<?php

namespace App\Mcp\Tools;

use App\Actions\Tickets\ListTicketsByStatusByVisibleProject;
use App\Http\Resources\TicketStatusResource;
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('list_tickets_by_status')]
#[Description('List tickets in a status, grouped by visible project. Use ticket_status_id when possible; status_slug or status_name are convenience lookups and must be unambiguous.')]
#[IsReadOnly]
class ListTicketsByStatus extends Tool
{
    public function __construct(
        private readonly KanbanGitMcp $kanbanGitMcp,
        private readonly ListTicketsByStatusByVisibleProject $listTicketsByStatusByVisibleProject,
    ) {}

    public function handle(Request $request): Response|ResponseFactory
    {
        $validated = $request->validate([
            'project_id' => ['nullable', 'integer'],
            'status_name' => ['nullable', 'string'],
            'status_slug' => ['nullable', 'string'],
            'ticket_status_id' => ['nullable', 'integer', 'required_without_all:status_slug,status_name'],
        ], [
            'ticket_status_id.required_without_all' => 'Provide ticket_status_id, status_slug, or status_name.',
        ]);

        $user = $this->kanbanGitMcp->user($request);
        $project = $this->kanbanGitMcp->projectForRead($user, $validated['project_id'] ?? null);
        $ticketStatuses = $this->kanbanGitMcp->resolveTicketStatuses($user, $validated, $project);

        if ($ticketStatuses instanceof Response) {
            return $ticketStatuses;
        }

        return Response::structured([
            'data' => $this->listTicketsByStatusByVisibleProject->handle($user, $ticketStatuses, $project),
            'meta' => [
                'statuses' => TicketStatusResource::collection($ticketStatuses)->resolve(),
            ],
        ]);
    }

    /**
     * @return array<string, Type>
     */
    public function schema(JsonSchema $schema): array
    {
        return [
            'project_id' => $schema->integer()
                ->nullable()
                ->description('Optional project ID. Use it to scope status_name or status_slug and avoid ambiguity.'),
            'status_name' => $schema->string()
                ->nullable()
                ->description('Exact ticket status name. Must match exactly and be unambiguous.'),
            'status_slug' => $schema->string()
                ->nullable()
                ->description('Ticket status slug. Must be unambiguous unless project_id is provided.'),
            'ticket_status_id' => $schema->integer()
                ->nullable()
                ->description('Stable ticket status ID. Preferred when available.'),
        ];
    }
}