<?php

namespace App\Mcp\Tools;

use App\Actions\Tickets\ListAssignedTicketsByVisibleProject;
use App\Http\Resources\UserResource;
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_my_assigned_tickets')]
#[Description('List tickets assigned to the authenticated application key owner, grouped by visible project. Optionally filter to one project.')]
#[IsReadOnly]
class ListMyAssignedTickets extends Tool
{
    public function __construct(
        private readonly KanbanGitMcp $kanbanGitMcp,
        private readonly ListAssignedTicketsByVisibleProject $listAssignedTicketsByVisibleProject,
    ) {}

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

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

        return Response::structured([
            'data' => $this->listAssignedTicketsByVisibleProject->handle($user, $user, $project),
            'meta' => [
                'assignee' => UserResource::make($user)->resolve(),
            ],
        ]);
    }

    /**
     * @return array<string, Type>
     */
    public function schema(JsonSchema $schema): array
    {
        return [
            'project_id' => $schema->integer()
                ->nullable()
                ->description('Optional project ID. When omitted, tickets from all visible projects are returned.'),
        ];
    }
}