@librechat/agents 3.3.3 → 3.3.5

package/dist/esm/session/handlers.mjs

@@ -1,6 +1,6 @@
 import "../common/enum.mjs";
 import "../common/index.mjs";
-import { createContentAggregator } from "../stream.mjs";
+import { SDK_STREAM_DISPATCH, createContentAggregator, dispatchesChatModelStream } from "../stream.mjs";
 import { ModelEndHandler, ToolEndHandler } from "../events.mjs";
 import { toJsonValue } from "./messageSerialization.mjs";
 import { createTimestamp } from "./ids.mjs";
@@ -57,21 +57,30 @@ function createRunHandlers(params) {
 	const toolEndHandler = new ToolEndHandler();
 	const modelEndHandler = new ModelEndHandler();
 	emitEvent(createEvent("run.started"));
+	/**
+	* Forwards to the host's own handler, so it inherits that handler's
+	* capability. Branding matters because this wrapper is installed on EVERY
+	* session run and merged last: without it, a host that registered
+	* `new ChatModelStreamHandler()` would silently lose the sealing opt-out
+	* that registration is supposed to buy.
+	*/
+	const streamWrapper = { handle: async (event, data, metadata, graph) => {
+		await callUserHandler({
+			userHandlers: params.userHandlers,
+			event,
+			data,
+			metadata,
+			graph
+		});
+	} };
+	if (dispatchesChatModelStream(params.userHandlers?.["on_chat_model_stream"])) Object.defineProperty(streamWrapper, SDK_STREAM_DISPATCH, { value: true });
 	return {
 		contentParts,
 		steps,
 		usage,
 		events,
 		handlers: {
-			["on_chat_model_stream"]: { handle: async (event, data, metadata, graph) => {
-				await callUserHandler({
-					userHandlers: params.userHandlers,
-					event,
-					data,
-					metadata,
-					graph
-				});
-			} },
+			["on_chat_model_stream"]: streamWrapper,
 			["on_chat_model_end"]: { handle: async (event, data, metadata, graph) => {
 				await modelEndHandler.handle(event, data, metadata, graph);
 				updateUsage(usage, data);

package/dist/esm/session/handlers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.mjs","names":[],"sources":["../../../src/session/handlers.ts"],"sourcesContent":["import type { UsageMetadata } from '@langchain/core/messages';\nimport type {\n  AgentSessionHandlersResult,\n  AgentSessionStreamEvent,\n  AgentSessionUsage,\n} from './types';\nimport type * as t from '@/types';\nimport { ModelEndHandler, ToolEndHandler } from '@/events';\nimport { toJsonValue } from './messageSerialization';\nimport { createContentAggregator } from '@/stream';\nimport { createTimestamp } from './ids';\nimport { GraphEvents } from '@/common';\n\ntype CompletedRunStepResult =\n  | t.ToolEndEvent\n  | (t.SummaryCompleted & { id: string; index: number });\n\nfunction isToolCompletion(\n  result: CompletedRunStepResult\n): result is t.ToolEndEvent {\n  return 'tool_call' in result;\n}\n\nfunction createEventFactory(params: {\n  runId: string;\n  threadId: string;\n}): (\n  type: AgentSessionStreamEvent['type'],\n  data?: unknown\n) => AgentSessionStreamEvent {\n  let sequence = 0;\n  return (type, data) => ({\n    type,\n    sequence: sequence++,\n    runId: params.runId,\n    threadId: params.threadId,\n    timestamp: createTimestamp(),\n    ...(typeof data !== 'undefined' ? { data: toJsonValue(data) } : {}),\n  });\n}\n\nfunction getTokenCount(value: number | null | undefined): number {\n  return typeof value === 'number' && Number.isFinite(value) ? value : 0;\n}\n\nfunction updateUsage(usage: AgentSessionUsage, data: t.ModelEndData): void {\n  const metadata = data?.output?.usage_metadata as\n    | Partial<UsageMetadata>\n    | undefined;\n  if (!metadata) {\n    return;\n  }\n  const inputTokens = getTokenCount(metadata.input_tokens);\n  const outputTokens = getTokenCount(metadata.output_tokens);\n  const totalTokens =\n    metadata.total_tokens == null\n      ? inputTokens + outputTokens\n      : getTokenCount(metadata.total_tokens);\n  usage.inputTokens += inputTokens;\n  usage.outputTokens += outputTokens;\n  usage.totalTokens += totalTokens;\n}\n\nasync function callUserHandler(params: {\n  userHandlers?: Record<string, t.EventHandler>;\n  event: string;\n  data: Parameters<t.EventHandler['handle']>[1];\n  metadata?: Record<string, unknown>;\n  graph?: Parameters<t.EventHandler['handle']>[3];\n}): Promise<void> {\n  const handler = params.userHandlers?.[params.event];\n  if (!handler) {\n    return;\n  }\n  await handler.handle(\n    params.event,\n    params.data,\n    params.metadata,\n    params.graph\n  );\n}\n\nexport function createRunHandlers(params: {\n  runId: string;\n  threadId: string;\n  userHandlers?: Record<string, t.EventHandler>;\n  onEvent?: (event: AgentSessionStreamEvent) => void;\n}): AgentSessionHandlersResult {\n  const { contentParts, aggregateContent } = createContentAggregator();\n  const steps: t.RunStep[] = [];\n  const usage: AgentSessionUsage = {\n    inputTokens: 0,\n    outputTokens: 0,\n    totalTokens: 0,\n  };\n  const events: AgentSessionStreamEvent[] = [];\n  const createEvent = createEventFactory({\n    runId: params.runId,\n    threadId: params.threadId,\n  });\n  const emitEvent = (event: AgentSessionStreamEvent): void => {\n    events.push(event);\n    params.onEvent?.(event);\n  };\n  const toolEndHandler = new ToolEndHandler();\n  const modelEndHandler = new ModelEndHandler();\n\n  emitEvent(createEvent('run.started'));\n\n  const handlers: Record<string, t.EventHandler> = {\n    [GraphEvents.CHAT_MODEL_STREAM]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.CHAT_MODEL_END]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        await modelEndHandler.handle(\n          event,\n          data as t.ModelEndData,\n          metadata,\n          graph\n        );\n        updateUsage(usage, data as t.ModelEndData);\n        emitEvent(createEvent('usage.updated', usage));\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.TOOL_END]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        await toolEndHandler.handle(\n          event,\n          data as t.StreamEventData,\n          metadata,\n          graph\n        );\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_RUN_STEP]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const runStep = data as t.RunStep;\n        steps.push(runStep);\n        aggregateContent({ event: GraphEvents.ON_RUN_STEP, data: runStep });\n        if (runStep.stepDetails.type === 'tool_calls') {\n          emitEvent(createEvent('tool.started', runStep));\n        }\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_RUN_STEP_DELTA]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const delta = data as t.RunStepDeltaEvent;\n        aggregateContent({ event: GraphEvents.ON_RUN_STEP_DELTA, data: delta });\n        emitEvent(createEvent('tool.delta', delta));\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_RUN_STEP_COMPLETED]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const completed = data as unknown as { result: CompletedRunStepResult };\n        aggregateContent({\n          event: GraphEvents.ON_RUN_STEP_COMPLETED,\n          data: completed as { result: t.ToolEndEvent },\n        });\n        if (isToolCompletion(completed.result)) {\n          emitEvent(createEvent('tool.completed', completed));\n        }\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_MESSAGE_DELTA]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const delta = data as t.MessageDeltaEvent;\n        aggregateContent({ event: GraphEvents.ON_MESSAGE_DELTA, data: delta });\n        emitEvent(createEvent('message.delta', delta));\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_REASONING_DELTA]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const delta = data as t.ReasoningDeltaEvent;\n        aggregateContent({\n          event: GraphEvents.ON_REASONING_DELTA,\n          data: delta,\n        });\n        emitEvent(createEvent('reasoning.delta', delta));\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_SUMMARIZE_DELTA]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        aggregateContent({\n          event: GraphEvents.ON_SUMMARIZE_DELTA,\n          data: data as t.SummarizeDeltaData,\n        });\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_SUMMARIZE_COMPLETE]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        aggregateContent({\n          event: GraphEvents.ON_SUMMARIZE_COMPLETE,\n          data: data as t.SummarizeCompleteEvent,\n        });\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n  };\n\n  return { contentParts, steps, usage, events, handlers };\n}\n"],"mappings":"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"}
+{"version":3,"file":"handlers.mjs","names":[],"sources":["../../../src/session/handlers.ts"],"sourcesContent":["import type { UsageMetadata } from '@langchain/core/messages';\nimport type {\n  AgentSessionHandlersResult,\n  AgentSessionStreamEvent,\n  AgentSessionUsage,\n} from './types';\nimport type * as t from '@/types';\nimport { ModelEndHandler, ToolEndHandler } from '@/events';\nimport { toJsonValue } from './messageSerialization';\nimport {\n  createContentAggregator,\n  dispatchesChatModelStream,\n  SDK_STREAM_DISPATCH,\n} from '@/stream';\nimport { createTimestamp } from './ids';\nimport { GraphEvents } from '@/common';\n\ntype CompletedRunStepResult =\n  | t.ToolEndEvent\n  | (t.SummaryCompleted & { id: string; index: number });\n\nfunction isToolCompletion(\n  result: CompletedRunStepResult\n): result is t.ToolEndEvent {\n  return 'tool_call' in result;\n}\n\nfunction createEventFactory(params: {\n  runId: string;\n  threadId: string;\n}): (\n  type: AgentSessionStreamEvent['type'],\n  data?: unknown\n) => AgentSessionStreamEvent {\n  let sequence = 0;\n  return (type, data) => ({\n    type,\n    sequence: sequence++,\n    runId: params.runId,\n    threadId: params.threadId,\n    timestamp: createTimestamp(),\n    ...(typeof data !== 'undefined' ? { data: toJsonValue(data) } : {}),\n  });\n}\n\nfunction getTokenCount(value: number | null | undefined): number {\n  return typeof value === 'number' && Number.isFinite(value) ? value : 0;\n}\n\nfunction updateUsage(usage: AgentSessionUsage, data: t.ModelEndData): void {\n  const metadata = data?.output?.usage_metadata as\n    | Partial<UsageMetadata>\n    | undefined;\n  if (!metadata) {\n    return;\n  }\n  const inputTokens = getTokenCount(metadata.input_tokens);\n  const outputTokens = getTokenCount(metadata.output_tokens);\n  const totalTokens =\n    metadata.total_tokens == null\n      ? inputTokens + outputTokens\n      : getTokenCount(metadata.total_tokens);\n  usage.inputTokens += inputTokens;\n  usage.outputTokens += outputTokens;\n  usage.totalTokens += totalTokens;\n}\n\nasync function callUserHandler(params: {\n  userHandlers?: Record<string, t.EventHandler>;\n  event: string;\n  data: Parameters<t.EventHandler['handle']>[1];\n  metadata?: Record<string, unknown>;\n  graph?: Parameters<t.EventHandler['handle']>[3];\n}): Promise<void> {\n  const handler = params.userHandlers?.[params.event];\n  if (!handler) {\n    return;\n  }\n  await handler.handle(\n    params.event,\n    params.data,\n    params.metadata,\n    params.graph\n  );\n}\n\nexport function createRunHandlers(params: {\n  runId: string;\n  threadId: string;\n  userHandlers?: Record<string, t.EventHandler>;\n  onEvent?: (event: AgentSessionStreamEvent) => void;\n}): AgentSessionHandlersResult {\n  const { contentParts, aggregateContent } = createContentAggregator();\n  const steps: t.RunStep[] = [];\n  const usage: AgentSessionUsage = {\n    inputTokens: 0,\n    outputTokens: 0,\n    totalTokens: 0,\n  };\n  const events: AgentSessionStreamEvent[] = [];\n  const createEvent = createEventFactory({\n    runId: params.runId,\n    threadId: params.threadId,\n  });\n  const emitEvent = (event: AgentSessionStreamEvent): void => {\n    events.push(event);\n    params.onEvent?.(event);\n  };\n  const toolEndHandler = new ToolEndHandler();\n  const modelEndHandler = new ModelEndHandler();\n\n  emitEvent(createEvent('run.started'));\n\n  /**\n   * Forwards to the host's own handler, so it inherits that handler's\n   * capability. Branding matters because this wrapper is installed on EVERY\n   * session run and merged last: without it, a host that registered\n   * `new ChatModelStreamHandler()` would silently lose the sealing opt-out\n   * that registration is supposed to buy.\n   */\n  const streamWrapper: t.EventHandler = {\n    handle: async (event, data, metadata, graph): Promise<void> => {\n      await callUserHandler({\n        userHandlers: params.userHandlers,\n        event,\n        data,\n        metadata,\n        graph,\n      });\n    },\n  };\n  if (\n    dispatchesChatModelStream(\n      params.userHandlers?.[GraphEvents.CHAT_MODEL_STREAM]\n    )\n  ) {\n    Object.defineProperty(streamWrapper, SDK_STREAM_DISPATCH, { value: true });\n  }\n\n  const handlers: Record<string, t.EventHandler> = {\n    [GraphEvents.CHAT_MODEL_STREAM]: streamWrapper,\n    [GraphEvents.CHAT_MODEL_END]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        await modelEndHandler.handle(\n          event,\n          data as t.ModelEndData,\n          metadata,\n          graph\n        );\n        updateUsage(usage, data as t.ModelEndData);\n        emitEvent(createEvent('usage.updated', usage));\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.TOOL_END]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        await toolEndHandler.handle(\n          event,\n          data as t.StreamEventData,\n          metadata,\n          graph\n        );\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_RUN_STEP]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const runStep = data as t.RunStep;\n        steps.push(runStep);\n        aggregateContent({ event: GraphEvents.ON_RUN_STEP, data: runStep });\n        if (runStep.stepDetails.type === 'tool_calls') {\n          emitEvent(createEvent('tool.started', runStep));\n        }\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_RUN_STEP_DELTA]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const delta = data as t.RunStepDeltaEvent;\n        aggregateContent({ event: GraphEvents.ON_RUN_STEP_DELTA, data: delta });\n        emitEvent(createEvent('tool.delta', delta));\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_RUN_STEP_COMPLETED]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const completed = data as unknown as { result: CompletedRunStepResult };\n        aggregateContent({\n          event: GraphEvents.ON_RUN_STEP_COMPLETED,\n          data: completed as { result: t.ToolEndEvent },\n        });\n        if (isToolCompletion(completed.result)) {\n          emitEvent(createEvent('tool.completed', completed));\n        }\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_MESSAGE_DELTA]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const delta = data as t.MessageDeltaEvent;\n        aggregateContent({ event: GraphEvents.ON_MESSAGE_DELTA, data: delta });\n        emitEvent(createEvent('message.delta', delta));\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_REASONING_DELTA]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        const delta = data as t.ReasoningDeltaEvent;\n        aggregateContent({\n          event: GraphEvents.ON_REASONING_DELTA,\n          data: delta,\n        });\n        emitEvent(createEvent('reasoning.delta', delta));\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_SUMMARIZE_DELTA]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        aggregateContent({\n          event: GraphEvents.ON_SUMMARIZE_DELTA,\n          data: data as t.SummarizeDeltaData,\n        });\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n    [GraphEvents.ON_SUMMARIZE_COMPLETE]: {\n      handle: async (event, data, metadata, graph): Promise<void> => {\n        aggregateContent({\n          event: GraphEvents.ON_SUMMARIZE_COMPLETE,\n          data: data as t.SummarizeCompleteEvent,\n        });\n        await callUserHandler({\n          userHandlers: params.userHandlers,\n          event,\n          data,\n          metadata,\n          graph,\n        });\n      },\n    },\n  };\n\n  return { contentParts, steps, usage, events, handlers };\n}\n"],"mappings":"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"}

package/dist/esm/stream.mjs

@@ -1,7 +1,8 @@
 import { CODE_EXECUTION_TOOLS, LOCAL_CODING_BUNDLE_NAMES } from "./common/enum.mjs";
 import "./common/index.mjs";
-import { getMessageId } from "./messages/ids.mjs";
 import { calculateMaxToolResultChars, truncateToolResultContent } from "./utils/truncation.mjs";
+import { serializeStructuredValueBounded, serializeToolContentBounded } from "./utils/toolContent.mjs";
+import { getMessageId } from "./messages/ids.mjs";
 import { safeDispatchCustomEvent } from "./utils/events.mjs";
 import "./messages/index.mjs";
 import { isGoogleLike } from "./utils/llm.mjs";
@@ -354,7 +355,10 @@ async function dispatchEagerToolCompletions(args) {
 		if (graph.eagerEventToolExecutions.get(result.toolCallId) !== record) continue;
 		const stepId = record.request.stepId ?? graph.toolCallStepIds.get(result.toolCallId) ?? "";
 		if (stepId === "") continue;
-		const output = result.status === "error" ? `Error: ${result.errorMessage ?? "Unknown error"}\n Please fix your mistakes.` : truncateToolResultContent(typeof result.content === "string" ? result.content : JSON.stringify(result.content), maxToolResultChars);
+		let output;
+		if (result.status === "error") output = truncateToolResultContent(`Error: ${result.errorMessage ?? "Unknown error"}\n Please fix your mistakes.`, maxToolResultChars);
+		else if (typeof result.content === "string") output = truncateToolResultContent(result.content, maxToolResultChars);
+		else output = serializeStructuredValueBounded(result.content, maxToolResultChars).content;
 		try {
 			if (await safeDispatchCustomEvent("on_run_step_completed", { result: {
 				id: stepId,
@@ -362,7 +366,7 @@ async function dispatchEagerToolCompletions(args) {
 				type: "tool_call",
 				eager: true,
 				tool_call: {
-					args: JSON.stringify(record.request.args),
+					args: serializeToolContentBounded(record.request.args, maxToolResultChars),
 					name: record.toolName,
 					id: result.toolCallId,
 					output,
@@ -565,7 +569,25 @@ function shouldSkipLateOpenRouterReasoningChunk({ chunk, agentContext, graph, me
 		metadata
 	});
 }
+/**
+* Brands a handler as one that dispatches content parts for the SDK — either
+* `ChatModelStreamHandler` itself or a wrapper forwarding to one.
+*
+* Identity alone is not a usable contract here. Hosts compose and wrap
+* handlers (`composeEventHandlers`, `createRunHandlers`), and every wrapper
+* fails `instanceof` while still driving the same dispatch. A brand survives
+* wrapping, so "does this handler own content-part dispatch" can be answered
+* about a value the SDK did not construct.
+*/
+const SDK_STREAM_DISPATCH = Symbol.for("@librechat/agents:chatModelStreamDispatch");
+/** True when `handler` is, or forwards to, the SDK's stream dispatcher. */
+function dispatchesChatModelStream(handler) {
+	if (handler == null) return false;
+	if (handler instanceof ChatModelStreamHandler) return true;
+	return Reflect.get(handler, SDK_STREAM_DISPATCH) === true;
+}
 var ChatModelStreamHandler = class {
+	[SDK_STREAM_DISPATCH] = true;
 	async handle(event, data, metadata, graph) {
 		if (!graph) throw new Error("Graph not found");
 		if (!graph.config) throw new Error("Config not found in graph");
@@ -788,9 +810,12 @@ function createContentAggregator() {
 	/** Physical append cursor; event/chunk indices are correlation keys, not array offsets. */
 	let nextContentIndex = 0;
 	const contentMetaMap = /* @__PURE__ */ new Map();
-	const getFirstContentPart = (content) => {
-		if (content == null) return;
-		return Array.isArray(content) ? content[0] : content;
+	/** A delta's content may carry several parts (e.g. Google server-side tool
+	*  chunks emit multiple reasoning entries at once); every entry must reach
+	*  the step's slot, in order, or streamed text is silently lost. */
+	const getDeltaContentParts = (content) => {
+		if (content == null) return [];
+		return Array.isArray(content) ? content : [content];
 	};
 	const indexContentPart = (index, contentPart) => {
 		if (contentPart == null) return;
@@ -1021,8 +1046,7 @@ function createContentAggregator() {
 				console.warn("No run step or runId found for message delta event");
 				return;
 			}
-			const contentPart = getFirstContentPart(messageDelta.delta.content);
-			if (contentPart != null) updateContent(runStep.index, contentPart);
+			for (const contentPart of getDeltaContentParts(messageDelta.delta.content)) updateContent(runStep.index, contentPart);
 		} else if (event === "on_agent_update" && data?.agent_update) {
 			const contentPart = data;
 			if (!contentPart) return;
@@ -1041,8 +1065,7 @@ function createContentAggregator() {
 				console.warn("No run step or runId found for reasoning delta event");
 				return;
 			}
-			const contentPart = getFirstContentPart(reasoningDelta.delta.content);
-			if (contentPart != null) updateContent(runStep.index, contentPart);
+			for (const contentPart of getDeltaContentParts(reasoningDelta.delta.content)) updateContent(runStep.index, contentPart);
 		} else if (event === "on_run_step_delta") {
 			const runStepDelta = data;
 			const runStep = stepMap.get(runStepDelta.id);
@@ -1129,6 +1152,6 @@ function createContentAggregator() {
 	};
 }
 //#endregion
-export { ChatModelStreamHandler, createContentAggregator, getChunkContent };
+export { ChatModelStreamHandler, SDK_STREAM_DISPATCH, createContentAggregator, dispatchesChatModelStream, getChunkContent };
 
 //# sourceMappingURL=stream.mjs.map