@mycadet/assistant 0.12.7 → 0.12.8

package/src/calls/tts-call-strategy.ts

@@ -44,7 +44,7 @@ export interface TtsCallStrategy {
  *
  * Reads the provider from config via {@link resolveTtsConfig} (or takes
  * `providerOverride`, the provider a caller already resolved after
- * managed-speech defaulting), then looks up its `callMode` in the catalog.
+ * cloud-speech defaulting), then looks up its `callMode` in the catalog.
  *
  * Falls back to `native-twilio` with `"elevenlabs"` when the config
  * or catalog is unavailable (e.g. test mocks, pre-migration configs).

package/src/calls/voice-escalation-judge.ts

@@ -9,7 +9,7 @@
  * correct reply need something the front door cannot do from here? A
  * confident yes overrules a front-door answer and hands the turn off.
  *
- * The judge uses managed Jev by default when Cadet-managed inference is
+ * The judge uses managed Jev by default when Cadet Cloud inference is
  * available. An explicit TypeSafe call-site override can use a user-owned
  * connection. Every other outcome (unavailable route, provider error,
  * timeout, unparseable answer) is a "clear" verdict, so the front door's own

package/src/calls/voice-ingress-preflight.ts

@@ -1,4 +1,4 @@
-import { getIsPlatform } from "../config/env-registry.js";
+import { getIsCloud } from "../config/env-registry.js";
 import { loadConfig } from "../config/loader.js";
 import type { AssistantConfig } from "../config/types.js";
 import { getPublicBaseUrl } from "../inbound/public-ingress-urls.js";
@@ -34,16 +34,16 @@ export async function preflightVoiceIngress(): Promise<VoiceIngressPreflightResu
   const ingressConfig = loadConfig();
 
   // The daemon performs both STT and TTS on the media-stream transport —
-  // in every deployment mode, platform-hosted included — so credential
+  // in every deployment mode, cloud-hosted included — so credential
   // readiness gates outbound placement before any Twilio call is made.
   const readiness = await resolveTelephonyCredentialReadiness();
   if (readiness.status === "not-ready") {
     return fail(readiness.userMessage);
   }
 
-  // Platform-callback deployments register routes with the platform and receive
+  // Platform-callback deployments register routes with the cloud and receive
   // stable callback URLs. No public ingress URL or local gateway is involved.
-  if (getIsPlatform()) {
+  if (getIsCloud()) {
     return {
       ok: true,
       ingressConfig,

package/src/cli/bundled-modules.ts

@@ -6,7 +6,7 @@ export interface BundledCliModules {
   pluginDiff: typeof import("./lib/diff-plugin.js");
   pluginInspect: typeof import("./lib/inspect-plugin.js");
   pluginInstallGitHub: typeof import("./lib/install-from-github.js");
-  pluginInstallPlatform: typeof import("./lib/install-from-platform.js");
+  pluginInstallPlatform: typeof import("./lib/install-from-cloud.js");
   pluginInstalled: typeof import("./lib/list-installed-plugins.js");
   pluginPinHistory: typeof import("./lib/plugin-pin-history.js");
   pluginSearch: typeof import("./lib/search-plugins.js");

package/src/cli/commands/__tests__/apps.test.ts

@@ -5,43 +5,15 @@
 import { mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { afterEach, beforeEach, describe, expect, mock, test } from "bun:test";
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
 
+import { mockIpc } from "../../../__tests__/requests-mock.js";
 import { createApp, getAppDirPath } from "../../../apps/app-store.js";
 import { writeAppSourceFingerprint } from "../../../apps/source-fingerprint.js";
 import { getWorkspacePluginsDir } from "../../../util/platform.js";
 import { runCliCommand } from "./cli-test-harness.js";
 
-let lastIpcCall: {
-  method: string;
-  params?: Record<string, unknown>;
-} | null = null;
-
-let mockIpcResult: {
-  ok: boolean;
-  result?: unknown;
-  error?: string;
-  statusCode?: number;
-} = { ok: true, result: { ok: true, compiled: true } };
-
-mock.module("../../../ipc/cli-client.js", () => ({
-  cliIpcCall: async (method: string, params?: Record<string, unknown>) => {
-    lastIpcCall = { method, params };
-    return mockIpcResult;
-  },
-  exitCodeFromIpcResult: (r: { statusCode?: number }) => {
-    if (r.statusCode === undefined) {
-      return 10;
-    }
-    if (r.statusCode >= 500) {
-      return 3;
-    }
-    if (r.statusCode >= 400) {
-      return 2;
-    }
-    return 1;
-  },
-}));
+const ipc = await mockIpc("cli");
 
 const { registerAppsCommand } = await import("../apps.js");
 
@@ -63,17 +35,13 @@ beforeEach(() => {
   previousWorkspaceDir = process.env.CADET_WORKSPACE_DIR;
   workspaceDir = freshWorkspace();
   process.env.CADET_WORKSPACE_DIR = workspaceDir;
-  lastIpcCall = null;
-  mockIpcResult = {
+  ipc.on("apps_refresh", {
     ok: true,
-    result: {
-      ok: true,
-      appId: "app-1",
-      name: "Budget",
-      compiled: true,
-      compile_duration_ms: 12,
-    },
-  };
+    appId: "app-1",
+    name: "Budget",
+    compiled: true,
+    compile_duration_ms: 12,
+  });
 });
 
 afterEach(() => {
@@ -179,7 +147,7 @@ describe("assistant apps refresh", () => {
     ]);
 
     expect(result.exitCode).toBe(0);
-    expect(lastIpcCall).toEqual({
+    expect(ipc.lastCall("apps_refresh")).toEqual({
       method: "apps_refresh",
       params: { pathParams: { id: created.id } },
     });
@@ -206,7 +174,7 @@ describe("assistant apps refresh", () => {
     ]);
 
     expect(result.exitCode).toBe(0);
-    expect(lastIpcCall).toEqual({
+    expect(ipc.lastCall("apps_refresh")).toEqual({
       method: "apps_refresh",
       params: { pathParams: { id: `plugins~${pluginName}~viewer` } },
     });
@@ -219,17 +187,14 @@ describe("assistant apps refresh", () => {
       schemaJson: "{}",
       htmlDefinition: "<h1>Budget</h1>",
     });
-    mockIpcResult = {
+    ipc.on("apps_refresh", {
       ok: true,
-      result: {
-        ok: true,
-        appId: created.id,
-        name,
-        compiled: false,
-        compile_duration_ms: 8,
-        compile_errors: [{ text: "Could not resolve foo" }],
-      },
-    };
+      appId: created.id,
+      name,
+      compiled: false,
+      compile_duration_ms: 8,
+      compile_errors: [{ text: "Could not resolve foo" }],
+    });
 
     const result = await runCliCommand(registerAppsCommand, [
       "apps",

package/src/cli/commands/__tests__/plugins.test.ts

@@ -115,7 +115,7 @@ mock.module("../../lib/confirm-prompt.js", () => ({
 }));
 
 const realGithub = await import("../../lib/install-from-github.js");
-const realPlatform = await import("../../lib/install-from-platform.js");
+const realPlatform = await import("../../lib/install-from-cloud.js");
 const realInspect = await import("../../lib/inspect-plugin.js");
 const realUpgrade = await import("../../lib/upgrade-plugin.js");
 const realCliClient = await import("../../../ipc/cli-client.js");
@@ -165,7 +165,7 @@ mock.module("../../lib/install-from-github.js", () => ({
   },
 }));
 
-mock.module("../../lib/install-from-platform.js", () => ({
+mock.module("../../lib/install-from-cloud.js", () => ({
   ...realPlatform,
   installPluginViaPlatform: async (
     opts: { name: string; force?: boolean },
@@ -273,8 +273,8 @@ function runCommand(args: string[]): Promise<CliCommandRunResult> {
   return runCliCommand(registerPluginsCommand, args);
 }
 
-const savedDisablePlatform = process.env.CADET_DISABLE_PLATFORM;
-const savedIsPlatform = process.env.IS_PLATFORM;
+const savedDisablePlatform = process.env.CADET_DISABLE_CLOUD;
+const savedIsPlatform = process.env.IS_CLOUD;
 
 beforeEach(() => {
   confirmCalls = [];
@@ -293,8 +293,8 @@ beforeEach(() => {
   installTarget = null;
   // Platform features on by default, so a plain name install takes the
   // platform-tarball branch.
-  delete process.env.CADET_DISABLE_PLATFORM;
-  delete process.env.IS_PLATFORM;
+  delete process.env.CADET_DISABLE_CLOUD;
+  delete process.env.IS_CLOUD;
 });
 
 afterEach(() => {
@@ -303,14 +303,14 @@ afterEach(() => {
   }
   installTargetDirs.length = 0;
   if (savedDisablePlatform === undefined) {
-    delete process.env.CADET_DISABLE_PLATFORM;
+    delete process.env.CADET_DISABLE_CLOUD;
   } else {
-    process.env.CADET_DISABLE_PLATFORM = savedDisablePlatform;
+    process.env.CADET_DISABLE_CLOUD = savedDisablePlatform;
   }
   if (savedIsPlatform === undefined) {
-    delete process.env.IS_PLATFORM;
+    delete process.env.IS_CLOUD;
   } else {
-    process.env.IS_PLATFORM = savedIsPlatform;
+    process.env.IS_CLOUD = savedIsPlatform;
   }
 });
 
@@ -451,7 +451,7 @@ describe("plugins install - declared-schedules consent", () => {
   });
 
   test("a bundled-catalog install (platform disabled) is gated too", async () => {
-    process.env.CADET_DISABLE_PLATFORM = "true";
+    process.env.CADET_DISABLE_CLOUD = "true";
     stageFixture = writeScheduleFixture;
     confirmResults = ["confirmed"];
 
@@ -465,7 +465,7 @@ describe("plugins install - declared-schedules consent", () => {
     expect(r.exitCode).toBe(0);
   });
 
-  test("a local catalog source bypasses the platform installer", async () => {
+  test("a local catalog source bypasses the cloud installer", async () => {
     catalogMatches = [
       {
         name: "fathom",
@@ -491,7 +491,7 @@ describe("plugins install - declared-schedules consent", () => {
     expect(r.exitCode).toBe(0);
   });
 
-  test("falls back to the platform installer when catalog discovery fails", async () => {
+  test("falls back to the cloud installer when catalog discovery fails", async () => {
     catalogError = new Error("catalog unavailable");
 
     const r = await runCommand(["plugins", "install", "example"]);

package/src/cli/commands/__tests__/tts.test.ts

@@ -353,7 +353,7 @@ describe("tts voice — active-provider routing", () => {
     expect(setCall!.params.body.value).toBe("aura-2-zeus-en");
   });
 
-  test("an ElevenLabs voice id on a managed assistant still writes cadet.model", async () => {
+  test("an ElevenLabs voice id on a cloud assistant still writes cadet.model", async () => {
     respondProvider("cadet");
 
     const { exitCode } = await runCommand([

package/src/cli/commands/auth.help.ts

@@ -29,10 +29,10 @@ Examples:
       description: "Show platform identity and authentication status",
       helpText: `
 Fields:
-  platformUrl         The Cadet Cloud base URL this assistant connects to
+  cloudUrl         The Cadet Cloud base URL this assistant connects to
   assistantId         This assistant's platform UUID
-  organizationId      The organization this assistant belongs to (from PLATFORM_ORGANIZATION_ID)
-  userId              The user who owns this assistant (from PLATFORM_USER_ID)
+  organizationId      The organization this assistant belongs to (from CLOUD_ORGANIZATION_ID)
+  userId              The user who owns this assistant (from CLOUD_USER_ID)
   authenticated       Whether all prerequisites for platform authentication are met
                       (platform URL and assistant API key both present)
 

package/src/cli/commands/auth.ts

@@ -8,7 +8,7 @@ import { shouldOutputJson, writeOutput } from "../output.js";
 import { authHelp } from "./auth.help.js";
 
 interface AuthInfoResponse {
-  platformUrl: string | null;
+  cloudUrl: string | null;
   assistantId: string | null;
   organizationId: string | null;
   userId: string | null;
@@ -37,9 +37,7 @@ export function registerAuthCommand(program: Command): void {
           writeOutput(cmd, result);
 
           if (!shouldOutputJson(cmd)) {
-            log.info(
-              `Platform URL:        ${result.platformUrl ?? "(not set)"}`,
-            );
+            log.info(`Platform URL:        ${result.cloudUrl ?? "(not set)"}`);
             log.info(
               `Assistant ID:        ${result.assistantId ?? "(not set)"}`,
             );

package/src/cli/commands/browser.help.ts

@@ -104,7 +104,7 @@ export const browserHelp: CliCommandHelp = {
     {
       flags: "--virtual-desktop",
       description:
-        "Use Chrome in the platform-hosted virtual desktop with visible cursor feedback.",
+        "Use Chrome in the cloud-hosted virtual desktop with visible cursor feedback.",
     },
     {
       flags: "--session <id>",
@@ -128,7 +128,7 @@ export const browserHelp: CliCommandHelp = {
   ],
   helpText: `
 Browser operations are executed through the running assistant.
-Virtual desktop is available only for platform-hosted assistants.
+Virtual desktop is available only for cloud-hosted assistants.
 In the web client, automatic selection prefers virtual desktop Chrome when
 its feature is enabled and the conversation has an
 identified guardian. The macOS and Windows apps keep their existing browser

package/src/cli/commands/channels/index.help.ts

@@ -72,12 +72,12 @@ and asks for approval like any action with irreversible effects. Reads are
 not distinguished from writes: the effect is the endpoint's. To send a
 message, use 'assistant channels send', which posts through the channel's
 transport and records what it sent; a message posted through this command
-reaches the platform directly and leaves no record of what was said.
+reaches the cloud directly and leaves no record of what was said.
 
 Arguments:
   <channel>  One of: ${BOT_CHANNELS}. A channel with no bot credential of
              its own (phone, cadet) is refused.
-  <url>      The API method path, relative to the platform's API host
+  <url>      The API method path, relative to the cloud's API host
              (for Slack, '/conversations.history'; for Discord, '/users/@me';
              for Telegram, '/getMe'). The provider supplies the host.
 

package/src/cli/commands/channels/index.ts

@@ -16,7 +16,7 @@
  * `send` is the send door (see ./send.ts): it runs the daemon's one send
  * implementation for the channel, so the post is threaded, rendered, and
  * recorded like every other message the assistant sends there. Posting
- * through `request` instead reaches the platform API and leaves no record.
+ * through `request` instead reaches the cloud API and leaves no record.
  *
  * A mutating `refresh` verb (for reconnecting channels, e.g. supplying
  * fresh Slack tokens) is intentionally not part of this group.

package/src/cli/commands/channels/send.ts

@@ -9,7 +9,7 @@
  * channel renders a reply, and written to the chat's conversation only once
  * the channel has acknowledged it.
  *
- * Posting the same text through `channels request` reaches the platform API
+ * Posting the same text through `channels request` reaches the cloud API
  * directly and leaves no record of what was said, which is why this command
  * exists beside it. Both act as the bot and both carry the same rating: the
  * effect is a message either way.

package/src/cli/commands/cloud/__tests__/connect.test.ts

@@ -69,7 +69,7 @@ describe("assistant cloud connect", () => {
     expect(parsed.showPlatformLogin).toBe(true);
   });
 
-  // A stored key the platform rejects is a recovery, not a first setup: the
+  // A stored key the cloud rejects is a recovery, not a first setup: the
   // outcome has to reach the caller in the response, since the daemon's login
   // signal has no shipped consumer.
   test("a rejected stored credential is reported as such", async () => {

package/src/cli/commands/cloud/__tests__/disconnect.test.ts

@@ -79,11 +79,10 @@ describe("assistant cloud disconnect", () => {
     expect(parsed.previousBaseUrl).toBe("https://cloud.mycadet.ai");
   });
 
-  test("rejects with error when running on a platform-hosted assistant", async () => {
+  test("rejects with error when running on a cloud-hosted assistant", async () => {
     mockResponse = {
       ok: false,
-      error:
-        "Cannot disconnect from the platform on a platform-hosted assistant.",
+      error: "Cannot disconnect from the cloud on a cloud-hosted assistant.",
       statusCode: 422,
     };
 
@@ -97,7 +96,7 @@ describe("assistant cloud disconnect", () => {
     mockResponse = {
       ok: false,
       error:
-        "Not connected to a platform. Nothing to disconnect.\n\nRun 'assistant cloud status' to check connection state.",
+        "Not connected to a cloud. Nothing to disconnect.\n\nRun 'assistant cloud status' to check connection state.",
       statusCode: 422,
     };
 

package/src/cli/commands/cloud/connect.ts

@@ -1,7 +1,7 @@
 import type { Command } from "commander";
 
 import { cliIpcCall, exitFromIpcResult } from "../../../ipc/cli-client.js";
-import type { PlatformConnectResponse } from "../../../runtime/routes/platform-routes.js";
+import type { PlatformConnectResponse } from "../../../runtime/routes/cloud-routes.js";
 import { subcommand } from "../../lib/cli-command-help.js";
 import { log } from "../../logger.js";
 import { shouldOutputJson, writeOutput } from "../../output.js";
@@ -34,7 +34,7 @@ export function registerCloudConnectCommand(platform: Command): void {
           // stops at "already logged in" before the credential pass runs;
           // --force runs it.
           log.info(
-            "The stored cloud credential was rejected by the platform. " +
+            "The stored cloud credential was rejected by the cloud. " +
               "Run 'cadet login --force' to sign in again and replace it.",
           );
         } else {

package/src/cli/commands/cloud/credits-format.ts

@@ -69,7 +69,7 @@ export function formatCreditsLines(result: CloudCreditsResult): string[] {
       `Expiring:  ${formatCostUsd(result.credits_expiring_soon)} within 30 days${when}`,
     );
   } else if (result.next_credit_expiry_at) {
-    // A null 30-day figure means the platform did not report it, so only an
+    // A null 30-day figure means the cloud did not report it, so only an
     // actual zero earns the "nothing expires within 30 days" claim.
     const window =
       result.credits_expiring_soon === null

package/src/cli/commands/cloud/index.help.ts

@@ -11,11 +11,11 @@ export const cloudHelp: CliCommandHelp = {
   helpText: `
 The cloud subsystem manages the connection to Cadet Cloud. Use
 'connect', 'status', and 'disconnect' to manage cloud credentials.
-Any assistant using the managed LLM proxy can use these commands.
+Any assistant using the cloud LLM proxy can use these commands.
 
 External service callbacks (Telegram webhooks, Twilio webhooks, email,
-OAuth redirects) route through the platform's gateway proxy via
-'callback-routes'. Works for both platform-managed and self-hosted
+OAuth redirects) route through the cloud's gateway proxy via
+'callback-routes'. Works for both cloud-managed and self-hosted
 assistants.
 
 Examples:
@@ -52,16 +52,16 @@ Reads platform-related environment variables and stored credentials to report
 the current platform deployment context and connection state.
 
 Fields:
-  isPlatform          Whether IS_PLATFORM is set (boolean)
-  baseUrl             CADET_PLATFORM_URL — the platform gateway base URL
+  isPlatform          Whether IS_CLOUD is set (boolean)
+  baseUrl             CADET_CLOUD_URL — the cloud gateway base URL
   assistantId         This assistant's platform UUID
   hasAssistantApiKey  Whether a stored assistant API key is available; null
                       when the credential store could not be read
   hasWebhookSecret    Whether a stored webhook secret is available (needed
                       for email and other inbound webhook channels)
   available           Whether callback registration prerequisites are satisfied
-  organizationId      The platform organization ID (from stored credentials)
-  userId              The platform user ID (from stored credentials)
+  organizationId      The cloud organization ID (from stored credentials)
+  userId              The cloud user ID (from stored credentials)
 
 For the Tunnel state (only relevant for Twilio webhooks and live
 voice/audio), use 'assistant gateway status' instead.
@@ -76,7 +76,7 @@ Examples:
         "Show the organization's credit balance, plan-credit usage, and daily-limit state",
       helpText: `
 Fetches the org's credit balance, plan-included credit usage, extra credit,
-upcoming expiry, today's spend, and daily-limit state from the platform
+upcoming expiry, today's spend, and daily-limit state from the cloud
 billing summary.
 
 Fields:
@@ -103,14 +103,14 @@ Fields:
   credits_expiring_soon  Credit on grants expiring within 30 days, in USD
   next_credit_expiry_at  Earliest upcoming grant expiry (ISO 8601), or null
 
-Grant fields are null when the platform does not report grant figures. Plan
+Grant fields are null when the cloud does not report grant figures. Plan
 credit mixes grants with different lifetimes (only the Pro bundle turns over
 with the billing cycle), so it has no single reset date. next_credit_expiry_at
 is the earliest expiry across all grants, plan-included or not, and
 'assistant cloud subscription' gives the billing cycle boundary.
 
 Requires cloud credentials (run 'assistant cloud connect' first or
-ensure CADET_PLATFORM_URL is set and credentials are stored).
+ensure CADET_CLOUD_URL is set and credentials are stored).
 
 Examples:
   $ assistant cloud credits
@@ -121,7 +121,7 @@ Examples:
       description:
         "Show the organization's current plan and subscription state",
       helpText: `
-Fetches the org's plan and subscription state from the platform. Answers
+Fetches the org's plan and subscription state from the cloud. Answers
 "what plan am I on?".
 
 Fields:
@@ -130,7 +130,7 @@ Fields:
                       null on the base plan
   renewalDate         When the current period ends / the plan renews (ISO
                       8601), or null on the base plan
-  currentPeriodEnd    Same as renewalDate; mirrors the platform field
+  currentPeriodEnd    Same as renewalDate; mirrors the cloud field
   cancelAtPeriodEnd   True when the subscription is set to cancel at period end
   cancelAt            When the subscription cancels (ISO 8601), or null
   selectedCreditTier  The selected Pro credit bundle tier, or null
@@ -142,7 +142,7 @@ For the credit balance (not the plan), use 'assistant cloud credits'. For
 plan pricing, use 'assistant cloud plans'.
 
 Requires cloud credentials (run 'assistant cloud connect' first or
-ensure CADET_PLATFORM_URL is set and credentials are stored).
+ensure CADET_CLOUD_URL is set and credentials are stored).
 
 Examples:
   $ assistant cloud subscription
@@ -152,7 +152,7 @@ Examples:
       name: "plans",
       description: "Show the plan catalog with pricing",
       helpText: `
-Fetches the platform plan catalog. Answers "how much does each plan cost?".
+Fetches the cloud plan catalog. Answers "how much does each plan cost?".
 
 Returns a "plans" array. Each entry has an "id" ("base" or "pro"), "name",
 "billing_interval", and "included_features". The base plan carries
@@ -163,7 +163,7 @@ For the org's OWN plan (not the catalog), use 'assistant cloud
 subscription'. For the credit balance, use 'assistant cloud credits'.
 
 Requires cloud credentials (run 'assistant cloud connect' first or
-ensure CADET_PLATFORM_URL is set and credentials are stored).
+ensure CADET_CLOUD_URL is set and credentials are stored).
 
 Examples:
   $ assistant cloud plans
@@ -173,17 +173,17 @@ Examples:
       name: "invoices",
       description: "Read the organization's Stripe invoice history",
       helpText: `
-Invoices are read from the platform's billing invoices endpoint using this
+Invoices are read from the cloud's billing invoices endpoint using this
 assistant's platform API key. Amounts are Stripe-scaled integers; see
 'assistant cloud invoices list --help' for the scaling rules. 'created'
 is a Unix timestamp in seconds.
 
-The platform returns one page of invoices at a time (newest first). When
+The cloud returns one page of invoices at a time (newest first). When
 the response's 'has_more' is true, pass the last invoice's id via
 --starting-after to fetch the next (older) page.
 
 Requires cloud credentials (run 'assistant cloud connect' first or
-ensure CADET_PLATFORM_URL is set and credentials are stored).
+ensure CADET_CLOUD_URL is set and credentials are stored).
 
 Examples:
   $ assistant cloud invoices list --json
@@ -202,7 +202,7 @@ Examples:
             },
           ],
           helpText: `
-Fetches one page of the org's Stripe invoice history from the platform,
+Fetches one page of the org's Stripe invoice history from the cloud,
 newest first.
 
 Fields:
@@ -229,7 +229,7 @@ Fields:
                       fetch them with --starting-after
 
 Requires cloud credentials (run 'assistant cloud connect' first or
-ensure CADET_PLATFORM_URL is set and credentials are stored).
+ensure CADET_CLOUD_URL is set and credentials are stored).
 
 Examples:
   $ assistant cloud invoices list --json
@@ -246,13 +246,13 @@ Examples:
             },
           ],
           helpText: `
-The platform has no per-invoice endpoint, so the assistant pages through
+The cloud has no per-invoice endpoint, so the assistant pages through
 the org's invoice list (newest first) until the ID matches. The lookup
 searches the most recent 2,500 invoices (25 pages) and errors if the ID
 is not found within that range.
 
 Requires cloud credentials (run 'assistant cloud connect' first or
-ensure CADET_PLATFORM_URL is set and credentials are stored).
+ensure CADET_CLOUD_URL is set and credentials are stored).
 
 Examples:
   $ assistant cloud invoices get in_1AbCdEfGh
@@ -265,8 +265,8 @@ Examples:
       description: "Disconnect from Cadet Cloud by removing stored credentials",
       helpText: `
 Removes all stored cloud credentials from the assistant's secure
-credential store. After disconnecting, platform-managed features (managed
-proxy, managed OAuth, callback routing) will no longer be available until
+credential store. After disconnecting, cloud-managed features (managed
+proxy, cloud OAuth, callback routing) will no longer be available until
 you reconnect with 'assistant cloud connect'.
 
 Use 'assistant cloud status' to check the current connection state
@@ -280,7 +280,7 @@ Examples:
       name: "callback-routes",
       description: "Manage platform callback route registrations",
       helpText: `
-Callback routes tell the platform gateway how to forward inbound provider
+Callback routes tell the cloud gateway how to forward inbound provider
 webhooks to the correct assistant instance. Each route maps a callback path
 and type to a stable external URL that external services (Telegram, Twilio,
 email, OAuth providers) should use.
@@ -293,7 +293,7 @@ Examples:
       subcommands: [
         {
           name: "register",
-          description: "Register a callback route with the platform gateway",
+          description: "Register a callback route with the cloud gateway",
           options: [
             {
               flags: "--path <path>",
@@ -309,14 +309,14 @@ Examples:
             },
           ],
           helpText: `
-Registers a callback route with the platform's internal gateway endpoint so
-the platform knows how to forward inbound provider webhooks to this
-platform-managed assistant instance.
+Registers a callback route with the cloud's internal gateway endpoint so
+the cloud knows how to forward inbound provider webhooks to this
+cloud assistant instance.
 
 Arguments:
   --path    The path portion after the ingress base URL. Leading/trailing
-            slashes are stripped by the platform.
-  --type    The route type identifier used by the platform to classify and
+            slashes are stripped by the cloud.
+  --type    The route type identifier used by the cloud to classify and
             route the callback.
 
 Known callback path/type combinations:
@@ -328,8 +328,8 @@ Known callback path/type combinations:
   --path webhooks/email             --type email
   --path oauth/callback             --type oauth
 
-Works for both platform-managed and self-hosted assistants. Requires
-CADET_PLATFORM_URL and a platform assistant ID. Returns the platform-provided
+Works for both cloud-managed and self-hosted assistants. Requires
+CADET_CLOUD_URL and a cloud assistant ID. Returns the cloud-provided
 stable callback URL that external services should use.
 
 Examples:
@@ -340,11 +340,11 @@ Examples:
           name: "list",
           description: "List registered callback routes for this assistant",
           helpText: `
-Lists all callback routes registered with the platform for this assistant.
+Lists all callback routes registered with the cloud for this assistant.
 Shows the route type, callback URL, and path for each registered webhook.
 
 Requires cloud credentials (run 'assistant cloud connect' first or
-ensure IS_PLATFORM and CADET_PLATFORM_URL are set and credentials are stored).
+ensure IS_CLOUD and CADET_CLOUD_URL are set and credentials are stored).
 
 Examples:
   $ assistant cloud callback-routes list