@agents24/chat-react 0.1.2 → 0.1.3

package/README.md

@@ -1,10 +1,10 @@
 # Agents24 Chat React
 
-Last Updated: 2026-06-08
+Last Updated: 2026-06-10
 
 Headless React primitives for Agents24 chat surfaces.
 
-The package owns thread hydration, older-page pagination, stream/reattach state, active run cancellation, normalized message blocks, and latest-thread viewport behavior. Hosts provide transport routes, cache storage, product rendering, source handling, and styling.
+The package owns thread hydration, older-page pagination, stream/reattach state, active run cancellation, normalized message parts, and latest-thread viewport behavior. Hosts provide transport routes, cache storage, product rendering, source handling, and styling.
 
 ## Public API
 
@@ -13,6 +13,10 @@ The package owns thread hydration, older-page pagination, stream/reattach state,
 - `LatestThreadViewport`
 - `createFetchChatTransport(options)`
 - `consumeSseResponse(response, onEvent)`
-- normalized chat message, block, transport, and storage types
+- normalized chat message, part, transport, and storage types
+- `partsFromResponseBlocks(blocks, fallbackText)`
+- `renderChatPart(part, message, renderOptions)`
+
+`ChatMessage.parts` is the only render model. Backend `response_blocks` are normalized into ordered parts such as `text`, `tool-get_meteo`, `ui-blocks`, `reasoning`, `approval`, `error`, and `data`. Tool UI is client-owned through `renderPart`, `toolRenderers`, and `fallbackToolRenderer`; the package does not infer English tool labels or group tool rows.
 
 Network access is always injected by the host. This browser package never requires platform API keys.

package/dist/index.cjs

@@ -21,10 +21,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DEFAULT_THREAD_PAGE_SIZE: () => DEFAULT_THREAD_PAGE_SIZE,
+  DefaultChatPart: () => DefaultChatPart,
+  DefaultToolPart: () => DefaultToolPart,
   LatestThreadViewport: () => LatestThreadViewport,
   activeRunIdFromThread: () => activeRunIdFromThread,
   activeRunIdFromThreadDetail: () => activeRunIdFromThreadDetail,
-  assistantTextFromBlocks: () => assistantTextFromBlocks,
+  assistantTextFromParts: () => assistantTextFromParts,
+  assistantTextFromResponseBlocks: () => assistantTextFromResponseBlocks,
   consumeSseResponse: () => consumeSseResponse,
   createChatId: () => createChatId,
   createFetchChatTransport: () => createFetchChatTransport,
@@ -37,14 +40,17 @@ __export(index_exports, {
   latestContextWindowFromThread: () => latestContextWindowFromThread,
   mergeReasoningSteps: () => mergeReasoningSteps,
   parseSseBlock: () => parseSseBlock,
-  reasoningStepsFromBlocks: () => reasoningStepsFromBlocks,
-  renderBlocksFromResponseBlocks: () => renderBlocksFromResponseBlocks,
+  partsFromResponseBlocks: () => partsFromResponseBlocks,
+  reasoningStepsFromParts: () => reasoningStepsFromParts,
+  renderChatPart: () => renderChatPart,
   shouldPrefetchOlder: () => shouldPrefetchOlder,
+  shouldUseTopOriginTimeline: () => shouldUseTopOriginTimeline,
   textFromFinalOutput: () => textFromFinalOutput,
   threadActivityDate: () => threadActivityDate,
   threadDetailToMessages: () => threadDetailToMessages,
   threadPaging: () => threadPaging,
   titleFromMessage: () => titleFromMessage,
+  toolStateFromStatus: () => toolStateFromStatus,
   useAgents24ChatController: () => useAgents24ChatController,
   useLatestThreadViewport: () => useLatestThreadViewport
 });
@@ -65,7 +71,8 @@ var titleFromMessage = (text, files = []) => {
   return base.replace(/\s+/g, " ").slice(0, 48);
 };
 var threadActivityDate = (thread) => String(thread.updated_at || thread.last_activity_at || thread.created_at || (/* @__PURE__ */ new Date()).toISOString());
-var assistantTextFromBlocks = (blocks) => (blocks || []).filter((block) => block.kind === "assistant_text" && typeof block.text === "string").map((block) => String(block.text)).join("\n\n").trim();
+var assistantTextFromResponseBlocks = (blocks) => (blocks || []).filter((block) => block.kind === "assistant_text" && typeof block.text === "string").map((block) => String(block.text)).join("\n\n").trim();
+var assistantTextFromParts = (parts) => (parts || []).filter((part) => part.kind === "text").map((part) => part.text).join("\n\n").trim();
 var textFromFinalOutput = (value) => {
   if (typeof value === "string") return value;
   if (!value || typeof value !== "object") return "";
@@ -110,95 +117,126 @@ var assistantTextFromEvents = (events) => {
   if (typeof assistantText === "string" && assistantText.trim()) return assistantText;
   return textFromFinalOutput(latestEventPayloadValue(events, "final_output"));
 };
-var normalizeToolStatus = (status) => {
-  if (status === "running" || status === "active" || status === "pending") return "running";
-  if (status === "failed" || status === "error") return "error";
-  return "done";
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
+var optionalString = (value) => typeof value === "string" && value.trim() ? value.trim() : void 0;
+var toolStateFromStatus = (status) => {
+  const normalized = String(status || "").trim().toLowerCase();
+  if (["failed", "error"].includes(normalized)) return "output-error";
+  if (["cancelled", "canceled"].includes(normalized)) return "cancelled";
+  if (["complete", "completed", "done", "success"].includes(normalized)) return "output-available";
+  if (["running", "active", "pending", "streaming"].includes(normalized)) return "input-available";
+  return "input-available";
 };
-var toolName = (tool) => String(tool.toolName || tool.tool_name || tool.name || tool.slug || tool.action || tool.title || "").trim().toLowerCase();
-var humanize = (value) => value.replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim().replace(/\b\w/g, (char) => char.toUpperCase());
-var toolActionKey = (tool) => {
-  const name = toolName(tool);
-  if (name.includes("search")) return "search";
-  if (name.includes("browse") || name.includes("navigate")) return "navigate";
-  if (name.includes("resolve")) return "resolve";
-  if (name.includes("open") || name.includes("read")) return "read";
-  if (name.includes("context")) return "context";
-  if (name.includes("link")) return "links";
-  return "work";
-};
-var actionLabels = {
-  search: "Searching",
-  navigate: "Navigating",
-  resolve: "Resolving",
-  read: "Reading",
-  context: "Checking context",
-  links: "Finding links",
-  work: "Working"
-};
-var toolTitle = (tool) => {
-  const explicit = tool.title || tool.label || tool.summary;
-  if (explicit) return String(explicit);
-  const name = toolName(tool);
-  return name ? humanize(name) : actionLabels[toolActionKey(tool)];
-};
-var toolDetail = (tool) => {
-  const summary = String(tool.summary || "").trim();
-  const detail = String(tool.detail || "").trim();
-  return summary || detail || void 0;
-};
-var summarizeToolGroup = (tools) => {
-  if (tools.length === 1) return tools[0].title;
-  const counts = /* @__PURE__ */ new Map();
-  tools.forEach((tool) => counts.set(tool.actionKey, (counts.get(tool.actionKey) || 0) + 1));
-  return Array.from(counts.entries()).map(([key, count]) => `${actionLabels[key]} ${count}`).join(", ");
-};
-var toolGroupStatus = (tools) => {
-  if (tools.some((tool) => tool.status === "error")) return "error";
-  if (tools.some((tool) => tool.status === "running")) return "running";
-  return "done";
+var toolNameFromRecord = (tool) => String(tool.toolName || tool.tool_name || tool.name || tool.slug || tool.action || "tool").trim() || "tool";
+var toolCallIdFromRecords = (block, tool) => optionalString(tool.toolCallId) || optionalString(tool.tool_call_id) || optionalString(block.toolCallId) || optionalString(block.tool_call_id) || optionalString(block.id) || null;
+var presentationFromTool = (tool) => {
+  const presentation = asRecord(tool.presentation);
+  const outputView = asRecord(tool.outputView) || asRecord(tool.output_view);
+  const next = presentation ? { ...presentation } : {};
+  [
+    "title",
+    "activity",
+    "detail",
+    "category",
+    "groupKey",
+    "groupLabel",
+    "showOutput",
+    "outputView"
+  ].forEach((key) => {
+    if (tool[key] !== void 0) {
+      next[key] = tool[key];
+    }
+  });
+  if (tool.group_key !== void 0) next.group_key = tool.group_key;
+  if (tool.group_label !== void 0) next.group_label = tool.group_label;
+  if (tool.show_output !== void 0) next.show_output = tool.show_output;
+  if (outputView && next.outputView === void 0) next.outputView = outputView;
+  return Object.keys(next).length > 0 ? next : null;
 };
-var createToolBlock = (block, index) => {
-  const tool = block.tool || {};
-  const actionKey = toolActionKey(tool);
+var createToolPart = (block, index) => {
+  const tool = asRecord(block.tool) || {};
+  const toolName = toolNameFromRecord(tool);
+  const errorText = optionalString(tool.errorText) || optionalString(tool.error) || optionalString(block.error) || null;
   return {
     id: String(block.id || `${block.kind || "tool"}-${index}`),
+    type: `tool-${toolName}`,
     kind: "tool",
-    title: toolTitle(tool),
-    actionLabel: actionLabels[actionKey],
-    actionKey,
-    status: normalizeToolStatus(block.status),
-    detail: toolDetail(tool)
+    toolName,
+    toolCallId: toolCallIdFromRecords(block, tool),
+    state: toolStateFromStatus(block.status),
+    input: tool.input ?? block.input,
+    output: tool.output ?? block.output,
+    errorText,
+    presentation: presentationFromTool(tool),
+    raw: block
   };
 };
-var renderBlocksFromResponseBlocks = (blocks, fallbackText) => {
-  const mapped = [];
-  let pendingTools = [];
-  const flushTools = () => {
-    if (pendingTools.length === 0) return;
-    mapped.push({
-      id: `tool-group-${pendingTools[0].id}`,
-      kind: "tool_group",
-      title: summarizeToolGroup(pendingTools),
-      status: toolGroupStatus(pendingTools),
-      tools: pendingTools
-    });
-    pendingTools = [];
-  };
+var createDataPart = (block, index, name = String(block.kind || "data")) => ({
+  id: String(block.id || `${name}-${index}`),
+  type: "data",
+  kind: "data",
+  name,
+  data: block,
+  raw: block
+});
+var partsFromResponseBlocks = (blocks, fallbackText) => {
+  const parts = [];
   (blocks || []).forEach((block, index) => {
     const id = String(block.id || `${block.kind || "block"}-${index}`);
     if (block.kind === "assistant_text" && typeof block.text === "string") {
-      flushTools();
-      mapped.push({ id, kind: "text", content: String(block.text) });
+      parts.push({ id, type: "text", kind: "text", text: String(block.text), raw: block });
+      return;
+    }
+    if (block.kind === "tool_call") {
+      parts.push(createToolPart(block, index));
+      return;
+    }
+    if (block.kind === "ui_blocks") {
+      parts.push({
+        id,
+        type: "ui-blocks",
+        kind: "ui-blocks",
+        state: toolStateFromStatus(block.status),
+        toolCallId: optionalString(block.toolCallId) || optionalString(block.tool_call_id) || null,
+        contractVersion: optionalString(block.contractVersion) || optionalString(block.contract_version) || null,
+        bundle: asRecord(block.bundle),
+        errorText: optionalString(block.error) || null,
+        raw: block
+      });
+      return;
+    }
+    if (block.kind === "reasoning_note") {
+      parts.push({
+        id,
+        type: "reasoning",
+        kind: "reasoning",
+        label: optionalString(block.label) || null,
+        text: optionalString(block.text) || optionalString(block.summary) || null,
+        status: optionalString(block.status) || null,
+        raw: block
+      });
+      return;
+    }
+    if (block.kind === "approval_request") {
+      parts.push({ id, type: "approval", kind: "approval", raw: block });
+      return;
+    }
+    if (block.kind === "error") {
+      parts.push({
+        id,
+        type: "error",
+        kind: "error",
+        errorText: optionalString(block.error) || optionalString(block.message) || "Error",
+        raw: block
+      });
       return;
     }
-    if (block.kind === "tool_call") pendingTools.push(createToolBlock(block, index));
+    parts.push(createDataPart(block, index));
   });
-  flushTools();
-  if (!mapped.some((block) => block.kind === "text") && fallbackText?.trim()) {
-    mapped.push({ id: "assistant-fallback-text", kind: "text", content: fallbackText });
+  if (!parts.some((part) => part.kind === "text") && fallbackText?.trim()) {
+    parts.push({ id: "assistant-fallback-text", type: "text", kind: "text", text: fallbackText });
   }
-  return mapped;
+  return parts;
 };
 var mergeReasoningSteps = (steps, options) => {
   if (!steps?.length) return [];
@@ -216,21 +254,20 @@ var mergeReasoningSteps = (steps, options) => {
   });
   return merged;
 };
-var reasoningStepsFromBlocks = (blocks) => (blocks || []).map((block) => {
-  const kind = String(block.kind || "");
-  if (kind === "tool_call") {
-    const tool = block.tool || {};
+var reasoningStepsFromParts = (parts) => (parts || []).map((block) => {
+  if (block.kind === "tool") {
+    const label = optionalString(block.presentation?.activity) || optionalString(block.presentation?.title) || block.toolName;
     return {
-      label: toolTitle(tool),
-      status: block.status === "running" ? "active" : "complete",
-      description: String(tool.summary || tool.detail || tool.action || "")
+      label,
+      status: block.state === "input-available" || block.state === "input-streaming" ? "active" : "complete",
+      description: optionalString(block.presentation?.detail) || ""
     };
   }
-  if (kind === "reasoning_note") {
+  if (block.kind === "reasoning") {
     return {
-      label: String(block.label || "Reasoning"),
+      label: block.label || "Reasoning",
       status: block.status === "running" ? "active" : "complete",
-      description: String(block.text || block.summary || "")
+      description: block.text || ""
     };
   }
   return null;
@@ -249,19 +286,21 @@ var turnToMessages = (turn, activeRunId) => {
       role: "user",
       content: userContent,
       createdAt,
+      parts: userContent ? [{ id: `${baseId}-user-text`, type: "text", kind: "text", text: userContent }] : [],
       attachments
     });
   }
-  const assistantText = turn.assistant_output_text || assistantTextFromBlocks(responseBlocks) || assistantTextFromEvents(turn.run_events) || textFromFinalOutput(turn.final_output);
+  const assistantText = turn.assistant_output_text || assistantTextFromResponseBlocks(responseBlocks) || assistantTextFromEvents(turn.run_events) || textFromFinalOutput(turn.final_output);
   if (assistantText || responseBlocks.length > 0 || isRunning) {
+    const parts = partsFromResponseBlocks(responseBlocks, assistantText);
     messages.push({
       id: `${baseId}-assistant`,
       role: "assistant",
       runId: turn.run_id || null,
-      content: assistantText,
+      content: assistantText || assistantTextFromParts(parts),
       createdAt: turn.completed_at ? new Date(turn.completed_at) : createdAt,
-      blocks: renderBlocksFromResponseBlocks(responseBlocks, assistantText),
-      reasoningSteps: mergeReasoningSteps(reasoningStepsFromBlocks(responseBlocks), { finalize: !isRunning }),
+      parts,
+      reasoningSteps: mergeReasoningSteps(reasoningStepsFromParts(parts), { finalize: !isRunning }),
       isFinal: !isRunning
     });
   }
@@ -475,7 +514,7 @@ function useAgents24ChatController({
             createdAt: /* @__PURE__ */ new Date(),
             reasoningSteps: input.reasoning,
             isFinal: false,
-            blocks: input.blocks
+            parts: input.parts || []
           });
           messagesRef.current = next2;
           return next2;
@@ -487,7 +526,7 @@ function useAgents24ChatController({
           content: input.content,
           reasoningSteps: input.reasoning,
           isFinal: false,
-          blocks: input.blocks ?? next[index].blocks
+          parts: input.parts ?? next[index].parts
         };
         messagesRef.current = next;
         return next;
@@ -503,7 +542,7 @@ function useAgents24ChatController({
         (message) => input.messageId && message.id === input.messageId || input.runId && message.role === "assistant" && message.runId === input.runId
       );
       const existing = existingIndex >= 0 ? input.baseMessages[existingIndex] : void 0;
-      const blocks = input.blocks || existing?.blocks || renderBlocksFromResponseBlocks(void 0, content);
+      const parts = input.parts || existing?.parts || partsFromResponseBlocks(void 0, content);
       const assistant = {
         id: existing?.id || input.messageId || createId(),
         role: "assistant",
@@ -511,13 +550,7 @@ function useAgents24ChatController({
         content,
         createdAt: /* @__PURE__ */ new Date(),
         isFinal: true,
-        blocks: blocks.map((block) => {
-          if (block.kind === "tool") return { ...block, status: input.error ? "error" : "done" };
-          if (block.kind === "tool_group") {
-            return { ...block, status: input.error ? "error" : "done", tools: block.tools.map((tool) => ({ ...tool, status: input.error ? "error" : "done" })) };
-          }
-          return block;
-        }),
+        parts,
         reasoningSteps: mergeReasoningSteps(input.reasoning, { finalize: true }),
         thinkingDurationMs: input.thinkingDurationMs
       };
@@ -552,7 +585,11 @@ function useAgents24ChatController({
       setIsLoadingOlder(false);
       isLoadingOlderRef.current = false;
       try {
-        const detail = await transport.getThread({ threadId, limit: pageSize });
+        const detail = await transport.getThread({
+          threadId,
+          limit: pageSize,
+          includeRunEvents: false
+        });
         if (activeThreadIdRef.current !== threadId || seq !== requestSeqRef.current) return;
         const nextMessages = threadDetailToMessages(detail);
         const paging = threadPaging(detail);
@@ -584,7 +621,12 @@ function useAgents24ChatController({
     isLoadingOlderRef.current = true;
     setIsLoadingOlder(true);
     try {
-      const detail = await transport.getThread({ threadId, limit: pageSize, beforeTurnIndex });
+      const detail = await transport.getThread({
+        threadId,
+        limit: pageSize,
+        beforeTurnIndex,
+        includeRunEvents: false
+      });
       if (activeThreadIdRef.current !== threadId) return;
       const older = threadDetailToMessages(detail);
       const paging = threadPaging(detail);
@@ -608,16 +650,17 @@ function useAgents24ChatController({
       if (event.run_id) activeRunIdRef.current = event.run_id;
       setContextStatus((current) => mergeContextWindow(current, payload.context_window));
       if (responseBlocks) {
-        const blockText = String(payload.assistant_output_text || "") || assistantTextFromBlocks(responseBlocks) || streamingContentRef.current;
+        const blockText = String(payload.assistant_output_text || "") || assistantTextFromResponseBlocks(responseBlocks) || streamingContentRef.current;
         if (blockText) setStreamingText(blockText);
-        const reasoning = mergeReasoningSteps([...reasoningRef.current, ...reasoningStepsFromBlocks(responseBlocks)]);
+        const parts = partsFromResponseBlocks(responseBlocks, blockText);
+        const reasoning = mergeReasoningSteps([...reasoningRef.current, ...reasoningStepsFromParts(parts)]);
         setReasoningSteps(reasoning);
         setLiveAssistantMessage({
           messageId: assistantMessageId,
           runId: event.run_id || activeRunIdRef.current,
           content: blockText,
           reasoning,
-          blocks: renderBlocksFromResponseBlocks(responseBlocks, blockText),
+          parts,
           baseMessages
         });
       }
@@ -647,7 +690,7 @@ function useAgents24ChatController({
         thinkingDurationMs: Date.now() - startedAt,
         messageId: assistantMessageId,
         runId: event.run_id || activeRunIdRef.current,
-        blocks: responseBlocks ? renderBlocksFromResponseBlocks(responseBlocks, finalText) : void 0,
+        parts: responseBlocks ? partsFromResponseBlocks(responseBlocks, finalText) : void 0,
         error: isFailed ? String(payload.message || payload.error || event.diagnostics?.[0]?.message || onStreamErrorMessage?.(event) || "The chat run failed.") : void 0
       });
     },
@@ -674,6 +717,7 @@ function useAgents24ChatController({
           role: "user",
           content: input.message.text,
           createdAt: /* @__PURE__ */ new Date(),
+          parts: input.message.text ? [{ id: createId(), type: "text", kind: "text", text: input.message.text }] : [],
           attachments: input.message.files
         };
         baseMessages = [...messagesRef.current, userMessage];
@@ -685,6 +729,7 @@ function useAgents24ChatController({
           content: "",
           createdAt: /* @__PURE__ */ new Date(),
           isFinal: false,
+          parts: [],
           reasoningSteps: []
         };
         const liveMessages = [...baseMessages, assistantMessage];
@@ -895,6 +940,7 @@ function useAgents24ChatController({
         createdAt: /* @__PURE__ */ new Date(),
         isFinal: Boolean(input.isFinal),
         isVoice: input.role === "user",
+        parts: content ? [{ id: createId(), type: "text", kind: "text", text: content }] : [],
         citations: input.citations,
         reasoningSteps: input.reasoningSteps
       };
@@ -958,6 +1004,53 @@ function useAgents24ChatController({
   ]);
 }
 
+// src/renderers.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var DefaultToolPart = ({ part }) => {
+  const label = typeof part.presentation?.activity === "string" ? part.presentation.activity : typeof part.presentation?.title === "string" ? part.presentation.title : part.toolName;
+  const detail = typeof part.presentation?.detail === "string" ? part.presentation.detail : part.errorText || part.state;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { "data-agents24-tool-part": part.type, "data-state": part.state, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: label }),
+    detail ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: detail }) : null
+  ] });
+};
+var DefaultChatPart = ({
+  part,
+  message,
+  renderOptions
+}) => {
+  if (renderOptions?.renderPart) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: renderOptions.renderPart(part, message) });
+  }
+  if (part.kind === "text") return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: part.text });
+  if (part.kind === "tool") {
+    const ToolRenderer = renderOptions?.toolRenderers?.[part.type] || renderOptions?.fallbackToolRenderer || DefaultToolPart;
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children: ToolRenderer({ part, message }) });
+  }
+  if (part.kind === "reasoning") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { "data-agents24-reasoning-part": true, children: part.text || part.label });
+  }
+  if (part.kind === "ui-blocks") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { "data-agents24-ui-blocks-part": true, "data-state": part.state });
+  }
+  if (part.kind === "approval") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { "data-agents24-approval-part": true });
+  }
+  if (part.kind === "error") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { "data-agents24-error-part": true, children: part.errorText });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { "data-agents24-data-part": part.name });
+};
+var renderChatPart = (part, message, renderOptions) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+  DefaultChatPart,
+  {
+    part,
+    message,
+    renderOptions
+  },
+  part.id
+);
+
 // src/sse.ts
 var parseSseBlock = (block) => {
   const data = block.split("\n").filter((line) => line.startsWith("data:")).map((line) => line.replace(/^data:\s?/, "")).join("\n").trim();
@@ -1082,7 +1175,7 @@ var createFetchChatTransport = ({
 
 // src/viewport.tsx
 var import_react2 = require("react");
-var import_jsx_runtime = require("react/jsx-runtime");
+var import_jsx_runtime2 = require("react/jsx-runtime");
 var LATEST_EDGE_THRESHOLD_PX = 2;
 var MIN_OLDER_PREFETCH_PX = 320;
 var MAX_OLDER_PREFETCH_PX = 900;
@@ -1093,6 +1186,11 @@ var isAtTimelineLatestEdge = (element, isTopOrigin) => {
 };
 var shouldPrefetchOlder = (element) => Math.abs(element.scrollTop) + element.clientHeight >= element.scrollHeight - Math.min(MAX_OLDER_PREFETCH_PX, Math.max(MIN_OLDER_PREFETCH_PX, element.clientHeight * 0.75));
 var getLatestScrollTop = (element, isTopOrigin) => isTopOrigin ? Math.max(0, element.scrollHeight - element.clientHeight) : 0;
+var shouldUseTopOriginTimeline = ({
+  hasOlder,
+  itemCount,
+  topOriginMaxItems = 4
+}) => !hasOlder && itemCount > 0 && itemCount <= topOriginMaxItems;
 function useLatestThreadViewport({
   itemCount,
   hasOlder,
@@ -1111,9 +1209,7 @@ function useLatestThreadViewport({
   const programmaticScrollTimeoutRef = (0, import_react2.useRef)(null);
   const activeStreamKeyRef = (0, import_react2.useRef)(null);
   const [isAtLatest, setIsAtLatest] = (0, import_react2.useState)(true);
-  const [topOriginCandidateOverflows, setTopOriginCandidateOverflows] = (0, import_react2.useState)(false);
-  const topOriginCandidate = !hasOlder && itemCount > 0 && itemCount <= topOriginMaxItems;
-  const isTopOrigin = topOriginCandidate && !topOriginCandidateOverflows;
+  const isTopOrigin = shouldUseTopOriginTimeline({ hasOlder, itemCount, topOriginMaxItems });
   const markProgrammaticScroll = (0, import_react2.useCallback)(() => {
     programmaticScrollRef.current = true;
     if (programmaticScrollTimeoutRef.current) clearTimeout(programmaticScrollTimeoutRef.current);
@@ -1140,11 +1236,6 @@ function useLatestThreadViewport({
     const element = scrollContainerRef.current;
     const preserve = olderPagePreserveRef.current;
     if (!element) return;
-    if (topOriginCandidate) {
-      setTopOriginCandidateOverflows(isScrollable(element));
-    } else if (topOriginCandidateOverflows) {
-      setTopOriginCandidateOverflows(false);
-    }
     if (!preserve) {
       setIsAtLatest(isAtTimelineLatestEdge(element, isTopOrigin));
       return;
@@ -1155,7 +1246,7 @@ function useLatestThreadViewport({
     olderPagePreserveRef.current = null;
     olderPageRequestInFlightRef.current = false;
     setIsAtLatest(isAtTimelineLatestEdge(element, isTopOrigin));
-  }, [isTopOrigin, itemCount, markProgrammaticScroll, topOriginCandidate, topOriginCandidateOverflows]);
+  }, [isTopOrigin, itemCount, markProgrammaticScroll]);
   const handleScroll = (0, import_react2.useCallback)(
     (event) => {
       const element = event.currentTarget;
@@ -1216,18 +1307,23 @@ function useLatestThreadViewport({
       return;
     }
     autoFollowLatestRef.current = true;
+    if (isTopOrigin) {
+      activeStreamKeyRef.current = key;
+      return;
+    }
     const frame = requestAnimationFrame(scrollToLatest);
     activeStreamKeyRef.current = key;
     return () => cancelAnimationFrame(frame);
-  }, [activeStreamKey, scrollToLatest]);
+  }, [activeStreamKey, isTopOrigin, scrollToLatest]);
   (0, import_react2.useLayoutEffect)(() => {
+    if (isTopOrigin) return;
     if (!activeStreamKey || !shouldAutoFollow || !autoFollowLatestRef.current) return;
     if (isLoadingOlder || olderPageRequestInFlightRef.current) return;
     const frame = requestAnimationFrame(() => {
       if (autoFollowLatestRef.current && !isLoadingOlder && !olderPageRequestInFlightRef.current) scrollToLatest();
     });
     return () => cancelAnimationFrame(frame);
-  }, [activeStreamKey, isLoadingOlder, itemCount, scrollToLatest, shouldAutoFollow]);
+  }, [activeStreamKey, isLoadingOlder, isTopOrigin, itemCount, scrollToLatest, shouldAutoFollow]);
   return {
     scrollContainerRef,
     isAtLatest,
@@ -1257,7 +1353,7 @@ function LatestThreadViewport({
     activeStreamKey
   });
   const timelineItems = (0, import_react2.useMemo)(() => viewport.isTopOrigin ? items : [...items].reverse(), [items, viewport.isTopOrigin]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
     "div",
     {
       ref: viewport.scrollContainerRef,
@@ -1276,10 +1372,13 @@ function LatestThreadViewport({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_THREAD_PAGE_SIZE,
+  DefaultChatPart,
+  DefaultToolPart,
   LatestThreadViewport,
   activeRunIdFromThread,
   activeRunIdFromThreadDetail,
-  assistantTextFromBlocks,
+  assistantTextFromParts,
+  assistantTextFromResponseBlocks,
   consumeSseResponse,
   createChatId,
   createFetchChatTransport,
@@ -1292,14 +1391,17 @@ function LatestThreadViewport({
   latestContextWindowFromThread,
   mergeReasoningSteps,
   parseSseBlock,
-  reasoningStepsFromBlocks,
-  renderBlocksFromResponseBlocks,
+  partsFromResponseBlocks,
+  reasoningStepsFromParts,
+  renderChatPart,
   shouldPrefetchOlder,
+  shouldUseTopOriginTimeline,
   textFromFinalOutput,
   threadActivityDate,
   threadDetailToMessages,
   threadPaging,
   titleFromMessage,
+  toolStateFromStatus,
   useAgents24ChatController,
   useLatestThreadViewport
 });