php-agentic/Mcp/Tools/Agent/State/StateSet.php
2026-01-27 00:28:29 +00:00

91 lines
2.4 KiB
PHP

<?php
declare(strict_types=1);
namespace Core\Agentic\Mcp\Tools\Agent\State;
use Core\Agentic\Models\AgentPlan;
use Core\Agentic\Models\AgentWorkspaceState;
use Core\Agentic\Mcp\Tools\Agent\AgentTool;
/**
* Set a workspace state value.
*/
class StateSet extends AgentTool
{
protected string $category = 'state';
protected array $scopes = ['write'];
public function name(): string
{
return 'state_set';
}
public function description(): string
{
return 'Set 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',
],
'value' => [
'type' => ['string', 'number', 'boolean', 'object', 'array'],
'description' => 'State value',
],
'category' => [
'type' => 'string',
'description' => 'State category for organisation',
],
],
'required' => ['plan_slug', 'key', 'value'],
];
}
public function handle(array $args, array $context = []): array
{
try {
$planSlug = $this->require($args, 'plan_slug');
$key = $this->require($args, 'key');
$value = $this->require($args, 'value');
} catch (\InvalidArgumentException $e) {
return $this->error($e->getMessage());
}
$plan = AgentPlan::where('slug', $planSlug)->first();
if (! $plan) {
return $this->error("Plan not found: {$planSlug}");
}
$state = AgentWorkspaceState::updateOrCreate(
[
'agent_plan_id' => $plan->id,
'key' => $key,
],
[
'value' => $value,
'category' => $this->optional($args, 'category', 'general'),
]
);
return $this->success([
'state' => [
'key' => $state->key,
'value' => $state->value,
'category' => $state->category,
],
]);
}
}