@agent-nexus/cli 0.1.11 → 0.1.12

package/README.md

@@ -470,7 +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 |
+| [`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

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.11",
+      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 } : {}
     });
@@ -3570,6 +3661,7 @@ 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;
@@ -3578,7 +3670,10 @@ function openUrl2(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:
@@ -3622,8 +3717,8 @@ Examples:
   $ nexus channel connect-waba`
   ).action(async () => {
     try {
-      const dashboardUrl = process.env.NEXUS_DASHBOARD_URL ?? "https://gpt.nexus";
-      const url = `${dashboardUrl}/app/settings/phone-number`;
+      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:');
@@ -3727,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
@@ -4426,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
@@ -4905,7 +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 |
+| [\`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
@@ -5933,12 +6440,12 @@ List deployments.
 nexus deployment list [options]
 \`\`\`
 
-| Option             | Description                                   |
-| ------------------ | --------------------------------------------- |
-| \`--agent-id <id>\`  | Filter by agent ID                            |
+| 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                                |
+| \`--page <number>\`  | Page number                                                     |
+| \`--limit <number>\` | Items per page                                                  |
 
 \`\`\`bash
 nexus deployment list
@@ -5975,13 +6482,13 @@ Create a new deployment.
 nexus deployment create [options]
 \`\`\`
 
-| Option                 | Required | Description                                                                 |
-| ---------------------- | -------- | --------------------------------------------------------------------------- |
-| \`--name <name>\`        | Yes      | Deployment name                                                             |
+| 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                        |
+| \`--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.
 
@@ -8697,11 +9204,11 @@ Check or auto-provision channel setup prerequisites. Returns a step-by-step chec
 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\`)   |
+| 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
@@ -8719,7 +9226,7 @@ Open the browser to connect your WhatsApp Business Account via Meta's Embedded S
 nexus channel connect-waba
 \`\`\`
 
-Opens \`{NEXUS_DASHBOARD_URL}/app/settings/phone-number\` in your default browser. Complete the "Connect with Meta" flow, then verify with \`nexus channel setup --type WHATSAPP\`.
+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
@@ -8749,8 +9256,8 @@ Create a messaging connection (max 1 per organization via the API).
 nexus channel connection create [options]
 \`\`\`
 
-| Option             | Description                     |
-| ------------------ | ------------------------------- |
+| Option              | Description                             |
+| ------------------- | --------------------------------------- |
 | \`--region <region>\` | Region: \`us1\` or \`ie1\` (default: \`us1\`) |
 
 \`\`\`bash
@@ -8782,12 +9289,12 @@ Create a WhatsApp sender (registers a phone number with WhatsApp Business via Me
 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) |
+| 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 \\
@@ -10257,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) {
@@ -10323,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);
@@ -11626,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) {
@@ -11712,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);
@@ -12035,10 +12542,10 @@ 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 {
@@ -12069,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";
@@ -12078,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;
   }
@@ -12086,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 {
   }
 }
@@ -12174,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");
@@ -12208,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
@@ -12993,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();
@@ -13009,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 {
@@ -13062,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.11",
+  "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.10"
+    "@agent-nexus/sdk": "0.1.13"
   },
   "scripts": {
     "gen:docs": "tsx scripts/bundle-docs.ts",