@athenaintel/react 0.48.0 → 0.50.0

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

@@ -1 +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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"}
+{"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  /**\n   * The collab agent (`asset_<uuid>`) whose home this list's app is (REST\n   * thread list only today, sent as `home_agent_id`). When the agent has a home\n   * app set and the viewer can open the agent, the server widens the app scope\n   * (`appId` / `appIds`) to every conversation with the agent too; every other\n   * filter still applies. The page says whether it did\n   * ({@link ConversationListPage.homeAgentApplied}); an older server ignores\n   * the field and lists the app scope alone.\n   */\n  homeAgentId?: 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   * Whether the server widened this page to the conversations with the\n   * filter's `homeAgentId` agent (REST `home_agent_applied`). Absent (an older\n   * server, another transport, or no `homeAgentId`) means it did not.\n   */\n  homeAgentApplied?: boolean;\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.homeAgentId) normalized.homeAgentId = filter.homeAgentId;\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    // A transport that does not carry the agent (`undefined`) and a push that\n    // says the session has none (`null`) agree.\n    (a.collabAgentId ?? null) === (b.collabAgentId ?? null) &&\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. The collab agent\n * (`collab_agent_id`) is taken the same way. Pull-request state, the last wake\n * and `createdByMe` are never pushed and always keep the fetched 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:\n      entry.collab_agent_id !== undefined ? entry.collab_agent_id : 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/agent-runtime/src/conversation-list.d.ts

@@ -160,6 +160,16 @@ export interface ConversationListFilter {
      * list only today). A host lists an earlier app's sessions beside its own.
      */
     appIds?: readonly string[];
+    /**
+     * The collab agent (`asset_<uuid>`) whose home this list's app is (REST
+     * thread list only today, sent as `home_agent_id`). When the agent has a home
+     * app set and the viewer can open the agent, the server widens the app scope
+     * (`appId` / `appIds`) to every conversation with the agent too; every other
+     * filter still applies. The page says whether it did
+     * ({@link ConversationListPage.homeAgentApplied}); an older server ignores
+     * the field and lists the app scope alone.
+     */
+    homeAgentId?: string;
     /** Asset types to include (e.g. ['session']); unset = all session types. */
     assetTypes?: readonly string[];
     /** Case-insensitive title search. */
@@ -194,6 +204,12 @@ export interface ConversationListPage {
     hasMore: boolean;
     /** Total matching rows, or null when the transport does not count. */
     totalCount: number | null;
+    /**
+     * Whether the server widened this page to the conversations with the
+     * filter's `homeAgentId` agent (REST `home_agent_applied`). Absent (an older
+     * server, another transport, or no `homeAgentId`) means it did not.
+     */
+    homeAgentApplied?: boolean;
 }
 export interface ConversationListFetchParams {
     limit: number;
@@ -315,9 +331,9 @@ export declare function removeConversationFromListCaches(queryClient: QueryClien
  * Attention fields (`attention`, `next_action`, `attention_source`,
  * `is_favorited`) are taken from the entry when the publishing pod reports
  * them, so a live push flips a row to "needs you" the way it renames it; a
- * pod that predates them leaves the row's previous values. Pull-request state,
- * the last wake and `createdByMe` are never pushed and always keep the fetched
- * value.
+ * pod that predates them leaves the row's previous values. The collab agent
+ * (`collab_agent_id`) is taken the same way. Pull-request state, the last wake
+ * and `createdByMe` are never pushed and always keep the fetched value.
  */
 export declare function summaryFromConversationIndexEntry(entry: ConversationIndexEntry, previous?: ConversationSummary): ConversationSummary;
 /**

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

@@ -14,6 +14,7 @@ function normalizeConversationListFilter(filter) {
   if (filter.appIds && filter.appIds.length > 0) {
     normalized.appIds = [...new Set(filter.appIds)].sort();
   }
+  if (filter.homeAgentId) normalized.homeAgentId = filter.homeAgentId;
   if (filter.assetTypes && filter.assetTypes.length > 0) {
     normalized.assetTypes = [...filter.assetTypes].sort();
   }
@@ -147,7 +148,7 @@ 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,
+    collabAgentId: entry.collab_agent_id !== void 0 ? entry.collab_agent_id : 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,

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

@@ -1 +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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"}
+{"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  /**\n   * The collab agent (`asset_<uuid>`) whose home this list's app is (REST\n   * thread list only today, sent as `home_agent_id`). When the agent has a home\n   * app set and the viewer can open the agent, the server widens the app scope\n   * (`appId` / `appIds`) to every conversation with the agent too; every other\n   * filter still applies. The page says whether it did\n   * ({@link ConversationListPage.homeAgentApplied}); an older server ignores\n   * the field and lists the app scope alone.\n   */\n  homeAgentId?: 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   * Whether the server widened this page to the conversations with the\n   * filter's `homeAgentId` agent (REST `home_agent_applied`). Absent (an older\n   * server, another transport, or no `homeAgentId`) means it did not.\n   */\n  homeAgentApplied?: boolean;\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.homeAgentId) normalized.homeAgentId = filter.homeAgentId;\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    // A transport that does not carry the agent (`undefined`) and a push that\n    // says the session has none (`null`) agree.\n    (a.collabAgentId ?? null) === (b.collabAgentId ?? null) &&\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. The collab agent\n * (`collab_agent_id`) is taken the same way. Pull-request state, the last wake\n * and `createdByMe` are never pushed and always keep the fetched 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:\n      entry.collab_agent_id !== undefined ? entry.collab_agent_id : 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/agent-runtime/src/index.d.ts

@@ -11,7 +11,7 @@ export { type ConversationListController, useConversationList, type UseConversat
 export { CLIENT_TOOL_RESULT_STATUS_ERROR, CLIENT_TOOL_RESULT_STATUS_SUCCESS, CLIENT_TOOL_RESULT_STATUSES, type ClientToolResultEnvelopeContract, type ClientToolResultStatus, DEEP_AGENT_CONTEXT_PROTOCOL, DEEP_AGENT_CUT_LANE_DOCUMENT, DEEP_AGENT_DEFAULT_MESSAGE_WINDOW, DEEP_AGENT_FOLLOW_TOOL_CALL_ID_KEY, DEEP_AGENT_INTEREST_PROTOCOL, DEEP_AGENT_LANE_CUT_PROTOCOL_VERSION, DEEP_AGENT_LANE_FOLLOW_PROTOCOL_VERSION, DEEP_AGENT_MAIN_NS, DEEP_AGENT_MAX_FOLLOWED_STEPS, DEEP_AGENT_MAX_LANE_PAGE, DEEP_AGENT_HISTORY_IMAGE_COMMAND, DEEP_AGENT_HISTORY_LANE_COMMAND, DEEP_AGENT_HISTORY_LANE_IMAGE_COMMAND, DEEP_AGENT_HISTORY_LANE_PAGE_CHARS, DEEP_AGENT_HISTORY_MESSAGE_COMMAND, DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND, DEEP_AGENT_INLINE_IMAGE_WIRE_BUDGET, DEEP_AGENT_MAX_INTERESTS, DEEP_AGENT_MAX_MESSAGE_WINDOW, DEEP_AGENT_MESSAGE_WINDOW_HEADER, DEEP_AGENT_MIN_MESSAGE_WINDOW, DEEP_AGENT_OMITTED_IMAGE_KEY, DEEP_AGENT_OMITTED_IMAGE_PLACEHOLDER_URL, DEEP_AGENT_PROTOCOL_STATE_KEY, DEEP_AGENT_PROTOCOL_VERSION, DEEP_AGENT_PROTOCOL_VERSION_HEADER, DEEP_AGENT_REPEATS_RESULT_KEY, DEEP_AGENT_RUNNING_LANE_WIRE_MESSAGES, DEEP_AGENT_RUNTIME_MARKER, DEEP_AGENT_TRUNCATED_CONTENT_KEY, DEEP_AGENT_TRUNCATED_LANE_KEY, KNOWN_START_CHANNEL_SET, KNOWN_START_CHANNELS, type KnownStartChannel, RUN_CONFIG_COMPANION_CUSTOM_KEYS, RUN_CONFIG_CUSTOM_KEY_SET, RUN_CONFIG_CUSTOM_KEYS, RUN_CONFIG_PARSED_CUSTOM_KEYS, RUN_CONFIG_PER_SEND_CUSTOM_KEY_SET, RUN_CONFIG_PER_SEND_CUSTOM_KEYS, type RunConfigCustomKey, type RunConfigPerSendCustomKey, DEEP_AGENT_CONFIG_COMMANDS, DEEP_AGENT_CONFIG_STATE_KEY, THREAD_CONFIG_CUSTOM_KEY_SET, THREAD_CONFIG_CUSTOM_KEYS, type ThreadConfigCustomKey, } from "./generated/runconfig-contract";
 export { COLLAB_AGENT_CHANNEL_SESSION_MISMATCH, CONVERSATION_ARCHIVED, CONVERSATION_ARCHIVED_MESSAGE, isConversationArchivedRejection, isLegacyThreadReadOnlyRejection, isStatewireChannelTeardown, isStatewireCommandAuthContextExpired, isStatewireExpiredVerdict, isStatewireRewindAnchorRejection, projectDeepAgentConnection, readRetryableCommandRejection, readRetryableRunRefusal, readRunStartRefusal, type RetryableCommandRejection, type RetryableRunRefusal, type RunStartRefusal, STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED, statewireRejectionCode, isVoiceCommandRejection, statewireRejectionDetailMessage, statewireRejectionPayload, type StatewireRejectionPayload, statewireTransportOutcome, } from "./errors";
 export { type ParsedExecuteOutput, parseExecuteOutput, type ShellCommandSummary, summarizeShellCommand, } from "./execute-output";
-export { type AbandonedInputRequest, type ApprovalResumeLock, asHitlApproval, canApproveForSession, DEFAULT_INTERRUPT_PAUSED_MESSAGE, fanLaneDecision, findAbandonedInterrupt, HITL_PENDING_RESUME_GRACE_MS, HITL_REJECT_REASON, HITL_RESUME_TRANSPORT_RETRIES, type HitlActionDecision, type HitlApprovalPayload, actionRequestToolCallIds, hitlResumeActionDecisions, hitlResumeApprove, hitlResumeApproveForSession, INTERRUPT_DECLINE_REASON, interruptMirrorPayload, interruptResumeDecline, hitlResumeReject, isApprovalCardInterrupt, isPendingInterrupt, isResumeTransportLoss, isSystemPauseInterrupt, laneInterruptIds, type PendingActionRequest, type PendingApprovalContext, type PendingApprovalFact, type PendingApprovalWarning, parsePendingApprovalContext, pendingActionRequests, readAbandonedInputRequests, readInterruptMessage, readInterruptMirror, readQueuedLaneDecisions, type ResumeExtras, resumeValueApproves, toolCallIdsAwaitingApproval, useApprovalResumeLock, type UseApprovalResumeLockOptions, } from "./interrupts";
+export { type AbandonedInputRequest, type ApprovalResumeLock, asHitlApproval, canApproveForSession, DEFAULT_INTERRUPT_PAUSED_MESSAGE, fanLaneDecision, findAbandonedInterrupt, HITL_PENDING_RESUME_GRACE_MS, HITL_REJECT_REASON, HITL_RESUME_TRANSPORT_RETRIES, type HitlActionDecision, type HitlApprovalPayload, actionRequestToolCallIds, hitlResumeActionDecisions, hitlResumeApprove, hitlResumeApproveForSession, INTERRUPT_DECLINE_REASON, interruptMirrorPayload, interruptResumeDecline, hitlResumeReject, isApprovalCardInterrupt, isPendingInterrupt, isResumeTransportLoss, isSystemPauseInterrupt, laneInterruptIds, type PendingActionRequest, type PendingApprovalContext, type PendingApprovalFact, type PendingApprovalTitle, type PendingApprovalWarning, parsePendingApprovalContext, pendingActionRequests, pendingApprovalTitle, readAbandonedInputRequests, readInterruptMessage, readInterruptMirror, readQueuedLaneDecisions, type ResumeExtras, resumeValueApproves, toolCallIdsAwaitingApproval, useApprovalResumeLock, type UseApprovalResumeLockOptions, } from "./interrupts";
 export { type AgoraFetch, bareDecisionThreadId, type BrowserDecisionCheckOutcome, DECISION_CHECK_HEADER, type DecisionCheckClient, type DecisionCheckClientKind, type DecisionCheckDescriptor, DecisionCheckKind, MAX_DECISIONS_PER_CHECK, type PendingBrowserDecisionCheck, respondDecisionDescriptor, type RunBrowserDecisionCheckOptions, runBrowserDecisionCheck, type StatewireAnswerForCheck, statewireAnswerDescriptors, } from "./decision-checks";
 export { buildQueueEditCommand, buildStatewireQueueRows, describeQueueSendFailure, isFailedSendEntryRace, isQueueEntryUnsettled, QUEUE_AUTO_CONTINUE_DELAY_MS, type QueueEditCommand, queueEntryText, queueLaneFlags, type QueueLaneFlags, readPrioritizedQueueIds, showQueueRowSendNow, showQueueRowSteer, type StatewireQueueRow, userStopBlocksQueueAutoContinue, } from "./queue";
 export { createDeepAgentSendRecovery, type DeepAgentSendRecovery, type DeepAgentSendRecoveryOptions, shouldAutoRetryFailedSend, } from "./send-recovery";
@@ -48,7 +48,7 @@ export { DEEP_AGENT_PRE_STREAM_STATE, isDeepAgentStateHydrated, pairDeepAgentSta
 export { StatewireSuspended, type SuspendedStatewireOptions, } from "./statewire-suspended";
 export { createDeepAgentThreadSnapshotCache, type CreatedDeepAgentThreadSnapshotCache, type DeepAgentThreadSnapshotCache, type DeepAgentThreadSnapshotCacheChange, type DeepAgentThreadSnapshotCacheOptions, toThreadSnapshotSeed, } from "./thread-snapshot-cache";
 export { classifyThreadSnapshotForMirror, createThreadSnapshotMirror, MAX_MIRRORED_SNAPSHOT_MESSAGES, MAX_MIRRORED_SNAPSHOTS_PER_OWNER, type MirroredList, type MirroredThreadSnapshot, SNAPSHOT_MIRROR_DEBOUNCE_MS, THREAD_SNAPSHOT_MIRROR_DATABASE, type ThreadSnapshotKeyPurpose, type ThreadSnapshotMirror, type ThreadSnapshotMirrorOptions, } from "./thread-snapshot-mirror";
-export { CHAT_EDIT_KEPT_MESSAGE, CHAT_EDIT_UNREACHABLE_LABEL, CHAT_OUTBOX_ASK_AFTER_MS, CHAT_OUTBOX_ATTACHMENT_CHECK_TIMEOUT_MS, CHAT_OUTBOX_CLAIM_LEASE_MS, CHAT_OUTBOX_COUNTDOWN_MS, ChatEditUnreachableError, type ChatOutbox, type ChatOutboxCommandUpdate, type ChatOutboxElsewhere, type ChatOutboxEvent, type ChatOutboxInput, type ChatOutboxOptions, type ChatOutboxRow, type ChatOutboxRowState, type ChatOutboxSignal, type ChatOutboxSnapshot, type ChatOutboxThreadPort, type ChatOutboxThreadReadiness, chatOutboxCommandMessageId, chatOutboxFailureMessage, createChatOutbox, } from "./chat-outbox";
+export { CHAT_EDIT_KEPT_MESSAGE, CHAT_EDIT_UNREACHABLE_LABEL, CHAT_OUTBOX_ASK_AFTER_MS, CHAT_OUTBOX_ATTACHMENT_CHECK_TIMEOUT_MS, CHAT_OUTBOX_CLAIM_LEASE_MS, CHAT_OUTBOX_COUNTDOWN_MS, ChatEditUnreachableError, type ChatOutbox, type ChatOutboxCommandUpdate, type ChatOutboxElsewhere, type ChatOutboxEvent, type ChatOutboxInput, type ChatOutboxOptions, type ChatOutboxRow, type ChatOutboxRowState, type ChatOutboxSendGate, type ChatOutboxSignal, type ChatOutboxSnapshot, type ChatOutboxThreadPort, type ChatOutboxThreadReadiness, chatOutboxCommandMessageId, chatOutboxFailureMessage, createChatOutbox, } from "./chat-outbox";
 export { CHAT_OUTBOX_DATABASE, CHAT_OUTBOX_FORMAT, type ChatOutboxAttachment, type ChatOutboxClaim, type ChatOutboxClaimResult, type ChatOutboxEntry, type ChatOutboxFailure, type ChatOutboxFailureReason, type ChatOutboxFile, type ChatOutboxKeyPurpose, type ChatOutboxRecord, type ChatOutboxStore, createIndexedDbChatOutboxStore, createMemoryChatOutboxStore, type IndexedDbChatOutboxStoreOptions, parseChatOutboxEntry, readChatOutboxClaim, readChatOutboxFailure, withChatOutboxMemoryFallback, } from "./chat-outbox-store";
 export { type ChatOutboxAssetReadResponse, type ChatOutboxAttachmentCheck, type ChatOutboxAttachmentVerdict, chatOutboxAttachmentPath, createChatOutboxAttachmentCheck, } from "./chat-outbox-attachments";
 export { buildChatOutboxSendCommand, type ChatOutboxClientHost, type ChatOutboxSendCommand, type ChatOutboxWireMessage, chatOutboxHeldIds, chatOutboxReadiness, chatOutboxWireAnchorId, chatOutboxWireMessage, createStatewireChatOutboxPort, } from "./chat-outbox-thread";
@@ -65,17 +65,18 @@ export { BACK_ONLINE_MS, chatSocketCannotReach, chatSocketOutage, useBrowserOnli
 export { type DeepAgentConfigControllerInputs, type DeepAgentConfigWriteResult, type DeepAgentServerConfig, type DeepAgentServerConfigEvent, foldPendingConfigOps, isConfigSyncUnavailableRejection, isConfigWriteForbiddenRejection, readConfigVersion, readServerConfig, readThreadServerConfig, useDeepAgentConfig, useDeepAgentConfigController, type UseDeepAgentConfigOptions, type UseDeepAgentConfigResult, } from "./use-deep-agent-config";
 export { applyConfigPatch, applyToolsDisable, applyToolsEnable, diffThreadConfig, pickPerSendCustom, pickThreadConfigCustom, readDeclinedToolkitIds, readEnabledTools, type ThreadConfigCustom, type ThreadConfigPatch, } from "./config-mutations";
 export { DEEP_AGENT_CONNECTION_STATUSES, type DeepAgentConnectionState, type DeepAgentConnectionStatus, type DeepAgentLaneProjection, type DeepAgentStreamValues, type LangGraphState, type PtcSubagentEntry, type Todo, } from "./types";
-export { classifyVoiceStartError, type DeepAgentVoiceDiagnostic, type DeepAgentVoiceDiagnosticEvent, type DeepAgentVoiceFailure, type DeepAgentVoiceFailureKind, type DeepAgentVoiceFailureStage, type DeepAgentVoiceLiveKitAdapter, type DeepAgentVoiceLiveKitAnswer, type DeepAgentVoiceLiveKitSession, type DeepAgentVoiceModelOption, type DeepAgentVoiceOpening, type DeepAgentVoiceOwnerWireState, type DeepAgentVoicePhase, type DeepAgentVoiceRemoteStream, type DeepAgentVoiceStartOptions, type DeepAgentVoiceSurface, type DeepAgentVoiceToolCall, type DeepAgentVoiceTransferWireState, type DeepAgentVoiceTransport, type DeepAgentVoiceWireState, describeVoiceFailure, describeVoiceLiveElsewhere, describeVoiceMovedTo, describeVoiceWireError, float32FromPcm16, formatVoiceElapsed, parseVoiceLiveKitAnswer, parseVoiceModelOptions, parseVoiceOwner, pcm16FromFloat32, useDeepAgentVoice, useVoiceElapsed, useVoiceMovedNotice, type UseDeepAgentVoiceOptions, type UseDeepAgentVoiceReturn, VOICE_LIVEKIT_ANSWER_PREFIX, VOICE_CONTINUE_BY_VOICE_LABEL, VOICE_LIVEKIT_OFFER, VOICE_MOVE_CALL_HERE_LABEL, VOICE_MOVE_HERE_ACTION, VOICE_MOVED_NOTICE_MS, VOICE_RELAY_ANSWER_PREFIX, VOICE_RELAY_SAMPLE_RATE, VOICE_WEBSOCKET_OFFER, voiceRelayUrl, voiceSurfaceLabel, } from "./use-deep-agent-voice";
+export { classifyVoiceStartError, type DeepAgentVoiceDiagnostic, type DeepAgentVoiceDiagnosticEvent, type DeepAgentVoiceFailure, type DeepAgentVoiceFailureKind, type DeepAgentVoiceFailureStage, type DeepAgentVoiceLiveKitAdapter, type DeepAgentVoiceCallMove, type DeepAgentVoiceLiveKitAnswer, type DeepAgentVoiceLiveKitSession, type DeepAgentVoiceModelOption, type DeepAgentVoiceOpening, type DeepAgentVoiceOwnerWireState, type DeepAgentVoicePhase, type DeepAgentVoiceRemoteStream, type DeepAgentVoiceStartOptions, type DeepAgentVoiceSurface, type DeepAgentVoiceToolCall, type DeepAgentVoiceTransferWireState, type DeepAgentVoiceTransport, type DeepAgentVoiceWireState, describeVoiceFailure, describeVoiceLiveElsewhere, describeVoiceMovedTo, describeVoiceWireError, float32FromPcm16, formatVoiceElapsed, parseVoiceLiveKitAnswer, parseVoiceModelOptions, parseVoiceOwner, pcm16FromFloat32, playVoiceMoveEarcon, useDeepAgentVoice, useVoiceElapsed, useVoiceMovedNotice, type UseDeepAgentVoiceOptions, type UseDeepAgentVoiceReturn, VOICE_LIVEKIT_ANSWER_PREFIX, VOICE_CONTINUE_BY_VOICE_LABEL, VOICE_LIVEKIT_OFFER, VOICE_MOVE_CALL_HERE_LABEL, VOICE_MOVE_EARCON_MS, VOICE_MOVE_EARCON_PEAK, VOICE_MOVE_EARCON_SAMPLE_RATE, VOICE_MOVE_HERE_ACTION, VOICE_MOVED_NOTICE_MS, VOICE_RELAY_ANSWER_PREFIX, VOICE_RELAY_SAMPLE_RATE, VOICE_WEBSOCKET_OFFER, voiceMoveEarconDataUri, voiceMoveEarconSamples, voiceMoveEarconWav, voiceRelayUrl, voiceSurfaceLabel, } from "./use-deep-agent-voice";
 export { type DeepAgentVoiceWireError } from "./types";
 export { describeVoiceUpdateToolCall, isSpokenTurnTextPart, isVoiceDelegationMessage, VOICE_DELEGATION_ID_PREFIX, VOICE_LIVE_KEY, VOICE_LIVE_TYPED_HINT, VOICE_SOURCE_DELEGATION, VOICE_SOURCE_SPOKEN, VOICE_SOURCE_TYPED, VOICE_TURN_IDS_KEY, VOICE_UPDATE_TOOL_NAME, type VoiceMessageMarker, type VoiceProvenance, type VoiceUpdateToolCall, voiceProvenanceLabel, voiceUpdateStatusLabel, } from "./voice-presentation";
 export { groupSpokenUserTurns, isSpokenUserTurn } from "./voice-turn-grouping";
+export { CALL_RECAP_APPROVAL_LABEL, CALL_RECAP_TITLE, type CallRecap, type CallRecapApproval, type CallRecapAsset, type CallRecapItem, type CallRecapLink, type CallRecapMessage, type CallRecapOpenToolCall, type CallRecapPart, callRecapAfter, callRecapHasItems, callRecapItems, isCallUserMessage, mayHaveLiveCall, VOICE_TYPED_ID_PREFIX, } from "./call-recap";
 export { canPersistDeepAgentSession, type DeepAgentPendingSession, type DeepAgentRunConfigRegistration, type DeepAgentSessionPersistence, type DeepAgentThreadElement, type DeepAgentThreadStateClientHost, logUnhandledStatewireError, useDeepAgentRuntime, type UseDeepAgentRuntimeOptions, } from "./use-deep-agent-runtime";
 export { type DeepAgentAttachSource, type DeepAgentHeadersResolver, readSessionPersisted, type RunningSnapshot, shouldNotifyRunningChange, useDeepAgentThread, type UseDeepAgentThreadOptions, } from "./use-deep-agent-thread";
 export { GITHUB_EVENT_SOURCE_KEY, type GithubWakeEvent, githubWakeEventLabel, githubWakeEventUrl, githubWakeMarkerText, githubWakeReference, isGithubWakeMessage, readGithubWakeEvent, } from "./github-wake-event";
 export { githubSubscriptionHeadline, isSubscriptionWakeMessage, readSubscriptionWakeEvent, SUBSCRIPTION_EVENT_KEY, type SubscriptionWakeChange, type SubscriptionWakeEvent, type SubscriptionWakeGithub, subscriptionPlaceWords, subscriptionWakeDetail, subscriptionWakeGithub, subscriptionWakeHeadline, } from "./subscription-wake-event";
 export { describeTerminationReason, readRuntimeMessageFromSourceMessages, readSoleRuntimeMessageKind, readTerminationReason, runtimeMessageMarkerText, TERMINATION_REASONS, type AthenaRuntimeMessage, type AthenaRuntimeMessageKind, type AthenaRuntimeMessageSeverity, type AthenaTerminationReason, type TerminationDescription, } from "./runtime-messages";
-export { buildHandoffQrSvg, buildMobileHandoffSchemeUrl, classifyHandoffTransportError, type CreateThreadHandoffInput, type CreateThreadHandoffResponse, createThreadHandoffResponseSchema, describeHandoffTransportError, type DestinationReadiness, HANDOFF_DESTINATION_LABELS, HANDOFF_DESTINATIONS, HANDOFF_URL_PARAM, type HandoffDestination, type HandoffDestinationPresentation, type HandoffEnvironment, HandoffGoneError, type HandoffLaunch, type HandoffOutcome, HandoffPermanentError, type HandoffReadinessResponse, type HandoffReadinessState, type HandoffSource, type HandoffState, type HandoffTransportErrorKind, handoffHttpError, handoffReadinessResponseSchema, handoffStateSchema, isHandoffGoneError, isHandoffPermanentError, isRetryableHandoffHttpStatus, isOfficeHandoffDestination, isServerHandoffDestination, isTerminalHandoffState, type MobileHandoffLaunch, type MobileLaunchMode, mobileHandoffLaunchSchema, OFFICE_HANDOFF_DESTINATIONS, type OfficeHandoffDestination, type OfficeHandoffLaunch, officeHandoffLaunchSchema, type OfficeInvitationLaunch, officeInvitationLaunchSchema, type OfficeLaunchMode, officeLaunchModeSchema, threadHandoffCreateBody, parseHandoffIdParam, presentHandoffDestination, readinessByDestination, SERVER_HANDOFF_DESTINATIONS, type ServerHandoffDestination, selectMobileLaunchMode, supportsDesktopHandoffSource, type ThreadHandoffTransport, type ThreadHandoffView, threadHandoffViewSchema, waitForHandoffOutcome, type WaitForHandoffOutcomeOptions, type ClaimThreadHandoffResponse, claimThreadHandoffResponseSchema, clampHandoffDraft, continuedFromLabel, pickUpFromLabel, pickUpOfferLabel, type DesktopThreadHandoffLaunch, desktopThreadHandoffLaunchSchema, driverSurfaceForChannel, drivingOnLabel, type HandoffLanding, handoffLandingFromView, isPickupSurface, MAX_HANDOFF_DRAFT_LENGTH, nextHandoffLaunchSchema, parseThreadHandoffCreateResponse, pendingThreadHandoffResponseSchema, pickedUpOnLabel, PICKUP_SURFACES, type PickupSurface, shouldOfferPendingHandoff, SPACES_HANDOFF_URL_PARAM, type SpacesHandoffLaunch, spacesHandoffLaunchSchema, SURFACE_HANDOFF_DESTINATIONS, type SurfaceHandoffDestination, supportsSurfaceHandoffDestinations, THREAD_HANDOFF_DESTINATION_LABELS, THREAD_HANDOFF_DESTINATIONS, threadHandoffClaimBody, threadHandoffCreateRequest, type ThreadHandoffDestination, type ThreadHandoffReceiverTransport, MAX_PENDING_EXCLUDE, pendingExcludeIds, pickupExcludeIds, pendingHandoffPath, type HandoffMode, handoffModeSchema, isVoiceHandoffDestination, } from "./thread-handoff";
+export { buildHandoffQrSvg, buildMobileHandoffSchemeUrl, classifyHandoffTransportError, type CreateThreadHandoffInput, type CreateThreadHandoffResponse, createThreadHandoffResponseSchema, describeHandoffTransportError, type DestinationReadiness, HANDOFF_DESTINATION_LABELS, HANDOFF_DESTINATIONS, HANDOFF_URL_PARAM, type HandoffDestination, type HandoffDestinationPresentation, type HandoffEnvironment, HandoffGoneError, type HandoffLaunch, type HandoffOutcome, HandoffPermanentError, type HandoffReadinessResponse, type HandoffReadinessState, type HandoffSource, type HandoffState, type HandoffTransportErrorKind, handoffHttpError, handoffReadinessResponseSchema, handoffStateSchema, isHandoffGoneError, isHandoffPermanentError, isRetryableHandoffHttpStatus, isOfficeHandoffDestination, isServerHandoffDestination, isTerminalHandoffState, type MobileHandoffLaunch, type MobileLaunchMode, mobileHandoffLaunchSchema, OFFICE_HANDOFF_DESTINATIONS, type OfficeHandoffDestination, type OfficeHandoffLaunch, officeHandoffLaunchSchema, type OfficeInvitationLaunch, officeInvitationLaunchSchema, type OfficeLaunchMode, officeLaunchModeSchema, threadHandoffCreateBody, parseHandoffIdParam, presentHandoffDestination, readinessByDestination, SERVER_HANDOFF_DESTINATIONS, type ServerHandoffDestination, selectMobileLaunchMode, supportsDesktopHandoffSource, type ThreadHandoffTransport, type ThreadHandoffView, threadHandoffViewSchema, waitForHandoffOutcome, type WaitForHandoffOutcomeOptions, type ClaimThreadHandoffResponse, claimThreadHandoffResponseSchema, clampHandoffDraft, handoffDraftToCarry, continuedFromLabel, pickUpFromLabel, pickUpOfferLabel, type DesktopThreadHandoffLaunch, desktopThreadHandoffLaunchSchema, driverSurfaceForChannel, drivingOnLabel, type HandoffLanding, handoffLandingFromView, isPickupSurface, MAX_HANDOFF_DRAFT_LENGTH, nextHandoffLaunchSchema, parseThreadHandoffCreateResponse, pendingThreadHandoffResponseSchema, pickedUpOnLabel, PICKUP_SURFACES, type PickupSurface, shouldOfferPendingHandoff, SPACES_HANDOFF_URL_PARAM, type SpacesHandoffLaunch, spacesHandoffLaunchSchema, SURFACE_HANDOFF_DESTINATIONS, type SurfaceHandoffDestination, supportsSurfaceHandoffDestinations, THREAD_HANDOFF_DESTINATION_LABELS, THREAD_HANDOFF_DESTINATIONS, threadHandoffClaimBody, threadHandoffCreateRequest, type ThreadHandoffDestination, type ThreadHandoffReceiverTransport, MAX_PENDING_EXCLUDE, pendingExcludeIds, pickupExcludeIds, pendingHandoffPath, type HandoffMode, handoffModeSchema, isVoiceHandoffDestination, livenessAgo, presentSurfaceLiveness, type SurfaceLiveness, type SurfaceLivenessBasis, surfaceLivenessBasisSchema, surfaceLivenessBySurface, type SurfaceLivenessPresentation, surfaceLivenessSchema, type SurfaceLivenessState, surfaceLivenessStateSchema, type SurfaceLivenessTone, supportsSurfaceLiveness, } from "./thread-handoff";
 export { DEFAULT_MOBILE_HANDOFF_TIMEOUT_MS, DEFAULT_OFFICE_HANDOFF_TIMEOUT_MS, DEFAULT_PICKUP_HANDOFF_TIMEOUT_MS, type StartThreadHandoffInput, type ThreadHandoffFlowCallbacks, type ThreadHandoffFlowController, type ThreadHandoffFlowPhase, useThreadHandoffFlow, type UseThreadHandoffFlowOptions, } from "./use-thread-handoff-flow";
 export { anchorHandoffArrival, clearHandoffArrival, type HandoffArrival, HandoffArrivalContext, MAX_HANDOFF_ARRIVALS, readHandoffArrival, recordHandoffArrival, resetHandoffArrivalsForTests, subscribeHandoffArrivals, useHandoffArrival, useHandoffArrivalAfter, } from "./handoff-arrival";
 export { connectVoiceMedia, VOICE_MICROPHONE_CAPTURE } from './voice-media';
-export type { VoiceMediaDriver, VoiceMediaHandlers, VoiceMediaSession } from './voice-media';
+export type { VoiceMediaDriver, VoiceMediaEvent, VoiceMediaEventType, VoiceMediaHandlers, VoiceMediaSession, } from './voice-media';

package/dist/agent-runtime/src/interrupts.cjs

@@ -36,6 +36,11 @@ const APPROVAL_WARNING_SEVERITIES = /* @__PURE__ */ new Set(["info", "warning",
 function isNullableString(value) {
   return value === null || typeof value === "string";
 }
+function displayText(value) {
+  if (typeof value !== "string") return void 0;
+  const text = value.trim();
+  return text.length > 0 ? text : void 0;
+}
 function isStringArray(value) {
   return Array.isArray(value) && value.every((entry) => typeof entry === "string");
 }
@@ -65,8 +70,16 @@ function parsePendingApprovalContext(value) {
     const severity = typeof warning.severity === "string" && APPROVAL_WARNING_SEVERITIES.has(warning.severity) ? warning.severity : "info";
     return [{ severity, message: warning.message }];
   }) : [];
+  const headline = displayText(value.headline);
+  const summary = displayText(value.summary);
   const slackTarget = parsePendingApprovalSlackTarget(value.slack_target);
-  return facts.length > 0 || warnings.length > 0 || slackTarget ? { facts, warnings, ...slackTarget ? { slack_target: slackTarget } : {} } : void 0;
+  return facts.length > 0 || warnings.length > 0 || headline || summary || slackTarget ? {
+    facts,
+    warnings,
+    ...headline ? { headline } : {},
+    ...summary ? { summary } : {},
+    ...slackTarget ? { slack_target: slackTarget } : {}
+  } : void 0;
 }
 function pendingActionRequests(hitl) {
   const context = hitl == null ? void 0 : hitl.context;
@@ -85,6 +98,19 @@ function pendingActionRequests(hitl) {
     };
   });
 }
+function pendingApprovalTitle({
+  hitl,
+  actionRequests
+}) {
+  var _a, _b;
+  const [call, ...others] = actionRequests;
+  if (hitl === null || call === void 0 || others.length > 0) return void 0;
+  const pendingCount = (_a = hitl.context) == null ? void 0 : _a.pending_action_count;
+  if (pendingCount !== void 0 && pendingCount !== 1) return void 0;
+  const envelope = call.approvalContext ?? parsePendingApprovalContext((_b = hitl.context) == null ? void 0 : _b.approval_context);
+  if ((envelope == null ? void 0 : envelope.headline) === void 0) return void 0;
+  return envelope.summary === void 0 ? { headline: envelope.headline } : { headline: envelope.headline, summary: envelope.summary };
+}
 function canApproveForSession(actionRequests) {
   return actionRequests.length > 0 && actionRequests.every((request) => request.sessionApprovalAllowed === true);
 }
@@ -322,6 +348,7 @@ exports.isSystemPauseInterrupt = isSystemPauseInterrupt;
 exports.laneInterruptIds = laneInterruptIds;
 exports.parsePendingApprovalContext = parsePendingApprovalContext;
 exports.pendingActionRequests = pendingActionRequests;
+exports.pendingApprovalTitle = pendingApprovalTitle;
 exports.readAbandonedInputRequests = readAbandonedInputRequests;
 exports.readInterruptMessage = readInterruptMessage;
 exports.readInterruptMirror = readInterruptMirror;