@openhands/agent-canvas 1.12.0 → 1.13.0

package/build/locales/zh-CN/openhands.json

@@ -633,7 +633,7 @@
   "BUTTON$PAUSE": "暂停",
   "BUTTON$EDIT_TITLE": "编辑标题",
   "BUTTON$DOWNLOAD_VIA_VSCODE": "通过VS Code下载",
-  "BUTTON$DISPLAY_COST": "显示成本",
+  "BUTTON$DISPLAY_COST": "显示用量和成本",
   "BUTTON$SHOW_AGENT_TOOLS_AND_METADATA": "显示代理工具和元数据",
   "LANDING$ATTACH_IMAGES": "附加图片",
   "LANDING$OPEN_REPO": "打开仓库",
@@ -1056,6 +1056,7 @@
   "CONVERSATION_PANEL$SHOW": "显示",
   "CONVERSATION_PANEL$ALL_THREADS": "所有会话",
   "CONVERSATION_PANEL$RELEVANT_THREADS": "相关（进行中）",
+  "CONVERSATION_PANEL$SHOW_ARCHIVED": "显示已归档",
   "CONVERSATION_PANEL$METADATA": "元数据",
   "CONVERSATION_PANEL$LLM_MODEL": "代理 / 模型",
   "CONVERSATION_PANEL$REPO_BRANCH": "仓库与分支",
@@ -1983,6 +1984,8 @@
   "RECOMMENDED_AUTOMATIONS$POPULARITY_SORTED": "按热度排序",
   "RECOMMENDED_AUTOMATIONS$MINUTES": "{{count}} 分钟",
   "RECOMMENDED_AUTOMATIONS$MISSING_CONNECT": "启动前需连接 {{count}} 个 MCP",
+  "RECOMMENDED_AUTOMATIONS$EXTERNAL_SETUP": "需要外部配置",
+  "RECOMMENDED_AUTOMATIONS$UNKNOWN_SETUP": "集成不可用",
   "RECOMMENDED_AUTOMATIONS$MODAL_AGENT_PROMPT": "代理提示",
   "RECOMMENDED_AUTOMATIONS$MODAL_EXAMPLE_IMPLEMENTATION": "示例实现草图",
   "RECOMMENDED_AUTOMATIONS$MODAL_REQUIRED_MCPS": "必需的 MCP",
@@ -2158,6 +2161,12 @@
   "SETTINGS$APP_UPDATE_RUN_COMMANDS": "运行以下任一命令：",
   "SETTINGS$APP_UPDATE_OR": "或",
   "SETTINGS$APP_UPDATE_RELEASE_NOTES": "查看发行说明",
+  "CONVERSATION$CONFIRM_ARCHIVE": "归档对话",
+  "CONVERSATION$ARCHIVE_WARNING": "该对话及其完整历史记录将保留，可通过“显示已归档”恢复。",
+  "CONVERSATION$ARCHIVE_WARNING_WITH_TITLE": "要归档“<title>{{title}}</title>”吗？该对话及其完整历史记录将保留，可通过“显示已归档”恢复。",
+  "ACTION$CONFIRM_ARCHIVE": "归档",
+  "COMMON$ARCHIVE_CONVERSATION": "归档对话",
+  "COMMON$UNARCHIVE_CONVERSATION": "取消归档对话",
   "BUTTON$CONTINUE": "继续",
   "SETUP$PREREQUISITES_TITLE": "开始之前",
   "SETUP$MANAGE_INTEGRATIONS": "管理集成",
@@ -2188,6 +2197,24 @@
   "FEATURED_AUTOMATIONS$MOVE_UP": "上移",
   "FEATURED_AUTOMATIONS$MOVE_DOWN": "下移",
   "FEATURED_AUTOMATIONS$REORDER_HANDLE": "重新排序 {{name}}",
+  "CONVERSATION$CONTEXT_WINDOW_UNKNOWN": "窗口大小未知",
+  "CONVERSATION$LEFT": "剩余",
+  "CONVERSATION$COMPACT_CONTEXT_DESCRIPTION": "总结较早的消息以释放上下文空间，同时保留近期细节。",
+  "CONVERSATION$COMPACT_CONTEXT_STARTED": "已开始压缩上下文",
+  "CONVERSATION$COMPACT_CONTEXT_COMPLETE": "上下文已压缩 — 释放 {{saved}} tokens（{{before}} → {{after}}）",
+  "CONVERSATION$COMPACT_CONTEXT_COMPLETE_NO_CHANGE": "上下文已压缩",
+  "CONVERSATION$COMPACT_CONTEXT_FAILED": "压缩上下文失败",
+  "CONVERSATION$TOKEN_USAGE": "Token 用量",
+  "CONVERSATION$PLAN_USAGE_NOTE": "套餐用量 — API 等价估算",
+  "COMMON$USAGE": "用量",
+  "CONVERSATION$COMPACT_CONTEXT": "压缩上下文",
+  "CONVERSATION$CONTEXT_FILLING_UP": "上下文即将占满——压缩可释放空间",
+  "CONVERSATION$PROVIDER_BALANCE": "提供商余额",
+  "CONVERSATION$CREDITS_REMAINING": "剩余额度",
+  "CONVERSATION$CREDITS_USED": "已用额度",
+  "CONVERSATION$FREE_TIER": "免费套餐",
+  "CHAT_INTERFACE$CONTEXT_WINDOW_METER_LABEL": "上下文窗口用量",
+  "CHAT_INTERFACE$SHOW_CONTEXT": "显示上下文",
   "CONVERSATION$TAGS_OVERFLOW_ARIA": "显示另外 {{count}} 个标签",
   "CONVERSATION_PANEL$PREVIEW_GIT": "Git",
   "CONVERSATION_PANEL$PREVIEW_REPO": "仓库",

package/build/locales/zh-TW/openhands.json

@@ -633,7 +633,7 @@
   "BUTTON$PAUSE": "暫停",
   "BUTTON$EDIT_TITLE": "編輯標題",
   "BUTTON$DOWNLOAD_VIA_VSCODE": "透過VS Code下載",
-  "BUTTON$DISPLAY_COST": "顯示成本",
+  "BUTTON$DISPLAY_COST": "顯示用量和成本",
   "BUTTON$SHOW_AGENT_TOOLS_AND_METADATA": "顯示代理工具和元數據",
   "LANDING$ATTACH_IMAGES": "附加圖片",
   "LANDING$OPEN_REPO": "開啟儲存庫",
@@ -1056,6 +1056,7 @@
   "CONVERSATION_PANEL$SHOW": "顯示",
   "CONVERSATION_PANEL$ALL_THREADS": "所有對話串",
   "CONVERSATION_PANEL$RELEVANT_THREADS": "相關（進行中）",
+  "CONVERSATION_PANEL$SHOW_ARCHIVED": "顯示已封存",
   "CONVERSATION_PANEL$METADATA": "中繼資料",
   "CONVERSATION_PANEL$LLM_MODEL": "代理 / 模型",
   "CONVERSATION_PANEL$REPO_BRANCH": "存放庫與分支",
@@ -1983,6 +1984,8 @@
   "RECOMMENDED_AUTOMATIONS$POPULARITY_SORTED": "依熱門程度排序",
   "RECOMMENDED_AUTOMATIONS$MINUTES": "{{count}} 分鐘",
   "RECOMMENDED_AUTOMATIONS$MISSING_CONNECT": "啟動前需連接 {{count}} 個 MCP",
+  "RECOMMENDED_AUTOMATIONS$EXTERNAL_SETUP": "需要外部設定",
+  "RECOMMENDED_AUTOMATIONS$UNKNOWN_SETUP": "整合不可用",
   "RECOMMENDED_AUTOMATIONS$MODAL_AGENT_PROMPT": "代理提示",
   "RECOMMENDED_AUTOMATIONS$MODAL_EXAMPLE_IMPLEMENTATION": "範例實作草圖",
   "RECOMMENDED_AUTOMATIONS$MODAL_REQUIRED_MCPS": "必要的 MCP",
@@ -2158,6 +2161,12 @@
   "SETTINGS$APP_UPDATE_RUN_COMMANDS": "執行以下任一命令：",
   "SETTINGS$APP_UPDATE_OR": "或",
   "SETTINGS$APP_UPDATE_RELEASE_NOTES": "檢視版本資訊",
+  "CONVERSATION$CONFIRM_ARCHIVE": "封存對話",
+  "CONVERSATION$ARCHIVE_WARNING": "該對話及其完整歷史記錄會保留，可透過「顯示已封存」還原。",
+  "CONVERSATION$ARCHIVE_WARNING_WITH_TITLE": "要封存「<title>{{title}}</title>」嗎？該對話及其完整歷史記錄會保留，可透過「顯示已封存」還原。",
+  "ACTION$CONFIRM_ARCHIVE": "封存",
+  "COMMON$ARCHIVE_CONVERSATION": "封存對話",
+  "COMMON$UNARCHIVE_CONVERSATION": "取消封存對話",
   "BUTTON$CONTINUE": "繼續",
   "SETUP$PREREQUISITES_TITLE": "開始之前",
   "SETUP$MANAGE_INTEGRATIONS": "管理整合",
@@ -2188,6 +2197,24 @@
   "FEATURED_AUTOMATIONS$MOVE_UP": "上移",
   "FEATURED_AUTOMATIONS$MOVE_DOWN": "下移",
   "FEATURED_AUTOMATIONS$REORDER_HANDLE": "重新排序 {{name}}",
+  "CONVERSATION$CONTEXT_WINDOW_UNKNOWN": "視窗大小未知",
+  "CONVERSATION$LEFT": "剩餘",
+  "CONVERSATION$COMPACT_CONTEXT_DESCRIPTION": "摘要較早的訊息以釋放上下文空間，同時保留近期細節。",
+  "CONVERSATION$COMPACT_CONTEXT_STARTED": "已開始壓縮上下文",
+  "CONVERSATION$COMPACT_CONTEXT_COMPLETE": "上下文已壓縮 — 釋放 {{saved}} tokens（{{before}} → {{after}}）",
+  "CONVERSATION$COMPACT_CONTEXT_COMPLETE_NO_CHANGE": "上下文已壓縮",
+  "CONVERSATION$COMPACT_CONTEXT_FAILED": "壓縮上下文失敗",
+  "CONVERSATION$TOKEN_USAGE": "Token 用量",
+  "CONVERSATION$PLAN_USAGE_NOTE": "方案用量 — API 等價估算",
+  "COMMON$USAGE": "用量",
+  "CONVERSATION$COMPACT_CONTEXT": "壓縮上下文",
+  "CONVERSATION$CONTEXT_FILLING_UP": "上下文即將佔滿——壓縮可釋放空間",
+  "CONVERSATION$PROVIDER_BALANCE": "供應商餘額",
+  "CONVERSATION$CREDITS_REMAINING": "剩餘額度",
+  "CONVERSATION$CREDITS_USED": "已用額度",
+  "CONVERSATION$FREE_TIER": "免費方案",
+  "CHAT_INTERFACE$CONTEXT_WINDOW_METER_LABEL": "上下文視窗用量",
+  "CHAT_INTERFACE$SHOW_CONTEXT": "顯示上下文",
   "CONVERSATION$TAGS_OVERFLOW_ARIA": "顯示另外 {{count}} 個標籤",
   "CONVERSATION_PANEL$PREVIEW_GIT": "Git",
   "CONVERSATION_PANEL$PREVIEW_REPO": "倉庫",

package/config/defaults.json

@@ -1,9 +1,9 @@
 {
   "_comment": "Single source of truth for version pins, ports, paths, and defaults shared across the npm and Docker install paths. Read by scripts/dev-safe.mjs, scripts/dev-with-automation.mjs, docker/entrypoint.sh (via generated defaults.env), and .github/workflows/docker.yml.",
   "versions": {
-    "agentServer": "1.40.1",
-    "agentCanvas": "1.12.0",
-    "automation": "1.6.0"
+    "agentServer": "1.42.1",
+    "agentCanvas": "1.13.0",
+    "automation": "1.7.1"
   },
   "compatibility": {
     "minimumAgentServer": "1.28.0"

package/dist/api/agent-server-compatibility.cjs

@@ -1,2 +1,2 @@
-require("../_virtual/_rolldown/runtime.cjs");const e=require("../node_modules/@openhands/typescript-client/dist/client/server-client.cjs"),t=require("../node_modules/@openhands/typescript-client/dist/client/settings-client.cjs");require("../node_modules/@openhands/typescript-client/dist/clients.cjs");const n=require("./agent-server-config.cjs"),r=require("./backend-registry/active-store.cjs"),i=require("./agent-server-client-options.cjs"),a=require("../config/defaults.cjs");var o=5e3,s=`unknown`,c=a.default.compatibility.minimumAgentServer,l=`AGENT_SERVER_UNSUPPORTED_VERSION`,u=`AGENT_SERVER_UNKNOWN_VERSION`,d=null,f=null,p=e=>Array.isArray(e?.usable_tools)?e.usable_tools:null,m=class extends Error{details;noBackendConfigured;constructor(e,t){let n=t?.noBackendConfigured??!1;super(n?`No agent server backend is configured yet. Add a backend to get started.`:`Could not connect to the configured agent server. Make sure it is running and reachable, then reload the page.`),this.name=`AgentServerUnavailableError`,this.details=e??null,this.noBackendConfigured=n}},h=e=>e instanceof m||typeof e==`object`&&!!e&&`name`in e&&e.name===`AgentServerUnavailableError`,g=class extends m{code=l;actualVersion;requiredVersion=c;constructor(e){let t=`Agent Canvas requires agent-server ${c} or newer; this backend is running ${e}. Please upgrade the agent-server backend.`;super(t),this.name=`AgentServerUnsupportedVersionError`,this.message=t,this.actualVersion=e}},_=class extends m{code=u;actualVersion;requiredVersion=c;constructor(e){let t=`Could not determine this backend's agent-server version.${e?` It reported "${e}".`:``} Agent Canvas requires agent-server ${c} or newer, but this backend did not return a valid version from /server_info. Restart or rebuild the agent-server backend, then try again.`;super(t),this.name=`AgentServerUnknownVersionError`,this.message=t,this.actualVersion=e}},v=e=>n.isAuthRequired()&&C(e,401);function y(){d=null,f=null}function b(e){return e?.host&&e.host!==f?null:d}function x(e){let t=p(d);return Array.isArray(t)?t.includes(e):!0}function S(e){return e instanceof Error&&e.name===`HttpError`&&`status`in e&&typeof e.status==`number`}function C(e,t){return S(e)&&e.status===t}function w(e){return typeof e==`string`&&e.trim()||null}function T(e){return w(e.sdk_version)}function E(e){return w(e.version)??T(e)}function D(e){let t=E(e);return!t||t.toLowerCase()===s?null:t}function O(e){let t=D(e);return!t||!j(t)?null:t}function k(e){return!d||e&&r.getEffectiveLocalBackend()?.host!==e?null:O(d)}function A(e,t){let n=j(e),r=j(t);if(!n||!r)return null;for(let e of[`major`,`minor`,`patch`]){if(n[e]>r[e])return 1;if(n[e]<r[e])return-1}return n.prerelease&&!r.prerelease?-1:!n.prerelease&&r.prerelease?1:n.prerelease&&r.prerelease?n.prerelease.localeCompare(r.prerelease):0}function j(e){let[t]=e.trim().replace(/^v/,``).split(`+`),[n,r]=t.split(`-`,2),i=n.split(`.`);if(i.length!==3)return null;let[a,o,s]=i.map(e=>Number(e));return[a,o,s].every(e=>Number.isInteger(e)&&e>=0)?{major:a,minor:o,patch:s,prerelease:r}:null}function M(e){let t=D(e);if(!t)throw y(),new _(E(e));let n=A(t,c);if(n===null)throw y(),new _(t);if(n<0)throw y(),new g(t)}async function N(){let a=r.getEffectiveLocalBackend();if(!a){if(y(),r.isNoBackend(r.getActiveBackend().backend))throw new m(`No backend configured`,{noBackendConfigured:!0});return null}let s=i.getAgentServerClientOptions({host:a.host,sessionApiKey:a.apiKey||null,timeout:o}),c;try{c=await new e.ServerClient(s).getServerInfo()}catch(e){throw y(),C(e,401)?e:new m(e instanceof Error?e.message:null)}if(M(c),n.isAuthRequired())try{await new t.SettingsClient(s).getSettings()}catch(e){if(C(e,401))throw e;console.warn(`[agent-server] getSettings() probe failed (non-401):`,e)}return d=c,f=s.host,c}exports.assertAgentServerVersionIsSupported=M,exports.clearCachedAgentServerInfo=y,exports.compareAgentServerVersions=A,exports.getCachedAgentServerInfo=b,exports.getCachedAgentServerVersion=k,exports.getDisplayAgentServerVersion=O,exports.isAgentServerAuthError=v,exports.isAgentServerToolAvailable=x,exports.isAgentServerUnavailableError=h,exports.isSdkHttpStatusError=C,exports.loadAgentServerInfo=N;
+require("../_virtual/_rolldown/runtime.cjs");const e=require("../node_modules/@openhands/typescript-client/dist/client/server-client.cjs"),t=require("../node_modules/@openhands/typescript-client/dist/client/settings-client.cjs");require("../node_modules/@openhands/typescript-client/dist/clients.cjs");const n=require("./agent-server-config.cjs"),r=require("./backend-registry/active-store.cjs"),i=require("./agent-server-client-options.cjs"),a=require("../config/defaults.cjs");var o=5e3,s=`unknown`,c=a.default.compatibility.minimumAgentServer,l=`AGENT_SERVER_UNSUPPORTED_VERSION`,u=`AGENT_SERVER_UNKNOWN_VERSION`,d=null,f=null,p=e=>Array.isArray(e?.usable_tools)?e.usable_tools:null,m=class extends Error{details;noBackendConfigured;constructor(e,t){let n=t?.noBackendConfigured??!1;super(n?`No agent server backend is configured yet. Add a backend to get started.`:`Could not connect to the configured agent server. Make sure it is running and reachable, then reload the page.`),this.name=`AgentServerUnavailableError`,this.details=e??null,this.noBackendConfigured=n}},h=e=>e instanceof m||typeof e==`object`&&!!e&&`name`in e&&(e.name===`AgentServerUnavailableError`||e.name===`AgentServerUnsupportedVersionError`||e.name===`AgentServerUnknownVersionError`),g=class extends m{code=l;actualVersion;requiredVersion=c;constructor(e){let t=`Agent Canvas requires agent-server ${c} or newer; this backend is running ${e}. Please upgrade the agent-server backend.`;super(t),this.name=`AgentServerUnsupportedVersionError`,this.message=t,this.actualVersion=e}},_=class extends m{code=u;actualVersion;requiredVersion=c;constructor(e){let t=`Could not determine this backend's agent-server version.${e?` It reported "${e}".`:``} Agent Canvas requires agent-server ${c} or newer, but this backend did not return a valid version from /server_info. Restart or rebuild the agent-server backend, then try again.`;super(t),this.name=`AgentServerUnknownVersionError`,this.message=t,this.actualVersion=e}},v=e=>n.isAuthRequired()&&C(e,401);function y(){d=null,f=null}function b(e){return e?.host&&e.host!==f?null:d}function x(e){let t=p(d);return Array.isArray(t)?t.includes(e):!0}function S(e){return e instanceof Error&&e.name===`HttpError`&&`status`in e&&typeof e.status==`number`}function C(e,t){return S(e)&&e.status===t}function w(e){return typeof e==`string`&&e.trim()||null}function T(e){return w(e.sdk_version)}function E(e){return w(e.version)??T(e)}function D(e){let t=E(e);return!t||t.toLowerCase()===s?null:t}function O(e){let t=D(e);return!t||!j(t)?null:t}function k(e){return!d||e&&r.getEffectiveLocalBackend()?.host!==e?null:O(d)}function A(e,t){let n=j(e),r=j(t);if(!n||!r)return null;for(let e of[`major`,`minor`,`patch`]){if(n[e]>r[e])return 1;if(n[e]<r[e])return-1}return n.prerelease&&!r.prerelease?-1:!n.prerelease&&r.prerelease?1:n.prerelease&&r.prerelease?n.prerelease.localeCompare(r.prerelease):0}function j(e){let[t]=e.trim().replace(/^v/,``).split(`+`),[n,r]=t.split(`-`,2),i=n.split(`.`);if(i.length!==3)return null;let[a,o,s]=i.map(e=>Number(e));return[a,o,s].every(e=>Number.isInteger(e)&&e>=0)?{major:a,minor:o,patch:s,prerelease:r}:null}function M(e){let t=D(e);if(!t)throw y(),new _(E(e));let n=A(t,c);if(n===null)throw y(),new _(t);if(n<0)throw y(),new g(t)}async function N(){let a=r.getEffectiveLocalBackend();if(!a){if(y(),r.isNoBackend(r.getActiveBackend().backend))throw new m(`No backend configured`,{noBackendConfigured:!0});return null}let s=i.getAgentServerClientOptions({host:a.host,sessionApiKey:a.apiKey||null,timeout:o}),c;try{c=await new e.ServerClient(s).getServerInfo()}catch(e){throw y(),C(e,401)?e:new m(e instanceof Error?e.message:null)}if(M(c),n.isAuthRequired())try{await new t.SettingsClient(s).getSettings()}catch(e){if(C(e,401))throw e;console.warn(`[agent-server] getSettings() probe failed (non-401):`,e)}return d=c,f=s.host,c}exports.assertAgentServerVersionIsSupported=M,exports.clearCachedAgentServerInfo=y,exports.compareAgentServerVersions=A,exports.getCachedAgentServerInfo=b,exports.getCachedAgentServerVersion=k,exports.getDisplayAgentServerVersion=O,exports.isAgentServerAuthError=v,exports.isAgentServerToolAvailable=x,exports.isAgentServerUnavailableError=h,exports.isSdkHttpStatusError=C,exports.loadAgentServerInfo=N;
 //# sourceMappingURL=agent-server-compatibility.cjs.map

package/dist/api/agent-server-compatibility.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"agent-server-compatibility.cjs","names":[],"sources":["../../src/api/agent-server-compatibility.ts"],"sourcesContent":["import {\n  ServerClient,\n  SettingsClient,\n} from \"@openhands/typescript-client/clients\";\nimport type { ServerInfo as BaseServerInfo } from \"@openhands/typescript-client\";\nimport { getAgentServerClientOptions } from \"#/api/agent-server-client-options\";\nimport { isAuthRequired } from \"#/api/agent-server-config\";\nimport {\n  getActiveBackend,\n  getEffectiveLocalBackend,\n  isNoBackend,\n} from \"#/api/backend-registry/active-store\";\nimport defaults from \"../../config/defaults.json\";\n\nconst AGENT_SERVER_INFO_TIMEOUT_MS = 5000;\nconst UNKNOWN_AGENT_SERVER_VERSION = \"unknown\";\n\nexport const MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION =\n  defaults.compatibility.minimumAgentServer;\nexport const AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE =\n  \"AGENT_SERVER_UNSUPPORTED_VERSION\";\nexport const AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE =\n  \"AGENT_SERVER_UNKNOWN_VERSION\";\n\nexport interface AgentServerInfo extends BaseServerInfo {\n  sdk_version?: string;\n  usable_tools?: string[] | null;\n  runtime_services?: unknown;\n}\n\nlet cachedAgentServerInfo: AgentServerInfo | null = null;\nlet cachedAgentServerInfoHost: string | null = null;\n\nconst getAdvertisedTools = (serverInfo: AgentServerInfo | null) => {\n  if (Array.isArray(serverInfo?.usable_tools)) {\n    return serverInfo.usable_tools;\n  }\n  return null;\n};\n\nexport class AgentServerUnavailableError extends Error {\n  readonly details: string | null;\n  readonly noBackendConfigured: boolean;\n\n  constructor(\n    details?: string | null,\n    options?: { noBackendConfigured?: boolean },\n  ) {\n    const noBackendConfigured = options?.noBackendConfigured ?? false;\n    super(\n      noBackendConfigured\n        ? \"No agent server backend is configured yet. Add a backend to get started.\"\n        : \"Could not connect to the configured agent server. Make sure it is running and reachable, then reload the page.\",\n    );\n    this.name = \"AgentServerUnavailableError\";\n    this.details = details ?? null;\n    this.noBackendConfigured = noBackendConfigured;\n  }\n}\n\nexport const isAgentServerUnavailableError = (\n  error: unknown,\n): error is AgentServerUnavailableError =>\n  error instanceof AgentServerUnavailableError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"name\" in error &&\n    error.name === \"AgentServerUnavailableError\");\n\nexport class AgentServerUnsupportedVersionError extends AgentServerUnavailableError {\n  readonly code = AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE;\n  readonly actualVersion: string;\n  readonly requiredVersion = MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION;\n\n  constructor(actualVersion: string) {\n    const message = `Agent Canvas requires agent-server ${MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION} or newer; this backend is running ${actualVersion}. Please upgrade the agent-server backend.`;\n    super(message);\n    this.name = \"AgentServerUnsupportedVersionError\";\n    this.message = message;\n    this.actualVersion = actualVersion;\n  }\n}\n\nexport class AgentServerUnknownVersionError extends AgentServerUnavailableError {\n  readonly code = AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE;\n  readonly actualVersion: string | null;\n  readonly requiredVersion = MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION;\n\n  constructor(actualVersion: string | null) {\n    const reported = actualVersion ? ` It reported \"${actualVersion}\".` : \"\";\n    const message =\n      `Could not determine this backend's agent-server version.${reported} ` +\n      `Agent Canvas requires agent-server ${MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION} ` +\n      \"or newer, but this backend did not return a valid version from \" +\n      \"/server_info. Restart or rebuild the agent-server backend, then try again.\";\n    super(message);\n    this.name = \"AgentServerUnknownVersionError\";\n    this.message = message;\n    this.actualVersion = actualVersion;\n  }\n}\n\nexport const isAgentServerUnsupportedVersionError = (\n  error: unknown,\n): error is AgentServerUnsupportedVersionError =>\n  error instanceof AgentServerUnsupportedVersionError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    error.code === AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE);\n\nexport const isAgentServerUnknownVersionError = (\n  error: unknown,\n): error is AgentServerUnknownVersionError =>\n  error instanceof AgentServerUnknownVersionError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    error.code === AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE);\n\n/**\n * Returns true when the agent-server probe failed with HTTP 401.\n * In public mode this means the stored key is stale (server restarted\n * with a different `LOCAL_BACKEND_API_KEY`). Only meaningful when\n * auth is required — a 401 in local mode is a misconfiguration, not a\n * key-rotation event. Uses {@link isAuthRequired} so both the build-time\n * `VITE_AUTH_REQUIRED` flag and the runtime `window.__AGENT_CANVAS_AUTH_REQUIRED__`\n * injection (used by pre-built static binaries) are honoured.\n */\nexport const isAgentServerAuthError = (error: unknown): boolean =>\n  isAuthRequired() && isSdkHttpStatusError(error, 401);\n\nexport function clearCachedAgentServerInfo() {\n  cachedAgentServerInfo = null;\n  cachedAgentServerInfoHost = null;\n}\n\nexport function getCachedAgentServerInfo(options?: {\n  host?: string | null;\n}): AgentServerInfo | null {\n  if (options?.host && options.host !== cachedAgentServerInfoHost) {\n    return null;\n  }\n  return cachedAgentServerInfo;\n}\n\nexport function isAgentServerToolAvailable(toolName: string) {\n  const availableTools = getAdvertisedTools(cachedAgentServerInfo);\n  if (!Array.isArray(availableTools)) {\n    return true;\n  }\n  return availableTools.includes(toolName);\n}\n\nexport function isSdkHttpError(error: unknown) {\n  return (\n    error instanceof Error &&\n    error.name === \"HttpError\" &&\n    \"status\" in error &&\n    typeof error.status === \"number\"\n  );\n}\n\n/**\n * Narrows an SDK HTTP error to a specific status code.\n * Use instead of manually casting `(err as { status: number }).status`.\n */\nexport function isSdkHttpStatusError(error: unknown, status: number): boolean {\n  return (\n    isSdkHttpError(error) && (error as { status: number }).status === status\n  );\n}\n\nfunction normalizeAgentServerInfoVersion(version: unknown): string | null {\n  if (typeof version !== \"string\") return null;\n  const trimmed = version.trim();\n  return trimmed || null;\n}\n\nfunction getRawAgentServerSdkVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  return normalizeAgentServerInfoVersion(serverInfo.sdk_version);\n}\n\nfunction getRawAgentServerVersion(serverInfo: AgentServerInfo): string | null {\n  return (\n    normalizeAgentServerInfoVersion(serverInfo.version) ??\n    getRawAgentServerSdkVersion(serverInfo)\n  );\n}\n\nfunction getComparableAgentServerVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version = getRawAgentServerVersion(serverInfo);\n  if (!version || version.toLowerCase() === UNKNOWN_AGENT_SERVER_VERSION) {\n    return null;\n  }\n  return version;\n}\n\nexport function getDisplayAgentServerVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version = getComparableAgentServerVersion(serverInfo);\n  if (!version || !parseAgentServerVersion(version)) {\n    return null;\n  }\n  return version;\n}\n\nexport function getDisplayAgentServerSdkVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version =\n    getRawAgentServerSdkVersion(serverInfo) ??\n    getComparableAgentServerVersion(serverInfo);\n  if (!version || version.toLowerCase() === UNKNOWN_AGENT_SERVER_VERSION) {\n    return null;\n  }\n  return version;\n}\n\nexport function getCachedAgentServerSdkVersion(\n  host?: string | null,\n): string | null {\n  if (!cachedAgentServerInfo) return null;\n  if (host && getEffectiveLocalBackend()?.host !== host) return null;\n  return getDisplayAgentServerSdkVersion(cachedAgentServerInfo);\n}\n\nexport function getCachedAgentServerVersion(\n  host?: string | null,\n): string | null {\n  if (!cachedAgentServerInfo) return null;\n  if (host && getEffectiveLocalBackend()?.host !== host) return null;\n  return getDisplayAgentServerVersion(cachedAgentServerInfo);\n}\n\nexport function compareAgentServerVersions(actual: string, required: string) {\n  const parsedActual = parseAgentServerVersion(actual);\n  const parsedRequired = parseAgentServerVersion(required);\n\n  if (!parsedActual || !parsedRequired) {\n    return null;\n  }\n\n  for (const key of [\"major\", \"minor\", \"patch\"] as const) {\n    if (parsedActual[key] > parsedRequired[key]) {\n      return 1;\n    }\n    if (parsedActual[key] < parsedRequired[key]) {\n      return -1;\n    }\n  }\n\n  if (parsedActual.prerelease && !parsedRequired.prerelease) {\n    return -1;\n  }\n  if (!parsedActual.prerelease && parsedRequired.prerelease) {\n    return 1;\n  }\n  if (parsedActual.prerelease && parsedRequired.prerelease) {\n    return parsedActual.prerelease.localeCompare(parsedRequired.prerelease);\n  }\n\n  return 0;\n}\n\nfunction parseAgentServerVersion(version: string) {\n  const trimmed = version.trim().replace(/^v/, \"\");\n  const [withoutBuild] = trimmed.split(\"+\");\n  const [core, prerelease] = withoutBuild.split(\"-\", 2);\n  const parts = core.split(\".\");\n\n  if (parts.length !== 3) {\n    return null;\n  }\n\n  const [major, minor, patch] = parts.map((part) => Number(part));\n  if (\n    ![major, minor, patch].every((part) => Number.isInteger(part) && part >= 0)\n  ) {\n    return null;\n  }\n\n  return { major, minor, patch, prerelease };\n}\n\nexport function assertAgentServerVersionIsSupported(\n  serverInfo: AgentServerInfo,\n) {\n  const actualVersion = getComparableAgentServerVersion(serverInfo);\n  if (!actualVersion) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnknownVersionError(\n      getRawAgentServerVersion(serverInfo),\n    );\n  }\n\n  const comparison = compareAgentServerVersions(\n    actualVersion,\n    MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION,\n  );\n\n  if (comparison === null) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnknownVersionError(actualVersion);\n  }\n\n  if (comparison < 0) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnsupportedVersionError(actualVersion);\n  }\n}\n\nexport async function loadAgentServerInfo() {\n  // The probe is a *local* agent-server concern — it verifies the runtime\n  // hosting the GUI is reachable. It must NEVER run against the active\n  // backend when that backend is cloud, because cloud hosts don't\n  // expose /api/server_info and would fail with a CORS error besides.\n  const local = getEffectiveLocalBackend();\n  if (!local) {\n    clearCachedAgentServerInfo();\n\n    // Empty registry (NO_BACKEND sentinel) — the user has no backend\n    // configured at all.  Throw so root.tsx shows the manage-backends\n    // modal instead of silently rendering a broken home page.\n    if (isNoBackend(getActiveBackend().backend)) {\n      throw new AgentServerUnavailableError(\"No backend configured\", {\n        noBackendConfigured: true,\n      });\n    }\n\n    // Active backend is cloud — no local probe needed.\n    return null;\n  }\n\n  const clientOptions = getAgentServerClientOptions({\n    host: local.host,\n    sessionApiKey: local.apiKey || null,\n    timeout: AGENT_SERVER_INFO_TIMEOUT_MS,\n  });\n  let serverInfo: AgentServerInfo;\n\n  try {\n    serverInfo = (await new ServerClient(\n      clientOptions,\n    ).getServerInfo()) as AgentServerInfo;\n  } catch (error) {\n    clearCachedAgentServerInfo();\n    // Preserve 401 so root.tsx can show the auth screen (public mode).\n    // All other HTTP errors (502, 503, etc.) mean the server is unreachable\n    // or misconfigured — treat them as unavailable.\n    if (isSdkHttpStatusError(error, 401)) {\n      throw error;\n    }\n\n    const details = error instanceof Error ? error.message : null;\n    throw new AgentServerUnavailableError(details);\n  }\n\n  assertAgentServerVersionIsSupported(serverInfo);\n\n  // /server_info is unprotected, so a stale session key still gets 200.\n  // In public mode, validate the key against a protected endpoint so a\n  // server restart with a new LOCAL_BACKEND_API_KEY surfaces immediately\n  // instead of letting the app load and fail on every subsequent call.\n  if (isAuthRequired()) {\n    try {\n      await new SettingsClient(clientOptions).getSettings();\n    } catch (error) {\n      // Only rethrow 401 — that means the stored key is invalid /\n      // rotated.  Other HTTP errors (403, 5xx) and non-HTTP errors\n      // (network, timeout) are swallowed: the server *is* up (we just\n      // reached /server_info), so let the app proceed with an\n      // unvalidated key rather than blocking the UI.\n      // NOTE: If the connection drops between the /server_info and\n      // getSettings() probes, the app loads with an unvalidated key and\n      // subsequent 401s won't trigger the auth screen (they come from\n      // React Query hooks, not this bootstrap path). Acceptable for now\n      // since the window is narrow and a page refresh recovers.\n      if (isSdkHttpStatusError(error, 401)) {\n        throw error;\n      }\n\n      console.warn(\n        \"[agent-server] getSettings() probe failed (non-401):\",\n        error,\n      );\n    }\n  }\n\n  cachedAgentServerInfo = serverInfo;\n  cachedAgentServerInfoHost = clientOptions.host;\n  return serverInfo;\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-server-compatibility.cjs","names":[],"sources":["../../src/api/agent-server-compatibility.ts"],"sourcesContent":["import {\n  ServerClient,\n  SettingsClient,\n} from \"@openhands/typescript-client/clients\";\nimport type { ServerInfo as BaseServerInfo } from \"@openhands/typescript-client\";\nimport { getAgentServerClientOptions } from \"#/api/agent-server-client-options\";\nimport { isAuthRequired } from \"#/api/agent-server-config\";\nimport {\n  getActiveBackend,\n  getEffectiveLocalBackend,\n  isNoBackend,\n} from \"#/api/backend-registry/active-store\";\nimport defaults from \"../../config/defaults.json\";\n\nconst AGENT_SERVER_INFO_TIMEOUT_MS = 5000;\nconst UNKNOWN_AGENT_SERVER_VERSION = \"unknown\";\n\nexport const MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION =\n  defaults.compatibility.minimumAgentServer;\nexport const AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE =\n  \"AGENT_SERVER_UNSUPPORTED_VERSION\";\nexport const AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE =\n  \"AGENT_SERVER_UNKNOWN_VERSION\";\n\nexport interface AgentServerInfo extends BaseServerInfo {\n  sdk_version?: string;\n  usable_tools?: string[] | null;\n  runtime_services?: unknown;\n}\n\nlet cachedAgentServerInfo: AgentServerInfo | null = null;\nlet cachedAgentServerInfoHost: string | null = null;\n\nconst getAdvertisedTools = (serverInfo: AgentServerInfo | null) => {\n  if (Array.isArray(serverInfo?.usable_tools)) {\n    return serverInfo.usable_tools;\n  }\n  return null;\n};\n\nexport class AgentServerUnavailableError extends Error {\n  readonly details: string | null;\n  readonly noBackendConfigured: boolean;\n\n  constructor(\n    details?: string | null,\n    options?: { noBackendConfigured?: boolean },\n  ) {\n    const noBackendConfigured = options?.noBackendConfigured ?? false;\n    super(\n      noBackendConfigured\n        ? \"No agent server backend is configured yet. Add a backend to get started.\"\n        : \"Could not connect to the configured agent server. Make sure it is running and reachable, then reload the page.\",\n    );\n    this.name = \"AgentServerUnavailableError\";\n    this.details = details ?? null;\n    this.noBackendConfigured = noBackendConfigured;\n  }\n}\n\nexport const isAgentServerUnavailableError = (\n  error: unknown,\n): error is AgentServerUnavailableError =>\n  error instanceof AgentServerUnavailableError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"name\" in error &&\n    (error.name === \"AgentServerUnavailableError\" ||\n      error.name === \"AgentServerUnsupportedVersionError\" ||\n      error.name === \"AgentServerUnknownVersionError\"));\n\nexport class AgentServerUnsupportedVersionError extends AgentServerUnavailableError {\n  readonly code = AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE;\n  readonly actualVersion: string;\n  readonly requiredVersion = MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION;\n\n  constructor(actualVersion: string) {\n    const message = `Agent Canvas requires agent-server ${MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION} or newer; this backend is running ${actualVersion}. Please upgrade the agent-server backend.`;\n    super(message);\n    this.name = \"AgentServerUnsupportedVersionError\";\n    this.message = message;\n    this.actualVersion = actualVersion;\n  }\n}\n\nexport class AgentServerUnknownVersionError extends AgentServerUnavailableError {\n  readonly code = AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE;\n  readonly actualVersion: string | null;\n  readonly requiredVersion = MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION;\n\n  constructor(actualVersion: string | null) {\n    const reported = actualVersion ? ` It reported \"${actualVersion}\".` : \"\";\n    const message =\n      `Could not determine this backend's agent-server version.${reported} ` +\n      `Agent Canvas requires agent-server ${MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION} ` +\n      \"or newer, but this backend did not return a valid version from \" +\n      \"/server_info. Restart or rebuild the agent-server backend, then try again.\";\n    super(message);\n    this.name = \"AgentServerUnknownVersionError\";\n    this.message = message;\n    this.actualVersion = actualVersion;\n  }\n}\n\nexport const isAgentServerUnsupportedVersionError = (\n  error: unknown,\n): error is AgentServerUnsupportedVersionError =>\n  error instanceof AgentServerUnsupportedVersionError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    error.code === AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE);\n\nexport const isAgentServerUnknownVersionError = (\n  error: unknown,\n): error is AgentServerUnknownVersionError =>\n  error instanceof AgentServerUnknownVersionError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    error.code === AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE);\n\n/**\n * Returns true when the agent-server probe failed with HTTP 401.\n * In public mode this means the stored key is stale (server restarted\n * with a different `LOCAL_BACKEND_API_KEY`). Only meaningful when\n * auth is required — a 401 in local mode is a misconfiguration, not a\n * key-rotation event. Uses {@link isAuthRequired} so both the build-time\n * `VITE_AUTH_REQUIRED` flag and the runtime `window.__AGENT_CANVAS_AUTH_REQUIRED__`\n * injection (used by pre-built static binaries) are honoured.\n */\nexport const isAgentServerAuthError = (error: unknown): boolean =>\n  isAuthRequired() && isSdkHttpStatusError(error, 401);\n\nexport function clearCachedAgentServerInfo() {\n  cachedAgentServerInfo = null;\n  cachedAgentServerInfoHost = null;\n}\n\nexport function getCachedAgentServerInfo(options?: {\n  host?: string | null;\n}): AgentServerInfo | null {\n  if (options?.host && options.host !== cachedAgentServerInfoHost) {\n    return null;\n  }\n  return cachedAgentServerInfo;\n}\n\nexport function isAgentServerToolAvailable(toolName: string) {\n  const availableTools = getAdvertisedTools(cachedAgentServerInfo);\n  if (!Array.isArray(availableTools)) {\n    return true;\n  }\n  return availableTools.includes(toolName);\n}\n\nexport function isSdkHttpError(error: unknown) {\n  return (\n    error instanceof Error &&\n    error.name === \"HttpError\" &&\n    \"status\" in error &&\n    typeof error.status === \"number\"\n  );\n}\n\n/**\n * Narrows an SDK HTTP error to a specific status code.\n * Use instead of manually casting `(err as { status: number }).status`.\n */\nexport function isSdkHttpStatusError(error: unknown, status: number): boolean {\n  return (\n    isSdkHttpError(error) && (error as { status: number }).status === status\n  );\n}\n\nfunction normalizeAgentServerInfoVersion(version: unknown): string | null {\n  if (typeof version !== \"string\") return null;\n  const trimmed = version.trim();\n  return trimmed || null;\n}\n\nfunction getRawAgentServerSdkVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  return normalizeAgentServerInfoVersion(serverInfo.sdk_version);\n}\n\nfunction getRawAgentServerVersion(serverInfo: AgentServerInfo): string | null {\n  return (\n    normalizeAgentServerInfoVersion(serverInfo.version) ??\n    getRawAgentServerSdkVersion(serverInfo)\n  );\n}\n\nfunction getComparableAgentServerVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version = getRawAgentServerVersion(serverInfo);\n  if (!version || version.toLowerCase() === UNKNOWN_AGENT_SERVER_VERSION) {\n    return null;\n  }\n  return version;\n}\n\nexport function getDisplayAgentServerVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version = getComparableAgentServerVersion(serverInfo);\n  if (!version || !parseAgentServerVersion(version)) {\n    return null;\n  }\n  return version;\n}\n\nexport function getDisplayAgentServerSdkVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version =\n    getRawAgentServerSdkVersion(serverInfo) ??\n    getComparableAgentServerVersion(serverInfo);\n  if (!version || version.toLowerCase() === UNKNOWN_AGENT_SERVER_VERSION) {\n    return null;\n  }\n  return version;\n}\n\nexport function getCachedAgentServerSdkVersion(\n  host?: string | null,\n): string | null {\n  if (!cachedAgentServerInfo) return null;\n  if (host && getEffectiveLocalBackend()?.host !== host) return null;\n  return getDisplayAgentServerSdkVersion(cachedAgentServerInfo);\n}\n\nexport function getCachedAgentServerVersion(\n  host?: string | null,\n): string | null {\n  if (!cachedAgentServerInfo) return null;\n  if (host && getEffectiveLocalBackend()?.host !== host) return null;\n  return getDisplayAgentServerVersion(cachedAgentServerInfo);\n}\n\nexport function compareAgentServerVersions(actual: string, required: string) {\n  const parsedActual = parseAgentServerVersion(actual);\n  const parsedRequired = parseAgentServerVersion(required);\n\n  if (!parsedActual || !parsedRequired) {\n    return null;\n  }\n\n  for (const key of [\"major\", \"minor\", \"patch\"] as const) {\n    if (parsedActual[key] > parsedRequired[key]) {\n      return 1;\n    }\n    if (parsedActual[key] < parsedRequired[key]) {\n      return -1;\n    }\n  }\n\n  if (parsedActual.prerelease && !parsedRequired.prerelease) {\n    return -1;\n  }\n  if (!parsedActual.prerelease && parsedRequired.prerelease) {\n    return 1;\n  }\n  if (parsedActual.prerelease && parsedRequired.prerelease) {\n    return parsedActual.prerelease.localeCompare(parsedRequired.prerelease);\n  }\n\n  return 0;\n}\n\nfunction parseAgentServerVersion(version: string) {\n  const trimmed = version.trim().replace(/^v/, \"\");\n  const [withoutBuild] = trimmed.split(\"+\");\n  const [core, prerelease] = withoutBuild.split(\"-\", 2);\n  const parts = core.split(\".\");\n\n  if (parts.length !== 3) {\n    return null;\n  }\n\n  const [major, minor, patch] = parts.map((part) => Number(part));\n  if (\n    ![major, minor, patch].every((part) => Number.isInteger(part) && part >= 0)\n  ) {\n    return null;\n  }\n\n  return { major, minor, patch, prerelease };\n}\n\nexport function assertAgentServerVersionIsSupported(\n  serverInfo: AgentServerInfo,\n) {\n  const actualVersion = getComparableAgentServerVersion(serverInfo);\n  if (!actualVersion) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnknownVersionError(\n      getRawAgentServerVersion(serverInfo),\n    );\n  }\n\n  const comparison = compareAgentServerVersions(\n    actualVersion,\n    MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION,\n  );\n\n  if (comparison === null) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnknownVersionError(actualVersion);\n  }\n\n  if (comparison < 0) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnsupportedVersionError(actualVersion);\n  }\n}\n\nexport async function loadAgentServerInfo() {\n  // The probe is a *local* agent-server concern — it verifies the runtime\n  // hosting the GUI is reachable. It must NEVER run against the active\n  // backend when that backend is cloud, because cloud hosts don't\n  // expose /api/server_info and would fail with a CORS error besides.\n  const local = getEffectiveLocalBackend();\n  if (!local) {\n    clearCachedAgentServerInfo();\n\n    // Empty registry (NO_BACKEND sentinel) — the user has no backend\n    // configured at all.  Throw so root.tsx shows the manage-backends\n    // modal instead of silently rendering a broken home page.\n    if (isNoBackend(getActiveBackend().backend)) {\n      throw new AgentServerUnavailableError(\"No backend configured\", {\n        noBackendConfigured: true,\n      });\n    }\n\n    // Active backend is cloud — no local probe needed.\n    return null;\n  }\n\n  const clientOptions = getAgentServerClientOptions({\n    host: local.host,\n    sessionApiKey: local.apiKey || null,\n    timeout: AGENT_SERVER_INFO_TIMEOUT_MS,\n  });\n  let serverInfo: AgentServerInfo;\n\n  try {\n    serverInfo = (await new ServerClient(\n      clientOptions,\n    ).getServerInfo()) as AgentServerInfo;\n  } catch (error) {\n    clearCachedAgentServerInfo();\n    // Preserve 401 so root.tsx can show the auth screen (public mode).\n    // All other HTTP errors (502, 503, etc.) mean the server is unreachable\n    // or misconfigured — treat them as unavailable.\n    if (isSdkHttpStatusError(error, 401)) {\n      throw error;\n    }\n\n    const details = error instanceof Error ? error.message : null;\n    throw new AgentServerUnavailableError(details);\n  }\n\n  assertAgentServerVersionIsSupported(serverInfo);\n\n  // /server_info is unprotected, so a stale session key still gets 200.\n  // In public mode, validate the key against a protected endpoint so a\n  // server restart with a new LOCAL_BACKEND_API_KEY surfaces immediately\n  // instead of letting the app load and fail on every subsequent call.\n  if (isAuthRequired()) {\n    try {\n      await new SettingsClient(clientOptions).getSettings();\n    } catch (error) {\n      // Only rethrow 401 — that means the stored key is invalid /\n      // rotated.  Other HTTP errors (403, 5xx) and non-HTTP errors\n      // (network, timeout) are swallowed: the server *is* up (we just\n      // reached /server_info), so let the app proceed with an\n      // unvalidated key rather than blocking the UI.\n      // NOTE: If the connection drops between the /server_info and\n      // getSettings() probes, the app loads with an unvalidated key and\n      // subsequent 401s won't trigger the auth screen (they come from\n      // React Query hooks, not this bootstrap path). Acceptable for now\n      // since the window is narrow and a page refresh recovers.\n      if (isSdkHttpStatusError(error, 401)) {\n        throw error;\n      }\n\n      console.warn(\n        \"[agent-server] getSettings() probe failed (non-401):\",\n        error,\n      );\n    }\n  }\n\n  cachedAgentServerInfo = serverInfo;\n  cachedAgentServerInfoHost = clientOptions.host;\n  return serverInfo;\n}\n"],"mappings":"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"}

package/dist/api/agent-server-compatibility.js

@@ -13,7 +13,7 @@ var c = 5e3, l = "unknown", u = s.compatibility.minimumAgentServer, d = "AGENT_S
 		let n = t?.noBackendConfigured ?? !1;
 		super(n ? "No agent server backend is configured yet. Add a backend to get started." : "Could not connect to the configured agent server. Make sure it is running and reachable, then reload the page."), this.name = "AgentServerUnavailableError", this.details = e ?? null, this.noBackendConfigured = n;
 	}
-}, _ = (e) => e instanceof g || typeof e == "object" && !!e && "name" in e && e.name === "AgentServerUnavailableError", v = class extends g {
+}, _ = (e) => e instanceof g || typeof e == "object" && !!e && "name" in e && (e.name === "AgentServerUnavailableError" || e.name === "AgentServerUnsupportedVersionError" || e.name === "AgentServerUnknownVersionError"), v = class extends g {
 	code = d;
 	actualVersion;
 	requiredVersion = u;

package/dist/api/agent-server-compatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-server-compatibility.js","names":[],"sources":["../../src/api/agent-server-compatibility.ts"],"sourcesContent":["import {\n  ServerClient,\n  SettingsClient,\n} from \"@openhands/typescript-client/clients\";\nimport type { ServerInfo as BaseServerInfo } from \"@openhands/typescript-client\";\nimport { getAgentServerClientOptions } from \"#/api/agent-server-client-options\";\nimport { isAuthRequired } from \"#/api/agent-server-config\";\nimport {\n  getActiveBackend,\n  getEffectiveLocalBackend,\n  isNoBackend,\n} from \"#/api/backend-registry/active-store\";\nimport defaults from \"../../config/defaults.json\";\n\nconst AGENT_SERVER_INFO_TIMEOUT_MS = 5000;\nconst UNKNOWN_AGENT_SERVER_VERSION = \"unknown\";\n\nexport const MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION =\n  defaults.compatibility.minimumAgentServer;\nexport const AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE =\n  \"AGENT_SERVER_UNSUPPORTED_VERSION\";\nexport const AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE =\n  \"AGENT_SERVER_UNKNOWN_VERSION\";\n\nexport interface AgentServerInfo extends BaseServerInfo {\n  sdk_version?: string;\n  usable_tools?: string[] | null;\n  runtime_services?: unknown;\n}\n\nlet cachedAgentServerInfo: AgentServerInfo | null = null;\nlet cachedAgentServerInfoHost: string | null = null;\n\nconst getAdvertisedTools = (serverInfo: AgentServerInfo | null) => {\n  if (Array.isArray(serverInfo?.usable_tools)) {\n    return serverInfo.usable_tools;\n  }\n  return null;\n};\n\nexport class AgentServerUnavailableError extends Error {\n  readonly details: string | null;\n  readonly noBackendConfigured: boolean;\n\n  constructor(\n    details?: string | null,\n    options?: { noBackendConfigured?: boolean },\n  ) {\n    const noBackendConfigured = options?.noBackendConfigured ?? false;\n    super(\n      noBackendConfigured\n        ? \"No agent server backend is configured yet. Add a backend to get started.\"\n        : \"Could not connect to the configured agent server. Make sure it is running and reachable, then reload the page.\",\n    );\n    this.name = \"AgentServerUnavailableError\";\n    this.details = details ?? null;\n    this.noBackendConfigured = noBackendConfigured;\n  }\n}\n\nexport const isAgentServerUnavailableError = (\n  error: unknown,\n): error is AgentServerUnavailableError =>\n  error instanceof AgentServerUnavailableError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"name\" in error &&\n    error.name === \"AgentServerUnavailableError\");\n\nexport class AgentServerUnsupportedVersionError extends AgentServerUnavailableError {\n  readonly code = AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE;\n  readonly actualVersion: string;\n  readonly requiredVersion = MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION;\n\n  constructor(actualVersion: string) {\n    const message = `Agent Canvas requires agent-server ${MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION} or newer; this backend is running ${actualVersion}. Please upgrade the agent-server backend.`;\n    super(message);\n    this.name = \"AgentServerUnsupportedVersionError\";\n    this.message = message;\n    this.actualVersion = actualVersion;\n  }\n}\n\nexport class AgentServerUnknownVersionError extends AgentServerUnavailableError {\n  readonly code = AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE;\n  readonly actualVersion: string | null;\n  readonly requiredVersion = MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION;\n\n  constructor(actualVersion: string | null) {\n    const reported = actualVersion ? ` It reported \"${actualVersion}\".` : \"\";\n    const message =\n      `Could not determine this backend's agent-server version.${reported} ` +\n      `Agent Canvas requires agent-server ${MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION} ` +\n      \"or newer, but this backend did not return a valid version from \" +\n      \"/server_info. Restart or rebuild the agent-server backend, then try again.\";\n    super(message);\n    this.name = \"AgentServerUnknownVersionError\";\n    this.message = message;\n    this.actualVersion = actualVersion;\n  }\n}\n\nexport const isAgentServerUnsupportedVersionError = (\n  error: unknown,\n): error is AgentServerUnsupportedVersionError =>\n  error instanceof AgentServerUnsupportedVersionError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    error.code === AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE);\n\nexport const isAgentServerUnknownVersionError = (\n  error: unknown,\n): error is AgentServerUnknownVersionError =>\n  error instanceof AgentServerUnknownVersionError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    error.code === AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE);\n\n/**\n * Returns true when the agent-server probe failed with HTTP 401.\n * In public mode this means the stored key is stale (server restarted\n * with a different `LOCAL_BACKEND_API_KEY`). Only meaningful when\n * auth is required — a 401 in local mode is a misconfiguration, not a\n * key-rotation event. Uses {@link isAuthRequired} so both the build-time\n * `VITE_AUTH_REQUIRED` flag and the runtime `window.__AGENT_CANVAS_AUTH_REQUIRED__`\n * injection (used by pre-built static binaries) are honoured.\n */\nexport const isAgentServerAuthError = (error: unknown): boolean =>\n  isAuthRequired() && isSdkHttpStatusError(error, 401);\n\nexport function clearCachedAgentServerInfo() {\n  cachedAgentServerInfo = null;\n  cachedAgentServerInfoHost = null;\n}\n\nexport function getCachedAgentServerInfo(options?: {\n  host?: string | null;\n}): AgentServerInfo | null {\n  if (options?.host && options.host !== cachedAgentServerInfoHost) {\n    return null;\n  }\n  return cachedAgentServerInfo;\n}\n\nexport function isAgentServerToolAvailable(toolName: string) {\n  const availableTools = getAdvertisedTools(cachedAgentServerInfo);\n  if (!Array.isArray(availableTools)) {\n    return true;\n  }\n  return availableTools.includes(toolName);\n}\n\nexport function isSdkHttpError(error: unknown) {\n  return (\n    error instanceof Error &&\n    error.name === \"HttpError\" &&\n    \"status\" in error &&\n    typeof error.status === \"number\"\n  );\n}\n\n/**\n * Narrows an SDK HTTP error to a specific status code.\n * Use instead of manually casting `(err as { status: number }).status`.\n */\nexport function isSdkHttpStatusError(error: unknown, status: number): boolean {\n  return (\n    isSdkHttpError(error) && (error as { status: number }).status === status\n  );\n}\n\nfunction normalizeAgentServerInfoVersion(version: unknown): string | null {\n  if (typeof version !== \"string\") return null;\n  const trimmed = version.trim();\n  return trimmed || null;\n}\n\nfunction getRawAgentServerSdkVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  return normalizeAgentServerInfoVersion(serverInfo.sdk_version);\n}\n\nfunction getRawAgentServerVersion(serverInfo: AgentServerInfo): string | null {\n  return (\n    normalizeAgentServerInfoVersion(serverInfo.version) ??\n    getRawAgentServerSdkVersion(serverInfo)\n  );\n}\n\nfunction getComparableAgentServerVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version = getRawAgentServerVersion(serverInfo);\n  if (!version || version.toLowerCase() === UNKNOWN_AGENT_SERVER_VERSION) {\n    return null;\n  }\n  return version;\n}\n\nexport function getDisplayAgentServerVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version = getComparableAgentServerVersion(serverInfo);\n  if (!version || !parseAgentServerVersion(version)) {\n    return null;\n  }\n  return version;\n}\n\nexport function getDisplayAgentServerSdkVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version =\n    getRawAgentServerSdkVersion(serverInfo) ??\n    getComparableAgentServerVersion(serverInfo);\n  if (!version || version.toLowerCase() === UNKNOWN_AGENT_SERVER_VERSION) {\n    return null;\n  }\n  return version;\n}\n\nexport function getCachedAgentServerSdkVersion(\n  host?: string | null,\n): string | null {\n  if (!cachedAgentServerInfo) return null;\n  if (host && getEffectiveLocalBackend()?.host !== host) return null;\n  return getDisplayAgentServerSdkVersion(cachedAgentServerInfo);\n}\n\nexport function getCachedAgentServerVersion(\n  host?: string | null,\n): string | null {\n  if (!cachedAgentServerInfo) return null;\n  if (host && getEffectiveLocalBackend()?.host !== host) return null;\n  return getDisplayAgentServerVersion(cachedAgentServerInfo);\n}\n\nexport function compareAgentServerVersions(actual: string, required: string) {\n  const parsedActual = parseAgentServerVersion(actual);\n  const parsedRequired = parseAgentServerVersion(required);\n\n  if (!parsedActual || !parsedRequired) {\n    return null;\n  }\n\n  for (const key of [\"major\", \"minor\", \"patch\"] as const) {\n    if (parsedActual[key] > parsedRequired[key]) {\n      return 1;\n    }\n    if (parsedActual[key] < parsedRequired[key]) {\n      return -1;\n    }\n  }\n\n  if (parsedActual.prerelease && !parsedRequired.prerelease) {\n    return -1;\n  }\n  if (!parsedActual.prerelease && parsedRequired.prerelease) {\n    return 1;\n  }\n  if (parsedActual.prerelease && parsedRequired.prerelease) {\n    return parsedActual.prerelease.localeCompare(parsedRequired.prerelease);\n  }\n\n  return 0;\n}\n\nfunction parseAgentServerVersion(version: string) {\n  const trimmed = version.trim().replace(/^v/, \"\");\n  const [withoutBuild] = trimmed.split(\"+\");\n  const [core, prerelease] = withoutBuild.split(\"-\", 2);\n  const parts = core.split(\".\");\n\n  if (parts.length !== 3) {\n    return null;\n  }\n\n  const [major, minor, patch] = parts.map((part) => Number(part));\n  if (\n    ![major, minor, patch].every((part) => Number.isInteger(part) && part >= 0)\n  ) {\n    return null;\n  }\n\n  return { major, minor, patch, prerelease };\n}\n\nexport function assertAgentServerVersionIsSupported(\n  serverInfo: AgentServerInfo,\n) {\n  const actualVersion = getComparableAgentServerVersion(serverInfo);\n  if (!actualVersion) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnknownVersionError(\n      getRawAgentServerVersion(serverInfo),\n    );\n  }\n\n  const comparison = compareAgentServerVersions(\n    actualVersion,\n    MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION,\n  );\n\n  if (comparison === null) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnknownVersionError(actualVersion);\n  }\n\n  if (comparison < 0) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnsupportedVersionError(actualVersion);\n  }\n}\n\nexport async function loadAgentServerInfo() {\n  // The probe is a *local* agent-server concern — it verifies the runtime\n  // hosting the GUI is reachable. It must NEVER run against the active\n  // backend when that backend is cloud, because cloud hosts don't\n  // expose /api/server_info and would fail with a CORS error besides.\n  const local = getEffectiveLocalBackend();\n  if (!local) {\n    clearCachedAgentServerInfo();\n\n    // Empty registry (NO_BACKEND sentinel) — the user has no backend\n    // configured at all.  Throw so root.tsx shows the manage-backends\n    // modal instead of silently rendering a broken home page.\n    if (isNoBackend(getActiveBackend().backend)) {\n      throw new AgentServerUnavailableError(\"No backend configured\", {\n        noBackendConfigured: true,\n      });\n    }\n\n    // Active backend is cloud — no local probe needed.\n    return null;\n  }\n\n  const clientOptions = getAgentServerClientOptions({\n    host: local.host,\n    sessionApiKey: local.apiKey || null,\n    timeout: AGENT_SERVER_INFO_TIMEOUT_MS,\n  });\n  let serverInfo: AgentServerInfo;\n\n  try {\n    serverInfo = (await new ServerClient(\n      clientOptions,\n    ).getServerInfo()) as AgentServerInfo;\n  } catch (error) {\n    clearCachedAgentServerInfo();\n    // Preserve 401 so root.tsx can show the auth screen (public mode).\n    // All other HTTP errors (502, 503, etc.) mean the server is unreachable\n    // or misconfigured — treat them as unavailable.\n    if (isSdkHttpStatusError(error, 401)) {\n      throw error;\n    }\n\n    const details = error instanceof Error ? error.message : null;\n    throw new AgentServerUnavailableError(details);\n  }\n\n  assertAgentServerVersionIsSupported(serverInfo);\n\n  // /server_info is unprotected, so a stale session key still gets 200.\n  // In public mode, validate the key against a protected endpoint so a\n  // server restart with a new LOCAL_BACKEND_API_KEY surfaces immediately\n  // instead of letting the app load and fail on every subsequent call.\n  if (isAuthRequired()) {\n    try {\n      await new SettingsClient(clientOptions).getSettings();\n    } catch (error) {\n      // Only rethrow 401 — that means the stored key is invalid /\n      // rotated.  Other HTTP errors (403, 5xx) and non-HTTP errors\n      // (network, timeout) are swallowed: the server *is* up (we just\n      // reached /server_info), so let the app proceed with an\n      // unvalidated key rather than blocking the UI.\n      // NOTE: If the connection drops between the /server_info and\n      // getSettings() probes, the app loads with an unvalidated key and\n      // subsequent 401s won't trigger the auth screen (they come from\n      // React Query hooks, not this bootstrap path). Acceptable for now\n      // since the window is narrow and a page refresh recovers.\n      if (isSdkHttpStatusError(error, 401)) {\n        throw error;\n      }\n\n      console.warn(\n        \"[agent-server] getSettings() probe failed (non-401):\",\n        error,\n      );\n    }\n  }\n\n  cachedAgentServerInfo = serverInfo;\n  cachedAgentServerInfoHost = clientOptions.host;\n  return serverInfo;\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-server-compatibility.js","names":[],"sources":["../../src/api/agent-server-compatibility.ts"],"sourcesContent":["import {\n  ServerClient,\n  SettingsClient,\n} from \"@openhands/typescript-client/clients\";\nimport type { ServerInfo as BaseServerInfo } from \"@openhands/typescript-client\";\nimport { getAgentServerClientOptions } from \"#/api/agent-server-client-options\";\nimport { isAuthRequired } from \"#/api/agent-server-config\";\nimport {\n  getActiveBackend,\n  getEffectiveLocalBackend,\n  isNoBackend,\n} from \"#/api/backend-registry/active-store\";\nimport defaults from \"../../config/defaults.json\";\n\nconst AGENT_SERVER_INFO_TIMEOUT_MS = 5000;\nconst UNKNOWN_AGENT_SERVER_VERSION = \"unknown\";\n\nexport const MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION =\n  defaults.compatibility.minimumAgentServer;\nexport const AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE =\n  \"AGENT_SERVER_UNSUPPORTED_VERSION\";\nexport const AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE =\n  \"AGENT_SERVER_UNKNOWN_VERSION\";\n\nexport interface AgentServerInfo extends BaseServerInfo {\n  sdk_version?: string;\n  usable_tools?: string[] | null;\n  runtime_services?: unknown;\n}\n\nlet cachedAgentServerInfo: AgentServerInfo | null = null;\nlet cachedAgentServerInfoHost: string | null = null;\n\nconst getAdvertisedTools = (serverInfo: AgentServerInfo | null) => {\n  if (Array.isArray(serverInfo?.usable_tools)) {\n    return serverInfo.usable_tools;\n  }\n  return null;\n};\n\nexport class AgentServerUnavailableError extends Error {\n  readonly details: string | null;\n  readonly noBackendConfigured: boolean;\n\n  constructor(\n    details?: string | null,\n    options?: { noBackendConfigured?: boolean },\n  ) {\n    const noBackendConfigured = options?.noBackendConfigured ?? false;\n    super(\n      noBackendConfigured\n        ? \"No agent server backend is configured yet. Add a backend to get started.\"\n        : \"Could not connect to the configured agent server. Make sure it is running and reachable, then reload the page.\",\n    );\n    this.name = \"AgentServerUnavailableError\";\n    this.details = details ?? null;\n    this.noBackendConfigured = noBackendConfigured;\n  }\n}\n\nexport const isAgentServerUnavailableError = (\n  error: unknown,\n): error is AgentServerUnavailableError =>\n  error instanceof AgentServerUnavailableError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"name\" in error &&\n    (error.name === \"AgentServerUnavailableError\" ||\n      error.name === \"AgentServerUnsupportedVersionError\" ||\n      error.name === \"AgentServerUnknownVersionError\"));\n\nexport class AgentServerUnsupportedVersionError extends AgentServerUnavailableError {\n  readonly code = AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE;\n  readonly actualVersion: string;\n  readonly requiredVersion = MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION;\n\n  constructor(actualVersion: string) {\n    const message = `Agent Canvas requires agent-server ${MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION} or newer; this backend is running ${actualVersion}. Please upgrade the agent-server backend.`;\n    super(message);\n    this.name = \"AgentServerUnsupportedVersionError\";\n    this.message = message;\n    this.actualVersion = actualVersion;\n  }\n}\n\nexport class AgentServerUnknownVersionError extends AgentServerUnavailableError {\n  readonly code = AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE;\n  readonly actualVersion: string | null;\n  readonly requiredVersion = MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION;\n\n  constructor(actualVersion: string | null) {\n    const reported = actualVersion ? ` It reported \"${actualVersion}\".` : \"\";\n    const message =\n      `Could not determine this backend's agent-server version.${reported} ` +\n      `Agent Canvas requires agent-server ${MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION} ` +\n      \"or newer, but this backend did not return a valid version from \" +\n      \"/server_info. Restart or rebuild the agent-server backend, then try again.\";\n    super(message);\n    this.name = \"AgentServerUnknownVersionError\";\n    this.message = message;\n    this.actualVersion = actualVersion;\n  }\n}\n\nexport const isAgentServerUnsupportedVersionError = (\n  error: unknown,\n): error is AgentServerUnsupportedVersionError =>\n  error instanceof AgentServerUnsupportedVersionError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    error.code === AGENT_SERVER_UNSUPPORTED_VERSION_ERROR_CODE);\n\nexport const isAgentServerUnknownVersionError = (\n  error: unknown,\n): error is AgentServerUnknownVersionError =>\n  error instanceof AgentServerUnknownVersionError ||\n  (typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    error.code === AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE);\n\n/**\n * Returns true when the agent-server probe failed with HTTP 401.\n * In public mode this means the stored key is stale (server restarted\n * with a different `LOCAL_BACKEND_API_KEY`). Only meaningful when\n * auth is required — a 401 in local mode is a misconfiguration, not a\n * key-rotation event. Uses {@link isAuthRequired} so both the build-time\n * `VITE_AUTH_REQUIRED` flag and the runtime `window.__AGENT_CANVAS_AUTH_REQUIRED__`\n * injection (used by pre-built static binaries) are honoured.\n */\nexport const isAgentServerAuthError = (error: unknown): boolean =>\n  isAuthRequired() && isSdkHttpStatusError(error, 401);\n\nexport function clearCachedAgentServerInfo() {\n  cachedAgentServerInfo = null;\n  cachedAgentServerInfoHost = null;\n}\n\nexport function getCachedAgentServerInfo(options?: {\n  host?: string | null;\n}): AgentServerInfo | null {\n  if (options?.host && options.host !== cachedAgentServerInfoHost) {\n    return null;\n  }\n  return cachedAgentServerInfo;\n}\n\nexport function isAgentServerToolAvailable(toolName: string) {\n  const availableTools = getAdvertisedTools(cachedAgentServerInfo);\n  if (!Array.isArray(availableTools)) {\n    return true;\n  }\n  return availableTools.includes(toolName);\n}\n\nexport function isSdkHttpError(error: unknown) {\n  return (\n    error instanceof Error &&\n    error.name === \"HttpError\" &&\n    \"status\" in error &&\n    typeof error.status === \"number\"\n  );\n}\n\n/**\n * Narrows an SDK HTTP error to a specific status code.\n * Use instead of manually casting `(err as { status: number }).status`.\n */\nexport function isSdkHttpStatusError(error: unknown, status: number): boolean {\n  return (\n    isSdkHttpError(error) && (error as { status: number }).status === status\n  );\n}\n\nfunction normalizeAgentServerInfoVersion(version: unknown): string | null {\n  if (typeof version !== \"string\") return null;\n  const trimmed = version.trim();\n  return trimmed || null;\n}\n\nfunction getRawAgentServerSdkVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  return normalizeAgentServerInfoVersion(serverInfo.sdk_version);\n}\n\nfunction getRawAgentServerVersion(serverInfo: AgentServerInfo): string | null {\n  return (\n    normalizeAgentServerInfoVersion(serverInfo.version) ??\n    getRawAgentServerSdkVersion(serverInfo)\n  );\n}\n\nfunction getComparableAgentServerVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version = getRawAgentServerVersion(serverInfo);\n  if (!version || version.toLowerCase() === UNKNOWN_AGENT_SERVER_VERSION) {\n    return null;\n  }\n  return version;\n}\n\nexport function getDisplayAgentServerVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version = getComparableAgentServerVersion(serverInfo);\n  if (!version || !parseAgentServerVersion(version)) {\n    return null;\n  }\n  return version;\n}\n\nexport function getDisplayAgentServerSdkVersion(\n  serverInfo: AgentServerInfo,\n): string | null {\n  const version =\n    getRawAgentServerSdkVersion(serverInfo) ??\n    getComparableAgentServerVersion(serverInfo);\n  if (!version || version.toLowerCase() === UNKNOWN_AGENT_SERVER_VERSION) {\n    return null;\n  }\n  return version;\n}\n\nexport function getCachedAgentServerSdkVersion(\n  host?: string | null,\n): string | null {\n  if (!cachedAgentServerInfo) return null;\n  if (host && getEffectiveLocalBackend()?.host !== host) return null;\n  return getDisplayAgentServerSdkVersion(cachedAgentServerInfo);\n}\n\nexport function getCachedAgentServerVersion(\n  host?: string | null,\n): string | null {\n  if (!cachedAgentServerInfo) return null;\n  if (host && getEffectiveLocalBackend()?.host !== host) return null;\n  return getDisplayAgentServerVersion(cachedAgentServerInfo);\n}\n\nexport function compareAgentServerVersions(actual: string, required: string) {\n  const parsedActual = parseAgentServerVersion(actual);\n  const parsedRequired = parseAgentServerVersion(required);\n\n  if (!parsedActual || !parsedRequired) {\n    return null;\n  }\n\n  for (const key of [\"major\", \"minor\", \"patch\"] as const) {\n    if (parsedActual[key] > parsedRequired[key]) {\n      return 1;\n    }\n    if (parsedActual[key] < parsedRequired[key]) {\n      return -1;\n    }\n  }\n\n  if (parsedActual.prerelease && !parsedRequired.prerelease) {\n    return -1;\n  }\n  if (!parsedActual.prerelease && parsedRequired.prerelease) {\n    return 1;\n  }\n  if (parsedActual.prerelease && parsedRequired.prerelease) {\n    return parsedActual.prerelease.localeCompare(parsedRequired.prerelease);\n  }\n\n  return 0;\n}\n\nfunction parseAgentServerVersion(version: string) {\n  const trimmed = version.trim().replace(/^v/, \"\");\n  const [withoutBuild] = trimmed.split(\"+\");\n  const [core, prerelease] = withoutBuild.split(\"-\", 2);\n  const parts = core.split(\".\");\n\n  if (parts.length !== 3) {\n    return null;\n  }\n\n  const [major, minor, patch] = parts.map((part) => Number(part));\n  if (\n    ![major, minor, patch].every((part) => Number.isInteger(part) && part >= 0)\n  ) {\n    return null;\n  }\n\n  return { major, minor, patch, prerelease };\n}\n\nexport function assertAgentServerVersionIsSupported(\n  serverInfo: AgentServerInfo,\n) {\n  const actualVersion = getComparableAgentServerVersion(serverInfo);\n  if (!actualVersion) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnknownVersionError(\n      getRawAgentServerVersion(serverInfo),\n    );\n  }\n\n  const comparison = compareAgentServerVersions(\n    actualVersion,\n    MINIMUM_COMPATIBLE_AGENT_SERVER_VERSION,\n  );\n\n  if (comparison === null) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnknownVersionError(actualVersion);\n  }\n\n  if (comparison < 0) {\n    clearCachedAgentServerInfo();\n    throw new AgentServerUnsupportedVersionError(actualVersion);\n  }\n}\n\nexport async function loadAgentServerInfo() {\n  // The probe is a *local* agent-server concern — it verifies the runtime\n  // hosting the GUI is reachable. It must NEVER run against the active\n  // backend when that backend is cloud, because cloud hosts don't\n  // expose /api/server_info and would fail with a CORS error besides.\n  const local = getEffectiveLocalBackend();\n  if (!local) {\n    clearCachedAgentServerInfo();\n\n    // Empty registry (NO_BACKEND sentinel) — the user has no backend\n    // configured at all.  Throw so root.tsx shows the manage-backends\n    // modal instead of silently rendering a broken home page.\n    if (isNoBackend(getActiveBackend().backend)) {\n      throw new AgentServerUnavailableError(\"No backend configured\", {\n        noBackendConfigured: true,\n      });\n    }\n\n    // Active backend is cloud — no local probe needed.\n    return null;\n  }\n\n  const clientOptions = getAgentServerClientOptions({\n    host: local.host,\n    sessionApiKey: local.apiKey || null,\n    timeout: AGENT_SERVER_INFO_TIMEOUT_MS,\n  });\n  let serverInfo: AgentServerInfo;\n\n  try {\n    serverInfo = (await new ServerClient(\n      clientOptions,\n    ).getServerInfo()) as AgentServerInfo;\n  } catch (error) {\n    clearCachedAgentServerInfo();\n    // Preserve 401 so root.tsx can show the auth screen (public mode).\n    // All other HTTP errors (502, 503, etc.) mean the server is unreachable\n    // or misconfigured — treat them as unavailable.\n    if (isSdkHttpStatusError(error, 401)) {\n      throw error;\n    }\n\n    const details = error instanceof Error ? error.message : null;\n    throw new AgentServerUnavailableError(details);\n  }\n\n  assertAgentServerVersionIsSupported(serverInfo);\n\n  // /server_info is unprotected, so a stale session key still gets 200.\n  // In public mode, validate the key against a protected endpoint so a\n  // server restart with a new LOCAL_BACKEND_API_KEY surfaces immediately\n  // instead of letting the app load and fail on every subsequent call.\n  if (isAuthRequired()) {\n    try {\n      await new SettingsClient(clientOptions).getSettings();\n    } catch (error) {\n      // Only rethrow 401 — that means the stored key is invalid /\n      // rotated.  Other HTTP errors (403, 5xx) and non-HTTP errors\n      // (network, timeout) are swallowed: the server *is* up (we just\n      // reached /server_info), so let the app proceed with an\n      // unvalidated key rather than blocking the UI.\n      // NOTE: If the connection drops between the /server_info and\n      // getSettings() probes, the app loads with an unvalidated key and\n      // subsequent 401s won't trigger the auth screen (they come from\n      // React Query hooks, not this bootstrap path). Acceptable for now\n      // since the window is narrow and a page refresh recovers.\n      if (isSdkHttpStatusError(error, 401)) {\n        throw error;\n      }\n\n      console.warn(\n        \"[agent-server] getSettings() probe failed (non-401):\",\n        error,\n      );\n    }\n  }\n\n  cachedAgentServerInfo = serverInfo;\n  cachedAgentServerInfoHost = clientOptions.host;\n  return serverInfo;\n}\n"],"mappings":";;;;;;;;AAcA,IAAM,IAA+B,KAC/B,IAA+B,WAExB,IACX,EAAS,cAAc,oBACZ,IACX,oCACW,IACX,gCAQE,IAAgD,MAChD,IAA2C,MAEzC,KAAsB,MACtB,MAAM,QAAQ,GAAY,YAAY,IACjC,EAAW,eAEb,MAGI,IAAb,cAAiD,MAAM;CACrD;CACA;CAEA,YACE,GACA,GACA;EACA,IAAM,IAAsB,GAAS,uBAAuB;EAQ5D,AAPA,MACE,IACI,6EACA,gHACN,GACA,KAAK,OAAO,+BACZ,KAAK,UAAU,KAAW,MAC1B,KAAK,sBAAsB;CAC7B;AACF,GAEa,KACX,MAEA,aAAiB,KAChB,OAAO,KAAU,cAChB,KACA,UAAU,MACT,EAAM,SAAS,iCACd,EAAM,SAAS,wCACf,EAAM,SAAS,mCAER,IAAb,cAAwD,EAA4B;CAClF,OAAgB;CAChB;CACA,kBAA2B;CAE3B,YAAY,GAAuB;EACjC,IAAM,IAAU,sCAAsC,EAAwC,qCAAqC,EAAc;EAIjJ,AAHA,MAAM,CAAO,GACb,KAAK,OAAO,sCACZ,KAAK,UAAU,GACf,KAAK,gBAAgB;CACvB;AACF,GAEa,IAAb,cAAoD,EAA4B;CAC9E,OAAgB;CAChB;CACA,kBAA2B;CAE3B,YAAY,GAA8B;EAExC,IAAM,IACJ,2DAFe,IAAgB,iBAAiB,EAAc,MAAM,GAEA,sCAC9B,EAAwC;EAMhF,AAHA,MAAM,CAAO,GACb,KAAK,OAAO,kCACZ,KAAK,UAAU,GACf,KAAK,gBAAgB;CACvB;AACF,GA6Ba,KAA0B,MACrC,EAAe,KAAK,EAAqB,GAAO,GAAG;AAErD,SAAgB,IAA6B;CAE3C,AADA,IAAwB,MACxB,IAA4B;AAC9B;AAEA,SAAgB,EAAyB,GAEd;CAIzB,OAHI,GAAS,QAAQ,EAAQ,SAAS,IAC7B,OAEF;AACT;AAEA,SAAgB,EAA2B,GAAkB;CAC3D,IAAM,IAAiB,EAAmB,CAAqB;CAI/D,OAHK,MAAM,QAAQ,CAAc,IAG1B,EAAe,SAAS,CAAQ,IAF9B;AAGX;AAEA,SAAgB,EAAe,GAAgB;CAC7C,OACE,aAAiB,SACjB,EAAM,SAAS,eACf,YAAY,KACZ,OAAO,EAAM,UAAW;AAE5B;AAMA,SAAgB,EAAqB,GAAgB,GAAyB;CAC5E,OACE,EAAe,CAAK,KAAM,EAA6B,WAAW;AAEtE;AAEA,SAAS,EAAgC,GAAiC;CAGxE,OAFI,OAAO,KAAY,YACP,EAAQ,KACjB,KAFiC;AAG1C;AAEA,SAAS,EACP,GACe;CACf,OAAO,EAAgC,EAAW,WAAW;AAC/D;AAEA,SAAS,EAAyB,GAA4C;CAC5E,OACE,EAAgC,EAAW,OAAO,KAClD,EAA4B,CAAU;AAE1C;AAEA,SAAS,EACP,GACe;CACf,IAAM,IAAU,EAAyB,CAAU;CAInD,OAHI,CAAC,KAAW,EAAQ,YAAY,MAAM,IACjC,OAEF;AACT;AAEA,SAAgB,EACd,GACe;CACf,IAAM,IAAU,EAAgC,CAAU;CAI1D,OAHI,CAAC,KAAW,CAAC,EAAwB,CAAO,IACvC,OAEF;AACT;AAsBA,SAAgB,EACd,GACe;CAGf,OAFI,CAAC,KACD,KAAQ,EAAyB,GAAG,SAAS,IAAa,OACvD,EAA6B,CAAqB;AAC3D;AAEA,SAAgB,EAA2B,GAAgB,GAAkB;CAC3E,IAAM,IAAe,EAAwB,CAAM,GAC7C,IAAiB,EAAwB,CAAQ;CAEvD,IAAI,CAAC,KAAgB,CAAC,GACpB,OAAO;CAGT,KAAK,IAAM,KAAO;EAAC;EAAS;EAAS;CAAO,GAAY;EACtD,IAAI,EAAa,KAAO,EAAe,IACrC,OAAO;EAET,IAAI,EAAa,KAAO,EAAe,IACrC,OAAO;CAEX;CAYA,OAVI,EAAa,cAAc,CAAC,EAAe,aACtC,KAEL,CAAC,EAAa,cAAc,EAAe,aACtC,IAEL,EAAa,cAAc,EAAe,aACrC,EAAa,WAAW,cAAc,EAAe,UAAU,IAGjE;AACT;AAEA,SAAS,EAAwB,GAAiB;CAEhD,IAAM,CAAC,KADS,EAAQ,KAAK,EAAE,QAAQ,MAAM,EACtB,EAAQ,MAAM,GAAG,GAClC,CAAC,GAAM,KAAc,EAAa,MAAM,KAAK,CAAC,GAC9C,IAAQ,EAAK,MAAM,GAAG;CAE5B,IAAI,EAAM,WAAW,GACnB,OAAO;CAGT,IAAM,CAAC,GAAO,GAAO,KAAS,EAAM,KAAK,MAAS,OAAO,CAAI,CAAC;CAO9D,OALG;EAAC;EAAO;EAAO;CAAK,EAAE,OAAO,MAAS,OAAO,UAAU,CAAI,KAAK,KAAQ,CAAC,IAKrE;EAAE;EAAO;EAAO;EAAO;CAAW,IAHhC;AAIX;AAEA,SAAgB,EACd,GACA;CACA,IAAM,IAAgB,EAAgC,CAAU;CAChE,IAAI,CAAC,GAEH,MADA,EAA2B,GACrB,IAAI,EACR,EAAyB,CAAU,CACrC;CAGF,IAAM,IAAa,EACjB,GACA,CACF;CAEA,IAAI,MAAe,MAEjB,MADA,EAA2B,GACrB,IAAI,EAA+B,CAAa;CAGxD,IAAI,IAAa,GAEf,MADA,EAA2B,GACrB,IAAI,EAAmC,CAAa;AAE9D;AAEA,eAAsB,IAAsB;CAK1C,IAAM,IAAQ,EAAyB;CACvC,IAAI,CAAC,GAAO;EAMV,IALA,EAA2B,GAKvB,EAAY,EAAiB,EAAE,OAAO,GACxC,MAAM,IAAI,EAA4B,yBAAyB,EAC7D,qBAAqB,GACvB,CAAC;EAIH,OAAO;CACT;CAEA,IAAM,IAAgB,EAA4B;EAChD,MAAM,EAAM;EACZ,eAAe,EAAM,UAAU;EAC/B,SAAS;CACX,CAAC,GACG;CAEJ,IAAI;EACF,IAAc,MAAM,IAAI,EACtB,CACF,EAAE,cAAc;CAClB,SAAS,GAAO;EAUd,MATA,EAA2B,GAIvB,EAAqB,GAAO,GAAG,IAC3B,IAIF,IAAI,EADM,aAAiB,QAAQ,EAAM,UAAU,IACZ;CAC/C;CAQA,IANA,EAAoC,CAAU,GAM1C,EAAe,GACjB,IAAI;EACF,MAAM,IAAI,EAAe,CAAa,EAAE,YAAY;CACtD,SAAS,GAAO;EAWd,IAAI,EAAqB,GAAO,GAAG,GACjC,MAAM;EAGR,QAAQ,KACN,wDACA,CACF;CACF;CAKF,OAFA,IAAwB,GACxB,IAA4B,EAAc,MACnC;AACT"}

package/dist/api/conversation-service/agent-server-conversation-service.api.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/conversation-client.cjs"),t=require("../../node_modules/@openhands/typescript-client/dist/client/file-client.cjs"),n=require("../../node_modules/@openhands/typescript-client/dist/client/profiles-client.cjs"),r=require("../../node_modules/@openhands/typescript-client/dist/client/vscode-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const i=require("../../utils/websocket-url.cjs"),a=require("../agent-server-config.cjs"),o=require("../backend-registry/active-store.cjs"),s=require("../agent-server-client-options.cjs"),c=require("../conversation-metadata-store.cjs"),l=require("../cloud/proxy.cjs"),u=require("../cloud/conversation-service.api.cjs"),d=require("../../node_modules/@openhands/typescript-client/dist/models/conversation.cjs");require("../../node_modules/@openhands/typescript-client/dist/index.cjs");const f=require("../../node_modules/uuid/dist/v4.cjs"),p=require("../agent-server-home.cjs"),m=require("../profiles-service/profiles-service.api.cjs"),h=require("../settings-service/settings-service.api.cjs"),g=require("../agent-server-adapter.cjs"),_=require("../../utils/title-llm-profile.cjs");var v=`1970-01-01T00:00:00.000Z`,y=300*1e3,b=`Unable to load conversations because the selected agent server returned data this UI does not understand. Check the backend URL/session key and update the agent server if needed.`;function x(){return Error(b)}function S(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function C(e){return typeof e==`number`?e:null}function w(e){return typeof e==`number`?e:0}function T(e){return typeof e==`string`?e:null}function E(e,t,n){let r=e[t]??e[n];return typeof r==`string`&&r.trim()?r:v}function D(e){return S(e)?{prompt_tokens:w(e.prompt_tokens),completion_tokens:w(e.completion_tokens),cache_read_tokens:w(e.cache_read_tokens),cache_write_tokens:w(e.cache_write_tokens),context_window:w(e.context_window),per_turn_token:w(e.per_turn_token)}:null}function O(e){return S(e)?{accumulated_cost:C(e.accumulated_cost),max_budget_per_task:C(e.max_budget_per_task),accumulated_token_usage:D(e.accumulated_token_usage)}:null}function k(e){if(!S(e))return null;let t=S(e.llm)?{model:T(e.llm.model)}:null;return{kind:T(e.kind),acp_server:T(e.acp_server),acp_model:T(e.acp_model),llm:t}}function A(e){return S(e)?{working_dir:T(e.working_dir)}:null}function j(e){if(!S(e))return null;let t={};for(let[n,r]of Object.entries(e))typeof r==`string`&&(t[n]=r);return t}function M(e){if(!S(e))return null;let{agent_profile_id:t,revision:n}=e;return typeof t!=`string`||typeof n!=`number`?null:{agent_profile_id:t,revision:n}}function N(e){if(!e.startsWith(`/`))return null;let t=[];for(let n of e.split(`/`))if(n&&n!==`.`)if(n===`..`){if(!t.length)return null;t.pop()}else t.push(n);return`/${t.join(`/`)}`}function P(e,t){let n=N(e),r=N(t);if(!n||!r||n!==r&&!n.startsWith(`${r}/`))throw Error(`Conversation file path must stay inside the workspace`);return n}function F(e){if(!S(e)||typeof e.id!=`string`||!e.id.trim())throw x();return{id:e.id.trim(),title:T(e.title),created_at:E(e,`created_at`,`createdAt`),updated_at:E(e,`updated_at`,`updatedAt`),execution_status:T(e.execution_status),sandbox_status:T(e.sandbox_status),metrics:O(e.metrics),agent:k(e.agent),workspace:A(e.workspace),tags:j(e.tags),launched_agent_profile:M(e.launched_agent_profile),current_model_id:T(e.current_model_id),current_model_name:T(e.current_model_name)}}function I(e){if(!Array.isArray(e))throw x();return e.map(F)}function L(e){if(Array.isArray(e))return{items:I(e),next_page_id:null};if(!S(e))throw x();return{items:I(e.items),next_page_id:typeof e.next_page_id==`string`?e.next_page_id:null}}var R=new Set([`idle`,`running`,`paused`,`waiting_for_confirmation`,`finished`,`error`,`stuck`]);function z(e){let t=e??`idle`;return R.has(t)?t:`idle`}function B(e,t){if(!e)throw Error(`Conversation ${t} was not found`);return e}var V=class{static async sendMessage(t,n,r){let a=o.getActiveBackend().backend,c=r?.conversationUrl??null,d=r?.sessionApiKey??null;if(a.kind===`cloud`){if(!c||!d){let[e]=await u.batchGetCloudConversations([t]);c=e?.conversation_url?.trim()??null,d=e?.session_api_key?.trim()??null}if(!c||!d)throw Error(`Conversation sandbox is still starting. Wait for it to finish, then try again.`);return await l.callCloudProxy({backend:a,method:`POST`,hostOverride:i.buildHttpBaseUrl(c),path:`/api/conversations/${t}/events`,body:{...n,run:!0},authMode:`session-api-key`,sessionApiKey:d}),n}return await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:c,sessionApiKey:d})).sendEvent(t,n,{run:!0}),n}static async createConversation(t,n,r,i,l,d,v,b,x,S,C){if(o.getActiveBackend().backend.kind===`cloud`)return u.createCloudAppConversation({initial_message:t?{role:`user`,content:[{type:`text`,text:t}]}:null,title:n??null,selected_repository:i?.selected_repository??null,selected_branch:i?.selected_branch??null,git_provider:i?.git_provider??null,plugins:r??null,parent_conversation_id:v??null,agent_type:b,sandbox_id:x??null,agent_profile_id:S??null});let[w,T]=await Promise.all([h.default.getSettings(),m.default.listProfiles().catch(()=>void 0)]),E=_.resolveTitleLlmProfile(w.title_llm_profile,T),D=f.default(),O=await p.resolveAbsoluteAgentServerPath(l??a.buildConversationWorkingDir(D)),k=d??(l?`local_repo`:`new_worktree`),A=await g.buildStartConversationRequestWithEncryptedSettings({settings:w,query:t,conversationInstructions:n,plugins:r,conversationId:D,parentConversationId:v,workingDir:O,worktree:k===`new_worktree`,agentProfileId:S,agentProfileKind:C,titleLlmProfile:E}),j=await new e.ConversationClient(s.getAgentServerClientOptions({timeout:y})).createConversation(A),M=o.getEffectiveLocalBackend();if(!M)throw new s.NoBackendAvailableError;return(i?.selected_repository||l)&&c.setStoredConversationMetadata(j.id,{selected_repository:i?.selected_repository??null,selected_branch:i?.selected_branch??null,git_provider:i?.git_provider??null,selected_workspace:l??null,workspace_mode:k}),{id:j.id,created_by_user_id:null,status:`READY`,detail:null,app_conversation_id:j.id,agent_server_url:M.host,request:{initial_message:A.initial_message,plugins:r??null},created_at:j.created_at,updated_at:j.updated_at}}static async getStartTask(e){return o.getActiveBackend().backend.kind===`cloud`?u.getCloudAppConversationStartTask(e):null}static async getVSCodeUrl(e,t,n){let i=await this.resolveConversationWorkingDir(e);return{vscode_url:await new r.VSCodeClient(s.getAgentServerClientOptions({conversationUrl:t,sessionApiKey:n})).getUrl({baseUrl:typeof window<`u`?window.location.origin:void 0,workspaceDir:i})}}static async resolveConversationWorkingDir(e){let[t]=await this.batchGetAppConversations([e]);return t?.workspace?.working_dir??a.getAgentServerWorkingDir()}static async batchGetAppConversations(t){return t.length===0?[]:o.getActiveBackend().backend.kind===`cloud`?u.batchGetCloudConversations(t):I(await new e.ConversationClient(s.getAgentServerClientOptions()).getConversations(t)).map(e=>g.toAppConversation(e))}static async updateConversationPublicFlag(e,t){if(o.getActiveBackend().backend.kind!==`cloud`)throw Error(`Public sharing requires a cloud backend.`);return u.updateCloudConversationPublicFlag(e,t)}static async updateConversationRepository(e,t,n,r){t?c.setStoredConversationMetadata(e,{...c.getStoredConversationMetadata(e)??{},selected_repository:t,selected_branch:n??null,git_provider:r??null}):c.removeStoredConversationMetadata(e);let[i]=await this.batchGetAppConversations([e]);return B(i,e)}static async readConversationFile(e,n){if(o.getActiveBackend().backend.kind===`cloud`)return u.readCloudConversationFile(e,P(n??`/workspace/project/.agents_tmp/PLAN.md`,`/workspace/project`));let r=await this.resolveConversationWorkingDir(e),i=P(n??`${r}/.agents_tmp/PLAN.md`,r);return new t.FileClient(s.getAgentServerClientOptions()).downloadTextFile(i)}static async downloadConversation(e){return o.getActiveBackend().backend.kind===`cloud`?u.downloadCloudConversation(e):new t.FileClient(s.getAgentServerClientOptions()).downloadTrajectory(e)}static async getHooks(e){return g.emptyHooksResponse()}static async getRuntimeConversation(t,n,r){let i=await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:n,sessionApiKey:r})).getConversation(t),a=F(i),o=S(i)?i.stats:null;return{id:a.id,title:a.title?.trim()?a.title:g.getDefaultConversationTitle(a.id),metrics:O(a.metrics),created_at:a.created_at,updated_at:a.updated_at,status:z(a.execution_status),stats:S(o)?o:{usage_to_metrics:{}}}}static async searchConversations(t=20,n){return o.getActiveBackend().backend.kind===`cloud`?u.searchCloudConversations(t,n):g.toConversationPage(L(await new e.ConversationClient(s.getAgentServerClientOptions()).searchConversations({limit:t,page_id:n,sort_order:d.ConversationSortOrder.UPDATED_AT_DESC})))}static async deleteConversation(t){o.getActiveBackend().backend.kind===`cloud`?await u.deleteCloudConversation(t):await new e.ConversationClient(s.getAgentServerClientOptions()).deleteConversation(t),c.removeStoredConversationMetadata(t)}static async updateConversationTitle(t,n){await new e.ConversationClient(s.getAgentServerClientOptions()).updateConversation(t,{title:n});let[r]=await this.batchGetAppConversations([t]);return B(r,t)}static async forkConversation(t,n,r){if(o.getActiveBackend().backend.kind===`cloud`)throw Error(`Branching a conversation isn't supported on the cloud backend yet.`);let i=await new e.ConversationClient(s.getAgentServerClientOptions()).forkConversation(t,{from_event_id:n,...r?{title:r}:{}}),a=c.getStoredConversationMetadata(t);return a&&c.setStoredConversationMetadata(i.id,a),i}static async getEventParentId(t,n){return(await new e.ConversationClient(s.getAgentServerClientOptions()).getEvent(t,n)).parent_id??void 0}static async switchProfile(t,r){let{backend:i}=o.getActiveBackend();if(i.kind===`cloud`){if(!t){await m.default.activateProfile(r);return}await l.callCloudProxy({backend:i,method:`POST`,path:`/api/v1/app-conversations/${t}/switch_profile`,body:{profile_name:r}});return}if(!t){await new n.ProfilesClient(s.getAgentServerClientOptions()).activateProfile(r);return}let a=s.getAgentServerClientOptions(),c=new e.ConversationClient(a),u=await new n.ProfilesClient(a).getProfile(r,{exposeSecrets:`encrypted`}),d=typeof u.config.model==`string`?u.config.model:``;if(!d)throw Error(`Profile '${r}' has no model.`);await g.assertSubscriptionAuthReady({llm:u.config}),await c.switchLLM(t,{...u.config,model:d,stream:!0,usage_id:`profile:${r}:${f.default()}`})}static async switchAcpModel(t,n){let{backend:r}=o.getActiveBackend();if(r.kind===`cloud`){await l.callCloudProxy({backend:r,method:`POST`,path:`/api/v1/app-conversations/${t}/switch_acp_model`,body:{model:n}});return}await new e.ConversationClient(s.getAgentServerClientOptions()).switchAcpModel(t,n)}};exports.default=V;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/conversation-client.cjs"),t=require("../../node_modules/@openhands/typescript-client/dist/client/file-client.cjs"),n=require("../../node_modules/@openhands/typescript-client/dist/client/profiles-client.cjs"),r=require("../../node_modules/@openhands/typescript-client/dist/client/vscode-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const i=require("../../utils/websocket-url.cjs"),a=require("../agent-server-config.cjs"),o=require("../backend-registry/active-store.cjs"),s=require("../agent-server-client-options.cjs"),c=require("../conversation-metadata-store.cjs"),l=require("../cloud/proxy.cjs"),u=require("../cloud/conversation-service.api.cjs"),d=require("../../node_modules/@openhands/typescript-client/dist/models/conversation.cjs");require("../../node_modules/@openhands/typescript-client/dist/index.cjs");const f=require("../../node_modules/uuid/dist/v4.cjs"),p=require("../agent-server-home.cjs"),m=require("../profiles-service/profiles-service.api.cjs"),h=require("../settings-service/settings-service.api.cjs"),g=require("../agent-server-adapter.cjs"),_=require("../../utils/title-llm-profile.cjs");var v=`1970-01-01T00:00:00.000Z`,y=300*1e3,b=`Unable to load conversations because the selected agent server returned data this UI does not understand. Check the backend URL/session key and update the agent server if needed.`;function x(){return Error(b)}function S(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function C(e){return typeof e==`number`?e:null}function w(e){return typeof e==`number`?e:0}function T(e){return typeof e==`string`?e:null}function E(e,t,n){let r=e[t]??e[n];return typeof r==`string`&&r.trim()?r:v}function D(e){return S(e)?{prompt_tokens:w(e.prompt_tokens),completion_tokens:w(e.completion_tokens),cache_read_tokens:w(e.cache_read_tokens),cache_write_tokens:w(e.cache_write_tokens),context_window:w(e.context_window),per_turn_token:w(e.per_turn_token)}:null}function O(e){return S(e)?{accumulated_cost:C(e.accumulated_cost),max_budget_per_task:C(e.max_budget_per_task),accumulated_token_usage:D(e.accumulated_token_usage)}:null}function k(e){if(!S(e))return null;let t=S(e.llm)?{model:T(e.llm.model)}:null;return{kind:T(e.kind),acp_server:T(e.acp_server),acp_model:T(e.acp_model),llm:t}}function A(e){return S(e)?{working_dir:T(e.working_dir)}:null}function j(e){if(!S(e))return null;let t={};for(let[n,r]of Object.entries(e))typeof r==`string`&&(t[n]=r);return t}function M(e){if(!S(e))return null;let{agent_profile_id:t,revision:n}=e;return typeof t!=`string`||typeof n!=`number`?null:{agent_profile_id:t,revision:n}}function N(e){if(!e.startsWith(`/`))return null;let t=[];for(let n of e.split(`/`))if(n&&n!==`.`)if(n===`..`){if(!t.length)return null;t.pop()}else t.push(n);return`/${t.join(`/`)}`}function P(e,t){let n=N(e),r=N(t);if(!n||!r||n!==r&&!n.startsWith(`${r}/`))throw Error(`Conversation file path must stay inside the workspace`);return n}function F(e){if(!S(e)||typeof e.id!=`string`||!e.id.trim())throw x();return{id:e.id.trim(),title:T(e.title),created_at:E(e,`created_at`,`createdAt`),updated_at:E(e,`updated_at`,`updatedAt`),execution_status:T(e.execution_status),sandbox_status:T(e.sandbox_status),metrics:O(e.metrics),agent:k(e.agent),workspace:A(e.workspace),tags:j(e.tags),launched_agent_profile:M(e.launched_agent_profile),current_model_id:T(e.current_model_id),current_model_name:T(e.current_model_name)}}function I(e){if(!Array.isArray(e))throw x();return e.map(F)}function L(e){if(Array.isArray(e))return{items:I(e),next_page_id:null};if(!S(e))throw x();return{items:I(e.items),next_page_id:typeof e.next_page_id==`string`?e.next_page_id:null}}var R=new Set([`idle`,`running`,`paused`,`waiting_for_confirmation`,`finished`,`error`,`stuck`]);function z(e){let t=e??`idle`;return R.has(t)?t:`idle`}function B(e,t){if(!e)throw Error(`Conversation ${t} was not found`);return e}var V=class{static async sendMessage(t,n,r){let a=o.getActiveBackend().backend,c=r?.conversationUrl??null,d=r?.sessionApiKey??null;if(a.kind===`cloud`){if(!c||!d){let[e]=await u.batchGetCloudConversations([t]);c=e?.conversation_url?.trim()??null,d=e?.session_api_key?.trim()??null}if(!c||!d)throw Error(`Conversation sandbox is still starting. Wait for it to finish, then try again.`);return await l.callCloudProxy({backend:a,method:`POST`,hostOverride:i.buildHttpBaseUrl(c),path:`/api/conversations/${t}/events`,body:{...n,run:!0},authMode:`session-api-key`,sessionApiKey:d}),n}return await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:c,sessionApiKey:d})).sendEvent(t,n,{run:!0}),n}static async createConversation(t={}){let{initialUserMsg:n,conversationInstructions:r,plugins:i,metadata:l,workingDirOverride:d,workspaceMode:v,parentConversationId:b,agentType:x,sandboxId:S,agentProfileId:C,agentProfileKind:w}=t;if(o.getActiveBackend().backend.kind===`cloud`)return u.createCloudAppConversation({initial_message:n?{role:`user`,content:[{type:`text`,text:n}]}:null,title:r??null,selected_repository:l?.selected_repository??null,selected_branch:l?.selected_branch??null,git_provider:l?.git_provider??null,plugins:i??null,parent_conversation_id:b??null,agent_type:x,sandbox_id:S??null,agent_profile_id:C??null});let[T,E]=await Promise.all([h.default.getSettings(),m.default.listProfiles().catch(()=>void 0)]),D=_.resolveTitleLlmProfile(T.title_llm_profile,E),O=f.default(),k=await p.resolveAbsoluteAgentServerPath(d??a.buildConversationWorkingDir(O)),A=v??(d?`local_repo`:`new_worktree`),j=await g.buildStartConversationRequestWithEncryptedSettings({settings:T,query:n,conversationInstructions:r,plugins:i,conversationId:O,parentConversationId:b,workingDir:k,worktree:A===`new_worktree`,agentProfileId:C,agentProfileKind:w,titleLlmProfile:D}),M=await new e.ConversationClient(s.getAgentServerClientOptions({timeout:y})).createConversation(j),N=o.getEffectiveLocalBackend();if(!N)throw new s.NoBackendAvailableError;return(l?.selected_repository||d)&&c.setStoredConversationMetadata(M.id,{selected_repository:l?.selected_repository??null,selected_branch:l?.selected_branch??null,git_provider:l?.git_provider??null,selected_workspace:d??null,workspace_mode:A}),{id:M.id,created_by_user_id:null,status:`READY`,detail:null,app_conversation_id:M.id,agent_server_url:N.host,request:{initial_message:j.initial_message,plugins:i??null},created_at:M.created_at,updated_at:M.updated_at}}static async getStartTask(e){return o.getActiveBackend().backend.kind===`cloud`?u.getCloudAppConversationStartTask(e):null}static async getVSCodeUrl(e,t,n){let i=await this.resolveConversationWorkingDir(e);return{vscode_url:await new r.VSCodeClient(s.getAgentServerClientOptions({conversationUrl:t,sessionApiKey:n})).getUrl({baseUrl:typeof window<`u`?window.location.origin:void 0,workspaceDir:i})}}static async resolveConversationWorkingDir(e){let[t]=await this.batchGetAppConversations([e]);return t?.workspace?.working_dir??a.getAgentServerWorkingDir()}static async batchGetAppConversations(t){return t.length===0?[]:o.getActiveBackend().backend.kind===`cloud`?u.batchGetCloudConversations(t):I(await new e.ConversationClient(s.getAgentServerClientOptions()).getConversations(t)).map(e=>g.toAppConversation(e))}static async updateConversationPublicFlag(e,t){if(o.getActiveBackend().backend.kind!==`cloud`)throw Error(`Public sharing requires a cloud backend.`);return u.updateCloudConversationPublicFlag(e,t)}static async updateConversationRepository(e,t,n,r){t?c.setStoredConversationMetadata(e,{...c.getStoredConversationMetadata(e)??{},selected_repository:t,selected_branch:n??null,git_provider:r??null}):c.removeStoredConversationMetadata(e);let[i]=await this.batchGetAppConversations([e]);return B(i,e)}static async readConversationFile(e,n){if(o.getActiveBackend().backend.kind===`cloud`)return u.readCloudConversationFile(e,P(n??`/workspace/project/.agents_tmp/PLAN.md`,`/workspace/project`));let r=await this.resolveConversationWorkingDir(e),i=P(n??`${r}/.agents_tmp/PLAN.md`,r);return new t.FileClient(s.getAgentServerClientOptions()).downloadTextFile(i)}static async downloadConversation(e){return o.getActiveBackend().backend.kind===`cloud`?u.downloadCloudConversation(e):new t.FileClient(s.getAgentServerClientOptions()).downloadTrajectory(e)}static async getHooks(e){return g.emptyHooksResponse()}static async getRuntimeConversation(t,n,r){let i=await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:n,sessionApiKey:r})).getConversation(t),a=F(i),o=S(i)?i.stats:null;return{id:a.id,title:a.title?.trim()?a.title:g.getDefaultConversationTitle(a.id),metrics:O(a.metrics),created_at:a.created_at,updated_at:a.updated_at,status:z(a.execution_status),stats:S(o)?o:{usage_to_metrics:{}}}}static async condenseConversation(t,n,r){let a=o.getActiveBackend().backend;if(a.kind===`cloud`&&n){await l.callCloudProxy({backend:a,method:`POST`,hostOverride:i.buildHttpBaseUrl(n),path:`/api/conversations/${t}/condense`,authMode:`session-api-key`,sessionApiKey:r});return}await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:n,sessionApiKey:r})).condenseConversation(t)}static async searchConversations(t=20,n){return o.getActiveBackend().backend.kind===`cloud`?u.searchCloudConversations(t,n):g.toConversationPage(L(await new e.ConversationClient(s.getAgentServerClientOptions()).searchConversations({limit:t,page_id:n,sort_order:d.ConversationSortOrder.UPDATED_AT_DESC})))}static async deleteConversation(t){o.getActiveBackend().backend.kind===`cloud`?await u.deleteCloudConversation(t):await new e.ConversationClient(s.getAgentServerClientOptions()).deleteConversation(t),c.removeStoredConversationMetadata(t)}static async updateConversationTitle(t,n){await new e.ConversationClient(s.getAgentServerClientOptions()).updateConversation(t,{title:n});let[r]=await this.batchGetAppConversations([t]);return B(r,t)}static async forkConversation(t,n,r){if(o.getActiveBackend().backend.kind===`cloud`)throw Error(`Branching a conversation isn't supported on the cloud backend yet.`);let i=await new e.ConversationClient(s.getAgentServerClientOptions()).forkConversation(t,{from_event_id:n,...r?{title:r}:{}}),a=c.getStoredConversationMetadata(t);return a&&c.setStoredConversationMetadata(i.id,a),i}static async getEventParentId(t,n){return(await new e.ConversationClient(s.getAgentServerClientOptions()).getEvent(t,n)).parent_id??void 0}static async switchProfile(t,r){let{backend:i}=o.getActiveBackend();if(i.kind===`cloud`){if(!t){await m.default.activateProfile(r);return}await l.callCloudProxy({backend:i,method:`POST`,path:`/api/v1/app-conversations/${t}/switch_profile`,body:{profile_name:r}});return}if(!t){await new n.ProfilesClient(s.getAgentServerClientOptions()).activateProfile(r);return}let a=s.getAgentServerClientOptions(),c=new e.ConversationClient(a),u=await new n.ProfilesClient(a).getProfile(r,{exposeSecrets:`encrypted`}),d=typeof u.config.model==`string`?u.config.model:``;if(!d)throw Error(`Profile '${r}' has no model.`);await g.assertSubscriptionAuthReady({llm:u.config}),await c.switchLLM(t,{...u.config,model:d,stream:!0,usage_id:`profile:${r}:${f.default()}`})}static async switchAcpModel(t,n){let{backend:r}=o.getActiveBackend();if(r.kind===`cloud`){await l.callCloudProxy({backend:r,method:`POST`,path:`/api/v1/app-conversations/${t}/switch_acp_model`,body:{model:n}});return}await new e.ConversationClient(s.getAgentServerClientOptions()).switchAcpModel(t,n)}};exports.default=V;
 //# sourceMappingURL=agent-server-conversation-service.api.cjs.map