php-agentic/Mcp/Tools/Agent/State/StateGet.php

76 lines
1.8 KiB
PHP
Raw Normal View History

2026-01-27 00:28:29 +00:00
<?php
declare(strict_types=1);
namespace Core\Agentic\Mcp\Tools\Agent\State;
use Core\Agentic\Models\AgentPlan;
use Core\Agentic\Mcp\Tools\Agent\AgentTool;
/**
* Get a workspace state value.
*/
class StateGet extends AgentTool
{
protected string $category = 'state';
protected array $scopes = ['read'];
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());
}
$plan = AgentPlan::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 [
'key' => $state->key,
'value' => $state->value,
'category' => $state->category,
'updated_at' => $state->updated_at->toIso8601String(),
];
}
}