@athenaintel/react 0.22.4 → 0.23.0

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 { 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":[],"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  /** 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":[],"mappings":"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"}

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

@@ -28,6 +28,22 @@ function threadListRequestBody(params) {
     ...filter.search ? { search: filter.search } : {}
   };
 }
+function conversationPullRequestFromThreadPullRequest(record) {
+  return {
+    repoFullName: record.repo_full_name,
+    number: record.number,
+    url: record.url,
+    title: record.title,
+    state: record.state,
+    isDraft: record.is_draft,
+    reviewDecision: record.review_decision ?? null,
+    checksState: record.checks_state,
+    updatedAt: record.updated_at
+  };
+}
+function conversationWakeFromThreadWake(wake) {
+  return { source: wake.source ?? null, reason: wake.reason ?? null, at: wake.at ?? null };
+}
 function conversationSummaryFromThreadSummary(thread, filter) {
   return {
     threadId: thread.thread_id,
@@ -45,9 +61,15 @@ function conversationSummaryFromThreadSummary(thread, filter) {
     preview: thread.last_message ?? null,
     messageCount: thread.message_count ?? null,
     isUnread: thread.is_unread ?? false,
-    // Not reported by this endpoint; `isConversationRunning` falls back to `state`.
-    sessionStatus: null,
-    runStatus: null
+    // Older servers omit the status planes; `isConversationRunning` then falls back to `state`.
+    sessionStatus: thread.session_status ?? null,
+    runStatus: thread.run_status ?? null,
+    attention: thread.attention,
+    nextAction: thread.next_action,
+    attentionSource: thread.attention_source,
+    isFavorited: thread.is_favorited,
+    lastWake: thread.last_wake === void 0 || thread.last_wake === null ? thread.last_wake : conversationWakeFromThreadWake(thread.last_wake),
+    pullRequests: thread.pull_requests === void 0 || thread.pull_requests === null ? thread.pull_requests : thread.pull_requests.map(conversationPullRequestFromThreadPullRequest)
   };
 }
 function createRestConversationListFetcher(options) {
@@ -58,6 +80,7 @@ function createRestConversationListFetcher(options) {
       await options.getAuth(),
       {
         ...body,
+        ...options.includePullRequests ? { include_pull_requests: true } : {},
         signal: params.signal
       }
     );
@@ -68,6 +91,7 @@ function createRestConversationListFetcher(options) {
     };
   };
 }
+exports.conversationPullRequestFromThreadPullRequest = conversationPullRequestFromThreadPullRequest;
 exports.conversationSummaryFromThreadSummary = conversationSummaryFromThreadSummary;
 exports.createRestConversationListFetcher = createRestConversationListFetcher;
 exports.threadListRequestBody = threadListRequestBody;

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  ConversationSummary,\n} from '@athenaintel/agent-runtime';\nimport { listThreads, type ThreadSummary } from './api';\n\nexport interface ThreadListRequestBody {\n  limit: number;\n  offset: number;\n  exclude_triggered?: boolean;\n  app_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.sourceChannels?.[0] ? { start_channel: filter.sourceChannels[0] } : {}),\n    ...(filter.search ? { search: filter.search } : {}),\n  };\n}\n\n/** Map a REST `ThreadSummary` row into the canonical contract shape. */\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    triggerType: thread.trigger_type ?? null,\n    preview: thread.last_message ?? null,\n    messageCount: thread.message_count ?? null,\n    isUnread: thread.is_unread ?? false,\n    // Not reported by this endpoint; `isConversationRunning` falls back to `state`.\n    sessionStatus: null,\n    runStatus: null,\n  };\n}\n\nexport interface RestConversationListFetcherOptions {\n  backendUrl: string;\n  /** Resolved per request so rotating tokens never go stale in the fetcher. */\n  getAuth: () =>\n    | { apiKey?: string; token?: string | null }\n    | Promise<{ apiKey?: string; token?: string | null }>;\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 body = threadListRequestBody(params);\n    const { threads, has_more: hasMore } = await listThreads(\n      options.backendUrl,\n      await options.getAuth(),\n      {\n        ...body,\n        signal: params.signal,\n      },\n    );\n    return {\n      items: threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter)),\n      hasMore: hasMore ?? threads.length >= params.limit,\n      totalCount: null,\n    };\n  };\n}\n"],"names":["listThreads"],"mappings":";;;AAiCO,SAAS,sBACd,QACuB;;AACvB,QAAM,EAAE,WAAW;AACnB,QAAM,cAAwB,CAAA;AAC9B,MAAI,OAAO,cAAc,OAAO,WAAW,SAAS,EAAG,aAAY,KAAK,YAAY;AACpF,MAAI,OAAO,UAAU,OAAO,OAAO,SAAS,EAAG,aAAY,KAAK,QAAQ;AACxE,MAAI,OAAO,kBAAkB,OAAO,eAAe,SAAS,GAAG;AAC7D,gBAAY,KAAK,gCAAgC;AAAA,EACnD;AACA,MAAI,OAAO,yBAAyB,OAAO,sBAAsB,SAAS,GAAG;AAC3E,gBAAY,KAAK,uBAAuB;AAAA,EAC1C;AACA,MAAI,OAAO,gBAAiB,aAAY,KAAK,iBAAiB;AAC9D,MAAI,YAAY,SAAS,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR,oEAAoE,YAAY,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAE9F;AACA,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,QAAQ,OAAO;AAAA,IACf,GAAI,OAAO,qBAAqB,SAC5B,EAAE,mBAAmB,OAAO,iBAAA,IAC5B,CAAA;AAAA,IACJ,GAAI,OAAO,QAAQ,EAAE,QAAQ,OAAO,MAAA,IAAU,CAAA;AAAA,IAC9C,KAAI,YAAO,mBAAP,mBAAwB,MAAK,EAAE,eAAe,OAAO,eAAe,CAAC,EAAA,IAAM,CAAA;AAAA,IAC/E,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAA,IAAW,CAAA;AAAA,EAAC;AAErD;AAGO,SAAS,qCACd,QACA,QACqB;AACrB,SAAO;AAAA,IACL,UAAU,OAAO;AAAA,IACjB,OAAO,OAAO;AAAA,IACd,WAAW,OAAO;AAAA,IAClB,WAAW,OAAO,cAAc;AAAA,IAChC,OAAO,OAAO;AAAA;AAAA,IAEd,SAAS;AAAA,IACT,eAAe,OAAO,iBAAiB;AAAA,IACvC,WAAW;AAAA,IACX,SAAS;AAAA,IACT,OAAO,OAAO,UAAU,OAAO,SAAS;AAAA,IACxC,aAAa,OAAO,gBAAgB;AAAA,IACpC,SAAS,OAAO,gBAAgB;AAAA,IAChC,cAAc,OAAO,iBAAiB;AAAA,IACtC,UAAU,OAAO,aAAa;AAAA;AAAA,IAE9B,eAAe;AAAA,IACf,WAAW;AAAA,EAAA;AAEf;AAeO,SAAS,kCACd,SACyB;AACzB,SAAO,OAAO,WAA0C;AACtD,UAAM,OAAO,sBAAsB,MAAM;AACzC,UAAM,EAAE,SAAS,UAAU,QAAA,IAAY,MAAMA,IAAAA;AAAAA,MAC3C,QAAQ;AAAA,MACR,MAAM,QAAQ,QAAA;AAAA,MACd;AAAA,QACE,GAAG;AAAA,QACH,QAAQ,OAAO;AAAA,MAAA;AAAA,IACjB;AAEF,WAAO;AAAA,MACL,OAAO,QAAQ,IAAI,CAAC,WAAW,qCAAqC,QAAQ,OAAO,MAAM,CAAC;AAAA,MAC1F,SAAS,WAAW,QAAQ,UAAU,OAAO;AAAA,MAC7C,YAAY;AAAA,IAAA;AAAA,EAEhB;AACF;;;;"}
+{"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 { listThreads, type ThreadPullRequest, type ThreadSummary, type ThreadWake } from './api';\n\nexport interface ThreadListRequestBody {\n  limit: number;\n  offset: number;\n  exclude_triggered?: boolean;\n  app_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.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    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    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  /** Resolved per request so rotating tokens never go stale in the fetcher. */\n  getAuth: () =>\n    | { apiKey?: string; token?: string | null }\n    | Promise<{ 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\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 body = threadListRequestBody(params);\n    const { threads, has_more: hasMore } = await listThreads(\n      options.backendUrl,\n      await options.getAuth(),\n      {\n        ...body,\n        ...(options.includePullRequests ? { include_pull_requests: true } : {}),\n        signal: params.signal,\n      },\n    );\n    return {\n      items: threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter)),\n      hasMore: hasMore ?? threads.length >= params.limit,\n      totalCount: null,\n    };\n  };\n}\n"],"names":["listThreads"],"mappings":"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"}

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

@@ -8,8 +8,8 @@
  * transport cannot express throw instead of being ignored — a dropped filter
  * would return wrong rows under a cache key that claims otherwise.
  */
-import type { ConversationListFetcher, ConversationListFetchParams, ConversationListFilter, ConversationSummary } from '@athenaintel/agent-runtime';
-import { type ThreadSummary } from './api';
+import type { ConversationListFetcher, ConversationListFetchParams, ConversationListFilter, ConversationPullRequest, ConversationSummary } from '@athenaintel/agent-runtime';
+import { type ThreadPullRequest, type ThreadSummary } from './api';
 export interface ThreadListRequestBody {
     limit: number;
     offset: number;
@@ -23,7 +23,14 @@ export interface ThreadListRequestBody {
  * Exported for tests; throws on filter fields the endpoint cannot express.
  */
 export declare function threadListRequestBody(params: Pick<ConversationListFetchParams, 'limit' | 'offset' | 'filter'>): ThreadListRequestBody;
-/** Map a REST `ThreadSummary` row into the canonical contract shape. */
+/** Map one REST pull-request record onto the canonical camelCase shape. */
+export declare function conversationPullRequestFromThreadPullRequest(record: ThreadPullRequest): ConversationPullRequest;
+/**
+ * Map a REST `ThreadSummary` row into the canonical contract shape. Fields
+ * the server did not send stay `undefined` (an older server, or a list that
+ * did not opt into pull requests), so a consumer can tell "not reported"
+ * from "reported as none".
+ */
 export declare function conversationSummaryFromThreadSummary(thread: ThreadSummary, filter: ConversationListFilter): ConversationSummary;
 export interface RestConversationListFetcherOptions {
     backendUrl: string;
@@ -35,6 +42,12 @@ export interface RestConversationListFetcherOptions {
         apiKey?: string;
         token?: string | null;
     }>;
+    /**
+     * Ask the server for live GitHub state on each row's `pullRequests`
+     * (`include_pull_requests`). Off by default: it costs the server a lookup,
+     * so only a list that renders pull-request chips opts in.
+     */
+    includePullRequests?: boolean;
 }
 /**
  * Build a {@link ConversationListFetcher} over the REST thread list. The

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

@@ -26,6 +26,22 @@ function threadListRequestBody(params) {
     ...filter.search ? { search: filter.search } : {}
   };
 }
+function conversationPullRequestFromThreadPullRequest(record) {
+  return {
+    repoFullName: record.repo_full_name,
+    number: record.number,
+    url: record.url,
+    title: record.title,
+    state: record.state,
+    isDraft: record.is_draft,
+    reviewDecision: record.review_decision ?? null,
+    checksState: record.checks_state,
+    updatedAt: record.updated_at
+  };
+}
+function conversationWakeFromThreadWake(wake) {
+  return { source: wake.source ?? null, reason: wake.reason ?? null, at: wake.at ?? null };
+}
 function conversationSummaryFromThreadSummary(thread, filter) {
   return {
     threadId: thread.thread_id,
@@ -43,9 +59,15 @@ function conversationSummaryFromThreadSummary(thread, filter) {
     preview: thread.last_message ?? null,
     messageCount: thread.message_count ?? null,
     isUnread: thread.is_unread ?? false,
-    // Not reported by this endpoint; `isConversationRunning` falls back to `state`.
-    sessionStatus: null,
-    runStatus: null
+    // Older servers omit the status planes; `isConversationRunning` then falls back to `state`.
+    sessionStatus: thread.session_status ?? null,
+    runStatus: thread.run_status ?? null,
+    attention: thread.attention,
+    nextAction: thread.next_action,
+    attentionSource: thread.attention_source,
+    isFavorited: thread.is_favorited,
+    lastWake: thread.last_wake === void 0 || thread.last_wake === null ? thread.last_wake : conversationWakeFromThreadWake(thread.last_wake),
+    pullRequests: thread.pull_requests === void 0 || thread.pull_requests === null ? thread.pull_requests : thread.pull_requests.map(conversationPullRequestFromThreadPullRequest)
   };
 }
 function createRestConversationListFetcher(options) {
@@ -56,6 +78,7 @@ function createRestConversationListFetcher(options) {
       await options.getAuth(),
       {
         ...body,
+        ...options.includePullRequests ? { include_pull_requests: true } : {},
         signal: params.signal
       }
     );
@@ -67,6 +90,7 @@ function createRestConversationListFetcher(options) {
   };
 }
 export {
+  conversationPullRequestFromThreadPullRequest,
   conversationSummaryFromThreadSummary,
   createRestConversationListFetcher,
   threadListRequestBody

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

@@ -1 +1 @@
-{"version":3,"file":"conversation-list-fetcher.js","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  ConversationSummary,\n} from '@athenaintel/agent-runtime';\nimport { listThreads, type ThreadSummary } from './api';\n\nexport interface ThreadListRequestBody {\n  limit: number;\n  offset: number;\n  exclude_triggered?: boolean;\n  app_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.sourceChannels?.[0] ? { start_channel: filter.sourceChannels[0] } : {}),\n    ...(filter.search ? { search: filter.search } : {}),\n  };\n}\n\n/** Map a REST `ThreadSummary` row into the canonical contract shape. */\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    triggerType: thread.trigger_type ?? null,\n    preview: thread.last_message ?? null,\n    messageCount: thread.message_count ?? null,\n    isUnread: thread.is_unread ?? false,\n    // Not reported by this endpoint; `isConversationRunning` falls back to `state`.\n    sessionStatus: null,\n    runStatus: null,\n  };\n}\n\nexport interface RestConversationListFetcherOptions {\n  backendUrl: string;\n  /** Resolved per request so rotating tokens never go stale in the fetcher. */\n  getAuth: () =>\n    | { apiKey?: string; token?: string | null }\n    | Promise<{ apiKey?: string; token?: string | null }>;\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 body = threadListRequestBody(params);\n    const { threads, has_more: hasMore } = await listThreads(\n      options.backendUrl,\n      await options.getAuth(),\n      {\n        ...body,\n        signal: params.signal,\n      },\n    );\n    return {\n      items: threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter)),\n      hasMore: hasMore ?? threads.length >= params.limit,\n      totalCount: null,\n    };\n  };\n}\n"],"names":[],"mappings":";AAiCO,SAAS,sBACd,QACuB;;AACvB,QAAM,EAAE,WAAW;AACnB,QAAM,cAAwB,CAAA;AAC9B,MAAI,OAAO,cAAc,OAAO,WAAW,SAAS,EAAG,aAAY,KAAK,YAAY;AACpF,MAAI,OAAO,UAAU,OAAO,OAAO,SAAS,EAAG,aAAY,KAAK,QAAQ;AACxE,MAAI,OAAO,kBAAkB,OAAO,eAAe,SAAS,GAAG;AAC7D,gBAAY,KAAK,gCAAgC;AAAA,EACnD;AACA,MAAI,OAAO,yBAAyB,OAAO,sBAAsB,SAAS,GAAG;AAC3E,gBAAY,KAAK,uBAAuB;AAAA,EAC1C;AACA,MAAI,OAAO,gBAAiB,aAAY,KAAK,iBAAiB;AAC9D,MAAI,YAAY,SAAS,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR,oEAAoE,YAAY,KAAK,IAAI,CAAC;AAAA,IAAA;AAAA,EAE9F;AACA,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,QAAQ,OAAO;AAAA,IACf,GAAI,OAAO,qBAAqB,SAC5B,EAAE,mBAAmB,OAAO,iBAAA,IAC5B,CAAA;AAAA,IACJ,GAAI,OAAO,QAAQ,EAAE,QAAQ,OAAO,MAAA,IAAU,CAAA;AAAA,IAC9C,KAAI,YAAO,mBAAP,mBAAwB,MAAK,EAAE,eAAe,OAAO,eAAe,CAAC,EAAA,IAAM,CAAA;AAAA,IAC/E,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAA,IAAW,CAAA;AAAA,EAAC;AAErD;AAGO,SAAS,qCACd,QACA,QACqB;AACrB,SAAO;AAAA,IACL,UAAU,OAAO;AAAA,IACjB,OAAO,OAAO;AAAA,IACd,WAAW,OAAO;AAAA,IAClB,WAAW,OAAO,cAAc;AAAA,IAChC,OAAO,OAAO;AAAA;AAAA,IAEd,SAAS;AAAA,IACT,eAAe,OAAO,iBAAiB;AAAA,IACvC,WAAW;AAAA,IACX,SAAS;AAAA,IACT,OAAO,OAAO,UAAU,OAAO,SAAS;AAAA,IACxC,aAAa,OAAO,gBAAgB;AAAA,IACpC,SAAS,OAAO,gBAAgB;AAAA,IAChC,cAAc,OAAO,iBAAiB;AAAA,IACtC,UAAU,OAAO,aAAa;AAAA;AAAA,IAE9B,eAAe;AAAA,IACf,WAAW;AAAA,EAAA;AAEf;AAeO,SAAS,kCACd,SACyB;AACzB,SAAO,OAAO,WAA0C;AACtD,UAAM,OAAO,sBAAsB,MAAM;AACzC,UAAM,EAAE,SAAS,UAAU,QAAA,IAAY,MAAM;AAAA,MAC3C,QAAQ;AAAA,MACR,MAAM,QAAQ,QAAA;AAAA,MACd;AAAA,QACE,GAAG;AAAA,QACH,QAAQ,OAAO;AAAA,MAAA;AAAA,IACjB;AAEF,WAAO;AAAA,MACL,OAAO,QAAQ,IAAI,CAAC,WAAW,qCAAqC,QAAQ,OAAO,MAAM,CAAC;AAAA,MAC1F,SAAS,WAAW,QAAQ,UAAU,OAAO;AAAA,MAC7C,YAAY;AAAA,IAAA;AAAA,EAEhB;AACF;"}
+{"version":3,"file":"conversation-list-fetcher.js","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 { listThreads, type ThreadPullRequest, type ThreadSummary, type ThreadWake } from './api';\n\nexport interface ThreadListRequestBody {\n  limit: number;\n  offset: number;\n  exclude_triggered?: boolean;\n  app_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.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    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    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  /** Resolved per request so rotating tokens never go stale in the fetcher. */\n  getAuth: () =>\n    | { apiKey?: string; token?: string | null }\n    | Promise<{ 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\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 body = threadListRequestBody(params);\n    const { threads, has_more: hasMore } = await listThreads(\n      options.backendUrl,\n      await options.getAuth(),\n      {\n        ...body,\n        ...(options.includePullRequests ? { include_pull_requests: true } : {}),\n        signal: params.signal,\n      },\n    );\n    return {\n      items: threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter)),\n      hasMore: hasMore ?? threads.length >= params.limit,\n      totalCount: null,\n    };\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/threads/index.d.ts

@@ -1,5 +1,9 @@
 export { ThreadList } from './ThreadList';
 export type { ThreadListProps } from './ThreadList';
-export type { ThreadSummary } from './api';
+export { SessionList } from './SessionList';
+export type { SessionListProps } from './SessionList';
+export type { ThreadPullRequest, ThreadSummary, ThreadWake } from './api';
 export { useAthenaThreadManager } from './useAthenaThreadManager';
 export type { AthenaThreadManagerState } from './useAthenaThreadManager';
+export { useAthenaSessionAttention } from './use-athena-session-attention';
+export type { AthenaSessionAttention } from './use-athena-session-attention';

package/dist/threads/session-list-model.cjs

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const SESSION_LIST_GROUPS = [
+  "Needs you",
+  "Working",
+  "Pinned",
+  "Recent"
+];
+function sessionListGroupOf(thread) {
+  if (thread.attention === "needs_you") return "Needs you";
+  if (thread.attention === "working") return "Working";
+  if (thread.isFavorited) return "Pinned";
+  return "Recent";
+}
+function groupSessions(threads, grouped) {
+  if (!grouped) return threads.length > 0 ? [{ group: null, items: [...threads] }] : [];
+  const byGroup = /* @__PURE__ */ new Map();
+  for (const thread of threads) {
+    const group = sessionListGroupOf(thread);
+    const items = byGroup.get(group) ?? [];
+    items.push(thread);
+    byGroup.set(group, items);
+  }
+  return SESSION_LIST_GROUPS.flatMap((group) => {
+    const items = byGroup.get(group);
+    return items ? [{ group, items }] : [];
+  });
+}
+function sessionIndicator(thread) {
+  if (thread.attention === "needs_you") return "needs_you";
+  if (thread.attention === "working") return "working";
+  if (thread.isUnread) return "unread";
+  if (thread.attention === "watching") return "watching";
+  return null;
+}
+function relativeTime(value, now = Date.now()) {
+  const timestamp = Date.parse(value);
+  if (!Number.isFinite(timestamp)) return "";
+  const minutes = Math.floor(Math.max(0, now - timestamp) / 6e4);
+  if (minutes < 1) return "just now";
+  if (minutes < 60) return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  return days < 7 ? `${days}d ago` : new Date(timestamp).toLocaleDateString();
+}
+function sessionSecondaryLine(thread, now = Date.now()) {
+  var _a;
+  const nextAction = (_a = thread.nextAction) == null ? void 0 : _a.trim();
+  if (nextAction) {
+    const tone = thread.attention === "needs_you" ? "needs_you" : thread.attention === "ready" ? "ready" : thread.attention === "error" ? "error" : "muted";
+    return { kind: "next_action", text: nextAction, tone };
+  }
+  return { kind: "updated", text: relativeTime(thread.updatedAt, now), tone: "muted" };
+}
+function pullRequestChipState(pullRequest) {
+  if (pullRequest.state === "MERGED") return "merged";
+  if (pullRequest.state === "CLOSED") return "closed";
+  return pullRequest.isDraft ? "draft" : "open";
+}
+function primaryPullRequest(pullRequests) {
+  const rank = (pullRequest) => pullRequest.state === "OPEN" ? pullRequest.isDraft ? 1 : 0 : 2;
+  return [...pullRequests].sort(
+    (a, b) => rank(a) - rank(b) || Date.parse(b.updatedAt) - Date.parse(a.updatedAt)
+  )[0];
+}
+function pullRequestChip(pullRequests) {
+  if (!pullRequests || pullRequests.length === 0) return null;
+  const primary = primaryPullRequest(pullRequests);
+  if (!primary) return null;
+  return {
+    state: pullRequestChipState(primary),
+    count: pullRequests.length,
+    label: pullRequests.length === 1 ? `#${primary.number}` : `${pullRequests.length} PRs`,
+    url: primary.url,
+    title: primary.title,
+    checksState: primary.checksState,
+    reviewDecision: primary.reviewDecision
+  };
+}
+const CHANNEL_LABELS = {
+  web: "Athena",
+  olympus: "Athena",
+  github: "GitHub",
+  api: "API",
+  email: "Email",
+  agent_email: "Email",
+  slack: "Slack",
+  sms: "SMS",
+  teams: "Teams",
+  task: "Task",
+  orchestration: "Orchestration",
+  computer: "Computer",
+  voice: "Voice",
+  mobile: "Mobile"
+};
+function humanize(value) {
+  const words = value.replace(/^athena[-_]/, "").replace(/[-_.]+/g, " ").trim();
+  return words ? words.charAt(0).toUpperCase() + words.slice(1) : "";
+}
+function sessionOriginLabel(thread) {
+  var _a, _b, _c;
+  const appId = ((_a = thread.appId) == null ? void 0 : _a.trim().toLowerCase()) ?? "";
+  if (appId) {
+    if (appId.includes("chrome")) return "Chrome";
+    if (appId.includes("powerpoint")) return "PowerPoint";
+    if (appId.includes("word")) return "Word";
+    if (appId.includes("excel")) return "Excel";
+    if (appId.includes("office")) return "Office";
+    if (appId.includes("mobile")) return "Mobile";
+    if (appId.startsWith("asset_")) return "Computer";
+    if (CHANNEL_LABELS[appId]) return CHANNEL_LABELS[appId];
+  }
+  const channel = ((_b = thread.startChannel) == null ? void 0 : _b.trim().toLowerCase()) ?? "";
+  if (channel) return CHANNEL_LABELS[channel] ?? humanize(channel);
+  if (appId) return humanize(appId) || null;
+  const trigger = ((_c = thread.triggerType) == null ? void 0 : _c.trim().toLowerCase()) ?? "";
+  if (trigger && trigger !== "manual") return humanize(trigger) || null;
+  return null;
+}
+exports.SESSION_LIST_GROUPS = SESSION_LIST_GROUPS;
+exports.groupSessions = groupSessions;
+exports.pullRequestChip = pullRequestChip;
+exports.pullRequestChipState = pullRequestChipState;
+exports.relativeTime = relativeTime;
+exports.sessionIndicator = sessionIndicator;
+exports.sessionListGroupOf = sessionListGroupOf;
+exports.sessionOriginLabel = sessionOriginLabel;
+exports.sessionSecondaryLine = sessionSecondaryLine;
+//# sourceMappingURL=session-list-model.cjs.map

package/dist/threads/session-list-model.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list-model.cjs","sources":["../../src/threads/session-list-model.ts"],"sourcesContent":["/**\n * Pure derivations behind `SessionList`: which group a session lands in,\n * which status indicator it shows, what its second line says, how its pull\n * requests collapse into one chip, and how its origin is labelled. Kept\n * React-free so the render tests stay thin and hosts that draw their own rows\n * (`useAthenaSessionAttention`) can reuse the same rules.\n */\nimport type { ConversationPullRequest } from '@athenaintel/agent-runtime';\nimport type { AthenaStatewireThreadSummary } from './statewire-thread-list';\n\nexport type SessionListGroup = 'Needs you' | 'Working' | 'Pinned' | 'Recent';\n\n/** Display order; a session appears once, in the FIRST group that applies. */\nexport const SESSION_LIST_GROUPS: readonly SessionListGroup[] = [\n  'Needs you',\n  'Working',\n  'Pinned',\n  'Recent',\n];\n\nexport function sessionListGroupOf(\n  thread: Pick<AthenaStatewireThreadSummary, 'attention' | 'isFavorited'>,\n): SessionListGroup {\n  if (thread.attention === 'needs_you') return 'Needs you';\n  if (thread.attention === 'working') return 'Working';\n  if (thread.isFavorited) return 'Pinned';\n  return 'Recent';\n}\n\nexport interface SessionListSection {\n  /** `null` for the single ungrouped section. */\n  group: SessionListGroup | null;\n  items: AthenaStatewireThreadSummary[];\n}\n\n/** Sections in display order; empty groups are omitted and row order is kept within a group. */\nexport function groupSessions(\n  threads: readonly AthenaStatewireThreadSummary[],\n  grouped: boolean,\n): SessionListSection[] {\n  if (!grouped) return threads.length > 0 ? [{ group: null, items: [...threads] }] : [];\n  const byGroup = new Map<SessionListGroup, AthenaStatewireThreadSummary[]>();\n  for (const thread of threads) {\n    const group = sessionListGroupOf(thread);\n    const items = byGroup.get(group) ?? [];\n    items.push(thread);\n    byGroup.set(group, items);\n  }\n  return SESSION_LIST_GROUPS.flatMap((group) => {\n    const items = byGroup.get(group);\n    return items ? [{ group, items }] : [];\n  });\n}\n\n/**\n * The status indicator at the head of a row: `needs_you` an orange dot,\n * `working` a spinner, `unread` (and not needs-you) a blue dot, `watching` a\n * clock, otherwise none. One indicator per row, in that precedence.\n */\nexport type SessionIndicator = 'needs_you' | 'working' | 'unread' | 'watching' | null;\n\nexport function sessionIndicator(\n  thread: Pick<AthenaStatewireThreadSummary, 'attention' | 'isUnread'>,\n): SessionIndicator {\n  if (thread.attention === 'needs_you') return 'needs_you';\n  if (thread.attention === 'working') return 'working';\n  if (thread.isUnread) return 'unread';\n  if (thread.attention === 'watching') return 'watching';\n  return null;\n}\n\nexport type SessionLineTone = 'needs_you' | 'ready' | 'error' | 'muted';\n\nexport interface SessionSecondaryLine {\n  kind: 'next_action' | 'updated';\n  text: string;\n  tone: SessionLineTone;\n}\n\n/** \"5m ago\" / \"3h ago\" / \"2d ago\"; a locale date past a week; empty for an unparseable value. */\nexport function relativeTime(value: string, now: number = Date.now()): string {\n  const timestamp = Date.parse(value);\n  if (!Number.isFinite(timestamp)) return '';\n  const minutes = Math.floor(Math.max(0, now - timestamp) / 60_000);\n  if (minutes < 1) return 'just now';\n  if (minutes < 60) return `${minutes}m ago`;\n  const hours = Math.floor(minutes / 60);\n  if (hours < 24) return `${hours}h ago`;\n  const days = Math.floor(hours / 24);\n  return days < 7 ? `${days}d ago` : new Date(timestamp).toLocaleDateString();\n}\n\n/**\n * The row's second line: the server's next action coloured by attention\n * (needs-you orange, ready green, error red), else the muted relative time\n * of the last update.\n */\nexport function sessionSecondaryLine(\n  thread: Pick<AthenaStatewireThreadSummary, 'attention' | 'nextAction' | 'updatedAt'>,\n  now: number = Date.now(),\n): SessionSecondaryLine {\n  const nextAction = thread.nextAction?.trim();\n  if (nextAction) {\n    const tone: SessionLineTone =\n      thread.attention === 'needs_you'\n        ? 'needs_you'\n        : thread.attention === 'ready'\n          ? 'ready'\n          : thread.attention === 'error'\n            ? 'error'\n            : 'muted';\n    return { kind: 'next_action', text: nextAction, tone };\n  }\n  return { kind: 'updated', text: relativeTime(thread.updatedAt, now), tone: 'muted' };\n}\n\nexport type PullRequestChipState = 'open' | 'draft' | 'merged' | 'closed';\n\nexport function pullRequestChipState(\n  pullRequest: Pick<ConversationPullRequest, 'state' | 'isDraft'>,\n): PullRequestChipState {\n  if (pullRequest.state === 'MERGED') return 'merged';\n  if (pullRequest.state === 'CLOSED') return 'closed';\n  return pullRequest.isDraft ? 'draft' : 'open';\n}\n\nexport interface PullRequestChip {\n  /** State of the primary pull request (the one the chip links to). */\n  state: PullRequestChipState;\n  count: number;\n  /** `#123` for one pull request, `3 PRs` for several. */\n  label: string;\n  url: string;\n  title: string;\n  checksState: ConversationPullRequest['checksState'];\n  reviewDecision: string | null;\n}\n\n/**\n * The pull request a chip stands for when a session opened several: the one\n * still in flight (open before draft), then the most recently updated.\n */\nfunction primaryPullRequest(\n  pullRequests: readonly ConversationPullRequest[],\n): ConversationPullRequest | undefined {\n  const rank = (pullRequest: ConversationPullRequest): number =>\n    pullRequest.state === 'OPEN' ? (pullRequest.isDraft ? 1 : 0) : 2;\n  return [...pullRequests].sort(\n    (a, b) => rank(a) - rank(b) || Date.parse(b.updatedAt) - Date.parse(a.updatedAt),\n  )[0];\n}\n\n/** One chip per row, or `null` when the session opened no pull request (or none is known). */\nexport function pullRequestChip(\n  pullRequests: readonly ConversationPullRequest[] | null | undefined,\n): PullRequestChip | null {\n  if (!pullRequests || pullRequests.length === 0) return null;\n  const primary = primaryPullRequest(pullRequests);\n  if (!primary) return null;\n  return {\n    state: pullRequestChipState(primary),\n    count: pullRequests.length,\n    label: pullRequests.length === 1 ? `#${primary.number}` : `${pullRequests.length} PRs`,\n    url: primary.url,\n    title: primary.title,\n    checksState: primary.checksState,\n    reviewDecision: primary.reviewDecision,\n  };\n}\n\nconst CHANNEL_LABELS: Record<string, string> = {\n  web: 'Athena',\n  olympus: 'Athena',\n  github: 'GitHub',\n  api: 'API',\n  email: 'Email',\n  agent_email: 'Email',\n  slack: 'Slack',\n  sms: 'SMS',\n  teams: 'Teams',\n  task: 'Task',\n  orchestration: 'Orchestration',\n  computer: 'Computer',\n  voice: 'Voice',\n  mobile: 'Mobile',\n};\n\nfunction humanize(value: string): string {\n  const words = value.replace(/^athena[-_]/, '').replace(/[-_.]+/g, ' ').trim();\n  return words ? words.charAt(0).toUpperCase() + words.slice(1) : '';\n}\n\n/**\n * The origin badge: the client app when it is a recognizable surface\n * (Chrome, an Office host, mobile, a computer asset), else the start channel,\n * else a non-manual trigger; `null` when nothing is known.\n */\nexport function sessionOriginLabel(\n  thread: Pick<AthenaStatewireThreadSummary, 'startChannel' | 'appId' | 'triggerType'>,\n): string | null {\n  const appId = thread.appId?.trim().toLowerCase() ?? '';\n  if (appId) {\n    if (appId.includes('chrome')) return 'Chrome';\n    if (appId.includes('powerpoint')) return 'PowerPoint';\n    if (appId.includes('word')) return 'Word';\n    if (appId.includes('excel')) return 'Excel';\n    if (appId.includes('office')) return 'Office';\n    if (appId.includes('mobile')) return 'Mobile';\n    if (appId.startsWith('asset_')) return 'Computer';\n    if (CHANNEL_LABELS[appId]) return CHANNEL_LABELS[appId];\n  }\n  const channel = thread.startChannel?.trim().toLowerCase() ?? '';\n  if (channel) return CHANNEL_LABELS[channel] ?? humanize(channel);\n  if (appId) return humanize(appId) || null;\n  const trigger = thread.triggerType?.trim().toLowerCase() ?? '';\n  if (trigger && trigger !== 'manual') return humanize(trigger) || null;\n  return null;\n}\n"],"names":[],"mappings":"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"}

package/dist/threads/session-list-model.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Pure derivations behind `SessionList`: which group a session lands in,
+ * which status indicator it shows, what its second line says, how its pull
+ * requests collapse into one chip, and how its origin is labelled. Kept
+ * React-free so the render tests stay thin and hosts that draw their own rows
+ * (`useAthenaSessionAttention`) can reuse the same rules.
+ */
+import type { ConversationPullRequest } from '@athenaintel/agent-runtime';
+import type { AthenaStatewireThreadSummary } from './statewire-thread-list';
+export type SessionListGroup = 'Needs you' | 'Working' | 'Pinned' | 'Recent';
+/** Display order; a session appears once, in the FIRST group that applies. */
+export declare const SESSION_LIST_GROUPS: readonly SessionListGroup[];
+export declare function sessionListGroupOf(thread: Pick<AthenaStatewireThreadSummary, 'attention' | 'isFavorited'>): SessionListGroup;
+export interface SessionListSection {
+    /** `null` for the single ungrouped section. */
+    group: SessionListGroup | null;
+    items: AthenaStatewireThreadSummary[];
+}
+/** Sections in display order; empty groups are omitted and row order is kept within a group. */
+export declare function groupSessions(threads: readonly AthenaStatewireThreadSummary[], grouped: boolean): SessionListSection[];
+/**
+ * The status indicator at the head of a row: `needs_you` an orange dot,
+ * `working` a spinner, `unread` (and not needs-you) a blue dot, `watching` a
+ * clock, otherwise none. One indicator per row, in that precedence.
+ */
+export type SessionIndicator = 'needs_you' | 'working' | 'unread' | 'watching' | null;
+export declare function sessionIndicator(thread: Pick<AthenaStatewireThreadSummary, 'attention' | 'isUnread'>): SessionIndicator;
+export type SessionLineTone = 'needs_you' | 'ready' | 'error' | 'muted';
+export interface SessionSecondaryLine {
+    kind: 'next_action' | 'updated';
+    text: string;
+    tone: SessionLineTone;
+}
+/** "5m ago" / "3h ago" / "2d ago"; a locale date past a week; empty for an unparseable value. */
+export declare function relativeTime(value: string, now?: number): string;
+/**
+ * The row's second line: the server's next action coloured by attention
+ * (needs-you orange, ready green, error red), else the muted relative time
+ * of the last update.
+ */
+export declare function sessionSecondaryLine(thread: Pick<AthenaStatewireThreadSummary, 'attention' | 'nextAction' | 'updatedAt'>, now?: number): SessionSecondaryLine;
+export type PullRequestChipState = 'open' | 'draft' | 'merged' | 'closed';
+export declare function pullRequestChipState(pullRequest: Pick<ConversationPullRequest, 'state' | 'isDraft'>): PullRequestChipState;
+export interface PullRequestChip {
+    /** State of the primary pull request (the one the chip links to). */
+    state: PullRequestChipState;
+    count: number;
+    /** `#123` for one pull request, `3 PRs` for several. */
+    label: string;
+    url: string;
+    title: string;
+    checksState: ConversationPullRequest['checksState'];
+    reviewDecision: string | null;
+}
+/** One chip per row, or `null` when the session opened no pull request (or none is known). */
+export declare function pullRequestChip(pullRequests: readonly ConversationPullRequest[] | null | undefined): PullRequestChip | null;
+/**
+ * The origin badge: the client app when it is a recognizable surface
+ * (Chrome, an Office host, mobile, a computer asset), else the start channel,
+ * else a non-manual trigger; `null` when nothing is known.
+ */
+export declare function sessionOriginLabel(thread: Pick<AthenaStatewireThreadSummary, 'startChannel' | 'appId' | 'triggerType'>): string | null;