@athenaintel/react 0.18.0 → 0.20.0

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

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

package/dist/packages/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 (windowed hello negotiation + history commands)\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  \"async_subagents\",\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_asset_id\",\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  \"permissions\",\n  \"project_id\",\n  \"recursion_limit\",\n  \"run_label\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\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  \"dry_run\",\n  \"enabled_toolkits\",\n  \"frontend_available\",\n  \"github_identity\",\n  \"max_tokens\",\n  \"middleware\",\n  \"model\",\n  \"muses_enabled\",\n  \"muses_recall_enabled\",\n  \"office_context\",\n  \"panel_config\",\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  \"async_subagents\",\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  \"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  \"environment\",\n  \"environment_asset_id\",\n  \"environment_id\",\n  \"environment_name\",\n  \"excluded_middleware\",\n  \"excluded_tools\",\n  \"extra_middleware\",\n  \"frontend_available\",\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  \"panel_config\",\n  \"permissions\",\n  \"project_id\",\n  \"recursion_limit\",\n  \"run_label\",\n  \"runtime\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\n  \"session_id\",\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  \"dry_run\",\n  \"frontend_available\",\n  \"github_identity\",\n  \"muses_enabled\",\n  \"muses_recall_enabled\",\n  \"office_context\",\n  \"project_id\",\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  \"async_subagents\",\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_asset_id\",\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  \"permissions\",\n  \"recursion_limit\",\n  \"run_label\",\n  \"sandbox_runtime\",\n  \"secret_asset_ids\",\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  \"api\",\n  \"chrome_extension\",\n  \"cli\",\n  \"comment_agent\",\n  \"default_voice\",\n  \"email\",\n  \"mobile_app\",\n  \"office_addin\",\n  \"orchestration\",\n  \"programmatic\",\n  \"slack\",\n  \"sms\",\n  \"task\",\n  \"teams\",\n  \"voice\",\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/** `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 and compared against the server's\n * advertised `minClientVersion` (the `protocol` state lane).\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/** Replicated-state key of the server-advertised version lane. */\nexport const DEEP_AGENT_PROTOCOL_STATE_KEY = \"protocol\";\n\n/**\n * Attach header opting into a windowed hello: its value is the window\n * size the client wants (the host clamps it). Undeclared clients keep\n * receiving the full snapshot.\n */\nexport const DEEP_AGENT_MESSAGE_WINDOW_HEADER = \"x-athena-deep-agent-window\";\n\n/** Attach header opting a windowed client back into the provenance blobs. */\nexport const DEEP_AGENT_PROVENANCE_HEADER = \"x-athena-deep-agent-provenance\";\n\n/** The `DEEP_AGENT_PROVENANCE_HEADER` value that keeps full provenance. */\nexport const DEEP_AGENT_PROVENANCE_FULL = \"full\";\n\n/** Window size a declaring client asks for by default. */\nexport const DEEP_AGENT_DEFAULT_MESSAGE_WINDOW = 40;\n\n/** Host clamp bounds on a declared window size. */\nexport const DEEP_AGENT_MIN_MESSAGE_WINDOW = 8;\n\nexport const DEEP_AGENT_MAX_MESSAGE_WINDOW = 200;\n\n/** Upper bound on the `limit` of one `history/load`. */\nexport const DEEP_AGENT_HISTORY_LOAD_MAX_LIMIT = 200;\n\n/** Replicated-state key of the window lane a windowed hello carries. */\nexport const DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY = \"messagesWindow\";\n\n/** Command loading older messages into a windowed client's view. */\nexport const DEEP_AGENT_HISTORY_LOAD_COMMAND = \"history/load\";\n\n/** Command returning a truncated tool output whole. */\nexport const DEEP_AGENT_HISTORY_TOOL_OUTPUT_COMMAND = \"history/tool_output\";\n\n/** Wire key marking a tool message whose content was truncated. */\nexport const DEEP_AGENT_TRUNCATED_CONTENT_KEY = \"athena_content_truncated\";\n"],"names":[],"mappings":"AAyGO,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;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;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;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;AACF;AAK4D,IAAI;AAAA,EAC9D;AACF;AAMO,MAAM,+BAA+B;AAQrC,MAAM,oCAAoC;AAE1C,MAAM,kCAAkC;AAiBxC,MAAM,8BAA8B;AAGpC,MAAM,qCACX;AAGK,MAAM,gCAAgC;AAOtC,MAAM,mCAAmC;AAGzC,MAAM,+BAA+B;AAGrC,MAAM,6BAA6B;AAGnC,MAAM,oCAAoC;AAG1C,MAAM,gCAAgC;AAEtC,MAAM,gCAAgC;AAGtC,MAAM,oCAAoC;AAG1C,MAAM,uCAAuC;AAG7C,MAAM,kCAAkC;AAGxC,MAAM,yCAAyC;AAG/C,MAAM,mCAAmC;"}

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

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const clientTools = require("./client-tools.cjs");
+const statewireState = require("./statewire-state.cjs");
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPendingInterrupt(request) {
+  return request.type === "interrupt" && !("response" in request);
+}
+function isApprovalCardInterrupt(request) {
+  if (!isPendingInterrupt(request)) return false;
+  return !clientTools.hasClientToolInterruptSource(request.payload);
+}
+function asHitlApproval(value) {
+  if (!isRecord(value)) return null;
+  return value.type === "hitl" && value.source === "hitl_approval" && typeof value.message === "string" ? value : null;
+}
+const DEFAULT_INTERRUPT_PAUSED_MESSAGE = "The agent is paused and waiting for input.";
+function readInterruptMessage(value, fallback = DEFAULT_INTERRUPT_PAUSED_MESSAGE) {
+  if (isRecord(value) && typeof value.message === "string" && value.message.length > 0) {
+    return value.message;
+  }
+  return fallback;
+}
+function pendingActionRequests(hitl) {
+  const context = hitl == null ? void 0 : hitl.context;
+  if (!context) return [];
+  const requests = Array.isArray(context.action_requests) ? context.action_requests.filter(isRecord) : context.tool_name && context.tool_args ? [{ name: context.tool_name, args: context.tool_args }] : [];
+  return requests.map((request) => ({
+    name: typeof request.name === "string" ? request.name : "tool",
+    args: isRecord(request.args) ? request.args : {},
+    ...typeof request.tool_call_id === "string" && { toolCallId: request.tool_call_id },
+    ...typeof request.interrupt_id === "string" && { interruptId: request.interrupt_id }
+  }));
+}
+function readAbandonedInputRequests(state) {
+  const abandoned = statewireState.readDeepAgentStreamValues(state).abandonedInputRequests;
+  return Array.isArray(abandoned) ? abandoned : void 0;
+}
+function findAbandonedInterrupt(abandoned) {
+  return abandoned == null ? void 0 : abandoned.find(
+    (request) => isRecord(request) && request.type === "interrupt" && typeof request.id === "string"
+  );
+}
+const HITL_REJECT_REASON = "User rejected the action.";
+const HITL_PENDING_RESUME_GRACE_MS = 15e3;
+function hitlResumeApprove() {
+  return { action: "approve" };
+}
+function hitlResumeReject(reason = HITL_REJECT_REASON) {
+  return { action: "reject", reason };
+}
+function hitlResumeContinue() {
+  return { action: "continue" };
+}
+function useApprovalResumeLock(options) {
+  const { requestId, isRunning, sendResume, pendingResumeGraceMs } = options;
+  const [pending, setPending] = react.useState(false);
+  const prevRequestIdRef = react.useRef(requestId);
+  if (prevRequestIdRef.current !== requestId) {
+    prevRequestIdRef.current = requestId;
+    if (pending) setPending(false);
+  }
+  const sawResumeRunRef = react.useRef(false);
+  react.useEffect(() => {
+    if (!pending) {
+      sawResumeRunRef.current = false;
+      return;
+    }
+    if (isRunning) {
+      sawResumeRunRef.current = true;
+      return;
+    }
+    if (sawResumeRunRef.current) {
+      sawResumeRunRef.current = false;
+      setPending(false);
+    }
+  }, [pending, isRunning]);
+  react.useEffect(() => {
+    if (!pending || pendingResumeGraceMs === void 0) return;
+    const timer = setTimeout(() => {
+      if (!sawResumeRunRef.current) setPending(false);
+    }, pendingResumeGraceMs);
+    return () => clearTimeout(timer);
+  }, [pending, requestId, pendingResumeGraceMs]);
+  const sendResumeRef = react.useRef(sendResume);
+  sendResumeRef.current = sendResume;
+  const pendingRef = react.useRef(pending);
+  pendingRef.current = pending;
+  const resume = react.useCallback(
+    (value) => {
+      if (requestId === void 0 || pendingRef.current) return;
+      setPending(true);
+      pendingRef.current = true;
+      sendResumeRef.current(requestId, value);
+    },
+    [requestId]
+  );
+  return { pending, resume };
+}
+exports.DEFAULT_INTERRUPT_PAUSED_MESSAGE = DEFAULT_INTERRUPT_PAUSED_MESSAGE;
+exports.HITL_PENDING_RESUME_GRACE_MS = HITL_PENDING_RESUME_GRACE_MS;
+exports.HITL_REJECT_REASON = HITL_REJECT_REASON;
+exports.asHitlApproval = asHitlApproval;
+exports.findAbandonedInterrupt = findAbandonedInterrupt;
+exports.hitlResumeApprove = hitlResumeApprove;
+exports.hitlResumeContinue = hitlResumeContinue;
+exports.hitlResumeReject = hitlResumeReject;
+exports.isApprovalCardInterrupt = isApprovalCardInterrupt;
+exports.isPendingInterrupt = isPendingInterrupt;
+exports.pendingActionRequests = pendingActionRequests;
+exports.readAbandonedInputRequests = readAbandonedInputRequests;
+exports.readInterruptMessage = readInterruptMessage;
+exports.useApprovalResumeLock = useApprovalResumeLock;
+//# sourceMappingURL=interrupts.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interrupts.cjs","sources":["../../../../../agent-runtime/src/interrupts.ts"],"sourcesContent":["/**\n * Human-in-the-loop interrupt primitives shared by every statewire chat\n * surface (Olympus, the React SDK, the Office add-in, the Chrome extension,\n * mobile).\n *\n * The agora deep-agent runtime parks a gated run on an `interrupt` input\n * request whose payload carries the Athena `hitl_approval` shape\n * (`athena_deep_agent/hitl_bridge.py`). A surface answers it with\n * `{ type: 'run/input', requestId, response: { type: 'resume', value } }` —\n * the exact command the backend's resume path consumes. This module holds the\n * payload contract (narrowing, resume values) and the shared resume-lock state\n * machine; rendering stays with each surface.\n *\n * Deliberately parameterized rather than self-wiring: these helpers never call\n * `useStatewireRuns`/`useAuiState` themselves. Each surface reads its own\n * statewire hooks (which its tests already mock) and passes the values in, so\n * the shared semantics cannot drift while per-surface wiring stays testable.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { hasClientToolInterruptSource } from './client-tools';\nimport { readDeepAgentStreamValues } from './statewire-state';\n\n/** Human-in-the-loop approval payload the agora deep-agent runtime parks a run\n *  on (shaped by `athena_deep_agent/hitl_bridge.py`). */\nexport interface HitlApprovalPayload {\n  source: string;\n  type: string;\n  message: string;\n  /** Risk headline/facts/warnings, when the host includes them. */\n  approval_context?: unknown;\n  context?: {\n    tool_name?: string;\n    tool_id?: string;\n    tool_call_id?: string;\n    tool_args?: Record<string, unknown>;\n    pending_action_count?: number;\n    approval_context?: unknown;\n    /**\n     * Every pending gated call (name + args), in decision order. Absent on\n     * older backends — fall back to the single `tool_name`/`tool_args` pair.\n     * Per-dispatch payloads also carry each lane's `tool_call_id` (the lane\n     * card key) and `interrupt_id` (the lane resume key).\n     */\n    action_requests?: {\n      name?: string;\n      args?: Record<string, unknown>;\n      tool_call_id?: string;\n      interrupt_id?: string;\n    }[];\n    /**\n     * True when each dispatch parked on its own interrupt: decisions submit\n     * per lane via `lane_decisions` and each approved lane starts immediately,\n     * instead of the legacy batch where one resume must answer every lane.\n     */\n    per_dispatch?: boolean;\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** A pending `interrupt` input request; a present `response` key marks it answered. */\nexport function isPendingInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  return request.type === 'interrupt' && !('response' in request);\n}\n\n/**\n * A pending interrupt an approval card may answer. Client-tool parks are\n * excluded — the client-tool bridge owns those, and a generic Continue resume\n * would corrupt the parked tool call. The source check is deliberately loose\n * (any payload stamped with the client-tool source) so a skewed deploy can\n * never route one here.\n */\nexport function isApprovalCardInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  if (!isPendingInterrupt(request)) return false;\n  return !hasClientToolInterruptSource((request as { payload?: unknown }).payload);\n}\n\n/** Narrow an interrupt payload to the Athena HITL approval shape. */\nexport function asHitlApproval(value: unknown): HitlApprovalPayload | null {\n  if (!isRecord(value)) return null;\n  return value.type === 'hitl' &&\n    value.source === 'hitl_approval' &&\n    typeof value.message === 'string'\n    ? (value as unknown as HitlApprovalPayload)\n    : null;\n}\n\n/** Default paused-run copy when an interrupt payload carries no message. */\nexport const DEFAULT_INTERRUPT_PAUSED_MESSAGE =\n  'The agent is paused and waiting for input.';\n\n/** Best-effort human-readable message from any interrupt payload. */\nexport function readInterruptMessage(\n  value: unknown,\n  fallback: string = DEFAULT_INTERRUPT_PAUSED_MESSAGE,\n): string {\n  if (isRecord(value) && typeof value.message === 'string' && value.message.length > 0) {\n    return value.message;\n  }\n  return fallback;\n}\n\nexport interface PendingActionRequest {\n  name: string;\n  args: Record<string, unknown>;\n  /** The lane's `task` tool-call id (present on per-dispatch payloads). */\n  toolCallId?: string;\n  /** The lane's langgraph interrupt id — the `lane_decisions` resume key. */\n  interruptId?: string;\n}\n\n/**\n * Every gated call this approval covers, in decision order. One resume answers\n * ALL of them, so every entry must stay reviewable somewhere. Falls back to\n * the single first-call fields on older backends without `action_requests`.\n */\nexport function pendingActionRequests(hitl: HitlApprovalPayload | null): PendingActionRequest[] {\n  const context = hitl?.context;\n  if (!context) return [];\n  // The payload crosses the wire with only its top-level shape narrowed\n  // (`asHitlApproval`), so the nested collection must be validated before any\n  // array/property access: a malformed host value must degrade to \"no\n  // reviewable entries\", never crash the approval surface.\n  const requests: Record<string, unknown>[] = Array.isArray(context.action_requests)\n    ? context.action_requests.filter(isRecord)\n    : context.tool_name && context.tool_args\n      ? [{ name: context.tool_name, args: context.tool_args }]\n      : [];\n  return requests.map((request) => ({\n    name: typeof request.name === 'string' ? request.name : 'tool',\n    args: isRecord(request.args) ? request.args : {},\n    ...(typeof request.tool_call_id === 'string' && { toolCallId: request.tool_call_id }),\n    ...(typeof request.interrupt_id === 'string' && { interruptId: request.interrupt_id }),\n  }));\n}\n\n/** An interrupt a non-resume dispatch dropped, published by the host. */\nexport interface AbandonedInputRequest {\n  id: string;\n  type: string;\n}\n\n/**\n * `useStatewireState` selector body for the host-published abandoned input\n * requests. Reads through {@link readDeepAgentStreamValues} so the selector is\n * safe on the pre-attach (`undefined`) wire state, and returns the raw array\n * reference so the subscription stays shallow-stable — derive (`.find`) on the\n * result, never inside the selector.\n */\nexport function readAbandonedInputRequests(\n  state: unknown,\n): readonly AbandonedInputRequest[] | undefined {\n  const abandoned = readDeepAgentStreamValues(state).abandonedInputRequests;\n  // Wire value: anything non-array (including a malformed host publication)\n  // reads as \"none\" rather than crashing the consuming surface. Identity-\n  // preserving for the valid case, so it stays selector-safe.\n  return Array.isArray(abandoned)\n    ? (abandoned as readonly AbandonedInputRequest[])\n    : undefined;\n}\n\n/** The abandoned `interrupt` entry, if any — the \"approval was cancelled\" notice. */\nexport function findAbandonedInterrupt(\n  abandoned: readonly AbandonedInputRequest[] | undefined,\n): AbandonedInputRequest | undefined {\n  return abandoned?.find(\n    (request) => isRecord(request) && request.type === 'interrupt' && typeof request.id === 'string',\n  );\n}\n\n/** Canonical reason string carried by a user rejection. */\nexport const HITL_REJECT_REASON = 'User rejected the action.';\n\n/**\n * Default {@link UseApprovalResumeLockOptions.pendingResumeGraceMs} for every\n * approval surface: how long a clicked decision waits for its resume run to\n * start before the actions unlock again. Covers a `run/input` the host\n * rejected or a disconnected transport swallowed before any run began — the\n * one failure neither identity-change nor observed-run recovery can detect.\n */\nexport const HITL_PENDING_RESUME_GRACE_MS = 15_000;\n\n/** `run/input` resume value approving the gated call(s). */\nexport function hitlResumeApprove(): Record<string, string> {\n  return { action: 'approve' };\n}\n\n/** `run/input` resume value rejecting the gated call(s). */\nexport function hitlResumeReject(reason: string = HITL_REJECT_REASON): Record<string, string> {\n  return { action: 'reject', reason };\n}\n\n/** `run/input` resume value for a non-HITL park (generic Continue). */\nexport function hitlResumeContinue(): Record<string, string> {\n  return { action: 'continue' };\n}\n\nexport interface UseApprovalResumeLockOptions<TValue> {\n  /** The pending interrupt's request id (`undefined` when nothing is parked). */\n  requestId: string | undefined;\n  /** The surface's thread `isRunning` read (mockable per surface). */\n  isRunning: boolean;\n  /** Dispatch the `run/input` resume for `requestId` on the surface's transport. */\n  sendResume: (requestId: string, value: TValue) => void;\n  /**\n   * Re-enable the actions when no resume run started within this window —\n   * covers a `run/input` that was rejected or lost before any run began, so\n   * neither reset path below can fire. Omit to keep the pre-existing surface\n   * behavior of staying locked until a resume run is observed.\n   */\n  pendingResumeGraceMs?: number;\n}\n\nexport interface ApprovalResumeLock<TValue> {\n  /** True after a resume until the request identity changes (or recovery fires). */\n  pending: boolean;\n  /** Send the resume value, locking the actions. No-op while pending or unparked. */\n  resume: (value: TValue) => void;\n}\n\n/**\n * Optimistic action lock shared by every approval surface: disable the\n * decision buttons the moment one is clicked, until the request identity\n * changes (it clears after the resume, or a fresh interrupt arrives). This\n * closes the double-click → duplicate-resume window.\n *\n * Recovery paths, in order of specificity:\n * 1. Identity change — the resume landed (or a new interrupt replaced the\n *    request). Reset during render via React's \"previous value\" pattern.\n * 2. A resume run was observed starting and then settling with the request\n *    still pending (failed/cancelled resume) — clear the lock so the user can\n *    answer again.\n * 3. Optional grace window ({@link UseApprovalResumeLockOptions.pendingResumeGraceMs})\n *    for a `run/input` that never started a run at all.\n */\nexport function useApprovalResumeLock<TValue = Record<string, string>>(\n  options: UseApprovalResumeLockOptions<TValue>,\n): ApprovalResumeLock<TValue> {\n  const { requestId, isRunning, sendResume, pendingResumeGraceMs } = options;\n\n  const [pending, setPending] = useState(false);\n  const prevRequestIdRef = useRef(requestId);\n  if (prevRequestIdRef.current !== requestId) {\n    prevRequestIdRef.current = requestId;\n    if (pending) setPending(false);\n  }\n\n  // Track the resume run we kicked off (isRunning observed true→false while\n  // pending) and clear `pending` when it ends with the request unresolved.\n  const sawResumeRunRef = useRef(false);\n  useEffect(() => {\n    if (!pending) {\n      sawResumeRunRef.current = false;\n      return;\n    }\n    if (isRunning) {\n      sawResumeRunRef.current = true;\n      return;\n    }\n    if (sawResumeRunRef.current) {\n      sawResumeRunRef.current = false;\n      setPending(false);\n    }\n  }, [pending, isRunning]);\n\n  // Pre-start failure recovery: re-enable after the grace window when no\n  // resume run began; answering the still-parked request again is exactly\n  // what the user needs to be able to do.\n  useEffect(() => {\n    if (!pending || pendingResumeGraceMs === undefined) return;\n    const timer = setTimeout(() => {\n      if (!sawResumeRunRef.current) setPending(false);\n    }, pendingResumeGraceMs);\n    return () => clearTimeout(timer);\n  }, [pending, requestId, pendingResumeGraceMs]);\n\n  const sendResumeRef = useRef(sendResume);\n  sendResumeRef.current = sendResume;\n  const pendingRef = useRef(pending);\n  pendingRef.current = pending;\n\n  const resume = useCallback(\n    (value: TValue) => {\n      if (requestId === undefined || pendingRef.current) return;\n      setPending(true);\n      pendingRef.current = true;\n      sendResumeRef.current(requestId, value);\n    },\n    [requestId],\n  );\n\n  return { pending, resume };\n}\n"],"names":["hasClientToolInterruptSource","readDeepAgentStreamValues","useState","useRef","useEffect","useCallback"],"mappings":"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"}

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

@@ -0,0 +1,117 @@
+import { useState, useRef, useEffect, useCallback } from "react";
+import { hasClientToolInterruptSource } from "./client-tools.js";
+import { readDeepAgentStreamValues } from "./statewire-state.js";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPendingInterrupt(request) {
+  return request.type === "interrupt" && !("response" in request);
+}
+function isApprovalCardInterrupt(request) {
+  if (!isPendingInterrupt(request)) return false;
+  return !hasClientToolInterruptSource(request.payload);
+}
+function asHitlApproval(value) {
+  if (!isRecord(value)) return null;
+  return value.type === "hitl" && value.source === "hitl_approval" && typeof value.message === "string" ? value : null;
+}
+const DEFAULT_INTERRUPT_PAUSED_MESSAGE = "The agent is paused and waiting for input.";
+function readInterruptMessage(value, fallback = DEFAULT_INTERRUPT_PAUSED_MESSAGE) {
+  if (isRecord(value) && typeof value.message === "string" && value.message.length > 0) {
+    return value.message;
+  }
+  return fallback;
+}
+function pendingActionRequests(hitl) {
+  const context = hitl == null ? void 0 : hitl.context;
+  if (!context) return [];
+  const requests = Array.isArray(context.action_requests) ? context.action_requests.filter(isRecord) : context.tool_name && context.tool_args ? [{ name: context.tool_name, args: context.tool_args }] : [];
+  return requests.map((request) => ({
+    name: typeof request.name === "string" ? request.name : "tool",
+    args: isRecord(request.args) ? request.args : {},
+    ...typeof request.tool_call_id === "string" && { toolCallId: request.tool_call_id },
+    ...typeof request.interrupt_id === "string" && { interruptId: request.interrupt_id }
+  }));
+}
+function readAbandonedInputRequests(state) {
+  const abandoned = readDeepAgentStreamValues(state).abandonedInputRequests;
+  return Array.isArray(abandoned) ? abandoned : void 0;
+}
+function findAbandonedInterrupt(abandoned) {
+  return abandoned == null ? void 0 : abandoned.find(
+    (request) => isRecord(request) && request.type === "interrupt" && typeof request.id === "string"
+  );
+}
+const HITL_REJECT_REASON = "User rejected the action.";
+const HITL_PENDING_RESUME_GRACE_MS = 15e3;
+function hitlResumeApprove() {
+  return { action: "approve" };
+}
+function hitlResumeReject(reason = HITL_REJECT_REASON) {
+  return { action: "reject", reason };
+}
+function hitlResumeContinue() {
+  return { action: "continue" };
+}
+function useApprovalResumeLock(options) {
+  const { requestId, isRunning, sendResume, pendingResumeGraceMs } = options;
+  const [pending, setPending] = useState(false);
+  const prevRequestIdRef = useRef(requestId);
+  if (prevRequestIdRef.current !== requestId) {
+    prevRequestIdRef.current = requestId;
+    if (pending) setPending(false);
+  }
+  const sawResumeRunRef = useRef(false);
+  useEffect(() => {
+    if (!pending) {
+      sawResumeRunRef.current = false;
+      return;
+    }
+    if (isRunning) {
+      sawResumeRunRef.current = true;
+      return;
+    }
+    if (sawResumeRunRef.current) {
+      sawResumeRunRef.current = false;
+      setPending(false);
+    }
+  }, [pending, isRunning]);
+  useEffect(() => {
+    if (!pending || pendingResumeGraceMs === void 0) return;
+    const timer = setTimeout(() => {
+      if (!sawResumeRunRef.current) setPending(false);
+    }, pendingResumeGraceMs);
+    return () => clearTimeout(timer);
+  }, [pending, requestId, pendingResumeGraceMs]);
+  const sendResumeRef = useRef(sendResume);
+  sendResumeRef.current = sendResume;
+  const pendingRef = useRef(pending);
+  pendingRef.current = pending;
+  const resume = useCallback(
+    (value) => {
+      if (requestId === void 0 || pendingRef.current) return;
+      setPending(true);
+      pendingRef.current = true;
+      sendResumeRef.current(requestId, value);
+    },
+    [requestId]
+  );
+  return { pending, resume };
+}
+export {
+  DEFAULT_INTERRUPT_PAUSED_MESSAGE,
+  HITL_PENDING_RESUME_GRACE_MS,
+  HITL_REJECT_REASON,
+  asHitlApproval,
+  findAbandonedInterrupt,
+  hitlResumeApprove,
+  hitlResumeContinue,
+  hitlResumeReject,
+  isApprovalCardInterrupt,
+  isPendingInterrupt,
+  pendingActionRequests,
+  readAbandonedInputRequests,
+  readInterruptMessage,
+  useApprovalResumeLock
+};
+//# sourceMappingURL=interrupts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interrupts.js","sources":["../../../../../agent-runtime/src/interrupts.ts"],"sourcesContent":["/**\n * Human-in-the-loop interrupt primitives shared by every statewire chat\n * surface (Olympus, the React SDK, the Office add-in, the Chrome extension,\n * mobile).\n *\n * The agora deep-agent runtime parks a gated run on an `interrupt` input\n * request whose payload carries the Athena `hitl_approval` shape\n * (`athena_deep_agent/hitl_bridge.py`). A surface answers it with\n * `{ type: 'run/input', requestId, response: { type: 'resume', value } }` —\n * the exact command the backend's resume path consumes. This module holds the\n * payload contract (narrowing, resume values) and the shared resume-lock state\n * machine; rendering stays with each surface.\n *\n * Deliberately parameterized rather than self-wiring: these helpers never call\n * `useStatewireRuns`/`useAuiState` themselves. Each surface reads its own\n * statewire hooks (which its tests already mock) and passes the values in, so\n * the shared semantics cannot drift while per-surface wiring stays testable.\n */\n\nimport type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { hasClientToolInterruptSource } from './client-tools';\nimport { readDeepAgentStreamValues } from './statewire-state';\n\n/** Human-in-the-loop approval payload the agora deep-agent runtime parks a run\n *  on (shaped by `athena_deep_agent/hitl_bridge.py`). */\nexport interface HitlApprovalPayload {\n  source: string;\n  type: string;\n  message: string;\n  /** Risk headline/facts/warnings, when the host includes them. */\n  approval_context?: unknown;\n  context?: {\n    tool_name?: string;\n    tool_id?: string;\n    tool_call_id?: string;\n    tool_args?: Record<string, unknown>;\n    pending_action_count?: number;\n    approval_context?: unknown;\n    /**\n     * Every pending gated call (name + args), in decision order. Absent on\n     * older backends — fall back to the single `tool_name`/`tool_args` pair.\n     * Per-dispatch payloads also carry each lane's `tool_call_id` (the lane\n     * card key) and `interrupt_id` (the lane resume key).\n     */\n    action_requests?: {\n      name?: string;\n      args?: Record<string, unknown>;\n      tool_call_id?: string;\n      interrupt_id?: string;\n    }[];\n    /**\n     * True when each dispatch parked on its own interrupt: decisions submit\n     * per lane via `lane_decisions` and each approved lane starts immediately,\n     * instead of the legacy batch where one resume must answer every lane.\n     */\n    per_dispatch?: boolean;\n  };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** A pending `interrupt` input request; a present `response` key marks it answered. */\nexport function isPendingInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  return request.type === 'interrupt' && !('response' in request);\n}\n\n/**\n * A pending interrupt an approval card may answer. Client-tool parks are\n * excluded — the client-tool bridge owns those, and a generic Continue resume\n * would corrupt the parked tool call. The source check is deliberately loose\n * (any payload stamped with the client-tool source) so a skewed deploy can\n * never route one here.\n */\nexport function isApprovalCardInterrupt(\n  request: StatewireThread.InputRequestState,\n): request is StatewireThread.CustomInputRequest {\n  if (!isPendingInterrupt(request)) return false;\n  return !hasClientToolInterruptSource((request as { payload?: unknown }).payload);\n}\n\n/** Narrow an interrupt payload to the Athena HITL approval shape. */\nexport function asHitlApproval(value: unknown): HitlApprovalPayload | null {\n  if (!isRecord(value)) return null;\n  return value.type === 'hitl' &&\n    value.source === 'hitl_approval' &&\n    typeof value.message === 'string'\n    ? (value as unknown as HitlApprovalPayload)\n    : null;\n}\n\n/** Default paused-run copy when an interrupt payload carries no message. */\nexport const DEFAULT_INTERRUPT_PAUSED_MESSAGE =\n  'The agent is paused and waiting for input.';\n\n/** Best-effort human-readable message from any interrupt payload. */\nexport function readInterruptMessage(\n  value: unknown,\n  fallback: string = DEFAULT_INTERRUPT_PAUSED_MESSAGE,\n): string {\n  if (isRecord(value) && typeof value.message === 'string' && value.message.length > 0) {\n    return value.message;\n  }\n  return fallback;\n}\n\nexport interface PendingActionRequest {\n  name: string;\n  args: Record<string, unknown>;\n  /** The lane's `task` tool-call id (present on per-dispatch payloads). */\n  toolCallId?: string;\n  /** The lane's langgraph interrupt id — the `lane_decisions` resume key. */\n  interruptId?: string;\n}\n\n/**\n * Every gated call this approval covers, in decision order. One resume answers\n * ALL of them, so every entry must stay reviewable somewhere. Falls back to\n * the single first-call fields on older backends without `action_requests`.\n */\nexport function pendingActionRequests(hitl: HitlApprovalPayload | null): PendingActionRequest[] {\n  const context = hitl?.context;\n  if (!context) return [];\n  // The payload crosses the wire with only its top-level shape narrowed\n  // (`asHitlApproval`), so the nested collection must be validated before any\n  // array/property access: a malformed host value must degrade to \"no\n  // reviewable entries\", never crash the approval surface.\n  const requests: Record<string, unknown>[] = Array.isArray(context.action_requests)\n    ? context.action_requests.filter(isRecord)\n    : context.tool_name && context.tool_args\n      ? [{ name: context.tool_name, args: context.tool_args }]\n      : [];\n  return requests.map((request) => ({\n    name: typeof request.name === 'string' ? request.name : 'tool',\n    args: isRecord(request.args) ? request.args : {},\n    ...(typeof request.tool_call_id === 'string' && { toolCallId: request.tool_call_id }),\n    ...(typeof request.interrupt_id === 'string' && { interruptId: request.interrupt_id }),\n  }));\n}\n\n/** An interrupt a non-resume dispatch dropped, published by the host. */\nexport interface AbandonedInputRequest {\n  id: string;\n  type: string;\n}\n\n/**\n * `useStatewireState` selector body for the host-published abandoned input\n * requests. Reads through {@link readDeepAgentStreamValues} so the selector is\n * safe on the pre-attach (`undefined`) wire state, and returns the raw array\n * reference so the subscription stays shallow-stable — derive (`.find`) on the\n * result, never inside the selector.\n */\nexport function readAbandonedInputRequests(\n  state: unknown,\n): readonly AbandonedInputRequest[] | undefined {\n  const abandoned = readDeepAgentStreamValues(state).abandonedInputRequests;\n  // Wire value: anything non-array (including a malformed host publication)\n  // reads as \"none\" rather than crashing the consuming surface. Identity-\n  // preserving for the valid case, so it stays selector-safe.\n  return Array.isArray(abandoned)\n    ? (abandoned as readonly AbandonedInputRequest[])\n    : undefined;\n}\n\n/** The abandoned `interrupt` entry, if any — the \"approval was cancelled\" notice. */\nexport function findAbandonedInterrupt(\n  abandoned: readonly AbandonedInputRequest[] | undefined,\n): AbandonedInputRequest | undefined {\n  return abandoned?.find(\n    (request) => isRecord(request) && request.type === 'interrupt' && typeof request.id === 'string',\n  );\n}\n\n/** Canonical reason string carried by a user rejection. */\nexport const HITL_REJECT_REASON = 'User rejected the action.';\n\n/**\n * Default {@link UseApprovalResumeLockOptions.pendingResumeGraceMs} for every\n * approval surface: how long a clicked decision waits for its resume run to\n * start before the actions unlock again. Covers a `run/input` the host\n * rejected or a disconnected transport swallowed before any run began — the\n * one failure neither identity-change nor observed-run recovery can detect.\n */\nexport const HITL_PENDING_RESUME_GRACE_MS = 15_000;\n\n/** `run/input` resume value approving the gated call(s). */\nexport function hitlResumeApprove(): Record<string, string> {\n  return { action: 'approve' };\n}\n\n/** `run/input` resume value rejecting the gated call(s). */\nexport function hitlResumeReject(reason: string = HITL_REJECT_REASON): Record<string, string> {\n  return { action: 'reject', reason };\n}\n\n/** `run/input` resume value for a non-HITL park (generic Continue). */\nexport function hitlResumeContinue(): Record<string, string> {\n  return { action: 'continue' };\n}\n\nexport interface UseApprovalResumeLockOptions<TValue> {\n  /** The pending interrupt's request id (`undefined` when nothing is parked). */\n  requestId: string | undefined;\n  /** The surface's thread `isRunning` read (mockable per surface). */\n  isRunning: boolean;\n  /** Dispatch the `run/input` resume for `requestId` on the surface's transport. */\n  sendResume: (requestId: string, value: TValue) => void;\n  /**\n   * Re-enable the actions when no resume run started within this window —\n   * covers a `run/input` that was rejected or lost before any run began, so\n   * neither reset path below can fire. Omit to keep the pre-existing surface\n   * behavior of staying locked until a resume run is observed.\n   */\n  pendingResumeGraceMs?: number;\n}\n\nexport interface ApprovalResumeLock<TValue> {\n  /** True after a resume until the request identity changes (or recovery fires). */\n  pending: boolean;\n  /** Send the resume value, locking the actions. No-op while pending or unparked. */\n  resume: (value: TValue) => void;\n}\n\n/**\n * Optimistic action lock shared by every approval surface: disable the\n * decision buttons the moment one is clicked, until the request identity\n * changes (it clears after the resume, or a fresh interrupt arrives). This\n * closes the double-click → duplicate-resume window.\n *\n * Recovery paths, in order of specificity:\n * 1. Identity change — the resume landed (or a new interrupt replaced the\n *    request). Reset during render via React's \"previous value\" pattern.\n * 2. A resume run was observed starting and then settling with the request\n *    still pending (failed/cancelled resume) — clear the lock so the user can\n *    answer again.\n * 3. Optional grace window ({@link UseApprovalResumeLockOptions.pendingResumeGraceMs})\n *    for a `run/input` that never started a run at all.\n */\nexport function useApprovalResumeLock<TValue = Record<string, string>>(\n  options: UseApprovalResumeLockOptions<TValue>,\n): ApprovalResumeLock<TValue> {\n  const { requestId, isRunning, sendResume, pendingResumeGraceMs } = options;\n\n  const [pending, setPending] = useState(false);\n  const prevRequestIdRef = useRef(requestId);\n  if (prevRequestIdRef.current !== requestId) {\n    prevRequestIdRef.current = requestId;\n    if (pending) setPending(false);\n  }\n\n  // Track the resume run we kicked off (isRunning observed true→false while\n  // pending) and clear `pending` when it ends with the request unresolved.\n  const sawResumeRunRef = useRef(false);\n  useEffect(() => {\n    if (!pending) {\n      sawResumeRunRef.current = false;\n      return;\n    }\n    if (isRunning) {\n      sawResumeRunRef.current = true;\n      return;\n    }\n    if (sawResumeRunRef.current) {\n      sawResumeRunRef.current = false;\n      setPending(false);\n    }\n  }, [pending, isRunning]);\n\n  // Pre-start failure recovery: re-enable after the grace window when no\n  // resume run began; answering the still-parked request again is exactly\n  // what the user needs to be able to do.\n  useEffect(() => {\n    if (!pending || pendingResumeGraceMs === undefined) return;\n    const timer = setTimeout(() => {\n      if (!sawResumeRunRef.current) setPending(false);\n    }, pendingResumeGraceMs);\n    return () => clearTimeout(timer);\n  }, [pending, requestId, pendingResumeGraceMs]);\n\n  const sendResumeRef = useRef(sendResume);\n  sendResumeRef.current = sendResume;\n  const pendingRef = useRef(pending);\n  pendingRef.current = pending;\n\n  const resume = useCallback(\n    (value: TValue) => {\n      if (requestId === undefined || pendingRef.current) return;\n      setPending(true);\n      pendingRef.current = true;\n      sendResumeRef.current(requestId, value);\n    },\n    [requestId],\n  );\n\n  return { pending, resume };\n}\n"],"names":[],"mappings":"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"}

package/dist/packages/agent-runtime/src/message-author.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const ATHENA_MESSAGE_AUTHOR_KEY = "author";
+const optionalString = (value) => typeof value === "string" && value.length > 0 ? value : null;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function readMessageAuthor(value) {
+  if (!isRecord(value)) return null;
+  const userId = value.user_id;
+  if (typeof userId !== "string" || userId.length === 0) return null;
+  return {
+    user_id: userId,
+    name: optionalString(value.name),
+    email: optionalString(value.email),
+    avatar_url: optionalString(value.avatar_url)
+  };
+}
+function isSameMessageAuthor(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  return a.user_id === b.user_id && a.name === b.name && a.email === b.email && a.avatar_url === b.avatar_url;
+}
+function laneEntryAuthor(entry, selfAuthor) {
+  if (entry.meta === void 0) return selfAuthor ?? null;
+  if (!isRecord(entry.meta)) return null;
+  return readMessageAuthor(entry.meta[ATHENA_MESSAGE_AUTHOR_KEY]);
+}
+exports.ATHENA_MESSAGE_AUTHOR_KEY = ATHENA_MESSAGE_AUTHOR_KEY;
+exports.isSameMessageAuthor = isSameMessageAuthor;
+exports.laneEntryAuthor = laneEntryAuthor;
+exports.readMessageAuthor = readMessageAuthor;
+//# sourceMappingURL=message-author.cjs.map

package/dist/packages/agent-runtime/src/message-author.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-author.cjs","sources":["../../../../../agent-runtime/src/message-author.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\n\n/**\n * `metadata.custom` key carrying who sent a human turn.\n *\n * The backend stamps it on every persisted human turn from the authenticated\n * sender (`agora/.../message_author.py`), and on the host `meta` of every\n * run-lane entry it admits (`statewire_host._op_meta`), so a queued or\n * just-sent bubble is attributable before the turn is materialised — on every\n * client on the thread, not only the sender's.\n */\nexport const ATHENA_MESSAGE_AUTHOR_KEY = 'author';\n\n/** Identity of the human who sent a message, as the backend stamps it. */\nexport interface DeepAgentMessageAuthor {\n  user_id: string;\n  name: string | null;\n  email: string | null;\n  avatar_url: string | null;\n}\n\nconst optionalString = (value: unknown): string | null =>\n  typeof value === 'string' && value.length > 0 ? value : null;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/**\n * Parse an author envelope off a wire value.\n *\n * Tolerates absent optional fields (a principal without a name or picture);\n * an envelope without a string `user_id` is no author at all — an\n * identity-less stamp would only mislead the gate that decides whether a\n * transcript has several human participants.\n */\nexport function readMessageAuthor(value: unknown): DeepAgentMessageAuthor | null {\n  if (!isRecord(value)) return null;\n  const userId = value.user_id;\n  if (typeof userId !== 'string' || userId.length === 0) return null;\n  return {\n    user_id: userId,\n    name: optionalString(value.name),\n    email: optionalString(value.email),\n    avatar_url: optionalString(value.avatar_url),\n  };\n}\n\n/** Field-wise equality, so hosts can hold a stable identity across renders. */\nexport function isSameMessageAuthor(\n  a: DeepAgentMessageAuthor | null,\n  b: DeepAgentMessageAuthor | null\n): boolean {\n  if (a === b) return true;\n  if (a === null || b === null) return false;\n  return (\n    a.user_id === b.user_id &&\n    a.name === b.name &&\n    a.email === b.email &&\n    a.avatar_url === b.avatar_url\n  );\n}\n\n/**\n * Who sent a run-lane entry, for its optimistic bubble.\n *\n * Only two sources are trusted. The host stamps `meta` on every entry it\n * admits, so `meta.author` is the server's word on the submitter and is what\n * every OTHER client on the thread renders. An entry with no `meta` at all is\n * this client's own optimistic fold — the send is still in flight — so it is\n * the viewer's (`selfAuthor`), matching what the host stamps on\n * acknowledgment. The entry's client-supplied `metadata` is never consulted:\n * a client that could set it could attribute its words to another\n * collaborator. A host-stamped entry without an author (a host predating the\n * stamp) yields none, so the surface falls back to its own attribution rule.\n */\nexport function laneEntryAuthor(\n  entry: StatewireThread.RunsQueueEntry,\n  selfAuthor: DeepAgentMessageAuthor | null | undefined\n): DeepAgentMessageAuthor | null {\n  if (entry.meta === undefined) return selfAuthor ?? null;\n  if (!isRecord(entry.meta)) return null;\n  return readMessageAuthor(entry.meta[ATHENA_MESSAGE_AUTHOR_KEY]);\n}\n"],"names":[],"mappings":";;AAWO,MAAM,4BAA4B;AAUzC,MAAM,iBAAiB,CAAC,UACtB,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;AAE1D,MAAM,WAAW,CAAC,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAU9D,SAAS,kBAAkB,OAA+C;AAC/E,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO;AAC7B,QAAM,SAAS,MAAM;AACrB,MAAI,OAAO,WAAW,YAAY,OAAO,WAAW,EAAG,QAAO;AAC9D,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM,eAAe,MAAM,IAAI;AAAA,IAC/B,OAAO,eAAe,MAAM,KAAK;AAAA,IACjC,YAAY,eAAe,MAAM,UAAU;AAAA,EAAA;AAE/C;AAGO,SAAS,oBACd,GACA,GACS;AACT,MAAI,MAAM,EAAG,QAAO;AACpB,MAAI,MAAM,QAAQ,MAAM,KAAM,QAAO;AACrC,SACE,EAAE,YAAY,EAAE,WAChB,EAAE,SAAS,EAAE,QACb,EAAE,UAAU,EAAE,SACd,EAAE,eAAe,EAAE;AAEvB;AAeO,SAAS,gBACd,OACA,YAC+B;AAC/B,MAAI,MAAM,SAAS,OAAW,QAAO,cAAc;AACnD,MAAI,CAAC,SAAS,MAAM,IAAI,EAAG,QAAO;AAClC,SAAO,kBAAkB,MAAM,KAAK,yBAAyB,CAAC;AAChE;;;;;"}

package/dist/packages/agent-runtime/src/message-author.js

@@ -0,0 +1,31 @@
+const ATHENA_MESSAGE_AUTHOR_KEY = "author";
+const optionalString = (value) => typeof value === "string" && value.length > 0 ? value : null;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function readMessageAuthor(value) {
+  if (!isRecord(value)) return null;
+  const userId = value.user_id;
+  if (typeof userId !== "string" || userId.length === 0) return null;
+  return {
+    user_id: userId,
+    name: optionalString(value.name),
+    email: optionalString(value.email),
+    avatar_url: optionalString(value.avatar_url)
+  };
+}
+function isSameMessageAuthor(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return false;
+  return a.user_id === b.user_id && a.name === b.name && a.email === b.email && a.avatar_url === b.avatar_url;
+}
+function laneEntryAuthor(entry, selfAuthor) {
+  if (entry.meta === void 0) return selfAuthor ?? null;
+  if (!isRecord(entry.meta)) return null;
+  return readMessageAuthor(entry.meta[ATHENA_MESSAGE_AUTHOR_KEY]);
+}
+export {
+  ATHENA_MESSAGE_AUTHOR_KEY,
+  isSameMessageAuthor,
+  laneEntryAuthor,
+  readMessageAuthor
+};
+//# sourceMappingURL=message-author.js.map