@agents24/chat-react 0.1.10 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # Agents24 Chat React
 
-Last Updated: 2026-07-07
+Last Updated: 2026-07-15
 
 Headless React primitives for Agents24 chat surfaces.
 
@@ -18,29 +18,34 @@ 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
+- typed V2 `pendingHitl`, `isResolvingHitl`, and `resumeHitl(...)` controller state/actions in package `0.3.0`
 - `partsFromResponseBlocks(blocks, fallbackText)`
 - `renderChatPart(part, message, renderOptions)`
 - `@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)`, `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.
+`useAgents24ChatController` exposes reactive `threads`, `activeThreadId`, `activeThread`, `activeRunId`, `pendingHitl`, `isResolvingHitl`, `isRefreshingThreads`, `resumeHitl(...)`, `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. V2 resume always reattaches after successful or idempotent resolution so the backend snapshot remains authoritative.
 
 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.
 
-`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.
+`ChatMessage.parts` is the only render model. Backend `response_blocks` are normalized into ordered parts such as `text`, `tool-get_meteo`, `ui-blocks`, `reasoning`, `hitl`, `error`, and `data`. The shared compact HITL card renders pending and terminal states for Tool review, MCP authentication, User Approval, and app-data permission. Tool review exposes only **Allow once** and **Don't allow**; Edit and Respond are not part of the contract. Tool UI is client-owned through `renderPart`, `toolRenderers`, and `fallbackToolRenderer`; the package does not infer English tool labels or group tool rows.
 
 `useStreamingText` owns reusable visual pacing for active assistant text. It returns `displayedText`, `isAnimating`, `mode`, and `parseIncompleteMarkdown` so host renderers can pass those values into their markdown component without the package depending on any markdown/UI library. The package only chooses text timing, cache behavior, reduced-motion handling, and active text-part helpers.
 
 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:

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":"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","names":["content"]}

package/dist/controller-hitl.d.ts

@@ -0,0 +1,22 @@
+import { type MutableRefObject } from "react";
+import type { ChatHitlPart, ChatHitlResumeInput, ChatHitlResumeResult, ChatMessage, ChatTransport } from "./types";
+type RunStream = (input: {
+    mode: "attach";
+    threadId: string;
+    runId: string;
+}) => Promise<void>;
+export declare function useControllerHitl({ messages, transport, activeRunId, activeRunIdRef, activeThreadIdRef, runStream, }: {
+    messages: ChatMessage[];
+    transport: ChatTransport;
+    activeRunId: string | null;
+    activeRunIdRef: MutableRefObject<string | null>;
+    activeThreadIdRef: MutableRefObject<string | null>;
+    runStream: RunStream;
+}): {
+    pendingHitl: ChatHitlPart | null;
+    isResolvingHitl: boolean;
+    resumeHitl: (input: Omit<ChatHitlResumeInput, "runId"> & {
+        runId?: string;
+    }) => Promise<ChatHitlResumeResult>;
+};
+export {};

package/dist/controller-options.d.ts

@@ -0,0 +1,15 @@
+import type { ChatRuntimeEventContext } from "./controller-helpers";
+import type { ChatMessage, ChatRuntimeEvent, ChatStorageAdapter, ChatTransport } from "./types";
+export type UseAgents24ChatControllerOptions = {
+    transport: ChatTransport;
+    storage: ChatStorageAdapter;
+    activeThreadId?: string | null;
+    pageSize?: number;
+    storageKey?: unknown;
+    createId?: () => string;
+    onActiveThreadIdChange?: (threadId: string | null) => void;
+    onSourceClick?: (citations: ChatMessage["citations"]) => void;
+    onStreamErrorMessage?: (error: unknown) => string;
+    onRuntimeEvent?: (event: ChatRuntimeEvent, context: ChatRuntimeEventContext) => void | Promise<void>;
+    onThreadDetailLoaded?: (detail: unknown) => void | Promise<void>;
+};

package/dist/controller-thread-events.d.ts

@@ -0,0 +1,7 @@
+import type { ChatStorageAdapter, ChatTransport, StoredChatThread } from "./types";
+export declare function useControllerThreadEvents({ transport, storage, refresh, setThreads, }: {
+    transport: ChatTransport;
+    storage: ChatStorageAdapter;
+    refresh: () => Promise<void>;
+    setThreads: (threads: StoredChatThread[]) => void;
+}): void;

package/dist/controller.d.ts

@@ -1,17 +1,5 @@
-import { type ChatRuntimeEventContext } from "./controller-helpers";
-import type { ChatController, ChatMessage, ChatRuntimeEvent, ChatStorageAdapter, ChatTransport } from "./types";
+import type { UseAgents24ChatControllerOptions } from "./controller-options";
+import type { ChatController } from "./types";
 export { mergeStoredThreadsForRefresh } from "./controller-helpers";
-export type UseAgents24ChatControllerOptions = {
-    transport: ChatTransport;
-    storage: ChatStorageAdapter;
-    activeThreadId?: string | null;
-    pageSize?: number;
-    storageKey?: unknown;
-    createId?: () => string;
-    onActiveThreadIdChange?: (threadId: string | null) => void;
-    onSourceClick?: (citations: ChatMessage["citations"]) => void;
-    onStreamErrorMessage?: (error: unknown) => string;
-    onRuntimeEvent?: (event: ChatRuntimeEvent, context: ChatRuntimeEventContext) => void | Promise<void>;
-    onThreadDetailLoaded?: (detail: unknown) => void | Promise<void>;
-};
-export declare function useAgents24ChatController({ transport, storage, activeThreadId: controlledActiveThreadId, pageSize, storageKey, createId, onActiveThreadIdChange, onSourceClick, onStreamErrorMessage, onRuntimeEvent, onThreadDetailLoaded, }: UseAgents24ChatControllerOptions): ChatController;
+export type { UseAgents24ChatControllerOptions } from "./controller-options";
+export declare function useAgents24ChatController(options: UseAgents24ChatControllerOptions): ChatController;