@assistant-ui/react 0.15.14 → 0.15.15

package/dist/unstable/useLiveCompletionAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLiveCompletionAdapter.js","names":["useCallback","useEffect","useMemo","useRef","useState","Unstable_TriggerAdapter","Unstable_TriggerItem","Unstable_UseLiveCompletionAdapterOptions","fetcher","query","Promise","debounceMs","enabled","NO_QUERY","unstable_useLiveCompletionAdapter","options","adapter","isLoading","state","setState","items","failed","setIsLoading","fetcherRef","current","timerRef","ReturnType","setTimeout","tokenRef","pendingQueryRef","retryableQueryRef","pendingRetryQueryRef","cancelTimer","clearTimeout","rearmPendingRetry","scheduleFetch","token","then","invalidatePending","s","categories","categoryItems","search","queueMicrotask"],"sources":["../../src/unstable/useLiveCompletionAdapter.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type {\n  Unstable_TriggerAdapter,\n  Unstable_TriggerItem,\n} from \"@assistant-ui/core\";\n\nexport type Unstable_UseLiveCompletionAdapterOptions = {\n  /**\n   * Fetches the items for a query from an async source. Called debounced; the\n   * resolved items are cached and returned synchronously to the popover on the\n   * next render.\n   */\n  readonly fetcher: (query: string) => Promise<readonly Unstable_TriggerItem[]>;\n  /** Debounce applied before a fetch fires, in milliseconds. @default 60 */\n  readonly debounceMs?: number | undefined;\n  /** When `false`, no fetch is scheduled and the adapter stays empty. @default true */\n  readonly enabled?: boolean | undefined;\n};\n\n/** Sentinel that no real query (including the empty string) equals, so the first query always fetches. */\nconst NO_QUERY = \"\\u0000\";\n\n/**\n * @deprecated Under active development and may change without notice.\n *\n * Bridges an async completion source (a server search, a gateway RPC) into the\n * synchronous `Unstable_TriggerAdapter` that `ComposerTriggerPopover` consumes.\n * `search(query)` returns the last fetched items synchronously and schedules a\n * debounced fetch when the query changes; when results arrive the returned\n * `adapter` identity changes, which re-runs the popover's lookup so the fresh\n * items render. This is a search-only adapter (`categories` are empty).\n *\n * `isLoading` is `true` while a fetch is in flight. Pass it to the popover's\n * `isLoading` prop to render a loading state.\n *\n * @example\n * ```tsx\n * const mentions = unstable_useLiveCompletionAdapter({\n *   fetcher: (query) => searchUsers(query),\n * });\n *\n * <ComposerTriggerPopover\n *   char=\"@\"\n *   adapter={mentions.adapter}\n *   isLoading={mentions.isLoading}\n *   directive={{ onInserted }}\n * />\n * ```\n */\nexport function unstable_useLiveCompletionAdapter(\n  options: Unstable_UseLiveCompletionAdapterOptions,\n): { adapter: Unstable_TriggerAdapter; isLoading: boolean } {\n  const { fetcher, debounceMs = 60, enabled = true } = options;\n\n  const [state, setState] = useState<{\n    query: string;\n    items: readonly Unstable_TriggerItem[];\n    failed: boolean;\n  }>({ query: NO_QUERY, items: [], failed: false });\n  const [isLoading, setIsLoading] = useState(false);\n\n  const fetcherRef = useRef(fetcher);\n  fetcherRef.current = fetcher;\n\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const tokenRef = useRef(0);\n  const pendingQueryRef = useRef<string | null>(null);\n  const retryableQueryRef = useRef<string | null>(null);\n  const pendingRetryQueryRef = useRef<string | null>(null);\n\n  const cancelTimer = useCallback(() => {\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    }\n  }, []);\n\n  const rearmPendingRetry = useCallback(() => {\n    const query = pendingRetryQueryRef.current;\n    if (query === null) return;\n    retryableQueryRef.current = query;\n    pendingRetryQueryRef.current = null;\n  }, []);\n\n  const scheduleFetch = useCallback(\n    (query: string) => {\n      if (!enabled) return;\n      if (pendingQueryRef.current === query) return;\n      rearmPendingRetry();\n      if (retryableQueryRef.current === query) {\n        retryableQueryRef.current = null;\n        pendingRetryQueryRef.current = query;\n      }\n      pendingQueryRef.current = query;\n      cancelTimer();\n      const token = ++tokenRef.current;\n      setIsLoading(true);\n      timerRef.current = setTimeout(() => {\n        timerRef.current = null;\n        fetcherRef.current(query).then(\n          (items) => {\n            if (token !== tokenRef.current) return;\n            pendingRetryQueryRef.current = null;\n            setState({ query, items, failed: false });\n            setIsLoading(false);\n          },\n          () => {\n            if (token !== tokenRef.current) return;\n            pendingQueryRef.current = null;\n            pendingRetryQueryRef.current = null;\n            setState({ query, items: [], failed: true });\n            setIsLoading(false);\n          },\n        );\n      }, debounceMs);\n    },\n    [enabled, debounceMs, cancelTimer, rearmPendingRetry],\n  );\n\n  const invalidatePending = useCallback(() => {\n    rearmPendingRetry();\n    cancelTimer();\n    pendingQueryRef.current = null;\n    tokenRef.current += 1;\n    setIsLoading(false);\n  }, [cancelTimer, rearmPendingRetry]);\n\n  useEffect(() => {\n    if (enabled) return;\n    invalidatePending();\n    setState((s) =>\n      s.query === NO_QUERY ? s : { query: NO_QUERY, items: [], failed: false },\n    );\n  }, [enabled, invalidatePending]);\n\n  useEffect(() => cancelTimer, [cancelTimer]);\n\n  // Arm retries only after the failed state commits. Arming during rejection\n  // would let the failure render immediately schedule another request.\n  useEffect(() => {\n    retryableQueryRef.current = state.failed ? state.query : null;\n  }, [state]);\n\n  const adapter = useMemo<Unstable_TriggerAdapter>(\n    () => ({\n      categories: () => [],\n      categoryItems: () => [],\n      search: (query: string) => {\n        // search() runs inside the popover's render; defer state updates with\n        // queueMicrotask so they are not dispatched while another component renders.\n        if (query !== state.query || retryableQueryRef.current === query) {\n          queueMicrotask(() => scheduleFetch(query));\n        } else if (\n          pendingQueryRef.current !== null &&\n          pendingQueryRef.current !== query\n        ) {\n          // the query returned to a cached value while a fetch for a different\n          // query is in flight; drop it so its result cannot overwrite the cache\n          queueMicrotask(invalidatePending);\n        }\n        return state.items;\n      },\n    }),\n    [state, scheduleFetch, invalidatePending],\n  );\n\n  return { adapter, isLoading };\n}\n"],"mappings":"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"}
+{"version":3,"file":"useLiveCompletionAdapter.js","names":["useCallback","useEffect","useLayoutEffect","useMemo","useRef","useState","Unstable_TriggerAdapter","Unstable_TriggerItem","Unstable_UseLiveCompletionAdapterOptions","fetcher","query","Promise","cacheKey","debounceMs","enabled","NO_QUERY","unstable_useLiveCompletionAdapter","options","adapter","isLoading","state","setState","items","failed","setIsLoading","fetcherRef","current","timerRef","ReturnType","setTimeout","tokenRef","pendingQueryRef","retryableQueryRef","pendingRetryQueryRef","cancelTimer","clearTimeout","rearmPendingRetry","scheduleFetch","token","resolve","then","invalidatePending","cacheKeyRef","s","categories","categoryItems","search","queueMicrotask"],"sources":["../../src/unstable/useLiveCompletionAdapter.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type {\n  Unstable_TriggerAdapter,\n  Unstable_TriggerItem,\n} from \"@assistant-ui/core\";\n\nexport type Unstable_UseLiveCompletionAdapterOptions = {\n  /**\n   * Fetches the items for a query from an async source. Called debounced; the\n   * resolved items are cached and returned synchronously to the popover on the\n   * next render.\n   */\n  readonly fetcher: (query: string) => Promise<readonly Unstable_TriggerItem[]>;\n  /**\n   * Identifies the fetcher's data source. Change this when switching accounts,\n   * workspaces, or another boundary that should invalidate cached results.\n   */\n  readonly cacheKey?: string | number | undefined;\n  /** Debounce applied before a fetch fires, in milliseconds. @default 60 */\n  readonly debounceMs?: number | undefined;\n  /** When `false`, no fetch is scheduled and the adapter stays empty. @default true */\n  readonly enabled?: boolean | undefined;\n};\n\n/** Sentinel that no real query (including the empty string) equals, so the first query always fetches. */\nconst NO_QUERY = \"\\u0000\";\n\n/**\n * @deprecated Under active development and may change without notice.\n *\n * Bridges an async completion source (a server search, a gateway RPC) into the\n * synchronous `Unstable_TriggerAdapter` that `ComposerTriggerPopover` consumes.\n * `search(query)` returns the last fetched items synchronously and schedules a\n * debounced fetch when the query changes; when results arrive the returned\n * `adapter` identity changes, which re-runs the popover's lookup so the fresh\n * items render. This is a search-only adapter (`categories` are empty).\n *\n * `isLoading` is `true` while a fetch is in flight. Pass it to the popover's\n * `isLoading` prop to render a loading state.\n *\n * @example\n * ```tsx\n * const mentions = unstable_useLiveCompletionAdapter({\n *   fetcher: (query) => searchUsers(query),\n * });\n *\n * <ComposerTriggerPopover\n *   char=\"@\"\n *   adapter={mentions.adapter}\n *   isLoading={mentions.isLoading}\n *   directive={{ onInserted }}\n * />\n * ```\n */\nexport function unstable_useLiveCompletionAdapter(\n  options: Unstable_UseLiveCompletionAdapterOptions,\n): { adapter: Unstable_TriggerAdapter; isLoading: boolean } {\n  const { fetcher, cacheKey, debounceMs = 60, enabled = true } = options;\n\n  const [state, setState] = useState<{\n    query: string;\n    items: readonly Unstable_TriggerItem[];\n    failed: boolean;\n  }>({ query: NO_QUERY, items: [], failed: false });\n  const [isLoading, setIsLoading] = useState(false);\n\n  const fetcherRef = useRef(fetcher);\n  fetcherRef.current = fetcher;\n\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const tokenRef = useRef(0);\n  const pendingQueryRef = useRef<string | null>(null);\n  const retryableQueryRef = useRef<string | null>(null);\n  const pendingRetryQueryRef = useRef<string | null>(null);\n\n  const cancelTimer = useCallback(() => {\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    }\n  }, []);\n\n  const rearmPendingRetry = useCallback(() => {\n    const query = pendingRetryQueryRef.current;\n    if (query === null) return;\n    retryableQueryRef.current = query;\n    pendingRetryQueryRef.current = null;\n  }, []);\n\n  const scheduleFetch = useCallback(\n    (query: string) => {\n      if (!enabled) return;\n      if (pendingQueryRef.current === query) return;\n      rearmPendingRetry();\n      if (retryableQueryRef.current === query) {\n        retryableQueryRef.current = null;\n        pendingRetryQueryRef.current = query;\n      }\n      pendingQueryRef.current = query;\n      cancelTimer();\n      const token = ++tokenRef.current;\n      setIsLoading(true);\n      timerRef.current = setTimeout(() => {\n        timerRef.current = null;\n        Promise.resolve()\n          .then(() => fetcherRef.current(query))\n          .then(\n            (items) => {\n              if (token !== tokenRef.current) return;\n              pendingRetryQueryRef.current = null;\n              setState({ query, items, failed: false });\n              setIsLoading(false);\n            },\n            () => {\n              if (token !== tokenRef.current) return;\n              pendingQueryRef.current = null;\n              pendingRetryQueryRef.current = null;\n              setState({ query, items: [], failed: true });\n              setIsLoading(false);\n            },\n          );\n      }, debounceMs);\n    },\n    [enabled, debounceMs, cancelTimer, rearmPendingRetry],\n  );\n\n  const invalidatePending = useCallback(() => {\n    rearmPendingRetry();\n    cancelTimer();\n    pendingQueryRef.current = null;\n    tokenRef.current += 1;\n    setIsLoading(false);\n  }, [cancelTimer, rearmPendingRetry]);\n\n  const cacheKeyRef = useRef(cacheKey);\n  useLayoutEffect(() => {\n    if (cacheKeyRef.current === cacheKey) return;\n    cacheKeyRef.current = cacheKey;\n    invalidatePending();\n    retryableQueryRef.current = null;\n    pendingRetryQueryRef.current = null;\n    setState({ query: NO_QUERY, items: [], failed: false });\n  }, [cacheKey, invalidatePending]);\n\n  useEffect(() => {\n    if (enabled) return;\n    invalidatePending();\n    setState((s) =>\n      s.query === NO_QUERY ? s : { query: NO_QUERY, items: [], failed: false },\n    );\n  }, [enabled, invalidatePending]);\n\n  useEffect(() => cancelTimer, [cancelTimer]);\n\n  // Arm retries only after the failed state commits. Arming during rejection\n  // would let the failure render immediately schedule another request.\n  useEffect(() => {\n    retryableQueryRef.current = state.failed ? state.query : null;\n  }, [state]);\n\n  const adapter = useMemo<Unstable_TriggerAdapter>(\n    () => ({\n      categories: () => [],\n      categoryItems: () => [],\n      search: (query: string) => {\n        // search() runs inside the popover's render; defer state updates with\n        // queueMicrotask so they are not dispatched while another component renders.\n        if (query !== state.query || retryableQueryRef.current === query) {\n          queueMicrotask(() => scheduleFetch(query));\n        } else if (\n          pendingQueryRef.current !== null &&\n          pendingQueryRef.current !== query\n        ) {\n          // the query returned to a cached value while a fetch for a different\n          // query is in flight; drop it so its result cannot overwrite the cache\n          queueMicrotask(invalidatePending);\n        }\n        return state.items;\n      },\n    }),\n    [state, scheduleFetch, invalidatePending],\n  );\n\n  return { adapter, isLoading };\n}\n"],"mappings":";;;;AAkCA,MAAMe,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BjB,SAAgBC,kCACdC,SAC0D;CAC1D,MAAM,EAAER,SAASG,UAAUC,aAAa,IAAIC,UAAU,SAASG;CAE/D,MAAM,CAACG,OAAOC,YAAYhB,SAIvB;EAAEK,OAAOK;EAAUO,OAAO,CAAA;EAAIC,QAAQ;CAAM,CAAC;CAChD,MAAM,CAACJ,WAAWK,gBAAgBnB,SAAS,KAAK;CAEhD,MAAMoB,aAAarB,OAAOK,OAAO;CACjCgB,WAAWC,UAAUjB;CAErB,MAAMkB,WAAWvB,OAA6C,IAAI;CAClE,MAAM0B,WAAW1B,OAAO,CAAC;CACzB,MAAM2B,kBAAkB3B,OAAsB,IAAI;CAClD,MAAM4B,oBAAoB5B,OAAsB,IAAI;CACpD,MAAM6B,uBAAuB7B,OAAsB,IAAI;CAEvD,MAAM8B,cAAclC,kBAAkB;EACpC,IAAI2B,SAASD,YAAY,MAAM;GAC7BS,aAAaR,SAASD,OAAO;GAC7BC,SAASD,UAAU;EACrB;CACF,GAAG,CAAA,CAAE;CAEL,MAAMU,oBAAoBpC,kBAAkB;EAC1C,MAAMU,QAAQuB,qBAAqBP;EACnC,IAAIhB,UAAU,MAAM;EACpBsB,kBAAkBN,UAAUhB;EAC5BuB,qBAAqBP,UAAU;CACjC,GAAG,CAAA,CAAE;CAEL,MAAMW,gBAAgBrC,aACnBU,UAAkB;EACjB,IAAI,CAACI,SAAS;EACd,IAAIiB,gBAAgBL,YAAYhB,OAAO;EACvC0B,kBAAkB;EAClB,IAAIJ,kBAAkBN,YAAYhB,OAAO;GACvCsB,kBAAkBN,UAAU;GAC5BO,qBAAqBP,UAAUhB;EACjC;EACAqB,gBAAgBL,UAAUhB;EAC1BwB,YAAY;EACZ,MAAMI,QAAQ,EAAER,SAASJ;EACzBF,aAAa,IAAI;EACjBG,SAASD,UAAUG,iBAAiB;GAClCF,SAASD,UAAU;GACnBf,QAAQ4B,QAAQ,CAAC,CACdC,WAAWf,WAAWC,QAAQhB,KAAK,CAAC,CAAC,CACrC8B,MACElB,UAAU;IACT,IAAIgB,UAAUR,SAASJ,SAAS;IAChCO,qBAAqBP,UAAU;IAC/BL,SAAS;KAAEX;KAAOY;KAAOC,QAAQ;IAAM,CAAC;IACxCC,aAAa,KAAK;GACpB,SACM;IACJ,IAAIc,UAAUR,SAASJ,SAAS;IAChCK,gBAAgBL,UAAU;IAC1BO,qBAAqBP,UAAU;IAC/BL,SAAS;KAAEX;KAAOY,OAAO,CAAA;KAAIC,QAAQ;IAAK,CAAC;IAC3CC,aAAa,KAAK;GACpB,CACF;EACJ,GAAGX,UAAU;CACf,GACA;EAACC;EAASD;EAAYqB;EAAaE;CAAiB,CACtD;CAEA,MAAMK,oBAAoBzC,kBAAkB;EAC1CoC,kBAAkB;EAClBF,YAAY;EACZH,gBAAgBL,UAAU;EAC1BI,SAASJ,WAAW;EACpBF,aAAa,KAAK;CACpB,GAAG,CAACU,aAAaE,iBAAiB,CAAC;CAEnC,MAAMM,cAActC,OAAOQ,QAAQ;CACnCV,sBAAsB;EACpB,IAAIwC,YAAYhB,YAAYd,UAAU;EACtC8B,YAAYhB,UAAUd;EACtB6B,kBAAkB;EAClBT,kBAAkBN,UAAU;EAC5BO,qBAAqBP,UAAU;EAC/BL,SAAS;GAAEX,OAAOK;GAAUO,OAAO,CAAA;GAAIC,QAAQ;EAAM,CAAC;CACxD,GAAG,CAACX,UAAU6B,iBAAiB,CAAC;CAEhCxC,gBAAgB;EACd,IAAIa,SAAS;EACb2B,kBAAkB;EAClBpB,UAAUsB,MACRA,EAAEjC,UAAUK,WAAW4B,IAAI;GAAEjC,OAAOK;GAAUO,OAAO,CAAA;GAAIC,QAAQ;EAAM,CACzE;CACF,GAAG,CAACT,SAAS2B,iBAAiB,CAAC;CAE/BxC,gBAAgBiC,aAAa,CAACA,WAAW,CAAC;CAI1CjC,gBAAgB;EACd+B,kBAAkBN,UAAUN,MAAMG,SAASH,MAAMV,QAAQ;CAC3D,GAAG,CAACU,KAAK,CAAC;CAyBV,OAAO;EAAEF,SAvBOf,eACP;GACLyC,kBAAkB,CAAA;GAClBC,qBAAqB,CAAA;GACrBC,SAASpC,UAAkB;IAGzB,IAAIA,UAAUU,MAAMV,SAASsB,kBAAkBN,YAAYhB,OACzDqC,qBAAqBV,cAAc3B,KAAK,CAAC;SACpC,IACLqB,gBAAgBL,YAAY,QAC5BK,gBAAgBL,YAAYhB,OAI5BqC,eAAeN,iBAAiB;IAElC,OAAOrB,MAAME;GACf;EACF,IACA;GAACF;GAAOiB;GAAeI;EAAiB,CAGjCvB;EAASC;CAAU;AAC9B"}

package/dist/unstable/useMentionAdapter.d.ts

@@ -1,6 +1,6 @@
 import { Unstable_DirectiveFormatter, Unstable_TriggerAdapter, Unstable_TriggerItem } from "@assistant-ui/core";
-import { ReadonlyJSONObject } from "assistant-stream/utils";
 import { FC } from "react";
+import { ReadonlyJSONObject } from "assistant-stream/utils";
 //#region src/unstable/useMentionAdapter.d.ts
 /** Icon component shape consumed by `ComposerTriggerPopover`'s `iconMap`. */
 type Unstable_IconComponent = FC<{

package/dist/utils/smooth/SmoothContext.js

@@ -1,7 +1,7 @@
 "use client";
 import { createContextStoreHook } from "../../context/react/utils/createContextStoreHook.js";
-import { useAui } from "@assistant-ui/store";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
+import { useAui } from "@assistant-ui/store";
 import { createContext, forwardRef, useContext, useState } from "@assistant-ui/tap/react-shim";
 import { create } from "zustand";
 import { jsx } from "react/jsx-runtime";

package/dist/utils/useToolArgsFieldStatus.js

@@ -1,5 +1,5 @@
-import { useAuiState } from "@assistant-ui/store";
 import { c } from "@assistant-ui/tap/react-shim/compiler-runtime";
+import { useAuiState } from "@assistant-ui/store";
 import { getPartialJsonObjectFieldState } from "assistant-stream/utils";
 //#region src/utils/useToolArgsFieldStatus.ts
 const COMPLETE_STATUS = { type: "complete" };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/react",
-  "version": "0.15.14",
+  "version": "0.15.15",
   "description": "Open-source TypeScript/React library for building production-grade AI chat experiences",
   "keywords": [
     "ai",
@@ -55,9 +55,9 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@assistant-ui/core": "^0.3.13",
-    "@assistant-ui/store": "^0.3.9",
-    "@assistant-ui/tap": "^0.9.12",
+    "@assistant-ui/core": "^0.3.14",
+    "@assistant-ui/store": "^0.3.10",
+    "@assistant-ui/tap": "^0.9.13",
     "@radix-ui/primitive": "^1.1.7",
     "@radix-ui/react-collection": "^1.1.15",
     "@radix-ui/react-compose-refs": "^1.1.5",
@@ -66,8 +66,8 @@
     "@radix-ui/react-use-callback-ref": "^1.1.4",
     "@radix-ui/react-use-controllable-state": "^1.2.6",
     "@radix-ui/react-use-escape-keydown": "^1.1.5",
-    "assistant-cloud": "^0.1.40",
-    "assistant-stream": "^0.3.37",
+    "assistant-cloud": "^0.1.41",
+    "assistant-stream": "^0.3.38",
     "radix-ui": "^1.6.7",
     "react-textarea-autosize": "^8.5.9",
     "safe-content-frame": "^0.0.27",
@@ -91,15 +91,15 @@
   "devDependencies": {
     "@testing-library/react": "^16.3.2",
     "@types/json-schema": "^7.0.15",
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
     "jsdom": "^30.0.1",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "vitest": "^4.1.10",
-    "@assistant-ui/vite": "0.0.12",
-    "@assistant-ui/x-buildutils": "0.0.22"
+    "@assistant-ui/vite": "0.0.14",
+    "@assistant-ui/x-buildutils": "0.0.23"
   },
   "publishConfig": {
     "access": "public",

package/src/assistant-transport.ts

@@ -0,0 +1,94 @@
+"use client";
+
+import type {
+  AssistantRuntime,
+  UserCommands as CoreUserCommands,
+  UserExternalState as CoreUserExternalState,
+} from "@assistant-ui/core";
+import {
+  useAssistantTransportRuntime as useCoreAssistantTransportRuntime,
+  useAssistantTransportSendCommand as useCoreAssistantTransportSendCommand,
+  useAssistantTransportState as useCoreAssistantTransportState,
+} from "@assistant-ui/core/react";
+import type {
+  AssistantTransportCommand as CoreAssistantTransportCommand,
+  AssistantTransportConnectionMetadata as CoreAssistantTransportConnectionMetadata,
+  AssistantTransportOptions as CoreAssistantTransportOptions,
+  AssistantTransportProtocol,
+  SendCommandsRequestBody as CoreSendCommandsRequestBody,
+} from "@assistant-ui/core/react";
+import type { UserCommands, UserExternalState } from "./augmentations";
+
+export type { AssistantTransportProtocol };
+
+export type SendCommandsRequestBody = Omit<
+  CoreSendCommandsRequestBody,
+  "commands"
+> & {
+  commands: AssistantTransportCommand[];
+};
+
+export type AssistantTransportCommand =
+  | Exclude<CoreAssistantTransportCommand, CoreUserCommands>
+  | UserCommands;
+
+export type AssistantTransportConnectionMetadata = Omit<
+  CoreAssistantTransportConnectionMetadata,
+  "pendingCommands"
+> & {
+  pendingCommands: AssistantTransportCommand[];
+};
+
+export type AssistantTransportStateConverter<T> = (
+  state: T,
+  connectionMetadata: AssistantTransportConnectionMetadata,
+) => ReturnType<CoreAssistantTransportOptions<T>["converter"]>;
+
+export type AssistantTransportOptions<T> = Omit<
+  CoreAssistantTransportOptions<T>,
+  "converter" | "prepareSendCommandsRequest" | "onError" | "onCancel"
+> & {
+  converter: AssistantTransportStateConverter<T>;
+  prepareSendCommandsRequest?: (
+    body: SendCommandsRequestBody,
+  ) => Record<string, unknown> | Promise<Record<string, unknown>>;
+  onError?: (
+    error: Error,
+    params: {
+      commands: AssistantTransportCommand[];
+      updateState: (updater: (state: T) => T) => void;
+    },
+  ) => void | Promise<void>;
+  onCancel?: (params: {
+    commands: AssistantTransportCommand[];
+    updateState: (updater: (state: T) => T) => void;
+    error?: Error;
+  }) => void;
+};
+
+export const useAssistantTransportRuntime = <T>(
+  options: AssistantTransportOptions<T>,
+): AssistantRuntime => {
+  return useCoreAssistantTransportRuntime(
+    options as CoreAssistantTransportOptions<T>,
+  );
+};
+
+export const useAssistantTransportSendCommand = () => {
+  const send = useCoreAssistantTransportSendCommand();
+  return (command: AssistantTransportCommand) => {
+    send(command as CoreAssistantTransportCommand);
+  };
+};
+
+export function useAssistantTransportState(): UserExternalState;
+export function useAssistantTransportState<T>(
+  selector: (state: UserExternalState) => T,
+): T;
+export function useAssistantTransportState<T>(
+  selector: (state: UserExternalState) => T = (state) => state as T,
+): T | UserExternalState {
+  return useCoreAssistantTransportState(
+    selector as (state: CoreUserExternalState) => T,
+  );
+}

package/src/index.ts

@@ -43,7 +43,7 @@ export type {
   ThreadListItemState,
 } from "@assistant-ui/core";
 
-export { useCloudThreadListRuntime } from "./legacy-runtime/cloud/useCloudThreadListRuntime";
+export { useCloudThreadListRuntime } from "@assistant-ui/core/react";
 export { AssistantCloud } from "assistant-cloud";
 
 // --- adapters/attachment ---
@@ -107,13 +107,13 @@ export {
   useAssistantTransportRuntime,
   useAssistantTransportSendCommand,
   useAssistantTransportState,
-} from "./legacy-runtime/runtime-cores/assistant-transport/useAssistantTransportRuntime";
+} from "./assistant-transport";
 export type {
   AssistantTransportConnectionMetadata,
   AssistantTransportCommand,
   AssistantTransportProtocol,
   SendCommandsRequestBody,
-} from "./legacy-runtime/runtime-cores/assistant-transport/types";
+} from "./assistant-transport";
 
 // --- core ---
 export type {
@@ -430,7 +430,11 @@ export {
 export {
   InMemoryThreadList,
   type InMemoryThreadListProps,
-} from "./client/InMemoryThreadList";
+} from "@assistant-ui/core/store";
+export {
+  RemoteThreadList,
+  type RemoteThreadListProps,
+} from "@assistant-ui/core/store";
 export { SingleThreadList } from "@assistant-ui/core/store";
 
 export * as INTERNAL from "./internal";

package/src/mcp-apps/McpAppsRemoteHost.test.ts

@@ -41,9 +41,15 @@ describe("McpAppsRemoteHost", () => {
   });
 
   it("posts serverId params verbatim for tool calls and resource loads", async () => {
-    const fetch = vi.fn(async () =>
-      Response.json({ content: [{ type: "text", text: "ok" }] }),
-    ) as unknown as typeof globalThis.fetch;
+    const fetch = vi.fn(async (_input, init) => {
+      const request = JSON.parse(String(init?.body)) as { method: string };
+      return request.method === "mcp-apps/read-resource"
+        ? Response.json({
+            uri: "ui://example/search",
+            html: "<main>Search</main>",
+          })
+        : Response.json({ content: [{ type: "text", text: "ok" }] });
+    }) as unknown as typeof globalThis.fetch;
     const root = mount(fetch);
 
     try {
@@ -123,4 +129,24 @@ describe("McpAppsRemoteHost", () => {
       root.unmount();
     }
   });
+
+  it.each([{}, { uri: " ", html: "" }])(
+    "rejects malformed successful resource responses",
+    async (response) => {
+      const fetch = vi.fn(async () =>
+        Response.json(response),
+      ) as unknown as typeof globalThis.fetch;
+      const root = mount(fetch);
+
+      try {
+        await expect(
+          root.getValue().loadResource({ uri: "ui://example/search" }),
+        ).rejects.toThrow(
+          /Invalid MCP App host response "mcp-apps\/read-resource" from "\/api\/mcp-apps"/,
+        );
+      } finally {
+        root.unmount();
+      }
+    },
+  );
 });

package/src/mcp-apps/McpAppsRemoteHost.ts

@@ -39,6 +39,33 @@ const readErrorBody = async (res: Response): Promise<string | undefined> => {
   }
 };
 
+const invalidMcpAppResource = (options: McpAppsRemoteHostOptions): never => {
+  throw new Error(
+    `Invalid MCP App host response "mcp-apps/read-resource" from "${options.url}": expected a resource with non-empty string "uri" and "html" fields`,
+  );
+};
+
+const parseMcpAppResource = (
+  value: unknown,
+  options: McpAppsRemoteHostOptions,
+): McpAppResource => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return invalidMcpAppResource(options);
+  }
+
+  const resource = value as Record<string, unknown>;
+  if (
+    typeof resource.uri !== "string" ||
+    resource.uri.trim() === "" ||
+    typeof resource.html !== "string" ||
+    resource.html.trim() === ""
+  ) {
+    return invalidMcpAppResource(options);
+  }
+
+  return value as McpAppResource;
+};
+
 async function postToHost(
   options: McpAppsRemoteHostOptions,
   method: string,
@@ -63,7 +90,14 @@ async function postToHost(
       `MCP App host request "${method}" to "${options.url}" failed with ${status}${body ? `: ${body}` : ""}`,
     );
   }
-  return res.json();
+  try {
+    return await res.json();
+  } catch (cause) {
+    throw new Error(
+      `Invalid MCP App host response "${method}" from "${options.url}": expected valid JSON`,
+      { cause },
+    );
+  }
 }
 
 /**
@@ -91,12 +125,13 @@ const useMcpAppsRemoteHost = (
       };
     };
     return {
-      loadResource: (params) =>
-        postToHost(
-          getCurrentOptions(),
-          "mcp-apps/read-resource",
-          params,
-        ) as Promise<McpAppResource>,
+      loadResource: async (params) => {
+        const options = getCurrentOptions();
+        return parseMcpAppResource(
+          await postToHost(options, "mcp-apps/read-resource", params),
+          options,
+        );
+      },
       callTool: (params) =>
         postToHost(getCurrentOptions(), "tools/call", params),
       readResource: (params) =>

package/src/mcp-apps/bridge.test.ts

@@ -124,6 +124,53 @@ describe("createMcpAppBridge", () => {
     bridge.dispose();
   });
 
+  it.each([
+    [
+      "throws",
+      () => {
+        throw new Error("error callback failed");
+      },
+    ],
+    ["rejects", () => Promise.reject(new Error("error callback failed"))],
+  ])(
+    "returns an error response when onError %s",
+    async (_behavior, onErrorCallback) => {
+      const { frame, captured } = makeFrame();
+      const callTool = vi.fn().mockRejectedValue(new Error("tool failed"));
+      const consoleError = vi
+        .spyOn(console, "error")
+        .mockImplementation(() => {});
+      const onError = vi.fn(onErrorCallback);
+      const bridge = createMcpAppBridge({
+        frame,
+        handlers: { callTool, onError },
+      });
+
+      deliver(bridge, {
+        jsonrpc: "2.0",
+        id: 8,
+        method: "tools/call",
+        params: { name: "search" },
+      });
+      await flush();
+
+      expect(onError).toHaveBeenCalledWith(new Error("tool failed"));
+      expect(captured).toEqual([
+        {
+          jsonrpc: "2.0",
+          id: 8,
+          error: { code: -32603, message: "tool failed" },
+        },
+      ]);
+      expect(consoleError).toHaveBeenCalledWith(
+        "[assistant-ui] MCP App onError callback threw an error",
+        new Error("error callback failed"),
+      );
+      consoleError.mockRestore();
+      bridge.dispose();
+    },
+  );
+
   it("rejects tools/call for disallowed tool with -32602", async () => {
     const { frame, captured } = makeFrame();
     const callTool = vi.fn();
@@ -244,6 +291,60 @@ describe("createMcpAppBridge", () => {
     bridge.dispose();
   });
 
+  it("isolates throwing notification handlers and reports their errors", () => {
+    const { frame, captured } = makeFrame();
+    const initializedError = new Error("initialized callback failed");
+    const sizeChangeError = new Error("size change callback failed");
+    const teardownError = new Error("teardown callback failed");
+    const onError = vi.fn();
+    const bridge = createMcpAppBridge({
+      frame,
+      handlers: {
+        onInitialized: () => {
+          throw initializedError;
+        },
+        onSizeChange: () => {
+          throw sizeChangeError;
+        },
+        onLog: () => {
+          throw "log callback failed";
+        },
+        onRequestTeardown: () => {
+          throw teardownError;
+        },
+        onError,
+      },
+    });
+
+    expect(() => {
+      deliver(bridge, {
+        jsonrpc: "2.0",
+        method: "notifications/initialized",
+      });
+      deliver(bridge, {
+        jsonrpc: "2.0",
+        method: "notifications/size_changed",
+      });
+      deliver(bridge, {
+        jsonrpc: "2.0",
+        method: "notifications/log",
+      });
+      deliver(bridge, {
+        jsonrpc: "2.0",
+        method: "notifications/request_teardown",
+      });
+    }).not.toThrow();
+
+    expect(onError.mock.calls.map(([error]) => error)).toEqual([
+      initializedError,
+      sizeChangeError,
+      new Error("log callback failed"),
+      teardownError,
+    ]);
+    expect(captured).toEqual([]);
+    bridge.dispose();
+  });
+
   it("notifyToolInput / notifyToolResult / notifyHostContextChanged post both legacy and 2026-01-26 notifications", () => {
     const { frame, captured } = makeFrame();
     const bridge = createMcpAppBridge({ frame });
@@ -428,4 +529,35 @@ describe("createMcpAppBridge", () => {
     expect(onRequestTeardown).toHaveBeenCalledWith({ reason: "done" });
     bridge.dispose();
   });
+
+  it("isolates a throwing onError from widget error notifications", () => {
+    const { frame } = makeFrame();
+    const callbackError = new Error("error callback failed");
+    const consoleError = vi
+      .spyOn(console, "error")
+      .mockImplementation(() => {});
+    const onError = vi.fn(() => {
+      throw callbackError;
+    });
+    const bridge = createMcpAppBridge({
+      frame,
+      handlers: { callTool: vi.fn(), onError },
+    });
+
+    expect(() =>
+      deliver(bridge, {
+        jsonrpc: "2.0",
+        method: "notifications/error",
+        params: { message: "kaboom" },
+      }),
+    ).not.toThrow();
+
+    expect(onError).toHaveBeenCalledWith(new Error("kaboom"));
+    expect(consoleError).toHaveBeenCalledWith(
+      "[assistant-ui] MCP App onError callback threw an error",
+      callbackError,
+    );
+    consoleError.mockRestore();
+    bridge.dispose();
+  });
 });

package/src/mcp-apps/bridge.ts

@@ -123,6 +123,23 @@ export function createMcpAppBridge(
     });
   };
 
+  const reportErrorCallbackFailure = (error: unknown) => {
+    console.error(
+      "[assistant-ui] MCP App onError callback threw an error",
+      error,
+    );
+  };
+
+  const reportError = (error: Error) => {
+    try {
+      void Promise.resolve(handlers.onError?.(error)).catch(
+        reportErrorCallbackFailure,
+      );
+    } catch (callbackError) {
+      reportErrorCallbackFailure(callbackError);
+    }
+  };
+
   const handleRequest = async (req: McpAppJsonRpcRequest) => {
     try {
       const params = req.params;
@@ -376,42 +393,49 @@ export function createMcpAppBridge(
       }
     } catch (err) {
       const error = err instanceof Error ? err : new Error(String(err));
-      handlers.onError?.(error);
+      reportError(error);
       errorResponse(req.id, JSONRPC_ERROR.internalError, error.message);
     }
   };
 
   const handleNotification = (note: McpAppJsonRpcNotification) => {
-    switch (normalizeMethod(note.method)) {
-      case "notifications/initialized": {
-        handlers.onInitialized?.();
-        return;
-      }
-      case "notifications/size_changed": {
-        const p = (note.params ?? {}) as { width?: number; height?: number };
-        handlers.onSizeChange?.({
-          ...(typeof p.width === "number" ? { width: p.width } : {}),
-          ...(typeof p.height === "number" ? { height: p.height } : {}),
-        });
-        return;
-      }
-      case "notifications/log": {
-        handlers.onLog?.(note.params);
-        return;
-      }
-      case "notifications/request_teardown": {
-        handlers.onRequestTeardown?.(note.params);
-        return;
-      }
-      case "notifications/error": {
-        const p = (note.params ?? {}) as { message?: string };
-        handlers.onError?.(
-          new Error(typeof p.message === "string" ? p.message : "Widget error"),
-        );
-        return;
+    try {
+      switch (normalizeMethod(note.method)) {
+        case "notifications/initialized": {
+          handlers.onInitialized?.();
+          return;
+        }
+        case "notifications/size_changed": {
+          const p = (note.params ?? {}) as { width?: number; height?: number };
+          handlers.onSizeChange?.({
+            ...(typeof p.width === "number" ? { width: p.width } : {}),
+            ...(typeof p.height === "number" ? { height: p.height } : {}),
+          });
+          return;
+        }
+        case "notifications/log": {
+          handlers.onLog?.(note.params);
+          return;
+        }
+        case "notifications/request_teardown": {
+          handlers.onRequestTeardown?.(note.params);
+          return;
+        }
+        case "notifications/error": {
+          const p = (note.params ?? {}) as { message?: string };
+          reportError(
+            new Error(
+              typeof p.message === "string" ? p.message : "Widget error",
+            ),
+          );
+          return;
+        }
+        default:
+          return;
       }
-      default:
-        return;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error(String(err));
+      reportError(error);
     }
   };
 

package/src/primitives/actionBar/ActionBarStopSpeaking.tsx

@@ -2,7 +2,6 @@
 
 import { forwardRef } from "react";
 import type { ActionButtonProps } from "../../utils/createActionButton";
-import { useEscapeKeydown } from "@radix-ui/react-use-escape-keydown";
 import { Primitive } from "../../utils/Primitive";
 import { composeEventHandlers } from "@radix-ui/primitive";
 import { useActionBarStopSpeaking as useActionBarStopSpeakingBehavior } from "@assistant-ui/core/react";
@@ -24,14 +23,6 @@ export const ActionBarPrimitiveStopSpeaking = forwardRef<
 >((props, ref) => {
   const callback = useActionBarStopSpeaking();
 
-  // TODO this stops working if the user is not hovering over an older message
-  useEscapeKeydown((e) => {
-    if (callback) {
-      e.preventDefault();
-      callback();
-    }
-  });
-
   return (
     <Primitive.button
       type="button"

package/src/primitives/composer/ComposerInput.tsx

@@ -346,7 +346,7 @@ export const ComposerPrimitiveInput = forwardRef<
       )
         return undefined;
 
-      return aui.on("threadListItem.switchedTo", focus);
+      return aui.on("threads.selectionChanged", focus);
     }, [unstable_focusOnThreadSwitched, focus, aui]);
 
     useEffect(() => {