npm - @openhands/agent-canvas - Versions diffs - 1.12.0 → 1.13.0 - Mend

@openhands/agent-canvas 1.12.0 → 1.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (732) hide show

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

	@@ -1 +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\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 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 ): Promise<AppConversationStartTask> {\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 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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"}
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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"}

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

@@ -4,9 +4,25 @@ import { DirectConversationInfo } from "../agent-server-adapter";
 import { GetVSCodeUrlResponse } from "../open-hands.types";
 import { ConversationMetadata, type WorkspaceMode } from "../conversation-metadata-store";
 import type { GetHooksResponse, PluginSpec, AppConversation, AppConversationPage, AppConversationStartTask, RuntimeConversationInfo, SendMessageRequest, SendMessageResponse } from "./agent-server-conversation-service.types";
+/**
+ * Options for {@link AgentServerConversationService.createConversation}.
+ */
+export interface CreateConversationOptions {
+    initialUserMsg?: string;
+    conversationInstructions?: string;
+    plugins?: PluginSpec[];
+    metadata?: ConversationMetadata | null;
+    workingDirOverride?: string;
+    workspaceMode?: WorkspaceMode;
+    parentConversationId?: string;
+    agentType?: "default" | "plan";
+    sandboxId?: string;
+    agentProfileId?: string;
+    agentProfileKind?: AgentKind;
+}
 declare class AgentServerConversationService {
     static sendMessage(conversationId: string, message: SendMessageRequest, runtime?: ConversationRuntimeContext | null): Promise<SendMessageResponse>;
-    static createConversation(initialUserMsg?: string, conversationInstructions?: string, plugins?: PluginSpec[], metadata?: ConversationMetadata | null, workingDirOverride?: string, workspaceMode?: WorkspaceMode, parentConversationId?: string, agentType?: "default" | "plan", sandboxId?: string, agentProfileId?: string, agentProfileKind?: AgentKind): Promise<AppConversationStartTask>;
+    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>;
     static resolveConversationWorkingDir(conversationId: string): Promise<string>;
@@ -17,6 +33,13 @@ declare class AgentServerConversationService {
     static downloadConversation(conversationId: string): Promise<Blob>;
     static getHooks(conversationId: string): Promise<GetHooksResponse>;
     static getRuntimeConversation(conversationId: string, conversationUrl: string | null | undefined, sessionApiKey?: string | null): Promise<RuntimeConversationInfo>;
+    /**
+     * Force condensation ("compact") of the conversation history via
+     * `POST /api/conversations/{id}/condense`. Routed the same way as
+     * {@link sendMessage}: through the cloud proxy at the conversation's own
+     * runtime host for cloud backends, directly against that runtime otherwise.
+     */
+    static condenseConversation(conversationId: string, conversationUrl: string | null | undefined, sessionApiKey?: string | null): Promise<void>;
     static searchConversations(limit?: number, pageId?: string): Promise<AppConversationPage>;
     static deleteConversation(conversationId: string): Promise<void>;
     static updateConversationTitle(conversationId: string, title: string): Promise<AppConversation>;

package/dist/api/conversation-service/agent-server-conversation-service.api.js CHANGED Viewed

@@ -16,67 +16,67 @@ import w from "../../node_modules/uuid/dist/v4.js";
 import { resolveAbsoluteAgentServerPath as T } from "../agent-server-home.js";
 import E from "../profiles-service/profiles-service.api.js";
 import D from "../settings-service/settings-service.api.js";
-import { assertSubscriptionAuthReady as O, buildStartConversationRequestWithEncryptedSettings as ee, emptyHooksResponse as k, getDefaultConversationTitle as A, toAppConversation as j, toConversationPage as M } from "../agent-server-adapter.js";
-import { resolveTitleLlmProfile as N } from "../../utils/title-llm-profile.js";
+import { assertSubscriptionAuthReady as O, buildStartConversationRequestWithEncryptedSettings as k, emptyHooksResponse as A, getDefaultConversationTitle as j, toAppConversation as M, toConversationPage as N } from "../agent-server-adapter.js";
+import { resolveTitleLlmProfile as P } from "../../utils/title-llm-profile.js";
 //#region src/api/conversation-service/agent-server-conversation-service.api.ts
-var P = "1970-01-01T00:00:00.000Z", F = 300 * 1e3, I = "Unable to load conversations because the selected agent server returned data this UI does not understand. Check the backend URL/session key and update the agent server if needed.";
-function L() {
-	return /* @__PURE__ */ Error(I);
+var F = "1970-01-01T00:00:00.000Z", I = 300 * 1e3, L = "Unable to load conversations because the selected agent server returned data this UI does not understand. Check the backend URL/session key and update the agent server if needed.";
+function R() {
+	return /* @__PURE__ */ Error(L);
 }
-function R(e) {
+function z(e) {
 	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-function z(e) {
+function B(e) {
 	return typeof e == "number" ? e : null;
 }
-function B(e) {
+function V(e) {
 	return typeof e == "number" ? e : 0;
 }
-function V(e) {
+function H(e) {
 	return typeof e == "string" ? e : null;
 }
-function H(e, t, n) {
+function U(e, t, n) {
 	let r = e[t] ?? e[n];
-	return typeof r == "string" && r.trim() ? r : P;
-}
-function U(e) {
-	return R(e) ? {
-		prompt_tokens: B(e.prompt_tokens),
-		completion_tokens: B(e.completion_tokens),
-		cache_read_tokens: B(e.cache_read_tokens),
-		cache_write_tokens: B(e.cache_write_tokens),
-		context_window: B(e.context_window),
-		per_turn_token: B(e.per_turn_token)
-	} : null;
+	return typeof r == "string" && r.trim() ? r : F;
 }
 function W(e) {
-	return R(e) ? {
-		accumulated_cost: z(e.accumulated_cost),
-		max_budget_per_task: z(e.max_budget_per_task),
-		accumulated_token_usage: U(e.accumulated_token_usage)
+	return z(e) ? {
+		prompt_tokens: V(e.prompt_tokens),
+		completion_tokens: V(e.completion_tokens),
+		cache_read_tokens: V(e.cache_read_tokens),
+		cache_write_tokens: V(e.cache_write_tokens),
+		context_window: V(e.context_window),
+		per_turn_token: V(e.per_turn_token)
 	} : null;
 }
 function G(e) {
-	if (!R(e)) return null;
-	let t = R(e.llm) ? { model: V(e.llm.model) } : null;
+	return z(e) ? {
+		accumulated_cost: B(e.accumulated_cost),
+		max_budget_per_task: B(e.max_budget_per_task),
+		accumulated_token_usage: W(e.accumulated_token_usage)
+	} : null;
+}
+function K(e) {
+	if (!z(e)) return null;
+	let t = z(e.llm) ? { model: H(e.llm.model) } : null;
 	return {
-		kind: V(e.kind),
-		acp_server: V(e.acp_server),
-		acp_model: V(e.acp_model),
+		kind: H(e.kind),
+		acp_server: H(e.acp_server),
+		acp_model: H(e.acp_model),
 		llm: t
 	};
 }
-function K(e) {
-	return R(e) ? { working_dir: V(e.working_dir) } : null;
-}
 function q(e) {
-	if (!R(e)) return null;
+	return z(e) ? { working_dir: H(e.working_dir) } : null;
+}
+function J(e) {
+	if (!z(e)) return null;
 	let t = {};
 	for (let [n, r] of Object.entries(e)) typeof r == "string" && (t[n] = r);
 	return t;
 }
-function J(e) {
-	if (!R(e)) return null;
+function ee(e) {
+	if (!z(e)) return null;
 	let { agent_profile_id: t, revision: n } = e;
 	return typeof t != "string" || typeof n != "number" ? null : {
 		agent_profile_id: t,
@@ -98,25 +98,25 @@ function X(e, t) {
 	return n;
 }
 function Z(e) {
-	if (!R(e) || typeof e.id != "string" || !e.id.trim()) throw L();
+	if (!z(e) || typeof e.id != "string" || !e.id.trim()) throw R();
 	return {
 		id: e.id.trim(),
-		title: V(e.title),
-		created_at: H(e, "created_at", "createdAt"),
-		updated_at: H(e, "updated_at", "updatedAt"),
-		execution_status: V(e.execution_status),
-		sandbox_status: V(e.sandbox_status),
-		metrics: W(e.metrics),
-		agent: G(e.agent),
-		workspace: K(e.workspace),
-		tags: q(e.tags),
-		launched_agent_profile: J(e.launched_agent_profile),
-		current_model_id: V(e.current_model_id),
-		current_model_name: V(e.current_model_name)
+		title: H(e.title),
+		created_at: U(e, "created_at", "createdAt"),
+		updated_at: U(e, "updated_at", "updatedAt"),
+		execution_status: H(e.execution_status),
+		sandbox_status: H(e.sandbox_status),
+		metrics: G(e.metrics),
+		agent: K(e.agent),
+		workspace: q(e.workspace),
+		tags: J(e.tags),
+		launched_agent_profile: ee(e.launched_agent_profile),
+		current_model_id: H(e.current_model_id),
+		current_model_name: H(e.current_model_name)
 	};
 }
 function Q(e) {
-	if (!Array.isArray(e)) throw L();
+	if (!Array.isArray(e)) throw R();
 	return e.map(Z);
 }
 function te(e) {
@@ -124,7 +124,7 @@ function te(e) {
 		items: Q(e),
 		next_page_id: null
 	};
-	if (!R(e)) throw L();
+	if (!z(e)) throw R();
 	return {
 		items: Q(e.items),
 		next_page_id: typeof e.next_page_id == "string" ? e.next_page_id : null
@@ -174,58 +174,59 @@ var ie = class {
 			sessionApiKey: c
 		})).sendEvent(t, n, { run: !0 }), n;
 	}
-	static async createConversation(t, n, r, i, o, d, f, m, h, _, v) {
+	static async createConversation(t = {}) {
+		let { initialUserMsg: n, conversationInstructions: r, plugins: i, metadata: o, workingDirOverride: d, workspaceMode: f, parentConversationId: m, agentType: h, sandboxId: _, agentProfileId: v, agentProfileKind: y } = t;
 		if (s().backend.kind === "cloud") return g({
-			initial_message: t ? {
+			initial_message: n ? {
 				role: "user",
 				content: [{
 					type: "text",
-					text: t
+					text: n
 				}]
 			} : null,
-			title: n ?? null,
-			selected_repository: i?.selected_repository ?? null,
-			selected_branch: i?.selected_branch ?? null,
-			git_provider: i?.git_provider ?? null,
-			plugins: r ?? null,
-			parent_conversation_id: f ?? null,
-			agent_type: m,
-			sandbox_id: h ?? null,
-			agent_profile_id: _ ?? null
+			title: r ?? null,
+			selected_repository: o?.selected_repository ?? null,
+			selected_branch: o?.selected_branch ?? null,
+			git_provider: o?.git_provider ?? null,
+			plugins: i ?? null,
+			parent_conversation_id: m ?? null,
+			agent_type: h,
+			sandbox_id: _ ?? null,
+			agent_profile_id: v ?? null
 		});
-		let [y, b] = await Promise.all([D.getSettings(), E.listProfiles().catch(() => void 0)]), x = N(y.title_llm_profile, b), S = w(), C = await T(o ?? a(S)), O = d ?? (o ? "local_repo" : "new_worktree"), k = await ee({
-			settings: y,
-			query: t,
-			conversationInstructions: n,
-			plugins: r,
-			conversationId: S,
-			parentConversationId: f,
-			workingDir: C,
-			worktree: O === "new_worktree",
-			agentProfileId: _,
-			agentProfileKind: v,
-			titleLlmProfile: x
-		}), A = await new e(u({ timeout: F })).createConversation(k), j = c();
-		if (!j) throw new l();
-		return (i?.selected_repository || o) && p(A.id, {
-			selected_repository: i?.selected_repository ?? null,
-			selected_branch: i?.selected_branch ?? null,
-			git_provider: i?.git_provider ?? null,
-			selected_workspace: o ?? null,
-			workspace_mode: O
+		let [b, x] = await Promise.all([D.getSettings(), E.listProfiles().catch(() => void 0)]), S = P(b.title_llm_profile, x), C = w(), O = await T(d ?? a(C)), A = f ?? (d ? "local_repo" : "new_worktree"), j = await k({
+			settings: b,
+			query: n,
+			conversationInstructions: r,
+			plugins: i,
+			conversationId: C,
+			parentConversationId: m,
+			workingDir: O,
+			worktree: A === "new_worktree",
+			agentProfileId: v,
+			agentProfileKind: y,
+			titleLlmProfile: S
+		}), M = await new e(u({ timeout: I })).createConversation(j), N = c();
+		if (!N) throw new l();
+		return (o?.selected_repository || d) && p(M.id, {
+			selected_repository: o?.selected_repository ?? null,
+			selected_branch: o?.selected_branch ?? null,
+			git_provider: o?.git_provider ?? null,
+			selected_workspace: d ?? null,
+			workspace_mode: A
 		}), {
-			id: A.id,
+			id: M.id,
 			created_by_user_id: null,
 			status: "READY",
 			detail: null,
-			app_conversation_id: A.id,
-			agent_server_url: j.host,
+			app_conversation_id: M.id,
+			agent_server_url: N.host,
 			request: {
-				initial_message: k.initial_message,
-				plugins: r ?? null
+				initial_message: j.initial_message,
+				plugins: i ?? null
 			},
-			created_at: A.created_at,
-			updated_at: A.updated_at
+			created_at: M.created_at,
+			updated_at: M.updated_at
 		};
 	}
 	static async getStartTask(e) {
@@ -246,7 +247,7 @@ var ie = class {
 		return t?.workspace?.working_dir ?? o();
 	}
 	static async batchGetAppConversations(t) {
-		return t.length === 0 ? [] : s().backend.kind === "cloud" ? h(t) : Q(await new e(u()).getConversations(t)).map((e) => j(e));
+		return t.length === 0 ? [] : s().backend.kind === "cloud" ? h(t) : Q(await new e(u()).getConversations(t)).map((e) => M(e));
 	}
 	static async updateConversationPublicFlag(e, t) {
 		if (s().backend.kind !== "cloud") throw Error("Public sharing requires a cloud backend.");
@@ -271,25 +272,43 @@ var ie = class {
 		return s().backend.kind === "cloud" ? v(e) : new t(u()).downloadTrajectory(e);
 	}
 	static async getHooks(e) {
-		return k();
+		return A();
 	}
 	static async getRuntimeConversation(t, n, r) {
 		let i = await new e(u({
 			conversationUrl: n,
 			sessionApiKey: r
-		})).getConversation(t), a = Z(i), o = R(i) ? i.stats : null;
+		})).getConversation(t), a = Z(i), o = z(i) ? i.stats : null;
 		return {
 			id: a.id,
-			title: a.title?.trim() ? a.title : A(a.id),
-			metrics: W(a.metrics),
+			title: a.title?.trim() ? a.title : j(a.id),
+			metrics: G(a.metrics),
 			created_at: a.created_at,
 			updated_at: a.updated_at,
 			status: re(a.execution_status),
-			stats: R(o) ? o : { usage_to_metrics: {} }
+			stats: z(o) ? o : { usage_to_metrics: {} }
 		};
 	}
+	static async condenseConversation(t, n, r) {
+		let a = s().backend;
+		if (a.kind === "cloud" && n) {
+			await m({
+				backend: a,
+				method: "POST",
+				hostOverride: i(n),
+				path: `/api/conversations/${t}/condense`,
+				authMode: "session-api-key",
+				sessionApiKey: r
+			});
+			return;
+		}
+		await new e(u({
+			conversationUrl: n,
+			sessionApiKey: r
+		})).condenseConversation(t);
+	}
 	static async searchConversations(t = 20, n) {
-		return s().backend.kind === "cloud" ? x(t, n) : M(te(await new e(u()).searchConversations({
+		return s().backend.kind === "cloud" ? x(t, n) : N(te(await new e(u()).searchConversations({
 			limit: t,
 			page_id: n,
 			sort_order: C.UPDATED_AT_DESC