@openhands/agent-canvas 1.9.0 → 1.11.0

package/dist/api/automation-service/automation-service.api.js.map

@@ -1 +1 @@
-{"version":3,"file":"automation-service.api.js","names":[],"sources":["../../../src/api/automation-service/automation-service.api.ts"],"sourcesContent":["import axios from \"axios\";\nimport {\n  clearPendingLocalTelemetryRevocation,\n  getTelemetryConsent,\n  getTelemetryDistinctId,\n  getTelemetryDistinctIdForConsentSync,\n  type TelemetryConsent,\n} from \"#/services/telemetry\";\nimport type {\n  Automation,\n  AutomationRun,\n  AutomationSpec,\n  AutomationTrigger,\n  AutomationsResponse,\n  AutomationRunsResponse,\n} from \"#/types/automation\";\nimport { AUTOMATION_CREATE_ENDPOINT } from \"#/manifests/automation-setup\";\nimport {\n  getAutomationEndpoint,\n  getAutomationIdEndpoint,\n  getImportExportSpec,\n} from \"#/manifests/automation-interface\";\nimport type {\n  DeploymentCapabilities,\n  SetupRequestBody,\n  ValidateDraftResponse,\n} from \"#/manifests/types\";\nimport type { Backend, ResolvedActiveBackend } from \"../backend-registry/types\";\nimport {\n  getActiveBackend,\n  getEffectiveLocalBackend,\n} from \"../backend-registry/active-store\";\nimport { NoBackendAvailableError } from \"../agent-server-client-options\";\nimport { callCloudProxy } from \"../cloud/proxy\";\nimport {\n  AGENT_CANVAS_CLIENT_HEADERS,\n  OPENHANDS_TELEMETRY_DISTINCT_ID_HEADER,\n} from \"../client-source\";\n\nconst AUTOMATION_BASE_PATH = \"/api/automation\";\n\nexport interface AutomationHealthResponse {\n  status: \"ok\" | \"error\";\n  message?: string;\n}\n\ntype AutomationSdkVersionResponse =\n  | string\n  | {\n      sdk_version?: unknown;\n      version?: unknown;\n    };\n\n// Local automation calls go to the automation sidecar that\n// `scripts/dev-with-automation.mjs` mounts behind the local agent-server.\n// Both backends use the same session API key and the same `X-Session-API-Key`\n// header for consistency.\nconst localAutomationAxios = axios.create();\n\nasync function buildAutomationRequestHeaders(\n  extraHeaders: Record<string, string> = {},\n): Promise<Record<string, string>> {\n  const telemetryDistinctId = await getTelemetryDistinctId();\n  return {\n    ...AGENT_CANVAS_CLIENT_HEADERS,\n    ...(telemetryDistinctId\n      ? { [OPENHANDS_TELEMETRY_DISTINCT_ID_HEADER]: telemetryDistinctId }\n      : {}),\n    ...extraHeaders,\n  };\n}\n\nlocalAutomationAxios.interceptors.request.use(async (config) => {\n  const requestHeaders = await buildAutomationRequestHeaders();\n  Object.entries(requestHeaders).forEach(([name, value]) => {\n    config.headers.set(name, value);\n  });\n\n  // Import uses an explicit baseURL/header pair so its POST, PATCH, and\n  // cleanup stay pinned to the backend selected when the mutation started.\n  if (config.baseURL) return config;\n\n  // Resolve the local backend on every call so it tracks the\n  // currently-active local backend (and any host/key edits made via the\n  // manage-backends UI), rather than freezing whatever value the\n  // agent-server-config produced at module load time.\n  // Using the backend registry (rather than the build-time VITE_SESSION_API_KEY\n  // env var) ensures the published npm package picks up the runtime-injected\n  // session key that scripts/static-server.mjs seeds into localStorage, fixing\n  // the 401 errors reported in issue #829.\n  const backend = getEffectiveLocalBackend();\n  if (!backend) throw new NoBackendAvailableError();\n  // eslint-disable-next-line no-param-reassign\n  config.baseURL = backend.host;\n\n  const apiKey = backend.apiKey?.trim();\n  if (apiKey) {\n    config.headers.set(\"X-Session-API-Key\", apiKey);\n  }\n  return config;\n});\n\nfunction normalizeAutomationSdkVersion(version: unknown): string | null {\n  if (typeof version !== \"string\") return null;\n  const trimmed = version.trim();\n  return trimmed || null;\n}\n\nfunction getAutomationSdkVersionFromResponse(\n  response: AutomationSdkVersionResponse,\n): string | null {\n  if (typeof response === \"string\") {\n    return normalizeAutomationSdkVersion(response);\n  }\n  return (\n    normalizeAutomationSdkVersion(response.sdk_version) ??\n    normalizeAutomationSdkVersion(response.version)\n  );\n}\n\nfunction buildPaginationQuery(limit: number, offset: number): string {\n  const params = new URLSearchParams();\n  params.set(\"limit\", String(limit));\n  params.set(\"offset\", String(offset));\n  return params.toString();\n}\n\nfunction buildImportedTrigger(spec: AutomationSpec): AutomationTrigger {\n  if (spec.trigger.type === \"event\") {\n    return {\n      type: \"event\",\n      source: spec.trigger.source,\n      on: spec.trigger.on,\n      ...(spec.trigger.filter && { filter: spec.trigger.filter }),\n    };\n  }\n\n  return {\n    type: \"cron\",\n    schedule: spec.trigger.schedule,\n    timezone: spec.timezone ?? spec.trigger.timezone ?? \"UTC\",\n  };\n}\n\nfunction generatePendingImportEvent(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return `pending.${crypto.randomUUID()}`;\n  }\n  return `pending.${Date.now()}.${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction buildCreateAutomationRequest(spec: AutomationSpec) {\n  if (!spec.prompt) {\n    throw new Error(\"An automation prompt is required for import.\");\n  }\n\n  const { importDefaults } = getImportExportSpec();\n  const repos = spec.repository\n    ? [\n        {\n          url: spec.repository,\n          ...(spec.branch && { ref: spec.branch }),\n          ...(!spec.repository.includes(\"://\") &&\n            !spec.repository.startsWith(\"git@\") && {\n              provider: importDefaults.repoProvider,\n            }),\n        },\n      ]\n    : undefined;\n\n  return {\n    path: `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\n      spec.plugins?.length ? \"createPlugin\" : \"createPrompt\",\n    )}`,\n    body: {\n      name: spec.name,\n      prompt: spec.prompt,\n      // Preset creation defaults to enabled. A unique event trigger keeps the\n      // new record inert until the real trigger and disabled state are applied\n      // together in the follow-up PATCH.\n      trigger: {\n        type: \"event\",\n        source: importDefaults.placeholderEventSource,\n        on: generatePendingImportEvent(),\n      },\n      ...(spec.model && { model: spec.model }),\n      ...(repos && { repos }),\n      ...(spec.plugins?.length && {\n        plugins: spec.plugins.map((source) => ({ source })),\n      }),\n      ...(spec.timeout != null && { timeout: spec.timeout }),\n    },\n  };\n}\n\nasync function buildPinnedLocalConfig(backend: Backend) {\n  const apiKey = backend.apiKey.trim();\n  return {\n    baseURL: backend.host,\n    headers: await buildAutomationRequestHeaders(\n      apiKey ? { \"X-Session-API-Key\": apiKey } : {},\n    ),\n  };\n}\n\nasync function buildPinnedCloudHeaders(active: ResolvedActiveBackend) {\n  return buildAutomationRequestHeaders(\n    active.orgId ? { \"X-Org-Id\": active.orgId } : {},\n  );\n}\n\nclass AutomationService {\n  static async syncTelemetryConsent(\n    consent: TelemetryConsent = getTelemetryConsent(),\n  ): Promise<void> {\n    const active = getActiveBackend();\n    if (active.backend.kind !== \"local\") return;\n\n    const frontendDistinctId = await getTelemetryDistinctIdForConsentSync();\n    await localAutomationAxios.post(\n      `${AUTOMATION_BASE_PATH}/v1/telemetry/consent`,\n      {\n        consent_granted: consent === \"granted\",\n        frontend_distinct_id: frontendDistinctId,\n      },\n      { timeout: 5000 },\n    );\n    if (consent !== \"granted\" && frontendDistinctId) {\n      clearPendingLocalTelemetryRevocation(frontendDistinctId);\n    }\n  }\n\n  static async getSdkVersion(): Promise<string | null> {\n    const active = getActiveBackend();\n    const path = `${AUTOMATION_BASE_PATH}/sdk-version`;\n\n    try {\n      let response: AutomationSdkVersionResponse;\n      if (active.backend.kind === \"cloud\") {\n        response = await callCloudProxy<AutomationSdkVersionResponse>({\n          backend: active.backend,\n          method: \"GET\",\n          path,\n          headers: await buildPinnedCloudHeaders(active),\n          timeoutSeconds: 5,\n        });\n      } else {\n        const { data } =\n          await localAutomationAxios.get<AutomationSdkVersionResponse>(path, {\n            timeout: 5000,\n          });\n        response = data;\n      }\n\n      return getAutomationSdkVersionFromResponse(response);\n    } catch {\n      return null;\n    }\n  }\n\n  static async listAutomations(\n    params: { limit?: number; offset?: number } = {},\n  ): Promise<AutomationsResponse> {\n    const { limit = 50, offset = 0 } = params;\n    const active = getActiveBackend().backend;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<AutomationsResponse>({\n        backend: active,\n        method: \"GET\",\n        path: `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"list\")}?${buildPaginationQuery(limit, offset)}`,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.get<AutomationsResponse>(\n      `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"list\")}`,\n      { params: { limit, offset } },\n    );\n    return data;\n  }\n\n  static async getAutomations(\n    limit = 50,\n    offset = 0,\n  ): Promise<AutomationsResponse> {\n    return AutomationService.listAutomations({ limit, offset });\n  }\n\n  static async getAutomation(id: string): Promise<Automation> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"detail\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<Automation>({\n        backend: active,\n        method: \"GET\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.get<Automation>(path);\n    return data;\n  }\n\n  static async createAutomation(spec: AutomationSpec): Promise<Automation> {\n    const active = getActiveBackend();\n    const { path, body } = buildCreateAutomationRequest(spec);\n\n    let created: Automation;\n    if (active.backend.kind === \"cloud\") {\n      created = await callCloudProxy<Automation>({\n        backend: active.backend,\n        method: \"POST\",\n        path,\n        body,\n        headers: await buildPinnedCloudHeaders(active),\n      });\n    } else {\n      const { data } = await localAutomationAxios.post<Automation>(\n        path,\n        body,\n        await buildPinnedLocalConfig(active.backend),\n      );\n      created = data;\n    }\n\n    const updatePath = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"detail\", created.id)}`;\n    const updateBody: Partial<Automation> = {\n      trigger: buildImportedTrigger(spec),\n      enabled: false,\n    };\n\n    try {\n      if (active.backend.kind === \"cloud\") {\n        return await callCloudProxy<Automation>({\n          backend: active.backend,\n          method: \"PATCH\",\n          path: updatePath,\n          body: updateBody,\n          headers: await buildPinnedCloudHeaders(active),\n        });\n      }\n\n      const { data } = await localAutomationAxios.patch<Automation>(\n        updatePath,\n        updateBody,\n        await buildPinnedLocalConfig(active.backend),\n      );\n      return data;\n    } catch (updateError) {\n      try {\n        if (active.backend.kind === \"cloud\") {\n          await callCloudProxy<unknown>({\n            backend: active.backend,\n            method: \"DELETE\",\n            path: updatePath,\n            headers: await buildPinnedCloudHeaders(active),\n          });\n        } else {\n          await localAutomationAxios.delete(\n            updatePath,\n            await buildPinnedLocalConfig(active.backend),\n          );\n        }\n      } catch (cleanupError) {\n        throw new AggregateError(\n          [updateError, cleanupError],\n          \"Failed to disable the imported automation and clean it up.\",\n        );\n      }\n      throw updateError;\n    }\n  }\n\n  static async updateAutomation(\n    id: string,\n    body: Partial<Automation>,\n  ): Promise<Automation> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"detail\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<Automation>({\n        backend: active,\n        method: \"PATCH\",\n        path,\n        body: body as Record<string, unknown>,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.patch<Automation>(path, body);\n    return data;\n  }\n\n  static async deleteAutomation(id: string): Promise<void> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"detail\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      await callCloudProxy<unknown>({\n        backend: active,\n        method: \"DELETE\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n      return;\n    }\n\n    await localAutomationAxios.delete(path);\n  }\n\n  static async dispatchAutomation(id: string): Promise<AutomationRun> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"dispatch\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<AutomationRun>({\n        backend: active,\n        method: \"POST\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.post<AutomationRun>(path);\n    return data;\n  }\n\n  static async listAutomationRuns(\n    id: string,\n    params: { limit?: number; offset?: number } = {},\n  ): Promise<AutomationRunsResponse> {\n    const { limit = 50, offset = 0 } = params;\n    const active = getActiveBackend().backend;\n    const basePath = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"runs\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<AutomationRunsResponse>({\n        backend: active,\n        method: \"GET\",\n        path: `${basePath}?${buildPaginationQuery(limit, offset)}`,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.get<AutomationRunsResponse>(\n      basePath,\n      { params: { limit, offset } },\n    );\n    return data;\n  }\n\n  static async getAutomationRuns(\n    id: string,\n    limit = 50,\n    offset = 0,\n  ): Promise<AutomationRunsResponse> {\n    return AutomationService.listAutomationRuns(id, { limit, offset });\n  }\n\n  static async toggleAutomation(\n    id: string,\n    enabled: boolean,\n  ): Promise<Automation> {\n    return AutomationService.updateAutomation(id, { enabled });\n  }\n\n  static async downloadTarball(id: string, name: string): Promise<void> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"tarball\", id)}`;\n\n    let blob: Blob;\n    if (active.kind === \"cloud\") {\n      blob = await callCloudProxy<Blob>({\n        backend: active,\n        method: \"GET\",\n        path,\n        responseType: \"blob\",\n        headers: await buildAutomationRequestHeaders(),\n      });\n    } else {\n      const { data } = await localAutomationAxios.get<Blob>(path, {\n        responseType: \"blob\",\n      });\n      blob = data;\n    }\n\n    const url = URL.createObjectURL(blob);\n    const a = document.createElement(\"a\");\n    a.href = url;\n    a.download = `${name}.tar`;\n    a.click();\n    URL.revokeObjectURL(url);\n  }\n\n  /**\n   * Ask what this deployment supports, before a setup form renders.\n   *\n   * The setup endpoints answer a contract authored in `OpenHands/extensions`,\n   * so their bodies are camelCase where the rest of this service is snake_case.\n   */\n  static async getCapabilities(): Promise<DeploymentCapabilities> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"capabilities\")}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<DeploymentCapabilities>({\n        backend: active,\n        method: \"GET\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } =\n      await localAutomationAxios.get<DeploymentCapabilities>(path);\n    return data;\n  }\n\n  /**\n   * Validate a draft without creating it. An invalid draft is a 200 carrying\n   * field-addressed errors; only a malformed envelope is a 4xx.\n   */\n  static async validateDraft(\n    body: SetupRequestBody,\n  ): Promise<ValidateDraftResponse> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"validate\")}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<ValidateDraftResponse>({\n        backend: active,\n        method: \"POST\",\n        path,\n        body,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.post<ValidateDraftResponse>(\n      path,\n      body,\n    );\n    return data;\n  }\n\n  /**\n   * Create from a draft a setup form derived. Unlike {@link\n   * AutomationService.createAutomation}, which exists for import and has to\n   * park the record on a placeholder trigger, this sends the finished record in\n   * one request.\n   */\n  static async createAutomationDraft(\n    body: SetupRequestBody,\n  ): Promise<Record<string, unknown>> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${AUTOMATION_CREATE_ENDPOINT}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<Record<string, unknown>>({\n        backend: active,\n        method: \"POST\",\n        path,\n        body,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.post<Record<string, unknown>>(\n      path,\n      body,\n    );\n    return data;\n  }\n\n  static async checkHealth(): Promise<AutomationHealthResponse> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"health\")}`;\n\n    try {\n      if (active.kind === \"cloud\") {\n        const response = await callCloudProxy<AutomationHealthResponse>({\n          backend: active,\n          method: \"GET\",\n          path,\n          // Fail fast, matching the local branch's 5s timeout below.\n          timeoutSeconds: 5,\n          headers: await buildAutomationRequestHeaders(),\n        });\n        return response;\n      }\n\n      const { data } = await localAutomationAxios.get<AutomationHealthResponse>(\n        path,\n        { timeout: 5000 },\n      );\n      return data;\n    } catch {\n      return { status: \"error\" };\n    }\n  }\n}\n\nexport default AutomationService;\n"],"mappings":"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"}
+{"version":3,"file":"automation-service.api.js","names":[],"sources":["../../../src/api/automation-service/automation-service.api.ts"],"sourcesContent":["import axios from \"axios\";\nimport {\n  clearPendingLocalTelemetryRevocation,\n  getTelemetryConsent,\n  getTelemetryDistinctId,\n  getTelemetryDistinctIdForConsentSync,\n  type TelemetryConsent,\n} from \"#/services/telemetry\";\nimport type {\n  Automation,\n  AutomationRun,\n  AutomationSpec,\n  AutomationTrigger,\n  AutomationsResponse,\n  AutomationRunsResponse,\n} from \"#/types/automation\";\nimport { AUTOMATION_CREATE_ENDPOINT } from \"#/manifests/automation-setup\";\nimport {\n  getAutomationEndpoint,\n  getAutomationIdEndpoint,\n  getImportExportSpec,\n} from \"#/manifests/automation-interface\";\nimport type {\n  DeploymentCapabilities,\n  SetupRequestBody,\n  ValidateDraftResponse,\n} from \"#/manifests/types\";\nimport type { Backend, ResolvedActiveBackend } from \"../backend-registry/types\";\nimport {\n  getActiveBackend,\n  getEffectiveLocalBackend,\n} from \"../backend-registry/active-store\";\nimport { NoBackendAvailableError } from \"../agent-server-client-options\";\nimport { callCloudProxy } from \"../cloud/proxy\";\nimport {\n  AGENT_CANVAS_CLIENT_HEADERS,\n  OPENHANDS_TELEMETRY_DISTINCT_ID_HEADER,\n} from \"../client-source\";\n\nconst AUTOMATION_BASE_PATH = \"/api/automation\";\n\nexport interface AutomationHealthResponse {\n  status: \"ok\" | \"error\";\n  message?: string;\n}\n\ntype AutomationSdkVersionResponse =\n  | string\n  | {\n      sdk_version?: unknown;\n      version?: unknown;\n    };\n\n// Local automation calls go to the automation sidecar that\n// `scripts/dev-with-automation.mjs` mounts behind the local agent-server.\n// Both backends use the same session API key and the same `X-Session-API-Key`\n// header for consistency.\nconst localAutomationAxios = axios.create();\n\nasync function buildAutomationRequestHeaders(\n  extraHeaders: Record<string, string> = {},\n): Promise<Record<string, string>> {\n  const telemetryDistinctId = await getTelemetryDistinctId();\n  return {\n    ...AGENT_CANVAS_CLIENT_HEADERS,\n    ...(telemetryDistinctId\n      ? { [OPENHANDS_TELEMETRY_DISTINCT_ID_HEADER]: telemetryDistinctId }\n      : {}),\n    ...extraHeaders,\n  };\n}\n\nlocalAutomationAxios.interceptors.request.use(async (config) => {\n  const requestHeaders = await buildAutomationRequestHeaders();\n  Object.entries(requestHeaders).forEach(([name, value]) => {\n    config.headers.set(name, value);\n  });\n\n  // Import uses an explicit baseURL/header pair so its POST, PATCH, and\n  // cleanup stay pinned to the backend selected when the mutation started.\n  if (config.baseURL) return config;\n\n  // Resolve the local backend on every call so it tracks the\n  // currently-active local backend (and any host/key edits made via the\n  // manage-backends UI), rather than freezing whatever value the\n  // agent-server-config produced at module load time.\n  // Using the backend registry (rather than the build-time VITE_SESSION_API_KEY\n  // env var) ensures the published npm package picks up the runtime-injected\n  // session key that scripts/static-server.mjs seeds into localStorage, fixing\n  // the 401 errors reported in issue #829.\n  const backend = getEffectiveLocalBackend();\n  if (!backend) throw new NoBackendAvailableError();\n  // eslint-disable-next-line no-param-reassign\n  config.baseURL = backend.host;\n\n  const apiKey = backend.apiKey?.trim();\n  if (apiKey) {\n    config.headers.set(\"X-Session-API-Key\", apiKey);\n  }\n  return config;\n});\n\nfunction normalizeAutomationSdkVersion(version: unknown): string | null {\n  if (typeof version !== \"string\") return null;\n  const trimmed = version.trim();\n  return trimmed || null;\n}\n\nfunction getAutomationSdkVersionFromResponse(\n  response: AutomationSdkVersionResponse,\n): string | null {\n  if (typeof response === \"string\") {\n    return normalizeAutomationSdkVersion(response);\n  }\n  return (\n    normalizeAutomationSdkVersion(response.sdk_version) ??\n    normalizeAutomationSdkVersion(response.version)\n  );\n}\n\nfunction buildPaginationQuery(limit: number, offset: number): string {\n  const params = new URLSearchParams();\n  params.set(\"limit\", String(limit));\n  params.set(\"offset\", String(offset));\n  return params.toString();\n}\n\nfunction buildImportedTrigger(spec: AutomationSpec): AutomationTrigger {\n  if (spec.trigger.type === \"event\") {\n    return {\n      type: \"event\",\n      source: spec.trigger.source,\n      on: spec.trigger.on,\n      ...(spec.trigger.filter && { filter: spec.trigger.filter }),\n    };\n  }\n\n  return {\n    type: \"cron\",\n    schedule: spec.trigger.schedule,\n    timezone: spec.timezone ?? spec.trigger.timezone ?? \"UTC\",\n  };\n}\n\nfunction generatePendingImportEvent(): string {\n  if (\n    typeof crypto !== \"undefined\" &&\n    typeof crypto.randomUUID === \"function\"\n  ) {\n    return `pending.${crypto.randomUUID()}`;\n  }\n  return `pending.${Date.now()}.${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction buildCreateAutomationRequest(spec: AutomationSpec) {\n  if (!spec.prompt) {\n    throw new Error(\"An automation prompt is required for import.\");\n  }\n\n  const { importDefaults } = getImportExportSpec();\n  const repos = spec.repository\n    ? [\n        {\n          url: spec.repository,\n          ...(spec.branch && { ref: spec.branch }),\n          ...(!spec.repository.includes(\"://\") &&\n            !spec.repository.startsWith(\"git@\") && {\n              provider: importDefaults.repoProvider,\n            }),\n        },\n      ]\n    : undefined;\n\n  return {\n    path: `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\n      spec.plugins?.length ? \"createPlugin\" : \"createPrompt\",\n    )}`,\n    body: {\n      name: spec.name,\n      prompt: spec.prompt,\n      // Preset creation defaults to enabled. A unique event trigger keeps the\n      // new record inert until the real trigger and disabled state are applied\n      // together in the follow-up PATCH.\n      trigger: {\n        type: \"event\",\n        source: importDefaults.placeholderEventSource,\n        on: generatePendingImportEvent(),\n      },\n      ...(spec.model && { model: spec.model }),\n      ...(repos && { repos }),\n      ...(spec.plugins?.length && {\n        plugins: spec.plugins.map((source) => ({ source })),\n      }),\n      ...(spec.timeout != null && { timeout: spec.timeout }),\n    },\n  };\n}\n\nasync function buildPinnedLocalConfig(backend: Backend) {\n  const apiKey = backend.apiKey.trim();\n  return {\n    baseURL: backend.host,\n    headers: await buildAutomationRequestHeaders(\n      apiKey ? { \"X-Session-API-Key\": apiKey } : {},\n    ),\n  };\n}\n\nasync function buildPinnedCloudHeaders(active: ResolvedActiveBackend) {\n  return buildAutomationRequestHeaders(\n    active.orgId ? { \"X-Org-Id\": active.orgId } : {},\n  );\n}\n\nclass AutomationService {\n  static async syncTelemetryConsent(\n    consent: TelemetryConsent = getTelemetryConsent(),\n  ): Promise<void> {\n    const active = getActiveBackend();\n    if (active.backend.kind !== \"local\") return;\n\n    const frontendDistinctId = await getTelemetryDistinctIdForConsentSync();\n    await localAutomationAxios.post(\n      `${AUTOMATION_BASE_PATH}/v1/telemetry/consent`,\n      {\n        consent_granted: consent === \"granted\",\n        frontend_distinct_id: frontendDistinctId,\n      },\n      { timeout: 5000 },\n    );\n    if (consent !== \"granted\" && frontendDistinctId) {\n      clearPendingLocalTelemetryRevocation(frontendDistinctId);\n    }\n  }\n\n  static async getSdkVersion(): Promise<string | null> {\n    const active = getActiveBackend();\n    const path = `${AUTOMATION_BASE_PATH}/sdk-version`;\n\n    try {\n      let response: AutomationSdkVersionResponse;\n      if (active.backend.kind === \"cloud\") {\n        response = await callCloudProxy<AutomationSdkVersionResponse>({\n          backend: active.backend,\n          method: \"GET\",\n          path,\n          headers: await buildPinnedCloudHeaders(active),\n          timeoutSeconds: 5,\n        });\n      } else {\n        const { data } =\n          await localAutomationAxios.get<AutomationSdkVersionResponse>(path, {\n            timeout: 5000,\n          });\n        response = data;\n      }\n\n      return getAutomationSdkVersionFromResponse(response);\n    } catch {\n      return null;\n    }\n  }\n\n  static async listAutomations(\n    params: { limit?: number; offset?: number } = {},\n  ): Promise<AutomationsResponse> {\n    const { limit = 50, offset = 0 } = params;\n    const active = getActiveBackend().backend;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<AutomationsResponse>({\n        backend: active,\n        method: \"GET\",\n        path: `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"list\")}?${buildPaginationQuery(limit, offset)}`,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.get<AutomationsResponse>(\n      `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"list\")}`,\n      { params: { limit, offset } },\n    );\n    return data;\n  }\n\n  static async getAutomations(\n    limit = 50,\n    offset = 0,\n  ): Promise<AutomationsResponse> {\n    return AutomationService.listAutomations({ limit, offset });\n  }\n\n  static async getAutomation(id: string): Promise<Automation> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"detail\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<Automation>({\n        backend: active,\n        method: \"GET\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.get<Automation>(path);\n    return data;\n  }\n\n  static async createAutomation(spec: AutomationSpec): Promise<Automation> {\n    const active = getActiveBackend();\n    const { path, body } = buildCreateAutomationRequest(spec);\n\n    let created: Automation;\n    if (active.backend.kind === \"cloud\") {\n      created = await callCloudProxy<Automation>({\n        backend: active.backend,\n        method: \"POST\",\n        path,\n        body,\n        headers: await buildPinnedCloudHeaders(active),\n      });\n    } else {\n      const { data } = await localAutomationAxios.post<Automation>(\n        path,\n        body,\n        await buildPinnedLocalConfig(active.backend),\n      );\n      created = data;\n    }\n\n    const updatePath = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"detail\", created.id)}`;\n    const updateBody: Partial<Automation> = {\n      trigger: buildImportedTrigger(spec),\n      enabled: false,\n    };\n\n    try {\n      if (active.backend.kind === \"cloud\") {\n        return await callCloudProxy<Automation>({\n          backend: active.backend,\n          method: \"PATCH\",\n          path: updatePath,\n          body: updateBody,\n          headers: await buildPinnedCloudHeaders(active),\n        });\n      }\n\n      const { data } = await localAutomationAxios.patch<Automation>(\n        updatePath,\n        updateBody,\n        await buildPinnedLocalConfig(active.backend),\n      );\n      return data;\n    } catch (updateError) {\n      try {\n        if (active.backend.kind === \"cloud\") {\n          await callCloudProxy<unknown>({\n            backend: active.backend,\n            method: \"DELETE\",\n            path: updatePath,\n            headers: await buildPinnedCloudHeaders(active),\n          });\n        } else {\n          await localAutomationAxios.delete(\n            updatePath,\n            await buildPinnedLocalConfig(active.backend),\n          );\n        }\n      } catch (cleanupError) {\n        throw new AggregateError(\n          [updateError, cleanupError],\n          \"Failed to disable the imported automation and clean it up.\",\n        );\n      }\n      throw updateError;\n    }\n  }\n\n  static async updateAutomation(\n    id: string,\n    body: Partial<Automation>,\n  ): Promise<Automation> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"detail\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<Automation>({\n        backend: active,\n        method: \"PATCH\",\n        path,\n        body: body as Record<string, unknown>,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.patch<Automation>(path, body);\n    return data;\n  }\n\n  static async deleteAutomation(id: string): Promise<void> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"detail\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      await callCloudProxy<unknown>({\n        backend: active,\n        method: \"DELETE\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n      return;\n    }\n\n    await localAutomationAxios.delete(path);\n  }\n\n  static async dispatchAutomation(id: string): Promise<AutomationRun> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"dispatch\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<AutomationRun>({\n        backend: active,\n        method: \"POST\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.post<AutomationRun>(path);\n    return data;\n  }\n\n  /**\n   * Cancel a pending or running automation run.\n   * Backend: POST /api/automation/v1/runs/{run_id}/cancel\n   */\n  static async cancelAutomationRun(runId: string): Promise<AutomationRun> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}/v1/runs/${encodeURIComponent(runId)}/cancel`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<AutomationRun>({\n        backend: active,\n        method: \"POST\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.post<AutomationRun>(path);\n    return data;\n  }\n\n  static async listAutomationRuns(\n    id: string,\n    params: { limit?: number; offset?: number } = {},\n  ): Promise<AutomationRunsResponse> {\n    const { limit = 50, offset = 0 } = params;\n    const active = getActiveBackend().backend;\n    const basePath = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"runs\", id)}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<AutomationRunsResponse>({\n        backend: active,\n        method: \"GET\",\n        path: `${basePath}?${buildPaginationQuery(limit, offset)}`,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.get<AutomationRunsResponse>(\n      basePath,\n      { params: { limit, offset } },\n    );\n    return data;\n  }\n\n  static async getAutomationRuns(\n    id: string,\n    limit = 50,\n    offset = 0,\n  ): Promise<AutomationRunsResponse> {\n    return AutomationService.listAutomationRuns(id, { limit, offset });\n  }\n\n  static async toggleAutomation(\n    id: string,\n    enabled: boolean,\n  ): Promise<Automation> {\n    return AutomationService.updateAutomation(id, { enabled });\n  }\n\n  static async downloadTarball(id: string, name: string): Promise<void> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationIdEndpoint(\"tarball\", id)}`;\n\n    let blob: Blob;\n    if (active.kind === \"cloud\") {\n      blob = await callCloudProxy<Blob>({\n        backend: active,\n        method: \"GET\",\n        path,\n        responseType: \"blob\",\n        headers: await buildAutomationRequestHeaders(),\n      });\n    } else {\n      const { data } = await localAutomationAxios.get<Blob>(path, {\n        responseType: \"blob\",\n      });\n      blob = data;\n    }\n\n    const url = URL.createObjectURL(blob);\n    const a = document.createElement(\"a\");\n    a.href = url;\n    a.download = `${name}.tar`;\n    a.click();\n    URL.revokeObjectURL(url);\n  }\n\n  /**\n   * Ask what this deployment supports, before a setup form renders.\n   *\n   * The setup endpoints answer a contract authored in `OpenHands/extensions`,\n   * so their bodies are camelCase where the rest of this service is snake_case.\n   */\n  static async getCapabilities(): Promise<DeploymentCapabilities> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"capabilities\")}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<DeploymentCapabilities>({\n        backend: active,\n        method: \"GET\",\n        path,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } =\n      await localAutomationAxios.get<DeploymentCapabilities>(path);\n    return data;\n  }\n\n  /**\n   * Validate a draft without creating it. An invalid draft is a 200 carrying\n   * field-addressed errors; only a malformed envelope is a 4xx.\n   */\n  static async validateDraft(\n    body: SetupRequestBody,\n  ): Promise<ValidateDraftResponse> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"validate\")}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<ValidateDraftResponse>({\n        backend: active,\n        method: \"POST\",\n        path,\n        body,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.post<ValidateDraftResponse>(\n      path,\n      body,\n    );\n    return data;\n  }\n\n  /**\n   * Create from a draft a setup form derived. Unlike {@link\n   * AutomationService.createAutomation}, which exists for import and has to\n   * park the record on a placeholder trigger, this sends the finished record in\n   * one request.\n   */\n  static async createAutomationDraft(\n    body: SetupRequestBody,\n  ): Promise<Record<string, unknown>> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${AUTOMATION_CREATE_ENDPOINT}`;\n\n    if (active.kind === \"cloud\") {\n      return callCloudProxy<Record<string, unknown>>({\n        backend: active,\n        method: \"POST\",\n        path,\n        body,\n        headers: await buildAutomationRequestHeaders(),\n      });\n    }\n\n    const { data } = await localAutomationAxios.post<Record<string, unknown>>(\n      path,\n      body,\n    );\n    return data;\n  }\n\n  static async checkHealth(): Promise<AutomationHealthResponse> {\n    const active = getActiveBackend().backend;\n    const path = `${AUTOMATION_BASE_PATH}${getAutomationEndpoint(\"health\")}`;\n\n    try {\n      if (active.kind === \"cloud\") {\n        const response = await callCloudProxy<AutomationHealthResponse>({\n          backend: active,\n          method: \"GET\",\n          path,\n          // Fail fast, matching the local branch's 5s timeout below.\n          timeoutSeconds: 5,\n          headers: await buildAutomationRequestHeaders(),\n        });\n        return response;\n      }\n\n      const { data } = await localAutomationAxios.get<AutomationHealthResponse>(\n        path,\n        { timeout: 5000 },\n      );\n      return data;\n    } catch {\n      return { status: \"error\" };\n    }\n  }\n}\n\nexport default AutomationService;\n"],"mappings":"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"}

package/dist/api/backend-registry/active-store.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("./health-store.cjs"),t=require("./storage.cjs");var n=`no-backend`,r={id:n,name:`No Backend Available`,host:``,apiKey:``,kind:`local`};function i(e){return e.id===n}function a(t){return t.find(t=>t.kind===`local`&&e.getBackendHealthEntry(t.id)?.disabled!==!0)||(t.find(e=>e.kind===`local`)??t[0]??r)}function o(e,t){let n=null,r=null;if(t){let i=e.find(e=>e.id===t.backendId);i&&(n=i,r=t.orgId??null)}return n||(n=a(e),r=null),{backends:e,selection:t,active:{backend:n,orgId:r}}}var s=o(t.readStoredBackends(),t.readStoredActiveBackend()),c=new Set;function l(){c.forEach(e=>e())}function u(){return s.active}function d(){let e=s.active.backend;return e.kind===`local`&&!i(e)?e:null}function f(){return s.backends}function p(){return s.selection}function m(){return s}function h(e){t.writeStoredActiveBackend(e),s=o(s.backends,e),l()}function g(e){t.writeStoredBackends(e);let n=s.selection;n&&!e.some(e=>e.id===n.backendId)&&(n=null,t.writeStoredActiveBackend(null)),s=o(e,n),l()}function _(e){return c.add(e),()=>{c.delete(e)}}exports.NO_BACKEND=r,exports.getActiveBackend=u,exports.getActiveSelection=p,exports.getEffectiveLocalBackend=d,exports.getRegisteredBackends=f,exports.getSnapshot=m,exports.isNoBackend=i,exports.setActiveSelection=h,exports.setRegisteredBackends=g,exports.subscribeActiveBackend=_;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("./health-store.cjs"),t=require("./storage.cjs"),n=require("./url-selection.cjs");var r=`no-backend`,i={id:r,name:`No Backend Available`,host:``,apiKey:``,kind:`local`};function a(e){return e.id===r}function o(t){return t.find(t=>t.kind===`local`&&e.getBackendHealthEntry(t.id)?.disabled!==!0)||(t.find(e=>e.kind===`local`)??t[0]??i)}function s(e,t){let n=null,r=null;if(t){let i=e.find(e=>e.id===t.backendId);i&&(n=i,r=t.orgId??null)}return n||(n=o(e),r=null),{backends:e,selection:t,active:{backend:n,orgId:r}}}function c(e){let r=n.readBackendSelectionFromUrl(e,n.currentLocationSearch());return r?(t.writeStoredActiveBackend(r),r):t.readStoredActiveBackend()}var l=t.readStoredBackends(),u=s(l,c(l)),d=new Set;function f(){d.forEach(e=>e())}function p(){return u.active}function m(){let e=u.active.backend;return e.kind===`local`&&!a(e)?e:null}function h(){return u.backends}function g(){return u.selection}function _(){return u}function v(e){t.writeStoredActiveBackend(e),u=s(u.backends,e),f()}function y(e){t.writeStoredBackends(e);let n=u.selection;n&&!e.some(e=>e.id===n.backendId)&&(n=null,t.writeStoredActiveBackend(null)),u=s(e,n),f()}function b(e){return d.add(e),()=>{d.delete(e)}}exports.NO_BACKEND=i,exports.getActiveBackend=p,exports.getActiveSelection=g,exports.getEffectiveLocalBackend=m,exports.getRegisteredBackends=h,exports.getSnapshot=_,exports.isNoBackend=a,exports.setActiveSelection=v,exports.setRegisteredBackends=y,exports.subscribeActiveBackend=b;
 //# sourceMappingURL=active-store.cjs.map

package/dist/api/backend-registry/active-store.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"active-store.cjs","names":[],"sources":["../../../src/api/backend-registry/active-store.ts"],"sourcesContent":["import { getBackendHealthEntry } from \"./health-store\";\nimport {\n  readStoredActiveBackend,\n  readStoredBackends,\n  writeStoredActiveBackend,\n  writeStoredBackends,\n} from \"./storage\";\nimport type { Backend, BackendSelection, ResolvedActiveBackend } from \"./types\";\n\ntype Listener = () => void;\n\ninterface Snapshot {\n  backends: Backend[];\n  selection: BackendSelection | null;\n  active: ResolvedActiveBackend;\n}\n\nexport const NO_BACKEND_ID = \"no-backend\";\n\n/**\n * Sentinel returned when the registry has no usable backend. It must never be\n * persisted, and callers must check `isNoBackend()` before interpreting fields\n * like `kind`, `host`, or `apiKey`.\n */\nexport const NO_BACKEND: Backend = {\n  id: NO_BACKEND_ID,\n  name: \"No Backend Available\",\n  host: \"\",\n  apiKey: \"\",\n  kind: \"local\",\n};\n\nexport function isNoBackend(backend: Backend): boolean {\n  return backend.id === NO_BACKEND_ID;\n}\n\n/**\n * Choose an active backend when there is no valid explicit selection (fresh\n * start, or the selected backend was removed). Most of the GUI speaks the\n * local agent-server protocol, so a cloud or dead-local backend at index 0\n * would leave `getEffectiveLocalBackend()` null and make every local-protocol\n * call throw \"No backend is configured\" even when a healthy local backend is\n * registered further down the list. Consult the synchronous, persisted health\n * store and prefer a healthy local backend; fall back to any local backend so\n * the effective-local resolver still resolves, then to the prior deterministic\n * `backends[0]` behavior for the registry-has-no-local case.\n */\nfunction pickFallbackBackend(backends: Backend[]): Backend {\n  const healthyLocalBackend = backends.find(\n    (backend) =>\n      backend.kind === \"local\" &&\n      getBackendHealthEntry(backend.id)?.disabled !== true,\n  );\n  if (healthyLocalBackend) return healthyLocalBackend;\n\n  const localBackend = backends.find((backend) => backend.kind === \"local\");\n  return localBackend ?? backends[0] ?? NO_BACKEND;\n}\n\nfunction computeSnapshot(\n  backends: Backend[],\n  selection: BackendSelection | null,\n): Snapshot {\n  let activeBackend: Backend | null = null;\n  let activeOrgId: string | null = null;\n\n  if (selection) {\n    const found = backends.find((b) => b.id === selection.backendId);\n    if (found) {\n      activeBackend = found;\n      activeOrgId = selection.orgId ?? null;\n    }\n    // If the selection points at a removed backend, fall through to\n    // the unselected case below; we also drop the orgId since it only\n    // makes sense in the context of a specific cloud backend.\n  }\n\n  // @spec BM-003 — Fallback on active backend removal\n  if (!activeBackend) {\n    activeBackend = pickFallbackBackend(backends);\n    activeOrgId = null;\n  }\n\n  return {\n    backends,\n    selection,\n    active: { backend: activeBackend, orgId: activeOrgId },\n  };\n}\n\nlet snapshot: Snapshot = computeSnapshot(\n  readStoredBackends(),\n  readStoredActiveBackend(),\n);\n\nconst listeners = new Set<Listener>();\n\nfunction notify(): void {\n  listeners.forEach((listener) => listener());\n}\n\nexport function getActiveBackend(): ResolvedActiveBackend {\n  return snapshot.active;\n}\n\n/**\n * Pick the backend to use for *local agent-server protocol* calls.\n *\n * Most of the GUI's services (settings reads/writes, conversation CRUD,\n * skills/MCP/secrets, etc.) speak the local agent-server's protocol —\n * they would fail against a cloud host. Only the active backend is eligible:\n * a cloud selection must not borrow another registered local backend.\n */\nexport function getEffectiveLocalBackend(): Backend | null {\n  const active = snapshot.active.backend;\n  if (active.kind === \"local\" && !isNoBackend(active)) return active;\n  return null;\n}\n\nexport function getRegisteredBackends(): Backend[] {\n  return snapshot.backends;\n}\n\nexport function getActiveSelection(): BackendSelection | null {\n  return snapshot.selection;\n}\n\nexport function getSnapshot(): Snapshot {\n  return snapshot;\n}\n\nexport function setActiveSelection(selection: BackendSelection | null): void {\n  writeStoredActiveBackend(selection);\n  snapshot = computeSnapshot(snapshot.backends, selection);\n  notify();\n}\n\nexport function setRegisteredBackends(backends: Backend[]): void {\n  writeStoredBackends(backends);\n\n  let nextSelection = snapshot.selection;\n  if (\n    nextSelection &&\n    !backends.some((b) => b.id === nextSelection!.backendId)\n  ) {\n    nextSelection = null;\n    writeStoredActiveBackend(null);\n  }\n\n  snapshot = computeSnapshot(backends, nextSelection);\n  notify();\n}\n\nexport function subscribeActiveBackend(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n/** Test-only: re-read storage and clear listeners. */\n\nexport function __resetActiveStoreForTests(): void {\n  snapshot = computeSnapshot(readStoredBackends(), readStoredActiveBackend());\n  listeners.clear();\n}\n"],"mappings":"iHAiBA,IAAa,EAAgB,aAOhB,EAAsB,CACjC,GAAI,EACJ,KAAM,uBACN,KAAM,GACN,OAAQ,GACR,KAAM,OACR,EAEA,SAAgB,EAAY,EAA2B,CACrD,OAAO,EAAQ,KAAO,CACxB,CAaA,SAAS,EAAoB,EAA8B,CASzD,OAR4B,EAAS,KAClC,GACC,EAAQ,OAAS,SACjB,EAAA,sBAAsB,EAAQ,EAAE,GAAG,WAAa,EAEhD,IAEiB,EAAS,KAAM,GAAY,EAAQ,OAAS,OAC1D,GAAgB,EAAS,IAAM,EACxC,CAEA,SAAS,EACP,EACA,EACU,CACV,IAAI,EAAgC,KAChC,EAA6B,KAEjC,GAAI,EAAW,CACb,IAAM,EAAQ,EAAS,KAAM,GAAM,EAAE,KAAO,EAAU,SAAS,EAC3D,IACF,EAAgB,EAChB,EAAc,EAAU,OAAS,KAKrC,CAQA,OALK,IACH,EAAgB,EAAoB,CAAQ,EAC5C,EAAc,MAGT,CACL,WACA,YACA,OAAQ,CAAE,QAAS,EAAe,MAAO,CAAY,CACvD,CACF,CAEA,IAAI,EAAqB,EACvB,EAAA,mBAAmB,EACnB,EAAA,wBAAwB,CAC1B,EAEM,EAAY,IAAI,IAEtB,SAAS,GAAe,CACtB,EAAU,QAAS,GAAa,EAAS,CAAC,CAC5C,CAEA,SAAgB,GAA0C,CACxD,OAAO,EAAS,MAClB,CAUA,SAAgB,GAA2C,CACzD,IAAM,EAAS,EAAS,OAAO,QAE/B,OADI,EAAO,OAAS,SAAW,CAAC,EAAY,CAAM,EAAU,EACrD,IACT,CAEA,SAAgB,GAAmC,CACjD,OAAO,EAAS,QAClB,CAEA,SAAgB,GAA8C,CAC5D,OAAO,EAAS,SAClB,CAEA,SAAgB,GAAwB,CACtC,OAAO,CACT,CAEA,SAAgB,EAAmB,EAA0C,CAC3E,EAAA,yBAAyB,CAAS,EAClC,EAAW,EAAgB,EAAS,SAAU,CAAS,EACvD,EAAO,CACT,CAEA,SAAgB,EAAsB,EAA2B,CAC/D,EAAA,oBAAoB,CAAQ,EAE5B,IAAI,EAAgB,EAAS,UAE3B,GACA,CAAC,EAAS,KAAM,GAAM,EAAE,KAAO,EAAe,SAAS,IAEvD,EAAgB,KAChB,EAAA,yBAAyB,IAAI,GAG/B,EAAW,EAAgB,EAAU,CAAa,EAClD,EAAO,CACT,CAEA,SAAgB,EAAuB,EAAgC,CAErE,OADA,EAAU,IAAI,CAAQ,MACT,CACX,EAAU,OAAO,CAAQ,CAC3B,CACF"}
+{"version":3,"file":"active-store.cjs","names":[],"sources":["../../../src/api/backend-registry/active-store.ts"],"sourcesContent":["import { getBackendHealthEntry } from \"./health-store\";\nimport {\n  readStoredActiveBackend,\n  readStoredBackends,\n  writeStoredActiveBackend,\n  writeStoredBackends,\n} from \"./storage\";\nimport type { Backend, BackendSelection, ResolvedActiveBackend } from \"./types\";\nimport {\n  currentLocationSearch,\n  readBackendSelectionFromUrl,\n} from \"./url-selection\";\n\ntype Listener = () => void;\n\ninterface Snapshot {\n  backends: Backend[];\n  selection: BackendSelection | null;\n  active: ResolvedActiveBackend;\n}\n\nexport const NO_BACKEND_ID = \"no-backend\";\n\n/**\n * Sentinel returned when the registry has no usable backend. It must never be\n * persisted, and callers must check `isNoBackend()` before interpreting fields\n * like `kind`, `host`, or `apiKey`.\n */\nexport const NO_BACKEND: Backend = {\n  id: NO_BACKEND_ID,\n  name: \"No Backend Available\",\n  host: \"\",\n  apiKey: \"\",\n  kind: \"local\",\n};\n\nexport function isNoBackend(backend: Backend): boolean {\n  return backend.id === NO_BACKEND_ID;\n}\n\n/**\n * Choose an active backend when there is no valid explicit selection (fresh\n * start, or the selected backend was removed). Most of the GUI speaks the\n * local agent-server protocol, so a cloud or dead-local backend at index 0\n * would leave `getEffectiveLocalBackend()` null and make every local-protocol\n * call throw \"No backend is configured\" even when a healthy local backend is\n * registered further down the list. Consult the synchronous, persisted health\n * store and prefer a healthy local backend; fall back to any local backend so\n * the effective-local resolver still resolves, then to the prior deterministic\n * `backends[0]` behavior for the registry-has-no-local case.\n */\nfunction pickFallbackBackend(backends: Backend[]): Backend {\n  const healthyLocalBackend = backends.find(\n    (backend) =>\n      backend.kind === \"local\" &&\n      getBackendHealthEntry(backend.id)?.disabled !== true,\n  );\n  if (healthyLocalBackend) return healthyLocalBackend;\n\n  const localBackend = backends.find((backend) => backend.kind === \"local\");\n  return localBackend ?? backends[0] ?? NO_BACKEND;\n}\n\nfunction computeSnapshot(\n  backends: Backend[],\n  selection: BackendSelection | null,\n): Snapshot {\n  let activeBackend: Backend | null = null;\n  let activeOrgId: string | null = null;\n\n  if (selection) {\n    const found = backends.find((b) => b.id === selection.backendId);\n    if (found) {\n      activeBackend = found;\n      activeOrgId = selection.orgId ?? null;\n    }\n    // If the selection points at a removed backend, fall through to\n    // the unselected case below; we also drop the orgId since it only\n    // makes sense in the context of a specific cloud backend.\n  }\n\n  // @spec BM-003 — Fallback on active backend removal\n  if (!activeBackend) {\n    activeBackend = pickFallbackBackend(backends);\n    activeOrgId = null;\n  }\n\n  return {\n    backends,\n    selection,\n    active: { backend: activeBackend, orgId: activeOrgId },\n  };\n}\n\n/**\n * Resolve the selection this tab boots with. A backend pinned in the URL wins\n * over stored state so a link opened in a new tab (cmd/ctrl-click, middle\n * click, \"Open in new tab\") lands on the backend that owns the linked\n * conversation, even when the new tab starts with an empty `sessionStorage`\n * and would otherwise adopt the `localStorage` fallback. The honoured\n * selection is persisted so later in-tab navigation — which drops the query\n * parameters — keeps the same backend.\n */\nfunction readInitialSelection(backends: Backend[]): BackendSelection | null {\n  const fromUrl = readBackendSelectionFromUrl(\n    backends,\n    currentLocationSearch(),\n  );\n  if (fromUrl) {\n    writeStoredActiveBackend(fromUrl);\n    return fromUrl;\n  }\n  return readStoredActiveBackend();\n}\n\nconst initialBackends = readStoredBackends();\nlet snapshot: Snapshot = computeSnapshot(\n  initialBackends,\n  readInitialSelection(initialBackends),\n);\n\nconst listeners = new Set<Listener>();\n\nfunction notify(): void {\n  listeners.forEach((listener) => listener());\n}\n\nexport function getActiveBackend(): ResolvedActiveBackend {\n  return snapshot.active;\n}\n\n/**\n * Pick the backend to use for *local agent-server protocol* calls.\n *\n * Most of the GUI's services (settings reads/writes, conversation CRUD,\n * skills/MCP/secrets, etc.) speak the local agent-server's protocol —\n * they would fail against a cloud host. Only the active backend is eligible:\n * a cloud selection must not borrow another registered local backend.\n */\nexport function getEffectiveLocalBackend(): Backend | null {\n  const active = snapshot.active.backend;\n  if (active.kind === \"local\" && !isNoBackend(active)) return active;\n  return null;\n}\n\nexport function getRegisteredBackends(): Backend[] {\n  return snapshot.backends;\n}\n\nexport function getActiveSelection(): BackendSelection | null {\n  return snapshot.selection;\n}\n\nexport function getSnapshot(): Snapshot {\n  return snapshot;\n}\n\nexport function setActiveSelection(selection: BackendSelection | null): void {\n  writeStoredActiveBackend(selection);\n  snapshot = computeSnapshot(snapshot.backends, selection);\n  notify();\n}\n\nexport function setRegisteredBackends(backends: Backend[]): void {\n  writeStoredBackends(backends);\n\n  let nextSelection = snapshot.selection;\n  if (\n    nextSelection &&\n    !backends.some((b) => b.id === nextSelection!.backendId)\n  ) {\n    nextSelection = null;\n    writeStoredActiveBackend(null);\n  }\n\n  snapshot = computeSnapshot(backends, nextSelection);\n  notify();\n}\n\nexport function subscribeActiveBackend(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n/** Test-only: re-read storage and clear listeners. */\n\nexport function __resetActiveStoreForTests(): void {\n  const backends = readStoredBackends();\n  snapshot = computeSnapshot(backends, readInitialSelection(backends));\n  listeners.clear();\n}\n"],"mappings":"kJAqBA,IAAa,EAAgB,aAOhB,EAAsB,CACjC,GAAI,EACJ,KAAM,uBACN,KAAM,GACN,OAAQ,GACR,KAAM,OACR,EAEA,SAAgB,EAAY,EAA2B,CACrD,OAAO,EAAQ,KAAO,CACxB,CAaA,SAAS,EAAoB,EAA8B,CASzD,OAR4B,EAAS,KAClC,GACC,EAAQ,OAAS,SACjB,EAAA,sBAAsB,EAAQ,EAAE,GAAG,WAAa,EAEhD,IAEiB,EAAS,KAAM,GAAY,EAAQ,OAAS,OAC1D,GAAgB,EAAS,IAAM,EACxC,CAEA,SAAS,EACP,EACA,EACU,CACV,IAAI,EAAgC,KAChC,EAA6B,KAEjC,GAAI,EAAW,CACb,IAAM,EAAQ,EAAS,KAAM,GAAM,EAAE,KAAO,EAAU,SAAS,EAC3D,IACF,EAAgB,EAChB,EAAc,EAAU,OAAS,KAKrC,CAQA,OALK,IACH,EAAgB,EAAoB,CAAQ,EAC5C,EAAc,MAGT,CACL,WACA,YACA,OAAQ,CAAE,QAAS,EAAe,MAAO,CAAY,CACvD,CACF,CAWA,SAAS,EAAqB,EAA8C,CAC1E,IAAM,EAAU,EAAA,4BACd,EACA,EAAA,sBAAsB,CACxB,EAKA,OAJI,GACF,EAAA,yBAAyB,CAAO,EACzB,GAEF,EAAA,wBAAwB,CACjC,CAEA,IAAM,EAAkB,EAAA,mBAAmB,EACvC,EAAqB,EACvB,EACA,EAAqB,CAAe,CACtC,EAEM,EAAY,IAAI,IAEtB,SAAS,GAAe,CACtB,EAAU,QAAS,GAAa,EAAS,CAAC,CAC5C,CAEA,SAAgB,GAA0C,CACxD,OAAO,EAAS,MAClB,CAUA,SAAgB,GAA2C,CACzD,IAAM,EAAS,EAAS,OAAO,QAE/B,OADI,EAAO,OAAS,SAAW,CAAC,EAAY,CAAM,EAAU,EACrD,IACT,CAEA,SAAgB,GAAmC,CACjD,OAAO,EAAS,QAClB,CAEA,SAAgB,GAA8C,CAC5D,OAAO,EAAS,SAClB,CAEA,SAAgB,GAAwB,CACtC,OAAO,CACT,CAEA,SAAgB,EAAmB,EAA0C,CAC3E,EAAA,yBAAyB,CAAS,EAClC,EAAW,EAAgB,EAAS,SAAU,CAAS,EACvD,EAAO,CACT,CAEA,SAAgB,EAAsB,EAA2B,CAC/D,EAAA,oBAAoB,CAAQ,EAE5B,IAAI,EAAgB,EAAS,UAE3B,GACA,CAAC,EAAS,KAAM,GAAM,EAAE,KAAO,EAAe,SAAS,IAEvD,EAAgB,KAChB,EAAA,yBAAyB,IAAI,GAG/B,EAAW,EAAgB,EAAU,CAAa,EAClD,EAAO,CACT,CAEA,SAAgB,EAAuB,EAAgC,CAErE,OADA,EAAU,IAAI,CAAQ,MACT,CACX,EAAU,OAAO,CAAQ,CAC3B,CACF"}

package/dist/api/backend-registry/active-store.js

@@ -1,26 +1,27 @@
 import { getBackendHealthEntry as e } from "./health-store.js";
 import { readStoredActiveBackend as t, readStoredBackends as n, writeStoredActiveBackend as r, writeStoredBackends as i } from "./storage.js";
+import { currentLocationSearch as a, readBackendSelectionFromUrl as o } from "./url-selection.js";
 //#region src/api/backend-registry/active-store.ts
-var a = "no-backend", o = {
-	id: a,
+var s = "no-backend", c = {
+	id: s,
 	name: "No Backend Available",
 	host: "",
 	apiKey: "",
 	kind: "local"
 };
-function s(e) {
-	return e.id === a;
+function l(e) {
+	return e.id === s;
 }
-function c(t) {
-	return t.find((t) => t.kind === "local" && e(t.id)?.disabled !== !0) || (t.find((e) => e.kind === "local") ?? t[0] ?? o);
+function u(t) {
+	return t.find((t) => t.kind === "local" && e(t.id)?.disabled !== !0) || (t.find((e) => e.kind === "local") ?? t[0] ?? c);
 }
-function l(e, t) {
+function d(e, t) {
 	let n = null, r = null;
 	if (t) {
 		let i = e.find((e) => e.id === t.backendId);
 		i && (n = i, r = t.orgId ?? null);
 	}
-	return n || (n = c(e), r = null), {
+	return n || (n = u(e), r = null), {
 		backends: e,
 		selection: t,
 		active: {
@@ -29,40 +30,44 @@ function l(e, t) {
 		}
 	};
 }
-var u = l(n(), t()), d = /* @__PURE__ */ new Set();
-function f() {
-	d.forEach((e) => e());
+function f(e) {
+	let n = o(e, a());
+	return n ? (r(n), n) : t();
 }
-function p() {
-	return u.active;
+var p = n(), m = d(p, f(p)), h = /* @__PURE__ */ new Set();
+function g() {
+	h.forEach((e) => e());
 }
-function m() {
-	let e = u.active.backend;
-	return e.kind === "local" && !s(e) ? e : null;
+function _() {
+	return m.active;
 }
-function h() {
-	return u.backends;
+function v() {
+	let e = m.active.backend;
+	return e.kind === "local" && !l(e) ? e : null;
 }
-function g() {
-	return u.selection;
+function y() {
+	return m.backends;
 }
-function _() {
-	return u;
+function b() {
+	return m.selection;
+}
+function x() {
+	return m;
 }
-function v(e) {
-	r(e), u = l(u.backends, e), f();
+function S(e) {
+	r(e), m = d(m.backends, e), g();
 }
-function y(e) {
+function C(e) {
 	i(e);
-	let t = u.selection;
-	t && !e.some((e) => e.id === t.backendId) && (t = null, r(null)), u = l(e, t), f();
+	let t = m.selection;
+	t && !e.some((e) => e.id === t.backendId) && (t = null, r(null)), m = d(e, t), g();
 }
-function b(e) {
-	return d.add(e), () => {
-		d.delete(e);
+function w(e) {
+	return h.add(e), () => {
+		h.delete(e);
 	};
 }
 //#endregion
-export { o as NO_BACKEND, p as getActiveBackend, g as getActiveSelection, m as getEffectiveLocalBackend, h as getRegisteredBackends, _ as getSnapshot, s as isNoBackend, v as setActiveSelection, y as setRegisteredBackends, b as subscribeActiveBackend };
+export { c as NO_BACKEND, _ as getActiveBackend, b as getActiveSelection, v as getEffectiveLocalBackend, y as getRegisteredBackends, x as getSnapshot, l as isNoBackend, S as setActiveSelection, C as setRegisteredBackends, w as subscribeActiveBackend };
 
 //# sourceMappingURL=active-store.js.map

package/dist/api/backend-registry/active-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"active-store.js","names":[],"sources":["../../../src/api/backend-registry/active-store.ts"],"sourcesContent":["import { getBackendHealthEntry } from \"./health-store\";\nimport {\n  readStoredActiveBackend,\n  readStoredBackends,\n  writeStoredActiveBackend,\n  writeStoredBackends,\n} from \"./storage\";\nimport type { Backend, BackendSelection, ResolvedActiveBackend } from \"./types\";\n\ntype Listener = () => void;\n\ninterface Snapshot {\n  backends: Backend[];\n  selection: BackendSelection | null;\n  active: ResolvedActiveBackend;\n}\n\nexport const NO_BACKEND_ID = \"no-backend\";\n\n/**\n * Sentinel returned when the registry has no usable backend. It must never be\n * persisted, and callers must check `isNoBackend()` before interpreting fields\n * like `kind`, `host`, or `apiKey`.\n */\nexport const NO_BACKEND: Backend = {\n  id: NO_BACKEND_ID,\n  name: \"No Backend Available\",\n  host: \"\",\n  apiKey: \"\",\n  kind: \"local\",\n};\n\nexport function isNoBackend(backend: Backend): boolean {\n  return backend.id === NO_BACKEND_ID;\n}\n\n/**\n * Choose an active backend when there is no valid explicit selection (fresh\n * start, or the selected backend was removed). Most of the GUI speaks the\n * local agent-server protocol, so a cloud or dead-local backend at index 0\n * would leave `getEffectiveLocalBackend()` null and make every local-protocol\n * call throw \"No backend is configured\" even when a healthy local backend is\n * registered further down the list. Consult the synchronous, persisted health\n * store and prefer a healthy local backend; fall back to any local backend so\n * the effective-local resolver still resolves, then to the prior deterministic\n * `backends[0]` behavior for the registry-has-no-local case.\n */\nfunction pickFallbackBackend(backends: Backend[]): Backend {\n  const healthyLocalBackend = backends.find(\n    (backend) =>\n      backend.kind === \"local\" &&\n      getBackendHealthEntry(backend.id)?.disabled !== true,\n  );\n  if (healthyLocalBackend) return healthyLocalBackend;\n\n  const localBackend = backends.find((backend) => backend.kind === \"local\");\n  return localBackend ?? backends[0] ?? NO_BACKEND;\n}\n\nfunction computeSnapshot(\n  backends: Backend[],\n  selection: BackendSelection | null,\n): Snapshot {\n  let activeBackend: Backend | null = null;\n  let activeOrgId: string | null = null;\n\n  if (selection) {\n    const found = backends.find((b) => b.id === selection.backendId);\n    if (found) {\n      activeBackend = found;\n      activeOrgId = selection.orgId ?? null;\n    }\n    // If the selection points at a removed backend, fall through to\n    // the unselected case below; we also drop the orgId since it only\n    // makes sense in the context of a specific cloud backend.\n  }\n\n  // @spec BM-003 — Fallback on active backend removal\n  if (!activeBackend) {\n    activeBackend = pickFallbackBackend(backends);\n    activeOrgId = null;\n  }\n\n  return {\n    backends,\n    selection,\n    active: { backend: activeBackend, orgId: activeOrgId },\n  };\n}\n\nlet snapshot: Snapshot = computeSnapshot(\n  readStoredBackends(),\n  readStoredActiveBackend(),\n);\n\nconst listeners = new Set<Listener>();\n\nfunction notify(): void {\n  listeners.forEach((listener) => listener());\n}\n\nexport function getActiveBackend(): ResolvedActiveBackend {\n  return snapshot.active;\n}\n\n/**\n * Pick the backend to use for *local agent-server protocol* calls.\n *\n * Most of the GUI's services (settings reads/writes, conversation CRUD,\n * skills/MCP/secrets, etc.) speak the local agent-server's protocol —\n * they would fail against a cloud host. Only the active backend is eligible:\n * a cloud selection must not borrow another registered local backend.\n */\nexport function getEffectiveLocalBackend(): Backend | null {\n  const active = snapshot.active.backend;\n  if (active.kind === \"local\" && !isNoBackend(active)) return active;\n  return null;\n}\n\nexport function getRegisteredBackends(): Backend[] {\n  return snapshot.backends;\n}\n\nexport function getActiveSelection(): BackendSelection | null {\n  return snapshot.selection;\n}\n\nexport function getSnapshot(): Snapshot {\n  return snapshot;\n}\n\nexport function setActiveSelection(selection: BackendSelection | null): void {\n  writeStoredActiveBackend(selection);\n  snapshot = computeSnapshot(snapshot.backends, selection);\n  notify();\n}\n\nexport function setRegisteredBackends(backends: Backend[]): void {\n  writeStoredBackends(backends);\n\n  let nextSelection = snapshot.selection;\n  if (\n    nextSelection &&\n    !backends.some((b) => b.id === nextSelection!.backendId)\n  ) {\n    nextSelection = null;\n    writeStoredActiveBackend(null);\n  }\n\n  snapshot = computeSnapshot(backends, nextSelection);\n  notify();\n}\n\nexport function subscribeActiveBackend(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n/** Test-only: re-read storage and clear listeners. */\n\nexport function __resetActiveStoreForTests(): void {\n  snapshot = computeSnapshot(readStoredBackends(), readStoredActiveBackend());\n  listeners.clear();\n}\n"],"mappings":";;;AAiBA,IAAa,IAAgB,cAOhB,IAAsB;CACjC,IAAI;CACJ,MAAM;CACN,MAAM;CACN,QAAQ;CACR,MAAM;AACR;AAEA,SAAgB,EAAY,GAA2B;CACrD,OAAO,EAAQ,OAAO;AACxB;AAaA,SAAS,EAAoB,GAA8B;CASzD,OAR4B,EAAS,MAClC,MACC,EAAQ,SAAS,WACjB,EAAsB,EAAQ,EAAE,GAAG,aAAa,EAEhD,MAEiB,EAAS,MAAM,MAAY,EAAQ,SAAS,OAC1D,KAAgB,EAAS,MAAM;AACxC;AAEA,SAAS,EACP,GACA,GACU;CACV,IAAI,IAAgC,MAChC,IAA6B;CAEjC,IAAI,GAAW;EACb,IAAM,IAAQ,EAAS,MAAM,MAAM,EAAE,OAAO,EAAU,SAAS;EAC/D,AAAI,MACF,IAAgB,GAChB,IAAc,EAAU,SAAS;CAKrC;CAQA,OALK,MACH,IAAgB,EAAoB,CAAQ,GAC5C,IAAc,OAGT;EACL;EACA;EACA,QAAQ;GAAE,SAAS;GAAe,OAAO;EAAY;CACvD;AACF;AAEA,IAAI,IAAqB,EACvB,EAAmB,GACnB,EAAwB,CAC1B,GAEM,oBAAY,IAAI,IAAc;AAEpC,SAAS,IAAe;CACtB,EAAU,SAAS,MAAa,EAAS,CAAC;AAC5C;AAEA,SAAgB,IAA0C;CACxD,OAAO,EAAS;AAClB;AAUA,SAAgB,IAA2C;CACzD,IAAM,IAAS,EAAS,OAAO;CAE/B,OADI,EAAO,SAAS,WAAW,CAAC,EAAY,CAAM,IAAU,IACrD;AACT;AAEA,SAAgB,IAAmC;CACjD,OAAO,EAAS;AAClB;AAEA,SAAgB,IAA8C;CAC5D,OAAO,EAAS;AAClB;AAEA,SAAgB,IAAwB;CACtC,OAAO;AACT;AAEA,SAAgB,EAAmB,GAA0C;CAG3E,AAFA,EAAyB,CAAS,GAClC,IAAW,EAAgB,EAAS,UAAU,CAAS,GACvD,EAAO;AACT;AAEA,SAAgB,EAAsB,GAA2B;CAC/D,EAAoB,CAAQ;CAE5B,IAAI,IAAgB,EAAS;CAU7B,AARE,KACA,CAAC,EAAS,MAAM,MAAM,EAAE,OAAO,EAAe,SAAS,MAEvD,IAAgB,MAChB,EAAyB,IAAI,IAG/B,IAAW,EAAgB,GAAU,CAAa,GAClD,EAAO;AACT;AAEA,SAAgB,EAAuB,GAAgC;CAErE,OADA,EAAU,IAAI,CAAQ,SACT;EACX,EAAU,OAAO,CAAQ;CAC3B;AACF"}
+{"version":3,"file":"active-store.js","names":[],"sources":["../../../src/api/backend-registry/active-store.ts"],"sourcesContent":["import { getBackendHealthEntry } from \"./health-store\";\nimport {\n  readStoredActiveBackend,\n  readStoredBackends,\n  writeStoredActiveBackend,\n  writeStoredBackends,\n} from \"./storage\";\nimport type { Backend, BackendSelection, ResolvedActiveBackend } from \"./types\";\nimport {\n  currentLocationSearch,\n  readBackendSelectionFromUrl,\n} from \"./url-selection\";\n\ntype Listener = () => void;\n\ninterface Snapshot {\n  backends: Backend[];\n  selection: BackendSelection | null;\n  active: ResolvedActiveBackend;\n}\n\nexport const NO_BACKEND_ID = \"no-backend\";\n\n/**\n * Sentinel returned when the registry has no usable backend. It must never be\n * persisted, and callers must check `isNoBackend()` before interpreting fields\n * like `kind`, `host`, or `apiKey`.\n */\nexport const NO_BACKEND: Backend = {\n  id: NO_BACKEND_ID,\n  name: \"No Backend Available\",\n  host: \"\",\n  apiKey: \"\",\n  kind: \"local\",\n};\n\nexport function isNoBackend(backend: Backend): boolean {\n  return backend.id === NO_BACKEND_ID;\n}\n\n/**\n * Choose an active backend when there is no valid explicit selection (fresh\n * start, or the selected backend was removed). Most of the GUI speaks the\n * local agent-server protocol, so a cloud or dead-local backend at index 0\n * would leave `getEffectiveLocalBackend()` null and make every local-protocol\n * call throw \"No backend is configured\" even when a healthy local backend is\n * registered further down the list. Consult the synchronous, persisted health\n * store and prefer a healthy local backend; fall back to any local backend so\n * the effective-local resolver still resolves, then to the prior deterministic\n * `backends[0]` behavior for the registry-has-no-local case.\n */\nfunction pickFallbackBackend(backends: Backend[]): Backend {\n  const healthyLocalBackend = backends.find(\n    (backend) =>\n      backend.kind === \"local\" &&\n      getBackendHealthEntry(backend.id)?.disabled !== true,\n  );\n  if (healthyLocalBackend) return healthyLocalBackend;\n\n  const localBackend = backends.find((backend) => backend.kind === \"local\");\n  return localBackend ?? backends[0] ?? NO_BACKEND;\n}\n\nfunction computeSnapshot(\n  backends: Backend[],\n  selection: BackendSelection | null,\n): Snapshot {\n  let activeBackend: Backend | null = null;\n  let activeOrgId: string | null = null;\n\n  if (selection) {\n    const found = backends.find((b) => b.id === selection.backendId);\n    if (found) {\n      activeBackend = found;\n      activeOrgId = selection.orgId ?? null;\n    }\n    // If the selection points at a removed backend, fall through to\n    // the unselected case below; we also drop the orgId since it only\n    // makes sense in the context of a specific cloud backend.\n  }\n\n  // @spec BM-003 — Fallback on active backend removal\n  if (!activeBackend) {\n    activeBackend = pickFallbackBackend(backends);\n    activeOrgId = null;\n  }\n\n  return {\n    backends,\n    selection,\n    active: { backend: activeBackend, orgId: activeOrgId },\n  };\n}\n\n/**\n * Resolve the selection this tab boots with. A backend pinned in the URL wins\n * over stored state so a link opened in a new tab (cmd/ctrl-click, middle\n * click, \"Open in new tab\") lands on the backend that owns the linked\n * conversation, even when the new tab starts with an empty `sessionStorage`\n * and would otherwise adopt the `localStorage` fallback. The honoured\n * selection is persisted so later in-tab navigation — which drops the query\n * parameters — keeps the same backend.\n */\nfunction readInitialSelection(backends: Backend[]): BackendSelection | null {\n  const fromUrl = readBackendSelectionFromUrl(\n    backends,\n    currentLocationSearch(),\n  );\n  if (fromUrl) {\n    writeStoredActiveBackend(fromUrl);\n    return fromUrl;\n  }\n  return readStoredActiveBackend();\n}\n\nconst initialBackends = readStoredBackends();\nlet snapshot: Snapshot = computeSnapshot(\n  initialBackends,\n  readInitialSelection(initialBackends),\n);\n\nconst listeners = new Set<Listener>();\n\nfunction notify(): void {\n  listeners.forEach((listener) => listener());\n}\n\nexport function getActiveBackend(): ResolvedActiveBackend {\n  return snapshot.active;\n}\n\n/**\n * Pick the backend to use for *local agent-server protocol* calls.\n *\n * Most of the GUI's services (settings reads/writes, conversation CRUD,\n * skills/MCP/secrets, etc.) speak the local agent-server's protocol —\n * they would fail against a cloud host. Only the active backend is eligible:\n * a cloud selection must not borrow another registered local backend.\n */\nexport function getEffectiveLocalBackend(): Backend | null {\n  const active = snapshot.active.backend;\n  if (active.kind === \"local\" && !isNoBackend(active)) return active;\n  return null;\n}\n\nexport function getRegisteredBackends(): Backend[] {\n  return snapshot.backends;\n}\n\nexport function getActiveSelection(): BackendSelection | null {\n  return snapshot.selection;\n}\n\nexport function getSnapshot(): Snapshot {\n  return snapshot;\n}\n\nexport function setActiveSelection(selection: BackendSelection | null): void {\n  writeStoredActiveBackend(selection);\n  snapshot = computeSnapshot(snapshot.backends, selection);\n  notify();\n}\n\nexport function setRegisteredBackends(backends: Backend[]): void {\n  writeStoredBackends(backends);\n\n  let nextSelection = snapshot.selection;\n  if (\n    nextSelection &&\n    !backends.some((b) => b.id === nextSelection!.backendId)\n  ) {\n    nextSelection = null;\n    writeStoredActiveBackend(null);\n  }\n\n  snapshot = computeSnapshot(backends, nextSelection);\n  notify();\n}\n\nexport function subscribeActiveBackend(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n/** Test-only: re-read storage and clear listeners. */\n\nexport function __resetActiveStoreForTests(): void {\n  const backends = readStoredBackends();\n  snapshot = computeSnapshot(backends, readInitialSelection(backends));\n  listeners.clear();\n}\n"],"mappings":";;;;AAqBA,IAAa,IAAgB,cAOhB,IAAsB;CACjC,IAAI;CACJ,MAAM;CACN,MAAM;CACN,QAAQ;CACR,MAAM;AACR;AAEA,SAAgB,EAAY,GAA2B;CACrD,OAAO,EAAQ,OAAO;AACxB;AAaA,SAAS,EAAoB,GAA8B;CASzD,OAR4B,EAAS,MAClC,MACC,EAAQ,SAAS,WACjB,EAAsB,EAAQ,EAAE,GAAG,aAAa,EAEhD,MAEiB,EAAS,MAAM,MAAY,EAAQ,SAAS,OAC1D,KAAgB,EAAS,MAAM;AACxC;AAEA,SAAS,EACP,GACA,GACU;CACV,IAAI,IAAgC,MAChC,IAA6B;CAEjC,IAAI,GAAW;EACb,IAAM,IAAQ,EAAS,MAAM,MAAM,EAAE,OAAO,EAAU,SAAS;EAC/D,AAAI,MACF,IAAgB,GAChB,IAAc,EAAU,SAAS;CAKrC;CAQA,OALK,MACH,IAAgB,EAAoB,CAAQ,GAC5C,IAAc,OAGT;EACL;EACA;EACA,QAAQ;GAAE,SAAS;GAAe,OAAO;EAAY;CACvD;AACF;AAWA,SAAS,EAAqB,GAA8C;CAC1E,IAAM,IAAU,EACd,GACA,EAAsB,CACxB;CAKA,OAJI,KACF,EAAyB,CAAO,GACzB,KAEF,EAAwB;AACjC;AAEA,IAAM,IAAkB,EAAmB,GACvC,IAAqB,EACvB,GACA,EAAqB,CAAe,CACtC,GAEM,oBAAY,IAAI,IAAc;AAEpC,SAAS,IAAe;CACtB,EAAU,SAAS,MAAa,EAAS,CAAC;AAC5C;AAEA,SAAgB,IAA0C;CACxD,OAAO,EAAS;AAClB;AAUA,SAAgB,IAA2C;CACzD,IAAM,IAAS,EAAS,OAAO;CAE/B,OADI,EAAO,SAAS,WAAW,CAAC,EAAY,CAAM,IAAU,IACrD;AACT;AAEA,SAAgB,IAAmC;CACjD,OAAO,EAAS;AAClB;AAEA,SAAgB,IAA8C;CAC5D,OAAO,EAAS;AAClB;AAEA,SAAgB,IAAwB;CACtC,OAAO;AACT;AAEA,SAAgB,EAAmB,GAA0C;CAG3E,AAFA,EAAyB,CAAS,GAClC,IAAW,EAAgB,EAAS,UAAU,CAAS,GACvD,EAAO;AACT;AAEA,SAAgB,EAAsB,GAA2B;CAC/D,EAAoB,CAAQ;CAE5B,IAAI,IAAgB,EAAS;CAU7B,AARE,KACA,CAAC,EAAS,MAAM,MAAM,EAAE,OAAO,EAAe,SAAS,MAEvD,IAAgB,MAChB,EAAyB,IAAI,IAG/B,IAAW,EAAgB,GAAU,CAAa,GAClD,EAAO;AACT;AAEA,SAAgB,EAAuB,GAAgC;CAErE,OADA,EAAU,IAAI,CAAQ,SACT;EACX,EAAU,OAAO,CAAQ;CAC3B;AACF"}

package/dist/api/backend-registry/url-selection.cjs

@@ -0,0 +1,2 @@
+require("../../_virtual/_rolldown/runtime.cjs");var e=`backend`;function t(t,n){let{backend:r,orgId:i}=n;if(!r.id)return t;let[a,o=``]=t.split(`?`),s=new URLSearchParams(o);return s.set(e,r.id),i&&s.set(`org`,i),`${a}?${s.toString()}`}function n(t,n){if(!n)return null;let r;try{r=new URLSearchParams(n)}catch{return null}let i=r.get(e);return!i||!t.some(e=>e.id===i)?null:{backendId:i,orgId:r.get(`org`)||null}}function r(){return typeof window>`u`?``:window.location.search}exports.currentLocationSearch=r,exports.readBackendSelectionFromUrl=n,exports.withBackendSelectionParams=t;
+//# sourceMappingURL=url-selection.cjs.map

package/dist/api/backend-registry/url-selection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-selection.cjs","names":[],"sources":["../../../src/api/backend-registry/url-selection.ts"],"sourcesContent":["import type { Backend, BackendSelection, ResolvedActiveBackend } from \"./types\";\n\n/**\n * Query parameters that pin a link to the backend (and cloud org) that owns\n * the linked resource.\n *\n * The active backend is tab-scoped: `readStoredActiveBackend()` prefers\n * `sessionStorage` and only falls back to `localStorage`. A tab opened with\n * cmd/ctrl-click or middle-click does not reliably inherit the opener's\n * `sessionStorage`, so it can boot from the `localStorage` fallback — which\n * holds whichever backend was selected *last in any tab*, not the one the\n * sidebar we were just looking at belongs to. The new tab then resolves the\n * conversation id against the wrong backend and shows \"conversation not\n * found\". Carrying the identity in the URL makes the link self-describing so\n * the new tab pins to the right backend regardless of what storage holds.\n */\nexport const BACKEND_QUERY_PARAM = \"backend\";\nexport const ORG_QUERY_PARAM = \"org\";\n\n/**\n * Append the active backend identity to an in-app path so opening it in a new\n * browsing context resolves against the same backend.\n */\nexport function withBackendSelectionParams(\n  path: string,\n  active: ResolvedActiveBackend,\n): string {\n  const { backend, orgId } = active;\n  if (!backend.id) return path;\n\n  const [pathname, existingSearch = \"\"] = path.split(\"?\");\n  const params = new URLSearchParams(existingSearch);\n  params.set(BACKEND_QUERY_PARAM, backend.id);\n  if (orgId) params.set(ORG_QUERY_PARAM, orgId);\n\n  return `${pathname}?${params.toString()}`;\n}\n\n/**\n * Read a backend selection off the current URL, keeping it only when it names\n * a registered backend. An unknown id (a link from another machine, or a\n * backend that has since been removed) is ignored so the caller falls back to\n * the stored selection.\n */\nexport function readBackendSelectionFromUrl(\n  backends: Backend[],\n  search: string,\n): BackendSelection | null {\n  if (!search) return null;\n\n  let params: URLSearchParams;\n  try {\n    params = new URLSearchParams(search);\n  } catch {\n    return null;\n  }\n\n  const backendId = params.get(BACKEND_QUERY_PARAM);\n  if (!backendId) return null;\n  if (!backends.some((backend) => backend.id === backendId)) return null;\n\n  const orgId = params.get(ORG_QUERY_PARAM);\n  return { backendId, orgId: orgId || null };\n}\n\n/** The current tab's query string, or \"\" outside a browser. */\nexport function currentLocationSearch(): string {\n  if (typeof window === \"undefined\") return \"\";\n  return window.location.search;\n}\n"],"mappings":"gDAgBA,IAAa,EAAsB,UAOnC,SAAgB,EACd,EACA,EACQ,CACR,GAAM,CAAE,UAAS,SAAU,EAC3B,GAAI,CAAC,EAAQ,GAAI,OAAO,EAExB,GAAM,CAAC,EAAU,EAAiB,IAAM,EAAK,MAAM,GAAG,EAChD,EAAS,IAAI,gBAAgB,CAAc,EAIjD,OAHA,EAAO,IAAI,EAAqB,EAAQ,EAAE,EACtC,GAAO,EAAO,IAAA,MAAqB,CAAK,EAErC,GAAG,EAAS,GAAG,EAAO,SAAS,GACxC,CAQA,SAAgB,EACd,EACA,EACyB,CACzB,GAAI,CAAC,EAAQ,OAAO,KAEpB,IAAI,EACJ,GAAI,CACF,EAAS,IAAI,gBAAgB,CAAM,CACrC,MAAQ,CACN,OAAO,IACT,CAEA,IAAM,EAAY,EAAO,IAAI,CAAmB,EAKhD,MAJI,CAAC,GACD,CAAC,EAAS,KAAM,GAAY,EAAQ,KAAO,CAAS,EAAU,KAG3D,CAAE,YAAW,MADN,EAAO,IAAA,KACM,GAAS,IAAK,CAC3C,CAGA,SAAgB,GAAgC,CAE9C,OADI,OAAO,OAAW,IAAoB,GACnC,OAAO,SAAS,MACzB"}

package/dist/api/backend-registry/url-selection.d.ts

@@ -0,0 +1,31 @@
+import type { Backend, BackendSelection, ResolvedActiveBackend } from "./types";
+/**
+ * Query parameters that pin a link to the backend (and cloud org) that owns
+ * the linked resource.
+ *
+ * The active backend is tab-scoped: `readStoredActiveBackend()` prefers
+ * `sessionStorage` and only falls back to `localStorage`. A tab opened with
+ * cmd/ctrl-click or middle-click does not reliably inherit the opener's
+ * `sessionStorage`, so it can boot from the `localStorage` fallback — which
+ * holds whichever backend was selected *last in any tab*, not the one the
+ * sidebar we were just looking at belongs to. The new tab then resolves the
+ * conversation id against the wrong backend and shows "conversation not
+ * found". Carrying the identity in the URL makes the link self-describing so
+ * the new tab pins to the right backend regardless of what storage holds.
+ */
+export declare const BACKEND_QUERY_PARAM = "backend";
+export declare const ORG_QUERY_PARAM = "org";
+/**
+ * Append the active backend identity to an in-app path so opening it in a new
+ * browsing context resolves against the same backend.
+ */
+export declare function withBackendSelectionParams(path: string, active: ResolvedActiveBackend): string;
+/**
+ * Read a backend selection off the current URL, keeping it only when it names
+ * a registered backend. An unknown id (a link from another machine, or a
+ * backend that has since been removed) is ignored so the caller falls back to
+ * the stored selection.
+ */
+export declare function readBackendSelectionFromUrl(backends: Backend[], search: string): BackendSelection | null;
+/** The current tab's query string, or "" outside a browser. */
+export declare function currentLocationSearch(): string;

package/dist/api/backend-registry/url-selection.js

@@ -0,0 +1,29 @@
+//#region src/api/backend-registry/url-selection.ts
+var e = "backend";
+function t(t, n) {
+	let { backend: r, orgId: i } = n;
+	if (!r.id) return t;
+	let [a, o = ""] = t.split("?"), s = new URLSearchParams(o);
+	return s.set(e, r.id), i && s.set("org", i), `${a}?${s.toString()}`;
+}
+function n(t, n) {
+	if (!n) return null;
+	let r;
+	try {
+		r = new URLSearchParams(n);
+	} catch {
+		return null;
+	}
+	let i = r.get(e);
+	return !i || !t.some((e) => e.id === i) ? null : {
+		backendId: i,
+		orgId: r.get("org") || null
+	};
+}
+function r() {
+	return typeof window > "u" ? "" : window.location.search;
+}
+//#endregion
+export { r as currentLocationSearch, n as readBackendSelectionFromUrl, t as withBackendSelectionParams };
+
+//# sourceMappingURL=url-selection.js.map

package/dist/api/backend-registry/url-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-selection.js","names":[],"sources":["../../../src/api/backend-registry/url-selection.ts"],"sourcesContent":["import type { Backend, BackendSelection, ResolvedActiveBackend } from \"./types\";\n\n/**\n * Query parameters that pin a link to the backend (and cloud org) that owns\n * the linked resource.\n *\n * The active backend is tab-scoped: `readStoredActiveBackend()` prefers\n * `sessionStorage` and only falls back to `localStorage`. A tab opened with\n * cmd/ctrl-click or middle-click does not reliably inherit the opener's\n * `sessionStorage`, so it can boot from the `localStorage` fallback — which\n * holds whichever backend was selected *last in any tab*, not the one the\n * sidebar we were just looking at belongs to. The new tab then resolves the\n * conversation id against the wrong backend and shows \"conversation not\n * found\". Carrying the identity in the URL makes the link self-describing so\n * the new tab pins to the right backend regardless of what storage holds.\n */\nexport const BACKEND_QUERY_PARAM = \"backend\";\nexport const ORG_QUERY_PARAM = \"org\";\n\n/**\n * Append the active backend identity to an in-app path so opening it in a new\n * browsing context resolves against the same backend.\n */\nexport function withBackendSelectionParams(\n  path: string,\n  active: ResolvedActiveBackend,\n): string {\n  const { backend, orgId } = active;\n  if (!backend.id) return path;\n\n  const [pathname, existingSearch = \"\"] = path.split(\"?\");\n  const params = new URLSearchParams(existingSearch);\n  params.set(BACKEND_QUERY_PARAM, backend.id);\n  if (orgId) params.set(ORG_QUERY_PARAM, orgId);\n\n  return `${pathname}?${params.toString()}`;\n}\n\n/**\n * Read a backend selection off the current URL, keeping it only when it names\n * a registered backend. An unknown id (a link from another machine, or a\n * backend that has since been removed) is ignored so the caller falls back to\n * the stored selection.\n */\nexport function readBackendSelectionFromUrl(\n  backends: Backend[],\n  search: string,\n): BackendSelection | null {\n  if (!search) return null;\n\n  let params: URLSearchParams;\n  try {\n    params = new URLSearchParams(search);\n  } catch {\n    return null;\n  }\n\n  const backendId = params.get(BACKEND_QUERY_PARAM);\n  if (!backendId) return null;\n  if (!backends.some((backend) => backend.id === backendId)) return null;\n\n  const orgId = params.get(ORG_QUERY_PARAM);\n  return { backendId, orgId: orgId || null };\n}\n\n/** The current tab's query string, or \"\" outside a browser. */\nexport function currentLocationSearch(): string {\n  if (typeof window === \"undefined\") return \"\";\n  return window.location.search;\n}\n"],"mappings":";AAgBA,IAAa,IAAsB;AAOnC,SAAgB,EACd,GACA,GACQ;CACR,IAAM,EAAE,YAAS,aAAU;CAC3B,IAAI,CAAC,EAAQ,IAAI,OAAO;CAExB,IAAM,CAAC,GAAU,IAAiB,MAAM,EAAK,MAAM,GAAG,GAChD,IAAS,IAAI,gBAAgB,CAAc;CAIjD,OAHA,EAAO,IAAI,GAAqB,EAAQ,EAAE,GACtC,KAAO,EAAO,IAAA,OAAqB,CAAK,GAErC,GAAG,EAAS,GAAG,EAAO,SAAS;AACxC;AAQA,SAAgB,EACd,GACA,GACyB;CACzB,IAAI,CAAC,GAAQ,OAAO;CAEpB,IAAI;CACJ,IAAI;EACF,IAAS,IAAI,gBAAgB,CAAM;CACrC,QAAQ;EACN,OAAO;CACT;CAEA,IAAM,IAAY,EAAO,IAAI,CAAmB;CAKhD,OAJI,CAAC,KACD,CAAC,EAAS,MAAM,MAAY,EAAQ,OAAO,CAAS,IAAU,OAG3D;EAAE;EAAW,OADN,EAAO,IAAA,KACM,KAAS;CAAK;AAC3C;AAGA,SAAgB,IAAgC;CAE9C,OADI,OAAO,SAAW,MAAoB,KACnC,OAAO,SAAS;AACzB"}

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

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("../backend-registry/active-store.cjs"),t=require("../client-source.cjs"),n=require("./proxy.cjs"),r=require("../conversation-metadata-store.cjs");function i(e){if(!e?.id)return e;let t=r.getStoredConversationMetadata(e.id);return t?{...e,selected_repository:e.selected_repository??t.selected_repository??null,selected_branch:e.selected_branch??t.selected_branch??null,git_provider:e.git_provider??t.git_provider??null,selected_workspace:e.selected_workspace??t.selected_workspace??null}:e}function a(){let t=e.getActiveBackend().backend;if(t.kind!==`cloud`)throw Error(`Cloud conversations call requires a cloud backend.`);return t}async function o(e=20,t){let r=a(),o=new URLSearchParams;o.set(`limit`,String(e)),t&&o.set(`page_id`,t),o.set(`sort_order`,`UPDATED_AT_DESC`);let s=await n.callCloudProxy({backend:r,method:`GET`,path:`/api/v1/app-conversations/search?${o.toString()}`});return{items:(s?.items??[]).map(e=>i(e)),next_page_id:s?.next_page_id??null}}async function s(e){if(e.length===0)return[];let t=a(),r=new URLSearchParams;for(let t of e)r.append(`ids`,t);return(await n.callCloudProxy({backend:t,method:`GET`,path:`/api/v1/app-conversations?${r.toString()}`})??[]).map(i)}async function c(e){return await n.callCloudProxy({backend:a(),method:`POST`,path:`/api/v1/app-conversations`,body:e,headers:t.AGENT_CANVAS_CLIENT_HEADERS})}async function l(e){return n.callCloudProxy({backend:a(),method:`GET`,path:`/api/v1/app-conversations/${e}/download`,responseType:`blob`})}async function u(e){await n.callCloudProxy({backend:a(),method:`DELETE`,path:`/api/v1/app-conversations/${e}`})}async function d(e,t){return await n.callCloudProxy({backend:a(),method:`PATCH`,path:`/api/v1/app-conversations/${e}`,body:{public:t}})}async function f(e){await n.callCloudProxy({backend:a(),method:`POST`,path:`/api/v1/sandboxes/${e}/pause`})}async function p(e){await n.callCloudProxy({backend:a(),method:`POST`,path:`/api/v1/sandboxes/${e}/resume`})}async function m(e,t){let r=a(),i=new URLSearchParams;return i.append(`file_path`,t),await n.callCloudProxy({backend:r,method:`GET`,path:`/api/v1/app-conversations/${e}/file?${i.toString()}`})??``}async function h(e){let t=a(),r=new URLSearchParams;return r.set(`ids`,e),(await n.callCloudProxy({backend:t,method:`GET`,path:`/api/v1/app-conversations/start-tasks?${r.toString()}`}))?.[0]??null}exports.batchGetCloudConversations=s,exports.createCloudAppConversation=c,exports.deleteCloudConversation=u,exports.downloadCloudConversation=l,exports.getCloudAppConversationStartTask=h,exports.pauseCloudSandbox=f,exports.readCloudConversationFile=m,exports.resumeCloudSandbox=p,exports.searchCloudConversations=o,exports.updateCloudConversationPublicFlag=d;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("../backend-registry/active-store.cjs"),t=require("../client-source.cjs"),n=require("../conversation-metadata-store.cjs"),r=require("./proxy.cjs");function i(e){if(!e?.id)return e;let t=n.getStoredConversationMetadata(e.id);return t?{...e,selected_repository:e.selected_repository??t.selected_repository??null,selected_branch:e.selected_branch??t.selected_branch??null,git_provider:e.git_provider??t.git_provider??null,selected_workspace:e.selected_workspace??t.selected_workspace??null}:e}function a(){let t=e.getActiveBackend().backend;if(t.kind!==`cloud`)throw Error(`Cloud conversations call requires a cloud backend.`);return t}function o(){let t=e.getActiveBackend().backend;return t.kind===`cloud`?t:e.getRegisteredBackends().find(e=>e.kind===`cloud`&&!!e.apiKey)??null}async function s(e=20,t){let n=a(),o=new URLSearchParams;o.set(`limit`,String(e)),t&&o.set(`page_id`,t),o.set(`sort_order`,`UPDATED_AT_DESC`);let s=await r.callCloudProxy({backend:n,method:`GET`,path:`/api/v1/app-conversations/search?${o.toString()}`});return{items:(s?.items??[]).map(e=>i(e)),next_page_id:s?.next_page_id??null}}async function c(e){if(e.length===0)return[];let t=a(),n=new URLSearchParams;for(let t of e)n.append(`ids`,t);return(await r.callCloudProxy({backend:t,method:`GET`,path:`/api/v1/app-conversations?${n.toString()}`})??[]).map(i)}async function l(e,n){return await r.callCloudProxy({backend:n??a(),method:`POST`,path:`/api/v1/app-conversations`,body:e,headers:t.AGENT_CANVAS_CLIENT_HEADERS})}async function u(e){return r.callCloudProxy({backend:a(),method:`GET`,path:`/api/v1/app-conversations/${e}/download`,responseType:`blob`})}async function d(e){await r.callCloudProxy({backend:a(),method:`DELETE`,path:`/api/v1/app-conversations/${e}`})}async function f(e,t){return await r.callCloudProxy({backend:a(),method:`PATCH`,path:`/api/v1/app-conversations/${e}`,body:{public:t}})}async function p(e){await r.callCloudProxy({backend:a(),method:`POST`,path:`/api/v1/sandboxes/${e}/pause`})}async function m(e){await r.callCloudProxy({backend:a(),method:`POST`,path:`/api/v1/sandboxes/${e}/resume`})}async function h(e,t){let n=a(),i=new URLSearchParams;return i.append(`file_path`,t),await r.callCloudProxy({backend:n,method:`GET`,path:`/api/v1/app-conversations/${e}/file?${i.toString()}`})??``}async function g(e,t){let n=t??a(),i=new URLSearchParams;return i.set(`ids`,e),(await r.callCloudProxy({backend:n,method:`GET`,path:`/api/v1/app-conversations/start-tasks?${i.toString()}`}))?.[0]??null}exports.batchGetCloudConversations=c,exports.createCloudAppConversation=l,exports.deleteCloudConversation=d,exports.downloadCloudConversation=u,exports.getCloudAppConversationStartTask=g,exports.pauseCloudSandbox=p,exports.pickCloudBackendForLaunch=o,exports.readCloudConversationFile=h,exports.resumeCloudSandbox=m,exports.searchCloudConversations=s,exports.updateCloudConversationPublicFlag=f;
 //# sourceMappingURL=conversation-service.api.cjs.map

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 { AGENT_CANVAS_CLIENT_HEADERS } from \"../client-source\";\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    headers: AGENT_CANVAS_CLIENT_HEADERS,\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":"mNA0BA,SAAS,EACP,EACwB,CACxB,GAAI,CAAC,GAAc,GAAI,OAAO,EAC9B,IAAM,EAAS,EAAA,8BAA8B,EAAa,EAAE,EAG5D,OAFK,EAEE,CACL,GAAG,EACH,oBACE,EAAa,qBAAuB,EAAO,qBAAuB,KACpE,gBACE,EAAa,iBAAmB,EAAO,iBAAmB,KAC5D,aAAc,EAAa,cAAgB,EAAO,cAAgB,KAClE,mBACE,EAAa,oBAAsB,EAAO,oBAAsB,IACpE,EAXoB,CAYtB,CAEA,SAAS,GAAiC,CACxC,IAAM,EAAS,EAAA,iBAAiB,EAAE,QAClC,GAAI,EAAO,OAAS,QAClB,MAAU,MAAM,oDAAoD,EAEtE,OAAO,CACT,CAOA,eAAsB,EACpB,EAAgB,GAChB,EAC8B,CAC9B,IAAM,EAAU,EAAsB,EAChC,EAAS,IAAI,gBACnB,EAAO,IAAI,QAAS,OAAO,CAAK,CAAC,EAC7B,GAAQ,EAAO,IAAI,UAAW,CAAM,EACxC,EAAO,IAAI,aAAc,iBAAiB,EAE1C,IAAM,EAAO,MAAM,EAAA,eAGhB,CACD,UACA,OAAQ,MACR,KAAM,oCAAoC,EAAO,SAAS,GAC5D,CAAC,EAED,MAAO,CACL,OAAQ,GAAM,OAAS,CAAC,GAAG,IACxB,GAAS,EAA2B,CAAI,CAC3C,EACA,aAAc,GAAM,cAAgB,IACtC,CACF,CAMA,eAAsB,EACpB,EACqC,CACrC,GAAI,EAAI,SAAW,EAAG,MAAO,CAAC,EAC9B,IAAM,EAAU,EAAsB,EAChC,EAAS,IAAI,gBACnB,IAAK,IAAM,KAAM,EAAK,EAAO,OAAO,MAAO,CAAE,EAM7C,OAAQ,MALW,EAAA,eAA2C,CAC5D,UACA,OAAQ,MACR,KAAM,6BAA6B,EAAO,SAAS,GACrD,CAAC,GACe,CAAC,GAAG,IAAI,CAA0B,CACpD,CAkBA,eAAsB,EACpB,EACmC,CASnC,OAAO,MAPY,EAAA,eAAyC,CAC1D,QAFc,EAEd,EACA,OAAQ,OACR,KAAM,4BACN,KAAM,EACN,QAAS,EAAA,2BACX,CAAC,CAEH,CASA,eAAsB,EACpB,EACe,CAEf,OAAO,EAAA,eAAqB,CAC1B,QAFc,EAEd,EACA,OAAQ,MACR,KAAM,6BAA6B,EAAe,WAClD,aAAc,MAChB,CAAC,CACH,CASA,eAAsB,EACpB,EACe,CAEf,MAAM,EAAA,eAAwB,CAC5B,QAFc,EAEd,EACA,OAAQ,SACR,KAAM,6BAA6B,GACrC,CAAC,CACH,CAQA,eAAsB,EACpB,EACA,EAC0B,CAQ1B,OAAO,MANY,EAAA,eAAgC,CACjD,QAFc,EAEd,EACA,OAAQ,QACR,KAAM,6BAA6B,IACnC,KAAM,CAAE,OAAQ,CAAS,CAC3B,CAAC,CAEH,CAQA,eAAsB,EAAkB,EAAkC,CAExE,MAAM,EAAA,eAAwB,CAC5B,QAFc,EAEd,EACA,OAAQ,OACR,KAAM,qBAAqB,EAAU,OACvC,CAAC,CACH,CAWA,eAAsB,EAAmB,EAAkC,CAEzE,MAAM,EAAA,eAAwB,CAC5B,QAFc,EAEd,EACA,OAAQ,OACR,KAAM,qBAAqB,EAAU,QACvC,CAAC,CACH,CAQA,eAAsB,EACpB,EACA,EACiB,CACjB,IAAM,EAAU,EAAsB,EAChC,EAAS,IAAI,gBAOnB,OANA,EAAO,OAAO,YAAa,CAAQ,EAM5B,MALY,EAAA,eAAuB,CACxC,UACA,OAAQ,MACR,KAAM,6BAA6B,EAAe,QAAQ,EAAO,SAAS,GAC5E,CAAC,GACc,EACjB,CAOA,eAAsB,EACpB,EAC0C,CAC1C,IAAM,EAAU,EAAsB,EAChC,EAAS,IAAI,gBAOnB,OANA,EAAO,IAAI,MAAO,CAAM,GAMjB,MALY,EAAA,eAAoD,CACrE,UACA,OAAQ,MACR,KAAM,yCAAyC,EAAO,SAAS,GACjE,CAAC,KACa,IAAM,IACtB"}
+{"version":3,"file":"conversation-service.api.cjs","names":[],"sources":["../../../src/api/cloud/conversation-service.api.ts"],"sourcesContent":["import {\n  getActiveBackend,\n  getRegisteredBackends,\n} 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 { AGENT_CANVAS_CLIENT_HEADERS } from \"../client-source\";\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 * Resolve the cloud backend a Cloud conversation should be launched against\n * when the active backend may not be a cloud one. Cloud conversations cannot\n * register client tools, so the typed launch action always runs from a local\n * parent and has to reach a registered-but-inactive cloud backend.\n *\n * Prefers the active backend when it is already cloud, then the first\n * registered cloud backend that carries credentials. Returns `null` when the\n * user has no cloud backend connected, so callers can give the agent\n * corrective guidance instead of failing opaquely.\n *\n * Note: `createCloudClient` only sends `X-Org-Id` for the *active* backend, so\n * a conversation launched against an inactive backend lands in the API key's\n * own organization.\n */\nexport function pickCloudBackendForLaunch(): Backend | null {\n  const active = getActiveBackend().backend;\n  if (active.kind === \"cloud\") return active;\n  return (\n    getRegisteredBackends().find(\n      (backend) => backend.kind === \"cloud\" && !!backend.apiKey,\n    ) ?? null\n  );\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  // Defaults to the active backend. The typed launch action passes an explicit\n  // backend because it always runs from a *local* parent conversation.\n  backendOverride?: Backend,\n): Promise<AppConversationStartTask> {\n  const backend = backendOverride ?? 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    headers: AGENT_CANVAS_CLIENT_HEADERS,\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  backendOverride?: Backend,\n): Promise<AppConversationStartTask | null> {\n  const backend = backendOverride ?? 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,4 +1,21 @@
+import type { Backend } from "../backend-registry/types";
 import type { AppConversation, AppConversationPage, AppConversationStartRequest, AppConversationStartTask } from "../conversation-service/agent-server-conversation-service.types";
+/**
+ * Resolve the cloud backend a Cloud conversation should be launched against
+ * when the active backend may not be a cloud one. Cloud conversations cannot
+ * register client tools, so the typed launch action always runs from a local
+ * parent and has to reach a registered-but-inactive cloud backend.
+ *
+ * Prefers the active backend when it is already cloud, then the first
+ * registered cloud backend that carries credentials. Returns `null` when the
+ * user has no cloud backend connected, so callers can give the agent
+ * corrective guidance instead of failing opaquely.
+ *
+ * Note: `createCloudClient` only sends `X-Org-Id` for the *active* backend, so
+ * a conversation launched against an inactive backend lands in the API key's
+ * own organization.
+ */
+export declare function pickCloudBackendForLaunch(): Backend | null;
 /**
  * Search the cloud app-conversations list. Mirrors the local
  * `AgentServerConversationService.searchConversations` interface but calls
@@ -26,7 +43,7 @@ export declare function batchGetCloudConversations(ids: string[]): Promise<(AppC
  * provisioned with its own ephemeral session_api_key returned in the
  * task.
  */
-export declare function createCloudAppConversation(request: AppConversationStartRequest): Promise<AppConversationStartTask>;
+export declare function createCloudAppConversation(request: AppConversationStartRequest, backendOverride?: Backend): Promise<AppConversationStartTask>;
 /**
  * Download a v1 app-conversation as a ZIP from the cloud backend. Mirrors
  * the local `AgentServerConversationService.downloadConversation` interface but
@@ -79,4 +96,4 @@ export declare function readCloudConversationFile(conversationId: string, filePa
  * `AgentServerConversationService.getStartTask` — uses the batch search endpoint
  * with a single id and unwraps the first result.
  */
-export declare function getCloudAppConversationStartTask(taskId: string): Promise<AppConversationStartTask | null>;
+export declare function getCloudAppConversationStartTask(taskId: string, backendOverride?: Backend): Promise<AppConversationStartTask | null>;