@sumicom/quicksave 0.5.1 → 0.6.0

package/dist/ai/asyncQueue.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Push-based async iterable.
+ * Consumers `for await` over it; producers call `push()` to enqueue values
+ * and `end()` to signal completion.
+ */
+export declare class AsyncQueue<T> implements AsyncIterable<T> {
+    private queue;
+    private resolve;
+    private done;
+    /** Enqueue a value. No-op if end() was already called. */
+    push(value: T): void;
+    /** Signal that no more values will be pushed. */
+    end(): void;
+    [Symbol.asyncIterator](): AsyncGenerator<T, void>;
+}
+//# 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;;;;GAIG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAS;IAErB,0DAA0D;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IASpB,iDAAiD;IACjD,GAAG,IAAI,IAAI;IAQJ,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC;CASzD"}

package/dist/ai/asyncQueue.js

@@ -0,0 +1,39 @@
+/**
+ * Push-based async iterable.
+ * Consumers `for await` over it; producers call `push()` to enqueue values
+ * and `end()` to signal completion.
+ */
+export class AsyncQueue {
+    queue = [];
+    resolve = null;
+    done = false;
+    /** Enqueue a value. No-op if end() was already called. */
+    push(value) {
+        if (this.done)
+            return;
+        this.queue.push(value);
+        if (this.resolve) {
+            this.resolve();
+            this.resolve = null;
+        }
+    }
+    /** Signal that no more values will be pushed. */
+    end() {
+        this.done = true;
+        if (this.resolve) {
+            this.resolve();
+            this.resolve = null;
+        }
+    }
+    async *[Symbol.asyncIterator]() {
+        while (true) {
+            while (this.queue.length > 0) {
+                yield this.queue.shift();
+            }
+            if (this.done)
+                return;
+            await new Promise((r) => { this.resolve = r; });
+        }
+    }
+}
+//# 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;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACb,KAAK,GAAQ,EAAE,CAAC;IAChB,OAAO,GAAwB,IAAI,CAAC;IACpC,IAAI,GAAG,KAAK,CAAC;IAErB,0DAA0D;IAC1D,IAAI,CAAC,KAAQ;QACX,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO;QACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,GAAG;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO,IAAI,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;YAC5B,CAAC;YACD,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO;YACtB,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,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 pushed', async () => {
+        const q = new AsyncQueue();
+        const results = [];
+        const consumer = (async () => {
+            for await (const v of q) {
+                results.push(v);
+            }
+        })();
+        // Push after consumer starts waiting
+        q.push('a');
+        q.push('b');
+        q.end();
+        await consumer;
+        expect(results).toEqual(['a', 'b']);
+    });
+    it('stops iterating after end() is called', async () => {
+        const q = new AsyncQueue();
+        q.push(1);
+        q.end();
+        q.push(2); // should be ignored after end
+        const results = [];
+        for await (const v of q) {
+            results.push(v);
+        }
+        expect(results).toEqual([1]);
+    });
+    it('supports multiple sequential consumers via Symbol.asyncIterator', async () => {
+        const q = new AsyncQueue();
+        q.push(1);
+        q.push(2);
+        const iter = q[Symbol.asyncIterator]();
+        const first = await iter.next();
+        expect(first).toEqual({ value: 1, done: false });
+        const second = await iter.next();
+        expect(second).toEqual({ value: 2, done: false });
+        q.end();
+        const third = await iter.next();
+        expect(third).toEqual({ value: undefined, done: true });
+    });
+});
+//# 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,64 @@
+import type { Card, CardId, CardEvent, CardHistoryResponse, PendingInputAttachment } from '@sumicom/quicksave-shared';
+export declare class StreamCardBuilder {
+    private sessionId;
+    private streamId;
+    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;
+    constructor(sessionId: string, streamId: string);
+    updateSessionId(sessionId: string): void;
+    /** Start a new turn: update streamId and reset per-turn state, keep accumulated cards. */
+    startNewTurn(streamId: string): void;
+    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): 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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"}