ToolIntelligence

Intelligence data attached to tool results. This DTO carries enriched information that helps the LLM: - suggestions: Proactive tips to improve operations - warnings: Non-blocking alerts about potential issues - nextActions: Suggested follow-up tool calls - context: Entity completeness, relationships, capacity - businessRules: Applied rules, potential blocks, tips

public function __construct(array $suggestions = [], array $warnings = [], array $nextActions = [], array $context = [], array $businessRules = []):

Parameters

Parameters of __construct()
Name	Type	Description
$suggestions	`array<int, string>`	Proactive improvement suggestions
$warnings	`array<int, string>`	Non-blocking warnings
$nextActions	`array<int, array{tool: string, params?: array<string, mixed>, label: string}>`	Suggested follow-up actions
$context	`array<string, mixed>`	Entity context (completeness, relationships, capacity)
$businessRules	`array<string, mixed>`	Business rules state (applied, would_block, tips)

public static function empty(): self

Create an empty intelligence instance.

public static function fromArray(array $data): self

Create from array data.

Parameters

Parameters of fromArray()
Name	Type	Description
$data	`array<string, mixed>`

public function withSuggestions(array $suggestions): self

Add suggestions to a new instance.

Parameters

Parameters of withSuggestions()
Name	Type	Description
$suggestions	`array<string>`

public function withWarnings(array $warnings): self

Add warnings to a new instance.

Parameters

Parameters of withWarnings()
Name	Type	Description
$warnings	`array<string>`

public function withNextActions(array $nextActions): self

Add next actions to a new instance.

Parameters

Parameters of withNextActions()
Name	Type	Description
$nextActions	`array<int, array{tool: string, params?: array<string, mixed>, label: string}>`

public function withContext(array $context): self

Set context in a new instance.

Parameters

Parameters of withContext()
Name	Type	Description
$context	`array<string, mixed>`

public function withBusinessRules(array $businessRules): self

Set business rules in a new instance.

Parameters

Parameters of withBusinessRules()
Name	Type	Description
$businessRules	`array<string, mixed>`	Business rules (applied, would_block, tips)

public function merge(self $other): self

Merge another ToolIntelligence into this one.

Parameters

Parameters of merge()
Name	Type	Description
$other	`self`

public function isEmpty(): bool

Check if this intelligence has any content.

public function hasWarnings(): bool

Check if there are any warnings.

public function hasBlockingRules(): bool

Check if there are potential blocking rules.

public function getCompleteness(): float

Get completeness percentage from context.

public function getMissingRecommended(): array

Get missing recommended fields from context.

public function toArray(): array

Convert to array for JSON serialization.

public function jsonSerialize(): array

Serialize for JSON encoding; delegates to {@see toArray()} so empty sections are omitted.