@athenaintel/react 0.19.0 → 0.20.0

package/dist/diagnostics/athena-diagnostics.js

@@ -0,0 +1,329 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+import { getPostHogInstance } from "../provider/PostHogProvider.js";
+import { capturePosthogEvent } from "../lib/posthog/wrap-posthog-client.js";
+import { ATHENA_REACT_SDK_VERSION } from "../version.js";
+import { toAthenaSdkError, isAthenaSdkError } from "./errors.js";
+const ATHENA_DIAGNOSTIC_LEVELS = ["debug", "info", "warn", "error"];
+const LEVEL_RANK = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+const DEFAULT_CONFIG = {
+  console: false,
+  posthog: false,
+  bufferSize: 300
+};
+const CONSOLE_PREFIX = "[AthenaSDK]";
+const LOCAL_STORAGE_DEBUG_KEY = "athena:debug";
+const GLOBAL_KEY = "__ATHENA_SDK__";
+const REDACT_KEYS = /token|secret|api[-_]?key|authorization|cookie|password/i;
+function redact(data) {
+  if (!data) return void 0;
+  const out = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (REDACT_KEYS.test(key)) {
+      out[key] = typeof value === "string" && value.length > 0 ? `<redacted:${value.length}>` : "<redacted>";
+    } else {
+      out[key] = value;
+    }
+  }
+  return out;
+}
+function nowMs() {
+  return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function readLocalDebugLevel() {
+  try {
+    if (typeof localStorage === "undefined") return null;
+    const raw = localStorage.getItem(LOCAL_STORAGE_DEBUG_KEY);
+    if (!raw) return null;
+    if (ATHENA_DIAGNOSTIC_LEVELS.includes(raw)) {
+      return raw;
+    }
+    return raw === "1" || raw === "true" ? "debug" : null;
+  } catch {
+    return null;
+  }
+}
+class AthenaDiagnosticsBus {
+  constructor() {
+    __publicField(this, "config", { ...DEFAULT_CONFIG });
+    __publicField(this, "events", []);
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
+    __publicField(this, "snapshotListeners", /* @__PURE__ */ new Set());
+    __publicField(this, "seq", 0);
+    __publicField(this, "gauges", {});
+    __publicField(this, "timings", {});
+    __publicField(this, "spans", /* @__PURE__ */ new Map());
+    __publicField(this, "cachedSnapshot", null);
+  }
+  configure(partial) {
+    this.config = { ...this.config, ...partial };
+    if (this.events.length > this.config.bufferSize) {
+      this.events = this.events.slice(-this.config.bufferSize);
+    }
+    this.invalidate();
+  }
+  getConfig() {
+    return this.config;
+  }
+  /** Effective console level: the configured one, or `localStorage['athena:debug']`. */
+  consoleLevel() {
+    if (this.config.console !== false) return this.config.console;
+    return readLocalDebugLevel() ?? false;
+  }
+  emit(name, options = {}) {
+    const level = options.level ?? (options.error !== void 0 ? "error" : "info");
+    const error = options.error === void 0 ? void 0 : toAthenaSdkError(options.error, {
+      code: "unknown",
+      message: `Unexpected error during ${name}`
+    });
+    const event = {
+      seq: ++this.seq,
+      t: Math.round(nowMs() * 10) / 10,
+      at: (/* @__PURE__ */ new Date()).toISOString(),
+      name,
+      level,
+      ...options.durationMs !== void 0 && { durationMs: Math.round(options.durationMs) },
+      ...options.data && { data: redact(options.data) },
+      ...error && { error }
+    };
+    this.events.push(event);
+    if (this.events.length > this.config.bufferSize) {
+      this.events.splice(0, this.events.length - this.config.bufferSize);
+    }
+    if (event.durationMs !== void 0) {
+      this.timings[name] = event.durationMs;
+    }
+    this.invalidate();
+    this.echoToConsole(event);
+    this.forwardToPostHog(event);
+    for (const listener of this.listeners) {
+      try {
+        listener(event);
+      } catch (listenerError) {
+        console.error(`${CONSOLE_PREFIX} diagnostics listener threw`, listenerError);
+      }
+    }
+    if (this.config.onEvent) {
+      try {
+        this.config.onEvent(event);
+      } catch (callbackError) {
+        console.error(`${CONSOLE_PREFIX} onDiagnostic callback threw`, callbackError);
+      }
+    }
+    if (error && this.config.onError) {
+      try {
+        this.config.onError(error, event);
+      } catch (callbackError) {
+        console.error(`${CONSOLE_PREFIX} onError callback threw`, callbackError);
+      }
+    }
+    for (const notify of this.snapshotListeners) notify();
+    return event;
+  }
+  /** Record an error-level event. Returns the normalized `AthenaSdkError`. */
+  error(name, error, fallback, data) {
+    const normalized = toAthenaSdkError(error, fallback);
+    this.emit(name, { level: "error", error: normalized, data });
+    return normalized;
+  }
+  /**
+   * Start a named span. Returns a function that ends it and emits `doneName`
+   * with `durationMs` (or `errorName` when passed an error). Also records a
+   * `performance.measure` so the span shows in the browser's Performance panel.
+   */
+  span(spanName, startName, data) {
+    const startedAt = nowMs();
+    this.spans.set(spanName, startedAt);
+    this.mark(`${spanName}:start`);
+    this.emit(startName, { level: "debug", data });
+    return (doneName, doneOptions = {}) => {
+      const durationMs = nowMs() - startedAt;
+      this.spans.delete(spanName);
+      this.mark(`${spanName}:end`);
+      this.measure(spanName);
+      this.emit(doneName, {
+        level: doneOptions.error !== void 0 ? "error" : "info",
+        durationMs,
+        data: doneOptions.data,
+        error: doneOptions.error
+      });
+      return durationMs;
+    };
+  }
+  /** Set a gauge (latest-value metric): connection status, transport, auth mode. */
+  gauge(name, value) {
+    if (this.gauges[name] === value) return;
+    this.gauges[name] = value;
+    this.invalidate();
+    for (const notify of this.snapshotListeners) notify();
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  /**
+   * Additive consumer registration: every registered consumer receives every
+   * event (and every error), unlike the single `onEvent`/`onError` config
+   * slots which are last-writer-wins. `AthenaProvider` registers through this
+   * so two mounted providers never clobber each other's callbacks.
+   */
+  addConsumer(consumer) {
+    return this.subscribe((event) => {
+      var _a, _b;
+      try {
+        (_a = consumer.onEvent) == null ? void 0 : _a.call(consumer, event);
+      } catch (callbackError) {
+        console.error(`${CONSOLE_PREFIX} onDiagnostic consumer threw`, callbackError);
+      }
+      if (event.error) {
+        try {
+          (_b = consumer.onError) == null ? void 0 : _b.call(consumer, event.error, event);
+        } catch (callbackError) {
+          console.error(`${CONSOLE_PREFIX} onError consumer threw`, callbackError);
+        }
+      }
+    });
+  }
+  /** Subscribe to snapshot changes (for `useSyncExternalStore`). */
+  subscribeSnapshot(listener) {
+    this.snapshotListeners.add(listener);
+    return () => {
+      this.snapshotListeners.delete(listener);
+    };
+  }
+  snapshot() {
+    if (!this.cachedSnapshot) {
+      const { onEvent: _onEvent, onError: _onError, ...config } = this.config;
+      this.cachedSnapshot = {
+        sdkVersion: ATHENA_REACT_SDK_VERSION,
+        config,
+        events: [...this.events],
+        gauges: { ...this.gauges },
+        timings: { ...this.timings }
+      };
+    }
+    return this.cachedSnapshot;
+  }
+  /** Copy-paste-able JSON of the current snapshot (errors serialized). */
+  export() {
+    return JSON.stringify(
+      this.snapshot(),
+      (_key, value) => isAthenaSdkError(value) ? value.toJSON() : value,
+      2
+    );
+  }
+  clear() {
+    this.events = [];
+    this.timings = {};
+    this.invalidate();
+    for (const notify of this.snapshotListeners) notify();
+  }
+  invalidate() {
+    this.cachedSnapshot = null;
+  }
+  mark(name) {
+    try {
+      if (typeof performance !== "undefined" && typeof performance.mark === "function") {
+        performance.mark(`athena-sdk:${name}`);
+      }
+    } catch {
+    }
+  }
+  measure(spanName) {
+    try {
+      if (typeof performance !== "undefined" && typeof performance.measure === "function") {
+        performance.measure(
+          `athena-sdk:${spanName}`,
+          `athena-sdk:${spanName}:start`,
+          `athena-sdk:${spanName}:end`
+        );
+      }
+    } catch {
+    }
+  }
+  echoToConsole(event) {
+    const level = this.consoleLevel();
+    if (level === false) {
+      if (event.level === "error" && event.error) {
+        console.error(`${CONSOLE_PREFIX} ${event.name}: ${event.error.describe()}`, event.data ?? "");
+      }
+      return;
+    }
+    if (LEVEL_RANK[event.level] < LEVEL_RANK[level]) return;
+    const suffix = event.durationMs !== void 0 ? ` (${event.durationMs}ms)` : "";
+    const line = `${CONSOLE_PREFIX} ${event.name}${suffix}`;
+    const payload = event.error ? { ...event.data, error: event.error.describe() } : event.data;
+    const method = event.level === "error" ? console.error : event.level === "warn" ? console.warn : event.level === "debug" ? console.debug : console.info;
+    method(line, payload ?? "");
+  }
+  forwardToPostHog(event) {
+    if (!this.config.posthog) return;
+    if (event.durationMs === void 0 && event.level !== "error") return;
+    try {
+      const client = getPostHogInstance();
+      capturePosthogEvent(client, `athena_sdk_${event.name.replace(/\./g, "_")}`, {
+        sdk_version: ATHENA_REACT_SDK_VERSION,
+        level: event.level,
+        ...event.durationMs !== void 0 && { duration_ms: event.durationMs },
+        ...event.error && {
+          error_code: event.error.code,
+          error_message: event.error.message,
+          error_status: event.error.status
+        },
+        ...event.data
+      });
+    } catch {
+    }
+  }
+}
+const athenaDiagnostics = new AthenaDiagnosticsBus();
+function installAthenaDiagnosticsGlobal() {
+  if (typeof window === "undefined") return;
+  const globalWindow = window;
+  const existing = globalWindow[GLOBAL_KEY] ?? {};
+  globalWindow[GLOBAL_KEY] = {
+    ...existing,
+    version: ATHENA_REACT_SDK_VERSION,
+    diagnostics: {
+      snapshot: () => athenaDiagnostics.snapshot(),
+      export: () => athenaDiagnostics.export(),
+      clear: () => athenaDiagnostics.clear(),
+      enableConsole: (level = "debug") => {
+        try {
+          localStorage.setItem(LOCAL_STORAGE_DEBUG_KEY, level);
+        } catch {
+        }
+        athenaDiagnostics.configure({ console: level });
+      },
+      disableConsole: () => {
+        try {
+          localStorage.removeItem(LOCAL_STORAGE_DEBUG_KEY);
+        } catch {
+        }
+        athenaDiagnostics.configure({ console: false });
+      }
+    }
+  };
+}
+function debugPropToDiagnosticsConfig(debug) {
+  if (debug === void 0) return {};
+  if (debug === true) return { console: "debug" };
+  if (debug === false) return { console: false };
+  if (typeof debug === "string") return { console: debug };
+  return debug;
+}
+export {
+  ATHENA_DIAGNOSTIC_LEVELS,
+  athenaDiagnostics,
+  debugPropToDiagnosticsConfig,
+  installAthenaDiagnosticsGlobal
+};
+//# sourceMappingURL=athena-diagnostics.js.map

package/dist/diagnostics/athena-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"athena-diagnostics.js","sources":["../../src/diagnostics/athena-diagnostics.ts"],"sourcesContent":["/**\n * SDK diagnostics: one structured event bus for everything the SDK does that\n * can be slow or can fail — auth acquisition, thread-list fetches, statewire\n * attach/snapshot/connection changes, sends, first tokens, and every error.\n *\n * Design:\n * - Module-level singleton (one SDK, one bus), configured by `AthenaProvider`\n *   from its `debug` / `onDiagnostic` / `onError` props. Nothing here runs\n *   until something calls `emit`, and with defaults it costs a ring-buffer push.\n * - Every event carries `t` (ms since page navigation start via\n *   `performance.now()`) so the buffer reads as a waterfall. Timed spans use\n *   `performance.mark` / `performance.measure` too, so the browser Performance\n *   panel shows them as user timings without any extra tooling.\n * - Console output is opt-in (`debug` prop or `localStorage['athena:debug']`),\n *   prefixed `[AthenaSDK]`, and level-gated. Errors always reach `onError`.\n * - PostHog forwarding (opt-in) sends the timing events as\n *   `athena_sdk_<name>` with `duration_ms`, through the SDK's capture gate.\n *\n * Consumers read the buffer with `useAthenaDiagnostics()` or, in the browser\n * console, `window.__ATHENA_SDK__.diagnostics.snapshot()`.\n */\n\nimport { getPostHogInstance } from '../provider/PostHogProvider';\nimport { capturePosthogEvent, type PosthogCaptureClient } from '../lib/posthog/wrap-posthog-client';\nimport { ATHENA_REACT_SDK_VERSION } from '../version';\nimport { AthenaSdkError, isAthenaSdkError, toAthenaSdkError } from './errors';\n\nexport const ATHENA_DIAGNOSTIC_LEVELS = ['debug', 'info', 'warn', 'error'] as const;\nexport type AthenaDiagnosticLevel = (typeof ATHENA_DIAGNOSTIC_LEVELS)[number];\n\nconst LEVEL_RANK: Record<AthenaDiagnosticLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\n/**\n * Event names. Dotted `area.event` so a consumer can filter by prefix. Names\n * are part of the public contract: renaming one is a breaking change for\n * dashboards, so add new ones instead of repurposing.\n */\nexport type AthenaDiagnosticEventName =\n  // Provider / configuration\n  | 'sdk.init'\n  | 'sdk.transport'\n  | 'sdk.config.warning'\n  // Auth acquisition + lifecycle\n  | 'auth.bridge.start'\n  | 'auth.bridge.ready'\n  | 'auth.bridge.timeout'\n  | 'auth.bridge.absent'\n  | 'auth.bridge.error'\n  | 'auth.token.acquired'\n  | 'auth.token.refreshed'\n  | 'auth.token.refresh_failed'\n  | 'auth.token.stale'\n  | 'auth.sso.userinfo.start'\n  | 'auth.sso.userinfo.done'\n  | 'auth.sso.userinfo.error'\n  // Thread list + history\n  | 'threads.list.start'\n  | 'threads.list.done'\n  | 'threads.list.error'\n  | 'threads.list.aborted'\n  | 'threads.history.start'\n  | 'threads.history.done'\n  | 'threads.history.error'\n  | 'threads.history.aborted'\n  // Statewire transport\n  | 'statewire.attach.start'\n  | 'statewire.snapshot'\n  | 'statewire.connection'\n  | 'statewire.parked'\n  | 'statewire.error'\n  | 'statewire.read_only'\n  // Runs\n  | 'run.send'\n  | 'run.first_token'\n  | 'run.done'\n  | 'run.error'\n  // Composer\n  | 'composer.attachment.error'\n  | 'composer.cancel.error'\n  // Tool UIs + frontend tools\n  | 'tools.schema.warning'\n  | 'tools.debug'\n  // Mention suggestions\n  | 'mentions.fetch.error'\n  // Catch-all\n  | 'sdk.error';\n\nexport interface AthenaDiagnosticEvent {\n  /** Monotonic sequence number within this page. */\n  seq: number;\n  /** `performance.now()` at emit time (ms since navigation start). */\n  t: number;\n  /** Wall-clock ISO timestamp, for exports. */\n  at: string;\n  name: AthenaDiagnosticEventName;\n  level: AthenaDiagnosticLevel;\n  /** Milliseconds for a completed span (set on `*.done` / `*.ready` / `run.first_token`). */\n  durationMs?: number;\n  /** Structured context. Never contains credentials — see `redact`. */\n  data?: Record<string, unknown>;\n  /** Present on error-level events. */\n  error?: AthenaSdkError;\n}\n\nexport interface AthenaDiagnosticsConfig {\n  /** Minimum level echoed to the console. `false` disables console output. */\n  console: AthenaDiagnosticLevel | false;\n  /** Forward timing + error events to PostHog as `athena_sdk_*` events. */\n  posthog: boolean;\n  /** Receives every event (already redacted). */\n  onEvent?: (event: AthenaDiagnosticEvent) => void;\n  /** Receives every error-level event's `AthenaSdkError`. */\n  onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  /** Ring-buffer capacity. */\n  bufferSize: number;\n}\n\nexport interface AthenaDiagnosticsSnapshot {\n  sdkVersion: string;\n  config: Omit<AthenaDiagnosticsConfig, 'onEvent' | 'onError'>;\n  events: AthenaDiagnosticEvent[];\n  /** Latest value per gauge (connection status, transport, auth mode, …). */\n  gauges: Record<string, unknown>;\n  /** Named span durations, most recent per name (`auth.bridge`, `threads.list`, …). */\n  timings: Record<string, number>;\n}\n\nconst DEFAULT_CONFIG: AthenaDiagnosticsConfig = {\n  console: false,\n  posthog: false,\n  bufferSize: 300,\n};\n\nconst CONSOLE_PREFIX = '[AthenaSDK]';\nconst LOCAL_STORAGE_DEBUG_KEY = 'athena:debug';\nconst GLOBAL_KEY = '__ATHENA_SDK__';\n\n// Keys whose values must never enter the buffer, the console, or PostHog.\nconst REDACT_KEYS = /token|secret|api[-_]?key|authorization|cookie|password/i;\n\nfunction redact(data: Record<string, unknown> | undefined): Record<string, unknown> | undefined {\n  if (!data) return undefined;\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (REDACT_KEYS.test(key)) {\n      out[key] = typeof value === 'string' && value.length > 0 ? `<redacted:${value.length}>` : '<redacted>';\n    } else {\n      out[key] = value;\n    }\n  }\n  return out;\n}\n\nfunction nowMs(): number {\n  return typeof performance !== 'undefined' && typeof performance.now === 'function'\n    ? performance.now()\n    : Date.now();\n}\n\nfunction readLocalDebugLevel(): AthenaDiagnosticLevel | null {\n  try {\n    if (typeof localStorage === 'undefined') return null;\n    const raw = localStorage.getItem(LOCAL_STORAGE_DEBUG_KEY);\n    if (!raw) return null;\n    if ((ATHENA_DIAGNOSTIC_LEVELS as readonly string[]).includes(raw)) {\n      return raw as AthenaDiagnosticLevel;\n    }\n    return raw === '1' || raw === 'true' ? 'debug' : null;\n  } catch {\n    return null;\n  }\n}\n\ntype Listener = (event: AthenaDiagnosticEvent) => void;\n\nclass AthenaDiagnosticsBus {\n  private config: AthenaDiagnosticsConfig = { ...DEFAULT_CONFIG };\n  private events: AthenaDiagnosticEvent[] = [];\n  private listeners = new Set<Listener>();\n  private snapshotListeners = new Set<() => void>();\n  private seq = 0;\n  private gauges: Record<string, unknown> = {};\n  private timings: Record<string, number> = {};\n  private spans = new Map<string, number>();\n  private cachedSnapshot: AthenaDiagnosticsSnapshot | null = null;\n\n  configure(partial: Partial<AthenaDiagnosticsConfig>): void {\n    this.config = { ...this.config, ...partial };\n    if (this.events.length > this.config.bufferSize) {\n      this.events = this.events.slice(-this.config.bufferSize);\n    }\n    this.invalidate();\n  }\n\n  getConfig(): AthenaDiagnosticsConfig {\n    return this.config;\n  }\n\n  /** Effective console level: the configured one, or `localStorage['athena:debug']`. */\n  private consoleLevel(): AthenaDiagnosticLevel | false {\n    if (this.config.console !== false) return this.config.console;\n    return readLocalDebugLevel() ?? false;\n  }\n\n  emit(\n    name: AthenaDiagnosticEventName,\n    options: {\n      level?: AthenaDiagnosticLevel;\n      data?: Record<string, unknown>;\n      durationMs?: number;\n      error?: unknown;\n    } = {},\n  ): AthenaDiagnosticEvent {\n    const level = options.level ?? (options.error !== undefined ? 'error' : 'info');\n    const error =\n      options.error === undefined\n        ? undefined\n        : toAthenaSdkError(options.error, {\n            code: 'unknown',\n            message: `Unexpected error during ${name}`,\n          });\n    const event: AthenaDiagnosticEvent = {\n      seq: ++this.seq,\n      t: Math.round(nowMs() * 10) / 10,\n      at: new Date().toISOString(),\n      name,\n      level,\n      ...(options.durationMs !== undefined && { durationMs: Math.round(options.durationMs) }),\n      ...(options.data && { data: redact(options.data) }),\n      ...(error && { error }),\n    };\n\n    this.events.push(event);\n    if (this.events.length > this.config.bufferSize) {\n      this.events.splice(0, this.events.length - this.config.bufferSize);\n    }\n    if (event.durationMs !== undefined) {\n      this.timings[name] = event.durationMs;\n    }\n    this.invalidate();\n\n    this.echoToConsole(event);\n    this.forwardToPostHog(event);\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch (listenerError) {\n        console.error(`${CONSOLE_PREFIX} diagnostics listener threw`, listenerError);\n      }\n    }\n    if (this.config.onEvent) {\n      try {\n        this.config.onEvent(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic callback threw`, callbackError);\n      }\n    }\n    if (error && this.config.onError) {\n      try {\n        this.config.onError(error, event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onError callback threw`, callbackError);\n      }\n    }\n    for (const notify of this.snapshotListeners) notify();\n    return event;\n  }\n\n  /** Record an error-level event. Returns the normalized `AthenaSdkError`. */\n  error(\n    name: AthenaDiagnosticEventName,\n    error: unknown,\n    fallback: { code: AthenaSdkError['code']; message: string; hint?: string },\n    data?: Record<string, unknown>,\n  ): AthenaSdkError {\n    const normalized = toAthenaSdkError(error, fallback);\n    this.emit(name, { level: 'error', error: normalized, data });\n    return normalized;\n  }\n\n  /**\n   * Start a named span. Returns a function that ends it and emits `doneName`\n   * with `durationMs` (or `errorName` when passed an error). Also records a\n   * `performance.measure` so the span shows in the browser's Performance panel.\n   */\n  span(\n    spanName: string,\n    startName: AthenaDiagnosticEventName,\n    data?: Record<string, unknown>,\n  ): (\n    doneName: AthenaDiagnosticEventName,\n    doneOptions?: { data?: Record<string, unknown>; error?: unknown },\n  ) => number {\n    const startedAt = nowMs();\n    this.spans.set(spanName, startedAt);\n    this.mark(`${spanName}:start`);\n    this.emit(startName, { level: 'debug', data });\n    return (doneName, doneOptions = {}) => {\n      const durationMs = nowMs() - startedAt;\n      this.spans.delete(spanName);\n      this.mark(`${spanName}:end`);\n      this.measure(spanName);\n      this.emit(doneName, {\n        level: doneOptions.error !== undefined ? 'error' : 'info',\n        durationMs,\n        data: doneOptions.data,\n        error: doneOptions.error,\n      });\n      return durationMs;\n    };\n  }\n\n  /** Set a gauge (latest-value metric): connection status, transport, auth mode. */\n  gauge(name: string, value: unknown): void {\n    if (this.gauges[name] === value) return;\n    this.gauges[name] = value;\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  subscribe(listener: Listener): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  /**\n   * Additive consumer registration: every registered consumer receives every\n   * event (and every error), unlike the single `onEvent`/`onError` config\n   * slots which are last-writer-wins. `AthenaProvider` registers through this\n   * so two mounted providers never clobber each other's callbacks.\n   */\n  addConsumer(consumer: {\n    onEvent?: (event: AthenaDiagnosticEvent) => void;\n    onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  }): () => void {\n    return this.subscribe((event) => {\n      try {\n        consumer.onEvent?.(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic consumer threw`, callbackError);\n      }\n      if (event.error) {\n        try {\n          consumer.onError?.(event.error, event);\n        } catch (callbackError) {\n          console.error(`${CONSOLE_PREFIX} onError consumer threw`, callbackError);\n        }\n      }\n    });\n  }\n\n  /** Subscribe to snapshot changes (for `useSyncExternalStore`). */\n  subscribeSnapshot(listener: () => void): () => void {\n    this.snapshotListeners.add(listener);\n    return () => {\n      this.snapshotListeners.delete(listener);\n    };\n  }\n\n  snapshot(): AthenaDiagnosticsSnapshot {\n    if (!this.cachedSnapshot) {\n      const { onEvent: _onEvent, onError: _onError, ...config } = this.config;\n      this.cachedSnapshot = {\n        sdkVersion: ATHENA_REACT_SDK_VERSION,\n        config,\n        events: [...this.events],\n        gauges: { ...this.gauges },\n        timings: { ...this.timings },\n      };\n    }\n    return this.cachedSnapshot;\n  }\n\n  /** Copy-paste-able JSON of the current snapshot (errors serialized). */\n  export(): string {\n    return JSON.stringify(\n      this.snapshot(),\n      (_key, value) => (isAthenaSdkError(value) ? value.toJSON() : value),\n      2,\n    );\n  }\n\n  clear(): void {\n    this.events = [];\n    this.timings = {};\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  private invalidate(): void {\n    this.cachedSnapshot = null;\n  }\n\n  private mark(name: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.mark === 'function') {\n        performance.mark(`athena-sdk:${name}`);\n      }\n    } catch {\n      // User Timing is best-effort.\n    }\n  }\n\n  private measure(spanName: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.measure === 'function') {\n        performance.measure(\n          `athena-sdk:${spanName}`,\n          `athena-sdk:${spanName}:start`,\n          `athena-sdk:${spanName}:end`,\n        );\n      }\n    } catch {\n      // A missing start mark (e.g. after `performance.clearMarks`) is not an error.\n    }\n  }\n\n  private echoToConsole(event: AthenaDiagnosticEvent): void {\n    const level = this.consoleLevel();\n    if (level === false) {\n      // Errors are never silent: with console output off they still log once,\n      // compactly, so a broken integration is visible without enabling debug.\n      if (event.level === 'error' && event.error) {\n        console.error(`${CONSOLE_PREFIX} ${event.name}: ${event.error.describe()}`, event.data ?? '');\n      }\n      return;\n    }\n    if (LEVEL_RANK[event.level] < LEVEL_RANK[level]) return;\n    const suffix = event.durationMs !== undefined ? ` (${event.durationMs}ms)` : '';\n    const line = `${CONSOLE_PREFIX} ${event.name}${suffix}`;\n    const payload = event.error ? { ...event.data, error: event.error.describe() } : event.data;\n    const method =\n      event.level === 'error'\n        ? console.error\n        : event.level === 'warn'\n          ? console.warn\n          : event.level === 'debug'\n            ? console.debug\n            : console.info;\n    method(line, payload ?? '');\n  }\n\n  private forwardToPostHog(event: AthenaDiagnosticEvent): void {\n    if (!this.config.posthog) return;\n    if (event.durationMs === undefined && event.level !== 'error') return;\n    try {\n      const client = getPostHogInstance<PosthogCaptureClient>();\n      capturePosthogEvent(client, `athena_sdk_${event.name.replace(/\\./g, '_')}`, {\n        sdk_version: ATHENA_REACT_SDK_VERSION,\n        level: event.level,\n        ...(event.durationMs !== undefined && { duration_ms: event.durationMs }),\n        ...(event.error && {\n          error_code: event.error.code,\n          error_message: event.error.message,\n          error_status: event.error.status,\n        }),\n        ...event.data,\n      });\n    } catch {\n      // Analytics must never break the chat.\n    }\n  }\n}\n\nexport const athenaDiagnostics = new AthenaDiagnosticsBus();\n\n/**\n * Expose the bus on `window.__ATHENA_SDK__` so an integrator can inspect the\n * waterfall from the console (`__ATHENA_SDK__.diagnostics.snapshot()`) or turn\n * console echo on without a rebuild (`localStorage.setItem('athena:debug','debug')`).\n */\nexport function installAthenaDiagnosticsGlobal(): void {\n  if (typeof window === 'undefined') return;\n  const globalWindow = window as unknown as Record<string, unknown>;\n  const existing = (globalWindow[GLOBAL_KEY] ?? {}) as Record<string, unknown>;\n  globalWindow[GLOBAL_KEY] = {\n    ...existing,\n    version: ATHENA_REACT_SDK_VERSION,\n    diagnostics: {\n      snapshot: () => athenaDiagnostics.snapshot(),\n      export: () => athenaDiagnostics.export(),\n      clear: () => athenaDiagnostics.clear(),\n      enableConsole: (level: AthenaDiagnosticLevel = 'debug') => {\n        try {\n          localStorage.setItem(LOCAL_STORAGE_DEBUG_KEY, level);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: level });\n      },\n      disableConsole: () => {\n        try {\n          localStorage.removeItem(LOCAL_STORAGE_DEBUG_KEY);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: false });\n      },\n    },\n  };\n}\n\n/** Normalize the provider's `debug` prop into a diagnostics config patch. */\nexport function debugPropToDiagnosticsConfig(\n  debug: boolean | AthenaDiagnosticLevel | Partial<AthenaDiagnosticsConfig> | undefined,\n): Partial<AthenaDiagnosticsConfig> {\n  if (debug === undefined) return {};\n  if (debug === true) return { console: 'debug' };\n  if (debug === false) return { console: false };\n  if (typeof debug === 'string') return { console: debug };\n  return debug;\n}\n"],"names":[],"mappings":"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"}

package/dist/diagnostics/errors.cjs

@@ -0,0 +1,89 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const ATHENA_SDK_ERROR_CODES = {
+  /** No token and no API key resolved before a request had to be sent. */
+  auth_missing: "auth_missing",
+  /** The server refused the credential (401 / statewire `unauthorized` fin). */
+  auth_rejected: "auth_rejected",
+  /** `/_athena/auth` or the iframe bridge did not answer within the timeout. */
+  auth_bridge_timeout: "auth_bridge_timeout",
+  /** `/_athena/auth` answered with a non-404 error. */
+  auth_bridge_failed: "auth_bridge_failed",
+  /** The statewire sync URL could not be derived from the configuration. */
+  config_invalid: "config_invalid",
+  /** The thread list request failed. */
+  threads_list_failed: "threads_list_failed",
+  /** Loading a thread's history failed. */
+  thread_load_failed: "thread_load_failed",
+  /** The statewire host rejected a command (structured `{status, detail}`). */
+  statewire_rejected: "statewire_rejected",
+  /** The statewire connection is gone and will not reconnect on its own. */
+  statewire_gone: "statewire_gone",
+  /** The selected collab agent / channel was refused by the backend. */
+  collab_agent_rejected: "collab_agent_rejected",
+  /** A React render error crashed the chat surface (caught by the SDK's error boundary). */
+  chat_render_crash: "chat_render_crash",
+  /** A pasted or dropped file could not be uploaded as a composer attachment. */
+  attachment_failed: "attachment_failed",
+  /** Mention suggestions for a scope failed after every retry. */
+  mentions_fetch_failed: "mentions_fetch_failed",
+  /** Anything else. */
+  unknown: "unknown"
+};
+class AthenaSdkError extends Error {
+  constructor(options) {
+    super(options.message, options.cause === void 0 ? void 0 : { cause: options.cause });
+    __publicField(this, "code");
+    __publicField(this, "hint");
+    __publicField(this, "status");
+    __publicField(this, "detail");
+    __publicField(this, "context");
+    this.name = "AthenaSdkError";
+    this.code = options.code;
+    this.hint = options.hint;
+    this.status = options.status;
+    this.detail = options.detail;
+    this.context = options.context ?? {};
+  }
+  /** A log/console-friendly one-liner: `[code] message — hint`. */
+  describe() {
+    return `[${this.code}] ${this.message}${this.hint ? ` — ${this.hint}` : ""}`;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      hint: this.hint,
+      status: this.status,
+      detail: this.detail,
+      context: this.context
+    };
+  }
+}
+function isAthenaSdkError(value) {
+  return value instanceof AthenaSdkError;
+}
+function toAthenaSdkError(value, fallback) {
+  if (isAthenaSdkError(value)) return value;
+  const message = value instanceof Error && value.message ? value.message : fallback.message;
+  return new AthenaSdkError({ ...fallback, message, cause: value });
+}
+function readRejectionDetail(detail) {
+  if (typeof detail === "string") return { code: null, message: detail || null };
+  if (!detail || typeof detail !== "object") return { code: null, message: null };
+  const record = detail;
+  return {
+    code: typeof record.code === "string" ? record.code : null,
+    message: typeof record.message === "string" ? record.message : null
+  };
+}
+exports.ATHENA_SDK_ERROR_CODES = ATHENA_SDK_ERROR_CODES;
+exports.AthenaSdkError = AthenaSdkError;
+exports.isAthenaSdkError = isAthenaSdkError;
+exports.readRejectionDetail = readRejectionDetail;
+exports.toAthenaSdkError = toAthenaSdkError;
+//# sourceMappingURL=errors.cjs.map

package/dist/diagnostics/errors.cjs.map

@@ -0,0 +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  /** `/_athena/auth` or the iframe bridge did not answer within the timeout. */\n  auth_bridge_timeout: 'auth_bridge_timeout',\n  /** `/_athena/auth` answered with a non-404 error. */\n  auth_bridge_failed: 'auth_bridge_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  /** 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  /** 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,EAEf,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA,EAEpB,gBAAgB;AAAA;AAAA,EAEhB,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA,EAEpB,oBAAoB;AAAA;AAAA,EAEpB,gBAAgB;AAAA;AAAA,EAEhB,uBAAuB;AAAA;AAAA,EAEvB,mBAAmB;AAAA;AAAA,EAEnB,mBAAmB;AAAA;AAAA,EAEnB,uBAAuB;AAAA;AAAA,EAEvB,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.js

@@ -0,0 +1,89 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+const ATHENA_SDK_ERROR_CODES = {
+  /** No token and no API key resolved before a request had to be sent. */
+  auth_missing: "auth_missing",
+  /** The server refused the credential (401 / statewire `unauthorized` fin). */
+  auth_rejected: "auth_rejected",
+  /** `/_athena/auth` or the iframe bridge did not answer within the timeout. */
+  auth_bridge_timeout: "auth_bridge_timeout",
+  /** `/_athena/auth` answered with a non-404 error. */
+  auth_bridge_failed: "auth_bridge_failed",
+  /** The statewire sync URL could not be derived from the configuration. */
+  config_invalid: "config_invalid",
+  /** The thread list request failed. */
+  threads_list_failed: "threads_list_failed",
+  /** Loading a thread's history failed. */
+  thread_load_failed: "thread_load_failed",
+  /** The statewire host rejected a command (structured `{status, detail}`). */
+  statewire_rejected: "statewire_rejected",
+  /** The statewire connection is gone and will not reconnect on its own. */
+  statewire_gone: "statewire_gone",
+  /** The selected collab agent / channel was refused by the backend. */
+  collab_agent_rejected: "collab_agent_rejected",
+  /** A React render error crashed the chat surface (caught by the SDK's error boundary). */
+  chat_render_crash: "chat_render_crash",
+  /** A pasted or dropped file could not be uploaded as a composer attachment. */
+  attachment_failed: "attachment_failed",
+  /** Mention suggestions for a scope failed after every retry. */
+  mentions_fetch_failed: "mentions_fetch_failed",
+  /** Anything else. */
+  unknown: "unknown"
+};
+class AthenaSdkError extends Error {
+  constructor(options) {
+    super(options.message, options.cause === void 0 ? void 0 : { cause: options.cause });
+    __publicField(this, "code");
+    __publicField(this, "hint");
+    __publicField(this, "status");
+    __publicField(this, "detail");
+    __publicField(this, "context");
+    this.name = "AthenaSdkError";
+    this.code = options.code;
+    this.hint = options.hint;
+    this.status = options.status;
+    this.detail = options.detail;
+    this.context = options.context ?? {};
+  }
+  /** A log/console-friendly one-liner: `[code] message — hint`. */
+  describe() {
+    return `[${this.code}] ${this.message}${this.hint ? ` — ${this.hint}` : ""}`;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      hint: this.hint,
+      status: this.status,
+      detail: this.detail,
+      context: this.context
+    };
+  }
+}
+function isAthenaSdkError(value) {
+  return value instanceof AthenaSdkError;
+}
+function toAthenaSdkError(value, fallback) {
+  if (isAthenaSdkError(value)) return value;
+  const message = value instanceof Error && value.message ? value.message : fallback.message;
+  return new AthenaSdkError({ ...fallback, message, cause: value });
+}
+function readRejectionDetail(detail) {
+  if (typeof detail === "string") return { code: null, message: detail || null };
+  if (!detail || typeof detail !== "object") return { code: null, message: null };
+  const record = detail;
+  return {
+    code: typeof record.code === "string" ? record.code : null,
+    message: typeof record.message === "string" ? record.message : null
+  };
+}
+export {
+  ATHENA_SDK_ERROR_CODES,
+  AthenaSdkError,
+  isAthenaSdkError,
+  readRejectionDetail,
+  toAthenaSdkError
+};
+//# sourceMappingURL=errors.js.map

package/dist/diagnostics/errors.js.map

@@ -0,0 +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  /** `/_athena/auth` or the iframe bridge did not answer within the timeout. */\n  auth_bridge_timeout: 'auth_bridge_timeout',\n  /** `/_athena/auth` answered with a non-404 error. */\n  auth_bridge_failed: 'auth_bridge_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  /** 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  /** 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,EAEf,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA,EAEpB,gBAAgB;AAAA;AAAA,EAEhB,qBAAqB;AAAA;AAAA,EAErB,oBAAoB;AAAA;AAAA,EAEpB,oBAAoB;AAAA;AAAA,EAEpB,gBAAgB;AAAA;AAAA,EAEhB,uBAAuB;AAAA;AAAA,EAEvB,mBAAmB;AAAA;AAAA,EAEnB,mBAAmB;AAAA;AAAA,EAEnB,uBAAuB;AAAA;AAAA,EAEvB,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/useAthenaDiagnostics.cjs

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const athenaDiagnostics = require("./athena-diagnostics.cjs");
+function useAthenaDiagnostics() {
+  const snapshot = react.useSyncExternalStore(
+    athenaDiagnostics.athenaDiagnostics.subscribeSnapshot.bind(athenaDiagnostics.athenaDiagnostics),
+    athenaDiagnostics.athenaDiagnostics.snapshot.bind(athenaDiagnostics.athenaDiagnostics),
+    athenaDiagnostics.athenaDiagnostics.snapshot.bind(athenaDiagnostics.athenaDiagnostics)
+  );
+  const clear = react.useCallback(() => athenaDiagnostics.athenaDiagnostics.clear(), []);
+  const exportJson = react.useCallback(() => athenaDiagnostics.athenaDiagnostics.export(), []);
+  return { ...snapshot, clear, export: exportJson };
+}
+exports.useAthenaDiagnostics = useAthenaDiagnostics;
+//# sourceMappingURL=useAthenaDiagnostics.cjs.map

package/dist/diagnostics/useAthenaDiagnostics.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAthenaDiagnostics.cjs","sources":["../../src/diagnostics/useAthenaDiagnostics.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\nimport { athenaDiagnostics, type AthenaDiagnosticsSnapshot } from './athena-diagnostics';\n\n/**\n * Read the SDK diagnostics buffer reactively — events, gauges (connection\n * status, transport, auth mode), and the latest span timings (time to auth,\n * time to thread list, time to statewire snapshot, time to first token).\n *\n * Renders on every emitted event; mount it in a debug panel, not in the chat\n * transcript.\n */\nexport function useAthenaDiagnostics(): AthenaDiagnosticsSnapshot & {\n  clear: () => void;\n  export: () => string;\n} {\n  const snapshot = useSyncExternalStore(\n    athenaDiagnostics.subscribeSnapshot.bind(athenaDiagnostics),\n    athenaDiagnostics.snapshot.bind(athenaDiagnostics),\n    athenaDiagnostics.snapshot.bind(athenaDiagnostics),\n  );\n  const clear = useCallback(() => athenaDiagnostics.clear(), []);\n  const exportJson = useCallback(() => athenaDiagnostics.export(), []);\n  return { ...snapshot, clear, export: exportJson };\n}\n"],"names":["useSyncExternalStore","athenaDiagnostics","useCallback"],"mappings":";;;;AAWO,SAAS,uBAGd;AACA,QAAM,WAAWA,MAAAA;AAAAA,IACfC,oCAAkB,kBAAkB,KAAKA,mCAAiB;AAAA,IAC1DA,oCAAkB,SAAS,KAAKA,mCAAiB;AAAA,IACjDA,oCAAkB,SAAS,KAAKA,kBAAAA,iBAAiB;AAAA,EAAA;AAEnD,QAAM,QAAQC,MAAAA,YAAY,MAAMD,kBAAAA,kBAAkB,MAAA,GAAS,CAAA,CAAE;AAC7D,QAAM,aAAaC,MAAAA,YAAY,MAAMD,kBAAAA,kBAAkB,OAAA,GAAU,CAAA,CAAE;AACnE,SAAO,EAAE,GAAG,UAAU,OAAO,QAAQ,WAAA;AACvC;;"}

package/dist/diagnostics/useAthenaDiagnostics.js

@@ -0,0 +1,16 @@
+import { useSyncExternalStore, useCallback } from "react";
+import { athenaDiagnostics } from "./athena-diagnostics.js";
+function useAthenaDiagnostics() {
+  const snapshot = useSyncExternalStore(
+    athenaDiagnostics.subscribeSnapshot.bind(athenaDiagnostics),
+    athenaDiagnostics.snapshot.bind(athenaDiagnostics),
+    athenaDiagnostics.snapshot.bind(athenaDiagnostics)
+  );
+  const clear = useCallback(() => athenaDiagnostics.clear(), []);
+  const exportJson = useCallback(() => athenaDiagnostics.export(), []);
+  return { ...snapshot, clear, export: exportJson };
+}
+export {
+  useAthenaDiagnostics
+};
+//# sourceMappingURL=useAthenaDiagnostics.js.map

package/dist/diagnostics/useAthenaDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAthenaDiagnostics.js","sources":["../../src/diagnostics/useAthenaDiagnostics.ts"],"sourcesContent":["import { useCallback, useSyncExternalStore } from 'react';\nimport { athenaDiagnostics, type AthenaDiagnosticsSnapshot } from './athena-diagnostics';\n\n/**\n * Read the SDK diagnostics buffer reactively — events, gauges (connection\n * status, transport, auth mode), and the latest span timings (time to auth,\n * time to thread list, time to statewire snapshot, time to first token).\n *\n * Renders on every emitted event; mount it in a debug panel, not in the chat\n * transcript.\n */\nexport function useAthenaDiagnostics(): AthenaDiagnosticsSnapshot & {\n  clear: () => void;\n  export: () => string;\n} {\n  const snapshot = useSyncExternalStore(\n    athenaDiagnostics.subscribeSnapshot.bind(athenaDiagnostics),\n    athenaDiagnostics.snapshot.bind(athenaDiagnostics),\n    athenaDiagnostics.snapshot.bind(athenaDiagnostics),\n  );\n  const clear = useCallback(() => athenaDiagnostics.clear(), []);\n  const exportJson = useCallback(() => athenaDiagnostics.export(), []);\n  return { ...snapshot, clear, export: exportJson };\n}\n"],"names":[],"mappings":";;AAWO,SAAS,uBAGd;AACA,QAAM,WAAW;AAAA,IACf,kBAAkB,kBAAkB,KAAK,iBAAiB;AAAA,IAC1D,kBAAkB,SAAS,KAAK,iBAAiB;AAAA,IACjD,kBAAkB,SAAS,KAAK,iBAAiB;AAAA,EAAA;AAEnD,QAAM,QAAQ,YAAY,MAAM,kBAAkB,MAAA,GAAS,CAAA,CAAE;AAC7D,QAAM,aAAa,YAAY,MAAM,kBAAkB,OAAA,GAAU,CAAA,CAAE;AACnE,SAAO,EAAE,GAAG,UAAU,OAAO,QAAQ,WAAA;AACvC;"}