convex 1.40.0 → 1.41.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "convex",
   "description": "Client for the Convex Cloud",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "author": "Convex, Inc. <no-reply@convex.dev>",
   "homepage": "https://convex.dev",
   "repository": {
@@ -199,6 +199,7 @@
   ],
   "devDependencies": {
     "@auth0/auth0-react": "2.15.1",
+    "@babel/code-frame": "^7.27.1",
     "@babel/parser": "^7.27.1",
     "@babel/types": "^7.27.1",
     "@clerk/react": "^6.4.3",
@@ -214,6 +215,7 @@
     "@swc/core": "1.15.8",
     "@testing-library/react": "~16.3.0",
     "@types/adm-zip": "^0.5.7",
+    "@types/babel__code-frame": "^7.0.6",
     "@types/deep-equal": "1.0.4",
     "@inquirer/confirm": "^6.0.4",
     "@inquirer/input": "^5.0.4",
@@ -269,7 +271,7 @@
     "typedoc": "^0.24.6",
     "typescript": "~5.0.3",
     "typescript-eslint": "~8.57.0",
-    "vitest": "^3.2.4",
+    "vitest": "^4.1.0",
     "undici": "7.24.0",
     "wait-for-expect": "~4.0.0",
     "zod": "^3.24.0",

package/src/browser/sync/request_manager.test.ts

@@ -5,10 +5,10 @@ import { ActionRequest, MutationRequest } from "./protocol.js";
 import { instantiateDefaultLogger } from "../logging.js";
 
 let requestManager: RequestManager;
-let markConnectionStateDirty: ReturnType<typeof vi.fn>;
+let markConnectionStateDirty: ReturnType<typeof vi.fn<() => void>>;
 
 beforeEach(() => {
-  markConnectionStateDirty = vi.fn();
+  markConnectionStateDirty = vi.fn<() => void>();
   requestManager = new RequestManager(
     instantiateDefaultLogger({ verbose: false }),
     markConnectionStateDirty,

package/src/cli/aiFiles.ts

@@ -68,7 +68,7 @@ const aiUpdate = new Command("update")
       "  - convex/_generated/ai/guidelines.md\n" +
       "  - AGENTS.md (Convex section only)\n" +
       "  - CLAUDE.md (Convex section only)\n" +
-      "  - Agent skills (installed to each coding agent's native path, configured via convex.json)\n\n",
+      "  - Agent skills (installed to each coding agent's native path, configured via convex.json)",
   )
   .allowExcessArguments(false)
   .action(async () => {
@@ -130,7 +130,7 @@ const aiRemove = new Command("remove")
     "Removes the following:\n" +
       "  - convex/_generated/ai/ directory (guidelines.md, ai-files.state.json)\n" +
       "  - Convex sections from AGENTS.md and CLAUDE.md\n" +
-      "  - Agent skills installed by `convex ai-files install`\n\n" +
+      "  - Agent skills installed by `npx convex ai-files install`\n\n" +
       "If removing the managed section leaves AGENTS.md or CLAUDE.md empty, the\n" +
       "empty file is deleted. Otherwise the rest of the file is kept.\n\n" +
       "Skills installed from other sources are not affected.\n\n" +

package/src/cli/configure.ts

@@ -93,9 +93,10 @@ type ConfigureCmdOptions = {
 /**
  * As of writing, this is used by:
  * - `npx convex dev`
- * - `npx convex codegen`
+ * - `npx convex init`
  *
- * But is not used by `npx convex deploy` or other commands.
+ * But is not used by `npx convex deploy`, `npx convex codegen`,
+ * `npx convex env`, or other commands.
  */
 export async function deploymentCredentialsOrConfigure(
   ctx: Context,
@@ -692,10 +693,7 @@ async function ensureDeploymentProvisioned(
           },
           options.deploymentOptions.kind,
         );
-      return {
-        ...credentials,
-        onActivity: null,
-      };
+      return credentials;
     }
     case "local": {
       const credentials = await handleLocalDeployment(ctx, {

package/src/cli/convexExport.ts

@@ -13,9 +13,9 @@ export const convexExport = new Command("export")
     [
       "Export data, and optionally file storage, from your Convex deployment to a ZIP file.",
       "",
-      "- Export to a directory: `npx convex export --path dir/`",
-      "- Export to a ZIP file: `npx convex export --path snapshot.zip`",
-      "- Include file storage: `npx convex export --include-file-storage --path dir/`",
+      "• Export to a directory: `npx convex export --path dir/`",
+      "• Export to a ZIP file: `npx convex export --path snapshot.zip`",
+      "• Include file storage: `npx convex export --include-file-storage --path dir/`",
       "",
       "By default, this exports from your dev deployment.",
       "",

package/src/cli/convexImport.ts

@@ -14,8 +14,8 @@ export const convexImport = new Command("import")
     [
       "Import data from a file to your Convex deployment.",
       "",
-      "- From a snapshot: `npx convex import snapshot.zip`",
-      "- For a single table: `npx convex import --table tableName file.json`",
+      "• From a snapshot: `npx convex import snapshot.zip`",
+      "• For a single table: `npx convex import --table tableName file.json`",
       "",
       "By default, this imports into your dev deployment.",
       "",

package/src/cli/dashboard.ts

@@ -6,7 +6,6 @@ import { logMessage, logOutput, logWarning } from "../bundler/log.js";
 import { loadSelectedDeploymentCredentials } from "./lib/api.js";
 import { actionDescription } from "./lib/command.js";
 import { getDeploymentSelection } from "./lib/deploymentSelection.js";
-import { checkIfDashboardIsRunning } from "./lib/localDeployment/dashboard.js";
 import { DASHBOARD_HOST, getDashboardUrl } from "./lib/dashboard.js";
 import { isAnonymousDeployment } from "./lib/deployment.js";
 
@@ -45,8 +44,15 @@ export const dashboard = new Command("dashboard")
         logWarning(warningMessage);
         return;
       }
-      const isLocalDashboardRunning = await checkIfDashboardIsRunning(ctx);
-      if (!isLocalDashboardRunning) {
+      // The anonymous-mode dashboard is a separate local HTTP server; confirm
+      // it's actually serving by hitting its API rather than inferring from the
+      // backend.
+      if (
+        !(await isAnonymousDashboardRunning(
+          dashboardUrl,
+          deployment.deploymentFields.deploymentName,
+        ))
+      ) {
         logWarning(warningMessage);
         return;
       }
@@ -57,6 +63,26 @@ export const dashboard = new Command("dashboard")
     await logOrOpenUrl(ctx, dashboardUrl ?? DASHBOARD_HOST, options.open);
   });
 
+async function isAnonymousDashboardRunning(
+  dashboardUrl: string,
+  deploymentName: string,
+): Promise<boolean> {
+  try {
+    // `dashboardUrl` ends with a trailing slash.
+    const resp = await fetch(`${dashboardUrl}api/current_deployment`);
+    if (resp.status !== 200) {
+      return false;
+    }
+    // The dashboard port is stored per deployment but can be reused by a
+    // different anonymous dev session, so confirm this dashboard is actually
+    // serving the selected deployment.
+    const currentDeployment = (await resp.json()) as { name?: unknown };
+    return currentDeployment.name === deploymentName;
+  } catch {
+    return false;
+  }
+}
+
 async function logOrOpenUrl(ctx: Context, url: string, shouldOpen: boolean) {
   if (shouldOpen) {
     logMessage(chalkStderr.gray(`Opening ${url} in the default browser...`));

package/src/cli/data.ts

@@ -12,8 +12,8 @@ export const data = new Command("data")
     [
       "Inspect your Convex deployment's database.",
       "",
-      "- List tables: `npx convex data`",
-      "- List documents in a table: `npx convex data tableName`",
+      "• List tables: `npx convex data`",
+      "• List documents in a table: `npx convex data tableName`",
       "",
       "By default, this inspects your dev deployment.",
       "",

package/src/cli/deploy.ts

@@ -42,11 +42,11 @@ export const deploy = new Command("deploy")
       "This is typically used for deploying to a prod or preview deployment manually or from CI; to deploy to your dev deployment when developing, use `npx convex dev`.",
       "",
       "The target deployment is chosen like this:",
-      `- If the \`${CONVEX_DEPLOYMENT_ENV_VAR_NAME}\` environment variable is set (typical during local development), the target is the project’s default production deployment.`,
-      `- If the \`${CONVEX_DEPLOY_KEY_ENV_VAR_NAME}\` environment variable is set (typical in CI), it is the deployment associated with that key.`,
-      `  - When it’s set to a preview deploy key, it will deploy to a preview deployment:`,
-      `    - with the name of the current Git branch when running in CI (Vercel, Netlify, Cloudflare Pages, GitHub)`,
-      `    - or with the name specified by the \`--preview-name\` or \`--preview-create\` flags`,
+      `• If the \`${CONVEX_DEPLOYMENT_ENV_VAR_NAME}\` environment variable is set (typical during local development), the target is the project’s default production deployment.`,
+      `• If the \`${CONVEX_DEPLOY_KEY_ENV_VAR_NAME}\` environment variable is set (typical in CI), it is the deployment associated with that key.`,
+      `  • When it’s set to a preview deploy key, it will deploy to a preview deployment:`,
+      `    • with the name of the current Git branch when running in CI (Vercel, Netlify, Cloudflare Pages, GitHub)`,
+      `    • or with the name specified by the \`--preview-name\` or \`--preview-create\` flags`,
       "",
       "`npx convex deploy` will:",
       "  1. Run a command if specified with `--cmd`, with the deployment URL available as an environment variable.",

package/src/cli/deploymentCreate.test.ts

@@ -1,6 +1,8 @@
 import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
 // @inquirer/testing/vitest must be imported before modules that use @inquirer/*
 import { screen } from "@inquirer/testing/vitest";
+import { fileURLToPath } from "url";
+import path from "path";
 import {
   typedPlatformClient,
   typedBigBrainClient,
@@ -13,7 +15,9 @@ import {
   getDeploymentSelection,
   getProjectDetails,
   deploymentNameFromSelection,
+  initializeBigBrainAuth,
 } from "./lib/deploymentSelection.js";
+import type { Context } from "../bundler/context.js";
 import { saveSelectedDeployment } from "./deploymentSelect.js";
 import {
   deploymentCreate,
@@ -25,10 +29,7 @@ import {
   loadProjectLocalConfig,
   saveDeploymentConfig,
 } from "./lib/localDeployment/filePaths.js";
-import {
-  chooseLocalBackendPorts,
-  LOCAL_BACKEND_INSTANCE_SECRET,
-} from "./lib/localDeployment/utils.js";
+import { chooseLocalBackendPorts } from "./lib/localDeployment/utils.js";
 import { bigBrainStart } from "./lib/localDeployment/bigBrain.js";
 
 vi.mock("@sentry/node", () => ({
@@ -36,19 +37,28 @@ vi.mock("@sentry/node", () => ({
   close: vi.fn(),
 }));
 
-vi.mock("./lib/utils/utils.js", () => ({
-  typedPlatformClient: vi.fn(),
-  typedBigBrainClient: vi.fn(),
-  selectRegion: vi.fn(),
-  logNoDefaultRegionMessage: vi.fn(),
-}));
+vi.mock("./lib/utils/utils.js", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("./lib/utils/utils.js")>();
+  return {
+    ...actual,
+    typedPlatformClient: vi.fn(),
+    typedBigBrainClient: vi.fn(),
+    selectRegion: vi.fn(),
+    logNoDefaultRegionMessage: vi.fn(),
+  };
+});
 
-vi.mock("./lib/deploymentSelection.js", () => ({
-  initializeBigBrainAuth: vi.fn(),
-  getDeploymentSelection: vi.fn(),
-  getProjectDetails: vi.fn(),
-  deploymentNameFromSelection: vi.fn().mockReturnValue(null),
-}));
+vi.mock("./lib/deploymentSelection.js", async (importOriginal) => {
+  const actual =
+    await importOriginal<typeof import("./lib/deploymentSelection.js")>();
+  return {
+    ...actual,
+    initializeBigBrainAuth: vi.fn(),
+    getDeploymentSelection: vi.fn(),
+    getProjectDetails: vi.fn(),
+    deploymentNameFromSelection: vi.fn().mockReturnValue(null),
+  };
+});
 
 vi.mock("./deploymentSelect.js", () => ({
   saveSelectedDeployment: vi.fn(),
@@ -65,13 +75,17 @@ vi.mock("./lib/localDeployment/filePaths.js", () => ({
 
 vi.mock("./lib/localDeployment/utils.js", () => ({
   chooseLocalBackendPorts: vi.fn(),
-  LOCAL_BACKEND_INSTANCE_SECRET: "MockSecret123",
 }));
 
 vi.mock("./lib/localDeployment/bigBrain.js", () => ({
   bigBrainStart: vi.fn(),
 }));
 
+const fakeLocalDevBinary = path.join(
+  path.dirname(fileURLToPath(import.meta.url)),
+  "lib/localDeployment/tests/keygenSuccess.mjs",
+);
+
 const mockRegions = [
   {
     name: "aws-us-east-1" as const,
@@ -104,6 +118,44 @@ const mockPlatformGet = vi.fn();
 const mockPlatformPost = vi.fn();
 const mockBigBrainGet = vi.fn();
 
+function setAuthKind(
+  kind: "accessToken" | "deploymentKey" | "projectKey" | "previewDeployKey",
+) {
+  vi.mocked(initializeBigBrainAuth).mockImplementation(async (ctx) => {
+    const fakeAuth =
+      kind === "accessToken"
+        ? {
+            kind: "accessToken" as const,
+            accessToken: "test-token",
+            header: "Bearer test-token",
+          }
+        : kind === "deploymentKey"
+          ? {
+              kind: "deploymentKey" as const,
+              deploymentKey: "dev:foo|secret",
+              header: "Bearer dev:foo|secret",
+            }
+          : kind === "projectKey"
+            ? {
+                kind: "projectKey" as const,
+                projectKey: "project:foo|secret",
+                header: "Bearer project:foo|secret",
+              }
+            : {
+                kind: "previewDeployKey" as const,
+                previewDeployKey: "preview:t:p|secret",
+                header: "Bearer preview:t:p|secret",
+              };
+    (ctx as Context)._updateBigBrainAuth(fakeAuth);
+  });
+}
+
+function setNoAuth() {
+  vi.mocked(initializeBigBrainAuth).mockImplementation(async (ctx) => {
+    (ctx as Context)._updateBigBrainAuth(null);
+  });
+}
+
 function setupPlatformClient() {
   vi.mocked(typedPlatformClient).mockReturnValue({
     GET: mockPlatformGet,
@@ -123,6 +175,8 @@ beforeEach(() => {
   mockPlatformGet.mockReset();
   mockPlatformPost.mockReset();
   mockBigBrainGet.mockReset();
+  // Default to a logged-in personal access token; guard tests override this.
+  setAuthKind("accessToken");
 });
 
 afterEach(() => {
@@ -161,6 +215,60 @@ function setupPlatformForCreate(overrides?: Record<string, unknown>) {
   });
 }
 
+describe("deploy key guard", () => {
+  test.each(["deploymentKey", "previewDeployKey"] as const)(
+    "crashes before any platform call when authed with a %s",
+    async (kind) => {
+      setAuthKind(kind);
+      setupPlatformClient();
+
+      await expect(
+        deploymentCreate.parseAsync(["my-deployment", "--type", "dev"], {
+          from: "user",
+        }),
+      ).rejects.toThrow();
+
+      expect(process.stderr.write).toHaveBeenCalledWith(
+        expect.stringContaining("isn't supported with a deploy key"),
+      );
+      expect(mockPlatformGet).not.toHaveBeenCalled();
+      expect(mockPlatformPost).not.toHaveBeenCalled();
+    },
+  );
+
+  test("crashes when no auth is configured at all", async () => {
+    setNoAuth();
+    setupPlatformClient();
+
+    await expect(
+      deploymentCreate.parseAsync(["my-deployment", "--type", "dev"], {
+        from: "user",
+      }),
+    ).rejects.toThrow();
+
+    expect(process.stderr.write).toHaveBeenCalledWith(
+      expect.stringContaining("Creating a deployment requires logging in"),
+    );
+    expect(mockPlatformGet).not.toHaveBeenCalled();
+    expect(mockPlatformPost).not.toHaveBeenCalled();
+  });
+
+  test("also guards local deployment creation", async () => {
+    setAuthKind("deploymentKey");
+    setupPlatformClient();
+
+    await expect(
+      deploymentCreate.parseAsync(["local"], { from: "user" }),
+    ).rejects.toThrow();
+
+    expect(process.stderr.write).toHaveBeenCalledWith(
+      expect.stringContaining("isn't supported with a deploy key"),
+    );
+    expect(mockPlatformGet).not.toHaveBeenCalled();
+    expect(mockPlatformPost).not.toHaveBeenCalled();
+  });
+});
+
 describe("non-interactive create flow", () => {
   beforeEach(() => {
     vi.mocked(getDeploymentSelection).mockReset();
@@ -209,7 +317,7 @@ describe("non-interactive create flow", () => {
       vi.mocked(getProjectDetails).mockResolvedValue(fakeProject);
       vi.mocked(loadProjectLocalConfig).mockReturnValue(null);
       vi.mocked(ensureBackendBinaryDownloaded).mockResolvedValue({
-        binaryPath: "/path",
+        binaryPath: fakeLocalDevBinary,
         version: "1.0.0",
       });
       vi.mocked(chooseLocalBackendPorts).mockResolvedValue({
@@ -233,8 +341,8 @@ describe("non-interactive create flow", () => {
         {
           backendVersion: "1.0.0",
           ports: { cloud: 3210, site: 3211 },
-          adminKey: "test-key",
-          instanceSecret: LOCAL_BACKEND_INSTANCE_SECRET,
+          adminKey: "local-test-123|mock_admin_key",
+          instanceSecret: expect.anything(),
           cloudProjectId: fakeProject.id,
         },
       );
@@ -261,7 +369,7 @@ describe("non-interactive create flow", () => {
       vi.mocked(getProjectDetails).mockResolvedValue(fakeProject);
       vi.mocked(loadProjectLocalConfig).mockReturnValue(null);
       vi.mocked(ensureBackendBinaryDownloaded).mockResolvedValue({
-        binaryPath: "/path",
+        binaryPath: fakeLocalDevBinary,
         version: "1.0.0",
       });
       vi.mocked(chooseLocalBackendPorts).mockResolvedValue({
@@ -405,6 +513,25 @@ describe("non-interactive create flow", () => {
       );
     });
 
+    test("allows a project key (creates the deployment)", async () => {
+      setAuthKind("projectKey");
+      setupPlatformForCreate();
+
+      await deploymentCreate.parseAsync(["my-deployment", "--type", "dev"], {
+        from: "user",
+      });
+
+      expect(mockPlatformPost).toHaveBeenCalledWith(
+        "/projects/{project_id}/create_deployment",
+        expect.objectContaining({
+          body: expect.objectContaining({
+            type: "dev",
+            reference: "my-deployment",
+          }),
+        }),
+      );
+    });
+
     test("creates a prod deployment with ref and --type prod", async () => {
       setupPlatformForCreate({
         deploymentType: "prod",
@@ -661,7 +788,7 @@ describe("non-interactive create flow", () => {
       });
       vi.mocked(loadProjectLocalConfig).mockReturnValue(null);
       vi.mocked(ensureBackendBinaryDownloaded).mockResolvedValue({
-        binaryPath: "/path",
+        binaryPath: fakeLocalDevBinary,
         version: "1.0.0",
       });
       vi.mocked(chooseLocalBackendPorts).mockResolvedValue({
@@ -697,7 +824,7 @@ describe("non-interactive create flow", () => {
         "local",
         "local-other_team-other_project-xyz",
         expect.objectContaining({
-          adminKey: "other-key",
+          adminKey: "local-other_team-other_project-xyz|mock_admin_key",
           cloudProjectId: 999,
         }),
       );
@@ -730,7 +857,7 @@ describe("non-interactive create flow", () => {
       });
       vi.mocked(loadProjectLocalConfig).mockReturnValue(null);
       vi.mocked(ensureBackendBinaryDownloaded).mockResolvedValue({
-        binaryPath: "/path",
+        binaryPath: fakeLocalDevBinary,
         version: "1.0.0",
       });
       vi.mocked(chooseLocalBackendPorts).mockResolvedValue({

package/src/cli/deploymentCreate.ts

@@ -9,6 +9,7 @@ import {
 } from "../bundler/log.js";
 import {
   DeploymentSelection,
+  ensureAuthCanCreateDeployment,
   getDeploymentSelection,
   getProjectDetails,
   deploymentNameFromSelection,
@@ -35,14 +36,12 @@ import {
   loadProjectLocalConfig,
   saveDeploymentConfig,
 } from "./lib/localDeployment/filePaths.js";
-import {
-  chooseLocalBackendPorts,
-  LOCAL_BACKEND_INSTANCE_SECRET,
-} from "./lib/localDeployment/utils.js";
+import { chooseLocalBackendPorts } from "./lib/localDeployment/utils.js";
 import { bigBrainStart } from "./lib/localDeployment/bigBrain.js";
 import { importDefaultEnvVars } from "./lib/localDeployment/localDeployment.js";
 import { localDeploymentUrl } from "./lib/localDeployment/run.js";
 import { announceDeploymentTarget } from "./lib/announceDeploymentTarget.js";
+import { generateLocalDevSecrets } from "./lib/localDeployment/secrets.js";
 
 const SUPPORTED_TYPES = ["dev", "prod", "preview"] as const;
 
@@ -52,8 +51,8 @@ export const deploymentCreate = new Command("create")
     [
       "Create a new deployment for a project.",
       "",
-      "- Create a dev deployment and select it: `npx convex deployment create dev/my-new-feature --type dev --select`",
-      "- Create a prod deployment named “staging”: `npx convex deployment create staging --type prod`",
+      "• Create a dev deployment and select it: `npx convex deployment create dev/my-new-feature --type dev --select`",
+      "• Create a prod deployment named “staging”: `npx convex deployment create staging --type prod`",
     ].join("\n"),
   )
   .argument(
@@ -91,6 +90,12 @@ export const deploymentCreate = new Command("create")
       envFile: undefined,
     });
 
+    // Creating a deployment goes through the platform API, which accepts
+    // personal access tokens and project keys but not deployment/preview deploy
+    // keys. Fail fast (and clearly) for the unsupported keys rather than
+    // surfacing an opaque 401 from the lookup below.
+    await ensureAuthCanCreateDeployment(ctx);
+
     const currentDeployment = await getDeploymentSelection(ctx, {
       url: undefined,
       adminKey: undefined,
@@ -282,25 +287,30 @@ export async function createLocalDeployment(
     : await resolveProject(ctx, currentDeployment);
 
   showSpinner("Downloading local backend...");
-  const { version } = await ensureBackendBinaryDownloaded(ctx, {
-    kind: "latest",
-  });
+  const { version, binaryPath: latestBinaryPath } =
+    await ensureBackendBinaryDownloaded(ctx, {
+      kind: "latest",
+    });
 
   const { cloudPort, sitePort } = await chooseLocalBackendPorts(ctx);
 
   showSpinner("Registering local deployment...");
-  const { deploymentName, adminKey } = await bigBrainStart(ctx, {
+  const { deploymentName } = await bigBrainStart(ctx, {
     port: cloudPort,
     projectSlug,
     teamSlug,
     instanceName: null,
   });
+  const { instanceSecret, adminKey } = await generateLocalDevSecrets(ctx, {
+    deploymentName,
+    latestBinaryPath,
+  });
 
   saveDeploymentConfig(ctx, "local", deploymentName, {
     backendVersion: version,
     ports: { cloud: cloudPort, site: sitePort },
     adminKey,
-    instanceSecret: LOCAL_BACKEND_INSTANCE_SECRET,
+    instanceSecret,
     cloudProjectId,
   });
 

package/src/cli/deploymentSelect.ts

@@ -38,11 +38,11 @@ export const deploymentSelect = new Command("select")
       "",
       "The deployment will be used by all `npx convex` commands, except `npx convex deploy`. You can also run individual commands on another deployment by using the --deployment flag on that command.",
       "",
-      "- Select your personal cloud dev deployment in the current project: `npx convex deployment select dev`",
-      "- Select your local deployment: `npx convex deployment select local`",
-      "- Select a deployment in the same project by its reference: `npx convex deployment select dev/james`",
-      "- Select a deployment in another project in the same team: `npx convex deployment select some-project:dev/james`",
-      "- Select a deployment in a particular team/project: `npx convex deployment select some-team:some-project:dev/james`",
+      "• Select your personal cloud dev deployment in the current project: `npx convex deployment select dev`",
+      "• Select your local deployment: `npx convex deployment select local`",
+      "• Select a deployment in the same project by its reference: `npx convex deployment select dev/james`",
+      "• Select a deployment in another project in the same team: `npx convex deployment select some-project:dev/james`",
+      "• Select a deployment in a particular team/project: `npx convex deployment select some-team:some-project:dev/james`",
     ].join("\n"),
   )
   .argument("<deployment>", "The deployment to use")

package/src/cli/deploymentSelection.test.ts

@@ -271,7 +271,6 @@ describe("deployment selection flows", () => {
       deploymentName: "local-test",
       deploymentUrl: "http://127.0.0.1:3210",
       adminKey: "local|admin|key",
-      onActivity: async () => {},
     } as any);
     vi.mocked(loadLocalDeploymentCredentials).mockResolvedValue({
       deploymentName: "local-test",
@@ -291,7 +290,6 @@ describe("deployment selection flows", () => {
       adminKey: "anon|admin|key",
       reference: null,
       isDefault: false,
-      onActivity: async () => {},
     });
   });
 
@@ -2295,7 +2293,6 @@ describe("deployment selection flows", () => {
         deploymentName: "my-local-deployment",
         deploymentUrl: "http://127.0.0.1:3210",
         adminKey: "fresh|admin|key",
-        onActivity: async () => {},
       } as any);
 
       setupBigBrainRoutes({