@agno-hq/chat-react 0.3.3 → 0.3.4

package/README.md

@@ -118,6 +118,52 @@ function Chat() {
 `entity.type` is `'agent' | 'team' | 'workflow'` and `entity.id` is the
 agent/team/workflow id — the same hook drives all three.
 
+### Buffered streaming
+
+Plain text is batched so the answer reveals in smooth steps instead of one
+character at a time. The first text of an answer is shown immediately; after
+that, text accumulates for 150 ms and each flush fades in as one batch. Tool
+calls, media, pauses, errors and completion are never delayed: each one flushes
+the pending text ahead of it, so the transcript always stays in order.
+
+```tsx
+<AgnoChat
+  baseUrl="http://localhost:7777"
+  streaming={{ flushIntervalMs: 150, maxBufferEvents: 100, maxBufferChars: 16_384 }}
+/>
+```
+
+The same `streaming` prop works on `useAgnoChat` and `<ChatProvider>`.
+
+| Option | Default | Effect |
+|---|---|---|
+| `enabled` | `true` | `false` delivers every event as it arrives. |
+| `flushIntervalMs` | `150` | How long text accumulates before a flush. `0` disables buffering. |
+| `maxBufferEvents` | `100` | Flush early once this many events are pending. |
+| `maxBufferChars` | `16384` | Flush early once this many characters are pending. |
+
+Settings are read when a run or continuation starts, so changing the prop
+affects the next one. A hidden tab flushes immediately, since nothing is
+painting. Invalid values fall back to the defaults. `DEFAULT_STREAMING_OPTIONS`
+and `StreamingOptions` are exported from the root and `/chat` entry points.
+
+What stays immediate:
+
+- `onEvent` receives every raw event as it arrives, unbuffered.
+- `events`, `currentEvent` and each message's event log update per batch, with
+  every original event preserved in order.
+- Cancelling keeps the text already received. Switching sessions keeps the
+  buffer with its run; deleting the session or unmounting discards it.
+- `AgnoClient` and `streamRun` are never buffered.
+
+Each batch fades in through Streamdown's own animation, with every word of a
+batch starting together. Fenced code stays plain until the run completes, then
+highlights. Reduced motion turns the fade off. Pass `animated` in `options` on
+`<Markdown>` to change or disable it.
+
+Try **Streaming / Buffered** in Storybook to compare the defaults, a longer
+buffer and per-event updates.
+
 ### What the hook returns
 
 | Value | Type | Description |

package/dist/chat/index.cjs

@@ -1,346 +1,350 @@
 'use client';
 'use strict';
 
-var chunk3IEYJIYJ_cjs = require('../chunk-3IEYJIYJ.cjs');
-require('../chunk-55HQJGLP.cjs');
+var chunkESV52ERB_cjs = require('../chunk-ESV52ERB.cjs');
+require('../chunk-Y34YRC5T.cjs');
 
 
 
 Object.defineProperty(exports, "AgnoChat", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.AgnoChat; }
+  get: function () { return chunkESV52ERB_cjs.AgnoChat; }
 });
 Object.defineProperty(exports, "AgnoMark", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.AgnoMark; }
+  get: function () { return chunkESV52ERB_cjs.AgnoMark; }
 });
 Object.defineProperty(exports, "ArrowUp", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.ArrowUp; }
+  get: function () { return chunkESV52ERB_cjs.ArrowUp; }
 });
 Object.defineProperty(exports, "BehindTheScenes", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.BehindTheScenes; }
+  get: function () { return chunkESV52ERB_cjs.BehindTheScenes; }
 });
 Object.defineProperty(exports, "BookOpen", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.BookOpen; }
+  get: function () { return chunkESV52ERB_cjs.BookOpen; }
 });
 Object.defineProperty(exports, "Box", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Box; }
+  get: function () { return chunkESV52ERB_cjs.Box; }
 });
 Object.defineProperty(exports, "Brain", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Brain; }
+  get: function () { return chunkESV52ERB_cjs.Brain; }
 });
 Object.defineProperty(exports, "ChatBubble", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.ChatBubble; }
+  get: function () { return chunkESV52ERB_cjs.ChatBubble; }
 });
 Object.defineProperty(exports, "ChatInput", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.ChatInput; }
+  get: function () { return chunkESV52ERB_cjs.ChatInput; }
 });
 Object.defineProperty(exports, "ChatLauncher", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.ChatLauncher; }
+  get: function () { return chunkESV52ERB_cjs.ChatLauncher; }
 });
 Object.defineProperty(exports, "ChatProvider", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.ChatProvider; }
+  get: function () { return chunkESV52ERB_cjs.ChatProvider; }
 });
 Object.defineProperty(exports, "ChatWindow", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.ChatWindow; }
+  get: function () { return chunkESV52ERB_cjs.ChatWindow; }
 });
 Object.defineProperty(exports, "Check", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Check; }
+  get: function () { return chunkESV52ERB_cjs.Check; }
 });
 Object.defineProperty(exports, "ChevronDown", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.ChevronDown; }
+  get: function () { return chunkESV52ERB_cjs.ChevronDown; }
 });
 Object.defineProperty(exports, "Citations", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Citations; }
+  get: function () { return chunkESV52ERB_cjs.Citations; }
 });
 Object.defineProperty(exports, "Close", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Close; }
+  get: function () { return chunkESV52ERB_cjs.Close; }
 });
 Object.defineProperty(exports, "Copy", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Copy; }
+  get: function () { return chunkESV52ERB_cjs.Copy; }
 });
 Object.defineProperty(exports, "CopyButton", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.CopyButton; }
+  get: function () { return chunkESV52ERB_cjs.CopyButton; }
+});
+Object.defineProperty(exports, "DEFAULT_STREAMING_OPTIONS", {
+  enumerable: true,
+  get: function () { return chunkESV52ERB_cjs.DEFAULT_STREAMING_OPTIONS; }
 });
 Object.defineProperty(exports, "EntityBadge", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.EntityBadge; }
+  get: function () { return chunkESV52ERB_cjs.EntityBadge; }
 });
 Object.defineProperty(exports, "EntitySelector", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.EntitySelector; }
+  get: function () { return chunkESV52ERB_cjs.EntitySelector; }
 });
 Object.defineProperty(exports, "EventLog", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.EventLog; }
+  get: function () { return chunkESV52ERB_cjs.EventLog; }
 });
 Object.defineProperty(exports, "Favicon", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Favicon; }
+  get: function () { return chunkESV52ERB_cjs.Favicon; }
 });
 Object.defineProperty(exports, "FileAudio", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.FileAudio; }
+  get: function () { return chunkESV52ERB_cjs.FileAudio; }
 });
 Object.defineProperty(exports, "FileIcon", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.FileIcon; }
+  get: function () { return chunkESV52ERB_cjs.FileIcon; }
 });
 Object.defineProperty(exports, "FilePreview", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.FilePreview; }
+  get: function () { return chunkESV52ERB_cjs.FilePreview; }
 });
 Object.defineProperty(exports, "FileType", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.FileType; }
+  get: function () { return chunkESV52ERB_cjs.FileType; }
 });
 Object.defineProperty(exports, "FileVideo", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.FileVideo; }
+  get: function () { return chunkESV52ERB_cjs.FileVideo; }
 });
 Object.defineProperty(exports, "Followups", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Followups; }
+  get: function () { return chunkESV52ERB_cjs.Followups; }
 });
 Object.defineProperty(exports, "Globe", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Globe; }
+  get: function () { return chunkESV52ERB_cjs.Globe; }
 });
 Object.defineProperty(exports, "GridLoader", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.GridLoader; }
+  get: function () { return chunkESV52ERB_cjs.GridLoader; }
 });
 Object.defineProperty(exports, "HoverPreview", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.HoverPreview; }
+  get: function () { return chunkESV52ERB_cjs.HoverPreview; }
 });
 Object.defineProperty(exports, "HumanInput", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.HumanInput; }
+  get: function () { return chunkESV52ERB_cjs.HumanInput; }
 });
 Object.defineProperty(exports, "LinkIcon", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.LinkIcon; }
+  get: function () { return chunkESV52ERB_cjs.LinkIcon; }
 });
 Object.defineProperty(exports, "LinkPreviewCard", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.LinkPreviewCard; }
+  get: function () { return chunkESV52ERB_cjs.LinkPreviewCard; }
 });
 Object.defineProperty(exports, "Markdown", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Markdown; }
+  get: function () { return chunkESV52ERB_cjs.Markdown; }
 });
 Object.defineProperty(exports, "MemberResponses", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.MemberResponses; }
+  get: function () { return chunkESV52ERB_cjs.MemberResponses; }
 });
 Object.defineProperty(exports, "Memory", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Memory; }
+  get: function () { return chunkESV52ERB_cjs.Memory; }
 });
 Object.defineProperty(exports, "Message", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Message; }
+  get: function () { return chunkESV52ERB_cjs.Message; }
 });
 Object.defineProperty(exports, "MessageActions", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.MessageActions; }
+  get: function () { return chunkESV52ERB_cjs.MessageActions; }
 });
 Object.defineProperty(exports, "MessageList", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.MessageList; }
+  get: function () { return chunkESV52ERB_cjs.MessageList; }
 });
 Object.defineProperty(exports, "Multimedia", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Multimedia; }
+  get: function () { return chunkESV52ERB_cjs.Multimedia; }
 });
 Object.defineProperty(exports, "Paperclip", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Paperclip; }
+  get: function () { return chunkESV52ERB_cjs.Paperclip; }
 });
 Object.defineProperty(exports, "Plus", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Plus; }
+  get: function () { return chunkESV52ERB_cjs.Plus; }
 });
 Object.defineProperty(exports, "Pulse", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Pulse; }
+  get: function () { return chunkESV52ERB_cjs.Pulse; }
 });
 Object.defineProperty(exports, "QuickPrompts", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.QuickPrompts; }
+  get: function () { return chunkESV52ERB_cjs.QuickPrompts; }
 });
 Object.defineProperty(exports, "Reasoning", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Reasoning; }
+  get: function () { return chunkESV52ERB_cjs.Reasoning; }
 });
 Object.defineProperty(exports, "Rerun", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Rerun; }
+  get: function () { return chunkESV52ERB_cjs.Rerun; }
 });
 Object.defineProperty(exports, "SessionList", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.SessionList; }
+  get: function () { return chunkESV52ERB_cjs.SessionList; }
 });
 Object.defineProperty(exports, "SourceCard", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.SourceCard; }
+  get: function () { return chunkESV52ERB_cjs.SourceCard; }
 });
 Object.defineProperty(exports, "SourcesProvider", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.SourcesProvider; }
+  get: function () { return chunkESV52ERB_cjs.SourcesProvider; }
 });
 Object.defineProperty(exports, "Spinner", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Spinner; }
+  get: function () { return chunkESV52ERB_cjs.Spinner; }
 });
 Object.defineProperty(exports, "StatusIndicator", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.StatusIndicator; }
+  get: function () { return chunkESV52ERB_cjs.StatusIndicator; }
 });
 Object.defineProperty(exports, "Stop", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Stop; }
+  get: function () { return chunkESV52ERB_cjs.Stop; }
 });
 Object.defineProperty(exports, "TeamGlyph", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.TeamGlyph; }
+  get: function () { return chunkESV52ERB_cjs.TeamGlyph; }
 });
 Object.defineProperty(exports, "ToolCalls", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.ToolCalls; }
+  get: function () { return chunkESV52ERB_cjs.ToolCalls; }
 });
 Object.defineProperty(exports, "Trash", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Trash; }
+  get: function () { return chunkESV52ERB_cjs.Trash; }
 });
 Object.defineProperty(exports, "WorkflowSteps", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.WorkflowSteps; }
+  get: function () { return chunkESV52ERB_cjs.WorkflowSteps; }
 });
 Object.defineProperty(exports, "Wrench", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.Wrench; }
+  get: function () { return chunkESV52ERB_cjs.Wrench; }
 });
 Object.defineProperty(exports, "admitFiles", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.admitFiles; }
+  get: function () { return chunkESV52ERB_cjs.admitFiles; }
 });
 Object.defineProperty(exports, "behindTheScenesItems", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.behindTheScenesItems; }
+  get: function () { return chunkESV52ERB_cjs.behindTheScenesItems; }
 });
 Object.defineProperty(exports, "behindTheScenesLabel", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.behindTheScenesLabel; }
+  get: function () { return chunkESV52ERB_cjs.behindTheScenesLabel; }
 });
 Object.defineProperty(exports, "collectSources", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.collectSources; }
+  get: function () { return chunkESV52ERB_cjs.collectSources; }
 });
 Object.defineProperty(exports, "displayUrl", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.displayUrl; }
+  get: function () { return chunkESV52ERB_cjs.displayUrl; }
 });
 Object.defineProperty(exports, "faviconFallbacks", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.faviconFallbacks; }
+  get: function () { return chunkESV52ERB_cjs.faviconFallbacks; }
 });
 Object.defineProperty(exports, "faviconUrl", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.faviconUrl; }
+  get: function () { return chunkESV52ERB_cjs.faviconUrl; }
 });
 Object.defineProperty(exports, "fileAccepted", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.fileAccepted; }
+  get: function () { return chunkESV52ERB_cjs.fileAccepted; }
 });
 Object.defineProperty(exports, "getProviderIcon", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.getProviderIcon; }
+  get: function () { return chunkESV52ERB_cjs.getProviderIcon; }
 });
 Object.defineProperty(exports, "hasBehindTheScenes", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.hasBehindTheScenes; }
+  get: function () { return chunkESV52ERB_cjs.hasBehindTheScenes; }
 });
 Object.defineProperty(exports, "linkCitations", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.linkCitations; }
+  get: function () { return chunkESV52ERB_cjs.linkCitations; }
 });
 Object.defineProperty(exports, "normalizeFollowups", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.normalizeFollowups; }
+  get: function () { return chunkESV52ERB_cjs.normalizeFollowups; }
 });
 Object.defineProperty(exports, "quickPromptLabel", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.quickPromptLabel; }
+  get: function () { return chunkESV52ERB_cjs.quickPromptLabel; }
 });
 Object.defineProperty(exports, "quickPromptText", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.quickPromptText; }
+  get: function () { return chunkESV52ERB_cjs.quickPromptText; }
 });
 Object.defineProperty(exports, "sourceHost", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.sourceHost; }
+  get: function () { return chunkESV52ERB_cjs.sourceHost; }
 });
 Object.defineProperty(exports, "sourcesFromMarkdown", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.sourcesFromMarkdown; }
+  get: function () { return chunkESV52ERB_cjs.sourcesFromMarkdown; }
 });
 Object.defineProperty(exports, "useAgnoChat", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.useAgnoChat; }
+  get: function () { return chunkESV52ERB_cjs.useAgnoChat; }
 });
 Object.defineProperty(exports, "useChatContext", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.useChatContext; }
+  get: function () { return chunkESV52ERB_cjs.useChatContext; }
 });
 Object.defineProperty(exports, "useLinkComponent", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.useLinkComponent; }
+  get: function () { return chunkESV52ERB_cjs.useLinkComponent; }
 });
 Object.defineProperty(exports, "useLinkPreview", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.useLinkPreview; }
+  get: function () { return chunkESV52ERB_cjs.useLinkPreview; }
 });
 Object.defineProperty(exports, "useOptionalChatContext", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.useOptionalChatContext; }
+  get: function () { return chunkESV52ERB_cjs.useOptionalChatContext; }
 });
 Object.defineProperty(exports, "useResolvedChat", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.useResolvedChat; }
+  get: function () { return chunkESV52ERB_cjs.useResolvedChat; }
 });
 Object.defineProperty(exports, "useResolvedClassNames", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.useResolvedClassNames; }
+  get: function () { return chunkESV52ERB_cjs.useResolvedClassNames; }
 });
 Object.defineProperty(exports, "useSources", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.useSources; }
+  get: function () { return chunkESV52ERB_cjs.useSources; }
 });
 Object.defineProperty(exports, "withoutSourcesLine", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.withoutSourcesLine; }
+  get: function () { return chunkESV52ERB_cjs.withoutSourcesLine; }
 });
 Object.defineProperty(exports, "writeClipboard", {
   enumerable: true,
-  get: function () { return chunk3IEYJIYJ_cjs.writeClipboard; }
+  get: function () { return chunkESV52ERB_cjs.writeClipboard; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/chat/index.d.cts

@@ -1,7 +1,19 @@
-import { C as ChatMessage, l as RunEventData, e as ChatStatus, g as EntityType, q as ToolExecution, m as RunRequirement, S as SessionEntry, A as AgnoClient, E as Entity, j as ReferenceData, f as Citations$1, R as ReasoningStep, o as SubRun, r as WorkflowStep, I as ImageData, V as VideoData, c as AudioData } from '../client-DUyVqxU9.cjs';
+import { C as ChatMessage, l as RunEventData, e as ChatStatus, g as EntityType, s as ToolExecution, m as RunRequirement, S as SessionEntry, n as RunResolution, A as AgnoClient, E as Entity, j as ReferenceData, f as Citations$1, R as ReasoningStep, q as SubRun, t as WorkflowStep, I as ImageData, V as VideoData, c as AudioData } from '../client-Dwk6ThnW.cjs';
 import React$1 from 'react';
 import { StreamdownProps } from 'streamdown';
 
+interface StreamingOptions {
+    /** Buffer plain text updates. Set false for immediate per-event updates. */
+    enabled?: boolean;
+    /** How long text accumulates before a flush, in ms. Zero disables buffering. */
+    flushIntervalMs?: number;
+    /** Flush when this many original events are pending. */
+    maxBufferEvents?: number;
+    /** Flush when this many UTF-16 characters are pending. */
+    maxBufferChars?: number;
+}
+declare const DEFAULT_STREAMING_OPTIONS: Readonly<Required<StreamingOptions>>;
+
 /**
  * useAgnoChat — a headless React hook for running any Agno agent, team or
  * workflow against an AgentOS backend and consuming its streamed output.
@@ -30,7 +42,9 @@ interface UseAgnoChatOptions {
     sessionId?: string;
     /** Pre-seed the transcript (e.g. when restoring a session). */
     initialMessages?: ChatMessage[];
-    /** Called with every raw run event, for logging/telemetry. */
+    /** Plain-text buffering settings, captured when a run or continuation starts. */
+    streaming?: StreamingOptions;
+    /** Called immediately with every raw run event, for logging/telemetry. */
     onEvent?: (event: RunEventData) => void;
     /** Called when the session id changes (e.g. first run of a new session). */
     onSessionId?: (sessionId: string) => void;
@@ -76,10 +90,7 @@ interface UseAgnoChat {
     /** Stop the active run. */
     cancel: () => Promise<void>;
     /** Continue a paused run with explicitly resolved requirements. */
-    continueRun: (resolution: {
-        tools?: ToolExecution[];
-        stepRequirements?: unknown[];
-    }) => Promise<void>;
+    continueRun: (resolution: RunResolution) => Promise<void>;
     /** Approve or reject all pending tool confirmations, then continue. */
     respondToConfirmation: (approve: boolean) => Promise<void>;
     /** Provide values for pending tool user-input fields, then continue. */
@@ -364,36 +375,6 @@ declare const SourcesProvider: React$1.Provider<Source[]>;
 /** The sources of the surrounding message; empty outside one. */
 declare function useSources(): Source[];
 
-/**
- * The copy control — one component wherever something can be copied: the
- * header of a fenced code block, the action row under an answer, a host's own
- * surface. It owns the "copied" flash and the clipboard fallbacks, so every
- * copy affordance in a transcript behaves the same way.
- */
-
-/**
- * Copy text, by whichever route the browser allows.
- *
- * The async Clipboard API is the right one, but it rejects on an insecure
- * origin and whenever the document isn't focused — so a selection-based copy
- * stands behind it. Returns whether anything was actually copied: the button
- * should not claim success it didn't have.
- *
- * Exported because a host building its own copy affordance wants the same
- * fallbacks, and because the failure paths are worth testing.
- */
-declare function writeClipboard(text: string): Promise<boolean>;
-interface CopyButtonProps {
-    /** What to copy — a string, or a function for text that is costly to build. */
-    text: string | (() => string);
-    /** Accessible name and tooltip. Defaults to "Copy". */
-    label?: string;
-    /** Icon size, in px. */
-    size?: number;
-    className?: string;
-}
-declare function CopyButton({ text, label, size, className }: CopyButtonProps): React$1.ReactElement;
-
 /**
  * Markdown for a chat transcript, rendered by [Streamdown](https://streamdown.ai).
  *
@@ -411,6 +392,8 @@ declare function CopyButton({ text, label, size, className }: CopyButtonProps):
  * this one entirely.
  */
 
+/** Everything a host may pass straight through to Streamdown. */
+type StreamdownOptions = Omit<StreamdownProps, 'children' | 'className' | 'components'>;
 interface MarkdownProps {
     content: string;
     className?: string;
@@ -435,11 +418,41 @@ interface MarkdownProps {
      */
     linkComponent?: LinkComponent;
     /** Escape hatch onto Streamdown itself — anything not set here. */
-    options?: Omit<StreamdownProps, 'children' | 'className' | 'components'>;
+    options?: StreamdownOptions;
 }
-declare function Markdown({ content, className, sources, streaming, codeCopy, linkComponent, options, }: MarkdownProps): React$1.ReactElement;
+declare function Markdown({ content, className, sources, streaming, codeCopy, linkComponent, options }: MarkdownProps): React$1.ReactElement;
 type RenderMarkdown = (content: string) => React$1.ReactNode;
 
+/**
+ * The copy control — one component wherever something can be copied: the
+ * header of a fenced code block, the action row under an answer, a host's own
+ * surface. It owns the "copied" flash and the clipboard fallbacks, so every
+ * copy affordance in a transcript behaves the same way.
+ */
+
+/**
+ * Copy text, by whichever route the browser allows.
+ *
+ * The async Clipboard API is the right one, but it rejects on an insecure
+ * origin and whenever the document isn't focused — so a selection-based copy
+ * stands behind it. Returns whether anything was actually copied: the button
+ * should not claim success it didn't have.
+ *
+ * Exported because a host building its own copy affordance wants the same
+ * fallbacks, and because the failure paths are worth testing.
+ */
+declare function writeClipboard(text: string): Promise<boolean>;
+interface CopyButtonProps {
+    /** What to copy — a string, or a function for text that is costly to build. */
+    text: string | (() => string);
+    /** Accessible name and tooltip. Defaults to "Copy". */
+    label?: string;
+    /** Icon size, in px. */
+    size?: number;
+    className?: string;
+}
+declare function CopyButton({ text, label, size, className }: CopyButtonProps): React$1.ReactElement;
+
 /**
  * `<ChatProvider>` runs a chat and shares it with everything below it, so the
  * layout is entirely yours:
@@ -623,6 +636,8 @@ interface AgnoChatProps {
     client?: AgnoClient;
     headers?: Record<string, string>;
     userId?: string;
+    /** Override the default bounded plain-text buffering. */
+    streaming?: StreamingOptions;
     /**
      * The selected agent/team/workflow. Pass it to own the selection — the embed
      * then only displays it, the way AgentOS drives the chat from its breadcrumb.
@@ -1235,10 +1250,7 @@ interface HumanInputProps {
     entityType?: EntityType;
     busy?: boolean;
     /** Continue the run with the resolved tools (agent/team) or step requirements (workflow). */
-    onResolve: (resolution: {
-        tools?: ToolExecution[];
-        stepRequirements?: unknown[];
-    }) => void;
+    onResolve: (resolution: RunResolution) => void;
     className?: string;
 }
 declare function HumanInput({ message, entityType, busy, onResolve, className, }: HumanInputProps): React$1.ReactElement | null;
@@ -1387,4 +1399,4 @@ declare function GridLoader({ className }: {
     className?: string;
 }): React$1.ReactElement;
 
-export { AgnoChat, type AgnoChatProps, AgnoMark, ArrowUp, BehindTheScenes, type BehindTheScenesProps, BookOpen, Box, Brain, ChatBubble, type ChatClassNames, type ChatContextValue, ChatInput, type ChatInputProps, ChatLauncher, type ChatLauncherProps, ChatProvider, type ChatProviderProps, type ChatTextareaProps, ChatWindow, type ChatWindowProps, Check, ChevronDown, Citations, type CitationsProps, Close, Copy, CopyButton, type CopyButtonProps, EntityBadge, type EntityBadgeProps, EntitySelector, EventLog, Favicon, FileAudio, FileIcon, type FileLimits, FilePreview, type FilePreviewProps, FileType, FileVideo, Followups, type FollowupsProps, Globe, GridLoader, HoverPreview, type HoverPreviewProps, HumanInput, type HumanInputProps, type LauncherPanel, type LauncherPosition, type LinkComponent, LinkIcon, type LinkPreview, LinkPreviewCard, type LinkPreviewCardProps, Markdown, type MarkdownProps, MemberResponses, Memory, Message, MessageActions, type MessageActionsProps, MessageList, type MessageListProps, type MessageProps, Multimedia, Paperclip, Plus, Pulse, type QuickPrompt, QuickPrompts, type QuickPromptsProps, Reasoning, type RenderMarkdown, Rerun, type ResolveLinkPreview, type SendOptions, SessionList, type SessionListProps, type Source, SourceCard, SourcesProvider, Spinner, StatusIndicator, Stop, TeamGlyph, ToolCalls, Trash, type UseAgnoChat, type UseAgnoChatOptions, WorkflowSteps, Wrench, admitFiles, behindTheScenesItems, behindTheScenesLabel, collectSources, displayUrl, faviconFallbacks, faviconUrl, fileAccepted, getProviderIcon, hasBehindTheScenes, linkCitations, normalizeFollowups, quickPromptLabel, quickPromptText, sourceHost, sourcesFromMarkdown, useAgnoChat, useChatContext, useLinkComponent, useLinkPreview, useOptionalChatContext, useResolvedChat, useResolvedClassNames, useSources, withoutSourcesLine, writeClipboard };
+export { AgnoChat, type AgnoChatProps, AgnoMark, ArrowUp, BehindTheScenes, type BehindTheScenesProps, BookOpen, Box, Brain, ChatBubble, type ChatClassNames, type ChatContextValue, ChatInput, type ChatInputProps, ChatLauncher, type ChatLauncherProps, ChatProvider, type ChatProviderProps, type ChatTextareaProps, ChatWindow, type ChatWindowProps, Check, ChevronDown, Citations, type CitationsProps, Close, Copy, CopyButton, type CopyButtonProps, DEFAULT_STREAMING_OPTIONS, EntityBadge, type EntityBadgeProps, EntitySelector, EventLog, Favicon, FileAudio, FileIcon, type FileLimits, FilePreview, type FilePreviewProps, FileType, FileVideo, Followups, type FollowupsProps, Globe, GridLoader, HoverPreview, type HoverPreviewProps, HumanInput, type HumanInputProps, type LauncherPanel, type LauncherPosition, type LinkComponent, LinkIcon, type LinkPreview, LinkPreviewCard, type LinkPreviewCardProps, Markdown, type MarkdownProps, MemberResponses, Memory, Message, MessageActions, type MessageActionsProps, MessageList, type MessageListProps, type MessageProps, Multimedia, Paperclip, Plus, Pulse, type QuickPrompt, QuickPrompts, type QuickPromptsProps, Reasoning, type RenderMarkdown, Rerun, type ResolveLinkPreview, type SendOptions, SessionList, type SessionListProps, type Source, SourceCard, SourcesProvider, Spinner, StatusIndicator, Stop, type StreamingOptions, TeamGlyph, ToolCalls, Trash, type UseAgnoChat, type UseAgnoChatOptions, WorkflowSteps, Wrench, admitFiles, behindTheScenesItems, behindTheScenesLabel, collectSources, displayUrl, faviconFallbacks, faviconUrl, fileAccepted, getProviderIcon, hasBehindTheScenes, linkCitations, normalizeFollowups, quickPromptLabel, quickPromptText, sourceHost, sourcesFromMarkdown, useAgnoChat, useChatContext, useLinkComponent, useLinkPreview, useOptionalChatContext, useResolvedChat, useResolvedClassNames, useSources, withoutSourcesLine, writeClipboard };