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()?
optionalonForgeTrace: (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
Returns
void | Promise<void>
onToolForged()?
optionalonToolForged: (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
executable
Returns
Promise<void>
onToolPromoted()?
optionalonToolPromoted: (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
Returns
Promise<void>
onToolRemoved()?
optionalonToolRemoved: (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
Returns
Promise<void>
onToolRestored()?
optionalonToolRestored: (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
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?
optionalsandboxForge: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?
optionalstepGate: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).