@athenaintel/react 0.18.0 → 0.20.0

package/dist/packages/agent-runtime/src/thread-extras.cjs

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function hasStatewireThreadExtras(extras) {
+  if (!extras || typeof extras !== "object") return false;
+  const candidate = extras;
+  return typeof candidate.sendCommand === "function" && Array.isArray(candidate.inputRequests) && typeof candidate.runs === "object" && candidate.runs !== null;
+}
+function isFailedSendEntry(value) {
+  var _a;
+  if (!value || typeof value !== "object") return false;
+  const entry = value;
+  return typeof entry.id === "string" && typeof ((_a = entry.sendFailure) == null ? void 0 : _a.fate) === "string";
+}
+function readStatewireFailedSendLane(extras) {
+  var _a;
+  if (!extras || typeof extras !== "object") return null;
+  const candidate = extras;
+  const failed = (_a = candidate.runs) == null ? void 0 : _a.failed;
+  if (!Array.isArray(failed) || typeof candidate.retryFailed !== "function") return null;
+  return {
+    failed: failed.filter(isFailedSendEntry),
+    retryFailed: candidate.retryFailed
+  };
+}
+function requireStatewireFailedActions(extras) {
+  if (!extras || typeof extras !== "object") {
+    throw new Error("Failed-send actions require a Statewire thread");
+  }
+  const candidate = extras;
+  if (typeof candidate.retryFailed !== "function" || typeof candidate.discardFailed !== "function") {
+    throw new Error("Failed-send actions require a Statewire thread");
+  }
+  return candidate;
+}
+exports.hasStatewireThreadExtras = hasStatewireThreadExtras;
+exports.readStatewireFailedSendLane = readStatewireFailedSendLane;
+exports.requireStatewireFailedActions = requireStatewireFailedActions;
+//# sourceMappingURL=thread-extras.cjs.map

package/dist/packages/agent-runtime/src/thread-extras.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-extras.cjs","sources":["../../../../../agent-runtime/src/thread-extras.ts"],"sourcesContent":["/**\n * The statewire hooks read the NEAREST aui thread's extras and throw when those\n * aren't statewire extras — which is the case inside nested read-only runtimes\n * (e.g. a transcript drawer) and on legacy (non-statewire) threads. Duck-type\n * the pieces the statewire components actually consume; a wider shape check\n * would silently hide live affordances if the library ever drops an unrelated\n * field.\n */\nexport function hasStatewireThreadExtras(extras: unknown): boolean {\n  if (!extras || typeof extras !== 'object') return false;\n  const candidate = extras as Record<string, unknown>;\n  return (\n    typeof candidate.sendCommand === 'function' &&\n    Array.isArray(candidate.inputRequests) &&\n    typeof candidate.runs === 'object' &&\n    candidate.runs !== null\n  );\n}\n\nexport interface StatewireFailedActions {\n  retryFailed: (messageId: string) => void;\n  discardFailed: (messageId: string) => void;\n}\n\n/** One projected failed run send: the message id plus the failure that\n * retained it (`runs.failed` entry, structurally). */\nexport interface StatewireFailedSendEntry {\n  id: string;\n  sendFailure: {\n    fate: string;\n    /**\n     * Set on an `aborted` send that was never attempted because an earlier\n     * send in the same detach batch WAS attempted and settled `lost`: the\n     * library cannot know whether that predecessor ran, so the successor\n     * must not be re-dispatched ahead of it (`StatewireClient.SendFailure`).\n     */\n    predecessorLost?: boolean;\n  };\n}\n\n/** The failed-send lane surface the send-recovery controller consumes. */\nexport interface StatewireFailedSendLane {\n  failed: readonly StatewireFailedSendEntry[];\n  /** Re-dispatches the entry against the current thread — same message id,\n   * re-anchored — and removes it from the lane. Throws for unknown ids. */\n  retryFailed: (messageId: string) => void;\n}\n\nfunction isFailedSendEntry(value: unknown): value is StatewireFailedSendEntry {\n  if (!value || typeof value !== 'object') return false;\n  const entry = value as { id?: unknown; sendFailure?: { fate?: unknown } };\n  return typeof entry.id === 'string' && typeof entry.sendFailure?.fate === 'string';\n}\n\n/**\n * The failed-send lane off a statewire thread's extras, or `null` when the\n * extras are not a statewire thread's (nested read-only runtimes, legacy\n * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.\n */\nexport function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null {\n  if (!extras || typeof extras !== 'object') return null;\n  const candidate = extras as {\n    runs?: { failed?: unknown };\n    retryFailed?: unknown;\n  };\n  const failed = candidate.runs?.failed;\n  if (!Array.isArray(failed) || typeof candidate.retryFailed !== 'function') return null;\n  return {\n    failed: failed.filter(isFailedSendEntry),\n    retryFailed: candidate.retryFailed as StatewireFailedSendLane['retryFailed'],\n  };\n}\n\n/** The failed-send lane actions off a statewire thread's extras, or throw. */\nexport function requireStatewireFailedActions(extras: unknown): StatewireFailedActions {\n  if (!extras || typeof extras !== 'object') {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  const candidate = extras as Record<string, unknown>;\n  if (\n    typeof candidate.retryFailed !== 'function' ||\n    typeof candidate.discardFailed !== 'function'\n  ) {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  return candidate as unknown as StatewireFailedActions;\n}\n"],"names":[],"mappings":";;AAQO,SAAS,yBAAyB,QAA0B;AACjE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,gBAAgB,cACjC,MAAM,QAAQ,UAAU,aAAa,KACrC,OAAO,UAAU,SAAS,YAC1B,UAAU,SAAS;AAEvB;AA+BA,SAAS,kBAAkB,OAAmD;;AAC5E,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,QAAQ;AACd,SAAO,OAAO,MAAM,OAAO,YAAY,SAAO,WAAM,gBAAN,mBAAmB,UAAS;AAC5E;AAOO,SAAS,4BAA4B,QAAiD;;AAC3F,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAIlB,QAAM,UAAS,eAAU,SAAV,mBAAgB;AAC/B,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,UAAU,gBAAgB,WAAY,QAAO;AAClF,SAAO;AAAA,IACL,QAAQ,OAAO,OAAO,iBAAiB;AAAA,IACvC,aAAa,UAAU;AAAA,EAAA;AAE3B;AAGO,SAAS,8BAA8B,QAAyC;AACrF,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,QAAM,YAAY;AAClB,MACE,OAAO,UAAU,gBAAgB,cACjC,OAAO,UAAU,kBAAkB,YACnC;AACA,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;;;;"}

package/dist/packages/agent-runtime/src/thread-extras.js

@@ -0,0 +1,38 @@
+function hasStatewireThreadExtras(extras) {
+  if (!extras || typeof extras !== "object") return false;
+  const candidate = extras;
+  return typeof candidate.sendCommand === "function" && Array.isArray(candidate.inputRequests) && typeof candidate.runs === "object" && candidate.runs !== null;
+}
+function isFailedSendEntry(value) {
+  var _a;
+  if (!value || typeof value !== "object") return false;
+  const entry = value;
+  return typeof entry.id === "string" && typeof ((_a = entry.sendFailure) == null ? void 0 : _a.fate) === "string";
+}
+function readStatewireFailedSendLane(extras) {
+  var _a;
+  if (!extras || typeof extras !== "object") return null;
+  const candidate = extras;
+  const failed = (_a = candidate.runs) == null ? void 0 : _a.failed;
+  if (!Array.isArray(failed) || typeof candidate.retryFailed !== "function") return null;
+  return {
+    failed: failed.filter(isFailedSendEntry),
+    retryFailed: candidate.retryFailed
+  };
+}
+function requireStatewireFailedActions(extras) {
+  if (!extras || typeof extras !== "object") {
+    throw new Error("Failed-send actions require a Statewire thread");
+  }
+  const candidate = extras;
+  if (typeof candidate.retryFailed !== "function" || typeof candidate.discardFailed !== "function") {
+    throw new Error("Failed-send actions require a Statewire thread");
+  }
+  return candidate;
+}
+export {
+  hasStatewireThreadExtras,
+  readStatewireFailedSendLane,
+  requireStatewireFailedActions
+};
+//# sourceMappingURL=thread-extras.js.map

package/dist/packages/agent-runtime/src/thread-extras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-extras.js","sources":["../../../../../agent-runtime/src/thread-extras.ts"],"sourcesContent":["/**\n * The statewire hooks read the NEAREST aui thread's extras and throw when those\n * aren't statewire extras — which is the case inside nested read-only runtimes\n * (e.g. a transcript drawer) and on legacy (non-statewire) threads. Duck-type\n * the pieces the statewire components actually consume; a wider shape check\n * would silently hide live affordances if the library ever drops an unrelated\n * field.\n */\nexport function hasStatewireThreadExtras(extras: unknown): boolean {\n  if (!extras || typeof extras !== 'object') return false;\n  const candidate = extras as Record<string, unknown>;\n  return (\n    typeof candidate.sendCommand === 'function' &&\n    Array.isArray(candidate.inputRequests) &&\n    typeof candidate.runs === 'object' &&\n    candidate.runs !== null\n  );\n}\n\nexport interface StatewireFailedActions {\n  retryFailed: (messageId: string) => void;\n  discardFailed: (messageId: string) => void;\n}\n\n/** One projected failed run send: the message id plus the failure that\n * retained it (`runs.failed` entry, structurally). */\nexport interface StatewireFailedSendEntry {\n  id: string;\n  sendFailure: {\n    fate: string;\n    /**\n     * Set on an `aborted` send that was never attempted because an earlier\n     * send in the same detach batch WAS attempted and settled `lost`: the\n     * library cannot know whether that predecessor ran, so the successor\n     * must not be re-dispatched ahead of it (`StatewireClient.SendFailure`).\n     */\n    predecessorLost?: boolean;\n  };\n}\n\n/** The failed-send lane surface the send-recovery controller consumes. */\nexport interface StatewireFailedSendLane {\n  failed: readonly StatewireFailedSendEntry[];\n  /** Re-dispatches the entry against the current thread — same message id,\n   * re-anchored — and removes it from the lane. Throws for unknown ids. */\n  retryFailed: (messageId: string) => void;\n}\n\nfunction isFailedSendEntry(value: unknown): value is StatewireFailedSendEntry {\n  if (!value || typeof value !== 'object') return false;\n  const entry = value as { id?: unknown; sendFailure?: { fate?: unknown } };\n  return typeof entry.id === 'string' && typeof entry.sendFailure?.fate === 'string';\n}\n\n/**\n * The failed-send lane off a statewire thread's extras, or `null` when the\n * extras are not a statewire thread's (nested read-only runtimes, legacy\n * threads) — same duck-typing posture as {@link hasStatewireThreadExtras}.\n */\nexport function readStatewireFailedSendLane(extras: unknown): StatewireFailedSendLane | null {\n  if (!extras || typeof extras !== 'object') return null;\n  const candidate = extras as {\n    runs?: { failed?: unknown };\n    retryFailed?: unknown;\n  };\n  const failed = candidate.runs?.failed;\n  if (!Array.isArray(failed) || typeof candidate.retryFailed !== 'function') return null;\n  return {\n    failed: failed.filter(isFailedSendEntry),\n    retryFailed: candidate.retryFailed as StatewireFailedSendLane['retryFailed'],\n  };\n}\n\n/** The failed-send lane actions off a statewire thread's extras, or throw. */\nexport function requireStatewireFailedActions(extras: unknown): StatewireFailedActions {\n  if (!extras || typeof extras !== 'object') {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  const candidate = extras as Record<string, unknown>;\n  if (\n    typeof candidate.retryFailed !== 'function' ||\n    typeof candidate.discardFailed !== 'function'\n  ) {\n    throw new Error('Failed-send actions require a Statewire thread');\n  }\n  return candidate as unknown as StatewireFailedActions;\n}\n"],"names":[],"mappings":"AAQO,SAAS,yBAAyB,QAA0B;AACjE,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,gBAAgB,cACjC,MAAM,QAAQ,UAAU,aAAa,KACrC,OAAO,UAAU,SAAS,YAC1B,UAAU,SAAS;AAEvB;AA+BA,SAAS,kBAAkB,OAAmD;AAxCvE;AAyCL,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,QAAQ;AACd,SAAO,OAAO,MAAM,OAAO,YAAY,SAAO,WAAM,gBAAN,mBAAmB,UAAS;AAC5E;AAOO,SAAS,4BAA4B,QAAiD;AAnDtF;AAoDL,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAIlB,QAAM,UAAS,eAAU,SAAV,mBAAgB;AAC/B,MAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,UAAU,gBAAgB,WAAY,QAAO;AAClF,SAAO;AAAA,IACL,QAAQ,OAAO,OAAO,iBAAiB;AAAA,IACvC,aAAa,UAAU;AAAA,EAAA;AAE3B;AAGO,SAAS,8BAA8B,QAAyC;AACrF,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,QAAM,YAAY;AAClB,MACE,OAAO,UAAU,gBAAgB,cACjC,OAAO,UAAU,kBAAkB,YACnC;AACA,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AACA,SAAO;AACT;"}

package/dist/packages/agent-runtime/src/thread-snapshot-cache.cjs

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEFAULT_MAX_THREADS = 30;
+const DEFAULT_MAX_AGE_MS = 60 * 60 * 1e3;
+function createDeepAgentThreadSnapshotCache(options = {}) {
+  const maxThreads = options.maxThreads ?? DEFAULT_MAX_THREADS;
+  const maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
+  const now = options.now ?? (() => Date.now());
+  const notify = (change) => {
+    var _a;
+    try {
+      (_a = options.onChange) == null ? void 0 : _a.call(options, change);
+    } catch {
+    }
+  };
+  const entries = /* @__PURE__ */ new Map();
+  const evict = () => {
+    while (entries.size > maxThreads) {
+      const oldest = entries.keys().next().value;
+      if (oldest === void 0) break;
+      entries.delete(oldest);
+    }
+  };
+  const fresh = (threadId) => {
+    const entry = entries.get(threadId);
+    if (!entry) return void 0;
+    if (now() - entry.at > maxAgeMs) {
+      entries.delete(threadId);
+      return void 0;
+    }
+    return entry;
+  };
+  return {
+    remember(threadId, state) {
+      const at = now();
+      entries.delete(threadId);
+      entries.set(threadId, { state, at });
+      evict();
+      notify({ type: "remember", threadId, state, at });
+    },
+    take(threadId) {
+      var _a;
+      return (_a = fresh(threadId)) == null ? void 0 : _a.state;
+    },
+    peek(threadId) {
+      return fresh(threadId) !== void 0;
+    },
+    restore(threadId, state, at) {
+      if (now() - at > maxAgeMs) return;
+      const existing = entries.get(threadId);
+      if (existing && existing.at >= at) return;
+      entries.delete(threadId);
+      entries.set(threadId, { state, at });
+      evict();
+    },
+    forget(threadId) {
+      entries.delete(threadId);
+      notify({ type: "forget", threadId });
+    },
+    clear() {
+      entries.clear();
+      notify({ type: "clear" });
+    }
+  };
+}
+function toThreadSnapshotSeed(state) {
+  const {
+    __interrupt__: _interrupt,
+    ptc_subagents: _ptcSubagents,
+    legacyRunActive: _legacyRunActive,
+    ...rest
+  } = state;
+  return { ...rest, runs: seedRunsLane(state.runs) };
+}
+function seedRunsLane(runs) {
+  const live = runs == null ? void 0 : runs[0];
+  if (live === void 0 || live.status !== "running") return [];
+  return [
+    {
+      runId: live.runId,
+      status: "running",
+      queue: live.queue,
+      steerQueue: live.steerQueue,
+      ...live.epoch !== void 0 && { epoch: live.epoch }
+    }
+  ];
+}
+exports.createDeepAgentThreadSnapshotCache = createDeepAgentThreadSnapshotCache;
+exports.toThreadSnapshotSeed = toThreadSnapshotSeed;
+//# sourceMappingURL=thread-snapshot-cache.cjs.map

package/dist/packages/agent-runtime/src/thread-snapshot-cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-snapshot-cache.cjs","sources":["../../../../../agent-runtime/src/thread-snapshot-cache.ts"],"sourcesContent":["import type { DeepAgentStreamValues } from './types';\n\n/**\n * Per-tab LRU of the last wire state seen per thread, so a switch back to a\n * recently-visited thread can mount with that snapshot instead of an empty\n * \"loading\" state (see `UseDeepAgentThreadOptions.snapshotCache`). Entries are\n * references into states the wire already produced — remembering is O(1) and\n * copies nothing; the bound is `maxThreads` retained states.\n */\nexport interface DeepAgentThreadSnapshotCache {\n  /** Record the latest hydrated wire state for a thread. */\n  remember(threadId: string, state: DeepAgentStreamValues): void;\n  /** The freshest remembered state for a thread, or `undefined` when none is\n   * held or the entry aged out. */\n  take(threadId: string): DeepAgentStreamValues | undefined;\n  /**\n   * Drop a single thread's entry. Called when the server refuses\n   * authorization for the thread — a refused thread must not warm-paint on\n   * its next mount.\n   */\n  forget(threadId: string): void;\n  /**\n   * Drop every entry. Called when the acting identity changes — a snapshot\n   * captured under one account must never seed a mount under another.\n   */\n  clear(): void;\n  /**\n   * Whether a fresh entry is held for the thread, without consuming or\n   * touching it. Hosts read it at selection time to decide whether the switch\n   * can paint from a seed (no loading treatment) or must cover the attach\n   * wait. Optional so hand-rolled caches keep type-checking; the built-in\n   * cache implements it.\n   */\n  peek?(threadId: string): boolean;\n}\n\n/** A write observed on the cache — the durable-mirror seam (see `onChange`). */\nexport type DeepAgentThreadSnapshotCacheChange =\n  | { type: 'remember'; threadId: string; state: DeepAgentStreamValues; at: number }\n  | { type: 'forget'; threadId: string }\n  | { type: 'clear' };\n\nexport interface DeepAgentThreadSnapshotCacheOptions {\n  /** Threads retained; the least-recently written entry evicts beyond this. */\n  maxThreads?: number;\n  /**\n   * Entries older than this are dropped at read time. The seed's value is\n   * \"the thread you just left\" — a snapshot from long ago is more likely to\n   * flash content the server has since rewritten than to save a paint.\n   */\n  maxAgeMs?: number;\n  /**\n   * Observer of every write (`remember`, `forget`, `clear`). Hosts mirror\n   * entries into durable storage from here so a reload can seed too; the\n   * observer is never invoked for `restore`, which re-admits mirrored entries.\n   * Exceptions are swallowed — a mirror fault must not break the wire path.\n   */\n  onChange?: (change: DeepAgentThreadSnapshotCacheChange) => void;\n  /** Injectable clock (tests). */\n  now?: () => number;\n}\n\n/** The built-in cache: the host contract plus the durable-mirror re-admission. */\nexport interface CreatedDeepAgentThreadSnapshotCache extends DeepAgentThreadSnapshotCache {\n  peek(threadId: string): boolean;\n  /**\n   * Re-admit an entry captured earlier — a mirrored snapshot after a reload —\n   * under its ORIGINAL capture time, so the age bound still applies. Never\n   * displaces a fresher in-memory entry and never notifies `onChange`.\n   */\n  restore(threadId: string, state: DeepAgentStreamValues, at: number): void;\n}\n\nconst DEFAULT_MAX_THREADS = 30;\nconst DEFAULT_MAX_AGE_MS = 60 * 60 * 1000;\n\nexport function createDeepAgentThreadSnapshotCache(\n  options: DeepAgentThreadSnapshotCacheOptions = {}\n): CreatedDeepAgentThreadSnapshotCache {\n  const maxThreads = options.maxThreads ?? DEFAULT_MAX_THREADS;\n  const maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;\n  const now = options.now ?? (() => Date.now());\n  const notify = (change: DeepAgentThreadSnapshotCacheChange): void => {\n    try {\n      options.onChange?.(change);\n    } catch {\n      // The mirror is best-effort; the in-memory cache stays authoritative.\n    }\n  };\n  // Map iteration order is insertion order; delete-then-set on every write\n  // keeps the first key the least-recently written.\n  const entries = new Map<string, { state: DeepAgentStreamValues; at: number }>();\n  const evict = (): void => {\n    while (entries.size > maxThreads) {\n      const oldest = entries.keys().next().value;\n      if (oldest === undefined) break;\n      entries.delete(oldest);\n    }\n  };\n  const fresh = (threadId: string): { state: DeepAgentStreamValues; at: number } | undefined => {\n    const entry = entries.get(threadId);\n    if (!entry) return undefined;\n    if (now() - entry.at > maxAgeMs) {\n      entries.delete(threadId);\n      return undefined;\n    }\n    return entry;\n  };\n  return {\n    remember(threadId, state) {\n      const at = now();\n      entries.delete(threadId);\n      entries.set(threadId, { state, at });\n      evict();\n      notify({ type: 'remember', threadId, state, at });\n    },\n    take(threadId) {\n      return fresh(threadId)?.state;\n    },\n    peek(threadId) {\n      return fresh(threadId) !== undefined;\n    },\n    restore(threadId, state, at) {\n      if (now() - at > maxAgeMs) return;\n      const existing = entries.get(threadId);\n      if (existing && existing.at >= at) return;\n      entries.delete(threadId);\n      entries.set(threadId, { state, at });\n      evict();\n    },\n    forget(threadId) {\n      entries.delete(threadId);\n      notify({ type: 'forget', threadId });\n    },\n    clear() {\n      entries.clear();\n      notify({ type: 'clear' });\n    },\n  };\n}\n\n/**\n * Shape a remembered wire state for use as a mount's `initialState`.\n *\n * Messages/todos and the other app-owned keys seed as captured. The run lane\n * seeds by what the user left: a thread whose run was `running` when the\n * snapshot was taken seeds a running entry (see {@link seedRunsLane}) so the\n * switch back reads Running with a Stop control on its first frame — the same\n * frame `runs: []` would render as \"ready\" with a Send button over a thread the\n * server is still mid-run on. Every other live-lifecycle lane normalizes to\n * resting: a seeded input request could collect a decision the server may have\n * already resolved, so an `input-required` entry seeds as no run at all.\n * `__interrupt__` is dropped for the same reason, and so are `ptc_subagents`\n * (the live in-eval dispatch lane — a seeded \"running\" dispatch card under a\n * resting thread would render active with no eval behind it) and\n * `legacyRunActive` (the host's out-of-band-run-in-progress flag — seeding a\n * finished run's `true` would hide the composer until the attach corrected\n * it). Durable thread properties (`runConfig`, `sessionPersisted`, …) seed as\n * captured; the attach snapshot then replaces the whole seed.\n */\nexport function toThreadSnapshotSeed(state: DeepAgentStreamValues): DeepAgentStreamValues {\n  const {\n    __interrupt__: _interrupt,\n    ptc_subagents: _ptcSubagents,\n    legacyRunActive: _legacyRunActive,\n    ...rest\n  } = state;\n  return { ...rest, runs: seedRunsLane(state.runs) };\n}\n\n/**\n * The run entries a seed carries.\n *\n * Only a `running` entry survives, and only its replicated identity and its\n * durable lanes: `runId` (the target of a Stop sent during the attach\n * round-trip — the live run's id if it is still running, and a refused stop\n * if it finished meanwhile), `epoch` (rides that Stop so a replayed stop cannot\n * end a later leg) and the `queue`/`steerQueue` entries (server lanes the tray\n * renders). The in-flight records rest until the snapshot: `dispatching` and\n * `nextDispatch` are batches the materializer would re-apply onto messages\n * that already contain them, `stopping` is a rewind the host may have\n * finished, `inputRequests` is a parked decision, and `error` is a failure the\n * next user run clears. An entry in any other status — `stopped`, `error`,\n * `input-required` — seeds as no run.\n */\nfunction seedRunsLane(\n  runs: DeepAgentStreamValues['runs']\n): NonNullable<DeepAgentStreamValues['runs']> {\n  const live = runs?.[0];\n  if (live === undefined || live.status !== 'running') return [];\n  return [\n    {\n      runId: live.runId,\n      status: 'running',\n      queue: live.queue,\n      steerQueue: live.steerQueue,\n      ...(live.epoch !== undefined && { epoch: live.epoch }),\n    },\n  ];\n}\n"],"names":[],"mappings":";;AAyEA,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB,KAAK,KAAK;AAE9B,SAAS,mCACd,UAA+C,IACV;AACrC,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,MAAM,QAAQ,QAAQ,MAAM,KAAK,IAAA;AACvC,QAAM,SAAS,CAAC,WAAqD;;AACnE,QAAI;AACF,oBAAQ,aAAR,iCAAmB;AAAA,IACrB,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,QAAM,8BAAc,IAAA;AACpB,QAAM,QAAQ,MAAY;AACxB,WAAO,QAAQ,OAAO,YAAY;AAChC,YAAM,SAAS,QAAQ,KAAA,EAAO,OAAO;AACrC,UAAI,WAAW,OAAW;AAC1B,cAAQ,OAAO,MAAM;AAAA,IACvB;AAAA,EACF;AACA,QAAM,QAAQ,CAAC,aAA+E;AAC5F,UAAM,QAAQ,QAAQ,IAAI,QAAQ;AAClC,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,IAAA,IAAQ,MAAM,KAAK,UAAU;AAC/B,cAAQ,OAAO,QAAQ;AACvB,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,SAAS,UAAU,OAAO;AACxB,YAAM,KAAK,IAAA;AACX,cAAQ,OAAO,QAAQ;AACvB,cAAQ,IAAI,UAAU,EAAE,OAAO,IAAI;AACnC,YAAA;AACA,aAAO,EAAE,MAAM,YAAY,UAAU,OAAO,IAAI;AAAA,IAClD;AAAA,IACA,KAAK,UAAU;;AACb,cAAO,WAAM,QAAQ,MAAd,mBAAiB;AAAA,IAC1B;AAAA,IACA,KAAK,UAAU;AACb,aAAO,MAAM,QAAQ,MAAM;AAAA,IAC7B;AAAA,IACA,QAAQ,UAAU,OAAO,IAAI;AAC3B,UAAI,IAAA,IAAQ,KAAK,SAAU;AAC3B,YAAM,WAAW,QAAQ,IAAI,QAAQ;AACrC,UAAI,YAAY,SAAS,MAAM,GAAI;AACnC,cAAQ,OAAO,QAAQ;AACvB,cAAQ,IAAI,UAAU,EAAE,OAAO,IAAI;AACnC,YAAA;AAAA,IACF;AAAA,IACA,OAAO,UAAU;AACf,cAAQ,OAAO,QAAQ;AACvB,aAAO,EAAE,MAAM,UAAU,SAAA,CAAU;AAAA,IACrC;AAAA,IACA,QAAQ;AACN,cAAQ,MAAA;AACR,aAAO,EAAE,MAAM,SAAS;AAAA,IAC1B;AAAA,EAAA;AAEJ;AAqBO,SAAS,qBAAqB,OAAqD;AACxF,QAAM;AAAA,IACJ,eAAe;AAAA,IACf,eAAe;AAAA,IACf,iBAAiB;AAAA,IACjB,GAAG;AAAA,EAAA,IACD;AACJ,SAAO,EAAE,GAAG,MAAM,MAAM,aAAa,MAAM,IAAI,EAAA;AACjD;AAiBA,SAAS,aACP,MAC4C;AAC5C,QAAM,OAAO,6BAAO;AACpB,MAAI,SAAS,UAAa,KAAK,WAAW,kBAAkB,CAAA;AAC5D,SAAO;AAAA,IACL;AAAA,MACE,OAAO,KAAK;AAAA,MACZ,QAAQ;AAAA,MACR,OAAO,KAAK;AAAA,MACZ,YAAY,KAAK;AAAA,MACjB,GAAI,KAAK,UAAU,UAAa,EAAE,OAAO,KAAK,MAAA;AAAA,IAAM;AAAA,EACtD;AAEJ;;;"}

package/dist/packages/agent-runtime/src/thread-snapshot-cache.js

@@ -0,0 +1,90 @@
+const DEFAULT_MAX_THREADS = 30;
+const DEFAULT_MAX_AGE_MS = 60 * 60 * 1e3;
+function createDeepAgentThreadSnapshotCache(options = {}) {
+  const maxThreads = options.maxThreads ?? DEFAULT_MAX_THREADS;
+  const maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
+  const now = options.now ?? (() => Date.now());
+  const notify = (change) => {
+    var _a;
+    try {
+      (_a = options.onChange) == null ? void 0 : _a.call(options, change);
+    } catch {
+    }
+  };
+  const entries = /* @__PURE__ */ new Map();
+  const evict = () => {
+    while (entries.size > maxThreads) {
+      const oldest = entries.keys().next().value;
+      if (oldest === void 0) break;
+      entries.delete(oldest);
+    }
+  };
+  const fresh = (threadId) => {
+    const entry = entries.get(threadId);
+    if (!entry) return void 0;
+    if (now() - entry.at > maxAgeMs) {
+      entries.delete(threadId);
+      return void 0;
+    }
+    return entry;
+  };
+  return {
+    remember(threadId, state) {
+      const at = now();
+      entries.delete(threadId);
+      entries.set(threadId, { state, at });
+      evict();
+      notify({ type: "remember", threadId, state, at });
+    },
+    take(threadId) {
+      var _a;
+      return (_a = fresh(threadId)) == null ? void 0 : _a.state;
+    },
+    peek(threadId) {
+      return fresh(threadId) !== void 0;
+    },
+    restore(threadId, state, at) {
+      if (now() - at > maxAgeMs) return;
+      const existing = entries.get(threadId);
+      if (existing && existing.at >= at) return;
+      entries.delete(threadId);
+      entries.set(threadId, { state, at });
+      evict();
+    },
+    forget(threadId) {
+      entries.delete(threadId);
+      notify({ type: "forget", threadId });
+    },
+    clear() {
+      entries.clear();
+      notify({ type: "clear" });
+    }
+  };
+}
+function toThreadSnapshotSeed(state) {
+  const {
+    __interrupt__: _interrupt,
+    ptc_subagents: _ptcSubagents,
+    legacyRunActive: _legacyRunActive,
+    ...rest
+  } = state;
+  return { ...rest, runs: seedRunsLane(state.runs) };
+}
+function seedRunsLane(runs) {
+  const live = runs == null ? void 0 : runs[0];
+  if (live === void 0 || live.status !== "running") return [];
+  return [
+    {
+      runId: live.runId,
+      status: "running",
+      queue: live.queue,
+      steerQueue: live.steerQueue,
+      ...live.epoch !== void 0 && { epoch: live.epoch }
+    }
+  ];
+}
+export {
+  createDeepAgentThreadSnapshotCache,
+  toThreadSnapshotSeed
+};
+//# sourceMappingURL=thread-snapshot-cache.js.map

package/dist/packages/agent-runtime/src/thread-snapshot-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-snapshot-cache.js","sources":["../../../../../agent-runtime/src/thread-snapshot-cache.ts"],"sourcesContent":["import type { DeepAgentStreamValues } from './types';\n\n/**\n * Per-tab LRU of the last wire state seen per thread, so a switch back to a\n * recently-visited thread can mount with that snapshot instead of an empty\n * \"loading\" state (see `UseDeepAgentThreadOptions.snapshotCache`). Entries are\n * references into states the wire already produced — remembering is O(1) and\n * copies nothing; the bound is `maxThreads` retained states.\n */\nexport interface DeepAgentThreadSnapshotCache {\n  /** Record the latest hydrated wire state for a thread. */\n  remember(threadId: string, state: DeepAgentStreamValues): void;\n  /** The freshest remembered state for a thread, or `undefined` when none is\n   * held or the entry aged out. */\n  take(threadId: string): DeepAgentStreamValues | undefined;\n  /**\n   * Drop a single thread's entry. Called when the server refuses\n   * authorization for the thread — a refused thread must not warm-paint on\n   * its next mount.\n   */\n  forget(threadId: string): void;\n  /**\n   * Drop every entry. Called when the acting identity changes — a snapshot\n   * captured under one account must never seed a mount under another.\n   */\n  clear(): void;\n  /**\n   * Whether a fresh entry is held for the thread, without consuming or\n   * touching it. Hosts read it at selection time to decide whether the switch\n   * can paint from a seed (no loading treatment) or must cover the attach\n   * wait. Optional so hand-rolled caches keep type-checking; the built-in\n   * cache implements it.\n   */\n  peek?(threadId: string): boolean;\n}\n\n/** A write observed on the cache — the durable-mirror seam (see `onChange`). */\nexport type DeepAgentThreadSnapshotCacheChange =\n  | { type: 'remember'; threadId: string; state: DeepAgentStreamValues; at: number }\n  | { type: 'forget'; threadId: string }\n  | { type: 'clear' };\n\nexport interface DeepAgentThreadSnapshotCacheOptions {\n  /** Threads retained; the least-recently written entry evicts beyond this. */\n  maxThreads?: number;\n  /**\n   * Entries older than this are dropped at read time. The seed's value is\n   * \"the thread you just left\" — a snapshot from long ago is more likely to\n   * flash content the server has since rewritten than to save a paint.\n   */\n  maxAgeMs?: number;\n  /**\n   * Observer of every write (`remember`, `forget`, `clear`). Hosts mirror\n   * entries into durable storage from here so a reload can seed too; the\n   * observer is never invoked for `restore`, which re-admits mirrored entries.\n   * Exceptions are swallowed — a mirror fault must not break the wire path.\n   */\n  onChange?: (change: DeepAgentThreadSnapshotCacheChange) => void;\n  /** Injectable clock (tests). */\n  now?: () => number;\n}\n\n/** The built-in cache: the host contract plus the durable-mirror re-admission. */\nexport interface CreatedDeepAgentThreadSnapshotCache extends DeepAgentThreadSnapshotCache {\n  peek(threadId: string): boolean;\n  /**\n   * Re-admit an entry captured earlier — a mirrored snapshot after a reload —\n   * under its ORIGINAL capture time, so the age bound still applies. Never\n   * displaces a fresher in-memory entry and never notifies `onChange`.\n   */\n  restore(threadId: string, state: DeepAgentStreamValues, at: number): void;\n}\n\nconst DEFAULT_MAX_THREADS = 30;\nconst DEFAULT_MAX_AGE_MS = 60 * 60 * 1000;\n\nexport function createDeepAgentThreadSnapshotCache(\n  options: DeepAgentThreadSnapshotCacheOptions = {}\n): CreatedDeepAgentThreadSnapshotCache {\n  const maxThreads = options.maxThreads ?? DEFAULT_MAX_THREADS;\n  const maxAgeMs = options.maxAgeMs ?? DEFAULT_MAX_AGE_MS;\n  const now = options.now ?? (() => Date.now());\n  const notify = (change: DeepAgentThreadSnapshotCacheChange): void => {\n    try {\n      options.onChange?.(change);\n    } catch {\n      // The mirror is best-effort; the in-memory cache stays authoritative.\n    }\n  };\n  // Map iteration order is insertion order; delete-then-set on every write\n  // keeps the first key the least-recently written.\n  const entries = new Map<string, { state: DeepAgentStreamValues; at: number }>();\n  const evict = (): void => {\n    while (entries.size > maxThreads) {\n      const oldest = entries.keys().next().value;\n      if (oldest === undefined) break;\n      entries.delete(oldest);\n    }\n  };\n  const fresh = (threadId: string): { state: DeepAgentStreamValues; at: number } | undefined => {\n    const entry = entries.get(threadId);\n    if (!entry) return undefined;\n    if (now() - entry.at > maxAgeMs) {\n      entries.delete(threadId);\n      return undefined;\n    }\n    return entry;\n  };\n  return {\n    remember(threadId, state) {\n      const at = now();\n      entries.delete(threadId);\n      entries.set(threadId, { state, at });\n      evict();\n      notify({ type: 'remember', threadId, state, at });\n    },\n    take(threadId) {\n      return fresh(threadId)?.state;\n    },\n    peek(threadId) {\n      return fresh(threadId) !== undefined;\n    },\n    restore(threadId, state, at) {\n      if (now() - at > maxAgeMs) return;\n      const existing = entries.get(threadId);\n      if (existing && existing.at >= at) return;\n      entries.delete(threadId);\n      entries.set(threadId, { state, at });\n      evict();\n    },\n    forget(threadId) {\n      entries.delete(threadId);\n      notify({ type: 'forget', threadId });\n    },\n    clear() {\n      entries.clear();\n      notify({ type: 'clear' });\n    },\n  };\n}\n\n/**\n * Shape a remembered wire state for use as a mount's `initialState`.\n *\n * Messages/todos and the other app-owned keys seed as captured. The run lane\n * seeds by what the user left: a thread whose run was `running` when the\n * snapshot was taken seeds a running entry (see {@link seedRunsLane}) so the\n * switch back reads Running with a Stop control on its first frame — the same\n * frame `runs: []` would render as \"ready\" with a Send button over a thread the\n * server is still mid-run on. Every other live-lifecycle lane normalizes to\n * resting: a seeded input request could collect a decision the server may have\n * already resolved, so an `input-required` entry seeds as no run at all.\n * `__interrupt__` is dropped for the same reason, and so are `ptc_subagents`\n * (the live in-eval dispatch lane — a seeded \"running\" dispatch card under a\n * resting thread would render active with no eval behind it) and\n * `legacyRunActive` (the host's out-of-band-run-in-progress flag — seeding a\n * finished run's `true` would hide the composer until the attach corrected\n * it). Durable thread properties (`runConfig`, `sessionPersisted`, …) seed as\n * captured; the attach snapshot then replaces the whole seed.\n */\nexport function toThreadSnapshotSeed(state: DeepAgentStreamValues): DeepAgentStreamValues {\n  const {\n    __interrupt__: _interrupt,\n    ptc_subagents: _ptcSubagents,\n    legacyRunActive: _legacyRunActive,\n    ...rest\n  } = state;\n  return { ...rest, runs: seedRunsLane(state.runs) };\n}\n\n/**\n * The run entries a seed carries.\n *\n * Only a `running` entry survives, and only its replicated identity and its\n * durable lanes: `runId` (the target of a Stop sent during the attach\n * round-trip — the live run's id if it is still running, and a refused stop\n * if it finished meanwhile), `epoch` (rides that Stop so a replayed stop cannot\n * end a later leg) and the `queue`/`steerQueue` entries (server lanes the tray\n * renders). The in-flight records rest until the snapshot: `dispatching` and\n * `nextDispatch` are batches the materializer would re-apply onto messages\n * that already contain them, `stopping` is a rewind the host may have\n * finished, `inputRequests` is a parked decision, and `error` is a failure the\n * next user run clears. An entry in any other status — `stopped`, `error`,\n * `input-required` — seeds as no run.\n */\nfunction seedRunsLane(\n  runs: DeepAgentStreamValues['runs']\n): NonNullable<DeepAgentStreamValues['runs']> {\n  const live = runs?.[0];\n  if (live === undefined || live.status !== 'running') return [];\n  return [\n    {\n      runId: live.runId,\n      status: 'running',\n      queue: live.queue,\n      steerQueue: live.steerQueue,\n      ...(live.epoch !== undefined && { epoch: live.epoch }),\n    },\n  ];\n}\n"],"names":[],"mappings":"AAyEA,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB,KAAK,KAAK;AAE9B,SAAS,mCACd,UAA+C,IACV;AACrC,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,WAAW,QAAQ,YAAY;AACrC,QAAM,MAAM,QAAQ,QAAQ,MAAM,KAAK,IAAA;AACvC,QAAM,SAAS,CAAC,WAAqD;AATvE;AAUI,QAAI;AACF,oBAAQ,aAAR,iCAAmB;AAAA,IACrB,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,QAAM,8BAAc,IAAA;AACpB,QAAM,QAAQ,MAAY;AACxB,WAAO,QAAQ,OAAO,YAAY;AAChC,YAAM,SAAS,QAAQ,KAAA,EAAO,OAAO;AACrC,UAAI,WAAW,OAAW;AAC1B,cAAQ,OAAO,MAAM;AAAA,IACvB;AAAA,EACF;AACA,QAAM,QAAQ,CAAC,aAA+E;AAC5F,UAAM,QAAQ,QAAQ,IAAI,QAAQ;AAClC,QAAI,CAAC,MAAO,QAAO;AACnB,QAAI,IAAA,IAAQ,MAAM,KAAK,UAAU;AAC/B,cAAQ,OAAO,QAAQ;AACvB,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,SAAS,UAAU,OAAO;AACxB,YAAM,KAAK,IAAA;AACX,cAAQ,OAAO,QAAQ;AACvB,cAAQ,IAAI,UAAU,EAAE,OAAO,IAAI;AACnC,YAAA;AACA,aAAO,EAAE,MAAM,YAAY,UAAU,OAAO,IAAI;AAAA,IAClD;AAAA,IACA,KAAK,UAAU;AA3CnB;AA4CM,cAAO,WAAM,QAAQ,MAAd,mBAAiB;AAAA,IAC1B;AAAA,IACA,KAAK,UAAU;AACb,aAAO,MAAM,QAAQ,MAAM;AAAA,IAC7B;AAAA,IACA,QAAQ,UAAU,OAAO,IAAI;AAC3B,UAAI,IAAA,IAAQ,KAAK,SAAU;AAC3B,YAAM,WAAW,QAAQ,IAAI,QAAQ;AACrC,UAAI,YAAY,SAAS,MAAM,GAAI;AACnC,cAAQ,OAAO,QAAQ;AACvB,cAAQ,IAAI,UAAU,EAAE,OAAO,IAAI;AACnC,YAAA;AAAA,IACF;AAAA,IACA,OAAO,UAAU;AACf,cAAQ,OAAO,QAAQ;AACvB,aAAO,EAAE,MAAM,UAAU,SAAA,CAAU;AAAA,IACrC;AAAA,IACA,QAAQ;AACN,cAAQ,MAAA;AACR,aAAO,EAAE,MAAM,SAAS;AAAA,IAC1B;AAAA,EAAA;AAEJ;AAqBO,SAAS,qBAAqB,OAAqD;AACxF,QAAM;AAAA,IACJ,eAAe;AAAA,IACf,eAAe;AAAA,IACf,iBAAiB;AAAA,IACjB,GAAG;AAAA,EAAA,IACD;AACJ,SAAO,EAAE,GAAG,MAAM,MAAM,aAAa,MAAM,IAAI,EAAA;AACjD;AAiBA,SAAS,aACP,MAC4C;AAC5C,QAAM,OAAO,6BAAO;AACpB,MAAI,SAAS,UAAa,KAAK,WAAW,kBAAkB,CAAA;AAC5D,SAAO;AAAA,IACL;AAAA,MACE,OAAO,KAAK;AAAA,MACZ,QAAQ;AAAA,MACR,OAAO,KAAK;AAAA,MACZ,YAAY,KAAK;AAAA,MACjB,GAAI,KAAK,UAAU,UAAa,EAAE,OAAO,KAAK,MAAA;AAAA,IAAM;AAAA,EACtD;AAEJ;"}

package/dist/packages/agent-runtime/src/thread-status.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const store = require("@assistant-ui/store");
+const react = require("react");
+function useDeepAgentThreadStatus() {
+  return store.useAuiState((s) => {
+    var _a;
+    const status = (_a = s.thread.extras) == null ? void 0 : _a.status;
+    if (status === void 0) {
+      throw new Error("useDeepAgentThreadStatus requires a statewire thread");
+    }
+    return status;
+  });
+}
+function resolveStaleRunReason({
+  status,
+  connection
+}) {
+  if (status === "evicted") return "evicted";
+  if (status !== "disconnected") return null;
+  if ((connection == null ? void 0 : connection.status) === "connecting") {
+    return null;
+  }
+  return "disconnected";
+}
+function resolveRunLive({
+  status,
+  connection
+}) {
+  if (status === "running") return true;
+  if (status !== "disconnected") return false;
+  return resolveStaleRunReason({ status, connection }) === null;
+}
+function readRunLive(thread, connection) {
+  var _a;
+  const status = (_a = thread.extras) == null ? void 0 : _a.status;
+  return status === void 0 ? thread.isRunning : resolveRunLive({ status, connection });
+}
+const DeepAgentConnectionContext = react.createContext(null);
+function useDeepAgentConnection() {
+  return react.useContext(DeepAgentConnectionContext);
+}
+exports.DeepAgentConnectionContext = DeepAgentConnectionContext;
+exports.readRunLive = readRunLive;
+exports.resolveRunLive = resolveRunLive;
+exports.resolveStaleRunReason = resolveStaleRunReason;
+exports.useDeepAgentConnection = useDeepAgentConnection;
+exports.useDeepAgentThreadStatus = useDeepAgentThreadStatus;
+//# sourceMappingURL=thread-status.cjs.map

package/dist/packages/agent-runtime/src/thread-status.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-status.cjs","sources":["../../../../../agent-runtime/src/thread-status.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { createContext, useContext } from 'react';\nimport type { DeepAgentConnectionState } from './types';\n\nexport type DeepAgentThreadStatus = StatewireThread.ThreadStatus;\n\n/**\n * Runtime-scoped thread status, as the library presents it: `\"loading\"` /\n * `\"ready\"` / the run's status replicated by the host, with a mid-run\n * connection loss presented as `\"evicted\"` (server-update pod drain) or\n * `\"disconnected\"` instead of `\"running\"`. Throws outside a statewire aui\n * provider, matching react-statewire 0.13's removed `useStatewireThreadStatus`.\n */\nexport function useDeepAgentThreadStatus(): DeepAgentThreadStatus {\n  return useAuiState((s) => {\n    const status = (s.thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n    if (status === undefined) {\n      throw new Error('useDeepAgentThreadStatus requires a statewire thread');\n    }\n    return status;\n  });\n}\n\n/** The two presented statuses that hide a live run behind a channel problem. */\nexport type DeepAgentStaleRunReason = Extract<DeepAgentThreadStatus, 'disconnected' | 'evicted'>;\n\n/** A first connection attempt can present an optimistic run without a stale warning. */\nexport function resolveStaleRunReason({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): DeepAgentStaleRunReason | null {\n  if (status === 'evicted') return 'evicted';\n  if (status !== 'disconnected') return null;\n  if (connection?.status === 'connecting') {\n    return null;\n  }\n  return 'disconnected';\n}\n\n/**\n * Whether the thread has a live run to present — the composer's Running bar\n * and its Stop/Queue slot.\n *\n * The library derives `thread.isRunning` from the PRESENTED status, so a run\n * that is live on the host but sits behind a channel that has not connected\n * yet reads as not running. Behind a first dial that is exactly the run the\n * client just seeded — switching back to a thread that was running when you\n * left, or a brand-new chat's optimistic first send — and nothing is stale:\n * the channel is still attaching. Hiding the run for that round-trip flashes\n * Ready and a Send button before Running comes back. A run behind a reconnect\n * or an eviction is presented by the stale treatment (`resolveStaleRunReason`),\n * never as live.\n */\nexport function resolveRunLive({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): boolean {\n  if (status === 'running') return true;\n  if (status !== 'disconnected') return false;\n  return resolveStaleRunReason({ status, connection }) === null;\n}\n\n/**\n * `thread.isRunning` for a `useAuiState` selector, folded through\n * `resolveRunLive` when the thread is a statewire thread. A thread without a\n * statewire status (another runtime, a test stub) keeps the library's answer.\n */\nexport function readRunLive(\n  thread: { isRunning: boolean; extras?: unknown },\n  connection: DeepAgentConnectionState | null,\n): boolean {\n  const status = (thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n  return status === undefined ? thread.isRunning : resolveRunLive({ status, connection });\n}\n\n/**\n * The active thread's channel, for `readRunLive`'s first-dial verdict. Each\n * host provides it from its own lifecycle state (`AthenaProvider`, the\n * Chrome extension's lifecycle provider); `null` means \"no channel known\",\n * which folds a `disconnected` status as stale.\n */\nexport const DeepAgentConnectionContext = createContext<DeepAgentConnectionState | null>(null);\n\nexport function useDeepAgentConnection(): DeepAgentConnectionState | null {\n  return useContext(DeepAgentConnectionContext);\n}\n"],"names":["useAuiState","createContext","useContext"],"mappings":";;;;AAcO,SAAS,2BAAkD;AAChE,SAAOA,MAAAA,YAAY,CAAC,MAAM;;AACxB,UAAM,UAAU,OAAE,OAAO,WAAT,mBAAiE;AACjF,QAAI,WAAW,QAAW;AACxB,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAMO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AACF,GAGmC;AACjC,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,OAAI,yCAAY,YAAW,cAAc;AACvC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAgBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAGY;AACV,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,SAAO,sBAAsB,EAAE,QAAQ,WAAA,CAAY,MAAM;AAC3D;AAOO,SAAS,YACd,QACA,YACS;;AACT,QAAM,UAAU,YAAO,WAAP,mBAA+D;AAC/E,SAAO,WAAW,SAAY,OAAO,YAAY,eAAe,EAAE,QAAQ,YAAY;AACxF;AAQO,MAAM,6BAA6BC,MAAAA,cAA+C,IAAI;AAEtF,SAAS,yBAA0D;AACxE,SAAOC,MAAAA,WAAW,0BAA0B;AAC9C;;;;;;;"}

package/dist/packages/agent-runtime/src/thread-status.js

@@ -0,0 +1,49 @@
+import { useAuiState } from "@assistant-ui/store";
+import { createContext, useContext } from "react";
+function useDeepAgentThreadStatus() {
+  return useAuiState((s) => {
+    var _a;
+    const status = (_a = s.thread.extras) == null ? void 0 : _a.status;
+    if (status === void 0) {
+      throw new Error("useDeepAgentThreadStatus requires a statewire thread");
+    }
+    return status;
+  });
+}
+function resolveStaleRunReason({
+  status,
+  connection
+}) {
+  if (status === "evicted") return "evicted";
+  if (status !== "disconnected") return null;
+  if ((connection == null ? void 0 : connection.status) === "connecting") {
+    return null;
+  }
+  return "disconnected";
+}
+function resolveRunLive({
+  status,
+  connection
+}) {
+  if (status === "running") return true;
+  if (status !== "disconnected") return false;
+  return resolveStaleRunReason({ status, connection }) === null;
+}
+function readRunLive(thread, connection) {
+  var _a;
+  const status = (_a = thread.extras) == null ? void 0 : _a.status;
+  return status === void 0 ? thread.isRunning : resolveRunLive({ status, connection });
+}
+const DeepAgentConnectionContext = createContext(null);
+function useDeepAgentConnection() {
+  return useContext(DeepAgentConnectionContext);
+}
+export {
+  DeepAgentConnectionContext,
+  readRunLive,
+  resolveRunLive,
+  resolveStaleRunReason,
+  useDeepAgentConnection,
+  useDeepAgentThreadStatus
+};
+//# sourceMappingURL=thread-status.js.map

package/dist/packages/agent-runtime/src/thread-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-status.js","sources":["../../../../../agent-runtime/src/thread-status.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { createContext, useContext } from 'react';\nimport type { DeepAgentConnectionState } from './types';\n\nexport type DeepAgentThreadStatus = StatewireThread.ThreadStatus;\n\n/**\n * Runtime-scoped thread status, as the library presents it: `\"loading\"` /\n * `\"ready\"` / the run's status replicated by the host, with a mid-run\n * connection loss presented as `\"evicted\"` (server-update pod drain) or\n * `\"disconnected\"` instead of `\"running\"`. Throws outside a statewire aui\n * provider, matching react-statewire 0.13's removed `useStatewireThreadStatus`.\n */\nexport function useDeepAgentThreadStatus(): DeepAgentThreadStatus {\n  return useAuiState((s) => {\n    const status = (s.thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n    if (status === undefined) {\n      throw new Error('useDeepAgentThreadStatus requires a statewire thread');\n    }\n    return status;\n  });\n}\n\n/** The two presented statuses that hide a live run behind a channel problem. */\nexport type DeepAgentStaleRunReason = Extract<DeepAgentThreadStatus, 'disconnected' | 'evicted'>;\n\n/** A first connection attempt can present an optimistic run without a stale warning. */\nexport function resolveStaleRunReason({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): DeepAgentStaleRunReason | null {\n  if (status === 'evicted') return 'evicted';\n  if (status !== 'disconnected') return null;\n  if (connection?.status === 'connecting') {\n    return null;\n  }\n  return 'disconnected';\n}\n\n/**\n * Whether the thread has a live run to present — the composer's Running bar\n * and its Stop/Queue slot.\n *\n * The library derives `thread.isRunning` from the PRESENTED status, so a run\n * that is live on the host but sits behind a channel that has not connected\n * yet reads as not running. Behind a first dial that is exactly the run the\n * client just seeded — switching back to a thread that was running when you\n * left, or a brand-new chat's optimistic first send — and nothing is stale:\n * the channel is still attaching. Hiding the run for that round-trip flashes\n * Ready and a Send button before Running comes back. A run behind a reconnect\n * or an eviction is presented by the stale treatment (`resolveStaleRunReason`),\n * never as live.\n */\nexport function resolveRunLive({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): boolean {\n  if (status === 'running') return true;\n  if (status !== 'disconnected') return false;\n  return resolveStaleRunReason({ status, connection }) === null;\n}\n\n/**\n * `thread.isRunning` for a `useAuiState` selector, folded through\n * `resolveRunLive` when the thread is a statewire thread. A thread without a\n * statewire status (another runtime, a test stub) keeps the library's answer.\n */\nexport function readRunLive(\n  thread: { isRunning: boolean; extras?: unknown },\n  connection: DeepAgentConnectionState | null,\n): boolean {\n  const status = (thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n  return status === undefined ? thread.isRunning : resolveRunLive({ status, connection });\n}\n\n/**\n * The active thread's channel, for `readRunLive`'s first-dial verdict. Each\n * host provides it from its own lifecycle state (`AthenaProvider`, the\n * Chrome extension's lifecycle provider); `null` means \"no channel known\",\n * which folds a `disconnected` status as stale.\n */\nexport const DeepAgentConnectionContext = createContext<DeepAgentConnectionState | null>(null);\n\nexport function useDeepAgentConnection(): DeepAgentConnectionState | null {\n  return useContext(DeepAgentConnectionContext);\n}\n"],"names":[],"mappings":";;AAcO,SAAS,2BAAkD;AAChE,SAAO,YAAY,CAAC,MAAM;;AACxB,UAAM,UAAU,OAAE,OAAO,WAAT,mBAAiE;AACjF,QAAI,WAAW,QAAW;AACxB,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAMO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AACF,GAGmC;AACjC,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,OAAI,yCAAY,YAAW,cAAc;AACvC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAgBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAGY;AACV,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,SAAO,sBAAsB,EAAE,QAAQ,WAAA,CAAY,MAAM;AAC3D;AAOO,SAAS,YACd,QACA,YACS;;AACT,QAAM,UAAU,YAAO,WAAP,mBAA+D;AAC/E,SAAO,WAAW,SAAY,OAAO,YAAY,eAAe,EAAE,QAAQ,YAAY;AACxF;AAQO,MAAM,6BAA6B,cAA+C,IAAI;AAEtF,SAAS,yBAA0D;AACxE,SAAO,WAAW,0BAA0B;AAC9C;"}