@openhands/agent-canvas 1.4.0 → 1.5.1

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

@@ -1,8 +1,9 @@
+import { CANVAS_UI_CLIENT_ACTION_KIND } from "#/constants/canvas-ui";
 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";
-type ObservationEventType = `${ObservationOnlyType}Observation` | `${EventType}Observation` | "TerminalObservation" | "GlobObservation" | "GrepObservation" | "TaskObservation" | "CanvasUIObservation";
+type ActionEventType = `${ActionOnlyType}Action` | `${EventType}Action` | "GlobAction" | "GrepAction" | "TaskAction" | typeof CANVAS_UI_CLIENT_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/core/base/observation.d.ts

@@ -304,7 +304,7 @@ export interface TaskObservation extends ObservationBase<"TaskObservation"> {
      */
     status: string;
 }
-export interface CanvasUIObservation extends ObservationBase<"CanvasUIObservation"> {
+export interface CanvasUIObservation extends ObservationBase<"CanvasUIObservation" | "ClientToolObservation"> {
     /**
      * Acknowledgement text returned after the canvas UI command is dispatched.
      */

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

@@ -1,2 +1,2 @@
-require(`../../_virtual/_rolldown/runtime.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`,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`);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;
 //# 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  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 the canvas_ui custom tool's ActionEvent.\n *\n * The tool is injected via tool_module_qualnames (see canvas_ui_tool.py and\n * agent-server-adapter.ts). We discriminate on tool_name (which we control\n * via register_tool(\"canvas_ui\", ...)). The predicate narrows the event so\n * the call site can read `event.action.command` etc. without further casts.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) && event.tool_name === \"canvas_ui\";\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":"gDAoCA,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,QAOvB,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,EAAM,EAAI,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,EAAM,GACnB,EAAM,OAAO,OAAS,qBACrB,EAAM,OAAO,OAAS,kBAKb,EACX,GAEA,EAAmB,EAAM,GACxB,EAAM,YAAY,OAAS,0BAC1B,EAAM,YAAY,OAAS,uBAKlB,EACX,GAEA,EAAmB,EAAM,EACzB,EAAM,YAAY,OAAS,gCAKhB,EACX,GAEA,EAAmB,EAAM,EAAI,EAAM,YAAY,OAAS,qBAK7C,EACX,GAEA,EAAmB,EAAM,EACzB,EAAM,YAAY,OAAS,uBAKhB,EACX,GAEA,EAAc,EAAM,EAAI,EAAM,OAAO,OAAS,wBAUnC,EACX,GAEA,EAAc,EAAM,EAAI,EAAM,YAAc,YAKjC,EACX,GAEA,EAAM,SAAW,SACjB,kBAAmB,GACnB,UAAW,GACX,OAAO,EAAM,eAAkB,UAC/B,MAAM,QAAQ,EAAM,MAAM,CAKf,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,EAAM,EAAI,EAAmB,EAAM,CAKjD,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,EAAM"}
+{"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,QAOvB,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,EAAM,EAAI,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,EAAM,GACnB,EAAM,OAAO,OAAS,qBACrB,EAAM,OAAO,OAAS,kBAKb,EACX,GAEA,EAAmB,EAAM,GACxB,EAAM,YAAY,OAAS,0BAC1B,EAAM,YAAY,OAAS,uBAKlB,EACX,GAEA,EAAmB,EAAM,EACzB,EAAM,YAAY,OAAS,gCAKhB,EACX,GAEA,EAAmB,EAAM,EAAI,EAAM,YAAY,OAAS,qBAK7C,EACX,GAEA,EAAmB,EAAM,EACzB,EAAM,YAAY,OAAS,uBAKhB,EACX,GAEA,EAAc,EAAM,EAAI,EAAM,OAAO,OAAS,wBAQnC,EACX,GAEA,EAAc,EAAM,GACnB,EAAM,YAAA,aACL,EAAM,YAAA,qBAKG,EACX,GAEA,EAAM,SAAW,SACjB,kBAAmB,GACnB,UAAW,GACX,OAAO,EAAM,eAAkB,UAC/B,MAAM,QAAQ,EAAM,MAAM,CAKf,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,EAAM,EAAI,EAAmB,EAAM,CAKjD,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,EAAM"}

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

@@ -58,12 +58,10 @@ export declare const isSwitchLLMObservationEvent: (event: OpenHandsEvent) => eve
  */
 export declare const isBrowserNavigateActionEvent: (event: OpenHandsEvent) => event is ActionEvent<BrowserNavigateAction>;
 /**
- * Type guard for the canvas_ui custom tool's ActionEvent.
+ * Type guard for Canvas UI tool ActionEvents.
  *
- * The tool is injected via tool_module_qualnames (see canvas_ui_tool.py and
- * agent-server-adapter.ts). We discriminate on tool_name (which we control
- * via register_tool("canvas_ui", ...)). The predicate narrows the event so
- * the call site can read `event.action.command` etc. without further casts.
+ * Discriminating on tool_name supports legacy CanvasUIAction events and the
+ * SDK-generated action kind without leaking that generated name here.
  */
 export declare const isCanvasUIActionEvent: (event: OpenHandsEvent) => event is ActionEvent<CanvasUIAction>;
 /**

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

@@ -1,8 +1,9 @@
+import "../../constants/canvas-ui.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", 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";
+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);
 }

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  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 the canvas_ui custom tool's ActionEvent.\n *\n * The tool is injected via tool_module_qualnames (see canvas_ui_tool.py and\n * agent-server-adapter.ts). We discriminate on tool_name (which we control\n * via register_tool(\"canvas_ui\", ...)). The predicate narrows the event so\n * the call site can read `event.action.command` etc. without further casts.\n */\nexport const isCanvasUIActionEvent = (\n  event: OpenHandsEvent,\n): event is ActionEvent<CanvasUIAction> =>\n  isActionEvent(event) && event.tool_name === \"canvas_ui\";\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":";AAoCA,SAAgB,EAAY,GAAoC;AAC9D,QAEE,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;;AAOvB,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,EAAM,IAAI,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,EAAM,KACnB,EAAM,OAAO,SAAS,uBACrB,EAAM,OAAO,SAAS,mBAKb,KACX,MAEA,EAAmB,EAAM,KACxB,EAAM,YAAY,SAAS,4BAC1B,EAAM,YAAY,SAAS,wBAKlB,KACX,MAEA,EAAmB,EAAM,IACzB,EAAM,YAAY,SAAS,iCAKhB,KACX,MAEA,EAAmB,EAAM,IAAI,EAAM,YAAY,SAAS,sBAK7C,KACX,MAEA,EAAmB,EAAM,IACzB,EAAM,YAAY,SAAS,wBAKhB,KACX,MAEA,EAAc,EAAM,IAAI,EAAM,OAAO,SAAS,yBAUnC,KACX,MAEA,EAAc,EAAM,IAAI,EAAM,cAAc,aAKjC,KACX,MAEA,EAAM,WAAW,WACjB,mBAAmB,KACnB,WAAW,KACX,OAAO,EAAM,iBAAkB,YAC/B,MAAM,QAAQ,EAAM,MAAM,EAKf,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,EAAM,IAAI,EAAmB,EAAM,EAKjD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,sBAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAEvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS;AAUpC,SAAgB,EAAmB,GAAyC;AAC1E,QAAO,EAAY,EAAM"}
+{"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;AAC9D,QAEE,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;;AAOvB,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,EAAM,IAAI,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,EAAM,KACnB,EAAM,OAAO,SAAS,uBACrB,EAAM,OAAO,SAAS,mBAKb,KACX,MAEA,EAAmB,EAAM,KACxB,EAAM,YAAY,SAAS,4BAC1B,EAAM,YAAY,SAAS,wBAKlB,KACX,MAEA,EAAmB,EAAM,IACzB,EAAM,YAAY,SAAS,iCAKhB,KACX,MAEA,EAAmB,EAAM,IAAI,EAAM,YAAY,SAAS,sBAK7C,KACX,MAEA,EAAmB,EAAM,IACzB,EAAM,YAAY,SAAS,wBAKhB,KACX,MAEA,EAAc,EAAM,IAAI,EAAM,OAAO,SAAS,yBAQnC,KACX,MAEA,EAAc,EAAM,KACnB,EAAM,cAAA,eACL,EAAM,cAAA,sBAKG,KACX,MAEA,EAAM,WAAW,WACjB,mBAAmB,KACnB,WAAW,KACX,OAAO,EAAM,iBAAkB,YAC/B,MAAM,QAAQ,EAAM,MAAM,EAKf,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,EAAM,IAAI,EAAmB,EAAM,EAKjD,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,sBAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS,oBAEvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS;AAUpC,SAAgB,EAAmB,GAAyC;AAC1E,QAAO,EAAY,EAAM"}

package/dist/types/automation.d.ts

@@ -28,6 +28,11 @@ export interface Automation {
     repository?: string;
     /** LLM/model profile name used for automation runs. */
     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).
+     */
+    timeout?: number | null;
     created_at: string;
     updated_at: string;
     prompt: string | null;

package/dist/utils/api-error-message.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extract a human-readable message from a failed API call.
+ *
+ * Handles both transports the app uses: local agent-server calls that
+ * throw an `AxiosError` (body under `error.response.data`) and cloud
+ * calls through the shared TypeScript client that throw an `HttpError`
+ * (parsed body directly under `error.response`). Prefers the
+ * server-provided `message`/`detail` fields, then the `Error` message,
+ * then `fallback`.
+ */
+export declare function getApiErrorMessage(error: unknown, fallback: string): string;

package/dist/utils/automation-timeout.d.ts

@@ -0,0 +1,19 @@
+import { I18nKey } from "#/i18n/declaration";
+/**
+ * Per-automation run timeout bounds. These mirror the automation server
+ * (`openhands/automation/utils/timeout.py`): a `null`/omitted timeout falls back
+ * to the default, and the server rejects anything above the maximum.
+ */
+export declare const AUTOMATION_TIMEOUT_DEFAULT_SECONDS = 600;
+export declare const AUTOMATION_TIMEOUT_MAX_SECONDS = 1800;
+export type AutomationTimeoutValidation = {
+    value: number | null;
+} | {
+    errorKey: I18nKey;
+};
+/**
+ * Validate a raw timeout string from the edit form. A blank string means "use
+ * the server default" (resolved as `null`). Otherwise the value must be a
+ * positive integer no greater than {@link AUTOMATION_TIMEOUT_MAX_SECONDS}.
+ */
+export declare function validateAutomationTimeout(raw: string): AutomationTimeoutValidation;

package/dist/utils/base-path.cjs

@@ -0,0 +1,2 @@
+require(`../_virtual/_rolldown/runtime.cjs`);var e=`__AGENT_CANVAS_BASE_PATH__`;function t(e){let t=e?.trim();return!t||t===`/`?``:(t.startsWith(`/`)?t:`/${t}`).replace(/\/+$/,``)}function n(){let n=t(void 0);if(n)return n;if(typeof window<`u`){let n=window[e];if(typeof n==`string`)return t(n)}return``}function r(e){let t=n();return t?`${t}${e.startsWith(`/`)?e:`/${e}`}`:e.startsWith(`/`)?e:`/${e}`}exports.buildAgentCanvasPath=r;
+//# sourceMappingURL=base-path.cjs.map

package/dist/utils/base-path.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-path.cjs","names":[],"sources":["../../src/utils/base-path.ts"],"sourcesContent":["const BASE_PATH_WINDOW_KEY = \"__AGENT_CANVAS_BASE_PATH__\";\n\nfunction normalizeBasePath(value?: string | null): string {\n  const raw = value?.trim();\n  if (!raw || raw === \"/\") return \"\";\n\n  const withLeadingSlash = raw.startsWith(\"/\") ? raw : `/${raw}`;\n  return withLeadingSlash.replace(/\\/+$/, \"\");\n}\n\nexport function getAgentCanvasBasePath(): string {\n  const envPath = normalizeBasePath(import.meta.env.VITE_BASE_PATH);\n  if (envPath) return envPath;\n\n  if (typeof window !== \"undefined\") {\n    const injected = (window as unknown as Record<string, unknown>)[\n      BASE_PATH_WINDOW_KEY\n    ];\n    if (typeof injected === \"string\") {\n      return normalizeBasePath(injected);\n    }\n  }\n\n  return \"\";\n}\n\nexport function buildAgentCanvasPath(path: string): string {\n  const basePath = getAgentCanvasBasePath();\n  if (!basePath) return path.startsWith(\"/\") ? path : `/${path}`;\n\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${basePath}${normalizedPath}`;\n}\n"],"mappings":"6CAAA,IAAM,EAAuB,6BAE7B,SAAS,EAAkB,EAA+B,CACxD,IAAM,EAAM,GAAO,MAAM,CAIzB,MAHI,CAAC,GAAO,IAAQ,IAAY,IAEP,EAAI,WAAW,IAAI,CAAG,EAAM,IAAI,KACjC,QAAQ,OAAQ,GAAG,CAG7C,SAAgB,GAAiC,CAC/C,IAAM,EAAU,EAAA,IAAA,GAAiD,CACjE,GAAI,EAAS,OAAO,EAEpB,GAAI,OAAO,OAAW,IAAa,CACjC,IAAM,EAAY,OAChB,GAEF,GAAI,OAAO,GAAa,SACtB,OAAO,EAAkB,EAAS,CAItC,MAAO,GAGT,SAAgB,EAAqB,EAAsB,CACzD,IAAM,EAAW,GAAwB,CAIzC,OAHK,EAGE,GAAG,IADa,EAAK,WAAW,IAAI,CAAG,EAAO,IAAI,MAFnC,EAAK,WAAW,IAAI,CAAG,EAAO,IAAI"}

package/dist/utils/base-path.d.ts

@@ -0,0 +1,2 @@
+export declare function getAgentCanvasBasePath(): string;
+export declare function buildAgentCanvasPath(path: string): string;

package/dist/utils/base-path.js

@@ -0,0 +1,23 @@
+//#region src/utils/base-path.ts
+var e = "__AGENT_CANVAS_BASE_PATH__";
+function t(e) {
+	let t = e?.trim();
+	return !t || t === "/" ? "" : (t.startsWith("/") ? t : `/${t}`).replace(/\/+$/, "");
+}
+function n() {
+	let n = t(void 0);
+	if (n) return n;
+	if (typeof window < "u") {
+		let n = window[e];
+		if (typeof n == "string") return t(n);
+	}
+	return "";
+}
+function r(e) {
+	let t = n();
+	return t ? `${t}${e.startsWith("/") ? e : `/${e}`}` : e.startsWith("/") ? e : `/${e}`;
+}
+//#endregion
+export { r as buildAgentCanvasPath };
+
+//# sourceMappingURL=base-path.js.map

package/dist/utils/base-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-path.js","names":[],"sources":["../../src/utils/base-path.ts"],"sourcesContent":["const BASE_PATH_WINDOW_KEY = \"__AGENT_CANVAS_BASE_PATH__\";\n\nfunction normalizeBasePath(value?: string | null): string {\n  const raw = value?.trim();\n  if (!raw || raw === \"/\") return \"\";\n\n  const withLeadingSlash = raw.startsWith(\"/\") ? raw : `/${raw}`;\n  return withLeadingSlash.replace(/\\/+$/, \"\");\n}\n\nexport function getAgentCanvasBasePath(): string {\n  const envPath = normalizeBasePath(import.meta.env.VITE_BASE_PATH);\n  if (envPath) return envPath;\n\n  if (typeof window !== \"undefined\") {\n    const injected = (window as unknown as Record<string, unknown>)[\n      BASE_PATH_WINDOW_KEY\n    ];\n    if (typeof injected === \"string\") {\n      return normalizeBasePath(injected);\n    }\n  }\n\n  return \"\";\n}\n\nexport function buildAgentCanvasPath(path: string): string {\n  const basePath = getAgentCanvasBasePath();\n  if (!basePath) return path.startsWith(\"/\") ? path : `/${path}`;\n\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\n  return `${basePath}${normalizedPath}`;\n}\n"],"mappings":";AAAA,IAAM,IAAuB;AAE7B,SAAS,EAAkB,GAA+B;CACxD,IAAM,IAAM,GAAO,MAAM;AAIzB,QAHI,CAAC,KAAO,MAAQ,MAAY,MAEP,EAAI,WAAW,IAAI,GAAG,IAAM,IAAI,KACjC,QAAQ,QAAQ,GAAG;;AAG7C,SAAgB,IAAiC;CAC/C,IAAM,IAAU,EAAA,KAAA,EAAiD;AACjE,KAAI,EAAS,QAAO;AAEpB,KAAI,OAAO,SAAW,KAAa;EACjC,IAAM,IAAY,OAChB;AAEF,MAAI,OAAO,KAAa,SACtB,QAAO,EAAkB,EAAS;;AAItC,QAAO;;AAGT,SAAgB,EAAqB,GAAsB;CACzD,IAAM,IAAW,GAAwB;AAIzC,QAHK,IAGE,GAAG,IADa,EAAK,WAAW,IAAI,GAAG,IAAO,IAAI,QAFnC,EAAK,WAAW,IAAI,GAAG,IAAO,IAAI"}

package/dist/utils/error-handler.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);function e({message:e,source:t,metadata:n={},posthog:r}){if(!r)return;let i=Error(e);r.captureException(i,{error_source:t||`unknown`,...n})}exports.trackError=e;
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../services/telemetry.cjs`);function t({message:t,source:n,metadata:r={}}){e.trackException(Error(t),{error_source:n||`unknown`,...r})}exports.trackError=t;
 //# sourceMappingURL=error-handler.cjs.map

package/dist/utils/error-handler.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.cjs","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import type { PostHog } from \"posthog-js\";\n\ninterface ErrorDetails {\n  message: string;\n  source?: string;\n  metadata?: Record<string, unknown>;\n  msgId?: string;\n  posthog?: PostHog;\n}\n\nexport function trackError({\n  message,\n  source,\n  metadata = {},\n  posthog,\n}: ErrorDetails) {\n  if (!posthog) return;\n\n  const error = new Error(message);\n  posthog.captureException(error, {\n    error_source: source || \"unknown\",\n    ...metadata,\n  });\n}\n"],"mappings":"6CAUA,SAAgB,EAAW,CACzB,UACA,SACA,WAAW,EAAE,CACb,WACe,CACf,GAAI,CAAC,EAAS,OAEd,IAAM,EAAY,MAAM,EAAQ,CAChC,EAAQ,iBAAiB,EAAO,CAC9B,aAAc,GAAU,UACxB,GAAG,EACJ,CAAC"}
+{"version":3,"file":"error-handler.cjs","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import { trackException } from \"#/services/telemetry\";\n\ninterface ErrorDetails {\n  message: string;\n  source?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport function trackError({ message, source, metadata = {} }: ErrorDetails) {\n  const error = new Error(message);\n  void trackException(error, {\n    error_source: source || \"unknown\",\n    ...metadata,\n  });\n}\n"],"mappings":"0FAQA,SAAgB,EAAW,CAAE,UAAS,SAAQ,WAAW,EAAE,EAAkB,CAEtE,EAAA,eADa,MAAM,EACJ,CAAO,CACzB,aAAc,GAAU,UACxB,GAAG,EACJ,CAAC"}

package/dist/utils/error-handler.d.ts

@@ -1,10 +1,7 @@
-import type { PostHog } from "posthog-js";
 interface ErrorDetails {
     message: string;
     source?: string;
     metadata?: Record<string, unknown>;
-    msgId?: string;
-    posthog?: PostHog;
 }
-export declare function trackError({ message, source, metadata, posthog, }: ErrorDetails): void;
+export declare function trackError({ message, source, metadata }: ErrorDetails): void;
 export {};

package/dist/utils/error-handler.js

@@ -1,13 +1,12 @@
+import { trackException as e } from "../services/telemetry.js";
 //#region src/utils/error-handler.ts
-function e({ message: e, source: t, metadata: n = {}, posthog: r }) {
-	if (!r) return;
-	let i = Error(e);
-	r.captureException(i, {
-		error_source: t || "unknown",
-		...n
+function t({ message: t, source: n, metadata: r = {} }) {
+	e(Error(t), {
+		error_source: n || "unknown",
+		...r
 	});
 }
 //#endregion
-export { e as trackError };
+export { t as trackError };
 
 //# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.js","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import type { PostHog } from \"posthog-js\";\n\ninterface ErrorDetails {\n  message: string;\n  source?: string;\n  metadata?: Record<string, unknown>;\n  msgId?: string;\n  posthog?: PostHog;\n}\n\nexport function trackError({\n  message,\n  source,\n  metadata = {},\n  posthog,\n}: ErrorDetails) {\n  if (!posthog) return;\n\n  const error = new Error(message);\n  posthog.captureException(error, {\n    error_source: source || \"unknown\",\n    ...metadata,\n  });\n}\n"],"mappings":";AAUA,SAAgB,EAAW,EACzB,YACA,WACA,cAAW,EAAE,EACb,cACe;AACf,KAAI,CAAC,EAAS;CAEd,IAAM,IAAY,MAAM,EAAQ;AAChC,GAAQ,iBAAiB,GAAO;EAC9B,cAAc,KAAU;EACxB,GAAG;EACJ,CAAC"}
+{"version":3,"file":"error-handler.js","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import { trackException } from \"#/services/telemetry\";\n\ninterface ErrorDetails {\n  message: string;\n  source?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport function trackError({ message, source, metadata = {} }: ErrorDetails) {\n  const error = new Error(message);\n  void trackException(error, {\n    error_source: source || \"unknown\",\n    ...metadata,\n  });\n}\n"],"mappings":";;AAQA,SAAgB,EAAW,EAAE,YAAS,WAAQ,cAAW,EAAE,IAAkB;AAEtE,GADa,MAAM,EACJ,EAAO;EACzB,cAAc,KAAU;EACxB,GAAG;EACJ,CAAC"}

package/dist/utils/map-provider.cjs

@@ -1,2 +1,2 @@
-require(`../_virtual/_rolldown/runtime.cjs`);var e={openai:`OpenAI`,azure:`Azure`,azure_ai:`Azure AI Studio`,vertex_ai:`VertexAI`,palm:`PaLM`,gemini:`Gemini`,anthropic:`Anthropic`,sagemaker:`AWS SageMaker`,bedrock:`AWS Bedrock`,mistral:`Mistral AI`,anyscale:`Anyscale`,databricks:`Databricks`,ollama:`Ollama`,perlexity:`Perplexity AI`,friendliai:`FriendliAI`,groq:`Groq`,fireworks_ai:`Fireworks AI`,cloudflare:`Cloudflare Workers AI`,deepinfra:`DeepInfra`,ai21:`AI21`,replicate:`Replicate`,voyage:`Voyage AI`,openrouter:`OpenRouter`,openhands:`OpenHands`,lemonade:`Lemonade`,clarifai:`Clarifai`},t=t=>Object.keys(e).includes(t)?e[t]:t,n=t=>{let n=Object.entries(e).find(([,e])=>e===t);return n?n[0]:t};exports.getProviderId=n,exports.mapProvider=t;
+require(`../_virtual/_rolldown/runtime.cjs`);var e={openai:`OpenAI`,azure:`Azure`,azure_ai:`Azure AI Studio`,vertex_ai:`VertexAI`,palm:`PaLM`,gemini:`Gemini`,anthropic:`Anthropic`,sagemaker:`AWS SageMaker`,bedrock:`AWS Bedrock`,mistral:`Mistral AI`,anyscale:`Anyscale`,databricks:`Databricks`,ollama:`Ollama`,perlexity:`Perplexity AI`,friendliai:`FriendliAI`,groq:`Groq`,fireworks_ai:`Fireworks AI`,cloudflare:`Cloudflare Workers AI`,deepinfra:`DeepInfra`,ai21:`AI21`,replicate:`Replicate`,voyage:`Voyage AI`,openrouter:`OpenRouter`,openhands:`OpenHands`,lemonade:`Lemonade`,clarifai:`Clarifai`,moonshot:`Moonshot`},t=t=>Object.keys(e).includes(t)?e[t]:t,n=t=>{let n=Object.entries(e).find(([,e])=>e===t);return n?n[0]:t};exports.getProviderId=n,exports.mapProvider=t;
 //# sourceMappingURL=map-provider.cjs.map

package/dist/utils/map-provider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"map-provider.cjs","names":[],"sources":["../../src/utils/map-provider.ts"],"sourcesContent":["// These are provider names, not user-facing text\nexport const MAP_PROVIDER = {\n  openai: \"OpenAI\",\n  azure: \"Azure\",\n  azure_ai: \"Azure AI Studio\",\n  vertex_ai: \"VertexAI\",\n  palm: \"PaLM\",\n  gemini: \"Gemini\",\n  anthropic: \"Anthropic\",\n  sagemaker: \"AWS SageMaker\",\n  bedrock: \"AWS Bedrock\",\n  mistral: \"Mistral AI\",\n  anyscale: \"Anyscale\",\n  databricks: \"Databricks\",\n  ollama: \"Ollama\",\n  perlexity: \"Perplexity AI\",\n  friendliai: \"FriendliAI\",\n  groq: \"Groq\",\n  fireworks_ai: \"Fireworks AI\",\n  cloudflare: \"Cloudflare Workers AI\",\n  deepinfra: \"DeepInfra\",\n  ai21: \"AI21\",\n  replicate: \"Replicate\",\n  voyage: \"Voyage AI\",\n  openrouter: \"OpenRouter\",\n  openhands: \"OpenHands\",\n  lemonade: \"Lemonade\",\n  clarifai: \"Clarifai\",\n};\n\nexport const mapProvider = (provider: string) =>\n  Object.keys(MAP_PROVIDER).includes(provider)\n    ? MAP_PROVIDER[provider as keyof typeof MAP_PROVIDER]\n    : provider;\n\nexport const getProviderId = (displayName: string): string => {\n  const entry = Object.entries(MAP_PROVIDER).find(\n    ([, value]) => value === displayName,\n  );\n  return entry ? entry[0] : displayName;\n};\n"],"mappings":"6CACA,IAAa,EAAe,CAC1B,OAAQ,SACR,MAAO,QACP,SAAU,kBACV,UAAW,WACX,KAAM,OACN,OAAQ,SACR,UAAW,YACX,UAAW,gBACX,QAAS,cACT,QAAS,aACT,SAAU,WACV,WAAY,aACZ,OAAQ,SACR,UAAW,gBACX,WAAY,aACZ,KAAM,OACN,aAAc,eACd,WAAY,wBACZ,UAAW,YACX,KAAM,OACN,UAAW,YACX,OAAQ,YACR,WAAY,aACZ,UAAW,YACX,SAAU,WACV,SAAU,WACX,CAEY,EAAe,GAC1B,OAAO,KAAK,EAAa,CAAC,SAAS,EAAS,CACxC,EAAa,GACb,EAEO,EAAiB,GAAgC,CAC5D,IAAM,EAAQ,OAAO,QAAQ,EAAa,CAAC,MACxC,EAAG,KAAW,IAAU,EAC1B,CACD,OAAO,EAAQ,EAAM,GAAK"}
+{"version":3,"file":"map-provider.cjs","names":[],"sources":["../../src/utils/map-provider.ts"],"sourcesContent":["// These are provider names, not user-facing text\nexport const MAP_PROVIDER = {\n  openai: \"OpenAI\",\n  azure: \"Azure\",\n  azure_ai: \"Azure AI Studio\",\n  vertex_ai: \"VertexAI\",\n  palm: \"PaLM\",\n  gemini: \"Gemini\",\n  anthropic: \"Anthropic\",\n  sagemaker: \"AWS SageMaker\",\n  bedrock: \"AWS Bedrock\",\n  mistral: \"Mistral AI\",\n  anyscale: \"Anyscale\",\n  databricks: \"Databricks\",\n  ollama: \"Ollama\",\n  perlexity: \"Perplexity AI\",\n  friendliai: \"FriendliAI\",\n  groq: \"Groq\",\n  fireworks_ai: \"Fireworks AI\",\n  cloudflare: \"Cloudflare Workers AI\",\n  deepinfra: \"DeepInfra\",\n  ai21: \"AI21\",\n  replicate: \"Replicate\",\n  voyage: \"Voyage AI\",\n  openrouter: \"OpenRouter\",\n  openhands: \"OpenHands\",\n  lemonade: \"Lemonade\",\n  clarifai: \"Clarifai\",\n  moonshot: \"Moonshot\",\n};\n\nexport const mapProvider = (provider: string) =>\n  Object.keys(MAP_PROVIDER).includes(provider)\n    ? MAP_PROVIDER[provider as keyof typeof MAP_PROVIDER]\n    : provider;\n\nexport const getProviderId = (displayName: string): string => {\n  const entry = Object.entries(MAP_PROVIDER).find(\n    ([, value]) => value === displayName,\n  );\n  return entry ? entry[0] : displayName;\n};\n"],"mappings":"6CACA,IAAa,EAAe,CAC1B,OAAQ,SACR,MAAO,QACP,SAAU,kBACV,UAAW,WACX,KAAM,OACN,OAAQ,SACR,UAAW,YACX,UAAW,gBACX,QAAS,cACT,QAAS,aACT,SAAU,WACV,WAAY,aACZ,OAAQ,SACR,UAAW,gBACX,WAAY,aACZ,KAAM,OACN,aAAc,eACd,WAAY,wBACZ,UAAW,YACX,KAAM,OACN,UAAW,YACX,OAAQ,YACR,WAAY,aACZ,UAAW,YACX,SAAU,WACV,SAAU,WACV,SAAU,WACX,CAEY,EAAe,GAC1B,OAAO,KAAK,EAAa,CAAC,SAAS,EAAS,CACxC,EAAa,GACb,EAEO,EAAiB,GAAgC,CAC5D,IAAM,EAAQ,OAAO,QAAQ,EAAa,CAAC,MACxC,EAAG,KAAW,IAAU,EAC1B,CACD,OAAO,EAAQ,EAAM,GAAK"}

package/dist/utils/map-provider.d.ts

@@ -25,6 +25,7 @@ export declare const MAP_PROVIDER: {
     openhands: string;
     lemonade: string;
     clarifai: string;
+    moonshot: string;
 };
 export declare const mapProvider: (provider: string) => string;
 export declare const getProviderId: (displayName: string) => string;

package/dist/utils/map-provider.js

@@ -25,7 +25,8 @@ var e = {
 	openrouter: "OpenRouter",
 	openhands: "OpenHands",
 	lemonade: "Lemonade",
-	clarifai: "Clarifai"
+	clarifai: "Clarifai",
+	moonshot: "Moonshot"
 }, t = (t) => Object.keys(e).includes(t) ? e[t] : t, n = (t) => {
 	let n = Object.entries(e).find(([, e]) => e === t);
 	return n ? n[0] : t;

package/dist/utils/map-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-provider.js","names":[],"sources":["../../src/utils/map-provider.ts"],"sourcesContent":["// These are provider names, not user-facing text\nexport const MAP_PROVIDER = {\n  openai: \"OpenAI\",\n  azure: \"Azure\",\n  azure_ai: \"Azure AI Studio\",\n  vertex_ai: \"VertexAI\",\n  palm: \"PaLM\",\n  gemini: \"Gemini\",\n  anthropic: \"Anthropic\",\n  sagemaker: \"AWS SageMaker\",\n  bedrock: \"AWS Bedrock\",\n  mistral: \"Mistral AI\",\n  anyscale: \"Anyscale\",\n  databricks: \"Databricks\",\n  ollama: \"Ollama\",\n  perlexity: \"Perplexity AI\",\n  friendliai: \"FriendliAI\",\n  groq: \"Groq\",\n  fireworks_ai: \"Fireworks AI\",\n  cloudflare: \"Cloudflare Workers AI\",\n  deepinfra: \"DeepInfra\",\n  ai21: \"AI21\",\n  replicate: \"Replicate\",\n  voyage: \"Voyage AI\",\n  openrouter: \"OpenRouter\",\n  openhands: \"OpenHands\",\n  lemonade: \"Lemonade\",\n  clarifai: \"Clarifai\",\n};\n\nexport const mapProvider = (provider: string) =>\n  Object.keys(MAP_PROVIDER).includes(provider)\n    ? MAP_PROVIDER[provider as keyof typeof MAP_PROVIDER]\n    : provider;\n\nexport const getProviderId = (displayName: string): string => {\n  const entry = Object.entries(MAP_PROVIDER).find(\n    ([, value]) => value === displayName,\n  );\n  return entry ? entry[0] : displayName;\n};\n"],"mappings":";AACA,IAAa,IAAe;CAC1B,QAAQ;CACR,OAAO;CACP,UAAU;CACV,WAAW;CACX,MAAM;CACN,QAAQ;CACR,WAAW;CACX,WAAW;CACX,SAAS;CACT,SAAS;CACT,UAAU;CACV,YAAY;CACZ,QAAQ;CACR,WAAW;CACX,YAAY;CACZ,MAAM;CACN,cAAc;CACd,YAAY;CACZ,WAAW;CACX,MAAM;CACN,WAAW;CACX,QAAQ;CACR,YAAY;CACZ,WAAW;CACX,UAAU;CACV,UAAU;CACX,EAEY,KAAe,MAC1B,OAAO,KAAK,EAAa,CAAC,SAAS,EAAS,GACxC,EAAa,KACb,GAEO,KAAiB,MAAgC;CAC5D,IAAM,IAAQ,OAAO,QAAQ,EAAa,CAAC,MACxC,GAAG,OAAW,MAAU,EAC1B;AACD,QAAO,IAAQ,EAAM,KAAK"}
+{"version":3,"file":"map-provider.js","names":[],"sources":["../../src/utils/map-provider.ts"],"sourcesContent":["// These are provider names, not user-facing text\nexport const MAP_PROVIDER = {\n  openai: \"OpenAI\",\n  azure: \"Azure\",\n  azure_ai: \"Azure AI Studio\",\n  vertex_ai: \"VertexAI\",\n  palm: \"PaLM\",\n  gemini: \"Gemini\",\n  anthropic: \"Anthropic\",\n  sagemaker: \"AWS SageMaker\",\n  bedrock: \"AWS Bedrock\",\n  mistral: \"Mistral AI\",\n  anyscale: \"Anyscale\",\n  databricks: \"Databricks\",\n  ollama: \"Ollama\",\n  perlexity: \"Perplexity AI\",\n  friendliai: \"FriendliAI\",\n  groq: \"Groq\",\n  fireworks_ai: \"Fireworks AI\",\n  cloudflare: \"Cloudflare Workers AI\",\n  deepinfra: \"DeepInfra\",\n  ai21: \"AI21\",\n  replicate: \"Replicate\",\n  voyage: \"Voyage AI\",\n  openrouter: \"OpenRouter\",\n  openhands: \"OpenHands\",\n  lemonade: \"Lemonade\",\n  clarifai: \"Clarifai\",\n  moonshot: \"Moonshot\",\n};\n\nexport const mapProvider = (provider: string) =>\n  Object.keys(MAP_PROVIDER).includes(provider)\n    ? MAP_PROVIDER[provider as keyof typeof MAP_PROVIDER]\n    : provider;\n\nexport const getProviderId = (displayName: string): string => {\n  const entry = Object.entries(MAP_PROVIDER).find(\n    ([, value]) => value === displayName,\n  );\n  return entry ? entry[0] : displayName;\n};\n"],"mappings":";AACA,IAAa,IAAe;CAC1B,QAAQ;CACR,OAAO;CACP,UAAU;CACV,WAAW;CACX,MAAM;CACN,QAAQ;CACR,WAAW;CACX,WAAW;CACX,SAAS;CACT,SAAS;CACT,UAAU;CACV,YAAY;CACZ,QAAQ;CACR,WAAW;CACX,YAAY;CACZ,MAAM;CACN,cAAc;CACd,YAAY;CACZ,WAAW;CACX,MAAM;CACN,WAAW;CACX,QAAQ;CACR,YAAY;CACZ,WAAW;CACX,UAAU;CACV,UAAU;CACV,UAAU;CACX,EAEY,KAAe,MAC1B,OAAO,KAAK,EAAa,CAAC,SAAS,EAAS,GACxC,EAAa,KACb,GAEO,KAAiB,MAAgC;CAC5D,IAAM,IAAQ,OAAO,QAAQ,EAAa,CAAC,MACxC,GAAG,OAAW,MAAU,EAC1B;AACD,QAAO,IAAQ,EAAM,KAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/agent-canvas",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Agent Canvas UI for OpenHands - run AI coding agents with a visual interface",
   "license": "MIT",
   "private": false,
@@ -24,7 +24,7 @@
     "@microlink/react-json-view": "1.31.20",
     "@monaco-editor/react": "4.7.0",
     "@openhands/extensions": "0.9.0",
-    "@openhands/typescript-client": "1.32.1",
+    "@openhands/typescript-client": "1.34.0",
     "@react-router/node": "7.17.0",
     "@react-router/serve": "7.17.0",
     "@tailwindcss/vite": "4.2.4",
@@ -98,7 +98,7 @@
     "typecheck:staged": "react-router typegen && npx tsc --noEmit --skipLibCheck",
     "check-translation-completeness": "node scripts/check-translation-completeness.cjs",
     "build:app": "npm run make-i18n && react-router build",
-    "build:lib": "npm run make-i18n && react-router typegen && cross-env BUILD_LIB=true VITE_APP_ENV=production vite build && tsc -p tsconfig.lib.json",
+    "build:lib": "npm run make-i18n && react-router typegen && cross-env BUILD_LIB=true vite build && tsc -p tsconfig.lib.json",
     "build:docker": "node scripts/docker-build.mjs",
     "example:acp-docker:env": "node scripts/gen-acp-docker-env.mjs"
   },

package/scripts/check-sdk-version-sync.mjs

@@ -19,7 +19,7 @@
  *
  * Usage:
  *   node scripts/check-sdk-version-sync.mjs
- *   EXPECTED_SDK_VERSION=1.35.0 node scripts/check-sdk-version-sync.mjs
+ *   EXPECTED_SDK_VERSION=1.36.1 node scripts/check-sdk-version-sync.mjs
  *   node scripts/check-sdk-version-sync.mjs --check-pypi
  *
  * Environment variables:
@@ -78,7 +78,7 @@ Triggering from other repos:
     -H "Authorization: token \$GITHUB_TOKEN" \\
     -H "Accept: application/vnd.github.v3+json" \\
     https://api.github.com/repos/OpenHands/agent-canvas/dispatches \\
-    -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.35.0"}}'
+    -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.36.1"}}'
 `);
   process.exit(0);
 }
@@ -260,9 +260,9 @@ async function fetchPyPIDependencies(packageName, version) {
  * Parse PyPI requires_dist array and extract SDK package versions
  *
  * PyPI returns dependencies in PEP 508 format like:
- *   "openhands-sdk>=1.35.0,<2.0.0"
- *   "openhands-tools==1.35.0"
- *   "openhands-workspace (>=1.35.0)"
+ *   "openhands-sdk>=1.36.1,<2.0.0"
+ *   "openhands-tools==1.36.1"
+ *   "openhands-workspace (>=1.36.1)"
  */
 function parseSdkVersionsFromRequiresDist(requiresDist) {
   const versions = {};
@@ -276,7 +276,7 @@ function parseSdkVersionsFromRequiresDist(requiresDist) {
       }
 
       // Extract the version number - look for patterns like:
-      // ">=1.35.0", "==1.35.0", "(>=1.35.0)", "~=1.35.0"
+      // ">=1.36.1", "==1.36.1", "(>=1.36.1)", "~=1.36.1"
       // After the package name and before any comma or closing paren
       const versionPattern = /[><=~!]+\s*([0-9]+(?:\.[0-9]+)*)/;
       const match = dep.match(versionPattern);

package/scripts/dev-safe.mjs

@@ -48,7 +48,7 @@ const LOCAL_AGENT_SERVER_SUBDIRS = [
   "openhands-workspace",
 ];
 const DEFAULT_AGENT_SERVER_VERSION = SHARED_DEFAULTS.versions.agentServer;
-// Temporary transitive-dep pin: openhands-sdk 1.35.0 leaves agent-client-protocol
+// Temporary transitive-dep pin: openhands-sdk 1.36.1 leaves agent-client-protocol
 // unbounded (>=0.10.1), but acp 0.11.0 reordered the ACP prompt() args and breaks
 // the SDK's ACP client. Hold acp <0.11 until a fixed SDK ships. See config/defaults.json.
 const AGENT_CLIENT_PROTOCOL_CONSTRAINT =
@@ -399,7 +399,7 @@ export function validateFrontendDependencies(
  *   edits are picked up without a manual reinstall. The agent-server itself
  *   is rebuilt from local source on each invocation (--reinstall).
  * - OH_AGENT_SERVER_GIT_REF: Git commit SHA or branch name
- * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.35.0")
+ * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.36.1")
  *
  * If none are set, defaults to the released version specified by
  * DEFAULT_AGENT_SERVER_VERSION. Set OH_AGENT_SERVER_GIT_REF to use a
@@ -636,10 +636,9 @@ function buildConfigFromPorts(ports, cwd, env) {
     env.LOCAL_BACKEND_API_KEY ||
     getOrCreatePersistedApiKeyFile(persistedKeyPath);
 
-  // Host directory containing Agent-Canvas-specific Python tools (e.g. the
-  // canvas_ui tool). Added to OH_EXTRA_PYTHON_PATH below so the agent-server
-  // can import the modules listed in `tool_module_qualnames`. Lives at
-  // <repo-root>/tools relative to this script.
+  // Host directory containing the legacy canvas_ui Python module. Persisted
+  // conversations created before the client_tools migration still reference
+  // its module qualname, so the agent-server can import it when resuming them.
   const canvasToolsDir = fileURLToPath(new URL("../tools", import.meta.url));
 
   return {
@@ -719,8 +718,8 @@ export function buildAgentServerEnv(config) {
     // a follow-up change to the automation preset reads
     // OH_SESSION_API_KEYS_0 directly (which is already in env).
     AGENT_SERVER_URL: config.backendBaseUrl,
-    // Make the host tools/ directory importable so the agent-server can
-    // resolve modules listed in tool_module_qualnames (e.g. canvas_ui_tool).
+    // Let the agent-server resolve canvas_ui_tool when old persisted metadata
+    // requests that compatibility module during startup.
     OH_EXTRA_PYTHON_PATH: config.canvasToolsDir,
   };
 }

package/scripts/dev-static.mjs

@@ -386,6 +386,9 @@ function startStaticServer(config) {
       join(config.canvasPath, "build"),
       "--port",
       String(config.vitePort),
+      ...(process.env.VITE_BASE_PATH
+        ? ["--base-path", process.env.VITE_BASE_PATH]
+        : []),
       // Inject the API key so the pre-built frontend can authenticate
       // to the agent-server without a baked-in VITE_SESSION_API_KEY.
       ...(config.sessionApiKey

package/scripts/dev-with-automation.mjs

@@ -1376,6 +1376,9 @@ function startStaticFrontend(config, staticDir) {
       staticDir,
       "--port",
       String(config.vitePort),
+      ...(process.env.VITE_BASE_PATH
+        ? ["--base-path", process.env.VITE_BASE_PATH]
+        : []),
       // In local mode, inject the API key so the pre-built frontend can
       // authenticate transparently. In public mode, pass --auth-required
       // so the frontend shows the API key entry screen instead.

package/scripts/docker-build.mjs

@@ -25,6 +25,7 @@ const config = JSON.parse(
 
 const agentServerImage = `${config.images.agentServer}:${config.versions.agentServer}-python`;
 const automationVersion = config.versions.automation;
+const canvasBasePath = config.paths.canvasBasePath;
 
 // Parse CLI: --tag <name> and everything after -- is passed to docker build
 let tag = "agent-canvas:local";
@@ -50,6 +51,8 @@ const cmd = [
   `AGENT_SERVER_IMAGE=${agentServerImage}`,
   "--build-arg",
   `AUTOMATION_VERSION=${automationVersion}`,
+  "--build-arg",
+  `VITE_BASE_PATH=${canvasBasePath}`,
   "-t",
   tag,
   ...extraArgs,
@@ -58,6 +61,7 @@ const cmd = [
 
 console.log(`Agent Server image      : ${agentServerImage}`);
 console.log(`Automation version      : ${automationVersion}`);
+console.log(`Canvas base path        : ${canvasBasePath}`);
 console.log(`Tag                     : ${tag}`);
 console.log(`\n$ ${cmd.join(" ")}\n`);