@athenaintel/react 0.57.2 → 0.59.0

package/dist/threads/use-athena-sessions.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-athena-sessions.cjs","sources":["../../src/threads/use-athena-sessions.ts"],"sourcesContent":["/**\n * `useAthenaSessions(query)` — one filtered, sorted, live session list under\n * `<AthenaProvider enableThreadList>`: the data layer of `SessionsPage` and\n * `Inbox`, for hosts drawing their own.\n *\n * - **Server-side.** The query travels to `POST /api/conversations/threads/list`\n *   as filters of the server's one page statement (`planSessionsQuery`), over\n *   the shared two-tier pager (`useConversationList`: a live first page and\n *   frozen history pages) in the thread-list provider's query client.\n * - **Live.** Rows fold the same conversation-index pushes the sidebar folds\n *   (titles, lifecycle, attention flip in place), carry the provider's\n *   in-flight writes (pin, rename, read state, archive), and a thread the\n *   index learns about that the list does not show yet refreshes the list\n *   once.\n * - **Degraded, not wrong.** A server that cannot apply part of the query is\n *   detected from its `supported_filters` echo (one `limit: 1` probe per\n *   identity). Fields the loaded rows can be tested on are applied to them\n *   (`degradedFields`: exact per page, a page can come back short); fields\n *   they cannot are reported in `unavailableFields` and not applied, so a\n *   control for them can be disabled rather than lie.\n */\nimport {\n  type ConversationListFilter,\n  type ConversationSummary,\n  conversationListFilterKey,\n  conversationListQueryKeys,\n  useConversationList,\n} from '@athenaintel/agent-runtime';\nimport { useQuery } from '@tanstack/react-query';\nimport { useContext, useMemo, useRef } from 'react';\nimport { useAthenaQueryClient } from '../lib/use-athena-rest-query';\nimport { withCredentialRenewal } from '../runtime/credential-renewal';\nimport { listThreads } from './api';\nimport { createRestConversationListFetcher } from './conversation-list-fetcher';\nimport { useIndexTriggeredRefresh } from './index-triggered-refresh';\nimport { sessionListShareKey } from './session-list-tab-share';\nimport {\n  type AthenaSessionsQuery,\n  type AthenaSessionsQueryField,\n  matchesSessionsQuery,\n  planSessionsQuery,\n  sessionsQueryFromKey,\n  sessionsQueryKey,\n  sortSessions,\n  supportedFiltersFromResponse,\n  unavailableSessionsQueryFields,\n} from './sessions-query';\nimport {\n  AthenaSessionsLiveContext,\n  type AthenaStatewireThreadSummary,\n  foldConversationIndex,\n  indexedThreadsToRefreshFor,\n  threadSummaryFromConversation,\n} from './statewire-thread-list';\n\nexport interface UseAthenaSessionsOptions {\n  /** What to list. A new object with the same content does not refetch. */\n  query: AthenaSessionsQuery;\n  /** Rows per page (default 50). */\n  pageSize?: number;\n  /** `false` holds the list idle. Default `true`. */\n  enabled?: boolean;\n}\n\nexport interface AthenaSessionsList {\n  /** The rows, in the query's order, with live pushes and in-flight writes applied. */\n  rows: AthenaStatewireThreadSummary[];\n  /** `false` outside `enableThreadList` mode: nothing is fetched and `rows` stays empty. */\n  isAvailable: boolean;\n  /** True until the first page has answered (or while no credential has resolved). */\n  isLoading: boolean;\n  isFetching: boolean;\n  hasResolvedFirstPage: boolean;\n  /**\n   * True while the rows are the previous query's (checked against this\n   * query's local part) because this query's first page is still in flight.\n   */\n  isPlaceholderData: boolean;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  fetchNextPage: () => void;\n  /** Refetch the first page; resolves once it has answered. */\n  refresh: () => Promise<void>;\n  /** True while the last \"load more\" request failed. */\n  isFetchNextPageError: boolean;\n  /**\n   * The server fields this backend applies (`supported_filters`), `null`\n   * while unknown or on a backend that predates the list.\n   */\n  supportedFilters: ReadonlySet<string> | null;\n  /** Fields applied to the loaded rows because the backend cannot. */\n  degradedFields: AthenaSessionsQueryField[];\n  /** Fields of this query that cannot be applied on this backend at all (and are not). */\n  unavailableFields: AthenaSessionsQueryField[];\n  /**\n   * Every field this backend cannot apply anywhere, selected or not — what a\n   * filter UI disables. Empty until the capabilities probe has answered.\n   */\n  unsupportedFields: AthenaSessionsQueryField[];\n}\n\nconst DEFAULT_PAGE_SIZE = 50;\n\n/** The capabilities probe's key prefix. */\nexport const THREAD_LIST_CAPABILITIES_QUERY_KEY = [\n  'athena-sdk',\n  'thread-list-capabilities',\n] as const;\n\nconst EMPTY_ROWS: AthenaStatewireThreadSummary[] = [];\nconst EMPTY_VERSIONS: ReadonlySet<string> = new Set();\nconst NOOP = () => undefined;\nconst NOOP_ASYNC = async () => undefined;\n\nexport function useAthenaSessions({\n  query,\n  pageSize = DEFAULT_PAGE_SIZE,\n  enabled = true,\n}: UseAthenaSessionsOptions): AthenaSessionsList {\n  const live = useContext(AthenaSessionsLiveContext);\n  const isAvailable = live !== null;\n  const backendUrl = live?.backendUrl ?? '';\n  const principal = live?.principal ?? '';\n  const hasAuth = live?.hasAuth ?? false;\n  const includePullRequests = live?.includePullRequests ?? false;\n  const getAuth = live?.getAuth;\n  const active = isAvailable && enabled && hasAuth;\n  // Every cache below is keyed by WHO reads (principal) and WITH WHAT (the\n  // credential generation): a scoped credential for another workspace under\n  // the same principal must never read this one's cached rows.\n  const identityScope = `${live?.scopeKey ?? 'unavailable'}::credential-${\n    live?.credentialGeneration ?? 0\n  }`;\n\n  // Outside thread-list mode there may be no `QueryClientProvider`; every\n  // query below is disabled there, on a client of this hook's own.\n  const queryClient = useAthenaQueryClient();\n\n  // Which filters this backend applies: one tiny page per identity. The\n  // answer is a property of the deployed agora, so it never goes stale.\n  const capabilities = useQuery(\n    {\n      queryKey: [\n        ...THREAD_LIST_CAPABILITIES_QUERY_KEY,\n        backendUrl,\n        principal,\n        live?.credentialGeneration ?? 0,\n      ],\n      queryFn: async ({ signal }) => {\n        if (!getAuth) return null;\n        const response = await withCredentialRenewal(getAuth, (auth) =>\n          listThreads(backendUrl, auth, { limit: 1, signal }),\n        );\n        return supportedFiltersFromResponse(response.supported_filters);\n      },\n      enabled: active,\n      staleTime: Number.POSITIVE_INFINITY,\n      retry: 1,\n    },\n    queryClient,\n  );\n  // A failed probe is treated as an older backend: the query degrades\n  // instead of the list staying empty.\n  const capabilitiesSettled = capabilities.isSuccess || capabilities.isError;\n  const supportedFilters = capabilities.data ?? null;\n\n  // `query` may be a fresh object every render; its normalized key is what\n  // identifies it, so the plan is built from the key and recomputed only\n  // when the content changes.\n  const queryKey = sessionsQueryKey(query);\n  const plan = useMemo(\n    () =>\n      planSessionsQuery(sessionsQueryFromKey(queryKey), {\n        supportedFilters,\n        includePullRequests,\n      }),\n    [queryKey, supportedFilters, includePullRequests],\n  );\n  const planRef = useRef(plan);\n  planRef.current = plan;\n  const unsupportedFields = useMemo(\n    () =>\n      capabilitiesSettled\n        ? unavailableSessionsQueryFields({ supportedFilters, includePullRequests })\n        : [],\n    [capabilitiesSettled, supportedFilters, includePullRequests],\n  );\n\n  const fetchPage = useMemo(\n    () =>\n      getAuth\n        ? createRestConversationListFetcher({\n            backendUrl,\n            getAuth,\n            includePullRequests,\n            extraFilters: plan.body,\n            keepRow: (row) => matchesSessionsQuery(row, planRef.current.local),\n          })\n        : async () => ({ items: [], hasMore: false, totalCount: null }),\n    [backendUrl, getAuth, includePullRequests, plan.body],\n  );\n  const baseFilter: ConversationListFilter = live?.baseFilter ?? {};\n  const capabilityKey = supportedFilters ? [...supportedFilters].sort().join(',') : 'legacy';\n  // The query's server filters are not part of the shared filter contract,\n  // so they — and what this backend applies of them — key the cache here.\n  const listScopeKey = `${identityScope}::sessions::${queryKey}::${capabilityKey}`;\n  const list = useConversationList({\n    fetchPage,\n    filter: baseFilter,\n    pageSize,\n    scopeKey: listScopeKey,\n    enabled: active && capabilitiesSettled,\n    queryClient,\n  });\n\n  // While a changed query's first page is in flight, the previous query's\n  // rows stand in, checked against the new query's local part — the list\n  // narrows at once instead of blanking to skeletons. Only rows read as the\n  // same identity and credential, over the same app scope, ever stand in: a\n  // changed scope (another app, or the home agent's conversations turned off)\n  // cannot be narrowed on the rows.\n  const standInScope = `${identityScope}::${conversationListFilterKey(baseFilter)}`;\n  const lastResolvedRef = useRef<{ scope: string; conversations: ConversationSummary[] }>({\n    scope: '',\n    conversations: [],\n  });\n  if (list.hasResolvedFirstPage) {\n    lastResolvedRef.current = { scope: standInScope, conversations: list.conversations };\n  }\n  const standIn =\n    !list.hasResolvedFirstPage && lastResolvedRef.current.scope === standInScope\n      ? lastResolvedRef.current.conversations\n      : null;\n  const source = standIn ?? list.conversations;\n  const isPlaceholderData = standIn !== null && standIn.length > 0;\n\n  const indexByThread = live?.indexByThread;\n  const applyOverrides = live?.applyOverrides;\n  const rows = useMemo(() => {\n    if (!indexByThread || !applyOverrides) return EMPTY_ROWS;\n    const folded: ConversationSummary[] = applyOverrides(\n      foldConversationIndex(source, indexByThread),\n    ).filter((row) => matchesSessionsQuery(row, plan.local));\n    return sortSessions(folded, plan.local).map(threadSummaryFromConversation);\n  }, [source, indexByThread, applyOverrides, plan.local]);\n\n  // A thread the index knows that this list does not show yet refreshes the\n  // list — it may be new, or may have just come to match. Once per VERSION of\n  // the entry (its id and `updated_at`): an unchanged entry the server keeps\n  // leaving out never refreshes twice, and a later change to it (a PR opened,\n  // a run now needing input) gets its own refresh. Coalesced, held while the\n  // list is already being read, and a refused refresh is tried again\n  // (`useIndexTriggeredRefresh`).\n  const indexEntries = live?.indexEntries ?? null;\n  const listRefresh = list.refresh;\n  const baseAppId = baseFilter.appId;\n  const baseAppIds = baseFilter.appIds;\n  const baseHomeAgentId = baseFilter.homeAgentId;\n  const homeAgentApplied = list.homeAgentApplied;\n  const listedThreadIds = useMemo(\n    () => new Set(list.conversations.map((conversation) => conversation.threadId)),\n    [list.conversations],\n  );\n  const unlistedVersions = useMemo(\n    () =>\n      indexEntries === null\n        ? []\n        : indexEntryVersionsToRefresh({\n            entries: indexEntries,\n            listedThreadIds,\n            refreshedVersions: EMPTY_VERSIONS,\n            appId: baseAppId,\n            additionalAppIds: baseAppIds ?? [],\n            homeAgentId: baseHomeAgentId,\n            homeAgentApplied,\n            query: plan.local,\n          }),\n    [\n      indexEntries,\n      listedThreadIds,\n      baseAppId,\n      baseAppIds,\n      baseHomeAgentId,\n      homeAgentApplied,\n      plan.local,\n    ],\n  );\n  useIndexTriggeredRefresh({\n    pending: unlistedVersions,\n    refresh: listRefresh,\n    // Held while the list is being read; a refused first page does not hold\n    // it (the refresh is how the list recovers).\n    enabled: active && capabilitiesSettled && indexEntries !== null && !list.isFetching,\n    tabShare: live?.tabShare,\n    shareKey: sessionListShareKey(\n      conversationListQueryKeys.firstPage(\n        listScopeKey,\n        conversationListFilterKey(baseFilter),\n        pageSize,\n      ),\n    ),\n  });\n\n  const listFetchNextPage = list.fetchNextPage;\n  return {\n    rows: isAvailable ? rows : EMPTY_ROWS,\n    isAvailable,\n    isLoading: active && (!capabilitiesSettled || list.isLoading),\n    isFetching: list.isFetching || capabilities.isFetching,\n    hasResolvedFirstPage: list.hasResolvedFirstPage,\n    isPlaceholderData,\n    hasNextPage: list.hasNextPage,\n    isFetchingNextPage: list.isFetchingNextPage,\n    fetchNextPage: isAvailable ? () => void listFetchNextPage() : NOOP,\n    refresh: isAvailable ? async () => void (await listRefresh()) : NOOP_ASYNC,\n    isFetchNextPageError: list.isFetchNextPageError,\n    supportedFilters,\n    degradedFields: plan.degraded,\n    unavailableFields: plan.unavailable,\n    unsupportedFields,\n  };\n}\n\ntype IndexEntryLike = Parameters<typeof entryCouldMatch>[0] & {\n  thread_id: string;\n  updated_at: string;\n  app_id: string | null;\n  collab_agent_id?: string | null;\n  start_channel?: string | null;\n};\n\n/**\n * The index entries that warrant one refresh of a filtered list, as\n * `<thread_id>@<updated_at>` versions: entries the list does not show, of\n * the apps it lists (and, while `homeAgentApplied`, of the conversations with\n * `homeAgentId`'s agent; see `indexedThreadsToRefreshFor`), that the query\n * could match on what the entry carries, and whose version has not prompted a\n * refresh before. An unchanged entry the server keeps leaving out refreshes\n * once; any later change to it refreshes again. Exported for tests.\n */\nexport function indexEntryVersionsToRefresh({\n  entries,\n  listedThreadIds,\n  refreshedVersions,\n  appId,\n  additionalAppIds,\n  homeAgentId,\n  homeAgentApplied,\n  query,\n}: {\n  entries: readonly IndexEntryLike[];\n  listedThreadIds: ReadonlySet<string>;\n  refreshedVersions: ReadonlySet<string>;\n  appId: string | undefined;\n  additionalAppIds: readonly string[];\n  homeAgentId?: string;\n  homeAgentApplied?: boolean;\n  query: AthenaSessionsQuery;\n}): string[] {\n  const versionOf = (entry: IndexEntryLike) => `${entry.thread_id}@${entry.updated_at}`;\n  const byVersion = new Map(entries.map((entry) => [versionOf(entry), entry]));\n  return indexedThreadsToRefreshFor({\n    entries: entries.map((entry) => ({\n      thread_id: versionOf(entry),\n      app_id: entry.app_id,\n      collab_agent_id: entry.collab_agent_id,\n      start_channel: entry.start_channel,\n    })),\n    listedThreadIds: new Set(\n      entries.filter((entry) => listedThreadIds.has(entry.thread_id)).map(versionOf),\n    ),\n    refreshedThreadIds: refreshedVersions,\n    appId,\n    additionalAppIds,\n    homeAgentId,\n    homeAgentApplied,\n  }).filter((version) => {\n    const entry = byVersion.get(version);\n    return entry === undefined || entryCouldMatch(entry, query);\n  });\n}\n\n/**\n * Whether a pushed index entry could belong to a list with this local query:\n * the fields the entry carries are checked, the rest pass.\n */\nexport function entryCouldMatch(\n  entry: {\n    is_unread?: boolean | null;\n    is_favorited?: boolean | null;\n    run_status?: string | null;\n    session_status?: string | null;\n  },\n  query: AthenaSessionsQuery,\n): boolean {\n  if (query.unreadOnly && entry.is_unread === false) return false;\n  if (query.favoritesOnly && entry.is_favorited === false) return false;\n  if (\n    query.runStatuses &&\n    typeof entry.run_status === 'string' &&\n    !(query.runStatuses as readonly string[]).includes(entry.run_status)\n  ) {\n    return false;\n  }\n  if (\n    query.sessionStatuses &&\n    typeof entry.session_status === 'string' &&\n    !(query.sessionStatuses as readonly string[]).includes(entry.session_status)\n  ) {\n    return false;\n  }\n  return true;\n}\n"],"names":["useContext","AthenaSessionsLiveContext","useAthenaQueryClient","useQuery","withCredentialRenewal","listThreads","supportedFiltersFromResponse","sessionsQueryKey","useMemo","planSessionsQuery","sessionsQueryFromKey","useRef","unavailableSessionsQueryFields","createRestConversationListFetcher","matchesSessionsQuery","useConversationList","conversationListFilterKey","foldConversationIndex","sortSessions","threadSummaryFromConversation","useIndexTriggeredRefresh","sessionListShareKey","conversationListQueryKeys","indexedThreadsToRefreshFor"],"mappings":"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"}
+{"version":3,"file":"use-athena-sessions.cjs","sources":["../../src/threads/use-athena-sessions.ts"],"sourcesContent":["/**\n * `useAthenaSessions(query)` — one filtered, sorted, live session list under\n * `<AthenaProvider enableThreadList>`: the data layer of `SessionsPage` and\n * `Inbox`, for hosts drawing their own.\n *\n * - **Server-side.** The query travels to `POST /api/conversations/threads/list`\n *   as filters of the server's one page statement (`planSessionsQuery`), over\n *   the shared two-tier pager (`useConversationList`: a live first page and\n *   frozen history pages) in the thread-list provider's query client.\n * - **Live.** Rows fold the same conversation-index pushes the sidebar folds\n *   (titles, lifecycle, attention flip in place), carry the provider's\n *   in-flight writes (pin, rename, read state, archive), and a thread the\n *   index learns about that the list does not show yet refreshes the list\n *   once.\n * - **Degraded, not wrong.** A server that cannot apply part of the query is\n *   detected from its `supported_filters` echo (one `limit: 1` probe per\n *   identity). Fields the loaded rows can be tested on are applied to them\n *   (`degradedFields`: exact per page, a page can come back short); fields\n *   they cannot are reported in `unavailableFields` and not applied, so a\n *   control for them can be disabled rather than lie.\n */\nimport {\n  type ConversationListFilter,\n  type ConversationSummary,\n  conversationListFilterKey,\n  conversationListQueryKeys,\n  useConversationList,\n} from '@athenaintel/agent-runtime';\nimport { useQuery } from '@tanstack/react-query';\nimport { useContext, useMemo, useRef } from 'react';\nimport { useAthenaQueryClient } from '../lib/use-athena-rest-query';\nimport { withCredentialRenewal } from '../runtime/credential-renewal';\nimport { listThreads } from './api';\nimport { createRestConversationListFetcher } from './conversation-list-fetcher';\nimport { useIndexTriggeredRefresh } from './index-triggered-refresh';\nimport { sessionListShareKey } from './session-list-tab-share';\nimport {\n  type AthenaSessionsQuery,\n  type AthenaSessionsQueryField,\n  matchesSessionsQuery,\n  planSessionsQuery,\n  sessionsQueryFromKey,\n  sessionsQueryKey,\n  sortSessions,\n  supportedFiltersFromResponse,\n  unavailableSessionsQueryFields,\n} from './sessions-query';\nimport {\n  AthenaSessionsLiveContext,\n  type AthenaStatewireThreadSummary,\n  foldConversationIndex,\n  indexedThreadsToRefreshFor,\n  threadSummaryFromConversation,\n} from './statewire-thread-list';\n\nexport interface UseAthenaSessionsOptions {\n  /** What to list. A new object with the same content does not refetch. */\n  query: AthenaSessionsQuery;\n  /** Rows per page (default 50). */\n  pageSize?: number;\n  /** `false` holds the list idle. Default `true`. */\n  enabled?: boolean;\n}\n\nexport interface AthenaSessionsList {\n  /** The rows, in the query's order, with live pushes and in-flight writes applied. */\n  rows: AthenaStatewireThreadSummary[];\n  /** `false` outside `enableThreadList` mode: nothing is fetched and `rows` stays empty. */\n  isAvailable: boolean;\n  /** True until the first page has answered (or while no credential has resolved). */\n  isLoading: boolean;\n  isFetching: boolean;\n  hasResolvedFirstPage: boolean;\n  /**\n   * When this query's first page was last written (ms since the epoch; 0 before it has any). A\n   * first page restored from the copy kept on this device (`offlineList`) carries that copy's\n   * old stamp until agora answers, and a refresh that fails leaves it as it was: compare it with\n   * a mount time to act only on what agora said since.\n   */\n  firstPageUpdatedAt: number;\n  /**\n   * True while the rows are the previous query's (checked against this\n   * query's local part) because this query's first page is still in flight.\n   */\n  isPlaceholderData: boolean;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  fetchNextPage: () => void;\n  /** Refetch the first page; resolves once it has answered. */\n  refresh: () => Promise<void>;\n  /** True while the last \"load more\" request failed. */\n  isFetchNextPageError: boolean;\n  /**\n   * The server fields this backend applies (`supported_filters`), `null`\n   * while unknown or on a backend that predates the list.\n   */\n  supportedFilters: ReadonlySet<string> | null;\n  /** Fields applied to the loaded rows because the backend cannot. */\n  degradedFields: AthenaSessionsQueryField[];\n  /** Fields of this query that cannot be applied on this backend at all (and are not). */\n  unavailableFields: AthenaSessionsQueryField[];\n  /**\n   * Every field this backend cannot apply anywhere, selected or not — what a\n   * filter UI disables. Empty until the capabilities probe has answered.\n   */\n  unsupportedFields: AthenaSessionsQueryField[];\n}\n\nconst DEFAULT_PAGE_SIZE = 50;\n\n/** The capabilities probe's key prefix. */\nexport const THREAD_LIST_CAPABILITIES_QUERY_KEY = [\n  'athena-sdk',\n  'thread-list-capabilities',\n] as const;\n\nconst EMPTY_ROWS: AthenaStatewireThreadSummary[] = [];\nconst EMPTY_VERSIONS: ReadonlySet<string> = new Set();\nconst NOOP = () => undefined;\nconst NOOP_ASYNC = async () => undefined;\n\nexport function useAthenaSessions({\n  query,\n  pageSize = DEFAULT_PAGE_SIZE,\n  enabled = true,\n}: UseAthenaSessionsOptions): AthenaSessionsList {\n  const live = useContext(AthenaSessionsLiveContext);\n  const isAvailable = live !== null;\n  const backendUrl = live?.backendUrl ?? '';\n  const principal = live?.principal ?? '';\n  const hasAuth = live?.hasAuth ?? false;\n  const includePullRequests = live?.includePullRequests ?? false;\n  const getAuth = live?.getAuth;\n  const active = isAvailable && enabled && hasAuth;\n  // Every cache below is keyed by WHO reads (principal) and WITH WHAT (the\n  // credential generation): a scoped credential for another workspace under\n  // the same principal must never read this one's cached rows.\n  const identityScope = `${live?.scopeKey ?? 'unavailable'}::credential-${\n    live?.credentialGeneration ?? 0\n  }`;\n\n  // Outside thread-list mode there may be no `QueryClientProvider`; every\n  // query below is disabled there, on a client of this hook's own.\n  const queryClient = useAthenaQueryClient();\n\n  // Which filters this backend applies: one tiny page per identity. The\n  // answer is a property of the deployed agora, so it never goes stale.\n  const capabilities = useQuery(\n    {\n      queryKey: [\n        ...THREAD_LIST_CAPABILITIES_QUERY_KEY,\n        backendUrl,\n        principal,\n        live?.credentialGeneration ?? 0,\n      ],\n      queryFn: async ({ signal }) => {\n        if (!getAuth) return null;\n        const response = await withCredentialRenewal(getAuth, (auth) =>\n          listThreads(backendUrl, auth, { limit: 1, signal }),\n        );\n        return supportedFiltersFromResponse(response.supported_filters);\n      },\n      enabled: active,\n      staleTime: Number.POSITIVE_INFINITY,\n      retry: 1,\n    },\n    queryClient,\n  );\n  // A failed probe is treated as an older backend: the query degrades\n  // instead of the list staying empty.\n  const capabilitiesSettled = capabilities.isSuccess || capabilities.isError;\n  const supportedFilters = capabilities.data ?? null;\n\n  // `query` may be a fresh object every render; its normalized key is what\n  // identifies it, so the plan is built from the key and recomputed only\n  // when the content changes.\n  const queryKey = sessionsQueryKey(query);\n  const plan = useMemo(\n    () =>\n      planSessionsQuery(sessionsQueryFromKey(queryKey), {\n        supportedFilters,\n        includePullRequests,\n      }),\n    [queryKey, supportedFilters, includePullRequests],\n  );\n  const planRef = useRef(plan);\n  planRef.current = plan;\n  const unsupportedFields = useMemo(\n    () =>\n      capabilitiesSettled\n        ? unavailableSessionsQueryFields({ supportedFilters, includePullRequests })\n        : [],\n    [capabilitiesSettled, supportedFilters, includePullRequests],\n  );\n\n  const fetchPage = useMemo(\n    () =>\n      getAuth\n        ? createRestConversationListFetcher({\n            backendUrl,\n            getAuth,\n            includePullRequests,\n            extraFilters: plan.body,\n            keepRow: (row) => matchesSessionsQuery(row, planRef.current.local),\n          })\n        : async () => ({ items: [], hasMore: false, totalCount: null }),\n    [backendUrl, getAuth, includePullRequests, plan.body],\n  );\n  const baseFilter: ConversationListFilter = live?.baseFilter ?? {};\n  const capabilityKey = supportedFilters ? [...supportedFilters].sort().join(',') : 'legacy';\n  // The query's server filters are not part of the shared filter contract,\n  // so they — and what this backend applies of them — key the cache here.\n  const listScopeKey = `${identityScope}::sessions::${queryKey}::${capabilityKey}`;\n  const list = useConversationList({\n    fetchPage,\n    filter: baseFilter,\n    pageSize,\n    scopeKey: listScopeKey,\n    enabled: active && capabilitiesSettled,\n    queryClient,\n  });\n\n  // While a changed query's first page is in flight, the previous query's\n  // rows stand in, checked against the new query's local part — the list\n  // narrows at once instead of blanking to skeletons. Only rows read as the\n  // same identity and credential, over the same app scope, ever stand in: a\n  // changed scope (another app, or the home agent's conversations turned off)\n  // cannot be narrowed on the rows.\n  const standInScope = `${identityScope}::${conversationListFilterKey(baseFilter)}`;\n  const lastResolvedRef = useRef<{ scope: string; conversations: ConversationSummary[] }>({\n    scope: '',\n    conversations: [],\n  });\n  if (list.hasResolvedFirstPage) {\n    lastResolvedRef.current = { scope: standInScope, conversations: list.conversations };\n  }\n  const standIn =\n    !list.hasResolvedFirstPage && lastResolvedRef.current.scope === standInScope\n      ? lastResolvedRef.current.conversations\n      : null;\n  const source = standIn ?? list.conversations;\n  const isPlaceholderData = standIn !== null && standIn.length > 0;\n\n  const indexByThread = live?.indexByThread;\n  const applyOverrides = live?.applyOverrides;\n  const rows = useMemo(() => {\n    if (!indexByThread || !applyOverrides) return EMPTY_ROWS;\n    const folded: ConversationSummary[] = applyOverrides(\n      foldConversationIndex(source, indexByThread),\n    ).filter((row) => matchesSessionsQuery(row, plan.local));\n    return sortSessions(folded, plan.local).map(threadSummaryFromConversation);\n  }, [source, indexByThread, applyOverrides, plan.local]);\n\n  // A thread the index knows that this list does not show yet refreshes the\n  // list — it may be new, or may have just come to match. Once per VERSION of\n  // the entry (its id and `updated_at`): an unchanged entry the server keeps\n  // leaving out never refreshes twice, and a later change to it (a PR opened,\n  // a run now needing input) gets its own refresh. Coalesced, held while the\n  // list is already being read, and a refused refresh is tried again\n  // (`useIndexTriggeredRefresh`).\n  const indexEntries = live?.indexEntries ?? null;\n  const listRefresh = list.refresh;\n  const baseAppId = baseFilter.appId;\n  const baseAppIds = baseFilter.appIds;\n  const baseHomeAgentId = baseFilter.homeAgentId;\n  const homeAgentApplied = list.homeAgentApplied;\n  const listedThreadIds = useMemo(\n    () => new Set(list.conversations.map((conversation) => conversation.threadId)),\n    [list.conversations],\n  );\n  const unlistedVersions = useMemo(\n    () =>\n      indexEntries === null\n        ? []\n        : indexEntryVersionsToRefresh({\n            entries: indexEntries,\n            listedThreadIds,\n            refreshedVersions: EMPTY_VERSIONS,\n            appId: baseAppId,\n            additionalAppIds: baseAppIds ?? [],\n            homeAgentId: baseHomeAgentId,\n            homeAgentApplied,\n            query: plan.local,\n          }),\n    [\n      indexEntries,\n      listedThreadIds,\n      baseAppId,\n      baseAppIds,\n      baseHomeAgentId,\n      homeAgentApplied,\n      plan.local,\n    ],\n  );\n  useIndexTriggeredRefresh({\n    pending: unlistedVersions,\n    refresh: listRefresh,\n    // Held while the list is being read; a refused first page does not hold\n    // it (the refresh is how the list recovers).\n    enabled: active && capabilitiesSettled && indexEntries !== null && !list.isFetching,\n    tabShare: live?.tabShare,\n    shareKey: sessionListShareKey(\n      conversationListQueryKeys.firstPage(\n        listScopeKey,\n        conversationListFilterKey(baseFilter),\n        pageSize,\n      ),\n    ),\n  });\n\n  const listFetchNextPage = list.fetchNextPage;\n  return {\n    rows: isAvailable ? rows : EMPTY_ROWS,\n    isAvailable,\n    isLoading: active && (!capabilitiesSettled || list.isLoading),\n    isFetching: list.isFetching || capabilities.isFetching,\n    hasResolvedFirstPage: list.hasResolvedFirstPage,\n    firstPageUpdatedAt: isAvailable ? list.firstPageUpdatedAt : 0,\n    isPlaceholderData,\n    hasNextPage: list.hasNextPage,\n    isFetchingNextPage: list.isFetchingNextPage,\n    fetchNextPage: isAvailable ? () => void listFetchNextPage() : NOOP,\n    refresh: isAvailable ? async () => void (await listRefresh()) : NOOP_ASYNC,\n    isFetchNextPageError: list.isFetchNextPageError,\n    supportedFilters,\n    degradedFields: plan.degraded,\n    unavailableFields: plan.unavailable,\n    unsupportedFields,\n  };\n}\n\ntype IndexEntryLike = Parameters<typeof entryCouldMatch>[0] & {\n  thread_id: string;\n  updated_at: string;\n  app_id: string | null;\n  collab_agent_id?: string | null;\n  start_channel?: string | null;\n};\n\n/**\n * The index entries that warrant one refresh of a filtered list, as\n * `<thread_id>@<updated_at>` versions: entries the list does not show, of\n * the apps it lists (and, while `homeAgentApplied`, of the conversations with\n * `homeAgentId`'s agent; see `indexedThreadsToRefreshFor`), that the query\n * could match on what the entry carries, and whose version has not prompted a\n * refresh before. An unchanged entry the server keeps leaving out refreshes\n * once; any later change to it refreshes again. Exported for tests.\n */\nexport function indexEntryVersionsToRefresh({\n  entries,\n  listedThreadIds,\n  refreshedVersions,\n  appId,\n  additionalAppIds,\n  homeAgentId,\n  homeAgentApplied,\n  query,\n}: {\n  entries: readonly IndexEntryLike[];\n  listedThreadIds: ReadonlySet<string>;\n  refreshedVersions: ReadonlySet<string>;\n  appId: string | undefined;\n  additionalAppIds: readonly string[];\n  homeAgentId?: string;\n  homeAgentApplied?: boolean;\n  query: AthenaSessionsQuery;\n}): string[] {\n  const versionOf = (entry: IndexEntryLike) => `${entry.thread_id}@${entry.updated_at}`;\n  const byVersion = new Map(entries.map((entry) => [versionOf(entry), entry]));\n  return indexedThreadsToRefreshFor({\n    entries: entries.map((entry) => ({\n      thread_id: versionOf(entry),\n      app_id: entry.app_id,\n      collab_agent_id: entry.collab_agent_id,\n      start_channel: entry.start_channel,\n    })),\n    listedThreadIds: new Set(\n      entries.filter((entry) => listedThreadIds.has(entry.thread_id)).map(versionOf),\n    ),\n    refreshedThreadIds: refreshedVersions,\n    appId,\n    additionalAppIds,\n    homeAgentId,\n    homeAgentApplied,\n  }).filter((version) => {\n    const entry = byVersion.get(version);\n    return entry === undefined || entryCouldMatch(entry, query);\n  });\n}\n\n/**\n * Whether a pushed index entry could belong to a list with this local query:\n * the fields the entry carries are checked, the rest pass.\n */\nexport function entryCouldMatch(\n  entry: {\n    is_unread?: boolean | null;\n    is_favorited?: boolean | null;\n    run_status?: string | null;\n    session_status?: string | null;\n  },\n  query: AthenaSessionsQuery,\n): boolean {\n  if (query.unreadOnly && entry.is_unread === false) return false;\n  if (query.favoritesOnly && entry.is_favorited === false) return false;\n  if (\n    query.runStatuses &&\n    typeof entry.run_status === 'string' &&\n    !(query.runStatuses as readonly string[]).includes(entry.run_status)\n  ) {\n    return false;\n  }\n  if (\n    query.sessionStatuses &&\n    typeof entry.session_status === 'string' &&\n    !(query.sessionStatuses as readonly string[]).includes(entry.session_status)\n  ) {\n    return false;\n  }\n  return true;\n}\n"],"names":["useContext","AthenaSessionsLiveContext","useAthenaQueryClient","useQuery","withCredentialRenewal","listThreads","supportedFiltersFromResponse","sessionsQueryKey","useMemo","planSessionsQuery","sessionsQueryFromKey","useRef","unavailableSessionsQueryFields","createRestConversationListFetcher","matchesSessionsQuery","useConversationList","conversationListFilterKey","foldConversationIndex","sortSessions","threadSummaryFromConversation","useIndexTriggeredRefresh","sessionListShareKey","conversationListQueryKeys","indexedThreadsToRefreshFor"],"mappings":"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"}

package/dist/threads/use-athena-sessions.d.ts

@@ -17,6 +17,13 @@ export interface AthenaSessionsList {
     isLoading: boolean;
     isFetching: boolean;
     hasResolvedFirstPage: boolean;
+    /**
+     * When this query's first page was last written (ms since the epoch; 0 before it has any). A
+     * first page restored from the copy kept on this device (`offlineList`) carries that copy's
+     * old stamp until agora answers, and a refresh that fails leaves it as it was: compare it with
+     * a mount time to act only on what agora said since.
+     */
+    firstPageUpdatedAt: number;
     /**
      * True while the rows are the previous query's (checked against this
      * query's local part) because this query's first page is still in flight.

package/dist/threads/use-athena-sessions.js

@@ -166,6 +166,7 @@ function useAthenaSessions({
     isLoading: active && (!capabilitiesSettled || list.isLoading),
     isFetching: list.isFetching || capabilities.isFetching,
     hasResolvedFirstPage: list.hasResolvedFirstPage,
+    firstPageUpdatedAt: isAvailable ? list.firstPageUpdatedAt : 0,
     isPlaceholderData,
     hasNextPage: list.hasNextPage,
     isFetchingNextPage: list.isFetchingNextPage,

package/dist/threads/use-athena-sessions.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-athena-sessions.js","sources":["../../src/threads/use-athena-sessions.ts"],"sourcesContent":["/**\n * `useAthenaSessions(query)` — one filtered, sorted, live session list under\n * `<AthenaProvider enableThreadList>`: the data layer of `SessionsPage` and\n * `Inbox`, for hosts drawing their own.\n *\n * - **Server-side.** The query travels to `POST /api/conversations/threads/list`\n *   as filters of the server's one page statement (`planSessionsQuery`), over\n *   the shared two-tier pager (`useConversationList`: a live first page and\n *   frozen history pages) in the thread-list provider's query client.\n * - **Live.** Rows fold the same conversation-index pushes the sidebar folds\n *   (titles, lifecycle, attention flip in place), carry the provider's\n *   in-flight writes (pin, rename, read state, archive), and a thread the\n *   index learns about that the list does not show yet refreshes the list\n *   once.\n * - **Degraded, not wrong.** A server that cannot apply part of the query is\n *   detected from its `supported_filters` echo (one `limit: 1` probe per\n *   identity). Fields the loaded rows can be tested on are applied to them\n *   (`degradedFields`: exact per page, a page can come back short); fields\n *   they cannot are reported in `unavailableFields` and not applied, so a\n *   control for them can be disabled rather than lie.\n */\nimport {\n  type ConversationListFilter,\n  type ConversationSummary,\n  conversationListFilterKey,\n  conversationListQueryKeys,\n  useConversationList,\n} from '@athenaintel/agent-runtime';\nimport { useQuery } from '@tanstack/react-query';\nimport { useContext, useMemo, useRef } from 'react';\nimport { useAthenaQueryClient } from '../lib/use-athena-rest-query';\nimport { withCredentialRenewal } from '../runtime/credential-renewal';\nimport { listThreads } from './api';\nimport { createRestConversationListFetcher } from './conversation-list-fetcher';\nimport { useIndexTriggeredRefresh } from './index-triggered-refresh';\nimport { sessionListShareKey } from './session-list-tab-share';\nimport {\n  type AthenaSessionsQuery,\n  type AthenaSessionsQueryField,\n  matchesSessionsQuery,\n  planSessionsQuery,\n  sessionsQueryFromKey,\n  sessionsQueryKey,\n  sortSessions,\n  supportedFiltersFromResponse,\n  unavailableSessionsQueryFields,\n} from './sessions-query';\nimport {\n  AthenaSessionsLiveContext,\n  type AthenaStatewireThreadSummary,\n  foldConversationIndex,\n  indexedThreadsToRefreshFor,\n  threadSummaryFromConversation,\n} from './statewire-thread-list';\n\nexport interface UseAthenaSessionsOptions {\n  /** What to list. A new object with the same content does not refetch. */\n  query: AthenaSessionsQuery;\n  /** Rows per page (default 50). */\n  pageSize?: number;\n  /** `false` holds the list idle. Default `true`. */\n  enabled?: boolean;\n}\n\nexport interface AthenaSessionsList {\n  /** The rows, in the query's order, with live pushes and in-flight writes applied. */\n  rows: AthenaStatewireThreadSummary[];\n  /** `false` outside `enableThreadList` mode: nothing is fetched and `rows` stays empty. */\n  isAvailable: boolean;\n  /** True until the first page has answered (or while no credential has resolved). */\n  isLoading: boolean;\n  isFetching: boolean;\n  hasResolvedFirstPage: boolean;\n  /**\n   * True while the rows are the previous query's (checked against this\n   * query's local part) because this query's first page is still in flight.\n   */\n  isPlaceholderData: boolean;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  fetchNextPage: () => void;\n  /** Refetch the first page; resolves once it has answered. */\n  refresh: () => Promise<void>;\n  /** True while the last \"load more\" request failed. */\n  isFetchNextPageError: boolean;\n  /**\n   * The server fields this backend applies (`supported_filters`), `null`\n   * while unknown or on a backend that predates the list.\n   */\n  supportedFilters: ReadonlySet<string> | null;\n  /** Fields applied to the loaded rows because the backend cannot. */\n  degradedFields: AthenaSessionsQueryField[];\n  /** Fields of this query that cannot be applied on this backend at all (and are not). */\n  unavailableFields: AthenaSessionsQueryField[];\n  /**\n   * Every field this backend cannot apply anywhere, selected or not — what a\n   * filter UI disables. Empty until the capabilities probe has answered.\n   */\n  unsupportedFields: AthenaSessionsQueryField[];\n}\n\nconst DEFAULT_PAGE_SIZE = 50;\n\n/** The capabilities probe's key prefix. */\nexport const THREAD_LIST_CAPABILITIES_QUERY_KEY = [\n  'athena-sdk',\n  'thread-list-capabilities',\n] as const;\n\nconst EMPTY_ROWS: AthenaStatewireThreadSummary[] = [];\nconst EMPTY_VERSIONS: ReadonlySet<string> = new Set();\nconst NOOP = () => undefined;\nconst NOOP_ASYNC = async () => undefined;\n\nexport function useAthenaSessions({\n  query,\n  pageSize = DEFAULT_PAGE_SIZE,\n  enabled = true,\n}: UseAthenaSessionsOptions): AthenaSessionsList {\n  const live = useContext(AthenaSessionsLiveContext);\n  const isAvailable = live !== null;\n  const backendUrl = live?.backendUrl ?? '';\n  const principal = live?.principal ?? '';\n  const hasAuth = live?.hasAuth ?? false;\n  const includePullRequests = live?.includePullRequests ?? false;\n  const getAuth = live?.getAuth;\n  const active = isAvailable && enabled && hasAuth;\n  // Every cache below is keyed by WHO reads (principal) and WITH WHAT (the\n  // credential generation): a scoped credential for another workspace under\n  // the same principal must never read this one's cached rows.\n  const identityScope = `${live?.scopeKey ?? 'unavailable'}::credential-${\n    live?.credentialGeneration ?? 0\n  }`;\n\n  // Outside thread-list mode there may be no `QueryClientProvider`; every\n  // query below is disabled there, on a client of this hook's own.\n  const queryClient = useAthenaQueryClient();\n\n  // Which filters this backend applies: one tiny page per identity. The\n  // answer is a property of the deployed agora, so it never goes stale.\n  const capabilities = useQuery(\n    {\n      queryKey: [\n        ...THREAD_LIST_CAPABILITIES_QUERY_KEY,\n        backendUrl,\n        principal,\n        live?.credentialGeneration ?? 0,\n      ],\n      queryFn: async ({ signal }) => {\n        if (!getAuth) return null;\n        const response = await withCredentialRenewal(getAuth, (auth) =>\n          listThreads(backendUrl, auth, { limit: 1, signal }),\n        );\n        return supportedFiltersFromResponse(response.supported_filters);\n      },\n      enabled: active,\n      staleTime: Number.POSITIVE_INFINITY,\n      retry: 1,\n    },\n    queryClient,\n  );\n  // A failed probe is treated as an older backend: the query degrades\n  // instead of the list staying empty.\n  const capabilitiesSettled = capabilities.isSuccess || capabilities.isError;\n  const supportedFilters = capabilities.data ?? null;\n\n  // `query` may be a fresh object every render; its normalized key is what\n  // identifies it, so the plan is built from the key and recomputed only\n  // when the content changes.\n  const queryKey = sessionsQueryKey(query);\n  const plan = useMemo(\n    () =>\n      planSessionsQuery(sessionsQueryFromKey(queryKey), {\n        supportedFilters,\n        includePullRequests,\n      }),\n    [queryKey, supportedFilters, includePullRequests],\n  );\n  const planRef = useRef(plan);\n  planRef.current = plan;\n  const unsupportedFields = useMemo(\n    () =>\n      capabilitiesSettled\n        ? unavailableSessionsQueryFields({ supportedFilters, includePullRequests })\n        : [],\n    [capabilitiesSettled, supportedFilters, includePullRequests],\n  );\n\n  const fetchPage = useMemo(\n    () =>\n      getAuth\n        ? createRestConversationListFetcher({\n            backendUrl,\n            getAuth,\n            includePullRequests,\n            extraFilters: plan.body,\n            keepRow: (row) => matchesSessionsQuery(row, planRef.current.local),\n          })\n        : async () => ({ items: [], hasMore: false, totalCount: null }),\n    [backendUrl, getAuth, includePullRequests, plan.body],\n  );\n  const baseFilter: ConversationListFilter = live?.baseFilter ?? {};\n  const capabilityKey = supportedFilters ? [...supportedFilters].sort().join(',') : 'legacy';\n  // The query's server filters are not part of the shared filter contract,\n  // so they — and what this backend applies of them — key the cache here.\n  const listScopeKey = `${identityScope}::sessions::${queryKey}::${capabilityKey}`;\n  const list = useConversationList({\n    fetchPage,\n    filter: baseFilter,\n    pageSize,\n    scopeKey: listScopeKey,\n    enabled: active && capabilitiesSettled,\n    queryClient,\n  });\n\n  // While a changed query's first page is in flight, the previous query's\n  // rows stand in, checked against the new query's local part — the list\n  // narrows at once instead of blanking to skeletons. Only rows read as the\n  // same identity and credential, over the same app scope, ever stand in: a\n  // changed scope (another app, or the home agent's conversations turned off)\n  // cannot be narrowed on the rows.\n  const standInScope = `${identityScope}::${conversationListFilterKey(baseFilter)}`;\n  const lastResolvedRef = useRef<{ scope: string; conversations: ConversationSummary[] }>({\n    scope: '',\n    conversations: [],\n  });\n  if (list.hasResolvedFirstPage) {\n    lastResolvedRef.current = { scope: standInScope, conversations: list.conversations };\n  }\n  const standIn =\n    !list.hasResolvedFirstPage && lastResolvedRef.current.scope === standInScope\n      ? lastResolvedRef.current.conversations\n      : null;\n  const source = standIn ?? list.conversations;\n  const isPlaceholderData = standIn !== null && standIn.length > 0;\n\n  const indexByThread = live?.indexByThread;\n  const applyOverrides = live?.applyOverrides;\n  const rows = useMemo(() => {\n    if (!indexByThread || !applyOverrides) return EMPTY_ROWS;\n    const folded: ConversationSummary[] = applyOverrides(\n      foldConversationIndex(source, indexByThread),\n    ).filter((row) => matchesSessionsQuery(row, plan.local));\n    return sortSessions(folded, plan.local).map(threadSummaryFromConversation);\n  }, [source, indexByThread, applyOverrides, plan.local]);\n\n  // A thread the index knows that this list does not show yet refreshes the\n  // list — it may be new, or may have just come to match. Once per VERSION of\n  // the entry (its id and `updated_at`): an unchanged entry the server keeps\n  // leaving out never refreshes twice, and a later change to it (a PR opened,\n  // a run now needing input) gets its own refresh. Coalesced, held while the\n  // list is already being read, and a refused refresh is tried again\n  // (`useIndexTriggeredRefresh`).\n  const indexEntries = live?.indexEntries ?? null;\n  const listRefresh = list.refresh;\n  const baseAppId = baseFilter.appId;\n  const baseAppIds = baseFilter.appIds;\n  const baseHomeAgentId = baseFilter.homeAgentId;\n  const homeAgentApplied = list.homeAgentApplied;\n  const listedThreadIds = useMemo(\n    () => new Set(list.conversations.map((conversation) => conversation.threadId)),\n    [list.conversations],\n  );\n  const unlistedVersions = useMemo(\n    () =>\n      indexEntries === null\n        ? []\n        : indexEntryVersionsToRefresh({\n            entries: indexEntries,\n            listedThreadIds,\n            refreshedVersions: EMPTY_VERSIONS,\n            appId: baseAppId,\n            additionalAppIds: baseAppIds ?? [],\n            homeAgentId: baseHomeAgentId,\n            homeAgentApplied,\n            query: plan.local,\n          }),\n    [\n      indexEntries,\n      listedThreadIds,\n      baseAppId,\n      baseAppIds,\n      baseHomeAgentId,\n      homeAgentApplied,\n      plan.local,\n    ],\n  );\n  useIndexTriggeredRefresh({\n    pending: unlistedVersions,\n    refresh: listRefresh,\n    // Held while the list is being read; a refused first page does not hold\n    // it (the refresh is how the list recovers).\n    enabled: active && capabilitiesSettled && indexEntries !== null && !list.isFetching,\n    tabShare: live?.tabShare,\n    shareKey: sessionListShareKey(\n      conversationListQueryKeys.firstPage(\n        listScopeKey,\n        conversationListFilterKey(baseFilter),\n        pageSize,\n      ),\n    ),\n  });\n\n  const listFetchNextPage = list.fetchNextPage;\n  return {\n    rows: isAvailable ? rows : EMPTY_ROWS,\n    isAvailable,\n    isLoading: active && (!capabilitiesSettled || list.isLoading),\n    isFetching: list.isFetching || capabilities.isFetching,\n    hasResolvedFirstPage: list.hasResolvedFirstPage,\n    isPlaceholderData,\n    hasNextPage: list.hasNextPage,\n    isFetchingNextPage: list.isFetchingNextPage,\n    fetchNextPage: isAvailable ? () => void listFetchNextPage() : NOOP,\n    refresh: isAvailable ? async () => void (await listRefresh()) : NOOP_ASYNC,\n    isFetchNextPageError: list.isFetchNextPageError,\n    supportedFilters,\n    degradedFields: plan.degraded,\n    unavailableFields: plan.unavailable,\n    unsupportedFields,\n  };\n}\n\ntype IndexEntryLike = Parameters<typeof entryCouldMatch>[0] & {\n  thread_id: string;\n  updated_at: string;\n  app_id: string | null;\n  collab_agent_id?: string | null;\n  start_channel?: string | null;\n};\n\n/**\n * The index entries that warrant one refresh of a filtered list, as\n * `<thread_id>@<updated_at>` versions: entries the list does not show, of\n * the apps it lists (and, while `homeAgentApplied`, of the conversations with\n * `homeAgentId`'s agent; see `indexedThreadsToRefreshFor`), that the query\n * could match on what the entry carries, and whose version has not prompted a\n * refresh before. An unchanged entry the server keeps leaving out refreshes\n * once; any later change to it refreshes again. Exported for tests.\n */\nexport function indexEntryVersionsToRefresh({\n  entries,\n  listedThreadIds,\n  refreshedVersions,\n  appId,\n  additionalAppIds,\n  homeAgentId,\n  homeAgentApplied,\n  query,\n}: {\n  entries: readonly IndexEntryLike[];\n  listedThreadIds: ReadonlySet<string>;\n  refreshedVersions: ReadonlySet<string>;\n  appId: string | undefined;\n  additionalAppIds: readonly string[];\n  homeAgentId?: string;\n  homeAgentApplied?: boolean;\n  query: AthenaSessionsQuery;\n}): string[] {\n  const versionOf = (entry: IndexEntryLike) => `${entry.thread_id}@${entry.updated_at}`;\n  const byVersion = new Map(entries.map((entry) => [versionOf(entry), entry]));\n  return indexedThreadsToRefreshFor({\n    entries: entries.map((entry) => ({\n      thread_id: versionOf(entry),\n      app_id: entry.app_id,\n      collab_agent_id: entry.collab_agent_id,\n      start_channel: entry.start_channel,\n    })),\n    listedThreadIds: new Set(\n      entries.filter((entry) => listedThreadIds.has(entry.thread_id)).map(versionOf),\n    ),\n    refreshedThreadIds: refreshedVersions,\n    appId,\n    additionalAppIds,\n    homeAgentId,\n    homeAgentApplied,\n  }).filter((version) => {\n    const entry = byVersion.get(version);\n    return entry === undefined || entryCouldMatch(entry, query);\n  });\n}\n\n/**\n * Whether a pushed index entry could belong to a list with this local query:\n * the fields the entry carries are checked, the rest pass.\n */\nexport function entryCouldMatch(\n  entry: {\n    is_unread?: boolean | null;\n    is_favorited?: boolean | null;\n    run_status?: string | null;\n    session_status?: string | null;\n  },\n  query: AthenaSessionsQuery,\n): boolean {\n  if (query.unreadOnly && entry.is_unread === false) return false;\n  if (query.favoritesOnly && entry.is_favorited === false) return false;\n  if (\n    query.runStatuses &&\n    typeof entry.run_status === 'string' &&\n    !(query.runStatuses as readonly string[]).includes(entry.run_status)\n  ) {\n    return false;\n  }\n  if (\n    query.sessionStatuses &&\n    typeof entry.session_status === 'string' &&\n    !(query.sessionStatuses as readonly string[]).includes(entry.session_status)\n  ) {\n    return false;\n  }\n  return true;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-athena-sessions.js","sources":["../../src/threads/use-athena-sessions.ts"],"sourcesContent":["/**\n * `useAthenaSessions(query)` — one filtered, sorted, live session list under\n * `<AthenaProvider enableThreadList>`: the data layer of `SessionsPage` and\n * `Inbox`, for hosts drawing their own.\n *\n * - **Server-side.** The query travels to `POST /api/conversations/threads/list`\n *   as filters of the server's one page statement (`planSessionsQuery`), over\n *   the shared two-tier pager (`useConversationList`: a live first page and\n *   frozen history pages) in the thread-list provider's query client.\n * - **Live.** Rows fold the same conversation-index pushes the sidebar folds\n *   (titles, lifecycle, attention flip in place), carry the provider's\n *   in-flight writes (pin, rename, read state, archive), and a thread the\n *   index learns about that the list does not show yet refreshes the list\n *   once.\n * - **Degraded, not wrong.** A server that cannot apply part of the query is\n *   detected from its `supported_filters` echo (one `limit: 1` probe per\n *   identity). Fields the loaded rows can be tested on are applied to them\n *   (`degradedFields`: exact per page, a page can come back short); fields\n *   they cannot are reported in `unavailableFields` and not applied, so a\n *   control for them can be disabled rather than lie.\n */\nimport {\n  type ConversationListFilter,\n  type ConversationSummary,\n  conversationListFilterKey,\n  conversationListQueryKeys,\n  useConversationList,\n} from '@athenaintel/agent-runtime';\nimport { useQuery } from '@tanstack/react-query';\nimport { useContext, useMemo, useRef } from 'react';\nimport { useAthenaQueryClient } from '../lib/use-athena-rest-query';\nimport { withCredentialRenewal } from '../runtime/credential-renewal';\nimport { listThreads } from './api';\nimport { createRestConversationListFetcher } from './conversation-list-fetcher';\nimport { useIndexTriggeredRefresh } from './index-triggered-refresh';\nimport { sessionListShareKey } from './session-list-tab-share';\nimport {\n  type AthenaSessionsQuery,\n  type AthenaSessionsQueryField,\n  matchesSessionsQuery,\n  planSessionsQuery,\n  sessionsQueryFromKey,\n  sessionsQueryKey,\n  sortSessions,\n  supportedFiltersFromResponse,\n  unavailableSessionsQueryFields,\n} from './sessions-query';\nimport {\n  AthenaSessionsLiveContext,\n  type AthenaStatewireThreadSummary,\n  foldConversationIndex,\n  indexedThreadsToRefreshFor,\n  threadSummaryFromConversation,\n} from './statewire-thread-list';\n\nexport interface UseAthenaSessionsOptions {\n  /** What to list. A new object with the same content does not refetch. */\n  query: AthenaSessionsQuery;\n  /** Rows per page (default 50). */\n  pageSize?: number;\n  /** `false` holds the list idle. Default `true`. */\n  enabled?: boolean;\n}\n\nexport interface AthenaSessionsList {\n  /** The rows, in the query's order, with live pushes and in-flight writes applied. */\n  rows: AthenaStatewireThreadSummary[];\n  /** `false` outside `enableThreadList` mode: nothing is fetched and `rows` stays empty. */\n  isAvailable: boolean;\n  /** True until the first page has answered (or while no credential has resolved). */\n  isLoading: boolean;\n  isFetching: boolean;\n  hasResolvedFirstPage: boolean;\n  /**\n   * When this query's first page was last written (ms since the epoch; 0 before it has any). A\n   * first page restored from the copy kept on this device (`offlineList`) carries that copy's\n   * old stamp until agora answers, and a refresh that fails leaves it as it was: compare it with\n   * a mount time to act only on what agora said since.\n   */\n  firstPageUpdatedAt: number;\n  /**\n   * True while the rows are the previous query's (checked against this\n   * query's local part) because this query's first page is still in flight.\n   */\n  isPlaceholderData: boolean;\n  hasNextPage: boolean;\n  isFetchingNextPage: boolean;\n  fetchNextPage: () => void;\n  /** Refetch the first page; resolves once it has answered. */\n  refresh: () => Promise<void>;\n  /** True while the last \"load more\" request failed. */\n  isFetchNextPageError: boolean;\n  /**\n   * The server fields this backend applies (`supported_filters`), `null`\n   * while unknown or on a backend that predates the list.\n   */\n  supportedFilters: ReadonlySet<string> | null;\n  /** Fields applied to the loaded rows because the backend cannot. */\n  degradedFields: AthenaSessionsQueryField[];\n  /** Fields of this query that cannot be applied on this backend at all (and are not). */\n  unavailableFields: AthenaSessionsQueryField[];\n  /**\n   * Every field this backend cannot apply anywhere, selected or not — what a\n   * filter UI disables. Empty until the capabilities probe has answered.\n   */\n  unsupportedFields: AthenaSessionsQueryField[];\n}\n\nconst DEFAULT_PAGE_SIZE = 50;\n\n/** The capabilities probe's key prefix. */\nexport const THREAD_LIST_CAPABILITIES_QUERY_KEY = [\n  'athena-sdk',\n  'thread-list-capabilities',\n] as const;\n\nconst EMPTY_ROWS: AthenaStatewireThreadSummary[] = [];\nconst EMPTY_VERSIONS: ReadonlySet<string> = new Set();\nconst NOOP = () => undefined;\nconst NOOP_ASYNC = async () => undefined;\n\nexport function useAthenaSessions({\n  query,\n  pageSize = DEFAULT_PAGE_SIZE,\n  enabled = true,\n}: UseAthenaSessionsOptions): AthenaSessionsList {\n  const live = useContext(AthenaSessionsLiveContext);\n  const isAvailable = live !== null;\n  const backendUrl = live?.backendUrl ?? '';\n  const principal = live?.principal ?? '';\n  const hasAuth = live?.hasAuth ?? false;\n  const includePullRequests = live?.includePullRequests ?? false;\n  const getAuth = live?.getAuth;\n  const active = isAvailable && enabled && hasAuth;\n  // Every cache below is keyed by WHO reads (principal) and WITH WHAT (the\n  // credential generation): a scoped credential for another workspace under\n  // the same principal must never read this one's cached rows.\n  const identityScope = `${live?.scopeKey ?? 'unavailable'}::credential-${\n    live?.credentialGeneration ?? 0\n  }`;\n\n  // Outside thread-list mode there may be no `QueryClientProvider`; every\n  // query below is disabled there, on a client of this hook's own.\n  const queryClient = useAthenaQueryClient();\n\n  // Which filters this backend applies: one tiny page per identity. The\n  // answer is a property of the deployed agora, so it never goes stale.\n  const capabilities = useQuery(\n    {\n      queryKey: [\n        ...THREAD_LIST_CAPABILITIES_QUERY_KEY,\n        backendUrl,\n        principal,\n        live?.credentialGeneration ?? 0,\n      ],\n      queryFn: async ({ signal }) => {\n        if (!getAuth) return null;\n        const response = await withCredentialRenewal(getAuth, (auth) =>\n          listThreads(backendUrl, auth, { limit: 1, signal }),\n        );\n        return supportedFiltersFromResponse(response.supported_filters);\n      },\n      enabled: active,\n      staleTime: Number.POSITIVE_INFINITY,\n      retry: 1,\n    },\n    queryClient,\n  );\n  // A failed probe is treated as an older backend: the query degrades\n  // instead of the list staying empty.\n  const capabilitiesSettled = capabilities.isSuccess || capabilities.isError;\n  const supportedFilters = capabilities.data ?? null;\n\n  // `query` may be a fresh object every render; its normalized key is what\n  // identifies it, so the plan is built from the key and recomputed only\n  // when the content changes.\n  const queryKey = sessionsQueryKey(query);\n  const plan = useMemo(\n    () =>\n      planSessionsQuery(sessionsQueryFromKey(queryKey), {\n        supportedFilters,\n        includePullRequests,\n      }),\n    [queryKey, supportedFilters, includePullRequests],\n  );\n  const planRef = useRef(plan);\n  planRef.current = plan;\n  const unsupportedFields = useMemo(\n    () =>\n      capabilitiesSettled\n        ? unavailableSessionsQueryFields({ supportedFilters, includePullRequests })\n        : [],\n    [capabilitiesSettled, supportedFilters, includePullRequests],\n  );\n\n  const fetchPage = useMemo(\n    () =>\n      getAuth\n        ? createRestConversationListFetcher({\n            backendUrl,\n            getAuth,\n            includePullRequests,\n            extraFilters: plan.body,\n            keepRow: (row) => matchesSessionsQuery(row, planRef.current.local),\n          })\n        : async () => ({ items: [], hasMore: false, totalCount: null }),\n    [backendUrl, getAuth, includePullRequests, plan.body],\n  );\n  const baseFilter: ConversationListFilter = live?.baseFilter ?? {};\n  const capabilityKey = supportedFilters ? [...supportedFilters].sort().join(',') : 'legacy';\n  // The query's server filters are not part of the shared filter contract,\n  // so they — and what this backend applies of them — key the cache here.\n  const listScopeKey = `${identityScope}::sessions::${queryKey}::${capabilityKey}`;\n  const list = useConversationList({\n    fetchPage,\n    filter: baseFilter,\n    pageSize,\n    scopeKey: listScopeKey,\n    enabled: active && capabilitiesSettled,\n    queryClient,\n  });\n\n  // While a changed query's first page is in flight, the previous query's\n  // rows stand in, checked against the new query's local part — the list\n  // narrows at once instead of blanking to skeletons. Only rows read as the\n  // same identity and credential, over the same app scope, ever stand in: a\n  // changed scope (another app, or the home agent's conversations turned off)\n  // cannot be narrowed on the rows.\n  const standInScope = `${identityScope}::${conversationListFilterKey(baseFilter)}`;\n  const lastResolvedRef = useRef<{ scope: string; conversations: ConversationSummary[] }>({\n    scope: '',\n    conversations: [],\n  });\n  if (list.hasResolvedFirstPage) {\n    lastResolvedRef.current = { scope: standInScope, conversations: list.conversations };\n  }\n  const standIn =\n    !list.hasResolvedFirstPage && lastResolvedRef.current.scope === standInScope\n      ? lastResolvedRef.current.conversations\n      : null;\n  const source = standIn ?? list.conversations;\n  const isPlaceholderData = standIn !== null && standIn.length > 0;\n\n  const indexByThread = live?.indexByThread;\n  const applyOverrides = live?.applyOverrides;\n  const rows = useMemo(() => {\n    if (!indexByThread || !applyOverrides) return EMPTY_ROWS;\n    const folded: ConversationSummary[] = applyOverrides(\n      foldConversationIndex(source, indexByThread),\n    ).filter((row) => matchesSessionsQuery(row, plan.local));\n    return sortSessions(folded, plan.local).map(threadSummaryFromConversation);\n  }, [source, indexByThread, applyOverrides, plan.local]);\n\n  // A thread the index knows that this list does not show yet refreshes the\n  // list — it may be new, or may have just come to match. Once per VERSION of\n  // the entry (its id and `updated_at`): an unchanged entry the server keeps\n  // leaving out never refreshes twice, and a later change to it (a PR opened,\n  // a run now needing input) gets its own refresh. Coalesced, held while the\n  // list is already being read, and a refused refresh is tried again\n  // (`useIndexTriggeredRefresh`).\n  const indexEntries = live?.indexEntries ?? null;\n  const listRefresh = list.refresh;\n  const baseAppId = baseFilter.appId;\n  const baseAppIds = baseFilter.appIds;\n  const baseHomeAgentId = baseFilter.homeAgentId;\n  const homeAgentApplied = list.homeAgentApplied;\n  const listedThreadIds = useMemo(\n    () => new Set(list.conversations.map((conversation) => conversation.threadId)),\n    [list.conversations],\n  );\n  const unlistedVersions = useMemo(\n    () =>\n      indexEntries === null\n        ? []\n        : indexEntryVersionsToRefresh({\n            entries: indexEntries,\n            listedThreadIds,\n            refreshedVersions: EMPTY_VERSIONS,\n            appId: baseAppId,\n            additionalAppIds: baseAppIds ?? [],\n            homeAgentId: baseHomeAgentId,\n            homeAgentApplied,\n            query: plan.local,\n          }),\n    [\n      indexEntries,\n      listedThreadIds,\n      baseAppId,\n      baseAppIds,\n      baseHomeAgentId,\n      homeAgentApplied,\n      plan.local,\n    ],\n  );\n  useIndexTriggeredRefresh({\n    pending: unlistedVersions,\n    refresh: listRefresh,\n    // Held while the list is being read; a refused first page does not hold\n    // it (the refresh is how the list recovers).\n    enabled: active && capabilitiesSettled && indexEntries !== null && !list.isFetching,\n    tabShare: live?.tabShare,\n    shareKey: sessionListShareKey(\n      conversationListQueryKeys.firstPage(\n        listScopeKey,\n        conversationListFilterKey(baseFilter),\n        pageSize,\n      ),\n    ),\n  });\n\n  const listFetchNextPage = list.fetchNextPage;\n  return {\n    rows: isAvailable ? rows : EMPTY_ROWS,\n    isAvailable,\n    isLoading: active && (!capabilitiesSettled || list.isLoading),\n    isFetching: list.isFetching || capabilities.isFetching,\n    hasResolvedFirstPage: list.hasResolvedFirstPage,\n    firstPageUpdatedAt: isAvailable ? list.firstPageUpdatedAt : 0,\n    isPlaceholderData,\n    hasNextPage: list.hasNextPage,\n    isFetchingNextPage: list.isFetchingNextPage,\n    fetchNextPage: isAvailable ? () => void listFetchNextPage() : NOOP,\n    refresh: isAvailable ? async () => void (await listRefresh()) : NOOP_ASYNC,\n    isFetchNextPageError: list.isFetchNextPageError,\n    supportedFilters,\n    degradedFields: plan.degraded,\n    unavailableFields: plan.unavailable,\n    unsupportedFields,\n  };\n}\n\ntype IndexEntryLike = Parameters<typeof entryCouldMatch>[0] & {\n  thread_id: string;\n  updated_at: string;\n  app_id: string | null;\n  collab_agent_id?: string | null;\n  start_channel?: string | null;\n};\n\n/**\n * The index entries that warrant one refresh of a filtered list, as\n * `<thread_id>@<updated_at>` versions: entries the list does not show, of\n * the apps it lists (and, while `homeAgentApplied`, of the conversations with\n * `homeAgentId`'s agent; see `indexedThreadsToRefreshFor`), that the query\n * could match on what the entry carries, and whose version has not prompted a\n * refresh before. An unchanged entry the server keeps leaving out refreshes\n * once; any later change to it refreshes again. Exported for tests.\n */\nexport function indexEntryVersionsToRefresh({\n  entries,\n  listedThreadIds,\n  refreshedVersions,\n  appId,\n  additionalAppIds,\n  homeAgentId,\n  homeAgentApplied,\n  query,\n}: {\n  entries: readonly IndexEntryLike[];\n  listedThreadIds: ReadonlySet<string>;\n  refreshedVersions: ReadonlySet<string>;\n  appId: string | undefined;\n  additionalAppIds: readonly string[];\n  homeAgentId?: string;\n  homeAgentApplied?: boolean;\n  query: AthenaSessionsQuery;\n}): string[] {\n  const versionOf = (entry: IndexEntryLike) => `${entry.thread_id}@${entry.updated_at}`;\n  const byVersion = new Map(entries.map((entry) => [versionOf(entry), entry]));\n  return indexedThreadsToRefreshFor({\n    entries: entries.map((entry) => ({\n      thread_id: versionOf(entry),\n      app_id: entry.app_id,\n      collab_agent_id: entry.collab_agent_id,\n      start_channel: entry.start_channel,\n    })),\n    listedThreadIds: new Set(\n      entries.filter((entry) => listedThreadIds.has(entry.thread_id)).map(versionOf),\n    ),\n    refreshedThreadIds: refreshedVersions,\n    appId,\n    additionalAppIds,\n    homeAgentId,\n    homeAgentApplied,\n  }).filter((version) => {\n    const entry = byVersion.get(version);\n    return entry === undefined || entryCouldMatch(entry, query);\n  });\n}\n\n/**\n * Whether a pushed index entry could belong to a list with this local query:\n * the fields the entry carries are checked, the rest pass.\n */\nexport function entryCouldMatch(\n  entry: {\n    is_unread?: boolean | null;\n    is_favorited?: boolean | null;\n    run_status?: string | null;\n    session_status?: string | null;\n  },\n  query: AthenaSessionsQuery,\n): boolean {\n  if (query.unreadOnly && entry.is_unread === false) return false;\n  if (query.favoritesOnly && entry.is_favorited === false) return false;\n  if (\n    query.runStatuses &&\n    typeof entry.run_status === 'string' &&\n    !(query.runStatuses as readonly string[]).includes(entry.run_status)\n  ) {\n    return false;\n  }\n  if (\n    query.sessionStatuses &&\n    typeof entry.session_status === 'string' &&\n    !(query.sessionStatuses as readonly string[]).includes(entry.session_status)\n  ) {\n    return false;\n  }\n  return true;\n}\n"],"names":[],"mappings":"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"}

package/dist/threads/use-athena-thread-agent.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require$$0 = require("react");
+const agentModelOptions = require("../catalog/agent-model-options.cjs");
+const statewireServerLaneContext = require("../runtime/statewire-server-lane-context.cjs");
+function threadAgentFromLane({
+  lane,
+  ready
+}) {
+  if (!ready || lane === null) return { agentId: null, configured: false, ready };
+  const value = lane.custom.collab_agent_id;
+  return {
+    agentId: typeof value === "string" ? agentModelOptions.agentAssetIdOf(value) : null,
+    configured: true,
+    ready
+  };
+}
+function useAthenaThreadAgent() {
+  const lane = require$$0.useContext(statewireServerLaneContext.AthenaStatewireServerLaneContext);
+  const agent = require$$0.useMemo(
+    () => lane === null ? null : threadAgentFromLane({ lane: lane.config, ready: lane.landed }),
+    [lane]
+  );
+  if (agent === null) {
+    throw new Error("[AthenaSDK] useAthenaThreadAgent must be used within <AthenaProvider>");
+  }
+  return agent;
+}
+exports.threadAgentFromLane = threadAgentFromLane;
+exports.useAthenaThreadAgent = useAthenaThreadAgent;
+//# sourceMappingURL=use-athena-thread-agent.cjs.map

package/dist/threads/use-athena-thread-agent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-agent.cjs","sources":["../../src/threads/use-athena-thread-agent.ts"],"sourcesContent":["import type { DeepAgentServerConfig } from '@athenaintel/agent-runtime';\nimport { useContext, useMemo } from 'react';\nimport { agentAssetIdOf } from '../catalog/agent-model-options';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\n/**\n * The collab agent a thread runs as, read from its server config lane\n * (`state.config.custom.collab_agent_id`), plus whether there is a lane at all.\n */\nexport interface AthenaThreadAgent {\n  /**\n   * The collab agent's asset id, or `null` when the lane names none: the thread is the person's\n   * own Athena assistant's.\n   */\n  agentId: string | null;\n  /** `true` once the thread has a server config lane (version > 0). */\n  configured: boolean;\n  /**\n   * `true` once the statewire host's snapshot of this thread has arrived. Before that `agentId` is\n   * `null` and `configured` is `false` whatever the thread holds, so wait for `ready` before\n   * treating \"no agent\" as an answer.\n   */\n  ready: boolean;\n}\n\n/** {@link AthenaThreadAgent} from the lane and the landed flag. Pure. */\nexport function threadAgentFromLane({\n  lane,\n  ready,\n}: {\n  lane: DeepAgentServerConfig | null;\n  ready: boolean;\n}): AthenaThreadAgent {\n  if (!ready || lane === null) return { agentId: null, configured: false, ready };\n  const value = lane.custom.collab_agent_id;\n  return {\n    agentId: typeof value === 'string' ? agentAssetIdOf(value) : null,\n    configured: true,\n    ready,\n  };\n}\n\n/**\n * The collab agent the active thread runs as, from the thread's config lane as the statewire host\n * sent it.\n *\n * `collab_agent_id` is a key the lane owns: once a thread has run, every turn runs as the agent\n * the lane names, whatever the provider's `agent` prop says (the prop seeds a new thread's lane on\n * its first send and is dropped from later sends). Read this hook to show an open thread's real\n * agent: `{ agentId: null, configured: true }` is a thread of the person's own assistant. Wait for\n * `ready`; a never-started chat stays not ready until its first send attaches it.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadAgent(): AthenaThreadAgent {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  const agent = useMemo(\n    () => (lane === null ? null : threadAgentFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n  if (agent === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadAgent must be used within <AthenaProvider>');\n  }\n  return agent;\n}\n"],"names":["agentAssetIdOf","useContext","AthenaStatewireServerLaneContext","useMemo"],"mappings":";;;;;AA0BO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGsB;AACpB,MAAI,CAAC,SAAS,SAAS,KAAM,QAAO,EAAE,SAAS,MAAM,YAAY,OAAO,MAAA;AACxE,QAAM,QAAQ,KAAK,OAAO;AAC1B,SAAO;AAAA,IACL,SAAS,OAAO,UAAU,WAAWA,kBAAAA,eAAe,KAAK,IAAI;AAAA,IAC7D,YAAY;AAAA,IACZ;AAAA,EAAA;AAEJ;AAcO,SAAS,uBAA0C;AACxD,QAAM,OAAOC,WAAAA,WAAWC,2DAAgC;AACxD,QAAM,QAAQC,WAAAA;AAAAA,IACZ,MAAO,SAAS,OAAO,OAAO,oBAAoB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC3F,CAAC,IAAI;AAAA,EAAA;AAEP,MAAI,UAAU,MAAM;AAClB,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;;;"}

package/dist/threads/use-athena-thread-agent.d.ts

@@ -0,0 +1,38 @@
+import type { DeepAgentServerConfig } from '../agent-runtime/src/index';
+/**
+ * The collab agent a thread runs as, read from its server config lane
+ * (`state.config.custom.collab_agent_id`), plus whether there is a lane at all.
+ */
+export interface AthenaThreadAgent {
+    /**
+     * The collab agent's asset id, or `null` when the lane names none: the thread is the person's
+     * own Athena assistant's.
+     */
+    agentId: string | null;
+    /** `true` once the thread has a server config lane (version > 0). */
+    configured: boolean;
+    /**
+     * `true` once the statewire host's snapshot of this thread has arrived. Before that `agentId` is
+     * `null` and `configured` is `false` whatever the thread holds, so wait for `ready` before
+     * treating "no agent" as an answer.
+     */
+    ready: boolean;
+}
+/** {@link AthenaThreadAgent} from the lane and the landed flag. Pure. */
+export declare function threadAgentFromLane({ lane, ready, }: {
+    lane: DeepAgentServerConfig | null;
+    ready: boolean;
+}): AthenaThreadAgent;
+/**
+ * The collab agent the active thread runs as, from the thread's config lane as the statewire host
+ * sent it.
+ *
+ * `collab_agent_id` is a key the lane owns: once a thread has run, every turn runs as the agent
+ * the lane names, whatever the provider's `agent` prop says (the prop seeds a new thread's lane on
+ * its first send and is dropped from later sends). Read this hook to show an open thread's real
+ * agent: `{ agentId: null, configured: true }` is a thread of the person's own assistant. Wait for
+ * `ready`; a never-started chat stays not ready until its first send attaches it.
+ *
+ * Must be used within `<AthenaProvider>`.
+ */
+export declare function useAthenaThreadAgent(): AthenaThreadAgent;

package/dist/threads/use-athena-thread-agent.js

@@ -0,0 +1,31 @@
+import { useContext, useMemo } from "react";
+import { agentAssetIdOf } from "../catalog/agent-model-options.js";
+import { AthenaStatewireServerLaneContext } from "../runtime/statewire-server-lane-context.js";
+function threadAgentFromLane({
+  lane,
+  ready
+}) {
+  if (!ready || lane === null) return { agentId: null, configured: false, ready };
+  const value = lane.custom.collab_agent_id;
+  return {
+    agentId: typeof value === "string" ? agentAssetIdOf(value) : null,
+    configured: true,
+    ready
+  };
+}
+function useAthenaThreadAgent() {
+  const lane = useContext(AthenaStatewireServerLaneContext);
+  const agent = useMemo(
+    () => lane === null ? null : threadAgentFromLane({ lane: lane.config, ready: lane.landed }),
+    [lane]
+  );
+  if (agent === null) {
+    throw new Error("[AthenaSDK] useAthenaThreadAgent must be used within <AthenaProvider>");
+  }
+  return agent;
+}
+export {
+  threadAgentFromLane,
+  useAthenaThreadAgent
+};
+//# sourceMappingURL=use-athena-thread-agent.js.map

package/dist/threads/use-athena-thread-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-agent.js","sources":["../../src/threads/use-athena-thread-agent.ts"],"sourcesContent":["import type { DeepAgentServerConfig } from '@athenaintel/agent-runtime';\nimport { useContext, useMemo } from 'react';\nimport { agentAssetIdOf } from '../catalog/agent-model-options';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\n/**\n * The collab agent a thread runs as, read from its server config lane\n * (`state.config.custom.collab_agent_id`), plus whether there is a lane at all.\n */\nexport interface AthenaThreadAgent {\n  /**\n   * The collab agent's asset id, or `null` when the lane names none: the thread is the person's\n   * own Athena assistant's.\n   */\n  agentId: string | null;\n  /** `true` once the thread has a server config lane (version > 0). */\n  configured: boolean;\n  /**\n   * `true` once the statewire host's snapshot of this thread has arrived. Before that `agentId` is\n   * `null` and `configured` is `false` whatever the thread holds, so wait for `ready` before\n   * treating \"no agent\" as an answer.\n   */\n  ready: boolean;\n}\n\n/** {@link AthenaThreadAgent} from the lane and the landed flag. Pure. */\nexport function threadAgentFromLane({\n  lane,\n  ready,\n}: {\n  lane: DeepAgentServerConfig | null;\n  ready: boolean;\n}): AthenaThreadAgent {\n  if (!ready || lane === null) return { agentId: null, configured: false, ready };\n  const value = lane.custom.collab_agent_id;\n  return {\n    agentId: typeof value === 'string' ? agentAssetIdOf(value) : null,\n    configured: true,\n    ready,\n  };\n}\n\n/**\n * The collab agent the active thread runs as, from the thread's config lane as the statewire host\n * sent it.\n *\n * `collab_agent_id` is a key the lane owns: once a thread has run, every turn runs as the agent\n * the lane names, whatever the provider's `agent` prop says (the prop seeds a new thread's lane on\n * its first send and is dropped from later sends). Read this hook to show an open thread's real\n * agent: `{ agentId: null, configured: true }` is a thread of the person's own assistant. Wait for\n * `ready`; a never-started chat stays not ready until its first send attaches it.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadAgent(): AthenaThreadAgent {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  const agent = useMemo(\n    () => (lane === null ? null : threadAgentFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n  if (agent === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadAgent must be used within <AthenaProvider>');\n  }\n  return agent;\n}\n"],"names":[],"mappings":";;;AA0BO,SAAS,oBAAoB;AAAA,EAClC;AAAA,EACA;AACF,GAGsB;AACpB,MAAI,CAAC,SAAS,SAAS,KAAM,QAAO,EAAE,SAAS,MAAM,YAAY,OAAO,MAAA;AACxE,QAAM,QAAQ,KAAK,OAAO;AAC1B,SAAO;AAAA,IACL,SAAS,OAAO,UAAU,WAAW,eAAe,KAAK,IAAI;AAAA,IAC7D,YAAY;AAAA,IACZ;AAAA,EAAA;AAEJ;AAcO,SAAS,uBAA0C;AACxD,QAAM,OAAO,WAAW,gCAAgC;AACxD,QAAM,QAAQ;AAAA,IACZ,MAAO,SAAS,OAAO,OAAO,oBAAoB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC3F,CAAC,IAAI;AAAA,EAAA;AAEP,MAAI,UAAU,MAAM;AAClB,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;"}

package/dist/threads/use-athena-thread-plan-mode.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require$$0 = require("react");
+const statewirePlanMode = require("../runtime/statewire-plan-mode.cjs");
+const statewireServerLaneContext = require("../runtime/statewire-server-lane-context.cjs");
+function useAthenaThreadPlanMode() {
+  const lane = require$$0.useContext(statewireServerLaneContext.AthenaStatewireServerLaneContext);
+  const planMode = require$$0.useMemo(
+    () => lane === null ? null : statewirePlanMode.threadPlanModeFromLane({ lane: lane.config, ready: lane.landed }),
+    [lane]
+  );
+  if (planMode === null) {
+    throw new Error("[AthenaSDK] useAthenaThreadPlanMode must be used within <AthenaProvider>");
+  }
+  return planMode;
+}
+exports.useAthenaThreadPlanMode = useAthenaThreadPlanMode;
+//# sourceMappingURL=use-athena-thread-plan-mode.cjs.map

package/dist/threads/use-athena-thread-plan-mode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-plan-mode.cjs","sources":["../../src/threads/use-athena-thread-plan-mode.ts"],"sourcesContent":["import { useContext, useMemo } from 'react';\nimport { type AthenaThreadPlanMode, threadPlanModeFromLane } from '../runtime/statewire-plan-mode';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\nexport type { AthenaThreadPlanMode };\n\n/**\n * Whether the active thread's server config plans: the agent's to-do plan\n * (`write_todos`) is on unless the thread's config lane excludes it, as the\n * statewire host sent the lane.\n *\n * Once a thread has run with server config, its lane (not the provider's\n * `planMode` prop) decides, and another client (Athena on the web, a second\n * app) can change it at any time. Read this hook when a thread opens to show\n * the thread's own plan mode in a switch: `{ planMode: null, configured: false }`\n * is a thread without server config, whose turns run with what the provider\n * sends. Wait for `ready`: until the host's snapshot of the thread has arrived\n * every thread reads as unconfigured.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadPlanMode(): AthenaThreadPlanMode {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  const planMode = useMemo(\n    () => (lane === null ? null : threadPlanModeFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n  if (planMode === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadPlanMode must be used within <AthenaProvider>');\n  }\n  return planMode;\n}\n"],"names":["useContext","AthenaStatewireServerLaneContext","useMemo","threadPlanModeFromLane"],"mappings":";;;;;AAqBO,SAAS,0BAAgD;AAC9D,QAAM,OAAOA,WAAAA,WAAWC,2DAAgC;AACxD,QAAM,WAAWC,WAAAA;AAAAA,IACf,MAAO,SAAS,OAAO,OAAOC,kBAAAA,uBAAuB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC9F,CAAC,IAAI;AAAA,EAAA;AAEP,MAAI,aAAa,MAAM;AACrB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AACA,SAAO;AACT;;"}

package/dist/threads/use-athena-thread-plan-mode.d.ts

@@ -0,0 +1,18 @@
+import { type AthenaThreadPlanMode } from '../runtime/statewire-plan-mode';
+export type { AthenaThreadPlanMode };
+/**
+ * Whether the active thread's server config plans: the agent's to-do plan
+ * (`write_todos`) is on unless the thread's config lane excludes it, as the
+ * statewire host sent the lane.
+ *
+ * Once a thread has run with server config, its lane (not the provider's
+ * `planMode` prop) decides, and another client (Athena on the web, a second
+ * app) can change it at any time. Read this hook when a thread opens to show
+ * the thread's own plan mode in a switch: `{ planMode: null, configured: false }`
+ * is a thread without server config, whose turns run with what the provider
+ * sends. Wait for `ready`: until the host's snapshot of the thread has arrived
+ * every thread reads as unconfigured.
+ *
+ * Must be used within `<AthenaProvider>`.
+ */
+export declare function useAthenaThreadPlanMode(): AthenaThreadPlanMode;

package/dist/threads/use-athena-thread-plan-mode.js

@@ -0,0 +1,18 @@
+import { useContext, useMemo } from "react";
+import { threadPlanModeFromLane } from "../runtime/statewire-plan-mode.js";
+import { AthenaStatewireServerLaneContext } from "../runtime/statewire-server-lane-context.js";
+function useAthenaThreadPlanMode() {
+  const lane = useContext(AthenaStatewireServerLaneContext);
+  const planMode = useMemo(
+    () => lane === null ? null : threadPlanModeFromLane({ lane: lane.config, ready: lane.landed }),
+    [lane]
+  );
+  if (planMode === null) {
+    throw new Error("[AthenaSDK] useAthenaThreadPlanMode must be used within <AthenaProvider>");
+  }
+  return planMode;
+}
+export {
+  useAthenaThreadPlanMode
+};
+//# sourceMappingURL=use-athena-thread-plan-mode.js.map

package/dist/threads/use-athena-thread-plan-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-plan-mode.js","sources":["../../src/threads/use-athena-thread-plan-mode.ts"],"sourcesContent":["import { useContext, useMemo } from 'react';\nimport { type AthenaThreadPlanMode, threadPlanModeFromLane } from '../runtime/statewire-plan-mode';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\nexport type { AthenaThreadPlanMode };\n\n/**\n * Whether the active thread's server config plans: the agent's to-do plan\n * (`write_todos`) is on unless the thread's config lane excludes it, as the\n * statewire host sent the lane.\n *\n * Once a thread has run with server config, its lane (not the provider's\n * `planMode` prop) decides, and another client (Athena on the web, a second\n * app) can change it at any time. Read this hook when a thread opens to show\n * the thread's own plan mode in a switch: `{ planMode: null, configured: false }`\n * is a thread without server config, whose turns run with what the provider\n * sends. Wait for `ready`: until the host's snapshot of the thread has arrived\n * every thread reads as unconfigured.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadPlanMode(): AthenaThreadPlanMode {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  const planMode = useMemo(\n    () => (lane === null ? null : threadPlanModeFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n  if (planMode === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadPlanMode must be used within <AthenaProvider>');\n  }\n  return planMode;\n}\n"],"names":[],"mappings":";;;AAqBO,SAAS,0BAAgD;AAC9D,QAAM,OAAO,WAAW,gCAAgC;AACxD,QAAM,WAAW;AAAA,IACf,MAAO,SAAS,OAAO,OAAO,uBAAuB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC9F,CAAC,IAAI;AAAA,EAAA;AAEP,MAAI,aAAa,MAAM;AACrB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AACA,SAAO;AACT;"}

package/dist/threads/use-rest-conversation-history.d.ts

@@ -25,6 +25,7 @@ export declare function useRestConversationHistory({ backendUrl, principalId, ge
     isLoading: boolean;
     isFetching: boolean;
     hasResolvedFirstPage: boolean;
+    firstPageUpdatedAt: number;
     hasNextPage: boolean;
     isFetchingNextPage: boolean;
     isFetchNextPageError: boolean;

package/dist/tools/agent-creations.cjs

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactStatewire = require("@assistant-ui/react-statewire");
+const require$$0 = require("react");
+const autoOpenTools = require("./auto-open-tools.cjs");
+const statewireState = require("../agent-runtime/src/statewire-state.cjs");
+const toolNames = require("../agent-runtime/src/tool-names.cjs");
+const subagents = require("../agent-runtime/src/subagents.cjs");
+const runningToolPlaceholder = require("../agent-runtime/src/running-tool-placeholder.cjs");
+const messageText = require("../agent-runtime/src/message-text.cjs");
+const creationsByMessage = /* @__PURE__ */ new WeakMap();
+function argsByCallId(messages) {
+  const args = /* @__PURE__ */ new Map();
+  for (const message of messages) {
+    if (message.type !== "ai" || !message.tool_calls) continue;
+    for (const call of message.tool_calls) if (call.id) args.set(call.id, call.args);
+  }
+  return args;
+}
+function agentCreationsIn(messages) {
+  const args = argsByCallId(messages);
+  const made = [];
+  for (const message of messages) {
+    if (message.type !== "tool" || !message.tool_call_id || !message.name) continue;
+    if (message.name === toolNames.TASK_TOOL_NAME) {
+      made.push(...agentCreationsIn(subagents.nestedMessagesFromArtifact(message.artifact)));
+      continue;
+    }
+    if (runningToolPlaceholder.isRunningToolPlaceholder(message)) continue;
+    let creations = creationsByMessage.get(message);
+    if (creations === void 0) {
+      creations = autoOpenTools.creationsOfCall({
+        toolCallId: message.tool_call_id,
+        tool: message.name,
+        result: typeof message.content === "string" ? message.content : messageText.getMessageText(message),
+        isError: message.status === "error",
+        artifact: message.artifact,
+        args: args.get(message.tool_call_id)
+      });
+      creationsByMessage.set(message, creations);
+    }
+    made.push(...creations);
+  }
+  return made;
+}
+function latestTurn(messages) {
+  var _a;
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    if (((_a = messages[index]) == null ? void 0 : _a.type) === "human") return messages.slice(index + 1);
+  }
+  return messages;
+}
+function createAgentCreationsReporter() {
+  let seen = null;
+  return {
+    see: ({ thread, messages }) => {
+      if (seen === null || seen.thread !== thread) {
+        seen = { thread, reported: new Set(agentCreationsIn(messages).map(({ key }) => key)) };
+        return [];
+      }
+      const reported = seen.reported;
+      const fresh = agentCreationsIn(latestTurn(messages)).filter(({ key }) => !reported.has(key));
+      for (const { key } of fresh) reported.add(key);
+      return fresh;
+    }
+  };
+}
+const selectState = (state) => state;
+function useAthenaAgentCreations({
+  onCreation,
+  enabled = true
+}) {
+  const state = reactStatewire.useStatewireState(selectState);
+  const reporter = require$$0.useRef(null);
+  const latest = require$$0.useRef(onCreation);
+  require$$0.useEffect(() => {
+    latest.current = onCreation;
+  }, [onCreation]);
+  require$$0.useEffect(() => {
+    if (!enabled) {
+      reporter.current = null;
+      return;
+    }
+    if (!statewireState.isDeepAgentStateHydrated(state)) return;
+    reporter.current ?? (reporter.current = createAgentCreationsReporter());
+    const made = reporter.current.see({
+      thread: statewireState.readDeepAgentStateThreadId(state),
+      messages: statewireState.readDeepAgentStreamValues(state).messages ?? []
+    });
+    for (const creation of made) latest.current(creation);
+  }, [state, enabled]);
+}
+exports.agentCreationsIn = agentCreationsIn;
+exports.createAgentCreationsReporter = createAgentCreationsReporter;
+exports.latestTurn = latestTurn;
+exports.useAthenaAgentCreations = useAthenaAgentCreations;
+//# sourceMappingURL=agent-creations.cjs.map

package/dist/tools/agent-creations.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-creations.cjs","sources":["../../src/tools/agent-creations.ts"],"sourcesContent":["'use client';\n\nimport type { LangChainMessage } from '@assistant-ui/react-langgraph';\nimport { useStatewireState } from '@assistant-ui/react-statewire';\nimport {\n  getMessageText,\n  isDeepAgentStateHydrated,\n  isRunningToolPlaceholder,\n  nestedMessagesFromArtifact,\n  readDeepAgentStateThreadId,\n  readDeepAgentStreamValues,\n  TASK_TOOL_NAME,\n} from '@athenaintel/agent-runtime';\nimport { useEffect, useRef } from 'react';\nimport { type AgentCreation, creationsOfCall } from './auto-open-tools';\n\n/*\n * What the agent makes, as it makes it, read off the conversation's own state: the deep agent's\n * runtime (statewire) runs no tool's `streamCall`, so the SDK's auto-open toolkit\n * (`DEFAULT_AUTO_OPEN_TOOLS`) never hears its calls answer. A host that follows the agent's work\n * (Athena's desktop app opens what it makes in a tab behind the person's) reads it here instead, as\n * Athena on the web's studio follow reads the transcript (`DeepAgentPtcStudioFollowObserver`).\n */\n\nexport type { AgentCreation } from './auto-open-tools';\n\n/** Each finished tool message's creations, kept with the message (a message never changes). */\nconst creationsByMessage = new WeakMap<object, AgentCreation[]>();\n\n/** The arguments of every tool call the AI messages in `messages` asked for, by call id. */\nfunction argsByCallId(messages: readonly LangChainMessage[]): Map<string, unknown> {\n  const args = new Map<string, unknown>();\n  for (const message of messages) {\n    if (message.type !== 'ai' || !message.tool_calls) continue;\n    for (const call of message.tool_calls) if (call.id) args.set(call.id, call.args);\n  }\n  return args;\n}\n\n/**\n * What the finished tool calls in `messages` made or showed the person (`creationsOfCall`), a\n * `task` subagent's own calls included (its transcript rides its card, running or done). A call\n * still running (its card is the backend's running placeholder) has made nothing yet.\n */\nexport function agentCreationsIn(messages: readonly LangChainMessage[]): AgentCreation[] {\n  const args = argsByCallId(messages);\n  const made: AgentCreation[] = [];\n  for (const message of messages) {\n    if (message.type !== 'tool' || !message.tool_call_id || !message.name) continue;\n    if (message.name === TASK_TOOL_NAME) {\n      made.push(...agentCreationsIn(nestedMessagesFromArtifact(message.artifact)));\n      continue;\n    }\n    if (isRunningToolPlaceholder(message)) continue;\n    let creations = creationsByMessage.get(message);\n    if (creations === undefined) {\n      creations = creationsOfCall({\n        toolCallId: message.tool_call_id,\n        tool: message.name,\n        result: typeof message.content === 'string' ? message.content : getMessageText(message),\n        isError: message.status === 'error',\n        artifact: message.artifact,\n        args: args.get(message.tool_call_id),\n      });\n      creationsByMessage.set(message, creations);\n    }\n    made.push(...creations);\n  }\n  return made;\n}\n\n/**\n * The messages of the conversation's latest turn: everything after the person's last message. What\n * the agent makes now is there; older history a page loads in never is.\n */\nexport function latestTurn(messages: readonly LangChainMessage[]): readonly LangChainMessage[] {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    if (messages[index]?.type === 'human') return messages.slice(index + 1);\n  }\n  return messages;\n}\n\n/** Tells a host what the agent makes, once each, from the states its conversation goes through. */\nexport interface AgentCreationsReporter {\n  /**\n   * A state of the conversation: what its latest turn made since the last one, never reported\n   * before. Everything a thread's first state holds (its history, a run already under way when it\n   * was opened) is history: nothing of it is reported. A state of another thread starts again.\n   */\n  see(params: { thread: string | null; messages: readonly LangChainMessage[] }): AgentCreation[];\n}\n\nexport function createAgentCreationsReporter(): AgentCreationsReporter {\n  let seen: { thread: string | null; reported: Set<string> } | null = null;\n  return {\n    see: ({ thread, messages }) => {\n      if (seen === null || seen.thread !== thread) {\n        seen = { thread, reported: new Set(agentCreationsIn(messages).map(({ key }) => key)) };\n        return [];\n      }\n      const reported = seen.reported;\n      const fresh = agentCreationsIn(latestTurn(messages)).filter(({ key }) => !reported.has(key));\n      for (const { key } of fresh) reported.add(key);\n      return fresh;\n    },\n  };\n}\n\nconst selectState = (state: unknown): unknown => state;\n\n/**\n * Calls `onCreation` once for each asset the agent makes in this conversation (a create tool, a\n * studio script's `Create*`) or opens for the person to see (`open_asset_in_workspace`), as its\n * call finishes: never for history, a call that failed or was refused, or a call that only read or\n * changed an asset. Render it inside `AthenaChat` (a `composer` slot, a `components` override),\n * where the conversation's state is read. Nothing is read while `enabled` is false.\n */\nexport function useAthenaAgentCreations({\n  onCreation,\n  enabled = true,\n}: {\n  onCreation: (creation: AgentCreation) => void;\n  enabled?: boolean;\n}): void {\n  const state = useStatewireState(selectState);\n  const reporter = useRef<AgentCreationsReporter | null>(null);\n  const latest = useRef(onCreation);\n  useEffect(() => {\n    latest.current = onCreation;\n  }, [onCreation]);\n  useEffect(() => {\n    if (!enabled) {\n      reporter.current = null;\n      return;\n    }\n    if (!isDeepAgentStateHydrated(state)) return;\n    reporter.current ??= createAgentCreationsReporter();\n    const made = reporter.current.see({\n      thread: readDeepAgentStateThreadId(state),\n      messages: readDeepAgentStreamValues(state).messages ?? [],\n    });\n    for (const creation of made) latest.current(creation);\n  }, [state, enabled]);\n}\n"],"names":["TASK_TOOL_NAME","nestedMessagesFromArtifact","isRunningToolPlaceholder","creationsOfCall","getMessageText","useStatewireState","useRef","useEffect","isDeepAgentStateHydrated","readDeepAgentStateThreadId","readDeepAgentStreamValues"],"mappings":";;;;;;;;;;AA2BA,MAAM,yCAAyB,QAAA;AAG/B,SAAS,aAAa,UAA6D;AACjF,QAAM,2BAAW,IAAA;AACjB,aAAW,WAAW,UAAU;AAC9B,QAAI,QAAQ,SAAS,QAAQ,CAAC,QAAQ,WAAY;AAClD,eAAW,QAAQ,QAAQ,WAAY,KAAI,KAAK,GAAI,MAAK,IAAI,KAAK,IAAI,KAAK,IAAI;AAAA,EACjF;AACA,SAAO;AACT;AAOO,SAAS,iBAAiB,UAAwD;AACvF,QAAM,OAAO,aAAa,QAAQ;AAClC,QAAM,OAAwB,CAAA;AAC9B,aAAW,WAAW,UAAU;AAC9B,QAAI,QAAQ,SAAS,UAAU,CAAC,QAAQ,gBAAgB,CAAC,QAAQ,KAAM;AACvE,QAAI,QAAQ,SAASA,0BAAgB;AACnC,WAAK,KAAK,GAAG,iBAAiBC,UAAAA,2BAA2B,QAAQ,QAAQ,CAAC,CAAC;AAC3E;AAAA,IACF;AACA,QAAIC,uBAAAA,yBAAyB,OAAO,EAAG;AACvC,QAAI,YAAY,mBAAmB,IAAI,OAAO;AAC9C,QAAI,cAAc,QAAW;AAC3B,kBAAYC,cAAAA,gBAAgB;AAAA,QAC1B,YAAY,QAAQ;AAAA,QACpB,MAAM,QAAQ;AAAA,QACd,QAAQ,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAUC,YAAAA,eAAe,OAAO;AAAA,QACtF,SAAS,QAAQ,WAAW;AAAA,QAC5B,UAAU,QAAQ;AAAA,QAClB,MAAM,KAAK,IAAI,QAAQ,YAAY;AAAA,MAAA,CACpC;AACD,yBAAmB,IAAI,SAAS,SAAS;AAAA,IAC3C;AACA,SAAK,KAAK,GAAG,SAAS;AAAA,EACxB;AACA,SAAO;AACT;AAMO,SAAS,WAAW,UAAoE;;AAC7F,WAAS,QAAQ,SAAS,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG;AAC5D,UAAI,cAAS,KAAK,MAAd,mBAAiB,UAAS,QAAS,QAAO,SAAS,MAAM,QAAQ,CAAC;AAAA,EACxE;AACA,SAAO;AACT;AAYO,SAAS,+BAAuD;AACrE,MAAI,OAAgE;AACpE,SAAO;AAAA,IACL,KAAK,CAAC,EAAE,QAAQ,eAAe;AAC7B,UAAI,SAAS,QAAQ,KAAK,WAAW,QAAQ;AAC3C,eAAO,EAAE,QAAQ,UAAU,IAAI,IAAI,iBAAiB,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAA,MAAU,GAAG,CAAC,EAAA;AACnF,eAAO,CAAA;AAAA,MACT;AACA,YAAM,WAAW,KAAK;AACtB,YAAM,QAAQ,iBAAiB,WAAW,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,IAAI,GAAG,CAAC;AAC3F,iBAAW,EAAE,IAAA,KAAS,MAAO,UAAS,IAAI,GAAG;AAC7C,aAAO;AAAA,IACT;AAAA,EAAA;AAEJ;AAEA,MAAM,cAAc,CAAC,UAA4B;AAS1C,SAAS,wBAAwB;AAAA,EACtC;AAAA,EACA,UAAU;AACZ,GAGS;AACP,QAAM,QAAQC,eAAAA,kBAAkB,WAAW;AAC3C,QAAM,WAAWC,WAAAA,OAAsC,IAAI;AAC3D,QAAM,SAASA,WAAAA,OAAO,UAAU;AAChCC,aAAAA,UAAU,MAAM;AACd,WAAO,UAAU;AAAA,EACnB,GAAG,CAAC,UAAU,CAAC;AACfA,aAAAA,UAAU,MAAM;AACd,QAAI,CAAC,SAAS;AACZ,eAAS,UAAU;AACnB;AAAA,IACF;AACA,QAAI,CAACC,eAAAA,yBAAyB,KAAK,EAAG;AACtC,aAAS,YAAT,SAAS,UAAY,6BAAA;AACrB,UAAM,OAAO,SAAS,QAAQ,IAAI;AAAA,MAChC,QAAQC,eAAAA,2BAA2B,KAAK;AAAA,MACxC,UAAUC,eAAAA,0BAA0B,KAAK,EAAE,YAAY,CAAA;AAAA,IAAC,CACzD;AACD,eAAW,YAAY,KAAM,QAAO,QAAQ,QAAQ;AAAA,EACtD,GAAG,CAAC,OAAO,OAAO,CAAC;AACrB;;;;;"}

package/dist/tools/agent-creations.d.ts

@@ -0,0 +1,38 @@
+import type { LangChainMessage } from '@assistant-ui/react-langgraph';
+import { type AgentCreation } from './auto-open-tools';
+export type { AgentCreation } from './auto-open-tools';
+/**
+ * What the finished tool calls in `messages` made or showed the person (`creationsOfCall`), a
+ * `task` subagent's own calls included (its transcript rides its card, running or done). A call
+ * still running (its card is the backend's running placeholder) has made nothing yet.
+ */
+export declare function agentCreationsIn(messages: readonly LangChainMessage[]): AgentCreation[];
+/**
+ * The messages of the conversation's latest turn: everything after the person's last message. What
+ * the agent makes now is there; older history a page loads in never is.
+ */
+export declare function latestTurn(messages: readonly LangChainMessage[]): readonly LangChainMessage[];
+/** Tells a host what the agent makes, once each, from the states its conversation goes through. */
+export interface AgentCreationsReporter {
+    /**
+     * A state of the conversation: what its latest turn made since the last one, never reported
+     * before. Everything a thread's first state holds (its history, a run already under way when it
+     * was opened) is history: nothing of it is reported. A state of another thread starts again.
+     */
+    see(params: {
+        thread: string | null;
+        messages: readonly LangChainMessage[];
+    }): AgentCreation[];
+}
+export declare function createAgentCreationsReporter(): AgentCreationsReporter;
+/**
+ * Calls `onCreation` once for each asset the agent makes in this conversation (a create tool, a
+ * studio script's `Create*`) or opens for the person to see (`open_asset_in_workspace`), as its
+ * call finishes: never for history, a call that failed or was refused, or a call that only read or
+ * changed an asset. Render it inside `AthenaChat` (a `composer` slot, a `components` override),
+ * where the conversation's state is read. Nothing is read while `enabled` is false.
+ */
+export declare function useAthenaAgentCreations({ onCreation, enabled, }: {
+    onCreation: (creation: AgentCreation) => void;
+    enabled?: boolean;
+}): void;