@athenaintel/react 0.28.0 → 0.30.0

package/dist/chat/super-grouping/turn-timing.cjs

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const messageTime = require("../message-time.cjs");
+const messages = require("../../agent-runtime/src/messages.cjs");
+function record(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function readInstantMs(value) {
+  var _a;
+  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+    return value > 1e12 ? value : value * 1e3;
+  }
+  return ((_a = messageTime.parseMessageTime(value)) == null ? void 0 : _a.getTime()) ?? null;
+}
+function sourceMetadata(message) {
+  var _a;
+  const kwargs = record((_a = record(message)) == null ? void 0 : _a.additional_kwargs);
+  return record(kwargs == null ? void 0 : kwargs.metadata) ?? kwargs;
+}
+function isRunMarker(message) {
+  var _a, _b;
+  return typeof ((_b = record((_a = record(message)) == null ? void 0 : _a.additional_kwargs)) == null ? void 0 : _b[messages.ATHENA_RUN_MARKER_KEY]) === "string";
+}
+function readTurnTiming({ promptCreatedAt, custom, sourceMessages }) {
+  let endMs = null;
+  let firstStampMs = null;
+  let serverStartMs = null;
+  let serverDurationMs = null;
+  let afterMarker = false;
+  let continuedAtMs = null;
+  for (const message of sourceMessages) {
+    if (isRunMarker(message)) {
+      afterMarker = true;
+      continuedAtMs = null;
+      serverDurationMs = null;
+      continue;
+    }
+    const metadata = sourceMetadata(message);
+    const stamp = readInstantMs(metadata == null ? void 0 : metadata[messageTime.MESSAGE_CREATED_AT_KEY]);
+    if (stamp !== null) {
+      firstStampMs ?? (firstStampMs = stamp);
+      if (afterMarker) continuedAtMs ?? (continuedAtMs = stamp);
+      endMs = endMs === null ? stamp : Math.max(endMs, stamp);
+    }
+    const duration = metadata == null ? void 0 : metadata.agent_duration_seconds;
+    if (typeof duration === "number" && Number.isFinite(duration) && duration > 0) {
+      serverDurationMs = duration * 1e3;
+      serverStartMs = readInstantMs(metadata == null ? void 0 : metadata.agent_start_time) ?? serverStartMs;
+    }
+  }
+  if (serverStartMs !== null && serverDurationMs !== null) {
+    const serverEnd = serverStartMs + serverDurationMs;
+    endMs = endMs === null ? serverEnd : Math.max(endMs, serverEnd);
+  }
+  const startMs = continuedAtMs ?? readInstantMs(promptCreatedAt) ?? serverStartMs ?? readInstantMs(custom == null ? void 0 : custom.agent_start_time) ?? readInstantMs(custom == null ? void 0 : custom.run_started_at) ?? readInstantMs(custom == null ? void 0 : custom[messageTime.MESSAGE_CREATED_AT_KEY]) ?? firstStampMs;
+  return { startMs, endMs, serverDurationMs };
+}
+function workedDurationMs({ startMs, endMs, serverDurationMs }, observedEndMs = null) {
+  const observed = observedEndMs !== null && (endMs === null || observedEndMs - endMs <= MAX_OBSERVED_END_LAG_MS) ? observedEndMs : null;
+  const end = serverDurationMs !== null || observed === null ? endMs : endMs === null ? observed : Math.max(endMs, observed);
+  if (startMs !== null && end !== null && end >= startMs) {
+    return Math.max(end - startMs, serverDurationMs ?? 0);
+  }
+  return serverDurationMs;
+}
+const MAX_OBSERVED_END_LAG_MS = 10 * 60 * 1e3;
+function formatWorkDuration(ms) {
+  const totalSeconds = Math.max(0, Math.floor(ms / 1e3));
+  if (totalSeconds < 60) return `${totalSeconds}s`;
+  const totalMinutes = Math.floor(totalSeconds / 60);
+  if (totalMinutes < 60) return `${totalMinutes}m ${String(totalSeconds % 60).padStart(2, "0")}s`;
+  const hours = Math.floor(totalMinutes / 60);
+  return `${hours}h ${String(totalMinutes % 60).padStart(2, "0")}m`;
+}
+function workingLabel(elapsedMs) {
+  return elapsedMs < 1e3 ? "Working" : `Working for ${formatWorkDuration(elapsedMs)}`;
+}
+const MAX_FIRST_SEEN = 200;
+const firstSeen = /* @__PURE__ */ new Map();
+function firstSeenMs(key, now = Date.now()) {
+  const seen = firstSeen.get(key);
+  if (seen !== void 0) return seen;
+  firstSeen.set(key, now);
+  if (firstSeen.size > MAX_FIRST_SEEN) {
+    const oldest = firstSeen.keys().next().value;
+    if (oldest !== void 0) firstSeen.delete(oldest);
+  }
+  return now;
+}
+const observedEnds = /* @__PURE__ */ new Map();
+function recordObservedTurnEnd(key, now = Date.now()) {
+  observedEnds.set(key, now);
+  if (observedEnds.size > MAX_FIRST_SEEN) {
+    const oldest = observedEnds.keys().next().value;
+    if (oldest !== void 0) observedEnds.delete(oldest);
+  }
+  return now;
+}
+function observedTurnEndMs(key) {
+  return observedEnds.get(key) ?? null;
+}
+exports.firstSeenMs = firstSeenMs;
+exports.formatWorkDuration = formatWorkDuration;
+exports.observedTurnEndMs = observedTurnEndMs;
+exports.readInstantMs = readInstantMs;
+exports.readTurnTiming = readTurnTiming;
+exports.recordObservedTurnEnd = recordObservedTurnEnd;
+exports.workedDurationMs = workedDurationMs;
+exports.workingLabel = workingLabel;
+//# sourceMappingURL=turn-timing.cjs.map

package/dist/chat/super-grouping/turn-timing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-timing.cjs","sources":["../../../src/chat/super-grouping/turn-timing.ts"],"sourcesContent":["/**\n * How long an assistant turn has been working, or worked — the grouped\n * transcript's \"Working for 1m 12s\" / \"Worked for 2m 30s\" header.\n *\n * Every clock here is a server stamp the runtime already writes: `_created_at`\n * on each message (`additional_kwargs.metadata`, surfaced as\n * `metadata.custom`), and on the turn's final assistant message the\n * turn-timing middleware's `agent_start_time` / `agent_duration_seconds`\n * (epoch seconds). The converter joins only the first assistant message's\n * metadata into the turn, so the end of the turn is read off the raw messages\n * bound to it. assistant-ui's own `createdAt` is when this client first saw the\n * message, so it is never used.\n */\nimport { ATHENA_RUN_MARKER_KEY } from '@athenaintel/agent-runtime';\nimport { MESSAGE_CREATED_AT_KEY, parseMessageTime } from '../message-time';\n\nexport interface TurnTiming {\n  /**\n   * When the turn started: the prompt's stamp, else the run's own start\n   * stamps. A turn that was stopped and then continued starts at its\n   * continuation, so the clock never counts the time it sat stopped.\n   */\n  startMs: number | null;\n  /** When the turn's last message was written, from the server's stamps. */\n  endMs: number | null;\n  /** The turn-timing middleware's duration, when the final message carries it. */\n  serverDurationMs: number | null;\n}\n\nexport interface TurnTimingSources {\n  /** `_created_at` of the user message this turn answers. */\n  promptCreatedAt: string | null | undefined;\n  /** The turn's joined `metadata.custom` (its first assistant message's). */\n  custom: Record<string, unknown> | undefined;\n  /** The raw messages bound to the turn (`getExternalStoreMessages`), oldest first. */\n  sourceMessages: readonly unknown[];\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\n/** An instant from an ISO stamp or epoch seconds (milliseconds past 1e12), else `null`. */\nexport function readInstantMs(value: unknown): number | null {\n  if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n    return value > 1e12 ? value : value * 1000;\n  }\n  return parseMessageTime(value)?.getTime() ?? null;\n}\n\nfunction sourceMetadata(message: unknown): Record<string, unknown> | undefined {\n  const kwargs = record(record(message)?.additional_kwargs);\n  return record(kwargs?.metadata) ?? kwargs;\n}\n\nfunction isRunMarker(message: unknown): boolean {\n  return typeof record(record(message)?.additional_kwargs)?.[ATHENA_RUN_MARKER_KEY] === 'string';\n}\n\n/** The turn's start, end and server-measured duration from the stamps it carries. */\nexport function readTurnTiming({ promptCreatedAt, custom, sourceMessages }: TurnTimingSources): TurnTiming {\n  let endMs: number | null = null;\n  let firstStampMs: number | null = null;\n  let serverStartMs: number | null = null;\n  let serverDurationMs: number | null = null;\n  let afterMarker = false;\n  let continuedAtMs: number | null = null;\n  for (const message of sourceMessages) {\n    if (isRunMarker(message)) {\n      afterMarker = true;\n      continuedAtMs = null;\n      serverDurationMs = null;\n      continue;\n    }\n    const metadata = sourceMetadata(message);\n    const stamp = readInstantMs(metadata?.[MESSAGE_CREATED_AT_KEY]);\n    if (stamp !== null) {\n      firstStampMs ??= stamp;\n      if (afterMarker) continuedAtMs ??= stamp;\n      endMs = endMs === null ? stamp : Math.max(endMs, stamp);\n    }\n    const duration = metadata?.agent_duration_seconds;\n    if (typeof duration === 'number' && Number.isFinite(duration) && duration > 0) {\n      serverDurationMs = duration * 1000;\n      serverStartMs = readInstantMs(metadata?.agent_start_time) ?? serverStartMs;\n    }\n  }\n  if (serverStartMs !== null && serverDurationMs !== null) {\n    const serverEnd = serverStartMs + serverDurationMs;\n    endMs = endMs === null ? serverEnd : Math.max(endMs, serverEnd);\n  }\n  // Without a prompt stamp the run's own server clock comes before any\n  // assistant stamp: the first assistant message is written after the turn\n  // has already been working (thinking, the first tool), so starting there\n  // would drop that time.\n  const startMs =\n    continuedAtMs ??\n    readInstantMs(promptCreatedAt) ??\n    serverStartMs ??\n    readInstantMs(custom?.agent_start_time) ??\n    readInstantMs(custom?.run_started_at) ??\n    readInstantMs(custom?.[MESSAGE_CREATED_AT_KEY]) ??\n    firstStampMs;\n  return { startMs, endMs, serverDurationMs };\n}\n\n/**\n * How long a finished turn worked: from its start to its end, else the\n * server-measured duration, else `null` (nothing truthful to show).\n *\n * The end is the server's own turn clock when the final message carries it.\n * The turn-timing stamp lands on that message only after it has streamed, so a\n * turn watched live can settle before the stamp reaches this client; the last\n * message's `_created_at` is then the start of the final answer, not its end,\n * and `observedEndMs` (when this client saw the turn settle) stands in for it.\n */\nexport function workedDurationMs(\n  { startMs, endMs, serverDurationMs }: TurnTiming,\n  observedEndMs: number | null = null,\n): number | null {\n  // A settle seen long after the last stamp is not this turn's end (a thread\n  // opened while its status was still catching up), so it is ignored.\n  const observed =\n    observedEndMs !== null && (endMs === null || observedEndMs - endMs <= MAX_OBSERVED_END_LAG_MS)\n      ? observedEndMs\n      : null;\n  const end =\n    serverDurationMs !== null || observed === null\n      ? endMs\n      : endMs === null\n        ? observed\n        : Math.max(endMs, observed);\n  // The server's own duration is a floor: a start read off a later stamp\n  // never shortens the turn below what the server measured.\n  if (startMs !== null && end !== null && end >= startMs) {\n    return Math.max(end - startMs, serverDurationMs ?? 0);\n  }\n  return serverDurationMs;\n}\n\n/** How far past its last stamp a turn may be seen to settle and still count as its end. */\nconst MAX_OBSERVED_END_LAG_MS = 10 * 60 * 1000;\n\n/** \"45s\", \"1m 12s\", \"1h 03m\". */\nexport function formatWorkDuration(ms: number): string {\n  const totalSeconds = Math.max(0, Math.floor(ms / 1000));\n  if (totalSeconds < 60) return `${totalSeconds}s`;\n  const totalMinutes = Math.floor(totalSeconds / 60);\n  if (totalMinutes < 60) return `${totalMinutes}m ${String(totalSeconds % 60).padStart(2, '0')}s`;\n  const hours = Math.floor(totalMinutes / 60);\n  return `${hours}h ${String(totalMinutes % 60).padStart(2, '0')}m`;\n}\n\n/** The live header: \"Working\" for the first second, then \"Working for 1m 12s\". */\nexport function workingLabel(elapsedMs: number): string {\n  return elapsedMs < 1000 ? 'Working' : `Working for ${formatWorkDuration(elapsedMs)}`;\n}\n\n/** The settled header: \"Worked for 2m 30s\", or `null` when the turn carries no usable stamps. */\nexport function workedLabel(timing: TurnTiming): string | null {\n  const worked = workedDurationMs(timing);\n  return worked === null ? null : `Worked for ${formatWorkDuration(worked)}`;\n}\n\nconst MAX_FIRST_SEEN = 200;\nconst firstSeen = new Map<string, number>();\n\n/**\n * The first time this client saw a turn, for a live clock with no server stamp\n * to anchor on yet (an optimistic prompt before the server echoes it). Keyed\n * per turn, so a later turn never inherits an earlier one's start; bounded.\n */\nexport function firstSeenMs(key: string, now = Date.now()): number {\n  const seen = firstSeen.get(key);\n  if (seen !== undefined) return seen;\n  firstSeen.set(key, now);\n  if (firstSeen.size > MAX_FIRST_SEEN) {\n    const oldest = firstSeen.keys().next().value;\n    if (oldest !== undefined) firstSeen.delete(oldest);\n  }\n  return now;\n}\n\nconst observedEnds = new Map<string, number>();\n\n/** Record that this client saw the turn `key` settle at `now`; returns the recorded instant. */\nexport function recordObservedTurnEnd(key: string, now = Date.now()): number {\n  observedEnds.set(key, now);\n  if (observedEnds.size > MAX_FIRST_SEEN) {\n    const oldest = observedEnds.keys().next().value;\n    if (oldest !== undefined) observedEnds.delete(oldest);\n  }\n  return now;\n}\n\n/** When this client saw the turn `key` settle, if it watched it do so. */\nexport function observedTurnEndMs(key: string): number | null {\n  return observedEnds.get(key) ?? null;\n}\n\nexport function resetFirstSeenForTests(): void {\n  firstSeen.clear();\n  observedEnds.clear();\n}\n"],"names":["parseMessageTime","ATHENA_RUN_MARKER_KEY","MESSAGE_CREATED_AT_KEY"],"mappings":"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"}

package/dist/chat/super-grouping/turn-timing.d.ts

@@ -0,0 +1,52 @@
+export interface TurnTiming {
+    /**
+     * When the turn started: the prompt's stamp, else the run's own start
+     * stamps. A turn that was stopped and then continued starts at its
+     * continuation, so the clock never counts the time it sat stopped.
+     */
+    startMs: number | null;
+    /** When the turn's last message was written, from the server's stamps. */
+    endMs: number | null;
+    /** The turn-timing middleware's duration, when the final message carries it. */
+    serverDurationMs: number | null;
+}
+export interface TurnTimingSources {
+    /** `_created_at` of the user message this turn answers. */
+    promptCreatedAt: string | null | undefined;
+    /** The turn's joined `metadata.custom` (its first assistant message's). */
+    custom: Record<string, unknown> | undefined;
+    /** The raw messages bound to the turn (`getExternalStoreMessages`), oldest first. */
+    sourceMessages: readonly unknown[];
+}
+/** An instant from an ISO stamp or epoch seconds (milliseconds past 1e12), else `null`. */
+export declare function readInstantMs(value: unknown): number | null;
+/** The turn's start, end and server-measured duration from the stamps it carries. */
+export declare function readTurnTiming({ promptCreatedAt, custom, sourceMessages }: TurnTimingSources): TurnTiming;
+/**
+ * How long a finished turn worked: from its start to its end, else the
+ * server-measured duration, else `null` (nothing truthful to show).
+ *
+ * The end is the server's own turn clock when the final message carries it.
+ * The turn-timing stamp lands on that message only after it has streamed, so a
+ * turn watched live can settle before the stamp reaches this client; the last
+ * message's `_created_at` is then the start of the final answer, not its end,
+ * and `observedEndMs` (when this client saw the turn settle) stands in for it.
+ */
+export declare function workedDurationMs({ startMs, endMs, serverDurationMs }: TurnTiming, observedEndMs?: number | null): number | null;
+/** "45s", "1m 12s", "1h 03m". */
+export declare function formatWorkDuration(ms: number): string;
+/** The live header: "Working" for the first second, then "Working for 1m 12s". */
+export declare function workingLabel(elapsedMs: number): string;
+/** The settled header: "Worked for 2m 30s", or `null` when the turn carries no usable stamps. */
+export declare function workedLabel(timing: TurnTiming): string | null;
+/**
+ * The first time this client saw a turn, for a live clock with no server stamp
+ * to anchor on yet (an optimistic prompt before the server echoes it). Keyed
+ * per turn, so a later turn never inherits an earlier one's start; bounded.
+ */
+export declare function firstSeenMs(key: string, now?: number): number;
+/** Record that this client saw the turn `key` settle at `now`; returns the recorded instant. */
+export declare function recordObservedTurnEnd(key: string, now?: number): number;
+/** When this client saw the turn `key` settle, if it watched it do so. */
+export declare function observedTurnEndMs(key: string): number | null;
+export declare function resetFirstSeenForTests(): void;

package/dist/chat/super-grouping/turn-timing.js

@@ -0,0 +1,110 @@
+import { MESSAGE_CREATED_AT_KEY, parseMessageTime } from "../message-time.js";
+import { ATHENA_RUN_MARKER_KEY } from "../../agent-runtime/src/messages.js";
+function record(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function readInstantMs(value) {
+  var _a;
+  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+    return value > 1e12 ? value : value * 1e3;
+  }
+  return ((_a = parseMessageTime(value)) == null ? void 0 : _a.getTime()) ?? null;
+}
+function sourceMetadata(message) {
+  var _a;
+  const kwargs = record((_a = record(message)) == null ? void 0 : _a.additional_kwargs);
+  return record(kwargs == null ? void 0 : kwargs.metadata) ?? kwargs;
+}
+function isRunMarker(message) {
+  var _a, _b;
+  return typeof ((_b = record((_a = record(message)) == null ? void 0 : _a.additional_kwargs)) == null ? void 0 : _b[ATHENA_RUN_MARKER_KEY]) === "string";
+}
+function readTurnTiming({ promptCreatedAt, custom, sourceMessages }) {
+  let endMs = null;
+  let firstStampMs = null;
+  let serverStartMs = null;
+  let serverDurationMs = null;
+  let afterMarker = false;
+  let continuedAtMs = null;
+  for (const message of sourceMessages) {
+    if (isRunMarker(message)) {
+      afterMarker = true;
+      continuedAtMs = null;
+      serverDurationMs = null;
+      continue;
+    }
+    const metadata = sourceMetadata(message);
+    const stamp = readInstantMs(metadata == null ? void 0 : metadata[MESSAGE_CREATED_AT_KEY]);
+    if (stamp !== null) {
+      firstStampMs ?? (firstStampMs = stamp);
+      if (afterMarker) continuedAtMs ?? (continuedAtMs = stamp);
+      endMs = endMs === null ? stamp : Math.max(endMs, stamp);
+    }
+    const duration = metadata == null ? void 0 : metadata.agent_duration_seconds;
+    if (typeof duration === "number" && Number.isFinite(duration) && duration > 0) {
+      serverDurationMs = duration * 1e3;
+      serverStartMs = readInstantMs(metadata == null ? void 0 : metadata.agent_start_time) ?? serverStartMs;
+    }
+  }
+  if (serverStartMs !== null && serverDurationMs !== null) {
+    const serverEnd = serverStartMs + serverDurationMs;
+    endMs = endMs === null ? serverEnd : Math.max(endMs, serverEnd);
+  }
+  const startMs = continuedAtMs ?? readInstantMs(promptCreatedAt) ?? serverStartMs ?? readInstantMs(custom == null ? void 0 : custom.agent_start_time) ?? readInstantMs(custom == null ? void 0 : custom.run_started_at) ?? readInstantMs(custom == null ? void 0 : custom[MESSAGE_CREATED_AT_KEY]) ?? firstStampMs;
+  return { startMs, endMs, serverDurationMs };
+}
+function workedDurationMs({ startMs, endMs, serverDurationMs }, observedEndMs = null) {
+  const observed = observedEndMs !== null && (endMs === null || observedEndMs - endMs <= MAX_OBSERVED_END_LAG_MS) ? observedEndMs : null;
+  const end = serverDurationMs !== null || observed === null ? endMs : endMs === null ? observed : Math.max(endMs, observed);
+  if (startMs !== null && end !== null && end >= startMs) {
+    return Math.max(end - startMs, serverDurationMs ?? 0);
+  }
+  return serverDurationMs;
+}
+const MAX_OBSERVED_END_LAG_MS = 10 * 60 * 1e3;
+function formatWorkDuration(ms) {
+  const totalSeconds = Math.max(0, Math.floor(ms / 1e3));
+  if (totalSeconds < 60) return `${totalSeconds}s`;
+  const totalMinutes = Math.floor(totalSeconds / 60);
+  if (totalMinutes < 60) return `${totalMinutes}m ${String(totalSeconds % 60).padStart(2, "0")}s`;
+  const hours = Math.floor(totalMinutes / 60);
+  return `${hours}h ${String(totalMinutes % 60).padStart(2, "0")}m`;
+}
+function workingLabel(elapsedMs) {
+  return elapsedMs < 1e3 ? "Working" : `Working for ${formatWorkDuration(elapsedMs)}`;
+}
+const MAX_FIRST_SEEN = 200;
+const firstSeen = /* @__PURE__ */ new Map();
+function firstSeenMs(key, now = Date.now()) {
+  const seen = firstSeen.get(key);
+  if (seen !== void 0) return seen;
+  firstSeen.set(key, now);
+  if (firstSeen.size > MAX_FIRST_SEEN) {
+    const oldest = firstSeen.keys().next().value;
+    if (oldest !== void 0) firstSeen.delete(oldest);
+  }
+  return now;
+}
+const observedEnds = /* @__PURE__ */ new Map();
+function recordObservedTurnEnd(key, now = Date.now()) {
+  observedEnds.set(key, now);
+  if (observedEnds.size > MAX_FIRST_SEEN) {
+    const oldest = observedEnds.keys().next().value;
+    if (oldest !== void 0) observedEnds.delete(oldest);
+  }
+  return now;
+}
+function observedTurnEndMs(key) {
+  return observedEnds.get(key) ?? null;
+}
+export {
+  firstSeenMs,
+  formatWorkDuration,
+  observedTurnEndMs,
+  readInstantMs,
+  readTurnTiming,
+  recordObservedTurnEnd,
+  workedDurationMs,
+  workingLabel
+};
+//# sourceMappingURL=turn-timing.js.map

package/dist/chat/super-grouping/turn-timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-timing.js","sources":["../../../src/chat/super-grouping/turn-timing.ts"],"sourcesContent":["/**\n * How long an assistant turn has been working, or worked — the grouped\n * transcript's \"Working for 1m 12s\" / \"Worked for 2m 30s\" header.\n *\n * Every clock here is a server stamp the runtime already writes: `_created_at`\n * on each message (`additional_kwargs.metadata`, surfaced as\n * `metadata.custom`), and on the turn's final assistant message the\n * turn-timing middleware's `agent_start_time` / `agent_duration_seconds`\n * (epoch seconds). The converter joins only the first assistant message's\n * metadata into the turn, so the end of the turn is read off the raw messages\n * bound to it. assistant-ui's own `createdAt` is when this client first saw the\n * message, so it is never used.\n */\nimport { ATHENA_RUN_MARKER_KEY } from '@athenaintel/agent-runtime';\nimport { MESSAGE_CREATED_AT_KEY, parseMessageTime } from '../message-time';\n\nexport interface TurnTiming {\n  /**\n   * When the turn started: the prompt's stamp, else the run's own start\n   * stamps. A turn that was stopped and then continued starts at its\n   * continuation, so the clock never counts the time it sat stopped.\n   */\n  startMs: number | null;\n  /** When the turn's last message was written, from the server's stamps. */\n  endMs: number | null;\n  /** The turn-timing middleware's duration, when the final message carries it. */\n  serverDurationMs: number | null;\n}\n\nexport interface TurnTimingSources {\n  /** `_created_at` of the user message this turn answers. */\n  promptCreatedAt: string | null | undefined;\n  /** The turn's joined `metadata.custom` (its first assistant message's). */\n  custom: Record<string, unknown> | undefined;\n  /** The raw messages bound to the turn (`getExternalStoreMessages`), oldest first. */\n  sourceMessages: readonly unknown[];\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\n/** An instant from an ISO stamp or epoch seconds (milliseconds past 1e12), else `null`. */\nexport function readInstantMs(value: unknown): number | null {\n  if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n    return value > 1e12 ? value : value * 1000;\n  }\n  return parseMessageTime(value)?.getTime() ?? null;\n}\n\nfunction sourceMetadata(message: unknown): Record<string, unknown> | undefined {\n  const kwargs = record(record(message)?.additional_kwargs);\n  return record(kwargs?.metadata) ?? kwargs;\n}\n\nfunction isRunMarker(message: unknown): boolean {\n  return typeof record(record(message)?.additional_kwargs)?.[ATHENA_RUN_MARKER_KEY] === 'string';\n}\n\n/** The turn's start, end and server-measured duration from the stamps it carries. */\nexport function readTurnTiming({ promptCreatedAt, custom, sourceMessages }: TurnTimingSources): TurnTiming {\n  let endMs: number | null = null;\n  let firstStampMs: number | null = null;\n  let serverStartMs: number | null = null;\n  let serverDurationMs: number | null = null;\n  let afterMarker = false;\n  let continuedAtMs: number | null = null;\n  for (const message of sourceMessages) {\n    if (isRunMarker(message)) {\n      afterMarker = true;\n      continuedAtMs = null;\n      serverDurationMs = null;\n      continue;\n    }\n    const metadata = sourceMetadata(message);\n    const stamp = readInstantMs(metadata?.[MESSAGE_CREATED_AT_KEY]);\n    if (stamp !== null) {\n      firstStampMs ??= stamp;\n      if (afterMarker) continuedAtMs ??= stamp;\n      endMs = endMs === null ? stamp : Math.max(endMs, stamp);\n    }\n    const duration = metadata?.agent_duration_seconds;\n    if (typeof duration === 'number' && Number.isFinite(duration) && duration > 0) {\n      serverDurationMs = duration * 1000;\n      serverStartMs = readInstantMs(metadata?.agent_start_time) ?? serverStartMs;\n    }\n  }\n  if (serverStartMs !== null && serverDurationMs !== null) {\n    const serverEnd = serverStartMs + serverDurationMs;\n    endMs = endMs === null ? serverEnd : Math.max(endMs, serverEnd);\n  }\n  // Without a prompt stamp the run's own server clock comes before any\n  // assistant stamp: the first assistant message is written after the turn\n  // has already been working (thinking, the first tool), so starting there\n  // would drop that time.\n  const startMs =\n    continuedAtMs ??\n    readInstantMs(promptCreatedAt) ??\n    serverStartMs ??\n    readInstantMs(custom?.agent_start_time) ??\n    readInstantMs(custom?.run_started_at) ??\n    readInstantMs(custom?.[MESSAGE_CREATED_AT_KEY]) ??\n    firstStampMs;\n  return { startMs, endMs, serverDurationMs };\n}\n\n/**\n * How long a finished turn worked: from its start to its end, else the\n * server-measured duration, else `null` (nothing truthful to show).\n *\n * The end is the server's own turn clock when the final message carries it.\n * The turn-timing stamp lands on that message only after it has streamed, so a\n * turn watched live can settle before the stamp reaches this client; the last\n * message's `_created_at` is then the start of the final answer, not its end,\n * and `observedEndMs` (when this client saw the turn settle) stands in for it.\n */\nexport function workedDurationMs(\n  { startMs, endMs, serverDurationMs }: TurnTiming,\n  observedEndMs: number | null = null,\n): number | null {\n  // A settle seen long after the last stamp is not this turn's end (a thread\n  // opened while its status was still catching up), so it is ignored.\n  const observed =\n    observedEndMs !== null && (endMs === null || observedEndMs - endMs <= MAX_OBSERVED_END_LAG_MS)\n      ? observedEndMs\n      : null;\n  const end =\n    serverDurationMs !== null || observed === null\n      ? endMs\n      : endMs === null\n        ? observed\n        : Math.max(endMs, observed);\n  // The server's own duration is a floor: a start read off a later stamp\n  // never shortens the turn below what the server measured.\n  if (startMs !== null && end !== null && end >= startMs) {\n    return Math.max(end - startMs, serverDurationMs ?? 0);\n  }\n  return serverDurationMs;\n}\n\n/** How far past its last stamp a turn may be seen to settle and still count as its end. */\nconst MAX_OBSERVED_END_LAG_MS = 10 * 60 * 1000;\n\n/** \"45s\", \"1m 12s\", \"1h 03m\". */\nexport function formatWorkDuration(ms: number): string {\n  const totalSeconds = Math.max(0, Math.floor(ms / 1000));\n  if (totalSeconds < 60) return `${totalSeconds}s`;\n  const totalMinutes = Math.floor(totalSeconds / 60);\n  if (totalMinutes < 60) return `${totalMinutes}m ${String(totalSeconds % 60).padStart(2, '0')}s`;\n  const hours = Math.floor(totalMinutes / 60);\n  return `${hours}h ${String(totalMinutes % 60).padStart(2, '0')}m`;\n}\n\n/** The live header: \"Working\" for the first second, then \"Working for 1m 12s\". */\nexport function workingLabel(elapsedMs: number): string {\n  return elapsedMs < 1000 ? 'Working' : `Working for ${formatWorkDuration(elapsedMs)}`;\n}\n\n/** The settled header: \"Worked for 2m 30s\", or `null` when the turn carries no usable stamps. */\nexport function workedLabel(timing: TurnTiming): string | null {\n  const worked = workedDurationMs(timing);\n  return worked === null ? null : `Worked for ${formatWorkDuration(worked)}`;\n}\n\nconst MAX_FIRST_SEEN = 200;\nconst firstSeen = new Map<string, number>();\n\n/**\n * The first time this client saw a turn, for a live clock with no server stamp\n * to anchor on yet (an optimistic prompt before the server echoes it). Keyed\n * per turn, so a later turn never inherits an earlier one's start; bounded.\n */\nexport function firstSeenMs(key: string, now = Date.now()): number {\n  const seen = firstSeen.get(key);\n  if (seen !== undefined) return seen;\n  firstSeen.set(key, now);\n  if (firstSeen.size > MAX_FIRST_SEEN) {\n    const oldest = firstSeen.keys().next().value;\n    if (oldest !== undefined) firstSeen.delete(oldest);\n  }\n  return now;\n}\n\nconst observedEnds = new Map<string, number>();\n\n/** Record that this client saw the turn `key` settle at `now`; returns the recorded instant. */\nexport function recordObservedTurnEnd(key: string, now = Date.now()): number {\n  observedEnds.set(key, now);\n  if (observedEnds.size > MAX_FIRST_SEEN) {\n    const oldest = observedEnds.keys().next().value;\n    if (oldest !== undefined) observedEnds.delete(oldest);\n  }\n  return now;\n}\n\n/** When this client saw the turn `key` settle, if it watched it do so. */\nexport function observedTurnEndMs(key: string): number | null {\n  return observedEnds.get(key) ?? null;\n}\n\nexport function resetFirstSeenForTests(): void {\n  firstSeen.clear();\n  observedEnds.clear();\n}\n"],"names":[],"mappings":"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"}

package/dist/chat/tiptap-text.cjs

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
 const chatMessageBody = require("../chat-ui/rich-text/chat-message-body.cjs");
-const streamingMarkdown = require("../packages/agent-runtime/src/streaming-markdown.cjs");
+const streamingMarkdown = require("../agent-runtime/src/streaming-markdown.cjs");
 const TiptapText = ({ text, status }) => {
   const isRunning = (status == null ? void 0 : status.type) === "running";
   return /* @__PURE__ */ jsxRuntime.jsx(

package/dist/chat/tiptap-text.js

@@ -1,6 +1,6 @@
 import { jsx } from "react/jsx-runtime";
 import { ChatMessageBody } from "../chat-ui/rich-text/chat-message-body.js";
-import { hideUnterminatedMarkdownLink } from "../packages/agent-runtime/src/streaming-markdown.js";
+import { hideUnterminatedMarkdownLink } from "../agent-runtime/src/streaming-markdown.js";
 const TiptapText = ({ text, status }) => {
   const isRunning = (status == null ? void 0 : status.type) === "running";
   return /* @__PURE__ */ jsx(

package/dist/chat/use-athena-run-live.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const react = require("@assistant-ui/react");
-const threadStatus = require("../packages/agent-runtime/src/thread-status.cjs");
+const threadStatus = require("../agent-runtime/src/thread-status.cjs");
 function useAthenaRunLive() {
   const connection = threadStatus.useDeepAgentConnection();
   return react.useAuiState((s) => threadStatus.readRunLive(s.thread, connection));

package/dist/chat/use-athena-run-live.js

@@ -1,5 +1,5 @@
 import { useAuiState } from "@assistant-ui/react";
-import { useDeepAgentConnection, readRunLive } from "../packages/agent-runtime/src/thread-status.js";
+import { useDeepAgentConnection, readRunLive } from "../agent-runtime/src/thread-status.js";
 function useAthenaRunLive() {
   const connection = useDeepAgentConnection();
   return useAuiState((s) => readRunLive(s.thread, connection));

package/dist/chat/use-statewire-approval-request.cjs

@@ -3,8 +3,46 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const reactStatewire = require("@assistant-ui/react-statewire");
 const react = require("react");
 const useAthenaRunLive = require("./use-athena-run-live.cjs");
-const interrupts = require("../packages/agent-runtime/src/interrupts.cjs");
+const interrupts = require("../agent-runtime/src/interrupts.cjs");
 const NO_QUEUED_LANE_DECISIONS = Object.freeze({});
+const NO_ACTION_REQUESTS = [];
+const answeredRequests = /* @__PURE__ */ new Map();
+const answeredListeners = /* @__PURE__ */ new Set();
+let answeredVersion = 0;
+function notifyAnswered() {
+  answeredVersion += 1;
+  for (const listener of answeredListeners) listener();
+}
+function recordAnswered(requestId, laneIds) {
+  answeredRequests.set(requestId, laneIds);
+  notifyAnswered();
+}
+function forgetAnswered(requestId) {
+  if (answeredRequests.delete(requestId)) notifyAnswered();
+}
+function subscribeAnswered(listener) {
+  answeredListeners.add(listener);
+  return () => {
+    answeredListeners.delete(listener);
+  };
+}
+const readAnsweredVersion = () => answeredVersion;
+function answeredLaneIds(value, actionRequests) {
+  const ids = interrupts.laneInterruptIds(actionRequests) ?? [];
+  if (typeof value === "object" && value !== null && "lane_decisions" in value) {
+    const lanes = value.lane_decisions;
+    if (typeof lanes === "object" && lanes !== null) {
+      for (const id of Object.keys(lanes)) if (!ids.includes(id)) ids.push(id);
+    }
+  }
+  return ids;
+}
+function mirrorAlreadyAnswered(answeredLanes, liveActionRequests) {
+  if (answeredLanes === void 0) return false;
+  const ids = interrupts.laneInterruptIds(liveActionRequests);
+  if (ids === null) return false;
+  return ids.every((id) => answeredLanes.includes(id));
+}
 function useStatewireApprovalRequest(options = {}) {
   var _a;
   const {
@@ -22,10 +60,32 @@ function useStatewireApprovalRequest(options = {}) {
   const actionRequests = react.useMemo(() => interrupts.pendingActionRequests(hitl), [hitl]);
   const isRunning = useAthenaRunLive.useAthenaRunLive();
   const mirror = reactStatewire.useStatewireState(interrupts.readInterruptMirror);
-  const liveHitl = request === void 0 && isRunning ? interrupts.asHitlApproval(interrupts.interruptMirrorPayload(mirror)) : null;
-  const liveActionRequests = react.useMemo(() => interrupts.pendingActionRequests(liveHitl), [liveHitl]);
+  const mirrorHitl = request === void 0 && isRunning ? interrupts.asHitlApproval(interrupts.interruptMirrorPayload(mirror)) : null;
+  const mirrorActionRequests = react.useMemo(() => interrupts.pendingActionRequests(mirrorHitl), [mirrorHitl]);
+  const lastRequestIdRef = react.useRef(void 0);
+  if (requestId !== void 0) lastRequestIdRef.current = requestId;
+  react.useSyncExternalStore(subscribeAnswered, readAnsweredVersion, readAnsweredVersion);
+  const answeredLanes = lastRequestIdRef.current === void 0 ? void 0 : answeredRequests.get(lastRequestIdRef.current);
+  const mirrorCleared = interrupts.interruptMirrorPayload(mirror) === void 0;
+  react.useEffect(() => {
+    if (requestId === void 0) return;
+    return () => {
+      if (lastRequestIdRef.current !== requestId) forgetAnswered(requestId);
+    };
+  }, [requestId]);
+  react.useEffect(() => {
+    if (mirrorCleared && lastRequestIdRef.current !== void 0) forgetAnswered(lastRequestIdRef.current);
+  }, [mirrorCleared]);
+  react.useEffect(
+    () => () => {
+      if (lastRequestIdRef.current !== void 0) forgetAnswered(lastRequestIdRef.current);
+    },
+    []
+  );
+  const liveHitl = mirrorAlreadyAnswered(answeredLanes, mirrorActionRequests) ? null : mirrorHitl;
+  const liveActionRequests = liveHitl === mirrorHitl ? mirrorActionRequests : NO_ACTION_REQUESTS;
   const queuedLaneDecisions = reactStatewire.useStatewireState(interrupts.readQueuedLaneDecisions) ?? NO_QUEUED_LANE_DECISIONS;
-  const { pending, resume } = interrupts.useApprovalResumeLock({
+  const { pending, resume: resumeLocked } = interrupts.useApprovalResumeLock({
     requestId,
     isRunning,
     pendingResumeGraceMs,
@@ -39,6 +99,15 @@ function useStatewireApprovalRequest(options = {}) {
       response: { type: "resume", value }
     })
   });
+  const resume = react.useCallback(
+    (value) => {
+      if (requestId !== void 0) {
+        recordAnswered(requestId, answeredLaneIds(value, actionRequests));
+      }
+      return resumeLocked(value);
+    },
+    [requestId, actionRequests, resumeLocked]
+  );
   const sendLaneDecisions = react.useCallback(
     (lanes) => requestId !== void 0 ? resume({ lane_decisions: lanes }) : sendCommand({ type: "run/lane-input", laneDecisions: lanes }),
     [requestId, resume, sendCommand]

package/dist/chat/use-statewire-approval-request.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-statewire-approval-request.cjs","sources":["../../src/chat/use-statewire-approval-request.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport {\n  useStatewireRuns,\n  useStatewireSendCommand,\n  useStatewireState,\n} from '@assistant-ui/react-statewire';\nimport {\n  type AbandonedInputRequest,\n  asHitlApproval,\n  findAbandonedInterrupt,\n  HITL_PENDING_RESUME_GRACE_MS,\n  type HitlApprovalPayload,\n  interruptMirrorPayload,\n  isApprovalCardInterrupt,\n  type PendingActionRequest,\n  pendingActionRequests,\n  readAbandonedInputRequests,\n  readInterruptMirror,\n  readQueuedLaneDecisions,\n  useApprovalResumeLock,\n} from '@athenaintel/agent-runtime';\nimport { useCallback, useMemo } from 'react';\nimport { useAthenaRunLive } from './use-athena-run-live';\n\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /**\n       * Decide per-dispatch subagent lanes while the parent run is still\n       * streaming (`DeepAgentThread.run_lane_input`). Keys are the lanes'\n       * langgraph interrupt ids; the host matches them against the lanes its\n       * mirrored interrupt currently parks, answers at once when the run is\n       * already parked, and otherwise holds them until it parks — stale or\n       * unknown ids are ignored, never carried to a later interrupt.\n       */\n      runLaneInput: {\n        readonly type: 'run/lane-input';\n        readonly laneDecisions: Readonly<Record<string, StatewireThread.InputResponse>>;\n      };\n      /**\n       * Re-send the lane decisions the host still holds queued as their\n       * approver's resume of the parked request (`DeepAgentThread.run_lane_replay`).\n       * The host resumes under the meta the approver's `run/lane-input`\n       * recorded and refuses any other caller — every attached client reads\n       * the same queue, and only the one that queued it may turn it into a\n       * resume. Carries no decisions: the host replays what it recorded.\n       */\n      runLaneReplay: {\n        readonly type: 'run/lane-replay';\n        readonly requestId: string;\n      };\n    }\n  }\n}\n\nconst NO_QUEUED_LANE_DECISIONS: Readonly<Record<string, unknown>> = Object.freeze({});\n\n/** Selects which pending interrupt an approval surface answers. */\nexport type StatewireInterruptPredicate = (\n  request: StatewireThread.InputRequestState,\n) => request is StatewireThread.CustomInputRequest;\n\nexport interface UseStatewireApprovalRequestOptions {\n  /**\n   * Which pending interrupt to answer. Defaults to `isApprovalCardInterrupt`\n   * (client-tool parks excluded — the client-tool bridge owns those, and a\n   * generic resume would corrupt the parked tool call).\n   */\n  interruptPredicate?: StatewireInterruptPredicate;\n  /**\n   * How long a sent decision keeps the actions locked when no resume run ever\n   * starts. Defaults to {@link HITL_PENDING_RESUME_GRACE_MS}.\n   */\n  pendingResumeGraceMs?: number;\n  /**\n   * The host refused the `run/input` (or the transport lost it): the\n   * optimistic fold rolls back, the request is on screen again with its\n   * actions re-enabled, and this is the surface's one chance to say why.\n   */\n  onResumeRejected?: (error: unknown, requestId: string) => void;\n  /** See {@link UseApprovalResumeLockOptions.onResumeRetry}. */\n  onResumeRetry?: (error: unknown, requestId: string, attempt: number) => void;\n}\n\nexport interface StatewireApprovalRequest<TValue> {\n  /** The pending interrupt this surface answers, if any. */\n  request: StatewireThread.CustomInputRequest | undefined;\n  requestId: string | undefined;\n  /** The payload narrowed to the Athena HITL approval shape, or `null`. */\n  hitl: HitlApprovalPayload | null;\n  /** Every gated call the approval covers, in decision order (empty for non-HITL parks). */\n  actionRequests: PendingActionRequest[];\n  /** An interrupt a non-resume dispatch dropped — the \"approval was cancelled\" notice. */\n  abandonedInterrupt: AbandonedInputRequest | undefined;\n  /**\n   * The mirrored interrupt's HITL payload while the run is still live and no\n   * input request is answerable: per-dispatch `task` lanes parked on their\n   * gates while sibling lanes stream. `null` once the run parks (the same\n   * lanes are then `hitl` / `actionRequests`) and when nothing is parked.\n   */\n  liveHitl: HitlApprovalPayload | null;\n  /** Every gated call `liveHitl` covers (empty when it is `null`). */\n  liveActionRequests: PendingActionRequest[];\n  /**\n   * The decisions the host already holds from a `run/lane-input`, keyed by\n   * langgraph interrupt id, to be answered when the run parks — a queued lane\n   * reads as decided on every attached client, not just the one that sent it.\n   */\n  queuedLaneDecisions: Readonly<Record<string, unknown>>;\n  /** True after a resume until the request identity changes (or recovery fires). */\n  pending: boolean;\n  /**\n   * Answer the request with `{ type: 'run/input', requestId, response: { type: 'resume', value } }`.\n   * Returns the dispatch promise (settles when the host accepts, rejects when\n   * it refuses), or `undefined` when the lock dropped the send.\n   */\n  resume: (value: TValue) => Promise<unknown> | undefined;\n  /**\n   * Decide per-dispatch lanes by langgraph interrupt id. With a pending\n   * request this is the native `lane_decisions` resume through the lock;\n   * without one (the run is still streaming siblings) it is `run/lane-input`,\n   * which the host queues and answers on the park. Returns the dispatch\n   * promise, or `undefined` when the lock dropped a resume.\n   */\n  sendLaneDecisions: (\n    lanes: Readonly<Record<string, StatewireThread.InputResponse>>,\n  ) => Promise<unknown> | undefined;\n  /**\n   * Ask the host to resume the parked `requestId` with the lane decisions it\n   * still holds queued, as their approver (`run/lane-replay`). For the card\n   * that queued them, after the host's own answerer has stayed silent past\n   * its budget; the host refuses every other caller. Settles when the host\n   * accepts, rejects when it refuses.\n   */\n  replayQueuedLanes: (requestId: string) => Promise<unknown>;\n}\n\n/**\n * The headless half of every statewire approval surface: selects the pending\n * interrupt from the runs projection, narrows its payload, reads the\n * host-published abandoned interrupts, and wires the shared optimistic resume\n * lock to the thread's `run/input` command. `StatewireApprovalCard` renders\n * over it; hosts with their own decision UI (per-lane subagent cards) build\n * on it directly so the selection and lock semantics cannot drift.\n *\n * Requires a statewire aui scope (throws outside one, like every\n * `useStatewire*` hook) — gate the mount with `hasStatewireThreadExtras`.\n */\nexport function useStatewireApprovalRequest<\n  TValue extends StatewireThread.InputResponse = Record<string, string>,\n>(options: UseStatewireApprovalRequestOptions = {}): StatewireApprovalRequest<TValue> {\n  const {\n    interruptPredicate = isApprovalCardInterrupt,\n    pendingResumeGraceMs = HITL_PENDING_RESUME_GRACE_MS,\n    onResumeRejected,\n    onResumeRetry,\n  } = options;\n  const sendCommand = useStatewireSendCommand();\n  // The runs projection is memoized by the lib, so this derivation is\n  // reference-stable between state updates.\n  const request = useStatewireRuns().inputRequests?.find(interruptPredicate);\n  const requestId = request?.id;\n\n  // The host publishes the interrupts a non-resume dispatch dropped. Select\n  // the raw array reference (pre-stream-safe) and derive inline; a `.find`\n  // selector would return a fresh object every update.\n  const abandoned = useStatewireState(readAbandonedInputRequests);\n  const abandonedInterrupt = findAbandonedInterrupt(abandoned);\n\n  const hitl = asHitlApproval(request?.payload);\n  const actionRequests = useMemo(() => pendingActionRequests(hitl), [hitl]);\n\n  const isRunning = useAthenaRunLive();\n  // The host mirrors the interrupt into state as soon as a lane parks — while\n  // the run manager still reports `running` (siblings streaming) and has no\n  // request to answer. Raw reference selectors; derive inline.\n  const mirror = useStatewireState(readInterruptMirror);\n  const liveHitl =\n    request === undefined && isRunning ? asHitlApproval(interruptMirrorPayload(mirror)) : null;\n  const liveActionRequests = useMemo(() => pendingActionRequests(liveHitl), [liveHitl]);\n  const queuedLaneDecisions =\n    useStatewireState(readQueuedLaneDecisions) ?? NO_QUEUED_LANE_DECISIONS;\n\n  const { pending, resume } = useApprovalResumeLock<TValue>({\n    requestId,\n    isRunning,\n    pendingResumeGraceMs,\n    onResumeRejected,\n    onResumeRetry,\n    // The dispatch promise is handed to the lock: a refusal releases it and\n    // reaches `onResumeRejected`.\n    sendResume: (id, value) =>\n      sendCommand({\n        type: 'run/input',\n        requestId: id,\n        response: { type: 'resume', value },\n      }),\n  });\n\n  const sendLaneDecisions = useCallback(\n    (lanes: Readonly<Record<string, StatewireThread.InputResponse>>) =>\n      requestId !== undefined\n        ? resume({ lane_decisions: lanes } as unknown as TValue)\n        : sendCommand({ type: 'run/lane-input', laneDecisions: lanes }),\n    [requestId, resume, sendCommand],\n  );\n\n  const replayQueuedLanes = useCallback(\n    (id: string) => sendCommand({ type: 'run/lane-replay', requestId: id }),\n    [sendCommand],\n  );\n\n  return {\n    request,\n    requestId,\n    hitl,\n    actionRequests,\n    liveHitl,\n    liveActionRequests,\n    queuedLaneDecisions,\n    abandonedInterrupt,\n    pending,\n    resume,\n    sendLaneDecisions,\n    replayQueuedLanes,\n  };\n}\n"],"names":["isApprovalCardInterrupt","HITL_PENDING_RESUME_GRACE_MS","useStatewireSendCommand","useStatewireRuns","useStatewireState","readAbandonedInputRequests","findAbandonedInterrupt","asHitlApproval","useMemo","pendingActionRequests","useAthenaRunLive","readInterruptMirror","interruptMirrorPayload","readQueuedLaneDecisions","useApprovalResumeLock","useCallback"],"mappings":";;;;;;AAuDA,MAAM,2BAA8D,OAAO,OAAO,EAAE;AA6F7E,SAAS,4BAEd,UAA8C,IAAsC;;AACpF,QAAM;AAAA,IACJ,qBAAqBA,WAAAA;AAAAA,IACrB,uBAAuBC,WAAAA;AAAAA,IACvB;AAAA,IACA;AAAA,EAAA,IACE;AACJ,QAAM,cAAcC,eAAAA,wBAAA;AAGpB,QAAM,WAAUC,oBAAAA,iBAAA,EAAmB,kBAAnBA,mBAAkC,KAAK;AACvD,QAAM,YAAY,mCAAS;AAK3B,QAAM,YAAYC,eAAAA,kBAAkBC,qCAA0B;AAC9D,QAAM,qBAAqBC,WAAAA,uBAAuB,SAAS;AAE3D,QAAM,OAAOC,WAAAA,eAAe,mCAAS,OAAO;AAC5C,QAAM,iBAAiBC,MAAAA,QAAQ,MAAMC,WAAAA,sBAAsB,IAAI,GAAG,CAAC,IAAI,CAAC;AAExE,QAAM,YAAYC,iBAAAA,iBAAA;AAIlB,QAAM,SAASN,eAAAA,kBAAkBO,8BAAmB;AACpD,QAAM,WACJ,YAAY,UAAa,YAAYJ,WAAAA,eAAeK,WAAAA,uBAAuB,MAAM,CAAC,IAAI;AACxF,QAAM,qBAAqBJ,MAAAA,QAAQ,MAAMC,WAAAA,sBAAsB,QAAQ,GAAG,CAAC,QAAQ,CAAC;AACpF,QAAM,sBACJL,eAAAA,kBAAkBS,WAAAA,uBAAuB,KAAK;AAEhD,QAAM,EAAE,SAAS,OAAA,IAAWC,iCAA8B;AAAA,IACxD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA;AAAA,IAGA,YAAY,CAAC,IAAI,UACf,YAAY;AAAA,MACV,MAAM;AAAA,MACN,WAAW;AAAA,MACX,UAAU,EAAE,MAAM,UAAU,MAAA;AAAA,IAAM,CACnC;AAAA,EAAA,CACJ;AAED,QAAM,oBAAoBC,MAAAA;AAAAA,IACxB,CAAC,UACC,cAAc,SACV,OAAO,EAAE,gBAAgB,MAAA,CAA4B,IACrD,YAAY,EAAE,MAAM,kBAAkB,eAAe,OAAO;AAAA,IAClE,CAAC,WAAW,QAAQ,WAAW;AAAA,EAAA;AAGjC,QAAM,oBAAoBA,MAAAA;AAAAA,IACxB,CAAC,OAAe,YAAY,EAAE,MAAM,mBAAmB,WAAW,IAAI;AAAA,IACtE,CAAC,WAAW;AAAA,EAAA;AAGd,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;;"}
+{"version":3,"file":"use-statewire-approval-request.cjs","sources":["../../src/chat/use-statewire-approval-request.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport {\n  useStatewireRuns,\n  useStatewireSendCommand,\n  useStatewireState,\n} from '@assistant-ui/react-statewire';\nimport {\n  type AbandonedInputRequest,\n  asHitlApproval,\n  findAbandonedInterrupt,\n  HITL_PENDING_RESUME_GRACE_MS,\n  type HitlApprovalPayload,\n  interruptMirrorPayload,\n  isApprovalCardInterrupt,\n  laneInterruptIds,\n  type PendingActionRequest,\n  pendingActionRequests,\n  readAbandonedInputRequests,\n  readInterruptMirror,\n  readQueuedLaneDecisions,\n  useApprovalResumeLock,\n} from '@athenaintel/agent-runtime';\nimport { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport { useAthenaRunLive } from './use-athena-run-live';\n\ndeclare module '@assistant-ui/core' {\n  namespace Assistant {\n    interface Commands {\n      /**\n       * Decide per-dispatch subagent lanes while the parent run is still\n       * streaming (`DeepAgentThread.run_lane_input`). Keys are the lanes'\n       * langgraph interrupt ids; the host matches them against the lanes its\n       * mirrored interrupt currently parks, answers at once when the run is\n       * already parked, and otherwise holds them until it parks — stale or\n       * unknown ids are ignored, never carried to a later interrupt.\n       */\n      runLaneInput: {\n        readonly type: 'run/lane-input';\n        readonly laneDecisions: Readonly<Record<string, StatewireThread.InputResponse>>;\n      };\n      /**\n       * Re-send the lane decisions the host still holds queued as their\n       * approver's resume of the parked request (`DeepAgentThread.run_lane_replay`).\n       * The host resumes under the meta the approver's `run/lane-input`\n       * recorded and refuses any other caller — every attached client reads\n       * the same queue, and only the one that queued it may turn it into a\n       * resume. Carries no decisions: the host replays what it recorded.\n       */\n      runLaneReplay: {\n        readonly type: 'run/lane-replay';\n        readonly requestId: string;\n      };\n    }\n  }\n}\n\nconst NO_QUEUED_LANE_DECISIONS: Readonly<Record<string, unknown>> = Object.freeze({});\nconst NO_ACTION_REQUESTS: PendingActionRequest[] = [];\n\n/**\n * Lane ids of the parked requests this client resumed, keyed by request id\n * and shared by every hook instance on the page (approval card,\n * waiting-on-you banner, host editors) so all of them treat a lingering\n * mirror the same way. Request ids are unique per parked interrupt, so an\n * instance only ever consults the record of the request it saw parked: two\n * chats mounted side by side cannot suppress or clear each other's. A record\n * is retired once the host drops that request's mirror (the resume run\n * started), the surface sees a different request park, or it unmounts.\n */\nconst answeredRequests = new Map<string, readonly string[]>();\nconst answeredListeners = new Set<() => void>();\nlet answeredVersion = 0;\nfunction notifyAnswered(): void {\n  answeredVersion += 1;\n  for (const listener of answeredListeners) listener();\n}\nfunction recordAnswered(requestId: string, laneIds: readonly string[]): void {\n  answeredRequests.set(requestId, laneIds);\n  notifyAnswered();\n}\nfunction forgetAnswered(requestId: string): void {\n  if (answeredRequests.delete(requestId)) notifyAnswered();\n}\nfunction subscribeAnswered(listener: () => void): () => void {\n  answeredListeners.add(listener);\n  return () => {\n    answeredListeners.delete(listener);\n  };\n}\nconst readAnsweredVersion = (): number => answeredVersion;\n\n/**\n * The lanes a resume of the parked request settles: every lane of the request\n * (a resume answers the whole park — lanes already queued through\n * `run/lane-input` ride along) plus any lane named in the `lane_decisions` map.\n */\nfunction answeredLaneIds(value: unknown, actionRequests: readonly PendingActionRequest[]): string[] {\n  const ids = laneInterruptIds(actionRequests) ?? [];\n  if (typeof value === 'object' && value !== null && 'lane_decisions' in value) {\n    const lanes = (value as { lane_decisions: unknown }).lane_decisions;\n    if (typeof lanes === 'object' && lanes !== null) {\n      for (const id of Object.keys(lanes)) if (!ids.includes(id)) ids.push(id);\n    }\n  }\n  return ids;\n}\n\n/**\n * Whether the host's mirror still shows an interrupt this client already\n * answered. After `run/input` the host drops the parked request at once but\n * keeps `__interrupt__` until the resume run starts and clears it (seconds on\n * a cold checkpoint); without this check the card would re-offer the SAME\n * approval from the mirror, buttons live, and then fold it away again.\n */\nfunction mirrorAlreadyAnswered(\n  answeredLanes: readonly string[] | undefined,\n  liveActionRequests: readonly PendingActionRequest[],\n): boolean {\n  if (answeredLanes === undefined) return false;\n  const ids = laneInterruptIds(liveActionRequests);\n  if (ids === null) return false;\n  return ids.every((id) => answeredLanes.includes(id));\n}\n\n/** Selects which pending interrupt an approval surface answers. */\nexport type StatewireInterruptPredicate = (\n  request: StatewireThread.InputRequestState,\n) => request is StatewireThread.CustomInputRequest;\n\nexport interface UseStatewireApprovalRequestOptions {\n  /**\n   * Which pending interrupt to answer. Defaults to `isApprovalCardInterrupt`\n   * (client-tool parks excluded — the client-tool bridge owns those, and a\n   * generic resume would corrupt the parked tool call).\n   */\n  interruptPredicate?: StatewireInterruptPredicate;\n  /**\n   * How long a sent decision keeps the actions locked when no resume run ever\n   * starts. Defaults to {@link HITL_PENDING_RESUME_GRACE_MS}.\n   */\n  pendingResumeGraceMs?: number;\n  /**\n   * The host refused the `run/input` (or the transport lost it): the\n   * optimistic fold rolls back, the request is on screen again with its\n   * actions re-enabled, and this is the surface's one chance to say why.\n   */\n  onResumeRejected?: (error: unknown, requestId: string) => void;\n  /** See {@link UseApprovalResumeLockOptions.onResumeRetry}. */\n  onResumeRetry?: (error: unknown, requestId: string, attempt: number) => void;\n}\n\nexport interface StatewireApprovalRequest<TValue> {\n  /** The pending interrupt this surface answers, if any. */\n  request: StatewireThread.CustomInputRequest | undefined;\n  requestId: string | undefined;\n  /** The payload narrowed to the Athena HITL approval shape, or `null`. */\n  hitl: HitlApprovalPayload | null;\n  /** Every gated call the approval covers, in decision order (empty for non-HITL parks). */\n  actionRequests: PendingActionRequest[];\n  /** An interrupt a non-resume dispatch dropped — the \"approval was cancelled\" notice. */\n  abandonedInterrupt: AbandonedInputRequest | undefined;\n  /**\n   * The mirrored interrupt's HITL payload while the run is still live and no\n   * input request is answerable: per-dispatch `task` lanes parked on their\n   * gates while sibling lanes stream. `null` once the run parks (the same\n   * lanes are then `hitl` / `actionRequests`) and when nothing is parked.\n   */\n  liveHitl: HitlApprovalPayload | null;\n  /** Every gated call `liveHitl` covers (empty when it is `null`). */\n  liveActionRequests: PendingActionRequest[];\n  /**\n   * The decisions the host already holds from a `run/lane-input`, keyed by\n   * langgraph interrupt id, to be answered when the run parks — a queued lane\n   * reads as decided on every attached client, not just the one that sent it.\n   */\n  queuedLaneDecisions: Readonly<Record<string, unknown>>;\n  /** True after a resume until the request identity changes (or recovery fires). */\n  pending: boolean;\n  /**\n   * Answer the request with `{ type: 'run/input', requestId, response: { type: 'resume', value } }`.\n   * Returns the dispatch promise (settles when the host accepts, rejects when\n   * it refuses), or `undefined` when the lock dropped the send.\n   */\n  resume: (value: TValue) => Promise<unknown> | undefined;\n  /**\n   * Decide per-dispatch lanes by langgraph interrupt id. With a pending\n   * request this is the native `lane_decisions` resume through the lock;\n   * without one (the run is still streaming siblings) it is `run/lane-input`,\n   * which the host queues and answers on the park. Returns the dispatch\n   * promise, or `undefined` when the lock dropped a resume.\n   */\n  sendLaneDecisions: (\n    lanes: Readonly<Record<string, StatewireThread.InputResponse>>,\n  ) => Promise<unknown> | undefined;\n  /**\n   * Ask the host to resume the parked `requestId` with the lane decisions it\n   * still holds queued, as their approver (`run/lane-replay`). For the card\n   * that queued them, after the host's own answerer has stayed silent past\n   * its budget; the host refuses every other caller. Settles when the host\n   * accepts, rejects when it refuses.\n   */\n  replayQueuedLanes: (requestId: string) => Promise<unknown>;\n}\n\n/**\n * The headless half of every statewire approval surface: selects the pending\n * interrupt from the runs projection, narrows its payload, reads the\n * host-published abandoned interrupts, and wires the shared optimistic resume\n * lock to the thread's `run/input` command. `StatewireApprovalCard` renders\n * over it; hosts with their own decision UI (per-lane subagent cards) build\n * on it directly so the selection and lock semantics cannot drift.\n *\n * Requires a statewire aui scope (throws outside one, like every\n * `useStatewire*` hook) — gate the mount with `hasStatewireThreadExtras`.\n */\nexport function useStatewireApprovalRequest<\n  TValue extends StatewireThread.InputResponse = Record<string, string>,\n>(options: UseStatewireApprovalRequestOptions = {}): StatewireApprovalRequest<TValue> {\n  const {\n    interruptPredicate = isApprovalCardInterrupt,\n    pendingResumeGraceMs = HITL_PENDING_RESUME_GRACE_MS,\n    onResumeRejected,\n    onResumeRetry,\n  } = options;\n  const sendCommand = useStatewireSendCommand();\n  // The runs projection is memoized by the lib, so this derivation is\n  // reference-stable between state updates.\n  const request = useStatewireRuns().inputRequests?.find(interruptPredicate);\n  const requestId = request?.id;\n\n  // The host publishes the interrupts a non-resume dispatch dropped. Select\n  // the raw array reference (pre-stream-safe) and derive inline; a `.find`\n  // selector would return a fresh object every update.\n  const abandoned = useStatewireState(readAbandonedInputRequests);\n  const abandonedInterrupt = findAbandonedInterrupt(abandoned);\n\n  const hitl = asHitlApproval(request?.payload);\n  const actionRequests = useMemo(() => pendingActionRequests(hitl), [hitl]);\n\n  const isRunning = useAthenaRunLive();\n  // The host mirrors the interrupt into state as soon as a lane parks — while\n  // the run manager still reports `running` (siblings streaming) and has no\n  // request to answer. Raw reference selectors; derive inline.\n  const mirror = useStatewireState(readInterruptMirror);\n  const mirrorHitl =\n    request === undefined && isRunning ? asHitlApproval(interruptMirrorPayload(mirror)) : null;\n  const mirrorActionRequests = useMemo(() => pendingActionRequests(mirrorHitl), [mirrorHitl]);\n\n  // The request this surface last saw parked: the only record it may read\n  // or retire (the mirror it watches is the one that request's resume clears).\n  const lastRequestIdRef = useRef<string>(undefined);\n  if (requestId !== undefined) lastRequestIdRef.current = requestId;\n  useSyncExternalStore(subscribeAnswered, readAnsweredVersion, readAnsweredVersion);\n  const answeredLanes =\n    lastRequestIdRef.current === undefined ? undefined : answeredRequests.get(lastRequestIdRef.current);\n  const mirrorCleared = interruptMirrorPayload(mirror) === undefined;\n  useEffect(() => {\n    if (requestId === undefined) return;\n    return () => {\n      // A different request parks next (or this one unparks for good): the\n      // record of this one is stale once it is not the one on screen.\n      if (lastRequestIdRef.current !== requestId) forgetAnswered(requestId);\n    };\n  }, [requestId]);\n  useEffect(() => {\n    if (mirrorCleared && lastRequestIdRef.current !== undefined) forgetAnswered(lastRequestIdRef.current);\n  }, [mirrorCleared]);\n  useEffect(\n    () => () => {\n      if (lastRequestIdRef.current !== undefined) forgetAnswered(lastRequestIdRef.current);\n    },\n    [],\n  );\n  const liveHitl = mirrorAlreadyAnswered(answeredLanes, mirrorActionRequests) ? null : mirrorHitl;\n  const liveActionRequests = liveHitl === mirrorHitl ? mirrorActionRequests : NO_ACTION_REQUESTS;\n  const queuedLaneDecisions =\n    useStatewireState(readQueuedLaneDecisions) ?? NO_QUEUED_LANE_DECISIONS;\n\n  const { pending, resume: resumeLocked } = useApprovalResumeLock<TValue>({\n    requestId,\n    isRunning,\n    pendingResumeGraceMs,\n    onResumeRejected,\n    onResumeRetry,\n    // The dispatch promise is handed to the lock: a refusal releases it and\n    // reaches `onResumeRejected`.\n    sendResume: (id, value) =>\n      sendCommand({\n        type: 'run/input',\n        requestId: id,\n        response: { type: 'resume', value },\n      }),\n  });\n\n  const resume = useCallback(\n    (value: TValue) => {\n      if (requestId !== undefined) {\n        recordAnswered(requestId, answeredLaneIds(value, actionRequests));\n      }\n      return resumeLocked(value);\n    },\n    [requestId, actionRequests, resumeLocked],\n  );\n\n  const sendLaneDecisions = useCallback(\n    (lanes: Readonly<Record<string, StatewireThread.InputResponse>>) =>\n      requestId !== undefined\n        ? resume({ lane_decisions: lanes } as unknown as TValue)\n        : sendCommand({ type: 'run/lane-input', laneDecisions: lanes }),\n    [requestId, resume, sendCommand],\n  );\n\n  const replayQueuedLanes = useCallback(\n    (id: string) => sendCommand({ type: 'run/lane-replay', requestId: id }),\n    [sendCommand],\n  );\n\n  return {\n    request,\n    requestId,\n    hitl,\n    actionRequests,\n    liveHitl,\n    liveActionRequests,\n    queuedLaneDecisions,\n    abandonedInterrupt,\n    pending,\n    resume,\n    sendLaneDecisions,\n    replayQueuedLanes,\n  };\n}\n"],"names":["laneInterruptIds","isApprovalCardInterrupt","HITL_PENDING_RESUME_GRACE_MS","useStatewireSendCommand","useStatewireRuns","useStatewireState","readAbandonedInputRequests","findAbandonedInterrupt","asHitlApproval","useMemo","pendingActionRequests","useAthenaRunLive","readInterruptMirror","interruptMirrorPayload","useRef","useSyncExternalStore","useEffect","readQueuedLaneDecisions","useApprovalResumeLock","useCallback"],"mappings":";;;;;;AAwDA,MAAM,2BAA8D,OAAO,OAAO,EAAE;AACpF,MAAM,qBAA6C,CAAA;AAYnD,MAAM,uCAAuB,IAAA;AAC7B,MAAM,wCAAwB,IAAA;AAC9B,IAAI,kBAAkB;AACtB,SAAS,iBAAuB;AAC9B,qBAAmB;AACnB,aAAW,YAAY,kBAAmB,UAAA;AAC5C;AACA,SAAS,eAAe,WAAmB,SAAkC;AAC3E,mBAAiB,IAAI,WAAW,OAAO;AACvC,iBAAA;AACF;AACA,SAAS,eAAe,WAAyB;AAC/C,MAAI,iBAAiB,OAAO,SAAS,EAAG,gBAAA;AAC1C;AACA,SAAS,kBAAkB,UAAkC;AAC3D,oBAAkB,IAAI,QAAQ;AAC9B,SAAO,MAAM;AACX,sBAAkB,OAAO,QAAQ;AAAA,EACnC;AACF;AACA,MAAM,sBAAsB,MAAc;AAO1C,SAAS,gBAAgB,OAAgB,gBAA2D;AAClG,QAAM,MAAMA,WAAAA,iBAAiB,cAAc,KAAK,CAAA;AAChD,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,oBAAoB,OAAO;AAC5E,UAAM,QAAS,MAAsC;AACrD,QAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,iBAAW,MAAM,OAAO,KAAK,KAAK,EAAG,KAAI,CAAC,IAAI,SAAS,EAAE,EAAG,KAAI,KAAK,EAAE;AAAA,IACzE;AAAA,EACF;AACA,SAAO;AACT;AASA,SAAS,sBACP,eACA,oBACS;AACT,MAAI,kBAAkB,OAAW,QAAO;AACxC,QAAM,MAAMA,WAAAA,iBAAiB,kBAAkB;AAC/C,MAAI,QAAQ,KAAM,QAAO;AACzB,SAAO,IAAI,MAAM,CAAC,OAAO,cAAc,SAAS,EAAE,CAAC;AACrD;AA6FO,SAAS,4BAEd,UAA8C,IAAsC;;AACpF,QAAM;AAAA,IACJ,qBAAqBC,WAAAA;AAAAA,IACrB,uBAAuBC,WAAAA;AAAAA,IACvB;AAAA,IACA;AAAA,EAAA,IACE;AACJ,QAAM,cAAcC,eAAAA,wBAAA;AAGpB,QAAM,WAAUC,oBAAAA,iBAAA,EAAmB,kBAAnBA,mBAAkC,KAAK;AACvD,QAAM,YAAY,mCAAS;AAK3B,QAAM,YAAYC,eAAAA,kBAAkBC,qCAA0B;AAC9D,QAAM,qBAAqBC,WAAAA,uBAAuB,SAAS;AAE3D,QAAM,OAAOC,WAAAA,eAAe,mCAAS,OAAO;AAC5C,QAAM,iBAAiBC,MAAAA,QAAQ,MAAMC,WAAAA,sBAAsB,IAAI,GAAG,CAAC,IAAI,CAAC;AAExE,QAAM,YAAYC,iBAAAA,iBAAA;AAIlB,QAAM,SAASN,eAAAA,kBAAkBO,8BAAmB;AACpD,QAAM,aACJ,YAAY,UAAa,YAAYJ,WAAAA,eAAeK,WAAAA,uBAAuB,MAAM,CAAC,IAAI;AACxF,QAAM,uBAAuBJ,MAAAA,QAAQ,MAAMC,WAAAA,sBAAsB,UAAU,GAAG,CAAC,UAAU,CAAC;AAI1F,QAAM,mBAAmBI,MAAAA,OAAe,MAAS;AACjD,MAAI,cAAc,OAAW,kBAAiB,UAAU;AACxDC,6BAAqB,mBAAmB,qBAAqB,mBAAmB;AAChF,QAAM,gBACJ,iBAAiB,YAAY,SAAY,SAAY,iBAAiB,IAAI,iBAAiB,OAAO;AACpG,QAAM,gBAAgBF,WAAAA,uBAAuB,MAAM,MAAM;AACzDG,QAAAA,UAAU,MAAM;AACd,QAAI,cAAc,OAAW;AAC7B,WAAO,MAAM;AAGX,UAAI,iBAAiB,YAAY,UAAW,gBAAe,SAAS;AAAA,IACtE;AAAA,EACF,GAAG,CAAC,SAAS,CAAC;AACdA,QAAAA,UAAU,MAAM;AACd,QAAI,iBAAiB,iBAAiB,YAAY,OAAW,gBAAe,iBAAiB,OAAO;AAAA,EACtG,GAAG,CAAC,aAAa,CAAC;AAClBA,QAAAA;AAAAA,IACE,MAAM,MAAM;AACV,UAAI,iBAAiB,YAAY,OAAW,gBAAe,iBAAiB,OAAO;AAAA,IACrF;AAAA,IACA,CAAA;AAAA,EAAC;AAEH,QAAM,WAAW,sBAAsB,eAAe,oBAAoB,IAAI,OAAO;AACrF,QAAM,qBAAqB,aAAa,aAAa,uBAAuB;AAC5E,QAAM,sBACJX,eAAAA,kBAAkBY,WAAAA,uBAAuB,KAAK;AAEhD,QAAM,EAAE,SAAS,QAAQ,aAAA,IAAiBC,WAAAA,sBAA8B;AAAA,IACtE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA;AAAA,IAGA,YAAY,CAAC,IAAI,UACf,YAAY;AAAA,MACV,MAAM;AAAA,MACN,WAAW;AAAA,MACX,UAAU,EAAE,MAAM,UAAU,MAAA;AAAA,IAAM,CACnC;AAAA,EAAA,CACJ;AAED,QAAM,SAASC,MAAAA;AAAAA,IACb,CAAC,UAAkB;AACjB,UAAI,cAAc,QAAW;AAC3B,uBAAe,WAAW,gBAAgB,OAAO,cAAc,CAAC;AAAA,MAClE;AACA,aAAO,aAAa,KAAK;AAAA,IAC3B;AAAA,IACA,CAAC,WAAW,gBAAgB,YAAY;AAAA,EAAA;AAG1C,QAAM,oBAAoBA,MAAAA;AAAAA,IACxB,CAAC,UACC,cAAc,SACV,OAAO,EAAE,gBAAgB,MAAA,CAA4B,IACrD,YAAY,EAAE,MAAM,kBAAkB,eAAe,OAAO;AAAA,IAClE,CAAC,WAAW,QAAQ,WAAW;AAAA,EAAA;AAGjC,QAAM,oBAAoBA,MAAAA;AAAAA,IACxB,CAAC,OAAe,YAAY,EAAE,MAAM,mBAAmB,WAAW,IAAI;AAAA,IACtE,CAAC,WAAW;AAAA,EAAA;AAGd,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;;"}

package/dist/chat/use-statewire-approval-request.js

@@ -1,8 +1,46 @@
 import { useStatewireSendCommand, useStatewireRuns, useStatewireState } from "@assistant-ui/react-statewire";
-import { useMemo, useCallback } from "react";
+import { useMemo, useRef, useSyncExternalStore, useEffect, useCallback } from "react";
 import { useAthenaRunLive } from "./use-athena-run-live.js";
-import { isApprovalCardInterrupt, HITL_PENDING_RESUME_GRACE_MS, readAbandonedInputRequests, findAbandonedInterrupt, asHitlApproval, pendingActionRequests, readInterruptMirror, interruptMirrorPayload, readQueuedLaneDecisions, useApprovalResumeLock } from "../packages/agent-runtime/src/interrupts.js";
+import { isApprovalCardInterrupt, HITL_PENDING_RESUME_GRACE_MS, readAbandonedInputRequests, findAbandonedInterrupt, asHitlApproval, pendingActionRequests, readInterruptMirror, interruptMirrorPayload, readQueuedLaneDecisions, useApprovalResumeLock, laneInterruptIds } from "../agent-runtime/src/interrupts.js";
 const NO_QUEUED_LANE_DECISIONS = Object.freeze({});
+const NO_ACTION_REQUESTS = [];
+const answeredRequests = /* @__PURE__ */ new Map();
+const answeredListeners = /* @__PURE__ */ new Set();
+let answeredVersion = 0;
+function notifyAnswered() {
+  answeredVersion += 1;
+  for (const listener of answeredListeners) listener();
+}
+function recordAnswered(requestId, laneIds) {
+  answeredRequests.set(requestId, laneIds);
+  notifyAnswered();
+}
+function forgetAnswered(requestId) {
+  if (answeredRequests.delete(requestId)) notifyAnswered();
+}
+function subscribeAnswered(listener) {
+  answeredListeners.add(listener);
+  return () => {
+    answeredListeners.delete(listener);
+  };
+}
+const readAnsweredVersion = () => answeredVersion;
+function answeredLaneIds(value, actionRequests) {
+  const ids = laneInterruptIds(actionRequests) ?? [];
+  if (typeof value === "object" && value !== null && "lane_decisions" in value) {
+    const lanes = value.lane_decisions;
+    if (typeof lanes === "object" && lanes !== null) {
+      for (const id of Object.keys(lanes)) if (!ids.includes(id)) ids.push(id);
+    }
+  }
+  return ids;
+}
+function mirrorAlreadyAnswered(answeredLanes, liveActionRequests) {
+  if (answeredLanes === void 0) return false;
+  const ids = laneInterruptIds(liveActionRequests);
+  if (ids === null) return false;
+  return ids.every((id) => answeredLanes.includes(id));
+}
 function useStatewireApprovalRequest(options = {}) {
   var _a;
   const {
@@ -20,10 +58,32 @@ function useStatewireApprovalRequest(options = {}) {
   const actionRequests = useMemo(() => pendingActionRequests(hitl), [hitl]);
   const isRunning = useAthenaRunLive();
   const mirror = useStatewireState(readInterruptMirror);
-  const liveHitl = request === void 0 && isRunning ? asHitlApproval(interruptMirrorPayload(mirror)) : null;
-  const liveActionRequests = useMemo(() => pendingActionRequests(liveHitl), [liveHitl]);
+  const mirrorHitl = request === void 0 && isRunning ? asHitlApproval(interruptMirrorPayload(mirror)) : null;
+  const mirrorActionRequests = useMemo(() => pendingActionRequests(mirrorHitl), [mirrorHitl]);
+  const lastRequestIdRef = useRef(void 0);
+  if (requestId !== void 0) lastRequestIdRef.current = requestId;
+  useSyncExternalStore(subscribeAnswered, readAnsweredVersion, readAnsweredVersion);
+  const answeredLanes = lastRequestIdRef.current === void 0 ? void 0 : answeredRequests.get(lastRequestIdRef.current);
+  const mirrorCleared = interruptMirrorPayload(mirror) === void 0;
+  useEffect(() => {
+    if (requestId === void 0) return;
+    return () => {
+      if (lastRequestIdRef.current !== requestId) forgetAnswered(requestId);
+    };
+  }, [requestId]);
+  useEffect(() => {
+    if (mirrorCleared && lastRequestIdRef.current !== void 0) forgetAnswered(lastRequestIdRef.current);
+  }, [mirrorCleared]);
+  useEffect(
+    () => () => {
+      if (lastRequestIdRef.current !== void 0) forgetAnswered(lastRequestIdRef.current);
+    },
+    []
+  );
+  const liveHitl = mirrorAlreadyAnswered(answeredLanes, mirrorActionRequests) ? null : mirrorHitl;
+  const liveActionRequests = liveHitl === mirrorHitl ? mirrorActionRequests : NO_ACTION_REQUESTS;
   const queuedLaneDecisions = useStatewireState(readQueuedLaneDecisions) ?? NO_QUEUED_LANE_DECISIONS;
-  const { pending, resume } = useApprovalResumeLock({
+  const { pending, resume: resumeLocked } = useApprovalResumeLock({
     requestId,
     isRunning,
     pendingResumeGraceMs,
@@ -37,6 +97,15 @@ function useStatewireApprovalRequest(options = {}) {
       response: { type: "resume", value }
     })
   });
+  const resume = useCallback(
+    (value) => {
+      if (requestId !== void 0) {
+        recordAnswered(requestId, answeredLaneIds(value, actionRequests));
+      }
+      return resumeLocked(value);
+    },
+    [requestId, actionRequests, resumeLocked]
+  );
   const sendLaneDecisions = useCallback(
     (lanes) => requestId !== void 0 ? resume({ lane_decisions: lanes }) : sendCommand({ type: "run/lane-input", laneDecisions: lanes }),
     [requestId, resume, sendCommand]