bs-agent 0.0.26 → 0.0.27

package/README.md

@@ -370,6 +370,56 @@ handleSend(input: AgentInput, options?: {
 `AgentInput` is `string | ContentPart[]` — see
 [Multimodal Input](#multimodal-input).
 
+### Text Modifiers
+
+`useAgent` accepts optional modifier functions that transform streamed text
+before it is stored in messages. This is useful for stripping thinking tags,
+converting markup, or applying any real-time post-processing.
+
+#### `textDeltaModifier`
+
+Runs on **each incoming text chunk** before it is appended. Receives the raw
+delta, the full text accumulated so far, and event metadata.
+
+```tsx
+const agent = useAgent(myAgent, {
+  textDeltaModifier: (delta, fullText, meta) => {
+    // Example: strip <think>…</think> tags from each chunk
+    return delta.replace(/<\/?think>/g, "");
+  },
+});
+```
+
+#### `fullTextModifier`
+
+Runs on the **accumulated full text** after every delta is appended. The return
+value becomes the displayed text, while the unmodified accumulation is preserved
+internally as `_rawText`.
+
+```tsx
+const agent = useAgent(myAgent, {
+  fullTextModifier: (fullText, meta) => {
+    // Example: render LaTeX-style math as Unicode
+    return convertLatex(fullText);
+  },
+});
+```
+
+#### Using both together
+
+When both modifiers are provided they **chain** in order:
+
+```
+raw delta → textDeltaModifier(delta) → accumulated text → fullTextModifier(accumulated) → display
+```
+
+`textDeltaModifier` acts as a per-chunk preprocessor; `fullTextModifier` acts as
+a post-accumulation formatter on top of the already-modified text.
+
+> **Note:** `_rawText` stores the `textDeltaModifier`-processed accumulation,
+> not the original unmodified stream. If `textDeltaModifier` strips content,
+> `fullTextModifier` will never see it.
+
 ## `useAgentContext` Hook
 
 An alternative to `useAgent` for multi-agent setups. Initializes agents

package/dist/react/index.cjs

@@ -51,6 +51,18 @@ var TEMPORARY_SESSION_ID = "sess_temp";
 
 // src/react/session-utils.ts
 var import_react = require("react");
+function sanitizeMessagesForStorage(messages) {
+  return messages.map((msg) => {
+    if (!msg.attachments || msg.attachments.length === 0) return msg;
+    return {
+      ...msg,
+      attachments: msg.attachments.map((att) => {
+        const { data, ...metadata } = att;
+        return metadata;
+      })
+    };
+  });
+}
 var useSessionUtils = (agentId, allSessions, setAllSessions, currentSessionId, setCurrentSessionId, messagesRef) => {
   const agentSessions = (0, import_react.useMemo)(() => allSessions[agentId] || {}, [agentId, allSessions]);
   const syncSessionRef = (0, import_react.useRef)();
@@ -58,13 +70,14 @@ var useSessionUtils = (agentId, allSessions, setAllSessions, currentSessionId, s
     if (!currentSessionId || currentSessionId === TEMPORARY_SESSION_ID) {
       return;
     }
+    const messagesToPersist = sanitizeMessagesForStorage(updatedMessages ?? messagesRef.current);
     setAllSessions((prev) => ({
       ...prev,
       [agentId]: {
         ...prev[agentId],
         [currentSessionId]: {
           ...prev[agentId]?.[currentSessionId],
-          messages: updatedMessages ?? messagesRef.current,
+          messages: messagesToPersist,
           updatedAt: Date.now()
         }
       }
@@ -121,7 +134,7 @@ var useSessionUtils = (agentId, allSessions, setAllSessions, currentSessionId, s
           id: sessionId,
           createdAt: Date.now(),
           updatedAt: Date.now(),
-          messages: currentMessages,
+          messages: sanitizeMessagesForStorage(currentMessages),
           name: sessionName
         }
       }