@athenaintel/react 0.28.0 → 0.30.0

package/dist/{packages/agent-runtime → agent-runtime}/src/errors.js

@@ -23,6 +23,26 @@ function readRetryableRunRefusal(error) {
   if (error === null || typeof error !== "object" || Array.isArray(error)) return null;
   return readRetryableDetail(error.detail);
 }
+const COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = "collab_agent_channel_session_mismatch";
+function readRunStartRefusal(error) {
+  if (error === null || typeof error !== "object" || Array.isArray(error)) return null;
+  const { detail, status } = error;
+  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,
+    status: typeof status === "number" ? status : null
+  };
+}
+function statewireRejectionCode(error) {
+  var _a;
+  const detail = (_a = statewireRejectionPayload(error)) == null ? void 0 : _a.detail;
+  if (detail === null || typeof detail !== "object" || Array.isArray(detail)) return null;
+  const code = detail.code;
+  return typeof code === "string" && code.length > 0 ? code : null;
+}
 function readRetryableCommandRejection(error) {
   const payload = statewireRejectionPayload(error);
   return payload === null ? null : readRetryableDetail(payload.detail);
@@ -100,12 +120,15 @@ function unknownConnectionStatus(connection) {
   );
 }
 export {
+  COLLAB_AGENT_CHANNEL_SESSION_MISMATCH,
   isLegacyThreadReadOnlyRejection,
   isStatewireChannelTeardown,
   isStatewireExpiredVerdict,
   projectDeepAgentConnection,
   readRetryableCommandRejection,
   readRetryableRunRefusal,
+  readRunStartRefusal,
+  statewireRejectionCode,
   statewireRejectionDetailMessage,
   statewireRejectionPayload,
   statewireTransportOutcome

package/dist/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 * The `detail.code` agora answers when a send names another channel of the\n * collab agent a session started on (`collab_agent_bridge.py`): a session\n * keeps its channel — the SDK app's Agent / Ask mode — for its lifetime, and\n * the way to the other mode is a new session. Wire-frozen.\n */\nexport const COLLAB_AGENT_CHANNEL_SESSION_MISMATCH = 'collab_agent_channel_session_mismatch';\n\n/**\n * A structured refusal the host recorded as the run error when the run could\n * not START: the run executor raised the gate's `{status, detail: {code,\n * message}}` envelope (agora's `_status_reject`) before it accepted the\n * dispatched input, so the message went back to its lane and the thread rests\n * `error` with it still queued. Unlike a retryable refusal\n * ({@link readRetryableRunRefusal}) nothing will dispatch it later: resending\n * the same input is refused the same way, so the server's message is the only\n * explanation the person gets.\n */\nexport interface RunStartRefusal {\n  /** The structured `detail.code` (`collab_agent_channel_session_mismatch`, …). */\n  code: string;\n  /** The server's human-readable reason, when it sent one. */\n  message: string | null;\n  /** The HTTP-style status the gate raised with, when recorded. */\n  status: number | null;\n}\n\n/**\n * The non-retryable structured refusal off a replicated run error\n * (`runs.error`), or `null` — for a run that failed while it was running (a\n * plain `{message}`), a retryable refusal, or no error at all.\n */\nexport function readRunStartRefusal(error: unknown): RunStartRefusal | null {\n  if (error === null || typeof error !== 'object' || Array.isArray(error)) return null;\n  const { detail, status } = error as { detail?: unknown; status?: unknown };\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 {\n    code,\n    message: typeof message === 'string' && message.length > 0 ? message : null,\n    status: typeof status === 'number' ? status : null,\n  };\n}\n\n/** The structured `detail.code` of a rejected command, or `null`. */\nexport function statewireRejectionCode(error: unknown): string | null {\n  const detail = statewireRejectionPayload(error)?.detail;\n  if (detail === null || typeof detail !== 'object' || Array.isArray(detail)) return null;\n  const code = (detail as { code?: unknown }).code;\n  return typeof code === 'string' && code.length > 0 ? code : null;\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/agent-runtime/src/execute-output.cjs

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function summarizeShellCommand(command) {
+  const lines = command.replace(/\n+$/, "").split("\n");
+  const firstIndex = lines.findIndex((line) => line.trim().length > 0);
+  if (firstIndex < 0) return { firstLine: "", extraLines: 0 };
+  return {
+    firstLine: (lines[firstIndex] ?? "").trim(),
+    extraLines: Math.max(0, lines.length - firstIndex - 1)
+  };
+}
+const EXIT_CODE_NOTE = /^\[Command (?:succeeded|failed) with exit code (-?\d+)\]$/;
+const TRUNCATION_NOTE = /^\[Output .*truncated.*\]$/;
+function parseExecuteOutput(raw) {
+  const lines = raw.split("\n");
+  let exitCode = null;
+  let truncated = false;
+  while (lines.length > 0) {
+    const last = (lines[lines.length - 1] ?? "").trim();
+    if (last === "") {
+      lines.pop();
+      continue;
+    }
+    const exitMatch = EXIT_CODE_NOTE.exec(last);
+    if (exitMatch && exitCode === null) {
+      exitCode = Number.parseInt(exitMatch[1] ?? "", 10);
+      lines.pop();
+      continue;
+    }
+    if (TRUNCATION_NOTE.test(last) && !truncated) {
+      truncated = true;
+      lines.pop();
+      continue;
+    }
+    break;
+  }
+  return { body: lines.join("\n"), exitCode, truncated };
+}
+exports.parseExecuteOutput = parseExecuteOutput;
+exports.summarizeShellCommand = summarizeShellCommand;
+//# sourceMappingURL=execute-output.cjs.map

package/dist/agent-runtime/src/execute-output.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-output.cjs","sources":["../../../../agent-runtime/src/execute-output.ts"],"sourcesContent":["/**\n * Reading the deepagents `execute` (shell) tool: the command's headline and\n * the status notes the backend appends to its output. Pure, so every surface\n * that lists shell commands (a tool card, a session's Shell pane) agrees on\n * what succeeded.\n */\n\nexport interface ShellCommandSummary {\n  /** The first non-blank line of the command, trimmed. */\n  firstLine: string;\n  /** How many lines follow it. */\n  extraLines: number;\n}\n\n/** A shell command's first non-blank line plus how many lines follow it. */\nexport function summarizeShellCommand(command: string): ShellCommandSummary {\n  const lines = command.replace(/\\n+$/, '').split('\\n');\n  const firstIndex = lines.findIndex((line) => line.trim().length > 0);\n  if (firstIndex < 0) return { firstLine: '', extraLines: 0 };\n  return {\n    firstLine: (lines[firstIndex] ?? '').trim(),\n    extraLines: Math.max(0, lines.length - firstIndex - 1),\n  };\n}\n\nexport interface ParsedExecuteOutput {\n  /** The command's output with the trailing status notes removed. */\n  body: string;\n  /** The exit code from the status note, or `null` when the output carries none. */\n  exitCode: number | null;\n  /** Whether the backend cut the output (`[Output was truncated due to size limits]`). */\n  truncated: boolean;\n}\n\nconst EXIT_CODE_NOTE = /^\\[Command (?:succeeded|failed) with exit code (-?\\d+)\\]$/;\nconst TRUNCATION_NOTE = /^\\[Output .*truncated.*\\]$/;\n\n/**\n * Split an `execute` result into its output and the notes agora's execute\n * router appends (`_format_execute_output` in `asset_execute.py`, mirroring\n * the SDK tool): `[Command succeeded with exit code 0]`, `[Command failed with\n * exit code 1]` and `[Output was truncated due to size limits]`. A result\n * without an exit note (an `Error: …` refusal before the command ran, an\n * output the live window cut) reports `exitCode: null`.\n */\nexport function parseExecuteOutput(raw: string): ParsedExecuteOutput {\n  const lines = raw.split('\\n');\n  let exitCode: number | null = null;\n  let truncated = false;\n  while (lines.length > 0) {\n    const last = (lines[lines.length - 1] ?? '').trim();\n    if (last === '') {\n      lines.pop();\n      continue;\n    }\n    const exitMatch = EXIT_CODE_NOTE.exec(last);\n    if (exitMatch && exitCode === null) {\n      exitCode = Number.parseInt(exitMatch[1] ?? '', 10);\n      lines.pop();\n      continue;\n    }\n    if (TRUNCATION_NOTE.test(last) && !truncated) {\n      truncated = true;\n      lines.pop();\n      continue;\n    }\n    break;\n  }\n  return { body: lines.join('\\n'), exitCode, truncated };\n}\n"],"names":[],"mappings":";;AAeO,SAAS,sBAAsB,SAAsC;AAC1E,QAAM,QAAQ,QAAQ,QAAQ,QAAQ,EAAE,EAAE,MAAM,IAAI;AACpD,QAAM,aAAa,MAAM,UAAU,CAAC,SAAS,KAAK,KAAA,EAAO,SAAS,CAAC;AACnE,MAAI,aAAa,EAAG,QAAO,EAAE,WAAW,IAAI,YAAY,EAAA;AACxD,SAAO;AAAA,IACL,YAAY,MAAM,UAAU,KAAK,IAAI,KAAA;AAAA,IACrC,YAAY,KAAK,IAAI,GAAG,MAAM,SAAS,aAAa,CAAC;AAAA,EAAA;AAEzD;AAWA,MAAM,iBAAiB;AACvB,MAAM,kBAAkB;AAUjB,SAAS,mBAAmB,KAAkC;AACnE,QAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,MAAI,WAA0B;AAC9B,MAAI,YAAY;AAChB,SAAO,MAAM,SAAS,GAAG;AACvB,UAAM,QAAQ,MAAM,MAAM,SAAS,CAAC,KAAK,IAAI,KAAA;AAC7C,QAAI,SAAS,IAAI;AACf,YAAM,IAAA;AACN;AAAA,IACF;AACA,UAAM,YAAY,eAAe,KAAK,IAAI;AAC1C,QAAI,aAAa,aAAa,MAAM;AAClC,iBAAW,OAAO,SAAS,UAAU,CAAC,KAAK,IAAI,EAAE;AACjD,YAAM,IAAA;AACN;AAAA,IACF;AACA,QAAI,gBAAgB,KAAK,IAAI,KAAK,CAAC,WAAW;AAC5C,kBAAY;AACZ,YAAM,IAAA;AACN;AAAA,IACF;AACA;AAAA,EACF;AACA,SAAO,EAAE,MAAM,MAAM,KAAK,IAAI,GAAG,UAAU,UAAA;AAC7C;;;"}

package/dist/agent-runtime/src/execute-output.js

@@ -0,0 +1,41 @@
+function summarizeShellCommand(command) {
+  const lines = command.replace(/\n+$/, "").split("\n");
+  const firstIndex = lines.findIndex((line) => line.trim().length > 0);
+  if (firstIndex < 0) return { firstLine: "", extraLines: 0 };
+  return {
+    firstLine: (lines[firstIndex] ?? "").trim(),
+    extraLines: Math.max(0, lines.length - firstIndex - 1)
+  };
+}
+const EXIT_CODE_NOTE = /^\[Command (?:succeeded|failed) with exit code (-?\d+)\]$/;
+const TRUNCATION_NOTE = /^\[Output .*truncated.*\]$/;
+function parseExecuteOutput(raw) {
+  const lines = raw.split("\n");
+  let exitCode = null;
+  let truncated = false;
+  while (lines.length > 0) {
+    const last = (lines[lines.length - 1] ?? "").trim();
+    if (last === "") {
+      lines.pop();
+      continue;
+    }
+    const exitMatch = EXIT_CODE_NOTE.exec(last);
+    if (exitMatch && exitCode === null) {
+      exitCode = Number.parseInt(exitMatch[1] ?? "", 10);
+      lines.pop();
+      continue;
+    }
+    if (TRUNCATION_NOTE.test(last) && !truncated) {
+      truncated = true;
+      lines.pop();
+      continue;
+    }
+    break;
+  }
+  return { body: lines.join("\n"), exitCode, truncated };
+}
+export {
+  parseExecuteOutput,
+  summarizeShellCommand
+};
+//# sourceMappingURL=execute-output.js.map

package/dist/agent-runtime/src/execute-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-output.js","sources":["../../../../agent-runtime/src/execute-output.ts"],"sourcesContent":["/**\n * Reading the deepagents `execute` (shell) tool: the command's headline and\n * the status notes the backend appends to its output. Pure, so every surface\n * that lists shell commands (a tool card, a session's Shell pane) agrees on\n * what succeeded.\n */\n\nexport interface ShellCommandSummary {\n  /** The first non-blank line of the command, trimmed. */\n  firstLine: string;\n  /** How many lines follow it. */\n  extraLines: number;\n}\n\n/** A shell command's first non-blank line plus how many lines follow it. */\nexport function summarizeShellCommand(command: string): ShellCommandSummary {\n  const lines = command.replace(/\\n+$/, '').split('\\n');\n  const firstIndex = lines.findIndex((line) => line.trim().length > 0);\n  if (firstIndex < 0) return { firstLine: '', extraLines: 0 };\n  return {\n    firstLine: (lines[firstIndex] ?? '').trim(),\n    extraLines: Math.max(0, lines.length - firstIndex - 1),\n  };\n}\n\nexport interface ParsedExecuteOutput {\n  /** The command's output with the trailing status notes removed. */\n  body: string;\n  /** The exit code from the status note, or `null` when the output carries none. */\n  exitCode: number | null;\n  /** Whether the backend cut the output (`[Output was truncated due to size limits]`). */\n  truncated: boolean;\n}\n\nconst EXIT_CODE_NOTE = /^\\[Command (?:succeeded|failed) with exit code (-?\\d+)\\]$/;\nconst TRUNCATION_NOTE = /^\\[Output .*truncated.*\\]$/;\n\n/**\n * Split an `execute` result into its output and the notes agora's execute\n * router appends (`_format_execute_output` in `asset_execute.py`, mirroring\n * the SDK tool): `[Command succeeded with exit code 0]`, `[Command failed with\n * exit code 1]` and `[Output was truncated due to size limits]`. A result\n * without an exit note (an `Error: …` refusal before the command ran, an\n * output the live window cut) reports `exitCode: null`.\n */\nexport function parseExecuteOutput(raw: string): ParsedExecuteOutput {\n  const lines = raw.split('\\n');\n  let exitCode: number | null = null;\n  let truncated = false;\n  while (lines.length > 0) {\n    const last = (lines[lines.length - 1] ?? '').trim();\n    if (last === '') {\n      lines.pop();\n      continue;\n    }\n    const exitMatch = EXIT_CODE_NOTE.exec(last);\n    if (exitMatch && exitCode === null) {\n      exitCode = Number.parseInt(exitMatch[1] ?? '', 10);\n      lines.pop();\n      continue;\n    }\n    if (TRUNCATION_NOTE.test(last) && !truncated) {\n      truncated = true;\n      lines.pop();\n      continue;\n    }\n    break;\n  }\n  return { body: lines.join('\\n'), exitCode, truncated };\n}\n"],"names":[],"mappings":"AAeO,SAAS,sBAAsB,SAAsC;AAC1E,QAAM,QAAQ,QAAQ,QAAQ,QAAQ,EAAE,EAAE,MAAM,IAAI;AACpD,QAAM,aAAa,MAAM,UAAU,CAAC,SAAS,KAAK,KAAA,EAAO,SAAS,CAAC;AACnE,MAAI,aAAa,EAAG,QAAO,EAAE,WAAW,IAAI,YAAY,EAAA;AACxD,SAAO;AAAA,IACL,YAAY,MAAM,UAAU,KAAK,IAAI,KAAA;AAAA,IACrC,YAAY,KAAK,IAAI,GAAG,MAAM,SAAS,aAAa,CAAC;AAAA,EAAA;AAEzD;AAWA,MAAM,iBAAiB;AACvB,MAAM,kBAAkB;AAUjB,SAAS,mBAAmB,KAAkC;AACnE,QAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,MAAI,WAA0B;AAC9B,MAAI,YAAY;AAChB,SAAO,MAAM,SAAS,GAAG;AACvB,UAAM,QAAQ,MAAM,MAAM,SAAS,CAAC,KAAK,IAAI,KAAA;AAC7C,QAAI,SAAS,IAAI;AACf,YAAM,IAAA;AACN;AAAA,IACF;AACA,UAAM,YAAY,eAAe,KAAK,IAAI;AAC1C,QAAI,aAAa,aAAa,MAAM;AAClC,iBAAW,OAAO,SAAS,UAAU,CAAC,KAAK,IAAI,EAAE;AACjD,YAAM,IAAA;AACN;AAAA,IACF;AACA,QAAI,gBAAgB,KAAK,IAAI,KAAK,CAAC,WAAW;AAC5C,kBAAY;AACZ,YAAM,IAAA;AACN;AAAA,IACF;AACA;AAAA,EACF;AACA,SAAO,EAAE,MAAM,MAAM,KAAK,IAAI,GAAG,UAAU,UAAA;AAC7C;"}

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

@@ -6,7 +6,6 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "allowed_tab_ids",
   "app_id",
   "approve_changes",
-  "async_subagents",
   "catalog_asset_ids",
   "channel",
   "client_tools",
@@ -19,6 +18,7 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "declined_toolkit_ids",
   "deterministic",
   "device_id",
+  "device_toolkits",
   "drive_mounts",
   "dry_run",
   "enable_interpreter",
@@ -27,13 +27,16 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "enable_skills",
   "enabled_toolkits",
   "enabled_tools",
+  "entry_point",
   "environment",
   "environment_id",
   "environment_name",
   "excluded_middleware",
   "excluded_tools",
   "extra_middleware",
+  "from_stored_config",
   "frontend_available",
+  "generative_frame_inline",
   "github_identity",
   "include_citation_instructions",
   "interpreter_max_ptc_calls",
@@ -57,6 +60,7 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "outbound_approval_allowlist",
   "panel_config",
   "permissions",
+  "posthog_session_id",
   "project_id",
   "recursion_limit",
   "run_budget",
@@ -64,6 +68,7 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "runtime",
   "sandbox_runtime",
   "secret_asset_ids",
+  "session_computer",
   "session_id",
   "session_machine",
   "session_origin_kind",
@@ -97,12 +102,17 @@ const RUN_CONFIG_PER_SEND_CUSTOM_KEYS = [
   "collab_channel_id",
   "deterministic",
   "device_id",
+  "device_toolkits",
   "dry_run",
+  "entry_point",
+  "from_stored_config",
   "frontend_available",
+  "generative_frame_inline",
   "github_identity",
   "muses_enabled",
   "muses_recall_enabled",
   "office_context",
+  "posthog_session_id",
   "project_id",
   "run_budget",
   "runtime",
@@ -124,7 +134,6 @@ new Set(
 const THREAD_CONFIG_CUSTOM_KEYS = [
   "agent_catalog_asset_ids",
   "approve_changes",
-  "async_subagents",
   "catalog_asset_ids",
   "coding_worker_asset_id",
   "coding_workers",
@@ -167,6 +176,7 @@ const THREAD_CONFIG_CUSTOM_KEYS = [
   "run_label",
   "sandbox_runtime",
   "secret_asset_ids",
+  "session_computer",
   "session_machine",
   "session_vm_retention",
   "skill_asset_ids",

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

@@ -0,0 +1 @@
+{"version":3,"file":"runconfig-contract.cjs","sources":["../../../../../agent-runtime/src/generated/runconfig-contract.ts"],"sourcesContent":["// GENERATED FILE — DO NOT EDIT BY HAND.\n//\n// Source of truth (agora):\n//   agora/agora/graphs/athena_deep_agent/run_config.py    (_PARSED_CUSTOM_KEYS / _COMPANION_CUSTOM_KEYS / PER_SEND_CUSTOM_KEYS)\n//   agora/agora/graphs/athena_deep_agent/thread_config.py (server config lane + config/* command names)\n//   agora/agora/graphs/athena_deep_agent/session_asset.py (KNOWN_START_CHANNELS / DEEP_AGENT_RUNTIME_MARKER)\n//   agora/agora/graphs/athena_deep_agent/client_tools.py  (client-tool interrupt + result-envelope literals)\n//   agora/agora/graphs/athena_deep_agent/protocol_version.py (wire-contract version negotiation)\n//   agora/agora/graphs/athena_deep_agent/message_window.py (interest windows + history commands)\n//   agora/agora/type_definitions/collab_agent.py            (CAPABILITIES ladder: absent mode + new-agent default)\n//\n// Regenerate:\n//   cd agora && mise exec -- infisical run --command 'uv run python scripts/export_runconfig_contract.py'\n//\n// CI verifies this file matches the Python source (agora-check runs the\n// exporter with --check), so hand edits and un-regenerated key changes fail.\n\n/** `runConfig.custom` keys parsed by agora's `parse_deep_agent_run_config`. */\nexport const RUN_CONFIG_PARSED_CUSTOM_KEYS = [\n  \"agent_catalog_asset_ids\",\n  \"approve_changes\",\n  \"catalog_asset_ids\",\n  \"coding_worker_asset_id\",\n  \"coding_workers\",\n  \"compiled_subagents\",\n  \"declined_toolkit_ids\",\n  \"drive_mounts\",\n  \"enable_interpreter\",\n  \"enable_persistent_fs\",\n  \"enable_sandbox\",\n  \"enable_skills\",\n  \"enabled_tools\",\n  \"environment\",\n  \"environment_id\",\n  \"environment_name\",\n  \"excluded_middleware\",\n  \"excluded_tools\",\n  \"extra_middleware\",\n  \"include_citation_instructions\",\n  \"interpreter_max_ptc_calls\",\n  \"interpreter_mode\",\n  \"interpreter_ptc\",\n  \"interpreter_ptc_exclusive\",\n  \"interpreter_runtime\",\n  \"interpreter_subagents\",\n  \"interpreter_timeout_seconds\",\n  \"interrupt_on\",\n  \"knowledge_base\",\n  \"mcp_server_configs\",\n  \"mcp_servers\",\n  \"memory\",\n  \"outbound_approval_allowlist\",\n  \"permissions\",\n  \"project_id\",\n  \"recursion_limit\",\n  \"run_label\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\n  \"session_computer\",\n  \"session_machine\",\n  \"session_vm_retention\",\n  \"skill_asset_ids\",\n  \"skills\",\n  \"subagents\",\n  \"system_prompt\",\n  \"tool_description_overrides\",\n  \"voice_update_handle\",\n  \"workbench\",\n] as const;\n\n/** `runConfig.custom` keys consumed by the surrounding deep-agent request machinery rather than the capability parser. */\nexport const RUN_CONFIG_COMPANION_CUSTOM_KEYS = [\n  \"agent\",\n  \"allowed_tab_ids\",\n  \"app_id\",\n  \"channel\",\n  \"client_tools\",\n  \"collab_agent_id\",\n  \"collab_channel_id\",\n  \"custom_tool_configs\",\n  \"deterministic\",\n  \"device_id\",\n  \"device_toolkits\",\n  \"dry_run\",\n  \"enabled_toolkits\",\n  \"entry_point\",\n  \"from_stored_config\",\n  \"frontend_available\",\n  \"generative_frame_inline\",\n  \"github_identity\",\n  \"max_tokens\",\n  \"middleware\",\n  \"model\",\n  \"muses_enabled\",\n  \"muses_recall_enabled\",\n  \"office_context\",\n  \"panel_config\",\n  \"posthog_session_id\",\n  \"run_budget\",\n  \"runtime\",\n  \"session_id\",\n  \"session_origin_kind\",\n  \"session_tab_id\",\n  \"skip_title_generation\",\n  \"source_aop_id\",\n  \"start_channel\",\n  \"structured_output\",\n  \"temperature\",\n  \"tool_limit_override\",\n  \"trigger_type\",\n  \"workspace_id\",\n] as const;\n\n/** Every `runConfig.custom` key some deep-agent request consumer reads. A key outside this set is invisible to the run and trips agora's unknown-key telemetry. */\nexport const RUN_CONFIG_CUSTOM_KEYS = [\n  \"agent\",\n  \"agent_catalog_asset_ids\",\n  \"allowed_tab_ids\",\n  \"app_id\",\n  \"approve_changes\",\n  \"catalog_asset_ids\",\n  \"channel\",\n  \"client_tools\",\n  \"coding_worker_asset_id\",\n  \"coding_workers\",\n  \"collab_agent_id\",\n  \"collab_channel_id\",\n  \"compiled_subagents\",\n  \"custom_tool_configs\",\n  \"declined_toolkit_ids\",\n  \"deterministic\",\n  \"device_id\",\n  \"device_toolkits\",\n  \"drive_mounts\",\n  \"dry_run\",\n  \"enable_interpreter\",\n  \"enable_persistent_fs\",\n  \"enable_sandbox\",\n  \"enable_skills\",\n  \"enabled_toolkits\",\n  \"enabled_tools\",\n  \"entry_point\",\n  \"environment\",\n  \"environment_id\",\n  \"environment_name\",\n  \"excluded_middleware\",\n  \"excluded_tools\",\n  \"extra_middleware\",\n  \"from_stored_config\",\n  \"frontend_available\",\n  \"generative_frame_inline\",\n  \"github_identity\",\n  \"include_citation_instructions\",\n  \"interpreter_max_ptc_calls\",\n  \"interpreter_mode\",\n  \"interpreter_ptc\",\n  \"interpreter_ptc_exclusive\",\n  \"interpreter_runtime\",\n  \"interpreter_subagents\",\n  \"interpreter_timeout_seconds\",\n  \"interrupt_on\",\n  \"knowledge_base\",\n  \"max_tokens\",\n  \"mcp_server_configs\",\n  \"mcp_servers\",\n  \"memory\",\n  \"middleware\",\n  \"model\",\n  \"muses_enabled\",\n  \"muses_recall_enabled\",\n  \"office_context\",\n  \"outbound_approval_allowlist\",\n  \"panel_config\",\n  \"permissions\",\n  \"posthog_session_id\",\n  \"project_id\",\n  \"recursion_limit\",\n  \"run_budget\",\n  \"run_label\",\n  \"runtime\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\n  \"session_computer\",\n  \"session_id\",\n  \"session_machine\",\n  \"session_origin_kind\",\n  \"session_tab_id\",\n  \"session_vm_retention\",\n  \"skill_asset_ids\",\n  \"skills\",\n  \"skip_title_generation\",\n  \"source_aop_id\",\n  \"start_channel\",\n  \"structured_output\",\n  \"subagents\",\n  \"system_prompt\",\n  \"temperature\",\n  \"tool_description_overrides\",\n  \"tool_limit_override\",\n  \"trigger_type\",\n  \"voice_update_handle\",\n  \"workbench\",\n  \"workspace_id\",\n] as const;\n\nexport type RunConfigCustomKey = (typeof RUN_CONFIG_CUSTOM_KEYS)[number];\n\n/** Fast membership checks for builder/test assertions. */\nexport const RUN_CONFIG_CUSTOM_KEY_SET: ReadonlySet<string> = new Set(\n  RUN_CONFIG_CUSTOM_KEYS,\n);\n\n/** `runConfig.custom` keys a client still carries per send on a thread with server config; every other key is dropped at dispatch. */\nexport const RUN_CONFIG_PER_SEND_CUSTOM_KEYS = [\n  \"agent\",\n  \"allowed_tab_ids\",\n  \"app_id\",\n  \"channel\",\n  \"client_tools\",\n  \"collab_channel_id\",\n  \"deterministic\",\n  \"device_id\",\n  \"device_toolkits\",\n  \"dry_run\",\n  \"entry_point\",\n  \"from_stored_config\",\n  \"frontend_available\",\n  \"generative_frame_inline\",\n  \"github_identity\",\n  \"muses_enabled\",\n  \"muses_recall_enabled\",\n  \"office_context\",\n  \"posthog_session_id\",\n  \"project_id\",\n  \"run_budget\",\n  \"runtime\",\n  \"session_id\",\n  \"session_origin_kind\",\n  \"session_tab_id\",\n  \"skip_title_generation\",\n  \"source_aop_id\",\n  \"start_channel\",\n  \"structured_output\",\n  \"tool_limit_override\",\n  \"trigger_type\",\n  \"voice_update_handle\",\n  \"workspace_id\",\n] as const;\n\nexport type RunConfigPerSendCustomKey =\n  (typeof RUN_CONFIG_PER_SEND_CUSTOM_KEYS)[number];\n\n/** Fast membership checks for builder/test assertions. */\nexport const RUN_CONFIG_PER_SEND_CUSTOM_KEY_SET: ReadonlySet<string> = new Set(\n  RUN_CONFIG_PER_SEND_CUSTOM_KEYS,\n);\n\n/** Keys the thread's server config lane owns — changed only through the `config/*` commands, never per send. */\nexport const THREAD_CONFIG_CUSTOM_KEYS = [\n  \"agent_catalog_asset_ids\",\n  \"approve_changes\",\n  \"catalog_asset_ids\",\n  \"coding_worker_asset_id\",\n  \"coding_workers\",\n  \"collab_agent_id\",\n  \"compiled_subagents\",\n  \"custom_tool_configs\",\n  \"declined_toolkit_ids\",\n  \"drive_mounts\",\n  \"enable_interpreter\",\n  \"enable_persistent_fs\",\n  \"enable_sandbox\",\n  \"enable_skills\",\n  \"enabled_toolkits\",\n  \"enabled_tools\",\n  \"environment\",\n  \"environment_id\",\n  \"environment_name\",\n  \"excluded_middleware\",\n  \"excluded_tools\",\n  \"extra_middleware\",\n  \"include_citation_instructions\",\n  \"interpreter_max_ptc_calls\",\n  \"interpreter_mode\",\n  \"interpreter_ptc\",\n  \"interpreter_ptc_exclusive\",\n  \"interpreter_runtime\",\n  \"interpreter_subagents\",\n  \"interpreter_timeout_seconds\",\n  \"interrupt_on\",\n  \"knowledge_base\",\n  \"max_tokens\",\n  \"mcp_server_configs\",\n  \"mcp_servers\",\n  \"memory\",\n  \"middleware\",\n  \"model\",\n  \"outbound_approval_allowlist\",\n  \"permissions\",\n  \"recursion_limit\",\n  \"run_label\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\n  \"session_computer\",\n  \"session_machine\",\n  \"session_vm_retention\",\n  \"skill_asset_ids\",\n  \"skills\",\n  \"subagents\",\n  \"system_prompt\",\n  \"temperature\",\n  \"tool_description_overrides\",\n  \"workbench\",\n] as const;\n\nexport type ThreadConfigCustomKey = (typeof THREAD_CONFIG_CUSTOM_KEYS)[number];\n\n/** Fast membership checks for builder/test assertions. */\nexport const THREAD_CONFIG_CUSTOM_KEY_SET: ReadonlySet<string> = new Set(\n  THREAD_CONFIG_CUSTOM_KEYS,\n);\n\n/** Replicated-state key of the server config lane (`{ version, custom }`). */\nexport const DEEP_AGENT_CONFIG_STATE_KEY = \"config\";\n\n/** The statewire commands that mutate the server config lane. */\nexport const DEEP_AGENT_CONFIG_COMMANDS = {\n  patch: \"config/patch\",\n  toolsEnable: \"config/tools/enable\",\n  toolsDisable: \"config/tools/disable\",\n} as const;\n\n/** `start_channel` values the session substrate stamps as provenance; anything else clamps to \"web\". */\nexport const KNOWN_START_CHANNELS = [\n  \"agent_orchestration\",\n  \"api\",\n  \"automation\",\n  \"chrome_extension\",\n  \"cli\",\n  \"comment_agent\",\n  \"default_voice\",\n  \"desktop_app\",\n  \"email\",\n  \"mobile_app\",\n  \"office_addin\",\n  \"orchestration\",\n  \"programmatic\",\n  \"slack\",\n  \"sms\",\n  \"task\",\n  \"teams\",\n  \"voice\",\n  \"voice_memo\",\n  \"web\",\n] as const;\n\nexport type KnownStartChannel = (typeof KNOWN_START_CHANNELS)[number];\n\n/** Fast membership checks for builder/test assertions. */\nexport const KNOWN_START_CHANNEL_SET: ReadonlySet<string> = new Set(\n  KNOWN_START_CHANNELS,\n);\n\n/** `runConfig.custom.runtime` marker selecting the deep-agent runtime. */\nexport const DEEP_AGENT_RUNTIME_MARKER = \"athena_deep_agent\";\n\n/**\n * Collab-agent capability ladder (agent schema v3): per explicit\n * capability field, what an ABSENT value means and the value stamped on\n * a new agent. Resolved by agora's `capability_decoder` and the one agent\n * compiler on every run: `passthrough` — explicit only, absent means off;\n * `off` — absent means off under every `runtime` marker; `runtime` —\n * absent derives from the `runtime` marker (`athena_deep_agent` on, any\n * other or missing marker off).\n */\nexport const COLLAB_AGENT_CAPABILITIES = {\n  deepAgentBuiltinsEnabled: { absent: \"runtime\", default: true },\n  interpreterEnabled: { absent: \"off\", default: false },\n  sandboxEnabled: { absent: \"passthrough\", default: false },\n  skillsEnabled: { absent: \"runtime\", default: true },\n} as const;\n\nexport type CollabAgentCapabilityField = keyof typeof COLLAB_AGENT_CAPABILITIES;\n\nexport type CollabAgentCapabilityAbsentMode =\n  (typeof COLLAB_AGENT_CAPABILITIES)[CollabAgentCapabilityField][\"absent\"];\n\n/** `source`/`type` stamped on client-tool interrupt payloads by agora. */\nexport const CLIENT_TOOL_INTERRUPT_SOURCE = \"client_tool\";\n\n/** `status` literals of the result envelope a client resumes a parked client-tool call with. */\nexport const CLIENT_TOOL_RESULT_STATUSES = [\"error\", \"success\"] as const;\n\nexport type ClientToolResultStatus =\n  (typeof CLIENT_TOOL_RESULT_STATUSES)[number];\n\nexport const CLIENT_TOOL_RESULT_STATUS_SUCCESS = \"success\";\n\nexport const CLIENT_TOOL_RESULT_STATUS_ERROR = \"error\";\n\n/**\n * Result envelope a client resumes a parked client-tool call with,\n * keyed by interrupt id:\n * `{ client_tool_results: { <interrupt_id>: <envelope> } }`.\n * Agora relays the envelope to the model verbatim.\n */\nexport type ClientToolResultEnvelopeContract =\n  | { status: typeof CLIENT_TOOL_RESULT_STATUS_SUCCESS; result: unknown }\n  | { status: typeof CLIENT_TOOL_RESULT_STATUS_ERROR; error: string };\n\n/**\n * The deep-agent wire-contract version this client build speaks,\n * declared on every attach. The host records it for attach telemetry\n * and per-version behaviour; it has no minimum client version, so no\n * build is refused for the version it declares (the `protocol` state\n * lane's `minClientVersion` is the constant 1).\n */\nexport const DEEP_AGENT_PROTOCOL_VERSION = 1;\n\n/** Attach header carrying the client's declared contract version. */\nexport const DEEP_AGENT_PROTOCOL_VERSION_HEADER =\n  \"x-athena-deep-agent-protocol-version\";\n\n/** Attach header declaring the head window a fresh client wants in its hello (host-clamped). */\nexport const DEEP_AGENT_MESSAGE_WINDOW_HEADER = \"x-athena-deep-agent-window\";\n\n/** Replicated-state key of the server-advertised version lane. */\nexport const DEEP_AGENT_PROTOCOL_STATE_KEY = \"protocol\";\n\n/** Ephemeral subprotocol carrying a client's message-window interests. */\nexport const DEEP_AGENT_INTEREST_PROTOCOL = \"athena/interest\";\n\n/** Ephemeral subprotocol carrying a client's synced context document. */\nexport const DEEP_AGENT_CONTEXT_PROTOCOL = \"athena/context\";\n\n/** The only interest namespace the host resolves (the linear transcript). */\nexport const DEEP_AGENT_MAIN_NS = \"main\";\n\n/** Window size (interest `before`) a client asks for by default. */\nexport const DEEP_AGENT_DEFAULT_MESSAGE_WINDOW = 40;\n\n/** Bounds on a window size. */\nexport const DEEP_AGENT_MIN_MESSAGE_WINDOW = 8;\n\nexport const DEEP_AGENT_MAX_MESSAGE_WINDOW = 200;\n\n/** Interests one attach may hold at once (the head plus its pages). */\nexport const DEEP_AGENT_MAX_INTERESTS = 16;\n\n/** Command returning a truncated tool output whole. */\nexport const DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND = \"history/tool_output\";\n\n/** Command returning one stored message whole (provenance and full tool output included). */\nexport const DEEP_AGENT_HISTORY_MESSAGE_COMMAND = \"history/message\";\n\n/** Wire key marking a tool message whose content was truncated. */\nexport const DEEP_AGENT_TRUNCATED_CONTENT_KEY = \"athena_content_truncated\";\n\n/** Most inline-image payload characters one message carries whole on the wire. */\nexport const DEEP_AGENT_INLINE_IMAGE_WIRE_BUDGET = 4194304;\n\n/** Wire key on an image block left off the wire: `{ index, chars, mediaType }`. */\nexport const DEEP_AGENT_OMITTED_IMAGE_KEY = \"athena_image_omitted\";\n\n/** The image an omitted block carries instead of its own (a neutral PNG tile). */\nexport const DEEP_AGENT_OMITTED_IMAGE_PLACEHOLDER_URL =\n  \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKAAAAB4AQMAAABPbGssAAAABlBMVEXi6PCUo7jao11HAAAA6ElEQVR42u2UyW3DMBBF3wxogEd2EJbCElKQDRCwC3MpSRc5eLuYokgNLEUxctK/CHyanQts2vRO3QdlALVsXsBvecqxxr1ob0A5GlDJU+hICxN54p/qXAx/+FpoeeE8hTerzfvByn7ifzpaBtWCOwv6bMVMBgzRgNGKmUL9McDs4XOSyEHuoKCI76AiqOugg+y0gx6SN+YQg3QwALGk19pQSKV/reOocyoww27oU5sxhAbKUNgIqrVxrvnovJ80MFgxYy23wtTss44tmL+bAuOE2p2o0fJa3iW/6iR/lEfx8kv3TZtW6AFk5Sf3k+GTswAAAABJRU5ErkJggg==\";\n\n/**\n * Command returning one inline image of a stored message in chunks:\n * `{ messageId, index, offset? }` answers\n * `{ messageId, index, mediaType, offset, total, chunk, next }`; the\n * chunks joined in order are the image's `data:` URL, and `next` is\n * the offset to ask for next (`null` after the last chunk).\n */\nexport const DEEP_AGENT_HISTORY_IMAGE_COMMAND = \"history/image\";\n"],"names":[],"mappings":";;AAkHO,MAAM,yBAAyB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAK8D,IAAI;AAAA,EAChE;AACF;AAGO,MAAM,kCAAkC;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMuE,IAAI;AAAA,EACzE;AACF;AAGO,MAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAKiE,IAAI;AAAA,EACnE;AACF;AAaO,MAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAK4D,IAAI;AAAA,EAC9D;AACF;AA2BO,MAAM,+BAA+B;AAQrC,MAAM,oCAAoC;AAE1C,MAAM,kCAAkC;AAmBxC,MAAM,8BAA8B;AAGpC,MAAM,qCACX;AAGK,MAAM,mCAAmC;AAGzC,MAAM,gCAAgC;AAGtC,MAAM,+BAA+B;AAMrC,MAAM,qBAAqB;AAG3B,MAAM,oCAAoC;AAG1C,MAAM,gCAAgC;AAEtC,MAAM,gCAAgC;AAGtC,MAAM,2BAA2B;AAGjC,MAAM,yCAAyC;AAM/C,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;"}

package/dist/{packages/agent-runtime → agent-runtime}/src/generated/runconfig-contract.js

@@ -4,7 +4,6 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "allowed_tab_ids",
   "app_id",
   "approve_changes",
-  "async_subagents",
   "catalog_asset_ids",
   "channel",
   "client_tools",
@@ -17,6 +16,7 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "declined_toolkit_ids",
   "deterministic",
   "device_id",
+  "device_toolkits",
   "drive_mounts",
   "dry_run",
   "enable_interpreter",
@@ -25,13 +25,16 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "enable_skills",
   "enabled_toolkits",
   "enabled_tools",
+  "entry_point",
   "environment",
   "environment_id",
   "environment_name",
   "excluded_middleware",
   "excluded_tools",
   "extra_middleware",
+  "from_stored_config",
   "frontend_available",
+  "generative_frame_inline",
   "github_identity",
   "include_citation_instructions",
   "interpreter_max_ptc_calls",
@@ -55,6 +58,7 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "outbound_approval_allowlist",
   "panel_config",
   "permissions",
+  "posthog_session_id",
   "project_id",
   "recursion_limit",
   "run_budget",
@@ -62,6 +66,7 @@ const RUN_CONFIG_CUSTOM_KEYS = [
   "runtime",
   "sandbox_runtime",
   "secret_asset_ids",
+  "session_computer",
   "session_id",
   "session_machine",
   "session_origin_kind",
@@ -95,12 +100,17 @@ const RUN_CONFIG_PER_SEND_CUSTOM_KEYS = [
   "collab_channel_id",
   "deterministic",
   "device_id",
+  "device_toolkits",
   "dry_run",
+  "entry_point",
+  "from_stored_config",
   "frontend_available",
+  "generative_frame_inline",
   "github_identity",
   "muses_enabled",
   "muses_recall_enabled",
   "office_context",
+  "posthog_session_id",
   "project_id",
   "run_budget",
   "runtime",
@@ -122,7 +132,6 @@ new Set(
 const THREAD_CONFIG_CUSTOM_KEYS = [
   "agent_catalog_asset_ids",
   "approve_changes",
-  "async_subagents",
   "catalog_asset_ids",
   "coding_worker_asset_id",
   "coding_workers",
@@ -165,6 +174,7 @@ const THREAD_CONFIG_CUSTOM_KEYS = [
   "run_label",
   "sandbox_runtime",
   "secret_asset_ids",
+  "session_computer",
   "session_machine",
   "session_vm_retention",
   "skill_asset_ids",

package/dist/agent-runtime/src/generated/runconfig-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runconfig-contract.js","sources":["../../../../../agent-runtime/src/generated/runconfig-contract.ts"],"sourcesContent":["// GENERATED FILE — DO NOT EDIT BY HAND.\n//\n// Source of truth (agora):\n//   agora/agora/graphs/athena_deep_agent/run_config.py    (_PARSED_CUSTOM_KEYS / _COMPANION_CUSTOM_KEYS / PER_SEND_CUSTOM_KEYS)\n//   agora/agora/graphs/athena_deep_agent/thread_config.py (server config lane + config/* command names)\n//   agora/agora/graphs/athena_deep_agent/session_asset.py (KNOWN_START_CHANNELS / DEEP_AGENT_RUNTIME_MARKER)\n//   agora/agora/graphs/athena_deep_agent/client_tools.py  (client-tool interrupt + result-envelope literals)\n//   agora/agora/graphs/athena_deep_agent/protocol_version.py (wire-contract version negotiation)\n//   agora/agora/graphs/athena_deep_agent/message_window.py (interest windows + history commands)\n//   agora/agora/type_definitions/collab_agent.py            (CAPABILITIES ladder: absent mode + new-agent default)\n//\n// Regenerate:\n//   cd agora && mise exec -- infisical run --command 'uv run python scripts/export_runconfig_contract.py'\n//\n// CI verifies this file matches the Python source (agora-check runs the\n// exporter with --check), so hand edits and un-regenerated key changes fail.\n\n/** `runConfig.custom` keys parsed by agora's `parse_deep_agent_run_config`. */\nexport const RUN_CONFIG_PARSED_CUSTOM_KEYS = [\n  \"agent_catalog_asset_ids\",\n  \"approve_changes\",\n  \"catalog_asset_ids\",\n  \"coding_worker_asset_id\",\n  \"coding_workers\",\n  \"compiled_subagents\",\n  \"declined_toolkit_ids\",\n  \"drive_mounts\",\n  \"enable_interpreter\",\n  \"enable_persistent_fs\",\n  \"enable_sandbox\",\n  \"enable_skills\",\n  \"enabled_tools\",\n  \"environment\",\n  \"environment_id\",\n  \"environment_name\",\n  \"excluded_middleware\",\n  \"excluded_tools\",\n  \"extra_middleware\",\n  \"include_citation_instructions\",\n  \"interpreter_max_ptc_calls\",\n  \"interpreter_mode\",\n  \"interpreter_ptc\",\n  \"interpreter_ptc_exclusive\",\n  \"interpreter_runtime\",\n  \"interpreter_subagents\",\n  \"interpreter_timeout_seconds\",\n  \"interrupt_on\",\n  \"knowledge_base\",\n  \"mcp_server_configs\",\n  \"mcp_servers\",\n  \"memory\",\n  \"outbound_approval_allowlist\",\n  \"permissions\",\n  \"project_id\",\n  \"recursion_limit\",\n  \"run_label\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\n  \"session_computer\",\n  \"session_machine\",\n  \"session_vm_retention\",\n  \"skill_asset_ids\",\n  \"skills\",\n  \"subagents\",\n  \"system_prompt\",\n  \"tool_description_overrides\",\n  \"voice_update_handle\",\n  \"workbench\",\n] as const;\n\n/** `runConfig.custom` keys consumed by the surrounding deep-agent request machinery rather than the capability parser. */\nexport const RUN_CONFIG_COMPANION_CUSTOM_KEYS = [\n  \"agent\",\n  \"allowed_tab_ids\",\n  \"app_id\",\n  \"channel\",\n  \"client_tools\",\n  \"collab_agent_id\",\n  \"collab_channel_id\",\n  \"custom_tool_configs\",\n  \"deterministic\",\n  \"device_id\",\n  \"device_toolkits\",\n  \"dry_run\",\n  \"enabled_toolkits\",\n  \"entry_point\",\n  \"from_stored_config\",\n  \"frontend_available\",\n  \"generative_frame_inline\",\n  \"github_identity\",\n  \"max_tokens\",\n  \"middleware\",\n  \"model\",\n  \"muses_enabled\",\n  \"muses_recall_enabled\",\n  \"office_context\",\n  \"panel_config\",\n  \"posthog_session_id\",\n  \"run_budget\",\n  \"runtime\",\n  \"session_id\",\n  \"session_origin_kind\",\n  \"session_tab_id\",\n  \"skip_title_generation\",\n  \"source_aop_id\",\n  \"start_channel\",\n  \"structured_output\",\n  \"temperature\",\n  \"tool_limit_override\",\n  \"trigger_type\",\n  \"workspace_id\",\n] as const;\n\n/** Every `runConfig.custom` key some deep-agent request consumer reads. A key outside this set is invisible to the run and trips agora's unknown-key telemetry. */\nexport const RUN_CONFIG_CUSTOM_KEYS = [\n  \"agent\",\n  \"agent_catalog_asset_ids\",\n  \"allowed_tab_ids\",\n  \"app_id\",\n  \"approve_changes\",\n  \"catalog_asset_ids\",\n  \"channel\",\n  \"client_tools\",\n  \"coding_worker_asset_id\",\n  \"coding_workers\",\n  \"collab_agent_id\",\n  \"collab_channel_id\",\n  \"compiled_subagents\",\n  \"custom_tool_configs\",\n  \"declined_toolkit_ids\",\n  \"deterministic\",\n  \"device_id\",\n  \"device_toolkits\",\n  \"drive_mounts\",\n  \"dry_run\",\n  \"enable_interpreter\",\n  \"enable_persistent_fs\",\n  \"enable_sandbox\",\n  \"enable_skills\",\n  \"enabled_toolkits\",\n  \"enabled_tools\",\n  \"entry_point\",\n  \"environment\",\n  \"environment_id\",\n  \"environment_name\",\n  \"excluded_middleware\",\n  \"excluded_tools\",\n  \"extra_middleware\",\n  \"from_stored_config\",\n  \"frontend_available\",\n  \"generative_frame_inline\",\n  \"github_identity\",\n  \"include_citation_instructions\",\n  \"interpreter_max_ptc_calls\",\n  \"interpreter_mode\",\n  \"interpreter_ptc\",\n  \"interpreter_ptc_exclusive\",\n  \"interpreter_runtime\",\n  \"interpreter_subagents\",\n  \"interpreter_timeout_seconds\",\n  \"interrupt_on\",\n  \"knowledge_base\",\n  \"max_tokens\",\n  \"mcp_server_configs\",\n  \"mcp_servers\",\n  \"memory\",\n  \"middleware\",\n  \"model\",\n  \"muses_enabled\",\n  \"muses_recall_enabled\",\n  \"office_context\",\n  \"outbound_approval_allowlist\",\n  \"panel_config\",\n  \"permissions\",\n  \"posthog_session_id\",\n  \"project_id\",\n  \"recursion_limit\",\n  \"run_budget\",\n  \"run_label\",\n  \"runtime\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\n  \"session_computer\",\n  \"session_id\",\n  \"session_machine\",\n  \"session_origin_kind\",\n  \"session_tab_id\",\n  \"session_vm_retention\",\n  \"skill_asset_ids\",\n  \"skills\",\n  \"skip_title_generation\",\n  \"source_aop_id\",\n  \"start_channel\",\n  \"structured_output\",\n  \"subagents\",\n  \"system_prompt\",\n  \"temperature\",\n  \"tool_description_overrides\",\n  \"tool_limit_override\",\n  \"trigger_type\",\n  \"voice_update_handle\",\n  \"workbench\",\n  \"workspace_id\",\n] as const;\n\nexport type RunConfigCustomKey = (typeof RUN_CONFIG_CUSTOM_KEYS)[number];\n\n/** Fast membership checks for builder/test assertions. */\nexport const RUN_CONFIG_CUSTOM_KEY_SET: ReadonlySet<string> = new Set(\n  RUN_CONFIG_CUSTOM_KEYS,\n);\n\n/** `runConfig.custom` keys a client still carries per send on a thread with server config; every other key is dropped at dispatch. */\nexport const RUN_CONFIG_PER_SEND_CUSTOM_KEYS = [\n  \"agent\",\n  \"allowed_tab_ids\",\n  \"app_id\",\n  \"channel\",\n  \"client_tools\",\n  \"collab_channel_id\",\n  \"deterministic\",\n  \"device_id\",\n  \"device_toolkits\",\n  \"dry_run\",\n  \"entry_point\",\n  \"from_stored_config\",\n  \"frontend_available\",\n  \"generative_frame_inline\",\n  \"github_identity\",\n  \"muses_enabled\",\n  \"muses_recall_enabled\",\n  \"office_context\",\n  \"posthog_session_id\",\n  \"project_id\",\n  \"run_budget\",\n  \"runtime\",\n  \"session_id\",\n  \"session_origin_kind\",\n  \"session_tab_id\",\n  \"skip_title_generation\",\n  \"source_aop_id\",\n  \"start_channel\",\n  \"structured_output\",\n  \"tool_limit_override\",\n  \"trigger_type\",\n  \"voice_update_handle\",\n  \"workspace_id\",\n] as const;\n\nexport type RunConfigPerSendCustomKey =\n  (typeof RUN_CONFIG_PER_SEND_CUSTOM_KEYS)[number];\n\n/** Fast membership checks for builder/test assertions. */\nexport const RUN_CONFIG_PER_SEND_CUSTOM_KEY_SET: ReadonlySet<string> = new Set(\n  RUN_CONFIG_PER_SEND_CUSTOM_KEYS,\n);\n\n/** Keys the thread's server config lane owns — changed only through the `config/*` commands, never per send. */\nexport const THREAD_CONFIG_CUSTOM_KEYS = [\n  \"agent_catalog_asset_ids\",\n  \"approve_changes\",\n  \"catalog_asset_ids\",\n  \"coding_worker_asset_id\",\n  \"coding_workers\",\n  \"collab_agent_id\",\n  \"compiled_subagents\",\n  \"custom_tool_configs\",\n  \"declined_toolkit_ids\",\n  \"drive_mounts\",\n  \"enable_interpreter\",\n  \"enable_persistent_fs\",\n  \"enable_sandbox\",\n  \"enable_skills\",\n  \"enabled_toolkits\",\n  \"enabled_tools\",\n  \"environment\",\n  \"environment_id\",\n  \"environment_name\",\n  \"excluded_middleware\",\n  \"excluded_tools\",\n  \"extra_middleware\",\n  \"include_citation_instructions\",\n  \"interpreter_max_ptc_calls\",\n  \"interpreter_mode\",\n  \"interpreter_ptc\",\n  \"interpreter_ptc_exclusive\",\n  \"interpreter_runtime\",\n  \"interpreter_subagents\",\n  \"interpreter_timeout_seconds\",\n  \"interrupt_on\",\n  \"knowledge_base\",\n  \"max_tokens\",\n  \"mcp_server_configs\",\n  \"mcp_servers\",\n  \"memory\",\n  \"middleware\",\n  \"model\",\n  \"outbound_approval_allowlist\",\n  \"permissions\",\n  \"recursion_limit\",\n  \"run_label\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\n  \"session_computer\",\n  \"session_machine\",\n  \"session_vm_retention\",\n  \"skill_asset_ids\",\n  \"skills\",\n  \"subagents\",\n  \"system_prompt\",\n  \"temperature\",\n  \"tool_description_overrides\",\n  \"workbench\",\n] as const;\n\nexport type ThreadConfigCustomKey = (typeof THREAD_CONFIG_CUSTOM_KEYS)[number];\n\n/** Fast membership checks for builder/test assertions. */\nexport const THREAD_CONFIG_CUSTOM_KEY_SET: ReadonlySet<string> = new Set(\n  THREAD_CONFIG_CUSTOM_KEYS,\n);\n\n/** Replicated-state key of the server config lane (`{ version, custom }`). */\nexport const DEEP_AGENT_CONFIG_STATE_KEY = \"config\";\n\n/** The statewire commands that mutate the server config lane. */\nexport const DEEP_AGENT_CONFIG_COMMANDS = {\n  patch: \"config/patch\",\n  toolsEnable: \"config/tools/enable\",\n  toolsDisable: \"config/tools/disable\",\n} as const;\n\n/** `start_channel` values the session substrate stamps as provenance; anything else clamps to \"web\". */\nexport const KNOWN_START_CHANNELS = [\n  \"agent_orchestration\",\n  \"api\",\n  \"automation\",\n  \"chrome_extension\",\n  \"cli\",\n  \"comment_agent\",\n  \"default_voice\",\n  \"desktop_app\",\n  \"email\",\n  \"mobile_app\",\n  \"office_addin\",\n  \"orchestration\",\n  \"programmatic\",\n  \"slack\",\n  \"sms\",\n  \"task\",\n  \"teams\",\n  \"voice\",\n  \"voice_memo\",\n  \"web\",\n] as const;\n\nexport type KnownStartChannel = (typeof KNOWN_START_CHANNELS)[number];\n\n/** Fast membership checks for builder/test assertions. */\nexport const KNOWN_START_CHANNEL_SET: ReadonlySet<string> = new Set(\n  KNOWN_START_CHANNELS,\n);\n\n/** `runConfig.custom.runtime` marker selecting the deep-agent runtime. */\nexport const DEEP_AGENT_RUNTIME_MARKER = \"athena_deep_agent\";\n\n/**\n * Collab-agent capability ladder (agent schema v3): per explicit\n * capability field, what an ABSENT value means and the value stamped on\n * a new agent. Resolved by agora's `capability_decoder` and the one agent\n * compiler on every run: `passthrough` — explicit only, absent means off;\n * `off` — absent means off under every `runtime` marker; `runtime` —\n * absent derives from the `runtime` marker (`athena_deep_agent` on, any\n * other or missing marker off).\n */\nexport const COLLAB_AGENT_CAPABILITIES = {\n  deepAgentBuiltinsEnabled: { absent: \"runtime\", default: true },\n  interpreterEnabled: { absent: \"off\", default: false },\n  sandboxEnabled: { absent: \"passthrough\", default: false },\n  skillsEnabled: { absent: \"runtime\", default: true },\n} as const;\n\nexport type CollabAgentCapabilityField = keyof typeof COLLAB_AGENT_CAPABILITIES;\n\nexport type CollabAgentCapabilityAbsentMode =\n  (typeof COLLAB_AGENT_CAPABILITIES)[CollabAgentCapabilityField][\"absent\"];\n\n/** `source`/`type` stamped on client-tool interrupt payloads by agora. */\nexport const CLIENT_TOOL_INTERRUPT_SOURCE = \"client_tool\";\n\n/** `status` literals of the result envelope a client resumes a parked client-tool call with. */\nexport const CLIENT_TOOL_RESULT_STATUSES = [\"error\", \"success\"] as const;\n\nexport type ClientToolResultStatus =\n  (typeof CLIENT_TOOL_RESULT_STATUSES)[number];\n\nexport const CLIENT_TOOL_RESULT_STATUS_SUCCESS = \"success\";\n\nexport const CLIENT_TOOL_RESULT_STATUS_ERROR = \"error\";\n\n/**\n * Result envelope a client resumes a parked client-tool call with,\n * keyed by interrupt id:\n * `{ client_tool_results: { <interrupt_id>: <envelope> } }`.\n * Agora relays the envelope to the model verbatim.\n */\nexport type ClientToolResultEnvelopeContract =\n  | { status: typeof CLIENT_TOOL_RESULT_STATUS_SUCCESS; result: unknown }\n  | { status: typeof CLIENT_TOOL_RESULT_STATUS_ERROR; error: string };\n\n/**\n * The deep-agent wire-contract version this client build speaks,\n * declared on every attach. The host records it for attach telemetry\n * and per-version behaviour; it has no minimum client version, so no\n * build is refused for the version it declares (the `protocol` state\n * lane's `minClientVersion` is the constant 1).\n */\nexport const DEEP_AGENT_PROTOCOL_VERSION = 1;\n\n/** Attach header carrying the client's declared contract version. */\nexport const DEEP_AGENT_PROTOCOL_VERSION_HEADER =\n  \"x-athena-deep-agent-protocol-version\";\n\n/** Attach header declaring the head window a fresh client wants in its hello (host-clamped). */\nexport const DEEP_AGENT_MESSAGE_WINDOW_HEADER = \"x-athena-deep-agent-window\";\n\n/** Replicated-state key of the server-advertised version lane. */\nexport const DEEP_AGENT_PROTOCOL_STATE_KEY = \"protocol\";\n\n/** Ephemeral subprotocol carrying a client's message-window interests. */\nexport const DEEP_AGENT_INTEREST_PROTOCOL = \"athena/interest\";\n\n/** Ephemeral subprotocol carrying a client's synced context document. */\nexport const DEEP_AGENT_CONTEXT_PROTOCOL = \"athena/context\";\n\n/** The only interest namespace the host resolves (the linear transcript). */\nexport const DEEP_AGENT_MAIN_NS = \"main\";\n\n/** Window size (interest `before`) a client asks for by default. */\nexport const DEEP_AGENT_DEFAULT_MESSAGE_WINDOW = 40;\n\n/** Bounds on a window size. */\nexport const DEEP_AGENT_MIN_MESSAGE_WINDOW = 8;\n\nexport const DEEP_AGENT_MAX_MESSAGE_WINDOW = 200;\n\n/** Interests one attach may hold at once (the head plus its pages). */\nexport const DEEP_AGENT_MAX_INTERESTS = 16;\n\n/** Command returning a truncated tool output whole. */\nexport const DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND = \"history/tool_output\";\n\n/** Command returning one stored message whole (provenance and full tool output included). */\nexport const DEEP_AGENT_HISTORY_MESSAGE_COMMAND = \"history/message\";\n\n/** Wire key marking a tool message whose content was truncated. */\nexport const DEEP_AGENT_TRUNCATED_CONTENT_KEY = \"athena_content_truncated\";\n\n/** Most inline-image payload characters one message carries whole on the wire. */\nexport const DEEP_AGENT_INLINE_IMAGE_WIRE_BUDGET = 4194304;\n\n/** Wire key on an image block left off the wire: `{ index, chars, mediaType }`. */\nexport const DEEP_AGENT_OMITTED_IMAGE_KEY = \"athena_image_omitted\";\n\n/** The image an omitted block carries instead of its own (a neutral PNG tile). */\nexport const DEEP_AGENT_OMITTED_IMAGE_PLACEHOLDER_URL =\n  \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKAAAAB4AQMAAABPbGssAAAABlBMVEXi6PCUo7jao11HAAAA6ElEQVR42u2UyW3DMBBF3wxogEd2EJbCElKQDRCwC3MpSRc5eLuYokgNLEUxctK/CHyanQts2vRO3QdlALVsXsBvecqxxr1ob0A5GlDJU+hICxN54p/qXAx/+FpoeeE8hTerzfvByn7ifzpaBtWCOwv6bMVMBgzRgNGKmUL9McDs4XOSyEHuoKCI76AiqOugg+y0gx6SN+YQg3QwALGk19pQSKV/reOocyoww27oU5sxhAbKUNgIqrVxrvnovJ80MFgxYy23wtTss44tmL+bAuOE2p2o0fJa3iW/6iR/lEfx8kv3TZtW6AFk5Sf3k+GTswAAAABJRU5ErkJggg==\";\n\n/**\n * Command returning one inline image of a stored message in chunks:\n * `{ messageId, index, offset? }` answers\n * `{ messageId, index, mediaType, offset, total, chunk, next }`; the\n * chunks joined in order are the image's `data:` URL, and `next` is\n * the offset to ask for next (`null` after the last chunk).\n */\nexport const DEEP_AGENT_HISTORY_IMAGE_COMMAND = \"history/image\";\n"],"names":[],"mappings":"AAkHO,MAAM,yBAAyB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAK8D,IAAI;AAAA,EAChE;AACF;AAGO,MAAM,kCAAkC;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMuE,IAAI;AAAA,EACzE;AACF;AAGO,MAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAKiE,IAAI;AAAA,EACnE;AACF;AAaO,MAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAK4D,IAAI;AAAA,EAC9D;AACF;AA2BO,MAAM,+BAA+B;AAQrC,MAAM,oCAAoC;AAE1C,MAAM,kCAAkC;AAmBxC,MAAM,8BAA8B;AAGpC,MAAM,qCACX;AAGK,MAAM,mCAAmC;AAGzC,MAAM,gCAAgC;AAGtC,MAAM,+BAA+B;AAMrC,MAAM,qBAAqB;AAG3B,MAAM,oCAAoC;AAG1C,MAAM,gCAAgC;AAEtC,MAAM,gCAAgC;AAGtC,MAAM,2BAA2B;AAGjC,MAAM,yCAAyC;AAM/C,MAAM,mCAAmC;"}

package/dist/agent-runtime/src/github-wake-event.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-wake-event.cjs","sources":["../../../../agent-runtime/src/github-wake-event.ts"],"sourcesContent":["/**\n * The GitHub event that woke a resting session, read from the user turn the\n * wake injected.\n *\n * When a GitHub webhook wakes a linked session (agora\n * `trigger_engine/actions/handlers/github_thread_wake.py`), the injected user\n * turn carries a provenance envelope under `github_event_source` in its\n * message metadata (`services/channels/github_event_source.py`). The shipped\n * converter exposes that metadata as the thread message's `metadata.custom`,\n * so every surface reads the envelope from there and renders the turn as a\n * compact runtime marker (\"Woke: review comment on #36337\") instead of a user\n * bubble quoting the whole wake text. The envelope is provenance for RENDERING\n * only: the model still receives the full composed text, so a surface that\n * ignores it degrades to a plain bubble, never to a lost instruction.\n */\n\n/** `metadata.custom` key the wake handler stamps on the injected user turn. */\nexport const GITHUB_EVENT_SOURCE_KEY = 'github_event_source';\n\n/**\n * `owner/name`, the only repository shape the wake handler stamps. The\n * envelope is message metadata, which a collaborator with write access to\n * the thread can also author, so a marker is only rendered for an envelope\n * of the real shape and only links back into the named repository on\n * github.com (see {@link githubWakeEventUrl}) — a forged envelope can at\n * most point at its own repository, never at an arbitrary host.\n */\nconst REPO_FULL_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*\\/[A-Za-z0-9._-]+$/;\n\nconst GITHUB_HOSTS: ReadonlySet<string> = new Set(['github.com', 'www.github.com']);\n\nexport interface GithubWakeEvent {\n  /** `owner/repo` the event came from. */\n  repo: string;\n  /** The pull request number, when the event names one. */\n  number: number | null;\n  /** The webhook event name (`pull_request_review_comment`, `check_run`, …). */\n  githubEvent: string | null;\n  /** The event's `action` (`created`, `submitted`, `completed`, …). */\n  action: string | null;\n  /** GitHub login of who caused the event. */\n  sender: string | null;\n  /** The pull request title, when the payload carried one. */\n  title: string | null;\n  /**\n   * Link to the pull request (or the repository for repo-level events),\n   * kept only when it points into `repo` on github.com\n   * ({@link githubWakeEventUrl}); any other value reads as `null`.\n   */\n  url: string | null;\n  /** A review's state (`approved`, `changes_requested`, `commented`). */\n  reviewState: string | null;\n  /** A check's name and conclusion, for check events. */\n  checkName: string | null;\n  checkConclusion: string | null;\n  /** The comment or review body, cut to the card budget by the backend. */\n  bodyExcerpt: string | null;\n  /** ISO 8601 receipt time stamped by the backend. */\n  receivedAt: string | null;\n}\n\nfunction readString(record: Record<string, unknown>, key: string): string | null {\n  const value = record[key];\n  return typeof value === 'string' && value.trim().length > 0 ? value : null;\n}\n\nfunction readNumber(record: Record<string, unknown>, key: string): number | null {\n  const value = record[key];\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value === 'string' && /^\\d+$/.test(value.trim())) return Number(value.trim());\n  return null;\n}\n\n/**\n * The envelope's link when it is an `https://github.com/<repo>/…` URL for the\n * envelope's own repository, else `null`. The marker never renders a link\n * that could lead anywhere else, whatever the metadata claims.\n */\nexport function githubWakeEventUrl(repo: string, url: string | null): string | null {\n  if (url === null) return null;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return null;\n  }\n  if (parsed.protocol !== 'https:' || !GITHUB_HOSTS.has(parsed.hostname.toLowerCase())) {\n    return null;\n  }\n  const path = parsed.pathname.toLowerCase();\n  const prefix = `/${repo.toLowerCase()}`;\n  return path === prefix || path.startsWith(`${prefix}/`) ? parsed.toString() : null;\n}\n\n/**\n * The wake envelope behind a thread message's `metadata.custom`, or\n * `undefined` when the message is an ordinary user turn (or the envelope is\n * not of the shape the wake handler stamps — a missing or malformed\n * repository is not a wake worth rendering).\n */\nexport function readGithubWakeEvent(\n  custom: Record<string, unknown> | null | undefined\n): GithubWakeEvent | undefined {\n  const raw = custom?.[GITHUB_EVENT_SOURCE_KEY];\n  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) return undefined;\n  const record = raw as Record<string, unknown>;\n  const repo = readString(record, 'repo');\n  if (repo === null || !REPO_FULL_NAME.test(repo)) return undefined;\n  return {\n    repo,\n    number: readNumber(record, 'number'),\n    githubEvent: readString(record, 'github_event'),\n    action: readString(record, 'action'),\n    sender: readString(record, 'sender'),\n    title: readString(record, 'title'),\n    url: githubWakeEventUrl(repo, readString(record, 'url')),\n    reviewState: readString(record, 'review_state'),\n    checkName: readString(record, 'check_name'),\n    checkConclusion: readString(record, 'check_conclusion'),\n    bodyExcerpt: readString(record, 'body_excerpt'),\n    receivedAt: readString(record, 'received_at'),\n  };\n}\n\n/**\n * Whether a thread message is a GitHub wake turn. Returns a primitive, so it\n * is safe as a `useAuiState` selector (the reader above builds a fresh object\n * per call; an object snapshot would loop the render under `Object.is`).\n */\nexport function isGithubWakeMessage(custom: Record<string, unknown> | null | undefined): boolean {\n  return readGithubWakeEvent(custom) !== undefined;\n}\n\nfunction humanize(value: string): string {\n  return value.replace(/[._]/g, ' ').trim();\n}\n\n/**\n * The event in a few words, in sentence position (\"review comment\",\n * \"review: changes requested\", \"check CI: failure\", \"pull request opened\").\n */\nexport function githubWakeEventLabel(event: GithubWakeEvent): string {\n  const name = event.githubEvent ?? '';\n  if (name.includes('review_comment')) return 'review comment';\n  if (name.includes('review')) {\n    return event.reviewState ? `review: ${humanize(event.reviewState)}` : 'review';\n  }\n  if (name.includes('comment')) return 'comment';\n  if (name.includes('check')) {\n    const check = event.checkName ? `check ${event.checkName}` : 'check';\n    return event.checkConclusion ? `${check}: ${humanize(event.checkConclusion)}` : check;\n  }\n  if (event.action) return `${humanize(name) || 'event'} ${humanize(event.action)}`.trim();\n  return humanize(name) || 'GitHub event';\n}\n\n/** `owner/repo#123`, or `owner/repo` for a repository-level event. */\nexport function githubWakeReference(event: GithubWakeEvent): string {\n  return event.number !== null ? `${event.repo}#${event.number}` : event.repo;\n}\n\n/**\n * The marker line every surface renders for a wake turn:\n * \"Woke: review comment on #36337\" (the repository when there is no number).\n */\nexport function githubWakeMarkerText(event: GithubWakeEvent): string {\n  const target = event.number !== null ? `#${event.number}` : event.repo;\n  return `Woke: ${githubWakeEventLabel(event)} on ${target}`;\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/github-wake-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-wake-event.js","sources":["../../../../agent-runtime/src/github-wake-event.ts"],"sourcesContent":["/**\n * The GitHub event that woke a resting session, read from the user turn the\n * wake injected.\n *\n * When a GitHub webhook wakes a linked session (agora\n * `trigger_engine/actions/handlers/github_thread_wake.py`), the injected user\n * turn carries a provenance envelope under `github_event_source` in its\n * message metadata (`services/channels/github_event_source.py`). The shipped\n * converter exposes that metadata as the thread message's `metadata.custom`,\n * so every surface reads the envelope from there and renders the turn as a\n * compact runtime marker (\"Woke: review comment on #36337\") instead of a user\n * bubble quoting the whole wake text. The envelope is provenance for RENDERING\n * only: the model still receives the full composed text, so a surface that\n * ignores it degrades to a plain bubble, never to a lost instruction.\n */\n\n/** `metadata.custom` key the wake handler stamps on the injected user turn. */\nexport const GITHUB_EVENT_SOURCE_KEY = 'github_event_source';\n\n/**\n * `owner/name`, the only repository shape the wake handler stamps. The\n * envelope is message metadata, which a collaborator with write access to\n * the thread can also author, so a marker is only rendered for an envelope\n * of the real shape and only links back into the named repository on\n * github.com (see {@link githubWakeEventUrl}) — a forged envelope can at\n * most point at its own repository, never at an arbitrary host.\n */\nconst REPO_FULL_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*\\/[A-Za-z0-9._-]+$/;\n\nconst GITHUB_HOSTS: ReadonlySet<string> = new Set(['github.com', 'www.github.com']);\n\nexport interface GithubWakeEvent {\n  /** `owner/repo` the event came from. */\n  repo: string;\n  /** The pull request number, when the event names one. */\n  number: number | null;\n  /** The webhook event name (`pull_request_review_comment`, `check_run`, …). */\n  githubEvent: string | null;\n  /** The event's `action` (`created`, `submitted`, `completed`, …). */\n  action: string | null;\n  /** GitHub login of who caused the event. */\n  sender: string | null;\n  /** The pull request title, when the payload carried one. */\n  title: string | null;\n  /**\n   * Link to the pull request (or the repository for repo-level events),\n   * kept only when it points into `repo` on github.com\n   * ({@link githubWakeEventUrl}); any other value reads as `null`.\n   */\n  url: string | null;\n  /** A review's state (`approved`, `changes_requested`, `commented`). */\n  reviewState: string | null;\n  /** A check's name and conclusion, for check events. */\n  checkName: string | null;\n  checkConclusion: string | null;\n  /** The comment or review body, cut to the card budget by the backend. */\n  bodyExcerpt: string | null;\n  /** ISO 8601 receipt time stamped by the backend. */\n  receivedAt: string | null;\n}\n\nfunction readString(record: Record<string, unknown>, key: string): string | null {\n  const value = record[key];\n  return typeof value === 'string' && value.trim().length > 0 ? value : null;\n}\n\nfunction readNumber(record: Record<string, unknown>, key: string): number | null {\n  const value = record[key];\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value === 'string' && /^\\d+$/.test(value.trim())) return Number(value.trim());\n  return null;\n}\n\n/**\n * The envelope's link when it is an `https://github.com/<repo>/…` URL for the\n * envelope's own repository, else `null`. The marker never renders a link\n * that could lead anywhere else, whatever the metadata claims.\n */\nexport function githubWakeEventUrl(repo: string, url: string | null): string | null {\n  if (url === null) return null;\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return null;\n  }\n  if (parsed.protocol !== 'https:' || !GITHUB_HOSTS.has(parsed.hostname.toLowerCase())) {\n    return null;\n  }\n  const path = parsed.pathname.toLowerCase();\n  const prefix = `/${repo.toLowerCase()}`;\n  return path === prefix || path.startsWith(`${prefix}/`) ? parsed.toString() : null;\n}\n\n/**\n * The wake envelope behind a thread message's `metadata.custom`, or\n * `undefined` when the message is an ordinary user turn (or the envelope is\n * not of the shape the wake handler stamps — a missing or malformed\n * repository is not a wake worth rendering).\n */\nexport function readGithubWakeEvent(\n  custom: Record<string, unknown> | null | undefined\n): GithubWakeEvent | undefined {\n  const raw = custom?.[GITHUB_EVENT_SOURCE_KEY];\n  if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) return undefined;\n  const record = raw as Record<string, unknown>;\n  const repo = readString(record, 'repo');\n  if (repo === null || !REPO_FULL_NAME.test(repo)) return undefined;\n  return {\n    repo,\n    number: readNumber(record, 'number'),\n    githubEvent: readString(record, 'github_event'),\n    action: readString(record, 'action'),\n    sender: readString(record, 'sender'),\n    title: readString(record, 'title'),\n    url: githubWakeEventUrl(repo, readString(record, 'url')),\n    reviewState: readString(record, 'review_state'),\n    checkName: readString(record, 'check_name'),\n    checkConclusion: readString(record, 'check_conclusion'),\n    bodyExcerpt: readString(record, 'body_excerpt'),\n    receivedAt: readString(record, 'received_at'),\n  };\n}\n\n/**\n * Whether a thread message is a GitHub wake turn. Returns a primitive, so it\n * is safe as a `useAuiState` selector (the reader above builds a fresh object\n * per call; an object snapshot would loop the render under `Object.is`).\n */\nexport function isGithubWakeMessage(custom: Record<string, unknown> | null | undefined): boolean {\n  return readGithubWakeEvent(custom) !== undefined;\n}\n\nfunction humanize(value: string): string {\n  return value.replace(/[._]/g, ' ').trim();\n}\n\n/**\n * The event in a few words, in sentence position (\"review comment\",\n * \"review: changes requested\", \"check CI: failure\", \"pull request opened\").\n */\nexport function githubWakeEventLabel(event: GithubWakeEvent): string {\n  const name = event.githubEvent ?? '';\n  if (name.includes('review_comment')) return 'review comment';\n  if (name.includes('review')) {\n    return event.reviewState ? `review: ${humanize(event.reviewState)}` : 'review';\n  }\n  if (name.includes('comment')) return 'comment';\n  if (name.includes('check')) {\n    const check = event.checkName ? `check ${event.checkName}` : 'check';\n    return event.checkConclusion ? `${check}: ${humanize(event.checkConclusion)}` : check;\n  }\n  if (event.action) return `${humanize(name) || 'event'} ${humanize(event.action)}`.trim();\n  return humanize(name) || 'GitHub event';\n}\n\n/** `owner/repo#123`, or `owner/repo` for a repository-level event. */\nexport function githubWakeReference(event: GithubWakeEvent): string {\n  return event.number !== null ? `${event.repo}#${event.number}` : event.repo;\n}\n\n/**\n * The marker line every surface renders for a wake turn:\n * \"Woke: review comment on #36337\" (the repository when there is no number).\n */\nexport function githubWakeMarkerText(event: GithubWakeEvent): string {\n  const target = event.number !== null ? `#${event.number}` : event.repo;\n  return `Woke: ${githubWakeEventLabel(event)} on ${target}`;\n}\n"],"names":[],"mappings":"AAiBO,MAAM,0BAA0B;AAUvC,MAAM,iBAAiB;AAEvB,MAAM,eAAoC,oBAAI,IAAI,CAAC,cAAc,gBAAgB,CAAC;AAgClF,SAAS,WAAW,QAAiC,KAA4B;AAC/E,QAAM,QAAQ,OAAO,GAAG;AACxB,SAAO,OAAO,UAAU,YAAY,MAAM,OAAO,SAAS,IAAI,QAAQ;AACxE;AAEA,SAAS,WAAW,QAAiC,KAA4B;AAC/E,QAAM,QAAQ,OAAO,GAAG;AACxB,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,EAAG,QAAO;AAChE,MAAI,OAAO,UAAU,YAAY,QAAQ,KAAK,MAAM,KAAA,CAAM,EAAG,QAAO,OAAO,MAAM,MAAM;AACvF,SAAO;AACT;AAOO,SAAS,mBAAmB,MAAc,KAAmC;AAClF,MAAI,QAAQ,KAAM,QAAO;AACzB,MAAI;AACJ,MAAI;AACF,aAAS,IAAI,IAAI,GAAG;AAAA,EACtB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,OAAO,aAAa,YAAY,CAAC,aAAa,IAAI,OAAO,SAAS,YAAA,CAAa,GAAG;AACpF,WAAO;AAAA,EACT;AACA,QAAM,OAAO,OAAO,SAAS,YAAA;AAC7B,QAAM,SAAS,IAAI,KAAK,YAAA,CAAa;AACrC,SAAO,SAAS,UAAU,KAAK,WAAW,GAAG,MAAM,GAAG,IAAI,OAAO,SAAA,IAAa;AAChF;AAQO,SAAS,oBACd,QAC6B;AAC7B,QAAM,MAAM,iCAAS;AACrB,MAAI,OAAO,QAAQ,YAAY,QAAQ,QAAQ,MAAM,QAAQ,GAAG,EAAG,QAAO;AAC1E,QAAM,SAAS;AACf,QAAM,OAAO,WAAW,QAAQ,MAAM;AACtC,MAAI,SAAS,QAAQ,CAAC,eAAe,KAAK,IAAI,EAAG,QAAO;AACxD,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,WAAW,QAAQ,QAAQ;AAAA,IACnC,aAAa,WAAW,QAAQ,cAAc;AAAA,IAC9C,QAAQ,WAAW,QAAQ,QAAQ;AAAA,IACnC,QAAQ,WAAW,QAAQ,QAAQ;AAAA,IACnC,OAAO,WAAW,QAAQ,OAAO;AAAA,IACjC,KAAK,mBAAmB,MAAM,WAAW,QAAQ,KAAK,CAAC;AAAA,IACvD,aAAa,WAAW,QAAQ,cAAc;AAAA,IAC9C,WAAW,WAAW,QAAQ,YAAY;AAAA,IAC1C,iBAAiB,WAAW,QAAQ,kBAAkB;AAAA,IACtD,aAAa,WAAW,QAAQ,cAAc;AAAA,IAC9C,YAAY,WAAW,QAAQ,aAAa;AAAA,EAAA;AAEhD;AAOO,SAAS,oBAAoB,QAA6D;AAC/F,SAAO,oBAAoB,MAAM,MAAM;AACzC;AAEA,SAAS,SAAS,OAAuB;AACvC,SAAO,MAAM,QAAQ,SAAS,GAAG,EAAE,KAAA;AACrC;AAMO,SAAS,qBAAqB,OAAgC;AACnE,QAAM,OAAO,MAAM,eAAe;AAClC,MAAI,KAAK,SAAS,gBAAgB,EAAG,QAAO;AAC5C,MAAI,KAAK,SAAS,QAAQ,GAAG;AAC3B,WAAO,MAAM,cAAc,WAAW,SAAS,MAAM,WAAW,CAAC,KAAK;AAAA,EACxE;AACA,MAAI,KAAK,SAAS,SAAS,EAAG,QAAO;AACrC,MAAI,KAAK,SAAS,OAAO,GAAG;AAC1B,UAAM,QAAQ,MAAM,YAAY,SAAS,MAAM,SAAS,KAAK;AAC7D,WAAO,MAAM,kBAAkB,GAAG,KAAK,KAAK,SAAS,MAAM,eAAe,CAAC,KAAK;AAAA,EAClF;AACA,MAAI,MAAM,OAAQ,QAAO,GAAG,SAAS,IAAI,KAAK,OAAO,IAAI,SAAS,MAAM,MAAM,CAAC,GAAG,KAAA;AAClF,SAAO,SAAS,IAAI,KAAK;AAC3B;AAGO,SAAS,oBAAoB,OAAgC;AAClE,SAAO,MAAM,WAAW,OAAO,GAAG,MAAM,IAAI,IAAI,MAAM,MAAM,KAAK,MAAM;AACzE;AAMO,SAAS,qBAAqB,OAAgC;AACnE,QAAM,SAAS,MAAM,WAAW,OAAO,IAAI,MAAM,MAAM,KAAK,MAAM;AAClE,SAAO,SAAS,qBAAqB,KAAK,CAAC,OAAO,MAAM;AAC1D;"}

package/dist/{packages/agent-runtime → agent-runtime}/src/interrupts.cjs

@@ -33,6 +33,28 @@ function readInterruptMessage(value, fallback = DEFAULT_INTERRUPT_PAUSED_MESSAGE
   return fallback;
 }
 const APPROVAL_WARNING_SEVERITIES = /* @__PURE__ */ new Set(["info", "warning", "critical"]);
+function isNullableString(value) {
+  return value === null || typeof value === "string";
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+function parsePendingApprovalSlackTarget(value) {
+  if (!isRecord(value) || typeof value.catalog_id !== "string") return void 0;
+  const conversationId = value.conversation_id;
+  const threadTs = value.thread_ts;
+  const teamUrl = value.team_url;
+  const people = value.people === void 0 ? [] : value.people;
+  if (!isNullableString(conversationId) || !isNullableString(threadTs) || !isNullableString(teamUrl) || !isStringArray(people))
+    return void 0;
+  return {
+    catalog_id: value.catalog_id,
+    conversation_id: conversationId,
+    thread_ts: threadTs,
+    team_url: teamUrl,
+    people
+  };
+}
 function parsePendingApprovalContext(value) {
   if (!isRecord(value)) return void 0;
   const facts = Array.isArray(value.facts) ? value.facts.flatMap(
@@ -43,7 +65,8 @@ function parsePendingApprovalContext(value) {
     const severity = typeof warning.severity === "string" && APPROVAL_WARNING_SEVERITIES.has(warning.severity) ? warning.severity : "info";
     return [{ severity, message: warning.message }];
   }) : [];
-  return facts.length > 0 || warnings.length > 0 ? { facts, warnings } : void 0;
+  const slackTarget = parsePendingApprovalSlackTarget(value.slack_target);
+  return facts.length > 0 || warnings.length > 0 || slackTarget ? { facts, warnings, ...slackTarget ? { slack_target: slackTarget } : {} } : void 0;
 }
 function pendingActionRequests(hitl) {
   const context = hitl == null ? void 0 : hitl.context;