@mcpcloud/cli 0.17.1 → 0.17.2

package/README.md

@@ -367,7 +367,7 @@ _Generated from the live command tree by `bun run docs:readme` — do not edit b
 | `mcp servers test-suites get <suiteId>` | Show one server test suite including its scenario membership |
 | `mcp servers test-suites list <server>` | List test suites bound to a server |
 | `mcp servers test-suites run <server>` | Run the server’s test scenarios and report the suite result |
-| `mcp servers update <server>` | Update a server (name, description, runtime token TTL) |
+| `mcp servers update <server>` | Update a server (name, description, tool surface, upstream key mode, runtime token TTL) |
 | `mcp servers variables` | Inspect and set the sandbox variables that scenario arguments reference |
 | `mcp servers variables list <server>` | List a server’s sandbox variables and which ones still need a value |
 | `mcp servers variables set <server>` | Set or clear sandbox variables (repeat --set; an empty value clears) |

package/dist/index.js

@@ -7674,10 +7674,37 @@ function registerServerExportCommands(servers) {
   }));
 }
 
+// src/lib/validate-choice.ts
+function validateChoice(name, value, allowed) {
+  const trimmed = value.trim();
+  const match = allowed.find((option) => option.toLowerCase() === trimmed.toLowerCase());
+  if (!match) {
+    throw new Error(`Invalid --${name}: ${value}. Expected one of: ${allowed.join(", ")}.`);
+  }
+  return match;
+}
+
 // src/commands/servers-lifecycle.ts
 import { existsSync as existsSync6 } from "node:fs";
 import { isAbsolute as isAbsolute2, resolve as resolve4 } from "node:path";
 
+// src/lib/deployment-display.ts
+function formatDeploymentExposure(deployment) {
+  const exposure = deployment.exposureTarget ?? null;
+  if (exposure === "platformSubdomain")
+    return "Platform subdomain";
+  if (exposure === "managedDomain")
+    return "Premium subdomain";
+  if (exposure === "workersDev")
+    return "workers.dev";
+  const target = deployment.target ?? null;
+  if (target === "managedDomain")
+    return "Premium subdomain";
+  if (target === "workersDev")
+    return "Platform default";
+  return target ?? "unknown";
+}
+
 // src/lib/dev/spec-watcher.ts
 import { createHash as createHash2 } from "node:crypto";
 import {
@@ -7808,13 +7835,6 @@ var ACCESS_MODES = [
   "privateOrg",
   "unlisted"
 ];
-function validateChoice(name, value, allowed) {
-  const v2 = value.trim();
-  if (!allowed.includes(v2)) {
-    throw new Error(`Invalid --${name}: ${value}. Expected one of: ${allowed.join(", ")}.`);
-  }
-  return v2;
-}
 function reportDeployFailure(terminalEvent) {
   if (!terminalEvent || !isFailureEvent(terminalEvent))
     return false;
@@ -7899,8 +7919,17 @@ function registerServerLifecycleCommands(servers) {
       }
     }
     const deployFailed = dep.status === "failed" || Boolean(terminalEvent && isFailureEvent(terminalEvent));
+    let final = dep;
+    if (opts.wait && waitDone) {
+      try {
+        const refreshed = await api.get(`/api/v1/server/deployments?organizationId=${encodeURIComponent(orgId)}&serverId=${encodeURIComponent(serverId)}&limit=5`);
+        const row = (refreshed.deployments ?? []).find((entry) => entry.id === dep.deploymentId);
+        if (row)
+          final = { ...dep, ...row };
+      } catch {}
+    }
     if (isJsonMode()) {
-      printJson({ deployment: dep, waitDone, terminalEvent });
+      printJson({ deployment: final, waitDone, terminalEvent });
       if (opts.wait && (!waitDone || deployFailed))
         throw new CliExitError(1);
       return;
@@ -7908,11 +7937,11 @@ function registerServerLifecycleCommands(servers) {
     printSuccess(`Deployment ${c.bold(dep.deploymentId)} created.`);
     printKeyValue({
       id: dep.deploymentId,
-      ...dep.deploymentUrl ? { url: dep.deploymentUrl } : {},
-      target: dep.target,
+      ...final.deploymentUrl ? { url: final.deploymentUrl } : {},
+      exposure: formatDeploymentExposure(final),
       "access mode": dep.accessMode,
-      status: dep.status,
-      health: dep.healthStatus,
+      status: final.status,
+      health: final.healthStatus,
       ...terminalEvent ? {
         "terminal event": `${terminalEvent.stage} (${terminalEvent.level}) — ${terminalEvent.message}`,
         "terminal at": formatDate(terminalEvent.timestamp)
@@ -8200,23 +8229,41 @@ function registerServerMutationCommands(servers) {
       created: formatDate(s.createdAt)
     });
   }));
-  servers.command("update <server>").description("Update a server (name, description, runtime token TTL)").option("--org <organizationId>", "Organization ID").option("--name <name>", "New display name").option("--description <text>", "New description").option("--runtime-token-ttl <seconds|default>", 'Runtime token lifetime in seconds (60-86400; the default AND cap for minted tokens). Pass "default" to restore the 300s platform default.').addHelpText("after", [
+  servers.command("update <server>").description("Update a server (name, description, tool surface, upstream key mode, runtime token TTL)").option("--org <organizationId>", "Organization ID").option("--name <name>", "New display name").option("--description <text>", "New description").option("--discovery-mode <all|wrapper>", 'Tool surface: "all" registers every operation; "wrapper" registers searchTools/getToolDefinition/useTool INSTEAD (operations are called through useTool).').option("--code-mode <off|opt-in|default>", "Code Mode: expose codemode_execute so an agent can script several calls in one sandboxed run. Served by the edge, so it takes effect on the next deploy.").option("--upstream-api-key-mode <shared|perMember>", "Whose upstream credential the server uses: one shared key, or each member their own (Pro and above).").option("--runtime-token-ttl <seconds|default>", 'Runtime token lifetime in seconds (60-86400; the default AND cap for minted tokens). Pass "default" to restore the 300s platform default.').addHelpText("after", [
     "",
     "Notes:",
     "  Runtime defaults (oauth, deploymentDefaults, runtime bindings) are not",
-    "  v1 PATCH-able. Change them via `mcp servers deploy --upstream-*`."
+    "  v1 PATCH-able. Change them via `mcp servers deploy --upstream-*`.",
+    "  --discovery-mode and --code-mode change the server's TOOL SURFACE and",
+    "  reach clients on the next `mcp servers deploy`. Check what is live with",
+    "  `mcp servers get <server> --probe`."
   ].join(`
 `)).action(runAction(async (serverRef, opts) => {
     const orgId = await resolveOrgId(opts.org);
     const serverId = await resolveServerId(serverRef, orgId);
+    const serverData = await api.get("/api/v1/server", { organizationId: orgId, serverId });
     const body = {
       organizationId: orgId,
+      projectId: serverData.server.projectId,
       serverId
     };
     if (opts.name !== undefined)
       body["name"] = opts.name;
     if (opts.description !== undefined)
       body["description"] = opts.description;
+    if (opts.discoveryMode !== undefined) {
+      body["discoveryMode"] = validateChoice("discovery-mode", opts.discoveryMode, ["all", "wrapper"]);
+    }
+    if (opts.codeMode !== undefined) {
+      body["codeModeMode"] = validateChoice("code-mode", opts.codeMode, [
+        "off",
+        "opt-in",
+        "default"
+      ]);
+    }
+    if (opts.upstreamApiKeyMode !== undefined) {
+      body["upstreamApiKeyMode"] = validateChoice("upstream-api-key-mode", opts.upstreamApiKeyMode, ["shared", "perMember"]);
+    }
     if (opts.runtimeTokenTtl !== undefined) {
       if (opts.runtimeTokenTtl === "default") {
         body["runtimeTokenTtlSeconds"] = null;
@@ -8228,8 +8275,8 @@ function registerServerMutationCommands(servers) {
         body["runtimeTokenTtlSeconds"] = ttl;
       }
     }
-    if (Object.keys(body).length === 2) {
-      throw new Error("Provide at least one of --name, --description, or --runtime-token-ttl.");
+    if (Object.keys(body).length === 3) {
+      throw new Error("Provide at least one of --name, --description, --discovery-mode, --code-mode, --upstream-api-key-mode, or --runtime-token-ttl.");
     }
     const data = await api.patch("/api/v1/server", body);
     if (isJsonMode()) {
@@ -32385,18 +32432,11 @@ var SELECTOR_HELP = [
   "  $ mcp deployments get dep_123        # bare ids still work, no --server"
 ].join(`
 `);
-function validateChoice4(name, value, allowed) {
-  const v2 = value.trim().toLowerCase();
-  if (!allowed.includes(v2)) {
-    throw new Error(`Invalid --${name}: ${value}. Expected one of: ${allowed.join(", ")}.`);
-  }
-  return v2;
-}
 function registerDeploymentCommands(program2) {
   const deployments = program2.command("deployments").description("Inspect deployments");
   deployments.command("list").description("List deployments in an organization").option("--org <organizationId>", "Organization ID").option("--status <status>", `Filter: ${DEPLOYMENT_STATUSES.join(" | ")}`, "active").option("--limit <n>", "Maximum results (default 25)", parsePositiveIntOption("limit"), "25").action(runAction(async (opts) => {
     const orgId = await resolveOrgId(opts.org);
-    const status = validateChoice4("status", opts.status, DEPLOYMENT_STATUSES);
+    const status = validateChoice("status", opts.status, DEPLOYMENT_STATUSES);
     const data = await api.get("/api/v1/deployments", {
       organizationId: orgId,
       status,
@@ -32406,7 +32446,7 @@ function registerDeploymentCommands(program2) {
       id: d.id,
       server: d.serverName,
       project: d.projectName,
-      target: d.target,
+      exposure: formatDeploymentExposure(d),
       access: d.accessMode,
       status: d.status,
       version: d.version,
@@ -32443,7 +32483,7 @@ function registerDeploymentCommands(program2) {
       project: `${d.projectName} (${d.projectId})`,
       url: d.deploymentUrl ?? "—",
       hostname: d.hostname ?? "—",
-      target: d.target,
+      exposure: formatDeploymentExposure(d),
       "access mode": d.accessMode,
       status: d.status,
       version: d.version,
@@ -32541,7 +32581,7 @@ function registerDeploymentCommands(program2) {
       status: d.status,
       "access mode": d.accessMode,
       url: d.deploymentUrl ?? "—",
-      target: d.target,
+      exposure: formatDeploymentExposure(d),
       version: d.version,
       demoted: d.demotedDeploymentId ?? "—",
       "rolled back at": formatDate(d.rolledBackAt)
@@ -34140,7 +34180,7 @@ async function resolveArtifactId(reference, scope = {}) {
 // src/commands/marketplace.ts
 var ARTIFACT_TYPE_FILTERS = ["all", "server", "skill"];
 var ACCESS_FILTERS = ["all", "public", "privateOrg"];
-function validateChoice5(name, value, allowed) {
+function validateChoice4(name, value, allowed) {
   const v2 = value.trim();
   if (!allowed.includes(v2)) {
     throw new Error(`Invalid --${name}: ${value}. Expected one of: ${allowed.join(", ")}.`);
@@ -34158,8 +34198,8 @@ function registerMarketplaceCommands(program2) {
     "  $ mcp --json marketplace list --type server | jq '.artifacts[].id'"
   ].join(`
 `)).action(runAction(async (opts) => {
-    const artifactType = validateChoice5("type", opts.type, ARTIFACT_TYPE_FILTERS);
-    const access = validateChoice5("access", opts.access, ACCESS_FILTERS);
+    const artifactType = validateChoice4("type", opts.type, ARTIFACT_TYPE_FILTERS);
+    const access = validateChoice4("access", opts.access, ACCESS_FILTERS);
     const params = { limit: opts.limit };
     if (artifactType !== "all")
       params["artifactType"] = artifactType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpcloud/cli",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "The official CLI for MCPCloud — manage projects, servers, skills, and API keys from the terminal",
   "type": "module",
   "bin": {