@athenaintel/react 0.48.0 → 0.50.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  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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"}
+{"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   * Whether the page also holds the conversations with the `home_agent_id`\n   * agent: true only when the request named one, the agent has a home app set\n   * and the caller can open the agent. Servers that predate the field omit it,\n   * which reads as false.\n   */\n  home_agent_applied?: boolean;\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  /**\n   * A collab agent (`asset_<uuid>`) whose home this list's app is. When the\n   * agent has a home app set and the caller can open the agent, the app scope\n   * (`app_id` / `app_ids`) widens to every conversation with the agent too,\n   * ANDed with the other filters as usual; `home_agent_applied` on the answer\n   * says whether it did.\n   */\n  home_agent_id?: 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

@@ -86,6 +86,13 @@ export interface ThreadListResponse {
      * `ThreadListFilterBody` fields are applied there).
      */
     supported_filters?: string[];
+    /**
+     * Whether the page also holds the conversations with the `home_agent_id`
+     * agent: true only when the request named one, the agent has a home app set
+     * and the caller can open the agent. Servers that predate the field omit it,
+     * which reads as false.
+     */
+    home_agent_applied?: boolean;
 }
 /**
  * The server-side filters and order of `POST /api/conversations/threads/list`
@@ -99,6 +106,14 @@ export interface ThreadListFilterBody {
     search?: string;
     exclude_triggered?: boolean;
     app_ids?: string[];
+    /**
+     * A collab agent (`asset_<uuid>`) whose home this list's app is. When the
+     * agent has a home app set and the caller can open the agent, the app scope
+     * (`app_id` / `app_ids`) widens to every conversation with the agent too,
+     * ANDed with the other filters as usual; `home_agent_applied` on the answer
+     * says whether it did.
+     */
+    home_agent_id?: string;
     start_channels?: string[];
     created_after?: string;
     created_before?: string;

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  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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"}
+{"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   * Whether the page also holds the conversations with the `home_agent_id`\n   * agent: true only when the request named one, the agent has a home app set\n   * and the caller can open the agent. Servers that predate the field omit it,\n   * which reads as false.\n   */\n  home_agent_applied?: boolean;\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  /**\n   * A collab agent (`asset_<uuid>`) whose home this list's app is. When the\n   * agent has a home app set and the caller can open the agent, the app scope\n   * (`app_id` / `app_ids`) widens to every conversation with the agent too,\n   * ANDed with the other filters as usual; `home_agent_applied` on the answer\n   * says whether it did.\n   */\n  home_agent_id?: 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/conversation-list-fetcher.cjs

@@ -26,6 +26,7 @@ function threadListRequestBody(params) {
     ...filter.excludeTriggered !== void 0 ? { exclude_triggered: filter.excludeTriggered } : {},
     ...filter.appId ? { app_id: filter.appId } : {},
     ...filter.appIds && filter.appIds.length > 0 ? { app_ids: [...filter.appIds] } : {},
+    ...filter.homeAgentId ? { home_agent_id: filter.homeAgentId } : {},
     ...((_a = filter.sourceChannels) == null ? void 0 : _a[0]) ? { start_channel: filter.sourceChannels[0] } : {},
     ...filter.search ? { search: filter.search } : {}
   };
@@ -47,6 +48,7 @@ function conversationWakeFromThreadWake(wake) {
   return { source: wake.source ?? null, reason: wake.reason ?? null, at: wake.at ?? null };
 }
 function conversationSummaryFromThreadSummary(thread, filter) {
+  const requestedOnlyApp = filter.appIds && filter.appIds.length > 0 || filter.homeAgentId ? void 0 : filter.appId;
   return {
     threadId: thread.thread_id,
     title: thread.title,
@@ -58,7 +60,7 @@ function conversationSummaryFromThreadSummary(thread, filter) {
     sourceChannel: thread.start_channel ?? null,
     assetType: null,
     assetId: null,
-    appId: thread.app_id ?? filter.appId ?? null,
+    appId: thread.app_id ?? requestedOnlyApp ?? null,
     collabAgentId: thread.collab_agent_id,
     collabChannelId: thread.collab_channel_id,
     triggerType: thread.trigger_type ?? null,
@@ -79,9 +81,13 @@ function conversationSummaryFromThreadSummary(thread, filter) {
 }
 function createRestConversationListFetcher(options) {
   return async (params) => {
-    const { app_ids: appIds, ...body } = threadListRequestBody(params);
-    const filters = appIds || options.extraFilters ? { ...appIds ? { app_ids: appIds } : {}, ...options.extraFilters } : void 0;
-    const { threads, has_more: hasMore } = await credentialRenewal.withCredentialRenewal(
+    const { app_ids: appIds, home_agent_id: homeAgentId, ...body } = threadListRequestBody(params);
+    const filters = appIds || homeAgentId || options.extraFilters ? {
+      ...appIds ? { app_ids: appIds } : {},
+      ...homeAgentId ? { home_agent_id: homeAgentId } : {},
+      ...options.extraFilters
+    } : void 0;
+    const response = await credentialRenewal.withCredentialRenewal(
       options.getAuth,
       (auth) => api.listThreads(options.backendUrl, auth, {
         ...body,
@@ -90,11 +96,13 @@ function createRestConversationListFetcher(options) {
         signal: params.signal
       })
     );
+    const { threads, has_more: hasMore } = response;
     const items = threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter));
     return {
       items: options.keepRow ? items.filter(options.keepRow) : items,
       hasMore: hasMore ?? threads.length >= params.limit,
-      totalCount: null
+      totalCount: null,
+      ...homeAgentId && response.home_agent_applied === true ? { homeAgentApplied: true } : {}
     };
   };
 }

package/dist/threads/conversation-list-fetcher.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-list-fetcher.cjs","sources":["../../src/threads/conversation-list-fetcher.ts"],"sourcesContent":["/**\n * REST adapter for the shared conversation-list contract\n * (`@athenaintel/agent-runtime` — thread-list-contract-convergence).\n *\n * Translates the canonical {@link ConversationListFetchParams} onto Agora's\n * `POST /api/conversations/threads/list` and maps its `ThreadSummary` rows\n * into the canonical {@link ConversationSummary} shape. Filter fields this\n * transport cannot express throw instead of being ignored — a dropped filter\n * would return wrong rows under a cache key that claims otherwise.\n */\n\nimport type {\n  ConversationListFetcher,\n  ConversationListFetchParams,\n  ConversationListFilter,\n  ConversationListPage,\n  ConversationPullRequest,\n  ConversationSummary,\n  ConversationWake,\n} from '@athenaintel/agent-runtime';\nimport { type CredentialResolver, withCredentialRenewal } from '../runtime/credential-renewal';\nimport {\n  listThreads,\n  type ThreadListFilterBody,\n  type ThreadPullRequest,\n  type ThreadSummary,\n  type ThreadWake,\n} from './api';\n\nexport interface ThreadListRequestBody {\n  limit: number;\n  offset: number;\n  exclude_triggered?: boolean;\n  app_id?: string;\n  app_ids?: string[];\n  start_channel?: string;\n  search?: string;\n}\n\n/**\n * Map the canonical filter onto the REST thread-list request body.\n * Exported for tests; throws on filter fields the endpoint cannot express.\n */\nexport function threadListRequestBody(\n  params: Pick<ConversationListFetchParams, 'limit' | 'offset' | 'filter'>,\n): ThreadListRequestBody {\n  const { filter } = params;\n  const unsupported: string[] = [];\n  if (filter.assetTypes && filter.assetTypes.length > 0) unsupported.push('assetTypes');\n  if (filter.states && filter.states.length > 0) unsupported.push('states');\n  if (filter.sourceChannels && filter.sourceChannels.length > 1) {\n    unsupported.push('sourceChannels (more than one)');\n  }\n  if (filter.excludeSourceChannels && filter.excludeSourceChannels.length > 0) {\n    unsupported.push('excludeSourceChannels');\n  }\n  if (filter.computerAssetId) unsupported.push('computerAssetId');\n  if (unsupported.length > 0) {\n    throw new Error(\n      `[AthenaSDK] The REST thread list cannot express filter field(s): ${unsupported.join(', ')}`,\n    );\n  }\n  return {\n    limit: params.limit,\n    offset: params.offset,\n    ...(filter.excludeTriggered !== undefined\n      ? { exclude_triggered: filter.excludeTriggered }\n      : {}),\n    ...(filter.appId ? { app_id: filter.appId } : {}),\n    ...(filter.appIds && filter.appIds.length > 0 ? { app_ids: [...filter.appIds] } : {}),\n    ...(filter.sourceChannels?.[0] ? { start_channel: filter.sourceChannels[0] } : {}),\n    ...(filter.search ? { search: filter.search } : {}),\n  };\n}\n\n/** Map one REST pull-request record onto the canonical camelCase shape. */\nexport function conversationPullRequestFromThreadPullRequest(\n  record: ThreadPullRequest,\n): ConversationPullRequest {\n  return {\n    repoFullName: record.repo_full_name,\n    number: record.number,\n    url: record.url,\n    title: record.title,\n    state: record.state,\n    isDraft: record.is_draft,\n    reviewDecision: record.review_decision ?? null,\n    checksState: record.checks_state,\n    updatedAt: record.updated_at,\n  };\n}\n\nfunction conversationWakeFromThreadWake(wake: ThreadWake): ConversationWake {\n  return { source: wake.source ?? null, reason: wake.reason ?? null, at: wake.at ?? null };\n}\n\n/**\n * Map a REST `ThreadSummary` row into the canonical contract shape. Fields\n * the server did not send stay `undefined` (an older server, or a list that\n * did not opt into pull requests), so a consumer can tell \"not reported\"\n * from \"reported as none\".\n */\nexport function conversationSummaryFromThreadSummary(\n  thread: ThreadSummary,\n  filter: ConversationListFilter,\n): ConversationSummary {\n  return {\n    threadId: thread.thread_id,\n    title: thread.title,\n    updatedAt: thread.updated_at,\n    createdAt: thread.created_at ?? null,\n    state: thread.state,\n    // Not reported by this endpoint.\n    runtime: null,\n    sourceChannel: thread.start_channel ?? null,\n    assetType: null,\n    assetId: null,\n    appId: thread.app_id ?? filter.appId ?? null,\n    collabAgentId: thread.collab_agent_id,\n    collabChannelId: thread.collab_channel_id,\n    triggerType: thread.trigger_type ?? null,\n    preview: thread.last_message ?? null,\n    messageCount: thread.message_count ?? null,\n    isUnread: thread.is_unread ?? false,\n    // Older servers omit the status planes; `isConversationRunning` then falls back to `state`.\n    sessionStatus: thread.session_status ?? null,\n    runStatus: thread.run_status ?? null,\n    attention: thread.attention,\n    nextAction: thread.next_action,\n    attentionSource: thread.attention_source,\n    isFavorited: thread.is_favorited,\n    createdByMe: thread.created_by_me,\n    lastWake:\n      thread.last_wake === undefined || thread.last_wake === null\n        ? thread.last_wake\n        : conversationWakeFromThreadWake(thread.last_wake),\n    pullRequests:\n      thread.pull_requests === undefined || thread.pull_requests === null\n        ? thread.pull_requests\n        : thread.pull_requests.map(conversationPullRequestFromThreadPullRequest),\n  };\n}\n\nexport interface RestConversationListFetcherOptions {\n  backendUrl: string;\n  /**\n   * Resolved per request so rotating tokens never go stale in the fetcher;\n   * called again with `{ force: true }` when the host refuses the token.\n   */\n  getAuth: CredentialResolver<{ apiKey?: string; token?: string | null }>;\n  /**\n   * Ask the server for live GitHub state on each row's `pullRequests`\n   * (`include_pull_requests`). Off by default: it costs the server a lookup,\n   * so only a list that renders pull-request chips opts in.\n   */\n  includePullRequests?: boolean;\n  /**\n   * Server-side filters and order beyond the shared filter contract\n   * (`SessionsPage` / `Inbox`). The caller keys its cache on them (the\n   * pager's `scopeKey`), since the contract's filter key does not carry them.\n   */\n  extraFilters?: ThreadListFilterBody;\n  /**\n   * Rows a page keeps — the filters this server cannot apply, checked on the\n   * rows it returned (`planSessionsQuery`'s `local`). Such a page can come\n   * back short while `hasMore` stays true.\n   */\n  keepRow?: (row: ConversationSummary) => boolean;\n}\n\n/**\n * Build a {@link ConversationListFetcher} over the REST thread list. The\n * endpoint reports no `hasMore`/total, so `hasMore` is the standard offset\n * heuristic (a full page implies more may exist) and `totalCount` is null.\n */\nexport function createRestConversationListFetcher(\n  options: RestConversationListFetcherOptions,\n): ConversationListFetcher {\n  return async (params): Promise<ConversationListPage> => {\n    const { app_ids: appIds, ...body } = threadListRequestBody(params);\n    const filters: ThreadListFilterBody | undefined =\n      appIds || options.extraFilters\n        ? { ...(appIds ? { app_ids: appIds } : {}), ...options.extraFilters }\n        : undefined;\n    const { threads, has_more: hasMore } = await withCredentialRenewal(options.getAuth, (auth) =>\n      listThreads(options.backendUrl, auth, {\n        ...body,\n        ...(options.includePullRequests ? { include_pull_requests: true } : {}),\n        ...(filters ? { filters } : {}),\n        signal: params.signal,\n      }),\n    );\n    const items = threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter));\n    return {\n      items: options.keepRow ? items.filter(options.keepRow) : items,\n      hasMore: hasMore ?? threads.length >= params.limit,\n      totalCount: null,\n    };\n  };\n}\n"],"names":["withCredentialRenewal","listThreads"],"mappings":"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"}
+{"version":3,"file":"conversation-list-fetcher.cjs","sources":["../../src/threads/conversation-list-fetcher.ts"],"sourcesContent":["/**\n * REST adapter for the shared conversation-list contract\n * (`@athenaintel/agent-runtime` — thread-list-contract-convergence).\n *\n * Translates the canonical {@link ConversationListFetchParams} onto Agora's\n * `POST /api/conversations/threads/list` and maps its `ThreadSummary` rows\n * into the canonical {@link ConversationSummary} shape. Filter fields this\n * transport cannot express throw instead of being ignored — a dropped filter\n * would return wrong rows under a cache key that claims otherwise.\n */\n\nimport type {\n  ConversationListFetcher,\n  ConversationListFetchParams,\n  ConversationListFilter,\n  ConversationListPage,\n  ConversationPullRequest,\n  ConversationSummary,\n  ConversationWake,\n} from '@athenaintel/agent-runtime';\nimport { type CredentialResolver, withCredentialRenewal } from '../runtime/credential-renewal';\nimport {\n  listThreads,\n  type ThreadListFilterBody,\n  type ThreadPullRequest,\n  type ThreadSummary,\n  type ThreadWake,\n} from './api';\n\nexport interface ThreadListRequestBody {\n  limit: number;\n  offset: number;\n  exclude_triggered?: boolean;\n  app_id?: string;\n  app_ids?: string[];\n  home_agent_id?: string;\n  start_channel?: string;\n  search?: string;\n}\n\n/**\n * Map the canonical filter onto the REST thread-list request body.\n * Exported for tests; throws on filter fields the endpoint cannot express.\n */\nexport function threadListRequestBody(\n  params: Pick<ConversationListFetchParams, 'limit' | 'offset' | 'filter'>,\n): ThreadListRequestBody {\n  const { filter } = params;\n  const unsupported: string[] = [];\n  if (filter.assetTypes && filter.assetTypes.length > 0) unsupported.push('assetTypes');\n  if (filter.states && filter.states.length > 0) unsupported.push('states');\n  if (filter.sourceChannels && filter.sourceChannels.length > 1) {\n    unsupported.push('sourceChannels (more than one)');\n  }\n  if (filter.excludeSourceChannels && filter.excludeSourceChannels.length > 0) {\n    unsupported.push('excludeSourceChannels');\n  }\n  if (filter.computerAssetId) unsupported.push('computerAssetId');\n  if (unsupported.length > 0) {\n    throw new Error(\n      `[AthenaSDK] The REST thread list cannot express filter field(s): ${unsupported.join(', ')}`,\n    );\n  }\n  return {\n    limit: params.limit,\n    offset: params.offset,\n    ...(filter.excludeTriggered !== undefined\n      ? { exclude_triggered: filter.excludeTriggered }\n      : {}),\n    ...(filter.appId ? { app_id: filter.appId } : {}),\n    ...(filter.appIds && filter.appIds.length > 0 ? { app_ids: [...filter.appIds] } : {}),\n    ...(filter.homeAgentId ? { home_agent_id: filter.homeAgentId } : {}),\n    ...(filter.sourceChannels?.[0] ? { start_channel: filter.sourceChannels[0] } : {}),\n    ...(filter.search ? { search: filter.search } : {}),\n  };\n}\n\n/** Map one REST pull-request record onto the canonical camelCase shape. */\nexport function conversationPullRequestFromThreadPullRequest(\n  record: ThreadPullRequest,\n): ConversationPullRequest {\n  return {\n    repoFullName: record.repo_full_name,\n    number: record.number,\n    url: record.url,\n    title: record.title,\n    state: record.state,\n    isDraft: record.is_draft,\n    reviewDecision: record.review_decision ?? null,\n    checksState: record.checks_state,\n    updatedAt: record.updated_at,\n  };\n}\n\nfunction conversationWakeFromThreadWake(wake: ThreadWake): ConversationWake {\n  return { source: wake.source ?? null, reason: wake.reason ?? null, at: wake.at ?? null };\n}\n\n/**\n * Map a REST `ThreadSummary` row into the canonical contract shape. Fields\n * the server did not send stay `undefined` (an older server, or a list that\n * did not opt into pull requests), so a consumer can tell \"not reported\"\n * from \"reported as none\".\n */\nexport function conversationSummaryFromThreadSummary(\n  thread: ThreadSummary,\n  filter: ConversationListFilter,\n): ConversationSummary {\n  // A row that reports no app is the requested app's only when the request named exactly that\n  // app: a list widened to other apps (`appIds`) or to an agent's conversations (`homeAgentId`)\n  // also holds rows of other apps, and of none (a Slack conversation).\n  const requestedOnlyApp =\n    (filter.appIds && filter.appIds.length > 0) || filter.homeAgentId ? undefined : filter.appId;\n  return {\n    threadId: thread.thread_id,\n    title: thread.title,\n    updatedAt: thread.updated_at,\n    createdAt: thread.created_at ?? null,\n    state: thread.state,\n    // Not reported by this endpoint.\n    runtime: null,\n    sourceChannel: thread.start_channel ?? null,\n    assetType: null,\n    assetId: null,\n    appId: thread.app_id ?? requestedOnlyApp ?? null,\n    collabAgentId: thread.collab_agent_id,\n    collabChannelId: thread.collab_channel_id,\n    triggerType: thread.trigger_type ?? null,\n    preview: thread.last_message ?? null,\n    messageCount: thread.message_count ?? null,\n    isUnread: thread.is_unread ?? false,\n    // Older servers omit the status planes; `isConversationRunning` then falls back to `state`.\n    sessionStatus: thread.session_status ?? null,\n    runStatus: thread.run_status ?? null,\n    attention: thread.attention,\n    nextAction: thread.next_action,\n    attentionSource: thread.attention_source,\n    isFavorited: thread.is_favorited,\n    createdByMe: thread.created_by_me,\n    lastWake:\n      thread.last_wake === undefined || thread.last_wake === null\n        ? thread.last_wake\n        : conversationWakeFromThreadWake(thread.last_wake),\n    pullRequests:\n      thread.pull_requests === undefined || thread.pull_requests === null\n        ? thread.pull_requests\n        : thread.pull_requests.map(conversationPullRequestFromThreadPullRequest),\n  };\n}\n\nexport interface RestConversationListFetcherOptions {\n  backendUrl: string;\n  /**\n   * Resolved per request so rotating tokens never go stale in the fetcher;\n   * called again with `{ force: true }` when the host refuses the token.\n   */\n  getAuth: CredentialResolver<{ apiKey?: string; token?: string | null }>;\n  /**\n   * Ask the server for live GitHub state on each row's `pullRequests`\n   * (`include_pull_requests`). Off by default: it costs the server a lookup,\n   * so only a list that renders pull-request chips opts in.\n   */\n  includePullRequests?: boolean;\n  /**\n   * Server-side filters and order beyond the shared filter contract\n   * (`SessionsPage` / `Inbox`). The caller keys its cache on them (the\n   * pager's `scopeKey`), since the contract's filter key does not carry them.\n   */\n  extraFilters?: ThreadListFilterBody;\n  /**\n   * Rows a page keeps — the filters this server cannot apply, checked on the\n   * rows it returned (`planSessionsQuery`'s `local`). Such a page can come\n   * back short while `hasMore` stays true.\n   */\n  keepRow?: (row: ConversationSummary) => boolean;\n}\n\n/**\n * Build a {@link ConversationListFetcher} over the REST thread list. The\n * endpoint reports no `hasMore`/total, so `hasMore` is the standard offset\n * heuristic (a full page implies more may exist) and `totalCount` is null. A\n * page asked for a `homeAgentId` carries `homeAgentApplied: true` only when the\n * server answered `home_agent_applied: true`.\n */\nexport function createRestConversationListFetcher(\n  options: RestConversationListFetcherOptions,\n): ConversationListFetcher {\n  return async (params): Promise<ConversationListPage> => {\n    const { app_ids: appIds, home_agent_id: homeAgentId, ...body } = threadListRequestBody(params);\n    const filters: ThreadListFilterBody | undefined =\n      appIds || homeAgentId || options.extraFilters\n        ? {\n            ...(appIds ? { app_ids: appIds } : {}),\n            ...(homeAgentId ? { home_agent_id: homeAgentId } : {}),\n            ...options.extraFilters,\n          }\n        : undefined;\n    const response = await withCredentialRenewal(options.getAuth, (auth) =>\n      listThreads(options.backendUrl, auth, {\n        ...body,\n        ...(options.includePullRequests ? { include_pull_requests: true } : {}),\n        ...(filters ? { filters } : {}),\n        signal: params.signal,\n      }),\n    );\n    const { threads, has_more: hasMore } = response;\n    const items = threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter));\n    return {\n      items: options.keepRow ? items.filter(options.keepRow) : items,\n      hasMore: hasMore ?? threads.length >= params.limit,\n      totalCount: null,\n      ...(homeAgentId && response.home_agent_applied === true ? { homeAgentApplied: true } : {}),\n    };\n  };\n}\n"],"names":["withCredentialRenewal","listThreads"],"mappings":"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"}

package/dist/threads/conversation-list-fetcher.d.ts

@@ -17,6 +17,7 @@ export interface ThreadListRequestBody {
     exclude_triggered?: boolean;
     app_id?: string;
     app_ids?: string[];
+    home_agent_id?: string;
     start_channel?: string;
     search?: string;
 }
@@ -66,6 +67,8 @@ export interface RestConversationListFetcherOptions {
 /**
  * Build a {@link ConversationListFetcher} over the REST thread list. The
  * endpoint reports no `hasMore`/total, so `hasMore` is the standard offset
- * heuristic (a full page implies more may exist) and `totalCount` is null.
+ * heuristic (a full page implies more may exist) and `totalCount` is null. A
+ * page asked for a `homeAgentId` carries `homeAgentApplied: true` only when the
+ * server answered `home_agent_applied: true`.
  */
 export declare function createRestConversationListFetcher(options: RestConversationListFetcherOptions): ConversationListFetcher;

package/dist/threads/conversation-list-fetcher.js

@@ -24,6 +24,7 @@ function threadListRequestBody(params) {
     ...filter.excludeTriggered !== void 0 ? { exclude_triggered: filter.excludeTriggered } : {},
     ...filter.appId ? { app_id: filter.appId } : {},
     ...filter.appIds && filter.appIds.length > 0 ? { app_ids: [...filter.appIds] } : {},
+    ...filter.homeAgentId ? { home_agent_id: filter.homeAgentId } : {},
     ...((_a = filter.sourceChannels) == null ? void 0 : _a[0]) ? { start_channel: filter.sourceChannels[0] } : {},
     ...filter.search ? { search: filter.search } : {}
   };
@@ -45,6 +46,7 @@ function conversationWakeFromThreadWake(wake) {
   return { source: wake.source ?? null, reason: wake.reason ?? null, at: wake.at ?? null };
 }
 function conversationSummaryFromThreadSummary(thread, filter) {
+  const requestedOnlyApp = filter.appIds && filter.appIds.length > 0 || filter.homeAgentId ? void 0 : filter.appId;
   return {
     threadId: thread.thread_id,
     title: thread.title,
@@ -56,7 +58,7 @@ function conversationSummaryFromThreadSummary(thread, filter) {
     sourceChannel: thread.start_channel ?? null,
     assetType: null,
     assetId: null,
-    appId: thread.app_id ?? filter.appId ?? null,
+    appId: thread.app_id ?? requestedOnlyApp ?? null,
     collabAgentId: thread.collab_agent_id,
     collabChannelId: thread.collab_channel_id,
     triggerType: thread.trigger_type ?? null,
@@ -77,9 +79,13 @@ function conversationSummaryFromThreadSummary(thread, filter) {
 }
 function createRestConversationListFetcher(options) {
   return async (params) => {
-    const { app_ids: appIds, ...body } = threadListRequestBody(params);
-    const filters = appIds || options.extraFilters ? { ...appIds ? { app_ids: appIds } : {}, ...options.extraFilters } : void 0;
-    const { threads, has_more: hasMore } = await withCredentialRenewal(
+    const { app_ids: appIds, home_agent_id: homeAgentId, ...body } = threadListRequestBody(params);
+    const filters = appIds || homeAgentId || options.extraFilters ? {
+      ...appIds ? { app_ids: appIds } : {},
+      ...homeAgentId ? { home_agent_id: homeAgentId } : {},
+      ...options.extraFilters
+    } : void 0;
+    const response = await withCredentialRenewal(
       options.getAuth,
       (auth) => listThreads(options.backendUrl, auth, {
         ...body,
@@ -88,11 +94,13 @@ function createRestConversationListFetcher(options) {
         signal: params.signal
       })
     );
+    const { threads, has_more: hasMore } = response;
     const items = threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter));
     return {
       items: options.keepRow ? items.filter(options.keepRow) : items,
       hasMore: hasMore ?? threads.length >= params.limit,
-      totalCount: null
+      totalCount: null,
+      ...homeAgentId && response.home_agent_applied === true ? { homeAgentApplied: true } : {}
     };
   };
 }