@athenaintel/react 0.18.0 → 0.20.0

package/dist/threads/api.cjs

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
+const errors = require("../diagnostics/errors.cjs");
+function isAbortError(error) {
+  return error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
+}
+function getAuthHeaders(auth) {
+  if (auth.token) {
+    return { Authorization: `Bearer ${auth.token}` };
+  }
+  if (auth.apiKey) {
+    return { "X-API-KEY": auth.apiKey };
+  }
+  return {};
+}
+function getAthenaApiBaseUrl(backendUrl) {
+  const stripped = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
+  if (stripped === backendUrl) {
+    return backendUrl.replace(/\/$/, "");
+  }
+  return stripped;
+}
+async function listThreads(backendUrl, auth, opts = {}) {
+  var _a;
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const endSpan = athenaDiagnostics.athenaDiagnostics.span("threads.list", "threads.list.start", {
+    auth_mode: getAuthMode(auth),
+    app_id: opts.app_id
+  });
+  try {
+    const res = await fetch(`${base}/api/conversations/threads/list`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+      signal: opts.signal ?? null,
+      body: JSON.stringify({
+        limit: opts.limit ?? 50,
+        offset: opts.offset ?? 0,
+        // Default to the full recent-conversations set unless a caller
+        // explicitly asks to hide triggered/background sessions.
+        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 } : {}
+      })
+    });
+    if (!res.ok) {
+      throw new errors.AthenaSdkError({
+        code: res.status === 401 || res.status === 403 ? "auth_rejected" : "threads_list_failed",
+        message: `Failed to list threads: ${res.status}`,
+        status: res.status,
+        hint: res.status === 401 || res.status === 403 ? "The credential was refused. Check the token/API key and that the user belongs to the workspace." : "Check backendUrl points at the Agora API base.",
+        context: { auth_mode: getAuthMode(auth) }
+      });
+    }
+    const data = await res.json();
+    endSpan("threads.list.done", { data: { count: ((_a = data.threads) == null ? void 0 : _a.length) ?? 0 } });
+    return data;
+  } catch (error) {
+    if (isAbortError(error)) {
+      endSpan("threads.list.aborted", { data: { reason: "request aborted" } });
+    } else {
+      endSpan("threads.list.error", { error });
+    }
+    throw error;
+  }
+}
+async function setThreadReadState(backendUrl, auth, opts) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/conversations/threads/read-state`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({
+      thread_id: opts.threadId,
+      is_unread: opts.isUnread
+    })
+  });
+  if (!res.ok) {
+    throw new Error(`[AthenaSDK] Failed to set thread read state: ${res.status}`);
+  }
+  return res.json();
+}
+async function createThread(backendUrl, auth, opts = {}) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/unstable/threads/`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({
+      config: {
+        system_prompt: opts.systemPrompt ?? "",
+        enabled_tools: opts.enabledTools,
+        ...opts.appId ? { app_id: opts.appId } : {}
+      }
+    })
+  });
+  if (!res.ok) {
+    throw new Error(`[AthenaSDK] Failed to create thread: ${res.status}`);
+  }
+  return res.json();
+}
+function deserializeMessage(msg) {
+  if (msg && typeof msg === "object" && "lc" in msg && "kwargs" in msg && msg.type === "constructor") {
+    const kwargs = msg.kwargs;
+    const deserializedToolCalls = Array.isArray(kwargs.tool_calls) ? kwargs.tool_calls.map((tc) => {
+      if (tc && typeof tc === "object" && "lc" in tc && "kwargs" in tc) {
+        return tc.kwargs;
+      }
+      return tc;
+    }) : kwargs.tool_calls;
+    return { ...kwargs, tool_calls: deserializedToolCalls };
+  }
+  return msg;
+}
+function getAuthMode(auth) {
+  if (auth.token) {
+    return "bearer";
+  }
+  if (auth.apiKey) {
+    return "api-key";
+  }
+  return "none";
+}
+function getResponseErrorBody(response) {
+  return response.text().catch(() => "");
+}
+async function getThreadState(backendUrl, auth, threadId) {
+  var _a, _b, _c, _d;
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const authMode = getAuthMode(auth);
+  const endpoint = `${base}/api/conversations/threads/get`;
+  const endSpan = athenaDiagnostics.athenaDiagnostics.span("threads.history", "threads.history.start", {
+    thread_id: threadId,
+    auth_mode: authMode
+  });
+  let res;
+  try {
+    res = await fetch(endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+      body: JSON.stringify({
+        thread_id: threadId,
+        skip_cache: true
+      })
+    });
+  } catch (error) {
+    if (isAbortError(error)) {
+      endSpan("threads.history.aborted", {
+        data: { thread_id: threadId, reason: "request aborted" }
+      });
+    } else {
+      endSpan("threads.history.error", { error, data: { thread_id: threadId } });
+    }
+    throw error;
+  }
+  if (!res.ok) {
+    const body = await getResponseErrorBody(res);
+    const error = new errors.AthenaSdkError({
+      code: res.status === 401 || res.status === 403 ? "auth_rejected" : "thread_load_failed",
+      message: `Failed to get thread state: ${res.status} (${authMode})${body ? `: ${body.slice(0, 300)}` : ""}`,
+      status: res.status,
+      hint: "A brand-new thread may not be persisted yet; anything else means the credential or backendUrl is wrong.",
+      context: { thread_id: threadId, auth_mode: authMode }
+    });
+    endSpan("threads.history.error", { error, data: { thread_id: threadId } });
+    throw error;
+  }
+  const data = await res.json();
+  const channelMessages = (_b = (_a = data.thread) == null ? void 0 : _a.channel_values) == null ? void 0 : _b.messages;
+  endSpan("threads.history.done", {
+    data: {
+      thread_id: threadId,
+      found: data.thread_found !== false,
+      message_count: Array.isArray(channelMessages) ? channelMessages.length : ((_d = (_c = data.thread) == null ? void 0 : _c.messages) == null ? void 0 : _d.length) ?? 0
+    }
+  });
+  const thread = data.thread;
+  if (data.thread_found === false || !thread) {
+    return {
+      thread_id: threadId,
+      messages: []
+    };
+  }
+  const channelValues = thread.channel_values ?? {};
+  const rawMessages = Array.isArray(channelValues.messages) ? channelValues.messages : Array.isArray(thread.messages) ? thread.messages : [];
+  return {
+    ...channelValues,
+    thread_id: thread.thread_id ?? threadId,
+    messages: rawMessages.map(deserializeMessage),
+    ...thread.state ? { status: thread.state } : {}
+  };
+}
+async function archiveThread(backendUrl, auth, threadId) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/conversations/threads/archive`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({ thread_id: threadId })
+  });
+  if (!res.ok) {
+    throw new Error(`[AthenaSDK] Failed to archive thread: ${res.status}`);
+  }
+}
+exports.archiveThread = archiveThread;
+exports.createThread = createThread;
+exports.getThreadState = getThreadState;
+exports.listThreads = listThreads;
+exports.setThreadReadState = setThreadReadState;
+//# sourceMappingURL=api.cjs.map

package/dist/threads/api.cjs.map

@@ -0,0 +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\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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"}

package/dist/threads/api.js

@@ -0,0 +1,208 @@
+import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
+import { AthenaSdkError } from "../diagnostics/errors.js";
+function isAbortError(error) {
+  return error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
+}
+function getAuthHeaders(auth) {
+  if (auth.token) {
+    return { Authorization: `Bearer ${auth.token}` };
+  }
+  if (auth.apiKey) {
+    return { "X-API-KEY": auth.apiKey };
+  }
+  return {};
+}
+function getAthenaApiBaseUrl(backendUrl) {
+  const stripped = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
+  if (stripped === backendUrl) {
+    return backendUrl.replace(/\/$/, "");
+  }
+  return stripped;
+}
+async function listThreads(backendUrl, auth, opts = {}) {
+  var _a;
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const endSpan = athenaDiagnostics.span("threads.list", "threads.list.start", {
+    auth_mode: getAuthMode(auth),
+    app_id: opts.app_id
+  });
+  try {
+    const res = await fetch(`${base}/api/conversations/threads/list`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+      signal: opts.signal ?? null,
+      body: JSON.stringify({
+        limit: opts.limit ?? 50,
+        offset: opts.offset ?? 0,
+        // Default to the full recent-conversations set unless a caller
+        // explicitly asks to hide triggered/background sessions.
+        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 } : {}
+      })
+    });
+    if (!res.ok) {
+      throw new AthenaSdkError({
+        code: res.status === 401 || res.status === 403 ? "auth_rejected" : "threads_list_failed",
+        message: `Failed to list threads: ${res.status}`,
+        status: res.status,
+        hint: res.status === 401 || res.status === 403 ? "The credential was refused. Check the token/API key and that the user belongs to the workspace." : "Check backendUrl points at the Agora API base.",
+        context: { auth_mode: getAuthMode(auth) }
+      });
+    }
+    const data = await res.json();
+    endSpan("threads.list.done", { data: { count: ((_a = data.threads) == null ? void 0 : _a.length) ?? 0 } });
+    return data;
+  } catch (error) {
+    if (isAbortError(error)) {
+      endSpan("threads.list.aborted", { data: { reason: "request aborted" } });
+    } else {
+      endSpan("threads.list.error", { error });
+    }
+    throw error;
+  }
+}
+async function setThreadReadState(backendUrl, auth, opts) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/conversations/threads/read-state`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({
+      thread_id: opts.threadId,
+      is_unread: opts.isUnread
+    })
+  });
+  if (!res.ok) {
+    throw new Error(`[AthenaSDK] Failed to set thread read state: ${res.status}`);
+  }
+  return res.json();
+}
+async function createThread(backendUrl, auth, opts = {}) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/unstable/threads/`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({
+      config: {
+        system_prompt: opts.systemPrompt ?? "",
+        enabled_tools: opts.enabledTools,
+        ...opts.appId ? { app_id: opts.appId } : {}
+      }
+    })
+  });
+  if (!res.ok) {
+    throw new Error(`[AthenaSDK] Failed to create thread: ${res.status}`);
+  }
+  return res.json();
+}
+function deserializeMessage(msg) {
+  if (msg && typeof msg === "object" && "lc" in msg && "kwargs" in msg && msg.type === "constructor") {
+    const kwargs = msg.kwargs;
+    const deserializedToolCalls = Array.isArray(kwargs.tool_calls) ? kwargs.tool_calls.map((tc) => {
+      if (tc && typeof tc === "object" && "lc" in tc && "kwargs" in tc) {
+        return tc.kwargs;
+      }
+      return tc;
+    }) : kwargs.tool_calls;
+    return { ...kwargs, tool_calls: deserializedToolCalls };
+  }
+  return msg;
+}
+function getAuthMode(auth) {
+  if (auth.token) {
+    return "bearer";
+  }
+  if (auth.apiKey) {
+    return "api-key";
+  }
+  return "none";
+}
+function getResponseErrorBody(response) {
+  return response.text().catch(() => "");
+}
+async function getThreadState(backendUrl, auth, threadId) {
+  var _a, _b, _c, _d;
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const authMode = getAuthMode(auth);
+  const endpoint = `${base}/api/conversations/threads/get`;
+  const endSpan = athenaDiagnostics.span("threads.history", "threads.history.start", {
+    thread_id: threadId,
+    auth_mode: authMode
+  });
+  let res;
+  try {
+    res = await fetch(endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+      body: JSON.stringify({
+        thread_id: threadId,
+        skip_cache: true
+      })
+    });
+  } catch (error) {
+    if (isAbortError(error)) {
+      endSpan("threads.history.aborted", {
+        data: { thread_id: threadId, reason: "request aborted" }
+      });
+    } else {
+      endSpan("threads.history.error", { error, data: { thread_id: threadId } });
+    }
+    throw error;
+  }
+  if (!res.ok) {
+    const body = await getResponseErrorBody(res);
+    const error = new AthenaSdkError({
+      code: res.status === 401 || res.status === 403 ? "auth_rejected" : "thread_load_failed",
+      message: `Failed to get thread state: ${res.status} (${authMode})${body ? `: ${body.slice(0, 300)}` : ""}`,
+      status: res.status,
+      hint: "A brand-new thread may not be persisted yet; anything else means the credential or backendUrl is wrong.",
+      context: { thread_id: threadId, auth_mode: authMode }
+    });
+    endSpan("threads.history.error", { error, data: { thread_id: threadId } });
+    throw error;
+  }
+  const data = await res.json();
+  const channelMessages = (_b = (_a = data.thread) == null ? void 0 : _a.channel_values) == null ? void 0 : _b.messages;
+  endSpan("threads.history.done", {
+    data: {
+      thread_id: threadId,
+      found: data.thread_found !== false,
+      message_count: Array.isArray(channelMessages) ? channelMessages.length : ((_d = (_c = data.thread) == null ? void 0 : _c.messages) == null ? void 0 : _d.length) ?? 0
+    }
+  });
+  const thread = data.thread;
+  if (data.thread_found === false || !thread) {
+    return {
+      thread_id: threadId,
+      messages: []
+    };
+  }
+  const channelValues = thread.channel_values ?? {};
+  const rawMessages = Array.isArray(channelValues.messages) ? channelValues.messages : Array.isArray(thread.messages) ? thread.messages : [];
+  return {
+    ...channelValues,
+    thread_id: thread.thread_id ?? threadId,
+    messages: rawMessages.map(deserializeMessage),
+    ...thread.state ? { status: thread.state } : {}
+  };
+}
+async function archiveThread(backendUrl, auth, threadId) {
+  const base = getAthenaApiBaseUrl(backendUrl);
+  const res = await fetch(`${base}/api/conversations/threads/archive`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", ...getAuthHeaders(auth) },
+    body: JSON.stringify({ thread_id: threadId })
+  });
+  if (!res.ok) {
+    throw new Error(`[AthenaSDK] Failed to archive thread: ${res.status}`);
+  }
+}
+export {
+  archiveThread,
+  createThread,
+  getThreadState,
+  listThreads,
+  setThreadReadState
+};
+//# sourceMappingURL=api.js.map

package/dist/threads/api.js.map

@@ -0,0 +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\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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"}

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

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const api = require("./api.cjs");
+function threadListRequestBody(params) {
+  var _a;
+  const { filter } = params;
+  const unsupported = [];
+  if (filter.assetTypes && filter.assetTypes.length > 0) unsupported.push("assetTypes");
+  if (filter.states && filter.states.length > 0) unsupported.push("states");
+  if (filter.sourceChannels && filter.sourceChannels.length > 1) {
+    unsupported.push("sourceChannels (more than one)");
+  }
+  if (unsupported.length > 0) {
+    throw new Error(
+      `[AthenaSDK] The REST thread list cannot express filter field(s): ${unsupported.join(", ")}`
+    );
+  }
+  return {
+    limit: params.limit,
+    offset: params.offset,
+    ...filter.excludeTriggered !== void 0 ? { exclude_triggered: filter.excludeTriggered } : {},
+    ...filter.appId ? { app_id: filter.appId } : {},
+    ...((_a = filter.sourceChannels) == null ? void 0 : _a[0]) ? { start_channel: filter.sourceChannels[0] } : {},
+    ...filter.search ? { search: filter.search } : {}
+  };
+}
+function conversationSummaryFromThreadSummary(thread, filter) {
+  return {
+    threadId: thread.thread_id,
+    title: thread.title,
+    updatedAt: thread.updated_at,
+    createdAt: thread.created_at ?? null,
+    state: thread.state,
+    // Not reported by this endpoint.
+    runtime: null,
+    sourceChannel: thread.start_channel ?? null,
+    assetType: null,
+    assetId: null,
+    appId: thread.app_id ?? filter.appId ?? null,
+    triggerType: thread.trigger_type ?? null,
+    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
+  };
+}
+function createRestConversationListFetcher(options) {
+  return async (params) => {
+    const body = threadListRequestBody(params);
+    const { threads, has_more: hasMore } = await api.listThreads(
+      options.backendUrl,
+      await options.getAuth(),
+      {
+        ...body,
+        signal: params.signal
+      }
+    );
+    return {
+      items: threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter)),
+      hasMore: hasMore ?? threads.length >= params.limit,
+      totalCount: null
+    };
+  };
+}
+exports.conversationSummaryFromThreadSummary = conversationSummaryFromThreadSummary;
+exports.createRestConversationListFetcher = createRestConversationListFetcher;
+exports.threadListRequestBody = threadListRequestBody;
+//# sourceMappingURL=conversation-list-fetcher.cjs.map

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

@@ -0,0 +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 (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,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;;;;"}

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

@@ -0,0 +1,70 @@
+import { listThreads } from "./api.js";
+function threadListRequestBody(params) {
+  var _a;
+  const { filter } = params;
+  const unsupported = [];
+  if (filter.assetTypes && filter.assetTypes.length > 0) unsupported.push("assetTypes");
+  if (filter.states && filter.states.length > 0) unsupported.push("states");
+  if (filter.sourceChannels && filter.sourceChannels.length > 1) {
+    unsupported.push("sourceChannels (more than one)");
+  }
+  if (unsupported.length > 0) {
+    throw new Error(
+      `[AthenaSDK] The REST thread list cannot express filter field(s): ${unsupported.join(", ")}`
+    );
+  }
+  return {
+    limit: params.limit,
+    offset: params.offset,
+    ...filter.excludeTriggered !== void 0 ? { exclude_triggered: filter.excludeTriggered } : {},
+    ...filter.appId ? { app_id: filter.appId } : {},
+    ...((_a = filter.sourceChannels) == null ? void 0 : _a[0]) ? { start_channel: filter.sourceChannels[0] } : {},
+    ...filter.search ? { search: filter.search } : {}
+  };
+}
+function conversationSummaryFromThreadSummary(thread, filter) {
+  return {
+    threadId: thread.thread_id,
+    title: thread.title,
+    updatedAt: thread.updated_at,
+    createdAt: thread.created_at ?? null,
+    state: thread.state,
+    // Not reported by this endpoint.
+    runtime: null,
+    sourceChannel: thread.start_channel ?? null,
+    assetType: null,
+    assetId: null,
+    appId: thread.app_id ?? filter.appId ?? null,
+    triggerType: thread.trigger_type ?? null,
+    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
+  };
+}
+function createRestConversationListFetcher(options) {
+  return async (params) => {
+    const body = threadListRequestBody(params);
+    const { threads, has_more: hasMore } = await listThreads(
+      options.backendUrl,
+      await options.getAuth(),
+      {
+        ...body,
+        signal: params.signal
+      }
+    );
+    return {
+      items: threads.map((thread) => conversationSummaryFromThreadSummary(thread, params.filter)),
+      hasMore: hasMore ?? threads.length >= params.limit,
+      totalCount: null
+    };
+  };
+}
+export {
+  conversationSummaryFromThreadSummary,
+  createRestConversationListFetcher,
+  threadListRequestBody
+};
+//# sourceMappingURL=conversation-list-fetcher.js.map