@mycadet/assistant 0.12.7 → 0.12.9

package/src/runtime/routes/webhook-routes.ts

@@ -6,18 +6,18 @@
  *     for a webhook type. See `handleWebhooksRegister` for the resolution
  *     order.
  *   - webhooks_list (GET webhooks): List all webhook callback routes registered
- *     with the platform for this assistant.
+ *     with the cloud for this assistant.
  */
 
 import { z } from "zod";
 
-import { getIsPlatform } from "../../config/env-registry.js";
+import { getIsCloud } from "../../config/env-registry.js";
 import { getConfig } from "../../config/loader.js";
 import {
   registerCallbackRoute,
   registerLocalWebhookRoute,
-  resolvePlatformCallbackRegistrationContext,
-} from "../../inbound/platform-callback-registration.js";
+  resolveCloudCallbackRegistrationContext,
+} from "../../inbound/cloud-callback-registration.js";
 import { resolveClaimedPodWebhookUrl } from "../../inbound/pod-webhook-claim.js";
 import {
   getPublicBaseUrl,
@@ -83,7 +83,7 @@ function deriveWebhookPath(type: string): string {
 }
 
 /**
- * Register `webhookPath` with the platform gateway, mapping failures onto the
+ * Register `webhookPath` with the cloud gateway, mapping failures onto the
  * route error vocabulary.
  */
 async function registerWithPlatform(
@@ -112,8 +112,8 @@ async function registerWithPlatform(
  * Resolve a stable callback URL for a webhook type.
  *
  * Resolution order:
- *   1. **Platform pods** (`IS_PLATFORM`) with the `tunnel-webhooks` flag off
- *      always register with the platform gateway. With the flag on, the
+ *   1. **Cloud pods** (`IS_CLOUD`) with the `tunnel-webhooks` flag off
+ *      always register with the cloud gateway. With the flag on, the
  *      Tunnel-published `ingress.publicBaseUrl` wins and platform
  *      registration is the fallback for any failure to resolve it —
  *      including an explicit `ingress.enabled: false`, matching
@@ -127,12 +127,12 @@ async function registerWithPlatform(
  *   3. **Platform-connected assistants with no ingress** register with the
  *      platform gateway rather than failing. Connectivity is decided by
  *      credentials (platform base URL + assistant ID + assistant API key), not
- *      by `IS_PLATFORM`, which is only ever true on a platform pod.
+ *      by `IS_CLOUD`, which is only ever true on a cloud pod.
  *
  * Ingress deliberately precedes platform registration: any logged-in local
  * assistant holds cloud credentials (it needs them for the LLM proxy), so
  * treating credential presence as "managed" would silently reroute an
- * explicitly configured self-hosted webhook through the platform. The gateway's
+ * explicitly configured self-hosted webhook through the cloud. The gateway's
  * Telegram and email registrars order the same two tiers the same way.
  */
 async function handleWebhooksRegister(
@@ -148,7 +148,7 @@ async function handleWebhooksRegister(
     (pathOverride as string | undefined) ?? deriveWebhookPath(type as string);
   const sourceIdentifier = source as string | undefined;
 
-  if (getIsPlatform()) {
+  if (getIsCloud()) {
     if (isTunnelWebhooksEnabled()) {
       const callbackUrl = await resolveClaimedPodWebhookUrl(
         () => `${getPublicBaseUrl(getConfig())}/${webhookPath}`,
@@ -186,9 +186,9 @@ async function handleWebhooksRegister(
     ingressError = err as Error;
   }
 
-  // No ingress configured. Fall back to the platform gateway when this
-  // assistant is connected to the platform.
-  const context = await resolvePlatformCallbackRegistrationContext();
+  // No ingress configured. Fall back to the cloud gateway when this
+  // assistant is connected to the cloud.
+  const context = await resolveCloudCallbackRegistrationContext();
   if (context.enabled) {
     return registerWithPlatform(webhookPath, type, sourceIdentifier);
   }
@@ -199,15 +199,15 @@ async function handleWebhooksRegister(
 async function handleWebhooksList(
   _args: RouteHandlerArgs,
 ): Promise<WebhooksListResponse> {
-  const context = await resolvePlatformCallbackRegistrationContext();
+  const context = await resolveCloudCallbackRegistrationContext();
 
-  if (!context.platformBaseUrl || !context.authHeader) {
+  if (!context.cloudBaseUrl || !context.authHeader) {
     throw new UnprocessableEntityError(
       "Self-hosted webhook listing is not available. Use 'assistant webhooks register <type>' to resolve URLs on demand.",
     );
   }
 
-  const url = `${context.platformBaseUrl}/v1/internal/gateway/callback-routes/`;
+  const url = `${context.cloudBaseUrl}/v1/internal/gateway/callback-routes/`;
   let response: Response;
   try {
     response = await fetch(url, {
@@ -258,7 +258,7 @@ export const ROUTES: RouteDefinition[] = [
     },
     summary: "Register a webhook callback URL",
     description:
-      "Resolves a stable callback URL for a webhook type. On platform-managed assistants, registers the route with the platform gateway. Otherwise uses the configured ingress.publicBaseUrl, falling back to the platform gateway when no ingress is configured and the assistant is connected to the platform.",
+      "Resolves a stable callback URL for a webhook type. On cloud assistants, registers the route with the cloud gateway. Otherwise uses the configured ingress.publicBaseUrl, falling back to the cloud gateway when no ingress is configured and the assistant is connected to the cloud.",
     tags: ["webhooks"],
     requestBody: WebhooksRegisterRequestSchema,
     responseBody: WebhooksRegisterResponseSchema,
@@ -274,7 +274,7 @@ export const ROUTES: RouteDefinition[] = [
     },
     summary: "List registered webhook callback routes",
     description:
-      "Lists all webhook callback routes registered with the platform for this assistant.",
+      "Lists all webhook callback routes registered with the cloud for this assistant.",
     tags: ["webhooks"],
     responseBody: WebhooksListResponseSchema,
     handler: handleWebhooksList,

package/src/runtime/routes/workflow-routes.ts

@@ -3,8 +3,8 @@
  *
  * All routes are served by both the HTTP server and the IPC server via the
  * shared ROUTES array. They are read/abort surfaces over the workflow run
- * manager and the saved-workflow library — a human (via the `cadet workflows`
- * CLI or the app) can inspect runs and abort an in-flight one.
+ * manager and the saved-workflow library — a human (via the app) can inspect
+ * runs and abort an in-flight one.
  */
 
 import { z } from "zod";
@@ -334,9 +334,9 @@ async function handleResumeRun(id: string) {
   // the side-effecting tools/host functions the original manifest granted. The
   // conversational `manage_workflows` resume path promotes such resumes to a
   // fresh interactive approval (executor.ts → requireFreshApproval); this
-  // HTTP/IPC route (and the `cadet workflows resume` CLI on top of it) has no
-  // prompt channel. At full-access posture the user has opted into
-  // auto-approving even high-risk tools, so the resume proceeds without a
+  // HTTP/IPC route has no prompt channel. At full-access posture the user has
+  // opted into auto-approving even high-risk tools, so the resume proceeds
+  // without a
   // prompt; otherwise it must not silently bypass consent — refuse and direct
   // the caller to the assistant. A read-only run (no declared tools/host
   // functions) resumes freely regardless of posture.

package/src/runtime/sync/resource-sync-events.ts

@@ -1,4 +1,4 @@
-import { syncAvatarToPlatform } from "../../avatar/sync-avatar.js";
+import { syncAvatarToCloud } from "../../avatar/sync-avatar.js";
 import type { IdentityFields } from "../../daemon/handlers/identity.js";
 import {
   conversationMessagesSyncTag,
@@ -34,7 +34,7 @@ export function publishAvatarChanged(originClientId?: string): void {
     avatarPath: getAvatarImagePath(),
   });
   void publishSyncInvalidation([SYNC_TAGS.assistantAvatar], originClientId);
-  syncAvatarToPlatform();
+  syncAvatarToCloud();
 }
 
 export function publishIdentityChanged(

package/src/runtime/verification-outbound-actions.ts

@@ -555,7 +555,7 @@ export function deliverVerificationDiscord(
 // ---------------------------------------------------------------------------
 
 /**
- * Deliver a verification email via the platform email send API.
+ * Deliver a verification email via the cloud email send API.
  * Fire-and-forget wrapper for use in the daemon process (HTTP route handlers).
  */
 export function deliverVerificationEmail(
@@ -566,9 +566,9 @@ export function deliverVerificationEmail(
 ): void {
   (async () => {
     try {
-      const { CadetPlatformClient } = await import("../platform/client.js");
-      const client = await CadetPlatformClient.create();
-      if (!client?.platformAssistantId) {
+      const { CadetCloudClient } = await import("../cloud/client.js");
+      const client = await CadetCloudClient.create();
+      if (!client?.cloudAssistantId) {
         log.error(
           "Cannot deliver verification email: platform client not configured",
         );

package/src/schedule/integration-status.ts

@@ -14,7 +14,7 @@ export async function isOAuthProviderConnected(
   provider: string,
 ): Promise<boolean> {
   const providerRow = getProvider(provider);
-  const managedKey = providerRow?.managedServiceConfigKey;
+  const managedKey = providerRow?.cloudServiceConfigKey;
 
   if (managedKey) {
     try {
@@ -39,16 +39,16 @@ export async function isOAuthProviderConnected(
 }
 
 /**
- * Check the platform for active connections for a managed provider.
+ * Check the cloud for active connections for a cloud provider.
  * Returns false on any error (network, auth, etc.) rather than throwing.
  */
 async function isProviderConnectedOnPlatform(
   provider: string,
 ): Promise<boolean> {
   try {
-    const { CadetPlatformClient } = await import("../platform/client.js");
-    const client = await CadetPlatformClient.create();
-    if (!client?.platformAssistantId) {
+    const { CadetCloudClient } = await import("../cloud/client.js");
+    const client = await CadetCloudClient.create();
+    if (!client?.cloudAssistantId) {
       return false;
     }
 
@@ -56,7 +56,7 @@ async function isProviderConnectedOnPlatform(
     params.set("provider", provider);
     params.set("status", "ACTIVE");
 
-    const path = `/v1/assistants/${encodeURIComponent(client.platformAssistantId)}/oauth/connections/?${params.toString()}`;
+    const path = `/v1/assistants/${encodeURIComponent(client.cloudAssistantId)}/oauth/connections/?${params.toString()}`;
     const response = await client.fetch(path);
 
     if (!response.ok) {

package/src/schedule/run-script.ts

@@ -40,7 +40,7 @@ export interface ScriptResult {
 /**
  * Run a shell command and capture its output.
  *
- * Uses the platform shell so the command string supports pipes, redirects,
+ * Uses the cloud shell so the command string supports pipes, redirects,
  * and shell builtins. Windows uses PowerShell and POSIX hosts use Bash. Output
  * is truncated to {@link MAX_OUTPUT_BYTES} to keep schedule_runs rows bounded.
  *

package/src/schedule/schedule-timezone.ts

@@ -66,7 +66,7 @@ export function resolveScheduleTimezone(
  * Wall-clock hour (0-23) of `now` in `timeZone`.
  *
  * Heartbeat active hours are stored as 0-23 integers. Evaluating them against
- * the host clock (UTC on a managed container) shifts the window by the user's
+ * the host clock (UTC on a cloud container) shifts the window by the user's
  * offset, so 8:00-22:00 becomes 1am-3pm Pacific. This reads the hour in the
  * same zone `resolveScheduleTimezone` selected.
  */

package/src/schedule/worker.ts

@@ -17,8 +17,8 @@ import {
   initFeatureFlagOverrides,
   refreshOverridesFromGateway,
 } from "../config/assistant-feature-flags.js";
+import { rehydrateCloudCredentials } from "../config/cloud-rehydration.js";
 import { getConfig } from "../config/loader.js";
-import { rehydratePlatformCredentials } from "../config/platform-rehydration.js";
 import { startConversationEvictor } from "../daemon/conversation-evictor.js";
 import { stopMcpServerManager } from "../mcp/manager.js";
 import { MCP_RELOAD_SIGNAL_FILE } from "../mcp/reload-signal.js";
@@ -139,13 +139,13 @@ async function main(): Promise<void> {
     );
   }
 
-  // Rehydrate the platform base URL and IDs from the credential store before
+  // Rehydrate the cloud base URL and IDs from the credential store before
   // the first tick. The daemon does this in initializeProvidersAndTools(); this
-  // standalone process must do it itself so getPlatformBaseUrl() resolves to
+  // standalone process must do it itself so getCloudBaseUrl() resolves to
   // the persisted platform environment instead of the CADET_ENVIRONMENT
   // default — otherwise valid credentials are sent to the wrong platform and
   // rejected for both inference and background-wake requests.
-  await rehydratePlatformCredentials();
+  await rehydrateCloudCredentials();
 
   // This process is the sole runner of schedule execution and hosts real agent
   // conversations (wake, execute, and workflow modes), so it needs the default
@@ -264,7 +264,7 @@ async function main(): Promise<void> {
 
   // This process outlives any single flag value, so poll the gateway instead of
   // holding whatever was cached at startup. The daemon's gateway flag listener
-  // is not reusable here: it also reconciles managed profiles and broadcasts
+  // is not reusable here: it also reconciles cloud profiles and broadcasts
   // sync events, both of which belong to the daemon alone. The refresh swaps the
   // cache atomically, so a tick reading a flag mid-refresh still sees the last
   // known values. Unref'd so the tick interval above stays the one thing

package/src/security/auth-fallback-events-store.ts

@@ -1,6 +1,6 @@
 import { v4 as uuid } from "uuid";
 
-import { getRawShareAnalytics } from "../platform/consent-cache.js";
+import { getRawShareAnalytics } from "../cloud/consent-cache.js";
 import { insertTelemetryOutboxEvents } from "../telemetry/telemetry-events-outbox.js";
 import type { AuthFallbackTelemetryEvent } from "../telemetry/types.js";
 import { APP_VERSION } from "../version.js";

package/src/security/oauth2.ts

@@ -19,7 +19,7 @@
 import { createHash, randomBytes } from "node:crypto";
 import { createServer, type Server } from "node:http";
 
-import { getIsPlatform } from "../config/env-registry.js";
+import { getIsCloud } from "../config/env-registry.js";
 import { parseScopeList } from "../oauth/scope-utils.js";
 import { getLogger } from "../util/logger.js";
 import { renderOAuthCompletionPage as renderLoopbackPage } from "./oauth-completion-page.js";
@@ -791,9 +791,9 @@ export async function startOAuth2Flow(
     // No public URL configured
   }
 
-  // When containerized with a platform, callback routes are registered
-  // through the platform gateway — treat as having a public URL.
-  if (!hasPublicUrl && getIsPlatform()) {
+  // When containerized with a cloud, callback routes are registered
+  // through the cloud gateway — treat as having a public URL.
+  if (!hasPublicUrl && getIsCloud()) {
     hasPublicUrl = true;
   }
 

package/src/skills/available-skills.ts

@@ -1,10 +1,10 @@
 import { getConfig } from "../config/loader.js";
 import type { SkillSource } from "../config/skills.js";
-import type { SkillInstallMeta } from "./install-meta.js";
 import {
-  isSkillCompatibleWithPlatform,
+  isSkillCompatibleWithCloud,
   type SkillPlatform,
-} from "./platform-compatibility.js";
+} from "./cloud-compatibility.js";
+import type { SkillInstallMeta } from "./install-meta.js";
 
 /**
  * Plugin-facing read API over the skill surface: the locally installed
@@ -128,7 +128,7 @@ export async function listCatalogSkills(): Promise<ResolvedSkillEntry[]> {
       typeof flagKey === "string" &&
       flagKey.length > 0 &&
       !isAssistantFeatureFlagEnabled(flagKey, config);
-    const incompatible = !isSkillCompatibleWithPlatform(entry);
+    const incompatible = !isSkillCompatibleWithCloud(entry);
     return {
       id: entry.id,
       displayName: entry.metadata?.cadet?.["display-name"] ?? entry.name,

package/src/skills/catalog-files.ts

@@ -10,7 +10,7 @@
  *   - In `CADET_DEV` mode, when `<repo>/skills/<id>/` exists on disk, we
  *     read the skill files directly from the repo checkout (matching the
  *     behavior of `getCatalog()` in dev).
- *   - Otherwise, we call the platform preview endpoints:
+ *   - Otherwise, we call the cloud preview endpoints:
  *       GET /v1/skills/{skill_id}/files/
  *       GET /v1/skills/{skill_id}/files/content/?path=...
  *
@@ -28,7 +28,7 @@ import {
 } from "node:fs";
 import { basename, join, posix, sep } from "node:path";
 
-import { getPlatformBaseUrl } from "../config/env.js";
+import { getCloudBaseUrl } from "../config/env.js";
 import type { SlimSkillResponse } from "../daemon/message-types/skills.js";
 import {
   isTextMimeType as isTextMime,
@@ -69,9 +69,9 @@ export type { SkillFileEntry } from "./skill-file-types.js";
 
 // ─── Platform response contracts ─────────────────────────────────────────────
 //
-// The platform preview API uses snake_case on the wire. We map to the
+// The cloud preview API uses snake_case on the wire. We map to the
 // daemon's camelCase shape inside this module so nothing downstream needs to
-// know about the platform contract.
+// know about the cloud contract.
 
 interface PlatformFileListResponse {
   skill_id: string;
@@ -101,7 +101,7 @@ interface PlatformFileContentResponse {
  *   - Reject paths that escape the root (normalized result equals `..` or
  *     begins with `../`).
  *
- * The platform also validates these server-side; client-side sanitization is
+ * The cloud also validates these server-side; client-side sanitization is
  * defense in depth and short-circuits obvious bad requests before a network
  * round trip.
  */
@@ -164,7 +164,7 @@ type CatalogSource =
 /**
  * Resolve where to read files for a given catalog skill id. Performs NO
  * network calls — network requests happen only inside `readCatalogSkillFiles`
- * and `readCatalogSkillFileContent` on the platform path.
+ * and `readCatalogSkillFileContent` on the cloud path.
  *
  * Dev-mode safety: when a `<repoSkillsDir>/<skillId>` entry exists on disk,
  * we verify that the skill root is a real directory physically located
@@ -246,7 +246,7 @@ function isSafeDevSkillRoot(candidate: string, repoSkillsDir: string): boolean {
 // ─── Platform fetch helper ───────────────────────────────────────────────────
 
 /**
- * Fetch JSON from the platform preview API. Returns `null` on any failure
+ * Fetch JSON from the cloud preview API. Returns `null` on any failure
  * (non-2xx, network error, abort). The query string is stripped from log
  * messages to avoid leaking user-supplied file paths.
  */
@@ -254,7 +254,7 @@ async function fetchPlatformJson<T>(
   path: string,
   query?: Record<string, string>,
 ): Promise<T | null> {
-  const base = getPlatformBaseUrl();
+  const base = getCloudBaseUrl();
   const url = new URL(`${base}${path}`);
   if (query) {
     const params = new URLSearchParams(query);

package/src/skills/catalog-install.ts

@@ -20,19 +20,19 @@ import {
   MALFORMED_USTAR_SIZE,
   parseUstarSizeField,
 } from "../archive/ustar-size.js";
-import { getPlatformBaseUrl } from "../config/env.js";
+import { getCloudBaseUrl } from "../config/env.js";
 import { loadSkillCatalog } from "../config/skills.js";
 import { isBunVirtualPath } from "../util/bundled-asset.js";
 import { getLogger } from "../util/logger.js";
 import { addToPathEnv, getWorkspaceSkillsDir } from "../util/platform.js";
-import { computeSkillHash, writeInstallMeta } from "./install-meta.js";
 import {
-  isSkillCompatibleWithPlatform,
+  isSkillCompatibleWithCloud,
   normalizeSkillPlatforms,
   SKILL_PLATFORM_VALUES,
   type SkillPlatform,
   skillPlatformUnavailableMessage,
-} from "./platform-compatibility.js";
+} from "./cloud-compatibility.js";
+import { computeSkillHash, writeInstallMeta } from "./install-meta.js";
 
 const log = getLogger("catalog-install");
 
@@ -139,7 +139,7 @@ export function getRepoSkillsDir(): string | undefined {
 // ─── Catalog operations ──────────────────────────────────────────────────────
 
 /**
- * Raw skill entry as returned by the platform `/v1/skills/` API. The platform
+ * Raw skill entry as returned by the cloud `/v1/skills/` API. The cloud
  * serializer flattens the skill's metadata into top-level fields
  * (`category`, `display_name`, `icon`) rather than the nested
  * `metadata.cadet.*` shape used by the local `catalog.json`. Both shapes are
@@ -191,9 +191,9 @@ function asStr(value: unknown): string | undefined {
 }
 
 /**
- * Normalize a platform API entry into a canonical {@link CatalogSkill}.
+ * Normalize a cloud API entry into a canonical {@link CatalogSkill}.
  *
- * The platform flattens `category`, `display_name`, and `icon` to the top
+ * The cloud flattens `category`, `display_name`, and `icon` to the top
  * level, so re-nest them under `metadata.cadet` to match the local catalog
  * shape that the rest of the daemon reads (`metadata.cadet.category`,
  * `metadata.cadet["display-name"]`). Existing nested values take precedence
@@ -244,8 +244,8 @@ function normalizeCatalogEntry(raw: unknown): CatalogSkill | null {
 }
 
 export async function fetchCatalog(): Promise<CatalogSkill[]> {
-  const platformUrl = getPlatformBaseUrl();
-  const url = `${platformUrl}/v1/skills/`;
+  const cloudUrl = getCloudBaseUrl();
+  const url = `${cloudUrl}/v1/skills/`;
   const response = await fetch(url, {
     signal: AbortSignal.timeout(10000),
   });
@@ -398,8 +398,8 @@ async function fetchAndExtractSkill(
   skillId: string,
   destDir: string,
 ): Promise<void> {
-  const platformUrl = getPlatformBaseUrl();
-  const url = `${platformUrl}/v1/skills/${encodeURIComponent(skillId)}/`;
+  const cloudUrl = getCloudBaseUrl();
+  const url = `${cloudUrl}/v1/skills/${encodeURIComponent(skillId)}/`;
   const response = await fetch(url, {
     signal: AbortSignal.timeout(15000),
   });
@@ -721,7 +721,7 @@ export async function autoInstallFromCatalog(
   if (!entry) {
     return false;
   }
-  if (!isSkillCompatibleWithPlatform(entry)) {
+  if (!isSkillCompatibleWithCloud(entry)) {
     throw new Error(skillPlatformUnavailableMessage(skillId, entry));
   }
 

package/src/skills/categories-cache.ts

@@ -3,7 +3,7 @@ import { join } from "node:path";
 
 import { parse as parseYaml } from "yaml";
 
-import { getPlatformBaseUrl } from "../config/env.js";
+import { getCloudBaseUrl } from "../config/env.js";
 import { getLogger } from "../util/logger.js";
 import { getRepoSkillsDir } from "./catalog-install.js";
 
@@ -21,8 +21,8 @@ let cachedCategories: SkillCategoryDef[] | null = null;
 let cacheTimestamp = 0;
 
 async function fetchCategories(): Promise<SkillCategoryDef[]> {
-  const platformUrl = getPlatformBaseUrl();
-  const url = `${platformUrl}/v1/skills/categories/`;
+  const cloudUrl = getCloudBaseUrl();
+  const url = `${cloudUrl}/v1/skills/categories/`;
   const response = await fetch(url, {
     signal: AbortSignal.timeout(10000),
   });

package/src/skills/clawhub.ts

@@ -12,7 +12,7 @@ import {
 const log = getLogger("clawhub");
 
 // ClaWHub project root — clawhub creates a `skills/` subdir inside its cwd,
-// so we use the parent of the managed skills dir as the project root.
+// so we use the parent of the cloud skills dir as the project root.
 function getClawhubProjectRoot(): string {
   return dirname(getWorkspaceSkillsDir());
 }

package/src/skills/{platform-compatibility.test.ts → cloud-compatibility.test.ts}

@@ -2,10 +2,10 @@ import { describe, expect, test } from "bun:test";
 
 import {
   filterSkillsByPlatform,
-  isSkillCompatibleWithPlatform,
+  isSkillCompatibleWithCloud,
   normalizeSkillPlatforms,
   skillPlatformForNodePlatform,
-} from "./platform-compatibility.js";
+} from "./cloud-compatibility.js";
 
 describe("skill platform compatibility", () => {
   test("maps Node platforms to skill platform names", () => {
@@ -16,15 +16,15 @@ describe("skill platform compatibility", () => {
   });
 
   test("treats missing platform metadata as portable", () => {
-    expect(isSkillCompatibleWithPlatform({}, "win32")).toBe(true);
-    expect(isSkillCompatibleWithPlatform({}, "linux")).toBe(true);
+    expect(isSkillCompatibleWithCloud({}, "win32")).toBe(true);
+    expect(isSkillCompatibleWithCloud({}, "linux")).toBe(true);
   });
 
   test("matches declared host platforms", () => {
     const skill = { platforms: ["macos", "linux"] as const };
-    expect(isSkillCompatibleWithPlatform(skill, "darwin")).toBe(true);
-    expect(isSkillCompatibleWithPlatform(skill, "linux")).toBe(true);
-    expect(isSkillCompatibleWithPlatform(skill, "win32")).toBe(false);
+    expect(isSkillCompatibleWithCloud(skill, "darwin")).toBe(true);
+    expect(isSkillCompatibleWithCloud(skill, "linux")).toBe(true);
+    expect(isSkillCompatibleWithCloud(skill, "win32")).toBe(false);
   });
 
   test("filters incompatible skills from offer surfaces", () => {

package/src/skills/{platform-compatibility.ts → cloud-compatibility.ts}

@@ -37,7 +37,7 @@ export function skillPlatformForNodePlatform(
   return null;
 }
 
-export function isSkillCompatibleWithPlatform(
+export function isSkillCompatibleWithCloud(
   skill: PlatformScopedSkill,
   platform: NodeJS.Platform = process.platform,
 ): boolean {
@@ -52,9 +52,7 @@ export function filterSkillsByPlatform<T extends PlatformScopedSkill>(
   skills: readonly T[],
   platform: NodeJS.Platform = process.platform,
 ): T[] {
-  return skills.filter((skill) =>
-    isSkillCompatibleWithPlatform(skill, platform),
-  );
+  return skills.filter((skill) => isSkillCompatibleWithCloud(skill, platform));
 }
 
 export function skillPlatformUnavailableMessage(