@openhands/agent-canvas 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/api/backend-registry/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","names":[],"sources":["../../../src/api/backend-registry/auth.ts"],"sourcesContent":["import { getAgentServerSessionApiKey } from \"../agent-server-config\";\nimport { DEFAULT_LOCAL_BACKEND_ID } from \"./default-backend\";\nimport type { Backend } from \"./types\";\n\n/**\n * Build the auth headers to send to a backend.\n *\n * Local agent-server uses `X-Session-API-Key`. Cloud expects a bearer\n * token in the `Authorization` header.\n */\nexport function buildAuthHeaders(backend: Backend): Record<string, string> {\n  if (backend.kind === \"local\" && backend.id === DEFAULT_LOCAL_BACKEND_ID) {\n    const configuredSessionApiKey = getAgentServerSessionApiKey();\n    if (configuredSessionApiKey) {\n      return { \"X-Session-API-Key\": configuredSessionApiKey };\n    }\n  }\n\n  if (!backend.apiKey) return {};\n\n  if (backend.kind === \"cloud\") {\n    return { Authorization: `Bearer ${backend.apiKey}` };\n  }\n\n  return { \"X-Session-API-Key\": backend.apiKey };\n}\n"],"mappings":";;;AAUA,SAAgB,EAAiB,GAA0C;AACzE,KAAI,EAAQ,SAAS,WAAW,EAAQ,OAAA,iBAAiC;EACvE,IAAM,IAA0B,GAA6B;AAC7D,MAAI,EACF,QAAO,EAAE,qBAAqB,GAAyB;;AAU3D,QANK,EAAQ,SAET,EAAQ,SAAS,UACZ,EAAE,eAAe,UAAU,EAAQ,UAAU,GAG/C,EAAE,qBAAqB,EAAQ,QAAQ,GANlB,EAAE"}
+{"version":3,"file":"auth.js","names":[],"sources":["../../../src/api/backend-registry/auth.ts"],"sourcesContent":["import type { Backend } from \"./types\";\n\n/**\n * Build the auth headers to send to a backend.\n *\n * Local agent-server uses `X-Session-API-Key`. Cloud expects a bearer\n * token in the `Authorization` header.\n */\nexport function buildAuthHeaders(backend: Backend): Record<string, string> {\n  if (!backend.apiKey) return {};\n\n  if (backend.kind === \"cloud\") {\n    return { Authorization: `Bearer ${backend.apiKey}` };\n  }\n\n  return { \"X-Session-API-Key\": backend.apiKey };\n}\n"],"mappings":";AAQA,SAAgB,EAAiB,GAA0C;AAOzE,QANK,EAAQ,SAET,EAAQ,SAAS,UACZ,EAAE,eAAe,UAAU,EAAQ,UAAU,GAG/C,EAAE,qBAAqB,EAAQ,QAAQ,GANlB,EAAE"}

package/dist/api/backend-registry/default-backend.cjs

@@ -1,2 +1,2 @@
-require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../agent-server-config.cjs`);var t=`default-local`,n=`Local`;function r(){return{id:t,name:n,host:e.getAgentServerBaseUrl(),apiKey:e.getAgentServerSessionApiKey()??``,kind:`local`}}exports.DEFAULT_LOCAL_BACKEND_ID=t,exports.makeDefaultLocalBackend=r;
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../agent-server-config.cjs`);var t=`default-local`,n=`Local`;function r(){let r=e.getAgentServerBaseUrl(),i=e.getAgentServerSessionApiKey();return!r||!i?null:{id:t,name:n,host:r,apiKey:i,kind:`local`}}exports.DEFAULT_LOCAL_BACKEND_ID=t,exports.DEFAULT_LOCAL_BACKEND_NAME=n,exports.makeDefaultLocalBackend=r;
 //# sourceMappingURL=default-backend.cjs.map

package/dist/api/backend-registry/default-backend.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"default-backend.cjs","names":[],"sources":["../../../src/api/backend-registry/default-backend.ts"],"sourcesContent":["import {\n  getAgentServerBaseUrl,\n  getAgentServerSessionApiKey,\n} from \"../agent-server-config\";\nimport type { Backend } from \"./types\";\n\n/**\n * Stable id for the default local backend that is auto-seeded into the\n * registry on a fresh install. After seeding, this backend is a normal\n * registered entry — the user can rename it, edit its host/api key, or\n * remove it like any other backend.\n *\n * The id is also used by `saveAgentServerConfig` to keep the registry\n * entry in sync with the legacy `openhands-agent-server-config` storage\n * that the recovery / agent-server settings page edits.\n */\nexport const DEFAULT_LOCAL_BACKEND_ID = \"default-local\";\n\nexport const DEFAULT_LOCAL_BACKEND_NAME = \"Local\";\n\n/**\n * Construct the default local backend from environment / agent-server\n * config (`VITE_BACKEND_BASE_URL`, `VITE_SESSION_API_KEY`, plus the\n * `openhands-agent-server-config` localStorage overrides).\n *\n * Used in two places:\n *   1. As the seed entry written to `openhands-backends` on first load.\n *   2. As a last-resort fallback inside the active store when the\n *      registry has no local backend at all (e.g. the user removed\n *      every entry). The synthetic fallback is never persisted.\n */\nexport function makeDefaultLocalBackend(): Backend {\n  return {\n    id: DEFAULT_LOCAL_BACKEND_ID,\n    name: DEFAULT_LOCAL_BACKEND_NAME,\n    host: getAgentServerBaseUrl(),\n    apiKey: getAgentServerSessionApiKey() ?? \"\",\n    kind: \"local\",\n  };\n}\n"],"mappings":"8FAgBA,IAAa,EAA2B,gBAE3B,EAA6B,QAa1C,SAAgB,GAAmC,CACjD,MAAO,CACL,GAAI,EACJ,KAAM,EACN,KAAM,EAAA,uBAAuB,CAC7B,OAAQ,EAAA,6BAA6B,EAAI,GACzC,KAAM,QACP"}
+{"version":3,"file":"default-backend.cjs","names":[],"sources":["../../../src/api/backend-registry/default-backend.ts"],"sourcesContent":["import {\n  getAgentServerBaseUrl,\n  getAgentServerSessionApiKey,\n} from \"../agent-server-config\";\nimport type { Backend } from \"./types\";\n\n/**\n * Stable id for the default local backend that is auto-seeded into the\n * registry when the launcher provides both a backend host and API key.\n * After seeding, this backend is a normal registered entry — the user can\n * rename it, edit its host/api key, or remove it like any other backend.\n */\nexport const DEFAULT_LOCAL_BACKEND_ID = \"default-local\";\n\nexport const DEFAULT_LOCAL_BACKEND_NAME = \"Local\";\n\n/**\n * Construct the default local backend from environment/runtime config.\n * Returns null unless both a backend location and API key are available.\n *\n * Used as the seed entry written to `openhands-backends` on first load;\n * if it returns null, onboarding is responsible for collecting backend\n * connection details from the user.\n */\nexport function makeDefaultLocalBackend(): Backend | null {\n  const host = getAgentServerBaseUrl();\n  const apiKey = getAgentServerSessionApiKey();\n\n  if (!host || !apiKey) return null;\n\n  return {\n    id: DEFAULT_LOCAL_BACKEND_ID,\n    name: DEFAULT_LOCAL_BACKEND_NAME,\n    host,\n    apiKey,\n    kind: \"local\",\n  };\n}\n"],"mappings":"8FAYA,IAAa,EAA2B,gBAE3B,EAA6B,QAU1C,SAAgB,GAA0C,CACxD,IAAM,EAAO,EAAA,uBAAuB,CAC9B,EAAS,EAAA,6BAA6B,CAI5C,MAFI,CAAC,GAAQ,CAAC,EAAe,KAEtB,CACL,GAAI,EACJ,KAAM,EACN,OACA,SACA,KAAM,QACP"}

package/dist/api/backend-registry/default-backend.d.ts

@@ -1,25 +1,18 @@
 import type { Backend } from "./types";
 /**
  * Stable id for the default local backend that is auto-seeded into the
- * registry on a fresh install. After seeding, this backend is a normal
- * registered entry — the user can rename it, edit its host/api key, or
- * remove it like any other backend.
- *
- * The id is also used by `saveAgentServerConfig` to keep the registry
- * entry in sync with the legacy `openhands-agent-server-config` storage
- * that the recovery / agent-server settings page edits.
+ * registry when the launcher provides both a backend host and API key.
+ * After seeding, this backend is a normal registered entry — the user can
+ * rename it, edit its host/api key, or remove it like any other backend.
  */
 export declare const DEFAULT_LOCAL_BACKEND_ID = "default-local";
 export declare const DEFAULT_LOCAL_BACKEND_NAME = "Local";
 /**
- * Construct the default local backend from environment / agent-server
- * config (`VITE_BACKEND_BASE_URL`, `VITE_SESSION_API_KEY`, plus the
- * `openhands-agent-server-config` localStorage overrides).
+ * Construct the default local backend from environment/runtime config.
+ * Returns null unless both a backend location and API key are available.
  *
- * Used in two places:
- *   1. As the seed entry written to `openhands-backends` on first load.
- *   2. As a last-resort fallback inside the active store when the
- *      registry has no local backend at all (e.g. the user removed
- *      every entry). The synthetic fallback is never persisted.
+ * Used as the seed entry written to `openhands-backends` on first load;
+ * if it returns null, onboarding is responsible for collecting backend
+ * connection details from the user.
  */
-export declare function makeDefaultLocalBackend(): Backend;
+export declare function makeDefaultLocalBackend(): Backend | null;

package/dist/api/backend-registry/default-backend.js

@@ -2,15 +2,16 @@ import { getAgentServerBaseUrl as e, getAgentServerSessionApiKey as t } from "..
 //#region src/api/backend-registry/default-backend.ts
 var n = "default-local", r = "Local";
 function i() {
-	return {
+	let i = e(), a = t();
+	return !i || !a ? null : {
 		id: n,
 		name: r,
-		host: e(),
-		apiKey: t() ?? "",
+		host: i,
+		apiKey: a,
 		kind: "local"
 	};
 }
 //#endregion
-export { n as DEFAULT_LOCAL_BACKEND_ID, i as makeDefaultLocalBackend };
+export { n as DEFAULT_LOCAL_BACKEND_ID, r as DEFAULT_LOCAL_BACKEND_NAME, i as makeDefaultLocalBackend };
 
 //# sourceMappingURL=default-backend.js.map

package/dist/api/backend-registry/default-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-backend.js","names":[],"sources":["../../../src/api/backend-registry/default-backend.ts"],"sourcesContent":["import {\n  getAgentServerBaseUrl,\n  getAgentServerSessionApiKey,\n} from \"../agent-server-config\";\nimport type { Backend } from \"./types\";\n\n/**\n * Stable id for the default local backend that is auto-seeded into the\n * registry on a fresh install. After seeding, this backend is a normal\n * registered entry — the user can rename it, edit its host/api key, or\n * remove it like any other backend.\n *\n * The id is also used by `saveAgentServerConfig` to keep the registry\n * entry in sync with the legacy `openhands-agent-server-config` storage\n * that the recovery / agent-server settings page edits.\n */\nexport const DEFAULT_LOCAL_BACKEND_ID = \"default-local\";\n\nexport const DEFAULT_LOCAL_BACKEND_NAME = \"Local\";\n\n/**\n * Construct the default local backend from environment / agent-server\n * config (`VITE_BACKEND_BASE_URL`, `VITE_SESSION_API_KEY`, plus the\n * `openhands-agent-server-config` localStorage overrides).\n *\n * Used in two places:\n *   1. As the seed entry written to `openhands-backends` on first load.\n *   2. As a last-resort fallback inside the active store when the\n *      registry has no local backend at all (e.g. the user removed\n *      every entry). The synthetic fallback is never persisted.\n */\nexport function makeDefaultLocalBackend(): Backend {\n  return {\n    id: DEFAULT_LOCAL_BACKEND_ID,\n    name: DEFAULT_LOCAL_BACKEND_NAME,\n    host: getAgentServerBaseUrl(),\n    apiKey: getAgentServerSessionApiKey() ?? \"\",\n    kind: \"local\",\n  };\n}\n"],"mappings":";;AAgBA,IAAa,IAA2B,iBAE3B,IAA6B;AAa1C,SAAgB,IAAmC;AACjD,QAAO;EACL,IAAI;EACJ,MAAM;EACN,MAAM,GAAuB;EAC7B,QAAQ,GAA6B,IAAI;EACzC,MAAM;EACP"}
+{"version":3,"file":"default-backend.js","names":[],"sources":["../../../src/api/backend-registry/default-backend.ts"],"sourcesContent":["import {\n  getAgentServerBaseUrl,\n  getAgentServerSessionApiKey,\n} from \"../agent-server-config\";\nimport type { Backend } from \"./types\";\n\n/**\n * Stable id for the default local backend that is auto-seeded into the\n * registry when the launcher provides both a backend host and API key.\n * After seeding, this backend is a normal registered entry — the user can\n * rename it, edit its host/api key, or remove it like any other backend.\n */\nexport const DEFAULT_LOCAL_BACKEND_ID = \"default-local\";\n\nexport const DEFAULT_LOCAL_BACKEND_NAME = \"Local\";\n\n/**\n * Construct the default local backend from environment/runtime config.\n * Returns null unless both a backend location and API key are available.\n *\n * Used as the seed entry written to `openhands-backends` on first load;\n * if it returns null, onboarding is responsible for collecting backend\n * connection details from the user.\n */\nexport function makeDefaultLocalBackend(): Backend | null {\n  const host = getAgentServerBaseUrl();\n  const apiKey = getAgentServerSessionApiKey();\n\n  if (!host || !apiKey) return null;\n\n  return {\n    id: DEFAULT_LOCAL_BACKEND_ID,\n    name: DEFAULT_LOCAL_BACKEND_NAME,\n    host,\n    apiKey,\n    kind: \"local\",\n  };\n}\n"],"mappings":";;AAYA,IAAa,IAA2B,iBAE3B,IAA6B;AAU1C,SAAgB,IAA0C;CACxD,IAAM,IAAO,GAAuB,EAC9B,IAAS,GAA6B;AAI5C,QAFI,CAAC,KAAQ,CAAC,IAAe,OAEtB;EACL,IAAI;EACJ,MAAM;EACN;EACA;EACA,MAAM;EACP"}

package/dist/api/backend-registry/storage.cjs

@@ -1,2 +1,2 @@
-require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../agent-server-config.cjs`),t=require(`./default-backend.cjs`);var n=`openhands-backends`,r=`openhands-active-backend`;function i(e){return e===`local`||e===`cloud`}function a(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.id==`string`&&t.id.length>0&&typeof t.name==`string`&&typeof t.host==`string`&&typeof t.apiKey==`string`&&i(t.kind)}function o(e){try{return new URL(e).origin}catch{return e.replace(/\/+$/,``)}}function s(e){let n=t.makeDefaultLocalBackend();return e.id!==n.id||e.kind!==`local`||!n.apiKey||o(e.host)!==o(n.host)||e.apiKey===n.apiKey?e:{...e,apiKey:n.apiKey}}function c(e){if(!(typeof window>`u`))try{window.localStorage.setItem(n,JSON.stringify(e))}catch{}}function l(){if(typeof window>`u`)return[];e.syncBakedSessionApiKey();try{let e=window.localStorage.getItem(n);if(e===null){let e=[t.makeDefaultLocalBackend()];return c(e),e}let r=JSON.parse(e);if(!Array.isArray(r))return[];let i=r.filter(a);if(i.length===0){let e=[t.makeDefaultLocalBackend()];return c(e),e}let o=i.map(s);return o.some((e,t)=>e!==i[t])&&c(o),o}catch{return[]}}function u(){if(typeof window>`u`)return null;try{let e=window.localStorage.getItem(r);if(!e)return null;let t=JSON.parse(e);if(typeof t!=`object`||!t||typeof t.backendId!=`string`)return null;let n=t.orgId;return{backendId:t.backendId,orgId:typeof n==`string`&&n.length>0?n:null}}catch{return null}}function d(e){if(!(typeof window>`u`))try{if(!e){window.localStorage.removeItem(r);return}window.localStorage.setItem(r,JSON.stringify({backendId:e.backendId,orgId:e.orgId??null}))}catch{}}exports.readStoredActiveBackend=u,exports.readStoredBackends=l,exports.writeStoredActiveBackend=d,exports.writeStoredBackends=c;
+require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`./default-backend.cjs`);var t=`openhands-backends`,n=`openhands-active-backend`,r=`openhands-agent-server-config`;function i(e){return e===`local`||e===`cloud`}function a(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.id==`string`&&t.id.length>0&&typeof t.name==`string`&&typeof t.host==`string`&&typeof t.apiKey==`string`&&i(t.kind)}function o(e){if(typeof e!=`string`)return null;let t=e.trim().replace(/\/+$/,``);return t?/^https?:\/\//i.test(t)?t:`http://${t}`:null}function s(){let t=window.localStorage.getItem(r);if(!t)return null;try{let n=JSON.parse(t),r=o(n.baseUrl),i=typeof n.sessionApiKey==`string`?n.sessionApiKey.trim():``;return!r||!i?null:{id:e.DEFAULT_LOCAL_BACKEND_ID,name:e.DEFAULT_LOCAL_BACKEND_NAME,host:r,apiKey:i,kind:`local`}}catch{return null}}function c(){window.localStorage.removeItem(r)}function l(e){return p(e),c(),e}function u(e){try{let{hostname:t}=new URL(e);return t===`localhost`||t===`127.0.0.1`||t===`::1`||t===`[::1]`}catch{return!1}}function d(e,t){return e.id!==`default-local`||e.kind!==`local`?!1:e.host===t.host||u(e.host)&&u(t.host)}function f(t){let n=e.makeDefaultLocalBackend();if(!n)return t;let r=!1,i=t.map(e=>!d(e,n)||e.apiKey===n.apiKey?e:(r=!0,{...e,apiKey:n.apiKey}));return r?(p(i),i):t}function p(e){if(!(typeof window>`u`))try{window.localStorage.setItem(t,JSON.stringify(e))}catch{}}function m(){if(typeof window>`u`)return[];try{let n=window.localStorage.getItem(t);if(n===null){let t=s();if(t)return l([t]);let n=e.makeDefaultLocalBackend();return n?l([n]):[]}let r=JSON.parse(n);if(!Array.isArray(r))return[];let i=r.filter(a);if(i.length===0){let t=e.makeDefaultLocalBackend();return t?l([t]):[]}let o=f(i);return c(),o}catch{return[]}}function h(){if(typeof window>`u`)return null;try{let e=window.localStorage.getItem(n);if(!e)return null;let t=JSON.parse(e);if(typeof t!=`object`||!t||typeof t.backendId!=`string`)return null;let r=t.orgId;return{backendId:t.backendId,orgId:typeof r==`string`&&r.length>0?r:null}}catch{return null}}function g(e){if(!(typeof window>`u`))try{if(!e){window.localStorage.removeItem(n);return}window.localStorage.setItem(n,JSON.stringify({backendId:e.backendId,orgId:e.orgId??null}))}catch{}}exports.readStoredActiveBackend=h,exports.readStoredBackends=m,exports.writeStoredActiveBackend=g,exports.writeStoredBackends=p;
 //# sourceMappingURL=storage.cjs.map

package/dist/api/backend-registry/storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.cjs","names":[],"sources":["../../../src/api/backend-registry/storage.ts"],"sourcesContent":["import { syncBakedSessionApiKey } from \"../agent-server-config\";\nimport { makeDefaultLocalBackend } from \"./default-backend\";\nimport type { Backend, BackendKind, BackendSelection } from \"./types\";\n\nexport const BACKENDS_STORAGE_KEY = \"openhands-backends\";\nexport const ACTIVE_BACKEND_STORAGE_KEY = \"openhands-active-backend\";\n\nfunction isValidKind(value: unknown): value is BackendKind {\n  return value === \"local\" || value === \"cloud\";\n}\n\nfunction isValidBackend(value: unknown): value is Backend {\n  if (typeof value !== \"object\" || value === null) return false;\n  const v = value as Partial<Backend>;\n  return (\n    typeof v.id === \"string\" &&\n    v.id.length > 0 &&\n    typeof v.name === \"string\" &&\n    typeof v.host === \"string\" &&\n    typeof v.apiKey === \"string\" &&\n    isValidKind(v.kind)\n  );\n}\n\nfunction normalizeHostForComparison(host: string): string {\n  try {\n    return new URL(host).origin;\n  } catch {\n    return host.replace(/\\/+$/, \"\");\n  }\n}\n\nfunction syncDefaultLocalBackendAuth(backend: Backend): Backend {\n  const defaultBackend = makeDefaultLocalBackend();\n\n  if (\n    backend.id !== defaultBackend.id ||\n    backend.kind !== \"local\" ||\n    !defaultBackend.apiKey ||\n    normalizeHostForComparison(backend.host) !==\n      normalizeHostForComparison(defaultBackend.host)\n  ) {\n    return backend;\n  }\n\n  if (backend.apiKey === defaultBackend.apiKey) {\n    return backend;\n  }\n\n  return {\n    ...backend,\n    apiKey: defaultBackend.apiKey,\n  };\n}\n\nexport function writeStoredBackends(backends: Backend[]): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(BACKENDS_STORAGE_KEY, JSON.stringify(backends));\n  } catch {\n    /* ignore quota / serialization errors */\n  }\n}\n\nexport function readStoredBackends(): Backend[] {\n  if (typeof window === \"undefined\") return [];\n\n  // Ensure the baked-in session API key (VITE_SESSION_API_KEY) is synced\n  // into the legacy `openhands-agent-server-config` localStorage entry\n  // BEFORE we read the backend registry.  This matters when the user\n  // restarts the stack with a different LOCAL_BACKEND_API_KEY — without\n  // this call the stale key in `openhands-agent-server-config` shadows\n  // the new baked key, making `makeDefaultLocalBackend()` (and the\n  // downstream `syncDefaultLocalBackendAuth`) read the wrong value.\n  syncBakedSessionApiKey();\n\n  try {\n    const raw = window.localStorage.getItem(BACKENDS_STORAGE_KEY);\n\n    // First install: the storage key has never been written. Seed the\n    // registry with one default local backend derived from the env /\n    // agent-server-config so the user has something to talk to out of\n    // the box.\n    if (raw === null) {\n      const seeded = [makeDefaultLocalBackend()];\n      writeStoredBackends(seeded);\n      return seeded;\n    }\n\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) return [];\n    const valid = parsed.filter(isValidBackend);\n\n    // If the stored array is empty (or everything in it failed validation),\n    // re-seed with the default Local backend so the user always has a\n    // working entry pointing at VITE_SESSION_API_KEY. With the dev scripts\n    // persisting that key to ~/.openhands/agent-canvas/session-api-key.txt,\n    // re-seeding is safe — the seeded entry will keep working across\n    // restarts instead of going stale.\n    if (valid.length === 0) {\n      const seeded = [makeDefaultLocalBackend()];\n      writeStoredBackends(seeded);\n      return seeded;\n    }\n\n    const synced = valid.map(syncDefaultLocalBackendAuth);\n    if (synced.some((backend, index) => backend !== valid[index])) {\n      writeStoredBackends(synced);\n    }\n\n    return synced;\n  } catch {\n    return [];\n  }\n}\n\nexport function readStoredActiveBackend(): BackendSelection | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    const raw = window.localStorage.getItem(ACTIVE_BACKEND_STORAGE_KEY);\n    if (!raw) return null;\n    const parsed = JSON.parse(raw);\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      typeof (parsed as BackendSelection).backendId !== \"string\"\n    ) {\n      return null;\n    }\n    const orgIdRaw = (parsed as BackendSelection).orgId;\n    return {\n      backendId: (parsed as BackendSelection).backendId,\n      orgId:\n        typeof orgIdRaw === \"string\" && orgIdRaw.length > 0 ? orgIdRaw : null,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function writeStoredActiveBackend(\n  selection: BackendSelection | null,\n): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (!selection) {\n      window.localStorage.removeItem(ACTIVE_BACKEND_STORAGE_KEY);\n      return;\n    }\n    window.localStorage.setItem(\n      ACTIVE_BACKEND_STORAGE_KEY,\n      JSON.stringify({\n        backendId: selection.backendId,\n        orgId: selection.orgId ?? null,\n      }),\n    );\n  } catch {\n    /* ignore */\n  }\n}\n"],"mappings":"iIAIA,IAAa,EAAuB,qBACvB,EAA6B,2BAE1C,SAAS,EAAY,EAAsC,CACzD,OAAO,IAAU,SAAW,IAAU,QAGxC,SAAS,EAAe,EAAkC,CACxD,GAAI,OAAO,GAAU,WAAY,EAAgB,MAAO,GACxD,IAAM,EAAI,EACV,OACE,OAAO,EAAE,IAAO,UAChB,EAAE,GAAG,OAAS,GACd,OAAO,EAAE,MAAS,UAClB,OAAO,EAAE,MAAS,UAClB,OAAO,EAAE,QAAW,UACpB,EAAY,EAAE,KAAK,CAIvB,SAAS,EAA2B,EAAsB,CACxD,GAAI,CACF,OAAO,IAAI,IAAI,EAAK,CAAC,YACf,CACN,OAAO,EAAK,QAAQ,OAAQ,GAAG,EAInC,SAAS,EAA4B,EAA2B,CAC9D,IAAM,EAAiB,EAAA,yBAAyB,CAgBhD,OAbE,EAAQ,KAAO,EAAe,IAC9B,EAAQ,OAAS,SACjB,CAAC,EAAe,QAChB,EAA2B,EAAQ,KAAK,GACtC,EAA2B,EAAe,KAAK,EAK/C,EAAQ,SAAW,EAAe,OAC7B,EAGF,CACL,GAAG,EACH,OAAQ,EAAe,OACxB,CAGH,SAAgB,EAAoB,EAA2B,CACzD,YAAO,OAAW,KACtB,GAAI,CACF,OAAO,aAAa,QAAQ,EAAsB,KAAK,UAAU,EAAS,CAAC,MACrE,GAKV,SAAgB,GAAgC,CAC9C,GAAI,OAAO,OAAW,IAAa,MAAO,EAAE,CAS5C,EAAA,wBAAwB,CAExB,GAAI,CACF,IAAM,EAAM,OAAO,aAAa,QAAQ,EAAqB,CAM7D,GAAI,IAAQ,KAAM,CAChB,IAAM,EAAS,CAAC,EAAA,yBAAyB,CAAC,CAE1C,OADA,EAAoB,EAAO,CACpB,EAGT,IAAM,EAAS,KAAK,MAAM,EAAI,CAC9B,GAAI,CAAC,MAAM,QAAQ,EAAO,CAAE,MAAO,EAAE,CACrC,IAAM,EAAQ,EAAO,OAAO,EAAe,CAQ3C,GAAI,EAAM,SAAW,EAAG,CACtB,IAAM,EAAS,CAAC,EAAA,yBAAyB,CAAC,CAE1C,OADA,EAAoB,EAAO,CACpB,EAGT,IAAM,EAAS,EAAM,IAAI,EAA4B,CAKrD,OAJI,EAAO,MAAM,EAAS,IAAU,IAAY,EAAM,GAAO,EAC3D,EAAoB,EAAO,CAGtB,OACD,CACN,MAAO,EAAE,EAIb,SAAgB,GAAmD,CACjE,GAAI,OAAO,OAAW,IAAa,OAAO,KAC1C,GAAI,CACF,IAAM,EAAM,OAAO,aAAa,QAAQ,EAA2B,CACnE,GAAI,CAAC,EAAK,OAAO,KACjB,IAAM,EAAS,KAAK,MAAM,EAAI,CAC9B,GACE,OAAO,GAAW,WAClB,GACA,OAAQ,EAA4B,WAAc,SAElD,OAAO,KAET,IAAM,EAAY,EAA4B,MAC9C,MAAO,CACL,UAAY,EAA4B,UACxC,MACE,OAAO,GAAa,UAAY,EAAS,OAAS,EAAI,EAAW,KACpE,MACK,CACN,OAAO,MAIX,SAAgB,EACd,EACM,CACF,YAAO,OAAW,KACtB,GAAI,CACF,GAAI,CAAC,EAAW,CACd,OAAO,aAAa,WAAW,EAA2B,CAC1D,OAEF,OAAO,aAAa,QAClB,EACA,KAAK,UAAU,CACb,UAAW,EAAU,UACrB,MAAO,EAAU,OAAS,KAC3B,CAAC,CACH,MACK"}
+{"version":3,"file":"storage.cjs","names":[],"sources":["../../../src/api/backend-registry/storage.ts"],"sourcesContent":["import {\n  DEFAULT_LOCAL_BACKEND_ID,\n  DEFAULT_LOCAL_BACKEND_NAME,\n  makeDefaultLocalBackend,\n} from \"./default-backend\";\nimport type { Backend, BackendKind, BackendSelection } from \"./types\";\n\nexport const BACKENDS_STORAGE_KEY = \"openhands-backends\";\nexport const ACTIVE_BACKEND_STORAGE_KEY = \"openhands-active-backend\";\n\nconst LEGACY_AGENT_SERVER_CONFIG_STORAGE_KEY = \"openhands-agent-server-config\";\n\nfunction isValidKind(value: unknown): value is BackendKind {\n  return value === \"local\" || value === \"cloud\";\n}\n\nfunction isValidBackend(value: unknown): value is Backend {\n  if (typeof value !== \"object\" || value === null) return false;\n  const v = value as Partial<Backend>;\n  return (\n    typeof v.id === \"string\" &&\n    v.id.length > 0 &&\n    typeof v.name === \"string\" &&\n    typeof v.host === \"string\" &&\n    typeof v.apiKey === \"string\" &&\n    isValidKind(v.kind)\n  );\n}\n\nfunction normalizeLegacyBaseUrl(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim().replace(/\\/+$/, \"\");\n  if (!trimmed) return null;\n  if (/^https?:\\/\\//i.test(trimmed)) return trimmed;\n  return `http://${trimmed}`;\n}\n\nfunction readLegacyBackend(): Backend | null {\n  const raw = window.localStorage.getItem(\n    LEGACY_AGENT_SERVER_CONFIG_STORAGE_KEY,\n  );\n  if (!raw) return null;\n\n  try {\n    const parsed = JSON.parse(raw) as Record<string, unknown>;\n    const host = normalizeLegacyBaseUrl(parsed.baseUrl);\n    const apiKey =\n      typeof parsed.sessionApiKey === \"string\"\n        ? parsed.sessionApiKey.trim()\n        : \"\";\n\n    if (!host || !apiKey) return null;\n\n    return {\n      id: DEFAULT_LOCAL_BACKEND_ID,\n      name: DEFAULT_LOCAL_BACKEND_NAME,\n      host,\n      apiKey,\n      kind: \"local\",\n    };\n  } catch {\n    return null;\n  }\n}\n\nfunction clearLegacyBackendConfig(): void {\n  window.localStorage.removeItem(LEGACY_AGENT_SERVER_CONFIG_STORAGE_KEY);\n}\n\nfunction seedBackends(backends: Backend[]): Backend[] {\n  writeStoredBackends(backends);\n  clearLegacyBackendConfig();\n  return backends;\n}\n\nfunction isLoopbackUrl(value: string): boolean {\n  try {\n    const { hostname } = new URL(value);\n    return (\n      hostname === \"localhost\" ||\n      hostname === \"127.0.0.1\" ||\n      hostname === \"::1\" ||\n      hostname === \"[::1]\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nfunction shouldSyncLauncherDefaultLocalBackend(\n  backend: Backend,\n  defaultBackend: Backend,\n): boolean {\n  if (backend.id !== DEFAULT_LOCAL_BACKEND_ID || backend.kind !== \"local\") {\n    return false;\n  }\n\n  return (\n    backend.host === defaultBackend.host ||\n    (isLoopbackUrl(backend.host) && isLoopbackUrl(defaultBackend.host))\n  );\n}\n\nfunction syncLauncherDefaultLocalBackend(backends: Backend[]): Backend[] {\n  const defaultBackend = makeDefaultLocalBackend();\n  if (!defaultBackend) return backends;\n\n  let didSync = false;\n  const syncedBackends = backends.map((backend) => {\n    if (!shouldSyncLauncherDefaultLocalBackend(backend, defaultBackend)) {\n      return backend;\n    }\n\n    if (backend.apiKey === defaultBackend.apiKey) return backend;\n\n    didSync = true;\n    return {\n      ...backend,\n      apiKey: defaultBackend.apiKey,\n    };\n  });\n\n  if (!didSync) return backends;\n\n  writeStoredBackends(syncedBackends);\n  return syncedBackends;\n}\n\nexport function writeStoredBackends(backends: Backend[]): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(BACKENDS_STORAGE_KEY, JSON.stringify(backends));\n  } catch {\n    /* ignore quota / serialization errors */\n  }\n}\n\nexport function readStoredBackends(): Backend[] {\n  if (typeof window === \"undefined\") return [];\n\n  try {\n    const raw = window.localStorage.getItem(BACKENDS_STORAGE_KEY);\n\n    // First install: migrate one legacy local backend if present, otherwise\n    // seed only when the launcher supplied enough information for a usable\n    // local backend.\n    if (raw === null) {\n      const legacyBackend = readLegacyBackend();\n      if (legacyBackend) return seedBackends([legacyBackend]);\n\n      const defaultBackend = makeDefaultLocalBackend();\n      if (!defaultBackend) return [];\n\n      return seedBackends([defaultBackend]);\n    }\n\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) return [];\n    const valid = parsed.filter(isValidBackend);\n\n    // If the stored array is empty (or everything in it failed validation),\n    // only re-seed when the launcher supplied both a host and API key.\n    if (valid.length === 0) {\n      const defaultBackend = makeDefaultLocalBackend();\n      if (!defaultBackend) return [];\n\n      return seedBackends([defaultBackend]);\n    }\n\n    const synced = syncLauncherDefaultLocalBackend(valid);\n    clearLegacyBackendConfig();\n    return synced;\n  } catch {\n    return [];\n  }\n}\n\nexport function readStoredActiveBackend(): BackendSelection | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    const raw = window.localStorage.getItem(ACTIVE_BACKEND_STORAGE_KEY);\n    if (!raw) return null;\n    const parsed = JSON.parse(raw);\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      typeof (parsed as BackendSelection).backendId !== \"string\"\n    ) {\n      return null;\n    }\n    const orgIdRaw = (parsed as BackendSelection).orgId;\n    return {\n      backendId: (parsed as BackendSelection).backendId,\n      orgId:\n        typeof orgIdRaw === \"string\" && orgIdRaw.length > 0 ? orgIdRaw : null,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function writeStoredActiveBackend(\n  selection: BackendSelection | null,\n): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (!selection) {\n      window.localStorage.removeItem(ACTIVE_BACKEND_STORAGE_KEY);\n      return;\n    }\n    window.localStorage.setItem(\n      ACTIVE_BACKEND_STORAGE_KEY,\n      JSON.stringify({\n        backendId: selection.backendId,\n        orgId: selection.orgId ?? null,\n      }),\n    );\n  } catch {\n    /* ignore */\n  }\n}\n"],"mappings":"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"}

package/dist/api/backend-registry/storage.js

@@ -1,60 +1,93 @@
-import { syncBakedSessionApiKey as e } from "../agent-server-config.js";
-import { makeDefaultLocalBackend as t } from "./default-backend.js";
+import { DEFAULT_LOCAL_BACKEND_ID as e, DEFAULT_LOCAL_BACKEND_NAME as t, makeDefaultLocalBackend as n } from "./default-backend.js";
 //#region src/api/backend-registry/storage.ts
-var n = "openhands-backends", r = "openhands-active-backend";
-function i(e) {
+var r = "openhands-backends", i = "openhands-active-backend", a = "openhands-agent-server-config";
+function o(e) {
 	return e === "local" || e === "cloud";
 }
-function a(e) {
+function s(e) {
 	if (typeof e != "object" || !e) return !1;
 	let t = e;
-	return typeof t.id == "string" && t.id.length > 0 && typeof t.name == "string" && typeof t.host == "string" && typeof t.apiKey == "string" && i(t.kind);
+	return typeof t.id == "string" && t.id.length > 0 && typeof t.name == "string" && typeof t.host == "string" && typeof t.apiKey == "string" && o(t.kind);
 }
-function o(e) {
+function c(e) {
+	if (typeof e != "string") return null;
+	let t = e.trim().replace(/\/+$/, "");
+	return t ? /^https?:\/\//i.test(t) ? t : `http://${t}` : null;
+}
+function l() {
+	let n = window.localStorage.getItem(a);
+	if (!n) return null;
 	try {
-		return new URL(e).origin;
+		let r = JSON.parse(n), i = c(r.baseUrl), a = typeof r.sessionApiKey == "string" ? r.sessionApiKey.trim() : "";
+		return !i || !a ? null : {
+			id: e,
+			name: t,
+			host: i,
+			apiKey: a,
+			kind: "local"
+		};
 	} catch {
-		return e.replace(/\/+$/, "");
+		return null;
 	}
 }
-function s(e) {
-	let n = t();
-	return e.id !== n.id || e.kind !== "local" || !n.apiKey || o(e.host) !== o(n.host) || e.apiKey === n.apiKey ? e : {
+function u() {
+	window.localStorage.removeItem(a);
+}
+function d(e) {
+	return h(e), u(), e;
+}
+function f(e) {
+	try {
+		let { hostname: t } = new URL(e);
+		return t === "localhost" || t === "127.0.0.1" || t === "::1" || t === "[::1]";
+	} catch {
+		return !1;
+	}
+}
+function p(e, t) {
+	return e.id !== "default-local" || e.kind !== "local" ? !1 : e.host === t.host || f(e.host) && f(t.host);
+}
+function m(e) {
+	let t = n();
+	if (!t) return e;
+	let r = !1, i = e.map((e) => !p(e, t) || e.apiKey === t.apiKey ? e : (r = !0, {
 		...e,
-		apiKey: n.apiKey
-	};
+		apiKey: t.apiKey
+	}));
+	return r ? (h(i), i) : e;
 }
-function c(e) {
+function h(e) {
 	if (!(typeof window > "u")) try {
-		window.localStorage.setItem(n, JSON.stringify(e));
+		window.localStorage.setItem(r, JSON.stringify(e));
 	} catch {}
 }
-function l() {
+function g() {
 	if (typeof window > "u") return [];
-	e();
 	try {
-		let e = window.localStorage.getItem(n);
+		let e = window.localStorage.getItem(r);
 		if (e === null) {
-			let e = [t()];
-			return c(e), e;
+			let e = l();
+			if (e) return d([e]);
+			let t = n();
+			return t ? d([t]) : [];
 		}
-		let r = JSON.parse(e);
-		if (!Array.isArray(r)) return [];
-		let i = r.filter(a);
+		let t = JSON.parse(e);
+		if (!Array.isArray(t)) return [];
+		let i = t.filter(s);
 		if (i.length === 0) {
-			let e = [t()];
-			return c(e), e;
+			let e = n();
+			return e ? d([e]) : [];
 		}
-		let o = i.map(s);
-		return o.some((e, t) => e !== i[t]) && c(o), o;
+		let a = m(i);
+		return u(), a;
 	} catch {
 		return [];
 	}
 }
-function u() {
+function _() {
 	if (typeof window > "u") return null;
 	try {
-		let e = window.localStorage.getItem(r);
+		let e = window.localStorage.getItem(i);
 		if (!e) return null;
 		let t = JSON.parse(e);
 		if (typeof t != "object" || !t || typeof t.backendId != "string") return null;
@@ -67,19 +100,19 @@ function u() {
 		return null;
 	}
 }
-function d(e) {
+function v(e) {
 	if (!(typeof window > "u")) try {
 		if (!e) {
-			window.localStorage.removeItem(r);
+			window.localStorage.removeItem(i);
 			return;
 		}
-		window.localStorage.setItem(r, JSON.stringify({
+		window.localStorage.setItem(i, JSON.stringify({
 			backendId: e.backendId,
 			orgId: e.orgId ?? null
 		}));
 	} catch {}
 }
 //#endregion
-export { u as readStoredActiveBackend, l as readStoredBackends, d as writeStoredActiveBackend, c as writeStoredBackends };
+export { _ as readStoredActiveBackend, g as readStoredBackends, v as writeStoredActiveBackend, h as writeStoredBackends };
 
 //# sourceMappingURL=storage.js.map

package/dist/api/backend-registry/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","names":[],"sources":["../../../src/api/backend-registry/storage.ts"],"sourcesContent":["import { syncBakedSessionApiKey } from \"../agent-server-config\";\nimport { makeDefaultLocalBackend } from \"./default-backend\";\nimport type { Backend, BackendKind, BackendSelection } from \"./types\";\n\nexport const BACKENDS_STORAGE_KEY = \"openhands-backends\";\nexport const ACTIVE_BACKEND_STORAGE_KEY = \"openhands-active-backend\";\n\nfunction isValidKind(value: unknown): value is BackendKind {\n  return value === \"local\" || value === \"cloud\";\n}\n\nfunction isValidBackend(value: unknown): value is Backend {\n  if (typeof value !== \"object\" || value === null) return false;\n  const v = value as Partial<Backend>;\n  return (\n    typeof v.id === \"string\" &&\n    v.id.length > 0 &&\n    typeof v.name === \"string\" &&\n    typeof v.host === \"string\" &&\n    typeof v.apiKey === \"string\" &&\n    isValidKind(v.kind)\n  );\n}\n\nfunction normalizeHostForComparison(host: string): string {\n  try {\n    return new URL(host).origin;\n  } catch {\n    return host.replace(/\\/+$/, \"\");\n  }\n}\n\nfunction syncDefaultLocalBackendAuth(backend: Backend): Backend {\n  const defaultBackend = makeDefaultLocalBackend();\n\n  if (\n    backend.id !== defaultBackend.id ||\n    backend.kind !== \"local\" ||\n    !defaultBackend.apiKey ||\n    normalizeHostForComparison(backend.host) !==\n      normalizeHostForComparison(defaultBackend.host)\n  ) {\n    return backend;\n  }\n\n  if (backend.apiKey === defaultBackend.apiKey) {\n    return backend;\n  }\n\n  return {\n    ...backend,\n    apiKey: defaultBackend.apiKey,\n  };\n}\n\nexport function writeStoredBackends(backends: Backend[]): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(BACKENDS_STORAGE_KEY, JSON.stringify(backends));\n  } catch {\n    /* ignore quota / serialization errors */\n  }\n}\n\nexport function readStoredBackends(): Backend[] {\n  if (typeof window === \"undefined\") return [];\n\n  // Ensure the baked-in session API key (VITE_SESSION_API_KEY) is synced\n  // into the legacy `openhands-agent-server-config` localStorage entry\n  // BEFORE we read the backend registry.  This matters when the user\n  // restarts the stack with a different LOCAL_BACKEND_API_KEY — without\n  // this call the stale key in `openhands-agent-server-config` shadows\n  // the new baked key, making `makeDefaultLocalBackend()` (and the\n  // downstream `syncDefaultLocalBackendAuth`) read the wrong value.\n  syncBakedSessionApiKey();\n\n  try {\n    const raw = window.localStorage.getItem(BACKENDS_STORAGE_KEY);\n\n    // First install: the storage key has never been written. Seed the\n    // registry with one default local backend derived from the env /\n    // agent-server-config so the user has something to talk to out of\n    // the box.\n    if (raw === null) {\n      const seeded = [makeDefaultLocalBackend()];\n      writeStoredBackends(seeded);\n      return seeded;\n    }\n\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) return [];\n    const valid = parsed.filter(isValidBackend);\n\n    // If the stored array is empty (or everything in it failed validation),\n    // re-seed with the default Local backend so the user always has a\n    // working entry pointing at VITE_SESSION_API_KEY. With the dev scripts\n    // persisting that key to ~/.openhands/agent-canvas/session-api-key.txt,\n    // re-seeding is safe — the seeded entry will keep working across\n    // restarts instead of going stale.\n    if (valid.length === 0) {\n      const seeded = [makeDefaultLocalBackend()];\n      writeStoredBackends(seeded);\n      return seeded;\n    }\n\n    const synced = valid.map(syncDefaultLocalBackendAuth);\n    if (synced.some((backend, index) => backend !== valid[index])) {\n      writeStoredBackends(synced);\n    }\n\n    return synced;\n  } catch {\n    return [];\n  }\n}\n\nexport function readStoredActiveBackend(): BackendSelection | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    const raw = window.localStorage.getItem(ACTIVE_BACKEND_STORAGE_KEY);\n    if (!raw) return null;\n    const parsed = JSON.parse(raw);\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      typeof (parsed as BackendSelection).backendId !== \"string\"\n    ) {\n      return null;\n    }\n    const orgIdRaw = (parsed as BackendSelection).orgId;\n    return {\n      backendId: (parsed as BackendSelection).backendId,\n      orgId:\n        typeof orgIdRaw === \"string\" && orgIdRaw.length > 0 ? orgIdRaw : null,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function writeStoredActiveBackend(\n  selection: BackendSelection | null,\n): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (!selection) {\n      window.localStorage.removeItem(ACTIVE_BACKEND_STORAGE_KEY);\n      return;\n    }\n    window.localStorage.setItem(\n      ACTIVE_BACKEND_STORAGE_KEY,\n      JSON.stringify({\n        backendId: selection.backendId,\n        orgId: selection.orgId ?? null,\n      }),\n    );\n  } catch {\n    /* ignore */\n  }\n}\n"],"mappings":";;;AAIA,IAAa,IAAuB,sBACvB,IAA6B;AAE1C,SAAS,EAAY,GAAsC;AACzD,QAAO,MAAU,WAAW,MAAU;;AAGxC,SAAS,EAAe,GAAkC;AACxD,KAAI,OAAO,KAAU,aAAY,EAAgB,QAAO;CACxD,IAAM,IAAI;AACV,QACE,OAAO,EAAE,MAAO,YAChB,EAAE,GAAG,SAAS,KACd,OAAO,EAAE,QAAS,YAClB,OAAO,EAAE,QAAS,YAClB,OAAO,EAAE,UAAW,YACpB,EAAY,EAAE,KAAK;;AAIvB,SAAS,EAA2B,GAAsB;AACxD,KAAI;AACF,SAAO,IAAI,IAAI,EAAK,CAAC;SACf;AACN,SAAO,EAAK,QAAQ,QAAQ,GAAG;;;AAInC,SAAS,EAA4B,GAA2B;CAC9D,IAAM,IAAiB,GAAyB;AAgBhD,QAbE,EAAQ,OAAO,EAAe,MAC9B,EAAQ,SAAS,WACjB,CAAC,EAAe,UAChB,EAA2B,EAAQ,KAAK,KACtC,EAA2B,EAAe,KAAK,IAK/C,EAAQ,WAAW,EAAe,SAC7B,IAGF;EACL,GAAG;EACH,QAAQ,EAAe;EACxB;;AAGH,SAAgB,EAAoB,GAA2B;AACzD,cAAO,SAAW,KACtB,KAAI;AACF,SAAO,aAAa,QAAQ,GAAsB,KAAK,UAAU,EAAS,CAAC;SACrE;;AAKV,SAAgB,IAAgC;AAC9C,KAAI,OAAO,SAAW,IAAa,QAAO,EAAE;AAS5C,IAAwB;AAExB,KAAI;EACF,IAAM,IAAM,OAAO,aAAa,QAAQ,EAAqB;AAM7D,MAAI,MAAQ,MAAM;GAChB,IAAM,IAAS,CAAC,GAAyB,CAAC;AAE1C,UADA,EAAoB,EAAO,EACpB;;EAGT,IAAM,IAAS,KAAK,MAAM,EAAI;AAC9B,MAAI,CAAC,MAAM,QAAQ,EAAO,CAAE,QAAO,EAAE;EACrC,IAAM,IAAQ,EAAO,OAAO,EAAe;AAQ3C,MAAI,EAAM,WAAW,GAAG;GACtB,IAAM,IAAS,CAAC,GAAyB,CAAC;AAE1C,UADA,EAAoB,EAAO,EACpB;;EAGT,IAAM,IAAS,EAAM,IAAI,EAA4B;AAKrD,SAJI,EAAO,MAAM,GAAS,MAAU,MAAY,EAAM,GAAO,IAC3D,EAAoB,EAAO,EAGtB;SACD;AACN,SAAO,EAAE;;;AAIb,SAAgB,IAAmD;AACjE,KAAI,OAAO,SAAW,IAAa,QAAO;AAC1C,KAAI;EACF,IAAM,IAAM,OAAO,aAAa,QAAQ,EAA2B;AACnE,MAAI,CAAC,EAAK,QAAO;EACjB,IAAM,IAAS,KAAK,MAAM,EAAI;AAC9B,MACE,OAAO,KAAW,aAClB,KACA,OAAQ,EAA4B,aAAc,SAElD,QAAO;EAET,IAAM,IAAY,EAA4B;AAC9C,SAAO;GACL,WAAY,EAA4B;GACxC,OACE,OAAO,KAAa,YAAY,EAAS,SAAS,IAAI,IAAW;GACpE;SACK;AACN,SAAO;;;AAIX,SAAgB,EACd,GACM;AACF,cAAO,SAAW,KACtB,KAAI;AACF,MAAI,CAAC,GAAW;AACd,UAAO,aAAa,WAAW,EAA2B;AAC1D;;AAEF,SAAO,aAAa,QAClB,GACA,KAAK,UAAU;GACb,WAAW,EAAU;GACrB,OAAO,EAAU,SAAS;GAC3B,CAAC,CACH;SACK"}
+{"version":3,"file":"storage.js","names":[],"sources":["../../../src/api/backend-registry/storage.ts"],"sourcesContent":["import {\n  DEFAULT_LOCAL_BACKEND_ID,\n  DEFAULT_LOCAL_BACKEND_NAME,\n  makeDefaultLocalBackend,\n} from \"./default-backend\";\nimport type { Backend, BackendKind, BackendSelection } from \"./types\";\n\nexport const BACKENDS_STORAGE_KEY = \"openhands-backends\";\nexport const ACTIVE_BACKEND_STORAGE_KEY = \"openhands-active-backend\";\n\nconst LEGACY_AGENT_SERVER_CONFIG_STORAGE_KEY = \"openhands-agent-server-config\";\n\nfunction isValidKind(value: unknown): value is BackendKind {\n  return value === \"local\" || value === \"cloud\";\n}\n\nfunction isValidBackend(value: unknown): value is Backend {\n  if (typeof value !== \"object\" || value === null) return false;\n  const v = value as Partial<Backend>;\n  return (\n    typeof v.id === \"string\" &&\n    v.id.length > 0 &&\n    typeof v.name === \"string\" &&\n    typeof v.host === \"string\" &&\n    typeof v.apiKey === \"string\" &&\n    isValidKind(v.kind)\n  );\n}\n\nfunction normalizeLegacyBaseUrl(value: unknown): string | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim().replace(/\\/+$/, \"\");\n  if (!trimmed) return null;\n  if (/^https?:\\/\\//i.test(trimmed)) return trimmed;\n  return `http://${trimmed}`;\n}\n\nfunction readLegacyBackend(): Backend | null {\n  const raw = window.localStorage.getItem(\n    LEGACY_AGENT_SERVER_CONFIG_STORAGE_KEY,\n  );\n  if (!raw) return null;\n\n  try {\n    const parsed = JSON.parse(raw) as Record<string, unknown>;\n    const host = normalizeLegacyBaseUrl(parsed.baseUrl);\n    const apiKey =\n      typeof parsed.sessionApiKey === \"string\"\n        ? parsed.sessionApiKey.trim()\n        : \"\";\n\n    if (!host || !apiKey) return null;\n\n    return {\n      id: DEFAULT_LOCAL_BACKEND_ID,\n      name: DEFAULT_LOCAL_BACKEND_NAME,\n      host,\n      apiKey,\n      kind: \"local\",\n    };\n  } catch {\n    return null;\n  }\n}\n\nfunction clearLegacyBackendConfig(): void {\n  window.localStorage.removeItem(LEGACY_AGENT_SERVER_CONFIG_STORAGE_KEY);\n}\n\nfunction seedBackends(backends: Backend[]): Backend[] {\n  writeStoredBackends(backends);\n  clearLegacyBackendConfig();\n  return backends;\n}\n\nfunction isLoopbackUrl(value: string): boolean {\n  try {\n    const { hostname } = new URL(value);\n    return (\n      hostname === \"localhost\" ||\n      hostname === \"127.0.0.1\" ||\n      hostname === \"::1\" ||\n      hostname === \"[::1]\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nfunction shouldSyncLauncherDefaultLocalBackend(\n  backend: Backend,\n  defaultBackend: Backend,\n): boolean {\n  if (backend.id !== DEFAULT_LOCAL_BACKEND_ID || backend.kind !== \"local\") {\n    return false;\n  }\n\n  return (\n    backend.host === defaultBackend.host ||\n    (isLoopbackUrl(backend.host) && isLoopbackUrl(defaultBackend.host))\n  );\n}\n\nfunction syncLauncherDefaultLocalBackend(backends: Backend[]): Backend[] {\n  const defaultBackend = makeDefaultLocalBackend();\n  if (!defaultBackend) return backends;\n\n  let didSync = false;\n  const syncedBackends = backends.map((backend) => {\n    if (!shouldSyncLauncherDefaultLocalBackend(backend, defaultBackend)) {\n      return backend;\n    }\n\n    if (backend.apiKey === defaultBackend.apiKey) return backend;\n\n    didSync = true;\n    return {\n      ...backend,\n      apiKey: defaultBackend.apiKey,\n    };\n  });\n\n  if (!didSync) return backends;\n\n  writeStoredBackends(syncedBackends);\n  return syncedBackends;\n}\n\nexport function writeStoredBackends(backends: Backend[]): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    window.localStorage.setItem(BACKENDS_STORAGE_KEY, JSON.stringify(backends));\n  } catch {\n    /* ignore quota / serialization errors */\n  }\n}\n\nexport function readStoredBackends(): Backend[] {\n  if (typeof window === \"undefined\") return [];\n\n  try {\n    const raw = window.localStorage.getItem(BACKENDS_STORAGE_KEY);\n\n    // First install: migrate one legacy local backend if present, otherwise\n    // seed only when the launcher supplied enough information for a usable\n    // local backend.\n    if (raw === null) {\n      const legacyBackend = readLegacyBackend();\n      if (legacyBackend) return seedBackends([legacyBackend]);\n\n      const defaultBackend = makeDefaultLocalBackend();\n      if (!defaultBackend) return [];\n\n      return seedBackends([defaultBackend]);\n    }\n\n    const parsed = JSON.parse(raw);\n    if (!Array.isArray(parsed)) return [];\n    const valid = parsed.filter(isValidBackend);\n\n    // If the stored array is empty (or everything in it failed validation),\n    // only re-seed when the launcher supplied both a host and API key.\n    if (valid.length === 0) {\n      const defaultBackend = makeDefaultLocalBackend();\n      if (!defaultBackend) return [];\n\n      return seedBackends([defaultBackend]);\n    }\n\n    const synced = syncLauncherDefaultLocalBackend(valid);\n    clearLegacyBackendConfig();\n    return synced;\n  } catch {\n    return [];\n  }\n}\n\nexport function readStoredActiveBackend(): BackendSelection | null {\n  if (typeof window === \"undefined\") return null;\n  try {\n    const raw = window.localStorage.getItem(ACTIVE_BACKEND_STORAGE_KEY);\n    if (!raw) return null;\n    const parsed = JSON.parse(raw);\n    if (\n      typeof parsed !== \"object\" ||\n      parsed === null ||\n      typeof (parsed as BackendSelection).backendId !== \"string\"\n    ) {\n      return null;\n    }\n    const orgIdRaw = (parsed as BackendSelection).orgId;\n    return {\n      backendId: (parsed as BackendSelection).backendId,\n      orgId:\n        typeof orgIdRaw === \"string\" && orgIdRaw.length > 0 ? orgIdRaw : null,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function writeStoredActiveBackend(\n  selection: BackendSelection | null,\n): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    if (!selection) {\n      window.localStorage.removeItem(ACTIVE_BACKEND_STORAGE_KEY);\n      return;\n    }\n    window.localStorage.setItem(\n      ACTIVE_BACKEND_STORAGE_KEY,\n      JSON.stringify({\n        backendId: selection.backendId,\n        orgId: selection.orgId ?? null,\n      }),\n    );\n  } catch {\n    /* ignore */\n  }\n}\n"],"mappings":"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"}

package/dist/api/cloud/conversation-service.api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-service.api.cjs","names":[],"sources":["../../../src/api/cloud/conversation-service.api.ts"],"sourcesContent":["import { getActiveBackend } from \"../backend-registry/active-store\";\nimport type { Backend } from \"../backend-registry/types\";\nimport { getStoredConversationMetadata } from \"../conversation-metadata-store\";\nimport type {\n  AppConversation,\n  AppConversationPage,\n  AppConversationStartRequest,\n  AppConversationStartTask,\n} from \"../conversation-service/agent-server-conversation-service.types\";\nimport { callCloudProxy } from \"./proxy\";\n\n/**\n * The cloud backend does not always echo `selected_repository` /\n * `selected_branch` / `git_provider` back from\n * `GET /api/v1/app-conversations` until its own background hydration\n * completes. We persist the selection to local storage at connect time\n * (see `AgentServerConversationService.updateConversationRepository`)\n * and overlay it here so the chat-page git control bar reflects the\n * connection immediately, instead of snapping back to the empty\n * \"Connect Repo\" state on every refetch.\n *\n * Server values take precedence whenever they're populated; the\n * local-storage fallback only fills in fields the server returned as\n * `null`/`undefined`.\n */\nfunction overlayStoredRepoSelection(\n  conversation: AppConversation | null,\n): AppConversation | null {\n  if (!conversation?.id) return conversation;\n  const stored = getStoredConversationMetadata(conversation.id);\n  if (!stored) return conversation;\n\n  return {\n    ...conversation,\n    selected_repository:\n      conversation.selected_repository ?? stored.selected_repository ?? null,\n    selected_branch:\n      conversation.selected_branch ?? stored.selected_branch ?? null,\n    git_provider: conversation.git_provider ?? stored.git_provider ?? null,\n    selected_workspace:\n      conversation.selected_workspace ?? stored.selected_workspace ?? null,\n  };\n}\n\nfunction getActiveCloudBackend(): Backend {\n  const active = getActiveBackend().backend;\n  if (active.kind !== \"cloud\") {\n    throw new Error(\"Cloud conversations call requires a cloud backend.\");\n  }\n  return active;\n}\n\n/**\n * Search the cloud app-conversations list. Mirrors the local\n * `AgentServerConversationService.searchConversations` interface but routes\n * through the bundled agent-server's cloud proxy and hits the cloud\n * endpoint `/api/v1/app-conversations/search`.\n */\nexport async function searchCloudConversations(\n  limit: number = 20,\n  pageId?: string,\n): Promise<AppConversationPage> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.set(\"limit\", String(limit));\n  if (pageId) params.set(\"page_id\", pageId);\n  params.set(\"sort_order\", \"UPDATED_AT_DESC\");\n\n  const data = await callCloudProxy<{\n    items: AppConversation[];\n    next_page_id: string | null;\n  }>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/search?${params.toString()}`,\n  });\n\n  return {\n    items: (data?.items ?? []).map(\n      (item) => overlayStoredRepoSelection(item) as AppConversation,\n    ),\n    next_page_id: data?.next_page_id ?? null,\n  };\n}\n\n/**\n * Batch-fetch cloud app-conversations by id. Mirrors the local\n * `AgentServerConversationService.batchGetAppConversations` interface.\n */\nexport async function batchGetCloudConversations(\n  ids: string[],\n): Promise<(AppConversation | null)[]> {\n  if (ids.length === 0) return [];\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  for (const id of ids) params.append(\"ids\", id);\n  const data = await callCloudProxy<(AppConversation | null)[]>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations?${params.toString()}`,\n  });\n  return (data ?? []).map(overlayStoredRepoSelection);\n}\n\n/**\n * Create a v1 app-conversation on the cloud backend.\n *\n * Mirrors OpenHands' cloud flow: POST /api/v1/app-conversations with the\n * `AppConversationStartRequest` payload, returning a\n * `AppConversationStartTask`. The task is initially WORKING; the caller\n * polls `getCloudAppConversationStartTask` (3s cadence per OpenHands)\n * until status is READY (then `app_conversation_id`, `agent_server_url`,\n * and `session_api_key` are populated) or ERROR.\n *\n * This path does NOT use encrypted-settings round-tripping. Secrets stay\n * server-side on the cloud backend — the only auth carried is the cloud bearer\n * token (via the proxy's headers), and the conversation runtime is\n * provisioned with its own ephemeral session_api_key returned in the\n * task.\n */\nexport async function createCloudAppConversation(\n  request: AppConversationStartRequest,\n): Promise<AppConversationStartTask> {\n  const backend = getActiveCloudBackend();\n  const data = await callCloudProxy<AppConversationStartTask>({\n    backend,\n    method: \"POST\",\n    path: \"/api/v1/app-conversations\",\n    body: request as unknown as Record<string, unknown>,\n  });\n  return data;\n}\n\n/**\n * Download a v1 app-conversation as a ZIP from the cloud backend. Mirrors\n * the local `AgentServerConversationService.downloadConversation` interface but\n * routes through the bundled agent-server's cloud proxy and hits\n * `GET /api/v1/app-conversations/{id}/download`, which returns\n * `application/zip` with `Content-Disposition` set by the cloud backend.\n */\nexport async function downloadCloudConversation(\n  conversationId: string,\n): Promise<Blob> {\n  const backend = getActiveCloudBackend();\n  return callCloudProxy<Blob>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/${conversationId}/download`,\n    responseType: \"blob\",\n  });\n}\n\n/**\n * Delete a v1 app-conversation on the cloud backend. Mirrors the local\n * `AgentServerConversationService.deleteConversation` interface but routes\n * through the bundled agent-server's cloud proxy and hits\n * `DELETE /api/v1/app-conversations/{id}`, which returns a JSON\n * `Success` envelope (discarded here — the caller only needs to know\n * the request didn't error).\n */\nexport async function deleteCloudConversation(\n  conversationId: string,\n): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"DELETE\",\n    path: `/api/v1/app-conversations/${conversationId}`,\n  });\n}\n\n/**\n * Toggle the public-sharing flag on a cloud v1 app-conversation. Mirrors\n * OpenHands' `AgentServerConversationService.updateConversationPublicFlag` —\n * routes through the bundled agent-server's cloud proxy and hits\n * `PATCH /api/v1/app-conversations/{id}` with `{ public }`, returning\n * the updated conversation.\n */\nexport async function updateCloudConversationPublicFlag(\n  conversationId: string,\n  isPublic: boolean,\n): Promise<AppConversation> {\n  const backend = getActiveCloudBackend();\n  const data = await callCloudProxy<AppConversation>({\n    backend,\n    method: \"PATCH\",\n    path: `/api/v1/app-conversations/${conversationId}`,\n    body: { public: isPublic },\n  });\n  return data;\n}\n\n/**\n * Pause the cloud sandbox backing a v1 app-conversation. Mirrors\n * OpenHands' `SandboxService.pauseSandbox` — routes through the\n * bundled agent-server's cloud proxy and hits\n * `POST /api/v1/sandboxes/{sandboxId}/pause` on the cloud backend, which stops\n * the runtime owning the conversation.\n */\nexport async function pauseCloudSandbox(sandboxId: string): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"POST\",\n    path: `/api/v1/sandboxes/${sandboxId}/pause`,\n  });\n}\n\n/**\n * Resume a paused cloud sandbox. Mirrors OpenHands' `SandboxService.resumeSandbox`\n * — routes through the bundled agent-server's cloud proxy and hits\n * `POST /api/v1/sandboxes/{sandboxId}/resume` on the SaaS.\n *\n * This is the correct endpoint for waking a PAUSED sandbox. It is a\n * lightweight unpause — NOT the same as creating a new start task via\n * `POST /api/v1/app-conversations`, which provisions a fresh conversation\n * and is subject to the 120-second sandbox-start timeout.\n */\nexport async function resumeCloudSandbox(sandboxId: string): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"POST\",\n    path: `/api/v1/sandboxes/${sandboxId}/resume`,\n  });\n}\n\n/**\n * Read a file from a cloud conversation's sandbox workspace. Mirrors\n * OpenHands' `AgentServerConversationService.readConversationFile` — hits\n * `GET /api/v1/app-conversations/{id}/file?file_path=...` on the cloud backend\n * and returns the file content as a string.\n */\nexport async function readCloudConversationFile(\n  conversationId: string,\n  filePath: string,\n): Promise<string> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.append(\"file_path\", filePath);\n  const data = await callCloudProxy<string>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/${conversationId}/file?${params.toString()}`,\n  });\n  return data ?? \"\";\n}\n\n/**\n * Fetch a single v1 app-conversation start task. Mirrors OpenHands'\n * `AgentServerConversationService.getStartTask` — uses the batch search endpoint\n * with a single id and unwraps the first result.\n */\nexport async function getCloudAppConversationStartTask(\n  taskId: string,\n): Promise<AppConversationStartTask | null> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.set(\"ids\", taskId);\n  const data = await callCloudProxy<(AppConversationStartTask | null)[]>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/start-tasks?${params.toString()}`,\n  });\n  return data?.[0] ?? null;\n}\n"],"mappings":"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"}
+{"version":3,"file":"conversation-service.api.cjs","names":[],"sources":["../../../src/api/cloud/conversation-service.api.ts"],"sourcesContent":["import { getActiveBackend } from \"../backend-registry/active-store\";\nimport type { Backend } from \"../backend-registry/types\";\nimport { getStoredConversationMetadata } from \"../conversation-metadata-store\";\nimport type {\n  AppConversation,\n  AppConversationPage,\n  AppConversationStartRequest,\n  AppConversationStartTask,\n} from \"../conversation-service/agent-server-conversation-service.types\";\nimport { callCloudProxy } from \"./proxy\";\n\n/**\n * The cloud backend does not always echo `selected_repository` /\n * `selected_branch` / `git_provider` back from\n * `GET /api/v1/app-conversations` until its own background hydration\n * completes. We persist the selection to local storage at connect time\n * (see `AgentServerConversationService.updateConversationRepository`)\n * and overlay it here so the chat-page git control bar reflects the\n * connection immediately, instead of snapping back to the empty\n * \"Connect Repo\" state on every refetch.\n *\n * Server values take precedence whenever they're populated; the\n * local-storage fallback only fills in fields the server returned as\n * `null`/`undefined`.\n */\nfunction overlayStoredRepoSelection(\n  conversation: AppConversation | null,\n): AppConversation | null {\n  if (!conversation?.id) return conversation;\n  const stored = getStoredConversationMetadata(conversation.id);\n  if (!stored) return conversation;\n\n  return {\n    ...conversation,\n    selected_repository:\n      conversation.selected_repository ?? stored.selected_repository ?? null,\n    selected_branch:\n      conversation.selected_branch ?? stored.selected_branch ?? null,\n    git_provider: conversation.git_provider ?? stored.git_provider ?? null,\n    selected_workspace:\n      conversation.selected_workspace ?? stored.selected_workspace ?? null,\n  };\n}\n\nfunction getActiveCloudBackend(): Backend {\n  const active = getActiveBackend().backend;\n  if (active.kind !== \"cloud\") {\n    throw new Error(\"Cloud conversations call requires a cloud backend.\");\n  }\n  return active;\n}\n\n/**\n * Search the cloud app-conversations list. Mirrors the local\n * `AgentServerConversationService.searchConversations` interface but calls\n * the cloud endpoint `/api/v1/app-conversations/search`.\n */\nexport async function searchCloudConversations(\n  limit: number = 20,\n  pageId?: string,\n): Promise<AppConversationPage> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.set(\"limit\", String(limit));\n  if (pageId) params.set(\"page_id\", pageId);\n  params.set(\"sort_order\", \"UPDATED_AT_DESC\");\n\n  const data = await callCloudProxy<{\n    items: AppConversation[];\n    next_page_id: string | null;\n  }>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/search?${params.toString()}`,\n  });\n\n  return {\n    items: (data?.items ?? []).map(\n      (item) => overlayStoredRepoSelection(item) as AppConversation,\n    ),\n    next_page_id: data?.next_page_id ?? null,\n  };\n}\n\n/**\n * Batch-fetch cloud app-conversations by id. Mirrors the local\n * `AgentServerConversationService.batchGetAppConversations` interface.\n */\nexport async function batchGetCloudConversations(\n  ids: string[],\n): Promise<(AppConversation | null)[]> {\n  if (ids.length === 0) return [];\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  for (const id of ids) params.append(\"ids\", id);\n  const data = await callCloudProxy<(AppConversation | null)[]>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations?${params.toString()}`,\n  });\n  return (data ?? []).map(overlayStoredRepoSelection);\n}\n\n/**\n * Create a v1 app-conversation on the cloud backend.\n *\n * Mirrors OpenHands' cloud flow: POST /api/v1/app-conversations with the\n * `AppConversationStartRequest` payload, returning a\n * `AppConversationStartTask`. The task is initially WORKING; the caller\n * polls `getCloudAppConversationStartTask` (3s cadence per OpenHands)\n * until status is READY (then `app_conversation_id`, `agent_server_url`,\n * and `session_api_key` are populated) or ERROR.\n *\n * This path does NOT use encrypted-settings round-tripping. Secrets stay\n * server-side on the cloud backend — the only auth carried is the cloud bearer\n * token, and the conversation runtime is\n * provisioned with its own ephemeral session_api_key returned in the\n * task.\n */\nexport async function createCloudAppConversation(\n  request: AppConversationStartRequest,\n): Promise<AppConversationStartTask> {\n  const backend = getActiveCloudBackend();\n  const data = await callCloudProxy<AppConversationStartTask>({\n    backend,\n    method: \"POST\",\n    path: \"/api/v1/app-conversations\",\n    body: request as unknown as Record<string, unknown>,\n  });\n  return data;\n}\n\n/**\n * Download a v1 app-conversation as a ZIP from the cloud backend. Mirrors\n * the local `AgentServerConversationService.downloadConversation` interface but\n * calls\n * `GET /api/v1/app-conversations/{id}/download`, which returns\n * `application/zip` with `Content-Disposition` set by the cloud backend.\n */\nexport async function downloadCloudConversation(\n  conversationId: string,\n): Promise<Blob> {\n  const backend = getActiveCloudBackend();\n  return callCloudProxy<Blob>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/${conversationId}/download`,\n    responseType: \"blob\",\n  });\n}\n\n/**\n * Delete a v1 app-conversation on the cloud backend. Mirrors the local\n * `AgentServerConversationService.deleteConversation` interface but calls\n * `DELETE /api/v1/app-conversations/{id}`, which returns a JSON\n * `Success` envelope (discarded here — the caller only needs to know\n * the request didn't error).\n */\nexport async function deleteCloudConversation(\n  conversationId: string,\n): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"DELETE\",\n    path: `/api/v1/app-conversations/${conversationId}`,\n  });\n}\n\n/**\n * Toggle the public-sharing flag on a cloud v1 app-conversation. Mirrors\n * OpenHands' `AgentServerConversationService.updateConversationPublicFlag`:\n * `PATCH /api/v1/app-conversations/{id}` with `{ public }`, returning\n * the updated conversation.\n */\nexport async function updateCloudConversationPublicFlag(\n  conversationId: string,\n  isPublic: boolean,\n): Promise<AppConversation> {\n  const backend = getActiveCloudBackend();\n  const data = await callCloudProxy<AppConversation>({\n    backend,\n    method: \"PATCH\",\n    path: `/api/v1/app-conversations/${conversationId}`,\n    body: { public: isPublic },\n  });\n  return data;\n}\n\n/**\n * Pause the cloud sandbox backing a v1 app-conversation. Mirrors\n * OpenHands' `SandboxService.pauseSandbox`:\n * `POST /api/v1/sandboxes/{sandboxId}/pause` on the cloud backend, which stops\n * the runtime owning the conversation.\n */\nexport async function pauseCloudSandbox(sandboxId: string): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"POST\",\n    path: `/api/v1/sandboxes/${sandboxId}/pause`,\n  });\n}\n\n/**\n * Resume a paused cloud sandbox. Mirrors OpenHands' `SandboxService.resumeSandbox`\n * by calling `POST /api/v1/sandboxes/{sandboxId}/resume` on the SaaS.\n *\n * This is the correct endpoint for waking a PAUSED sandbox. It is a\n * lightweight unpause — NOT the same as creating a new start task via\n * `POST /api/v1/app-conversations`, which provisions a fresh conversation\n * and is subject to the 120-second sandbox-start timeout.\n */\nexport async function resumeCloudSandbox(sandboxId: string): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"POST\",\n    path: `/api/v1/sandboxes/${sandboxId}/resume`,\n  });\n}\n\n/**\n * Read a file from a cloud conversation's sandbox workspace. Mirrors\n * OpenHands' `AgentServerConversationService.readConversationFile` — hits\n * `GET /api/v1/app-conversations/{id}/file?file_path=...` on the cloud backend\n * and returns the file content as a string.\n */\nexport async function readCloudConversationFile(\n  conversationId: string,\n  filePath: string,\n): Promise<string> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.append(\"file_path\", filePath);\n  const data = await callCloudProxy<string>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/${conversationId}/file?${params.toString()}`,\n  });\n  return data ?? \"\";\n}\n\n/**\n * Fetch a single v1 app-conversation start task. Mirrors OpenHands'\n * `AgentServerConversationService.getStartTask` — uses the batch search endpoint\n * with a single id and unwraps the first result.\n */\nexport async function getCloudAppConversationStartTask(\n  taskId: string,\n): Promise<AppConversationStartTask | null> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.set(\"ids\", taskId);\n  const data = await callCloudProxy<(AppConversationStartTask | null)[]>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/start-tasks?${params.toString()}`,\n  });\n  return data?.[0] ?? null;\n}\n"],"mappings":"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"}

package/dist/api/cloud/conversation-service.api.d.ts

@@ -1,9 +1,8 @@
 import type { AppConversation, AppConversationPage, AppConversationStartRequest, AppConversationStartTask } from "../conversation-service/agent-server-conversation-service.types";
 /**
  * Search the cloud app-conversations list. Mirrors the local
- * `AgentServerConversationService.searchConversations` interface but routes
- * through the bundled agent-server's cloud proxy and hits the cloud
- * endpoint `/api/v1/app-conversations/search`.
+ * `AgentServerConversationService.searchConversations` interface but calls
+ * the cloud endpoint `/api/v1/app-conversations/search`.
  */
 export declare function searchCloudConversations(limit?: number, pageId?: string): Promise<AppConversationPage>;
 /**
@@ -23,7 +22,7 @@ export declare function batchGetCloudConversations(ids: string[]): Promise<(AppC
  *
  * This path does NOT use encrypted-settings round-tripping. Secrets stay
  * server-side on the cloud backend — the only auth carried is the cloud bearer
- * token (via the proxy's headers), and the conversation runtime is
+ * token, and the conversation runtime is
  * provisioned with its own ephemeral session_api_key returned in the
  * task.
  */
@@ -31,15 +30,14 @@ export declare function createCloudAppConversation(request: AppConversationStart
 /**
  * Download a v1 app-conversation as a ZIP from the cloud backend. Mirrors
  * the local `AgentServerConversationService.downloadConversation` interface but
- * routes through the bundled agent-server's cloud proxy and hits
+ * calls
  * `GET /api/v1/app-conversations/{id}/download`, which returns
  * `application/zip` with `Content-Disposition` set by the cloud backend.
  */
 export declare function downloadCloudConversation(conversationId: string): Promise<Blob>;
 /**
  * Delete a v1 app-conversation on the cloud backend. Mirrors the local
- * `AgentServerConversationService.deleteConversation` interface but routes
- * through the bundled agent-server's cloud proxy and hits
+ * `AgentServerConversationService.deleteConversation` interface but calls
  * `DELETE /api/v1/app-conversations/{id}`, which returns a JSON
  * `Success` envelope (discarded here — the caller only needs to know
  * the request didn't error).
@@ -47,24 +45,21 @@ export declare function downloadCloudConversation(conversationId: string): Promi
 export declare function deleteCloudConversation(conversationId: string): Promise<void>;
 /**
  * Toggle the public-sharing flag on a cloud v1 app-conversation. Mirrors
- * OpenHands' `AgentServerConversationService.updateConversationPublicFlag` —
- * routes through the bundled agent-server's cloud proxy and hits
+ * OpenHands' `AgentServerConversationService.updateConversationPublicFlag`:
  * `PATCH /api/v1/app-conversations/{id}` with `{ public }`, returning
  * the updated conversation.
  */
 export declare function updateCloudConversationPublicFlag(conversationId: string, isPublic: boolean): Promise<AppConversation>;
 /**
  * Pause the cloud sandbox backing a v1 app-conversation. Mirrors
- * OpenHands' `SandboxService.pauseSandbox` — routes through the
- * bundled agent-server's cloud proxy and hits
+ * OpenHands' `SandboxService.pauseSandbox`:
  * `POST /api/v1/sandboxes/{sandboxId}/pause` on the cloud backend, which stops
  * the runtime owning the conversation.
  */
 export declare function pauseCloudSandbox(sandboxId: string): Promise<void>;
 /**
  * Resume a paused cloud sandbox. Mirrors OpenHands' `SandboxService.resumeSandbox`
- * — routes through the bundled agent-server's cloud proxy and hits
- * `POST /api/v1/sandboxes/{sandboxId}/resume` on the SaaS.
+ * by calling `POST /api/v1/sandboxes/{sandboxId}/resume` on the SaaS.
  *
  * This is the correct endpoint for waking a PAUSED sandbox. It is a
  * lightweight unpause — NOT the same as creating a new start task via

package/dist/api/cloud/conversation-service.api.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-service.api.js","names":[],"sources":["../../../src/api/cloud/conversation-service.api.ts"],"sourcesContent":["import { getActiveBackend } from \"../backend-registry/active-store\";\nimport type { Backend } from \"../backend-registry/types\";\nimport { getStoredConversationMetadata } from \"../conversation-metadata-store\";\nimport type {\n  AppConversation,\n  AppConversationPage,\n  AppConversationStartRequest,\n  AppConversationStartTask,\n} from \"../conversation-service/agent-server-conversation-service.types\";\nimport { callCloudProxy } from \"./proxy\";\n\n/**\n * The cloud backend does not always echo `selected_repository` /\n * `selected_branch` / `git_provider` back from\n * `GET /api/v1/app-conversations` until its own background hydration\n * completes. We persist the selection to local storage at connect time\n * (see `AgentServerConversationService.updateConversationRepository`)\n * and overlay it here so the chat-page git control bar reflects the\n * connection immediately, instead of snapping back to the empty\n * \"Connect Repo\" state on every refetch.\n *\n * Server values take precedence whenever they're populated; the\n * local-storage fallback only fills in fields the server returned as\n * `null`/`undefined`.\n */\nfunction overlayStoredRepoSelection(\n  conversation: AppConversation | null,\n): AppConversation | null {\n  if (!conversation?.id) return conversation;\n  const stored = getStoredConversationMetadata(conversation.id);\n  if (!stored) return conversation;\n\n  return {\n    ...conversation,\n    selected_repository:\n      conversation.selected_repository ?? stored.selected_repository ?? null,\n    selected_branch:\n      conversation.selected_branch ?? stored.selected_branch ?? null,\n    git_provider: conversation.git_provider ?? stored.git_provider ?? null,\n    selected_workspace:\n      conversation.selected_workspace ?? stored.selected_workspace ?? null,\n  };\n}\n\nfunction getActiveCloudBackend(): Backend {\n  const active = getActiveBackend().backend;\n  if (active.kind !== \"cloud\") {\n    throw new Error(\"Cloud conversations call requires a cloud backend.\");\n  }\n  return active;\n}\n\n/**\n * Search the cloud app-conversations list. Mirrors the local\n * `AgentServerConversationService.searchConversations` interface but routes\n * through the bundled agent-server's cloud proxy and hits the cloud\n * endpoint `/api/v1/app-conversations/search`.\n */\nexport async function searchCloudConversations(\n  limit: number = 20,\n  pageId?: string,\n): Promise<AppConversationPage> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.set(\"limit\", String(limit));\n  if (pageId) params.set(\"page_id\", pageId);\n  params.set(\"sort_order\", \"UPDATED_AT_DESC\");\n\n  const data = await callCloudProxy<{\n    items: AppConversation[];\n    next_page_id: string | null;\n  }>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/search?${params.toString()}`,\n  });\n\n  return {\n    items: (data?.items ?? []).map(\n      (item) => overlayStoredRepoSelection(item) as AppConversation,\n    ),\n    next_page_id: data?.next_page_id ?? null,\n  };\n}\n\n/**\n * Batch-fetch cloud app-conversations by id. Mirrors the local\n * `AgentServerConversationService.batchGetAppConversations` interface.\n */\nexport async function batchGetCloudConversations(\n  ids: string[],\n): Promise<(AppConversation | null)[]> {\n  if (ids.length === 0) return [];\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  for (const id of ids) params.append(\"ids\", id);\n  const data = await callCloudProxy<(AppConversation | null)[]>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations?${params.toString()}`,\n  });\n  return (data ?? []).map(overlayStoredRepoSelection);\n}\n\n/**\n * Create a v1 app-conversation on the cloud backend.\n *\n * Mirrors OpenHands' cloud flow: POST /api/v1/app-conversations with the\n * `AppConversationStartRequest` payload, returning a\n * `AppConversationStartTask`. The task is initially WORKING; the caller\n * polls `getCloudAppConversationStartTask` (3s cadence per OpenHands)\n * until status is READY (then `app_conversation_id`, `agent_server_url`,\n * and `session_api_key` are populated) or ERROR.\n *\n * This path does NOT use encrypted-settings round-tripping. Secrets stay\n * server-side on the cloud backend — the only auth carried is the cloud bearer\n * token (via the proxy's headers), and the conversation runtime is\n * provisioned with its own ephemeral session_api_key returned in the\n * task.\n */\nexport async function createCloudAppConversation(\n  request: AppConversationStartRequest,\n): Promise<AppConversationStartTask> {\n  const backend = getActiveCloudBackend();\n  const data = await callCloudProxy<AppConversationStartTask>({\n    backend,\n    method: \"POST\",\n    path: \"/api/v1/app-conversations\",\n    body: request as unknown as Record<string, unknown>,\n  });\n  return data;\n}\n\n/**\n * Download a v1 app-conversation as a ZIP from the cloud backend. Mirrors\n * the local `AgentServerConversationService.downloadConversation` interface but\n * routes through the bundled agent-server's cloud proxy and hits\n * `GET /api/v1/app-conversations/{id}/download`, which returns\n * `application/zip` with `Content-Disposition` set by the cloud backend.\n */\nexport async function downloadCloudConversation(\n  conversationId: string,\n): Promise<Blob> {\n  const backend = getActiveCloudBackend();\n  return callCloudProxy<Blob>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/${conversationId}/download`,\n    responseType: \"blob\",\n  });\n}\n\n/**\n * Delete a v1 app-conversation on the cloud backend. Mirrors the local\n * `AgentServerConversationService.deleteConversation` interface but routes\n * through the bundled agent-server's cloud proxy and hits\n * `DELETE /api/v1/app-conversations/{id}`, which returns a JSON\n * `Success` envelope (discarded here — the caller only needs to know\n * the request didn't error).\n */\nexport async function deleteCloudConversation(\n  conversationId: string,\n): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"DELETE\",\n    path: `/api/v1/app-conversations/${conversationId}`,\n  });\n}\n\n/**\n * Toggle the public-sharing flag on a cloud v1 app-conversation. Mirrors\n * OpenHands' `AgentServerConversationService.updateConversationPublicFlag` —\n * routes through the bundled agent-server's cloud proxy and hits\n * `PATCH /api/v1/app-conversations/{id}` with `{ public }`, returning\n * the updated conversation.\n */\nexport async function updateCloudConversationPublicFlag(\n  conversationId: string,\n  isPublic: boolean,\n): Promise<AppConversation> {\n  const backend = getActiveCloudBackend();\n  const data = await callCloudProxy<AppConversation>({\n    backend,\n    method: \"PATCH\",\n    path: `/api/v1/app-conversations/${conversationId}`,\n    body: { public: isPublic },\n  });\n  return data;\n}\n\n/**\n * Pause the cloud sandbox backing a v1 app-conversation. Mirrors\n * OpenHands' `SandboxService.pauseSandbox` — routes through the\n * bundled agent-server's cloud proxy and hits\n * `POST /api/v1/sandboxes/{sandboxId}/pause` on the cloud backend, which stops\n * the runtime owning the conversation.\n */\nexport async function pauseCloudSandbox(sandboxId: string): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"POST\",\n    path: `/api/v1/sandboxes/${sandboxId}/pause`,\n  });\n}\n\n/**\n * Resume a paused cloud sandbox. Mirrors OpenHands' `SandboxService.resumeSandbox`\n * — routes through the bundled agent-server's cloud proxy and hits\n * `POST /api/v1/sandboxes/{sandboxId}/resume` on the SaaS.\n *\n * This is the correct endpoint for waking a PAUSED sandbox. It is a\n * lightweight unpause — NOT the same as creating a new start task via\n * `POST /api/v1/app-conversations`, which provisions a fresh conversation\n * and is subject to the 120-second sandbox-start timeout.\n */\nexport async function resumeCloudSandbox(sandboxId: string): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"POST\",\n    path: `/api/v1/sandboxes/${sandboxId}/resume`,\n  });\n}\n\n/**\n * Read a file from a cloud conversation's sandbox workspace. Mirrors\n * OpenHands' `AgentServerConversationService.readConversationFile` — hits\n * `GET /api/v1/app-conversations/{id}/file?file_path=...` on the cloud backend\n * and returns the file content as a string.\n */\nexport async function readCloudConversationFile(\n  conversationId: string,\n  filePath: string,\n): Promise<string> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.append(\"file_path\", filePath);\n  const data = await callCloudProxy<string>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/${conversationId}/file?${params.toString()}`,\n  });\n  return data ?? \"\";\n}\n\n/**\n * Fetch a single v1 app-conversation start task. Mirrors OpenHands'\n * `AgentServerConversationService.getStartTask` — uses the batch search endpoint\n * with a single id and unwraps the first result.\n */\nexport async function getCloudAppConversationStartTask(\n  taskId: string,\n): Promise<AppConversationStartTask | null> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.set(\"ids\", taskId);\n  const data = await callCloudProxy<(AppConversationStartTask | null)[]>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/start-tasks?${params.toString()}`,\n  });\n  return data?.[0] ?? null;\n}\n"],"mappings":";;;;AAyBA,SAAS,EACP,GACwB;AACxB,KAAI,CAAC,GAAc,GAAI,QAAO;CAC9B,IAAM,IAAS,EAA8B,EAAa,GAAG;AAG7D,QAFK,IAEE;EACL,GAAG;EACH,qBACE,EAAa,uBAAuB,EAAO,uBAAuB;EACpE,iBACE,EAAa,mBAAmB,EAAO,mBAAmB;EAC5D,cAAc,EAAa,gBAAgB,EAAO,gBAAgB;EAClE,oBACE,EAAa,sBAAsB,EAAO,sBAAsB;EACnE,GAXmB;;AActB,SAAS,IAAiC;CACxC,IAAM,IAAS,GAAkB,CAAC;AAClC,KAAI,EAAO,SAAS,QAClB,OAAU,MAAM,qDAAqD;AAEvE,QAAO;;AAST,eAAsB,EACpB,IAAgB,IAChB,GAC8B;CAC9B,IAAM,IAAU,GAAuB,EACjC,IAAS,IAAI,iBAAiB;AAGpC,CAFA,EAAO,IAAI,SAAS,OAAO,EAAM,CAAC,EAC9B,KAAQ,EAAO,IAAI,WAAW,EAAO,EACzC,EAAO,IAAI,cAAc,kBAAkB;CAE3C,IAAM,IAAO,MAAM,EAGhB;EACD;EACA,QAAQ;EACR,MAAM,oCAAoC,EAAO,UAAU;EAC5D,CAAC;AAEF,QAAO;EACL,QAAQ,GAAM,SAAS,EAAE,EAAE,KACxB,MAAS,EAA2B,EAAK,CAC3C;EACD,cAAc,GAAM,gBAAgB;EACrC;;AAOH,eAAsB,EACpB,GACqC;AACrC,KAAI,EAAI,WAAW,EAAG,QAAO,EAAE;CAC/B,IAAM,IAAU,GAAuB,EACjC,IAAS,IAAI,iBAAiB;AACpC,MAAK,IAAM,KAAM,EAAK,GAAO,OAAO,OAAO,EAAG;AAM9C,SAAQ,MALW,EAA2C;EAC5D;EACA,QAAQ;EACR,MAAM,6BAA6B,EAAO,UAAU;EACrD,CAAC,IACc,EAAE,EAAE,IAAI,EAA2B;;AAmBrD,eAAsB,EACpB,GACmC;AAQnC,QAAO,MANY,EAAyC;EAC1D,SAFc,GAEd;EACA,QAAQ;EACR,MAAM;EACN,MAAM;EACP,CAAC;;AAWJ,eAAsB,EACpB,GACe;AAEf,QAAO,EAAqB;EAC1B,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,6BAA6B,EAAe;EAClD,cAAc;EACf,CAAC;;AAWJ,eAAsB,EACpB,GACe;AAEf,OAAM,EAAwB;EAC5B,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,6BAA6B;EACpC,CAAC;;AAUJ,eAAsB,EACpB,GACA,GAC0B;AAQ1B,QAAO,MANY,EAAgC;EACjD,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,6BAA6B;EACnC,MAAM,EAAE,QAAQ,GAAU;EAC3B,CAAC;;AAWJ,eAAsB,EAAkB,GAAkC;AAExE,OAAM,EAAwB;EAC5B,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,qBAAqB,EAAU;EACtC,CAAC;;AAaJ,eAAsB,EAAmB,GAAkC;AAEzE,OAAM,EAAwB;EAC5B,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,qBAAqB,EAAU;EACtC,CAAC;;AASJ,eAAsB,EACpB,GACA,GACiB;CACjB,IAAM,IAAU,GAAuB,EACjC,IAAS,IAAI,iBAAiB;AAOpC,QANA,EAAO,OAAO,aAAa,EAAS,EAM7B,MALY,EAAuB;EACxC;EACA,QAAQ;EACR,MAAM,6BAA6B,EAAe,QAAQ,EAAO,UAAU;EAC5E,CAAC,IACa;;AAQjB,eAAsB,EACpB,GAC0C;CAC1C,IAAM,IAAU,GAAuB,EACjC,IAAS,IAAI,iBAAiB;AAOpC,QANA,EAAO,IAAI,OAAO,EAAO,GAMlB,MALY,EAAoD;EACrE;EACA,QAAQ;EACR,MAAM,yCAAyC,EAAO,UAAU;EACjE,CAAC,IACY,MAAM"}
+{"version":3,"file":"conversation-service.api.js","names":[],"sources":["../../../src/api/cloud/conversation-service.api.ts"],"sourcesContent":["import { getActiveBackend } from \"../backend-registry/active-store\";\nimport type { Backend } from \"../backend-registry/types\";\nimport { getStoredConversationMetadata } from \"../conversation-metadata-store\";\nimport type {\n  AppConversation,\n  AppConversationPage,\n  AppConversationStartRequest,\n  AppConversationStartTask,\n} from \"../conversation-service/agent-server-conversation-service.types\";\nimport { callCloudProxy } from \"./proxy\";\n\n/**\n * The cloud backend does not always echo `selected_repository` /\n * `selected_branch` / `git_provider` back from\n * `GET /api/v1/app-conversations` until its own background hydration\n * completes. We persist the selection to local storage at connect time\n * (see `AgentServerConversationService.updateConversationRepository`)\n * and overlay it here so the chat-page git control bar reflects the\n * connection immediately, instead of snapping back to the empty\n * \"Connect Repo\" state on every refetch.\n *\n * Server values take precedence whenever they're populated; the\n * local-storage fallback only fills in fields the server returned as\n * `null`/`undefined`.\n */\nfunction overlayStoredRepoSelection(\n  conversation: AppConversation | null,\n): AppConversation | null {\n  if (!conversation?.id) return conversation;\n  const stored = getStoredConversationMetadata(conversation.id);\n  if (!stored) return conversation;\n\n  return {\n    ...conversation,\n    selected_repository:\n      conversation.selected_repository ?? stored.selected_repository ?? null,\n    selected_branch:\n      conversation.selected_branch ?? stored.selected_branch ?? null,\n    git_provider: conversation.git_provider ?? stored.git_provider ?? null,\n    selected_workspace:\n      conversation.selected_workspace ?? stored.selected_workspace ?? null,\n  };\n}\n\nfunction getActiveCloudBackend(): Backend {\n  const active = getActiveBackend().backend;\n  if (active.kind !== \"cloud\") {\n    throw new Error(\"Cloud conversations call requires a cloud backend.\");\n  }\n  return active;\n}\n\n/**\n * Search the cloud app-conversations list. Mirrors the local\n * `AgentServerConversationService.searchConversations` interface but calls\n * the cloud endpoint `/api/v1/app-conversations/search`.\n */\nexport async function searchCloudConversations(\n  limit: number = 20,\n  pageId?: string,\n): Promise<AppConversationPage> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.set(\"limit\", String(limit));\n  if (pageId) params.set(\"page_id\", pageId);\n  params.set(\"sort_order\", \"UPDATED_AT_DESC\");\n\n  const data = await callCloudProxy<{\n    items: AppConversation[];\n    next_page_id: string | null;\n  }>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/search?${params.toString()}`,\n  });\n\n  return {\n    items: (data?.items ?? []).map(\n      (item) => overlayStoredRepoSelection(item) as AppConversation,\n    ),\n    next_page_id: data?.next_page_id ?? null,\n  };\n}\n\n/**\n * Batch-fetch cloud app-conversations by id. Mirrors the local\n * `AgentServerConversationService.batchGetAppConversations` interface.\n */\nexport async function batchGetCloudConversations(\n  ids: string[],\n): Promise<(AppConversation | null)[]> {\n  if (ids.length === 0) return [];\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  for (const id of ids) params.append(\"ids\", id);\n  const data = await callCloudProxy<(AppConversation | null)[]>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations?${params.toString()}`,\n  });\n  return (data ?? []).map(overlayStoredRepoSelection);\n}\n\n/**\n * Create a v1 app-conversation on the cloud backend.\n *\n * Mirrors OpenHands' cloud flow: POST /api/v1/app-conversations with the\n * `AppConversationStartRequest` payload, returning a\n * `AppConversationStartTask`. The task is initially WORKING; the caller\n * polls `getCloudAppConversationStartTask` (3s cadence per OpenHands)\n * until status is READY (then `app_conversation_id`, `agent_server_url`,\n * and `session_api_key` are populated) or ERROR.\n *\n * This path does NOT use encrypted-settings round-tripping. Secrets stay\n * server-side on the cloud backend — the only auth carried is the cloud bearer\n * token, and the conversation runtime is\n * provisioned with its own ephemeral session_api_key returned in the\n * task.\n */\nexport async function createCloudAppConversation(\n  request: AppConversationStartRequest,\n): Promise<AppConversationStartTask> {\n  const backend = getActiveCloudBackend();\n  const data = await callCloudProxy<AppConversationStartTask>({\n    backend,\n    method: \"POST\",\n    path: \"/api/v1/app-conversations\",\n    body: request as unknown as Record<string, unknown>,\n  });\n  return data;\n}\n\n/**\n * Download a v1 app-conversation as a ZIP from the cloud backend. Mirrors\n * the local `AgentServerConversationService.downloadConversation` interface but\n * calls\n * `GET /api/v1/app-conversations/{id}/download`, which returns\n * `application/zip` with `Content-Disposition` set by the cloud backend.\n */\nexport async function downloadCloudConversation(\n  conversationId: string,\n): Promise<Blob> {\n  const backend = getActiveCloudBackend();\n  return callCloudProxy<Blob>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/${conversationId}/download`,\n    responseType: \"blob\",\n  });\n}\n\n/**\n * Delete a v1 app-conversation on the cloud backend. Mirrors the local\n * `AgentServerConversationService.deleteConversation` interface but calls\n * `DELETE /api/v1/app-conversations/{id}`, which returns a JSON\n * `Success` envelope (discarded here — the caller only needs to know\n * the request didn't error).\n */\nexport async function deleteCloudConversation(\n  conversationId: string,\n): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"DELETE\",\n    path: `/api/v1/app-conversations/${conversationId}`,\n  });\n}\n\n/**\n * Toggle the public-sharing flag on a cloud v1 app-conversation. Mirrors\n * OpenHands' `AgentServerConversationService.updateConversationPublicFlag`:\n * `PATCH /api/v1/app-conversations/{id}` with `{ public }`, returning\n * the updated conversation.\n */\nexport async function updateCloudConversationPublicFlag(\n  conversationId: string,\n  isPublic: boolean,\n): Promise<AppConversation> {\n  const backend = getActiveCloudBackend();\n  const data = await callCloudProxy<AppConversation>({\n    backend,\n    method: \"PATCH\",\n    path: `/api/v1/app-conversations/${conversationId}`,\n    body: { public: isPublic },\n  });\n  return data;\n}\n\n/**\n * Pause the cloud sandbox backing a v1 app-conversation. Mirrors\n * OpenHands' `SandboxService.pauseSandbox`:\n * `POST /api/v1/sandboxes/{sandboxId}/pause` on the cloud backend, which stops\n * the runtime owning the conversation.\n */\nexport async function pauseCloudSandbox(sandboxId: string): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"POST\",\n    path: `/api/v1/sandboxes/${sandboxId}/pause`,\n  });\n}\n\n/**\n * Resume a paused cloud sandbox. Mirrors OpenHands' `SandboxService.resumeSandbox`\n * by calling `POST /api/v1/sandboxes/{sandboxId}/resume` on the SaaS.\n *\n * This is the correct endpoint for waking a PAUSED sandbox. It is a\n * lightweight unpause — NOT the same as creating a new start task via\n * `POST /api/v1/app-conversations`, which provisions a fresh conversation\n * and is subject to the 120-second sandbox-start timeout.\n */\nexport async function resumeCloudSandbox(sandboxId: string): Promise<void> {\n  const backend = getActiveCloudBackend();\n  await callCloudProxy<unknown>({\n    backend,\n    method: \"POST\",\n    path: `/api/v1/sandboxes/${sandboxId}/resume`,\n  });\n}\n\n/**\n * Read a file from a cloud conversation's sandbox workspace. Mirrors\n * OpenHands' `AgentServerConversationService.readConversationFile` — hits\n * `GET /api/v1/app-conversations/{id}/file?file_path=...` on the cloud backend\n * and returns the file content as a string.\n */\nexport async function readCloudConversationFile(\n  conversationId: string,\n  filePath: string,\n): Promise<string> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.append(\"file_path\", filePath);\n  const data = await callCloudProxy<string>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/${conversationId}/file?${params.toString()}`,\n  });\n  return data ?? \"\";\n}\n\n/**\n * Fetch a single v1 app-conversation start task. Mirrors OpenHands'\n * `AgentServerConversationService.getStartTask` — uses the batch search endpoint\n * with a single id and unwraps the first result.\n */\nexport async function getCloudAppConversationStartTask(\n  taskId: string,\n): Promise<AppConversationStartTask | null> {\n  const backend = getActiveCloudBackend();\n  const params = new URLSearchParams();\n  params.set(\"ids\", taskId);\n  const data = await callCloudProxy<(AppConversationStartTask | null)[]>({\n    backend,\n    method: \"GET\",\n    path: `/api/v1/app-conversations/start-tasks?${params.toString()}`,\n  });\n  return data?.[0] ?? null;\n}\n"],"mappings":";;;;AAyBA,SAAS,EACP,GACwB;AACxB,KAAI,CAAC,GAAc,GAAI,QAAO;CAC9B,IAAM,IAAS,EAA8B,EAAa,GAAG;AAG7D,QAFK,IAEE;EACL,GAAG;EACH,qBACE,EAAa,uBAAuB,EAAO,uBAAuB;EACpE,iBACE,EAAa,mBAAmB,EAAO,mBAAmB;EAC5D,cAAc,EAAa,gBAAgB,EAAO,gBAAgB;EAClE,oBACE,EAAa,sBAAsB,EAAO,sBAAsB;EACnE,GAXmB;;AActB,SAAS,IAAiC;CACxC,IAAM,IAAS,GAAkB,CAAC;AAClC,KAAI,EAAO,SAAS,QAClB,OAAU,MAAM,qDAAqD;AAEvE,QAAO;;AAQT,eAAsB,EACpB,IAAgB,IAChB,GAC8B;CAC9B,IAAM,IAAU,GAAuB,EACjC,IAAS,IAAI,iBAAiB;AAGpC,CAFA,EAAO,IAAI,SAAS,OAAO,EAAM,CAAC,EAC9B,KAAQ,EAAO,IAAI,WAAW,EAAO,EACzC,EAAO,IAAI,cAAc,kBAAkB;CAE3C,IAAM,IAAO,MAAM,EAGhB;EACD;EACA,QAAQ;EACR,MAAM,oCAAoC,EAAO,UAAU;EAC5D,CAAC;AAEF,QAAO;EACL,QAAQ,GAAM,SAAS,EAAE,EAAE,KACxB,MAAS,EAA2B,EAAK,CAC3C;EACD,cAAc,GAAM,gBAAgB;EACrC;;AAOH,eAAsB,EACpB,GACqC;AACrC,KAAI,EAAI,WAAW,EAAG,QAAO,EAAE;CAC/B,IAAM,IAAU,GAAuB,EACjC,IAAS,IAAI,iBAAiB;AACpC,MAAK,IAAM,KAAM,EAAK,GAAO,OAAO,OAAO,EAAG;AAM9C,SAAQ,MALW,EAA2C;EAC5D;EACA,QAAQ;EACR,MAAM,6BAA6B,EAAO,UAAU;EACrD,CAAC,IACc,EAAE,EAAE,IAAI,EAA2B;;AAmBrD,eAAsB,EACpB,GACmC;AAQnC,QAAO,MANY,EAAyC;EAC1D,SAFc,GAEd;EACA,QAAQ;EACR,MAAM;EACN,MAAM;EACP,CAAC;;AAWJ,eAAsB,EACpB,GACe;AAEf,QAAO,EAAqB;EAC1B,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,6BAA6B,EAAe;EAClD,cAAc;EACf,CAAC;;AAUJ,eAAsB,EACpB,GACe;AAEf,OAAM,EAAwB;EAC5B,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,6BAA6B;EACpC,CAAC;;AASJ,eAAsB,EACpB,GACA,GAC0B;AAQ1B,QAAO,MANY,EAAgC;EACjD,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,6BAA6B;EACnC,MAAM,EAAE,QAAQ,GAAU;EAC3B,CAAC;;AAUJ,eAAsB,EAAkB,GAAkC;AAExE,OAAM,EAAwB;EAC5B,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,qBAAqB,EAAU;EACtC,CAAC;;AAYJ,eAAsB,EAAmB,GAAkC;AAEzE,OAAM,EAAwB;EAC5B,SAFc,GAEd;EACA,QAAQ;EACR,MAAM,qBAAqB,EAAU;EACtC,CAAC;;AASJ,eAAsB,EACpB,GACA,GACiB;CACjB,IAAM,IAAU,GAAuB,EACjC,IAAS,IAAI,iBAAiB;AAOpC,QANA,EAAO,OAAO,aAAa,EAAS,EAM7B,MALY,EAAuB;EACxC;EACA,QAAQ;EACR,MAAM,6BAA6B,EAAe,QAAQ,EAAO,UAAU;EAC5E,CAAC,IACa;;AAQjB,eAAsB,EACpB,GAC0C;CAC1C,IAAM,IAAU,GAAuB,EACjC,IAAS,IAAI,iBAAiB;AAOpC,QANA,EAAO,IAAI,OAAO,EAAO,GAMlB,MALY,EAAoD;EACrE;EACA,QAAQ;EACR,MAAM,yCAAyC,EAAO,UAAU;EACjE,CAAC,IACY,MAAM"}

package/dist/api/cloud/organization-service.api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"organization-service.api.cjs","names":[],"sources":["../../../src/api/cloud/organization-service.api.ts"],"sourcesContent":["import axios from \"axios\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport type { Backend } from \"../backend-registry/types\";\nimport { callCloudProxy } from \"./proxy\";\nimport type {\n  CloudApiKeyMetadata,\n  CloudOrganization,\n  CloudOrganizationsResponse,\n} from \"./types\";\n\ninterface OrganizationsResult {\n  items: CloudOrganization[];\n  currentOrgId: string | null;\n}\n\nfunction normalizeResult(\n  data: CloudOrganizationsResponse | undefined | null,\n): OrganizationsResult {\n  return {\n    items: data?.items ?? [],\n    currentOrgId: data?.current_org_id ?? null,\n  };\n}\n\nfunction resolveBackend(backend?: Backend): Backend {\n  if (backend) return backend;\n  const active = getActiveBackend().backend;\n  if (active.kind !== \"cloud\") {\n    throw new Error(\n      \"Cloud organization calls require a cloud backend. Active backend is local.\",\n    );\n  }\n  return active;\n}\n\n/**\n * Fetch the org list for a cloud backend. With no argument, uses the active\n * cloud backend; pass `backend` explicitly to fetch for an inactive cloud\n * (used by the selector to flatten all cloud rows).\n *\n * Routed through the bundled agent-server's `/api/cloud-proxy` to avoid\n * cross-origin browser calls.\n */\nexport async function getCloudOrganizations(\n  backend?: Backend,\n): Promise<OrganizationsResult> {\n  const target = resolveBackend(backend);\n  const data = await callCloudProxy<CloudOrganizationsResponse>({\n    backend: target,\n    method: \"GET\",\n    path: \"/api/organizations\",\n  });\n  return normalizeResult(data);\n}\n\n/**\n * Fetch metadata for the API key used to authenticate this cloud backend.\n * The returned `orgId` is the single org the key is authorized to act on\n * (the cloud contract: one key → one org).\n *\n * Legacy keys minted before per-key org binding existed cause the upstream\n * to return HTTP 400 — we surface that as `isLegacyKey: true` with a null\n * `orgId` so the caller can fall back to the unfiltered behavior. Other\n * statuses (401 revoked, 5xx outage) propagate so React Query can mark\n * the query as failed and the selector can render the no-org-known row.\n */\nexport async function getCurrentCloudApiKey(\n  backend?: Backend,\n): Promise<{ orgId: string | null; isLegacyKey: boolean }> {\n  const target = resolveBackend(backend);\n  try {\n    const data = await callCloudProxy<CloudApiKeyMetadata>({\n      backend: target,\n      method: \"GET\",\n      path: \"/api/keys/current\",\n    });\n    return { orgId: data?.org_id ?? null, isLegacyKey: false };\n  } catch (e) {\n    if (axios.isAxiosError(e) && e.response?.status === 400) {\n      return { orgId: null, isLegacyKey: true };\n    }\n    throw e;\n  }\n}\n\n/**\n * Fetch `GET /api/organizations/{orgId}/me`. Identifies the calling user as\n * a member of `orgId`. The GUI uses `me.org_id === me.user_id` to decide\n * whether `orgId` is the user's personal workspace — that's the cloud\n * contract (the auto-generated personal-workspace org has the same id as\n * the user).\n */\nexport async function getCloudOrganizationMe(\n  orgId: string,\n  backend?: Backend,\n): Promise<{ orgId: string; userId: string }> {\n  const target = resolveBackend(backend);\n  const data = await callCloudProxy<{ org_id: string; user_id: string }>({\n    backend: target,\n    method: \"GET\",\n    path: `/api/organizations/${encodeURIComponent(orgId)}/me`,\n  });\n  return {\n    orgId: data?.org_id ?? orgId,\n    userId: data?.user_id ?? \"\",\n  };\n}\n"],"mappings":"qLAeA,SAAS,EACP,EACqB,CACrB,MAAO,CACL,MAAO,GAAM,OAAS,EAAE,CACxB,aAAc,GAAM,gBAAkB,KACvC,CAGH,SAAS,EAAe,EAA4B,CAClD,GAAI,EAAS,OAAO,EACpB,IAAM,EAAS,EAAA,kBAAkB,CAAC,QAClC,GAAI,EAAO,OAAS,QAClB,MAAU,MACR,6EACD,CAEH,OAAO,EAWT,eAAsB,EACpB,EAC8B,CAO9B,OAAO,EAAgB,MALJ,EAAA,eAA2C,CAC5D,QAFa,EAAe,EAEnB,CACT,OAAQ,MACR,KAAM,qBACP,CAAC,CAC0B,CAc9B,eAAsB,EACpB,EACyD,CACzD,IAAM,EAAS,EAAe,EAAQ,CACtC,GAAI,CAMF,MAAO,CAAE,OAAO,MALG,EAAA,eAAoC,CACrD,QAAS,EACT,OAAQ,MACR,KAAM,oBACP,CAAC,GACoB,QAAU,KAAM,YAAa,GAAO,OACnD,EAAG,CACV,GAAI,EAAA,QAAM,aAAa,EAAE,EAAI,EAAE,UAAU,SAAW,IAClD,MAAO,CAAE,MAAO,KAAM,YAAa,GAAM,CAE3C,MAAM,GAWV,eAAsB,EACpB,EACA,EAC4C,CAE5C,IAAM,EAAO,MAAM,EAAA,eAAoD,CACrE,QAFa,EAAe,EAEnB,CACT,OAAQ,MACR,KAAM,sBAAsB,mBAAmB,EAAM,CAAC,KACvD,CAAC,CACF,MAAO,CACL,MAAO,GAAM,QAAU,EACvB,OAAQ,GAAM,SAAW,GAC1B"}
+{"version":3,"file":"organization-service.api.cjs","names":[],"sources":["../../../src/api/cloud/organization-service.api.ts"],"sourcesContent":["import axios from \"axios\";\nimport { getActiveBackend } from \"../backend-registry/active-store\";\nimport type { Backend } from \"../backend-registry/types\";\nimport { callCloudProxy } from \"./proxy\";\nimport type {\n  CloudApiKeyMetadata,\n  CloudOrganization,\n  CloudOrganizationsResponse,\n} from \"./types\";\n\ninterface OrganizationsResult {\n  items: CloudOrganization[];\n  currentOrgId: string | null;\n}\n\nfunction normalizeResult(\n  data: CloudOrganizationsResponse | undefined | null,\n): OrganizationsResult {\n  return {\n    items: data?.items ?? [],\n    currentOrgId: data?.current_org_id ?? null,\n  };\n}\n\nfunction resolveBackend(backend?: Backend): Backend {\n  if (backend) return backend;\n  const active = getActiveBackend().backend;\n  if (active.kind !== \"cloud\") {\n    throw new Error(\n      \"Cloud organization calls require a cloud backend. Active backend is local.\",\n    );\n  }\n  return active;\n}\n\n/**\n * Fetch the org list for a cloud backend. With no argument, uses the active\n * cloud backend; pass `backend` explicitly to fetch for an inactive cloud\n * (used by the selector to flatten all cloud rows).\n *\n * Calls the cloud API directly with the backend's bearer token.\n */\nexport async function getCloudOrganizations(\n  backend?: Backend,\n): Promise<OrganizationsResult> {\n  const target = resolveBackend(backend);\n  const data = await callCloudProxy<CloudOrganizationsResponse>({\n    backend: target,\n    method: \"GET\",\n    path: \"/api/organizations\",\n  });\n  return normalizeResult(data);\n}\n\n/**\n * Fetch metadata for the API key used to authenticate this cloud backend.\n * The returned `orgId` is the single org the key is authorized to act on\n * (the cloud contract: one key → one org).\n *\n * Legacy keys minted before per-key org binding existed cause the upstream\n * to return HTTP 400 — we surface that as `isLegacyKey: true` with a null\n * `orgId` so the caller can fall back to the unfiltered behavior. Other\n * statuses (401 revoked, 5xx outage) propagate so React Query can mark\n * the query as failed and the selector can render the no-org-known row.\n */\nexport async function getCurrentCloudApiKey(\n  backend?: Backend,\n): Promise<{ orgId: string | null; isLegacyKey: boolean }> {\n  const target = resolveBackend(backend);\n  try {\n    const data = await callCloudProxy<CloudApiKeyMetadata>({\n      backend: target,\n      method: \"GET\",\n      path: \"/api/keys/current\",\n    });\n    return { orgId: data?.org_id ?? null, isLegacyKey: false };\n  } catch (e) {\n    if (axios.isAxiosError(e) && e.response?.status === 400) {\n      return { orgId: null, isLegacyKey: true };\n    }\n    throw e;\n  }\n}\n\n/**\n * Fetch `GET /api/organizations/{orgId}/me`. Identifies the calling user as\n * a member of `orgId`. The GUI uses `me.org_id === me.user_id` to decide\n * whether `orgId` is the user's personal workspace — that's the cloud\n * contract (the auto-generated personal-workspace org has the same id as\n * the user).\n */\nexport async function getCloudOrganizationMe(\n  orgId: string,\n  backend?: Backend,\n): Promise<{ orgId: string; userId: string }> {\n  const target = resolveBackend(backend);\n  const data = await callCloudProxy<{ org_id: string; user_id: string }>({\n    backend: target,\n    method: \"GET\",\n    path: `/api/organizations/${encodeURIComponent(orgId)}/me`,\n  });\n  return {\n    orgId: data?.org_id ?? orgId,\n    userId: data?.user_id ?? \"\",\n  };\n}\n"],"mappings":"qLAeA,SAAS,EACP,EACqB,CACrB,MAAO,CACL,MAAO,GAAM,OAAS,EAAE,CACxB,aAAc,GAAM,gBAAkB,KACvC,CAGH,SAAS,EAAe,EAA4B,CAClD,GAAI,EAAS,OAAO,EACpB,IAAM,EAAS,EAAA,kBAAkB,CAAC,QAClC,GAAI,EAAO,OAAS,QAClB,MAAU,MACR,6EACD,CAEH,OAAO,EAUT,eAAsB,EACpB,EAC8B,CAO9B,OAAO,EAAgB,MALJ,EAAA,eAA2C,CAC5D,QAFa,EAAe,EAEnB,CACT,OAAQ,MACR,KAAM,qBACP,CAAC,CAC0B,CAc9B,eAAsB,EACpB,EACyD,CACzD,IAAM,EAAS,EAAe,EAAQ,CACtC,GAAI,CAMF,MAAO,CAAE,OAAO,MALG,EAAA,eAAoC,CACrD,QAAS,EACT,OAAQ,MACR,KAAM,oBACP,CAAC,GACoB,QAAU,KAAM,YAAa,GAAO,OACnD,EAAG,CACV,GAAI,EAAA,QAAM,aAAa,EAAE,EAAI,EAAE,UAAU,SAAW,IAClD,MAAO,CAAE,MAAO,KAAM,YAAa,GAAM,CAE3C,MAAM,GAWV,eAAsB,EACpB,EACA,EAC4C,CAE5C,IAAM,EAAO,MAAM,EAAA,eAAoD,CACrE,QAFa,EAAe,EAEnB,CACT,OAAQ,MACR,KAAM,sBAAsB,mBAAmB,EAAM,CAAC,KACvD,CAAC,CACF,MAAO,CACL,MAAO,GAAM,QAAU,EACvB,OAAQ,GAAM,SAAW,GAC1B"}

package/dist/api/cloud/organization-service.api.d.ts

@@ -9,8 +9,7 @@ interface OrganizationsResult {
  * cloud backend; pass `backend` explicitly to fetch for an inactive cloud
  * (used by the selector to flatten all cloud rows).
  *
- * Routed through the bundled agent-server's `/api/cloud-proxy` to avoid
- * cross-origin browser calls.
+ * Calls the cloud API directly with the backend's bearer token.
  */
 export declare function getCloudOrganizations(backend?: Backend): Promise<OrganizationsResult>;
 /**