<?php

namespace App\Mcp\Tools;

use App\Mcp\Support\KanbanGitMcp;
use Illuminate\Contracts\JsonSchema\JsonSchema;
use Illuminate\JsonSchema\Types\Type;
use Laravel\Mcp\Request;
use Laravel\Mcp\Response;
use Laravel\Mcp\ResponseFactory;
use Laravel\Mcp\Server\Attributes\Description;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;

#[Name('get_ticket')]
#[Description('Get a visible ticket with project, status, type, priority, assignee, author, field values, and worklog data.')]
#[IsReadOnly]
class GetTicket extends Tool
{
    public function __construct(
        private readonly KanbanGitMcp $kanbanGitMcp,
    ) {}

    public function handle(Request $request): Response|ResponseFactory
    {
        $validated = $request->validate([
            'ticket_id' => ['required', 'integer'],
        ]);

        $user = $this->kanbanGitMcp->user($request);
        $ticket = $this->kanbanGitMcp->ticketForRead($user, (int) $validated['ticket_id']);

        return Response::structured([
            'data' => $this->kanbanGitMcp->ticketPayload($ticket),
        ]);
    }

    /**
     * @return array<string, Type>
     */
    public function schema(JsonSchema $schema): array
    {
        return [
            'ticket_id' => $schema->integer()
                ->description('Ticket ID.')
                ->required(),
        ];
    }
}