@athenaintel/react 0.39.0 → 0.40.1

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  /**\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  /** 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,EAErB,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");
@@ -177,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;
@@ -272,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;
@@ -283,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;

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';

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";
@@ -184,6 +189,7 @@ export {
   ExpandableSection,
   FileUploadButton,
   GetDatabaseTableSchemaToolUI,
+  GroupedMessageParts,
   HITL_PENDING_RESUME_GRACE_MS,
   HiddenWriteTodosToolUI,
   INBOX_PAGE_SIZE,
@@ -247,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,
@@ -293,6 +306,7 @@ export {
   asHitlApproval,
   assetPanelTypeOf,
   assetTypeLabel,
+  athenaAssetContentPath,
   athenaDiagnostics,
   athenaLinkAppUrl,
   athenaStatewireErrorNotice,
@@ -336,10 +350,13 @@ export {
   deriveShellRows,
   deriveStatewireSyncUrl,
   deriveTaskSteps,
+  describeTestRecordingMark,
+  describeTestRecordingStart,
   describeToolArgs,
   dismissThreadFromInbox,
   excludeFinalTextFromGroups,
   excludePartsFromGroups,
+  fetchAthenaAssetContent,
   fetchComputerRuntimeStatus,
   fetchComputerSshAccess,
   fetchRepoSearch,
@@ -349,6 +366,8 @@ export {
   finalLiveDesktopCloseNotice,
   formatA1Cell,
   formatA1Range,
+  formatRecordingClock,
+  formatTestRecordingCounts,
   formatToolName,
   formatWorkDuration,
   friendlyWorkspacePath,
@@ -377,6 +396,7 @@ export {
   isCriticalPosthogEvent,
   isGithubWakeMessage,
   isPendingInterrupt,
+  isSdkInlineTool,
   isThreadArchiveUnavailableError,
   isThreadFavoriteUnavailableError,
   isThreadRenameUnavailableError,
@@ -393,6 +413,7 @@ export {
   parseA1Range,
   parseAthenaCitationLink,
   parseCollabAgentRef,
+  parseTestRecordingStopResult,
   parseTodoPlan,
   planSessionsQuery,
   pullRequestChip,
@@ -456,6 +477,7 @@ export {
   useAssetPanelStore,
   useAthenaAgentCatalog,
   useAthenaAgentModelOptions,
+  useAthenaAssetContent,
   useAthenaChatMode,
   useAthenaCitationLinkHandler,
   useAthenaComputerSshAccess,
@@ -487,6 +509,7 @@ export {
   useIsInPopoutDocument,
   useLatestTodoPlan,
   useNestedPtcComponents,
+  useObjectUrl,
   useOwnerDocument,
   useParentAuth,
   useParentBridge,

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/lib/use-document-active.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+function isActive(doc) {
+  if (!doc) return false;
+  return doc.visibilityState === "visible" && doc.hasFocus();
+}
+function getServerSnapshot() {
+  return false;
+}
+function subscribeTo(doc, onChange) {
+  const view = doc == null ? void 0 : doc.defaultView;
+  if (!doc || !view) return () => {
+  };
+  let afterBlur = null;
+  const onBlur = () => {
+    onChange();
+    if (afterBlur !== null) clearTimeout(afterBlur);
+    afterBlur = setTimeout(() => {
+      afterBlur = null;
+      onChange();
+    }, 0);
+  };
+  view.addEventListener("focus", onChange);
+  view.addEventListener("blur", onBlur);
+  doc.addEventListener("visibilitychange", onChange);
+  return () => {
+    view.removeEventListener("focus", onChange);
+    view.removeEventListener("blur", onBlur);
+    doc.removeEventListener("visibilitychange", onChange);
+    if (afterBlur !== null) clearTimeout(afterBlur);
+  };
+}
+function useDocumentActive(doc) {
+  const subscribe = react.useCallback((onChange) => subscribeTo(doc, onChange), [doc]);
+  const getSnapshot = react.useCallback(() => isActive(doc), [doc]);
+  return react.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+exports.useDocumentActive = useDocumentActive;
+//# sourceMappingURL=use-document-active.cjs.map

package/dist/lib/use-document-active.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-document-active.cjs","sources":["../../src/lib/use-document-active.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\n\nfunction isActive(doc: Document | null): boolean {\n  if (!doc) return false;\n  return doc.visibilityState === 'visible' && doc.hasFocus();\n}\n\nfunction getServerSnapshot(): boolean {\n  return false;\n}\n\nfunction subscribeTo(doc: Document | null, onChange: () => void): () => void {\n  const view = doc?.defaultView;\n  if (!doc || !view) return () => {};\n  let afterBlur: ReturnType<typeof setTimeout> | null = null;\n  // `blur` fires before focus has landed. Focus that moved into a frame of\n  // this page (a computer's live desktop, an embedded asset) leaves the\n  // document focused, so it is read again once the browser has moved it.\n  const onBlur = () => {\n    onChange();\n    if (afterBlur !== null) clearTimeout(afterBlur);\n    afterBlur = setTimeout(() => {\n      afterBlur = null;\n      onChange();\n    }, 0);\n  };\n  view.addEventListener('focus', onChange);\n  view.addEventListener('blur', onBlur);\n  doc.addEventListener('visibilitychange', onChange);\n  return () => {\n    view.removeEventListener('focus', onChange);\n    view.removeEventListener('blur', onBlur);\n    doc.removeEventListener('visibilitychange', onChange);\n    if (afterBlur !== null) clearTimeout(afterBlur);\n  };\n}\n\n/**\n * Whether `doc` is in front of the person: visible and focused\n * (`hasFocus()`, which stays true while focus is inside a frame of the page).\n * Pass the document a subtree renders into (`useOwnerDocument()`), so a pane\n * popped out into another window reads that window. Re-read on its window's\n * `focus` / `blur` and its `visibilitychange`; nothing polls. `false` on the\n * server and without a document.\n */\nexport function useDocumentActive(doc: Document | null): boolean {\n  const subscribe = useCallback((onChange: () => void) => subscribeTo(doc, onChange), [doc]);\n  const getSnapshot = useCallback(() => isActive(doc), [doc]);\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n"],"names":["useCallback","useSyncExternalStore"],"mappings":";;;AAEA,SAAS,SAAS,KAA+B;AAC/C,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,oBAAoB,aAAa,IAAI,SAAA;AAClD;AAEA,SAAS,oBAA6B;AACpC,SAAO;AACT;AAEA,SAAS,YAAY,KAAsB,UAAkC;AAC3E,QAAM,OAAO,2BAAK;AAClB,MAAI,CAAC,OAAO,CAAC,aAAa,MAAM;AAAA,EAAC;AACjC,MAAI,YAAkD;AAItD,QAAM,SAAS,MAAM;AACnB,aAAA;AACA,QAAI,cAAc,KAAM,cAAa,SAAS;AAC9C,gBAAY,WAAW,MAAM;AAC3B,kBAAY;AACZ,eAAA;AAAA,IACF,GAAG,CAAC;AAAA,EACN;AACA,OAAK,iBAAiB,SAAS,QAAQ;AACvC,OAAK,iBAAiB,QAAQ,MAAM;AACpC,MAAI,iBAAiB,oBAAoB,QAAQ;AACjD,SAAO,MAAM;AACX,SAAK,oBAAoB,SAAS,QAAQ;AAC1C,SAAK,oBAAoB,QAAQ,MAAM;AACvC,QAAI,oBAAoB,oBAAoB,QAAQ;AACpD,QAAI,cAAc,KAAM,cAAa,SAAS;AAAA,EAChD;AACF;AAUO,SAAS,kBAAkB,KAA+B;AAC/D,QAAM,YAAYA,kBAAY,CAAC,aAAyB,YAAY,KAAK,QAAQ,GAAG,CAAC,GAAG,CAAC;AACzF,QAAM,cAAcA,MAAAA,YAAY,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC;AAC1D,SAAOC,2BAAqB,WAAW,aAAa,iBAAiB;AACvE;;"}

package/dist/lib/use-document-active.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Whether `doc` is in front of the person: visible and focused
+ * (`hasFocus()`, which stays true while focus is inside a frame of the page).
+ * Pass the document a subtree renders into (`useOwnerDocument()`), so a pane
+ * popped out into another window reads that window. Re-read on its window's
+ * `focus` / `blur` and its `visibilitychange`; nothing polls. `false` on the
+ * server and without a document.
+ */
+export declare function useDocumentActive(doc: Document | null): boolean;

package/dist/lib/use-document-active.js

@@ -0,0 +1,40 @@
+import { useCallback, useSyncExternalStore } from "react";
+function isActive(doc) {
+  if (!doc) return false;
+  return doc.visibilityState === "visible" && doc.hasFocus();
+}
+function getServerSnapshot() {
+  return false;
+}
+function subscribeTo(doc, onChange) {
+  const view = doc == null ? void 0 : doc.defaultView;
+  if (!doc || !view) return () => {
+  };
+  let afterBlur = null;
+  const onBlur = () => {
+    onChange();
+    if (afterBlur !== null) clearTimeout(afterBlur);
+    afterBlur = setTimeout(() => {
+      afterBlur = null;
+      onChange();
+    }, 0);
+  };
+  view.addEventListener("focus", onChange);
+  view.addEventListener("blur", onBlur);
+  doc.addEventListener("visibilitychange", onChange);
+  return () => {
+    view.removeEventListener("focus", onChange);
+    view.removeEventListener("blur", onBlur);
+    doc.removeEventListener("visibilitychange", onChange);
+    if (afterBlur !== null) clearTimeout(afterBlur);
+  };
+}
+function useDocumentActive(doc) {
+  const subscribe = useCallback((onChange) => subscribeTo(doc, onChange), [doc]);
+  const getSnapshot = useCallback(() => isActive(doc), [doc]);
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}
+export {
+  useDocumentActive
+};
+//# sourceMappingURL=use-document-active.js.map

package/dist/lib/use-document-active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-document-active.js","sources":["../../src/lib/use-document-active.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\n\nfunction isActive(doc: Document | null): boolean {\n  if (!doc) return false;\n  return doc.visibilityState === 'visible' && doc.hasFocus();\n}\n\nfunction getServerSnapshot(): boolean {\n  return false;\n}\n\nfunction subscribeTo(doc: Document | null, onChange: () => void): () => void {\n  const view = doc?.defaultView;\n  if (!doc || !view) return () => {};\n  let afterBlur: ReturnType<typeof setTimeout> | null = null;\n  // `blur` fires before focus has landed. Focus that moved into a frame of\n  // this page (a computer's live desktop, an embedded asset) leaves the\n  // document focused, so it is read again once the browser has moved it.\n  const onBlur = () => {\n    onChange();\n    if (afterBlur !== null) clearTimeout(afterBlur);\n    afterBlur = setTimeout(() => {\n      afterBlur = null;\n      onChange();\n    }, 0);\n  };\n  view.addEventListener('focus', onChange);\n  view.addEventListener('blur', onBlur);\n  doc.addEventListener('visibilitychange', onChange);\n  return () => {\n    view.removeEventListener('focus', onChange);\n    view.removeEventListener('blur', onBlur);\n    doc.removeEventListener('visibilitychange', onChange);\n    if (afterBlur !== null) clearTimeout(afterBlur);\n  };\n}\n\n/**\n * Whether `doc` is in front of the person: visible and focused\n * (`hasFocus()`, which stays true while focus is inside a frame of the page).\n * Pass the document a subtree renders into (`useOwnerDocument()`), so a pane\n * popped out into another window reads that window. Re-read on its window's\n * `focus` / `blur` and its `visibilitychange`; nothing polls. `false` on the\n * server and without a document.\n */\nexport function useDocumentActive(doc: Document | null): boolean {\n  const subscribe = useCallback((onChange: () => void) => subscribeTo(doc, onChange), [doc]);\n  const getSnapshot = useCallback(() => isActive(doc), [doc]);\n  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n}\n"],"names":[],"mappings":";AAEA,SAAS,SAAS,KAA+B;AAC/C,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,IAAI,oBAAoB,aAAa,IAAI,SAAA;AAClD;AAEA,SAAS,oBAA6B;AACpC,SAAO;AACT;AAEA,SAAS,YAAY,KAAsB,UAAkC;AAC3E,QAAM,OAAO,2BAAK;AAClB,MAAI,CAAC,OAAO,CAAC,aAAa,MAAM;AAAA,EAAC;AACjC,MAAI,YAAkD;AAItD,QAAM,SAAS,MAAM;AACnB,aAAA;AACA,QAAI,cAAc,KAAM,cAAa,SAAS;AAC9C,gBAAY,WAAW,MAAM;AAC3B,kBAAY;AACZ,eAAA;AAAA,IACF,GAAG,CAAC;AAAA,EACN;AACA,OAAK,iBAAiB,SAAS,QAAQ;AACvC,OAAK,iBAAiB,QAAQ,MAAM;AACpC,MAAI,iBAAiB,oBAAoB,QAAQ;AACjD,SAAO,MAAM;AACX,SAAK,oBAAoB,SAAS,QAAQ;AAC1C,SAAK,oBAAoB,QAAQ,MAAM;AACvC,QAAI,oBAAoB,oBAAoB,QAAQ;AACpD,QAAI,cAAc,KAAM,cAAa,SAAS;AAAA,EAChD;AACF;AAUO,SAAS,kBAAkB,KAA+B;AAC/D,QAAM,YAAY,YAAY,CAAC,aAAyB,YAAY,KAAK,QAAQ,GAAG,CAAC,GAAG,CAAC;AACzF,QAAM,cAAc,YAAY,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC;AAC1D,SAAO,qBAAqB,WAAW,aAAa,iBAAiB;AACvE;"}

package/dist/react/package.json.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const version = "0.39.0";
+const version = "0.40.1";
 const packageJson = {
   version
 };

package/dist/react/package.json.js

@@ -1,4 +1,4 @@
-const version = "0.39.0";
+const version = "0.40.1";
 const packageJson = {
   version
 };

package/dist/runtime/statewire-lifecycle.cjs

@@ -22,6 +22,14 @@ function athenaStatewireErrorNotice(error) {
       ...withCode
     };
   }
+  if (errors.isConversationArchivedRejection(error)) {
+    return {
+      kind: "read-only",
+      title: "Message was not sent",
+      message: errors.CONVERSATION_ARCHIVED_MESSAGE,
+      ...withCode
+    };
+  }
   if (code === errors.COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {
     return {
       kind: "read-only",

package/dist/runtime/statewire-lifecycle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-lifecycle.cjs","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionCode,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n  /**\n   * The server's structured `detail.code` (`collab_agent_channel_session_mismatch`,\n   * `legacy_thread_read_only`, …), when the rejection carried one — what a\n   * host matches on to offer the right next step.\n   */\n  code?: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  const code = statewireRejectionCode(error);\n  const withCode = code === null ? {} : { code };\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n      ...withCode,\n    };\n  }\n\n  // A session keeps the collab-agent channel (the app's mode) it started on:\n  // the send asked for another one. Nothing about the chat is broken — the\n  // way on is a new session — so it reads as the amber \"not sent\", not red.\n  if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: detail ?? 'This session runs in another mode. Start a new session to use this one.',\n      code,\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n    ...withCode,\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\n/**\n * Whether the statewire channel can take a command now: connected, or on\n * standby (attached and idle). `null` (no connection observed yet) is not.\n */\nexport function isStatewireChannelLive(connection: DeepAgentConnectionState | null): boolean {\n  return connection?.status === 'connected' || connection?.status === 'standby';\n}\n\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy = isStatewireChannelLive(action.connection);\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":["isStatewireChannelTeardown","statewireRejectionPayload","statewireRejectionDetailMessage","statewireRejectionCode","isLegacyThreadReadOnlyRejection","COLLAB_AGENT_CHANNEL_SESSION_MISMATCH"],"mappings":";;;AA4BO,SAAS,2BACd,OACmC;AACnC,MAAIA,OAAAA,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAYC,OAAAA,0BAA0B,KAAK;AAGjD,QAAM,SAASC,OAAAA,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAEA,QAAM,OAAOC,OAAAA,uBAAuB,KAAK;AACzC,QAAM,WAAW,SAAS,OAAO,CAAA,IAAK,EAAE,KAAA;AAMxC,MAAIC,OAAAA,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,MACF,GAAG;AAAA,IAAA;AAAA,EAEP;AAKA,MAAI,SAASC,OAAAA,uCAAuC;AAClD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,UAAU;AAAA,MACnB;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AAaO,SAAS,uBAAuB,YAAsD;AAC3F,UAAO,yCAAY,YAAW,gBAAe,yCAAY,YAAW;AACtE;AAEO,SAAS,0BACd,OACA,QACgC;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,UAAU,uBAAuB,OAAO,UAAU;AACxD,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;;;;;"}
+{"version":3,"file":"statewire-lifecycle.cjs","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,\n  CONVERSATION_ARCHIVED_MESSAGE,\n  isConversationArchivedRejection,\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionCode,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n  /**\n   * The server's structured `detail.code` (`collab_agent_channel_session_mismatch`,\n   * `legacy_thread_read_only`, …), when the rejection carried one — what a\n   * host matches on to offer the right next step.\n   */\n  code?: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  const code = statewireRejectionCode(error);\n  const withCode = code === null ? {} : { code };\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n      ...withCode,\n    };\n  }\n\n  // The conversation is archived (in the trash): it takes no new turns until\n  // it is restored. Not broken and not retriable — the amber \"not sent\".\n  if (isConversationArchivedRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: CONVERSATION_ARCHIVED_MESSAGE,\n      ...withCode,\n    };\n  }\n\n  // A session keeps the collab-agent channel (the app's mode) it started on:\n  // the send asked for another one. Nothing about the chat is broken — the\n  // way on is a new session — so it reads as the amber \"not sent\", not red.\n  if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: detail ?? 'This session runs in another mode. Start a new session to use this one.',\n      code,\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n    ...withCode,\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\n/**\n * Whether the statewire channel can take a command now: connected, or on\n * standby (attached and idle). `null` (no connection observed yet) is not.\n */\nexport function isStatewireChannelLive(connection: DeepAgentConnectionState | null): boolean {\n  return connection?.status === 'connected' || connection?.status === 'standby';\n}\n\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy = isStatewireChannelLive(action.connection);\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":["isStatewireChannelTeardown","statewireRejectionPayload","statewireRejectionDetailMessage","statewireRejectionCode","isLegacyThreadReadOnlyRejection","isConversationArchivedRejection","CONVERSATION_ARCHIVED_MESSAGE","COLLAB_AGENT_CHANNEL_SESSION_MISMATCH"],"mappings":";;;AA8BO,SAAS,2BACd,OACmC;AACnC,MAAIA,OAAAA,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAYC,OAAAA,0BAA0B,KAAK;AAGjD,QAAM,SAASC,OAAAA,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAEA,QAAM,OAAOC,OAAAA,uBAAuB,KAAK;AACzC,QAAM,WAAW,SAAS,OAAO,CAAA,IAAK,EAAE,KAAA;AAMxC,MAAIC,OAAAA,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,MACF,GAAG;AAAA,IAAA;AAAA,EAEP;AAIA,MAAIC,OAAAA,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAASC,OAAAA;AAAAA,MACT,GAAG;AAAA,IAAA;AAAA,EAEP;AAKA,MAAI,SAASC,OAAAA,uCAAuC;AAClD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,UAAU;AAAA,MACnB;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AAaO,SAAS,uBAAuB,YAAsD;AAC3F,UAAO,yCAAY,YAAW,gBAAe,yCAAY,YAAW;AACtE;AAEO,SAAS,0BACd,OACA,QACgC;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,UAAU,uBAAuB,OAAO,UAAU;AACxD,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;;;;;"}

package/dist/runtime/statewire-lifecycle.js

@@ -1,4 +1,4 @@
-import { isStatewireChannelTeardown, statewireRejectionPayload, statewireRejectionDetailMessage, statewireRejectionCode, isLegacyThreadReadOnlyRejection, COLLAB_AGENT_CHANNEL_SESSION_MISMATCH } from "../agent-runtime/src/errors.js";
+import { isStatewireChannelTeardown, statewireRejectionPayload, statewireRejectionDetailMessage, statewireRejectionCode, isLegacyThreadReadOnlyRejection, isConversationArchivedRejection, CONVERSATION_ARCHIVED_MESSAGE, COLLAB_AGENT_CHANNEL_SESSION_MISMATCH } from "../agent-runtime/src/errors.js";
 function athenaStatewireErrorNotice(error) {
   if (isStatewireChannelTeardown(error)) return null;
   const rejection = statewireRejectionPayload(error);
@@ -20,6 +20,14 @@ function athenaStatewireErrorNotice(error) {
       ...withCode
     };
   }
+  if (isConversationArchivedRejection(error)) {
+    return {
+      kind: "read-only",
+      title: "Message was not sent",
+      message: CONVERSATION_ARCHIVED_MESSAGE,
+      ...withCode
+    };
+  }
   if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {
     return {
       kind: "read-only",

package/dist/runtime/statewire-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-lifecycle.js","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionCode,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n  /**\n   * The server's structured `detail.code` (`collab_agent_channel_session_mismatch`,\n   * `legacy_thread_read_only`, …), when the rejection carried one — what a\n   * host matches on to offer the right next step.\n   */\n  code?: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  const code = statewireRejectionCode(error);\n  const withCode = code === null ? {} : { code };\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n      ...withCode,\n    };\n  }\n\n  // A session keeps the collab-agent channel (the app's mode) it started on:\n  // the send asked for another one. Nothing about the chat is broken — the\n  // way on is a new session — so it reads as the amber \"not sent\", not red.\n  if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: detail ?? 'This session runs in another mode. Start a new session to use this one.',\n      code,\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n    ...withCode,\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\n/**\n * Whether the statewire channel can take a command now: connected, or on\n * standby (attached and idle). `null` (no connection observed yet) is not.\n */\nexport function isStatewireChannelLive(connection: DeepAgentConnectionState | null): boolean {\n  return connection?.status === 'connected' || connection?.status === 'standby';\n}\n\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy = isStatewireChannelLive(action.connection);\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":[],"mappings":";AA4BO,SAAS,2BACd,OACmC;AACnC,MAAI,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAY,0BAA0B,KAAK;AAGjD,QAAM,SAAS,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAEA,QAAM,OAAO,uBAAuB,KAAK;AACzC,QAAM,WAAW,SAAS,OAAO,CAAA,IAAK,EAAE,KAAA;AAMxC,MAAI,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,MACF,GAAG;AAAA,IAAA;AAAA,EAEP;AAKA,MAAI,SAAS,uCAAuC;AAClD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,UAAU;AAAA,MACnB;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AAaO,SAAS,uBAAuB,YAAsD;AAC3F,UAAO,yCAAY,YAAW,gBAAe,yCAAY,YAAW;AACtE;AAEO,SAAS,0BACd,OACA,QACgC;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,UAAU,uBAAuB,OAAO,UAAU;AACxD,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;"}
+{"version":3,"file":"statewire-lifecycle.js","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,\n  CONVERSATION_ARCHIVED_MESSAGE,\n  isConversationArchivedRejection,\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionCode,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n  /**\n   * The server's structured `detail.code` (`collab_agent_channel_session_mismatch`,\n   * `legacy_thread_read_only`, …), when the rejection carried one — what a\n   * host matches on to offer the right next step.\n   */\n  code?: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  const code = statewireRejectionCode(error);\n  const withCode = code === null ? {} : { code };\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n      ...withCode,\n    };\n  }\n\n  // The conversation is archived (in the trash): it takes no new turns until\n  // it is restored. Not broken and not retriable — the amber \"not sent\".\n  if (isConversationArchivedRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: CONVERSATION_ARCHIVED_MESSAGE,\n      ...withCode,\n    };\n  }\n\n  // A session keeps the collab-agent channel (the app's mode) it started on:\n  // the send asked for another one. Nothing about the chat is broken — the\n  // way on is a new session — so it reads as the amber \"not sent\", not red.\n  if (code === COLLAB_AGENT_CHANNEL_SESSION_MISMATCH) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message: detail ?? 'This session runs in another mode. Start a new session to use this one.',\n      code,\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n    ...withCode,\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\n/**\n * Whether the statewire channel can take a command now: connected, or on\n * standby (attached and idle). `null` (no connection observed yet) is not.\n */\nexport function isStatewireChannelLive(connection: DeepAgentConnectionState | null): boolean {\n  return connection?.status === 'connected' || connection?.status === 'standby';\n}\n\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy = isStatewireChannelLive(action.connection);\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":[],"mappings":";AA8BO,SAAS,2BACd,OACmC;AACnC,MAAI,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAY,0BAA0B,KAAK;AAGjD,QAAM,SAAS,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAEA,QAAM,OAAO,uBAAuB,KAAK;AACzC,QAAM,WAAW,SAAS,OAAO,CAAA,IAAK,EAAE,KAAA;AAMxC,MAAI,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,MACF,GAAG;AAAA,IAAA;AAAA,EAEP;AAIA,MAAI,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS;AAAA,MACT,GAAG;AAAA,IAAA;AAAA,EAEP;AAKA,MAAI,SAAS,uCAAuC;AAClD,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS,UAAU;AAAA,MACnB;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,IACN,GAAG;AAAA,EAAA;AAEP;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AAaO,SAAS,uBAAuB,YAAsD;AAC3F,UAAO,yCAAY,YAAW,gBAAe,yCAAY,YAAW;AACtE;AAEO,SAAS,0BACd,OACA,QACgC;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,UAAU,uBAAuB,OAAO,UAAU;AACxD,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;"}