@bytexbyte/nxtlinq-ai-agent-core-development 0.2.0 → 0.2.1

package/dist/api/nxtlinq-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nxtlinq-api.d.ts","sourceRoot":"","sources":["../../src/api/nxtlinq-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE5D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;AAknBpF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,GAClB,UAAU,CAYZ"}
+{"version":3,"file":"nxtlinq-api.d.ts","sourceRoot":"","sources":["../../src/api/nxtlinq-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE5D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;AA0nBpF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,GAClB,UAAU,CAYZ"}

package/dist/api/nxtlinq-api.js

@@ -1,7 +1,7 @@
 import { STORAGE_KEYS } from '../constants/storageKeys';
 import { createDefaultHttpPort } from '../ports/HttpPort';
 import { getAiAgentApiHost, getAitServiceApiHost } from './hosts';
-import { parseSSEText } from './parse-sse';
+import { parseSSEResponse, parseSSEText } from './parse-sse';
 import { postTextTts } from './tts';
 export { postTextTts, buildTextTtsDataUri } from './tts';
 /** RN/Hermes 的 URLSearchParams 常缺少 set/append，改用手動組 query。 */
@@ -128,7 +128,7 @@ const createAgentApi = (helpers) => ({
                     : {}),
             };
             const useSSE = Boolean(params.onPiiProgress || params.onStreamDelta || model.endsWith('-stream'));
-            const response = await helpers.fetchFn(`${getAiAgentApiHost()}/api/${model}`, {
+            const fetchInit = {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
@@ -138,7 +138,10 @@ const createAgentApi = (helpers) => ({
                     ...(params.onPiiProgress ? { 'X-Stream-PII': '1' } : {}),
                 },
                 body: JSON.stringify(requestBody),
-            });
+                // React Native: enable incremental body reads for `*-stream` SSE routes.
+                ...(useSSE ? { reactNative: { textStreaming: true } } : {}),
+            };
+            const response = await helpers.fetchFn(`${getAiAgentApiHost()}/api/${model}`, fetchInit);
             if (!response.ok) {
                 throw new Error('Failed to send message');
             }
@@ -148,13 +151,14 @@ const createAgentApi = (helpers) => ({
                     onPiiProgress: params.onPiiProgress,
                     onStreamDelta: params.onStreamDelta,
                 };
-                // Always buffer first: RN often exposes a `body` stream that closes
-                // immediately without data, which breaks incremental parsing.
+                const bodyStream = response.body;
+                if (bodyStream?.getReader) {
+                    return await parseSSEResponse(bodyStream, sseHandlers);
+                }
                 const rawText = await response.text();
                 if (rawText.trimStart().startsWith('event:') || rawText.includes('\nevent:')) {
                     return parseSSEText(rawText, sseHandlers);
                 }
-                // Gateway returned JSON despite SSE content-type.
                 return rawText ? JSON.parse(rawText) : {};
             }
             return await response.json();

package/dist/api/parse-sse.d.ts

@@ -1,9 +1,25 @@
 export type SSEHandlers = {
     onPiiProgress?: (step: 'scan_start' | 'scan_complete' | 'send_start' | 'done', data?: unknown) => void;
+    /** Token chunk from a `text_delta` event. */
     onStreamDelta?: (text: string) => void;
+    /** Accumulated assistant text after each `text_delta` (convenience for chat UIs). */
+    onStreamText?: (fullText: string) => void;
 };
-/** Parse a complete SSE payload (React Native fetch often lacks a usable `response.body`). */
+type SSEParseState = {
+    streamText: string;
+};
+/**
+ * Parse complete SSE blocks from `buffer`, dispatch events, return trailing incomplete bytes.
+ */
+export declare function consumeSSEBuffer(buffer: string, handlers: SSEHandlers, finalDataRef: {
+    value: unknown | null;
+}, streamState?: SSEParseState): string;
+/** Parse a complete SSE payload (e.g. React Native fallback after `response.text()`). */
 export declare function parseSSEText(text: string, handlers: SSEHandlers): unknown;
-/** Parse Agent SSE: PII steps, optional LLM `text_delta`, final `done`. */
+/**
+ * Incrementally parse Agent SSE from a ReadableStream (`text_delta`, PII steps, final `done`).
+ * Dispatches handlers as chunks arrive (required for RN chat UIs).
+ */
 export declare function parseSSEResponse(body: ReadableStream<Uint8Array>, handlers: SSEHandlers): Promise<unknown>;
+export {};
 //# sourceMappingURL=parse-sse.d.ts.map

package/dist/api/parse-sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-sse.d.ts","sourceRoot":"","sources":["../../src/api/parse-sse.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,YAAY,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvG,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC,CAAC;AA8EF,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAEzE;AAED,2EAA2E;AAC3E,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CAalB"}
+{"version":3,"file":"parse-sse.d.ts","sourceRoot":"","sources":["../../src/api/parse-sse.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,YAAY,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvG,6CAA6C;IAC7C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,qFAAqF;IACrF,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAkEF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,EACrB,YAAY,EAAE;IAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,EACvC,WAAW,GAAE,aAAkC,GAC9C,MAAM,CAUR;AA6BD,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/dist/api/parse-sse.js

@@ -1,9 +1,4 @@
-/** Normalize CRLF and split into SSE message blocks. */
-function splitSSEMessages(raw) {
-    const normalized = raw.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-    return normalized.split('\n\n').filter((block) => block.trim().length > 0);
-}
-function dispatchSSEMessage(msg, handlers, finalDataRef) {
+function dispatchSSEMessage(msg, handlers, finalDataRef, streamState) {
     if (!msg.trim())
         return;
     let eventType = '';
@@ -46,7 +41,11 @@ function dispatchSSEMessage(msg, handlers, finalDataRef) {
             /* ignore */
         }
         const chunk = typeof parsed.text === 'string' ? parsed.text : '';
-        handlers.onStreamDelta?.(chunk);
+        if (chunk) {
+            handlers.onStreamDelta?.(chunk);
+            streamState.streamText += chunk;
+            handlers.onStreamText?.(streamState.streamText);
+        }
     }
     else if (eventType === 'error') {
         let parsed = {};
@@ -67,22 +66,47 @@ function dispatchSSEMessage(msg, handlers, finalDataRef) {
         }
     }
 }
-function parseSSEPayload(raw, handlers) {
-    const finalDataRef = { value: null };
-    for (const msg of splitSSEMessages(raw)) {
-        dispatchSSEMessage(msg, handlers, finalDataRef);
+/**
+ * Parse complete SSE blocks from `buffer`, dispatch events, return trailing incomplete bytes.
+ */
+export function consumeSSEBuffer(buffer, handlers, finalDataRef, streamState = { streamText: '' }) {
+    const normalized = buffer.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const parts = normalized.split('\n\n');
+    const remainder = parts.pop() ?? '';
+    for (const block of parts) {
+        dispatchSSEMessage(block, handlers, finalDataRef, streamState);
     }
+    return remainder;
+}
+function flushSSEBuffer(remainder, handlers, finalDataRef, streamState) {
+    if (!remainder.trim())
+        return;
+    dispatchSSEMessage(remainder, handlers, finalDataRef, streamState);
+}
+function finalizeSSEParse(finalDataRef) {
     if (finalDataRef.value !== null && finalDataRef.value !== undefined) {
         return finalDataRef.value;
     }
     throw new Error('SSE stream ended without done event');
 }
-/** Parse a complete SSE payload (React Native fetch often lacks a usable `response.body`). */
+function parseSSEPayload(raw, handlers) {
+    const finalDataRef = { value: null };
+    const streamState = { streamText: '' };
+    const remainder = consumeSSEBuffer(raw, handlers, finalDataRef, streamState);
+    flushSSEBuffer(remainder, handlers, finalDataRef, streamState);
+    return finalizeSSEParse(finalDataRef);
+}
+/** Parse a complete SSE payload (e.g. React Native fallback after `response.text()`). */
 export function parseSSEText(text, handlers) {
     return parseSSEPayload(text, handlers);
 }
-/** Parse Agent SSE: PII steps, optional LLM `text_delta`, final `done`. */
+/**
+ * Incrementally parse Agent SSE from a ReadableStream (`text_delta`, PII steps, final `done`).
+ * Dispatches handlers as chunks arrive (required for RN chat UIs).
+ */
 export async function parseSSEResponse(body, handlers) {
+    const finalDataRef = { value: null };
+    const streamState = { streamText: '' };
     const reader = body.getReader();
     const decoder = new TextDecoder();
     let buffer = '';
@@ -91,7 +115,10 @@ export async function parseSSEResponse(body, handlers) {
         if (done)
             break;
         buffer += decoder.decode(value, { stream: true });
+        buffer = consumeSSEBuffer(buffer, handlers, finalDataRef, streamState);
     }
     buffer += decoder.decode();
-    return parseSSEPayload(buffer, handlers);
+    buffer = consumeSSEBuffer(buffer, handlers, finalDataRef, streamState);
+    flushSSEBuffer(buffer, handlers, finalDataRef, streamState);
+    return finalizeSSEParse(finalDataRef);
 }

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { setApiHosts, getAiAgentApiHost, getAitServiceApiHost } from './api/hosts';
 export { createNxtlinqApiWithDeps, type CoreAITApi, type ApiClientDeps, } from './api/nxtlinq-api';
-export { parseSSEResponse, parseSSEText } from './api/parse-sse';
+export { consumeSSEBuffer, parseSSEResponse, parseSSEText, type SSEHandlers, } from './api/parse-sse';
 export { postTextTts, buildTextTtsDataUri, type PostTextTtsParams, type PostTextTtsResult, } from './api/tts';
 export * from './ports';
 export { STORAGE_KEYS } from './constants/storageKeys';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AAGnB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,mBAAmB,iBAAiB,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGnF,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,yBAAyB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,4BAA4B,EAC5B,mCAAmC,EACnC,yBAAyB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,EACnC,gCAAgC,EAChC,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,wBAAwB,EACxB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC;AAGnB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGvD,mBAAmB,iBAAiB,CAAC;AACrC,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGnF,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,oBAAoB,GAC1B,MAAM,0BAA0B,CAAC;AAGlC,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,6BAA6B,GAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,yBAAyB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,4BAA4B,EAC5B,mCAAmC,EACnC,yBAAyB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,EACnC,gCAAgC,EAChC,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 // API
 export { setApiHosts, getAiAgentApiHost, getAitServiceApiHost } from './api/hosts';
 export { createNxtlinqApiWithDeps, } from './api/nxtlinq-api';
-export { parseSSEResponse, parseSSEText } from './api/parse-sse';
+export { consumeSSEBuffer, parseSSEResponse, parseSSEText, } from './api/parse-sse';
 export { postTextTts, buildTextTtsDataUri, } from './api/tts';
 // Ports
 export * from './ports';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytexbyte/nxtlinq-ai-agent-core-development",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Platform-agnostic nxtlinq AI Agent core — API client, types, and orchestration ports",
   "main": "dist/index.js",
   "react-native": "src/index.ts",

package/src/api/nxtlinq-api.ts

@@ -220,7 +220,7 @@ const createAgentApi = (helpers: ReturnType<typeof createApiHelpers>) => ({
         params.onPiiProgress || params.onStreamDelta || model.endsWith('-stream')
       );
 
-      const response = await helpers.fetchFn(`${getAiAgentApiHost()}/api/${model}`, {
+      const fetchInit: RequestInit = {
         method: 'POST',
         headers: {
           'Content-Type': 'application/json',
@@ -230,7 +230,14 @@ const createAgentApi = (helpers: ReturnType<typeof createApiHelpers>) => ({
           ...(params.onPiiProgress ? { 'X-Stream-PII': '1' } : {}),
         },
         body: JSON.stringify(requestBody),
-      });
+        // React Native: enable incremental body reads for `*-stream` SSE routes.
+        ...(useSSE ? { reactNative: { textStreaming: true } } : {}),
+      };
+
+      const response = await helpers.fetchFn(
+        `${getAiAgentApiHost()}/api/${model}`,
+        fetchInit as RequestInit,
+      );
 
       if (!response.ok) {
         throw new Error('Failed to send message');
@@ -243,13 +250,14 @@ const createAgentApi = (helpers: ReturnType<typeof createApiHelpers>) => ({
           onPiiProgress: params.onPiiProgress,
           onStreamDelta: params.onStreamDelta,
         };
-        // Always buffer first: RN often exposes a `body` stream that closes
-        // immediately without data, which breaks incremental parsing.
+        const bodyStream = response.body;
+        if (bodyStream?.getReader) {
+          return await parseSSEResponse(bodyStream, sseHandlers);
+        }
         const rawText = await response.text();
         if (rawText.trimStart().startsWith('event:') || rawText.includes('\nevent:')) {
           return parseSSEText(rawText, sseHandlers);
         }
-        // Gateway returned JSON despite SSE content-type.
         return rawText ? JSON.parse(rawText) : {};
       }
 

package/src/api/parse-sse.ts

@@ -1,18 +1,20 @@
 export type SSEHandlers = {
   onPiiProgress?: (step: 'scan_start' | 'scan_complete' | 'send_start' | 'done', data?: unknown) => void;
+  /** Token chunk from a `text_delta` event. */
   onStreamDelta?: (text: string) => void;
+  /** Accumulated assistant text after each `text_delta` (convenience for chat UIs). */
+  onStreamText?: (fullText: string) => void;
 };
 
-/** Normalize CRLF and split into SSE message blocks. */
-function splitSSEMessages(raw: string): string[] {
-  const normalized = raw.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-  return normalized.split('\n\n').filter((block) => block.trim().length > 0);
-}
+type SSEParseState = {
+  streamText: string;
+};
 
 function dispatchSSEMessage(
   msg: string,
   handlers: SSEHandlers,
   finalDataRef: { value: unknown | null },
+  streamState: SSEParseState,
 ): void {
   if (!msg.trim()) return;
   let eventType = '';
@@ -50,7 +52,11 @@ function dispatchSSEMessage(
       /* ignore */
     }
     const chunk = typeof parsed.text === 'string' ? parsed.text : '';
-    handlers.onStreamDelta?.(chunk);
+    if (chunk) {
+      handlers.onStreamDelta?.(chunk);
+      streamState.streamText += chunk;
+      handlers.onStreamText?.(streamState.streamText);
+    }
   } else if (eventType === 'error') {
     let parsed: { error?: string } = {};
     try {
@@ -68,27 +74,68 @@ function dispatchSSEMessage(
   }
 }
 
-function parseSSEPayload(raw: string, handlers: SSEHandlers): unknown {
-  const finalDataRef = { value: null as unknown | null };
-  for (const msg of splitSSEMessages(raw)) {
-    dispatchSSEMessage(msg, handlers, finalDataRef);
+/**
+ * Parse complete SSE blocks from `buffer`, dispatch events, return trailing incomplete bytes.
+ */
+export function consumeSSEBuffer(
+  buffer: string,
+  handlers: SSEHandlers,
+  finalDataRef: { value: unknown | null },
+  streamState: SSEParseState = { streamText: '' },
+): string {
+  const normalized = buffer.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+  const parts = normalized.split('\n\n');
+  const remainder = parts.pop() ?? '';
+
+  for (const block of parts) {
+    dispatchSSEMessage(block, handlers, finalDataRef, streamState);
   }
+
+  return remainder;
+}
+
+function flushSSEBuffer(
+  remainder: string,
+  handlers: SSEHandlers,
+  finalDataRef: { value: unknown | null },
+  streamState: SSEParseState,
+): void {
+  if (!remainder.trim()) return;
+  dispatchSSEMessage(remainder, handlers, finalDataRef, streamState);
+}
+
+function finalizeSSEParse(
+  finalDataRef: { value: unknown | null },
+): unknown {
   if (finalDataRef.value !== null && finalDataRef.value !== undefined) {
     return finalDataRef.value;
   }
   throw new Error('SSE stream ended without done event');
 }
 
-/** Parse a complete SSE payload (React Native fetch often lacks a usable `response.body`). */
+function parseSSEPayload(raw: string, handlers: SSEHandlers): unknown {
+  const finalDataRef = { value: null as unknown | null };
+  const streamState: SSEParseState = { streamText: '' };
+  const remainder = consumeSSEBuffer(raw, handlers, finalDataRef, streamState);
+  flushSSEBuffer(remainder, handlers, finalDataRef, streamState);
+  return finalizeSSEParse(finalDataRef);
+}
+
+/** Parse a complete SSE payload (e.g. React Native fallback after `response.text()`). */
 export function parseSSEText(text: string, handlers: SSEHandlers): unknown {
   return parseSSEPayload(text, handlers);
 }
 
-/** Parse Agent SSE: PII steps, optional LLM `text_delta`, final `done`. */
+/**
+ * Incrementally parse Agent SSE from a ReadableStream (`text_delta`, PII steps, final `done`).
+ * Dispatches handlers as chunks arrive (required for RN chat UIs).
+ */
 export async function parseSSEResponse(
   body: ReadableStream<Uint8Array>,
   handlers: SSEHandlers,
 ): Promise<unknown> {
+  const finalDataRef = { value: null as unknown | null };
+  const streamState: SSEParseState = { streamText: '' };
   const reader = body.getReader();
   const decoder = new TextDecoder();
   let buffer = '';
@@ -97,8 +144,12 @@ export async function parseSSEResponse(
     const { done, value } = await reader.read();
     if (done) break;
     buffer += decoder.decode(value, { stream: true });
+    buffer = consumeSSEBuffer(buffer, handlers, finalDataRef, streamState);
   }
 
   buffer += decoder.decode();
-  return parseSSEPayload(buffer, handlers);
+  buffer = consumeSSEBuffer(buffer, handlers, finalDataRef, streamState);
+  flushSSEBuffer(buffer, handlers, finalDataRef, streamState);
+
+  return finalizeSSEParse(finalDataRef);
 }

package/src/index.ts

@@ -5,7 +5,12 @@ export {
   type CoreAITApi,
   type ApiClientDeps,
 } from './api/nxtlinq-api';
-export { parseSSEResponse, parseSSEText } from './api/parse-sse';
+export {
+  consumeSSEBuffer,
+  parseSSEResponse,
+  parseSSEText,
+  type SSEHandlers,
+} from './api/parse-sse';
 export {
   postTextTts,
   buildTextTtsDataUri,