@enderfga/claw-orchestrator 3.4.2 → 3.5.6

package/dist/src/autoloop/dispatcher.d.ts

@@ -0,0 +1,137 @@
+/**
+ * ClaudeAgentDispatcher — wires the v2 runner to real persistent Claude
+ * sessions managed by SessionManager.
+ *
+ * S2 scope: Planner only (chat-mode, no subagents yet). Coder/Reviewer
+ * delivery throws — S4 wires them in.
+ *
+ * Naming convention:
+ *   autoloop-<run_id>-planner
+ *   autoloop-<run_id>-coder      (S4)
+ *   autoloop-<run_id>-reviewer   (S4)
+ *
+ * Reply path:
+ *   When the user chats, we sendMessage(planner, text) and capture the
+ *   Planner's natural-language reply. The reply is *not* a v2 message —
+ *   it is emitted as the dispatcher's own 'planner_reply' event so the
+ *   `autoloop_chat` plugin tool can return it to the user. Structured
+ *   signals (S3+) will be parsed out of the same reply text and pushed
+ *   into the runner queue.
+ */
+import { EventEmitter } from 'node:events';
+import type { SessionManager } from '../session-manager.js';
+import type { Logger } from '../logger.js';
+import { type AnyAutoloopMessage } from './messages.js';
+import type { AgentDispatcher, AutoloopState, PushPolicy } from './types.js';
+import { type SpawnSubagentsArgs } from './planner-tools.js';
+export interface ClaudeAgentDispatcherConfig {
+    manager: SessionManager;
+    runId: string;
+    workspace: string;
+    /** Override the default Planner system prompt (default loads from configs/autoloop-planner-prompt.md). */
+    plannerPromptPath?: string;
+    /** Override Coder/Reviewer prompt paths (defaults walk-up to configs/autoloop-{coder,reviewer}-prompt.md). */
+    coderPromptPath?: string;
+    reviewerPromptPath?: string;
+    /** Model alias for Planner (default: 'opus'). */
+    plannerModel?: string;
+    /** Default Coder model (default: 'sonnet'). Can be overridden per spawn_subagents call. */
+    coderModel?: string;
+    /** Default Reviewer model (default: 'sonnet'). */
+    reviewerModel?: string;
+    /** Per-message wall-clock cap. Default 10 min. */
+    sendTimeoutMs?: number;
+    logger?: Logger;
+    /**
+     * Auto-compact thresholds (percent of context window). When the agent's
+     * `contextPercent` (from getStats) climbs above its threshold after a
+     * turn, the dispatcher dispatches `/compact <agent-specific summary>` to
+     * that agent. Defaults: Planner 80%, Coder 70%, Reviewer 70%.
+     *
+     * Per the design doc §7: each agent's context is precious; don't let it
+     * silently fill until the API rejects.
+     */
+    compactThresholds?: {
+        planner?: number;
+        coder?: number;
+        reviewer?: number;
+    };
+    /**
+     * Push-policy ref that S3's update_push_policy mutates. Caller (SessionManager)
+     * passes its own policy object so changes are visible to the runner.
+     */
+    pushPolicyRef?: PushPolicy;
+    /** Called when Planner emits spawn_subagents. S4 implements; S3 records the intent. */
+    onSpawnSubagents?: (args: SpawnSubagentsArgs) => Promise<void>;
+}
+export declare class ClaudeAgentDispatcher extends EventEmitter implements AgentDispatcher {
+    readonly config: ClaudeAgentDispatcherConfig;
+    private logger;
+    private plannerName;
+    private coderName;
+    private reviewerName;
+    private plannerStarted;
+    private coderStarted;
+    private reviewerStarted;
+    private plannerSystemPrompt;
+    private coderSystemPrompt;
+    private reviewerSystemPrompt;
+    private coderModel;
+    private reviewerModel;
+    /** Where Reviewer reads from. Created lazily by stageReviewSandbox(). */
+    private reviewerSandboxDir;
+    private ledgerDir;
+    constructor(config: ClaudeAgentDispatcherConfig);
+    get sessionNames(): {
+        planner: string;
+        coder: string;
+        reviewer: string;
+    };
+    init(state: AutoloopState): Promise<void>;
+    shutdown(reason: string): Promise<void>;
+    deliver(env: AnyAutoloopMessage): Promise<AnyAutoloopMessage[]>;
+    /**
+     * Start Coder + Reviewer sessions. Idempotent. Called in response to a
+     * Planner spawn_subagents tool (the SessionManager wires this via
+     * onSpawnSubagents).
+     */
+    spawnSubagents(args?: SpawnSubagentsArgs): Promise<void>;
+    /**
+     * Reset a single subagent — stop its session, clear the started flag, and
+     * (optionally) eagerly start a fresh one. The session-level system prompt is
+     * the same; persistent state lives in `<ledger>/{coder,reviewer}_memory.md`
+     * which the agent reads on its first turn after reset.
+     *
+     * Refuses to reset Planner without `force: true` — Planner reset throws away
+     * the user-conversation context and must be a deliberate action.
+     */
+    resetAgent(agent: 'planner' | 'coder' | 'reviewer', opts?: {
+        force?: boolean;
+        eagerRestart?: boolean;
+    }): Promise<void>;
+    /**
+     * Wrap a subagent send. If the underlying session throws or returns an
+     * error string, auto-reset the subagent once and retry. Used by
+     * deliverToCoder / deliverToReviewer to recover from subprocess deaths.
+     */
+    private sendWithRecovery;
+    private lastCompactAt;
+    private compactSummaryFor;
+    private maybeCompact;
+    private ensurePlanner;
+    private deliverToPlanner;
+    private ensureCoder;
+    private deliverToCoder;
+    private ensureReviewer;
+    /**
+     * Stage the iter's artifacts into the Reviewer sandbox cwd. Reviewer is a
+     * persistent session whose cwd is fixed at <ledger>/reviewer_sandbox/, so
+     * every review must rewrite the sandbox to "this iter's view".
+     */
+    private stageReviewSandbox;
+    private deliverToReviewer;
+    private persistVerdict;
+    /** Run a git command in the workspace; returns combined output. Used by Coder commits. */
+    private runGit;
+    private gitCommit;
+}