@athenaintel/react 0.38.1 → 0.40.0

package/dist/composer/clipboard.d.ts

@@ -28,3 +28,12 @@ export interface PastedImage {
 export declare function extractPastedImages({ clipboardData, }: {
     clipboardData: DataTransfer;
 }): PastedImage[];
+export declare function isImageFile(file: File): boolean;
+/**
+ * The non-image files of a paste (a PDF or spreadsheet copied in Finder or
+ * Explorer), kept under their own names. Images come from
+ * {@link extractPastedImages}, which renames them.
+ */
+export declare function extractPastedNonImageFiles({ clipboardData, }: {
+    clipboardData: DataTransfer;
+}): File[];

package/dist/composer/clipboard.js

@@ -55,8 +55,24 @@ function extractPastedImages({
   }
   return images;
 }
+function isImageFile(file) {
+  return file.type.startsWith("image/");
+}
+function extractPastedNonImageFiles({
+  clipboardData
+}) {
+  const files = [];
+  for (const item of Array.from(clipboardData.items ?? [])) {
+    if (item.kind !== "file" || item.type.startsWith("image/")) continue;
+    const file = item.getAsFile();
+    if (file) files.push(file);
+  }
+  return files;
+}
 export {
   clipboardHasMeaningfulText,
-  extractPastedImages
+  extractPastedImages,
+  extractPastedNonImageFiles,
+  isImageFile
 };
 //# sourceMappingURL=clipboard.js.map

package/dist/composer/clipboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.js","sources":["../../src/composer/clipboard.ts"],"sourcesContent":["const IMAGE_EXTENSION_BY_MIME_TYPE: Record<string, string> = {\n  'image/avif': 'avif',\n  'image/bmp': 'bmp',\n  'image/gif': 'gif',\n  'image/heic': 'heic',\n  'image/jpeg': 'jpg',\n  'image/png': 'png',\n  'image/svg+xml': 'svg',\n  'image/tiff': 'tiff',\n  'image/webp': 'webp',\n};\n\n/** A lone image file name — what Finder and Explorer put in `text/plain` beside a copied image file. */\nconst IMAGE_FILE_NAME = /^[^\\s\\\\/]+\\.(?:png|jpe?g|gif|webp|svg|bmp|tiff?|heic|avif)$/i;\n\n/**\n * Whether a clipboard carries text the user meant to paste: non-blank\n * `text/plain`, or `text/html` with text content once tags are stripped. An\n * Excel, Sheets or Word copy puts the cells' text beside a bitmap of them —\n * the text is the payload and the image is incidental; a copied web image\n * carries only an `<img>` tag, which has no text content; a copied image\n * *file* carries its own name in `text/plain` (Finder, Explorer), which is\n * not content either — pass the pasted files' names so it is recognized.\n * Tolerates the partial `DataTransfer` shapes test environments hand out.\n */\nexport function clipboardHasMeaningfulText({\n  clipboardData,\n  pastedFileNames = [],\n}: {\n  clipboardData: DataTransfer;\n  pastedFileNames?: readonly string[];\n}): boolean {\n  const types = Array.from(clipboardData.types ?? []);\n  if (typeof clipboardData.getData !== 'function') return false;\n\n  if (types.includes('text/plain')) {\n    const plainText = clipboardData.getData('text/plain').trim();\n    const isFileName =\n      pastedFileNames.includes(plainText) || IMAGE_FILE_NAME.test(plainText);\n    if (plainText.length > 0 && !isFileName) {\n      return true;\n    }\n  }\n\n  if (types.includes('text/html')) {\n    const html = clipboardData.getData('text/html');\n    const textContent = html.replace(/<[^>]*>/g, '').trim();\n    if (textContent.length > 0) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport interface PastedImage {\n  /** The file as the composer attaches it: renamed so the asset gets a useful, unique title. */\n  file: File;\n  /** The name the clipboard carried — a copied file's own name, or the browser's bitmap default. */\n  originalName: string;\n}\n\n/**\n * The image files of a paste, from the clipboard's items. Each is renamed\n * `pasted-image-<stamp>.<ext>` (the second and later of one paste get a\n * `-2`, `-3`, … suffix) with the extension taken from the MIME type, so a\n * pasted bitmap becomes an asset titled by the paste rather than the\n * browser's `image.png` default.\n */\nexport function extractPastedImages({\n  clipboardData,\n}: {\n  clipboardData: DataTransfer;\n}): PastedImage[] {\n  const stamp = Date.now();\n  const images: PastedImage[] = [];\n  for (const item of Array.from(clipboardData.items ?? [])) {\n    if (!item.type.startsWith('image/')) continue;\n    const blob = item.getAsFile();\n    if (!blob) continue;\n    const originalName = blob.name || '';\n    const ordinal = images.length === 0 ? '' : `-${images.length + 1}`;\n    const extension =\n      IMAGE_EXTENSION_BY_MIME_TYPE[item.type] ??\n      item.type.slice('image/'.length).replace(/[^a-z0-9]/gi, '');\n    // Two parts on purpose: a File built from a single File part shares that\n    // part's name handle in some runtimes (Bun 1.3), so the rename would\n    // either be lost or applied to the clipboard's file as well.\n    images.push({\n      file: new File(\n        [blob, new Blob([])],\n        `pasted-image-${stamp}${ordinal}.${extension || 'png'}`,\n        { type: item.type },\n      ),\n      originalName,\n    });\n  }\n  return images;\n}\n"],"names":[],"mappings":"AAAA,MAAM,+BAAuD;AAAA,EAC3D,cAAc;AAAA,EACd,aAAa;AAAA,EACb,aAAa;AAAA,EACb,cAAc;AAAA,EACd,cAAc;AAAA,EACd,aAAa;AAAA,EACb,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,cAAc;AAChB;AAGA,MAAM,kBAAkB;AAYjB,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA,kBAAkB,CAAA;AACpB,GAGY;AACV,QAAM,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE;AAClD,MAAI,OAAO,cAAc,YAAY,WAAY,QAAO;AAExD,MAAI,MAAM,SAAS,YAAY,GAAG;AAChC,UAAM,YAAY,cAAc,QAAQ,YAAY,EAAE,KAAA;AACtD,UAAM,aACJ,gBAAgB,SAAS,SAAS,KAAK,gBAAgB,KAAK,SAAS;AACvE,QAAI,UAAU,SAAS,KAAK,CAAC,YAAY;AACvC,aAAO;AAAA,IACT;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,WAAW,GAAG;AAC/B,UAAM,OAAO,cAAc,QAAQ,WAAW;AAC9C,UAAM,cAAc,KAAK,QAAQ,YAAY,EAAE,EAAE,KAAA;AACjD,QAAI,YAAY,SAAS,GAAG;AAC1B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAgBO,SAAS,oBAAoB;AAAA,EAClC;AACF,GAEkB;AAChB,QAAM,QAAQ,KAAK,IAAA;AACnB,QAAM,SAAwB,CAAA;AAC9B,aAAW,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE,GAAG;AACxD,QAAI,CAAC,KAAK,KAAK,WAAW,QAAQ,EAAG;AACrC,UAAM,OAAO,KAAK,UAAA;AAClB,QAAI,CAAC,KAAM;AACX,UAAM,eAAe,KAAK,QAAQ;AAClC,UAAM,UAAU,OAAO,WAAW,IAAI,KAAK,IAAI,OAAO,SAAS,CAAC;AAChE,UAAM,YACJ,6BAA6B,KAAK,IAAI,KACtC,KAAK,KAAK,MAAM,SAAS,MAAM,EAAE,QAAQ,eAAe,EAAE;AAI5D,WAAO,KAAK;AAAA,MACV,MAAM,IAAI;AAAA,QACR,CAAC,MAAM,IAAI,KAAK,CAAA,CAAE,CAAC;AAAA,QACnB,gBAAgB,KAAK,GAAG,OAAO,IAAI,aAAa,KAAK;AAAA,QACrD,EAAE,MAAM,KAAK,KAAA;AAAA,MAAK;AAAA,MAEpB;AAAA,IAAA,CACD;AAAA,EACH;AACA,SAAO;AACT;"}
+{"version":3,"file":"clipboard.js","sources":["../../src/composer/clipboard.ts"],"sourcesContent":["const IMAGE_EXTENSION_BY_MIME_TYPE: Record<string, string> = {\n  'image/avif': 'avif',\n  'image/bmp': 'bmp',\n  'image/gif': 'gif',\n  'image/heic': 'heic',\n  'image/jpeg': 'jpg',\n  'image/png': 'png',\n  'image/svg+xml': 'svg',\n  'image/tiff': 'tiff',\n  'image/webp': 'webp',\n};\n\n/** A lone image file name — what Finder and Explorer put in `text/plain` beside a copied image file. */\nconst IMAGE_FILE_NAME = /^[^\\s\\\\/]+\\.(?:png|jpe?g|gif|webp|svg|bmp|tiff?|heic|avif)$/i;\n\n/**\n * Whether a clipboard carries text the user meant to paste: non-blank\n * `text/plain`, or `text/html` with text content once tags are stripped. An\n * Excel, Sheets or Word copy puts the cells' text beside a bitmap of them —\n * the text is the payload and the image is incidental; a copied web image\n * carries only an `<img>` tag, which has no text content; a copied image\n * *file* carries its own name in `text/plain` (Finder, Explorer), which is\n * not content either — pass the pasted files' names so it is recognized.\n * Tolerates the partial `DataTransfer` shapes test environments hand out.\n */\nexport function clipboardHasMeaningfulText({\n  clipboardData,\n  pastedFileNames = [],\n}: {\n  clipboardData: DataTransfer;\n  pastedFileNames?: readonly string[];\n}): boolean {\n  const types = Array.from(clipboardData.types ?? []);\n  if (typeof clipboardData.getData !== 'function') return false;\n\n  if (types.includes('text/plain')) {\n    const plainText = clipboardData.getData('text/plain').trim();\n    const isFileName =\n      pastedFileNames.includes(plainText) || IMAGE_FILE_NAME.test(plainText);\n    if (plainText.length > 0 && !isFileName) {\n      return true;\n    }\n  }\n\n  if (types.includes('text/html')) {\n    const html = clipboardData.getData('text/html');\n    const textContent = html.replace(/<[^>]*>/g, '').trim();\n    if (textContent.length > 0) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport interface PastedImage {\n  /** The file as the composer attaches it: renamed so the asset gets a useful, unique title. */\n  file: File;\n  /** The name the clipboard carried — a copied file's own name, or the browser's bitmap default. */\n  originalName: string;\n}\n\n/**\n * The image files of a paste, from the clipboard's items. Each is renamed\n * `pasted-image-<stamp>.<ext>` (the second and later of one paste get a\n * `-2`, `-3`, … suffix) with the extension taken from the MIME type, so a\n * pasted bitmap becomes an asset titled by the paste rather than the\n * browser's `image.png` default.\n */\nexport function extractPastedImages({\n  clipboardData,\n}: {\n  clipboardData: DataTransfer;\n}): PastedImage[] {\n  const stamp = Date.now();\n  const images: PastedImage[] = [];\n  for (const item of Array.from(clipboardData.items ?? [])) {\n    if (!item.type.startsWith('image/')) continue;\n    const blob = item.getAsFile();\n    if (!blob) continue;\n    const originalName = blob.name || '';\n    const ordinal = images.length === 0 ? '' : `-${images.length + 1}`;\n    const extension =\n      IMAGE_EXTENSION_BY_MIME_TYPE[item.type] ??\n      item.type.slice('image/'.length).replace(/[^a-z0-9]/gi, '');\n    // Two parts on purpose: a File built from a single File part shares that\n    // part's name handle in some runtimes (Bun 1.3), so the rename would\n    // either be lost or applied to the clipboard's file as well.\n    images.push({\n      file: new File(\n        [blob, new Blob([])],\n        `pasted-image-${stamp}${ordinal}.${extension || 'png'}`,\n        { type: item.type },\n      ),\n      originalName,\n    });\n  }\n  return images;\n}\n\nexport function isImageFile(file: File): boolean {\n  return file.type.startsWith('image/');\n}\n\n/**\n * The non-image files of a paste (a PDF or spreadsheet copied in Finder or\n * Explorer), kept under their own names. Images come from\n * {@link extractPastedImages}, which renames them.\n */\nexport function extractPastedNonImageFiles({\n  clipboardData,\n}: {\n  clipboardData: DataTransfer;\n}): File[] {\n  const files: File[] = [];\n  for (const item of Array.from(clipboardData.items ?? [])) {\n    if (item.kind !== 'file' || item.type.startsWith('image/')) continue;\n    const file = item.getAsFile();\n    if (file) files.push(file);\n  }\n  return files;\n}\n"],"names":[],"mappings":"AAAA,MAAM,+BAAuD;AAAA,EAC3D,cAAc;AAAA,EACd,aAAa;AAAA,EACb,aAAa;AAAA,EACb,cAAc;AAAA,EACd,cAAc;AAAA,EACd,aAAa;AAAA,EACb,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,cAAc;AAChB;AAGA,MAAM,kBAAkB;AAYjB,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA,kBAAkB,CAAA;AACpB,GAGY;AACV,QAAM,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE;AAClD,MAAI,OAAO,cAAc,YAAY,WAAY,QAAO;AAExD,MAAI,MAAM,SAAS,YAAY,GAAG;AAChC,UAAM,YAAY,cAAc,QAAQ,YAAY,EAAE,KAAA;AACtD,UAAM,aACJ,gBAAgB,SAAS,SAAS,KAAK,gBAAgB,KAAK,SAAS;AACvE,QAAI,UAAU,SAAS,KAAK,CAAC,YAAY;AACvC,aAAO;AAAA,IACT;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,WAAW,GAAG;AAC/B,UAAM,OAAO,cAAc,QAAQ,WAAW;AAC9C,UAAM,cAAc,KAAK,QAAQ,YAAY,EAAE,EAAE,KAAA;AACjD,QAAI,YAAY,SAAS,GAAG;AAC1B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAgBO,SAAS,oBAAoB;AAAA,EAClC;AACF,GAEkB;AAChB,QAAM,QAAQ,KAAK,IAAA;AACnB,QAAM,SAAwB,CAAA;AAC9B,aAAW,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE,GAAG;AACxD,QAAI,CAAC,KAAK,KAAK,WAAW,QAAQ,EAAG;AACrC,UAAM,OAAO,KAAK,UAAA;AAClB,QAAI,CAAC,KAAM;AACX,UAAM,eAAe,KAAK,QAAQ;AAClC,UAAM,UAAU,OAAO,WAAW,IAAI,KAAK,IAAI,OAAO,SAAS,CAAC;AAChE,UAAM,YACJ,6BAA6B,KAAK,IAAI,KACtC,KAAK,KAAK,MAAM,SAAS,MAAM,EAAE,QAAQ,eAAe,EAAE;AAI5D,WAAO,KAAK;AAAA,MACV,MAAM,IAAI;AAAA,QACR,CAAC,MAAM,IAAI,KAAK,CAAA,CAAE,CAAC;AAAA,QACnB,gBAAgB,KAAK,GAAG,OAAO,IAAI,aAAa,KAAK;AAAA,QACrD,EAAE,MAAM,KAAK,KAAA;AAAA,MAAK;AAAA,MAEpB;AAAA,IAAA,CACD;AAAA,EACH;AACA,SAAO;AACT;AAEO,SAAS,YAAY,MAAqB;AAC/C,SAAO,KAAK,KAAK,WAAW,QAAQ;AACtC;AAOO,SAAS,2BAA2B;AAAA,EACzC;AACF,GAEW;AACT,QAAM,QAAgB,CAAA;AACtB,aAAW,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE,GAAG;AACxD,QAAI,KAAK,SAAS,UAAU,KAAK,KAAK,WAAW,QAAQ,EAAG;AAC5D,UAAM,OAAO,KAAK,UAAA;AAClB,QAAI,KAAM,OAAM,KAAK,IAAI;AAAA,EAC3B;AACA,SAAO;AACT;"}

package/dist/diagnostics/errors.cjs

@@ -74,6 +74,17 @@ const ATHENA_SDK_ERROR_CODES = {
    * SSH target.
    */
   session_workspace_failed: "session_workspace_failed",
+  /**
+   * A computer's live desktop session
+   * (`/api/sandbox/computer/{id}/live-desktop/session`) was refused or failed.
+   */
+  live_desktop_failed: "live_desktop_failed",
+  /**
+   * Reading an asset's stored file (`GET /api/asset/content/{id}`, e.g. a
+   * test recording's video) failed for a reason other than a refused
+   * credential (those are `auth_rejected`).
+   */
+  asset_content_failed: "asset_content_failed",
   /** Anything else. */
   unknown: "unknown"
 };

package/dist/diagnostics/errors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.cjs","sources":["../../src/diagnostics/errors.ts"],"sourcesContent":["/**\n * Typed SDK errors. Every failure the SDK surfaces to a consumer carries a\n * stable `code` (matchable in code), a human `message`, and a `hint` — the\n * one-line \"what to do about it\" that turns a silent failure into a debuggable\n * one. Backend rejections keep their structured `{ status, detail }` payload.\n */\n\nexport const ATHENA_SDK_ERROR_CODES = {\n  /** No token and no API key resolved before a request had to be sent. */\n  auth_missing: 'auth_missing',\n  /** The server refused the credential (401 / statewire `unauthorized` fin). */\n  auth_rejected: 'auth_rejected',\n  /**\n   * `/_athena/auth` did not answer within the timeout on the last attempt of\n   * its bounded retry cycle. The bridge stopped retrying (see\n   * `ParentBridgeState.error`).\n   */\n  auth_bridge_timeout: 'auth_bridge_timeout',\n  /**\n   * `/_athena/auth` refused the mint (a 4xx other than 404), answered a body\n   * it cannot read, or kept failing (5xx, 408, 429, network) through its\n   * bounded retry cycle. The bridge stopped retrying and hands out no token\n   * (see `ParentBridgeState.error`).\n   */\n  auth_bridge_failed: 'auth_bridge_failed',\n  /**\n   * `AthenaSSOProvider`'s session read (`/api/sso/userinfo`) kept failing\n   * (5xx, 408, 429, network, timeout) through its bounded retries, or\n   * answered another status it does not retry, or a 2xx without a JSON body.\n   * The provider shows `displayOnError` with reason `request_failed`.\n   */\n  auth_sso_failed: 'auth_sso_failed',\n  /** The statewire sync URL could not be derived from the configuration. */\n  config_invalid: 'config_invalid',\n  /** The thread list request failed. */\n  threads_list_failed: 'threads_list_failed',\n  /** Loading a thread's history failed. */\n  thread_load_failed: 'thread_load_failed',\n  /**\n   * Pinning / unpinning a thread failed. `status` 404 / 405 means the backend\n   * predates `POST /api/conversations/threads/favorite` (see\n   * `isThreadFavoriteUnavailableError`); the pin then stays read-only.\n   */\n  thread_favorite_failed: 'thread_favorite_failed',\n  /**\n   * Renaming a thread failed. `status` 404 / 405 means the backend predates\n   * `POST /api/conversations/threads/rename` (see\n   * `isThreadRenameUnavailableError`); the list then offers no rename.\n   */\n  thread_rename_failed: 'thread_rename_failed',\n  /**\n   * Archiving a thread failed. `status` 404 / 405 means the backend has no\n   * archive route (see `isThreadArchiveUnavailableError`); the list then\n   * offers no archive action.\n   */\n  thread_archive_failed: 'thread_archive_failed',\n  /** The statewire host rejected a command (structured `{status, detail}`). */\n  statewire_rejected: 'statewire_rejected',\n  /** The statewire connection is gone and will not reconnect on its own. */\n  statewire_gone: 'statewire_gone',\n  /** The selected collab agent / channel was refused by the backend. */\n  collab_agent_rejected: 'collab_agent_rejected',\n  /** A React render error crashed the chat surface (caught by the SDK's error boundary). */\n  chat_render_crash: 'chat_render_crash',\n  /** A pasted or dropped file could not be uploaded as a composer attachment. */\n  attachment_failed: 'attachment_failed',\n  /** Mention suggestions for a scope failed after every retry. */\n  mentions_fetch_failed: 'mentions_fetch_failed',\n  /** A composer write queued before the chat was ready can no longer land (thread switched, identity changed, provider unmounted). */\n  composer_write_dropped: 'composer_write_dropped',\n  /** The repository code search request (`/api/search/repositories`) failed. */\n  repo_search_failed: 'repo_search_failed',\n  /**\n   * A session workbench read failed: the session's workspace\n   * (`/api/conversations/threads/{id}/workspace`) or a computer's status or\n   * SSH target.\n   */\n  session_workspace_failed: 'session_workspace_failed',\n  /** Anything else. */\n  unknown: 'unknown',\n} as const;\n\nexport type AthenaSdkErrorCode =\n  (typeof ATHENA_SDK_ERROR_CODES)[keyof typeof ATHENA_SDK_ERROR_CODES];\n\nexport interface AthenaSdkErrorOptions {\n  code: AthenaSdkErrorCode;\n  message: string;\n  /** One line telling the integrator what to check or change. */\n  hint?: string;\n  /** HTTP-ish status when the failure came from a server. */\n  status?: number;\n  /** Structured server detail (e.g. `{ code, message }` from agora). */\n  detail?: unknown;\n  cause?: unknown;\n  /** Extra structured context safe to log (never credentials). */\n  context?: Record<string, unknown>;\n}\n\nexport class AthenaSdkError extends Error {\n  readonly code: AthenaSdkErrorCode;\n  readonly hint: string | undefined;\n  readonly status: number | undefined;\n  readonly detail: unknown;\n  readonly context: Record<string, unknown>;\n\n  constructor(options: AthenaSdkErrorOptions) {\n    super(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = 'AthenaSdkError';\n    this.code = options.code;\n    this.hint = options.hint;\n    this.status = options.status;\n    this.detail = options.detail;\n    this.context = options.context ?? {};\n  }\n\n  /** A log/console-friendly one-liner: `[code] message — hint`. */\n  describe(): string {\n    return `[${this.code}] ${this.message}${this.hint ? ` — ${this.hint}` : ''}`;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      hint: this.hint,\n      status: this.status,\n      detail: this.detail,\n      context: this.context,\n    };\n  }\n}\n\nexport function isAthenaSdkError(value: unknown): value is AthenaSdkError {\n  return value instanceof AthenaSdkError;\n}\n\n/** Wrap any thrown value as an `AthenaSdkError` (idempotent for SDK errors). */\nexport function toAthenaSdkError(\n  value: unknown,\n  fallback: Omit<AthenaSdkErrorOptions, 'cause'>,\n): AthenaSdkError {\n  if (isAthenaSdkError(value)) return value;\n  const message =\n    value instanceof Error && value.message ? value.message : fallback.message;\n  return new AthenaSdkError({ ...fallback, message, cause: value });\n}\n\n/** Structured `{ code, message }` detail from an agora rejection, if present. */\nexport function readRejectionDetail(\n  detail: unknown,\n): { code: string | null; message: string | null } {\n  if (typeof detail === 'string') return { code: null, message: detail || null };\n  if (!detail || typeof detail !== 'object') return { code: null, message: null };\n  const record = detail as { code?: unknown; message?: unknown };\n  return {\n    code: typeof record.code === 'string' ? record.code : null,\n    message: typeof record.message === 'string' ? record.message : null,\n  };\n}\n"],"names":[],"mappings":";;;;;AAOO,MAAM,yBAAyB;AAAA;AAAA,EAEpC,cAAc;AAAA;AAAA,EAEd,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,iBAAiB;AAAA;AAAA,EAEjB,gBAAgB;AAAA;AAAA,EAEhB,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,wBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMxB,sBAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtB,uBAAuB;AAAA;AAAA,EAEvB,oBAAoB;AAAA;AAAA,EAEpB,gBAAgB;AAAA;AAAA,EAEhB,uBAAuB;AAAA;AAAA,EAEvB,mBAAmB;AAAA;AAAA,EAEnB,mBAAmB;AAAA;AAAA,EAEnB,uBAAuB;AAAA;AAAA,EAEvB,wBAAwB;AAAA;AAAA,EAExB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,0BAA0B;AAAA;AAAA,EAE1B,SAAS;AACX;AAmBO,MAAM,uBAAuB,MAAM;AAAA,EAOxC,YAAY,SAAgC;AAC1C,UAAM,QAAQ,SAAS,QAAQ,UAAU,SAAY,SAAY,EAAE,OAAO,QAAQ,MAAA,CAAO;AAPlF;AACA;AACA;AACA;AACA;AAIP,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ;AACpB,SAAK,OAAO,QAAQ;AACpB,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ,WAAW,CAAA;AAAA,EACpC;AAAA;AAAA,EAGA,WAAmB;AACjB,WAAO,IAAI,KAAK,IAAI,KAAK,KAAK,OAAO,GAAG,KAAK,OAAO,MAAM,KAAK,IAAI,KAAK,EAAE;AAAA,EAC5E;AAAA,EAEA,SAAkC;AAChC,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,MAAM,KAAK;AAAA,MACX,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,SAAS,KAAK;AAAA,IAAA;AAAA,EAElB;AACF;AAEO,SAAS,iBAAiB,OAAyC;AACxE,SAAO,iBAAiB;AAC1B;AAGO,SAAS,iBACd,OACA,UACgB;AAChB,MAAI,iBAAiB,KAAK,EAAG,QAAO;AACpC,QAAM,UACJ,iBAAiB,SAAS,MAAM,UAAU,MAAM,UAAU,SAAS;AACrE,SAAO,IAAI,eAAe,EAAE,GAAG,UAAU,SAAS,OAAO,OAAO;AAClE;AAGO,SAAS,oBACd,QACiD;AACjD,MAAI,OAAO,WAAW,SAAU,QAAO,EAAE,MAAM,MAAM,SAAS,UAAU,KAAA;AACxE,MAAI,CAAC,UAAU,OAAO,WAAW,iBAAiB,EAAE,MAAM,MAAM,SAAS,KAAA;AACzE,QAAM,SAAS;AACf,SAAO;AAAA,IACL,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAAA,IACtD,SAAS,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU;AAAA,EAAA;AAEnE;;;;;;"}
+{"version":3,"file":"errors.cjs","sources":["../../src/diagnostics/errors.ts"],"sourcesContent":["/**\n * Typed SDK errors. Every failure the SDK surfaces to a consumer carries a\n * stable `code` (matchable in code), a human `message`, and a `hint` — the\n * one-line \"what to do about it\" that turns a silent failure into a debuggable\n * one. Backend rejections keep their structured `{ status, detail }` payload.\n */\n\nexport const ATHENA_SDK_ERROR_CODES = {\n  /** No token and no API key resolved before a request had to be sent. */\n  auth_missing: 'auth_missing',\n  /** The server refused the credential (401 / statewire `unauthorized` fin). */\n  auth_rejected: 'auth_rejected',\n  /**\n   * `/_athena/auth` did not answer within the timeout on the last attempt of\n   * its bounded retry cycle. The bridge stopped retrying (see\n   * `ParentBridgeState.error`).\n   */\n  auth_bridge_timeout: 'auth_bridge_timeout',\n  /**\n   * `/_athena/auth` refused the mint (a 4xx other than 404), answered a body\n   * it cannot read, or kept failing (5xx, 408, 429, network) through its\n   * bounded retry cycle. The bridge stopped retrying and hands out no token\n   * (see `ParentBridgeState.error`).\n   */\n  auth_bridge_failed: 'auth_bridge_failed',\n  /**\n   * `AthenaSSOProvider`'s session read (`/api/sso/userinfo`) kept failing\n   * (5xx, 408, 429, network, timeout) through its bounded retries, or\n   * answered another status it does not retry, or a 2xx without a JSON body.\n   * The provider shows `displayOnError` with reason `request_failed`.\n   */\n  auth_sso_failed: 'auth_sso_failed',\n  /** The statewire sync URL could not be derived from the configuration. */\n  config_invalid: 'config_invalid',\n  /** The thread list request failed. */\n  threads_list_failed: 'threads_list_failed',\n  /** Loading a thread's history failed. */\n  thread_load_failed: 'thread_load_failed',\n  /**\n   * Pinning / unpinning a thread failed. `status` 404 / 405 means the backend\n   * predates `POST /api/conversations/threads/favorite` (see\n   * `isThreadFavoriteUnavailableError`); the pin then stays read-only.\n   */\n  thread_favorite_failed: 'thread_favorite_failed',\n  /**\n   * Renaming a thread failed. `status` 404 / 405 means the backend predates\n   * `POST /api/conversations/threads/rename` (see\n   * `isThreadRenameUnavailableError`); the list then offers no rename.\n   */\n  thread_rename_failed: 'thread_rename_failed',\n  /**\n   * Archiving a thread failed. `status` 404 / 405 means the backend has no\n   * archive route (see `isThreadArchiveUnavailableError`); the list then\n   * offers no archive action.\n   */\n  thread_archive_failed: 'thread_archive_failed',\n  /** The statewire host rejected a command (structured `{status, detail}`). */\n  statewire_rejected: 'statewire_rejected',\n  /** The statewire connection is gone and will not reconnect on its own. */\n  statewire_gone: 'statewire_gone',\n  /** The selected collab agent / channel was refused by the backend. */\n  collab_agent_rejected: 'collab_agent_rejected',\n  /** A React render error crashed the chat surface (caught by the SDK's error boundary). */\n  chat_render_crash: 'chat_render_crash',\n  /** A pasted or dropped file could not be uploaded as a composer attachment. */\n  attachment_failed: 'attachment_failed',\n  /** Mention suggestions for a scope failed after every retry. */\n  mentions_fetch_failed: 'mentions_fetch_failed',\n  /** A composer write queued before the chat was ready can no longer land (thread switched, identity changed, provider unmounted). */\n  composer_write_dropped: 'composer_write_dropped',\n  /** The repository code search request (`/api/search/repositories`) failed. */\n  repo_search_failed: 'repo_search_failed',\n  /**\n   * A session workbench read failed: the session's workspace\n   * (`/api/conversations/threads/{id}/workspace`) or a computer's status or\n   * SSH target.\n   */\n  session_workspace_failed: 'session_workspace_failed',\n  /**\n   * A computer's live desktop session\n   * (`/api/sandbox/computer/{id}/live-desktop/session`) was refused or failed.\n   */\n  live_desktop_failed: 'live_desktop_failed',\n  /**\n   * Reading an asset's stored file (`GET /api/asset/content/{id}`, e.g. a\n   * test recording's video) failed for a reason other than a refused\n   * credential (those are `auth_rejected`).\n   */\n  asset_content_failed: 'asset_content_failed',\n  /** Anything else. */\n  unknown: 'unknown',\n} as const;\n\nexport type AthenaSdkErrorCode =\n  (typeof ATHENA_SDK_ERROR_CODES)[keyof typeof ATHENA_SDK_ERROR_CODES];\n\nexport interface AthenaSdkErrorOptions {\n  code: AthenaSdkErrorCode;\n  message: string;\n  /** One line telling the integrator what to check or change. */\n  hint?: string;\n  /** HTTP-ish status when the failure came from a server. */\n  status?: number;\n  /** Structured server detail (e.g. `{ code, message }` from agora). */\n  detail?: unknown;\n  cause?: unknown;\n  /** Extra structured context safe to log (never credentials). */\n  context?: Record<string, unknown>;\n}\n\nexport class AthenaSdkError extends Error {\n  readonly code: AthenaSdkErrorCode;\n  readonly hint: string | undefined;\n  readonly status: number | undefined;\n  readonly detail: unknown;\n  readonly context: Record<string, unknown>;\n\n  constructor(options: AthenaSdkErrorOptions) {\n    super(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = 'AthenaSdkError';\n    this.code = options.code;\n    this.hint = options.hint;\n    this.status = options.status;\n    this.detail = options.detail;\n    this.context = options.context ?? {};\n  }\n\n  /** A log/console-friendly one-liner: `[code] message — hint`. */\n  describe(): string {\n    return `[${this.code}] ${this.message}${this.hint ? ` — ${this.hint}` : ''}`;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      hint: this.hint,\n      status: this.status,\n      detail: this.detail,\n      context: this.context,\n    };\n  }\n}\n\nexport function isAthenaSdkError(value: unknown): value is AthenaSdkError {\n  return value instanceof AthenaSdkError;\n}\n\n/** Wrap any thrown value as an `AthenaSdkError` (idempotent for SDK errors). */\nexport function toAthenaSdkError(\n  value: unknown,\n  fallback: Omit<AthenaSdkErrorOptions, 'cause'>,\n): AthenaSdkError {\n  if (isAthenaSdkError(value)) return value;\n  const message =\n    value instanceof Error && value.message ? value.message : fallback.message;\n  return new AthenaSdkError({ ...fallback, message, cause: value });\n}\n\n/** Structured `{ code, message }` detail from an agora rejection, if present. */\nexport function readRejectionDetail(\n  detail: unknown,\n): { code: string | null; message: string | null } {\n  if (typeof detail === 'string') return { code: null, message: detail || null };\n  if (!detail || typeof detail !== 'object') return { code: null, message: null };\n  const record = detail as { code?: unknown; message?: unknown };\n  return {\n    code: typeof record.code === 'string' ? record.code : null,\n    message: typeof record.message === 'string' ? record.message : null,\n  };\n}\n"],"names":[],"mappings":";;;;;AAOO,MAAM,yBAAyB;AAAA;AAAA,EAEpC,cAAc;AAAA;AAAA,EAEd,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,iBAAiB;AAAA;AAAA,EAEjB,gBAAgB;AAAA;AAAA,EAEhB,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,wBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMxB,sBAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtB,uBAAuB;AAAA;AAAA,EAEvB,oBAAoB;AAAA;AAAA,EAEpB,gBAAgB;AAAA;AAAA,EAEhB,uBAAuB;AAAA;AAAA,EAEvB,mBAAmB;AAAA;AAAA,EAEnB,mBAAmB;AAAA;AAAA,EAEnB,uBAAuB;AAAA;AAAA,EAEvB,wBAAwB;AAAA;AAAA,EAExB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAAA,EAK1B,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMrB,sBAAsB;AAAA;AAAA,EAEtB,SAAS;AACX;AAmBO,MAAM,uBAAuB,MAAM;AAAA,EAOxC,YAAY,SAAgC;AAC1C,UAAM,QAAQ,SAAS,QAAQ,UAAU,SAAY,SAAY,EAAE,OAAO,QAAQ,MAAA,CAAO;AAPlF;AACA;AACA;AACA;AACA;AAIP,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ;AACpB,SAAK,OAAO,QAAQ;AACpB,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ,WAAW,CAAA;AAAA,EACpC;AAAA;AAAA,EAGA,WAAmB;AACjB,WAAO,IAAI,KAAK,IAAI,KAAK,KAAK,OAAO,GAAG,KAAK,OAAO,MAAM,KAAK,IAAI,KAAK,EAAE;AAAA,EAC5E;AAAA,EAEA,SAAkC;AAChC,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,MAAM,KAAK;AAAA,MACX,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,SAAS,KAAK;AAAA,IAAA;AAAA,EAElB;AACF;AAEO,SAAS,iBAAiB,OAAyC;AACxE,SAAO,iBAAiB;AAC1B;AAGO,SAAS,iBACd,OACA,UACgB;AAChB,MAAI,iBAAiB,KAAK,EAAG,QAAO;AACpC,QAAM,UACJ,iBAAiB,SAAS,MAAM,UAAU,MAAM,UAAU,SAAS;AACrE,SAAO,IAAI,eAAe,EAAE,GAAG,UAAU,SAAS,OAAO,OAAO;AAClE;AAGO,SAAS,oBACd,QACiD;AACjD,MAAI,OAAO,WAAW,SAAU,QAAO,EAAE,MAAM,MAAM,SAAS,UAAU,KAAA;AACxE,MAAI,CAAC,UAAU,OAAO,WAAW,iBAAiB,EAAE,MAAM,MAAM,SAAS,KAAA;AACzE,QAAM,SAAS;AACf,SAAO;AAAA,IACL,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAAA,IACtD,SAAS,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU;AAAA,EAAA;AAEnE;;;;;;"}

package/dist/diagnostics/errors.d.ts

@@ -75,6 +75,17 @@ export declare const ATHENA_SDK_ERROR_CODES: {
      * SSH target.
      */
     readonly session_workspace_failed: 'session_workspace_failed';
+    /**
+     * A computer's live desktop session
+     * (`/api/sandbox/computer/{id}/live-desktop/session`) was refused or failed.
+     */
+    readonly live_desktop_failed: 'live_desktop_failed';
+    /**
+     * Reading an asset's stored file (`GET /api/asset/content/{id}`, e.g. a
+     * test recording's video) failed for a reason other than a refused
+     * credential (those are `auth_rejected`).
+     */
+    readonly asset_content_failed: 'asset_content_failed';
     /** Anything else. */
     readonly unknown: 'unknown';
 };

package/dist/diagnostics/errors.js

@@ -72,6 +72,17 @@ const ATHENA_SDK_ERROR_CODES = {
    * SSH target.
    */
   session_workspace_failed: "session_workspace_failed",
+  /**
+   * A computer's live desktop session
+   * (`/api/sandbox/computer/{id}/live-desktop/session`) was refused or failed.
+   */
+  live_desktop_failed: "live_desktop_failed",
+  /**
+   * Reading an asset's stored file (`GET /api/asset/content/{id}`, e.g. a
+   * test recording's video) failed for a reason other than a refused
+   * credential (those are `auth_rejected`).
+   */
+  asset_content_failed: "asset_content_failed",
   /** Anything else. */
   unknown: "unknown"
 };

package/dist/diagnostics/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sources":["../../src/diagnostics/errors.ts"],"sourcesContent":["/**\n * Typed SDK errors. Every failure the SDK surfaces to a consumer carries a\n * stable `code` (matchable in code), a human `message`, and a `hint` — the\n * one-line \"what to do about it\" that turns a silent failure into a debuggable\n * one. Backend rejections keep their structured `{ status, detail }` payload.\n */\n\nexport const ATHENA_SDK_ERROR_CODES = {\n  /** No token and no API key resolved before a request had to be sent. */\n  auth_missing: 'auth_missing',\n  /** The server refused the credential (401 / statewire `unauthorized` fin). */\n  auth_rejected: 'auth_rejected',\n  /**\n   * `/_athena/auth` did not answer within the timeout on the last attempt of\n   * its bounded retry cycle. The bridge stopped retrying (see\n   * `ParentBridgeState.error`).\n   */\n  auth_bridge_timeout: 'auth_bridge_timeout',\n  /**\n   * `/_athena/auth` refused the mint (a 4xx other than 404), answered a body\n   * it cannot read, or kept failing (5xx, 408, 429, network) through its\n   * bounded retry cycle. The bridge stopped retrying and hands out no token\n   * (see `ParentBridgeState.error`).\n   */\n  auth_bridge_failed: 'auth_bridge_failed',\n  /**\n   * `AthenaSSOProvider`'s session read (`/api/sso/userinfo`) kept failing\n   * (5xx, 408, 429, network, timeout) through its bounded retries, or\n   * answered another status it does not retry, or a 2xx without a JSON body.\n   * The provider shows `displayOnError` with reason `request_failed`.\n   */\n  auth_sso_failed: 'auth_sso_failed',\n  /** The statewire sync URL could not be derived from the configuration. */\n  config_invalid: 'config_invalid',\n  /** The thread list request failed. */\n  threads_list_failed: 'threads_list_failed',\n  /** Loading a thread's history failed. */\n  thread_load_failed: 'thread_load_failed',\n  /**\n   * Pinning / unpinning a thread failed. `status` 404 / 405 means the backend\n   * predates `POST /api/conversations/threads/favorite` (see\n   * `isThreadFavoriteUnavailableError`); the pin then stays read-only.\n   */\n  thread_favorite_failed: 'thread_favorite_failed',\n  /**\n   * Renaming a thread failed. `status` 404 / 405 means the backend predates\n   * `POST /api/conversations/threads/rename` (see\n   * `isThreadRenameUnavailableError`); the list then offers no rename.\n   */\n  thread_rename_failed: 'thread_rename_failed',\n  /**\n   * Archiving a thread failed. `status` 404 / 405 means the backend has no\n   * archive route (see `isThreadArchiveUnavailableError`); the list then\n   * offers no archive action.\n   */\n  thread_archive_failed: 'thread_archive_failed',\n  /** The statewire host rejected a command (structured `{status, detail}`). */\n  statewire_rejected: 'statewire_rejected',\n  /** The statewire connection is gone and will not reconnect on its own. */\n  statewire_gone: 'statewire_gone',\n  /** The selected collab agent / channel was refused by the backend. */\n  collab_agent_rejected: 'collab_agent_rejected',\n  /** A React render error crashed the chat surface (caught by the SDK's error boundary). */\n  chat_render_crash: 'chat_render_crash',\n  /** A pasted or dropped file could not be uploaded as a composer attachment. */\n  attachment_failed: 'attachment_failed',\n  /** Mention suggestions for a scope failed after every retry. */\n  mentions_fetch_failed: 'mentions_fetch_failed',\n  /** A composer write queued before the chat was ready can no longer land (thread switched, identity changed, provider unmounted). */\n  composer_write_dropped: 'composer_write_dropped',\n  /** The repository code search request (`/api/search/repositories`) failed. */\n  repo_search_failed: 'repo_search_failed',\n  /**\n   * A session workbench read failed: the session's workspace\n   * (`/api/conversations/threads/{id}/workspace`) or a computer's status or\n   * SSH target.\n   */\n  session_workspace_failed: 'session_workspace_failed',\n  /** Anything else. */\n  unknown: 'unknown',\n} as const;\n\nexport type AthenaSdkErrorCode =\n  (typeof ATHENA_SDK_ERROR_CODES)[keyof typeof ATHENA_SDK_ERROR_CODES];\n\nexport interface AthenaSdkErrorOptions {\n  code: AthenaSdkErrorCode;\n  message: string;\n  /** One line telling the integrator what to check or change. */\n  hint?: string;\n  /** HTTP-ish status when the failure came from a server. */\n  status?: number;\n  /** Structured server detail (e.g. `{ code, message }` from agora). */\n  detail?: unknown;\n  cause?: unknown;\n  /** Extra structured context safe to log (never credentials). */\n  context?: Record<string, unknown>;\n}\n\nexport class AthenaSdkError extends Error {\n  readonly code: AthenaSdkErrorCode;\n  readonly hint: string | undefined;\n  readonly status: number | undefined;\n  readonly detail: unknown;\n  readonly context: Record<string, unknown>;\n\n  constructor(options: AthenaSdkErrorOptions) {\n    super(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = 'AthenaSdkError';\n    this.code = options.code;\n    this.hint = options.hint;\n    this.status = options.status;\n    this.detail = options.detail;\n    this.context = options.context ?? {};\n  }\n\n  /** A log/console-friendly one-liner: `[code] message — hint`. */\n  describe(): string {\n    return `[${this.code}] ${this.message}${this.hint ? ` — ${this.hint}` : ''}`;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      hint: this.hint,\n      status: this.status,\n      detail: this.detail,\n      context: this.context,\n    };\n  }\n}\n\nexport function isAthenaSdkError(value: unknown): value is AthenaSdkError {\n  return value instanceof AthenaSdkError;\n}\n\n/** Wrap any thrown value as an `AthenaSdkError` (idempotent for SDK errors). */\nexport function toAthenaSdkError(\n  value: unknown,\n  fallback: Omit<AthenaSdkErrorOptions, 'cause'>,\n): AthenaSdkError {\n  if (isAthenaSdkError(value)) return value;\n  const message =\n    value instanceof Error && value.message ? value.message : fallback.message;\n  return new AthenaSdkError({ ...fallback, message, cause: value });\n}\n\n/** Structured `{ code, message }` detail from an agora rejection, if present. */\nexport function readRejectionDetail(\n  detail: unknown,\n): { code: string | null; message: string | null } {\n  if (typeof detail === 'string') return { code: null, message: detail || null };\n  if (!detail || typeof detail !== 'object') return { code: null, message: null };\n  const record = detail as { code?: unknown; message?: unknown };\n  return {\n    code: typeof record.code === 'string' ? record.code : null,\n    message: typeof record.message === 'string' ? record.message : null,\n  };\n}\n"],"names":[],"mappings":";;;AAOO,MAAM,yBAAyB;AAAA;AAAA,EAEpC,cAAc;AAAA;AAAA,EAEd,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,iBAAiB;AAAA;AAAA,EAEjB,gBAAgB;AAAA;AAAA,EAEhB,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,wBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMxB,sBAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtB,uBAAuB;AAAA;AAAA,EAEvB,oBAAoB;AAAA;AAAA,EAEpB,gBAAgB;AAAA;AAAA,EAEhB,uBAAuB;AAAA;AAAA,EAEvB,mBAAmB;AAAA;AAAA,EAEnB,mBAAmB;AAAA;AAAA,EAEnB,uBAAuB;AAAA;AAAA,EAEvB,wBAAwB;AAAA;AAAA,EAExB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,0BAA0B;AAAA;AAAA,EAE1B,SAAS;AACX;AAmBO,MAAM,uBAAuB,MAAM;AAAA,EAOxC,YAAY,SAAgC;AAC1C,UAAM,QAAQ,SAAS,QAAQ,UAAU,SAAY,SAAY,EAAE,OAAO,QAAQ,MAAA,CAAO;AAPlF;AACA;AACA;AACA;AACA;AAIP,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ;AACpB,SAAK,OAAO,QAAQ;AACpB,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ,WAAW,CAAA;AAAA,EACpC;AAAA;AAAA,EAGA,WAAmB;AACjB,WAAO,IAAI,KAAK,IAAI,KAAK,KAAK,OAAO,GAAG,KAAK,OAAO,MAAM,KAAK,IAAI,KAAK,EAAE;AAAA,EAC5E;AAAA,EAEA,SAAkC;AAChC,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,MAAM,KAAK;AAAA,MACX,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,SAAS,KAAK;AAAA,IAAA;AAAA,EAElB;AACF;AAEO,SAAS,iBAAiB,OAAyC;AACxE,SAAO,iBAAiB;AAC1B;AAGO,SAAS,iBACd,OACA,UACgB;AAChB,MAAI,iBAAiB,KAAK,EAAG,QAAO;AACpC,QAAM,UACJ,iBAAiB,SAAS,MAAM,UAAU,MAAM,UAAU,SAAS;AACrE,SAAO,IAAI,eAAe,EAAE,GAAG,UAAU,SAAS,OAAO,OAAO;AAClE;AAGO,SAAS,oBACd,QACiD;AACjD,MAAI,OAAO,WAAW,SAAU,QAAO,EAAE,MAAM,MAAM,SAAS,UAAU,KAAA;AACxE,MAAI,CAAC,UAAU,OAAO,WAAW,iBAAiB,EAAE,MAAM,MAAM,SAAS,KAAA;AACzE,QAAM,SAAS;AACf,SAAO;AAAA,IACL,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAAA,IACtD,SAAS,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU;AAAA,EAAA;AAEnE;"}
+{"version":3,"file":"errors.js","sources":["../../src/diagnostics/errors.ts"],"sourcesContent":["/**\n * Typed SDK errors. Every failure the SDK surfaces to a consumer carries a\n * stable `code` (matchable in code), a human `message`, and a `hint` — the\n * one-line \"what to do about it\" that turns a silent failure into a debuggable\n * one. Backend rejections keep their structured `{ status, detail }` payload.\n */\n\nexport const ATHENA_SDK_ERROR_CODES = {\n  /** No token and no API key resolved before a request had to be sent. */\n  auth_missing: 'auth_missing',\n  /** The server refused the credential (401 / statewire `unauthorized` fin). */\n  auth_rejected: 'auth_rejected',\n  /**\n   * `/_athena/auth` did not answer within the timeout on the last attempt of\n   * its bounded retry cycle. The bridge stopped retrying (see\n   * `ParentBridgeState.error`).\n   */\n  auth_bridge_timeout: 'auth_bridge_timeout',\n  /**\n   * `/_athena/auth` refused the mint (a 4xx other than 404), answered a body\n   * it cannot read, or kept failing (5xx, 408, 429, network) through its\n   * bounded retry cycle. The bridge stopped retrying and hands out no token\n   * (see `ParentBridgeState.error`).\n   */\n  auth_bridge_failed: 'auth_bridge_failed',\n  /**\n   * `AthenaSSOProvider`'s session read (`/api/sso/userinfo`) kept failing\n   * (5xx, 408, 429, network, timeout) through its bounded retries, or\n   * answered another status it does not retry, or a 2xx without a JSON body.\n   * The provider shows `displayOnError` with reason `request_failed`.\n   */\n  auth_sso_failed: 'auth_sso_failed',\n  /** The statewire sync URL could not be derived from the configuration. */\n  config_invalid: 'config_invalid',\n  /** The thread list request failed. */\n  threads_list_failed: 'threads_list_failed',\n  /** Loading a thread's history failed. */\n  thread_load_failed: 'thread_load_failed',\n  /**\n   * Pinning / unpinning a thread failed. `status` 404 / 405 means the backend\n   * predates `POST /api/conversations/threads/favorite` (see\n   * `isThreadFavoriteUnavailableError`); the pin then stays read-only.\n   */\n  thread_favorite_failed: 'thread_favorite_failed',\n  /**\n   * Renaming a thread failed. `status` 404 / 405 means the backend predates\n   * `POST /api/conversations/threads/rename` (see\n   * `isThreadRenameUnavailableError`); the list then offers no rename.\n   */\n  thread_rename_failed: 'thread_rename_failed',\n  /**\n   * Archiving a thread failed. `status` 404 / 405 means the backend has no\n   * archive route (see `isThreadArchiveUnavailableError`); the list then\n   * offers no archive action.\n   */\n  thread_archive_failed: 'thread_archive_failed',\n  /** The statewire host rejected a command (structured `{status, detail}`). */\n  statewire_rejected: 'statewire_rejected',\n  /** The statewire connection is gone and will not reconnect on its own. */\n  statewire_gone: 'statewire_gone',\n  /** The selected collab agent / channel was refused by the backend. */\n  collab_agent_rejected: 'collab_agent_rejected',\n  /** A React render error crashed the chat surface (caught by the SDK's error boundary). */\n  chat_render_crash: 'chat_render_crash',\n  /** A pasted or dropped file could not be uploaded as a composer attachment. */\n  attachment_failed: 'attachment_failed',\n  /** Mention suggestions for a scope failed after every retry. */\n  mentions_fetch_failed: 'mentions_fetch_failed',\n  /** A composer write queued before the chat was ready can no longer land (thread switched, identity changed, provider unmounted). */\n  composer_write_dropped: 'composer_write_dropped',\n  /** The repository code search request (`/api/search/repositories`) failed. */\n  repo_search_failed: 'repo_search_failed',\n  /**\n   * A session workbench read failed: the session's workspace\n   * (`/api/conversations/threads/{id}/workspace`) or a computer's status or\n   * SSH target.\n   */\n  session_workspace_failed: 'session_workspace_failed',\n  /**\n   * A computer's live desktop session\n   * (`/api/sandbox/computer/{id}/live-desktop/session`) was refused or failed.\n   */\n  live_desktop_failed: 'live_desktop_failed',\n  /**\n   * Reading an asset's stored file (`GET /api/asset/content/{id}`, e.g. a\n   * test recording's video) failed for a reason other than a refused\n   * credential (those are `auth_rejected`).\n   */\n  asset_content_failed: 'asset_content_failed',\n  /** Anything else. */\n  unknown: 'unknown',\n} as const;\n\nexport type AthenaSdkErrorCode =\n  (typeof ATHENA_SDK_ERROR_CODES)[keyof typeof ATHENA_SDK_ERROR_CODES];\n\nexport interface AthenaSdkErrorOptions {\n  code: AthenaSdkErrorCode;\n  message: string;\n  /** One line telling the integrator what to check or change. */\n  hint?: string;\n  /** HTTP-ish status when the failure came from a server. */\n  status?: number;\n  /** Structured server detail (e.g. `{ code, message }` from agora). */\n  detail?: unknown;\n  cause?: unknown;\n  /** Extra structured context safe to log (never credentials). */\n  context?: Record<string, unknown>;\n}\n\nexport class AthenaSdkError extends Error {\n  readonly code: AthenaSdkErrorCode;\n  readonly hint: string | undefined;\n  readonly status: number | undefined;\n  readonly detail: unknown;\n  readonly context: Record<string, unknown>;\n\n  constructor(options: AthenaSdkErrorOptions) {\n    super(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = 'AthenaSdkError';\n    this.code = options.code;\n    this.hint = options.hint;\n    this.status = options.status;\n    this.detail = options.detail;\n    this.context = options.context ?? {};\n  }\n\n  /** A log/console-friendly one-liner: `[code] message — hint`. */\n  describe(): string {\n    return `[${this.code}] ${this.message}${this.hint ? ` — ${this.hint}` : ''}`;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      hint: this.hint,\n      status: this.status,\n      detail: this.detail,\n      context: this.context,\n    };\n  }\n}\n\nexport function isAthenaSdkError(value: unknown): value is AthenaSdkError {\n  return value instanceof AthenaSdkError;\n}\n\n/** Wrap any thrown value as an `AthenaSdkError` (idempotent for SDK errors). */\nexport function toAthenaSdkError(\n  value: unknown,\n  fallback: Omit<AthenaSdkErrorOptions, 'cause'>,\n): AthenaSdkError {\n  if (isAthenaSdkError(value)) return value;\n  const message =\n    value instanceof Error && value.message ? value.message : fallback.message;\n  return new AthenaSdkError({ ...fallback, message, cause: value });\n}\n\n/** Structured `{ code, message }` detail from an agora rejection, if present. */\nexport function readRejectionDetail(\n  detail: unknown,\n): { code: string | null; message: string | null } {\n  if (typeof detail === 'string') return { code: null, message: detail || null };\n  if (!detail || typeof detail !== 'object') return { code: null, message: null };\n  const record = detail as { code?: unknown; message?: unknown };\n  return {\n    code: typeof record.code === 'string' ? record.code : null,\n    message: typeof record.message === 'string' ? record.message : null,\n  };\n}\n"],"names":[],"mappings":";;;AAOO,MAAM,yBAAyB;AAAA;AAAA,EAEpC,cAAc;AAAA;AAAA,EAEd,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,iBAAiB;AAAA;AAAA,EAEjB,gBAAgB;AAAA;AAAA,EAEhB,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,wBAAwB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMxB,sBAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtB,uBAAuB;AAAA;AAAA,EAEvB,oBAAoB;AAAA;AAAA,EAEpB,gBAAgB;AAAA;AAAA,EAEhB,uBAAuB;AAAA;AAAA,EAEvB,mBAAmB;AAAA;AAAA,EAEnB,mBAAmB;AAAA;AAAA,EAEnB,uBAAuB;AAAA;AAAA,EAEvB,wBAAwB;AAAA;AAAA,EAExB,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAAA,EAK1B,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMrB,sBAAsB;AAAA;AAAA,EAEtB,SAAS;AACX;AAmBO,MAAM,uBAAuB,MAAM;AAAA,EAOxC,YAAY,SAAgC;AAC1C,UAAM,QAAQ,SAAS,QAAQ,UAAU,SAAY,SAAY,EAAE,OAAO,QAAQ,MAAA,CAAO;AAPlF;AACA;AACA;AACA;AACA;AAIP,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ;AACpB,SAAK,OAAO,QAAQ;AACpB,SAAK,SAAS,QAAQ;AACtB,SAAK,SAAS,QAAQ;AACtB,SAAK,UAAU,QAAQ,WAAW,CAAA;AAAA,EACpC;AAAA;AAAA,EAGA,WAAmB;AACjB,WAAO,IAAI,KAAK,IAAI,KAAK,KAAK,OAAO,GAAG,KAAK,OAAO,MAAM,KAAK,IAAI,KAAK,EAAE;AAAA,EAC5E;AAAA,EAEA,SAAkC;AAChC,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,MAAM,KAAK;AAAA,MACX,SAAS,KAAK;AAAA,MACd,MAAM,KAAK;AAAA,MACX,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,SAAS,KAAK;AAAA,IAAA;AAAA,EAElB;AACF;AAEO,SAAS,iBAAiB,OAAyC;AACxE,SAAO,iBAAiB;AAC1B;AAGO,SAAS,iBACd,OACA,UACgB;AAChB,MAAI,iBAAiB,KAAK,EAAG,QAAO;AACpC,QAAM,UACJ,iBAAiB,SAAS,MAAM,UAAU,MAAM,UAAU,SAAS;AACrE,SAAO,IAAI,eAAe,EAAE,GAAG,UAAU,SAAS,OAAO,OAAO;AAClE;AAGO,SAAS,oBACd,QACiD;AACjD,MAAI,OAAO,WAAW,SAAU,QAAO,EAAE,MAAM,MAAM,SAAS,UAAU,KAAA;AACxE,MAAI,CAAC,UAAU,OAAO,WAAW,iBAAiB,EAAE,MAAM,MAAM,SAAS,KAAA;AACzE,QAAM,SAAS;AACf,SAAO;AAAA,IACL,MAAM,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAAA,IACtD,SAAS,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU;AAAA,EAAA;AAEnE;"}

package/dist/index.cjs

@@ -14,6 +14,7 @@ const AthenaChat = require("./chat/AthenaChat.cjs");
 const AthenaChatErrorBoundary = require("./chat/AthenaChatErrorBoundary.cjs");
 const activityTimeline = require("./chat/super-grouping/activity-timeline.cjs");
 const CollapsibleGroup = require("./chat/super-grouping/CollapsibleGroup.cjs");
+const GroupedMessageParts = require("./chat/super-grouping/GroupedMessageParts.cjs");
 const groupingFunction = require("./chat/super-grouping/grouping-function.cjs");
 const SuperGroupingCard = require("./chat/super-grouping/SuperGroupingCard.cjs");
 const SuperGroupingTranscript = require("./chat/super-grouping/SuperGroupingTranscript.cjs");
@@ -50,6 +51,9 @@ const fileToolUis = require("./tools/file-tool-uis.cjs");
 const toolSummary = require("./tools/tool-summary.cjs");
 const toolFallback = require("./tools/tool-fallback.cjs");
 const voiceUpdateToolUi = require("./tools/voice-update-tool-ui.cjs");
+const testRecordingToolUis = require("./tools/test-recording-tool-uis.cjs");
+const testRecordingReport = require("./tools/test-recording-report.cjs");
+const inlineTools = require("./tools/inline-tools.cjs");
 const voiceDelegationCard = require("./chat-ui/messages/voice-delegation-card.cjs");
 const NestedPtcMessages = require("./tools/NestedPtcMessages.cjs");
 const readAssetToolUi = require("./tools/read-asset-tool-ui.cjs");
@@ -57,6 +61,7 @@ const autoOpenTools = require("./tools/auto-open-tools.cjs");
 const appendDocumentToolUi = require("./tools/append-document-tool-ui.cjs");
 const assetUtils = require("./tools/asset-utils.cjs");
 const AthenaAssetEmbed = require("./assets/AthenaAssetEmbed.cjs");
+const useAssetContent = require("./assets/use-asset-content.cjs");
 const AssetPanel = require("./assets/AssetPanel.cjs");
 const AthenaLayout = require("./assets/AthenaLayout.cjs");
 const assetPanelStore = require("./assets/asset-panel-store.cjs");
@@ -66,6 +71,9 @@ const sessionWorkbenchPanes = require("./workbench/session-workbench-panes.cjs")
 const sessionWorkbenchModel = require("./workbench/session-workbench-model.cjs");
 const sessionWorkspaceApi = require("./workbench/session-workspace-api.cjs");
 const useSessionWorkspace = require("./workbench/use-session-workspace.cjs");
+const ComputerLiveDesktop = require("./workbench/ComputerLiveDesktop.cjs");
+const liveDesktopApi = require("./workbench/live-desktop-api.cjs");
+const statewireHistoryContext = require("./provider/statewire-history-context.cjs");
 const useAssetEmbed = require("./assets/use-asset-embed.cjs");
 const AthenaContext = require("./provider/AthenaContext.cjs");
 const ThreadList = require("./threads/ThreadList.cjs");
@@ -174,6 +182,7 @@ exports.CollapsibleGroup = CollapsibleGroup.CollapsibleGroup;
 exports.DEFAULT_TOOLKIT_THEME = CollapsibleGroup.DEFAULT_TOOLKIT_THEME;
 exports.SuperGroupingProvider = CollapsibleGroup.SuperGroupingProvider;
 exports.TOOLKIT_THEMES = CollapsibleGroup.TOOLKIT_THEMES;
+exports.GroupedMessageParts = GroupedMessageParts.GroupedMessageParts;
 exports.createToolBasedGroupingFunction = groupingFunction.createToolBasedGroupingFunction;
 exports.SuperGroupingCard = SuperGroupingCard.SuperGroupingCard;
 exports.SuperGroupingFinalText = SuperGroupingCard.SuperGroupingFinalText;
@@ -269,6 +278,19 @@ exports.ToolFallbackTrigger = toolFallback.ToolFallbackTrigger;
 exports.clearAutoOpenedAssets = toolFallback.clearAutoOpenedAssets;
 exports.VoiceUpdateCard = voiceUpdateToolUi.VoiceUpdateCard;
 exports.VoiceUpdateToolUI = voiceUpdateToolUi.VoiceUpdateToolUI;
+exports.TestRecordingMarkToolUI = testRecordingToolUis.TestRecordingMarkToolUI;
+exports.TestRecordingReportCard = testRecordingToolUis.TestRecordingReportCard;
+exports.TestRecordingStartToolUI = testRecordingToolUis.TestRecordingStartToolUI;
+exports.TestRecordingStopToolUI = testRecordingToolUis.TestRecordingStopToolUI;
+exports.TEST_RECORDING_MARK_TOOL = testRecordingReport.TEST_RECORDING_MARK_TOOL;
+exports.TEST_RECORDING_START_TOOL = testRecordingReport.TEST_RECORDING_START_TOOL;
+exports.TEST_RECORDING_STOP_TOOL = testRecordingReport.TEST_RECORDING_STOP_TOOL;
+exports.describeTestRecordingMark = testRecordingReport.describeTestRecordingMark;
+exports.describeTestRecordingStart = testRecordingReport.describeTestRecordingStart;
+exports.formatRecordingClock = testRecordingReport.formatRecordingClock;
+exports.formatTestRecordingCounts = testRecordingReport.formatTestRecordingCounts;
+exports.parseTestRecordingStopResult = testRecordingReport.parseTestRecordingStopResult;
+exports.isSdkInlineTool = inlineTools.isSdkInlineTool;
 exports.VoiceDelegationCard = voiceDelegationCard.VoiceDelegationCard;
 exports.VoiceDelegationMessage = voiceDelegationCard.VoiceDelegationMessage;
 exports.NestedPtcComponentsProvider = NestedPtcMessages.NestedPtcComponentsProvider;
@@ -280,6 +302,10 @@ exports.AppendDocumentToolUI = appendDocumentToolUi.AppendDocumentToolUI;
 exports.getAssetInfo = assetUtils.getAssetInfo;
 exports.tryParseJson = assetUtils.tryParseJson;
 exports.AthenaAssetEmbed = AthenaAssetEmbed.AthenaAssetEmbed;
+exports.athenaAssetContentPath = useAssetContent.athenaAssetContentPath;
+exports.fetchAthenaAssetContent = useAssetContent.fetchAthenaAssetContent;
+exports.useAthenaAssetContent = useAssetContent.useAthenaAssetContent;
+exports.useObjectUrl = useAssetContent.useObjectUrl;
 exports.AssetPanel = AssetPanel.AssetPanel;
 exports.AthenaLayout = AthenaLayout.AthenaLayout;
 exports.useAssetPanelStore = assetPanelStore.useAssetPanelStore;
@@ -327,6 +353,17 @@ exports.sessionWorkspacePath = sessionWorkspaceApi.sessionWorkspacePath;
 exports.useAthenaComputerSshAccess = useSessionWorkspace.useAthenaComputerSshAccess;
 exports.useAthenaComputerStatus = useSessionWorkspace.useAthenaComputerStatus;
 exports.useAthenaSessionWorkspace = useSessionWorkspace.useAthenaSessionWorkspace;
+exports.ComputerLiveDesktop = ComputerLiveDesktop.ComputerLiveDesktop;
+exports.LIVE_DESKTOP_READY_TIMEOUT_MS = ComputerLiveDesktop.LIVE_DESKTOP_READY_TIMEOUT_MS;
+exports.LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE = liveDesktopApi.LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE;
+exports.LiveDesktopMode = liveDesktopApi.LiveDesktopMode;
+exports.computerLiveDesktopSessionPath = liveDesktopApi.computerLiveDesktopSessionPath;
+exports.createComputerLiveDesktopSession = liveDesktopApi.createComputerLiveDesktopSession;
+exports.finalLiveDesktopCloseNotice = liveDesktopApi.finalLiveDesktopCloseNotice;
+exports.liveDesktopViewerUrl = liveDesktopApi.liveDesktopViewerUrl;
+exports.readLiveDesktopSession = liveDesktopApi.readLiveDesktopSession;
+exports.readLiveDesktopViewerMessage = liveDesktopApi.readLiveDesktopViewerMessage;
+exports.useStatewireHistory = statewireHistoryContext.useStatewireHistory;
 exports.appendCitationReferenceParams = useAssetEmbed.appendCitationReferenceParams;
 exports.useAssetEmbed = useAssetEmbed.useAssetEmbed;
 exports.useAthenaConfig = AthenaContext.useAthenaConfig;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.ts

@@ -20,7 +20,7 @@ export { AthenaAssistantActionBar, AthenaAssistantMessage, AthenaChat, AthenaRea
 export type { AthenaAssistantActionBarProps, AthenaAssistantMessageProps, AthenaChatComponents, AthenaChatMessagePartComponents, AthenaChatProps, AthenaReasoningPartProps, AthenaUserMessageProps, } from './chat/AthenaChat';
 export type { WelcomeSuggestion } from './chat/athena-chat-welcome';
 export { AthenaChatErrorBoundary } from './chat/AthenaChatErrorBoundary';
-export { type ActivityItem, type ActivityPhase, type ActivityTimelineOptions, type ActivityToolState, buildActivityTimeline, CollapsibleGroup, type CollapsibleGroupProps, countActivityTools, createToolBasedGroupingFunction, DEFAULT_TOOLKIT_THEME, defaultGetToolGroupKey, excludeFinalTextFromGroups, excludePartsFromGroups, type FinalTextPart, type FinalTextSegment, formatWorkDuration, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, type GetToolGroupKey, type GroupablePart, type GroupingFunction, type MessagePartGroup, readTurnTiming, resetRememberedExpansionsForTests, resolveActivityPhase, splitTurnSegments, SuperGroupingCard, type SuperGroupingCardProps, SuperGroupingFinalText, SuperGroupingProvider, SuperGroupingTranscript, type SuperGroupingTranscriptProps, TOOLKIT_THEMES, type ToolGroupKeyOptions, type ToolkitTheme, type TurnSegment, type TurnTiming, useActivityExpansion, workedDurationMs, } from './chat/super-grouping';
+export { type ActivityItem, type ActivityPhase, type ActivityTimelineOptions, type ActivityToolState, buildActivityTimeline, CollapsibleGroup, type CollapsibleGroupProps, countActivityTools, createToolBasedGroupingFunction, DEFAULT_TOOLKIT_THEME, defaultGetToolGroupKey, excludeFinalTextFromGroups, excludePartsFromGroups, type FinalTextPart, type FinalTextSegment, formatWorkDuration, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, type GetToolGroupKey, type GroupablePart, GroupedMessageParts, type GroupedMessagePartsProps, type GroupingFunction, type MessagePartGroup, readTurnTiming, resetRememberedExpansionsForTests, resolveActivityPhase, splitTurnSegments, SuperGroupingCard, type SuperGroupingCardProps, SuperGroupingFinalText, SuperGroupingProvider, SuperGroupingTranscript, type SuperGroupingTranscriptProps, TOOLKIT_THEMES, type ToolGroupKeyOptions, type ToolkitTheme, type TurnSegment, type TurnTiming, useActivityExpansion, workedDurationMs, } from './chat/super-grouping';
 export { StatewireApprovalCard } from './chat/StatewireApprovalCard';
 export type { StatewireApprovalCardProps, StatewireApprovalEditorContext, StatewireApprovalRequestContext, } from './chat/StatewireApprovalCard';
 export { useStatewireApprovalRequest } from './chat/use-statewire-approval-request';
@@ -76,6 +76,11 @@ export { ToolFallback, ToolFallbackAppearanceProvider, ToolFallbackRoot, ToolFal
 export type { ToolAppearance, ToolFallbackContext, ToolFallbackOptions, ToolFallbackProps, ToolFallbackRootProps, ToolFallbackTriggerProps, } from './tools/tool-fallback';
 export { VoiceUpdateCard, VoiceUpdateToolUI } from './tools/voice-update-tool-ui';
 export type { VoiceUpdateCardProps } from './tools/voice-update-tool-ui';
+export { TestRecordingMarkToolUI, TestRecordingReportCard, TestRecordingStartToolUI, TestRecordingStopToolUI, } from './tools/test-recording-tool-uis';
+export type { TestRecordingReportCardProps } from './tools/test-recording-tool-uis';
+export { describeTestRecordingMark, describeTestRecordingStart, formatRecordingClock, formatTestRecordingCounts, parseTestRecordingStopResult, TEST_RECORDING_MARK_TOOL, TEST_RECORDING_START_TOOL, TEST_RECORDING_STOP_TOOL, } from './tools/test-recording-report';
+export type { TestRecordingAssertion, TestRecordingMark, TestRecordingMarkKind, TestRecordingOutcome, TestRecordingReport, TestRecordingStart, TestRecordingStopResult, TestRecordingTest, } from './tools/test-recording-report';
+export { isSdkInlineTool } from './tools/inline-tools';
 export { VoiceDelegationCard, VoiceDelegationMessage, } from './chat-ui/messages/voice-delegation-card';
 export type { VoiceDelegationCardProps } from './chat-ui/messages/voice-delegation-card';
 export { NestedPtcComponentsProvider, NestedPtcMessages, useNestedPtcComponents, } from './tools/NestedPtcMessages';
@@ -85,6 +90,8 @@ export { DEFAULT_AUTO_OPEN_TOOLS } from './tools/auto-open-tools';
 export { AppendDocumentToolUI } from './tools/append-document-tool-ui';
 export { getAssetInfo, tryParseJson } from './tools/asset-utils';
 export { AthenaAssetEmbed } from './assets/AthenaAssetEmbed';
+export { athenaAssetContentPath, fetchAthenaAssetContent, useAthenaAssetContent, useObjectUrl, } from './assets/use-asset-content';
+export type { UseAthenaAssetContentOptions } from './assets/use-asset-content';
 export type { AthenaAssetEmbedProps } from './assets/AthenaAssetEmbed';
 export type { AthenaAssetCitationAction, AthenaAssetCitationActionEvent, AthenaAssetCitationBehavior, AthenaAssetCitationClickEvent, AthenaAssetCitationReference, } from './assets/asset-embed-messages';
 export { AssetPanel } from './assets/AssetPanel';
@@ -104,6 +111,12 @@ export { computerSshAccessPath, computerStatusPath, fetchComputerRuntimeStatus,
 export type { ComputerRuntimeStatus, ComputerSshAccess, SessionWorkspace, SessionWorkspaceAsset, SessionWorkspaceRole, } from './workbench/session-workspace-api';
 export { useAthenaComputerSshAccess, useAthenaComputerStatus, useAthenaSessionWorkspace, } from './workbench/use-session-workspace';
 export type { UseAthenaSessionWorkspaceOptions } from './workbench/use-session-workspace';
+export { ComputerLiveDesktop, LIVE_DESKTOP_READY_TIMEOUT_MS, } from './workbench/ComputerLiveDesktop';
+export type { ComputerLiveDesktopProps } from './workbench/ComputerLiveDesktop';
+export { computerLiveDesktopSessionPath, createComputerLiveDesktopSession, finalLiveDesktopCloseNotice, LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE, LiveDesktopMode, liveDesktopViewerUrl, readLiveDesktopSession, readLiveDesktopViewerMessage, } from './workbench/live-desktop-api';
+export type { LiveDesktopSession, LiveDesktopViewerMessage, } from './workbench/live-desktop-api';
+export { useStatewireHistory } from './provider/statewire-history-context';
+export type { StatewireHistoryState } from './provider/statewire-history-context';
 export { appendCitationReferenceParams, useAssetEmbed } from './assets/use-asset-embed';
 export type { UseAssetEmbedOptions, UseAssetEmbedResult } from './assets/use-asset-embed';
 export { useAthenaConfig } from './provider/AthenaContext';

package/dist/index.js

@@ -12,6 +12,7 @@ import { AthenaAssistantActionBar, AthenaAssistantMessage, AthenaChat, AthenaRea
 import { AthenaChatErrorBoundary } from "./chat/AthenaChatErrorBoundary.js";
 import { buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, excludePartsFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, resolveActivityPhase } from "./chat/super-grouping/activity-timeline.js";
 import { CollapsibleGroup, DEFAULT_TOOLKIT_THEME, SuperGroupingProvider, TOOLKIT_THEMES } from "./chat/super-grouping/CollapsibleGroup.js";
+import { GroupedMessageParts } from "./chat/super-grouping/GroupedMessageParts.js";
 import { createToolBasedGroupingFunction } from "./chat/super-grouping/grouping-function.js";
 import { SuperGroupingCard, SuperGroupingFinalText, resetRememberedExpansionsForTests, useActivityExpansion } from "./chat/super-grouping/SuperGroupingCard.js";
 import { SuperGroupingTranscript } from "./chat/super-grouping/SuperGroupingTranscript.js";
@@ -48,6 +49,9 @@ import { EditFileToolUI, ListFilesToolUI, ReadFileToolUI, SearchFilesToolUI, Wri
 import { collectAssetTitles, friendlyWorkspacePath, humanizeToolName, summarizeToolCall } from "./tools/tool-summary.js";
 import { ToolFallback, ToolFallbackAppearanceProvider, ToolFallbackArgs, ToolFallbackContent, ToolFallbackError, ToolFallbackNotice, ToolFallbackResult, ToolFallbackRoot, ToolFallbackTrigger, clearAutoOpenedAssets } from "./tools/tool-fallback.js";
 import { VoiceUpdateCard, VoiceUpdateToolUI } from "./tools/voice-update-tool-ui.js";
+import { TestRecordingMarkToolUI, TestRecordingReportCard, TestRecordingStartToolUI, TestRecordingStopToolUI } from "./tools/test-recording-tool-uis.js";
+import { TEST_RECORDING_MARK_TOOL, TEST_RECORDING_START_TOOL, TEST_RECORDING_STOP_TOOL, describeTestRecordingMark, describeTestRecordingStart, formatRecordingClock, formatTestRecordingCounts, parseTestRecordingStopResult } from "./tools/test-recording-report.js";
+import { isSdkInlineTool } from "./tools/inline-tools.js";
 import { VoiceDelegationCard, VoiceDelegationMessage } from "./chat-ui/messages/voice-delegation-card.js";
 import { NestedPtcComponentsProvider, NestedPtcMessages, useNestedPtcComponents } from "./tools/NestedPtcMessages.js";
 import { ReadAssetToolUI } from "./tools/read-asset-tool-ui.js";
@@ -55,6 +59,7 @@ import { DEFAULT_AUTO_OPEN_TOOLS } from "./tools/auto-open-tools.js";
 import { AppendDocumentToolUI } from "./tools/append-document-tool-ui.js";
 import { getAssetInfo, tryParseJson } from "./tools/asset-utils.js";
 import { AthenaAssetEmbed } from "./assets/AthenaAssetEmbed.js";
+import { athenaAssetContentPath, fetchAthenaAssetContent, useAthenaAssetContent, useObjectUrl } from "./assets/use-asset-content.js";
 import { AssetPanel } from "./assets/AssetPanel.js";
 import { AthenaLayout } from "./assets/AthenaLayout.js";
 import { useAssetPanelStore } from "./assets/asset-panel-store.js";
@@ -64,6 +69,9 @@ import { DEFAULT_SESSION_WORKBENCH_OPEN_PANE_IDS, DEFAULT_SESSION_WORKBENCH_PANE
 import { SESSION_SANDBOX_LABEL, SHELL_OUTPUT_PREVIEW_CHARS, assetPanelTypeOf, assetTypeLabel, athenaLinkAppUrl, computerStateBadge, deriveShellRows, deriveTaskSteps, filterShellRows, filterWorkbenchPanes, reviewDecisionLabel, shellMachine, taskProgress, toolResultText, workspaceComputers } from "./workbench/session-workbench-model.js";
 import { computerSshAccessPath, computerStatusPath, fetchComputerRuntimeStatus, fetchComputerSshAccess, fetchSessionWorkspace, readComputerRuntimeStatus, readComputerSshAccess, readSessionWorkspace, sessionWorkspacePath } from "./workbench/session-workspace-api.js";
 import { useAthenaComputerSshAccess, useAthenaComputerStatus, useAthenaSessionWorkspace } from "./workbench/use-session-workspace.js";
+import { ComputerLiveDesktop, LIVE_DESKTOP_READY_TIMEOUT_MS } from "./workbench/ComputerLiveDesktop.js";
+import { LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE, LiveDesktopMode, computerLiveDesktopSessionPath, createComputerLiveDesktopSession, finalLiveDesktopCloseNotice, liveDesktopViewerUrl, readLiveDesktopSession, readLiveDesktopViewerMessage } from "./workbench/live-desktop-api.js";
+import { useStatewireHistory } from "./provider/statewire-history-context.js";
 import { appendCitationReferenceParams, useAssetEmbed } from "./assets/use-asset-embed.js";
 import { useAthenaConfig } from "./provider/AthenaContext.js";
 import { ThreadList } from "./threads/ThreadList.js";
@@ -156,6 +164,7 @@ export {
   CollapsibleTrigger,
   ComposerDropZone,
   ComposerQuotePreview,
+  ComputerLiveDesktop,
   CopyToolSpecButton,
   CreateDocumentToolUI,
   CreateEmailDraftToolUI,
@@ -180,6 +189,7 @@ export {
   ExpandableSection,
   FileUploadButton,
   GetDatabaseTableSchemaToolUI,
+  GroupedMessageParts,
   HITL_PENDING_RESUME_GRACE_MS,
   HiddenWriteTodosToolUI,
   INBOX_PAGE_SIZE,
@@ -188,8 +198,11 @@ export {
   Inbox,
   InboxButton,
   InstallPackageToolUI,
+  LIVE_DESKTOP_READY_TIMEOUT_MS,
+  LIVE_DESKTOP_VIEWER_MESSAGE_SOURCE,
   ListDatabaseTablesToolUI,
   ListFilesToolUI,
+  LiveDesktopMode,
   MODEL_PROVIDER_LABELS,
   NestedPtcComponentsProvider,
   NestedPtcMessages,
@@ -240,12 +253,19 @@ export {
   SuperGroupingFinalText,
   SuperGroupingProvider,
   SuperGroupingTranscript,
+  TEST_RECORDING_MARK_TOOL,
+  TEST_RECORDING_START_TOOL,
+  TEST_RECORDING_STOP_TOOL,
   THREAD_PREFETCH_HOVER_DELAY_MS,
   THREAD_PREFETCH_MAX_CONCURRENT,
   THREAD_TITLE_MAX_LENGTH,
   TOOLKIT_THEMES,
   TOOL_ICONS,
   TOOL_UI_REGISTRY,
+  TestRecordingMarkToolUI,
+  TestRecordingReportCard,
+  TestRecordingStartToolUI,
+  TestRecordingStopToolUI,
   ThreadList,
   ThreadLoadingOverlay,
   TiptapText,
@@ -286,6 +306,7 @@ export {
   asHitlApproval,
   assetPanelTypeOf,
   assetTypeLabel,
+  athenaAssetContentPath,
   athenaDiagnostics,
   athenaLinkAppUrl,
   athenaStatewireErrorNotice,
@@ -304,6 +325,7 @@ export {
   columnLettersToNumber,
   columnNumberToLetters,
   composeDictationDraft,
+  computerLiveDesktopSessionPath,
   computerSshAccessPath,
   computerStateBadge,
   computerStatusPath,
@@ -313,6 +335,7 @@ export {
   createAssetToolUI,
   createAthenaSpacesUrl,
   createAttachmentStore,
+  createComputerLiveDesktopSession,
   createQuoteStore,
   createRecordedDictationEngine,
   createThread,
@@ -327,18 +350,24 @@ export {
   deriveShellRows,
   deriveStatewireSyncUrl,
   deriveTaskSteps,
+  describeTestRecordingMark,
+  describeTestRecordingStart,
   describeToolArgs,
   dismissThreadFromInbox,
   excludeFinalTextFromGroups,
   excludePartsFromGroups,
+  fetchAthenaAssetContent,
   fetchComputerRuntimeStatus,
   fetchComputerSshAccess,
   fetchRepoSearch,
   fetchSessionWorkspace,
   filterShellRows,
   filterWorkbenchPanes,
+  finalLiveDesktopCloseNotice,
   formatA1Cell,
   formatA1Range,
+  formatRecordingClock,
+  formatTestRecordingCounts,
   formatToolName,
   formatWorkDuration,
   friendlyWorkspacePath,
@@ -367,11 +396,13 @@ export {
   isCriticalPosthogEvent,
   isGithubWakeMessage,
   isPendingInterrupt,
+  isSdkInlineTool,
   isThreadArchiveUnavailableError,
   isThreadFavoriteUnavailableError,
   isThreadRenameUnavailableError,
   isToolResultSuccess,
   listThreads,
+  liveDesktopViewerUrl,
   matchesSessionsQuery,
   mintThreadId,
   normalizeAgentCatalog,
@@ -382,6 +413,7 @@ export {
   parseA1Range,
   parseAthenaCitationLink,
   parseCollabAgentRef,
+  parseTestRecordingStopResult,
   parseTodoPlan,
   planSessionsQuery,
   pullRequestChip,
@@ -393,6 +425,8 @@ export {
   readComputerSshAccess,
   readGithubWakeEvent,
   readInterruptMessage,
+  readLiveDesktopSession,
+  readLiveDesktopViewerMessage,
   readRejectionDetail,
   readRunStartRefusal,
   readSessionWorkspace,
@@ -443,6 +477,7 @@ export {
   useAssetPanelStore,
   useAthenaAgentCatalog,
   useAthenaAgentModelOptions,
+  useAthenaAssetContent,
   useAthenaChatMode,
   useAthenaCitationLinkHandler,
   useAthenaComputerSshAccess,
@@ -474,6 +509,7 @@ export {
   useIsInPopoutDocument,
   useLatestTodoPlan,
   useNestedPtcComponents,
+  useObjectUrl,
   useOwnerDocument,
   useParentAuth,
   useParentBridge,
@@ -487,6 +523,7 @@ export {
   useSessionWorkbenchWorkspace,
   useStatewireApprovalRequest,
   useStatewireConversationHistory,
+  useStatewireHistory,
   useStatewireToolOutputs,
   useToolAppearance,
   withCaptureGateBypass,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/provider/AthenaProvider.cjs

@@ -17,6 +17,7 @@ const statewireThreadConfigLane = require("../runtime/statewire-thread-config-la
 const mintThreadId = require("../threads/mint-thread-id.cjs");
 const statewireLifecycleContext = require("./statewire-lifecycle-context.cjs");
 const composerHandoff = require("../composer/composer-handoff.cjs");
+const statewireHistoryContext = require("./statewire-history-context.cjs");
 const statewireWindowContext = require("./statewire-window-context.cjs");
 const StatewireClientToolBridge = require("../chat/StatewireClientToolBridge.cjs");
 const StatewireThreadConfigLaneSync = require("../runtime/StatewireThreadConfigLaneSync.cjs");
@@ -306,7 +307,7 @@ function AthenaStatewireStandalone({
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [modeKey, modeScope, modePicks, sessionChannels, published, setModePick, setSessionChannel]
   );
-  const scope = published && /* @__PURE__ */ jsxRuntime.jsx(react$1.AuiProvider, { value: published.client, children: /* @__PURE__ */ jsxRuntime.jsx(AthenaContext.AthenaContext.Provider, { value: athenaConfig, children: /* @__PURE__ */ jsxRuntime.jsx(threadIdContext.AthenaStatewireThreadIdContext.Provider, { value: published.threadId, children: /* @__PURE__ */ jsxRuntime.jsx(statewireLifecycleContext.AthenaStatewireLifecycleContext.Provider, { value: published.lifecycle, children: /* @__PURE__ */ jsxRuntime.jsx(threadStatus.DeepAgentConnectionContext.Provider, { value: published.lifecycle.connection, children: /* @__PURE__ */ jsxRuntime.jsx(statewireServerLaneContext.AthenaStatewireServerLaneContext.Provider, { value: published.serverLane, children: /* @__PURE__ */ jsxRuntime.jsx(statewireWindowContext.StatewireToolOutputsContext.Provider, { value: runtimeProps.toolOutputs, children: /* @__PURE__ */ jsxRuntime.jsxs(tooltip.TooltipProvider, { children: [
+  const scope = published && /* @__PURE__ */ jsxRuntime.jsx(react$1.AuiProvider, { value: published.client, children: /* @__PURE__ */ jsxRuntime.jsx(AthenaContext.AthenaContext.Provider, { value: athenaConfig, children: /* @__PURE__ */ jsxRuntime.jsx(threadIdContext.AthenaStatewireThreadIdContext.Provider, { value: published.threadId, children: /* @__PURE__ */ jsxRuntime.jsx(statewireLifecycleContext.AthenaStatewireLifecycleContext.Provider, { value: published.lifecycle, children: /* @__PURE__ */ jsxRuntime.jsx(threadStatus.DeepAgentConnectionContext.Provider, { value: published.lifecycle.connection, children: /* @__PURE__ */ jsxRuntime.jsx(statewireServerLaneContext.AthenaStatewireServerLaneContext.Provider, { value: published.serverLane, children: /* @__PURE__ */ jsxRuntime.jsx(statewireWindowContext.StatewireToolOutputsContext.Provider, { value: runtimeProps.toolOutputs, children: /* @__PURE__ */ jsxRuntime.jsx(statewireHistoryContext.StatewireHistoryContext.Provider, { value: runtimeProps.historyStore, children: /* @__PURE__ */ jsxRuntime.jsxs(tooltip.TooltipProvider, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(StatewireClientToolBridge.StatewireClientToolBridge, { tools: clientTools, threadId: published.threadId }),
     /* @__PURE__ */ jsxRuntime.jsx(
       StatewireThreadConfigLaneSync.StatewireThreadConfigLaneSync,
@@ -320,7 +321,7 @@ function AthenaStatewireStandalone({
     ),
     /* @__PURE__ */ jsxRuntime.jsx(ComposerHandoffDrain, {}),
     /* @__PURE__ */ jsxRuntime.jsx(chatModeContext.AthenaChatModeSelectionContext.Provider, { value: chatModeSelection, children })
-  ] }) }) }) }) }) }) }) });
+  ] }) }) }) }) }) }) }) }) });
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(
       AthenaStatewireRuntimeMount,
@@ -527,6 +528,7 @@ function AthenaProvider({
   const [snapshotCache] = react.useState(() => threadSnapshotCache.createDeepAgentThreadSnapshotCache());
   const [composerHandoff$1] = react.useState(composerHandoff.createComposerHandoffStore);
   const [toolOutputs$1] = react.useState(() => toolOutputs.createDeepAgentToolOutputStore());
+  const [historyStore] = react.useState(statewireHistoryContext.createStatewireHistoryStore);
   const principal = ((_a = authContext == null ? void 0 : authContext.user) == null ? void 0 : _a.userId) ?? "";
   react.useEffect(() => {
     snapshotCache.clear();
@@ -595,6 +597,7 @@ function AthenaProvider({
     extraRunConfig: configuredExtraRunConfig,
     snapshotCache,
     toolOutputs: toolOutputs$1,
+    historyStore,
     linkClicks,
     citationLinks
   };