zcode-acp-server 0.31.1 → 0.33.0

package/README.md

@@ -237,7 +237,9 @@ Thanks to everyone who has contributed (updated automatically from the
 [contributors graph](https://github.com/william0wang/zcode-acp/graphs/contributors)):
 
 <a href="https://github.com/william0wang/zcode-acp/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=william0wang/zcode-acp" alt="Contributors" />
+  <!-- release-please re-stamps &v= on every release: the new URL busts the
+       contrib.rocks and GitHub camo image caches. -->
+  <img src="https://contrib.rocks/image?repo=william0wang/zcode-acp&v=0.33.0" alt="Contributors" /> <!-- x-release-please-version -->
 </a>
 
 ## Related Projects

package/dist/code-fingerprint.json

@@ -1,4 +1,4 @@
 {
-  "fingerprint": "e6dadb69fa6f9cfd7e0da8827d2c0ee439aa10042e127a91a059bf95db436c8a",
-  "fileCount": 72
+  "fingerprint": "7a587b589239abea7088f51681879c929f0c30580112c1aa9dfa93f8e1f69fce",
+  "fileCount": 75
 }

package/dist/goal-loop/driver.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Goal-loop driver (ADR-0022): the bridge-driven autonomous turn chain.
+ *
+ * Round shape: one ticket per `session/send` turn via the shared
+ * {@link runOneTurn} machinery, a worker self-report VERDICT, and — only on a
+ * claimed `met` — one verification turn that re-runs the acceptance criteria
+ * (never trust the worker's report). Compaction runs at round boundaries
+ * (handoff turn → session/compact → the next dispatch reads the handoff doc).
+ *
+ * User interaction: rounds register in `pendingTurns` with `goalLoop: true`
+ * INSIDE withPreemptLock — `preemptInFlightTurn` skips them and the prompt
+ * path parks the incoming prompt on the driver instead (merge at the next
+ * boundary). ESC/cancel still cancels the in-flight round (pause follows).
+ * While prompts are parked, a 60s keepalive keeps clients from hitting their
+ * idle deadlines during the quiet judge/compaction windows.
+ */
+import type * as acp from "@agentclientprotocol/sdk";
+import type { ZcodeAcpServer } from "../server.js";
+/** ENV: ZCODE_ACP_GOAL_MAX_TURNS — hard round budget before a pause. */
+export declare function goalMaxTurns(): number;
+/** Goal-loop compaction threshold: the shared env var, else 80% of window. */
+export declare function goalCompactThreshold(contextWindow: number): number;
+export declare class GoalLoopDriver {
+    readonly zcodeSid: string;
+    private readonly server;
+    private readonly acpSid;
+    private state;
+    private pauseFlag;
+    private stopFlag;
+    private parked;
+    private parkSeq;
+    private keepalive;
+    private runId;
+    /** Set when the last goal turn was cancelled by the sandbox allow-restart. */
+    private lastSandboxRestart;
+    private constructor();
+    /** Live driver for a session, when a loop is running. */
+    static live(server: ZcodeAcpServer, zcodeSid: string): GoalLoopDriver | undefined;
+    /**
+     * Start (or resume) the loop for a session. Resuming adopts the persisted
+     * state (round count, tickets, parked text); a fresh start decomposes the
+     * objective into tickets first.
+     */
+    static start(server: ZcodeAcpServer, acpSid: string, zcodeSid: string, objective: string, opts?: {
+        resume?: boolean;
+    }): GoalLoopDriver;
+    /** Pause at the next round boundary (the in-flight round keeps running). */
+    pause(): void;
+    /**
+     * External pause request — session/cancel during a quiet window with no
+     * registered turn (e.g. compact()'s internal wait): same flag as pause(),
+     * consumed at the next boundary.
+     */
+    requestPause(): void;
+    /** Clear a pending pause/stop (/auto resume before the boundary takes it). */
+    resume(): void;
+    /** Stop at the next boundary and clear persisted state. */
+    stop(): void;
+    /** One-line status for /auto status. */
+    statusText(): string;
+    /**
+     * Park an incoming user prompt (called by the prompt path when a goalLoop
+     * turn is in flight). Resolves when the merged round completes — or
+     * `cancelled` if the loop pauses/stops first (text preserved in state).
+     */
+    parkPrompt(text: string): Promise<acp.PromptResponse>;
+    private armKeepalive;
+    private disarmKeepalive;
+    /**
+     * Resolve parked prompts. Without a `snapshot`, everything currently parked
+     * settles (pause/stop/end-of-loop paths). With one, ONLY the snapshot's
+     * entries resolve — prompts parked DURING a round (the common steering
+     * window) stay parked and their text merges into the NEXT round instead of
+     * being silently resolved-and-dropped (ADR-0022 §3).
+     */
+    private settleParked;
+    /** One goal-loop turn through the shared runOneTurn (goalLoop-marked). */
+    private runGoalTurn;
+    /** Consume the sandbox-restart mark set by the last runGoalTurn. */
+    private consumeSandboxRestart;
+    /**
+     * Wait out in-flight NON-goal turns for this session before the first
+     * round: a send landing mid-generation is accepted as steer input and its
+     * text silently dropped when the old turn finishes (see AGENTS.md) — the
+     * decompose prompt would be injected into the foreign conversation and the
+     * tickets parsed from its reply. Real agent turns run minutes, so on timeout
+     * the wait PRE-EMPTS the editor turn with the same semantics a normal
+     * prompt uses (cancel flag + stop pair via preemptInFlightTurn) — proceeding
+     * would land the decompose send as steer input into the live conversation.
+     * runOneTurn's drain gate, armed by the pre-empt's lastCancelledAt mark,
+     * settles the backend before the decompose send.
+     */
+    private waitForEditorTurnsIdle;
+    /** Text of the last assistant reply at or after `since` (verdict parsing input). */
+    private lastAssistantText;
+    /** Tool-part count in the messages appended since `before` (stall signal). */
+    private toolActivitySince;
+    private messageCount;
+    private contextUsed;
+    private announce;
+    private persist;
+    private endLoop;
+    private run;
+    private runRounds;
+    private contextWindowFromRead;
+    /**
+     * Handoff turn → session/compact → mark handoffFresh for the next round.
+     * Returns true when the handoff turn was cancelled (ESC / restart).
+     */
+    private compactBoundary;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/goal-loop/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/goal-loop/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,GAAG,MAAM,0BAA0B,CAAC;AAOrD,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,cAAc,CAAC;AAsBhE,wEAAwE;AACxE,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAIlE;AAiBD,qBAAa,cAAc;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,KAAK,CAAK;IAClB,8EAA8E;IAC9E,OAAO,CAAC,kBAAkB,CAAS;IAEnC,OAAO;IAYP,yDAAyD;IACzD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKjF;;;;OAIG;IACH,MAAM,CAAC,KAAK,CACV,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAC9B,cAAc;IA+BjB,4EAA4E;IAC5E,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,YAAY,IAAI,IAAI;IAIpB,8EAA8E;IAC9E,MAAM,IAAI,IAAI;IAKd,2DAA2D;IAC3D,IAAI,IAAI,IAAI;IAIZ,wCAAwC;IACxC,UAAU,IAAI,MAAM;IAcpB;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAOrD,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,eAAe;IAKvB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAqBpB,0EAA0E;YAC5D,WAAW;IAmCzB,oEAAoE;IACpE,OAAO,CAAC,qBAAqB;IAM7B;;;;;;;;;;;OAWG;YACW,sBAAsB;IAcpC,oFAAoF;YACtE,iBAAiB;IAe/B,8EAA8E;YAChE,iBAAiB;YAUjB,YAAY;YAKZ,WAAW;YAWX,QAAQ;IAStB,OAAO,CAAC,OAAO;YAID,OAAO;YAgBP,GAAG;YAoBH,SAAS;YAoNT,qBAAqB;IAWnC;;;OAGG;YACW,eAAe;CA0B9B"}