Interface EmergentConfig

Configuration options for the Emergent Capability Engine.

All fields have sensible defaults defined in DEFAULT_EMERGENT_CONFIG. Pass a partial object to override only the fields you need.

interface EmergentConfig {
    enabled: boolean;
    maxSessionTools: number;
    maxAgentTools: number;
    allowSandboxTools: boolean;
    persistSandboxSource: boolean;
    sandboxMemoryMB: number;
    sandboxTimeoutMs: number;
    promotionThreshold: {
        uses: number;
        confidence: number;
    };
    judgeModel: string;
    promotionJudgeModel: string;
    selfImprovement?: SelfImprovementConfig;
}

Properties

enabled maxSessionTools maxAgentTools allowSandboxTools persistSandboxSource sandboxMemoryMB sandboxTimeoutMs promotionThreshold judgeModel promotionJudgeModel selfImprovement?

Properties

enabled

enabled: boolean

Master switch. When false, all forge / promote / execute requests are rejected immediately with a "emergent capabilities disabled" error.

Default

false

maxSessionTools

maxSessionTools: number

Maximum number of session-scoped emergent tools an agent may hold at once. Forge requests beyond this limit are rejected until older tools are evicted.

Default

10

maxAgentTools

maxAgentTools: number

Maximum number of agent-scoped emergent tools persisted per agent. Promotion from 'session' to 'agent' is blocked when this limit is reached.

Default

50

allowSandboxTools

allowSandboxTools: boolean

Whether sandboxed code tools may be forged at all.

When false, agents may still create compose-mode tools from existing registered tools, but any forge request using implementation.mode: 'sandbox' is rejected before validation or execution.

This is intentionally disabled by default because sandboxed code carries higher review and persistence risk than safe-by-construction composition.

Default

false

persistSandboxSource

persistSandboxSource: boolean

Whether sandbox source code should be persisted at rest.

When false, sandbox tools still run in memory for the active process, but durable storage only receives redacted metadata instead of raw source code. This reduces the blast radius of runtime-forged code while preserving audit visibility and non-source tool metadata.

Persisting raw sandbox source should be an explicit opt-in for trusted environments that need restart-time rehydration of sandbox tools.

Default

false

sandboxMemoryMB

sandboxMemoryMB: number

Memory limit in megabytes for each sandboxed tool execution. Passed as SandboxExecutionRequest.memoryMB.

Default

128

sandboxTimeoutMs

sandboxTimeoutMs: number

Wall-clock timeout in milliseconds for each sandboxed tool execution. Passed as SandboxExecutionRequest.timeoutMs.

Default

5000

promotionThreshold

promotionThreshold: {
    uses: number;
    confidence: number;
}

Thresholds that must be met before a tool is eligible for tier promotion.

Type declaration

  • uses: number

    Minimum total invocation count before promotion is considered.

    Default

    5
  • confidence: number

    Minimum aggregate confidence score (from usage stats) before promotion. In the range [0, 1].

    Default

    0.8

judgeModel

judgeModel: string

Model ID used by the single LLM judge at forge time (CreationVerdict). Should be a fast, cost-efficient model — correctness is handled by test cases.

Default

"gpt-4o-mini"

promotionJudgeModel

promotionJudgeModel: string

Model ID used by both reviewers in the multi-reviewer promotion panel (PromotionVerdict). Should be a more capable model than judgeModel.

Default

"gpt-4o"

Optional selfImprovement

selfImprovement?: SelfImprovementConfig

Self-improvement configuration for bounded autonomous personality mutation, skill management, workflow composition, and self-evaluation.

When omitted or undefined, self-improvement tools are not registered.

Default

undefined (disabled)

Settings

Member Visibility

Theme

On This Page

enabledmaxSessionToolsmaxAgentToolsallowSandboxToolspersistSandboxSourcesandboxMemoryMBsandboxTimeoutMspromotionThresholdjudgeModelpromotionJudgeModelselfImprovement