@athenaintel/react 0.57.2 → 0.59.0

package/dist/agent-runtime/src/tool-names.cjs

@@ -3,14 +3,28 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const TASK_TOOL_NAME = "task";
 const EVAL_TOOL_NAME = "eval";
 const EXECUTE_TOOL_NAME = "execute";
+const RUN_PYTHON_CODE_TOOL_NAME = "run_python_code";
+const EXECUTE_PRESENTATION_CODE_TOOL_NAME = "execute_presentation_code";
+const EXECUTE_SPREADSHEET_CODE_TOOL_NAME = "execute_spreadsheet_code";
+const EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME = "execute_word_document_code";
+const PTC_PARENT_TOOL_NAMES = /* @__PURE__ */ new Set([
+  EXECUTE_TOOL_NAME,
+  EVAL_TOOL_NAME,
+  RUN_PYTHON_CODE_TOOL_NAME,
+  EXECUTE_PRESENTATION_CODE_TOOL_NAME,
+  EXECUTE_SPREADSHEET_CODE_TOOL_NAME,
+  EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME
+]);
 const WRITE_FILE_TOOL_NAME = "write_file";
 const EDIT_FILE_TOOL_NAME = "edit_file";
 const SUBMIT_FEEDBACK_TOOL_NAME = "submit_feedback";
 const QUIET_TOOL_NAMES = /* @__PURE__ */ new Set([SUBMIT_FEEDBACK_TOOL_NAME]);
+const REDACTED_TOOL_NAME = "athena_redacted_tool";
 const START_ASYNC_TASK_TOOL_NAME = "start_async_task";
 const CHECK_ASYNC_TASK_TOOL_NAME = "check_async_task";
 const UPDATE_ASYNC_TASK_TOOL_NAME = "update_async_task";
 const CANCEL_ASYNC_TASK_TOOL_NAME = "cancel_async_task";
+const ASK_AGENT_TOOL_NAME = "ask_agent";
 function salientToolCallDetail(toolCall) {
   const args = toolCall.args ?? {};
   const firstString = (...keys) => {
@@ -63,12 +77,19 @@ function salientToolCallDetail(toolCall) {
   const clean = detail.replace(/\s+/g, " ").trim();
   return clean.length > 80 ? `${clean.slice(0, 79)}…` : clean;
 }
+exports.ASK_AGENT_TOOL_NAME = ASK_AGENT_TOOL_NAME;
 exports.CANCEL_ASYNC_TASK_TOOL_NAME = CANCEL_ASYNC_TASK_TOOL_NAME;
 exports.CHECK_ASYNC_TASK_TOOL_NAME = CHECK_ASYNC_TASK_TOOL_NAME;
 exports.EDIT_FILE_TOOL_NAME = EDIT_FILE_TOOL_NAME;
 exports.EVAL_TOOL_NAME = EVAL_TOOL_NAME;
+exports.EXECUTE_PRESENTATION_CODE_TOOL_NAME = EXECUTE_PRESENTATION_CODE_TOOL_NAME;
+exports.EXECUTE_SPREADSHEET_CODE_TOOL_NAME = EXECUTE_SPREADSHEET_CODE_TOOL_NAME;
 exports.EXECUTE_TOOL_NAME = EXECUTE_TOOL_NAME;
+exports.EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME = EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME;
+exports.PTC_PARENT_TOOL_NAMES = PTC_PARENT_TOOL_NAMES;
 exports.QUIET_TOOL_NAMES = QUIET_TOOL_NAMES;
+exports.REDACTED_TOOL_NAME = REDACTED_TOOL_NAME;
+exports.RUN_PYTHON_CODE_TOOL_NAME = RUN_PYTHON_CODE_TOOL_NAME;
 exports.START_ASYNC_TASK_TOOL_NAME = START_ASYNC_TASK_TOOL_NAME;
 exports.SUBMIT_FEEDBACK_TOOL_NAME = SUBMIT_FEEDBACK_TOOL_NAME;
 exports.TASK_TOOL_NAME = TASK_TOOL_NAME;

package/dist/agent-runtime/src/tool-names.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tool-names.cjs","sources":["../../../../agent-runtime/src/tool-names.ts"],"sourcesContent":["/**\n * Names of the deepagents built-in tools as they appear on the wire, plus the\n * shared arg shapes / display derivations keyed on those names. One home so\n * tool cards, activity panels, and transcript renderers on every surface agree\n * on which call is which.\n */\nimport type { LangChainToolCall } from \"@assistant-ui/react-langgraph\";\n\n/** The built-in deepagents delegation tool; a `task` call spawns a subagent. */\nexport const TASK_TOOL_NAME = \"task\";\n/** The QuickJS code-interpreter tool (langchain_quickjs middleware). */\nexport const EVAL_TOOL_NAME = \"eval\";\n/** The built-in deepagents sandbox shell tool. */\nexport const EXECUTE_TOOL_NAME = \"execute\";\n/**\n * The Athena studio code executors: sandboxed Python whose SDK calls the\n * backend records as PTC sub-calls, exactly like `execute` / `eval`.\n */\nexport const RUN_PYTHON_CODE_TOOL_NAME = \"run_python_code\";\nexport const EXECUTE_PRESENTATION_CODE_TOOL_NAME = \"execute_presentation_code\";\nexport const EXECUTE_SPREADSHEET_CODE_TOOL_NAME = \"execute_spreadsheet_code\";\nexport const EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME = \"execute_word_document_code\";\n/** Every tool whose ToolMessage artifact may carry promoted PTC sub-calls. */\nexport const PTC_PARENT_TOOL_NAMES: ReadonlySet<string> = new Set<string>([\n  EXECUTE_TOOL_NAME,\n  EVAL_TOOL_NAME,\n  RUN_PYTHON_CODE_TOOL_NAME,\n  EXECUTE_PRESENTATION_CODE_TOOL_NAME,\n  EXECUTE_SPREADSHEET_CODE_TOOL_NAME,\n  EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME,\n]);\n/** The built-in deepagents filesystem write/edit tools. */\nexport const WRITE_FILE_TOOL_NAME = \"write_file\";\nexport const EDIT_FILE_TOOL_NAME = \"edit_file\";\n\n/**\n * Tools whose calls render nothing in chat: no card, no status line. The call\n * and its result stay in the stored transcript and in exports; only the\n * conversation view leaves them out (see `convertDeepAgentMessage`).\n */\nexport const SUBMIT_FEEDBACK_TOOL_NAME = \"submit_feedback\";\nexport const QUIET_TOOL_NAMES: ReadonlySet<string> = new Set([SUBMIT_FEEDBACK_TOOL_NAME]);\n\n/**\n * The deepagents async-subagent tools (ADR 0006 coding workers ride these):\n * `start_async_task` launches a remote task, `check_async_task` polls it,\n * `update_async_task` sends a follow-up, `cancel_async_task` interrupts it.\n */\nexport const START_ASYNC_TASK_TOOL_NAME = \"start_async_task\";\nexport const CHECK_ASYNC_TASK_TOOL_NAME = \"check_async_task\";\nexport const UPDATE_ASYNC_TASK_TOOL_NAME = \"update_async_task\";\nexport const CANCEL_ASYNC_TASK_TOOL_NAME = \"cancel_async_task\";\nexport const LIST_ASYNC_TASKS_TOOL_NAME = \"list_async_tasks\";\n/** The Agent Communication toolkit's synchronous ask of a listed collab agent. */\nexport const ASK_AGENT_TOOL_NAME = \"ask_agent\";\nexport const ASYNC_TASK_TOOL_NAMES = [\n  START_ASYNC_TASK_TOOL_NAME,\n  CHECK_ASYNC_TASK_TOOL_NAME,\n  UPDATE_ASYNC_TASK_TOOL_NAME,\n  CANCEL_ASYNC_TASK_TOOL_NAME,\n  LIST_ASYNC_TASKS_TOOL_NAME,\n] as const;\n\n/**\n * Args shape shared by `write_file` / `edit_file` (single source of truth for\n * both the tool card and the changed-files panel). `write_file` carries the\n * whole `content`; `edit_file` carries the `old_string` → `new_string`\n * replacement instead (deepagents `WriteFileSchema` / `EditFileSchema`).\n */\nexport type FileToolArgs = {\n  file_path?: string;\n  path?: string;\n  content?: string;\n  old_string?: string;\n  new_string?: string;\n  replace_all?: boolean;\n  /** Cross-asset targeting: the sandbox-backed asset the tool acted on. */\n  sandbox_asset_id?: string | null;\n};\n\n/**\n * Human-salient one-liner for a nested tool call — the argument a person would\n * glance at (`execute` → the command, file tools → the path, searches → the\n * query). Empty string when nothing salient exists; capped so the ticker line\n * can't blow out the card.\n */\nexport function salientToolCallDetail(toolCall: LangChainToolCall): string {\n  const args = (toolCall.args ?? {}) as Record<string, unknown>;\n  const firstString = (...keys: string[]): string => {\n    for (const key of keys) {\n      const value = args[key];\n      if (typeof value === \"string\" && value) return value;\n    }\n    return \"\";\n  };\n  let detail: string;\n  switch (toolCall.name) {\n    case EXECUTE_TOOL_NAME:\n      detail = firstString(\"command\");\n      break;\n    case WRITE_FILE_TOOL_NAME:\n    case EDIT_FILE_TOOL_NAME:\n      detail = firstString(\"file_path\", \"path\");\n      break;\n    case \"read_file\":\n    case \"ls\":\n      detail = firstString(\"file_path\", \"path\");\n      break;\n    case \"write_todos\": {\n      const todos = args.todos;\n      detail = Array.isArray(todos)\n        ? `${todos.length} step${todos.length === 1 ? \"\" : \"s\"}`\n        : \"\";\n      break;\n    }\n    case TASK_TOOL_NAME:\n    case START_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"description\", \"subagent_type\");\n      break;\n    case UPDATE_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"message\", \"task_id\");\n      break;\n    case CHECK_ASYNC_TASK_TOOL_NAME:\n    case CANCEL_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"task_id\");\n      break;\n    default:\n      detail = firstString(\n        \"query\",\n        \"pattern\",\n        \"command\",\n        \"path\",\n        \"file_path\",\n        \"url\",\n        \"question\",\n      );\n  }\n  const clean = detail.replace(/\\s+/g, \" \").trim();\n  return clean.length > 80 ? `${clean.slice(0, 79)}…` : clean;\n}\n"],"names":[],"mappings":";;AASO,MAAM,iBAAiB;AAEvB,MAAM,iBAAiB;AAEvB,MAAM,oBAAoB;AAmB1B,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAO5B,MAAM,4BAA4B;AAClC,MAAM,mBAAwC,oBAAI,IAAI,CAAC,yBAAyB,CAAC;AAOjF,MAAM,6BAA6B;AACnC,MAAM,6BAA6B;AACnC,MAAM,8BAA8B;AACpC,MAAM,8BAA8B;AAmCpC,SAAS,sBAAsB,UAAqC;AACzE,QAAM,OAAQ,SAAS,QAAQ,CAAA;AAC/B,QAAM,cAAc,IAAI,SAA2B;AACjD,eAAW,OAAO,MAAM;AACtB,YAAM,QAAQ,KAAK,GAAG;AACtB,UAAI,OAAO,UAAU,YAAY,MAAO,QAAO;AAAA,IACjD;AACA,WAAO;AAAA,EACT;AACA,MAAI;AACJ,UAAQ,SAAS,MAAA;AAAA,IACf,KAAK;AACH,eAAS,YAAY,SAAS;AAC9B;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,aAAa,MAAM;AACxC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,aAAa,MAAM;AACxC;AAAA,IACF,KAAK,eAAe;AAClB,YAAM,QAAQ,KAAK;AACnB,eAAS,MAAM,QAAQ,KAAK,IACxB,GAAG,MAAM,MAAM,QAAQ,MAAM,WAAW,IAAI,KAAK,GAAG,KACpD;AACJ;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,eAAe,eAAe;AACnD;AAAA,IACF,KAAK;AACH,eAAS,YAAY,WAAW,SAAS;AACzC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,SAAS;AAC9B;AAAA,IACF;AACE,eAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,EACF;AAEJ,QAAM,QAAQ,OAAO,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAC1C,SAAO,MAAM,SAAS,KAAK,GAAG,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM;AACxD;;;;;;;;;;;;;"}
+{"version":3,"file":"tool-names.cjs","sources":["../../../../agent-runtime/src/tool-names.ts"],"sourcesContent":["/**\n * Names of the deepagents built-in tools as they appear on the wire, plus the\n * shared arg shapes / display derivations keyed on those names. One home so\n * tool cards, activity panels, and transcript renderers on every surface agree\n * on which call is which.\n */\nimport type { LangChainToolCall } from \"@assistant-ui/react-langgraph\";\n\n/** The built-in deepagents delegation tool; a `task` call spawns a subagent. */\nexport const TASK_TOOL_NAME = \"task\";\n/** The QuickJS code-interpreter tool (langchain_quickjs middleware). */\nexport const EVAL_TOOL_NAME = \"eval\";\n/** The built-in deepagents sandbox shell tool. */\nexport const EXECUTE_TOOL_NAME = \"execute\";\n/**\n * The Athena studio code executors: sandboxed Python whose SDK calls the\n * backend records as PTC sub-calls, exactly like `execute` / `eval`.\n */\nexport const RUN_PYTHON_CODE_TOOL_NAME = \"run_python_code\";\nexport const EXECUTE_PRESENTATION_CODE_TOOL_NAME = \"execute_presentation_code\";\nexport const EXECUTE_SPREADSHEET_CODE_TOOL_NAME = \"execute_spreadsheet_code\";\nexport const EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME = \"execute_word_document_code\";\n/** Every tool whose ToolMessage artifact may carry promoted PTC sub-calls. */\nexport const PTC_PARENT_TOOL_NAMES: ReadonlySet<string> = new Set<string>([\n  EXECUTE_TOOL_NAME,\n  EVAL_TOOL_NAME,\n  RUN_PYTHON_CODE_TOOL_NAME,\n  EXECUTE_PRESENTATION_CODE_TOOL_NAME,\n  EXECUTE_SPREADSHEET_CODE_TOOL_NAME,\n  EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME,\n]);\n/** The built-in deepagents filesystem write/edit tools. */\nexport const WRITE_FILE_TOOL_NAME = \"write_file\";\nexport const EDIT_FILE_TOOL_NAME = \"edit_file\";\n\n/**\n * Tools whose calls render nothing in chat: no card, no status line. The call\n * and its result stay in the stored transcript and in exports; only the\n * conversation view leaves them out (see `convertDeepAgentMessage`).\n */\nexport const SUBMIT_FEEDBACK_TOOL_NAME = \"submit_feedback\";\nexport const QUIET_TOOL_NAMES: ReadonlySet<string> = new Set([SUBMIT_FEEDBACK_TOOL_NAME]);\n\n/**\n * The tool name a redacted call renders under. A participant who is not the\n * conversation's owner receives tool calls as `{ id, type }` stubs and tool\n * results as `{ type, id, tool_call_id, status }` (agora `read_filters`);\n * `convertDeepAgentMessage` names both this, and tool cards render it as a\n * muted \"Used a tool\" chip.\n */\nexport const REDACTED_TOOL_NAME = \"athena_redacted_tool\";\n\n/**\n * The deepagents async-subagent tools (ADR 0006 coding workers ride these):\n * `start_async_task` launches a remote task, `check_async_task` polls it,\n * `update_async_task` sends a follow-up, `cancel_async_task` interrupts it.\n */\nexport const START_ASYNC_TASK_TOOL_NAME = \"start_async_task\";\nexport const CHECK_ASYNC_TASK_TOOL_NAME = \"check_async_task\";\nexport const UPDATE_ASYNC_TASK_TOOL_NAME = \"update_async_task\";\nexport const CANCEL_ASYNC_TASK_TOOL_NAME = \"cancel_async_task\";\nexport const LIST_ASYNC_TASKS_TOOL_NAME = \"list_async_tasks\";\n/** The Agent Communication toolkit's synchronous ask of a listed collab agent. */\nexport const ASK_AGENT_TOOL_NAME = \"ask_agent\";\nexport const ASYNC_TASK_TOOL_NAMES = [\n  START_ASYNC_TASK_TOOL_NAME,\n  CHECK_ASYNC_TASK_TOOL_NAME,\n  UPDATE_ASYNC_TASK_TOOL_NAME,\n  CANCEL_ASYNC_TASK_TOOL_NAME,\n  LIST_ASYNC_TASKS_TOOL_NAME,\n] as const;\n\n/**\n * Args shape shared by `write_file` / `edit_file` (single source of truth for\n * both the tool card and the changed-files panel). `write_file` carries the\n * whole `content`; `edit_file` carries the `old_string` → `new_string`\n * replacement instead (deepagents `WriteFileSchema` / `EditFileSchema`).\n */\nexport type FileToolArgs = {\n  file_path?: string;\n  path?: string;\n  content?: string;\n  old_string?: string;\n  new_string?: string;\n  replace_all?: boolean;\n  /** Cross-asset targeting: the sandbox-backed asset the tool acted on. */\n  sandbox_asset_id?: string | null;\n};\n\n/**\n * Human-salient one-liner for a nested tool call — the argument a person would\n * glance at (`execute` → the command, file tools → the path, searches → the\n * query). Empty string when nothing salient exists; capped so the ticker line\n * can't blow out the card.\n */\nexport function salientToolCallDetail(toolCall: LangChainToolCall): string {\n  const args = (toolCall.args ?? {}) as Record<string, unknown>;\n  const firstString = (...keys: string[]): string => {\n    for (const key of keys) {\n      const value = args[key];\n      if (typeof value === \"string\" && value) return value;\n    }\n    return \"\";\n  };\n  let detail: string;\n  switch (toolCall.name) {\n    case EXECUTE_TOOL_NAME:\n      detail = firstString(\"command\");\n      break;\n    case WRITE_FILE_TOOL_NAME:\n    case EDIT_FILE_TOOL_NAME:\n      detail = firstString(\"file_path\", \"path\");\n      break;\n    case \"read_file\":\n    case \"ls\":\n      detail = firstString(\"file_path\", \"path\");\n      break;\n    case \"write_todos\": {\n      const todos = args.todos;\n      detail = Array.isArray(todos)\n        ? `${todos.length} step${todos.length === 1 ? \"\" : \"s\"}`\n        : \"\";\n      break;\n    }\n    case TASK_TOOL_NAME:\n    case START_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"description\", \"subagent_type\");\n      break;\n    case UPDATE_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"message\", \"task_id\");\n      break;\n    case CHECK_ASYNC_TASK_TOOL_NAME:\n    case CANCEL_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"task_id\");\n      break;\n    default:\n      detail = firstString(\n        \"query\",\n        \"pattern\",\n        \"command\",\n        \"path\",\n        \"file_path\",\n        \"url\",\n        \"question\",\n      );\n  }\n  const clean = detail.replace(/\\s+/g, \" \").trim();\n  return clean.length > 80 ? `${clean.slice(0, 79)}…` : clean;\n}\n"],"names":[],"mappings":";;AASO,MAAM,iBAAiB;AAEvB,MAAM,iBAAiB;AAEvB,MAAM,oBAAoB;AAK1B,MAAM,4BAA4B;AAClC,MAAM,sCAAsC;AAC5C,MAAM,qCAAqC;AAC3C,MAAM,uCAAuC;AAE7C,MAAM,4CAAiD,IAAY;AAAA,EACxE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAO5B,MAAM,4BAA4B;AAClC,MAAM,mBAAwC,oBAAI,IAAI,CAAC,yBAAyB,CAAC;AASjF,MAAM,qBAAqB;AAO3B,MAAM,6BAA6B;AACnC,MAAM,6BAA6B;AACnC,MAAM,8BAA8B;AACpC,MAAM,8BAA8B;AAGpC,MAAM,sBAAsB;AAgC5B,SAAS,sBAAsB,UAAqC;AACzE,QAAM,OAAQ,SAAS,QAAQ,CAAA;AAC/B,QAAM,cAAc,IAAI,SAA2B;AACjD,eAAW,OAAO,MAAM;AACtB,YAAM,QAAQ,KAAK,GAAG;AACtB,UAAI,OAAO,UAAU,YAAY,MAAO,QAAO;AAAA,IACjD;AACA,WAAO;AAAA,EACT;AACA,MAAI;AACJ,UAAQ,SAAS,MAAA;AAAA,IACf,KAAK;AACH,eAAS,YAAY,SAAS;AAC9B;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,aAAa,MAAM;AACxC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,aAAa,MAAM;AACxC;AAAA,IACF,KAAK,eAAe;AAClB,YAAM,QAAQ,KAAK;AACnB,eAAS,MAAM,QAAQ,KAAK,IACxB,GAAG,MAAM,MAAM,QAAQ,MAAM,WAAW,IAAI,KAAK,GAAG,KACpD;AACJ;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,eAAe,eAAe;AACnD;AAAA,IACF,KAAK;AACH,eAAS,YAAY,WAAW,SAAS;AACzC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,SAAS;AAC9B;AAAA,IACF;AACE,eAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,EACF;AAEJ,QAAM,QAAQ,OAAO,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAC1C,SAAO,MAAM,SAAS,KAAK,GAAG,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM;AACxD;;;;;;;;;;;;;;;;;;;;"}

package/dist/agent-runtime/src/tool-names.d.ts

@@ -31,6 +31,14 @@ export declare const EDIT_FILE_TOOL_NAME = "edit_file";
  */
 export declare const SUBMIT_FEEDBACK_TOOL_NAME = "submit_feedback";
 export declare const QUIET_TOOL_NAMES: ReadonlySet<string>;
+/**
+ * The tool name a redacted call renders under. A participant who is not the
+ * conversation's owner receives tool calls as `{ id, type }` stubs and tool
+ * results as `{ type, id, tool_call_id, status }` (agora `read_filters`);
+ * `convertDeepAgentMessage` names both this, and tool cards render it as a
+ * muted "Used a tool" chip.
+ */
+export declare const REDACTED_TOOL_NAME = "athena_redacted_tool";
 /**
  * The deepagents async-subagent tools (ADR 0006 coding workers ride these):
  * `start_async_task` launches a remote task, `check_async_task` polls it,

package/dist/agent-runtime/src/tool-names.js

@@ -1,14 +1,28 @@
 const TASK_TOOL_NAME = "task";
 const EVAL_TOOL_NAME = "eval";
 const EXECUTE_TOOL_NAME = "execute";
+const RUN_PYTHON_CODE_TOOL_NAME = "run_python_code";
+const EXECUTE_PRESENTATION_CODE_TOOL_NAME = "execute_presentation_code";
+const EXECUTE_SPREADSHEET_CODE_TOOL_NAME = "execute_spreadsheet_code";
+const EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME = "execute_word_document_code";
+const PTC_PARENT_TOOL_NAMES = /* @__PURE__ */ new Set([
+  EXECUTE_TOOL_NAME,
+  EVAL_TOOL_NAME,
+  RUN_PYTHON_CODE_TOOL_NAME,
+  EXECUTE_PRESENTATION_CODE_TOOL_NAME,
+  EXECUTE_SPREADSHEET_CODE_TOOL_NAME,
+  EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME
+]);
 const WRITE_FILE_TOOL_NAME = "write_file";
 const EDIT_FILE_TOOL_NAME = "edit_file";
 const SUBMIT_FEEDBACK_TOOL_NAME = "submit_feedback";
 const QUIET_TOOL_NAMES = /* @__PURE__ */ new Set([SUBMIT_FEEDBACK_TOOL_NAME]);
+const REDACTED_TOOL_NAME = "athena_redacted_tool";
 const START_ASYNC_TASK_TOOL_NAME = "start_async_task";
 const CHECK_ASYNC_TASK_TOOL_NAME = "check_async_task";
 const UPDATE_ASYNC_TASK_TOOL_NAME = "update_async_task";
 const CANCEL_ASYNC_TASK_TOOL_NAME = "cancel_async_task";
+const ASK_AGENT_TOOL_NAME = "ask_agent";
 function salientToolCallDetail(toolCall) {
   const args = toolCall.args ?? {};
   const firstString = (...keys) => {
@@ -62,12 +76,19 @@ function salientToolCallDetail(toolCall) {
   return clean.length > 80 ? `${clean.slice(0, 79)}…` : clean;
 }
 export {
+  ASK_AGENT_TOOL_NAME,
   CANCEL_ASYNC_TASK_TOOL_NAME,
   CHECK_ASYNC_TASK_TOOL_NAME,
   EDIT_FILE_TOOL_NAME,
   EVAL_TOOL_NAME,
+  EXECUTE_PRESENTATION_CODE_TOOL_NAME,
+  EXECUTE_SPREADSHEET_CODE_TOOL_NAME,
   EXECUTE_TOOL_NAME,
+  EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME,
+  PTC_PARENT_TOOL_NAMES,
   QUIET_TOOL_NAMES,
+  REDACTED_TOOL_NAME,
+  RUN_PYTHON_CODE_TOOL_NAME,
   START_ASYNC_TASK_TOOL_NAME,
   SUBMIT_FEEDBACK_TOOL_NAME,
   TASK_TOOL_NAME,

package/dist/agent-runtime/src/tool-names.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-names.js","sources":["../../../../agent-runtime/src/tool-names.ts"],"sourcesContent":["/**\n * Names of the deepagents built-in tools as they appear on the wire, plus the\n * shared arg shapes / display derivations keyed on those names. One home so\n * tool cards, activity panels, and transcript renderers on every surface agree\n * on which call is which.\n */\nimport type { LangChainToolCall } from \"@assistant-ui/react-langgraph\";\n\n/** The built-in deepagents delegation tool; a `task` call spawns a subagent. */\nexport const TASK_TOOL_NAME = \"task\";\n/** The QuickJS code-interpreter tool (langchain_quickjs middleware). */\nexport const EVAL_TOOL_NAME = \"eval\";\n/** The built-in deepagents sandbox shell tool. */\nexport const EXECUTE_TOOL_NAME = \"execute\";\n/**\n * The Athena studio code executors: sandboxed Python whose SDK calls the\n * backend records as PTC sub-calls, exactly like `execute` / `eval`.\n */\nexport const RUN_PYTHON_CODE_TOOL_NAME = \"run_python_code\";\nexport const EXECUTE_PRESENTATION_CODE_TOOL_NAME = \"execute_presentation_code\";\nexport const EXECUTE_SPREADSHEET_CODE_TOOL_NAME = \"execute_spreadsheet_code\";\nexport const EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME = \"execute_word_document_code\";\n/** Every tool whose ToolMessage artifact may carry promoted PTC sub-calls. */\nexport const PTC_PARENT_TOOL_NAMES: ReadonlySet<string> = new Set<string>([\n  EXECUTE_TOOL_NAME,\n  EVAL_TOOL_NAME,\n  RUN_PYTHON_CODE_TOOL_NAME,\n  EXECUTE_PRESENTATION_CODE_TOOL_NAME,\n  EXECUTE_SPREADSHEET_CODE_TOOL_NAME,\n  EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME,\n]);\n/** The built-in deepagents filesystem write/edit tools. */\nexport const WRITE_FILE_TOOL_NAME = \"write_file\";\nexport const EDIT_FILE_TOOL_NAME = \"edit_file\";\n\n/**\n * Tools whose calls render nothing in chat: no card, no status line. The call\n * and its result stay in the stored transcript and in exports; only the\n * conversation view leaves them out (see `convertDeepAgentMessage`).\n */\nexport const SUBMIT_FEEDBACK_TOOL_NAME = \"submit_feedback\";\nexport const QUIET_TOOL_NAMES: ReadonlySet<string> = new Set([SUBMIT_FEEDBACK_TOOL_NAME]);\n\n/**\n * The deepagents async-subagent tools (ADR 0006 coding workers ride these):\n * `start_async_task` launches a remote task, `check_async_task` polls it,\n * `update_async_task` sends a follow-up, `cancel_async_task` interrupts it.\n */\nexport const START_ASYNC_TASK_TOOL_NAME = \"start_async_task\";\nexport const CHECK_ASYNC_TASK_TOOL_NAME = \"check_async_task\";\nexport const UPDATE_ASYNC_TASK_TOOL_NAME = \"update_async_task\";\nexport const CANCEL_ASYNC_TASK_TOOL_NAME = \"cancel_async_task\";\nexport const LIST_ASYNC_TASKS_TOOL_NAME = \"list_async_tasks\";\n/** The Agent Communication toolkit's synchronous ask of a listed collab agent. */\nexport const ASK_AGENT_TOOL_NAME = \"ask_agent\";\nexport const ASYNC_TASK_TOOL_NAMES = [\n  START_ASYNC_TASK_TOOL_NAME,\n  CHECK_ASYNC_TASK_TOOL_NAME,\n  UPDATE_ASYNC_TASK_TOOL_NAME,\n  CANCEL_ASYNC_TASK_TOOL_NAME,\n  LIST_ASYNC_TASKS_TOOL_NAME,\n] as const;\n\n/**\n * Args shape shared by `write_file` / `edit_file` (single source of truth for\n * both the tool card and the changed-files panel). `write_file` carries the\n * whole `content`; `edit_file` carries the `old_string` → `new_string`\n * replacement instead (deepagents `WriteFileSchema` / `EditFileSchema`).\n */\nexport type FileToolArgs = {\n  file_path?: string;\n  path?: string;\n  content?: string;\n  old_string?: string;\n  new_string?: string;\n  replace_all?: boolean;\n  /** Cross-asset targeting: the sandbox-backed asset the tool acted on. */\n  sandbox_asset_id?: string | null;\n};\n\n/**\n * Human-salient one-liner for a nested tool call — the argument a person would\n * glance at (`execute` → the command, file tools → the path, searches → the\n * query). Empty string when nothing salient exists; capped so the ticker line\n * can't blow out the card.\n */\nexport function salientToolCallDetail(toolCall: LangChainToolCall): string {\n  const args = (toolCall.args ?? {}) as Record<string, unknown>;\n  const firstString = (...keys: string[]): string => {\n    for (const key of keys) {\n      const value = args[key];\n      if (typeof value === \"string\" && value) return value;\n    }\n    return \"\";\n  };\n  let detail: string;\n  switch (toolCall.name) {\n    case EXECUTE_TOOL_NAME:\n      detail = firstString(\"command\");\n      break;\n    case WRITE_FILE_TOOL_NAME:\n    case EDIT_FILE_TOOL_NAME:\n      detail = firstString(\"file_path\", \"path\");\n      break;\n    case \"read_file\":\n    case \"ls\":\n      detail = firstString(\"file_path\", \"path\");\n      break;\n    case \"write_todos\": {\n      const todos = args.todos;\n      detail = Array.isArray(todos)\n        ? `${todos.length} step${todos.length === 1 ? \"\" : \"s\"}`\n        : \"\";\n      break;\n    }\n    case TASK_TOOL_NAME:\n    case START_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"description\", \"subagent_type\");\n      break;\n    case UPDATE_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"message\", \"task_id\");\n      break;\n    case CHECK_ASYNC_TASK_TOOL_NAME:\n    case CANCEL_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"task_id\");\n      break;\n    default:\n      detail = firstString(\n        \"query\",\n        \"pattern\",\n        \"command\",\n        \"path\",\n        \"file_path\",\n        \"url\",\n        \"question\",\n      );\n  }\n  const clean = detail.replace(/\\s+/g, \" \").trim();\n  return clean.length > 80 ? `${clean.slice(0, 79)}…` : clean;\n}\n"],"names":[],"mappings":"AASO,MAAM,iBAAiB;AAEvB,MAAM,iBAAiB;AAEvB,MAAM,oBAAoB;AAmB1B,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAO5B,MAAM,4BAA4B;AAClC,MAAM,mBAAwC,oBAAI,IAAI,CAAC,yBAAyB,CAAC;AAOjF,MAAM,6BAA6B;AACnC,MAAM,6BAA6B;AACnC,MAAM,8BAA8B;AACpC,MAAM,8BAA8B;AAmCpC,SAAS,sBAAsB,UAAqC;AACzE,QAAM,OAAQ,SAAS,QAAQ,CAAA;AAC/B,QAAM,cAAc,IAAI,SAA2B;AACjD,eAAW,OAAO,MAAM;AACtB,YAAM,QAAQ,KAAK,GAAG;AACtB,UAAI,OAAO,UAAU,YAAY,MAAO,QAAO;AAAA,IACjD;AACA,WAAO;AAAA,EACT;AACA,MAAI;AACJ,UAAQ,SAAS,MAAA;AAAA,IACf,KAAK;AACH,eAAS,YAAY,SAAS;AAC9B;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,aAAa,MAAM;AACxC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,aAAa,MAAM;AACxC;AAAA,IACF,KAAK,eAAe;AAClB,YAAM,QAAQ,KAAK;AACnB,eAAS,MAAM,QAAQ,KAAK,IACxB,GAAG,MAAM,MAAM,QAAQ,MAAM,WAAW,IAAI,KAAK,GAAG,KACpD;AACJ;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,eAAe,eAAe;AACnD;AAAA,IACF,KAAK;AACH,eAAS,YAAY,WAAW,SAAS;AACzC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,SAAS;AAC9B;AAAA,IACF;AACE,eAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,EACF;AAEJ,QAAM,QAAQ,OAAO,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAC1C,SAAO,MAAM,SAAS,KAAK,GAAG,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM;AACxD;"}
+{"version":3,"file":"tool-names.js","sources":["../../../../agent-runtime/src/tool-names.ts"],"sourcesContent":["/**\n * Names of the deepagents built-in tools as they appear on the wire, plus the\n * shared arg shapes / display derivations keyed on those names. One home so\n * tool cards, activity panels, and transcript renderers on every surface agree\n * on which call is which.\n */\nimport type { LangChainToolCall } from \"@assistant-ui/react-langgraph\";\n\n/** The built-in deepagents delegation tool; a `task` call spawns a subagent. */\nexport const TASK_TOOL_NAME = \"task\";\n/** The QuickJS code-interpreter tool (langchain_quickjs middleware). */\nexport const EVAL_TOOL_NAME = \"eval\";\n/** The built-in deepagents sandbox shell tool. */\nexport const EXECUTE_TOOL_NAME = \"execute\";\n/**\n * The Athena studio code executors: sandboxed Python whose SDK calls the\n * backend records as PTC sub-calls, exactly like `execute` / `eval`.\n */\nexport const RUN_PYTHON_CODE_TOOL_NAME = \"run_python_code\";\nexport const EXECUTE_PRESENTATION_CODE_TOOL_NAME = \"execute_presentation_code\";\nexport const EXECUTE_SPREADSHEET_CODE_TOOL_NAME = \"execute_spreadsheet_code\";\nexport const EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME = \"execute_word_document_code\";\n/** Every tool whose ToolMessage artifact may carry promoted PTC sub-calls. */\nexport const PTC_PARENT_TOOL_NAMES: ReadonlySet<string> = new Set<string>([\n  EXECUTE_TOOL_NAME,\n  EVAL_TOOL_NAME,\n  RUN_PYTHON_CODE_TOOL_NAME,\n  EXECUTE_PRESENTATION_CODE_TOOL_NAME,\n  EXECUTE_SPREADSHEET_CODE_TOOL_NAME,\n  EXECUTE_WORD_DOCUMENT_CODE_TOOL_NAME,\n]);\n/** The built-in deepagents filesystem write/edit tools. */\nexport const WRITE_FILE_TOOL_NAME = \"write_file\";\nexport const EDIT_FILE_TOOL_NAME = \"edit_file\";\n\n/**\n * Tools whose calls render nothing in chat: no card, no status line. The call\n * and its result stay in the stored transcript and in exports; only the\n * conversation view leaves them out (see `convertDeepAgentMessage`).\n */\nexport const SUBMIT_FEEDBACK_TOOL_NAME = \"submit_feedback\";\nexport const QUIET_TOOL_NAMES: ReadonlySet<string> = new Set([SUBMIT_FEEDBACK_TOOL_NAME]);\n\n/**\n * The tool name a redacted call renders under. A participant who is not the\n * conversation's owner receives tool calls as `{ id, type }` stubs and tool\n * results as `{ type, id, tool_call_id, status }` (agora `read_filters`);\n * `convertDeepAgentMessage` names both this, and tool cards render it as a\n * muted \"Used a tool\" chip.\n */\nexport const REDACTED_TOOL_NAME = \"athena_redacted_tool\";\n\n/**\n * The deepagents async-subagent tools (ADR 0006 coding workers ride these):\n * `start_async_task` launches a remote task, `check_async_task` polls it,\n * `update_async_task` sends a follow-up, `cancel_async_task` interrupts it.\n */\nexport const START_ASYNC_TASK_TOOL_NAME = \"start_async_task\";\nexport const CHECK_ASYNC_TASK_TOOL_NAME = \"check_async_task\";\nexport const UPDATE_ASYNC_TASK_TOOL_NAME = \"update_async_task\";\nexport const CANCEL_ASYNC_TASK_TOOL_NAME = \"cancel_async_task\";\nexport const LIST_ASYNC_TASKS_TOOL_NAME = \"list_async_tasks\";\n/** The Agent Communication toolkit's synchronous ask of a listed collab agent. */\nexport const ASK_AGENT_TOOL_NAME = \"ask_agent\";\nexport const ASYNC_TASK_TOOL_NAMES = [\n  START_ASYNC_TASK_TOOL_NAME,\n  CHECK_ASYNC_TASK_TOOL_NAME,\n  UPDATE_ASYNC_TASK_TOOL_NAME,\n  CANCEL_ASYNC_TASK_TOOL_NAME,\n  LIST_ASYNC_TASKS_TOOL_NAME,\n] as const;\n\n/**\n * Args shape shared by `write_file` / `edit_file` (single source of truth for\n * both the tool card and the changed-files panel). `write_file` carries the\n * whole `content`; `edit_file` carries the `old_string` → `new_string`\n * replacement instead (deepagents `WriteFileSchema` / `EditFileSchema`).\n */\nexport type FileToolArgs = {\n  file_path?: string;\n  path?: string;\n  content?: string;\n  old_string?: string;\n  new_string?: string;\n  replace_all?: boolean;\n  /** Cross-asset targeting: the sandbox-backed asset the tool acted on. */\n  sandbox_asset_id?: string | null;\n};\n\n/**\n * Human-salient one-liner for a nested tool call — the argument a person would\n * glance at (`execute` → the command, file tools → the path, searches → the\n * query). Empty string when nothing salient exists; capped so the ticker line\n * can't blow out the card.\n */\nexport function salientToolCallDetail(toolCall: LangChainToolCall): string {\n  const args = (toolCall.args ?? {}) as Record<string, unknown>;\n  const firstString = (...keys: string[]): string => {\n    for (const key of keys) {\n      const value = args[key];\n      if (typeof value === \"string\" && value) return value;\n    }\n    return \"\";\n  };\n  let detail: string;\n  switch (toolCall.name) {\n    case EXECUTE_TOOL_NAME:\n      detail = firstString(\"command\");\n      break;\n    case WRITE_FILE_TOOL_NAME:\n    case EDIT_FILE_TOOL_NAME:\n      detail = firstString(\"file_path\", \"path\");\n      break;\n    case \"read_file\":\n    case \"ls\":\n      detail = firstString(\"file_path\", \"path\");\n      break;\n    case \"write_todos\": {\n      const todos = args.todos;\n      detail = Array.isArray(todos)\n        ? `${todos.length} step${todos.length === 1 ? \"\" : \"s\"}`\n        : \"\";\n      break;\n    }\n    case TASK_TOOL_NAME:\n    case START_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"description\", \"subagent_type\");\n      break;\n    case UPDATE_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"message\", \"task_id\");\n      break;\n    case CHECK_ASYNC_TASK_TOOL_NAME:\n    case CANCEL_ASYNC_TASK_TOOL_NAME:\n      detail = firstString(\"task_id\");\n      break;\n    default:\n      detail = firstString(\n        \"query\",\n        \"pattern\",\n        \"command\",\n        \"path\",\n        \"file_path\",\n        \"url\",\n        \"question\",\n      );\n  }\n  const clean = detail.replace(/\\s+/g, \" \").trim();\n  return clean.length > 80 ? `${clean.slice(0, 79)}…` : clean;\n}\n"],"names":[],"mappings":"AASO,MAAM,iBAAiB;AAEvB,MAAM,iBAAiB;AAEvB,MAAM,oBAAoB;AAK1B,MAAM,4BAA4B;AAClC,MAAM,sCAAsC;AAC5C,MAAM,qCAAqC;AAC3C,MAAM,uCAAuC;AAE7C,MAAM,4CAAiD,IAAY;AAAA,EACxE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAO5B,MAAM,4BAA4B;AAClC,MAAM,mBAAwC,oBAAI,IAAI,CAAC,yBAAyB,CAAC;AASjF,MAAM,qBAAqB;AAO3B,MAAM,6BAA6B;AACnC,MAAM,6BAA6B;AACnC,MAAM,8BAA8B;AACpC,MAAM,8BAA8B;AAGpC,MAAM,sBAAsB;AAgC5B,SAAS,sBAAsB,UAAqC;AACzE,QAAM,OAAQ,SAAS,QAAQ,CAAA;AAC/B,QAAM,cAAc,IAAI,SAA2B;AACjD,eAAW,OAAO,MAAM;AACtB,YAAM,QAAQ,KAAK,GAAG;AACtB,UAAI,OAAO,UAAU,YAAY,MAAO,QAAO;AAAA,IACjD;AACA,WAAO;AAAA,EACT;AACA,MAAI;AACJ,UAAQ,SAAS,MAAA;AAAA,IACf,KAAK;AACH,eAAS,YAAY,SAAS;AAC9B;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,aAAa,MAAM;AACxC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,aAAa,MAAM;AACxC;AAAA,IACF,KAAK,eAAe;AAClB,YAAM,QAAQ,KAAK;AACnB,eAAS,MAAM,QAAQ,KAAK,IACxB,GAAG,MAAM,MAAM,QAAQ,MAAM,WAAW,IAAI,KAAK,GAAG,KACpD;AACJ;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,eAAe,eAAe;AACnD;AAAA,IACF,KAAK;AACH,eAAS,YAAY,WAAW,SAAS;AACzC;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,eAAS,YAAY,SAAS;AAC9B;AAAA,IACF;AACE,eAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,EACF;AAEJ,QAAM,QAAQ,OAAO,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAC1C,SAAO,MAAM,SAAS,KAAK,GAAG,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM;AACxD;"}

package/dist/agent-runtime/src/typed-interrupt-kinds.cjs

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const typedInterrupts = require("./typed-interrupts.cjs");
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOptional(value, check) {
+  return value === void 0 || check(value);
+}
+const isString = (value) => typeof value === "string";
+const isFiniteNumber = (value) => typeof value === "number" && Number.isFinite(value);
+const TYPED_APPROVAL_SOURCES = /* @__PURE__ */ new Set([
+  typedInterrupts.TypedInterruptSource.PM_SCHEDULE_APPROVAL,
+  typedInterrupts.TypedInterruptSource.BROWSE_PROFILE_APPROVAL,
+  typedInterrupts.TypedInterruptSource.TOOLKIT_SELECTION
+]);
+function isTypedApprovalInterrupt(payload) {
+  return payload.type === typedInterrupts.TypedInterruptType.HITL || TYPED_APPROVAL_SOURCES.has(payload.source);
+}
+const TYPED_NON_RUNNING_ACTIONS = /* @__PURE__ */ new Set(["reject", "cancel"]);
+function typedAnswerLetsSomethingRun(value) {
+  if (!isRecord(value)) return true;
+  return !(typeof value.action === "string" && TYPED_NON_RUNNING_ACTIONS.has(value.action));
+}
+const TYPED_INTERRUPT_ID_KEY = "__interrupt_id__";
+const TYPED_INTERRUPT_INSTANCE_KEY = "__interrupt_instance_id__";
+function stampTypedInterruptAnswer({
+  payload,
+  value
+}) {
+  const stamped = {
+    ...value,
+    [TYPED_INTERRUPT_ID_KEY]: payload.source,
+    [TYPED_INTERRUPT_INSTANCE_KEY]: payload.interrupt_instance_id
+  };
+  const parsed = JSON.parse(JSON.stringify(stamped));
+  return isRecord(parsed) ? parsed : {};
+}
+function typedInterruptCancel() {
+  return { action: "cancel" };
+}
+function hasInterruptTimeout(payload) {
+  return payload.timeout_seconds !== void 0 && payload.timeout_at !== void 0;
+}
+function interruptTimeoutRemaining(payload, now = Date.now()) {
+  if (!payload.timeout_at) return null;
+  const deadline = new Date(payload.timeout_at).getTime();
+  if (Number.isNaN(deadline)) return null;
+  return Math.max(0, (deadline - now) / 1e3);
+}
+function stripInterruptTimeoutText(message) {
+  if (!message) return "";
+  return message.replace(/\s*\(timeout in \d+s\)/, "");
+}
+function interruptDraftId(payload) {
+  return payload.timeout_at ?? payload.source;
+}
+function isCustomWithSource(payload, source) {
+  return payload.type === typedInterrupts.TypedInterruptType.CUSTOM && payload.source === source;
+}
+const isStringArray = (value) => Array.isArray(value) && value.every(isString);
+function optionalText(value) {
+  return isString(value) ? value : null;
+}
+const QuestionType = {
+  TEXT: "text",
+  YES_NO: "yes_no",
+  SINGLE_CHOICE: "single_choice",
+  MULTI_CHOICE: "multi_choice"
+};
+const QUESTION_TYPES = new Set(Object.values(QuestionType));
+function isQuestionnaireInterrupt(payload) {
+  return isCustomWithSource(payload, typedInterrupts.TypedInterruptSource.ASK_QUESTIONNAIRE);
+}
+function readQuestionnaireContext(payload) {
+  const { context } = payload;
+  const questions = Array.isArray(context.questions) ? context.questions.filter(isRecord).map(
+    (question) => ({
+      text: isString(question.text) ? question.text : "",
+      type: isString(question.type) && QUESTION_TYPES.has(question.type) ? question.type : QuestionType.TEXT,
+      options: isStringArray(question.options) ? question.options : [],
+      recommended: optionalText(question.recommended)
+    })
+  ) : [];
+  return { title: optionalText(context.title), questions };
+}
+function questionnaireResume(answers) {
+  return { answers: answers.map(({ value, comment }) => ({ value, comment })) };
+}
+function isToolkitSelectionInterrupt(payload) {
+  return isCustomWithSource(payload, typedInterrupts.TypedInterruptSource.TOOLKIT_SELECTION);
+}
+const NO_TOOLKIT_SELECTION = { action: "enable", toolkits: [] };
+function readToolkitItem(value) {
+  if (!isRecord(value) || !isString(value.toolkit_id) || !isString(value.display_name)) return null;
+  const { description, rationale, added_tool_count: added } = value;
+  if (description != null && !isString(description) || rationale != null && !isString(rationale) || !isOptional(added, isFiniteNumber)) {
+    return null;
+  }
+  return {
+    toolkit_id: value.toolkit_id,
+    display_name: value.display_name,
+    description: optionalText(description),
+    rationale: optionalText(rationale),
+    ...isFiniteNumber(added) ? { added_tool_count: added } : {}
+  };
+}
+function readToolkitSelectionContext(payload) {
+  const { context } = payload;
+  const { action, toolkits, total, current_tool_count: current, max_tools: max } = context;
+  if (action !== "enable" && action !== "disable") return NO_TOOLKIT_SELECTION;
+  if (!Array.isArray(toolkits)) return NO_TOOLKIT_SELECTION;
+  if (!isOptional(total, isFiniteNumber) || !isOptional(current, isFiniteNumber) || !isOptional(max, isFiniteNumber)) {
+    return NO_TOOLKIT_SELECTION;
+  }
+  const items = toolkits.map(readToolkitItem);
+  if (items.some((item) => item === null)) return NO_TOOLKIT_SELECTION;
+  return {
+    action,
+    toolkits: items,
+    ...isFiniteNumber(current) ? { current_tool_count: current } : {},
+    ...isFiniteNumber(max) ? { max_tools: max } : {}
+  };
+}
+function toolkitSelectionResume({
+  action,
+  approvedToolkitIds,
+  reason
+}) {
+  return {
+    action,
+    approved_toolkit_ids: action === "approve" ? [...approvedToolkitIds] : [],
+    ...reason ? { reason } : {}
+  };
+}
+function isBrowseProfileApprovalInterrupt(payload) {
+  return isCustomWithSource(payload, typedInterrupts.TypedInterruptSource.BROWSE_PROFILE_APPROVAL);
+}
+function readBrowseProfileApprovalContext(payload) {
+  const approval = payload.context.browse_profile_approval;
+  if (!isRecord(approval)) return { profiles: [], sessionApprovalAllowed: false };
+  const profiles = Array.isArray(approval.profiles) ? approval.profiles.flatMap(
+    (profile) => isRecord(profile) && isString(profile.profile_asset_id) ? [
+      {
+        profile_asset_id: profile.profile_asset_id,
+        approval_scope: optionalText(profile.approval_scope)
+      }
+    ] : []
+  ) : [];
+  return { profiles, sessionApprovalAllowed: approval.session_approval_allowed === true };
+}
+function browseProfileApprovalResume({
+  action,
+  forSession = false
+}) {
+  return action === "approve" && forSession ? { action, scope: "session" } : { action };
+}
+function isPmScheduleApprovalInterrupt(payload) {
+  return isCustomWithSource(payload, typedInterrupts.TypedInterruptSource.PM_SCHEDULE_APPROVAL);
+}
+const PM_SCHEDULE_FIELDS = [
+  "project_asset_id",
+  "cron",
+  "timezone",
+  "summary",
+  "scheduled_for",
+  "schedule_id"
+];
+function readPmScheduleApprovalContext(payload) {
+  const { context } = payload;
+  const fields = PM_SCHEDULE_FIELDS.flatMap((key) => {
+    const value = context[key];
+    return value ? [[key, String(value)]] : [];
+  });
+  return { action: optionalText(context.action), fields };
+}
+function typedApprovalResume({
+  action,
+  reason
+}) {
+  return reason ? { action, reason } : { action };
+}
+function isWaitForMinutesInterrupt(payload) {
+  return isCustomWithSource(payload, typedInterrupts.TypedInterruptSource.WAIT_FOR_MINUTES);
+}
+function readWaitForMinutesContext(payload) {
+  const { minutes, reason, timeout_seconds: timeoutSeconds } = payload.context;
+  return {
+    minutes: isFiniteNumber(minutes) ? minutes : 0,
+    reason: isString(reason) && reason ? reason : null,
+    timeoutSeconds: isFiniteNumber(timeoutSeconds) ? timeoutSeconds : null
+  };
+}
+function isRequestFileInterrupt(payload) {
+  return isCustomWithSource(payload, typedInterrupts.TypedInterruptSource.REQUEST_FILE);
+}
+function readRequestFileContext(payload) {
+  const { prompt, allow_multiple: allowMultiple } = payload.context;
+  return {
+    prompt: isString(prompt) && prompt || payload.message || "Upload a file to continue.",
+    allowMultiple: allowMultiple === true
+  };
+}
+function requestFileResume(files) {
+  return {
+    files: files.map(({ asset_id, filename, mention }) => ({ asset_id, filename, mention }))
+  };
+}
+function readTypedHitlContext(payload) {
+  const { context } = payload;
+  return {
+    toolId: optionalText(context.tool_id),
+    toolCallId: optionalText(context.tool_call_id),
+    toolArgs: isRecord(context.tool_args) ? context.tool_args : {},
+    approvalContext: context.approval_context
+  };
+}
+exports.QuestionType = QuestionType;
+exports.TYPED_INTERRUPT_ID_KEY = TYPED_INTERRUPT_ID_KEY;
+exports.TYPED_INTERRUPT_INSTANCE_KEY = TYPED_INTERRUPT_INSTANCE_KEY;
+exports.browseProfileApprovalResume = browseProfileApprovalResume;
+exports.hasInterruptTimeout = hasInterruptTimeout;
+exports.interruptDraftId = interruptDraftId;
+exports.interruptTimeoutRemaining = interruptTimeoutRemaining;
+exports.isBrowseProfileApprovalInterrupt = isBrowseProfileApprovalInterrupt;
+exports.isPmScheduleApprovalInterrupt = isPmScheduleApprovalInterrupt;
+exports.isQuestionnaireInterrupt = isQuestionnaireInterrupt;
+exports.isRequestFileInterrupt = isRequestFileInterrupt;
+exports.isToolkitSelectionInterrupt = isToolkitSelectionInterrupt;
+exports.isTypedApprovalInterrupt = isTypedApprovalInterrupt;
+exports.isWaitForMinutesInterrupt = isWaitForMinutesInterrupt;
+exports.questionnaireResume = questionnaireResume;
+exports.readBrowseProfileApprovalContext = readBrowseProfileApprovalContext;
+exports.readPmScheduleApprovalContext = readPmScheduleApprovalContext;
+exports.readQuestionnaireContext = readQuestionnaireContext;
+exports.readRequestFileContext = readRequestFileContext;
+exports.readToolkitSelectionContext = readToolkitSelectionContext;
+exports.readTypedHitlContext = readTypedHitlContext;
+exports.readWaitForMinutesContext = readWaitForMinutesContext;
+exports.requestFileResume = requestFileResume;
+exports.stampTypedInterruptAnswer = stampTypedInterruptAnswer;
+exports.stripInterruptTimeoutText = stripInterruptTimeoutText;
+exports.toolkitSelectionResume = toolkitSelectionResume;
+exports.typedAnswerLetsSomethingRun = typedAnswerLetsSomethingRun;
+exports.typedApprovalResume = typedApprovalResume;
+exports.typedInterruptCancel = typedInterruptCancel;
+//# sourceMappingURL=typed-interrupt-kinds.cjs.map

package/dist/agent-runtime/src/typed-interrupt-kinds.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-interrupt-kinds.cjs","sources":["../../../../agent-runtime/src/typed-interrupt-kinds.ts"],"sourcesContent":["/**\n * What a typed card needs beyond the selector (`typed-interrupts.ts`): which\n * answers decide something only a person may decide (`isTypedApprovalInterrupt`),\n * the stamps the raiser's stale-resume check reads, the timer, and each kind's\n * context reader and resume, each mirroring its raiser\n * (`agora/services/interrupts/definitions.py`) and Olympus's\n * `config/interruptDefinitions.ts`.\n */\n\nimport {\n  type TypedInterruptPayload,\n  TypedInterruptSource,\n  TypedInterruptType,\n} from './typed-interrupts';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isOptional<T>(value: unknown, check: (candidate: unknown) => candidate is T): boolean {\n  return value === undefined || check(value);\n}\n\nconst isString = (value: unknown): value is string => typeof value === 'string';\nconst isFiniteNumber = (value: unknown): value is number =>\n  typeof value === 'number' && Number.isFinite(value);\n\n/**\n * The parks a person answers by approving: a tool-raised HITL approval (type\n * `hitl`), a project manager's schedule (standing work), a saved login the\n * agent asks to use, and toolkits it asks to turn on. A question the agent\n * asked (a form, a questionnaire, a file) is not: answering it decides\n * nothing. Mirrors agora's `answer_checks.is_typed_approval_interrupt`, which\n * holds an approving answer to a signed-in person (or, while checks are\n * enforced, a device key with a passkey check).\n */\nconst TYPED_APPROVAL_SOURCES: ReadonlySet<string> = new Set([\n  TypedInterruptSource.PM_SCHEDULE_APPROVAL,\n  TypedInterruptSource.BROWSE_PROFILE_APPROVAL,\n  TypedInterruptSource.TOOLKIT_SELECTION,\n]);\n\nexport function isTypedApprovalInterrupt(payload: TypedInterruptPayload): boolean {\n  return payload.type === TypedInterruptType.HITL || TYPED_APPROVAL_SOURCES.has(payload.source);\n}\n\n/**\n * What every typed raiser reads as running nothing: a reject, and the card's\n * cancel, which ends the interrupted operation (agora's\n * `TYPED_NON_RUNNING_ACTIONS`). Anything else, unreadable included, runs.\n */\nconst TYPED_NON_RUNNING_ACTIONS: ReadonlySet<string> = new Set(['reject', 'cancel']);\n\n/** Whether a typed answer lets anything run, as its raiser reads it (fails closed). */\nexport function typedAnswerLetsSomethingRun(value: unknown): boolean {\n  if (!isRecord(value)) return true;\n  return !(typeof value.action === 'string' && TYPED_NON_RUNNING_ACTIONS.has(value.action));\n}\n\n/** The keys the raiser's stale-resume check reads on an answer. */\nexport const TYPED_INTERRUPT_ID_KEY = '__interrupt_id__';\nexport const TYPED_INTERRUPT_INSTANCE_KEY = '__interrupt_instance_id__';\n\n/**\n * The answer as it leaves: the kind's resume value stamped with the park it\n * answers (`__interrupt_id__`, `__interrupt_instance_id__`) and serialized as\n * plain JSON, so an optional field a card left unset never reaches statewire\n * as `undefined` (an invalid document there).\n */\nexport function stampTypedInterruptAnswer({\n  payload,\n  value,\n}: {\n  payload: TypedInterruptPayload;\n  value: Readonly<Record<string, unknown>>;\n}): Record<string, unknown> {\n  const stamped = {\n    ...value,\n    [TYPED_INTERRUPT_ID_KEY]: payload.source,\n    [TYPED_INTERRUPT_INSTANCE_KEY]: payload.interrupt_instance_id,\n  };\n  const parsed: unknown = JSON.parse(JSON.stringify(stamped));\n  return isRecord(parsed) ? parsed : {};\n}\n\n/** `{ action: 'cancel' }`: every typed raiser ends the interrupted operation (`FormCancelledError`). */\nexport function typedInterruptCancel(): Record<string, string> {\n  return { action: 'cancel' };\n}\n\n// ── Timeouts ─────────────────────────────────────────────────────────────\n\n/** Whether the backend's timer answers this park for the person at a deadline. */\nexport function hasInterruptTimeout(payload: TypedInterruptPayload): boolean {\n  return payload.timeout_seconds !== undefined && payload.timeout_at !== undefined;\n}\n\n/** Seconds until the backend's timer answers (never negative), or `null` without one. */\nexport function interruptTimeoutRemaining(\n  payload: TypedInterruptPayload,\n  now: number = Date.now(),\n): number | null {\n  if (!payload.timeout_at) return null;\n  const deadline = new Date(payload.timeout_at).getTime();\n  if (Number.isNaN(deadline)) return null;\n  return Math.max(0, (deadline - now) / 1000);\n}\n\n/**\n * The park's message without the raiser's `(timeout in 180s)` suffix, for\n * once the person stopped the timer and the card says \"take your time\".\n */\nexport function stripInterruptTimeoutText(message: string | null | undefined): string {\n  if (!message) return '';\n  return message.replace(/\\s*\\(timeout in \\d+s\\)/, '');\n}\n\n/**\n * The key a timed interrupt's draft is saved under: the one the backend's\n * timer worker checks before it fires (`_draft_interrupt_id_for_timeout`: the\n * park's `timeout_at`, else its source). A draft under any other key does not\n * hold the timer.\n */\nexport function interruptDraftId(payload: TypedInterruptPayload): string {\n  return payload.timeout_at ?? payload.source;\n}\n\n// ── Kinds ────────────────────────────────────────────────────────────────\n\nfunction isCustomWithSource(payload: TypedInterruptPayload, source: string): boolean {\n  return payload.type === TypedInterruptType.CUSTOM && payload.source === source;\n}\n\nconst isStringArray = (value: unknown): value is string[] =>\n  Array.isArray(value) && value.every(isString);\n\nfunction optionalText(value: unknown): string | null {\n  return isString(value) ? value : null;\n}\n\n/** The kinds of question the `ask` tool asks. */\nexport const QuestionType = {\n  TEXT: 'text',\n  YES_NO: 'yes_no',\n  SINGLE_CHOICE: 'single_choice',\n  MULTI_CHOICE: 'multi_choice',\n} as const;\n\nexport type QuestionType = (typeof QuestionType)[keyof typeof QuestionType];\n\nconst QUESTION_TYPES: ReadonlySet<string> = new Set(Object.values(QuestionType));\n\nexport interface TypedQuestion {\n  readonly text: string;\n  readonly type: QuestionType;\n  readonly options: readonly string[];\n  /** The answer the agent recommends (an option, or `yes` / `no`); also the timeout's answer. */\n  readonly recommended: string | null;\n}\n\nexport interface QuestionnaireContext {\n  /** The questionnaire's own title, when the agent gave one. */\n  readonly title: string | null;\n  readonly questions: readonly TypedQuestion[];\n}\n\nexport function isQuestionnaireInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.ASK_QUESTIONNAIRE);\n}\n\n/** The questions the `ask` tool parked on (`misc_tools.py`), in order. */\nexport function readQuestionnaireContext(payload: TypedInterruptPayload): QuestionnaireContext {\n  const { context } = payload;\n  const questions = Array.isArray(context.questions)\n    ? context.questions.filter(isRecord).map(\n        (question): TypedQuestion => ({\n          text: isString(question.text) ? question.text : '',\n          type:\n            isString(question.type) && QUESTION_TYPES.has(question.type)\n              ? (question.type as QuestionType)\n              : QuestionType.TEXT,\n          options: isStringArray(question.options) ? question.options : [],\n          recommended: optionalText(question.recommended),\n        }),\n      )\n    : [];\n  return { title: optionalText(context.title), questions };\n}\n\n/** One answer of a questionnaire's resume (`QuestionnaireAnswer`). */\nexport interface QuestionnaireAnswer {\n  readonly value: string;\n  readonly comment: string | null;\n}\n\n/** The questionnaire's resume (`QuestionnaireResume`); an empty list is the card's cancel. */\nexport function questionnaireResume(answers: readonly QuestionnaireAnswer[]): Record<string, unknown> {\n  return { answers: answers.map(({ value, comment }) => ({ value, comment })) };\n}\n\n/** One toolkit `toggle_toolkit` proposes (`agent_config_tools.py`). */\nexport interface ToolkitSelectionItem {\n  readonly toolkit_id: string;\n  readonly display_name: string;\n  readonly description: string | null;\n  /** The agent's reason it needs this toolkit, shown to the person. */\n  readonly rationale: string | null;\n  /** Tools this toolkit adds beyond those already on (the tool cap's headroom). */\n  readonly added_tool_count?: number;\n}\n\nexport interface ToolkitSelectionContext {\n  readonly action: 'enable' | 'disable';\n  readonly toolkits: readonly ToolkitSelectionItem[];\n  /** Tools already on and the run's cap (enable only), so the card warns before a breach. */\n  readonly current_tool_count?: number;\n  readonly max_tools?: number;\n}\n\nexport function isToolkitSelectionInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.TOOLKIT_SELECTION);\n}\n\nconst NO_TOOLKIT_SELECTION: ToolkitSelectionContext = { action: 'enable', toolkits: [] };\n\nfunction readToolkitItem(value: unknown): ToolkitSelectionItem | null {\n  if (!isRecord(value) || !isString(value.toolkit_id) || !isString(value.display_name)) return null;\n  const { description, rationale, added_tool_count: added } = value;\n  if (\n    (description != null && !isString(description)) ||\n    (rationale != null && !isString(rationale)) ||\n    !isOptional(added, isFiniteNumber)\n  ) {\n    return null;\n  }\n  return {\n    toolkit_id: value.toolkit_id,\n    display_name: value.display_name,\n    description: optionalText(description),\n    rationale: optionalText(rationale),\n    ...(isFiniteNumber(added) ? { added_tool_count: added } : {}),\n  };\n}\n\n/**\n * The toolkits `toggle_toolkit` asks to turn on or off. Read whole or not at\n * all, as Olympus's schema reads it: a malformed context is an empty enable.\n */\nexport function readToolkitSelectionContext(payload: TypedInterruptPayload): ToolkitSelectionContext {\n  const { context } = payload;\n  const { action, toolkits, total, current_tool_count: current, max_tools: max } = context;\n  if (action !== 'enable' && action !== 'disable') return NO_TOOLKIT_SELECTION;\n  if (!Array.isArray(toolkits)) return NO_TOOLKIT_SELECTION;\n  if (\n    !isOptional(total, isFiniteNumber) ||\n    !isOptional(current, isFiniteNumber) ||\n    !isOptional(max, isFiniteNumber)\n  ) {\n    return NO_TOOLKIT_SELECTION;\n  }\n  const items = toolkits.map(readToolkitItem);\n  if (items.some((item) => item === null)) return NO_TOOLKIT_SELECTION;\n  return {\n    action,\n    toolkits: items as ToolkitSelectionItem[],\n    ...(isFiniteNumber(current) ? { current_tool_count: current } : {}),\n    ...(isFiniteNumber(max) ? { max_tools: max } : {}),\n  };\n}\n\n/** The toolkit selection's resume (`ToolkitSelectionResume`). */\nexport function toolkitSelectionResume({\n  action,\n  approvedToolkitIds,\n  reason,\n}: {\n  action: 'approve' | 'reject';\n  approvedToolkitIds: readonly string[];\n  reason?: string;\n}): Record<string, unknown> {\n  return {\n    action,\n    approved_toolkit_ids: action === 'approve' ? [...approvedToolkitIds] : [],\n    ...(reason ? { reason } : {}),\n  };\n}\n\n/** One saved login the browse-profile gate asks to use (`browse_profile_gate_node.py`). */\nexport interface BrowseProfileApprovalProfile {\n  readonly profile_asset_id: string;\n  /** What the ordinary approve grants: `session` (this browser session) or `attempt` (this one action). */\n  readonly approval_scope: string | null;\n}\n\nexport interface BrowseProfileApprovalContext {\n  readonly profiles: readonly BrowseProfileApprovalProfile[];\n  /** Stamped when every shown profile may be approved for the rest of the thread. */\n  readonly sessionApprovalAllowed: boolean;\n}\n\nexport function isBrowseProfileApprovalInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.BROWSE_PROFILE_APPROVAL);\n}\n\nexport function readBrowseProfileApprovalContext(\n  payload: TypedInterruptPayload,\n): BrowseProfileApprovalContext {\n  const approval = payload.context.browse_profile_approval;\n  if (!isRecord(approval)) return { profiles: [], sessionApprovalAllowed: false };\n  const profiles = Array.isArray(approval.profiles)\n    ? approval.profiles.flatMap((profile): BrowseProfileApprovalProfile[] =>\n        isRecord(profile) && isString(profile.profile_asset_id)\n          ? [\n              {\n                profile_asset_id: profile.profile_asset_id,\n                approval_scope: optionalText(profile.approval_scope),\n              },\n            ]\n          : [],\n      )\n    : [];\n  return { profiles, sessionApprovalAllowed: approval.session_approval_allowed === true };\n}\n\n/** The browse-profile gate's resume (`BrowseProfileApprovalResume`). */\nexport function browseProfileApprovalResume({\n  action,\n  forSession = false,\n}: {\n  action: 'approve' | 'reject';\n  /** On an approve: stop asking about these profiles for the rest of the thread. */\n  forSession?: boolean;\n}): Record<string, unknown> {\n  return action === 'approve' && forSession ? { action, scope: 'session' } : { action };\n}\n\nexport function isPmScheduleApprovalInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.PM_SCHEDULE_APPROVAL);\n}\n\n/** The project manager schedule a person approves (`pm_tools.py`). */\nexport interface PmScheduleApprovalContext {\n  /** `delete` for a deletion; anything else is a creation. */\n  readonly action: string | null;\n  /** The schedule's facts, in the card's order, by their context key. */\n  readonly fields: readonly (readonly [key: string, value: string])[];\n}\n\nconst PM_SCHEDULE_FIELDS = [\n  'project_asset_id',\n  'cron',\n  'timezone',\n  'summary',\n  'scheduled_for',\n  'schedule_id',\n] as const;\n\nexport function readPmScheduleApprovalContext(payload: TypedInterruptPayload): PmScheduleApprovalContext {\n  const { context } = payload;\n  // Only the facts the schedule has, as Olympus's card lists them.\n  const fields = PM_SCHEDULE_FIELDS.flatMap((key): (readonly [string, string])[] => {\n    const value = context[key];\n    return value ? [[key, String(value)]] : [];\n  });\n  return { action: optionalText(context.action), fields };\n}\n\n/** An approval's resume (`HITLResume`, `PMScheduleApprovalResume`): approve, or reject with a reason. */\nexport function typedApprovalResume({\n  action,\n  reason,\n}: {\n  action: 'approve' | 'reject';\n  reason?: string;\n}): Record<string, unknown> {\n  return reason ? { action, reason } : { action };\n}\n\nexport function isWaitForMinutesInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.WAIT_FOR_MINUTES);\n}\n\n/** The wait `wait_for_minutes` announced (`misc_tools.py`). */\nexport interface WaitForMinutesContext {\n  readonly minutes: number;\n  readonly reason: string | null;\n  /** The whole wait in seconds, when the raiser stamped it on the context. */\n  readonly timeoutSeconds: number | null;\n}\n\n/**\n * Each field on its own: the raiser sends `reason: null` for a wait without\n * one, which must not lose the minutes.\n */\nexport function readWaitForMinutesContext(payload: TypedInterruptPayload): WaitForMinutesContext {\n  const { minutes, reason, timeout_seconds: timeoutSeconds } = payload.context;\n  return {\n    minutes: isFiniteNumber(minutes) ? minutes : 0,\n    reason: isString(reason) && reason ? reason : null,\n    timeoutSeconds: isFiniteNumber(timeoutSeconds) ? timeoutSeconds : null,\n  };\n}\n\nexport function isRequestFileInterrupt(payload: TypedInterruptPayload): boolean {\n  return isCustomWithSource(payload, TypedInterruptSource.REQUEST_FILE);\n}\n\n/** What `request_file_from_user` asks for (`misc_tools.py`). */\nexport interface RequestFileContext {\n  readonly prompt: string;\n  readonly allowMultiple: boolean;\n}\n\nexport function readRequestFileContext(payload: TypedInterruptPayload): RequestFileContext {\n  const { prompt, allow_multiple: allowMultiple } = payload.context;\n  return {\n    prompt: (isString(prompt) && prompt) || payload.message || 'Upload a file to continue.',\n    allowMultiple: allowMultiple === true,\n  };\n}\n\n/** One uploaded file of `request_file_from_user`'s resume (`RequestedFile`). */\nexport interface RequestedFile {\n  readonly asset_id: string;\n  readonly filename: string;\n  /** The `[@title](link)` mention the agent can quote. */\n  readonly mention: string | null;\n}\n\n/** The file request's resume (`RequestFileResume`). */\nexport function requestFileResume(files: readonly RequestedFile[]): Record<string, unknown> {\n  return {\n    files: files.map(({ asset_id, filename, mention }) => ({ asset_id, filename, mention })),\n  };\n}\n\n/** The gated call of a tool-raised HITL approval (`raise_hitl_interrupt`). */\nexport interface TypedHitlContext {\n  readonly toolId: string | null;\n  readonly toolCallId: string | null;\n  readonly toolArgs: Readonly<Record<string, unknown>>;\n  /** What the backend resolved about the call before asking (`approval_context`). */\n  readonly approvalContext: unknown;\n}\n\nexport function readTypedHitlContext(payload: TypedInterruptPayload): TypedHitlContext {\n  const { context } = payload;\n  return {\n    toolId: optionalText(context.tool_id),\n    toolCallId: optionalText(context.tool_call_id),\n    toolArgs: isRecord(context.tool_args) ? context.tool_args : {},\n    approvalContext: context.approval_context,\n  };\n}\n"],"names":["TypedInterruptSource","TypedInterruptType"],"mappings":"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"}