@openhands/agent-canvas 1.15.0 → 1.17.0

package/dist/hooks/query/use-backends-health.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-backends-health.cjs","names":[],"sources":["../../../src/hooks/query/use-backends-health.ts"],"sourcesContent":["import React from \"react\";\nimport axios from \"axios\";\nimport { useQueries } from \"@tanstack/react-query\";\nimport { HttpError } from \"@openhands/typescript-client\";\nimport {\n  ServerClient,\n  SettingsClient,\n} from \"@openhands/typescript-client/clients\";\nimport {\n  getCloudOrganizations,\n  getCurrentCloudApiKey,\n} from \"#/api/cloud/organization-service.api\";\nimport {\n  assertAgentServerVersionIsSupported,\n  isSdkHttpStatusError,\n} from \"#/api/agent-server-compatibility\";\nimport type { Backend } from \"#/api/backend-registry/types\";\nimport { getAgentServerClientOptions } from \"#/api/agent-server-client-options\";\nimport {\n  isCorsOrNetworkError,\n  isCorsOrNetworkErrorMessage,\n} from \"#/utils/user-facing-error\";\nimport {\n  getHealthSnapshot,\n  recordBackendFailure,\n  recordBackendSuccess,\n  subscribeBackendHealth,\n} from \"#/api/backend-registry/health-store\";\nimport { MAX_CONSECUTIVE_FAILURES } from \"#/api/backend-registry/health-storage\";\n\n// 30s: each tick costs two sequential requests per backend (settings +\n// server_info), which on slow links measurably competes with conversation\n// traffic for the browser's per-origin HTTP/1.1 connection pool.\nconst REFRESH_INTERVAL_MS = 30000;\nconst PROBE_TIMEOUT_MS = 4000;\nexport const INVALID_BACKEND_API_KEY_ERROR = \"Invalid API key\";\nexport const MISSING_BACKEND_API_KEY_ERROR = \"API key required\";\nexport const CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR =\n  \"Cloud API key or network issue\";\nexport const CLOUD_BACKEND_LOGGED_OUT_ERROR = \"Logged out\";\n\nexport function isInvalidBackendApiKeyHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === INVALID_BACKEND_API_KEY_ERROR;\n}\n\nexport function isMissingBackendApiKeyHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === MISSING_BACKEND_API_KEY_ERROR;\n}\n\nexport function isCloudBackendApiKeyOrNetworkHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR;\n}\n\nfunction hasMissingBackendApiKey(backend: Backend): boolean {\n  return (\n    backend.kind === \"cloud\" &&\n    backend.authMode !== \"cookie\" &&\n    !backend.apiKey.trim()\n  );\n}\n\nexport function isCloudBackendLoggedOutHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === CLOUD_BACKEND_LOGGED_OUT_ERROR;\n}\n\n/**\n * Probe a single backend for connectivity. The probe path differs by\n * backend kind:\n *\n *  - Local agent-server: GET `/api/settings`, then `/server_info` via the\n *    typescript-client. The settings call validates the configured session\n *    API key; the server info call validates the version compatibility floor.\n *  - Cloud: GET `/api/keys/current` directly against the cloud host. That\n *    endpoint is lightweight, requires auth, and `getCurrentCloudApiKey`\n *    already absorbs the legacy-key 400 fallback so we treat that as\n *    \"connected\" too. Missing / rejected keys are reported explicitly instead\n *    of falling through to the browser's opaque CORS/network error shape.\n *\n * Throws on failure so React Query marks the query as errored — the\n * dropdown reads `isSuccess` to flip the indicator green.\n */\nasync function probeBackend(backend: Backend): Promise<true> {\n  if (backend.kind === \"cloud\") {\n    if (backend.authMode !== \"cookie\" && !backend.apiKey?.trim()) {\n      throw new Error(MISSING_BACKEND_API_KEY_ERROR);\n    }\n\n    try {\n      if (backend.authMode === \"cookie\") {\n        await getCloudOrganizations(backend);\n      } else {\n        await getCurrentCloudApiKey(backend);\n      }\n    } catch (error) {\n      if (\n        (axios.isAxiosError(error) && error.response?.status === 401) ||\n        (error instanceof HttpError && error.status === 401)\n      ) {\n        throw new Error(CLOUD_BACKEND_LOGGED_OUT_ERROR);\n      }\n      if (isCorsOrNetworkError(error)) {\n        throw new Error(CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR);\n      }\n      throw error;\n    }\n    return true;\n  }\n\n  try {\n    const clientOptions = getAgentServerClientOptions({\n      host: backend.host,\n      sessionApiKey: backend.apiKey || null,\n      timeout: PROBE_TIMEOUT_MS,\n    });\n\n    await new SettingsClient(clientOptions).getSettings();\n    const serverInfo = await new ServerClient(clientOptions).getServerInfo();\n    assertAgentServerVersionIsSupported(serverInfo);\n  } catch (error) {\n    if (isSdkHttpStatusError(error, 401)) {\n      throw new Error(INVALID_BACKEND_API_KEY_ERROR);\n    }\n    throw error;\n  }\n  return true;\n}\n\n/**\n * How many extra times to re-run a failed probe before giving up, and how\n * long to wait between attempts.\n */\nconst PROBE_RETRY_ATTEMPTS = 2;\nconst PROBE_RETRY_DELAY_MS = 300;\n\n/**\n * Probe a backend, retrying a couple of times on failure before giving up.\n *\n * The connectivity indicator (and the onboarding \"backend connected\" banner)\n * only flips green once a probe succeeds. With `retry: false` at the query\n * level and a REFRESH_INTERVAL_MS (30s) poll, a single transient first-probe\n * miss — the agent-server still warming up right after navigation, a momentary\n * proxy 5xx, a dropped connection — would otherwise leave the banner stuck\n * until the next scheduled refetch. That is the root cause of the\n * flaky onboarding e2e \"backend health probe should report connected\" timeout.\n *\n * Retrying here, inside the query function rather than via React Query's\n * `retry`, is deliberate: the success/failure recording below runs once per\n * settled query, so a single logical probe still records exactly one outcome.\n * Retrying at the query level instead would call `recordBackendFailure` on\n * every internal attempt and reach the disabled cap several times too fast.\n *\n * Definitive auth failures (logged out, invalid/missing key) are NOT retried:\n * they are a decided server response, not a transient miss, so retrying only\n * delays surfacing the correct \"disconnected\" state (and the recovery UI).\n */\nfunction isRetryableProbeError(error: unknown): boolean {\n  if (!(error instanceof Error)) return true;\n  return (\n    error.message !== INVALID_BACKEND_API_KEY_ERROR &&\n    error.message !== MISSING_BACKEND_API_KEY_ERROR &&\n    error.message !== CLOUD_BACKEND_LOGGED_OUT_ERROR\n  );\n}\n\nasync function probeBackendWithQuickRetry(backend: Backend): Promise<true> {\n  for (let attempt = 0; ; attempt += 1) {\n    try {\n      return await probeBackend(backend);\n    } catch (error) {\n      if (attempt >= PROBE_RETRY_ATTEMPTS || !isRetryableProbeError(error)) {\n        throw error;\n      }\n      await new Promise((resolve) => {\n        setTimeout(resolve, PROBE_RETRY_DELAY_MS);\n      });\n    }\n  }\n}\n\nexport interface BackendHealth {\n  /** `null` while the first probe is in flight; then `true` / `false`. */\n  isConnected: boolean | null;\n  /** Number of consecutive failed probes since the last success. */\n  consecutiveFailures: number;\n  /** Last error message captured from a failed probe, if any. */\n  lastError: string | null;\n  /**\n   * `true` once `consecutiveFailures` reaches the cap. While disabled,\n   * ordinary background polling stops and survives a page refresh in\n   * that state.\n   */\n  disabled: boolean;\n}\n\nexport interface UseBackendsHealthOptions {\n  /**\n   * Re-probe disabled backends once when the hook mounts. Used by the\n   * Manage Backends modal so a recovered backend can clear its stale\n   * persisted error state without forcing the user to edit the config.\n   */\n  probeDisabledOnce?: boolean;\n}\n\n/**\n * Poll every backend in `backends` once every 10s and report a simple\n * connected / disconnected verdict per backend id.\n *\n * The query key includes `host` and `apiKey` so editing a backend's\n * connection details re-keys the query and triggers an immediate\n * refetch instead of waiting for the next tick.\n *\n * After `MAX_CONSECUTIVE_FAILURES` failures in a row, ordinary polling\n * stops for that backend until the user updates its host / apiKey.\n * Callers can still opt into a one-shot recheck for disabled backends\n * (for example when the user explicitly opens Manage Backends). The\n * failure count and last error live in localStorage so a page refresh\n * does not silently re-arm polling against a backend that's known to\n * be unreachable.\n */\nexport function useBackendsHealth(\n  backends: Backend[],\n  options: UseBackendsHealthOptions = {},\n): Record<string, BackendHealth> {\n  const { probeDisabledOnce = false } = options;\n  const healthMap = React.useSyncExternalStore(\n    subscribeBackendHealth,\n    getHealthSnapshot,\n    getHealthSnapshot,\n  );\n\n  const results = useQueries({\n    queries: backends.map((b) => {\n      const entry = healthMap[b.id];\n      const hasMissingCloudApiKey = hasMissingBackendApiKey(b);\n      const isDisabled = entry?.disabled === true;\n      const shouldReprobeStaleCloudNetworkError =\n        isDisabled &&\n        b.kind === \"cloud\" &&\n        isCorsOrNetworkErrorMessage(entry?.lastError);\n      const shouldProbe =\n        !hasMissingCloudApiKey &&\n        (!isDisabled ||\n          probeDisabledOnce ||\n          shouldReprobeStaleCloudNetworkError);\n      return {\n        queryKey: [\n          \"backend-health\",\n          b.id,\n          b.kind,\n          b.host,\n          b.apiKey ?? \"\",\n        ] as const,\n        queryFn: async () => {\n          try {\n            const result = await probeBackendWithQuickRetry(b);\n            recordBackendSuccess(b.id);\n            return result;\n          } catch (err) {\n            recordBackendFailure(b.id, err);\n            throw err;\n          }\n        },\n        enabled: shouldProbe,\n        refetchInterval:\n          isDisabled || hasMissingCloudApiKey\n            ? (false as const)\n            : REFRESH_INTERVAL_MS,\n        refetchIntervalInBackground: false,\n        refetchOnMount: isDisabled && probeDisabledOnce ? \"always\" : true,\n        refetchOnReconnect: !isDisabled && !hasMissingCloudApiKey,\n        refetchOnWindowFocus: !isDisabled && !hasMissingCloudApiKey,\n        retry: false,\n        // Keep the previous verdict visible while the next probe is in\n        // flight so the indicator doesn't flicker on routine polling.\n        staleTime: isDisabled ? 0 : REFRESH_INTERVAL_MS,\n        meta: { disableToast: true },\n      };\n    }),\n  });\n\n  const out: Record<string, BackendHealth> = {};\n  backends.forEach((b, i) => {\n    const r = results[i];\n    const entry = healthMap[b.id];\n    const hasMissingCloudApiKey = hasMissingBackendApiKey(b);\n    const disabled = hasMissingCloudApiKey ? false : entry?.disabled === true;\n    const consecutiveFailures = hasMissingCloudApiKey\n      ? 0\n      : (entry?.consecutiveFailures ?? 0);\n    const lastError = hasMissingCloudApiKey\n      ? MISSING_BACKEND_API_KEY_ERROR\n      : (entry?.lastError ?? null);\n\n    let isConnected: boolean | null;\n    if (hasMissingCloudApiKey) {\n      isConnected = false;\n    } else if (disabled) {\n      // Polling stopped after hitting the cap — treat as disconnected\n      // so existing consumers (dot, badge) render red without needing\n      // to know about the new fields.\n      isConnected = false;\n    } else if (r.isSuccess) isConnected = true;\n    else if (r.isError) isConnected = false;\n    else isConnected = null;\n\n    out[b.id] = { isConnected, consecutiveFailures, lastError, disabled };\n  });\n  return out;\n}\n\nexport { MAX_CONSECUTIVE_FAILURES };\n"],"mappings":"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"}
+{"version":3,"file":"use-backends-health.cjs","names":[],"sources":["../../../src/hooks/query/use-backends-health.ts"],"sourcesContent":["import React from \"react\";\nimport axios from \"axios\";\nimport { useQueries } from \"@tanstack/react-query\";\nimport { HttpError } from \"@openhands/typescript-client\";\nimport {\n  getCloudOrganizations,\n  getCurrentCloudApiKey,\n} from \"#/api/cloud/organization-service.api\";\nimport {\n  validateLocalBackend,\n  INVALID_BACKEND_API_KEY_ERROR,\n} from \"#/api/agent-server-compatibility\";\nimport type { Backend } from \"#/api/backend-registry/types\";\nimport {\n  isCorsOrNetworkError,\n  isCorsOrNetworkErrorMessage,\n} from \"#/utils/user-facing-error\";\nimport {\n  getHealthSnapshot,\n  recordBackendFailure,\n  recordBackendSuccess,\n  subscribeBackendHealth,\n} from \"#/api/backend-registry/health-store\";\nimport { MAX_CONSECUTIVE_FAILURES } from \"#/api/backend-registry/health-storage\";\n\n// 30s: each tick costs two sequential requests per backend (settings +\n// server_info), which on slow links measurably competes with conversation\n// traffic for the browser's per-origin HTTP/1.1 connection pool.\nconst REFRESH_INTERVAL_MS = 30000;\nconst PROBE_TIMEOUT_MS = 4000;\nexport { INVALID_BACKEND_API_KEY_ERROR } from \"#/api/agent-server-compatibility\";\nexport const MISSING_BACKEND_API_KEY_ERROR = \"API key required\";\nexport const CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR =\n  \"Cloud API key or network issue\";\nexport const CLOUD_BACKEND_LOGGED_OUT_ERROR = \"Logged out\";\n\nexport function isInvalidBackendApiKeyHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === INVALID_BACKEND_API_KEY_ERROR;\n}\n\nexport function isMissingBackendApiKeyHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === MISSING_BACKEND_API_KEY_ERROR;\n}\n\nexport function isCloudBackendApiKeyOrNetworkHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR;\n}\n\nfunction hasMissingBackendApiKey(backend: Backend): boolean {\n  return (\n    backend.kind === \"cloud\" &&\n    backend.authMode !== \"cookie\" &&\n    !backend.apiKey.trim()\n  );\n}\n\nexport function isCloudBackendLoggedOutHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === CLOUD_BACKEND_LOGGED_OUT_ERROR;\n}\n\n/**\n * Probe a single backend for connectivity. The probe path differs by\n * backend kind:\n *\n *  - Local agent-server: GET `/api/settings`, then `/server_info` via the\n *    typescript-client. The settings call validates the configured session\n *    API key; the server info call validates the version compatibility floor.\n *  - Cloud: GET `/api/keys/current` directly against the cloud host. That\n *    endpoint is lightweight, requires auth, and `getCurrentCloudApiKey`\n *    already absorbs the legacy-key 400 fallback so we treat that as\n *    \"connected\" too. Missing / rejected keys are reported explicitly instead\n *    of falling through to the browser's opaque CORS/network error shape.\n *\n * Throws on failure so React Query marks the query as errored — the\n * dropdown reads `isSuccess` to flip the indicator green.\n */\nasync function probeBackend(backend: Backend): Promise<true> {\n  if (backend.kind === \"cloud\") {\n    if (backend.authMode !== \"cookie\" && !backend.apiKey?.trim()) {\n      throw new Error(MISSING_BACKEND_API_KEY_ERROR);\n    }\n\n    try {\n      if (backend.authMode === \"cookie\") {\n        await getCloudOrganizations(backend);\n      } else {\n        await getCurrentCloudApiKey(backend);\n      }\n    } catch (error) {\n      if (\n        (axios.isAxiosError(error) && error.response?.status === 401) ||\n        (error instanceof HttpError && error.status === 401)\n      ) {\n        throw new Error(CLOUD_BACKEND_LOGGED_OUT_ERROR);\n      }\n      if (isCorsOrNetworkError(error)) {\n        throw new Error(CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR);\n      }\n      throw error;\n    }\n    return true;\n  }\n\n  await validateLocalBackend(backend, PROBE_TIMEOUT_MS);\n  return true;\n}\n\n/**\n * How many extra times to re-run a failed probe before giving up, and how\n * long to wait between attempts.\n */\nconst PROBE_RETRY_ATTEMPTS = 2;\nconst PROBE_RETRY_DELAY_MS = 300;\n\n/**\n * Probe a backend, retrying a couple of times on failure before giving up.\n *\n * The connectivity indicator (and the onboarding \"backend connected\" banner)\n * only flips green once a probe succeeds. With `retry: false` at the query\n * level and a REFRESH_INTERVAL_MS (30s) poll, a single transient first-probe\n * miss — the agent-server still warming up right after navigation, a momentary\n * proxy 5xx, a dropped connection — would otherwise leave the banner stuck\n * until the next scheduled refetch. That is the root cause of the\n * flaky onboarding e2e \"backend health probe should report connected\" timeout.\n *\n * Retrying here, inside the query function rather than via React Query's\n * `retry`, is deliberate: the success/failure recording below runs once per\n * settled query, so a single logical probe still records exactly one outcome.\n * Retrying at the query level instead would call `recordBackendFailure` on\n * every internal attempt and reach the disabled cap several times too fast.\n *\n * Definitive auth failures (logged out, invalid/missing key) are NOT retried:\n * they are a decided server response, not a transient miss, so retrying only\n * delays surfacing the correct \"disconnected\" state (and the recovery UI).\n */\nfunction isRetryableProbeError(error: unknown): boolean {\n  if (!(error instanceof Error)) return true;\n  return (\n    error.message !== INVALID_BACKEND_API_KEY_ERROR &&\n    error.message !== MISSING_BACKEND_API_KEY_ERROR &&\n    error.message !== CLOUD_BACKEND_LOGGED_OUT_ERROR\n  );\n}\n\nasync function probeBackendWithQuickRetry(backend: Backend): Promise<true> {\n  for (let attempt = 0; ; attempt += 1) {\n    try {\n      return await probeBackend(backend);\n    } catch (error) {\n      if (attempt >= PROBE_RETRY_ATTEMPTS || !isRetryableProbeError(error)) {\n        throw error;\n      }\n      await new Promise((resolve) => {\n        setTimeout(resolve, PROBE_RETRY_DELAY_MS);\n      });\n    }\n  }\n}\n\nexport interface BackendHealth {\n  /** `null` while the first probe is in flight; then `true` / `false`. */\n  isConnected: boolean | null;\n  /** Number of consecutive failed probes since the last success. */\n  consecutiveFailures: number;\n  /** Last error message captured from a failed probe, if any. */\n  lastError: string | null;\n  /**\n   * `true` once `consecutiveFailures` reaches the cap. While disabled,\n   * ordinary background polling stops and survives a page refresh in\n   * that state.\n   */\n  disabled: boolean;\n}\n\nexport interface UseBackendsHealthOptions {\n  /**\n   * Re-probe disabled backends once when the hook mounts. Used by the\n   * Manage Backends modal so a recovered backend can clear its stale\n   * persisted error state without forcing the user to edit the config.\n   */\n  probeDisabledOnce?: boolean;\n}\n\n/**\n * Poll every backend in `backends` once every 10s and report a simple\n * connected / disconnected verdict per backend id.\n *\n * The query key includes `host` and `apiKey` so editing a backend's\n * connection details re-keys the query and triggers an immediate\n * refetch instead of waiting for the next tick.\n *\n * After `MAX_CONSECUTIVE_FAILURES` failures in a row, ordinary polling\n * stops for that backend until the user updates its host / apiKey.\n * Callers can still opt into a one-shot recheck for disabled backends\n * (for example when the user explicitly opens Manage Backends). The\n * failure count and last error live in localStorage so a page refresh\n * does not silently re-arm polling against a backend that's known to\n * be unreachable.\n */\nexport function useBackendsHealth(\n  backends: Backend[],\n  options: UseBackendsHealthOptions = {},\n): Record<string, BackendHealth> {\n  const { probeDisabledOnce = false } = options;\n  const healthMap = React.useSyncExternalStore(\n    subscribeBackendHealth,\n    getHealthSnapshot,\n    getHealthSnapshot,\n  );\n\n  const results = useQueries({\n    queries: backends.map((b) => {\n      const entry = healthMap[b.id];\n      const hasMissingCloudApiKey = hasMissingBackendApiKey(b);\n      const isDisabled = entry?.disabled === true;\n      const shouldReprobeStaleCloudNetworkError =\n        isDisabled &&\n        b.kind === \"cloud\" &&\n        isCorsOrNetworkErrorMessage(entry?.lastError);\n      const shouldProbe =\n        !hasMissingCloudApiKey &&\n        (!isDisabled ||\n          probeDisabledOnce ||\n          shouldReprobeStaleCloudNetworkError);\n      return {\n        queryKey: [\n          \"backend-health\",\n          b.id,\n          b.kind,\n          b.host,\n          b.apiKey ?? \"\",\n        ] as const,\n        queryFn: async () => {\n          try {\n            const result = await probeBackendWithQuickRetry(b);\n            recordBackendSuccess(b.id);\n            return result;\n          } catch (err) {\n            recordBackendFailure(b.id, err);\n            throw err;\n          }\n        },\n        enabled: shouldProbe,\n        refetchInterval:\n          isDisabled || hasMissingCloudApiKey\n            ? (false as const)\n            : REFRESH_INTERVAL_MS,\n        refetchIntervalInBackground: false,\n        refetchOnMount: isDisabled && probeDisabledOnce ? \"always\" : true,\n        refetchOnReconnect: !isDisabled && !hasMissingCloudApiKey,\n        refetchOnWindowFocus: !isDisabled && !hasMissingCloudApiKey,\n        retry: false,\n        // Keep the previous verdict visible while the next probe is in\n        // flight so the indicator doesn't flicker on routine polling.\n        staleTime: isDisabled ? 0 : REFRESH_INTERVAL_MS,\n        meta: { disableToast: true },\n      };\n    }),\n  });\n\n  const out: Record<string, BackendHealth> = {};\n  backends.forEach((b, i) => {\n    const r = results[i];\n    const entry = healthMap[b.id];\n    const hasMissingCloudApiKey = hasMissingBackendApiKey(b);\n    const disabled = hasMissingCloudApiKey ? false : entry?.disabled === true;\n    const consecutiveFailures = hasMissingCloudApiKey\n      ? 0\n      : (entry?.consecutiveFailures ?? 0);\n    const lastError = hasMissingCloudApiKey\n      ? MISSING_BACKEND_API_KEY_ERROR\n      : (entry?.lastError ?? null);\n\n    let isConnected: boolean | null;\n    if (hasMissingCloudApiKey) {\n      isConnected = false;\n    } else if (disabled) {\n      // Polling stopped after hitting the cap — treat as disconnected\n      // so existing consumers (dot, badge) render red without needing\n      // to know about the new fields.\n      isConnected = false;\n    } else if (r.isSuccess) isConnected = true;\n    else if (r.isError) isConnected = false;\n    else isConnected = null;\n\n    out[b.id] = { isConnected, consecutiveFailures, lastError, disabled };\n  });\n  return out;\n}\n\nexport { MAX_CONSECUTIVE_FAILURES };\n"],"mappings":"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"}

package/dist/hooks/query/use-backends-health.d.ts

@@ -1,6 +1,6 @@
 import type { Backend } from "#/api/backend-registry/types";
 import { MAX_CONSECUTIVE_FAILURES } from "#/api/backend-registry/health-storage";
-export declare const INVALID_BACKEND_API_KEY_ERROR = "Invalid API key";
+export { INVALID_BACKEND_API_KEY_ERROR } from "#/api/agent-server-compatibility";
 export declare const MISSING_BACKEND_API_KEY_ERROR = "API key required";
 export declare const CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR = "Cloud API key or network issue";
 export declare const CLOUD_BACKEND_LOGGED_OUT_ERROR = "Logged out";

package/dist/hooks/query/use-backends-health.js

@@ -1,72 +1,58 @@
 import { HttpError as e } from "../../node_modules/@openhands/typescript-client/dist/client/http-client.js";
-import { ServerClient as t } from "../../node_modules/@openhands/typescript-client/dist/client/server-client.js";
-import { SettingsClient as n } from "../../node_modules/@openhands/typescript-client/dist/client/settings-client.js";
-import "../../node_modules/@openhands/typescript-client/dist/clients.js";
-import { isCorsOrNetworkError as r, isCorsOrNetworkErrorMessage as i } from "../../utils/user-facing-error.js";
-import { getHealthSnapshot as a, recordBackendFailure as o, recordBackendSuccess as s, subscribeBackendHealth as c } from "../../api/backend-registry/health-store.js";
-import { getAgentServerClientOptions as l } from "../../api/agent-server-client-options.js";
-import { assertAgentServerVersionIsSupported as u, isSdkHttpStatusError as d } from "../../api/agent-server-compatibility.js";
-import { useQueries as f } from "../../node_modules/@tanstack/react-query/build/modern/useQueries.js";
-import p from "../../node_modules/axios/lib/axios.js";
+import { isCorsOrNetworkError as t, isCorsOrNetworkErrorMessage as n } from "../../utils/user-facing-error.js";
+import { getHealthSnapshot as r, recordBackendFailure as i, recordBackendSuccess as a, subscribeBackendHealth as o } from "../../api/backend-registry/health-store.js";
+import { INVALID_BACKEND_API_KEY_ERROR as s, validateLocalBackend as c } from "../../api/agent-server-compatibility.js";
+import { useQueries as l } from "../../node_modules/@tanstack/react-query/build/modern/useQueries.js";
+import u from "../../node_modules/axios/lib/axios.js";
 import "../../node_modules/@openhands/typescript-client/dist/index.js";
-import { getCloudOrganizations as m, getCurrentCloudApiKey as h } from "../../api/cloud/organization-service.api.js";
-import g from "react";
+import { getCloudOrganizations as d, getCurrentCloudApiKey as f } from "../../api/cloud/organization-service.api.js";
+import p from "react";
 //#region src/hooks/query/use-backends-health.ts
-var _ = 3e4, v = 4e3, y = "Invalid API key", b = "API key required", x = "Cloud API key or network issue", S = "Logged out";
-function C(e) {
-	return e === y;
+var m = 3e4, h = 4e3, g = "API key required", _ = "Cloud API key or network issue", v = "Logged out";
+function y(e) {
+	return e === s;
 }
-function w(e) {
-	return e === b;
+function b(e) {
+	return e === g;
 }
-function T(e) {
-	return e === x;
+function x(e) {
+	return e === _;
 }
-function E(e) {
+function S(e) {
 	return e.kind === "cloud" && e.authMode !== "cookie" && !e.apiKey.trim();
 }
-function D(e) {
-	return e === S;
+function C(e) {
+	return e === v;
 }
-async function O(i) {
-	if (i.kind === "cloud") {
-		if (i.authMode !== "cookie" && !i.apiKey?.trim()) throw Error(b);
+async function w(n) {
+	if (n.kind === "cloud") {
+		if (n.authMode !== "cookie" && !n.apiKey?.trim()) throw Error(g);
 		try {
-			i.authMode === "cookie" ? await m(i) : await h(i);
-		} catch (t) {
-			throw p.isAxiosError(t) && t.response?.status === 401 || t instanceof e && t.status === 401 ? Error(S) : r(t) ? Error(x) : t;
+			n.authMode === "cookie" ? await d(n) : await f(n);
+		} catch (n) {
+			throw u.isAxiosError(n) && n.response?.status === 401 || n instanceof e && n.status === 401 ? Error(v) : t(n) ? Error(_) : n;
 		}
 		return !0;
 	}
-	try {
-		let e = l({
-			host: i.host,
-			sessionApiKey: i.apiKey || null,
-			timeout: v
-		});
-		await new n(e).getSettings(), u(await new t(e).getServerInfo());
-	} catch (e) {
-		throw d(e, 401) ? Error(y) : e;
-	}
-	return !0;
+	return await c(n, h), !0;
 }
-var k = 2, A = 300;
-function j(e) {
+var T = 2, E = 300;
+function D(e) {
 	return e instanceof Error ? e.message !== "Invalid API key" && e.message !== "API key required" && e.message !== "Logged out" : !0;
 }
-async function M(e) {
+async function O(e) {
 	for (let t = 0;; t += 1) try {
-		return await O(e);
+		return await w(e);
 	} catch (e) {
-		if (t >= k || !j(e)) throw e;
+		if (t >= T || !D(e)) throw e;
 		await new Promise((e) => {
-			setTimeout(e, A);
+			setTimeout(e, E);
 		});
 	}
 }
-function N(e, t = {}) {
-	let { probeDisabledOnce: n = !1 } = t, r = g.useSyncExternalStore(c, a, a), l = f({ queries: e.map((e) => {
-		let t = r[e.id], a = E(e), c = t?.disabled === !0, l = c && e.kind === "cloud" && i(t?.lastError), u = !a && (!c || n || l);
+function k(e, t = {}) {
+	let { probeDisabledOnce: s = !1 } = t, c = p.useSyncExternalStore(o, r, r), u = l({ queries: e.map((e) => {
+		let t = c[e.id], r = S(e), o = t?.disabled === !0, l = o && e.kind === "cloud" && n(t?.lastError), u = !r && (!o || s || l);
 		return {
 			queryKey: [
 				"backend-health",
@@ -77,34 +63,34 @@ function N(e, t = {}) {
 			],
 			queryFn: async () => {
 				try {
-					let t = await M(e);
-					return s(e.id), t;
+					let t = await O(e);
+					return a(e.id), t;
 				} catch (t) {
-					throw o(e.id, t), t;
+					throw i(e.id, t), t;
 				}
 			},
 			enabled: u,
-			refetchInterval: c || a ? !1 : _,
+			refetchInterval: o || r ? !1 : m,
 			refetchIntervalInBackground: !1,
-			refetchOnMount: c && n ? "always" : !0,
-			refetchOnReconnect: !c && !a,
-			refetchOnWindowFocus: !c && !a,
+			refetchOnMount: o && s ? "always" : !0,
+			refetchOnReconnect: !o && !r,
+			refetchOnWindowFocus: !o && !r,
 			retry: !1,
-			staleTime: c ? 0 : _,
+			staleTime: o ? 0 : m,
 			meta: { disableToast: !0 }
 		};
-	}) }), u = {};
+	}) }), d = {};
 	return e.forEach((e, t) => {
-		let n = l[t], i = r[e.id], a = E(e), o = a ? !1 : i?.disabled === !0, s = a ? 0 : i?.consecutiveFailures ?? 0, c = a ? b : i?.lastError ?? null, d;
-		d = a || o ? !1 : n.isSuccess ? !0 : n.isError ? !1 : null, u[e.id] = {
-			isConnected: d,
-			consecutiveFailures: s,
-			lastError: c,
-			disabled: o
+		let n = u[t], r = c[e.id], i = S(e), a = i ? !1 : r?.disabled === !0, o = i ? 0 : r?.consecutiveFailures ?? 0, s = i ? g : r?.lastError ?? null, l;
+		l = i || a ? !1 : n.isSuccess ? !0 : n.isError ? !1 : null, d[e.id] = {
+			isConnected: l,
+			consecutiveFailures: o,
+			lastError: s,
+			disabled: a
 		};
-	}), u;
+	}), d;
 }
 //#endregion
-export { T as isCloudBackendApiKeyOrNetworkHealthError, D as isCloudBackendLoggedOutHealthError, C as isInvalidBackendApiKeyHealthError, w as isMissingBackendApiKeyHealthError, N as useBackendsHealth };
+export { x as isCloudBackendApiKeyOrNetworkHealthError, C as isCloudBackendLoggedOutHealthError, y as isInvalidBackendApiKeyHealthError, b as isMissingBackendApiKeyHealthError, k as useBackendsHealth };
 
 //# sourceMappingURL=use-backends-health.js.map

package/dist/hooks/query/use-backends-health.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-backends-health.js","names":[],"sources":["../../../src/hooks/query/use-backends-health.ts"],"sourcesContent":["import React from \"react\";\nimport axios from \"axios\";\nimport { useQueries } from \"@tanstack/react-query\";\nimport { HttpError } from \"@openhands/typescript-client\";\nimport {\n  ServerClient,\n  SettingsClient,\n} from \"@openhands/typescript-client/clients\";\nimport {\n  getCloudOrganizations,\n  getCurrentCloudApiKey,\n} from \"#/api/cloud/organization-service.api\";\nimport {\n  assertAgentServerVersionIsSupported,\n  isSdkHttpStatusError,\n} from \"#/api/agent-server-compatibility\";\nimport type { Backend } from \"#/api/backend-registry/types\";\nimport { getAgentServerClientOptions } from \"#/api/agent-server-client-options\";\nimport {\n  isCorsOrNetworkError,\n  isCorsOrNetworkErrorMessage,\n} from \"#/utils/user-facing-error\";\nimport {\n  getHealthSnapshot,\n  recordBackendFailure,\n  recordBackendSuccess,\n  subscribeBackendHealth,\n} from \"#/api/backend-registry/health-store\";\nimport { MAX_CONSECUTIVE_FAILURES } from \"#/api/backend-registry/health-storage\";\n\n// 30s: each tick costs two sequential requests per backend (settings +\n// server_info), which on slow links measurably competes with conversation\n// traffic for the browser's per-origin HTTP/1.1 connection pool.\nconst REFRESH_INTERVAL_MS = 30000;\nconst PROBE_TIMEOUT_MS = 4000;\nexport const INVALID_BACKEND_API_KEY_ERROR = \"Invalid API key\";\nexport const MISSING_BACKEND_API_KEY_ERROR = \"API key required\";\nexport const CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR =\n  \"Cloud API key or network issue\";\nexport const CLOUD_BACKEND_LOGGED_OUT_ERROR = \"Logged out\";\n\nexport function isInvalidBackendApiKeyHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === INVALID_BACKEND_API_KEY_ERROR;\n}\n\nexport function isMissingBackendApiKeyHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === MISSING_BACKEND_API_KEY_ERROR;\n}\n\nexport function isCloudBackendApiKeyOrNetworkHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR;\n}\n\nfunction hasMissingBackendApiKey(backend: Backend): boolean {\n  return (\n    backend.kind === \"cloud\" &&\n    backend.authMode !== \"cookie\" &&\n    !backend.apiKey.trim()\n  );\n}\n\nexport function isCloudBackendLoggedOutHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === CLOUD_BACKEND_LOGGED_OUT_ERROR;\n}\n\n/**\n * Probe a single backend for connectivity. The probe path differs by\n * backend kind:\n *\n *  - Local agent-server: GET `/api/settings`, then `/server_info` via the\n *    typescript-client. The settings call validates the configured session\n *    API key; the server info call validates the version compatibility floor.\n *  - Cloud: GET `/api/keys/current` directly against the cloud host. That\n *    endpoint is lightweight, requires auth, and `getCurrentCloudApiKey`\n *    already absorbs the legacy-key 400 fallback so we treat that as\n *    \"connected\" too. Missing / rejected keys are reported explicitly instead\n *    of falling through to the browser's opaque CORS/network error shape.\n *\n * Throws on failure so React Query marks the query as errored — the\n * dropdown reads `isSuccess` to flip the indicator green.\n */\nasync function probeBackend(backend: Backend): Promise<true> {\n  if (backend.kind === \"cloud\") {\n    if (backend.authMode !== \"cookie\" && !backend.apiKey?.trim()) {\n      throw new Error(MISSING_BACKEND_API_KEY_ERROR);\n    }\n\n    try {\n      if (backend.authMode === \"cookie\") {\n        await getCloudOrganizations(backend);\n      } else {\n        await getCurrentCloudApiKey(backend);\n      }\n    } catch (error) {\n      if (\n        (axios.isAxiosError(error) && error.response?.status === 401) ||\n        (error instanceof HttpError && error.status === 401)\n      ) {\n        throw new Error(CLOUD_BACKEND_LOGGED_OUT_ERROR);\n      }\n      if (isCorsOrNetworkError(error)) {\n        throw new Error(CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR);\n      }\n      throw error;\n    }\n    return true;\n  }\n\n  try {\n    const clientOptions = getAgentServerClientOptions({\n      host: backend.host,\n      sessionApiKey: backend.apiKey || null,\n      timeout: PROBE_TIMEOUT_MS,\n    });\n\n    await new SettingsClient(clientOptions).getSettings();\n    const serverInfo = await new ServerClient(clientOptions).getServerInfo();\n    assertAgentServerVersionIsSupported(serverInfo);\n  } catch (error) {\n    if (isSdkHttpStatusError(error, 401)) {\n      throw new Error(INVALID_BACKEND_API_KEY_ERROR);\n    }\n    throw error;\n  }\n  return true;\n}\n\n/**\n * How many extra times to re-run a failed probe before giving up, and how\n * long to wait between attempts.\n */\nconst PROBE_RETRY_ATTEMPTS = 2;\nconst PROBE_RETRY_DELAY_MS = 300;\n\n/**\n * Probe a backend, retrying a couple of times on failure before giving up.\n *\n * The connectivity indicator (and the onboarding \"backend connected\" banner)\n * only flips green once a probe succeeds. With `retry: false` at the query\n * level and a REFRESH_INTERVAL_MS (30s) poll, a single transient first-probe\n * miss — the agent-server still warming up right after navigation, a momentary\n * proxy 5xx, a dropped connection — would otherwise leave the banner stuck\n * until the next scheduled refetch. That is the root cause of the\n * flaky onboarding e2e \"backend health probe should report connected\" timeout.\n *\n * Retrying here, inside the query function rather than via React Query's\n * `retry`, is deliberate: the success/failure recording below runs once per\n * settled query, so a single logical probe still records exactly one outcome.\n * Retrying at the query level instead would call `recordBackendFailure` on\n * every internal attempt and reach the disabled cap several times too fast.\n *\n * Definitive auth failures (logged out, invalid/missing key) are NOT retried:\n * they are a decided server response, not a transient miss, so retrying only\n * delays surfacing the correct \"disconnected\" state (and the recovery UI).\n */\nfunction isRetryableProbeError(error: unknown): boolean {\n  if (!(error instanceof Error)) return true;\n  return (\n    error.message !== INVALID_BACKEND_API_KEY_ERROR &&\n    error.message !== MISSING_BACKEND_API_KEY_ERROR &&\n    error.message !== CLOUD_BACKEND_LOGGED_OUT_ERROR\n  );\n}\n\nasync function probeBackendWithQuickRetry(backend: Backend): Promise<true> {\n  for (let attempt = 0; ; attempt += 1) {\n    try {\n      return await probeBackend(backend);\n    } catch (error) {\n      if (attempt >= PROBE_RETRY_ATTEMPTS || !isRetryableProbeError(error)) {\n        throw error;\n      }\n      await new Promise((resolve) => {\n        setTimeout(resolve, PROBE_RETRY_DELAY_MS);\n      });\n    }\n  }\n}\n\nexport interface BackendHealth {\n  /** `null` while the first probe is in flight; then `true` / `false`. */\n  isConnected: boolean | null;\n  /** Number of consecutive failed probes since the last success. */\n  consecutiveFailures: number;\n  /** Last error message captured from a failed probe, if any. */\n  lastError: string | null;\n  /**\n   * `true` once `consecutiveFailures` reaches the cap. While disabled,\n   * ordinary background polling stops and survives a page refresh in\n   * that state.\n   */\n  disabled: boolean;\n}\n\nexport interface UseBackendsHealthOptions {\n  /**\n   * Re-probe disabled backends once when the hook mounts. Used by the\n   * Manage Backends modal so a recovered backend can clear its stale\n   * persisted error state without forcing the user to edit the config.\n   */\n  probeDisabledOnce?: boolean;\n}\n\n/**\n * Poll every backend in `backends` once every 10s and report a simple\n * connected / disconnected verdict per backend id.\n *\n * The query key includes `host` and `apiKey` so editing a backend's\n * connection details re-keys the query and triggers an immediate\n * refetch instead of waiting for the next tick.\n *\n * After `MAX_CONSECUTIVE_FAILURES` failures in a row, ordinary polling\n * stops for that backend until the user updates its host / apiKey.\n * Callers can still opt into a one-shot recheck for disabled backends\n * (for example when the user explicitly opens Manage Backends). The\n * failure count and last error live in localStorage so a page refresh\n * does not silently re-arm polling against a backend that's known to\n * be unreachable.\n */\nexport function useBackendsHealth(\n  backends: Backend[],\n  options: UseBackendsHealthOptions = {},\n): Record<string, BackendHealth> {\n  const { probeDisabledOnce = false } = options;\n  const healthMap = React.useSyncExternalStore(\n    subscribeBackendHealth,\n    getHealthSnapshot,\n    getHealthSnapshot,\n  );\n\n  const results = useQueries({\n    queries: backends.map((b) => {\n      const entry = healthMap[b.id];\n      const hasMissingCloudApiKey = hasMissingBackendApiKey(b);\n      const isDisabled = entry?.disabled === true;\n      const shouldReprobeStaleCloudNetworkError =\n        isDisabled &&\n        b.kind === \"cloud\" &&\n        isCorsOrNetworkErrorMessage(entry?.lastError);\n      const shouldProbe =\n        !hasMissingCloudApiKey &&\n        (!isDisabled ||\n          probeDisabledOnce ||\n          shouldReprobeStaleCloudNetworkError);\n      return {\n        queryKey: [\n          \"backend-health\",\n          b.id,\n          b.kind,\n          b.host,\n          b.apiKey ?? \"\",\n        ] as const,\n        queryFn: async () => {\n          try {\n            const result = await probeBackendWithQuickRetry(b);\n            recordBackendSuccess(b.id);\n            return result;\n          } catch (err) {\n            recordBackendFailure(b.id, err);\n            throw err;\n          }\n        },\n        enabled: shouldProbe,\n        refetchInterval:\n          isDisabled || hasMissingCloudApiKey\n            ? (false as const)\n            : REFRESH_INTERVAL_MS,\n        refetchIntervalInBackground: false,\n        refetchOnMount: isDisabled && probeDisabledOnce ? \"always\" : true,\n        refetchOnReconnect: !isDisabled && !hasMissingCloudApiKey,\n        refetchOnWindowFocus: !isDisabled && !hasMissingCloudApiKey,\n        retry: false,\n        // Keep the previous verdict visible while the next probe is in\n        // flight so the indicator doesn't flicker on routine polling.\n        staleTime: isDisabled ? 0 : REFRESH_INTERVAL_MS,\n        meta: { disableToast: true },\n      };\n    }),\n  });\n\n  const out: Record<string, BackendHealth> = {};\n  backends.forEach((b, i) => {\n    const r = results[i];\n    const entry = healthMap[b.id];\n    const hasMissingCloudApiKey = hasMissingBackendApiKey(b);\n    const disabled = hasMissingCloudApiKey ? false : entry?.disabled === true;\n    const consecutiveFailures = hasMissingCloudApiKey\n      ? 0\n      : (entry?.consecutiveFailures ?? 0);\n    const lastError = hasMissingCloudApiKey\n      ? MISSING_BACKEND_API_KEY_ERROR\n      : (entry?.lastError ?? null);\n\n    let isConnected: boolean | null;\n    if (hasMissingCloudApiKey) {\n      isConnected = false;\n    } else if (disabled) {\n      // Polling stopped after hitting the cap — treat as disconnected\n      // so existing consumers (dot, badge) render red without needing\n      // to know about the new fields.\n      isConnected = false;\n    } else if (r.isSuccess) isConnected = true;\n    else if (r.isError) isConnected = false;\n    else isConnected = null;\n\n    out[b.id] = { isConnected, consecutiveFailures, lastError, disabled };\n  });\n  return out;\n}\n\nexport { MAX_CONSECUTIVE_FAILURES };\n"],"mappings":"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"}
+{"version":3,"file":"use-backends-health.js","names":[],"sources":["../../../src/hooks/query/use-backends-health.ts"],"sourcesContent":["import React from \"react\";\nimport axios from \"axios\";\nimport { useQueries } from \"@tanstack/react-query\";\nimport { HttpError } from \"@openhands/typescript-client\";\nimport {\n  getCloudOrganizations,\n  getCurrentCloudApiKey,\n} from \"#/api/cloud/organization-service.api\";\nimport {\n  validateLocalBackend,\n  INVALID_BACKEND_API_KEY_ERROR,\n} from \"#/api/agent-server-compatibility\";\nimport type { Backend } from \"#/api/backend-registry/types\";\nimport {\n  isCorsOrNetworkError,\n  isCorsOrNetworkErrorMessage,\n} from \"#/utils/user-facing-error\";\nimport {\n  getHealthSnapshot,\n  recordBackendFailure,\n  recordBackendSuccess,\n  subscribeBackendHealth,\n} from \"#/api/backend-registry/health-store\";\nimport { MAX_CONSECUTIVE_FAILURES } from \"#/api/backend-registry/health-storage\";\n\n// 30s: each tick costs two sequential requests per backend (settings +\n// server_info), which on slow links measurably competes with conversation\n// traffic for the browser's per-origin HTTP/1.1 connection pool.\nconst REFRESH_INTERVAL_MS = 30000;\nconst PROBE_TIMEOUT_MS = 4000;\nexport { INVALID_BACKEND_API_KEY_ERROR } from \"#/api/agent-server-compatibility\";\nexport const MISSING_BACKEND_API_KEY_ERROR = \"API key required\";\nexport const CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR =\n  \"Cloud API key or network issue\";\nexport const CLOUD_BACKEND_LOGGED_OUT_ERROR = \"Logged out\";\n\nexport function isInvalidBackendApiKeyHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === INVALID_BACKEND_API_KEY_ERROR;\n}\n\nexport function isMissingBackendApiKeyHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === MISSING_BACKEND_API_KEY_ERROR;\n}\n\nexport function isCloudBackendApiKeyOrNetworkHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR;\n}\n\nfunction hasMissingBackendApiKey(backend: Backend): boolean {\n  return (\n    backend.kind === \"cloud\" &&\n    backend.authMode !== \"cookie\" &&\n    !backend.apiKey.trim()\n  );\n}\n\nexport function isCloudBackendLoggedOutHealthError(\n  error: string | null | undefined,\n): boolean {\n  return error === CLOUD_BACKEND_LOGGED_OUT_ERROR;\n}\n\n/**\n * Probe a single backend for connectivity. The probe path differs by\n * backend kind:\n *\n *  - Local agent-server: GET `/api/settings`, then `/server_info` via the\n *    typescript-client. The settings call validates the configured session\n *    API key; the server info call validates the version compatibility floor.\n *  - Cloud: GET `/api/keys/current` directly against the cloud host. That\n *    endpoint is lightweight, requires auth, and `getCurrentCloudApiKey`\n *    already absorbs the legacy-key 400 fallback so we treat that as\n *    \"connected\" too. Missing / rejected keys are reported explicitly instead\n *    of falling through to the browser's opaque CORS/network error shape.\n *\n * Throws on failure so React Query marks the query as errored — the\n * dropdown reads `isSuccess` to flip the indicator green.\n */\nasync function probeBackend(backend: Backend): Promise<true> {\n  if (backend.kind === \"cloud\") {\n    if (backend.authMode !== \"cookie\" && !backend.apiKey?.trim()) {\n      throw new Error(MISSING_BACKEND_API_KEY_ERROR);\n    }\n\n    try {\n      if (backend.authMode === \"cookie\") {\n        await getCloudOrganizations(backend);\n      } else {\n        await getCurrentCloudApiKey(backend);\n      }\n    } catch (error) {\n      if (\n        (axios.isAxiosError(error) && error.response?.status === 401) ||\n        (error instanceof HttpError && error.status === 401)\n      ) {\n        throw new Error(CLOUD_BACKEND_LOGGED_OUT_ERROR);\n      }\n      if (isCorsOrNetworkError(error)) {\n        throw new Error(CLOUD_BACKEND_API_KEY_OR_NETWORK_ERROR);\n      }\n      throw error;\n    }\n    return true;\n  }\n\n  await validateLocalBackend(backend, PROBE_TIMEOUT_MS);\n  return true;\n}\n\n/**\n * How many extra times to re-run a failed probe before giving up, and how\n * long to wait between attempts.\n */\nconst PROBE_RETRY_ATTEMPTS = 2;\nconst PROBE_RETRY_DELAY_MS = 300;\n\n/**\n * Probe a backend, retrying a couple of times on failure before giving up.\n *\n * The connectivity indicator (and the onboarding \"backend connected\" banner)\n * only flips green once a probe succeeds. With `retry: false` at the query\n * level and a REFRESH_INTERVAL_MS (30s) poll, a single transient first-probe\n * miss — the agent-server still warming up right after navigation, a momentary\n * proxy 5xx, a dropped connection — would otherwise leave the banner stuck\n * until the next scheduled refetch. That is the root cause of the\n * flaky onboarding e2e \"backend health probe should report connected\" timeout.\n *\n * Retrying here, inside the query function rather than via React Query's\n * `retry`, is deliberate: the success/failure recording below runs once per\n * settled query, so a single logical probe still records exactly one outcome.\n * Retrying at the query level instead would call `recordBackendFailure` on\n * every internal attempt and reach the disabled cap several times too fast.\n *\n * Definitive auth failures (logged out, invalid/missing key) are NOT retried:\n * they are a decided server response, not a transient miss, so retrying only\n * delays surfacing the correct \"disconnected\" state (and the recovery UI).\n */\nfunction isRetryableProbeError(error: unknown): boolean {\n  if (!(error instanceof Error)) return true;\n  return (\n    error.message !== INVALID_BACKEND_API_KEY_ERROR &&\n    error.message !== MISSING_BACKEND_API_KEY_ERROR &&\n    error.message !== CLOUD_BACKEND_LOGGED_OUT_ERROR\n  );\n}\n\nasync function probeBackendWithQuickRetry(backend: Backend): Promise<true> {\n  for (let attempt = 0; ; attempt += 1) {\n    try {\n      return await probeBackend(backend);\n    } catch (error) {\n      if (attempt >= PROBE_RETRY_ATTEMPTS || !isRetryableProbeError(error)) {\n        throw error;\n      }\n      await new Promise((resolve) => {\n        setTimeout(resolve, PROBE_RETRY_DELAY_MS);\n      });\n    }\n  }\n}\n\nexport interface BackendHealth {\n  /** `null` while the first probe is in flight; then `true` / `false`. */\n  isConnected: boolean | null;\n  /** Number of consecutive failed probes since the last success. */\n  consecutiveFailures: number;\n  /** Last error message captured from a failed probe, if any. */\n  lastError: string | null;\n  /**\n   * `true` once `consecutiveFailures` reaches the cap. While disabled,\n   * ordinary background polling stops and survives a page refresh in\n   * that state.\n   */\n  disabled: boolean;\n}\n\nexport interface UseBackendsHealthOptions {\n  /**\n   * Re-probe disabled backends once when the hook mounts. Used by the\n   * Manage Backends modal so a recovered backend can clear its stale\n   * persisted error state without forcing the user to edit the config.\n   */\n  probeDisabledOnce?: boolean;\n}\n\n/**\n * Poll every backend in `backends` once every 10s and report a simple\n * connected / disconnected verdict per backend id.\n *\n * The query key includes `host` and `apiKey` so editing a backend's\n * connection details re-keys the query and triggers an immediate\n * refetch instead of waiting for the next tick.\n *\n * After `MAX_CONSECUTIVE_FAILURES` failures in a row, ordinary polling\n * stops for that backend until the user updates its host / apiKey.\n * Callers can still opt into a one-shot recheck for disabled backends\n * (for example when the user explicitly opens Manage Backends). The\n * failure count and last error live in localStorage so a page refresh\n * does not silently re-arm polling against a backend that's known to\n * be unreachable.\n */\nexport function useBackendsHealth(\n  backends: Backend[],\n  options: UseBackendsHealthOptions = {},\n): Record<string, BackendHealth> {\n  const { probeDisabledOnce = false } = options;\n  const healthMap = React.useSyncExternalStore(\n    subscribeBackendHealth,\n    getHealthSnapshot,\n    getHealthSnapshot,\n  );\n\n  const results = useQueries({\n    queries: backends.map((b) => {\n      const entry = healthMap[b.id];\n      const hasMissingCloudApiKey = hasMissingBackendApiKey(b);\n      const isDisabled = entry?.disabled === true;\n      const shouldReprobeStaleCloudNetworkError =\n        isDisabled &&\n        b.kind === \"cloud\" &&\n        isCorsOrNetworkErrorMessage(entry?.lastError);\n      const shouldProbe =\n        !hasMissingCloudApiKey &&\n        (!isDisabled ||\n          probeDisabledOnce ||\n          shouldReprobeStaleCloudNetworkError);\n      return {\n        queryKey: [\n          \"backend-health\",\n          b.id,\n          b.kind,\n          b.host,\n          b.apiKey ?? \"\",\n        ] as const,\n        queryFn: async () => {\n          try {\n            const result = await probeBackendWithQuickRetry(b);\n            recordBackendSuccess(b.id);\n            return result;\n          } catch (err) {\n            recordBackendFailure(b.id, err);\n            throw err;\n          }\n        },\n        enabled: shouldProbe,\n        refetchInterval:\n          isDisabled || hasMissingCloudApiKey\n            ? (false as const)\n            : REFRESH_INTERVAL_MS,\n        refetchIntervalInBackground: false,\n        refetchOnMount: isDisabled && probeDisabledOnce ? \"always\" : true,\n        refetchOnReconnect: !isDisabled && !hasMissingCloudApiKey,\n        refetchOnWindowFocus: !isDisabled && !hasMissingCloudApiKey,\n        retry: false,\n        // Keep the previous verdict visible while the next probe is in\n        // flight so the indicator doesn't flicker on routine polling.\n        staleTime: isDisabled ? 0 : REFRESH_INTERVAL_MS,\n        meta: { disableToast: true },\n      };\n    }),\n  });\n\n  const out: Record<string, BackendHealth> = {};\n  backends.forEach((b, i) => {\n    const r = results[i];\n    const entry = healthMap[b.id];\n    const hasMissingCloudApiKey = hasMissingBackendApiKey(b);\n    const disabled = hasMissingCloudApiKey ? false : entry?.disabled === true;\n    const consecutiveFailures = hasMissingCloudApiKey\n      ? 0\n      : (entry?.consecutiveFailures ?? 0);\n    const lastError = hasMissingCloudApiKey\n      ? MISSING_BACKEND_API_KEY_ERROR\n      : (entry?.lastError ?? null);\n\n    let isConnected: boolean | null;\n    if (hasMissingCloudApiKey) {\n      isConnected = false;\n    } else if (disabled) {\n      // Polling stopped after hitting the cap — treat as disconnected\n      // so existing consumers (dot, badge) render red without needing\n      // to know about the new fields.\n      isConnected = false;\n    } else if (r.isSuccess) isConnected = true;\n    else if (r.isError) isConnected = false;\n    else isConnected = null;\n\n    out[b.id] = { isConnected, consecutiveFailures, lastError, disabled };\n  });\n  return out;\n}\n\nexport { MAX_CONSECUTIVE_FAILURES };\n"],"mappings":"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"}

package/dist/hooks/query/use-canvas-extensions.cjs

@@ -0,0 +1 @@
+require("../../_virtual/_rolldown/runtime.cjs"),require("../../api/backend-registry/active-store.cjs"),require("../../contexts/active-backend-context.cjs"),require("../../api/canvas-extensions-service.cjs");

package/dist/hooks/query/use-canvas-extensions.d.ts

@@ -0,0 +1,5 @@
+interface UseCanvasExtensionsOptions {
+    enabled?: boolean;
+}
+export declare function useCanvasExtensions(options?: UseCanvasExtensionsOptions): import("@tanstack/react-query").UseQueryResult<NoInfer<import("../..").InstalledCanvasExtensionInfo[]>, import("axios").AxiosError<unknown, any>>;
+export {};

package/dist/hooks/query/use-canvas-extensions.js

@@ -0,0 +1,3 @@
+import "../../api/backend-registry/active-store.js";
+import "../../contexts/active-backend-context.js";
+import "../../api/canvas-extensions-service.js";

package/dist/hooks/query/use-commit-changes.cjs

@@ -1,2 +1,2 @@
-const e=require("../../_virtual/_rolldown/runtime.cjs"),t=require("../use-conversation-id.cjs"),n=require("../../node_modules/@tanstack/react-query/build/modern/useQuery.cjs"),r=require("./use-active-conversation.cjs"),i=require("../use-runtime-is-ready.cjs"),a=require("../../api/git-service/agent-server-git-service.api.cjs"),o=require("../../utils/get-git-path.cjs");let s=require("react");s=e.__toESM(s,1);var c=(e,c)=>{let{conversationId:l}=t.useConversationId(),{data:u}=r.useActiveConversation(),d=i.useRuntimeIsReady(),f=u?.conversation_url,p=u?.session_api_key,m=u?.selected_repository,h=u?.workspace?.working_dir?.trim(),g=s.default.useMemo(()=>o.getGitPath(m,h),[m,h]);return n.useQuery({queryKey:[`commit_changes`,l,f,p,g,e],queryFn:async()=>{if(!l)throw Error(`No conversation ID`);return a.default.getCommitChanges(f,p,g,e)},staleTime:1/0,gcTime:1e3*60*15,retry:!1,enabled:c.enabled&&d&&!!l,meta:{disableToast:!0}})};exports.useCommitChanges=c;
+const e=require("../../_virtual/_rolldown/runtime.cjs"),t=require("../use-conversation-id.cjs"),n=require("../../node_modules/@tanstack/react-query/build/modern/useQuery.cjs"),r=require("./use-active-conversation.cjs"),i=require("../use-runtime-is-ready.cjs"),a=require("../../utils/get-git-path.cjs"),o=require("../../api/git-service/agent-server-git-service.api.cjs");let s=require("react");s=e.__toESM(s,1);var c=(e,c)=>{let{conversationId:l}=t.useConversationId(),{data:u}=r.useActiveConversation(),d=i.useRuntimeIsReady(),f=u?.conversation_url,p=u?.session_api_key,m=u?.selected_repository,h=u?.workspace?.working_dir?.trim(),g=s.default.useMemo(()=>a.getGitPath(m,h),[m,h]);return n.useQuery({queryKey:[`commit_changes`,l,f,p,g,e],queryFn:async()=>{if(!l)throw Error(`No conversation ID`);return o.default.getCommitChanges(f,p,g,e)},staleTime:1/0,gcTime:1e3*60*15,retry:!1,enabled:c.enabled&&d&&!!l,meta:{disableToast:!0}})};exports.useCommitChanges=c;
 //# sourceMappingURL=use-commit-changes.cjs.map

package/dist/hooks/query/use-commit-changes.js

@@ -2,12 +2,12 @@ import { useConversationId as e } from "../use-conversation-id.js";
 import { useQuery as t } from "../../node_modules/@tanstack/react-query/build/modern/useQuery.js";
 import { useActiveConversation as n } from "./use-active-conversation.js";
 import { useRuntimeIsReady as r } from "../use-runtime-is-ready.js";
-import i from "../../api/git-service/agent-server-git-service.api.js";
-import { getGitPath as a } from "../../utils/get-git-path.js";
+import { getGitPath as i } from "../../utils/get-git-path.js";
+import a from "../../api/git-service/agent-server-git-service.api.js";
 import o from "react";
 //#region src/hooks/query/use-commit-changes.ts
 var s = (s, c) => {
-	let { conversationId: l } = e(), { data: u } = n(), d = r(), f = u?.conversation_url, p = u?.session_api_key, m = u?.selected_repository, h = u?.workspace?.working_dir?.trim(), g = o.useMemo(() => a(m, h), [m, h]);
+	let { conversationId: l } = e(), { data: u } = n(), d = r(), f = u?.conversation_url, p = u?.session_api_key, m = u?.selected_repository, h = u?.workspace?.working_dir?.trim(), g = o.useMemo(() => i(m, h), [m, h]);
 	return t({
 		queryKey: [
 			"commit_changes",
@@ -19,7 +19,7 @@ var s = (s, c) => {
 		],
 		queryFn: async () => {
 			if (!l) throw Error("No conversation ID");
-			return i.getCommitChanges(f, p, g, s);
+			return a.getCommitChanges(f, p, g, s);
 		},
 		staleTime: Infinity,
 		gcTime: 1e3 * 60 * 15,

package/dist/hooks/query/use-conversation-skills.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("./use-active-conversation.cjs"),t=require("./use-skills.cjs");var n=()=>t.useSkills(e.useActiveConversation().data?.selected_workspace??void 0);exports.useConversationSkills=n;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("../use-conversation-id.cjs"),t=require("../../node_modules/@tanstack/react-query/build/modern/useQuery.cjs"),n=require("../../contexts/active-backend-context.cjs"),r=require("./use-active-conversation.cjs"),i=require("../../api/skills-service.cjs");var a=()=>{let a=n.useActiveBackend().backend.kind===`cloud`,{conversationId:o}=e.useOptionalConversationId(),{data:s}=r.useActiveConversation(),c=s?.selected_workspace??void 0,l=a?o:null;return t.useQuery({queryKey:l?[`conversation`,l,`skills`]:[`skills`,c??null],queryFn:()=>l?i.default.getConversationSkills(l):i.default.getSkills(c),enabled:!l||s?.sandbox_status===`RUNNING`,staleTime:1e3*60*10,refetchOnWindowFocus:!1})};exports.useConversationSkills=a;
 //# sourceMappingURL=use-conversation-skills.cjs.map

package/dist/hooks/query/use-conversation-skills.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-conversation-skills.cjs","names":[],"sources":["../../../src/hooks/query/use-conversation-skills.ts"],"sourcesContent":["import { useActiveConversation } from \"./use-active-conversation\";\nimport { useSkills } from \"./use-skills\";\n\n/**\n * Skills catalog scoped to the active conversation's attached workspace, so\n * the slash-command menu and skills modal list the same project skills that\n * were loaded into the conversation. Falls back to the global workspace dir\n * for \"No workspace\" conversations (``selected_workspace`` is null).\n */\nexport const useConversationSkills = () => {\n  const conversation = useActiveConversation();\n  return useSkills(conversation.data?.selected_workspace ?? undefined);\n};\n"],"mappings":"+HASA,IAAa,MAEJ,EAAA,UADc,EAAA,sBACJ,EAAa,MAAM,oBAAsB,IAAA,EAAS"}
+{"version":3,"file":"use-conversation-skills.cjs","names":[],"sources":["../../../src/hooks/query/use-conversation-skills.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport SkillsService from \"#/api/skills-service\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useOptionalConversationId } from \"#/hooks/use-conversation-id\";\nimport { SkillInfo } from \"#/types/settings\";\nimport { useActiveConversation } from \"./use-active-conversation\";\n\n/**\n * Skills catalog scoped to the active conversation, so the slash-command menu\n * and skills modal list the same skills that were loaded into it.\n *\n * Cloud: the per-conversation route reports what the conversation's\n * agent-server actually loaded (public catalog, user/org repos, project\n * skills, auto-loaded marketplace plugins); the global `/api/v1/skills/search`\n * catalog only scans the API host's built-in skills directory. The route needs\n * a running sandbox, which `useActiveConversation` polls for.\n *\n * Local (and cloud with no conversation route, e.g. the home page): the\n * workspace-scoped catalog, falling back to the global workspace dir for\n * \"No workspace\" conversations (`selected_workspace` is null).\n */\nexport const useConversationSkills = () => {\n  const isCloud = useActiveBackend().backend.kind === \"cloud\";\n  const { conversationId } = useOptionalConversationId();\n  const { data: conversation } = useActiveConversation();\n  const projectDir = conversation?.selected_workspace ?? undefined;\n  // Keyed on the route id so a still-loading cloud conversation does not fall\n  // back to the global catalog; only a missing route does.\n  const cloudConversationId = isCloud ? conversationId : null;\n\n  return useQuery<SkillInfo[]>({\n    queryKey: cloudConversationId\n      ? [\"conversation\", cloudConversationId, \"skills\"]\n      : [\"skills\", projectDir ?? null],\n    queryFn: () =>\n      cloudConversationId\n        ? SkillsService.getConversationSkills(cloudConversationId)\n        : SkillsService.getSkills(projectDir),\n    // The cloud route 404s until the sandbox runs.\n    enabled: !cloudConversationId || conversation?.sandbox_status === \"RUNNING\",\n    staleTime: 1000 * 60 * 10, // 10 minutes – skill list rarely changes\n    refetchOnWindowFocus: false,\n  });\n};\n"],"mappings":"0TAqBA,IAAa,MAA8B,CACzC,IAAM,EAAU,EAAA,iBAAiB,EAAE,QAAQ,OAAS,QAC9C,CAAE,kBAAmB,EAAA,0BAA0B,EAC/C,CAAE,KAAM,GAAiB,EAAA,sBAAsB,EAC/C,EAAa,GAAc,oBAAsB,IAAA,GAGjD,EAAsB,EAAU,EAAiB,KAEvD,OAAO,EAAA,SAAsB,CAC3B,SAAU,EACN,CAAC,eAAgB,EAAqB,QAAQ,EAC9C,CAAC,SAAU,GAAc,IAAI,EACjC,YACE,EACI,EAAA,QAAc,sBAAsB,CAAmB,EACvD,EAAA,QAAc,UAAU,CAAU,EAExC,QAAS,CAAC,GAAuB,GAAc,iBAAmB,UAClE,UAAW,IAAO,GAAK,GACvB,qBAAsB,EACxB,CAAC,CACH"}

package/dist/hooks/query/use-conversation-skills.d.ts

@@ -1,7 +1,16 @@
+import { SkillInfo } from "#/types/settings";
 /**
- * Skills catalog scoped to the active conversation's attached workspace, so
- * the slash-command menu and skills modal list the same project skills that
- * were loaded into the conversation. Falls back to the global workspace dir
- * for "No workspace" conversations (``selected_workspace`` is null).
+ * Skills catalog scoped to the active conversation, so the slash-command menu
+ * and skills modal list the same skills that were loaded into it.
+ *
+ * Cloud: the per-conversation route reports what the conversation's
+ * agent-server actually loaded (public catalog, user/org repos, project
+ * skills, auto-loaded marketplace plugins); the global `/api/v1/skills/search`
+ * catalog only scans the API host's built-in skills directory. The route needs
+ * a running sandbox, which `useActiveConversation` polls for.
+ *
+ * Local (and cloud with no conversation route, e.g. the home page): the
+ * workspace-scoped catalog, falling back to the global workspace dir for
+ * "No workspace" conversations (`selected_workspace` is null).
  */
-export declare const useConversationSkills: () => import("@tanstack/react-query").UseQueryResult<NoInfer<import("../../types/settings").SkillInfo[]>, import("axios").AxiosError<unknown, any>>;
+export declare const useConversationSkills: () => import("@tanstack/react-query").UseQueryResult<NoInfer<SkillInfo[]>, import("axios").AxiosError<unknown, any>>;

package/dist/hooks/query/use-conversation-skills.js

@@ -1,8 +1,24 @@
-import { useActiveConversation as e } from "./use-active-conversation.js";
-import { useSkills as t } from "./use-skills.js";
+import { useOptionalConversationId as e } from "../use-conversation-id.js";
+import { useQuery as t } from "../../node_modules/@tanstack/react-query/build/modern/useQuery.js";
+import { useActiveBackend as n } from "../../contexts/active-backend-context.js";
+import { useActiveConversation as r } from "./use-active-conversation.js";
+import i from "../../api/skills-service.js";
 //#region src/hooks/query/use-conversation-skills.ts
-var n = () => t(e().data?.selected_workspace ?? void 0);
+var a = () => {
+	let a = n().backend.kind === "cloud", { conversationId: o } = e(), { data: s } = r(), c = s?.selected_workspace ?? void 0, l = a ? o : null;
+	return t({
+		queryKey: l ? [
+			"conversation",
+			l,
+			"skills"
+		] : ["skills", c ?? null],
+		queryFn: () => l ? i.getConversationSkills(l) : i.getSkills(c),
+		enabled: !l || s?.sandbox_status === "RUNNING",
+		staleTime: 1e3 * 60 * 10,
+		refetchOnWindowFocus: !1
+	});
+};
 //#endregion
-export { n as useConversationSkills };
+export { a as useConversationSkills };
 
 //# sourceMappingURL=use-conversation-skills.js.map

package/dist/hooks/query/use-conversation-skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-conversation-skills.js","names":[],"sources":["../../../src/hooks/query/use-conversation-skills.ts"],"sourcesContent":["import { useActiveConversation } from \"./use-active-conversation\";\nimport { useSkills } from \"./use-skills\";\n\n/**\n * Skills catalog scoped to the active conversation's attached workspace, so\n * the slash-command menu and skills modal list the same project skills that\n * were loaded into the conversation. Falls back to the global workspace dir\n * for \"No workspace\" conversations (``selected_workspace`` is null).\n */\nexport const useConversationSkills = () => {\n  const conversation = useActiveConversation();\n  return useSkills(conversation.data?.selected_workspace ?? undefined);\n};\n"],"mappings":";;;AASA,IAAa,UAEJ,EADc,EACJ,EAAa,MAAM,sBAAsB,KAAA,CAAS"}
+{"version":3,"file":"use-conversation-skills.js","names":[],"sources":["../../../src/hooks/query/use-conversation-skills.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport SkillsService from \"#/api/skills-service\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { useOptionalConversationId } from \"#/hooks/use-conversation-id\";\nimport { SkillInfo } from \"#/types/settings\";\nimport { useActiveConversation } from \"./use-active-conversation\";\n\n/**\n * Skills catalog scoped to the active conversation, so the slash-command menu\n * and skills modal list the same skills that were loaded into it.\n *\n * Cloud: the per-conversation route reports what the conversation's\n * agent-server actually loaded (public catalog, user/org repos, project\n * skills, auto-loaded marketplace plugins); the global `/api/v1/skills/search`\n * catalog only scans the API host's built-in skills directory. The route needs\n * a running sandbox, which `useActiveConversation` polls for.\n *\n * Local (and cloud with no conversation route, e.g. the home page): the\n * workspace-scoped catalog, falling back to the global workspace dir for\n * \"No workspace\" conversations (`selected_workspace` is null).\n */\nexport const useConversationSkills = () => {\n  const isCloud = useActiveBackend().backend.kind === \"cloud\";\n  const { conversationId } = useOptionalConversationId();\n  const { data: conversation } = useActiveConversation();\n  const projectDir = conversation?.selected_workspace ?? undefined;\n  // Keyed on the route id so a still-loading cloud conversation does not fall\n  // back to the global catalog; only a missing route does.\n  const cloudConversationId = isCloud ? conversationId : null;\n\n  return useQuery<SkillInfo[]>({\n    queryKey: cloudConversationId\n      ? [\"conversation\", cloudConversationId, \"skills\"]\n      : [\"skills\", projectDir ?? null],\n    queryFn: () =>\n      cloudConversationId\n        ? SkillsService.getConversationSkills(cloudConversationId)\n        : SkillsService.getSkills(projectDir),\n    // The cloud route 404s until the sandbox runs.\n    enabled: !cloudConversationId || conversation?.sandbox_status === \"RUNNING\",\n    staleTime: 1000 * 60 * 10, // 10 minutes – skill list rarely changes\n    refetchOnWindowFocus: false,\n  });\n};\n"],"mappings":";;;;;;AAqBA,IAAa,UAA8B;CACzC,IAAM,IAAU,EAAiB,EAAE,QAAQ,SAAS,SAC9C,EAAE,sBAAmB,EAA0B,GAC/C,EAAE,MAAM,MAAiB,EAAsB,GAC/C,IAAa,GAAc,sBAAsB,KAAA,GAGjD,IAAsB,IAAU,IAAiB;CAEvD,OAAO,EAAsB;EAC3B,UAAU,IACN;GAAC;GAAgB;GAAqB;EAAQ,IAC9C,CAAC,UAAU,KAAc,IAAI;EACjC,eACE,IACI,EAAc,sBAAsB,CAAmB,IACvD,EAAc,UAAU,CAAU;EAExC,SAAS,CAAC,KAAuB,GAAc,mBAAmB;EAClE,WAAW,MAAO,KAAK;EACvB,sBAAsB;CACxB,CAAC;AACH"}

package/dist/hooks/query/use-latest-automation-runs.cjs

@@ -1 +1 @@
-require("../../_virtual/_rolldown/runtime.cjs"),require("../../contexts/active-backend-context.cjs"),require("../../api/automation-service/automation-service.api.cjs"),require("./use-automation-detail.cjs");
+require("../../_virtual/_rolldown/runtime.cjs"),require("../../contexts/active-backend-context.cjs"),require("../../api/automation-service/automation-service.api.cjs"),require("./concurrency-limiter.cjs"),require("./use-automation-detail.cjs");

package/dist/hooks/query/use-latest-automation-runs.js

@@ -1,3 +1,4 @@
 import "../../contexts/active-backend-context.js";
 import "../../api/automation-service/automation-service.api.js";
+import "./concurrency-limiter.js";
 import "./use-automation-detail.js";

package/dist/hooks/query/use-paginated-conversations.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../api/backend-registry/active-store.cjs"),t=require("../../node_modules/@tanstack/react-query/build/modern/useInfiniteQuery.cjs"),n=require("../../contexts/active-backend-context.cjs"),r=require("../../api/conversation-service/agent-server-conversation-service.api.cjs"),i=require("./use-is-authed.cjs");var a=(a=20)=>{let{data:o}=i.useIsAuthed(),s=n.useActiveBackend(),c=!e.isNoBackend(s.backend);return t.useInfiniteQuery({queryKey:[`user`,`conversations`,`paginated`,a,s.backend.id,s.orgId],queryFn:async({pageParam:e})=>await r.default.searchConversations(a,e),enabled:!!o&&c,getNextPageParam:e=>e.next_page_id,initialPageParam:void 0,refetchInterval:3e4,meta:{backendId:s.backend.id}})};exports.usePaginatedConversations=a;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("../../context/navigation-context.cjs"),t=require("../../api/backend-registry/active-store.cjs"),n=require("../../node_modules/@tanstack/react-query/build/modern/useInfiniteQuery.cjs"),r=require("../../contexts/active-backend-context.cjs"),i=require("../../api/conversation-service/agent-server-conversation-service.api.cjs"),a=require("./use-is-authed.cjs"),o=require("../../manifests/automation-interface.cjs");var s=(s=20)=>{let{data:c}=a.useIsAuthed(),l=r.useActiveBackend(),{currentPath:u}=e.useNavigation(),d=!t.isNoBackend(l.backend);return n.useInfiniteQuery({queryKey:[`user`,`conversations`,`paginated`,s,l.backend.id,l.orgId],queryFn:async({pageParam:e})=>await i.default.searchConversations(s,e),enabled:!!c&&d,getNextPageParam:e=>e.next_page_id,initialPageParam:void 0,refetchInterval:o.isAutomationsRoute(u)?!1:3e4,refetchIntervalInBackground:!1,meta:{backendId:l.backend.id}})};exports.usePaginatedConversations=s;
 //# sourceMappingURL=use-paginated-conversations.cjs.map

package/dist/hooks/query/use-paginated-conversations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-paginated-conversations.cjs","names":[],"sources":["../../../src/hooks/query/use-paginated-conversations.ts"],"sourcesContent":["import { useInfiniteQuery } from \"@tanstack/react-query\";\nimport AgentServerConversationService from \"#/api/conversation-service/agent-server-conversation-service.api\";\nimport { useIsAuthed } from \"./use-is-authed\";\nimport { isNoBackend } from \"#/api/backend-registry/active-store\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { AppConversationPage } from \"#/api/conversation-service/agent-server-conversation-service.types\";\n\nexport const usePaginatedConversations = (limit: number = 20) => {\n  const { data: userIsAuthenticated } = useIsAuthed();\n  const active = useActiveBackend();\n  const hasBackend = !isNoBackend(active.backend);\n\n  return useInfiniteQuery({\n    // Include the active backend identity so each (backend, org) pair\n    // maintains its own paginated cache. Switching backends naturally\n    // produces a new query and a fresh fetch — without it the previous\n    // backend's conversations stay visible for staleTime.\n    queryKey: [\n      \"user\",\n      \"conversations\",\n      \"paginated\",\n      limit,\n      active.backend.id,\n      active.orgId,\n    ],\n    queryFn: async ({ pageParam }) => {\n      const result = await AgentServerConversationService.searchConversations(\n        limit,\n        pageParam,\n      );\n\n      return result;\n    },\n    enabled: !!userIsAuthenticated && hasBackend,\n    getNextPageParam: (lastPage: AppConversationPage) => lastPage.next_page_id,\n    initialPageParam: undefined as string | undefined,\n    // Poll every 30s so titles, execution status, and timestamps stay fresh\n    // without requiring the user to refresh. Each response carries the full\n    // conversation objects, so on slow links a tighter interval degrades into\n    // a continuous download that starves the rest of the app (including the\n    // events WebSocket handshake). Consumers must gate initial-load UI (e.g.\n    // skeletons) on `isLoading`, not `isFetching` — `isFetching` flips back to\n    // true on every background refetch, which would cause the skeleton to\n    // flicker on each poll when the list is empty.\n    refetchInterval: 30_000,\n    // A successful fetch proves the backend is reachable. The global\n    // QueryCache onSuccess handler reads this to clear any persisted\n    // failure state, re-arming the status dot without user intervention.\n    meta: { backendId: active.backend.id },\n  });\n};\n"],"mappings":"qXAOA,IAAa,GAA6B,EAAgB,KAAO,CAC/D,GAAM,CAAE,KAAM,GAAwB,EAAA,YAAY,EAC5C,EAAS,EAAA,iBAAiB,EAC1B,EAAa,CAAC,EAAA,YAAY,EAAO,OAAO,EAE9C,OAAO,EAAA,iBAAiB,CAKtB,SAAU,CACR,OACA,gBACA,YACA,EACA,EAAO,QAAQ,GACf,EAAO,KACT,EACA,QAAS,MAAO,CAAE,eAMT,MALc,EAAA,QAA+B,oBAClD,EACA,CACF,EAIF,QAAS,CAAC,CAAC,GAAuB,EAClC,iBAAmB,GAAkC,EAAS,aAC9D,iBAAkB,IAAA,GASlB,gBAAiB,IAIjB,KAAM,CAAE,UAAW,EAAO,QAAQ,EAAG,CACvC,CAAC,CACH"}
+{"version":3,"file":"use-paginated-conversations.cjs","names":[],"sources":["../../../src/hooks/query/use-paginated-conversations.ts"],"sourcesContent":["import { useInfiniteQuery } from \"@tanstack/react-query\";\nimport AgentServerConversationService from \"#/api/conversation-service/agent-server-conversation-service.api\";\nimport { useIsAuthed } from \"./use-is-authed\";\nimport { isNoBackend } from \"#/api/backend-registry/active-store\";\nimport { useNavigation } from \"#/context/navigation-context\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { isAutomationsRoute } from \"#/manifests/automation-interface\";\nimport { AppConversationPage } from \"#/api/conversation-service/agent-server-conversation-service.types\";\n\nexport const usePaginatedConversations = (limit: number = 20) => {\n  const { data: userIsAuthenticated } = useIsAuthed();\n  const active = useActiveBackend();\n  const { currentPath } = useNavigation();\n  const hasBackend = !isNoBackend(active.backend);\n\n  return useInfiniteQuery({\n    // Include the active backend identity so each (backend, org) pair\n    // maintains its own paginated cache. Switching backends naturally\n    // produces a new query and a fresh fetch — without it the previous\n    // backend's conversations stay visible for staleTime.\n    queryKey: [\n      \"user\",\n      \"conversations\",\n      \"paginated\",\n      limit,\n      active.backend.id,\n      active.orgId,\n    ],\n    queryFn: async ({ pageParam }) => {\n      const result = await AgentServerConversationService.searchConversations(\n        limit,\n        pageParam,\n      );\n\n      return result;\n    },\n    enabled: !!userIsAuthenticated && hasBackend,\n    getNextPageParam: (lastPage: AppConversationPage) => lastPage.next_page_id,\n    initialPageParam: undefined as string | undefined,\n    // Poll every 30s so titles, execution status, and timestamps stay fresh\n    // without requiring the user to refresh. Each response carries the full\n    // conversation objects, so on slow links a tighter interval degrades into\n    // a continuous download that starves the rest of the app (including the\n    // events WebSocket handshake). Consumers must gate initial-load UI (e.g.\n    // skeletons) on `isLoading`, not `isFetching` — `isFetching` flips back to\n    // true on every background refetch, which would cause the skeleton to\n    // flicker on each poll when the list is empty.\n    //\n    // The interval is paused on automation routes: the dashboard there already\n    // fans out one runs request per automation, and the sidebar list is not\n    // the focus. Only the poll pauses — the initial fetch still happens — and\n    // mutations that create or cancel runs invalidate [\"user\", \"conversations\"]\n    // so the sidebar stays correct while paused.\n    refetchInterval: isAutomationsRoute(currentPath) ? false : 30_000,\n    refetchIntervalInBackground: false,\n    // A successful fetch proves the backend is reachable. The global\n    // QueryCache onSuccess handler reads this to clear any persisted\n    // failure state, re-arming the status dot without user intervention.\n    meta: { backendId: active.backend.id },\n  });\n};\n"],"mappings":"6dASA,IAAa,GAA6B,EAAgB,KAAO,CAC/D,GAAM,CAAE,KAAM,GAAwB,EAAA,YAAY,EAC5C,EAAS,EAAA,iBAAiB,EAC1B,CAAE,eAAgB,EAAA,cAAc,EAChC,EAAa,CAAC,EAAA,YAAY,EAAO,OAAO,EAE9C,OAAO,EAAA,iBAAiB,CAKtB,SAAU,CACR,OACA,gBACA,YACA,EACA,EAAO,QAAQ,GACf,EAAO,KACT,EACA,QAAS,MAAO,CAAE,eAMT,MALc,EAAA,QAA+B,oBAClD,EACA,CACF,EAIF,QAAS,CAAC,CAAC,GAAuB,EAClC,iBAAmB,GAAkC,EAAS,aAC9D,iBAAkB,IAAA,GAelB,gBAAiB,EAAA,mBAAmB,CAAW,EAAI,GAAQ,IAC3D,4BAA6B,GAI7B,KAAM,CAAE,UAAW,EAAO,QAAQ,EAAG,CACvC,CAAC,CACH"}

package/dist/hooks/query/use-paginated-conversations.js

@@ -1,29 +1,32 @@
-import { isNoBackend as e } from "../../api/backend-registry/active-store.js";
-import { useInfiniteQuery as t } from "../../node_modules/@tanstack/react-query/build/modern/useInfiniteQuery.js";
-import { useActiveBackend as n } from "../../contexts/active-backend-context.js";
-import r from "../../api/conversation-service/agent-server-conversation-service.api.js";
-import { useIsAuthed as i } from "./use-is-authed.js";
+import { useNavigation as e } from "../../context/navigation-context.js";
+import { isNoBackend as t } from "../../api/backend-registry/active-store.js";
+import { useInfiniteQuery as n } from "../../node_modules/@tanstack/react-query/build/modern/useInfiniteQuery.js";
+import { useActiveBackend as r } from "../../contexts/active-backend-context.js";
+import i from "../../api/conversation-service/agent-server-conversation-service.api.js";
+import { useIsAuthed as a } from "./use-is-authed.js";
+import { isAutomationsRoute as o } from "../../manifests/automation-interface.js";
 //#region src/hooks/query/use-paginated-conversations.ts
-var a = (a = 20) => {
-	let { data: o } = i(), s = n(), c = !e(s.backend);
-	return t({
+var s = (s = 20) => {
+	let { data: c } = a(), l = r(), { currentPath: u } = e(), d = !t(l.backend);
+	return n({
 		queryKey: [
 			"user",
 			"conversations",
 			"paginated",
-			a,
-			s.backend.id,
-			s.orgId
+			s,
+			l.backend.id,
+			l.orgId
 		],
-		queryFn: async ({ pageParam: e }) => await r.searchConversations(a, e),
-		enabled: !!o && c,
+		queryFn: async ({ pageParam: e }) => await i.searchConversations(s, e),
+		enabled: !!c && d,
 		getNextPageParam: (e) => e.next_page_id,
 		initialPageParam: void 0,
-		refetchInterval: 3e4,
-		meta: { backendId: s.backend.id }
+		refetchInterval: o(u) ? !1 : 3e4,
+		refetchIntervalInBackground: !1,
+		meta: { backendId: l.backend.id }
 	});
 };
 //#endregion
-export { a as usePaginatedConversations };
+export { s as usePaginatedConversations };
 
 //# sourceMappingURL=use-paginated-conversations.js.map

package/dist/hooks/query/use-paginated-conversations.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-paginated-conversations.js","names":[],"sources":["../../../src/hooks/query/use-paginated-conversations.ts"],"sourcesContent":["import { useInfiniteQuery } from \"@tanstack/react-query\";\nimport AgentServerConversationService from \"#/api/conversation-service/agent-server-conversation-service.api\";\nimport { useIsAuthed } from \"./use-is-authed\";\nimport { isNoBackend } from \"#/api/backend-registry/active-store\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { AppConversationPage } from \"#/api/conversation-service/agent-server-conversation-service.types\";\n\nexport const usePaginatedConversations = (limit: number = 20) => {\n  const { data: userIsAuthenticated } = useIsAuthed();\n  const active = useActiveBackend();\n  const hasBackend = !isNoBackend(active.backend);\n\n  return useInfiniteQuery({\n    // Include the active backend identity so each (backend, org) pair\n    // maintains its own paginated cache. Switching backends naturally\n    // produces a new query and a fresh fetch — without it the previous\n    // backend's conversations stay visible for staleTime.\n    queryKey: [\n      \"user\",\n      \"conversations\",\n      \"paginated\",\n      limit,\n      active.backend.id,\n      active.orgId,\n    ],\n    queryFn: async ({ pageParam }) => {\n      const result = await AgentServerConversationService.searchConversations(\n        limit,\n        pageParam,\n      );\n\n      return result;\n    },\n    enabled: !!userIsAuthenticated && hasBackend,\n    getNextPageParam: (lastPage: AppConversationPage) => lastPage.next_page_id,\n    initialPageParam: undefined as string | undefined,\n    // Poll every 30s so titles, execution status, and timestamps stay fresh\n    // without requiring the user to refresh. Each response carries the full\n    // conversation objects, so on slow links a tighter interval degrades into\n    // a continuous download that starves the rest of the app (including the\n    // events WebSocket handshake). Consumers must gate initial-load UI (e.g.\n    // skeletons) on `isLoading`, not `isFetching` — `isFetching` flips back to\n    // true on every background refetch, which would cause the skeleton to\n    // flicker on each poll when the list is empty.\n    refetchInterval: 30_000,\n    // A successful fetch proves the backend is reachable. The global\n    // QueryCache onSuccess handler reads this to clear any persisted\n    // failure state, re-arming the status dot without user intervention.\n    meta: { backendId: active.backend.id },\n  });\n};\n"],"mappings":";;;;;;AAOA,IAAa,KAA6B,IAAgB,OAAO;CAC/D,IAAM,EAAE,MAAM,MAAwB,EAAY,GAC5C,IAAS,EAAiB,GAC1B,IAAa,CAAC,EAAY,EAAO,OAAO;CAE9C,OAAO,EAAiB;EAKtB,UAAU;GACR;GACA;GACA;GACA;GACA,EAAO,QAAQ;GACf,EAAO;EACT;EACA,SAAS,OAAO,EAAE,mBAMT,MALc,EAA+B,oBAClD,GACA,CACF;EAIF,SAAS,CAAC,CAAC,KAAuB;EAClC,mBAAmB,MAAkC,EAAS;EAC9D,kBAAkB,KAAA;EASlB,iBAAiB;EAIjB,MAAM,EAAE,WAAW,EAAO,QAAQ,GAAG;CACvC,CAAC;AACH"}
+{"version":3,"file":"use-paginated-conversations.js","names":[],"sources":["../../../src/hooks/query/use-paginated-conversations.ts"],"sourcesContent":["import { useInfiniteQuery } from \"@tanstack/react-query\";\nimport AgentServerConversationService from \"#/api/conversation-service/agent-server-conversation-service.api\";\nimport { useIsAuthed } from \"./use-is-authed\";\nimport { isNoBackend } from \"#/api/backend-registry/active-store\";\nimport { useNavigation } from \"#/context/navigation-context\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport { isAutomationsRoute } from \"#/manifests/automation-interface\";\nimport { AppConversationPage } from \"#/api/conversation-service/agent-server-conversation-service.types\";\n\nexport const usePaginatedConversations = (limit: number = 20) => {\n  const { data: userIsAuthenticated } = useIsAuthed();\n  const active = useActiveBackend();\n  const { currentPath } = useNavigation();\n  const hasBackend = !isNoBackend(active.backend);\n\n  return useInfiniteQuery({\n    // Include the active backend identity so each (backend, org) pair\n    // maintains its own paginated cache. Switching backends naturally\n    // produces a new query and a fresh fetch — without it the previous\n    // backend's conversations stay visible for staleTime.\n    queryKey: [\n      \"user\",\n      \"conversations\",\n      \"paginated\",\n      limit,\n      active.backend.id,\n      active.orgId,\n    ],\n    queryFn: async ({ pageParam }) => {\n      const result = await AgentServerConversationService.searchConversations(\n        limit,\n        pageParam,\n      );\n\n      return result;\n    },\n    enabled: !!userIsAuthenticated && hasBackend,\n    getNextPageParam: (lastPage: AppConversationPage) => lastPage.next_page_id,\n    initialPageParam: undefined as string | undefined,\n    // Poll every 30s so titles, execution status, and timestamps stay fresh\n    // without requiring the user to refresh. Each response carries the full\n    // conversation objects, so on slow links a tighter interval degrades into\n    // a continuous download that starves the rest of the app (including the\n    // events WebSocket handshake). Consumers must gate initial-load UI (e.g.\n    // skeletons) on `isLoading`, not `isFetching` — `isFetching` flips back to\n    // true on every background refetch, which would cause the skeleton to\n    // flicker on each poll when the list is empty.\n    //\n    // The interval is paused on automation routes: the dashboard there already\n    // fans out one runs request per automation, and the sidebar list is not\n    // the focus. Only the poll pauses — the initial fetch still happens — and\n    // mutations that create or cancel runs invalidate [\"user\", \"conversations\"]\n    // so the sidebar stays correct while paused.\n    refetchInterval: isAutomationsRoute(currentPath) ? false : 30_000,\n    refetchIntervalInBackground: false,\n    // A successful fetch proves the backend is reachable. The global\n    // QueryCache onSuccess handler reads this to clear any persisted\n    // failure state, re-arming the status dot without user intervention.\n    meta: { backendId: active.backend.id },\n  });\n};\n"],"mappings":";;;;;;;;AASA,IAAa,KAA6B,IAAgB,OAAO;CAC/D,IAAM,EAAE,MAAM,MAAwB,EAAY,GAC5C,IAAS,EAAiB,GAC1B,EAAE,mBAAgB,EAAc,GAChC,IAAa,CAAC,EAAY,EAAO,OAAO;CAE9C,OAAO,EAAiB;EAKtB,UAAU;GACR;GACA;GACA;GACA;GACA,EAAO,QAAQ;GACf,EAAO;EACT;EACA,SAAS,OAAO,EAAE,mBAMT,MALc,EAA+B,oBAClD,GACA,CACF;EAIF,SAAS,CAAC,CAAC,KAAuB;EAClC,mBAAmB,MAAkC,EAAS;EAC9D,kBAAkB,KAAA;EAelB,iBAAiB,EAAmB,CAAW,IAAI,KAAQ;EAC3D,6BAA6B;EAI7B,MAAM,EAAE,WAAW,EAAO,QAAQ,GAAG;CACvC,CAAC;AACH"}

package/dist/hooks/query/use-provider-connections.cjs

@@ -1,2 +1,2 @@
-require("../../_virtual/_rolldown/runtime.cjs");const e=require("./query-keys.cjs"),t=require("../../node_modules/@tanstack/react-query/build/modern/useQuery.cjs"),n=require("../../contexts/active-backend-context.cjs"),r=require("../../api/provider-connections-service/provider-connections-service.api.cjs");function i(){let{backend:i}=n.useActiveBackend(),a=i.kind===`local`;return t.useQuery({queryKey:[...e.PROVIDER_CONNECTIONS_QUERY_KEYS.all,i.id],queryFn:r.default.list,...e.CONFIG_CACHE_OPTIONS,enabled:a,meta:{disableToast:!0}})}exports.useProviderConnections=i;
+require("../../_virtual/_rolldown/runtime.cjs");const e=require("./query-keys.cjs"),t=require("../../node_modules/@tanstack/react-query/build/modern/useQuery.cjs"),n=require("../../contexts/active-backend-context.cjs"),r=require("../../api/provider-connections-service/provider-connections-service.api.cjs");function i(){let{backend:i,orgId:a}=n.useActiveBackend(),o=i.kind===`local`,s=i.kind===`cloud`&&!!a,c=o||s;return t.useQuery({queryKey:[...e.PROVIDER_CONNECTIONS_QUERY_KEYS.all,i.id,a],queryFn:r.default.list,...e.CONFIG_CACHE_OPTIONS,enabled:c,meta:{disableToast:!0}})}exports.useProviderConnections=i;
 //# sourceMappingURL=use-provider-connections.cjs.map

package/dist/hooks/query/use-provider-connections.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-provider-connections.cjs","names":[],"sources":["../../../src/hooks/query/use-provider-connections.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport ProviderConnectionsService from \"#/api/provider-connections-service/provider-connections-service.api\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport {\n  CONFIG_CACHE_OPTIONS,\n  PROVIDER_CONNECTIONS_QUERY_KEYS,\n} from \"./query-keys\";\n\nexport { PROVIDER_CONNECTIONS_QUERY_KEYS };\n\n/**\n * Provider connections live only on the local agent-server. On cloud backends\n * the query stays disabled and returns no data, so the connections UI hides\n * itself rather than firing a request that would 404.\n */\nexport function useProviderConnections() {\n  const { backend } = useActiveBackend();\n  const isLocal = backend.kind === \"local\";\n\n  return useQuery({\n    queryKey: [...PROVIDER_CONNECTIONS_QUERY_KEYS.all, backend.id],\n    queryFn: ProviderConnectionsService.list,\n    ...CONFIG_CACHE_OPTIONS,\n    enabled: isLocal,\n    meta: { disableToast: true },\n  });\n}\n"],"mappings":"oTAeA,SAAgB,GAAyB,CACvC,GAAM,CAAE,WAAY,EAAA,iBAAiB,EAC/B,EAAU,EAAQ,OAAS,QAEjC,OAAO,EAAA,SAAS,CACd,SAAU,CAAC,GAAG,EAAA,gCAAgC,IAAK,EAAQ,EAAE,EAC7D,QAAS,EAAA,QAA2B,KACpC,GAAG,EAAA,qBACH,QAAS,EACT,KAAM,CAAE,aAAc,EAAK,CAC7B,CAAC,CACH"}
+{"version":3,"file":"use-provider-connections.cjs","names":[],"sources":["../../../src/hooks/query/use-provider-connections.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport ProviderConnectionsService from \"#/api/provider-connections-service/provider-connections-service.api\";\nimport { useActiveBackend } from \"#/contexts/active-backend-context\";\nimport {\n  CONFIG_CACHE_OPTIONS,\n  PROVIDER_CONNECTIONS_QUERY_KEYS,\n} from \"./query-keys\";\n\nexport { PROVIDER_CONNECTIONS_QUERY_KEYS };\n\n/**\n * Provider connections are available on the local agent-server\n * (`/api/llm/provider-connections`) and on cloud when an org is bound\n * (`/api/organizations/{orgId}/provider-connections`). The query is disabled\n * only for a cloud backend without an org (legacy API keys), where the\n * org-scoped route cannot be addressed — there it returns no data so the\n * connections UI hides itself rather than firing an unaddressable request.\n */\nexport function useProviderConnections() {\n  const { backend, orgId } = useActiveBackend();\n  const isLocal = backend.kind === \"local\";\n  const isCloudWithOrg = backend.kind === \"cloud\" && !!orgId;\n  const enabled = isLocal || isCloudWithOrg;\n\n  return useQuery({\n    queryKey: [...PROVIDER_CONNECTIONS_QUERY_KEYS.all, backend.id, orgId],\n    queryFn: ProviderConnectionsService.list,\n    ...CONFIG_CACHE_OPTIONS,\n    enabled,\n    meta: { disableToast: true },\n  });\n}\n"],"mappings":"oTAkBA,SAAgB,GAAyB,CACvC,GAAM,CAAE,UAAS,SAAU,EAAA,iBAAiB,EACtC,EAAU,EAAQ,OAAS,QAC3B,EAAiB,EAAQ,OAAS,SAAW,CAAC,CAAC,EAC/C,EAAU,GAAW,EAE3B,OAAO,EAAA,SAAS,CACd,SAAU,CAAC,GAAG,EAAA,gCAAgC,IAAK,EAAQ,GAAI,CAAK,EACpE,QAAS,EAAA,QAA2B,KACpC,GAAG,EAAA,qBACH,UACA,KAAM,CAAE,aAAc,EAAK,CAC7B,CAAC,CACH"}