@mycadet/assistant 0.12.7 → 0.12.8

package/src/cli/commands/config.ts

@@ -40,7 +40,7 @@ const SERVICE_MODE_PATH_RE = /^services\.[^.]+\.mode$/;
  */
 const REMOVED_MODE_PATHS: Record<string, string> = {
   "services.web-search.mode":
-    "services.web-search.mode does not exist; web search is configured by provider alone. For managed search run `config set services.web-search.provider cadet`.",
+    "services.web-search.mode does not exist; web search is configured by provider alone. For cloud search run `config set services.web-search.provider cadet`.",
   "services.image-generation.mode":
     "services.image-generation.mode does not exist; image generation is configured by provider alone. For managed image generation run `config set services.image-generation.provider cadet`.",
 };

package/src/cli/commands/credentials.ts

@@ -59,8 +59,8 @@ function printCredentialHuman(output: Record<string, unknown>): void {
   }
 }
 
-function printManagedCredentialHuman(output: Record<string, unknown>): void {
-  log.info(`  [platform-managed] ${output.provider}`);
+function printCloudCredentialHuman(output: Record<string, unknown>): void {
+  log.info(`  [cloud-managed] ${output.provider}`);
   log.info(`    Handle:      ${output.handle}`);
   log.info(`    Status:      ${output.status}`);
   if (output.accountInfo) {
@@ -82,7 +82,7 @@ function printManagedCredentialHuman(output: Record<string, unknown>): void {
 
 interface CredentialsListResponse {
   credentials: Record<string, unknown>[];
-  managedCredentials: Record<string, unknown>[];
+  cloudCredentials: Record<string, unknown>[];
 }
 
 interface CredentialsStatusResponse {
@@ -120,16 +120,16 @@ export function registerCredentialsCommand(program: Command): void {
             );
           }
 
-          const { credentials, managedCredentials } = r.result!;
+          const { credentials, cloudCredentials } = r.result!;
 
           if (shouldOutputJson(cmd)) {
             writeOutput(cmd, {
               ok: true,
               credentials,
-              managedCredentials,
+              cloudCredentials,
             });
           } else {
-            const totalCount = credentials.length + managedCredentials.length;
+            const totalCount = credentials.length + cloudCredentials.length;
             if (totalCount === 0) {
               log.info("No credentials found");
             } else {
@@ -140,12 +140,10 @@ export function registerCredentialsCommand(program: Command): void {
                   log.info("");
                 }
               }
-              if (managedCredentials.length > 0) {
-                log.info(
-                  `${managedCredentials.length} platform-managed credential(s):\n`,
-                );
-                for (const managed of managedCredentials) {
-                  printManagedCredentialHuman(managed);
+              if (cloudCredentials.length > 0) {
+                log.info(`${cloudCredentials.length} cloud credential(s):\n`);
+                for (const managed of cloudCredentials) {
+                  printCloudCredentialHuman(managed);
                   log.info("");
                 }
               }

package/src/cli/commands/domain.ts

@@ -70,7 +70,7 @@ Examples:
           return `
 Arguments:
   subdomain   The subdomain to register (e.g. "velly" → velly.${baseDomain}).
-              If omitted, the platform derives it from the assistant's name.
+              If omitted, the cloud derives it from the assistant's name.
 
 Options:
   --email-username <username>  Also register an email address for the domain

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

@@ -114,7 +114,7 @@ from the assistant's registered email address.
 
 Body source priority: --body flag > --file flag > stdin (if not a TTY).
 
-When --reply-to is provided, the platform auto-resolves In-Reply-To,
+When --reply-to is provided, the cloud auto-resolves In-Reply-To,
 References, and Subject headers from the referenced email. You can
 still override subject with -s.
 

package/src/cli/commands/email.ts

@@ -180,7 +180,7 @@ Examples:
           "after",
           () => `
 Shows the email address registered for this assistant along with
-current usage and quota information from the platform.
+current usage and quota information from the cloud.
 
 Examples:
   $ assistant email status
@@ -482,7 +482,7 @@ Examples:
           }
 
           // Read attachments and base64-encode their content for the JSON
-          // wire to the platform proxy.
+          // wire to the cloud proxy.
           let attachments:
             | { filename: string; content_type: string; content: string }[]
             | undefined;

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

@@ -32,7 +32,7 @@ public-ingress transport (currently Tunnel).
 
 The tunnel is ONLY used to route inbound Twilio webhooks and live voice/audio
 WebSockets through to this assistant. It has nothing to do with platform
-credentials, the managed LLM proxy, or text channels. If you are not using
+credentials, the cloud LLM proxy, or text channels. If you are not using
 Twilio voice or live audio, a "not connected" tunnel is expected and harmless.
 
 JSON output (--json):

package/src/cli/commands/gateway.ts

@@ -111,7 +111,7 @@ export function registerGatewayCommand(program: Command): void {
         log.info(
           "  live voice/audio WebSockets. It is not needed for text channels or",
         );
-        log.info("  the managed LLM proxy.");
+        log.info("  the cloud LLM proxy.");
       });
 
       const logs = subcommand(gateway, "logs");

package/src/cli/commands/image-generation.help.ts

@@ -7,7 +7,7 @@ export const imageGenerationHelp: CliCommandHelp = {
   description: "AI image generation and editing",
   helpText: `
 Modes:
-  managed    — Uses platform-managed credentials (requires login to Cadet).
+  managed    — Uses cloud credentials (requires login to Cadet).
   your-own   — Uses your own Gemini or OpenAI API key depending on the configured model.
 
 Supported models: pass a tier alias, the assistant resolves it to the

package/src/cli/commands/inference-providers.ts

@@ -65,7 +65,7 @@ function formatAuth(auth: AuthInfo): string {
     case "api_key":
       return `api_key (credential: ${auth.credential})`;
     case "platform":
-      return "platform (managed proxy)";
+      return "platform (cloud proxy)";
     case "none":
       return "none";
     case "oauth_subscription":

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

@@ -204,11 +204,11 @@ Examples:
       helpText: `
 A provider entry names a model provider plus how to reach it. Auth is
 derived from the provider: keyless providers (ollama) need none, the
-Cadet entry routes through the platform's managed proxy, and everything
+Cadet entry routes through the cloud's cloud proxy, and everything
 else uses an API key referenced by --credential.
 
 Canonical entry (seeded on every boot):
-  cadet → the platform-managed provider; cannot be deleted
+  cadet → the cloud provider; cannot be deleted
 
 Examples:
   $ assistant inference providers list

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

@@ -739,7 +739,7 @@ only contested gate decisions — the signal relevant for threshold calibration.
 Coverage is limited to runs still pending platform flush. In a healthy system
 the outbox holds only the last few minutes to hours of events, so
 --lookback-days is an upper bound, not a guarantee; long-window aggregation
-lives on the platform side on top of flushed watchdog events.
+lives on the cloud side on top of flushed watchdog events.
 
 Reads the telemetry database directly — the assistant does not need to be
 running.

package/src/cli/commands/oauth/connect.test.ts

@@ -98,7 +98,7 @@ async function runConnectCommand(extraArgs: string[] = []): Promise<{
 }
 
 describe("oauth connect", () => {
-  test("managed provider in a conversation shell returns oauth_connect guidance without opening a browser", async () => {
+  test("cloud provider in a conversation shell returns oauth_connect guidance without opening a browser", async () => {
     const { stdout, exitCode } = await runConnectCommand();
 
     expect(exitCode).toBe(1);
@@ -116,7 +116,7 @@ describe("oauth connect", () => {
     ]);
   });
 
-  test("managed provider in a conversation shell includes requested scopes in the oauth_connect guidance", async () => {
+  test("cloud provider in a conversation shell includes requested scopes in the oauth_connect guidance", async () => {
     const { stdout, exitCode } = await runConnectCommand([
       "--scopes",
       "https://www.googleapis.com/auth/tasks",

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

@@ -152,7 +152,7 @@ export function registerConnectCommand(oauth: Command): void {
 
             if (opts.clientId) {
               log.info(
-                `Warning: --client-id is ignored for platform-managed providers. The platform manages OAuth apps for "${provider}".`,
+                `Warning: --client-id is ignored for cloud providers. The cloud manages OAuth apps for "${provider}".`,
               );
             }
 

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

@@ -515,7 +515,7 @@ Arguments:
 
 Modes:
   managed    OAuth credentials are managed by Cadet Cloud. The
-             assistant connects via a platform-hosted authorization flow.
+             assistant connects via a cloud-hosted authorization flow.
              No local client ID or secret is needed.
   your-own   You supply your own OAuth app credentials (client ID and
              secret). The assistant runs the OAuth flow locally.
@@ -699,9 +699,9 @@ completion. Use --no-browser to print the URL instead (useful for headless
 or SSH sessions).
 
 Important for chat/UI turns: do not run this command just to let the user
-connect a managed provider. Render the first-class connect surface instead:
+connect a cloud provider. Render the first-class connect surface instead:
 call \`ui_show\` with surface_type "oauth_connect" and data.providerKey set to
-the provider (for example, "google"). That surface starts the managed OAuth UI
+the provider (for example, "google"). That surface starts the cloud OAuth UI
 and avoids pasting raw authorization links into the conversation. If the user
 needs non-default scopes, also pass data.requestedScopes as a full replacement
 set (list every scope the connection should keep, not just the new ones).
@@ -866,7 +866,7 @@ need direct access to the token (i.e. \`assistant oauth request\` is
 insufficient) and you are comfortable with the security implications.
 
 Token retrieval is only supported for providers with mode set to "your-own".
-Platform-managed providers handle tokens internally — use
+Cloud providers handle tokens internally — use
 'assistant oauth ping <provider>' to verify connectivity or
 'assistant oauth request --provider <provider> <url>' to make
 authenticated requests.
@@ -925,7 +925,7 @@ Environment variables (printed as \`export\` lines with --export):
 Use 'assistant oauth status <provider>' to find account identifiers for
 --account. Unlabeled connections can be selected by their connection ID.
 
-Managed connections forward Content-Type, Accept, User-Agent, and X-Request-Id.
+Cloud connections forward Content-Type, Accept, User-Agent, and X-Request-Id.
 Requests with unsupported headers, including If-Match and Idempotency-Key,
 are rejected before calling the provider. A connection using your own OAuth
 app can preserve those headers.

package/src/cli/commands/oauth/providers.ts

@@ -282,7 +282,7 @@ export function registerProviderCommands(oauth: Command): void {
     ) => {
       const queryParams: Record<string, string> = {};
       if (opts.supportsManaged) {
-        queryParams.supports_managed_mode = "true";
+        queryParams.supports_cloud_mode = "true";
       }
       const r = await cliIpcCall<{
         providers: Array<Record<string, unknown>>;
@@ -300,7 +300,7 @@ export function registerProviderCommands(oauth: Command): void {
         providerKey: p.provider_key as string,
         displayName: p.display_name as string | null,
         description: p.description as string | null,
-        supportsManagedMode: p.supports_managed_mode as boolean,
+        supportsManagedMode: p.supports_cloud_mode as boolean,
         managedServiceIsPaid: p.managed_service_is_paid as boolean,
         requiresClientSecret: p.requires_client_secret as boolean,
         logoUrl: p.logo_url as string | null,

package/src/cli/commands/oauth/shared.ts

@@ -15,7 +15,7 @@ import { writeOutput } from "../../output.js";
 
 /**
  * Verify that the user has connected to Cadet Cloud (has stored
- * credentials). Unlike `requirePlatformClient`, this does NOT require a
+ * credentials). Unlike `requireCloudClient`, this does NOT require a
  * platform assistant ID — it only checks that credentials exist.
  *
  * Writes an error and sets exitCode=1 when the user is not connected.
@@ -26,8 +26,8 @@ import { writeOutput } from "../../output.js";
 export async function requirePlatformConnection(
   cmd: Command,
 ): Promise<boolean> {
-  const { CadetPlatformClient } = await import("../../../platform/client.js");
-  const client = await CadetPlatformClient.create();
+  const { CadetCloudClient } = await import("../../../cloud/client.js");
+  const client = await CadetCloudClient.create();
   if (!client) {
     writeOutput(cmd, {
       ok: false,

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

@@ -184,8 +184,7 @@ Examples:
       options: [
         {
           flags: "--print",
-          description:
-            "Print the entry JSON without submitting to the platform",
+          description: "Print the entry JSON without submitting to the cloud",
         },
         {
           flags: "--path <dir>",
@@ -205,7 +204,7 @@ Examples:
 
 Validates the plugin in the current directory (or --path), resolves the
 git commit SHA and GitHub remote, and submits the entry to the Cadet
-platform API. The platform creates a pull request against
+platform API. The cloud creates a pull request against
 vargasjr-dev/mycadet adding the plugin to the marketplace catalog.
 
 Requires a connected Cadet Cloud account (run \`assistant cloud connect\`).

package/src/cli/commands/plugins.ts

@@ -112,8 +112,8 @@ const libs = {
       "pluginInstallPlatform",
       () =>
         loadModule(
-          "../lib/install-from-platform.js",
-        ) as typeof import("../lib/install-from-platform.js"),
+          "../lib/install-from-cloud.js",
+        ) as typeof import("../lib/install-from-cloud.js"),
     );
   },
   get installed() {
@@ -209,8 +209,8 @@ export function registerPluginsCommand(program: Command): void {
         ) => {
           try {
             const direct = looksLikeGitHubSpec(nameOrUrl);
-            // A plain marketplace install by name is platform-managed: the
-            // content flows through the platform install endpoint (which
+            // A plain marketplace install by name is cloud-managed: the
+            // content flows through the cloud install endpoint (which
             // serves a verified `.tgz`), not a GitHub clone. The advanced
             // pin/ref/allow-unreviewed selectors still resolve a specific
             // reviewed revision through the marketplace-git path, and a
@@ -236,7 +236,7 @@ export function registerPluginsCommand(program: Command): void {
               // self-hosted) there is no platform to call, so resolve the pin
               // from the bundled catalog and install through the GitHub path.
               const platformEnabled =
-                libs.catalogLocal.arePlatformFeaturesEnabled();
+                libs.catalogLocal.areCloudFeaturesEnabled();
               if (platformEnabled) {
                 if (!libs.catalogLocal.isPluginCatalogEntryVisible(nameOrUrl)) {
                   console.error(

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

@@ -14,7 +14,7 @@ Items, upvotes, and comments filed here are attributed to the assistant, not
 to its owner: the assistant signs these calls with its own platform API key.
 The owner's own roadmap identity lives on \`cadet roadmap\`.
 
-Reads work anonymously when the assistant is not connected to the platform
+Reads work anonymously when the assistant is not connected to the cloud
 (the "upvoted" marker is then blank). Every write needs the connection, so
 run \`assistant cloud connect\` first.
 

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

@@ -8,9 +8,9 @@ export const telemetryHelp: CliCommandHelp = {
   subcommands: [
     {
       name: "flush",
-      description: "Force-flush all pending telemetry events to the platform",
+      description: "Force-flush all pending telemetry events to the cloud",
       helpText: `
-Reports how many events reached the platform: 'sent' (POSTed), 'persisted'
+Reports how many events reached the cloud: 'sent' (POSTed), 'persisted'
 (confirmed written), and 'dropped' (sent - persisted — server-side drops plus
 events skipped at ingest validation). When nothing ships, prints why (e.g.
 nothing pending, opted out, not signed in).

package/src/cli/commands/telemetry.ts

@@ -15,7 +15,7 @@ function describeSkip(reason: string): string {
     case "opted-out":
       return "Telemetry flush skipped: analytics sharing is opted out.";
     case "no-credentials":
-      return "Telemetry flush skipped: not signed in to the platform yet.";
+      return "Telemetry flush skipped: not signed in to the cloud yet.";
     case "unknown-consent":
       return "Telemetry flush skipped: consent not yet resolved (will retry).";
     case "checkpoint-unavailable":
@@ -23,7 +23,7 @@ function describeSkip(reason: string): string {
     case "disabled":
       return "Telemetry flush skipped: telemetry is disabled.";
     case "post-failed":
-      return "Telemetry flush failed: the platform rejected the request.";
+      return "Telemetry flush failed: the cloud rejected the request.";
     default:
       return `Telemetry flush skipped: ${reason}`;
   }

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

@@ -92,7 +92,7 @@ Examples:
         {
           name: "[id...]",
           description:
-            "Voice/model id to set (joined with spaces). ElevenLabs voice id for elevenlabs; managed voice model id (ElevenLabs id or Deepgram Aura model like aura-2-thalia-en) for cadet; Aura model id for deepgram",
+            "Voice/model id to set (joined with spaces). ElevenLabs voice id for elevenlabs; cloud voice model id (ElevenLabs id or Deepgram Aura model like aura-2-thalia-en) for cadet; Aura model id for deepgram",
         },
       ],
       options: [
@@ -105,11 +105,11 @@ Examples:
       helpText: `
 Set the assistant's TTS voice on whichever provider is currently active
 (services.tts.provider). This writes to the config key that provider actually
-reads — e.g. services.tts.providers.cadet.model for managed speech — so the
+reads — e.g. services.tts.providers.cadet.model for cloud speech — so the
 change takes effect on the next spoken turn.
 
 Prefer this over 'assistant config set services.tts.providers.elevenlabs.voiceId'
-directly: on a managed (cadet) assistant that field is ignored, so the voice
+directly: on a cloud (cadet) assistant that field is ignored, so the voice
 would silently not change.
 
 Examples:

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

@@ -12,10 +12,10 @@ export const webhooksHelp: CliCommandHelp = {
 Resolves a stable callback URL that external services (Telegram, Twilio,
 email providers, OAuth) should use to reach this assistant.
 
-On platform-managed assistants, this registers a callback route with the
+On cloud assistants, this registers a callback route with the
 platform gateway. Otherwise it uses the configured ingress.publicBaseUrl,
-falling back to the platform gateway when no ingress is configured and the
-assistant is connected to the platform.
+falling back to the cloud gateway when no ingress is configured and the
+assistant is connected to the cloud.
 
 The webhook path is derived from the type: underscores become path
 separators, prefixed with webhooks/.
@@ -35,7 +35,7 @@ Examples:
       name: "register",
       args: "<type>",
       description:
-        "Get a callback URL for a webhook type, registering with the platform if needed",
+        "Get a callback URL for a webhook type, registering with the cloud if needed",
       options: [
         {
           flags: "--path <path>",
@@ -48,12 +48,12 @@ Examples:
         },
       ],
       helpText: `
-Resolves a callback URL for the given webhook type. On platform-managed
-assistants (IS_PLATFORM=true), registers a callback route with the platform
+Resolves a callback URL for the given webhook type. On cloud-managed
+assistants (IS_CLOUD=true), registers a callback route with the cloud
 gateway and returns the stable external URL. Otherwise it reads
 ingress.publicBaseUrl from config and appends the webhook path. That URL is
 either your own tunnel or the Tunnel URL the gateway publishes. If no
-ingress is configured and the assistant is connected to the platform
+ingress is configured and the assistant is connected to the cloud
 (via 'assistant cloud connect'), it registers a callback route with the
 platform gateway instead of failing.
 
@@ -84,9 +84,9 @@ Examples:
       name: "list",
       description: "List registered webhook callback routes",
       helpText: `
-Lists all webhook callback routes registered with the platform for this
+Lists all webhook callback routes registered with the cloud for this
 assistant. Only available when cloud credentials are configured (either
-via IS_PLATFORM or 'assistant cloud connect').
+via IS_CLOUD or 'assistant cloud connect').
 
 Self-hosted assistants without cloud credentials do not have a persistent
 webhook registry — use 'assistant webhooks register <type>' to resolve URLs

package/src/cli/commands/webhooks.ts

@@ -3,7 +3,7 @@
  *
  * Thin IPC wrapper that delegates webhook operations to the daemon.
  *
- * Platform-managed:  daemon registers a callback route and returns the platform URL.
+ * Platform-managed:  daemon registers a callback route and returns the cloud URL.
  * Self-hosted:       daemon resolves ingress.publicBaseUrl and appends the path.
  */
 

package/src/cli/lib/__tests__/inspect-plugin.test.ts

@@ -336,10 +336,10 @@ describe("inspectPlugin", () => {
   });
 
   test("previews an uninstalled bundled provider offline without fetching GitHub", async () => {
-    const savedDisablePlatform = process.env.CADET_DISABLE_PLATFORM;
-    const savedIsPlatform = process.env.IS_PLATFORM;
-    process.env.CADET_DISABLE_PLATFORM = "true";
-    delete process.env.IS_PLATFORM;
+    const savedDisablePlatform = process.env.CADET_DISABLE_CLOUD;
+    const savedIsPlatform = process.env.IS_CLOUD;
+    process.env.CADET_DISABLE_CLOUD = "true";
+    delete process.env.IS_CLOUD;
     let fetchCalls = 0;
     const fetch = (async () => {
       fetchCalls += 1;
@@ -376,14 +376,14 @@ describe("inspectPlugin", () => {
       expect(fetchCalls).toBe(0);
     } finally {
       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;
       }
     }
   });