@agent-nexus/cli 0.1.13 → 0.1.14

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.13",
+      version: "0.1.14",
       description: "Official CLI for the Nexus AI agent platform.",
       license: "MIT",
       keywords: [
@@ -798,6 +798,23 @@ var ChannelsResource = class extends BaseResource {
       { body }
     );
   }
+  // ===========================================================================
+  // WhatsApp Template Test-Send
+  // ===========================================================================
+  async testSendWhatsAppTemplate(templateId, body) {
+    return this.http.request(
+      "POST",
+      `/channels/whatsapp-templates/${templateId}/test-send`,
+      { body }
+    );
+  }
+  async getTestSendStatus(templateId, messageSid, params) {
+    return this.http.request(
+      "GET",
+      `/channels/whatsapp-templates/${templateId}/test-send/${messageSid}/status`,
+      { query: params }
+    );
+  }
 };
 var CloudImportsResource = class extends BaseResource {
   // Google Drive
@@ -4197,6 +4214,83 @@ Next: Attach to deployment: ${color.dim("nexus deployment template attach <depId
       process.exitCode = handleError(err);
     }
   });
+  waTemplate.command("test-send").description(
+    "Test-send a WhatsApp template to a phone number via the real Twilio/Meta pipeline"
+  ).requiredOption("--connection-id <id>", "Messaging connection ID").requiredOption("--template-id <id>", "Template ID (Twilio content SID)").requiredOption("--to <phone>", "Recipient phone number in E.164 format (e.g., +1234567890)").option("--variables <json>", `Template variables as JSON (e.g., '{"1": "Hello"}')`).option("--wait", "Poll delivery status until resolved (up to 2 minutes)").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus channel whatsapp-template test-send --connection-id abc --template-id HX123 --to +1234567890
+  $ nexus channel whatsapp-template test-send --connection-id abc --template-id HX123 --to +1234567890 --variables '{"1": "Sneakers"}' --wait`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      let variables;
+      if (opts.variables) {
+        try {
+          variables = JSON.parse(opts.variables);
+        } catch {
+          console.error(`Invalid JSON for --variables. Example: '{"1": "Hello"}'`);
+          process.exitCode = 1;
+          return;
+        }
+      }
+      const result = await client.channels.testSendWhatsAppTemplate(opts.templateId, {
+        connectionId: opts.connectionId,
+        to: opts.to,
+        variables
+      });
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "messageSid", label: "Message SID" },
+        { key: "status", label: "Status" },
+        { key: "to", label: "To" },
+        { key: "from", label: "From" },
+        { key: "sentAt", label: "Sent At" }
+      ]);
+      printSuccess("Template test-send initiated.");
+      if (opts.wait) {
+        const maxWaitMs = 12e4;
+        const intervalMs = 5e3;
+        const startTime = Date.now();
+        let lastStatus = data.status;
+        console.log("Polling delivery status...");
+        while (Date.now() - startTime < maxWaitMs) {
+          await new Promise((r) => setTimeout(r, intervalMs));
+          try {
+            const statusResult = await client.channels.getTestSendStatus(
+              opts.templateId,
+              data.messageSid,
+              { connectionId: opts.connectionId }
+            );
+            const statusData = statusResult?.data ?? statusResult;
+            lastStatus = statusData.status;
+            if (["delivered", "read"].includes(lastStatus)) {
+              console.log(color.green(`\u2713 Message ${lastStatus}.`));
+              break;
+            } else if (["failed", "undelivered"].includes(lastStatus)) {
+              console.log(color.red(`\u2717 Message ${lastStatus}.`));
+              if (statusData.errorCode) {
+                console.log(
+                  `  Error ${statusData.errorCode}: ${statusData.errorMessage ?? "Unknown error"}`
+                );
+              }
+              process.exitCode = 1;
+              break;
+            }
+          } catch {
+          }
+        }
+        if (!["delivered", "read", "failed", "undelivered"].includes(lastStatus)) {
+          console.log(
+            `Status still '${lastStatus}' after 2m. The message may still be in transit.`
+          );
+        }
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
 }
 
 // src/commands/collection.ts
@@ -5026,8 +5120,7 @@ Examples:
       if (opts.description !== void 0) body.description = opts.description;
       if (opts.enableMultiLanguage !== void 0)
         body.enableMultiLanguage = opts.enableMultiLanguage;
-      if (opts.enableDynamicSize !== void 0)
-        body.enableDynamicSize = opts.enableDynamicSize;
+      if (opts.enableDynamicSize !== void 0) body.enableDynamicSize = opts.enableDynamicSize;
       if (opts.singleItemCardTemplateId !== void 0)
         body.singleItemCardTemplateId = opts.singleItemCardTemplateId;
       if (opts.variables) {
@@ -12742,7 +12835,7 @@ init_output();
 function registerTracingCommands(program2) {
   const tracing = program2.command("tracing").description("View LLM traces and analytics");
   addPaginationOptions(
-    tracing.command("traces").description("List LLM traces").option("--status <status>", "Filter by status (IN_PROGRESS, COMPLETED, FAILED)").option("--agent-id <id>", "Filter by agent ID").option("--workflow-id <id>", "Filter by workflow ID").option("--model <name>", "Filter by model name").option("--start-date <iso>", "Filter from date (ISO 8601)").option("--end-date <iso>", "Filter to date (ISO 8601)").option(
+    tracing.command("traces").description("List LLM traces").option("--status <status>", "Filter by status (IN_PROGRESS, COMPLETED, FAILED)").option("--agent-id <id>", "Filter by agent ID").option("--workflow-id <id>", "Filter by workflow ID").option("--model <name>", "Filter by model name (max 255 chars)").option("--start-date <iso>", "Filter from date (ISO 8601, e.g. 2026-03-01)").option("--end-date <iso>", "Filter to date (ISO 8601, e.g. 2026-03-01)").option(
       "--sort-by <field>",
       "Sort by field (startedAt, totalCostUsd, totalDurationMs)",
       "startedAt"
@@ -12768,26 +12861,30 @@ Examples:
         sortBy: opts.sortBy,
         order: opts.order
       });
-      printList(data, meta, [
-        { key: "id", label: "ID", width: 36 },
-        { key: "status", label: "STATUS", width: 12, format: formatStatus },
-        { key: "agentName", label: "AGENT", width: 20 },
-        { key: "workflowName", label: "WORKFLOW", width: 20 },
-        {
-          key: "totalCostUsd",
-          label: "COST ($)",
-          width: 10,
-          format: (v) => v != null ? `$${Number(v).toFixed(4)}` : "-"
-        },
-        {
-          key: "totalDurationMs",
-          label: "DURATION",
-          width: 10,
-          format: (v) => v != null ? `${Number(v)}ms` : "-"
-        },
-        { key: "generationCount", label: "GENS", width: 5 },
-        { key: "startedAt", label: "STARTED", width: 20 }
-      ]);
+      printList(
+        data,
+        meta,
+        [
+          { key: "id", label: "ID", width: 36 },
+          { key: "status", label: "STATUS", width: 12, format: formatStatus },
+          { key: "agentName", label: "AGENT", width: 20 },
+          { key: "workflowName", label: "WORKFLOW", width: 20 },
+          {
+            key: "totalCostUsd",
+            label: "COST ($)",
+            width: 10,
+            format: (v) => v != null ? `$${Number(v).toFixed(4)}` : "-"
+          },
+          {
+            key: "totalDurationMs",
+            label: "DURATION",
+            width: 10,
+            format: (v) => v != null ? `${Number(v)}ms` : "-"
+          },
+          { key: "generationCount", label: "GENS", width: 5 },
+          { key: "startedAt", label: "STARTED", width: 20 }
+        ]
+      );
     } catch (err) {
       process.exitCode = handleError(err);
     }
@@ -12807,7 +12904,11 @@ Examples:
         { key: "status", label: "Status" },
         { key: "agentName", label: "Agent" },
         { key: "workflowName", label: "Workflow" },
-        { key: "totalCostUsd", label: "Cost ($)", format: (v) => v != null ? `$${Number(v).toFixed(4)}` : "-" },
+        {
+          key: "totalCostUsd",
+          label: "Cost ($)",
+          format: (v) => v != null ? `$${Number(v).toFixed(4)}` : "-"
+        },
         { key: "totalInputTokens", label: "Input Tokens" },
         { key: "totalOutputTokens", label: "Output Tokens" },
         { key: "totalDurationMs", label: "Duration (ms)" },
@@ -12856,7 +12957,7 @@ Examples:
     }
   });
   addPaginationOptions(
-    tracing.command("generations").description("List LLM generations across traces").option("--trace-id <id>", "Filter by trace ID").option("--provider <provider>", "Filter by provider (OPEN_AI, ANTHROPIC, GOOGLE_AI)").option("--model <name>", "Filter by model name").option("--status <status>", "Filter by status (PENDING, RUNNING, COMPLETED, FAILED)").option("--agent-id <id>", "Filter by agent ID").option("--task-id <id>", "Filter by task ID").option("--start-date <iso>", "Filter from date").option("--end-date <iso>", "Filter to date").option("--min-cost <usd>", "Minimum cost in USD").option("--max-cost <usd>", "Maximum cost in USD").addHelpText(
+    tracing.command("generations").description("List LLM generations across traces").option("--trace-id <id>", "Filter by trace ID").option("--provider <provider>", "Filter by provider (OPEN_AI, ANTHROPIC, GOOGLE_AI)").option("--model <name>", "Filter by model name (max 255 chars)").option("--status <status>", "Filter by status (PENDING, RUNNING, COMPLETED, FAILED)").option("--agent-id <id>", "Filter by agent ID").option("--task-id <id>", "Filter by task ID").option("--start-date <iso>", "Filter from date (ISO 8601, e.g. 2026-03-01)").option("--end-date <iso>", "Filter to date (ISO 8601, e.g. 2026-03-01)").option("--min-cost <usd>", "Minimum cost in USD").option("--max-cost <usd>", "Maximum cost in USD").addHelpText(
       "after",
       `
 Examples:
@@ -12880,24 +12981,28 @@ Examples:
         minCostUsd: opts.minCost ? parseFloat(opts.minCost) : void 0,
         maxCostUsd: opts.maxCost ? parseFloat(opts.maxCost) : void 0
       });
-      printList(data, meta, [
-        { key: "id", label: "ID", width: 36 },
-        { key: "traceId", label: "TRACE", width: 36 },
-        { key: "modelName", label: "MODEL", width: 25 },
-        { key: "status", label: "STATUS", width: 12, format: formatStatus },
-        {
-          key: "costUsd",
-          label: "COST ($)",
-          width: 10,
-          format: (v) => v != null ? `$${Number(v).toFixed(6)}` : "-"
-        },
-        {
-          key: "durationMs",
-          label: "DURATION",
-          width: 10,
-          format: (v) => v != null ? `${v}ms` : "-"
-        }
-      ]);
+      printList(
+        data,
+        meta,
+        [
+          { key: "id", label: "ID", width: 36 },
+          { key: "traceId", label: "TRACE", width: 36 },
+          { key: "modelName", label: "MODEL", width: 25 },
+          { key: "status", label: "STATUS", width: 12, format: formatStatus },
+          {
+            key: "costUsd",
+            label: "COST ($)",
+            width: 10,
+            format: (v) => v != null ? `$${Number(v).toFixed(6)}` : "-"
+          },
+          {
+            key: "durationMs",
+            label: "DURATION",
+            width: 10,
+            format: (v) => v != null ? `${v}ms` : "-"
+          }
+        ]
+      );
     } catch (err) {
       process.exitCode = handleError(err);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-nexus/cli",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "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.15"
+    "@agent-nexus/sdk": "0.1.16"
   },
   "scripts": {
     "gen:docs": "tsx scripts/bundle-docs.ts",