IntelligentToolResult

Extended ToolResult with Intelligence layer. Follows the Intelligent Tool Protocol (ITP) format: { "action": "create_note", "attempt": "Create note 'Design ideas'", "response": {...}, "success": true, "reason": null, "intelligence": { "suggestions": [...], "warnings": [...], "next_actions": [...], "context": {...}, "business_rules": {...} }, "meta": {...} }

public function __construct(bool $success, ?mixed $data = null, ?string $message = null, ?string $error = null, array $meta = [], ?Milpa\ToolRuntime\Contracts\ToolIntelligence $intelligence = null, ?string $action = null, ?string $attempt = null):

Parameters

Parameters of __construct()
Name	Type	Description
$success	`bool`	Whether the operation succeeded
$data	`mixed`	Response data
$message	`(string \| null)`	Success message
$error	`(string \| null)`	Error reason
$meta	`array<string, mixed>`	Additional metadata
$intelligence	`(ToolIntelligence \| null)`	Intelligence layer
$action	`(string \| null)`	Tool/action name
$attempt	`(string \| null)`	Human-readable description of what was attempted

public static function fromToolResult(Milpa\ToolRuntime\ToolResult $result, Milpa\ToolRuntime\Contracts\ToolIntelligence $intelligence, string $action, string $attempt): self

Create from an existing ToolResult with added intelligence.

Parameters

Parameters of fromToolResult()
Name	Type	Description
$result	`ToolResult`	Original result
$intelligence	`ToolIntelligence`	Intelligence to add
$action	`string`	Tool/action name
$attempt	`string`	Human-readable attempt description

public static function successWithIntelligence(?mixed $data, Milpa\ToolRuntime\Contracts\ToolIntelligence $intelligence, string $action, string $attempt, ?string $message = null, array $meta = []): self

Create a success result with intelligence.

Parameters

Parameters of successWithIntelligence()
Name	Type	Description
$data	`mixed`	Response data
$intelligence	`ToolIntelligence`	Intelligence layer
$action	`string`	Tool/action name
$attempt	`string`	Human-readable attempt description
$message	`(string \| null)`	Success message
$meta	`array<string, mixed>`	Additional metadata

public static function errorWithIntelligence(string $error, Milpa\ToolRuntime\Contracts\ToolIntelligence $intelligence, string $action, string $attempt, ?mixed $data = null, array $meta = []): self

Create an error result with intelligence (suggestions for recovery).

Parameters

Parameters of errorWithIntelligence()
Name	Type	Description
$error	`string`	Error reason
$intelligence	`ToolIntelligence`	Intelligence with suggestions
$action	`string`	Tool/action name
$attempt	`string`	Human-readable attempt description
$data	`mixed`	Optional data (e.g., partial results)
$meta	`array<string, mixed>`	Additional metadata

public static function blockedWithIntelligence(string $reason, Milpa\ToolRuntime\Contracts\ToolIntelligence $intelligence, string $action, string $attempt): self

Create a blocked result with alternative suggestions.

Parameters

Parameters of blockedWithIntelligence()
Name	Type	Description
$reason	`string`	Block reason
$intelligence	`ToolIntelligence`	Intelligence with alternatives
$action	`string`	Tool/action name
$attempt	`string`	Human-readable attempt description

public function getIntelligence(): ?Milpa\ToolRuntime\Contracts\ToolIntelligence

Get the intelligence layer.

public function hasIntelligence(): bool

Check if this result has intelligence.

public function getAction(): ?string

Get the action name.

public function getAttempt(): ?string

Get the attempt description.

public function getSuggestions(): array

Get suggestions from intelligence.

public function getWarnings(): array

Get warnings from intelligence.

public function getNextActions(): array

Get next actions from intelligence.

public function withIntelligence(Milpa\ToolRuntime\Contracts\ToolIntelligence $intelligence): self

Add intelligence to this result (creates new instance).

Parameters

Parameters of withIntelligence()
Name	Type	Description
$intelligence	`Milpa\ToolRuntime\Contracts\ToolIntelligence`

public function mergeIntelligence(Milpa\ToolRuntime\Contracts\ToolIntelligence $intelligence): self

Merge additional intelligence into existing (creates new instance).

Parameters

Parameters of mergeIntelligence()
Name	Type	Description
$intelligence	`Milpa\ToolRuntime\Contracts\ToolIntelligence`

public function jsonSerialize(): array

Serialize to ITP format.

public function toStandardFormat(): array

Convert to standard ToolResult format (without ITP wrapper). Useful for backwards compatibility with code expecting ToolResult format.

public function toCompactFormat(): array

Convert to compact format (minimal response).