Skip to content

πŸ™Œ OpenHands: AI-Driven Development

chore: remove SaaS references from codebase (#548)

Hiep Le5d3e5f761151
diff --git a/.agents/skills/custom-codereview-guide.md b/.agents/skills/custom-codereview-guide.md
index f405ba7d7e..082cdbc90b 100644
--- a/.agents/skills/custom-codereview-guide.md
+++ b/.agents/skills/custom-codereview-guide.md
@@ -205,12 +205,12 @@ flag it -- the allowlist should not grow casually.
### Rule 2 -- All cloud backend calls must go through `callCloudProxy`
**DO NOT APPROVE** a PR that issues a direct browser `fetch` or `axios` call to the
-cloud SaaS backend (`app.all-hands.dev`) or a cloud runtime sandbox
+cloud backend (`app.all-hands.dev`) or a cloud runtime sandbox
(`*.prod-runtime.all-hands.dev`). Both origins block CORS from `localhost`. Cloud calls
must go through `callCloudProxy()` in `src/api/cloud/proxy.ts`, which routes them
server-side through `/api/cloud-proxy` on the local agent-server.
-Correct pattern -- cloud SaaS:
+Correct pattern -- cloud:
```ts
callCloudProxy({ backend, method: "GET", path: "/api/v1/app-conversations/search?..." })
```
@@ -237,7 +237,7 @@ return new ConversationClient(getAgentServerClientOptions()).someMethod(...);
```
Missing the `hostOverride` on a runtime-sandbox call is a silent bug: the proxy
-will target `backend.host` (the SaaS API) instead of the actual runtime URL.
+will target `backend.host` (the cloud API) instead of the actual runtime URL.
Flag any `callCloudProxy` call that targets a runtime URL without `hostOverride`.
## SDK Architecture Conventions
diff --git a/AGENTS.md b/AGENTS.md
index 65c7f2e4ec..6b508650cf 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -202,7 +202,7 @@ const data = await fetch(`/api/conversations/${id}`);
### Rule 2 -- Cloud backend routes must go through `callCloudProxy`
-Any call from the browser to the cloud SaaS backend (`app.all-hands.dev`) or a cloud
+Any call from the browser to the cloud backend (`app.all-hands.dev`) or a cloud
runtime sandbox (`*.prod-runtime.all-hands.dev`) **must** go through `callCloudProxy()`
in `src/api/cloud/proxy.ts`. These origins do not permit CORS from `localhost`;
`callCloudProxy` POSTs the request envelope to `/api/cloud-proxy` on the local
@@ -211,7 +211,7 @@ agent-server, which forwards it server-side.
```ts
import { callCloudProxy } from "../cloud/proxy";
-// CORRECT -- cloud SaaS endpoint
+// CORRECT -- cloud endpoint
const result = await callCloudProxy<ResponseType>({
backend,
method: "GET",
@@ -235,7 +235,7 @@ const result = await axios.get(`${backend.host}/api/v1/app-conversations`);
`callCloudProxy` key options:
- `backend` -- the cloud `Backend` object (provides host and bearer token)
- `hostOverride` -- override for runtime-sandbox calls; replaces `backend.host`
-- `authMode` -- `"bearer"` (default, cloud SaaS) | `"session-api-key"` (runtime sandbox) | `"none"`
+- `authMode` -- `"bearer"` (default, cloud) | `"session-api-key"` (runtime sandbox) | `"none"`
- `sessionApiKey` -- required when `authMode === "session-api-key"`
Standard cloud/local branch pattern used throughout the service layer:
@@ -412,7 +412,7 @@ return new ConversationClient(getAgentServerClientOptions()).someMethod(...);
- The terminal tab (`components/features/terminal/terminal.tsx`) is `React.lazy`'d in `conversation-tab-content.tsx` alongside the other tabs, so xterm + addon-fit + xterm.css don't enter the conversation route's eager graph (they ship as a separate `terminal-*.js` chunk now).
- Avoid importing app code through `#/components/conversation-events/chat` or its `event-message-components/index.ts` barrel β€” they exist for `lib/index.ts` (npm subpath) consumers only. Internal callers use deep paths (`./messages`, `./event-message-components/<name>`, `./event-content-helpers/should-render-event`) so Vite dev doesn't fan out the barrel.
-- Backend dropdown connectivity indicator: `useBackendsHealth` (`src/hooks/query/use-backends-health.ts`) polls each registered backend every 10s. Local agent-server backends are probed via `ServerClient.getServerInfo()` (`/server_info`); cloud SaaS backends are probed via `getCurrentCloudApiKey()` (`/api/keys/current` through the bundled `/api/cloud-proxy`). Verdicts are surfaced as a colored dot rendered through `DropdownOption.prefix` (added to `src/ui/dropdown/types.ts`); the trigger reads its prefix from the live `options` array (not downshift's frozen `selectedItem`) so the indicator updates without remounting. The same dot is also rendered in each row of `ManageBackendsModal`, which now opts into a one-shot re-probe for previously disabled backends so opening the modal can clear stale persisted error state when a server has recovered. Tests live in `__tests__/hooks/query/use-backends-health.test.tsx`, the `connection indicator` block of `__tests__/components/backends/backend-selector.test.tsx`, and `__tests__/components/backends/manage-backends-modal.test.tsx`.
+- Backend dropdown connectivity indicator: `useBackendsHealth` (`src/hooks/query/use-backends-health.ts`) polls each registered backend every 10s. Local agent-server backends are probed via `ServerClient.getServerInfo()` (`/server_info`); cloud backends are probed via `getCurrentCloudApiKey()` (`/api/keys/current` through the bundled `/api/cloud-proxy`). Verdicts are surfaced as a colored dot rendered through `DropdownOption.prefix` (added to `src/ui/dropdown/types.ts`); the trigger reads its prefix from the live `options` array (not downshift's frozen `selectedItem`) so the indicator updates without remounting. The same dot is also rendered in each row of `ManageBackendsModal`, which now opts into a one-shot re-probe for previously disabled backends so opening the modal can clear stale persisted error state when a server has recovered. Tests live in `__tests__/hooks/query/use-backends-health.test.tsx`, the `connection indicator` block of `__tests__/components/backends/backend-selector.test.tsx`, and `__tests__/components/backends/manage-backends-modal.test.tsx`.
- Manage Backends modal: `src/components/features/backends/manage-backends-modal.tsx` lets users edit (host/name/api-key/kind) and remove existing backends, plus add new ones inline via a "+ Add Backend" footer button that opens a `BackendFormModal`. Both the dropdown footer's "Add backend" and the manage modal's "+ Add Backend" reuse `BackendFormModal` (see `backend-form-modal.tsx`), with `mode="add"` or `mode="edit"`; `AddBackendModal` is now a thin compatibility wrapper for `BackendFormModal mode="add"`. The modal is also auto-rendered (with a no-op `onClose`) by `src/root.tsx` when the active backend is unreachable, replacing the old full-screen `MissingAgentServerNotice` onboarding screen.
diff --git a/__tests__/api/agent-server-compatibility-bundled-pin.test.ts b/__tests__/api/agent-server-compatibility-bundled-pin.test.ts
index ed04220418..353db3863f 100644
--- a/__tests__/api/agent-server-compatibility-bundled-pin.test.ts
+++ b/__tests__/api/agent-server-compatibility-bundled-pin.test.ts
@@ -54,7 +54,7 @@ describe("loadAgentServerInfo", () => {
];
const overrides = callArgs[0];
- // Must NOT use the cloud host β€” that endpoint doesn't exist on SaaS
+ // Must NOT use the cloud host β€” that endpoint doesn't exist on cloud
// and would fail with a CORS preflight error.
expect(overrides.host).toBeDefined();
expect(overrides.host).not.toBe(cloudBackend.host);
diff --git a/__tests__/api/agent-server-conversation-service.test.ts b/__tests__/api/agent-server-conversation-service.test.ts
index a2522ba421..2927fe230c 100644
--- a/__tests__/api/agent-server-conversation-service.test.ts
+++ b/__tests__/api/agent-server-conversation-service.test.ts
@@ -519,7 +519,7 @@ describe("AgentServerConversationService", () => {
});
});
- it("routes readConversationFile to the SaaS file endpoint with the file_path query param", async () => {
+ it("routes readConversationFile to the cloud file endpoint with the file_path query param", async () => {
// Arrange
vi.mocked(axios.post).mockResolvedValue({ data: "# PLAN content" });
diff --git a/__tests__/api/cloud/conversation-create.test.ts b/__tests__/api/cloud/conversation-create.test.ts
index 4549f50ae0..185941f809 100644
--- a/__tests__/api/cloud/conversation-create.test.ts
+++ b/__tests__/api/cloud/conversation-create.test.ts
@@ -32,7 +32,7 @@ afterEach(() => {
});
describe("AgentServerConversationService cloud branch", () => {
- it("createConversation POSTs the SaaS payload through the proxy and returns a WORKING task", async () => {
+ it("createConversation POSTs the cloud payload through the proxy and returns a WORKING task", async () => {
vi.mocked(axios.post).mockResolvedValue({
data: {
id: "task-123",
@@ -72,7 +72,7 @@ describe("AgentServerConversationService cloud branch", () => {
});
const proxiedBody = (body as { body: Record<string, unknown> }).body;
- // SaaS payload shape β€” flat fields, NO encrypted-settings round-trip.
+ // cloud payload shape β€” flat fields, NO encrypted-settings round-trip.
expect(proxiedBody.selected_repository).toBe("user/repo");
expect(proxiedBody.selected_branch).toBe("main");
expect(proxiedBody.git_provider).toBe("github");
diff --git a/__tests__/api/cloud/conversation-delete.test.ts b/__tests__/api/cloud/conversation-delete.test.ts
index 41d761fa50..0a4f169198 100644
--- a/__tests__/api/cloud/conversation-delete.test.ts
+++ b/__tests__/api/cloud/conversation-delete.test.ts
@@ -32,7 +32,7 @@ afterEach(() => {
});
describe("AgentServerConversationService.deleteConversation cloud branch", () => {
- it("routes through /api/cloud-proxy to the SaaS DELETE app-conversations endpoint", async () => {
+ it("routes through /api/cloud-proxy to the cloud DELETE app-conversations endpoint", async () => {
vi.mocked(axios.post).mockResolvedValue({ data: { success: true } });
await AgentServerConversationService.deleteConversation("conv-abc");
diff --git a/__tests__/api/cloud/conversation-download.test.ts b/__tests__/api/cloud/conversation-download.test.ts
index a85c83e1b4..1c8907917d 100644
--- a/__tests__/api/cloud/conversation-download.test.ts
+++ b/__tests__/api/cloud/conversation-download.test.ts
@@ -32,7 +32,7 @@ afterEach(() => {
});
describe("AgentServerConversationService.downloadConversation cloud branch", () => {
- it("routes through /api/cloud-proxy to the SaaS download endpoint with responseType blob and returns the Blob", async () => {
+ it("routes through /api/cloud-proxy to the cloud download endpoint with responseType blob and returns the Blob", async () => {
const zipBlob = new Blob(["zip-bytes"], { type: "application/zip" });
vi.mocked(axios.post).mockResolvedValue({ data: zipBlob });
diff --git a/__tests__/api/cloud/conversation-pause.test.ts b/__tests__/api/cloud/conversation-pause.test.ts
index 6958bd7e1c..bfd247d695 100644
--- a/__tests__/api/cloud/conversation-pause.test.ts
+++ b/__tests__/api/cloud/conversation-pause.test.ts
@@ -59,7 +59,7 @@ afterEach(() => {
});
describe("pauseConversation cloud branch", () => {
- it("routes through /api/cloud-proxy to POST the SaaS sandbox pause endpoint", async () => {
+ it("routes through /api/cloud-proxy to POST the cloud sandbox pause endpoint", async () => {
vi.spyOn(
AgentServerConversationService,
"batchGetAppConversations",
diff --git a/__tests__/api/cloud/proxy.test.ts b/__tests__/api/cloud/proxy.test.ts
index 05563b243a..56f1512e88 100644
--- a/__tests__/api/cloud/proxy.test.ts
+++ b/__tests__/api/cloud/proxy.test.ts
@@ -66,7 +66,7 @@ describe("callCloudProxy X-Org-Id injection", () => {
});
// Assert β€” the upstream envelope carries the X-Org-Id of the active
- // selection so the SaaS can scope this request to the user's
+ // selection so the cloud backend can scope this request to the user's
// locally-chosen org without depending on user.current_org_id.
const [, body] = vi.mocked(axios.post).mock.calls[0]!;
expect(
@@ -78,7 +78,7 @@ describe("callCloudProxy X-Org-Id injection", () => {
// Arrange β€” the BackendSelector fan-out (e.g. useAllCloudOrganizations)
// calls callCloudProxy(b) for every registered cloud backend. Sending
// the active backend's orgId across an unrelated API key would cause
- // the SaaS to 403 on api_key_org_id / X-Org-Id mismatch.
+ // the cloud backend to 403 on api_key_org_id / X-Org-Id mismatch.
setRegisteredBackends([cloudPersonal, cloudAcme]);
setActiveSelection({
backendId: cloudPersonal.id,
diff --git a/__tests__/api/cloud/sandbox-service.test.ts b/__tests__/api/cloud/sandbox-service.test.ts
index c46478e61a..daf0ced93f 100644
--- a/__tests__/api/cloud/sandbox-service.test.ts
+++ b/__tests__/api/cloud/sandbox-service.test.ts
@@ -36,7 +36,7 @@ afterEach(() => {
describe("batchGetCloudSandboxes", () => {
it("targets /api/v1/sandboxes with one id query param per sandbox id", async () => {
// Arrange β€” multiple ids exercises the URLSearchParams.append path,
- // which is the SaaS contract for batch-fetching sandboxes (the GUI
+ // which is the cloud contract for batch-fetching sandboxes (the GUI
// reads sandbox.exposed_urls from the response to find the VSCODE
// URL instead of asking the runtime for a localhost address).
const ids = ["sandbox-a", "sandbox-b"];
@@ -45,7 +45,7 @@ describe("batchGetCloudSandboxes", () => {
await batchGetCloudSandboxes(ids);
// Assert β€” the cloud-proxy envelope encodes a GET against
- // /api/v1/sandboxes?id=sandbox-a&id=sandbox-b on the SaaS.
+ // /api/v1/sandboxes?id=sandbox-a&id=sandbox-b on the cloud backend.
const [, body] = vi.mocked(axios.post).mock.calls[0]!;
const upstream = body as { method: string; path: string };
expect(upstream.method).toBe("GET");
diff --git a/__tests__/components/backends/backend-selector.test.tsx b/__tests__/components/backends/backend-selector.test.tsx
index fe7b497b27..31fb096c4f 100644
--- a/__tests__/components/backends/backend-selector.test.tsx
+++ b/__tests__/components/backends/backend-selector.test.tsx
@@ -168,7 +168,7 @@ describe("BackendSelector", () => {
expect(screen.getByText("Production")).toBeInTheDocument();
});
- it("expands a cloud backend into one row per org and records the org locally without calling SaaS /switch", async () => {
+ it("expands a cloud backend into one row per org and records the org locally without calling cloud /switch", async () => {
vi.mocked(getCloudOrganizations).mockResolvedValue({
items: [
{ id: "org-personal", name: "Personal" },
@@ -203,7 +203,7 @@ describe("BackendSelector", () => {
await user.click(screen.getByText("Production – Acme Inc"));
// Selecting an org row updates the active selection locally only β€”
- // it must never trigger the SaaS-mutating /switch call that used to
+ // it must never trigger the cloud-mutating /switch call that used to
// leak the local-UI choice into the cloud UI's `current_org_id`.
await waitFor(() => {
const stored = JSON.parse(
@@ -350,7 +350,7 @@ describe("BackendSelector", () => {
// After orgs + /me resolve, the selector snaps the active selection
// onto the personal-workspace org locally β€” without round-tripping
- // /switch on the SaaS (which would have mutated the cloud UI's
+ // /switch on the cloud backend (which would have mutated the cloud UI's
// user.current_org_id as a side effect).
await waitFor(() => {
const stored = JSON.parse(
diff --git a/__tests__/components/conversation-events/chat/event-message-acp-tool-call.test.tsx b/__tests__/components/conversation-events/chat/event-message-acp-tool-call.test.tsx
index 8991fcf236..7bd8c25e6d 100644
--- a/__tests__/components/conversation-events/chat/event-message-acp-tool-call.test.tsx
+++ b/__tests__/components/conversation-events/chat/event-message-acp-tool-call.test.tsx
@@ -8,7 +8,7 @@ import { AgentState } from "#/types/agent-state";
import { ACPToolCallEvent } from "#/types/agent-server/core/events/acp-tool-call-event";
vi.mock("#/hooks/query/use-config", () => ({
- useConfig: () => ({ data: { APP_MODE: "saas" } }),
+ useConfig: () => ({ data: { APP_MODE: "local" } }),
}));
vi.mock("#/hooks/use-agent-state");
vi.mock("#/hooks/use-conversation-id", () => ({
diff --git a/__tests__/hooks/mutation/use-new-conversation-command.test.tsx b/__tests__/hooks/mutation/use-new-conversation-command.test.tsx
index fd99e4b17f..83df06479e 100644
--- a/__tests__/hooks/mutation/use-new-conversation-command.test.tsx
+++ b/__tests__/hooks/mutation/use-new-conversation-command.test.tsx
@@ -151,7 +151,7 @@ describe("useNewConversationCommand", () => {
await result.current.mutateAsync();
await waitFor(() => {
- // Format matches OpenHands' SaaS pattern: useTaskPolling unwraps
+ // Format matches OpenHands' cloud pattern: useTaskPolling unwraps
// `task-{uuid}` and polls until READY, then redirects.
expect(mockNavigate).toHaveBeenCalledWith("/conversations/task-task-789");
});
diff --git a/__tests__/hooks/use-unified-vscode-url.test.tsx b/__tests__/hooks/use-unified-vscode-url.test.tsx
index eae7ab0ebc..a28ce7df67 100644
--- a/__tests__/hooks/use-unified-vscode-url.test.tsx
+++ b/__tests__/hooks/use-unified-vscode-url.test.tsx
@@ -129,9 +129,9 @@ afterEach(() => {
});
describe("useUnifiedVSCodeUrl", () => {
- it("returns the SaaS-computed VSCode URL from sandbox.exposed_urls in cloud mode", async () => {
+ it("returns the cloud-computed VSCode URL from sandbox.exposed_urls in cloud mode", async () => {
// Arrange β€” cloud backend, sandbox returned with a VSCODE entry.
- // This is the steady-state happy path: the SaaS pre-builds the
+ // This is the steady-state happy path: the cloud backend pre-builds the
// public vscode subdomain URL and the GUI must surface it directly
// instead of asking the runtime for /api/vscode/url (which only
// knows its own localhost:8001).
diff --git a/src/api/agent-server-compatibility.ts b/src/api/agent-server-compatibility.ts
index fa7f20ff27..7c03d5cef9 100644
--- a/src/api/agent-server-compatibility.ts
+++ b/src/api/agent-server-compatibility.ts
@@ -55,7 +55,7 @@ export function isAgentServerToolAvailable(toolName: string) {
export async function loadAgentServerInfo() {
// The probe is a *local* agent-server concern β€” it verifies the runtime
// hosting the GUI is reachable. It must NEVER run against the active
- // backend when that backend is cloud, because cloud SaaS hosts don't
+ // backend when that backend is cloud, because cloud hosts don't
// expose /api/server_info and would fail with a CORS error besides.
const local = getEffectiveLocalBackend();
let serverInfo: AgentServerInfo;
diff --git a/src/api/app-preferences-store.ts b/src/api/app-preferences-store.ts
index 2e465d177a..4b4136688d 100644
--- a/src/api/app-preferences-store.ts
+++ b/src/api/app-preferences-store.ts
@@ -7,7 +7,7 @@ import { Settings } from "#/types/settings";
* identity) have no native home there, so we persist them in localStorage
* β€” the same approach `secrets-service.ts` uses for git provider tokens.
*
- * In cloud mode the SaaS backend accepts these fields as flat top-level
+ * In cloud mode the cloud backend accepts these fields as flat top-level
* keys at POST /api/v1/settings, and the cloud fetch returns them. We
* still write through to localStorage so the values survive momentary
* fetch failures and so the merge logic in `syncDerivedSettings` has a
diff --git a/src/api/backend-registry/active-store.ts b/src/api/backend-registry/active-store.ts
index 6aeb5cffcc..d5b9d544da 100644
--- a/src/api/backend-registry/active-store.ts
+++ b/src/api/backend-registry/active-store.ts
@@ -78,7 +78,7 @@ export function getActiveBackend(): ResolvedActiveBackend {
*
* Most of the GUI's services (settings reads/writes, conversation CRUD,
* skills/MCP/secrets, etc.) speak the local agent-server's protocol β€”
- * they would fail against a cloud SaaS host. When the user has chosen a
+ * they would fail against a cloud host. When the user has chosen a
* cloud backend as active, those calls fall back to the first registered
* local backend (or the env-derived default if none exists). Cloud-only
* call sites import `getActiveBackend` directly.
diff --git a/src/api/backend-registry/auth.ts b/src/api/backend-registry/auth.ts
index 386b46040d..6a273cbe33 100644
--- a/src/api/backend-registry/auth.ts
+++ b/src/api/backend-registry/auth.ts
@@ -3,7 +3,7 @@ import type { Backend } from "./types";
/**
* Build the auth headers to send to a backend.
*
- * Local agent-server uses `X-Session-API-Key`. Cloud SaaS expects a bearer
+ * Local agent-server uses `X-Session-API-Key`. Cloud expects a bearer
* token in the `Authorization` header.
*/
export function buildAuthHeaders(backend: Backend): Record<string, string> {
diff --git a/src/api/cloud/auth-service.api.ts b/src/api/cloud/auth-service.api.ts
index 32cf48edce..58f3b40c7b 100644
--- a/src/api/cloud/auth-service.api.ts
+++ b/src/api/cloud/auth-service.api.ts
@@ -3,7 +3,7 @@ import type { Backend } from "../backend-registry/types";
import { callCloudProxy } from "./proxy";
/**
- * Cloud (SaaS) authentication probe. Routed through the bundled local
+ * Cloud authentication probe. Routed through the bundled local
* agent-server's `/api/cloud-proxy` to avoid cross-origin browser calls.
*
* Returns true if the API key is accepted by the cloud backend.
diff --git a/src/api/cloud/conversation-service.api.ts b/src/api/cloud/conversation-service.api.ts
index 032926eff9..d6c496d5e1 100644
--- a/src/api/cloud/conversation-service.api.ts
+++ b/src/api/cloud/conversation-service.api.ts
@@ -10,7 +10,7 @@ import type {
import { callCloudProxy } from "./proxy";
/**
- * The cloud SaaS does not always echo `selected_repository` /
+ * The cloud backend does not always echo `selected_repository` /
* `selected_branch` / `git_provider` back from
* `GET /api/v1/app-conversations` until its own background hydration
* completes. We persist the selection to local storage at connect time
@@ -49,9 +49,9 @@ function getActiveCloudBackend(): Backend {
}
/**
- * Search the cloud SaaS app-conversations list. Mirrors the local
+ * Search the cloud app-conversations list. Mirrors the local
* `AgentServerConversationService.searchConversations` interface but routes
- * through the bundled agent-server's cloud proxy and hits the SaaS
+ * through the bundled agent-server's cloud proxy and hits the cloud
* endpoint `/api/v1/app-conversations/search`.
*/
export async function searchCloudConversations(
@@ -101,9 +101,9 @@ export async function batchGetCloudConversations(
}
/**
- * Create a v1 app-conversation on the cloud SaaS.
+ * Create a v1 app-conversation on the cloud backend.
*
- * Mirrors OpenHands' SaaS flow: POST /api/v1/app-conversations with the
+ * Mirrors OpenHands' cloud flow: POST /api/v1/app-conversations with the
* `AppConversationStartRequest` payload, returning a
* `AppConversationStartTask`. The task is initially WORKING; the caller
* polls `getCloudAppConversationStartTask` (3s cadence per OpenHands)
@@ -111,7 +111,7 @@ export async function batchGetCloudConversations(
* and `session_api_key` are populated) or ERROR.
*
* This path does NOT use encrypted-settings round-tripping. Secrets stay
- * server-side on the SaaS β€” the only auth carried is the cloud bearer
+ * server-side on the cloud backend β€” the only auth carried is the cloud bearer
* token (via the proxy's headers), and the conversation runtime is
* provisioned with its own ephemeral session_api_key returned in the
* task.
@@ -130,11 +130,11 @@ export async function createCloudAppConversation(
}
/**
- * Download a v1 app-conversation as a ZIP from the cloud SaaS. Mirrors
+ * Download a v1 app-conversation as a ZIP from the cloud backend. Mirrors
* the local `AgentServerConversationService.downloadConversation` interface but
* routes through the bundled agent-server's cloud proxy and hits
* `GET /api/v1/app-conversations/{id}/download`, which returns
- * `application/zip` with `Content-Disposition` set by the SaaS.
+ * `application/zip` with `Content-Disposition` set by the cloud backend.
*/
export async function downloadCloudConversation(
conversationId: string,
@@ -149,7 +149,7 @@ export async function downloadCloudConversation(
}
/**
- * Delete a v1 app-conversation on the cloud SaaS. Mirrors the local
+ * Delete a v1 app-conversation on the cloud backend. Mirrors the local
* `AgentServerConversationService.deleteConversation` interface but routes
* through the bundled agent-server's cloud proxy and hits
* `DELETE /api/v1/app-conversations/{id}`, which returns a JSON
@@ -192,7 +192,7 @@ export async function updateCloudConversationPublicFlag(
* Pause the cloud sandbox backing a v1 app-conversation. Mirrors
* OpenHands' `SandboxService.pauseSandbox` β€” routes through the
* bundled agent-server's cloud proxy and hits
- * `POST /api/v1/sandboxes/{sandboxId}/pause` on the SaaS, which stops
+ * `POST /api/v1/sandboxes/{sandboxId}/pause` on the cloud backend, which stops
* the runtime owning the conversation.
*/
export async function pauseCloudSandbox(sandboxId: string): Promise<void> {
@@ -207,7 +207,7 @@ export async function pauseCloudSandbox(sandboxId: string): Promise<void> {
/**
* Read a file from a cloud conversation's sandbox workspace. Mirrors
* OpenHands' `AgentServerConversationService.readConversationFile` β€” hits
- * `GET /api/v1/app-conversations/{id}/file?file_path=...` on the SaaS
+ * `GET /api/v1/app-conversations/{id}/file?file_path=...` on the cloud backend
* and returns the file content as a string.
*/
export async function readCloudConversationFile(
diff --git a/src/api/cloud/organization-service.api.ts b/src/api/cloud/organization-service.api.ts
index 0e72ad1b0a..443ba41266 100644
--- a/src/api/cloud/organization-service.api.ts
+++ b/src/api/cloud/organization-service.api.ts
@@ -56,7 +56,7 @@ export async function getCloudOrganizations(
/**
* Fetch metadata for the API key used to authenticate this cloud backend.
* The returned `orgId` is the single org the key is authorized to act on
- * (the SaaS contract: one key β†’ one org).
+ * (the cloud contract: one key β†’ one org).
*
* Legacy keys minted before per-key org binding existed cause the upstream
* to return HTTP 400 β€” we surface that as `isLegacyKey: true` with a null
@@ -86,7 +86,7 @@ export async function getCurrentCloudApiKey(
/**
* Fetch `GET /api/organizations/{orgId}/me`. Identifies the calling user as
* a member of `orgId`. The GUI uses `me.org_id === me.user_id` to decide
- * whether `orgId` is the user's personal workspace β€” that's the SaaS
+ * whether `orgId` is the user's personal workspace β€” that's the cloud
* contract (the auto-generated personal-workspace org has the same id as
* the user).
*/
diff --git a/src/api/cloud/proxy.ts b/src/api/cloud/proxy.ts
index c9757c5a40..d21e2c0e2e 100644
--- a/src/api/cloud/proxy.ts
+++ b/src/api/cloud/proxy.ts
@@ -28,7 +28,7 @@ interface CloudProxyRequest {
* Override the upstream host. When set, the proxy targets this host
* instead of `backend.host`. Used for runtime-sandbox calls where the
* upstream lives at the conversation's runtime URL (e.g.
- * `http://<id>.prod-runtime.all-hands.dev`) rather than the SaaS API.
+ * `http://<id>.prod-runtime.all-hands.dev`) rather than the cloud API.
* The host must still pass the proxy's allowlist server-side.
*/
hostOverride?: string;
@@ -64,7 +64,7 @@ function buildUpstreamAuthHeaders(
/**
* POST a cloud-proxy envelope to the local agent-server. The local server
* forwards the request to the upstream host server-side, which sidesteps
- * the cross-origin restrictions that would block a direct browser β†’ SaaS
+ * the cross-origin restrictions that would block a direct browser β†’ cloud
* or browser β†’ runtime-sandbox call.
*
* Auth headers (bearer or session-api-key) are attached server-side; they
@@ -80,10 +80,10 @@ export async function callCloudProxy<TResponse = unknown>(
};
// Send `X-Org-Id` so the upstream scopes per-request to the org the user
// selected locally, instead of the user's globally-shared
- // `current_org_id` on the SaaS. Restricted to calls against the active
+ // `current_org_id` on the cloud backend. Restricted to calls against the active
// backend: the selector also fans out per-backend bookkeeping calls
// (e.g. `getCloudOrganizations(b)`) that would otherwise carry the
- // active backend's orgId across an unrelated API key, which the SaaS
+ // active backend's orgId across an unrelated API key, which the cloud backend
// rejects when api_key_org_id and X-Org-Id disagree.
const active = getActiveBackend();
const orgIdHeader =
diff --git a/src/api/cloud/sandbox-service.api.ts b/src/api/cloud/sandbox-service.api.ts
index 98bcd52b20..dde55e5632 100644
--- a/src/api/cloud/sandbox-service.api.ts
+++ b/src/api/cloud/sandbox-service.api.ts
@@ -15,9 +15,9 @@ function getActiveCloudBackend(): Backend {
* Batch-fetch cloud sandboxes by id. Mirrors OpenHands'
* `SandboxService.batchGetSandboxes` β€” routes through the bundled
* agent-server's cloud proxy and hits `GET /api/v1/sandboxes?id=...` on
- * the SaaS, returning each `SandboxInfo` (or null if not found).
+ * the cloud backend, returning each `SandboxInfo` (or null if not found).
*
- * The returned `SandboxInfo.exposed_urls` carry the SaaS-computed,
+ * The returned `SandboxInfo.exposed_urls` carry the cloud-computed,
* publicly-reachable URLs for the sandbox's services (VSCODE,
* AGENT_SERVER, WORKER_*) β€” the GUI reads them directly instead of
* asking the runtime for `/api/vscode/url`, which only knows its
diff --git a/src/api/cloud/secrets-service.api.ts b/src/api/cloud/secrets-service.api.ts
index c5d87baa95..f334f3283d 100644
--- a/src/api/cloud/secrets-service.api.ts
+++ b/src/api/cloud/secrets-service.api.ts
@@ -19,7 +19,7 @@ function getActiveCloudBackend(): Backend {
}
/**
- * Walk every page of the cloud SaaS `/api/v1/secrets/search` endpoint via the
+ * Walk every page of the cloud `/api/v1/secrets/search` endpoint via the
* bundled `/api/cloud-proxy` and return the merged list. The cloud shape
* (name + description) matches `CustomSecretWithoutValue`, so items pass
* through unchanged.
diff --git a/src/api/cloud/settings-service.api.ts b/src/api/cloud/settings-service.api.ts
index 9515a31bc0..82c2fd21fd 100644
--- a/src/api/cloud/settings-service.api.ts
+++ b/src/api/cloud/settings-service.api.ts
@@ -10,7 +10,7 @@ import type { Backend } from "../backend-registry/types";
import { callCloudProxy } from "./proxy";
/**
- * The cloud SaaS Settings response is mostly flat β€” top-level fields like
+ * The cloud Settings response is mostly flat β€” top-level fields like
* `llm_model`, `provider_tokens_set`, etc., rather than the nested
* `{ agent_settings, conversation_settings }` shape the local agent-server
* uses. We deliberately do NOT remap cloud fields into the local shape:
@@ -120,7 +120,7 @@ function deriveConversationSettings(
}
/**
- * Fetch the cloud SaaS settings and return them as a `Partial<Settings>`.
+ * Fetch the cloud settings and return them as a `Partial<Settings>`.
*
* Top-level fields like `provider_tokens_set` are preserved unchanged so
* the existing `useUserProviders` β†’ `useAppInstallations` β†’
diff --git a/src/api/cloud/skills-service.api.ts b/src/api/cloud/skills-service.api.ts
index e7ccad4477..f8d98f1e66 100644
--- a/src/api/cloud/skills-service.api.ts
+++ b/src/api/cloud/skills-service.api.ts
@@ -19,7 +19,7 @@ function getActiveCloudBackend(): Backend {
}
/**
- * Fetch the full list of skills from the cloud SaaS via the bundled
+ * Fetch the full list of skills from the cloud backend via the bundled
* /api/cloud-proxy. The cloud endpoint is paginated (page_id cursor); we
* walk all pages so the settings UI gets a complete list in one call. The
* cloud SkillInfo shape (name/type/source/triggers) matches the GUI's
diff --git a/src/api/cloud/types.ts b/src/api/cloud/types.ts
index 10b3ae2103..2c66f5639e 100644
--- a/src/api/cloud/types.ts
+++ b/src/api/cloud/types.ts
@@ -1,5 +1,5 @@
/**
- * Minimal slice of the OpenHands SaaS organization shape that the GUI needs
+ * Minimal slice of the OpenHands cloud organization shape that the GUI needs
* to render the backend selector. Full shape lives in the OpenHands repo;
* we keep only the fields actually read by this codebase.
*/
diff --git a/src/api/conversation-service/agent-server-conversation-service.api.ts b/src/api/conversation-service/agent-server-conversation-service.api.ts
index 38444ada29..7f45d4f9a4 100644
--- a/src/api/conversation-service/agent-server-conversation-service.api.ts
+++ b/src/api/conversation-service/agent-server-conversation-service.api.ts
@@ -271,11 +271,11 @@ class AgentServerConversationService {
sandboxId?: string,
): Promise<AppConversationStartTask> {
if (getActiveBackend().backend.kind === "cloud") {
- // Cloud SaaS path mirrors OpenHands' frontend: build a flat
+ // Cloud path mirrors OpenHands' frontend: build a flat
// AppConversationStartRequest, POST /api/v1/app-conversations
// (returns a WORKING task), and let the conversation route's
// useTaskPolling drive it to READY. NO encrypted-settings
- // round-trip β€” the SaaS holds secrets server-side.
+ // round-trip β€” the cloud backend holds secrets server-side.
const request: AppConversationStartRequest = {
initial_message: initialUserMsg
? {
@@ -365,7 +365,7 @@ class AgentServerConversationService {
sessionApiKey?: string | null,
): Promise<GetVSCodeUrlResponse> {
// Local-only path. Cloud conversations read the VSCode URL straight
- // from the SaaS-computed `sandbox.exposed_urls` (see
+ // from the cloud-computed `sandbox.exposed_urls` (see
// `useUnifiedVSCodeUrl` + `useCloudSandbox`); the runtime's own
// `/api/vscode/url` only knows its internal `localhost:8001`, which
// the user's browser can't reach.
@@ -452,7 +452,7 @@ class AgentServerConversationService {
filePath?: string,
): Promise<string> {
if (getActiveBackend().backend.kind === "cloud") {
- // Cloud SaaS exposes a per-conversation file endpoint; the sandbox
+ // Cloud exposes a per-conversation file endpoint; the sandbox
// working dir is fixed (`/workspace/project`), so PLAN.md lives at
// a known absolute path. Mirrors OpenHands' readConversationFile.
const path = requirePathInsideDirectory(
diff --git a/src/api/event-service/event-service.api.ts b/src/api/event-service/event-service.api.ts
index a255c2262f..348197b639 100644
--- a/src/api/event-service/event-service.api.ts
+++ b/src/api/event-service/event-service.api.ts
@@ -18,11 +18,11 @@ import type {
/**
* Cloud-mode REST calls are split between two upstream hosts (matching
- * OpenHands' SaaS frontend):
+ * OpenHands' cloud frontend):
*
* - **App API** (`backend.host`, default in `callCloudProxy`):
* event *history* (`/api/v1/conversation/{id}/events/search`).
- * Persisted by the SaaS β€” survives the runtime sandbox.
+ * Persisted by the cloud backend β€” survives the runtime sandbox.
*
* - **Runtime sandbox** (extracted from `conversation.conversation_url`
* and passed as `hostOverride`): live runtime endpoints like
@@ -32,7 +32,7 @@ import type {
*
* Both go through the bundled local agent-server's `/api/cloud-proxy`,
* which sidesteps the cross-origin restrictions that block the GUI at
- * `localhost` from talking directly to either the SaaS or the runtime.
+ * `localhost` from talking directly to either the cloud backend or the runtime.
*
* Local mode keeps the existing typescript-client path: it targets the
* conversation's host directly via typed client classes.
@@ -110,7 +110,7 @@ class EventService {
const limit = options.limit ?? 100;
if (active.kind === "cloud") {
- // Event *history* lives on the SaaS App API, not the runtime
+ // Event *history* lives on the cloud App API, not the runtime
// sandbox. Path is singular `conversation` and v1-prefixed.
//
// Full pagination params (sort_order, page_id, timestamp filters)
diff --git a/src/api/settings-service/settings-service.api.ts b/src/api/settings-service/settings-service.api.ts
index 4ab46358e0..8896429a73 100644
--- a/src/api/settings-service/settings-service.api.ts
+++ b/src/api/settings-service/settings-service.api.ts
@@ -219,7 +219,7 @@ class SettingsService {
* Uses in-memory cache for performance.
*/
static async getSettings(): Promise<Settings> {
- // Cloud SaaS uses a different settings shape (flat top-level fields
+ // Cloud uses a different settings shape (flat top-level fields
// including provider_tokens_set, llm_model, etc.). Branch out before
// touching the local-only cache: cloud responses bypass the local
// SettingsApiResponse shape and feed straight into syncDerivedSettings
diff --git a/src/api/suggestions-service/suggestions-service.api.ts b/src/api/suggestions-service/suggestions-service.api.ts
index 708073edbf..16e70c26c2 100644
--- a/src/api/suggestions-service/suggestions-service.api.ts
+++ b/src/api/suggestions-service/suggestions-service.api.ts
@@ -4,7 +4,7 @@ import { getCloudSuggestedTasks } from "../cloud/suggestions-service.api";
export class SuggestionsService {
/**
- * Aggregate suggested tasks for the calling user. Cloud SaaS exposes
+ * Aggregate suggested tasks for the calling user. Cloud exposes
* `/api/v1/git/suggested-tasks/search` which the proxy forwards to.
* Local agent-server has no equivalent endpoint, so we return an
* empty list there β€” the home page's `<TaskSuggestions />` already
diff --git a/src/components/features/backends/backend-selector.tsx b/src/components/features/backends/backend-selector.tsx
index a94a6f66ca..d2daafdd2c 100644
--- a/src/components/features/backends/backend-selector.tsx
+++ b/src/components/features/backends/backend-selector.tsx
@@ -73,7 +73,7 @@ function buildOptions(
prefix,
});
} else {
- // Personal-workspace rule (per the SaaS contract): the org whose
+ // Personal-workspace rule (per the cloud contract): the org whose
// id matches the calling user's id is the user's personal
// workspace. We resolve `user_id` once per backend (via /me on any
// one org) and apply it across all orgs of that backend.
@@ -174,7 +174,7 @@ export function BackendSelector({
// (UI says "Local", APIs hit cloud). When we detect the drift, snap
// the selection onto the personal-workspace org (or, lacking a /me
// result, the first org). The selection is recorded locally only;
- // the SaaS request scope follows from the API key's bound org and the
+ // the cloud request scope follows from the API key's bound org and the
// X-Org-Id header sent by `callCloudProxy`, so the cloud UI's
// org choice is never mutated as a side effect.
React.useEffect(() => {
diff --git a/src/components/features/conversation/conversation-name-context-menu.tsx b/src/components/features/conversation/conversation-name-context-menu.tsx
index 4af2171e58..229e1c3602 100644
--- a/src/components/features/conversation/conversation-name-context-menu.tsx
+++ b/src/components/features/conversation/conversation-name-context-menu.tsx
@@ -115,7 +115,7 @@ export function ConversationNameContextMenu({
backend.kind === "cloud"
? I18nKey.COMMON$CLOSE_CONVERSATION_STOP_RUNTIME
: I18nKey.COMMON$STOP_CONVERSATION;
- // Public sharing is a cloud-only SaaS feature; hide it on local backends.
+ // Public sharing is a cloud-only feature; hide it on local backends.
const shouldShowPublicSharing =
backend.kind === "cloud" && Boolean(onTogglePublic);
diff --git a/src/hooks/mutation/use-create-conversation.ts b/src/hooks/mutation/use-create-conversation.ts
index 4c8db91288..cd76f30725 100644
--- a/src/hooks/mutation/use-create-conversation.ts
+++ b/src/hooks/mutation/use-create-conversation.ts
@@ -63,7 +63,7 @@ export const useCreateConversation = () => {
agentType,
);
- // OpenHands SaaS pattern: when the start task isn't immediately
+ // OpenHands cloud pattern: when the start task isn't immediately
// READY (cloud sandbox is still provisioning),
// app_conversation_id is null. We return a `task-{id}` URL so the
// conversation route's useTaskPolling can drive it to READY and
@@ -91,7 +91,7 @@ export const useCreateConversation = () => {
queryClient.invalidateQueries({
queryKey: ["user", "conversations"],
});
- // The cloud SaaS path returns a start task (no app_conversation_id
+ // The cloud path returns a start task (no app_conversation_id
// yet); the sidebar surfaces those via `useStartTasks` which doesn't
// poll, so invalidate it explicitly so the in-flight task shows up
// in the conversation list immediately.
diff --git a/src/hooks/mutation/use-delete-conversation.ts b/src/hooks/mutation/use-delete-conversation.ts
index c20dc49ddc..5a559bf39a 100644
--- a/src/hooks/mutation/use-delete-conversation.ts
+++ b/src/hooks/mutation/use-delete-conversation.ts
@@ -42,7 +42,7 @@ export const useDeleteConversation = () => {
},
onSettled: () => {
queryClient.invalidateQueries({ queryKey: ["user", "conversations"] });
- // Mirror useCreateConversation: cloud SaaS surfaces in-flight
+ // Mirror useCreateConversation: cloud surfaces in-flight
// conversations via useStartTasks, so invalidate that key too so the
// panel refreshes regardless of whether the deleted item was a ready
// conversation or a still-provisioning start task.
diff --git a/src/hooks/mutation/use-new-conversation-command.ts b/src/hooks/mutation/use-new-conversation-command.ts
index 096775d94f..47b7fa40a7 100644
--- a/src/hooks/mutation/use-new-conversation-command.ts
+++ b/src/hooks/mutation/use-new-conversation-command.ts
@@ -24,7 +24,7 @@ export const useNewConversationCommand = () => {
}
// /new reuses the parent conversation's sandbox (matches OpenHands
- // SaaS behavior); it is NOT a sub-conversation, so parent_conversation_id
+ // cloud behavior); it is NOT a sub-conversation, so parent_conversation_id
// and agent_type stay undefined.
const startTask = await AgentServerConversationService.createConversation(
undefined,
@@ -43,7 +43,7 @@ export const useNewConversationCommand = () => {
);
}
- // Cloud SaaS returns a WORKING task (no app_conversation_id yet);
+ // Cloud returns a WORKING task (no app_conversation_id yet);
// navigate to /conversations/task-{id} so useTaskPolling drives it
// to READY. Local creates synchronously β€” app_conversation_id is
// already set, so we navigate straight to it.
diff --git a/src/hooks/query/use-app-installations.ts b/src/hooks/query/use-app-installations.ts
index 59ee4c1459..d20065af0a 100644
--- a/src/hooks/query/use-app-installations.ts
+++ b/src/hooks/query/use-app-installations.ts
@@ -36,7 +36,7 @@ export const useAppInstallations = (selectedProvider: Provider | null) => {
!!selectedProvider &&
// Gate on providers length too: when settings haven't yet told
// us which providers the user has connected we must not fire,
- // otherwise we'd hit the SaaS for a provider it can't service.
+ // otherwise we'd hit the cloud backend for a provider it can't service.
providers.length > 0 &&
shouldUseInstallationRepos(selectedProvider, active.backend.kind),
staleTime: 1000 * 60 * 5, // 5 minutes
diff --git a/src/hooks/query/use-backends-health.ts b/src/hooks/query/use-backends-health.ts
index e33082d343..0a32cb3b89 100644
--- a/src/hooks/query/use-backends-health.ts
+++ b/src/hooks/query/use-backends-health.ts
@@ -22,7 +22,7 @@ const PROBE_TIMEOUT_MS = 4000;
* - Local agent-server: GET `/server_info` via the typescript-client.
* That's the same endpoint the root compatibility check uses, so a
* healthy backend always answers it.
- * - Cloud SaaS: GET `/api/keys/current` via the bundled local
+ * - Cloud: GET `/api/keys/current` via the bundled local
* agent-server's `/api/cloud-proxy`. That endpoint is lightweight,
* requires auth, and `getCurrentCloudApiKey` already absorbs the
* legacy-key 400 fallback so we treat that as "connected" too.
diff --git a/src/hooks/query/use-cloud-current-user-id.ts b/src/hooks/query/use-cloud-current-user-id.ts
index 7201376670..351ebcc080 100644
--- a/src/hooks/query/use-cloud-current-user-id.ts
+++ b/src/hooks/query/use-cloud-current-user-id.ts
@@ -10,7 +10,7 @@ import { useAllCloudOrganizations } from "./use-cloud-organizations";
* Resolve the current user's `user_id` per cloud backend with one
* `/api/organizations/{orgId}/me` call per backend (NOT one per org).
*
- * The SaaS contract: `/me` returns `{ org_id, user_id, … }`. `user_id`
+ * The cloud contract: `/me` returns `{ org_id, user_id, … }`. `user_id`
* is identical regardless of which org you ask, so we make a single
* call per backend.
*
diff --git a/src/hooks/query/use-cloud-organizations.ts b/src/hooks/query/use-cloud-organizations.ts
index 11c1962774..7263a4801a 100644
--- a/src/hooks/query/use-cloud-organizations.ts
+++ b/src/hooks/query/use-cloud-organizations.ts
@@ -21,7 +21,7 @@ export function useAllCloudOrganizations() {
queries: cloudBackends.map((backend) => ({
queryKey: ["cloud-organizations", backend.id],
// Filter the user's full org membership down to the single org the
- // backend's API key is bound to. The SaaS enforces one-key-one-org
+ // backend's API key is bound to. The cloud enforces one-key-one-org
// server-side (HTTP 403 otherwise); without this filter the
// selector would advertise orgs the key cannot use. Legacy keys
// with no binding fall through unfiltered.
diff --git a/src/hooks/query/use-unified-vscode-url.ts b/src/hooks/query/use-unified-vscode-url.ts
index b84f1c0d68..87b695348f 100644
--- a/src/hooks/query/use-unified-vscode-url.ts
+++ b/src/hooks/query/use-unified-vscode-url.ts
@@ -28,7 +28,7 @@ export const useUnifiedVSCodeUrl = () => {
const sandboxId = conversation?.sandbox_id ?? null;
const isCloud = active.backend.kind === "cloud";
- // Cloud mode: read VSCode URL from the SaaS-computed `exposed_urls` on
+ // Cloud mode: read VSCode URL from the cloud-computed `exposed_urls` on
// the conversation's sandbox. The runtime's `/api/vscode/url` only
// knows its internal `localhost:8001`, so calling it returned a URL
// the user's browser couldn't reach.
diff --git a/src/hooks/use-conversation-name-context-menu.ts b/src/hooks/use-conversation-name-context-menu.ts
index f162531832..c77636cdb7 100644
--- a/src/hooks/use-conversation-name-context-menu.ts
+++ b/src/hooks/use-conversation-name-context-menu.ts
@@ -150,7 +150,7 @@ export function useConversationNameContextMenu({
const shareUrl = React.useMemo(() => {
if (!conversationId) return "";
// On cloud backends, the shareable URL must point at the cloud
- // environment's host (e.g. the SaaS app domain) rather than the local
+ // environment's host (e.g. the cloud app domain) rather than the local
// dev origin so the link works for anyone the user shares it with.
const origin =
backend.kind === "cloud"
diff --git a/src/utils/utils.ts b/src/utils/utils.ts
index c5381cb66d..1089c810ea 100644
--- a/src/utils/utils.ts
+++ b/src/utils/utils.ts
@@ -166,7 +166,7 @@ export const getFileExtension = (fileName: string): string => {
* (`/api/v1/git/installations/search` β†’ `/api/v1/git/repositories/search?installation_id=…`)
* for the given provider/backend combo.
*
- * Mirrors OpenHands' SaaS frontend (parameterized by `app_mode`):
+ * Mirrors OpenHands' cloud frontend (parameterized by `app_mode`):
* - bitbucket / bitbucket_data_center β†’ always installation-based
* - github β†’ installation-based ONLY when the active backend is cloud
* - gitlab / azure_devops / forgejo β†’ direct (search) flow