76 lines
2.9 KiB
PHP
76 lines
2.9 KiB
PHP
<?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.'),
|
|
];
|
|
}
|
|
}
|