@athenaintel/react 0.30.0 → 0.35.0

package/dist/threads/api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.cjs","sources":["../../src/threads/api.ts"],"sourcesContent":["/**\n * Athena thread API client.\n * Calls existing REST endpoints for thread CRUD.\n */\n\nimport type {\n  ConversationAttention,\n  ConversationAttentionSource,\n} from '@athenaintel/agent-runtime';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError, type AthenaSdkErrorCode, isAthenaSdkError } from '../diagnostics/errors';\n\n/**\n * Live GitHub state of a pull request the thread opened, read by the server\n * when the list renders (agora `agent_pr_threads` is the only stored link).\n */\nexport interface ThreadPullRequest {\n  /** `owner/repo` the pull request lives in. */\n  repo_full_name: string;\n  number: number;\n  url: string;\n  title: string;\n  state: 'OPEN' | 'CLOSED' | 'MERGED';\n  is_draft: boolean;\n  /** GitHub's review decision (APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED) or null. */\n  review_decision: string | null;\n  /** Combined state of the checks on the head commit. */\n  checks_state: 'SUCCESS' | 'FAILURE' | 'PENDING' | 'NONE';\n  /** ISO 8601 timestamp of the pull request's last update on GitHub. */\n  updated_at: string;\n}\n\n/** The last event that woke a resting thread (a GitHub webhook, a schedule, a handoff). */\nexport interface ThreadWake {\n  source: string | null;\n  reason: string | null;\n  /** ISO 8601 timestamp of the wake. */\n  at: string | null;\n}\n\nexport interface ThreadSummary {\n  thread_id: string;\n  title: string;\n  created_at: string;\n  updated_at: string;\n  last_message: string | null;\n  message_count: number;\n  state: string | null;\n  start_channel?: string | null;\n  last_channel?: string | null;\n  /** Client app that created the session (SESSION_APP_ID_GUIDE). */\n  app_id?: string | null;\n  /** Collab agent and channel the session started on; older servers omit them. */\n  collab_agent_id?: string | null;\n  collab_channel_id?: string | null;\n  /** Trigger marker for automated/background sessions. */\n  trigger_type?: string | null;\n  /** Whether the calling user has seen this thread since it last changed. */\n  is_unread?: boolean;\n  /**\n   * Canonical status_v2 planes (`idle | active | needs_input | error` and\n   * `scheduled | queued | running | needs_input | completed | failed |\n   * canceled`); older servers omit them.\n   */\n  session_status?: string | null;\n  run_status?: string | null;\n  /**\n   * The viewer's attention state, the one-line next action (≤ 80 chars) and\n   * the signal that produced them, derived server-side; older servers omit them.\n   */\n  attention?: ConversationAttention | null;\n  next_action?: string | null;\n  attention_source?: ConversationAttentionSource | null;\n  /** Whether the calling user favorited (pinned) the thread; older servers omit it. */\n  is_favorited?: boolean;\n  /** The last wake of a resting thread; older servers omit it. */\n  last_wake?: ThreadWake | null;\n  /** Whether the calling user started the thread (`false`: shared with them); older servers omit it. */\n  created_by_me?: boolean;\n  /**\n   * Pull requests the thread opened with their live GitHub state. `[]` when\n   * it opened none, `null` when the state could not be read right now;\n   * older servers omit the field.\n   */\n  pull_requests?: ThreadPullRequest[] | null;\n}\n\n/**\n * True for fetch cancellations (unmount/remount aborts, StrictMode double\n * effects). These are lifecycle noise, not failures: emitting them as\n * `*.error` diagnostics floods the console with\n * \"signal is aborted without reason\" for requests the caller itself aborted.\n */\nfunction isAbortError(error: unknown): boolean {\n  return (\n    (error instanceof DOMException && error.name === 'AbortError') ||\n    (error instanceof Error && error.name === 'AbortError')\n  );\n}\n\nexport interface ThreadListResponse {\n  threads: ThreadSummary[];\n  /** Server lookahead result. Older servers may omit this field. */\n  has_more?: boolean;\n  /**\n   * Every request field the server applies beyond paging. The server ignores\n   * fields it does not know, so a filter missing from this list came back\n   * unapplied; servers that predate the list omit it (none of the\n   * `ThreadListFilterBody` fields are applied there).\n   */\n  supported_filters?: string[];\n}\n\n/**\n * The server-side filters and order of `POST /api/conversations/threads/list`\n * beyond the original `app_id` / `start_channel` / `search` /\n * `exclude_triggered` set. Each is a predicate of the server's one page\n * statement, so a page is exact; a server that predates a field ignores it\n * (check `ThreadListResponse.supported_filters`).\n */\nexport interface ThreadListFilterBody {\n  /** Original fields, accepted here too so one body can carry a whole query. */\n  search?: string;\n  exclude_triggered?: boolean;\n  app_ids?: string[];\n  start_channels?: string[];\n  created_after?: string;\n  created_before?: string;\n  updated_after?: string;\n  updated_before?: string;\n  collab_agent_ids?: string[];\n  /** `'default'` matches the agent's default channel (no channel stamp); needs `collab_agent_ids`. */\n  collab_channel_ids?: string[];\n  favorites_only?: boolean;\n  unread_only?: boolean;\n  run_statuses?: string[];\n  session_statuses?: string[];\n  has_pull_requests?: boolean;\n  created_by_me?: boolean;\n  exclude_dismissed?: boolean;\n  sort?: 'updated' | 'created';\n  direction?: 'desc' | 'asc';\n}\n\nexport interface ThreadCreateResponse {\n  thread_id: string;\n}\n\ninterface AuthConfig {\n  apiKey?: string;\n  token?: string | null;\n}\n\nfunction getAuthHeaders(auth: AuthConfig): Record<string, string> {\n  if (auth.token) {\n    return { Authorization: `Bearer ${auth.token}` };\n  }\n  if (auth.apiKey) {\n    return { 'X-API-KEY': auth.apiKey };\n  }\n  return {};\n}\n\n/**\n * Resolves the Athena API base URL from backendUrl.\n * Thread endpoints live under `/api/conversations/threads/*` and `/api/unstable/threads/`.\n * If backendUrl points at a nested Athena endpoint, trim it back to the API base first.\n */\nfunction getAthenaApiBaseUrl(backendUrl: string): string {\n  const stripped = backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '');\n  // If the suffix wasn't found, assume the URL already points to the API base\n  if (stripped === backendUrl) {\n    return backendUrl.replace(/\\/$/, '');\n  }\n  return stripped;\n}\n\nexport async function listThreads(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: {\n    limit?: number;\n    offset?: number;\n    exclude_triggered?: boolean;\n    app_id?: string;\n    start_channel?: string;\n    search?: string;\n    /** Ask the server for live GitHub state on `pull_requests` (off by default: it costs a lookup). */\n    include_pull_requests?: boolean;\n    /** Server-side filters and order beyond the original set (see `ThreadListFilterBody`). */\n    filters?: ThreadListFilterBody;\n    signal?: AbortSignal;\n  } = {},\n): Promise<ThreadListResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const endSpan = athenaDiagnostics.span('threads.list', 'threads.list.start', {\n    auth_mode: getAuthMode(auth),\n    app_id: opts.app_id,\n  });\n  try {\n    const res = await fetch(`${base}/api/conversations/threads/list`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n      signal: opts.signal ?? null,\n      body: JSON.stringify({\n        limit: opts.limit ?? 50,\n        offset: opts.offset ?? 0,\n        // Default to the full recent-conversations set unless a caller\n        // explicitly asks to hide triggered/background sessions.\n        exclude_triggered: opts.exclude_triggered ?? false,\n        ...(opts.app_id ? { app_id: opts.app_id } : {}),\n        ...(opts.start_channel ? { start_channel: opts.start_channel } : {}),\n        ...(opts.search ? { search: opts.search } : {}),\n        ...(opts.include_pull_requests ? { include_pull_requests: true } : {}),\n        ...opts.filters,\n      }),\n    });\n    if (!res.ok) {\n      throw new AthenaSdkError({\n        code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n        message: `Failed to list threads: ${res.status}`,\n        status: res.status,\n        hint:\n          res.status === 401 || res.status === 403\n            ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n            : 'Check backendUrl points at the Agora API base.',\n        context: { auth_mode: getAuthMode(auth) },\n      });\n    }\n    const data = (await res.json()) as ThreadListResponse;\n    endSpan('threads.list.done', { data: { count: data.threads?.length ?? 0 } });\n    return data;\n  } catch (error) {\n    // Cancellation is lifecycle noise (unmount/remount aborts): log it as an\n    // informational abort, not an error — passing `error` would force the\n    // span end to error level and spam the console.\n    if (isAbortError(error)) {\n      endSpan('threads.list.aborted', { data: { reason: 'request aborted' } });\n    } else {\n      endSpan('threads.list.error', { error });\n    }\n    throw error;\n  }\n}\n\n/** The `(workspace, user)` pair the credential resolves to on the backend. */\nexport interface AccountIdentity {\n  userId: string;\n  /** `null` for a user with no current workspace. */\n  workspaceId: string | null;\n}\n\n/**\n * Resolve the credential's agora identity. The conversation index is one\n * statewire instance per `(workspace, user)`, and neither half is knowable\n * from the credential alone: the SDK's auth context carries an identity\n * provider user id, not agora's, and never a workspace.\n */\nexport async function fetchAccountIdentity(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { signal?: AbortSignal } = {},\n): Promise<AccountIdentity> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/v0/me`, {\n    headers: getAuthHeaders(auth),\n    signal: opts.signal ?? null,\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n      message: `Failed to resolve account identity: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 401 || res.status === 403\n          ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n          : 'Check backendUrl points at the Agora API base.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  const body = (await res.json()) as { user_id?: unknown; workspace_id?: unknown };\n  if (typeof body.user_id !== 'string' || body.user_id.length === 0) {\n    throw new AthenaSdkError({\n      code: 'threads_list_failed',\n      message: 'Account identity lookup returned no user id.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  return {\n    userId: body.user_id,\n    workspaceId: typeof body.workspace_id === 'string' ? body.workspace_id : null,\n  };\n}\n\nexport interface ThreadReadStateResponse {\n  thread_id: string;\n  is_unread: boolean;\n}\n\n/** Store the calling user's read receipt for a thread. */\nexport async function setThreadReadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isUnread: boolean },\n): Promise<ThreadReadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/read-state`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_unread: opts.isUnread,\n    }),\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'unknown',\n      message: `Failed to set thread read state: ${res.status}`,\n      status: res.status,\n    });\n  }\n  return res.json();\n}\n\nexport interface ThreadInboxDismissResponse {\n  success: boolean;\n  dismissed: boolean;\n}\n\n/**\n * Dismiss a session from the inbox, or bring it back\n * (`POST /api/conversations/threads/notifications/dismiss`). A dismissed\n * session returns on its own with its next message. The state lives on the\n * session for its creator's inbox, so the route takes EDIT on the session\n * (403 for a VIEW share).\n */\nexport async function dismissThreadFromInbox(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; dismissed: boolean },\n): Promise<ThreadInboxDismissResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/notifications/dismiss`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({ thread_id: opts.threadId, dismissed: opts.dismissed }),\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'unknown',\n      message: `Failed to ${opts.dismissed ? 'dismiss' : 'restore'} the session: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 403\n          ? 'Only someone who can edit the session (its creator, usually) can dismiss it from the inbox.'\n          : undefined,\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth) },\n    });\n  }\n  return res.json();\n}\n\nexport interface ThreadFavoriteResponse {\n  thread_id: string;\n  /** The server's state after the write. */\n  is_favorited: boolean;\n}\n\n/**\n * Classify a 4xx from one of the per-thread write routes (`favorite`,\n * `rename`, `archive`). A 404 there is ambiguous: FastAPI answers\n * `{\"detail\":\"Not Found\"}` for a route an older agora does not have, the\n * archive route answers `\"Endpoint not available\"` on an agora without the\n * checkpointer — and each route answers 404 for a thread that no longer\n * exists (`\"Thread <id> not found\"`, `\"Conversation with langchain thread id\n * <id> not found\"`). The routes' own not-found answers name the thread, so a\n * body that does not is the ROUTE missing, and only that withdraws the\n * feature; a stale row must not disable the action for every other row.\n */\nfunction classifyThreadRouteRejection(\n  status: number,\n  body: string,\n  threadId: string,\n): { routeMissing: boolean; detail: unknown } {\n  let detail: unknown = body || undefined;\n  try {\n    const parsed: unknown = JSON.parse(body);\n    if (parsed && typeof parsed === 'object') {\n      const record = parsed as { detail?: unknown; message?: unknown };\n      detail = record.detail ?? record.message ?? parsed;\n    }\n  } catch {\n    // A non-JSON body (a proxy page) is kept as text.\n  }\n  const routeMissing = status === 405 || (status === 404 && !mentionsThread(body, threadId));\n  return { routeMissing, detail };\n}\n\n/**\n * Whether an error body names the thread as a whole token (the routes embed\n * the id between spaces: `Thread <id> not found`); a substring match would\n * let a short id match a letter inside `\"detail\"`.\n */\nfunction mentionsThread(body: string, threadId: string): boolean {\n  if (!threadId) return false;\n  const escaped = threadId.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  return new RegExp(`(^|[^A-Za-z0-9_-])${escaped}($|[^A-Za-z0-9_-])`).test(body);\n}\n\n/** True when a per-thread write was rejected because the backend has no such route. */\nfunction isThreadRouteUnavailableError(error: unknown, code: AthenaSdkErrorCode): boolean {\n  return isAthenaSdkError(error) && error.code === code && error.context.route_missing === true;\n}\n\n/**\n * Pin (favorite) or unpin a thread for the calling user. The response is the\n * server's truth after the write. Rejections: 401 / 403 when the caller\n * cannot view the thread (`auth_rejected`), otherwise `thread_favorite_failed`\n * with the HTTP status — 404 / 405 from an agora that predates the route,\n * which `isThreadFavoriteUnavailableError` recognizes so callers can fall\n * back to a read-only pin.\n */\nexport async function setThreadFavorite(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isFavorited: boolean },\n): Promise<ThreadFavoriteResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/favorite`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_favorited: opts.isFavorited,\n    }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      opts.threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_favorite_failed',\n      message: `Failed to set thread favorite: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot view this thread.'\n        : routeMissing\n          ? 'The backend has no favorite route yet (older agora); the pin stays read-only until it deploys.'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n  return res.json();\n}\n\n/**\n * True when `setThreadFavorite` failed because the backend has no favorite\n * route (a 405, or a 404 whose body does not name the thread — see\n * `classifyThreadRouteRejection`); a 404 for a thread that is gone is a\n * per-row failure and leaves the toggle available.\n */\nexport function isThreadFavoriteUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_favorite_failed');\n}\n\nexport interface ThreadRenameResponse {\n  thread_id: string;\n  /** The stored title after the write (trimmed by the server). */\n  title: string;\n}\n\n/** The longest title the rename route accepts; the server answers 422 past it. */\nexport const THREAD_TITLE_MAX_LENGTH = 200;\n\n/**\n * Rename a thread for every viewer (`POST /api/conversations/threads/rename`).\n * The server trims the title and stores 1–200 characters; the response is the\n * row's title after the write. Rejections: 401 / 403 when the caller cannot\n * edit the thread (`auth_rejected` — a viewer can pin a shared session but not\n * retitle it), otherwise `thread_rename_failed` with the HTTP status — 404 /\n * 405 from an agora that predates the route, which\n * `isThreadRenameUnavailableError` recognizes so callers can drop the action.\n */\nexport async function renameThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; title: string },\n): Promise<ThreadRenameResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/rename`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      title: opts.title,\n    }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      opts.threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_rename_failed',\n      message: `Failed to rename thread: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot edit this thread (a viewer can pin a shared session, not retitle it).'\n        : routeMissing\n          ? 'The backend has no rename route yet (older agora); sessions cannot be renamed from here until it deploys.'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : res.status === 422\n              ? `The title must be 1–${THREAD_TITLE_MAX_LENGTH} characters after trimming.`\n              : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n  return res.json();\n}\n\n/**\n * True when `renameThread` failed because the backend has no rename route\n * (a 405, or a 404 whose body does not name the thread); a 404 for a thread\n * that is gone is a per-row failure and leaves the action offered.\n */\nexport function isThreadRenameUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_rename_failed');\n}\n\n/**\n * True when `archiveThread` failed because the backend offers no archive\n * route: a 405, FastAPI's bare 404 on an agora without the route, or the\n * route's own `\"Endpoint not available\"` 404 on an agora without the\n * checkpointer. The route's `\"Thread <id> not found\"` 404 for a stale row is\n * a per-row failure and leaves the action offered on every other row.\n */\nexport function isThreadArchiveUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_archive_failed');\n}\n\nexport async function createThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { systemPrompt?: string; enabledTools?: string[]; appId?: string } = {},\n): Promise<ThreadCreateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/unstable/threads/`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      config: {\n        system_prompt: opts.systemPrompt ?? '',\n        enabled_tools: opts.enabledTools,\n        ...(opts.appId ? { app_id: opts.appId } : {}),\n      },\n    }),\n  });\n  if (!res.ok) {\n    throw new Error(`[AthenaSDK] Failed to create thread: ${res.status}`);\n  }\n  return res.json();\n}\n\nexport interface ThreadStateResponse {\n  thread_id: string;\n  messages: unknown[];\n  status?: string;\n  [key: string]: unknown;\n}\n\ninterface ConversationThreadResponse {\n  thread?: {\n    thread_id?: string;\n    state?: string | null;\n    channel_values?: Record<string, unknown> | null;\n    messages?: unknown[] | null;\n  } | null;\n  thread_found?: boolean;\n}\n\n/**\n * Deserialize a LangChain serialized message.\n * The API returns messages in `{lc, type: \"constructor\", id, kwargs}` format.\n * We need the plain format: `{type: \"human\", content: \"...\", id: \"...\"}`.\n */\nfunction deserializeMessage(msg: unknown): unknown {\n  if (\n    msg &&\n    typeof msg === 'object' &&\n    'lc' in msg &&\n    'kwargs' in msg &&\n    (msg as Record<string, unknown>).type === 'constructor'\n  ) {\n    const kwargs = (msg as { kwargs: Record<string, unknown> }).kwargs;\n\n    // Recursively deserialize nested content without mutating the original\n    const deserializedToolCalls = Array.isArray(kwargs.tool_calls)\n      ? kwargs.tool_calls.map((tc: unknown) => {\n          if (tc && typeof tc === 'object' && 'lc' in tc && 'kwargs' in tc) {\n            return (tc as { kwargs: unknown }).kwargs;\n          }\n          return tc;\n        })\n      : kwargs.tool_calls;\n\n    return { ...kwargs, tool_calls: deserializedToolCalls };\n  }\n  return msg;\n}\n\n/** Return a non-sensitive auth label for request diagnostics. */\nfunction getAuthMode(auth: AuthConfig): 'bearer' | 'api-key' | 'none' {\n  if (auth.token) {\n    return 'bearer';\n  }\n  if (auth.apiKey) {\n    return 'api-key';\n  }\n  return 'none';\n}\n\n/** Safely read a response body for error messages without masking the root failure. */\nfunction getResponseErrorBody(response: Response): Promise<string> {\n  return response.text().catch(() => '');\n}\n\n/**\n * Fetch persisted thread state from the conversations API.\n *\n * This endpoint is the same source used by Athena's conversation sidebar and\n * supports API-key auth plus BYO SSO session tokens sent as Bearer tokens.\n */\nexport async function getThreadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  threadId: string,\n  opts: {\n    /**\n     * Bypass the server's Redis thread cache and read the checkpoint (default\n     * `true`, the history load's contract). A warm-up read that only seeds a\n     * first paint passes `false`: the cached copy is cheaper and the attach\n     * snapshot replaces it anyway.\n     */\n    skipCache?: boolean;\n    signal?: AbortSignal;\n  } = {},\n): Promise<ThreadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const authMode = getAuthMode(auth);\n  const endpoint = `${base}/api/conversations/threads/get`;\n\n  const endSpan = athenaDiagnostics.span('threads.history', 'threads.history.start', {\n    thread_id: threadId,\n    auth_mode: authMode,\n  });\n\n  let res: Response;\n  try {\n    res = await fetch(endpoint, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n      signal: opts.signal ?? null,\n      body: JSON.stringify({\n        thread_id: threadId,\n        skip_cache: opts.skipCache ?? true,\n      }),\n    });\n  } catch (error) {\n    if (isAbortError(error)) {\n      endSpan('threads.history.aborted', {\n        data: { thread_id: threadId, reason: 'request aborted' },\n      });\n    } else {\n      endSpan('threads.history.error', { error, data: { thread_id: threadId } });\n    }\n    throw error;\n  }\n  if (!res.ok) {\n    const body = await getResponseErrorBody(res);\n    const error = new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'thread_load_failed',\n      message: `Failed to get thread state: ${res.status} (${authMode})${\n        body ? `: ${body.slice(0, 300)}` : ''\n      }`,\n      status: res.status,\n      hint: 'A brand-new thread may not be persisted yet; anything else means the credential or backendUrl is wrong.',\n      context: { thread_id: threadId, auth_mode: authMode },\n    });\n    endSpan('threads.history.error', { error, data: { thread_id: threadId } });\n    throw error;\n  }\n  const data = (await res.json()) as ConversationThreadResponse;\n  const channelMessages = data.thread?.channel_values?.messages;\n  endSpan('threads.history.done', {\n    data: {\n      thread_id: threadId,\n      found: data.thread_found !== false,\n      message_count: Array.isArray(channelMessages)\n        ? channelMessages.length\n        : (data.thread?.messages?.length ?? 0),\n    },\n  });\n  const thread = data.thread;\n\n  if (data.thread_found === false || !thread) {\n    return {\n      thread_id: threadId,\n      messages: [],\n    };\n  }\n\n  const channelValues = thread.channel_values ?? {};\n  const rawMessages = Array.isArray(channelValues.messages)\n    ? channelValues.messages\n    : Array.isArray(thread.messages)\n      ? thread.messages\n      : [];\n\n  return {\n    ...channelValues,\n    thread_id: thread.thread_id ?? threadId,\n    messages: rawMessages.map(deserializeMessage),\n    ...(thread.state ? { status: thread.state } : {}),\n  };\n}\n\n/**\n * Archive a thread (`POST /api/conversations/threads/archive`): it leaves\n * every list but keeps its state. Rejections: 401 / 403 when the caller\n * cannot access the thread (`auth_rejected`), otherwise\n * `thread_archive_failed` with the HTTP status — 404 / 405 when the backend\n * has no archive route, which `isThreadArchiveUnavailableError` recognizes.\n */\nexport async function archiveThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  threadId: string,\n): Promise<void> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/archive`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({ thread_id: threadId }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_archive_failed',\n      message: `Failed to archive thread: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot access this thread.'\n        : routeMissing\n          ? 'The backend has no archive route (no checkpointer, or an older agora).'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n}\n"],"names":["athenaDiagnostics","AthenaSdkError","isAthenaSdkError"],"mappings":"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"}
+{"version":3,"file":"api.cjs","sources":["../../src/threads/api.ts"],"sourcesContent":["/**\n * Athena thread API client.\n * Calls existing REST endpoints for thread CRUD.\n */\n\nimport type {\n  ConversationAttention,\n  ConversationAttentionSource,\n} from '@athenaintel/agent-runtime';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError, type AthenaSdkErrorCode, isAthenaSdkError } from '../diagnostics/errors';\n\n/**\n * Live GitHub state of a pull request the thread opened, read by the server\n * when the list renders (agora `agent_pr_threads` is the only stored link).\n */\nexport interface ThreadPullRequest {\n  /** `owner/repo` the pull request lives in. */\n  repo_full_name: string;\n  number: number;\n  url: string;\n  title: string;\n  state: 'OPEN' | 'CLOSED' | 'MERGED';\n  is_draft: boolean;\n  /** GitHub's review decision (APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED) or null. */\n  review_decision: string | null;\n  /** Combined state of the checks on the head commit. */\n  checks_state: 'SUCCESS' | 'FAILURE' | 'PENDING' | 'NONE';\n  /** ISO 8601 timestamp of the pull request's last update on GitHub. */\n  updated_at: string;\n}\n\n/** The last event that woke a resting thread (a GitHub webhook, a schedule, a handoff). */\nexport interface ThreadWake {\n  source: string | null;\n  reason: string | null;\n  /** ISO 8601 timestamp of the wake. */\n  at: string | null;\n}\n\nexport interface ThreadSummary {\n  thread_id: string;\n  title: string;\n  created_at: string;\n  updated_at: string;\n  last_message: string | null;\n  message_count: number;\n  state: string | null;\n  start_channel?: string | null;\n  last_channel?: string | null;\n  /** Client app that created the session (SESSION_APP_ID_GUIDE). */\n  app_id?: string | null;\n  /** Collab agent and channel the session started on; older servers omit them. */\n  collab_agent_id?: string | null;\n  collab_channel_id?: string | null;\n  /** Trigger marker for automated/background sessions. */\n  trigger_type?: string | null;\n  /** Whether the calling user has seen this thread since it last changed. */\n  is_unread?: boolean;\n  /**\n   * Canonical status_v2 planes (`idle | active | needs_input | error` and\n   * `scheduled | queued | running | needs_input | completed | failed |\n   * canceled`); older servers omit them.\n   */\n  session_status?: string | null;\n  run_status?: string | null;\n  /**\n   * The viewer's attention state, the one-line next action (≤ 80 chars) and\n   * the signal that produced them, derived server-side; older servers omit them.\n   */\n  attention?: ConversationAttention | null;\n  next_action?: string | null;\n  attention_source?: ConversationAttentionSource | null;\n  /** Whether the calling user favorited (pinned) the thread; older servers omit it. */\n  is_favorited?: boolean;\n  /** The last wake of a resting thread; older servers omit it. */\n  last_wake?: ThreadWake | null;\n  /** Whether the calling user started the thread (`false`: shared with them); older servers omit it. */\n  created_by_me?: boolean;\n  /**\n   * Pull requests the thread opened with their live GitHub state. `[]` when\n   * it opened none, `null` when the state could not be read right now;\n   * older servers omit the field.\n   */\n  pull_requests?: ThreadPullRequest[] | null;\n}\n\n/**\n * True for fetch cancellations (unmount/remount aborts, StrictMode double\n * effects). These are lifecycle noise, not failures: emitting them as\n * `*.error` diagnostics floods the console with\n * \"signal is aborted without reason\" for requests the caller itself aborted.\n */\nfunction isAbortError(error: unknown): boolean {\n  return (\n    (error instanceof DOMException && error.name === 'AbortError') ||\n    (error instanceof Error && error.name === 'AbortError')\n  );\n}\n\nexport interface ThreadListResponse {\n  threads: ThreadSummary[];\n  /** Server lookahead result. Older servers may omit this field. */\n  has_more?: boolean;\n  /**\n   * Every request field the server applies beyond paging. The server ignores\n   * fields it does not know, so a filter missing from this list came back\n   * unapplied; servers that predate the list omit it (none of the\n   * `ThreadListFilterBody` fields are applied there).\n   */\n  supported_filters?: string[];\n}\n\n/**\n * The server-side filters and order of `POST /api/conversations/threads/list`\n * beyond the original `app_id` / `start_channel` / `search` /\n * `exclude_triggered` set. Each is a predicate of the server's one page\n * statement, so a page is exact; a server that predates a field ignores it\n * (check `ThreadListResponse.supported_filters`).\n */\nexport interface ThreadListFilterBody {\n  /** Original fields, accepted here too so one body can carry a whole query. */\n  search?: string;\n  exclude_triggered?: boolean;\n  app_ids?: string[];\n  start_channels?: string[];\n  created_after?: string;\n  created_before?: string;\n  updated_after?: string;\n  updated_before?: string;\n  collab_agent_ids?: string[];\n  /** `'default'` matches the agent's default channel (no channel stamp); needs `collab_agent_ids`. */\n  collab_channel_ids?: string[];\n  favorites_only?: boolean;\n  unread_only?: boolean;\n  run_statuses?: string[];\n  session_statuses?: string[];\n  has_pull_requests?: boolean;\n  created_by_me?: boolean;\n  exclude_dismissed?: boolean;\n  sort?: 'updated' | 'created';\n  direction?: 'desc' | 'asc';\n}\n\nexport interface ThreadCreateResponse {\n  thread_id: string;\n}\n\ninterface AuthConfig {\n  apiKey?: string;\n  token?: string | null;\n  credentials?: RequestCredentials;\n}\n\nfunction getAuthHeaders(auth: AuthConfig): Record<string, string> {\n  if (auth.token) {\n    return { Authorization: `Bearer ${auth.token}` };\n  }\n  if (auth.apiKey) {\n    return { 'X-API-KEY': auth.apiKey };\n  }\n  return {};\n}\n\n/**\n * Resolves the Athena API base URL from backendUrl.\n * Thread endpoints live under `/api/conversations/threads/*` and `/api/unstable/threads/`.\n * If backendUrl points at a nested Athena endpoint, trim it back to the API base first.\n */\nfunction getAthenaApiBaseUrl(backendUrl: string): string {\n  const stripped = backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '');\n  // If the suffix wasn't found, assume the URL already points to the API base\n  if (stripped === backendUrl) {\n    return backendUrl.replace(/\\/$/, '');\n  }\n  return stripped;\n}\n\nexport async function listThreads(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: {\n    limit?: number;\n    offset?: number;\n    exclude_triggered?: boolean;\n    app_id?: string;\n    start_channel?: string;\n    search?: string;\n    /** Ask the server for live GitHub state on `pull_requests` (off by default: it costs a lookup). */\n    include_pull_requests?: boolean;\n    /** Server-side filters and order beyond the original set (see `ThreadListFilterBody`). */\n    filters?: ThreadListFilterBody;\n    signal?: AbortSignal;\n  } = {},\n): Promise<ThreadListResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const endSpan = athenaDiagnostics.span('threads.list', 'threads.list.start', {\n    auth_mode: getAuthMode(auth),\n    app_id: opts.app_id,\n  });\n  try {\n    const res = await fetch(`${base}/api/conversations/threads/list`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n      signal: opts.signal ?? null,\n      body: JSON.stringify({\n        limit: opts.limit ?? 50,\n        offset: opts.offset ?? 0,\n        // Default to the full recent-conversations set unless a caller\n        // explicitly asks to hide triggered/background sessions.\n        exclude_triggered: opts.exclude_triggered ?? false,\n        ...(opts.app_id ? { app_id: opts.app_id } : {}),\n        ...(opts.start_channel ? { start_channel: opts.start_channel } : {}),\n        ...(opts.search ? { search: opts.search } : {}),\n        ...(opts.include_pull_requests ? { include_pull_requests: true } : {}),\n        ...opts.filters,\n      }),\n    });\n    if (!res.ok) {\n      throw new AthenaSdkError({\n        code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n        message: `Failed to list threads: ${res.status}`,\n        status: res.status,\n        hint:\n          res.status === 401 || res.status === 403\n            ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n            : 'Check backendUrl points at the Agora API base.',\n        context: { auth_mode: getAuthMode(auth) },\n      });\n    }\n    const data = (await res.json()) as ThreadListResponse;\n    endSpan('threads.list.done', { data: { count: data.threads?.length ?? 0 } });\n    return data;\n  } catch (error) {\n    // Cancellation is lifecycle noise (unmount/remount aborts): log it as an\n    // informational abort, not an error — passing `error` would force the\n    // span end to error level and spam the console.\n    if (isAbortError(error)) {\n      endSpan('threads.list.aborted', { data: { reason: 'request aborted' } });\n    } else {\n      endSpan('threads.list.error', { error });\n    }\n    throw error;\n  }\n}\n\n/** The `(workspace, user)` pair the credential resolves to on the backend. */\nexport interface AccountIdentity {\n  userId: string;\n  /** `null` for a user with no current workspace. */\n  workspaceId: string | null;\n}\n\n/**\n * Resolve the credential's agora identity. The conversation index is one\n * statewire instance per `(workspace, user)`, and neither half is knowable\n * from the credential alone: the SDK's auth context carries an identity\n * provider user id, not agora's, and never a workspace.\n */\nexport async function fetchAccountIdentity(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { signal?: AbortSignal } = {},\n): Promise<AccountIdentity> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/v0/me`, {\n    headers: getAuthHeaders(auth),\n    signal: opts.signal ?? null,\n    credentials: auth.credentials,\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n      message: `Failed to resolve account identity: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 401 || res.status === 403\n          ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n          : 'Check backendUrl points at the Agora API base.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  const body = (await res.json()) as { user_id?: unknown; workspace_id?: unknown };\n  if (typeof body.user_id !== 'string' || body.user_id.length === 0) {\n    throw new AthenaSdkError({\n      code: 'threads_list_failed',\n      message: 'Account identity lookup returned no user id.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  return {\n    userId: body.user_id,\n    workspaceId: typeof body.workspace_id === 'string' ? body.workspace_id : null,\n  };\n}\n\nexport interface ThreadReadStateResponse {\n  thread_id: string;\n  is_unread: boolean;\n}\n\n/** Store the calling user's read receipt for a thread. */\nexport async function setThreadReadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isUnread: boolean },\n): Promise<ThreadReadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/read-state`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_unread: opts.isUnread,\n    }),\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'unknown',\n      message: `Failed to set thread read state: ${res.status}`,\n      status: res.status,\n    });\n  }\n  return res.json();\n}\n\nexport interface ThreadInboxDismissResponse {\n  success: boolean;\n  dismissed: boolean;\n}\n\n/**\n * Dismiss a session from the inbox, or bring it back\n * (`POST /api/conversations/threads/notifications/dismiss`). A dismissed\n * session returns on its own with its next message. The state lives on the\n * session for its creator's inbox, so the route takes EDIT on the session\n * (403 for a VIEW share).\n */\nexport async function dismissThreadFromInbox(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; dismissed: boolean },\n): Promise<ThreadInboxDismissResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/notifications/dismiss`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({ thread_id: opts.threadId, dismissed: opts.dismissed }),\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'unknown',\n      message: `Failed to ${opts.dismissed ? 'dismiss' : 'restore'} the session: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 403\n          ? 'Only someone who can edit the session (its creator, usually) can dismiss it from the inbox.'\n          : undefined,\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth) },\n    });\n  }\n  return res.json();\n}\n\nexport interface ThreadFavoriteResponse {\n  thread_id: string;\n  /** The server's state after the write. */\n  is_favorited: boolean;\n}\n\n/**\n * Classify a 4xx from one of the per-thread write routes (`favorite`,\n * `rename`, `archive`). A 404 there is ambiguous: FastAPI answers\n * `{\"detail\":\"Not Found\"}` for a route an older agora does not have, the\n * archive route answers `\"Endpoint not available\"` on an agora without the\n * checkpointer — and each route answers 404 for a thread that no longer\n * exists (`\"Thread <id> not found\"`, `\"Conversation with langchain thread id\n * <id> not found\"`). The routes' own not-found answers name the thread, so a\n * body that does not is the ROUTE missing, and only that withdraws the\n * feature; a stale row must not disable the action for every other row.\n */\nfunction classifyThreadRouteRejection(\n  status: number,\n  body: string,\n  threadId: string,\n): { routeMissing: boolean; detail: unknown } {\n  let detail: unknown = body || undefined;\n  try {\n    const parsed: unknown = JSON.parse(body);\n    if (parsed && typeof parsed === 'object') {\n      const record = parsed as { detail?: unknown; message?: unknown };\n      detail = record.detail ?? record.message ?? parsed;\n    }\n  } catch {\n    // A non-JSON body (a proxy page) is kept as text.\n  }\n  const routeMissing = status === 405 || (status === 404 && !mentionsThread(body, threadId));\n  return { routeMissing, detail };\n}\n\n/**\n * Whether an error body names the thread as a whole token (the routes embed\n * the id between spaces: `Thread <id> not found`); a substring match would\n * let a short id match a letter inside `\"detail\"`.\n */\nfunction mentionsThread(body: string, threadId: string): boolean {\n  if (!threadId) return false;\n  const escaped = threadId.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  return new RegExp(`(^|[^A-Za-z0-9_-])${escaped}($|[^A-Za-z0-9_-])`).test(body);\n}\n\n/** True when a per-thread write was rejected because the backend has no such route. */\nfunction isThreadRouteUnavailableError(error: unknown, code: AthenaSdkErrorCode): boolean {\n  return isAthenaSdkError(error) && error.code === code && error.context.route_missing === true;\n}\n\n/**\n * Pin (favorite) or unpin a thread for the calling user. The response is the\n * server's truth after the write. Rejections: 401 / 403 when the caller\n * cannot view the thread (`auth_rejected`), otherwise `thread_favorite_failed`\n * with the HTTP status — 404 / 405 from an agora that predates the route,\n * which `isThreadFavoriteUnavailableError` recognizes so callers can fall\n * back to a read-only pin.\n */\nexport async function setThreadFavorite(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isFavorited: boolean },\n): Promise<ThreadFavoriteResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/favorite`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_favorited: opts.isFavorited,\n    }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      opts.threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_favorite_failed',\n      message: `Failed to set thread favorite: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot view this thread.'\n        : routeMissing\n          ? 'The backend has no favorite route yet (older agora); the pin stays read-only until it deploys.'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n  return res.json();\n}\n\n/**\n * True when `setThreadFavorite` failed because the backend has no favorite\n * route (a 405, or a 404 whose body does not name the thread — see\n * `classifyThreadRouteRejection`); a 404 for a thread that is gone is a\n * per-row failure and leaves the toggle available.\n */\nexport function isThreadFavoriteUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_favorite_failed');\n}\n\nexport interface ThreadRenameResponse {\n  thread_id: string;\n  /** The stored title after the write (trimmed by the server). */\n  title: string;\n}\n\n/** The longest title the rename route accepts; the server answers 422 past it. */\nexport const THREAD_TITLE_MAX_LENGTH = 200;\n\n/**\n * Rename a thread for every viewer (`POST /api/conversations/threads/rename`).\n * The server trims the title and stores 1–200 characters; the response is the\n * row's title after the write. Rejections: 401 / 403 when the caller cannot\n * edit the thread (`auth_rejected` — a viewer can pin a shared session but not\n * retitle it), otherwise `thread_rename_failed` with the HTTP status — 404 /\n * 405 from an agora that predates the route, which\n * `isThreadRenameUnavailableError` recognizes so callers can drop the action.\n */\nexport async function renameThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; title: string },\n): Promise<ThreadRenameResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/rename`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      title: opts.title,\n    }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      opts.threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_rename_failed',\n      message: `Failed to rename thread: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot edit this thread (a viewer can pin a shared session, not retitle it).'\n        : routeMissing\n          ? 'The backend has no rename route yet (older agora); sessions cannot be renamed from here until it deploys.'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : res.status === 422\n              ? `The title must be 1–${THREAD_TITLE_MAX_LENGTH} characters after trimming.`\n              : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n  return res.json();\n}\n\n/**\n * True when `renameThread` failed because the backend has no rename route\n * (a 405, or a 404 whose body does not name the thread); a 404 for a thread\n * that is gone is a per-row failure and leaves the action offered.\n */\nexport function isThreadRenameUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_rename_failed');\n}\n\n/**\n * True when `archiveThread` failed because the backend offers no archive\n * route: a 405, FastAPI's bare 404 on an agora without the route, or the\n * route's own `\"Endpoint not available\"` 404 on an agora without the\n * checkpointer. The route's `\"Thread <id> not found\"` 404 for a stale row is\n * a per-row failure and leaves the action offered on every other row.\n */\nexport function isThreadArchiveUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_archive_failed');\n}\n\nexport async function createThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { systemPrompt?: string; enabledTools?: string[]; appId?: string } = {},\n): Promise<ThreadCreateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/unstable/threads/`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      config: {\n        system_prompt: opts.systemPrompt ?? '',\n        enabled_tools: opts.enabledTools,\n        ...(opts.appId ? { app_id: opts.appId } : {}),\n      },\n    }),\n  });\n  if (!res.ok) {\n    throw new Error(`[AthenaSDK] Failed to create thread: ${res.status}`);\n  }\n  return res.json();\n}\n\nexport interface ThreadStateResponse {\n  thread_id: string;\n  messages: unknown[];\n  status?: string;\n  [key: string]: unknown;\n}\n\ninterface ConversationThreadResponse {\n  thread?: {\n    thread_id?: string;\n    state?: string | null;\n    channel_values?: Record<string, unknown> | null;\n    messages?: unknown[] | null;\n  } | null;\n  thread_found?: boolean;\n}\n\n/**\n * Deserialize a LangChain serialized message.\n * The API returns messages in `{lc, type: \"constructor\", id, kwargs}` format.\n * We need the plain format: `{type: \"human\", content: \"...\", id: \"...\"}`.\n */\nfunction deserializeMessage(msg: unknown): unknown {\n  if (\n    msg &&\n    typeof msg === 'object' &&\n    'lc' in msg &&\n    'kwargs' in msg &&\n    (msg as Record<string, unknown>).type === 'constructor'\n  ) {\n    const kwargs = (msg as { kwargs: Record<string, unknown> }).kwargs;\n\n    // Recursively deserialize nested content without mutating the original\n    const deserializedToolCalls = Array.isArray(kwargs.tool_calls)\n      ? kwargs.tool_calls.map((tc: unknown) => {\n          if (tc && typeof tc === 'object' && 'lc' in tc && 'kwargs' in tc) {\n            return (tc as { kwargs: unknown }).kwargs;\n          }\n          return tc;\n        })\n      : kwargs.tool_calls;\n\n    return { ...kwargs, tool_calls: deserializedToolCalls };\n  }\n  return msg;\n}\n\n/** Return a non-sensitive auth label for request diagnostics. */\nfunction getAuthMode(auth: AuthConfig): 'bearer' | 'api-key' | 'none' {\n  if (auth.token) {\n    return 'bearer';\n  }\n  if (auth.apiKey) {\n    return 'api-key';\n  }\n  return 'none';\n}\n\n/** Safely read a response body for error messages without masking the root failure. */\nfunction getResponseErrorBody(response: Response): Promise<string> {\n  return response.text().catch(() => '');\n}\n\n/**\n * Fetch persisted thread state from the conversations API.\n *\n * This endpoint is the same source used by Athena's conversation sidebar and\n * supports API-key auth plus BYO SSO session tokens sent as Bearer tokens.\n */\nexport async function getThreadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  threadId: string,\n  opts: {\n    /**\n     * Bypass the server's Redis thread cache and read the checkpoint (default\n     * `true`, the history load's contract). A warm-up read that only seeds a\n     * first paint passes `false`: the cached copy is cheaper and the attach\n     * snapshot replaces it anyway.\n     */\n    skipCache?: boolean;\n    signal?: AbortSignal;\n  } = {},\n): Promise<ThreadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const authMode = getAuthMode(auth);\n  const endpoint = `${base}/api/conversations/threads/get`;\n\n  const endSpan = athenaDiagnostics.span('threads.history', 'threads.history.start', {\n    thread_id: threadId,\n    auth_mode: authMode,\n  });\n\n  let res: Response;\n  try {\n    res = await fetch(endpoint, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n      signal: opts.signal ?? null,\n      body: JSON.stringify({\n        thread_id: threadId,\n        skip_cache: opts.skipCache ?? true,\n      }),\n    });\n  } catch (error) {\n    if (isAbortError(error)) {\n      endSpan('threads.history.aborted', {\n        data: { thread_id: threadId, reason: 'request aborted' },\n      });\n    } else {\n      endSpan('threads.history.error', { error, data: { thread_id: threadId } });\n    }\n    throw error;\n  }\n  if (!res.ok) {\n    const body = await getResponseErrorBody(res);\n    const error = new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'thread_load_failed',\n      message: `Failed to get thread state: ${res.status} (${authMode})${\n        body ? `: ${body.slice(0, 300)}` : ''\n      }`,\n      status: res.status,\n      hint: 'A brand-new thread may not be persisted yet; anything else means the credential or backendUrl is wrong.',\n      context: { thread_id: threadId, auth_mode: authMode },\n    });\n    endSpan('threads.history.error', { error, data: { thread_id: threadId } });\n    throw error;\n  }\n  const data = (await res.json()) as ConversationThreadResponse;\n  const channelMessages = data.thread?.channel_values?.messages;\n  endSpan('threads.history.done', {\n    data: {\n      thread_id: threadId,\n      found: data.thread_found !== false,\n      message_count: Array.isArray(channelMessages)\n        ? channelMessages.length\n        : (data.thread?.messages?.length ?? 0),\n    },\n  });\n  const thread = data.thread;\n\n  if (data.thread_found === false || !thread) {\n    return {\n      thread_id: threadId,\n      messages: [],\n    };\n  }\n\n  const channelValues = thread.channel_values ?? {};\n  const rawMessages = Array.isArray(channelValues.messages)\n    ? channelValues.messages\n    : Array.isArray(thread.messages)\n      ? thread.messages\n      : [];\n\n  return {\n    ...channelValues,\n    thread_id: thread.thread_id ?? threadId,\n    messages: rawMessages.map(deserializeMessage),\n    ...(thread.state ? { status: thread.state } : {}),\n  };\n}\n\n/**\n * Archive a thread (`POST /api/conversations/threads/archive`): it leaves\n * every list but keeps its state. Rejections: 401 / 403 when the caller\n * cannot access the thread (`auth_rejected`), otherwise\n * `thread_archive_failed` with the HTTP status — 404 / 405 when the backend\n * has no archive route, which `isThreadArchiveUnavailableError` recognizes.\n */\nexport async function archiveThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  threadId: string,\n): Promise<void> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/archive`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({ thread_id: threadId }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_archive_failed',\n      message: `Failed to archive thread: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot access this thread.'\n        : routeMissing\n          ? 'The backend has no archive route (no checkpointer, or an older agora).'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n}\n"],"names":["athenaDiagnostics","AthenaSdkError","isAthenaSdkError"],"mappings":"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"}

package/dist/threads/api.d.ts

@@ -123,6 +123,7 @@ export interface ThreadCreateResponse {
 interface AuthConfig {
     apiKey?: string;
     token?: string | null;
+    credentials?: RequestCredentials;
 }
 export declare function listThreads(backendUrl: string, auth: AuthConfig, opts?: {
     limit?: number;

package/dist/threads/api.js

@@ -69,7 +69,8 @@ async function fetchAccountIdentity(backendUrl, auth, opts = {}) {
   const base = getAthenaApiBaseUrl(backendUrl);
   const res = await fetch(`${base}/api/v0/me`, {
     headers: getAuthHeaders(auth),
-    signal: opts.signal ?? null
+    signal: opts.signal ?? null,
+    credentials: auth.credentials
   });
   if (!res.ok) {
     throw new AthenaSdkError({

package/dist/threads/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sources":["../../src/threads/api.ts"],"sourcesContent":["/**\n * Athena thread API client.\n * Calls existing REST endpoints for thread CRUD.\n */\n\nimport type {\n  ConversationAttention,\n  ConversationAttentionSource,\n} from '@athenaintel/agent-runtime';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError, type AthenaSdkErrorCode, isAthenaSdkError } from '../diagnostics/errors';\n\n/**\n * Live GitHub state of a pull request the thread opened, read by the server\n * when the list renders (agora `agent_pr_threads` is the only stored link).\n */\nexport interface ThreadPullRequest {\n  /** `owner/repo` the pull request lives in. */\n  repo_full_name: string;\n  number: number;\n  url: string;\n  title: string;\n  state: 'OPEN' | 'CLOSED' | 'MERGED';\n  is_draft: boolean;\n  /** GitHub's review decision (APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED) or null. */\n  review_decision: string | null;\n  /** Combined state of the checks on the head commit. */\n  checks_state: 'SUCCESS' | 'FAILURE' | 'PENDING' | 'NONE';\n  /** ISO 8601 timestamp of the pull request's last update on GitHub. */\n  updated_at: string;\n}\n\n/** The last event that woke a resting thread (a GitHub webhook, a schedule, a handoff). */\nexport interface ThreadWake {\n  source: string | null;\n  reason: string | null;\n  /** ISO 8601 timestamp of the wake. */\n  at: string | null;\n}\n\nexport interface ThreadSummary {\n  thread_id: string;\n  title: string;\n  created_at: string;\n  updated_at: string;\n  last_message: string | null;\n  message_count: number;\n  state: string | null;\n  start_channel?: string | null;\n  last_channel?: string | null;\n  /** Client app that created the session (SESSION_APP_ID_GUIDE). */\n  app_id?: string | null;\n  /** Collab agent and channel the session started on; older servers omit them. */\n  collab_agent_id?: string | null;\n  collab_channel_id?: string | null;\n  /** Trigger marker for automated/background sessions. */\n  trigger_type?: string | null;\n  /** Whether the calling user has seen this thread since it last changed. */\n  is_unread?: boolean;\n  /**\n   * Canonical status_v2 planes (`idle | active | needs_input | error` and\n   * `scheduled | queued | running | needs_input | completed | failed |\n   * canceled`); older servers omit them.\n   */\n  session_status?: string | null;\n  run_status?: string | null;\n  /**\n   * The viewer's attention state, the one-line next action (≤ 80 chars) and\n   * the signal that produced them, derived server-side; older servers omit them.\n   */\n  attention?: ConversationAttention | null;\n  next_action?: string | null;\n  attention_source?: ConversationAttentionSource | null;\n  /** Whether the calling user favorited (pinned) the thread; older servers omit it. */\n  is_favorited?: boolean;\n  /** The last wake of a resting thread; older servers omit it. */\n  last_wake?: ThreadWake | null;\n  /** Whether the calling user started the thread (`false`: shared with them); older servers omit it. */\n  created_by_me?: boolean;\n  /**\n   * Pull requests the thread opened with their live GitHub state. `[]` when\n   * it opened none, `null` when the state could not be read right now;\n   * older servers omit the field.\n   */\n  pull_requests?: ThreadPullRequest[] | null;\n}\n\n/**\n * True for fetch cancellations (unmount/remount aborts, StrictMode double\n * effects). These are lifecycle noise, not failures: emitting them as\n * `*.error` diagnostics floods the console with\n * \"signal is aborted without reason\" for requests the caller itself aborted.\n */\nfunction isAbortError(error: unknown): boolean {\n  return (\n    (error instanceof DOMException && error.name === 'AbortError') ||\n    (error instanceof Error && error.name === 'AbortError')\n  );\n}\n\nexport interface ThreadListResponse {\n  threads: ThreadSummary[];\n  /** Server lookahead result. Older servers may omit this field. */\n  has_more?: boolean;\n  /**\n   * Every request field the server applies beyond paging. The server ignores\n   * fields it does not know, so a filter missing from this list came back\n   * unapplied; servers that predate the list omit it (none of the\n   * `ThreadListFilterBody` fields are applied there).\n   */\n  supported_filters?: string[];\n}\n\n/**\n * The server-side filters and order of `POST /api/conversations/threads/list`\n * beyond the original `app_id` / `start_channel` / `search` /\n * `exclude_triggered` set. Each is a predicate of the server's one page\n * statement, so a page is exact; a server that predates a field ignores it\n * (check `ThreadListResponse.supported_filters`).\n */\nexport interface ThreadListFilterBody {\n  /** Original fields, accepted here too so one body can carry a whole query. */\n  search?: string;\n  exclude_triggered?: boolean;\n  app_ids?: string[];\n  start_channels?: string[];\n  created_after?: string;\n  created_before?: string;\n  updated_after?: string;\n  updated_before?: string;\n  collab_agent_ids?: string[];\n  /** `'default'` matches the agent's default channel (no channel stamp); needs `collab_agent_ids`. */\n  collab_channel_ids?: string[];\n  favorites_only?: boolean;\n  unread_only?: boolean;\n  run_statuses?: string[];\n  session_statuses?: string[];\n  has_pull_requests?: boolean;\n  created_by_me?: boolean;\n  exclude_dismissed?: boolean;\n  sort?: 'updated' | 'created';\n  direction?: 'desc' | 'asc';\n}\n\nexport interface ThreadCreateResponse {\n  thread_id: string;\n}\n\ninterface AuthConfig {\n  apiKey?: string;\n  token?: string | null;\n}\n\nfunction getAuthHeaders(auth: AuthConfig): Record<string, string> {\n  if (auth.token) {\n    return { Authorization: `Bearer ${auth.token}` };\n  }\n  if (auth.apiKey) {\n    return { 'X-API-KEY': auth.apiKey };\n  }\n  return {};\n}\n\n/**\n * Resolves the Athena API base URL from backendUrl.\n * Thread endpoints live under `/api/conversations/threads/*` and `/api/unstable/threads/`.\n * If backendUrl points at a nested Athena endpoint, trim it back to the API base first.\n */\nfunction getAthenaApiBaseUrl(backendUrl: string): string {\n  const stripped = backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '');\n  // If the suffix wasn't found, assume the URL already points to the API base\n  if (stripped === backendUrl) {\n    return backendUrl.replace(/\\/$/, '');\n  }\n  return stripped;\n}\n\nexport async function listThreads(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: {\n    limit?: number;\n    offset?: number;\n    exclude_triggered?: boolean;\n    app_id?: string;\n    start_channel?: string;\n    search?: string;\n    /** Ask the server for live GitHub state on `pull_requests` (off by default: it costs a lookup). */\n    include_pull_requests?: boolean;\n    /** Server-side filters and order beyond the original set (see `ThreadListFilterBody`). */\n    filters?: ThreadListFilterBody;\n    signal?: AbortSignal;\n  } = {},\n): Promise<ThreadListResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const endSpan = athenaDiagnostics.span('threads.list', 'threads.list.start', {\n    auth_mode: getAuthMode(auth),\n    app_id: opts.app_id,\n  });\n  try {\n    const res = await fetch(`${base}/api/conversations/threads/list`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n      signal: opts.signal ?? null,\n      body: JSON.stringify({\n        limit: opts.limit ?? 50,\n        offset: opts.offset ?? 0,\n        // Default to the full recent-conversations set unless a caller\n        // explicitly asks to hide triggered/background sessions.\n        exclude_triggered: opts.exclude_triggered ?? false,\n        ...(opts.app_id ? { app_id: opts.app_id } : {}),\n        ...(opts.start_channel ? { start_channel: opts.start_channel } : {}),\n        ...(opts.search ? { search: opts.search } : {}),\n        ...(opts.include_pull_requests ? { include_pull_requests: true } : {}),\n        ...opts.filters,\n      }),\n    });\n    if (!res.ok) {\n      throw new AthenaSdkError({\n        code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n        message: `Failed to list threads: ${res.status}`,\n        status: res.status,\n        hint:\n          res.status === 401 || res.status === 403\n            ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n            : 'Check backendUrl points at the Agora API base.',\n        context: { auth_mode: getAuthMode(auth) },\n      });\n    }\n    const data = (await res.json()) as ThreadListResponse;\n    endSpan('threads.list.done', { data: { count: data.threads?.length ?? 0 } });\n    return data;\n  } catch (error) {\n    // Cancellation is lifecycle noise (unmount/remount aborts): log it as an\n    // informational abort, not an error — passing `error` would force the\n    // span end to error level and spam the console.\n    if (isAbortError(error)) {\n      endSpan('threads.list.aborted', { data: { reason: 'request aborted' } });\n    } else {\n      endSpan('threads.list.error', { error });\n    }\n    throw error;\n  }\n}\n\n/** The `(workspace, user)` pair the credential resolves to on the backend. */\nexport interface AccountIdentity {\n  userId: string;\n  /** `null` for a user with no current workspace. */\n  workspaceId: string | null;\n}\n\n/**\n * Resolve the credential's agora identity. The conversation index is one\n * statewire instance per `(workspace, user)`, and neither half is knowable\n * from the credential alone: the SDK's auth context carries an identity\n * provider user id, not agora's, and never a workspace.\n */\nexport async function fetchAccountIdentity(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { signal?: AbortSignal } = {},\n): Promise<AccountIdentity> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/v0/me`, {\n    headers: getAuthHeaders(auth),\n    signal: opts.signal ?? null,\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n      message: `Failed to resolve account identity: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 401 || res.status === 403\n          ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n          : 'Check backendUrl points at the Agora API base.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  const body = (await res.json()) as { user_id?: unknown; workspace_id?: unknown };\n  if (typeof body.user_id !== 'string' || body.user_id.length === 0) {\n    throw new AthenaSdkError({\n      code: 'threads_list_failed',\n      message: 'Account identity lookup returned no user id.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  return {\n    userId: body.user_id,\n    workspaceId: typeof body.workspace_id === 'string' ? body.workspace_id : null,\n  };\n}\n\nexport interface ThreadReadStateResponse {\n  thread_id: string;\n  is_unread: boolean;\n}\n\n/** Store the calling user's read receipt for a thread. */\nexport async function setThreadReadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isUnread: boolean },\n): Promise<ThreadReadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/read-state`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_unread: opts.isUnread,\n    }),\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'unknown',\n      message: `Failed to set thread read state: ${res.status}`,\n      status: res.status,\n    });\n  }\n  return res.json();\n}\n\nexport interface ThreadInboxDismissResponse {\n  success: boolean;\n  dismissed: boolean;\n}\n\n/**\n * Dismiss a session from the inbox, or bring it back\n * (`POST /api/conversations/threads/notifications/dismiss`). A dismissed\n * session returns on its own with its next message. The state lives on the\n * session for its creator's inbox, so the route takes EDIT on the session\n * (403 for a VIEW share).\n */\nexport async function dismissThreadFromInbox(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; dismissed: boolean },\n): Promise<ThreadInboxDismissResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/notifications/dismiss`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({ thread_id: opts.threadId, dismissed: opts.dismissed }),\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'unknown',\n      message: `Failed to ${opts.dismissed ? 'dismiss' : 'restore'} the session: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 403\n          ? 'Only someone who can edit the session (its creator, usually) can dismiss it from the inbox.'\n          : undefined,\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth) },\n    });\n  }\n  return res.json();\n}\n\nexport interface ThreadFavoriteResponse {\n  thread_id: string;\n  /** The server's state after the write. */\n  is_favorited: boolean;\n}\n\n/**\n * Classify a 4xx from one of the per-thread write routes (`favorite`,\n * `rename`, `archive`). A 404 there is ambiguous: FastAPI answers\n * `{\"detail\":\"Not Found\"}` for a route an older agora does not have, the\n * archive route answers `\"Endpoint not available\"` on an agora without the\n * checkpointer — and each route answers 404 for a thread that no longer\n * exists (`\"Thread <id> not found\"`, `\"Conversation with langchain thread id\n * <id> not found\"`). The routes' own not-found answers name the thread, so a\n * body that does not is the ROUTE missing, and only that withdraws the\n * feature; a stale row must not disable the action for every other row.\n */\nfunction classifyThreadRouteRejection(\n  status: number,\n  body: string,\n  threadId: string,\n): { routeMissing: boolean; detail: unknown } {\n  let detail: unknown = body || undefined;\n  try {\n    const parsed: unknown = JSON.parse(body);\n    if (parsed && typeof parsed === 'object') {\n      const record = parsed as { detail?: unknown; message?: unknown };\n      detail = record.detail ?? record.message ?? parsed;\n    }\n  } catch {\n    // A non-JSON body (a proxy page) is kept as text.\n  }\n  const routeMissing = status === 405 || (status === 404 && !mentionsThread(body, threadId));\n  return { routeMissing, detail };\n}\n\n/**\n * Whether an error body names the thread as a whole token (the routes embed\n * the id between spaces: `Thread <id> not found`); a substring match would\n * let a short id match a letter inside `\"detail\"`.\n */\nfunction mentionsThread(body: string, threadId: string): boolean {\n  if (!threadId) return false;\n  const escaped = threadId.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  return new RegExp(`(^|[^A-Za-z0-9_-])${escaped}($|[^A-Za-z0-9_-])`).test(body);\n}\n\n/** True when a per-thread write was rejected because the backend has no such route. */\nfunction isThreadRouteUnavailableError(error: unknown, code: AthenaSdkErrorCode): boolean {\n  return isAthenaSdkError(error) && error.code === code && error.context.route_missing === true;\n}\n\n/**\n * Pin (favorite) or unpin a thread for the calling user. The response is the\n * server's truth after the write. Rejections: 401 / 403 when the caller\n * cannot view the thread (`auth_rejected`), otherwise `thread_favorite_failed`\n * with the HTTP status — 404 / 405 from an agora that predates the route,\n * which `isThreadFavoriteUnavailableError` recognizes so callers can fall\n * back to a read-only pin.\n */\nexport async function setThreadFavorite(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isFavorited: boolean },\n): Promise<ThreadFavoriteResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/favorite`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_favorited: opts.isFavorited,\n    }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      opts.threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_favorite_failed',\n      message: `Failed to set thread favorite: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot view this thread.'\n        : routeMissing\n          ? 'The backend has no favorite route yet (older agora); the pin stays read-only until it deploys.'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n  return res.json();\n}\n\n/**\n * True when `setThreadFavorite` failed because the backend has no favorite\n * route (a 405, or a 404 whose body does not name the thread — see\n * `classifyThreadRouteRejection`); a 404 for a thread that is gone is a\n * per-row failure and leaves the toggle available.\n */\nexport function isThreadFavoriteUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_favorite_failed');\n}\n\nexport interface ThreadRenameResponse {\n  thread_id: string;\n  /** The stored title after the write (trimmed by the server). */\n  title: string;\n}\n\n/** The longest title the rename route accepts; the server answers 422 past it. */\nexport const THREAD_TITLE_MAX_LENGTH = 200;\n\n/**\n * Rename a thread for every viewer (`POST /api/conversations/threads/rename`).\n * The server trims the title and stores 1–200 characters; the response is the\n * row's title after the write. Rejections: 401 / 403 when the caller cannot\n * edit the thread (`auth_rejected` — a viewer can pin a shared session but not\n * retitle it), otherwise `thread_rename_failed` with the HTTP status — 404 /\n * 405 from an agora that predates the route, which\n * `isThreadRenameUnavailableError` recognizes so callers can drop the action.\n */\nexport async function renameThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; title: string },\n): Promise<ThreadRenameResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/rename`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      title: opts.title,\n    }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      opts.threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_rename_failed',\n      message: `Failed to rename thread: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot edit this thread (a viewer can pin a shared session, not retitle it).'\n        : routeMissing\n          ? 'The backend has no rename route yet (older agora); sessions cannot be renamed from here until it deploys.'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : res.status === 422\n              ? `The title must be 1–${THREAD_TITLE_MAX_LENGTH} characters after trimming.`\n              : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n  return res.json();\n}\n\n/**\n * True when `renameThread` failed because the backend has no rename route\n * (a 405, or a 404 whose body does not name the thread); a 404 for a thread\n * that is gone is a per-row failure and leaves the action offered.\n */\nexport function isThreadRenameUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_rename_failed');\n}\n\n/**\n * True when `archiveThread` failed because the backend offers no archive\n * route: a 405, FastAPI's bare 404 on an agora without the route, or the\n * route's own `\"Endpoint not available\"` 404 on an agora without the\n * checkpointer. The route's `\"Thread <id> not found\"` 404 for a stale row is\n * a per-row failure and leaves the action offered on every other row.\n */\nexport function isThreadArchiveUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_archive_failed');\n}\n\nexport async function createThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { systemPrompt?: string; enabledTools?: string[]; appId?: string } = {},\n): Promise<ThreadCreateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/unstable/threads/`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      config: {\n        system_prompt: opts.systemPrompt ?? '',\n        enabled_tools: opts.enabledTools,\n        ...(opts.appId ? { app_id: opts.appId } : {}),\n      },\n    }),\n  });\n  if (!res.ok) {\n    throw new Error(`[AthenaSDK] Failed to create thread: ${res.status}`);\n  }\n  return res.json();\n}\n\nexport interface ThreadStateResponse {\n  thread_id: string;\n  messages: unknown[];\n  status?: string;\n  [key: string]: unknown;\n}\n\ninterface ConversationThreadResponse {\n  thread?: {\n    thread_id?: string;\n    state?: string | null;\n    channel_values?: Record<string, unknown> | null;\n    messages?: unknown[] | null;\n  } | null;\n  thread_found?: boolean;\n}\n\n/**\n * Deserialize a LangChain serialized message.\n * The API returns messages in `{lc, type: \"constructor\", id, kwargs}` format.\n * We need the plain format: `{type: \"human\", content: \"...\", id: \"...\"}`.\n */\nfunction deserializeMessage(msg: unknown): unknown {\n  if (\n    msg &&\n    typeof msg === 'object' &&\n    'lc' in msg &&\n    'kwargs' in msg &&\n    (msg as Record<string, unknown>).type === 'constructor'\n  ) {\n    const kwargs = (msg as { kwargs: Record<string, unknown> }).kwargs;\n\n    // Recursively deserialize nested content without mutating the original\n    const deserializedToolCalls = Array.isArray(kwargs.tool_calls)\n      ? kwargs.tool_calls.map((tc: unknown) => {\n          if (tc && typeof tc === 'object' && 'lc' in tc && 'kwargs' in tc) {\n            return (tc as { kwargs: unknown }).kwargs;\n          }\n          return tc;\n        })\n      : kwargs.tool_calls;\n\n    return { ...kwargs, tool_calls: deserializedToolCalls };\n  }\n  return msg;\n}\n\n/** Return a non-sensitive auth label for request diagnostics. */\nfunction getAuthMode(auth: AuthConfig): 'bearer' | 'api-key' | 'none' {\n  if (auth.token) {\n    return 'bearer';\n  }\n  if (auth.apiKey) {\n    return 'api-key';\n  }\n  return 'none';\n}\n\n/** Safely read a response body for error messages without masking the root failure. */\nfunction getResponseErrorBody(response: Response): Promise<string> {\n  return response.text().catch(() => '');\n}\n\n/**\n * Fetch persisted thread state from the conversations API.\n *\n * This endpoint is the same source used by Athena's conversation sidebar and\n * supports API-key auth plus BYO SSO session tokens sent as Bearer tokens.\n */\nexport async function getThreadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  threadId: string,\n  opts: {\n    /**\n     * Bypass the server's Redis thread cache and read the checkpoint (default\n     * `true`, the history load's contract). A warm-up read that only seeds a\n     * first paint passes `false`: the cached copy is cheaper and the attach\n     * snapshot replaces it anyway.\n     */\n    skipCache?: boolean;\n    signal?: AbortSignal;\n  } = {},\n): Promise<ThreadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const authMode = getAuthMode(auth);\n  const endpoint = `${base}/api/conversations/threads/get`;\n\n  const endSpan = athenaDiagnostics.span('threads.history', 'threads.history.start', {\n    thread_id: threadId,\n    auth_mode: authMode,\n  });\n\n  let res: Response;\n  try {\n    res = await fetch(endpoint, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n      signal: opts.signal ?? null,\n      body: JSON.stringify({\n        thread_id: threadId,\n        skip_cache: opts.skipCache ?? true,\n      }),\n    });\n  } catch (error) {\n    if (isAbortError(error)) {\n      endSpan('threads.history.aborted', {\n        data: { thread_id: threadId, reason: 'request aborted' },\n      });\n    } else {\n      endSpan('threads.history.error', { error, data: { thread_id: threadId } });\n    }\n    throw error;\n  }\n  if (!res.ok) {\n    const body = await getResponseErrorBody(res);\n    const error = new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'thread_load_failed',\n      message: `Failed to get thread state: ${res.status} (${authMode})${\n        body ? `: ${body.slice(0, 300)}` : ''\n      }`,\n      status: res.status,\n      hint: 'A brand-new thread may not be persisted yet; anything else means the credential or backendUrl is wrong.',\n      context: { thread_id: threadId, auth_mode: authMode },\n    });\n    endSpan('threads.history.error', { error, data: { thread_id: threadId } });\n    throw error;\n  }\n  const data = (await res.json()) as ConversationThreadResponse;\n  const channelMessages = data.thread?.channel_values?.messages;\n  endSpan('threads.history.done', {\n    data: {\n      thread_id: threadId,\n      found: data.thread_found !== false,\n      message_count: Array.isArray(channelMessages)\n        ? channelMessages.length\n        : (data.thread?.messages?.length ?? 0),\n    },\n  });\n  const thread = data.thread;\n\n  if (data.thread_found === false || !thread) {\n    return {\n      thread_id: threadId,\n      messages: [],\n    };\n  }\n\n  const channelValues = thread.channel_values ?? {};\n  const rawMessages = Array.isArray(channelValues.messages)\n    ? channelValues.messages\n    : Array.isArray(thread.messages)\n      ? thread.messages\n      : [];\n\n  return {\n    ...channelValues,\n    thread_id: thread.thread_id ?? threadId,\n    messages: rawMessages.map(deserializeMessage),\n    ...(thread.state ? { status: thread.state } : {}),\n  };\n}\n\n/**\n * Archive a thread (`POST /api/conversations/threads/archive`): it leaves\n * every list but keeps its state. Rejections: 401 / 403 when the caller\n * cannot access the thread (`auth_rejected`), otherwise\n * `thread_archive_failed` with the HTTP status — 404 / 405 when the backend\n * has no archive route, which `isThreadArchiveUnavailableError` recognizes.\n */\nexport async function archiveThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  threadId: string,\n): Promise<void> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/archive`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({ thread_id: threadId }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_archive_failed',\n      message: `Failed to archive thread: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot access this thread.'\n        : routeMissing\n          ? 'The backend has no archive route (no checkpointer, or an older agora).'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sources":["../../src/threads/api.ts"],"sourcesContent":["/**\n * Athena thread API client.\n * Calls existing REST endpoints for thread CRUD.\n */\n\nimport type {\n  ConversationAttention,\n  ConversationAttentionSource,\n} from '@athenaintel/agent-runtime';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError, type AthenaSdkErrorCode, isAthenaSdkError } from '../diagnostics/errors';\n\n/**\n * Live GitHub state of a pull request the thread opened, read by the server\n * when the list renders (agora `agent_pr_threads` is the only stored link).\n */\nexport interface ThreadPullRequest {\n  /** `owner/repo` the pull request lives in. */\n  repo_full_name: string;\n  number: number;\n  url: string;\n  title: string;\n  state: 'OPEN' | 'CLOSED' | 'MERGED';\n  is_draft: boolean;\n  /** GitHub's review decision (APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED) or null. */\n  review_decision: string | null;\n  /** Combined state of the checks on the head commit. */\n  checks_state: 'SUCCESS' | 'FAILURE' | 'PENDING' | 'NONE';\n  /** ISO 8601 timestamp of the pull request's last update on GitHub. */\n  updated_at: string;\n}\n\n/** The last event that woke a resting thread (a GitHub webhook, a schedule, a handoff). */\nexport interface ThreadWake {\n  source: string | null;\n  reason: string | null;\n  /** ISO 8601 timestamp of the wake. */\n  at: string | null;\n}\n\nexport interface ThreadSummary {\n  thread_id: string;\n  title: string;\n  created_at: string;\n  updated_at: string;\n  last_message: string | null;\n  message_count: number;\n  state: string | null;\n  start_channel?: string | null;\n  last_channel?: string | null;\n  /** Client app that created the session (SESSION_APP_ID_GUIDE). */\n  app_id?: string | null;\n  /** Collab agent and channel the session started on; older servers omit them. */\n  collab_agent_id?: string | null;\n  collab_channel_id?: string | null;\n  /** Trigger marker for automated/background sessions. */\n  trigger_type?: string | null;\n  /** Whether the calling user has seen this thread since it last changed. */\n  is_unread?: boolean;\n  /**\n   * Canonical status_v2 planes (`idle | active | needs_input | error` and\n   * `scheduled | queued | running | needs_input | completed | failed |\n   * canceled`); older servers omit them.\n   */\n  session_status?: string | null;\n  run_status?: string | null;\n  /**\n   * The viewer's attention state, the one-line next action (≤ 80 chars) and\n   * the signal that produced them, derived server-side; older servers omit them.\n   */\n  attention?: ConversationAttention | null;\n  next_action?: string | null;\n  attention_source?: ConversationAttentionSource | null;\n  /** Whether the calling user favorited (pinned) the thread; older servers omit it. */\n  is_favorited?: boolean;\n  /** The last wake of a resting thread; older servers omit it. */\n  last_wake?: ThreadWake | null;\n  /** Whether the calling user started the thread (`false`: shared with them); older servers omit it. */\n  created_by_me?: boolean;\n  /**\n   * Pull requests the thread opened with their live GitHub state. `[]` when\n   * it opened none, `null` when the state could not be read right now;\n   * older servers omit the field.\n   */\n  pull_requests?: ThreadPullRequest[] | null;\n}\n\n/**\n * True for fetch cancellations (unmount/remount aborts, StrictMode double\n * effects). These are lifecycle noise, not failures: emitting them as\n * `*.error` diagnostics floods the console with\n * \"signal is aborted without reason\" for requests the caller itself aborted.\n */\nfunction isAbortError(error: unknown): boolean {\n  return (\n    (error instanceof DOMException && error.name === 'AbortError') ||\n    (error instanceof Error && error.name === 'AbortError')\n  );\n}\n\nexport interface ThreadListResponse {\n  threads: ThreadSummary[];\n  /** Server lookahead result. Older servers may omit this field. */\n  has_more?: boolean;\n  /**\n   * Every request field the server applies beyond paging. The server ignores\n   * fields it does not know, so a filter missing from this list came back\n   * unapplied; servers that predate the list omit it (none of the\n   * `ThreadListFilterBody` fields are applied there).\n   */\n  supported_filters?: string[];\n}\n\n/**\n * The server-side filters and order of `POST /api/conversations/threads/list`\n * beyond the original `app_id` / `start_channel` / `search` /\n * `exclude_triggered` set. Each is a predicate of the server's one page\n * statement, so a page is exact; a server that predates a field ignores it\n * (check `ThreadListResponse.supported_filters`).\n */\nexport interface ThreadListFilterBody {\n  /** Original fields, accepted here too so one body can carry a whole query. */\n  search?: string;\n  exclude_triggered?: boolean;\n  app_ids?: string[];\n  start_channels?: string[];\n  created_after?: string;\n  created_before?: string;\n  updated_after?: string;\n  updated_before?: string;\n  collab_agent_ids?: string[];\n  /** `'default'` matches the agent's default channel (no channel stamp); needs `collab_agent_ids`. */\n  collab_channel_ids?: string[];\n  favorites_only?: boolean;\n  unread_only?: boolean;\n  run_statuses?: string[];\n  session_statuses?: string[];\n  has_pull_requests?: boolean;\n  created_by_me?: boolean;\n  exclude_dismissed?: boolean;\n  sort?: 'updated' | 'created';\n  direction?: 'desc' | 'asc';\n}\n\nexport interface ThreadCreateResponse {\n  thread_id: string;\n}\n\ninterface AuthConfig {\n  apiKey?: string;\n  token?: string | null;\n  credentials?: RequestCredentials;\n}\n\nfunction getAuthHeaders(auth: AuthConfig): Record<string, string> {\n  if (auth.token) {\n    return { Authorization: `Bearer ${auth.token}` };\n  }\n  if (auth.apiKey) {\n    return { 'X-API-KEY': auth.apiKey };\n  }\n  return {};\n}\n\n/**\n * Resolves the Athena API base URL from backendUrl.\n * Thread endpoints live under `/api/conversations/threads/*` and `/api/unstable/threads/`.\n * If backendUrl points at a nested Athena endpoint, trim it back to the API base first.\n */\nfunction getAthenaApiBaseUrl(backendUrl: string): string {\n  const stripped = backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '');\n  // If the suffix wasn't found, assume the URL already points to the API base\n  if (stripped === backendUrl) {\n    return backendUrl.replace(/\\/$/, '');\n  }\n  return stripped;\n}\n\nexport async function listThreads(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: {\n    limit?: number;\n    offset?: number;\n    exclude_triggered?: boolean;\n    app_id?: string;\n    start_channel?: string;\n    search?: string;\n    /** Ask the server for live GitHub state on `pull_requests` (off by default: it costs a lookup). */\n    include_pull_requests?: boolean;\n    /** Server-side filters and order beyond the original set (see `ThreadListFilterBody`). */\n    filters?: ThreadListFilterBody;\n    signal?: AbortSignal;\n  } = {},\n): Promise<ThreadListResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const endSpan = athenaDiagnostics.span('threads.list', 'threads.list.start', {\n    auth_mode: getAuthMode(auth),\n    app_id: opts.app_id,\n  });\n  try {\n    const res = await fetch(`${base}/api/conversations/threads/list`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n      signal: opts.signal ?? null,\n      body: JSON.stringify({\n        limit: opts.limit ?? 50,\n        offset: opts.offset ?? 0,\n        // Default to the full recent-conversations set unless a caller\n        // explicitly asks to hide triggered/background sessions.\n        exclude_triggered: opts.exclude_triggered ?? false,\n        ...(opts.app_id ? { app_id: opts.app_id } : {}),\n        ...(opts.start_channel ? { start_channel: opts.start_channel } : {}),\n        ...(opts.search ? { search: opts.search } : {}),\n        ...(opts.include_pull_requests ? { include_pull_requests: true } : {}),\n        ...opts.filters,\n      }),\n    });\n    if (!res.ok) {\n      throw new AthenaSdkError({\n        code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n        message: `Failed to list threads: ${res.status}`,\n        status: res.status,\n        hint:\n          res.status === 401 || res.status === 403\n            ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n            : 'Check backendUrl points at the Agora API base.',\n        context: { auth_mode: getAuthMode(auth) },\n      });\n    }\n    const data = (await res.json()) as ThreadListResponse;\n    endSpan('threads.list.done', { data: { count: data.threads?.length ?? 0 } });\n    return data;\n  } catch (error) {\n    // Cancellation is lifecycle noise (unmount/remount aborts): log it as an\n    // informational abort, not an error — passing `error` would force the\n    // span end to error level and spam the console.\n    if (isAbortError(error)) {\n      endSpan('threads.list.aborted', { data: { reason: 'request aborted' } });\n    } else {\n      endSpan('threads.list.error', { error });\n    }\n    throw error;\n  }\n}\n\n/** The `(workspace, user)` pair the credential resolves to on the backend. */\nexport interface AccountIdentity {\n  userId: string;\n  /** `null` for a user with no current workspace. */\n  workspaceId: string | null;\n}\n\n/**\n * Resolve the credential's agora identity. The conversation index is one\n * statewire instance per `(workspace, user)`, and neither half is knowable\n * from the credential alone: the SDK's auth context carries an identity\n * provider user id, not agora's, and never a workspace.\n */\nexport async function fetchAccountIdentity(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { signal?: AbortSignal } = {},\n): Promise<AccountIdentity> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/v0/me`, {\n    headers: getAuthHeaders(auth),\n    signal: opts.signal ?? null,\n    credentials: auth.credentials,\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n      message: `Failed to resolve account identity: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 401 || res.status === 403\n          ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n          : 'Check backendUrl points at the Agora API base.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  const body = (await res.json()) as { user_id?: unknown; workspace_id?: unknown };\n  if (typeof body.user_id !== 'string' || body.user_id.length === 0) {\n    throw new AthenaSdkError({\n      code: 'threads_list_failed',\n      message: 'Account identity lookup returned no user id.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  return {\n    userId: body.user_id,\n    workspaceId: typeof body.workspace_id === 'string' ? body.workspace_id : null,\n  };\n}\n\nexport interface ThreadReadStateResponse {\n  thread_id: string;\n  is_unread: boolean;\n}\n\n/** Store the calling user's read receipt for a thread. */\nexport async function setThreadReadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isUnread: boolean },\n): Promise<ThreadReadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/read-state`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_unread: opts.isUnread,\n    }),\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'unknown',\n      message: `Failed to set thread read state: ${res.status}`,\n      status: res.status,\n    });\n  }\n  return res.json();\n}\n\nexport interface ThreadInboxDismissResponse {\n  success: boolean;\n  dismissed: boolean;\n}\n\n/**\n * Dismiss a session from the inbox, or bring it back\n * (`POST /api/conversations/threads/notifications/dismiss`). A dismissed\n * session returns on its own with its next message. The state lives on the\n * session for its creator's inbox, so the route takes EDIT on the session\n * (403 for a VIEW share).\n */\nexport async function dismissThreadFromInbox(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; dismissed: boolean },\n): Promise<ThreadInboxDismissResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/notifications/dismiss`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({ thread_id: opts.threadId, dismissed: opts.dismissed }),\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'unknown',\n      message: `Failed to ${opts.dismissed ? 'dismiss' : 'restore'} the session: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 403\n          ? 'Only someone who can edit the session (its creator, usually) can dismiss it from the inbox.'\n          : undefined,\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth) },\n    });\n  }\n  return res.json();\n}\n\nexport interface ThreadFavoriteResponse {\n  thread_id: string;\n  /** The server's state after the write. */\n  is_favorited: boolean;\n}\n\n/**\n * Classify a 4xx from one of the per-thread write routes (`favorite`,\n * `rename`, `archive`). A 404 there is ambiguous: FastAPI answers\n * `{\"detail\":\"Not Found\"}` for a route an older agora does not have, the\n * archive route answers `\"Endpoint not available\"` on an agora without the\n * checkpointer — and each route answers 404 for a thread that no longer\n * exists (`\"Thread <id> not found\"`, `\"Conversation with langchain thread id\n * <id> not found\"`). The routes' own not-found answers name the thread, so a\n * body that does not is the ROUTE missing, and only that withdraws the\n * feature; a stale row must not disable the action for every other row.\n */\nfunction classifyThreadRouteRejection(\n  status: number,\n  body: string,\n  threadId: string,\n): { routeMissing: boolean; detail: unknown } {\n  let detail: unknown = body || undefined;\n  try {\n    const parsed: unknown = JSON.parse(body);\n    if (parsed && typeof parsed === 'object') {\n      const record = parsed as { detail?: unknown; message?: unknown };\n      detail = record.detail ?? record.message ?? parsed;\n    }\n  } catch {\n    // A non-JSON body (a proxy page) is kept as text.\n  }\n  const routeMissing = status === 405 || (status === 404 && !mentionsThread(body, threadId));\n  return { routeMissing, detail };\n}\n\n/**\n * Whether an error body names the thread as a whole token (the routes embed\n * the id between spaces: `Thread <id> not found`); a substring match would\n * let a short id match a letter inside `\"detail\"`.\n */\nfunction mentionsThread(body: string, threadId: string): boolean {\n  if (!threadId) return false;\n  const escaped = threadId.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n  return new RegExp(`(^|[^A-Za-z0-9_-])${escaped}($|[^A-Za-z0-9_-])`).test(body);\n}\n\n/** True when a per-thread write was rejected because the backend has no such route. */\nfunction isThreadRouteUnavailableError(error: unknown, code: AthenaSdkErrorCode): boolean {\n  return isAthenaSdkError(error) && error.code === code && error.context.route_missing === true;\n}\n\n/**\n * Pin (favorite) or unpin a thread for the calling user. The response is the\n * server's truth after the write. Rejections: 401 / 403 when the caller\n * cannot view the thread (`auth_rejected`), otherwise `thread_favorite_failed`\n * with the HTTP status — 404 / 405 from an agora that predates the route,\n * which `isThreadFavoriteUnavailableError` recognizes so callers can fall\n * back to a read-only pin.\n */\nexport async function setThreadFavorite(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isFavorited: boolean },\n): Promise<ThreadFavoriteResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/favorite`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_favorited: opts.isFavorited,\n    }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      opts.threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_favorite_failed',\n      message: `Failed to set thread favorite: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot view this thread.'\n        : routeMissing\n          ? 'The backend has no favorite route yet (older agora); the pin stays read-only until it deploys.'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n  return res.json();\n}\n\n/**\n * True when `setThreadFavorite` failed because the backend has no favorite\n * route (a 405, or a 404 whose body does not name the thread — see\n * `classifyThreadRouteRejection`); a 404 for a thread that is gone is a\n * per-row failure and leaves the toggle available.\n */\nexport function isThreadFavoriteUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_favorite_failed');\n}\n\nexport interface ThreadRenameResponse {\n  thread_id: string;\n  /** The stored title after the write (trimmed by the server). */\n  title: string;\n}\n\n/** The longest title the rename route accepts; the server answers 422 past it. */\nexport const THREAD_TITLE_MAX_LENGTH = 200;\n\n/**\n * Rename a thread for every viewer (`POST /api/conversations/threads/rename`).\n * The server trims the title and stores 1–200 characters; the response is the\n * row's title after the write. Rejections: 401 / 403 when the caller cannot\n * edit the thread (`auth_rejected` — a viewer can pin a shared session but not\n * retitle it), otherwise `thread_rename_failed` with the HTTP status — 404 /\n * 405 from an agora that predates the route, which\n * `isThreadRenameUnavailableError` recognizes so callers can drop the action.\n */\nexport async function renameThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; title: string },\n): Promise<ThreadRenameResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/rename`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      title: opts.title,\n    }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      opts.threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_rename_failed',\n      message: `Failed to rename thread: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot edit this thread (a viewer can pin a shared session, not retitle it).'\n        : routeMissing\n          ? 'The backend has no rename route yet (older agora); sessions cannot be renamed from here until it deploys.'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : res.status === 422\n              ? `The title must be 1–${THREAD_TITLE_MAX_LENGTH} characters after trimming.`\n              : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n  return res.json();\n}\n\n/**\n * True when `renameThread` failed because the backend has no rename route\n * (a 405, or a 404 whose body does not name the thread); a 404 for a thread\n * that is gone is a per-row failure and leaves the action offered.\n */\nexport function isThreadRenameUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_rename_failed');\n}\n\n/**\n * True when `archiveThread` failed because the backend offers no archive\n * route: a 405, FastAPI's bare 404 on an agora without the route, or the\n * route's own `\"Endpoint not available\"` 404 on an agora without the\n * checkpointer. The route's `\"Thread <id> not found\"` 404 for a stale row is\n * a per-row failure and leaves the action offered on every other row.\n */\nexport function isThreadArchiveUnavailableError(error: unknown): boolean {\n  return isThreadRouteUnavailableError(error, 'thread_archive_failed');\n}\n\nexport async function createThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { systemPrompt?: string; enabledTools?: string[]; appId?: string } = {},\n): Promise<ThreadCreateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/unstable/threads/`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      config: {\n        system_prompt: opts.systemPrompt ?? '',\n        enabled_tools: opts.enabledTools,\n        ...(opts.appId ? { app_id: opts.appId } : {}),\n      },\n    }),\n  });\n  if (!res.ok) {\n    throw new Error(`[AthenaSDK] Failed to create thread: ${res.status}`);\n  }\n  return res.json();\n}\n\nexport interface ThreadStateResponse {\n  thread_id: string;\n  messages: unknown[];\n  status?: string;\n  [key: string]: unknown;\n}\n\ninterface ConversationThreadResponse {\n  thread?: {\n    thread_id?: string;\n    state?: string | null;\n    channel_values?: Record<string, unknown> | null;\n    messages?: unknown[] | null;\n  } | null;\n  thread_found?: boolean;\n}\n\n/**\n * Deserialize a LangChain serialized message.\n * The API returns messages in `{lc, type: \"constructor\", id, kwargs}` format.\n * We need the plain format: `{type: \"human\", content: \"...\", id: \"...\"}`.\n */\nfunction deserializeMessage(msg: unknown): unknown {\n  if (\n    msg &&\n    typeof msg === 'object' &&\n    'lc' in msg &&\n    'kwargs' in msg &&\n    (msg as Record<string, unknown>).type === 'constructor'\n  ) {\n    const kwargs = (msg as { kwargs: Record<string, unknown> }).kwargs;\n\n    // Recursively deserialize nested content without mutating the original\n    const deserializedToolCalls = Array.isArray(kwargs.tool_calls)\n      ? kwargs.tool_calls.map((tc: unknown) => {\n          if (tc && typeof tc === 'object' && 'lc' in tc && 'kwargs' in tc) {\n            return (tc as { kwargs: unknown }).kwargs;\n          }\n          return tc;\n        })\n      : kwargs.tool_calls;\n\n    return { ...kwargs, tool_calls: deserializedToolCalls };\n  }\n  return msg;\n}\n\n/** Return a non-sensitive auth label for request diagnostics. */\nfunction getAuthMode(auth: AuthConfig): 'bearer' | 'api-key' | 'none' {\n  if (auth.token) {\n    return 'bearer';\n  }\n  if (auth.apiKey) {\n    return 'api-key';\n  }\n  return 'none';\n}\n\n/** Safely read a response body for error messages without masking the root failure. */\nfunction getResponseErrorBody(response: Response): Promise<string> {\n  return response.text().catch(() => '');\n}\n\n/**\n * Fetch persisted thread state from the conversations API.\n *\n * This endpoint is the same source used by Athena's conversation sidebar and\n * supports API-key auth plus BYO SSO session tokens sent as Bearer tokens.\n */\nexport async function getThreadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  threadId: string,\n  opts: {\n    /**\n     * Bypass the server's Redis thread cache and read the checkpoint (default\n     * `true`, the history load's contract). A warm-up read that only seeds a\n     * first paint passes `false`: the cached copy is cheaper and the attach\n     * snapshot replaces it anyway.\n     */\n    skipCache?: boolean;\n    signal?: AbortSignal;\n  } = {},\n): Promise<ThreadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const authMode = getAuthMode(auth);\n  const endpoint = `${base}/api/conversations/threads/get`;\n\n  const endSpan = athenaDiagnostics.span('threads.history', 'threads.history.start', {\n    thread_id: threadId,\n    auth_mode: authMode,\n  });\n\n  let res: Response;\n  try {\n    res = await fetch(endpoint, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n      signal: opts.signal ?? null,\n      body: JSON.stringify({\n        thread_id: threadId,\n        skip_cache: opts.skipCache ?? true,\n      }),\n    });\n  } catch (error) {\n    if (isAbortError(error)) {\n      endSpan('threads.history.aborted', {\n        data: { thread_id: threadId, reason: 'request aborted' },\n      });\n    } else {\n      endSpan('threads.history.error', { error, data: { thread_id: threadId } });\n    }\n    throw error;\n  }\n  if (!res.ok) {\n    const body = await getResponseErrorBody(res);\n    const error = new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'thread_load_failed',\n      message: `Failed to get thread state: ${res.status} (${authMode})${\n        body ? `: ${body.slice(0, 300)}` : ''\n      }`,\n      status: res.status,\n      hint: 'A brand-new thread may not be persisted yet; anything else means the credential or backendUrl is wrong.',\n      context: { thread_id: threadId, auth_mode: authMode },\n    });\n    endSpan('threads.history.error', { error, data: { thread_id: threadId } });\n    throw error;\n  }\n  const data = (await res.json()) as ConversationThreadResponse;\n  const channelMessages = data.thread?.channel_values?.messages;\n  endSpan('threads.history.done', {\n    data: {\n      thread_id: threadId,\n      found: data.thread_found !== false,\n      message_count: Array.isArray(channelMessages)\n        ? channelMessages.length\n        : (data.thread?.messages?.length ?? 0),\n    },\n  });\n  const thread = data.thread;\n\n  if (data.thread_found === false || !thread) {\n    return {\n      thread_id: threadId,\n      messages: [],\n    };\n  }\n\n  const channelValues = thread.channel_values ?? {};\n  const rawMessages = Array.isArray(channelValues.messages)\n    ? channelValues.messages\n    : Array.isArray(thread.messages)\n      ? thread.messages\n      : [];\n\n  return {\n    ...channelValues,\n    thread_id: thread.thread_id ?? threadId,\n    messages: rawMessages.map(deserializeMessage),\n    ...(thread.state ? { status: thread.state } : {}),\n  };\n}\n\n/**\n * Archive a thread (`POST /api/conversations/threads/archive`): it leaves\n * every list but keeps its state. Rejections: 401 / 403 when the caller\n * cannot access the thread (`auth_rejected`), otherwise\n * `thread_archive_failed` with the HTTP status — 404 / 405 when the backend\n * has no archive route, which `isThreadArchiveUnavailableError` recognizes.\n */\nexport async function archiveThread(\n  backendUrl: string,\n  auth: AuthConfig,\n  threadId: string,\n): Promise<void> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/archive`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({ thread_id: threadId }),\n  });\n  if (!res.ok) {\n    const refused = res.status === 401 || res.status === 403;\n    const { routeMissing, detail } = classifyThreadRouteRejection(\n      res.status,\n      await getResponseErrorBody(res),\n      threadId,\n    );\n    throw new AthenaSdkError({\n      code: refused ? 'auth_rejected' : 'thread_archive_failed',\n      message: `Failed to archive thread: ${res.status}`,\n      status: res.status,\n      detail,\n      hint: refused\n        ? 'The credential cannot access this thread.'\n        : routeMissing\n          ? 'The backend has no archive route (no checkpointer, or an older agora).'\n          : res.status === 404\n            ? 'The thread no longer exists on the server (archived or deleted elsewhere); refresh the list.'\n            : 'Check backendUrl points at the Agora API base.',\n      context: { thread_id: threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing },\n    });\n  }\n}\n"],"names":[],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-model.cjs","sources":["../../src/threads/use-athena-thread-model.ts"],"sourcesContent":["import { useContext, useMemo } from 'react';\nimport { type AthenaThreadModel, threadModelFromLane } from '../runtime/statewire-model-lane';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\nexport type { AthenaThreadModel };\n\n/**\n * The model the active thread's server config pins, read from the thread's\n * config lane (`state.config.custom.model`) as the statewire host sent it.\n *\n * Once a thread has run, its server config (not the provider's `model` prop)\n * decides which model each turn uses; another client (Olympus, a second tab)\n * can change it at any time. Read this hook when a session opens to show the\n * session's real model in your picker: `{ model: null, configured: true }` is\n * a thread that pins no model, so the collab agent's own model (or the\n * default) runs. Wait for `ready`: until the host's snapshot of the thread has\n * arrived every thread reads as unconfigured, and a never-started chat stays\n * not ready until its first send attaches it.\n *\n * The value is the server's: a model change the provider is still writing\n * shows here once the server has applied it. Seed the picker from it when the\n * thread opens, rather than mirroring it on every render.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadModel(): AthenaThreadModel {\n  const threadModel = useOptionalAthenaThreadModel();\n  if (threadModel === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadModel must be used within <AthenaProvider>');\n  }\n  return threadModel;\n}\n\n/**\n * {@link useAthenaThreadModel}, or `null` outside `<AthenaProvider>` (a picker\n * a host renders beside the chat rather than in it). Internal.\n */\nexport function useOptionalAthenaThreadModel(): AthenaThreadModel | null {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  return useMemo(\n    () => (lane === null ? null : threadModelFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n}\n"],"names":["useContext","AthenaStatewireServerLaneContext","useMemo","threadModelFromLane"],"mappings":";;;;;AAyBO,SAAS,uBAA0C;AACxD,QAAM,cAAc,6BAAA;AACpB,MAAI,gBAAgB,MAAM;AACxB,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;AAMO,SAAS,+BAAyD;AACvE,QAAM,OAAOA,MAAAA,WAAWC,2DAAgC;AACxD,SAAOC,MAAAA;AAAAA,IACL,MAAO,SAAS,OAAO,OAAOC,mBAAAA,oBAAoB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC3F,CAAC,IAAI;AAAA,EAAA;AAET;;;"}

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

@@ -0,0 +1,27 @@
+import { type AthenaThreadModel } from '../runtime/statewire-model-lane';
+export type { AthenaThreadModel };
+/**
+ * The model the active thread's server config pins, read from the thread's
+ * config lane (`state.config.custom.model`) as the statewire host sent it.
+ *
+ * Once a thread has run, its server config (not the provider's `model` prop)
+ * decides which model each turn uses; another client (Olympus, a second tab)
+ * can change it at any time. Read this hook when a session opens to show the
+ * session's real model in your picker: `{ model: null, configured: true }` is
+ * a thread that pins no model, so the collab agent's own model (or the
+ * default) runs. Wait for `ready`: until the host's snapshot of the thread has
+ * arrived every thread reads as unconfigured, and a never-started chat stays
+ * not ready until its first send attaches it.
+ *
+ * The value is the server's: a model change the provider is still writing
+ * shows here once the server has applied it. Seed the picker from it when the
+ * thread opens, rather than mirroring it on every render.
+ *
+ * Must be used within `<AthenaProvider>`.
+ */
+export declare function useAthenaThreadModel(): AthenaThreadModel;
+/**
+ * {@link useAthenaThreadModel}, or `null` outside `<AthenaProvider>` (a picker
+ * a host renders beside the chat rather than in it). Internal.
+ */
+export declare function useOptionalAthenaThreadModel(): AthenaThreadModel | null;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-athena-thread-model.js","sources":["../../src/threads/use-athena-thread-model.ts"],"sourcesContent":["import { useContext, useMemo } from 'react';\nimport { type AthenaThreadModel, threadModelFromLane } from '../runtime/statewire-model-lane';\nimport { AthenaStatewireServerLaneContext } from '../runtime/statewire-server-lane-context';\n\nexport type { AthenaThreadModel };\n\n/**\n * The model the active thread's server config pins, read from the thread's\n * config lane (`state.config.custom.model`) as the statewire host sent it.\n *\n * Once a thread has run, its server config (not the provider's `model` prop)\n * decides which model each turn uses; another client (Olympus, a second tab)\n * can change it at any time. Read this hook when a session opens to show the\n * session's real model in your picker: `{ model: null, configured: true }` is\n * a thread that pins no model, so the collab agent's own model (or the\n * default) runs. Wait for `ready`: until the host's snapshot of the thread has\n * arrived every thread reads as unconfigured, and a never-started chat stays\n * not ready until its first send attaches it.\n *\n * The value is the server's: a model change the provider is still writing\n * shows here once the server has applied it. Seed the picker from it when the\n * thread opens, rather than mirroring it on every render.\n *\n * Must be used within `<AthenaProvider>`.\n */\nexport function useAthenaThreadModel(): AthenaThreadModel {\n  const threadModel = useOptionalAthenaThreadModel();\n  if (threadModel === null) {\n    throw new Error('[AthenaSDK] useAthenaThreadModel must be used within <AthenaProvider>');\n  }\n  return threadModel;\n}\n\n/**\n * {@link useAthenaThreadModel}, or `null` outside `<AthenaProvider>` (a picker\n * a host renders beside the chat rather than in it). Internal.\n */\nexport function useOptionalAthenaThreadModel(): AthenaThreadModel | null {\n  const lane = useContext(AthenaStatewireServerLaneContext);\n  return useMemo(\n    () => (lane === null ? null : threadModelFromLane({ lane: lane.config, ready: lane.landed })),\n    [lane],\n  );\n}\n"],"names":[],"mappings":";;;AAyBO,SAAS,uBAA0C;AACxD,QAAM,cAAc,6BAAA;AACpB,MAAI,gBAAgB,MAAM;AACxB,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;AAMO,SAAS,+BAAyD;AACvE,QAAM,OAAO,WAAW,gCAAgC;AACxD,SAAO;AAAA,IACL,MAAO,SAAS,OAAO,OAAO,oBAAoB,EAAE,MAAM,KAAK,QAAQ,OAAO,KAAK,OAAA,CAAQ;AAAA,IAC3F,CAAC,IAAI;AAAA,EAAA;AAET;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@athenaintel/react",
-  "version": "0.30.0",
+  "version": "0.35.0",
   "description": "Athena React SDK — Build AI-powered chat applications with the Athena platform",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -99,7 +99,7 @@
     "@assistant-ui/react": "0.15.28",
     "@assistant-ui/react-langgraph": "0.14.34",
     "@assistant-ui/react-markdown": "0.14.21",
-    "@assistant-ui/react-statewire": "0.30.0",
+    "@assistant-ui/react-statewire": "0.31.0",
     "@assistant-ui/store": "0.3.21",
     "@assistant-ui/tap": "0.9.23",
     "@floating-ui/react": "^0.27.7",
@@ -120,14 +120,14 @@
     "@tiptap/starter-kit": "^3.31.3",
     "@tiptap/suggestion": "^3.31.3",
     "@y/websocket": "4.0.0-rc.2",
-    "@y/y": "14.0.0-rc.28",
+    "@y/y": "14.0.0-rc.29",
     "assistant-stream": "0.3.50",
     "class-variance-authority": "^0.7.1",
     "cnfast": "0.0.8",
     "lucide-react": "^0.575.0",
     "radix-ui": "^1.4.3",
     "remark-gfm": "^4.0.0",
-    "statewire": "0.20.0",
+    "statewire": "0.21.0",
     "tiptap-markdown": "^0.9.0",
     "zustand": "^5.0.11"
   },