72 lines
2.3 KiB
PHP
72 lines
2.3 KiB
PHP
<?php
|
|
|
|
namespace App\Mcp\Tools;
|
|
|
|
use App\Actions\Tickets\UpdateProjectTicket;
|
|
use App\Mcp\Support\DescribesTicketWriting;
|
|
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\IsDestructive;
|
|
|
|
#[Name('update_ticket_assignee')]
|
|
#[Description('Assign or unassign a ticket while preserving all other ticket fields. Requires project write permission.')]
|
|
#[IsDestructive(false)]
|
|
class UpdateTicketAssignee extends Tool
|
|
{
|
|
use DescribesTicketWriting;
|
|
|
|
public function __construct(
|
|
private readonly KanbanGitMcp $kanbanGitMcp,
|
|
private readonly UpdateProjectTicket $updateProjectTicket,
|
|
) {}
|
|
|
|
public function handle(Request $request): Response|ResponseFactory
|
|
{
|
|
$validated = $request->validate([
|
|
'assignee_user_id' => ['present', 'nullable', 'integer', 'exists:users,id'],
|
|
'ticket_id' => ['required', 'integer'],
|
|
]);
|
|
|
|
$user = $this->kanbanGitMcp->user($request);
|
|
$ticket = $this->kanbanGitMcp->ticketForWrite($user, (int) $validated['ticket_id']);
|
|
$payload = [
|
|
...$this->kanbanGitMcp->updatePayload($ticket),
|
|
'assignee_user_id' => $validated['assignee_user_id'] ?? null,
|
|
];
|
|
|
|
$wasUpdated = $this->updateProjectTicket->handle($ticket, $user, $payload);
|
|
|
|
return Response::structured([
|
|
'data' => $this->kanbanGitMcp->ticketPayload($ticket->fresh()),
|
|
'meta' => [
|
|
'message' => $wasUpdated
|
|
? "{$ticket->ticket_key} assignee was updated."
|
|
: 'No ticket changes were detected.',
|
|
],
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* @return array<string, Type>
|
|
*/
|
|
public function schema(JsonSchema $schema): array
|
|
{
|
|
return [
|
|
'assignee_user_id' => $schema->integer()
|
|
->nullable()
|
|
->description('User ID to assign. Pass null to unassign.')
|
|
->required(),
|
|
'ticket_id' => $schema->integer()
|
|
->description('Ticket ID.')
|
|
->required(),
|
|
];
|
|
}
|
|
}
|