@openhands/agent-canvas 1.16.0 → 1.17.0

package/dist/api/conversation-metadata-store.d.ts

@@ -31,10 +31,34 @@ export interface ConversationMetadata {
      * is ambiguous (issue #1082).
      */
     active_profile?: string | null;
+    /**
+     * When `active_profile` was stamped (ISO string). Written by the live
+     * WebSocket handler (the observation's server timestamp) and the user
+     * `/model` mutation (client clock). The history seed compares the latest
+     * SwitchLLM observation's timestamp against this so a reload can repair a
+     * missed agent switch without rolling back a newer manual switch — manual
+     * `/model` switches go through REST and leave no observation in history.
+     * Absent on stamps written before this field existed; treated as older
+     * than any observation so the seed can still repair them.
+     */
+    stamped_at?: string | null;
     /** Store plugin coordinates only; parameters may contain secrets. */
     plugins?: PluginSpec[] | null;
+    /**
+     * Local-only client-managed planning conversation id. Cloud backends expose
+     * real sub-conversations through `sub_conversation_ids`; local agent-server
+     * backends do not, so Canvas stores the relationship here.
+     */
+    local_planning_conversation_id?: string | null;
 }
 export declare const toPluginCoordinates: (plugin: PluginSpec) => PluginSpec;
 export declare const getStoredConversationMetadata: (conversationId: string) => ConversationMetadata | null;
 export declare const setStoredConversationMetadata: (conversationId: string, metadata: ConversationMetadata) => void;
+/**
+ * Merge `patch` into a conversation's stored metadata, preserving every
+ * existing field — `setStoredConversationMetadata` does a full-object
+ * replace, which would otherwise silently drop fields the caller doesn't
+ * enumerate (e.g. `plugins`).
+ */
+export declare const mergeStoredConversationMetadata: (conversationId: string, patch: Partial<ConversationMetadata>) => void;
 export declare const removeStoredConversationMetadata: (conversationId: string) => void;

package/dist/api/conversation-metadata-store.js

@@ -24,11 +24,19 @@ var e = "openhands-agent-server-conversation-metadata", t = (e) => ({
 }, i = (e) => n()[e] ?? null, a = (e, t) => {
 	let i = n();
 	i[e] = t, r(i);
-}, o = (e) => {
+}, o = (e, t) => {
+	a(e, {
+		selected_repository: null,
+		selected_branch: null,
+		git_provider: null,
+		...i(e) ?? {},
+		...t
+	});
+}, s = (e) => {
 	let t = n();
 	e in t && (delete t[e], r(t));
 };
 //#endregion
-export { i as getStoredConversationMetadata, o as removeStoredConversationMetadata, a as setStoredConversationMetadata, t as toPluginCoordinates };
+export { i as getStoredConversationMetadata, o as mergeStoredConversationMetadata, s as removeStoredConversationMetadata, a as setStoredConversationMetadata, t as toPluginCoordinates };
 
 //# sourceMappingURL=conversation-metadata-store.js.map

package/dist/api/conversation-metadata-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-metadata-store.js","names":[],"sources":["../../src/api/conversation-metadata-store.ts"],"sourcesContent":["import { Provider } from \"#/types/settings\";\nimport type { PluginSpec } from \"#/api/conversation-service/agent-server-conversation-service.types\";\n\nconst STORAGE_KEY = \"openhands-agent-server-conversation-metadata\";\n\nexport type WorkspaceMode = \"local_repo\" | \"new_worktree\";\n\nexport interface ConversationMetadata {\n  selected_repository: string | null;\n  selected_branch: string | null;\n  git_provider: Provider | null;\n  /**\n   * The local workspace path the user explicitly attached at conversation\n   * creation time. Distinct from `selected_repository` (which is set by\n   * the repo picker on the home page). Used by the Files tab to decide\n   * whether to default to diff view: if the user attached *anything*\n   * (repo or local workspace), we lean diff-first because there's a real\n   * git baseline to compare against.\n   */\n  selected_workspace?: string | null;\n  /**\n   * How the conversation should use `selected_workspace`.\n   *\n   * `local_repo` means the runtime should operate directly in the selected\n   * folder, even when it is not a git checkout. `new_worktree` preserves the\n   * historical agent-server behavior for conversations that should start in a\n   * generated per-conversation worktree.\n   */\n  workspace_mode?: WorkspaceMode | null;\n  /**\n   * The LLM profile the conversation was created with (or last switched to).\n   * Client-side only. Lets the chat-header switcher show the exact profile\n   * name even when several profiles share the same underlying model — the\n   * agent-server only round-trips the model string, so matching on it alone\n   * is ambiguous (issue #1082).\n   */\n  active_profile?: string | null;\n  /** Store plugin coordinates only; parameters may contain secrets. */\n  plugins?: PluginSpec[] | null;\n}\n\nexport const toPluginCoordinates = (plugin: PluginSpec): PluginSpec => ({\n  source: plugin.source,\n  ref: plugin.ref ?? null,\n  repo_path: plugin.repo_path ?? null,\n});\n\ntype StoredMetadata = Record<string, ConversationMetadata>;\n\nconst readAll = (): StoredMetadata => {\n  if (typeof window === \"undefined\") return {};\n  try {\n    const raw = window.localStorage.getItem(STORAGE_KEY);\n    if (!raw) return {};\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== \"object\") return {};\n    return parsed as StoredMetadata;\n  } catch {\n    return {};\n  }\n};\n\nconst writeAll = (next: StoredMetadata): void => {\n  if (typeof window === \"undefined\") return;\n  if (Object.keys(next).length === 0) {\n    window.localStorage.removeItem(STORAGE_KEY);\n    return;\n  }\n  window.localStorage.setItem(STORAGE_KEY, JSON.stringify(next));\n};\n\nexport const getStoredConversationMetadata = (\n  conversationId: string,\n): ConversationMetadata | null => readAll()[conversationId] ?? null;\n\nexport const setStoredConversationMetadata = (\n  conversationId: string,\n  metadata: ConversationMetadata,\n): void => {\n  const all = readAll();\n  all[conversationId] = metadata;\n  writeAll(all);\n};\n\nexport const removeStoredConversationMetadata = (\n  conversationId: string,\n): void => {\n  const all = readAll();\n  if (!(conversationId in all)) return;\n  delete all[conversationId];\n  writeAll(all);\n};\n"],"mappings":";AAGA,IAAM,IAAc,gDAsCP,KAAuB,OAAoC;CACtE,QAAQ,EAAO;CACf,KAAK,EAAO,OAAO;CACnB,WAAW,EAAO,aAAa;AACjC,IAIM,UAAgC;CACpC,IAAI,OAAO,SAAW,KAAa,OAAO,CAAC;CAC3C,IAAI;EACF,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAW;EACnD,IAAI,CAAC,GAAK,OAAO,CAAC;EAClB,IAAM,IAAS,KAAK,MAAM,CAAG;EAE7B,OADI,CAAC,KAAU,OAAO,KAAW,WAAiB,CAAC,IAC5C;CACT,QAAQ;EACN,OAAO,CAAC;CACV;AACF,GAEM,KAAY,MAA+B;CAC3C,aAAO,SAAW,MACtB;MAAI,OAAO,KAAK,CAAI,EAAE,WAAW,GAAG;GAClC,OAAO,aAAa,WAAW,CAAW;GAC1C;EACF;EACA,OAAO,aAAa,QAAQ,GAAa,KAAK,UAAU,CAAI,CAAC;CAD7D;AAEF,GAEa,KACX,MACgC,EAAQ,EAAE,MAAmB,MAElD,KACX,GACA,MACS;CACT,IAAM,IAAM,EAAQ;CAEpB,AADA,EAAI,KAAkB,GACtB,EAAS,CAAG;AACd,GAEa,KACX,MACS;CACT,IAAM,IAAM,EAAQ;CACd,KAAkB,MACxB,OAAO,EAAI,IACX,EAAS,CAAG;AACd"}
+{"version":3,"file":"conversation-metadata-store.js","names":[],"sources":["../../src/api/conversation-metadata-store.ts"],"sourcesContent":["import { Provider } from \"#/types/settings\";\nimport type { PluginSpec } from \"#/api/conversation-service/agent-server-conversation-service.types\";\n\nconst STORAGE_KEY = \"openhands-agent-server-conversation-metadata\";\n\nexport type WorkspaceMode = \"local_repo\" | \"new_worktree\";\n\nexport interface ConversationMetadata {\n  selected_repository: string | null;\n  selected_branch: string | null;\n  git_provider: Provider | null;\n  /**\n   * The local workspace path the user explicitly attached at conversation\n   * creation time. Distinct from `selected_repository` (which is set by\n   * the repo picker on the home page). Used by the Files tab to decide\n   * whether to default to diff view: if the user attached *anything*\n   * (repo or local workspace), we lean diff-first because there's a real\n   * git baseline to compare against.\n   */\n  selected_workspace?: string | null;\n  /**\n   * How the conversation should use `selected_workspace`.\n   *\n   * `local_repo` means the runtime should operate directly in the selected\n   * folder, even when it is not a git checkout. `new_worktree` preserves the\n   * historical agent-server behavior for conversations that should start in a\n   * generated per-conversation worktree.\n   */\n  workspace_mode?: WorkspaceMode | null;\n  /**\n   * The LLM profile the conversation was created with (or last switched to).\n   * Client-side only. Lets the chat-header switcher show the exact profile\n   * name even when several profiles share the same underlying model — the\n   * agent-server only round-trips the model string, so matching on it alone\n   * is ambiguous (issue #1082).\n   */\n  active_profile?: string | null;\n  /**\n   * When `active_profile` was stamped (ISO string). Written by the live\n   * WebSocket handler (the observation's server timestamp) and the user\n   * `/model` mutation (client clock). The history seed compares the latest\n   * SwitchLLM observation's timestamp against this so a reload can repair a\n   * missed agent switch without rolling back a newer manual switch — manual\n   * `/model` switches go through REST and leave no observation in history.\n   * Absent on stamps written before this field existed; treated as older\n   * than any observation so the seed can still repair them.\n   */\n  stamped_at?: string | null;\n  /** Store plugin coordinates only; parameters may contain secrets. */\n  plugins?: PluginSpec[] | null;\n  /**\n   * Local-only client-managed planning conversation id. Cloud backends expose\n   * real sub-conversations through `sub_conversation_ids`; local agent-server\n   * backends do not, so Canvas stores the relationship here.\n   */\n  local_planning_conversation_id?: string | null;\n}\n\nexport const toPluginCoordinates = (plugin: PluginSpec): PluginSpec => ({\n  source: plugin.source,\n  ref: plugin.ref ?? null,\n  repo_path: plugin.repo_path ?? null,\n});\n\ntype StoredMetadata = Record<string, ConversationMetadata>;\n\nconst readAll = (): StoredMetadata => {\n  if (typeof window === \"undefined\") return {};\n  try {\n    const raw = window.localStorage.getItem(STORAGE_KEY);\n    if (!raw) return {};\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== \"object\") return {};\n    return parsed as StoredMetadata;\n  } catch {\n    return {};\n  }\n};\n\nconst writeAll = (next: StoredMetadata): void => {\n  if (typeof window === \"undefined\") return;\n  if (Object.keys(next).length === 0) {\n    window.localStorage.removeItem(STORAGE_KEY);\n    return;\n  }\n  window.localStorage.setItem(STORAGE_KEY, JSON.stringify(next));\n};\n\nexport const getStoredConversationMetadata = (\n  conversationId: string,\n): ConversationMetadata | null => readAll()[conversationId] ?? null;\n\nexport const setStoredConversationMetadata = (\n  conversationId: string,\n  metadata: ConversationMetadata,\n): void => {\n  const all = readAll();\n  all[conversationId] = metadata;\n  writeAll(all);\n};\n\n/**\n * Merge `patch` into a conversation's stored metadata, preserving every\n * existing field — `setStoredConversationMetadata` does a full-object\n * replace, which would otherwise silently drop fields the caller doesn't\n * enumerate (e.g. `plugins`).\n */\nexport const mergeStoredConversationMetadata = (\n  conversationId: string,\n  patch: Partial<ConversationMetadata>,\n): void => {\n  setStoredConversationMetadata(conversationId, {\n    selected_repository: null,\n    selected_branch: null,\n    git_provider: null,\n    ...(getStoredConversationMetadata(conversationId) ?? {}),\n    ...patch,\n  });\n};\n\nexport const removeStoredConversationMetadata = (\n  conversationId: string,\n): void => {\n  const all = readAll();\n  if (!(conversationId in all)) return;\n  delete all[conversationId];\n  writeAll(all);\n};\n"],"mappings":";AAGA,IAAM,IAAc,gDAuDP,KAAuB,OAAoC;CACtE,QAAQ,EAAO;CACf,KAAK,EAAO,OAAO;CACnB,WAAW,EAAO,aAAa;AACjC,IAIM,UAAgC;CACpC,IAAI,OAAO,SAAW,KAAa,OAAO,CAAC;CAC3C,IAAI;EACF,IAAM,IAAM,OAAO,aAAa,QAAQ,CAAW;EACnD,IAAI,CAAC,GAAK,OAAO,CAAC;EAClB,IAAM,IAAS,KAAK,MAAM,CAAG;EAE7B,OADI,CAAC,KAAU,OAAO,KAAW,WAAiB,CAAC,IAC5C;CACT,QAAQ;EACN,OAAO,CAAC;CACV;AACF,GAEM,KAAY,MAA+B;CAC3C,aAAO,SAAW,MACtB;MAAI,OAAO,KAAK,CAAI,EAAE,WAAW,GAAG;GAClC,OAAO,aAAa,WAAW,CAAW;GAC1C;EACF;EACA,OAAO,aAAa,QAAQ,GAAa,KAAK,UAAU,CAAI,CAAC;CAD7D;AAEF,GAEa,KACX,MACgC,EAAQ,EAAE,MAAmB,MAElD,KACX,GACA,MACS;CACT,IAAM,IAAM,EAAQ;CAEpB,AADA,EAAI,KAAkB,GACtB,EAAS,CAAG;AACd,GAQa,KACX,GACA,MACS;CACT,EAA8B,GAAgB;EAC5C,qBAAqB;EACrB,iBAAiB;EACjB,cAAc;EACd,GAAI,EAA8B,CAAc,KAAK,CAAC;EACtD,GAAG;CACL,CAAC;AACH,GAEa,KACX,MACS;CACT,IAAM,IAAM,EAAQ;CACd,KAAkB,MACxB,OAAO,EAAI,IACX,EAAS,CAAG;AACd"}

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

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/conversation-client.cjs"),t=require("../../node_modules/@openhands/typescript-client/dist/client/file-client.cjs"),n=require("../../node_modules/@openhands/typescript-client/dist/client/profiles-client.cjs"),r=require("../../node_modules/@openhands/typescript-client/dist/client/vscode-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const i=require("../../utils/websocket-url.cjs"),a=require("../agent-server-config.cjs"),o=require("../backend-registry/active-store.cjs"),s=require("../agent-server-client-options.cjs"),c=require("../../services/telemetry.cjs"),l=require("../conversation-metadata-store.cjs"),u=require("../cloud/proxy.cjs"),d=require("../cloud/conversation-service.api.cjs"),f=require("../../node_modules/@openhands/typescript-client/dist/models/conversation.cjs");require("../../node_modules/@openhands/typescript-client/dist/index.cjs");const p=require("../../node_modules/uuid/dist/v4.cjs"),m=require("../agent-server-home.cjs"),h=require("../profiles-service/profiles-service.api.cjs"),g=require("../settings-service/settings-service.api.cjs"),_=require("../agent-server-adapter.cjs"),v=require("../../utils/title-llm-profile.cjs");var y=`1970-01-01T00:00:00.000Z`,b=300*1e3,x=`Unable to load conversations because the selected agent server returned data this UI does not understand. Check the backend URL/session key and update the agent server if needed.`;function S(){return Error(x)}function C(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function w(e){return typeof e==`number`?e:null}function T(e){return typeof e==`number`?e:0}function E(e){return typeof e==`string`?e:null}function D(e,t,n){let r=e[t]??e[n];return typeof r==`string`&&r.trim()?r:y}function O(e){return C(e)?{prompt_tokens:T(e.prompt_tokens),completion_tokens:T(e.completion_tokens),cache_read_tokens:T(e.cache_read_tokens),cache_write_tokens:T(e.cache_write_tokens),context_window:T(e.context_window),per_turn_token:T(e.per_turn_token)}:null}function k(e){return C(e)?{accumulated_cost:w(e.accumulated_cost),max_budget_per_task:w(e.max_budget_per_task),accumulated_token_usage:O(e.accumulated_token_usage)}:null}function A(e){return C(e)?e:null}function j(e){if(!C(e))return null;let t=C(e.llm)?{model:E(e.llm.model)}:null;return{kind:E(e.kind),acp_server:E(e.acp_server),acp_model:E(e.acp_model),llm:t}}function M(e){return C(e)?{working_dir:E(e.working_dir)}:null}function N(e){if(!C(e))return null;let t={};for(let[n,r]of Object.entries(e))typeof r==`string`&&(t[n]=r);return t}function P(e){if(!C(e))return null;let{agent_profile_id:t,revision:n}=e;return typeof t!=`string`||typeof n!=`number`?null:{agent_profile_id:t,revision:n}}function F(e){if(!e.startsWith(`/`))return null;let t=[];for(let n of e.split(`/`))if(n&&n!==`.`)if(n===`..`){if(!t.length)return null;t.pop()}else t.push(n);return`/${t.join(`/`)}`}function I(e,t){let n=F(e),r=F(t);if(!n||!r||n!==r&&!n.startsWith(`${r}/`))throw Error(`Conversation file path must stay inside the workspace`);return n}function L(e){if(!C(e)||typeof e.id!=`string`||!e.id.trim())throw S();return{id:e.id.trim(),title:E(e.title),created_at:D(e,`created_at`,`createdAt`),updated_at:D(e,`updated_at`,`updatedAt`),execution_status:E(e.execution_status),sandbox_status:E(e.sandbox_status),metrics:k(e.metrics),stats:A(e.stats),agent:j(e.agent),workspace:M(e.workspace),tags:N(e.tags),launched_agent_profile:P(e.launched_agent_profile),current_model_id:E(e.current_model_id),current_model_name:E(e.current_model_name)}}function R(e){if(!Array.isArray(e))throw S();return e.map(L)}function z(e){if(Array.isArray(e))return{items:R(e),next_page_id:null};if(!C(e))throw S();return{items:R(e.items),next_page_id:typeof e.next_page_id==`string`?e.next_page_id:null}}var B=new Set([`idle`,`running`,`paused`,`waiting_for_confirmation`,`finished`,`error`,`stuck`]);function V(e){let t=e??`idle`;return B.has(t)?t:`idle`}function H(e,t){if(!e)throw Error(`Conversation ${t} was not found`);return e}var U=class{static async sendMessage(t,n,r){let a=o.getActiveBackend().backend,c=r?.conversationUrl??null,l=r?.sessionApiKey??null;if(a.kind===`cloud`){if(!c||!l){let[e]=await d.batchGetCloudConversations([t]);c=e?.conversation_url?.trim()??null,l=e?.session_api_key?.trim()??null}if(!c||!l)throw Error(`Conversation sandbox is still starting. Wait for it to finish, then try again.`);return await u.callCloudProxy({backend:a,method:`POST`,hostOverride:i.buildHttpBaseUrl(c),path:`/api/conversations/${t}/events`,body:{...n,run:!0},authMode:`session-api-key`,sessionApiKey:l}),n}return await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:c,sessionApiKey:l})).sendEvent(t,n,{run:!0}),n}static async createConversation(t={}){let{initialUserMsg:n,conversationInstructions:r,plugins:i,metadata:u,workingDirOverride:f,workspaceMode:y,parentConversationId:x,agentType:S,sandboxId:C,agentProfileId:w,agentProfileKind:T}=t;if(o.getActiveBackend().backend.kind===`cloud`)return d.createCloudAppConversation({initial_message:n?{role:`user`,content:[{type:`text`,text:n}]}:null,title:r??null,selected_repository:u?.selected_repository??null,selected_branch:u?.selected_branch??null,git_provider:u?.git_provider??null,plugins:i??null,parent_conversation_id:x??null,agent_type:S,sandbox_id:C??null,agent_profile_id:w??null,trigger:`gui`});let[E,D]=await Promise.all([g.default.getSettings(),h.default.listProfiles().catch(()=>void 0)]),O=v.resolveTitleLlmProfile(E.title_llm_profile,D),k=p.default(),A=await m.resolveAbsoluteAgentServerPath(f??a.buildConversationWorkingDirForBackend(k,o.getActiveBackend().backend.host)),j=y??(f?`local_repo`:`new_worktree`),M=await _.buildStartConversationRequestWithEncryptedSettings({settings:E,query:n,conversationInstructions:r,plugins:i,conversationId:k,parentConversationId:x,workingDir:A,worktree:j===`new_worktree`,agentProfileId:w,agentProfileKind:T,titleLlmProfile:O}),N=await c.getTelemetryDistinctId(),P=await new e.ConversationClient(s.getAgentServerClientOptions({timeout:b})).createConversation({...M,...N?{user_id:N}:{}}),F=o.getEffectiveLocalBackend();if(!F)throw new s.NoBackendAvailableError;return(u?.selected_repository||f)&&l.setStoredConversationMetadata(P.id,{selected_repository:u?.selected_repository??null,selected_branch:u?.selected_branch??null,git_provider:u?.git_provider??null,selected_workspace:f??null,workspace_mode:j}),{id:P.id,created_by_user_id:null,status:`READY`,detail:null,app_conversation_id:P.id,agent_server_url:F.host,request:{initial_message:M.initial_message,plugins:i??null},created_at:P.created_at,updated_at:P.updated_at}}static async getStartTask(e){return o.getActiveBackend().backend.kind===`cloud`?d.getCloudAppConversationStartTask(e):null}static async getVSCodeUrl(e,t,n){let i=await this.resolveConversationWorkingDir(e);return{vscode_url:await new r.VSCodeClient(s.getAgentServerClientOptions({conversationUrl:t,sessionApiKey:n})).getUrl({baseUrl:typeof window<`u`?window.location.origin:void 0,workspaceDir:i})}}static async getVSCodeStatus(e,t){return new r.VSCodeClient(s.getAgentServerClientOptions({conversationUrl:e,sessionApiKey:t})).getStatus()}static async resolveConversationWorkingDir(e){let[t]=await this.batchGetAppConversations([e]);return t?.workspace?.working_dir??a.getAgentServerWorkingDir()}static async batchGetAppConversations(t){return t.length===0?[]:o.getActiveBackend().backend.kind===`cloud`?d.batchGetCloudConversations(t):R(await new e.ConversationClient(s.getAgentServerClientOptions()).getConversations(t)).map(e=>_.toAppConversation(e))}static async updateConversationPublicFlag(e,t){if(o.getActiveBackend().backend.kind!==`cloud`)throw Error(`Public sharing requires a cloud backend.`);return d.updateCloudConversationPublicFlag(e,t)}static async updateConversationRepository(e,t,n,r){t?l.setStoredConversationMetadata(e,{...l.getStoredConversationMetadata(e)??{},selected_repository:t,selected_branch:n??null,git_provider:r??null}):l.removeStoredConversationMetadata(e);let[i]=await this.batchGetAppConversations([e]);return H(i,e)}static async readConversationFile(e,n){if(o.getActiveBackend().backend.kind===`cloud`)return d.readCloudConversationFile(e,I(n??`/workspace/project/.agents_tmp/PLAN.md`,`/workspace/project`));let r=await this.resolveConversationWorkingDir(e),i=I(n??`${r}/.agents_tmp/PLAN.md`,r);return new t.FileClient(s.getAgentServerClientOptions()).downloadTextFile(i)}static async downloadConversation(e){return o.getActiveBackend().backend.kind===`cloud`?d.downloadCloudConversation(e):new t.FileClient(s.getAgentServerClientOptions()).downloadTrajectory(e)}static async getHooks(e){return _.emptyHooksResponse()}static async getRuntimeConversation(t,n,r){let i=L(await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:n,sessionApiKey:r})).getConversation(t));return{id:i.id,title:i.title?.trim()?i.title:_.getDefaultConversationTitle(i.id),metrics:k(i.metrics),created_at:i.created_at,updated_at:i.updated_at,status:V(i.execution_status),stats:i.stats??{usage_to_metrics:{}}}}static async condenseConversation(t,n,r){let a=o.getActiveBackend().backend;if(a.kind===`cloud`&&n){await u.callCloudProxy({backend:a,method:`POST`,hostOverride:i.buildHttpBaseUrl(n),path:`/api/conversations/${t}/condense`,authMode:`session-api-key`,sessionApiKey:r});return}await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:n,sessionApiKey:r})).condenseConversation(t)}static async searchConversations(t=20,n){return o.getActiveBackend().backend.kind===`cloud`?d.searchCloudConversations(t,n):_.toConversationPage(z(await new e.ConversationClient(s.getAgentServerClientOptions()).searchConversations({limit:t,page_id:n,sort_order:f.ConversationSortOrder.UPDATED_AT_DESC})))}static async deleteConversation(t){o.getActiveBackend().backend.kind===`cloud`?await d.deleteCloudConversation(t):await new e.ConversationClient(s.getAgentServerClientOptions()).deleteConversation(t),l.removeStoredConversationMetadata(t)}static async updateConversationTitle(t,n){if(o.getActiveBackend().backend.kind===`cloud`)return d.updateCloudConversationTitle(t,n);await new e.ConversationClient(s.getAgentServerClientOptions()).updateConversation(t,{title:n});let[r]=await this.batchGetAppConversations([t]);return H(r,t)}static async forkConversation(t,n,r){if(o.getActiveBackend().backend.kind===`cloud`)throw Error(`Branching a conversation isn't supported on the cloud backend yet.`);let i=await new e.ConversationClient(s.getAgentServerClientOptions()).forkConversation(t,{from_event_id:n,...r?{title:r}:{}}),a=l.getStoredConversationMetadata(t);return a&&l.setStoredConversationMetadata(i.id,a),i}static async getEventParentId(t,n){return(await new e.ConversationClient(s.getAgentServerClientOptions()).getEvent(t,n)).parent_id??void 0}static async switchProfile(t,r){let{backend:i}=o.getActiveBackend();if(i.kind===`cloud`){if(!t){await h.default.activateProfile(r);return}await u.callCloudProxy({backend:i,method:`POST`,path:`/api/v1/app-conversations/${t}/switch_profile`,body:{profile_name:r}});return}if(!t){await new n.ProfilesClient(s.getAgentServerClientOptions()).activateProfile(r);return}let a=s.getAgentServerClientOptions(),c=new e.ConversationClient(a),l=await new n.ProfilesClient(a).getProfile(r,{exposeSecrets:`encrypted`}),d=typeof l.config.model==`string`?l.config.model:``;if(!d)throw Error(`Profile '${r}' has no model.`);await _.assertSubscriptionAuthReady({llm:l.config}),await c.switchLLM(t,{...l.config,model:d,stream:!0,usage_id:`profile:${r}:${p.default()}`})}static async switchAcpModel(t,n){let{backend:r}=o.getActiveBackend();if(r.kind===`cloud`){await u.callCloudProxy({backend:r,method:`POST`,path:`/api/v1/app-conversations/${t}/switch_acp_model`,body:{model:n}});return}await new e.ConversationClient(s.getAgentServerClientOptions()).switchAcpModel(t,n)}};exports.default=U;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../node_modules/@openhands/typescript-client/dist/client/conversation-client.cjs"),t=require("../../node_modules/@openhands/typescript-client/dist/client/file-client.cjs"),n=require("../../node_modules/@openhands/typescript-client/dist/client/profiles-client.cjs"),r=require("../../node_modules/@openhands/typescript-client/dist/client/vscode-client.cjs");require("../../node_modules/@openhands/typescript-client/dist/clients.cjs");const i=require("../../utils/websocket-url.cjs"),a=require("../agent-server-config.cjs"),o=require("../backend-registry/active-store.cjs"),s=require("../agent-server-client-options.cjs"),c=require("../../services/telemetry.cjs"),l=require("../conversation-metadata-store.cjs"),u=require("../cloud/proxy.cjs"),d=require("../cloud/conversation-service.api.cjs"),f=require("../../node_modules/@openhands/typescript-client/dist/models/conversation.cjs");require("../../node_modules/@openhands/typescript-client/dist/index.cjs");const p=require("../../node_modules/uuid/dist/v4.cjs"),m=require("../agent-server-home.cjs"),h=require("../profiles-service/profiles-service.api.cjs"),g=require("../settings-service/settings-service.api.cjs"),_=require("../../utils/plan-file.cjs"),v=require("../agent-server-adapter.cjs"),y=require("../../utils/title-llm-profile.cjs");var b=`1970-01-01T00:00:00.000Z`,x=300*1e3,S=`Unable to load conversations because the selected agent server returned data this UI does not understand. Check the backend URL/session key and update the agent server if needed.`;function C(){return Error(S)}function w(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function T(e){return typeof e==`number`?e:null}function E(e){return typeof e==`number`?e:0}function D(e){return typeof e==`string`?e:null}function O(e,t,n){let r=e[t]??e[n];return typeof r==`string`&&r.trim()?r:b}function k(e){return w(e)?{prompt_tokens:E(e.prompt_tokens),completion_tokens:E(e.completion_tokens),cache_read_tokens:E(e.cache_read_tokens),cache_write_tokens:E(e.cache_write_tokens),context_window:E(e.context_window),per_turn_token:E(e.per_turn_token)}:null}function A(e){return w(e)?{accumulated_cost:T(e.accumulated_cost),max_budget_per_task:T(e.max_budget_per_task),accumulated_token_usage:k(e.accumulated_token_usage)}:null}function j(e){return w(e)?e:null}function M(e){if(!w(e))return null;let t=w(e.llm)?{model:D(e.llm.model)}:null;return{kind:D(e.kind),acp_server:D(e.acp_server),acp_model:D(e.acp_model),llm:t}}function N(e){return w(e)?{working_dir:D(e.working_dir)}:null}function P(e){if(!w(e))return null;let t={};for(let[n,r]of Object.entries(e))typeof r==`string`&&(t[n]=r);return t}function F(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`):null}function I(e){if(!w(e))return null;let{agent_profile_id:t,revision:n}=e;return typeof t!=`string`||typeof n!=`number`?null:{agent_profile_id:t,revision:n}}function L(e){if(!e.startsWith(`/`))return null;let t=[];for(let n of e.split(`/`))if(n&&n!==`.`)if(n===`..`){if(!t.length)return null;t.pop()}else t.push(n);return`/${t.join(`/`)}`}function R(e,t){let n=L(e),r=L(t);if(!n||!r||n!==r&&!n.startsWith(`${r}/`))throw Error(`Conversation file path must stay inside the workspace`);return n}function z(e){if(!w(e)||typeof e.id!=`string`||!e.id.trim())throw C();return{id:e.id.trim(),title:D(e.title),created_at:O(e,`created_at`,`createdAt`),updated_at:O(e,`updated_at`,`updatedAt`),execution_status:D(e.execution_status),sandbox_status:D(e.sandbox_status),metrics:A(e.metrics),stats:j(e.stats),agent:M(e.agent),workspace:N(e.workspace),tags:P(e.tags),launched_agent_profile:I(e.launched_agent_profile),sub_conversation_ids:F(e.sub_conversation_ids),current_model_id:D(e.current_model_id),current_model_name:D(e.current_model_name)}}function B(e){if(!Array.isArray(e))throw C();return e.map(z)}function V(e){if(Array.isArray(e))return{items:B(e),next_page_id:null};if(!w(e))throw C();return{items:B(e.items),next_page_id:typeof e.next_page_id==`string`?e.next_page_id:null}}var H=new Set([`idle`,`running`,`paused`,`waiting_for_confirmation`,`finished`,`error`,`stuck`]);function U(e){let t=e??`idle`;return H.has(t)?t:`idle`}function W(e,t){if(!e)throw Error(`Conversation ${t} was not found`);return e}var G=class{static async sendMessage(t,n,r){let a=o.getActiveBackend().backend,c=r?.conversationUrl??null,l=r?.sessionApiKey??null;if(a.kind===`cloud`){if(!c||!l){let[e]=await d.batchGetCloudConversations([t]);c=e?.conversation_url?.trim()??null,l=e?.session_api_key?.trim()??null}if(!c||!l)throw Error(`Conversation sandbox is still starting. Wait for it to finish, then try again.`);return await u.callCloudProxy({backend:a,method:`POST`,hostOverride:i.buildHttpBaseUrl(c),path:`/api/conversations/${t}/events`,body:{...n,run:!0},authMode:`session-api-key`,sessionApiKey:l}),n}return await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:c,sessionApiKey:l})).sendEvent(t,n,{run:!0}),n}static async createConversation(t={}){let{initialUserMsg:n,conversationInstructions:r,plugins:i,metadata:u,workingDirOverride:f,workspaceMode:_,parentConversationId:b,agentType:S,sandboxId:C,agentProfileId:w,agentProfileKind:T}=t;if(o.getActiveBackend().backend.kind===`cloud`)return d.createCloudAppConversation({initial_message:n?{role:`user`,content:[{type:`text`,text:n}]}:null,title:r??null,selected_repository:u?.selected_repository??null,selected_branch:u?.selected_branch??null,git_provider:u?.git_provider??null,plugins:i??null,parent_conversation_id:b??null,agent_type:S,sandbox_id:C??null,agent_profile_id:w??null,trigger:`gui`});let[E,D]=await Promise.all([g.default.getSettings(),h.default.listProfiles().catch(()=>void 0)]),O=y.resolveTitleLlmProfile(E.title_llm_profile,D),k=p.default(),A=o.getActiveBackend().backend.host,j=await m.resolveAbsoluteAgentServerPath(f??a.buildConversationWorkingDirForBackend(k,A)),M=f?j:await m.resolveAbsoluteAgentServerPath(a.getWorkspaceRootForBackend(A)),N=_??(f?`local_repo`:`new_worktree`),P=await v.buildStartConversationRequestWithEncryptedSettings({settings:E,query:n,conversationInstructions:r,plugins:i,conversationId:k,parentConversationId:b,workingDir:j,hooksProjectDir:M,worktree:N===`new_worktree`,agentProfileId:w,agentProfileKind:T,titleLlmProfile:O}),F=await c.getTelemetryDistinctId(),I=await new e.ConversationClient(s.getAgentServerClientOptions({timeout:x})).createConversation({...P,...F?{user_id:F}:{}}),L=o.getEffectiveLocalBackend();if(!L)throw new s.NoBackendAvailableError;return(u?.selected_repository||f)&&l.setStoredConversationMetadata(I.id,{selected_repository:u?.selected_repository??null,selected_branch:u?.selected_branch??null,git_provider:u?.git_provider??null,selected_workspace:f??null,workspace_mode:N}),{id:I.id,created_by_user_id:null,status:`READY`,detail:null,app_conversation_id:I.id,agent_server_url:L.host,request:{initial_message:P.initial_message,plugins:i??null},created_at:I.created_at,updated_at:I.updated_at}}static async createLocalPlanningConversation(t,n){if(o.getActiveBackend().backend.kind===`cloud`)throw Error(`Local planning conversations require a local backend.`);let[r]=await this.batchGetAppConversations([t]),i=await v.buildStartPlanningConversationRequestWithEncryptedSettings({workingDir:r?.workspace?.working_dir??a.getAgentServerWorkingDir(),parentConversationId:t,parentActiveProfileName:r?.agent_kind===`openhands`?r?.active_profile??null:null,parentAgentProfileId:r?.launched_agent_profile?.agent_profile_id??null,initialMessage:n}),c=await new e.ConversationClient(s.getAgentServerClientOptions()).createConversation(i);return l.mergeStoredConversationMetadata(t,{local_planning_conversation_id:c.id}),v.toAppConversation(c)}static async getLocalPlanningConversationIds(e){if(o.getActiveBackend().backend.kind===`cloud`)return[];let t=new Set;try{let[n]=await this.batchGetAppConversations([e]),r=n?.sub_conversation_ids??[];if(r.length>0){let n=await this.batchGetAppConversations(r);for(let r of n)r&&_.isPlannerConversationOf(r,e)&&t.add(r.id)}}catch(t){console.warn(`Failed to read sub-conversations of ${e}`,t)}let n=l.getStoredConversationMetadata(e)?.local_planning_conversation_id;return n&&t.add(n),[...t]}static async getStartTask(e){return o.getActiveBackend().backend.kind===`cloud`?d.getCloudAppConversationStartTask(e):null}static async getVSCodeUrl(e,t,n){let i=await this.resolveConversationWorkingDir(e);return{vscode_url:await new r.VSCodeClient(s.getAgentServerClientOptions({conversationUrl:t,sessionApiKey:n})).getUrl({baseUrl:typeof window<`u`?window.location.origin:void 0,workspaceDir:i})}}static async getVSCodeStatus(e,t){return new r.VSCodeClient(s.getAgentServerClientOptions({conversationUrl:e,sessionApiKey:t})).getStatus()}static async resolveConversationWorkingDir(e){let[t]=await this.batchGetAppConversations([e]);return t?.workspace?.working_dir??a.getAgentServerWorkingDir()}static async batchGetAppConversations(t){return t.length===0?[]:o.getActiveBackend().backend.kind===`cloud`?d.batchGetCloudConversations(t):B(await new e.ConversationClient(s.getAgentServerClientOptions()).getConversations(t)).map(e=>v.toAppConversation(e))}static async updateConversationPublicFlag(e,t){if(o.getActiveBackend().backend.kind!==`cloud`)throw Error(`Public sharing requires a cloud backend.`);return d.updateCloudConversationPublicFlag(e,t)}static async updateConversationRepository(e,t,n,r){t?l.setStoredConversationMetadata(e,{...l.getStoredConversationMetadata(e)??{},selected_repository:t,selected_branch:n??null,git_provider:r??null}):l.removeStoredConversationMetadata(e);let[i]=await this.batchGetAppConversations([e]);return W(i,e)}static async readConversationFile(e,n){if(o.getActiveBackend().backend.kind===`cloud`)return d.readCloudConversationFile(e,R(n??`/workspace/project/.agents_tmp/PLAN.md`,`/workspace/project`));let r=await this.resolveConversationWorkingDir(e),i=R(n??`${r}/.agents_tmp/PLAN.md`,r);return new t.FileClient(s.getAgentServerClientOptions()).downloadTextFile(i)}static async downloadConversation(e){return o.getActiveBackend().backend.kind===`cloud`?d.downloadCloudConversation(e):new t.FileClient(s.getAgentServerClientOptions()).downloadTrajectory(e)}static async getHooks(e){return v.emptyHooksResponse()}static async getRuntimeConversation(t,n,r){let i=z(await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:n,sessionApiKey:r})).getConversation(t));return{id:i.id,title:i.title?.trim()?i.title:v.getDefaultConversationTitle(i.id),metrics:A(i.metrics),created_at:i.created_at,updated_at:i.updated_at,status:U(i.execution_status),stats:i.stats??{usage_to_metrics:{}}}}static async condenseConversation(t,n,r){let a=o.getActiveBackend().backend;if(a.kind===`cloud`&&n){await u.callCloudProxy({backend:a,method:`POST`,hostOverride:i.buildHttpBaseUrl(n),path:`/api/conversations/${t}/condense`,authMode:`session-api-key`,sessionApiKey:r});return}await new e.ConversationClient(s.getAgentServerClientOptions({conversationUrl:n,sessionApiKey:r})).condenseConversation(t)}static async searchConversations(t=20,n){return o.getActiveBackend().backend.kind===`cloud`?d.searchCloudConversations(t,n):v.toConversationPage(V(await new e.ConversationClient(s.getAgentServerClientOptions()).searchConversations({limit:t,page_id:n,sort_order:f.ConversationSortOrder.UPDATED_AT_DESC})))}static async deleteConversation(t){if(o.getActiveBackend().backend.kind===`cloud`){await d.deleteCloudConversation(t),l.removeStoredConversationMetadata(t);return}let n=await this.getLocalPlanningConversationIds(t),r=new e.ConversationClient(s.getAgentServerClientOptions());await Promise.all(n.map(async e=>{try{await r.deleteConversation(e)}catch(t){console.warn(`Failed to delete planning conversation ${e}`,t)}l.removeStoredConversationMetadata(e)})),await r.deleteConversation(t),l.removeStoredConversationMetadata(t)}static async updateConversationTitle(t,n){if(o.getActiveBackend().backend.kind===`cloud`)return d.updateCloudConversationTitle(t,n);await new e.ConversationClient(s.getAgentServerClientOptions()).updateConversation(t,{title:n});let[r]=await this.batchGetAppConversations([t]);return W(r,t)}static async updateConversationTags(t,n){await new e.ConversationClient(s.getAgentServerClientOptions()).updateConversation(t,{tags:n});let[r]=await this.batchGetAppConversations([t]);return W(r,t)}static async forkConversation(t,n,r){if(o.getActiveBackend().backend.kind===`cloud`)throw Error(`Branching a conversation isn't supported on the cloud backend yet.`);let i=await new e.ConversationClient(s.getAgentServerClientOptions()).forkConversation(t,{from_event_id:n,...r?{title:r}:{}}),a=l.getStoredConversationMetadata(t);return a&&l.setStoredConversationMetadata(i.id,a),i}static async getEventParentId(t,n){return(await new e.ConversationClient(s.getAgentServerClientOptions()).getEvent(t,n)).parent_id??void 0}static async switchProfile(t,r){let{backend:i}=o.getActiveBackend();if(i.kind===`cloud`){if(!t){await h.default.activateProfile(r);return}await u.callCloudProxy({backend:i,method:`POST`,path:`/api/v1/app-conversations/${t}/switch_profile`,body:{profile_name:r}});return}if(!t){await new n.ProfilesClient(s.getAgentServerClientOptions()).activateProfile(r);return}let a=s.getAgentServerClientOptions(),c=new e.ConversationClient(a),l=await new n.ProfilesClient(a).getProfile(r,{exposeSecrets:`encrypted`}),d=typeof l.config.model==`string`?l.config.model:``;if(!d)throw Error(`Profile '${r}' has no model.`);await v.assertSubscriptionAuthReady({llm:l.config}),await c.switchLLM(t,{...l.config,model:d,stream:!0,usage_id:`profile:${r}:${p.default()}`})}static async switchAcpModel(t,n){let{backend:r}=o.getActiveBackend();if(r.kind===`cloud`){await u.callCloudProxy({backend:r,method:`POST`,path:`/api/v1/app-conversations/${t}/switch_acp_model`,body:{model:n}});return}await new e.ConversationClient(s.getAgentServerClientOptions()).switchAcpModel(t,n)}};exports.default=G;
 //# sourceMappingURL=agent-server-conversation-service.api.cjs.map

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

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

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

@@ -24,6 +24,19 @@ export interface CreateConversationOptions {
 declare class AgentServerConversationService {
     static sendMessage(conversationId: string, message: SendMessageRequest, runtime?: ConversationRuntimeContext | null): Promise<SendMessageResponse>;
     static createConversation(options?: CreateConversationOptions): Promise<AppConversationStartTask>;
+    static createLocalPlanningConversation(parentConversationId: string, initialMessage?: string): Promise<AppConversation>;
+    /**
+     * Ids of the conversations owned by `parentConversationId` on a local
+     * backend — today that means its planner helper, the only child Canvas
+     * creates locally.
+     *
+     * `sub_conversation_ids` is the generic server-derived child list, so each
+     * child is kept only if it's tagged `plannerparent` for this parent —
+     * otherwise deleting the parent would also delete an unrelated non-planner
+     * child (e.g. a delegated sub-agent). The stored metadata hint is merged in
+     * for agent-servers older than 1.37.1, which report no children at all.
+     */
+    static getLocalPlanningConversationIds(parentConversationId: string): Promise<string[]>;
     static getStartTask(taskId: string): Promise<AppConversationStartTask | null>;
     static getVSCodeUrl(conversationId: string, conversationUrl: string | null | undefined, sessionApiKey?: string | null): Promise<GetVSCodeUrlResponse>;
     /**
@@ -54,6 +67,13 @@ declare class AgentServerConversationService {
     static searchConversations(limit?: number, pageId?: string): Promise<AppConversationPage>;
     static deleteConversation(conversationId: string): Promise<void>;
     static updateConversationTitle(conversationId: string, title: string): Promise<AppConversation>;
+    /**
+     * Replaces the conversation's complete server-side tag map (the PATCH is
+     * replace-all, so callers must merge user edits with any reserved/internal
+     * keys before calling). Mirrors `updateConversationTitle`; local
+     * agent-server conversations only — Cloud conversations don't carry tags.
+     */
+    static updateConversationTags(conversationId: string, tags: Record<string, string>): Promise<AppConversation>;
     /**
      * Forks a conversation, copying event history up to and including
      * `fromEventId`. Local agent-server only; needs agent-server >= 1.31.0 for