6748e6cd84
Updated workspace_id error messages in all MCP tools to include actionable guidance and a documentation link. Affected tools: PlanCreate, PlanGet, PlanList, StateSet, StateGet, StateList, SessionStart. Resolves DX-001 from TODO.md. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
99 lines
2.7 KiB
PHP
99 lines
2.7 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Core\Mod\Agentic\Mcp\Tools\Agent\State;
|
|
|
|
use Core\Mcp\Dependencies\ToolDependency;
|
|
use Core\Mod\Agentic\Mcp\Tools\Agent\AgentTool;
|
|
use Core\Mod\Agentic\Models\AgentPlan;
|
|
|
|
/**
|
|
* Get a workspace state value.
|
|
*/
|
|
class StateGet extends AgentTool
|
|
{
|
|
protected string $category = 'state';
|
|
|
|
protected array $scopes = ['read'];
|
|
|
|
/**
|
|
* Get the dependencies for this tool.
|
|
*
|
|
* Workspace context is required to ensure tenant isolation.
|
|
*
|
|
* @return array<ToolDependency>
|
|
*/
|
|
public function dependencies(): array
|
|
{
|
|
return [
|
|
ToolDependency::contextExists('workspace_id', 'Workspace context required for state operations'),
|
|
];
|
|
}
|
|
|
|
public function name(): string
|
|
{
|
|
return 'state_get';
|
|
}
|
|
|
|
public function description(): string
|
|
{
|
|
return 'Get a workspace state value';
|
|
}
|
|
|
|
public function inputSchema(): array
|
|
{
|
|
return [
|
|
'type' => 'object',
|
|
'properties' => [
|
|
'plan_slug' => [
|
|
'type' => 'string',
|
|
'description' => 'Plan slug identifier',
|
|
],
|
|
'key' => [
|
|
'type' => 'string',
|
|
'description' => 'State key',
|
|
],
|
|
],
|
|
'required' => ['plan_slug', 'key'],
|
|
];
|
|
}
|
|
|
|
public function handle(array $args, array $context = []): array
|
|
{
|
|
try {
|
|
$planSlug = $this->require($args, 'plan_slug');
|
|
$key = $this->require($args, 'key');
|
|
} catch (\InvalidArgumentException $e) {
|
|
return $this->error($e->getMessage());
|
|
}
|
|
|
|
// Validate workspace context for tenant isolation
|
|
$workspaceId = $context['workspace_id'] ?? null;
|
|
if ($workspaceId === null) {
|
|
return $this->error('workspace_id is required. Ensure you have authenticated with a valid API key and started a session. See: https://host.uk.com/ai');
|
|
}
|
|
|
|
// Query plan with workspace scope to prevent cross-tenant access
|
|
$plan = AgentPlan::forWorkspace($workspaceId)
|
|
->where('slug', $planSlug)
|
|
->first();
|
|
|
|
if (! $plan) {
|
|
return $this->error("Plan not found: {$planSlug}");
|
|
}
|
|
|
|
$state = $plan->states()->where('key', $key)->first();
|
|
|
|
if (! $state) {
|
|
return $this->error("State not found: {$key}");
|
|
}
|
|
|
|
return $this->success([
|
|
'key' => $state->key,
|
|
'value' => $state->value,
|
|
'category' => $state->category,
|
|
'updated_at' => $state->updated_at->toIso8601String(),
|
|
]);
|
|
}
|
|
}
|