@athenaintel/react 0.19.0 → 0.21.0

package/dist/packages/agent-runtime/src/edit-command.js

@@ -0,0 +1,89 @@
+import { readDeepAgentMessagesWindow, buildHistoryLoadCommand, readHistoryLoadResult } from "./message-window.js";
+import { hasStatewireThreadExtras } from "./thread-extras.js";
+function readDeepAgentStatewireExtras(extras) {
+  if (!hasStatewireThreadExtras(extras)) return null;
+  return extras;
+}
+function resolveWireAnchorMessageId({
+  wireMessages,
+  sourceId,
+  window = null
+}) {
+  var _a;
+  if (!wireMessages) return void 0;
+  const index = wireMessages.findIndex((message) => (message == null ? void 0 : message.id) === sourceId);
+  if (index < 0) return void 0;
+  if (index === 0) {
+    if (window === null || window.start === 0) return null;
+    return window.anchorBefore ?? void 0;
+  }
+  const parentId = (_a = wireMessages[index - 1]) == null ? void 0 : _a.id;
+  return typeof parentId === "string" ? parentId : void 0;
+}
+function isSourceBelowLoadedWindow({
+  wireMessages,
+  sourceId,
+  window
+}) {
+  if (!wireMessages || window === null || window.start === 0) return false;
+  return !wireMessages.some((message) => (message == null ? void 0 : message.id) === sourceId);
+}
+function mintCommandId() {
+  const webcrypto = globalThis.crypto;
+  if (typeof (webcrypto == null ? void 0 : webcrypto.randomUUID) === "function") return webcrypto.randomUUID();
+  const hex = () => Math.floor(Math.random() * 65536).toString(16).padStart(4, "0");
+  return `${hex()}${hex()}-${hex()}-4${hex().slice(1)}-${hex()}-${hex()}${hex()}${hex()}`;
+}
+function buildDeepAgentEditCommand({
+  extras,
+  sourceId,
+  text
+}) {
+  var _a;
+  const runAnchorMessageId = resolveWireAnchorMessageId({
+    wireMessages: (_a = extras.state) == null ? void 0 : _a.messages,
+    sourceId,
+    window: readDeepAgentMessagesWindow(extras.state)
+  });
+  if (runAnchorMessageId === void 0) return null;
+  return {
+    type: "run/edit",
+    runId: extras.runs.runId ?? mintCommandId(),
+    message: { id: mintCommandId(), role: "user", parts: [{ type: "text", text }] },
+    sourceId,
+    runAnchorMessageId
+  };
+}
+const MAX_EDIT_ANCHOR_HISTORY_LOADS = 5;
+async function resolveDeepAgentEditCommand({
+  readExtras,
+  sourceId,
+  text,
+  maxHistoryLoads = MAX_EDIT_ANCHOR_HISTORY_LOADS
+}) {
+  var _a;
+  for (let page = 0; page <= maxHistoryLoads; page += 1) {
+    const extras = readExtras();
+    if (!extras) return null;
+    const command = buildDeepAgentEditCommand({ extras, sourceId, text });
+    if (command) return command;
+    if (page === maxHistoryLoads) return null;
+    const wireMessages = (_a = extras.state) == null ? void 0 : _a.messages;
+    const window = readDeepAgentMessagesWindow(extras.state);
+    if (!isSourceBelowLoadedWindow({ wireMessages, sourceId, window })) return null;
+    const load = window === null ? null : buildHistoryLoadCommand({ window });
+    if (load === null) return null;
+    const result = readHistoryLoadResult(await extras.sendCommand(load));
+    if (result === null || result.loaded === 0 && !result.stale) return null;
+  }
+  return null;
+}
+export {
+  MAX_EDIT_ANCHOR_HISTORY_LOADS,
+  buildDeepAgentEditCommand,
+  isSourceBelowLoadedWindow,
+  readDeepAgentStatewireExtras,
+  resolveDeepAgentEditCommand,
+  resolveWireAnchorMessageId
+};
+//# sourceMappingURL=edit-command.js.map

package/dist/packages/agent-runtime/src/edit-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-command.js","sources":["../../../../../agent-runtime/src/edit-command.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport {\n  buildHistoryLoadCommand,\n  type DeepAgentMessagesWindow,\n  readDeepAgentMessagesWindow,\n  readHistoryLoadResult,\n} from './message-window';\nimport { hasStatewireThreadExtras } from './thread-extras';\n\n/**\n * Wire-accurate `run/edit` construction for deep-agent retry/edit, shared by\n * every surface that resubmits a user message.\n *\n * assistant-ui builds the command's `runAnchorMessageId` from the CONVERTED\n * thread messages (`resolveEditCommand`: `messages[index - 1].id`), but the\n * deep-agent host validates that anchor against the edited message's parent in\n * its RAW message list (`harness_sdk.linear_thread`: the entry before it in\n * `state[\"messages\"]`). Those two lists do not line up:\n *\n * - the converter chunks an assistant turn and its tool messages into ONE\n *   thread message carrying only the FIRST wire id, so the anchor names the\n *   head of the previous turn instead of its last tool message;\n * - `sanitizeLangChainMessages` drops hidden-from-frontend and unconvertible\n *   entries, so a dropped tail message is invisible to the anchor too.\n *\n * Either way the host rejects the command with `wrong-anchor`\n * (`runAnchorMessageId … is not the source's parent`) AFTER the composer's\n * synchronous `send()` returned, so the retry/edit silently does nothing.\n *\n * Building the command here off the replicated raw state makes the anchor the\n * same value the host computes.\n *\n * On a windowed wire the raw list is the tail of the transcript, so the first\n * loaded message's parent is not in it: the host publishes that id as the\n * `messagesWindow` lane's `anchorBefore`, and an edit at the window edge\n * anchors there — never on `null`, which would assert the root and be\n * rejected `wrong-anchor`. A message below the loaded range has no parent on\n * this client at all; {@link resolveDeepAgentEditCommand} loads older pages\n * until it does.\n */\n\n/** The pieces of the statewire thread extras the edit path reads. */\nexport interface DeepAgentStatewireExtras {\n  /** The library's dispatch; it resolves with the host's reply to the command. */\n  sendCommand: (\n    command: StatewireThread.Command,\n    options?: StatewireThread.SendOptions,\n  ) => Promise<unknown> | void;\n  /** Optional on older hosts; capture before loading an edit's history anchor. */\n  prepareMessageMetadata?: StatewireThread.Extras['prepareMessageMetadata'];\n  discardPreparedMessageMetadata?: StatewireThread.Extras['discardPreparedMessageMetadata'];\n  sendPreparedEdit?: StatewireThread.Extras['sendPreparedEdit'];\n  isPreparingSubmission?: boolean;\n  /** The replicated host state — its `messages` are the raw wire messages. */\n  state: { messages?: readonly { id?: unknown }[] } | null;\n  /** The live run, when one is in flight; `epoch` advances on each dispatch. */\n  runs: { runId?: string | null; epoch?: number };\n  /** The host's replicated run status; absent on a surface that predates it. */\n  status?: StatewireThread.ThreadStatus;\n}\n\n/**\n * The statewire extras of the nearest aui thread, or `null` when the thread is\n * not a statewire thread (e.g. a read-only subagent transcript runtime).\n * Gated on {@link hasStatewireThreadExtras} for the same reason the approval\n * card is: the library's own hooks throw on a non-statewire thread.\n */\nexport function readDeepAgentStatewireExtras(extras: unknown): DeepAgentStatewireExtras | null {\n  if (!hasStatewireThreadExtras(extras)) return null;\n  return extras as DeepAgentStatewireExtras;\n}\n\n/**\n * The host's parent of `sourceId`: the raw wire message directly before it\n * (`null` when it is the first of the whole transcript). Returns `undefined`\n * when `sourceId` is not in the raw list at all — an optimistic bubble the\n * host has not settled yet, a message below a windowed wire's loaded range, or\n * a surface whose state this module cannot read — so the caller can fall back\n * to the library's own path instead of asserting a wrong anchor.\n *\n * On a windowed wire (`window`), the first loaded message's parent is the\n * lane's `anchorBefore`; a truncated window that carries no anchor resolves\n * `undefined` rather than `null` (the root), which the host would reject.\n */\nexport function resolveWireAnchorMessageId({\n  wireMessages,\n  sourceId,\n  window = null,\n}: {\n  wireMessages: readonly { id?: unknown }[] | undefined;\n  sourceId: string;\n  window?: DeepAgentMessagesWindow | null;\n}): string | null | undefined {\n  if (!wireMessages) return undefined;\n  const index = wireMessages.findIndex((message) => message?.id === sourceId);\n  if (index < 0) return undefined;\n  if (index === 0) {\n    if (window === null || window.start === 0) return null;\n    return window.anchorBefore ?? undefined;\n  }\n  const parentId = wireMessages[index - 1]?.id;\n  return typeof parentId === 'string' ? parentId : undefined;\n}\n\n/**\n * Whether `sourceId` lies below a windowed wire's loaded range: not in the raw\n * list while the lane says older messages exist. The caller loads older\n * history before an edit can be anchored.\n */\nexport function isSourceBelowLoadedWindow({\n  wireMessages,\n  sourceId,\n  window,\n}: {\n  wireMessages: readonly { id?: unknown }[] | undefined;\n  sourceId: string;\n  window: DeepAgentMessagesWindow | null;\n}): boolean {\n  if (!wireMessages || window === null || window.start === 0) return false;\n  return !wireMessages.some((message) => message?.id === sourceId);\n}\n\n/**\n * A fresh command / message id (uniqueness, not secrecy). `crypto.randomUUID`\n * where the host runtime has it — every browser, Bun, Node and Hermes with\n * webcrypto — and a v4-shaped fallback elsewhere, so the shared path never\n * throws on a runtime without full webcrypto.\n */\nfunction mintCommandId(): string {\n  const webcrypto = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (typeof webcrypto?.randomUUID === 'function') return webcrypto.randomUUID();\n  const hex = (): string => Math.floor(Math.random() * 0x10000).toString(16).padStart(4, '0');\n  return `${hex()}${hex()}-${hex()}-4${hex().slice(1)}-${hex()}-${hex()}${hex()}${hex()}`;\n}\n\n/**\n * The `run/edit` command for resubmitting `sourceId` with `text`, anchored on\n * the host's own parent. `null` when the anchor cannot be resolved from the\n * replicated state.\n */\nexport function buildDeepAgentEditCommand({\n  extras,\n  sourceId,\n  text,\n}: {\n  extras: DeepAgentStatewireExtras;\n  sourceId: string;\n  text: string;\n}): StatewireThread.RunEditCommand | null {\n  const runAnchorMessageId = resolveWireAnchorMessageId({\n    wireMessages: extras.state?.messages,\n    sourceId,\n    window: readDeepAgentMessagesWindow(extras.state),\n  });\n  if (runAnchorMessageId === undefined) return null;\n  return {\n    type: 'run/edit',\n    runId: extras.runs.runId ?? mintCommandId(),\n    message: { id: mintCommandId(), role: 'user', parts: [{ type: 'text', text }] },\n    sourceId,\n    runAnchorMessageId,\n  };\n}\n\n/**\n * Pages of older history loaded while looking for an edited message's host\n * parent. Each page is up to a window's worth of messages, so an edit reaches\n * this many windows below what was loaded before it gives up.\n */\nexport const MAX_EDIT_ANCHOR_HISTORY_LOADS = 5;\n\n/**\n * The anchored `run/edit` for `sourceId`, loading older history a page at a\n * time when the message lies below a windowed wire's loaded range. Every page\n * is read back from the live thread state (`readExtras` — the host prepends\n * it as ops before it answers the command), so the anchor is always the host's\n * own parent id.\n *\n * Resolves `null` — the caller's cue for the library's composer path, whose\n * failure it reports — when the thread is not a statewire thread, the host has\n * not settled the message, the history is exhausted without it, or the page\n * budget ({@link MAX_EDIT_ANCHOR_HISTORY_LOADS}) is spent. A synchronous\n * resolution never awaits: the first read either anchors at once or decides\n * that pages are needed.\n */\nexport async function resolveDeepAgentEditCommand({\n  readExtras,\n  sourceId,\n  text,\n  maxHistoryLoads = MAX_EDIT_ANCHOR_HISTORY_LOADS,\n}: {\n  /** The live thread extras — re-read per page so each anchor attempt sees the prepended range. */\n  readExtras: () => DeepAgentStatewireExtras | null;\n  sourceId: string;\n  text: string;\n  maxHistoryLoads?: number;\n}): Promise<StatewireThread.RunEditCommand | null> {\n  for (let page = 0; page <= maxHistoryLoads; page += 1) {\n    const extras = readExtras();\n    if (!extras) return null;\n    const command = buildDeepAgentEditCommand({ extras, sourceId, text });\n    if (command) return command;\n    if (page === maxHistoryLoads) return null;\n    const wireMessages = extras.state?.messages;\n    const window = readDeepAgentMessagesWindow(extras.state);\n    if (!isSourceBelowLoadedWindow({ wireMessages, sourceId, window })) return null;\n    const load = window === null ? null : buildHistoryLoadCommand({ window });\n    if (load === null) return null;\n    const result = readHistoryLoadResult(await extras.sendCommand(load));\n    // A current view that yielded nothing older: the message is not in this\n    // thread's history at all. (A stale view is retried with the fresh lane.)\n    if (result === null || (result.loaded === 0 && !result.stale)) return null;\n  }\n  return null;\n}\n"],"names":[],"mappings":";;AAmEO,SAAS,6BAA6B,QAAkD;AAC7F,MAAI,CAAC,yBAAyB,MAAM,EAAG,QAAO;AAC9C,SAAO;AACT;AAcO,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA;AAAA,EACA,SAAS;AACX,GAI8B;;AAC5B,MAAI,CAAC,aAAc,QAAO;AAC1B,QAAM,QAAQ,aAAa,UAAU,CAAC,aAAY,mCAAS,QAAO,QAAQ;AAC1E,MAAI,QAAQ,EAAG,QAAO;AACtB,MAAI,UAAU,GAAG;AACf,QAAI,WAAW,QAAQ,OAAO,UAAU,EAAG,QAAO;AAClD,WAAO,OAAO,gBAAgB;AAAA,EAChC;AACA,QAAM,YAAW,kBAAa,QAAQ,CAAC,MAAtB,mBAAyB;AAC1C,SAAO,OAAO,aAAa,WAAW,WAAW;AACnD;AAOO,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,GAIY;AACV,MAAI,CAAC,gBAAgB,WAAW,QAAQ,OAAO,UAAU,EAAG,QAAO;AACnE,SAAO,CAAC,aAAa,KAAK,CAAC,aAAY,mCAAS,QAAO,QAAQ;AACjE;AAQA,SAAS,gBAAwB;AAC/B,QAAM,YAAa,WAA0D;AAC7E,MAAI,QAAO,uCAAW,gBAAe,WAAY,QAAO,UAAU,WAAA;AAClE,QAAM,MAAM,MAAc,KAAK,MAAM,KAAK,OAAA,IAAW,KAAO,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAC1F,SAAO,GAAG,IAAA,CAAK,GAAG,IAAA,CAAK,IAAI,IAAA,CAAK,KAAK,MAAM,MAAM,CAAC,CAAC,IAAI,IAAA,CAAK,IAAI,KAAK,GAAG,IAAA,CAAK,GAAG,IAAA,CAAK;AACvF;AAOO,SAAS,0BAA0B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AACF,GAI0C;;AACxC,QAAM,qBAAqB,2BAA2B;AAAA,IACpD,eAAc,YAAO,UAAP,mBAAc;AAAA,IAC5B;AAAA,IACA,QAAQ,4BAA4B,OAAO,KAAK;AAAA,EAAA,CACjD;AACD,MAAI,uBAAuB,OAAW,QAAO;AAC7C,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,OAAO,KAAK,SAAS,cAAA;AAAA,IAC5B,SAAS,EAAE,IAAI,cAAA,GAAiB,MAAM,QAAQ,OAAO,CAAC,EAAE,MAAM,QAAQ,KAAA,CAAM,EAAA;AAAA,IAC5E;AAAA,IACA;AAAA,EAAA;AAEJ;AAOO,MAAM,gCAAgC;AAgB7C,eAAsB,4BAA4B;AAAA,EAChD;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AACpB,GAMmD;;AACjD,WAAS,OAAO,GAAG,QAAQ,iBAAiB,QAAQ,GAAG;AACrD,UAAM,SAAS,WAAA;AACf,QAAI,CAAC,OAAQ,QAAO;AACpB,UAAM,UAAU,0BAA0B,EAAE,QAAQ,UAAU,MAAM;AACpE,QAAI,QAAS,QAAO;AACpB,QAAI,SAAS,gBAAiB,QAAO;AACrC,UAAM,gBAAe,YAAO,UAAP,mBAAc;AACnC,UAAM,SAAS,4BAA4B,OAAO,KAAK;AACvD,QAAI,CAAC,0BAA0B,EAAE,cAAc,UAAU,OAAA,CAAQ,EAAG,QAAO;AAC3E,UAAM,OAAO,WAAW,OAAO,OAAO,wBAAwB,EAAE,QAAQ;AACxE,QAAI,SAAS,KAAM,QAAO;AAC1B,UAAM,SAAS,sBAAsB,MAAM,OAAO,YAAY,IAAI,CAAC;AAGnE,QAAI,WAAW,QAAS,OAAO,WAAW,KAAK,CAAC,OAAO,MAAQ,QAAO;AAAA,EACxE;AACA,SAAO;AACT;"}

package/dist/packages/agent-runtime/src/errors.cjs

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function statewireRejectionPayload(error) {
+  const failure = error == null ? void 0 : error.failure;
+  if ((failure == null ? void 0 : failure.fate) !== "rejected") return null;
+  const payload = failure.payload;
+  if (typeof (payload == null ? void 0 : payload.status) !== "number") return null;
+  return { status: payload.status, detail: payload.detail };
+}
+function statewireRejectionDetailMessage(error) {
+  var _a;
+  const detail = (_a = statewireRejectionPayload(error)) == null ? void 0 : _a.detail;
+  if (typeof detail === "string") return detail.length > 0 ? detail : null;
+  if (detail === null || typeof detail !== "object" || Array.isArray(detail)) return null;
+  const message = detail.message;
+  return typeof message === "string" && message.length > 0 ? message : null;
+}
+function readRetryableDetail(detail) {
+  if (detail === null || typeof detail !== "object" || Array.isArray(detail)) return null;
+  const { code, message, retryable } = detail;
+  if (retryable !== true || typeof code !== "string" || code.length === 0) return null;
+  return { code, message: typeof message === "string" && message.length > 0 ? message : null };
+}
+function readRetryableRunRefusal(error) {
+  if (error === null || typeof error !== "object" || Array.isArray(error)) return null;
+  return readRetryableDetail(error.detail);
+}
+function isLegacyThreadReadOnlyRejection(error) {
+  const payload = statewireRejectionPayload(error);
+  if ((payload == null ? void 0 : payload.status) !== 409) return false;
+  const detail = payload.detail;
+  return (detail == null ? void 0 : detail.code) === "legacy_thread_read_only";
+}
+function isStatewireChannelTeardown(error) {
+  var _a;
+  const cause = (_a = error == null ? void 0 : error.failure) == null ? void 0 : _a.cause;
+  return typeof cause === "string" && cause !== "server";
+}
+const sanitizeConnectionMessage = (message) => {
+  const printable = Array.from(message, (character) => {
+    const code = character.charCodeAt(0);
+    return code < 32 || code === 127 ? " " : character;
+  }).join("").replace(/\s+/g, " ").trim();
+  return printable ? printable.slice(0, 200) : void 0;
+};
+function projectDeepAgentConnection(connection) {
+  const message = "message" in connection && typeof connection.message === "string" ? sanitizeConnectionMessage(connection.message) : void 0;
+  switch (connection.status) {
+    case "standby":
+      return {
+        status: connection.status,
+        reason: connection.reason,
+        degraded: connection.degraded,
+        ...message !== void 0 && { message }
+      };
+    case "connecting":
+    case "connected":
+      return { status: connection.status, degraded: connection.degraded };
+    case "retrying":
+      return {
+        status: connection.status,
+        degraded: connection.degraded,
+        attempt: connection.attempt,
+        ...connection.cause !== void 0 && { cause: connection.cause },
+        ...connection.code !== void 0 && { code: connection.code },
+        ...connection.nextRetryAt !== void 0 && { nextRetryAt: connection.nextRetryAt },
+        ...connection.lastError !== void 0 && { lastError: connection.lastError },
+        ...message !== void 0 && { message }
+      };
+    case "stopped":
+      return {
+        status: connection.status,
+        degraded: connection.degraded,
+        reason: connection.reason,
+        ...connection.payload !== void 0 && { payload: connection.payload },
+        ...message !== void 0 && { message }
+      };
+    default:
+      return unknownConnectionStatus(connection);
+  }
+}
+function unknownConnectionStatus(connection) {
+  throw new Error(
+    `statewire: unknown connection status ${JSON.stringify(
+      connection.status
+    )}`
+  );
+}
+exports.isLegacyThreadReadOnlyRejection = isLegacyThreadReadOnlyRejection;
+exports.isStatewireChannelTeardown = isStatewireChannelTeardown;
+exports.projectDeepAgentConnection = projectDeepAgentConnection;
+exports.readRetryableRunRefusal = readRetryableRunRefusal;
+exports.statewireRejectionDetailMessage = statewireRejectionDetailMessage;
+exports.statewireRejectionPayload = statewireRejectionPayload;
+//# sourceMappingURL=errors.cjs.map

package/dist/packages/agent-runtime/src/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sources":["../../../../../agent-runtime/src/errors.ts"],"sourcesContent":["import type { StatewireClient } from 'statewire';\nimport type { DeepAgentConnectionState } from './types';\n\n/** Structured payload attached to a server-rejected Statewire command. */\nexport interface StatewireRejectionPayload {\n  status: number;\n  detail: unknown;\n}\n\n/** Return a rejected command's structured `{ status, detail }` payload. */\nexport function statewireRejectionPayload(error: unknown): StatewireRejectionPayload | null {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null)?.failure;\n  if (failure?.fate !== 'rejected') return null;\n\n  const payload = failure.payload as { status?: unknown; detail?: unknown } | undefined;\n  if (typeof payload?.status !== 'number') return null;\n  return { status: payload.status, detail: payload.detail };\n}\n\n/**\n * The server's human-readable reason for a rejected command — `detail.message`\n * (or a plain-string `detail`) — else `null`. Hosts surface it as send\n * feedback so the user sees the actionable cause instead of the generic\n * client-side `command rejected (<status>)`.\n */\nexport function statewireRejectionDetailMessage(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (typeof detail === 'string') return detail.length > 0 ? detail : null;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const message = (detail as { message?: unknown }).message;\n  return typeof message === 'string' && message.length > 0 ? message : null;\n}\n\n/**\n * A structured, retryable refusal the host recorded as the run error\n * (`runs.error`): the dispatch never started — the pod or instance was\n * closing (`pod_draining`) — and the entries stayed in their lanes for the\n * thread's next placement. Distinct from a rejected COMMAND\n * ({@link statewireRejectionPayload}): this is the shape harness-sdk writes\n * when the run executor raises the rejection, so it lives on the replicated\n * run entry, not on a command settle.\n */\nexport interface RetryableRunRefusal {\n  /** The structured `detail.code` (`pod_draining`). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\n/** The `{ code, message, retryable: true }` detail of a structured refusal, or `null`. */\nfunction readRetryableDetail(detail: unknown): { code: string; message: string | null } | null {\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable !== true || typeof code !== 'string' || code.length === 0) return null;\n  return { code, message: typeof message === 'string' && message.length > 0 ? message : null };\n}\n\nexport function readRetryableRunRefusal(error: unknown): RetryableRunRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  return readRetryableDetail((error as { detail?: unknown }).detail);\n}\n\n/**\n * A structured, retryable refusal of a COMMAND, read off its rejection\n * ({@link statewireRejectionPayload}): the host's `_structured_reject(...,\n * retryable=True)` envelope — `command_auth_context_expired` when a pod\n * replacement dropped the socket-scoped auth a replayed command needed,\n * `pod_draining` when the host was closing. The command never ran, and the\n * host itself says a resend after the reconnect will; `detail.code` is the\n * wire-frozen contract clients classify on. Same shape as\n * {@link readRetryableRunRefusal}, which reads it off a replicated run entry.\n */\nexport interface RetryableCommandRejection {\n  /** The structured `detail.code`. */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\nexport function readRetryableCommandRejection(error: unknown): RetryableCommandRejection | null {\n  const payload = statewireRejectionPayload(error);\n  return payload === null ? null : readRetryableDetail(payload.detail);\n}\n\n/** The host's `detail.code` for a command replayed onto a pod that could not restore its auth context. */\nexport const STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED = 'command_auth_context_expired';\n\n/**\n * Whether a rejected command hit the host's fail-closed auth recovery: the\n * command was replayed onto a replacement pod that could not restore the\n * attach's auth context, so it was refused unrun (503, retryable). The\n * reconnect already under way restores the context; a single resend after it\n * is the recovery, not a failure to report.\n */\nexport function isStatewireCommandAuthContextExpired(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  return (\n    payload?.status === 503 &&\n    readRetryableDetail(payload.detail)?.code === STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED\n  );\n}\n\n/**\n * Whether a rejected command hit the legacy-thread dispatch fence: the\n * structured 409 the server answers when an out-of-band run is writing a\n * pre-cutover thread (or its adoption failed). A per-send failure — the\n * snapshot never carries a standing read-only flag.\n */\nexport function isLegacyThreadReadOnlyRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 409) return false;\n\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'legacy_thread_read_only';\n}\n\n/**\n * Whether a rejected command was refused because its rewind anchor no longer\n * matches the host's parent for the edited message (`wrong-anchor`).\n *\n * A retry/edit resubmit is dispatched optimistically, so this rejection lands\n * after the UI already cleared its edit affordances: the turn simply never\n * re-runs. Callers use this to tell the user the resubmit was dropped instead\n * of leaving a console-only failure.\n */\nexport function isStatewireRewindAnchorRejection(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null | undefined)\n    ?.failure;\n  if (failure?.fate !== 'rejected') return false;\n  return (failure.payload as { reason?: unknown } | undefined)?.reason === 'wrong-anchor';\n}\n\n/**\n * Whether a statewire send failure is the host's `expired` verdict\n * (`result-unavailable`): the command's seq was at or below the host's\n * admitted watermark and no retained result was left for it. Either the\n * command ran and settled but the client re-asked for the answer (a resend\n * after the stream came back) only after the host had let the retained result\n * go, or the seq was already admitted and the command was absorbed as a\n * duplicate without ever running — a client whose shared session record fell\n * behind the watermark stays there until a reconnect re-syncs it. The library\n * never reruns the command on replay, so for an idempotent read the answer is\n * simply gone — asking again is the correct reaction, not reporting a failure;\n * a write cannot assume it was applied.\n */\nexport function isStatewireExpiredVerdict(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; cause?: unknown } | null | undefined })\n    ?.failure;\n  return failure?.fate === 'expired' && failure.cause === 'server';\n}\n\n/**\n * Whether a statewire send failure is a local channel death rather than a\n * command error.\n *\n * The library's contract for `SendFailure.cause`: `\"server\"` is the server's\n * own answer; every other cause is \"a channel death the client settled\n * locally\" — `unmount`, `stream-gone`, and `session-lost`. A thread switch\n * settles every in-flight command that way, so logging these at error level\n * reports two failures for an ordinary switch and buries the ones that mean\n * something.\n *\n * Channel health is already surfaced where it belongs: the connection\n * indicator renders the connection state. This\n * predicate only decides the log level.\n */\nexport function isStatewireChannelTeardown(error: unknown): boolean {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  return typeof cause === 'string' && cause !== 'server';\n}\n\n/**\n * The low-cardinality reason a statewire send settled as transport weather\n * rather than a defect, or `null` when the failure is a real error.\n *\n * Three families qualify: a channel death the client settled locally\n * ({@link isStatewireChannelTeardown} — the cause: `unmount`, `stream-gone`,\n * `session-lost`), the host's `expired` verdict\n * ({@link isStatewireExpiredVerdict} — the answer outlived the host's\n * retention before the post-reconnect resend collected it), and a retryable\n * structured rejection ({@link readRetryableCommandRejection} — its code: the\n * host asked for a resend). In every case the sender's own retry or poll is\n * the recovery and the connection indicator already shows the channel, so\n * error reporting counts the outcome instead of paging on it. Handler\n * failures, crashes, and non-retryable rejections stay `null`: those are\n * defects to page on.\n */\nexport function statewireTransportOutcome(error: unknown): string | null {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  if (typeof cause === 'string' && cause !== 'server') return cause;\n  if (isStatewireExpiredVerdict(error)) return 'expired';\n  return readRetryableCommandRejection(error)?.code ?? null;\n}\n\nconst sanitizeConnectionMessage = (message: string): string | undefined => {\n  const printable = Array.from(message, (character) => {\n    const code = character.charCodeAt(0);\n    return code < 32 || code === 127 ? ' ' : character;\n  })\n    .join('')\n    .replace(/\\s+/g, ' ')\n    .trim();\n  return printable ? printable.slice(0, 200) : undefined;\n};\n\n/** Preserve the Statewire lifecycle and sanitize host detail for display. */\nexport function projectDeepAgentConnection(\n  connection: StatewireClient.ConnectionState\n): DeepAgentConnectionState {\n  const message =\n    'message' in connection && typeof connection.message === 'string'\n      ? sanitizeConnectionMessage(connection.message)\n      : undefined;\n  switch (connection.status) {\n    case 'standby':\n      return {\n        status: connection.status,\n        reason: connection.reason,\n        degraded: connection.degraded,\n        ...(message !== undefined && { message }),\n      };\n    case 'connecting':\n    case 'connected':\n      return { status: connection.status, degraded: connection.degraded };\n    case 'retrying':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        attempt: connection.attempt,\n        ...(connection.cause !== undefined && { cause: connection.cause }),\n        ...(connection.code !== undefined && { code: connection.code }),\n        ...(connection.nextRetryAt !== undefined && { nextRetryAt: connection.nextRetryAt }),\n        ...(connection.lastError !== undefined && { lastError: connection.lastError }),\n        ...(message !== undefined && { message }),\n      };\n    case 'stopped':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        reason: connection.reason,\n        ...(connection.payload !== undefined && { payload: connection.payload }),\n        ...(message !== undefined && { message }),\n      };\n    default:\n      return unknownConnectionStatus(connection);\n  }\n}\n\n/** Compile-time exhaustiveness: reachable only when the library grows a status this build does not project. */\nfunction unknownConnectionStatus(connection: never): never {\n  throw new Error(\n    `statewire: unknown connection status ${JSON.stringify(\n      (connection as { status?: unknown }).status\n    )}`\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/packages/agent-runtime/src/errors.js

@@ -0,0 +1,95 @@
+function statewireRejectionPayload(error) {
+  const failure = error == null ? void 0 : error.failure;
+  if ((failure == null ? void 0 : failure.fate) !== "rejected") return null;
+  const payload = failure.payload;
+  if (typeof (payload == null ? void 0 : payload.status) !== "number") return null;
+  return { status: payload.status, detail: payload.detail };
+}
+function statewireRejectionDetailMessage(error) {
+  var _a;
+  const detail = (_a = statewireRejectionPayload(error)) == null ? void 0 : _a.detail;
+  if (typeof detail === "string") return detail.length > 0 ? detail : null;
+  if (detail === null || typeof detail !== "object" || Array.isArray(detail)) return null;
+  const message = detail.message;
+  return typeof message === "string" && message.length > 0 ? message : null;
+}
+function readRetryableDetail(detail) {
+  if (detail === null || typeof detail !== "object" || Array.isArray(detail)) return null;
+  const { code, message, retryable } = detail;
+  if (retryable !== true || typeof code !== "string" || code.length === 0) return null;
+  return { code, message: typeof message === "string" && message.length > 0 ? message : null };
+}
+function readRetryableRunRefusal(error) {
+  if (error === null || typeof error !== "object" || Array.isArray(error)) return null;
+  return readRetryableDetail(error.detail);
+}
+function isLegacyThreadReadOnlyRejection(error) {
+  const payload = statewireRejectionPayload(error);
+  if ((payload == null ? void 0 : payload.status) !== 409) return false;
+  const detail = payload.detail;
+  return (detail == null ? void 0 : detail.code) === "legacy_thread_read_only";
+}
+function isStatewireChannelTeardown(error) {
+  var _a;
+  const cause = (_a = error == null ? void 0 : error.failure) == null ? void 0 : _a.cause;
+  return typeof cause === "string" && cause !== "server";
+}
+const sanitizeConnectionMessage = (message) => {
+  const printable = Array.from(message, (character) => {
+    const code = character.charCodeAt(0);
+    return code < 32 || code === 127 ? " " : character;
+  }).join("").replace(/\s+/g, " ").trim();
+  return printable ? printable.slice(0, 200) : void 0;
+};
+function projectDeepAgentConnection(connection) {
+  const message = "message" in connection && typeof connection.message === "string" ? sanitizeConnectionMessage(connection.message) : void 0;
+  switch (connection.status) {
+    case "standby":
+      return {
+        status: connection.status,
+        reason: connection.reason,
+        degraded: connection.degraded,
+        ...message !== void 0 && { message }
+      };
+    case "connecting":
+    case "connected":
+      return { status: connection.status, degraded: connection.degraded };
+    case "retrying":
+      return {
+        status: connection.status,
+        degraded: connection.degraded,
+        attempt: connection.attempt,
+        ...connection.cause !== void 0 && { cause: connection.cause },
+        ...connection.code !== void 0 && { code: connection.code },
+        ...connection.nextRetryAt !== void 0 && { nextRetryAt: connection.nextRetryAt },
+        ...connection.lastError !== void 0 && { lastError: connection.lastError },
+        ...message !== void 0 && { message }
+      };
+    case "stopped":
+      return {
+        status: connection.status,
+        degraded: connection.degraded,
+        reason: connection.reason,
+        ...connection.payload !== void 0 && { payload: connection.payload },
+        ...message !== void 0 && { message }
+      };
+    default:
+      return unknownConnectionStatus(connection);
+  }
+}
+function unknownConnectionStatus(connection) {
+  throw new Error(
+    `statewire: unknown connection status ${JSON.stringify(
+      connection.status
+    )}`
+  );
+}
+export {
+  isLegacyThreadReadOnlyRejection,
+  isStatewireChannelTeardown,
+  projectDeepAgentConnection,
+  readRetryableRunRefusal,
+  statewireRejectionDetailMessage,
+  statewireRejectionPayload
+};
+//# sourceMappingURL=errors.js.map

package/dist/packages/agent-runtime/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../../../../../agent-runtime/src/errors.ts"],"sourcesContent":["import type { StatewireClient } from 'statewire';\nimport type { DeepAgentConnectionState } from './types';\n\n/** Structured payload attached to a server-rejected Statewire command. */\nexport interface StatewireRejectionPayload {\n  status: number;\n  detail: unknown;\n}\n\n/** Return a rejected command's structured `{ status, detail }` payload. */\nexport function statewireRejectionPayload(error: unknown): StatewireRejectionPayload | null {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null)?.failure;\n  if (failure?.fate !== 'rejected') return null;\n\n  const payload = failure.payload as { status?: unknown; detail?: unknown } | undefined;\n  if (typeof payload?.status !== 'number') return null;\n  return { status: payload.status, detail: payload.detail };\n}\n\n/**\n * The server's human-readable reason for a rejected command — `detail.message`\n * (or a plain-string `detail`) — else `null`. Hosts surface it as send\n * feedback so the user sees the actionable cause instead of the generic\n * client-side `command rejected (<status>)`.\n */\nexport function statewireRejectionDetailMessage(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (typeof detail === 'string') return detail.length > 0 ? detail : null;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const message = (detail as { message?: unknown }).message;\n  return typeof message === 'string' && message.length > 0 ? message : null;\n}\n\n/**\n * A structured, retryable refusal the host recorded as the run error\n * (`runs.error`): the dispatch never started — the pod or instance was\n * closing (`pod_draining`) — and the entries stayed in their lanes for the\n * thread's next placement. Distinct from a rejected COMMAND\n * ({@link statewireRejectionPayload}): this is the shape harness-sdk writes\n * when the run executor raises the rejection, so it lives on the replicated\n * run entry, not on a command settle.\n */\nexport interface RetryableRunRefusal {\n  /** The structured `detail.code` (`pod_draining`). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\n/** The `{ code, message, retryable: true }` detail of a structured refusal, or `null`. */\nfunction readRetryableDetail(detail: unknown): { code: string; message: string | null } | null {\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const { code, message, retryable } = detail as {\n    code?: unknown;\n    message?: unknown;\n    retryable?: unknown;\n  };\n  if (retryable !== true || typeof code !== 'string' || code.length === 0) return null;\n  return { code, message: typeof message === 'string' && message.length > 0 ? message : null };\n}\n\nexport function readRetryableRunRefusal(error: unknown): RetryableRunRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  return readRetryableDetail((error as { detail?: unknown }).detail);\n}\n\n/**\n * A structured, retryable refusal of a COMMAND, read off its rejection\n * ({@link statewireRejectionPayload}): the host's `_structured_reject(...,\n * retryable=True)` envelope — `command_auth_context_expired` when a pod\n * replacement dropped the socket-scoped auth a replayed command needed,\n * `pod_draining` when the host was closing. The command never ran, and the\n * host itself says a resend after the reconnect will; `detail.code` is the\n * wire-frozen contract clients classify on. Same shape as\n * {@link readRetryableRunRefusal}, which reads it off a replicated run entry.\n */\nexport interface RetryableCommandRejection {\n  /** The structured `detail.code`. */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n}\n\nexport function readRetryableCommandRejection(error: unknown): RetryableCommandRejection | null {\n  const payload = statewireRejectionPayload(error);\n  return payload === null ? null : readRetryableDetail(payload.detail);\n}\n\n/** The host's `detail.code` for a command replayed onto a pod that could not restore its auth context. */\nexport const STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED = 'command_auth_context_expired';\n\n/**\n * Whether a rejected command hit the host's fail-closed auth recovery: the\n * command was replayed onto a replacement pod that could not restore the\n * attach's auth context, so it was refused unrun (503, retryable). The\n * reconnect already under way restores the context; a single resend after it\n * is the recovery, not a failure to report.\n */\nexport function isStatewireCommandAuthContextExpired(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  return (\n    payload?.status === 503 &&\n    readRetryableDetail(payload.detail)?.code === STATEWIRE_COMMAND_AUTH_CONTEXT_EXPIRED\n  );\n}\n\n/**\n * Whether a rejected command hit the legacy-thread dispatch fence: the\n * structured 409 the server answers when an out-of-band run is writing a\n * pre-cutover thread (or its adoption failed). A per-send failure — the\n * snapshot never carries a standing read-only flag.\n */\nexport function isLegacyThreadReadOnlyRejection(error: unknown): boolean {\n  const payload = statewireRejectionPayload(error);\n  if (payload?.status !== 409) return false;\n\n  const detail = payload.detail as { code?: unknown } | undefined;\n  return detail?.code === 'legacy_thread_read_only';\n}\n\n/**\n * Whether a rejected command was refused because its rewind anchor no longer\n * matches the host's parent for the edited message (`wrong-anchor`).\n *\n * A retry/edit resubmit is dispatched optimistically, so this rejection lands\n * after the UI already cleared its edit affordances: the turn simply never\n * re-runs. Callers use this to tell the user the resubmit was dropped instead\n * of leaving a console-only failure.\n */\nexport function isStatewireRewindAnchorRejection(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; payload?: unknown } } | null | undefined)\n    ?.failure;\n  if (failure?.fate !== 'rejected') return false;\n  return (failure.payload as { reason?: unknown } | undefined)?.reason === 'wrong-anchor';\n}\n\n/**\n * Whether a statewire send failure is the host's `expired` verdict\n * (`result-unavailable`): the command's seq was at or below the host's\n * admitted watermark and no retained result was left for it. Either the\n * command ran and settled but the client re-asked for the answer (a resend\n * after the stream came back) only after the host had let the retained result\n * go, or the seq was already admitted and the command was absorbed as a\n * duplicate without ever running — a client whose shared session record fell\n * behind the watermark stays there until a reconnect re-syncs it. The library\n * never reruns the command on replay, so for an idempotent read the answer is\n * simply gone — asking again is the correct reaction, not reporting a failure;\n * a write cannot assume it was applied.\n */\nexport function isStatewireExpiredVerdict(error: unknown): boolean {\n  const failure = (error as { failure?: { fate?: unknown; cause?: unknown } | null | undefined })\n    ?.failure;\n  return failure?.fate === 'expired' && failure.cause === 'server';\n}\n\n/**\n * Whether a statewire send failure is a local channel death rather than a\n * command error.\n *\n * The library's contract for `SendFailure.cause`: `\"server\"` is the server's\n * own answer; every other cause is \"a channel death the client settled\n * locally\" — `unmount`, `stream-gone`, and `session-lost`. A thread switch\n * settles every in-flight command that way, so logging these at error level\n * reports two failures for an ordinary switch and buries the ones that mean\n * something.\n *\n * Channel health is already surfaced where it belongs: the connection\n * indicator renders the connection state. This\n * predicate only decides the log level.\n */\nexport function isStatewireChannelTeardown(error: unknown): boolean {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  return typeof cause === 'string' && cause !== 'server';\n}\n\n/**\n * The low-cardinality reason a statewire send settled as transport weather\n * rather than a defect, or `null` when the failure is a real error.\n *\n * Three families qualify: a channel death the client settled locally\n * ({@link isStatewireChannelTeardown} — the cause: `unmount`, `stream-gone`,\n * `session-lost`), the host's `expired` verdict\n * ({@link isStatewireExpiredVerdict} — the answer outlived the host's\n * retention before the post-reconnect resend collected it), and a retryable\n * structured rejection ({@link readRetryableCommandRejection} — its code: the\n * host asked for a resend). In every case the sender's own retry or poll is\n * the recovery and the connection indicator already shows the channel, so\n * error reporting counts the outcome instead of paging on it. Handler\n * failures, crashes, and non-retryable rejections stay `null`: those are\n * defects to page on.\n */\nexport function statewireTransportOutcome(error: unknown): string | null {\n  const cause = (error as { failure?: { cause?: unknown } } | null | undefined)?.failure?.cause;\n  if (typeof cause === 'string' && cause !== 'server') return cause;\n  if (isStatewireExpiredVerdict(error)) return 'expired';\n  return readRetryableCommandRejection(error)?.code ?? null;\n}\n\nconst sanitizeConnectionMessage = (message: string): string | undefined => {\n  const printable = Array.from(message, (character) => {\n    const code = character.charCodeAt(0);\n    return code < 32 || code === 127 ? ' ' : character;\n  })\n    .join('')\n    .replace(/\\s+/g, ' ')\n    .trim();\n  return printable ? printable.slice(0, 200) : undefined;\n};\n\n/** Preserve the Statewire lifecycle and sanitize host detail for display. */\nexport function projectDeepAgentConnection(\n  connection: StatewireClient.ConnectionState\n): DeepAgentConnectionState {\n  const message =\n    'message' in connection && typeof connection.message === 'string'\n      ? sanitizeConnectionMessage(connection.message)\n      : undefined;\n  switch (connection.status) {\n    case 'standby':\n      return {\n        status: connection.status,\n        reason: connection.reason,\n        degraded: connection.degraded,\n        ...(message !== undefined && { message }),\n      };\n    case 'connecting':\n    case 'connected':\n      return { status: connection.status, degraded: connection.degraded };\n    case 'retrying':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        attempt: connection.attempt,\n        ...(connection.cause !== undefined && { cause: connection.cause }),\n        ...(connection.code !== undefined && { code: connection.code }),\n        ...(connection.nextRetryAt !== undefined && { nextRetryAt: connection.nextRetryAt }),\n        ...(connection.lastError !== undefined && { lastError: connection.lastError }),\n        ...(message !== undefined && { message }),\n      };\n    case 'stopped':\n      return {\n        status: connection.status,\n        degraded: connection.degraded,\n        reason: connection.reason,\n        ...(connection.payload !== undefined && { payload: connection.payload }),\n        ...(message !== undefined && { message }),\n      };\n    default:\n      return unknownConnectionStatus(connection);\n  }\n}\n\n/** Compile-time exhaustiveness: reachable only when the library grows a status this build does not project. */\nfunction unknownConnectionStatus(connection: never): never {\n  throw new Error(\n    `statewire: unknown connection status ${JSON.stringify(\n      (connection as { status?: unknown }).status\n    )}`\n  );\n}\n"],"names":[],"mappings":"AAUO,SAAS,0BAA0B,OAAkD;AAC1F,QAAM,UAAW,+BAAsE;AACvF,OAAI,mCAAS,UAAS,WAAY,QAAO;AAEzC,QAAM,UAAU,QAAQ;AACxB,MAAI,QAAO,mCAAS,YAAW,SAAU,QAAO;AAChD,SAAO,EAAE,QAAQ,QAAQ,QAAQ,QAAQ,QAAQ,OAAA;AACnD;AAQO,SAAS,gCAAgC,OAA+B;AAfxE;AAgBL,QAAM,UAAS,+BAA0B,KAAK,MAA/B,mBAAkC;AACjD,MAAI,OAAO,WAAW,iBAAiB,OAAO,SAAS,IAAI,SAAS;AACpE,MAAI,WAAW,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,EAAG,QAAO;AACnF,QAAM,UAAW,OAAiC;AAClD,SAAO,OAAO,YAAY,YAAY,QAAQ,SAAS,IAAI,UAAU;AACvE;AAmBA,SAAS,oBAAoB,QAAkE;AAC7F,MAAI,WAAW,QAAQ,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,EAAG,QAAO;AACnF,QAAM,EAAE,MAAM,SAAS,UAAA,IAAc;AAKrC,MAAI,cAAc,QAAQ,OAAO,SAAS,YAAY,KAAK,WAAW,EAAG,QAAO;AAChF,SAAO,EAAE,MAAM,SAAS,OAAO,YAAY,YAAY,QAAQ,SAAS,IAAI,UAAU,KAAA;AACxF;AAEO,SAAS,wBAAwB,OAA4C;AAClF,MAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,SAAO,oBAAqB,MAA+B,MAAM;AACnE;AAgDO,SAAS,gCAAgC,OAAyB;AACvE,QAAM,UAAU,0BAA0B,KAAK;AAC/C,OAAI,mCAAS,YAAW,IAAK,QAAO;AAEpC,QAAM,SAAS,QAAQ;AACvB,UAAO,iCAAQ,UAAS;AAC1B;AAoDO,SAAS,2BAA2B,OAAyB;AAhK7D;AAiKL,QAAM,SAAS,oCAAgE,YAAhE,mBAAyE;AACxF,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAyBA,MAAM,4BAA4B,CAAC,YAAwC;AACzE,QAAM,YAAY,MAAM,KAAK,SAAS,CAAC,cAAc;AACnD,UAAM,OAAO,UAAU,WAAW,CAAC;AACnC,WAAO,OAAO,MAAM,SAAS,MAAM,MAAM;AAAA,EAC3C,CAAC,EACE,KAAK,EAAE,EACP,QAAQ,QAAQ,GAAG,EACnB,KAAA;AACH,SAAO,YAAY,UAAU,MAAM,GAAG,GAAG,IAAI;AAC/C;AAGO,SAAS,2BACd,YAC0B;AAC1B,QAAM,UACJ,aAAa,cAAc,OAAO,WAAW,YAAY,WACrD,0BAA0B,WAAW,OAAO,IAC5C;AACN,UAAQ,WAAW,QAAA;AAAA,IACjB,KAAK;AACH,aAAO;AAAA,QACL,QAAQ,WAAW;AAAA,QACnB,QAAQ,WAAW;AAAA,QACnB,UAAU,WAAW;AAAA,QACrB,GAAI,YAAY,UAAa,EAAE,QAAA;AAAA,MAAQ;AAAA,IAE3C,KAAK;AAAA,IACL,KAAK;AACH,aAAO,EAAE,QAAQ,WAAW,QAAQ,UAAU,WAAW,SAAA;AAAA,IAC3D,KAAK;AACH,aAAO;AAAA,QACL,QAAQ,WAAW;AAAA,QACnB,UAAU,WAAW;AAAA,QACrB,SAAS,WAAW;AAAA,QACpB,GAAI,WAAW,UAAU,UAAa,EAAE,OAAO,WAAW,MAAA;AAAA,QAC1D,GAAI,WAAW,SAAS,UAAa,EAAE,MAAM,WAAW,KAAA;AAAA,QACxD,GAAI,WAAW,gBAAgB,UAAa,EAAE,aAAa,WAAW,YAAA;AAAA,QACtE,GAAI,WAAW,cAAc,UAAa,EAAE,WAAW,WAAW,UAAA;AAAA,QAClE,GAAI,YAAY,UAAa,EAAE,QAAA;AAAA,MAAQ;AAAA,IAE3C,KAAK;AACH,aAAO;AAAA,QACL,QAAQ,WAAW;AAAA,QACnB,UAAU,WAAW;AAAA,QACrB,QAAQ,WAAW;AAAA,QACnB,GAAI,WAAW,YAAY,UAAa,EAAE,SAAS,WAAW,QAAA;AAAA,QAC9D,GAAI,YAAY,UAAa,EAAE,QAAA;AAAA,MAAQ;AAAA,IAE3C;AACE,aAAO,wBAAwB,UAAU;AAAA,EAAA;AAE/C;AAGA,SAAS,wBAAwB,YAA0B;AACzD,QAAM,IAAI;AAAA,IACR,wCAAwC,KAAK;AAAA,MAC1C,WAAoC;AAAA,IAAA,CACtC;AAAA,EAAA;AAEL;"}

package/dist/packages/agent-runtime/src/generated/runconfig-contract.cjs

@@ -0,0 +1,238 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const RUN_CONFIG_CUSTOM_KEYS = [
+  "agent",
+  "agent_catalog_asset_ids",
+  "allowed_tab_ids",
+  "app_id",
+  "async_subagents",
+  "catalog_asset_ids",
+  "channel",
+  "client_tools",
+  "coding_worker_asset_id",
+  "coding_workers",
+  "collab_agent_id",
+  "collab_channel_id",
+  "compiled_subagents",
+  "custom_tool_configs",
+  "declined_toolkit_ids",
+  "deterministic",
+  "device_id",
+  "drive_mounts",
+  "dry_run",
+  "enable_interpreter",
+  "enable_persistent_fs",
+  "enable_sandbox",
+  "enable_skills",
+  "enabled_toolkits",
+  "enabled_tools",
+  "environment",
+  "environment_asset_id",
+  "environment_id",
+  "environment_name",
+  "excluded_middleware",
+  "excluded_tools",
+  "extra_middleware",
+  "frontend_available",
+  "github_identity",
+  "include_citation_instructions",
+  "interpreter_max_ptc_calls",
+  "interpreter_mode",
+  "interpreter_ptc",
+  "interpreter_ptc_exclusive",
+  "interpreter_runtime",
+  "interpreter_subagents",
+  "interpreter_timeout_seconds",
+  "interrupt_on",
+  "knowledge_base",
+  "max_tokens",
+  "mcp_server_configs",
+  "mcp_servers",
+  "memory",
+  "middleware",
+  "model",
+  "muses_enabled",
+  "muses_recall_enabled",
+  "office_context",
+  "panel_config",
+  "permissions",
+  "project_id",
+  "recursion_limit",
+  "run_budget",
+  "run_label",
+  "runtime",
+  "sandbox_runtime",
+  "secret_asset_ids",
+  "session_id",
+  "session_origin_kind",
+  "session_tab_id",
+  "session_vm_retention",
+  "skill_asset_ids",
+  "skills",
+  "skip_title_generation",
+  "source_aop_id",
+  "start_channel",
+  "structured_output",
+  "subagents",
+  "system_prompt",
+  "temperature",
+  "tool_description_overrides",
+  "tool_limit_override",
+  "trigger_type",
+  "voice_update_handle",
+  "workbench",
+  "workspace_id"
+];
+new Set(
+  RUN_CONFIG_CUSTOM_KEYS
+);
+const RUN_CONFIG_PER_SEND_CUSTOM_KEYS = [
+  "agent",
+  "allowed_tab_ids",
+  "app_id",
+  "channel",
+  "client_tools",
+  "collab_channel_id",
+  "deterministic",
+  "device_id",
+  "dry_run",
+  "frontend_available",
+  "github_identity",
+  "muses_enabled",
+  "muses_recall_enabled",
+  "office_context",
+  "project_id",
+  "run_budget",
+  "runtime",
+  "session_id",
+  "session_origin_kind",
+  "session_tab_id",
+  "skip_title_generation",
+  "source_aop_id",
+  "start_channel",
+  "structured_output",
+  "tool_limit_override",
+  "trigger_type",
+  "voice_update_handle",
+  "workspace_id"
+];
+new Set(
+  RUN_CONFIG_PER_SEND_CUSTOM_KEYS
+);
+const THREAD_CONFIG_CUSTOM_KEYS = [
+  "agent_catalog_asset_ids",
+  "async_subagents",
+  "catalog_asset_ids",
+  "coding_worker_asset_id",
+  "coding_workers",
+  "collab_agent_id",
+  "compiled_subagents",
+  "custom_tool_configs",
+  "declined_toolkit_ids",
+  "drive_mounts",
+  "enable_interpreter",
+  "enable_persistent_fs",
+  "enable_sandbox",
+  "enable_skills",
+  "enabled_toolkits",
+  "enabled_tools",
+  "environment",
+  "environment_asset_id",
+  "environment_id",
+  "environment_name",
+  "excluded_middleware",
+  "excluded_tools",
+  "extra_middleware",
+  "include_citation_instructions",
+  "interpreter_max_ptc_calls",
+  "interpreter_mode",
+  "interpreter_ptc",
+  "interpreter_ptc_exclusive",
+  "interpreter_runtime",
+  "interpreter_subagents",
+  "interpreter_timeout_seconds",
+  "interrupt_on",
+  "knowledge_base",
+  "max_tokens",
+  "mcp_server_configs",
+  "mcp_servers",
+  "memory",
+  "middleware",
+  "model",
+  "permissions",
+  "recursion_limit",
+  "run_label",
+  "sandbox_runtime",
+  "secret_asset_ids",
+  "session_vm_retention",
+  "skill_asset_ids",
+  "skills",
+  "subagents",
+  "system_prompt",
+  "temperature",
+  "tool_description_overrides",
+  "workbench"
+];
+new Set(
+  THREAD_CONFIG_CUSTOM_KEYS
+);
+const KNOWN_START_CHANNELS = [
+  "api",
+  "chrome_extension",
+  "cli",
+  "comment_agent",
+  "default_voice",
+  "email",
+  "mobile_app",
+  "office_addin",
+  "orchestration",
+  "programmatic",
+  "slack",
+  "sms",
+  "task",
+  "teams",
+  "voice",
+  "web"
+];
+new Set(
+  KNOWN_START_CHANNELS
+);
+const CLIENT_TOOL_INTERRUPT_SOURCE = "client_tool";
+const CLIENT_TOOL_RESULT_STATUS_SUCCESS = "success";
+const CLIENT_TOOL_RESULT_STATUS_ERROR = "error";
+const DEEP_AGENT_PROTOCOL_VERSION = 1;
+const DEEP_AGENT_PROTOCOL_VERSION_HEADER = "x-athena-deep-agent-protocol-version";
+const DEEP_AGENT_PROTOCOL_STATE_KEY = "protocol";
+const DEEP_AGENT_MESSAGE_WINDOW_HEADER = "x-athena-deep-agent-window";
+const DEEP_AGENT_PROVENANCE_HEADER = "x-athena-deep-agent-provenance";
+const DEEP_AGENT_PROVENANCE_FULL = "full";
+const DEEP_AGENT_DEFAULT_MESSAGE_WINDOW = 40;
+const DEEP_AGENT_MIN_MESSAGE_WINDOW = 8;
+const DEEP_AGENT_MAX_MESSAGE_WINDOW = 200;
+const DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT = 200;
+const DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY = "messagesWindow";
+const DEEP_AGENT_HISTORY_LOAD_COMMAND = "history/load";
+const DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND = "history/tool_output";
+const DEEP_AGENT_TRUNCATED_CONTENT_KEY = "athena_content_truncated";
+exports.CLIENT_TOOL_INTERRUPT_SOURCE = CLIENT_TOOL_INTERRUPT_SOURCE;
+exports.CLIENT_TOOL_RESULT_STATUS_ERROR = CLIENT_TOOL_RESULT_STATUS_ERROR;
+exports.CLIENT_TOOL_RESULT_STATUS_SUCCESS = CLIENT_TOOL_RESULT_STATUS_SUCCESS;
+exports.DEEP_AGENT_DEFAULT_MESSAGE_WINDOW = DEEP_AGENT_DEFAULT_MESSAGE_WINDOW;
+exports.DEEP_AGENT_HISTORY_LOAD_COMMAND = DEEP_AGENT_HISTORY_LOAD_COMMAND;
+exports.DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT = DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT;
+exports.DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND = DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND;
+exports.DEEP_AGENT_MAX_MESSAGE_WINDOW = DEEP_AGENT_MAX_MESSAGE_WINDOW;
+exports.DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY = DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY;
+exports.DEEP_AGENT_MESSAGE_WINDOW_HEADER = DEEP_AGENT_MESSAGE_WINDOW_HEADER;
+exports.DEEP_AGENT_MIN_MESSAGE_WINDOW = DEEP_AGENT_MIN_MESSAGE_WINDOW;
+exports.DEEP_AGENT_PROTOCOL_STATE_KEY = DEEP_AGENT_PROTOCOL_STATE_KEY;
+exports.DEEP_AGENT_PROTOCOL_VERSION = DEEP_AGENT_PROTOCOL_VERSION;
+exports.DEEP_AGENT_PROTOCOL_VERSION_HEADER = DEEP_AGENT_PROTOCOL_VERSION_HEADER;
+exports.DEEP_AGENT_PROVENANCE_FULL = DEEP_AGENT_PROVENANCE_FULL;
+exports.DEEP_AGENT_PROVENANCE_HEADER = DEEP_AGENT_PROVENANCE_HEADER;
+exports.DEEP_AGENT_TRUNCATED_CONTENT_KEY = DEEP_AGENT_TRUNCATED_CONTENT_KEY;
+exports.KNOWN_START_CHANNELS = KNOWN_START_CHANNELS;
+exports.RUN_CONFIG_CUSTOM_KEYS = RUN_CONFIG_CUSTOM_KEYS;
+exports.RUN_CONFIG_PER_SEND_CUSTOM_KEYS = RUN_CONFIG_PER_SEND_CUSTOM_KEYS;
+exports.THREAD_CONFIG_CUSTOM_KEYS = THREAD_CONFIG_CUSTOM_KEYS;
+//# sourceMappingURL=runconfig-contract.cjs.map