@herbcaudill/ralph 0.6.5 → 0.7.0

package/dist/components/JsonOutput.js

@@ -0,0 +1,246 @@
+import React, { useState, useEffect, useRef } from "react";
+import { useApp, Text } from "ink";
+import { writeFileSync, readFileSync, existsSync } from "fs";
+import { join, dirname, basename } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { MessageQueue, createUserMessage } from "../lib/MessageQueue.js";
+import { getProgress, captureStartupSnapshot } from "../lib/getProgress.js";
+import { createDebugLogger } from "../lib/debug.js";
+import { getNextLogFile } from "../lib/getNextLogFile.js";
+import { createStdinCommandHandler } from "../lib/StdinCommandHandler.js";
+const log = createDebugLogger("iteration");
+const ralphDir = join(process.cwd(), ".ralph");
+const promptFile = join(ralphDir, "prompt.md");
+const todoFile = join(ralphDir, "todo.md");
+const beadsDir = join(process.cwd(), ".beads");
+const templatesDir = join(__dirname, "..", "..", "templates");
+const repoName = basename(process.cwd());
+/**
+ * Get the prompt content, falling back to templates if .ralph/prompt.md doesn't exist.
+ * Uses the appropriate template based on the project setup:
+ * - If .beads directory exists OR no .ralph/todo.md: use prompt-beads.md
+ * - If .ralph/todo.md exists: use prompt-todos.md (todo-based workflow)
+ */
+export const getPromptContent = () => {
+    // First, try to read from .ralph/prompt.md
+    if (existsSync(promptFile)) {
+        return readFileSync(promptFile, "utf-8");
+    }
+    // Fall back to templates based on project setup
+    const useBeadsTemplate = existsSync(beadsDir) || !existsSync(todoFile);
+    const templateFile = useBeadsTemplate ? "prompt-beads.md" : "prompt-todos.md";
+    const templatePath = join(templatesDir, templateFile);
+    if (existsSync(templatePath)) {
+        return readFileSync(templatePath, "utf-8");
+    }
+    // Last resort: return a minimal prompt
+    return "Work on the highest-priority task.";
+};
+// Output an event as newline-delimited JSON to stdout
+const outputEvent = (event) => {
+    process.stdout.write(JSON.stringify(event) + "\n");
+};
+export const JsonOutput = ({ totalIterations }) => {
+    const { exit } = useApp();
+    const [currentIteration, setCurrentIteration] = useState(1);
+    const [error, setError] = useState();
+    const [isRunning, setIsRunning] = useState(false);
+    const [startupSnapshot] = useState(() => captureStartupSnapshot());
+    const messageQueueRef = useRef(null);
+    // Log file path for this run (set once at startup, persisted across iterations)
+    const logFileRef = useRef(null);
+    const [stopAfterCurrent, setStopAfterCurrent] = useState(false); // Stop gracefully after current iteration
+    const stopAfterCurrentRef = useRef(false); // Ref to access in async callbacks
+    const [isPaused, setIsPaused] = useState(false); // Pause after current iteration completes
+    const isPausedRef = useRef(false); // Ref to access in async callbacks
+    const stdinCleanupRef = useRef(null);
+    // Keep stopAfterCurrent ref in sync with state
+    useEffect(() => {
+        stopAfterCurrentRef.current = stopAfterCurrent;
+    }, [stopAfterCurrent]);
+    // Keep isPaused ref in sync with state
+    useEffect(() => {
+        isPausedRef.current = isPaused;
+    }, [isPaused]);
+    // Set up stdin command handler for receiving commands via piped input
+    useEffect(() => {
+        const cleanup = createStdinCommandHandler(() => ({
+            messageQueue: messageQueueRef.current,
+            onStop: () => {
+                setStopAfterCurrent(true);
+                outputEvent({ type: "ralph_stop_requested" });
+            },
+            onPause: () => {
+                setIsPaused(true);
+                outputEvent({ type: "ralph_pause_requested" });
+            },
+            onResume: () => {
+                const wasPaused = isPausedRef.current;
+                setIsPaused(false);
+                outputEvent({ type: "ralph_resumed" });
+                // If we were paused between iterations, trigger the next iteration
+                if (wasPaused && !isRunning) {
+                    setTimeout(() => setCurrentIteration(i => i + 1), 100);
+                }
+            },
+            onMessage: (text) => {
+                // Output event showing we received a message command
+                outputEvent({
+                    type: "ralph_message_received",
+                    text: text.slice(0, 100) + (text.length > 100 ? "..." : ""),
+                });
+            },
+        }));
+        stdinCleanupRef.current = cleanup;
+        return () => {
+            cleanup();
+            stdinCleanupRef.current = null;
+        };
+    }, []);
+    useEffect(() => {
+        if (currentIteration > totalIterations) {
+            outputEvent({ type: "ralph_exit", reason: "max_iterations" });
+            exit();
+            return;
+        }
+        // Check if there are any tasks available before starting a round
+        const currentProgress = startupSnapshot ?
+            getProgress(startupSnapshot.initialCount, startupSnapshot.timestamp)
+            : { type: "none", completed: 0, total: 0 };
+        // All tasks are complete when completed equals total
+        if (currentProgress.completed >= currentProgress.total && currentProgress.type !== "none") {
+            outputEvent({ type: "ralph_exit", reason: "all_tasks_complete" });
+            exit();
+            process.exit(0);
+            return;
+        }
+        // Get or create the log file path for this run
+        // Only create a new sequential log file on the first iteration
+        if (!logFileRef.current) {
+            logFileRef.current = getNextLogFile();
+            writeFileSync(logFileRef.current, "");
+        }
+        // Read prompt (from .ralph/prompt.md or falling back to templates)
+        const promptContent = getPromptContent();
+        const todoExists = existsSync(todoFile);
+        const todoContent = todoExists ? readFileSync(todoFile, "utf-8") : "";
+        const fullPrompt = todoContent ? `${promptContent}\n\n## Current Todo List\n\n${todoContent}` : promptContent;
+        const abortController = new AbortController();
+        setIsRunning(true);
+        // Output iteration start event
+        outputEvent({
+            type: "ralph_iteration_start",
+            iteration: currentIteration,
+            totalIterations,
+            repo: repoName,
+        });
+        // Create a message queue for this iteration
+        const messageQueue = new MessageQueue();
+        messageQueueRef.current = messageQueue;
+        // Push the initial prompt as the first message
+        messageQueue.push(createUserMessage(fullPrompt));
+        const runQuery = async () => {
+            let finalResult = "";
+            log(`Starting iteration ${currentIteration}`);
+            try {
+                log(`Beginning query() loop`);
+                for await (const message of query({
+                    prompt: messageQueue,
+                    options: {
+                        abortController,
+                        permissionMode: "bypassPermissions",
+                        allowDangerouslySkipPermissions: true,
+                        includePartialMessages: false, // Only complete messages for JSON output
+                        env: {
+                            ...process.env,
+                            // Disable LSP plugins to avoid crashes when TypeScript LSP server errors
+                            ENABLE_LSP_TOOL: "0",
+                        },
+                    },
+                })) {
+                    log(`Received message type: ${message.type}`);
+                    // Output the raw SDK message as JSON
+                    outputEvent(message);
+                    // Capture the final result message
+                    if (message.type === "result" &&
+                        "result" in message &&
+                        typeof message.result === "string") {
+                        log(`Received result message`);
+                        finalResult = message.result;
+                        // Close the message queue immediately when we get the result.
+                        log(`Closing message queue on result`);
+                        messageQueue.close();
+                    }
+                }
+                log(`query() loop completed normally`);
+                setIsRunning(false);
+                log(`Ensuring message queue is closed`);
+                messageQueue.close();
+                messageQueueRef.current = null;
+                // Output iteration end event
+                outputEvent({
+                    type: "ralph_iteration_end",
+                    iteration: currentIteration,
+                });
+                // Check for stop-after-current request
+                if (stopAfterCurrentRef.current) {
+                    log(`Stop after current requested - exiting gracefully`);
+                    outputEvent({ type: "ralph_exit", reason: "stop_requested" });
+                    exit();
+                    process.exit(0);
+                    return;
+                }
+                // Check for completion
+                if (finalResult.includes("<promise>COMPLETE</promise>")) {
+                    outputEvent({ type: "ralph_exit", reason: "task_complete" });
+                    exit();
+                    process.exit(0);
+                    return;
+                }
+                // Check for pause request - if paused, we wait for resume via stdin
+                if (isPausedRef.current) {
+                    log(`Paused after iteration ${currentIteration}`);
+                    outputEvent({ type: "ralph_paused", iteration: currentIteration });
+                    // Don't move to next iteration - the resume handler will trigger it
+                    return;
+                }
+                // Move to next iteration
+                setTimeout(() => setCurrentIteration(i => i + 1), 500);
+            }
+            catch (err) {
+                log(`query() loop error: ${err instanceof Error ? err.message : String(err)}`);
+                setIsRunning(false);
+                log(`Closing message queue after error`);
+                messageQueue.close();
+                messageQueueRef.current = null;
+                if (abortController.signal.aborted) {
+                    log(`Abort signal detected`);
+                    return; // Intentionally aborted
+                }
+                const errorMsg = `Error running Claude: ${err instanceof Error ? err.message : String(err)}`;
+                setError(errorMsg);
+                outputEvent({ type: "ralph_error", error: errorMsg });
+                setTimeout(() => {
+                    exit();
+                    process.exit(1);
+                }, 100);
+            }
+        };
+        runQuery();
+        return () => {
+            log(`Cleanup: aborting and closing queue for iteration ${currentIteration}`);
+            abortController.abort();
+            messageQueue.close();
+            messageQueueRef.current = null;
+        };
+    }, [currentIteration, totalIterations, exit, startupSnapshot]);
+    // In JSON mode, we output to stdout, so no visual rendering needed
+    // Just return an empty component (Ink requires something to render)
+    if (error) {
+        return React.createElement(Text, null, "");
+    }
+    return React.createElement(Text, null, "");
+};
+//# sourceMappingURL=JsonOutput.js.map

package/dist/components/JsonOutput.js.map

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

package/dist/components/ProgressBar.d.ts

@@ -1,16 +1,18 @@
 import React from "react";
 /**
  * A simple progress bar component using Unicode block characters.
- * Shows completion progress: (total - remaining) / total
+ * Shows completion progress: completed / total
  */
-export declare const ProgressBar: ({ remaining, total, width }: Props) => React.JSX.Element | null;
+export declare const ProgressBar: ({ completed, total, width, repoName }: Props) => React.JSX.Element | null;
 type Props = {
-    /** Number of items remaining (open issues or unchecked tasks) */
-    remaining: number;
-    /** Total number of items at the start */
+    /** Number of items completed (closed issues or checked tasks) */
+    completed: number;
+    /** Total number of items seen since startup */
     total: number;
     /** Width of the progress bar in characters (default: 12) */
     width?: number;
+    /** Repository name to display before the progress bar */
+    repoName?: string;
 };
 export {};
 //# sourceMappingURL=ProgressBar.d.ts.map

package/dist/components/ProgressBar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../src/components/ProgressBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,6BAAkC,KAAK,6BAyBlE,CAAA;AAED,KAAK,KAAK,GAAG;IACX,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA"}
+{"version":3,"file":"ProgressBar.d.ts","sourceRoot":"","sources":["../../src/components/ProgressBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,uCAA4C,KAAK,6BA6B5E,CAAA;AAED,KAAK,KAAK,GAAG;IACX,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA"}

package/dist/components/ProgressBar.js

@@ -2,20 +2,22 @@ import React from "react";
 import { Text } from "ink";
 /**
  * A simple progress bar component using Unicode block characters.
- * Shows completion progress: (total - remaining) / total
+ * Shows completion progress: completed / total
  */
-export const ProgressBar = ({ remaining, total, width = 12 }) => {
+export const ProgressBar = ({ completed, total, width = 12, repoName }) => {
     if (total === 0) {
         return null;
     }
-    // Progress is how much is done: 1 - (remaining / total)
-    const progress = Math.min(1, Math.max(0, 1 - remaining / total));
+    // Progress is how much is done: completed / total
+    const progress = Math.min(1, Math.max(0, completed / total));
     const filledWidth = Math.round(progress * width);
     const emptyWidth = width - filledWidth;
     const filled = "▰".repeat(filledWidth);
     const empty = "▱".repeat(emptyWidth);
-    const completed = total - remaining;
     return (React.createElement(Text, null,
+        repoName && (React.createElement(React.Fragment, null,
+            React.createElement(Text, { color: "cyan" }, repoName),
+            React.createElement(Text, { dimColor: true }, " \u2502 "))),
         React.createElement(Text, { color: "yellow" }, filled),
         React.createElement(Text, { dimColor: true }, empty),
         React.createElement(Text, { dimColor: true },

package/dist/components/ProgressBar.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressBar.js","sourceRoot":"","sources":["../../src/components/ProgressBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAS,EAAE,EAAE;IACrE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,wDAAwD;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC,CAAA;IAChE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAA;IAChD,MAAM,UAAU,GAAG,KAAK,GAAG,WAAW,CAAA;IAEtC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAEpC,MAAM,SAAS,GAAG,KAAK,GAAG,SAAS,CAAA;IAEnC,OAAO,CACL,oBAAC,IAAI;QACH,oBAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,IAAE,MAAM,CAAQ;QACpC,oBAAC,IAAI,IAAC,QAAQ,UAAE,KAAK,CAAQ;QAC7B,oBAAC,IAAI,IAAC,QAAQ;YACX,GAAG;YACH,SAAS;;YAAG,KAAK;YAAE,GAAG,CAClB,CACF,CACR,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"ProgressBar.js","sourceRoot":"","sources":["../../src/components/ProgressBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,QAAQ,EAAS,EAAE,EAAE;IAC/E,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,kDAAkD;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC,CAAA;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAA;IAChD,MAAM,UAAU,GAAG,KAAK,GAAG,WAAW,CAAA;IAEtC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAEpC,OAAO,CACL,oBAAC,IAAI;QACF,QAAQ,IAAI,CACX;YACE,oBAAC,IAAI,IAAC,KAAK,EAAC,MAAM,IAAE,QAAQ,CAAQ;YACpC,oBAAC,IAAI,IAAC,QAAQ,qBAAW,CACxB,CACJ;QACD,oBAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,IAAE,MAAM,CAAQ;QACpC,oBAAC,IAAI,IAAC,QAAQ,UAAE,KAAK,CAAQ;QAC7B,oBAAC,IAAI,IAAC,QAAQ;YACX,GAAG;YACH,SAAS;;YAAG,KAAK;YAAE,GAAG,CAClB,CACF,CACR,CAAA;AACH,CAAC,CAAA"}

package/dist/components/ProgressBar.test.js

@@ -4,39 +4,52 @@ import { render } from "ink-testing-library";
 import { ProgressBar } from "./ProgressBar.js";
 describe("ProgressBar", () => {
     it("renders nothing when total is 0", () => {
-        const { lastFrame } = render(React.createElement(ProgressBar, { remaining: 0, total: 0 }));
+        const { lastFrame } = render(React.createElement(ProgressBar, { completed: 0, total: 0 }));
         expect(lastFrame()).toBe("");
     });
-    it("shows empty bar when all tasks remain", () => {
-        const { lastFrame } = render(React.createElement(ProgressBar, { remaining: 10, total: 10, width: 10 }));
+    it("shows empty bar when no tasks completed", () => {
+        const { lastFrame } = render(React.createElement(ProgressBar, { completed: 0, total: 10, width: 10 }));
         const output = lastFrame();
         expect(output).toContain("▱▱▱▱▱▱▱▱▱▱");
         expect(output).toContain("0/10");
     });
-    it("shows full bar when no tasks remain", () => {
-        const { lastFrame } = render(React.createElement(ProgressBar, { remaining: 0, total: 10, width: 10 }));
+    it("shows full bar when all tasks completed", () => {
+        const { lastFrame } = render(React.createElement(ProgressBar, { completed: 10, total: 10, width: 10 }));
         const output = lastFrame();
         expect(output).toContain("▰▰▰▰▰▰▰▰▰▰");
         expect(output).toContain("10/10");
     });
-    it("shows half bar when half remain", () => {
-        const { lastFrame } = render(React.createElement(ProgressBar, { remaining: 5, total: 10, width: 10 }));
+    it("shows half bar when half completed", () => {
+        const { lastFrame } = render(React.createElement(ProgressBar, { completed: 5, total: 10, width: 10 }));
         const output = lastFrame();
         expect(output).toContain("▰▰▰▰▰");
         expect(output).toContain("▱▱▱▱▱");
         expect(output).toContain("5/10");
     });
     it("respects custom width", () => {
-        const { lastFrame } = render(React.createElement(ProgressBar, { remaining: 0, total: 10, width: 5 }));
+        const { lastFrame } = render(React.createElement(ProgressBar, { completed: 10, total: 10, width: 5 }));
         const output = lastFrame();
         // Should have 5 filled blocks
         expect(output).toMatch(/▰{5}/);
     });
     it("clamps progress to 0-100%", () => {
-        // More remaining than total (shouldn't happen, but handle gracefully)
-        const { lastFrame } = render(React.createElement(ProgressBar, { remaining: 15, total: 10, width: 10 }));
+        // More completed than total (shouldn't happen, but handle gracefully)
+        const { lastFrame } = render(React.createElement(ProgressBar, { completed: 15, total: 10, width: 10 }));
         const output = lastFrame();
-        expect(output).toContain("▱▱▱▱▱▱▱▱▱▱");
+        expect(output).toContain("▰▰▰▰▰▰▰▰▰▰");
+    });
+    it("displays repo name when provided", () => {
+        const { lastFrame } = render(React.createElement(ProgressBar, { completed: 5, total: 10, width: 10, repoName: "my-repo" }));
+        const output = lastFrame();
+        expect(output).toContain("my-repo");
+        expect(output).toContain("│");
+        expect(output).toContain("5/10");
+    });
+    it("does not display repo name when not provided", () => {
+        const { lastFrame } = render(React.createElement(ProgressBar, { completed: 5, total: 10, width: 10 }));
+        const output = lastFrame();
+        expect(output).not.toContain("│");
+        expect(output).toContain("5/10");
     });
 });
 //# sourceMappingURL=ProgressBar.test.js.map

package/dist/components/ProgressBar.test.js.map

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

package/dist/lib/MessageQueue.d.ts

@@ -7,8 +7,10 @@ export declare class MessageQueue implements AsyncIterable<SDKUserMessage> {
     private queue;
     private resolvers;
     private closed;
+    private nextCallCount;
     push(message: SDKUserMessage): void;
     close(): void;
+    private getMessagePreview;
     [Symbol.asyncIterator](): AsyncIterator<SDKUserMessage>;
 }
 /**

package/dist/lib/MessageQueue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageQueue.d.ts","sourceRoot":"","sources":["../../src/lib/MessageQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAEpE;;;GAGG;AACH,qBAAa,YAAa,YAAW,aAAa,CAAC,cAAc,CAAC;IAChE,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAA8D;IAC/E,OAAO,CAAC,MAAM,CAAQ;IAEtB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAWnC,KAAK,IAAI,IAAI;IASb,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,cAAc,CAAC;CAexD;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,cAQ/C,CAAA"}
+{"version":3,"file":"MessageQueue.d.ts","sourceRoot":"","sources":["../../src/lib/MessageQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAKpE;;;GAGG;AACH,qBAAa,YAAa,YAAW,aAAa,CAAC,cAAc,CAAC;IAChE,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAA8D;IAC/E,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,aAAa,CAAI;IAEzB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAmBnC,KAAK,IAAI,IAAI;IAgBb,OAAO,CAAC,iBAAiB;IAYzB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,cAAc,CAAC;CAwBxD;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,cAQ/C,CAAA"}

package/dist/lib/MessageQueue.js

@@ -1,3 +1,5 @@
+import { createDebugLogger } from "./debug.js";
+const log = createDebugLogger("messagequeue");
 /**
  * A message queue that can be used as an async iterable for the SDK's streamInput.
  * Allows pushing messages dynamically while iterating.
@@ -6,34 +8,65 @@ export class MessageQueue {
     queue = [];
     resolvers = [];
     closed = false;
+    nextCallCount = 0;
     push(message) {
-        if (this.closed)
+        const messagePreview = this.getMessagePreview(message);
+        log(`push() called with message: ${messagePreview}`);
+        if (this.closed) {
+            log(`push() ignored - queue is closed`);
             return;
+        }
         if (this.resolvers.length > 0) {
             const resolve = this.resolvers.shift();
+            log(`push() resolving pending next() call (${this.resolvers.length} resolvers remaining)`);
             resolve({ value: message, done: false });
         }
         else {
             this.queue.push(message);
+            log(`push() added to queue (queue length: ${this.queue.length})`);
         }
     }
     close() {
+        if (this.closed) {
+            log(`close() called but already closed - no-op`);
+            return;
+        }
+        log(`close() called - resolving ${this.resolvers.length} pending resolvers`);
         this.closed = true;
         // Resolve any pending iterators
         for (const resolve of this.resolvers) {
+            log(`close() resolving pending resolver with done=true`);
             resolve({ value: undefined, done: true });
         }
         this.resolvers = [];
+        log(`close() complete`);
+    }
+    getMessagePreview(message) {
+        const content = message.message?.content;
+        if (Array.isArray(content) && content.length > 0) {
+            const firstBlock = content[0];
+            if ("text" in firstBlock && typeof firstBlock.text === "string") {
+                const text = firstBlock.text.slice(0, 50);
+                return text.length < firstBlock.text.length ? `"${text}..."` : `"${text}"`;
+            }
+        }
+        return `[${message.type} message]`;
     }
     [Symbol.asyncIterator]() {
         return {
             next: () => {
+                this.nextCallCount++;
+                const callId = this.nextCallCount;
                 if (this.queue.length > 0) {
-                    return Promise.resolve({ value: this.queue.shift(), done: false });
+                    const message = this.queue.shift();
+                    log(`next() #${callId}: returning queued message (${this.queue.length} remaining)`);
+                    return Promise.resolve({ value: message, done: false });
                 }
                 if (this.closed) {
+                    log(`next() #${callId}: queue closed, returning done=true`);
                     return Promise.resolve({ value: undefined, done: true });
                 }
+                log(`next() #${callId}: queue empty, creating pending resolver (${this.resolvers.length + 1} total)`);
                 return new Promise(resolve => {
                     this.resolvers.push(resolve);
                 });

package/dist/lib/MessageQueue.js.map

@@ -1 +1 @@
-{"version":3,"file":"MessageQueue.js","sourceRoot":"","sources":["../../src/lib/MessageQueue.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAqB,EAAE,CAAA;IAC5B,SAAS,GAA4D,EAAE,CAAA;IACvE,MAAM,GAAG,KAAK,CAAA;IAEtB,IAAI,CAAC,OAAuB;QAC1B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QAEvB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAA;YACvC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC1C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,gCAAgC;QAChC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAsC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACxE,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAA;IACrB,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,GAA4C,EAAE;gBAClD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;gBACrE,CAAC;gBACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAsC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;gBACvF,CAAC;gBACD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;oBAC3B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBAC9B,CAAC,CAAC,CAAA;YACJ,CAAC;SACF,CAAA;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAkB,EAAE,CAAC,CAAC;IAClE,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,EAAE;IACd,OAAO,EAAE;QACP,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAClC;IACD,kBAAkB,EAAE,IAAI;CACzB,CAAC,CAAA"}
+{"version":3,"file":"MessageQueue.js","sourceRoot":"","sources":["../../src/lib/MessageQueue.ts"],"names":[],"mappings":"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"}