@nac3/forge-cli 1.0.36 → 1.0.38

package/dist/llm/sse_stream.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Pendiente B (2026-06-22) -- token-level streaming parsers.
+ *
+ * Each brain client today does `fetch(...) -> await res.json()` and only
+ * surfaces the assistant text whole, at the end. These helpers parse the
+ * provider's streaming SSE body instead, calling `onText(delta)` as each
+ * text fragment arrives, and reconstruct the SAME response shape the
+ * client's buffered path already consumes -- so the downstream tool-loop,
+ * caching, truncation detection, etc. stay byte-identical. The only change
+ * at the call site is swapping the transport.
+ *
+ * Provider coverage:
+ *   - Anthropic (/v1/messages, stream:true) -- readAnthropicStream. DONE.
+ *   - OpenAI-compat + Gemini parsers are the documented next step
+ *     (docs/PND_STREAMING_B_TOKEN_LEVEL.md); the panel + server plumbing
+ *     here is provider-agnostic (any client that emits assistant_delta
+ *     streams live), so adding them is mechanical.
+ *
+ * ASCII-only.
+ */
+/** Generic block shape Anthropic's buffered path consumes. */
+export interface AnthropicStreamResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    } | {
+        type: 'tool_use';
+        id: string;
+        name: string;
+        input: Record<string, unknown>;
+    }>;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    model?: string;
+    stop_reason?: string;
+}
+/**
+ * Parse an Anthropic streaming /v1/messages body into the buffered shape,
+ * emitting each text delta via onText. Mirrors the SSE event sequence:
+ *   message_start -> (content_block_start -> content_block_delta* ->
+ *   content_block_stop)* -> message_delta -> message_stop.
+ */
+export declare function readAnthropicStream(body: ReadableStream<Uint8Array>, onText: (delta: string) => void): Promise<AnthropicStreamResult>;
+//# sourceMappingURL=sse_stream.d.ts.map

package/dist/llm/sse_stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse_stream.d.ts","sourceRoot":"","sources":["../../src/llm/sse_stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,KAAK,CACV;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC9B;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CACjF,CAAC;IACF,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+BD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAyDhC"}

package/dist/llm/sse_stream.js

@@ -0,0 +1,134 @@
+/**
+ * Pendiente B (2026-06-22) -- token-level streaming parsers.
+ *
+ * Each brain client today does `fetch(...) -> await res.json()` and only
+ * surfaces the assistant text whole, at the end. These helpers parse the
+ * provider's streaming SSE body instead, calling `onText(delta)` as each
+ * text fragment arrives, and reconstruct the SAME response shape the
+ * client's buffered path already consumes -- so the downstream tool-loop,
+ * caching, truncation detection, etc. stay byte-identical. The only change
+ * at the call site is swapping the transport.
+ *
+ * Provider coverage:
+ *   - Anthropic (/v1/messages, stream:true) -- readAnthropicStream. DONE.
+ *   - OpenAI-compat + Gemini parsers are the documented next step
+ *     (docs/PND_STREAMING_B_TOKEN_LEVEL.md); the panel + server plumbing
+ *     here is provider-agnostic (any client that emits assistant_delta
+ *     streams live), so adding them is mechanical.
+ *
+ * ASCII-only.
+ */
+/** Read one SSE-framed Response body, invoking `onFrame` per `data:` JSON
+ *  object. Tolerant of multi-line data fields and keep-alive `:` comments. */
+async function forEachSseFrame(body, onFrame) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder('utf-8');
+    let buf = '';
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buf += decoder.decode(value, { stream: true });
+        let idx;
+        while ((idx = buf.indexOf('\n\n')) >= 0) {
+            const frame = buf.slice(0, idx);
+            buf = buf.slice(idx + 2);
+            let dataStr = '';
+            for (const line of frame.split('\n')) {
+                if (line.startsWith('data:'))
+                    dataStr += line.slice(5).trim();
+            }
+            if (!dataStr || dataStr === '[DONE]')
+                continue;
+            let obj;
+            try {
+                obj = JSON.parse(dataStr);
+            }
+            catch {
+                continue;
+            }
+            onFrame(obj);
+        }
+    }
+}
+/**
+ * Parse an Anthropic streaming /v1/messages body into the buffered shape,
+ * emitting each text delta via onText. Mirrors the SSE event sequence:
+ *   message_start -> (content_block_start -> content_block_delta* ->
+ *   content_block_stop)* -> message_delta -> message_stop.
+ */
+export async function readAnthropicStream(body, onText) {
+    const blocks = [];
+    const partialJson = {};
+    let model;
+    let stopReason;
+    let inputTokens = 0;
+    let outputTokens = 0;
+    await forEachSseFrame(body, (evt) => {
+        const t = evt['type'];
+        if (t === 'message_start') {
+            const msg = evt['message'];
+            inputTokens = msg?.usage?.input_tokens ?? 0;
+            model = msg?.model;
+        }
+        else if (t === 'content_block_start') {
+            const i = Number(evt['index']) || 0;
+            const cb = evt['content_block'];
+            if (cb?.type === 'text') {
+                blocks[i] = { type: 'text', text: '' };
+            }
+            else if (cb?.type === 'tool_use') {
+                blocks[i] = { type: 'tool_use', id: String(cb.id || ''), name: String(cb.name || ''), input: {} };
+                partialJson[i] = '';
+            }
+        }
+        else if (t === 'content_block_delta') {
+            const i = Number(evt['index']) || 0;
+            const d = evt['delta'];
+            if (d?.type === 'text_delta') {
+                const b = blocks[i];
+                if (b && b.type === 'text')
+                    b.text += d.text || '';
+                if (d.text)
+                    onText(d.text);
+            }
+            else if (d?.type === 'input_json_delta') {
+                partialJson[i] = (partialJson[i] || '') + (d.partial_json || '');
+            }
+        }
+        else if (t === 'content_block_stop') {
+            const i = Number(evt['index']) || 0;
+            const b = blocks[i];
+            if (b && b.type === 'tool_use') {
+                const raw = partialJson[i];
+                if (raw) {
+                    try {
+                        b.input = JSON.parse(raw);
+                    }
+                    catch {
+                        b.input = {};
+                    }
+                }
+            }
+        }
+        else if (t === 'message_delta') {
+            const d = evt['delta'];
+            if (d?.stop_reason)
+                stopReason = d.stop_reason;
+            const u = evt['usage'];
+            if (u && typeof u.output_tokens === 'number')
+                outputTokens = u.output_tokens;
+        }
+        else if (t === 'error') {
+            const e = evt['error'];
+            throw new Error('anthropic stream error: ' + (e?.message || 'unknown'));
+        }
+    });
+    return {
+        content: blocks.filter(Boolean),
+        usage: { input_tokens: inputTokens, output_tokens: outputTokens },
+        model,
+        stop_reason: stopReason,
+    };
+}
+//# sourceMappingURL=sse_stream.js.map

package/dist/llm/sse_stream.js.map

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

package/dist/version.d.ts

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export declare const VERSION = "1.0.36";
+export declare const VERSION = "1.0.38";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -2,5 +2,5 @@
  * Yujin Forge CLI version. Kept in sync with package.json by the npm
  * "version" lifecycle (scripts/sync_version.mjs) so the two never drift.
  */
-export const VERSION = '1.0.36';
+export const VERSION = '1.0.38';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "1.0.36",
+  "version": "1.0.38",
   "description": "Yujin Forge -- voice-first NAC-3 React development framework. CLI + chat panel + spec ingest + 10-format document reader + voice loop.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Pablo Kuschnirof <pablo@rpaforce.com>",