@openhands/agent-canvas 1.12.0 → 1.14.0

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\";\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"}
+{"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\";\nimport { CondensationEvent } from \"./core/events/condensation-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 * Type guard for condensation completion events (history was compacted).\n */\nexport const isCondensationEvent = (\n  event: OpenHandsEvent,\n): event is CondensationEvent =>\n  \"kind\" in event && event.kind === \"Condensation\";\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":"2IA4CA,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,sBAKvB,EACX,GAEA,SAAU,GAAS,EAAM,OAAS,eAUpC,SAAgB,EAAmB,EAAyC,CAC1E,OAAO,EAAY,CAAK,CAC1B"}

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

@@ -7,6 +7,7 @@ import { HookExecutionEvent } from "./core/events/hook-execution-event";
 import { ACPToolCallEvent } from "./core/events/acp-tool-call-event";
 import { StreamingDeltaEvent } from "./core/events/streaming-delta-event";
 import { SystemPromptEvent } from "./core/events/system-event";
+import { CondensationEvent } from "./core/events/condensation-event";
 /**
  * Type guard to check if an unknown value is a valid BaseEvent
  * @param value - The value to check
@@ -105,6 +106,10 @@ export declare const isHookExecutionEvent: (event: OpenHandsEvent) => event is H
  */
 export declare const isACPToolCallEvent: (event: OpenHandsEvent) => event is ACPToolCallEvent;
 export declare const isStreamingDeltaEvent: (event: OpenHandsEvent) => event is StreamingDeltaEvent;
+/**
+ * Type guard for condensation completion events (history was compacted).
+ */
+export declare const isCondensationEvent: (event: OpenHandsEvent) => event is CondensationEvent;
 /**
  * Type guard to check if an event is an agent-server OpenHandsEvent.
  * Uses isBaseEvent to validate the complete event structure.

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

@@ -4,11 +4,11 @@ import "../../constants/child-conversation.js";
 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) {
+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", E = (e) => "kind" in e && e.kind === "Condensation";
+function D(t) {
 	return e(t);
 }
 //#endregion
-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 };
+export { w as isACPToolCallEvent, a as isActionEvent, n as isAgentErrorEvent, D as isAgentServerEvent, _ as isAgentStatusConversationStateUpdateEvent, d as isBrowserNavigateActionEvent, l as isBrowserObservationEvent, f as isCanvasUIActionEvent, E as isCondensationEvent, 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\";\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"}
+{"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\";\nimport { CondensationEvent } from \"./core/events/condensation-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 * Type guard for condensation completion events (history was compacted).\n */\nexport const isCondensationEvent = (\n  event: OpenHandsEvent,\n): event is CondensationEvent =>\n  \"kind\" in event && event.kind === \"Condensation\";\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":";;;AA4CA,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,uBAKvB,KACX,MAEA,UAAU,KAAS,EAAM,SAAS;AAUpC,SAAgB,EAAmB,GAAyC;CAC1E,OAAO,EAAY,CAAK;AAC1B"}

package/dist/types/git-sync.d.ts

@@ -0,0 +1,51 @@
+export interface GitSyncStatus {
+    enabled: boolean;
+    repo_url: string;
+    branch: string;
+    path: string;
+    encryption_enabled: boolean;
+    /** Seconds between automatic syncs; 0 means manual-only. */
+    interval_seconds: number;
+    last_synced_commit: string | null;
+    last_synced_at: string | null;
+    last_error: string | null;
+    last_error_at: string | null;
+    dirty_count: number;
+    /**
+     * Whether a sync cycle is running right now, including one the backend's own
+     * interval started. A cycle reports its outcome only once it ends, so
+     * without this the page cannot tell a sync in flight from one that never
+     * started. Absent on automation backends that predate the field.
+     */
+    sync_in_progress?: boolean;
+    sync_started_at?: string | null;
+}
+export interface GitSyncConfigUpdateRequest {
+    enabled?: boolean | null;
+    interval_seconds?: number | null;
+    repo_url?: string | null;
+    branch?: string | null;
+    path?: string | null;
+    token?: string | null;
+    encryption_key?: string | null;
+    author_name?: string | null;
+    author_email?: string | null;
+}
+export interface GitSyncTriggerResponse {
+    triggered: boolean;
+}
+/**
+ * Whether a configuration can reach its repo, from `POST /v1/git-sync/check`.
+ *
+ * `ok` is about reachability only -- the backend runs a single `git ls-remote`
+ * rather than a sync, so a token without write scope passes here and still
+ * fails at push time, and the encryption key is never exercised.
+ * `branch_exists: false` alongside `ok: true` is normal for a repo that has
+ * never been synced: the first cycle creates the branch.
+ */
+export interface GitSyncCheckResponse {
+    ok: boolean;
+    branch_exists: boolean;
+    /** git's own failure output, with credentials in the URL redacted. */
+    detail: string | null;
+}

package/dist/utils/conversation-local-storage.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");let e=require("react");var t={CONVERSATION_STATE:`conversation-state`,PENDING_TASK_DRAFT:`pending-task-draft`},n=`conversation-state-updated`,r={selectedTab:`files`,unpinnedTabs:[],conversationMode:`code`,subConversationTaskId:null,draftMessage:null,filesTabDiffView:null,filesTabContentViewMode:`rich`},i=new Set([`files`,`browser`,`terminal`,`planner`,`tasklist`]),a=new Set([`editor`,`served`,`changes`,`app`,`vscode`]),o=new Set([`rich`,`plain`]);function s(e){let{rightPanelShown:t,...n}=e,r=n;if(r.selectedTab!=null&&(a.has(r.selectedTab)||!i.has(r.selectedTab))&&(r={...r},delete r.selectedTab),r.unpinnedTabs){let e=r.unpinnedTabs.filter(e=>!a.has(e));e.length!==r.unpinnedTabs.length&&(r={...r,unpinnedTabs:e})}return r.filesTabContentViewMode!=null&&!o.has(r.filesTabContentViewMode)&&(r={...r},delete r.filesTabContentViewMode),r}function c(e){return e.startsWith(`task-`)}function l(e){return e===``||c(e)}function u(e){if(l(e))return r;try{let n=`${t.CONVERSATION_STATE}-${e}`,i=localStorage.getItem(n);return i===null?r:{...r,...s(JSON.parse(i))}}catch{return r}}function d(e,r){if(!l(e))try{let i=`${t.CONVERSATION_STATE}-${e}`,a={...u(e),...r};localStorage.setItem(i,JSON.stringify(a)),typeof window<`u`&&window.dispatchEvent(new CustomEvent(n,{detail:{conversationId:e}}))}catch(e){console.warn(`Failed to set conversation localStorage`,e)}}function f(e){return`${t.PENDING_TASK_DRAFT}-${e}`}function p(e){if(!e)return null;try{let t=f(e),n=localStorage.getItem(t);return localStorage.removeItem(t),n}catch(e){return console.warn(`Failed to consume pending task draft`,e),null}}function m(e){try{let r=`${t.CONVERSATION_STATE}-${e}`;localStorage.removeItem(r),typeof window<`u`&&window.dispatchEvent(new CustomEvent(n,{detail:{conversationId:e}}))}catch(t){console.warn(`Failed to clear conversation localStorage`,e,t)}}function h(r){let[i,a]=(0,e.useState)(()=>u(r));(0,e.useEffect)(()=>{if(typeof window>`u`)return;let e=`${t.CONVERSATION_STATE}-${r}`,i=()=>{a(u(r))},o=t=>{t.key===e&&i()},s=e=>{e.detail?.conversationId===r&&i()};return i(),window.addEventListener(`storage`,o),window.addEventListener(n,s),()=>{window.removeEventListener(`storage`,o),window.removeEventListener(n,s)}},[r]);let o=e=>{if(l(r)){a(t=>({...t,...e}));return}d(r,e)};return{state:i,setSelectedTab:e=>o({selectedTab:e}),setUnpinnedTabs:e=>o({unpinnedTabs:e}),setConversationMode:e=>o({conversationMode:e}),setDraftMessage:e=>o({draftMessage:e}),setFilesTabDiffView:e=>o({filesTabDiffView:e}),setFilesTabContentViewMode:e=>o({filesTabContentViewMode:e})}}exports.clearConversationLocalStorage=m,exports.consumePendingTaskDraft=p,exports.getConversationState=u,exports.isTaskConversationId=c,exports.setConversationState=d,exports.useConversationLocalStorageState=h;
+require("../_virtual/_rolldown/runtime.cjs");let e=require("react");var t={CONVERSATION_STATE:`conversation-state`,PENDING_TASK_DRAFT:`pending-task-draft`},n=`conversation-state-updated`,r={selectedTab:`files`,unpinnedTabs:[],conversationMode:`code`,subConversationTaskId:null,draftMessage:null,filesTabDiffView:null,filesTabContentViewMode:`rich`},i=new Set([`files`,`browser`,`terminal`,`planner`,`tasklist`,`usage`]),a=new Set([`editor`,`served`,`changes`,`app`,`vscode`]),o=new Set([`rich`,`plain`]);function s(e){let{rightPanelShown:t,...n}=e,r=n;if(r.selectedTab!=null&&(a.has(r.selectedTab)||!i.has(r.selectedTab))&&(r={...r},delete r.selectedTab),r.unpinnedTabs){let e=r.unpinnedTabs.filter(e=>!a.has(e));e.length!==r.unpinnedTabs.length&&(r={...r,unpinnedTabs:e})}return r.filesTabContentViewMode!=null&&!o.has(r.filesTabContentViewMode)&&(r={...r},delete r.filesTabContentViewMode),r}function c(e){return e.startsWith(`task-`)}function l(e){return e===``||c(e)}function u(e){if(l(e))return r;try{let n=`${t.CONVERSATION_STATE}-${e}`,i=localStorage.getItem(n);return i===null?r:{...r,...s(JSON.parse(i))}}catch{return r}}function d(e,r){if(!l(e))try{let i=`${t.CONVERSATION_STATE}-${e}`,a={...u(e),...r};localStorage.setItem(i,JSON.stringify(a)),typeof window<`u`&&window.dispatchEvent(new CustomEvent(n,{detail:{conversationId:e}}))}catch(e){console.warn(`Failed to set conversation localStorage`,e)}}function f(e){return`${t.PENDING_TASK_DRAFT}-${e}`}function p(e){if(!e)return null;try{let t=f(e),n=localStorage.getItem(t);return localStorage.removeItem(t),n}catch(e){return console.warn(`Failed to consume pending task draft`,e),null}}function m(e){try{let r=`${t.CONVERSATION_STATE}-${e}`;localStorage.removeItem(r),typeof window<`u`&&window.dispatchEvent(new CustomEvent(n,{detail:{conversationId:e}}))}catch(t){console.warn(`Failed to clear conversation localStorage`,e,t)}}function h(r){let[i,a]=(0,e.useState)(()=>u(r));(0,e.useEffect)(()=>{if(typeof window>`u`)return;let e=`${t.CONVERSATION_STATE}-${r}`,i=()=>{a(u(r))},o=t=>{t.key===e&&i()},s=e=>{e.detail?.conversationId===r&&i()};return i(),window.addEventListener(`storage`,o),window.addEventListener(n,s),()=>{window.removeEventListener(`storage`,o),window.removeEventListener(n,s)}},[r]);let o=e=>{if(l(r)){a(t=>({...t,...e}));return}d(r,e)};return{state:i,setSelectedTab:e=>o({selectedTab:e}),setUnpinnedTabs:e=>o({unpinnedTabs:e}),setConversationMode:e=>o({conversationMode:e}),setDraftMessage:e=>o({draftMessage:e}),setFilesTabDiffView:e=>o({filesTabDiffView:e}),setFilesTabContentViewMode:e=>o({filesTabContentViewMode:e})}}exports.clearConversationLocalStorage=m,exports.consumePendingTaskDraft=p,exports.getConversationState=u,exports.isTaskConversationId=c,exports.setConversationState=d,exports.useConversationLocalStorageState=h;
 //# sourceMappingURL=conversation-local-storage.cjs.map

package/dist/utils/conversation-local-storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-local-storage.cjs","names":[],"sources":["../../src/utils/conversation-local-storage.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type {\n  ConversationTab,\n  ConversationMode,\n} from \"#/stores/conversation-store\";\nimport type { ViewMode } from \"#/components/features/files-tab/view-mode\";\n\nexport const LOCAL_STORAGE_KEYS = {\n  CONVERSATION_STATE: \"conversation-state\",\n  PENDING_TASK_DRAFT: \"pending-task-draft\",\n} as const;\n\nconst CONVERSATION_STATE_UPDATED_EVENT = \"conversation-state-updated\";\n\ntype ConversationStateUpdatedDetail = {\n  conversationId: string;\n};\n\n/**\n * Consolidated conversation state stored in a single localStorage key.\n *\n * NOTE: the right-drawer open/closed state is intentionally *not* persisted\n * here. Users expect the drawer to start closed every time the app is\n * (re)loaded and only stay open when they opened it themselves during the\n * current session. That state lives in the in-memory Zustand\n * `useConversationStore` (`isRightPanelShown` / `hasRightPanelToggled`)\n * which survives in-app navigation but resets on full reloads. Older\n * builds wrote a `rightPanelShown` field into this blob; we accept and\n * silently ignore that field on read so we don't churn old localStorage.\n */\nexport interface ConversationState {\n  selectedTab: ConversationTab | null;\n  unpinnedTabs: string[];\n  conversationMode: ConversationMode;\n  subConversationTaskId: string | null;\n  draftMessage: string | null;\n  /**\n   * User's persisted choice for the Files tab diff-vs-files toggle.\n   * `null` means \"no explicit choice yet\" — the Files tab then falls back\n   * to its repo-aware default (diff inside a git repo with commits, files\n   * otherwise).\n   */\n  filesTabDiffView: boolean | null;\n  /** User's persisted choice for the Files tab Rich/Plain content toggle. */\n  filesTabContentViewMode: ViewMode;\n}\n\nconst DEFAULT_CONVERSATION_STATE: ConversationState = {\n  selectedTab: \"files\",\n  unpinnedTabs: [],\n  conversationMode: \"code\",\n  subConversationTaskId: null,\n  draftMessage: null,\n  filesTabDiffView: null,\n  filesTabContentViewMode: \"rich\",\n};\n\nconst VALID_CONVERSATION_TABS: ReadonlySet<ConversationTab> = new Set([\n  \"files\",\n  \"browser\",\n  \"terminal\",\n  \"planner\",\n  \"tasklist\",\n]);\n\n// Tab keys that *used to* exist and were removed during the Files tab\n// refactor. We strip these out of any persisted state on read so that\n// returning users don't keep ghost entries (in `selectedTab` or\n// `unpinnedTabs`) forever — the UI has no way to surface them again to\n// be re-pinned or re-selected. We deliberately use an explicit denylist\n// here rather than a strict \"whitelist against VALID_CONVERSATION_TABS\"\n// filter because `unpinnedTabs` is typed `string[]` and other parts of\n// the app legitimately store arbitrary tab keys in it (sub-conversation\n// tab ids etc.).\nconst REMOVED_CONVERSATION_TABS: ReadonlySet<string> = new Set([\n  \"editor\",\n  \"served\",\n  \"changes\",\n  \"app\",\n  \"vscode\",\n]);\n\nconst VALID_VIEW_MODES: ReadonlySet<ViewMode> = new Set([\"rich\", \"plain\"]);\n\nfunction sanitizeStoredState(\n  stored: Record<string, unknown>,\n): Partial<ConversationState> {\n  // `rightPanelShown` is no longer part of the schema (the drawer's\n  // open state is session-only) but old persisted blobs still carry it.\n  // We just drop it on the way in — keeping it in `result` here would\n  // pollute the merged `ConversationState` shape that consumers receive.\n  const { rightPanelShown: _ignoredRightPanelShown, ...rest } = stored as {\n    rightPanelShown?: unknown;\n  } & Record<string, unknown>;\n  let result: Partial<ConversationState> = rest as Partial<ConversationState>;\n\n  if (\n    result.selectedTab != null &&\n    (REMOVED_CONVERSATION_TABS.has(result.selectedTab) ||\n      !VALID_CONVERSATION_TABS.has(result.selectedTab as ConversationTab))\n  ) {\n    result = { ...result };\n    delete result.selectedTab;\n  }\n\n  if (result.unpinnedTabs) {\n    const filtered = result.unpinnedTabs.filter(\n      (tab) => !REMOVED_CONVERSATION_TABS.has(tab),\n    );\n    if (filtered.length !== result.unpinnedTabs.length) {\n      result = { ...result, unpinnedTabs: filtered };\n    }\n  }\n\n  // Drop a corrupt/manually-edited `filesTabContentViewMode` so it falls\n  // back to the typed default (\"rich\") instead of leaking a junk string\n  // into ViewMode-typed consumers. TypeScript can't help us here — the\n  // value comes from `JSON.parse(localStorage.getItem(...))` which is\n  // unknown at runtime.\n  if (\n    result.filesTabContentViewMode != null &&\n    !VALID_VIEW_MODES.has(result.filesTabContentViewMode)\n  ) {\n    result = { ...result };\n    delete result.filesTabContentViewMode;\n  }\n\n  return result;\n}\n\n/**\n * Check if a conversation ID is a temporary task ID that should not be persisted.\n * Task IDs have the format \"task-{uuid}\" and are used during V1 conversation initialization.\n */\nexport function isTaskConversationId(conversationId: string): boolean {\n  return conversationId.startsWith(\"task-\");\n}\n\n/**\n * Whether persistence should be skipped for this conversation id.\n *\n * Skips:\n *  - empty string ids (callers outside of a conversation route, e.g.\n *    rendered inside a unit test without a NavigationProvider)\n *  - \"task-...\" ids used as placeholders during V1 conversation\n *    initialization\n */\nfunction shouldSkipPersistence(conversationId: string): boolean {\n  return conversationId === \"\" || isTaskConversationId(conversationId);\n}\n\n/**\n * Get the full conversation state from localStorage.\n */\nexport function getConversationState(\n  conversationId: string,\n): ConversationState {\n  if (shouldSkipPersistence(conversationId)) {\n    return DEFAULT_CONVERSATION_STATE;\n  }\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    const item = localStorage.getItem(key);\n    if (item !== null) {\n      return {\n        ...DEFAULT_CONVERSATION_STATE,\n        ...sanitizeStoredState(JSON.parse(item)),\n      };\n    }\n    return DEFAULT_CONVERSATION_STATE;\n  } catch {\n    return DEFAULT_CONVERSATION_STATE;\n  }\n}\n\n/**\n * Set the conversation state in localStorage, merging with existing state.\n */\nexport function setConversationState(\n  conversationId: string,\n  updates: Partial<ConversationState>,\n): void {\n  if (shouldSkipPersistence(conversationId)) {\n    return;\n  }\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    const currentState = getConversationState(conversationId);\n    const newState = { ...currentState, ...updates };\n    localStorage.setItem(key, JSON.stringify(newState));\n    if (typeof window !== \"undefined\") {\n      window.dispatchEvent(\n        new CustomEvent<ConversationStateUpdatedDetail>(\n          CONVERSATION_STATE_UPDATED_EVENT,\n          { detail: { conversationId } },\n        ),\n      );\n    }\n  } catch (err) {\n    console.warn(\"Failed to set conversation localStorage\", err);\n  }\n}\n\nfunction getPendingTaskDraftKey(taskId: string): string {\n  return `${LOCAL_STORAGE_KEYS.PENDING_TASK_DRAFT}-${taskId}`;\n}\n\nexport function setPendingTaskDraft(\n  taskId: string | null | undefined,\n  draftMessage: string,\n): void {\n  if (!taskId) return;\n  try {\n    localStorage.setItem(getPendingTaskDraftKey(taskId), draftMessage);\n  } catch (err) {\n    console.warn(\"Failed to store pending task draft\", err);\n  }\n}\n\nexport function consumePendingTaskDraft(\n  taskId: string | null | undefined,\n): string | null {\n  if (!taskId) return null;\n  try {\n    const key = getPendingTaskDraftKey(taskId);\n    const draft = localStorage.getItem(key);\n    localStorage.removeItem(key);\n    return draft;\n  } catch (err) {\n    console.warn(\"Failed to consume pending task draft\", err);\n    return null;\n  }\n}\n\nexport function clearConversationLocalStorage(conversationId: string) {\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    localStorage.removeItem(key);\n    if (typeof window !== \"undefined\") {\n      window.dispatchEvent(\n        new CustomEvent<ConversationStateUpdatedDetail>(\n          CONVERSATION_STATE_UPDATED_EVENT,\n          { detail: { conversationId } },\n        ),\n      );\n    }\n  } catch (err) {\n    console.warn(\n      \"Failed to clear conversation localStorage\",\n      conversationId,\n      err,\n    );\n  }\n}\n\n/**\n * React hook for conversation-scoped localStorage state.\n * Returns the full state and individual setters for each property.\n *\n * The right-drawer open state is deliberately not represented here —\n * see the note on `ConversationState` for the rationale.\n */\nexport function useConversationLocalStorageState(conversationId: string): {\n  state: ConversationState;\n  setSelectedTab: (tab: ConversationTab | null) => void;\n  setUnpinnedTabs: (tabs: string[]) => void;\n  setConversationMode: (mode: ConversationMode) => void;\n  setDraftMessage: (message: string | null) => void;\n  setFilesTabDiffView: (diffView: boolean | null) => void;\n  setFilesTabContentViewMode: (mode: ViewMode) => void;\n} {\n  const [state, setState] = useState<ConversationState>(() =>\n    getConversationState(conversationId),\n  );\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return undefined;\n    }\n\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n\n    const syncState = () => {\n      setState(getConversationState(conversationId));\n    };\n\n    const handleStorage = (event: StorageEvent) => {\n      if (event.key === key) {\n        syncState();\n      }\n    };\n\n    const handleConversationStateUpdated = (event: Event) => {\n      const customEvent = event as CustomEvent<ConversationStateUpdatedDetail>;\n      if (customEvent.detail?.conversationId === conversationId) {\n        syncState();\n      }\n    };\n\n    // Ensure this hook reflects latest state for the current conversation ID.\n    syncState();\n\n    window.addEventListener(\"storage\", handleStorage);\n    window.addEventListener(\n      CONVERSATION_STATE_UPDATED_EVENT,\n      handleConversationStateUpdated,\n    );\n\n    return () => {\n      window.removeEventListener(\"storage\", handleStorage);\n      window.removeEventListener(\n        CONVERSATION_STATE_UPDATED_EVENT,\n        handleConversationStateUpdated,\n      );\n    };\n  }, [conversationId]);\n\n  const updateState = (updates: Partial<ConversationState>) => {\n    if (shouldSkipPersistence(conversationId)) {\n      // No durable storage for this id (empty / task placeholder), but the\n      // hook is still useful as ephemeral in-memory state — update the\n      // local React mirror directly so toggles in the UI behave normally\n      // until a real conversation id arrives.\n      setState((prev) => ({ ...prev, ...updates }));\n      return;\n    }\n    setConversationState(conversationId, updates);\n  };\n\n  return {\n    state,\n    setSelectedTab: (tab) => updateState({ selectedTab: tab }),\n    setUnpinnedTabs: (tabs) => updateState({ unpinnedTabs: tabs }),\n    setConversationMode: (mode) => updateState({ conversationMode: mode }),\n    setDraftMessage: (message) => updateState({ draftMessage: message }),\n    setFilesTabDiffView: (diffView) =>\n      updateState({ filesTabDiffView: diffView }),\n    setFilesTabContentViewMode: (mode) =>\n      updateState({ filesTabContentViewMode: mode }),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"conversation-local-storage.cjs","names":[],"sources":["../../src/utils/conversation-local-storage.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type {\n  ConversationTab,\n  ConversationMode,\n} from \"#/stores/conversation-store\";\nimport type { ViewMode } from \"#/components/features/files-tab/view-mode\";\n\nexport const LOCAL_STORAGE_KEYS = {\n  CONVERSATION_STATE: \"conversation-state\",\n  PENDING_TASK_DRAFT: \"pending-task-draft\",\n} as const;\n\nconst CONVERSATION_STATE_UPDATED_EVENT = \"conversation-state-updated\";\n\ntype ConversationStateUpdatedDetail = {\n  conversationId: string;\n};\n\n/**\n * Consolidated conversation state stored in a single localStorage key.\n *\n * NOTE: the right-drawer open/closed state is intentionally *not* persisted\n * here. Users expect the drawer to start closed every time the app is\n * (re)loaded and only stay open when they opened it themselves during the\n * current session. That state lives in the in-memory Zustand\n * `useConversationStore` (`isRightPanelShown` / `hasRightPanelToggled`)\n * which survives in-app navigation but resets on full reloads. Older\n * builds wrote a `rightPanelShown` field into this blob; we accept and\n * silently ignore that field on read so we don't churn old localStorage.\n */\nexport interface ConversationState {\n  selectedTab: ConversationTab | null;\n  unpinnedTabs: string[];\n  conversationMode: ConversationMode;\n  subConversationTaskId: string | null;\n  draftMessage: string | null;\n  /**\n   * User's persisted choice for the Files tab diff-vs-files toggle.\n   * `null` means \"no explicit choice yet\" — the Files tab then falls back\n   * to its repo-aware default (diff inside a git repo with commits, files\n   * otherwise).\n   */\n  filesTabDiffView: boolean | null;\n  /** User's persisted choice for the Files tab Rich/Plain content toggle. */\n  filesTabContentViewMode: ViewMode;\n}\n\nconst DEFAULT_CONVERSATION_STATE: ConversationState = {\n  selectedTab: \"files\",\n  unpinnedTabs: [],\n  conversationMode: \"code\",\n  subConversationTaskId: null,\n  draftMessage: null,\n  filesTabDiffView: null,\n  filesTabContentViewMode: \"rich\",\n};\n\nconst VALID_CONVERSATION_TABS: ReadonlySet<ConversationTab> = new Set([\n  \"files\",\n  \"browser\",\n  \"terminal\",\n  \"planner\",\n  \"tasklist\",\n  \"usage\",\n]);\n\n// Tab keys that *used to* exist and were removed during the Files tab\n// refactor. We strip these out of any persisted state on read so that\n// returning users don't keep ghost entries (in `selectedTab` or\n// `unpinnedTabs`) forever — the UI has no way to surface them again to\n// be re-pinned or re-selected. We deliberately use an explicit denylist\n// here rather than a strict \"whitelist against VALID_CONVERSATION_TABS\"\n// filter because `unpinnedTabs` is typed `string[]` and other parts of\n// the app legitimately store arbitrary tab keys in it (sub-conversation\n// tab ids etc.).\nconst REMOVED_CONVERSATION_TABS: ReadonlySet<string> = new Set([\n  \"editor\",\n  \"served\",\n  \"changes\",\n  \"app\",\n  \"vscode\",\n]);\n\nconst VALID_VIEW_MODES: ReadonlySet<ViewMode> = new Set([\"rich\", \"plain\"]);\n\nfunction sanitizeStoredState(\n  stored: Record<string, unknown>,\n): Partial<ConversationState> {\n  // `rightPanelShown` is no longer part of the schema (the drawer's\n  // open state is session-only) but old persisted blobs still carry it.\n  // We just drop it on the way in — keeping it in `result` here would\n  // pollute the merged `ConversationState` shape that consumers receive.\n  const { rightPanelShown: _ignoredRightPanelShown, ...rest } = stored as {\n    rightPanelShown?: unknown;\n  } & Record<string, unknown>;\n  let result: Partial<ConversationState> = rest as Partial<ConversationState>;\n\n  if (\n    result.selectedTab != null &&\n    (REMOVED_CONVERSATION_TABS.has(result.selectedTab) ||\n      !VALID_CONVERSATION_TABS.has(result.selectedTab as ConversationTab))\n  ) {\n    result = { ...result };\n    delete result.selectedTab;\n  }\n\n  if (result.unpinnedTabs) {\n    const filtered = result.unpinnedTabs.filter(\n      (tab) => !REMOVED_CONVERSATION_TABS.has(tab),\n    );\n    if (filtered.length !== result.unpinnedTabs.length) {\n      result = { ...result, unpinnedTabs: filtered };\n    }\n  }\n\n  // Drop a corrupt/manually-edited `filesTabContentViewMode` so it falls\n  // back to the typed default (\"rich\") instead of leaking a junk string\n  // into ViewMode-typed consumers. TypeScript can't help us here — the\n  // value comes from `JSON.parse(localStorage.getItem(...))` which is\n  // unknown at runtime.\n  if (\n    result.filesTabContentViewMode != null &&\n    !VALID_VIEW_MODES.has(result.filesTabContentViewMode)\n  ) {\n    result = { ...result };\n    delete result.filesTabContentViewMode;\n  }\n\n  return result;\n}\n\n/**\n * Check if a conversation ID is a temporary task ID that should not be persisted.\n * Task IDs have the format \"task-{uuid}\" and are used during V1 conversation initialization.\n */\nexport function isTaskConversationId(conversationId: string): boolean {\n  return conversationId.startsWith(\"task-\");\n}\n\n/**\n * Whether persistence should be skipped for this conversation id.\n *\n * Skips:\n *  - empty string ids (callers outside of a conversation route, e.g.\n *    rendered inside a unit test without a NavigationProvider)\n *  - \"task-...\" ids used as placeholders during V1 conversation\n *    initialization\n */\nfunction shouldSkipPersistence(conversationId: string): boolean {\n  return conversationId === \"\" || isTaskConversationId(conversationId);\n}\n\n/**\n * Get the full conversation state from localStorage.\n */\nexport function getConversationState(\n  conversationId: string,\n): ConversationState {\n  if (shouldSkipPersistence(conversationId)) {\n    return DEFAULT_CONVERSATION_STATE;\n  }\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    const item = localStorage.getItem(key);\n    if (item !== null) {\n      return {\n        ...DEFAULT_CONVERSATION_STATE,\n        ...sanitizeStoredState(JSON.parse(item)),\n      };\n    }\n    return DEFAULT_CONVERSATION_STATE;\n  } catch {\n    return DEFAULT_CONVERSATION_STATE;\n  }\n}\n\n/**\n * Set the conversation state in localStorage, merging with existing state.\n */\nexport function setConversationState(\n  conversationId: string,\n  updates: Partial<ConversationState>,\n): void {\n  if (shouldSkipPersistence(conversationId)) {\n    return;\n  }\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    const currentState = getConversationState(conversationId);\n    const newState = { ...currentState, ...updates };\n    localStorage.setItem(key, JSON.stringify(newState));\n    if (typeof window !== \"undefined\") {\n      window.dispatchEvent(\n        new CustomEvent<ConversationStateUpdatedDetail>(\n          CONVERSATION_STATE_UPDATED_EVENT,\n          { detail: { conversationId } },\n        ),\n      );\n    }\n  } catch (err) {\n    console.warn(\"Failed to set conversation localStorage\", err);\n  }\n}\n\nfunction getPendingTaskDraftKey(taskId: string): string {\n  return `${LOCAL_STORAGE_KEYS.PENDING_TASK_DRAFT}-${taskId}`;\n}\n\nexport function setPendingTaskDraft(\n  taskId: string | null | undefined,\n  draftMessage: string,\n): void {\n  if (!taskId) return;\n  try {\n    localStorage.setItem(getPendingTaskDraftKey(taskId), draftMessage);\n  } catch (err) {\n    console.warn(\"Failed to store pending task draft\", err);\n  }\n}\n\nexport function consumePendingTaskDraft(\n  taskId: string | null | undefined,\n): string | null {\n  if (!taskId) return null;\n  try {\n    const key = getPendingTaskDraftKey(taskId);\n    const draft = localStorage.getItem(key);\n    localStorage.removeItem(key);\n    return draft;\n  } catch (err) {\n    console.warn(\"Failed to consume pending task draft\", err);\n    return null;\n  }\n}\n\nexport function clearConversationLocalStorage(conversationId: string) {\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    localStorage.removeItem(key);\n    if (typeof window !== \"undefined\") {\n      window.dispatchEvent(\n        new CustomEvent<ConversationStateUpdatedDetail>(\n          CONVERSATION_STATE_UPDATED_EVENT,\n          { detail: { conversationId } },\n        ),\n      );\n    }\n  } catch (err) {\n    console.warn(\n      \"Failed to clear conversation localStorage\",\n      conversationId,\n      err,\n    );\n  }\n}\n\n/**\n * React hook for conversation-scoped localStorage state.\n * Returns the full state and individual setters for each property.\n *\n * The right-drawer open state is deliberately not represented here —\n * see the note on `ConversationState` for the rationale.\n */\nexport function useConversationLocalStorageState(conversationId: string): {\n  state: ConversationState;\n  setSelectedTab: (tab: ConversationTab | null) => void;\n  setUnpinnedTabs: (tabs: string[]) => void;\n  setConversationMode: (mode: ConversationMode) => void;\n  setDraftMessage: (message: string | null) => void;\n  setFilesTabDiffView: (diffView: boolean | null) => void;\n  setFilesTabContentViewMode: (mode: ViewMode) => void;\n} {\n  const [state, setState] = useState<ConversationState>(() =>\n    getConversationState(conversationId),\n  );\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return undefined;\n    }\n\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n\n    const syncState = () => {\n      setState(getConversationState(conversationId));\n    };\n\n    const handleStorage = (event: StorageEvent) => {\n      if (event.key === key) {\n        syncState();\n      }\n    };\n\n    const handleConversationStateUpdated = (event: Event) => {\n      const customEvent = event as CustomEvent<ConversationStateUpdatedDetail>;\n      if (customEvent.detail?.conversationId === conversationId) {\n        syncState();\n      }\n    };\n\n    // Ensure this hook reflects latest state for the current conversation ID.\n    syncState();\n\n    window.addEventListener(\"storage\", handleStorage);\n    window.addEventListener(\n      CONVERSATION_STATE_UPDATED_EVENT,\n      handleConversationStateUpdated,\n    );\n\n    return () => {\n      window.removeEventListener(\"storage\", handleStorage);\n      window.removeEventListener(\n        CONVERSATION_STATE_UPDATED_EVENT,\n        handleConversationStateUpdated,\n      );\n    };\n  }, [conversationId]);\n\n  const updateState = (updates: Partial<ConversationState>) => {\n    if (shouldSkipPersistence(conversationId)) {\n      // No durable storage for this id (empty / task placeholder), but the\n      // hook is still useful as ephemeral in-memory state — update the\n      // local React mirror directly so toggles in the UI behave normally\n      // until a real conversation id arrives.\n      setState((prev) => ({ ...prev, ...updates }));\n      return;\n    }\n    setConversationState(conversationId, updates);\n  };\n\n  return {\n    state,\n    setSelectedTab: (tab) => updateState({ selectedTab: tab }),\n    setUnpinnedTabs: (tabs) => updateState({ unpinnedTabs: tabs }),\n    setConversationMode: (mode) => updateState({ conversationMode: mode }),\n    setDraftMessage: (message) => updateState({ draftMessage: message }),\n    setFilesTabDiffView: (diffView) =>\n      updateState({ filesTabDiffView: diffView }),\n    setFilesTabContentViewMode: (mode) =>\n      updateState({ filesTabContentViewMode: mode }),\n  };\n}\n"],"mappings":"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"}

package/dist/utils/conversation-local-storage.js

@@ -16,7 +16,8 @@ var n = {
 	"browser",
 	"terminal",
 	"planner",
-	"tasklist"
+	"tasklist",
+	"usage"
 ]), o = new Set([
 	"editor",
 	"served",

package/dist/utils/conversation-local-storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-local-storage.js","names":[],"sources":["../../src/utils/conversation-local-storage.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type {\n  ConversationTab,\n  ConversationMode,\n} from \"#/stores/conversation-store\";\nimport type { ViewMode } from \"#/components/features/files-tab/view-mode\";\n\nexport const LOCAL_STORAGE_KEYS = {\n  CONVERSATION_STATE: \"conversation-state\",\n  PENDING_TASK_DRAFT: \"pending-task-draft\",\n} as const;\n\nconst CONVERSATION_STATE_UPDATED_EVENT = \"conversation-state-updated\";\n\ntype ConversationStateUpdatedDetail = {\n  conversationId: string;\n};\n\n/**\n * Consolidated conversation state stored in a single localStorage key.\n *\n * NOTE: the right-drawer open/closed state is intentionally *not* persisted\n * here. Users expect the drawer to start closed every time the app is\n * (re)loaded and only stay open when they opened it themselves during the\n * current session. That state lives in the in-memory Zustand\n * `useConversationStore` (`isRightPanelShown` / `hasRightPanelToggled`)\n * which survives in-app navigation but resets on full reloads. Older\n * builds wrote a `rightPanelShown` field into this blob; we accept and\n * silently ignore that field on read so we don't churn old localStorage.\n */\nexport interface ConversationState {\n  selectedTab: ConversationTab | null;\n  unpinnedTabs: string[];\n  conversationMode: ConversationMode;\n  subConversationTaskId: string | null;\n  draftMessage: string | null;\n  /**\n   * User's persisted choice for the Files tab diff-vs-files toggle.\n   * `null` means \"no explicit choice yet\" — the Files tab then falls back\n   * to its repo-aware default (diff inside a git repo with commits, files\n   * otherwise).\n   */\n  filesTabDiffView: boolean | null;\n  /** User's persisted choice for the Files tab Rich/Plain content toggle. */\n  filesTabContentViewMode: ViewMode;\n}\n\nconst DEFAULT_CONVERSATION_STATE: ConversationState = {\n  selectedTab: \"files\",\n  unpinnedTabs: [],\n  conversationMode: \"code\",\n  subConversationTaskId: null,\n  draftMessage: null,\n  filesTabDiffView: null,\n  filesTabContentViewMode: \"rich\",\n};\n\nconst VALID_CONVERSATION_TABS: ReadonlySet<ConversationTab> = new Set([\n  \"files\",\n  \"browser\",\n  \"terminal\",\n  \"planner\",\n  \"tasklist\",\n]);\n\n// Tab keys that *used to* exist and were removed during the Files tab\n// refactor. We strip these out of any persisted state on read so that\n// returning users don't keep ghost entries (in `selectedTab` or\n// `unpinnedTabs`) forever — the UI has no way to surface them again to\n// be re-pinned or re-selected. We deliberately use an explicit denylist\n// here rather than a strict \"whitelist against VALID_CONVERSATION_TABS\"\n// filter because `unpinnedTabs` is typed `string[]` and other parts of\n// the app legitimately store arbitrary tab keys in it (sub-conversation\n// tab ids etc.).\nconst REMOVED_CONVERSATION_TABS: ReadonlySet<string> = new Set([\n  \"editor\",\n  \"served\",\n  \"changes\",\n  \"app\",\n  \"vscode\",\n]);\n\nconst VALID_VIEW_MODES: ReadonlySet<ViewMode> = new Set([\"rich\", \"plain\"]);\n\nfunction sanitizeStoredState(\n  stored: Record<string, unknown>,\n): Partial<ConversationState> {\n  // `rightPanelShown` is no longer part of the schema (the drawer's\n  // open state is session-only) but old persisted blobs still carry it.\n  // We just drop it on the way in — keeping it in `result` here would\n  // pollute the merged `ConversationState` shape that consumers receive.\n  const { rightPanelShown: _ignoredRightPanelShown, ...rest } = stored as {\n    rightPanelShown?: unknown;\n  } & Record<string, unknown>;\n  let result: Partial<ConversationState> = rest as Partial<ConversationState>;\n\n  if (\n    result.selectedTab != null &&\n    (REMOVED_CONVERSATION_TABS.has(result.selectedTab) ||\n      !VALID_CONVERSATION_TABS.has(result.selectedTab as ConversationTab))\n  ) {\n    result = { ...result };\n    delete result.selectedTab;\n  }\n\n  if (result.unpinnedTabs) {\n    const filtered = result.unpinnedTabs.filter(\n      (tab) => !REMOVED_CONVERSATION_TABS.has(tab),\n    );\n    if (filtered.length !== result.unpinnedTabs.length) {\n      result = { ...result, unpinnedTabs: filtered };\n    }\n  }\n\n  // Drop a corrupt/manually-edited `filesTabContentViewMode` so it falls\n  // back to the typed default (\"rich\") instead of leaking a junk string\n  // into ViewMode-typed consumers. TypeScript can't help us here — the\n  // value comes from `JSON.parse(localStorage.getItem(...))` which is\n  // unknown at runtime.\n  if (\n    result.filesTabContentViewMode != null &&\n    !VALID_VIEW_MODES.has(result.filesTabContentViewMode)\n  ) {\n    result = { ...result };\n    delete result.filesTabContentViewMode;\n  }\n\n  return result;\n}\n\n/**\n * Check if a conversation ID is a temporary task ID that should not be persisted.\n * Task IDs have the format \"task-{uuid}\" and are used during V1 conversation initialization.\n */\nexport function isTaskConversationId(conversationId: string): boolean {\n  return conversationId.startsWith(\"task-\");\n}\n\n/**\n * Whether persistence should be skipped for this conversation id.\n *\n * Skips:\n *  - empty string ids (callers outside of a conversation route, e.g.\n *    rendered inside a unit test without a NavigationProvider)\n *  - \"task-...\" ids used as placeholders during V1 conversation\n *    initialization\n */\nfunction shouldSkipPersistence(conversationId: string): boolean {\n  return conversationId === \"\" || isTaskConversationId(conversationId);\n}\n\n/**\n * Get the full conversation state from localStorage.\n */\nexport function getConversationState(\n  conversationId: string,\n): ConversationState {\n  if (shouldSkipPersistence(conversationId)) {\n    return DEFAULT_CONVERSATION_STATE;\n  }\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    const item = localStorage.getItem(key);\n    if (item !== null) {\n      return {\n        ...DEFAULT_CONVERSATION_STATE,\n        ...sanitizeStoredState(JSON.parse(item)),\n      };\n    }\n    return DEFAULT_CONVERSATION_STATE;\n  } catch {\n    return DEFAULT_CONVERSATION_STATE;\n  }\n}\n\n/**\n * Set the conversation state in localStorage, merging with existing state.\n */\nexport function setConversationState(\n  conversationId: string,\n  updates: Partial<ConversationState>,\n): void {\n  if (shouldSkipPersistence(conversationId)) {\n    return;\n  }\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    const currentState = getConversationState(conversationId);\n    const newState = { ...currentState, ...updates };\n    localStorage.setItem(key, JSON.stringify(newState));\n    if (typeof window !== \"undefined\") {\n      window.dispatchEvent(\n        new CustomEvent<ConversationStateUpdatedDetail>(\n          CONVERSATION_STATE_UPDATED_EVENT,\n          { detail: { conversationId } },\n        ),\n      );\n    }\n  } catch (err) {\n    console.warn(\"Failed to set conversation localStorage\", err);\n  }\n}\n\nfunction getPendingTaskDraftKey(taskId: string): string {\n  return `${LOCAL_STORAGE_KEYS.PENDING_TASK_DRAFT}-${taskId}`;\n}\n\nexport function setPendingTaskDraft(\n  taskId: string | null | undefined,\n  draftMessage: string,\n): void {\n  if (!taskId) return;\n  try {\n    localStorage.setItem(getPendingTaskDraftKey(taskId), draftMessage);\n  } catch (err) {\n    console.warn(\"Failed to store pending task draft\", err);\n  }\n}\n\nexport function consumePendingTaskDraft(\n  taskId: string | null | undefined,\n): string | null {\n  if (!taskId) return null;\n  try {\n    const key = getPendingTaskDraftKey(taskId);\n    const draft = localStorage.getItem(key);\n    localStorage.removeItem(key);\n    return draft;\n  } catch (err) {\n    console.warn(\"Failed to consume pending task draft\", err);\n    return null;\n  }\n}\n\nexport function clearConversationLocalStorage(conversationId: string) {\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    localStorage.removeItem(key);\n    if (typeof window !== \"undefined\") {\n      window.dispatchEvent(\n        new CustomEvent<ConversationStateUpdatedDetail>(\n          CONVERSATION_STATE_UPDATED_EVENT,\n          { detail: { conversationId } },\n        ),\n      );\n    }\n  } catch (err) {\n    console.warn(\n      \"Failed to clear conversation localStorage\",\n      conversationId,\n      err,\n    );\n  }\n}\n\n/**\n * React hook for conversation-scoped localStorage state.\n * Returns the full state and individual setters for each property.\n *\n * The right-drawer open state is deliberately not represented here —\n * see the note on `ConversationState` for the rationale.\n */\nexport function useConversationLocalStorageState(conversationId: string): {\n  state: ConversationState;\n  setSelectedTab: (tab: ConversationTab | null) => void;\n  setUnpinnedTabs: (tabs: string[]) => void;\n  setConversationMode: (mode: ConversationMode) => void;\n  setDraftMessage: (message: string | null) => void;\n  setFilesTabDiffView: (diffView: boolean | null) => void;\n  setFilesTabContentViewMode: (mode: ViewMode) => void;\n} {\n  const [state, setState] = useState<ConversationState>(() =>\n    getConversationState(conversationId),\n  );\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return undefined;\n    }\n\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n\n    const syncState = () => {\n      setState(getConversationState(conversationId));\n    };\n\n    const handleStorage = (event: StorageEvent) => {\n      if (event.key === key) {\n        syncState();\n      }\n    };\n\n    const handleConversationStateUpdated = (event: Event) => {\n      const customEvent = event as CustomEvent<ConversationStateUpdatedDetail>;\n      if (customEvent.detail?.conversationId === conversationId) {\n        syncState();\n      }\n    };\n\n    // Ensure this hook reflects latest state for the current conversation ID.\n    syncState();\n\n    window.addEventListener(\"storage\", handleStorage);\n    window.addEventListener(\n      CONVERSATION_STATE_UPDATED_EVENT,\n      handleConversationStateUpdated,\n    );\n\n    return () => {\n      window.removeEventListener(\"storage\", handleStorage);\n      window.removeEventListener(\n        CONVERSATION_STATE_UPDATED_EVENT,\n        handleConversationStateUpdated,\n      );\n    };\n  }, [conversationId]);\n\n  const updateState = (updates: Partial<ConversationState>) => {\n    if (shouldSkipPersistence(conversationId)) {\n      // No durable storage for this id (empty / task placeholder), but the\n      // hook is still useful as ephemeral in-memory state — update the\n      // local React mirror directly so toggles in the UI behave normally\n      // until a real conversation id arrives.\n      setState((prev) => ({ ...prev, ...updates }));\n      return;\n    }\n    setConversationState(conversationId, updates);\n  };\n\n  return {\n    state,\n    setSelectedTab: (tab) => updateState({ selectedTab: tab }),\n    setUnpinnedTabs: (tabs) => updateState({ unpinnedTabs: tabs }),\n    setConversationMode: (mode) => updateState({ conversationMode: mode }),\n    setDraftMessage: (message) => updateState({ draftMessage: message }),\n    setFilesTabDiffView: (diffView) =>\n      updateState({ filesTabDiffView: diffView }),\n    setFilesTabContentViewMode: (mode) =>\n      updateState({ filesTabContentViewMode: mode }),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"conversation-local-storage.js","names":[],"sources":["../../src/utils/conversation-local-storage.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport type {\n  ConversationTab,\n  ConversationMode,\n} from \"#/stores/conversation-store\";\nimport type { ViewMode } from \"#/components/features/files-tab/view-mode\";\n\nexport const LOCAL_STORAGE_KEYS = {\n  CONVERSATION_STATE: \"conversation-state\",\n  PENDING_TASK_DRAFT: \"pending-task-draft\",\n} as const;\n\nconst CONVERSATION_STATE_UPDATED_EVENT = \"conversation-state-updated\";\n\ntype ConversationStateUpdatedDetail = {\n  conversationId: string;\n};\n\n/**\n * Consolidated conversation state stored in a single localStorage key.\n *\n * NOTE: the right-drawer open/closed state is intentionally *not* persisted\n * here. Users expect the drawer to start closed every time the app is\n * (re)loaded and only stay open when they opened it themselves during the\n * current session. That state lives in the in-memory Zustand\n * `useConversationStore` (`isRightPanelShown` / `hasRightPanelToggled`)\n * which survives in-app navigation but resets on full reloads. Older\n * builds wrote a `rightPanelShown` field into this blob; we accept and\n * silently ignore that field on read so we don't churn old localStorage.\n */\nexport interface ConversationState {\n  selectedTab: ConversationTab | null;\n  unpinnedTabs: string[];\n  conversationMode: ConversationMode;\n  subConversationTaskId: string | null;\n  draftMessage: string | null;\n  /**\n   * User's persisted choice for the Files tab diff-vs-files toggle.\n   * `null` means \"no explicit choice yet\" — the Files tab then falls back\n   * to its repo-aware default (diff inside a git repo with commits, files\n   * otherwise).\n   */\n  filesTabDiffView: boolean | null;\n  /** User's persisted choice for the Files tab Rich/Plain content toggle. */\n  filesTabContentViewMode: ViewMode;\n}\n\nconst DEFAULT_CONVERSATION_STATE: ConversationState = {\n  selectedTab: \"files\",\n  unpinnedTabs: [],\n  conversationMode: \"code\",\n  subConversationTaskId: null,\n  draftMessage: null,\n  filesTabDiffView: null,\n  filesTabContentViewMode: \"rich\",\n};\n\nconst VALID_CONVERSATION_TABS: ReadonlySet<ConversationTab> = new Set([\n  \"files\",\n  \"browser\",\n  \"terminal\",\n  \"planner\",\n  \"tasklist\",\n  \"usage\",\n]);\n\n// Tab keys that *used to* exist and were removed during the Files tab\n// refactor. We strip these out of any persisted state on read so that\n// returning users don't keep ghost entries (in `selectedTab` or\n// `unpinnedTabs`) forever — the UI has no way to surface them again to\n// be re-pinned or re-selected. We deliberately use an explicit denylist\n// here rather than a strict \"whitelist against VALID_CONVERSATION_TABS\"\n// filter because `unpinnedTabs` is typed `string[]` and other parts of\n// the app legitimately store arbitrary tab keys in it (sub-conversation\n// tab ids etc.).\nconst REMOVED_CONVERSATION_TABS: ReadonlySet<string> = new Set([\n  \"editor\",\n  \"served\",\n  \"changes\",\n  \"app\",\n  \"vscode\",\n]);\n\nconst VALID_VIEW_MODES: ReadonlySet<ViewMode> = new Set([\"rich\", \"plain\"]);\n\nfunction sanitizeStoredState(\n  stored: Record<string, unknown>,\n): Partial<ConversationState> {\n  // `rightPanelShown` is no longer part of the schema (the drawer's\n  // open state is session-only) but old persisted blobs still carry it.\n  // We just drop it on the way in — keeping it in `result` here would\n  // pollute the merged `ConversationState` shape that consumers receive.\n  const { rightPanelShown: _ignoredRightPanelShown, ...rest } = stored as {\n    rightPanelShown?: unknown;\n  } & Record<string, unknown>;\n  let result: Partial<ConversationState> = rest as Partial<ConversationState>;\n\n  if (\n    result.selectedTab != null &&\n    (REMOVED_CONVERSATION_TABS.has(result.selectedTab) ||\n      !VALID_CONVERSATION_TABS.has(result.selectedTab as ConversationTab))\n  ) {\n    result = { ...result };\n    delete result.selectedTab;\n  }\n\n  if (result.unpinnedTabs) {\n    const filtered = result.unpinnedTabs.filter(\n      (tab) => !REMOVED_CONVERSATION_TABS.has(tab),\n    );\n    if (filtered.length !== result.unpinnedTabs.length) {\n      result = { ...result, unpinnedTabs: filtered };\n    }\n  }\n\n  // Drop a corrupt/manually-edited `filesTabContentViewMode` so it falls\n  // back to the typed default (\"rich\") instead of leaking a junk string\n  // into ViewMode-typed consumers. TypeScript can't help us here — the\n  // value comes from `JSON.parse(localStorage.getItem(...))` which is\n  // unknown at runtime.\n  if (\n    result.filesTabContentViewMode != null &&\n    !VALID_VIEW_MODES.has(result.filesTabContentViewMode)\n  ) {\n    result = { ...result };\n    delete result.filesTabContentViewMode;\n  }\n\n  return result;\n}\n\n/**\n * Check if a conversation ID is a temporary task ID that should not be persisted.\n * Task IDs have the format \"task-{uuid}\" and are used during V1 conversation initialization.\n */\nexport function isTaskConversationId(conversationId: string): boolean {\n  return conversationId.startsWith(\"task-\");\n}\n\n/**\n * Whether persistence should be skipped for this conversation id.\n *\n * Skips:\n *  - empty string ids (callers outside of a conversation route, e.g.\n *    rendered inside a unit test without a NavigationProvider)\n *  - \"task-...\" ids used as placeholders during V1 conversation\n *    initialization\n */\nfunction shouldSkipPersistence(conversationId: string): boolean {\n  return conversationId === \"\" || isTaskConversationId(conversationId);\n}\n\n/**\n * Get the full conversation state from localStorage.\n */\nexport function getConversationState(\n  conversationId: string,\n): ConversationState {\n  if (shouldSkipPersistence(conversationId)) {\n    return DEFAULT_CONVERSATION_STATE;\n  }\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    const item = localStorage.getItem(key);\n    if (item !== null) {\n      return {\n        ...DEFAULT_CONVERSATION_STATE,\n        ...sanitizeStoredState(JSON.parse(item)),\n      };\n    }\n    return DEFAULT_CONVERSATION_STATE;\n  } catch {\n    return DEFAULT_CONVERSATION_STATE;\n  }\n}\n\n/**\n * Set the conversation state in localStorage, merging with existing state.\n */\nexport function setConversationState(\n  conversationId: string,\n  updates: Partial<ConversationState>,\n): void {\n  if (shouldSkipPersistence(conversationId)) {\n    return;\n  }\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    const currentState = getConversationState(conversationId);\n    const newState = { ...currentState, ...updates };\n    localStorage.setItem(key, JSON.stringify(newState));\n    if (typeof window !== \"undefined\") {\n      window.dispatchEvent(\n        new CustomEvent<ConversationStateUpdatedDetail>(\n          CONVERSATION_STATE_UPDATED_EVENT,\n          { detail: { conversationId } },\n        ),\n      );\n    }\n  } catch (err) {\n    console.warn(\"Failed to set conversation localStorage\", err);\n  }\n}\n\nfunction getPendingTaskDraftKey(taskId: string): string {\n  return `${LOCAL_STORAGE_KEYS.PENDING_TASK_DRAFT}-${taskId}`;\n}\n\nexport function setPendingTaskDraft(\n  taskId: string | null | undefined,\n  draftMessage: string,\n): void {\n  if (!taskId) return;\n  try {\n    localStorage.setItem(getPendingTaskDraftKey(taskId), draftMessage);\n  } catch (err) {\n    console.warn(\"Failed to store pending task draft\", err);\n  }\n}\n\nexport function consumePendingTaskDraft(\n  taskId: string | null | undefined,\n): string | null {\n  if (!taskId) return null;\n  try {\n    const key = getPendingTaskDraftKey(taskId);\n    const draft = localStorage.getItem(key);\n    localStorage.removeItem(key);\n    return draft;\n  } catch (err) {\n    console.warn(\"Failed to consume pending task draft\", err);\n    return null;\n  }\n}\n\nexport function clearConversationLocalStorage(conversationId: string) {\n  try {\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n    localStorage.removeItem(key);\n    if (typeof window !== \"undefined\") {\n      window.dispatchEvent(\n        new CustomEvent<ConversationStateUpdatedDetail>(\n          CONVERSATION_STATE_UPDATED_EVENT,\n          { detail: { conversationId } },\n        ),\n      );\n    }\n  } catch (err) {\n    console.warn(\n      \"Failed to clear conversation localStorage\",\n      conversationId,\n      err,\n    );\n  }\n}\n\n/**\n * React hook for conversation-scoped localStorage state.\n * Returns the full state and individual setters for each property.\n *\n * The right-drawer open state is deliberately not represented here —\n * see the note on `ConversationState` for the rationale.\n */\nexport function useConversationLocalStorageState(conversationId: string): {\n  state: ConversationState;\n  setSelectedTab: (tab: ConversationTab | null) => void;\n  setUnpinnedTabs: (tabs: string[]) => void;\n  setConversationMode: (mode: ConversationMode) => void;\n  setDraftMessage: (message: string | null) => void;\n  setFilesTabDiffView: (diffView: boolean | null) => void;\n  setFilesTabContentViewMode: (mode: ViewMode) => void;\n} {\n  const [state, setState] = useState<ConversationState>(() =>\n    getConversationState(conversationId),\n  );\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") {\n      return undefined;\n    }\n\n    const key = `${LOCAL_STORAGE_KEYS.CONVERSATION_STATE}-${conversationId}`;\n\n    const syncState = () => {\n      setState(getConversationState(conversationId));\n    };\n\n    const handleStorage = (event: StorageEvent) => {\n      if (event.key === key) {\n        syncState();\n      }\n    };\n\n    const handleConversationStateUpdated = (event: Event) => {\n      const customEvent = event as CustomEvent<ConversationStateUpdatedDetail>;\n      if (customEvent.detail?.conversationId === conversationId) {\n        syncState();\n      }\n    };\n\n    // Ensure this hook reflects latest state for the current conversation ID.\n    syncState();\n\n    window.addEventListener(\"storage\", handleStorage);\n    window.addEventListener(\n      CONVERSATION_STATE_UPDATED_EVENT,\n      handleConversationStateUpdated,\n    );\n\n    return () => {\n      window.removeEventListener(\"storage\", handleStorage);\n      window.removeEventListener(\n        CONVERSATION_STATE_UPDATED_EVENT,\n        handleConversationStateUpdated,\n      );\n    };\n  }, [conversationId]);\n\n  const updateState = (updates: Partial<ConversationState>) => {\n    if (shouldSkipPersistence(conversationId)) {\n      // No durable storage for this id (empty / task placeholder), but the\n      // hook is still useful as ephemeral in-memory state — update the\n      // local React mirror directly so toggles in the UI behave normally\n      // until a real conversation id arrives.\n      setState((prev) => ({ ...prev, ...updates }));\n      return;\n    }\n    setConversationState(conversationId, updates);\n  };\n\n  return {\n    state,\n    setSelectedTab: (tab) => updateState({ selectedTab: tab }),\n    setUnpinnedTabs: (tabs) => updateState({ unpinnedTabs: tabs }),\n    setConversationMode: (mode) => updateState({ conversationMode: mode }),\n    setDraftMessage: (message) => updateState({ draftMessage: message }),\n    setFilesTabDiffView: (diffView) =>\n      updateState({ filesTabDiffView: diffView }),\n    setFilesTabContentViewMode: (mode) =>\n      updateState({ filesTabContentViewMode: mode }),\n  };\n}\n"],"mappings":"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"}

package/dist/utils/error-handler.cjs

@@ -1,2 +1,2 @@
-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;
+require("../_virtual/_rolldown/runtime.cjs");const e=require("../services/telemetry.cjs");var t=new Set([`error_source`,`error_kind`,`error_id`,`error_telemetry`]);function n({source:n,metadata:r={},classification:i}){let a=Object.fromEntries(Object.entries(r).filter(([e])=>!t.has(e))),o=i?.kind||`unknown`,s=typeof r.eventId==`string`?r.eventId:void 0;s!=null&&delete a.eventId;let c=i?.error_id??s;e.trackEvent(`error_outcome`,{...a,current_url:window.location.href,error_source:n||`unknown`,error_kind:o,...c==null?{}:{error_id:c},error_telemetry:o===`internal`||o===`unknown`?`diagnostic`:`outcome`})}exports.trackError=n;
 //# 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 { 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,CAAC,GAAmB,CAE3E,EAAK,eADa,MAAM,CACJ,EAAO,CACzB,aAAc,GAAU,UACxB,GAAG,CACL,CAAC,CACH"}
+{"version":3,"file":"error-handler.cjs","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import { trackEvent } from \"#/services/telemetry\";\nimport type { ErrorClassification } from \"@openhands/typescript-client\";\n\ninterface ErrorDetails {\n  source?: string;\n  metadata?: Record<string, unknown>;\n  classification?: ErrorClassification | null;\n}\n\nconst RESERVED_ERROR_KEYS = new Set([\n  \"error_source\",\n  \"error_kind\",\n  \"error_id\",\n  \"error_telemetry\",\n]);\n\nexport function trackError({\n  source,\n  metadata = {},\n  classification,\n}: ErrorDetails) {\n  // Reserved outcome fields are derived from `source`/`classification` and\n  // must not be overridable through arbitrary caller metadata.\n  const extra = Object.fromEntries(\n    Object.entries(metadata).filter(([key]) => !RESERVED_ERROR_KEYS.has(key)),\n  );\n  const kind = classification?.kind || \"unknown\";\n  // Promote a caller-provided `eventId` to the reserved `error_id` dimension as\n  // a fallback so unclassified errors stay correlatable with server-side logs.\n  const promotedEventId =\n    typeof metadata.eventId === \"string\" ? metadata.eventId : undefined;\n  if (promotedEventId != null) {\n    delete extra.eventId;\n  }\n  const errorId = classification?.error_id ?? promotedEventId;\n\n  void trackEvent(\"error_outcome\", {\n    ...extra,\n    current_url: window.location.href,\n    error_source: source || \"unknown\",\n    error_kind: kind,\n    // Keep diagnostic errors correlatable without capturing raw messages.\n    ...(errorId != null ? { error_id: errorId } : {}),\n    error_telemetry:\n      kind === \"internal\" || kind === \"unknown\" ? \"diagnostic\" : \"outcome\",\n  });\n}\n"],"mappings":"0FASA,IAAM,EAAsB,IAAI,IAAI,CAClC,eACA,aACA,WACA,iBACF,CAAC,EAED,SAAgB,EAAW,CACzB,SACA,WAAW,CAAC,EACZ,kBACe,CAGf,IAAM,EAAQ,OAAO,YACnB,OAAO,QAAQ,CAAQ,EAAE,QAAQ,CAAC,KAAS,CAAC,EAAoB,IAAI,CAAG,CAAC,CAC1E,EACM,EAAO,GAAgB,MAAQ,UAG/B,EACJ,OAAO,EAAS,SAAY,SAAW,EAAS,QAAU,IAAA,GACxD,GAAmB,MACrB,OAAO,EAAM,QAEf,IAAM,EAAU,GAAgB,UAAY,EAE5C,EAAK,WAAW,gBAAiB,CAC/B,GAAG,EACH,YAAa,OAAO,SAAS,KAC7B,aAAc,GAAU,UACxB,WAAY,EAEZ,GAAI,GAAW,KAA+B,CAAC,EAAzB,CAAE,SAAU,CAAQ,EAC1C,gBACE,IAAS,YAAc,IAAS,UAAY,aAAe,SAC/D,CAAC,CACH"}

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

@@ -1,7 +1,8 @@
+import type { ErrorClassification } from "@openhands/typescript-client";
 interface ErrorDetails {
-    message: string;
     source?: string;
     metadata?: Record<string, unknown>;
+    classification?: ErrorClassification | null;
 }
-export declare function trackError({ message, source, metadata }: ErrorDetails): void;
+export declare function trackError({ source, metadata, classification, }: ErrorDetails): void;
 export {};

package/dist/utils/error-handler.js

@@ -1,12 +1,25 @@
-import { trackException as e } from "../services/telemetry.js";
+import { trackEvent as e } from "../services/telemetry.js";
 //#region src/utils/error-handler.ts
-function t({ message: t, source: n, metadata: r = {} }) {
-	e(Error(t), {
+var t = new Set([
+	"error_source",
+	"error_kind",
+	"error_id",
+	"error_telemetry"
+]);
+function n({ source: n, metadata: r = {}, classification: i }) {
+	let a = Object.fromEntries(Object.entries(r).filter(([e]) => !t.has(e))), o = i?.kind || "unknown", s = typeof r.eventId == "string" ? r.eventId : void 0;
+	s != null && delete a.eventId;
+	let c = i?.error_id ?? s;
+	e("error_outcome", {
+		...a,
+		current_url: window.location.href,
 		error_source: n || "unknown",
-		...r
+		error_kind: o,
+		...c == null ? {} : { error_id: c },
+		error_telemetry: o === "internal" || o === "unknown" ? "diagnostic" : "outcome"
 	});
 }
 //#endregion
-export { t as trackError };
+export { n 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 { 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,CAAC,KAAmB;CAE3E,EADkB,MAAM,CACJ,GAAO;EACzB,cAAc,KAAU;EACxB,GAAG;CACL,CAAC;AACH"}
+{"version":3,"file":"error-handler.js","names":[],"sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import { trackEvent } from \"#/services/telemetry\";\nimport type { ErrorClassification } from \"@openhands/typescript-client\";\n\ninterface ErrorDetails {\n  source?: string;\n  metadata?: Record<string, unknown>;\n  classification?: ErrorClassification | null;\n}\n\nconst RESERVED_ERROR_KEYS = new Set([\n  \"error_source\",\n  \"error_kind\",\n  \"error_id\",\n  \"error_telemetry\",\n]);\n\nexport function trackError({\n  source,\n  metadata = {},\n  classification,\n}: ErrorDetails) {\n  // Reserved outcome fields are derived from `source`/`classification` and\n  // must not be overridable through arbitrary caller metadata.\n  const extra = Object.fromEntries(\n    Object.entries(metadata).filter(([key]) => !RESERVED_ERROR_KEYS.has(key)),\n  );\n  const kind = classification?.kind || \"unknown\";\n  // Promote a caller-provided `eventId` to the reserved `error_id` dimension as\n  // a fallback so unclassified errors stay correlatable with server-side logs.\n  const promotedEventId =\n    typeof metadata.eventId === \"string\" ? metadata.eventId : undefined;\n  if (promotedEventId != null) {\n    delete extra.eventId;\n  }\n  const errorId = classification?.error_id ?? promotedEventId;\n\n  void trackEvent(\"error_outcome\", {\n    ...extra,\n    current_url: window.location.href,\n    error_source: source || \"unknown\",\n    error_kind: kind,\n    // Keep diagnostic errors correlatable without capturing raw messages.\n    ...(errorId != null ? { error_id: errorId } : {}),\n    error_telemetry:\n      kind === \"internal\" || kind === \"unknown\" ? \"diagnostic\" : \"outcome\",\n  });\n}\n"],"mappings":";;AASA,IAAM,IAAsB,IAAI,IAAI;CAClC;CACA;CACA;CACA;AACF,CAAC;AAED,SAAgB,EAAW,EACzB,WACA,cAAW,CAAC,GACZ,qBACe;CAGf,IAAM,IAAQ,OAAO,YACnB,OAAO,QAAQ,CAAQ,EAAE,QAAQ,CAAC,OAAS,CAAC,EAAoB,IAAI,CAAG,CAAC,CAC1E,GACM,IAAO,GAAgB,QAAQ,WAG/B,IACJ,OAAO,EAAS,WAAY,WAAW,EAAS,UAAU,KAAA;CAC5D,AAAI,KAAmB,QACrB,OAAO,EAAM;CAEf,IAAM,IAAU,GAAgB,YAAY;CAE5C,EAAgB,iBAAiB;EAC/B,GAAG;EACH,aAAa,OAAO,SAAS;EAC7B,cAAc,KAAU;EACxB,YAAY;EAEZ,GAAI,KAAW,OAA+B,CAAC,IAAzB,EAAE,UAAU,EAAQ;EAC1C,iBACE,MAAS,cAAc,MAAS,YAAY,eAAe;CAC/D,CAAC;AACH"}

package/dist/utils/format-model-name.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");var e=`Free`,t={"openhands/glm-5.2":`OpenHands GLM-5.2 (free)`,"openhands/deepseek-v4-flash":`OpenHands DeepSeek V4 Flash (free)`,"openhands/minimax-m2.7":`OpenHands MiniMax M2.7 (free)`},n=`Free OpenHands models: ${Object.keys(t).join(`, `)}. Other provider endpoints with similar model names may require separate billing.`,r=e=>!!(e&&e in t);function i(e){return e?r(e)?t[e]:e:null}function a(e){return e?r(e)?t[e]:e.split(`/`).pop()||e:null}exports.FREE_MODEL_BADGE_LABEL=e,exports.FREE_OPENHANDS_MODEL_NOTE=n,exports.formatModelNameForDisplay=i,exports.formatNativeModelName=a,exports.isFreeOpenHandsModel=r;
+require("../_virtual/_rolldown/runtime.cjs");var e=`Free`,t={"openhands/kimi-k3":`OpenHands Kimi K3 (free)`,"openhands/glm-5.2":`OpenHands GLM-5.2 (free)`,"openhands/deepseek-v4-flash":`OpenHands DeepSeek V4 Flash (free)`,"openhands/minimax-m2.7":`OpenHands MiniMax M2.7 (free)`},n=`Free OpenHands models: ${Object.keys(t).join(`, `)}. Other provider endpoints with similar model names may require separate billing.`,r=e=>!!(e&&e in t);function i(e){return e?r(e)?t[e]:e:null}function a(e){return e?r(e)?t[e]:e.split(`/`).pop()||e:null}exports.FREE_MODEL_BADGE_LABEL=e,exports.FREE_OPENHANDS_MODEL_NOTE=n,exports.formatModelNameForDisplay=i,exports.formatNativeModelName=a,exports.isFreeOpenHandsModel=r;
 //# sourceMappingURL=format-model-name.cjs.map

package/dist/utils/format-model-name.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"format-model-name.cjs","names":[],"sources":["../../src/utils/format-model-name.ts"],"sourcesContent":["export const FREE_MODEL_BADGE_LABEL = \"Free\";\n\nexport const FREE_OPENHANDS_MODELS = {\n  \"openhands/glm-5.2\": \"OpenHands GLM-5.2 (free)\",\n  \"openhands/deepseek-v4-flash\": \"OpenHands DeepSeek V4 Flash (free)\",\n  \"openhands/minimax-m2.7\": \"OpenHands MiniMax M2.7 (free)\",\n} as const;\n\nexport const FREE_OPENHANDS_MODEL_IDS = Object.keys(FREE_OPENHANDS_MODELS);\nexport const FREE_OPENHANDS_MODEL_NOTE = `Free OpenHands models: ${FREE_OPENHANDS_MODEL_IDS.join(\n  \", \",\n)}. Other provider endpoints with similar model names may require separate billing.`;\n\nexport const isFreeOpenHandsModel = (\n  model: string | null | undefined,\n): model is keyof typeof FREE_OPENHANDS_MODELS =>\n  Boolean(model && model in FREE_OPENHANDS_MODELS);\n\nexport function formatModelNameForDisplay(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  return isFreeOpenHandsModel(model) ? FREE_OPENHANDS_MODELS[model] : model;\n}\n\nexport function formatProviderModelNameForDisplay(\n  provider: string | null | undefined,\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  const fullModel = provider ? `${provider}/${model}` : model;\n  return isFreeOpenHandsModel(fullModel)\n    ? FREE_OPENHANDS_MODELS[fullModel]\n    : model;\n}\n\n/**\n * Format a native (OpenHands-kind) routing model string for display, stripping\n * the provider route prefix (e.g. ``\"anthropic/claude-sonnet-4-5-20250929\"`` →\n * ``\"claude-sonnet-4-5-20250929\"``, ``\"litellm_proxy/openai/gpt-4o\"`` →\n * ``\"gpt-4o\"``) so a conversation chip shows a meaningful model name rather than\n * the full routing path.\n *\n * Returns ``null`` for an empty/nullish input, and falls back to the original\n * string when stripping the prefix would leave nothing (e.g. a trailing slash)\n * — never an empty string, which would collapse the chip text.\n *\n * Display-only: unlike {@link deriveProfileNameFromModel} this does not sanitize\n * to an identifier, so it keeps the real model id intact for the chip.\n */\nexport function formatNativeModelName(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  if (isFreeOpenHandsModel(model)) return FREE_OPENHANDS_MODELS[model];\n  const lastSegment = model.split(\"/\").pop();\n  return lastSegment || model;\n}\n"],"mappings":"6CAAA,IAAa,EAAyB,OAEzB,EAAwB,CACnC,oBAAqB,2BACrB,8BAA+B,qCAC/B,yBAA0B,+BAC5B,EAGa,EAA4B,0BADD,OAAO,KAAK,CACe,EAAyB,KAC1F,IACF,EAAE,mFAEW,EACX,GAEA,GAAQ,GAAS,KAAS,GAE5B,SAAgB,EACd,EACe,CAEf,OADK,EACE,EAAqB,CAAK,EAAI,EAAsB,GAAS,EADjD,IAErB,CA2BA,SAAgB,EACd,EACe,CAIf,OAHK,EACD,EAAqB,CAAK,EAAU,EAAsB,GAC1C,EAAM,MAAM,GAAG,EAAE,IAC9B,GAAe,EAHH,IAIrB"}
+{"version":3,"file":"format-model-name.cjs","names":[],"sources":["../../src/utils/format-model-name.ts"],"sourcesContent":["export const FREE_MODEL_BADGE_LABEL = \"Free\";\n\nexport const FREE_OPENHANDS_MODELS = {\n  \"openhands/kimi-k3\": \"OpenHands Kimi K3 (free)\",\n  \"openhands/glm-5.2\": \"OpenHands GLM-5.2 (free)\",\n  \"openhands/deepseek-v4-flash\": \"OpenHands DeepSeek V4 Flash (free)\",\n  \"openhands/minimax-m2.7\": \"OpenHands MiniMax M2.7 (free)\",\n} as const;\n\nexport const FREE_OPENHANDS_MODEL_IDS = Object.keys(FREE_OPENHANDS_MODELS);\nexport const FREE_OPENHANDS_MODEL_NOTE = `Free OpenHands models: ${FREE_OPENHANDS_MODEL_IDS.join(\n  \", \",\n)}. Other provider endpoints with similar model names may require separate billing.`;\n\nexport const isFreeOpenHandsModel = (\n  model: string | null | undefined,\n): model is keyof typeof FREE_OPENHANDS_MODELS =>\n  Boolean(model && model in FREE_OPENHANDS_MODELS);\n\nexport function formatModelNameForDisplay(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  return isFreeOpenHandsModel(model) ? FREE_OPENHANDS_MODELS[model] : model;\n}\n\nexport function formatProviderModelNameForDisplay(\n  provider: string | null | undefined,\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  const fullModel = provider ? `${provider}/${model}` : model;\n  return isFreeOpenHandsModel(fullModel)\n    ? FREE_OPENHANDS_MODELS[fullModel]\n    : model;\n}\n\n/**\n * Format a native (OpenHands-kind) routing model string for display, stripping\n * the provider route prefix (e.g. ``\"anthropic/claude-sonnet-4-5-20250929\"`` →\n * ``\"claude-sonnet-4-5-20250929\"``, ``\"litellm_proxy/openai/gpt-4o\"`` →\n * ``\"gpt-4o\"``) so a conversation chip shows a meaningful model name rather than\n * the full routing path.\n *\n * Returns ``null`` for an empty/nullish input, and falls back to the original\n * string when stripping the prefix would leave nothing (e.g. a trailing slash)\n * — never an empty string, which would collapse the chip text.\n *\n * Display-only: unlike {@link deriveProfileNameFromModel} this does not sanitize\n * to an identifier, so it keeps the real model id intact for the chip.\n */\nexport function formatNativeModelName(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  if (isFreeOpenHandsModel(model)) return FREE_OPENHANDS_MODELS[model];\n  const lastSegment = model.split(\"/\").pop();\n  return lastSegment || model;\n}\n"],"mappings":"6CAAA,IAAa,EAAyB,OAEzB,EAAwB,CACnC,oBAAqB,2BACrB,oBAAqB,2BACrB,8BAA+B,qCAC/B,yBAA0B,+BAC5B,EAGa,EAA4B,0BADD,OAAO,KAAK,CACe,EAAyB,KAC1F,IACF,EAAE,mFAEW,EACX,GAEA,GAAQ,GAAS,KAAS,GAE5B,SAAgB,EACd,EACe,CAEf,OADK,EACE,EAAqB,CAAK,EAAI,EAAsB,GAAS,EADjD,IAErB,CA2BA,SAAgB,EACd,EACe,CAIf,OAHK,EACD,EAAqB,CAAK,EAAU,EAAsB,GAC1C,EAAM,MAAM,GAAG,EAAE,IAC9B,GAAe,EAHH,IAIrB"}

package/dist/utils/format-model-name.d.ts

@@ -1,5 +1,6 @@
 export declare const FREE_MODEL_BADGE_LABEL = "Free";
 export declare const FREE_OPENHANDS_MODELS: {
+    readonly "openhands/kimi-k3": "OpenHands Kimi K3 (free)";
     readonly "openhands/glm-5.2": "OpenHands GLM-5.2 (free)";
     readonly "openhands/deepseek-v4-flash": "OpenHands DeepSeek V4 Flash (free)";
     readonly "openhands/minimax-m2.7": "OpenHands MiniMax M2.7 (free)";

package/dist/utils/format-model-name.js

@@ -1,5 +1,6 @@
 //#region src/utils/format-model-name.ts
 var e = "Free", t = {
+	"openhands/kimi-k3": "OpenHands Kimi K3 (free)",
 	"openhands/glm-5.2": "OpenHands GLM-5.2 (free)",
 	"openhands/deepseek-v4-flash": "OpenHands DeepSeek V4 Flash (free)",
 	"openhands/minimax-m2.7": "OpenHands MiniMax M2.7 (free)"

package/dist/utils/format-model-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-model-name.js","names":[],"sources":["../../src/utils/format-model-name.ts"],"sourcesContent":["export const FREE_MODEL_BADGE_LABEL = \"Free\";\n\nexport const FREE_OPENHANDS_MODELS = {\n  \"openhands/glm-5.2\": \"OpenHands GLM-5.2 (free)\",\n  \"openhands/deepseek-v4-flash\": \"OpenHands DeepSeek V4 Flash (free)\",\n  \"openhands/minimax-m2.7\": \"OpenHands MiniMax M2.7 (free)\",\n} as const;\n\nexport const FREE_OPENHANDS_MODEL_IDS = Object.keys(FREE_OPENHANDS_MODELS);\nexport const FREE_OPENHANDS_MODEL_NOTE = `Free OpenHands models: ${FREE_OPENHANDS_MODEL_IDS.join(\n  \", \",\n)}. Other provider endpoints with similar model names may require separate billing.`;\n\nexport const isFreeOpenHandsModel = (\n  model: string | null | undefined,\n): model is keyof typeof FREE_OPENHANDS_MODELS =>\n  Boolean(model && model in FREE_OPENHANDS_MODELS);\n\nexport function formatModelNameForDisplay(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  return isFreeOpenHandsModel(model) ? FREE_OPENHANDS_MODELS[model] : model;\n}\n\nexport function formatProviderModelNameForDisplay(\n  provider: string | null | undefined,\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  const fullModel = provider ? `${provider}/${model}` : model;\n  return isFreeOpenHandsModel(fullModel)\n    ? FREE_OPENHANDS_MODELS[fullModel]\n    : model;\n}\n\n/**\n * Format a native (OpenHands-kind) routing model string for display, stripping\n * the provider route prefix (e.g. ``\"anthropic/claude-sonnet-4-5-20250929\"`` →\n * ``\"claude-sonnet-4-5-20250929\"``, ``\"litellm_proxy/openai/gpt-4o\"`` →\n * ``\"gpt-4o\"``) so a conversation chip shows a meaningful model name rather than\n * the full routing path.\n *\n * Returns ``null`` for an empty/nullish input, and falls back to the original\n * string when stripping the prefix would leave nothing (e.g. a trailing slash)\n * — never an empty string, which would collapse the chip text.\n *\n * Display-only: unlike {@link deriveProfileNameFromModel} this does not sanitize\n * to an identifier, so it keeps the real model id intact for the chip.\n */\nexport function formatNativeModelName(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  if (isFreeOpenHandsModel(model)) return FREE_OPENHANDS_MODELS[model];\n  const lastSegment = model.split(\"/\").pop();\n  return lastSegment || model;\n}\n"],"mappings":";AAAA,IAAa,IAAyB,QAEzB,IAAwB;CACnC,qBAAqB;CACrB,+BAA+B;CAC/B,0BAA0B;AAC5B,GAGa,IAA4B,0BADD,OAAO,KAAK,CACe,EAAyB,KAC1F,IACF,EAAE,oFAEW,KACX,MAEA,GAAQ,KAAS,KAAS;AAE5B,SAAgB,EACd,GACe;CAEf,OADK,IACE,EAAqB,CAAK,IAAI,EAAsB,KAAS,IADjD;AAErB;AA2BA,SAAgB,EACd,GACe;CAIf,OAHK,IACD,EAAqB,CAAK,IAAU,EAAsB,KAC1C,EAAM,MAAM,GAAG,EAAE,IAC9B,KAAe,IAHH;AAIrB"}
+{"version":3,"file":"format-model-name.js","names":[],"sources":["../../src/utils/format-model-name.ts"],"sourcesContent":["export const FREE_MODEL_BADGE_LABEL = \"Free\";\n\nexport const FREE_OPENHANDS_MODELS = {\n  \"openhands/kimi-k3\": \"OpenHands Kimi K3 (free)\",\n  \"openhands/glm-5.2\": \"OpenHands GLM-5.2 (free)\",\n  \"openhands/deepseek-v4-flash\": \"OpenHands DeepSeek V4 Flash (free)\",\n  \"openhands/minimax-m2.7\": \"OpenHands MiniMax M2.7 (free)\",\n} as const;\n\nexport const FREE_OPENHANDS_MODEL_IDS = Object.keys(FREE_OPENHANDS_MODELS);\nexport const FREE_OPENHANDS_MODEL_NOTE = `Free OpenHands models: ${FREE_OPENHANDS_MODEL_IDS.join(\n  \", \",\n)}. Other provider endpoints with similar model names may require separate billing.`;\n\nexport const isFreeOpenHandsModel = (\n  model: string | null | undefined,\n): model is keyof typeof FREE_OPENHANDS_MODELS =>\n  Boolean(model && model in FREE_OPENHANDS_MODELS);\n\nexport function formatModelNameForDisplay(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  return isFreeOpenHandsModel(model) ? FREE_OPENHANDS_MODELS[model] : model;\n}\n\nexport function formatProviderModelNameForDisplay(\n  provider: string | null | undefined,\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  const fullModel = provider ? `${provider}/${model}` : model;\n  return isFreeOpenHandsModel(fullModel)\n    ? FREE_OPENHANDS_MODELS[fullModel]\n    : model;\n}\n\n/**\n * Format a native (OpenHands-kind) routing model string for display, stripping\n * the provider route prefix (e.g. ``\"anthropic/claude-sonnet-4-5-20250929\"`` →\n * ``\"claude-sonnet-4-5-20250929\"``, ``\"litellm_proxy/openai/gpt-4o\"`` →\n * ``\"gpt-4o\"``) so a conversation chip shows a meaningful model name rather than\n * the full routing path.\n *\n * Returns ``null`` for an empty/nullish input, and falls back to the original\n * string when stripping the prefix would leave nothing (e.g. a trailing slash)\n * — never an empty string, which would collapse the chip text.\n *\n * Display-only: unlike {@link deriveProfileNameFromModel} this does not sanitize\n * to an identifier, so it keeps the real model id intact for the chip.\n */\nexport function formatNativeModelName(\n  model: string | null | undefined,\n): string | null {\n  if (!model) return null;\n  if (isFreeOpenHandsModel(model)) return FREE_OPENHANDS_MODELS[model];\n  const lastSegment = model.split(\"/\").pop();\n  return lastSegment || model;\n}\n"],"mappings":";AAAA,IAAa,IAAyB,QAEzB,IAAwB;CACnC,qBAAqB;CACrB,qBAAqB;CACrB,+BAA+B;CAC/B,0BAA0B;AAC5B,GAGa,IAA4B,0BADD,OAAO,KAAK,CACe,EAAyB,KAC1F,IACF,EAAE,oFAEW,KACX,MAEA,GAAQ,KAAS,KAAS;AAE5B,SAAgB,EACd,GACe;CAEf,OADK,IACE,EAAqB,CAAK,IAAI,EAAsB,KAAS,IADjD;AAErB;AA2BA,SAAgB,EACd,GACe;CAIf,OAHK,IACD,EAAqB,CAAK,IAAU,EAAsB,KAC1C,EAAM,MAAM,GAAG,EAAE,IAC9B,KAAe,IAHH;AAIrB"}

package/dist/utils/format-token-count.cjs

@@ -0,0 +1,2 @@
+require("../_virtual/_rolldown/runtime.cjs");function e(e){if(e>=1e6){let t=e/1e6;return t>=10&&Number.isInteger(t)?`${t.toFixed(0)}M`:`${t.toFixed(1)}M`}if(e>=1e3){let t=e/1e3;return Number.isInteger(t)?`${t.toFixed(0)}k`:`${t.toFixed(1)}k`}return e.toLocaleString()}function t(e,t){return t<=0?0:Math.min(100,e/t*100)}exports.formatCompactTokenCount=e,exports.getContextWindowUsagePercentage=t;
+//# sourceMappingURL=format-token-count.cjs.map

package/dist/utils/format-token-count.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-token-count.cjs","names":[],"sources":["../../src/utils/format-token-count.ts"],"sourcesContent":["/** Compact token counts for context-window UI (e.g. 198.5k, 1.0M). */\nexport function formatCompactTokenCount(value: number): string {\n  if (value >= 1_000_000) {\n    const millions = value / 1_000_000;\n    if (millions >= 10 && Number.isInteger(millions)) {\n      return `${millions.toFixed(0)}M`;\n    }\n    return `${millions.toFixed(1)}M`;\n  }\n\n  if (value >= 1_000) {\n    const thousands = value / 1_000;\n    if (Number.isInteger(thousands)) {\n      return `${thousands.toFixed(0)}k`;\n    }\n    return `${thousands.toFixed(1)}k`;\n  }\n\n  return value.toLocaleString();\n}\n\nexport function getContextWindowUsagePercentage(\n  perTurnToken: number,\n  contextWindow: number,\n): number {\n  if (contextWindow <= 0) {\n    return 0;\n  }\n\n  return Math.min(100, (perTurnToken / contextWindow) * 100);\n}\n"],"mappings":"6CACA,SAAgB,EAAwB,EAAuB,CAC7D,GAAI,GAAS,IAAW,CACtB,IAAM,EAAW,EAAQ,IAIzB,OAHI,GAAY,IAAM,OAAO,UAAU,CAAQ,EACtC,GAAG,EAAS,QAAQ,CAAC,EAAE,GAEzB,GAAG,EAAS,QAAQ,CAAC,EAAE,EAChC,CAEA,GAAI,GAAS,IAAO,CAClB,IAAM,EAAY,EAAQ,IAI1B,OAHI,OAAO,UAAU,CAAS,EACrB,GAAG,EAAU,QAAQ,CAAC,EAAE,GAE1B,GAAG,EAAU,QAAQ,CAAC,EAAE,EACjC,CAEA,OAAO,EAAM,eAAe,CAC9B,CAEA,SAAgB,EACd,EACA,EACQ,CAKR,OAJI,GAAiB,EACZ,EAGF,KAAK,IAAI,IAAM,EAAe,EAAiB,GAAG,CAC3D"}

package/dist/utils/format-token-count.d.ts

@@ -0,0 +1,3 @@
+/** Compact token counts for context-window UI (e.g. 198.5k, 1.0M). */
+export declare function formatCompactTokenCount(value: number): string;
+export declare function getContextWindowUsagePercentage(perTurnToken: number, contextWindow: number): number;

package/dist/utils/format-token-count.js

@@ -0,0 +1,19 @@
+//#region src/utils/format-token-count.ts
+function e(e) {
+	if (e >= 1e6) {
+		let t = e / 1e6;
+		return t >= 10 && Number.isInteger(t) ? `${t.toFixed(0)}M` : `${t.toFixed(1)}M`;
+	}
+	if (e >= 1e3) {
+		let t = e / 1e3;
+		return Number.isInteger(t) ? `${t.toFixed(0)}k` : `${t.toFixed(1)}k`;
+	}
+	return e.toLocaleString();
+}
+function t(e, t) {
+	return t <= 0 ? 0 : Math.min(100, e / t * 100);
+}
+//#endregion
+export { e as formatCompactTokenCount, t as getContextWindowUsagePercentage };
+
+//# sourceMappingURL=format-token-count.js.map

package/dist/utils/format-token-count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-token-count.js","names":[],"sources":["../../src/utils/format-token-count.ts"],"sourcesContent":["/** Compact token counts for context-window UI (e.g. 198.5k, 1.0M). */\nexport function formatCompactTokenCount(value: number): string {\n  if (value >= 1_000_000) {\n    const millions = value / 1_000_000;\n    if (millions >= 10 && Number.isInteger(millions)) {\n      return `${millions.toFixed(0)}M`;\n    }\n    return `${millions.toFixed(1)}M`;\n  }\n\n  if (value >= 1_000) {\n    const thousands = value / 1_000;\n    if (Number.isInteger(thousands)) {\n      return `${thousands.toFixed(0)}k`;\n    }\n    return `${thousands.toFixed(1)}k`;\n  }\n\n  return value.toLocaleString();\n}\n\nexport function getContextWindowUsagePercentage(\n  perTurnToken: number,\n  contextWindow: number,\n): number {\n  if (contextWindow <= 0) {\n    return 0;\n  }\n\n  return Math.min(100, (perTurnToken / contextWindow) * 100);\n}\n"],"mappings":";AACA,SAAgB,EAAwB,GAAuB;CAC7D,IAAI,KAAS,KAAW;EACtB,IAAM,IAAW,IAAQ;EAIzB,OAHI,KAAY,MAAM,OAAO,UAAU,CAAQ,IACtC,GAAG,EAAS,QAAQ,CAAC,EAAE,KAEzB,GAAG,EAAS,QAAQ,CAAC,EAAE;CAChC;CAEA,IAAI,KAAS,KAAO;EAClB,IAAM,IAAY,IAAQ;EAI1B,OAHI,OAAO,UAAU,CAAS,IACrB,GAAG,EAAU,QAAQ,CAAC,EAAE,KAE1B,GAAG,EAAU,QAAQ,CAAC,EAAE;CACjC;CAEA,OAAO,EAAM,eAAe;AAC9B;AAEA,SAAgB,EACd,GACA,GACQ;CAKR,OAJI,KAAiB,IACZ,IAGF,KAAK,IAAI,KAAM,IAAe,IAAiB,GAAG;AAC3D"}