@enderfga/claw-orchestrator 3.4.2 → 3.5.5

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

@@ -0,0 +1,48 @@
+/**
+ * Autoloop — thin orchestrator.
+ *
+ * Pure transport: validates messages, dispatches to agents, handles the
+ * tiny set of runner-self-targeted messages (iter_artifacts, review_verdict,
+ * pause/resume/terminate, push_user). No LLM logic lives here — that's the
+ * AgentDispatcher's job (S2-S4 will plug in real Claude sessions; S1 ships
+ * with a mock dispatcher used by tests).
+ *
+ * Contract: tasks/autoloop.md §3.4 (phase machine lives inside Coder/Reviewer
+ * dispatchers, not here).
+ */
+import { EventEmitter } from 'node:events';
+import { type AnyAutoloopMessage } from './messages.js';
+import { type AutoloopConfig, type AutoloopState } from './types.js';
+/**
+ * Events emitted by the runner (string keys, documented payloads):
+ * - 'message'    : (env: AnyAutoloopMessage) — every routed message
+ * - 'state'      : (state: AutoloopState) — status / iter changes
+ * - 'push'       : ({ level, summary, detail?, channel }) — fired before notifyUser
+ * - 'iter_done'  : ({ iter, verdict, metric }) — Reviewer verdict committed
+ * - 'terminated' : (reason: string) — final state, no more messages
+ * - 'error'      : (err: Error) — routing or dispatcher errors
+ */
+export declare class AutoloopRunner extends EventEmitter {
+    readonly config: AutoloopConfig;
+    state: AutoloopState;
+    /** Queue of messages awaiting routing. Drained by the active dispatch loop. */
+    private queue;
+    private draining;
+    private regressionStreak;
+    private rejectStreak;
+    /** Recent push events for dedup (5 min window). */
+    private recentPushes;
+    constructor(config: AutoloopConfig);
+    start(): Promise<void>;
+    /** Enqueue a message and drain the queue. Resolves when the queue is idle. */
+    send(env: AnyAutoloopMessage): Promise<void>;
+    /** External entry: user typed something to Planner. */
+    chat(text: string): Promise<void>;
+    /** Mark subagents spawned (called by S3's spawn_subagents tool handler). */
+    markSubagentsSpawned(): void;
+    private drain;
+    private handleOne;
+    private handleRunnerInbox;
+    private handlePushUser;
+    private firePolicyPush;
+}

package/dist/src/autoloop/runner.js

@@ -0,0 +1,214 @@
+/**
+ * Autoloop — thin orchestrator.
+ *
+ * Pure transport: validates messages, dispatches to agents, handles the
+ * tiny set of runner-self-targeted messages (iter_artifacts, review_verdict,
+ * pause/resume/terminate, push_user). No LLM logic lives here — that's the
+ * AgentDispatcher's job (S2-S4 will plug in real Claude sessions; S1 ships
+ * with a mock dispatcher used by tests).
+ *
+ * Contract: tasks/autoloop.md §3.4 (phase machine lives inside Coder/Reviewer
+ * dispatchers, not here).
+ */
+import { EventEmitter } from 'node:events';
+import { AutoloopRoutingError, Msg, validateMessage } from './messages.js';
+import { DEFAULT_PUSH_POLICY } from './types.js';
+const MAX_DISPATCH_DEPTH = 64;
+/**
+ * Events emitted by the runner (string keys, documented payloads):
+ * - 'message'    : (env: AnyAutoloopMessage) — every routed message
+ * - 'state'      : (state: AutoloopState) — status / iter changes
+ * - 'push'       : ({ level, summary, detail?, channel }) — fired before notifyUser
+ * - 'iter_done'  : ({ iter, verdict, metric }) — Reviewer verdict committed
+ * - 'terminated' : (reason: string) — final state, no more messages
+ * - 'error'      : (err: Error) — routing or dispatcher errors
+ */
+export class AutoloopRunner extends EventEmitter {
+    config;
+    state;
+    /** Queue of messages awaiting routing. Drained by the active dispatch loop. */
+    queue = [];
+    draining = false;
+    regressionStreak = 0;
+    rejectStreak = 0;
+    /** Recent push events for dedup (5 min window). */
+    recentPushes = [];
+    constructor(config) {
+        super();
+        this.config = config;
+        this.state = {
+            run_id: config.run_id,
+            status: 'planning',
+            iter: 0,
+            subagents_spawned: false,
+            started_at: new Date().toISOString(),
+            workspace: config.workspace,
+            ledger_dir: config.ledger_dir,
+            push_log_count: 0,
+            status_reason: null,
+        };
+    }
+    async start() {
+        await this.config.dispatcher.init?.(this.state);
+        // Surface initial state so listeners can render the planning UI.
+        this.emit('state', this.state);
+    }
+    /** Enqueue a message and drain the queue. Resolves when the queue is idle. */
+    async send(env) {
+        validateMessage(env);
+        this.queue.push(env);
+        await this.drain();
+    }
+    /** External entry: user typed something to Planner. */
+    chat(text) {
+        return this.send(Msg.chat(this.state.iter, { text }));
+    }
+    /** Mark subagents spawned (called by S3's spawn_subagents tool handler). */
+    markSubagentsSpawned() {
+        if (this.state.subagents_spawned)
+            return;
+        this.state.subagents_spawned = true;
+        this.state.status = 'running';
+        this.emit('state', this.state);
+    }
+    // ─── Drain loop ────────────────────────────────────────────────────────────
+    async drain() {
+        if (this.draining)
+            return; // a previous send() is already draining; new items will be picked up
+        this.draining = true;
+        try {
+            let depth = 0;
+            while (this.queue.length > 0) {
+                if (depth++ > MAX_DISPATCH_DEPTH) {
+                    throw new AutoloopRoutingError(`dispatch depth exceeded ${MAX_DISPATCH_DEPTH} — likely message ping-pong`);
+                }
+                const env = this.queue.shift();
+                if (!env)
+                    break;
+                await this.handleOne(env);
+            }
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+    async handleOne(env) {
+        this.emit('message', env);
+        // Runner is the target for a small set of messages — handle them inline.
+        if (env.to === 'runner') {
+            await this.handleRunnerInbox(env);
+            return;
+        }
+        // user → planner: forward to dispatcher.
+        // user is not a real agent; we don't dispatch to it, we consume `push_user`.
+        if (env.to === 'user') {
+            await this.handlePushUser(env);
+            return;
+        }
+        // Everything else goes to the agent dispatcher.
+        if (this.state.status === 'terminated')
+            return;
+        const replies = await this.config.dispatcher.deliver(env);
+        for (const r of replies) {
+            validateMessage(r);
+            this.queue.push(r);
+        }
+    }
+    async handleRunnerInbox(env) {
+        switch (env.type) {
+            case 'iter_artifacts': {
+                // Coder produced work for iter N; ask Reviewer to audit.
+                const req = Msg.reviewRequest(env.iter, {
+                    iter: env.iter,
+                    ledger_path: this.config.ledger_dir,
+                    prior_metrics: [], // S4 will populate from metric.json
+                });
+                this.queue.push(req);
+                return;
+            }
+            case 'review_verdict': {
+                const v = env.payload;
+                const regression = v.decision === 'rollback';
+                if (v.decision === 'hold' || v.decision === 'rollback') {
+                    this.rejectStreak++;
+                }
+                else {
+                    this.rejectStreak = 0;
+                }
+                if (regression)
+                    this.regressionStreak++;
+                else
+                    this.regressionStreak = 0;
+                const done = Msg.iterDone(env.iter, {
+                    iter: env.iter,
+                    verdict: v.decision,
+                    metric: v.metric,
+                    regression,
+                });
+                this.queue.push(done);
+                this.emit('iter_done', { iter: env.iter, verdict: v.decision, metric: v.metric });
+                // Trigger policy-based push hooks.
+                if (this.regressionStreak >= 2)
+                    await this.firePolicyPush('on_metric_regression_2', env.iter);
+                if (this.rejectStreak >= 2)
+                    await this.firePolicyPush('on_reviewer_reject_2', env.iter);
+                return;
+            }
+            case 'pause': {
+                this.state.status = 'paused';
+                this.state.status_reason = env.payload.reason;
+                this.emit('state', this.state);
+                return;
+            }
+            case 'resume': {
+                if (this.state.status === 'paused') {
+                    this.state.status = 'running';
+                    this.state.status_reason = null;
+                    this.emit('state', this.state);
+                }
+                return;
+            }
+            case 'terminate': {
+                this.state.status = 'terminated';
+                this.state.status_reason = env.payload.reason;
+                this.emit('state', this.state);
+                await this.config.dispatcher.shutdown?.(env.payload.reason);
+                this.emit('terminated', env.payload.reason);
+                return;
+            }
+            default:
+                // review_request / iter_done etc. arriving with to=runner is a routing bug.
+                throw new AutoloopRoutingError(`Unexpected runner-targeted message type: ${env.type}`, env);
+        }
+    }
+    async handlePushUser(env) {
+        if (env.type !== 'push_user')
+            return;
+        const p = env.payload;
+        const key = `${p.level}:${p.summary}`;
+        const now = Date.now();
+        // 5 min dedup
+        this.recentPushes = this.recentPushes.filter((r) => now - r.ts < 5 * 60_000);
+        if (this.recentPushes.some((r) => r.key === key))
+            return;
+        this.recentPushes.push({ key, ts: now });
+        this.state.push_log_count++;
+        this.emit('push', { level: p.level, summary: p.summary, detail: p.detail, channel: p.channel });
+        await this.config.notifyUser(p.level, p.summary, p.detail, p.channel);
+    }
+    async firePolicyPush(rule, iter) {
+        const policy = this.config.push_policy ?? DEFAULT_PUSH_POLICY;
+        const r = policy[rule];
+        if (!r || r.silent)
+            return;
+        const summary = `[${rule}] iter ${iter}`;
+        // We synthesise a push_user envelope as if Planner had asked for it, so
+        // dedup + push_log book-keeping go through the same path.
+        this.queue.push(Msg.pushUser(iter, {
+            level: r.level ?? 'info',
+            summary,
+            channel: r.channel ?? 'auto',
+        }));
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/src/autoloop/runner.js.map

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

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

@@ -0,0 +1,69 @@
+/**
+ * Runner-level types for autoloop (three-agent architecture).
+ *
+ * Contract: tasks/autoloop.md.
+ */
+import type { AnyAutoloopMessage, PushChannel, PushLevel } from './messages.js';
+export type AutoloopStatus = 'planning' | 'running' | 'paused' | 'terminated' | 'crashed';
+export interface AutoloopState {
+    run_id: string;
+    status: AutoloopStatus;
+    iter: number;
+    /** Set once Planner calls `spawn_subagents`. Until then we are in "planning" mode. */
+    subagents_spawned: boolean;
+    started_at: string;
+    workspace: string;
+    ledger_dir: string;
+    push_log_count: number;
+    /** Last reason set when status flips to terminated/crashed/paused. */
+    status_reason: string | null;
+}
+export interface PushPolicyRule {
+    silent?: boolean;
+    level?: PushLevel;
+    channel?: PushChannel;
+}
+export interface PushPolicy {
+    on_start: PushPolicyRule;
+    on_iter_done_ok: PushPolicyRule;
+    on_target_hit: PushPolicyRule;
+    on_metric_regression_2: PushPolicyRule;
+    on_reviewer_reject_2: PushPolicyRule;
+    on_phase_error: PushPolicyRule;
+    on_stall_30min: PushPolicyRule;
+    on_decision_needed: PushPolicyRule;
+}
+export declare const DEFAULT_PUSH_POLICY: PushPolicy;
+/**
+ * Pluggable agent layer. The runner stays transport-only; an AgentDispatcher
+ * implementation owns the actual Claude (or mock) sessions and turns inbound
+ * messages into outbound replies. S2/S3/S4 swap mocks for real persistent
+ * sessions; the runner contract stays the same.
+ */
+export interface AgentDispatcher {
+    /**
+     * Deliver `env` to its target agent and return any messages the agent emits
+     * synchronously in reply. Asynchronous emissions should also be returned
+     * (the runner awaits this call).
+     */
+    deliver(env: AnyAutoloopMessage): Promise<AnyAutoloopMessage[]>;
+    /** Called once when the runner is starting up — agent may pre-warm sessions. */
+    init?(state: AutoloopState): Promise<void>;
+    /** Called on terminate — agent must release sessions cleanly. */
+    shutdown?(reason: string): Promise<void>;
+}
+export interface AutoloopConfig {
+    run_id: string;
+    workspace: string;
+    ledger_dir: string;
+    /** Optional override; defaults to DEFAULT_PUSH_POLICY. */
+    push_policy?: PushPolicy;
+    /**
+     * Notifier the runner calls when a `push_user` message arrives.
+     * S3 will plug in the wechat→whatsapp→email fallback chain; S1/S2 use
+     * a recording stub.
+     */
+    notifyUser: (level: PushLevel, summary: string, detail: string | undefined, channel: PushChannel) => Promise<void>;
+    /** Agent transport layer (mockable). */
+    dispatcher: AgentDispatcher;
+}

package/dist/src/autoloop/types.js

@@ -0,0 +1,16 @@
+/**
+ * Runner-level types for autoloop (three-agent architecture).
+ *
+ * Contract: tasks/autoloop.md.
+ */
+export const DEFAULT_PUSH_POLICY = {
+    on_start: { level: 'info', channel: 'wechat' },
+    on_iter_done_ok: { silent: true },
+    on_target_hit: { level: 'info', channel: 'both' },
+    on_metric_regression_2: { level: 'warn', channel: 'both' },
+    on_reviewer_reject_2: { level: 'warn', channel: 'both' },
+    on_phase_error: { level: 'error', channel: 'both' },
+    on_stall_30min: { level: 'warn', channel: 'wechat' },
+    on_decision_needed: { level: 'decision', channel: 'both' },
+};
+//# sourceMappingURL=types.js.map

package/dist/src/autoloop/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/autoloop/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;IAC9C,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;IACjC,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IACjD,sBAAsB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC1D,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IACxD,cAAc,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE;IACnD,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;IACpD,kBAAkB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE;CAC3D,CAAC"}