@openhands/agent-canvas 1.0.0-rc.1 → 1.0.0-rc.3

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

@@ -3,23 +3,34 @@ import { getAgentServerWorkingDir as t, shouldLoadPublicSkills as n } from "./ag
 import { getEffectiveLocalBackend as r } from "./backend-registry/active-store.js";
 import { getAgentServerClientOptions as i } from "./agent-server-client-options.js";
 import { buildAuthHeaders as a } from "./backend-registry/auth.js";
-import { getStoredConversationMetadata as o } from "./conversation-metadata-store.js";
-import { DEFAULT_SETTINGS as s } from "../services/settings.js";
-import { getAcpProvider as c, resolveEffectiveAcpModel as l } from "../constants/acp-providers.js";
-import { isAgentServerToolAvailable as u } from "./agent-server-compatibility.js";
-import d from "./settings-service/settings-service.api.js";
+import { ACP_SETTINGS_KEYS as o } from "../node_modules/@openhands/typescript-client/dist/models/acp.js";
+import "../node_modules/@openhands/typescript-client/dist/index.js";
+import { getStoredConversationMetadata as s } from "./conversation-metadata-store.js";
+import { DEFAULT_SETTINGS as c } from "../services/settings.js";
+import { getAcpProvider as l, resolveEffectiveAcpModel as u } from "../constants/acp-providers.js";
+import { isAgentServerToolAvailable as d } from "./agent-server-compatibility.js";
+import f from "./settings-service/settings-service.api.js";
 //#region src/api/agent-server-adapter.ts
-var f = "canvas_ui", p = "canvas_ui_tool", m = [
+var p = "canvas_ui", m = "canvas_ui_tool", h = [
 	"terminal",
 	"file_editor",
 	"task_tracker",
-	f
-], h = "browser_tool_set", g = "task_tool_set";
-function _() {
+	p
+], g = "browser_tool_set", _ = "task_tool_set";
+function v() {
 	return !0;
 }
-function v() {
+function y() {
 	let e = (void 0)?.trim();
+	if (e) return e;
+	if (typeof window < "u") {
+		let e = window.__AGENT_CANVAS_RUNTIME_SERVICES_INFO__;
+		if (typeof e == "string") return e.trim() || null;
+	}
+	return null;
+}
+function b() {
+	let e = y();
 	if (!e) return null;
 	try {
 		let t = JSON.parse(e);
@@ -28,8 +39,8 @@ function v() {
 		return null;
 	}
 }
-function y() {
-	let e = v();
+function x() {
+	let e = b();
 	if (!e?.services) return;
 	let t = [];
 	t.push("<RUNTIME_SERVICES>"), e.mode ? t.push(`You are running inside an agent-canvas dev stack started in '${e.mode}' mode.`) : t.push("You are running inside an agent-canvas dev stack."), t.push("The following services are reachable from your sandbox. URLs are written", "from your point of view (i.e., as you should curl/fetch them).", "");
@@ -38,15 +49,15 @@ function y() {
 	let o = n?.url_from_agent;
 	return t.push("", "Trust this block over guessing: do not assume any other URLs are running."), o && t.push(`In particular, ${o} inside your sandbox is the Agent Server`, "you are running inside of — NOT the automation backend."), t.push("</RUNTIME_SERVICES>"), t.join("\n");
 }
-function b(e) {
+function S(e) {
 	let { host: t } = i();
 	return `${t}/api/conversations/${e}`;
 }
-function x(e) {
+function C(e) {
 	return `Conversation ${e.slice(0, 5)}`;
 }
-function S(n) {
-	let r = o(n.id), a = n.agent?.kind === "ACPAgent", c = a ? n.tags?.acpserver ?? null : null;
+function w(n) {
+	let r = s(n.id), a = n.agent?.kind === "ACPAgent", o = a ? n.tags?.acpserver ?? null : null;
 	return {
 		id: n.id,
 		created_by_user_id: null,
@@ -54,17 +65,18 @@ function S(n) {
 		selected_branch: r?.selected_branch ?? null,
 		git_provider: r?.git_provider ?? null,
 		selected_workspace: r?.selected_workspace ?? null,
-		title: n.title?.trim() ? n.title : x(n.id),
+		active_profile: r?.active_profile ?? null,
+		title: n.title?.trim() ? n.title : C(n.id),
 		trigger: null,
 		pr_number: [],
 		agent_kind: a ? "acp" : "openhands",
-		acp_server: c,
-		llm_model: a ? l({
+		acp_server: o,
+		llm_model: a ? u({
 			runtimeName: n.current_model_name,
 			runtimeId: n.current_model_id,
 			configured: n.agent?.acp_model,
 			sdkLlm: n.agent?.llm?.model
-		}) : n.agent?.llm?.model ?? s.llm_model,
+		}) : n.agent?.llm?.model ?? c.llm_model,
 		metrics: n.metrics ? {
 			accumulated_cost: n.metrics.accumulated_cost ?? null,
 			max_budget_per_task: n.metrics.max_budget_per_task ?? null,
@@ -81,7 +93,7 @@ function S(n) {
 		updated_at: n.updated_at,
 		execution_status: n.execution_status ?? e.IDLE,
 		sandbox_status: n.sandbox_status ?? null,
-		conversation_url: b(n.id),
+		conversation_url: S(n.id),
 		session_api_key: i().apiKey ?? null,
 		sandbox_id: null,
 		workspace: { working_dir: n.workspace?.working_dir ?? t() },
@@ -89,19 +101,13 @@ function S(n) {
 		sub_conversation_ids: []
 	};
 }
-function C(e) {
+function T(e) {
 	return {
-		items: e.items.map(S),
+		items: e.items.map(w),
 		next_page_id: e.next_page_id ?? null
 	};
 }
-var w = [
-	"acp_command",
-	"acp_args",
-	"acp_model",
-	"acp_session_mode",
-	"acp_prompt_timeout"
-], T = "acpserver", E = new Set([
+var E = "acpserver", D = new Set([
 	"schema_version",
 	"agent_settings",
 	"workspace",
@@ -109,22 +115,22 @@ var w = [
 	"initial_message",
 	"plugins"
 ]);
-function D(e) {
+function O(e) {
 	return !e || typeof e != "object" || Array.isArray(e) ? {} : structuredClone(e);
 }
-function O(e) {
+function k(e) {
 	if (typeof e != "string") return;
 	let t = e.trim();
 	return t.length > 0 ? t : void 0;
 }
-function k(e) {
+function A(e) {
 	return e.confirmation_mode === !0 ? e.security_analyzer === "llm" ? {
 		kind: "ConfirmRisky",
 		threshold: "HIGH",
 		confirm_unknown: !0
 	} : { kind: "AlwaysConfirm" } : { kind: "NeverConfirm" };
 }
-function A(e) {
+function j(e) {
 	switch (e.security_analyzer) {
 		case "llm": return { kind: "LLMSecurityAnalyzer" };
 		case "pattern": return { kind: "PatternSecurityAnalyzer" };
@@ -132,30 +138,30 @@ function A(e) {
 		default: return;
 	}
 }
-function j(e) {
+function M(e) {
 	return !!e && typeof e == "object" && !Array.isArray(e) && typeof e.name == "string";
 }
-function M(e, t) {
-	return e === h ? _() && u(e) : e === g ? t.enable_sub_agents === !0 && u(e) : !0;
+function N(e, t) {
+	return e === g ? v() && d(e) : e === _ ? t.enable_sub_agents === !0 && d(e) : !0;
 }
-function N(e) {
+function P(e) {
 	let t = /* @__PURE__ */ new Map();
-	for (let e of m) t.set(e, {
+	for (let e of h) t.set(e, {
 		name: e,
 		params: {}
 	});
-	for (let n of [h, g]) M(n, e) && t.set(n, {
+	for (let n of [g, _]) N(n, e) && t.set(n, {
 		name: n,
 		params: {}
 	});
 	let n = e.tools;
-	if (Array.isArray(n) && n.every((e) => j(e))) for (let r of n) M(r.name, e) && t.set(r.name, {
+	if (Array.isArray(n) && n.every((e) => M(e))) for (let r of n) N(r.name, e) && t.set(r.name, {
 		name: r.name,
-		params: D(r.params)
+		params: O(r.params)
 	});
 	return Array.from(t.values());
 }
-function P(e, t) {
+function F(e, t) {
 	let n = [e?.trim(), t?.trim()].filter(Boolean);
 	return n.length === 0 ? null : {
 		role: "user",
@@ -166,68 +172,70 @@ function P(e, t) {
 		run: !0
 	};
 }
-function F(e) {
-	let t = y();
+function I(e) {
+	let t = x();
 	return {
-		...D(e.agent_context),
+		...O(e.agent_context),
 		load_public_skills: n(),
 		load_user_skills: !0,
 		load_project_skills: !0,
 		...t ? { system_message_suffix: t } : {}
 	};
 }
-function I(e) {
-	return D(e.agent_settings).agent_kind === "acp";
-}
 function L(e) {
-	let t = D(e.agent_settings).acp_server;
-	return typeof t == "string" && t.length > 0 ? t : void 0;
+	return O(e.agent_settings).agent_kind === "acp";
 }
 function R(e) {
+	let t = O(e.agent_settings).acp_server;
+	return typeof t == "string" && t.length > 0 ? t : void 0;
+}
+function z(e) {
 	let t = e.acp_command;
 	if (!(Array.isArray(t) && t.length === 0) && t !== void 0) return t;
-	let n = c(typeof e.acp_server == "string" ? e.acp_server : void 0);
+	let n = l(typeof e.acp_server == "string" ? e.acp_server : void 0);
 	return n ? [...n.default_command] : t;
 }
-function z(e) {
-	let t = D(e.agent_settings), n = {
+function B(e) {
+	let t = O(e.agent_settings), n = {
 		agent_kind: "acp",
-		agent_context: F(t)
+		agent_context: I(t)
 	};
-	for (let e of w) {
-		if (e === "acp_model") continue;
-		let r = e === "acp_command" ? R(t) : t[e];
+	for (let e of o) {
+		if (e === "acp_model" || e === "acp_env") continue;
+		let r = e === "acp_command" ? z(t) : t[e];
 		r != null && (n[e] = r);
 	}
-	let r = c(typeof t.acp_server == "string" ? t.acp_server : void 0), i = l({
+	let r = O(t.mcp_config);
+	Object.keys(r).length > 0 && "mcpServers" in r && (n.mcp_config = r);
+	let i = l(typeof t.acp_server == "string" ? t.acp_server : void 0), a = u({
 		configured: t.acp_model,
-		providerDefault: r?.default_model
+		providerDefault: i?.default_model
 	});
-	return i && (n.acp_model = i), n;
+	return a && (n.acp_model = a), n;
 }
-function B(e) {
-	let t = D(e.agent_settings), n = D(t.llm);
-	n.model = typeof n.model == "string" && n.model.trim().length > 0 ? n.model : s.llm_model;
-	let r = O(n.api_key);
+function V(e) {
+	let t = O(e.agent_settings), n = O(t.llm);
+	n.model = typeof n.model == "string" && n.model.trim().length > 0 ? n.model : c.llm_model;
+	let r = k(n.api_key);
 	r ? n.api_key = r : delete n.api_key;
-	let i = O(n.base_url);
+	let i = k(n.base_url);
 	i ? n.base_url = i : delete n.base_url;
-	let a = D(t.mcp_config);
+	let a = O(t.mcp_config);
 	(Object.keys(a).length === 0 || !("mcpServers" in a)) && delete t.mcp_config, delete t.acp_server;
-	for (let e of w) delete t[e];
+	for (let e of o) delete t[e];
 	return delete t.acp_env, {
 		...t,
 		llm: n,
-		agent_context: F(t),
-		tools: N(t)
+		agent_context: I(t),
+		tools: P(t)
 	};
 }
-function V(e) {
-	return I(e) ? z(e) : B(e);
-}
 function H(e) {
-	let { settings: n, query: r, conversationInstructions: i, plugins: a, workingDir: o } = e, s = D(n.conversation_settings), c = P(r, i);
-	return E.forEach((e) => delete s[e]), {
+	return L(e) ? B(e) : V(e);
+}
+function U(e) {
+	let { settings: n, query: r, conversationInstructions: i, plugins: a, workingDir: o } = e, s = O(n.conversation_settings), c = F(r, i);
+	return D.forEach((e) => delete s[e]), {
 		...s,
 		workspace: {
 			kind: "LocalWorkspace",
@@ -241,11 +249,11 @@ function H(e) {
 		})) } : {}
 	};
 }
-function U(e) {
+function W(e) {
 	let t = e.encryptedAgentSettings ? {
 		...e.settings,
 		agent_settings: e.encryptedAgentSettings
-	} : e.settings, n = I(t), i = V(t), o = n ? L(t) : void 0, s = H(e.encryptedConversationSettings ? {
+	} : e.settings, n = L(t), i = H(t), o = n ? R(t) : void 0, s = U(e.encryptedConversationSettings ? {
 		...e,
 		settings: {
 			...e.settings,
@@ -254,16 +262,16 @@ function U(e) {
 	} : e), c = {
 		agent_settings: i,
 		workspace: s.workspace,
-		confirmation_policy: k(s),
+		confirmation_policy: A(s),
 		max_iterations: typeof s.max_iterations == "number" ? s.max_iterations : 500,
 		stuck_detection: !0,
 		autotitle: !0,
 		worktree: !0
 	};
-	o && (c.tags = { [T]: o }), e.secretsEncrypted && (c.secrets_encrypted = !0), e.conversationId && (c.conversation_id = e.conversationId);
-	let l = A(s);
+	o && (c.tags = { [E]: o }), e.secretsEncrypted && (c.secrets_encrypted = !0), e.conversationId && (c.conversation_id = e.conversationId);
+	let l = j(s);
 	if (l && (c.security_analyzer = l), s.initial_message && (c.initial_message = s.initial_message), s.plugins && (c.plugins = s.plugins), s.hook_config && (c.hook_config = s.hook_config), c.tool_module_qualnames = {
-		[f]: p,
+		[p]: m,
 		...s.tool_module_qualnames ?? {}
 	}, s.agent_definitions && (c.agent_definitions = s.agent_definitions), e.customSecrets && e.customSecrets.length > 0) {
 		let t = r(), i = t ? a(t) : {}, o = {};
@@ -282,9 +290,9 @@ function U(e) {
 	}
 	return c;
 }
-async function W(e) {
-	let { SecretsService: t } = await import("./secrets-service.js"), [n, r] = await Promise.all([d.getSettingsForConversation(), t.getSecrets()]), { agentSettings: i, conversationSettings: a, secretsEncrypted: o } = n;
-	return U({
+async function G(e) {
+	let { SecretsService: t } = await import("./secrets-service.js"), [n, r] = await Promise.all([f.getSettingsForConversation(), t.getSecrets()]), { agentSettings: i, conversationSettings: a, secretsEncrypted: o } = n;
+	return W({
 		...e,
 		encryptedAgentSettings: i,
 		encryptedConversationSettings: a,
@@ -292,10 +300,10 @@ async function W(e) {
 		customSecrets: r
 	});
 }
-function G() {
+function K() {
 	return { hooks: [] };
 }
 //#endregion
-export { W as buildStartConversationRequestWithEncryptedSettings, G as emptyHooksResponse, x as getDefaultConversationTitle, S as toAppConversation, C as toConversationPage };
+export { G as buildStartConversationRequestWithEncryptedSettings, K as emptyHooksResponse, C as getDefaultConversationTitle, w as toAppConversation, T as toConversationPage };
 
 //# sourceMappingURL=agent-server-adapter.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent-server-adapter.js","names":[],"sources":["../../src/api/agent-server-adapter.ts"],"sourcesContent":["import { DEFAULT_SETTINGS } from \"#/services/settings\";\nimport { ExecutionStatus } from \"#/types/agent-server/core\";\nimport { Settings, SettingsValue } from \"#/types/settings\";\nimport {\n  getAcpProvider,\n  resolveEffectiveAcpModel,\n} from \"#/constants/acp-providers\";\nimport { getAgentServerClientOptions } from \"./agent-server-client-options\";\nimport { isAgentServerToolAvailable } from \"./agent-server-compatibility\";\nimport {\n  getAgentServerWorkingDir,\n  shouldLoadPublicSkills,\n} from \"./agent-server-config\";\nimport { getEffectiveLocalBackend } from \"./backend-registry/active-store\";\nimport { buildAuthHeaders } from \"./backend-registry/auth\";\nimport {\n  GetHooksResponse,\n  PluginSpec,\n  AppConversation,\n  AppConversationPage,\n  SandboxStatus,\n} from \"./conversation-service/agent-server-conversation-service.types\";\nimport SettingsService from \"./settings-service/settings-service.api\";\nimport { getStoredConversationMetadata } from \"./conversation-metadata-store\";\n\nexport interface DirectConversationInfo {\n  id: string;\n  title?: string | null;\n  created_at: string;\n  updated_at: string;\n  execution_status?: string | null;\n  /** Cloud-only sandbox lifecycle state. Omitted / null for local agent-server conversations. */\n  sandbox_status?: string | null;\n  metrics?: {\n    accumulated_cost?: number | null;\n    max_budget_per_task?: number | null;\n    accumulated_token_usage?: {\n      prompt_tokens?: number;\n      completion_tokens?: number;\n      cache_read_tokens?: number;\n      cache_write_tokens?: number;\n      context_window?: number;\n      per_turn_token?: number;\n    } | null;\n  } | null;\n  agent?: {\n    /**\n     * Pydantic discriminator from the SDK union: ``\"ACPAgent\"`` for ACP CLI\n     * subprocesses (model lives on the subprocess via ``acp_model``),\n     * ``\"Agent\"`` for direct litellm. Read by {@link toAppConversation}.\n     */\n    kind?: string | null;\n    acp_model?: string | null;\n    llm?: {\n      model?: string | null;\n    } | null;\n  } | null;\n  current_model_id?: string | null;\n  current_model_name?: string | null;\n  workspace?: {\n    working_dir?: string | null;\n  } | null;\n  /**\n   * Arbitrary string-keyed conversation tags surfaced by the agent-server\n   * (see ``ConversationInfo.tags``). Canvas only consumes one key today —\n   * ``ACP_SERVER_TAG_KEY`` (\"acpserver\") — but the field is typed as a\n   * generic record so future readers don't need another wire-shape change.\n   * Keys are constrained to ``^[a-z0-9]+$`` by the agent-server validator;\n   * values are opaque strings.\n   */\n  tags?: Record<string, string> | null;\n}\n\n// Module qualname for the Canvas-UI tool. The agent-server imports this via\n// tool_module_qualnames; the host directory is exposed via OH_EXTRA_PYTHON_PATH\n// (see scripts/dev-safe.mjs).\nconst CANVAS_UI_TOOL_NAME = \"canvas_ui\";\nconst CANVAS_UI_TOOL_MODULE = \"canvas_ui_tool\";\n\nconst DEFAULT_TOOL_NAMES = [\n  \"terminal\",\n  \"file_editor\",\n  \"task_tracker\",\n  CANVAS_UI_TOOL_NAME,\n];\nconst BROWSER_TOOL_SET_NAME = \"browser_tool_set\";\nconst TASK_TOOL_SET_NAME = \"task_tool_set\";\n\nfunction browserToolsEnabled() {\n  return import.meta.env.VITE_ENABLE_BROWSER_TOOLS !== \"false\";\n}\n\n/**\n * Shape of `VITE_RUNTIME_SERVICES_INFO` (set by the dev launchers in\n * scripts/dev-*.mjs). All URLs are written from the agent's point of view,\n * not the browser's. The block is rendered into the agent's system prompt\n * via `AgentContext.system_message_suffix` so the agent knows what's\n * reachable from inside its sandbox without having to probe.\n */\ninterface RuntimeServicesInfo {\n  mode?: string;\n  agent_host_alias?: string;\n  services?: {\n    agent_server?: { description?: string; url_from_agent?: string };\n    ingress?: { description?: string; url_from_agent?: string };\n    frontend?: {\n      kind?: \"vite\" | \"static\";\n      description?: string;\n      url_from_agent?: string;\n    };\n    // `vite` is the legacy key name for the frontend entry, accepted for\n    // one release while older dev-stack launchers may still emit it.\n    vite?: { description?: string; url_from_agent?: string };\n    automation?: {\n      description?: string;\n      url_from_agent?: string;\n      api_prefix?: string;\n      docs_url?: string;\n      openapi_url?: string;\n      auth_env_var?: string;\n    };\n  };\n}\n\nfunction parseRuntimeServicesInfo(): RuntimeServicesInfo | null {\n  const raw = import.meta.env.VITE_RUNTIME_SERVICES_INFO?.trim();\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as RuntimeServicesInfo;\n    if (!parsed || typeof parsed !== \"object\") return null;\n    return parsed;\n  } catch {\n    // Malformed JSON: ignore and fall back to no runtime info, rather than\n    // tearing down conversation creation over a misconfigured dev env var.\n    return null;\n  }\n}\n\n/**\n * Render the runtime services info into a markdown block suitable for\n * appending to the system prompt via `AgentContext.system_message_suffix`.\n *\n * Returns `undefined` when no runtime info is configured, so callers can\n * safely omit the field on production builds (where the launcher doesn't\n * set `VITE_RUNTIME_SERVICES_INFO`).\n */\nexport function buildRuntimeServicesSystemSuffix(): string | undefined {\n  const info = parseRuntimeServicesInfo();\n  if (!info?.services) return undefined;\n\n  const lines: string[] = [];\n  lines.push(\"<RUNTIME_SERVICES>\");\n  if (info.mode) {\n    lines.push(\n      `You are running inside an agent-canvas dev stack started in '${info.mode}' mode.`,\n    );\n  } else {\n    lines.push(\"You are running inside an agent-canvas dev stack.\");\n  }\n  lines.push(\n    \"The following services are reachable from your sandbox. URLs are written\",\n    \"from your point of view (i.e., as you should curl/fetch them).\",\n    \"\",\n  );\n\n  const { agent_server, ingress, automation } = info.services;\n  // Accept `frontend` (current key) or `vite` (legacy key) for the\n  // frontend service entry. The legacy fallback can be removed once all\n  // launchers in this repo emit `frontend`.\n  const frontend = info.services.frontend ?? info.services.vite;\n\n  if (agent_server?.url_from_agent) {\n    lines.push(\n      `* Agent Server (you): ${agent_server.url_from_agent}`,\n      `    ${agent_server.description ?? \"The agent-server hosting your tool calls.\"}`,\n    );\n  }\n  if (ingress?.url_from_agent) {\n    lines.push(\n      `* Ingress: ${ingress.url_from_agent}`,\n      `    ${ingress.description ?? \"Unified entry point for browser-facing traffic.\"}`,\n    );\n  }\n  if (frontend?.url_from_agent) {\n    lines.push(\n      `* Frontend: ${frontend.url_from_agent}`,\n      `    ${frontend.description ?? \"Frontend dev server.\"}`,\n    );\n  }\n  if (automation?.url_from_agent) {\n    lines.push(\n      `* Automation backend: ${automation.url_from_agent}`,\n      `    ${automation.description ?? \"OpenHands Automations service.\"}`,\n    );\n    if (automation.docs_url) {\n      lines.push(`    Docs:    ${automation.docs_url}`);\n    }\n    if (automation.openapi_url) {\n      lines.push(`    OpenAPI: ${automation.openapi_url}`);\n    }\n    if (automation.auth_env_var) {\n      // X-Session-API-Key is the local convention shared by the agent-server\n      // and automation backend (see openhands-automation auth.py).\n      lines.push(\n        `    Auth:    header 'X-Session-API-Key: $${automation.auth_env_var}'`,\n      );\n    }\n  } else {\n    lines.push(\n      \"* Automation backend: not running in this dev mode (skip /api/automation calls).\",\n    );\n  }\n\n  // Anchor the \"don't guess\" warning to the actual agent-server URL for\n  // this stack instead of a hardcoded port. The agent-server listens on\n  // different ports across dev modes, and baking the wrong port into the\n  // system prompt is exactly the kind of confusion this block is meant to\n  // prevent.\n  const agentServerUrl = agent_server?.url_from_agent;\n  lines.push(\n    \"\",\n    \"Trust this block over guessing: do not assume any other URLs are running.\",\n  );\n  if (agentServerUrl) {\n    lines.push(\n      `In particular, ${agentServerUrl} inside your sandbox is the Agent Server`,\n      \"you are running inside of — NOT the automation backend.\",\n    );\n  }\n  lines.push(\"</RUNTIME_SERVICES>\");\n\n  return lines.join(\"\\n\");\n}\n\nexport function toConversationUrl(conversationId: string): string {\n  // Local-format conversation URL — points at whichever local agent-server\n  // is actually serving the conversation (the bundled one when the active\n  // selection is cloud).\n  const { host } = getAgentServerClientOptions();\n  return `${host}/api/conversations/${conversationId}`;\n}\n\n// TODO(i18n): extract \"Conversation\" once we add CONVERSATION$DEFAULT_TITLE\n// with `{{shortId}}` interpolation. Kept as a literal for now to keep the\n// fallback inside this pure adapter rather than fanning out to display sites.\nexport function getDefaultConversationTitle(conversationId: string): string {\n  return `Conversation ${conversationId.slice(0, 5)}`;\n}\n\nexport function toAppConversation(\n  info: DirectConversationInfo,\n): AppConversation {\n  const metadata = getStoredConversationMetadata(info.id);\n  // ACPAgent conversations carry a sentinel ``llm`` on older SDKs. Prefer the\n  // runtime model fields when available, then the configured ``acp_model`` that\n  // Canvas saves for built-in providers. ``agent_kind`` still gates model\n  // switching, so surfacing this string is display-only.\n  const isAcp = info.agent?.kind === \"ACPAgent\";\n  // Only surface ``acp_server`` for ACP conversations even if the wire\n  // payload accidentally carries an ``acpserver`` tag on an OpenHands\n  // conversation — the chip is identity info for the ACP CLI subprocess,\n  // and showing it on a non-ACP conversation would be a lie.\n  const acpServer = isAcp ? (info.tags?.[ACP_SERVER_TAG_KEY] ?? null) : null;\n  return {\n    id: info.id,\n    created_by_user_id: null,\n    selected_repository: metadata?.selected_repository ?? null,\n    selected_branch: metadata?.selected_branch ?? null,\n    git_provider: metadata?.git_provider ?? null,\n    selected_workspace: metadata?.selected_workspace ?? null,\n    title: info.title?.trim()\n      ? info.title\n      : getDefaultConversationTitle(info.id),\n    trigger: null,\n    pr_number: [],\n    agent_kind: isAcp ? \"acp\" : \"openhands\",\n    acp_server: acpServer,\n    // Chip path: no ``providerDefault`` — the chip must distinguish\n    // \"no concrete model\" (fall back to the provider display name in\n    // ConversationCardFooter) from \"default\" (would lie about what's\n    // running on the subprocess).\n    llm_model: isAcp\n      ? resolveEffectiveAcpModel({\n          runtimeName: info.current_model_name,\n          runtimeId: info.current_model_id,\n          configured: info.agent?.acp_model,\n          sdkLlm: info.agent?.llm?.model,\n        })\n      : (info.agent?.llm?.model ?? DEFAULT_SETTINGS.llm_model),\n    metrics: info.metrics\n      ? {\n          accumulated_cost: info.metrics.accumulated_cost ?? null,\n          max_budget_per_task: info.metrics.max_budget_per_task ?? null,\n          accumulated_token_usage: info.metrics.accumulated_token_usage\n            ? {\n                prompt_tokens:\n                  info.metrics.accumulated_token_usage.prompt_tokens ?? 0,\n                completion_tokens:\n                  info.metrics.accumulated_token_usage.completion_tokens ?? 0,\n                cache_read_tokens:\n                  info.metrics.accumulated_token_usage.cache_read_tokens ?? 0,\n                cache_write_tokens:\n                  info.metrics.accumulated_token_usage.cache_write_tokens ?? 0,\n                context_window:\n                  info.metrics.accumulated_token_usage.context_window ?? 0,\n                per_turn_token:\n                  info.metrics.accumulated_token_usage.per_turn_token ?? 0,\n              }\n            : null,\n        }\n      : null,\n    created_at: info.created_at,\n    updated_at: info.updated_at,\n    execution_status:\n      (info.execution_status as AppConversation[\"execution_status\"]) ??\n      ExecutionStatus.IDLE,\n    sandbox_status: (info.sandbox_status as SandboxStatus | null) ?? null,\n    conversation_url: toConversationUrl(info.id),\n    session_api_key: getAgentServerClientOptions().apiKey ?? null,\n    sandbox_id: null,\n    workspace: {\n      working_dir: info.workspace?.working_dir ?? getAgentServerWorkingDir(),\n    },\n    public: false,\n    sub_conversation_ids: [],\n  };\n}\n\nexport function toConversationPage(data: {\n  items: DirectConversationInfo[];\n  next_page_id?: string | null;\n}): AppConversationPage {\n  return {\n    items: data.items.map(toAppConversation),\n    next_page_id: data.next_page_id ?? null,\n  };\n}\n\ntype SettingsRecord = Record<string, unknown>;\n\ninterface AgentToolSpec {\n  name: string;\n  params: SettingsRecord;\n}\n\ntype AgentSettingsPayload = SettingsRecord & {\n  llm?: SettingsRecord;\n  agent_context: SettingsRecord;\n  tools?: AgentToolSpec[];\n};\n\ninterface LocalWorkspacePayload {\n  kind: \"LocalWorkspace\";\n  working_dir: string;\n}\n\ninterface InitialMessagePayload {\n  role: \"user\";\n  content: Array<{ type: \"text\"; text: string }>;\n  run: true;\n}\n\ntype ConversationSettingsPayload = SettingsRecord & {\n  workspace: LocalWorkspacePayload;\n  initial_message?: InitialMessagePayload;\n};\n\nconst ACP_SETTINGS_KEYS = [\n  \"acp_command\",\n  \"acp_args\",\n  \"acp_model\",\n  \"acp_session_mode\",\n  \"acp_prompt_timeout\",\n] as const;\n\nexport const ACP_SERVER_TAG_KEY = \"acpserver\";\n\nconst CONVERSATION_SETTINGS_METADATA_KEYS = new Set([\n  \"schema_version\",\n  \"agent_settings\",\n  \"workspace\",\n  \"conversation_id\",\n  \"initial_message\",\n  \"plugins\",\n]);\n\nfunction toRecord(value: unknown): SettingsRecord {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return {};\n  }\n\n  return structuredClone(value as SettingsRecord);\n}\n\nfunction normalizeSecretString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nfunction getConversationConfirmationPolicy(\n  conversationSettings: SettingsRecord,\n) {\n  if (conversationSettings.confirmation_mode !== true) {\n    return { kind: \"NeverConfirm\" };\n  }\n\n  if (conversationSettings.security_analyzer === \"llm\") {\n    return { kind: \"ConfirmRisky\", threshold: \"HIGH\", confirm_unknown: true };\n  }\n\n  return { kind: \"AlwaysConfirm\" };\n}\n\nfunction getConversationSecurityAnalyzer(conversationSettings: SettingsRecord) {\n  switch (conversationSettings.security_analyzer) {\n    case \"llm\":\n      return { kind: \"LLMSecurityAnalyzer\" };\n    case \"pattern\":\n      return { kind: \"PatternSecurityAnalyzer\" };\n    case \"policy_rail\":\n      return { kind: \"PolicyRailSecurityAnalyzer\" };\n    default:\n      return undefined;\n  }\n}\n\nfunction isToolRecord(\n  value: unknown,\n): value is { name: string; params?: unknown } {\n  return (\n    !!value &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    typeof (value as { name?: unknown }).name === \"string\"\n  );\n}\n\nfunction shouldIncludeTool(name: string, agentSettings: SettingsRecord) {\n  if (name === BROWSER_TOOL_SET_NAME) {\n    return browserToolsEnabled() && isAgentServerToolAvailable(name);\n  }\n\n  if (name === TASK_TOOL_SET_NAME) {\n    return (\n      agentSettings.enable_sub_agents === true &&\n      isAgentServerToolAvailable(name)\n    );\n  }\n\n  return true;\n}\n\nfunction getAgentTools(agentSettings: SettingsRecord): AgentToolSpec[] {\n  const tools = new Map<string, AgentToolSpec>();\n\n  for (const name of DEFAULT_TOOL_NAMES) {\n    tools.set(name, { name, params: {} });\n  }\n\n  for (const name of [BROWSER_TOOL_SET_NAME, TASK_TOOL_SET_NAME]) {\n    if (shouldIncludeTool(name, agentSettings)) {\n      tools.set(name, { name, params: {} });\n    }\n  }\n\n  const configuredTools = agentSettings.tools;\n  if (\n    Array.isArray(configuredTools) &&\n    configuredTools.every((tool) => isToolRecord(tool))\n  ) {\n    for (const tool of configuredTools) {\n      if (shouldIncludeTool(tool.name, agentSettings)) {\n        tools.set(tool.name, {\n          name: tool.name,\n          params: toRecord(tool.params),\n        });\n      }\n    }\n  }\n\n  return Array.from(tools.values());\n}\n\nfunction buildInitialMessage(\n  query?: string,\n  conversationInstructions?: string,\n): InitialMessagePayload | null {\n  const parts = [query?.trim(), conversationInstructions?.trim()].filter(\n    Boolean,\n  );\n  if (parts.length === 0) {\n    return null;\n  }\n\n  return {\n    role: \"user\",\n    content: [{ type: \"text\", text: parts.join(\"\\n\\n\") }],\n    run: true,\n  };\n}\n\nfunction buildAgentContext(agentSettings: SettingsRecord): SettingsRecord {\n  const runtimeServicesSuffix = buildRuntimeServicesSystemSuffix();\n  return {\n    ...toRecord(agentSettings.agent_context),\n    load_public_skills: shouldLoadPublicSkills(),\n    load_user_skills: true,\n    load_project_skills: true,\n    ...(runtimeServicesSuffix\n      ? { system_message_suffix: runtimeServicesSuffix }\n      : {}),\n  };\n}\n\nfunction isAcpAgent(settings: Settings): boolean {\n  const agentSettings = toRecord(settings.agent_settings);\n  return agentSettings.agent_kind === \"acp\";\n}\n\nfunction getAcpServerTag(settings: Settings): string | undefined {\n  const agentSettings = toRecord(settings.agent_settings);\n  const value = agentSettings.acp_server;\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction resolveAcpCommand(agentSettings: SettingsRecord): unknown {\n  const cmd = agentSettings.acp_command;\n  const isEmpty = Array.isArray(cmd) && cmd.length === 0;\n  const noCommand = cmd === undefined;\n  if (!isEmpty && !noCommand) {\n    return cmd;\n  }\n\n  const serverKey =\n    typeof agentSettings.acp_server === \"string\"\n      ? agentSettings.acp_server\n      : undefined;\n  const provider = getAcpProvider(serverKey);\n  return provider ? [...provider.default_command] : cmd;\n}\n\nfunction buildConfiguredAcpAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  const agentSettings = toRecord(settings.agent_settings);\n  const payload: AgentSettingsPayload = {\n    agent_kind: \"acp\",\n    agent_context: buildAgentContext(agentSettings),\n  };\n\n  for (const key of ACP_SETTINGS_KEYS) {\n    // ``acp_model`` is resolved separately below so a saved ``null`` still\n    // falls back to the provider's default rather than being dropped.\n    if (key === \"acp_model\") continue;\n    const value =\n      key === \"acp_command\"\n        ? resolveAcpCommand(agentSettings)\n        : agentSettings[key];\n    if (value !== undefined && value !== null) {\n      payload[key] = value;\n    }\n  }\n\n  // Saved settings may carry ``acp_model: null`` (existing users predating\n  // the default-model registry, or saved fields the agent-server stripped).\n  // Fall back to the provider's ``default_model`` so the conversation starts\n  // with whatever the Settings → Agent UI shows — without that, the form's\n  // displayed default would silently not take effect at runtime until the\n  // user re-saved the page.\n  const serverKey =\n    typeof agentSettings.acp_server === \"string\"\n      ? agentSettings.acp_server\n      : undefined;\n  const provider = getAcpProvider(serverKey);\n  const effectiveModel = resolveEffectiveAcpModel({\n    configured: agentSettings.acp_model as string | null | undefined,\n    providerDefault: provider?.default_model,\n  });\n  if (effectiveModel) {\n    payload.acp_model = effectiveModel;\n  }\n\n  return payload;\n}\n\nfunction buildConfiguredOpenHandsAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  const agentSettings = toRecord(settings.agent_settings);\n  const llm = toRecord(agentSettings.llm);\n\n  llm.model =\n    typeof llm.model === \"string\" && llm.model.trim().length > 0\n      ? llm.model\n      : DEFAULT_SETTINGS.llm_model;\n\n  const apiKey = normalizeSecretString(llm.api_key);\n  if (apiKey) {\n    llm.api_key = apiKey;\n  } else {\n    delete llm.api_key;\n  }\n\n  const baseUrl = normalizeSecretString(llm.base_url);\n  if (baseUrl) {\n    llm.base_url = baseUrl;\n  } else {\n    delete llm.base_url;\n  }\n\n  const mcpConfig = toRecord(agentSettings.mcp_config);\n  if (Object.keys(mcpConfig).length === 0 || !(\"mcpServers\" in mcpConfig)) {\n    delete agentSettings.mcp_config;\n  }\n\n  delete agentSettings.acp_server;\n  for (const key of ACP_SETTINGS_KEYS) {\n    delete agentSettings[key];\n  }\n  // ``acp_env`` is no longer a forwarded ACP setting (provider creds ride the\n  // Secrets panel), but a legacy value may linger on persisted settings —\n  // scrub it so it never leaks onto the OpenHands payload.\n  delete agentSettings.acp_env;\n\n  return {\n    ...agentSettings,\n    llm,\n    agent_context: buildAgentContext(agentSettings),\n    tools: getAgentTools(agentSettings),\n  };\n}\n\nfunction buildConfiguredAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  return isAcpAgent(settings)\n    ? buildConfiguredAcpAgentSettings(settings)\n    : buildConfiguredOpenHandsAgentSettings(settings);\n}\n\nfunction buildConfiguredConversationSettings(options: {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  workingDir?: string;\n}): ConversationSettingsPayload {\n  const { settings, query, conversationInstructions, plugins, workingDir } =\n    options;\n  const conversationSettings = toRecord(settings.conversation_settings);\n  const initialMessage = buildInitialMessage(query, conversationInstructions);\n\n  CONVERSATION_SETTINGS_METADATA_KEYS.forEach(\n    (key) => delete conversationSettings[key],\n  );\n\n  const payload: ConversationSettingsPayload = {\n    ...conversationSettings,\n    workspace: {\n      kind: \"LocalWorkspace\",\n      working_dir: workingDir ?? getAgentServerWorkingDir(),\n    },\n    ...(initialMessage ? { initial_message: initialMessage } : {}),\n    ...(plugins?.length\n      ? {\n          plugins: plugins.map((plugin) => ({\n            source: plugin.source,\n            ...(plugin.ref ? { ref: plugin.ref } : {}),\n            ...(plugin.repo_path ? { repo_path: plugin.repo_path } : {}),\n          })),\n        }\n      : {}),\n  };\n\n  return payload;\n}\n\ninterface LookupSecret {\n  kind: \"LookupSecret\";\n  url: string;\n  headers?: Record<string, string>;\n  description?: string;\n}\n\ntype StartConversationPayload = Record<string, unknown> & {\n  agent_settings: AgentSettingsPayload;\n  workspace: LocalWorkspacePayload;\n  confirmation_policy: SettingsRecord;\n  security_analyzer?: SettingsRecord;\n  initial_message?: InitialMessagePayload;\n  max_iterations: number;\n  stuck_detection: true;\n  autotitle: true;\n  worktree: true;\n  secrets_encrypted?: true;\n  conversation_id?: string;\n  secrets?: Record<string, LookupSecret>;\n  tags?: Record<string, string>;\n  tool_module_qualnames?: Record<string, string>;\n};\n\nexport interface StartConversationOptions {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  conversationId?: string;\n  workingDir?: string;\n  encryptedAgentSettings?: Record<string, SettingsValue>;\n  encryptedConversationSettings?: Record<string, SettingsValue>;\n  secretsEncrypted?: boolean;\n  customSecrets?: Array<{ name: string; description?: string }>;\n}\n\nexport function buildStartConversationRequest(\n  options: StartConversationOptions,\n): StartConversationPayload {\n  const sourceAgentSettings = options.encryptedAgentSettings\n    ? { ...options.settings, agent_settings: options.encryptedAgentSettings }\n    : options.settings;\n\n  const acpMode = isAcpAgent(sourceAgentSettings);\n  const agentSettings = buildConfiguredAgentSettings(sourceAgentSettings);\n  const acpServerTag = acpMode\n    ? getAcpServerTag(sourceAgentSettings)\n    : undefined;\n\n  const sourceConversationOptions = options.encryptedConversationSettings\n    ? {\n        ...options,\n        settings: {\n          ...options.settings,\n          conversation_settings: options.encryptedConversationSettings,\n        },\n      }\n    : options;\n\n  const conversationSettings = buildConfiguredConversationSettings(\n    sourceConversationOptions,\n  );\n\n  const payload: StartConversationPayload = {\n    agent_settings: agentSettings,\n    workspace: conversationSettings.workspace,\n    confirmation_policy:\n      getConversationConfirmationPolicy(conversationSettings),\n    max_iterations:\n      typeof conversationSettings.max_iterations === \"number\"\n        ? conversationSettings.max_iterations\n        : 500,\n    stuck_detection: true,\n    autotitle: true,\n    worktree: true,\n  };\n\n  if (acpServerTag) {\n    payload.tags = { [ACP_SERVER_TAG_KEY]: acpServerTag };\n  }\n\n  if (options.secretsEncrypted) {\n    payload.secrets_encrypted = true;\n  }\n\n  if (options.conversationId) {\n    payload.conversation_id = options.conversationId;\n  }\n\n  const securityAnalyzer =\n    getConversationSecurityAnalyzer(conversationSettings);\n  if (securityAnalyzer) {\n    payload.security_analyzer = securityAnalyzer;\n  }\n\n  if (conversationSettings.initial_message) {\n    payload.initial_message = conversationSettings.initial_message;\n  }\n\n  if (conversationSettings.plugins) {\n    payload.plugins = conversationSettings.plugins;\n  }\n\n  if (conversationSettings.hook_config) {\n    payload.hook_config = conversationSettings.hook_config;\n  }\n\n  payload.tool_module_qualnames = {\n    [CANVAS_UI_TOOL_NAME]: CANVAS_UI_TOOL_MODULE,\n    ...((conversationSettings.tool_module_qualnames as\n      | Record<string, string>\n      | undefined) ?? {}),\n  };\n\n  if (conversationSettings.agent_definitions) {\n    payload.agent_definitions = conversationSettings.agent_definitions;\n  }\n\n  if (options.customSecrets && options.customSecrets.length > 0) {\n    const backend = getEffectiveLocalBackend();\n    const headers = backend ? buildAuthHeaders(backend) : {};\n\n    const secrets: Record<string, LookupSecret> = {};\n    for (const secret of options.customSecrets) {\n      const lookupSecret: LookupSecret = {\n        kind: \"LookupSecret\",\n        url: `/api/settings/secrets/${encodeURIComponent(secret.name)}`,\n        description: secret.description,\n      };\n\n      if (Object.keys(headers).length > 0) {\n        lookupSecret.headers = headers;\n      }\n\n      secrets[secret.name] = lookupSecret;\n    }\n\n    payload.secrets = secrets;\n\n    if (acpMode) {\n      payload.agent_settings.agent_context = {\n        ...payload.agent_settings.agent_context,\n        secrets,\n      };\n    }\n  }\n\n  return payload;\n}\n\nexport async function buildStartConversationRequestWithEncryptedSettings(options: {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  conversationId?: string;\n  workingDir?: string;\n}): Promise<Record<string, unknown>> {\n  const { SecretsService } = await import(\"./secrets-service\");\n\n  const [settingsResult, customSecrets] = await Promise.all([\n    SettingsService.getSettingsForConversation(),\n    SecretsService.getSecrets(),\n  ]);\n\n  const { agentSettings, conversationSettings, secretsEncrypted } =\n    settingsResult;\n\n  return buildStartConversationRequest({\n    ...options,\n    encryptedAgentSettings: agentSettings,\n    encryptedConversationSettings: conversationSettings,\n    secretsEncrypted,\n    customSecrets,\n  });\n}\n\nexport function emptyHooksResponse(): GetHooksResponse {\n  return { hooks: [] };\n}\n"],"mappings":";;;;;;;;;;;AA4EA,IAAM,IAAsB,aACtB,IAAwB,kBAExB,IAAqB;CACzB;CACA;CACA;CACA;CACD,EACK,IAAwB,oBACxB,IAAqB;AAE3B,SAAS,IAAsB;AAC7B,QAAO;;AAmCT,SAAS,IAAuD;CAC9D,IAAM,KAAA,KAAA,IAAkD,MAAM;AAC9D,KAAI,CAAC,EAAK,QAAO;AACjB,KAAI;EACF,IAAM,IAAS,KAAK,MAAM,EAAI;AAE9B,SADI,CAAC,KAAU,OAAO,KAAW,WAAiB,OAC3C;SACD;AAGN,SAAO;;;AAYX,SAAgB,IAAuD;CACrE,IAAM,IAAO,GAA0B;AACvC,KAAI,CAAC,GAAM,SAAU;CAErB,IAAM,IAAkB,EAAE;AAS1B,CARA,EAAM,KAAK,qBAAqB,EAC5B,EAAK,OACP,EAAM,KACJ,gEAAgE,EAAK,KAAK,SAC3E,GAED,EAAM,KAAK,oDAAoD,EAEjE,EAAM,KACJ,4EACA,kEACA,GACD;CAED,IAAM,EAAE,iBAAc,YAAS,kBAAe,EAAK,UAI7C,IAAW,EAAK,SAAS,YAAY,EAAK,SAAS;AAoBzD,CAlBI,GAAc,kBAChB,EAAM,KACJ,yBAAyB,EAAa,kBACtC,OAAO,EAAa,eAAe,8CACpC,EAEC,GAAS,kBACX,EAAM,KACJ,cAAc,EAAQ,kBACtB,OAAO,EAAQ,eAAe,oDAC/B,EAEC,GAAU,kBACZ,EAAM,KACJ,eAAe,EAAS,kBACxB,OAAO,EAAS,eAAe,yBAChC,EAEC,GAAY,kBACd,EAAM,KACJ,yBAAyB,EAAW,kBACpC,OAAO,EAAW,eAAe,mCAClC,EACG,EAAW,YACb,EAAM,KAAK,gBAAgB,EAAW,WAAW,EAE/C,EAAW,eACb,EAAM,KAAK,gBAAgB,EAAW,cAAc,EAElD,EAAW,gBAGb,EAAM,KACJ,4CAA4C,EAAW,aAAa,GACrE,IAGH,EAAM,KACJ,mFACD;CAQH,IAAM,IAAiB,GAAc;AAarC,QAZA,EAAM,KACJ,IACA,4EACD,EACG,KACF,EAAM,KACJ,kBAAkB,EAAe,2CACjC,0DACD,EAEH,EAAM,KAAK,sBAAsB,EAE1B,EAAM,KAAK,KAAK;;AAGzB,SAAgB,EAAkB,GAAgC;CAIhE,IAAM,EAAE,YAAS,GAA6B;AAC9C,QAAO,GAAG,EAAK,qBAAqB;;AAMtC,SAAgB,EAA4B,GAAgC;AAC1E,QAAO,gBAAgB,EAAe,MAAM,GAAG,EAAE;;AAGnD,SAAgB,EACd,GACiB;CACjB,IAAM,IAAW,EAA8B,EAAK,GAAG,EAKjD,IAAQ,EAAK,OAAO,SAAS,YAK7B,IAAY,IAAS,EAAK,MAAA,aAA8B,OAAQ;AACtE,QAAO;EACL,IAAI,EAAK;EACT,oBAAoB;EACpB,qBAAqB,GAAU,uBAAuB;EACtD,iBAAiB,GAAU,mBAAmB;EAC9C,cAAc,GAAU,gBAAgB;EACxC,oBAAoB,GAAU,sBAAsB;EACpD,OAAO,EAAK,OAAO,MAAM,GACrB,EAAK,QACL,EAA4B,EAAK,GAAG;EACxC,SAAS;EACT,WAAW,EAAE;EACb,YAAY,IAAQ,QAAQ;EAC5B,YAAY;EAKZ,WAAW,IACP,EAAyB;GACvB,aAAa,EAAK;GAClB,WAAW,EAAK;GAChB,YAAY,EAAK,OAAO;GACxB,QAAQ,EAAK,OAAO,KAAK;GAC1B,CAAC,GACD,EAAK,OAAO,KAAK,SAAS,EAAiB;EAChD,SAAS,EAAK,UACV;GACE,kBAAkB,EAAK,QAAQ,oBAAoB;GACnD,qBAAqB,EAAK,QAAQ,uBAAuB;GACzD,yBAAyB,EAAK,QAAQ,0BAClC;IACE,eACE,EAAK,QAAQ,wBAAwB,iBAAiB;IACxD,mBACE,EAAK,QAAQ,wBAAwB,qBAAqB;IAC5D,mBACE,EAAK,QAAQ,wBAAwB,qBAAqB;IAC5D,oBACE,EAAK,QAAQ,wBAAwB,sBAAsB;IAC7D,gBACE,EAAK,QAAQ,wBAAwB,kBAAkB;IACzD,gBACE,EAAK,QAAQ,wBAAwB,kBAAkB;IAC1D,GACD;GACL,GACD;EACJ,YAAY,EAAK;EACjB,YAAY,EAAK;EACjB,kBACG,EAAK,oBACN,EAAgB;EAClB,gBAAiB,EAAK,kBAA2C;EACjE,kBAAkB,EAAkB,EAAK,GAAG;EAC5C,iBAAiB,GAA6B,CAAC,UAAU;EACzD,YAAY;EACZ,WAAW,EACT,aAAa,EAAK,WAAW,eAAe,GAA0B,EACvE;EACD,QAAQ;EACR,sBAAsB,EAAE;EACzB;;AAGH,SAAgB,EAAmB,GAGX;AACtB,QAAO;EACL,OAAO,EAAK,MAAM,IAAI,EAAkB;EACxC,cAAc,EAAK,gBAAgB;EACpC;;AAgCH,IAAM,IAAoB;CACxB;CACA;CACA;CACA;CACA;CACD,EAEY,IAAqB,aAE5B,IAAsC,IAAI,IAAI;CAClD;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AAEF,SAAS,EAAS,GAAgC;AAKhD,QAJI,CAAC,KAAS,OAAO,KAAU,YAAY,MAAM,QAAQ,EAAM,GACtD,EAAE,GAGJ,gBAAgB,EAAwB;;AAGjD,SAAS,EAAsB,GAAoC;AACjE,KAAI,OAAO,KAAU,SACnB;CAGF,IAAM,IAAU,EAAM,MAAM;AAC5B,QAAO,EAAQ,SAAS,IAAI,IAAU,KAAA;;AAGxC,SAAS,EACP,GACA;AASA,QARI,EAAqB,sBAAsB,KAI3C,EAAqB,sBAAsB,QACtC;EAAE,MAAM;EAAgB,WAAW;EAAQ,iBAAiB;EAAM,GAGpE,EAAE,MAAM,iBAAiB,GAPvB,EAAE,MAAM,gBAAgB;;AAUnC,SAAS,EAAgC,GAAsC;AAC7E,SAAQ,EAAqB,mBAA7B;EACE,KAAK,MACH,QAAO,EAAE,MAAM,uBAAuB;EACxC,KAAK,UACH,QAAO,EAAE,MAAM,2BAA2B;EAC5C,KAAK,cACH,QAAO,EAAE,MAAM,8BAA8B;EAC/C,QACE;;;AAIN,SAAS,EACP,GAC6C;AAC7C,QACE,CAAC,CAAC,KACF,OAAO,KAAU,YACjB,CAAC,MAAM,QAAQ,EAAM,IACrB,OAAQ,EAA6B,QAAS;;AAIlD,SAAS,EAAkB,GAAc,GAA+B;AAYtE,QAXI,MAAS,IACJ,GAAqB,IAAI,EAA2B,EAAK,GAG9D,MAAS,IAET,EAAc,sBAAsB,MACpC,EAA2B,EAAK,GAI7B;;AAGT,SAAS,EAAc,GAAgD;CACrE,IAAM,oBAAQ,IAAI,KAA4B;AAE9C,MAAK,IAAM,KAAQ,EACjB,GAAM,IAAI,GAAM;EAAE;EAAM,QAAQ,EAAE;EAAE,CAAC;AAGvC,MAAK,IAAM,KAAQ,CAAC,GAAuB,EAAmB,CAC5D,CAAI,EAAkB,GAAM,EAAc,IACxC,EAAM,IAAI,GAAM;EAAE;EAAM,QAAQ,EAAE;EAAE,CAAC;CAIzC,IAAM,IAAkB,EAAc;AACtC,KACE,MAAM,QAAQ,EAAgB,IAC9B,EAAgB,OAAO,MAAS,EAAa,EAAK,CAAC,OAE9C,IAAM,KAAQ,EACjB,CAAI,EAAkB,EAAK,MAAM,EAAc,IAC7C,EAAM,IAAI,EAAK,MAAM;EACnB,MAAM,EAAK;EACX,QAAQ,EAAS,EAAK,OAAO;EAC9B,CAAC;AAKR,QAAO,MAAM,KAAK,EAAM,QAAQ,CAAC;;AAGnC,SAAS,EACP,GACA,GAC8B;CAC9B,IAAM,IAAQ,CAAC,GAAO,MAAM,EAAE,GAA0B,MAAM,CAAC,CAAC,OAC9D,QACD;AAKD,QAJI,EAAM,WAAW,IACZ,OAGF;EACL,MAAM;EACN,SAAS,CAAC;GAAE,MAAM;GAAQ,MAAM,EAAM,KAAK,OAAO;GAAE,CAAC;EACrD,KAAK;EACN;;AAGH,SAAS,EAAkB,GAA+C;CACxE,IAAM,IAAwB,GAAkC;AAChE,QAAO;EACL,GAAG,EAAS,EAAc,cAAc;EACxC,oBAAoB,GAAwB;EAC5C,kBAAkB;EAClB,qBAAqB;EACrB,GAAI,IACA,EAAE,uBAAuB,GAAuB,GAChD,EAAE;EACP;;AAGH,SAAS,EAAW,GAA6B;AAE/C,QADsB,EAAS,EAAS,eACjC,CAAc,eAAe;;AAGtC,SAAS,EAAgB,GAAwC;CAE/D,IAAM,IADgB,EAAS,EAAS,eAC1B,CAAc;AAC5B,QAAO,OAAO,KAAU,YAAY,EAAM,SAAS,IAAI,IAAQ,KAAA;;AAGjE,SAAS,EAAkB,GAAwC;CACjE,IAAM,IAAM,EAAc;AAG1B,KAAI,EAFY,MAAM,QAAQ,EAAI,IAAI,EAAI,WAAW,MACnC,MAAQ,KAAA,EAExB,QAAO;CAOT,IAAM,IAAW,EAHf,OAAO,EAAc,cAAe,WAChC,EAAc,aACd,KAAA,EACoC;AAC1C,QAAO,IAAW,CAAC,GAAG,EAAS,gBAAgB,GAAG;;AAGpD,SAAS,EACP,GACsB;CACtB,IAAM,IAAgB,EAAS,EAAS,eAAe,EACjD,IAAgC;EACpC,YAAY;EACZ,eAAe,EAAkB,EAAc;EAChD;AAED,MAAK,IAAM,KAAO,GAAmB;AAGnC,MAAI,MAAQ,YAAa;EACzB,IAAM,IACJ,MAAQ,gBACJ,EAAkB,EAAc,GAChC,EAAc;AACpB,EAAI,KAAiC,SACnC,EAAQ,KAAO;;CAcnB,IAAM,IAAW,EAHf,OAAO,EAAc,cAAe,WAChC,EAAc,aACd,KAAA,EACoC,EACpC,IAAiB,EAAyB;EAC9C,YAAY,EAAc;EAC1B,iBAAiB,GAAU;EAC5B,CAAC;AAKF,QAJI,MACF,EAAQ,YAAY,IAGf;;AAGT,SAAS,EACP,GACsB;CACtB,IAAM,IAAgB,EAAS,EAAS,eAAe,EACjD,IAAM,EAAS,EAAc,IAAI;AAEvC,GAAI,QACF,OAAO,EAAI,SAAU,YAAY,EAAI,MAAM,MAAM,CAAC,SAAS,IACvD,EAAI,QACJ,EAAiB;CAEvB,IAAM,IAAS,EAAsB,EAAI,QAAQ;AACjD,CAAI,IACF,EAAI,UAAU,IAEd,OAAO,EAAI;CAGb,IAAM,IAAU,EAAsB,EAAI,SAAS;AACnD,CAAI,IACF,EAAI,WAAW,IAEf,OAAO,EAAI;CAGb,IAAM,IAAY,EAAS,EAAc,WAAW;AAKpD,EAJI,OAAO,KAAK,EAAU,CAAC,WAAW,KAAK,EAAE,gBAAgB,OAC3D,OAAO,EAAc,YAGvB,OAAO,EAAc;AACrB,MAAK,IAAM,KAAO,EAChB,QAAO,EAAc;AAOvB,QAFA,OAAO,EAAc,SAEd;EACL,GAAG;EACH;EACA,eAAe,EAAkB,EAAc;EAC/C,OAAO,EAAc,EAAc;EACpC;;AAGH,SAAS,EACP,GACsB;AACtB,QAAO,EAAW,EAAS,GACvB,EAAgC,EAAS,GACzC,EAAsC,EAAS;;AAGrD,SAAS,EAAoC,GAMb;CAC9B,IAAM,EAAE,aAAU,UAAO,6BAA0B,YAAS,kBAC1D,GACI,IAAuB,EAAS,EAAS,sBAAsB,EAC/D,IAAiB,EAAoB,GAAO,EAAyB;AAwB3E,QAtBA,EAAoC,SACjC,MAAQ,OAAO,EAAqB,GACtC,EAoBM;EAjBL,GAAG;EACH,WAAW;GACT,MAAM;GACN,aAAa,KAAc,GAA0B;GACtD;EACD,GAAI,IAAiB,EAAE,iBAAiB,GAAgB,GAAG,EAAE;EAC7D,GAAI,GAAS,SACT,EACE,SAAS,EAAQ,KAAK,OAAY;GAChC,QAAQ,EAAO;GACf,GAAI,EAAO,MAAM,EAAE,KAAK,EAAO,KAAK,GAAG,EAAE;GACzC,GAAI,EAAO,YAAY,EAAE,WAAW,EAAO,WAAW,GAAG,EAAE;GAC5D,EAAE,EACJ,GACD,EAAE;EAGD;;AAwCT,SAAgB,EACd,GAC0B;CAC1B,IAAM,IAAsB,EAAQ,yBAChC;EAAE,GAAG,EAAQ;EAAU,gBAAgB,EAAQ;EAAwB,GACvE,EAAQ,UAEN,IAAU,EAAW,EAAoB,EACzC,IAAgB,EAA6B,EAAoB,EACjE,IAAe,IACjB,EAAgB,EAAoB,GACpC,KAAA,GAYE,IAAuB,EAVK,EAAQ,gCACtC;EACE,GAAG;EACH,UAAU;GACR,GAAG,EAAQ;GACX,uBAAuB,EAAQ;GAChC;EACF,GACD,EAIH,EAEK,IAAoC;EACxC,gBAAgB;EAChB,WAAW,EAAqB;EAChC,qBACE,EAAkC,EAAqB;EACzD,gBACE,OAAO,EAAqB,kBAAmB,WAC3C,EAAqB,iBACrB;EACN,iBAAiB;EACjB,WAAW;EACX,UAAU;EACX;AAUD,CARI,MACF,EAAQ,OAAO,GAAG,IAAqB,GAAc,GAGnD,EAAQ,qBACV,EAAQ,oBAAoB,KAG1B,EAAQ,mBACV,EAAQ,kBAAkB,EAAQ;CAGpC,IAAM,IACJ,EAAgC,EAAqB;AA4BvD,KA3BI,MACF,EAAQ,oBAAoB,IAG1B,EAAqB,oBACvB,EAAQ,kBAAkB,EAAqB,kBAG7C,EAAqB,YACvB,EAAQ,UAAU,EAAqB,UAGrC,EAAqB,gBACvB,EAAQ,cAAc,EAAqB,cAG7C,EAAQ,wBAAwB;GAC7B,IAAsB;EACvB,GAAK,EAAqB,yBAER,EAAE;EACrB,EAEG,EAAqB,sBACvB,EAAQ,oBAAoB,EAAqB,oBAG/C,EAAQ,iBAAiB,EAAQ,cAAc,SAAS,GAAG;EAC7D,IAAM,IAAU,GAA0B,EACpC,IAAU,IAAU,EAAiB,EAAQ,GAAG,EAAE,EAElD,IAAwC,EAAE;AAChD,OAAK,IAAM,KAAU,EAAQ,eAAe;GAC1C,IAAM,IAA6B;IACjC,MAAM;IACN,KAAK,yBAAyB,mBAAmB,EAAO,KAAK;IAC7D,aAAa,EAAO;IACrB;AAMD,GAJI,OAAO,KAAK,EAAQ,CAAC,SAAS,MAChC,EAAa,UAAU,IAGzB,EAAQ,EAAO,QAAQ;;AAKzB,EAFA,EAAQ,UAAU,GAEd,MACF,EAAQ,eAAe,gBAAgB;GACrC,GAAG,EAAQ,eAAe;GAC1B;GACD;;AAIL,QAAO;;AAGT,eAAsB,EAAmD,GAOpC;CACnC,IAAM,EAAE,sBAAmB,MAAM,OAAO,yBAElC,CAAC,GAAgB,KAAiB,MAAM,QAAQ,IAAI,CACxD,EAAgB,4BAA4B,EAC5C,EAAe,YAAY,CAC5B,CAAC,EAEI,EAAE,kBAAe,yBAAsB,wBAC3C;AAEF,QAAO,EAA8B;EACnC,GAAG;EACH,wBAAwB;EACxB,+BAA+B;EAC/B;EACA;EACD,CAAC;;AAGJ,SAAgB,IAAuC;AACrD,QAAO,EAAE,OAAO,EAAE,EAAE"}
+{"version":3,"file":"agent-server-adapter.js","names":[],"sources":["../../src/api/agent-server-adapter.ts"],"sourcesContent":["import { ACP_SETTINGS_KEYS } from \"@openhands/typescript-client\";\nimport { DEFAULT_SETTINGS } from \"#/services/settings\";\nimport { ExecutionStatus } from \"#/types/agent-server/core\";\nimport { Settings, SettingsValue } from \"#/types/settings\";\nimport {\n  getAcpProvider,\n  resolveEffectiveAcpModel,\n} from \"#/constants/acp-providers\";\nimport { getAgentServerClientOptions } from \"./agent-server-client-options\";\nimport { isAgentServerToolAvailable } from \"./agent-server-compatibility\";\nimport {\n  getAgentServerWorkingDir,\n  shouldLoadPublicSkills,\n} from \"./agent-server-config\";\nimport { getEffectiveLocalBackend } from \"./backend-registry/active-store\";\nimport { buildAuthHeaders } from \"./backend-registry/auth\";\nimport {\n  GetHooksResponse,\n  PluginSpec,\n  AppConversation,\n  AppConversationPage,\n  SandboxStatus,\n} from \"./conversation-service/agent-server-conversation-service.types\";\nimport SettingsService from \"./settings-service/settings-service.api\";\nimport { getStoredConversationMetadata } from \"./conversation-metadata-store\";\n\nexport interface DirectConversationInfo {\n  id: string;\n  title?: string | null;\n  created_at: string;\n  updated_at: string;\n  execution_status?: string | null;\n  /** Cloud-only sandbox lifecycle state. Omitted / null for local agent-server conversations. */\n  sandbox_status?: string | null;\n  metrics?: {\n    accumulated_cost?: number | null;\n    max_budget_per_task?: number | null;\n    accumulated_token_usage?: {\n      prompt_tokens?: number;\n      completion_tokens?: number;\n      cache_read_tokens?: number;\n      cache_write_tokens?: number;\n      context_window?: number;\n      per_turn_token?: number;\n    } | null;\n  } | null;\n  agent?: {\n    /**\n     * Pydantic discriminator from the SDK union: ``\"ACPAgent\"`` for ACP CLI\n     * subprocesses (model lives on the subprocess via ``acp_model``),\n     * ``\"Agent\"`` for direct litellm. Read by {@link toAppConversation}.\n     */\n    kind?: string | null;\n    acp_model?: string | null;\n    llm?: {\n      model?: string | null;\n    } | null;\n  } | null;\n  current_model_id?: string | null;\n  current_model_name?: string | null;\n  workspace?: {\n    working_dir?: string | null;\n  } | null;\n  /**\n   * Arbitrary string-keyed conversation tags surfaced by the agent-server\n   * (see ``ConversationInfo.tags``). Canvas only consumes one key today —\n   * ``ACP_SERVER_TAG_KEY`` (\"acpserver\") — but the field is typed as a\n   * generic record so future readers don't need another wire-shape change.\n   * Keys are constrained to ``^[a-z0-9]+$`` by the agent-server validator;\n   * values are opaque strings.\n   */\n  tags?: Record<string, string> | null;\n}\n\n// Module qualname for the Canvas-UI tool. The agent-server imports this via\n// tool_module_qualnames; the host directory is exposed via OH_EXTRA_PYTHON_PATH\n// (see scripts/dev-safe.mjs).\nconst CANVAS_UI_TOOL_NAME = \"canvas_ui\";\nconst CANVAS_UI_TOOL_MODULE = \"canvas_ui_tool\";\n\nconst DEFAULT_TOOL_NAMES = [\n  \"terminal\",\n  \"file_editor\",\n  \"task_tracker\",\n  CANVAS_UI_TOOL_NAME,\n];\nconst BROWSER_TOOL_SET_NAME = \"browser_tool_set\";\nconst TASK_TOOL_SET_NAME = \"task_tool_set\";\n\nfunction browserToolsEnabled() {\n  return import.meta.env.VITE_ENABLE_BROWSER_TOOLS !== \"false\";\n}\n\n/**\n * Shape of the runtime services info (set by the dev launchers in\n * scripts/dev-*.mjs as `VITE_RUNTIME_SERVICES_INFO`, or injected at serve time\n * by `scripts/static-server.mjs` for static builds — see\n * `getRawRuntimeServicesInfo`). All URLs are written from the agent's point of\n * view, not the browser's. The block is rendered into the agent's system prompt\n * via `AgentContext.system_message_suffix` so the agent knows what's\n * reachable from inside its sandbox without having to probe.\n */\ninterface RuntimeServicesInfo {\n  mode?: string;\n  agent_host_alias?: string;\n  services?: {\n    agent_server?: { description?: string; url_from_agent?: string };\n    ingress?: { description?: string; url_from_agent?: string };\n    frontend?: {\n      kind?: \"vite\" | \"static\";\n      description?: string;\n      url_from_agent?: string;\n    };\n    // `vite` is the legacy key name for the frontend entry, accepted for\n    // one release while older dev-stack launchers may still emit it.\n    vite?: { description?: string; url_from_agent?: string };\n    automation?: {\n      description?: string;\n      url_from_agent?: string;\n      api_prefix?: string;\n      docs_url?: string;\n      openapi_url?: string;\n      auth_env_var?: string;\n    };\n  };\n}\n\n/**\n * Return the raw runtime-services JSON string, consulting two sources in order\n * (mirrors `getBakedSessionApiKey` in agent-server-config.ts):\n *   1. `VITE_RUNTIME_SERVICES_INFO` — baked into the bundle at build time by\n *      the dev launchers (`npm run dev`, dev:static).\n *   2. `window.__AGENT_CANVAS_RUNTIME_SERVICES_INFO__` — injected into\n *      index.html at serve time by `scripts/static-server.mjs\n *      --runtime-services-info <json>`. This is the path used by static builds\n *      (the Docker image and the published binary), where the env var is empty\n *      in the prebuilt bundle. Without it the `<RUNTIME_SERVICES>` block is\n *      missing and the agent cannot reach the local automation backend.\n */\nfunction getRawRuntimeServicesInfo(): string | null {\n  const envRaw = import.meta.env.VITE_RUNTIME_SERVICES_INFO?.trim();\n  if (envRaw) return envRaw;\n\n  if (typeof window !== \"undefined\") {\n    const injected = (window as unknown as Record<string, unknown>)\n      .__AGENT_CANVAS_RUNTIME_SERVICES_INFO__;\n    if (typeof injected === \"string\") {\n      return injected.trim() || null;\n    }\n  }\n\n  return null;\n}\n\nfunction parseRuntimeServicesInfo(): RuntimeServicesInfo | null {\n  const raw = getRawRuntimeServicesInfo();\n  if (!raw) return null;\n  try {\n    const parsed = JSON.parse(raw) as RuntimeServicesInfo;\n    if (!parsed || typeof parsed !== \"object\") return null;\n    return parsed;\n  } catch {\n    // Malformed JSON: ignore and fall back to no runtime info, rather than\n    // tearing down conversation creation over a misconfigured env var or\n    // injected value.\n    return null;\n  }\n}\n\n/**\n * Render the runtime services info into a markdown block suitable for\n * appending to the system prompt via `AgentContext.system_message_suffix`.\n *\n * Returns `undefined` when no runtime info is configured, so callers can\n * safely omit the field on production builds (where the launcher doesn't\n * set `VITE_RUNTIME_SERVICES_INFO`).\n */\nexport function buildRuntimeServicesSystemSuffix(): string | undefined {\n  const info = parseRuntimeServicesInfo();\n  if (!info?.services) return undefined;\n\n  const lines: string[] = [];\n  lines.push(\"<RUNTIME_SERVICES>\");\n  if (info.mode) {\n    lines.push(\n      `You are running inside an agent-canvas dev stack started in '${info.mode}' mode.`,\n    );\n  } else {\n    lines.push(\"You are running inside an agent-canvas dev stack.\");\n  }\n  lines.push(\n    \"The following services are reachable from your sandbox. URLs are written\",\n    \"from your point of view (i.e., as you should curl/fetch them).\",\n    \"\",\n  );\n\n  const { agent_server, ingress, automation } = info.services;\n  // Accept `frontend` (current key) or `vite` (legacy key) for the\n  // frontend service entry. The legacy fallback can be removed once all\n  // launchers in this repo emit `frontend`.\n  const frontend = info.services.frontend ?? info.services.vite;\n\n  if (agent_server?.url_from_agent) {\n    lines.push(\n      `* Agent Server (you): ${agent_server.url_from_agent}`,\n      `    ${agent_server.description ?? \"The agent-server hosting your tool calls.\"}`,\n    );\n  }\n  if (ingress?.url_from_agent) {\n    lines.push(\n      `* Ingress: ${ingress.url_from_agent}`,\n      `    ${ingress.description ?? \"Unified entry point for browser-facing traffic.\"}`,\n    );\n  }\n  if (frontend?.url_from_agent) {\n    lines.push(\n      `* Frontend: ${frontend.url_from_agent}`,\n      `    ${frontend.description ?? \"Frontend dev server.\"}`,\n    );\n  }\n  if (automation?.url_from_agent) {\n    lines.push(\n      `* Automation backend: ${automation.url_from_agent}`,\n      `    ${automation.description ?? \"OpenHands Automations service.\"}`,\n    );\n    if (automation.docs_url) {\n      lines.push(`    Docs:    ${automation.docs_url}`);\n    }\n    if (automation.openapi_url) {\n      lines.push(`    OpenAPI: ${automation.openapi_url}`);\n    }\n    if (automation.auth_env_var) {\n      // X-Session-API-Key is the local convention shared by the agent-server\n      // and automation backend (see openhands-automation auth.py).\n      lines.push(\n        `    Auth:    header 'X-Session-API-Key: $${automation.auth_env_var}'`,\n      );\n    }\n  } else {\n    lines.push(\n      \"* Automation backend: not running in this dev mode (skip /api/automation calls).\",\n    );\n  }\n\n  // Anchor the \"don't guess\" warning to the actual agent-server URL for\n  // this stack instead of a hardcoded port. The agent-server listens on\n  // different ports across dev modes, and baking the wrong port into the\n  // system prompt is exactly the kind of confusion this block is meant to\n  // prevent.\n  const agentServerUrl = agent_server?.url_from_agent;\n  lines.push(\n    \"\",\n    \"Trust this block over guessing: do not assume any other URLs are running.\",\n  );\n  if (agentServerUrl) {\n    lines.push(\n      `In particular, ${agentServerUrl} inside your sandbox is the Agent Server`,\n      \"you are running inside of — NOT the automation backend.\",\n    );\n  }\n  lines.push(\"</RUNTIME_SERVICES>\");\n\n  return lines.join(\"\\n\");\n}\n\nexport function toConversationUrl(conversationId: string): string {\n  // Local-format conversation URL — points at whichever local agent-server\n  // is actually serving the conversation (the bundled one when the active\n  // selection is cloud).\n  const { host } = getAgentServerClientOptions();\n  return `${host}/api/conversations/${conversationId}`;\n}\n\n// TODO(i18n): extract \"Conversation\" once we add CONVERSATION$DEFAULT_TITLE\n// with `{{shortId}}` interpolation. Kept as a literal for now to keep the\n// fallback inside this pure adapter rather than fanning out to display sites.\nexport function getDefaultConversationTitle(conversationId: string): string {\n  return `Conversation ${conversationId.slice(0, 5)}`;\n}\n\nexport function toAppConversation(\n  info: DirectConversationInfo,\n): AppConversation {\n  const metadata = getStoredConversationMetadata(info.id);\n  // ACPAgent conversations carry a sentinel ``llm`` on older SDKs. Prefer the\n  // runtime model fields when available, then the configured ``acp_model`` that\n  // Canvas saves for built-in providers. ``agent_kind`` still gates model\n  // switching, so surfacing this string is display-only.\n  const isAcp = info.agent?.kind === \"ACPAgent\";\n  // Only surface ``acp_server`` for ACP conversations even if the wire\n  // payload accidentally carries an ``acpserver`` tag on an OpenHands\n  // conversation — the chip is identity info for the ACP CLI subprocess,\n  // and showing it on a non-ACP conversation would be a lie.\n  const acpServer = isAcp ? (info.tags?.[ACP_SERVER_TAG_KEY] ?? null) : null;\n  return {\n    id: info.id,\n    created_by_user_id: null,\n    selected_repository: metadata?.selected_repository ?? null,\n    selected_branch: metadata?.selected_branch ?? null,\n    git_provider: metadata?.git_provider ?? null,\n    selected_workspace: metadata?.selected_workspace ?? null,\n    active_profile: metadata?.active_profile ?? null,\n    title: info.title?.trim()\n      ? info.title\n      : getDefaultConversationTitle(info.id),\n    trigger: null,\n    pr_number: [],\n    agent_kind: isAcp ? \"acp\" : \"openhands\",\n    acp_server: acpServer,\n    // Chip path: no ``providerDefault`` — the chip must distinguish\n    // \"no concrete model\" (fall back to the provider display name in\n    // ConversationCardFooter) from \"default\" (would lie about what's\n    // running on the subprocess).\n    llm_model: isAcp\n      ? resolveEffectiveAcpModel({\n          runtimeName: info.current_model_name,\n          runtimeId: info.current_model_id,\n          configured: info.agent?.acp_model,\n          sdkLlm: info.agent?.llm?.model,\n        })\n      : (info.agent?.llm?.model ?? DEFAULT_SETTINGS.llm_model),\n    metrics: info.metrics\n      ? {\n          accumulated_cost: info.metrics.accumulated_cost ?? null,\n          max_budget_per_task: info.metrics.max_budget_per_task ?? null,\n          accumulated_token_usage: info.metrics.accumulated_token_usage\n            ? {\n                prompt_tokens:\n                  info.metrics.accumulated_token_usage.prompt_tokens ?? 0,\n                completion_tokens:\n                  info.metrics.accumulated_token_usage.completion_tokens ?? 0,\n                cache_read_tokens:\n                  info.metrics.accumulated_token_usage.cache_read_tokens ?? 0,\n                cache_write_tokens:\n                  info.metrics.accumulated_token_usage.cache_write_tokens ?? 0,\n                context_window:\n                  info.metrics.accumulated_token_usage.context_window ?? 0,\n                per_turn_token:\n                  info.metrics.accumulated_token_usage.per_turn_token ?? 0,\n              }\n            : null,\n        }\n      : null,\n    created_at: info.created_at,\n    updated_at: info.updated_at,\n    execution_status:\n      (info.execution_status as AppConversation[\"execution_status\"]) ??\n      ExecutionStatus.IDLE,\n    sandbox_status: (info.sandbox_status as SandboxStatus | null) ?? null,\n    conversation_url: toConversationUrl(info.id),\n    session_api_key: getAgentServerClientOptions().apiKey ?? null,\n    sandbox_id: null,\n    workspace: {\n      working_dir: info.workspace?.working_dir ?? getAgentServerWorkingDir(),\n    },\n    public: false,\n    sub_conversation_ids: [],\n  };\n}\n\nexport function toConversationPage(data: {\n  items: DirectConversationInfo[];\n  next_page_id?: string | null;\n}): AppConversationPage {\n  return {\n    items: data.items.map(toAppConversation),\n    next_page_id: data.next_page_id ?? null,\n  };\n}\n\ntype SettingsRecord = Record<string, unknown>;\n\ninterface AgentToolSpec {\n  name: string;\n  params: SettingsRecord;\n}\n\ntype AgentSettingsPayload = SettingsRecord & {\n  llm?: SettingsRecord;\n  agent_context: SettingsRecord;\n  tools?: AgentToolSpec[];\n};\n\ninterface LocalWorkspacePayload {\n  kind: \"LocalWorkspace\";\n  working_dir: string;\n}\n\ninterface InitialMessagePayload {\n  role: \"user\";\n  content: Array<{ type: \"text\"; text: string }>;\n  run: true;\n}\n\ntype ConversationSettingsPayload = SettingsRecord & {\n  workspace: LocalWorkspacePayload;\n  initial_message?: InitialMessagePayload;\n};\n\nexport const ACP_SERVER_TAG_KEY = \"acpserver\";\n\nconst CONVERSATION_SETTINGS_METADATA_KEYS = new Set([\n  \"schema_version\",\n  \"agent_settings\",\n  \"workspace\",\n  \"conversation_id\",\n  \"initial_message\",\n  \"plugins\",\n]);\n\nfunction toRecord(value: unknown): SettingsRecord {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return {};\n  }\n\n  return structuredClone(value as SettingsRecord);\n}\n\nfunction normalizeSecretString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\nfunction getConversationConfirmationPolicy(\n  conversationSettings: SettingsRecord,\n) {\n  if (conversationSettings.confirmation_mode !== true) {\n    return { kind: \"NeverConfirm\" };\n  }\n\n  if (conversationSettings.security_analyzer === \"llm\") {\n    return { kind: \"ConfirmRisky\", threshold: \"HIGH\", confirm_unknown: true };\n  }\n\n  return { kind: \"AlwaysConfirm\" };\n}\n\nfunction getConversationSecurityAnalyzer(conversationSettings: SettingsRecord) {\n  switch (conversationSettings.security_analyzer) {\n    case \"llm\":\n      return { kind: \"LLMSecurityAnalyzer\" };\n    case \"pattern\":\n      return { kind: \"PatternSecurityAnalyzer\" };\n    case \"policy_rail\":\n      return { kind: \"PolicyRailSecurityAnalyzer\" };\n    default:\n      return undefined;\n  }\n}\n\nfunction isToolRecord(\n  value: unknown,\n): value is { name: string; params?: unknown } {\n  return (\n    !!value &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    typeof (value as { name?: unknown }).name === \"string\"\n  );\n}\n\nfunction shouldIncludeTool(name: string, agentSettings: SettingsRecord) {\n  if (name === BROWSER_TOOL_SET_NAME) {\n    return browserToolsEnabled() && isAgentServerToolAvailable(name);\n  }\n\n  if (name === TASK_TOOL_SET_NAME) {\n    return (\n      agentSettings.enable_sub_agents === true &&\n      isAgentServerToolAvailable(name)\n    );\n  }\n\n  return true;\n}\n\nfunction getAgentTools(agentSettings: SettingsRecord): AgentToolSpec[] {\n  const tools = new Map<string, AgentToolSpec>();\n\n  for (const name of DEFAULT_TOOL_NAMES) {\n    tools.set(name, { name, params: {} });\n  }\n\n  for (const name of [BROWSER_TOOL_SET_NAME, TASK_TOOL_SET_NAME]) {\n    if (shouldIncludeTool(name, agentSettings)) {\n      tools.set(name, { name, params: {} });\n    }\n  }\n\n  const configuredTools = agentSettings.tools;\n  if (\n    Array.isArray(configuredTools) &&\n    configuredTools.every((tool) => isToolRecord(tool))\n  ) {\n    for (const tool of configuredTools) {\n      if (shouldIncludeTool(tool.name, agentSettings)) {\n        tools.set(tool.name, {\n          name: tool.name,\n          params: toRecord(tool.params),\n        });\n      }\n    }\n  }\n\n  return Array.from(tools.values());\n}\n\nfunction buildInitialMessage(\n  query?: string,\n  conversationInstructions?: string,\n): InitialMessagePayload | null {\n  const parts = [query?.trim(), conversationInstructions?.trim()].filter(\n    Boolean,\n  );\n  if (parts.length === 0) {\n    return null;\n  }\n\n  return {\n    role: \"user\",\n    content: [{ type: \"text\", text: parts.join(\"\\n\\n\") }],\n    run: true,\n  };\n}\n\nfunction buildAgentContext(agentSettings: SettingsRecord): SettingsRecord {\n  const runtimeServicesSuffix = buildRuntimeServicesSystemSuffix();\n  return {\n    ...toRecord(agentSettings.agent_context),\n    load_public_skills: shouldLoadPublicSkills(),\n    load_user_skills: true,\n    load_project_skills: true,\n    ...(runtimeServicesSuffix\n      ? { system_message_suffix: runtimeServicesSuffix }\n      : {}),\n  };\n}\n\nfunction isAcpAgent(settings: Settings): boolean {\n  const agentSettings = toRecord(settings.agent_settings);\n  return agentSettings.agent_kind === \"acp\";\n}\n\nfunction getAcpServerTag(settings: Settings): string | undefined {\n  const agentSettings = toRecord(settings.agent_settings);\n  const value = agentSettings.acp_server;\n  return typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction resolveAcpCommand(agentSettings: SettingsRecord): unknown {\n  const cmd = agentSettings.acp_command;\n  const isEmpty = Array.isArray(cmd) && cmd.length === 0;\n  const noCommand = cmd === undefined;\n  if (!isEmpty && !noCommand) {\n    return cmd;\n  }\n\n  const serverKey =\n    typeof agentSettings.acp_server === \"string\"\n      ? agentSettings.acp_server\n      : undefined;\n  const provider = getAcpProvider(serverKey);\n  return provider ? [...provider.default_command] : cmd;\n}\n\nfunction buildConfiguredAcpAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  const agentSettings = toRecord(settings.agent_settings);\n  const payload: AgentSettingsPayload = {\n    agent_kind: \"acp\",\n    agent_context: buildAgentContext(agentSettings),\n  };\n\n  for (const key of ACP_SETTINGS_KEYS) {\n    // ``acp_model`` is resolved separately below so a saved ``null`` still\n    // falls back to the provider's default rather than being dropped.\n    if (key === \"acp_model\") continue;\n    // ``acp_env`` is deprecated — provider creds now route via agent_context.secrets.\n    if (key === \"acp_env\") continue;\n    const value =\n      key === \"acp_command\"\n        ? resolveAcpCommand(agentSettings)\n        : agentSettings[key];\n    if (value !== undefined && value !== null) {\n      payload[key] = value;\n    }\n  }\n\n  // ``mcp_config`` is a *shared* field (not in ACP_SETTINGS_KEYS): forward it\n  // so the ACP subprocess connects to the configured MCP servers at session\n  // creation. Only include it when it actually carries servers — an empty or\n  // malformed value is dropped rather than sending ``mcp_config: {}``.\n  const mcpConfig = toRecord(agentSettings.mcp_config);\n  if (Object.keys(mcpConfig).length > 0 && \"mcpServers\" in mcpConfig) {\n    payload.mcp_config = mcpConfig;\n  }\n\n  // Saved settings may carry ``acp_model: null`` (existing users predating\n  // the default-model registry, or saved fields the agent-server stripped).\n  // Fall back to the provider's ``default_model`` so the conversation starts\n  // with whatever the Settings → Agent UI shows — without that, the form's\n  // displayed default would silently not take effect at runtime until the\n  // user re-saved the page.\n  const serverKey =\n    typeof agentSettings.acp_server === \"string\"\n      ? agentSettings.acp_server\n      : undefined;\n  const provider = getAcpProvider(serverKey);\n  const effectiveModel = resolveEffectiveAcpModel({\n    configured: agentSettings.acp_model as string | null | undefined,\n    providerDefault: provider?.default_model,\n  });\n  if (effectiveModel) {\n    payload.acp_model = effectiveModel;\n  }\n\n  return payload;\n}\n\nfunction buildConfiguredOpenHandsAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  const agentSettings = toRecord(settings.agent_settings);\n  const llm = toRecord(agentSettings.llm);\n\n  llm.model =\n    typeof llm.model === \"string\" && llm.model.trim().length > 0\n      ? llm.model\n      : DEFAULT_SETTINGS.llm_model;\n\n  const apiKey = normalizeSecretString(llm.api_key);\n  if (apiKey) {\n    llm.api_key = apiKey;\n  } else {\n    delete llm.api_key;\n  }\n\n  const baseUrl = normalizeSecretString(llm.base_url);\n  if (baseUrl) {\n    llm.base_url = baseUrl;\n  } else {\n    delete llm.base_url;\n  }\n\n  const mcpConfig = toRecord(agentSettings.mcp_config);\n  if (Object.keys(mcpConfig).length === 0 || !(\"mcpServers\" in mcpConfig)) {\n    delete agentSettings.mcp_config;\n  }\n\n  delete agentSettings.acp_server;\n  for (const key of ACP_SETTINGS_KEYS) {\n    delete agentSettings[key];\n  }\n  // ``acp_env`` is no longer a forwarded ACP setting (provider creds ride the\n  // Secrets panel), but a legacy value may linger on persisted settings —\n  // scrub it so it never leaks onto the OpenHands payload.\n  delete agentSettings.acp_env;\n\n  return {\n    ...agentSettings,\n    llm,\n    agent_context: buildAgentContext(agentSettings),\n    tools: getAgentTools(agentSettings),\n  };\n}\n\nfunction buildConfiguredAgentSettings(\n  settings: Settings,\n): AgentSettingsPayload {\n  return isAcpAgent(settings)\n    ? buildConfiguredAcpAgentSettings(settings)\n    : buildConfiguredOpenHandsAgentSettings(settings);\n}\n\nfunction buildConfiguredConversationSettings(options: {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  workingDir?: string;\n}): ConversationSettingsPayload {\n  const { settings, query, conversationInstructions, plugins, workingDir } =\n    options;\n  const conversationSettings = toRecord(settings.conversation_settings);\n  const initialMessage = buildInitialMessage(query, conversationInstructions);\n\n  CONVERSATION_SETTINGS_METADATA_KEYS.forEach(\n    (key) => delete conversationSettings[key],\n  );\n\n  const payload: ConversationSettingsPayload = {\n    ...conversationSettings,\n    workspace: {\n      kind: \"LocalWorkspace\",\n      working_dir: workingDir ?? getAgentServerWorkingDir(),\n    },\n    ...(initialMessage ? { initial_message: initialMessage } : {}),\n    ...(plugins?.length\n      ? {\n          plugins: plugins.map((plugin) => ({\n            source: plugin.source,\n            ...(plugin.ref ? { ref: plugin.ref } : {}),\n            ...(plugin.repo_path ? { repo_path: plugin.repo_path } : {}),\n          })),\n        }\n      : {}),\n  };\n\n  return payload;\n}\n\ninterface LookupSecret {\n  kind: \"LookupSecret\";\n  url: string;\n  headers?: Record<string, string>;\n  description?: string;\n}\n\ntype StartConversationPayload = Record<string, unknown> & {\n  agent_settings: AgentSettingsPayload;\n  workspace: LocalWorkspacePayload;\n  confirmation_policy: SettingsRecord;\n  security_analyzer?: SettingsRecord;\n  initial_message?: InitialMessagePayload;\n  max_iterations: number;\n  stuck_detection: true;\n  autotitle: true;\n  worktree: true;\n  secrets_encrypted?: true;\n  conversation_id?: string;\n  secrets?: Record<string, LookupSecret>;\n  tags?: Record<string, string>;\n  tool_module_qualnames?: Record<string, string>;\n};\n\nexport interface StartConversationOptions {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  conversationId?: string;\n  workingDir?: string;\n  encryptedAgentSettings?: Record<string, SettingsValue>;\n  encryptedConversationSettings?: Record<string, SettingsValue>;\n  secretsEncrypted?: boolean;\n  customSecrets?: Array<{ name: string; description?: string }>;\n}\n\nexport function buildStartConversationRequest(\n  options: StartConversationOptions,\n): StartConversationPayload {\n  const sourceAgentSettings = options.encryptedAgentSettings\n    ? { ...options.settings, agent_settings: options.encryptedAgentSettings }\n    : options.settings;\n\n  const acpMode = isAcpAgent(sourceAgentSettings);\n  const agentSettings = buildConfiguredAgentSettings(sourceAgentSettings);\n  const acpServerTag = acpMode\n    ? getAcpServerTag(sourceAgentSettings)\n    : undefined;\n\n  const sourceConversationOptions = options.encryptedConversationSettings\n    ? {\n        ...options,\n        settings: {\n          ...options.settings,\n          conversation_settings: options.encryptedConversationSettings,\n        },\n      }\n    : options;\n\n  const conversationSettings = buildConfiguredConversationSettings(\n    sourceConversationOptions,\n  );\n\n  const payload: StartConversationPayload = {\n    agent_settings: agentSettings,\n    workspace: conversationSettings.workspace,\n    confirmation_policy:\n      getConversationConfirmationPolicy(conversationSettings),\n    max_iterations:\n      typeof conversationSettings.max_iterations === \"number\"\n        ? conversationSettings.max_iterations\n        : 500,\n    stuck_detection: true,\n    autotitle: true,\n    worktree: true,\n  };\n\n  if (acpServerTag) {\n    payload.tags = { [ACP_SERVER_TAG_KEY]: acpServerTag };\n  }\n\n  if (options.secretsEncrypted) {\n    payload.secrets_encrypted = true;\n  }\n\n  if (options.conversationId) {\n    payload.conversation_id = options.conversationId;\n  }\n\n  const securityAnalyzer =\n    getConversationSecurityAnalyzer(conversationSettings);\n  if (securityAnalyzer) {\n    payload.security_analyzer = securityAnalyzer;\n  }\n\n  if (conversationSettings.initial_message) {\n    payload.initial_message = conversationSettings.initial_message;\n  }\n\n  if (conversationSettings.plugins) {\n    payload.plugins = conversationSettings.plugins;\n  }\n\n  if (conversationSettings.hook_config) {\n    payload.hook_config = conversationSettings.hook_config;\n  }\n\n  payload.tool_module_qualnames = {\n    [CANVAS_UI_TOOL_NAME]: CANVAS_UI_TOOL_MODULE,\n    ...((conversationSettings.tool_module_qualnames as\n      | Record<string, string>\n      | undefined) ?? {}),\n  };\n\n  if (conversationSettings.agent_definitions) {\n    payload.agent_definitions = conversationSettings.agent_definitions;\n  }\n\n  if (options.customSecrets && options.customSecrets.length > 0) {\n    const backend = getEffectiveLocalBackend();\n    const headers = backend ? buildAuthHeaders(backend) : {};\n\n    const secrets: Record<string, LookupSecret> = {};\n    for (const secret of options.customSecrets) {\n      const lookupSecret: LookupSecret = {\n        kind: \"LookupSecret\",\n        url: `/api/settings/secrets/${encodeURIComponent(secret.name)}`,\n        description: secret.description,\n      };\n\n      if (Object.keys(headers).length > 0) {\n        lookupSecret.headers = headers;\n      }\n\n      secrets[secret.name] = lookupSecret;\n    }\n\n    payload.secrets = secrets;\n\n    if (acpMode) {\n      payload.agent_settings.agent_context = {\n        ...payload.agent_settings.agent_context,\n        secrets,\n      };\n    }\n  }\n\n  return payload;\n}\n\nexport async function buildStartConversationRequestWithEncryptedSettings(options: {\n  settings: Settings;\n  query?: string;\n  conversationInstructions?: string;\n  plugins?: PluginSpec[];\n  conversationId?: string;\n  workingDir?: string;\n}): Promise<Record<string, unknown>> {\n  const { SecretsService } = await import(\"./secrets-service\");\n\n  const [settingsResult, customSecrets] = await Promise.all([\n    SettingsService.getSettingsForConversation(),\n    SecretsService.getSecrets(),\n  ]);\n\n  const { agentSettings, conversationSettings, secretsEncrypted } =\n    settingsResult;\n\n  return buildStartConversationRequest({\n    ...options,\n    encryptedAgentSettings: agentSettings,\n    encryptedConversationSettings: conversationSettings,\n    secretsEncrypted,\n    customSecrets,\n  });\n}\n\nexport function emptyHooksResponse(): GetHooksResponse {\n  return { hooks: [] };\n}\n"],"mappings":"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"}

package/dist/api/app-preferences-store.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-preferences-store.cjs","names":[],"sources":["../../src/api/app-preferences-store.ts"],"sourcesContent":["import { Settings } from \"#/types/settings\";\n\n/**\n * The local agent-server's PATCH /api/settings only persists\n * `agent_settings_diff` and `conversation_settings_diff`. App-level user\n * preferences (language, sound notifications, analytics consent, git\n * identity) have no native home there, so we persist them in localStorage\n * — the same approach `secrets-service.ts` uses for git provider tokens.\n *\n * In cloud mode the cloud backend accepts these fields as flat top-level\n * keys at POST /api/v1/settings, and the cloud fetch returns them. We\n * still write through to localStorage so the values survive momentary\n * fetch failures and so the merge logic in `syncDerivedSettings` has a\n * single source for both modes.\n */\nexport const APP_PREFERENCES_STORAGE_KEY =\n  \"openhands-agent-server-app-preferences\";\n\nexport const APP_PREFERENCE_FIELDS = [\n  \"language\",\n  \"user_consents_to_analytics\",\n  \"enable_sound_notifications\",\n  \"git_user_name\",\n  \"git_user_email\",\n] as const;\n\nexport type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];\n\nexport type StoredAppPreferences = Partial<Pick<Settings, AppPreferenceField>>;\n\nconst APP_PREFERENCE_FIELD_SET: ReadonlySet<string> = new Set(\n  APP_PREFERENCE_FIELDS,\n);\n\nconst isAppPreferenceField = (key: string): key is AppPreferenceField =>\n  APP_PREFERENCE_FIELD_SET.has(key);\n\nconst coerceValue = (\n  key: AppPreferenceField,\n  value: unknown,\n): StoredAppPreferences[AppPreferenceField] | undefined => {\n  switch (key) {\n    case \"language\":\n    case \"git_user_name\":\n    case \"git_user_email\":\n      return typeof value === \"string\" ? value : undefined;\n    case \"enable_sound_notifications\":\n      return typeof value === \"boolean\" ? value : undefined;\n    case \"user_consents_to_analytics\":\n      if (value === null) return null;\n      return typeof value === \"boolean\" ? value : undefined;\n    default:\n      return undefined;\n  }\n};\n\nconst sanitize = (input: Record<string, unknown>): StoredAppPreferences => {\n  const out: StoredAppPreferences = {};\n  for (const key of APP_PREFERENCE_FIELDS) {\n    if (key in input) {\n      const coerced = coerceValue(key, input[key]);\n      if (coerced !== undefined) {\n        // TS can't narrow per-key writes through a discriminated assignment,\n        // so funnel through a single record write.\n        (out as Record<string, unknown>)[key] = coerced;\n      }\n    }\n  }\n  return out;\n};\n\nexport const readStoredAppPreferences = (): StoredAppPreferences => {\n  if (typeof window === \"undefined\") {\n    return {};\n  }\n\n  try {\n    const raw = window.localStorage.getItem(APP_PREFERENCES_STORAGE_KEY);\n    if (!raw) return {};\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      return {};\n    }\n    return sanitize(parsed as Record<string, unknown>);\n  } catch {\n    return {};\n  }\n};\n\nexport const writeStoredAppPreferences = (\n  partial: StoredAppPreferences,\n): void => {\n  if (typeof window === \"undefined\") return;\n\n  const sanitized = sanitize(partial as Record<string, unknown>);\n  const existing = readStoredAppPreferences();\n  const merged: StoredAppPreferences = { ...existing, ...sanitized };\n\n  if (Object.keys(merged).length === 0) {\n    window.localStorage.removeItem(APP_PREFERENCES_STORAGE_KEY);\n    return;\n  }\n\n  window.localStorage.setItem(\n    APP_PREFERENCES_STORAGE_KEY,\n    JSON.stringify(merged),\n  );\n};\n\nexport const clearStoredAppPreferences = (): void => {\n  if (typeof window === \"undefined\") return;\n  window.localStorage.removeItem(APP_PREFERENCES_STORAGE_KEY);\n};\n\n/**\n * Split known app-preference keys out of a save payload. Used by\n * `SettingsService.saveSettings` so the local PATCH only ever sees the\n * diff fields the agent-server accepts.\n */\nexport const extractAppPreferences = (\n  input: Record<string, unknown>,\n): { extracted: StoredAppPreferences; rest: Record<string, unknown> } => {\n  const extracted: StoredAppPreferences = {};\n  const rest: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(input)) {\n    if (isAppPreferenceField(key)) {\n      const coerced = coerceValue(key, value);\n      if (coerced !== undefined) {\n        (extracted as Record<string, unknown>)[key] = coerced;\n      }\n    } else {\n      rest[key] = value;\n    }\n  }\n\n  return { extracted, rest };\n};\n"],"mappings":"6CAeA,IAAa,EACX,yCAEW,EAAwB,CACnC,WACA,6BACA,6BACA,gBACA,iBACD,CAMK,EAAgD,IAAI,IACxD,EACD,CAEK,EAAwB,GAC5B,EAAyB,IAAI,EAAI,CAE7B,GACJ,EACA,IACyD,CACzD,OAAQ,EAAR,CACE,IAAK,WACL,IAAK,gBACL,IAAK,iBACH,OAAO,OAAO,GAAU,SAAW,EAAQ,IAAA,GAC7C,IAAK,6BACH,OAAO,OAAO,GAAU,UAAY,EAAQ,IAAA,GAC9C,IAAK,6BAEH,OADI,IAAU,KAAa,KACpB,OAAO,GAAU,UAAY,EAAQ,IAAA,GAC9C,QACE,SAIA,EAAY,GAAyD,CACzE,IAAM,EAA4B,EAAE,CACpC,IAAK,IAAM,KAAO,EAChB,GAAI,KAAO,EAAO,CAChB,IAAM,EAAU,EAAY,EAAK,EAAM,GAAK,CACxC,IAAY,IAAA,KAGb,EAAgC,GAAO,GAI9C,OAAO,GAGI,MAAuD,CAClE,GAAI,OAAO,OAAW,IACpB,MAAO,EAAE,CAGX,GAAI,CACF,IAAM,EAAM,OAAO,aAAa,QAAQ,EAA4B,CACpE,GAAI,CAAC,EAAK,MAAO,EAAE,CACnB,IAAM,EAAS,KAAK,MAAM,EAAI,CAI9B,MAHI,CAAC,GAAU,OAAO,GAAW,UAAY,MAAM,QAAQ,EAAO,CACzD,EAAE,CAEJ,EAAS,EAAkC,MAC5C,CACN,MAAO,EAAE,GAIA,EACX,GACS,CACT,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAM,EAAY,EAAS,EAAmC,CAExD,EAA+B,CAAE,GADtB,GACyB,CAAU,GAAG,EAAW,CAElE,GAAI,OAAO,KAAK,EAAO,CAAC,SAAW,EAAG,CACpC,OAAO,aAAa,WAAW,EAA4B,CAC3D,OAGF,OAAO,aAAa,QAClB,EACA,KAAK,UAAU,EAAO,CACvB,EAaU,EACX,GACuE,CACvE,IAAM,EAAkC,EAAE,CACpC,EAAgC,EAAE,CAExC,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,EAAM,CAC9C,GAAI,EAAqB,EAAI,CAAE,CAC7B,IAAM,EAAU,EAAY,EAAK,EAAM,CACnC,IAAY,IAAA,KACb,EAAsC,GAAO,QAGhD,EAAK,GAAO,EAIhB,MAAO,CAAE,YAAW,OAAM"}
+{"version":3,"file":"app-preferences-store.cjs","names":[],"sources":["../../src/api/app-preferences-store.ts"],"sourcesContent":["import { Settings } from \"#/types/settings\";\n\n/**\n * The local agent-server's PATCH /api/settings only persists\n * `agent_settings_diff` and `conversation_settings_diff`. App-level user\n * preferences (language, sound notifications, analytics consent, git\n * identity) have no native home in that schema, so we persist them in\n * localStorage as a workaround. This is the same fallback pattern used\n * by `DISABLED_SKILLS_STORAGE_KEY` in `settings-service.api.ts`.\n *\n * In cloud mode the cloud backend accepts these fields as flat top-level\n * keys at POST /api/v1/settings, and the cloud fetch returns them. We\n * still write through to localStorage so the values survive momentary\n * fetch failures and so the merge logic in `syncDerivedSettings` has a\n * single source for both modes.\n *\n * Long-term goal: extend the local agent-server settings schema to cover\n * these fields and delete this module entirely.\n */\nexport const APP_PREFERENCES_STORAGE_KEY =\n  \"openhands-agent-server-app-preferences\";\n\nexport const APP_PREFERENCE_FIELDS = [\n  \"language\",\n  \"user_consents_to_analytics\",\n  \"enable_sound_notifications\",\n  \"git_user_name\",\n  \"git_user_email\",\n] as const;\n\nexport type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];\n\nexport type StoredAppPreferences = Partial<Pick<Settings, AppPreferenceField>>;\n\nconst APP_PREFERENCE_FIELD_SET: ReadonlySet<string> = new Set(\n  APP_PREFERENCE_FIELDS,\n);\n\nconst isAppPreferenceField = (key: string): key is AppPreferenceField =>\n  APP_PREFERENCE_FIELD_SET.has(key);\n\nconst coerceValue = (\n  key: AppPreferenceField,\n  value: unknown,\n): StoredAppPreferences[AppPreferenceField] | undefined => {\n  switch (key) {\n    case \"language\":\n    case \"git_user_name\":\n    case \"git_user_email\":\n      return typeof value === \"string\" ? value : undefined;\n    case \"enable_sound_notifications\":\n      return typeof value === \"boolean\" ? value : undefined;\n    case \"user_consents_to_analytics\":\n      if (value === null) return null;\n      return typeof value === \"boolean\" ? value : undefined;\n    default:\n      return undefined;\n  }\n};\n\nconst sanitize = (input: Record<string, unknown>): StoredAppPreferences => {\n  const out: StoredAppPreferences = {};\n  for (const key of APP_PREFERENCE_FIELDS) {\n    if (key in input) {\n      const coerced = coerceValue(key, input[key]);\n      if (coerced !== undefined) {\n        // TS can't narrow per-key writes through a discriminated assignment,\n        // so funnel through a single record write.\n        (out as Record<string, unknown>)[key] = coerced;\n      }\n    }\n  }\n  return out;\n};\n\nexport const readStoredAppPreferences = (): StoredAppPreferences => {\n  if (typeof window === \"undefined\") {\n    return {};\n  }\n\n  try {\n    const raw = window.localStorage.getItem(APP_PREFERENCES_STORAGE_KEY);\n    if (!raw) return {};\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      return {};\n    }\n    return sanitize(parsed as Record<string, unknown>);\n  } catch {\n    return {};\n  }\n};\n\nexport const writeStoredAppPreferences = (\n  partial: StoredAppPreferences,\n): void => {\n  if (typeof window === \"undefined\") return;\n\n  const sanitized = sanitize(partial as Record<string, unknown>);\n  const existing = readStoredAppPreferences();\n  const merged: StoredAppPreferences = { ...existing, ...sanitized };\n\n  if (Object.keys(merged).length === 0) {\n    window.localStorage.removeItem(APP_PREFERENCES_STORAGE_KEY);\n    return;\n  }\n\n  window.localStorage.setItem(\n    APP_PREFERENCES_STORAGE_KEY,\n    JSON.stringify(merged),\n  );\n};\n\nexport const clearStoredAppPreferences = (): void => {\n  if (typeof window === \"undefined\") return;\n  window.localStorage.removeItem(APP_PREFERENCES_STORAGE_KEY);\n};\n\n/**\n * Split known app-preference keys out of a save payload. Used by\n * `SettingsService.saveSettings` so the local PATCH only ever sees the\n * diff fields the agent-server accepts.\n */\nexport const extractAppPreferences = (\n  input: Record<string, unknown>,\n): { extracted: StoredAppPreferences; rest: Record<string, unknown> } => {\n  const extracted: StoredAppPreferences = {};\n  const rest: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(input)) {\n    if (isAppPreferenceField(key)) {\n      const coerced = coerceValue(key, value);\n      if (coerced !== undefined) {\n        (extracted as Record<string, unknown>)[key] = coerced;\n      }\n    } else {\n      rest[key] = value;\n    }\n  }\n\n  return { extracted, rest };\n};\n"],"mappings":"6CAmBA,IAAa,EACX,yCAEW,EAAwB,CACnC,WACA,6BACA,6BACA,gBACA,iBACD,CAMK,EAAgD,IAAI,IACxD,EACD,CAEK,EAAwB,GAC5B,EAAyB,IAAI,EAAI,CAE7B,GACJ,EACA,IACyD,CACzD,OAAQ,EAAR,CACE,IAAK,WACL,IAAK,gBACL,IAAK,iBACH,OAAO,OAAO,GAAU,SAAW,EAAQ,IAAA,GAC7C,IAAK,6BACH,OAAO,OAAO,GAAU,UAAY,EAAQ,IAAA,GAC9C,IAAK,6BAEH,OADI,IAAU,KAAa,KACpB,OAAO,GAAU,UAAY,EAAQ,IAAA,GAC9C,QACE,SAIA,EAAY,GAAyD,CACzE,IAAM,EAA4B,EAAE,CACpC,IAAK,IAAM,KAAO,EAChB,GAAI,KAAO,EAAO,CAChB,IAAM,EAAU,EAAY,EAAK,EAAM,GAAK,CACxC,IAAY,IAAA,KAGb,EAAgC,GAAO,GAI9C,OAAO,GAGI,MAAuD,CAClE,GAAI,OAAO,OAAW,IACpB,MAAO,EAAE,CAGX,GAAI,CACF,IAAM,EAAM,OAAO,aAAa,QAAQ,EAA4B,CACpE,GAAI,CAAC,EAAK,MAAO,EAAE,CACnB,IAAM,EAAS,KAAK,MAAM,EAAI,CAI9B,MAHI,CAAC,GAAU,OAAO,GAAW,UAAY,MAAM,QAAQ,EAAO,CACzD,EAAE,CAEJ,EAAS,EAAkC,MAC5C,CACN,MAAO,EAAE,GAIA,EACX,GACS,CACT,GAAI,OAAO,OAAW,IAAa,OAEnC,IAAM,EAAY,EAAS,EAAmC,CAExD,EAA+B,CAAE,GADtB,GACyB,CAAU,GAAG,EAAW,CAElE,GAAI,OAAO,KAAK,EAAO,CAAC,SAAW,EAAG,CACpC,OAAO,aAAa,WAAW,EAA4B,CAC3D,OAGF,OAAO,aAAa,QAClB,EACA,KAAK,UAAU,EAAO,CACvB,EAaU,EACX,GACuE,CACvE,IAAM,EAAkC,EAAE,CACpC,EAAgC,EAAE,CAExC,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,EAAM,CAC9C,GAAI,EAAqB,EAAI,CAAE,CAC7B,IAAM,EAAU,EAAY,EAAK,EAAM,CACnC,IAAY,IAAA,KACb,EAAsC,GAAO,QAGhD,EAAK,GAAO,EAIhB,MAAO,CAAE,YAAW,OAAM"}

package/dist/api/app-preferences-store.d.ts

@@ -3,14 +3,18 @@ import { Settings } from "#/types/settings";
  * The local agent-server's PATCH /api/settings only persists
  * `agent_settings_diff` and `conversation_settings_diff`. App-level user
  * preferences (language, sound notifications, analytics consent, git
- * identity) have no native home there, so we persist them in localStorage
- * — the same approach `secrets-service.ts` uses for git provider tokens.
+ * identity) have no native home in that schema, so we persist them in
+ * localStorage as a workaround. This is the same fallback pattern used
+ * by `DISABLED_SKILLS_STORAGE_KEY` in `settings-service.api.ts`.
  *
  * In cloud mode the cloud backend accepts these fields as flat top-level
  * keys at POST /api/v1/settings, and the cloud fetch returns them. We
  * still write through to localStorage so the values survive momentary
  * fetch failures and so the merge logic in `syncDerivedSettings` has a
  * single source for both modes.
+ *
+ * Long-term goal: extend the local agent-server settings schema to cover
+ * these fields and delete this module entirely.
  */
 export declare const APP_PREFERENCES_STORAGE_KEY = "openhands-agent-server-app-preferences";
 export declare const APP_PREFERENCE_FIELDS: readonly ["language", "user_consents_to_analytics", "enable_sound_notifications", "git_user_name", "git_user_email"];

package/dist/api/app-preferences-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-preferences-store.js","names":[],"sources":["../../src/api/app-preferences-store.ts"],"sourcesContent":["import { Settings } from \"#/types/settings\";\n\n/**\n * The local agent-server's PATCH /api/settings only persists\n * `agent_settings_diff` and `conversation_settings_diff`. App-level user\n * preferences (language, sound notifications, analytics consent, git\n * identity) have no native home there, so we persist them in localStorage\n * — the same approach `secrets-service.ts` uses for git provider tokens.\n *\n * In cloud mode the cloud backend accepts these fields as flat top-level\n * keys at POST /api/v1/settings, and the cloud fetch returns them. We\n * still write through to localStorage so the values survive momentary\n * fetch failures and so the merge logic in `syncDerivedSettings` has a\n * single source for both modes.\n */\nexport const APP_PREFERENCES_STORAGE_KEY =\n  \"openhands-agent-server-app-preferences\";\n\nexport const APP_PREFERENCE_FIELDS = [\n  \"language\",\n  \"user_consents_to_analytics\",\n  \"enable_sound_notifications\",\n  \"git_user_name\",\n  \"git_user_email\",\n] as const;\n\nexport type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];\n\nexport type StoredAppPreferences = Partial<Pick<Settings, AppPreferenceField>>;\n\nconst APP_PREFERENCE_FIELD_SET: ReadonlySet<string> = new Set(\n  APP_PREFERENCE_FIELDS,\n);\n\nconst isAppPreferenceField = (key: string): key is AppPreferenceField =>\n  APP_PREFERENCE_FIELD_SET.has(key);\n\nconst coerceValue = (\n  key: AppPreferenceField,\n  value: unknown,\n): StoredAppPreferences[AppPreferenceField] | undefined => {\n  switch (key) {\n    case \"language\":\n    case \"git_user_name\":\n    case \"git_user_email\":\n      return typeof value === \"string\" ? value : undefined;\n    case \"enable_sound_notifications\":\n      return typeof value === \"boolean\" ? value : undefined;\n    case \"user_consents_to_analytics\":\n      if (value === null) return null;\n      return typeof value === \"boolean\" ? value : undefined;\n    default:\n      return undefined;\n  }\n};\n\nconst sanitize = (input: Record<string, unknown>): StoredAppPreferences => {\n  const out: StoredAppPreferences = {};\n  for (const key of APP_PREFERENCE_FIELDS) {\n    if (key in input) {\n      const coerced = coerceValue(key, input[key]);\n      if (coerced !== undefined) {\n        // TS can't narrow per-key writes through a discriminated assignment,\n        // so funnel through a single record write.\n        (out as Record<string, unknown>)[key] = coerced;\n      }\n    }\n  }\n  return out;\n};\n\nexport const readStoredAppPreferences = (): StoredAppPreferences => {\n  if (typeof window === \"undefined\") {\n    return {};\n  }\n\n  try {\n    const raw = window.localStorage.getItem(APP_PREFERENCES_STORAGE_KEY);\n    if (!raw) return {};\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      return {};\n    }\n    return sanitize(parsed as Record<string, unknown>);\n  } catch {\n    return {};\n  }\n};\n\nexport const writeStoredAppPreferences = (\n  partial: StoredAppPreferences,\n): void => {\n  if (typeof window === \"undefined\") return;\n\n  const sanitized = sanitize(partial as Record<string, unknown>);\n  const existing = readStoredAppPreferences();\n  const merged: StoredAppPreferences = { ...existing, ...sanitized };\n\n  if (Object.keys(merged).length === 0) {\n    window.localStorage.removeItem(APP_PREFERENCES_STORAGE_KEY);\n    return;\n  }\n\n  window.localStorage.setItem(\n    APP_PREFERENCES_STORAGE_KEY,\n    JSON.stringify(merged),\n  );\n};\n\nexport const clearStoredAppPreferences = (): void => {\n  if (typeof window === \"undefined\") return;\n  window.localStorage.removeItem(APP_PREFERENCES_STORAGE_KEY);\n};\n\n/**\n * Split known app-preference keys out of a save payload. Used by\n * `SettingsService.saveSettings` so the local PATCH only ever sees the\n * diff fields the agent-server accepts.\n */\nexport const extractAppPreferences = (\n  input: Record<string, unknown>,\n): { extracted: StoredAppPreferences; rest: Record<string, unknown> } => {\n  const extracted: StoredAppPreferences = {};\n  const rest: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(input)) {\n    if (isAppPreferenceField(key)) {\n      const coerced = coerceValue(key, value);\n      if (coerced !== undefined) {\n        (extracted as Record<string, unknown>)[key] = coerced;\n      }\n    } else {\n      rest[key] = value;\n    }\n  }\n\n  return { extracted, rest };\n};\n"],"mappings":";AAeA,IAAa,IACX,0CAEW,IAAwB;CACnC;CACA;CACA;CACA;CACA;CACD,EAMK,IAAgD,IAAI,IACxD,EACD,EAEK,KAAwB,MAC5B,EAAyB,IAAI,EAAI,EAE7B,KACJ,GACA,MACyD;AACzD,SAAQ,GAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK,iBACH,QAAO,OAAO,KAAU,WAAW,IAAQ,KAAA;EAC7C,KAAK,6BACH,QAAO,OAAO,KAAU,YAAY,IAAQ,KAAA;EAC9C,KAAK,6BAEH,QADI,MAAU,OAAa,OACpB,OAAO,KAAU,YAAY,IAAQ,KAAA;EAC9C,QACE;;GAIA,KAAY,MAAyD;CACzE,IAAM,IAA4B,EAAE;AACpC,MAAK,IAAM,KAAO,EAChB,KAAI,KAAO,GAAO;EAChB,IAAM,IAAU,EAAY,GAAK,EAAM,GAAK;AAC5C,EAAI,MAAY,KAAA,MAGb,EAAgC,KAAO;;AAI9C,QAAO;GAGI,UAAuD;AAClE,KAAI,OAAO,SAAW,IACpB,QAAO,EAAE;AAGX,KAAI;EACF,IAAM,IAAM,OAAO,aAAa,QAAQ,EAA4B;AACpE,MAAI,CAAC,EAAK,QAAO,EAAE;EACnB,IAAM,IAAS,KAAK,MAAM,EAAI;AAI9B,SAHI,CAAC,KAAU,OAAO,KAAW,YAAY,MAAM,QAAQ,EAAO,GACzD,EAAE,GAEJ,EAAS,EAAkC;SAC5C;AACN,SAAO,EAAE;;GAIA,KACX,MACS;AACT,KAAI,OAAO,SAAW,IAAa;CAEnC,IAAM,IAAY,EAAS,EAAmC,EAExD,IAA+B;EAAE,GADtB,GACyB;EAAU,GAAG;EAAW;AAElE,KAAI,OAAO,KAAK,EAAO,CAAC,WAAW,GAAG;AACpC,SAAO,aAAa,WAAW,EAA4B;AAC3D;;AAGF,QAAO,aAAa,QAClB,GACA,KAAK,UAAU,EAAO,CACvB;GAaU,KACX,MACuE;CACvE,IAAM,IAAkC,EAAE,EACpC,IAAgC,EAAE;AAExC,MAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,EAAM,CAC9C,KAAI,EAAqB,EAAI,EAAE;EAC7B,IAAM,IAAU,EAAY,GAAK,EAAM;AACvC,EAAI,MAAY,KAAA,MACb,EAAsC,KAAO;OAGhD,GAAK,KAAO;AAIhB,QAAO;EAAE;EAAW;EAAM"}
+{"version":3,"file":"app-preferences-store.js","names":[],"sources":["../../src/api/app-preferences-store.ts"],"sourcesContent":["import { Settings } from \"#/types/settings\";\n\n/**\n * The local agent-server's PATCH /api/settings only persists\n * `agent_settings_diff` and `conversation_settings_diff`. App-level user\n * preferences (language, sound notifications, analytics consent, git\n * identity) have no native home in that schema, so we persist them in\n * localStorage as a workaround. This is the same fallback pattern used\n * by `DISABLED_SKILLS_STORAGE_KEY` in `settings-service.api.ts`.\n *\n * In cloud mode the cloud backend accepts these fields as flat top-level\n * keys at POST /api/v1/settings, and the cloud fetch returns them. We\n * still write through to localStorage so the values survive momentary\n * fetch failures and so the merge logic in `syncDerivedSettings` has a\n * single source for both modes.\n *\n * Long-term goal: extend the local agent-server settings schema to cover\n * these fields and delete this module entirely.\n */\nexport const APP_PREFERENCES_STORAGE_KEY =\n  \"openhands-agent-server-app-preferences\";\n\nexport const APP_PREFERENCE_FIELDS = [\n  \"language\",\n  \"user_consents_to_analytics\",\n  \"enable_sound_notifications\",\n  \"git_user_name\",\n  \"git_user_email\",\n] as const;\n\nexport type AppPreferenceField = (typeof APP_PREFERENCE_FIELDS)[number];\n\nexport type StoredAppPreferences = Partial<Pick<Settings, AppPreferenceField>>;\n\nconst APP_PREFERENCE_FIELD_SET: ReadonlySet<string> = new Set(\n  APP_PREFERENCE_FIELDS,\n);\n\nconst isAppPreferenceField = (key: string): key is AppPreferenceField =>\n  APP_PREFERENCE_FIELD_SET.has(key);\n\nconst coerceValue = (\n  key: AppPreferenceField,\n  value: unknown,\n): StoredAppPreferences[AppPreferenceField] | undefined => {\n  switch (key) {\n    case \"language\":\n    case \"git_user_name\":\n    case \"git_user_email\":\n      return typeof value === \"string\" ? value : undefined;\n    case \"enable_sound_notifications\":\n      return typeof value === \"boolean\" ? value : undefined;\n    case \"user_consents_to_analytics\":\n      if (value === null) return null;\n      return typeof value === \"boolean\" ? value : undefined;\n    default:\n      return undefined;\n  }\n};\n\nconst sanitize = (input: Record<string, unknown>): StoredAppPreferences => {\n  const out: StoredAppPreferences = {};\n  for (const key of APP_PREFERENCE_FIELDS) {\n    if (key in input) {\n      const coerced = coerceValue(key, input[key]);\n      if (coerced !== undefined) {\n        // TS can't narrow per-key writes through a discriminated assignment,\n        // so funnel through a single record write.\n        (out as Record<string, unknown>)[key] = coerced;\n      }\n    }\n  }\n  return out;\n};\n\nexport const readStoredAppPreferences = (): StoredAppPreferences => {\n  if (typeof window === \"undefined\") {\n    return {};\n  }\n\n  try {\n    const raw = window.localStorage.getItem(APP_PREFERENCES_STORAGE_KEY);\n    if (!raw) return {};\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n      return {};\n    }\n    return sanitize(parsed as Record<string, unknown>);\n  } catch {\n    return {};\n  }\n};\n\nexport const writeStoredAppPreferences = (\n  partial: StoredAppPreferences,\n): void => {\n  if (typeof window === \"undefined\") return;\n\n  const sanitized = sanitize(partial as Record<string, unknown>);\n  const existing = readStoredAppPreferences();\n  const merged: StoredAppPreferences = { ...existing, ...sanitized };\n\n  if (Object.keys(merged).length === 0) {\n    window.localStorage.removeItem(APP_PREFERENCES_STORAGE_KEY);\n    return;\n  }\n\n  window.localStorage.setItem(\n    APP_PREFERENCES_STORAGE_KEY,\n    JSON.stringify(merged),\n  );\n};\n\nexport const clearStoredAppPreferences = (): void => {\n  if (typeof window === \"undefined\") return;\n  window.localStorage.removeItem(APP_PREFERENCES_STORAGE_KEY);\n};\n\n/**\n * Split known app-preference keys out of a save payload. Used by\n * `SettingsService.saveSettings` so the local PATCH only ever sees the\n * diff fields the agent-server accepts.\n */\nexport const extractAppPreferences = (\n  input: Record<string, unknown>,\n): { extracted: StoredAppPreferences; rest: Record<string, unknown> } => {\n  const extracted: StoredAppPreferences = {};\n  const rest: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(input)) {\n    if (isAppPreferenceField(key)) {\n      const coerced = coerceValue(key, value);\n      if (coerced !== undefined) {\n        (extracted as Record<string, unknown>)[key] = coerced;\n      }\n    } else {\n      rest[key] = value;\n    }\n  }\n\n  return { extracted, rest };\n};\n"],"mappings":";AAmBA,IAAa,IACX,0CAEW,IAAwB;CACnC;CACA;CACA;CACA;CACA;CACD,EAMK,IAAgD,IAAI,IACxD,EACD,EAEK,KAAwB,MAC5B,EAAyB,IAAI,EAAI,EAE7B,KACJ,GACA,MACyD;AACzD,SAAQ,GAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK,iBACH,QAAO,OAAO,KAAU,WAAW,IAAQ,KAAA;EAC7C,KAAK,6BACH,QAAO,OAAO,KAAU,YAAY,IAAQ,KAAA;EAC9C,KAAK,6BAEH,QADI,MAAU,OAAa,OACpB,OAAO,KAAU,YAAY,IAAQ,KAAA;EAC9C,QACE;;GAIA,KAAY,MAAyD;CACzE,IAAM,IAA4B,EAAE;AACpC,MAAK,IAAM,KAAO,EAChB,KAAI,KAAO,GAAO;EAChB,IAAM,IAAU,EAAY,GAAK,EAAM,GAAK;AAC5C,EAAI,MAAY,KAAA,MAGb,EAAgC,KAAO;;AAI9C,QAAO;GAGI,UAAuD;AAClE,KAAI,OAAO,SAAW,IACpB,QAAO,EAAE;AAGX,KAAI;EACF,IAAM,IAAM,OAAO,aAAa,QAAQ,EAA4B;AACpE,MAAI,CAAC,EAAK,QAAO,EAAE;EACnB,IAAM,IAAS,KAAK,MAAM,EAAI;AAI9B,SAHI,CAAC,KAAU,OAAO,KAAW,YAAY,MAAM,QAAQ,EAAO,GACzD,EAAE,GAEJ,EAAS,EAAkC;SAC5C;AACN,SAAO,EAAE;;GAIA,KACX,MACS;AACT,KAAI,OAAO,SAAW,IAAa;CAEnC,IAAM,IAAY,EAAS,EAAmC,EAExD,IAA+B;EAAE,GADtB,GACyB;EAAU,GAAG;EAAW;AAElE,KAAI,OAAO,KAAK,EAAO,CAAC,WAAW,GAAG;AACpC,SAAO,aAAa,WAAW,EAA4B;AAC3D;;AAGF,QAAO,aAAa,QAClB,GACA,KAAK,UAAU,EAAO,CACvB;GAaU,KACX,MACuE;CACvE,IAAM,IAAkC,EAAE,EACpC,IAAgC,EAAE;AAExC,MAAK,IAAM,CAAC,GAAK,MAAU,OAAO,QAAQ,EAAM,CAC9C,KAAI,EAAqB,EAAI,EAAE;EAC7B,IAAM,IAAU,EAAY,GAAK,EAAM;AACvC,EAAI,MAAY,KAAA,MACb,EAAsC,KAAO;OAGhD,GAAK,KAAO;AAIhB,QAAO;EAAE;EAAW;EAAM"}