@athenaintel/react 0.28.0 → 0.30.0

package/dist/{packages/agent-runtime → agent-runtime}/src/conversation-list.cjs

@@ -13,6 +13,9 @@ const CONVERSATION_LIST_DEFAULT_SCOPE_KEY = "default";
 function normalizeConversationListFilter(filter) {
   const normalized = {};
   if (filter.appId) normalized.appId = filter.appId;
+  if (filter.appIds && filter.appIds.length > 0) {
+    normalized.appIds = [...new Set(filter.appIds)].sort();
+  }
   if (filter.assetTypes && filter.assetTypes.length > 0) {
     normalized.assetTypes = [...filter.assetTypes].sort();
   }
@@ -99,12 +102,40 @@ function patchConversationsInPage(page, match, patch) {
   });
   return changed ? { ...page, items } : page;
 }
+function isInfinitePages(data) {
+  return "pages" in data;
+}
+function mapCachedPages(data, transform) {
+  if (!data) return data;
+  if (isInfinitePages(data)) {
+    let changed = false;
+    const pages = data.pages.map((page) => {
+      const next = transform(page);
+      if (next !== page) changed = true;
+      return next;
+    });
+    return changed ? { ...data, pages } : data;
+  }
+  return transform(data);
+}
 function scopedKey(options) {
   return (options == null ? void 0 : options.scopeKey) !== void 0 ? conversationListQueryKeys.scope(options.scopeKey) : conversationListQueryKeys.root;
 }
 function invalidateConversationListCaches(queryClient, options) {
   return queryClient.invalidateQueries({ queryKey: scopedKey(options) });
 }
+function patchConversationListCaches(queryClient, options) {
+  queryClient.setQueriesData(
+    { queryKey: scopedKey(options) },
+    (data) => mapCachedPages(data, (page) => patchConversationsInPage(page, options.match, options.patch))
+  );
+}
+function removeConversationFromListCaches(queryClient, options) {
+  queryClient.setQueriesData(
+    { queryKey: scopedKey(options) },
+    (data) => mapCachedPages(data, (page) => removeConversationFromPage(page, options.threadId))
+  );
+}
 function summaryFromConversationIndexEntry(entry, previous) {
   const carriesStatus = entry.run_status !== void 0 || entry.session_status !== void 0;
   return {
@@ -118,6 +149,8 @@ function summaryFromConversationIndexEntry(entry, previous) {
     assetType: entry.asset_type,
     assetId: entry.asset_id ?? (previous == null ? void 0 : previous.assetId) ?? null,
     computerAssetId: (previous == null ? void 0 : previous.computerAssetId) ?? null,
+    collabAgentId: previous == null ? void 0 : previous.collabAgentId,
+    collabChannelId: previous == null ? void 0 : previous.collabChannelId,
     parentSessionId: previous == null ? void 0 : previous.parentSessionId,
     subSessionCount: previous == null ? void 0 : previous.subSessionCount,
     appId: entry.app_id,
@@ -131,6 +164,7 @@ function summaryFromConversationIndexEntry(entry, previous) {
     nextAction: entry.next_action !== void 0 ? entry.next_action : previous == null ? void 0 : previous.nextAction,
     attentionSource: entry.attention_source !== void 0 ? entry.attention_source : previous == null ? void 0 : previous.attentionSource,
     isFavorited: entry.is_favorited ?? (previous == null ? void 0 : previous.isFavorited),
+    createdByMe: previous == null ? void 0 : previous.createdByMe,
     lastWake: previous == null ? void 0 : previous.lastWake,
     pullRequests: previous == null ? void 0 : previous.pullRequests
   };
@@ -145,8 +179,10 @@ exports.invalidateConversationListCaches = invalidateConversationListCaches;
 exports.isConversationRunning = isConversationRunning;
 exports.mergeConversationPages = mergeConversationPages;
 exports.normalizeConversationListFilter = normalizeConversationListFilter;
+exports.patchConversationListCaches = patchConversationListCaches;
 exports.patchConversationsInPage = patchConversationsInPage;
 exports.prependConversationToPage = prependConversationToPage;
+exports.removeConversationFromListCaches = removeConversationFromListCaches;
 exports.removeConversationFromPage = removeConversationFromPage;
 exports.summaryFromConversationIndexEntry = summaryFromConversationIndexEntry;
 //# sourceMappingURL=conversation-list.cjs.map

package/dist/agent-runtime/src/conversation-list.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-list.cjs","sources":["../../../../agent-runtime/src/conversation-list.ts"],"sourcesContent":["import type { InfiniteData, QueryClient } from '@tanstack/react-query';\nimport type { ConversationIndexEntry } from './conversation-index';\n\n/**\n * What a session asks of the viewer, derived server-side from the run, the\n * parked interrupt, the pull requests it opened, its termination and its last\n * wake (the Devin-style session list). `needs_you` is the only state that\n * demands the viewer act; `working` is live; `ready` finished with something\n * to look at; `watching` waits on an external party (a review, a check);\n * `done` and `error` are terminal. A backend newer than this client may report\n * a value outside the union — render it as \"no attention\" rather than failing.\n */\nexport type ConversationAttention =\n  | 'needs_you'\n  | 'working'\n  | 'ready'\n  | 'watching'\n  | 'done'\n  | 'error';\n\nexport const CONVERSATION_ATTENTIONS: readonly ConversationAttention[] = [\n  'needs_you',\n  'working',\n  'ready',\n  'watching',\n  'done',\n  'error',\n];\n\n/** Which signal produced the attention state (and the `nextAction` copy). */\nexport type ConversationAttentionSource =\n  | 'interrupt'\n  | 'run'\n  | 'pull_request'\n  | 'termination'\n  | 'wake'\n  | 'handoff'\n  | 'follow_up';\n\n/** The last event that woke a resting session (a GitHub webhook, a schedule, a handoff). */\nexport interface ConversationWake {\n  source: string | null;\n  reason: string | null;\n  /** ISO 8601 timestamp of the wake. */\n  at: string | null;\n}\n\n/**\n * Live GitHub state of a pull request the session opened, read by the server\n * when the list renders. Never pushed by the conversation index — it comes\n * from the list fetch only, so a fold keeps the fetched value.\n */\nexport interface ConversationPullRequest {\n  /** `owner/repo` the pull request lives in. */\n  repoFullName: string;\n  number: number;\n  url: string;\n  title: string;\n  state: 'OPEN' | 'CLOSED' | 'MERGED';\n  isDraft: boolean;\n  /** GitHub's review decision (APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED) or null. */\n  reviewDecision: string | null;\n  /** Combined state of the checks on the head commit. */\n  checksState: 'SUCCESS' | 'FAILURE' | 'PENDING' | 'NONE';\n  /** ISO 8601 timestamp of the pull request's last update on GitHub. */\n  updatedAt: string;\n}\n\n/**\n * Shared conversation/thread LIST contract (chat-stack unification —\n * thread-list-contract-convergence).\n *\n * Every chat surface lists \"my conversations\" against the same underlying\n * session assets, but historically each declared its own row shape, paging\n * model, and filter set (Olympus GraphQL `listConversations`, the SDK/Chrome\n * REST `/api/conversations/threads/list`, mobile's `/api/v0/sessions`). This\n * module is the ONE contract those surfaces converge on:\n *\n * - **Row shape**: {@link ConversationSummary} — the canonical camelCase\n *   superset. Fields a transport cannot supply are `null`, never invented.\n * - **Ordering**: newest first by `updatedAt`, always. Ordering is part of the\n *   contract, not a parameter — no surface sorts any other way.\n * - **Paging**: offset/limit with a LIVE newest page and explicitly-fetched\n *   frozen history pages (see `useConversationList`). `hasMore` continues the\n *   scan; `totalCount` is advisory and may be `null` for transports that do\n *   not count.\n * - **Filtering**: {@link ConversationListFilter}. `appId` follows\n *   `docs/SESSION_APP_ID_GUIDE.md`: exact match when set (legacy `null`\n *   sessions excluded), no filter when unset. A fetcher that cannot express a\n *   requested filter field MUST throw rather than silently ignore it — a\n *   dropped filter returns wrong rows under a cache key that claims otherwise.\n * - **Freshness**: the per-user conversation-index statewire\n *   (`conversation-index.ts`) is the push signal; these queries are the data\n *   source. Push handlers call {@link invalidateConversationListCaches}.\n */\nexport interface ConversationSummary {\n  /** LangGraph thread id — the cross-surface conversation identity. */\n  threadId: string;\n  title: string;\n  /** ISO 8601 timestamp of last update (the contract's sort key). */\n  updatedAt: string;\n  /** ISO 8601 creation timestamp, when the transport reports it. */\n  createdAt: string | null;\n  /** Session lifecycle state from athena_metadata (e.g. running, completed). */\n  state: string | null;\n  /** Agent runtime marker (e.g. 'athena_deep_agent'), when reported. */\n  runtime: string | null;\n  /** Channel the session was started from (e.g. agent_email, web). */\n  sourceChannel: string | null;\n  /** Asset type (session, video_session, desktop_session, mobile_session). */\n  assetType: string | null;\n  /** Session asset id (`asset_<uuid>`), when the transport reports it. */\n  assetId: string | null;\n  /** Client app that created the session (SESSION_APP_ID_GUIDE). */\n  appId: string | null;\n  /** Computer asset whose sandbox started the session (`sourceChannel` 'computer'); omitted by surfaces that don't carry it. */\n  computerAssetId?: string | null;\n  /**\n   * Collab agent (`asset_<uuid>`) and channel the session started on; `null`\n   * channel is the agent's default channel. The server refuses a run on another\n   * of the agent's channels, so a client shows the session's mode from these\n   * instead of remembering it. Omitted by surfaces that don't carry them.\n   */\n  collabAgentId?: string | null;\n  collabChannelId?: string | null;\n  /** Session asset id this row is a sub-session of; omitted by surfaces that don't carry it. */\n  parentSessionId?: string | null;\n  /** Sub-sessions of this row the viewer can see; omitted by surfaces that don't carry it. */\n  subSessionCount?: number;\n  /** Trigger marker (`manual` remains user-initiated; other values are automated). */\n  triggerType: string | null;\n  /** Last-message preview used when a legacy session has no useful title. */\n  preview: string | null;\n  messageCount: number | null;\n  /** Per-user unread flag derived server-side from the read receipt. */\n  isUnread: boolean;\n  /**\n   * Canonical session status (status_v2: idle | active | needs_input | error),\n   * or null when the transport does not report it.\n   */\n  sessionStatus: string | null;\n  /**\n   * Canonical status of the session's current run (status_v2: scheduled |\n   * queued | running | needs_input | completed | failed | canceled). Null when\n   * the transport does not report it — {@link isConversationRunning} then\n   * falls back to the legacy `state`. Running badges on every surface derive\n   * from this one helper so they cannot disagree.\n   */\n  runStatus: string | null;\n  /**\n   * Server-derived attention state. `undefined` when the transport (or an\n   * older server) does not report it — {@link deriveConversationAttention}\n   * then falls back to the status planes; `null` when the server reports none.\n   */\n  attention?: ConversationAttention | null;\n  /** One line (≤ 80 chars) of what the viewer should do next, when the server derives one. */\n  nextAction?: string | null;\n  /** Which signal produced `attention` / `nextAction`. */\n  attentionSource?: ConversationAttentionSource | null;\n  /** Whether the viewer pinned (favorited) the session; `undefined` when not reported. */\n  isFavorited?: boolean;\n  /**\n   * Whether the viewer started the session (`false`: it is shared with them);\n   * `undefined` when not reported. Never pushed by the conversation index, so\n   * a fold keeps the fetched value.\n   */\n  createdByMe?: boolean;\n  /** The last wake of a resting session; `undefined` when not reported. */\n  lastWake?: ConversationWake | null;\n  /**\n   * Pull requests the session opened with their live GitHub state. `[]` when\n   * it opened none, `null` when the state could not be read right now,\n   * `undefined` when the transport did not ask for (or report) it.\n   */\n  pullRequests?: ConversationPullRequest[] | null;\n}\n\n/**\n * The canonical filter set. Semantics are defined here once; each fetcher\n * translates the fields its transport supports and throws on the rest.\n */\nexport interface ConversationListFilter {\n  /** Exact-match client app filter; unset = all apps (SESSION_APP_ID_GUIDE). */\n  appId?: string;\n  /**\n   * Sessions of any of these client apps too, a union with `appId` (REST thread\n   * list only today). A host lists an earlier app's sessions beside its own.\n   */\n  appIds?: readonly string[];\n  /** Asset types to include (e.g. ['session']); unset = all session types. */\n  assetTypes?: readonly string[];\n  /** Case-insensitive title search. */\n  search?: string;\n  /** Hide triggered/background sessions (REST thread list only today). */\n  excludeTriggered?: boolean;\n  /** Start-channel filter (v0 sessions / REST thread list only today). */\n  sourceChannels?: readonly string[];\n  /** Start channels to hide (e.g. ['api']); GraphQL `listConversations` only today. */\n  excludeSourceChannels?: readonly string[];\n  /** Exact computer asset whose sandbox started the session; GraphQL `listConversations` only today. */\n  computerAssetId?: string;\n  /** Only the sub-sessions of this session asset id; GraphQL `listConversations` only today. */\n  parentSessionId?: string;\n  /**\n   * Lifecycle-state filter (e.g. ['running'], ['completed']). Transports match\n   * it with the shared status_v2 rule (running carries a 12-hour recency cutoff).\n   */\n  states?: readonly string[];\n  /** Restrict to sessions run by any of these agents (athena_metadata.agent). */\n  agentIds?: readonly string[];\n  /**\n   * Include branched sub-sessions and orchestration children, which every list\n   * hides by default because they belong under their parent thread.\n   */\n  includeSubSessions?: boolean;\n}\n\nexport interface ConversationListPage {\n  /** Rows in contract order (updatedAt desc). */\n  items: ConversationSummary[];\n  /** Whether another `offset + limit` scan would return more rows. */\n  hasMore: boolean;\n  /** Total matching rows, or null when the transport does not count. */\n  totalCount: number | null;\n}\n\nexport interface ConversationListFetchParams {\n  limit: number;\n  offset: number;\n  filter: ConversationListFilter;\n  signal?: AbortSignal;\n}\n\n/**\n * One page fetch against some transport (GraphQL `listConversations`, the\n * REST thread list, …). Must reject on filter fields it cannot express.\n */\nexport type ConversationListFetcher = (\n  params: ConversationListFetchParams\n) => Promise<ConversationListPage>;\n\n/** Root of every conversation-list query key (all surfaces, all filters). */\nexport const CONVERSATION_LIST_QUERY_KEY_ROOT = 'athena-conversation-list';\n\n/**\n * Scope used by `useConversationList` when the caller passes no `scopeKey`.\n * Exported so cache seeders (e.g. Olympus's spacesBootstrap adoption) can\n * address the exact keys default-scoped hooks read from.\n */\nexport const CONVERSATION_LIST_DEFAULT_SCOPE_KEY = 'default';\n\n/**\n * Normalize a filter to its semantic content: unset/empty fields are dropped\n * (so `{}` and `{ appId: undefined }` are the same filter) and array order is\n * canonicalized. Fetchers receive the normalized form, so what a cache entry\n * claims to hold is exactly what was fetched.\n */\nexport function normalizeConversationListFilter(\n  filter: ConversationListFilter\n): ConversationListFilter {\n  const normalized: ConversationListFilter = {};\n  if (filter.appId) normalized.appId = filter.appId;\n  if (filter.appIds && filter.appIds.length > 0) {\n    normalized.appIds = [...new Set(filter.appIds)].sort();\n  }\n  if (filter.assetTypes && filter.assetTypes.length > 0) {\n    normalized.assetTypes = [...filter.assetTypes].sort();\n  }\n  if (filter.search) normalized.search = filter.search;\n  if (filter.excludeTriggered !== undefined) normalized.excludeTriggered = filter.excludeTriggered;\n  if (filter.sourceChannels && filter.sourceChannels.length > 0) {\n    normalized.sourceChannels = [...filter.sourceChannels].sort();\n  }\n  if (filter.excludeSourceChannels && filter.excludeSourceChannels.length > 0) {\n    normalized.excludeSourceChannels = [...filter.excludeSourceChannels].sort();\n  }\n  if (filter.computerAssetId) normalized.computerAssetId = filter.computerAssetId;\n  if (filter.parentSessionId) normalized.parentSessionId = filter.parentSessionId;\n  if (filter.states && filter.states.length > 0) {\n    normalized.states = [...filter.states].sort();\n  }\n  if (filter.agentIds && filter.agentIds.length > 0) {\n    normalized.agentIds = [...filter.agentIds].sort();\n  }\n  if (filter.includeSubSessions) normalized.includeSubSessions = true;\n  return normalized;\n}\n\n/** status_v2 run statuses during which a session is actively working. */\nconst RUNNING_RUN_STATUSES: ReadonlySet<string> = new Set(['queued', 'running']);\n\n/**\n * THE running rule for every conversation-list surface (sidebar pane, recent\n * dropdown, workspace section, pushed index rows): the canonical status_v2 run\n * status when the transport reports one, else the legacy `state`. A session\n * paused on a human gate (`needs_input`) is not running.\n */\nexport function isConversationRunning(summary: {\n  runStatus?: string | null;\n  state?: string | null;\n}): boolean {\n  if (summary.runStatus !== null && summary.runStatus !== undefined) {\n    return RUNNING_RUN_STATUSES.has(summary.runStatus);\n  }\n  return summary.state === 'running';\n}\n\nconst KNOWN_ATTENTIONS: ReadonlySet<string> = new Set(CONVERSATION_ATTENTIONS);\n\n/**\n * THE attention rule for every session-list surface: the server-derived\n * `attention` when the transport reports one it knows, else a client fallback\n * from the status planes so an older server still yields the two states a\n * list cannot do without — a human gate reads as `needs_you`, a live run as\n * `working`, a failed run as `error`. `null` when nothing applies.\n */\nexport function deriveConversationAttention(\n  summary: Pick<ConversationSummary, 'attention' | 'runStatus' | 'sessionStatus' | 'state'>\n): ConversationAttention | null {\n  if (typeof summary.attention === 'string' && KNOWN_ATTENTIONS.has(summary.attention)) {\n    return summary.attention;\n  }\n  if (summary.runStatus === 'needs_input' || summary.sessionStatus === 'needs_input') {\n    return 'needs_you';\n  }\n  if (isConversationRunning(summary)) return 'working';\n  if (summary.runStatus === 'failed' || summary.sessionStatus === 'error') return 'error';\n  return null;\n}\n\n/**\n * Stable cache identity for a filter: the normalized fields serialized in\n * sorted key order, so semantically equal filters share one cache entry.\n */\nexport function conversationListFilterKey(filter: ConversationListFilter): string {\n  const normalized = normalizeConversationListFilter(filter) as Record<string, unknown>;\n  return JSON.stringify(\n    Object.keys(normalized)\n      .sort()\n      .map((key) => [key, normalized[key]])\n  );\n}\n\n/**\n * Query keys for the two-tier pager. `scopeKey` isolates caches beyond the\n * filter — surfaces MUST include everything that changes whose list this is\n * (principal/user id, backend base URL) so a credential swap can never read\n * another identity's rows out of the cache.\n *\n * `pageSize` is part of the key because it is baked into every cached page's\n * offset boundaries: two hooks sharing a scope and filter but paging by\n * different sizes would otherwise reuse each other's incompatible boundaries\n * and skip or duplicate rows.\n */\nexport const conversationListQueryKeys = {\n  root: [CONVERSATION_LIST_QUERY_KEY_ROOT] as const,\n  scope: (scopeKey: string) => [CONVERSATION_LIST_QUERY_KEY_ROOT, scopeKey] as const,\n  firstPage: (scopeKey: string, filterKey: string, pageSize: number) =>\n    [CONVERSATION_LIST_QUERY_KEY_ROOT, scopeKey, filterKey, pageSize, 'first-page'] as const,\n  history: (scopeKey: string, filterKey: string, pageSize: number) =>\n    [CONVERSATION_LIST_QUERY_KEY_ROOT, scopeKey, filterKey, pageSize, 'history'] as const,\n};\n\n/**\n * Flatten pages into one newest-first list, deduplicating by `threadId`.\n * The live first page wins over retained history copies of the same thread.\n */\nexport function mergeConversationPages(\n  pages: readonly ConversationListPage[]\n): ConversationSummary[] {\n  const seen = new Set<string>();\n  const items: ConversationSummary[] = [];\n  for (const page of pages) {\n    for (const item of page.items) {\n      if (seen.has(item.threadId)) continue;\n      seen.add(item.threadId);\n      items.push(item);\n    }\n  }\n  return items;\n}\n\n/**\n * Prepend a conversation to a page unless its thread is already present\n * (optimistic \"new thread appears at the top\" write). Identity-preserving\n * no-op when present, so equal writes never notify subscribers.\n */\nexport function prependConversationToPage(\n  page: ConversationListPage,\n  item: ConversationSummary\n): ConversationListPage {\n  if (page.items.some((existing) => existing.threadId === item.threadId)) return page;\n  return {\n    ...page,\n    items: [item, ...page.items],\n    totalCount: page.totalCount === null ? null : page.totalCount + 1,\n  };\n}\n\n/** Remove a thread's row from a page; identity-preserving when absent. */\nexport function removeConversationFromPage(\n  page: ConversationListPage,\n  threadId: string\n): ConversationListPage {\n  if (!page.items.some((item) => item.threadId === threadId)) return page;\n  return { ...page, items: page.items.filter((item) => item.threadId !== threadId) };\n}\n\n/**\n * Patch every row matching `match`; identity-preserving when nothing matches\n * so cache writes cannot cause spurious re-renders.\n */\nexport function patchConversationsInPage(\n  page: ConversationListPage,\n  match: (item: ConversationSummary) => boolean,\n  patch: Partial<ConversationSummary>\n): ConversationListPage {\n  let changed = false;\n  const items = page.items.map((item) => {\n    if (!match(item)) return item;\n    changed = true;\n    return { ...item, ...patch };\n  });\n  return changed ? { ...page, items } : page;\n}\n\ntype CachedConversationList =\n  | ConversationListPage\n  | InfiniteData<ConversationListPage, number>\n  | undefined;\n\nfunction isInfinitePages(\n  data: ConversationListPage | InfiniteData<ConversationListPage, number>\n): data is InfiniteData<ConversationListPage, number> {\n  return 'pages' in data;\n}\n\nfunction mapCachedPages(\n  data: CachedConversationList,\n  transform: (page: ConversationListPage) => ConversationListPage\n): CachedConversationList {\n  if (!data) return data;\n  if (isInfinitePages(data)) {\n    let changed = false;\n    const pages = data.pages.map((page) => {\n      const next = transform(page);\n      if (next !== page) changed = true;\n      return next;\n    });\n    return changed ? { ...data, pages } : data;\n  }\n  return transform(data);\n}\n\ninterface ConversationListCacheScope {\n  /** Restrict to one scope; omitted = every conversation-list cache. */\n  scopeKey?: string;\n}\n\nfunction scopedKey(options?: ConversationListCacheScope): readonly string[] {\n  return options?.scopeKey !== undefined\n    ? conversationListQueryKeys.scope(options.scopeKey)\n    : conversationListQueryKeys.root;\n}\n\n/**\n * Invalidate conversation-list caches (all filters, first page + history).\n * This is the hook for push signals — the conversation-index statewire, a\n * finished run, an archive/restore — anything that changed the server list.\n */\nexport function invalidateConversationListCaches(\n  queryClient: QueryClient,\n  options?: ConversationListCacheScope\n): Promise<void> {\n  return queryClient.invalidateQueries({ queryKey: scopedKey(options) });\n}\n\n/** Cancel in-flight list fetches so an optimistic write cannot be overwritten. */\nexport function cancelConversationListCaches(\n  queryClient: QueryClient,\n  options?: ConversationListCacheScope\n): Promise<void> {\n  return queryClient.cancelQueries({ queryKey: scopedKey(options) });\n}\n\n/**\n * Patch matching rows in every cached conversation list (first pages, history\n * pages, searches) so per-row state (read receipts, titles) flips in the same\n * frame as the interaction instead of after the next refetch.\n */\nexport function patchConversationListCaches(\n  queryClient: QueryClient,\n  options: ConversationListCacheScope & {\n    match: (item: ConversationSummary) => boolean;\n    patch: Partial<ConversationSummary>;\n  }\n): void {\n  queryClient.setQueriesData<CachedConversationList>({ queryKey: scopedKey(options) }, (data) =>\n    mapCachedPages(data, (page) => patchConversationsInPage(page, options.match, options.patch))\n  );\n}\n\n/** Remove a thread's row from every cached conversation list in scope. */\nexport function removeConversationFromListCaches(\n  queryClient: QueryClient,\n  options: ConversationListCacheScope & { threadId: string }\n): void {\n  queryClient.setQueriesData<CachedConversationList>({ queryKey: scopedKey(options) }, (data) =>\n    mapCachedPages(data, (page) => removeConversationFromPage(page, options.threadId))\n  );\n}\n\nfunction timestampMs(value: string): number {\n  const parsed = Date.parse(value);\n  return Number.isNaN(parsed) ? 0 : parsed;\n}\n\nfunction sameSummary(a: ConversationSummary, b: ConversationSummary): boolean {\n  return (\n    a.threadId === b.threadId &&\n    a.title === b.title &&\n    a.updatedAt === b.updatedAt &&\n    a.createdAt === b.createdAt &&\n    a.state === b.state &&\n    a.runtime === b.runtime &&\n    a.sourceChannel === b.sourceChannel &&\n    a.assetType === b.assetType &&\n    a.assetId === b.assetId &&\n    a.appId === b.appId &&\n    a.triggerType === b.triggerType &&\n    a.preview === b.preview &&\n    a.messageCount === b.messageCount &&\n    a.isUnread === b.isUnread &&\n    a.sessionStatus === b.sessionStatus &&\n    a.runStatus === b.runStatus &&\n    a.attention === b.attention &&\n    a.nextAction === b.nextAction &&\n    a.attentionSource === b.attentionSource &&\n    a.isFavorited === b.isFavorited &&\n    // Never pushed by the index, so a fold carries the previous references\n    // through unchanged; identity is the equality that matters here.\n    a.lastWake === b.lastWake &&\n    a.pullRequests === b.pullRequests\n  );\n}\n\n/**\n * Project one replicated conversation-index row onto the shared summary shape.\n * Fields the index never carries (`createdAt`) and viewer-specific fields a\n * lifecycle publish cannot know (`is_unread: null`) keep the row's previous\n * value. Canonical status is taken from the entry when the publishing pod\n * reports it; a snapshot from a pod that predates the fields falls back to the\n * legacy `state` (null status) rather than keeping a stale run status.\n *\n * Attention fields (`attention`, `next_action`, `attention_source`,\n * `is_favorited`) are taken from the entry when the publishing pod reports\n * them, so a live push flips a row to \"needs you\" the way it renames it; a\n * pod that predates them leaves the row's previous values. Pull-request state,\n * the last wake and `createdByMe` are never pushed and always keep the fetched\n * value.\n */\nexport function summaryFromConversationIndexEntry(\n  entry: ConversationIndexEntry,\n  previous?: ConversationSummary\n): ConversationSummary {\n  const carriesStatus = entry.run_status !== undefined || entry.session_status !== undefined;\n  return {\n    threadId: entry.thread_id,\n    title: entry.title,\n    updatedAt: entry.updated_at,\n    createdAt: previous?.createdAt ?? null,\n    state: entry.state,\n    runtime: entry.runtime,\n    sourceChannel: entry.start_channel,\n    assetType: entry.asset_type,\n    assetId: entry.asset_id ?? previous?.assetId ?? null,\n    computerAssetId: previous?.computerAssetId ?? null,\n    collabAgentId: previous?.collabAgentId,\n    collabChannelId: previous?.collabChannelId,\n    parentSessionId: previous?.parentSessionId,\n    subSessionCount: previous?.subSessionCount,\n    appId: entry.app_id,\n    triggerType: entry.trigger_type,\n    preview: entry.last_message_preview,\n    messageCount: entry.message_count,\n    isUnread: entry.is_unread ?? previous?.isUnread ?? false,\n    sessionStatus: carriesStatus ? (entry.session_status ?? null) : null,\n    runStatus: carriesStatus ? (entry.run_status ?? null) : null,\n    attention: entry.attention !== undefined ? entry.attention : previous?.attention,\n    nextAction: entry.next_action !== undefined ? entry.next_action : previous?.nextAction,\n    attentionSource:\n      entry.attention_source !== undefined ? entry.attention_source : previous?.attentionSource,\n    isFavorited: entry.is_favorited ?? previous?.isFavorited,\n    createdByMe: previous?.createdByMe,\n    lastWake: previous?.lastWake,\n    pullRequests: previous?.pullRequests,\n  };\n}\n\n/**\n * Fold the user's replicated conversation index (the newest-page window the\n * per-user statewire pushes) into a cached live first page, so a thread\n * created, renamed, finished, or read anywhere updates every list surface in\n * the same frame — without refetching the page.\n *\n * - Rows in the window are upserted (new threads appear, existing rows take\n *   the pushed fields, see {@link summaryFromConversationIndexEntry}).\n * - Rows NOT in the window but at least as new as the window's oldest row\n *   should have been in it, so they left the list (archived, hidden, shared\n *   away) and are dropped. Older rows are beyond the window and are kept.\n * - When the index reports no further rows (`indexHasMore === false`) the\n *   window IS the whole list, so every row outside it is dropped.\n *\n * Newest-first ordering is restored and the page identity is preserved when\n * nothing changed, so an equal push never notifies subscribers.\n */\nexport function mergeConversationIndexIntoPage(\n  page: ConversationListPage,\n  entries: readonly ConversationIndexEntry[],\n  options: { indexHasMore: boolean }\n): ConversationListPage {\n  const previousByThread = new Map(page.items.map((item) => [item.threadId, item]));\n  const inWindow = new Set(entries.map((entry) => entry.thread_id));\n  const windowTailMs =\n    entries.length > 0 ? Math.min(...entries.map((entry) => timestampMs(entry.updated_at))) : null;\n\n  const merged: ConversationSummary[] = entries.map((entry) => {\n    const previous = previousByThread.get(entry.thread_id);\n    const next = summaryFromConversationIndexEntry(entry, previous);\n    return previous && sameSummary(previous, next) ? previous : next;\n  });\n\n  for (const item of page.items) {\n    if (inWindow.has(item.threadId)) continue;\n    if (!options.indexHasMore) continue;\n    if (windowTailMs !== null && timestampMs(item.updatedAt) >= windowTailMs) continue;\n    merged.push(item);\n  }\n\n  merged.sort((a, b) => timestampMs(b.updatedAt) - timestampMs(a.updatedAt));\n\n  const unchanged =\n    merged.length === page.items.length &&\n    merged.every((item, index) => item === page.items[index]);\n  if (unchanged) return page;\n\n  return { ...page, items: merged };\n}\n"],"names":[],"mappings":"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"}

package/dist/{packages/agent-runtime → agent-runtime}/src/conversation-list.js

@@ -11,6 +11,9 @@ const CONVERSATION_LIST_DEFAULT_SCOPE_KEY = "default";
 function normalizeConversationListFilter(filter) {
   const normalized = {};
   if (filter.appId) normalized.appId = filter.appId;
+  if (filter.appIds && filter.appIds.length > 0) {
+    normalized.appIds = [...new Set(filter.appIds)].sort();
+  }
   if (filter.assetTypes && filter.assetTypes.length > 0) {
     normalized.assetTypes = [...filter.assetTypes].sort();
   }
@@ -97,12 +100,40 @@ function patchConversationsInPage(page, match, patch) {
   });
   return changed ? { ...page, items } : page;
 }
+function isInfinitePages(data) {
+  return "pages" in data;
+}
+function mapCachedPages(data, transform) {
+  if (!data) return data;
+  if (isInfinitePages(data)) {
+    let changed = false;
+    const pages = data.pages.map((page) => {
+      const next = transform(page);
+      if (next !== page) changed = true;
+      return next;
+    });
+    return changed ? { ...data, pages } : data;
+  }
+  return transform(data);
+}
 function scopedKey(options) {
   return (options == null ? void 0 : options.scopeKey) !== void 0 ? conversationListQueryKeys.scope(options.scopeKey) : conversationListQueryKeys.root;
 }
 function invalidateConversationListCaches(queryClient, options) {
   return queryClient.invalidateQueries({ queryKey: scopedKey(options) });
 }
+function patchConversationListCaches(queryClient, options) {
+  queryClient.setQueriesData(
+    { queryKey: scopedKey(options) },
+    (data) => mapCachedPages(data, (page) => patchConversationsInPage(page, options.match, options.patch))
+  );
+}
+function removeConversationFromListCaches(queryClient, options) {
+  queryClient.setQueriesData(
+    { queryKey: scopedKey(options) },
+    (data) => mapCachedPages(data, (page) => removeConversationFromPage(page, options.threadId))
+  );
+}
 function summaryFromConversationIndexEntry(entry, previous) {
   const carriesStatus = entry.run_status !== void 0 || entry.session_status !== void 0;
   return {
@@ -116,6 +147,8 @@ function summaryFromConversationIndexEntry(entry, previous) {
     assetType: entry.asset_type,
     assetId: entry.asset_id ?? (previous == null ? void 0 : previous.assetId) ?? null,
     computerAssetId: (previous == null ? void 0 : previous.computerAssetId) ?? null,
+    collabAgentId: previous == null ? void 0 : previous.collabAgentId,
+    collabChannelId: previous == null ? void 0 : previous.collabChannelId,
     parentSessionId: previous == null ? void 0 : previous.parentSessionId,
     subSessionCount: previous == null ? void 0 : previous.subSessionCount,
     appId: entry.app_id,
@@ -129,6 +162,7 @@ function summaryFromConversationIndexEntry(entry, previous) {
     nextAction: entry.next_action !== void 0 ? entry.next_action : previous == null ? void 0 : previous.nextAction,
     attentionSource: entry.attention_source !== void 0 ? entry.attention_source : previous == null ? void 0 : previous.attentionSource,
     isFavorited: entry.is_favorited ?? (previous == null ? void 0 : previous.isFavorited),
+    createdByMe: previous == null ? void 0 : previous.createdByMe,
     lastWake: previous == null ? void 0 : previous.lastWake,
     pullRequests: previous == null ? void 0 : previous.pullRequests
   };
@@ -144,8 +178,10 @@ export {
   isConversationRunning,
   mergeConversationPages,
   normalizeConversationListFilter,
+  patchConversationListCaches,
   patchConversationsInPage,
   prependConversationToPage,
+  removeConversationFromListCaches,
   removeConversationFromPage,
   summaryFromConversationIndexEntry
 };

package/dist/agent-runtime/src/conversation-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-list.js","sources":["../../../../agent-runtime/src/conversation-list.ts"],"sourcesContent":["import type { InfiniteData, QueryClient } from '@tanstack/react-query';\nimport type { ConversationIndexEntry } from './conversation-index';\n\n/**\n * What a session asks of the viewer, derived server-side from the run, the\n * parked interrupt, the pull requests it opened, its termination and its last\n * wake (the Devin-style session list). `needs_you` is the only state that\n * demands the viewer act; `working` is live; `ready` finished with something\n * to look at; `watching` waits on an external party (a review, a check);\n * `done` and `error` are terminal. A backend newer than this client may report\n * a value outside the union — render it as \"no attention\" rather than failing.\n */\nexport type ConversationAttention =\n  | 'needs_you'\n  | 'working'\n  | 'ready'\n  | 'watching'\n  | 'done'\n  | 'error';\n\nexport const CONVERSATION_ATTENTIONS: readonly ConversationAttention[] = [\n  'needs_you',\n  'working',\n  'ready',\n  'watching',\n  'done',\n  'error',\n];\n\n/** Which signal produced the attention state (and the `nextAction` copy). */\nexport type ConversationAttentionSource =\n  | 'interrupt'\n  | 'run'\n  | 'pull_request'\n  | 'termination'\n  | 'wake'\n  | 'handoff'\n  | 'follow_up';\n\n/** The last event that woke a resting session (a GitHub webhook, a schedule, a handoff). */\nexport interface ConversationWake {\n  source: string | null;\n  reason: string | null;\n  /** ISO 8601 timestamp of the wake. */\n  at: string | null;\n}\n\n/**\n * Live GitHub state of a pull request the session opened, read by the server\n * when the list renders. Never pushed by the conversation index — it comes\n * from the list fetch only, so a fold keeps the fetched value.\n */\nexport interface ConversationPullRequest {\n  /** `owner/repo` the pull request lives in. */\n  repoFullName: string;\n  number: number;\n  url: string;\n  title: string;\n  state: 'OPEN' | 'CLOSED' | 'MERGED';\n  isDraft: boolean;\n  /** GitHub's review decision (APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED) or null. */\n  reviewDecision: string | null;\n  /** Combined state of the checks on the head commit. */\n  checksState: 'SUCCESS' | 'FAILURE' | 'PENDING' | 'NONE';\n  /** ISO 8601 timestamp of the pull request's last update on GitHub. */\n  updatedAt: string;\n}\n\n/**\n * Shared conversation/thread LIST contract (chat-stack unification —\n * thread-list-contract-convergence).\n *\n * Every chat surface lists \"my conversations\" against the same underlying\n * session assets, but historically each declared its own row shape, paging\n * model, and filter set (Olympus GraphQL `listConversations`, the SDK/Chrome\n * REST `/api/conversations/threads/list`, mobile's `/api/v0/sessions`). This\n * module is the ONE contract those surfaces converge on:\n *\n * - **Row shape**: {@link ConversationSummary} — the canonical camelCase\n *   superset. Fields a transport cannot supply are `null`, never invented.\n * - **Ordering**: newest first by `updatedAt`, always. Ordering is part of the\n *   contract, not a parameter — no surface sorts any other way.\n * - **Paging**: offset/limit with a LIVE newest page and explicitly-fetched\n *   frozen history pages (see `useConversationList`). `hasMore` continues the\n *   scan; `totalCount` is advisory and may be `null` for transports that do\n *   not count.\n * - **Filtering**: {@link ConversationListFilter}. `appId` follows\n *   `docs/SESSION_APP_ID_GUIDE.md`: exact match when set (legacy `null`\n *   sessions excluded), no filter when unset. A fetcher that cannot express a\n *   requested filter field MUST throw rather than silently ignore it — a\n *   dropped filter returns wrong rows under a cache key that claims otherwise.\n * - **Freshness**: the per-user conversation-index statewire\n *   (`conversation-index.ts`) is the push signal; these queries are the data\n *   source. Push handlers call {@link invalidateConversationListCaches}.\n */\nexport interface ConversationSummary {\n  /** LangGraph thread id — the cross-surface conversation identity. */\n  threadId: string;\n  title: string;\n  /** ISO 8601 timestamp of last update (the contract's sort key). */\n  updatedAt: string;\n  /** ISO 8601 creation timestamp, when the transport reports it. */\n  createdAt: string | null;\n  /** Session lifecycle state from athena_metadata (e.g. running, completed). */\n  state: string | null;\n  /** Agent runtime marker (e.g. 'athena_deep_agent'), when reported. */\n  runtime: string | null;\n  /** Channel the session was started from (e.g. agent_email, web). */\n  sourceChannel: string | null;\n  /** Asset type (session, video_session, desktop_session, mobile_session). */\n  assetType: string | null;\n  /** Session asset id (`asset_<uuid>`), when the transport reports it. */\n  assetId: string | null;\n  /** Client app that created the session (SESSION_APP_ID_GUIDE). */\n  appId: string | null;\n  /** Computer asset whose sandbox started the session (`sourceChannel` 'computer'); omitted by surfaces that don't carry it. */\n  computerAssetId?: string | null;\n  /**\n   * Collab agent (`asset_<uuid>`) and channel the session started on; `null`\n   * channel is the agent's default channel. The server refuses a run on another\n   * of the agent's channels, so a client shows the session's mode from these\n   * instead of remembering it. Omitted by surfaces that don't carry them.\n   */\n  collabAgentId?: string | null;\n  collabChannelId?: string | null;\n  /** Session asset id this row is a sub-session of; omitted by surfaces that don't carry it. */\n  parentSessionId?: string | null;\n  /** Sub-sessions of this row the viewer can see; omitted by surfaces that don't carry it. */\n  subSessionCount?: number;\n  /** Trigger marker (`manual` remains user-initiated; other values are automated). */\n  triggerType: string | null;\n  /** Last-message preview used when a legacy session has no useful title. */\n  preview: string | null;\n  messageCount: number | null;\n  /** Per-user unread flag derived server-side from the read receipt. */\n  isUnread: boolean;\n  /**\n   * Canonical session status (status_v2: idle | active | needs_input | error),\n   * or null when the transport does not report it.\n   */\n  sessionStatus: string | null;\n  /**\n   * Canonical status of the session's current run (status_v2: scheduled |\n   * queued | running | needs_input | completed | failed | canceled). Null when\n   * the transport does not report it — {@link isConversationRunning} then\n   * falls back to the legacy `state`. Running badges on every surface derive\n   * from this one helper so they cannot disagree.\n   */\n  runStatus: string | null;\n  /**\n   * Server-derived attention state. `undefined` when the transport (or an\n   * older server) does not report it — {@link deriveConversationAttention}\n   * then falls back to the status planes; `null` when the server reports none.\n   */\n  attention?: ConversationAttention | null;\n  /** One line (≤ 80 chars) of what the viewer should do next, when the server derives one. */\n  nextAction?: string | null;\n  /** Which signal produced `attention` / `nextAction`. */\n  attentionSource?: ConversationAttentionSource | null;\n  /** Whether the viewer pinned (favorited) the session; `undefined` when not reported. */\n  isFavorited?: boolean;\n  /**\n   * Whether the viewer started the session (`false`: it is shared with them);\n   * `undefined` when not reported. Never pushed by the conversation index, so\n   * a fold keeps the fetched value.\n   */\n  createdByMe?: boolean;\n  /** The last wake of a resting session; `undefined` when not reported. */\n  lastWake?: ConversationWake | null;\n  /**\n   * Pull requests the session opened with their live GitHub state. `[]` when\n   * it opened none, `null` when the state could not be read right now,\n   * `undefined` when the transport did not ask for (or report) it.\n   */\n  pullRequests?: ConversationPullRequest[] | null;\n}\n\n/**\n * The canonical filter set. Semantics are defined here once; each fetcher\n * translates the fields its transport supports and throws on the rest.\n */\nexport interface ConversationListFilter {\n  /** Exact-match client app filter; unset = all apps (SESSION_APP_ID_GUIDE). */\n  appId?: string;\n  /**\n   * Sessions of any of these client apps too, a union with `appId` (REST thread\n   * list only today). A host lists an earlier app's sessions beside its own.\n   */\n  appIds?: readonly string[];\n  /** Asset types to include (e.g. ['session']); unset = all session types. */\n  assetTypes?: readonly string[];\n  /** Case-insensitive title search. */\n  search?: string;\n  /** Hide triggered/background sessions (REST thread list only today). */\n  excludeTriggered?: boolean;\n  /** Start-channel filter (v0 sessions / REST thread list only today). */\n  sourceChannels?: readonly string[];\n  /** Start channels to hide (e.g. ['api']); GraphQL `listConversations` only today. */\n  excludeSourceChannels?: readonly string[];\n  /** Exact computer asset whose sandbox started the session; GraphQL `listConversations` only today. */\n  computerAssetId?: string;\n  /** Only the sub-sessions of this session asset id; GraphQL `listConversations` only today. */\n  parentSessionId?: string;\n  /**\n   * Lifecycle-state filter (e.g. ['running'], ['completed']). Transports match\n   * it with the shared status_v2 rule (running carries a 12-hour recency cutoff).\n   */\n  states?: readonly string[];\n  /** Restrict to sessions run by any of these agents (athena_metadata.agent). */\n  agentIds?: readonly string[];\n  /**\n   * Include branched sub-sessions and orchestration children, which every list\n   * hides by default because they belong under their parent thread.\n   */\n  includeSubSessions?: boolean;\n}\n\nexport interface ConversationListPage {\n  /** Rows in contract order (updatedAt desc). */\n  items: ConversationSummary[];\n  /** Whether another `offset + limit` scan would return more rows. */\n  hasMore: boolean;\n  /** Total matching rows, or null when the transport does not count. */\n  totalCount: number | null;\n}\n\nexport interface ConversationListFetchParams {\n  limit: number;\n  offset: number;\n  filter: ConversationListFilter;\n  signal?: AbortSignal;\n}\n\n/**\n * One page fetch against some transport (GraphQL `listConversations`, the\n * REST thread list, …). Must reject on filter fields it cannot express.\n */\nexport type ConversationListFetcher = (\n  params: ConversationListFetchParams\n) => Promise<ConversationListPage>;\n\n/** Root of every conversation-list query key (all surfaces, all filters). */\nexport const CONVERSATION_LIST_QUERY_KEY_ROOT = 'athena-conversation-list';\n\n/**\n * Scope used by `useConversationList` when the caller passes no `scopeKey`.\n * Exported so cache seeders (e.g. Olympus's spacesBootstrap adoption) can\n * address the exact keys default-scoped hooks read from.\n */\nexport const CONVERSATION_LIST_DEFAULT_SCOPE_KEY = 'default';\n\n/**\n * Normalize a filter to its semantic content: unset/empty fields are dropped\n * (so `{}` and `{ appId: undefined }` are the same filter) and array order is\n * canonicalized. Fetchers receive the normalized form, so what a cache entry\n * claims to hold is exactly what was fetched.\n */\nexport function normalizeConversationListFilter(\n  filter: ConversationListFilter\n): ConversationListFilter {\n  const normalized: ConversationListFilter = {};\n  if (filter.appId) normalized.appId = filter.appId;\n  if (filter.appIds && filter.appIds.length > 0) {\n    normalized.appIds = [...new Set(filter.appIds)].sort();\n  }\n  if (filter.assetTypes && filter.assetTypes.length > 0) {\n    normalized.assetTypes = [...filter.assetTypes].sort();\n  }\n  if (filter.search) normalized.search = filter.search;\n  if (filter.excludeTriggered !== undefined) normalized.excludeTriggered = filter.excludeTriggered;\n  if (filter.sourceChannels && filter.sourceChannels.length > 0) {\n    normalized.sourceChannels = [...filter.sourceChannels].sort();\n  }\n  if (filter.excludeSourceChannels && filter.excludeSourceChannels.length > 0) {\n    normalized.excludeSourceChannels = [...filter.excludeSourceChannels].sort();\n  }\n  if (filter.computerAssetId) normalized.computerAssetId = filter.computerAssetId;\n  if (filter.parentSessionId) normalized.parentSessionId = filter.parentSessionId;\n  if (filter.states && filter.states.length > 0) {\n    normalized.states = [...filter.states].sort();\n  }\n  if (filter.agentIds && filter.agentIds.length > 0) {\n    normalized.agentIds = [...filter.agentIds].sort();\n  }\n  if (filter.includeSubSessions) normalized.includeSubSessions = true;\n  return normalized;\n}\n\n/** status_v2 run statuses during which a session is actively working. */\nconst RUNNING_RUN_STATUSES: ReadonlySet<string> = new Set(['queued', 'running']);\n\n/**\n * THE running rule for every conversation-list surface (sidebar pane, recent\n * dropdown, workspace section, pushed index rows): the canonical status_v2 run\n * status when the transport reports one, else the legacy `state`. A session\n * paused on a human gate (`needs_input`) is not running.\n */\nexport function isConversationRunning(summary: {\n  runStatus?: string | null;\n  state?: string | null;\n}): boolean {\n  if (summary.runStatus !== null && summary.runStatus !== undefined) {\n    return RUNNING_RUN_STATUSES.has(summary.runStatus);\n  }\n  return summary.state === 'running';\n}\n\nconst KNOWN_ATTENTIONS: ReadonlySet<string> = new Set(CONVERSATION_ATTENTIONS);\n\n/**\n * THE attention rule for every session-list surface: the server-derived\n * `attention` when the transport reports one it knows, else a client fallback\n * from the status planes so an older server still yields the two states a\n * list cannot do without — a human gate reads as `needs_you`, a live run as\n * `working`, a failed run as `error`. `null` when nothing applies.\n */\nexport function deriveConversationAttention(\n  summary: Pick<ConversationSummary, 'attention' | 'runStatus' | 'sessionStatus' | 'state'>\n): ConversationAttention | null {\n  if (typeof summary.attention === 'string' && KNOWN_ATTENTIONS.has(summary.attention)) {\n    return summary.attention;\n  }\n  if (summary.runStatus === 'needs_input' || summary.sessionStatus === 'needs_input') {\n    return 'needs_you';\n  }\n  if (isConversationRunning(summary)) return 'working';\n  if (summary.runStatus === 'failed' || summary.sessionStatus === 'error') return 'error';\n  return null;\n}\n\n/**\n * Stable cache identity for a filter: the normalized fields serialized in\n * sorted key order, so semantically equal filters share one cache entry.\n */\nexport function conversationListFilterKey(filter: ConversationListFilter): string {\n  const normalized = normalizeConversationListFilter(filter) as Record<string, unknown>;\n  return JSON.stringify(\n    Object.keys(normalized)\n      .sort()\n      .map((key) => [key, normalized[key]])\n  );\n}\n\n/**\n * Query keys for the two-tier pager. `scopeKey` isolates caches beyond the\n * filter — surfaces MUST include everything that changes whose list this is\n * (principal/user id, backend base URL) so a credential swap can never read\n * another identity's rows out of the cache.\n *\n * `pageSize` is part of the key because it is baked into every cached page's\n * offset boundaries: two hooks sharing a scope and filter but paging by\n * different sizes would otherwise reuse each other's incompatible boundaries\n * and skip or duplicate rows.\n */\nexport const conversationListQueryKeys = {\n  root: [CONVERSATION_LIST_QUERY_KEY_ROOT] as const,\n  scope: (scopeKey: string) => [CONVERSATION_LIST_QUERY_KEY_ROOT, scopeKey] as const,\n  firstPage: (scopeKey: string, filterKey: string, pageSize: number) =>\n    [CONVERSATION_LIST_QUERY_KEY_ROOT, scopeKey, filterKey, pageSize, 'first-page'] as const,\n  history: (scopeKey: string, filterKey: string, pageSize: number) =>\n    [CONVERSATION_LIST_QUERY_KEY_ROOT, scopeKey, filterKey, pageSize, 'history'] as const,\n};\n\n/**\n * Flatten pages into one newest-first list, deduplicating by `threadId`.\n * The live first page wins over retained history copies of the same thread.\n */\nexport function mergeConversationPages(\n  pages: readonly ConversationListPage[]\n): ConversationSummary[] {\n  const seen = new Set<string>();\n  const items: ConversationSummary[] = [];\n  for (const page of pages) {\n    for (const item of page.items) {\n      if (seen.has(item.threadId)) continue;\n      seen.add(item.threadId);\n      items.push(item);\n    }\n  }\n  return items;\n}\n\n/**\n * Prepend a conversation to a page unless its thread is already present\n * (optimistic \"new thread appears at the top\" write). Identity-preserving\n * no-op when present, so equal writes never notify subscribers.\n */\nexport function prependConversationToPage(\n  page: ConversationListPage,\n  item: ConversationSummary\n): ConversationListPage {\n  if (page.items.some((existing) => existing.threadId === item.threadId)) return page;\n  return {\n    ...page,\n    items: [item, ...page.items],\n    totalCount: page.totalCount === null ? null : page.totalCount + 1,\n  };\n}\n\n/** Remove a thread's row from a page; identity-preserving when absent. */\nexport function removeConversationFromPage(\n  page: ConversationListPage,\n  threadId: string\n): ConversationListPage {\n  if (!page.items.some((item) => item.threadId === threadId)) return page;\n  return { ...page, items: page.items.filter((item) => item.threadId !== threadId) };\n}\n\n/**\n * Patch every row matching `match`; identity-preserving when nothing matches\n * so cache writes cannot cause spurious re-renders.\n */\nexport function patchConversationsInPage(\n  page: ConversationListPage,\n  match: (item: ConversationSummary) => boolean,\n  patch: Partial<ConversationSummary>\n): ConversationListPage {\n  let changed = false;\n  const items = page.items.map((item) => {\n    if (!match(item)) return item;\n    changed = true;\n    return { ...item, ...patch };\n  });\n  return changed ? { ...page, items } : page;\n}\n\ntype CachedConversationList =\n  | ConversationListPage\n  | InfiniteData<ConversationListPage, number>\n  | undefined;\n\nfunction isInfinitePages(\n  data: ConversationListPage | InfiniteData<ConversationListPage, number>\n): data is InfiniteData<ConversationListPage, number> {\n  return 'pages' in data;\n}\n\nfunction mapCachedPages(\n  data: CachedConversationList,\n  transform: (page: ConversationListPage) => ConversationListPage\n): CachedConversationList {\n  if (!data) return data;\n  if (isInfinitePages(data)) {\n    let changed = false;\n    const pages = data.pages.map((page) => {\n      const next = transform(page);\n      if (next !== page) changed = true;\n      return next;\n    });\n    return changed ? { ...data, pages } : data;\n  }\n  return transform(data);\n}\n\ninterface ConversationListCacheScope {\n  /** Restrict to one scope; omitted = every conversation-list cache. */\n  scopeKey?: string;\n}\n\nfunction scopedKey(options?: ConversationListCacheScope): readonly string[] {\n  return options?.scopeKey !== undefined\n    ? conversationListQueryKeys.scope(options.scopeKey)\n    : conversationListQueryKeys.root;\n}\n\n/**\n * Invalidate conversation-list caches (all filters, first page + history).\n * This is the hook for push signals — the conversation-index statewire, a\n * finished run, an archive/restore — anything that changed the server list.\n */\nexport function invalidateConversationListCaches(\n  queryClient: QueryClient,\n  options?: ConversationListCacheScope\n): Promise<void> {\n  return queryClient.invalidateQueries({ queryKey: scopedKey(options) });\n}\n\n/** Cancel in-flight list fetches so an optimistic write cannot be overwritten. */\nexport function cancelConversationListCaches(\n  queryClient: QueryClient,\n  options?: ConversationListCacheScope\n): Promise<void> {\n  return queryClient.cancelQueries({ queryKey: scopedKey(options) });\n}\n\n/**\n * Patch matching rows in every cached conversation list (first pages, history\n * pages, searches) so per-row state (read receipts, titles) flips in the same\n * frame as the interaction instead of after the next refetch.\n */\nexport function patchConversationListCaches(\n  queryClient: QueryClient,\n  options: ConversationListCacheScope & {\n    match: (item: ConversationSummary) => boolean;\n    patch: Partial<ConversationSummary>;\n  }\n): void {\n  queryClient.setQueriesData<CachedConversationList>({ queryKey: scopedKey(options) }, (data) =>\n    mapCachedPages(data, (page) => patchConversationsInPage(page, options.match, options.patch))\n  );\n}\n\n/** Remove a thread's row from every cached conversation list in scope. */\nexport function removeConversationFromListCaches(\n  queryClient: QueryClient,\n  options: ConversationListCacheScope & { threadId: string }\n): void {\n  queryClient.setQueriesData<CachedConversationList>({ queryKey: scopedKey(options) }, (data) =>\n    mapCachedPages(data, (page) => removeConversationFromPage(page, options.threadId))\n  );\n}\n\nfunction timestampMs(value: string): number {\n  const parsed = Date.parse(value);\n  return Number.isNaN(parsed) ? 0 : parsed;\n}\n\nfunction sameSummary(a: ConversationSummary, b: ConversationSummary): boolean {\n  return (\n    a.threadId === b.threadId &&\n    a.title === b.title &&\n    a.updatedAt === b.updatedAt &&\n    a.createdAt === b.createdAt &&\n    a.state === b.state &&\n    a.runtime === b.runtime &&\n    a.sourceChannel === b.sourceChannel &&\n    a.assetType === b.assetType &&\n    a.assetId === b.assetId &&\n    a.appId === b.appId &&\n    a.triggerType === b.triggerType &&\n    a.preview === b.preview &&\n    a.messageCount === b.messageCount &&\n    a.isUnread === b.isUnread &&\n    a.sessionStatus === b.sessionStatus &&\n    a.runStatus === b.runStatus &&\n    a.attention === b.attention &&\n    a.nextAction === b.nextAction &&\n    a.attentionSource === b.attentionSource &&\n    a.isFavorited === b.isFavorited &&\n    // Never pushed by the index, so a fold carries the previous references\n    // through unchanged; identity is the equality that matters here.\n    a.lastWake === b.lastWake &&\n    a.pullRequests === b.pullRequests\n  );\n}\n\n/**\n * Project one replicated conversation-index row onto the shared summary shape.\n * Fields the index never carries (`createdAt`) and viewer-specific fields a\n * lifecycle publish cannot know (`is_unread: null`) keep the row's previous\n * value. Canonical status is taken from the entry when the publishing pod\n * reports it; a snapshot from a pod that predates the fields falls back to the\n * legacy `state` (null status) rather than keeping a stale run status.\n *\n * Attention fields (`attention`, `next_action`, `attention_source`,\n * `is_favorited`) are taken from the entry when the publishing pod reports\n * them, so a live push flips a row to \"needs you\" the way it renames it; a\n * pod that predates them leaves the row's previous values. Pull-request state,\n * the last wake and `createdByMe` are never pushed and always keep the fetched\n * value.\n */\nexport function summaryFromConversationIndexEntry(\n  entry: ConversationIndexEntry,\n  previous?: ConversationSummary\n): ConversationSummary {\n  const carriesStatus = entry.run_status !== undefined || entry.session_status !== undefined;\n  return {\n    threadId: entry.thread_id,\n    title: entry.title,\n    updatedAt: entry.updated_at,\n    createdAt: previous?.createdAt ?? null,\n    state: entry.state,\n    runtime: entry.runtime,\n    sourceChannel: entry.start_channel,\n    assetType: entry.asset_type,\n    assetId: entry.asset_id ?? previous?.assetId ?? null,\n    computerAssetId: previous?.computerAssetId ?? null,\n    collabAgentId: previous?.collabAgentId,\n    collabChannelId: previous?.collabChannelId,\n    parentSessionId: previous?.parentSessionId,\n    subSessionCount: previous?.subSessionCount,\n    appId: entry.app_id,\n    triggerType: entry.trigger_type,\n    preview: entry.last_message_preview,\n    messageCount: entry.message_count,\n    isUnread: entry.is_unread ?? previous?.isUnread ?? false,\n    sessionStatus: carriesStatus ? (entry.session_status ?? null) : null,\n    runStatus: carriesStatus ? (entry.run_status ?? null) : null,\n    attention: entry.attention !== undefined ? entry.attention : previous?.attention,\n    nextAction: entry.next_action !== undefined ? entry.next_action : previous?.nextAction,\n    attentionSource:\n      entry.attention_source !== undefined ? entry.attention_source : previous?.attentionSource,\n    isFavorited: entry.is_favorited ?? previous?.isFavorited,\n    createdByMe: previous?.createdByMe,\n    lastWake: previous?.lastWake,\n    pullRequests: previous?.pullRequests,\n  };\n}\n\n/**\n * Fold the user's replicated conversation index (the newest-page window the\n * per-user statewire pushes) into a cached live first page, so a thread\n * created, renamed, finished, or read anywhere updates every list surface in\n * the same frame — without refetching the page.\n *\n * - Rows in the window are upserted (new threads appear, existing rows take\n *   the pushed fields, see {@link summaryFromConversationIndexEntry}).\n * - Rows NOT in the window but at least as new as the window's oldest row\n *   should have been in it, so they left the list (archived, hidden, shared\n *   away) and are dropped. Older rows are beyond the window and are kept.\n * - When the index reports no further rows (`indexHasMore === false`) the\n *   window IS the whole list, so every row outside it is dropped.\n *\n * Newest-first ordering is restored and the page identity is preserved when\n * nothing changed, so an equal push never notifies subscribers.\n */\nexport function mergeConversationIndexIntoPage(\n  page: ConversationListPage,\n  entries: readonly ConversationIndexEntry[],\n  options: { indexHasMore: boolean }\n): ConversationListPage {\n  const previousByThread = new Map(page.items.map((item) => [item.threadId, item]));\n  const inWindow = new Set(entries.map((entry) => entry.thread_id));\n  const windowTailMs =\n    entries.length > 0 ? Math.min(...entries.map((entry) => timestampMs(entry.updated_at))) : null;\n\n  const merged: ConversationSummary[] = entries.map((entry) => {\n    const previous = previousByThread.get(entry.thread_id);\n    const next = summaryFromConversationIndexEntry(entry, previous);\n    return previous && sameSummary(previous, next) ? previous : next;\n  });\n\n  for (const item of page.items) {\n    if (inWindow.has(item.threadId)) continue;\n    if (!options.indexHasMore) continue;\n    if (windowTailMs !== null && timestampMs(item.updatedAt) >= windowTailMs) continue;\n    merged.push(item);\n  }\n\n  merged.sort((a, b) => timestampMs(b.updatedAt) - timestampMs(a.updatedAt));\n\n  const unchanged =\n    merged.length === page.items.length &&\n    merged.every((item, index) => item === page.items[index]);\n  if (unchanged) return page;\n\n  return { ...page, items: merged };\n}\n"],"names":[],"mappings":"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"}

package/dist/{packages/agent-runtime → agent-runtime}/src/deep-agent-transport-recipe.cjs

@@ -20,12 +20,14 @@ function createDeepAgentAttachTransport({
   onAuthResolve,
   onAttachTiming,
   retryGate = statewireAttachObserver.attachRetryGate,
-  messageWindow: messageWindow$1
+  messageWindow: messageWindow$1,
+  statewireClient
 }) {
   const url = deepAgentThreadUrl({ baseUrl, threadId });
+  const useSse = statewireTransport.resolveStatewireTransportKind({ sse, client: statewireClient }) === "sse";
   const instrumentation = statewireAttachObserver.createAttachInstrumentation({
     url,
-    sse,
+    sse: useSse,
     onEvent: onAttachTiming,
     retryGate
   });
@@ -50,7 +52,7 @@ function createDeepAgentAttachTransport({
       fetch: instrumentation.fetch
     }
   };
-  return statewireTransport.statewireTransport(options, { sse });
+  return statewireTransport.statewireTransport(options, { sse: useSse });
 }
 exports.createDeepAgentAttachTransport = createDeepAgentAttachTransport;
 exports.deepAgentThreadUrl = deepAgentThreadUrl;

package/dist/agent-runtime/src/deep-agent-transport-recipe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-agent-transport-recipe.cjs","sources":["../../../../agent-runtime/src/deep-agent-transport-recipe.ts"],"sourcesContent":["import type { ResourceElement } from \"@assistant-ui/tap\";\nimport type { Statewire, StatewireClient } from \"statewire\";\nimport {\n  type DeepAgentMessageWindowDeclaration,\n  withDeclaredMessageWindow,\n} from \"./message-window\";\nimport { withDeclaredProtocolVersion } from \"./protocol\";\nimport {\n  attachRetryGate,\n  type AttachRetryGate,\n  createAttachInstrumentation,\n  type DeepAgentAttachTimingEvent,\n  type DeepAgentWakeRefusal,\n  parseRetryAfterHeaderMs,\n} from \"./statewire-attach-observer\";\nimport {\n  resolveStatewireTransportKind,\n  statewireTransport,\n  type StatewireTransportOptions,\n} from \"./statewire-transport\";\n\n/** Auth-header resolver for the transport; `staleAuth` is true right after an\n * auth rejection, so resolvers that can force-renew should honor it. */\nexport type DeepAgentHeadersResolver = (ctx: {\n  staleAuth: boolean;\n}) => Record<string, string> | Promise<Record<string, string>>;\n\n/** The statewire attach URL for a thread: the host's `…/v2/threads` mount plus the id. */\nexport function deepAgentThreadUrl({\n  baseUrl,\n  threadId,\n}: {\n  baseUrl: string;\n  threadId: string;\n}): string {\n  return `${baseUrl.replace(/\\/+$/, \"\")}/${encodeURIComponent(threadId)}`;\n}\n\nexport interface DeepAgentAttachTransportOptions {\n  /** Base URL of the deep-agent statewire host (the `…/v2/threads` mount). */\n  baseUrl: string;\n  threadId: string;\n  headers: DeepAgentHeadersResolver;\n  /**\n   * SSE when true, WebSocket otherwise, over the qualified statewire client: an\n   * unqualified one gets SSE either way (`resolveStatewireTransportKind`).\n   */\n  sse?: boolean;\n  /** The statewire client class whose qualification picks the transport: the installed one unless given. */\n  statewireClient?: object;\n  /** A never-started chat: the transport makes no network calls until the first command send. */\n  isNew?: boolean;\n  /** Host session store (mobile); browser hosts mount `storage.session` on the thread instead. */\n  sessionStore?: StatewireClient.SessionStorage | undefined;\n  /** Observes every headers resolve (the diagnostics recorder's stale-auth seam). */\n  onAuthResolve?: ((ctx: { staleAuth: boolean }) => void) | undefined;\n  /** Attach timing + retry hints (see `statewire-attach-observer`). */\n  onAttachTiming?: ((event: DeepAgentAttachTimingEvent) => void) | undefined;\n  /** Dial floors from server retry hints; the process-wide gate by default. */\n  retryGate?: AttachRetryGate;\n  /**\n   * The head window declared on the attach (`x-athena-deep-agent-window`,\n   * see `message-window.ts`): the hello of a client the host does not\n   * remember carries the newest `size` messages. Part of the recipe so a\n   * pooled dial asks for the same shape as the thread's own attach — a pooled\n   * hello then seeds the very state the attach will reconcile. Omitted, the\n   * shared default is declared.\n   */\n  messageWindow?: DeepAgentMessageWindowDeclaration | undefined;\n}\n\n/**\n * The ONE recipe for a deep-agent thread transport — shared by the mounted\n * thread (`useDeepAgentThread`) and the prewarm pool, so a pre-dialed\n * connection is byte-for-byte the connection the thread would have opened\n * itself: same URL, same auth + wire-contract headers, same session lane, same\n * instrumentation.\n *\n * Every attach declares this build's wire-contract version alongside the\n * host's auth headers (first WS frame / SSE request headers) — the server\n * half of version negotiation reads it in `authorize`. The headers resolve\n * also waits out any server `Retry-After` floor for the thread: both statewire\n * attach paths resolve headers before they dial, so this is the seam where a\n * hint can hold the next dial without touching the library's backoff.\n */\nexport function createDeepAgentAttachTransport<TState = unknown>({\n  baseUrl,\n  threadId,\n  headers,\n  sse = false,\n  isNew = false,\n  sessionStore,\n  onAuthResolve,\n  onAttachTiming,\n  retryGate = attachRetryGate,\n  messageWindow,\n  statewireClient,\n}: DeepAgentAttachTransportOptions): ResourceElement<\n  Statewire<TState | undefined>\n> {\n  const url = deepAgentThreadUrl({ baseUrl, threadId });\n  // The instrumentation wraps the transport actually built: an SSE fallback\n  // needs the fetch wrapper that reads a refused attach's `Retry-After`.\n  const useSse =\n    resolveStatewireTransportKind({ sse, client: statewireClient }) === \"sse\";\n  const instrumentation = createAttachInstrumentation({\n    url,\n    sse: useSse,\n    onEvent: onAttachTiming,\n    retryGate,\n  });\n  const options: StatewireTransportOptions = {\n    url,\n    ...(isNew && { isNew: true }),\n    headers: async (ctx: { staleAuth: boolean }) => {\n      await retryGate.waitForDial(url);\n      onAuthResolve?.(ctx);\n      return withDeclaredMessageWindow(\n        withDeclaredProtocolVersion(await headers(ctx)),\n        messageWindow,\n      );\n    },\n    ...(sessionStore && { sessionStore }),\n    // Structural types: this package compiles without the DOM lib, while\n    // statewire's option types name the browser `WebSocket`/`fetch`.\n    ...(instrumentation.webSocket && {\n      webSocket:\n        instrumentation.webSocket as unknown as StatewireTransportOptions[\"webSocket\"],\n    }),\n    ...(instrumentation.fetch && {\n      fetch:\n        instrumentation.fetch as unknown as StatewireTransportOptions[\"fetch\"],\n    }),\n  };\n  return statewireTransport<TState>(options, { sse: useSse });\n}\n\n/** What `POST …/prewarm` answered. */\nexport interface DeepAgentWakeResult {\n  status: number;\n  /** The host activated the thread and its history is resident. */\n  warm: boolean;\n  /**\n   * `'warm'` when the history was already memoized, `'fresh_load'` when this\n   * call loaded it; `null` when the host did not say (a refusal, or a host\n   * without the route).\n   */\n  history: \"fresh_load\" | \"warm\" | null;\n  /**\n   * The dial floor recorded for the thread off a 503/429 `Retry-After` — the\n   * header's value, except a 503 `\"worker\"` refusal, capped at\n   * {@link WAKE_WORKER_REFUSAL_FLOOR_MS}.\n   */\n  retryAfterMs: number | null;\n  /** Who refused a 503/429 (see {@link DeepAgentWakeRefusal}); `null` for any other answer. */\n  refusal: DeepAgentWakeRefusal;\n  durationMs: number;\n}\n\n/**\n * Dial floor for a 503 the pinned worker produced about one instance's\n * lifecycle. Pinned answers every retriable 503 with a blanket\n * `Retry-After: 1`, but what those name — an instance record mid-teardown\n * (\"instance closing; retry\": fence release + placement release, ≈100 ms), a\n * full activation queue — clears far sooner than that, and the thread's own\n * attach is the request that carries the next activation. Holding it a full\n * second traded a ≈100 ms gap for a ≈1 s stall on every refused wake. A 429\n * is rate limiting and keeps its hint whatever the body says.\n */\nexport const WAKE_WORKER_REFUSAL_FLOOR_MS = 250;\n\n/**\n * The pinboard's own placement-refusal vocabulary — the `error` strings of\n * `@assistant-ui/pinboard` (`src/refusals.ts` plus the two inline refusals in\n * `src/server.ts`). Mirrors `PINBOARD_PLACEMENT_REFUSAL_ERRORS` in\n * `iris/scaler/src/v2AccessLog.ts`, whose test pins it to the installed\n * library; keep the two lists identical. A body with any other `error`\n * string is `\"unknown\"`, never `\"placement\"`.\n */\nexport const PINBOARD_PLACEMENT_REFUSAL_ERRORS: ReadonlySet<string> = new Set([\n  \"no live backends for namespace\",\n  \"registry cold start, retry\",\n  \"not the serving fleet\",\n  \"no live workers for hostname\",\n  \"hostname binding displaced, retry\",\n  \"hostname bindings inconsistent, retry\",\n  \"takeover in progress, retry\",\n  \"placement held by another hostname\",\n  \"worker inflight cap exceeded, retry\",\n  \"worker refused activation, retry\",\n]);\n\n/**\n * Pinned's instance-lifecycle refusals (`pinned/hosting/directory.py`,\n * `pinned/hosting/_records.py`): each names one instance on the worker the\n * thread is already placed on and clears in the time a teardown or an\n * activation slot takes. Anything else the worker answers 503 with — \"Thread\n * history load failed\", \"The regional conversation store is temporarily\n * unavailable\", a lease that expired — is not about one instance and keeps\n * the full hint.\n */\nexport const PINNED_TRANSIENT_WORKER_REFUSALS: ReadonlySet<string> = new Set([\n  \"instance closing; retry\",\n  \"instance aborted\",\n  \"activation queue full; retry\",\n  \"host draining; retry\",\n  \"instance capacity reached; retry\",\n  \"instance past its wind-down deadline; retry\",\n]);\n\n/**\n * Classify a 503/429 body (see {@link DeepAgentWakeRefusal}): a known pinboard\n * `error` is `\"placement\"`, a known pinned `detail` is `\"worker\"`, everything\n * else — including unfamiliar strings in either field — is `\"unknown\"`.\n */\nexport function classifyWakeRefusal(\n  body: unknown,\n): Exclude<DeepAgentWakeRefusal, null> {\n  if (typeof body === \"object\" && body !== null) {\n    const record = body as Record<string, unknown>;\n    if (\n      typeof record.error === \"string\" &&\n      PINBOARD_PLACEMENT_REFUSAL_ERRORS.has(record.error)\n    ) {\n      return \"placement\";\n    }\n    if (\n      typeof record.detail === \"string\" &&\n      PINNED_TRANSIENT_WORKER_REFUSALS.has(record.detail)\n    ) {\n      return \"worker\";\n    }\n  }\n  return \"unknown\";\n}\n\n/** Structural `fetch` for the wake call — this package compiles without the DOM lib. */\nexport type DeepAgentWakeFetch = (\n  input: string,\n  init?: {\n    method?: string;\n    headers?: Record<string, string>;\n    keepalive?: boolean;\n  },\n) => Promise<{\n  ok: boolean;\n  status: number;\n  headers: { get(name: string): string | null };\n  json(): Promise<unknown>;\n}>;\n\nexport interface DeepAgentWakeOptions {\n  /** Base URL of the deep-agent statewire host (the `…/v2/threads` mount). */\n  baseUrl: string;\n  threadId: string;\n  headers: DeepAgentHeadersResolver;\n  fetch?: DeepAgentWakeFetch | undefined;\n  /** Dial floors from server retry hints; the process-wide gate by default. */\n  retryGate?: AttachRetryGate;\n  onAttachTiming?: ((event: DeepAgentAttachTimingEvent) => void) | undefined;\n  now?: () => number;\n}\n\n/**\n * Wake a thread's server instance ahead of its attach. `POST …/prewarm` runs\n * the host's `authorize` and history load — the fence adopt, graph compile and\n * checkpoint read that make a cold attach's hello take ≈1 s — and answers with\n * no thread content, only whether the history was already resident. Fire it\n * on hover intent, before a pooled attach or the click's own dial, so the\n * activation overlaps the handshake and the attach that follows finds the\n * instance warm.\n *\n * Fire-and-forget by contract: every failure resolves `null`, and a host\n * without the route (404) is reported like any other non-OK answer. A 503/429\n * `Retry-After` is recorded as a dial floor for the thread, so the attach that\n * follows waits it out instead of bouncing — in full, except a 503 that names\n * one of pinned's instance-lifecycle refusals (one instance mid-teardown on\n * the worker the thread already has; see {@link DeepAgentWakeRefusal}), whose\n * floor is capped at {@link WAKE_WORKER_REFUSAL_FLOOR_MS}.\n */\nexport async function wakeDeepAgentThread({\n  baseUrl,\n  threadId,\n  headers,\n  fetch: fetchOverride,\n  retryGate = attachRetryGate,\n  onAttachTiming,\n  now = () => Date.now(),\n}: DeepAgentWakeOptions): Promise<DeepAgentWakeResult | null> {\n  const fetchImpl =\n    fetchOverride ?? (globalThis as { fetch?: DeepAgentWakeFetch }).fetch;\n  if (typeof fetchImpl !== \"function\") return null;\n  const threadUrl = deepAgentThreadUrl({ baseUrl, threadId });\n  const emit = (event: DeepAgentAttachTimingEvent): void => {\n    try {\n      onAttachTiming?.(event);\n    } catch {\n      // Observers are best-effort.\n    }\n  };\n  const startedAt = now();\n  try {\n    const resolved = withDeclaredProtocolVersion(\n      await headers({ staleAuth: false }),\n    );\n    const response = await fetchImpl(`${threadUrl}/prewarm`, {\n      method: \"POST\",\n      headers: resolved,\n      keepalive: true,\n    });\n    const durationMs = now() - startedAt;\n    let retryAfterMs: number | null = null;\n    let refusal: DeepAgentWakeRefusal = null;\n    if (response.status === 503 || response.status === 429) {\n      let body: unknown = null;\n      try {\n        body = await response.json();\n      } catch {\n        // A refusal without a readable body is classified by nothing.\n      }\n      refusal = classifyWakeRefusal(body);\n      const hinted = parseRetryAfterHeaderMs(\n        response.headers.get(\"retry-after\"),\n        now,\n      );\n      if (hinted !== null) {\n        retryAfterMs =\n          response.status === 503 && refusal === \"worker\"\n            ? Math.min(hinted, WAKE_WORKER_REFUSAL_FLOOR_MS)\n            : hinted;\n        if (retryAfterMs > 0) {\n          retryGate.noteRetryAfter(threadUrl, retryAfterMs);\n          emit({\n            type: \"retry-after\",\n            url: threadUrl,\n            delayMs: retryAfterMs,\n            source: \"http-header\",\n          });\n        }\n      }\n    }\n    let warm = false;\n    let history: DeepAgentWakeResult[\"history\"] = null;\n    if (response.ok) {\n      try {\n        const body = (await response.json()) as {\n          warm?: unknown;\n          history?: unknown;\n        } | null;\n        warm = body?.warm === true;\n        history =\n          body?.history === \"warm\" || body?.history === \"fresh_load\"\n            ? body.history\n            : null;\n      } catch {\n        // A 200 without a JSON body still means the instance is up.\n        warm = true;\n      }\n    }\n    emit({\n      type: \"wake\",\n      url: threadUrl,\n      status: response.status,\n      durationMs,\n      history,\n      refusal,\n    });\n    return {\n      status: response.status,\n      warm,\n      history,\n      retryAfterMs,\n      refusal,\n      durationMs,\n    };\n  } catch {\n    return null;\n  }\n}\n"],"names":["attachRetryGate","messageWindow","resolveStatewireTransportKind","createAttachInstrumentation","withDeclaredMessageWindow","withDeclaredProtocolVersion","statewireTransport"],"mappings":";;;;;;AA4BO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AACF,GAGW;AACT,SAAO,GAAG,QAAQ,QAAQ,QAAQ,EAAE,CAAC,IAAI,mBAAmB,QAAQ,CAAC;AACvE;AAiDO,SAAS,+BAAiD;AAAA,EAC/D;AAAA,EACA;AAAA,EACA;AAAA,EACA,MAAM;AAAA,EACN,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAYA,wBAAAA;AAAAA,EAAA,eACZC;AAAAA,EACA;AACF,GAEE;AACA,QAAM,MAAM,mBAAmB,EAAE,SAAS,UAAU;AAGpD,QAAM,SACJC,mBAAAA,8BAA8B,EAAE,KAAK,QAAQ,gBAAA,CAAiB,MAAM;AACtE,QAAM,kBAAkBC,wBAAAA,4BAA4B;AAAA,IAClD;AAAA,IACA,KAAK;AAAA,IACL,SAAS;AAAA,IACT;AAAA,EAAA,CACD;AACD,QAAM,UAAqC;AAAA,IACzC;AAAA,IACA,GAAI,SAAS,EAAE,OAAO,KAAA;AAAA,IACtB,SAAS,OAAO,QAAgC;AAC9C,YAAM,UAAU,YAAY,GAAG;AAC/B,qDAAgB;AAChB,aAAOC,cAAAA;AAAAA,QACLC,qCAA4B,MAAM,QAAQ,GAAG,CAAC;AAAA,QAC9CJ;AAAAA,MAAA;AAAA,IAEJ;AAAA,IACA,GAAI,gBAAgB,EAAE,aAAA;AAAA;AAAA;AAAA,IAGtB,GAAI,gBAAgB,aAAa;AAAA,MAC/B,WACE,gBAAgB;AAAA,IAAA;AAAA,IAEpB,GAAI,gBAAgB,SAAS;AAAA,MAC3B,OACE,gBAAgB;AAAA,IAAA;AAAA,EACpB;AAEF,SAAOK,mBAAAA,mBAA2B,SAAS,EAAE,KAAK,QAAQ;AAC5D;;;"}

package/dist/{packages/agent-runtime → agent-runtime}/src/deep-agent-transport-recipe.js

@@ -1,7 +1,7 @@
 import { withDeclaredMessageWindow } from "./message-window.js";
 import { withDeclaredProtocolVersion } from "./protocol.js";
 import { createAttachInstrumentation, attachRetryGate } from "./statewire-attach-observer.js";
-import { statewireTransport } from "./statewire-transport.js";
+import { resolveStatewireTransportKind, statewireTransport } from "./statewire-transport.js";
 function deepAgentThreadUrl({
   baseUrl,
   threadId
@@ -18,12 +18,14 @@ function createDeepAgentAttachTransport({
   onAuthResolve,
   onAttachTiming,
   retryGate = attachRetryGate,
-  messageWindow
+  messageWindow,
+  statewireClient
 }) {
   const url = deepAgentThreadUrl({ baseUrl, threadId });
+  const useSse = resolveStatewireTransportKind({ sse, client: statewireClient }) === "sse";
   const instrumentation = createAttachInstrumentation({
     url,
-    sse,
+    sse: useSse,
     onEvent: onAttachTiming,
     retryGate
   });
@@ -48,7 +50,7 @@ function createDeepAgentAttachTransport({
       fetch: instrumentation.fetch
     }
   };
-  return statewireTransport(options, { sse });
+  return statewireTransport(options, { sse: useSse });
 }
 export {
   createDeepAgentAttachTransport,

package/dist/agent-runtime/src/deep-agent-transport-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-agent-transport-recipe.js","sources":["../../../../agent-runtime/src/deep-agent-transport-recipe.ts"],"sourcesContent":["import type { ResourceElement } from \"@assistant-ui/tap\";\nimport type { Statewire, StatewireClient } from \"statewire\";\nimport {\n  type DeepAgentMessageWindowDeclaration,\n  withDeclaredMessageWindow,\n} from \"./message-window\";\nimport { withDeclaredProtocolVersion } from \"./protocol\";\nimport {\n  attachRetryGate,\n  type AttachRetryGate,\n  createAttachInstrumentation,\n  type DeepAgentAttachTimingEvent,\n  type DeepAgentWakeRefusal,\n  parseRetryAfterHeaderMs,\n} from \"./statewire-attach-observer\";\nimport {\n  resolveStatewireTransportKind,\n  statewireTransport,\n  type StatewireTransportOptions,\n} from \"./statewire-transport\";\n\n/** Auth-header resolver for the transport; `staleAuth` is true right after an\n * auth rejection, so resolvers that can force-renew should honor it. */\nexport type DeepAgentHeadersResolver = (ctx: {\n  staleAuth: boolean;\n}) => Record<string, string> | Promise<Record<string, string>>;\n\n/** The statewire attach URL for a thread: the host's `…/v2/threads` mount plus the id. */\nexport function deepAgentThreadUrl({\n  baseUrl,\n  threadId,\n}: {\n  baseUrl: string;\n  threadId: string;\n}): string {\n  return `${baseUrl.replace(/\\/+$/, \"\")}/${encodeURIComponent(threadId)}`;\n}\n\nexport interface DeepAgentAttachTransportOptions {\n  /** Base URL of the deep-agent statewire host (the `…/v2/threads` mount). */\n  baseUrl: string;\n  threadId: string;\n  headers: DeepAgentHeadersResolver;\n  /**\n   * SSE when true, WebSocket otherwise, over the qualified statewire client: an\n   * unqualified one gets SSE either way (`resolveStatewireTransportKind`).\n   */\n  sse?: boolean;\n  /** The statewire client class whose qualification picks the transport: the installed one unless given. */\n  statewireClient?: object;\n  /** A never-started chat: the transport makes no network calls until the first command send. */\n  isNew?: boolean;\n  /** Host session store (mobile); browser hosts mount `storage.session` on the thread instead. */\n  sessionStore?: StatewireClient.SessionStorage | undefined;\n  /** Observes every headers resolve (the diagnostics recorder's stale-auth seam). */\n  onAuthResolve?: ((ctx: { staleAuth: boolean }) => void) | undefined;\n  /** Attach timing + retry hints (see `statewire-attach-observer`). */\n  onAttachTiming?: ((event: DeepAgentAttachTimingEvent) => void) | undefined;\n  /** Dial floors from server retry hints; the process-wide gate by default. */\n  retryGate?: AttachRetryGate;\n  /**\n   * The head window declared on the attach (`x-athena-deep-agent-window`,\n   * see `message-window.ts`): the hello of a client the host does not\n   * remember carries the newest `size` messages. Part of the recipe so a\n   * pooled dial asks for the same shape as the thread's own attach — a pooled\n   * hello then seeds the very state the attach will reconcile. Omitted, the\n   * shared default is declared.\n   */\n  messageWindow?: DeepAgentMessageWindowDeclaration | undefined;\n}\n\n/**\n * The ONE recipe for a deep-agent thread transport — shared by the mounted\n * thread (`useDeepAgentThread`) and the prewarm pool, so a pre-dialed\n * connection is byte-for-byte the connection the thread would have opened\n * itself: same URL, same auth + wire-contract headers, same session lane, same\n * instrumentation.\n *\n * Every attach declares this build's wire-contract version alongside the\n * host's auth headers (first WS frame / SSE request headers) — the server\n * half of version negotiation reads it in `authorize`. The headers resolve\n * also waits out any server `Retry-After` floor for the thread: both statewire\n * attach paths resolve headers before they dial, so this is the seam where a\n * hint can hold the next dial without touching the library's backoff.\n */\nexport function createDeepAgentAttachTransport<TState = unknown>({\n  baseUrl,\n  threadId,\n  headers,\n  sse = false,\n  isNew = false,\n  sessionStore,\n  onAuthResolve,\n  onAttachTiming,\n  retryGate = attachRetryGate,\n  messageWindow,\n  statewireClient,\n}: DeepAgentAttachTransportOptions): ResourceElement<\n  Statewire<TState | undefined>\n> {\n  const url = deepAgentThreadUrl({ baseUrl, threadId });\n  // The instrumentation wraps the transport actually built: an SSE fallback\n  // needs the fetch wrapper that reads a refused attach's `Retry-After`.\n  const useSse =\n    resolveStatewireTransportKind({ sse, client: statewireClient }) === \"sse\";\n  const instrumentation = createAttachInstrumentation({\n    url,\n    sse: useSse,\n    onEvent: onAttachTiming,\n    retryGate,\n  });\n  const options: StatewireTransportOptions = {\n    url,\n    ...(isNew && { isNew: true }),\n    headers: async (ctx: { staleAuth: boolean }) => {\n      await retryGate.waitForDial(url);\n      onAuthResolve?.(ctx);\n      return withDeclaredMessageWindow(\n        withDeclaredProtocolVersion(await headers(ctx)),\n        messageWindow,\n      );\n    },\n    ...(sessionStore && { sessionStore }),\n    // Structural types: this package compiles without the DOM lib, while\n    // statewire's option types name the browser `WebSocket`/`fetch`.\n    ...(instrumentation.webSocket && {\n      webSocket:\n        instrumentation.webSocket as unknown as StatewireTransportOptions[\"webSocket\"],\n    }),\n    ...(instrumentation.fetch && {\n      fetch:\n        instrumentation.fetch as unknown as StatewireTransportOptions[\"fetch\"],\n    }),\n  };\n  return statewireTransport<TState>(options, { sse: useSse });\n}\n\n/** What `POST …/prewarm` answered. */\nexport interface DeepAgentWakeResult {\n  status: number;\n  /** The host activated the thread and its history is resident. */\n  warm: boolean;\n  /**\n   * `'warm'` when the history was already memoized, `'fresh_load'` when this\n   * call loaded it; `null` when the host did not say (a refusal, or a host\n   * without the route).\n   */\n  history: \"fresh_load\" | \"warm\" | null;\n  /**\n   * The dial floor recorded for the thread off a 503/429 `Retry-After` — the\n   * header's value, except a 503 `\"worker\"` refusal, capped at\n   * {@link WAKE_WORKER_REFUSAL_FLOOR_MS}.\n   */\n  retryAfterMs: number | null;\n  /** Who refused a 503/429 (see {@link DeepAgentWakeRefusal}); `null` for any other answer. */\n  refusal: DeepAgentWakeRefusal;\n  durationMs: number;\n}\n\n/**\n * Dial floor for a 503 the pinned worker produced about one instance's\n * lifecycle. Pinned answers every retriable 503 with a blanket\n * `Retry-After: 1`, but what those name — an instance record mid-teardown\n * (\"instance closing; retry\": fence release + placement release, ≈100 ms), a\n * full activation queue — clears far sooner than that, and the thread's own\n * attach is the request that carries the next activation. Holding it a full\n * second traded a ≈100 ms gap for a ≈1 s stall on every refused wake. A 429\n * is rate limiting and keeps its hint whatever the body says.\n */\nexport const WAKE_WORKER_REFUSAL_FLOOR_MS = 250;\n\n/**\n * The pinboard's own placement-refusal vocabulary — the `error` strings of\n * `@assistant-ui/pinboard` (`src/refusals.ts` plus the two inline refusals in\n * `src/server.ts`). Mirrors `PINBOARD_PLACEMENT_REFUSAL_ERRORS` in\n * `iris/scaler/src/v2AccessLog.ts`, whose test pins it to the installed\n * library; keep the two lists identical. A body with any other `error`\n * string is `\"unknown\"`, never `\"placement\"`.\n */\nexport const PINBOARD_PLACEMENT_REFUSAL_ERRORS: ReadonlySet<string> = new Set([\n  \"no live backends for namespace\",\n  \"registry cold start, retry\",\n  \"not the serving fleet\",\n  \"no live workers for hostname\",\n  \"hostname binding displaced, retry\",\n  \"hostname bindings inconsistent, retry\",\n  \"takeover in progress, retry\",\n  \"placement held by another hostname\",\n  \"worker inflight cap exceeded, retry\",\n  \"worker refused activation, retry\",\n]);\n\n/**\n * Pinned's instance-lifecycle refusals (`pinned/hosting/directory.py`,\n * `pinned/hosting/_records.py`): each names one instance on the worker the\n * thread is already placed on and clears in the time a teardown or an\n * activation slot takes. Anything else the worker answers 503 with — \"Thread\n * history load failed\", \"The regional conversation store is temporarily\n * unavailable\", a lease that expired — is not about one instance and keeps\n * the full hint.\n */\nexport const PINNED_TRANSIENT_WORKER_REFUSALS: ReadonlySet<string> = new Set([\n  \"instance closing; retry\",\n  \"instance aborted\",\n  \"activation queue full; retry\",\n  \"host draining; retry\",\n  \"instance capacity reached; retry\",\n  \"instance past its wind-down deadline; retry\",\n]);\n\n/**\n * Classify a 503/429 body (see {@link DeepAgentWakeRefusal}): a known pinboard\n * `error` is `\"placement\"`, a known pinned `detail` is `\"worker\"`, everything\n * else — including unfamiliar strings in either field — is `\"unknown\"`.\n */\nexport function classifyWakeRefusal(\n  body: unknown,\n): Exclude<DeepAgentWakeRefusal, null> {\n  if (typeof body === \"object\" && body !== null) {\n    const record = body as Record<string, unknown>;\n    if (\n      typeof record.error === \"string\" &&\n      PINBOARD_PLACEMENT_REFUSAL_ERRORS.has(record.error)\n    ) {\n      return \"placement\";\n    }\n    if (\n      typeof record.detail === \"string\" &&\n      PINNED_TRANSIENT_WORKER_REFUSALS.has(record.detail)\n    ) {\n      return \"worker\";\n    }\n  }\n  return \"unknown\";\n}\n\n/** Structural `fetch` for the wake call — this package compiles without the DOM lib. */\nexport type DeepAgentWakeFetch = (\n  input: string,\n  init?: {\n    method?: string;\n    headers?: Record<string, string>;\n    keepalive?: boolean;\n  },\n) => Promise<{\n  ok: boolean;\n  status: number;\n  headers: { get(name: string): string | null };\n  json(): Promise<unknown>;\n}>;\n\nexport interface DeepAgentWakeOptions {\n  /** Base URL of the deep-agent statewire host (the `…/v2/threads` mount). */\n  baseUrl: string;\n  threadId: string;\n  headers: DeepAgentHeadersResolver;\n  fetch?: DeepAgentWakeFetch | undefined;\n  /** Dial floors from server retry hints; the process-wide gate by default. */\n  retryGate?: AttachRetryGate;\n  onAttachTiming?: ((event: DeepAgentAttachTimingEvent) => void) | undefined;\n  now?: () => number;\n}\n\n/**\n * Wake a thread's server instance ahead of its attach. `POST …/prewarm` runs\n * the host's `authorize` and history load — the fence adopt, graph compile and\n * checkpoint read that make a cold attach's hello take ≈1 s — and answers with\n * no thread content, only whether the history was already resident. Fire it\n * on hover intent, before a pooled attach or the click's own dial, so the\n * activation overlaps the handshake and the attach that follows finds the\n * instance warm.\n *\n * Fire-and-forget by contract: every failure resolves `null`, and a host\n * without the route (404) is reported like any other non-OK answer. A 503/429\n * `Retry-After` is recorded as a dial floor for the thread, so the attach that\n * follows waits it out instead of bouncing — in full, except a 503 that names\n * one of pinned's instance-lifecycle refusals (one instance mid-teardown on\n * the worker the thread already has; see {@link DeepAgentWakeRefusal}), whose\n * floor is capped at {@link WAKE_WORKER_REFUSAL_FLOOR_MS}.\n */\nexport async function wakeDeepAgentThread({\n  baseUrl,\n  threadId,\n  headers,\n  fetch: fetchOverride,\n  retryGate = attachRetryGate,\n  onAttachTiming,\n  now = () => Date.now(),\n}: DeepAgentWakeOptions): Promise<DeepAgentWakeResult | null> {\n  const fetchImpl =\n    fetchOverride ?? (globalThis as { fetch?: DeepAgentWakeFetch }).fetch;\n  if (typeof fetchImpl !== \"function\") return null;\n  const threadUrl = deepAgentThreadUrl({ baseUrl, threadId });\n  const emit = (event: DeepAgentAttachTimingEvent): void => {\n    try {\n      onAttachTiming?.(event);\n    } catch {\n      // Observers are best-effort.\n    }\n  };\n  const startedAt = now();\n  try {\n    const resolved = withDeclaredProtocolVersion(\n      await headers({ staleAuth: false }),\n    );\n    const response = await fetchImpl(`${threadUrl}/prewarm`, {\n      method: \"POST\",\n      headers: resolved,\n      keepalive: true,\n    });\n    const durationMs = now() - startedAt;\n    let retryAfterMs: number | null = null;\n    let refusal: DeepAgentWakeRefusal = null;\n    if (response.status === 503 || response.status === 429) {\n      let body: unknown = null;\n      try {\n        body = await response.json();\n      } catch {\n        // A refusal without a readable body is classified by nothing.\n      }\n      refusal = classifyWakeRefusal(body);\n      const hinted = parseRetryAfterHeaderMs(\n        response.headers.get(\"retry-after\"),\n        now,\n      );\n      if (hinted !== null) {\n        retryAfterMs =\n          response.status === 503 && refusal === \"worker\"\n            ? Math.min(hinted, WAKE_WORKER_REFUSAL_FLOOR_MS)\n            : hinted;\n        if (retryAfterMs > 0) {\n          retryGate.noteRetryAfter(threadUrl, retryAfterMs);\n          emit({\n            type: \"retry-after\",\n            url: threadUrl,\n            delayMs: retryAfterMs,\n            source: \"http-header\",\n          });\n        }\n      }\n    }\n    let warm = false;\n    let history: DeepAgentWakeResult[\"history\"] = null;\n    if (response.ok) {\n      try {\n        const body = (await response.json()) as {\n          warm?: unknown;\n          history?: unknown;\n        } | null;\n        warm = body?.warm === true;\n        history =\n          body?.history === \"warm\" || body?.history === \"fresh_load\"\n            ? body.history\n            : null;\n      } catch {\n        // A 200 without a JSON body still means the instance is up.\n        warm = true;\n      }\n    }\n    emit({\n      type: \"wake\",\n      url: threadUrl,\n      status: response.status,\n      durationMs,\n      history,\n      refusal,\n    });\n    return {\n      status: response.status,\n      warm,\n      history,\n      retryAfterMs,\n      refusal,\n      durationMs,\n    };\n  } catch {\n    return null;\n  }\n}\n"],"names":[],"mappings":";;;;AA4BO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AACF,GAGW;AACT,SAAO,GAAG,QAAQ,QAAQ,QAAQ,EAAE,CAAC,IAAI,mBAAmB,QAAQ,CAAC;AACvE;AAiDO,SAAS,+BAAiD;AAAA,EAC/D;AAAA,EACA;AAAA,EACA;AAAA,EACA,MAAM;AAAA,EACN,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA;AACF,GAEE;AACA,QAAM,MAAM,mBAAmB,EAAE,SAAS,UAAU;AAGpD,QAAM,SACJ,8BAA8B,EAAE,KAAK,QAAQ,gBAAA,CAAiB,MAAM;AACtE,QAAM,kBAAkB,4BAA4B;AAAA,IAClD;AAAA,IACA,KAAK;AAAA,IACL,SAAS;AAAA,IACT;AAAA,EAAA,CACD;AACD,QAAM,UAAqC;AAAA,IACzC;AAAA,IACA,GAAI,SAAS,EAAE,OAAO,KAAA;AAAA,IACtB,SAAS,OAAO,QAAgC;AAC9C,YAAM,UAAU,YAAY,GAAG;AAC/B,qDAAgB;AAChB,aAAO;AAAA,QACL,4BAA4B,MAAM,QAAQ,GAAG,CAAC;AAAA,QAC9C;AAAA,MAAA;AAAA,IAEJ;AAAA,IACA,GAAI,gBAAgB,EAAE,aAAA;AAAA;AAAA;AAAA,IAGtB,GAAI,gBAAgB,aAAa;AAAA,MAC/B,WACE,gBAAgB;AAAA,IAAA;AAAA,IAEpB,GAAI,gBAAgB,SAAS;AAAA,MAC3B,OACE,gBAAgB;AAAA,IAAA;AAAA,EACpB;AAEF,SAAO,mBAA2B,SAAS,EAAE,KAAK,QAAQ;AAC5D;"}

package/dist/agent-runtime/src/edit-command.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-command.cjs","sources":["../../../../agent-runtime/src/edit-command.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { DEEP_AGENT_INTEREST_PROTOCOL } from './generated/runconfig-contract';\nimport {\n  type DeepAgentMessageWindow,\n  pageInterestRequests,\n  readDeepAgentMessageWindow,\n} from './message-window';\nimport { hasStatewireThreadExtras } from './thread-extras';\n\n/**\n * Wire-accurate `run/edit` construction for deep-agent retry/edit, shared by\n * every surface that resubmits a user message.\n *\n * assistant-ui builds the command's `runAnchorMessageId` from the CONVERTED\n * thread messages (`resolveEditCommand`: `messages[index - 1].id`), but the\n * deep-agent host validates that anchor against the edited message's parent in\n * its RAW message list (`harness_sdk.linear_thread`: the entry before it in\n * `state[\"messages\"]`). Those two lists do not line up:\n *\n * - the converter chunks an assistant turn and its tool messages into ONE\n *   thread message carrying only the FIRST wire id, so the anchor names the\n *   head of the previous turn instead of its last tool message;\n * - `sanitizeLangChainMessages` drops hidden-from-frontend and unconvertible\n *   entries, so a dropped tail message is invisible to the anchor too.\n *\n * Either way the host rejects the command with `wrong-anchor`\n * (`runAnchorMessageId … is not the source's parent`) AFTER the composer's\n * synchronous `send()` returned, so the retry/edit silently does nothing.\n *\n * Building the command here off the replicated raw state makes the anchor the\n * same value the host computes.\n *\n * The raw list is the loaded interest window, so the first loaded message's\n * parent is not in it while older messages exist — an edit there must not\n * anchor on `null` (the root, rejected `wrong-anchor`); a message below the\n * window has no parent on this client at all. {@link resolveDeepAgentEditCommand}\n * states older page interests until the parent is loaded.\n */\n\n/**\n * Host metadata frozen at submission, settling once the async capture does.\n * The message-metadata preparation surface — `prepareMessageMetadata`,\n * `discardPreparedMessageMetadata`, `sendPreparedEdit` and `sendCommand`'s\n * `preparedMetadata` option — is what the monorepo patches into\n * `@assistant-ui/react-statewire@0.30.0` (`patches/`). It is declared\n * structurally here rather than as `StatewireThread.Extras[...]` so that the\n * published sources also compile against the unpatched upstream typings, where\n * those members are absent and the edit path's optional calls never run.\n */\nexport type DeepAgentPreparedMessageMetadata = Promise<Record<string, unknown> | undefined>;\n\n/** The pieces of the statewire thread extras the edit path reads. */\nexport interface DeepAgentStatewireExtras {\n  /** The library's dispatch; it resolves with the host's reply to the command. */\n  sendCommand: (\n    command: StatewireThread.Command,\n    options?: { preparedMetadata?: DeepAgentPreparedMessageMetadata | undefined },\n  ) => Promise<unknown> | void;\n  /** Optional on older hosts; capture before loading an edit's history anchor. */\n  prepareMessageMetadata?: (() => DeepAgentPreparedMessageMetadata) | undefined;\n  discardPreparedMessageMetadata?:\n    | ((prepared: DeepAgentPreparedMessageMetadata) => void)\n    | undefined;\n  sendPreparedEdit?:\n    | ((sourceId: string, prepared: DeepAgentPreparedMessageMetadata) => void)\n    | undefined;\n  isPreparingSubmission?: boolean;\n  /** The composed thread state — its `messages` are the raw wire messages of the loaded window. */\n  state: { messages?: readonly { id?: unknown }[] } | null;\n  /** The mounted documents (the interest window), absent on a wire without documents. */\n  documents?: StatewireThread.Extras['documents'];\n  invoke?: StatewireThread.Extras['invoke'];\n  /** The live run, when one is in flight; `epoch` advances on each dispatch. */\n  runs: { runId?: string | null; epoch?: number };\n  /** The host's replicated run status; absent on a surface that predates it. */\n  status?: StatewireThread.ThreadStatus;\n}\n\n/**\n * The statewire extras of the nearest aui thread, or `null` when the thread is\n * not a statewire thread (e.g. a read-only subagent transcript runtime).\n * Gated on {@link hasStatewireThreadExtras} for the same reason the approval\n * card is: the library's own hooks throw on a non-statewire thread.\n */\nexport function readDeepAgentStatewireExtras(extras: unknown): DeepAgentStatewireExtras | null {\n  if (!hasStatewireThreadExtras(extras)) return null;\n  return extras as DeepAgentStatewireExtras;\n}\n\n/**\n * The host's parent of `sourceId`: the raw wire message directly before it\n * (`null` when it is the first of the whole transcript). Returns `undefined`\n * when `sourceId` is not in the raw list at all — an optimistic bubble the\n * host has not settled yet, a message below the loaded window, or a surface\n * whose state this module cannot read — or when it is the first loaded\n * message while older ones exist (`hasOlder`), so the caller can load more or\n * fall back to the library's own path instead of asserting a wrong anchor.\n */\nexport function resolveWireAnchorMessageId({\n  wireMessages,\n  sourceId,\n  hasOlder = false,\n}: {\n  wireMessages: readonly { id?: unknown }[] | undefined;\n  sourceId: string;\n  hasOlder?: boolean;\n}): string | null | undefined {\n  if (!wireMessages) return undefined;\n  const index = wireMessages.findIndex((message) => message?.id === sourceId);\n  if (index < 0) return undefined;\n  if (index === 0) return hasOlder ? undefined : null;\n  const parentId = wireMessages[index - 1]?.id;\n  return typeof parentId === 'string' ? parentId : undefined;\n}\n\n/**\n * Whether `sourceId`'s parent lies below the loaded window: the message is\n * absent from the raw list, or its first entry, while older messages exist.\n * The caller loads older history before an edit can be anchored.\n */\nexport function isSourceBelowLoadedWindow({\n  wireMessages,\n  sourceId,\n  window,\n}: {\n  wireMessages: readonly { id?: unknown }[] | undefined;\n  sourceId: string;\n  window: DeepAgentMessageWindow | null;\n}): boolean {\n  if (!wireMessages || window === null || !window.hasOlder) return false;\n  const index = wireMessages.findIndex((message) => message?.id === sourceId);\n  return index <= 0;\n}\n\nconst readWindow = (extras: DeepAgentStatewireExtras) =>\n  readDeepAgentMessageWindow(extras.documents?.list());\n\n/**\n * A fresh command / message id (uniqueness, not secrecy). `crypto.randomUUID`\n * where the host runtime has it — every browser, Bun, Node and Hermes with\n * webcrypto — and a v4-shaped fallback elsewhere, so the shared path never\n * throws on a runtime without full webcrypto.\n */\nfunction mintCommandId(): string {\n  const webcrypto = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (typeof webcrypto?.randomUUID === 'function') return webcrypto.randomUUID();\n  const hex = (): string => Math.floor(Math.random() * 0x10000).toString(16).padStart(4, '0');\n  return `${hex()}${hex()}-${hex()}-4${hex().slice(1)}-${hex()}-${hex()}${hex()}${hex()}`;\n}\n\n/**\n * The `run/edit` command for resubmitting `sourceId` with `text`, anchored on\n * the host's own parent. `null` when the anchor cannot be resolved from the\n * replicated state.\n */\nexport function buildDeepAgentEditCommand({\n  extras,\n  sourceId,\n  text,\n}: {\n  extras: DeepAgentStatewireExtras;\n  sourceId: string;\n  text: string;\n}): StatewireThread.RunEditCommand | null {\n  const runAnchorMessageId = resolveWireAnchorMessageId({\n    wireMessages: extras.state?.messages,\n    sourceId,\n    hasOlder: readWindow(extras)?.hasOlder ?? false,\n  });\n  if (runAnchorMessageId === undefined) return null;\n  return {\n    type: 'run/edit',\n    runId: extras.runs.runId ?? mintCommandId(),\n    message: { id: mintCommandId(), role: 'user', parts: [{ type: 'text', text }] },\n    sourceId,\n    runAnchorMessageId,\n  };\n}\n\n/**\n * State one more page of older history for a windowed thread: the next page\n * past the loaded window's oldest message. Resolves `true` once the host has\n * mounted it (it answers the statement after mounting), `false` when there is\n * nothing older, the thread is not a windowed statewire thread, or no page can\n * be stated. For a reader that needs a message below the loaded window — a\n * search result revealing an older turn of a long conversation — and pages\n * until it renders.\n */\nexport async function loadOlderDeepAgentHistoryPage({\n  readExtras,\n  pageSize,\n}: {\n  readExtras: () => DeepAgentStatewireExtras | null;\n  pageSize?: number;\n}): Promise<boolean> {\n  const extras = readExtras();\n  if (!extras?.invoke) return false;\n  const window = readWindow(extras);\n  if (window === null || !window.hasOlder) return false;\n  const requests = pageInterestRequests(window, pageSize);\n  if (requests === null) return false;\n  await extras.invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [requests]);\n  return true;\n}\n\n/**\n * Pages of older history stated while looking for an edited message's host\n * parent. Each page is up to a window's worth of messages, so an edit reaches\n * this many windows below what was loaded before it gives up.\n */\nexport const MAX_EDIT_ANCHOR_HISTORY_LOADS = 5;\n\n/**\n * The anchored `run/edit` for `sourceId`, stating older page interests one at\n * a time when the message's parent lies below the loaded window. Every page\n * is read back from the live documents (`readExtras` — the host mounts them\n * before it answers the statement), so the anchor is always the host's own\n * parent id.\n *\n * Resolves `null` — the caller's cue for the library's composer path, whose\n * failure it reports — when the thread is not a statewire thread, the host has\n * not settled the message, the history is exhausted without it, or the page\n * budget ({@link MAX_EDIT_ANCHOR_HISTORY_LOADS}) is spent. A synchronous\n * resolution never awaits: the first read either anchors at once or decides\n * that pages are needed.\n */\nexport async function resolveDeepAgentEditCommand({\n  readExtras,\n  sourceId,\n  text,\n  pageSize,\n  maxHistoryLoads = MAX_EDIT_ANCHOR_HISTORY_LOADS,\n}: {\n  /** The live thread extras — re-read per page so each anchor attempt sees the widened window. */\n  readExtras: () => DeepAgentStatewireExtras | null;\n  sourceId: string;\n  text: string;\n  pageSize?: number;\n  maxHistoryLoads?: number;\n}): Promise<StatewireThread.RunEditCommand | null> {\n  for (let page = 0; page <= maxHistoryLoads; page += 1) {\n    const extras = readExtras();\n    if (!extras) return null;\n    const command = buildDeepAgentEditCommand({ extras, sourceId, text });\n    if (command) return command;\n    if (page === maxHistoryLoads || !extras.invoke) return null;\n    const window = readWindow(extras);\n    if (!isSourceBelowLoadedWindow({ wireMessages: extras.state?.messages, sourceId, window })) {\n      return null;\n    }\n    const requests = window === null ? null : pageInterestRequests(window, pageSize);\n    if (requests === null) return null;\n    await extras.invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [requests]);\n  }\n  return null;\n}\n"],"names":["hasStatewireThreadExtras","readDeepAgentMessageWindow","pageInterestRequests","DEEP_AGENT_INTEREST_PROTOCOL"],"mappings":";;;;;AAoFO,SAAS,6BAA6B,QAAkD;AAC7F,MAAI,CAACA,aAAAA,yBAAyB,MAAM,EAAG,QAAO;AAC9C,SAAO;AACT;AAWO,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA;AAAA,EACA,WAAW;AACb,GAI8B;;AAC5B,MAAI,CAAC,aAAc,QAAO;AAC1B,QAAM,QAAQ,aAAa,UAAU,CAAC,aAAY,mCAAS,QAAO,QAAQ;AAC1E,MAAI,QAAQ,EAAG,QAAO;AACtB,MAAI,UAAU,EAAG,QAAO,WAAW,SAAY;AAC/C,QAAM,YAAW,kBAAa,QAAQ,CAAC,MAAtB,mBAAyB;AAC1C,SAAO,OAAO,aAAa,WAAW,WAAW;AACnD;AAOO,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,GAIY;AACV,MAAI,CAAC,gBAAgB,WAAW,QAAQ,CAAC,OAAO,SAAU,QAAO;AACjE,QAAM,QAAQ,aAAa,UAAU,CAAC,aAAY,mCAAS,QAAO,QAAQ;AAC1E,SAAO,SAAS;AAClB;AAEA,MAAM,aAAa,CAAC,WAAA;;AAClBC,uBAAAA,4BAA2B,YAAO,cAAP,mBAAkB,MAAM;AAAA;AAQrD,SAAS,gBAAwB;AAC/B,QAAM,YAAa,WAA0D;AAC7E,MAAI,QAAO,uCAAW,gBAAe,WAAY,QAAO,UAAU,WAAA;AAClE,QAAM,MAAM,MAAc,KAAK,MAAM,KAAK,OAAA,IAAW,KAAO,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAC1F,SAAO,GAAG,IAAA,CAAK,GAAG,IAAA,CAAK,IAAI,IAAA,CAAK,KAAK,MAAM,MAAM,CAAC,CAAC,IAAI,IAAA,CAAK,IAAI,KAAK,GAAG,IAAA,CAAK,GAAG,IAAA,CAAK;AACvF;AAOO,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,GAI0C;;AACxC,QAAM,qBAAqB,2BAA2B;AAAA,IACpD,eAAc,YAAO,UAAP,mBAAc;AAAA,IAC5B;AAAA,IACA,YAAU,gBAAW,MAAM,MAAjB,mBAAoB,aAAY;AAAA,EAAA,CAC3C;AACD,MAAI,uBAAuB,OAAW,QAAO;AAC7C,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,OAAO,KAAK,SAAS,cAAA;AAAA,IAC5B,SAAS,EAAE,IAAI,cAAA,GAAiB,MAAM,QAAQ,OAAO,CAAC,EAAE,MAAM,QAAQ,KAAA,CAAM,EAAA;AAAA,IAC5E;AAAA,IACA;AAAA,EAAA;AAEJ;AAiCO,MAAM,gCAAgC;AAgB7C,eAAsB,4BAA4B;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AACpB,GAOmD;;AACjD,WAAS,OAAO,GAAG,QAAQ,iBAAiB,QAAQ,GAAG;AACrD,UAAM,SAAS,WAAA;AACf,QAAI,CAAC,OAAQ,QAAO;AACpB,UAAM,UAAU,0BAA0B,EAAE,QAAQ,UAAU,MAAM;AACpE,QAAI,QAAS,QAAO;AACpB,QAAI,SAAS,mBAAmB,CAAC,OAAO,OAAQ,QAAO;AACvD,UAAM,SAAS,WAAW,MAAM;AAChC,QAAI,CAAC,0BAA0B,EAAE,eAAc,YAAO,UAAP,mBAAc,UAAU,UAAU,OAAA,CAAQ,GAAG;AAC1F,aAAO;AAAA,IACT;AACA,UAAM,WAAW,WAAW,OAAO,OAAOC,cAAAA,qBAAqB,QAAQ,QAAQ;AAC/E,QAAI,aAAa,KAAM,QAAO;AAC9B,UAAM,OAAO,OAAOC,kBAAAA,8BAA8B,OAAO,CAAC,QAAQ,CAAC;AAAA,EACrE;AACA,SAAO;AACT;;;;;;;"}

package/dist/agent-runtime/src/edit-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-command.js","sources":["../../../../agent-runtime/src/edit-command.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { DEEP_AGENT_INTEREST_PROTOCOL } from './generated/runconfig-contract';\nimport {\n  type DeepAgentMessageWindow,\n  pageInterestRequests,\n  readDeepAgentMessageWindow,\n} from './message-window';\nimport { hasStatewireThreadExtras } from './thread-extras';\n\n/**\n * Wire-accurate `run/edit` construction for deep-agent retry/edit, shared by\n * every surface that resubmits a user message.\n *\n * assistant-ui builds the command's `runAnchorMessageId` from the CONVERTED\n * thread messages (`resolveEditCommand`: `messages[index - 1].id`), but the\n * deep-agent host validates that anchor against the edited message's parent in\n * its RAW message list (`harness_sdk.linear_thread`: the entry before it in\n * `state[\"messages\"]`). Those two lists do not line up:\n *\n * - the converter chunks an assistant turn and its tool messages into ONE\n *   thread message carrying only the FIRST wire id, so the anchor names the\n *   head of the previous turn instead of its last tool message;\n * - `sanitizeLangChainMessages` drops hidden-from-frontend and unconvertible\n *   entries, so a dropped tail message is invisible to the anchor too.\n *\n * Either way the host rejects the command with `wrong-anchor`\n * (`runAnchorMessageId … is not the source's parent`) AFTER the composer's\n * synchronous `send()` returned, so the retry/edit silently does nothing.\n *\n * Building the command here off the replicated raw state makes the anchor the\n * same value the host computes.\n *\n * The raw list is the loaded interest window, so the first loaded message's\n * parent is not in it while older messages exist — an edit there must not\n * anchor on `null` (the root, rejected `wrong-anchor`); a message below the\n * window has no parent on this client at all. {@link resolveDeepAgentEditCommand}\n * states older page interests until the parent is loaded.\n */\n\n/**\n * Host metadata frozen at submission, settling once the async capture does.\n * The message-metadata preparation surface — `prepareMessageMetadata`,\n * `discardPreparedMessageMetadata`, `sendPreparedEdit` and `sendCommand`'s\n * `preparedMetadata` option — is what the monorepo patches into\n * `@assistant-ui/react-statewire@0.30.0` (`patches/`). It is declared\n * structurally here rather than as `StatewireThread.Extras[...]` so that the\n * published sources also compile against the unpatched upstream typings, where\n * those members are absent and the edit path's optional calls never run.\n */\nexport type DeepAgentPreparedMessageMetadata = Promise<Record<string, unknown> | undefined>;\n\n/** The pieces of the statewire thread extras the edit path reads. */\nexport interface DeepAgentStatewireExtras {\n  /** The library's dispatch; it resolves with the host's reply to the command. */\n  sendCommand: (\n    command: StatewireThread.Command,\n    options?: { preparedMetadata?: DeepAgentPreparedMessageMetadata | undefined },\n  ) => Promise<unknown> | void;\n  /** Optional on older hosts; capture before loading an edit's history anchor. */\n  prepareMessageMetadata?: (() => DeepAgentPreparedMessageMetadata) | undefined;\n  discardPreparedMessageMetadata?:\n    | ((prepared: DeepAgentPreparedMessageMetadata) => void)\n    | undefined;\n  sendPreparedEdit?:\n    | ((sourceId: string, prepared: DeepAgentPreparedMessageMetadata) => void)\n    | undefined;\n  isPreparingSubmission?: boolean;\n  /** The composed thread state — its `messages` are the raw wire messages of the loaded window. */\n  state: { messages?: readonly { id?: unknown }[] } | null;\n  /** The mounted documents (the interest window), absent on a wire without documents. */\n  documents?: StatewireThread.Extras['documents'];\n  invoke?: StatewireThread.Extras['invoke'];\n  /** The live run, when one is in flight; `epoch` advances on each dispatch. */\n  runs: { runId?: string | null; epoch?: number };\n  /** The host's replicated run status; absent on a surface that predates it. */\n  status?: StatewireThread.ThreadStatus;\n}\n\n/**\n * The statewire extras of the nearest aui thread, or `null` when the thread is\n * not a statewire thread (e.g. a read-only subagent transcript runtime).\n * Gated on {@link hasStatewireThreadExtras} for the same reason the approval\n * card is: the library's own hooks throw on a non-statewire thread.\n */\nexport function readDeepAgentStatewireExtras(extras: unknown): DeepAgentStatewireExtras | null {\n  if (!hasStatewireThreadExtras(extras)) return null;\n  return extras as DeepAgentStatewireExtras;\n}\n\n/**\n * The host's parent of `sourceId`: the raw wire message directly before it\n * (`null` when it is the first of the whole transcript). Returns `undefined`\n * when `sourceId` is not in the raw list at all — an optimistic bubble the\n * host has not settled yet, a message below the loaded window, or a surface\n * whose state this module cannot read — or when it is the first loaded\n * message while older ones exist (`hasOlder`), so the caller can load more or\n * fall back to the library's own path instead of asserting a wrong anchor.\n */\nexport function resolveWireAnchorMessageId({\n  wireMessages,\n  sourceId,\n  hasOlder = false,\n}: {\n  wireMessages: readonly { id?: unknown }[] | undefined;\n  sourceId: string;\n  hasOlder?: boolean;\n}): string | null | undefined {\n  if (!wireMessages) return undefined;\n  const index = wireMessages.findIndex((message) => message?.id === sourceId);\n  if (index < 0) return undefined;\n  if (index === 0) return hasOlder ? undefined : null;\n  const parentId = wireMessages[index - 1]?.id;\n  return typeof parentId === 'string' ? parentId : undefined;\n}\n\n/**\n * Whether `sourceId`'s parent lies below the loaded window: the message is\n * absent from the raw list, or its first entry, while older messages exist.\n * The caller loads older history before an edit can be anchored.\n */\nexport function isSourceBelowLoadedWindow({\n  wireMessages,\n  sourceId,\n  window,\n}: {\n  wireMessages: readonly { id?: unknown }[] | undefined;\n  sourceId: string;\n  window: DeepAgentMessageWindow | null;\n}): boolean {\n  if (!wireMessages || window === null || !window.hasOlder) return false;\n  const index = wireMessages.findIndex((message) => message?.id === sourceId);\n  return index <= 0;\n}\n\nconst readWindow = (extras: DeepAgentStatewireExtras) =>\n  readDeepAgentMessageWindow(extras.documents?.list());\n\n/**\n * A fresh command / message id (uniqueness, not secrecy). `crypto.randomUUID`\n * where the host runtime has it — every browser, Bun, Node and Hermes with\n * webcrypto — and a v4-shaped fallback elsewhere, so the shared path never\n * throws on a runtime without full webcrypto.\n */\nfunction mintCommandId(): string {\n  const webcrypto = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (typeof webcrypto?.randomUUID === 'function') return webcrypto.randomUUID();\n  const hex = (): string => Math.floor(Math.random() * 0x10000).toString(16).padStart(4, '0');\n  return `${hex()}${hex()}-${hex()}-4${hex().slice(1)}-${hex()}-${hex()}${hex()}${hex()}`;\n}\n\n/**\n * The `run/edit` command for resubmitting `sourceId` with `text`, anchored on\n * the host's own parent. `null` when the anchor cannot be resolved from the\n * replicated state.\n */\nexport function buildDeepAgentEditCommand({\n  extras,\n  sourceId,\n  text,\n}: {\n  extras: DeepAgentStatewireExtras;\n  sourceId: string;\n  text: string;\n}): StatewireThread.RunEditCommand | null {\n  const runAnchorMessageId = resolveWireAnchorMessageId({\n    wireMessages: extras.state?.messages,\n    sourceId,\n    hasOlder: readWindow(extras)?.hasOlder ?? false,\n  });\n  if (runAnchorMessageId === undefined) return null;\n  return {\n    type: 'run/edit',\n    runId: extras.runs.runId ?? mintCommandId(),\n    message: { id: mintCommandId(), role: 'user', parts: [{ type: 'text', text }] },\n    sourceId,\n    runAnchorMessageId,\n  };\n}\n\n/**\n * State one more page of older history for a windowed thread: the next page\n * past the loaded window's oldest message. Resolves `true` once the host has\n * mounted it (it answers the statement after mounting), `false` when there is\n * nothing older, the thread is not a windowed statewire thread, or no page can\n * be stated. For a reader that needs a message below the loaded window — a\n * search result revealing an older turn of a long conversation — and pages\n * until it renders.\n */\nexport async function loadOlderDeepAgentHistoryPage({\n  readExtras,\n  pageSize,\n}: {\n  readExtras: () => DeepAgentStatewireExtras | null;\n  pageSize?: number;\n}): Promise<boolean> {\n  const extras = readExtras();\n  if (!extras?.invoke) return false;\n  const window = readWindow(extras);\n  if (window === null || !window.hasOlder) return false;\n  const requests = pageInterestRequests(window, pageSize);\n  if (requests === null) return false;\n  await extras.invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [requests]);\n  return true;\n}\n\n/**\n * Pages of older history stated while looking for an edited message's host\n * parent. Each page is up to a window's worth of messages, so an edit reaches\n * this many windows below what was loaded before it gives up.\n */\nexport const MAX_EDIT_ANCHOR_HISTORY_LOADS = 5;\n\n/**\n * The anchored `run/edit` for `sourceId`, stating older page interests one at\n * a time when the message's parent lies below the loaded window. Every page\n * is read back from the live documents (`readExtras` — the host mounts them\n * before it answers the statement), so the anchor is always the host's own\n * parent id.\n *\n * Resolves `null` — the caller's cue for the library's composer path, whose\n * failure it reports — when the thread is not a statewire thread, the host has\n * not settled the message, the history is exhausted without it, or the page\n * budget ({@link MAX_EDIT_ANCHOR_HISTORY_LOADS}) is spent. A synchronous\n * resolution never awaits: the first read either anchors at once or decides\n * that pages are needed.\n */\nexport async function resolveDeepAgentEditCommand({\n  readExtras,\n  sourceId,\n  text,\n  pageSize,\n  maxHistoryLoads = MAX_EDIT_ANCHOR_HISTORY_LOADS,\n}: {\n  /** The live thread extras — re-read per page so each anchor attempt sees the widened window. */\n  readExtras: () => DeepAgentStatewireExtras | null;\n  sourceId: string;\n  text: string;\n  pageSize?: number;\n  maxHistoryLoads?: number;\n}): Promise<StatewireThread.RunEditCommand | null> {\n  for (let page = 0; page <= maxHistoryLoads; page += 1) {\n    const extras = readExtras();\n    if (!extras) return null;\n    const command = buildDeepAgentEditCommand({ extras, sourceId, text });\n    if (command) return command;\n    if (page === maxHistoryLoads || !extras.invoke) return null;\n    const window = readWindow(extras);\n    if (!isSourceBelowLoadedWindow({ wireMessages: extras.state?.messages, sourceId, window })) {\n      return null;\n    }\n    const requests = window === null ? null : pageInterestRequests(window, pageSize);\n    if (requests === null) return null;\n    await extras.invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [requests]);\n  }\n  return null;\n}\n"],"names":[],"mappings":";;;AAoFO,SAAS,6BAA6B,QAAkD;AAC7F,MAAI,CAAC,yBAAyB,MAAM,EAAG,QAAO;AAC9C,SAAO;AACT;AAWO,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA;AAAA,EACA,WAAW;AACb,GAI8B;;AAC5B,MAAI,CAAC,aAAc,QAAO;AAC1B,QAAM,QAAQ,aAAa,UAAU,CAAC,aAAY,mCAAS,QAAO,QAAQ;AAC1E,MAAI,QAAQ,EAAG,QAAO;AACtB,MAAI,UAAU,EAAG,QAAO,WAAW,SAAY;AAC/C,QAAM,YAAW,kBAAa,QAAQ,CAAC,MAAtB,mBAAyB;AAC1C,SAAO,OAAO,aAAa,WAAW,WAAW;AACnD;AAOO,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,GAIY;AACV,MAAI,CAAC,gBAAgB,WAAW,QAAQ,CAAC,OAAO,SAAU,QAAO;AACjE,QAAM,QAAQ,aAAa,UAAU,CAAC,aAAY,mCAAS,QAAO,QAAQ;AAC1E,SAAO,SAAS;AAClB;AAEA,MAAM,aAAa,CAAC,WAAA;;AAClB,qCAA2B,YAAO,cAAP,mBAAkB,MAAM;AAAA;AAQrD,SAAS,gBAAwB;AAC/B,QAAM,YAAa,WAA0D;AAC7E,MAAI,QAAO,uCAAW,gBAAe,WAAY,QAAO,UAAU,WAAA;AAClE,QAAM,MAAM,MAAc,KAAK,MAAM,KAAK,OAAA,IAAW,KAAO,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAC1F,SAAO,GAAG,IAAA,CAAK,GAAG,IAAA,CAAK,IAAI,IAAA,CAAK,KAAK,MAAM,MAAM,CAAC,CAAC,IAAI,IAAA,CAAK,IAAI,KAAK,GAAG,IAAA,CAAK,GAAG,IAAA,CAAK;AACvF;AAOO,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,GAI0C;;AACxC,QAAM,qBAAqB,2BAA2B;AAAA,IACpD,eAAc,YAAO,UAAP,mBAAc;AAAA,IAC5B;AAAA,IACA,YAAU,gBAAW,MAAM,MAAjB,mBAAoB,aAAY;AAAA,EAAA,CAC3C;AACD,MAAI,uBAAuB,OAAW,QAAO;AAC7C,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,OAAO,KAAK,SAAS,cAAA;AAAA,IAC5B,SAAS,EAAE,IAAI,cAAA,GAAiB,MAAM,QAAQ,OAAO,CAAC,EAAE,MAAM,QAAQ,KAAA,CAAM,EAAA;AAAA,IAC5E;AAAA,IACA;AAAA,EAAA;AAEJ;AAiCO,MAAM,gCAAgC;AAgB7C,eAAsB,4BAA4B;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AACpB,GAOmD;;AACjD,WAAS,OAAO,GAAG,QAAQ,iBAAiB,QAAQ,GAAG;AACrD,UAAM,SAAS,WAAA;AACf,QAAI,CAAC,OAAQ,QAAO;AACpB,UAAM,UAAU,0BAA0B,EAAE,QAAQ,UAAU,MAAM;AACpE,QAAI,QAAS,QAAO;AACpB,QAAI,SAAS,mBAAmB,CAAC,OAAO,OAAQ,QAAO;AACvD,UAAM,SAAS,WAAW,MAAM;AAChC,QAAI,CAAC,0BAA0B,EAAE,eAAc,YAAO,UAAP,mBAAc,UAAU,UAAU,OAAA,CAAQ,GAAG;AAC1F,aAAO;AAAA,IACT;AACA,UAAM,WAAW,WAAW,OAAO,OAAO,qBAAqB,QAAQ,QAAQ;AAC/E,QAAI,aAAa,KAAM,QAAO;AAC9B,UAAM,OAAO,OAAO,8BAA8B,OAAO,CAAC,QAAQ,CAAC;AAAA,EACrE;AACA,SAAO;AACT;"}

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

@@ -25,6 +25,26 @@ function readRetryableRunRefusal(error) {
   if (error === null || typeof error !== "object" || Array.isArray(error)) return null;
   return readRetryableDetail(error.detail);
 }
+const COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = "collab_agent_channel_session_mismatch";
+function readRunStartRefusal(error) {
+  if (error === null || typeof error !== "object" || Array.isArray(error)) return null;
+  const { detail, status } = error;
+  if (detail === null || typeof detail !== "object" || Array.isArray(detail)) return null;
+  const { code, message, retryable } = detail;
+  if (retryable === true || typeof code !== "string" || code.length === 0) return null;
+  return {
+    code,
+    message: typeof message === "string" && message.length > 0 ? message : null,
+    status: typeof status === "number" ? status : null
+  };
+}
+function statewireRejectionCode(error) {
+  var _a;
+  const detail = (_a = statewireRejectionPayload(error)) == null ? void 0 : _a.detail;
+  if (detail === null || typeof detail !== "object" || Array.isArray(detail)) return null;
+  const code = detail.code;
+  return typeof code === "string" && code.length > 0 ? code : null;
+}
 function readRetryableCommandRejection(error) {
   const payload = statewireRejectionPayload(error);
   return payload === null ? null : readRetryableDetail(payload.detail);
@@ -101,12 +121,15 @@ function unknownConnectionStatus(connection) {
     )}`
   );
 }
+exports.COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = COLLAB_AGENT_CHANNEL_SESSION_MISMATCH;
 exports.isLegacyThreadReadOnlyRejection = isLegacyThreadReadOnlyRejection;
 exports.isStatewireChannelTeardown = isStatewireChannelTeardown;
 exports.isStatewireExpiredVerdict = isStatewireExpiredVerdict;
 exports.projectDeepAgentConnection = projectDeepAgentConnection;
 exports.readRetryableCommandRejection = readRetryableCommandRejection;
 exports.readRetryableRunRefusal = readRetryableRunRefusal;
+exports.readRunStartRefusal = readRunStartRefusal;
+exports.statewireRejectionCode = statewireRejectionCode;
 exports.statewireRejectionDetailMessage = statewireRejectionDetailMessage;
 exports.statewireRejectionPayload = statewireRejectionPayload;
 exports.statewireTransportOutcome = statewireTransportOutcome;

package/dist/agent-runtime/src/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sources":["../../../../agent-runtime/src/errors.ts"],"sourcesContent":["import type { StatewireClient } from 'statewire';\nimport type { DeepAgentConnectionState } from './types';\n\n/** Structured payload attached to a server-rejected Statewire command. */\nexport interface StatewireRejectionPayload {\n  status: number;\n  detail: unknown;\n}\n\n/** Return a rejected command's structured `{ status, detail }` payload. */\nexport function statewireRejectionPayload(error: unknown): StatewireRejectionPayload | null {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null)?.failure;\n  if (failure?.fate !== 'rejected') return null;\n\n  const payload = failure.payload as { status?: unknown; detail?: unknown } | undefined;\n  if (typeof payload?.status !== 'number') return null;\n  return { status: payload.status, detail: payload.detail };\n}\n\n/**\n * The server's human-readable reason for a rejected command — `detail.message`\n * (or a plain-string `detail`) — else `null`. Hosts surface it as send\n * feedback so the user sees the actionable cause instead of the generic\n * client-side `command rejected (<status>)`.\n */\nexport function statewireRejectionDetailMessage(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (typeof detail === 'string') return detail.length > 0 ? detail : null;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const message = (detail as { message?: unknown }).message;\n  return typeof message === 'string' && message.length > 0 ? message : null;\n}\n\n/**\n * A structured, retryable refusal the host recorded as the run error\n * (`runs.error`): the dispatch never started — the pod or instance was\n * closing (`pod_draining`) — and the entries stayed in their lanes for the\n * thread's next placement. Distinct from a rejected COMMAND\n * ({@link statewireRejectionPayload}): this is the shape harness-sdk writes\n * when the run executor raises the rejection, so it lives on the replicated\n * run entry, not on a command settle.\n */\nexport interface RetryableRunRefusal {\n  /** The structured `detail.code` (`pod_draining`). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\n/** The `{ code, message, retryable: true }` detail of a structured refusal, or `null`. */\nfunction readRetryableDetail(detail: unknown): { code: string; message: string | null } | null {\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable !== true || typeof code !== 'string' || code.length === 0) return null;\n  return { code, message: typeof message === 'string' && message.length > 0 ? message : null };\n}\n\nexport function readRetryableRunRefusal(error: unknown): RetryableRunRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  return readRetryableDetail((error as { detail?: unknown }).detail);\n}\n\n/**\n * The `detail.code` agora answers when a send names another channel of the\n * collab agent a session started on (`collab_agent_bridge.py`): a session\n * keeps its channel — the SDK app's Agent / Ask mode — for its lifetime, and\n * the way to the other mode is a new session. Wire-frozen.\n */\nexport const COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = 'collab_agent_channel_session_mismatch';\n\n/**\n * A structured refusal the host recorded as the run error when the run could\n * not START: the run executor raised the gate's `{status, detail: {code,\n * message}}` envelope (agora's `_status_reject`) before it accepted the\n * dispatched input, so the message went back to its lane and the thread rests\n * `error` with it still queued. Unlike a retryable refusal\n * ({@link readRetryableRunRefusal}) nothing will dispatch it later: resending\n * the same input is refused the same way, so the server's message is the only\n * explanation the person gets.\n */\nexport interface RunStartRefusal {\n  /** The structured `detail.code` (`collab_agent_channel_session_mismatch`, …). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n  /** The HTTP-style status the gate raised with, when recorded. */\n  status: number | null;\n}\n\n/**\n * The non-retryable structured refusal off a replicated run error\n * (`runs.error`), or `null` — for a run that failed while it was running (a\n * plain `{message}`), a retryable refusal, or no error at all.\n */\nexport function readRunStartRefusal(error: unknown): RunStartRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  const { detail, status } = error as { detail?: unknown; status?: unknown };\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable === true || typeof code !== 'string' || code.length === 0) return null;\n  return {\n    code,\n    message: typeof message === 'string' && message.length > 0 ? message : null,\n    status: typeof status === 'number' ? status : null,\n  };\n}\n\n/** The structured `detail.code` of a rejected command, or `null`. */\nexport function statewireRejectionCode(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const code = (detail as { code?: unknown }).code;\n  return typeof code === 'string' && code.length > 0 ? code : null;\n}\n\n/**\n * A structured, retryable refusal of a COMMAND, read off its rejection\n * ({@link statewireRejectionPayload}): the host's `_structured_reject(...,\n * retryable=True)` envelope — `command_auth_context_expired` when a pod\n * replacement dropped the socket-scoped auth a replayed command needed,\n * `pod_draining` when the host was closing. The command never ran, and the\n * host itself says a resend after the reconnect will; `detail.code` is the\n * wire-frozen contract clients classify on. Same shape as\n * {@link readRetryableRunRefusal}, which reads it off a replicated run entry.\n */\nexport interface RetryableCommandRejection {\n  /** The structured `detail.code`. */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\nexport function readRetryableCommandRejection(error: unknown): RetryableCommandRejection | null {\n  const payload = statewireRejectionPayload(error);\n  return payload === null ? null : readRetryableDetail(payload.detail);\n}\n\n/** The host's `detail.code` for a command replayed onto a pod that could not restore its auth context. */\nexport const STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED = 'command_auth_context_expired';\n\n/**\n * Whether a rejected command hit the host's fail-closed auth recovery: the\n * command was replayed onto a replacement pod that could not restore the\n * attach's auth context, so it was refused unrun (503, retryable). The\n * reconnect already under way restores the context; a single resend after it\n * is the recovery, not a failure to report.\n */\nexport function isStatewireCommandAuthContextExpired(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  return (\n    payload?.status === 503 &&\n    readRetryableDetail(payload.detail)?.code === STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED\n  );\n}\n\n/**\n * Whether a rejected command hit the legacy-thread dispatch fence: the\n * structured 409 the server answers when an out-of-band run is writing a\n * pre-cutover thread (or its adoption failed). A per-send failure — the\n * snapshot never carries a standing read-only flag.\n */\nexport function isLegacyThreadReadOnlyRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 409) return false;\n\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'legacy_thread_read_only';\n}\n\n/**\n * Whether a rejected command was refused because its rewind anchor no longer\n * matches the host's parent for the edited message (`wrong-anchor`).\n *\n * A retry/edit resubmit is dispatched optimistically, so this rejection lands\n * after the UI already cleared its edit affordances: the turn simply never\n * re-runs. Callers use this to tell the user the resubmit was dropped instead\n * of leaving a console-only failure.\n */\nexport function isStatewireRewindAnchorRejection(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null | undefined)\n    ?.failure;\n  if (failure?.fate !== 'rejected') return false;\n  return (failure.payload as { reason?: unknown } | undefined)?.reason === 'wrong-anchor';\n}\n\n/**\n * Whether a statewire send failure is the host's `expired` verdict\n * (`result-unavailable`): the command's seq was at or below the host's\n * admitted watermark and no retained result was left for it. Either the\n * command ran and settled but the client re-asked for the answer (a resend\n * after the stream came back) only after the host had let the retained result\n * go, or the seq was already admitted and the command was absorbed as a\n * duplicate without ever running — a client whose shared session record fell\n * behind the watermark stays there until a reconnect re-syncs it. The library\n * never reruns the command on replay, so for an idempotent read the answer is\n * simply gone — asking again is the correct reaction, not reporting a failure;\n * a write cannot assume it was applied.\n */\nexport function isStatewireExpiredVerdict(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; cause?: unknown } | null | undefined })\n    ?.failure;\n  return failure?.fate === 'expired' && failure.cause === 'server';\n}\n\n/**\n * Whether a statewire send failure is a local channel death rather than a\n * command error.\n *\n * The library's contract for `SendFailure.cause`: `\"server\"` is the server's\n * own answer; every other cause is \"a channel death the client settled\n * locally\" — `unmount`, `stream-gone`, and `session-lost`. A thread switch\n * settles every in-flight command that way, so logging these at error level\n * reports two failures for an ordinary switch and buries the ones that mean\n * something.\n *\n * Channel health is already surfaced where it belongs: the connection\n * indicator renders the connection state. This\n * predicate only decides the log level.\n */\nexport function isStatewireChannelTeardown(error: unknown): boolean {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  return typeof cause === 'string' && cause !== 'server';\n}\n\n/**\n * The low-cardinality reason a statewire send settled as transport weather\n * rather than a defect, or `null` when the failure is a real error.\n *\n * Three families qualify: a channel death the client settled locally\n * ({@link isStatewireChannelTeardown} — the cause: `unmount`, `stream-gone`,\n * `session-lost`), the host's `expired` verdict\n * ({@link isStatewireExpiredVerdict} — the answer outlived the host's\n * retention before the post-reconnect resend collected it), and a retryable\n * structured rejection ({@link readRetryableCommandRejection} — its code: the\n * host asked for a resend). In every case the sender's own retry or poll is\n * the recovery and the connection indicator already shows the channel, so\n * error reporting counts the outcome instead of paging on it. Handler\n * failures, crashes, and non-retryable rejections stay `null`: those are\n * defects to page on.\n */\nexport function statewireTransportOutcome(error: unknown): string | null {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  if (typeof cause === 'string' && cause !== 'server') return cause;\n  if (isStatewireExpiredVerdict(error)) return 'expired';\n  return readRetryableCommandRejection(error)?.code ?? null;\n}\n\nconst sanitizeConnectionMessage = (message: string): string | undefined => {\n  const printable = Array.from(message, (character) => {\n    const code = character.charCodeAt(0);\n    return code < 32 || code === 127 ? ' ' : character;\n  })\n    .join('')\n    .replace(/\\s+/g, ' ')\n    .trim();\n  return printable ? printable.slice(0, 200) : undefined;\n};\n\n/** Preserve the Statewire lifecycle and sanitize host detail for display. */\nexport function projectDeepAgentConnection(\n  connection: StatewireClient.ConnectionState\n): DeepAgentConnectionState {\n  const message =\n    'message' in connection && typeof connection.message === 'string'\n      ? sanitizeConnectionMessage(connection.message)\n      : undefined;\n  switch (connection.status) {\n    case 'standby':\n      return {\n        status: connection.status,\n        reason: connection.reason,\n        degraded: connection.degraded,\n        ...(message !== undefined && { message }),\n      };\n    case 'connecting':\n    case 'connected':\n      return { status: connection.status, degraded: connection.degraded };\n    case 'retrying':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        attempt: connection.attempt,\n        ...(connection.cause !== undefined && { cause: connection.cause }),\n        ...(connection.code !== undefined && { code: connection.code }),\n        ...(connection.nextRetryAt !== undefined && { nextRetryAt: connection.nextRetryAt }),\n        ...(connection.lastError !== undefined && { lastError: connection.lastError }),\n        ...(message !== undefined && { message }),\n      };\n    case 'stopped':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        reason: connection.reason,\n        ...(connection.payload !== undefined && { payload: connection.payload }),\n        ...(message !== undefined && { message }),\n      };\n    default:\n      return unknownConnectionStatus(connection);\n  }\n}\n\n/** Compile-time exhaustiveness: reachable only when the library grows a status this build does not project. */\nfunction unknownConnectionStatus(connection: never): never {\n  throw new Error(\n    `statewire: unknown connection status ${JSON.stringify(\n      (connection as { status?: unknown }).status\n    )}`\n  );\n}\n"],"names":[],"mappings":"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"}