agent/php/Mcp/Tools/Agent/Session/SessionArtifact.php
Snider 3f5f4d15fe fix(mcp): SessionArtifact passes description as metadata array
AgentSession::addArtifact expects ?array $metadata in the third
argument slot; the MCP tool was passing the optional description
string directly, producing a TypeError whenever a caller supplied a
non-null description. Wrap the description into a metadata array so
the call matches the model signature, and add a feature test that
exercises the MCP handler end-to-end to prevent regression.

Closes tasks.lthn.sh/view.php?id=95

Co-authored-by: Codex <noreply@openai.com>
Co-Authored-By: Virgil <virgil@lethean.io>
2026-04-23 18:10:21 +01:00

80 lines
2.2 KiB
PHP

<?php
declare(strict_types=1);
namespace Core\Mod\Agentic\Mcp\Tools\Agent\Session;
use Core\Mod\Agentic\Mcp\Tools\Agent\AgentTool;
use Core\Mod\Agentic\Models\AgentSession;
/**
* Record an artifact created/modified during the session.
*/
class SessionArtifact extends AgentTool
{
protected string $category = 'session';
protected array $scopes = ['write'];
public function name(): string
{
return 'session_artifact';
}
public function description(): string
{
return 'Record an artifact created/modified during the session';
}
public function inputSchema(): array
{
return [
'type' => 'object',
'properties' => [
'path' => [
'type' => 'string',
'description' => 'File or resource path',
],
'action' => [
'type' => 'string',
'description' => 'Action performed',
'enum' => ['created', 'modified', 'deleted', 'reviewed'],
],
'description' => [
'type' => 'string',
'description' => 'Description of changes',
],
],
'required' => ['path', 'action'],
];
}
public function handle(array $args, array $context = []): array
{
try {
$path = $this->require($args, 'path');
$action = $this->require($args, 'action');
} catch (\InvalidArgumentException $e) {
return $this->error($e->getMessage());
}
$sessionId = $context['session_id'] ?? null;
if (! $sessionId) {
return $this->error('No active session. Call session_start first.');
}
$session = AgentSession::where('session_id', $sessionId)->first();
if (! $session) {
return $this->error('Session not found');
}
$description = $this->optional($args, 'description');
$metadata = $description !== null ? ['description' => $description] : null;
$session->addArtifact($path, $action, $metadata);
return $this->success(['artifact' => $path]);
}
}