@wix/legends-platform-sdk 1.7.0 → 1.9.0

package/dist/cjs/hooks/useTextChat/index.js

@@ -7,4 +7,10 @@ Object.keys(_useTextChat).forEach(function (key) {
   if (key in exports && exports[key] === _useTextChat[key]) return;
   exports[key] = _useTextChat[key];
 });
+var _useTextChatStream = require("./useTextChatStream");
+Object.keys(_useTextChatStream).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _useTextChatStream[key]) return;
+  exports[key] = _useTextChatStream[key];
+});
 //# sourceMappingURL=index.js.map

package/dist/cjs/hooks/useTextChat/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_useTextChat","require","Object","keys","forEach","key","exports"],"sources":["../../../../src/hooks/useTextChat/index.ts"],"sourcesContent":["export * from './useTextChat';\n"],"mappings":";;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,YAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,YAAA,CAAAK,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAL,YAAA,CAAAK,GAAA;AAAA","ignoreList":[]}
+{"version":3,"names":["_useTextChat","require","Object","keys","forEach","key","exports","_useTextChatStream"],"sources":["../../../../src/hooks/useTextChat/index.ts"],"sourcesContent":["export * from './useTextChat';\nexport * from './useTextChatStream';\n"],"mappings":";;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,YAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,YAAA,CAAAK,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAL,YAAA,CAAAK,GAAA;AAAA;AACA,IAAAE,kBAAA,GAAAN,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAI,kBAAA,EAAAH,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAE,kBAAA,CAAAF,GAAA;EAAAC,OAAA,CAAAD,GAAA,IAAAE,kBAAA,CAAAF,GAAA;AAAA","ignoreList":[]}

package/dist/cjs/hooks/useTextChat/useTextChatStream.js

@@ -0,0 +1,272 @@
+"use strict";
+
+exports.__esModule = true;
+exports.useTextChatStream = useTextChatStream;
+var _react = require("react");
+var _reactQuery = require("@tanstack/react-query");
+var _sdkConsumer = require("../../sdk-consumer");
+var _streamChatMessage = require("../../services/streamChatMessage");
+exports.streamChatMessage = _streamChatMessage.streamChatMessage;
+// Re-exported here so consumers can reach the framework-agnostic transport
+// alongside the hook.
+
+/**
+ * A `ChatMessage` augmented with streaming metadata. The host renderer uses
+ * `streamStatus`/`streamingText` to drive its typewriter; confirmed
+ * (non-streamed) messages carry neither.
+ */
+
+/**
+ * Identity for deduping optimistic streamed messages against confirmed ones.
+ *
+ * This is a *content* join: the streamed text must equal the server-persisted
+ * copy for the confirmed duplicate to be hidden. `.trim()` absorbs trailing-
+ * whitespace differences, but heavier server-side post-processing (markdown /
+ * entity normalization, an appended citation) would make the keys diverge and
+ * briefly surface both copies. A shared message id would be more robust, but
+ * the streamed frames carry only token deltas — no id — so content equality is
+ * the best join available without backend support.
+ */
+const messageKey = m => `${m.role}::${(m.content ?? '').trim()}`;
+
+/**
+ * Streaming counterpart to `useTextChat`. Sends a message over the SSE transport
+ * and drips the accumulated reply into `streamingText` at a steady, time-paced
+ * rate (see `revealMsPerChar`) via requestAnimationFrame, merging the in-flight
+ * and completed streamed exchanges with the confirmed history (oldest-first).
+ * The host renderer (e.g. dolly) animates the dripped prefix with its own
+ * typewriter; pacing the drip below the typer's per-char rate keeps the typer
+ * from building a backlog it would otherwise skip through (jumpy reveal). The
+ * exchange settles only once the drip has revealed everything AND the network
+ * stream has ended, which avoids an end-of-reply snap.
+ *
+ * KNOWN LIMITATION: the streaming path does not run a function-call resolution
+ * loop — parity with the current unary behavior.
+ */
+function useTextChatStream(options) {
+  const {
+    streamUrl,
+    limit = 50,
+    headers,
+    onError,
+    revealMsPerChar = 16
+  } = options;
+  const {
+    chatId,
+    namespace,
+    personaChatService
+  } = (0, _sdkConsumer.useSdkConsumer)();
+  const {
+    data: sdkMessages = [],
+    status,
+    fetchNextPage,
+    refetch
+  } = (0, _reactQuery.useInfiniteQuery)({
+    queryKey: ['chat-messages', chatId, namespace],
+    queryFn: async ({
+      pageParam
+    }) => {
+      if (!personaChatService) {
+        return {
+          messages: [],
+          nextCursor: undefined
+        };
+      }
+      return personaChatService.queryChatMessages({
+        chatId,
+        namespace,
+        limit,
+        cursor: pageParam
+      });
+    },
+    getNextPageParam: lastPage => lastPage.nextCursor,
+    initialPageParam: undefined,
+    select: data => data.pages.flatMap(page => page.messages)
+  });
+
+  // Local state for the in-progress streaming exchange (user + assistant messages).
+  const [streamingMessages, setStreamingMessages] = (0, _react.useState)([]);
+  // Exchanges that finished streaming, kept for the lifetime of this chat. They
+  // keep their stable optimistic ids and stand in for the SDK's confirmed copies
+  // (which are hidden as duplicates) — this both bridges the refetch lag and
+  // avoids remounting the message (and restarting its typewriter) when the
+  // confirmed copy, with a different id, arrives.
+  const [completedMessages, setCompletedMessages] = (0, _react.useState)([]);
+  const abortRef = (0, _react.useRef)(null);
+  // Handle of the pending reveal-drip animation frame, if any.
+  const rafRef = (0, _react.useRef)(null);
+  // Last non-empty confirmed list. `refetch()` can transiently empty sdkMessages;
+  // falling back to this keeps the history from disappearing and reappearing.
+  const lastConfirmedRef = (0, _react.useRef)([]);
+  // Monotonic per-hook counter so two sends within the same millisecond still
+  // produce distinct message ids (used as React keys downstream).
+  const sendSeqRef = (0, _react.useRef)(0);
+
+  // Cancel any pending reveal-drip frame.
+  const stopRaf = (0, _react.useCallback)(() => {
+    if (rafRef.current !== null) {
+      cancelAnimationFrame(rafRef.current);
+      rafRef.current = null;
+    }
+  }, []);
+
+  // Stop any in-flight stream (and reveal drip) on unmount.
+  (0, _react.useEffect)(() => {
+    return () => {
+      var _abortRef$current;
+      (_abortRef$current = abortRef.current) == null || _abortRef$current.abort();
+      stopRaf();
+    };
+  }, [stopRaf]);
+  const messages = (0, _react.useMemo)(() => {
+    const converted = [...sdkMessages].reverse();
+    const confirmedMessages = converted.length > 0 ? converted : lastConfirmedRef.current;
+
+    // Show our locally-tracked streamed exchanges (stable ids) and hide the
+    // SDK's confirmed duplicates. Swapping to a confirmed copy would remount the
+    // message (different id) and restart its typewriter — that's the flicker.
+    // The in-progress streaming messages are always shown as-is.
+    const completedKeys = new Set(completedMessages.map(messageKey));
+    const confirmedShown = confirmedMessages.filter(m => !completedKeys.has(messageKey(m)));
+    return [...confirmedShown, ...completedMessages, ...streamingMessages];
+  }, [sdkMessages, streamingMessages, completedMessages]);
+
+  // Remember the latest non-empty confirmed list so a transient empty during a
+  // refetch doesn't blank the history.
+  (0, _react.useEffect)(() => {
+    const converted = [...sdkMessages].reverse();
+    if (converted.length > 0) {
+      lastConfirmedRef.current = converted;
+    }
+  }, [sdkMessages]);
+  const send = (0, _react.useCallback)(async ({
+    message,
+    chatConfig,
+    attachments
+  }) => {
+    var _abortRef$current2;
+    // Abort any in-flight stream before starting a new one.
+    (_abortRef$current2 = abortRef.current) == null || _abortRef$current2.abort();
+    const controller = new AbortController();
+    abortRef.current = controller;
+    const seq = sendSeqRef.current += 1;
+    const userMsgId = `stream-user-${Date.now()}-${seq}`;
+    const assistantMsgId = `stream-assistant-${Date.now()}-${seq}`;
+    const optimisticUserMsg = {
+      id: userMsgId,
+      role: 'USER',
+      content: message,
+      attachments
+    };
+    const streamingAssistantMsg = {
+      id: assistantMsgId,
+      role: 'ASSISTANT',
+      content: '',
+      streamStatus: 'streaming',
+      streamingText: ''
+    };
+    setStreamingMessages([optimisticUserMsg, streamingAssistantMsg]);
+
+    // Tokens accumulate as they arrive, but we reveal them into
+    // `streamingText` at a steady time-paced rate via requestAnimationFrame.
+    // Pacing the reveal below the host typer's per-char rate stops it from
+    // building a backlog it would skip through (the jumpy/"super fast" look).
+    let accumulated = ''; // full text received so far
+    let revealedLen = 0; // how many chars we've dripped into streamingText
+    let streamDone = false; // network stream ended
+    let carry = 0; // fractional chars carried between frames
+    let lastFrameTime = 0; // 0 = uninitialized
+
+    const settle = () => {
+      // Settle only after the drip has revealed everything AND the stream
+      // ended. Mirror the text into both `content` and `streamingText` so a
+      // host typer hands off with no re-type or flicker. Kept in
+      // `completedMessages` (stable id) so the confirmed copy from refetch is
+      // hidden and never remounts.
+      stopRaf();
+      const finalAssistantMsg = {
+        ...streamingAssistantMsg,
+        content: accumulated,
+        streamStatus: 'settled',
+        streamingText: accumulated
+      };
+      setCompletedMessages(prev => [...prev, optimisticUserMsg, finalAssistantMsg]);
+      setStreamingMessages([]);
+      void refetch();
+    };
+    const frame = now => {
+      if (lastFrameTime === 0) {
+        lastFrameTime = now;
+      }
+      const elapsedMs = now - lastFrameTime;
+      lastFrameTime = now;
+      if (revealedLen < accumulated.length) {
+        carry += elapsedMs / revealMsPerChar;
+        const step = Math.floor(carry);
+        if (step > 0) {
+          carry -= step;
+          revealedLen = Math.min(accumulated.length, revealedLen + step);
+          setStreamingMessages([optimisticUserMsg, {
+            ...streamingAssistantMsg,
+            streamStatus: 'streaming',
+            streamingText: accumulated.slice(0, revealedLen)
+          }]);
+        }
+        rafRef.current = requestAnimationFrame(frame);
+      } else if (streamDone) {
+        settle();
+      } else {
+        // Caught up, waiting for more tokens; onChunk will restart the loop.
+        stopRaf();
+      }
+    };
+    const startRaf = () => {
+      if (rafRef.current === null) {
+        lastFrameTime = 0;
+        rafRef.current = requestAnimationFrame(frame);
+      }
+    };
+
+    // Streaming deliberately bypasses the injected `personaChatService` (the
+    // DI seam every other hook uses): SSE needs a raw fetch with cookie auth
+    // to a caller-supplied url, which the Api-Key `IPersonaChatService` can't
+    // model. History reads still go through the service (see the query above).
+    await (0, _streamChatMessage.streamChatMessage)({
+      url: streamUrl,
+      chatId,
+      message,
+      namespace,
+      chatConfig,
+      attachments,
+      headers
+    }, {
+      onChunk: token => {
+        accumulated += token;
+        startRaf();
+      },
+      onDone: () => {
+        streamDone = true;
+        startRaf();
+      },
+      onError: err => {
+        stopRaf();
+        onError == null || onError(err);
+        setStreamingMessages([]);
+      }
+    }, controller.signal);
+  }, [streamUrl, chatId, namespace, headers, onError, refetch, revealMsPerChar, stopRaf]);
+  return {
+    status,
+    // Present for symmetry with `useTextChat`; the streaming path tracks its own
+    // optimistic state, so this is always empty.
+    pending: [],
+    messages,
+    fetchNext,
+    refetch,
+    send
+  };
+  function fetchNext() {
+    void fetchNextPage();
+  }
+}
+//# sourceMappingURL=useTextChatStream.js.map

package/dist/cjs/hooks/useTextChat/useTextChatStream.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_reactQuery","_sdkConsumer","_streamChatMessage","exports","streamChatMessage","messageKey","m","role","content","trim","useTextChatStream","options","streamUrl","limit","headers","onError","revealMsPerChar","chatId","namespace","personaChatService","useSdkConsumer","data","sdkMessages","status","fetchNextPage","refetch","useInfiniteQuery","queryKey","queryFn","pageParam","messages","nextCursor","undefined","queryChatMessages","cursor","getNextPageParam","lastPage","initialPageParam","select","pages","flatMap","page","streamingMessages","setStreamingMessages","useState","completedMessages","setCompletedMessages","abortRef","useRef","rafRef","lastConfirmedRef","sendSeqRef","stopRaf","useCallback","current","cancelAnimationFrame","useEffect","_abortRef$current","abort","useMemo","converted","reverse","confirmedMessages","length","completedKeys","Set","map","confirmedShown","filter","has","send","message","chatConfig","attachments","_abortRef$current2","controller","AbortController","seq","userMsgId","Date","now","assistantMsgId","optimisticUserMsg","id","streamingAssistantMsg","streamStatus","streamingText","accumulated","revealedLen","streamDone","carry","lastFrameTime","settle","finalAssistantMsg","prev","frame","elapsedMs","step","Math","floor","min","slice","requestAnimationFrame","startRaf","url","onChunk","token","onDone","err","signal","pending","fetchNext"],"sources":["../../../../src/hooks/useTextChat/useTextChatStream.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { useInfiniteQuery } from '@tanstack/react-query';\nimport type { ChatMessage, ChatMessageAttachment } from '../../types';\nimport { useSdkConsumer } from '../../sdk-consumer';\nimport { streamChatMessage } from '../../services/streamChatMessage';\n\n// Re-exported here so consumers can reach the framework-agnostic transport\n// alongside the hook.\nexport {\n  streamChatMessage,\n  type StreamCallbacks,\n  type StreamChatMessageParams,\n} from '../../services/streamChatMessage';\n\n/**\n * A `ChatMessage` augmented with streaming metadata. The host renderer uses\n * `streamStatus`/`streamingText` to drive its typewriter; confirmed\n * (non-streamed) messages carry neither.\n */\nexport type StreamingChatMessage = ChatMessage & {\n  streamingText?: string;\n  streamStatus?: 'streaming' | 'settled';\n};\n\nexport interface UseTextChatStreamOptions {\n  streamUrl: string;\n  limit?: number;\n  // Extra headers forwarded on every stream request — e.g. an `x-xsrf-token`\n  // when `streamUrl` sits behind a CSRF-protected gateway.\n  headers?: Record<string, string>;\n  // Stream failures surfaced to the host (e.g. to report to Sentry + toast).\n  onError?: (err: Error) => void;\n  // Milliseconds per character for the requestAnimationFrame reveal drip.\n  // Default 16 (~62 chars/s) — comfortably slower than the chat UI typer's\n  // ~8ms/char, so the typer never builds a backlog it would skip through.\n  revealMsPerChar?: number;\n}\n\nexport interface SendStreamMessageParams {\n  message: string;\n  chatConfig?: object;\n  attachments?: ChatMessageAttachment[];\n}\n\n/**\n * Identity for deduping optimistic streamed messages against confirmed ones.\n *\n * This is a *content* join: the streamed text must equal the server-persisted\n * copy for the confirmed duplicate to be hidden. `.trim()` absorbs trailing-\n * whitespace differences, but heavier server-side post-processing (markdown /\n * entity normalization, an appended citation) would make the keys diverge and\n * briefly surface both copies. A shared message id would be more robust, but\n * the streamed frames carry only token deltas — no id — so content equality is\n * the best join available without backend support.\n */\nconst messageKey = (m: StreamingChatMessage) =>\n  `${m.role}::${(m.content ?? '').trim()}`;\n\n/**\n * Streaming counterpart to `useTextChat`. Sends a message over the SSE transport\n * and drips the accumulated reply into `streamingText` at a steady, time-paced\n * rate (see `revealMsPerChar`) via requestAnimationFrame, merging the in-flight\n * and completed streamed exchanges with the confirmed history (oldest-first).\n * The host renderer (e.g. dolly) animates the dripped prefix with its own\n * typewriter; pacing the drip below the typer's per-char rate keeps the typer\n * from building a backlog it would otherwise skip through (jumpy reveal). The\n * exchange settles only once the drip has revealed everything AND the network\n * stream has ended, which avoids an end-of-reply snap.\n *\n * KNOWN LIMITATION: the streaming path does not run a function-call resolution\n * loop — parity with the current unary behavior.\n */\nexport function useTextChatStream(options: UseTextChatStreamOptions) {\n  const {\n    streamUrl,\n    limit = 50,\n    headers,\n    onError,\n    revealMsPerChar = 16,\n  } = options;\n\n  const { chatId, namespace, personaChatService } = useSdkConsumer();\n\n  const {\n    data: sdkMessages = [],\n    status,\n    fetchNextPage,\n    refetch,\n  } = useInfiniteQuery({\n    queryKey: ['chat-messages', chatId, namespace],\n    queryFn: async ({ pageParam }: { pageParam?: string }) => {\n      if (!personaChatService) {\n        return { messages: [], nextCursor: undefined };\n      }\n      return personaChatService.queryChatMessages({\n        chatId,\n        namespace,\n        limit,\n        cursor: pageParam,\n      });\n    },\n    getNextPageParam: (lastPage) => lastPage.nextCursor,\n    initialPageParam: undefined as string | undefined,\n    select: (data) =>\n      data.pages.flatMap((page) => page.messages as ChatMessage[]),\n  });\n\n  // Local state for the in-progress streaming exchange (user + assistant messages).\n  const [streamingMessages, setStreamingMessages] = useState<\n    StreamingChatMessage[]\n  >([]);\n  // Exchanges that finished streaming, kept for the lifetime of this chat. They\n  // keep their stable optimistic ids and stand in for the SDK's confirmed copies\n  // (which are hidden as duplicates) — this both bridges the refetch lag and\n  // avoids remounting the message (and restarting its typewriter) when the\n  // confirmed copy, with a different id, arrives.\n  const [completedMessages, setCompletedMessages] = useState<\n    StreamingChatMessage[]\n  >([]);\n  const abortRef = useRef<AbortController | null>(null);\n  // Handle of the pending reveal-drip animation frame, if any.\n  const rafRef = useRef<number | null>(null);\n  // Last non-empty confirmed list. `refetch()` can transiently empty sdkMessages;\n  // falling back to this keeps the history from disappearing and reappearing.\n  const lastConfirmedRef = useRef<StreamingChatMessage[]>([]);\n  // Monotonic per-hook counter so two sends within the same millisecond still\n  // produce distinct message ids (used as React keys downstream).\n  const sendSeqRef = useRef(0);\n\n  // Cancel any pending reveal-drip frame.\n  const stopRaf = useCallback(() => {\n    if (rafRef.current !== null) {\n      cancelAnimationFrame(rafRef.current);\n      rafRef.current = null;\n    }\n  }, []);\n\n  // Stop any in-flight stream (and reveal drip) on unmount.\n  useEffect(() => {\n    return () => {\n      abortRef.current?.abort();\n      stopRaf();\n    };\n  }, [stopRaf]);\n\n  const messages = useMemo<StreamingChatMessage[]>(() => {\n    const converted = [...sdkMessages].reverse() as StreamingChatMessage[];\n    const confirmedMessages =\n      converted.length > 0 ? converted : lastConfirmedRef.current;\n\n    // Show our locally-tracked streamed exchanges (stable ids) and hide the\n    // SDK's confirmed duplicates. Swapping to a confirmed copy would remount the\n    // message (different id) and restart its typewriter — that's the flicker.\n    // The in-progress streaming messages are always shown as-is.\n    const completedKeys = new Set(completedMessages.map(messageKey));\n    const confirmedShown = confirmedMessages.filter(\n      (m) => !completedKeys.has(messageKey(m)),\n    );\n    return [...confirmedShown, ...completedMessages, ...streamingMessages];\n  }, [sdkMessages, streamingMessages, completedMessages]);\n\n  // Remember the latest non-empty confirmed list so a transient empty during a\n  // refetch doesn't blank the history.\n  useEffect(() => {\n    const converted = [...sdkMessages].reverse() as StreamingChatMessage[];\n    if (converted.length > 0) {\n      lastConfirmedRef.current = converted;\n    }\n  }, [sdkMessages]);\n\n  const send = useCallback(\n    async ({ message, chatConfig, attachments }: SendStreamMessageParams) => {\n      // Abort any in-flight stream before starting a new one.\n      abortRef.current?.abort();\n      const controller = new AbortController();\n      abortRef.current = controller;\n\n      const seq = (sendSeqRef.current += 1);\n      const userMsgId = `stream-user-${Date.now()}-${seq}`;\n      const assistantMsgId = `stream-assistant-${Date.now()}-${seq}`;\n\n      const optimisticUserMsg: StreamingChatMessage = {\n        id: userMsgId,\n        role: 'USER',\n        content: message,\n        attachments,\n      };\n\n      const streamingAssistantMsg: StreamingChatMessage = {\n        id: assistantMsgId,\n        role: 'ASSISTANT',\n        content: '',\n        streamStatus: 'streaming',\n        streamingText: '',\n      };\n\n      setStreamingMessages([optimisticUserMsg, streamingAssistantMsg]);\n\n      // Tokens accumulate as they arrive, but we reveal them into\n      // `streamingText` at a steady time-paced rate via requestAnimationFrame.\n      // Pacing the reveal below the host typer's per-char rate stops it from\n      // building a backlog it would skip through (the jumpy/\"super fast\" look).\n      let accumulated = ''; // full text received so far\n      let revealedLen = 0; // how many chars we've dripped into streamingText\n      let streamDone = false; // network stream ended\n      let carry = 0; // fractional chars carried between frames\n      let lastFrameTime = 0; // 0 = uninitialized\n\n      const settle = () => {\n        // Settle only after the drip has revealed everything AND the stream\n        // ended. Mirror the text into both `content` and `streamingText` so a\n        // host typer hands off with no re-type or flicker. Kept in\n        // `completedMessages` (stable id) so the confirmed copy from refetch is\n        // hidden and never remounts.\n        stopRaf();\n        const finalAssistantMsg: StreamingChatMessage = {\n          ...streamingAssistantMsg,\n          content: accumulated,\n          streamStatus: 'settled',\n          streamingText: accumulated,\n        };\n        setCompletedMessages((prev) => [\n          ...prev,\n          optimisticUserMsg,\n          finalAssistantMsg,\n        ]);\n        setStreamingMessages([]);\n        void refetch();\n      };\n\n      const frame = (now: number) => {\n        if (lastFrameTime === 0) {\n          lastFrameTime = now;\n        }\n        const elapsedMs = now - lastFrameTime;\n        lastFrameTime = now;\n\n        if (revealedLen < accumulated.length) {\n          carry += elapsedMs / revealMsPerChar;\n          const step = Math.floor(carry);\n          if (step > 0) {\n            carry -= step;\n            revealedLen = Math.min(accumulated.length, revealedLen + step);\n            setStreamingMessages([\n              optimisticUserMsg,\n              {\n                ...streamingAssistantMsg,\n                streamStatus: 'streaming',\n                streamingText: accumulated.slice(0, revealedLen),\n              },\n            ]);\n          }\n          rafRef.current = requestAnimationFrame(frame);\n        } else if (streamDone) {\n          settle();\n        } else {\n          // Caught up, waiting for more tokens; onChunk will restart the loop.\n          stopRaf();\n        }\n      };\n\n      const startRaf = () => {\n        if (rafRef.current === null) {\n          lastFrameTime = 0;\n          rafRef.current = requestAnimationFrame(frame);\n        }\n      };\n\n      // Streaming deliberately bypasses the injected `personaChatService` (the\n      // DI seam every other hook uses): SSE needs a raw fetch with cookie auth\n      // to a caller-supplied url, which the Api-Key `IPersonaChatService` can't\n      // model. History reads still go through the service (see the query above).\n      await streamChatMessage(\n        {\n          url: streamUrl,\n          chatId,\n          message,\n          namespace,\n          chatConfig,\n          attachments,\n          headers,\n        },\n        {\n          onChunk: (token) => {\n            accumulated += token;\n            startRaf();\n          },\n          onDone: () => {\n            streamDone = true;\n            startRaf();\n          },\n          onError: (err) => {\n            stopRaf();\n            onError?.(err);\n            setStreamingMessages([]);\n          },\n        },\n        controller.signal,\n      );\n    },\n    [\n      streamUrl,\n      chatId,\n      namespace,\n      headers,\n      onError,\n      refetch,\n      revealMsPerChar,\n      stopRaf,\n    ],\n  );\n\n  return {\n    status,\n    // Present for symmetry with `useTextChat`; the streaming path tracks its own\n    // optimistic state, so this is always empty.\n    pending: [],\n    messages,\n    fetchNext,\n    refetch,\n    send,\n  };\n\n  function fetchNext() {\n    void fetchNextPage();\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cjs/services/streamChatMessage.js

@@ -0,0 +1,140 @@
+"use strict";
+
+exports.__esModule = true;
+exports.createObjectScanner = createObjectScanner;
+exports.extractContent = extractContent;
+exports.streamChatMessage = streamChatMessage;
+// Pull the assistant text out of one streamed frame. Two framings reach us: a
+// proxy route yields `{ content }` objects, while the gateway wraps each frame
+// as `{ body: base64(json) }`. Returns null for frames without content.
+function extractContent(frame) {
+  try {
+    const parsed = JSON.parse(frame);
+    if (typeof parsed.content === 'string') {
+      return parsed.content;
+    }
+    if (typeof parsed.body === 'string') {
+      const decoded = new TextDecoder().decode(Uint8Array.from(atob(parsed.body), char => char.charCodeAt(0)));
+      const inner = JSON.parse(decoded);
+      return typeof inner.content === 'string' ? inner.content : null;
+    }
+  } catch {
+    // Incomplete or non-object frame — skip it.
+  }
+  return null;
+}
+
+// Feeds decoded text through a running scanner that emits each complete
+// top-level `{…}` object as its closing brace arrives. This keeps a message
+// that's split across reads intact, and parses a newline-free JSON array (the
+// gateway framing) incrementally. Anything outside a top-level object is ignored.
+function createObjectScanner(onObject) {
+  let buffer = '';
+  let cursor = 0;
+  let braceDepth = 0;
+  let objectStart = -1;
+  let inString = false;
+  let escaped = false;
+  return function feed(text) {
+    buffer += text;
+    for (; cursor < buffer.length; cursor++) {
+      const char = buffer[cursor];
+      if (inString) {
+        if (escaped) {
+          escaped = false;
+        } else if (char === '\\') {
+          escaped = true;
+        } else if (char === '"') {
+          inString = false;
+        }
+        continue;
+      }
+      if (char === '"') {
+        inString = true;
+      } else if (char === '{') {
+        if (braceDepth === 0) {
+          objectStart = cursor;
+        }
+        braceDepth++;
+      } else if (char === '}' && braceDepth > 0) {
+        braceDepth--;
+        if (braceDepth === 0 && objectStart >= 0) {
+          onObject(buffer.slice(objectStart, cursor + 1));
+          objectStart = -1;
+        }
+      }
+    }
+  };
+}
+
+/**
+ * Framework-agnostic streaming transport. POSTs the message to the
+ * caller-supplied SSE endpoint, reads the response body incrementally, and
+ * fires `onChunk` per assistant token, `onDone` on close, `onError` on failure.
+ * A caller-supplied `AbortSignal` cancels the request; `AbortError` is swallowed.
+ */
+async function streamChatMessage(params, callbacks, signal) {
+  const {
+    url,
+    chatId,
+    message,
+    namespace,
+    chatConfig,
+    attachments,
+    headers
+  } = params;
+  const {
+    onChunk,
+    onDone,
+    onError
+  } = callbacks;
+  try {
+    const response = await fetch(url, {
+      method: 'POST',
+      credentials: 'include',
+      headers: {
+        'Content-Type': 'application/json',
+        ...headers
+      },
+      body: JSON.stringify({
+        chatId,
+        message,
+        namespace,
+        chatConfig,
+        attachments
+      }),
+      signal
+    });
+    if (!response.ok || !response.body) {
+      onError(new Error(`Stream request failed: ${response.status}`));
+      return;
+    }
+    const scanForObjects = createObjectScanner(frame => {
+      const content = extractContent(frame);
+      if (content !== null) {
+        onChunk(content);
+      }
+    });
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    for (;;) {
+      const {
+        done,
+        value
+      } = await reader.read();
+      if (done) {
+        break;
+      }
+      scanForObjects(decoder.decode(value, {
+        stream: true
+      }));
+    }
+    scanForObjects(decoder.decode());
+    onDone();
+  } catch (err) {
+    if (err.name !== 'AbortError') {
+      onError(err);
+    }
+  }
+}
+//# sourceMappingURL=streamChatMessage.js.map

package/dist/cjs/services/streamChatMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["extractContent","frame","parsed","JSON","parse","content","body","decoded","TextDecoder","decode","Uint8Array","from","atob","char","charCodeAt","inner","createObjectScanner","onObject","buffer","cursor","braceDepth","objectStart","inString","escaped","feed","text","length","slice","streamChatMessage","params","callbacks","signal","url","chatId","message","namespace","chatConfig","attachments","headers","onChunk","onDone","onError","response","fetch","method","credentials","stringify","ok","Error","status","scanForObjects","reader","getReader","decoder","done","value","read","stream","err","name"],"sources":["../../../src/services/streamChatMessage.ts"],"sourcesContent":["import type { ChatMessageAttachment } from '../types';\n\nexport type StreamCallbacks = {\n  onChunk: (token: string) => void;\n  onDone: () => void;\n  onError: (err: Error) => void;\n};\n\nexport type StreamChatMessageParams = {\n  // The caller supplies the endpoint (e.g. a proxied SSE route URL). The SDK\n  // stays agnostic about base paths and gateway passthroughs.\n  //\n  // SECURITY: the request is sent with `credentials: 'include'`, so the session\n  // cookie is delivered to whatever origin this resolves to. It must come from\n  // trusted host/config — never from user input.\n  url: string;\n  chatId: string;\n  message: string;\n  namespace: string;\n  chatConfig?: object;\n  attachments?: ChatMessageAttachment[];\n  // Extra request headers merged onto the POST. Lets the caller satisfy the\n  // host's transport requirements the SDK can't know about — e.g. an\n  // `x-xsrf-token` when the endpoint sits behind a CSRF-protected gateway.\n  headers?: Record<string, string>;\n};\n\n// Pull the assistant text out of one streamed frame. Two framings reach us: a\n// proxy route yields `{ content }` objects, while the gateway wraps each frame\n// as `{ body: base64(json) }`. Returns null for frames without content.\nexport function extractContent(frame: string): string | null {\n  try {\n    const parsed = JSON.parse(frame);\n    if (typeof parsed.content === 'string') {\n      return parsed.content;\n    }\n    if (typeof parsed.body === 'string') {\n      const decoded = new TextDecoder().decode(\n        Uint8Array.from(atob(parsed.body), (char) => char.charCodeAt(0)),\n      );\n      const inner = JSON.parse(decoded);\n      return typeof inner.content === 'string' ? inner.content : null;\n    }\n  } catch {\n    // Incomplete or non-object frame — skip it.\n  }\n  return null;\n}\n\n// Feeds decoded text through a running scanner that emits each complete\n// top-level `{…}` object as its closing brace arrives. This keeps a message\n// that's split across reads intact, and parses a newline-free JSON array (the\n// gateway framing) incrementally. Anything outside a top-level object is ignored.\nexport function createObjectScanner(onObject: (frame: string) => void) {\n  let buffer = '';\n  let cursor = 0;\n  let braceDepth = 0;\n  let objectStart = -1;\n  let inString = false;\n  let escaped = false;\n\n  return function feed(text: string) {\n    buffer += text;\n    for (; cursor < buffer.length; cursor++) {\n      const char = buffer[cursor];\n      if (inString) {\n        if (escaped) {\n          escaped = false;\n        } else if (char === '\\\\') {\n          escaped = true;\n        } else if (char === '\"') {\n          inString = false;\n        }\n        continue;\n      }\n      if (char === '\"') {\n        inString = true;\n      } else if (char === '{') {\n        if (braceDepth === 0) {\n          objectStart = cursor;\n        }\n        braceDepth++;\n      } else if (char === '}' && braceDepth > 0) {\n        braceDepth--;\n        if (braceDepth === 0 && objectStart >= 0) {\n          onObject(buffer.slice(objectStart, cursor + 1));\n          objectStart = -1;\n        }\n      }\n    }\n  };\n}\n\n/**\n * Framework-agnostic streaming transport. POSTs the message to the\n * caller-supplied SSE endpoint, reads the response body incrementally, and\n * fires `onChunk` per assistant token, `onDone` on close, `onError` on failure.\n * A caller-supplied `AbortSignal` cancels the request; `AbortError` is swallowed.\n */\nexport async function streamChatMessage(\n  params: StreamChatMessageParams,\n  callbacks: StreamCallbacks,\n  signal?: AbortSignal,\n): Promise<void> {\n  const { url, chatId, message, namespace, chatConfig, attachments, headers } =\n    params;\n  const { onChunk, onDone, onError } = callbacks;\n\n  try {\n    const response = await fetch(url, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { 'Content-Type': 'application/json', ...headers },\n      body: JSON.stringify({\n        chatId,\n        message,\n        namespace,\n        chatConfig,\n        attachments,\n      }),\n      signal,\n    });\n\n    if (!response.ok || !response.body) {\n      onError(new Error(`Stream request failed: ${response.status}`));\n      return;\n    }\n\n    const scanForObjects = createObjectScanner((frame) => {\n      const content = extractContent(frame);\n      if (content !== null) {\n        onChunk(content);\n      }\n    });\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n      scanForObjects(decoder.decode(value, { stream: true }));\n    }\n    scanForObjects(decoder.decode());\n    onDone();\n  } catch (err) {\n    if ((err as Error).name !== 'AbortError') {\n      onError(err as Error);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/hooks/useTextChat/index.js

@@ -1,2 +1,3 @@
 export * from './useTextChat';
+export * from './useTextChatStream';
 //# sourceMappingURL=index.js.map

package/dist/esm/hooks/useTextChat/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../../src/hooks/useTextChat/index.ts"],"sourcesContent":["export * from './useTextChat';\n"],"mappings":"AAAA,cAAc,eAAe","ignoreList":[]}
+{"version":3,"names":[],"sources":["../../../../src/hooks/useTextChat/index.ts"],"sourcesContent":["export * from './useTextChat';\nexport * from './useTextChatStream';\n"],"mappings":"AAAA,cAAc,eAAe;AAC7B,cAAc,qBAAqB","ignoreList":[]}

package/dist/esm/hooks/useTextChat/useTextChatStream.js

@@ -0,0 +1,270 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useInfiniteQuery } from '@tanstack/react-query';
+import { useSdkConsumer } from '../../sdk-consumer';
+import { streamChatMessage } from '../../services/streamChatMessage';
+
+// Re-exported here so consumers can reach the framework-agnostic transport
+// alongside the hook.
+export { streamChatMessage } from '../../services/streamChatMessage';
+
+/**
+ * A `ChatMessage` augmented with streaming metadata. The host renderer uses
+ * `streamStatus`/`streamingText` to drive its typewriter; confirmed
+ * (non-streamed) messages carry neither.
+ */
+
+/**
+ * Identity for deduping optimistic streamed messages against confirmed ones.
+ *
+ * This is a *content* join: the streamed text must equal the server-persisted
+ * copy for the confirmed duplicate to be hidden. `.trim()` absorbs trailing-
+ * whitespace differences, but heavier server-side post-processing (markdown /
+ * entity normalization, an appended citation) would make the keys diverge and
+ * briefly surface both copies. A shared message id would be more robust, but
+ * the streamed frames carry only token deltas — no id — so content equality is
+ * the best join available without backend support.
+ */
+const messageKey = m => `${m.role}::${(m.content ?? '').trim()}`;
+
+/**
+ * Streaming counterpart to `useTextChat`. Sends a message over the SSE transport
+ * and drips the accumulated reply into `streamingText` at a steady, time-paced
+ * rate (see `revealMsPerChar`) via requestAnimationFrame, merging the in-flight
+ * and completed streamed exchanges with the confirmed history (oldest-first).
+ * The host renderer (e.g. dolly) animates the dripped prefix with its own
+ * typewriter; pacing the drip below the typer's per-char rate keeps the typer
+ * from building a backlog it would otherwise skip through (jumpy reveal). The
+ * exchange settles only once the drip has revealed everything AND the network
+ * stream has ended, which avoids an end-of-reply snap.
+ *
+ * KNOWN LIMITATION: the streaming path does not run a function-call resolution
+ * loop — parity with the current unary behavior.
+ */
+export function useTextChatStream(options) {
+  const streamUrl = options.streamUrl,
+    _options$limit = options.limit,
+    limit = _options$limit === void 0 ? 50 : _options$limit,
+    headers = options.headers,
+    onError = options.onError,
+    _options$revealMsPerC = options.revealMsPerChar,
+    revealMsPerChar = _options$revealMsPerC === void 0 ? 16 : _options$revealMsPerC;
+  const _useSdkConsumer = useSdkConsumer(),
+    chatId = _useSdkConsumer.chatId,
+    namespace = _useSdkConsumer.namespace,
+    personaChatService = _useSdkConsumer.personaChatService;
+  const _useInfiniteQuery = useInfiniteQuery({
+      queryKey: ['chat-messages', chatId, namespace],
+      queryFn: async _ref => {
+        let pageParam = _ref.pageParam;
+        if (!personaChatService) {
+          return {
+            messages: [],
+            nextCursor: undefined
+          };
+        }
+        return personaChatService.queryChatMessages({
+          chatId,
+          namespace,
+          limit,
+          cursor: pageParam
+        });
+      },
+      getNextPageParam: lastPage => lastPage.nextCursor,
+      initialPageParam: undefined,
+      select: data => data.pages.flatMap(page => page.messages)
+    }),
+    _useInfiniteQuery$dat = _useInfiniteQuery.data,
+    sdkMessages = _useInfiniteQuery$dat === void 0 ? [] : _useInfiniteQuery$dat,
+    status = _useInfiniteQuery.status,
+    fetchNextPage = _useInfiniteQuery.fetchNextPage,
+    refetch = _useInfiniteQuery.refetch;
+
+  // Local state for the in-progress streaming exchange (user + assistant messages).
+  const _useState = useState([]),
+    streamingMessages = _useState[0],
+    setStreamingMessages = _useState[1];
+  // Exchanges that finished streaming, kept for the lifetime of this chat. They
+  // keep their stable optimistic ids and stand in for the SDK's confirmed copies
+  // (which are hidden as duplicates) — this both bridges the refetch lag and
+  // avoids remounting the message (and restarting its typewriter) when the
+  // confirmed copy, with a different id, arrives.
+  const _useState2 = useState([]),
+    completedMessages = _useState2[0],
+    setCompletedMessages = _useState2[1];
+  const abortRef = useRef(null);
+  // Handle of the pending reveal-drip animation frame, if any.
+  const rafRef = useRef(null);
+  // Last non-empty confirmed list. `refetch()` can transiently empty sdkMessages;
+  // falling back to this keeps the history from disappearing and reappearing.
+  const lastConfirmedRef = useRef([]);
+  // Monotonic per-hook counter so two sends within the same millisecond still
+  // produce distinct message ids (used as React keys downstream).
+  const sendSeqRef = useRef(0);
+
+  // Cancel any pending reveal-drip frame.
+  const stopRaf = useCallback(() => {
+    if (rafRef.current !== null) {
+      cancelAnimationFrame(rafRef.current);
+      rafRef.current = null;
+    }
+  }, []);
+
+  // Stop any in-flight stream (and reveal drip) on unmount.
+  useEffect(() => {
+    return () => {
+      var _abortRef$current;
+      (_abortRef$current = abortRef.current) == null || _abortRef$current.abort();
+      stopRaf();
+    };
+  }, [stopRaf]);
+  const messages = useMemo(() => {
+    const converted = [...sdkMessages].reverse();
+    const confirmedMessages = converted.length > 0 ? converted : lastConfirmedRef.current;
+
+    // Show our locally-tracked streamed exchanges (stable ids) and hide the
+    // SDK's confirmed duplicates. Swapping to a confirmed copy would remount the
+    // message (different id) and restart its typewriter — that's the flicker.
+    // The in-progress streaming messages are always shown as-is.
+    const completedKeys = new Set(completedMessages.map(messageKey));
+    const confirmedShown = confirmedMessages.filter(m => !completedKeys.has(messageKey(m)));
+    return [...confirmedShown, ...completedMessages, ...streamingMessages];
+  }, [sdkMessages, streamingMessages, completedMessages]);
+
+  // Remember the latest non-empty confirmed list so a transient empty during a
+  // refetch doesn't blank the history.
+  useEffect(() => {
+    const converted = [...sdkMessages].reverse();
+    if (converted.length > 0) {
+      lastConfirmedRef.current = converted;
+    }
+  }, [sdkMessages]);
+  const send = useCallback(async _ref2 => {
+    var _abortRef$current2;
+    let message = _ref2.message,
+      chatConfig = _ref2.chatConfig,
+      attachments = _ref2.attachments;
+    // Abort any in-flight stream before starting a new one.
+    (_abortRef$current2 = abortRef.current) == null || _abortRef$current2.abort();
+    const controller = new AbortController();
+    abortRef.current = controller;
+    const seq = sendSeqRef.current += 1;
+    const userMsgId = `stream-user-${Date.now()}-${seq}`;
+    const assistantMsgId = `stream-assistant-${Date.now()}-${seq}`;
+    const optimisticUserMsg = {
+      id: userMsgId,
+      role: 'USER',
+      content: message,
+      attachments
+    };
+    const streamingAssistantMsg = {
+      id: assistantMsgId,
+      role: 'ASSISTANT',
+      content: '',
+      streamStatus: 'streaming',
+      streamingText: ''
+    };
+    setStreamingMessages([optimisticUserMsg, streamingAssistantMsg]);
+
+    // Tokens accumulate as they arrive, but we reveal them into
+    // `streamingText` at a steady time-paced rate via requestAnimationFrame.
+    // Pacing the reveal below the host typer's per-char rate stops it from
+    // building a backlog it would skip through (the jumpy/"super fast" look).
+    let accumulated = ''; // full text received so far
+    let revealedLen = 0; // how many chars we've dripped into streamingText
+    let streamDone = false; // network stream ended
+    let carry = 0; // fractional chars carried between frames
+    let lastFrameTime = 0; // 0 = uninitialized
+
+    const settle = () => {
+      // Settle only after the drip has revealed everything AND the stream
+      // ended. Mirror the text into both `content` and `streamingText` so a
+      // host typer hands off with no re-type or flicker. Kept in
+      // `completedMessages` (stable id) so the confirmed copy from refetch is
+      // hidden and never remounts.
+      stopRaf();
+      const finalAssistantMsg = {
+        ...streamingAssistantMsg,
+        content: accumulated,
+        streamStatus: 'settled',
+        streamingText: accumulated
+      };
+      setCompletedMessages(prev => [...prev, optimisticUserMsg, finalAssistantMsg]);
+      setStreamingMessages([]);
+      void refetch();
+    };
+    const frame = now => {
+      if (lastFrameTime === 0) {
+        lastFrameTime = now;
+      }
+      const elapsedMs = now - lastFrameTime;
+      lastFrameTime = now;
+      if (revealedLen < accumulated.length) {
+        carry += elapsedMs / revealMsPerChar;
+        const step = Math.floor(carry);
+        if (step > 0) {
+          carry -= step;
+          revealedLen = Math.min(accumulated.length, revealedLen + step);
+          setStreamingMessages([optimisticUserMsg, {
+            ...streamingAssistantMsg,
+            streamStatus: 'streaming',
+            streamingText: accumulated.slice(0, revealedLen)
+          }]);
+        }
+        rafRef.current = requestAnimationFrame(frame);
+      } else if (streamDone) {
+        settle();
+      } else {
+        // Caught up, waiting for more tokens; onChunk will restart the loop.
+        stopRaf();
+      }
+    };
+    const startRaf = () => {
+      if (rafRef.current === null) {
+        lastFrameTime = 0;
+        rafRef.current = requestAnimationFrame(frame);
+      }
+    };
+
+    // Streaming deliberately bypasses the injected `personaChatService` (the
+    // DI seam every other hook uses): SSE needs a raw fetch with cookie auth
+    // to a caller-supplied url, which the Api-Key `IPersonaChatService` can't
+    // model. History reads still go through the service (see the query above).
+    await streamChatMessage({
+      url: streamUrl,
+      chatId,
+      message,
+      namespace,
+      chatConfig,
+      attachments,
+      headers
+    }, {
+      onChunk: token => {
+        accumulated += token;
+        startRaf();
+      },
+      onDone: () => {
+        streamDone = true;
+        startRaf();
+      },
+      onError: err => {
+        stopRaf();
+        onError == null || onError(err);
+        setStreamingMessages([]);
+      }
+    }, controller.signal);
+  }, [streamUrl, chatId, namespace, headers, onError, refetch, revealMsPerChar, stopRaf]);
+  return {
+    status,
+    // Present for symmetry with `useTextChat`; the streaming path tracks its own
+    // optimistic state, so this is always empty.
+    pending: [],
+    messages,
+    fetchNext,
+    refetch,
+    send
+  };
+  function fetchNext() {
+    void fetchNextPage();
+  }
+}
+//# sourceMappingURL=useTextChatStream.js.map

package/dist/esm/hooks/useTextChat/useTextChatStream.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useMemo","useRef","useState","useInfiniteQuery","useSdkConsumer","streamChatMessage","messageKey","m","role","content","trim","useTextChatStream","options","streamUrl","_options$limit","limit","headers","onError","_options$revealMsPerC","revealMsPerChar","_useSdkConsumer","chatId","namespace","personaChatService","_useInfiniteQuery","queryKey","queryFn","_ref","pageParam","messages","nextCursor","undefined","queryChatMessages","cursor","getNextPageParam","lastPage","initialPageParam","select","data","pages","flatMap","page","_useInfiniteQuery$dat","sdkMessages","status","fetchNextPage","refetch","_useState","streamingMessages","setStreamingMessages","_useState2","completedMessages","setCompletedMessages","abortRef","rafRef","lastConfirmedRef","sendSeqRef","stopRaf","current","cancelAnimationFrame","_abortRef$current","abort","converted","reverse","confirmedMessages","length","completedKeys","Set","map","confirmedShown","filter","has","send","_ref2","_abortRef$current2","message","chatConfig","attachments","controller","AbortController","seq","userMsgId","Date","now","assistantMsgId","optimisticUserMsg","id","streamingAssistantMsg","streamStatus","streamingText","accumulated","revealedLen","streamDone","carry","lastFrameTime","settle","finalAssistantMsg","prev","frame","elapsedMs","step","Math","floor","min","slice","requestAnimationFrame","startRaf","url","onChunk","token","onDone","err","signal","pending","fetchNext"],"sources":["../../../../src/hooks/useTextChat/useTextChatStream.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { useInfiniteQuery } from '@tanstack/react-query';\nimport type { ChatMessage, ChatMessageAttachment } from '../../types';\nimport { useSdkConsumer } from '../../sdk-consumer';\nimport { streamChatMessage } from '../../services/streamChatMessage';\n\n// Re-exported here so consumers can reach the framework-agnostic transport\n// alongside the hook.\nexport {\n  streamChatMessage,\n  type StreamCallbacks,\n  type StreamChatMessageParams,\n} from '../../services/streamChatMessage';\n\n/**\n * A `ChatMessage` augmented with streaming metadata. The host renderer uses\n * `streamStatus`/`streamingText` to drive its typewriter; confirmed\n * (non-streamed) messages carry neither.\n */\nexport type StreamingChatMessage = ChatMessage & {\n  streamingText?: string;\n  streamStatus?: 'streaming' | 'settled';\n};\n\nexport interface UseTextChatStreamOptions {\n  streamUrl: string;\n  limit?: number;\n  // Extra headers forwarded on every stream request — e.g. an `x-xsrf-token`\n  // when `streamUrl` sits behind a CSRF-protected gateway.\n  headers?: Record<string, string>;\n  // Stream failures surfaced to the host (e.g. to report to Sentry + toast).\n  onError?: (err: Error) => void;\n  // Milliseconds per character for the requestAnimationFrame reveal drip.\n  // Default 16 (~62 chars/s) — comfortably slower than the chat UI typer's\n  // ~8ms/char, so the typer never builds a backlog it would skip through.\n  revealMsPerChar?: number;\n}\n\nexport interface SendStreamMessageParams {\n  message: string;\n  chatConfig?: object;\n  attachments?: ChatMessageAttachment[];\n}\n\n/**\n * Identity for deduping optimistic streamed messages against confirmed ones.\n *\n * This is a *content* join: the streamed text must equal the server-persisted\n * copy for the confirmed duplicate to be hidden. `.trim()` absorbs trailing-\n * whitespace differences, but heavier server-side post-processing (markdown /\n * entity normalization, an appended citation) would make the keys diverge and\n * briefly surface both copies. A shared message id would be more robust, but\n * the streamed frames carry only token deltas — no id — so content equality is\n * the best join available without backend support.\n */\nconst messageKey = (m: StreamingChatMessage) =>\n  `${m.role}::${(m.content ?? '').trim()}`;\n\n/**\n * Streaming counterpart to `useTextChat`. Sends a message over the SSE transport\n * and drips the accumulated reply into `streamingText` at a steady, time-paced\n * rate (see `revealMsPerChar`) via requestAnimationFrame, merging the in-flight\n * and completed streamed exchanges with the confirmed history (oldest-first).\n * The host renderer (e.g. dolly) animates the dripped prefix with its own\n * typewriter; pacing the drip below the typer's per-char rate keeps the typer\n * from building a backlog it would otherwise skip through (jumpy reveal). The\n * exchange settles only once the drip has revealed everything AND the network\n * stream has ended, which avoids an end-of-reply snap.\n *\n * KNOWN LIMITATION: the streaming path does not run a function-call resolution\n * loop — parity with the current unary behavior.\n */\nexport function useTextChatStream(options: UseTextChatStreamOptions) {\n  const {\n    streamUrl,\n    limit = 50,\n    headers,\n    onError,\n    revealMsPerChar = 16,\n  } = options;\n\n  const { chatId, namespace, personaChatService } = useSdkConsumer();\n\n  const {\n    data: sdkMessages = [],\n    status,\n    fetchNextPage,\n    refetch,\n  } = useInfiniteQuery({\n    queryKey: ['chat-messages', chatId, namespace],\n    queryFn: async ({ pageParam }: { pageParam?: string }) => {\n      if (!personaChatService) {\n        return { messages: [], nextCursor: undefined };\n      }\n      return personaChatService.queryChatMessages({\n        chatId,\n        namespace,\n        limit,\n        cursor: pageParam,\n      });\n    },\n    getNextPageParam: (lastPage) => lastPage.nextCursor,\n    initialPageParam: undefined as string | undefined,\n    select: (data) =>\n      data.pages.flatMap((page) => page.messages as ChatMessage[]),\n  });\n\n  // Local state for the in-progress streaming exchange (user + assistant messages).\n  const [streamingMessages, setStreamingMessages] = useState<\n    StreamingChatMessage[]\n  >([]);\n  // Exchanges that finished streaming, kept for the lifetime of this chat. They\n  // keep their stable optimistic ids and stand in for the SDK's confirmed copies\n  // (which are hidden as duplicates) — this both bridges the refetch lag and\n  // avoids remounting the message (and restarting its typewriter) when the\n  // confirmed copy, with a different id, arrives.\n  const [completedMessages, setCompletedMessages] = useState<\n    StreamingChatMessage[]\n  >([]);\n  const abortRef = useRef<AbortController | null>(null);\n  // Handle of the pending reveal-drip animation frame, if any.\n  const rafRef = useRef<number | null>(null);\n  // Last non-empty confirmed list. `refetch()` can transiently empty sdkMessages;\n  // falling back to this keeps the history from disappearing and reappearing.\n  const lastConfirmedRef = useRef<StreamingChatMessage[]>([]);\n  // Monotonic per-hook counter so two sends within the same millisecond still\n  // produce distinct message ids (used as React keys downstream).\n  const sendSeqRef = useRef(0);\n\n  // Cancel any pending reveal-drip frame.\n  const stopRaf = useCallback(() => {\n    if (rafRef.current !== null) {\n      cancelAnimationFrame(rafRef.current);\n      rafRef.current = null;\n    }\n  }, []);\n\n  // Stop any in-flight stream (and reveal drip) on unmount.\n  useEffect(() => {\n    return () => {\n      abortRef.current?.abort();\n      stopRaf();\n    };\n  }, [stopRaf]);\n\n  const messages = useMemo<StreamingChatMessage[]>(() => {\n    const converted = [...sdkMessages].reverse() as StreamingChatMessage[];\n    const confirmedMessages =\n      converted.length > 0 ? converted : lastConfirmedRef.current;\n\n    // Show our locally-tracked streamed exchanges (stable ids) and hide the\n    // SDK's confirmed duplicates. Swapping to a confirmed copy would remount the\n    // message (different id) and restart its typewriter — that's the flicker.\n    // The in-progress streaming messages are always shown as-is.\n    const completedKeys = new Set(completedMessages.map(messageKey));\n    const confirmedShown = confirmedMessages.filter(\n      (m) => !completedKeys.has(messageKey(m)),\n    );\n    return [...confirmedShown, ...completedMessages, ...streamingMessages];\n  }, [sdkMessages, streamingMessages, completedMessages]);\n\n  // Remember the latest non-empty confirmed list so a transient empty during a\n  // refetch doesn't blank the history.\n  useEffect(() => {\n    const converted = [...sdkMessages].reverse() as StreamingChatMessage[];\n    if (converted.length > 0) {\n      lastConfirmedRef.current = converted;\n    }\n  }, [sdkMessages]);\n\n  const send = useCallback(\n    async ({ message, chatConfig, attachments }: SendStreamMessageParams) => {\n      // Abort any in-flight stream before starting a new one.\n      abortRef.current?.abort();\n      const controller = new AbortController();\n      abortRef.current = controller;\n\n      const seq = (sendSeqRef.current += 1);\n      const userMsgId = `stream-user-${Date.now()}-${seq}`;\n      const assistantMsgId = `stream-assistant-${Date.now()}-${seq}`;\n\n      const optimisticUserMsg: StreamingChatMessage = {\n        id: userMsgId,\n        role: 'USER',\n        content: message,\n        attachments,\n      };\n\n      const streamingAssistantMsg: StreamingChatMessage = {\n        id: assistantMsgId,\n        role: 'ASSISTANT',\n        content: '',\n        streamStatus: 'streaming',\n        streamingText: '',\n      };\n\n      setStreamingMessages([optimisticUserMsg, streamingAssistantMsg]);\n\n      // Tokens accumulate as they arrive, but we reveal them into\n      // `streamingText` at a steady time-paced rate via requestAnimationFrame.\n      // Pacing the reveal below the host typer's per-char rate stops it from\n      // building a backlog it would skip through (the jumpy/\"super fast\" look).\n      let accumulated = ''; // full text received so far\n      let revealedLen = 0; // how many chars we've dripped into streamingText\n      let streamDone = false; // network stream ended\n      let carry = 0; // fractional chars carried between frames\n      let lastFrameTime = 0; // 0 = uninitialized\n\n      const settle = () => {\n        // Settle only after the drip has revealed everything AND the stream\n        // ended. Mirror the text into both `content` and `streamingText` so a\n        // host typer hands off with no re-type or flicker. Kept in\n        // `completedMessages` (stable id) so the confirmed copy from refetch is\n        // hidden and never remounts.\n        stopRaf();\n        const finalAssistantMsg: StreamingChatMessage = {\n          ...streamingAssistantMsg,\n          content: accumulated,\n          streamStatus: 'settled',\n          streamingText: accumulated,\n        };\n        setCompletedMessages((prev) => [\n          ...prev,\n          optimisticUserMsg,\n          finalAssistantMsg,\n        ]);\n        setStreamingMessages([]);\n        void refetch();\n      };\n\n      const frame = (now: number) => {\n        if (lastFrameTime === 0) {\n          lastFrameTime = now;\n        }\n        const elapsedMs = now - lastFrameTime;\n        lastFrameTime = now;\n\n        if (revealedLen < accumulated.length) {\n          carry += elapsedMs / revealMsPerChar;\n          const step = Math.floor(carry);\n          if (step > 0) {\n            carry -= step;\n            revealedLen = Math.min(accumulated.length, revealedLen + step);\n            setStreamingMessages([\n              optimisticUserMsg,\n              {\n                ...streamingAssistantMsg,\n                streamStatus: 'streaming',\n                streamingText: accumulated.slice(0, revealedLen),\n              },\n            ]);\n          }\n          rafRef.current = requestAnimationFrame(frame);\n        } else if (streamDone) {\n          settle();\n        } else {\n          // Caught up, waiting for more tokens; onChunk will restart the loop.\n          stopRaf();\n        }\n      };\n\n      const startRaf = () => {\n        if (rafRef.current === null) {\n          lastFrameTime = 0;\n          rafRef.current = requestAnimationFrame(frame);\n        }\n      };\n\n      // Streaming deliberately bypasses the injected `personaChatService` (the\n      // DI seam every other hook uses): SSE needs a raw fetch with cookie auth\n      // to a caller-supplied url, which the Api-Key `IPersonaChatService` can't\n      // model. History reads still go through the service (see the query above).\n      await streamChatMessage(\n        {\n          url: streamUrl,\n          chatId,\n          message,\n          namespace,\n          chatConfig,\n          attachments,\n          headers,\n        },\n        {\n          onChunk: (token) => {\n            accumulated += token;\n            startRaf();\n          },\n          onDone: () => {\n            streamDone = true;\n            startRaf();\n          },\n          onError: (err) => {\n            stopRaf();\n            onError?.(err);\n            setStreamingMessages([]);\n          },\n        },\n        controller.signal,\n      );\n    },\n    [\n      streamUrl,\n      chatId,\n      namespace,\n      headers,\n      onError,\n      refetch,\n      revealMsPerChar,\n      stopRaf,\n    ],\n  );\n\n  return {\n    status,\n    // Present for symmetry with `useTextChat`; the streaming path tracks its own\n    // optimistic state, so this is always empty.\n    pending: [],\n    messages,\n    fetchNext,\n    refetch,\n    send,\n  };\n\n  function fetchNext() {\n    void fetchNextPage();\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/services/streamChatMessage.js

@@ -0,0 +1,129 @@
+// Pull the assistant text out of one streamed frame. Two framings reach us: a
+// proxy route yields `{ content }` objects, while the gateway wraps each frame
+// as `{ body: base64(json) }`. Returns null for frames without content.
+export function extractContent(frame) {
+  try {
+    const parsed = JSON.parse(frame);
+    if (typeof parsed.content === 'string') {
+      return parsed.content;
+    }
+    if (typeof parsed.body === 'string') {
+      const decoded = new TextDecoder().decode(Uint8Array.from(atob(parsed.body), char => char.charCodeAt(0)));
+      const inner = JSON.parse(decoded);
+      return typeof inner.content === 'string' ? inner.content : null;
+    }
+  } catch {
+    // Incomplete or non-object frame — skip it.
+  }
+  return null;
+}
+
+// Feeds decoded text through a running scanner that emits each complete
+// top-level `{…}` object as its closing brace arrives. This keeps a message
+// that's split across reads intact, and parses a newline-free JSON array (the
+// gateway framing) incrementally. Anything outside a top-level object is ignored.
+export function createObjectScanner(onObject) {
+  let buffer = '';
+  let cursor = 0;
+  let braceDepth = 0;
+  let objectStart = -1;
+  let inString = false;
+  let escaped = false;
+  return function feed(text) {
+    buffer += text;
+    for (; cursor < buffer.length; cursor++) {
+      const char = buffer[cursor];
+      if (inString) {
+        if (escaped) {
+          escaped = false;
+        } else if (char === '\\') {
+          escaped = true;
+        } else if (char === '"') {
+          inString = false;
+        }
+        continue;
+      }
+      if (char === '"') {
+        inString = true;
+      } else if (char === '{') {
+        if (braceDepth === 0) {
+          objectStart = cursor;
+        }
+        braceDepth++;
+      } else if (char === '}' && braceDepth > 0) {
+        braceDepth--;
+        if (braceDepth === 0 && objectStart >= 0) {
+          onObject(buffer.slice(objectStart, cursor + 1));
+          objectStart = -1;
+        }
+      }
+    }
+  };
+}
+
+/**
+ * Framework-agnostic streaming transport. POSTs the message to the
+ * caller-supplied SSE endpoint, reads the response body incrementally, and
+ * fires `onChunk` per assistant token, `onDone` on close, `onError` on failure.
+ * A caller-supplied `AbortSignal` cancels the request; `AbortError` is swallowed.
+ */
+export async function streamChatMessage(params, callbacks, signal) {
+  const url = params.url,
+    chatId = params.chatId,
+    message = params.message,
+    namespace = params.namespace,
+    chatConfig = params.chatConfig,
+    attachments = params.attachments,
+    headers = params.headers;
+  const onChunk = callbacks.onChunk,
+    onDone = callbacks.onDone,
+    onError = callbacks.onError;
+  try {
+    const response = await fetch(url, {
+      method: 'POST',
+      credentials: 'include',
+      headers: {
+        'Content-Type': 'application/json',
+        ...headers
+      },
+      body: JSON.stringify({
+        chatId,
+        message,
+        namespace,
+        chatConfig,
+        attachments
+      }),
+      signal
+    });
+    if (!response.ok || !response.body) {
+      onError(new Error(`Stream request failed: ${response.status}`));
+      return;
+    }
+    const scanForObjects = createObjectScanner(frame => {
+      const content = extractContent(frame);
+      if (content !== null) {
+        onChunk(content);
+      }
+    });
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    for (;;) {
+      const _await$reader$read = await reader.read(),
+        done = _await$reader$read.done,
+        value = _await$reader$read.value;
+      if (done) {
+        break;
+      }
+      scanForObjects(decoder.decode(value, {
+        stream: true
+      }));
+    }
+    scanForObjects(decoder.decode());
+    onDone();
+  } catch (err) {
+    if (err.name !== 'AbortError') {
+      onError(err);
+    }
+  }
+}
+//# sourceMappingURL=streamChatMessage.js.map

package/dist/esm/services/streamChatMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["extractContent","frame","parsed","JSON","parse","content","body","decoded","TextDecoder","decode","Uint8Array","from","atob","char","charCodeAt","inner","createObjectScanner","onObject","buffer","cursor","braceDepth","objectStart","inString","escaped","feed","text","length","slice","streamChatMessage","params","callbacks","signal","url","chatId","message","namespace","chatConfig","attachments","headers","onChunk","onDone","onError","response","fetch","method","credentials","stringify","ok","Error","status","scanForObjects","reader","getReader","decoder","_await$reader$read","read","done","value","stream","err","name"],"sources":["../../../src/services/streamChatMessage.ts"],"sourcesContent":["import type { ChatMessageAttachment } from '../types';\n\nexport type StreamCallbacks = {\n  onChunk: (token: string) => void;\n  onDone: () => void;\n  onError: (err: Error) => void;\n};\n\nexport type StreamChatMessageParams = {\n  // The caller supplies the endpoint (e.g. a proxied SSE route URL). The SDK\n  // stays agnostic about base paths and gateway passthroughs.\n  //\n  // SECURITY: the request is sent with `credentials: 'include'`, so the session\n  // cookie is delivered to whatever origin this resolves to. It must come from\n  // trusted host/config — never from user input.\n  url: string;\n  chatId: string;\n  message: string;\n  namespace: string;\n  chatConfig?: object;\n  attachments?: ChatMessageAttachment[];\n  // Extra request headers merged onto the POST. Lets the caller satisfy the\n  // host's transport requirements the SDK can't know about — e.g. an\n  // `x-xsrf-token` when the endpoint sits behind a CSRF-protected gateway.\n  headers?: Record<string, string>;\n};\n\n// Pull the assistant text out of one streamed frame. Two framings reach us: a\n// proxy route yields `{ content }` objects, while the gateway wraps each frame\n// as `{ body: base64(json) }`. Returns null for frames without content.\nexport function extractContent(frame: string): string | null {\n  try {\n    const parsed = JSON.parse(frame);\n    if (typeof parsed.content === 'string') {\n      return parsed.content;\n    }\n    if (typeof parsed.body === 'string') {\n      const decoded = new TextDecoder().decode(\n        Uint8Array.from(atob(parsed.body), (char) => char.charCodeAt(0)),\n      );\n      const inner = JSON.parse(decoded);\n      return typeof inner.content === 'string' ? inner.content : null;\n    }\n  } catch {\n    // Incomplete or non-object frame — skip it.\n  }\n  return null;\n}\n\n// Feeds decoded text through a running scanner that emits each complete\n// top-level `{…}` object as its closing brace arrives. This keeps a message\n// that's split across reads intact, and parses a newline-free JSON array (the\n// gateway framing) incrementally. Anything outside a top-level object is ignored.\nexport function createObjectScanner(onObject: (frame: string) => void) {\n  let buffer = '';\n  let cursor = 0;\n  let braceDepth = 0;\n  let objectStart = -1;\n  let inString = false;\n  let escaped = false;\n\n  return function feed(text: string) {\n    buffer += text;\n    for (; cursor < buffer.length; cursor++) {\n      const char = buffer[cursor];\n      if (inString) {\n        if (escaped) {\n          escaped = false;\n        } else if (char === '\\\\') {\n          escaped = true;\n        } else if (char === '\"') {\n          inString = false;\n        }\n        continue;\n      }\n      if (char === '\"') {\n        inString = true;\n      } else if (char === '{') {\n        if (braceDepth === 0) {\n          objectStart = cursor;\n        }\n        braceDepth++;\n      } else if (char === '}' && braceDepth > 0) {\n        braceDepth--;\n        if (braceDepth === 0 && objectStart >= 0) {\n          onObject(buffer.slice(objectStart, cursor + 1));\n          objectStart = -1;\n        }\n      }\n    }\n  };\n}\n\n/**\n * Framework-agnostic streaming transport. POSTs the message to the\n * caller-supplied SSE endpoint, reads the response body incrementally, and\n * fires `onChunk` per assistant token, `onDone` on close, `onError` on failure.\n * A caller-supplied `AbortSignal` cancels the request; `AbortError` is swallowed.\n */\nexport async function streamChatMessage(\n  params: StreamChatMessageParams,\n  callbacks: StreamCallbacks,\n  signal?: AbortSignal,\n): Promise<void> {\n  const { url, chatId, message, namespace, chatConfig, attachments, headers } =\n    params;\n  const { onChunk, onDone, onError } = callbacks;\n\n  try {\n    const response = await fetch(url, {\n      method: 'POST',\n      credentials: 'include',\n      headers: { 'Content-Type': 'application/json', ...headers },\n      body: JSON.stringify({\n        chatId,\n        message,\n        namespace,\n        chatConfig,\n        attachments,\n      }),\n      signal,\n    });\n\n    if (!response.ok || !response.body) {\n      onError(new Error(`Stream request failed: ${response.status}`));\n      return;\n    }\n\n    const scanForObjects = createObjectScanner((frame) => {\n      const content = extractContent(frame);\n      if (content !== null) {\n        onChunk(content);\n      }\n    });\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n      scanForObjects(decoder.decode(value, { stream: true }));\n    }\n    scanForObjects(decoder.decode());\n    onDone();\n  } catch (err) {\n    if ((err as Error).name !== 'AbortError') {\n      onError(err as Error);\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/types/hooks/useTextChat/index.d.ts

@@ -1,2 +1,3 @@
 export * from './useTextChat';
+export * from './useTextChatStream';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/hooks/useTextChat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useTextChat/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useTextChat/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC"}

package/dist/types/hooks/useTextChat/useTextChatStream.d.ts

@@ -0,0 +1,46 @@
+import type { ChatMessage, ChatMessageAttachment } from '../../types';
+export { streamChatMessage, type StreamCallbacks, type StreamChatMessageParams, } from '../../services/streamChatMessage';
+/**
+ * A `ChatMessage` augmented with streaming metadata. The host renderer uses
+ * `streamStatus`/`streamingText` to drive its typewriter; confirmed
+ * (non-streamed) messages carry neither.
+ */
+export type StreamingChatMessage = ChatMessage & {
+    streamingText?: string;
+    streamStatus?: 'streaming' | 'settled';
+};
+export interface UseTextChatStreamOptions {
+    streamUrl: string;
+    limit?: number;
+    headers?: Record<string, string>;
+    onError?: (err: Error) => void;
+    revealMsPerChar?: number;
+}
+export interface SendStreamMessageParams {
+    message: string;
+    chatConfig?: object;
+    attachments?: ChatMessageAttachment[];
+}
+/**
+ * Streaming counterpart to `useTextChat`. Sends a message over the SSE transport
+ * and drips the accumulated reply into `streamingText` at a steady, time-paced
+ * rate (see `revealMsPerChar`) via requestAnimationFrame, merging the in-flight
+ * and completed streamed exchanges with the confirmed history (oldest-first).
+ * The host renderer (e.g. dolly) animates the dripped prefix with its own
+ * typewriter; pacing the drip below the typer's per-char rate keeps the typer
+ * from building a backlog it would otherwise skip through (jumpy reveal). The
+ * exchange settles only once the drip has revealed everything AND the network
+ * stream has ended, which avoids an end-of-reply snap.
+ *
+ * KNOWN LIMITATION: the streaming path does not run a function-call resolution
+ * loop — parity with the current unary behavior.
+ */
+export declare function useTextChatStream(options: UseTextChatStreamOptions): {
+    status: "pending" | "error" | "success";
+    pending: never[];
+    messages: StreamingChatMessage[];
+    fetchNext: () => void;
+    refetch: (options?: import("@tanstack/query-core/build/legacy/hydration-BlEVG2Lp").aq | undefined) => Promise<import("@tanstack/query-core/build/legacy/hydration-BlEVG2Lp").aH<ChatMessage[], Error>>;
+    send: ({ message, chatConfig, attachments }: SendStreamMessageParams) => Promise<void>;
+};
+//# sourceMappingURL=useTextChatStream.d.ts.map

package/dist/types/hooks/useTextChat/useTextChatStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTextChatStream.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useTextChat/useTextChatStream.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAMtE,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAI/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACvC;AAgBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB;;;;;;iDAmGlB,uBAAuB;EA2JvE"}

package/dist/types/services/streamChatMessage.d.ts

@@ -0,0 +1,25 @@
+import type { ChatMessageAttachment } from '../types';
+export type StreamCallbacks = {
+    onChunk: (token: string) => void;
+    onDone: () => void;
+    onError: (err: Error) => void;
+};
+export type StreamChatMessageParams = {
+    url: string;
+    chatId: string;
+    message: string;
+    namespace: string;
+    chatConfig?: object;
+    attachments?: ChatMessageAttachment[];
+    headers?: Record<string, string>;
+};
+export declare function extractContent(frame: string): string | null;
+export declare function createObjectScanner(onObject: (frame: string) => void): (text: string) => void;
+/**
+ * Framework-agnostic streaming transport. POSTs the message to the
+ * caller-supplied SSE endpoint, reads the response body incrementally, and
+ * fires `onChunk` per assistant token, `onDone` on close, `onError` on failure.
+ * A caller-supplied `AbortSignal` cancels the request; `AbortError` is swallowed.
+ */
+export declare function streamChatMessage(params: StreamChatMessageParams, callbacks: StreamCallbacks, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=streamChatMessage.d.ts.map

package/dist/types/services/streamChatMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamChatMessage.d.ts","sourceRoot":"","sources":["../../../src/services/streamChatMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAOpC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAItC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAKF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiB3D;AAMD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,UAQxC,MAAM,UA8BlC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,EAC/B,SAAS,EAAE,eAAe,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.7.0",
+  "version": "1.9.0",
   "name": "@wix/legends-platform-sdk",
   "license": "MIT",
   "author": {
@@ -103,5 +103,5 @@
   "wallaby": {
     "autoDetect": true
   },
-  "falconPackageHash": "65d6f955a3a805b2511326986d408969ce62ade38ddcda7deb8bcf9c"
+  "falconPackageHash": "e93bb4f738434f45ce730b0465ade783249af8d03bd939de0c73a284"
 }