@openhands/agent-canvas 1.8.0 → 1.10.0

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

@@ -1 +1 @@
-{"version":3,"file":"agent-server-adapter.js","names":[],"sources":["../../src/api/agent-server-adapter.ts"],"sourcesContent":["import { ACP_SETTINGS_KEYS } from \"@openhands/typescript-client\";\nimport { SKILLS_CATALOG } from \"@openhands/extensions/skills\";\nimport { DEFAULT_SETTINGS } from \"#/services/settings\";\nimport { ExecutionStatus } from \"#/types/agent-server/core\";\nimport { AgentKind, Settings, SettingsValue } from \"#/types/settings\";\nimport {\n  getAcpPreferredDefaultModel,\n  getAcpProvider,\n  resolveEffectiveAcpModel,\n} from \"#/constants/acp-providers\";\nimport { getAgentServerClientOptions } from \"./agent-server-client-options\";\nimport { isAgentServerToolAvailable } from \"./agent-server-compatibility\";\nimport { getAgentServerWorkingDir } from \"./agent-server-config\";\nimport { getEffectiveLocalBackend } from \"./backend-registry/active-store\";\nimport { buildAuthHeaders } from \"./backend-registry/auth\";\nimport {\n  GetHooksResponse,\n  PluginSpec,\n  AppConversation,\n  AppConversationPage,\n  SandboxStatus,\n} from \"./conversation-service/agent-server-conversation-service.types\";\nimport SettingsService from \"./settings-service/settings-service.api\";\nimport { getStoredConversationMetadata } from \"./conversation-metadata-store\";\nimport LLMSubscriptionService from \"./llm-subscription-service\";\nimport {\n  LLM_AUTH_TYPE_SUBSCRIPTION,\n  OPENAI_SUBSCRIPTION_VENDOR,\n  isSubscriptionLlmConfig,\n} from \"#/constants/llm-subscription\";\nimport {\n  CANVAS_UI_CLIENT_TOOL,\n  CANVAS_UI_CLIENT_TOOL_NAME,\n  LEGACY_CANVAS_UI_TOOL_NAME,\n  type ClientToolSpec,\n} from \"./canvas-ui-client-tool\";\n\nexport interface DirectConversationInfo {\n  id: string;\n  title?: string | null;\n  created_at: string;\n  updated_at: string;\n  execution_status?: string | null;\n  /** Cloud-only sandbox lifecycle state. Omitted / null for local agent-server conversations. */\n  sandbox_status?: string | null;\n  metrics?: {\n    accumulated_cost?: number | null;\n    max_budget_per_task?: number | null;\n    accumulated_token_usage?: {\n      prompt_tokens?: number;\n      completion_tokens?: number;\n      cache_read_tokens?: number;\n      cache_write_tokens?: number;\n      context_window?: number;\n      per_turn_token?: number;\n    } | null;\n  } | null;\n  agent?: {\n    /**\n     * Pydantic discriminator from the SDK union: ``\"ACPAgent\"`` for ACP CLI\n     * subprocesses (model lives on the subprocess via ``acp_model``),\n     * ``\"Agent\"`` for direct litellm. Read by {@link toAppConversation}.\n     */\n    kind?: string | null;\n    acp_model?: string | null;\n    /**\n     * ACP CLI identity (``claude-code`` / ``codex`` / ``gemini-cli``) from the\n     * SDK's ``ACPAgent.acp_server`` (#3692). Preferred fallback when the\n     * ``acpserver`` tag is absent — e.g. a profile launch doesn't stamp the tag\n     * client-side and the server may not repopulate it. Read by {@link toAppConversation}.\n     */\n    acp_server?: string | null;\n    llm?: {\n      model?: string | null;\n    } | null;\n  } | null;\n  current_model_id?: string | null;\n  current_model_name?: string | null;\n  workspace?: {\n    working_dir?: string | null;\n  } | null;\n  /**\n   * Arbitrary string-keyed conversation tags surfaced by the agent-server\n   * (see ``ConversationInfo.tags``). Canvas only consumes one key today —\n   * ``ACP_SERVER_TAG_KEY`` (\"acpserver\") — but the field is typed as a\n   * generic record so future readers don't need another wire-shape change.\n   * Keys are constrained to ``^[a-z0-9]+$`` by the agent-server validator;\n   * values are opaque strings.\n   */\n  tags?: Record<string, string> | null;\n  launched_agent_profile?: {\n    agent_profile_id: string;\n    revision: number;\n  } | null;\n}\n\nconst DEFAULT_TOOL_NAMES = [\"terminal\", \"file_editor\", \"task_tracker\"];\nconst BROWSER_TOOL_SET_NAME = \"browser_tool_set\";\nconst TASK_TOOL_SET_NAME = \"task_tool_set\";\n\nfunction browserToolsEnabled() {\n  return import.meta.env.VITE_ENABLE_BROWSER_TOOLS !== \"false\";\n}\n\n/**\n * Shape of the runtime services info (set by the dev launchers in\n * scripts/dev-*.mjs as `VITE_RUNTIME_SERVICES_INFO`, or injected at serve time\n * by `scripts/static-server.mjs` for static builds — see\n * `getRawRuntimeServicesInfo`). All URLs are written from the agent's point of\n * view, not the browser's. The block is rendered into the agent's system prompt\n * via `AgentContext.system_message_suffix` so the agent knows what's\n * reachable from inside its sandbox without having to probe.\n */\ninterface RuntimeServicesInfo {\n  mode?: string;\n  agent_host_alias?: string;\n  services?: {\n    agent_server?: { description?: string; url_from_agent?: string };\n    ingress?: { description?: string; url_from_agent?: string };\n    frontend?: {\n      kind?: \"vite\" | \"static\";\n      description?: string;\n      url_from_agent?: string;\n    };\n    // `vite` is the legacy key name for the frontend entry, accepted for\n    // one release while older dev-stack launchers may still emit it.\n    vite?: { description?: string; url_from_agent?: string };\n    automation?: {\n      description?: string;\n      url_from_agent?: string;\n      api_prefix?: string;\n      docs_url?: string;\n      openapi_url?: string;\n      auth_env_var?: string;\n    };\n  };\n}\n\n/**\n * Return the raw runtime-services JSON string, consulting two sources in order\n * (mirrors `getBakedSessionApiKey` in agent-server-config.ts):\n *   1. `VITE_RUNTIME_SERVICES_INFO` — baked into the bundle at build time by\n *      the dev launchers (`npm run dev`, dev:static).\n *   2. `window.__AGENT_CANVAS_RUNTIME_SERVICES_INFO__` — injected into\n *      index.html at serve time by `scripts/static-server.mjs\n *      --runtime-services-info <json>`. This is the path used by static builds\n *      (the Docker image and the published binary), where the env var is empty\n *      in the prebuilt bundle. Without it the `<RUNTIME_SERVICES>` block is\n *      missing and the agent cannot reach the local automation backend.\n */\nfunction getRawRuntimeServicesInfo(): string | null {\n  const envRaw = import.meta.env.VITE_RUNTIME_SERVICES_INFO?.trim();\n  if (envRaw) return envRaw;\n\n  if (typeof window !== \"undefined\") {\n    const injected = (window as unknown as Record<string, unknown>)\n      .__AGENT_CANVAS_RUNTIME_SERVICES_INFO__;\n    if (typeof injected === \"string\") {\n      return injected.trim() || null;\n    }\n  }\n\n  return null;\n}\n\nfunction parseRuntimeServicesInfo(): RuntimeServicesInfo | null {\n  const raw = getRawRuntimeServicesInfo();\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as RuntimeServicesInfo;\n    if (!parsed || typeof parsed !== \"object\") return null;\n    return parsed;\n  } catch {\n    // Malformed JSON: ignore and fall back to no runtime info, rather than\n    // tearing down conversation creation over a misconfigured env var or\n    // injected value.\n    return null;\n  }\n}\n\n/**\n * Return the deployment mode from the runtime services info, e.g. \"docker\",\n * \"dev:automation\", etc. Returns `null` when no runtime info is configured.\n */\nexport function getDeploymentMode(): string | null {\n  return parseRuntimeServicesInfo()?.mode ?? null;\n}\n\n/**\n * Render the runtime services info into a markdown block suitable for\n * appending to the system prompt via `AgentContext.system_message_suffix`.\n *\n * Returns `undefined` when no runtime info is configured, so callers can\n * safely omit the field on production builds (where the launcher doesn't\n * set `VITE_RUNTIME_SERVICES_INFO`).\n */\nexport function buildRuntimeServicesSystemSuffix(): string | undefined {\n  const info = parseRuntimeServicesInfo();\n  if (!info?.services) return undefined;\n\n  const lines: string[] = [];\n  lines.push(\"<RUNTIME_SERVICES>\");\n  if (info.mode) {\n    lines.push(\n      `You are running inside an agent-canvas dev stack started in '${info.mode}' mode.`,\n    );\n  } else {\n    lines.push(\"You are running inside an agent-canvas dev stack.\");\n  }\n  lines.push(\n    \"The following services are reachable from your sandbox. URLs are written\",\n    \"from your point of view (i.e., as you should curl/fetch them).\",\n    \"\",\n  );\n\n  const { agent_server, ingress, automation } = info.services;\n  const { frontend } = info.services;\n\n  if (agent_server?.url_from_agent) {\n    lines.push(\n      `* Agent Server (you): ${agent_server.url_from_agent}`,\n      `    ${agent_server.description ?? \"The agent-server hosting your tool calls.\"}`,\n    );\n  }\n  if (ingress?.url_from_agent) {\n    lines.push(\n      `* Ingress: ${ingress.url_from_agent}`,\n      `    ${ingress.description ?? \"Unified entry point for browser-facing traffic.\"}`,\n    );\n  }\n  if (frontend?.url_from_agent) {\n    lines.push(\n      `* Frontend: ${frontend.url_from_agent}`,\n      `    ${frontend.description ?? \"Frontend dev server.\"}`,\n    );\n  }\n  if (automation?.url_from_agent) {\n    lines.push(\n      `* Automation backend: ${automation.url_from_agent}`,\n      `    ${automation.description ?? \"OpenHands Automations service.\"}`,\n    );\n    if (automation.docs_url) {\n      lines.push(`    Docs:    ${automation.docs_url}`);\n    }\n    if (automation.openapi_url) {\n      lines.push(`    OpenAPI: ${automation.openapi_url}`);\n    }\n    if (automation.auth_env_var) {\n      // X-Session-API-Key is the local convention shared by the agent-server\n      // and automation backend (see openhands-automation auth.py).\n      lines.push(\n        `    Auth:    header 'X-Session-API-Key: $${automation.auth_env_var}'`,\n      );\n    }\n  } else {\n    lines.push(\n      \"* Automation backend: not running in this dev mode (skip /api/automation calls).\",\n    );\n  }\n\n  // Anchor the \"don't guess\" warning to the actual agent-server URL for\n  // this stack instead of a hardcoded port. The agent-server listens on\n  // different ports across dev modes, and baking the wrong port into the\n  // system prompt is exactly the kind of confusion this block is meant to\n  // prevent.\n  const agentServerUrl = agent_server?.url_from_agent;\n  lines.push(\n    \"\",\n    \"Trust this block over guessing: do not assume any other URLs are running.\",\n  );\n  if (agentServerUrl) {\n    lines.push(\n      `In particular, ${agentServerUrl} inside your sandbox is the Agent Server`,\n      \"you are running inside of — NOT the automation backend.\",\n    );\n  }\n  lines.push(\"</RUNTIME_SERVICES>\");\n\n  return lines.join(\"\\n\");\n}\n\nexport function toConversationUrl(conversationId: string): string {\n  // Local-format conversation URL — points at whichever local agent-server\n  // is actually serving the conversation (the bundled one when the active\n  // selection is cloud).\n  const { host } = getAgentServerClientOptions();\n  return `${host}/api/conversations/${conversationId}`;\n}\n\n// TODO(i18n): extract \"Conversation\" once we add CONVERSATION$DEFAULT_TITLE\n// with `{{shortId}}` interpolation. Kept as a literal for now to keep the\n// fallback inside this pure adapter rather than fanning out to display sites.\nexport function getDefaultConversationTitle(conversationId: string): string {\n  return `Conversation ${conversationId.slice(0, 5)}`;\n}\n\nexport function toAppConversation(\n  info: DirectConversationInfo,\n): AppConversation {\n  const metadata = getStoredConversationMetadata(info.id);\n  // ACPAgent conversations carry a sentinel ``llm`` on older SDKs. Prefer the\n  // runtime model fields when available, then the configured ``acp_model`` that\n  // Canvas saves for built-in providers. ``agent_kind`` still gates model\n  // switching, so surfacing this string is display-only.\n  const isAcp = info.agent?.kind === \"ACPAgent\";\n  // Only surface ``acp_server`` for ACP conversations even if the wire\n  // payload accidentally carries an ``acpserver`` tag on an OpenHands\n  // conversation — the chip is identity info for the ACP CLI subprocess,\n  // and showing it on a non-ACP conversation would be a lie. Fall back to the\n  // agent's own ``acp_server`` (#3692) when the tag is missing — a profile\n  // launch doesn't stamp the tag, so tag-only reads would drop the ACP model\n  // picker and degrade the chip to a generic \"ACP\" (#1571).\n  const acpServer = isAcp\n    ? (info.tags?.[ACP_SERVER_TAG_KEY] ?? info.agent?.acp_server ?? null)\n    : null;\n  return {\n    id: info.id,\n    created_by_user_id: null,\n    selected_repository: metadata?.selected_repository ?? null,\n    selected_branch: metadata?.selected_branch ?? null,\n    git_provider: metadata?.git_provider ?? null,\n    selected_workspace: metadata?.selected_workspace ?? null,\n    active_profile: metadata?.active_profile ?? null,\n    title: info.title?.trim()\n      ? info.title\n      : getDefaultConversationTitle(info.id),\n    trigger: null,\n    pr_number: [],\n    agent_kind: isAcp ? \"acp\" : \"openhands\",\n    acp_server: acpServer,\n    tags: info.tags ?? null,\n    launched_agent_profile: info.launched_agent_profile ?? null,\n    // Chip path: omit ``providerDefault`` so that when no concrete model\n    // resolves, the chip falls back to the provider display name in\n    // ConversationCardFooter rather than a registry default the session may\n    // not actually be running.\n    llm_model: isAcp\n      ? resolveEffectiveAcpModel({\n          runtimeName: info.current_model_name,\n          runtimeId: info.current_model_id,\n          configured: info.agent?.acp_model,\n          sdkLlm: info.agent?.llm?.model,\n        })\n      : (info.agent?.llm?.model ?? DEFAULT_SETTINGS.llm_model),\n    metrics: info.metrics\n      ? {\n          accumulated_cost: info.metrics.accumulated_cost ?? null,\n          max_budget_per_task: info.metrics.max_budget_per_task ?? null,\n          accumulated_token_usage: info.metrics.accumulated_token_usage\n            ? {\n                prompt_tokens:\n                  info.metrics.accumulated_token_usage.prompt_tokens ?? 0,\n                completion_tokens:\n                  info.metrics.accumulated_token_usage.completion_tokens ?? 0,\n                cache_read_tokens:\n                  info.metrics.accumulated_token_usage.cache_read_tokens ?? 0,\n                cache_write_tokens:\n                  info.metrics.accumulated_token_usage.cache_write_tokens ?? 0,\n                context_window:\n                  info.metrics.accumulated_token_usage.context_window ?? 0,\n                per_turn_token:\n                  info.metrics.accumulated_token_usage.per_turn_token ?? 0,\n              }\n            : null,\n        }\n      : null,\n    created_at: info.created_at,\n    updated_at: info.updated_at,\n    execution_status:\n      (info.execution_status as AppConversation[\"execution_status\"]) ??\n      ExecutionStatus.IDLE,\n    sandbox_status: (info.sandbox_status as SandboxStatus | null) ?? null,\n    conversation_url: toConversationUrl(info.id),\n    session_api_key: getAgentServerClientOptions().apiKey ?? null,\n    sandbox_id: null,\n    workspace: {\n      working_dir: info.workspace?.working_dir ?? getAgentServerWorkingDir(),\n    },\n    public: false,\n    sub_conversation_ids: [],\n  };\n}\n\nexport function toConversationPage(data: {\n  items: DirectConversationInfo[];\n  next_page_id?: string | null;\n}): AppConversationPage {\n  return {\n    items: data.items.map(toAppConversation),\n    next_page_id: data.next_page_id ?? null,\n  };\n}\n\ntype SettingsRecord = Record<string, unknown>;\n\ninterface AgentToolSpec {\n  name: string;\n  params: SettingsRecord;\n}\n\ntype AgentSettingsPayload = SettingsRecord & {\n  llm?: SettingsRecord;\n  agent_context: SettingsRecord;\n  tools?: AgentToolSpec[];\n};\n\ninterface LocalWorkspacePayload {\n  kind: \"LocalWorkspace\";\n  working_dir: string;\n}\n\ninterface InitialMessagePayload {\n  role: \"user\";\n  content: Array<{ type: \"text\"; text: string }>;\n  run: true;\n}\n\ntype ConversationSettingsPayload = SettingsRecord & {\n  workspace: LocalWorkspacePayload;\n  initial_message?: InitialMessagePayload;\n};\n\nexport const ACP_SERVER_TAG_KEY = \"acpserver\";\n\n/**\n * Conversation tag keys Canvas itself stamps/consumes for internal routing.\n * They are already surfaced through dedicated UI (the ACP provider chip), so\n * the generic tag-chip display filters them out.\n */\nexport const RESERVED_CONVERSATION_TAG_KEYS: ReadonlySet<string> = new Set([\n  ACP_SERVER_TAG_KEY,\n]);\n\n/**\n * User-facing subset of a conversation's server-side tags: everything except\n * {@link RESERVED_CONVERSATION_TAG_KEYS}, as stable ``[key, value]`` entries\n * sorted by key so chip order doesn't shuffle between refetches.\n */\nexport function getDisplayConversationTags(\n  tags: Record<string, string> | null | undefined,\n): Array<[string, string]> {\n  if (!tags) {\n    return [];\n  }\n  return Object.entries(tags)\n    .filter(([key]) => !RESERVED_CONVERSATION_TAG_KEYS.has(key))\n    .sort(([a], [b]) => a.localeCompare(b));\n}\n\nconst FERNET_TOKEN_PREFIX = \"gAAAAA\";\n\nconst CONVERSATION_SETTINGS_METADATA_KEYS = new Set([\n  \"schema_version\",\n  \"agent_settings\",\n  \"workspace\",\n  \"conversation_id\",\n  \"initial_message\",\n  \"plugins\",\n]);\n\nfunction toRecord(value: unknown): SettingsRecord {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return {};\n  }\n\n  return structuredClone(value as SettingsRecord);\n}\n\nfunction normalizeSecretString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction hasEncryptedString(value: unknown): boolean {\n  if (typeof value === \"string\") {\n    return value.startsWith(FERNET_TOKEN_PREFIX);\n  }\n  if (Array.isArray(value)) {\n    return value.some(hasEncryptedString);\n  }\n  if (isPlainRecord(value)) {\n    return Object.values(value).some(hasEncryptedString);\n  }\n  return false;\n}\n\nfunction hasEncryptedMcpSecrets(mcpConfig: unknown): boolean {\n  if (!isPlainRecord(mcpConfig)) {\n    return false;\n  }\n\n  return Object.values(mcpConfig).some(hasEncryptedString);\n}\n\nfunction getConversationConfirmationPolicy(\n  conversationSettings: SettingsRecord,\n) {\n  if (conversationSettings.confirmation_mode !== true) {\n    return { kind: \"NeverConfirm\" };\n  }\n\n  if (conversationSettings.security_analyzer === \"llm\") {\n    return { kind: \"ConfirmRisky\", threshold: \"HIGH\", confirm_unknown: true };\n  }\n\n  return { kind: \"AlwaysConfirm\" };\n}\n\nfunction getConversationSecurityAnalyzer(conversationSettings: SettingsRecord) {\n  switch (conversationSettings.security_analyzer) {\n    case \"llm\":\n      return { kind: \"LLMSecurityAnalyzer\" };\n    case \"pattern\":\n      return { kind: \"PatternSecurityAnalyzer\" };\n    case \"policy_rail\":\n      return { kind: \"PolicyRailSecurityAnalyzer\" };\n    default:\n      return undefined;\n  }\n}\n\nfunction isToolRecord(\n  value: unknown,\n): value is { name: string; params?: unknown } {\n  return (\n    !!value &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    typeof (value as { name?: unknown }).name === \"string\"\n  );\n}\n\nfunction shouldIncludeTool(name: string, agentSettings: SettingsRecord) {\n  if (name === BROWSER_TOOL_SET_NAME) {\n    return browserToolsEnabled() && isAgentServerToolAvailable(name);\n  }\n\n  if (name === TASK_TOOL_SET_NAME) {\n    return (\n      agentSettings.enable_sub_agents === true &&\n      isAgentServerToolAvailable(name)\n    );\n  }\n\n  return true;\n}\n\nfunction getAgentTools(agentSettings: SettingsRecord): AgentToolSpec[] {\n  const tools = new Map<string, AgentToolSpec>();\n\n  for (const name of DEFAULT_TOOL_NAMES) {\n    if (shouldIncludeTool(name, agentSettings)) {\n      tools.set(name, { name, params: {} });\n    }\n  }\n\n  for (const name of [BROWSER_TOOL_SET_NAME, TASK_TOOL_SET_NAME]) {\n    if (shouldIncludeTool(name, agentSettings)) {\n      tools.set(name, { name, params: {} });\n    }\n  }\n\n  const configuredTools = agentSettings.tools;\n  if (\n    Array.isArray(configuredTools) &&\n    configuredTools.every((tool) => isToolRecord(tool))\n  ) {\n    for (const tool of configuredTools) {\n      if (shouldIncludeTool(tool.name, agentSettings)) {\n        tools.set(tool.name, {\n          name: tool.name,\n          params: toRecord(tool.params),\n        });\n      }\n    }\n  }\n\n  return Array.from(tools.values());\n}\n\nfunction buildInitialMessage(\n  query?: string,\n  conversationInstructions?: string,\n): InitialMessagePayload | null {\n  const parts = [query?.trim(), conversationInstructions?.trim()].filter(\n    Boolean,\n  );\n  if (parts.length === 0) {\n    return null;\n  }\n\n  return {\n    role: \"user\",\n    content: [{ type: \"text\", text: parts.join(\"\\n\\n\") }],\n    run: true,\n  };\n}\n\n/**\n * Shape of a bundled skill entry passed to the agent-server SDK via\n * `agent_context.skills`. Mirrors the SDK's `Skill` model fields that\n * the server uses for trigger matching, activation, and system-prompt\n * injection.\n */\ninterface BundledSkill {\n  name: string;\n  content: string;\n  trigger: { type: \"keyword\"; keywords: string[] } | null;\n  source: string;\n  description: string | null;\n  is_agentskills_format: true;\n  license?: string;\n  compatibility?: string;\n}\n\n/**\n * Convert the bundled `SKILLS_CATALOG` entries into the SDK `Skill` JSON\n * shape so the agent-server can perform trigger matching, skill activation,\n * and system-prompt injection without cloning the extensions repo.\n *\n * The SDK discriminates triggers via `{ type: \"keyword\", keywords: [...] }`.\n * Skills with no triggers get `trigger: null` (always-active / on-demand).\n */\nfunction buildBundledSkills(): BundledSkill[] {\n  return SKILLS_CATALOG.map((entry) => {\n    const trigger: BundledSkill[\"trigger\"] =\n      entry.triggers?.length > 0\n        ? { type: \"keyword\", keywords: entry.triggers }\n        : null;\n\n    // Use the absolute path to the skill's SKILL.md so the Python\n    // agent-server can resolve bundled resources (scripts/, references/).\n    // Falls back to \"public\" in library builds where the path isn't known.\n    const source = __EXTENSIONS_SKILLS_DIR__\n      ? `${__EXTENSIONS_SKILLS_DIR__}/${entry.name}/SKILL.md`\n      : \"public\";\n\n    return {\n      name: entry.name,\n      content: entry.content,\n      trigger,\n      source,\n      description: entry.description ?? null,\n      is_agentskills_format: true as const,\n      ...(entry.license ? { license: entry.license } : {}),\n      ...(entry.compatibility ? { compatibility: entry.compatibility } : {}),\n    };\n  });\n}\n\nfunction buildAgentContext(\n  agentSettings: SettingsRecord,\n  disabledSkills: string[] = [],\n): SettingsRecord {\n  const runtimeServicesSuffix = buildRuntimeServicesSystemSuffix();\n  const existingContext = toRecord(agentSettings.agent_context);\n\n  // Merge bundled public skills with any skills already present in the\n  // agent context (e.g. user-defined skills set via the settings API).\n  const existingSkills = Array.isArray(existingContext.skills)\n    ? (existingContext.skills as SettingsRecord[])\n    : [];\n  const disabledSkillNames = new Set(disabledSkills);\n  const mergedSkills = [...existingSkills, ...buildBundledSkills()].filter(\n    (skill) =>\n      typeof skill.name !== \"string\" || !disabledSkillNames.has(skill.name),\n  );\n\n  return {\n    ...existingContext,\n    // Public skills are bundled at build time from the @openhands/extensions\n    // npm package and passed directly in agent_context.skills. Setting\n    // load_public_skills to false tells the agent-server SDK to skip its own\n    // extensions-repo clone — the frontend is the sole source of public\n    // skills now.\n    //\n    // Migration: the former VITE_LOAD_PUBLIC_SKILLS env var was removed\n    // because bundled skills have no clone latency. Users who previously set\n    // VITE_LOAD_PUBLIC_SKILLS=false to avoid clone delays no longer need it.\n    skills: mergedSkills,\n    load_public_skills: false,\n    load_user_skills: true,\n    load_project_skills: true,\n    ...(runtimeServicesSuffix\n      ? { system_message_suffix: runtimeServicesSuffix }\n      : {}),\n  };\n}\n\nfunction isAcpAgent(settings: Settings): boolean {\n  const agentSettings = toRecord(settings.agent_settings);\n  return agentSettings.agent_kind === \"acp\";\n}\n\nfunction getAcpServerTag(settings: Settings): string | undefined {\n  const agentSettings = toRecord(settings.agent_settings);\n  const value = agentSettings.acp_server;\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction resolveAcpCommand(agentSettings: SettingsRecord): unknown {\n  const cmd = agentSettings.acp_command;\n  const isEmpty = Array.isArray(cmd) && cmd.length === 0;\n  const noCommand = cmd === undefined;\n  if (!isEmpty && !noCommand) {\n    return cmd;\n  }\n\n  const serverKey =\n    typeof agentSettings.acp_server === \"string\"\n      ? agentSettings.acp_server\n      : undefined;\n  const provider = getAcpProvider(serverKey);\n  return provider ? [...provider.default_command] : cmd;\n}\n\nfunction buildConfiguredAcpAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  const agentSettings = toRecord(settings.agent_settings);\n  const payload: AgentSettingsPayload = {\n    agent_kind: \"acp\",\n    agent_context: buildAgentContext(agentSettings, settings.disabled_skills),\n  };\n\n  // TODO(#1019): set ``acp_isolate_data_dir: true`` here for a containerized\n  // backend so concurrent same-provider conversations don't race on a shared\n  // HOME. The SDK supports it (software-agent-sdk#3492), but the released\n  // ``@openhands/typescript-client`` (1.24.3) doesn't surface it on\n  // ``ACPAgentSettings`` yet, so sending it risks a validation error on older\n  // servers. Cloud grouping isolation is separate (agent-canvas#1016).\n\n  for (const key of ACP_SETTINGS_KEYS) {\n    // ``acp_model`` is resolved separately below so a saved ``null`` still\n    // falls back to the provider's default rather than being dropped.\n    if (key === \"acp_model\") continue;\n    // ``acp_env`` is deprecated — provider creds now route via ``request.secrets``.\n    if (key === \"acp_env\") continue;\n    const value =\n      key === \"acp_command\"\n        ? resolveAcpCommand(agentSettings)\n        : agentSettings[key];\n    if (value !== undefined && value !== null) {\n      payload[key] = value;\n    }\n  }\n\n  // ``mcp_config`` is a shared field (not in ACP_SETTINGS_KEYS): forward it\n  // so the ACP subprocess connects to the configured MCP servers at session\n  // creation. Only include it when it actually carries servers — an empty or\n  // malformed value is dropped rather than sending ``mcp_config: {}``.\n  const mcpConfig = toRecord(agentSettings.mcp_config);\n  if (Object.keys(mcpConfig).length > 0) {\n    payload.mcp_config = mcpConfig;\n  }\n\n  // Saved settings may carry ``acp_model: null`` (existing users predating\n  // the default-model registry, or saved fields the agent-server stripped).\n  // Fall back to the *preferred* default (Vertex-safe for Gemini) so the\n  // conversation starts with whatever the Settings → Agent UI shows — without\n  // that, the form's displayed default would silently not take effect at\n  // runtime until the user re-saved the page.\n  const serverKey =\n    typeof agentSettings.acp_server === \"string\"\n      ? agentSettings.acp_server\n      : undefined;\n  const effectiveModel = resolveEffectiveAcpModel({\n    configured: agentSettings.acp_model as string | null | undefined,\n    providerDefault: getAcpPreferredDefaultModel(serverKey),\n  });\n  if (effectiveModel) {\n    payload.acp_model = effectiveModel;\n  }\n\n  return payload;\n}\n\nfunction buildConfiguredOpenHandsAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  const agentSettings = toRecord(settings.agent_settings);\n  const llm = toRecord(agentSettings.llm);\n\n  llm.model =\n    typeof llm.model === \"string\" && llm.model.trim().length > 0\n      ? llm.model\n      : DEFAULT_SETTINGS.llm_model;\n\n  // Stream assistant tokens (parity with ACP agents). The agent-server only\n  // emits StreamingDeltaEvents for SDK LLM agents when an LLM has stream=True.\n  llm.stream = true;\n\n  const apiKey = normalizeSecretString(llm.api_key);\n  if (apiKey) {\n    llm.api_key = apiKey;\n  } else {\n    delete llm.api_key;\n  }\n\n  const baseUrl = normalizeSecretString(llm.base_url);\n  if (baseUrl) {\n    llm.base_url = baseUrl;\n  } else {\n    delete llm.base_url;\n  }\n\n  if (isSubscriptionLlmConfig(llm)) {\n    llm.auth_type = LLM_AUTH_TYPE_SUBSCRIPTION;\n    llm.subscription_vendor = OPENAI_SUBSCRIPTION_VENDOR;\n    delete llm.api_key;\n    delete llm.base_url;\n  } else {\n    delete llm.auth_type;\n    delete llm.subscription_vendor;\n  }\n\n  const mcpConfig = toRecord(agentSettings.mcp_config);\n  if (Object.keys(mcpConfig).length === 0) {\n    delete agentSettings.mcp_config;\n  }\n\n  delete agentSettings.acp_server;\n  for (const key of ACP_SETTINGS_KEYS) {\n    delete agentSettings[key];\n  }\n  // ``acp_env`` is no longer a forwarded ACP setting (provider creds ride the\n  // Secrets panel), but a legacy value may linger on persisted settings —\n  // scrub it so it never leaks onto the OpenHands payload.\n  delete agentSettings.acp_env;\n\n  return {\n    ...agentSettings,\n    llm,\n    agent_context: buildAgentContext(agentSettings, settings.disabled_skills),\n    tools: getAgentTools(agentSettings),\n  };\n}\n\nfunction buildConfiguredAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  return isAcpAgent(settings)\n    ? buildConfiguredAcpAgentSettings(settings)\n    : buildConfiguredOpenHandsAgentSettings(settings);\n}\n\nfunction buildConfiguredConversationSettings(options: {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  workingDir?: string;\n}): ConversationSettingsPayload {\n  const { settings, query, conversationInstructions, plugins, workingDir } =\n    options;\n  const conversationSettings = toRecord(settings.conversation_settings);\n  const initialMessage = buildInitialMessage(query, conversationInstructions);\n\n  CONVERSATION_SETTINGS_METADATA_KEYS.forEach(\n    (key) => delete conversationSettings[key],\n  );\n\n  const payload: ConversationSettingsPayload = {\n    ...conversationSettings,\n    workspace: {\n      kind: \"LocalWorkspace\",\n      working_dir: workingDir ?? getAgentServerWorkingDir(),\n    },\n    ...(initialMessage ? { initial_message: initialMessage } : {}),\n    ...(plugins?.length\n      ? {\n          plugins: plugins.map((plugin) => ({\n            source: plugin.source,\n            ...(plugin.ref ? { ref: plugin.ref } : {}),\n            ...(plugin.repo_path ? { repo_path: plugin.repo_path } : {}),\n          })),\n        }\n      : {}),\n  };\n\n  return payload;\n}\n\ninterface LookupSecret {\n  kind: \"LookupSecret\";\n  url: string;\n  headers?: Record<string, string>;\n  description?: string;\n}\n\ntype StartConversationPayload = Record<string, unknown> & {\n  // Omitted when launching via ``agent_profile_id`` — the two are mutually\n  // exclusive agent sources; the server resolves the profile server-side.\n  agent_settings?: AgentSettingsPayload;\n  agent_profile_id?: string;\n  workspace: LocalWorkspacePayload;\n  confirmation_policy: SettingsRecord;\n  security_analyzer?: SettingsRecord;\n  initial_message?: InitialMessagePayload;\n  max_iterations: number;\n  stuck_detection: true;\n  autotitle: true;\n  title_llm_profile?: string;\n  worktree: boolean;\n  secrets_encrypted?: true;\n  conversation_id?: string;\n  secrets?: Record<string, LookupSecret>;\n  tags?: Record<string, string>;\n  client_tools: ClientToolSpec[];\n  tool_module_qualnames?: Record<string, string>;\n};\n\nexport interface StartConversationOptions {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  conversationId?: string;\n  workingDir?: string;\n  worktree?: boolean;\n  encryptedAgentSettings?: Record<string, SettingsValue>;\n  encryptedConversationSettings?: Record<string, SettingsValue>;\n  secretsEncrypted?: boolean;\n  customSecrets?: Array<{ name: string; description?: string }>;\n  // When set, the conversation launches from this AgentProfile (resolved\n  // server-side) instead of an inline ``agent_settings`` dump (#3727).\n  agentProfileId?: string;\n  agentProfileKind?: AgentKind;\n  titleLlmProfile?: string;\n}\n\nexport function buildStartConversationRequest(\n  options: StartConversationOptions,\n): StartConversationPayload {\n  const sourceAgentSettings = options.encryptedAgentSettings\n    ? { ...options.settings, agent_settings: options.encryptedAgentSettings }\n    : options.settings;\n\n  const acpMode = isAcpAgent(sourceAgentSettings);\n  const launchAgentKind = options.agentProfileId\n    ? options.agentProfileKind\n    : acpMode\n      ? \"acp\"\n      : \"openhands\";\n  const agentSettings = buildConfiguredAgentSettings(sourceAgentSettings);\n  const acpServerTag = acpMode\n    ? getAcpServerTag(sourceAgentSettings)\n    : undefined;\n\n  const sourceConversationOptions = options.encryptedConversationSettings\n    ? {\n        ...options,\n        settings: {\n          ...options.settings,\n          conversation_settings: options.encryptedConversationSettings,\n        },\n      }\n    : options;\n\n  const conversationSettings = buildConfiguredConversationSettings(\n    sourceConversationOptions,\n  );\n\n  const payload: StartConversationPayload = {\n    // ``agent_profile_id`` and ``agent_settings`` are mutually exclusive agent\n    // sources; the profile path lets the server resolve the profile (#3727).\n    //\n    // Enrichment boundary: on the profile path the server rebuilds the agent\n    // purely from the stored profile fields, so the client-owned enrichments\n    // this adapter folds into ``agent_settings`` do NOT apply. The exec toolset\n    // (terminal/file_editor/task_tracker) and public-skill loading are the\n    // server/SDK's responsibility to restore on the profile path — tracked in\n    // software-agent-sdk#3967 (profile resolution must attach the default\n    // toolset + public skills, else a profile-launched OpenHands agent has only\n    // Finish/Think). The dev ``RUNTIME_SERVICES`` system-message suffix remains\n    // agent-settings-only; the Canvas UI tool is a top-level client tool and\n    // therefore works on both inline-agent and profile launch paths.\n    //\n    // Persistent memory is NOT on that boundary: ``load_memory`` is a global\n    // user preference, so the agent-server stamps the stored\n    // ``agent_settings.agent_context.load_memory`` onto the profile-resolved\n    // agent the same way it already applies the global ``mcp_config``. The\n    // toggle therefore applies to both launch paths, and the client must not\n    // re-send it here (``agent_profile_id`` and ``agent_settings`` are\n    // mutually exclusive).\n    ...(options.agentProfileId\n      ? { agent_profile_id: options.agentProfileId }\n      : { agent_settings: agentSettings }),\n    workspace: conversationSettings.workspace,\n    client_tools:\n      launchAgentKind === \"openhands\" ? [CANVAS_UI_CLIENT_TOOL] : [],\n    confirmation_policy:\n      getConversationConfirmationPolicy(conversationSettings),\n    max_iterations:\n      typeof conversationSettings.max_iterations === \"number\"\n        ? conversationSettings.max_iterations\n        : 500,\n    stuck_detection: true,\n    autotitle: true,\n    ...(options.titleLlmProfile\n      ? { title_llm_profile: options.titleLlmProfile }\n      : {}),\n    worktree: options.worktree ?? true,\n  };\n\n  // A profile launch resolves the ACP server server-side, so don't stamp the\n  // tag from current settings (it may not match the launched profile).\n  if (!options.agentProfileId && acpServerTag) {\n    payload.tags = { [ACP_SERVER_TAG_KEY]: acpServerTag };\n  }\n\n  // ``secrets_encrypted`` makes the agent-server decrypt request secrets at\n  // conversation start. Non-ACP conversations need it for encrypted LLM keys.\n  // ACP normally carries provider credentials as LookupSecrets, so avoid\n  // forcing a cipher on fresh ACP-only backends. The exception is MCP:\n  // encrypted settings round-trip mcp_config secrets as Fernet tokens,\n  // and ACP forwards mcp_config directly to the subprocess.\n  if (\n    !options.agentProfileId &&\n    options.secretsEncrypted &&\n    (!acpMode || hasEncryptedMcpSecrets(agentSettings.mcp_config))\n  ) {\n    payload.secrets_encrypted = true;\n  }\n\n  if (options.conversationId) {\n    payload.conversation_id = options.conversationId;\n  }\n\n  const securityAnalyzer =\n    getConversationSecurityAnalyzer(conversationSettings);\n  if (securityAnalyzer) {\n    payload.security_analyzer = securityAnalyzer;\n  }\n\n  if (conversationSettings.initial_message) {\n    payload.initial_message = conversationSettings.initial_message;\n  }\n\n  if (conversationSettings.plugins) {\n    payload.plugins = conversationSettings.plugins;\n  }\n\n  if (conversationSettings.hook_config) {\n    payload.hook_config = conversationSettings.hook_config;\n  }\n\n  const toolModuleQualnames = {\n    ...((conversationSettings.tool_module_qualnames as\n      | Record<string, string>\n      | undefined) ?? {}),\n  };\n  delete toolModuleQualnames[LEGACY_CANVAS_UI_TOOL_NAME];\n  delete toolModuleQualnames[CANVAS_UI_CLIENT_TOOL_NAME];\n  if (Object.keys(toolModuleQualnames).length > 0) {\n    payload.tool_module_qualnames = toolModuleQualnames;\n  }\n\n  if (conversationSettings.agent_definitions) {\n    payload.agent_definitions = conversationSettings.agent_definitions;\n  }\n\n  // Every saved secret rides as a LookupSecret the agent-server resolves back\n  // from its own store at spawn time — ``request.secrets`` is the sole channel,\n  // uniform for ACP and non-ACP (agent-canvas#1039). For ACP the resolution\n  // runs off the event loop (software-agent-sdk#3510, >=1.25.0), so the loopback\n  // fetch can't deadlock.\n  if (options.customSecrets && options.customSecrets.length > 0) {\n    const backend = getEffectiveLocalBackend();\n    const headers = backend ? buildAuthHeaders(backend) : {};\n\n    const secrets: Record<string, LookupSecret> = {};\n    for (const secret of options.customSecrets) {\n      const lookupSecret: LookupSecret = {\n        kind: \"LookupSecret\",\n        url: `/api/settings/secrets/${encodeURIComponent(secret.name)}`,\n        description: secret.description,\n      };\n\n      if (Object.keys(headers).length > 0) {\n        lookupSecret.headers = headers;\n      }\n\n      secrets[secret.name] = lookupSecret;\n    }\n\n    payload.secrets = secrets;\n  }\n\n  return payload;\n}\n\nexport const SUBSCRIPTION_LOGIN_REQUIRED_ERROR =\n  \"Connect your ChatGPT subscription before starting a conversation with this LLM profile.\";\n\n/**\n * Throws if a ChatGPT subscription LLM profile is not connected.\n * Called before conversation creation and LLM profile switch only — not on\n * subsequent message sends or conversation resume. The agent-server must handle\n * mid-conversation token expiry gracefully.\n */\nexport async function assertSubscriptionAuthReady(\n  agentSettings: Record<string, unknown>,\n): Promise<void> {\n  const llm = toRecord(agentSettings.llm);\n  if (!isSubscriptionLlmConfig(llm)) return;\n\n  const status = await LLMSubscriptionService.getOpenAIStatus();\n  if (!status.connected) {\n    throw new Error(SUBSCRIPTION_LOGIN_REQUIRED_ERROR);\n  }\n}\n\nexport async function buildStartConversationRequestWithEncryptedSettings(options: {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  conversationId?: string;\n  workingDir?: string;\n  worktree?: boolean;\n  agentProfileId?: string;\n  agentProfileKind?: AgentKind;\n  titleLlmProfile?: string;\n}): Promise<Record<string, unknown>> {\n  const { SecretsService } = await import(\"./secrets-service\");\n\n  const [settingsResult, customSecrets] = await Promise.all([\n    SettingsService.getSettingsForConversation(),\n    SecretsService.getSecrets(),\n  ]);\n\n  const { agentSettings, conversationSettings, secretsEncrypted } =\n    settingsResult;\n\n  // A profile launch resolves the LLM server-side, so the current-settings\n  // subscription check doesn't apply (and can't see the profile's LLM).\n  if (!options.agentProfileId) {\n    await assertSubscriptionAuthReady(agentSettings);\n  }\n\n  return buildStartConversationRequest({\n    ...options,\n    encryptedAgentSettings: agentSettings,\n    encryptedConversationSettings: conversationSettings,\n    secretsEncrypted,\n    customSecrets,\n  });\n}\n\nexport function emptyHooksResponse(): GetHooksResponse {\n  return { hooks: [] };\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-server-adapter.js","names":[],"sources":["../../src/api/agent-server-adapter.ts"],"sourcesContent":["import { ACP_SETTINGS_KEYS } from \"@openhands/typescript-client\";\nimport { ServerClient } from \"@openhands/typescript-client/clients\";\nimport { SKILLS_CATALOG } from \"@openhands/extensions/skills\";\nimport { DEFAULT_SETTINGS } from \"#/services/settings\";\nimport { ExecutionStatus } from \"#/types/agent-server/core\";\nimport { AgentKind, Settings, SettingsValue } from \"#/types/settings\";\nimport {\n  getAcpPreferredDefaultModel,\n  getAcpProvider,\n  resolveEffectiveAcpModel,\n} from \"#/constants/acp-providers\";\nimport { getAgentServerClientOptions } from \"./agent-server-client-options\";\nimport {\n  getCachedAgentServerInfo,\n  isAgentServerToolAvailable,\n} from \"./agent-server-compatibility\";\nimport { getAgentServerWorkingDir } from \"./agent-server-config\";\nimport { getEffectiveLocalBackend } from \"./backend-registry/active-store\";\nimport { buildAuthHeaders } from \"./backend-registry/auth\";\nimport {\n  GetHooksResponse,\n  PluginSpec,\n  AppConversation,\n  AppConversationPage,\n  SandboxStatus,\n} from \"./conversation-service/agent-server-conversation-service.types\";\nimport SettingsService from \"./settings-service/settings-service.api\";\nimport { getStoredConversationMetadata } from \"./conversation-metadata-store\";\nimport LLMSubscriptionService from \"./llm-subscription-service\";\nimport {\n  LLM_AUTH_TYPE_SUBSCRIPTION,\n  OPENAI_SUBSCRIPTION_VENDOR,\n  isSubscriptionLlmConfig,\n} from \"#/constants/llm-subscription\";\nimport {\n  CANVAS_UI_CLIENT_TOOL,\n  CANVAS_UI_CLIENT_TOOL_NAME,\n  LEGACY_CANVAS_UI_TOOL_NAME,\n  type ClientToolSpec,\n} from \"./canvas-ui-client-tool\";\n\nexport interface DirectConversationInfo {\n  id: string;\n  title?: string | null;\n  created_at: string;\n  updated_at: string;\n  execution_status?: string | null;\n  /** Cloud-only sandbox lifecycle state. Omitted / null for local agent-server conversations. */\n  sandbox_status?: string | null;\n  metrics?: {\n    accumulated_cost?: number | null;\n    max_budget_per_task?: number | null;\n    accumulated_token_usage?: {\n      prompt_tokens?: number;\n      completion_tokens?: number;\n      cache_read_tokens?: number;\n      cache_write_tokens?: number;\n      context_window?: number;\n      per_turn_token?: number;\n    } | null;\n  } | null;\n  agent?: {\n    /**\n     * Pydantic discriminator from the SDK union: ``\"ACPAgent\"`` for ACP CLI\n     * subprocesses (model lives on the subprocess via ``acp_model``),\n     * ``\"Agent\"`` for direct litellm. Read by {@link toAppConversation}.\n     */\n    kind?: string | null;\n    acp_model?: string | null;\n    /**\n     * ACP CLI identity (``claude-code`` / ``codex`` / ``gemini-cli``) from the\n     * SDK's ``ACPAgent.acp_server`` (#3692). Preferred fallback when the\n     * ``acpserver`` tag is absent — e.g. a profile launch doesn't stamp the tag\n     * client-side and the server may not repopulate it. Read by {@link toAppConversation}.\n     */\n    acp_server?: string | null;\n    llm?: {\n      model?: string | null;\n    } | null;\n  } | null;\n  current_model_id?: string | null;\n  current_model_name?: string | null;\n  workspace?: {\n    working_dir?: string | null;\n  } | null;\n  /**\n   * Arbitrary string-keyed conversation tags surfaced by the agent-server\n   * (see ``ConversationInfo.tags``). Canvas only consumes one key today —\n   * ``ACP_SERVER_TAG_KEY`` (\"acpserver\") — but the field is typed as a\n   * generic record so future readers don't need another wire-shape change.\n   * Keys are constrained to ``^[a-z0-9]+$`` by the agent-server validator;\n   * values are opaque strings.\n   */\n  tags?: Record<string, string> | null;\n  launched_agent_profile?: {\n    agent_profile_id: string;\n    revision: number;\n  } | null;\n}\n\nconst DEFAULT_TOOL_NAMES = [\"terminal\", \"file_editor\", \"task_tracker\"];\nconst BROWSER_TOOL_SET_NAME = \"browser_tool_set\";\nconst TASK_TOOL_SET_NAME = \"task_tool_set\";\n\nfunction browserToolsEnabled() {\n  return import.meta.env.VITE_ENABLE_BROWSER_TOOLS !== \"false\";\n}\n\n/**\n * Shape of the runtime services info served by Agent Canvas backends in\n * `/server_info.runtime_services`. All URLs are written from the agent's point of\n * view, not the browser's. The block is rendered into the agent's system prompt\n * via `AgentContext.system_message_suffix` so the agent knows what's reachable\n * from inside its sandbox without having to probe.\n */\nexport interface RuntimeServicesInfo {\n  mode?: string;\n  agent_host_alias?: string;\n  services?: {\n    agent_server?: { description?: string; url_from_agent?: string };\n    ingress?: { description?: string; url_from_agent?: string };\n    frontend?: {\n      kind?: \"vite\" | \"static\";\n      description?: string;\n      url_from_agent?: string;\n    };\n    // `vite` is the legacy key name for the frontend entry, accepted for\n    // one release while older dev-stack launchers may still emit it.\n    vite?: { description?: string; url_from_agent?: string };\n    automation?: {\n      description?: string;\n      url_from_agent?: string;\n      api_prefix?: string;\n      docs_url?: string;\n      openapi_url?: string;\n      auth_env_var?: string;\n    };\n  };\n}\n\nexport function parseRuntimeServicesInfo(\n  value: unknown,\n): RuntimeServicesInfo | null {\n  if (typeof value === \"string\") {\n    const raw = value.trim();\n    if (!raw) return null;\n    try {\n      return parseRuntimeServicesInfo(JSON.parse(raw));\n    } catch {\n      return null;\n    }\n  }\n\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return null;\n  }\n\n  const parsed = value as RuntimeServicesInfo;\n  if (!parsed.services || typeof parsed.services !== \"object\") return null;\n  return parsed;\n}\n\nexport async function fetchBackendRuntimeServicesInfo(): Promise<RuntimeServicesInfo | null> {\n  let clientOptions: ReturnType<typeof getAgentServerClientOptions>;\n  try {\n    clientOptions = getAgentServerClientOptions({ timeout: 3000 });\n  } catch {\n    return null;\n  }\n\n  const cached = parseRuntimeServicesInfo(\n    getCachedAgentServerInfo({ host: clientOptions.host })?.runtime_services,\n  );\n  if (cached) return cached;\n\n  try {\n    const serverInfo = await new ServerClient(clientOptions).getServerInfo();\n    return parseRuntimeServicesInfo(\n      (serverInfo as { runtime_services?: unknown }).runtime_services,\n    );\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Return the deployment mode from the runtime services info, e.g. \"docker\",\n * \"dev:automation\", etc. Returns `null` when no runtime info is supplied.\n */\nexport function getDeploymentMode(\n  runtimeServicesInfo?: RuntimeServicesInfo | null,\n): string | null {\n  return runtimeServicesInfo?.mode ?? null;\n}\n\n/**\n * Render the runtime services info into a markdown block suitable for\n * appending to the system prompt via `AgentContext.system_message_suffix`.\n *\n * Returns `undefined` when no runtime info is available, so callers can safely\n * omit the field when the selected backend does not advertise runtime services.\n */\nexport function buildRuntimeServicesSystemSuffix(\n  runtimeServicesInfo?: RuntimeServicesInfo | null,\n): string | undefined {\n  const info = parseRuntimeServicesInfo(runtimeServicesInfo);\n  if (!info?.services) return undefined;\n\n  const lines: string[] = [];\n  lines.push(\"<RUNTIME_SERVICES>\");\n  if (info.mode) {\n    lines.push(\n      `You are running inside an agent-canvas dev stack started in '${info.mode}' mode.`,\n    );\n  } else {\n    lines.push(\"You are running inside an agent-canvas dev stack.\");\n  }\n  lines.push(\n    \"The following services are reachable from your sandbox. URLs are written\",\n    \"from your point of view (i.e., as you should curl/fetch them).\",\n    \"\",\n  );\n\n  const { agent_server, ingress, automation } = info.services;\n  const { frontend } = info.services;\n\n  if (agent_server?.url_from_agent) {\n    lines.push(\n      `* Agent Server (you): ${agent_server.url_from_agent}`,\n      `    ${agent_server.description ?? \"The agent-server hosting your tool calls.\"}`,\n    );\n  }\n  if (ingress?.url_from_agent) {\n    lines.push(\n      `* Ingress: ${ingress.url_from_agent}`,\n      `    ${ingress.description ?? \"Unified entry point for browser-facing traffic.\"}`,\n    );\n  }\n  if (frontend?.url_from_agent) {\n    lines.push(\n      `* Frontend: ${frontend.url_from_agent}`,\n      `    ${frontend.description ?? \"Frontend dev server.\"}`,\n    );\n  }\n  if (automation?.url_from_agent) {\n    lines.push(\n      `* Automation backend: ${automation.url_from_agent}`,\n      `    ${automation.description ?? \"OpenHands Automations service.\"}`,\n    );\n    if (automation.docs_url) {\n      lines.push(`    Docs:    ${automation.docs_url}`);\n    }\n    if (automation.openapi_url) {\n      lines.push(`    OpenAPI: ${automation.openapi_url}`);\n    }\n    if (automation.auth_env_var) {\n      // X-Session-API-Key is the local convention shared by the agent-server\n      // and automation backend (see openhands-automation auth.py).\n      lines.push(\n        `    Auth:    header 'X-Session-API-Key: $${automation.auth_env_var}'`,\n      );\n    }\n  } else {\n    lines.push(\n      \"* Automation backend: not running in this dev mode (skip /api/automation calls).\",\n    );\n  }\n\n  // Anchor the \"don't guess\" warning to the actual agent-server URL for\n  // this stack instead of a hardcoded port. The agent-server listens on\n  // different ports across dev modes, and baking the wrong port into the\n  // system prompt is exactly the kind of confusion this block is meant to\n  // prevent.\n  const agentServerUrl = agent_server?.url_from_agent;\n  lines.push(\n    \"\",\n    \"Trust this block over guessing: do not assume any other URLs are running.\",\n  );\n  if (agentServerUrl) {\n    lines.push(\n      `In particular, ${agentServerUrl} inside your sandbox is the Agent Server`,\n      \"you are running inside of — NOT the automation backend.\",\n    );\n  }\n  lines.push(\"</RUNTIME_SERVICES>\");\n\n  return lines.join(\"\\n\");\n}\n\nexport function toConversationUrl(conversationId: string): string {\n  // Local-format conversation URL — points at whichever local agent-server\n  // is actually serving the conversation (the bundled one when the active\n  // selection is cloud).\n  const { host } = getAgentServerClientOptions();\n  return `${host}/api/conversations/${conversationId}`;\n}\n\n// TODO(i18n): extract \"Conversation\" once we add CONVERSATION$DEFAULT_TITLE\n// with `{{shortId}}` interpolation. Kept as a literal for now to keep the\n// fallback inside this pure adapter rather than fanning out to display sites.\nexport function getDefaultConversationTitle(conversationId: string): string {\n  return `Conversation ${conversationId.slice(0, 5)}`;\n}\n\nexport function toAppConversation(\n  info: DirectConversationInfo,\n): AppConversation {\n  const metadata = getStoredConversationMetadata(info.id);\n  // ACPAgent conversations carry a sentinel ``llm`` on older SDKs. Prefer the\n  // runtime model fields when available, then the configured ``acp_model`` that\n  // Canvas saves for built-in providers. ``agent_kind`` still gates model\n  // switching, so surfacing this string is display-only.\n  const isAcp = info.agent?.kind === \"ACPAgent\";\n  // Only surface ``acp_server`` for ACP conversations even if the wire\n  // payload accidentally carries an ``acpserver`` tag on an OpenHands\n  // conversation — the chip is identity info for the ACP CLI subprocess,\n  // and showing it on a non-ACP conversation would be a lie. Fall back to the\n  // agent's own ``acp_server`` (#3692) when the tag is missing — a profile\n  // launch doesn't stamp the tag, so tag-only reads would drop the ACP model\n  // picker and degrade the chip to a generic \"ACP\" (#1571).\n  const acpServer = isAcp\n    ? (info.tags?.[ACP_SERVER_TAG_KEY] ?? info.agent?.acp_server ?? null)\n    : null;\n  return {\n    id: info.id,\n    created_by_user_id: null,\n    selected_repository: metadata?.selected_repository ?? null,\n    selected_branch: metadata?.selected_branch ?? null,\n    git_provider: metadata?.git_provider ?? null,\n    selected_workspace: metadata?.selected_workspace ?? null,\n    active_profile: metadata?.active_profile ?? null,\n    title: info.title?.trim()\n      ? info.title\n      : getDefaultConversationTitle(info.id),\n    trigger: null,\n    pr_number: [],\n    agent_kind: isAcp ? \"acp\" : \"openhands\",\n    acp_server: acpServer,\n    tags: info.tags ?? null,\n    launched_agent_profile: info.launched_agent_profile ?? null,\n    // Chip path: omit ``providerDefault`` so that when no concrete model\n    // resolves, the chip falls back to the provider display name in\n    // ConversationCardFooter rather than a registry default the session may\n    // not actually be running.\n    llm_model: isAcp\n      ? resolveEffectiveAcpModel({\n          runtimeName: info.current_model_name,\n          runtimeId: info.current_model_id,\n          configured: info.agent?.acp_model,\n          sdkLlm: info.agent?.llm?.model,\n        })\n      : (info.agent?.llm?.model ?? DEFAULT_SETTINGS.llm_model),\n    metrics: info.metrics\n      ? {\n          accumulated_cost: info.metrics.accumulated_cost ?? null,\n          max_budget_per_task: info.metrics.max_budget_per_task ?? null,\n          accumulated_token_usage: info.metrics.accumulated_token_usage\n            ? {\n                prompt_tokens:\n                  info.metrics.accumulated_token_usage.prompt_tokens ?? 0,\n                completion_tokens:\n                  info.metrics.accumulated_token_usage.completion_tokens ?? 0,\n                cache_read_tokens:\n                  info.metrics.accumulated_token_usage.cache_read_tokens ?? 0,\n                cache_write_tokens:\n                  info.metrics.accumulated_token_usage.cache_write_tokens ?? 0,\n                context_window:\n                  info.metrics.accumulated_token_usage.context_window ?? 0,\n                per_turn_token:\n                  info.metrics.accumulated_token_usage.per_turn_token ?? 0,\n              }\n            : null,\n        }\n      : null,\n    created_at: info.created_at,\n    updated_at: info.updated_at,\n    execution_status:\n      (info.execution_status as AppConversation[\"execution_status\"]) ??\n      ExecutionStatus.IDLE,\n    sandbox_status: (info.sandbox_status as SandboxStatus | null) ?? null,\n    conversation_url: toConversationUrl(info.id),\n    session_api_key: getAgentServerClientOptions().apiKey ?? null,\n    sandbox_id: null,\n    workspace: {\n      working_dir: info.workspace?.working_dir ?? getAgentServerWorkingDir(),\n    },\n    public: false,\n    sub_conversation_ids: [],\n  };\n}\n\nexport function toConversationPage(data: {\n  items: DirectConversationInfo[];\n  next_page_id?: string | null;\n}): AppConversationPage {\n  return {\n    items: data.items.map(toAppConversation),\n    next_page_id: data.next_page_id ?? null,\n  };\n}\n\ntype SettingsRecord = Record<string, unknown>;\n\ninterface AgentToolSpec {\n  name: string;\n  params: SettingsRecord;\n}\n\ntype AgentSettingsPayload = SettingsRecord & {\n  llm?: SettingsRecord;\n  agent_context: SettingsRecord;\n  tools?: AgentToolSpec[];\n};\n\ninterface LocalWorkspacePayload {\n  kind: \"LocalWorkspace\";\n  working_dir: string;\n}\n\ninterface InitialMessagePayload {\n  role: \"user\";\n  content: Array<{ type: \"text\"; text: string }>;\n  run: true;\n}\n\ntype ConversationSettingsPayload = SettingsRecord & {\n  workspace: LocalWorkspacePayload;\n  initial_message?: InitialMessagePayload;\n};\n\nexport const ACP_SERVER_TAG_KEY = \"acpserver\";\n\n/**\n * Conversation tag keys Canvas itself stamps/consumes for internal routing.\n * They are already surfaced through dedicated UI (the ACP provider chip), so\n * the generic tag-chip display filters them out.\n */\nexport const RESERVED_CONVERSATION_TAG_KEYS: ReadonlySet<string> = new Set([\n  ACP_SERVER_TAG_KEY,\n]);\n\n/**\n * User-facing subset of a conversation's server-side tags: everything except\n * {@link RESERVED_CONVERSATION_TAG_KEYS}, as stable ``[key, value]`` entries\n * sorted by key so chip order doesn't shuffle between refetches.\n */\nexport function getDisplayConversationTags(\n  tags: Record<string, string> | null | undefined,\n): Array<[string, string]> {\n  if (!tags) {\n    return [];\n  }\n  return Object.entries(tags)\n    .filter(([key]) => !RESERVED_CONVERSATION_TAG_KEYS.has(key))\n    .sort(([a], [b]) => a.localeCompare(b));\n}\n\nconst FERNET_TOKEN_PREFIX = \"gAAAAA\";\n\nconst CONVERSATION_SETTINGS_METADATA_KEYS = new Set([\n  \"schema_version\",\n  \"agent_settings\",\n  \"workspace\",\n  \"conversation_id\",\n  \"initial_message\",\n  \"plugins\",\n]);\n\nfunction toRecord(value: unknown): SettingsRecord {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return {};\n  }\n\n  return structuredClone(value as SettingsRecord);\n}\n\nfunction normalizeSecretString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nfunction isPlainRecord(value: unknown): value is Record<string, unknown> {\n  return !!value && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction hasEncryptedString(value: unknown): boolean {\n  if (typeof value === \"string\") {\n    return value.startsWith(FERNET_TOKEN_PREFIX);\n  }\n  if (Array.isArray(value)) {\n    return value.some(hasEncryptedString);\n  }\n  if (isPlainRecord(value)) {\n    return Object.values(value).some(hasEncryptedString);\n  }\n  return false;\n}\n\nfunction hasEncryptedMcpSecrets(mcpConfig: unknown): boolean {\n  if (!isPlainRecord(mcpConfig)) {\n    return false;\n  }\n\n  return Object.values(mcpConfig).some(hasEncryptedString);\n}\n\nfunction getConversationConfirmationPolicy(\n  conversationSettings: SettingsRecord,\n) {\n  if (conversationSettings.confirmation_mode !== true) {\n    return { kind: \"NeverConfirm\" };\n  }\n\n  if (conversationSettings.security_analyzer === \"llm\") {\n    return { kind: \"ConfirmRisky\", threshold: \"HIGH\", confirm_unknown: true };\n  }\n\n  return { kind: \"AlwaysConfirm\" };\n}\n\nfunction getConversationSecurityAnalyzer(conversationSettings: SettingsRecord) {\n  switch (conversationSettings.security_analyzer) {\n    case \"llm\":\n      return { kind: \"LLMSecurityAnalyzer\" };\n    case \"pattern\":\n      return { kind: \"PatternSecurityAnalyzer\" };\n    case \"policy_rail\":\n      return { kind: \"PolicyRailSecurityAnalyzer\" };\n    default:\n      return undefined;\n  }\n}\n\nfunction isToolRecord(\n  value: unknown,\n): value is { name: string; params?: unknown } {\n  return (\n    !!value &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    typeof (value as { name?: unknown }).name === \"string\"\n  );\n}\n\nfunction shouldIncludeTool(name: string, agentSettings: SettingsRecord) {\n  if (name === BROWSER_TOOL_SET_NAME) {\n    return browserToolsEnabled() && isAgentServerToolAvailable(name);\n  }\n\n  if (name === TASK_TOOL_SET_NAME) {\n    return (\n      agentSettings.enable_sub_agents === true &&\n      isAgentServerToolAvailable(name)\n    );\n  }\n\n  return true;\n}\n\nfunction getAgentTools(agentSettings: SettingsRecord): AgentToolSpec[] {\n  const tools = new Map<string, AgentToolSpec>();\n\n  for (const name of DEFAULT_TOOL_NAMES) {\n    if (shouldIncludeTool(name, agentSettings)) {\n      tools.set(name, { name, params: {} });\n    }\n  }\n\n  for (const name of [BROWSER_TOOL_SET_NAME, TASK_TOOL_SET_NAME]) {\n    if (shouldIncludeTool(name, agentSettings)) {\n      tools.set(name, { name, params: {} });\n    }\n  }\n\n  const configuredTools = agentSettings.tools;\n  if (\n    Array.isArray(configuredTools) &&\n    configuredTools.every((tool) => isToolRecord(tool))\n  ) {\n    for (const tool of configuredTools) {\n      if (shouldIncludeTool(tool.name, agentSettings)) {\n        tools.set(tool.name, {\n          name: tool.name,\n          params: toRecord(tool.params),\n        });\n      }\n    }\n  }\n\n  return Array.from(tools.values());\n}\n\nfunction buildInitialMessage(\n  query?: string,\n  conversationInstructions?: string,\n): InitialMessagePayload | null {\n  const parts = [query?.trim(), conversationInstructions?.trim()].filter(\n    Boolean,\n  );\n  if (parts.length === 0) {\n    return null;\n  }\n\n  return {\n    role: \"user\",\n    content: [{ type: \"text\", text: parts.join(\"\\n\\n\") }],\n    run: true,\n  };\n}\n\n/**\n * Shape of a bundled skill entry passed to the agent-server SDK via\n * `agent_context.skills`. Mirrors the SDK's `Skill` model fields that\n * the server uses for trigger matching, activation, and system-prompt\n * injection.\n */\ninterface BundledSkill {\n  name: string;\n  content: string;\n  trigger: { type: \"keyword\"; keywords: string[] } | null;\n  source: string;\n  description: string | null;\n  is_agentskills_format: true;\n  license?: string;\n  compatibility?: string;\n}\n\n/**\n * Convert the bundled `SKILLS_CATALOG` entries into the SDK `Skill` JSON\n * shape so the agent-server can perform trigger matching, skill activation,\n * and system-prompt injection without cloning the extensions repo.\n *\n * The SDK discriminates triggers via `{ type: \"keyword\", keywords: [...] }`.\n * Skills with no triggers get `trigger: null` (always-active / on-demand).\n */\nfunction buildBundledSkills(): BundledSkill[] {\n  return SKILLS_CATALOG.map((entry) => {\n    const trigger: BundledSkill[\"trigger\"] =\n      entry.triggers?.length > 0\n        ? { type: \"keyword\", keywords: entry.triggers }\n        : null;\n\n    // Use the absolute path to the skill's SKILL.md so the Python\n    // agent-server can resolve bundled resources (scripts/, references/).\n    // Falls back to \"public\" in library builds where the path isn't known.\n    const source = __EXTENSIONS_SKILLS_DIR__\n      ? `${__EXTENSIONS_SKILLS_DIR__}/${entry.name}/SKILL.md`\n      : \"public\";\n\n    return {\n      name: entry.name,\n      content: entry.content,\n      trigger,\n      source,\n      description: entry.description ?? null,\n      is_agentskills_format: true as const,\n      ...(entry.license ? { license: entry.license } : {}),\n      ...(entry.compatibility ? { compatibility: entry.compatibility } : {}),\n    };\n  });\n}\n\nfunction buildAgentContext(\n  agentSettings: SettingsRecord,\n  runtimeServicesInfo?: RuntimeServicesInfo | null,\n  disabledSkills: string[] = [],\n): SettingsRecord {\n  const runtimeServicesSuffix =\n    buildRuntimeServicesSystemSuffix(runtimeServicesInfo);\n  const existingContext = toRecord(agentSettings.agent_context);\n\n  // Merge bundled public skills with any skills already present in the\n  // agent context (e.g. user-defined skills set via the settings API).\n  const existingSkills = Array.isArray(existingContext.skills)\n    ? (existingContext.skills as SettingsRecord[])\n    : [];\n  const disabledSkillNames = new Set(disabledSkills);\n  const mergedSkills = [...existingSkills, ...buildBundledSkills()].filter(\n    (skill) =>\n      typeof skill.name !== \"string\" || !disabledSkillNames.has(skill.name),\n  );\n\n  return {\n    ...existingContext,\n    // Public skills are bundled at build time from the @openhands/extensions\n    // npm package and passed directly in agent_context.skills. Setting\n    // load_public_skills to false tells the agent-server SDK to skip its own\n    // extensions-repo clone — the frontend is the sole source of public\n    // skills now.\n    //\n    // Migration: the former VITE_LOAD_PUBLIC_SKILLS env var was removed\n    // because bundled skills have no clone latency. Users who previously set\n    // VITE_LOAD_PUBLIC_SKILLS=false to avoid clone delays no longer need it.\n    skills: mergedSkills,\n    load_public_skills: false,\n    load_user_skills: true,\n    load_project_skills: true,\n    ...(runtimeServicesSuffix\n      ? { system_message_suffix: runtimeServicesSuffix }\n      : {}),\n  };\n}\n\nfunction isAcpAgent(settings: Settings): boolean {\n  const agentSettings = toRecord(settings.agent_settings);\n  return agentSettings.agent_kind === \"acp\";\n}\n\nfunction getAcpServerTag(settings: Settings): string | undefined {\n  const agentSettings = toRecord(settings.agent_settings);\n  const value = agentSettings.acp_server;\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction resolveAcpCommand(agentSettings: SettingsRecord): unknown {\n  const cmd = agentSettings.acp_command;\n  const isEmpty = Array.isArray(cmd) && cmd.length === 0;\n  const noCommand = cmd === undefined;\n  if (!isEmpty && !noCommand) {\n    return cmd;\n  }\n\n  const serverKey =\n    typeof agentSettings.acp_server === \"string\"\n      ? agentSettings.acp_server\n      : undefined;\n  const provider = getAcpProvider(serverKey);\n  return provider ? [...provider.default_command] : cmd;\n}\n\nfunction buildConfiguredAcpAgentSettings(\n  settings: Settings,\n  runtimeServicesInfo?: RuntimeServicesInfo | null,\n): AgentSettingsPayload {\n  const agentSettings = toRecord(settings.agent_settings);\n  const payload: AgentSettingsPayload = {\n    agent_kind: \"acp\",\n    agent_context: buildAgentContext(\n      agentSettings,\n      runtimeServicesInfo,\n      settings.disabled_skills,\n    ),\n  };\n\n  // TODO(#1019): set ``acp_isolate_data_dir: true`` here for a containerized\n  // backend so concurrent same-provider conversations don't race on a shared\n  // HOME. The SDK supports it (software-agent-sdk#3492), but the released\n  // ``@openhands/typescript-client`` (1.24.3) doesn't surface it on\n  // ``ACPAgentSettings`` yet, so sending it risks a validation error on older\n  // servers. Cloud grouping isolation is separate (agent-canvas#1016).\n\n  for (const key of ACP_SETTINGS_KEYS) {\n    // ``acp_model`` is resolved separately below so a saved ``null`` still\n    // falls back to the provider's default rather than being dropped.\n    if (key === \"acp_model\") continue;\n    // ``acp_env`` is deprecated — provider creds now route via ``request.secrets``.\n    if (key === \"acp_env\") continue;\n    const value =\n      key === \"acp_command\"\n        ? resolveAcpCommand(agentSettings)\n        : agentSettings[key];\n    if (value !== undefined && value !== null) {\n      payload[key] = value;\n    }\n  }\n\n  // ``mcp_config`` is a shared field (not in ACP_SETTINGS_KEYS): forward it\n  // so the ACP subprocess connects to the configured MCP servers at session\n  // creation. Only include it when it actually carries servers — an empty or\n  // malformed value is dropped rather than sending ``mcp_config: {}``.\n  const mcpConfig = toRecord(agentSettings.mcp_config);\n  if (Object.keys(mcpConfig).length > 0) {\n    payload.mcp_config = mcpConfig;\n  }\n\n  // Saved settings may carry ``acp_model: null`` (existing users predating\n  // the default-model registry, or saved fields the agent-server stripped).\n  // Fall back to the *preferred* default (Vertex-safe for Gemini) so the\n  // conversation starts with whatever the Settings → Agent UI shows — without\n  // that, the form's displayed default would silently not take effect at\n  // runtime until the user re-saved the page.\n  const serverKey =\n    typeof agentSettings.acp_server === \"string\"\n      ? agentSettings.acp_server\n      : undefined;\n  const effectiveModel = resolveEffectiveAcpModel({\n    configured: agentSettings.acp_model as string | null | undefined,\n    providerDefault: getAcpPreferredDefaultModel(serverKey),\n  });\n  if (effectiveModel) {\n    payload.acp_model = effectiveModel;\n  }\n\n  return payload;\n}\n\nfunction buildConfiguredOpenHandsAgentSettings(\n  settings: Settings,\n  runtimeServicesInfo?: RuntimeServicesInfo | null,\n): AgentSettingsPayload {\n  const agentSettings = toRecord(settings.agent_settings);\n  const llm = toRecord(agentSettings.llm);\n\n  llm.model =\n    typeof llm.model === \"string\" && llm.model.trim().length > 0\n      ? llm.model\n      : DEFAULT_SETTINGS.llm_model;\n\n  // Stream assistant tokens (parity with ACP agents). The agent-server only\n  // emits StreamingDeltaEvents for SDK LLM agents when an LLM has stream=True.\n  llm.stream = true;\n\n  const apiKey = normalizeSecretString(llm.api_key);\n  if (apiKey) {\n    llm.api_key = apiKey;\n  } else {\n    delete llm.api_key;\n  }\n\n  const baseUrl = normalizeSecretString(llm.base_url);\n  if (baseUrl) {\n    llm.base_url = baseUrl;\n  } else {\n    delete llm.base_url;\n  }\n\n  if (isSubscriptionLlmConfig(llm)) {\n    llm.auth_type = LLM_AUTH_TYPE_SUBSCRIPTION;\n    llm.subscription_vendor = OPENAI_SUBSCRIPTION_VENDOR;\n    delete llm.api_key;\n    delete llm.base_url;\n  } else {\n    delete llm.auth_type;\n    delete llm.subscription_vendor;\n  }\n\n  const mcpConfig = toRecord(agentSettings.mcp_config);\n  if (Object.keys(mcpConfig).length === 0) {\n    delete agentSettings.mcp_config;\n  }\n\n  delete agentSettings.acp_server;\n  for (const key of ACP_SETTINGS_KEYS) {\n    delete agentSettings[key];\n  }\n  // ``acp_env`` is no longer a forwarded ACP setting (provider creds ride the\n  // Secrets panel), but a legacy value may linger on persisted settings —\n  // scrub it so it never leaks onto the OpenHands payload.\n  delete agentSettings.acp_env;\n\n  return {\n    ...agentSettings,\n    llm,\n    agent_context: buildAgentContext(\n      agentSettings,\n      runtimeServicesInfo,\n      settings.disabled_skills,\n    ),\n    tools: getAgentTools(agentSettings),\n  };\n}\n\nfunction buildConfiguredAgentSettings(\n  settings: Settings,\n  runtimeServicesInfo?: RuntimeServicesInfo | null,\n): AgentSettingsPayload {\n  return isAcpAgent(settings)\n    ? buildConfiguredAcpAgentSettings(settings, runtimeServicesInfo)\n    : buildConfiguredOpenHandsAgentSettings(settings, runtimeServicesInfo);\n}\n\nfunction buildConfiguredConversationSettings(options: {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  workingDir?: string;\n}): ConversationSettingsPayload {\n  const { settings, query, conversationInstructions, plugins, workingDir } =\n    options;\n  const conversationSettings = toRecord(settings.conversation_settings);\n  const initialMessage = buildInitialMessage(query, conversationInstructions);\n\n  CONVERSATION_SETTINGS_METADATA_KEYS.forEach(\n    (key) => delete conversationSettings[key],\n  );\n\n  const payload: ConversationSettingsPayload = {\n    ...conversationSettings,\n    workspace: {\n      kind: \"LocalWorkspace\",\n      working_dir: workingDir ?? getAgentServerWorkingDir(),\n    },\n    ...(initialMessage ? { initial_message: initialMessage } : {}),\n    ...(plugins?.length\n      ? {\n          plugins: plugins.map((plugin) => ({\n            source: plugin.source,\n            ...(plugin.ref ? { ref: plugin.ref } : {}),\n            ...(plugin.repo_path ? { repo_path: plugin.repo_path } : {}),\n          })),\n        }\n      : {}),\n  };\n\n  return payload;\n}\n\ninterface LookupSecret {\n  kind: \"LookupSecret\";\n  url: string;\n  headers?: Record<string, string>;\n  description?: string;\n}\n\ntype StartConversationPayload = Record<string, unknown> & {\n  // Omitted when launching via ``agent_profile_id`` — the two are mutually\n  // exclusive agent sources; the server resolves the profile server-side.\n  agent_settings?: AgentSettingsPayload;\n  agent_profile_id?: string;\n  workspace: LocalWorkspacePayload;\n  confirmation_policy: SettingsRecord;\n  security_analyzer?: SettingsRecord;\n  initial_message?: InitialMessagePayload;\n  max_iterations: number;\n  stuck_detection: true;\n  autotitle: true;\n  title_llm_profile?: string;\n  worktree: boolean;\n  secrets_encrypted?: true;\n  conversation_id?: string;\n  secrets?: Record<string, LookupSecret>;\n  tags?: Record<string, string>;\n  client_tools: ClientToolSpec[];\n  tool_module_qualnames?: Record<string, string>;\n};\n\nexport interface StartConversationOptions {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  conversationId?: string;\n  workingDir?: string;\n  worktree?: boolean;\n  encryptedAgentSettings?: Record<string, SettingsValue>;\n  encryptedConversationSettings?: Record<string, SettingsValue>;\n  secretsEncrypted?: boolean;\n  customSecrets?: Array<{ name: string; description?: string }>;\n  // When set, the conversation launches from this AgentProfile (resolved\n  // server-side) instead of an inline ``agent_settings`` dump (#3727).\n  agentProfileId?: string;\n  agentProfileKind?: AgentKind;\n  titleLlmProfile?: string;\n  runtimeServicesInfo?: RuntimeServicesInfo | null;\n}\n\nexport function buildStartConversationRequest(\n  options: StartConversationOptions,\n): StartConversationPayload {\n  const sourceAgentSettings = options.encryptedAgentSettings\n    ? { ...options.settings, agent_settings: options.encryptedAgentSettings }\n    : options.settings;\n\n  const acpMode = isAcpAgent(sourceAgentSettings);\n  const launchAgentKind = options.agentProfileId\n    ? options.agentProfileKind\n    : acpMode\n      ? \"acp\"\n      : \"openhands\";\n  const agentSettings = buildConfiguredAgentSettings(\n    sourceAgentSettings,\n    options.runtimeServicesInfo,\n  );\n  const acpServerTag = acpMode\n    ? getAcpServerTag(sourceAgentSettings)\n    : undefined;\n\n  const sourceConversationOptions = options.encryptedConversationSettings\n    ? {\n        ...options,\n        settings: {\n          ...options.settings,\n          conversation_settings: options.encryptedConversationSettings,\n        },\n      }\n    : options;\n\n  const conversationSettings = buildConfiguredConversationSettings(\n    sourceConversationOptions,\n  );\n\n  const payload: StartConversationPayload = {\n    // ``agent_profile_id`` and ``agent_settings`` are mutually exclusive agent\n    // sources; the profile path lets the server resolve the profile (#3727).\n    //\n    // Enrichment boundary: on the profile path the server rebuilds the agent\n    // purely from the stored profile fields, so the client-owned enrichments\n    // this adapter folds into ``agent_settings`` do NOT apply. The exec toolset\n    // (terminal/file_editor/task_tracker) and public-skill loading are the\n    // server/SDK's responsibility to restore on the profile path — tracked in\n    // software-agent-sdk#3967 (profile resolution must attach the default\n    // toolset + public skills, else a profile-launched OpenHands agent has only\n    // Finish/Think). The dev ``RUNTIME_SERVICES`` system-message suffix remains\n    // agent-settings-only; the Canvas UI tool is a top-level client tool and\n    // therefore works on both inline-agent and profile launch paths.\n    //\n    // Persistent memory is NOT on that boundary: ``load_memory`` is a global\n    // user preference, so the agent-server stamps the stored\n    // ``agent_settings.agent_context.load_memory`` onto the profile-resolved\n    // agent the same way it already applies the global ``mcp_config``. The\n    // toggle therefore applies to both launch paths, and the client must not\n    // re-send it here (``agent_profile_id`` and ``agent_settings`` are\n    // mutually exclusive).\n    ...(options.agentProfileId\n      ? { agent_profile_id: options.agentProfileId }\n      : { agent_settings: agentSettings }),\n    workspace: conversationSettings.workspace,\n    client_tools:\n      launchAgentKind === \"openhands\" ? [CANVAS_UI_CLIENT_TOOL] : [],\n    confirmation_policy:\n      getConversationConfirmationPolicy(conversationSettings),\n    max_iterations:\n      typeof conversationSettings.max_iterations === \"number\"\n        ? conversationSettings.max_iterations\n        : 500,\n    stuck_detection: true,\n    autotitle: true,\n    ...(options.titleLlmProfile\n      ? { title_llm_profile: options.titleLlmProfile }\n      : {}),\n    worktree: options.worktree ?? true,\n  };\n\n  // A profile launch resolves the ACP server server-side, so don't stamp the\n  // tag from current settings (it may not match the launched profile).\n  if (!options.agentProfileId && acpServerTag) {\n    payload.tags = { [ACP_SERVER_TAG_KEY]: acpServerTag };\n  }\n\n  // ``secrets_encrypted`` makes the agent-server decrypt request secrets at\n  // conversation start. Non-ACP conversations need it for encrypted LLM keys.\n  // ACP normally carries provider credentials as LookupSecrets, so avoid\n  // forcing a cipher on fresh ACP-only backends. The exception is MCP:\n  // encrypted settings round-trip mcp_config secrets as Fernet tokens,\n  // and ACP forwards mcp_config directly to the subprocess.\n  if (\n    !options.agentProfileId &&\n    options.secretsEncrypted &&\n    (!acpMode || hasEncryptedMcpSecrets(agentSettings.mcp_config))\n  ) {\n    payload.secrets_encrypted = true;\n  }\n\n  if (options.conversationId) {\n    payload.conversation_id = options.conversationId;\n  }\n\n  const securityAnalyzer =\n    getConversationSecurityAnalyzer(conversationSettings);\n  if (securityAnalyzer) {\n    payload.security_analyzer = securityAnalyzer;\n  }\n\n  if (conversationSettings.initial_message) {\n    payload.initial_message = conversationSettings.initial_message;\n  }\n\n  if (conversationSettings.plugins) {\n    payload.plugins = conversationSettings.plugins;\n  }\n\n  if (conversationSettings.hook_config) {\n    payload.hook_config = conversationSettings.hook_config;\n  }\n\n  const toolModuleQualnames = {\n    ...((conversationSettings.tool_module_qualnames as\n      | Record<string, string>\n      | undefined) ?? {}),\n  };\n  delete toolModuleQualnames[LEGACY_CANVAS_UI_TOOL_NAME];\n  delete toolModuleQualnames[CANVAS_UI_CLIENT_TOOL_NAME];\n  if (Object.keys(toolModuleQualnames).length > 0) {\n    payload.tool_module_qualnames = toolModuleQualnames;\n  }\n\n  if (conversationSettings.agent_definitions) {\n    payload.agent_definitions = conversationSettings.agent_definitions;\n  }\n\n  // Every saved secret rides as a LookupSecret the agent-server resolves back\n  // from its own store at spawn time — ``request.secrets`` is the sole channel,\n  // uniform for ACP and non-ACP (agent-canvas#1039). For ACP the resolution\n  // runs off the event loop (software-agent-sdk#3510, >=1.25.0), so the loopback\n  // fetch can't deadlock.\n  if (options.customSecrets && options.customSecrets.length > 0) {\n    const backend = getEffectiveLocalBackend();\n    const headers = backend ? buildAuthHeaders(backend) : {};\n\n    const secrets: Record<string, LookupSecret> = {};\n    for (const secret of options.customSecrets) {\n      const lookupSecret: LookupSecret = {\n        kind: \"LookupSecret\",\n        url: `/api/settings/secrets/${encodeURIComponent(secret.name)}`,\n        description: secret.description,\n      };\n\n      if (Object.keys(headers).length > 0) {\n        lookupSecret.headers = headers;\n      }\n\n      secrets[secret.name] = lookupSecret;\n    }\n\n    payload.secrets = secrets;\n  }\n\n  return payload;\n}\n\nexport const SUBSCRIPTION_LOGIN_REQUIRED_ERROR =\n  \"Connect your ChatGPT subscription before starting a conversation with this LLM profile.\";\n\n/**\n * Throws if a ChatGPT subscription LLM profile is not connected.\n * Called before conversation creation and LLM profile switch only — not on\n * subsequent message sends or conversation resume. The agent-server must handle\n * mid-conversation token expiry gracefully.\n */\nexport async function assertSubscriptionAuthReady(\n  agentSettings: Record<string, unknown>,\n): Promise<void> {\n  const llm = toRecord(agentSettings.llm);\n  if (!isSubscriptionLlmConfig(llm)) return;\n\n  const status = await LLMSubscriptionService.getOpenAIStatus();\n  if (!status.connected) {\n    throw new Error(SUBSCRIPTION_LOGIN_REQUIRED_ERROR);\n  }\n}\n\nexport async function buildStartConversationRequestWithEncryptedSettings(options: {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  conversationId?: string;\n  workingDir?: string;\n  worktree?: boolean;\n  agentProfileId?: string;\n  agentProfileKind?: AgentKind;\n  titleLlmProfile?: string;\n}): Promise<Record<string, unknown>> {\n  const { SecretsService } = await import(\"./secrets-service\");\n\n  const [settingsResult, customSecrets, runtimeServicesInfo] =\n    await Promise.all([\n      SettingsService.getSettingsForConversation(),\n      SecretsService.getSecrets(),\n      fetchBackendRuntimeServicesInfo(),\n    ]);\n\n  const { agentSettings, conversationSettings, secretsEncrypted } =\n    settingsResult;\n\n  // A profile launch resolves the LLM server-side, so the current-settings\n  // subscription check doesn't apply (and can't see the profile's LLM).\n  if (!options.agentProfileId) {\n    await assertSubscriptionAuthReady(agentSettings);\n  }\n\n  return buildStartConversationRequest({\n    ...options,\n    encryptedAgentSettings: agentSettings,\n    encryptedConversationSettings: conversationSettings,\n    secretsEncrypted,\n    customSecrets,\n    runtimeServicesInfo,\n  });\n}\n\nexport function emptyHooksResponse(): GetHooksResponse {\n  return { hooks: [] };\n}\n"],"mappings":"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"}

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=e=>Array.isArray(e?.usable_tools)?e.usable_tools:null,p=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}},m=e=>e instanceof p||typeof e==`object`&&!!e&&`name`in e&&e.name===`AgentServerUnavailableError`,h=class extends p{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}},g=class extends p{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}},_=e=>n.isAuthRequired()&&x(e,401);function v(){d=null}function y(e){let t=f(d);return Array.isArray(t)?t.includes(e):!0}function b(e){return e instanceof Error&&e.name===`HttpError`&&`status`in e&&typeof e.status==`number`}function x(e,t){return b(e)&&e.status===t}function S(e){return typeof e==`string`&&e.trim()||null}function C(e){return S(e.sdk_version)}function w(e){return S(e.version)??C(e)}function T(e){let t=w(e);return!t||t.toLowerCase()===s?null:t}function E(e){let t=T(e);return!t||!k(t)?null:t}function D(e){return!d||e&&r.getEffectiveLocalBackend()?.host!==e?null:E(d)}function O(e,t){let n=k(e),r=k(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 k(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 A(e){let t=T(e);if(!t)throw v(),new g(w(e));let n=O(t,c);if(n===null)throw v(),new g(t);if(n<0)throw v(),new h(t)}async function j(){let a=r.getEffectiveLocalBackend();if(!a){if(v(),r.isNoBackend(r.getActiveBackend().backend))throw new p(`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 v(),x(e,401)?e:new p(e instanceof Error?e.message:null)}if(A(c),n.isAuthRequired())try{await new t.SettingsClient(s).getSettings()}catch(e){if(x(e,401))throw e;console.warn(`[agent-server] getSettings() probe failed (non-401):`,e)}return d=c,c}exports.assertAgentServerVersionIsSupported=A,exports.clearCachedAgentServerInfo=v,exports.compareAgentServerVersions=O,exports.getCachedAgentServerVersion=D,exports.getDisplayAgentServerVersion=E,exports.isAgentServerAuthError=_,exports.isAgentServerToolAvailable=y,exports.isAgentServerUnavailableError=m,exports.isSdkHttpStatusError=x,exports.loadAgentServerInfo=j;
+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;
 //# 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}\n\nlet cachedAgentServerInfo: AgentServerInfo | 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}\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  return serverInfo;\n}\n"],"mappings":"+dAcA,IAAM,EAA+B,IAC/B,EAA+B,UAExB,EACX,EAAA,QAAS,cAAc,mBACZ,EACX,mCACW,EACX,+BAOE,EAAgD,KAE9C,EAAsB,GACtB,MAAM,QAAQ,GAAY,YAAY,EACjC,EAAW,aAEb,KAGI,EAAb,cAAiD,KAAM,CACrD,QACA,oBAEA,YACE,EACA,EACA,CACA,IAAM,EAAsB,GAAS,qBAAuB,GAC5D,MACE,EACI,2EACA,gHACN,EACA,KAAK,KAAO,8BACZ,KAAK,QAAU,GAAW,KAC1B,KAAK,oBAAsB,CAC7B,CACF,EAEa,EACX,GAEA,aAAiB,GAChB,OAAO,GAAU,YAChB,GACA,SAAU,GACV,EAAM,OAAS,8BAEN,EAAb,cAAwD,CAA4B,CAClF,KAAgB,EAChB,cACA,gBAA2B,EAE3B,YAAY,EAAuB,CACjC,IAAM,EAAU,sCAAsC,EAAwC,qCAAqC,EAAc,4CACjJ,MAAM,CAAO,EACb,KAAK,KAAO,qCACZ,KAAK,QAAU,EACf,KAAK,cAAgB,CACvB,CACF,EAEa,EAAb,cAAoD,CAA4B,CAC9E,KAAgB,EAChB,cACA,gBAA2B,EAE3B,YAAY,EAA8B,CAExC,IAAM,EACJ,2DAFe,EAAgB,iBAAiB,EAAc,IAAM,GAEA,sCAC9B,EAAwC,4IAGhF,MAAM,CAAO,EACb,KAAK,KAAO,iCACZ,KAAK,QAAU,EACf,KAAK,cAAgB,CACvB,CACF,EA6Ba,EAA0B,GACrC,EAAA,eAAe,GAAK,EAAqB,EAAO,GAAG,EAErD,SAAgB,GAA6B,CAC3C,EAAwB,IAC1B,CAEA,SAAgB,EAA2B,EAAkB,CAC3D,IAAM,EAAiB,EAAmB,CAAqB,EAI/D,OAHK,MAAM,QAAQ,CAAc,EAG1B,EAAe,SAAS,CAAQ,EAF9B,EAGX,CAEA,SAAgB,EAAe,EAAgB,CAC7C,OACE,aAAiB,OACjB,EAAM,OAAS,aACf,WAAY,GACZ,OAAO,EAAM,QAAW,QAE5B,CAMA,SAAgB,EAAqB,EAAgB,EAAyB,CAC5E,OACE,EAAe,CAAK,GAAM,EAA6B,SAAW,CAEtE,CAEA,SAAS,EAAgC,EAAiC,CAGxE,OAFI,OAAO,GAAY,UACP,EAAQ,KACjB,GAFiC,IAG1C,CAEA,SAAS,EACP,EACe,CACf,OAAO,EAAgC,EAAW,WAAW,CAC/D,CAEA,SAAS,EAAyB,EAA4C,CAC5E,OACE,EAAgC,EAAW,OAAO,GAClD,EAA4B,CAAU,CAE1C,CAEA,SAAS,EACP,EACe,CACf,IAAM,EAAU,EAAyB,CAAU,EAInD,MAHI,CAAC,GAAW,EAAQ,YAAY,IAAM,EACjC,KAEF,CACT,CAEA,SAAgB,EACd,EACe,CACf,IAAM,EAAU,EAAgC,CAAU,EAI1D,MAHI,CAAC,GAAW,CAAC,EAAwB,CAAO,EACvC,KAEF,CACT,CAsBA,SAAgB,EACd,EACe,CAGf,MAFI,CAAC,GACD,GAAQ,EAAA,yBAAyB,GAAG,OAAS,EAAa,KACvD,EAA6B,CAAqB,CAC3D,CAEA,SAAgB,EAA2B,EAAgB,EAAkB,CAC3E,IAAM,EAAe,EAAwB,CAAM,EAC7C,EAAiB,EAAwB,CAAQ,EAEvD,GAAI,CAAC,GAAgB,CAAC,EACpB,OAAO,KAGT,IAAK,IAAM,IAAO,CAAC,QAAS,QAAS,OAAO,EAAY,CACtD,GAAI,EAAa,GAAO,EAAe,GACrC,MAAO,GAET,GAAI,EAAa,GAAO,EAAe,GACrC,MAAO,EAEX,CAYA,OAVI,EAAa,YAAc,CAAC,EAAe,WACtC,GAEL,CAAC,EAAa,YAAc,EAAe,WACtC,EAEL,EAAa,YAAc,EAAe,WACrC,EAAa,WAAW,cAAc,EAAe,UAAU,EAGjE,CACT,CAEA,SAAS,EAAwB,EAAiB,CAEhD,GAAM,CAAC,GADS,EAAQ,KAAK,EAAE,QAAQ,KAAM,EACtB,EAAQ,MAAM,GAAG,EAClC,CAAC,EAAM,GAAc,EAAa,MAAM,IAAK,CAAC,EAC9C,EAAQ,EAAK,MAAM,GAAG,EAE5B,GAAI,EAAM,SAAW,EACnB,OAAO,KAGT,GAAM,CAAC,EAAO,EAAO,GAAS,EAAM,IAAK,GAAS,OAAO,CAAI,CAAC,EAO9D,MALG,CAAC,EAAO,EAAO,CAAK,EAAE,MAAO,GAAS,OAAO,UAAU,CAAI,GAAK,GAAQ,CAAC,EAKrE,CAAE,QAAO,QAAO,QAAO,YAAW,EAHhC,IAIX,CAEA,SAAgB,EACd,EACA,CACA,IAAM,EAAgB,EAAgC,CAAU,EAChE,GAAI,CAAC,EAEH,MADA,EAA2B,EACrB,IAAI,EACR,EAAyB,CAAU,CACrC,EAGF,IAAM,EAAa,EACjB,EACA,CACF,EAEA,GAAI,IAAe,KAEjB,MADA,EAA2B,EACrB,IAAI,EAA+B,CAAa,EAGxD,GAAI,EAAa,EAEf,MADA,EAA2B,EACrB,IAAI,EAAmC,CAAa,CAE9D,CAEA,eAAsB,GAAsB,CAK1C,IAAM,EAAQ,EAAA,yBAAyB,EACvC,GAAI,CAAC,EAAO,CAMV,GALA,EAA2B,EAKvB,EAAA,YAAY,EAAA,iBAAiB,EAAE,OAAO,EACxC,MAAM,IAAI,EAA4B,wBAAyB,CAC7D,oBAAqB,EACvB,CAAC,EAIH,OAAO,IACT,CAEA,IAAM,EAAgB,EAAA,4BAA4B,CAChD,KAAM,EAAM,KACZ,cAAe,EAAM,QAAU,KAC/B,QAAS,CACX,CAAC,EACG,EAEJ,GAAI,CACF,EAAc,MAAM,IAAI,EAAA,aACtB,CACF,EAAE,cAAc,CAClB,OAAS,EAAO,CAUd,MATA,EAA2B,EAIvB,EAAqB,EAAO,GAAG,EAC3B,EAIF,IAAI,EADM,aAAiB,MAAQ,EAAM,QAAU,IACZ,CAC/C,CAQA,GANA,EAAoC,CAAU,EAM1C,EAAA,eAAe,EACjB,GAAI,CACF,MAAM,IAAI,EAAA,eAAe,CAAa,EAAE,YAAY,CACtD,OAAS,EAAO,CAWd,GAAI,EAAqB,EAAO,GAAG,EACjC,MAAM,EAGR,QAAQ,KACN,uDACA,CACF,CACF,CAIF,MADA,GAAwB,EACjB,CACT"}
+{"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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"}

package/dist/api/agent-server-compatibility.d.ts

@@ -5,6 +5,7 @@ export declare const AGENT_SERVER_UNKNOWN_VERSION_ERROR_CODE = "AGENT_SERVER_UNK
 export interface AgentServerInfo extends BaseServerInfo {
     sdk_version?: string;
     usable_tools?: string[] | null;
+    runtime_services?: unknown;
 }
 export declare class AgentServerUnavailableError extends Error {
     readonly details: string | null;
@@ -39,6 +40,9 @@ export declare const isAgentServerUnknownVersionError: (error: unknown) => error
  */
 export declare const isAgentServerAuthError: (error: unknown) => boolean;
 export declare function clearCachedAgentServerInfo(): void;
+export declare function getCachedAgentServerInfo(options?: {
+    host?: string | null;
+}): AgentServerInfo | null;
 export declare function isAgentServerToolAvailable(toolName: string): boolean;
 export declare function isSdkHttpError(error: unknown): boolean;
 /**

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

@@ -6,14 +6,14 @@ import { getActiveBackend as r, getEffectiveLocalBackend as i, isNoBackend as a
 import { getAgentServerClientOptions as o } from "./agent-server-client-options.js";
 import s from "../config/defaults.js";
 //#region src/api/agent-server-compatibility.ts
-var c = 5e3, l = "unknown", u = s.compatibility.minimumAgentServer, d = "AGENT_SERVER_UNSUPPORTED_VERSION", f = "AGENT_SERVER_UNKNOWN_VERSION", p = null, m = (e) => Array.isArray(e?.usable_tools) ? e.usable_tools : null, h = class extends Error {
+var c = 5e3, l = "unknown", u = s.compatibility.minimumAgentServer, d = "AGENT_SERVER_UNSUPPORTED_VERSION", f = "AGENT_SERVER_UNKNOWN_VERSION", p = null, m = null, h = (e) => Array.isArray(e?.usable_tools) ? e.usable_tools : null, g = 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;
 	}
-}, g = (e) => e instanceof h || typeof e == "object" && !!e && "name" in e && e.name === "AgentServerUnavailableError", _ = class extends h {
+}, _ = (e) => e instanceof g || typeof e == "object" && !!e && "name" in e && e.name === "AgentServerUnavailableError", v = class extends g {
 	code = d;
 	actualVersion;
 	requiredVersion = u;
@@ -21,7 +21,7 @@ var c = 5e3, l = "unknown", u = s.compatibility.minimumAgentServer, d = "AGENT_S
 		let t = `Agent Canvas requires agent-server ${u} or newer; this backend is running ${e}. Please upgrade the agent-server backend.`;
 		super(t), this.name = "AgentServerUnsupportedVersionError", this.message = t, this.actualVersion = e;
 	}
-}, v = class extends h {
+}, y = class extends g {
 	code = f;
 	actualVersion;
 	requiredVersion = u;
@@ -29,42 +29,45 @@ var c = 5e3, l = "unknown", u = s.compatibility.minimumAgentServer, d = "AGENT_S
 		let t = `Could not determine this backend's agent-server version.${e ? ` It reported "${e}".` : ""} Agent Canvas requires agent-server ${u} 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;
 	}
-}, y = (e) => n() && C(e, 401);
-function b() {
-	p = null;
-}
-function x(e) {
-	let t = m(p);
-	return Array.isArray(t) ? t.includes(e) : !0;
+}, b = (e) => n() && T(e, 401);
+function x() {
+	p = null, m = null;
 }
 function S(e) {
-	return e instanceof Error && e.name === "HttpError" && "status" in e && typeof e.status == "number";
+	return e?.host && e.host !== m ? null : p;
 }
-function C(e, t) {
-	return S(e) && e.status === t;
+function C(e) {
+	let t = h(p);
+	return Array.isArray(t) ? t.includes(e) : !0;
 }
 function w(e) {
-	return typeof e == "string" && e.trim() || null;
+	return e instanceof Error && e.name === "HttpError" && "status" in e && typeof e.status == "number";
 }
-function T(e) {
-	return w(e.sdk_version);
+function T(e, t) {
+	return w(e) && e.status === t;
 }
 function E(e) {
-	return w(e.version) ?? T(e);
+	return typeof e == "string" && e.trim() || null;
 }
 function D(e) {
-	let t = E(e);
-	return !t || t.toLowerCase() === l ? null : t;
+	return E(e.sdk_version);
 }
 function O(e) {
-	let t = D(e);
-	return !t || !j(t) ? null : t;
+	return E(e.version) ?? D(e);
 }
 function k(e) {
-	return !p || e && i()?.host !== e ? null : O(p);
+	let t = O(e);
+	return !t || t.toLowerCase() === l ? null : t;
+}
+function A(e) {
+	let t = k(e);
+	return !t || !N(t) ? null : t;
 }
-function A(e, t) {
-	let n = j(e), r = j(t);
+function j(e) {
+	return !p || e && i()?.host !== e ? null : A(p);
+}
+function M(e, t) {
+	let n = N(e), r = N(t);
 	if (!n || !r) return null;
 	for (let e of [
 		"major",
@@ -76,7 +79,7 @@ function A(e, t) {
 	}
 	return n.prerelease && !r.prerelease ? -1 : !n.prerelease && r.prerelease ? 1 : n.prerelease && r.prerelease ? n.prerelease.localeCompare(r.prerelease) : 0;
 }
-function j(e) {
+function N(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));
@@ -91,17 +94,17 @@ function j(e) {
 		prerelease: r
 	} : null;
 }
-function M(e) {
-	let t = D(e);
-	if (!t) throw b(), new v(E(e));
-	let n = A(t, u);
-	if (n === null) throw b(), new v(t);
-	if (n < 0) throw b(), new _(t);
+function P(e) {
+	let t = k(e);
+	if (!t) throw x(), new y(O(e));
+	let n = M(t, u);
+	if (n === null) throw x(), new y(t);
+	if (n < 0) throw x(), new v(t);
 }
-async function N() {
+async function F() {
 	let s = i();
 	if (!s) {
-		if (b(), a(r().backend)) throw new h("No backend configured", { noBackendConfigured: !0 });
+		if (x(), a(r().backend)) throw new g("No backend configured", { noBackendConfigured: !0 });
 		return null;
 	}
 	let l = o({
@@ -112,17 +115,17 @@ async function N() {
 	try {
 		u = await new e(l).getServerInfo();
 	} catch (e) {
-		throw b(), C(e, 401) ? e : new h(e instanceof Error ? e.message : null);
+		throw x(), T(e, 401) ? e : new g(e instanceof Error ? e.message : null);
 	}
-	if (M(u), n()) try {
+	if (P(u), n()) try {
 		await new t(l).getSettings();
 	} catch (e) {
-		if (C(e, 401)) throw e;
+		if (T(e, 401)) throw e;
 		console.warn("[agent-server] getSettings() probe failed (non-401):", e);
 	}
-	return p = u, u;
+	return p = u, m = l.host, u;
 }
 //#endregion
-export { M as assertAgentServerVersionIsSupported, b as clearCachedAgentServerInfo, A as compareAgentServerVersions, k as getCachedAgentServerVersion, O as getDisplayAgentServerVersion, y as isAgentServerAuthError, x as isAgentServerToolAvailable, g as isAgentServerUnavailableError, C as isSdkHttpStatusError, N as loadAgentServerInfo };
+export { P as assertAgentServerVersionIsSupported, x as clearCachedAgentServerInfo, M as compareAgentServerVersions, S as getCachedAgentServerInfo, j as getCachedAgentServerVersion, A as getDisplayAgentServerVersion, b as isAgentServerAuthError, C as isAgentServerToolAvailable, _ as isAgentServerUnavailableError, T as isSdkHttpStatusError, F as loadAgentServerInfo };
 
 //# sourceMappingURL=agent-server-compatibility.js.map