@herbcaudill/ralph 0.6.4 → 0.7.0

package/dist/lib/MessageQueue.test.js

@@ -60,6 +60,21 @@ describe("MessageQueue", () => {
         const result = await promise;
         expect(result.done).toBe(true);
     });
+    it("should be idempotent when close() is called multiple times", async () => {
+        const queue = new MessageQueue();
+        const msg = createUserMessage("test");
+        queue.push(msg);
+        const iterator = queue[Symbol.asyncIterator]();
+        const result1 = await iterator.next();
+        expect(result1.value).toEqual(msg);
+        // Close multiple times - should not throw or cause issues
+        queue.close();
+        queue.close();
+        queue.close();
+        // Iterator should still work correctly
+        const result2 = await iterator.next();
+        expect(result2.done).toBe(true);
+    });
 });
 describe("createUserMessage", () => {
     it("should create a valid SDK user message", () => {
@@ -75,4 +90,135 @@ describe("createUserMessage", () => {
         });
     });
 });
+describe("MessageQueue hang scenarios", () => {
+    /**
+     * This test documents the hang behavior that can occur when:
+     * 1. The SDK iterates the MessageQueue via streamInput()
+     * 2. The MessageQueue is empty and not closed
+     * 3. The SDK calls next() expecting more messages
+     *
+     * In this case, next() returns a Promise that never resolves
+     * until close() is called. If close() is only called after the
+     * SDK iteration completes, we have a deadlock.
+     */
+    it("should hang if next() is called on empty unclosed queue", async () => {
+        const queue = new MessageQueue();
+        const msg = createUserMessage("test");
+        queue.push(msg);
+        const iterator = queue[Symbol.asyncIterator]();
+        // First next() returns the queued message
+        const result1 = await iterator.next();
+        expect(result1.done).toBe(false);
+        expect(result1.value).toEqual(msg);
+        // Second next() on empty queue - this will hang until close() is called
+        // Use a timeout to demonstrate the hang behavior
+        const nextPromise = iterator.next();
+        let resolved = false;
+        nextPromise.then(() => {
+            resolved = true;
+        });
+        // Wait a bit - the promise should NOT resolve
+        await new Promise(resolve => setTimeout(resolve, 50));
+        expect(resolved).toBe(false);
+        // Now close the queue - this should resolve the pending promise
+        queue.close();
+        // Wait for the promise to resolve
+        const result2 = await nextPromise;
+        expect(result2.done).toBe(true);
+        expect(resolved).toBe(true);
+    });
+    it("should allow timeout-based iteration completion", async () => {
+        const queue = new MessageQueue();
+        const msg = createUserMessage("test");
+        queue.push(msg);
+        // Use Promise.race to implement timeout behavior
+        const iterator = queue[Symbol.asyncIterator]();
+        const result1 = await iterator.next();
+        expect(result1.value).toEqual(msg);
+        // Create a "timeout" mechanism
+        const timeoutPromise = new Promise(resolve => setTimeout(() => resolve({ done: true, value: undefined }), 100));
+        // Race between next message and timeout
+        const result = await Promise.race([iterator.next(), timeoutPromise]);
+        expect(result.done).toBe(true);
+        // Clean up
+        queue.close();
+    });
+    it("should close queue when abort signal is triggered", async () => {
+        const queue = new MessageQueue();
+        const msg = createUserMessage("test");
+        queue.push(msg);
+        const abortController = new AbortController();
+        // Set up abort listener to close queue
+        abortController.signal.addEventListener("abort", () => {
+            queue.close();
+        });
+        const iterator = queue[Symbol.asyncIterator]();
+        // Get the first message
+        const result1 = await iterator.next();
+        expect(result1.value).toEqual(msg);
+        // Start waiting for next (which would hang)
+        const nextPromise = iterator.next();
+        let resolved = false;
+        nextPromise.then(() => {
+            resolved = true;
+        });
+        // Abort should close the queue and resolve pending iterators
+        abortController.abort();
+        const result2 = await nextPromise;
+        expect(result2.done).toBe(true);
+        expect(resolved).toBe(true);
+    });
+    it("should work with AbortSignal.timeout pattern", async () => {
+        const queue = new MessageQueue();
+        const msg = createUserMessage("test");
+        queue.push(msg);
+        // Create an abort signal that times out after 50ms
+        const signal = AbortSignal.timeout(50);
+        // Set up abort listener to close queue
+        signal.addEventListener("abort", () => {
+            queue.close();
+        });
+        const iterator = queue[Symbol.asyncIterator]();
+        // Get the first message
+        const result1 = await iterator.next();
+        expect(result1.value).toEqual(msg);
+        // Start waiting for next (which would hang without timeout)
+        const result2 = await iterator.next();
+        // The timeout should have triggered, closing the queue
+        expect(result2.done).toBe(true);
+    });
+    it("should handle multiple pending resolvers with abort", async () => {
+        const queue = new MessageQueue();
+        const abortController = new AbortController();
+        abortController.signal.addEventListener("abort", () => {
+            queue.close();
+        });
+        const iterator = queue[Symbol.asyncIterator]();
+        // Start multiple pending next() calls
+        const promise1 = iterator.next();
+        const promise2 = iterator.next();
+        const promise3 = iterator.next();
+        // All should be pending
+        let resolved1 = false, resolved2 = false, resolved3 = false;
+        promise1.then(() => {
+            resolved1 = true;
+        });
+        promise2.then(() => {
+            resolved2 = true;
+        });
+        promise3.then(() => {
+            resolved3 = true;
+        });
+        await new Promise(resolve => setTimeout(resolve, 10));
+        expect(resolved1).toBe(false);
+        expect(resolved2).toBe(false);
+        expect(resolved3).toBe(false);
+        // Abort should resolve all pending promises
+        abortController.abort();
+        const [result1, result2, result3] = await Promise.all([promise1, promise2, promise3]);
+        expect(result1.done).toBe(true);
+        expect(result2.done).toBe(true);
+        expect(result3.done).toBe(true);
+    });
+});
 //# sourceMappingURL=MessageQueue.test.js.map

package/dist/lib/MessageQueue.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"MessageQueue.test.js","sourceRoot":"","sources":["../../src/lib/MessageQueue.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAEnE,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;QAEvC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChB,KAAK,CAAC,KAAK,EAAE,CAAA;QAEb,MAAM,QAAQ,GAAG,EAAE,CAAA;QACnB,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACpB,CAAC;QAED,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAA;QAChC,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;QAExC,kBAAkB;QAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAA;QAE9C,mCAAmC;QACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;QAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEhB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAA;QAC9B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAEhC,sBAAsB;QACtB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;QAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEhB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAA;QAC9B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAEhC,wBAAwB;QACxB,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QACrC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAA;QAChC,MAAM,GAAG,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;QAErC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACf,KAAK,CAAC,KAAK,EAAE,CAAA;QAEb,wCAAwC;QACxC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAA;QAExC,MAAM,QAAQ,GAAG,EAAE,CAAA;QACnB,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAClB,CAAC;QAED,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAA;QAEhC,mDAAmD;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAA;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAA;QAE/B,2CAA2C;QAC3C,KAAK,CAAC,KAAK,EAAE,CAAA;QAEb,MAAM,MAAM,GAAG,MAAM,OAAO,CAAA;QAC5B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,OAAO,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAA;QAElD,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACtB,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,EAAE;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;aACnD;YACD,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"MessageQueue.test.js","sourceRoot":"","sources":["../../src/lib/MessageQueue.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/StdinCommandHandler.d.ts

@@ -0,0 +1,42 @@
+import { MessageQueue } from "./MessageQueue.js";
+/**
+ * Stdin command types:
+ * - {"type": "message", "text": "..."} - Send a message to Claude
+ * - {"type": "stop"} - Request graceful stop after current iteration
+ * - {"type": "pause"} - Pause after current iteration completes
+ * - {"type": "resume"} - Resume from paused state
+ */
+export type StdinCommand = {
+    type: "message";
+    text: string;
+} | {
+    type: "stop";
+} | {
+    type: "pause";
+} | {
+    type: "resume";
+};
+/**
+ * Parse a JSON string into a StdinCommand.
+ * Returns null if parsing fails or the command is invalid.
+ */
+export declare const parseStdinCommand: (line: string) => StdinCommand | null;
+export type StdinCommandHandlerOptions = {
+    messageQueue: MessageQueue | null;
+    onStop: () => void;
+    onPause?: () => void;
+    onResume?: () => void;
+    onMessage?: (text: string) => void;
+};
+/**
+ * Creates a stdin command handler that reads JSON commands from stdin.
+ * Returns a cleanup function to stop reading.
+ *
+ * Commands:
+ * - {"type": "message", "text": "..."} - Send a message to Claude
+ * - {"type": "stop"} - Request graceful stop after current iteration
+ * - {"type": "pause"} - Pause after current iteration completes
+ * - {"type": "resume"} - Resume from paused state
+ */
+export declare const createStdinCommandHandler: (getOptions: () => StdinCommandHandlerOptions) => (() => void);
+//# sourceMappingURL=StdinCommandHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StdinCommandHandler.d.ts","sourceRoot":"","sources":["../../src/lib/StdinCommandHandler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAA;AAKnE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEtB;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,YAAY,GAAG,IAsC/D,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAA;IACjC,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACpC,YAAY,MAAM,0BAA0B,KAC3C,CAAC,MAAM,IAAI,CAkDb,CAAA"}

package/dist/lib/StdinCommandHandler.js

@@ -0,0 +1,102 @@
+import { createDebugLogger } from "./debug.js";
+import { createUserMessage } from "./MessageQueue.js";
+import { createInterface } from "readline";
+const log = createDebugLogger("stdin-command");
+/**
+ * Parse a JSON string into a StdinCommand.
+ * Returns null if parsing fails or the command is invalid.
+ */
+export const parseStdinCommand = (line) => {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed !== "object" || parsed === null) {
+            log(`Invalid command - not an object: ${trimmed}`);
+            return null;
+        }
+        if (parsed.type === "message") {
+            if (typeof parsed.text !== "string") {
+                log(`Invalid message command - missing or invalid text: ${trimmed}`);
+                return null;
+            }
+            return { type: "message", text: parsed.text };
+        }
+        if (parsed.type === "stop") {
+            return { type: "stop" };
+        }
+        if (parsed.type === "pause") {
+            return { type: "pause" };
+        }
+        if (parsed.type === "resume") {
+            return { type: "resume" };
+        }
+        log(`Unknown command type: ${parsed.type}`);
+        return null;
+    }
+    catch (err) {
+        log(`Failed to parse command: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+};
+/**
+ * Creates a stdin command handler that reads JSON commands from stdin.
+ * Returns a cleanup function to stop reading.
+ *
+ * Commands:
+ * - {"type": "message", "text": "..."} - Send a message to Claude
+ * - {"type": "stop"} - Request graceful stop after current iteration
+ * - {"type": "pause"} - Pause after current iteration completes
+ * - {"type": "resume"} - Resume from paused state
+ */
+export const createStdinCommandHandler = (getOptions) => {
+    // Don't set up stdin handler if stdin is a TTY (interactive mode handles input differently)
+    // This handler is for piped input in JSON mode
+    if (process.stdin.isTTY) {
+        log(`stdin is TTY - skipping stdin command handler`);
+        return () => { };
+    }
+    log(`Setting up stdin command handler`);
+    const rl = createInterface({
+        input: process.stdin,
+        terminal: false,
+    });
+    const lineHandler = (line) => {
+        const command = parseStdinCommand(line);
+        if (!command)
+            return;
+        const options = getOptions();
+        log(`Received command: ${command.type}`);
+        if (command.type === "message") {
+            if (options.messageQueue) {
+                const userMessage = createUserMessage(command.text);
+                options.messageQueue.push(userMessage);
+                log(`Pushed message to queue: ${command.text.slice(0, 50)}...`);
+                options.onMessage?.(command.text);
+            }
+            else {
+                log(`Cannot send message - no active message queue`);
+            }
+        }
+        else if (command.type === "stop") {
+            log(`Stop command received`);
+            options.onStop();
+        }
+        else if (command.type === "pause") {
+            log(`Pause command received`);
+            options.onPause?.();
+        }
+        else if (command.type === "resume") {
+            log(`Resume command received`);
+            options.onResume?.();
+        }
+    };
+    rl.on("line", lineHandler);
+    return () => {
+        log(`Cleaning up stdin command handler`);
+        rl.off("line", lineHandler);
+        rl.close();
+    };
+};
+//# sourceMappingURL=StdinCommandHandler.js.map

package/dist/lib/StdinCommandHandler.js.map

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

package/dist/lib/StdinCommandHandler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StdinCommandHandler.test.d.ts.map

package/dist/lib/StdinCommandHandler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdinCommandHandler.test.d.ts","sourceRoot":"","sources":["../../src/lib/StdinCommandHandler.test.ts"],"names":[],"mappings":""}

package/dist/lib/StdinCommandHandler.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect } from "vitest";
+import { parseStdinCommand } from "./StdinCommandHandler.js";
+describe("parseStdinCommand", () => {
+    describe("message command", () => {
+        it("parses valid message command", () => {
+            const result = parseStdinCommand('{"type": "message", "text": "hello world"}');
+            expect(result).toEqual({ type: "message", text: "hello world" });
+        });
+        it("handles message with special characters", () => {
+            const result = parseStdinCommand('{"type": "message", "text": "line1\\nline2"}');
+            expect(result).toEqual({ type: "message", text: "line1\nline2" });
+        });
+        it("handles empty message text", () => {
+            const result = parseStdinCommand('{"type": "message", "text": ""}');
+            expect(result).toEqual({ type: "message", text: "" });
+        });
+        it("returns null for message without text field", () => {
+            const result = parseStdinCommand('{"type": "message"}');
+            expect(result).toBeNull();
+        });
+        it("returns null for message with non-string text", () => {
+            const result = parseStdinCommand('{"type": "message", "text": 123}');
+            expect(result).toBeNull();
+        });
+    });
+    describe("stop command", () => {
+        it("parses valid stop command", () => {
+            const result = parseStdinCommand('{"type": "stop"}');
+            expect(result).toEqual({ type: "stop" });
+        });
+        it("ignores extra fields on stop command", () => {
+            const result = parseStdinCommand('{"type": "stop", "extra": "ignored"}');
+            expect(result).toEqual({ type: "stop" });
+        });
+    });
+    describe("pause command", () => {
+        it("parses valid pause command", () => {
+            const result = parseStdinCommand('{"type": "pause"}');
+            expect(result).toEqual({ type: "pause" });
+        });
+        it("ignores extra fields on pause command", () => {
+            const result = parseStdinCommand('{"type": "pause", "extra": "ignored"}');
+            expect(result).toEqual({ type: "pause" });
+        });
+    });
+    describe("resume command", () => {
+        it("parses valid resume command", () => {
+            const result = parseStdinCommand('{"type": "resume"}');
+            expect(result).toEqual({ type: "resume" });
+        });
+        it("ignores extra fields on resume command", () => {
+            const result = parseStdinCommand('{"type": "resume", "extra": "ignored"}');
+            expect(result).toEqual({ type: "resume" });
+        });
+    });
+    describe("invalid input", () => {
+        it("returns null for empty string", () => {
+            const result = parseStdinCommand("");
+            expect(result).toBeNull();
+        });
+        it("returns null for whitespace only", () => {
+            const result = parseStdinCommand("   \n\t  ");
+            expect(result).toBeNull();
+        });
+        it("returns null for invalid JSON", () => {
+            const result = parseStdinCommand("not json");
+            expect(result).toBeNull();
+        });
+        it("returns null for array instead of object", () => {
+            const result = parseStdinCommand('["type", "message"]');
+            expect(result).toBeNull();
+        });
+        it("returns null for null", () => {
+            const result = parseStdinCommand("null");
+            expect(result).toBeNull();
+        });
+        it("returns null for primitive value", () => {
+            const result = parseStdinCommand("123");
+            expect(result).toBeNull();
+        });
+        it("returns null for unknown command type", () => {
+            const result = parseStdinCommand('{"type": "unknown"}');
+            expect(result).toBeNull();
+        });
+    });
+    describe("whitespace handling", () => {
+        it("trims leading/trailing whitespace", () => {
+            const result = parseStdinCommand('  {"type": "stop"}  ');
+            expect(result).toEqual({ type: "stop" });
+        });
+    });
+});
+//# sourceMappingURL=StdinCommandHandler.test.js.map

package/dist/lib/StdinCommandHandler.test.js.map

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

package/dist/lib/debug.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Debug logging utility controlled by RALPH_DEBUG environment variable.
+ *
+ * Set RALPH_DEBUG=1 or RALPH_DEBUG=true to enable debug logging.
+ * Set RALPH_DEBUG=messagequeue to enable only MessageQueue logging.
+ * Set RALPH_DEBUG=all or RALPH_DEBUG=* to enable all debug logging.
+ */
+type DebugNamespace = "messagequeue" | "iteration" | "sdk" | "stdin-command";
+/**
+ * Log a debug message if debugging is enabled for the given namespace.
+ */
+export declare const debug: (namespace: DebugNamespace, message: string, ...args: unknown[]) => void;
+/**
+ * Create a namespaced debug logger.
+ */
+export declare const createDebugLogger: (namespace: DebugNamespace) => (message: string, ...args: unknown[]) => void;
+export {};
+//# sourceMappingURL=debug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/lib/debug.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,cAAc,GAAG,cAAc,GAAG,WAAW,GAAG,KAAK,GAAG,eAAe,CAAA;AA2B5E;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,WAAW,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,OAAO,EAAE,KAAG,IAOtF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,cAAc,MACjD,SAAS,MAAM,EAAE,GAAG,MAAM,OAAO,EAAE,SAC5C,CAAA"}

package/dist/lib/debug.js

@@ -0,0 +1,44 @@
+/**
+ * Debug logging utility controlled by RALPH_DEBUG environment variable.
+ *
+ * Set RALPH_DEBUG=1 or RALPH_DEBUG=true to enable debug logging.
+ * Set RALPH_DEBUG=messagequeue to enable only MessageQueue logging.
+ * Set RALPH_DEBUG=all or RALPH_DEBUG=* to enable all debug logging.
+ */
+const isDebugEnabled = (namespace) => {
+    const debugEnv = process.env.RALPH_DEBUG;
+    if (!debugEnv)
+        return false;
+    const value = debugEnv.toLowerCase();
+    // Enable all debugging
+    if (value === "1" || value === "true" || value === "all" || value === "*") {
+        return true;
+    }
+    // Enable specific namespace
+    if (namespace && value === namespace.toLowerCase()) {
+        return true;
+    }
+    // Comma-separated list of namespaces
+    if (namespace && value.includes(",")) {
+        return value.split(",").some(ns => ns.trim().toLowerCase() === namespace.toLowerCase());
+    }
+    return false;
+};
+/**
+ * Log a debug message if debugging is enabled for the given namespace.
+ */
+export const debug = (namespace, message, ...args) => {
+    if (isDebugEnabled(namespace)) {
+        const timestamp = new Date().toISOString();
+        const prefix = `[${timestamp}] [RALPH:${namespace.toUpperCase()}]`;
+        // eslint-disable-next-line no-console
+        console.error(prefix, message, ...args);
+    }
+};
+/**
+ * Create a namespaced debug logger.
+ */
+export const createDebugLogger = (namespace) => {
+    return (message, ...args) => debug(namespace, message, ...args);
+};
+//# sourceMappingURL=debug.js.map

package/dist/lib/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/lib/debug.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,cAAc,GAAG,CAAC,SAA0B,EAAW,EAAE;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAA;IAExC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;IAEpC,uBAAuB;IACvB,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4BAA4B;IAC5B,IAAI,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QACnD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,qCAAqC;IACrC,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;IACzF,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,SAAyB,EAAE,OAAe,EAAE,GAAG,IAAe,EAAQ,EAAE;IAC5F,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,YAAY,SAAS,CAAC,WAAW,EAAE,GAAG,CAAA;QAClE,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IACzC,CAAC;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAyB,EAAE,EAAE;IAC7D,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;AACpF,CAAC,CAAA"}

package/dist/lib/formatContentBlock.js

@@ -44,7 +44,7 @@ const formatToolUse = (name, arg) => {
  * Format a user message
  */
 const formatUserMessage = (content) => {
-    return chalk.green(`📨 You: ${content}`);
+    return chalk.green(content);
 };
 /**
  * Convert a content block to formatted string lines

package/dist/lib/formatContentBlock.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatContentBlock.js","sourceRoot":"","sources":["../../src/lib/formatContentBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe,EAAU,EAAE;IAC7C,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,IAAI,MAAM,GAAG,KAAK,CAAA;IAElB,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACjD,MAAM,GAAG,CAAC,MAAM,CAAA;YAChB,CAAC,IAAI,CAAC,CAAA;QACR,CAAC;aAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9B,MAAM,GAAG,CAAC,MAAM,CAAA;YAChB,CAAC,EAAE,CAAA;QACL,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;YAErB,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAC3B,CAAC;iBAAM,IAAI,MAAM,EAAE,CAAC;gBAClB,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzB,CAAC;YAED,MAAM,IAAI,IAAI,CAAA;YACd,CAAC,EAAE,CAAA;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,GAAY,EAAU,EAAE;IAC3D,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,KAAK,aAAa,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/C,CAAC;IACD,OAAO,KAAK,aAAa,EAAE,CAAA;AAC7B,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAU,EAAE;IACpD,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAA;AAC1C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAmB,EAAY,EAAE;IAClE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC3C,gEAAgE;QAChE,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;AAC/C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAiB,EAAU,EAAE;IACjE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,SAAS,MAAM,CAAC,CAAA;AACtD,CAAC,CAAA"}
+{"version":3,"file":"formatContentBlock.js","sourceRoot":"","sources":["../../src/lib/formatContentBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,OAAe,EAAU,EAAE;IAC7C,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,IAAI,MAAM,GAAG,KAAK,CAAA;IAElB,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACjD,MAAM,GAAG,CAAC,MAAM,CAAA;YAChB,CAAC,IAAI,CAAC,CAAA;QACR,CAAC;aAAM,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YAC9B,MAAM,GAAG,CAAC,MAAM,CAAA;YAChB,CAAC,EAAE,CAAA;QACL,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;YAErB,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAC3B,CAAC;iBAAM,IAAI,MAAM,EAAE,CAAC;gBAClB,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzB,CAAC;YAED,MAAM,IAAI,IAAI,CAAA;YACd,CAAC,EAAE,CAAA;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,GAAY,EAAU,EAAE;IAC3D,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACtC,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,KAAK,aAAa,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/C,CAAC;IACD,OAAO,KAAK,aAAa,EAAE,CAAA;AAC7B,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAU,EAAE;IACpD,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;AAC7B,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAmB,EAAY,EAAE;IAClE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC3C,gEAAgE;QAChE,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC9B,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;AAC/C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,SAAiB,EAAU,EAAE;IACjE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,SAAS,MAAM,CAAC,CAAA;AACtD,CAAC,CAAA"}

package/dist/lib/getNextLogFile.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Get the path to the next sequential log file in the .ralph directory.
+ * Files are named events-1.jsonl, events-2.jsonl, etc.
+ * Returns the path for the next available number (highest existing + 1).
+ */
+export declare const getNextLogFile: () => string;
+/**
+ * Get the path to the most recent (highest numbered) log file in the .ralph directory.
+ * Returns undefined if no event logs exist.
+ */
+export declare const getLatestLogFile: () => string | undefined;
+//# sourceMappingURL=getNextLogFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getNextLogFile.d.ts","sourceRoot":"","sources":["../../src/lib/getNextLogFile.ts"],"names":[],"mappings":"AAgCA;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,MAUjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAAM,GAAG,SAQ5C,CAAA"}

package/dist/lib/getNextLogFile.js

@@ -0,0 +1,52 @@
+import { readdirSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+const EVENT_LOG_PATTERN = /^events-(\d+)\.jsonl$/;
+/**
+ * Find the highest numbered event log file that exists in the .ralph directory.
+ * Returns 0 if no event logs exist.
+ */
+const findMaxLogNumber = () => {
+    const ralphDir = join(process.cwd(), ".ralph");
+    if (!existsSync(ralphDir)) {
+        return 0;
+    }
+    const files = readdirSync(ralphDir);
+    let maxNumber = 0;
+    for (const file of files) {
+        const match = file.match(EVENT_LOG_PATTERN);
+        if (match) {
+            const num = parseInt(match[1], 10);
+            if (num > maxNumber) {
+                maxNumber = num;
+            }
+        }
+    }
+    return maxNumber;
+};
+/**
+ * Get the path to the next sequential log file in the .ralph directory.
+ * Files are named events-1.jsonl, events-2.jsonl, etc.
+ * Returns the path for the next available number (highest existing + 1).
+ */
+export const getNextLogFile = () => {
+    const ralphDir = join(process.cwd(), ".ralph");
+    // Ensure .ralph directory exists
+    if (!existsSync(ralphDir)) {
+        mkdirSync(ralphDir, { recursive: true });
+    }
+    const maxNumber = findMaxLogNumber();
+    return join(ralphDir, `events-${maxNumber + 1}.jsonl`);
+};
+/**
+ * Get the path to the most recent (highest numbered) log file in the .ralph directory.
+ * Returns undefined if no event logs exist.
+ */
+export const getLatestLogFile = () => {
+    const maxNumber = findMaxLogNumber();
+    if (maxNumber === 0) {
+        return undefined;
+    }
+    const ralphDir = join(process.cwd(), ".ralph");
+    return join(ralphDir, `events-${maxNumber}.jsonl`);
+};
+//# sourceMappingURL=getNextLogFile.js.map

package/dist/lib/getNextLogFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNextLogFile.js","sourceRoot":"","sources":["../../src/lib/getNextLogFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B,MAAM,iBAAiB,GAAG,uBAAuB,CAAA;AAEjD;;;GAGG;AACH,MAAM,gBAAgB,GAAG,GAAW,EAAE;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAA;IAE9C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAA;IACV,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;IACnC,IAAI,SAAS,GAAG,CAAC,CAAA;IAEjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;QAC3C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YAClC,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;gBACpB,SAAS,GAAG,GAAG,CAAA;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAA;IAE9C,iCAAiC;IACjC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAA;IACpC,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,SAAS,GAAG,CAAC,QAAQ,CAAC,CAAA;AACxD,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAuB,EAAE;IACvD,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAA;IACpC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAA;IAC9C,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,SAAS,QAAQ,CAAC,CAAA;AACpD,CAAC,CAAA"}

package/dist/lib/getNextLogFile.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getNextLogFile.test.d.ts.map

package/dist/lib/getNextLogFile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getNextLogFile.test.d.ts","sourceRoot":"","sources":["../../src/lib/getNextLogFile.test.ts"],"names":[],"mappings":""}