@athenaintel/react 0.28.0 → 0.30.0

package/dist/agent-runtime/src/use-deep-agent-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-thread.js","sources":["../../../../agent-runtime/src/use-deep-agent-thread.ts"],"sourcesContent":["import type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport { StatewireThread } from '@assistant-ui/react-statewire';\nimport { withKey } from '@assistant-ui/tap';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport {\n  type AuthDenialTrackerState,\n  initialAuthDenialTrackerState,\n  observeAuthDenial,\n} from './auth-denial';\nimport {\n  createDeepAgentAttachTransport,\n  type DeepAgentHeadersResolver,\n} from './deep-agent-transport-recipe';\nimport { projectDeepAgentConnection } from './errors';\nimport { type DeepAgentMessageAuthor, isSameMessageAuthor } from './message-author';\nimport { DEEP_AGENT_INTEREST_PROTOCOL } from './generated/runconfig-contract';\nimport {\n  type DeepAgentMessageWindowDeclaration,\n  headInterestRequest,\n  readDeepAgentMessageWindow,\n} from './message-window';\nimport {\n  convertDeepAgentState,\n  createDeepAgentMaterialize,\n  createDeepAgentMessageConversionCache,\n  type DeepAgentMessageConversionCache,\n} from './messages';\nimport { type DeepAgentProtocolStatus, projectDeepAgentProtocol } from './protocol';\nimport type { DeepAgentAttachTimingEvent } from './statewire-attach-observer';\nimport type { StatewireDiagnosticsRecorder } from './statewire-diagnostics';\nimport {\n  isDeepAgentStateHydrated,\n  pairDeepAgentStateWithThread,\n  readDeepAgentStreamValues,\n} from './statewire-state';\nimport { StatewireSuspended } from './statewire-suspended';\nimport {\n  DEEP_AGENT_STATEWIRE_PROTOCOL,\n  type StatewireTransportOptions,\n} from './statewire-transport';\nimport type { DeepAgentThreadPrewarmPool } from './thread-prewarm';\nimport { type DeepAgentThreadSnapshotCache, toThreadSnapshotSeed } from './thread-snapshot-cache';\nimport type { DeepAgentToolOutputStore } from './tool-outputs';\nimport type { DeepAgentWithdrawnTurns } from './withdrawn-turns';\nimport type {\n  DeepAgentConnectionState,\n  DeepAgentLaneProjection,\n  DeepAgentStreamValues,\n} from './types';\n\ntype ThreadOptions = StatewireThread.Options<DeepAgentStreamValues>;\n\nexport type { DeepAgentHeadersResolver } from './deep-agent-transport-recipe';\n\n/**\n * How an attach's FIRST frame is sourced, decided once per attach at mount: the\n * hello a pooled pre-dialed attach already replicated (`prewarm`), a remembered\n * snapshot seed (`snapshot`), or nothing (`none` — the thread loads until its\n * hello).\n */\nexport type DeepAgentAttachSource = 'prewarm' | 'snapshot' | 'none';\n\nexport interface UseDeepAgentThreadOptions {\n  threadId: string;\n  /** Base URL of the deep-agent statewire host (the `…/v2/threads` mount). */\n  baseUrl: string;\n  /** Transport selection: SSE when true, WebSocket otherwise. */\n  sse?: boolean;\n  /**\n   * Auth headers for the transport. Statewire passes `{ staleAuth: true }`\n   * when the previous credential was refused, so resolvers that can\n   * force-renew should honor it.\n   */\n  headers: DeepAgentHeadersResolver;\n  /**\n   * Statewire session store for reconnect command-session recovery (e.g. the\n   * mobile AsyncStorage-backed store). Host-resolved; omitted, sessions are\n   * process-local.\n   */\n  sessionStore?: StatewireTransportOptions['sessionStore'];\n  /**\n   * Mounted storage seams for the thread: `session` holds the lane identity and\n   * the commands still awaiting a durable verdict, so a reload resumes the lane\n   * instead of minting a new client (browser hosts pass `LocalStorageSession`\n   * from `@assistant-ui/react-statewire/local-storage`); `composer` persists the\n   * draft. Mutually exclusive with `sessionStore` — statewire refuses a session\n   * mounted twice.\n   */\n  storage?: ThreadOptions['storage'];\n  /** True only for a never-started local chat; existing empty threads still load until their snapshot. */\n  isNewChat?: boolean;\n  /**\n   * Extra transport-key discriminator for the SAME thread. The session is keyed\n   * by `threadId` alone by default; hosts that must re-read the server snapshot\n   * without a thread switch (a run dispatched outside this client, e.g. a\n   * backgrounded AOP run writing the thread's first messages) bump this to\n   * remount the session against the same URL.\n   */\n  attachKey?: string | number;\n  /**\n   * Host gate: park the transport instead of attaching — no socket, no retry\n   * loop. The thread element stays mounted so assistant-ui consumers keep\n   * rendering. Pass it when the host already knows every attach would be denied (e.g.\n   * the signed-in user has no workspace yet), so a locked-out tab does not\n   * hammer the attach endpoint on every backoff interval.\n   */\n  suspended?: { reason: string } | false;\n  /**\n   * Adapter capabilities the host UI exposes. Defaults preserve each client's\n   * pre-extraction surface — pass what the product mounts.\n   */\n  capabilities?: {\n    edit?: boolean;\n    continue?: boolean;\n    reload?: boolean;\n    unstable_switchBranch?: boolean;\n  };\n  /** Which run lanes project into the message tail; see {@link DeepAgentLaneProjection}. */\n  laneProjection?: DeepAgentLaneProjection;\n  /**\n   * The viewer, as the backend would stamp them (`metadata.custom.author`).\n   * Stamped onto this client's own optimistic bubbles — a send still in flight\n   * has no host `meta` yet — so a just-sent turn is attributed, and the\n   * multi-author avatar gate flips for a second poster, without waiting for\n   * the acknowledgment. Replicated entries carry the host's own stamp instead.\n   * Compared field-wise, so callers need not memoize the object.\n   */\n  selfAuthor?: DeepAgentMessageAuthor | null;\n  /**\n   * Snapshot host context when each user message is submitted, before it is\n   * journaled. Includes programmatic appends, keyboard sends, queued messages,\n   * steering, and edits. The async getter starts immediately at submission;\n   * sends retain their order while it resolves. Retries, queue text edits,\n   * lane moves, reload, and continue preserve the original association.\n   * Return JSON-serializable metadata; optional capture failures can\n   * return an explicit null field rather than blocking the message.\n   *\n   * Declared structurally rather than as `ThreadOptions['getMessageMetadata']`:\n   * the option is what the monorepo patches into\n   * `@assistant-ui/react-statewire@0.30.0`, and the published sources must also\n   * compile against the unpatched upstream typings, where the library does not\n   * know the option and ignores it.\n   */\n  getMessageMetadata?:\n    | (() => Record<string, unknown> | undefined | Promise<Record<string, unknown> | undefined>)\n    | undefined;\n  /** Host-owned adapters: attachments (upload/mention choreography), speech, feedback. */\n  adapters?: ThreadOptions['adapters'];\n  /**\n   * Transport lifecycle recorder (attach latency, reconnect loops, command\n   * settle fates, stale-auth renewals) fed from the hook's own seams. Pass one\n   * only when the host's diagnostics channel is enabled — the recorder is\n   * observed on hot paths, and an absent recorder costs a single optional call.\n   */\n  diagnostics?: StatewireDiagnosticsRecorder;\n  /**\n   * Per-tab LRU of the last wire state seen per thread. When set, every\n   * hydrated state the transport publishes is remembered, and a mount of a\n   * remembered thread seeds `initialState` from the cache (through\n   * {@link toThreadSnapshotSeed}) — the thread renders its last-known\n   * messages on the first frame instead of holding a loading treatment for\n   * the attach round-trip, and projects \"running\" when the run was live at\n   * capture (else \"ready\"). The attach snapshot then\n   * REPLACES the seeded state (statewire's `initialState` contract), so a\n   * thread that advanced elsewhere reconciles in one round-trip. New chats\n   * keep their preload and never read the cache.\n   */\n  snapshotCache?: DeepAgentThreadSnapshotCache;\n  /**\n   * The head window this surface wants: declared on every attach\n   * (`x-athena-deep-agent-window`, part of the transport recipe) so the hello\n   * of a client the host does not remember carries the newest `size`\n   * messages, and stated as `athena/interest` after the hello only when the\n   * hello's head is narrower — never to shrink it (the host holds what a\n   * viewer has loaded for the life of its connection). The resolved chain is\n   * joined with the mounted message documents into the converted transcript\n   * (see `message-window.ts`); older pages load through\n   * `useDeepAgentWindowSync`. Read once per attach.\n   */\n  messageWindow?: DeepAgentMessageWindowDeclaration;\n  /**\n   * Full tool outputs fetched back for the wire's cut tool messages\n   * (`history/tool_output`); the thread re-converts when one lands.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  /**\n   * User turns this client took back ahead of the wire (a user stop before\n   * any assistant output); the thread re-converts when one opens or closes.\n   */\n  withdrawnTurns?: DeepAgentWithdrawnTurns;\n  /**\n   * Pre-dialed attaches (see `thread-prewarm.ts`). When the pool holds a root\n   * for this thread at mount, the thread takes the hello it replicated as its\n   * seed — the transcript is the first frame — and dials its own attach\n   * against the instance the pool warmed; the pooled root is disposed in the\n   * same step, so one socket is live per thread after mount. Never seeded for\n   * a preloaded new chat or a suspended attach; such a root is discarded.\n   */\n  prewarmPool?: DeepAgentThreadPrewarmPool<DeepAgentStreamValues>;\n  /**\n   * Attach-path timing: socket open, hello size + handler cost, server retry\n   * hints — attributed to the attach's own thread, since a late event from the\n   * thread being left can land after the host has moved on.\n   */\n  onAttachTiming?: (info: { threadId: string; event: DeepAgentAttachTimingEvent }) => void;\n  /** Where this attach's first frame comes from; once per attach, at mount. */\n  onAttachSource?: (info: { threadId: string; source: DeepAgentAttachSource }) => void;\n  /** Full transport error policy (paywall, toast, telemetry) — client-owned. */\n  onError?: ThreadOptions['onError'];\n  /**\n   * Raw statewire state observer (first-attach latches, telemetry). The state\n   * argument is never `undefined`/`null`: passes where the wire has no\n   * snapshot yet (pre-attach, replay boundaries) deliver the typed\n   * `DEEP_AGENT_PRE_STREAM_STATE` default — `isDeepAgentStateHydrated`\n   * distinguishes them from a real (possibly empty) snapshot.\n   */\n  onStateChange?: ThreadOptions['onStateChange'];\n  /** Raw command-lifecycle observer (send-failure salvage, telemetry). */\n  onCommandChange?: ThreadOptions['onCommandChange'];\n  /** Raw connection observer (reconnect handles, telemetry). */\n  onRawConnectionChange?: ThreadOptions['onConnectionChange'];\n  /**\n   * Projected connection status changes, deduped per thread, with `null` on\n   * unmount so an indicator never shows a stale status.\n   */\n  onConnectionChange?: (connection: DeepAgentConnectionState | null) => void;\n  /** Notified when a run starts/stops so the page can reflect the running thread. */\n  onRunningChange?: (isRunning: boolean) => void;\n  /**\n   * Notified once per thread with the `runConfig` carried by the statewire\n   * snapshot (the backend's persisted panel config, seeded in `_load_history`),\n   * so the host can hydrate its config store from the thread. Notified with\n   * `null` (at most once per attach) when a server snapshot arrives WITHOUT a\n   * persisted config, so a host waiting on hydration can stop waiting; a\n   * config appearing on a later snapshot of the same attach (mirrored at run\n   * start) still delivers the config notification.\n   */\n  onServerRunConfig?: (config: Record<string, unknown> | null) => void;\n  /**\n   * Notified when the snapshot's `outOfBandRunActive` flag changes: the host set\n   * it while a run executing OUTSIDE this surface (an AOP / HTTP-route run)\n   * is actively writing the thread's bare-namespace history, which the host\n   * live-refreshes onto the wire. Lets the page show run-in-progress\n   * treatment instead of an empty conversation, and stand down its own\n   * re-attach polling. Change-notified per attach (an initial `false` before\n   * the snapshot stays silent), mirroring `onRunningChange`.\n   */\n  onOutOfBandRunActive?: (outOfBandRunActive: boolean) => void;\n  /**\n   * Notified with the state's session-asset lifecycle flag\n   * ({@link readSessionPersisted}) PAIRED with the thread it describes: `false`\n   * while the thread's `session` asset provably does not exist yet (a\n   * never-started chat's preload, a first run before the mint), `true` once\n   * minted, `null` when the state carries no flag (a host that predates it).\n   *\n   * Fired from the converter pass, so the pair is read from the state of the\n   * thread this attach was mounted for. A component reading the flag off the\n   * client store instead lags the mounted thread id by one render on a switch\n   * and can pair the new id with the previous thread's flag — releasing a\n   * session-scoped read for a row the backend has not minted. Change-notified\n   * per attach; the first pass of every attach notifies, so a host holding a\n   * read back until it hears from the mounted thread always does.\n   */\n  onSessionPersistedChange?: (event: {\n    threadId: string;\n    sessionPersisted: boolean | null;\n  }) => void;\n  /**\n   * Notified with the wire-contract status once the attach snapshot\n   * advertises the `protocol` lane, and again whenever it changes (a\n   * re-attach after a server roll can advertise a new `version`). Telemetry\n   * and per-version behaviour only: the host has no minimum client version,\n   * so nothing about the status gates a send. Never called for\n   * pre-declaration servers (their snapshots carry no lane) — absence of a\n   * call means \"no advertisement\", not \"compatible\".\n   */\n  onProtocolChange?: (status: DeepAgentProtocolStatus) => void;\n}\n\n/** One thread's replicated running state, keyed so a switch between two\n * threads with the same status still re-notifies (the host page clears its\n * per-thread state on selection, mirroring the connection dedupe below). */\nexport interface RunningSnapshot {\n  threadId: string;\n  isRunning: boolean;\n}\n\n/** Whether the thread's `session` asset exists, read off a statewire state, or\n * `null` when the state does not carry the flag.\n *\n * Absence is not absence of the asset: a snapshot from a host that predates\n * the flag has no such key, and reading that as \"the asset does not exist\"\n * would gate a read the client is entitled to make, with nothing left to\n * un-gate it. A new thread's preload seeds `false` (see `initialState`), so\n * the pre-attach pass of a chat that cannot have an asset yet still gates.\n *\n * Hosts pass this to `useStatewireState` so the flag and the thread it belongs\n * to are read in one component — a thread switch then cannot pair one thread's\n * id with the other's flag. */\nexport function readSessionPersisted(state: unknown): boolean | null {\n  const flag = (state as { sessionPersisted?: unknown } | null)?.sessionPersisted;\n  return typeof flag === 'boolean' ? flag : null;\n}\n\n/** Whether a converter pass must notify `onRunningChange`.\n *\n * The mount's very first status notifies only when it is `true` (a snapshot\n * carrying a live run) — an initial `false` before the snapshot must stay\n * silent so it cannot clear a still-valid indicator. After that, every\n * transition notifies, and so does the first status after a thread switch\n * (the host page clears its per-thread state on selection, so a switch\n * between two threads with the same status must still re-notify). */\nexport function shouldNotifyRunningChange(\n  previous: RunningSnapshot | null,\n  next: RunningSnapshot\n): boolean {\n  if (previous === null) return next.isRunning;\n  return previous.threadId !== next.threadId || previous.isRunning !== next.isRunning;\n}\n\n/** Whether two transcripts hold the very same message objects, in order. */\nfunction isSameMessageArray(\n  previous: readonly LangChainMessage[],\n  next: readonly LangChainMessage[]\n): boolean {\n  return (\n    previous.length === next.length && previous.every((message, index) => message === next[index])\n  );\n}\n\n/**\n * The shared deep-agent Statewire thread.\n *\n * `StatewireThread` (from `@assistant-ui/react-statewire`) attaches to the\n * agora-hosted thread at `${baseUrl}/${threadId}` (WebSocket by default,\n * with SSE retained only as a host-selected compatibility switch): the backend\n * hosts the thread state and this client\n * replicates it live, so the server snapshot is the single source of history\n * (no local import, no `/status` resume probing) and run scheduling — queueing,\n * steering, stop, edit rewinds — rides the built-in `run/*` commands.\n *\n * The thread element is keyed by `threadId`, so a thread switch remounts the\n * session against the new URL instead of importing history in place.\n *\n * Returns the thread element for the host's own `useAui({ thread })` — web\n * hosts take `useAui` from `@assistant-ui/react`, React Native hosts from\n * `@assistant-ui/react-native`; this package imports neither.\n */\nexport function useDeepAgentThread({\n  threadId,\n  baseUrl,\n  sse = false,\n  headers,\n  sessionStore,\n  storage,\n  isNewChat = false,\n  attachKey,\n  suspended = false,\n  capabilities,\n  laneProjection = 'both',\n  selfAuthor = null,\n  getMessageMetadata,\n  adapters,\n  diagnostics,\n  snapshotCache,\n  messageWindow,\n  toolOutputs,\n  withdrawnTurns,\n  prewarmPool,\n  onAttachTiming,\n  onAttachSource,\n  onError,\n  onStateChange,\n  onCommandChange,\n  onRawConnectionChange,\n  onConnectionChange,\n  onRunningChange,\n  onServerRunConfig,\n  onOutOfBandRunActive,\n  onSessionPersistedChange,\n  onProtocolChange,\n}: UseDeepAgentThreadOptions) {\n  const onRunningChangeRef = useRef(onRunningChange);\n  onRunningChangeRef.current = onRunningChange;\n  const onSessionPersistedChangeRef = useRef(onSessionPersistedChange);\n  onSessionPersistedChangeRef.current = onSessionPersistedChange;\n  const onConnectionChangeRef = useRef(onConnectionChange);\n  onConnectionChangeRef.current = onConnectionChange;\n  const onServerRunConfigRef = useRef(onServerRunConfig);\n  onServerRunConfigRef.current = onServerRunConfig;\n  const onOutOfBandRunActiveRef = useRef(onOutOfBandRunActive);\n  onOutOfBandRunActiveRef.current = onOutOfBandRunActive;\n  const onProtocolChangeRef = useRef(onProtocolChange);\n  onProtocolChangeRef.current = onProtocolChange;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  const onStateChangeRef = useRef(onStateChange);\n  onStateChangeRef.current = onStateChange;\n  const onCommandChangeRef = useRef(onCommandChange);\n  onCommandChangeRef.current = onCommandChange;\n  const onRawConnectionChangeRef = useRef(onRawConnectionChange);\n  onRawConnectionChangeRef.current = onRawConnectionChange;\n  const headersRef = useRef(headers);\n  headersRef.current = headers;\n  const messageWindowRef = useRef(messageWindow);\n  messageWindowRef.current = messageWindow;\n  // The head interest is checked once per connected session, after the hello\n  // negotiated the lane (a statement before that would be minted durable):\n  // the hello carries the host's head — the attach header's size, or what\n  // this client id held — and a set goes out only to widen it.\n  const interestRef = useRef({ attachId: '', stated: false });\n  // The last joined transcript, held across the gap between a hello and its\n  // interest answer (and across a reconnect) so the thread never blanks.\n  const lastMessagesRef = useRef<{ attachId: string; messages: LangChainMessage[] } | null>(null);\n  // A fetched tool output must re-run the converter (the store is read inside\n  // it); the version is the memo's signal that the store's contents moved.\n  const [toolOutputsVersion, setToolOutputsVersion] = useState(0);\n  useEffect(() => {\n    if (!toolOutputs) return undefined;\n    return toolOutputs.subscribe(() => setToolOutputsVersion((version) => version + 1));\n  }, [toolOutputs]);\n  const [withdrawnTurnsVersion, setWithdrawnTurnsVersion] = useState(0);\n  useEffect(() => {\n    if (!withdrawnTurns) return undefined;\n    return withdrawnTurns.subscribe(() => setWithdrawnTurnsVersion((version) => version + 1));\n  }, [withdrawnTurns]);\n  const diagnosticsRef = useRef(diagnostics);\n  diagnosticsRef.current = diagnostics;\n  const onAttachTimingRef = useRef(onAttachTiming);\n  onAttachTimingRef.current = onAttachTiming;\n  const onAttachSourceRef = useRef(onAttachSource);\n  onAttachSourceRef.current = onAttachSource;\n\n  const lastRunningRef = useRef<RunningSnapshot | null>(null);\n  // Out-of-band run activity (`outOfBandRunActive`), change-notified with the\n  // same semantics as the running flag above.\n  const lastOutOfBandRunActiveRef = useRef<RunningSnapshot | null>(null);\n  // The session-asset lifecycle flag last notified, keyed by attach so every\n  // attach's first pass notifies (a host holding a read back until it hears\n  // from the mounted thread must always hear from it).\n  const lastSessionPersistedRef = useRef<{\n    attachId: string;\n    threadId: string;\n    sessionPersisted: boolean | null;\n  } | null>(null);\n  // The last wire-contract status notified, keyed by attach so a re-attach\n  // re-notifies (the new snapshot may advertise a different version).\n  // `status: null` = nothing advertised yet on this attach.\n  const lastProtocolRef = useRef<{\n    attachId: string;\n    status: DeepAgentProtocolStatus | null;\n  } | null>(null);\n  // The thread whose statewire-carried runConfig has been surfaced to the host\n  // (once per thread; later snapshots must not clobber edits).\n  const appliedStateRunConfigThreadRef = useRef<string | null>(null);\n  // The attach that already notified `onServerRunConfig(null)` (snapshot\n  // arrived carrying no persisted config) — at most once per attach.\n  const absentStateRunConfigAttachRef = useRef<string | null>(null);\n  // Live thread id for the callbacks: they are created per render but may\n  // settle after a switch, so they compare against the current id.\n  const threadIdRef = useRef(threadId);\n  threadIdRef.current = threadId;\n  // Identity of the current attach. Every per-thread latch keys off this, so a\n  // re-attach of the same thread (a bumped `attachKey`) re-notifies the host\n  // exactly like a switch would — the host clears its per-thread state on\n  // re-attach, so a snapshot that repeats the previous status must not dedupe.\n  const attachId: string = attachKey === undefined ? threadId : `${threadId}:${attachKey}`;\n  const attachIdRef = useRef(attachId);\n  attachIdRef.current = attachId;\n\n  // Auth-denial park: the server fins every denied attach `unauthorized` and\n  // the reconnect loop would otherwise retry it every 30s forever (prod tabs\n  // looped for hours against revoked/workspace-less credentials). After a\n  // streak of denials the live transport is swapped for a parked one; a new\n  // attach (thread switch, bumped attachKey) or the parked connection's\n  // `reconnect()` re-arms it.\n  const [authParked, setAuthParked] = useState<{\n    attachId: string;\n    message: string | undefined;\n  } | null>(null);\n  const authDenialRef = useRef<{ attachId: string; state: AuthDenialTrackerState }>({\n    attachId,\n    state: initialAuthDenialTrackerState(),\n  });\n  useEffect(() => {\n    setAuthParked((prev) => (prev !== null && prev.attachId !== attachId ? null : prev));\n  }, [attachId]);\n\n  // Field-wise stable identity for the viewer stamp, so a host that rebuilds\n  // the author object per render does not rebuild the converter (and with it\n  // every message) per render. Adjusting state during render is React's\n  // sanctioned derived-state pattern: it re-renders once with the new value.\n  const [stableSelfAuthor, setStableSelfAuthor] = useState(selfAuthor);\n  if (!isSameMessageAuthor(stableSelfAuthor, selfAuthor)) setStableSelfAuthor(selfAuthor);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: toolOutputsVersion / withdrawnTurnsVersion are the stores' change signals — the converter reads the stores' contents, not the counters.\n  const converter = useMemo(\n    () => (state: unknown, isRunning: boolean, conversionCache: DeepAgentMessageConversionCache) => {\n      // Statewire snapshots carry the thread's persisted panel config (the\n      // backend seeds `runConfig` in `_load_history` and mirrors it on run\n      // start). Surface it once per thread so the host can hydrate its config\n      // store.\n      const stateRunConfig = (state as { runConfig?: unknown } | null)?.runConfig;\n      if (\n        stateRunConfig &&\n        typeof stateRunConfig === 'object' &&\n        !Array.isArray(stateRunConfig) &&\n        appliedStateRunConfigThreadRef.current !== attachIdRef.current\n      ) {\n        appliedStateRunConfigThreadRef.current = attachIdRef.current;\n        const notifyRunConfig = onServerRunConfigRef.current;\n        if (notifyRunConfig) {\n          queueMicrotask(() => notifyRunConfig(stateRunConfig as Record<string, unknown>));\n        }\n      } else if (\n        !stateRunConfig &&\n        appliedStateRunConfigThreadRef.current !== attachIdRef.current &&\n        absentStateRunConfigAttachRef.current !== attachIdRef.current &&\n        projectDeepAgentProtocol(state) !== null\n      ) {\n        // No persisted config on a SERVER state: the protocol lane rides every\n        // attach snapshot, so its presence distinguishes \"the server answered\n        // without a config\" from the pre-attach `initialState` (which must not\n        // end the host's hydration wait).\n        absentStateRunConfigAttachRef.current = attachIdRef.current;\n        const notifyRunConfig = onServerRunConfigRef.current;\n        if (notifyRunConfig) {\n          queueMicrotask(() => notifyRunConfig(null));\n        }\n      }\n      // Out-of-band run activity: the host live-refreshes a bare-namespace\n      // (AOP / HTTP-route) thread's transcript while its run is active and\n      // flags the wire state so the page can reflect it.\n      const stateOutOfBandRunActive =\n        (state as { outOfBandRunActive?: unknown } | null)?.outOfBandRunActive === true;\n      const outOfBandRunActiveSnapshot = {\n        threadId: attachIdRef.current,\n        isRunning: stateOutOfBandRunActive,\n      };\n      if (shouldNotifyRunningChange(lastOutOfBandRunActiveRef.current, outOfBandRunActiveSnapshot)) {\n        lastOutOfBandRunActiveRef.current = outOfBandRunActiveSnapshot;\n        const observedAttachId = attachIdRef.current;\n        queueMicrotask(() => {\n          // A re-attach or newer snapshot between the converter pass and this\n          // microtask owns the channel now — a stale flag must not leak into\n          // the new attach's per-thread state.\n          if (\n            attachIdRef.current !== observedAttachId ||\n            lastOutOfBandRunActiveRef.current !== outOfBandRunActiveSnapshot\n          ) {\n            return;\n          }\n          onOutOfBandRunActiveRef.current?.(stateOutOfBandRunActive);\n        });\n      }\n      // Wire-contract advertisement: the host publishes the `protocol` lane in\n      // every attach snapshot. Notify on first advertisement and on change\n      // (dedupe by value, re-keyed per attach), with the same stale-guard\n      // microtask as the other observers.\n      const protocolStatus = projectDeepAgentProtocol(state);\n      if (protocolStatus !== null) {\n        const previous =\n          lastProtocolRef.current?.attachId === attachIdRef.current\n            ? lastProtocolRef.current.status\n            : null;\n        if (previous === null || previous.protocolVersion !== protocolStatus.protocolVersion) {\n          const update = { attachId: attachIdRef.current, status: protocolStatus };\n          lastProtocolRef.current = update;\n          queueMicrotask(() => {\n            if (lastProtocolRef.current !== update || attachIdRef.current !== update.attachId) {\n              return;\n            }\n            onProtocolChangeRef.current?.(protocolStatus);\n          });\n        }\n      }\n      const runningSnapshot = { threadId: attachIdRef.current, isRunning };\n      if (shouldNotifyRunningChange(lastRunningRef.current, runningSnapshot)) {\n        lastRunningRef.current = runningSnapshot;\n        const notify = onRunningChangeRef.current;\n        if (notify) queueMicrotask(() => notify(isRunning));\n      }\n      return {\n        ...convertDeepAgentState(state, {\n          laneProjection,\n          selfAuthor: stableSelfAuthor,\n          toolOutputs,\n          withdrawnTurns,\n          conversionCache,\n        }),\n        state: state as StatewireThread.State['state'],\n      };\n    },\n    [\n      laneProjection,\n      stableSelfAuthor,\n      toolOutputs,\n      toolOutputsVersion,\n      withdrawnTurns,\n      withdrawnTurnsVersion,\n    ]\n  );\n  const materialize = useMemo(\n    () => createDeepAgentMaterialize({ selfAuthor: stableSelfAuthor }),\n    [stableSelfAuthor]\n  );\n\n  // Surface the statewire connection status through `onConnectionChange` (the\n  // converter re-runs on connection changes), and clear it when the runtime\n  // unmounts so an indicator never shows a stale status. Dedup is keyed by\n  // thread: the runtime stays mounted across idle thread switches, so the new\n  // thread's first status must notify even when it equals the previous\n  // thread's last one.\n  const lastConnectionRef = useRef<{\n    threadId: string;\n    connection: DeepAgentConnectionState;\n  } | null>(null);\n  useEffect(\n    () => () => {\n      lastConnectionRef.current = null;\n      onConnectionChangeRef.current?.(null);\n    },\n    []\n  );\n\n  // The preload decision pins at thread entry: `isNewChat` flips once the\n  // thread persists, but the mount that began as a new thread stays preloaded.\n  const preloadRef = useRef({ threadId, preload: isNewChat });\n  if (preloadRef.current.threadId !== threadId)\n    preloadRef.current = { threadId, preload: isNewChat };\n\n  const snapshotCacheRef = useRef(snapshotCache);\n  snapshotCacheRef.current = snapshotCache;\n  // The snapshot seed pins at attach identity, like the preload decision: the\n  // cache is read once per mount, so a mid-session cache write (this thread's\n  // own states being remembered) never changes what `initialState` was.\n  //\n  // A suspended attach never seeds: the suspended transport never dials, so a\n  // seed would be served indefinitely — under a view-as lens that would paint\n  // thread content the parked transport exists to withhold (the lens must\n  // show what the LENSED identity is authorized to see, and only the server\n  // can decide that).\n  //\n  // The pooled hello is taken the same way: exactly once, at the attach's\n  // first render (the pool disposes its root in that step).\n  const snapshotSeedRef = useRef<{\n    attachId: string;\n    seed: DeepAgentStreamValues | undefined;\n  } | null>(null);\n  if (snapshotSeedRef.current === null || snapshotSeedRef.current.attachId !== attachId) {\n    const preload = preloadRef.current.preload;\n    let pooledState: DeepAgentStreamValues | undefined;\n    if (prewarmPool?.has(threadId)) {\n      if (preload || suspended) {\n        // This mount attaches on its own terms (or not at all): the pooled\n        // dial must not linger as a second socket to the same session.\n        prewarmPool.discard(threadId);\n      } else {\n        pooledState = prewarmPool.take(threadId)?.state;\n      }\n    }\n    // The pooled hello outranks a remembered snapshot (it is newer by\n    // construction); a pooled dial that had not landed seeds like a plain\n    // attach and reconciles when this attach's own hello lands.\n    const remembered =\n      preload || suspended ? undefined : (pooledState ?? snapshotCache?.take(threadId));\n    const seed = remembered ? toThreadSnapshotSeed(remembered) : undefined;\n    snapshotSeedRef.current = { attachId, seed };\n    const source: DeepAgentAttachSource =\n      pooledState !== undefined ? 'prewarm' : seed ? 'snapshot' : 'none';\n    const notifySource = onAttachSourceRef.current;\n    if (notifySource) queueMicrotask(() => notifySource({ threadId, source }));\n  }\n\n  // The conversion memory pins at attach identity like the snapshot seed: an\n  // unchanged message converts to the identical thread message on every pass\n  // of this attach, and a switch or re-attach starts from an empty memory, so\n  // one thread's converted messages can never be served for another.\n  const conversionCacheRef = useRef<{\n    attachId: string;\n    cache: DeepAgentMessageConversionCache;\n  } | null>(null);\n  if (conversionCacheRef.current === null || conversionCacheRef.current.attachId !== attachId) {\n    conversionCacheRef.current = { attachId, cache: createDeepAgentMessageConversionCache() };\n  }\n  const conversionCache = conversionCacheRef.current.cache;\n  // The last pass's joined transcript, reused when a packet moved no message\n  // (a run-status flip, a todo, another document) so readers memoized on\n  // `state.messages` skip that pass.\n  const lastStateMessagesRef = useRef<{ attachId: string; messages: LangChainMessage[] } | null>(\n    null\n  );\n\n  // react-statewire memoizes the converted thread on this function's\n  // identity, so an inline closure would re-run `convertDeepAgentState` over\n  // the whole transcript on every host render. Keyed on the attach identity (a\n  // re-attach re-keys its per-thread latches); everything else the body needs\n  // is read through the per-render refs above.\n  const threadConverter = useCallback<ThreadOptions['converter']>(\n    (wireState, meta) => {\n      // The wire main document carries no messages: join the interest window\n      // off the mounted documents, fold the dispatch record onto it, and hand\n      // the composite on as the thread state every reader sees.\n      const values = readDeepAgentStreamValues(wireState);\n      const window = readDeepAgentMessageWindow(meta.mounted);\n      const held =\n        lastMessagesRef.current?.attachId === attachId ? lastMessagesRef.current.messages : null;\n      const messages = window?.messages ?? values.messages ?? held ?? [];\n      if (window !== null || messages.length > 0) lastMessagesRef.current = { attachId, messages };\n      const state: DeepAgentStreamValues = { ...values, messages: [...messages] };\n      // Every state this attach publishes names its thread, so a binding\n      // mounted for the next thread can tell this state apart from its own\n      // for the render it is still projected after a switch.\n      pairDeepAgentStateWithThread({ state, threadId });\n      materialize(state);\n      const joined: LangChainMessage[] = state.messages ?? [];\n      const previousJoined = lastStateMessagesRef.current;\n      if (\n        previousJoined !== null &&\n        previousJoined.attachId === attachId &&\n        isSameMessageArray(previousJoined.messages, joined)\n      ) {\n        state.messages = previousJoined.messages;\n      } else {\n        lastStateMessagesRef.current = { attachId, messages: joined };\n      }\n      if (window !== null && isDeepAgentStateHydrated(values)) {\n        snapshotCacheRef.current?.remember(threadId, state);\n      }\n      if (interestRef.current.attachId !== attachId) {\n        interestRef.current = { attachId, stated: false };\n      }\n      if (meta.connection.status !== 'connected') {\n        interestRef.current.stated = false;\n      } else if (!interestRef.current.stated) {\n        interestRef.current.stated = true;\n        const wanted = headInterestRequest(messageWindowRef.current?.size);\n        const head = window?.requests[0];\n        // The hello's head is kept whenever it is at least what this surface\n        // wants (a remembered client's wider view, the declared header):\n        // stating a narrower head would shrink what the viewer holds. A\n        // narrower head — or none, a host without the lane — is widened, the\n        // hello's pages kept alongside.\n        const preloaded = head !== undefined && head.at === undefined && head.before >= wanted.before;\n        if (!preloaded) {\n          const requests = [\n            wanted,\n            ...(window?.requests.filter((request) => request.at !== undefined) ?? []),\n          ];\n          queueMicrotask(() => {\n            if (attachIdRef.current !== attachId) return;\n            meta\n              .invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [requests])\n              .catch((error: unknown) => {\n                onErrorRef.current?.(error instanceof Error ? error : new Error(String(error)));\n              });\n          });\n        }\n      }\n      // Projected once per pass through the single seam; every fold below\n      // consumes the projection (the recorder projects the raw connection\n      // itself, so any host observer can feed it).\n      const connection = projectDeepAgentConnection(meta.connection);\n      // Transition-deduped inside the recorder, so this per-pass observation\n      // is free while the connection is unchanged.\n      diagnosticsRef.current?.observeConnection(meta.connection);\n      // Fold this pass's connection into the denial streak (the converter\n      // re-runs on every reconnect-attempt bump). Parking is deferred to a\n      // microtask like every other notification here.\n      if (authDenialRef.current.attachId !== attachIdRef.current) {\n        authDenialRef.current = {\n          attachId: attachIdRef.current,\n          state: initialAuthDenialTrackerState(),\n        };\n      }\n      const denial = observeAuthDenial(authDenialRef.current.state, connection);\n      authDenialRef.current.state = denial.state;\n      if (denial.park) {\n        const parkAttachId = attachIdRef.current;\n        const parkMessage = denial.state.message;\n        // The server refused authorization for this thread: any remembered\n        // snapshot must not warm-paint it on a later mount (permissions may\n        // have been revoked since the state was captured).\n        snapshotCacheRef.current?.forget(threadId);\n        queueMicrotask(() => {\n          if (attachIdRef.current !== parkAttachId) return;\n          setAuthParked((prev) =>\n            prev?.attachId === parkAttachId\n              ? prev\n              : { attachId: parkAttachId, message: parkMessage }\n          );\n        });\n      }\n      const previous = lastConnectionRef.current;\n      if (\n        previous?.threadId !== attachId ||\n        !Object.keys({ ...previous.connection, ...connection }).every(\n          (key) => Reflect.get(previous.connection, key) === Reflect.get(connection, key)\n        )\n      ) {\n        const update = { threadId: attachId, connection };\n        lastConnectionRef.current = update;\n        queueMicrotask(() => {\n          // A newer projection, a thread switch, or the unmount cleanup owns\n          // the channel now.\n          if (lastConnectionRef.current !== update || attachIdRef.current !== attachId) return;\n          onConnectionChangeRef.current?.(connection);\n        });\n      }\n      // Session-asset lifecycle, paired with THIS attach's thread by closure:\n      // the state converted here is the state of the thread the element was\n      // built for, so the pair can never straddle a switch (a client-store\n      // read would). Deduped by value per attach. A pass from an attach the\n      // host has already replaced never touches the latch — it could otherwise\n      // cancel the current attach's still-queued verdict — and the microtask\n      // guard drops a pass whose attach is replaced before it settles.\n      if (attachIdRef.current === attachId) {\n        const sessionPersisted = readSessionPersisted(state);\n        const lastSession = lastSessionPersistedRef.current;\n        if (\n          lastSession?.attachId !== attachId ||\n          lastSession.sessionPersisted !== sessionPersisted\n        ) {\n          const sessionUpdate = { attachId, threadId, sessionPersisted };\n          lastSessionPersistedRef.current = sessionUpdate;\n          queueMicrotask(() => {\n            if (\n              lastSessionPersistedRef.current !== sessionUpdate ||\n              attachIdRef.current !== attachId\n            ) {\n              return;\n            }\n            onSessionPersistedChangeRef.current?.({ threadId, sessionPersisted });\n          });\n        }\n      }\n      // The replicated run status IS the running signal: the lib's run-dialect\n      // fold flips it to \"running\" on the send, before the app converter runs,\n      // so the optimistic window needs no hand-tracked flag.\n      return converter(state, state.runs?.[0]?.status === 'running', conversionCache);\n    },\n    [attachId, conversionCache, converter, materialize, threadId]\n  );\n\n  return StatewireThread<DeepAgentStreamValues>({\n    // The transport stamps this protocol on every command; the thread client\n    // must declare it too or the core skips the optimistic folds and a send\n    // stays invisible until the server frame lands.\n    protocol: DEEP_AGENT_STATEWIRE_PROTOCOL,\n    // New threads preload an empty runs mount and report `deferred` — the\n    // composer is interactive before the stream attaches and pre-attach sends\n    // render through the optimistic folds. Existing threads omit the runs\n    // mount and project \"loading\" until the attach snapshot: the server seeds\n    // messages/todos/runConfig in `_load_history`.\n    //\n    // The preload also seeds `sessionPersisted: false`: a never-started chat\n    // provably has no `session` asset until its first run mints one, so the\n    // wire carries that from the first render and a host reading the flag off\n    // the state needs no separate \"is this a new chat\" knowledge. An existing\n    // thread leaves it absent (unknown) so its asset read is never gated.\n    initialState:\n      snapshotSeedRef.current.seed ??\n      ({\n        messages: [],\n        todos: [],\n        ...(preloadRef.current.preload && { runs: [], sessionPersisted: false }),\n      } satisfies DeepAgentStreamValues),\n    // Keyed by thread: a switch unmounts the previous thread's session and\n    // remounts against the new URL, so the converter never sees the previous\n    // thread's snapshot (a new thread serves its preload again, an existing\n    // one loads until its snapshot). A host-suspended or auth-parked attach\n    // swaps in the never-dialing transport instead.\n    transport: withKey(\n      attachId,\n      (() => {\n        if (suspended) return StatewireSuspended({ message: suspended.reason });\n        if (authParked !== null && authParked.attachId === attachId) {\n          return StatewireSuspended({\n            message: authParked.message ?? 'Session authorization was refused.',\n            onReconnectRequested: () => {\n              authDenialRef.current = {\n                attachId: attachIdRef.current,\n                state: initialAuthDenialTrackerState(),\n              };\n              setAuthParked(null);\n            },\n          });\n        }\n        // The shared recipe (URL, auth + wire-contract headers, session lane,\n        // attach instrumentation, retry-hint floor) — the same one the prewarm\n        // pool dials with, so the instance a pooled attach warmed is the one\n        // this dial reaches. A never-started chat dials nothing until its\n        // first send.\n        return createDeepAgentAttachTransport<DeepAgentStreamValues>({\n          baseUrl,\n          threadId,\n          sse,\n          isNew: preloadRef.current.preload,\n          headers: (ctx) => headersRef.current(ctx),\n          messageWindow: messageWindowRef.current,\n          sessionStore,\n          onAuthResolve: (ctx) => diagnosticsRef.current?.observeAuthResolve(ctx),\n          onAttachTiming: (event) => onAttachTimingRef.current?.({ threadId, event }),\n        });\n      })()\n    ),\n    // Survives the transport remounts above: a bumped attachKey re-attaches the\n    // same lane, and a persistent session storage carries it across reloads.\n    ...(storage && { storage }),\n    // The run subsystem (status, lanes, input requests, runId) is mounted on\n    // the state root and always replicated by react-statewire >= 0.14 (the\n    // former `runs: true` opt-in is gone) — the converter only maps app-owned\n    // keys, including the `run/stop` runId stamp the lib projects itself.\n    converter: threadConverter,\n    // Native message editing: an edited turn is resubmitted as a `run/edit`\n    // command, and the deep-agent backend rewinds the checkpointed thread to\n    // the edited message's parent before appending (route `plan_rewind`).\n    capabilities: capabilities ?? { edit: true },\n    ...(getMessageMetadata && { getMessageMetadata }),\n    ...(adapters && { adapters }),\n    contextSync: 'command-send',\n    // The Stop control is the only `cancelRun()` caller — teardown paths\n    // unmount the keyed transport instead — so every `run/stop` is a\n    // deliberate user stop.\n    stopPayload: () => ({ reason: 'user_stop' }),\n    onError: (error) => {\n      diagnosticsRef.current?.observeError(error);\n      onErrorRef.current?.(error);\n    },\n    ...(onStateChange && {\n      // The lib types the observed state `NonNullable`, but the runtime\n      // delivers `undefined` where the wire has no snapshot (pre-attach and\n      // replay boundaries republish it) — normalize so the type is true and\n      // host observers never crash on a field read.\n      onStateChange: ((state, ctx) => {\n        onStateChangeRef.current?.(readDeepAgentStreamValues(state), ctx);\n      }) satisfies ThreadOptions['onStateChange'],\n    }),\n    ...((onCommandChange || diagnostics) && {\n      onCommandChange: ((update, ctx) => {\n        diagnosticsRef.current?.observeCommand(update);\n        onCommandChangeRef.current?.(update, ctx);\n      }) satisfies ThreadOptions['onCommandChange'],\n    }),\n    ...(onRawConnectionChange && {\n      onConnectionChange: ((connection) =>\n        onRawConnectionChangeRef.current?.(\n          connection\n        )) satisfies ThreadOptions['onConnectionChange'],\n    }),\n  });\n}\n"],"names":["conversionCache","_a"],"mappings":"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"}

package/dist/agent-runtime/src/use-deep-agent-window-sync.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-window-sync.cjs","sources":["../../../../agent-runtime/src/use-deep-agent-window-sync.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { DEEP_AGENT_INTEREST_PROTOCOL } from './generated/runconfig-contract';\nimport {\n  buildToolOutputCommand,\n  type DeepAgentInterestRequest,\n  type DeepAgentMessageWindow,\n  interestsCovered,\n  pageInterestRequests,\n  readDeepAgentMessageWindow,\n  readToolOutputResult,\n  readTruncatedToolOutputArtifact,\n} from './message-window';\nimport { hasStatewireThreadExtras } from './thread-extras';\nimport type { DeepAgentToolOutputStore } from './tool-outputs';\n\n/**\n * Pages of older history chained per approach to the top. A renderer lowers\n * its near-top level once prepended content has pushed the first message out\n * of its band; this bounds the case where it cannot (no viewport to scroll,\n * a list too short to overflow) so a 2,000-message thread never streams whole.\n */\nexport const DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS = 3;\n\n/**\n * Pages of older history that add no converted message — every message on\n * them folds into the first loaded turn, such as one agent run's hundreds of\n * tool steps — loaded on top of a request (or an approach's chain) before it\n * stops. Such a page changes nothing the user can see, so it neither answers\n * an ask nor counts against the per-approach chain.\n */\nexport const DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS = 25;\n\n/** The converted thread messages the tool-output half scans (web and native `ThreadMessage` both satisfy it). */\nexport interface DeepAgentWindowSyncMessage {\n  readonly id: string;\n  /** The converted role; lets the opening fill tell a turn's prompt from its reply. */\n  readonly role?: string;\n  readonly content: readonly { readonly type: string; readonly artifact?: unknown }[];\n}\n\n/** One page interest round trip, for the host's telemetry. */\nexport interface DeepAgentHistoryLoadEvent {\n  /** The page's ordinal (`1` extends the head). */\n  page: number;\n  request: DeepAgentInterestRequest;\n  durationMs: number;\n}\n\nexport interface UseDeepAgentWindowSyncOptions {\n  /**\n   * The converted thread messages — read by the host through its platform\n   * `useAuiState((s) => s.thread.messages)`, so this hook imports neither\n   * `@assistant-ui/react` nor `@assistant-ui/react-native`.\n   */\n  messages: readonly DeepAgentWindowSyncMessage[];\n  /** Messages per page; the thread's window size by default. */\n  pageSize?: number;\n  /**\n   * Full tool outputs fetched back for cut tool messages; the same store the\n   * thread converts with (`useDeepAgentThread({ toolOutputs })`). Omitted, the\n   * tool-output half is inert (a surface that never shows a cut output whole).\n   */\n  toolOutputs?: DeepAgentToolOutputStore | undefined;\n  /**\n   * The renderer's report that the top of the LOADED history is near — a\n   * level, not an edge: while it holds and older messages exist, pages load\n   * one after another (bounded by `maxChainedLoads` per approach). Omitted for\n   * hosts with only a manual affordance (`loadOlder`).\n   */\n  nearTop?: boolean;\n  /** Bumped on every rise of `nearTop` (and every explicit request), so the chain bound is per approach. */\n  nearTopEpoch?: number;\n  /**\n   * Whether a message's content is mounted right now, so lazy fetches (cut\n   * tool outputs) target what the user can see rather than the whole loaded\n   * history. Omitted: every message counts as mounted (the flat renderers).\n   */\n  isMessageMounted?: ((messageId: string) => boolean) | undefined;\n  maxChainedLoads?: number;\n  /** Pages adding no converted message loaded per request before it stops; see {@link DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS}. */\n  maxUnseenLoads?: number;\n  /** A page interest resolved (telemetry). */\n  onHistoryLoad?: ((event: DeepAgentHistoryLoadEvent) => void) | undefined;\n  /** A read failed; the sync itself recovers (the pending marks are released). */\n  onError?: ((error: unknown, command: 'athena/interest' | 'history/tool_output') => void) | undefined;\n  now?: () => number;\n}\n\nexport interface DeepAgentWindowSyncState {\n  /** The joined window, or `null` while the head interest has not resolved (both halves are inert). */\n  window: DeepAgentMessageWindow | null;\n  /** Whether the host holds messages older than the loaded window. */\n  hasOlder: boolean;\n  /**\n   * Whether the next page can be asked for: older messages exist and the\n   * host's interest cap has room for them. `hasOlder && !canLoadOlder` is the\n   * depth limit (`MAX_INTERESTS × MAX_MESSAGE_WINDOW` messages loaded in one\n   * connection) — an edge row says so instead of offering a dead button.\n   */\n  canLoadOlder: boolean;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  /** Ask for the next page of older history now (an edge row's button, a keypress). A no-op before the head resolved or at the beginning. */\n  loadOlder: () => void;\n}\n\nconst everyMessageMounted = (): boolean => true;\nconst defaultNow = (): number => Date.now();\nconst noopSubscribe = () => () => {};\n\n/** The statewire extras of the nearest aui thread; throws on a non-statewire thread like the library's own hooks. */\nconst useStatewireExtras = (): StatewireThread.Extras =>\n  useAuiState((s) => {\n    if (!hasStatewireThreadExtras(s.thread.extras)) {\n      throw new Error('useDeepAgentWindowSync requires a statewire thread');\n    }\n    return s.thread.extras as StatewireThread.Extras;\n  });\n\n/** The joined interest window of the nearest statewire thread. */\nexport function useDeepAgentMessageWindow(): DeepAgentMessageWindow | null {\n  const documents = useStatewireExtras().documents;\n  const mounted = useSyncExternalStore(\n    documents?.subscribe ?? noopSubscribe,\n    () => documents?.list(),\n    () => documents?.list()\n  );\n  return useMemo(() => readDeepAgentMessageWindow(mounted), [mounted]);\n}\n\n/**\n * The client half of the interest window, shared by every surface — mounted\n * once per runtime, inside its aui provider.\n *\n * - **Older history.** While the host renderer reports the top of the loaded\n *   history near (`nearTop`) and the window says older messages exist, this\n *   re-states the interests with one more page (anchored at the window's\n *   first message) — the host mounts its documents for this client alone —\n *   chaining at most `maxChainedLoads` pages per approach; `loadOlder` asks\n *   for one page on demand (an edge row's button). Never two loads in flight.\n *   A reconnect whose hello does not carry the interests this mount last\n *   stated (the host remembers a client id's view across its attaches; a new\n *   host instance does not) re-states them.\n * - **Cut tool outputs.** Tool cards whose output the wire carried cut\n *   (`artifact._athena_content_truncated`) get it fetched whole through\n *   `history/tool_output` once their message is mounted; the converter puts\n *   it back (`toolOutputs`), so the card re-renders complete. An output the\n *   host replaced since (the marker's `chars` changed) is fetched again.\n */\n/**\n * Whether an older page put a new converted message ahead of the thread's\n * first one. Older history only ever merges into or lands before the first\n * converted message, so the second one is a stable landmark: it moved down iff\n * the page showed something. A new tail message does not move it. Without a\n * second message (or once it is gone) the converted count decides.\n */\nfunction pageShowedEarlierMessage(\n  from: { count: number; secondId: string | undefined },\n  messages: readonly DeepAgentWindowSyncMessage[]\n): boolean {\n  if (from.secondId !== undefined) {\n    const index = messages.findIndex((message) => message.id === from.secondId);\n    if (index !== -1) return index > 1;\n  }\n  return messages.length > from.count;\n}\n\n/**\n * Whether the loaded thread still opens without context: it should open on a\n * prompt and hold at least one earlier turn, so the newest turn shows with the\n * one before it (a turn is a prompt followed by its reply). Queued and live\n * prompts land at the tail with no reply yet, so they never count; prompts\n * alone need nothing. Without roles, a lone converted message stands in for it.\n */\nfunction opensMidTurn(messages: readonly DeepAgentWindowSyncMessage[]): boolean {\n  const first = messages[0];\n  if (first === undefined) return false;\n  if (messages.every((message) => message.role === undefined)) return messages.length < 2;\n  if (first.role !== 'user') return true;\n  if (messages.every((message) => message.role === 'user')) return false;\n  let turns = 0;\n  for (let index = 1; index < messages.length; index += 1) {\n    if (messages[index - 1]!.role === 'user' && messages[index]!.role !== 'user') turns += 1;\n  }\n  return turns < 2;\n}\n\nexport function useDeepAgentWindowSync({\n  messages,\n  pageSize,\n  toolOutputs,\n  nearTop = false,\n  nearTopEpoch = 0,\n  isMessageMounted = everyMessageMounted,\n  maxChainedLoads = DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS,\n  maxUnseenLoads = DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS,\n  onHistoryLoad,\n  onError,\n  now = defaultNow,\n}: UseDeepAgentWindowSyncOptions): DeepAgentWindowSyncState {\n  const { sendCommand, invoke, connection } = useStatewireExtras();\n  const window = useDeepAgentMessageWindow();\n  const [loading, setLoading] = useState(false);\n  const [requests, setRequests] = useState(0);\n  const servedRequestsRef = useRef(0);\n  const inflightRef = useRef(false);\n  const chainRef = useRef({ epoch: 0, loads: 0, unseen: 0, requested: false });\n  // Pages loaded to show the opening turn's prompt; `null` once it shows, the\n  // user took over, or a page failed — never re-armed for this mount.\n  const openingFillRef = useRef<number | null>(0);\n  // The converted thread when the in-flight page was stated; `null` once its\n  // settle was judged (or it failed).\n  const pageFromRef = useRef<{ count: number; secondId: string | undefined } | null>(null);\n  const aliveRef = useRef(true);\n  // The interests this mount last stated, re-stated on the next connected\n  // session (a hello resets the documents) so a reconnect keeps the loaded history.\n  const statedRef = useRef<DeepAgentInterestRequest[] | null>(null);\n  const restatedConnectionRef = useRef<unknown>(null);\n  // Outputs already asked for and answered by this mount — fetched, refused,\n  // or failed — by the `chars` they were asked for. The converter re-runs on\n  // every wire change, and the store is a bounded LRU: without this memory a\n  // refused read would leave on every pass, and once a transcript holds more\n  // cut outputs than the store retains, each fetch would evict a still-loaded\n  // output and the next pass would fetch it again, forever. An evicted output\n  // renders its cut text (the REST display limit) rather than re-entering the\n  // loop; a marker whose `chars` moved (the host replaced the output) is asked\n  // for again.\n  const answeredRef = useRef(new Map<string, number>());\n  const onHistoryLoadRef = useRef(onHistoryLoad);\n  onHistoryLoadRef.current = onHistoryLoad;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  const nowRef = useRef(now);\n  nowRef.current = now;\n  useEffect(() => {\n    aliveRef.current = true;\n    return () => {\n      aliveRef.current = false;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (connection.status !== 'connected' || restatedConnectionRef.current === connection) return;\n    // Decided once per connected session, on the hello's interest document.\n    if (window === null) return;\n    restatedConnectionRef.current = connection;\n    const stated = statedRef.current;\n    if (stated === null || interestsCovered(window.requests, stated)) return;\n    invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [stated]).catch((error: unknown) => {\n      onErrorRef.current?.(error, 'athena/interest');\n    });\n  }, [connection, invoke, window]);\n\n  useEffect(() => {\n    if (window === null || inflightRef.current) return;\n    const from = pageFromRef.current;\n    pageFromRef.current = null;\n    const lastPageUnseen =\n      from !== null && from.count > 0 && !pageShowedEarlierMessage(from, messages);\n    const pageRequests = pageInterestRequests(window, pageSize);\n    if (pageRequests === null) return;\n    const requested = requests !== servedRequestsRef.current;\n    const chain = chainRef.current;\n    let fillPage = false;\n    if (\n      openingFillRef.current !== null &&\n      (requested || nearTop || (messages.length > 0 && !opensMidTurn(messages)))\n    ) {\n      openingFillRef.current = null;\n    }\n    if (requested) {\n      // An explicit ask re-arms the chain for this approach.\n      servedRequestsRef.current = requests;\n      chainRef.current = { epoch: nearTopEpoch, loads: 1, unseen: 0, requested: true };\n    } else if (lastPageUnseen && (chain.requested || (nearTop && chain.epoch === nearTopEpoch))) {\n      // The page landed inside the first loaded turn: keep going until one shows.\n      if (chain.unseen >= maxUnseenLoads) return;\n      chain.unseen += 1;\n    } else if (openingFillRef.current !== null && opensMidTurn(messages)) {\n      if (openingFillRef.current >= maxUnseenLoads) return;\n      openingFillRef.current += 1;\n      fillPage = true;\n    } else {\n      if (!nearTop) return;\n      if (chain.epoch !== nearTopEpoch) {\n        chainRef.current = { epoch: nearTopEpoch, loads: 0, unseen: 0, requested: false };\n      }\n      if (chainRef.current.loads >= maxChainedLoads) return;\n      chainRef.current.loads += 1;\n    }\n    pageFromRef.current = { count: messages.length, secondId: messages[1]?.id };\n    const page = window.pages + 1;\n    const request = pageRequests[pageRequests.length - 1] as DeepAgentInterestRequest;\n    inflightRef.current = true;\n    setLoading(true);\n    const startedAt = nowRef.current();\n    invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [pageRequests])\n      .then(() => {\n        statedRef.current = pageRequests;\n        onHistoryLoadRef.current?.({\n          page,\n          request,\n          durationMs: Math.max(0, Math.round(nowRef.current() - startedAt)),\n        });\n      })\n      .catch((error: unknown) => {\n        pageFromRef.current = null;\n        if (fillPage) openingFillRef.current = null;\n        onErrorRef.current?.(error, 'athena/interest');\n      })\n      .finally(() => {\n        inflightRef.current = false;\n        if (aliveRef.current) setLoading(false);\n      });\n    // `loading` re-arms the chain once a page settled after its documents moved the window.\n  }, [\n    nearTop,\n    nearTopEpoch,\n    requests,\n    window,\n    loading,\n    messages,\n    invoke,\n    maxChainedLoads,\n    maxUnseenLoads,\n    pageSize,\n  ]);\n\n  useEffect(() => {\n    if (window === null || toolOutputs === undefined) return;\n    for (const message of messages) {\n      if (!isMessageMounted(message.id)) continue;\n      for (const part of message.content) {\n        if (part.type !== 'tool-call') continue;\n        const marker = readTruncatedToolOutputArtifact(part.artifact);\n        if (marker === null || toolOutputs.isPending(marker.messageId)) continue;\n        // Fetched for this very length already; a different length means the\n        // host replaced the output under the same id since.\n        if (toolOutputs.entry(marker.messageId)?.chars === marker.chars) continue;\n        if (answeredRef.current.get(marker.messageId) === marker.chars) continue;\n        const { messageId, chars } = marker;\n        toolOutputs.markPending(messageId);\n        Promise.resolve(sendCommand(buildToolOutputCommand({ messageId })))\n          .then((payload) => {\n            answeredRef.current.set(messageId, chars);\n            const result = readToolOutputResult(payload);\n            if (result === null) {\n              toolOutputs.clearPending(messageId);\n              return;\n            }\n            toolOutputs.set(result.messageId, { content: result.content, chars });\n          })\n          .catch((error: unknown) => {\n            answeredRef.current.set(messageId, chars);\n            toolOutputs.clearPending(messageId);\n            onErrorRef.current?.(error, 'history/tool_output');\n          });\n      }\n    }\n  }, [messages, isMessageMounted, window, sendCommand, toolOutputs]);\n\n  const loadOlder = useCallback(() => {\n    setRequests((count) => count + 1);\n  }, []);\n\n  const canLoadOlder = useMemo(\n    () => window !== null && pageInterestRequests(window, pageSize) !== null,\n    [window, pageSize]\n  );\n\n  return { window, hasOlder: window?.hasOlder ?? false, canLoadOlder, loading, loadOlder };\n}\n"],"names":["useAuiState","hasStatewireThreadExtras","useSyncExternalStore","useMemo","readDeepAgentMessageWindow","useState","useRef","useEffect","interestsCovered","DEEP_AGENT_INTEREST_PROTOCOL","pageInterestRequests","_a","readTruncatedToolOutputArtifact","buildToolOutputCommand","readToolOutputResult","useCallback"],"mappings":"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"}

package/dist/agent-runtime/src/use-deep-agent-window-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-window-sync.js","sources":["../../../../agent-runtime/src/use-deep-agent-window-sync.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { DEEP_AGENT_INTEREST_PROTOCOL } from './generated/runconfig-contract';\nimport {\n  buildToolOutputCommand,\n  type DeepAgentInterestRequest,\n  type DeepAgentMessageWindow,\n  interestsCovered,\n  pageInterestRequests,\n  readDeepAgentMessageWindow,\n  readToolOutputResult,\n  readTruncatedToolOutputArtifact,\n} from './message-window';\nimport { hasStatewireThreadExtras } from './thread-extras';\nimport type { DeepAgentToolOutputStore } from './tool-outputs';\n\n/**\n * Pages of older history chained per approach to the top. A renderer lowers\n * its near-top level once prepended content has pushed the first message out\n * of its band; this bounds the case where it cannot (no viewport to scroll,\n * a list too short to overflow) so a 2,000-message thread never streams whole.\n */\nexport const DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS = 3;\n\n/**\n * Pages of older history that add no converted message — every message on\n * them folds into the first loaded turn, such as one agent run's hundreds of\n * tool steps — loaded on top of a request (or an approach's chain) before it\n * stops. Such a page changes nothing the user can see, so it neither answers\n * an ask nor counts against the per-approach chain.\n */\nexport const DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS = 25;\n\n/** The converted thread messages the tool-output half scans (web and native `ThreadMessage` both satisfy it). */\nexport interface DeepAgentWindowSyncMessage {\n  readonly id: string;\n  /** The converted role; lets the opening fill tell a turn's prompt from its reply. */\n  readonly role?: string;\n  readonly content: readonly { readonly type: string; readonly artifact?: unknown }[];\n}\n\n/** One page interest round trip, for the host's telemetry. */\nexport interface DeepAgentHistoryLoadEvent {\n  /** The page's ordinal (`1` extends the head). */\n  page: number;\n  request: DeepAgentInterestRequest;\n  durationMs: number;\n}\n\nexport interface UseDeepAgentWindowSyncOptions {\n  /**\n   * The converted thread messages — read by the host through its platform\n   * `useAuiState((s) => s.thread.messages)`, so this hook imports neither\n   * `@assistant-ui/react` nor `@assistant-ui/react-native`.\n   */\n  messages: readonly DeepAgentWindowSyncMessage[];\n  /** Messages per page; the thread's window size by default. */\n  pageSize?: number;\n  /**\n   * Full tool outputs fetched back for cut tool messages; the same store the\n   * thread converts with (`useDeepAgentThread({ toolOutputs })`). Omitted, the\n   * tool-output half is inert (a surface that never shows a cut output whole).\n   */\n  toolOutputs?: DeepAgentToolOutputStore | undefined;\n  /**\n   * The renderer's report that the top of the LOADED history is near — a\n   * level, not an edge: while it holds and older messages exist, pages load\n   * one after another (bounded by `maxChainedLoads` per approach). Omitted for\n   * hosts with only a manual affordance (`loadOlder`).\n   */\n  nearTop?: boolean;\n  /** Bumped on every rise of `nearTop` (and every explicit request), so the chain bound is per approach. */\n  nearTopEpoch?: number;\n  /**\n   * Whether a message's content is mounted right now, so lazy fetches (cut\n   * tool outputs) target what the user can see rather than the whole loaded\n   * history. Omitted: every message counts as mounted (the flat renderers).\n   */\n  isMessageMounted?: ((messageId: string) => boolean) | undefined;\n  maxChainedLoads?: number;\n  /** Pages adding no converted message loaded per request before it stops; see {@link DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS}. */\n  maxUnseenLoads?: number;\n  /** A page interest resolved (telemetry). */\n  onHistoryLoad?: ((event: DeepAgentHistoryLoadEvent) => void) | undefined;\n  /** A read failed; the sync itself recovers (the pending marks are released). */\n  onError?: ((error: unknown, command: 'athena/interest' | 'history/tool_output') => void) | undefined;\n  now?: () => number;\n}\n\nexport interface DeepAgentWindowSyncState {\n  /** The joined window, or `null` while the head interest has not resolved (both halves are inert). */\n  window: DeepAgentMessageWindow | null;\n  /** Whether the host holds messages older than the loaded window. */\n  hasOlder: boolean;\n  /**\n   * Whether the next page can be asked for: older messages exist and the\n   * host's interest cap has room for them. `hasOlder && !canLoadOlder` is the\n   * depth limit (`MAX_INTERESTS × MAX_MESSAGE_WINDOW` messages loaded in one\n   * connection) — an edge row says so instead of offering a dead button.\n   */\n  canLoadOlder: boolean;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  /** Ask for the next page of older history now (an edge row's button, a keypress). A no-op before the head resolved or at the beginning. */\n  loadOlder: () => void;\n}\n\nconst everyMessageMounted = (): boolean => true;\nconst defaultNow = (): number => Date.now();\nconst noopSubscribe = () => () => {};\n\n/** The statewire extras of the nearest aui thread; throws on a non-statewire thread like the library's own hooks. */\nconst useStatewireExtras = (): StatewireThread.Extras =>\n  useAuiState((s) => {\n    if (!hasStatewireThreadExtras(s.thread.extras)) {\n      throw new Error('useDeepAgentWindowSync requires a statewire thread');\n    }\n    return s.thread.extras as StatewireThread.Extras;\n  });\n\n/** The joined interest window of the nearest statewire thread. */\nexport function useDeepAgentMessageWindow(): DeepAgentMessageWindow | null {\n  const documents = useStatewireExtras().documents;\n  const mounted = useSyncExternalStore(\n    documents?.subscribe ?? noopSubscribe,\n    () => documents?.list(),\n    () => documents?.list()\n  );\n  return useMemo(() => readDeepAgentMessageWindow(mounted), [mounted]);\n}\n\n/**\n * The client half of the interest window, shared by every surface — mounted\n * once per runtime, inside its aui provider.\n *\n * - **Older history.** While the host renderer reports the top of the loaded\n *   history near (`nearTop`) and the window says older messages exist, this\n *   re-states the interests with one more page (anchored at the window's\n *   first message) — the host mounts its documents for this client alone —\n *   chaining at most `maxChainedLoads` pages per approach; `loadOlder` asks\n *   for one page on demand (an edge row's button). Never two loads in flight.\n *   A reconnect whose hello does not carry the interests this mount last\n *   stated (the host remembers a client id's view across its attaches; a new\n *   host instance does not) re-states them.\n * - **Cut tool outputs.** Tool cards whose output the wire carried cut\n *   (`artifact._athena_content_truncated`) get it fetched whole through\n *   `history/tool_output` once their message is mounted; the converter puts\n *   it back (`toolOutputs`), so the card re-renders complete. An output the\n *   host replaced since (the marker's `chars` changed) is fetched again.\n */\n/**\n * Whether an older page put a new converted message ahead of the thread's\n * first one. Older history only ever merges into or lands before the first\n * converted message, so the second one is a stable landmark: it moved down iff\n * the page showed something. A new tail message does not move it. Without a\n * second message (or once it is gone) the converted count decides.\n */\nfunction pageShowedEarlierMessage(\n  from: { count: number; secondId: string | undefined },\n  messages: readonly DeepAgentWindowSyncMessage[]\n): boolean {\n  if (from.secondId !== undefined) {\n    const index = messages.findIndex((message) => message.id === from.secondId);\n    if (index !== -1) return index > 1;\n  }\n  return messages.length > from.count;\n}\n\n/**\n * Whether the loaded thread still opens without context: it should open on a\n * prompt and hold at least one earlier turn, so the newest turn shows with the\n * one before it (a turn is a prompt followed by its reply). Queued and live\n * prompts land at the tail with no reply yet, so they never count; prompts\n * alone need nothing. Without roles, a lone converted message stands in for it.\n */\nfunction opensMidTurn(messages: readonly DeepAgentWindowSyncMessage[]): boolean {\n  const first = messages[0];\n  if (first === undefined) return false;\n  if (messages.every((message) => message.role === undefined)) return messages.length < 2;\n  if (first.role !== 'user') return true;\n  if (messages.every((message) => message.role === 'user')) return false;\n  let turns = 0;\n  for (let index = 1; index < messages.length; index += 1) {\n    if (messages[index - 1]!.role === 'user' && messages[index]!.role !== 'user') turns += 1;\n  }\n  return turns < 2;\n}\n\nexport function useDeepAgentWindowSync({\n  messages,\n  pageSize,\n  toolOutputs,\n  nearTop = false,\n  nearTopEpoch = 0,\n  isMessageMounted = everyMessageMounted,\n  maxChainedLoads = DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS,\n  maxUnseenLoads = DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS,\n  onHistoryLoad,\n  onError,\n  now = defaultNow,\n}: UseDeepAgentWindowSyncOptions): DeepAgentWindowSyncState {\n  const { sendCommand, invoke, connection } = useStatewireExtras();\n  const window = useDeepAgentMessageWindow();\n  const [loading, setLoading] = useState(false);\n  const [requests, setRequests] = useState(0);\n  const servedRequestsRef = useRef(0);\n  const inflightRef = useRef(false);\n  const chainRef = useRef({ epoch: 0, loads: 0, unseen: 0, requested: false });\n  // Pages loaded to show the opening turn's prompt; `null` once it shows, the\n  // user took over, or a page failed — never re-armed for this mount.\n  const openingFillRef = useRef<number | null>(0);\n  // The converted thread when the in-flight page was stated; `null` once its\n  // settle was judged (or it failed).\n  const pageFromRef = useRef<{ count: number; secondId: string | undefined } | null>(null);\n  const aliveRef = useRef(true);\n  // The interests this mount last stated, re-stated on the next connected\n  // session (a hello resets the documents) so a reconnect keeps the loaded history.\n  const statedRef = useRef<DeepAgentInterestRequest[] | null>(null);\n  const restatedConnectionRef = useRef<unknown>(null);\n  // Outputs already asked for and answered by this mount — fetched, refused,\n  // or failed — by the `chars` they were asked for. The converter re-runs on\n  // every wire change, and the store is a bounded LRU: without this memory a\n  // refused read would leave on every pass, and once a transcript holds more\n  // cut outputs than the store retains, each fetch would evict a still-loaded\n  // output and the next pass would fetch it again, forever. An evicted output\n  // renders its cut text (the REST display limit) rather than re-entering the\n  // loop; a marker whose `chars` moved (the host replaced the output) is asked\n  // for again.\n  const answeredRef = useRef(new Map<string, number>());\n  const onHistoryLoadRef = useRef(onHistoryLoad);\n  onHistoryLoadRef.current = onHistoryLoad;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  const nowRef = useRef(now);\n  nowRef.current = now;\n  useEffect(() => {\n    aliveRef.current = true;\n    return () => {\n      aliveRef.current = false;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (connection.status !== 'connected' || restatedConnectionRef.current === connection) return;\n    // Decided once per connected session, on the hello's interest document.\n    if (window === null) return;\n    restatedConnectionRef.current = connection;\n    const stated = statedRef.current;\n    if (stated === null || interestsCovered(window.requests, stated)) return;\n    invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [stated]).catch((error: unknown) => {\n      onErrorRef.current?.(error, 'athena/interest');\n    });\n  }, [connection, invoke, window]);\n\n  useEffect(() => {\n    if (window === null || inflightRef.current) return;\n    const from = pageFromRef.current;\n    pageFromRef.current = null;\n    const lastPageUnseen =\n      from !== null && from.count > 0 && !pageShowedEarlierMessage(from, messages);\n    const pageRequests = pageInterestRequests(window, pageSize);\n    if (pageRequests === null) return;\n    const requested = requests !== servedRequestsRef.current;\n    const chain = chainRef.current;\n    let fillPage = false;\n    if (\n      openingFillRef.current !== null &&\n      (requested || nearTop || (messages.length > 0 && !opensMidTurn(messages)))\n    ) {\n      openingFillRef.current = null;\n    }\n    if (requested) {\n      // An explicit ask re-arms the chain for this approach.\n      servedRequestsRef.current = requests;\n      chainRef.current = { epoch: nearTopEpoch, loads: 1, unseen: 0, requested: true };\n    } else if (lastPageUnseen && (chain.requested || (nearTop && chain.epoch === nearTopEpoch))) {\n      // The page landed inside the first loaded turn: keep going until one shows.\n      if (chain.unseen >= maxUnseenLoads) return;\n      chain.unseen += 1;\n    } else if (openingFillRef.current !== null && opensMidTurn(messages)) {\n      if (openingFillRef.current >= maxUnseenLoads) return;\n      openingFillRef.current += 1;\n      fillPage = true;\n    } else {\n      if (!nearTop) return;\n      if (chain.epoch !== nearTopEpoch) {\n        chainRef.current = { epoch: nearTopEpoch, loads: 0, unseen: 0, requested: false };\n      }\n      if (chainRef.current.loads >= maxChainedLoads) return;\n      chainRef.current.loads += 1;\n    }\n    pageFromRef.current = { count: messages.length, secondId: messages[1]?.id };\n    const page = window.pages + 1;\n    const request = pageRequests[pageRequests.length - 1] as DeepAgentInterestRequest;\n    inflightRef.current = true;\n    setLoading(true);\n    const startedAt = nowRef.current();\n    invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [pageRequests])\n      .then(() => {\n        statedRef.current = pageRequests;\n        onHistoryLoadRef.current?.({\n          page,\n          request,\n          durationMs: Math.max(0, Math.round(nowRef.current() - startedAt)),\n        });\n      })\n      .catch((error: unknown) => {\n        pageFromRef.current = null;\n        if (fillPage) openingFillRef.current = null;\n        onErrorRef.current?.(error, 'athena/interest');\n      })\n      .finally(() => {\n        inflightRef.current = false;\n        if (aliveRef.current) setLoading(false);\n      });\n    // `loading` re-arms the chain once a page settled after its documents moved the window.\n  }, [\n    nearTop,\n    nearTopEpoch,\n    requests,\n    window,\n    loading,\n    messages,\n    invoke,\n    maxChainedLoads,\n    maxUnseenLoads,\n    pageSize,\n  ]);\n\n  useEffect(() => {\n    if (window === null || toolOutputs === undefined) return;\n    for (const message of messages) {\n      if (!isMessageMounted(message.id)) continue;\n      for (const part of message.content) {\n        if (part.type !== 'tool-call') continue;\n        const marker = readTruncatedToolOutputArtifact(part.artifact);\n        if (marker === null || toolOutputs.isPending(marker.messageId)) continue;\n        // Fetched for this very length already; a different length means the\n        // host replaced the output under the same id since.\n        if (toolOutputs.entry(marker.messageId)?.chars === marker.chars) continue;\n        if (answeredRef.current.get(marker.messageId) === marker.chars) continue;\n        const { messageId, chars } = marker;\n        toolOutputs.markPending(messageId);\n        Promise.resolve(sendCommand(buildToolOutputCommand({ messageId })))\n          .then((payload) => {\n            answeredRef.current.set(messageId, chars);\n            const result = readToolOutputResult(payload);\n            if (result === null) {\n              toolOutputs.clearPending(messageId);\n              return;\n            }\n            toolOutputs.set(result.messageId, { content: result.content, chars });\n          })\n          .catch((error: unknown) => {\n            answeredRef.current.set(messageId, chars);\n            toolOutputs.clearPending(messageId);\n            onErrorRef.current?.(error, 'history/tool_output');\n          });\n      }\n    }\n  }, [messages, isMessageMounted, window, sendCommand, toolOutputs]);\n\n  const loadOlder = useCallback(() => {\n    setRequests((count) => count + 1);\n  }, []);\n\n  const canLoadOlder = useMemo(\n    () => window !== null && pageInterestRequests(window, pageSize) !== null,\n    [window, pageSize]\n  );\n\n  return { window, hasOlder: window?.hasOlder ?? false, canLoadOlder, loading, loadOlder };\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/agent-runtime/src/use-historical-edit-attachments.cjs

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const store = require("@assistant-ui/store");
+const react = require("react");
+function useHistoricalEditAttachments() {
+  const aui = store.useAui();
+  const isEditing = store.useAuiState((state) => state.message.composer.isEditing);
+  const restoredMessage = react.useRef(null);
+  const [restoreError, setRestoreError] = react.useState();
+  react.useEffect(() => {
+    if (!isEditing) {
+      restoredMessage.current = null;
+      return;
+    }
+    const message = aui.message().getState();
+    if (message.role !== "user" || restoredMessage.current === message.id)
+      return;
+    restoredMessage.current = message.id;
+    const composer = aui.message().composer();
+    const existing = composer.getState().attachments.flatMap((attachment) => attachment.content ?? []);
+    for (const part of message.content) {
+      if (part.type !== "image" && part.type !== "file") continue;
+      const index = existing.findIndex(
+        (candidate) => samePart(candidate, part)
+      );
+      if (index >= 0) {
+        existing.splice(index, 1);
+        continue;
+      }
+      void composer.addAttachment({
+        name: part.filename ?? (part.type === "image" ? "image" : "document"),
+        type: part.type === "image" ? "image" : "document",
+        contentType: part.type === "image" ? "image/*" : part.mimeType,
+        content: [part]
+      }).catch((error) => {
+        setRestoreError(
+          error instanceof Error ? error : new Error(String(error))
+        );
+      });
+    }
+  }, [aui, isEditing]);
+  if (restoreError) throw restoreError;
+}
+function samePart(left, right) {
+  if (left.type === "image" && right.type === "image")
+    return left.image === right.image;
+  if (left.type === "file" && right.type === "file")
+    return left.data === right.data && left.mimeType === right.mimeType && left.filename === right.filename;
+  return false;
+}
+exports.useHistoricalEditAttachments = useHistoricalEditAttachments;
+//# sourceMappingURL=use-historical-edit-attachments.cjs.map

package/dist/agent-runtime/src/use-historical-edit-attachments.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-historical-edit-attachments.cjs","sources":["../../../../agent-runtime/src/use-historical-edit-attachments.ts"],"sourcesContent":["import type { ThreadUserMessagePart } from \"@assistant-ui/core\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\nimport { useEffect, useRef, useState } from \"react\";\n\n/** Restore once per edit so published SDKs work with unpatched upstream AUI. */\nexport function useHistoricalEditAttachments(): void {\n\tconst aui = useAui();\n\tconst isEditing = useAuiState((state) => state.message.composer.isEditing);\n\tconst restoredMessage = useRef<string | null>(null);\n\tconst [restoreError, setRestoreError] = useState<Error>();\n\tuseEffect(() => {\n\t\tif (!isEditing) {\n\t\t\trestoredMessage.current = null;\n\t\t\treturn;\n\t\t}\n\t\tconst message = aui.message().getState();\n\t\tif (message.role !== \"user\" || restoredMessage.current === message.id)\n\t\t\treturn;\n\t\trestoredMessage.current = message.id;\n\t\tconst composer = aui.message().composer();\n\t\t// Match occurrences, preserving repeated images without duplicating parts\n\t\t// already lifted by the monorepo's patched core. Removing one afterward\n\t\t// must remain a deliberate removal throughout this edit session.\n\t\tconst existing = composer\n\t\t\t.getState()\n\t\t\t.attachments.flatMap((attachment) => attachment.content ?? []);\n\t\tfor (const part of message.content) {\n\t\t\tif (part.type !== \"image\" && part.type !== \"file\") continue;\n\t\t\tconst index = existing.findIndex((candidate) =>\n\t\t\t\tsamePart(candidate, part),\n\t\t\t);\n\t\t\tif (index >= 0) {\n\t\t\t\texisting.splice(index, 1);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tvoid composer\n\t\t\t\t.addAttachment({\n\t\t\t\t\tname: part.filename ?? (part.type === \"image\" ? \"image\" : \"document\"),\n\t\t\t\t\ttype: part.type === \"image\" ? \"image\" : \"document\",\n\t\t\t\t\tcontentType: part.type === \"image\" ? \"image/*\" : part.mimeType,\n\t\t\t\t\tcontent: [part],\n\t\t\t\t})\n\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\tsetRestoreError(\n\t\t\t\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t}\n\t}, [aui, isEditing]);\n\tif (restoreError) throw restoreError;\n}\n\nfunction samePart(\n\tleft: ThreadUserMessagePart,\n\tright: ThreadUserMessagePart,\n): boolean {\n\tif (left.type === \"image\" && right.type === \"image\")\n\t\treturn left.image === right.image;\n\tif (left.type === \"file\" && right.type === \"file\")\n\t\treturn (\n\t\t\tleft.data === right.data &&\n\t\t\tleft.mimeType === right.mimeType &&\n\t\t\tleft.filename === right.filename\n\t\t);\n\treturn false;\n}\n"],"names":["useAui","useAuiState","useRef","useState","useEffect"],"mappings":";;;;AAKO,SAAS,+BAAqC;AACpD,QAAM,MAAMA,MAAAA,OAAA;AACZ,QAAM,YAAYC,MAAAA,YAAY,CAAC,UAAU,MAAM,QAAQ,SAAS,SAAS;AACzE,QAAM,kBAAkBC,MAAAA,OAAsB,IAAI;AAClD,QAAM,CAAC,cAAc,eAAe,IAAIC,eAAA;AACxCC,QAAAA,UAAU,MAAM;AACf,QAAI,CAAC,WAAW;AACf,sBAAgB,UAAU;AAC1B;AAAA,IACD;AACA,UAAM,UAAU,IAAI,QAAA,EAAU,SAAA;AAC9B,QAAI,QAAQ,SAAS,UAAU,gBAAgB,YAAY,QAAQ;AAClE;AACD,oBAAgB,UAAU,QAAQ;AAClC,UAAM,WAAW,IAAI,QAAA,EAAU,SAAA;AAI/B,UAAM,WAAW,SACf,SAAA,EACA,YAAY,QAAQ,CAAC,eAAe,WAAW,WAAW,EAAE;AAC9D,eAAW,QAAQ,QAAQ,SAAS;AACnC,UAAI,KAAK,SAAS,WAAW,KAAK,SAAS,OAAQ;AACnD,YAAM,QAAQ,SAAS;AAAA,QAAU,CAAC,cACjC,SAAS,WAAW,IAAI;AAAA,MAAA;AAEzB,UAAI,SAAS,GAAG;AACf,iBAAS,OAAO,OAAO,CAAC;AACxB;AAAA,MACD;AACA,WAAK,SACH,cAAc;AAAA,QACd,MAAM,KAAK,aAAa,KAAK,SAAS,UAAU,UAAU;AAAA,QAC1D,MAAM,KAAK,SAAS,UAAU,UAAU;AAAA,QACxC,aAAa,KAAK,SAAS,UAAU,YAAY,KAAK;AAAA,QACtD,SAAS,CAAC,IAAI;AAAA,MAAA,CACd,EACA,MAAM,CAAC,UAAmB;AAC1B;AAAA,UACC,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAAA;AAAA,MAE1D,CAAC;AAAA,IACH;AAAA,EACD,GAAG,CAAC,KAAK,SAAS,CAAC;AACnB,MAAI,aAAc,OAAM;AACzB;AAEA,SAAS,SACR,MACA,OACU;AACV,MAAI,KAAK,SAAS,WAAW,MAAM,SAAS;AAC3C,WAAO,KAAK,UAAU,MAAM;AAC7B,MAAI,KAAK,SAAS,UAAU,MAAM,SAAS;AAC1C,WACC,KAAK,SAAS,MAAM,QACpB,KAAK,aAAa,MAAM,YACxB,KAAK,aAAa,MAAM;AAE1B,SAAO;AACR;;"}

package/dist/agent-runtime/src/use-historical-edit-attachments.js

@@ -0,0 +1,52 @@
+import { useAui, useAuiState } from "@assistant-ui/store";
+import { useRef, useState, useEffect } from "react";
+function useHistoricalEditAttachments() {
+  const aui = useAui();
+  const isEditing = useAuiState((state) => state.message.composer.isEditing);
+  const restoredMessage = useRef(null);
+  const [restoreError, setRestoreError] = useState();
+  useEffect(() => {
+    if (!isEditing) {
+      restoredMessage.current = null;
+      return;
+    }
+    const message = aui.message().getState();
+    if (message.role !== "user" || restoredMessage.current === message.id)
+      return;
+    restoredMessage.current = message.id;
+    const composer = aui.message().composer();
+    const existing = composer.getState().attachments.flatMap((attachment) => attachment.content ?? []);
+    for (const part of message.content) {
+      if (part.type !== "image" && part.type !== "file") continue;
+      const index = existing.findIndex(
+        (candidate) => samePart(candidate, part)
+      );
+      if (index >= 0) {
+        existing.splice(index, 1);
+        continue;
+      }
+      void composer.addAttachment({
+        name: part.filename ?? (part.type === "image" ? "image" : "document"),
+        type: part.type === "image" ? "image" : "document",
+        contentType: part.type === "image" ? "image/*" : part.mimeType,
+        content: [part]
+      }).catch((error) => {
+        setRestoreError(
+          error instanceof Error ? error : new Error(String(error))
+        );
+      });
+    }
+  }, [aui, isEditing]);
+  if (restoreError) throw restoreError;
+}
+function samePart(left, right) {
+  if (left.type === "image" && right.type === "image")
+    return left.image === right.image;
+  if (left.type === "file" && right.type === "file")
+    return left.data === right.data && left.mimeType === right.mimeType && left.filename === right.filename;
+  return false;
+}
+export {
+  useHistoricalEditAttachments
+};
+//# sourceMappingURL=use-historical-edit-attachments.js.map

package/dist/agent-runtime/src/use-historical-edit-attachments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-historical-edit-attachments.js","sources":["../../../../agent-runtime/src/use-historical-edit-attachments.ts"],"sourcesContent":["import type { ThreadUserMessagePart } from \"@assistant-ui/core\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\nimport { useEffect, useRef, useState } from \"react\";\n\n/** Restore once per edit so published SDKs work with unpatched upstream AUI. */\nexport function useHistoricalEditAttachments(): void {\n\tconst aui = useAui();\n\tconst isEditing = useAuiState((state) => state.message.composer.isEditing);\n\tconst restoredMessage = useRef<string | null>(null);\n\tconst [restoreError, setRestoreError] = useState<Error>();\n\tuseEffect(() => {\n\t\tif (!isEditing) {\n\t\t\trestoredMessage.current = null;\n\t\t\treturn;\n\t\t}\n\t\tconst message = aui.message().getState();\n\t\tif (message.role !== \"user\" || restoredMessage.current === message.id)\n\t\t\treturn;\n\t\trestoredMessage.current = message.id;\n\t\tconst composer = aui.message().composer();\n\t\t// Match occurrences, preserving repeated images without duplicating parts\n\t\t// already lifted by the monorepo's patched core. Removing one afterward\n\t\t// must remain a deliberate removal throughout this edit session.\n\t\tconst existing = composer\n\t\t\t.getState()\n\t\t\t.attachments.flatMap((attachment) => attachment.content ?? []);\n\t\tfor (const part of message.content) {\n\t\t\tif (part.type !== \"image\" && part.type !== \"file\") continue;\n\t\t\tconst index = existing.findIndex((candidate) =>\n\t\t\t\tsamePart(candidate, part),\n\t\t\t);\n\t\t\tif (index >= 0) {\n\t\t\t\texisting.splice(index, 1);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tvoid composer\n\t\t\t\t.addAttachment({\n\t\t\t\t\tname: part.filename ?? (part.type === \"image\" ? \"image\" : \"document\"),\n\t\t\t\t\ttype: part.type === \"image\" ? \"image\" : \"document\",\n\t\t\t\t\tcontentType: part.type === \"image\" ? \"image/*\" : part.mimeType,\n\t\t\t\t\tcontent: [part],\n\t\t\t\t})\n\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\tsetRestoreError(\n\t\t\t\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t}\n\t}, [aui, isEditing]);\n\tif (restoreError) throw restoreError;\n}\n\nfunction samePart(\n\tleft: ThreadUserMessagePart,\n\tright: ThreadUserMessagePart,\n): boolean {\n\tif (left.type === \"image\" && right.type === \"image\")\n\t\treturn left.image === right.image;\n\tif (left.type === \"file\" && right.type === \"file\")\n\t\treturn (\n\t\t\tleft.data === right.data &&\n\t\t\tleft.mimeType === right.mimeType &&\n\t\t\tleft.filename === right.filename\n\t\t);\n\treturn false;\n}\n"],"names":[],"mappings":";;AAKO,SAAS,+BAAqC;AACpD,QAAM,MAAM,OAAA;AACZ,QAAM,YAAY,YAAY,CAAC,UAAU,MAAM,QAAQ,SAAS,SAAS;AACzE,QAAM,kBAAkB,OAAsB,IAAI;AAClD,QAAM,CAAC,cAAc,eAAe,IAAI,SAAA;AACxC,YAAU,MAAM;AACf,QAAI,CAAC,WAAW;AACf,sBAAgB,UAAU;AAC1B;AAAA,IACD;AACA,UAAM,UAAU,IAAI,QAAA,EAAU,SAAA;AAC9B,QAAI,QAAQ,SAAS,UAAU,gBAAgB,YAAY,QAAQ;AAClE;AACD,oBAAgB,UAAU,QAAQ;AAClC,UAAM,WAAW,IAAI,QAAA,EAAU,SAAA;AAI/B,UAAM,WAAW,SACf,SAAA,EACA,YAAY,QAAQ,CAAC,eAAe,WAAW,WAAW,EAAE;AAC9D,eAAW,QAAQ,QAAQ,SAAS;AACnC,UAAI,KAAK,SAAS,WAAW,KAAK,SAAS,OAAQ;AACnD,YAAM,QAAQ,SAAS;AAAA,QAAU,CAAC,cACjC,SAAS,WAAW,IAAI;AAAA,MAAA;AAEzB,UAAI,SAAS,GAAG;AACf,iBAAS,OAAO,OAAO,CAAC;AACxB;AAAA,MACD;AACA,WAAK,SACH,cAAc;AAAA,QACd,MAAM,KAAK,aAAa,KAAK,SAAS,UAAU,UAAU;AAAA,QAC1D,MAAM,KAAK,SAAS,UAAU,UAAU;AAAA,QACxC,aAAa,KAAK,SAAS,UAAU,YAAY,KAAK;AAAA,QACtD,SAAS,CAAC,IAAI;AAAA,MAAA,CACd,EACA,MAAM,CAAC,UAAmB;AAC1B;AAAA,UACC,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAAA;AAAA,MAE1D,CAAC;AAAA,IACH;AAAA,EACD,GAAG,CAAC,KAAK,SAAS,CAAC;AACnB,MAAI,aAAc,OAAM;AACzB;AAEA,SAAS,SACR,MACA,OACU;AACV,MAAI,KAAK,SAAS,WAAW,MAAM,SAAS;AAC3C,WAAO,KAAK,UAAU,MAAM;AAC7B,MAAI,KAAK,SAAS,UAAU,MAAM,SAAS;AAC1C,WACC,KAAK,SAAS,MAAM,QACpB,KAAK,aAAa,MAAM,YACxB,KAAK,aAAa,MAAM;AAE1B,SAAO;AACR;"}

package/dist/{packages/agent-runtime → agent-runtime}/src/voice-presentation.cjs

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const core = require("@assistant-ui/core");
 const VOICE_SOURCE_SPOKEN = "voice";
 const VOICE_SOURCE_DELEGATION = "voice_delegation";
 const VOICE_DELEGATION_ID_PREFIX = "voicetask_";
@@ -9,6 +10,18 @@ const VOICE_UPDATE_TOOL_NAME = "send_voice_update";
 function isVoiceDelegationMessage({ messageId, custom }) {
   return (custom == null ? void 0 : custom.source) === VOICE_SOURCE_DELEGATION || typeof messageId === "string" && messageId.startsWith(VOICE_DELEGATION_ID_PREFIX);
 }
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function isSpokenTurnTextPart(part) {
+  if (part.type !== "text") return false;
+  const entries = core.getExternalStoreMessages(
+    part
+  );
+  return entries.some((entry) => {
+    if (!isRecord(entry) || entry.role !== "assistant" || !isRecord(entry.metadata)) return false;
+    const custom = entry.metadata.custom;
+    return isRecord(custom) && custom.source === VOICE_SOURCE_SPOKEN;
+  });
+}
 function describeVoiceUpdateToolCall({
   args,
   result
@@ -38,6 +51,7 @@ exports.VOICE_SOURCE_SPOKEN = VOICE_SOURCE_SPOKEN;
 exports.VOICE_TURN_IDS_KEY = VOICE_TURN_IDS_KEY;
 exports.VOICE_UPDATE_TOOL_NAME = VOICE_UPDATE_TOOL_NAME;
 exports.describeVoiceUpdateToolCall = describeVoiceUpdateToolCall;
+exports.isSpokenTurnTextPart = isSpokenTurnTextPart;
 exports.isVoiceDelegationMessage = isVoiceDelegationMessage;
 exports.voiceUpdateStatusLabel = voiceUpdateStatusLabel;
 //# sourceMappingURL=voice-presentation.cjs.map

package/dist/agent-runtime/src/voice-presentation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-presentation.cjs","sources":["../../../../agent-runtime/src/voice-presentation.ts"],"sourcesContent":["/**\n * How voice-mode transcript entries present, shared by every chat surface\n * (Olympus, the Chrome side panel, the mobile app) so a spoken turn, a\n * delegation the live voice model handed off, and an interim spoken update\n * read the same everywhere. The wire contract is the deep-agent host's\n * `additional_kwargs.metadata` (exposed as `message.metadata.custom`):\n *\n * - `source: \"voice\"` — a spoken turn; `voice_live: true` while it is still\n *   being heard or spoken (the ephemeral entry the durable row replaces);\n * - `source: \"text\"` — a message typed into the live conversation;\n * - `source: \"voice_delegation\"` (id prefix `voicetask_`) — the unit of work\n *   the live voice model delegated to the thread.\n */\nimport { getExternalStoreMessages, type ThreadMessage } from '@assistant-ui/core';\n\n/** `metadata.custom.source` of a spoken turn. */\nexport const VOICE_SOURCE_SPOKEN = 'voice';\n/** `metadata.custom.source` of a message typed into the live conversation. */\nexport const VOICE_SOURCE_TYPED = 'text';\n/** `metadata.custom.source` of a voice delegation's anchor message. */\nexport const VOICE_SOURCE_DELEGATION = 'voice_delegation';\n/** Id prefix of a voice delegation's anchor message (the working signal on\n * hosts that drop the command's metadata). */\nexport const VOICE_DELEGATION_ID_PREFIX = 'voicetask_';\n/** `metadata.custom` flag on a spoken turn still in flight. */\nexport const VOICE_LIVE_KEY = 'voice_live';\n/** `metadata.custom` list of the wire ids a grouped spoken bubble stands for\n * (see `groupSpokenUserTurns`), so id-keyed lookups such as checkpoint markers\n * can resolve any member to the bubble. */\nexport const VOICE_TURN_IDS_KEY = 'voice_turn_ids';\n\n/** The delegated run's interim-update tool (agora `send_voice_update`). */\nexport const VOICE_UPDATE_TOOL_NAME = 'send_voice_update';\n\n/** Trailing hint on the live-session strip, worded once for every surface. */\nexport const VOICE_LIVE_TYPED_HINT = 'typed messages go to the voice conversation';\n\nexport interface VoiceMessageMarker {\n  /** The thread message id; a host may not have assigned one yet. */\n  messageId: string | undefined;\n  /** The thread message's `metadata.custom`, when any. */\n  custom: Record<string, unknown> | undefined;\n}\n\n/** Whether a thread message is a voice delegation's anchor (the ask the live\n * voice model handed to the thread), by source or by id prefix. */\nexport function isVoiceDelegationMessage({ messageId, custom }: VoiceMessageMarker): boolean {\n  return (\n    custom?.source === VOICE_SOURCE_DELEGATION ||\n    (typeof messageId === 'string' && messageId.startsWith(VOICE_DELEGATION_ID_PREFIX))\n  );\n}\n\nexport interface VoiceProvenance {\n  /** Chip copy: \"Listening\", \"Speaking\", \"Spoken\", or \"Delegated from voice\". */\n  readonly label: string;\n  /** True while the turn is still being heard or spoken. */\n  readonly live: boolean;\n}\n\n// These values are read directly by useAuiState/useSyncExternalStore selectors.\n// Equal presentation must retain its identity, even when a transport replaces\n// the message metadata. Fresh objects here cause React's update-depth crash.\nconst SPOKEN_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Spoken',\n  live: false,\n});\nconst LISTENING_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Listening',\n  live: true,\n});\nconst SPEAKING_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Speaking',\n  live: true,\n});\nconst DELEGATED_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Delegated from voice',\n  live: false,\n});\n\n/**\n * The provenance chip for a message, or `null` for ordinary chat messages so\n * the chip is free to mount on every row. A spoken turn still in flight reads\n * as what is happening (\"Listening\" for the user, \"Speaking\" for the\n * assistant) rather than as a finished \"Spoken\" turn; a typed-in-voice turn\n * is a normal message and gets no chip. Results are immutable and stable for\n * equal presentation, so all surfaces can use this function as a selector.\n */\nexport function voiceProvenanceLabel({\n  messageId,\n  custom,\n  role,\n}: VoiceMessageMarker & { role: 'user' | 'assistant' | string }): VoiceProvenance | null {\n  const source = custom?.source;\n  if (source === VOICE_SOURCE_SPOKEN) {\n    if (custom?.[VOICE_LIVE_KEY] === true) {\n      return role === 'user' ? LISTENING_PROVENANCE : SPEAKING_PROVENANCE;\n    }\n    return SPOKEN_PROVENANCE;\n  }\n  if (isVoiceDelegationMessage({ messageId, custom })) {\n    return DELEGATED_PROVENANCE;\n  }\n  return null;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * Whether a part of an assistant message holds the words of a spoken\n * assistant turn.\n *\n * The converter joins consecutive assistant entries into one message. The\n * host appends a live turn while it is heard, and a delegated run keeps\n * appending its own steps after it, so a turn spoken during a run becomes a\n * text part inside the run's message, before the run's later tool calls.\n * Grouped views put the text before the last tool call in the details panel\n * as the run's narration; they use this to keep the spoken words visible.\n *\n * The joined message's `metadata.custom` merges every entry in it, so this\n * reads the part's own entry, which the converter binds to the part.\n */\nexport function isSpokenTurnTextPart(part: { readonly type: string }): boolean {\n  if (part.type !== 'text') return false;\n  const entries: readonly unknown[] = getExternalStoreMessages<unknown>(\n    part as ThreadMessage['content'][number]\n  );\n  return entries.some((entry) => {\n    if (!isRecord(entry) || entry.role !== 'assistant' || !isRecord(entry.metadata)) return false;\n    const custom = entry.metadata.custom;\n    return isRecord(custom) && custom.source === VOICE_SOURCE_SPOKEN;\n  });\n}\n\nexport interface VoiceUpdateToolCall {\n  /** `mode: \"speak\"` — read aloud to the user; otherwise a silent progress note. */\n  spoken: boolean;\n  /** The update's words. */\n  text: string;\n  /** Whether the live session took it; `null` while the call is still running. */\n  delivered: boolean | null;\n}\n\n/**\n * What a `send_voice_update` tool call did, from its arguments and the tool's\n * teaching-text result (agora returns prose, not JSON, so the run can read it).\n */\nexport function describeVoiceUpdateToolCall({\n  args,\n  result,\n}: {\n  args: Record<string, unknown> | undefined;\n  result: unknown;\n}): VoiceUpdateToolCall {\n  const text = typeof args?.text === 'string' ? args.text.trim() : '';\n  const spoken = args?.mode === 'speak';\n  if (typeof result !== 'string' || result.trim() === '') {\n    return { spoken, text, delivered: null };\n  }\n  const outcome = result.toLowerCase();\n  const failed =\n    outcome.includes('could not be delivered') ||\n    outcome.includes('was not delivered') ||\n    outcome.includes('rejected the update') ||\n    outcome.includes('has ended') ||\n    outcome.includes('not configured') ||\n    outcome.includes('no voice session');\n  return { spoken, text, delivered: !failed };\n}\n\n/** The card's status line for a voice update in a given tool-call state. */\nexport function voiceUpdateStatusLabel(\n  call: VoiceUpdateToolCall,\n  status: 'running' | 'complete' | 'incomplete' | 'requires-action' | undefined\n): string {\n  if (status === 'running' || (call.delivered === null && status !== 'incomplete')) {\n    return call.spoken ? 'Saying to you…' : 'Noting progress…';\n  }\n  if (call.delivered === false || status === 'incomplete') {\n    return call.spoken ? 'Could not say this to you' : 'Progress note not delivered';\n  }\n  return call.spoken ? 'Said aloud' : 'Progress noted silently';\n}\n"],"names":["getExternalStoreMessages"],"mappings":";;;AAgBO,MAAM,sBAAsB;AAI5B,MAAM,0BAA0B;AAGhC,MAAM,6BAA6B;AAEnC,MAAM,iBAAiB;AAIvB,MAAM,qBAAqB;AAG3B,MAAM,yBAAyB;AAc/B,SAAS,yBAAyB,EAAE,WAAW,UAAuC;AAC3F,UACE,iCAAQ,YAAW,2BAClB,OAAO,cAAc,YAAY,UAAU,WAAW,0BAA0B;AAErF;AAuDA,MAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAgB9D,SAAS,qBAAqB,MAA0C;AAC7E,MAAI,KAAK,SAAS,OAAQ,QAAO;AACjC,QAAM,UAA8BA,KAAAA;AAAAA,IAClC;AAAA,EAAA;AAEF,SAAO,QAAQ,KAAK,CAAC,UAAU;AAC7B,QAAI,CAAC,SAAS,KAAK,KAAK,MAAM,SAAS,eAAe,CAAC,SAAS,MAAM,QAAQ,EAAG,QAAO;AACxF,UAAM,SAAS,MAAM,SAAS;AAC9B,WAAO,SAAS,MAAM,KAAK,OAAO,WAAW;AAAA,EAC/C,CAAC;AACH;AAeO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AACF,GAGwB;AACtB,QAAM,OAAO,QAAO,6BAAM,UAAS,WAAW,KAAK,KAAK,SAAS;AACjE,QAAM,UAAS,6BAAM,UAAS;AAC9B,MAAI,OAAO,WAAW,YAAY,OAAO,KAAA,MAAW,IAAI;AACtD,WAAO,EAAE,QAAQ,MAAM,WAAW,KAAA;AAAA,EACpC;AACA,QAAM,UAAU,OAAO,YAAA;AACvB,QAAM,SACJ,QAAQ,SAAS,wBAAwB,KACzC,QAAQ,SAAS,mBAAmB,KACpC,QAAQ,SAAS,qBAAqB,KACtC,QAAQ,SAAS,WAAW,KAC5B,QAAQ,SAAS,gBAAgB,KACjC,QAAQ,SAAS,kBAAkB;AACrC,SAAO,EAAE,QAAQ,MAAM,WAAW,CAAC,OAAA;AACrC;AAGO,SAAS,uBACd,MACA,QACQ;AACR,MAAI,WAAW,aAAc,KAAK,cAAc,QAAQ,WAAW,cAAe;AAChF,WAAO,KAAK,SAAS,mBAAmB;AAAA,EAC1C;AACA,MAAI,KAAK,cAAc,SAAS,WAAW,cAAc;AACvD,WAAO,KAAK,SAAS,8BAA8B;AAAA,EACrD;AACA,SAAO,KAAK,SAAS,eAAe;AACtC;;;;;;;;;;;"}

package/dist/{packages/agent-runtime → agent-runtime}/src/voice-presentation.js

@@ -1,3 +1,4 @@
+import { getExternalStoreMessages } from "@assistant-ui/core";
 const VOICE_SOURCE_SPOKEN = "voice";
 const VOICE_SOURCE_DELEGATION = "voice_delegation";
 const VOICE_DELEGATION_ID_PREFIX = "voicetask_";
@@ -7,6 +8,18 @@ const VOICE_UPDATE_TOOL_NAME = "send_voice_update";
 function isVoiceDelegationMessage({ messageId, custom }) {
   return (custom == null ? void 0 : custom.source) === VOICE_SOURCE_DELEGATION || typeof messageId === "string" && messageId.startsWith(VOICE_DELEGATION_ID_PREFIX);
 }
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function isSpokenTurnTextPart(part) {
+  if (part.type !== "text") return false;
+  const entries = getExternalStoreMessages(
+    part
+  );
+  return entries.some((entry) => {
+    if (!isRecord(entry) || entry.role !== "assistant" || !isRecord(entry.metadata)) return false;
+    const custom = entry.metadata.custom;
+    return isRecord(custom) && custom.source === VOICE_SOURCE_SPOKEN;
+  });
+}
 function describeVoiceUpdateToolCall({
   args,
   result
@@ -37,6 +50,7 @@ export {
   VOICE_TURN_IDS_KEY,
   VOICE_UPDATE_TOOL_NAME,
   describeVoiceUpdateToolCall,
+  isSpokenTurnTextPart,
   isVoiceDelegationMessage,
   voiceUpdateStatusLabel
 };

package/dist/agent-runtime/src/voice-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-presentation.js","sources":["../../../../agent-runtime/src/voice-presentation.ts"],"sourcesContent":["/**\n * How voice-mode transcript entries present, shared by every chat surface\n * (Olympus, the Chrome side panel, the mobile app) so a spoken turn, a\n * delegation the live voice model handed off, and an interim spoken update\n * read the same everywhere. The wire contract is the deep-agent host's\n * `additional_kwargs.metadata` (exposed as `message.metadata.custom`):\n *\n * - `source: \"voice\"` — a spoken turn; `voice_live: true` while it is still\n *   being heard or spoken (the ephemeral entry the durable row replaces);\n * - `source: \"text\"` — a message typed into the live conversation;\n * - `source: \"voice_delegation\"` (id prefix `voicetask_`) — the unit of work\n *   the live voice model delegated to the thread.\n */\nimport { getExternalStoreMessages, type ThreadMessage } from '@assistant-ui/core';\n\n/** `metadata.custom.source` of a spoken turn. */\nexport const VOICE_SOURCE_SPOKEN = 'voice';\n/** `metadata.custom.source` of a message typed into the live conversation. */\nexport const VOICE_SOURCE_TYPED = 'text';\n/** `metadata.custom.source` of a voice delegation's anchor message. */\nexport const VOICE_SOURCE_DELEGATION = 'voice_delegation';\n/** Id prefix of a voice delegation's anchor message (the working signal on\n * hosts that drop the command's metadata). */\nexport const VOICE_DELEGATION_ID_PREFIX = 'voicetask_';\n/** `metadata.custom` flag on a spoken turn still in flight. */\nexport const VOICE_LIVE_KEY = 'voice_live';\n/** `metadata.custom` list of the wire ids a grouped spoken bubble stands for\n * (see `groupSpokenUserTurns`), so id-keyed lookups such as checkpoint markers\n * can resolve any member to the bubble. */\nexport const VOICE_TURN_IDS_KEY = 'voice_turn_ids';\n\n/** The delegated run's interim-update tool (agora `send_voice_update`). */\nexport const VOICE_UPDATE_TOOL_NAME = 'send_voice_update';\n\n/** Trailing hint on the live-session strip, worded once for every surface. */\nexport const VOICE_LIVE_TYPED_HINT = 'typed messages go to the voice conversation';\n\nexport interface VoiceMessageMarker {\n  /** The thread message id; a host may not have assigned one yet. */\n  messageId: string | undefined;\n  /** The thread message's `metadata.custom`, when any. */\n  custom: Record<string, unknown> | undefined;\n}\n\n/** Whether a thread message is a voice delegation's anchor (the ask the live\n * voice model handed to the thread), by source or by id prefix. */\nexport function isVoiceDelegationMessage({ messageId, custom }: VoiceMessageMarker): boolean {\n  return (\n    custom?.source === VOICE_SOURCE_DELEGATION ||\n    (typeof messageId === 'string' && messageId.startsWith(VOICE_DELEGATION_ID_PREFIX))\n  );\n}\n\nexport interface VoiceProvenance {\n  /** Chip copy: \"Listening\", \"Speaking\", \"Spoken\", or \"Delegated from voice\". */\n  readonly label: string;\n  /** True while the turn is still being heard or spoken. */\n  readonly live: boolean;\n}\n\n// These values are read directly by useAuiState/useSyncExternalStore selectors.\n// Equal presentation must retain its identity, even when a transport replaces\n// the message metadata. Fresh objects here cause React's update-depth crash.\nconst SPOKEN_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Spoken',\n  live: false,\n});\nconst LISTENING_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Listening',\n  live: true,\n});\nconst SPEAKING_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Speaking',\n  live: true,\n});\nconst DELEGATED_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Delegated from voice',\n  live: false,\n});\n\n/**\n * The provenance chip for a message, or `null` for ordinary chat messages so\n * the chip is free to mount on every row. A spoken turn still in flight reads\n * as what is happening (\"Listening\" for the user, \"Speaking\" for the\n * assistant) rather than as a finished \"Spoken\" turn; a typed-in-voice turn\n * is a normal message and gets no chip. Results are immutable and stable for\n * equal presentation, so all surfaces can use this function as a selector.\n */\nexport function voiceProvenanceLabel({\n  messageId,\n  custom,\n  role,\n}: VoiceMessageMarker & { role: 'user' | 'assistant' | string }): VoiceProvenance | null {\n  const source = custom?.source;\n  if (source === VOICE_SOURCE_SPOKEN) {\n    if (custom?.[VOICE_LIVE_KEY] === true) {\n      return role === 'user' ? LISTENING_PROVENANCE : SPEAKING_PROVENANCE;\n    }\n    return SPOKEN_PROVENANCE;\n  }\n  if (isVoiceDelegationMessage({ messageId, custom })) {\n    return DELEGATED_PROVENANCE;\n  }\n  return null;\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * Whether a part of an assistant message holds the words of a spoken\n * assistant turn.\n *\n * The converter joins consecutive assistant entries into one message. The\n * host appends a live turn while it is heard, and a delegated run keeps\n * appending its own steps after it, so a turn spoken during a run becomes a\n * text part inside the run's message, before the run's later tool calls.\n * Grouped views put the text before the last tool call in the details panel\n * as the run's narration; they use this to keep the spoken words visible.\n *\n * The joined message's `metadata.custom` merges every entry in it, so this\n * reads the part's own entry, which the converter binds to the part.\n */\nexport function isSpokenTurnTextPart(part: { readonly type: string }): boolean {\n  if (part.type !== 'text') return false;\n  const entries: readonly unknown[] = getExternalStoreMessages<unknown>(\n    part as ThreadMessage['content'][number]\n  );\n  return entries.some((entry) => {\n    if (!isRecord(entry) || entry.role !== 'assistant' || !isRecord(entry.metadata)) return false;\n    const custom = entry.metadata.custom;\n    return isRecord(custom) && custom.source === VOICE_SOURCE_SPOKEN;\n  });\n}\n\nexport interface VoiceUpdateToolCall {\n  /** `mode: \"speak\"` — read aloud to the user; otherwise a silent progress note. */\n  spoken: boolean;\n  /** The update's words. */\n  text: string;\n  /** Whether the live session took it; `null` while the call is still running. */\n  delivered: boolean | null;\n}\n\n/**\n * What a `send_voice_update` tool call did, from its arguments and the tool's\n * teaching-text result (agora returns prose, not JSON, so the run can read it).\n */\nexport function describeVoiceUpdateToolCall({\n  args,\n  result,\n}: {\n  args: Record<string, unknown> | undefined;\n  result: unknown;\n}): VoiceUpdateToolCall {\n  const text = typeof args?.text === 'string' ? args.text.trim() : '';\n  const spoken = args?.mode === 'speak';\n  if (typeof result !== 'string' || result.trim() === '') {\n    return { spoken, text, delivered: null };\n  }\n  const outcome = result.toLowerCase();\n  const failed =\n    outcome.includes('could not be delivered') ||\n    outcome.includes('was not delivered') ||\n    outcome.includes('rejected the update') ||\n    outcome.includes('has ended') ||\n    outcome.includes('not configured') ||\n    outcome.includes('no voice session');\n  return { spoken, text, delivered: !failed };\n}\n\n/** The card's status line for a voice update in a given tool-call state. */\nexport function voiceUpdateStatusLabel(\n  call: VoiceUpdateToolCall,\n  status: 'running' | 'complete' | 'incomplete' | 'requires-action' | undefined\n): string {\n  if (status === 'running' || (call.delivered === null && status !== 'incomplete')) {\n    return call.spoken ? 'Saying to you…' : 'Noting progress…';\n  }\n  if (call.delivered === false || status === 'incomplete') {\n    return call.spoken ? 'Could not say this to you' : 'Progress note not delivered';\n  }\n  return call.spoken ? 'Said aloud' : 'Progress noted silently';\n}\n"],"names":[],"mappings":";AAgBO,MAAM,sBAAsB;AAI5B,MAAM,0BAA0B;AAGhC,MAAM,6BAA6B;AAEnC,MAAM,iBAAiB;AAIvB,MAAM,qBAAqB;AAG3B,MAAM,yBAAyB;AAc/B,SAAS,yBAAyB,EAAE,WAAW,UAAuC;AAC3F,UACE,iCAAQ,YAAW,2BAClB,OAAO,cAAc,YAAY,UAAU,WAAW,0BAA0B;AAErF;AAuDA,MAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAgB9D,SAAS,qBAAqB,MAA0C;AAC7E,MAAI,KAAK,SAAS,OAAQ,QAAO;AACjC,QAAM,UAA8B;AAAA,IAClC;AAAA,EAAA;AAEF,SAAO,QAAQ,KAAK,CAAC,UAAU;AAC7B,QAAI,CAAC,SAAS,KAAK,KAAK,MAAM,SAAS,eAAe,CAAC,SAAS,MAAM,QAAQ,EAAG,QAAO;AACxF,UAAM,SAAS,MAAM,SAAS;AAC9B,WAAO,SAAS,MAAM,KAAK,OAAO,WAAW;AAAA,EAC/C,CAAC;AACH;AAeO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AACF,GAGwB;AACtB,QAAM,OAAO,QAAO,6BAAM,UAAS,WAAW,KAAK,KAAK,SAAS;AACjE,QAAM,UAAS,6BAAM,UAAS;AAC9B,MAAI,OAAO,WAAW,YAAY,OAAO,KAAA,MAAW,IAAI;AACtD,WAAO,EAAE,QAAQ,MAAM,WAAW,KAAA;AAAA,EACpC;AACA,QAAM,UAAU,OAAO,YAAA;AACvB,QAAM,SACJ,QAAQ,SAAS,wBAAwB,KACzC,QAAQ,SAAS,mBAAmB,KACpC,QAAQ,SAAS,qBAAqB,KACtC,QAAQ,SAAS,WAAW,KAC5B,QAAQ,SAAS,gBAAgB,KACjC,QAAQ,SAAS,kBAAkB;AACrC,SAAO,EAAE,QAAQ,MAAM,WAAW,CAAC,OAAA;AACrC;AAGO,SAAS,uBACd,MACA,QACQ;AACR,MAAI,WAAW,aAAc,KAAK,cAAc,QAAQ,WAAW,cAAe;AAChF,WAAO,KAAK,SAAS,mBAAmB;AAAA,EAC1C;AACA,MAAI,KAAK,cAAc,SAAS,WAAW,cAAc;AACvD,WAAO,KAAK,SAAS,8BAA8B;AAAA,EACrD;AACA,SAAO,KAAK,SAAS,eAAe;AACtC;"}

package/dist/agent-runtime/src/voice-turn-grouping.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-turn-grouping.cjs","sources":["../../../../agent-runtime/src/voice-turn-grouping.ts"],"sourcesContent":["import type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport { VOICE_LIVE_KEY, VOICE_SOURCE_SPOKEN, VOICE_TURN_IDS_KEY } from './voice-presentation';\n\n/**\n * A live voice session commits a spoken turn per utterance, so one breath of\n * speech reaches the wire as several short human rows. Every chat surface\n * renders consecutive spoken user turns as ONE user message: the run stays\n * grouped until something other than a spoken user turn (the assistant's\n * reply, a typed message, a delegation anchor) closes it. There is no pause\n * threshold on purpose — the transcript is easier to read and reason about as\n * one bubble per exchange.\n *\n * The merged message keeps the FIRST turn's id and metadata, so message\n * actions (edit, retry) anchor where the user started speaking; lists every\n * member's id under `voice_turn_ids`, so a checkpoint written after a later\n * member still finds the bubble; and reads live while any member is still\n * being heard. A turn the history forks at (its branch fan-out lists siblings)\n * always starts a group: the branch picker reads `metadata.custom.branch` off\n * the presented message, so a fork buried inside a group would be unreachable.\n */\n\ntype SpokenUserTurn = Extract<LangChainMessage, { type: 'human' }> & { content: string };\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nfunction readVoiceMetadata(message: LangChainMessage): Record<string, unknown> | undefined {\n  if (!('additional_kwargs' in message)) return undefined;\n  const metadata = message.additional_kwargs?.metadata;\n  return isRecord(metadata) ? metadata : undefined;\n}\n\n/** Whether the history fans out at this turn (`branch.siblings` beyond itself). */\nfunction isBranchForkPoint(message: LangChainMessage): boolean {\n  const branch = readVoiceMetadata(message)?.branch;\n  return isRecord(branch) && Array.isArray(branch.siblings) && branch.siblings.length > 1;\n}\n\n/** A spoken (not typed, not delegated) user turn with plain text content. */\nexport function isSpokenUserTurn(message: LangChainMessage): message is SpokenUserTurn {\n  return (\n    message.type === 'human' &&\n    typeof message.content === 'string' &&\n    readVoiceMetadata(message)?.source === VOICE_SOURCE_SPOKEN\n  );\n}\n\ninterface SpokenGroup {\n  readonly turns: readonly SpokenUserTurn[];\n  readonly merged: LangChainMessage;\n}\n\n/**\n * Keyed by the group's first turn (identity-stable per wire object, see the\n * lift cache in `messages.ts`): an unchanged group returns the IDENTICAL\n * merged object, so the converter's per-source cache and assistant-ui's\n * selectors see no churn between passes.\n */\nconst spokenGroupCache = new WeakMap<LangChainMessage, SpokenGroup>();\n\nfunction sameTurns(a: readonly SpokenUserTurn[], b: readonly SpokenUserTurn[]): boolean {\n  return a.length === b.length && a.every((turn, index) => turn === b[index]);\n}\n\nfunction mergeSpokenTurns(turns: readonly SpokenUserTurn[]): LangChainMessage {\n  const first = turns[0];\n  if (first === undefined) throw new Error('mergeSpokenTurns: empty group');\n  if (turns.length === 1) return first;\n  const cached = spokenGroupCache.get(first);\n  if (cached !== undefined && sameTurns(cached.turns, turns)) return cached.merged;\n\n  const live = turns.some((turn) => readVoiceMetadata(turn)?.[VOICE_LIVE_KEY] === true);\n  const firstMetadata = readVoiceMetadata(first) ?? {};\n  const metadata: Record<string, unknown> = live\n    ? { ...firstMetadata, [VOICE_LIVE_KEY]: true }\n    : Object.fromEntries(Object.entries(firstMetadata).filter(([key]) => key !== VOICE_LIVE_KEY));\n  metadata[VOICE_TURN_IDS_KEY] = turns.flatMap((turn) => (turn.id === undefined ? [] : [turn.id]));\n  const content = turns\n    .map((turn) => turn.content.trim())\n    .filter((text) => text.length > 0)\n    .join(' ');\n  const merged: LangChainMessage = {\n    ...first,\n    content,\n    additional_kwargs: { ...first.additional_kwargs, metadata },\n  };\n  spokenGroupCache.set(first, { turns, merged });\n  return merged;\n}\n\n/** Collapse each run of consecutive spoken user turns into one human message. */\nexport function groupSpokenUserTurns(messages: readonly LangChainMessage[]): LangChainMessage[] {\n  const grouped: LangChainMessage[] = [];\n  let run: SpokenUserTurn[] = [];\n  const flush = () => {\n    if (run.length === 0) return;\n    grouped.push(mergeSpokenTurns(run));\n    run = [];\n  };\n  for (const message of messages) {\n    if (isSpokenUserTurn(message)) {\n      if (isBranchForkPoint(message)) flush();\n      run.push(message);\n      continue;\n    }\n    flush();\n    grouped.push(message);\n  }\n  flush();\n  return grouped;\n}\n"],"names":["VOICE_SOURCE_SPOKEN","VOICE_LIVE_KEY","VOICE_TURN_IDS_KEY"],"mappings":";;;AAuBA,MAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,SAAS,kBAAkB,SAAgE;;AACzF,MAAI,EAAE,uBAAuB,SAAU,QAAO;AAC9C,QAAM,YAAW,aAAQ,sBAAR,mBAA2B;AAC5C,SAAO,SAAS,QAAQ,IAAI,WAAW;AACzC;AAGA,SAAS,kBAAkB,SAAoC;;AAC7D,QAAM,UAAS,uBAAkB,OAAO,MAAzB,mBAA4B;AAC3C,SAAO,SAAS,MAAM,KAAK,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,SAAS;AACxF;AAGO,SAAS,iBAAiB,SAAsD;;AACrF,SACE,QAAQ,SAAS,WACjB,OAAO,QAAQ,YAAY,cAC3B,uBAAkB,OAAO,MAAzB,mBAA4B,YAAWA,kBAAAA;AAE3C;AAaA,MAAM,uCAAuB,QAAA;AAE7B,SAAS,UAAU,GAA8B,GAAuC;AACtF,SAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,UAAU,SAAS,EAAE,KAAK,CAAC;AAC5E;AAEA,SAAS,iBAAiB,OAAoD;AAC5E,QAAM,QAAQ,MAAM,CAAC;AACrB,MAAI,UAAU,OAAW,OAAM,IAAI,MAAM,+BAA+B;AACxE,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,SAAS,iBAAiB,IAAI,KAAK;AACzC,MAAI,WAAW,UAAa,UAAU,OAAO,OAAO,KAAK,UAAU,OAAO;AAE1E,QAAM,OAAO,MAAM,KAAK,CAAC;;AAAS,oCAAkB,IAAI,MAAtB,mBAA0BC,uCAAoB;AAAA,GAAI;AACpF,QAAM,gBAAgB,kBAAkB,KAAK,KAAK,CAAA;AAClD,QAAM,WAAoC,OACtC,EAAE,GAAG,eAAe,CAACA,gCAAc,GAAG,KAAA,IACtC,OAAO,YAAY,OAAO,QAAQ,aAAa,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQA,kBAAAA,cAAc,CAAC;AAC9F,WAASC,kBAAAA,kBAAkB,IAAI,MAAM,QAAQ,CAAC,SAAU,KAAK,OAAO,SAAY,CAAA,IAAK,CAAC,KAAK,EAAE,CAAE;AAC/F,QAAM,UAAU,MACb,IAAI,CAAC,SAAS,KAAK,QAAQ,KAAA,CAAM,EACjC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,EAChC,KAAK,GAAG;AACX,QAAM,SAA2B;AAAA,IAC/B,GAAG;AAAA,IACH;AAAA,IACA,mBAAmB,EAAE,GAAG,MAAM,mBAAmB,SAAA;AAAA,EAAS;AAE5D,mBAAiB,IAAI,OAAO,EAAE,OAAO,QAAQ;AAC7C,SAAO;AACT;AAGO,SAAS,qBAAqB,UAA2D;AAC9F,QAAM,UAA8B,CAAA;AACpC,MAAI,MAAwB,CAAA;AAC5B,QAAM,QAAQ,MAAM;AAClB,QAAI,IAAI,WAAW,EAAG;AACtB,YAAQ,KAAK,iBAAiB,GAAG,CAAC;AAClC,UAAM,CAAA;AAAA,EACR;AACA,aAAW,WAAW,UAAU;AAC9B,QAAI,iBAAiB,OAAO,GAAG;AAC7B,UAAI,kBAAkB,OAAO,EAAG,OAAA;AAChC,UAAI,KAAK,OAAO;AAChB;AAAA,IACF;AACA,UAAA;AACA,YAAQ,KAAK,OAAO;AAAA,EACtB;AACA,QAAA;AACA,SAAO;AACT;;;"}

package/dist/agent-runtime/src/voice-turn-grouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-turn-grouping.js","sources":["../../../../agent-runtime/src/voice-turn-grouping.ts"],"sourcesContent":["import type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport { VOICE_LIVE_KEY, VOICE_SOURCE_SPOKEN, VOICE_TURN_IDS_KEY } from './voice-presentation';\n\n/**\n * A live voice session commits a spoken turn per utterance, so one breath of\n * speech reaches the wire as several short human rows. Every chat surface\n * renders consecutive spoken user turns as ONE user message: the run stays\n * grouped until something other than a spoken user turn (the assistant's\n * reply, a typed message, a delegation anchor) closes it. There is no pause\n * threshold on purpose — the transcript is easier to read and reason about as\n * one bubble per exchange.\n *\n * The merged message keeps the FIRST turn's id and metadata, so message\n * actions (edit, retry) anchor where the user started speaking; lists every\n * member's id under `voice_turn_ids`, so a checkpoint written after a later\n * member still finds the bubble; and reads live while any member is still\n * being heard. A turn the history forks at (its branch fan-out lists siblings)\n * always starts a group: the branch picker reads `metadata.custom.branch` off\n * the presented message, so a fork buried inside a group would be unreachable.\n */\n\ntype SpokenUserTurn = Extract<LangChainMessage, { type: 'human' }> & { content: string };\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\nfunction readVoiceMetadata(message: LangChainMessage): Record<string, unknown> | undefined {\n  if (!('additional_kwargs' in message)) return undefined;\n  const metadata = message.additional_kwargs?.metadata;\n  return isRecord(metadata) ? metadata : undefined;\n}\n\n/** Whether the history fans out at this turn (`branch.siblings` beyond itself). */\nfunction isBranchForkPoint(message: LangChainMessage): boolean {\n  const branch = readVoiceMetadata(message)?.branch;\n  return isRecord(branch) && Array.isArray(branch.siblings) && branch.siblings.length > 1;\n}\n\n/** A spoken (not typed, not delegated) user turn with plain text content. */\nexport function isSpokenUserTurn(message: LangChainMessage): message is SpokenUserTurn {\n  return (\n    message.type === 'human' &&\n    typeof message.content === 'string' &&\n    readVoiceMetadata(message)?.source === VOICE_SOURCE_SPOKEN\n  );\n}\n\ninterface SpokenGroup {\n  readonly turns: readonly SpokenUserTurn[];\n  readonly merged: LangChainMessage;\n}\n\n/**\n * Keyed by the group's first turn (identity-stable per wire object, see the\n * lift cache in `messages.ts`): an unchanged group returns the IDENTICAL\n * merged object, so the converter's per-source cache and assistant-ui's\n * selectors see no churn between passes.\n */\nconst spokenGroupCache = new WeakMap<LangChainMessage, SpokenGroup>();\n\nfunction sameTurns(a: readonly SpokenUserTurn[], b: readonly SpokenUserTurn[]): boolean {\n  return a.length === b.length && a.every((turn, index) => turn === b[index]);\n}\n\nfunction mergeSpokenTurns(turns: readonly SpokenUserTurn[]): LangChainMessage {\n  const first = turns[0];\n  if (first === undefined) throw new Error('mergeSpokenTurns: empty group');\n  if (turns.length === 1) return first;\n  const cached = spokenGroupCache.get(first);\n  if (cached !== undefined && sameTurns(cached.turns, turns)) return cached.merged;\n\n  const live = turns.some((turn) => readVoiceMetadata(turn)?.[VOICE_LIVE_KEY] === true);\n  const firstMetadata = readVoiceMetadata(first) ?? {};\n  const metadata: Record<string, unknown> = live\n    ? { ...firstMetadata, [VOICE_LIVE_KEY]: true }\n    : Object.fromEntries(Object.entries(firstMetadata).filter(([key]) => key !== VOICE_LIVE_KEY));\n  metadata[VOICE_TURN_IDS_KEY] = turns.flatMap((turn) => (turn.id === undefined ? [] : [turn.id]));\n  const content = turns\n    .map((turn) => turn.content.trim())\n    .filter((text) => text.length > 0)\n    .join(' ');\n  const merged: LangChainMessage = {\n    ...first,\n    content,\n    additional_kwargs: { ...first.additional_kwargs, metadata },\n  };\n  spokenGroupCache.set(first, { turns, merged });\n  return merged;\n}\n\n/** Collapse each run of consecutive spoken user turns into one human message. */\nexport function groupSpokenUserTurns(messages: readonly LangChainMessage[]): LangChainMessage[] {\n  const grouped: LangChainMessage[] = [];\n  let run: SpokenUserTurn[] = [];\n  const flush = () => {\n    if (run.length === 0) return;\n    grouped.push(mergeSpokenTurns(run));\n    run = [];\n  };\n  for (const message of messages) {\n    if (isSpokenUserTurn(message)) {\n      if (isBranchForkPoint(message)) flush();\n      run.push(message);\n      continue;\n    }\n    flush();\n    grouped.push(message);\n  }\n  flush();\n  return grouped;\n}\n"],"names":[],"mappings":";AAuBA,MAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,SAAS,kBAAkB,SAAgE;;AACzF,MAAI,EAAE,uBAAuB,SAAU,QAAO;AAC9C,QAAM,YAAW,aAAQ,sBAAR,mBAA2B;AAC5C,SAAO,SAAS,QAAQ,IAAI,WAAW;AACzC;AAGA,SAAS,kBAAkB,SAAoC;;AAC7D,QAAM,UAAS,uBAAkB,OAAO,MAAzB,mBAA4B;AAC3C,SAAO,SAAS,MAAM,KAAK,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,SAAS;AACxF;AAGO,SAAS,iBAAiB,SAAsD;;AACrF,SACE,QAAQ,SAAS,WACjB,OAAO,QAAQ,YAAY,cAC3B,uBAAkB,OAAO,MAAzB,mBAA4B,YAAW;AAE3C;AAaA,MAAM,uCAAuB,QAAA;AAE7B,SAAS,UAAU,GAA8B,GAAuC;AACtF,SAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,UAAU,SAAS,EAAE,KAAK,CAAC;AAC5E;AAEA,SAAS,iBAAiB,OAAoD;AAC5E,QAAM,QAAQ,MAAM,CAAC;AACrB,MAAI,UAAU,OAAW,OAAM,IAAI,MAAM,+BAA+B;AACxE,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,SAAS,iBAAiB,IAAI,KAAK;AACzC,MAAI,WAAW,UAAa,UAAU,OAAO,OAAO,KAAK,UAAU,OAAO;AAE1E,QAAM,OAAO,MAAM,KAAK,CAAC;;AAAS,oCAAkB,IAAI,MAAtB,mBAA0B,qBAAoB;AAAA,GAAI;AACpF,QAAM,gBAAgB,kBAAkB,KAAK,KAAK,CAAA;AAClD,QAAM,WAAoC,OACtC,EAAE,GAAG,eAAe,CAAC,cAAc,GAAG,KAAA,IACtC,OAAO,YAAY,OAAO,QAAQ,aAAa,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,QAAQ,cAAc,CAAC;AAC9F,WAAS,kBAAkB,IAAI,MAAM,QAAQ,CAAC,SAAU,KAAK,OAAO,SAAY,CAAA,IAAK,CAAC,KAAK,EAAE,CAAE;AAC/F,QAAM,UAAU,MACb,IAAI,CAAC,SAAS,KAAK,QAAQ,KAAA,CAAM,EACjC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,EAChC,KAAK,GAAG;AACX,QAAM,SAA2B;AAAA,IAC/B,GAAG;AAAA,IACH;AAAA,IACA,mBAAmB,EAAE,GAAG,MAAM,mBAAmB,SAAA;AAAA,EAAS;AAE5D,mBAAiB,IAAI,OAAO,EAAE,OAAO,QAAQ;AAC7C,SAAO;AACT;AAGO,SAAS,qBAAqB,UAA2D;AAC9F,QAAM,UAA8B,CAAA;AACpC,MAAI,MAAwB,CAAA;AAC5B,QAAM,QAAQ,MAAM;AAClB,QAAI,IAAI,WAAW,EAAG;AACtB,YAAQ,KAAK,iBAAiB,GAAG,CAAC;AAClC,UAAM,CAAA;AAAA,EACR;AACA,aAAW,WAAW,UAAU;AAC9B,QAAI,iBAAiB,OAAO,GAAG;AAC7B,UAAI,kBAAkB,OAAO,EAAG,OAAA;AAChC,UAAI,KAAK,OAAO;AAChB;AAAA,IACF;AACA,UAAA;AACA,YAAQ,KAAK,OAAO;AAAA,EACtB;AACA,QAAA;AACA,SAAO;AACT;"}

package/dist/assets/AthenaAssetEmbed.cjs

@@ -23,6 +23,8 @@ const AthenaAssetEmbed = ({
   onCitationClick,
   citationActionBehavior,
   onCitationAction,
+  embedUrl: hostEmbedUrl,
+  onReady,
   onLoad,
   onError,
   loadingFallback,
@@ -36,7 +38,7 @@ const AthenaAssetEmbed = ({
   const iframeRef = react.useRef(null);
   const athenaConfig = AthenaContext.useAthenaConfig();
   const { backendUrl, appUrl, apiKey } = athenaConfig;
-  const { embedUrl, isLoading, error } = useAssetEmbed.useAssetEmbed(assetId, {
+  const minted = useAssetEmbed.useAssetEmbed(hostEmbedUrl ? null : assetId, {
     backendUrl,
     appUrl,
     apiKey,
@@ -46,6 +48,9 @@ const AthenaAssetEmbed = ({
     expiresInSeconds,
     displayMode
   });
+  const embedUrl = hostEmbedUrl ?? minted.embedUrl;
+  const isLoading = hostEmbedUrl ? false : minted.isLoading;
+  const error = hostEmbedUrl ? null : minted.error;
   const targetOrigin = react.useMemo(() => {
     if (!embedUrl) return null;
     try {
@@ -87,6 +92,7 @@ const AthenaAssetEmbed = ({
       if (event.origin !== targetOrigin || event.source !== ((_a = iframeRef.current) == null ? void 0 : _a.contentWindow)) return;
       if (assetEmbedMessages.isAthenaAssetEmbedReadyEvent(event.data)) {
         sendConfig();
+        onReady == null ? void 0 : onReady();
         return;
       }
       if (assetEmbedMessages.isAthenaAssetCitationClickEvent(event.data)) {
@@ -99,7 +105,7 @@ const AthenaAssetEmbed = ({
     };
     window.addEventListener("message", handleMessage);
     return () => window.removeEventListener("message", handleMessage);
-  }, [embedUrl, onCitationAction, onCitationClick, sendConfig, targetOrigin]);
+  }, [embedUrl, onCitationAction, onCitationClick, onReady, sendConfig, targetOrigin]);
   react.useEffect(() => {
     if (!embedUrl) return;
     sendConfig();