@mycadet/assistant 0.12.7 → 0.12.9

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__/callback-routes-list.test.ts

@@ -66,7 +66,7 @@ describe("assistant cloud callback-routes list", () => {
     expect((thrown as Error).message).toBe("exitFromIpcResult called");
   });
 
-  test("callback-routes register calls platform_callback_routes_register", async () => {
+  test("callback-routes register calls cloud_callback_routes_register", async () => {
     ipc.response = {
       ok: true,
       result: {
@@ -87,7 +87,7 @@ describe("assistant cloud callback-routes list", () => {
       "--json",
     ]);
 
-    expect(ipc.calls[0][0]).toBe("platform_callback_routes_register");
+    expect(ipc.calls[0][0]).toBe("cloud_callback_routes_register");
     expect((ipc.calls[0][1].body as Record<string, unknown>).path).toBe(
       "webhooks/telegram",
     );

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