@openhands/agent-canvas 1.16.0 → 1.18.0

package/dist/api/conversation-service/agent-server-conversation-service.api.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-server-conversation-service.api.js","names":[],"sources":["../../../src/api/conversation-service/agent-server-conversation-service.api.ts"],"sourcesContent":["import {\n  ConversationSortOrder,\n  type ForkConversationRequest,\n  type LLMConfig,\n  type VSCodeStatusResponse,\n} from \"@openhands/typescript-client\";\nimport {\n  ConversationClient,\n  FileClient,\n  ProfilesClient,\n  VSCodeClient,\n} from \"@openhands/typescript-client/clients\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport { AgentKind, Provider } from \"#/types/settings\";\nimport type { ConversationRuntimeContext } from \"#/api/conversation-file-upload.api\";\nimport { buildHttpBaseUrl } from \"#/utils/websocket-url\";\nimport {\n  buildConversationWorkingDirForBackend,\n  getAgentServerWorkingDir,\n} from \"../agent-server-config\";\nimport { resolveAbsoluteAgentServerPath } from \"../agent-server-home\";\nimport {\n  getActiveBackend,\n  getEffectiveLocalBackend,\n} from \"../backend-registry/active-store\";\nimport { callCloudProxy } from \"../cloud/proxy\";\nimport ProfilesService from \"../profiles-service/profiles-service.api\";\nimport {\n  batchGetCloudConversations,\n  createCloudAppConversation,\n  deleteCloudConversation,\n  downloadCloudConversation,\n  getCloudAppConversationStartTask,\n  readCloudConversationFile,\n  searchCloudConversations,\n  updateCloudConversationPublicFlag,\n  updateCloudConversationTitle,\n} from \"../cloud/conversation-service.api\";\nimport {\n  DirectConversationInfo,\n  assertSubscriptionAuthReady,\n  buildStartConversationRequestWithEncryptedSettings,\n  emptyHooksResponse,\n  getDefaultConversationTitle,\n  toAppConversation,\n  toConversationPage,\n} from \"../agent-server-adapter\";\nimport { GetVSCodeUrlResponse } from \"../open-hands.types\";\nimport {\n  getAgentServerClientOptions,\n  NoBackendAvailableError,\n} from \"../agent-server-client-options\";\nimport SettingsService from \"../settings-service/settings-service.api\";\nimport { getTelemetryDistinctId } from \"../../services/telemetry\";\nimport {\n  ConversationMetadata,\n  getStoredConversationMetadata,\n  removeStoredConversationMetadata,\n  setStoredConversationMetadata,\n  type WorkspaceMode,\n} from \"../conversation-metadata-store\";\nimport { resolveTitleLlmProfile } from \"#/utils/title-llm-profile\";\nimport type {\n  GetHooksResponse,\n  PluginSpec,\n  AppConversation,\n  AppConversationPage,\n  AppConversationStartRequest,\n  AppConversationStartTask,\n  MetricsSnapshot,\n  RuntimeConversationInfo,\n  RuntimeConversationStats,\n  SendMessageRequest,\n  SendMessageResponse,\n} from \"./agent-server-conversation-service.types\";\n\nconst DEFAULT_CONVERSATION_TIMESTAMP = \"1970-01-01T00:00:00.000Z\";\n// Creating the first conversation right after a cold agent-server boot (fresh\n// machine or the packaged desktop app, where uvx may still be warming caches)\n// can exceed the client's 60s default timeout.\nconst CREATE_CONVERSATION_TIMEOUT_MS = 5 * 60 * 1000;\nconst INVALID_CONVERSATION_RESPONSE_MESSAGE =\n  \"Unable to load conversations because the selected agent server returned \" +\n  \"data this UI does not understand. Check the backend URL/session key and \" +\n  \"update the agent server if needed.\";\nfunction invalidConversationResponse(): Error {\n  return new Error(INVALID_CONVERSATION_RESPONSE_MESSAGE);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction numberOrNull(value: unknown): number | null {\n  return typeof value === \"number\" ? value : null;\n}\n\nfunction numberOrZero(value: unknown): number {\n  return typeof value === \"number\" ? value : 0;\n}\n\nfunction stringOrNull(value: unknown): string | null {\n  return typeof value === \"string\" ? value : null;\n}\n\nfunction readTimestamp(\n  item: Record<string, unknown>,\n  snakeKey: \"created_at\" | \"updated_at\",\n  camelKey: \"createdAt\" | \"updatedAt\",\n): string {\n  const value = item[snakeKey] ?? item[camelKey];\n  return typeof value === \"string\" && value.trim()\n    ? value\n    : DEFAULT_CONVERSATION_TIMESTAMP;\n}\n\nfunction normalizeTokenUsage(\n  value: unknown,\n): NonNullable<MetricsSnapshot[\"accumulated_token_usage\"]> | null {\n  if (!isRecord(value)) return null;\n\n  return {\n    prompt_tokens: numberOrZero(value.prompt_tokens),\n    completion_tokens: numberOrZero(value.completion_tokens),\n    cache_read_tokens: numberOrZero(value.cache_read_tokens),\n    cache_write_tokens: numberOrZero(value.cache_write_tokens),\n    context_window: numberOrZero(value.context_window),\n    per_turn_token: numberOrZero(value.per_turn_token),\n  };\n}\n\nfunction normalizeMetrics(value: unknown): MetricsSnapshot | null {\n  if (!isRecord(value)) return null;\n\n  return {\n    accumulated_cost: numberOrNull(value.accumulated_cost),\n    max_budget_per_task: numberOrNull(value.max_budget_per_task),\n    accumulated_token_usage: normalizeTokenUsage(value.accumulated_token_usage),\n  };\n}\n\n// Shallow check only (matches the trust level `getRuntimeConversation` used\n// before this field was threaded through `DirectConversationInfo`): the\n// per-usage-id entries are consumed via `combineUsageMetrics`, which already\n// tolerates missing/malformed fields, so there's no need to validate them here.\nfunction normalizeStats(value: unknown): RuntimeConversationStats | null {\n  return isRecord(value)\n    ? (value as unknown as RuntimeConversationStats)\n    : null;\n}\n\nfunction normalizeAgent(value: unknown): DirectConversationInfo[\"agent\"] {\n  if (!isRecord(value)) return null;\n  const llm = isRecord(value.llm)\n    ? { model: stringOrNull(value.llm.model) }\n    : null;\n  // ``kind`` is the SDK's pydantic discriminator (``\"Agent\"`` vs ``\"ACPAgent\"``);\n  // ``toAppConversation`` reads it to derive ``agent_kind``. ``acp_server`` is\n  // the ACP provider identity (``ACPAgent.acp_server``, SDK #3692) — required so\n  // the adapter can source the chip + in-conversation model list from the agent\n  // when the ``acpserver`` tag is absent (a profile launch doesn't stamp it,\n  // #1571). ``acp_model`` is the Canvas-configured model — preserved so the chip\n  // can fall back to it when the SDK runtime model fields aren't populated.\n  // Preserving these makes the wire path agree with the unit-test path that\n  // builds ``DirectConversationInfo`` directly\n  // (e.g. ``__tests__/api/agent-server-adapter.test.ts``).\n  return {\n    kind: stringOrNull(value.kind),\n    acp_server: stringOrNull(value.acp_server),\n    acp_model: stringOrNull(value.acp_model),\n    llm,\n  };\n}\n\nfunction normalizeWorkspace(\n  value: unknown,\n): DirectConversationInfo[\"workspace\"] {\n  if (!isRecord(value)) return null;\n  return { working_dir: stringOrNull(value.working_dir) };\n}\n\n/**\n * Accept the agent-server's ``tags: Record[str, str]`` payload defensively:\n * the wire shape is guaranteed by the server-side validator (keys\n * ``^[a-z0-9]+$``, string values), but a non-conforming response (older\n * server, raw API write, future schema drift) must never crash the parser\n * — Canvas only consumes ``acpserver`` and falls back to a generic chip\n * for anything it doesn't recognize. Drop entries whose value isn't a\n * plain string; return ``null`` when the wire field is absent or not an\n * object so consumers can use ``info.tags?.[KEY] ?? null`` uniformly.\n */\nfunction normalizeTags(value: unknown): Record<string, string> | null {\n  if (!isRecord(value)) return null;\n  const tags: Record<string, string> = {};\n  for (const [key, entry] of Object.entries(value)) {\n    if (typeof entry === \"string\") {\n      tags[key] = entry;\n    }\n  }\n  return tags;\n}\n\nfunction normalizeLaunchedAgentProfile(\n  value: unknown,\n): DirectConversationInfo[\"launched_agent_profile\"] {\n  if (!isRecord(value)) return null;\n  const { agent_profile_id: agentProfileId, revision } = value;\n  if (typeof agentProfileId !== \"string\" || typeof revision !== \"number\") {\n    return null;\n  }\n  return { agent_profile_id: agentProfileId, revision };\n}\n\nfunction normalizeAbsolutePath(path: string): string | null {\n  if (!path.startsWith(\"/\")) return null;\n\n  const segments: string[] = [];\n  for (const segment of path.split(\"/\")) {\n    if (segment && segment !== \".\") {\n      if (segment === \"..\") {\n        if (!segments.length) return null;\n        segments.pop();\n      } else {\n        segments.push(segment);\n      }\n    }\n  }\n\n  return `/${segments.join(\"/\")}`;\n}\n\nfunction requirePathInsideDirectory(path: string, directory: string): string {\n  const normalizedPath = normalizeAbsolutePath(path);\n  const normalizedDirectory = normalizeAbsolutePath(directory);\n\n  if (\n    !normalizedPath ||\n    !normalizedDirectory ||\n    (normalizedPath !== normalizedDirectory &&\n      !normalizedPath.startsWith(`${normalizedDirectory}/`))\n  ) {\n    throw new Error(\"Conversation file path must stay inside the workspace\");\n  }\n\n  return normalizedPath;\n}\n\nfunction requireDirectConversationInfo(item: unknown): DirectConversationInfo {\n  if (!isRecord(item) || typeof item.id !== \"string\" || !item.id.trim()) {\n    throw invalidConversationResponse();\n  }\n\n  return {\n    id: item.id.trim(),\n    title: stringOrNull(item.title),\n    created_at: readTimestamp(item, \"created_at\", \"createdAt\"),\n    updated_at: readTimestamp(item, \"updated_at\", \"updatedAt\"),\n    execution_status: stringOrNull(item.execution_status),\n    sandbox_status: stringOrNull(item.sandbox_status),\n    metrics: normalizeMetrics(item.metrics),\n    stats: normalizeStats(item.stats),\n    agent: normalizeAgent(item.agent),\n    workspace: normalizeWorkspace(item.workspace),\n    tags: normalizeTags(item.tags),\n    launched_agent_profile: normalizeLaunchedAgentProfile(\n      item.launched_agent_profile,\n    ),\n    // SDK-runtime ACP model fields (populated when the agent-server supports\n    // ``ConversationInfo.current_model_*``). Consumed by the conversation\n    // adapter to drive the per-card chip's model text. Older agent-servers\n    // omit these — adapter handles ``undefined`` / ``null`` gracefully.\n    current_model_id: stringOrNull(item.current_model_id),\n    current_model_name: stringOrNull(item.current_model_name),\n  };\n}\n\nfunction requireDirectConversationItems(\n  items: unknown,\n): DirectConversationInfo[] {\n  if (!Array.isArray(items)) {\n    throw invalidConversationResponse();\n  }\n  return items.map(requireDirectConversationInfo);\n}\n\nfunction requireConversationSearchPage(page: unknown): {\n  items: DirectConversationInfo[];\n  next_page_id: string | null;\n} {\n  if (Array.isArray(page)) {\n    return {\n      items: requireDirectConversationItems(page),\n      next_page_id: null,\n    };\n  }\n\n  if (!isRecord(page)) {\n    throw invalidConversationResponse();\n  }\n\n  return {\n    items: requireDirectConversationItems(page.items),\n    next_page_id:\n      typeof page.next_page_id === \"string\" ? page.next_page_id : null,\n  };\n}\n\nconst RUNTIME_STATUSES = new Set<string>([\n  \"idle\",\n  \"running\",\n  \"paused\",\n  \"waiting_for_confirmation\",\n  \"finished\",\n  \"error\",\n  \"stuck\",\n]);\n\nfunction toRuntimeStatus(\n  status: DirectConversationInfo[\"execution_status\"],\n): RuntimeConversationInfo[\"status\"] {\n  const nextStatus = status ?? \"idle\";\n  return (\n    RUNTIME_STATUSES.has(nextStatus) ? nextStatus : \"idle\"\n  ) as RuntimeConversationInfo[\"status\"];\n}\n\nfunction requireAppConversation(\n  conversation: AppConversation | null | undefined,\n  conversationId: string,\n): AppConversation {\n  if (!conversation) {\n    throw new Error(`Conversation ${conversationId} was not found`);\n  }\n  return conversation;\n}\n\n/**\n * Options for {@link AgentServerConversationService.createConversation}.\n */\nexport interface CreateConversationOptions {\n  initialUserMsg?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  metadata?: ConversationMetadata | null;\n  workingDirOverride?: string;\n  workspaceMode?: WorkspaceMode;\n  parentConversationId?: string;\n  agentType?: \"default\" | \"plan\";\n  sandboxId?: string;\n  // Launch from a saved AgentProfile (resolved server-side) instead of the\n  // current encrypted agent_settings (#3727). Supported on both local and the\n  // cloud app-server (OpenHands #15060): local threads it through the\n  // encrypted-settings builder; cloud sends it as a flat request field.\n  agentProfileId?: string;\n  agentProfileKind?: AgentKind;\n}\n\nclass AgentServerConversationService {\n  static async sendMessage(\n    conversationId: string,\n    message: SendMessageRequest,\n    runtime?: ConversationRuntimeContext | null,\n  ): Promise<SendMessageResponse> {\n    const active = getActiveBackend().backend;\n    let conversationUrl = runtime?.conversationUrl ?? null;\n    let sessionApiKey = runtime?.sessionApiKey ?? null;\n\n    if (active.kind === \"cloud\") {\n      if (!conversationUrl || !sessionApiKey) {\n        const [conversation] = await batchGetCloudConversations([\n          conversationId,\n        ]);\n        conversationUrl = conversation?.conversation_url?.trim() ?? null;\n        sessionApiKey = conversation?.session_api_key?.trim() ?? null;\n      }\n\n      if (!conversationUrl || !sessionApiKey) {\n        throw new Error(\n          \"Conversation sandbox is still starting. Wait for it to finish, then try again.\",\n        );\n      }\n\n      await callCloudProxy({\n        backend: active,\n        method: \"POST\",\n        hostOverride: buildHttpBaseUrl(conversationUrl),\n        path: `/api/conversations/${conversationId}/events`,\n        body: { ...message, run: true },\n        authMode: \"session-api-key\",\n        sessionApiKey,\n      });\n\n      return message;\n    }\n\n    await new ConversationClient(\n      getAgentServerClientOptions({ conversationUrl, sessionApiKey }),\n    ).sendEvent(conversationId, message, {\n      run: true,\n    });\n\n    return message;\n  }\n\n  static async createConversation(\n    options: CreateConversationOptions = {},\n  ): Promise<AppConversationStartTask> {\n    const {\n      initialUserMsg,\n      conversationInstructions,\n      plugins,\n      metadata,\n      workingDirOverride,\n      workspaceMode,\n      parentConversationId,\n      agentType,\n      sandboxId,\n      agentProfileId,\n      agentProfileKind,\n    } = options;\n\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      // Cloud path mirrors OpenHands' frontend: build a flat\n      // AppConversationStartRequest, POST /api/v1/app-conversations\n      // (returns a WORKING task), and let the conversation route's\n      // useTaskPolling drive it to READY. NO encrypted-settings\n      // round-trip — the cloud backend holds secrets server-side.\n      // When launching from a profile, send `agent_profile_id`; the backend\n      // resolves it to agent_settings server-side.\n      const request: AppConversationStartRequest = {\n        initial_message: initialUserMsg\n          ? {\n              role: \"user\",\n              content: [{ type: \"text\", text: initialUserMsg }],\n            }\n          : null,\n        title: conversationInstructions ?? null,\n        selected_repository: metadata?.selected_repository ?? null,\n        selected_branch: metadata?.selected_branch ?? null,\n        git_provider: metadata?.git_provider ?? null,\n        plugins: plugins ?? null,\n        parent_conversation_id: parentConversationId ?? null,\n        agent_type: agentType,\n        sandbox_id: sandboxId ?? null,\n        agent_profile_id: agentProfileId ?? null,\n        trigger: \"gui\",\n      };\n      return createCloudAppConversation(request);\n    }\n\n    const [settings, profiles] = await Promise.all([\n      SettingsService.getSettings(),\n      ProfilesService.listProfiles().catch(() => undefined),\n    ]);\n    const titleLlmProfile = resolveTitleLlmProfile(\n      settings.title_llm_profile,\n      profiles,\n    );\n    const conversationId = uuidv4();\n    // @spec WUP-001 — Send an absolute working_dir to the agent-server.\n    // The default is `workspace/project/<hex>` (relative); without\n    // resolving it here, `/api/file/upload` later prepends `/` and writes\n    // to `/workspace/...` (read-only on macOS and fresh containers). When\n    // the user picks an explicit workspace, `workingDirOverride` is\n    // already absolute (it comes from `search_subdirs`).\n    //\n    // Pick the base working dir per-backend:\n    //   1. explicit user workspace pick → use it as-is;\n    //   2. no pick, backend that served this frontend → the baked default\n    //      (honors a launcher-baked absolute `VITE_WORKING_DIR`);\n    //   3. no pick, any other backend → the backend-relative default.\n    // A baked absolute dir is a path on the host that served this frontend,\n    // so it is only valid on that backend. Using it for a different backend\n    // (e.g. a remote sandbox) makes the agent-server mkdir an unwritable path\n    // and the conversation fails at the first prompt (e.g. `Permission\n    // denied: '/Users'`). The relative default is anchored per-backend by\n    // `resolveAbsoluteAgentServerPath()` via `/api/file/home`. The gate keys\n    // on the active backend's host (not its id): the seeded `default-local`\n    // entry is mutable, so a user can edit it to point at a remote host while\n    // its id stays `default-local`.\n    const baseWorkingDir =\n      workingDirOverride ??\n      buildConversationWorkingDirForBackend(\n        conversationId,\n        getActiveBackend().backend.host,\n      );\n    const workingDir = await resolveAbsoluteAgentServerPath(baseWorkingDir);\n    const resolvedWorkspaceMode =\n      workspaceMode ?? (workingDirOverride ? \"local_repo\" : \"new_worktree\");\n\n    // Use encrypted settings to avoid exposing secrets in the browser\n    const payload = await buildStartConversationRequestWithEncryptedSettings({\n      settings,\n      query: initialUserMsg,\n      conversationInstructions,\n      plugins,\n      conversationId,\n      // The agent-server rejects a parent in a different workspace, so callers\n      // launching a child must pass the parent's own `working_dir` as\n      // `workingDirOverride` (see `resolveConversationWorkingDir`). Servers\n      // older than 1.37.1 ignore the field and create an unlinked conversation.\n      parentConversationId,\n      workingDir,\n      worktree: resolvedWorkspaceMode === \"new_worktree\",\n      agentProfileId,\n      agentProfileKind,\n      titleLlmProfile,\n    });\n\n    const telemetryDistinctId = await getTelemetryDistinctId();\n    const data = await new ConversationClient(\n      getAgentServerClientOptions({ timeout: CREATE_CONVERSATION_TIMEOUT_MS }),\n    ).createConversation<DirectConversationInfo>({\n      ...payload,\n      ...(telemetryDistinctId ? { user_id: telemetryDistinctId } : {}),\n    });\n    const localBackend = getEffectiveLocalBackend();\n    if (!localBackend) throw new NoBackendAvailableError();\n\n    if (metadata?.selected_repository || workingDirOverride) {\n      // The agent-server runtime has no concept of selected repo/branch/\n      // workspace, so persist the home-page selection client-side.\n      // `toAppConversation` reads the repo/branch fields back to hydrate\n      // the chat-page badges; `useHasAttachedSource` reads\n      // `selected_workspace` to default the Files tab to Diff mode when\n      // the user explicitly attached a local workspace.\n      setStoredConversationMetadata(data.id, {\n        selected_repository: metadata?.selected_repository ?? null,\n        selected_branch: metadata?.selected_branch ?? null,\n        git_provider: metadata?.git_provider ?? null,\n        selected_workspace: workingDirOverride ?? null,\n        workspace_mode: resolvedWorkspaceMode,\n      });\n    }\n\n    return {\n      id: data.id,\n      created_by_user_id: null,\n      status: \"READY\",\n      detail: null,\n      app_conversation_id: data.id,\n      agent_server_url: localBackend.host,\n      request: {\n        initial_message: payload.initial_message as\n          | AppConversationStartRequest[\"initial_message\"]\n          | undefined,\n        plugins: plugins ?? null,\n      },\n      created_at: data.created_at,\n      updated_at: data.updated_at,\n    };\n  }\n\n  static async getStartTask(\n    taskId: string,\n  ): Promise<AppConversationStartTask | null> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return getCloudAppConversationStartTask(taskId);\n    }\n    // Local agent-server creates conversations synchronously — every\n    // local \"task\" is already READY when createConversation returns, so\n    // there's nothing to poll for.\n    return null;\n  }\n\n  static async getVSCodeUrl(\n    conversationId: string,\n    conversationUrl: string | null | undefined,\n    sessionApiKey?: string | null,\n  ): Promise<GetVSCodeUrlResponse> {\n    // Local-only path. Cloud conversations read the VSCode URL straight\n    // from the cloud-computed `sandbox.exposed_urls` (see\n    // `useUnifiedVSCodeUrl` + `useCloudSandbox`); the runtime's own\n    // `/api/vscode/url` only knows its internal `localhost:8001`, which\n    // the user's browser can't reach.\n    const workspaceDir =\n      await this.resolveConversationWorkingDir(conversationId);\n    // Local mode: the typescript-client targets the local agent-server\n    // directly via the conversationUrl override.\n    const vscodeUrl = await new VSCodeClient(\n      getAgentServerClientOptions({\n        conversationUrl,\n        sessionApiKey,\n      }),\n    ).getUrl({\n      baseUrl:\n        typeof window !== \"undefined\" ? window.location.origin : undefined,\n      workspaceDir,\n    });\n\n    return { vscode_url: vscodeUrl };\n  }\n\n  /**\n   * Read the editor's capability state from the agent-server.\n   *\n   * `/api/vscode/status` answers 200 with `enabled: false` when the\n   * deployment set `enable_vscode: false`, which distinguishes \"this\n   * deployment offers no editor\" from a transport, auth, or server\n   * failure — `/api/vscode/url` answers 503 for the former and so\n   * cannot be told apart from the latter.\n   */\n  static async getVSCodeStatus(\n    conversationUrl: string | null | undefined,\n    sessionApiKey?: string | null,\n  ): Promise<VSCodeStatusResponse> {\n    return new VSCodeClient(\n      getAgentServerClientOptions({\n        conversationUrl,\n        sessionApiKey,\n      }),\n    ).getStatus();\n  }\n\n  static async resolveConversationWorkingDir(\n    conversationId: string,\n  ): Promise<string> {\n    const [conversation] = await this.batchGetAppConversations([\n      conversationId,\n    ]);\n    return conversation?.workspace?.working_dir ?? getAgentServerWorkingDir();\n  }\n\n  static async batchGetAppConversations(\n    ids: string[],\n  ): Promise<(AppConversation | null)[]> {\n    if (ids.length === 0) return [];\n\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return batchGetCloudConversations(ids);\n    }\n\n    const data = await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).getConversations<DirectConversationInfo>(ids);\n\n    return requireDirectConversationItems(data).map((item) =>\n      toAppConversation(item),\n    );\n  }\n\n  static async updateConversationPublicFlag(\n    conversationId: string,\n    isPublic: boolean,\n  ): Promise<AppConversation> {\n    if (getActiveBackend().backend.kind !== \"cloud\") {\n      throw new Error(\"Public sharing requires a cloud backend.\");\n    }\n    return updateCloudConversationPublicFlag(conversationId, isPublic);\n  }\n\n  static async updateConversationRepository(\n    conversationId: string,\n    repository: string | null,\n    branch?: string | null,\n    gitProvider?: string | null,\n  ): Promise<AppConversation> {\n    if (repository) {\n      const existing = getStoredConversationMetadata(conversationId);\n      setStoredConversationMetadata(conversationId, {\n        ...(existing ?? {}),\n        selected_repository: repository,\n        selected_branch: branch ?? null,\n        git_provider: (gitProvider as Provider | null | undefined) ?? null,\n      });\n    } else {\n      removeStoredConversationMetadata(conversationId);\n    }\n    const [conversation] = await this.batchGetAppConversations([\n      conversationId,\n    ]);\n    return requireAppConversation(conversation, conversationId);\n  }\n\n  static async readConversationFile(\n    conversationId: string,\n    filePath?: string,\n  ): Promise<string> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      // Cloud exposes a per-conversation file endpoint; the sandbox\n      // working dir is fixed (`/workspace/project`), so PLAN.md lives at\n      // a known absolute path. Mirrors OpenHands' readConversationFile.\n      const path = requirePathInsideDirectory(\n        filePath ?? \"/workspace/project/.agents_tmp/PLAN.md\",\n        \"/workspace/project\",\n      );\n      return readCloudConversationFile(conversationId, path);\n    }\n\n    const workingDir = await this.resolveConversationWorkingDir(conversationId);\n    const path = requirePathInsideDirectory(\n      filePath ?? `${workingDir}/.agents_tmp/PLAN.md`,\n      workingDir,\n    );\n    return new FileClient(getAgentServerClientOptions()).downloadTextFile(path);\n  }\n\n  static async downloadConversation(conversationId: string): Promise<Blob> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return downloadCloudConversation(conversationId);\n    }\n\n    return new FileClient(getAgentServerClientOptions()).downloadTrajectory(\n      conversationId,\n    );\n  }\n\n  static async getHooks(conversationId: string): Promise<GetHooksResponse> {\n    if (!conversationId) {\n      return emptyHooksResponse();\n    }\n    return emptyHooksResponse();\n  }\n\n  static async getRuntimeConversation(\n    conversationId: string,\n    conversationUrl: string | null | undefined,\n    sessionApiKey?: string | null,\n  ): Promise<RuntimeConversationInfo> {\n    // Fetch directly from the per-conversation runtime agent-server at conversationUrl.\n    const response = await new ConversationClient(\n      getAgentServerClientOptions({\n        conversationUrl,\n        sessionApiKey,\n      }),\n    ).getConversation<DirectConversationInfo>(conversationId);\n    const data = requireDirectConversationInfo(response);\n\n    return {\n      id: data.id,\n      title: data.title?.trim()\n        ? data.title\n        : getDefaultConversationTitle(data.id),\n      metrics: normalizeMetrics(data.metrics),\n      created_at: data.created_at,\n      updated_at: data.updated_at,\n      status: toRuntimeStatus(data.execution_status),\n      stats: data.stats ?? { usage_to_metrics: {} },\n    };\n  }\n\n  /**\n   * Force condensation (\"compact\") of the conversation history via\n   * `POST /api/conversations/{id}/condense`. Routed the same way as\n   * {@link sendMessage}: through the cloud proxy at the conversation's own\n   * runtime host for cloud backends, directly against that runtime otherwise.\n   */\n  static async condenseConversation(\n    conversationId: string,\n    conversationUrl: string | null | undefined,\n    sessionApiKey?: string | null,\n  ): Promise<void> {\n    const active = getActiveBackend().backend;\n\n    if (active.kind === \"cloud\" && conversationUrl) {\n      await callCloudProxy({\n        backend: active,\n        method: \"POST\",\n        hostOverride: buildHttpBaseUrl(conversationUrl),\n        path: `/api/conversations/${conversationId}/condense`,\n        authMode: \"session-api-key\",\n        sessionApiKey,\n      });\n      return;\n    }\n\n    await new ConversationClient(\n      getAgentServerClientOptions({ conversationUrl, sessionApiKey }),\n    ).condenseConversation(conversationId);\n  }\n\n  static async searchConversations(\n    limit: number = 20,\n    pageId?: string,\n  ): Promise<AppConversationPage> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return searchCloudConversations(limit, pageId);\n    }\n\n    const data = await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).searchConversations({\n      limit,\n      page_id: pageId,\n      sort_order: ConversationSortOrder.UPDATED_AT_DESC,\n    });\n\n    return toConversationPage(requireConversationSearchPage(data));\n  }\n\n  static async deleteConversation(conversationId: string): Promise<void> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      await deleteCloudConversation(conversationId);\n    } else {\n      await new ConversationClient(\n        getAgentServerClientOptions(),\n      ).deleteConversation(conversationId);\n    }\n    removeStoredConversationMetadata(conversationId);\n  }\n\n  static async updateConversationTitle(\n    conversationId: string,\n    title: string,\n  ): Promise<AppConversation> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return updateCloudConversationTitle(conversationId, title);\n    }\n\n    await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).updateConversation(conversationId, {\n      title,\n    });\n    const [conversation] = await this.batchGetAppConversations([\n      conversationId,\n    ]);\n    return requireAppConversation(conversation, conversationId);\n  }\n\n  /**\n   * Forks a conversation, copying event history up to and including\n   * `fromEventId`. Local agent-server only; needs agent-server >= 1.31.0 for\n   * `from_event_id` (older backends copy the whole conversation).\n   */\n  static async forkConversation(\n    sourceConversationId: string,\n    fromEventId: string,\n    title?: string,\n  ): Promise<DirectConversationInfo> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      throw new Error(\n        \"Branching a conversation isn't supported on the cloud backend yet.\",\n      );\n    }\n\n    // `from_event_id` is accepted by `/fork` but not yet typed in\n    // ForkConversationRequest (through client 1.32.0); the client forwards the\n    // body verbatim, so cast to carry it. A title also suppresses the backend\n    // auto-title, so the \"(branch)\" marker sticks.\n    const data = await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).forkConversation<DirectConversationInfo>(sourceConversationId, {\n      from_event_id: fromEventId,\n      ...(title ? { title } : {}),\n    } as ForkConversationRequest & { from_event_id: string });\n\n    // Carry over the source's client-side metadata (repo/branch/workspace/\n    // profile/plugins) so the fork hydrates its chat-page badges the same way.\n    const sourceMetadata = getStoredConversationMetadata(sourceConversationId);\n    if (sourceMetadata) {\n      setStoredConversationMetadata(data.id, sourceMetadata);\n    }\n\n    return data;\n  }\n\n  /**\n   * Returns an event's `parent_id` (the fork point for branching *before* it),\n   * or undefined at the root. Uses the single-event endpoint because the events\n   * *search* API omits `parent_id`.\n   */\n  static async getEventParentId(\n    conversationId: string,\n    eventId: string,\n  ): Promise<string | undefined> {\n    const event = (await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).getEvent(conversationId, eventId)) as { parent_id?: string | null };\n    return event.parent_id ?? undefined;\n  }\n\n  /**\n   * Switches the LLM profile for the running conversation when one is open\n   * (POST /switch_profile — per-conversation swap, doesn't change the user's\n   * default profile). When called without a conversationId (home page),\n   * falls back to POST /activate so the next conversation created picks up\n   * the chosen profile.\n   *\n   * The per-conversation endpoint accepts only the profile name, so the UI does\n   * not need to fetch or forward profile secrets. That keeps switching working\n   * even when the agent server has no OH_SECRET_KEY for encrypted secret export.\n   *\n   * Cloud backends route to the app-server's per-conversation\n   * `/switch_profile`, which owns the profiles and resolves the swap\n   * server-side (base_url/api_key fixups, usage_id derivation, then the\n   * agent-server's switch_llm) — so the client only forwards the profile name,\n   * mirroring {@link switchAcpModel}.\n   */\n  static async switchProfile(\n    conversationId: string | null,\n    profileName: string,\n  ): Promise<void> {\n    const { backend } = getActiveBackend();\n\n    if (backend.kind === \"cloud\") {\n      // No conversation (home page): activate globally so the next\n      // conversation starts with it. ProfilesService routes to the cloud\n      // activate endpoint.\n      if (!conversationId) {\n        await ProfilesService.activateProfile(profileName);\n        return;\n      }\n      await callCloudProxy({\n        backend,\n        method: \"POST\",\n        path: `/api/v1/app-conversations/${conversationId}/switch_profile`,\n        body: { profile_name: profileName },\n      });\n      return;\n    }\n\n    if (!conversationId) {\n      await new ProfilesClient(getAgentServerClientOptions()).activateProfile(\n        profileName,\n      );\n      return;\n    }\n\n    const clientOptions = getAgentServerClientOptions();\n    const conversationClient = new ConversationClient(clientOptions);\n    const profile = await new ProfilesClient(clientOptions).getProfile(\n      profileName,\n      { exposeSecrets: \"encrypted\" },\n    );\n    const model =\n      typeof profile.config.model === \"string\" ? profile.config.model : \"\";\n    if (!model) throw new Error(`Profile '${profileName}' has no model.`);\n    await assertSubscriptionAuthReady({ llm: profile.config });\n    await conversationClient.switchLLM(conversationId, {\n      ...profile.config,\n      model,\n      // Keep streaming on after a switch (parity with conversation start);\n      // the profile config would otherwise default it to stream=False.\n      stream: true,\n      // Avoid stale first-write-wins entries in the backend LLM registry.\n      usage_id: `profile:${profileName}:${uuidv4()}`,\n    } as LLMConfig);\n  }\n\n  /**\n   * Switches the model of a running ACP conversation in place (POST\n   * /switch_acp_model — the ACP analog of {@link switchProfile}'s /switch_profile).\n   * The agent-server calls the ACP wrapper's ``session/set_model`` on the live\n   * session, preserving context. Mirrors {@link switchProfile}'s\n   * local-backend-only guard and per-conversation ConversationClient call.\n   *\n   * Works on a created-but-not-yet-run conversation too: the agent-server\n   * treats a pre-first-run switch as a persist-only deferral (the model is\n   * mirrored into the conversation's stored agent and applied when the session\n   * starts). The home/no-conversation default is persisted via the active ACP\n   * profile / Settings instead (see ``use-switch-acp-model``).\n   */\n  static async switchAcpModel(\n    conversationId: string,\n    model: string,\n  ): Promise<void> {\n    const { backend } = getActiveBackend();\n    if (backend.kind === \"cloud\") {\n      await callCloudProxy({\n        backend,\n        method: \"POST\",\n        path: `/api/v1/app-conversations/${conversationId}/switch_acp_model`,\n        body: { model },\n      });\n      return;\n    }\n\n    await new ConversationClient(getAgentServerClientOptions()).switchAcpModel(\n      conversationId,\n      model,\n    );\n  }\n}\n\nexport default AgentServerConversationService;\n"],"mappings":"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"}
+{"version":3,"file":"agent-server-conversation-service.api.js","names":[],"sources":["../../../src/api/conversation-service/agent-server-conversation-service.api.ts"],"sourcesContent":["import {\n  ConversationSortOrder,\n  type ForkConversationRequest,\n  type LLMConfig,\n  type VSCodeStatusResponse,\n} from \"@openhands/typescript-client\";\nimport {\n  ConversationClient,\n  FileClient,\n  ProfilesClient,\n  VSCodeClient,\n} from \"@openhands/typescript-client/clients\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport { AgentKind, Provider } from \"#/types/settings\";\nimport type { ConversationRuntimeContext } from \"#/api/conversation-file-upload.api\";\nimport { buildHttpBaseUrl } from \"#/utils/websocket-url\";\nimport {\n  buildConversationWorkingDirForBackend,\n  getAgentServerWorkingDir,\n  getWorkspaceRootForBackend,\n} from \"../agent-server-config\";\nimport { resolveAbsoluteAgentServerPath } from \"../agent-server-home\";\nimport {\n  getActiveBackend,\n  getEffectiveLocalBackend,\n} from \"../backend-registry/active-store\";\nimport { callCloudProxy } from \"../cloud/proxy\";\nimport ProfilesService from \"../profiles-service/profiles-service.api\";\nimport {\n  batchGetCloudConversations,\n  createCloudAppConversation,\n  deleteCloudConversation,\n  downloadCloudConversation,\n  getCloudAppConversationStartTask,\n  readCloudConversationFile,\n  searchCloudConversations,\n  updateCloudConversationPublicFlag,\n  updateCloudConversationTitle,\n} from \"../cloud/conversation-service.api\";\nimport {\n  DirectConversationInfo,\n  assertSubscriptionAuthReady,\n  buildStartConversationRequestWithEncryptedSettings,\n  buildStartPlanningConversationRequestWithEncryptedSettings,\n  emptyHooksResponse,\n  getDefaultConversationTitle,\n  toAppConversation,\n  toConversationPage,\n} from \"../agent-server-adapter\";\nimport { GetVSCodeUrlResponse } from \"../open-hands.types\";\nimport {\n  getAgentServerClientOptions,\n  NoBackendAvailableError,\n} from \"../agent-server-client-options\";\nimport SettingsService from \"../settings-service/settings-service.api\";\nimport { getTelemetryDistinctId } from \"../../services/telemetry\";\nimport {\n  ConversationMetadata,\n  getStoredConversationMetadata,\n  mergeStoredConversationMetadata,\n  removeStoredConversationMetadata,\n  setStoredConversationMetadata,\n  type WorkspaceMode,\n} from \"../conversation-metadata-store\";\nimport { resolveTitleLlmProfile } from \"#/utils/title-llm-profile\";\nimport { isPlannerConversationOf } from \"#/utils/plan-file\";\nimport type {\n  GetHooksResponse,\n  PluginSpec,\n  AppConversation,\n  AppConversationPage,\n  AppConversationStartRequest,\n  AppConversationStartTask,\n  MetricsSnapshot,\n  RuntimeConversationInfo,\n  RuntimeConversationStats,\n  SendMessageRequest,\n  SendMessageResponse,\n} from \"./agent-server-conversation-service.types\";\n\nconst DEFAULT_CONVERSATION_TIMESTAMP = \"1970-01-01T00:00:00.000Z\";\n// Creating the first conversation right after a cold agent-server boot (fresh\n// machine or the packaged desktop app, where uvx may still be warming caches)\n// can exceed the client's 60s default timeout.\nconst CREATE_CONVERSATION_TIMEOUT_MS = 5 * 60 * 1000;\nconst INVALID_CONVERSATION_RESPONSE_MESSAGE =\n  \"Unable to load conversations because the selected agent server returned \" +\n  \"data this UI does not understand. Check the backend URL/session key and \" +\n  \"update the agent server if needed.\";\nfunction invalidConversationResponse(): Error {\n  return new Error(INVALID_CONVERSATION_RESPONSE_MESSAGE);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction numberOrNull(value: unknown): number | null {\n  return typeof value === \"number\" ? value : null;\n}\n\nfunction numberOrZero(value: unknown): number {\n  return typeof value === \"number\" ? value : 0;\n}\n\nfunction stringOrNull(value: unknown): string | null {\n  return typeof value === \"string\" ? value : null;\n}\n\nfunction readTimestamp(\n  item: Record<string, unknown>,\n  snakeKey: \"created_at\" | \"updated_at\",\n  camelKey: \"createdAt\" | \"updatedAt\",\n): string {\n  const value = item[snakeKey] ?? item[camelKey];\n  return typeof value === \"string\" && value.trim()\n    ? value\n    : DEFAULT_CONVERSATION_TIMESTAMP;\n}\n\nfunction normalizeTokenUsage(\n  value: unknown,\n): NonNullable<MetricsSnapshot[\"accumulated_token_usage\"]> | null {\n  if (!isRecord(value)) return null;\n\n  return {\n    prompt_tokens: numberOrZero(value.prompt_tokens),\n    completion_tokens: numberOrZero(value.completion_tokens),\n    cache_read_tokens: numberOrZero(value.cache_read_tokens),\n    cache_write_tokens: numberOrZero(value.cache_write_tokens),\n    context_window: numberOrZero(value.context_window),\n    per_turn_token: numberOrZero(value.per_turn_token),\n  };\n}\n\nfunction normalizeMetrics(value: unknown): MetricsSnapshot | null {\n  if (!isRecord(value)) return null;\n\n  return {\n    accumulated_cost: numberOrNull(value.accumulated_cost),\n    max_budget_per_task: numberOrNull(value.max_budget_per_task),\n    accumulated_token_usage: normalizeTokenUsage(value.accumulated_token_usage),\n  };\n}\n\n// Shallow check only (matches the trust level `getRuntimeConversation` used\n// before this field was threaded through `DirectConversationInfo`): the\n// per-usage-id entries are consumed via `combineUsageMetrics`, which already\n// tolerates missing/malformed fields, so there's no need to validate them here.\nfunction normalizeStats(value: unknown): RuntimeConversationStats | null {\n  return isRecord(value)\n    ? (value as unknown as RuntimeConversationStats)\n    : null;\n}\n\nfunction normalizeAgent(value: unknown): DirectConversationInfo[\"agent\"] {\n  if (!isRecord(value)) return null;\n  const llm = isRecord(value.llm)\n    ? { model: stringOrNull(value.llm.model) }\n    : null;\n  // ``kind`` is the SDK's pydantic discriminator (``\"Agent\"`` vs ``\"ACPAgent\"``);\n  // ``toAppConversation`` reads it to derive ``agent_kind``. ``acp_server`` is\n  // the ACP provider identity (``ACPAgent.acp_server``, SDK #3692) — required so\n  // the adapter can source the chip + in-conversation model list from the agent\n  // when the ``acpserver`` tag is absent (a profile launch doesn't stamp it,\n  // #1571). ``acp_model`` is the Canvas-configured model — preserved so the chip\n  // can fall back to it when the SDK runtime model fields aren't populated.\n  // Preserving these makes the wire path agree with the unit-test path that\n  // builds ``DirectConversationInfo`` directly\n  // (e.g. ``__tests__/api/agent-server-adapter.test.ts``).\n  return {\n    kind: stringOrNull(value.kind),\n    acp_server: stringOrNull(value.acp_server),\n    acp_model: stringOrNull(value.acp_model),\n    llm,\n  };\n}\n\nfunction normalizeWorkspace(\n  value: unknown,\n): DirectConversationInfo[\"workspace\"] {\n  if (!isRecord(value)) return null;\n  return { working_dir: stringOrNull(value.working_dir) };\n}\n\n/**\n * Accept the agent-server's ``tags: Record[str, str]`` payload defensively:\n * the wire shape is guaranteed by the server-side validator (keys\n * ``^[a-z0-9]+$``, string values), but a non-conforming response (older\n * server, raw API write, future schema drift) must never crash the parser\n * — Canvas only consumes ``acpserver`` and falls back to a generic chip\n * for anything it doesn't recognize. Drop entries whose value isn't a\n * plain string; return ``null`` when the wire field is absent or not an\n * object so consumers can use ``info.tags?.[KEY] ?? null`` uniformly.\n */\nfunction normalizeTags(value: unknown): Record<string, string> | null {\n  if (!isRecord(value)) return null;\n  const tags: Record<string, string> = {};\n  for (const [key, entry] of Object.entries(value)) {\n    if (typeof entry === \"string\") {\n      tags[key] = entry;\n    }\n  }\n  return tags;\n}\n\n/**\n * ``ConversationInfo.sub_conversation_ids`` — the agent-server derives it from\n * its own catalog of conversations that name this one as parent (SDK #4188),\n * which is what lets Canvas find a conversation's local planner without any\n * browser-local state. Absent on agent-servers older than 1.37.1; parsed\n * defensively so a non-conforming payload degrades to \"no children\" instead of\n * crashing the list.\n */\nfunction normalizeSubConversationIds(value: unknown): string[] | null {\n  if (!Array.isArray(value)) return null;\n  return value.filter((entry): entry is string => typeof entry === \"string\");\n}\n\nfunction normalizeLaunchedAgentProfile(\n  value: unknown,\n): DirectConversationInfo[\"launched_agent_profile\"] {\n  if (!isRecord(value)) return null;\n  const { agent_profile_id: agentProfileId, revision } = value;\n  if (typeof agentProfileId !== \"string\" || typeof revision !== \"number\") {\n    return null;\n  }\n  return { agent_profile_id: agentProfileId, revision };\n}\n\nfunction normalizeAbsolutePath(path: string): string | null {\n  if (!path.startsWith(\"/\")) return null;\n\n  const segments: string[] = [];\n  for (const segment of path.split(\"/\")) {\n    if (segment && segment !== \".\") {\n      if (segment === \"..\") {\n        if (!segments.length) return null;\n        segments.pop();\n      } else {\n        segments.push(segment);\n      }\n    }\n  }\n\n  return `/${segments.join(\"/\")}`;\n}\n\nfunction requirePathInsideDirectory(path: string, directory: string): string {\n  const normalizedPath = normalizeAbsolutePath(path);\n  const normalizedDirectory = normalizeAbsolutePath(directory);\n\n  if (\n    !normalizedPath ||\n    !normalizedDirectory ||\n    (normalizedPath !== normalizedDirectory &&\n      !normalizedPath.startsWith(`${normalizedDirectory}/`))\n  ) {\n    throw new Error(\"Conversation file path must stay inside the workspace\");\n  }\n\n  return normalizedPath;\n}\n\nfunction requireDirectConversationInfo(item: unknown): DirectConversationInfo {\n  if (!isRecord(item) || typeof item.id !== \"string\" || !item.id.trim()) {\n    throw invalidConversationResponse();\n  }\n\n  return {\n    id: item.id.trim(),\n    title: stringOrNull(item.title),\n    created_at: readTimestamp(item, \"created_at\", \"createdAt\"),\n    updated_at: readTimestamp(item, \"updated_at\", \"updatedAt\"),\n    execution_status: stringOrNull(item.execution_status),\n    sandbox_status: stringOrNull(item.sandbox_status),\n    metrics: normalizeMetrics(item.metrics),\n    stats: normalizeStats(item.stats),\n    agent: normalizeAgent(item.agent),\n    workspace: normalizeWorkspace(item.workspace),\n    tags: normalizeTags(item.tags),\n    launched_agent_profile: normalizeLaunchedAgentProfile(\n      item.launched_agent_profile,\n    ),\n    sub_conversation_ids: normalizeSubConversationIds(\n      item.sub_conversation_ids,\n    ),\n    // SDK-runtime ACP model fields (populated when the agent-server supports\n    // ``ConversationInfo.current_model_*``). Consumed by the conversation\n    // adapter to drive the per-card chip's model text. Older agent-servers\n    // omit these — adapter handles ``undefined`` / ``null`` gracefully.\n    current_model_id: stringOrNull(item.current_model_id),\n    current_model_name: stringOrNull(item.current_model_name),\n  };\n}\n\nfunction requireDirectConversationItems(\n  items: unknown,\n): DirectConversationInfo[] {\n  if (!Array.isArray(items)) {\n    throw invalidConversationResponse();\n  }\n  return items.map(requireDirectConversationInfo);\n}\n\nfunction requireConversationSearchPage(page: unknown): {\n  items: DirectConversationInfo[];\n  next_page_id: string | null;\n} {\n  if (Array.isArray(page)) {\n    return {\n      items: requireDirectConversationItems(page),\n      next_page_id: null,\n    };\n  }\n\n  if (!isRecord(page)) {\n    throw invalidConversationResponse();\n  }\n\n  return {\n    items: requireDirectConversationItems(page.items),\n    next_page_id:\n      typeof page.next_page_id === \"string\" ? page.next_page_id : null,\n  };\n}\n\nconst RUNTIME_STATUSES = new Set<string>([\n  \"idle\",\n  \"running\",\n  \"paused\",\n  \"waiting_for_confirmation\",\n  \"finished\",\n  \"error\",\n  \"stuck\",\n]);\n\nfunction toRuntimeStatus(\n  status: DirectConversationInfo[\"execution_status\"],\n): RuntimeConversationInfo[\"status\"] {\n  const nextStatus = status ?? \"idle\";\n  return (\n    RUNTIME_STATUSES.has(nextStatus) ? nextStatus : \"idle\"\n  ) as RuntimeConversationInfo[\"status\"];\n}\n\nfunction requireAppConversation(\n  conversation: AppConversation | null | undefined,\n  conversationId: string,\n): AppConversation {\n  if (!conversation) {\n    throw new Error(`Conversation ${conversationId} was not found`);\n  }\n  return conversation;\n}\n\n/**\n * Options for {@link AgentServerConversationService.createConversation}.\n */\nexport interface CreateConversationOptions {\n  initialUserMsg?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  metadata?: ConversationMetadata | null;\n  workingDirOverride?: string;\n  workspaceMode?: WorkspaceMode;\n  parentConversationId?: string;\n  agentType?: \"default\" | \"plan\";\n  sandboxId?: string;\n  // Launch from a saved AgentProfile (resolved server-side) instead of the\n  // current encrypted agent_settings (#3727). Supported on both local and the\n  // cloud app-server (OpenHands #15060): local threads it through the\n  // encrypted-settings builder; cloud sends it as a flat request field.\n  agentProfileId?: string;\n  agentProfileKind?: AgentKind;\n}\n\nclass AgentServerConversationService {\n  static async sendMessage(\n    conversationId: string,\n    message: SendMessageRequest,\n    runtime?: ConversationRuntimeContext | null,\n  ): Promise<SendMessageResponse> {\n    const active = getActiveBackend().backend;\n    let conversationUrl = runtime?.conversationUrl ?? null;\n    let sessionApiKey = runtime?.sessionApiKey ?? null;\n\n    if (active.kind === \"cloud\") {\n      if (!conversationUrl || !sessionApiKey) {\n        const [conversation] = await batchGetCloudConversations([\n          conversationId,\n        ]);\n        conversationUrl = conversation?.conversation_url?.trim() ?? null;\n        sessionApiKey = conversation?.session_api_key?.trim() ?? null;\n      }\n\n      if (!conversationUrl || !sessionApiKey) {\n        throw new Error(\n          \"Conversation sandbox is still starting. Wait for it to finish, then try again.\",\n        );\n      }\n\n      await callCloudProxy({\n        backend: active,\n        method: \"POST\",\n        hostOverride: buildHttpBaseUrl(conversationUrl),\n        path: `/api/conversations/${conversationId}/events`,\n        body: { ...message, run: true },\n        authMode: \"session-api-key\",\n        sessionApiKey,\n      });\n\n      return message;\n    }\n\n    await new ConversationClient(\n      getAgentServerClientOptions({ conversationUrl, sessionApiKey }),\n    ).sendEvent(conversationId, message, {\n      run: true,\n    });\n\n    return message;\n  }\n\n  static async createConversation(\n    options: CreateConversationOptions = {},\n  ): Promise<AppConversationStartTask> {\n    const {\n      initialUserMsg,\n      conversationInstructions,\n      plugins,\n      metadata,\n      workingDirOverride,\n      workspaceMode,\n      parentConversationId,\n      agentType,\n      sandboxId,\n      agentProfileId,\n      agentProfileKind,\n    } = options;\n\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      // Cloud path mirrors OpenHands' frontend: build a flat\n      // AppConversationStartRequest, POST /api/v1/app-conversations\n      // (returns a WORKING task), and let the conversation route's\n      // useTaskPolling drive it to READY. NO encrypted-settings\n      // round-trip — the cloud backend holds secrets server-side.\n      // When launching from a profile, send `agent_profile_id`; the backend\n      // resolves it to agent_settings server-side.\n      const request: AppConversationStartRequest = {\n        initial_message: initialUserMsg\n          ? {\n              role: \"user\",\n              content: [{ type: \"text\", text: initialUserMsg }],\n            }\n          : null,\n        title: conversationInstructions ?? null,\n        selected_repository: metadata?.selected_repository ?? null,\n        selected_branch: metadata?.selected_branch ?? null,\n        git_provider: metadata?.git_provider ?? null,\n        plugins: plugins ?? null,\n        parent_conversation_id: parentConversationId ?? null,\n        agent_type: agentType,\n        sandbox_id: sandboxId ?? null,\n        agent_profile_id: agentProfileId ?? null,\n        trigger: \"gui\",\n      };\n      return createCloudAppConversation(request);\n    }\n\n    const [settings, profiles] = await Promise.all([\n      SettingsService.getSettings(),\n      ProfilesService.listProfiles().catch(() => undefined),\n    ]);\n    const titleLlmProfile = resolveTitleLlmProfile(\n      settings.title_llm_profile,\n      profiles,\n    );\n    const conversationId = uuidv4();\n    // @spec WUP-001 — Send an absolute working_dir to the agent-server.\n    // The default is `workspace/project/<hex>` (relative); without\n    // resolving it here, `/api/file/upload` later prepends `/` and writes\n    // to `/workspace/...` (read-only on macOS and fresh containers). When\n    // the user picks an explicit workspace, `workingDirOverride` is\n    // already absolute (it comes from `search_subdirs`).\n    //\n    // Pick the base working dir per-backend:\n    //   1. explicit user workspace pick → use it as-is;\n    //   2. no pick, backend that served this frontend → the baked default\n    //      (honors a launcher-baked absolute `VITE_WORKING_DIR`);\n    //   3. no pick, any other backend → the backend-relative default.\n    // A baked absolute dir is a path on the host that served this frontend,\n    // so it is only valid on that backend. Using it for a different backend\n    // (e.g. a remote sandbox) makes the agent-server mkdir an unwritable path\n    // and the conversation fails at the first prompt (e.g. `Permission\n    // denied: '/Users'`). The relative default is anchored per-backend by\n    // `resolveAbsoluteAgentServerPath()` via `/api/file/home`. The gate keys\n    // on the active backend's host (not its id): the seeded `default-local`\n    // entry is mutable, so a user can edit it to point at a remote host while\n    // its id stays `default-local`.\n    const backendHost = getActiveBackend().backend.host;\n    const baseWorkingDir =\n      workingDirOverride ??\n      buildConversationWorkingDirForBackend(conversationId, backendHost);\n    const workingDir = await resolveAbsoluteAgentServerPath(baseWorkingDir);\n    // The agent-server checks `<project_dir>/.openhands/hooks.json` literally,\n    // so hooks need the workspace root: the per-conversation subdir below it is\n    // created only after this request (#16907). An explicit pick is the root.\n    const hooksProjectDir = workingDirOverride\n      ? workingDir\n      : await resolveAbsoluteAgentServerPath(\n          getWorkspaceRootForBackend(backendHost),\n        );\n    const resolvedWorkspaceMode =\n      workspaceMode ?? (workingDirOverride ? \"local_repo\" : \"new_worktree\");\n\n    // Use encrypted settings to avoid exposing secrets in the browser\n    const payload = await buildStartConversationRequestWithEncryptedSettings({\n      settings,\n      query: initialUserMsg,\n      conversationInstructions,\n      plugins,\n      conversationId,\n      // The agent-server rejects a parent in a different workspace, so callers\n      // launching a child must pass the parent's own `working_dir` as\n      // `workingDirOverride` (see `resolveConversationWorkingDir`). Servers\n      // older than 1.37.1 ignore the field and create an unlinked conversation.\n      parentConversationId,\n      workingDir,\n      hooksProjectDir,\n      worktree: resolvedWorkspaceMode === \"new_worktree\",\n      agentProfileId,\n      agentProfileKind,\n      titleLlmProfile,\n    });\n\n    const telemetryDistinctId = await getTelemetryDistinctId();\n    const data = await new ConversationClient(\n      getAgentServerClientOptions({ timeout: CREATE_CONVERSATION_TIMEOUT_MS }),\n    ).createConversation<DirectConversationInfo>({\n      ...payload,\n      ...(telemetryDistinctId ? { user_id: telemetryDistinctId } : {}),\n    });\n    const localBackend = getEffectiveLocalBackend();\n    if (!localBackend) throw new NoBackendAvailableError();\n\n    if (metadata?.selected_repository || workingDirOverride) {\n      // The agent-server runtime has no concept of selected repo/branch/\n      // workspace, so persist the home-page selection client-side.\n      // `toAppConversation` reads the repo/branch fields back to hydrate\n      // the chat-page badges; `useHasAttachedSource` reads\n      // `selected_workspace` to default the Files tab to Diff mode when\n      // the user explicitly attached a local workspace.\n      setStoredConversationMetadata(data.id, {\n        selected_repository: metadata?.selected_repository ?? null,\n        selected_branch: metadata?.selected_branch ?? null,\n        git_provider: metadata?.git_provider ?? null,\n        selected_workspace: workingDirOverride ?? null,\n        workspace_mode: resolvedWorkspaceMode,\n      });\n    }\n\n    return {\n      id: data.id,\n      created_by_user_id: null,\n      status: \"READY\",\n      detail: null,\n      app_conversation_id: data.id,\n      agent_server_url: localBackend.host,\n      request: {\n        initial_message: payload.initial_message as\n          | AppConversationStartRequest[\"initial_message\"]\n          | undefined,\n        plugins: plugins ?? null,\n      },\n      created_at: data.created_at,\n      updated_at: data.updated_at,\n    };\n  }\n\n  static async createLocalPlanningConversation(\n    parentConversationId: string,\n    initialMessage?: string,\n  ): Promise<AppConversation> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      throw new Error(\"Local planning conversations require a local backend.\");\n    }\n\n    const [parent] = await this.batchGetAppConversations([\n      parentConversationId,\n    ]);\n    const workingDir =\n      parent?.workspace?.working_dir ?? getAgentServerWorkingDir();\n\n    const payload =\n      await buildStartPlanningConversationRequestWithEncryptedSettings({\n        workingDir,\n        parentConversationId,\n        // Pin the planner to the parent's own current model. Only meaningful\n        // for \"openhands\"-kind parents: an ACP parent's active_profile is a\n        // stale launch-time snapshot (/model is a no-op for ACP), not a live\n        // value, so treating it as authoritative would pin the planner to\n        // the wrong model instead of falling through to global settings.\n        parentActiveProfileName:\n          parent?.agent_kind === \"openhands\"\n            ? (parent?.active_profile ?? null)\n            : null,\n        // Fallback when active_profile can't be resolved (e.g. an ACP parent).\n        parentAgentProfileId:\n          parent?.launched_agent_profile?.agent_profile_id ?? null,\n        initialMessage,\n      });\n\n    const data = await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).createConversation<DirectConversationInfo>(payload);\n\n    // Client-side fallback only: agent-servers >= 1.37.1 persist the link via\n    // `parent_conversation_id` and hand it back on the parent's\n    // `sub_conversation_ids`, which is the source of truth. This hint covers\n    // older backends that ignore the field.\n    mergeStoredConversationMetadata(parentConversationId, {\n      local_planning_conversation_id: data.id,\n    });\n\n    return toAppConversation(data);\n  }\n\n  /**\n   * Ids of the conversations owned by `parentConversationId` on a local\n   * backend — today that means its planner helper, the only child Canvas\n   * creates locally.\n   *\n   * `sub_conversation_ids` is the generic server-derived child list, so each\n   * child is kept only if it's tagged `plannerparent` for this parent —\n   * otherwise deleting the parent would also delete an unrelated non-planner\n   * child (e.g. a delegated sub-agent). The stored metadata hint is merged in\n   * for agent-servers older than 1.37.1, which report no children at all.\n   */\n  static async getLocalPlanningConversationIds(\n    parentConversationId: string,\n  ): Promise<string[]> {\n    if (getActiveBackend().backend.kind === \"cloud\") return [];\n\n    const ids = new Set<string>();\n\n    try {\n      const [parent] = await this.batchGetAppConversations([\n        parentConversationId,\n      ]);\n      const childIds = parent?.sub_conversation_ids ?? [];\n      if (childIds.length > 0) {\n        const children = await this.batchGetAppConversations(childIds);\n        for (const child of children) {\n          if (child && isPlannerConversationOf(child, parentConversationId)) {\n            ids.add(child.id);\n          }\n        }\n      }\n    } catch (error) {\n      // The stored hint below still covers the common case, and callers\n      // (delete) must not be blocked by a failed lookup.\n      console.warn(\n        `Failed to read sub-conversations of ${parentConversationId}`,\n        error,\n      );\n    }\n\n    const stored =\n      getStoredConversationMetadata(\n        parentConversationId,\n      )?.local_planning_conversation_id;\n    if (stored) ids.add(stored);\n\n    return [...ids];\n  }\n\n  static async getStartTask(\n    taskId: string,\n  ): Promise<AppConversationStartTask | null> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return getCloudAppConversationStartTask(taskId);\n    }\n    // Local agent-server creates conversations synchronously — every\n    // local \"task\" is already READY when createConversation returns, so\n    // there's nothing to poll for.\n    return null;\n  }\n\n  static async getVSCodeUrl(\n    conversationId: string,\n    conversationUrl: string | null | undefined,\n    sessionApiKey?: string | null,\n  ): Promise<GetVSCodeUrlResponse> {\n    // Local-only path. Cloud conversations read the VSCode URL straight\n    // from the cloud-computed `sandbox.exposed_urls` (see\n    // `useUnifiedVSCodeUrl` + `useCloudSandbox`); the runtime's own\n    // `/api/vscode/url` only knows its internal `localhost:8001`, which\n    // the user's browser can't reach.\n    const workspaceDir =\n      await this.resolveConversationWorkingDir(conversationId);\n    // Local mode: the typescript-client targets the local agent-server\n    // directly via the conversationUrl override.\n    const vscodeUrl = await new VSCodeClient(\n      getAgentServerClientOptions({\n        conversationUrl,\n        sessionApiKey,\n      }),\n    ).getUrl({\n      baseUrl:\n        typeof window !== \"undefined\" ? window.location.origin : undefined,\n      workspaceDir,\n    });\n\n    return { vscode_url: vscodeUrl };\n  }\n\n  /**\n   * Read the editor's capability state from the agent-server.\n   *\n   * `/api/vscode/status` answers 200 with `enabled: false` when the\n   * deployment set `enable_vscode: false`, which distinguishes \"this\n   * deployment offers no editor\" from a transport, auth, or server\n   * failure — `/api/vscode/url` answers 503 for the former and so\n   * cannot be told apart from the latter.\n   */\n  static async getVSCodeStatus(\n    conversationUrl: string | null | undefined,\n    sessionApiKey?: string | null,\n  ): Promise<VSCodeStatusResponse> {\n    return new VSCodeClient(\n      getAgentServerClientOptions({\n        conversationUrl,\n        sessionApiKey,\n      }),\n    ).getStatus();\n  }\n\n  static async resolveConversationWorkingDir(\n    conversationId: string,\n  ): Promise<string> {\n    const [conversation] = await this.batchGetAppConversations([\n      conversationId,\n    ]);\n    return conversation?.workspace?.working_dir ?? getAgentServerWorkingDir();\n  }\n\n  static async batchGetAppConversations(\n    ids: string[],\n  ): Promise<(AppConversation | null)[]> {\n    if (ids.length === 0) return [];\n\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return batchGetCloudConversations(ids);\n    }\n\n    const data = await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).getConversations<DirectConversationInfo>(ids);\n\n    return requireDirectConversationItems(data).map((item) =>\n      toAppConversation(item),\n    );\n  }\n\n  static async updateConversationPublicFlag(\n    conversationId: string,\n    isPublic: boolean,\n  ): Promise<AppConversation> {\n    if (getActiveBackend().backend.kind !== \"cloud\") {\n      throw new Error(\"Public sharing requires a cloud backend.\");\n    }\n    return updateCloudConversationPublicFlag(conversationId, isPublic);\n  }\n\n  static async updateConversationRepository(\n    conversationId: string,\n    repository: string | null,\n    branch?: string | null,\n    gitProvider?: string | null,\n  ): Promise<AppConversation> {\n    if (repository) {\n      const existing = getStoredConversationMetadata(conversationId);\n      setStoredConversationMetadata(conversationId, {\n        ...(existing ?? {}),\n        selected_repository: repository,\n        selected_branch: branch ?? null,\n        git_provider: (gitProvider as Provider | null | undefined) ?? null,\n      });\n    } else {\n      removeStoredConversationMetadata(conversationId);\n    }\n    const [conversation] = await this.batchGetAppConversations([\n      conversationId,\n    ]);\n    return requireAppConversation(conversation, conversationId);\n  }\n\n  static async readConversationFile(\n    conversationId: string,\n    filePath?: string,\n  ): Promise<string> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      // Cloud exposes a per-conversation file endpoint; the sandbox\n      // working dir is fixed (`/workspace/project`), so PLAN.md lives at\n      // a known absolute path. Mirrors OpenHands' readConversationFile.\n      const path = requirePathInsideDirectory(\n        filePath ?? \"/workspace/project/.agents_tmp/PLAN.md\",\n        \"/workspace/project\",\n      );\n      return readCloudConversationFile(conversationId, path);\n    }\n\n    const workingDir = await this.resolveConversationWorkingDir(conversationId);\n    const path = requirePathInsideDirectory(\n      filePath ?? `${workingDir}/.agents_tmp/PLAN.md`,\n      workingDir,\n    );\n    return new FileClient(getAgentServerClientOptions()).downloadTextFile(path);\n  }\n\n  static async downloadConversation(conversationId: string): Promise<Blob> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return downloadCloudConversation(conversationId);\n    }\n\n    return new FileClient(getAgentServerClientOptions()).downloadTrajectory(\n      conversationId,\n    );\n  }\n\n  static async getHooks(conversationId: string): Promise<GetHooksResponse> {\n    if (!conversationId) {\n      return emptyHooksResponse();\n    }\n    return emptyHooksResponse();\n  }\n\n  static async getRuntimeConversation(\n    conversationId: string,\n    conversationUrl: string | null | undefined,\n    sessionApiKey?: string | null,\n  ): Promise<RuntimeConversationInfo> {\n    // Fetch directly from the per-conversation runtime agent-server at conversationUrl.\n    const response = await new ConversationClient(\n      getAgentServerClientOptions({\n        conversationUrl,\n        sessionApiKey,\n      }),\n    ).getConversation<DirectConversationInfo>(conversationId);\n    const data = requireDirectConversationInfo(response);\n\n    return {\n      id: data.id,\n      title: data.title?.trim()\n        ? data.title\n        : getDefaultConversationTitle(data.id),\n      metrics: normalizeMetrics(data.metrics),\n      created_at: data.created_at,\n      updated_at: data.updated_at,\n      status: toRuntimeStatus(data.execution_status),\n      stats: data.stats ?? { usage_to_metrics: {} },\n    };\n  }\n\n  /**\n   * Force condensation (\"compact\") of the conversation history via\n   * `POST /api/conversations/{id}/condense`. Routed the same way as\n   * {@link sendMessage}: through the cloud proxy at the conversation's own\n   * runtime host for cloud backends, directly against that runtime otherwise.\n   */\n  static async condenseConversation(\n    conversationId: string,\n    conversationUrl: string | null | undefined,\n    sessionApiKey?: string | null,\n  ): Promise<void> {\n    const active = getActiveBackend().backend;\n\n    if (active.kind === \"cloud\" && conversationUrl) {\n      await callCloudProxy({\n        backend: active,\n        method: \"POST\",\n        hostOverride: buildHttpBaseUrl(conversationUrl),\n        path: `/api/conversations/${conversationId}/condense`,\n        authMode: \"session-api-key\",\n        sessionApiKey,\n      });\n      return;\n    }\n\n    await new ConversationClient(\n      getAgentServerClientOptions({ conversationUrl, sessionApiKey }),\n    ).condenseConversation(conversationId);\n  }\n\n  static async searchConversations(\n    limit: number = 20,\n    pageId?: string,\n  ): Promise<AppConversationPage> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return searchCloudConversations(limit, pageId);\n    }\n\n    const data = await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).searchConversations({\n      limit,\n      page_id: pageId,\n      sort_order: ConversationSortOrder.UPDATED_AT_DESC,\n    });\n\n    return toConversationPage(requireConversationSearchPage(data));\n  }\n\n  static async deleteConversation(conversationId: string): Promise<void> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      await deleteCloudConversation(conversationId);\n      removeStoredConversationMetadata(conversationId);\n      return;\n    }\n\n    // The agent-server orphans children rather than cascading, and the local\n    // planner helper is hidden from the conversation list by its\n    // `plannerparent` tag — so without this it would survive its parent as an\n    // invisible, unreachable conversation (plus its events and state).\n    const planningConversationIds =\n      await this.getLocalPlanningConversationIds(conversationId);\n\n    const client = new ConversationClient(getAgentServerClientOptions());\n    await Promise.all(\n      planningConversationIds.map(async (planningConversationId) => {\n        try {\n          await client.deleteConversation(planningConversationId);\n        } catch (error) {\n          // Already gone (or unreachable): never block deleting the parent the\n          // user actually asked to remove.\n          console.warn(\n            `Failed to delete planning conversation ${planningConversationId}`,\n            error,\n          );\n        }\n        removeStoredConversationMetadata(planningConversationId);\n      }),\n    );\n\n    await client.deleteConversation(conversationId);\n    removeStoredConversationMetadata(conversationId);\n  }\n\n  static async updateConversationTitle(\n    conversationId: string,\n    title: string,\n  ): Promise<AppConversation> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      return updateCloudConversationTitle(conversationId, title);\n    }\n\n    await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).updateConversation(conversationId, {\n      title,\n    });\n    const [conversation] = await this.batchGetAppConversations([\n      conversationId,\n    ]);\n    return requireAppConversation(conversation, conversationId);\n  }\n\n  /**\n   * Replaces the conversation's complete server-side tag map (the PATCH is\n   * replace-all, so callers must merge user edits with any reserved/internal\n   * keys before calling). Mirrors `updateConversationTitle`; local\n   * agent-server conversations only — Cloud conversations don't carry tags.\n   */\n  static async updateConversationTags(\n    conversationId: string,\n    tags: Record<string, string>,\n  ): Promise<AppConversation> {\n    await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).updateConversation(conversationId, {\n      tags,\n    });\n    const [conversation] = await this.batchGetAppConversations([\n      conversationId,\n    ]);\n    return requireAppConversation(conversation, conversationId);\n  }\n\n  /**\n   * Forks a conversation, copying event history up to and including\n   * `fromEventId`. Local agent-server only; needs agent-server >= 1.31.0 for\n   * `from_event_id` (older backends copy the whole conversation).\n   */\n  static async forkConversation(\n    sourceConversationId: string,\n    fromEventId: string,\n    title?: string,\n  ): Promise<DirectConversationInfo> {\n    if (getActiveBackend().backend.kind === \"cloud\") {\n      throw new Error(\n        \"Branching a conversation isn't supported on the cloud backend yet.\",\n      );\n    }\n\n    // `from_event_id` is accepted by `/fork` but not yet typed in\n    // ForkConversationRequest (through client 1.32.0); the client forwards the\n    // body verbatim, so cast to carry it. A title also suppresses the backend\n    // auto-title, so the \"(branch)\" marker sticks.\n    const data = await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).forkConversation<DirectConversationInfo>(sourceConversationId, {\n      from_event_id: fromEventId,\n      ...(title ? { title } : {}),\n    } as ForkConversationRequest & { from_event_id: string });\n\n    // Carry over the source's client-side metadata (repo/branch/workspace/\n    // profile/plugins) so the fork hydrates its chat-page badges the same way.\n    const sourceMetadata = getStoredConversationMetadata(sourceConversationId);\n    if (sourceMetadata) {\n      setStoredConversationMetadata(data.id, sourceMetadata);\n    }\n\n    return data;\n  }\n\n  /**\n   * Returns an event's `parent_id` (the fork point for branching *before* it),\n   * or undefined at the root. Uses the single-event endpoint because the events\n   * *search* API omits `parent_id`.\n   */\n  static async getEventParentId(\n    conversationId: string,\n    eventId: string,\n  ): Promise<string | undefined> {\n    const event = (await new ConversationClient(\n      getAgentServerClientOptions(),\n    ).getEvent(conversationId, eventId)) as { parent_id?: string | null };\n    return event.parent_id ?? undefined;\n  }\n\n  /**\n   * Switches the LLM profile for the running conversation when one is open\n   * (POST /switch_profile — per-conversation swap, doesn't change the user's\n   * default profile). When called without a conversationId (home page),\n   * falls back to POST /activate so the next conversation created picks up\n   * the chosen profile.\n   *\n   * The per-conversation endpoint accepts only the profile name, so the UI does\n   * not need to fetch or forward profile secrets. That keeps switching working\n   * even when the agent server has no OH_SECRET_KEY for encrypted secret export.\n   *\n   * Cloud backends route to the app-server's per-conversation\n   * `/switch_profile`, which owns the profiles and resolves the swap\n   * server-side (base_url/api_key fixups, usage_id derivation, then the\n   * agent-server's switch_llm) — so the client only forwards the profile name,\n   * mirroring {@link switchAcpModel}.\n   */\n  static async switchProfile(\n    conversationId: string | null,\n    profileName: string,\n  ): Promise<void> {\n    const { backend } = getActiveBackend();\n\n    if (backend.kind === \"cloud\") {\n      // No conversation (home page): activate globally so the next\n      // conversation starts with it. ProfilesService routes to the cloud\n      // activate endpoint.\n      if (!conversationId) {\n        await ProfilesService.activateProfile(profileName);\n        return;\n      }\n      await callCloudProxy({\n        backend,\n        method: \"POST\",\n        path: `/api/v1/app-conversations/${conversationId}/switch_profile`,\n        body: { profile_name: profileName },\n      });\n      return;\n    }\n\n    if (!conversationId) {\n      await new ProfilesClient(getAgentServerClientOptions()).activateProfile(\n        profileName,\n      );\n      return;\n    }\n\n    const clientOptions = getAgentServerClientOptions();\n    const conversationClient = new ConversationClient(clientOptions);\n    const profile = await new ProfilesClient(clientOptions).getProfile(\n      profileName,\n      { exposeSecrets: \"encrypted\" },\n    );\n    const model =\n      typeof profile.config.model === \"string\" ? profile.config.model : \"\";\n    if (!model) throw new Error(`Profile '${profileName}' has no model.`);\n    await assertSubscriptionAuthReady({ llm: profile.config });\n    await conversationClient.switchLLM(conversationId, {\n      ...profile.config,\n      model,\n      // Keep streaming on after a switch (parity with conversation start);\n      // the profile config would otherwise default it to stream=False.\n      stream: true,\n      // Avoid stale first-write-wins entries in the backend LLM registry.\n      usage_id: `profile:${profileName}:${uuidv4()}`,\n    } as LLMConfig);\n  }\n\n  /**\n   * Switches the model of a running ACP conversation in place (POST\n   * /switch_acp_model — the ACP analog of {@link switchProfile}'s /switch_profile).\n   * The agent-server calls the ACP wrapper's ``session/set_model`` on the live\n   * session, preserving context. Mirrors {@link switchProfile}'s\n   * local-backend-only guard and per-conversation ConversationClient call.\n   *\n   * Works on a created-but-not-yet-run conversation too: the agent-server\n   * treats a pre-first-run switch as a persist-only deferral (the model is\n   * mirrored into the conversation's stored agent and applied when the session\n   * starts). The home/no-conversation default is persisted via the active ACP\n   * profile / Settings instead (see ``use-switch-acp-model``).\n   */\n  static async switchAcpModel(\n    conversationId: string,\n    model: string,\n  ): Promise<void> {\n    const { backend } = getActiveBackend();\n    if (backend.kind === \"cloud\") {\n      await callCloudProxy({\n        backend,\n        method: \"POST\",\n        path: `/api/v1/app-conversations/${conversationId}/switch_acp_model`,\n        body: { model },\n      });\n      return;\n    }\n\n    await new ConversationClient(getAgentServerClientOptions()).switchAcpModel(\n      conversationId,\n      model,\n    );\n  }\n}\n\nexport default AgentServerConversationService;\n"],"mappings":"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"}

package/dist/api/hooks-service.cjs

@@ -0,0 +1,2 @@
+require("../_virtual/_rolldown/runtime.cjs");const e=require("../node_modules/@openhands/typescript-client/dist/client/hooks-client.cjs");require("../node_modules/@openhands/typescript-client/dist/clients.cjs");const t=require("./agent-server-config.cjs"),n=require("./backend-registry/active-store.cjs"),r=require("./agent-server-client-options.cjs");var i=5e3,a=class{static async loadWorkspaceHooks(a){if(!n.getEffectiveLocalBackend())return null;try{return(await new e.HooksClient(r.getAgentServerClientOptions({timeout:i})).loadHooks({project_dir:a??t.getAgentServerWorkingDir()}))?.hook_config??null}catch(e){return console.warn(`Failed to load workspace hooks, continuing without:`,e),null}}};exports.default=a;
+//# sourceMappingURL=hooks-service.cjs.map

package/dist/api/hooks-service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-service.cjs","names":[],"sources":["../../src/api/hooks-service.ts"],"sourcesContent":["import { HooksClient } from \"@openhands/typescript-client/clients\";\nimport type { HookConfig } from \"@openhands/typescript-client\";\nimport { getAgentServerWorkingDir } from \"./agent-server-config\";\nimport { getEffectiveLocalBackend } from \"./backend-registry/active-store\";\nimport { getAgentServerClientOptions } from \"./agent-server-client-options\";\n\n// `loadHooks()` spends this twice (version probe, then the call) on the\n// conversation-start critical path; the SDK's 60s default would stall a launch.\nconst HOOKS_LOAD_TIMEOUT_MS = 5000;\n\nclass HooksService {\n  /**\n   * Load workspace hooks from the agent-server by calling POST /api/hooks.\n   * Returns the HookConfig if the workspace has hooks, or null.\n   * Gracefully returns null when no usable local backend is available\n   * (cloud backend, unseeded registry, or older agent-server).\n   * `projectDir` must be the workspace root: the agent-server checks\n   * `<project_dir>/.openhands/hooks.json` literally and never walks parents.\n   */\n  static async loadWorkspaceHooks(\n    projectDir?: string,\n  ): Promise<HookConfig | null> {\n    // getEffectiveLocalBackend() returns null for cloud backends AND for the\n    // NO_BACKEND sentinel (unseeded/empty registry), avoiding the silent\n    // NoBackendAvailableError that getActiveBackend() would cause.\n    if (!getEffectiveLocalBackend()) {\n      return null;\n    }\n\n    try {\n      const response = await new HooksClient(\n        getAgentServerClientOptions({ timeout: HOOKS_LOAD_TIMEOUT_MS }),\n      ).loadHooks({\n        project_dir: projectDir ?? getAgentServerWorkingDir(),\n      });\n      return response?.hook_config ?? null;\n    } catch (error) {\n      // Agent-server may not support the hooks endpoint or may be\n      // unreachable; gracefully fall back to null.\n      console.warn(\n        \"Failed to load workspace hooks, continuing without:\",\n        error,\n      );\n      return null;\n    }\n  }\n}\n\nexport default HooksService;\n"],"mappings":"gWAQA,IAAM,EAAwB,IAExB,EAAN,KAAmB,CASjB,aAAa,mBACX,EAC4B,CAI5B,GAAI,CAAC,EAAA,yBAAyB,EAC5B,OAAO,KAGT,GAAI,CAMF,OAAO,MALgB,IAAI,EAAA,YACzB,EAAA,4BAA4B,CAAE,QAAS,CAAsB,CAAC,CAChE,EAAE,UAAU,CACV,YAAa,GAAc,EAAA,yBAAyB,CACtD,CAAC,IACgB,aAAe,IAClC,OAAS,EAAO,CAOd,OAJA,QAAQ,KACN,sDACA,CACF,EACO,IACT,CACF,CACF"}

package/dist/api/hooks-service.d.ts

@@ -0,0 +1,13 @@
+import type { HookConfig } from "@openhands/typescript-client";
+declare class HooksService {
+    /**
+     * Load workspace hooks from the agent-server by calling POST /api/hooks.
+     * Returns the HookConfig if the workspace has hooks, or null.
+     * Gracefully returns null when no usable local backend is available
+     * (cloud backend, unseeded registry, or older agent-server).
+     * `projectDir` must be the workspace root: the agent-server checks
+     * `<project_dir>/.openhands/hooks.json` literally and never walks parents.
+     */
+    static loadWorkspaceHooks(projectDir?: string): Promise<HookConfig | null>;
+}
+export default HooksService;

package/dist/api/hooks-service.js

@@ -0,0 +1,20 @@
+import { HooksClient as e } from "../node_modules/@openhands/typescript-client/dist/client/hooks-client.js";
+import "../node_modules/@openhands/typescript-client/dist/clients.js";
+import { getAgentServerWorkingDir as t } from "./agent-server-config.js";
+import { getEffectiveLocalBackend as n } from "./backend-registry/active-store.js";
+import { getAgentServerClientOptions as r } from "./agent-server-client-options.js";
+//#region src/api/hooks-service.ts
+var i = 5e3, a = class {
+	static async loadWorkspaceHooks(a) {
+		if (!n()) return null;
+		try {
+			return (await new e(r({ timeout: i })).loadHooks({ project_dir: a ?? t() }))?.hook_config ?? null;
+		} catch (e) {
+			return console.warn("Failed to load workspace hooks, continuing without:", e), null;
+		}
+	}
+};
+//#endregion
+export { a as default };
+
+//# sourceMappingURL=hooks-service.js.map

package/dist/api/hooks-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-service.js","names":[],"sources":["../../src/api/hooks-service.ts"],"sourcesContent":["import { HooksClient } from \"@openhands/typescript-client/clients\";\nimport type { HookConfig } from \"@openhands/typescript-client\";\nimport { getAgentServerWorkingDir } from \"./agent-server-config\";\nimport { getEffectiveLocalBackend } from \"./backend-registry/active-store\";\nimport { getAgentServerClientOptions } from \"./agent-server-client-options\";\n\n// `loadHooks()` spends this twice (version probe, then the call) on the\n// conversation-start critical path; the SDK's 60s default would stall a launch.\nconst HOOKS_LOAD_TIMEOUT_MS = 5000;\n\nclass HooksService {\n  /**\n   * Load workspace hooks from the agent-server by calling POST /api/hooks.\n   * Returns the HookConfig if the workspace has hooks, or null.\n   * Gracefully returns null when no usable local backend is available\n   * (cloud backend, unseeded registry, or older agent-server).\n   * `projectDir` must be the workspace root: the agent-server checks\n   * `<project_dir>/.openhands/hooks.json` literally and never walks parents.\n   */\n  static async loadWorkspaceHooks(\n    projectDir?: string,\n  ): Promise<HookConfig | null> {\n    // getEffectiveLocalBackend() returns null for cloud backends AND for the\n    // NO_BACKEND sentinel (unseeded/empty registry), avoiding the silent\n    // NoBackendAvailableError that getActiveBackend() would cause.\n    if (!getEffectiveLocalBackend()) {\n      return null;\n    }\n\n    try {\n      const response = await new HooksClient(\n        getAgentServerClientOptions({ timeout: HOOKS_LOAD_TIMEOUT_MS }),\n      ).loadHooks({\n        project_dir: projectDir ?? getAgentServerWorkingDir(),\n      });\n      return response?.hook_config ?? null;\n    } catch (error) {\n      // Agent-server may not support the hooks endpoint or may be\n      // unreachable; gracefully fall back to null.\n      console.warn(\n        \"Failed to load workspace hooks, continuing without:\",\n        error,\n      );\n      return null;\n    }\n  }\n}\n\nexport default HooksService;\n"],"mappings":";;;;;;AAQA,IAAM,IAAwB,KAExB,IAAN,MAAmB;CASjB,aAAa,mBACX,GAC4B;EAI5B,IAAI,CAAC,EAAyB,GAC5B,OAAO;EAGT,IAAI;GAMF,QAAO,MALgB,IAAI,EACzB,EAA4B,EAAE,SAAS,EAAsB,CAAC,CAChE,EAAE,UAAU,EACV,aAAa,KAAc,EAAyB,EACtD,CAAC,IACgB,eAAe;EAClC,SAAS,GAAO;GAOd,OAJA,QAAQ,KACN,uDACA,CACF,GACO;EACT;CACF;AACF"}

package/dist/api/provider-connections-service/provider-connections-service.api.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/openhands-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const t=require("../agent-server-client-options.cjs");var n=`/api/llm/provider-connections`;function r(){let{host:n,apiKey:r}=t.getAgentServerClientOptions();return new e.AgentServerClient({host:n,...r?{apiKey:r}:{}})}var i=class{static async list(){let e=r();try{return await e.get(n,{responseType:`json`})}finally{e.close()}}static async create(e){let t=r();try{return await t.post(n,e,{responseType:`json`})}finally{t.close()}}static async update(e,t){let i=r();try{return await i.patch(`${n}/${encodeURIComponent(e)}`,t,{responseType:`json`})}finally{i.close()}}static async delete(e){let t=r();try{return await t.delete(`${n}/${encodeURIComponent(e)}`,{responseType:`json`})}finally{t.close()}}};exports.default=i;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/openhands-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const t=require("../backend-registry/active-store.cjs"),n=require("../agent-server-client-options.cjs"),r=require("../cloud/provider-connections-service.api.cjs");var i=`/api/llm/provider-connections`;function a(){return t.getActiveBackend().backend.kind===`cloud`}function o(){let{host:t,apiKey:r}=n.getAgentServerClientOptions();return new e.AgentServerClient({host:t,...r?{apiKey:r}:{}})}var s=class{static async list(){if(a())return r.fetchCloudProviderConnections();let e=o();try{return await e.get(i,{responseType:`json`})}finally{e.close()}}static async create(e){if(a())return r.createCloudProviderConnection(e);let t=o();try{return await t.post(i,e,{responseType:`json`})}finally{t.close()}}static async update(e,t){if(a())return r.updateCloudProviderConnection(e,t);let n=o();try{return await n.patch(`${i}/${encodeURIComponent(e)}`,t,{responseType:`json`})}finally{n.close()}}static async delete(e){if(a())return r.deleteCloudProviderConnection(e);let t=o();try{return await t.delete(`${i}/${encodeURIComponent(e)}`,{responseType:`json`})}finally{t.close()}}};exports.default=s;
 //# sourceMappingURL=provider-connections-service.api.cjs.map

package/dist/api/provider-connections-service/provider-connections-service.api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"provider-connections-service.api.cjs","names":[],"sources":["../../../src/api/provider-connections-service/provider-connections-service.api.ts"],"sourcesContent":["/**\n * ProviderConnectionsService is a thin wrapper over the local agent-server's\n * `/api/llm/provider-connections` CRUD endpoints. A provider connection is a\n * shared `api_key` + optional `base_url` that one or more LLM profiles\n * reference by id; the agent-server resolves the credential into a runnable LLM\n * at profile-load time, so this service only manages the stored connections.\n *\n * These endpoints exist only on the agent-server (local backend). Cloud has no\n * equivalent yet, so callers must gate usage on `backend.kind === \"local\"`.\n *\n * There is no generated client for these routes in `@openhands/typescript-client`\n * yet, so requests go through the generic `AgentServerClient` verb helpers —\n * the same approach `LLMBalanceService` uses.\n */\nimport { AgentServerClient } from \"@openhands/typescript-client/clients\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\n\nconst PROVIDER_CONNECTIONS_PATH = \"/api/llm/provider-connections\";\n\nexport interface ProviderConnection {\n  id: string;\n  display_name: string;\n  provider: string;\n  base_url: string | null;\n  created_at: number;\n  updated_at: number;\n  /** Whether the stored connection currently holds a usable key. */\n  api_key_set: boolean;\n}\n\nexport interface CreateProviderConnectionRequest {\n  display_name: string;\n  provider: string;\n  api_key: string;\n  base_url?: string | null;\n}\n\n/**\n * Partial update. Only the provided fields change. `api_key` may be sent to\n * rotate the key; the agent-server rejects `api_key: null` (a connection must\n * always keep a key), so callers omit it to leave the key unchanged.\n */\nexport interface UpdateProviderConnectionRequest {\n  display_name?: string;\n  provider?: string;\n  api_key?: string;\n  base_url?: string | null;\n}\n\nfunction createClient(): AgentServerClient {\n  const { host, apiKey } = getAgentServerClientOptions();\n  return new AgentServerClient({ host, ...(apiKey ? { apiKey } : {}) });\n}\n\nclass ProviderConnectionsService {\n  static async list(): Promise<ProviderConnection[]> {\n    const client = createClient();\n    try {\n      return await client.get<ProviderConnection[]>(PROVIDER_CONNECTIONS_PATH, {\n        responseType: \"json\",\n      });\n    } finally {\n      client.close();\n    }\n  }\n\n  static async create(\n    request: CreateProviderConnectionRequest,\n  ): Promise<ProviderConnection> {\n    const client = createClient();\n    try {\n      return await client.post<ProviderConnection>(\n        PROVIDER_CONNECTIONS_PATH,\n        request,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n\n  static async update(\n    id: string,\n    request: UpdateProviderConnectionRequest,\n  ): Promise<ProviderConnection> {\n    const client = createClient();\n    try {\n      return await client.patch<ProviderConnection>(\n        `${PROVIDER_CONNECTIONS_PATH}/${encodeURIComponent(id)}`,\n        request,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n\n  static async delete(id: string): Promise<ProviderConnection> {\n    const client = createClient();\n    try {\n      return await client.delete<ProviderConnection>(\n        `${PROVIDER_CONNECTIONS_PATH}/${encodeURIComponent(id)}`,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n}\n\nexport default ProviderConnectionsService;\n"],"mappings":"sRAiBA,IAAM,EAA4B,gCAgClC,SAAS,GAAkC,CACzC,GAAM,CAAE,OAAM,UAAW,EAAA,4BAA4B,EACrD,OAAO,IAAI,EAAA,kBAAkB,CAAE,OAAM,GAAI,EAAS,CAAE,QAAO,EAAI,CAAC,CAAG,CAAC,CACtE,CAEA,IAAM,EAAN,KAAiC,CAC/B,aAAa,MAAsC,CACjD,IAAM,EAAS,EAAa,EAC5B,GAAI,CACF,OAAO,MAAM,EAAO,IAA0B,EAA2B,CACvE,aAAc,MAChB,CAAC,CACH,QAAU,CACR,EAAO,MAAM,CACf,CACF,CAEA,aAAa,OACX,EAC6B,CAC7B,IAAM,EAAS,EAAa,EAC5B,GAAI,CACF,OAAO,MAAM,EAAO,KAClB,EACA,EACA,CAAE,aAAc,MAAO,CACzB,CACF,QAAU,CACR,EAAO,MAAM,CACf,CACF,CAEA,aAAa,OACX,EACA,EAC6B,CAC7B,IAAM,EAAS,EAAa,EAC5B,GAAI,CACF,OAAO,MAAM,EAAO,MAClB,GAAG,EAA0B,GAAG,mBAAmB,CAAE,IACrD,EACA,CAAE,aAAc,MAAO,CACzB,CACF,QAAU,CACR,EAAO,MAAM,CACf,CACF,CAEA,aAAa,OAAO,EAAyC,CAC3D,IAAM,EAAS,EAAa,EAC5B,GAAI,CACF,OAAO,MAAM,EAAO,OAClB,GAAG,EAA0B,GAAG,mBAAmB,CAAE,IACrD,CAAE,aAAc,MAAO,CACzB,CACF,QAAU,CACR,EAAO,MAAM,CACf,CACF,CACF"}
+{"version":3,"file":"provider-connections-service.api.cjs","names":[],"sources":["../../../src/api/provider-connections-service/provider-connections-service.api.ts"],"sourcesContent":["/**\n * ProviderConnectionsService is the single entry point for provider-connection\n * CRUD, routing per active backend so callers (hooks, the settings manager)\n * stay backend-agnostic. A provider connection is a shared `api_key` + optional\n * `base_url` that one or more LLM profiles reference by id; the backend resolves\n * the credential into a runnable LLM at profile-load time, so this service only\n * manages the stored connections.\n *\n * - local agent-server: the `/api/llm/provider-connections` CRUD endpoints via\n *   the generic `AgentServerClient` verb helpers (the same approach\n *   `LLMBalanceService` uses; there is no generated client for these routes in\n *   `@openhands/typescript-client` yet);\n * - cloud app-server: `src/api/cloud/provider-connections-service.api.ts` (the\n *   org-gated `/api/organizations/{orgId}/provider-connections` routes) via the\n *   org-scoped cloud proxy.\n *\n * This mirrors how `ProfilesService` branches to the cloud profile service.\n */\nimport { AgentServerClient } from \"@openhands/typescript-client/clients\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport {\n  fetchCloudProviderConnections,\n  createCloudProviderConnection,\n  updateCloudProviderConnection,\n  deleteCloudProviderConnection,\n} from \"../cloud/provider-connections-service.api\";\n\nconst PROVIDER_CONNECTIONS_PATH = \"/api/llm/provider-connections\";\n\nfunction isCloudBackend(): boolean {\n  return getActiveBackend().backend.kind === \"cloud\";\n}\n\nexport interface ProviderConnection {\n  id: string;\n  display_name: string;\n  provider: string;\n  base_url: string | null;\n  created_at: number;\n  updated_at: number;\n  /** Whether the stored connection currently holds a usable key. */\n  api_key_set: boolean;\n}\n\nexport interface CreateProviderConnectionRequest {\n  display_name: string;\n  provider: string;\n  api_key: string;\n  base_url?: string | null;\n}\n\n/**\n * Partial update. Only the provided fields change. `api_key` may be sent to\n * rotate the key; the agent-server rejects `api_key: null` (a connection must\n * always keep a key), so callers omit it to leave the key unchanged.\n */\nexport interface UpdateProviderConnectionRequest {\n  display_name?: string;\n  provider?: string;\n  api_key?: string;\n  base_url?: string | null;\n}\n\nfunction createClient(): AgentServerClient {\n  const { host, apiKey } = getAgentServerClientOptions();\n  return new AgentServerClient({ host, ...(apiKey ? { apiKey } : {}) });\n}\n\nclass ProviderConnectionsService {\n  static async list(): Promise<ProviderConnection[]> {\n    if (isCloudBackend()) return fetchCloudProviderConnections();\n    const client = createClient();\n    try {\n      return await client.get<ProviderConnection[]>(PROVIDER_CONNECTIONS_PATH, {\n        responseType: \"json\",\n      });\n    } finally {\n      client.close();\n    }\n  }\n\n  static async create(\n    request: CreateProviderConnectionRequest,\n  ): Promise<ProviderConnection> {\n    if (isCloudBackend()) return createCloudProviderConnection(request);\n    const client = createClient();\n    try {\n      return await client.post<ProviderConnection>(\n        PROVIDER_CONNECTIONS_PATH,\n        request,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n\n  static async update(\n    id: string,\n    request: UpdateProviderConnectionRequest,\n  ): Promise<ProviderConnection> {\n    if (isCloudBackend()) return updateCloudProviderConnection(id, request);\n    const client = createClient();\n    try {\n      return await client.patch<ProviderConnection>(\n        `${PROVIDER_CONNECTIONS_PATH}/${encodeURIComponent(id)}`,\n        request,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n\n  static async delete(id: string): Promise<ProviderConnection> {\n    if (isCloudBackend()) return deleteCloudProviderConnection(id);\n    const client = createClient();\n    try {\n      return await client.delete<ProviderConnection>(\n        `${PROVIDER_CONNECTIONS_PATH}/${encodeURIComponent(id)}`,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n}\n\nexport default ProviderConnectionsService;\n"],"mappings":"mYA4BA,IAAM,EAA4B,gCAElC,SAAS,GAA0B,CACjC,OAAO,EAAA,iBAAiB,EAAE,QAAQ,OAAS,OAC7C,CAgCA,SAAS,GAAkC,CACzC,GAAM,CAAE,OAAM,UAAW,EAAA,4BAA4B,EACrD,OAAO,IAAI,EAAA,kBAAkB,CAAE,OAAM,GAAI,EAAS,CAAE,QAAO,EAAI,CAAC,CAAG,CAAC,CACtE,CAEA,IAAM,EAAN,KAAiC,CAC/B,aAAa,MAAsC,CACjD,GAAI,EAAe,EAAG,OAAO,EAAA,8BAA8B,EAC3D,IAAM,EAAS,EAAa,EAC5B,GAAI,CACF,OAAO,MAAM,EAAO,IAA0B,EAA2B,CACvE,aAAc,MAChB,CAAC,CACH,QAAU,CACR,EAAO,MAAM,CACf,CACF,CAEA,aAAa,OACX,EAC6B,CAC7B,GAAI,EAAe,EAAG,OAAO,EAAA,8BAA8B,CAAO,EAClE,IAAM,EAAS,EAAa,EAC5B,GAAI,CACF,OAAO,MAAM,EAAO,KAClB,EACA,EACA,CAAE,aAAc,MAAO,CACzB,CACF,QAAU,CACR,EAAO,MAAM,CACf,CACF,CAEA,aAAa,OACX,EACA,EAC6B,CAC7B,GAAI,EAAe,EAAG,OAAO,EAAA,8BAA8B,EAAI,CAAO,EACtE,IAAM,EAAS,EAAa,EAC5B,GAAI,CACF,OAAO,MAAM,EAAO,MAClB,GAAG,EAA0B,GAAG,mBAAmB,CAAE,IACrD,EACA,CAAE,aAAc,MAAO,CACzB,CACF,QAAU,CACR,EAAO,MAAM,CACf,CACF,CAEA,aAAa,OAAO,EAAyC,CAC3D,GAAI,EAAe,EAAG,OAAO,EAAA,8BAA8B,CAAE,EAC7D,IAAM,EAAS,EAAa,EAC5B,GAAI,CACF,OAAO,MAAM,EAAO,OAClB,GAAG,EAA0B,GAAG,mBAAmB,CAAE,IACrD,CAAE,aAAc,MAAO,CACzB,CACF,QAAU,CACR,EAAO,MAAM,CACf,CACF,CACF"}

package/dist/api/provider-connections-service/provider-connections-service.api.js

@@ -1,50 +1,59 @@
 import { AgentServerClient as e } from "../../node_modules/@openhands/typescript-client/dist/client/openhands-client.js";
 import "../../node_modules/@openhands/typescript-client/dist/clients.js";
-import { getAgentServerClientOptions as t } from "../agent-server-client-options.js";
+import { getActiveBackend as t } from "../backend-registry/active-store.js";
+import { getAgentServerClientOptions as n } from "../agent-server-client-options.js";
+import { createCloudProviderConnection as r, deleteCloudProviderConnection as i, fetchCloudProviderConnections as a, updateCloudProviderConnection as o } from "../cloud/provider-connections-service.api.js";
 //#region src/api/provider-connections-service/provider-connections-service.api.ts
-var n = "/api/llm/provider-connections";
-function r() {
-	let { host: n, apiKey: r } = t();
+var s = "/api/llm/provider-connections";
+function c() {
+	return t().backend.kind === "cloud";
+}
+function l() {
+	let { host: t, apiKey: r } = n();
 	return new e({
-		host: n,
+		host: t,
 		...r ? { apiKey: r } : {}
 	});
 }
-var i = class {
+var u = class {
 	static async list() {
-		let e = r();
+		if (c()) return a();
+		let e = l();
 		try {
-			return await e.get(n, { responseType: "json" });
+			return await e.get(s, { responseType: "json" });
 		} finally {
 			e.close();
 		}
 	}
 	static async create(e) {
-		let t = r();
+		if (c()) return r(e);
+		let t = l();
 		try {
-			return await t.post(n, e, { responseType: "json" });
+			return await t.post(s, e, { responseType: "json" });
 		} finally {
 			t.close();
 		}
 	}
 	static async update(e, t) {
-		let i = r();
+		if (c()) return o(e, t);
+		let n = l();
 		try {
-			return await i.patch(`${n}/${encodeURIComponent(e)}`, t, { responseType: "json" });
+			return await n.patch(`${s}/${encodeURIComponent(e)}`, t, { responseType: "json" });
 		} finally {
-			i.close();
+			n.close();
 		}
 	}
 	static async delete(e) {
-		let t = r();
+		if (c()) return i(e);
+		let t = l();
 		try {
-			return await t.delete(`${n}/${encodeURIComponent(e)}`, { responseType: "json" });
+			return await t.delete(`${s}/${encodeURIComponent(e)}`, { responseType: "json" });
 		} finally {
 			t.close();
 		}
 	}
 };
 //#endregion
-export { i as default };
+export { u as default };
 
 //# sourceMappingURL=provider-connections-service.api.js.map

package/dist/api/provider-connections-service/provider-connections-service.api.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-connections-service.api.js","names":[],"sources":["../../../src/api/provider-connections-service/provider-connections-service.api.ts"],"sourcesContent":["/**\n * ProviderConnectionsService is a thin wrapper over the local agent-server's\n * `/api/llm/provider-connections` CRUD endpoints. A provider connection is a\n * shared `api_key` + optional `base_url` that one or more LLM profiles\n * reference by id; the agent-server resolves the credential into a runnable LLM\n * at profile-load time, so this service only manages the stored connections.\n *\n * These endpoints exist only on the agent-server (local backend). Cloud has no\n * equivalent yet, so callers must gate usage on `backend.kind === \"local\"`.\n *\n * There is no generated client for these routes in `@openhands/typescript-client`\n * yet, so requests go through the generic `AgentServerClient` verb helpers —\n * the same approach `LLMBalanceService` uses.\n */\nimport { AgentServerClient } from \"@openhands/typescript-client/clients\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\n\nconst PROVIDER_CONNECTIONS_PATH = \"/api/llm/provider-connections\";\n\nexport interface ProviderConnection {\n  id: string;\n  display_name: string;\n  provider: string;\n  base_url: string | null;\n  created_at: number;\n  updated_at: number;\n  /** Whether the stored connection currently holds a usable key. */\n  api_key_set: boolean;\n}\n\nexport interface CreateProviderConnectionRequest {\n  display_name: string;\n  provider: string;\n  api_key: string;\n  base_url?: string | null;\n}\n\n/**\n * Partial update. Only the provided fields change. `api_key` may be sent to\n * rotate the key; the agent-server rejects `api_key: null` (a connection must\n * always keep a key), so callers omit it to leave the key unchanged.\n */\nexport interface UpdateProviderConnectionRequest {\n  display_name?: string;\n  provider?: string;\n  api_key?: string;\n  base_url?: string | null;\n}\n\nfunction createClient(): AgentServerClient {\n  const { host, apiKey } = getAgentServerClientOptions();\n  return new AgentServerClient({ host, ...(apiKey ? { apiKey } : {}) });\n}\n\nclass ProviderConnectionsService {\n  static async list(): Promise<ProviderConnection[]> {\n    const client = createClient();\n    try {\n      return await client.get<ProviderConnection[]>(PROVIDER_CONNECTIONS_PATH, {\n        responseType: \"json\",\n      });\n    } finally {\n      client.close();\n    }\n  }\n\n  static async create(\n    request: CreateProviderConnectionRequest,\n  ): Promise<ProviderConnection> {\n    const client = createClient();\n    try {\n      return await client.post<ProviderConnection>(\n        PROVIDER_CONNECTIONS_PATH,\n        request,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n\n  static async update(\n    id: string,\n    request: UpdateProviderConnectionRequest,\n  ): Promise<ProviderConnection> {\n    const client = createClient();\n    try {\n      return await client.patch<ProviderConnection>(\n        `${PROVIDER_CONNECTIONS_PATH}/${encodeURIComponent(id)}`,\n        request,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n\n  static async delete(id: string): Promise<ProviderConnection> {\n    const client = createClient();\n    try {\n      return await client.delete<ProviderConnection>(\n        `${PROVIDER_CONNECTIONS_PATH}/${encodeURIComponent(id)}`,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n}\n\nexport default ProviderConnectionsService;\n"],"mappings":";;;;AAiBA,IAAM,IAA4B;AAgClC,SAAS,IAAkC;CACzC,IAAM,EAAE,SAAM,cAAW,EAA4B;CACrD,OAAO,IAAI,EAAkB;EAAE;EAAM,GAAI,IAAS,EAAE,UAAO,IAAI,CAAC;CAAG,CAAC;AACtE;AAEA,IAAM,IAAN,MAAiC;CAC/B,aAAa,OAAsC;EACjD,IAAM,IAAS,EAAa;EAC5B,IAAI;GACF,OAAO,MAAM,EAAO,IAA0B,GAA2B,EACvE,cAAc,OAChB,CAAC;EACH,UAAU;GACR,EAAO,MAAM;EACf;CACF;CAEA,aAAa,OACX,GAC6B;EAC7B,IAAM,IAAS,EAAa;EAC5B,IAAI;GACF,OAAO,MAAM,EAAO,KAClB,GACA,GACA,EAAE,cAAc,OAAO,CACzB;EACF,UAAU;GACR,EAAO,MAAM;EACf;CACF;CAEA,aAAa,OACX,GACA,GAC6B;EAC7B,IAAM,IAAS,EAAa;EAC5B,IAAI;GACF,OAAO,MAAM,EAAO,MAClB,GAAG,EAA0B,GAAG,mBAAmB,CAAE,KACrD,GACA,EAAE,cAAc,OAAO,CACzB;EACF,UAAU;GACR,EAAO,MAAM;EACf;CACF;CAEA,aAAa,OAAO,GAAyC;EAC3D,IAAM,IAAS,EAAa;EAC5B,IAAI;GACF,OAAO,MAAM,EAAO,OAClB,GAAG,EAA0B,GAAG,mBAAmB,CAAE,KACrD,EAAE,cAAc,OAAO,CACzB;EACF,UAAU;GACR,EAAO,MAAM;EACf;CACF;AACF"}
+{"version":3,"file":"provider-connections-service.api.js","names":[],"sources":["../../../src/api/provider-connections-service/provider-connections-service.api.ts"],"sourcesContent":["/**\n * ProviderConnectionsService is the single entry point for provider-connection\n * CRUD, routing per active backend so callers (hooks, the settings manager)\n * stay backend-agnostic. A provider connection is a shared `api_key` + optional\n * `base_url` that one or more LLM profiles reference by id; the backend resolves\n * the credential into a runnable LLM at profile-load time, so this service only\n * manages the stored connections.\n *\n * - local agent-server: the `/api/llm/provider-connections` CRUD endpoints via\n *   the generic `AgentServerClient` verb helpers (the same approach\n *   `LLMBalanceService` uses; there is no generated client for these routes in\n *   `@openhands/typescript-client` yet);\n * - cloud app-server: `src/api/cloud/provider-connections-service.api.ts` (the\n *   org-gated `/api/organizations/{orgId}/provider-connections` routes) via the\n *   org-scoped cloud proxy.\n *\n * This mirrors how `ProfilesService` branches to the cloud profile service.\n */\nimport { AgentServerClient } from \"@openhands/typescript-client/clients\";\nimport { getAgentServerClientOptions } from \"../agent-server-client-options\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport {\n  fetchCloudProviderConnections,\n  createCloudProviderConnection,\n  updateCloudProviderConnection,\n  deleteCloudProviderConnection,\n} from \"../cloud/provider-connections-service.api\";\n\nconst PROVIDER_CONNECTIONS_PATH = \"/api/llm/provider-connections\";\n\nfunction isCloudBackend(): boolean {\n  return getActiveBackend().backend.kind === \"cloud\";\n}\n\nexport interface ProviderConnection {\n  id: string;\n  display_name: string;\n  provider: string;\n  base_url: string | null;\n  created_at: number;\n  updated_at: number;\n  /** Whether the stored connection currently holds a usable key. */\n  api_key_set: boolean;\n}\n\nexport interface CreateProviderConnectionRequest {\n  display_name: string;\n  provider: string;\n  api_key: string;\n  base_url?: string | null;\n}\n\n/**\n * Partial update. Only the provided fields change. `api_key` may be sent to\n * rotate the key; the agent-server rejects `api_key: null` (a connection must\n * always keep a key), so callers omit it to leave the key unchanged.\n */\nexport interface UpdateProviderConnectionRequest {\n  display_name?: string;\n  provider?: string;\n  api_key?: string;\n  base_url?: string | null;\n}\n\nfunction createClient(): AgentServerClient {\n  const { host, apiKey } = getAgentServerClientOptions();\n  return new AgentServerClient({ host, ...(apiKey ? { apiKey } : {}) });\n}\n\nclass ProviderConnectionsService {\n  static async list(): Promise<ProviderConnection[]> {\n    if (isCloudBackend()) return fetchCloudProviderConnections();\n    const client = createClient();\n    try {\n      return await client.get<ProviderConnection[]>(PROVIDER_CONNECTIONS_PATH, {\n        responseType: \"json\",\n      });\n    } finally {\n      client.close();\n    }\n  }\n\n  static async create(\n    request: CreateProviderConnectionRequest,\n  ): Promise<ProviderConnection> {\n    if (isCloudBackend()) return createCloudProviderConnection(request);\n    const client = createClient();\n    try {\n      return await client.post<ProviderConnection>(\n        PROVIDER_CONNECTIONS_PATH,\n        request,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n\n  static async update(\n    id: string,\n    request: UpdateProviderConnectionRequest,\n  ): Promise<ProviderConnection> {\n    if (isCloudBackend()) return updateCloudProviderConnection(id, request);\n    const client = createClient();\n    try {\n      return await client.patch<ProviderConnection>(\n        `${PROVIDER_CONNECTIONS_PATH}/${encodeURIComponent(id)}`,\n        request,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n\n  static async delete(id: string): Promise<ProviderConnection> {\n    if (isCloudBackend()) return deleteCloudProviderConnection(id);\n    const client = createClient();\n    try {\n      return await client.delete<ProviderConnection>(\n        `${PROVIDER_CONNECTIONS_PATH}/${encodeURIComponent(id)}`,\n        { responseType: \"json\" },\n      );\n    } finally {\n      client.close();\n    }\n  }\n}\n\nexport default ProviderConnectionsService;\n"],"mappings":";;;;;;AA4BA,IAAM,IAA4B;AAElC,SAAS,IAA0B;CACjC,OAAO,EAAiB,EAAE,QAAQ,SAAS;AAC7C;AAgCA,SAAS,IAAkC;CACzC,IAAM,EAAE,SAAM,cAAW,EAA4B;CACrD,OAAO,IAAI,EAAkB;EAAE;EAAM,GAAI,IAAS,EAAE,UAAO,IAAI,CAAC;CAAG,CAAC;AACtE;AAEA,IAAM,IAAN,MAAiC;CAC/B,aAAa,OAAsC;EACjD,IAAI,EAAe,GAAG,OAAO,EAA8B;EAC3D,IAAM,IAAS,EAAa;EAC5B,IAAI;GACF,OAAO,MAAM,EAAO,IAA0B,GAA2B,EACvE,cAAc,OAChB,CAAC;EACH,UAAU;GACR,EAAO,MAAM;EACf;CACF;CAEA,aAAa,OACX,GAC6B;EAC7B,IAAI,EAAe,GAAG,OAAO,EAA8B,CAAO;EAClE,IAAM,IAAS,EAAa;EAC5B,IAAI;GACF,OAAO,MAAM,EAAO,KAClB,GACA,GACA,EAAE,cAAc,OAAO,CACzB;EACF,UAAU;GACR,EAAO,MAAM;EACf;CACF;CAEA,aAAa,OACX,GACA,GAC6B;EAC7B,IAAI,EAAe,GAAG,OAAO,EAA8B,GAAI,CAAO;EACtE,IAAM,IAAS,EAAa;EAC5B,IAAI;GACF,OAAO,MAAM,EAAO,MAClB,GAAG,EAA0B,GAAG,mBAAmB,CAAE,KACrD,GACA,EAAE,cAAc,OAAO,CACzB;EACF,UAAU;GACR,EAAO,MAAM;EACf;CACF;CAEA,aAAa,OAAO,GAAyC;EAC3D,IAAI,EAAe,GAAG,OAAO,EAA8B,CAAE;EAC7D,IAAM,IAAS,EAAa;EAC5B,IAAI;GACF,OAAO,MAAM,EAAO,OAClB,GAAG,EAA0B,GAAG,mBAAmB,CAAE,KACrD,EAAE,cAAc,OAAO,CACzB;EACF,UAAU;GACR,EAAO,MAAM;EACf;CACF;AACF"}

package/dist/api/settings-service/settings-service.api.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/settings-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const t=require("../backend-registry/active-store.cjs"),n=require("../agent-server-client-options.cjs"),r=require("../../services/settings.cjs"),i=require("../../utils/mcp-config.cjs"),a=require("../cloud/settings-service.api.cjs");var o=[`language`,`user_consents_to_analytics`,`enable_sound_notifications`,`git_user_name`,`git_user_email`,`title_llm_profile`,`disabled_skills`,`enabled_skills`],s=new Set(o),c=e=>s.has(e),l=e=>{let t={},n={};for(let[r,i]of Object.entries(e))c(r)?t[r]=i:n[r]=i;return{extracted:t,rest:n}},u=e=>JSON.parse(JSON.stringify(e)),d=(e,t)=>({...e??{},...t??{}});async function f(e,t=3,n=500){for(let r=0;r<t;r+=1)try{return await e()}catch(e){if(r>=t-1)throw e;let i=n*2**r;await new Promise(e=>{setTimeout(e,i)})}throw Error(`Retry attempts exhausted`)}var p={redacted:null,encrypted:null,timestamp:0},m=300*1e3,h=()=>Date.now()-p.timestamp<m,g=()=>{p={redacted:null,encrypted:null,timestamp:0}},_=e=>!!e&&typeof e==`object`&&!Array.isArray(e),v=(e,t)=>`Basic ${btoa(`${e}:${t}`)}`,y=e=>{switch(e.strategy){case`none`:return{};case`api_key`:{if(typeof e.value!=`string`||!e.value)return null;let t=typeof e.header_name==`string`&&e.header_name?e.header_name:`Authorization`,n=t===`Authorization`?`Bearer ${e.value}`:e.value;return{[t]:n}}case`bearer`:return typeof e.value!=`string`||!e.value?null:{Authorization:`Bearer ${e.value}`};case`basic`:return typeof e.username!=`string`||typeof e.password!=`string`?null:{Authorization:v(e.username,e.password)};case`header`:return i.stringRecord(e.headers)??{};case`oauth2`:{let t=_(e.state)?e.state.tokens:void 0;return!_(t)||typeof t.access_token!=`string`?null:{Authorization:`Bearer ${t.access_token}`}}default:return null}},b=async e=>{if(!_(e))return e;let n=_(e.mcpServers),r=n?e.mcpServers:e,o=Object.values(r).some(e=>_(e)&&_(e.auth)&&e.auth!==null)&&t.getActiveBackend().backend.kind===`cloud`,s=new Map;if(o)try{let e=await a.fetchCloudSettings(),t=_(e.mcp_config)?e.mcp_config:{};for(let[e,n]of Object.entries(t))if(_(n)){let t=i.stringRecord(n.headers);t&&s.set(e,t)}}catch{}let c=Object.fromEntries(Object.entries(r).map(([e,t])=>{if(!_(t))return[e,t];if(t.auth===null){let n={...t,headers:null};return delete n.auth,[e,n]}if(!_(t.auth))return[e,t];let n=y(t.auth);if(n===null)return[e,t];let r={...t},a={...i.stringRecord(t.headers)??{},...n},o=s.get(e);if(o)for(let e of Object.keys(o))e in a||(a[e]=null);return delete r.auth,Object.keys(a).length>0?r.headers=a:delete r.headers,[e,r]}));return n?{...e,mcpServers:c}:c},x=e=>{let t={agent_settings:e.agent_settings??{},conversation_settings:e.conversation_settings??{},llm_api_key_set:e.llm_api_key_is_set},n=e.misc_settings?.app_preferences;if(n)for(let e of o){let r=n[e];r!==void 0&&(t[e]=r)}return t},S=e=>{let t=d(r.DEFAULT_SETTINGS.agent_settings??{},e.agent_settings??{}),n=d(r.DEFAULT_SETTINGS.conversation_settings??{},e.conversation_settings??{}),i={...u(r.DEFAULT_SETTINGS),...e,provider_tokens_set:{...r.DEFAULT_SETTINGS.provider_tokens_set??{},...e.provider_tokens_set??{}},agent_settings:t,conversation_settings:n},a=t.llm,o=t.condenser;return typeof t.agent==`string`&&(i.agent=t.agent),typeof a?.model==`string`&&a.model.length>0&&(i.llm_model=a.model),typeof a?.base_url==`string`&&(i.llm_base_url=a.base_url),typeof o?.enabled==`boolean`&&(i.enable_default_condenser=o.enabled),typeof o?.max_size==`number`&&(i.condenser_max_size=o.max_size),typeof n.confirmation_mode==`boolean`&&(i.confirmation_mode=n.confirmation_mode),(typeof n.security_analyzer==`string`||n.security_analyzer===null)&&(i.security_analyzer=n.security_analyzer),typeof n.max_iterations==`number`&&(i.max_iterations=n.max_iterations),i.search_api_key_set=!!i.search_api_key,i},C=class r{static async fetchSettingsFromApi(t){return f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).getSettings({exposeSecrets:t}))}static async getSettings(){if(t.getActiveBackend().backend.kind===`cloud`)try{return S(await f(()=>a.fetchCloudSettings()))}catch(e){return console.warn(`Failed to fetch cloud settings, using defaults:`,e),S({})}if(h()&&p.redacted)return S(x(p.redacted));try{let e=await this.fetchSettingsFromApi();return p.redacted=e,p.timestamp=Date.now(),S(x(e))}catch(e){return console.warn(`Failed to fetch settings from API, using defaults:`,e),S({})}}static async getSettingsForConversation(){if(h()&&p.encrypted)return{agentSettings:p.encrypted.agent_settings,conversationSettings:p.encrypted.conversation_settings,secretsEncrypted:!0};let e=await this.fetchSettingsFromApi(`encrypted`);return p.encrypted=e,p.timestamp||=Date.now(),{agentSettings:e.agent_settings,conversationSettings:e.conversation_settings,secretsEncrypted:!0}}static async getSettingsSchema(){return t.getActiveBackend().backend.kind===`cloud`?await a.fetchCloudSettingsSchema():await new e.SettingsClient(n.getAgentServerClientOptions()).getAgentSchema()}static async getConversationSettingsSchema(){return t.getActiveBackend().backend.kind===`cloud`?await a.fetchCloudConversationSettingsSchema():await new e.SettingsClient(n.getAgentServerClientOptions()).getConversationSchema()}static async patchMcpConfig(r){if(t.getActiveBackend().backend.kind===`cloud`){let e=await b(r);await f(()=>a.saveCloudSettings({agent_settings_diff:{mcp_config:e}}))}else await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).updateSettings({agent_settings_diff:{mcp_config:r}}));return g(),!0}static async patchMcpServer(i,a){return t.getActiveBackend().backend.kind===`cloud`?r.patchMcpConfig({[i]:a}):(await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).patchMcpServer(i,a)),g(),!0)}static async createMcpServer(i,a){return t.getActiveBackend().backend.kind===`cloud`?r.patchMcpConfig({[i]:a}):(await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).createMcpServer(i,a)),g(),!0)}static async deleteMcpServer(i){return t.getActiveBackend().backend.kind===`cloud`?r.patchMcpConfig({[i]:null}):(await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).deleteMcpServer(i)),g(),!0)}static async saveSettings(r){let{extracted:i,rest:o}=l(r),s=Object.keys(i).length>0,c={},u=o.agent_settings_diff;u&&Object.keys(u).length>0&&(c.agent_settings_diff=u);let d=o.conversation_settings_diff;if(d&&Object.keys(d).length>0&&(c.conversation_settings_diff=d),s&&(c.misc_settings_diff={app_preferences:i}),t.getActiveBackend().backend.kind===`cloud`){if(!(c.agent_settings_diff||c.conversation_settings_diff||s))return!0;let e={};c.agent_settings_diff&&(e.agent_settings_diff={...c.agent_settings_diff},`mcp_config`in e.agent_settings_diff&&(e.agent_settings_diff.mcp_config=await b(e.agent_settings_diff.mcp_config))),c.conversation_settings_diff&&(e.conversation_settings_diff=c.conversation_settings_diff),s&&(e.app_preferences=i),await f(()=>a.saveCloudSettings(e))}else{if(!(c.agent_settings_diff||c.conversation_settings_diff||c.misc_settings_diff))return!0;await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).updateSettings(c))}return g(),!0}static invalidateCache(){g()}};exports.default=C;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/settings-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const t=require("../backend-registry/active-store.cjs"),n=require("../agent-server-client-options.cjs"),r=require("../../services/settings.cjs"),i=require("../../utils/mcp-config.cjs"),a=require("../cloud/settings-service.api.cjs");var o=[`language`,`user_consents_to_analytics`,`enable_sound_notifications`,`git_user_name`,`git_user_email`,`title_llm_profile`,`disabled_skills`,`enabled_skills`],s=new Set(o),c=e=>s.has(e),l=e=>{let t={},n={};for(let[r,i]of Object.entries(e))c(r)?t[r]=i:n[r]=i;return{extracted:t,rest:n}},u=e=>JSON.parse(JSON.stringify(e)),d=(e,t)=>({...e??{},...t??{}});async function f(e,t=3,n=500){for(let r=0;r<t;r+=1)try{return await e()}catch(e){if(r>=t-1)throw e;let i=n*2**r;await new Promise(e=>{setTimeout(e,i)})}throw Error(`Retry attempts exhausted`)}var p={redacted:null,encrypted:null,timestamp:0},m=300*1e3,h=()=>Date.now()-p.timestamp<m,g=()=>{p={redacted:null,encrypted:null,timestamp:0}},_=e=>!!e&&typeof e==`object`&&!Array.isArray(e),v=(e,t)=>`Basic ${btoa(`${e}:${t}`)}`,y=e=>{switch(e.strategy){case`none`:return{};case`api_key`:{if(typeof e.value!=`string`||!e.value)return null;let t=typeof e.header_name==`string`&&e.header_name?e.header_name:`Authorization`,n=t===`Authorization`?`Bearer ${e.value}`:e.value;return{[t]:n}}case`bearer`:return typeof e.value!=`string`||!e.value?null:{Authorization:`Bearer ${e.value}`};case`basic`:return typeof e.username!=`string`||typeof e.password!=`string`?null:{Authorization:v(e.username,e.password)};case`header`:return i.stringRecord(e.headers)??{};case`oauth2`:{let t=_(e.state)?e.state.tokens:void 0;return!_(t)||typeof t.access_token!=`string`?null:{Authorization:`Bearer ${t.access_token}`}}default:return null}},b=async e=>{if(!_(e))return e;let n=_(e.mcpServers),r=n?e.mcpServers:e,o=Object.values(r).some(e=>_(e)&&_(e.auth)&&e.auth!==null)&&t.getActiveBackend().backend.kind===`cloud`,s=new Map;if(o)try{let e=await a.fetchCloudSettings(),t=_(e.mcp_config)?e.mcp_config:{};for(let[e,n]of Object.entries(t))if(_(n)){let t=i.stringRecord(n.headers);t&&s.set(e,t)}}catch{}let c=Object.fromEntries(Object.entries(r).map(([e,t])=>{if(!_(t))return[e,t];if(t.auth===null){let n={...t,headers:null};return delete n.auth,[e,n]}if(!_(t.auth))return[e,t];let n=y(t.auth);if(n===null)return[e,t];let r={...t},a={...i.stringRecord(t.headers)??{},...n},o=s.get(e);if(o)for(let e of Object.keys(o))e in a||(a[e]=null);return delete r.auth,Object.keys(a).length>0?r.headers=a:delete r.headers,[e,r]}));return n?{...e,mcpServers:c}:c},x=e=>{let t=e.misc_settings?.app_preferences,n=t?.disabled_skills,r=t?.enabled_skills;return{disabledSkills:Array.isArray(n)?n:[],enabledSkills:Array.isArray(r)?r:void 0}},S=e=>{let t={agent_settings:e.agent_settings??{},conversation_settings:e.conversation_settings??{},llm_api_key_set:e.llm_api_key_is_set},n=e.misc_settings?.app_preferences;if(n)for(let e of o){let r=n[e];r!==void 0&&(t[e]=r)}return t},C=e=>{let t=d(r.DEFAULT_SETTINGS.agent_settings??{},e.agent_settings??{}),n=d(r.DEFAULT_SETTINGS.conversation_settings??{},e.conversation_settings??{}),i={...u(r.DEFAULT_SETTINGS),...e,provider_tokens_set:{...r.DEFAULT_SETTINGS.provider_tokens_set??{},...e.provider_tokens_set??{}},agent_settings:t,conversation_settings:n},a=t.llm,o=t.condenser;return typeof t.agent==`string`&&(i.agent=t.agent),typeof a?.model==`string`&&a.model.length>0&&(i.llm_model=a.model),typeof a?.base_url==`string`&&(i.llm_base_url=a.base_url),typeof o?.enabled==`boolean`&&(i.enable_default_condenser=o.enabled),typeof o?.max_size==`number`&&(i.condenser_max_size=o.max_size),typeof n.confirmation_mode==`boolean`&&(i.confirmation_mode=n.confirmation_mode),(typeof n.security_analyzer==`string`||n.security_analyzer===null)&&(i.security_analyzer=n.security_analyzer),typeof n.max_iterations==`number`&&(i.max_iterations=n.max_iterations),i.search_api_key_set=!!i.search_api_key,i},w=class r{static async fetchSettingsFromApi(t){return f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).getSettings({exposeSecrets:t}))}static async getSettings(){if(t.getActiveBackend().backend.kind===`cloud`)try{return C(await f(()=>a.fetchCloudSettings()))}catch(e){return console.warn(`Failed to fetch cloud settings, using defaults:`,e),C({})}if(h()&&p.redacted)return C(S(p.redacted));try{let e=await this.fetchSettingsFromApi();return p.redacted=e,p.timestamp=Date.now(),C(S(e))}catch(e){return console.warn(`Failed to fetch settings from API, using defaults:`,e),C({})}}static async getSettingsForConversation(){if(h()&&p.encrypted)return{agentSettings:p.encrypted.agent_settings,conversationSettings:p.encrypted.conversation_settings,secretsEncrypted:!0,skillEnablement:x(p.encrypted)};let e=await this.fetchSettingsFromApi(`encrypted`);return p.encrypted=e,p.timestamp||=Date.now(),{agentSettings:e.agent_settings,conversationSettings:e.conversation_settings,secretsEncrypted:!0,skillEnablement:x(e)}}static async getSettingsSchema(){return t.getActiveBackend().backend.kind===`cloud`?await a.fetchCloudSettingsSchema():await new e.SettingsClient(n.getAgentServerClientOptions()).getAgentSchema()}static async getConversationSettingsSchema(){return t.getActiveBackend().backend.kind===`cloud`?await a.fetchCloudConversationSettingsSchema():await new e.SettingsClient(n.getAgentServerClientOptions()).getConversationSchema()}static async patchMcpConfig(r){if(t.getActiveBackend().backend.kind===`cloud`){let e=await b(r);await f(()=>a.saveCloudSettings({agent_settings_diff:{mcp_config:e}}))}else await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).updateSettings({agent_settings_diff:{mcp_config:r}}));return g(),!0}static async patchMcpServer(i,a){return t.getActiveBackend().backend.kind===`cloud`?r.patchMcpConfig({[i]:a}):(await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).patchMcpServer(i,a)),g(),!0)}static async createMcpServer(i,a){return t.getActiveBackend().backend.kind===`cloud`?r.patchMcpConfig({[i]:a}):(await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).createMcpServer(i,a)),g(),!0)}static async deleteMcpServer(i){return t.getActiveBackend().backend.kind===`cloud`?r.patchMcpConfig({[i]:null}):(await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).deleteMcpServer(i)),g(),!0)}static async saveSettings(r){let{extracted:i,rest:o}=l(r),s=Object.keys(i).length>0,c={},u=o.agent_settings_diff;u&&Object.keys(u).length>0&&(c.agent_settings_diff=u);let d=o.conversation_settings_diff;if(d&&Object.keys(d).length>0&&(c.conversation_settings_diff=d),s&&(c.misc_settings_diff={app_preferences:i}),t.getActiveBackend().backend.kind===`cloud`){if(!(c.agent_settings_diff||c.conversation_settings_diff||s))return!0;let e={};c.agent_settings_diff&&(e.agent_settings_diff={...c.agent_settings_diff},`mcp_config`in e.agent_settings_diff&&(e.agent_settings_diff.mcp_config=await b(e.agent_settings_diff.mcp_config))),c.conversation_settings_diff&&(e.conversation_settings_diff=c.conversation_settings_diff),s&&(e.app_preferences=i),await f(()=>a.saveCloudSettings(e))}else{if(!(c.agent_settings_diff||c.conversation_settings_diff||c.misc_settings_diff))return!0;await f(()=>new e.SettingsClient(n.getAgentServerClientOptions()).updateSettings(c))}return g(),!0}static invalidateCache(){g()}};exports.default=w;
 //# sourceMappingURL=settings-service.api.cjs.map