@openhands/agent-canvas 1.14.0 → 1.16.0

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

@@ -1 +1 @@
-{"version":3,"file":"agent-server-conversation-service.api.cjs","names":[],"sources":["../../../src/api/conversation-service/agent-server-conversation-service.api.ts"],"sourcesContent":["import {\n  ConversationSortOrder,\n  type ForkConversationRequest,\n  type LLMConfig,\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  buildConversationWorkingDir,\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} 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 {\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  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\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    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      };\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    const workingDir = await resolveAbsoluteAgentServerPath(\n      workingDirOverride ?? buildConversationWorkingDir(conversationId),\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      worktree: resolvedWorkspaceMode === \"new_worktree\",\n      agentProfileId,\n      agentProfileKind,\n      titleLlmProfile,\n    });\n\n    const data = await new ConversationClient(\n      getAgentServerClientOptions({ timeout: CREATE_CONVERSATION_TIMEOUT_MS }),\n    ).createConversation<DirectConversationInfo>(payload);\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  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    type RawRuntime = DirectConversationInfo & {\n      stats?: RuntimeConversationInfo[\"stats\"];\n    };\n\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<RawRuntime>(conversationId);\n    const data = requireDirectConversationInfo(response);\n    const stats = isRecord(response) ? response.stats : null;\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: isRecord(stats) ? 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    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.cjs","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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"}

package/dist/api/conversation-service/agent-server-conversation-service.api.d.ts

@@ -1,3 +1,4 @@
+import { type VSCodeStatusResponse } from "@openhands/typescript-client";
 import { AgentKind } from "#/types/settings";
 import type { ConversationRuntimeContext } from "#/api/conversation-file-upload.api";
 import { DirectConversationInfo } from "../agent-server-adapter";
@@ -25,6 +26,16 @@ declare class AgentServerConversationService {
     static createConversation(options?: CreateConversationOptions): Promise<AppConversationStartTask>;
     static getStartTask(taskId: string): Promise<AppConversationStartTask | null>;
     static getVSCodeUrl(conversationId: string, conversationUrl: string | null | undefined, sessionApiKey?: string | null): Promise<GetVSCodeUrlResponse>;
+    /**
+     * Read the editor's capability state from the agent-server.
+     *
+     * `/api/vscode/status` answers 200 with `enabled: false` when the
+     * deployment set `enable_vscode: false`, which distinguishes "this
+     * deployment offers no editor" from a transport, auth, or server
+     * failure — `/api/vscode/url` answers 503 for the former and so
+     * cannot be told apart from the latter.
+     */
+    static getVSCodeStatus(conversationUrl: string | null | undefined, sessionApiKey?: string | null): Promise<VSCodeStatusResponse>;
     static resolveConversationWorkingDir(conversationId: string): Promise<string>;
     static batchGetAppConversations(ids: string[]): Promise<(AppConversation | null)[]>;
     static updateConversationPublicFlag(conversationId: string, isPublic: boolean): Promise<AppConversation>;