@athenaintel/react 0.53.1 → 0.54.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -1
- package/dist/agent-runtime/src/call-recap.cjs +2 -3
- package/dist/agent-runtime/src/call-recap.cjs.map +1 -1
- package/dist/agent-runtime/src/call-recap.d.ts +1 -2
- package/dist/agent-runtime/src/call-recap.js +1 -2
- package/dist/agent-runtime/src/call-recap.js.map +1 -1
- package/dist/agent-runtime/src/deep-agent-transport-recipe.cjs +7 -3
- package/dist/agent-runtime/src/deep-agent-transport-recipe.cjs.map +1 -1
- package/dist/agent-runtime/src/deep-agent-transport-recipe.d.ts +10 -2
- package/dist/agent-runtime/src/deep-agent-transport-recipe.js +8 -4
- package/dist/agent-runtime/src/deep-agent-transport-recipe.js.map +1 -1
- package/dist/agent-runtime/src/dictation-session.d.ts +158 -0
- package/dist/agent-runtime/src/edit-command.cjs +6 -0
- package/dist/agent-runtime/src/edit-command.cjs.map +1 -1
- package/dist/agent-runtime/src/edit-command.d.ts +8 -0
- package/dist/agent-runtime/src/edit-command.js +6 -0
- package/dist/agent-runtime/src/edit-command.js.map +1 -1
- package/dist/agent-runtime/src/generated/runconfig-contract.cjs +6 -0
- package/dist/agent-runtime/src/generated/runconfig-contract.cjs.map +1 -1
- package/dist/agent-runtime/src/generated/runconfig-contract.d.ts +13 -0
- package/dist/agent-runtime/src/generated/runconfig-contract.js +6 -0
- package/dist/agent-runtime/src/generated/runconfig-contract.js.map +1 -1
- package/dist/agent-runtime/src/index.d.ts +6 -6
- package/dist/agent-runtime/src/message-window.cjs +111 -7
- package/dist/agent-runtime/src/message-window.cjs.map +1 -1
- package/dist/agent-runtime/src/message-window.d.ts +66 -6
- package/dist/agent-runtime/src/message-window.js +112 -8
- package/dist/agent-runtime/src/message-window.js.map +1 -1
- package/dist/agent-runtime/src/offline-status.cjs.map +1 -1
- package/dist/agent-runtime/src/offline-status.d.ts +33 -0
- package/dist/agent-runtime/src/offline-status.js.map +1 -1
- package/dist/agent-runtime/src/runtime.d.ts +4 -3
- package/dist/agent-runtime/src/subagent-transcripts.cjs +23 -1
- package/dist/agent-runtime/src/subagent-transcripts.cjs.map +1 -1
- package/dist/agent-runtime/src/subagent-transcripts.js +25 -3
- package/dist/agent-runtime/src/subagent-transcripts.js.map +1 -1
- package/dist/agent-runtime/src/subagents.cjs +112 -0
- package/dist/agent-runtime/src/subagents.cjs.map +1 -1
- package/dist/agent-runtime/src/subagents.d.ts +103 -0
- package/dist/agent-runtime/src/subagents.js +113 -1
- package/dist/agent-runtime/src/subagents.js.map +1 -1
- package/dist/agent-runtime/src/thread-handoff-protocol.d.ts +37 -9
- package/dist/agent-runtime/src/thread-handoff.d.ts +1 -1
- package/dist/agent-runtime/src/tool-metadata.cjs +8 -0
- package/dist/agent-runtime/src/tool-metadata.cjs.map +1 -1
- package/dist/agent-runtime/src/tool-metadata.js +8 -0
- package/dist/agent-runtime/src/tool-metadata.js.map +1 -1
- package/dist/agent-runtime/src/use-deep-agent-thread.cjs +6 -0
- package/dist/agent-runtime/src/use-deep-agent-thread.cjs.map +1 -1
- package/dist/agent-runtime/src/use-deep-agent-thread.js +7 -1
- package/dist/agent-runtime/src/use-deep-agent-thread.js.map +1 -1
- package/dist/agent-runtime/src/use-deep-agent-window-sync.cjs +39 -10
- package/dist/agent-runtime/src/use-deep-agent-window-sync.cjs.map +1 -1
- package/dist/agent-runtime/src/use-deep-agent-window-sync.d.ts +14 -4
- package/dist/agent-runtime/src/use-deep-agent-window-sync.js +41 -12
- package/dist/agent-runtime/src/use-deep-agent-window-sync.js.map +1 -1
- package/dist/agent-runtime/src/use-thread-handoff-flow.d.ts +5 -9
- package/dist/agent-runtime/src/voice-presentation.cjs +34 -0
- package/dist/agent-runtime/src/voice-presentation.cjs.map +1 -1
- package/dist/agent-runtime/src/voice-presentation.d.ts +35 -0
- package/dist/agent-runtime/src/voice-presentation.js +34 -0
- package/dist/agent-runtime/src/voice-presentation.js.map +1 -1
- package/dist/assets/AthenaAssetEmbed.cjs +4 -2
- package/dist/assets/AthenaAssetEmbed.cjs.map +1 -1
- package/dist/assets/AthenaAssetEmbed.d.ts +17 -8
- package/dist/assets/AthenaAssetEmbed.js +4 -2
- package/dist/assets/AthenaAssetEmbed.js.map +1 -1
- package/dist/assets/use-asset-embed.cjs.map +1 -1
- package/dist/assets/use-asset-embed.d.ts +7 -5
- package/dist/assets/use-asset-embed.js.map +1 -1
- package/dist/auth/account-identity.cjs +69 -0
- package/dist/auth/account-identity.cjs.map +1 -0
- package/dist/auth/account-identity.d.ts +57 -0
- package/dist/auth/account-identity.js +69 -0
- package/dist/auth/account-identity.js.map +1 -0
- package/dist/chat/AthenaChat.cjs +1 -1
- package/dist/chat/AthenaChat.cjs.map +1 -1
- package/dist/chat/AthenaChat.js +1 -1
- package/dist/chat/AthenaChat.js.map +1 -1
- package/dist/chat/super-grouping/toolkit-map.cjs +1 -0
- package/dist/chat/super-grouping/toolkit-map.cjs.map +1 -1
- package/dist/chat/super-grouping/toolkit-map.js +1 -0
- package/dist/chat/super-grouping/toolkit-map.js.map +1 -1
- package/dist/chat/use-statewire-approval-request.cjs +5 -5
- package/dist/chat/use-statewire-approval-request.cjs.map +1 -1
- package/dist/chat/use-statewire-approval-request.d.ts +7 -0
- package/dist/chat/use-statewire-approval-request.js +5 -5
- package/dist/chat/use-statewire-approval-request.js.map +1 -1
- package/dist/chat-ui/mentions/use-account-workspace-id.cjs +18 -58
- package/dist/chat-ui/mentions/use-account-workspace-id.cjs.map +1 -1
- package/dist/chat-ui/mentions/use-account-workspace-id.js +18 -58
- package/dist/chat-ui/mentions/use-account-workspace-id.js.map +1 -1
- package/dist/chat-ui/messages/voice-delegation-card.cjs +93 -25
- package/dist/chat-ui/messages/voice-delegation-card.cjs.map +1 -1
- package/dist/chat-ui/messages/voice-delegation-card.d.ts +16 -7
- package/dist/chat-ui/messages/voice-delegation-card.js +95 -27
- package/dist/chat-ui/messages/voice-delegation-card.js.map +1 -1
- package/dist/chat-ui/thread/handoff-cursor.cjs +2 -2
- package/dist/chat-ui/thread/handoff-cursor.cjs.map +1 -1
- package/dist/chat-ui/thread/handoff-cursor.js +3 -3
- package/dist/chat-ui/thread/handoff-cursor.js.map +1 -1
- package/dist/collab/client.cjs +94 -6
- package/dist/collab/client.cjs.map +1 -1
- package/dist/collab/client.d.ts +27 -0
- package/dist/collab/client.js +94 -6
- package/dist/collab/client.js.map +1 -1
- package/dist/collab/index.d.ts +1 -1
- package/dist/keryx-http/src/initial-sync.cjs +121 -0
- package/dist/keryx-http/src/initial-sync.cjs.map +1 -0
- package/dist/keryx-http/src/initial-sync.d.ts +77 -0
- package/dist/keryx-http/src/initial-sync.js +104 -0
- package/dist/keryx-http/src/initial-sync.js.map +1 -0
- package/dist/keryx-http/src/unconfirmed-update-attributions.cjs +8 -0
- package/dist/keryx-http/src/unconfirmed-update-attributions.cjs.map +1 -1
- package/dist/keryx-http/src/unconfirmed-update-attributions.d.ts +6 -0
- package/dist/keryx-http/src/unconfirmed-update-attributions.js +8 -0
- package/dist/keryx-http/src/unconfirmed-update-attributions.js.map +1 -1
- package/dist/react/package.json.cjs +1 -1
- package/dist/react/package.json.js +1 -1
- package/dist/styles.css +1 -1
- package/dist/threads/api.cjs +1 -2
- package/dist/threads/api.cjs.map +1 -1
- package/dist/threads/api.d.ts +3 -2
- package/dist/threads/api.js +1 -2
- package/dist/threads/api.js.map +1 -1
- package/dist/threads/statewire-thread-list.cjs +5 -7
- package/dist/threads/statewire-thread-list.cjs.map +1 -1
- package/dist/threads/statewire-thread-list.js +7 -9
- package/dist/threads/statewire-thread-list.js.map +1 -1
- package/dist/tools/subagent-task-tool-ui.cjs +15 -5
- package/dist/tools/subagent-task-tool-ui.cjs.map +1 -1
- package/dist/tools/subagent-task-tool-ui.d.ts +5 -4
- package/dist/tools/subagent-task-tool-ui.js +16 -6
- package/dist/tools/subagent-task-tool-ui.js.map +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
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 DeepAgentConversionMemory,\n type DeepAgentMessageConversionOptions,\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 * The identity of one attach of a thread: the thread, the host's `attachKey`\n * and the lane epoch (`UseDeepAgentThreadOptions['laneEpoch']`). The transport\n * mount and every per-attach decision (snapshot seed, pooled hello, conversion\n * memory, the host's per-thread latches, send recovery) key off it, so a new\n * lane epoch is a new attach exactly like a thread switch.\n */\nexport function deepAgentAttachId({\n threadId,\n attachKey,\n laneEpoch = 0,\n}: {\n threadId: string;\n attachKey?: string | number | undefined;\n laneEpoch?: number;\n}): string {\n const attach = attachKey === undefined ? threadId : `${threadId}:${attachKey}`;\n return laneEpoch === 0 ? attach : `${attach}#lane-epoch:${laneEpoch}`;\n}\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 * Bumped when the durable lane this mount runs on is replaced by a lane of\n * another scope (another principal signed in, or another backend) while the\n * thread stays mounted; `useDeepAgentRuntime` derives it from the session\n * `key`. Each epoch remounts the whole statewire thread (its session with\n * the client id, lane clocks and journal it loaded, the session storage, the\n * composer and the thread state) instead of moving it to the new lane, and\n * is an attach identity of its own. Its first attach seeds nothing this tab\n * remembered of the thread and takes no dial pooled for it: both were\n * captured as the previous principal. It reads `isNewChat` afresh, so a\n * thread that persisted under the previous principal attaches at once.\n * Default 0.\n */\n laneEpoch?: 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. `reason` is the\n * connection message; a park with none (a `pending` session lane) reads\n * like a never-started chat.\n */\n suspended?: { reason?: string | undefined } | 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 * Render quiet tools (`QUIET_TOOL_NAMES`, e.g. `submit_feedback`) like any\n * other tool call. Off by default; pass it only for viewers allowed to see\n * them (Olympus: Athena's internal admins on managed cloud).\n */\n showQuietTools?: boolean;\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.31.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 * Set only by a surface that pages a cut lane's earlier steps wherever it\n * shows a lane's steps (`useDeepAgentLaneHistory`). Its attaches then\n * declare the lane-cut contract version, and the host sends a finished\n * `task` card with a deep transcript cut to its newest steps (see\n * `DeepAgentProtocolDeclaration`). Omitted, every attach declares the\n * default version and finished cards ride whole. Part of the transport\n * recipe: a prewarm controller for this thread must be given the same\n * value. Read once per attach.\n */\n laneHistory?: boolean;\n /**\n * Joins the interest window off the mounted documents; the default is\n * {@link readDeepAgentMessageWindow}. Olympus passes\n * `readDeepAgentFollowedWindow`, which also reads the lanes it follows onto\n * their `task` cards.\n */\n readMessageWindow?: typeof readDeepAgentMessageWindow;\n /**\n * Creates each attach's conversion memory; the default is\n * {@link createDeepAgentMessageConversionCache}. Olympus passes\n * `createSubagentTranscriptConversionCache`, which also turns each `task`\n * card's nested transcript into its tool-call part's `messages`.\n */\n createConversionCache?: (options: DeepAgentMessageConversionOptions) => DeepAgentConversionMemory;\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 laneEpoch = 0,\n suspended = false,\n capabilities,\n laneProjection = 'both',\n showQuietTools = false,\n selfAuthor = null,\n getMessageMetadata,\n adapters,\n diagnostics,\n snapshotCache,\n messageWindow,\n laneHistory = false,\n readMessageWindow = readDeepAgentMessageWindow,\n createConversionCache = createDeepAgentMessageConversionCache,\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 const laneHistoryRef = useRef(laneHistory);\n laneHistoryRef.current = laneHistory;\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`, a new lane epoch)\n // re-notifies the host exactly like a switch would — the host clears its\n // per-thread state on re-attach, so a snapshot that repeats the previous\n // status must not dedupe.\n const attachId: string = deepAgentAttachId({ threadId, attachKey, laneEpoch });\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: DeepAgentConversionMemory) => {\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 laneHistory: laneHistoryRef.current,\n });\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 // A new lane epoch enters the thread again, as another principal, so it pins\n // afresh: a thread that persisted under the previous principal attaches at\n // once and loads, rather than waiting for the new principal's first send.\n const preloadRef = useRef({ threadId, laneEpoch, preload: isNewChat });\n if (preloadRef.current.threadId !== threadId || preloadRef.current.laneEpoch !== laneEpoch)\n preloadRef.current = { threadId, laneEpoch, 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 //\n // The first attach of a new lane epoch belongs to another principal: what\n // this tab remembered of the thread, and a dial pooled for it, were captured\n // as the previous one. Neither seeds it, and the remembered state is dropped\n // so no later attach of the thread paints it either.\n const snapshotSeedRef = useRef<{\n attachId: string;\n laneEpoch: number;\n seed: DeepAgentStreamValues | undefined;\n } | null>(null);\n if (snapshotSeedRef.current === null || snapshotSeedRef.current.attachId !== attachId) {\n const preload = preloadRef.current.preload;\n const laneReplaced =\n snapshotSeedRef.current !== null && snapshotSeedRef.current.laneEpoch !== laneEpoch;\n if (laneReplaced) snapshotCache?.forget(threadId);\n let pooledState: DeepAgentStreamValues | undefined;\n if (prewarmPool?.has(threadId)) {\n if (preload || suspended || laneReplaced) {\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 || laneReplaced\n ? undefined\n : (pooledState ?? snapshotCache?.take(threadId));\n const seed = remembered ? toThreadSnapshotSeed(remembered) : undefined;\n snapshotSeedRef.current = { attachId, laneEpoch, 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 // A change in who may see quiet tools starts a new memory too, so every\n // message reconverts under the new setting.\n const conversionCacheRef = useRef<{\n attachId: string;\n showQuietTools: boolean;\n cache: DeepAgentConversionMemory;\n } | null>(null);\n if (\n conversionCacheRef.current === null ||\n conversionCacheRef.current.attachId !== attachId ||\n conversionCacheRef.current.showQuietTools !== showQuietTools\n ) {\n conversionCacheRef.current = {\n attachId,\n showQuietTools,\n cache: createConversionCache({ showQuietTools }),\n };\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 = readMessageWindow(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, readMessageWindow, threadId]\n );\n\n const thread = 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 laneHistory: laneHistoryRef.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 // A lane epoch is another principal's thread. The key remounts every\n // resource the previous one held (the statewire session, its storage, the\n // composer, the core's state) rather than moving them onto the new lane; the\n // client built from the element keeps its identity across the remount.\n return laneEpoch === 0 ? thread : withKey(`lane-epoch:${laneEpoch}`, thread);\n}\n"],"names":["conversionCache","_a"],"mappings":"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"}
|
|
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 readDeepAgentInterestDeclaration,\n readDeepAgentMessageWindow,\n} from './message-window';\nimport {\n convertDeepAgentState,\n createDeepAgentMaterialize,\n createDeepAgentMessageConversionCache,\n type DeepAgentConversionMemory,\n type DeepAgentMessageConversionOptions,\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 * The identity of one attach of a thread: the thread, the host's `attachKey`\n * and the lane epoch (`UseDeepAgentThreadOptions['laneEpoch']`). The transport\n * mount and every per-attach decision (snapshot seed, pooled hello, conversion\n * memory, the host's per-thread latches, send recovery) key off it, so a new\n * lane epoch is a new attach exactly like a thread switch.\n */\nexport function deepAgentAttachId({\n threadId,\n attachKey,\n laneEpoch = 0,\n}: {\n threadId: string;\n attachKey?: string | number | undefined;\n laneEpoch?: number;\n}): string {\n const attach = attachKey === undefined ? threadId : `${threadId}:${attachKey}`;\n return laneEpoch === 0 ? attach : `${attach}#lane-epoch:${laneEpoch}`;\n}\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 * Bumped when the durable lane this mount runs on is replaced by a lane of\n * another scope (another principal signed in, or another backend) while the\n * thread stays mounted; `useDeepAgentRuntime` derives it from the session\n * `key`. Each epoch remounts the whole statewire thread (its session with\n * the client id, lane clocks and journal it loaded, the session storage, the\n * composer and the thread state) instead of moving it to the new lane, and\n * is an attach identity of its own. Its first attach seeds nothing this tab\n * remembered of the thread and takes no dial pooled for it: both were\n * captured as the previous principal. It reads `isNewChat` afresh, so a\n * thread that persisted under the previous principal attaches at once.\n * Default 0.\n */\n laneEpoch?: 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. `reason` is the\n * connection message; a park with none (a `pending` session lane) reads\n * like a never-started chat.\n */\n suspended?: { reason?: string | undefined } | 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 * Render quiet tools (`QUIET_TOOL_NAMES`, e.g. `submit_feedback`) like any\n * other tool call. Off by default; pass it only for viewers allowed to see\n * them (Olympus: Athena's internal admins on managed cloud).\n */\n showQuietTools?: boolean;\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.31.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 * Set only by a surface that pages a cut lane's earlier steps wherever it\n * shows a lane's steps (`useDeepAgentLaneHistory`). Its attaches then\n * declare the lane-cut contract version, and the host sends a finished\n * `task` card with a deep transcript cut to its newest steps (see\n * `DeepAgentProtocolDeclaration`). Omitted, every attach declares the\n * default version and finished cards ride whole. Part of the transport\n * recipe: a prewarm controller for this thread must be given the same\n * value. Read once per attach.\n */\n laneHistory?: boolean;\n /**\n * Joins the interest window off the mounted documents; the default is\n * {@link readDeepAgentMessageWindow}. Olympus passes\n * `readDeepAgentFollowedWindow`, which also reads the lanes it follows onto\n * their `task` cards.\n */\n readMessageWindow?: typeof readDeepAgentMessageWindow;\n /**\n * Creates each attach's conversion memory; the default is\n * {@link createDeepAgentMessageConversionCache}. Olympus passes\n * `createSubagentTranscriptConversionCache`, which also turns each `task`\n * card's nested transcript into its tool-call part's `messages`.\n */\n createConversionCache?: (options: DeepAgentMessageConversionOptions) => DeepAgentConversionMemory;\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 laneEpoch = 0,\n suspended = false,\n capabilities,\n laneProjection = 'both',\n showQuietTools = false,\n selfAuthor = null,\n getMessageMetadata,\n adapters,\n diagnostics,\n snapshotCache,\n messageWindow,\n laneHistory = false,\n readMessageWindow = readDeepAgentMessageWindow,\n createConversionCache = createDeepAgentMessageConversionCache,\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 const laneHistoryRef = useRef(laneHistory);\n laneHistoryRef.current = laneHistory;\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 // The documents of the last pass whose interest window resolved: the view\n // the next re-attach declares (`x-athena-deep-agent-interests`), so its\n // hello carries every page loaded so far — a handover's reading position, a\n // search reveal, an edit's parent — on whichever host instance it lands.\n // They outlive a dropped connection until the next hello replaces them.\n const heldViewRef = useRef<{\n attachId: string;\n mounted: Parameters<typeof readDeepAgentInterestDeclaration>[0];\n } | 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`, a new lane epoch)\n // re-notifies the host exactly like a switch would — the host clears its\n // per-thread state on re-attach, so a snapshot that repeats the previous\n // status must not dedupe.\n const attachId: string = deepAgentAttachId({ threadId, attachKey, laneEpoch });\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: DeepAgentConversionMemory) => {\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 laneHistory: laneHistoryRef.current,\n });\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 // A new lane epoch enters the thread again, as another principal, so it pins\n // afresh: a thread that persisted under the previous principal attaches at\n // once and loads, rather than waiting for the new principal's first send.\n const preloadRef = useRef({ threadId, laneEpoch, preload: isNewChat });\n if (preloadRef.current.threadId !== threadId || preloadRef.current.laneEpoch !== laneEpoch)\n preloadRef.current = { threadId, laneEpoch, 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 //\n // The first attach of a new lane epoch belongs to another principal: what\n // this tab remembered of the thread, and a dial pooled for it, were captured\n // as the previous one. Neither seeds it, and the remembered state is dropped\n // so no later attach of the thread paints it either.\n const snapshotSeedRef = useRef<{\n attachId: string;\n laneEpoch: number;\n seed: DeepAgentStreamValues | undefined;\n } | null>(null);\n if (snapshotSeedRef.current === null || snapshotSeedRef.current.attachId !== attachId) {\n const preload = preloadRef.current.preload;\n const laneReplaced =\n snapshotSeedRef.current !== null && snapshotSeedRef.current.laneEpoch !== laneEpoch;\n if (laneReplaced) snapshotCache?.forget(threadId);\n let pooledState: DeepAgentStreamValues | undefined;\n if (prewarmPool?.has(threadId)) {\n if (preload || suspended || laneReplaced) {\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 || laneReplaced\n ? undefined\n : (pooledState ?? snapshotCache?.take(threadId));\n const seed = remembered ? toThreadSnapshotSeed(remembered) : undefined;\n snapshotSeedRef.current = { attachId, laneEpoch, 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 // A change in who may see quiet tools starts a new memory too, so every\n // message reconverts under the new setting.\n const conversionCacheRef = useRef<{\n attachId: string;\n showQuietTools: boolean;\n cache: DeepAgentConversionMemory;\n } | null>(null);\n if (\n conversionCacheRef.current === null ||\n conversionCacheRef.current.attachId !== attachId ||\n conversionCacheRef.current.showQuietTools !== showQuietTools\n ) {\n conversionCacheRef.current = {\n attachId,\n showQuietTools,\n cache: createConversionCache({ showQuietTools }),\n };\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 = readMessageWindow(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 if (window !== null) heldViewRef.current = { attachId, mounted: meta.mounted };\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, readMessageWindow, threadId]\n );\n\n const thread = 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 declaredInterests: () =>\n heldViewRef.current?.attachId === attachId\n ? readDeepAgentInterestDeclaration(heldViewRef.current.mounted)\n : null,\n laneHistory: laneHistoryRef.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 // A lane epoch is another principal's thread. The key remounts every\n // resource the previous one held (the statewire session, its storage, the\n // composer, the core's state) rather than moving them onto the new lane; the\n // client built from the element keeps its identity across the remount.\n return laneEpoch === 0 ? thread : withKey(`lane-epoch:${laneEpoch}`, thread);\n}\n"],"names":["conversionCache","_a"],"mappings":"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"}
|
|
@@ -7,6 +7,10 @@ const messageWindow = require("./message-window.cjs");
|
|
|
7
7
|
const threadExtras = require("./thread-extras.cjs");
|
|
8
8
|
const DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS = 3;
|
|
9
9
|
const DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS = 25;
|
|
10
|
+
function isOversizedInterestRejection(error) {
|
|
11
|
+
const failure = error == null ? void 0 : error.failure;
|
|
12
|
+
return (failure == null ? void 0 : failure.fate) === "rejected" && failure.code === runconfigContract.DEEP_AGENT_OVERSIZED_INTEREST_CODE;
|
|
13
|
+
}
|
|
10
14
|
const everyMessageMounted = () => true;
|
|
11
15
|
const defaultNow = () => Date.now();
|
|
12
16
|
const noopSubscribe = () => () => {
|
|
@@ -65,6 +69,10 @@ function useDeepAgentWindowSync({
|
|
|
65
69
|
const { sendCommand, invoke, connection } = useStatewireExtras();
|
|
66
70
|
const window = useDeepAgentMessageWindow();
|
|
67
71
|
const [loading, setLoading] = require$$0.useState(false);
|
|
72
|
+
const [spentDepth, setSpentDepth] = require$$0.useState(
|
|
73
|
+
null
|
|
74
|
+
);
|
|
75
|
+
const depthSpent = spentDepth !== null && window !== null && spentDepth.threadId === window.threadId && window.chain.length >= spentDepth.loaded;
|
|
68
76
|
const [requests, setRequests] = require$$0.useState(0);
|
|
69
77
|
const servedRequestsRef = require$$0.useRef(0);
|
|
70
78
|
const inflightRef = require$$0.useRef(false);
|
|
@@ -72,7 +80,7 @@ function useDeepAgentWindowSync({
|
|
|
72
80
|
const openingFillRef = require$$0.useRef(0);
|
|
73
81
|
const pageFromRef = require$$0.useRef(null);
|
|
74
82
|
const aliveRef = require$$0.useRef(true);
|
|
75
|
-
const
|
|
83
|
+
const heldRef = require$$0.useRef(null);
|
|
76
84
|
const restatedConnectionRef = require$$0.useRef(null);
|
|
77
85
|
const answeredRef = require$$0.useRef(/* @__PURE__ */ new Map());
|
|
78
86
|
const toolOutputsInFlightRef = require$$0.useRef(0);
|
|
@@ -91,19 +99,36 @@ function useDeepAgentWindowSync({
|
|
|
91
99
|
};
|
|
92
100
|
}, []);
|
|
93
101
|
require$$0.useEffect(() => {
|
|
94
|
-
if (connection.status !== "connected" ||
|
|
95
|
-
if (
|
|
102
|
+
if (connection.status !== "connected" || window === null) return;
|
|
103
|
+
if (restatedConnectionRef.current === connection) {
|
|
104
|
+
heldRef.current = window;
|
|
105
|
+
return;
|
|
106
|
+
}
|
|
96
107
|
restatedConnectionRef.current = connection;
|
|
97
|
-
const
|
|
98
|
-
|
|
99
|
-
|
|
108
|
+
const held = heldRef.current;
|
|
109
|
+
heldRef.current = window;
|
|
110
|
+
if (held === null || inflightRef.current || messageWindow.messageWindowCarries({ hello: window, held })) return;
|
|
111
|
+
if (held.threadId !== void 0 && window.threadId !== void 0 && held.threadId !== window.threadId) {
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
inflightRef.current = true;
|
|
115
|
+
setLoading(true);
|
|
116
|
+
invoke(runconfigContract.DEEP_AGENT_INTEREST_PROTOCOL, "set", [messageWindow.restatedInterestRequests({ held, hello: window })]).catch((error) => {
|
|
100
117
|
var _a;
|
|
101
118
|
(_a = onErrorRef.current) == null ? void 0 : _a.call(onErrorRef, error, "athena/interest");
|
|
119
|
+
}).finally(() => {
|
|
120
|
+
inflightRef.current = false;
|
|
121
|
+
if (aliveRef.current) setLoading(false);
|
|
102
122
|
});
|
|
103
123
|
}, [connection, invoke, window]);
|
|
104
124
|
require$$0.useEffect(() => {
|
|
105
125
|
var _a;
|
|
106
126
|
if (window === null || inflightRef.current) return;
|
|
127
|
+
if (depthSpent) {
|
|
128
|
+
servedRequestsRef.current = requests;
|
|
129
|
+
pageFromRef.current = null;
|
|
130
|
+
return;
|
|
131
|
+
}
|
|
107
132
|
const from = pageFromRef.current;
|
|
108
133
|
pageFromRef.current = null;
|
|
109
134
|
const lastPageUnseen = from !== null && from.count > 0 && !pageShowedEarlierMessage(from, messages);
|
|
@@ -143,7 +168,6 @@ function useDeepAgentWindowSync({
|
|
|
143
168
|
const startedAt = nowRef.current();
|
|
144
169
|
invoke(runconfigContract.DEEP_AGENT_INTEREST_PROTOCOL, "set", [stated]).then(() => {
|
|
145
170
|
var _a2;
|
|
146
|
-
statedRef.current = stated;
|
|
147
171
|
(_a2 = onHistoryLoadRef.current) == null ? void 0 : _a2.call(onHistoryLoadRef, {
|
|
148
172
|
page,
|
|
149
173
|
request,
|
|
@@ -153,6 +177,9 @@ function useDeepAgentWindowSync({
|
|
|
153
177
|
var _a2;
|
|
154
178
|
pageFromRef.current = null;
|
|
155
179
|
if (fillPage) openingFillRef.current = null;
|
|
180
|
+
if (isOversizedInterestRejection(error) && aliveRef.current) {
|
|
181
|
+
setSpentDepth({ threadId: window.threadId, loaded: window.chain.length });
|
|
182
|
+
}
|
|
156
183
|
(_a2 = onErrorRef.current) == null ? void 0 : _a2.call(onErrorRef, error, "athena/interest");
|
|
157
184
|
}).finally(() => {
|
|
158
185
|
inflightRef.current = false;
|
|
@@ -168,7 +195,8 @@ function useDeepAgentWindowSync({
|
|
|
168
195
|
invoke,
|
|
169
196
|
maxChainedLoads,
|
|
170
197
|
maxUnseenLoads,
|
|
171
|
-
pageSize
|
|
198
|
+
pageSize,
|
|
199
|
+
depthSpent
|
|
172
200
|
]);
|
|
173
201
|
require$$0.useEffect(() => {
|
|
174
202
|
var _a;
|
|
@@ -223,13 +251,14 @@ function useDeepAgentWindowSync({
|
|
|
223
251
|
setRequests((count) => count + 1);
|
|
224
252
|
}, []);
|
|
225
253
|
const canLoadOlder = require$$0.useMemo(
|
|
226
|
-
() => window !== null && messageWindow.pageInterestRequests(window, pageSize) !== null,
|
|
227
|
-
[window, pageSize]
|
|
254
|
+
() => window !== null && !depthSpent && messageWindow.pageInterestRequests(window, pageSize) !== null,
|
|
255
|
+
[window, pageSize, depthSpent]
|
|
228
256
|
);
|
|
229
257
|
return { window, hasOlder: (window == null ? void 0 : window.hasOlder) ?? false, canLoadOlder, loading, loadOlder };
|
|
230
258
|
}
|
|
231
259
|
exports.DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS = DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS;
|
|
232
260
|
exports.DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS = DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS;
|
|
261
|
+
exports.isOversizedInterestRejection = isOversizedInterestRejection;
|
|
233
262
|
exports.useDeepAgentMessageWindow = useDeepAgentMessageWindow;
|
|
234
263
|
exports.useDeepAgentWindowSync = useDeepAgentWindowSync;
|
|
235
264
|
//# sourceMappingURL=use-deep-agent-window-sync.cjs.map
|
|
@@ -1 +1 @@
|
|
|
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, DEEP_AGENT_MAX_MESSAGE_WINDOW } 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 *\n * A page loaded while the oldest loaded message is a reply lands inside that\n * reply's turn, so it asks for the host's largest window\n * (`DEEP_AGENT_MAX_MESSAGE_WINDOW`) instead of the thread's: a run of 373\n * tool calls is about 750 messages, nineteen round trips at the default\n * window and four at the largest, and the turn shows nothing new until its\n * prompt does. A page above a prompt keeps the thread's window.\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 /**\n * Cut tool outputs this mount reads at once; the rest wait for one to\n * settle. One mounted message can hold a whole agent run — a hundred tool\n * steps — and the host rate-limits a client's frames, so a reader that sends\n * them all together gets refusals back for most of them. Omitted: every\n * mounted output is asked for together (renderers whose mounted set is\n * already small).\n */\n maxConcurrentToolOutputs?: number;\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, at most\n * `maxConcurrentToolOutputs` at a time; the converter puts it back\n * (`toolOutputs`), so the card re-renders complete. An output the host\n * 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/** Whether a converted message is a turn's reply rather than its prompt (unknown without a role). */\nfunction isReply(message: DeepAgentWindowSyncMessage | undefined): boolean {\n return message?.role !== undefined && message.role !== 'user';\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 maxConcurrentToolOutputs = Number.POSITIVE_INFINITY,\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 // Reads this mount has in flight, and whether a pass left outputs waiting\n // for one to settle (`maxConcurrentToolOutputs`): only then does a settle\n // re-run the pass, so an unbounded mount renders no more than before.\n const toolOutputsInFlightRef = useRef(0);\n const toolOutputsWaitingRef = useRef(false);\n const [toolOutputSettles, setToolOutputSettles] = useState(0);\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 // The page continues the oldest loaded turn (see DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS).\n const insideTurn = lastPageUnseen || isReply(messages[0]);\n const stated =\n (insideTurn && pageInterestRequests(window, DEEP_AGENT_MAX_MESSAGE_WINDOW)) || pageRequests;\n pageFromRef.current = { count: messages.length, secondId: messages[1]?.id };\n const page = window.pages + 1;\n const request = stated[stated.length - 1] as DeepAgentInterestRequest;\n inflightRef.current = true;\n setLoading(true);\n const startedAt = nowRef.current();\n invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [stated])\n .then(() => {\n statedRef.current = stated;\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 toolOutputsWaitingRef.current = false;\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 if (toolOutputsInFlightRef.current >= maxConcurrentToolOutputs) {\n toolOutputsWaitingRef.current = true;\n return;\n }\n const { messageId, chars } = marker;\n toolOutputsInFlightRef.current += 1;\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 .finally(() => {\n toolOutputsInFlightRef.current -= 1;\n if (toolOutputsWaitingRef.current && aliveRef.current) {\n setToolOutputSettles((count) => count + 1);\n }\n });\n }\n }\n }, [\n messages,\n isMessageMounted,\n window,\n sendCommand,\n toolOutputs,\n maxConcurrentToolOutputs,\n toolOutputSettles,\n ]);\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","DEEP_AGENT_MAX_MESSAGE_WINDOW","_a","readTruncatedToolOutputArtifact","buildToolOutputCommand","readToolOutputResult","useCallback"],"mappings":"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"}
|
|
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 {\n DEEP_AGENT_INTEREST_PROTOCOL,\n DEEP_AGENT_MAX_MESSAGE_WINDOW,\n DEEP_AGENT_OVERSIZED_INTEREST_CODE,\n} from './generated/runconfig-contract';\nimport {\n buildToolOutputCommand,\n type DeepAgentInterestRequest,\n type DeepAgentMessageWindow,\n messageWindowCarries,\n pageInterestRequests,\n readDeepAgentMessageWindow,\n readToolOutputResult,\n readTruncatedToolOutputArtifact,\n restatedInterestRequests,\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 *\n * A page loaded while the oldest loaded message is a reply lands inside that\n * reply's turn, so it asks for the host's largest window\n * (`DEEP_AGENT_MAX_MESSAGE_WINDOW`) instead of the thread's: a run of 373\n * tool calls is about 750 messages, nineteen round trips at the default\n * window and four at the largest, and the turn shows nothing new until its\n * prompt does. A page above a prompt keeps the thread's window.\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 /**\n * Cut tool outputs this mount reads at once; the rest wait for one to\n * settle. One mounted message can hold a whole agent run — a hundred tool\n * steps — and the host rate-limits a client's frames, so a reader that sends\n * them all together gets refusals back for most of them. Omitted: every\n * mounted output is asked for together (renderers whose mounted set is\n * already small).\n */\n maxConcurrentToolOutputs?: number;\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 * view has room for them. `hasOlder && !canLoadOlder` is the depth limit —\n * an edge row says so instead of offering a dead button. The host bounds\n * one attach's view twice: `MAX_INTERESTS` requests, and an interest\n * document that lists every loaded message within a byte budget (about a\n * thousand messages). The second is found when the host refuses a page as\n * `oversized-interest` ({@link isOversizedInterestRejection}).\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, at the beginning, or once `canLoadOlder` is false. */\n loadOlder: () => void;\n}\n\n/**\n * Whether an `athena/interest` `set` came back refused because the windows it\n * states resolve past what one attach's interest document carries: the view\n * is as deep as this connection can load, and asking again only gets the same\n * refusal.\n */\nexport function isOversizedInterestRejection(error: unknown): boolean {\n const failure = (error as { failure?: { fate?: unknown; code?: unknown } } | null | undefined)\n ?.failure;\n return failure?.fate === 'rejected' && failure.code === DEEP_AGENT_OVERSIZED_INTEREST_CODE;\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 re-attach's hello carries the view the client declares on the attach\n * (`useDeepAgentThread`), every page in it however it was loaded (this\n * hook, a handover's or a search's reveal, an edit's parent). A hello that\n * does not carry the view the last connected session held — a host that\n * reads no declaration and has no memo of the client id — gets it stated\n * again ({@link restatedInterestRequests}).\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, at most\n * `maxConcurrentToolOutputs` at a time; the converter puts it back\n * (`toolOutputs`), so the card re-renders complete. An output the host\n * 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/** Whether a converted message is a turn's reply rather than its prompt (unknown without a role). */\nfunction isReply(message: DeepAgentWindowSyncMessage | undefined): boolean {\n return message?.role !== undefined && message.role !== 'user';\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 maxConcurrentToolOutputs = Number.POSITIVE_INFINITY,\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 // The view the host refused a page over as deeper than one attach holds\n // (`oversized-interest`): its conversation and how many messages it covered.\n // A view at least that large gets the same refusal (a run's appends only\n // grow it); one that shrank — an edit rewound the transcript, a re-attach\n // came back smaller — may fit a page again.\n const [spentDepth, setSpentDepth] = useState<{ threadId: string | undefined; loaded: number } | null>(\n null\n );\n const depthSpent =\n spentDepth !== null &&\n window !== null &&\n spentDepth.threadId === window.threadId &&\n window.chain.length >= spentDepth.loaded;\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 window the last connected session held, whoever paged it in, and the\n // session whose hello it was last checked against (a hello resets the\n // documents to what the host seeded).\n const heldRef = useRef<DeepAgentMessageWindow | 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 // Reads this mount has in flight, and whether a pass left outputs waiting\n // for one to settle (`maxConcurrentToolOutputs`): only then does a settle\n // re-run the pass, so an unbounded mount renders no more than before.\n const toolOutputsInFlightRef = useRef(0);\n const toolOutputsWaitingRef = useRef(false);\n const [toolOutputSettles, setToolOutputSettles] = useState(0);\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' || window === null) return;\n if (restatedConnectionRef.current === connection) {\n heldRef.current = window;\n return;\n }\n // Decided once per connected session, on the hello's interest document.\n restatedConnectionRef.current = connection;\n const held = heldRef.current;\n heldRef.current = window;\n // A page still in flight was stated over the held window: it restates it.\n if (held === null || inflightRef.current || messageWindowCarries({ hello: window, held })) return;\n // Another conversation's hello (the runtime switched threads under this mount).\n if (held.threadId !== undefined && window.threadId !== undefined && held.threadId !== window.threadId) {\n return;\n }\n // Held like a page, so no page is stated over it while it is in flight.\n inflightRef.current = true;\n setLoading(true);\n invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [restatedInterestRequests({ held, hello: window })])\n .catch((error: unknown) => {\n onErrorRef.current?.(error, 'athena/interest');\n })\n .finally(() => {\n inflightRef.current = false;\n if (aliveRef.current) setLoading(false);\n });\n }, [connection, invoke, window]);\n\n useEffect(() => {\n if (window === null || inflightRef.current) return;\n if (depthSpent) {\n // An ask now would get the same refusal: answer it here, so it never\n // reaches another conversation this mount switches to.\n servedRequestsRef.current = requests;\n pageFromRef.current = null;\n return;\n }\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 // The page continues the oldest loaded turn (see DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS).\n const insideTurn = lastPageUnseen || isReply(messages[0]);\n const stated =\n (insideTurn && pageInterestRequests(window, DEEP_AGENT_MAX_MESSAGE_WINDOW)) || pageRequests;\n pageFromRef.current = { count: messages.length, secondId: messages[1]?.id };\n const page = window.pages + 1;\n const request = stated[stated.length - 1] as DeepAgentInterestRequest;\n inflightRef.current = true;\n setLoading(true);\n const startedAt = nowRef.current();\n invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [stated])\n .then(() => {\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 if (isOversizedInterestRejection(error) && aliveRef.current) {\n setSpentDepth({ threadId: window.threadId, loaded: window.chain.length });\n }\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 depthSpent,\n ]);\n\n useEffect(() => {\n if (window === null || toolOutputs === undefined) return;\n toolOutputsWaitingRef.current = false;\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 if (toolOutputsInFlightRef.current >= maxConcurrentToolOutputs) {\n toolOutputsWaitingRef.current = true;\n return;\n }\n const { messageId, chars } = marker;\n toolOutputsInFlightRef.current += 1;\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 .finally(() => {\n toolOutputsInFlightRef.current -= 1;\n if (toolOutputsWaitingRef.current && aliveRef.current) {\n setToolOutputSettles((count) => count + 1);\n }\n });\n }\n }\n }, [\n messages,\n isMessageMounted,\n window,\n sendCommand,\n toolOutputs,\n maxConcurrentToolOutputs,\n toolOutputSettles,\n ]);\n\n const loadOlder = useCallback(() => {\n setRequests((count) => count + 1);\n }, []);\n\n const canLoadOlder = useMemo(\n () => window !== null && !depthSpent && pageInterestRequests(window, pageSize) !== null,\n [window, pageSize, depthSpent]\n );\n\n return { window, hasOlder: window?.hasOlder ?? false, canLoadOlder, loading, loadOlder };\n}\n"],"names":["DEEP_AGENT_OVERSIZED_INTEREST_CODE","useAuiState","hasStatewireThreadExtras","useSyncExternalStore","useMemo","readDeepAgentMessageWindow","useState","useRef","useEffect","messageWindowCarries","DEEP_AGENT_INTEREST_PROTOCOL","restatedInterestRequests","pageInterestRequests","DEEP_AGENT_MAX_MESSAGE_WINDOW","_a","readTruncatedToolOutputArtifact","buildToolOutputCommand","readToolOutputResult","useCallback"],"mappings":"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"}
|
|
@@ -94,16 +94,26 @@ export interface DeepAgentWindowSyncState {
|
|
|
94
94
|
hasOlder: boolean;
|
|
95
95
|
/**
|
|
96
96
|
* Whether the next page can be asked for: older messages exist and the
|
|
97
|
-
*
|
|
98
|
-
*
|
|
99
|
-
*
|
|
97
|
+
* view has room for them. `hasOlder && !canLoadOlder` is the depth limit —
|
|
98
|
+
* an edge row says so instead of offering a dead button. The host bounds
|
|
99
|
+
* one attach's view twice: `MAX_INTERESTS` requests, and an interest
|
|
100
|
+
* document that lists every loaded message within a byte budget (about a
|
|
101
|
+
* thousand messages). The second is found when the host refuses a page as
|
|
102
|
+
* `oversized-interest` ({@link isOversizedInterestRejection}).
|
|
100
103
|
*/
|
|
101
104
|
canLoadOlder: boolean;
|
|
102
105
|
/** A page of older history is in flight. */
|
|
103
106
|
loading: boolean;
|
|
104
|
-
/** Ask for the next page of older history now (an edge row's button, a keypress). A no-op before the head resolved
|
|
107
|
+
/** Ask for the next page of older history now (an edge row's button, a keypress). A no-op before the head resolved, at the beginning, or once `canLoadOlder` is false. */
|
|
105
108
|
loadOlder: () => void;
|
|
106
109
|
}
|
|
110
|
+
/**
|
|
111
|
+
* Whether an `athena/interest` `set` came back refused because the windows it
|
|
112
|
+
* states resolve past what one attach's interest document carries: the view
|
|
113
|
+
* is as deep as this connection can load, and asking again only gets the same
|
|
114
|
+
* refusal.
|
|
115
|
+
*/
|
|
116
|
+
export declare function isOversizedInterestRejection(error: unknown): boolean;
|
|
107
117
|
/** The joined interest window of the nearest statewire thread. */
|
|
108
118
|
export declare function useDeepAgentMessageWindow(): DeepAgentMessageWindow | null;
|
|
109
119
|
export declare function useDeepAgentWindowSync({ messages, pageSize, toolOutputs, nearTop, nearTopEpoch, isMessageMounted, maxConcurrentToolOutputs, maxChainedLoads, maxUnseenLoads, onHistoryLoad, onError, now, }: UseDeepAgentWindowSyncOptions): DeepAgentWindowSyncState;
|