@sumicom/quicksave 0.5.2 → 0.6.1

package/dist/ai/asyncQueue.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A simple async iterable queue for multi-turn prompt delivery.
+ *
+ * Push values from the producer side; consumers iterate with `for await`.
+ * Calling `end()` signals the consumer that no more values will arrive.
+ */
+export declare class AsyncQueue<T> implements AsyncIterable<T> {
+    private queue;
+    private waiting;
+    private done;
+    /** Enqueue a value. If a consumer is already waiting, deliver immediately. */
+    push(value: T): void;
+    /** Signal that no more values will be pushed. */
+    end(): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+//# sourceMappingURL=asyncQueue.d.ts.map

package/dist/ai/asyncQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncQueue.d.ts","sourceRoot":"","sources":["../../src/ai/asyncQueue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,OAAO,CAAqD;IACpE,OAAO,CAAC,IAAI,CAAS;IAErB,8EAA8E;IAC9E,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAWpB,iDAAiD;IACjD,GAAG,IAAI,IAAI;IASX,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAe3C"}

package/dist/ai/asyncQueue.js

@@ -0,0 +1,49 @@
+/**
+ * A simple async iterable queue for multi-turn prompt delivery.
+ *
+ * Push values from the producer side; consumers iterate with `for await`.
+ * Calling `end()` signals the consumer that no more values will arrive.
+ */
+export class AsyncQueue {
+    queue = [];
+    waiting = null;
+    done = false;
+    /** Enqueue a value. If a consumer is already waiting, deliver immediately. */
+    push(value) {
+        if (this.done)
+            return;
+        if (this.waiting) {
+            const resolve = this.waiting;
+            this.waiting = null;
+            resolve({ value, done: false });
+        }
+        else {
+            this.queue.push(value);
+        }
+    }
+    /** Signal that no more values will be pushed. */
+    end() {
+        this.done = true;
+        if (this.waiting) {
+            const resolve = this.waiting;
+            this.waiting = null;
+            resolve({ value: undefined, done: true });
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return {
+            next: () => {
+                if (this.queue.length > 0) {
+                    return Promise.resolve({ value: this.queue.shift(), done: false });
+                }
+                if (this.done) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise((resolve) => {
+                    this.waiting = resolve;
+                });
+            },
+        };
+    }
+}
+//# sourceMappingURL=asyncQueue.js.map

package/dist/ai/asyncQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncQueue.js","sourceRoot":"","sources":["../../src/ai/asyncQueue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,GAAQ,EAAE,CAAC;IAChB,OAAO,GAAgD,IAAI,CAAC;IAC5D,IAAI,GAAG,KAAK,CAAC;IAErB,8EAA8E;IAC9E,IAAI,CAAC,KAAQ;QACX,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO;QACtB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,GAAG;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,CAAC,EAAE,KAAK,EAAE,SAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,GAA+B,EAAE;gBACrC,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,CAAC;gBACtE,CAAC;gBACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACd,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClE,CAAC;gBACD,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;oBAChD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;gBACzB,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/ai/asyncQueue.test.d.ts

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

package/dist/ai/asyncQueue.test.d.ts.map

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

package/dist/ai/asyncQueue.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect } from 'vitest';
+import { AsyncQueue } from './asyncQueue.js';
+describe('AsyncQueue', () => {
+    it('yields pushed values in order', async () => {
+        const q = new AsyncQueue();
+        q.push(1);
+        q.push(2);
+        q.push(3);
+        q.end();
+        const results = [];
+        for await (const v of q) {
+            results.push(v);
+        }
+        expect(results).toEqual([1, 2, 3]);
+    });
+    it('waits for values when consumed before push', async () => {
+        const q = new AsyncQueue();
+        // Start consuming in the background
+        const collected = [];
+        const consumer = (async () => {
+            for await (const v of q) {
+                collected.push(v);
+            }
+        })();
+        // Push values after a microtask delay
+        await Promise.resolve();
+        q.push('a');
+        await Promise.resolve();
+        q.push('b');
+        await Promise.resolve();
+        q.end();
+        await consumer;
+        expect(collected).toEqual(['a', 'b']);
+    });
+    it('end() terminates the iterator', async () => {
+        const q = new AsyncQueue();
+        q.end();
+        const results = [];
+        for await (const v of q) {
+            results.push(v);
+        }
+        expect(results).toEqual([]);
+    });
+    it('ignores pushes after end()', async () => {
+        const q = new AsyncQueue();
+        q.push(1);
+        q.end();
+        q.push(2); // should be ignored
+        const results = [];
+        for await (const v of q) {
+            results.push(v);
+        }
+        expect(results).toEqual([1]);
+    });
+});
+//# sourceMappingURL=asyncQueue.test.js.map

package/dist/ai/asyncQueue.test.js.map

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

package/dist/ai/cardBuilder.d.ts

@@ -0,0 +1,73 @@
+import type { Card, CardId, CardEvent, CardHistoryResponse, PendingInputAttachment } from '@sumicom/quicksave-shared';
+export declare class StreamCardBuilder {
+    private sessionId;
+    private streamId;
+    private cwd;
+    private seq;
+    private cards;
+    /** tool_use_id → CardId, for pairing tool_result to ToolCallCard */
+    private toolUseIdToCardId;
+    /** agentId (task_id) → CardId, for matching subagent updates */
+    private agentIdToCardId;
+    /** Cards created for subagent permissions — removed after resolution. */
+    private ephemeralCards;
+    /** Current streaming assistant_text card (for append_text events) */
+    private currentTextCardId;
+    /** JSONL message count at the start of the current turn — history reads stop here. */
+    private _jsonlCutoff;
+    constructor(sessionId: string, streamId: string, cwd: string);
+    updateSessionId(sessionId: string): void;
+    /** Start a new turn: update streamId and reset per-turn state, keep accumulated cards. */
+    startNewTurn(streamId: string): void;
+    /** Clear all accumulated cards. Call after a turn completes and JSONL is flushed. */
+    clearCards(): void;
+    /** Snapshot current JSONL message count so history reads stop before the active turn. */
+    snapshotCutoff(): Promise<void>;
+    get jsonlCutoff(): number | null;
+    set jsonlCutoff(value: number | null);
+    private nextId;
+    private addEvent;
+    private updateEvent;
+    private appendTextEvent;
+    private removeEvent;
+    userMessage(text: string): CardEvent;
+    thinkingBlock(text: string): CardEvent;
+    /**
+     * Append text to current assistant_text card, or create a new one.
+     * Returns append_text event (hot path) or add event (new card).
+     */
+    assistantText(text: string): CardEvent;
+    /** Mark the current assistant_text card as done streaming. */
+    finalizeAssistantText(): CardEvent | null;
+    /**
+     * Handle tool_use block from SDK stream.
+     * If the card was already pre-created via `toolCallFromPermission()`, confirm it.
+     * Otherwise create a new ToolCallCard.
+     */
+    toolUse(toolName: string, toolInput: Record<string, unknown>, toolUseId: string): CardEvent;
+    /**
+     * Pre-create a ToolCallCard from canUseTool (fires before tool_use stream event).
+     * This eliminates the synthetic message hack.
+     */
+    toolCallFromPermission(toolName: string, toolInput: Record<string, unknown>, toolUseId: string, pendingInput: PendingInputAttachment, 
+    /** Ephemeral cards are removed after permission is resolved (subagent permissions). */
+    ephemeral?: boolean): CardEvent;
+    /** Attach a pending input to a subagent card (subagent permission). */
+    attachPendingToSubagent(agentId: string, pendingInput: PendingInputAttachment): CardEvent | null;
+    /** Clear pending input from a card. Ephemeral cards are removed entirely. */
+    clearPendingInput(requestId: string): CardEvent | null;
+    /** Find the card ID for a given requestId. */
+    findCardByRequestId(requestId: string): CardId | undefined;
+    /** Check if a tool card already exists for the given tool_use_id. */
+    hasToolCard(toolUseId: string): boolean;
+    /** Return all live cards (insertion order). Cards carry pendingInput if set. */
+    getCards(): Card[];
+    toolResult(toolUseId: string, content: string, isError: boolean): CardEvent | null;
+    subagentStart(description: string, agentId: string, toolUseId?: string): CardEvent;
+    subagentProgress(agentId: string, toolUseId: string | undefined, toolUseCount?: number, lastToolName?: string): CardEvent | null;
+    subagentEnd(agentId: string, toolUseId: string | undefined, status: 'completed' | 'failed' | 'stopped', summary?: string): CardEvent | null;
+    systemMessage(text: string, subtype?: 'compacted' | 'cost' | 'error' | 'info' | 'warning'): CardEvent;
+    errorMessage(text: string): CardEvent;
+}
+export declare function buildCardsFromHistory(sessionId: string, cwd: string, offset?: number, limit?: number, maxMessages?: number): Promise<CardHistoryResponse>;
+//# sourceMappingURL=cardBuilder.d.ts.map

package/dist/ai/cardBuilder.d.ts.map

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