74 lines
2.5 KiB
PHP
74 lines
2.5 KiB
PHP
<?php
|
|
|
|
namespace App\Mcp\Tools;
|
|
|
|
use App\Actions\Tickets\Support\TicketDescriptionFormat;
|
|
use App\Actions\Tickets\UpdateProjectTicket;
|
|
use App\Mcp\Support\DescribesTicketWriting;
|
|
use App\Mcp\Support\KanbanGitMcp;
|
|
use App\Rules\VisualTicketDescription;
|
|
use Illuminate\Contracts\JsonSchema\JsonSchema;
|
|
use Illuminate\JsonSchema\Types\Type;
|
|
use Illuminate\Support\Arr;
|
|
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_description')]
|
|
#[Description('Update only a ticket description while preserving all other ticket fields. Requires project write permission.')]
|
|
#[IsDestructive(false)]
|
|
class UpdateTicketDescription 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([
|
|
'description' => ['nullable', 'string', new VisualTicketDescription],
|
|
'ticket_id' => ['required', 'integer'],
|
|
]);
|
|
|
|
$user = $this->kanbanGitMcp->user($request);
|
|
$ticket = $this->kanbanGitMcp->ticketForWrite($user, (int) $validated['ticket_id']);
|
|
$payload = [
|
|
...$this->kanbanGitMcp->updatePayload($ticket),
|
|
...(Arr::exists($validated, 'description') ? ['description' => Arr::get($validated, 'description')] : []),
|
|
];
|
|
|
|
$wasUpdated = $this->updateProjectTicket->handle($ticket, $user, $payload);
|
|
|
|
return Response::structured([
|
|
'data' => $this->kanbanGitMcp->ticketPayload($ticket->fresh()),
|
|
'meta' => [
|
|
'message' => $wasUpdated
|
|
? "{$ticket->ticket_key} description was updated."
|
|
: 'No ticket changes were detected.',
|
|
],
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* @return array<string, Type>
|
|
*/
|
|
public function schema(JsonSchema $schema): array
|
|
{
|
|
return [
|
|
'description' => $schema->string()
|
|
->nullable()
|
|
->description('New ticket description. Omit to preserve; pass null to clear it. '.TicketDescriptionFormat::instructions()),
|
|
'ticket_id' => $schema->integer()
|
|
->description('Ticket ID.')
|
|
->required(),
|
|
];
|
|
}
|
|
}
|