IntelligenceContext

Context object passed to Intelligence Providers. Carries all information needed to generate intelligent suggestions: - Tool name and arguments - Execution result (for post-execution providers) - Entity information (type, instance, ID) - Applied business rules

public function __construct(string $toolName, array $args = [], ?Milpa\ToolRuntime\ToolResult $result = null, ?string $entityType = null, ?object $entity = null, string|int|null $entityId = null, array $appliedRules = [], array $extra = []):

Parameters

Parameters of __construct()
Name	Type	Description
$toolName	`string`	Name of the tool being executed
$args	`array<string, mixed>`	Arguments passed to the tool
$result	`(ToolResult \| null)`	Execution result (null for pre-execution)
$entityType	`(string \| null)`	Type of entity involved (Note, User, etc.)
$entity	`(object \| null)`	The actual entity instance
$entityId	`(int \| string \| null)`	Entity identifier
$appliedRules	`array<array{rule: string, effect?: string}>`	Rules that were applied
$extra	`array<string, mixed>`	Additional context data

public static function preExecution(string $toolName, array $args = [], array $extra = []): self

Create context for pre-execution phase (before tool runs).

Parameters

Parameters of preExecution()
Name	Type	Description
$toolName	`string`
$args	`array<string, mixed>`
$extra	`array<string, mixed>`

public static function postExecution(string $toolName, array $args, Milpa\ToolRuntime\ToolResult $result, ?string $entityType = null, ?object $entity = null, string|int|null $entityId = null, array $appliedRules = [], array $extra = []): self

Create context for post-execution phase (after tool runs).

Parameters

Parameters of postExecution()
Name	Type	Description
$toolName	`string`
$args	`array<string, mixed>`
$result	`ToolResult`
$entityType	`(string \| null)`
$entity	`(object \| null)`
$entityId	`(int \| string \| null)`
$appliedRules	`array<array{rule: string, effect?: string}>`
$extra	`array<string, mixed>`

public function withResult(Milpa\ToolRuntime\ToolResult $result): self

Add execution result to create post-execution context.

Parameters

Parameters of withResult()
Name	Type	Description
$result	`Milpa\ToolRuntime\ToolResult`

public function withEntity(string $type, ?object $entity, string|int|null $id = null): self

Add entity information.

Parameters

Parameters of withEntity()
Name	Type	Description
$type	`string`
$entity	`?object`
$id	`string\|int\|null`

public function withAppliedRules(array $rules): self

Add applied business rules.

Parameters

Parameters of withAppliedRules()
Name	Type	Description
$rules	`array<array{rule: string, effect?: string}>`

public function withExtra(array $extra): self

Add extra context data.

Parameters

Parameters of withExtra()
Name	Type	Description
$extra	`array<string, mixed>`

public function getToolName(): string

public function getArgs(): array

public function getArg(string $key, ?mixed $default = null): ?mixed

Get a specific argument value.

Parameters

Parameters of getArg()
Name	Type	Description
$key	`string`
$default	`?mixed`

public function getResult(): ?Milpa\ToolRuntime\ToolResult

public function hasResult(): bool

Check whether an execution result has been attached (i.e. this is a post-execution context).

public function isSuccessful(): bool

Check whether the attached execution result succeeded; false when no result is attached yet.

public function getEntityType(): ?string

public function getEntity(): ?object

public function getEntityId(): string|int|null

public function hasEntity(): bool

Check whether entity information (an instance, or at least a type) has been attached.

public function getAppliedRules(): array

public function getExtra(): array

public function getExtraValue(string $key, ?mixed $default = null): ?mixed

Get a specific extra value.

Parameters

Parameters of getExtraValue()
Name	Type	Description
$key	`string`
$default	`?mixed`

public function isCreateOperation(): bool

Check if this is a create operation.

public function isUpdateOperation(): bool

Check if this is an update operation.

public function isDeleteOperation(): bool

Check if this is a delete operation.

public function isReadOperation(): bool

Check if this is a read/list operation.

public function isMutation(): bool

Check if this is a mutation (create, update, delete).

public function getOperationType(): string

Get the operation type.

public function inferEntityTypeFromTool(): ?string

Get the entity type from tool name (e.g., create_note -> Note).