@agent-nexus/cli 0.1.10 → 0.1.11

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.11",
       description: "Official CLI for the Nexus AI agent platform.",
       license: "MIT",
       keywords: [
@@ -3569,7 +3569,13 @@ function openUrl(url) {
 }
 
 // src/commands/channel.ts
+var import_node_child_process2 = require("child_process");
 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(
@@ -3605,6 +3611,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 = process.env.NEXUS_DASHBOARD_URL ?? "https://gpt.nexus";
+      const url = `${dashboardUrl}/app/settings/phone-number`;
+      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 {
@@ -4877,6 +4905,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 +5036,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)
 
@@ -5904,7 +5936,7 @@ nexus deployment list [options]
 | Option             | Description                                   |
 | ------------------ | --------------------------------------------- |
 | \`--agent-id <id>\`  | Filter by agent ID                            |
-| \`--type <type>\`    | Filter by type (\`CHAT\`, \`API\`, \`PHONE\`, etc.) |
+| \`--type <type>\`    | Filter by type (\`EMBED\`, \`API\`, \`WHATSAPP\`, \`TWILIO_SMS\`, etc.) |
 | \`--page <number>\`  | Page number                                   |
 | \`--limit <number>\` | Items per page                                |
 
@@ -5943,21 +5975,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 +8685,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/settings/phone-number\` in your default browser. Complete the "Connect with Meta" 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 +9893,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 \\
-  --agent-id $AGENT_ID \\
-  --json | jq -r '.id')
-
-# 4. Deploy to Slack
-SLACK_DEP=$(nexus deployment create \\
-  --name "Slack Bot" \\
-  --type slack \\
+  --type WHATSAPP \\
   --agent-id $AGENT_ID \\
+  --body "{\\"phoneNumberId\\":\\"$PHONE_ID\\",\\"apiKeyConnectionId\\":\\"$CONN_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
@@ -10780,8 +10967,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" },
@@ -11844,7 +12031,7 @@ 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
@@ -12009,7 +12196,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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-nexus/cli",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "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.10"
   },
   "scripts": {
     "gen:docs": "tsx scripts/bundle-docs.ts",