@openhands/agent-canvas 1.9.0 → 1.11.0

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

@@ -7,16 +7,16 @@ import { buildHttpBaseUrl as i } from "../../utils/websocket-url.js";
 import { buildConversationWorkingDir as a, getAgentServerWorkingDir as o } from "../agent-server-config.js";
 import { getActiveBackend as s, getEffectiveLocalBackend as c } from "../backend-registry/active-store.js";
 import { NoBackendAvailableError as l, getAgentServerClientOptions as u } from "../agent-server-client-options.js";
-import d from "../../node_modules/uuid/dist/v4.js";
-import { callCloudProxy as f } from "../cloud/proxy.js";
-import { ConversationSortOrder as p } from "../../node_modules/@openhands/typescript-client/dist/models/conversation.js";
+import { getStoredConversationMetadata as d, removeStoredConversationMetadata as f, setStoredConversationMetadata as p } from "../conversation-metadata-store.js";
+import { callCloudProxy as m } from "../cloud/proxy.js";
+import { batchGetCloudConversations as h, createCloudAppConversation as g, deleteCloudConversation as _, downloadCloudConversation as v, getCloudAppConversationStartTask as y, readCloudConversationFile as b, searchCloudConversations as x, updateCloudConversationPublicFlag as S } from "../cloud/conversation-service.api.js";
+import { ConversationSortOrder as C } from "../../node_modules/@openhands/typescript-client/dist/models/conversation.js";
 import "../../node_modules/@openhands/typescript-client/dist/index.js";
-import { resolveAbsoluteAgentServerPath as m } from "../agent-server-home.js";
-import h from "../profiles-service/profiles-service.api.js";
-import { getStoredConversationMetadata as g, removeStoredConversationMetadata as _, setStoredConversationMetadata as v } from "../conversation-metadata-store.js";
-import { batchGetCloudConversations as y, createCloudAppConversation as b, deleteCloudConversation as x, downloadCloudConversation as S, getCloudAppConversationStartTask as C, readCloudConversationFile as w, searchCloudConversations as T, updateCloudConversationPublicFlag as E } from "../cloud/conversation-service.api.js";
-import ee from "../settings-service/settings-service.api.js";
-import { assertSubscriptionAuthReady as D, buildStartConversationRequestWithEncryptedSettings as O, emptyHooksResponse as k, getDefaultConversationTitle as A, toAppConversation as j, toConversationPage as M } from "../agent-server-adapter.js";
+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";
 //#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.";
@@ -152,11 +152,11 @@ var ie = class {
 		let a = s().backend, o = r?.conversationUrl ?? null, c = r?.sessionApiKey ?? null;
 		if (a.kind === "cloud") {
 			if (!o || !c) {
-				let [e] = await y([t]);
+				let [e] = await h([t]);
 				o = e?.conversation_url?.trim() ?? null, c = e?.session_api_key?.trim() ?? null;
 			}
 			if (!o || !c) throw Error("Conversation sandbox is still starting. Wait for it to finish, then try again.");
-			return await f({
+			return await m({
 				backend: a,
 				method: "POST",
 				hostOverride: i(o),
@@ -174,8 +174,8 @@ var ie = class {
 			sessionApiKey: c
 		})).sendEvent(t, n, { run: !0 }), n;
 	}
-	static async createConversation(t, n, r, i, o, f, p, g, _, y, x) {
-		if (s().backend.kind === "cloud") return b({
+	static async createConversation(t, n, r, i, o, d, f, m, h, _, v) {
+		if (s().backend.kind === "cloud") return g({
 			initial_message: t ? {
 				role: "user",
 				content: [{
@@ -188,30 +188,31 @@ var ie = class {
 			selected_branch: i?.selected_branch ?? null,
 			git_provider: i?.git_provider ?? null,
 			plugins: r ?? null,
-			parent_conversation_id: p ?? null,
-			agent_type: g,
-			sandbox_id: _ ?? null,
-			agent_profile_id: y ?? null
+			parent_conversation_id: f ?? null,
+			agent_type: m,
+			sandbox_id: h ?? null,
+			agent_profile_id: _ ?? null
 		});
-		let [S, C] = await Promise.all([ee.getSettings(), h.listProfiles().catch(() => void 0)]), w = N(S.title_llm_profile, C), T = d(), E = await m(o ?? a(T)), D = f ?? (o ? "local_repo" : "new_worktree"), k = await O({
-			settings: S,
+		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: T,
-			workingDir: E,
-			worktree: D === "new_worktree",
-			agentProfileId: y,
-			agentProfileKind: x,
-			titleLlmProfile: w
+			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) && v(A.id, {
+		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: D
+			workspace_mode: O
 		}), {
 			id: A.id,
 			created_by_user_id: null,
@@ -228,7 +229,7 @@ var ie = class {
 		};
 	}
 	static async getStartTask(e) {
-		return s().backend.kind === "cloud" ? C(e) : null;
+		return s().backend.kind === "cloud" ? y(e) : null;
 	}
 	static async getVSCodeUrl(e, t, n) {
 		let i = await this.resolveConversationWorkingDir(e);
@@ -245,64 +246,57 @@ var ie = class {
 		return t?.workspace?.working_dir ?? o();
 	}
 	static async batchGetAppConversations(t) {
-		return t.length === 0 ? [] : s().backend.kind === "cloud" ? y(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) => j(e));
 	}
 	static async updateConversationPublicFlag(e, t) {
 		if (s().backend.kind !== "cloud") throw Error("Public sharing requires a cloud backend.");
-		return E(e, t);
+		return S(e, t);
 	}
 	static async updateConversationRepository(e, t, n, r) {
-		t ? v(e, {
-			...g(e) ?? {},
+		t ? p(e, {
+			...d(e) ?? {},
 			selected_repository: t,
 			selected_branch: n ?? null,
 			git_provider: r ?? null
-		}) : _(e);
+		}) : f(e);
 		let [i] = await this.batchGetAppConversations([e]);
 		return $(i, e);
 	}
 	static async readConversationFile(e, n) {
-		if (s().backend.kind === "cloud") return w(e, X(n ?? "/workspace/project/.agents_tmp/PLAN.md", "/workspace/project"));
+		if (s().backend.kind === "cloud") return b(e, X(n ?? "/workspace/project/.agents_tmp/PLAN.md", "/workspace/project"));
 		let r = await this.resolveConversationWorkingDir(e), i = X(n ?? `${r}/.agents_tmp/PLAN.md`, r);
 		return new t(u()).downloadTextFile(i);
 	}
 	static async downloadConversation(e) {
-		return s().backend.kind === "cloud" ? S(e) : new t(u()).downloadTrajectory(e);
+		return s().backend.kind === "cloud" ? v(e) : new t(u()).downloadTrajectory(e);
 	}
 	static async getHooks(e) {
 		return k();
 	}
 	static async getRuntimeConversation(t, n, r) {
-		let a = s().backend, o = a.kind === "cloud" && n ? await f({
-			backend: a,
-			method: "GET",
-			hostOverride: i(n),
-			path: `/api/conversations/${t}`,
-			authMode: "session-api-key",
-			sessionApiKey: r
-		}) : await new e(u({
+		let i = await new e(u({
 			conversationUrl: n,
 			sessionApiKey: r
-		})).getConversation(t), c = Z(o), l = R(o) ? o.stats : null;
+		})).getConversation(t), a = Z(i), o = R(i) ? i.stats : null;
 		return {
-			id: c.id,
-			title: c.title?.trim() ? c.title : A(c.id),
-			metrics: W(c.metrics),
-			created_at: c.created_at,
-			updated_at: c.updated_at,
-			status: re(c.execution_status),
-			stats: R(l) ? l : { usage_to_metrics: {} }
+			id: a.id,
+			title: a.title?.trim() ? a.title : A(a.id),
+			metrics: W(a.metrics),
+			created_at: a.created_at,
+			updated_at: a.updated_at,
+			status: re(a.execution_status),
+			stats: R(o) ? o : { usage_to_metrics: {} }
 		};
 	}
 	static async searchConversations(t = 20, n) {
-		return s().backend.kind === "cloud" ? T(t, n) : M(te(await new e(u()).searchConversations({
+		return s().backend.kind === "cloud" ? x(t, n) : M(te(await new e(u()).searchConversations({
 			limit: t,
 			page_id: n,
-			sort_order: p.UPDATED_AT_DESC
+			sort_order: C.UPDATED_AT_DESC
 		})));
 	}
 	static async deleteConversation(t) {
-		s().backend.kind === "cloud" ? await x(t) : await new e(u()).deleteConversation(t), _(t);
+		s().backend.kind === "cloud" ? await _(t) : await new e(u()).deleteConversation(t), f(t);
 	}
 	static async updateConversationTitle(t, n) {
 		await new e(u()).updateConversation(t, { title: n });
@@ -314,8 +308,8 @@ var ie = class {
 		let i = await new e(u()).forkConversation(t, {
 			from_event_id: n,
 			...r ? { title: r } : {}
-		}), a = g(t);
-		return a && v(i.id, a), i;
+		}), a = d(t);
+		return a && p(i.id, a), i;
 	}
 	static async getEventParentId(t, n) {
 		return (await new e(u()).getEvent(t, n)).parent_id ?? void 0;
@@ -324,10 +318,10 @@ var ie = class {
 		let { backend: i } = s();
 		if (i.kind === "cloud") {
 			if (!t) {
-				await h.activateProfile(r);
+				await E.activateProfile(r);
 				return;
 			}
-			await f({
+			await m({
 				backend: i,
 				method: "POST",
 				path: `/api/v1/app-conversations/${t}/switch_profile`,
@@ -341,17 +335,17 @@ var ie = class {
 		}
 		let a = u(), o = new e(a), c = await new n(a).getProfile(r, { exposeSecrets: "encrypted" }), l = typeof c.config.model == "string" ? c.config.model : "";
 		if (!l) throw Error(`Profile '${r}' has no model.`);
-		await D({ llm: c.config }), await o.switchLLM(t, {
+		await O({ llm: c.config }), await o.switchLLM(t, {
 			...c.config,
 			model: l,
 			stream: !0,
-			usage_id: `profile:${r}:${d()}`
+			usage_id: `profile:${r}:${w()}`
 		});
 	}
 	static async switchAcpModel(t, n) {
 		let { backend: r } = s();
 		if (r.kind === "cloud") {
-			await f({
+			await m({
 				backend: r,
 				method: "POST",
 				path: `/api/v1/app-conversations/${t}/switch_acp_model`,

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

@@ -1 +1 @@
-{"version":3,"file":"agent-server-conversation-service.api.js","names":[],"sources":["../../../src/api/conversation-service/agent-server-conversation-service.api.ts"],"sourcesContent":["import {\n  ConversationSortOrder,\n  type ForkConversationRequest,\n  type LLMConfig,\n} 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      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    const active = getActiveBackend().backend;\n\n    type RawRuntime = DirectConversationInfo & {\n      stats?: RuntimeConversationInfo[\"stats\"];\n    };\n\n    // Cloud mode: route through the cloud-proxy to the runtime sandbox at\n    // the conversation's runtime URL — same pattern as getVSCodeUrl. Local\n    // mode forwards conversationUrl so the host explicitly resolves to the\n    // conversation's runtime instead of falling back to the active backend.\n    const response =\n      active.kind === \"cloud\" && conversationUrl\n        ? await callCloudProxy<RawRuntime>({\n            backend: active,\n            method: \"GET\",\n            hostOverride: buildHttpBaseUrl(conversationUrl),\n            path: `/api/conversations/${conversationId}`,\n            authMode: \"session-api-key\",\n            sessionApiKey,\n          })\n        : 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":";;;;;;;;;;;;;;;;;;;;;AAwEA,IAAM,IAAiC,4BAIjC,IAAiC,MAAS,KAC1C,IACJ;AAGF,SAAS,IAAqC;CAC5C,OAAO,gBAAI,MAAM,CAAqC;AACxD;AAEA,SAAS,EAAS,GAAkD;CAClE,OAAO,OAAO,KAAU,cAAY,KAAkB,CAAC,MAAM,QAAQ,CAAK;AAC5E;AAEA,SAAS,EAAa,GAA+B;CACnD,OAAO,OAAO,KAAU,WAAW,IAAQ;AAC7C;AAEA,SAAS,EAAa,GAAwB;CAC5C,OAAO,OAAO,KAAU,WAAW,IAAQ;AAC7C;AAEA,SAAS,EAAa,GAA+B;CACnD,OAAO,OAAO,KAAU,WAAW,IAAQ;AAC7C;AAEA,SAAS,EACP,GACA,GACA,GACQ;CACR,IAAM,IAAQ,EAAK,MAAa,EAAK;CACrC,OAAO,OAAO,KAAU,YAAY,EAAM,KAAK,IAC3C,IACA;AACN;AAEA,SAAS,EACP,GACgE;CAGhE,OAFK,EAAS,CAAK,IAEZ;EACL,eAAe,EAAa,EAAM,aAAa;EAC/C,mBAAmB,EAAa,EAAM,iBAAiB;EACvD,mBAAmB,EAAa,EAAM,iBAAiB;EACvD,oBAAoB,EAAa,EAAM,kBAAkB;EACzD,gBAAgB,EAAa,EAAM,cAAc;EACjD,gBAAgB,EAAa,EAAM,cAAc;CACnD,IAT6B;AAU/B;AAEA,SAAS,EAAiB,GAAwC;CAGhE,OAFK,EAAS,CAAK,IAEZ;EACL,kBAAkB,EAAa,EAAM,gBAAgB;EACrD,qBAAqB,EAAa,EAAM,mBAAmB;EAC3D,yBAAyB,EAAoB,EAAM,uBAAuB;CAC5E,IAN6B;AAO/B;AAEA,SAAS,EAAe,GAAiD;CACvE,IAAI,CAAC,EAAS,CAAK,GAAG,OAAO;CAC7B,IAAM,IAAM,EAAS,EAAM,GAAG,IAC1B,EAAE,OAAO,EAAa,EAAM,IAAI,KAAK,EAAE,IACvC;CAWJ,OAAO;EACL,MAAM,EAAa,EAAM,IAAI;EAC7B,YAAY,EAAa,EAAM,UAAU;EACzC,WAAW,EAAa,EAAM,SAAS;EACvC;CACF;AACF;AAEA,SAAS,EACP,GACqC;CAErC,OADK,EAAS,CAAK,IACZ,EAAE,aAAa,EAAa,EAAM,WAAW,EAAE,IADzB;AAE/B;AAYA,SAAS,EAAc,GAA+C;CACpE,IAAI,CAAC,EAAS,CAAK,GAAG,OAAO;CAC7B,IAAM,IAA+B,CAAC;CACtC,KAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,CAAK,GAC7C,AAAI,OAAO,KAAU,aACnB,EAAK,KAAO;CAGhB,OAAO;AACT;AAEA,SAAS,EACP,GACkD;CAClD,IAAI,CAAC,EAAS,CAAK,GAAG,OAAO;CAC7B,IAAM,EAAE,kBAAkB,GAAgB,gBAAa;CAIvD,OAHI,OAAO,KAAmB,YAAY,OAAO,KAAa,WACrD,OAEF;EAAE,kBAAkB;EAAgB;CAAS;AACtD;AAEA,SAAS,EAAsB,GAA6B;CAC1D,IAAI,CAAC,EAAK,WAAW,GAAG,GAAG,OAAO;CAElC,IAAM,IAAqB,CAAC;CAC5B,KAAK,IAAM,KAAW,EAAK,MAAM,GAAG,GAClC,IAAI,KAAW,MAAY,KACzB,IAAI,MAAY,MAAM;EACpB,IAAI,CAAC,EAAS,QAAQ,OAAO;EAC7B,EAAS,IAAI;CACf,OACE,EAAS,KAAK,CAAO;CAK3B,OAAO,IAAI,EAAS,KAAK,GAAG;AAC9B;AAEA,SAAS,EAA2B,GAAc,GAA2B;CAC3E,IAAM,IAAiB,EAAsB,CAAI,GAC3C,IAAsB,EAAsB,CAAS;CAE3D,IACE,CAAC,KACD,CAAC,KACA,MAAmB,KAClB,CAAC,EAAe,WAAW,GAAG,EAAoB,EAAE,GAEtD,MAAU,MAAM,uDAAuD;CAGzE,OAAO;AACT;AAEA,SAAS,EAA8B,GAAuC;CAC5E,IAAI,CAAC,EAAS,CAAI,KAAK,OAAO,EAAK,MAAO,YAAY,CAAC,EAAK,GAAG,KAAK,GAClE,MAAM,EAA4B;CAGpC,OAAO;EACL,IAAI,EAAK,GAAG,KAAK;EACjB,OAAO,EAAa,EAAK,KAAK;EAC9B,YAAY,EAAc,GAAM,cAAc,WAAW;EACzD,YAAY,EAAc,GAAM,cAAc,WAAW;EACzD,kBAAkB,EAAa,EAAK,gBAAgB;EACpD,gBAAgB,EAAa,EAAK,cAAc;EAChD,SAAS,EAAiB,EAAK,OAAO;EACtC,OAAO,EAAe,EAAK,KAAK;EAChC,WAAW,EAAmB,EAAK,SAAS;EAC5C,MAAM,EAAc,EAAK,IAAI;EAC7B,wBAAwB,EACtB,EAAK,sBACP;EAKA,kBAAkB,EAAa,EAAK,gBAAgB;EACpD,oBAAoB,EAAa,EAAK,kBAAkB;CAC1D;AACF;AAEA,SAAS,EACP,GAC0B;CAC1B,IAAI,CAAC,MAAM,QAAQ,CAAK,GACtB,MAAM,EAA4B;CAEpC,OAAO,EAAM,IAAI,CAA6B;AAChD;AAEA,SAAS,GAA8B,GAGrC;CACA,IAAI,MAAM,QAAQ,CAAI,GACpB,OAAO;EACL,OAAO,EAA+B,CAAI;EAC1C,cAAc;CAChB;CAGF,IAAI,CAAC,EAAS,CAAI,GAChB,MAAM,EAA4B;CAGpC,OAAO;EACL,OAAO,EAA+B,EAAK,KAAK;EAChD,cACE,OAAO,EAAK,gBAAiB,WAAW,EAAK,eAAe;CAChE;AACF;AAEA,IAAM,KAAmB,IAAI,IAAY;CACvC;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,SAAS,GACP,GACmC;CACnC,IAAM,IAAa,KAAU;CAC7B,OACE,GAAiB,IAAI,CAAU,IAAI,IAAa;AAEpD;AAEA,SAAS,EACP,GACA,GACiB;CACjB,IAAI,CAAC,GACH,MAAU,MAAM,gBAAgB,EAAe,eAAe;CAEhE,OAAO;AACT;AAEA,IAAM,KAAN,MAAqC;CACnC,aAAa,YACX,GACA,GACA,GAC8B;EAC9B,IAAM,IAAS,EAAiB,EAAE,SAC9B,IAAkB,GAAS,mBAAmB,MAC9C,IAAgB,GAAS,iBAAiB;EAE9C,IAAI,EAAO,SAAS,SAAS;GAC3B,IAAI,CAAC,KAAmB,CAAC,GAAe;IACtC,IAAM,CAAC,KAAgB,MAAM,EAA2B,CACtD,CACF,CAAC;IAED,AADA,IAAkB,GAAc,kBAAkB,KAAK,KAAK,MAC5D,IAAgB,GAAc,iBAAiB,KAAK,KAAK;GAC3D;GAEA,IAAI,CAAC,KAAmB,CAAC,GACvB,MAAU,MACR,gFACF;GAaF,OAVA,MAAM,EAAe;IACnB,SAAS;IACT,QAAQ;IACR,cAAc,EAAiB,CAAe;IAC9C,MAAM,sBAAsB,EAAe;IAC3C,MAAM;KAAE,GAAG;KAAS,KAAK;IAAK;IAC9B,UAAU;IACV;GACF,CAAC,GAEM;EACT;EAQA,OANA,MAAM,IAAI,EACR,EAA4B;GAAE;GAAiB;EAAc,CAAC,CAChE,EAAE,UAAU,GAAgB,GAAS,EACnC,KAAK,GACP,CAAC,GAEM;CACT;CAEA,aAAa,mBACX,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GAKA,GACA,GACmC;EACnC,IAAI,EAAiB,EAAE,QAAQ,SAAS,SAyBtC,OAAO,EAA2B;GAhBhC,iBAAiB,IACb;IACE,MAAM;IACN,SAAS,CAAC;KAAE,MAAM;KAAQ,MAAM;IAAe,CAAC;GAClD,IACA;GACJ,OAAO,KAA4B;GACnC,qBAAqB,GAAU,uBAAuB;GACtD,iBAAiB,GAAU,mBAAmB;GAC9C,cAAc,GAAU,gBAAgB;GACxC,SAAS,KAAW;GACpB,wBAAwB,KAAwB;GAChD,YAAY;GACZ,YAAY,KAAa;GACzB,kBAAkB,KAAkB;EAEJ,CAAO;EAG3C,IAAM,CAAC,GAAU,KAAY,MAAM,QAAQ,IAAI,CAC7C,GAAgB,YAAY,GAC5B,EAAgB,aAAa,EAAE,YAAY,KAAA,CAAS,CACtD,CAAC,GACK,IAAkB,EACtB,EAAS,mBACT,CACF,GACM,IAAiB,EAAO,GAOxB,IAAa,MAAM,EACvB,KAAsB,EAA4B,CAAc,CAClE,GACM,IACJ,MAAkB,IAAqB,eAAe,iBAGlD,IAAU,MAAM,EAAmD;GACvE;GACA,OAAO;GACP;GACA;GACA;GACA;GACA,UAAU,MAA0B;GACpC;GACA;GACA;EACF,CAAC,GAEK,IAAO,MAAM,IAAI,EACrB,EAA4B,EAAE,SAAS,EAA+B,CAAC,CACzE,EAAE,mBAA2C,CAAO,GAC9C,IAAe,EAAyB;EAC9C,IAAI,CAAC,GAAc,MAAM,IAAI,EAAwB;EAkBrD,QAhBI,GAAU,uBAAuB,MAOnC,EAA8B,EAAK,IAAI;GACrC,qBAAqB,GAAU,uBAAuB;GACtD,iBAAiB,GAAU,mBAAmB;GAC9C,cAAc,GAAU,gBAAgB;GACxC,oBAAoB,KAAsB;GAC1C,gBAAgB;EAClB,CAAC,GAGI;GACL,IAAI,EAAK;GACT,oBAAoB;GACpB,QAAQ;GACR,QAAQ;GACR,qBAAqB,EAAK;GAC1B,kBAAkB,EAAa;GAC/B,SAAS;IACP,iBAAiB,EAAQ;IAGzB,SAAS,KAAW;GACtB;GACA,YAAY,EAAK;GACjB,YAAY,EAAK;EACnB;CACF;CAEA,aAAa,aACX,GAC0C;EAO1C,OANI,EAAiB,EAAE,QAAQ,SAAS,UAC/B,EAAiC,CAAM,IAKzC;CACT;CAEA,aAAa,aACX,GACA,GACA,GAC+B;EAM/B,IAAM,IACJ,MAAM,KAAK,8BAA8B,CAAc;EAczD,OAAO,EAAE,YAAY,MAXG,IAAI,EAC1B,EAA4B;GAC1B;GACA;EACF,CAAC,CACH,EAAE,OAAO;GACP,SACE,OAAO,SAAW,MAAc,OAAO,SAAS,SAAS,KAAA;GAC3D;EACF,CAAC,EAE8B;CACjC;CAEA,aAAa,8BACX,GACiB;EACjB,IAAM,CAAC,KAAgB,MAAM,KAAK,yBAAyB,CACzD,CACF,CAAC;EACD,OAAO,GAAc,WAAW,eAAe,EAAyB;CAC1E;CAEA,aAAa,yBACX,GACqC;EAWrC,OAVI,EAAI,WAAW,IAAU,CAAC,IAE1B,EAAiB,EAAE,QAAQ,SAAS,UAC/B,EAA2B,CAAG,IAOhC,EAA+B,MAJnB,IAAI,EACrB,EAA4B,CAC9B,EAAE,iBAAyC,CAAG,CAEJ,EAAE,KAAK,MAC/C,EAAkB,CAAI,CACxB;CACF;CAEA,aAAa,6BACX,GACA,GAC0B;EAC1B,IAAI,EAAiB,EAAE,QAAQ,SAAS,SACtC,MAAU,MAAM,0CAA0C;EAE5D,OAAO,EAAkC,GAAgB,CAAQ;CACnE;CAEA,aAAa,6BACX,GACA,GACA,GACA,GAC0B;EAC1B,AAAI,IAEF,EAA8B,GAAgB;GAC5C,GAFe,EAA8B,CAEzC,KAAY,CAAC;GACjB,qBAAqB;GACrB,iBAAiB,KAAU;GAC3B,cAAe,KAA+C;EAChE,CAAC,IAED,EAAiC,CAAc;EAEjD,IAAM,CAAC,KAAgB,MAAM,KAAK,yBAAyB,CACzD,CACF,CAAC;EACD,OAAO,EAAuB,GAAc,CAAc;CAC5D;CAEA,aAAa,qBACX,GACA,GACiB;EACjB,IAAI,EAAiB,EAAE,QAAQ,SAAS,SAQtC,OAAO,EAA0B,GAJpB,EACX,KAAY,0CACZ,oBAE+C,CAAI;EAGvD,IAAM,IAAa,MAAM,KAAK,8BAA8B,CAAc,GACpE,IAAO,EACX,KAAY,GAAG,EAAW,uBAC1B,CACF;EACA,OAAO,IAAI,EAAW,EAA4B,CAAC,EAAE,iBAAiB,CAAI;CAC5E;CAEA,aAAa,qBAAqB,GAAuC;EAKvE,OAJI,EAAiB,EAAE,QAAQ,SAAS,UAC/B,EAA0B,CAAc,IAG1C,IAAI,EAAW,EAA4B,CAAC,EAAE,mBACnD,CACF;CACF;CAEA,aAAa,SAAS,GAAmD;EAIvE,OAAO,EAAmB;CAC5B;CAEA,aAAa,uBACX,GACA,GACA,GACkC;EAClC,IAAM,IAAS,EAAiB,EAAE,SAU5B,IACJ,EAAO,SAAS,WAAW,IACvB,MAAM,EAA2B;GAC/B,SAAS;GACT,QAAQ;GACR,cAAc,EAAiB,CAAe;GAC9C,MAAM,sBAAsB;GAC5B,UAAU;GACV;EACF,CAAC,IACD,MAAM,IAAI,EACR,EAA4B;GAC1B;GACA;EACF,CAAC,CACH,EAAE,gBAA4B,CAAc,GAC5C,IAAO,EAA8B,CAAQ,GAC7C,IAAQ,EAAS,CAAQ,IAAI,EAAS,QAAQ;EAEpD,OAAO;GACL,IAAI,EAAK;GACT,OAAO,EAAK,OAAO,KAAK,IACpB,EAAK,QACL,EAA4B,EAAK,EAAE;GACvC,SAAS,EAAiB,EAAK,OAAO;GACtC,YAAY,EAAK;GACjB,YAAY,EAAK;GACjB,QAAQ,GAAgB,EAAK,gBAAgB;GAC7C,OAAO,EAAS,CAAK,IAAI,IAAQ,EAAE,kBAAkB,CAAC,EAAE;EAC1D;CACF;CAEA,aAAa,oBACX,IAAgB,IAChB,GAC8B;EAa9B,OAZI,EAAiB,EAAE,QAAQ,SAAS,UAC/B,EAAyB,GAAO,CAAM,IAWxC,EAAmB,GAA8B,MARrC,IAAI,EACrB,EAA4B,CAC9B,EAAE,oBAAoB;GACpB;GACA,SAAS;GACT,YAAY,EAAsB;EACpC,CAAC,CAE2D,CAAC;CAC/D;CAEA,aAAa,mBAAmB,GAAuC;EAQrE,AAPI,EAAiB,EAAE,QAAQ,SAAS,UACtC,MAAM,EAAwB,CAAc,IAE5C,MAAM,IAAI,EACR,EAA4B,CAC9B,EAAE,mBAAmB,CAAc,GAErC,EAAiC,CAAc;CACjD;CAEA,aAAa,wBACX,GACA,GAC0B;EAC1B,MAAM,IAAI,EACR,EAA4B,CAC9B,EAAE,mBAAmB,GAAgB,EACnC,SACF,CAAC;EACD,IAAM,CAAC,KAAgB,MAAM,KAAK,yBAAyB,CACzD,CACF,CAAC;EACD,OAAO,EAAuB,GAAc,CAAc;CAC5D;CAOA,aAAa,iBACX,GACA,GACA,GACiC;EACjC,IAAI,EAAiB,EAAE,QAAQ,SAAS,SACtC,MAAU,MACR,oEACF;EAOF,IAAM,IAAO,MAAM,IAAI,EACrB,EAA4B,CAC9B,EAAE,iBAAyC,GAAsB;GAC/D,eAAe;GACf,GAAI,IAAQ,EAAE,SAAM,IAAI,CAAC;EAC3B,CAAwD,GAIlD,IAAiB,EAA8B,CAAoB;EAKzE,OAJI,KACF,EAA8B,EAAK,IAAI,CAAc,GAGhD;CACT;CAOA,aAAa,iBACX,GACA,GAC6B;EAI7B,QAAO,MAHc,IAAI,EACvB,EAA4B,CAC9B,EAAE,SAAS,GAAgB,CAAO,GACrB,aAAa,KAAA;CAC5B;CAmBA,aAAa,cACX,GACA,GACe;EACf,IAAM,EAAE,eAAY,EAAiB;EAErC,IAAI,EAAQ,SAAS,SAAS;GAI5B,IAAI,CAAC,GAAgB;IACnB,MAAM,EAAgB,gBAAgB,CAAW;IACjD;GACF;GACA,MAAM,EAAe;IACnB;IACA,QAAQ;IACR,MAAM,6BAA6B,EAAe;IAClD,MAAM,EAAE,cAAc,EAAY;GACpC,CAAC;GACD;EACF;EAEA,IAAI,CAAC,GAAgB;GACnB,MAAM,IAAI,EAAe,EAA4B,CAAC,EAAE,gBACtD,CACF;GACA;EACF;EAEA,IAAM,IAAgB,EAA4B,GAC5C,IAAqB,IAAI,EAAmB,CAAa,GACzD,IAAU,MAAM,IAAI,EAAe,CAAa,EAAE,WACtD,GACA,EAAE,eAAe,YAAY,CAC/B,GACM,IACJ,OAAO,EAAQ,OAAO,SAAU,WAAW,EAAQ,OAAO,QAAQ;EACpE,IAAI,CAAC,GAAO,MAAU,MAAM,YAAY,EAAY,gBAAgB;EAEpE,AADA,MAAM,EAA4B,EAAE,KAAK,EAAQ,OAAO,CAAC,GACzD,MAAM,EAAmB,UAAU,GAAgB;GACjD,GAAG,EAAQ;GACX;GAGA,QAAQ;GAER,UAAU,WAAW,EAAY,GAAG,EAAO;EAC7C,CAAc;CAChB;CAeA,aAAa,eACX,GACA,GACe;EACf,IAAM,EAAE,eAAY,EAAiB;EACrC,IAAI,EAAQ,SAAS,SAAS;GAC5B,MAAM,EAAe;IACnB;IACA,QAAQ;IACR,MAAM,6BAA6B,EAAe;IAClD,MAAM,EAAE,SAAM;GAChB,CAAC;GACD;EACF;EAEA,MAAM,IAAI,EAAmB,EAA4B,CAAC,EAAE,eAC1D,GACA,CACF;CACF;AACF"}
+{"version":3,"file":"agent-server-conversation-service.api.js","names":[],"sources":["../../../src/api/conversation-service/agent-server-conversation-service.api.ts"],"sourcesContent":["import {\n  ConversationSortOrder,\n  type ForkConversationRequest,\n  type LLMConfig,\n} 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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"}

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

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/conversation-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const t=require("../../utils/websocket-url.cjs"),n=require("../backend-registry/active-store.cjs"),r=require("../agent-server-client-options.cjs"),i=require("../../node_modules/@openhands/typescript-client/dist/events/remote-events-list.cjs"),a=require("../cloud/proxy.cjs");var o=class{static async respondToConfirmation(i,o,s,c){let l=n.getActiveBackend().backend;return l.kind===`cloud`?a.callCloudProxy({backend:l,method:`POST`,hostOverride:t.buildHttpBaseUrl(o),path:`/api/conversations/${i}/events/respond_to_confirmation`,body:s,authMode:`session-api-key`,sessionApiKey:c}):new e.ConversationClient(r.getAgentServerClientOptions({conversationUrl:o,sessionApiKey:c})).respondToConfirmation(i,s)}static async getEventCount(i,o,s){let c=n.getActiveBackend().backend;return c.kind===`cloud`?a.callCloudProxy({backend:c,method:`GET`,hostOverride:t.buildHttpBaseUrl(o),path:`/api/conversations/${i}/events/count`,authMode:`session-api-key`,sessionApiKey:s}):new e.ConversationClient(r.getAgentServerClientOptions({conversationUrl:o,sessionApiKey:s})).getEventCount(i)}static async searchEvents(e,t,o,s={}){let c=n.getActiveBackend().backend,l=s.limit??100;if(c.kind===`cloud`){let t=Math.min(l,100),n=!!(s.sortOrder||s.pageId||s.timestampGte||s.timestampLt),r=new URLSearchParams;r.set(`limit`,String(t)),s.sortOrder&&r.set(`sort_order`,s.sortOrder),s.pageId&&r.set(`page_id`,s.pageId),s.timestampGte&&r.set(`timestamp__gte`,s.timestampGte),s.timestampLt&&r.set(`timestamp__lt`,s.timestampLt);let i=t=>a.callCloudProxy({backend:c,method:`GET`,path:`/api/v1/conversation/${e}/events/search?${t.toString()}`});try{let e=await i(r);return{items:e?.items??[],next_page_id:e?.next_page_id??null}}catch(e){if(!n||s.strictPagination)throw e;return console.warn(`[EventService] Cloud backend doesn't support pagination filters. Falling back to initial load only. Server needs OpenHands/OpenHands#14399.`),{items:[],next_page_id:null}}}let u=await new i.RemoteEventsList(r.getAgentServerHttpClientOptions({conversationUrl:t,sessionApiKey:o}),e).search({limit:l,...s.pageId?{page_id:s.pageId}:{},...s.sortOrder?{sort_order:s.sortOrder}:{},...s.timestampGte?{timestamp__gte:s.timestampGte}:{},...s.timestampLt?{timestamp__lt:s.timestampLt}:{}});return{items:u?.items??[],next_page_id:u?.next_page_id??null}}};exports.default=o;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/conversation-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const t=require("../../utils/websocket-url.cjs"),n=require("../backend-registry/active-store.cjs"),r=require("../agent-server-client-options.cjs"),i=require("../cloud/proxy.cjs"),a=require("../../node_modules/@openhands/typescript-client/dist/events/remote-events-list.cjs");var o=class{static async respondToConfirmation(a,o,s,c){let l=n.getActiveBackend().backend;return l.kind===`cloud`?i.callCloudProxy({backend:l,method:`POST`,hostOverride:t.buildHttpBaseUrl(o),path:`/api/conversations/${a}/events/respond_to_confirmation`,body:s,authMode:`session-api-key`,sessionApiKey:c}):new e.ConversationClient(r.getAgentServerClientOptions({conversationUrl:o,sessionApiKey:c})).respondToConfirmation(a,s)}static async getEventCount(a,o,s){let c=n.getActiveBackend().backend;return c.kind===`cloud`?i.callCloudProxy({backend:c,method:`GET`,hostOverride:t.buildHttpBaseUrl(o),path:`/api/conversations/${a}/events/count`,authMode:`session-api-key`,sessionApiKey:s}):new e.ConversationClient(r.getAgentServerClientOptions({conversationUrl:o,sessionApiKey:s})).getEventCount(a)}static async searchEvents(e,t,o,s={}){let c=n.getActiveBackend().backend,l=s.limit??100;if(c.kind===`cloud`){let t=Math.min(l,100),n=!!(s.sortOrder||s.pageId||s.timestampGte||s.timestampLt),r=new URLSearchParams;r.set(`limit`,String(t)),s.sortOrder&&r.set(`sort_order`,s.sortOrder),s.pageId&&r.set(`page_id`,s.pageId),s.timestampGte&&r.set(`timestamp__gte`,s.timestampGte),s.timestampLt&&r.set(`timestamp__lt`,s.timestampLt);let a=t=>i.callCloudProxy({backend:c,method:`GET`,path:`/api/v1/conversation/${e}/events/search?${t.toString()}`});try{let e=await a(r);return{items:e?.items??[],next_page_id:e?.next_page_id??null}}catch(e){if(!n||s.strictPagination)throw e;return console.warn(`[EventService] Cloud backend doesn't support pagination filters. Falling back to initial load only. Server needs OpenHands/OpenHands#14399.`),{items:[],next_page_id:null}}}let u=await new a.RemoteEventsList(r.getAgentServerHttpClientOptions({conversationUrl:t,sessionApiKey:o}),e).search({limit:l,...s.pageId?{page_id:s.pageId}:{},...s.sortOrder?{sort_order:s.sortOrder}:{},...s.timestampGte?{timestamp__gte:s.timestampGte}:{},...s.timestampLt?{timestamp__lt:s.timestampLt}:{}});return{items:u?.items??[],next_page_id:u?.next_page_id??null}}};exports.default=o;
 //# sourceMappingURL=event-service.api.cjs.map

package/dist/api/event-service/event-service.api.js

@@ -3,36 +3,36 @@ import "../../node_modules/@openhands/typescript-client/dist/clients.js";
 import { buildHttpBaseUrl as t } from "../../utils/websocket-url.js";
 import { getActiveBackend as n } from "../backend-registry/active-store.js";
 import { getAgentServerClientOptions as r, getAgentServerHttpClientOptions as i } from "../agent-server-client-options.js";
-import { RemoteEventsList as a } from "../../node_modules/@openhands/typescript-client/dist/events/remote-events-list.js";
-import { callCloudProxy as o } from "../cloud/proxy.js";
+import { callCloudProxy as a } from "../cloud/proxy.js";
+import { RemoteEventsList as o } from "../../node_modules/@openhands/typescript-client/dist/events/remote-events-list.js";
 //#region src/api/event-service/event-service.api.ts
 var s = class {
-	static async respondToConfirmation(i, a, s, c) {
+	static async respondToConfirmation(i, o, s, c) {
 		let l = n().backend;
-		return l.kind === "cloud" ? o({
+		return l.kind === "cloud" ? a({
 			backend: l,
 			method: "POST",
-			hostOverride: t(a),
+			hostOverride: t(o),
 			path: `/api/conversations/${i}/events/respond_to_confirmation`,
 			body: s,
 			authMode: "session-api-key",
 			sessionApiKey: c
 		}) : new e(r({
-			conversationUrl: a,
+			conversationUrl: o,
 			sessionApiKey: c
 		})).respondToConfirmation(i, s);
 	}
-	static async getEventCount(i, a, s) {
+	static async getEventCount(i, o, s) {
 		let c = n().backend;
-		return c.kind === "cloud" ? o({
+		return c.kind === "cloud" ? a({
 			backend: c,
 			method: "GET",
-			hostOverride: t(a),
+			hostOverride: t(o),
 			path: `/api/conversations/${i}/events/count`,
 			authMode: "session-api-key",
 			sessionApiKey: s
 		}) : new e(r({
-			conversationUrl: a,
+			conversationUrl: o,
 			sessionApiKey: s
 		})).getEventCount(i);
 	}
@@ -41,7 +41,7 @@ var s = class {
 		if (c.kind === "cloud") {
 			let t = Math.min(l, 100), n = !!(s.sortOrder || s.pageId || s.timestampGte || s.timestampLt), r = new URLSearchParams();
 			r.set("limit", String(t)), s.sortOrder && r.set("sort_order", s.sortOrder), s.pageId && r.set("page_id", s.pageId), s.timestampGte && r.set("timestamp__gte", s.timestampGte), s.timestampLt && r.set("timestamp__lt", s.timestampLt);
-			let i = (t) => o({
+			let i = (t) => a({
 				backend: c,
 				method: "GET",
 				path: `/api/v1/conversation/${e}/events/search?${t.toString()}`
@@ -60,7 +60,7 @@ var s = class {
 				};
 			}
 		}
-		let u = await new a(i({
+		let u = await new o(i({
 			conversationUrl: t,
 			sessionApiKey: r
 		}), e).search({

package/dist/api/launch-child-conversation-client-tool.cjs

@@ -0,0 +1,47 @@
+require("../_virtual/_rolldown/runtime.cjs");const e=require("../constants/child-conversation.cjs");var t=`Start a NEW, independent conversation to work on a well-scoped task in parallel with this one, without the user having to run any CLI command. The new conversation is recorded as a child of this one.
+
+The child runs on its own. It does not block you, you do not see its output,
+and it cannot see this conversation's history — everything it needs must be in
+the task brief.
+
+Choosing target:
+
+* target="local" — runs on the same machine, in this conversation's workspace.
+  Fast, no repository clone, no sandbox provisioning. Use this by default when
+  the work is on code that is already checked out here.
+
+* target="cloud" — runs on OpenHands Cloud in its own isolated sandbox, from a
+  git repository. Use this when the work should not touch the user's machine or
+  when it needs a repository that is not checked out locally. Requires the user
+  to have an OpenHands Cloud backend connected in Agent Canvas; if none is
+  connected you will be told so and should fall back to target="local".
+
+Writing the task brief:
+
+* Put everything the child needs in "task": the goal, the relevant file paths,
+  the constraints, the expected deliverable, and how it should report back.
+* Keep each child's scope independent of its siblings so parallel children do
+  not fight over the same files.
+* One call per delegated task. Do NOT call this tool twice for the same task.
+
+Parameter rules (a call that breaks one of these launches nothing and comes
+back with corrective guidance):
+
+* "repository" and "branch" apply to target="cloud" only. A local child always
+  inherits this conversation's workspace, so do not pass them with
+  target="local".
+* "isolation" applies to target="local" only. Cloud sandboxes are always
+  isolated, so do not pass it with target="cloud".
+* isolation="worktree" (the default) gives the child its own git worktree and
+  branch, cut from the repository's default branch — it will NOT see this
+  conversation's uncommitted or committed work. isolation="shared" puts the
+  child in this conversation's exact directory; only choose it when the child
+  genuinely must see work in progress, and expect the two agents to conflict.
+
+What comes back: this tool is acknowledged immediately, before the conversation
+exists. The real outcome arrives moments later as a follow-up message starting
+with "${e.CHILD_CONVERSATION_RESULT_PREFIX.trim()}" that carries the child's
+conversation id, URL, target and initial status — or an error with guidance.
+Wait for it, then tell the user what you launched and give them the URL. If it
+reports an error, fix the parameters and call this tool again.`,n={name:e.LAUNCH_CHILD_CONVERSATION_TOOL_NAME,description:t,parameters:{type:`object`,additionalProperties:!1,properties:{target:{type:`string`,enum:[...e.CHILD_CONVERSATION_TARGETS],description:`Where the child runs. 'local' reuses this machine and this conversation's workspace; 'cloud' runs in an isolated OpenHands Cloud sandbox.`},task:{type:`string`,description:`Self-contained task brief, sent as the child's first message. The child cannot see this conversation, so state the goal, constraints, expected output and handoff criteria.`},title:{type:`string`,description:`Optional short title for the child conversation. Omit to let it title itself from the task.`},repository:{type:`string`,description:`target='cloud' only. Repository to clone into the sandbox, as 'owner/repo'. Defaults to this conversation's repository when it has one.`},branch:{type:`string`,description:`target='cloud' only, and only together with 'repository'. Defaults to the repository's default branch.`},isolation:{type:`string`,enum:[...e.CHILD_CONVERSATION_ISOLATIONS],description:`target='local' only. 'worktree' (default) gives the child its own git worktree and branch; 'shared' runs it in this conversation's exact directory.`}},required:[`target`,`task`]},annotations:{readOnlyHint:!1,destructiveHint:!1,idempotentHint:!1,openWorldHint:!0}};exports.LAUNCH_CHILD_CONVERSATION_CLIENT_TOOL=n;
+//# sourceMappingURL=launch-child-conversation-client-tool.cjs.map

package/dist/api/launch-child-conversation-client-tool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-child-conversation-client-tool.cjs","names":[],"sources":["../../src/api/launch-child-conversation-client-tool.ts"],"sourcesContent":["import {\n  CHILD_CONVERSATION_ISOLATIONS,\n  CHILD_CONVERSATION_RESULT_PREFIX,\n  CHILD_CONVERSATION_TARGETS,\n  LAUNCH_CHILD_CONVERSATION_TOOL_NAME,\n} from \"#/constants/child-conversation\";\nimport type { ClientToolSpec } from \"./canvas-ui-client-tool\";\n\nexport {\n  LAUNCH_CHILD_CONVERSATION_ACTION_KIND,\n  LAUNCH_CHILD_CONVERSATION_TOOL_NAME,\n} from \"#/constants/child-conversation\";\n\nconst LAUNCH_CHILD_CONVERSATION_DESCRIPTION = `Start a NEW, independent conversation to work on a well-scoped task in parallel with this one, without the user having to run any CLI command. The new conversation is recorded as a child of this one.\n\nThe child runs on its own. It does not block you, you do not see its output,\nand it cannot see this conversation's history — everything it needs must be in\nthe task brief.\n\nChoosing target:\n\n* target=\"local\" — runs on the same machine, in this conversation's workspace.\n  Fast, no repository clone, no sandbox provisioning. Use this by default when\n  the work is on code that is already checked out here.\n\n* target=\"cloud\" — runs on OpenHands Cloud in its own isolated sandbox, from a\n  git repository. Use this when the work should not touch the user's machine or\n  when it needs a repository that is not checked out locally. Requires the user\n  to have an OpenHands Cloud backend connected in Agent Canvas; if none is\n  connected you will be told so and should fall back to target=\"local\".\n\nWriting the task brief:\n\n* Put everything the child needs in \"task\": the goal, the relevant file paths,\n  the constraints, the expected deliverable, and how it should report back.\n* Keep each child's scope independent of its siblings so parallel children do\n  not fight over the same files.\n* One call per delegated task. Do NOT call this tool twice for the same task.\n\nParameter rules (a call that breaks one of these launches nothing and comes\nback with corrective guidance):\n\n* \"repository\" and \"branch\" apply to target=\"cloud\" only. A local child always\n  inherits this conversation's workspace, so do not pass them with\n  target=\"local\".\n* \"isolation\" applies to target=\"local\" only. Cloud sandboxes are always\n  isolated, so do not pass it with target=\"cloud\".\n* isolation=\"worktree\" (the default) gives the child its own git worktree and\n  branch, cut from the repository's default branch — it will NOT see this\n  conversation's uncommitted or committed work. isolation=\"shared\" puts the\n  child in this conversation's exact directory; only choose it when the child\n  genuinely must see work in progress, and expect the two agents to conflict.\n\nWhat comes back: this tool is acknowledged immediately, before the conversation\nexists. The real outcome arrives moments later as a follow-up message starting\nwith \"${CHILD_CONVERSATION_RESULT_PREFIX.trim()}\" that carries the child's\nconversation id, URL, target and initial status — or an error with guidance.\nWait for it, then tell the user what you launched and give them the URL. If it\nreports an error, fix the parameters and call this tool again.`;\n\nexport const LAUNCH_CHILD_CONVERSATION_CLIENT_TOOL: ClientToolSpec = {\n  name: LAUNCH_CHILD_CONVERSATION_TOOL_NAME,\n  description: LAUNCH_CHILD_CONVERSATION_DESCRIPTION,\n  parameters: {\n    type: \"object\",\n    additionalProperties: false,\n    properties: {\n      target: {\n        type: \"string\",\n        enum: [...CHILD_CONVERSATION_TARGETS],\n        description:\n          \"Where the child runs. 'local' reuses this machine and this conversation's workspace; 'cloud' runs in an isolated OpenHands Cloud sandbox.\",\n      },\n      task: {\n        type: \"string\",\n        description:\n          \"Self-contained task brief, sent as the child's first message. The child cannot see this conversation, so state the goal, constraints, expected output and handoff criteria.\",\n      },\n      title: {\n        type: \"string\",\n        description:\n          \"Optional short title for the child conversation. Omit to let it title itself from the task.\",\n      },\n      repository: {\n        type: \"string\",\n        description:\n          \"target='cloud' only. Repository to clone into the sandbox, as 'owner/repo'. Defaults to this conversation's repository when it has one.\",\n      },\n      branch: {\n        type: \"string\",\n        description:\n          \"target='cloud' only, and only together with 'repository'. Defaults to the repository's default branch.\",\n      },\n      isolation: {\n        type: \"string\",\n        enum: [...CHILD_CONVERSATION_ISOLATIONS],\n        description:\n          \"target='local' only. 'worktree' (default) gives the child its own git worktree and branch; 'shared' runs it in this conversation's exact directory.\",\n      },\n    },\n    required: [\"target\", \"task\"],\n  },\n  annotations: {\n    // Launching a conversation writes real state and is not repeatable, so the\n    // agent is asked to predict a security risk before every call.\n    readOnlyHint: false,\n    destructiveHint: false,\n    idempotentHint: false,\n    // The cloud target reaches OpenHands Cloud.\n    openWorldHint: true,\n  },\n};\n"],"mappings":"oGAaA,IAAM,EAAwC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA0CtC,EAAA,iCAAiC,KAAK,EAAE;;;gEAKnC,EAAwD,CACnE,KAAM,EAAA,oCACN,YAAa,EACb,WAAY,CACV,KAAM,SACN,qBAAsB,GACtB,WAAY,CACV,OAAQ,CACN,KAAM,SACN,KAAM,CAAC,GAAG,EAAA,0BAA0B,EACpC,YACE,2IACJ,EACA,KAAM,CACJ,KAAM,SACN,YACE,6KACJ,EACA,MAAO,CACL,KAAM,SACN,YACE,6FACJ,EACA,WAAY,CACV,KAAM,SACN,YACE,yIACJ,EACA,OAAQ,CACN,KAAM,SACN,YACE,wGACJ,EACA,UAAW,CACT,KAAM,SACN,KAAM,CAAC,GAAG,EAAA,6BAA6B,EACvC,YACE,qJACJ,CACF,EACA,SAAU,CAAC,SAAU,MAAM,CAC7B,EACA,YAAa,CAGX,aAAc,GACd,gBAAiB,GACjB,eAAgB,GAEhB,cAAe,EACjB,CACF"}

package/dist/api/launch-child-conversation-client-tool.d.ts

@@ -0,0 +1,3 @@
+import type { ClientToolSpec } from "./canvas-ui-client-tool";
+export { LAUNCH_CHILD_CONVERSATION_ACTION_KIND, LAUNCH_CHILD_CONVERSATION_TOOL_NAME, } from "#/constants/child-conversation";
+export declare const LAUNCH_CHILD_CONVERSATION_CLIENT_TOOL: ClientToolSpec;