poly-weaver 0.2.5

package/dist/prompts.d.ts

@@ -0,0 +1,34 @@
+import type { UserClarification } from "./agents/planners/types.js";
+export declare function getVerdictSchema(): Promise<string>;
+/**
+ * Derive a human-readable feedback markdown from a review verdict.
+ */
+export declare function deriveFeedback(verdict: {
+    approved: boolean;
+    issues: Array<{
+        description: string;
+        category?: string;
+        severity?: string;
+    }>;
+    summary: string;
+}): string;
+/**
+ * Derive a feedback markdown from user comments.
+ */
+export declare function deriveUserFeedback(comments: string): string;
+/**
+ * Append one or more clarification entries to the task content.
+ * Creates the "## User Clarifications" section header on first call
+ * (startNumber === 1). Returns the updated content and next available number.
+ */
+export declare function appendClarifications(taskContent: string, entries: Array<{
+    type: "qa";
+    clarification: UserClarification;
+} | {
+    type: "comment";
+    text: string;
+}>, startNumber: number): {
+    content: string;
+    nextNumber: number;
+};
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAOpE,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAKxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE;IACP,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7E,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,MAAM,CAmBR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,aAAa,EAAE,iBAAiB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACpG,WAAW,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAuBzC"}

package/dist/prompts.js

@@ -0,0 +1,67 @@
+import { readFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SCHEMA_PATH = join(__dirname, "..", "schemas", "review-verdict.json");
+let cachedSchema = null;
+export async function getVerdictSchema() {
+    if (!cachedSchema) {
+        cachedSchema = await readFile(SCHEMA_PATH, "utf-8");
+    }
+    return cachedSchema;
+}
+/**
+ * Derive a human-readable feedback markdown from a review verdict.
+ */
+export function deriveFeedback(verdict) {
+    const lines = ["# Review Feedback", "", `**Summary:** ${verdict.summary}`, ""];
+    if (verdict.issues.length > 0) {
+        lines.push("## Issues to Address", "");
+        for (const issue of verdict.issues) {
+            if (issue.severity && issue.category) {
+                lines.push(`- **[${issue.severity.toUpperCase()}] ${issue.category}**: ${issue.description}`);
+            }
+            else if (issue.category) {
+                lines.push(`- **${issue.category}**: ${issue.description}`);
+            }
+            else {
+                lines.push(`- ${issue.description}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Derive a feedback markdown from user comments.
+ */
+export function deriveUserFeedback(comments) {
+    return ["# User Feedback", "", comments].join("\n");
+}
+/**
+ * Append one or more clarification entries to the task content.
+ * Creates the "## User Clarifications" section header on first call
+ * (startNumber === 1). Returns the updated content and next available number.
+ */
+export function appendClarifications(taskContent, entries, startNumber) {
+    if (entries.length === 0)
+        return { content: taskContent, nextNumber: startNumber };
+    const parts = [];
+    if (startNumber === 1) {
+        parts.push("\n\n---\n## User Clarifications\n\n> Points are listed in chronological order. If a later point conflicts with an earlier one, follow the later point.\n");
+    }
+    let n = startNumber;
+    for (const entry of entries) {
+        if (entry.type === "qa") {
+            parts.push(`${n}. **Q:** ${entry.clarification.question}\n   **A:** ${entry.clarification.answer}`);
+        }
+        else {
+            parts.push(`${n}. ${entry.text}`);
+        }
+        n++;
+    }
+    return {
+        content: taskContent + parts.join("\n"),
+        nextNumber: n,
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/providers/base-completion.d.ts

@@ -0,0 +1,56 @@
+import type { CompletionDetector } from "./types.js";
+import { type SessionLine } from "../session/reader.js";
+/**
+ * Base class for completion detectors that share the same poll-based lifecycle:
+ *
+ * 1. Poll the session file via `fs.stat()` (reliable on Windows, unlike fs.watch).
+ * 2. On file growth: re-read, slice by `lineOffset`, call `analyzeLines()`.
+ * 3. When `isPrimarySignalFired()` returns true and the quiet debounce elapses,
+ *    resolve with `extractResponse()`.
+ *
+ * Subclasses only implement:
+ * - `analyzeLines(lines)` — update provider-specific state
+ * - `isPrimarySignalFired()` — check if the turn is considered done
+ * - `extractResponse(lines)` — pull the final text from parsed session lines
+ *
+ * Optional override:
+ * - `shouldShortCircuit(lines)` — return true to resolve immediately (skip debounce).
+ *   Used by Codex which resolves instantly on `task_complete`.
+ */
+export declare abstract class AbstractCompletionDetector implements CompletionDetector {
+    private readonly pollMs;
+    private readonly quietMs;
+    private disposed;
+    private pollTimer;
+    private resolve;
+    private reject;
+    private lastFileSize;
+    private sessionFile;
+    private lineOffset;
+    protected lastDataTime: number;
+    protected lastParsedLines: SessionLine[];
+    constructor(pollMs?: number, quietMs?: number);
+    start(sessionFile: string, lineOffset?: number): Promise<string>;
+    onPtyData(_data: string): void;
+    dispose(): void;
+    /** Update provider-specific state from the current session lines. */
+    protected abstract analyzeLines(lines: SessionLine[]): void;
+    /** Return true when the provider's primary completion signal has fired. */
+    protected abstract isPrimarySignalFired(): boolean;
+    /** Extract the final response text from parsed session lines. */
+    protected abstract extractResponse(lines: SessionLine[]): string;
+    /**
+     * Return true to resolve immediately when new data arrives (skip debounce).
+     * Default: false. Override in providers where the primary signal is authoritative
+     * (e.g., Codex's `task_complete`).
+     */
+    protected shouldShortCircuit(_lines: SessionLine[]): boolean;
+    /**
+     * Return true to suppress PTY timer resets in `onPtyData`.
+     * Default: false. Override in providers that keep emitting TUI data after
+     * the task is done (e.g., Codex, Copilot).
+     */
+    protected shouldSuppressPtyTimerReset(): boolean;
+    private poll;
+}
+//# sourceMappingURL=base-completion.d.ts.map

package/dist/providers/base-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-completion.d.ts","sourceRoot":"","sources":["../../src/providers/base-completion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,0BAA2B,YAAW,kBAAkB;IAa1E,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAb1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,UAAU,CAAK;IAEvB,SAAS,CAAC,YAAY,SAAK;IAC3B,SAAS,CAAC,eAAe,EAAE,WAAW,EAAE,CAAM;gBAG3B,MAAM,SAAM,EACZ,OAAO,SAAM;IAGhC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAe3D,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM9B,OAAO,IAAI,IAAI;IAUf,qEAAqE;IACrE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI;IAE3D,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAI,OAAO;IAElD,iEAAiE;IACjE,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM;IAEhE;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO;IAI5D;;;;OAIG;IACH,SAAS,CAAC,2BAA2B,IAAI,OAAO;YAMlC,IAAI;CAqCnB"}

package/dist/providers/base-completion.js

@@ -0,0 +1,111 @@
+import { stat } from "node:fs/promises";
+import { readSessionFile } from "../session/reader.js";
+/**
+ * Base class for completion detectors that share the same poll-based lifecycle:
+ *
+ * 1. Poll the session file via `fs.stat()` (reliable on Windows, unlike fs.watch).
+ * 2. On file growth: re-read, slice by `lineOffset`, call `analyzeLines()`.
+ * 3. When `isPrimarySignalFired()` returns true and the quiet debounce elapses,
+ *    resolve with `extractResponse()`.
+ *
+ * Subclasses only implement:
+ * - `analyzeLines(lines)` — update provider-specific state
+ * - `isPrimarySignalFired()` — check if the turn is considered done
+ * - `extractResponse(lines)` — pull the final text from parsed session lines
+ *
+ * Optional override:
+ * - `shouldShortCircuit(lines)` — return true to resolve immediately (skip debounce).
+ *   Used by Codex which resolves instantly on `task_complete`.
+ */
+export class AbstractCompletionDetector {
+    pollMs;
+    quietMs;
+    disposed = false;
+    pollTimer = null;
+    resolve = null;
+    reject = null;
+    lastFileSize = 0;
+    sessionFile = "";
+    lineOffset = 0;
+    lastDataTime = 0;
+    lastParsedLines = [];
+    constructor(pollMs = 500, quietMs = 500) {
+        this.pollMs = pollMs;
+        this.quietMs = quietMs;
+    }
+    start(sessionFile, lineOffset = 0) {
+        this.sessionFile = sessionFile;
+        this.lineOffset = lineOffset;
+        this.lastDataTime = Date.now();
+        return new Promise((resolve, reject) => {
+            this.resolve = resolve;
+            this.reject = reject;
+            this.pollTimer = setInterval(() => {
+                void this.poll();
+            }, this.pollMs);
+        });
+    }
+    onPtyData(_data) {
+        if (!this.shouldSuppressPtyTimerReset()) {
+            this.lastDataTime = Date.now();
+        }
+    }
+    dispose() {
+        this.disposed = true;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+    }
+    /**
+     * Return true to resolve immediately when new data arrives (skip debounce).
+     * Default: false. Override in providers where the primary signal is authoritative
+     * (e.g., Codex's `task_complete`).
+     */
+    shouldShortCircuit(_lines) {
+        return false;
+    }
+    /**
+     * Return true to suppress PTY timer resets in `onPtyData`.
+     * Default: false. Override in providers that keep emitting TUI data after
+     * the task is done (e.g., Codex, Copilot).
+     */
+    shouldSuppressPtyTimerReset() {
+        return false;
+    }
+    // ── Poll loop ───────────────────────────────────────────────────────
+    async poll() {
+        if (this.disposed)
+            return;
+        try {
+            const s = await stat(this.sessionFile);
+            if (s.size === this.lastFileSize) {
+                // No new data — check if quiet debounce has passed and primary signal is ready
+                if (this.isPrimarySignalFired() &&
+                    Date.now() - this.lastDataTime >= this.quietMs) {
+                    const text = this.extractResponse(this.lastParsedLines);
+                    this.dispose();
+                    this.resolve?.(text);
+                }
+                return;
+            }
+            const lines = await readSessionFile(this.sessionFile);
+            // Update AFTER successful read — if readSessionFile() throws (e.g. EBUSY
+            // on Windows), lastFileSize stays stale so the next poll retries the read.
+            this.lastFileSize = s.size;
+            this.lastDataTime = Date.now();
+            this.lastParsedLines = lines.slice(this.lineOffset);
+            this.analyzeLines(this.lastParsedLines);
+            // Allow providers to short-circuit (e.g. Codex on task_complete)
+            if (this.shouldShortCircuit(this.lastParsedLines)) {
+                const text = this.extractResponse(this.lastParsedLines);
+                this.dispose();
+                this.resolve?.(text);
+            }
+        }
+        catch {
+            // File might not exist yet — keep polling
+        }
+    }
+}
+//# sourceMappingURL=base-completion.js.map

package/dist/providers/base-completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-completion.js","sourceRoot":"","sources":["../../src/providers/base-completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,eAAe,EAAoB,MAAM,sBAAsB,CAAC;AAEzE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAgB,0BAA0B;IAa3B;IACA;IAbX,QAAQ,GAAG,KAAK,CAAC;IACjB,SAAS,GAA0C,IAAI,CAAC;IACxD,OAAO,GAAoC,IAAI,CAAC;IAChD,MAAM,GAAkC,IAAI,CAAC;IAC7C,YAAY,GAAG,CAAC,CAAC;IACjB,WAAW,GAAG,EAAE,CAAC;IACjB,UAAU,GAAG,CAAC,CAAC;IAEb,YAAY,GAAG,CAAC,CAAC;IACjB,eAAe,GAAkB,EAAE,CAAC;IAE9C,YACmB,SAAS,GAAG,EACZ,UAAU,GAAG;QADb,WAAM,GAAN,MAAM,CAAM;QACZ,YAAO,GAAP,OAAO,CAAM;IAC7B,CAAC;IAEJ,KAAK,CAAC,WAAmB,EAAE,UAAU,GAAG,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE/B,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YAErB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;gBAChC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACnB,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAaD;;;;OAIG;IACO,kBAAkB,CAAC,MAAqB;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACO,2BAA2B;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uEAAuE;IAE/D,KAAK,CAAC,IAAI;QAChB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE1B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;gBACjC,+EAA+E;gBAC/E,IACE,IAAI,CAAC,oBAAoB,EAAE;oBAC3B,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAC9C,CAAC;oBACD,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;oBACxD,IAAI,CAAC,OAAO,EAAE,CAAC;oBACf,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAEtD,yEAAyE;YACzE,2EAA2E;YAC3E,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;YAC3B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAExC,iEAAiE;YACjE,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBACxD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;CACF"}

package/dist/providers/claude/completion.d.ts

@@ -0,0 +1,28 @@
+import type { SessionLine } from "../../session/reader.js";
+import { AbstractCompletionDetector } from "../base-completion.js";
+/**
+ * Claude completion detection using the two-signal rule:
+ *
+ * 1. **Tool-use tracking (primary)**: Track tool_use IDs in assistant messages,
+ *    mark resolved when matching tool_result appears. Complete when pending set
+ *    is empty AND at least one text output was emitted.
+ *
+ * 2. **Quiet debounce (secondary)**: No new JSONL lines for `quietMs` after
+ *    the primary signal fires.
+ *
+ * Both signals must agree before the turn is considered complete.
+ */
+export declare class ClaudeCompletionStrategy extends AbstractCompletionDetector {
+    private readonly exitToolName?;
+    private pendingToolUses;
+    private hasTextOutput;
+    private primaryFired;
+    private exitToolCalled;
+    constructor(pollMs?: number, quietMs?: number, exitToolName?: string | undefined);
+    protected analyzeLines(currentLines: SessionLine[]): void;
+    protected isPrimarySignalFired(): boolean;
+    protected shouldShortCircuit(_lines: SessionLine[]): boolean;
+    protected shouldSuppressPtyTimerReset(): boolean;
+    protected extractResponse(lines: SessionLine[]): string;
+}
+//# sourceMappingURL=completion.d.ts.map

package/dist/providers/claude/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,SAAQ,0BAA0B;IAUpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IARhC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAS;gBAG7B,MAAM,SAAM,EACZ,OAAO,SAAM,EACI,YAAY,CAAC,EAAE,MAAM,YAAA;IAKxC,SAAS,CAAC,YAAY,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI;IA4EzD,SAAS,CAAC,oBAAoB,IAAI,OAAO;cAItB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO;cAIlD,2BAA2B,IAAI,OAAO;IAIzD,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM;CAGxD"}

package/dist/providers/claude/completion.js

@@ -0,0 +1,103 @@
+import { extractClaudeResponse } from "./session.js";
+import { AbstractCompletionDetector } from "../base-completion.js";
+/**
+ * Claude completion detection using the two-signal rule:
+ *
+ * 1. **Tool-use tracking (primary)**: Track tool_use IDs in assistant messages,
+ *    mark resolved when matching tool_result appears. Complete when pending set
+ *    is empty AND at least one text output was emitted.
+ *
+ * 2. **Quiet debounce (secondary)**: No new JSONL lines for `quietMs` after
+ *    the primary signal fires.
+ *
+ * Both signals must agree before the turn is considered complete.
+ */
+export class ClaudeCompletionStrategy extends AbstractCompletionDetector {
+    exitToolName;
+    // Two-signal state
+    pendingToolUses = new Set();
+    hasTextOutput = false;
+    primaryFired = false;
+    exitToolCalled = false;
+    constructor(pollMs = 500, quietMs = 500, exitToolName) {
+        super(pollMs, quietMs);
+        this.exitToolName = exitToolName;
+    }
+    analyzeLines(currentLines) {
+        this.pendingToolUses.clear();
+        this.hasTextOutput = false;
+        this.exitToolCalled = false;
+        let hasAnyToolUse = false;
+        let lastToolActivityIdx = -1;
+        let lastAssistantTextIdx = -1;
+        let lastAssistantStopReason;
+        for (let idx = 0; idx < currentLines.length; idx++) {
+            const line = currentLines[idx];
+            if (line.type === "assistant") {
+                const message = line.message;
+                if (!message?.content)
+                    continue;
+                lastAssistantStopReason = message.stop_reason;
+                for (const block of message.content) {
+                    if (block.type === "tool_use" && block.id) {
+                        // If this is the plan-exit tool, mark it and skip tracking
+                        if (this.exitToolName && block.name === this.exitToolName) {
+                            this.exitToolCalled = true;
+                            continue;
+                        }
+                        this.pendingToolUses.add(block.id);
+                        hasAnyToolUse = true;
+                        lastToolActivityIdx = idx;
+                    }
+                    if (block.type === "text" && block.text) {
+                        this.hasTextOutput = true;
+                        lastAssistantTextIdx = idx;
+                    }
+                }
+            }
+            else if (line.type === "user") {
+                // Tool results resolve pending tool uses
+                const message = line.message;
+                if (!message?.content)
+                    continue;
+                for (const block of message.content) {
+                    if (block.type === "tool_result" && block.tool_use_id) {
+                        this.pendingToolUses.delete(block.tool_use_id);
+                        lastToolActivityIdx = idx;
+                    }
+                }
+            }
+        }
+        // Guard: stop_reason === null (strict) means the API response is still
+        // streaming content blocks. Suppress primary to avoid false completion
+        // during the gap between intermediate JSONL lines of the same response.
+        // undefined (missing field, e.g. in test data) falls through.
+        const responseIncomplete = lastAssistantStopReason === null ||
+            lastAssistantStopReason === "stop_sequence";
+        // Primary signal:
+        // - the last assistant response is not mid-stream
+        // - no pending tool uses
+        // - at least one assistant text output
+        // - if tools were used, we require assistant text to appear after the
+        //   most recent tool activity (prevents resolving between tool_result and
+        //   the final narrative/verdict message).
+        this.primaryFired =
+            !responseIncomplete &&
+                this.pendingToolUses.size === 0 &&
+                this.hasTextOutput &&
+                (!hasAnyToolUse || lastAssistantTextIdx > lastToolActivityIdx);
+    }
+    isPrimarySignalFired() {
+        return this.primaryFired;
+    }
+    shouldShortCircuit(_lines) {
+        return this.exitToolCalled && this.pendingToolUses.size === 0;
+    }
+    shouldSuppressPtyTimerReset() {
+        return this.primaryFired || (this.exitToolCalled && this.pendingToolUses.size === 0);
+    }
+    extractResponse(lines) {
+        return extractClaudeResponse(lines);
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/providers/claude/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../../src/providers/claude/completion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,wBAAyB,SAAQ,0BAA0B;IAUnD;IATnB,mBAAmB;IACX,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,aAAa,GAAG,KAAK,CAAC;IACtB,YAAY,GAAG,KAAK,CAAC;IACrB,cAAc,GAAG,KAAK,CAAC;IAE/B,YACE,MAAM,GAAG,GAAG,EACZ,OAAO,GAAG,GAAG,EACI,YAAqB;QAEtC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAFN,iBAAY,GAAZ,YAAY,CAAS;IAGxC,CAAC;IAES,YAAY,CAAC,YAA2B;QAChD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,mBAAmB,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,oBAAoB,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,uBAAkD,CAAC;QAEvD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAKR,CAAC;gBACd,IAAI,CAAC,OAAO,EAAE,OAAO;oBAAE,SAAS;gBAEhC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;gBAE9C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;wBAC1C,2DAA2D;wBAC3D,IAAI,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;4BAC1D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;4BAC3B,SAAS;wBACX,CAAC;wBACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;wBACnC,aAAa,GAAG,IAAI,CAAC;wBACrB,mBAAmB,GAAG,GAAG,CAAC;oBAC5B,CAAC;oBACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;wBACxC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;wBAC1B,oBAAoB,GAAG,GAAG,CAAC;oBAC7B,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAChC,yCAAyC;gBACzC,MAAM,OAAO,GAAG,IAAI,CAAC,OAER,CAAC;gBACd,IAAI,CAAC,OAAO,EAAE,OAAO;oBAAE,SAAS;gBAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;wBACtD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;wBAC/C,mBAAmB,GAAG,GAAG,CAAC;oBAC5B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,uEAAuE;QACvE,wEAAwE;QACxE,8DAA8D;QAC9D,MAAM,kBAAkB,GACtB,uBAAuB,KAAK,IAAI;YAChC,uBAAuB,KAAK,eAAe,CAAC;QAE9C,kBAAkB;QAClB,kDAAkD;QAClD,yBAAyB;QACzB,uCAAuC;QACvC,sEAAsE;QACtE,0EAA0E;QAC1E,0CAA0C;QAC1C,IAAI,CAAC,YAAY;YACf,CAAC,kBAAkB;gBACnB,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC;gBAC/B,IAAI,CAAC,aAAa;gBAClB,CAAC,CAAC,aAAa,IAAI,oBAAoB,GAAG,mBAAmB,CAAC,CAAC;IACnE,CAAC;IAES,oBAAoB;QAC5B,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEkB,kBAAkB,CAAC,MAAqB;QACzD,OAAO,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,CAAC;IAChE,CAAC;IAEkB,2BAA2B;QAC5C,OAAO,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACvF,CAAC;IAES,eAAe,CAAC,KAAoB;QAC5C,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/providers/claude/index.d.ts

@@ -0,0 +1,2 @@
+export { ClaudeStrategy } from "./strategy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/claude/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/providers/claude/index.js

@@ -0,0 +1,2 @@
+export { ClaudeStrategy } from "./strategy.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/claude/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/claude/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/providers/claude/session.d.ts

@@ -0,0 +1,55 @@
+import type { SessionHandler, SessionSnapshot } from "../types.js";
+import { type SessionLine } from "../../session/reader.js";
+import type { UserClarification } from "../../agents/planners/types.js";
+/**
+ * Get the Claude session base directory.
+ * Claude stores sessions at: ~/.claude/projects/{encoded-cwd}/{sessionId}.jsonl
+ */
+export declare function getClaudeSessionDir(): string;
+/**
+ * Encode a working directory path into the directory name Claude uses
+ * under ~/.claude/projects/. Claude replaces colons, forward slashes,
+ * and backslashes with hyphens.
+ */
+export declare function encodeClaudeProjectDir(cwd: string): string;
+/**
+ * Extract the last assistant response text from a Claude session file.
+ *
+ * Claude format: message.content[] where type === "text".
+ * We collect text blocks from the last assistant message sequence.
+ */
+export declare function extractClaudeResponse(lines: SessionLine[]): string;
+/**
+ * Extract the plan file path from Claude session lines.
+ *
+ * Scans for Write or Edit tool_use blocks where `input.file_path` targets
+ * the `.claude/plans/` directory. Returns the last matching path
+ * (always re-scanned on each run to avoid staleness).
+ */
+export declare function extractClaudePlanFilePath(lines: SessionLine[]): string | undefined;
+/**
+ * Extract AskUserQuestion Q&A pairs from Claude session lines.
+ *
+ * Walks forward to pair `tool_use` blocks (name === "AskUserQuestion") with
+ * their corresponding `tool_result` responses. Multi-question calls have
+ * their questions joined with "; ". Unmatched tool_use blocks are skipped.
+ */
+export declare function extractClaudeClarifications(lines: SessionLine[]): UserClarification[];
+/**
+ * Claude session handler.
+ *
+ * Handles session file discovery across Claude's per-project subdirectories
+ * and extracts clarifications from AskUserQuestion Q&A pairs.
+ */
+export declare class ClaudeSessionHandler implements SessionHandler {
+    private readonly getSessionDir;
+    constructor(getSessionDir?: () => string);
+    predictSessionFile(workdir: string, sessionId: string): string;
+    snapshot(workdir: string): Promise<SessionSnapshot>;
+    findSessionFile(snapshot: SessionSnapshot, _workdir: string): Promise<string>;
+    extractSessionId(sessionFilePath: string): Promise<string>;
+    extractClarifications(sessionFilePath: string, lineOffset: number): Promise<UserClarification[]>;
+    extractPlanFilePath(sessionFilePath: string, lineOffset: number): Promise<string | undefined>;
+    private readNewLines;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/providers/claude/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/providers/claude/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAM5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CA0BlE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,SAAS,CA8BlF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,iBAAiB,EAAE,CA8CrF;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;gBAEjC,aAAa,CAAC,EAAE,MAAM,MAAM;IAIxC,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAKxD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAOnD,eAAe,CACnB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAOZ,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1D,qBAAqB,CACzB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIzB,mBAAmB,CACvB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAIhB,YAAY;CAI3B"}