@mindot/will 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -1,5 +1,143 @@
-import { S as SimulationContext, a as SeededPRNG, b as SimulationEntity, T as Timestamp, c as SimulationEvent, d as StateManager, e as Tick, f as SimulationState, R as RestoreOptions, g as StateCommands, h as ReasoningFootprint, i as ReadonlySimulationState, C as ConflictReport, j as ConflictStrategy, k as ConflictResolution, O as OutboundEnvelope, A as AckResult, l as ExternalTransport, I as InboundEnvelope, m as TransportStatus } from './will-B5eKs3Wv.js';
-export { n as AckEnvelope, o as ActionRequest, p as ActionResult, q as ActionSelector, r as ActivityEnvelope, s as ActivityEvent, t as ActivityEventHandler, u as AestheticEvaluator, v as AestheticEvaluatorConfig, w as AffectiveBlender, x as AffectiveBlenderConfig, y as AffordanceSynthesizer, z as AsyncEngine, B as AsyncEngineConfig, D as AttachmentEvaluator, F as AttachmentEvaluatorConfig, G as AttentionAllocator, H as AttentionAllocatorConfig, J as AuditionEngine, K as AutobiographicalNarrator, L as AutobiographicalNarratorConfig, M as BehavioralProbeResult, N as BiasDetector, P as BiasDetectorConfig, Q as BunStorageAdapter, U as ChunkEnvelope, V as CircadianConfig, X as CircadianOscillator, Y as ClockConfig, Z as Cognition, _ as CognitiveHealth, $ as ConfidenceCalibrator, a0 as ConfidenceCalibratorConfig, a1 as Coordinates, a2 as CreateWillOptions, a3 as DefaultEventBus, a4 as DefaultMetricCollector, a5 as DefaultOrchestrator, a6 as DefaultReplayRecorder, a7 as DefaultReplaySession, a8 as DefaultScenario, a9 as DefaultSerializer, aa as DefaultSimulation, ab as DefaultSimulationClock, ac as DefaultStateManager, ad as DefaultVectorMemoryAdapter, ae as DeliberationEngine, af as DeltaEncoder, ag as DeltaSnapshot, ah as DreamSimulator, ai as DreamSimulatorConfig, aj as Duration, ak as EffectorDeclaration, al as EffectorEntry, E as EffectorHandler, am as EffectorResult, an as EffectorSpec, ao as EmbeddingProvider, ap as EmpathySimulator, aq as EmpathySimulatorConfig, ar as EnergyRegulator, as as EnergyRegulatorConfig, at as EngineRegistry, au as EngineResult, av as Envelope, aw as EpisodicConsolidator, ax as EpisodicConsolidatorConfig, ay as EventBus, az as EventBusConfig, aA as EventFilter, aB as EventHandler, aC as EventPayload, aD as ExecutiveEngine, aE as ExecutiveEngineConfig, aF as Exteroception, aG as ExteroceptionConfig, aH as ForgettingCurve, aI as ForgettingCurveConfig, aJ as FrustrationEvaluator, aK as FrustrationEvaluatorConfig, aL as GoalManager, aM as GoalManagerConfig, aN as GustationEngine, aO as InboundMessageEnvelope, aP as InboundPerceptEnvelope, aQ as InhibitionController, aR as InhibitionControllerConfig, aS as Interoception, aT as InteroceptionConfig, aU as IntrospectionEngine, aV as IntrospectionEngineConfig, aW as KnownEntityTracker, aX as KnownEntityTrackerConfig, aY as LLMCompletionRecord, aZ as LLMCompletionSink, a_ as LossEvaluator, a$ as LossEvaluatorConfig, b0 as MessageEnvelope, b1 as MetricCollector, b2 as MetricPoint, b3 as MinimalContext, b4 as MockEmbedder, b5 as MoralEvaluator, b6 as MoralEvaluatorConfig, b7 as MotorSchemaExecutor, b8 as NoveltyDetector, b9 as NoveltyDetectorConfig, ba as OlfactionEngine, bb as OpenAICompatibleEmbedder, bc as Orchestrator, bd as OrchestratorConfig, be as OutboxMessage, bf as PMABehavioral, bg as PMABelief, bh as PMAEmotionalBaseline, bi as PMAEvalHarness, bj as PMAGoal, bk as PMAIdentity, bl as PMAProbe, bm as PMASnapshot, bn as PerceptEnvelope, bo as PersonaConsolidator, bp as PersonaConsolidatorConfig, bq as PlanningEngine, br as PlanningEngineConfig, bs as ReafferenceEngine, bt as ReconstructionFidelityReport, bu as ReconstructionFidelityScores, bv as RecordUsageInput, bw as ReplayComparison, bx as ReplayConfig, by as ReplayDifference, bz as ReplayManager, bA as ReplayMetadata, bB as ReplayRecord, bC as ReplayRecorder, bD as ReplaySession, bE as ReplyEnvelope, bF as ReputationTracker, bG as ReputationTrackerConfig, bH as RewardEvaluator, bI as RewardEvaluatorConfig, bJ as Scenario, bK as ScenarioConfig, bL as ScenarioValidationResult, bM as SchemaPrecondition, bN as SelfModelUpdater, bO as SelfModelUpdaterConfig, bP as SemanticIntegrator, bQ as SemanticIntegratorConfig, bR as SensoryInput, bS as SerializationConfig, bT as SerializationFormat, bU as SerializedEntity, bV as SerializedState, bW as Serializer, bX as SessionLogEnvelope, bY as Simulation, bZ as SimulationClock, b_ as SimulationConfig, b$ as SimulationEngine, c0 as SimulationEventBase, c1 as SimulationEventListener, c2 as SleepPressureConfig, c3 as SleepPressureRegulator, c4 as SocialPerception, c5 as SocialPerceptionConfig, c6 as SomatosensationEngine, c7 as SpacedRepetition, c8 as SpacedRepetitionConfig, c9 as StateSnapshot, ca as Stimulus, cb as StorageAdapter, cc as StressRegulator, cd as StressRegulatorConfig, ce as TaskSwitcher, cf as TaskSwitcherConfig, cg as TextMessage, ch as TheoryOfMind, ci as TheoryOfMindConfig, cj as ThreatEvaluator, ck as ThreatEvaluatorConfig, cl as TickListener, cm as TokenLedgerRecord, cn as TokenReportEnvelope, co as TokenTracker, cp as TokenTrackerConfig, cq as TokenUsage, cr as VectorIndex, cs as VectorMemoryAdapter, ct as VectorMemoryConfig, cu as VectorQueryFilter, cv as VectorQueryResult, cw as VectorRecord, cx as VisionEngine, cy as VoiceChunk, W as Will, cz as WillAffect, cA as WillConfig, cB as WillEffectorAct, cC as WillInstance, cD as WillMessage, cE as WillStateSummary, cF as WillStatus, cG as WillStem, cH as WillSummary, cI as WorkingMemory, cJ as WorkingMemoryConfig, cK as WorldEntity, cL as WorldInterface, cM as assembleMind, cN as clearCompletionRecorder, cO as effectorInvocation, cP as effectorInvocationEnvelope, cQ as getCompletionRecorder, cR as resolvePricing, cS as setCompletionRecorder } from './will-B5eKs3Wv.js';
+import { O as OutboundEnvelope, A as AckResult, a as ExternalTransport, I as InboundEnvelope, T as TransportStatus, S as SimulationContext, b as SeededPRNG, c as SimulationEntity, d as Timestamp, e as SimulationEvent, f as StateManager, g as Tick, h as SimulationState, R as RestoreOptions, i as StateCommands, j as ReasoningFootprint, k as ReadonlySimulationState, C as ConflictReport, l as ConflictStrategy, m as ConflictResolution } from './will-BDq-TMQr.js';
+export { n as AckEnvelope, o as ActionRequest, p as ActionResult, q as ActionSelector, r as ActivityEnvelope, s as ActivityEvent, t as ActivityEventHandler, u as AestheticEvaluator, v as AestheticEvaluatorConfig, w as AffectiveBlender, x as AffectiveBlenderConfig, y as AffordanceSynthesizer, z as AsyncEngine, B as AsyncEngineConfig, D as AttachmentEvaluator, F as AttachmentEvaluatorConfig, G as AttentionAllocator, H as AttentionAllocatorConfig, J as AuditionEngine, K as AutobiographicalNarrator, L as AutobiographicalNarratorConfig, M as BehavioralProbeResult, N as BiasDetector, P as BiasDetectorConfig, Q as BunStorageAdapter, U as ChunkEnvelope, V as CircadianConfig, X as CircadianOscillator, Y as ClockConfig, Z as Cognition, _ as CognitiveHealth, $ as ConfidenceCalibrator, a0 as ConfidenceCalibratorConfig, a1 as Coordinates, a2 as CreateWillOptions, a3 as DefaultEventBus, a4 as DefaultMetricCollector, a5 as DefaultOrchestrator, a6 as DefaultReplayRecorder, a7 as DefaultReplaySession, a8 as DefaultScenario, a9 as DefaultSerializer, aa as DefaultSimulation, ab as DefaultSimulationClock, ac as DefaultStateManager, ad as DefaultVectorMemoryAdapter, ae as DeliberationEngine, af as DeltaEncoder, ag as DeltaSnapshot, ah as DreamSimulator, ai as DreamSimulatorConfig, aj as Duration, ak as EffectorDeclaration, al as EffectorEntry, E as EffectorHandler, am as EffectorResult, an as EffectorSpec, ao as EmbeddingProvider, ap as EmpathySimulator, aq as EmpathySimulatorConfig, ar as EnergyRegulator, as as EnergyRegulatorConfig, at as EngineRegistry, au as EngineResult, av as Envelope, aw as EpisodicConsolidator, ax as EpisodicConsolidatorConfig, ay as EventBus, az as EventBusConfig, aA as EventFilter, aB as EventHandler, aC as EventPayload, aD as ExecutiveEngine, aE as ExecutiveEngineConfig, aF as Exteroception, aG as ExteroceptionConfig, aH as ForgettingCurve, aI as ForgettingCurveConfig, aJ as FrustrationEvaluator, aK as FrustrationEvaluatorConfig, aL as GoalManager, aM as GoalManagerConfig, aN as GustationEngine, aO as InboundMessageEnvelope, aP as InboundPerceptEnvelope, aQ as InhibitionController, aR as InhibitionControllerConfig, aS as Interoception, aT as InteroceptionConfig, aU as IntrospectionEngine, aV as IntrospectionEngineConfig, aW as KnownEntityTracker, aX as KnownEntityTrackerConfig, aY as LLMCompletionRecord, aZ as LLMCompletionSink, a_ as LossEvaluator, a$ as LossEvaluatorConfig, b0 as MessageEnvelope, b1 as MetricCollector, b2 as MetricPoint, b3 as MinimalContext, b4 as MockEmbedder, b5 as MoralEvaluator, b6 as MoralEvaluatorConfig, b7 as MotorSchemaExecutor, b8 as NoveltyDetector, b9 as NoveltyDetectorConfig, ba as OlfactionEngine, bb as OpenAICompatibleEmbedder, bc as Orchestrator, bd as OrchestratorConfig, be as OutboxMessage, bf as PMABehavioral, bg as PMABelief, bh as PMAEmotionalBaseline, bi as PMAEvalHarness, bj as PMAGoal, bk as PMAIdentity, bl as PMAProbe, bm as PMASnapshot, bn as PerceptEnvelope, bo as PersonaConsolidator, bp as PersonaConsolidatorConfig, bq as PlanningEngine, br as PlanningEngineConfig, bs as ReafferenceEngine, bt as ReconstructionFidelityReport, bu as ReconstructionFidelityScores, bv as RecordUsageInput, bw as ReplayComparison, bx as ReplayConfig, by as ReplayDifference, bz as ReplayManager, bA as ReplayMetadata, bB as ReplayRecord, bC as ReplayRecorder, bD as ReplaySession, bE as ReplyEnvelope, bF as ReputationTracker, bG as ReputationTrackerConfig, bH as RewardEvaluator, bI as RewardEvaluatorConfig, bJ as Scenario, bK as ScenarioConfig, bL as ScenarioValidationResult, bM as SchemaPrecondition, bN as SelfModelUpdater, bO as SelfModelUpdaterConfig, bP as SemanticIntegrator, bQ as SemanticIntegratorConfig, bR as SensoryInput, bS as SerializationConfig, bT as SerializationFormat, bU as SerializedEntity, bV as SerializedState, bW as Serializer, bX as SessionLogEnvelope, bY as Simulation, bZ as SimulationClock, b_ as SimulationConfig, b$ as SimulationEngine, c0 as SimulationEventBase, c1 as SimulationEventListener, c2 as SleepPressureConfig, c3 as SleepPressureRegulator, c4 as SocialPerception, c5 as SocialPerceptionConfig, c6 as SomatosensationEngine, c7 as SpacedRepetition, c8 as SpacedRepetitionConfig, c9 as StateSnapshot, ca as Stimulus, cb as StorageAdapter, cc as StressRegulator, cd as StressRegulatorConfig, ce as TaskSwitcher, cf as TaskSwitcherConfig, cg as TextMessage, ch as TheoryOfMind, ci as TheoryOfMindConfig, cj as ThreatEvaluator, ck as ThreatEvaluatorConfig, cl as TickListener, cm as TokenLedgerRecord, cn as TokenReportEnvelope, co as TokenTracker, cp as TokenTrackerConfig, cq as TokenUsage, cr as VectorIndex, cs as VectorMemoryAdapter, ct as VectorMemoryConfig, cu as VectorQueryFilter, cv as VectorQueryResult, cw as VectorRecord, cx as VisionEngine, cy as VoiceChunk, W as Will, cz as WillAffect, cA as WillConfig, cB as WillEffectorAct, cC as WillInstance, cD as WillMessage, cE as WillStateSummary, cF as WillStatus, cG as WillStem, cH as WillSummary, cI as WorkingMemory, cJ as WorkingMemoryConfig, cK as WorldEntity, cL as WorldInterface, cM as assembleMind, cN as clearCompletionRecorder, cO as effectorInvocation, cP as effectorInvocationEnvelope, cQ as getCompletionRecorder, cR as resolvePricing, cS as setCompletionRecorder } from './will-BDq-TMQr.js';
+
+/** Decides how emit() resolves an ack for a given envelope. Default: acked via callback. */
+type AckPolicy = (env: OutboundEnvelope) => AckResult;
+declare class LoopbackTransport implements ExternalTransport {
+    /** Every envelope passed to emit(), in order — inspect in tests. */
+    readonly sent: OutboundEnvelope[];
+    private _connected;
+    private _ackPolicy;
+    private readonly _inboundHandlers;
+    private readonly _statusHandlers;
+    constructor(ackPolicy?: AckPolicy);
+    get connected(): boolean;
+    emit(env: OutboundEnvelope): Promise<AckResult>;
+    onInbound(handler: (env: InboundEnvelope) => void): () => void;
+    onStatus(handler: (s: TransportStatus) => void): () => void;
+    close(): void;
+    /** Simulate the peer sending an inbound envelope to the Will. */
+    injectInbound(env: InboundEnvelope): void;
+    /** Flip connection state and notify status handlers. */
+    setConnected(connected: boolean): void;
+    /** Swap the ack policy mid-test (e.g. to simulate timeouts then recovery). */
+    setAckPolicy(policy: AckPolicy): void;
+    /** Convenience: only the envelopes on a given channel. */
+    sentOn<T extends OutboundEnvelope['channel']>(channel: T): Extract<OutboundEnvelope, {
+        channel: T;
+    }>[];
+}
+
+/** Minimal surface of a socket.io client we depend on — keeps us decoupled from the dep's types. */
+interface SocketLike {
+    connected: boolean;
+    on(event: string, handler: (...args: any[]) => void): void;
+    emit(event: string, payload: unknown, ack?: (response: unknown) => void): void;
+    disconnect(): void;
+}
+interface SocketIoTransportOptions {
+    /** socket.io server URL (e.g. wss://host or http://host:port). */
+    url: string;
+    /** This Will's id — sent as auth + routing key. */
+    willId: string;
+    /** Optional auth token sent in the socket.io handshake. */
+    token?: string;
+    /** Default ack timeout for emit() in ms. Default 5000. */
+    ackTimeoutMs?: number;
+    /**
+     * Override the socket factory — inject a fake in tests, or customize the
+     * socket.io connection. When omitted, `socket.io-client` is dynamically
+     * imported and `io(url, { auth })` is called.
+     */
+    socketFactory?: (url: string, opts: {
+        auth: {
+            willId: string;
+            token?: string;
+        };
+    }) => SocketLike | Promise<SocketLike>;
+}
+declare class SocketIoTransport implements ExternalTransport {
+    private readonly _opts;
+    private _socket;
+    private _connecting;
+    private _seq;
+    private readonly _inboundHandlers;
+    private readonly _statusHandlers;
+    constructor(_opts: SocketIoTransportOptions);
+    get connected(): boolean;
+    emit(env: OutboundEnvelope, opts?: {
+        ackTimeoutMs?: number;
+    }): Promise<AckResult>;
+    onInbound(handler: (env: InboundEnvelope) => void): () => void;
+    onStatus(handler: (s: TransportStatus) => void): () => void;
+    close(): void;
+    private _ensureSocket;
+    private _connect;
+    private _defaultFactory;
+    /** Attach socket.io event handlers that feed the inbound + status streams. */
+    private _wire;
+    private _emitInbound;
+    private _notifyStatus;
+    private _deliveryAck;
+    private _resultAck;
+}
+
+/** Channels a consumer can filter on (any OutboundEnvelope channel, or '*'). */
+type StreamChannel = OutboundEnvelope['channel'] | '*';
+type OutboundListener = (env: OutboundEnvelope) => void;
+declare class StreamTransport implements ExternalTransport {
+    readonly willId: string;
+    private _connected;
+    private readonly _outbound;
+    private readonly _outboundByCh;
+    private readonly _inboundHandlers;
+    private readonly _statusHandlers;
+    constructor(willId?: string);
+    get connected(): boolean;
+    /**
+     * Deliver an outbound envelope to subscribers. In-process and synchronous, so
+     * it resolves immediately (`via: 'event'`) — there is no remote peer to ack.
+     * A listener that throws is isolated; it can never break the tick loop.
+     */
+    emit(env: OutboundEnvelope): Promise<AckResult>;
+    /** Subscribe to every outbound envelope. Returns an unsubscribe function. */
+    subscribe(listener: OutboundListener): () => void;
+    /**
+     * Subscribe to a single channel (e.g. `'token_report'`, `'session_log'`,
+     * `'reply'`) or `'*'` for all. Returns an unsubscribe function.
+     */
+    on(channel: StreamChannel, listener: OutboundListener): () => void;
+    /**
+     * Inject an inbound envelope (message, percept, ack) into the Will. The stem
+     * enqueues it onto the tick-stamped InboundQueue and applies it deterministically
+     * on tick — this method itself never touches simulation state.
+     */
+    injectInbound(env: InboundEnvelope): void;
+    onInbound(handler: (env: InboundEnvelope) => void): () => void;
+    onStatus(handler: (s: TransportStatus) => void): () => void;
+    /** Notify status subscribers (e.g. flip to 'disconnected' in a test). */
+    setStatus(status: TransportStatus): void;
+    close(): void;
+    /** Total active outbound listeners (diagnostics/tests). */
+    get listenerCount(): number;
+    private _dispatch;
+}
+/**
+ * Whether producers should ALSO write their telemetry to local files.
+ *
+ * Files are a development convenience only. In production the stream/transport is
+ * the single source of truth and the consumer owns persistence.
+ *
+ * - `WILL_FILE_LOGS=true|1|false|0` — explicit override (wins).
+ * - otherwise: on when `NODE_ENV` is neither `production` nor `test`.
+ */
+declare function fileLoggingEnabled(): boolean;
+
+/**
+ * Number of ticks an undelivered outbox message survives before it is
+ * expired. Override via WILL_OUTBOX_TTL_TICKS. Default: 100 ticks.
+ */
+declare const OUTBOX_TTL_TICKS: number;
 
 /**
  * Creates a Mulberry32 PRNG from the given seed.
@@ -278,144 +416,6 @@ declare class ConflictDetector {
     private _merge;
 }
 
-/** Decides how emit() resolves an ack for a given envelope. Default: acked via callback. */
-type AckPolicy = (env: OutboundEnvelope) => AckResult;
-declare class LoopbackTransport implements ExternalTransport {
-    /** Every envelope passed to emit(), in order — inspect in tests. */
-    readonly sent: OutboundEnvelope[];
-    private _connected;
-    private _ackPolicy;
-    private readonly _inboundHandlers;
-    private readonly _statusHandlers;
-    constructor(ackPolicy?: AckPolicy);
-    get connected(): boolean;
-    emit(env: OutboundEnvelope): Promise<AckResult>;
-    onInbound(handler: (env: InboundEnvelope) => void): () => void;
-    onStatus(handler: (s: TransportStatus) => void): () => void;
-    close(): void;
-    /** Simulate the peer sending an inbound envelope to the Will. */
-    injectInbound(env: InboundEnvelope): void;
-    /** Flip connection state and notify status handlers. */
-    setConnected(connected: boolean): void;
-    /** Swap the ack policy mid-test (e.g. to simulate timeouts then recovery). */
-    setAckPolicy(policy: AckPolicy): void;
-    /** Convenience: only the envelopes on a given channel. */
-    sentOn<T extends OutboundEnvelope['channel']>(channel: T): Extract<OutboundEnvelope, {
-        channel: T;
-    }>[];
-}
-
-/** Minimal surface of a socket.io client we depend on — keeps us decoupled from the dep's types. */
-interface SocketLike {
-    connected: boolean;
-    on(event: string, handler: (...args: any[]) => void): void;
-    emit(event: string, payload: unknown, ack?: (response: unknown) => void): void;
-    disconnect(): void;
-}
-interface SocketIoTransportOptions {
-    /** socket.io server URL (e.g. wss://host or http://host:port). */
-    url: string;
-    /** This Will's id — sent as auth + routing key. */
-    willId: string;
-    /** Optional auth token sent in the socket.io handshake. */
-    token?: string;
-    /** Default ack timeout for emit() in ms. Default 5000. */
-    ackTimeoutMs?: number;
-    /**
-     * Override the socket factory — inject a fake in tests, or customize the
-     * socket.io connection. When omitted, `socket.io-client` is dynamically
-     * imported and `io(url, { auth })` is called.
-     */
-    socketFactory?: (url: string, opts: {
-        auth: {
-            willId: string;
-            token?: string;
-        };
-    }) => SocketLike | Promise<SocketLike>;
-}
-declare class SocketIoTransport implements ExternalTransport {
-    private readonly _opts;
-    private _socket;
-    private _connecting;
-    private _seq;
-    private readonly _inboundHandlers;
-    private readonly _statusHandlers;
-    constructor(_opts: SocketIoTransportOptions);
-    get connected(): boolean;
-    emit(env: OutboundEnvelope, opts?: {
-        ackTimeoutMs?: number;
-    }): Promise<AckResult>;
-    onInbound(handler: (env: InboundEnvelope) => void): () => void;
-    onStatus(handler: (s: TransportStatus) => void): () => void;
-    close(): void;
-    private _ensureSocket;
-    private _connect;
-    private _defaultFactory;
-    /** Attach socket.io event handlers that feed the inbound + status streams. */
-    private _wire;
-    private _emitInbound;
-    private _notifyStatus;
-    private _deliveryAck;
-    private _resultAck;
-}
-
-/** Channels a consumer can filter on (any OutboundEnvelope channel, or '*'). */
-type StreamChannel = OutboundEnvelope['channel'] | '*';
-type OutboundListener = (env: OutboundEnvelope) => void;
-declare class StreamTransport implements ExternalTransport {
-    readonly willId: string;
-    private _connected;
-    private readonly _outbound;
-    private readonly _outboundByCh;
-    private readonly _inboundHandlers;
-    private readonly _statusHandlers;
-    constructor(willId?: string);
-    get connected(): boolean;
-    /**
-     * Deliver an outbound envelope to subscribers. In-process and synchronous, so
-     * it resolves immediately (`via: 'event'`) — there is no remote peer to ack.
-     * A listener that throws is isolated; it can never break the tick loop.
-     */
-    emit(env: OutboundEnvelope): Promise<AckResult>;
-    /** Subscribe to every outbound envelope. Returns an unsubscribe function. */
-    subscribe(listener: OutboundListener): () => void;
-    /**
-     * Subscribe to a single channel (e.g. `'token_report'`, `'session_log'`,
-     * `'reply'`) or `'*'` for all. Returns an unsubscribe function.
-     */
-    on(channel: StreamChannel, listener: OutboundListener): () => void;
-    /**
-     * Inject an inbound envelope (message, percept, ack) into the Will. The stem
-     * enqueues it onto the tick-stamped InboundQueue and applies it deterministically
-     * on tick — this method itself never touches simulation state.
-     */
-    injectInbound(env: InboundEnvelope): void;
-    onInbound(handler: (env: InboundEnvelope) => void): () => void;
-    onStatus(handler: (s: TransportStatus) => void): () => void;
-    /** Notify status subscribers (e.g. flip to 'disconnected' in a test). */
-    setStatus(status: TransportStatus): void;
-    close(): void;
-    /** Total active outbound listeners (diagnostics/tests). */
-    get listenerCount(): number;
-    private _dispatch;
-}
-/**
- * Whether producers should ALSO write their telemetry to local files.
- *
- * Files are a development convenience only. In production the stream/transport is
- * the single source of truth and the consumer owns persistence.
- *
- * - `WILL_FILE_LOGS=true|1|false|0` — explicit override (wins).
- * - otherwise: on when `NODE_ENV` is neither `production` nor `test`.
- */
-declare function fileLoggingEnabled(): boolean;
-
-/**
- * Number of ticks an undelivered outbox message survives before it is
- * expired. Override via WILL_OUTBOX_TTL_TICKS. Default: 100 ticks.
- */
-declare const OUTBOX_TTL_TICKS: number;
-
 interface WorldProfile {
     id: string;
     name: string;
@@ -423,7 +423,7 @@ interface WorldProfile {
     /** Effectors pre-granted when this profile is active. */
     effectors: string[];
     /**
-     * Appended to the executive prompt under "## Your Environment".
+     * Appended to the executive prompt under "## My Environment".
      * Tells the Will what world it inhabits and how to behave in it.
      */
     context: string;