ToolContext

Context for tool execution. Contains information about who/where/what permissions for authorization.

public function __construct(?string $principal = null, string $channel = 'unknown', array $scopes = [], ?string $request_id = null, ?string $ip = null, ?string $userAgent = null, array $extra = [], string $mode = 'execute'):

Parameters

public function asPlan(): self

Clone this context in plan mode (dry-run). Plan mode validates and authorizes but does NOT execute the tool callback.

public function isPlanMode(): bool

Check if context is in plan mode.

public function isExecuteMode(): bool

Check if context is in execute mode.

public function hasScope(string $scope): bool

Check if context has a specific scope.

Parameters

public function hasAnyScope(array $scopes): bool

Check if context has any of the given scopes.

Parameters

public function hasAllScopes(array $scopes): bool

Check if context has all of the given scopes.

Parameters

public static function cli(?string $requestId = null, string $mode = 'execute'): self

Create context for CLI usage (full access).

Parameters

public static function mcp(string $requestId, ?string $principal = null, array $scopes = [], string $mode = 'execute'): self

Create context for MCP server.

Deprecated: Calling without explicit scopes is deprecated and will be removed in v2.0

Parameters

public static function telegram(string $chatId, ?string $userId = null, string $mode = 'execute'): self

Create context for Telegram.

Parameters

public function toArray(): array

Serialize this context to a plain array for logging or transport.