@athenaintel/react 0.22.3 → 0.23.0

package/dist/threads/api.cjs

@@ -41,7 +41,8 @@ async function listThreads(backendUrl, auth, opts = {}) {
         exclude_triggered: opts.exclude_triggered ?? false,
         ...opts.app_id ? { app_id: opts.app_id } : {},
         ...opts.start_channel ? { start_channel: opts.start_channel } : {},
-        ...opts.search ? { search: opts.search } : {}
+        ...opts.search ? { search: opts.search } : {},
+        ...opts.include_pull_requests ? { include_pull_requests: true } : {}
       })
     });
     if (!res.ok) {
@@ -108,6 +109,93 @@ async function setThreadReadState(backendUrl, auth, opts) {
   }
   return res.json();
 }
+function classifyThreadRouteRejection(status, body, threadId) {
+  let detail = body || void 0;
+  try {
+    const parsed = JSON.parse(body);
+    if (parsed && typeof parsed === "object") {
+      const record = parsed;
+      detail = record.detail ?? record.message ?? parsed;
+    }
+  } catch {
+  }
+  const routeMissing = status === 405 || status === 404 && !mentionsThread(body, threadId);
+  return { routeMissing, detail };
+}
+function mentionsThread(body, threadId) {
+  if (!threadId) return false;
+  const escaped = threadId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`(^|[^A-Za-z0-9_-])${escaped}($|[^A-Za-z0-9_-])`).test(body);
+}
+function isThreadRouteUnavailableError(error, code) {
+  return errors.isAthenaSdkError(error) && error.code === code && error.context.route_missing === true;
+}
+async function setThreadFavorite(backendUrl, auth, opts) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/conversations/threads/favorite`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({
+      thread_id: opts.threadId,
+      is_favorited: opts.isFavorited
+    })
+  });
+  if (!res.ok) {
+    const refused = res.status === 401 || res.status === 403;
+    const { routeMissing, detail } = classifyThreadRouteRejection(
+      res.status,
+      await getResponseErrorBody(res),
+      opts.threadId
+    );
+    throw new errors.AthenaSdkError({
+      code: refused ? "auth_rejected" : "thread_favorite_failed",
+      message: `Failed to set thread favorite: ${res.status}`,
+      status: res.status,
+      detail,
+      hint: refused ? "The credential cannot view this thread." : routeMissing ? "The backend has no favorite route yet (older agora); the pin stays read-only until it deploys." : res.status === 404 ? "The thread no longer exists on the server (archived or deleted elsewhere); refresh the list." : "Check backendUrl points at the Agora API base.",
+      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing }
+    });
+  }
+  return res.json();
+}
+function isThreadFavoriteUnavailableError(error) {
+  return isThreadRouteUnavailableError(error, "thread_favorite_failed");
+}
+const THREAD_TITLE_MAX_LENGTH = 200;
+async function renameThread(backendUrl, auth, opts) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/conversations/threads/rename`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({
+      thread_id: opts.threadId,
+      title: opts.title
+    })
+  });
+  if (!res.ok) {
+    const refused = res.status === 401 || res.status === 403;
+    const { routeMissing, detail } = classifyThreadRouteRejection(
+      res.status,
+      await getResponseErrorBody(res),
+      opts.threadId
+    );
+    throw new errors.AthenaSdkError({
+      code: refused ? "auth_rejected" : "thread_rename_failed",
+      message: `Failed to rename thread: ${res.status}`,
+      status: res.status,
+      detail,
+      hint: refused ? "The credential cannot edit this thread (a viewer can pin a shared session, not retitle it)." : routeMissing ? "The backend has no rename route yet (older agora); sessions cannot be renamed from here until it deploys." : res.status === 404 ? "The thread no longer exists on the server (archived or deleted elsewhere); refresh the list." : res.status === 422 ? `The title must be 1–${THREAD_TITLE_MAX_LENGTH} characters after trimming.` : "Check backendUrl points at the Agora API base.",
+      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing }
+    });
+  }
+  return res.json();
+}
+function isThreadRenameUnavailableError(error) {
+  return isThreadRouteUnavailableError(error, "thread_rename_failed");
+}
+function isThreadArchiveUnavailableError(error) {
+  return isThreadRouteUnavailableError(error, "thread_archive_failed");
+}
 async function createThread(backendUrl, auth, opts = {}) {
   const base = getAthenaApiBaseUrl(backendUrl);
   const res = await fetch(`${base}/api/unstable/threads/`, {
@@ -151,7 +239,7 @@ function getAuthMode(auth) {
 function getResponseErrorBody(response) {
   return response.text().catch(() => "");
 }
-async function getThreadState(backendUrl, auth, threadId) {
+async function getThreadState(backendUrl, auth, threadId, opts = {}) {
   var _a, _b, _c, _d;
   const base = getAthenaApiBaseUrl(backendUrl);
   const authMode = getAuthMode(auth);
@@ -165,9 +253,10 @@ async function getThreadState(backendUrl, auth, threadId) {
     res = await fetch(endpoint, {
       method: "POST",
       headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+      signal: opts.signal ?? null,
       body: JSON.stringify({
         thread_id: threadId,
-        skip_cache: true
+        skip_cache: opts.skipCache ?? true
       })
     });
   } catch (error) {
@@ -225,13 +314,32 @@ async function archiveThread(backendUrl, auth, threadId) {
     body: JSON.stringify({ thread_id: threadId })
   });
   if (!res.ok) {
-    throw new Error(`[AthenaSDK] Failed to archive thread: ${res.status}`);
+    const refused = res.status === 401 || res.status === 403;
+    const { routeMissing, detail } = classifyThreadRouteRejection(
+      res.status,
+      await getResponseErrorBody(res),
+      threadId
+    );
+    throw new errors.AthenaSdkError({
+      code: refused ? "auth_rejected" : "thread_archive_failed",
+      message: `Failed to archive thread: ${res.status}`,
+      status: res.status,
+      detail,
+      hint: refused ? "The credential cannot access this thread." : routeMissing ? "The backend has no archive route (no checkpointer, or an older agora)." : res.status === 404 ? "The thread no longer exists on the server (archived or deleted elsewhere); refresh the list." : "Check backendUrl points at the Agora API base.",
+      context: { thread_id: threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing }
+    });
   }
 }
+exports.THREAD_TITLE_MAX_LENGTH = THREAD_TITLE_MAX_LENGTH;
 exports.archiveThread = archiveThread;
 exports.createThread = createThread;
 exports.fetchAccountIdentity = fetchAccountIdentity;
 exports.getThreadState = getThreadState;
+exports.isThreadArchiveUnavailableError = isThreadArchiveUnavailableError;
+exports.isThreadFavoriteUnavailableError = isThreadFavoriteUnavailableError;
+exports.isThreadRenameUnavailableError = isThreadRenameUnavailableError;
 exports.listThreads = listThreads;
+exports.renameThread = renameThread;
+exports.setThreadFavorite = setThreadFavorite;
 exports.setThreadReadState = setThreadReadState;
 //# sourceMappingURL=api.cjs.map

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 { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\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  /** 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\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\nexport interface ThreadCreateResponse {\n  thread_id: string;\n}\n\ninterface AuthConfig {\n  apiKey?: string;\n  token?: string | null;\n}\n\nfunction getAuthHeaders(auth: AuthConfig): Record<string, string> {\n  if (auth.token) {\n    return { Authorization: `Bearer ${auth.token}` };\n  }\n  if (auth.apiKey) {\n    return { 'X-API-KEY': auth.apiKey };\n  }\n  return {};\n}\n\n/**\n * Resolves the Athena API base URL from backendUrl.\n * Thread endpoints live under `/api/conversations/threads/*` and `/api/unstable/threads/`.\n * If backendUrl points at a nested Athena endpoint, trim it back to the API base first.\n */\nfunction getAthenaApiBaseUrl(backendUrl: string): string {\n  const stripped = backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '');\n  // If the suffix wasn't found, assume the URL already points to the API base\n  if (stripped === backendUrl) {\n    return backendUrl.replace(/\\/$/, '');\n  }\n  return stripped;\n}\n\nexport async function listThreads(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: {\n    limit?: number;\n    offset?: number;\n    exclude_triggered?: boolean;\n    app_id?: string;\n    start_channel?: string;\n    search?: string;\n    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      }),\n    });\n    if (!res.ok) {\n      throw new AthenaSdkError({\n        code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n        message: `Failed to list threads: ${res.status}`,\n        status: res.status,\n        hint:\n          res.status === 401 || res.status === 403\n            ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n            : 'Check backendUrl points at the Agora API base.',\n        context: { auth_mode: getAuthMode(auth) },\n      });\n    }\n    const data = (await res.json()) as ThreadListResponse;\n    endSpan('threads.list.done', { data: { count: data.threads?.length ?? 0 } });\n    return data;\n  } catch (error) {\n    // Cancellation is lifecycle noise (unmount/remount aborts): log it as an\n    // informational abort, not an error — passing `error` would force the\n    // span end to error level and spam the console.\n    if (isAbortError(error)) {\n      endSpan('threads.list.aborted', { data: { reason: 'request aborted' } });\n    } else {\n      endSpan('threads.list.error', { error });\n    }\n    throw error;\n  }\n}\n\n/** The `(workspace, user)` pair the credential resolves to on the backend. */\nexport interface AccountIdentity {\n  userId: string;\n  /** `null` for a user with no current workspace. */\n  workspaceId: string | null;\n}\n\n/**\n * Resolve the credential's agora identity. The conversation index is one\n * statewire instance per `(workspace, user)`, and neither half is knowable\n * from the credential alone: the SDK's auth context carries an identity\n * provider user id, not agora's, and never a workspace.\n */\nexport async function fetchAccountIdentity(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { signal?: AbortSignal } = {},\n): Promise<AccountIdentity> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/v0/me`, {\n    headers: getAuthHeaders(auth),\n    signal: opts.signal ?? null,\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n      message: `Failed to resolve account identity: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 401 || res.status === 403\n          ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n          : 'Check backendUrl points at the Agora API base.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  const body = (await res.json()) as { user_id?: unknown; workspace_id?: unknown };\n  if (typeof body.user_id !== 'string' || body.user_id.length === 0) {\n    throw new AthenaSdkError({\n      code: 'threads_list_failed',\n      message: 'Account identity lookup returned no user id.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  return {\n    userId: body.user_id,\n    workspaceId: typeof body.workspace_id === 'string' ? body.workspace_id : null,\n  };\n}\n\nexport interface ThreadReadStateResponse {\n  thread_id: string;\n  is_unread: boolean;\n}\n\n/** Store the calling user's read receipt for a thread. */\nexport async function setThreadReadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isUnread: boolean },\n): Promise<ThreadReadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/read-state`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_unread: opts.isUnread,\n    }),\n  });\n  if (!res.ok) {\n    throw new Error(`[AthenaSDK] Failed to set thread read state: ${res.status}`);\n  }\n  return res.json();\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): 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      body: JSON.stringify({\n        thread_id: threadId,\n        skip_cache: 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\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    throw new Error(`[AthenaSDK] Failed to archive thread: ${res.status}`);\n  }\n}\n"],"names":["athenaDiagnostics","AthenaSdkError"],"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  /** 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  /**\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\nexport interface ThreadCreateResponse {\n  thread_id: string;\n}\n\ninterface AuthConfig {\n  apiKey?: string;\n  token?: string | null;\n}\n\nfunction getAuthHeaders(auth: AuthConfig): Record<string, string> {\n  if (auth.token) {\n    return { Authorization: `Bearer ${auth.token}` };\n  }\n  if (auth.apiKey) {\n    return { 'X-API-KEY': auth.apiKey };\n  }\n  return {};\n}\n\n/**\n * Resolves the Athena API base URL from backendUrl.\n * Thread endpoints live under `/api/conversations/threads/*` and `/api/unstable/threads/`.\n * If backendUrl points at a nested Athena endpoint, trim it back to the API base first.\n */\nfunction getAthenaApiBaseUrl(backendUrl: string): string {\n  const stripped = backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '');\n  // If the suffix wasn't found, assume the URL already points to the API base\n  if (stripped === backendUrl) {\n    return backendUrl.replace(/\\/$/, '');\n  }\n  return stripped;\n}\n\nexport async function listThreads(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: {\n    limit?: number;\n    offset?: number;\n    exclude_triggered?: boolean;\n    app_id?: string;\n    start_channel?: string;\n    search?: string;\n    /** Ask the server for live GitHub state on `pull_requests` (off by default: it costs a lookup). */\n    include_pull_requests?: boolean;\n    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      }),\n    });\n    if (!res.ok) {\n      throw new AthenaSdkError({\n        code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n        message: `Failed to list threads: ${res.status}`,\n        status: res.status,\n        hint:\n          res.status === 401 || res.status === 403\n            ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n            : 'Check backendUrl points at the Agora API base.',\n        context: { auth_mode: getAuthMode(auth) },\n      });\n    }\n    const data = (await res.json()) as ThreadListResponse;\n    endSpan('threads.list.done', { data: { count: data.threads?.length ?? 0 } });\n    return data;\n  } catch (error) {\n    // Cancellation is lifecycle noise (unmount/remount aborts): log it as an\n    // informational abort, not an error — passing `error` would force the\n    // span end to error level and spam the console.\n    if (isAbortError(error)) {\n      endSpan('threads.list.aborted', { data: { reason: 'request aborted' } });\n    } else {\n      endSpan('threads.list.error', { error });\n    }\n    throw error;\n  }\n}\n\n/** The `(workspace, user)` pair the credential resolves to on the backend. */\nexport interface AccountIdentity {\n  userId: string;\n  /** `null` for a user with no current workspace. */\n  workspaceId: string | null;\n}\n\n/**\n * Resolve the credential's agora identity. The conversation index is one\n * statewire instance per `(workspace, user)`, and neither half is knowable\n * from the credential alone: the SDK's auth context carries an identity\n * provider user id, not agora's, and never a workspace.\n */\nexport async function fetchAccountIdentity(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { signal?: AbortSignal } = {},\n): Promise<AccountIdentity> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/v0/me`, {\n    headers: getAuthHeaders(auth),\n    signal: opts.signal ?? null,\n  });\n  if (!res.ok) {\n    throw new AthenaSdkError({\n      code: res.status === 401 || res.status === 403 ? 'auth_rejected' : 'threads_list_failed',\n      message: `Failed to resolve account identity: ${res.status}`,\n      status: res.status,\n      hint:\n        res.status === 401 || res.status === 403\n          ? 'The credential was refused. Check the token/API key and that the user belongs to the workspace.'\n          : 'Check backendUrl points at the Agora API base.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  const body = (await res.json()) as { user_id?: unknown; workspace_id?: unknown };\n  if (typeof body.user_id !== 'string' || body.user_id.length === 0) {\n    throw new AthenaSdkError({\n      code: 'threads_list_failed',\n      message: 'Account identity lookup returned no user id.',\n      context: { auth_mode: getAuthMode(auth) },\n    });\n  }\n  return {\n    userId: body.user_id,\n    workspaceId: typeof body.workspace_id === 'string' ? body.workspace_id : null,\n  };\n}\n\nexport interface ThreadReadStateResponse {\n  thread_id: string;\n  is_unread: boolean;\n}\n\n/** Store the calling user's read receipt for a thread. */\nexport async function setThreadReadState(\n  backendUrl: string,\n  auth: AuthConfig,\n  opts: { threadId: string; isUnread: boolean },\n): Promise<ThreadReadStateResponse> {\n  const base = getAthenaApiBaseUrl(backendUrl);\n  const res = await fetch(`${base}/api/conversations/threads/read-state`, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json', ...getAuthHeaders(auth) },\n    body: JSON.stringify({\n      thread_id: opts.threadId,\n      is_unread: opts.isUnread,\n    }),\n  });\n  if (!res.ok) {\n    throw new Error(`[AthenaSDK] Failed to set thread read state: ${res.status}`);\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

@@ -2,6 +2,33 @@
  * Athena thread API client.
  * Calls existing REST endpoints for thread CRUD.
  */
+import type { ConversationAttention, ConversationAttentionSource } from '@athenaintel/agent-runtime';
+/**
+ * Live GitHub state of a pull request the thread opened, read by the server
+ * when the list renders (agora `agent_pr_threads` is the only stored link).
+ */
+export interface ThreadPullRequest {
+    /** `owner/repo` the pull request lives in. */
+    repo_full_name: string;
+    number: number;
+    url: string;
+    title: string;
+    state: 'OPEN' | 'CLOSED' | 'MERGED';
+    is_draft: boolean;
+    /** GitHub's review decision (APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED) or null. */
+    review_decision: string | null;
+    /** Combined state of the checks on the head commit. */
+    checks_state: 'SUCCESS' | 'FAILURE' | 'PENDING' | 'NONE';
+    /** ISO 8601 timestamp of the pull request's last update on GitHub. */
+    updated_at: string;
+}
+/** The last event that woke a resting thread (a GitHub webhook, a schedule, a handoff). */
+export interface ThreadWake {
+    source: string | null;
+    reason: string | null;
+    /** ISO 8601 timestamp of the wake. */
+    at: string | null;
+}
 export interface ThreadSummary {
     thread_id: string;
     title: string;
@@ -18,6 +45,30 @@ export interface ThreadSummary {
     trigger_type?: string | null;
     /** Whether the calling user has seen this thread since it last changed. */
     is_unread?: boolean;
+    /**
+     * Canonical status_v2 planes (`idle | active | needs_input | error` and
+     * `scheduled | queued | running | needs_input | completed | failed |
+     * canceled`); older servers omit them.
+     */
+    session_status?: string | null;
+    run_status?: string | null;
+    /**
+     * The viewer's attention state, the one-line next action (≤ 80 chars) and
+     * the signal that produced them, derived server-side; older servers omit them.
+     */
+    attention?: ConversationAttention | null;
+    next_action?: string | null;
+    attention_source?: ConversationAttentionSource | null;
+    /** Whether the calling user favorited (pinned) the thread; older servers omit it. */
+    is_favorited?: boolean;
+    /** The last wake of a resting thread; older servers omit it. */
+    last_wake?: ThreadWake | null;
+    /**
+     * Pull requests the thread opened with their live GitHub state. `[]` when
+     * it opened none, `null` when the state could not be read right now;
+     * older servers omit the field.
+     */
+    pull_requests?: ThreadPullRequest[] | null;
 }
 export interface ThreadListResponse {
     threads: ThreadSummary[];
@@ -38,6 +89,8 @@ export declare function listThreads(backendUrl: string, auth: AuthConfig, opts?:
     app_id?: string;
     start_channel?: string;
     search?: string;
+    /** Ask the server for live GitHub state on `pull_requests` (off by default: it costs a lookup). */
+    include_pull_requests?: boolean;
     signal?: AbortSignal;
 }): Promise<ThreadListResponse>;
 /** The `(workspace, user)` pair the credential resolves to on the backend. */
@@ -64,6 +117,64 @@ export declare function setThreadReadState(backendUrl: string, auth: AuthConfig,
     threadId: string;
     isUnread: boolean;
 }): Promise<ThreadReadStateResponse>;
+export interface ThreadFavoriteResponse {
+    thread_id: string;
+    /** The server's state after the write. */
+    is_favorited: boolean;
+}
+/**
+ * Pin (favorite) or unpin a thread for the calling user. The response is the
+ * server's truth after the write. Rejections: 401 / 403 when the caller
+ * cannot view the thread (`auth_rejected`), otherwise `thread_favorite_failed`
+ * with the HTTP status — 404 / 405 from an agora that predates the route,
+ * which `isThreadFavoriteUnavailableError` recognizes so callers can fall
+ * back to a read-only pin.
+ */
+export declare function setThreadFavorite(backendUrl: string, auth: AuthConfig, opts: {
+    threadId: string;
+    isFavorited: boolean;
+}): Promise<ThreadFavoriteResponse>;
+/**
+ * True when `setThreadFavorite` failed because the backend has no favorite
+ * route (a 405, or a 404 whose body does not name the thread — see
+ * `classifyThreadRouteRejection`); a 404 for a thread that is gone is a
+ * per-row failure and leaves the toggle available.
+ */
+export declare function isThreadFavoriteUnavailableError(error: unknown): boolean;
+export interface ThreadRenameResponse {
+    thread_id: string;
+    /** The stored title after the write (trimmed by the server). */
+    title: string;
+}
+/** The longest title the rename route accepts; the server answers 422 past it. */
+export declare const THREAD_TITLE_MAX_LENGTH = 200;
+/**
+ * Rename a thread for every viewer (`POST /api/conversations/threads/rename`).
+ * The server trims the title and stores 1–200 characters; the response is the
+ * row's title after the write. Rejections: 401 / 403 when the caller cannot
+ * edit the thread (`auth_rejected` — a viewer can pin a shared session but not
+ * retitle it), otherwise `thread_rename_failed` with the HTTP status — 404 /
+ * 405 from an agora that predates the route, which
+ * `isThreadRenameUnavailableError` recognizes so callers can drop the action.
+ */
+export declare function renameThread(backendUrl: string, auth: AuthConfig, opts: {
+    threadId: string;
+    title: string;
+}): Promise<ThreadRenameResponse>;
+/**
+ * True when `renameThread` failed because the backend has no rename route
+ * (a 405, or a 404 whose body does not name the thread); a 404 for a thread
+ * that is gone is a per-row failure and leaves the action offered.
+ */
+export declare function isThreadRenameUnavailableError(error: unknown): boolean;
+/**
+ * True when `archiveThread` failed because the backend offers no archive
+ * route: a 405, FastAPI's bare 404 on an agora without the route, or the
+ * route's own `"Endpoint not available"` 404 on an agora without the
+ * checkpointer. The route's `"Thread <id> not found"` 404 for a stale row is
+ * a per-row failure and leaves the action offered on every other row.
+ */
+export declare function isThreadArchiveUnavailableError(error: unknown): boolean;
 export declare function createThread(backendUrl: string, auth: AuthConfig, opts?: {
     systemPrompt?: string;
     enabledTools?: string[];
@@ -81,6 +192,22 @@ export interface ThreadStateResponse {
  * This endpoint is the same source used by Athena's conversation sidebar and
  * supports API-key auth plus BYO SSO session tokens sent as Bearer tokens.
  */
-export declare function getThreadState(backendUrl: string, auth: AuthConfig, threadId: string): Promise<ThreadStateResponse>;
+export declare function getThreadState(backendUrl: string, auth: AuthConfig, threadId: string, opts?: {
+    /**
+     * Bypass the server's Redis thread cache and read the checkpoint (default
+     * `true`, the history load's contract). A warm-up read that only seeds a
+     * first paint passes `false`: the cached copy is cheaper and the attach
+     * snapshot replaces it anyway.
+     */
+    skipCache?: boolean;
+    signal?: AbortSignal;
+}): Promise<ThreadStateResponse>;
+/**
+ * Archive a thread (`POST /api/conversations/threads/archive`): it leaves
+ * every list but keeps its state. Rejections: 401 / 403 when the caller
+ * cannot access the thread (`auth_rejected`), otherwise
+ * `thread_archive_failed` with the HTTP status — 404 / 405 when the backend
+ * has no archive route, which `isThreadArchiveUnavailableError` recognizes.
+ */
 export declare function archiveThread(backendUrl: string, auth: AuthConfig, threadId: string): Promise<void>;
 export {};

package/dist/threads/api.js

@@ -1,5 +1,5 @@
 import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
-import { AthenaSdkError } from "../diagnostics/errors.js";
+import { AthenaSdkError, isAthenaSdkError } from "../diagnostics/errors.js";
 function isAbortError(error) {
   return error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
 }
@@ -39,7 +39,8 @@ async function listThreads(backendUrl, auth, opts = {}) {
         exclude_triggered: opts.exclude_triggered ?? false,
         ...opts.app_id ? { app_id: opts.app_id } : {},
         ...opts.start_channel ? { start_channel: opts.start_channel } : {},
-        ...opts.search ? { search: opts.search } : {}
+        ...opts.search ? { search: opts.search } : {},
+        ...opts.include_pull_requests ? { include_pull_requests: true } : {}
       })
     });
     if (!res.ok) {
@@ -106,6 +107,93 @@ async function setThreadReadState(backendUrl, auth, opts) {
   }
   return res.json();
 }
+function classifyThreadRouteRejection(status, body, threadId) {
+  let detail = body || void 0;
+  try {
+    const parsed = JSON.parse(body);
+    if (parsed && typeof parsed === "object") {
+      const record = parsed;
+      detail = record.detail ?? record.message ?? parsed;
+    }
+  } catch {
+  }
+  const routeMissing = status === 405 || status === 404 && !mentionsThread(body, threadId);
+  return { routeMissing, detail };
+}
+function mentionsThread(body, threadId) {
+  if (!threadId) return false;
+  const escaped = threadId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`(^|[^A-Za-z0-9_-])${escaped}($|[^A-Za-z0-9_-])`).test(body);
+}
+function isThreadRouteUnavailableError(error, code) {
+  return isAthenaSdkError(error) && error.code === code && error.context.route_missing === true;
+}
+async function setThreadFavorite(backendUrl, auth, opts) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/conversations/threads/favorite`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({
+      thread_id: opts.threadId,
+      is_favorited: opts.isFavorited
+    })
+  });
+  if (!res.ok) {
+    const refused = res.status === 401 || res.status === 403;
+    const { routeMissing, detail } = classifyThreadRouteRejection(
+      res.status,
+      await getResponseErrorBody(res),
+      opts.threadId
+    );
+    throw new AthenaSdkError({
+      code: refused ? "auth_rejected" : "thread_favorite_failed",
+      message: `Failed to set thread favorite: ${res.status}`,
+      status: res.status,
+      detail,
+      hint: refused ? "The credential cannot view this thread." : routeMissing ? "The backend has no favorite route yet (older agora); the pin stays read-only until it deploys." : res.status === 404 ? "The thread no longer exists on the server (archived or deleted elsewhere); refresh the list." : "Check backendUrl points at the Agora API base.",
+      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing }
+    });
+  }
+  return res.json();
+}
+function isThreadFavoriteUnavailableError(error) {
+  return isThreadRouteUnavailableError(error, "thread_favorite_failed");
+}
+const THREAD_TITLE_MAX_LENGTH = 200;
+async function renameThread(backendUrl, auth, opts) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/conversations/threads/rename`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({
+      thread_id: opts.threadId,
+      title: opts.title
+    })
+  });
+  if (!res.ok) {
+    const refused = res.status === 401 || res.status === 403;
+    const { routeMissing, detail } = classifyThreadRouteRejection(
+      res.status,
+      await getResponseErrorBody(res),
+      opts.threadId
+    );
+    throw new AthenaSdkError({
+      code: refused ? "auth_rejected" : "thread_rename_failed",
+      message: `Failed to rename thread: ${res.status}`,
+      status: res.status,
+      detail,
+      hint: refused ? "The credential cannot edit this thread (a viewer can pin a shared session, not retitle it)." : routeMissing ? "The backend has no rename route yet (older agora); sessions cannot be renamed from here until it deploys." : res.status === 404 ? "The thread no longer exists on the server (archived or deleted elsewhere); refresh the list." : res.status === 422 ? `The title must be 1–${THREAD_TITLE_MAX_LENGTH} characters after trimming.` : "Check backendUrl points at the Agora API base.",
+      context: { thread_id: opts.threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing }
+    });
+  }
+  return res.json();
+}
+function isThreadRenameUnavailableError(error) {
+  return isThreadRouteUnavailableError(error, "thread_rename_failed");
+}
+function isThreadArchiveUnavailableError(error) {
+  return isThreadRouteUnavailableError(error, "thread_archive_failed");
+}
 async function createThread(backendUrl, auth, opts = {}) {
   const base = getAthenaApiBaseUrl(backendUrl);
   const res = await fetch(`${base}/api/unstable/threads/`, {
@@ -149,7 +237,7 @@ function getAuthMode(auth) {
 function getResponseErrorBody(response) {
   return response.text().catch(() => "");
 }
-async function getThreadState(backendUrl, auth, threadId) {
+async function getThreadState(backendUrl, auth, threadId, opts = {}) {
   var _a, _b, _c, _d;
   const base = getAthenaApiBaseUrl(backendUrl);
   const authMode = getAuthMode(auth);
@@ -163,9 +251,10 @@ async function getThreadState(backendUrl, auth, threadId) {
     res = await fetch(endpoint, {
       method: "POST",
       headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+      signal: opts.signal ?? null,
       body: JSON.stringify({
         thread_id: threadId,
-        skip_cache: true
+        skip_cache: opts.skipCache ?? true
       })
     });
   } catch (error) {
@@ -223,15 +312,34 @@ async function archiveThread(backendUrl, auth, threadId) {
     body: JSON.stringify({ thread_id: threadId })
   });
   if (!res.ok) {
-    throw new Error(`[AthenaSDK] Failed to archive thread: ${res.status}`);
+    const refused = res.status === 401 || res.status === 403;
+    const { routeMissing, detail } = classifyThreadRouteRejection(
+      res.status,
+      await getResponseErrorBody(res),
+      threadId
+    );
+    throw new AthenaSdkError({
+      code: refused ? "auth_rejected" : "thread_archive_failed",
+      message: `Failed to archive thread: ${res.status}`,
+      status: res.status,
+      detail,
+      hint: refused ? "The credential cannot access this thread." : routeMissing ? "The backend has no archive route (no checkpointer, or an older agora)." : res.status === 404 ? "The thread no longer exists on the server (archived or deleted elsewhere); refresh the list." : "Check backendUrl points at the Agora API base.",
+      context: { thread_id: threadId, auth_mode: getAuthMode(auth), route_missing: routeMissing }
+    });
   }
 }
 export {
+  THREAD_TITLE_MAX_LENGTH,
   archiveThread,
   createThread,
   fetchAccountIdentity,
   getThreadState,
+  isThreadArchiveUnavailableError,
+  isThreadFavoriteUnavailableError,
+  isThreadRenameUnavailableError,
   listThreads,
+  renameThread,
+  setThreadFavorite,
   setThreadReadState
 };
 //# sourceMappingURL=api.js.map