@agent-nexus/cli 0.1.10 → 0.1.12

package/README.md

@@ -470,6 +470,7 @@ All commands follow the pattern: `nexus <group> <action> [arguments] [options]`
 | [`eval`](docs/command-reference.md#nexus-eval)                         | (subgroups: `session`, `dataset`, `execute`, `judge`, `results`, `formats`, `judges`) | AI task evaluation         |
 | [`ticket`](docs/command-reference.md#nexus-ticket)                     | `list` `get` `create` `update` `comment` `comments`                                   | Bug and feature tracking   |
 | [`phone-number`](docs/command-reference.md#nexus-phone-number)         | `search` `buy` `list` `get` `release`                                                 | Phone number management    |
+| [`channel`](docs/command-reference.md#nexus-channel)                   | `setup` `connection list\|create` `whatsapp-sender list\|create\|get`                 | Channel setup orchestrator |
 | [`prompt-assistant`](docs/command-reference.md#nexus-prompt-assistant) | `chat` `get-thread` `delete-thread`                                                   | AI-assisted prompt writing |
 
 ### Utility
@@ -600,6 +601,9 @@ Every CLI command maps to an SDK method. Use the SDK (`@agent-nexus/sdk`) when b
 | `nexus model list`                      | `client.models.list()`                                |
 | `nexus ticket create --title X ...`     | `client.tickets.create({ title: "X", ... })`          |
 | `nexus phone-number list`               | `client.phoneNumbers.list()`                          |
+| `nexus channel setup --type WHATSAPP`   | `client.channels.getSetupStatus("WHATSAPP")`          |
+| `nexus channel connection create`       | `client.channels.createConnection()`                  |
+| `nexus channel whatsapp-sender create`  | `client.channels.createWhatsAppSender({ ... })`       |
 
 > **Full SDK documentation:** See [@agent-nexus/sdk README](../sdk/README.md)
 

package/dist/index.js

@@ -166,7 +166,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@agent-nexus/cli",
-      version: "0.1.10",
+      version: "0.1.12",
       description: "Official CLI for the Nexus AI agent platform.",
       license: "MIT",
       keywords: [
@@ -695,6 +695,24 @@ var AgentsResource = class extends BaseResource {
     return this.http.request("POST", `/agents/${agentId}/generate-profile-picture`, { body });
   }
 };
+var AnalyticsResource = class extends BaseResource {
+  async getOverview(params) {
+    return this.http.request("GET", "/analytics/overview", {
+      query: params
+    });
+  }
+  async exportCsv(params) {
+    return this.http.requestRaw("GET", "/analytics/export", {
+      query: params
+    });
+  }
+  async listFeedback(params) {
+    const { data, meta } = await this.http.requestWithMeta("GET", "/analytics/feedback", {
+      query: params
+    });
+    return { data, meta };
+  }
+};
 var ChannelsResource = class extends BaseResource {
   // ===========================================================================
   // Setup Orchestrator
@@ -748,23 +766,42 @@ var ChannelsResource = class extends BaseResource {
   async getWhatsAppSender(senderId) {
     return this.http.request("GET", `/channels/whatsapp-senders/${senderId}`);
   }
-};
-var AnalyticsResource = class extends BaseResource {
-  async getOverview(params) {
-    return this.http.request("GET", "/analytics/overview", {
+  // ===========================================================================
+  // WhatsApp Templates
+  // ===========================================================================
+  async listWhatsAppTemplates(params) {
+    return this.http.request("GET", "/channels/whatsapp-templates", {
       query: params
     });
   }
-  async exportCsv(params) {
-    return this.http.requestRaw("GET", "/analytics/export", {
-      query: params
-    });
+  async createWhatsAppTemplate(body) {
+    return this.http.request("POST", "/channels/whatsapp-templates", { body });
   }
-  async listFeedback(params) {
-    const { data, meta } = await this.http.requestWithMeta("GET", "/analytics/feedback", {
-      query: params
-    });
-    return { data, meta };
+  async getWhatsAppTemplate(templateId) {
+    return this.http.request(
+      "GET",
+      `/channels/whatsapp-templates/${templateId}`
+    );
+  }
+  async deleteWhatsAppTemplate(templateId) {
+    return this.http.request(
+      "DELETE",
+      `/channels/whatsapp-templates/${templateId}`
+    );
+  }
+  async listTemplateApprovals(params) {
+    return this.http.request(
+      "GET",
+      "/channels/whatsapp-templates/approvals",
+      { query: params }
+    );
+  }
+  async submitTemplateApproval(body) {
+    return this.http.request(
+      "POST",
+      "/channels/whatsapp-templates/approvals",
+      { body }
+    );
   }
 };
 var CloudImportsResource = class extends BaseResource {
@@ -898,6 +935,42 @@ var DeploymentsResource = class extends BaseResource {
   async updateEmbedConfig(deploymentId, body) {
     return this.http.request("PATCH", `/deployments/${deploymentId}/embed-config`, { body });
   }
+  // ===========================================================================
+  // WhatsApp Deployment Templates
+  // ===========================================================================
+  async listDeploymentTemplates(deploymentId) {
+    return this.http.request(
+      "GET",
+      `/deployments/${deploymentId}/whatsapp-templates`
+    );
+  }
+  async attachDeploymentTemplate(deploymentId, body) {
+    return this.http.request(
+      "POST",
+      `/deployments/${deploymentId}/whatsapp-templates`,
+      { body }
+    );
+  }
+  async updateDeploymentTemplate(deploymentId, templateId, body) {
+    return this.http.request(
+      "PATCH",
+      `/deployments/${deploymentId}/whatsapp-templates/${templateId}`,
+      { body }
+    );
+  }
+  async detachDeploymentTemplate(deploymentId, templateId) {
+    return this.http.request(
+      "DELETE",
+      `/deployments/${deploymentId}/whatsapp-templates/${templateId}`
+    );
+  }
+  async updateDeploymentTemplateSettings(deploymentId, body) {
+    return this.http.request(
+      "PATCH",
+      `/deployments/${deploymentId}/whatsapp-templates/settings`,
+      { body }
+    );
+  }
 };
 var DocumentTemplateFoldersResource = class extends BaseResource {
   async list() {
@@ -2471,6 +2544,10 @@ var URL_MAP = {
   production: "https://api.nexusgpt.io",
   dev: "http://localhost:3001"
 };
+var DASHBOARD_URL_MAP = {
+  production: "https://gpt.nexus",
+  dev: "http://localhost:3000"
+};
 var CONFIG_DIR = import_node_path.default.join(import_node_os.default.homedir(), ".nexus-mcp");
 var CONFIG_FILE = import_node_path.default.join(CONFIG_DIR, "config.json");
 var NEXUSRC_FILENAME = ".nexusrc";
@@ -2657,6 +2734,17 @@ function resolveBaseUrl(override) {
   const env = process.env.NEXUS_ENV ?? "production";
   return URL_MAP[env] ?? URL_MAP.production;
 }
+function resolveDashboardUrl(override) {
+  if (override) return override;
+  if (process.env.NEXUS_DASHBOARD_URL) return process.env.NEXUS_DASHBOARD_URL;
+  try {
+    const resolved = resolveProfile();
+    if (resolved.profile.dashboardUrl) return resolved.profile.dashboardUrl;
+  } catch {
+  }
+  const env = process.env.NEXUS_ENV ?? "production";
+  return DASHBOARD_URL_MAP[env] ?? DASHBOARD_URL_MAP.production;
+}
 
 // src/client.ts
 var _lastResolved = null;
@@ -3275,8 +3363,10 @@ Notes:
   Run "nexus auth list" to see all profiles, "nexus auth switch <name>" to change active.`
   ).action(async (opts) => {
     let baseUrl;
+    let dashboardUrl;
     if (opts.env === "dev") {
       baseUrl = "http://localhost:3001";
+      dashboardUrl = "http://localhost:3000";
     }
     const resolvedBaseUrl = baseUrl ?? resolveBaseUrl();
     let apiKey = opts.apiKey;
@@ -3368,6 +3458,7 @@ Notes:
     saveProfile(profileName, {
       apiKey,
       ...baseUrl ? { baseUrl } : {},
+      ...dashboardUrl ? { dashboardUrl } : {},
       ...orgName ? { orgName } : {},
       ...orgId ? { orgId } : {}
     });
@@ -3569,10 +3660,20 @@ function openUrl(url) {
 }
 
 // src/commands/channel.ts
+var import_node_child_process2 = require("child_process");
+var import_node_fs2 = require("fs");
 init_output();
+function openUrl2(url) {
+  const platform = process.platform;
+  const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  (0, import_node_child_process2.exec)(`${cmd} ${JSON.stringify(url)}`);
+}
 function registerChannelCommands(program2) {
   const channel = program2.command("channel").description("Set up deployment channels: connections, phone numbers, WhatsApp senders");
-  channel.command("setup").description("Check or auto-provision channel setup prerequisites").requiredOption("--type <type>", "Deployment type (WHATSAPP, TWILIO_SMS, TWILIO_VOICE, EMBED, etc.)").option("--auto", "Auto-provision what is possible (e.g., create messaging connection)").option("--region <region>", "Region for auto-provisioning (us1 or ie1)", "us1").addHelpText(
+  channel.command("setup").description("Check or auto-provision channel setup prerequisites").requiredOption(
+    "--type <type>",
+    "Deployment type (WHATSAPP, TWILIO_SMS, TWILIO_VOICE, EMBED, etc.)"
+  ).option("--auto", "Auto-provision what is possible (e.g., create messaging connection)").option("--region <region>", "Region for auto-provisioning (us1 or ie1)", "us1").addHelpText(
     "after",
     `
 Examples:
@@ -3605,6 +3706,28 @@ Examples:
       process.exitCode = handleError(err);
     }
   });
+  channel.command("connect-waba").description("Open browser to connect your WhatsApp Business Account (Meta signup)").addHelpText(
+    "after",
+    `
+This step requires a browser \u2014 it cannot be done via API.
+Opens the Nexus dashboard where you can click "Connect with Meta"
+to link your WhatsApp Business Account.
+
+Examples:
+  $ nexus channel connect-waba`
+  ).action(async () => {
+    try {
+      const dashboardUrl = resolveDashboardUrl(program2.optsWithGlobals().dashboardUrl);
+      const url = `${dashboardUrl}/app/connect-waba`;
+      console.log(`Opening ${color.cyan(url)} ...`);
+      console.log("");
+      console.log('Complete the "Connect with Meta" flow in your browser, then verify:');
+      console.log(`  ${color.dim("nexus channel setup --type WHATSAPP")}`);
+      openUrl2(url);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
   const connection = channel.command("connection").description("Manage messaging connections");
   connection.command("list").description("List messaging connections").action(async () => {
     try {
@@ -3699,6 +3822,253 @@ Examples:
       process.exitCode = handleError(err);
     }
   });
+  const waTemplate = channel.command("whatsapp-template").description("Manage WhatsApp message templates (Twilio Content API)");
+  waTemplate.command("list").description("List WhatsApp message templates").option("--connection-id <id>", "Filter by messaging connection ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus channel whatsapp-template list
+  $ nexus channel whatsapp-template list --connection-id abc --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.listWhatsAppTemplates({
+        connectionId: opts.connectionId
+      });
+      const data = result?.data ?? result;
+      printTable(Array.isArray(data) ? data : [data], [
+        { key: "id", label: "ID", width: 38 },
+        { key: "friendly_name", label: "FRIENDLY NAME", width: 25 },
+        { key: "language", label: "LANG", width: 8 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  waTemplate.command("get").description("Get WhatsApp template details").argument("<templateId>", "Template ID (Twilio SID)").action(async (templateId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.getWhatsAppTemplate(templateId);
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "id", label: "ID" },
+        { key: "friendly_name", label: "Friendly Name" },
+        { key: "language", label: "Language" },
+        { key: "types", label: "Types" },
+        { key: "variables", label: "Variables" },
+        { key: "created_at", label: "Created At" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  waTemplate.command("create").description("Create a WhatsApp message template").requiredOption("--connection-id <id>", "Messaging connection ID").requiredOption("--friendly-name <name>", "Template name (e.g., order_confirmation)").requiredOption("--language <lang>", "Language code (e.g., en, en_US)").option("--body <text>", "Template body text (auto-wraps as twilio/text type)").option("--body-file <path>", "Path to JSON file with full Twilio Types object").option("--type <type>", "Twilio type key when using --body", "twilio/text").option("--variables <json>", `Template variables as JSON (e.g., '{"1":"default"}')`).option("--submit", "Also submit for Meta approval after creation").option(
+    "--category <category>",
+    "Approval category (required with --submit): UTILITY, MARKETING, AUTHENTICATION"
+  ).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus channel whatsapp-template create --connection-id abc --friendly-name welcome --language en --body "Hello {{1}}, welcome!"
+  $ nexus channel whatsapp-template create --connection-id abc --friendly-name promo --language en --body-file template.json
+  $ nexus channel whatsapp-template create --connection-id abc --friendly-name order --language en --body "Order {{1}} confirmed" --submit --category UTILITY`
+  ).action(async (opts) => {
+    try {
+      if (!opts.body && !opts.bodyFile) {
+        console.error("Error: Either --body or --body-file is required.");
+        process.exitCode = 1;
+        return;
+      }
+      if (opts.body && opts.bodyFile) {
+        console.error("Error: Cannot use both --body and --body-file.");
+        process.exitCode = 1;
+        return;
+      }
+      if (opts.submit && !opts.category) {
+        console.error("Error: --category is required when using --submit.");
+        process.exitCode = 1;
+        return;
+      }
+      let types;
+      if (opts.bodyFile) {
+        try {
+          const content = (0, import_node_fs2.readFileSync)(opts.bodyFile, "utf-8");
+          types = JSON.parse(content);
+        } catch (e) {
+          console.error(
+            `Error reading --body-file: ${e instanceof Error ? e.message : String(e)}`
+          );
+          process.exitCode = 1;
+          return;
+        }
+      } else {
+        types = { [opts.type]: { body: opts.body } };
+      }
+      let variables;
+      if (opts.variables) {
+        try {
+          variables = JSON.parse(opts.variables);
+        } catch {
+          console.error("Error: --variables must be valid JSON.");
+          process.exitCode = 1;
+          return;
+        }
+      }
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.createWhatsAppTemplate({
+        connectionId: opts.connectionId,
+        friendlyName: opts.friendlyName,
+        language: opts.language,
+        types,
+        variables
+      });
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "id", label: "ID" },
+        { key: "friendly_name", label: "Friendly Name" },
+        { key: "language", label: "Language" },
+        { key: "created_at", label: "Created At" }
+      ]);
+      printSuccess("WhatsApp template created.");
+      if (opts.submit) {
+        console.log("");
+        console.log("Submitting for Meta approval...");
+        const approval = await client.channels.submitTemplateApproval({
+          connectionId: opts.connectionId,
+          templateId: data.id,
+          name: opts.friendlyName,
+          category: opts.category
+        });
+        const approvalData = approval?.data ?? approval;
+        printRecord(approvalData, [
+          { key: "sid", label: "Approval SID" },
+          { key: "status", label: "Status" }
+        ]);
+        printSuccess("Template submitted for Meta approval.");
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  waTemplate.command("delete").description("Delete a WhatsApp template").argument("<templateId>", "Template ID (Twilio SID)").option("--yes", "Skip confirmation prompt").action(async (templateId, opts) => {
+    try {
+      if (!opts.yes && process.stdin.isTTY) {
+        const readline2 = await import("readline");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await new Promise((resolve) => {
+          rl.question(`Delete template ${templateId}? (y/N) `, resolve);
+        });
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Cancelled.");
+          return;
+        }
+      }
+      const client = createClient(program2.optsWithGlobals());
+      await client.channels.deleteWhatsAppTemplate(templateId);
+      printSuccess("WhatsApp template deleted.", { id: templateId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  waTemplate.command("approvals").description("List template approval status from Meta").option("--connection-id <id>", "Filter by messaging connection ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus channel whatsapp-template approvals
+  $ nexus channel whatsapp-template approvals --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.listTemplateApprovals({
+        connectionId: opts.connectionId
+      });
+      const data = result?.data ?? result;
+      const items = Array.isArray(data) ? data : [data];
+      const rows = items.map((item) => ({
+        sid: item.sid,
+        name: item.approvalRequests?.name ?? "",
+        category: item.approvalRequests?.category ?? "",
+        status: item.approvalRequests?.status ?? "",
+        rejection_reason: item.approvalRequests?.rejection_reason ?? ""
+      }));
+      printTable(rows, [
+        { key: "sid", label: "SID", width: 38 },
+        { key: "name", label: "NAME", width: 20 },
+        { key: "category", label: "CATEGORY", width: 15 },
+        { key: "status", label: "STATUS", width: 12 },
+        { key: "rejection_reason", label: "REJECTION REASON", width: 30 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  waTemplate.command("submit-approval").description("Submit a template for Meta WhatsApp approval").requiredOption("--connection-id <id>", "Messaging connection ID").requiredOption("--template-id <id>", "Template ID (Twilio SID)").requiredOption("--name <name>", "Template name for approval").requiredOption(
+    "--category <category>",
+    "Approval category: UTILITY, MARKETING, or AUTHENTICATION"
+  ).option("--wait", "Poll approval status until resolved (up to 2 minutes)").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus channel whatsapp-template submit-approval --connection-id abc --template-id HX123 --name welcome --category UTILITY
+  $ nexus channel whatsapp-template submit-approval --connection-id abc --template-id HX123 --name promo --category MARKETING --wait`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.submitTemplateApproval({
+        connectionId: opts.connectionId,
+        templateId: opts.templateId,
+        name: opts.name,
+        category: opts.category
+      });
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "sid", label: "Approval SID" },
+        { key: "status", label: "Status" }
+      ]);
+      printSuccess("Template submitted for Meta approval.");
+      if (opts.wait) {
+        const maxWaitMs = 12e4;
+        const intervalMs = 5e3;
+        const startTime = Date.now();
+        let finalStatus = data.status;
+        console.log("Waiting for approval...");
+        while (Date.now() - startTime < maxWaitMs) {
+          await new Promise((r) => setTimeout(r, intervalMs));
+          const approvals = await client.channels.listTemplateApprovals({
+            connectionId: opts.connectionId
+          });
+          const approvalsData = approvals?.data ?? approvals;
+          const items = Array.isArray(approvalsData) ? approvalsData : [approvalsData];
+          const match = items.find((a) => a.sid === opts.templateId);
+          if (match?.approvalRequests?.status) {
+            finalStatus = match.approvalRequests.status;
+            if (finalStatus !== "pending" && finalStatus !== "unsubmitted") {
+              console.log(`Approval resolved: ${color.cyan(finalStatus)}`);
+              if (finalStatus === "rejected" && match.approvalRequests.rejection_reason) {
+                console.log(`Reason: ${match.approvalRequests.rejection_reason}`);
+              }
+              break;
+            }
+          }
+        }
+        if (finalStatus === "pending" || finalStatus === "unsubmitted") {
+          console.log(
+            `Still ${finalStatus} after 2m. Check again: ${color.dim("nexus channel whatsapp-template approvals")}`
+          );
+        }
+      }
+      console.log(
+        `
+Next: Attach to deployment: ${color.dim("nexus deployment template attach <depId> --template-id ...")}`
+      );
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
 }
 
 // src/commands/collection.ts
@@ -4398,6 +4768,171 @@ Examples:
       process.exitCode = handleError(err);
     }
   });
+  const depTemplate = deployment.command("template").description("Manage WhatsApp templates attached to a deployment");
+  depTemplate.command("list").description("List templates attached to a WhatsApp deployment").argument("<deploymentId>", "Deployment ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment template list dep-123
+  $ nexus deployment template list dep-123 --json`
+  ).action(async (deploymentId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.deployments.listDeploymentTemplates(deploymentId);
+      const data = result?.data ?? result;
+      const items = Array.isArray(data) ? data : [data];
+      const rows = items.map((t) => ({
+        templateId: t.templateId,
+        name: t.name,
+        type: t.type ?? "template",
+        variables: Object.keys(t.variables ?? {}).length,
+        multiLang: t.enableMultiLanguage ? "yes" : "no"
+      }));
+      printTable(rows, [
+        { key: "templateId", label: "TEMPLATE ID", width: 38 },
+        { key: "name", label: "NAME", width: 20 },
+        { key: "type", label: "TYPE", width: 10 },
+        { key: "variables", label: "VARS", width: 6 },
+        { key: "multiLang", label: "MULTI-LANG", width: 10 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  depTemplate.command("attach").description("Attach a WhatsApp template to a deployment").argument("<deploymentId>", "Deployment ID").requiredOption("--template-id <id>", "Template ID (Twilio SID)").requiredOption("--name <name>", "Display name for this template").requiredOption("--description <text>", "Description of what this template does").option("--variables <json>", 'Variables JSON: {"1":{"description":"Name","isBodyVariable":true}}').option("--type <type>", "Template type: template, card, or carousel", "template").option("--enable-multi-language", "Enable multi-language support").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment template attach dep-123 --template-id HX456 --name welcome --description "Welcome message"
+  $ nexus deployment template attach dep-123 --template-id HX456 --name order --description "Order confirmation" --variables '{"1":{"description":"Customer name","isBodyVariable":true}}'`
+  ).action(async (deploymentId, opts) => {
+    try {
+      let variables;
+      if (opts.variables) {
+        try {
+          variables = JSON.parse(opts.variables);
+        } catch {
+          console.error("Error: --variables must be valid JSON.");
+          process.exitCode = 1;
+          return;
+        }
+      }
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.deployments.attachDeploymentTemplate(deploymentId, {
+        templateId: opts.templateId,
+        name: opts.name,
+        description: opts.description,
+        variables,
+        type: opts.type,
+        enableMultiLanguage: opts.enableMultiLanguage
+      });
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "templateId", label: "Template ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" },
+        { key: "type", label: "Type" }
+      ]);
+      printSuccess("Template attached to deployment.");
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  depTemplate.command("update").description("Update a template's configuration on a deployment").argument("<deploymentId>", "Deployment ID").argument("<templateId>", "Template ID (Twilio SID)").option("--name <name>", "New display name").option("--description <text>", "New description").option("--variables <json>", "Updated variables JSON").option("--enable-multi-language", "Enable multi-language support").option("--no-multi-language", "Disable multi-language support").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment template update dep-123 HX456 --name "Updated Welcome"
+  $ nexus deployment template update dep-123 HX456 --variables '{"1":{"description":"Full name"}}'`
+  ).action(async (deploymentId, templateId, opts) => {
+    try {
+      const body = {};
+      if (opts.name !== void 0) body.name = opts.name;
+      if (opts.description !== void 0) body.description = opts.description;
+      if (opts.enableMultiLanguage !== void 0)
+        body.enableMultiLanguage = opts.enableMultiLanguage;
+      if (opts.variables) {
+        try {
+          body.variables = JSON.parse(opts.variables);
+        } catch {
+          console.error("Error: --variables must be valid JSON.");
+          process.exitCode = 1;
+          return;
+        }
+      }
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.deployments.updateDeploymentTemplate(
+        deploymentId,
+        templateId,
+        body
+      );
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "templateId", label: "Template ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" }
+      ]);
+      printSuccess("Deployment template updated.");
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  depTemplate.command("detach").description("Detach a template from a deployment").argument("<deploymentId>", "Deployment ID").argument("<templateId>", "Template ID (Twilio SID)").option("--yes", "Skip confirmation prompt").action(async (deploymentId, templateId, opts) => {
+    try {
+      if (!opts.yes && process.stdin.isTTY) {
+        const readline2 = await import("readline");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await new Promise((resolve) => {
+          rl.question(`Detach template ${templateId} from deployment ${deploymentId}? (y/N) `, resolve);
+        });
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Cancelled.");
+          return;
+        }
+      }
+      const client = createClient(program2.optsWithGlobals());
+      await client.deployments.detachDeploymentTemplate(deploymentId, templateId);
+      printSuccess("Template detached from deployment.", { templateId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  depTemplate.command("settings").description("View or update deployment template settings").argument("<deploymentId>", "Deployment ID").option(
+    "--allow-dynamic-templates <bool>",
+    "Allow agent to dynamically create and send templates (true/false)"
+  ).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment template settings dep-123
+  $ nexus deployment template settings dep-123 --allow-dynamic-templates true`
+  ).action(async (deploymentId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (opts.allowDynamicTemplates !== void 0) {
+        const value = opts.allowDynamicTemplates === "true";
+        await client.deployments.updateDeploymentTemplateSettings(deploymentId, {
+          allowAgentToCreateAndSendTemplates: value
+        });
+        printSuccess(
+          `Dynamic template creation ${value ? "enabled" : "disabled"} for deployment.`
+        );
+      } else {
+        const result = await client.deployments.listDeploymentTemplates(deploymentId);
+        const data = result?.data ?? result;
+        console.log(`Templates attached: ${Array.isArray(data) ? data.length : 0}`);
+        console.log(
+          `Tip: Use --allow-dynamic-templates true/false to toggle agent template creation.`
+        );
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
 }
 
 // src/docs-content.generated.ts
@@ -4877,6 +5412,7 @@ All commands follow the pattern: \`nexus <group> <action> [arguments] [options]\
 | [\`eval\`](docs/command-reference.md#nexus-eval)                         | (subgroups: \`session\`, \`dataset\`, \`execute\`, \`judge\`, \`results\`, \`formats\`, \`judges\`) | AI task evaluation         |
 | [\`ticket\`](docs/command-reference.md#nexus-ticket)                     | \`list\` \`get\` \`create\` \`update\` \`comment\` \`comments\`                                   | Bug and feature tracking   |
 | [\`phone-number\`](docs/command-reference.md#nexus-phone-number)         | \`search\` \`buy\` \`list\` \`get\` \`release\`                                                 | Phone number management    |
+| [\`channel\`](docs/command-reference.md#nexus-channel)                   | \`setup\` \`connection list\\|create\` \`whatsapp-sender list\\|create\\|get\`                 | Channel setup orchestrator |
 | [\`prompt-assistant\`](docs/command-reference.md#nexus-prompt-assistant) | \`chat\` \`get-thread\` \`delete-thread\`                                                   | AI-assisted prompt writing |
 
 ### Utility
@@ -5007,6 +5543,9 @@ Every CLI command maps to an SDK method. Use the SDK (\`@agent-nexus/sdk\`) when
 | \`nexus model list\`                      | \`client.models.list()\`                                |
 | \`nexus ticket create --title X ...\`     | \`client.tickets.create({ title: "X", ... })\`          |
 | \`nexus phone-number list\`               | \`client.phoneNumbers.list()\`                          |
+| \`nexus channel setup --type WHATSAPP\`   | \`client.channels.getSetupStatus("WHATSAPP")\`          |
+| \`nexus channel connection create\`       | \`client.channels.createConnection()\`                  |
+| \`nexus channel whatsapp-sender create\`  | \`client.channels.createWhatsAppSender({ ... })\`       |
 
 > **Full SDK documentation:** See [@agent-nexus/sdk README](../sdk/README.md)
 
@@ -5901,12 +6440,12 @@ List deployments.
 nexus deployment list [options]
 \`\`\`
 
-| Option             | Description                                   |
-| ------------------ | --------------------------------------------- |
-| \`--agent-id <id>\`  | Filter by agent ID                            |
-| \`--type <type>\`    | Filter by type (\`CHAT\`, \`API\`, \`PHONE\`, etc.) |
-| \`--page <number>\`  | Page number                                   |
-| \`--limit <number>\` | Items per page                                |
+| Option             | Description                                                     |
+| ------------------ | --------------------------------------------------------------- |
+| \`--agent-id <id>\`  | Filter by agent ID                                              |
+| \`--type <type>\`    | Filter by type (\`EMBED\`, \`API\`, \`WHATSAPP\`, \`TWILIO_SMS\`, etc.) |
+| \`--page <number>\`  | Page number                                                     |
+| \`--limit <number>\` | Items per page                                                  |
 
 \`\`\`bash
 nexus deployment list
@@ -5943,21 +6482,31 @@ Create a new deployment.
 nexus deployment create [options]
 \`\`\`
 
-| Option                 | Required | Description                                          |
-| ---------------------- | -------- | ---------------------------------------------------- |
-| \`--agent-id <id>\`      | Yes      | Agent ID                                             |
-| \`--name <name>\`        | Yes      | Deployment name                                      |
-| \`--type <type>\`        | Yes      | Deployment type (\`CHAT\`, \`API\`, \`PHONE\`, etc.)       |
-| \`--description <text>\` | No       | Deployment description                               |
-| \`--body <json>\`        | No       | Request body as JSON, \`.json\` file, or \`-\` for stdin |
+| Option                 | Required | Description                                                                                                                 |
+| ---------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
+| \`--name <name>\`        | Yes      | Deployment name                                                                                                             |
+| \`--type <type>\`        | Yes      | Deployment type: \`EMBED\`, \`API\`, \`WHATSAPP\`, \`TWILIO_SMS\`, \`TWILIO_VOICE\`, \`TELEGRAM\`, \`SLACK\`, \`GMAIL\`, \`OUTLOOK\`, \`TEAMS\` |
+| \`--agent-id <id>\`      | No       | Agent ID                                                                                                                    |
+| \`--description <text>\` | No       | Deployment description                                                                                                      |
+| \`--body <json>\`        | No       | Request body as JSON, \`.json\` file, or \`-\` for stdin                                                                        |
+
+**Important:** Channel deployments (WhatsApp, SMS, Voice, etc.) have prerequisites. Run \`nexus channel setup --type <TYPE>\` first to see what's needed.
 
 \`\`\`bash
-nexus deployment create --agent-id agt-123 --name "Website Chat" --type CHAT
-nexus deployment create --agent-id agt-123 --name "Support API" --type API
-nexus deployment create --body '{"agentId":"agt-123","name":"Chat","type":"CHAT"}'
+# Simple deployments (no prerequisites)
+nexus deployment create --name "Website Chat" --type EMBED --agent-id agt-123
+nexus deployment create --name "Support API" --type API --agent-id agt-123
+
+# Channel deployments (require connection + phone + optional sender)
+# First check prerequisites:
+nexus channel setup --type WHATSAPP
+
+# Then create with connection fields via --body:
+nexus deployment create --name "WhatsApp Support" --type WHATSAPP --agent-id agt-123 \\
+  --body '{"phoneNumberId":"phn-456","apiKeyConnectionId":"conn-789"}'
 \`\`\`
 
-**SDK equivalent:** \`client.deployments.create({ agentId, name, type, ... })\`
+**SDK equivalent:** \`client.deployments.create({ name, type, agentId, phoneNumberId, apiKeyConnectionId, ... })\`
 
 ### deployment update
 
@@ -8643,9 +9192,142 @@ nexus model list --search "gpt-4"
 
 ---
 
+## nexus channel
+
+Set up deployment channels: connections, phone numbers, and WhatsApp senders. Use \`nexus channel setup\` to see what's needed before creating any non-EMBED/API deployment.
+
+### channel setup
+
+Check or auto-provision channel setup prerequisites. Returns a step-by-step checklist.
+
+\`\`\`
+nexus channel setup [options]
+\`\`\`
+
+| Option              | Required | Description                                                         |
+| ------------------- | -------- | ------------------------------------------------------------------- |
+| \`--type <type>\`     | Yes      | Deployment type (\`WHATSAPP\`, \`TWILIO_SMS\`, \`TWILIO_VOICE\`, etc.)    |
+| \`--auto\`            | No       | Auto-provision what is possible (e.g., create messaging connection) |
+| \`--region <region>\` | No       | Region for auto-provisioning: \`us1\` or \`ie1\` (default: \`us1\`)       |
+
+\`\`\`bash
+nexus channel setup --type WHATSAPP
+nexus channel setup --type WHATSAPP --auto
+nexus channel setup --type TWILIO_SMS --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.getSetupStatus(type)\` / \`client.channels.autoProvision({ type, region })\`
+
+### channel connect-waba
+
+Open the browser to connect your WhatsApp Business Account via Meta's Embedded Signup. This step **requires a browser** and cannot be done via API.
+
+\`\`\`
+nexus channel connect-waba
+\`\`\`
+
+Opens \`{NEXUS_DASHBOARD_URL}/app/connect-waba\` in your default browser \u2014 a dedicated page with a single "Connect with Meta" button. Complete the flow, then verify with \`nexus channel setup --type WHATSAPP\`.
+
+\`\`\`bash
+nexus channel connect-waba
+\`\`\`
+
+**SDK equivalent:** N/A (browser-only step)
+
+### channel connection list
+
+List messaging connections for the organization.
+
+\`\`\`
+nexus channel connection list
+\`\`\`
+
+\`\`\`bash
+nexus channel connection list --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.listConnections()\`
+
+### channel connection create
+
+Create a messaging connection (max 1 per organization via the API).
+
+\`\`\`
+nexus channel connection create [options]
+\`\`\`
+
+| Option              | Description                             |
+| ------------------- | --------------------------------------- |
+| \`--region <region>\` | Region: \`us1\` or \`ie1\` (default: \`us1\`) |
+
+\`\`\`bash
+nexus channel connection create
+nexus channel connection create --region ie1 --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.createConnection({ region })\`
+
+### channel whatsapp-sender list
+
+List WhatsApp senders for the organization.
+
+\`\`\`
+nexus channel whatsapp-sender list
+\`\`\`
+
+\`\`\`bash
+nexus channel whatsapp-sender list --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.listWhatsAppSenders()\`
+
+### channel whatsapp-sender create
+
+Create a WhatsApp sender (registers a phone number with WhatsApp Business via Meta).
+
+\`\`\`
+nexus channel whatsapp-sender create [options]
+\`\`\`
+
+| Option                   | Required | Description                                                     |
+| ------------------------ | -------- | --------------------------------------------------------------- |
+| \`--connection-id <id>\`   | Yes      | Messaging connection ID                                         |
+| \`--phone-number-id <id>\` | Yes      | Phone number ID                                                 |
+| \`--sender-name <name>\`   | Yes      | Display name for the WhatsApp sender                            |
+| \`--waba-id <id>\`         | No       | WhatsApp Business Account ID (reads from connection if omitted) |
+
+\`\`\`bash
+nexus channel whatsapp-sender create \\
+  --connection-id conn-123 \\
+  --phone-number-id phn-456 \\
+  --sender-name "My Business"
+\`\`\`
+
+**SDK equivalent:** \`client.channels.createWhatsAppSender({ connectionId, phoneNumberId, senderName, wabaId })\`
+
+### channel whatsapp-sender get
+
+Get WhatsApp sender details including status.
+
+\`\`\`
+nexus channel whatsapp-sender get <id>
+\`\`\`
+
+| Argument | Description |
+| -------- | ----------- |
+| \`id\`     | Sender ID   |
+
+\`\`\`bash
+nexus channel whatsapp-sender get sender-123 --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.getWhatsAppSender(id)\`
+
+---
+
 ## nexus phone-number
 
-Manage phone numbers for voice deployments.
+Manage phone numbers for SMS, Voice, and WhatsApp deployments.
 
 ### phone-number search
 
@@ -9718,34 +10400,46 @@ Deploy the same agent to multiple channels and monitor analytics.
 # 1. Create an agent (or use an existing one)
 AGENT_ID="your-agent-id"
 
-# 2. Deploy to web widget
+# 2. Deploy to web widget (no prerequisites)
 WEB_DEP=$(nexus deployment create \\
   --name "Website Widget" \\
-  --type web \\
+  --type EMBED \\
   --agent-id $AGENT_ID \\
   --json | jq -r '.id')
 
-# 3. Deploy to WhatsApp
+# 3. Deploy to WhatsApp (requires channel setup first!)
+# Check what's needed:
+nexus channel setup --type WHATSAPP
+
+# Auto-provision messaging connection:
+nexus channel setup --type WHATSAPP --auto
+
+# Buy a phone number:
+nexus phone-number search --country US --sms
+nexus phone-number buy --phone-number "+12025551234" --country US --price 1.15
+
+# Create WhatsApp sender (register with Meta):
+CONN_ID=$(nexus channel connection list --json | jq -r '.[0].id')
+PHONE_ID=$(nexus phone-number list --json | jq -r '.[0].id')
+nexus channel whatsapp-sender create \\
+  --connection-id $CONN_ID \\
+  --phone-number-id $PHONE_ID \\
+  --sender-name "My Business"
+
+# Now create the WhatsApp deployment:
 WA_DEP=$(nexus deployment create \\
   --name "WhatsApp Support" \\
-  --type whatsapp \\
+  --type WHATSAPP \\
   --agent-id $AGENT_ID \\
+  --body "{\\"phoneNumberId\\":\\"$PHONE_ID\\",\\"apiKeyConnectionId\\":\\"$CONN_ID\\"}" \\
   --json | jq -r '.id')
 
-# 4. Deploy to Slack
-SLACK_DEP=$(nexus deployment create \\
-  --name "Slack Bot" \\
-  --type slack \\
-  --agent-id $AGENT_ID \\
-  --json | jq -r '.id')
-
-# 5. Organize deployments in a folder
+# 4. Organize deployments in a folder
 FOLDER_ID=$(nexus deployment folder create --name "Production" --json | jq -r '.id')
 nexus deployment folder assign --deployment-id $WEB_DEP --folder-id $FOLDER_ID
 nexus deployment folder assign --deployment-id $WA_DEP --folder-id $FOLDER_ID
-nexus deployment folder assign --deployment-id $SLACK_DEP --folder-id $FOLDER_ID
 
-# 6. Get the web widget embed configuration
+# 5. Get the web widget embed configuration
 nexus deployment embed-config $WEB_DEP
 
 # 7. Customize the widget
@@ -10070,7 +10764,7 @@ ${"\u2550".repeat(72)}`);
 }
 
 // src/commands/document.ts
-var import_node_fs2 = __toESM(require("fs"));
+var import_node_fs3 = __toESM(require("fs"));
 var import_node_path2 = __toESM(require("path"));
 init_output();
 function registerDocumentCommands(program2) {
@@ -10136,12 +10830,12 @@ Examples:
     try {
       const client = createClient(program2.optsWithGlobals());
       const absPath = import_node_path2.default.resolve(filePath);
-      if (!import_node_fs2.default.existsSync(absPath)) {
+      if (!import_node_fs3.default.existsSync(absPath)) {
         console.error(`Error: File not found: ${absPath}`);
         process.exitCode = 1;
         return;
       }
-      const buffer = import_node_fs2.default.readFileSync(absPath);
+      const buffer = import_node_fs3.default.readFileSync(absPath);
       const blob = new Blob([buffer]);
       const fileName = import_node_path2.default.basename(absPath);
       const doc = await client.documents.uploadFile(blob, fileName, opts.description);
@@ -10780,8 +11474,8 @@ Examples:
   ).action(async (id) => {
     try {
       const client = createClient(program2.optsWithGlobals());
-      const exec2 = await client.workflowExecutions.get(id);
-      printRecord(exec2, [
+      const exec3 = await client.workflowExecutions.get(id);
+      printRecord(exec3, [
         { key: "id", label: "ID" },
         { key: "workflowId", label: "Workflow" },
         { key: "status", label: "Status" },
@@ -11439,7 +12133,7 @@ Notes:
 }
 
 // src/commands/template.ts
-var import_node_fs3 = __toESM(require("fs"));
+var import_node_fs4 = __toESM(require("fs"));
 var import_node_path3 = __toESM(require("path"));
 init_output();
 function registerTemplateCommands(program2) {
@@ -11525,12 +12219,12 @@ Examples:
     try {
       const client = createClient(program2.optsWithGlobals());
       const absPath = import_node_path3.default.resolve(opts.file);
-      if (!import_node_fs3.default.existsSync(absPath)) {
+      if (!import_node_fs4.default.existsSync(absPath)) {
         console.error(`Error: File not found: ${absPath}`);
         process.exitCode = 1;
         return;
       }
-      const buffer = import_node_fs3.default.readFileSync(absPath);
+      const buffer = import_node_fs4.default.readFileSync(absPath);
       const blob = new Blob([buffer]);
       const fileName = import_node_path3.default.basename(absPath);
       const result = await client.skills.uploadDocumentTemplateFile(id, blob, fileName);
@@ -11844,14 +12538,14 @@ Examples:
 }
 
 // src/commands/upgrade.ts
-var import_node_child_process2 = require("child_process");
+var import_node_child_process3 = require("child_process");
 init_output();
 
 // src/util/package-manager.ts
-var import_node_fs4 = __toESM(require("fs"));
+var import_node_fs5 = __toESM(require("fs"));
 function detectPackageManager() {
   try {
-    const resolved = import_node_fs4.default.realpathSync(process.argv[1]).replace(/\\/g, "/");
+    const resolved = import_node_fs5.default.realpathSync(process.argv[1]).replace(/\\/g, "/");
     if (/[/]\.?pnpm[/]/.test(resolved)) return "pnpm";
     if (/[/]\.yarn[/]/.test(resolved)) return "yarn";
   } catch {
@@ -11882,7 +12576,7 @@ function getGlobalUpdateHint(pkg) {
 }
 
 // src/util/version-check.ts
-var import_node_fs5 = __toESM(require("fs"));
+var import_node_fs6 = __toESM(require("fs"));
 var import_node_os2 = __toESM(require("os"));
 var import_node_path4 = __toESM(require("path"));
 var PACKAGE_NAME = "@agent-nexus/cli";
@@ -11891,7 +12585,7 @@ var FETCH_TIMEOUT_MS = 3e3;
 var CACHE_FILE = import_node_path4.default.join(import_node_os2.default.homedir(), ".nexus-mcp", "version-check.json");
 function loadCache() {
   try {
-    return JSON.parse(import_node_fs5.default.readFileSync(CACHE_FILE, "utf-8"));
+    return JSON.parse(import_node_fs6.default.readFileSync(CACHE_FILE, "utf-8"));
   } catch {
     return null;
   }
@@ -11899,8 +12593,8 @@ function loadCache() {
 function saveCache(cache) {
   try {
     const dir = import_node_path4.default.dirname(CACHE_FILE);
-    import_node_fs5.default.mkdirSync(dir, { recursive: true, mode: 448 });
-    import_node_fs5.default.writeFileSync(CACHE_FILE, JSON.stringify(cache), { mode: 384 });
+    import_node_fs6.default.mkdirSync(dir, { recursive: true, mode: 448 });
+    import_node_fs6.default.writeFileSync(CACHE_FILE, JSON.stringify(cache), { mode: 384 });
   } catch {
   }
 }
@@ -11987,11 +12681,29 @@ async function autoUpdate(currentVersion) {
 
 // src/commands/upgrade.ts
 var PACKAGE_NAME2 = "@agent-nexus/cli";
+var UPGRADE_ALIASES = [
+  "update",
+  "latest",
+  "up",
+  "install",
+  "reinstall",
+  "refresh",
+  "fetch",
+  "pull",
+  "sync",
+  "get",
+  "download",
+  "self-update",
+  "selfupdate",
+  "self-upgrade",
+  "selfupgrade",
+  "new",
+  "patch",
+  "bump"
+];
 function registerUpgradeCommand(program2) {
   const currentVersion = require_package().version;
-  program2.command("upgrade").description("Upgrade the Nexus CLI to the latest version").addHelpText("after", `
-Examples:
-  $ nexus upgrade`).action(async () => {
+  const upgradeAction = async () => {
     process.stderr.write(`Current version: ${color.cyan(currentVersion)}
 `);
     process.stderr.write("Checking for updates\u2026\n");
@@ -12009,7 +12721,7 @@ Examples:
 `);
     try {
       const installCmd = getGlobalInstallCommand(PACKAGE_NAME2);
-      (0, import_node_child_process2.execSync)(installCmd, { stdio: "inherit" });
+      (0, import_node_child_process3.execSync)(installCmd, { stdio: "inherit" });
       printSuccess(`Successfully upgraded to ${latest}.`, { from: currentVersion, to: latest });
     } catch {
       const fallbackCmd = getGlobalInstallCommand(PACKAGE_NAME2);
@@ -12021,7 +12733,13 @@ Upgrade failed. Try running manually:
       );
       process.exitCode = 1;
     }
-  });
+  };
+  program2.command("upgrade").description("Upgrade the Nexus CLI to the latest version").addHelpText("after", `
+Examples:
+  $ nexus upgrade`).action(upgradeAction);
+  for (const alias of UPGRADE_ALIASES) {
+    program2.command(alias, { hidden: true }).action(upgradeAction);
+  }
 }
 
 // src/commands/version.ts
@@ -12806,7 +13524,7 @@ Examples:
 // src/index.ts
 init_output();
 var { version: VERSION } = require_package();
-var program = new import_commander.Command().name("nexus").description("Official CLI for the Nexus AI agent platform").version(VERSION, "-v, --version").option("--json", "Output as JSON").option("--api-key <key>", "Override API key for this invocation").option("--base-url <url>", "Override API base URL").option("--profile <name>", "Use a specific named profile").option("--no-auto-update", "Disable automatic updates when a new version is detected").hook("preAction", (thisCommand) => {
+var program = new import_commander.Command().name("nexus").description("Official CLI for the Nexus AI agent platform").version(VERSION, "-v, --version").option("--json", "Output as JSON").option("--api-key <key>", "Override API key for this invocation").option("--base-url <url>", "Override API base URL").option("--dashboard-url <url>", "Override dashboard URL (for browser links)").option("--profile <name>", "Use a specific named profile").option("--no-auto-update", "Disable automatic updates when a new version is detected").hook("preAction", (thisCommand) => {
   const opts = thisCommand.optsWithGlobals();
   if (opts.json) setJsonMode(true);
   const cmdName = thisCommand.name();
@@ -12822,7 +13540,8 @@ var program = new import_commander.Command().name("nexus").description("Official
     "pin",
     "unpin",
     "status",
-    "docs"
+    "docs",
+    ...UPGRADE_ALIASES
   ].includes(cmdName);
   if (!skipBanner && !isJsonMode()) {
     try {
@@ -12875,7 +13594,7 @@ if (process.argv.length <= 2) {
 program.parseAsync(process.argv).then(async () => {
   if (isJsonMode()) return;
   const ranCommand = process.argv[2];
-  if (ranCommand === "upgrade") return;
+  if (ranCommand === "upgrade" || UPGRADE_ALIASES.includes(ranCommand)) return;
   const opts = program.opts();
   if (opts.autoUpdate) {
     const msg = await autoUpdate(VERSION);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-nexus/cli",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Official CLI for the Nexus AI agent platform.",
   "license": "MIT",
   "keywords": [
@@ -35,7 +35,7 @@
     "@types/node": "24.6.2",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "@agent-nexus/sdk": "0.1.9"
+    "@agent-nexus/sdk": "0.1.13"
   },
   "scripts": {
     "gen:docs": "tsx scripts/bundle-docs.ts",