zora-agent 0.9.4 → 0.9.6

package/dist/orchestrator/orchestrator.d.ts

@@ -10,10 +10,12 @@
  *     and memory context injection into a unified execution path.
  */
 import type { ZoraConfig, ZoraPolicy, LLMProvider, CostTier, AgentEvent } from '../types.js';
+import { HookRunner } from '../hooks/hook-runner.js';
 import { Router } from './router.js';
 import { RetryQueue } from './retry-queue.js';
 import { AuthMonitor } from './auth-monitor.js';
 import { SessionManager } from './session-manager.js';
+import { type TransformContextFn } from './execution-loop.js';
 import { SteeringManager } from '../steering/steering-manager.js';
 import { MemoryManager } from '../memory/memory-manager.js';
 import { PolicyEngine } from '../security/policy-engine.js';
@@ -30,6 +32,8 @@ export interface SubmitTaskOptions {
     maxTurns?: number;
     jobId?: string;
     onEvent?: (event: AgentEvent) => void;
+    /** ORCH-14: Optional context transform callback applied to history before follow-ups */
+    transformContext?: TransformContextFn;
 }
 export declare class Orchestrator {
     private readonly _config;
@@ -46,14 +50,34 @@ export declare class Orchestrator {
     private _policyEngine;
     private _notifications;
     private _intentCapsuleManager;
+    private _leakDetector;
     private _heartbeatSystem;
     private _routineManager;
+    private _validationPipeline;
+    private _hookRunner;
+    private _transformContext;
+    private _observationStore;
     private _authCheckTimeout;
     private _retryPollTimeout;
+    private _consolidationTimeout;
     private _booted;
     constructor(options: OrchestratorOptions);
     /**
      * Boots all subsystems and starts background loops.
+     *
+     * Initialization order:
+     *  1. PolicyEngine + IntentCapsuleManager (security layer).
+     *  2. SessionManager (event persistence).
+     *  3. SteeringManager (human-in-the-loop).
+     *  4. MemoryManager (context injection).
+     *  5. Router (provider selection).
+     *  6. FailoverController (error recovery).
+     *  7. RetryQueue (deferred retry).
+     *  8. AuthMonitor (periodic auth checks every 5 min).
+     *  9. HeartbeatSystem + RoutineManager (scheduled tasks).
+     *
+     * Background loops use self-rescheduling setTimeout (not setInterval)
+     * to avoid overlapping async executions.
      */
     boot(): Promise<void>;
     /**
@@ -61,23 +85,56 @@ export declare class Orchestrator {
      */
     shutdown(): Promise<void>;
     /**
-     * Submits a task through the full orchestration pipeline:
-     * 1. Load memory context (R6)
-     * 2. Classify and route to provider (R2)
-     * 3. Execute with event persistence (R8) and steering (R7)
-     * 4. Handle failures with failover (R3) and retry (R5)
+     * Submits a task through the full orchestration pipeline.
+     *
+     * Pipeline stages:
+     *  1. Load memory context from MemoryManager (daily notes, long-term items).
+     *  2. Load SOUL.md identity file and build the system prompt with policy awareness hints.
+     *  3. Create a signed intent capsule for goal drift detection (ASI01).
+     *  4. Classify the task by complexity and resource type for routing.
+     *  5. Route to the best available provider via the Router.
+     *  6. Execute via _executeWithProvider, which handles event persistence,
+     *     steering injection, failover, and retry queueing.
+     *
+     * @returns The final text result from the provider's 'done' event.
+     * @throws If no provider is available or all failover attempts fail.
      */
     submitTask(options: SubmitTaskOptions): Promise<string>;
-    /** Symbol used to mark errors that have already been through the failover path */
-    private static readonly _FAILOVER_SENTINEL;
+    /** Tracks errors that have already been through the failover path */
+    private static readonly _failoverErrors;
     /** Maximum depth of failover recursion to prevent unbounded re-execution */
     private static readonly MAX_FAILOVER_DEPTH;
+    /** ORCH-16: Maximum depth of onTaskEnd follow-up injection loops */
+    private static readonly MAX_INJECTION_LOOPS;
     /**
      * Executes a task with a specific provider, handling failover and event persistence.
+     *
+     * During execution, this method:
+     * - Persists every event to the SessionManager for crash recovery.
+     * - Polls SteeringManager after text/tool_result events, injecting any pending
+     *   human steering messages into the event stream.
+     * - On error events: attempts failover via FailoverController. If failover
+     *   succeeds, recurses with the new provider (incrementing failoverDepth).
+     *   If failover fails, enqueues the task in the RetryQueue.
+     * - failoverDepth is capped at MAX_FAILOVER_DEPTH (3) to prevent unbounded recursion.
+     * - The _failoverErrors WeakSet prevents double-failover: errors already processed
+     *   by the failover path are not re-triggered in the outer catch block.
      */
     private _executeWithProvider;
+    /**
+     * MEM-09: Runs memory extraction asynchronously after job completion.
+     *
+     * Collects text events from the job history, passes them through
+     * ExtractionPipeline, deduplicates against existing items, and
+     * persists new items via StructuredMemory. Appends a daily note
+     * summarizing what was extracted.
+     *
+     * Runs fire-and-forget — errors are caught by the caller.
+     */
+    private _runExtractionAsync;
     /**
      * Creates custom tools available to the agent during execution.
+     * Includes: permission tools, memory tools (search/save/forget), recall_context.
      */
     private _createCustomTools;
     /**
@@ -93,6 +150,12 @@ export declare class Orchestrator {
     get authMonitor(): AuthMonitor;
     get retryQueue(): RetryQueue;
     get policyEngine(): PolicyEngine;
+    /** ORCH-12: Access the hook runner for registering lifecycle hooks */
+    get hookRunner(): HookRunner;
+    /** ORCH-14: Set a custom context transform function */
+    set transformContext(fn: TransformContextFn);
+    /** ORCH-14: Get the current context transform function */
+    get transformContext(): TransformContextFn;
     get config(): ZoraConfig;
     get providers(): LLMProvider[];
 }

package/dist/orchestrator/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/orchestrator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/orchestrator.ts"],"names":[],"mappings":"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"}