@agents24/chat-react 0.1.9 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # Agents24 Chat React
 
-Last Updated: 2026-06-29
+Last Updated: 2026-07-13
 
 Headless React primitives for Agents24 chat surfaces.
 
@@ -18,14 +18,16 @@ The package owns thread hydration, older-page pagination, stream/reattach state,
 - `getActiveStreamingTextPartId(message, streamingMessageId)`
 - `isActiveStreamingTextPart(message, part, streamingMessageId)`
 - `createFetchChatTransport(options)`
-- `consumeSseResponse(response, onEvent)`
+- `consumeSseResponse(response, onEvent, { signal })`
+- `appendStableStreamingTurn(messages, userMessage, assistantMessage)`
+- `upsertStableAssistantMessage(messages, input)`
 - normalized chat message, part, transport, and storage types
 - `partsFromResponseBlocks(blocks, fallbackText)`
 - `renderChatPart(part, message, renderOptions)`
-- `@agents24/chat-react/ui` for shared shadcn-derived `Message`, `Bubble`, `Attachment`, `Marker`, `MessageResponse`, and Agents24 message/attachment adapters
+- `@agents24/chat-react/ui` for shared shadcn-derived `Message`, `Bubble`, `Attachment`, `Marker`, `MessageResponse`, `AgentChatMessage`, `AgentChatComposer`, `McpConnectRequiredCard`, and Agents24 message/attachment adapters
 - `@agents24/chat-react/templates` for the slot-based `AgentChatShell` starter shell
 
-`useAgents24ChatController` exposes reactive `threads`, `activeThreadId`, `activeThread`, `activeRunId`, `isRefreshingThreads`, `loadThreadById(threadId)`, and `startNewThread()` in addition to message and stream state. It hydrates selected threads, detects active runs from `active_run`/`last_run_status`, attaches through the host transport, detaches local SSE streams on navigation, and refreshes history after terminal events.
+`useAgents24ChatController` exposes reactive `threads`, `activeThreadId`, `activeThread`, `activeRunId`, `isRefreshingThreads`, `loadThreadById(threadId)`, `attachRun(runId, threadId)`, and `startNewThread()` in addition to message and stream state. It hydrates selected threads, detects active runs from `active_run`/`last_run_status`, attaches through the host transport, detaches local SSE streams on navigation, and refreshes history after terminal events.
 
 Hosts can pass `onRuntimeEvent(event, context)` and `onThreadDetailLoaded(detail)` to layer product-specific runtime UI, trace panels, analytics, or metadata over the shared chat lifecycle without forking stream handling. That surface is enough for running-history badges and read-only live thread inspectors without a separate host-owned reattach state machine.
 
@@ -35,6 +37,14 @@ Hosts can pass `onRuntimeEvent(event, context)` and `onThreadDetailLoaded(detail
 
 Network access is always injected by the host. This browser package never requires platform API keys.
 
+`streamMessage`, `attachRun`, and `subscribeThreadEvents` require owner-provided abort signals. `createFetchChatTransport` forwards each signal through connection setup and SSE consumption, and `useAgents24ChatController` aborts owned requests when it unmounts. Local abort detaches the client stream; use `cancelRun` when the durable backend run must also stop.
+
+## Message Lifecycle
+
+Chat surfaces should keep active assistant turns as stable rows in `messages`: append the user row and assistant placeholder together, stream updates into that assistant `messageId`, finalize that same row in place, then clear the streaming marker. `appendStableStreamingTurn` and `upsertStableAssistantMessage` centralize that invariant for custom hosts. Avoid host-side synthetic assistant rows because removing and re-adding the same response can flicker and can make MessageScroller treat the turn as new content.
+
+The server owns assistant projection through `response_blocks` and `assistant_output_text`. Package version `0.2.0` removes the former public `textFromFinalOutput` helper; clients must not infer chat text from workflow `final_output`.
+
 ## MessageScroller Behavior
 
 The package re-exports shadcn `@shadcn/react/message-scroller` and provides `LatestThreadScroller`, a thin native preset around the official primitives. Host chat shells should prefer:
@@ -53,4 +63,10 @@ The preset defaults to `autoScroll`, `defaultScrollPosition="last-anchor"`, `scr
 
 `@agents24/chat-react/ui` contains package-owned source adapted from the shadcn CLI `message`, `bubble`, `attachment`, and `marker` components. Base primitive names stay close to shadcn, while Agents24-specific compatibility adapters sit beside them as `Message`, `MessageContent`, `MessageActions`, `MessageAction`, `MessageAttachments`, `MessageAttachment`, and `MessageResponse`.
 
-`@agents24/chat-react/templates` exposes `AgentChatShell`, a convenience shell that composes `LatestThreadScroller`, the outline rail, latest button, composer overlay spacing, older-history trigger, and message slots. Product apps still own transport, citations, TTS, source panes, artifact actions, and row-specific rendering.
+`AgentChatMessage` and `AgentChatComposer` provide the default customer starter UI used by `AgentChatShell` consumers that want a platform-playground-like baseline without importing platform internals. Hosts can still replace assistant/user message bodies, actions, HITL side effects, and toolbar controls through composition slots.
+
+`AgentChatMessage` collapses long user messages by default to keep bubbles compact. The default user bubble shows a four-line preview with `Show more` / `Show less` controls, and hosts can tune the threshold, visible lines, or labels through the `userMessage*` props.
+
+`@agents24/chat-react/templates` exposes `AgentChatShell`, a convenience shell that composes `LatestThreadScroller`, the outline rail, latest button, composer overlay spacing, older-history trigger, scroll-state reporting, and message slots. Product apps still own transport, citations, TTS, source panes, artifact actions, and row-specific rendering.
+
+The starter shell is suitable for public/shared chat pages and customer apps. Internal playground/admin controls such as traces, debug actions, source viewers, citations, TTS, artifacts, and approval side effects remain host-owned extensions.

package/dist/{chunk-E3TJ3I6G.js → chunk-FFO6KEB4.js}

@@ -216,6 +216,7 @@ function LatestThreadScrollerOutline({
       );
     };
     updateSideRoom();
+    if (typeof ResizeObserver === "undefined") return;
     const resizeObserver = new ResizeObserver(updateSideRoom);
     resizeObserver.observe(root);
     const content = layout?.contentElement;
@@ -355,4 +356,4 @@ export {
   LatestThreadScrollerOutline,
   LatestThreadScroller
 };
-//# sourceMappingURL=chunk-E3TJ3I6G.js.map
+//# sourceMappingURL=chunk-FFO6KEB4.js.map

package/dist/chunk-FFO6KEB4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/latest-thread-scroller.tsx"],"sourcesContent":["import * as React from \"react\";\nimport {\n  MessageScroller,\n  useMessageScroller,\n  useMessageScrollerVisibility,\n} from \"@shadcn/react/message-scroller\";\n\nconst cx = (...values: Array<string | false | null | undefined>) =>\n  values.filter(Boolean).join(\" \");\n\ntype MessageScrollerProviderProps = React.ComponentProps<\n  typeof MessageScroller.Provider\n>;\ntype MessageScrollerRootProps = React.ComponentProps<typeof MessageScroller.Root>;\ntype MessageScrollerViewportProps = React.ComponentProps<\n  typeof MessageScroller.Viewport\n>;\ntype MessageScrollerContentProps = React.ComponentProps<\n  typeof MessageScroller.Content\n>;\ntype MessageScrollerItemProps = React.ComponentProps<typeof MessageScroller.Item>;\ntype MessageScrollerButtonProps = React.ComponentProps<typeof MessageScroller.Button>;\n\ntype LatestThreadScrollerLayoutContextValue = {\n  contentElement: HTMLElement | null;\n  rootElement: HTMLElement | null;\n  setContentElement: (node: HTMLElement | null) => void;\n  setRootElement: (node: HTMLElement | null) => void;\n};\n\nconst LatestThreadScrollerLayoutContext =\n  React.createContext<LatestThreadScrollerLayoutContextValue | null>(null);\n\nconst useLatestThreadScrollerLayout = () =>\n  React.useContext(LatestThreadScrollerLayoutContext);\n\nexport type LatestThreadScrollerProviderProps = MessageScrollerProviderProps;\n\nexport function LatestThreadScrollerProvider({\n  autoScroll = true,\n  defaultScrollPosition = \"last-anchor\",\n  scrollPreviousItemPeek = 64,\n  ...props\n}: LatestThreadScrollerProviderProps) {\n  return (\n    <MessageScroller.Provider\n      autoScroll={autoScroll}\n      defaultScrollPosition={defaultScrollPosition}\n      scrollPreviousItemPeek={scrollPreviousItemPeek}\n      {...props}\n    />\n  );\n}\n\nexport type LatestThreadScrollerRootProps = MessageScrollerRootProps;\n\nexport function LatestThreadScrollerRoot({\n  className,\n  ref,\n  ...props\n}: LatestThreadScrollerRootProps) {\n  const [rootElement, setRootElement] = React.useState<HTMLElement | null>(null);\n  const [contentElement, setContentElement] =\n    React.useState<HTMLElement | null>(null);\n  const layoutContext = React.useMemo<LatestThreadScrollerLayoutContextValue>(\n    () => ({\n      contentElement,\n      rootElement,\n      setContentElement,\n      setRootElement,\n    }),\n    [contentElement, rootElement]\n  );\n  const setRef = React.useCallback(\n    (node: HTMLDivElement | null) => {\n      setRootElement(node);\n      if (typeof ref === \"function\") {\n        ref(node);\n      } else if (ref) {\n        ref.current = node;\n      }\n    },\n    [ref]\n  );\n\n  return (\n    <LatestThreadScrollerLayoutContext.Provider value={layoutContext}>\n      <MessageScroller.Root\n        ref={setRef}\n        className={cx(\n          \"relative flex size-full min-h-0 flex-1 flex-col overflow-hidden\",\n          className\n        )}\n        {...props}\n      />\n    </LatestThreadScrollerLayoutContext.Provider>\n  );\n}\n\nexport type LatestThreadScrollerViewportProps =\n  MessageScrollerViewportProps & {\n    onViewportChange?: (node: HTMLElement | null) => void;\n  };\n\nexport function LatestThreadScrollerViewport({\n  className,\n  onViewportChange,\n  preserveScrollOnPrepend = true,\n  ref,\n  ...props\n}: LatestThreadScrollerViewportProps) {\n  const setRef = React.useCallback(\n    (node: HTMLDivElement | null) => {\n      if (typeof ref === \"function\") {\n        ref(node);\n      } else if (ref) {\n        ref.current = node;\n      }\n      onViewportChange?.(node);\n    },\n    [onViewportChange, ref]\n  );\n\n  return (\n    <MessageScroller.Viewport\n      ref={setRef}\n      className={cx(\n        \"size-full min-h-0 min-w-0 flex-1 overflow-y-auto overscroll-contain\",\n        className\n      )}\n      preserveScrollOnPrepend={preserveScrollOnPrepend}\n      {...props}\n    />\n  );\n}\n\nexport type LatestThreadScrollerContentProps = MessageScrollerContentProps;\n\nexport function LatestThreadScrollerContent({\n  className,\n  ref,\n  ...props\n}: LatestThreadScrollerContentProps) {\n  const layout = useLatestThreadScrollerLayout();\n  const setRef = React.useCallback(\n    (node: HTMLDivElement | null) => {\n      layout?.setContentElement(node);\n      if (typeof ref === \"function\") {\n        ref(node);\n      } else if (ref) {\n        ref.current = node;\n      }\n    },\n    [layout, ref]\n  );\n\n  return (\n    <MessageScroller.Content\n      ref={setRef}\n      data-agents24-latest-thread-content=\"\"\n      className={cx(\"flex h-max min-h-full flex-col gap-8 p-4\", className)}\n      {...props}\n    />\n  );\n}\n\nexport type LatestThreadScrollerItemProps = Omit<\n  MessageScrollerItemProps,\n  \"messageId\"\n> & {\n  messageId: string;\n};\n\nexport function LatestThreadScrollerItem({\n  className,\n  messageId,\n  ...props\n}: LatestThreadScrollerItemProps) {\n  return (\n    <MessageScroller.Item\n      className={cx(\n        \"min-w-0 shrink-0 overflow-visible\",\n        className\n      )}\n      messageId={messageId}\n      {...props}\n    />\n  );\n}\n\nexport type LatestThreadScrollerButtonProps = Omit<\n  MessageScrollerButtonProps,\n  \"render\"\n> & {\n  className?: string;\n  render?: MessageScrollerButtonProps[\"render\"];\n};\n\nexport function LatestThreadScrollerButton({\n  children,\n  className,\n  direction = \"end\",\n  render,\n  ...props\n}: LatestThreadScrollerButtonProps) {\n  if (render) {\n    return (\n      <MessageScroller.Button\n        direction={direction}\n        render={render}\n        {...props}\n      />\n    );\n  }\n\n  return (\n    <MessageScroller.Button\n      direction={direction}\n      render={(buttonProps) => (\n        <button\n          {...(buttonProps as Record<string, unknown>)}\n          aria-label={\n            direction === \"end\"\n              ? \"Scroll to latest message\"\n              : \"Scroll to first message\"\n          }\n          className={cx(\n            \"absolute bottom-4 left-1/2 z-50 flex size-9 -translate-x-1/2 items-center justify-center rounded-full border border-border bg-background text-foreground shadow-md transition-all duration-200 data-[active=false]:pointer-events-none data-[active=false]:translate-y-2 data-[active=false]:opacity-0 data-[active=true]:translate-y-0 data-[active=true]:opacity-100\",\n            className\n          )}\n          type=\"button\"\n        >\n          {children ?? (direction === \"end\" ? \"↓\" : \"↑\")}\n        </button>\n      )}\n      {...props}\n    />\n  );\n}\n\nexport type LatestThreadScrollerOutlineItem = {\n  id: string;\n  label: string;\n  messageIds?: string[];\n  responsePreview?: string;\n};\n\nexport type LatestThreadScrollerOutlineProps = {\n  cardClassName?: string;\n  className?: string;\n  contentMaxWidth?: number;\n  dir?: \"ltr\" | \"rtl\";\n  items: LatestThreadScrollerOutlineItem[];\n  minContainerWidthForRail?: number;\n  minSideGutterForRail?: number;\n  side?: \"left\" | \"right\";\n};\n\nexport function LatestThreadScrollerOutline({\n  cardClassName,\n  className,\n  contentMaxWidth = 768,\n  dir = \"ltr\",\n  items,\n  minContainerWidthForRail = 0,\n  minSideGutterForRail = 48,\n  side,\n}: LatestThreadScrollerOutlineProps) {\n  const navRef = React.useRef<HTMLElement | null>(null);\n  const layout = useLatestThreadScrollerLayout();\n  const [hasSideRoom, setHasSideRoom] = React.useState(false);\n  const [hoveredIndex, setHoveredIndex] = React.useState<number | null>(null);\n  const { scrollToMessage } = useMessageScroller();\n  const { currentAnchorId, visibleMessageIds } = useMessageScrollerVisibility();\n  const visibleMessageIdSet = React.useMemo(\n    () => new Set(visibleMessageIds),\n    [visibleMessageIds]\n  );\n  const focusIndex = hoveredIndex ?? -1;\n  const railSide = side ?? (dir === \"rtl\" ? \"right\" : \"left\");\n\n  React.useEffect(() => {\n    const root = layout?.rootElement ?? navRef.current?.parentElement;\n    if (!root) return;\n\n    const updateSideRoom = () => {\n      const rootRect = root.getBoundingClientRect();\n      const rootWidth = rootRect.width;\n      const content = layout?.contentElement;\n      const sideGutter = content\n        ? Math.max(\n            0,\n            railSide === \"left\"\n              ? content.getBoundingClientRect().left - rootRect.left\n              : rootRect.right - content.getBoundingClientRect().right\n          )\n        : Math.max(0, (rootWidth - contentMaxWidth) / 2);\n      const nextHasSideRoom =\n        rootWidth >= minContainerWidthForRail &&\n        sideGutter >= minSideGutterForRail;\n      setHasSideRoom((current) =>\n        current === nextHasSideRoom ? current : nextHasSideRoom\n      );\n    };\n\n    updateSideRoom();\n    if (typeof ResizeObserver === \"undefined\") return;\n    const resizeObserver = new ResizeObserver(updateSideRoom);\n    resizeObserver.observe(root);\n    const content = layout?.contentElement;\n    if (content) {\n      resizeObserver.observe(content);\n    }\n    return () => resizeObserver.disconnect();\n  }, [\n    contentMaxWidth,\n    layout?.contentElement,\n    layout?.rootElement,\n    minContainerWidthForRail,\n    minSideGutterForRail,\n    railSide,\n  ]);\n\n  if (items.length < 2) {\n    return null;\n  }\n\n  return (\n    <nav\n      ref={navRef}\n      aria-label=\"Transcript outline\"\n      className={cx(\n        \"pointer-events-none absolute top-[46%] z-10 max-h-[min(18rem,calc(100%-10rem))] w-16 -translate-y-1/2 overflow-visible\",\n        hasSideRoom ? \"hidden md:block\" : \"hidden\",\n        railSide === \"left\" ? \"left-1\" : \"right-1\",\n        className\n      )}\n      dir={dir}\n    >\n      <div className=\"pointer-events-auto flex flex-col gap-0 py-1\">\n        {items.map((item, index) => {\n          const itemMessageIds =\n            item.messageIds && item.messageIds.length > 0\n              ? item.messageIds\n              : [item.id];\n          const active = itemMessageIds.some(\n            (messageId) =>\n              visibleMessageIdSet.has(messageId) || messageId === currentAnchorId\n          );\n          const distance =\n            focusIndex >= 0 ? Math.abs(index - focusIndex) : Number.POSITIVE_INFINITY;\n          const isFocused = distance === 0;\n          const isNear = distance === 1;\n          const isNextNear = distance === 2;\n          const barWidth = isFocused\n            ? 50\n            : isNear\n              ? 36\n              : isNextNear\n                ? 23\n                : 10;\n          const barOpacity = isFocused ? 1 : isNear ? 0.78 : isNextNear ? 0.58 : 0.36;\n          const fallbackLabel = `Turn ${index + 1}`;\n          const previewLabel =\n            item.label && item.label !== fallbackLabel ? item.label : \"\";\n          const responsePreview = (item.responsePreview || \"\").trim();\n\n          return (\n            <button\n              key={item.id}\n              type=\"button\"\n              data-active={active}\n              dir=\"ltr\"\n              className={cx(\n                \"group relative flex h-2 w-16 items-center rounded-sm outline-none\",\n                railSide === \"left\" ? \"justify-start\" : \"justify-end\"\n              )}\n              aria-label={`Jump to ${item.label || fallbackLabel}`}\n              onBlur={() => setHoveredIndex(null)}\n              onFocus={() => setHoveredIndex(index)}\n              onMouseEnter={() => setHoveredIndex(index)}\n              onMouseLeave={() => setHoveredIndex(null)}\n              onClick={() =>\n                scrollToMessage(item.id, {\n                  align: \"start\",\n                  behavior: \"smooth\",\n                })\n              }\n            >\n              <span\n                className=\"h-0.5 rounded-full bg-muted-foreground/55 transition-[width,background-color,opacity] duration-150 ease-out group-hover:bg-foreground group-focus-visible:bg-foreground group-data-[active=true]:bg-foreground\"\n                style={{\n                  opacity: barOpacity,\n                  width: barWidth,\n                }}\n              />\n              {previewLabel ? (\n                <span\n                  dir={dir}\n                  className={cx(\n                    \"pointer-events-none absolute top-1/2 z-20 max-h-32 w-64 -translate-y-1/2 overflow-hidden rounded-lg border border-border/80 bg-background p-3 text-start opacity-0 shadow-lg transition-all duration-200 group-hover:pointer-events-auto group-hover:opacity-100 group-focus-visible:pointer-events-auto group-focus-visible:opacity-100\",\n                    railSide === \"left\"\n                      ? \"left-full ml-2 -translate-x-1 group-hover:translate-x-0 group-focus-visible:translate-x-0\"\n                      : \"right-full mr-2 translate-x-1 group-hover:translate-x-0 group-focus-visible:translate-x-0\",\n                    cardClassName\n                  )}\n                >\n                  <span\n                    className=\"block overflow-hidden text-sm leading-5 text-foreground\"\n                    style={{\n                      display: \"-webkit-box\",\n                      WebkitBoxOrient: \"vertical\",\n                      WebkitLineClamp: responsePreview ? 2 : 4,\n                    }}\n                  >\n                    {previewLabel}\n                  </span>\n                  {responsePreview ? (\n                    <span\n                      className=\"mt-1 block overflow-hidden text-sm leading-5 text-muted-foreground\"\n                      style={{\n                        display: \"-webkit-box\",\n                        WebkitBoxOrient: \"vertical\",\n                        WebkitLineClamp: 2,\n                      }}\n                    >\n                      {responsePreview}\n                    </span>\n                  ) : null}\n                </span>\n              ) : null}\n            </button>\n          );\n        })}\n      </div>\n    </nav>\n  );\n}\n\nexport const LatestThreadScroller = {\n  Provider: LatestThreadScrollerProvider,\n  Root: LatestThreadScrollerRoot,\n  Viewport: LatestThreadScrollerViewport,\n  Content: LatestThreadScrollerContent,\n  Item: LatestThreadScrollerItem,\n  Button: LatestThreadScrollerButton,\n  Outline: LatestThreadScrollerOutline,\n};\n"],"mappings":";AAAA,YAAY,WAAW;AACvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAwCH,cAgWY,YAhWZ;AAtCJ,IAAM,KAAK,IAAI,WACb,OAAO,OAAO,OAAO,EAAE,KAAK,GAAG;AAsBjC,IAAM,oCACE,oBAA6D,IAAI;AAEzE,IAAM,gCAAgC,MAC9B,iBAAW,iCAAiC;AAI7C,SAAS,6BAA6B;AAAA,EAC3C,aAAa;AAAA,EACb,wBAAwB;AAAA,EACxB,yBAAyB;AAAA,EACzB,GAAG;AACL,GAAsC;AACpC,SACE;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AAIO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAkC;AAChC,QAAM,CAAC,aAAa,cAAc,IAAU,eAA6B,IAAI;AAC7E,QAAM,CAAC,gBAAgB,iBAAiB,IAChC,eAA6B,IAAI;AACzC,QAAM,gBAAsB;AAAA,IAC1B,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,CAAC,gBAAgB,WAAW;AAAA,EAC9B;AACA,QAAM,SAAe;AAAA,IACnB,CAAC,SAAgC;AAC/B,qBAAe,IAAI;AACnB,UAAI,OAAO,QAAQ,YAAY;AAC7B,YAAI,IAAI;AAAA,MACV,WAAW,KAAK;AACd,YAAI,UAAU;AAAA,MAChB;AAAA,IACF;AAAA,IACA,CAAC,GAAG;AAAA,EACN;AAEA,SACE,oBAAC,kCAAkC,UAAlC,EAA2C,OAAO,eACjD;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC,KAAK;AAAA,MACL,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA;AAAA,EACN,GACF;AAEJ;AAOO,SAAS,6BAA6B;AAAA,EAC3C;AAAA,EACA;AAAA,EACA,0BAA0B;AAAA,EAC1B;AAAA,EACA,GAAG;AACL,GAAsC;AACpC,QAAM,SAAe;AAAA,IACnB,CAAC,SAAgC;AAC/B,UAAI,OAAO,QAAQ,YAAY;AAC7B,YAAI,IAAI;AAAA,MACV,WAAW,KAAK;AACd,YAAI,UAAU;AAAA,MAChB;AACA,yBAAmB,IAAI;AAAA,IACzB;AAAA,IACA,CAAC,kBAAkB,GAAG;AAAA,EACxB;AAEA,SACE;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC,KAAK;AAAA,MACL,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACA;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AAIO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAqC;AACnC,QAAM,SAAS,8BAA8B;AAC7C,QAAM,SAAe;AAAA,IACnB,CAAC,SAAgC;AAC/B,cAAQ,kBAAkB,IAAI;AAC9B,UAAI,OAAO,QAAQ,YAAY;AAC7B,YAAI,IAAI;AAAA,MACV,WAAW,KAAK;AACd,YAAI,UAAU;AAAA,MAChB;AAAA,IACF;AAAA,IACA,CAAC,QAAQ,GAAG;AAAA,EACd;AAEA,SACE;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC,KAAK;AAAA,MACL,uCAAoC;AAAA,MACpC,WAAW,GAAG,4CAA4C,SAAS;AAAA,MAClE,GAAG;AAAA;AAAA,EACN;AAEJ;AASO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAkC;AAChC,SACE;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MACA;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AAUO,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA,GAAG;AACL,GAAoC;AAClC,MAAI,QAAQ;AACV,WACE;AAAA,MAAC,gBAAgB;AAAA,MAAhB;AAAA,QACC;AAAA,QACA;AAAA,QACC,GAAG;AAAA;AAAA,IACN;AAAA,EAEJ;AAEA,SACE;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC;AAAA,MACA,QAAQ,CAAC,gBACP;AAAA,QAAC;AAAA;AAAA,UACE,GAAI;AAAA,UACL,cACE,cAAc,QACV,6BACA;AAAA,UAEN,WAAW;AAAA,YACT;AAAA,YACA;AAAA,UACF;AAAA,UACA,MAAK;AAAA,UAEJ,uBAAa,cAAc,QAAQ,WAAM;AAAA;AAAA,MAC5C;AAAA,MAED,GAAG;AAAA;AAAA,EACN;AAEJ;AAoBO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA,kBAAkB;AAAA,EAClB,MAAM;AAAA,EACN;AAAA,EACA,2BAA2B;AAAA,EAC3B,uBAAuB;AAAA,EACvB;AACF,GAAqC;AACnC,QAAM,SAAe,aAA2B,IAAI;AACpD,QAAM,SAAS,8BAA8B;AAC7C,QAAM,CAAC,aAAa,cAAc,IAAU,eAAS,KAAK;AAC1D,QAAM,CAAC,cAAc,eAAe,IAAU,eAAwB,IAAI;AAC1E,QAAM,EAAE,gBAAgB,IAAI,mBAAmB;AAC/C,QAAM,EAAE,iBAAiB,kBAAkB,IAAI,6BAA6B;AAC5E,QAAM,sBAA4B;AAAA,IAChC,MAAM,IAAI,IAAI,iBAAiB;AAAA,IAC/B,CAAC,iBAAiB;AAAA,EACpB;AACA,QAAM,aAAa,gBAAgB;AACnC,QAAM,WAAW,SAAS,QAAQ,QAAQ,UAAU;AAEpD,EAAM,gBAAU,MAAM;AACpB,UAAM,OAAO,QAAQ,eAAe,OAAO,SAAS;AACpD,QAAI,CAAC,KAAM;AAEX,UAAM,iBAAiB,MAAM;AAC3B,YAAM,WAAW,KAAK,sBAAsB;AAC5C,YAAM,YAAY,SAAS;AAC3B,YAAMA,WAAU,QAAQ;AACxB,YAAM,aAAaA,WACf,KAAK;AAAA,QACH;AAAA,QACA,aAAa,SACTA,SAAQ,sBAAsB,EAAE,OAAO,SAAS,OAChD,SAAS,QAAQA,SAAQ,sBAAsB,EAAE;AAAA,MACvD,IACA,KAAK,IAAI,IAAI,YAAY,mBAAmB,CAAC;AACjD,YAAM,kBACJ,aAAa,4BACb,cAAc;AAChB;AAAA,QAAe,CAAC,YACd,YAAY,kBAAkB,UAAU;AAAA,MAC1C;AAAA,IACF;AAEA,mBAAe;AACf,QAAI,OAAO,mBAAmB,YAAa;AAC3C,UAAM,iBAAiB,IAAI,eAAe,cAAc;AACxD,mBAAe,QAAQ,IAAI;AAC3B,UAAM,UAAU,QAAQ;AACxB,QAAI,SAAS;AACX,qBAAe,QAAQ,OAAO;AAAA,IAChC;AACA,WAAO,MAAM,eAAe,WAAW;AAAA,EACzC,GAAG;AAAA,IACD;AAAA,IACA,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,MAAI,MAAM,SAAS,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK;AAAA,MACL,cAAW;AAAA,MACX,WAAW;AAAA,QACT;AAAA,QACA,cAAc,oBAAoB;AAAA,QAClC,aAAa,SAAS,WAAW;AAAA,QACjC;AAAA,MACF;AAAA,MACA;AAAA,MAEA,8BAAC,SAAI,WAAU,gDACZ,gBAAM,IAAI,CAAC,MAAM,UAAU;AAC1B,cAAM,iBACJ,KAAK,cAAc,KAAK,WAAW,SAAS,IACxC,KAAK,aACL,CAAC,KAAK,EAAE;AACd,cAAM,SAAS,eAAe;AAAA,UAC5B,CAAC,cACC,oBAAoB,IAAI,SAAS,KAAK,cAAc;AAAA,QACxD;AACA,cAAM,WACJ,cAAc,IAAI,KAAK,IAAI,QAAQ,UAAU,IAAI,OAAO;AAC1D,cAAM,YAAY,aAAa;AAC/B,cAAM,SAAS,aAAa;AAC5B,cAAM,aAAa,aAAa;AAChC,cAAM,WAAW,YACb,KACA,SACE,KACA,aACE,KACA;AACR,cAAM,aAAa,YAAY,IAAI,SAAS,OAAO,aAAa,OAAO;AACvE,cAAM,gBAAgB,QAAQ,QAAQ,CAAC;AACvC,cAAM,eACJ,KAAK,SAAS,KAAK,UAAU,gBAAgB,KAAK,QAAQ;AAC5D,cAAM,mBAAmB,KAAK,mBAAmB,IAAI,KAAK;AAE1D,eACE;AAAA,UAAC;AAAA;AAAA,YAEC,MAAK;AAAA,YACL,eAAa;AAAA,YACb,KAAI;AAAA,YACJ,WAAW;AAAA,cACT;AAAA,cACA,aAAa,SAAS,kBAAkB;AAAA,YAC1C;AAAA,YACA,cAAY,WAAW,KAAK,SAAS,aAAa;AAAA,YAClD,QAAQ,MAAM,gBAAgB,IAAI;AAAA,YAClC,SAAS,MAAM,gBAAgB,KAAK;AAAA,YACpC,cAAc,MAAM,gBAAgB,KAAK;AAAA,YACzC,cAAc,MAAM,gBAAgB,IAAI;AAAA,YACxC,SAAS,MACP,gBAAgB,KAAK,IAAI;AAAA,cACvB,OAAO;AAAA,cACP,UAAU;AAAA,YACZ,CAAC;AAAA,YAGH;AAAA;AAAA,gBAAC;AAAA;AAAA,kBACC,WAAU;AAAA,kBACV,OAAO;AAAA,oBACL,SAAS;AAAA,oBACT,OAAO;AAAA,kBACT;AAAA;AAAA,cACF;AAAA,cACC,eACC;AAAA,gBAAC;AAAA;AAAA,kBACC;AAAA,kBACA,WAAW;AAAA,oBACT;AAAA,oBACA,aAAa,SACT,8FACA;AAAA,oBACJ;AAAA,kBACF;AAAA,kBAEA;AAAA;AAAA,sBAAC;AAAA;AAAA,wBACC,WAAU;AAAA,wBACV,OAAO;AAAA,0BACL,SAAS;AAAA,0BACT,iBAAiB;AAAA,0BACjB,iBAAiB,kBAAkB,IAAI;AAAA,wBACzC;AAAA,wBAEC;AAAA;AAAA,oBACH;AAAA,oBACC,kBACC;AAAA,sBAAC;AAAA;AAAA,wBACC,WAAU;AAAA,wBACV,OAAO;AAAA,0BACL,SAAS;AAAA,0BACT,iBAAiB;AAAA,0BACjB,iBAAiB;AAAA,wBACnB;AAAA,wBAEC;AAAA;AAAA,oBACH,IACE;AAAA;AAAA;AAAA,cACN,IACE;AAAA;AAAA;AAAA,UA7DC,KAAK;AAAA,QA8DZ;AAAA,MAEJ,CAAC,GACH;AAAA;AAAA,EACF;AAEJ;AAEO,IAAM,uBAAuB;AAAA,EAClC,UAAU;AAAA,EACV,MAAM;AAAA,EACN,UAAU;AAAA,EACV,SAAS;AAAA,EACT,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,SAAS;AACX;","names":["content"]}

package/dist/controller-actions.d.ts

@@ -0,0 +1,45 @@
+import { type Dispatch, type MutableRefObject, type SetStateAction } from "react";
+import type { ChatCitation, ChatMessage, ChatReasoningStep, ChatStorageAdapter, ChatSubmitMessage } from "./types";
+type PagingRef = MutableRefObject<number | null>;
+export declare function useControllerMessageActions(input: {
+    activeThreadIdRef: MutableRefObject<string | null>;
+    createId: () => string;
+    detachActiveStream: () => void;
+    disliked: Record<string, boolean>;
+    handleSubmit: (message: ChatSubmitMessage) => Promise<void>;
+    hasOlderTurnsRef: MutableRefObject<boolean>;
+    liked: Record<string, boolean>;
+    liveVoiceIdsRef: MutableRefObject<{
+        user?: string;
+        assistant?: string;
+    }>;
+    loadedThreadIdRef: MutableRefObject<string | null>;
+    messagesRef: MutableRefObject<ChatMessage[]>;
+    nextBeforeTurnIndexRef: PagingRef;
+    onActiveThreadIdChange?: (threadId: string | null) => void;
+    persistThread: (threadId: string, nextMessages: ChatMessage[]) => void;
+    requestSeqRef: MutableRefObject<number>;
+    setContextStatus: Dispatch<SetStateAction<any>>;
+    setCopiedMessageId: Dispatch<SetStateAction<string | null>>;
+    setDisliked: Dispatch<SetStateAction<Record<string, boolean>>>;
+    setHasOlderTurns: Dispatch<SetStateAction<boolean>>;
+    setIsLoadingOlder: Dispatch<SetStateAction<boolean>>;
+    setLiked: Dispatch<SetStateAction<Record<string, boolean>>>;
+    setLoadingHistory: (value: boolean) => void;
+    setMessages: Dispatch<SetStateAction<ChatMessage[]>>;
+    storage: ChatStorageAdapter;
+}): {
+    handleCopy: (content: string, messageId: string) => void;
+    handleDislike: (msg: ChatMessage) => Promise<void>;
+    handleLike: (msg: ChatMessage) => Promise<void>;
+    handleRetry: (msg: ChatMessage) => Promise<void>;
+    startNewThread: () => void;
+    upsertLiveVoiceMessage: (payload: {
+        role: "user" | "assistant";
+        content: string;
+        isFinal?: boolean;
+        citations?: ChatCitation[];
+        reasoningSteps?: ChatReasoningStep[];
+    }) => void;
+};
+export {};

package/dist/controller-helpers.d.ts

@@ -0,0 +1,27 @@
+import type { ChatMessage, ChatReasoningStep, ChatPart, ChatThreadSummaryEvent, StoredChatThread } from "./types";
+export type ChatRuntimeEventContext = {
+    mode: "submit" | "attach";
+    assistantMessageId: string;
+    threadId: string | null;
+    runId: string | null;
+    startedAt: number;
+};
+export type FinalizeInput = {
+    threadId: string | null;
+    baseMessages: ChatMessage[];
+    assistantText: string;
+    reasoning: ChatReasoningStep[];
+    thinkingDurationMs: number;
+    messageId?: string | null;
+    runId?: string | null;
+    parts?: ChatPart[];
+    error?: string;
+};
+export declare const threadSummaryToStored: (thread: Record<string, unknown>) => StoredChatThread;
+export declare const isThreadNotFoundError: (error: unknown) => boolean;
+export declare const isAbortError: (error: unknown) => boolean;
+export declare const abortDetachedStream: (controller: AbortController | null) => void;
+export declare const mergeStoredThreadsForRefresh: (currentThreads: StoredChatThread[], serverThreads: StoredChatThread[]) => StoredChatThread[];
+export declare const hasRunningStoredThreads: (threads: StoredChatThread[]) => boolean;
+export declare const sameStoredThread: (left: StoredChatThread | undefined, right: StoredChatThread | undefined) => boolean;
+export declare const applyThreadSummaryEvent: (currentThreads: StoredChatThread[], event: ChatThreadSummaryEvent) => StoredChatThread[];

package/dist/controller.d.ts

@@ -1,11 +1,6 @@
+import { type ChatRuntimeEventContext } from "./controller-helpers";
 import type { ChatController, ChatMessage, ChatRuntimeEvent, ChatStorageAdapter, ChatTransport } from "./types";
-export type ChatRuntimeEventContext = {
-    mode: "submit" | "attach";
-    assistantMessageId: string;
-    threadId: string | null;
-    runId: string | null;
-    startedAt: number;
-};
+export { mergeStoredThreadsForRefresh } from "./controller-helpers";
 export type UseAgents24ChatControllerOptions = {
     transport: ChatTransport;
     storage: ChatStorageAdapter;