Skip to main content

Interface: EmergentCapabilityEngineDeps

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:335

Dependencies injected into the EmergentCapabilityEngine constructor.

All collaborators are provided externally so the engine is trivially testable with mocks — no real LLM calls, no real sandbox execution.

Properties​

composableBuilder​

composableBuilder: ComposableToolBuilder

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:340

Builder for composable (tool-chaining) implementations.


config​

config: EmergentConfig

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:337

Resolved emergent capability configuration.


judge​

judge: EmergentJudge

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:355

LLM-as-judge evaluator for creation and promotion reviews.


onForgeTrace()?​

optional onForgeTrace: (trace) => void | Promise<void>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:381

Called once for every forge, after its outcome is final, with its trace. Never called for loads or re-registrations.

The forge waits for the promise the handler returns up to one second and then returns; a handler running at that bound is left running. The bound starts when the handler returns: its synchronous work runs on the forge's own call, to its end, and no timer cuts it short. A handler that throws or rejects never changes the forge's result.

Parameters​

trace​

ForgeTrace

Returns​

void | Promise<void>


onToolForged()?​

optional onToolForged: (tool, executable) => Promise<void>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:369

Optional callback used to activate a newly forged tool immediately.

Parameters​

tool​

EmergentTool

executable​

ITool

Returns​

Promise<void>


onToolPromoted()?​

optional onToolPromoted: (tool) => Promise<void>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:384

Optional callback used when a tool is promoted to a persisted tier.

Parameters​

tool​

EmergentTool

Returns​

Promise<void>


onToolRemoved()?​

optional onToolRemoved: (tool) => Promise<void>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:387

Optional callback used when a tool is removed from the live runtime.

Parameters​

tool​

EmergentTool

Returns​

Promise<void>


onToolRestored()?​

optional onToolRestored: (tool) => Promise<void>

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:395

Optional callback used to register again a tool of the host's whose name a forged composition's executable took, when the forge takes that executable out again (the composition reached itself once registered). Without it the name is left empty in that case.

Parameters​

tool​

ITool

Returns​

Promise<void>


registry​

registry: EmergentToolRegistry

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:358

Tiered registry for storing and querying emergent tools.


sandboxForge?​

optional sandboxForge: SandboxedToolForge

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:352

The forge for code-forged tools. Optional: without it the engine builds one from config.sandboxMemoryMB, config.sandboxTimeoutMs and config.executor; with it, config.executor must be absent or this forge's own executor (executor_conflict otherwise). Under a ceiling (config.capabilities) a forge given here must be no wider than the ceiling (construction fails with forge_wider_than_ceiling naming the option), narrows it where it is narrower, and serves this engine only.


stepGate?​

optional stepGate: StepGate

Defined in: packages/agentos/src/cognition/emergent/EmergentCapabilityEngine.ts:366

The gate composed tools run their steps through. ToolOrchestrator passes its own; a host that builds the engine directly passes one from createStepGate, or gives the builder one. Without a gate the engine forges code but refuses to compose (compose_needs_gate).