IntelligenceAggregator

Aggregates intelligence from multiple providers. Manages the lifecycle of Intelligence Providers: - Provider registration - Priority-based sorting - Pre/Post execution gathering - Result merging Usage: ```php $aggregator = new IntelligenceAggregator($logger); $aggregator->registerProvider($myIntelligenceProvider); // any IntelligenceProviderInterface // Pre-execution (before tool runs) $preIntelligence = $aggregator->gatherPre($context); // Post-execution (after tool runs) $postIntelligence = $aggregator->gatherPost($context); // Merge all intelligence $fullIntelligence = $preIntelligence->merge($postIntelligence); ```

public function __construct(?Psr\Log\LoggerInterface $logger = null):

Parameters

Parameters of __construct()
Name	Type	Description
$logger	`?Psr\Log\LoggerInterface`

public function registerProvider(Milpa\ToolRuntime\Contracts\IntelligenceProviderInterface $provider): self

Register an intelligence provider.

Parameters

Parameters of registerProvider()
Name	Type	Description
$provider	`IntelligenceProviderInterface`	The provider to register

Returns

For chaining

public function registerProviders(array $providers): self

Register multiple providers at once.

Parameters

Parameters of registerProviders()
Name	Type	Description
$providers	`array<IntelligenceProviderInterface>`

Returns

For chaining

public function removeProvider(string $name): bool

Remove a provider by name.

Parameters

Parameters of removeProvider()
Name	Type	Description
$name	`string`	Provider name to remove

Returns

True if provider was found and removed

public function hasProvider(string $name): bool

Check if a provider is registered.

Parameters

Parameters of hasProvider()
Name	Type	Description
$name	`string`	Provider name to check

public function getProviderNames(): array

Get all registered provider names.

public function gatherPre(Milpa\ToolRuntime\Contracts\IntelligenceContext $context): Milpa\ToolRuntime\Contracts\ToolIntelligence

Gather pre-execution intelligence. Called before the tool executes. Returns warnings and would_block info.

Parameters

Parameters of gatherPre()
Name	Type	Description
$context	`IntelligenceContext`	Execution context

Returns

Aggregated pre-execution intelligence

public function gatherPost(Milpa\ToolRuntime\Contracts\IntelligenceContext $context): Milpa\ToolRuntime\Contracts\ToolIntelligence

Gather post-execution intelligence. Called after the tool executes. Returns suggestions, next_actions, context.

Parameters

Parameters of gatherPost()
Name	Type	Description
$context	`IntelligenceContext`	Execution context (with result)

Returns

Aggregated post-execution intelligence

public function gather(Milpa\ToolRuntime\Contracts\IntelligenceContext $context, string $phase = 'both'): Milpa\ToolRuntime\Contracts\ToolIntelligence

Gather intelligence from all applicable providers.

Parameters

Parameters of gather()
Name	Type	Description
$context	`IntelligenceContext`	Execution context
$phase	`string`	"pre", "post", or "both"

Returns

Aggregated intelligence

public function gatherAll(Milpa\ToolRuntime\Contracts\IntelligenceContext $preContext, Milpa\ToolRuntime\Contracts\IntelligenceContext $postContext): Milpa\ToolRuntime\Contracts\ToolIntelligence

Gather all intelligence (pre + post merged). Convenience method that gathers both phases.

Parameters

Parameters of gatherAll()
Name	Type	Description
$preContext	`IntelligenceContext`	Pre-execution context
$postContext	`IntelligenceContext`	Post-execution context

Returns

Complete aggregated intelligence

public function buildIntelligentResult(Milpa\ToolRuntime\ToolResult $result, Milpa\ToolRuntime\Contracts\IntelligenceContext $context, string $action, ?string $attempt = null): Milpa\ToolRuntime\IntelligentToolResult

Build an intelligent result from a ToolResult.

Parameters

Parameters of buildIntelligentResult()
Name	Type	Description
$result	`ToolResult`	Original result
$context	`IntelligenceContext`	Execution context
$action	`string`	Tool/action name
$attempt	`(string \| null)`	Human-readable attempt description (auto-generated if null)

Returns

Result with intelligence

public function generateAttemptDescription(string $action, array $args): string

Generate a human-readable attempt description.

Parameters

Parameters of generateAttemptDescription()
Name	Type	Description
$action	`string`	Tool/action name
$args	`array<string, mixed>`	Arguments

Returns

Human-readable description

public function getProviderCount(): int

Get count of registered providers.

public function clearProviders(): void

Clear all registered providers.