@openhands/agent-canvas 1.9.0 → 1.11.0

package/dist/types/agent-server/core/base/base.d.ts

@@ -1,8 +1,9 @@
 import { CANVAS_UI_CLIENT_ACTION_KIND } from "#/constants/canvas-ui";
+import { LAUNCH_CHILD_CONVERSATION_ACTION_KIND } from "#/constants/child-conversation";
 type EventType = "MCPTool" | "Finish" | "Think" | "ExecuteBash" | "Terminal" | "FileEditor" | "StrReplaceEditor" | "TaskTracker" | "PlanningFileEditor" | "InvokeSkill" | "SwitchLLM";
 type ActionOnlyType = "BrowserNavigate" | "BrowserClick" | "BrowserType" | "BrowserGetState" | "BrowserGetContent" | "BrowserScroll" | "BrowserGoBack" | "BrowserListTabs" | "BrowserSwitchTab" | "BrowserCloseTab" | "CanvasUI";
 type ObservationOnlyType = "Browser";
-type ActionEventType = `${ActionOnlyType}Action` | `${EventType}Action` | "GlobAction" | "GrepAction" | "TaskAction" | typeof CANVAS_UI_CLIENT_ACTION_KIND;
+type ActionEventType = `${ActionOnlyType}Action` | `${EventType}Action` | "GlobAction" | "GrepAction" | "TaskAction" | typeof CANVAS_UI_CLIENT_ACTION_KIND | typeof LAUNCH_CHILD_CONVERSATION_ACTION_KIND;
 type ObservationEventType = `${ObservationOnlyType}Observation` | `${EventType}Observation` | "TerminalObservation" | "GlobObservation" | "GrepObservation" | "TaskObservation" | "CanvasUIObservation" | "ClientToolObservation";
 export interface ActionBase<T extends ActionEventType = ActionEventType> {
     kind: T;

package/dist/types/agent-server/type-guards.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs"),require("../../constants/canvas-ui.cjs");function e(e){return typeof e==`object`&&!!e&&`id`in e&&`timestamp`in e&&`source`in e&&typeof e.id==`string`&&e.id.length>0&&typeof e.timestamp==`string`&&e.timestamp.length>0&&typeof e.source==`string`&&(e.source===`agent`||e.source===`user`||e.source===`environment`||e.source===`hook`)}var t=e=>e.source===`environment`&&`action_id`in e&&`observation`in e&&e.observation!==null&&typeof e.observation==`object`&&`kind`in e.observation,n=e=>e.source===`agent`&&`tool_name`in e&&`tool_call_id`in e&&`error`in e&&typeof e.tool_name==`string`&&typeof e.tool_call_id==`string`&&typeof e.error==`string`,r=e=>`llm_message`in e&&typeof e.llm_message==`object`&&e.llm_message!==null&&`role`in e.llm_message&&`content`in e.llm_message,i=e=>r(e)&&e.llm_message.role===`user`,a=e=>e.source===`agent`&&`action`in e&&e.action!==null&&typeof e.action==`object`&&`kind`in e.action&&`tool_name`in e&&`tool_call_id`in e&&typeof e.tool_name==`string`&&typeof e.tool_call_id==`string`,o=e=>a(e)&&(e.action.kind===`ExecuteBashAction`||e.action.kind===`TerminalAction`),s=e=>t(e)&&(e.observation.kind===`ExecuteBashObservation`||e.observation.kind===`TerminalObservation`),c=e=>t(e)&&e.observation.kind===`PlanningFileEditorObservation`,l=e=>t(e)&&e.observation.kind===`BrowserObservation`,u=e=>t(e)&&e.observation.kind===`SwitchLLMObservation`,d=e=>a(e)&&e.action.kind===`BrowserNavigateAction`,f=e=>a(e)&&(e.tool_name===`canvas_ui`||e.tool_name===`canvas_ui_control`),p=e=>e.source===`agent`&&`system_prompt`in e&&`tools`in e&&typeof e.system_prompt==`object`&&Array.isArray(e.tools),m=e=>`kind`in e&&e.kind===`ConversationStateUpdateEvent`,h=e=>e.key===`full_state`,g=e=>e.key===`execution_status`,_=e=>e.key===`stats`,v=e=>e.key===`goal`,y=e=>`kind`in e&&e.kind===`ConversationErrorEvent`,b=e=>`kind`in e&&e.kind===`ServerErrorEvent`,x=e=>y(e)||b(e),S=e=>`kind`in e&&e.kind===`HookExecutionEvent`,C=e=>`kind`in e&&e.kind===`ACPToolCallEvent`,w=e=>`kind`in e&&e.kind===`StreamingDeltaEvent`;function T(t){return e(t)}exports.isACPToolCallEvent=C,exports.isActionEvent=a,exports.isAgentErrorEvent=n,exports.isAgentServerEvent=T,exports.isAgentStatusConversationStateUpdateEvent=g,exports.isBrowserNavigateActionEvent=d,exports.isBrowserObservationEvent=l,exports.isCanvasUIActionEvent=f,exports.isConversationStateUpdateEvent=m,exports.isDisplayableErrorEvent=x,exports.isExecuteBashActionEvent=o,exports.isExecuteBashObservationEvent=s,exports.isFullStateConversationStateUpdateEvent=h,exports.isGoalConversationStateUpdateEvent=v,exports.isHookExecutionEvent=S,exports.isMessageEvent=r,exports.isObservationEvent=t,exports.isPlanningFileEditorObservationEvent=c,exports.isStatsConversationStateUpdateEvent=_,exports.isStreamingDeltaEvent=w,exports.isSwitchLLMObservationEvent=u,exports.isSystemPromptEvent=p,exports.isUserMessageEvent=i;
+require("../../_virtual/_rolldown/runtime.cjs"),require("../../constants/canvas-ui.cjs"),require("../../constants/child-conversation.cjs");function e(e){return typeof e==`object`&&!!e&&`id`in e&&`timestamp`in e&&`source`in e&&typeof e.id==`string`&&e.id.length>0&&typeof e.timestamp==`string`&&e.timestamp.length>0&&typeof e.source==`string`&&(e.source===`agent`||e.source===`user`||e.source===`environment`||e.source===`hook`)}var t=e=>e.source===`environment`&&`action_id`in e&&`observation`in e&&e.observation!==null&&typeof e.observation==`object`&&`kind`in e.observation,n=e=>e.source===`agent`&&`tool_name`in e&&`tool_call_id`in e&&`error`in e&&typeof e.tool_name==`string`&&typeof e.tool_call_id==`string`&&typeof e.error==`string`,r=e=>`llm_message`in e&&typeof e.llm_message==`object`&&e.llm_message!==null&&`role`in e.llm_message&&`content`in e.llm_message,i=e=>r(e)&&e.llm_message.role===`user`,a=e=>e.source===`agent`&&`action`in e&&e.action!==null&&typeof e.action==`object`&&`kind`in e.action&&`tool_name`in e&&`tool_call_id`in e&&typeof e.tool_name==`string`&&typeof e.tool_call_id==`string`,o=e=>a(e)&&(e.action.kind===`ExecuteBashAction`||e.action.kind===`TerminalAction`),s=e=>t(e)&&(e.observation.kind===`ExecuteBashObservation`||e.observation.kind===`TerminalObservation`),c=e=>t(e)&&e.observation.kind===`PlanningFileEditorObservation`,l=e=>t(e)&&e.observation.kind===`BrowserObservation`,u=e=>t(e)&&e.observation.kind===`SwitchLLMObservation`,d=e=>a(e)&&e.action.kind===`BrowserNavigateAction`,f=e=>a(e)&&(e.tool_name===`canvas_ui`||e.tool_name===`canvas_ui_control`),p=e=>a(e)&&e.tool_name===`launch_child_conversation`,m=e=>e.source===`agent`&&`system_prompt`in e&&`tools`in e&&typeof e.system_prompt==`object`&&Array.isArray(e.tools),h=e=>`kind`in e&&e.kind===`ConversationStateUpdateEvent`,g=e=>e.key===`full_state`,_=e=>e.key===`execution_status`,v=e=>e.key===`stats`,y=e=>e.key===`goal`,b=e=>`kind`in e&&e.kind===`ConversationErrorEvent`,x=e=>`kind`in e&&e.kind===`ServerErrorEvent`,S=e=>b(e)||x(e),C=e=>`kind`in e&&e.kind===`HookExecutionEvent`,w=e=>`kind`in e&&e.kind===`ACPToolCallEvent`,T=e=>`kind`in e&&e.kind===`StreamingDeltaEvent`;function E(t){return e(t)}exports.isACPToolCallEvent=w,exports.isActionEvent=a,exports.isAgentErrorEvent=n,exports.isAgentServerEvent=E,exports.isAgentStatusConversationStateUpdateEvent=_,exports.isBrowserNavigateActionEvent=d,exports.isBrowserObservationEvent=l,exports.isCanvasUIActionEvent=f,exports.isConversationStateUpdateEvent=h,exports.isDisplayableErrorEvent=S,exports.isExecuteBashActionEvent=o,exports.isExecuteBashObservationEvent=s,exports.isFullStateConversationStateUpdateEvent=g,exports.isGoalConversationStateUpdateEvent=y,exports.isHookExecutionEvent=C,exports.isLaunchChildConversationActionEvent=p,exports.isMessageEvent=r,exports.isObservationEvent=t,exports.isPlanningFileEditorObservationEvent=c,exports.isStatsConversationStateUpdateEvent=v,exports.isStreamingDeltaEvent=T,exports.isSwitchLLMObservationEvent=u,exports.isSystemPromptEvent=m,exports.isUserMessageEvent=i;
 //# sourceMappingURL=type-guards.cjs.map

package/dist/types/agent-server/type-guards.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.cjs","names":[],"sources":["../../../src/types/agent-server/type-guards.ts"],"sourcesContent":["import {\n  CANVAS_UI_CLIENT_TOOL_NAME,\n  LEGACY_CANVAS_UI_TOOL_NAME,\n} from \"#/constants/canvas-ui\";\n\nimport {\n  OpenHandsEvent,\n  ObservationEvent,\n  BaseEvent,\n  ExecuteBashAction,\n  TerminalAction,\n  ExecuteBashObservation,\n  PlanningFileEditorObservation,\n  TerminalObservation,\n  BrowserObservation,\n  BrowserNavigateAction,\n  SwitchLLMObservation,\n  CanvasUIAction,\n} from \"./core\";\nimport { AgentErrorEvent } from \"./core/events/observation-event\";\nimport { MessageEvent } from \"./core/events/message-event\";\nimport { ActionEvent } from \"./core/events/action-event\";\nimport {\n  ConversationStateUpdateEvent,\n  ConversationStateUpdateEventAgentStatus,\n  ConversationStateUpdateEventFullState,\n  ConversationStateUpdateEventStats,\n  ConversationStateUpdateEventGoal,\n  ConversationErrorEvent,\n  ServerErrorEvent,\n} from \"./core/events/conversation-state-event\";\nimport { HookExecutionEvent } from \"./core/events/hook-execution-event\";\nimport { ACPToolCallEvent } from \"./core/events/acp-tool-call-event\";\nimport { StreamingDeltaEvent } from \"./core/events/streaming-delta-event\";\nimport { SystemPromptEvent } from \"./core/events/system-event\";\n\n/**\n * Type guard to check if an unknown value is a valid BaseEvent\n * @param value - The value to check\n * @returns true if the value is a valid BaseEvent\n */\nexport function isBaseEvent(value: unknown): value is BaseEvent {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"id\" in value &&\n    \"timestamp\" in value &&\n    \"source\" in value &&\n    typeof value.id === \"string\" &&\n    value.id.length > 0 &&\n    typeof value.timestamp === \"string\" &&\n    value.timestamp.length > 0 &&\n    typeof value.source === \"string\" &&\n    (value.source === \"agent\" ||\n      value.source === \"user\" ||\n      value.source === \"environment\" ||\n      value.source === \"hook\")\n  );\n}\n\n/**\n * Type guard function to check if an event is an observation event\n */\nexport const isObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent =>\n  event.source === \"environment\" &&\n  \"action_id\" in event &&\n  \"observation\" in event &&\n  event.observation !== null &&\n  typeof event.observation === \"object\" &&\n  \"kind\" in event.observation;\n\n/**\n * Type guard function to check if an event is an agent error event\n */\nexport const isAgentErrorEvent = (\n  event: OpenHandsEvent,\n): event is AgentErrorEvent =>\n  event.source === \"agent\" &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  \"error\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\" &&\n  typeof event.error === \"string\";\n\n/**\n * Type guard function to check if an event is a message event (user or assistant)\n */\nexport const isMessageEvent = (event: OpenHandsEvent): event is MessageEvent =>\n  \"llm_message\" in event &&\n  typeof event.llm_message === \"object\" &&\n  event.llm_message !== null &&\n  \"role\" in event.llm_message &&\n  \"content\" in event.llm_message;\n\n/**\n * Type guard function to check if an event is a user message event\n */\nexport const isUserMessageEvent = (\n  event: OpenHandsEvent,\n): event is MessageEvent =>\n  isMessageEvent(event) && event.llm_message.role === \"user\";\n\n/**\n * Type guard function to check if an event is an action event\n */\nexport const isActionEvent = (event: OpenHandsEvent): event is ActionEvent =>\n  event.source === \"agent\" &&\n  \"action\" in event &&\n  event.action !== null &&\n  typeof event.action === \"object\" &&\n  \"kind\" in event.action &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\";\n\n/**\n * Type guard function to check if an action event is an ExecuteBashAction\n */\nexport const isExecuteBashActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<ExecuteBashAction | TerminalAction> =>\n  isActionEvent(event) &&\n  (event.action.kind === \"ExecuteBashAction\" ||\n    event.action.kind === \"TerminalAction\");\n\n/**\n * Type guard function to check if an observation event contains terminal output\n */\nexport const isExecuteBashObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<ExecuteBashObservation | TerminalObservation> =>\n  isObservationEvent(event) &&\n  (event.observation.kind === \"ExecuteBashObservation\" ||\n    event.observation.kind === \"TerminalObservation\");\n\n/**\n * Type guard function to check if an observation event is a PlanningFileEditorObservation\n */\nexport const isPlanningFileEditorObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<PlanningFileEditorObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"PlanningFileEditorObservation\";\n\n/**\n * Type guard function to check if an observation event is a BrowserObservation\n */\nexport const isBrowserObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<BrowserObservation> =>\n  isObservationEvent(event) && event.observation.kind === \"BrowserObservation\";\n\n/**\n * Type guard function to check if an observation event is a SwitchLLMObservation\n */\nexport const isSwitchLLMObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<SwitchLLMObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"SwitchLLMObservation\";\n\n/**\n * Type guard function to check if an action event is a BrowserNavigateAction\n */\nexport const isBrowserNavigateActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<BrowserNavigateAction> =>\n  isActionEvent(event) && event.action.kind === \"BrowserNavigateAction\";\n\n/**\n * Type guard for Canvas UI tool ActionEvents.\n *\n * Discriminating on tool_name supports legacy CanvasUIAction events and the\n * SDK-generated action kind without leaking that generated name here.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) &&\n  (event.tool_name === LEGACY_CANVAS_UI_TOOL_NAME ||\n    event.tool_name === CANVAS_UI_CLIENT_TOOL_NAME);\n\n/**\n * Type guard function to check if an event is a system prompt event\n */\nexport const isSystemPromptEvent = (\n  event: OpenHandsEvent,\n): event is SystemPromptEvent =>\n  event.source === \"agent\" &&\n  \"system_prompt\" in event &&\n  \"tools\" in event &&\n  typeof event.system_prompt === \"object\" &&\n  Array.isArray(event.tools);\n\n/**\n * Type guard function to check if an event is a conversation state update event\n */\nexport const isConversationStateUpdateEvent = (\n  event: OpenHandsEvent,\n): event is ConversationStateUpdateEvent =>\n  \"kind\" in event && event.kind === \"ConversationStateUpdateEvent\";\n\nexport const isFullStateConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventFullState => event.key === \"full_state\";\n\nexport const isAgentStatusConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventAgentStatus =>\n  event.key === \"execution_status\";\n\nexport const isStatsConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventStats => event.key === \"stats\";\n\nexport const isGoalConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventGoal => event.key === \"goal\";\n\n/**\n * Type guard function to check if an event is a conversation error event\n */\nexport const isConversationErrorEvent = (\n  event: OpenHandsEvent,\n): event is ConversationErrorEvent =>\n  \"kind\" in event && event.kind === \"ConversationErrorEvent\";\n\n/**\n * Type guard function to check if an event is a server error event\n */\nexport const isServerErrorEvent = (\n  event: OpenHandsEvent,\n): event is ServerErrorEvent =>\n  \"kind\" in event && event.kind === \"ServerErrorEvent\";\n\n/**\n * Type guard function to check if an event is a displayable error event\n * (ConversationErrorEvent or ServerErrorEvent) - both should show as error banners\n */\nexport const isDisplayableErrorEvent = (event: OpenHandsEvent): boolean =>\n  isConversationErrorEvent(event) || isServerErrorEvent(event);\n\n/**\n * Type guard function to check if an event is a hook execution event\n */\nexport const isHookExecutionEvent = (\n  event: OpenHandsEvent,\n): event is HookExecutionEvent =>\n  \"kind\" in event && event.kind === \"HookExecutionEvent\";\n\n/**\n * Type guard function to check if an event is an ACP tool call event\n */\nexport const isACPToolCallEvent = (\n  event: OpenHandsEvent,\n): event is ACPToolCallEvent =>\n  \"kind\" in event && event.kind === \"ACPToolCallEvent\";\n\nexport const isStreamingDeltaEvent = (\n  event: OpenHandsEvent,\n): event is StreamingDeltaEvent =>\n  \"kind\" in event && event.kind === \"StreamingDeltaEvent\";\n\n// =============================================================================\n// COMPATIBILITY TYPE GUARDS\n// =============================================================================\n\n/**\n * Type guard to check if an event is an agent-server OpenHandsEvent.\n * Uses isBaseEvent to validate the complete event structure.\n */\nexport function isAgentServerEvent(event: unknown): event is OpenHandsEvent {\n  return isBaseEvent(event);\n}\n"],"mappings":"yFAyCA,SAAgB,EAAY,EAAoC,CAC9D,OAEE,OAAO,GAAU,YADjB,GAEA,OAAQ,GACR,cAAe,GACf,WAAY,GACZ,OAAO,EAAM,IAAO,UACpB,EAAM,GAAG,OAAS,GAClB,OAAO,EAAM,WAAc,UAC3B,EAAM,UAAU,OAAS,GACzB,OAAO,EAAM,QAAW,WACvB,EAAM,SAAW,SAChB,EAAM,SAAW,QACjB,EAAM,SAAW,eACjB,EAAM,SAAW,OAEvB,CAKA,IAAa,EACX,GAEA,EAAM,SAAW,eACjB,cAAe,GACf,gBAAiB,GACjB,EAAM,cAAgB,MACtB,OAAO,EAAM,aAAgB,UAC7B,SAAU,EAAM,YAKL,EACX,GAEA,EAAM,SAAW,SACjB,cAAe,GACf,iBAAkB,GAClB,UAAW,GACX,OAAO,EAAM,WAAc,UAC3B,OAAO,EAAM,cAAiB,UAC9B,OAAO,EAAM,OAAU,SAKZ,EAAkB,GAC7B,gBAAiB,GACjB,OAAO,EAAM,aAAgB,UAC7B,EAAM,cAAgB,MACtB,SAAU,EAAM,aAChB,YAAa,EAAM,YAKR,EACX,GAEA,EAAe,CAAK,GAAK,EAAM,YAAY,OAAS,OAKzC,EAAiB,GAC5B,EAAM,SAAW,SACjB,WAAY,GACZ,EAAM,SAAW,MACjB,OAAO,EAAM,QAAW,UACxB,SAAU,EAAM,QAChB,cAAe,GACf,iBAAkB,GAClB,OAAO,EAAM,WAAc,UAC3B,OAAO,EAAM,cAAiB,SAKnB,EACX,GAEA,EAAc,CAAK,IAClB,EAAM,OAAO,OAAS,qBACrB,EAAM,OAAO,OAAS,kBAKb,EACX,GAEA,EAAmB,CAAK,IACvB,EAAM,YAAY,OAAS,0BAC1B,EAAM,YAAY,OAAS,uBAKlB,EACX,GAEA,EAAmB,CAAK,GACxB,EAAM,YAAY,OAAS,gCAKhB,EACX,GAEA,EAAmB,CAAK,GAAK,EAAM,YAAY,OAAS,qBAK7C,EACX,GAEA,EAAmB,CAAK,GACxB,EAAM,YAAY,OAAS,uBAKhB,EACX,GAEA,EAAc,CAAK,GAAK,EAAM,OAAO,OAAS,wBAQnC,EACX,GAEA,EAAc,CAAK,IAClB,EAAM,YAAA,aACL,EAAM,YAAA,qBAKG,EACX,GAEA,EAAM,SAAW,SACjB,kBAAmB,GACnB,UAAW,GACX,OAAO,EAAM,eAAkB,UAC/B,MAAM,QAAQ,EAAM,KAAK,EAKd,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,+BAEvB,EACX,GACmD,EAAM,MAAQ,aAEtD,EACX,GAEA,EAAM,MAAQ,mBAEH,EACX,GAC+C,EAAM,MAAQ,QAElD,EACX,GAC8C,EAAM,MAAQ,OAKjD,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,yBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,mBAMvB,EAA2B,GACtC,EAAyB,CAAK,GAAK,EAAmB,CAAK,EAKhD,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,qBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,mBAEvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,sBAUpC,SAAgB,EAAmB,EAAyC,CAC1E,OAAO,EAAY,CAAK,CAC1B"}
+{"version":3,"file":"type-guards.cjs","names":[],"sources":["../../../src/types/agent-server/type-guards.ts"],"sourcesContent":["import {\n  CANVAS_UI_CLIENT_TOOL_NAME,\n  LEGACY_CANVAS_UI_TOOL_NAME,\n} from \"#/constants/canvas-ui\";\nimport { LAUNCH_CHILD_CONVERSATION_TOOL_NAME } from \"#/constants/child-conversation\";\n\nimport {\n  OpenHandsEvent,\n  ObservationEvent,\n  BaseEvent,\n  ExecuteBashAction,\n  TerminalAction,\n  ExecuteBashObservation,\n  PlanningFileEditorObservation,\n  TerminalObservation,\n  BrowserObservation,\n  BrowserNavigateAction,\n  SwitchLLMObservation,\n  CanvasUIAction,\n  LaunchChildConversationAction,\n} from \"./core\";\nimport { AgentErrorEvent } from \"./core/events/observation-event\";\nimport { MessageEvent } from \"./core/events/message-event\";\nimport { ActionEvent } from \"./core/events/action-event\";\nimport {\n  ConversationStateUpdateEvent,\n  ConversationStateUpdateEventAgentStatus,\n  ConversationStateUpdateEventFullState,\n  ConversationStateUpdateEventStats,\n  ConversationStateUpdateEventGoal,\n  ConversationErrorEvent,\n  ServerErrorEvent,\n} from \"./core/events/conversation-state-event\";\nimport { HookExecutionEvent } from \"./core/events/hook-execution-event\";\nimport { ACPToolCallEvent } from \"./core/events/acp-tool-call-event\";\nimport { StreamingDeltaEvent } from \"./core/events/streaming-delta-event\";\nimport { SystemPromptEvent } from \"./core/events/system-event\";\n\n/**\n * Type guard to check if an unknown value is a valid BaseEvent\n * @param value - The value to check\n * @returns true if the value is a valid BaseEvent\n */\nexport function isBaseEvent(value: unknown): value is BaseEvent {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"id\" in value &&\n    \"timestamp\" in value &&\n    \"source\" in value &&\n    typeof value.id === \"string\" &&\n    value.id.length > 0 &&\n    typeof value.timestamp === \"string\" &&\n    value.timestamp.length > 0 &&\n    typeof value.source === \"string\" &&\n    (value.source === \"agent\" ||\n      value.source === \"user\" ||\n      value.source === \"environment\" ||\n      value.source === \"hook\")\n  );\n}\n\n/**\n * Type guard function to check if an event is an observation event\n */\nexport const isObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent =>\n  event.source === \"environment\" &&\n  \"action_id\" in event &&\n  \"observation\" in event &&\n  event.observation !== null &&\n  typeof event.observation === \"object\" &&\n  \"kind\" in event.observation;\n\n/**\n * Type guard function to check if an event is an agent error event\n */\nexport const isAgentErrorEvent = (\n  event: OpenHandsEvent,\n): event is AgentErrorEvent =>\n  event.source === \"agent\" &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  \"error\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\" &&\n  typeof event.error === \"string\";\n\n/**\n * Type guard function to check if an event is a message event (user or assistant)\n */\nexport const isMessageEvent = (event: OpenHandsEvent): event is MessageEvent =>\n  \"llm_message\" in event &&\n  typeof event.llm_message === \"object\" &&\n  event.llm_message !== null &&\n  \"role\" in event.llm_message &&\n  \"content\" in event.llm_message;\n\n/**\n * Type guard function to check if an event is a user message event\n */\nexport const isUserMessageEvent = (\n  event: OpenHandsEvent,\n): event is MessageEvent =>\n  isMessageEvent(event) && event.llm_message.role === \"user\";\n\n/**\n * Type guard function to check if an event is an action event\n */\nexport const isActionEvent = (event: OpenHandsEvent): event is ActionEvent =>\n  event.source === \"agent\" &&\n  \"action\" in event &&\n  event.action !== null &&\n  typeof event.action === \"object\" &&\n  \"kind\" in event.action &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\";\n\n/**\n * Type guard function to check if an action event is an ExecuteBashAction\n */\nexport const isExecuteBashActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<ExecuteBashAction | TerminalAction> =>\n  isActionEvent(event) &&\n  (event.action.kind === \"ExecuteBashAction\" ||\n    event.action.kind === \"TerminalAction\");\n\n/**\n * Type guard function to check if an observation event contains terminal output\n */\nexport const isExecuteBashObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<ExecuteBashObservation | TerminalObservation> =>\n  isObservationEvent(event) &&\n  (event.observation.kind === \"ExecuteBashObservation\" ||\n    event.observation.kind === \"TerminalObservation\");\n\n/**\n * Type guard function to check if an observation event is a PlanningFileEditorObservation\n */\nexport const isPlanningFileEditorObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<PlanningFileEditorObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"PlanningFileEditorObservation\";\n\n/**\n * Type guard function to check if an observation event is a BrowserObservation\n */\nexport const isBrowserObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<BrowserObservation> =>\n  isObservationEvent(event) && event.observation.kind === \"BrowserObservation\";\n\n/**\n * Type guard function to check if an observation event is a SwitchLLMObservation\n */\nexport const isSwitchLLMObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<SwitchLLMObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"SwitchLLMObservation\";\n\n/**\n * Type guard function to check if an action event is a BrowserNavigateAction\n */\nexport const isBrowserNavigateActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<BrowserNavigateAction> =>\n  isActionEvent(event) && event.action.kind === \"BrowserNavigateAction\";\n\n/**\n * Type guard for Canvas UI tool ActionEvents.\n *\n * Discriminating on tool_name supports legacy CanvasUIAction events and the\n * SDK-generated action kind without leaking that generated name here.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) &&\n  (event.tool_name === LEGACY_CANVAS_UI_TOOL_NAME ||\n    event.tool_name === CANVAS_UI_CLIENT_TOOL_NAME);\n\n/**\n * Type guard for launch-child-conversation tool ActionEvents.\n *\n * Discriminates on tool_name, like `isCanvasUIActionEvent`, so the\n * SDK-generated action kind stays contained in the constants module.\n */\nexport const isLaunchChildConversationActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<LaunchChildConversationAction> =>\n  isActionEvent(event) &&\n  event.tool_name === LAUNCH_CHILD_CONVERSATION_TOOL_NAME;\n\n/**\n * Type guard function to check if an event is a system prompt event\n */\nexport const isSystemPromptEvent = (\n  event: OpenHandsEvent,\n): event is SystemPromptEvent =>\n  event.source === \"agent\" &&\n  \"system_prompt\" in event &&\n  \"tools\" in event &&\n  typeof event.system_prompt === \"object\" &&\n  Array.isArray(event.tools);\n\n/**\n * Type guard function to check if an event is a conversation state update event\n */\nexport const isConversationStateUpdateEvent = (\n  event: OpenHandsEvent,\n): event is ConversationStateUpdateEvent =>\n  \"kind\" in event && event.kind === \"ConversationStateUpdateEvent\";\n\nexport const isFullStateConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventFullState => event.key === \"full_state\";\n\nexport const isAgentStatusConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventAgentStatus =>\n  event.key === \"execution_status\";\n\nexport const isStatsConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventStats => event.key === \"stats\";\n\nexport const isGoalConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventGoal => event.key === \"goal\";\n\n/**\n * Type guard function to check if an event is a conversation error event\n */\nexport const isConversationErrorEvent = (\n  event: OpenHandsEvent,\n): event is ConversationErrorEvent =>\n  \"kind\" in event && event.kind === \"ConversationErrorEvent\";\n\n/**\n * Type guard function to check if an event is a server error event\n */\nexport const isServerErrorEvent = (\n  event: OpenHandsEvent,\n): event is ServerErrorEvent =>\n  \"kind\" in event && event.kind === \"ServerErrorEvent\";\n\n/**\n * Type guard function to check if an event is a displayable error event\n * (ConversationErrorEvent or ServerErrorEvent) - both should show as error banners\n */\nexport const isDisplayableErrorEvent = (event: OpenHandsEvent): boolean =>\n  isConversationErrorEvent(event) || isServerErrorEvent(event);\n\n/**\n * Type guard function to check if an event is a hook execution event\n */\nexport const isHookExecutionEvent = (\n  event: OpenHandsEvent,\n): event is HookExecutionEvent =>\n  \"kind\" in event && event.kind === \"HookExecutionEvent\";\n\n/**\n * Type guard function to check if an event is an ACP tool call event\n */\nexport const isACPToolCallEvent = (\n  event: OpenHandsEvent,\n): event is ACPToolCallEvent =>\n  \"kind\" in event && event.kind === \"ACPToolCallEvent\";\n\nexport const isStreamingDeltaEvent = (\n  event: OpenHandsEvent,\n): event is StreamingDeltaEvent =>\n  \"kind\" in event && event.kind === \"StreamingDeltaEvent\";\n\n// =============================================================================\n// COMPATIBILITY TYPE GUARDS\n// =============================================================================\n\n/**\n * Type guard to check if an event is an agent-server OpenHandsEvent.\n * Uses isBaseEvent to validate the complete event structure.\n */\nexport function isAgentServerEvent(event: unknown): event is OpenHandsEvent {\n  return isBaseEvent(event);\n}\n"],"mappings":"2IA2CA,SAAgB,EAAY,EAAoC,CAC9D,OAEE,OAAO,GAAU,YADjB,GAEA,OAAQ,GACR,cAAe,GACf,WAAY,GACZ,OAAO,EAAM,IAAO,UACpB,EAAM,GAAG,OAAS,GAClB,OAAO,EAAM,WAAc,UAC3B,EAAM,UAAU,OAAS,GACzB,OAAO,EAAM,QAAW,WACvB,EAAM,SAAW,SAChB,EAAM,SAAW,QACjB,EAAM,SAAW,eACjB,EAAM,SAAW,OAEvB,CAKA,IAAa,EACX,GAEA,EAAM,SAAW,eACjB,cAAe,GACf,gBAAiB,GACjB,EAAM,cAAgB,MACtB,OAAO,EAAM,aAAgB,UAC7B,SAAU,EAAM,YAKL,EACX,GAEA,EAAM,SAAW,SACjB,cAAe,GACf,iBAAkB,GAClB,UAAW,GACX,OAAO,EAAM,WAAc,UAC3B,OAAO,EAAM,cAAiB,UAC9B,OAAO,EAAM,OAAU,SAKZ,EAAkB,GAC7B,gBAAiB,GACjB,OAAO,EAAM,aAAgB,UAC7B,EAAM,cAAgB,MACtB,SAAU,EAAM,aAChB,YAAa,EAAM,YAKR,EACX,GAEA,EAAe,CAAK,GAAK,EAAM,YAAY,OAAS,OAKzC,EAAiB,GAC5B,EAAM,SAAW,SACjB,WAAY,GACZ,EAAM,SAAW,MACjB,OAAO,EAAM,QAAW,UACxB,SAAU,EAAM,QAChB,cAAe,GACf,iBAAkB,GAClB,OAAO,EAAM,WAAc,UAC3B,OAAO,EAAM,cAAiB,SAKnB,EACX,GAEA,EAAc,CAAK,IAClB,EAAM,OAAO,OAAS,qBACrB,EAAM,OAAO,OAAS,kBAKb,EACX,GAEA,EAAmB,CAAK,IACvB,EAAM,YAAY,OAAS,0BAC1B,EAAM,YAAY,OAAS,uBAKlB,EACX,GAEA,EAAmB,CAAK,GACxB,EAAM,YAAY,OAAS,gCAKhB,EACX,GAEA,EAAmB,CAAK,GAAK,EAAM,YAAY,OAAS,qBAK7C,EACX,GAEA,EAAmB,CAAK,GACxB,EAAM,YAAY,OAAS,uBAKhB,EACX,GAEA,EAAc,CAAK,GAAK,EAAM,OAAO,OAAS,wBAQnC,EACX,GAEA,EAAc,CAAK,IAClB,EAAM,YAAA,aACL,EAAM,YAAA,qBAQG,EACX,GAEA,EAAc,CAAK,GACnB,EAAM,YAAA,4BAKK,EACX,GAEA,EAAM,SAAW,SACjB,kBAAmB,GACnB,UAAW,GACX,OAAO,EAAM,eAAkB,UAC/B,MAAM,QAAQ,EAAM,KAAK,EAKd,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,+BAEvB,EACX,GACmD,EAAM,MAAQ,aAEtD,EACX,GAEA,EAAM,MAAQ,mBAEH,EACX,GAC+C,EAAM,MAAQ,QAElD,EACX,GAC8C,EAAM,MAAQ,OAKjD,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,yBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,mBAMvB,EAA2B,GACtC,EAAyB,CAAK,GAAK,EAAmB,CAAK,EAKhD,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,qBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,mBAEvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,sBAUpC,SAAgB,EAAmB,EAAyC,CAC1E,OAAO,EAAY,CAAK,CAC1B"}

package/dist/types/agent-server/type-guards.d.ts

@@ -1,4 +1,4 @@
-import { OpenHandsEvent, ObservationEvent, BaseEvent, ExecuteBashAction, TerminalAction, ExecuteBashObservation, PlanningFileEditorObservation, TerminalObservation, BrowserObservation, BrowserNavigateAction, SwitchLLMObservation, CanvasUIAction } from "./core";
+import { OpenHandsEvent, ObservationEvent, BaseEvent, ExecuteBashAction, TerminalAction, ExecuteBashObservation, PlanningFileEditorObservation, TerminalObservation, BrowserObservation, BrowserNavigateAction, SwitchLLMObservation, CanvasUIAction, LaunchChildConversationAction } from "./core";
 import { AgentErrorEvent } from "./core/events/observation-event";
 import { MessageEvent } from "./core/events/message-event";
 import { ActionEvent } from "./core/events/action-event";
@@ -64,6 +64,13 @@ export declare const isBrowserNavigateActionEvent: (event: OpenHandsEvent) => ev
  * SDK-generated action kind without leaking that generated name here.
  */
 export declare const isCanvasUIActionEvent: (event: OpenHandsEvent) => event is ActionEvent<CanvasUIAction>;
+/**
+ * Type guard for launch-child-conversation tool ActionEvents.
+ *
+ * Discriminates on tool_name, like `isCanvasUIActionEvent`, so the
+ * SDK-generated action kind stays contained in the constants module.
+ */
+export declare const isLaunchChildConversationActionEvent: (event: OpenHandsEvent) => event is ActionEvent<LaunchChildConversationAction>;
 /**
  * Type guard function to check if an event is a system prompt event
  */

package/dist/types/agent-server/type-guards.js

@@ -1,13 +1,14 @@
 import "../../constants/canvas-ui.js";
+import "../../constants/child-conversation.js";
 //#region src/types/agent-server/type-guards.ts
 function e(e) {
 	return typeof e == "object" && !!e && "id" in e && "timestamp" in e && "source" in e && typeof e.id == "string" && e.id.length > 0 && typeof e.timestamp == "string" && e.timestamp.length > 0 && typeof e.source == "string" && (e.source === "agent" || e.source === "user" || e.source === "environment" || e.source === "hook");
 }
-var t = (e) => e.source === "environment" && "action_id" in e && "observation" in e && e.observation !== null && typeof e.observation == "object" && "kind" in e.observation, n = (e) => e.source === "agent" && "tool_name" in e && "tool_call_id" in e && "error" in e && typeof e.tool_name == "string" && typeof e.tool_call_id == "string" && typeof e.error == "string", r = (e) => "llm_message" in e && typeof e.llm_message == "object" && e.llm_message !== null && "role" in e.llm_message && "content" in e.llm_message, i = (e) => r(e) && e.llm_message.role === "user", a = (e) => e.source === "agent" && "action" in e && e.action !== null && typeof e.action == "object" && "kind" in e.action && "tool_name" in e && "tool_call_id" in e && typeof e.tool_name == "string" && typeof e.tool_call_id == "string", o = (e) => a(e) && (e.action.kind === "ExecuteBashAction" || e.action.kind === "TerminalAction"), s = (e) => t(e) && (e.observation.kind === "ExecuteBashObservation" || e.observation.kind === "TerminalObservation"), c = (e) => t(e) && e.observation.kind === "PlanningFileEditorObservation", l = (e) => t(e) && e.observation.kind === "BrowserObservation", u = (e) => t(e) && e.observation.kind === "SwitchLLMObservation", d = (e) => a(e) && e.action.kind === "BrowserNavigateAction", f = (e) => a(e) && (e.tool_name === "canvas_ui" || e.tool_name === "canvas_ui_control"), p = (e) => e.source === "agent" && "system_prompt" in e && "tools" in e && typeof e.system_prompt == "object" && Array.isArray(e.tools), m = (e) => "kind" in e && e.kind === "ConversationStateUpdateEvent", h = (e) => e.key === "full_state", g = (e) => e.key === "execution_status", _ = (e) => e.key === "stats", v = (e) => e.key === "goal", y = (e) => "kind" in e && e.kind === "ConversationErrorEvent", b = (e) => "kind" in e && e.kind === "ServerErrorEvent", x = (e) => y(e) || b(e), S = (e) => "kind" in e && e.kind === "HookExecutionEvent", C = (e) => "kind" in e && e.kind === "ACPToolCallEvent", w = (e) => "kind" in e && e.kind === "StreamingDeltaEvent";
-function T(t) {
+var t = (e) => e.source === "environment" && "action_id" in e && "observation" in e && e.observation !== null && typeof e.observation == "object" && "kind" in e.observation, n = (e) => e.source === "agent" && "tool_name" in e && "tool_call_id" in e && "error" in e && typeof e.tool_name == "string" && typeof e.tool_call_id == "string" && typeof e.error == "string", r = (e) => "llm_message" in e && typeof e.llm_message == "object" && e.llm_message !== null && "role" in e.llm_message && "content" in e.llm_message, i = (e) => r(e) && e.llm_message.role === "user", a = (e) => e.source === "agent" && "action" in e && e.action !== null && typeof e.action == "object" && "kind" in e.action && "tool_name" in e && "tool_call_id" in e && typeof e.tool_name == "string" && typeof e.tool_call_id == "string", o = (e) => a(e) && (e.action.kind === "ExecuteBashAction" || e.action.kind === "TerminalAction"), s = (e) => t(e) && (e.observation.kind === "ExecuteBashObservation" || e.observation.kind === "TerminalObservation"), c = (e) => t(e) && e.observation.kind === "PlanningFileEditorObservation", l = (e) => t(e) && e.observation.kind === "BrowserObservation", u = (e) => t(e) && e.observation.kind === "SwitchLLMObservation", d = (e) => a(e) && e.action.kind === "BrowserNavigateAction", f = (e) => a(e) && (e.tool_name === "canvas_ui" || e.tool_name === "canvas_ui_control"), p = (e) => a(e) && e.tool_name === "launch_child_conversation", m = (e) => e.source === "agent" && "system_prompt" in e && "tools" in e && typeof e.system_prompt == "object" && Array.isArray(e.tools), h = (e) => "kind" in e && e.kind === "ConversationStateUpdateEvent", g = (e) => e.key === "full_state", _ = (e) => e.key === "execution_status", v = (e) => e.key === "stats", y = (e) => e.key === "goal", b = (e) => "kind" in e && e.kind === "ConversationErrorEvent", x = (e) => "kind" in e && e.kind === "ServerErrorEvent", S = (e) => b(e) || x(e), C = (e) => "kind" in e && e.kind === "HookExecutionEvent", w = (e) => "kind" in e && e.kind === "ACPToolCallEvent", T = (e) => "kind" in e && e.kind === "StreamingDeltaEvent";
+function E(t) {
 	return e(t);
 }
 //#endregion
-export { C as isACPToolCallEvent, a as isActionEvent, n as isAgentErrorEvent, T as isAgentServerEvent, g as isAgentStatusConversationStateUpdateEvent, d as isBrowserNavigateActionEvent, l as isBrowserObservationEvent, f as isCanvasUIActionEvent, m as isConversationStateUpdateEvent, x as isDisplayableErrorEvent, o as isExecuteBashActionEvent, s as isExecuteBashObservationEvent, h as isFullStateConversationStateUpdateEvent, v as isGoalConversationStateUpdateEvent, S as isHookExecutionEvent, r as isMessageEvent, t as isObservationEvent, c as isPlanningFileEditorObservationEvent, _ as isStatsConversationStateUpdateEvent, w as isStreamingDeltaEvent, u as isSwitchLLMObservationEvent, p as isSystemPromptEvent, i as isUserMessageEvent };
+export { w as isACPToolCallEvent, a as isActionEvent, n as isAgentErrorEvent, E as isAgentServerEvent, _ as isAgentStatusConversationStateUpdateEvent, d as isBrowserNavigateActionEvent, l as isBrowserObservationEvent, f as isCanvasUIActionEvent, h as isConversationStateUpdateEvent, S as isDisplayableErrorEvent, o as isExecuteBashActionEvent, s as isExecuteBashObservationEvent, g as isFullStateConversationStateUpdateEvent, y as isGoalConversationStateUpdateEvent, C as isHookExecutionEvent, p as isLaunchChildConversationActionEvent, r as isMessageEvent, t as isObservationEvent, c as isPlanningFileEditorObservationEvent, v as isStatsConversationStateUpdateEvent, T as isStreamingDeltaEvent, u as isSwitchLLMObservationEvent, m as isSystemPromptEvent, i as isUserMessageEvent };
 
 //# sourceMappingURL=type-guards.js.map

package/dist/types/agent-server/type-guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.js","names":[],"sources":["../../../src/types/agent-server/type-guards.ts"],"sourcesContent":["import {\n  CANVAS_UI_CLIENT_TOOL_NAME,\n  LEGACY_CANVAS_UI_TOOL_NAME,\n} from \"#/constants/canvas-ui\";\n\nimport {\n  OpenHandsEvent,\n  ObservationEvent,\n  BaseEvent,\n  ExecuteBashAction,\n  TerminalAction,\n  ExecuteBashObservation,\n  PlanningFileEditorObservation,\n  TerminalObservation,\n  BrowserObservation,\n  BrowserNavigateAction,\n  SwitchLLMObservation,\n  CanvasUIAction,\n} from \"./core\";\nimport { AgentErrorEvent } from \"./core/events/observation-event\";\nimport { MessageEvent } from \"./core/events/message-event\";\nimport { ActionEvent } from \"./core/events/action-event\";\nimport {\n  ConversationStateUpdateEvent,\n  ConversationStateUpdateEventAgentStatus,\n  ConversationStateUpdateEventFullState,\n  ConversationStateUpdateEventStats,\n  ConversationStateUpdateEventGoal,\n  ConversationErrorEvent,\n  ServerErrorEvent,\n} from \"./core/events/conversation-state-event\";\nimport { HookExecutionEvent } from \"./core/events/hook-execution-event\";\nimport { ACPToolCallEvent } from \"./core/events/acp-tool-call-event\";\nimport { StreamingDeltaEvent } from \"./core/events/streaming-delta-event\";\nimport { SystemPromptEvent } from \"./core/events/system-event\";\n\n/**\n * Type guard to check if an unknown value is a valid BaseEvent\n * @param value - The value to check\n * @returns true if the value is a valid BaseEvent\n */\nexport function isBaseEvent(value: unknown): value is BaseEvent {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"id\" in value &&\n    \"timestamp\" in value &&\n    \"source\" in value &&\n    typeof value.id === \"string\" &&\n    value.id.length > 0 &&\n    typeof value.timestamp === \"string\" &&\n    value.timestamp.length > 0 &&\n    typeof value.source === \"string\" &&\n    (value.source === \"agent\" ||\n      value.source === \"user\" ||\n      value.source === \"environment\" ||\n      value.source === \"hook\")\n  );\n}\n\n/**\n * Type guard function to check if an event is an observation event\n */\nexport const isObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent =>\n  event.source === \"environment\" &&\n  \"action_id\" in event &&\n  \"observation\" in event &&\n  event.observation !== null &&\n  typeof event.observation === \"object\" &&\n  \"kind\" in event.observation;\n\n/**\n * Type guard function to check if an event is an agent error event\n */\nexport const isAgentErrorEvent = (\n  event: OpenHandsEvent,\n): event is AgentErrorEvent =>\n  event.source === \"agent\" &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  \"error\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\" &&\n  typeof event.error === \"string\";\n\n/**\n * Type guard function to check if an event is a message event (user or assistant)\n */\nexport const isMessageEvent = (event: OpenHandsEvent): event is MessageEvent =>\n  \"llm_message\" in event &&\n  typeof event.llm_message === \"object\" &&\n  event.llm_message !== null &&\n  \"role\" in event.llm_message &&\n  \"content\" in event.llm_message;\n\n/**\n * Type guard function to check if an event is a user message event\n */\nexport const isUserMessageEvent = (\n  event: OpenHandsEvent,\n): event is MessageEvent =>\n  isMessageEvent(event) && event.llm_message.role === \"user\";\n\n/**\n * Type guard function to check if an event is an action event\n */\nexport const isActionEvent = (event: OpenHandsEvent): event is ActionEvent =>\n  event.source === \"agent\" &&\n  \"action\" in event &&\n  event.action !== null &&\n  typeof event.action === \"object\" &&\n  \"kind\" in event.action &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\";\n\n/**\n * Type guard function to check if an action event is an ExecuteBashAction\n */\nexport const isExecuteBashActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<ExecuteBashAction | TerminalAction> =>\n  isActionEvent(event) &&\n  (event.action.kind === \"ExecuteBashAction\" ||\n    event.action.kind === \"TerminalAction\");\n\n/**\n * Type guard function to check if an observation event contains terminal output\n */\nexport const isExecuteBashObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<ExecuteBashObservation | TerminalObservation> =>\n  isObservationEvent(event) &&\n  (event.observation.kind === \"ExecuteBashObservation\" ||\n    event.observation.kind === \"TerminalObservation\");\n\n/**\n * Type guard function to check if an observation event is a PlanningFileEditorObservation\n */\nexport const isPlanningFileEditorObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<PlanningFileEditorObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"PlanningFileEditorObservation\";\n\n/**\n * Type guard function to check if an observation event is a BrowserObservation\n */\nexport const isBrowserObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<BrowserObservation> =>\n  isObservationEvent(event) && event.observation.kind === \"BrowserObservation\";\n\n/**\n * Type guard function to check if an observation event is a SwitchLLMObservation\n */\nexport const isSwitchLLMObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<SwitchLLMObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"SwitchLLMObservation\";\n\n/**\n * Type guard function to check if an action event is a BrowserNavigateAction\n */\nexport const isBrowserNavigateActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<BrowserNavigateAction> =>\n  isActionEvent(event) && event.action.kind === \"BrowserNavigateAction\";\n\n/**\n * Type guard for Canvas UI tool ActionEvents.\n *\n * Discriminating on tool_name supports legacy CanvasUIAction events and the\n * SDK-generated action kind without leaking that generated name here.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) &&\n  (event.tool_name === LEGACY_CANVAS_UI_TOOL_NAME ||\n    event.tool_name === CANVAS_UI_CLIENT_TOOL_NAME);\n\n/**\n * Type guard function to check if an event is a system prompt event\n */\nexport const isSystemPromptEvent = (\n  event: OpenHandsEvent,\n): event is SystemPromptEvent =>\n  event.source === \"agent\" &&\n  \"system_prompt\" in event &&\n  \"tools\" in event &&\n  typeof event.system_prompt === \"object\" &&\n  Array.isArray(event.tools);\n\n/**\n * Type guard function to check if an event is a conversation state update event\n */\nexport const isConversationStateUpdateEvent = (\n  event: OpenHandsEvent,\n): event is ConversationStateUpdateEvent =>\n  \"kind\" in event && event.kind === \"ConversationStateUpdateEvent\";\n\nexport const isFullStateConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventFullState => event.key === \"full_state\";\n\nexport const isAgentStatusConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventAgentStatus =>\n  event.key === \"execution_status\";\n\nexport const isStatsConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventStats => event.key === \"stats\";\n\nexport const isGoalConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventGoal => event.key === \"goal\";\n\n/**\n * Type guard function to check if an event is a conversation error event\n */\nexport const isConversationErrorEvent = (\n  event: OpenHandsEvent,\n): event is ConversationErrorEvent =>\n  \"kind\" in event && event.kind === \"ConversationErrorEvent\";\n\n/**\n * Type guard function to check if an event is a server error event\n */\nexport const isServerErrorEvent = (\n  event: OpenHandsEvent,\n): event is ServerErrorEvent =>\n  \"kind\" in event && event.kind === \"ServerErrorEvent\";\n\n/**\n * Type guard function to check if an event is a displayable error event\n * (ConversationErrorEvent or ServerErrorEvent) - both should show as error banners\n */\nexport const isDisplayableErrorEvent = (event: OpenHandsEvent): boolean =>\n  isConversationErrorEvent(event) || isServerErrorEvent(event);\n\n/**\n * Type guard function to check if an event is a hook execution event\n */\nexport const isHookExecutionEvent = (\n  event: OpenHandsEvent,\n): event is HookExecutionEvent =>\n  \"kind\" in event && event.kind === \"HookExecutionEvent\";\n\n/**\n * Type guard function to check if an event is an ACP tool call event\n */\nexport const isACPToolCallEvent = (\n  event: OpenHandsEvent,\n): event is ACPToolCallEvent =>\n  \"kind\" in event && event.kind === \"ACPToolCallEvent\";\n\nexport const isStreamingDeltaEvent = (\n  event: OpenHandsEvent,\n): event is StreamingDeltaEvent =>\n  \"kind\" in event && event.kind === \"StreamingDeltaEvent\";\n\n// =============================================================================\n// COMPATIBILITY TYPE GUARDS\n// =============================================================================\n\n/**\n * Type guard to check if an event is an agent-server OpenHandsEvent.\n * Uses isBaseEvent to validate the complete event structure.\n */\nexport function isAgentServerEvent(event: unknown): event is OpenHandsEvent {\n  return isBaseEvent(event);\n}\n"],"mappings":";;AAyCA,SAAgB,EAAY,GAAoC;CAC9D,OAEE,OAAO,KAAU,cADjB,KAEA,QAAQ,KACR,eAAe,KACf,YAAY,KACZ,OAAO,EAAM,MAAO,YACpB,EAAM,GAAG,SAAS,KAClB,OAAO,EAAM,aAAc,YAC3B,EAAM,UAAU,SAAS,KACzB,OAAO,EAAM,UAAW,aACvB,EAAM,WAAW,WAChB,EAAM,WAAW,UACjB,EAAM,WAAW,iBACjB,EAAM,WAAW;AAEvB;AAKA,IAAa,KACX,MAEA,EAAM,WAAW,iBACjB,eAAe,KACf,iBAAiB,KACjB,EAAM,gBAAgB,QACtB,OAAO,EAAM,eAAgB,YAC7B,UAAU,EAAM,aAKL,KACX,MAEA,EAAM,WAAW,WACjB,eAAe,KACf,kBAAkB,KAClB,WAAW,KACX,OAAO,EAAM,aAAc,YAC3B,OAAO,EAAM,gBAAiB,YAC9B,OAAO,EAAM,SAAU,UAKZ,KAAkB,MAC7B,iBAAiB,KACjB,OAAO,EAAM,eAAgB,YAC7B,EAAM,gBAAgB,QACtB,UAAU,EAAM,eAChB,aAAa,EAAM,aAKR,KACX,MAEA,EAAe,CAAK,KAAK,EAAM,YAAY,SAAS,QAKzC,KAAiB,MAC5B,EAAM,WAAW,WACjB,YAAY,KACZ,EAAM,WAAW,QACjB,OAAO,EAAM,UAAW,YACxB,UAAU,EAAM,UAChB,eAAe,KACf,kBAAkB,KAClB,OAAO,EAAM,aAAc,YAC3B,OAAO,EAAM,gBAAiB,UAKnB,KACX,MAEA,EAAc,CAAK,MAClB,EAAM,OAAO,SAAS,uBACrB,EAAM,OAAO,SAAS,mBAKb,KACX,MAEA,EAAmB,CAAK,MACvB,EAAM,YAAY,SAAS,4BAC1B,EAAM,YAAY,SAAS,wBAKlB,KACX,MAEA,EAAmB,CAAK,KACxB,EAAM,YAAY,SAAS,iCAKhB,KACX,MAEA,EAAmB,CAAK,KAAK,EAAM,YAAY,SAAS,sBAK7C,KACX,MAEA,EAAmB,CAAK,KACxB,EAAM,YAAY,SAAS,wBAKhB,KACX,MAEA,EAAc,CAAK,KAAK,EAAM,OAAO,SAAS,yBAQnC,KACX,MAEA,EAAc,CAAK,MAClB,EAAM,cAAA,eACL,EAAM,cAAA,sBAKG,KACX,MAEA,EAAM,WAAW,WACjB,mBAAmB,KACnB,WAAW,KACX,OAAO,EAAM,iBAAkB,YAC/B,MAAM,QAAQ,EAAM,KAAK,GAKd,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,gCAEvB,KACX,MACmD,EAAM,QAAQ,cAEtD,KACX,MAEA,EAAM,QAAQ,oBAEH,KACX,MAC+C,EAAM,QAAQ,SAElD,KACX,MAC8C,EAAM,QAAQ,QAKjD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,0BAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAMvB,KAA2B,MACtC,EAAyB,CAAK,KAAK,EAAmB,CAAK,GAKhD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,sBAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAEvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS;AAUpC,SAAgB,EAAmB,GAAyC;CAC1E,OAAO,EAAY,CAAK;AAC1B"}
+{"version":3,"file":"type-guards.js","names":[],"sources":["../../../src/types/agent-server/type-guards.ts"],"sourcesContent":["import {\n  CANVAS_UI_CLIENT_TOOL_NAME,\n  LEGACY_CANVAS_UI_TOOL_NAME,\n} from \"#/constants/canvas-ui\";\nimport { LAUNCH_CHILD_CONVERSATION_TOOL_NAME } from \"#/constants/child-conversation\";\n\nimport {\n  OpenHandsEvent,\n  ObservationEvent,\n  BaseEvent,\n  ExecuteBashAction,\n  TerminalAction,\n  ExecuteBashObservation,\n  PlanningFileEditorObservation,\n  TerminalObservation,\n  BrowserObservation,\n  BrowserNavigateAction,\n  SwitchLLMObservation,\n  CanvasUIAction,\n  LaunchChildConversationAction,\n} from \"./core\";\nimport { AgentErrorEvent } from \"./core/events/observation-event\";\nimport { MessageEvent } from \"./core/events/message-event\";\nimport { ActionEvent } from \"./core/events/action-event\";\nimport {\n  ConversationStateUpdateEvent,\n  ConversationStateUpdateEventAgentStatus,\n  ConversationStateUpdateEventFullState,\n  ConversationStateUpdateEventStats,\n  ConversationStateUpdateEventGoal,\n  ConversationErrorEvent,\n  ServerErrorEvent,\n} from \"./core/events/conversation-state-event\";\nimport { HookExecutionEvent } from \"./core/events/hook-execution-event\";\nimport { ACPToolCallEvent } from \"./core/events/acp-tool-call-event\";\nimport { StreamingDeltaEvent } from \"./core/events/streaming-delta-event\";\nimport { SystemPromptEvent } from \"./core/events/system-event\";\n\n/**\n * Type guard to check if an unknown value is a valid BaseEvent\n * @param value - The value to check\n * @returns true if the value is a valid BaseEvent\n */\nexport function isBaseEvent(value: unknown): value is BaseEvent {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"id\" in value &&\n    \"timestamp\" in value &&\n    \"source\" in value &&\n    typeof value.id === \"string\" &&\n    value.id.length > 0 &&\n    typeof value.timestamp === \"string\" &&\n    value.timestamp.length > 0 &&\n    typeof value.source === \"string\" &&\n    (value.source === \"agent\" ||\n      value.source === \"user\" ||\n      value.source === \"environment\" ||\n      value.source === \"hook\")\n  );\n}\n\n/**\n * Type guard function to check if an event is an observation event\n */\nexport const isObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent =>\n  event.source === \"environment\" &&\n  \"action_id\" in event &&\n  \"observation\" in event &&\n  event.observation !== null &&\n  typeof event.observation === \"object\" &&\n  \"kind\" in event.observation;\n\n/**\n * Type guard function to check if an event is an agent error event\n */\nexport const isAgentErrorEvent = (\n  event: OpenHandsEvent,\n): event is AgentErrorEvent =>\n  event.source === \"agent\" &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  \"error\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\" &&\n  typeof event.error === \"string\";\n\n/**\n * Type guard function to check if an event is a message event (user or assistant)\n */\nexport const isMessageEvent = (event: OpenHandsEvent): event is MessageEvent =>\n  \"llm_message\" in event &&\n  typeof event.llm_message === \"object\" &&\n  event.llm_message !== null &&\n  \"role\" in event.llm_message &&\n  \"content\" in event.llm_message;\n\n/**\n * Type guard function to check if an event is a user message event\n */\nexport const isUserMessageEvent = (\n  event: OpenHandsEvent,\n): event is MessageEvent =>\n  isMessageEvent(event) && event.llm_message.role === \"user\";\n\n/**\n * Type guard function to check if an event is an action event\n */\nexport const isActionEvent = (event: OpenHandsEvent): event is ActionEvent =>\n  event.source === \"agent\" &&\n  \"action\" in event &&\n  event.action !== null &&\n  typeof event.action === \"object\" &&\n  \"kind\" in event.action &&\n  \"tool_name\" in event &&\n  \"tool_call_id\" in event &&\n  typeof event.tool_name === \"string\" &&\n  typeof event.tool_call_id === \"string\";\n\n/**\n * Type guard function to check if an action event is an ExecuteBashAction\n */\nexport const isExecuteBashActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<ExecuteBashAction | TerminalAction> =>\n  isActionEvent(event) &&\n  (event.action.kind === \"ExecuteBashAction\" ||\n    event.action.kind === \"TerminalAction\");\n\n/**\n * Type guard function to check if an observation event contains terminal output\n */\nexport const isExecuteBashObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<ExecuteBashObservation | TerminalObservation> =>\n  isObservationEvent(event) &&\n  (event.observation.kind === \"ExecuteBashObservation\" ||\n    event.observation.kind === \"TerminalObservation\");\n\n/**\n * Type guard function to check if an observation event is a PlanningFileEditorObservation\n */\nexport const isPlanningFileEditorObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<PlanningFileEditorObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"PlanningFileEditorObservation\";\n\n/**\n * Type guard function to check if an observation event is a BrowserObservation\n */\nexport const isBrowserObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<BrowserObservation> =>\n  isObservationEvent(event) && event.observation.kind === \"BrowserObservation\";\n\n/**\n * Type guard function to check if an observation event is a SwitchLLMObservation\n */\nexport const isSwitchLLMObservationEvent = (\n  event: OpenHandsEvent,\n): event is ObservationEvent<SwitchLLMObservation> =>\n  isObservationEvent(event) &&\n  event.observation.kind === \"SwitchLLMObservation\";\n\n/**\n * Type guard function to check if an action event is a BrowserNavigateAction\n */\nexport const isBrowserNavigateActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<BrowserNavigateAction> =>\n  isActionEvent(event) && event.action.kind === \"BrowserNavigateAction\";\n\n/**\n * Type guard for Canvas UI tool ActionEvents.\n *\n * Discriminating on tool_name supports legacy CanvasUIAction events and the\n * SDK-generated action kind without leaking that generated name here.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) &&\n  (event.tool_name === LEGACY_CANVAS_UI_TOOL_NAME ||\n    event.tool_name === CANVAS_UI_CLIENT_TOOL_NAME);\n\n/**\n * Type guard for launch-child-conversation tool ActionEvents.\n *\n * Discriminates on tool_name, like `isCanvasUIActionEvent`, so the\n * SDK-generated action kind stays contained in the constants module.\n */\nexport const isLaunchChildConversationActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<LaunchChildConversationAction> =>\n  isActionEvent(event) &&\n  event.tool_name === LAUNCH_CHILD_CONVERSATION_TOOL_NAME;\n\n/**\n * Type guard function to check if an event is a system prompt event\n */\nexport const isSystemPromptEvent = (\n  event: OpenHandsEvent,\n): event is SystemPromptEvent =>\n  event.source === \"agent\" &&\n  \"system_prompt\" in event &&\n  \"tools\" in event &&\n  typeof event.system_prompt === \"object\" &&\n  Array.isArray(event.tools);\n\n/**\n * Type guard function to check if an event is a conversation state update event\n */\nexport const isConversationStateUpdateEvent = (\n  event: OpenHandsEvent,\n): event is ConversationStateUpdateEvent =>\n  \"kind\" in event && event.kind === \"ConversationStateUpdateEvent\";\n\nexport const isFullStateConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventFullState => event.key === \"full_state\";\n\nexport const isAgentStatusConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventAgentStatus =>\n  event.key === \"execution_status\";\n\nexport const isStatsConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventStats => event.key === \"stats\";\n\nexport const isGoalConversationStateUpdateEvent = (\n  event: ConversationStateUpdateEvent,\n): event is ConversationStateUpdateEventGoal => event.key === \"goal\";\n\n/**\n * Type guard function to check if an event is a conversation error event\n */\nexport const isConversationErrorEvent = (\n  event: OpenHandsEvent,\n): event is ConversationErrorEvent =>\n  \"kind\" in event && event.kind === \"ConversationErrorEvent\";\n\n/**\n * Type guard function to check if an event is a server error event\n */\nexport const isServerErrorEvent = (\n  event: OpenHandsEvent,\n): event is ServerErrorEvent =>\n  \"kind\" in event && event.kind === \"ServerErrorEvent\";\n\n/**\n * Type guard function to check if an event is a displayable error event\n * (ConversationErrorEvent or ServerErrorEvent) - both should show as error banners\n */\nexport const isDisplayableErrorEvent = (event: OpenHandsEvent): boolean =>\n  isConversationErrorEvent(event) || isServerErrorEvent(event);\n\n/**\n * Type guard function to check if an event is a hook execution event\n */\nexport const isHookExecutionEvent = (\n  event: OpenHandsEvent,\n): event is HookExecutionEvent =>\n  \"kind\" in event && event.kind === \"HookExecutionEvent\";\n\n/**\n * Type guard function to check if an event is an ACP tool call event\n */\nexport const isACPToolCallEvent = (\n  event: OpenHandsEvent,\n): event is ACPToolCallEvent =>\n  \"kind\" in event && event.kind === \"ACPToolCallEvent\";\n\nexport const isStreamingDeltaEvent = (\n  event: OpenHandsEvent,\n): event is StreamingDeltaEvent =>\n  \"kind\" in event && event.kind === \"StreamingDeltaEvent\";\n\n// =============================================================================\n// COMPATIBILITY TYPE GUARDS\n// =============================================================================\n\n/**\n * Type guard to check if an event is an agent-server OpenHandsEvent.\n * Uses isBaseEvent to validate the complete event structure.\n */\nexport function isAgentServerEvent(event: unknown): event is OpenHandsEvent {\n  return isBaseEvent(event);\n}\n"],"mappings":";;;AA2CA,SAAgB,EAAY,GAAoC;CAC9D,OAEE,OAAO,KAAU,cADjB,KAEA,QAAQ,KACR,eAAe,KACf,YAAY,KACZ,OAAO,EAAM,MAAO,YACpB,EAAM,GAAG,SAAS,KAClB,OAAO,EAAM,aAAc,YAC3B,EAAM,UAAU,SAAS,KACzB,OAAO,EAAM,UAAW,aACvB,EAAM,WAAW,WAChB,EAAM,WAAW,UACjB,EAAM,WAAW,iBACjB,EAAM,WAAW;AAEvB;AAKA,IAAa,KACX,MAEA,EAAM,WAAW,iBACjB,eAAe,KACf,iBAAiB,KACjB,EAAM,gBAAgB,QACtB,OAAO,EAAM,eAAgB,YAC7B,UAAU,EAAM,aAKL,KACX,MAEA,EAAM,WAAW,WACjB,eAAe,KACf,kBAAkB,KAClB,WAAW,KACX,OAAO,EAAM,aAAc,YAC3B,OAAO,EAAM,gBAAiB,YAC9B,OAAO,EAAM,SAAU,UAKZ,KAAkB,MAC7B,iBAAiB,KACjB,OAAO,EAAM,eAAgB,YAC7B,EAAM,gBAAgB,QACtB,UAAU,EAAM,eAChB,aAAa,EAAM,aAKR,KACX,MAEA,EAAe,CAAK,KAAK,EAAM,YAAY,SAAS,QAKzC,KAAiB,MAC5B,EAAM,WAAW,WACjB,YAAY,KACZ,EAAM,WAAW,QACjB,OAAO,EAAM,UAAW,YACxB,UAAU,EAAM,UAChB,eAAe,KACf,kBAAkB,KAClB,OAAO,EAAM,aAAc,YAC3B,OAAO,EAAM,gBAAiB,UAKnB,KACX,MAEA,EAAc,CAAK,MAClB,EAAM,OAAO,SAAS,uBACrB,EAAM,OAAO,SAAS,mBAKb,KACX,MAEA,EAAmB,CAAK,MACvB,EAAM,YAAY,SAAS,4BAC1B,EAAM,YAAY,SAAS,wBAKlB,KACX,MAEA,EAAmB,CAAK,KACxB,EAAM,YAAY,SAAS,iCAKhB,KACX,MAEA,EAAmB,CAAK,KAAK,EAAM,YAAY,SAAS,sBAK7C,KACX,MAEA,EAAmB,CAAK,KACxB,EAAM,YAAY,SAAS,wBAKhB,KACX,MAEA,EAAc,CAAK,KAAK,EAAM,OAAO,SAAS,yBAQnC,KACX,MAEA,EAAc,CAAK,MAClB,EAAM,cAAA,eACL,EAAM,cAAA,sBAQG,KACX,MAEA,EAAc,CAAK,KACnB,EAAM,cAAA,6BAKK,KACX,MAEA,EAAM,WAAW,WACjB,mBAAmB,KACnB,WAAW,KACX,OAAO,EAAM,iBAAkB,YAC/B,MAAM,QAAQ,EAAM,KAAK,GAKd,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,gCAEvB,KACX,MACmD,EAAM,QAAQ,cAEtD,KACX,MAEA,EAAM,QAAQ,oBAEH,KACX,MAC+C,EAAM,QAAQ,SAElD,KACX,MAC8C,EAAM,QAAQ,QAKjD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,0BAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAMvB,KAA2B,MACtC,EAAyB,CAAK,KAAK,EAAmB,CAAK,GAKhD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,sBAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAEvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS;AAUpC,SAAgB,EAAmB,GAAyC;CAC1E,OAAO,EAAY,CAAK;AAC1B"}

package/dist/types/automation.d.ts

@@ -30,7 +30,7 @@ export interface Automation {
     model?: string | null;
     /**
      * Maximum run time in seconds. `null`/omitted uses the server default
-     * (600s, 10 min); the server caps it at 1800s (30 min).
+     * (600s, 10 min); the deployment reports the maximum it accepts.
      */
     timeout?: number | null;
     created_at: string;
@@ -75,6 +75,14 @@ export interface AutomationRun {
      */
     bash_command_id: string | null;
     error_detail: string | null;
+    /**
+     * Accumulated LLM cost of the run in USD, reported by the SDK in the
+     * completion callback. `null` means unknown — the run predates cost
+     * tracking, or ended without a callback (cancelled, watchdog timeout).
+     * Absent entirely when the automation service is older than the release
+     * that added the field, hence optional.
+     */
+    cost?: number | null;
     started_at: string;
     completed_at: string | null;
 }
@@ -82,3 +90,24 @@ export interface AutomationRunsResponse {
     runs: AutomationRun[];
     total: number;
 }
+export type ActivityLogExportFormat = "json" | "csv";
+/** Client-built Activity Log export row (from list runs + automation detail). */
+export interface AutomationRunExportRow {
+    run_id: string;
+    automation_id: string;
+    automation_name: string;
+    trigger: AutomationTrigger | Record<string, unknown>;
+    start_time: string | null;
+    end_time: string | null;
+    duration_seconds: number | null;
+    status: AutomationRunStatus;
+    conversation_id: string | null;
+    conversation_url: string | null;
+    error: string | null;
+    /**
+     * Accumulated LLM cost in USD, or null when unknown. Unlike
+     * `AutomationRun["cost"]` this is always present: the row normalizes a
+     * missing field to null so every exported record has the same shape.
+     */
+    cost: number | null;
+}

package/dist/types/mcp-auth.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-auth.cjs","names":[],"sources":["../../src/types/mcp-auth.ts"],"sourcesContent":["export type MCPOAuthClientAuthMethod =\n  | \"none\"\n  | \"client_secret_post\"\n  | \"client_secret_basic\"\n  | \"private_key_jwt\";\n\nexport type MCPJsonValue =\n  | boolean\n  | number\n  | string\n  | null\n  | MCPJsonValue[]\n  | { [key: string]: MCPJsonValue };\n\nexport interface MCPOAuthAuthenticationConfig {\n  type: \"oauth\";\n  client_auth_method?: MCPOAuthClientAuthMethod | null;\n  scopes?: string | string[] | null;\n  client_name?: string | null;\n  client_metadata_url?: string | null;\n  client_id?: string | null;\n  client_secret?: string | null;\n  additional_client_metadata?: Record<string, MCPJsonValue> | null;\n}\n\nexport type MCPAuthenticationConfig = MCPOAuthAuthenticationConfig;\n\nexport interface MCPOAuthState {\n  tokens?: Record<string, MCPJsonValue> | null;\n  client_info?: Record<string, MCPJsonValue> | null;\n  token_expires_at?: number | null;\n}\n\nexport type MCPAuthCredential =\n  | { strategy: \"none\" }\n  | { strategy: \"api_key\"; value?: string | null; header_name?: string | null }\n  | { strategy: \"bearer\"; value?: string | null }\n  | { strategy: \"basic\"; username: string; password?: string | null }\n  | { strategy: \"header\"; headers?: Record<string, string> | null }\n  | {\n      strategy: \"oauth2\";\n      authentication?: MCPAuthenticationConfig | null;\n      state?: MCPOAuthState | null;\n    };\n\nexport const MCP_AUTH_STRATEGIES = [\n  \"none\",\n  \"api_key\",\n  \"bearer\",\n  \"basic\",\n  \"header\",\n  \"oauth2\",\n] as const;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nexport const isMcpAuthCredential = (\n  value: unknown,\n): value is MCPAuthCredential =>\n  isRecord(value) &&\n  typeof value.strategy === \"string\" &&\n  (MCP_AUTH_STRATEGIES as readonly string[]).includes(value.strategy);\n"],"mappings":"6CA6CA,IAAa,EAAsB,CACjC,OACA,UACA,SACA,QACA,SACA,QACF,EAEM,EAAY,GAChB,CAAC,CAAC,GAAS,OAAO,GAAU,UAAY,CAAC,MAAM,QAAQ,CAAK,EAEjD,EACX,GAEA,EAAS,CAAK,GACd,OAAO,EAAM,UAAa,UACzB,EAA0C,SAAS,EAAM,QAAQ"}
+{"version":3,"file":"mcp-auth.cjs","names":[],"sources":["../../src/types/mcp-auth.ts"],"sourcesContent":["import type {\n  MCPAuthCredential,\n  MCPOAuthAuthentication,\n} from \"@openhands/typescript-client\";\n\nexport type {\n  MCPAuthCredential,\n  MCPOAuthAuthentication,\n  MCPOAuthState,\n} from \"@openhands/typescript-client\";\n\nexport type MCPAuthenticationConfig = MCPOAuthAuthentication;\nexport type MCPOAuthAuthenticationConfig = MCPOAuthAuthentication;\nexport type MCPOAuthClientAuthMethod = NonNullable<\n  MCPOAuthAuthentication[\"client_auth_method\"]\n>;\n\nexport const MCP_AUTH_STRATEGIES = [\n  \"none\",\n  \"api_key\",\n  \"bearer\",\n  \"basic\",\n  \"header\",\n  \"oauth2\",\n] as const;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nexport const isMcpAuthCredential = (\n  value: unknown,\n): value is MCPAuthCredential =>\n  isRecord(value) &&\n  typeof value.strategy === \"string\" &&\n  (MCP_AUTH_STRATEGIES as readonly string[]).includes(value.strategy);\n"],"mappings":"6CAiBA,IAAa,EAAsB,CACjC,OACA,UACA,SACA,QACA,SACA,QACF,EAEM,EAAY,GAChB,CAAC,CAAC,GAAS,OAAO,GAAU,UAAY,CAAC,MAAM,QAAQ,CAAK,EAEjD,EACX,GAEA,EAAS,CAAK,GACd,OAAO,EAAM,UAAa,UACzB,EAA0C,SAAS,EAAM,QAAQ"}

package/dist/types/mcp-auth.d.ts

@@ -1,43 +1,7 @@
-export type MCPOAuthClientAuthMethod = "none" | "client_secret_post" | "client_secret_basic" | "private_key_jwt";
-export type MCPJsonValue = boolean | number | string | null | MCPJsonValue[] | {
-    [key: string]: MCPJsonValue;
-};
-export interface MCPOAuthAuthenticationConfig {
-    type: "oauth";
-    client_auth_method?: MCPOAuthClientAuthMethod | null;
-    scopes?: string | string[] | null;
-    client_name?: string | null;
-    client_metadata_url?: string | null;
-    client_id?: string | null;
-    client_secret?: string | null;
-    additional_client_metadata?: Record<string, MCPJsonValue> | null;
-}
-export type MCPAuthenticationConfig = MCPOAuthAuthenticationConfig;
-export interface MCPOAuthState {
-    tokens?: Record<string, MCPJsonValue> | null;
-    client_info?: Record<string, MCPJsonValue> | null;
-    token_expires_at?: number | null;
-}
-export type MCPAuthCredential = {
-    strategy: "none";
-} | {
-    strategy: "api_key";
-    value?: string | null;
-    header_name?: string | null;
-} | {
-    strategy: "bearer";
-    value?: string | null;
-} | {
-    strategy: "basic";
-    username: string;
-    password?: string | null;
-} | {
-    strategy: "header";
-    headers?: Record<string, string> | null;
-} | {
-    strategy: "oauth2";
-    authentication?: MCPAuthenticationConfig | null;
-    state?: MCPOAuthState | null;
-};
+import type { MCPAuthCredential, MCPOAuthAuthentication } from "@openhands/typescript-client";
+export type { MCPAuthCredential, MCPOAuthAuthentication, MCPOAuthState, } from "@openhands/typescript-client";
+export type MCPAuthenticationConfig = MCPOAuthAuthentication;
+export type MCPOAuthAuthenticationConfig = MCPOAuthAuthentication;
+export type MCPOAuthClientAuthMethod = NonNullable<MCPOAuthAuthentication["client_auth_method"]>;
 export declare const MCP_AUTH_STRATEGIES: readonly ["none", "api_key", "bearer", "basic", "header", "oauth2"];
 export declare const isMcpAuthCredential: (value: unknown) => value is MCPAuthCredential;

package/dist/types/mcp-auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-auth.js","names":[],"sources":["../../src/types/mcp-auth.ts"],"sourcesContent":["export type MCPOAuthClientAuthMethod =\n  | \"none\"\n  | \"client_secret_post\"\n  | \"client_secret_basic\"\n  | \"private_key_jwt\";\n\nexport type MCPJsonValue =\n  | boolean\n  | number\n  | string\n  | null\n  | MCPJsonValue[]\n  | { [key: string]: MCPJsonValue };\n\nexport interface MCPOAuthAuthenticationConfig {\n  type: \"oauth\";\n  client_auth_method?: MCPOAuthClientAuthMethod | null;\n  scopes?: string | string[] | null;\n  client_name?: string | null;\n  client_metadata_url?: string | null;\n  client_id?: string | null;\n  client_secret?: string | null;\n  additional_client_metadata?: Record<string, MCPJsonValue> | null;\n}\n\nexport type MCPAuthenticationConfig = MCPOAuthAuthenticationConfig;\n\nexport interface MCPOAuthState {\n  tokens?: Record<string, MCPJsonValue> | null;\n  client_info?: Record<string, MCPJsonValue> | null;\n  token_expires_at?: number | null;\n}\n\nexport type MCPAuthCredential =\n  | { strategy: \"none\" }\n  | { strategy: \"api_key\"; value?: string | null; header_name?: string | null }\n  | { strategy: \"bearer\"; value?: string | null }\n  | { strategy: \"basic\"; username: string; password?: string | null }\n  | { strategy: \"header\"; headers?: Record<string, string> | null }\n  | {\n      strategy: \"oauth2\";\n      authentication?: MCPAuthenticationConfig | null;\n      state?: MCPOAuthState | null;\n    };\n\nexport const MCP_AUTH_STRATEGIES = [\n  \"none\",\n  \"api_key\",\n  \"bearer\",\n  \"basic\",\n  \"header\",\n  \"oauth2\",\n] as const;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nexport const isMcpAuthCredential = (\n  value: unknown,\n): value is MCPAuthCredential =>\n  isRecord(value) &&\n  typeof value.strategy === \"string\" &&\n  (MCP_AUTH_STRATEGIES as readonly string[]).includes(value.strategy);\n"],"mappings":";AA6CA,IAAa,IAAsB;CACjC;CACA;CACA;CACA;CACA;CACA;AACF,GAEM,KAAY,MAChB,CAAC,CAAC,KAAS,OAAO,KAAU,YAAY,CAAC,MAAM,QAAQ,CAAK,GAEjD,KACX,MAEA,EAAS,CAAK,KACd,OAAO,EAAM,YAAa,YACzB,EAA0C,SAAS,EAAM,QAAQ"}
+{"version":3,"file":"mcp-auth.js","names":[],"sources":["../../src/types/mcp-auth.ts"],"sourcesContent":["import type {\n  MCPAuthCredential,\n  MCPOAuthAuthentication,\n} from \"@openhands/typescript-client\";\n\nexport type {\n  MCPAuthCredential,\n  MCPOAuthAuthentication,\n  MCPOAuthState,\n} from \"@openhands/typescript-client\";\n\nexport type MCPAuthenticationConfig = MCPOAuthAuthentication;\nexport type MCPOAuthAuthenticationConfig = MCPOAuthAuthentication;\nexport type MCPOAuthClientAuthMethod = NonNullable<\n  MCPOAuthAuthentication[\"client_auth_method\"]\n>;\n\nexport const MCP_AUTH_STRATEGIES = [\n  \"none\",\n  \"api_key\",\n  \"bearer\",\n  \"basic\",\n  \"header\",\n  \"oauth2\",\n] as const;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  !!value && typeof value === \"object\" && !Array.isArray(value);\n\nexport const isMcpAuthCredential = (\n  value: unknown,\n): value is MCPAuthCredential =>\n  isRecord(value) &&\n  typeof value.strategy === \"string\" &&\n  (MCP_AUTH_STRATEGIES as readonly string[]).includes(value.strategy);\n"],"mappings":";AAiBA,IAAa,IAAsB;CACjC;CACA;CACA;CACA;CACA;CACA;AACF,GAEM,KAAY,MAChB,CAAC,CAAC,KAAS,OAAO,KAAU,YAAY,CAAC,MAAM,QAAQ,CAAK,GAEjD,KACX,MAEA,EAAS,CAAK,KACd,OAAO,EAAM,YAAa,YACzB,EAA0C,SAAS,EAAM,QAAQ"}

package/dist/types/mcp-server.d.ts

@@ -1,4 +1,4 @@
-import type { MCPTestFailureKind } from "@openhands/typescript-client";
+import type { AgentServerMCPOAuthStatusResponse, AgentServerMCPStartOAuthResponse, AgentServerMCPTestResponse, AgentServerMCPToolCall, AgentServerMCPToolCallResult, MCPTestFailureKind } from "@openhands/typescript-client";
 import type { MCPAuthCredential, MCPOAuthState } from "./mcp-auth";
 export type MCPServerType = "sse" | "stdio" | "shttp";
 export interface MCPServerConfig {
@@ -18,43 +18,28 @@ export interface MCPServerConfig {
      */
     enabled?: boolean;
 }
-export interface MCPTestToolCall {
-    name: string;
-    arguments: Record<string, unknown>;
-}
-export interface MCPTestToolResult {
-    is_error: boolean;
-    text: string;
-}
+export type MCPTestToolCall = AgentServerMCPToolCall;
+export type MCPTestToolResult = AgentServerMCPToolCallResult;
 export type ExtendedMCPTestFailureKind = MCPTestFailureKind | "credentials";
-export interface ExtendedMCPTestSuccess {
+type GeneratedMCPTestSuccess = Extract<AgentServerMCPTestResponse, {
+    ok?: true;
+}>;
+type GeneratedMCPTestFailure = Extract<AgentServerMCPTestResponse, {
+    error: string;
+}>;
+export type ExtendedMCPTestSuccess = Omit<GeneratedMCPTestSuccess, "ok" | "tools" | "oauth_state"> & {
     ok: true;
     tools: string[];
     tool_result?: MCPTestToolResult | null;
     oauth_state?: MCPOAuthState | null;
-}
-export interface ExtendedMCPTestFailure {
+};
+export type ExtendedMCPTestFailure = Omit<GeneratedMCPTestFailure, "ok" | "error_kind"> & {
     ok: false;
-    error: string;
     error_kind: ExtendedMCPTestFailureKind;
-}
+};
 export type ExtendedMCPTestResponse = ExtendedMCPTestSuccess | ExtendedMCPTestFailure;
-export interface MCPOAuthStartResponse {
-    ok: boolean;
-    job_id?: string | null;
-    authorization_url?: string | null;
-    error?: string | null;
-    error_kind?: MCPTestFailureKind | null;
-}
-export interface MCPOAuthStatusResponse {
-    ok: boolean;
-    status: "pending" | "authorizing" | "succeeded" | "failed";
-    job_id: string;
-    authorization_url?: string | null;
-    callback_ready?: boolean;
-    tools?: string[] | null;
-    tool_result?: MCPTestToolResult | null;
+export type MCPOAuthStartResponse = AgentServerMCPStartOAuthResponse;
+export type MCPOAuthStatusResponse = Omit<AgentServerMCPOAuthStatusResponse, "oauth_state"> & {
     oauth_state?: MCPOAuthState | null;
-    error?: string | null;
-    error_kind?: MCPTestFailureKind | null;
-}
+};
+export {};

package/dist/types/settings.d.ts

@@ -1,4 +1,6 @@
-import type { MCPAuthCredential } from "./mcp-auth";
+import type { MCPConfig } from "@openhands/typescript-client";
+export type { MCPConfig } from "@openhands/typescript-client";
+import type { SkillCategoryId } from "@openhands/extensions/skills";
 export declare const ProviderOptions: {
     readonly github: "github";
     readonly gitlab: "gitlab";
@@ -12,33 +14,6 @@ export type ProviderToken = {
     token: string;
     host: string | null;
 };
-export type MCPSSEServer = {
-    name?: string;
-    url: string;
-    headers?: Record<string, string>;
-    auth?: MCPAuthCredential;
-    enabled?: boolean;
-};
-export type MCPStdioServer = {
-    name: string;
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-    enabled?: boolean;
-};
-export type MCPSHTTPServer = {
-    name?: string;
-    url: string;
-    headers?: Record<string, string>;
-    timeout?: number;
-    auth?: MCPAuthCredential;
-    enabled?: boolean;
-};
-export type MCPConfig = {
-    sse_servers: (string | MCPSSEServer)[];
-    stdio_servers: MCPStdioServer[];
-    shttp_servers: (string | MCPSHTTPServer)[];
-};
 export type SettingsChoiceValue = boolean | number | string;
 export type SettingsChoice = {
     label: string;
@@ -79,6 +54,11 @@ export type SkillInfo = {
     source: string | null;
     description?: string | null;
     triggers?: string[];
+    /**
+     * Topical category from the bundled `@openhands/extensions` catalog.
+     * Always absent for user/project skills: the agent-server's `/api/skills` response drops SKILL.md frontmatter metadata, so a local `category` cannot reach us.
+     */
+    category?: SkillCategoryId | null;
     version?: string;
     license?: string | null;
     compatibility?: string | null;

package/dist/ui/card-title.d.ts

@@ -12,5 +12,5 @@ interface CardTitleProps extends VariantProps<typeof cardTitleVariants> {
     children: ReactNode;
     className?: string;
 }
-export declare function CardTitle({ icon, children, className, gap, textSize, fontWeight, textColor, lineHeight, }: CardTitleProps): import("react/jsx-runtime").JSX.Element;
+export declare function CardTitle({ icon, children, className, gap, textSize, fontWeight, textColor, lineHeight, }: CardTitleProps): import("react").JSX.Element;
 export {};

package/dist/ui/card.d.ts

@@ -10,5 +10,5 @@ interface CardProps extends VariantProps<typeof cardVariants> {
     className?: string;
     testId?: string;
 }
-export declare function Card({ children, className, testId, theme, hover, gradient, }: CardProps): import("react/jsx-runtime").JSX.Element;
+export declare function Card({ children, className, testId, theme, hover, gradient, }: CardProps): import("react").JSX.Element;
 export {};

package/dist/ui/combobox-caret.d.ts

@@ -1,6 +1,6 @@
 export declare function ComboboxCaretIcon({ className }: {
     className?: string;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 /** Matches HeroUI Autocomplete selectorButton styling. */
 export declare const comboboxCaretButtonClassName: string;
 /** HeroUI Autocomplete selectorButton slot — keep only chevron rotation animated. */
@@ -8,10 +8,10 @@ export declare const heroUiAutocompleteSelectorButtonClassName: string;
 interface ComboboxCaretButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     isOpen?: boolean;
 }
-export declare function ComboboxCaretButton({ isOpen, className, disabled, children, ...props }: ComboboxCaretButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ComboboxCaretButton({ isOpen, className, disabled, children, ...props }: ComboboxCaretButtonProps): import("react").JSX.Element;
 /** Inline caret for buttons where only the icon rotates, not the whole control. */
 export declare function ComboboxCaretInline({ isOpen, className, }: {
     isOpen?: boolean;
     className?: string;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export {};

package/dist/ui/context-menu.cjs

@@ -1,2 +1,2 @@
-const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../utils/utils.cjs"),n=require("../node_modules/class-variance-authority/dist/index.cjs"),r=require("../utils/dropdown-classes.cjs");let i=require("react");i=e.__toESM(i,1);let a=require("react/jsx-runtime");var o=n.cva(`z-50 overflow-hidden text-[var(--oh-foreground)]`,{variants:{theme:{default:`absolute rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg`,naked:`relative`,popover:`relative rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg`},size:{compact:`py-1 px-1`,default:``},layout:{vertical:t.cn(`flex flex-col`,r.dropdownMenuListGapClassName)},position:{top:`bottom-full`,bottom:`top-full`,none:``},spacing:{default:`mt-2`,none:``},alignment:{left:`left-0`,right:`right-0`,none:``}},compoundVariants:[{theme:`naked`,className:`shadow-none`}],defaultVariants:{theme:`default`,size:`default`,layout:`vertical`,spacing:`default`}});function s({testId:e,children:n,className:r,style:i,ref:s,theme:c,size:l,layout:u,position:d,spacing:f,alignment:p}){return(0,a.jsx)(`ul`,{"data-testid":e,"data-position":d,ref:s,style:i,className:t.cn(o({theme:c,size:l,layout:u,position:d,spacing:f,alignment:p}),r),children:n})}exports.ContextMenu=s;
+const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../utils/utils.cjs"),n=require("../node_modules/class-variance-authority/dist/index.cjs"),r=require("../utils/dropdown-classes.cjs");let i=require("react");i=e.__toESM(i,1);let a=require("react/jsx-runtime");var o=n.cva(`z-50 overflow-hidden text-[var(--oh-foreground)]`,{variants:{theme:{default:`absolute rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg`,naked:`relative`,popover:`relative rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg`},size:{compact:`py-1 px-1`,default:``},layout:{vertical:t.cn(`flex flex-col`,r.dropdownMenuListGapClassName)},position:{top:`bottom-full`,bottom:`top-full`,none:``},spacing:{default:`mt-2`,none:``},alignment:{left:`left-0`,right:`right-0`,none:``}},compoundVariants:[{theme:`naked`,className:`shadow-none`}],defaultVariants:{theme:`default`,size:`default`,layout:`vertical`,spacing:`default`}});function s({testId:e,children:n,className:r,style:i,onKeyDown:s,ref:c,theme:l,size:u,layout:d,position:f,spacing:p,alignment:m}){return(0,a.jsx)(`ul`,{"data-testid":e,"data-position":f,ref:c,style:i,onKeyDown:s,className:t.cn(o({theme:l,size:u,layout:d,position:f,spacing:p,alignment:m}),r),children:n})}exports.ContextMenu=s;
 //# sourceMappingURL=context-menu.cjs.map

package/dist/ui/context-menu.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"context-menu.cjs","names":[],"sources":["../../src/ui/context-menu.tsx"],"sourcesContent":["import React from \"react\";\nimport { cva, type VariantProps } from \"class-variance-authority\";\nimport { cn } from \"#/utils/utils\";\nimport { dropdownMenuListGapClassName } from \"#/utils/dropdown-classes\";\n\nconst contextMenuVariants = cva(\n  \"z-50 overflow-hidden text-[var(--oh-foreground)]\",\n  {\n    variants: {\n      theme: {\n        default:\n          \"absolute rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg\",\n        naked: \"relative\",\n        /** In document-body portal; coordinates come from inline `style`. */\n        popover:\n          \"relative rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg\",\n      },\n      size: {\n        compact: \"py-1 px-1\",\n        default: \"\",\n      },\n      layout: {\n        vertical: cn(\"flex flex-col\", dropdownMenuListGapClassName),\n      },\n      position: {\n        top: \"bottom-full\",\n        bottom: \"top-full\",\n        none: \"\",\n      },\n      spacing: {\n        default: \"mt-2\",\n        none: \"\",\n      },\n      alignment: {\n        left: \"left-0\",\n        right: \"right-0\",\n        none: \"\",\n      },\n    },\n    compoundVariants: [\n      {\n        theme: \"naked\",\n        className: \"shadow-none\",\n      },\n    ],\n    defaultVariants: {\n      theme: \"default\",\n      size: \"default\",\n      layout: \"vertical\",\n      spacing: \"default\",\n    },\n  },\n);\n\ninterface ContextMenuProps {\n  ref?: React.RefObject<HTMLUListElement | null>;\n  testId?: string;\n  children: React.ReactNode;\n  className?: React.HTMLAttributes<HTMLUListElement>[\"className\"];\n  style?: React.CSSProperties;\n  theme?: VariantProps<typeof contextMenuVariants>[\"theme\"];\n  size?: VariantProps<typeof contextMenuVariants>[\"size\"];\n  layout?: VariantProps<typeof contextMenuVariants>[\"layout\"];\n  position?: VariantProps<typeof contextMenuVariants>[\"position\"];\n  spacing?: VariantProps<typeof contextMenuVariants>[\"spacing\"];\n  alignment?: VariantProps<typeof contextMenuVariants>[\"alignment\"];\n}\n\nexport function ContextMenu({\n  testId,\n  children,\n  className,\n  style,\n  ref,\n  theme,\n  size,\n  layout,\n  position,\n  spacing,\n  alignment,\n}: ContextMenuProps) {\n  return (\n    <ul\n      data-testid={testId}\n      data-position={position}\n      ref={ref}\n      style={style}\n      className={cn(\n        contextMenuVariants({\n          theme,\n          size,\n          layout,\n          position,\n          spacing,\n          alignment,\n        }),\n        className,\n      )}\n    >\n      {children}\n    </ul>\n  );\n}\n"],"mappings":"gRAKA,IAAM,EAAsB,EAAA,IAC1B,mDACA,CACE,SAAU,CACR,MAAO,CACL,QACE,8FACF,MAAO,WAEP,QACE,6FACJ,EACA,KAAM,CACJ,QAAS,YACT,QAAS,EACX,EACA,OAAQ,CACN,SAAU,EAAA,GAAG,gBAAiB,EAAA,4BAA4B,CAC5D,EACA,SAAU,CACR,IAAK,cACL,OAAQ,WACR,KAAM,EACR,EACA,QAAS,CACP,QAAS,OACT,KAAM,EACR,EACA,UAAW,CACT,KAAM,SACN,MAAO,UACP,KAAM,EACR,CACF,EACA,iBAAkB,CAChB,CACE,MAAO,QACP,UAAW,aACb,CACF,EACA,gBAAiB,CACf,MAAO,UACP,KAAM,UACN,OAAQ,WACR,QAAS,SACX,CACF,CACF,EAgBA,SAAgB,EAAY,CAC1B,SACA,WACA,YACA,QACA,MACA,QACA,OACA,SACA,WACA,UACA,aACmB,CACnB,OACE,EAAA,EAAA,KAAC,KAAD,CACE,cAAa,EACb,gBAAe,EACV,MACE,QACP,UAAW,EAAA,GACT,EAAoB,CAClB,QACA,OACA,SACA,WACA,UACA,WACF,CAAC,EACD,CACF,EAEC,UACC,CAAA,CAER"}
+{"version":3,"file":"context-menu.cjs","names":[],"sources":["../../src/ui/context-menu.tsx"],"sourcesContent":["import React from \"react\";\nimport { cva, type VariantProps } from \"class-variance-authority\";\nimport { cn } from \"#/utils/utils\";\nimport { dropdownMenuListGapClassName } from \"#/utils/dropdown-classes\";\n\nconst contextMenuVariants = cva(\n  \"z-50 overflow-hidden text-[var(--oh-foreground)]\",\n  {\n    variants: {\n      theme: {\n        default:\n          \"absolute rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg\",\n        naked: \"relative\",\n        /** In document-body portal; coordinates come from inline `style`. */\n        popover:\n          \"relative rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg\",\n      },\n      size: {\n        compact: \"py-1 px-1\",\n        default: \"\",\n      },\n      layout: {\n        vertical: cn(\"flex flex-col\", dropdownMenuListGapClassName),\n      },\n      position: {\n        top: \"bottom-full\",\n        bottom: \"top-full\",\n        none: \"\",\n      },\n      spacing: {\n        default: \"mt-2\",\n        none: \"\",\n      },\n      alignment: {\n        left: \"left-0\",\n        right: \"right-0\",\n        none: \"\",\n      },\n    },\n    compoundVariants: [\n      {\n        theme: \"naked\",\n        className: \"shadow-none\",\n      },\n    ],\n    defaultVariants: {\n      theme: \"default\",\n      size: \"default\",\n      layout: \"vertical\",\n      spacing: \"default\",\n    },\n  },\n);\n\ninterface ContextMenuProps {\n  ref?: React.RefObject<HTMLUListElement | null>;\n  testId?: string;\n  children: React.ReactNode;\n  className?: React.HTMLAttributes<HTMLUListElement>[\"className\"];\n  style?: React.CSSProperties;\n  onKeyDown?: React.KeyboardEventHandler<HTMLUListElement>;\n  theme?: VariantProps<typeof contextMenuVariants>[\"theme\"];\n  size?: VariantProps<typeof contextMenuVariants>[\"size\"];\n  layout?: VariantProps<typeof contextMenuVariants>[\"layout\"];\n  position?: VariantProps<typeof contextMenuVariants>[\"position\"];\n  spacing?: VariantProps<typeof contextMenuVariants>[\"spacing\"];\n  alignment?: VariantProps<typeof contextMenuVariants>[\"alignment\"];\n}\n\nexport function ContextMenu({\n  testId,\n  children,\n  className,\n  style,\n  onKeyDown,\n  ref,\n  theme,\n  size,\n  layout,\n  position,\n  spacing,\n  alignment,\n}: ContextMenuProps) {\n  return (\n    // Keyboard navigation is opt-in via `onKeyDown` (home automation kebab).\n    // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- popup list hosts Escape/arrow handlers when provided\n    <ul\n      data-testid={testId}\n      data-position={position}\n      ref={ref}\n      style={style}\n      onKeyDown={onKeyDown}\n      className={cn(\n        contextMenuVariants({\n          theme,\n          size,\n          layout,\n          position,\n          spacing,\n          alignment,\n        }),\n        className,\n      )}\n    >\n      {children}\n    </ul>\n  );\n}\n"],"mappings":"gRAKA,IAAM,EAAsB,EAAA,IAC1B,mDACA,CACE,SAAU,CACR,MAAO,CACL,QACE,8FACF,MAAO,WAEP,QACE,6FACJ,EACA,KAAM,CACJ,QAAS,YACT,QAAS,EACX,EACA,OAAQ,CACN,SAAU,EAAA,GAAG,gBAAiB,EAAA,4BAA4B,CAC5D,EACA,SAAU,CACR,IAAK,cACL,OAAQ,WACR,KAAM,EACR,EACA,QAAS,CACP,QAAS,OACT,KAAM,EACR,EACA,UAAW,CACT,KAAM,SACN,MAAO,UACP,KAAM,EACR,CACF,EACA,iBAAkB,CAChB,CACE,MAAO,QACP,UAAW,aACb,CACF,EACA,gBAAiB,CACf,MAAO,UACP,KAAM,UACN,OAAQ,WACR,QAAS,SACX,CACF,CACF,EAiBA,SAAgB,EAAY,CAC1B,SACA,WACA,YACA,QACA,YACA,MACA,QACA,OACA,SACA,WACA,UACA,aACmB,CACnB,OAGE,EAAA,EAAA,KAAC,KAAD,CACE,cAAa,EACb,gBAAe,EACV,MACE,QACI,YACX,UAAW,EAAA,GACT,EAAoB,CAClB,QACA,OACA,SACA,WACA,UACA,WACF,CAAC,EACD,CACF,EAEC,UACC,CAAA,CAER"}

package/dist/ui/context-menu.d.ts

@@ -5,7 +5,7 @@ declare const contextMenuVariants: (props?: ({
     size?: "default" | "compact" | null | undefined;
     layout?: "vertical" | null | undefined;
     position?: "none" | "bottom" | "top" | null | undefined;
-    spacing?: "none" | "default" | null | undefined;
+    spacing?: "default" | "none" | null | undefined;
     alignment?: "none" | "left" | "right" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface ContextMenuProps {
@@ -14,6 +14,7 @@ interface ContextMenuProps {
     children: React.ReactNode;
     className?: React.HTMLAttributes<HTMLUListElement>["className"];
     style?: React.CSSProperties;
+    onKeyDown?: React.KeyboardEventHandler<HTMLUListElement>;
     theme?: VariantProps<typeof contextMenuVariants>["theme"];
     size?: VariantProps<typeof contextMenuVariants>["size"];
     layout?: VariantProps<typeof contextMenuVariants>["layout"];
@@ -21,5 +22,5 @@ interface ContextMenuProps {
     spacing?: VariantProps<typeof contextMenuVariants>["spacing"];
     alignment?: VariantProps<typeof contextMenuVariants>["alignment"];
 }
-export declare function ContextMenu({ testId, children, className, style, ref, theme, size, layout, position, spacing, alignment, }: ContextMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function ContextMenu({ testId, children, className, style, onKeyDown, ref, theme, size, layout, position, spacing, alignment, }: ContextMenuProps): React.JSX.Element;
 export {};

package/dist/ui/context-menu.js

@@ -42,19 +42,20 @@ var i = t("z-50 overflow-hidden text-[var(--oh-foreground)]", {
 		spacing: "default"
 	}
 });
-function a({ testId: t, children: n, className: a, style: o, ref: s, theme: c, size: l, layout: u, position: d, spacing: f, alignment: p }) {
+function a({ testId: t, children: n, className: a, style: o, onKeyDown: s, ref: c, theme: l, size: u, layout: d, position: f, spacing: p, alignment: m }) {
 	return /* @__PURE__ */ r("ul", {
 		"data-testid": t,
-		"data-position": d,
-		ref: s,
+		"data-position": f,
+		ref: c,
 		style: o,
+		onKeyDown: s,
 		className: e(i({
-			theme: c,
-			size: l,
-			layout: u,
-			position: d,
-			spacing: f,
-			alignment: p
+			theme: l,
+			size: u,
+			layout: d,
+			position: f,
+			spacing: p,
+			alignment: m
 		}), a),
 		children: n
 	});

package/dist/ui/context-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-menu.js","names":[],"sources":["../../src/ui/context-menu.tsx"],"sourcesContent":["import React from \"react\";\nimport { cva, type VariantProps } from \"class-variance-authority\";\nimport { cn } from \"#/utils/utils\";\nimport { dropdownMenuListGapClassName } from \"#/utils/dropdown-classes\";\n\nconst contextMenuVariants = cva(\n  \"z-50 overflow-hidden text-[var(--oh-foreground)]\",\n  {\n    variants: {\n      theme: {\n        default:\n          \"absolute rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg\",\n        naked: \"relative\",\n        /** In document-body portal; coordinates come from inline `style`. */\n        popover:\n          \"relative rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg\",\n      },\n      size: {\n        compact: \"py-1 px-1\",\n        default: \"\",\n      },\n      layout: {\n        vertical: cn(\"flex flex-col\", dropdownMenuListGapClassName),\n      },\n      position: {\n        top: \"bottom-full\",\n        bottom: \"top-full\",\n        none: \"\",\n      },\n      spacing: {\n        default: \"mt-2\",\n        none: \"\",\n      },\n      alignment: {\n        left: \"left-0\",\n        right: \"right-0\",\n        none: \"\",\n      },\n    },\n    compoundVariants: [\n      {\n        theme: \"naked\",\n        className: \"shadow-none\",\n      },\n    ],\n    defaultVariants: {\n      theme: \"default\",\n      size: \"default\",\n      layout: \"vertical\",\n      spacing: \"default\",\n    },\n  },\n);\n\ninterface ContextMenuProps {\n  ref?: React.RefObject<HTMLUListElement | null>;\n  testId?: string;\n  children: React.ReactNode;\n  className?: React.HTMLAttributes<HTMLUListElement>[\"className\"];\n  style?: React.CSSProperties;\n  theme?: VariantProps<typeof contextMenuVariants>[\"theme\"];\n  size?: VariantProps<typeof contextMenuVariants>[\"size\"];\n  layout?: VariantProps<typeof contextMenuVariants>[\"layout\"];\n  position?: VariantProps<typeof contextMenuVariants>[\"position\"];\n  spacing?: VariantProps<typeof contextMenuVariants>[\"spacing\"];\n  alignment?: VariantProps<typeof contextMenuVariants>[\"alignment\"];\n}\n\nexport function ContextMenu({\n  testId,\n  children,\n  className,\n  style,\n  ref,\n  theme,\n  size,\n  layout,\n  position,\n  spacing,\n  alignment,\n}: ContextMenuProps) {\n  return (\n    <ul\n      data-testid={testId}\n      data-position={position}\n      ref={ref}\n      style={style}\n      className={cn(\n        contextMenuVariants({\n          theme,\n          size,\n          layout,\n          position,\n          spacing,\n          alignment,\n        }),\n        className,\n      )}\n    >\n      {children}\n    </ul>\n  );\n}\n"],"mappings":";;;;;;AAKA,IAAM,IAAsB,EAC1B,oDACA;CACE,UAAU;EACR,OAAO;GACL,SACE;GACF,OAAO;GAEP,SACE;EACJ;EACA,MAAM;GACJ,SAAS;GACT,SAAS;EACX;EACA,QAAQ,EACN,UAAU,EAAG,iBAAiB,CAA4B,EAC5D;EACA,UAAU;GACR,KAAK;GACL,QAAQ;GACR,MAAM;EACR;EACA,SAAS;GACP,SAAS;GACT,MAAM;EACR;EACA,WAAW;GACT,MAAM;GACN,OAAO;GACP,MAAM;EACR;CACF;CACA,kBAAkB,CAChB;EACE,OAAO;EACP,WAAW;CACb,CACF;CACA,iBAAiB;EACf,OAAO;EACP,MAAM;EACN,QAAQ;EACR,SAAS;CACX;AACF,CACF;AAgBA,SAAgB,EAAY,EAC1B,WACA,aACA,cACA,UACA,QACA,UACA,SACA,WACA,aACA,YACA,gBACmB;CACnB,OACE,kBAAC,MAAD;EACE,eAAa;EACb,iBAAe;EACV;EACE;EACP,WAAW,EACT,EAAoB;GAClB;GACA;GACA;GACA;GACA;GACA;EACF,CAAC,GACD,CACF;EAEC;CACC,CAAA;AAER"}
+{"version":3,"file":"context-menu.js","names":[],"sources":["../../src/ui/context-menu.tsx"],"sourcesContent":["import React from \"react\";\nimport { cva, type VariantProps } from \"class-variance-authority\";\nimport { cn } from \"#/utils/utils\";\nimport { dropdownMenuListGapClassName } from \"#/utils/dropdown-classes\";\n\nconst contextMenuVariants = cva(\n  \"z-50 overflow-hidden text-[var(--oh-foreground)]\",\n  {\n    variants: {\n      theme: {\n        default:\n          \"absolute rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg\",\n        naked: \"relative\",\n        /** In document-body portal; coordinates come from inline `style`. */\n        popover:\n          \"relative rounded-md border border-[var(--oh-border-subtle)] bg-tertiary px-1 py-1 shadow-lg\",\n      },\n      size: {\n        compact: \"py-1 px-1\",\n        default: \"\",\n      },\n      layout: {\n        vertical: cn(\"flex flex-col\", dropdownMenuListGapClassName),\n      },\n      position: {\n        top: \"bottom-full\",\n        bottom: \"top-full\",\n        none: \"\",\n      },\n      spacing: {\n        default: \"mt-2\",\n        none: \"\",\n      },\n      alignment: {\n        left: \"left-0\",\n        right: \"right-0\",\n        none: \"\",\n      },\n    },\n    compoundVariants: [\n      {\n        theme: \"naked\",\n        className: \"shadow-none\",\n      },\n    ],\n    defaultVariants: {\n      theme: \"default\",\n      size: \"default\",\n      layout: \"vertical\",\n      spacing: \"default\",\n    },\n  },\n);\n\ninterface ContextMenuProps {\n  ref?: React.RefObject<HTMLUListElement | null>;\n  testId?: string;\n  children: React.ReactNode;\n  className?: React.HTMLAttributes<HTMLUListElement>[\"className\"];\n  style?: React.CSSProperties;\n  onKeyDown?: React.KeyboardEventHandler<HTMLUListElement>;\n  theme?: VariantProps<typeof contextMenuVariants>[\"theme\"];\n  size?: VariantProps<typeof contextMenuVariants>[\"size\"];\n  layout?: VariantProps<typeof contextMenuVariants>[\"layout\"];\n  position?: VariantProps<typeof contextMenuVariants>[\"position\"];\n  spacing?: VariantProps<typeof contextMenuVariants>[\"spacing\"];\n  alignment?: VariantProps<typeof contextMenuVariants>[\"alignment\"];\n}\n\nexport function ContextMenu({\n  testId,\n  children,\n  className,\n  style,\n  onKeyDown,\n  ref,\n  theme,\n  size,\n  layout,\n  position,\n  spacing,\n  alignment,\n}: ContextMenuProps) {\n  return (\n    // Keyboard navigation is opt-in via `onKeyDown` (home automation kebab).\n    // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- popup list hosts Escape/arrow handlers when provided\n    <ul\n      data-testid={testId}\n      data-position={position}\n      ref={ref}\n      style={style}\n      onKeyDown={onKeyDown}\n      className={cn(\n        contextMenuVariants({\n          theme,\n          size,\n          layout,\n          position,\n          spacing,\n          alignment,\n        }),\n        className,\n      )}\n    >\n      {children}\n    </ul>\n  );\n}\n"],"mappings":";;;;;;AAKA,IAAM,IAAsB,EAC1B,oDACA;CACE,UAAU;EACR,OAAO;GACL,SACE;GACF,OAAO;GAEP,SACE;EACJ;EACA,MAAM;GACJ,SAAS;GACT,SAAS;EACX;EACA,QAAQ,EACN,UAAU,EAAG,iBAAiB,CAA4B,EAC5D;EACA,UAAU;GACR,KAAK;GACL,QAAQ;GACR,MAAM;EACR;EACA,SAAS;GACP,SAAS;GACT,MAAM;EACR;EACA,WAAW;GACT,MAAM;GACN,OAAO;GACP,MAAM;EACR;CACF;CACA,kBAAkB,CAChB;EACE,OAAO;EACP,WAAW;CACb,CACF;CACA,iBAAiB;EACf,OAAO;EACP,MAAM;EACN,QAAQ;EACR,SAAS;CACX;AACF,CACF;AAiBA,SAAgB,EAAY,EAC1B,WACA,aACA,cACA,UACA,cACA,QACA,UACA,SACA,WACA,aACA,YACA,gBACmB;CACnB,OAGE,kBAAC,MAAD;EACE,eAAa;EACb,iBAAe;EACV;EACE;EACI;EACX,WAAW,EACT,EAAoB;GAClB;GACA;GACA;GACA;GACA;GACA;EACF,CAAC,GACD,CACF;EAEC;CACC,CAAA;AAER"}