@agent-nexus/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,3992 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/output.ts
+var output_exports = {};
+__export(output_exports, {
+  color: () => color,
+  isJsonMode: () => isJsonMode,
+  printList: () => printList,
+  printPaginationMeta: () => printPaginationMeta,
+  printRecord: () => printRecord,
+  printSuccess: () => printSuccess,
+  printTable: () => printTable,
+  setJsonMode: () => setJsonMode
+});
+function setJsonMode(enabled) {
+  _jsonMode = enabled;
+}
+function isJsonMode() {
+  return _jsonMode;
+}
+function c2(code, text) {
+  return NO_COLOR2 ? text : `\x1B[${code}m${text}\x1B[0m`;
+}
+function printTable(rows, columns) {
+  if (_jsonMode) {
+    console.log(JSON.stringify(rows, null, 2));
+    return;
+  }
+  if (rows.length === 0) {
+    console.log(color.dim("No results."));
+    return;
+  }
+  const widths = columns.map((col) => {
+    const headerLen = col.label.length;
+    const maxDataLen = rows.reduce((max, row) => {
+      const val = col.format ? col.format(row[col.key]) : String(row[col.key] ?? "");
+      return Math.max(max, val.length);
+    }, 0);
+    return col.width ?? Math.min(Math.max(headerLen, maxDataLen), 50);
+  });
+  const header = columns.map((col, i) => color.bold(col.label.padEnd(widths[i]))).join("  ");
+  console.log(header);
+  console.log(columns.map((_, i) => "\u2500".repeat(widths[i])).join("  "));
+  for (const row of rows) {
+    const line = columns.map((col, i) => {
+      const val = col.format ? col.format(row[col.key]) : String(row[col.key] ?? "");
+      return val.padEnd(widths[i]).slice(0, widths[i]);
+    }).join("  ");
+    console.log(line);
+  }
+}
+function printRecord(data, fields) {
+  if (_jsonMode) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  const entries = fields ? fields.map((f) => [f.label, f.format ? f.format(data[f.key]) : String(data[f.key] ?? "")]) : Object.entries(data).map(([k, v]) => [k, String(v ?? "")]);
+  const maxLabel = entries.reduce((max, [label]) => Math.max(max, label.length), 0);
+  for (const [label, value] of entries) {
+    console.log(`${color.bold(label.padEnd(maxLabel))}  ${value}`);
+  }
+}
+function printSuccess(message, data) {
+  if (_jsonMode) {
+    console.log(JSON.stringify({ success: true, ...data }, null, 2));
+    return;
+  }
+  console.log(color.green("\u2713") + " " + message);
+  if (data) {
+    for (const [key, value] of Object.entries(data)) {
+      console.log(`  ${color.dim(key + ":")} ${value}`);
+    }
+  }
+}
+function printPaginationMeta(meta) {
+  if (_jsonMode) return;
+  const parts = [];
+  if (meta.total != null) parts.push(`${meta.total} total`);
+  if (meta.page != null) parts.push(`page ${meta.page}`);
+  if (meta.hasMore) parts.push("more available");
+  if (parts.length > 0) {
+    console.log(color.dim(`
+${parts.join(" \xB7 ")}`));
+  }
+}
+function printList(data, meta, columns) {
+  if (_jsonMode) {
+    console.log(JSON.stringify({ data, meta }, null, 2));
+    return;
+  }
+  printTable(data, columns);
+  if (meta) {
+    printPaginationMeta(meta);
+  }
+}
+var _jsonMode, NO_COLOR2, color;
+var init_output = __esm({
+  "src/output.ts"() {
+    "use strict";
+    _jsonMode = false;
+    NO_COLOR2 = !!process.env.NO_COLOR || process.argv.includes("--no-color") || !process.stdout.isTTY;
+    color = {
+      orange: (t) => c2("38;2;245;70;26", t),
+      teal: (t) => c2("38;2;0;183;165", t),
+      dim: (t) => c2("2", t),
+      bold: (t) => c2("1", t),
+      red: (t) => c2("31", t),
+      green: (t) => c2("32", t),
+      yellow: (t) => c2("33", t),
+      cyan: (t) => c2("36", t)
+    };
+  }
+});
+
+// src/index.ts
+var import_commander = require("commander");
+
+// src/banner.ts
+var NO_COLOR = !!process.env.NO_COLOR || process.argv.includes("--no-color") || !process.stdout.isTTY;
+function c(code, text) {
+  return NO_COLOR ? text : `\x1B[${code}m${text}\x1B[0m`;
+}
+var teal = (t) => c("38;2;0;183;165", t);
+var dim = (t) => c("2", t);
+var bold = (t) => c("1", t);
+var WORDMARK = [
+  "  \u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
+  "  \u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2588\u2588\u2557\u2588\u2588\u2554\u255D\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D",
+  "  \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557   \u255A\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
+  "  \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D   \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551   \u2588\u2588\u2551\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551",
+  "  \u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2554\u255D \u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551",
+  "  \u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D"
+];
+function getBanner(version) {
+  const lines = [""];
+  for (const line of WORDMARK) {
+    lines.push(bold(line));
+  }
+  lines.push("");
+  lines.push(dim("  The AI agent platform") + "  " + teal("v" + version));
+  lines.push("");
+  return lines.join("\n");
+}
+
+// src/client.ts
+var import_sdk = require("@agent-nexus/sdk");
+
+// src/config.ts
+var import_node_fs = __toESM(require("fs"));
+var import_node_os = __toESM(require("os"));
+var import_node_path = __toESM(require("path"));
+var URL_MAP = {
+  production: "https://api.nexusgpt.io",
+  dev: "http://localhost:3001"
+};
+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");
+function loadConfig() {
+  try {
+    const raw = import_node_fs.default.readFileSync(CONFIG_FILE, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function saveConfig(config) {
+  import_node_fs.default.mkdirSync(CONFIG_DIR, { recursive: true, mode: 448 });
+  import_node_fs.default.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", {
+    mode: 384
+  });
+}
+function clearConfig() {
+  try {
+    import_node_fs.default.unlinkSync(CONFIG_FILE);
+  } catch {
+  }
+}
+function resolveBaseUrl(override) {
+  if (override) return override;
+  if (process.env.NEXUS_BASE_URL) return process.env.NEXUS_BASE_URL;
+  const config = loadConfig();
+  if (config.baseUrl) return config.baseUrl;
+  const env = process.env.NEXUS_ENV ?? "production";
+  return URL_MAP[env] ?? URL_MAP.production;
+}
+function resolveApiKey(override) {
+  if (override) return override;
+  if (process.env.NEXUS_API_KEY) return process.env.NEXUS_API_KEY;
+  const config = loadConfig();
+  if (config.apiKey) return config.apiKey;
+  throw new Error("No API key found. Set NEXUS_API_KEY or run:\n  nexus auth login");
+}
+
+// src/client.ts
+function createClient(opts) {
+  return new import_sdk.NexusClient({
+    apiKey: resolveApiKey(opts?.apiKey),
+    baseUrl: resolveBaseUrl(opts?.baseUrl)
+  });
+}
+
+// src/errors.ts
+var import_sdk2 = require("@agent-nexus/sdk");
+init_output();
+function handleError(err) {
+  if (err instanceof import_sdk2.NexusAuthenticationError) {
+    printCliError(
+      "Authentication failed \u2014 invalid or missing API key.",
+      'Run "nexus auth login" to re-authenticate, or set NEXUS_API_KEY.'
+    );
+    return 1;
+  }
+  if (err instanceof import_sdk2.NexusApiError) {
+    if (err.status === 404) {
+      printCliError(
+        `Not found: ${err.message}`,
+        'Run "nexus <resource> list" to see available resources.'
+      );
+    } else if (err.status === 422 || err.code === "VALIDATION_ERROR") {
+      printCliError(
+        `Validation error: ${err.message}`,
+        err.details ? `Details: ${JSON.stringify(err.details)}` : void 0
+      );
+    } else {
+      printCliError(`API error (${err.status}): ${err.message}`);
+    }
+    return 1;
+  }
+  if (err instanceof import_sdk2.NexusConnectionError) {
+    printCliError(
+      "Could not reach the Nexus API.",
+      "Check your network connection and base URL configuration."
+    );
+    return 1;
+  }
+  if (err instanceof import_sdk2.NexusError) {
+    printCliError(err.message);
+    return 1;
+  }
+  if (err instanceof Error) {
+    printCliError(err.message);
+    return 1;
+  }
+  printCliError(String(err));
+  return 1;
+}
+function printCliError(message, hint) {
+  if (isJsonMode()) {
+    console.log(JSON.stringify({ error: { message, hint } }, null, 2));
+    return;
+  }
+  console.error(color.red("Error:") + " " + message);
+  if (hint) {
+    console.error(color.dim("  " + hint));
+  }
+}
+
+// src/commands/agent.ts
+init_output();
+
+// src/util/stdin.ts
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    process.stdin.on("data", (chunk) => chunks.push(chunk));
+    process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8").trim()));
+    process.stdin.on("error", reject);
+    if (process.stdin.isTTY) {
+      resolve("");
+    }
+  });
+}
+async function resolveInputValue(value) {
+  if (value === "-") {
+    return readStdin();
+  }
+  try {
+    const fs5 = await import("fs");
+    if (fs5.existsSync(value) && fs5.statSync(value).isFile()) {
+      return fs5.readFileSync(value, "utf-8").trim();
+    }
+  } catch {
+  }
+  return value;
+}
+
+// src/util/body.ts
+async function resolveBody(raw) {
+  if (raw === void 0) return void 0;
+  let jsonStr;
+  if (raw === "-") {
+    jsonStr = await readStdin();
+  } else if (raw.endsWith(".json")) {
+    try {
+      const fs5 = await import("fs/promises");
+      jsonStr = (await fs5.readFile(raw, "utf-8")).trim();
+    } catch (err) {
+      throw new Error(
+        `Could not read file "${raw}": ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  } else {
+    jsonStr = raw;
+  }
+  try {
+    return JSON.parse(jsonStr);
+  } catch {
+    throw new Error(
+      `Invalid JSON in --body: ${jsonStr.length > 120 ? jsonStr.slice(0, 120) + "\u2026" : jsonStr}`
+    );
+  }
+}
+function mergeBodyWithFlags(body, flags) {
+  const merged = { ...body };
+  for (const [key, value] of Object.entries(flags)) {
+    if (value !== void 0) merged[key] = value;
+  }
+  return merged;
+}
+
+// src/util/pagination.ts
+function addPaginationOptions(cmd) {
+  return cmd.option("--page <number>", "Page number", parseInt).option("--limit <number>", "Items per page", parseInt);
+}
+function getPaginationParams(opts) {
+  const params = {};
+  if (typeof opts.page === "number") params.page = opts.page;
+  if (typeof opts.limit === "number") params.limit = opts.limit;
+  return params;
+}
+
+// src/commands/agent.ts
+function registerAgentCommands(program2) {
+  const agent = program2.command("agent").description("Manage AI agents");
+  addPaginationOptions(
+    agent.command("list").description("List agents").option("--status <status>", "Filter by status (ACTIVE, DRAFT)").option("--search <query>", "Search by name or role").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus agent list
+  $ nexus agent list --limit 5 --status ACTIVE
+  $ nexus agent list --search "support" --json`
+    )
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.agents.list({
+        ...getPaginationParams(opts),
+        status: opts.status,
+        search: opts.search
+      });
+      printList(
+        data,
+        meta,
+        [
+          { key: "id", label: "ID", width: 36 },
+          { key: "firstName", label: "FIRST NAME", width: 15 },
+          { key: "lastName", label: "LAST NAME", width: 15 },
+          { key: "role", label: "ROLE", width: 25 },
+          { key: "status", label: "STATUS", width: 10 }
+        ]
+      );
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agent.command("get").description("Get agent details").argument("<id>", "Agent ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent get abc-123
+  $ nexus agent get abc-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const agent2 = await client.agents.get(id);
+      printRecord(agent2, [
+        { key: "id", label: "ID" },
+        { key: "firstName", label: "First Name" },
+        { key: "lastName", label: "Last Name" },
+        { key: "role", label: "Role" },
+        { key: "status", label: "Status" },
+        { key: "model", label: "Model" },
+        { key: "tone", label: "Tone" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agent.command("create").description("Create a new agent").requiredOption("--first-name <name>", "Agent first name").requiredOption("--last-name <name>", "Agent last name").requiredOption("--role <role>", "Agent role, e.g. 'Customer Support'").option("--bio <text>", "Full biography").option("--short-bio <text>", "Short biography for cards").option("--model <model>", "Model ID").option("--tone <tone>", "Communication tone").option("--prompt <file-or-->", "System prompt (file path, or '-' for stdin)").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent create --first-name Ada --last-name Lovelace --role "Assistant"
+  $ nexus agent create --first-name Bot --last-name Helper --role "Support" --model gpt-4o
+  $ cat prompt.md | nexus agent create --first-name Ada --last-name Lovelace --role "Assistant" --prompt -
+  $ nexus agent create --body '{"firstName":"Ada","lastName":"Lovelace","role":"Assistant"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.firstName !== void 0) flags.firstName = opts.firstName;
+      if (opts.lastName !== void 0) flags.lastName = opts.lastName;
+      if (opts.role !== void 0) flags.role = opts.role;
+      if (opts.bio !== void 0) flags.bio = opts.bio;
+      if (opts.shortBio !== void 0) flags.shortBio = opts.shortBio;
+      if (opts.model !== void 0) flags.model = opts.model;
+      if (opts.tone !== void 0) flags.tone = opts.tone;
+      if (opts.prompt) flags.prompt = await resolveInputValue(opts.prompt);
+      const body = mergeBodyWithFlags(base, flags);
+      const agent2 = await client.agents.create(body);
+      printSuccess("Agent created.", {
+        id: agent2.id,
+        name: `${agent2.firstName} ${agent2.lastName}`
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agent.command("update").description("Update an agent").argument("<id>", "Agent ID").option("--first-name <name>", "Agent first name").option("--last-name <name>", "Agent last name").option("--role <role>", "Agent role").option("--bio <text>", "Full biography").option("--short-bio <text>", "Short biography").option("--model <model>", "Model ID").option("--tone <tone>", "Communication tone").option("--prompt <file-or-->", "System prompt (file path, or '-' for stdin)").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent update abc-123 --role "Senior Assistant"
+  $ echo "You are helpful" | nexus agent update abc-123 --prompt -
+  $ nexus agent update abc-123 --model gpt-4o --tone professional
+  $ nexus agent update abc-123 --body '{"tone":"friendly"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.firstName !== void 0) flags.firstName = opts.firstName;
+      if (opts.lastName !== void 0) flags.lastName = opts.lastName;
+      if (opts.role !== void 0) flags.role = opts.role;
+      if (opts.bio !== void 0) flags.bio = opts.bio;
+      if (opts.shortBio !== void 0) flags.shortBio = opts.shortBio;
+      if (opts.model !== void 0) flags.model = opts.model;
+      if (opts.tone !== void 0) flags.tone = opts.tone;
+      if (opts.prompt) flags.prompt = await resolveInputValue(opts.prompt);
+      const body = mergeBodyWithFlags(base, flags);
+      const agent2 = await client.agents.update(id, body);
+      printSuccess("Agent updated.", { id: agent2.id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agent.command("delete").description("Delete an agent").argument("<id>", "Agent ID").option("--yes", "Skip confirmation").option("--dry-run", "Preview without deleting").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent delete abc-123
+  $ nexus agent delete abc-123 --yes
+  $ nexus agent delete abc-123 --dry-run`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (opts.dryRun) {
+        const agent2 = await client.agents.get(id);
+        console.log(
+          color.yellow("DRY RUN:") + ` Would delete agent "${agent2.firstName} ${agent2.lastName}" (${id})`
+        );
+        return;
+      }
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await rl.question(`Delete agent ${id}? This cannot be undone. [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.agents.delete(id);
+      printSuccess("Agent deleted.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agent.command("duplicate").description("Duplicate an agent").argument("<id>", "Agent ID to duplicate").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent duplicate abc-123
+  $ nexus agent duplicate abc-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const agent2 = await client.agents.duplicate(id);
+      printSuccess("Agent duplicated.", {
+        id: agent2.id,
+        name: `${agent2.firstName} ${agent2.lastName}`
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/agent-tool.ts
+init_output();
+function registerAgentToolCommands(program2) {
+  const agentTool = program2.command("agent-tool").description("Manage agent tool configurations");
+  agentTool.command("list").description("List tools attached to an agent").argument("<agent-id>", "Agent ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent-tool list agt-123
+  $ nexus agent-tool list agt-123 --json`
+  ).action(async (agentId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const tools = await client.agents.tools.list(agentId);
+      printTable(tools, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "label", label: "LABEL", width: 25 },
+        { key: "type", label: "TYPE", width: 15 },
+        { key: "isActive", label: "ACTIVE", width: 8, format: (v) => v ? "yes" : "no" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agentTool.command("get").description("Get tool configuration details").argument("<agent-id>", "Agent ID").argument("<tool-id>", "Tool config ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent-tool get agt-123 tool-456
+  $ nexus agent-tool get agt-123 tool-456 --json`
+  ).action(async (agentId, toolId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const tool = await client.agents.tools.get(agentId, toolId);
+      printRecord(tool);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agentTool.command("create").description("Add a tool to an agent").argument("<agent-id>", "Agent ID").requiredOption("--label <label>", "Tool label").requiredOption("--type <type>", "Tool type (PLUGIN, WORKFLOW, TASK, COLLECTION, etc.)").option("--config <json>", "Tool configuration as JSON").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent-tool create agt-123 --label "Gmail Send" --type PLUGIN
+  $ nexus agent-tool create agt-123 --label "Search KB" --type COLLECTION --config '{"collectionId":"col-789"}'
+  $ nexus agent-tool create agt-123 --body '{"label":"Search","type":"COLLECTION"}'`
+  ).action(async (agentId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.label !== void 0) flags.label = opts.label;
+      if (opts.type !== void 0) flags.type = opts.type;
+      if (opts.config) Object.assign(flags, JSON.parse(opts.config));
+      const body = mergeBodyWithFlags(base, flags);
+      const tool = await client.agents.tools.create(agentId, body);
+      printSuccess("Tool added to agent.", {
+        id: tool.id,
+        label: tool.label
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agentTool.command("update").description("Update a tool configuration").argument("<agent-id>", "Agent ID").argument("<tool-id>", "Tool config ID").option("--label <label>", "New label").option("--config <json>", "Updated configuration as JSON").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent-tool update agt-123 tool-456 --label "Renamed Tool"
+  $ nexus agent-tool update agt-123 tool-456 --body '{"label":"Renamed"}'`
+  ).action(async (agentId, toolId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.label !== void 0) flags.label = opts.label;
+      if (opts.config) Object.assign(flags, JSON.parse(opts.config));
+      const body = mergeBodyWithFlags(base, flags);
+      await client.agents.tools.update(agentId, toolId, body);
+      printSuccess("Tool updated.", { id: toolId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agentTool.command("delete").description("Remove a tool from an agent").argument("<agent-id>", "Agent ID").argument("<tool-id>", "Tool config ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent-tool delete agt-123 tool-456
+  $ nexus agent-tool delete agt-123 tool-456 --yes`
+  ).action(async (agentId, toolId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Remove tool ${toolId} from agent? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.agents.tools.delete(agentId, toolId);
+      printSuccess("Tool removed from agent.", { id: toolId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  agentTool.command("attach-collection").description("Attach a knowledge collection to an agent").argument("<agent-id>", "Agent ID").requiredOption("--collection-id <id>", "Collection ID").option("--label <label>", "Tool label").option("--instructions <text>", "Usage instructions").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus agent-tool attach-collection agt-123 --collection-id col-456
+  $ nexus agent-tool attach-collection agt-123 --collection-id col-456 --label "FAQ Search"
+  $ nexus agent-tool attach-collection agt-123 --body '{"collectionId":"col-456","label":"FAQ"}'`
+  ).action(async (agentId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.collectionId !== void 0 && { collectionId: opts.collectionId },
+        ...opts.label !== void 0 && { label: opts.label },
+        ...opts.instructions !== void 0 && { instructions: opts.instructions }
+      });
+      const tool = await client.agents.tools.attachCollection(agentId, body);
+      printSuccess("Collection attached to agent.", {
+        id: tool.id,
+        label: tool.label
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/analytics.ts
+init_output();
+function registerAnalyticsCommands(program2) {
+  const analytics = program2.command("analytics").description("View analytics and metrics");
+  analytics.command("overview").description("Get analytics overview").option("--time-period <period>", "Time period (7d, 30d, 90d, etc.)").option("--deployment-id <id>", "Filter by deployment ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus analytics overview
+  $ nexus analytics overview --time-period 30d
+  $ nexus analytics overview --deployment-id dep-123 --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.analytics.getOverview({
+        timePeriod: opts.timePeriod,
+        deploymentId: opts.deploymentId
+      });
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  addPaginationOptions(
+    analytics.command("feedback").description("List satisfaction feedback").option("--time-period <period>", "Time period").option("--deployment-id <id>", "Filter by deployment").option("--score <number>", "Filter by score", parseInt).addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus analytics feedback
+  $ nexus analytics feedback --time-period 7d --score 5
+  $ nexus analytics feedback --limit 20 --json`
+    )
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.analytics.listFeedback({
+        ...getPaginationParams(opts),
+        timePeriod: opts.timePeriod,
+        deploymentId: opts.deploymentId,
+        score: opts.score
+      });
+      const data = result.data ?? [];
+      const meta = result.meta;
+      printList(data, meta, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "score", label: "SCORE", width: 6 },
+        { key: "comment", label: "COMMENT", width: 40 },
+        { key: "createdAt", label: "DATE", width: 20 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  analytics.command("export").description("Export analytics as CSV").option("--time-period <period>", "Time period").option("--deployment-id <id>", "Filter by deployment").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus analytics export
+  $ nexus analytics export --time-period 30d > analytics.csv
+  $ nexus analytics export --deployment-id dep-123`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.analytics.exportCsv({
+        timePeriod: opts.timePeriod,
+        deploymentId: opts.deploymentId
+      });
+      if (typeof result === "string") {
+        console.log(result);
+      } else {
+        console.log(JSON.stringify(result, null, 2));
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/api.ts
+var import_sdk3 = require("@agent-nexus/sdk");
+init_output();
+function registerApiCommand(program2) {
+  program2.command("api").description("Call any Nexus API endpoint directly").argument("<method>", "HTTP method (GET, POST, PATCH, PUT, DELETE)").argument("<path>", "API path relative to /api/public/v1 (e.g. /models)").option("--body <json>", "Request body as JSON string, .json file path, or '-' for stdin").option("--query <key=value...>", "Query parameters (repeatable)", collect, []).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus api GET /models
+  $ nexus api POST /agents --body '{"firstName":"Test","lastName":"Bot","role":"QA"}'
+  $ nexus api GET /agents --query page=1 --query limit=5
+  $ nexus api PATCH /agents/abc-123 --body payload.json
+  $ echo '{"text":"hello"}' | nexus api POST /emulator/dep-1/sessions/s-1/messages --body -`
+  ).action(async (method, path5, opts) => {
+    try {
+      const globals = program2.optsWithGlobals();
+      const http = new import_sdk3.HttpClient({
+        baseUrl: resolveBaseUrl(globals.baseUrl),
+        apiKey: resolveApiKey(globals.apiKey)
+      });
+      const body = await resolveBody(opts.body);
+      const query = parseQueryPairs(opts.query);
+      const normalizedPath = path5.startsWith("/") ? path5 : `/${path5}`;
+      const { data, meta } = await http.requestWithMeta(
+        method.toUpperCase(),
+        normalizedPath,
+        { body, query }
+      );
+      const output = meta ? { data, meta } : { data };
+      console.log(JSON.stringify(output, null, isJsonMode() ? void 0 : 2));
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+function collect(value, previous) {
+  return [...previous, value];
+}
+function parseQueryPairs(pairs) {
+  if (pairs.length === 0) return void 0;
+  const result = {};
+  for (const pair of pairs) {
+    const eq = pair.indexOf("=");
+    if (eq === -1) {
+      result[pair] = "true";
+    } else {
+      result[pair.slice(0, eq)] = pair.slice(eq + 1);
+    }
+  }
+  return result;
+}
+
+// src/commands/auth.ts
+var import_node_child_process = require("child_process");
+var import_node_process = require("process");
+var import_promises = __toESM(require("readline/promises"));
+init_output();
+var SETTINGS_URL = "https://app.nexusgpt.io/app/settings/api-keys";
+function registerAuthCommands(program2) {
+  const auth = program2.command("auth").description("Manage authentication");
+  auth.command("login").description("Authenticate with the Nexus API").option("--api-key <key>", "API key (skip interactive prompt)").option("--env <env>", "Environment: dev or production", "production").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus auth login
+  $ nexus auth login --api-key nxs_abc123
+  $ nexus auth login --env dev`
+  ).action(async (opts) => {
+    const config = loadConfig();
+    if (opts.env === "dev") {
+      config.baseUrl = "http://localhost:3001";
+    }
+    const baseUrl = config.baseUrl ?? resolveBaseUrl();
+    let apiKey = opts.apiKey;
+    if (!apiKey) {
+      console.log(`Opening ${color.cyan(SETTINGS_URL)} ...`);
+      console.log("Create or copy an API key from the settings page.\n");
+      openUrl(SETTINGS_URL);
+      const rl = import_promises.default.createInterface({ input: import_node_process.stdin, output: import_node_process.stdout });
+      try {
+        apiKey = (await rl.question("Paste your API key (nxs_...): ")).trim();
+      } finally {
+        rl.close();
+      }
+    }
+    if (!apiKey) {
+      console.error(color.red("Error:") + " No key entered. Aborting.");
+      process.exitCode = 1;
+      return;
+    }
+    if (!apiKey.startsWith("nxs_")) {
+      console.error(
+        color.red("Error:") + ' Invalid key format \u2014 API keys start with "nxs_".\n  nexus auth login --api-key nxs_YOUR_KEY'
+      );
+      process.exitCode = 1;
+      return;
+    }
+    console.log("Validating...");
+    const res = await fetch(`${baseUrl}/api/public/v1/agents?limit=1`, {
+      headers: { "api-key": apiKey, Accept: "application/json" }
+    });
+    if (!res.ok) {
+      console.error(
+        color.red("Error:") + ` Validation failed (HTTP ${res.status}). Check your key and try again.`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    config.apiKey = apiKey;
+    if (opts.env === "dev") config.baseUrl = "http://localhost:3001";
+    saveConfig(config);
+    printSuccess("Logged in successfully.", {
+      config: "~/.nexus-mcp/config.json"
+    });
+  });
+  auth.command("logout").description("Remove stored credentials").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus auth logout`
+  ).action(() => {
+    clearConfig();
+    printSuccess("Logged out. Credentials removed from ~/.nexus-mcp/config.json");
+  });
+  auth.command("whoami").description("Show current authentication status").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus auth whoami`
+  ).action(async () => {
+    try {
+      const apiKey = resolveApiKey();
+      const baseUrl = resolveBaseUrl();
+      const res = await fetch(`${baseUrl}/api/public/v1/agents?limit=1`, {
+        headers: { "api-key": apiKey, Accept: "application/json" }
+      });
+      if (!res.ok) {
+        console.error(
+          color.red("Error:") + " API key is invalid or expired. Run: nexus auth login"
+        );
+        process.exitCode = 1;
+        return;
+      }
+      printSuccess("Authenticated.", {
+        api: baseUrl,
+        key: apiKey.slice(0, 8) + "..." + apiKey.slice(-4)
+      });
+    } catch (err) {
+      console.error(color.red("Error:") + " Not logged in. Run: nexus auth login");
+      process.exitCode = 1;
+    }
+  });
+}
+function openUrl(url) {
+  const platform = process.platform;
+  const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  (0, import_node_child_process.exec)(`${cmd} ${JSON.stringify(url)}`);
+}
+
+// src/commands/collection.ts
+init_output();
+function registerCollectionCommands(program2) {
+  const collection = program2.command("collection").description("Manage knowledge collections");
+  collection.command("list").description("List knowledge collections").option("--search <query>", "Search by name").option("--limit <number>", "Max results", parseInt).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection list
+  $ nexus collection list --search "product" --limit 10
+  $ nexus collection list --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.skills.listCollections({
+        search: opts.search,
+        limit: opts.limit
+      });
+      const items = result.items ?? [];
+      printTable(items, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 25 },
+        { key: "displayName", label: "DISPLAY NAME", width: 25 },
+        { key: "documentCount", label: "DOCS", width: 6 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  collection.command("get").description("Get collection details").argument("<id>", "Collection ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection get col-123
+  $ nexus collection get col-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const col = await client.skills.getCollection(id);
+      printRecord(col, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "displayName", label: "Display Name" },
+        { key: "description", label: "Description" },
+        { key: "k", label: "k (results)" },
+        { key: "reranker", label: "Reranker", format: (v) => v ? "yes" : "no" },
+        { key: "documentCount", label: "Documents" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  collection.command("create").description("Create a knowledge collection").requiredOption("--name <name>", "Collection name (unique slug)").option("--display-name <name>", "Human-readable display name").option("--description <text>", "Collection description").option("--k <number>", "Number of results to retrieve", parseInt).option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection create --name "product-docs"
+  $ nexus collection create --name "faq" --display-name "FAQ" --k 15
+  $ nexus collection create --body '{"name":"faq","displayName":"FAQ"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name },
+        ...opts.displayName !== void 0 && { displayName: opts.displayName },
+        ...opts.description !== void 0 && { description: opts.description },
+        ...opts.k !== void 0 && { k: opts.k }
+      });
+      const col = await client.skills.createCollection(body);
+      printSuccess("Collection created.", {
+        id: col.id,
+        name: col.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  collection.command("update").description("Update a collection").argument("<id>", "Collection ID").option("--display-name <name>", "Display name").option("--description <text>", "Description").option("--k <number>", "Number of results", parseInt).option("--reranker <bool>", "Enable reranker (true/false)").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection update col-123 --display-name "Updated FAQ"
+  $ nexus collection update col-123 --k 20 --reranker true
+  $ nexus collection update col-123 --body '{"displayName":"Updated"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.displayName !== void 0) flags.displayName = opts.displayName;
+      if (opts.description !== void 0) flags.description = opts.description;
+      if (opts.k !== void 0) flags.k = opts.k;
+      if (opts.reranker !== void 0) flags.reranker = opts.reranker === "true";
+      const body = mergeBodyWithFlags(base, flags);
+      await client.skills.updateCollection(id, body);
+      printSuccess("Collection updated.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  collection.command("delete").description("Delete a collection").argument("<id>", "Collection ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection delete col-123
+  $ nexus collection delete col-123 --yes`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Delete collection ${id}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.skills.deleteCollection(id);
+      printSuccess("Collection deleted.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  collection.command("search").description("Search a collection").argument("<id>", "Collection ID").requiredOption("--query <query>", "Search query").option("--limit <number>", "Max results", parseInt).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection search col-123 --query "how to reset password"
+  $ nexus collection search col-123 --query "pricing" --limit 5 --json`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.skills.searchCollection(id, {
+        query: opts.query,
+        limit: opts.limit
+      });
+      if (isJsonMode()) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        const results = result.results ?? result;
+        if (Array.isArray(results)) {
+          for (const r of results) {
+            console.log(
+              `\u2500 ${r.score?.toFixed(3) ?? "N/A"}  ${r.content?.slice(0, 100) ?? JSON.stringify(r).slice(0, 100)}...`
+            );
+          }
+        } else {
+          console.log(JSON.stringify(result, null, 2));
+        }
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  addPaginationOptions(
+    collection.command("documents").description("List documents in a collection").argument("<id>", "Collection ID").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus collection documents col-123
+  $ nexus collection documents col-123 --limit 20 --json`
+    )
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.skills.listCollectionDocuments(
+        id,
+        getPaginationParams(opts)
+      );
+      const data = result.data ?? result.items ?? result;
+      const meta = result.meta;
+      printList(Array.isArray(data) ? data : [data], meta, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "type", label: "TYPE", width: 12 },
+        { key: "status", label: "STATUS", width: 12 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  collection.command("attach-documents").description("Attach documents to a collection").argument("<id>", "Collection ID").requiredOption("--document-ids <ids>", "Comma-separated document IDs").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection attach-documents col-123 --document-ids doc-1,doc-2,doc-3`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      await client.skills.attachDocumentsToCollection(id, {
+        documentIds: opts.documentIds.split(",")
+      });
+      printSuccess("Documents attached to collection.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  collection.command("remove-document").description("Remove a document from a collection").argument("<id>", "Collection ID").argument("<document-id>", "Document ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection remove-document col-123 doc-456`
+  ).action(async (id, documentId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      await client.skills.removeCollectionDocument(id, documentId);
+      printSuccess("Document removed from collection.", { id, documentId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  collection.command("stats").description("Get collection statistics").argument("<id>", "Collection ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus collection stats col-123
+  $ nexus collection stats col-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const stats = await client.skills.getCollectionStatistics(id);
+      printRecord(stats);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/deployment.ts
+init_output();
+function registerDeploymentCommands(program2) {
+  const deployment = program2.command("deployment").description("Manage agent deployments");
+  addPaginationOptions(
+    deployment.command("list").description("List deployments").option("--search <query>", "Search by name").option("--type <type>", "Filter by deployment type").option("--active", "Show only active deployments").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus deployment list
+  $ nexus deployment list --type whatsapp --limit 10
+  $ nexus deployment list --active --json`
+    )
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.deployments.list({
+        ...getPaginationParams(opts),
+        search: opts.search,
+        type: opts.type,
+        isActive: opts.active ? true : void 0
+      });
+      printList(data, meta, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 25 },
+        { key: "type", label: "TYPE", width: 15 },
+        { key: "isActive", label: "ACTIVE", width: 8, format: (v) => v ? "yes" : "no" },
+        { key: "agentId", label: "AGENT ID", width: 36 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  deployment.command("get").description("Get deployment details").argument("<id>", "Deployment ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment get dep-123
+  $ nexus deployment get dep-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const dep = await client.deployments.get(id);
+      printRecord(dep, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "type", label: "Type" },
+        { key: "isActive", label: "Active", format: (v) => v ? "yes" : "no" },
+        { key: "agentId", label: "Agent ID" },
+        { key: "description", label: "Description" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  deployment.command("create").description("Create a new deployment").requiredOption("--name <name>", "Deployment name").requiredOption("--type <type>", "Deployment type (web, whatsapp, telegram, slack, etc.)").option("--agent-id <id>", "Agent ID to deploy").option("--description <text>", "Deployment description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment create --name "Web Widget" --type web --agent-id agt-123
+  $ nexus deployment create --name "WhatsApp Bot" --type whatsapp --agent-id agt-456
+  $ nexus deployment create --body '{"name":"Widget","type":"web","agentId":"agt-123"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name },
+        ...opts.type !== void 0 && { type: opts.type },
+        ...opts.agentId !== void 0 && { agentId: opts.agentId },
+        ...opts.description !== void 0 && { description: opts.description }
+      });
+      const dep = await client.deployments.create(body);
+      printSuccess("Deployment created.", {
+        id: dep.id,
+        name: dep.name,
+        type: dep.type
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  deployment.command("update").description("Update a deployment").argument("<id>", "Deployment ID").option("--name <name>", "Deployment name").option("--description <text>", "Description (use 'null' to clear)").option("--agent-id <id>", "Agent ID (use 'null' to detach)").option("--active <bool>", "Set active status (true/false)").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment update dep-123 --name "Renamed Widget"
+  $ nexus deployment update dep-123 --active false
+  $ nexus deployment update dep-123 --agent-id agt-456
+  $ nexus deployment update dep-123 --body '{"name":"Renamed"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.name !== void 0) flags.name = opts.name;
+      if (opts.description !== void 0) {
+        flags.description = opts.description === "null" ? null : opts.description;
+      }
+      if (opts.agentId !== void 0) {
+        flags.agentId = opts.agentId === "null" ? null : opts.agentId;
+      }
+      if (opts.active !== void 0) {
+        flags.isActive = opts.active === "true";
+      }
+      const body = mergeBodyWithFlags(base, flags);
+      await client.deployments.update(id, body);
+      printSuccess("Deployment updated.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  deployment.command("delete").description("Delete a deployment").argument("<id>", "Deployment ID").option("--yes", "Skip confirmation").option("--dry-run", "Preview without deleting").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment delete dep-123
+  $ nexus deployment delete dep-123 --yes
+  $ nexus deployment delete dep-123 --dry-run`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (opts.dryRun) {
+        const dep = await client.deployments.get(id);
+        console.log(
+          color.yellow("DRY RUN:") + ` Would delete deployment "${dep.name}" (${id})`
+        );
+        return;
+      }
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await rl.question(
+          `Delete deployment ${id}? This cannot be undone. [y/N] `
+        );
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.deployments.delete(id);
+      printSuccess("Deployment deleted.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  deployment.command("stats").description("Get deployment statistics").argument("<id>", "Deployment ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment stats dep-123
+  $ nexus deployment stats dep-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const stats = await client.deployments.getStatistics(id);
+      printRecord(stats);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  deployment.command("duplicate").description("Duplicate a deployment").argument("<id>", "Deployment ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment duplicate dep-123`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const dep = await client.deployments.duplicate(id);
+      printSuccess("Deployment duplicated.", {
+        id: dep.id,
+        name: dep.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  deployment.command("embed-config").description("Get deployment embed configuration").argument("<id>", "Deployment ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment embed-config dep-123
+  $ nexus deployment embed-config dep-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const config = await client.deployments.getEmbedConfig(id);
+      printRecord(config);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  deployment.command("embed-config-update").description("Update deployment embed configuration").argument("<id>", "Deployment ID").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment embed-config-update dep-123 --body '{"theme":"dark"}'
+  $ nexus deployment embed-config-update dep-123 --body config.json`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body) ?? {};
+      await client.deployments.updateEmbedConfig(id, body);
+      printSuccess("Embed config updated.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  const depFolder = deployment.command("folder").description("Manage deployment folders");
+  depFolder.command("list").description("List deployment folders").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment folder list
+  $ nexus deployment folder list --json`
+  ).action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.deploymentFolders.list();
+      const folders = result.folders ?? result.data ?? result;
+      printTable(Array.isArray(folders) ? folders : [folders], [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  depFolder.command("create").description("Create a deployment folder").requiredOption("--name <name>", "Folder name").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment folder create --name "Production"
+  $ nexus deployment folder create --body '{"name":"Staging"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name }
+      });
+      const folder = await client.deploymentFolders.create(body);
+      printSuccess("Deployment folder created.", {
+        id: folder.id,
+        name: folder.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  depFolder.command("update").description("Update a deployment folder").argument("<id>", "Folder ID").option("--name <name>", "Folder name").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment folder update fld-123 --name "Renamed"
+  $ nexus deployment folder update fld-123 --body '{"name":"Renamed"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name }
+      });
+      await client.deploymentFolders.update(id, body);
+      printSuccess("Deployment folder updated.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  depFolder.command("delete").description("Delete a deployment folder").argument("<id>", "Folder ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment folder delete fld-123
+  $ nexus deployment folder delete fld-123 --yes`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Delete deployment folder ${id}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.deploymentFolders.delete(id);
+      printSuccess("Deployment folder deleted.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  depFolder.command("assign").description("Assign a deployment to a folder").requiredOption("--deployment-id <id>", "Deployment ID").requiredOption("--folder-id <id>", "Folder ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus deployment folder assign --deployment-id dep-123 --folder-id fld-456`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      await client.deploymentFolders.assign({
+        deploymentId: opts.deploymentId,
+        folderId: opts.folderId
+      });
+      printSuccess("Deployment assigned to folder.", {
+        deploymentId: opts.deploymentId,
+        folderId: opts.folderId
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/document.ts
+var import_node_fs2 = __toESM(require("fs"));
+var import_node_path2 = __toESM(require("path"));
+init_output();
+function registerDocumentCommands(program2) {
+  const document = program2.command("document").description("Manage knowledge documents");
+  addPaginationOptions(
+    document.command("list").description("List documents").option("--search <query>", "Search by name").option("--type <type>", "Filter by type").option("--status <status>", "Filter by status").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus document list
+  $ nexus document list --search "report" --limit 10
+  $ nexus document list --status PROCESSED --json`
+    )
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.documents.list({
+        ...getPaginationParams(opts),
+        search: opts.search,
+        type: opts.type,
+        status: opts.status
+      });
+      printList(data, meta, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "type", label: "TYPE", width: 12 },
+        { key: "status", label: "STATUS", width: 12 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  document.command("get").description("Get document details").argument("<id>", "Document ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus document get doc-123
+  $ nexus document get doc-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const doc = await client.documents.get(id);
+      printRecord(doc, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "type", label: "Type" },
+        { key: "status", label: "Status" },
+        { key: "processingProgress", label: "Progress" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  document.command("upload").description("Upload a file as a document").argument("<file-path>", "Path to the file").option("--description <text>", "Document description").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus document upload ./report.pdf
+  $ nexus document upload ./data.csv --description "Q4 sales data"
+  $ nexus document upload ./manual.txt --json`
+  ).action(async (filePath, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const absPath = import_node_path2.default.resolve(filePath);
+      if (!import_node_fs2.default.existsSync(absPath)) {
+        console.error(`Error: File not found: ${absPath}`);
+        process.exitCode = 1;
+        return;
+      }
+      const buffer = import_node_fs2.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);
+      printSuccess("Document uploaded.", {
+        id: doc.id,
+        name: doc.name ?? fileName
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  document.command("create-text").description("Create a text document").requiredOption("--name <name>", "Document name").requiredOption("--content <text-or-->", "Content (text, or '-' for stdin)").option("--description <text>", "Document description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus document create-text --name "FAQ" --content "Q: How do I...\\nA: You can..."
+  $ cat content.md | nexus document create-text --name "Guide" --content -
+  $ nexus document create-text --body '{"name":"FAQ","content":"..."}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.name !== void 0) flags.name = opts.name;
+      if (opts.content) flags.content = await resolveInputValue(opts.content);
+      if (opts.description !== void 0) flags.description = opts.description;
+      const body = mergeBodyWithFlags(base, flags);
+      const doc = await client.documents.createText(body);
+      printSuccess("Text document created.", {
+        id: doc.id,
+        name: doc.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  document.command("add-website").description("Crawl a website and create document(s)").requiredOption("--url <url>", "Website URL").option("--mode <mode>", "Crawl mode: sitemap, single, etc.", "single").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus document add-website --url https://docs.example.com --mode sitemap
+  $ nexus document add-website --url https://example.com/page --mode single
+  $ nexus document add-website --body '{"url":"https://example.com","mode":"sitemap"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.url !== void 0 && { url: opts.url },
+        ...opts.mode !== void 0 && { mode: opts.mode }
+      });
+      const doc = await client.documents.addWebsite(body);
+      printSuccess("Website document created.", {
+        id: doc.id,
+        name: doc.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  document.command("delete").description("Delete a document").argument("<id>", "Document ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus document delete doc-123
+  $ nexus document delete doc-123 --yes`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Delete document ${id}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.documents.delete(id);
+      printSuccess("Document deleted.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/emulator.ts
+init_output();
+function registerEmulatorCommands(program2) {
+  const emulator = program2.command("emulator").description("Test deployments via the emulator");
+  const session = emulator.command("session").description("Manage emulator sessions");
+  session.command("create").description("Create an emulator session").argument("<deployment-id>", "Deployment ID").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator session create dep-123
+  $ nexus emulator session create dep-123 --body '{"participant":"user-1"}'
+  $ nexus emulator session create dep-123 --json`
+  ).action(async (deploymentId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const s = await client.emulator.createSession(deploymentId, body);
+      printRecord(s, [
+        { key: "id", label: "ID" },
+        { key: "deploymentId", label: "Deployment ID" },
+        { key: "status", label: "Status" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  session.command("list").description("List emulator sessions").argument("<deployment-id>", "Deployment ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator session list dep-123
+  $ nexus emulator session list dep-123 --json`
+  ).action(async (deploymentId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.emulator.listSessions(deploymentId);
+      const items = Array.isArray(result) ? result : result.data ?? result;
+      printList(items, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "createdAt", label: "CREATED", width: 26 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  session.command("get").description("Get emulator session details (with messages)").argument("<deployment-id>", "Deployment ID").argument("<session-id>", "Session ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator session get dep-123 sess-456
+  $ nexus emulator session get dep-123 sess-456 --json`
+  ).action(async (deploymentId, sessionId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const s = await client.emulator.getSession(deploymentId, sessionId);
+      printRecord(s, [
+        { key: "id", label: "ID" },
+        { key: "deploymentId", label: "Deployment ID" },
+        { key: "status", label: "Status" },
+        { key: "messages", label: "Messages" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  session.command("delete").description("Delete an emulator session").argument("<deployment-id>", "Deployment ID").argument("<session-id>", "Session ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator session delete dep-123 sess-456
+  $ nexus emulator session delete dep-123 sess-456 --yes`
+  ).action(async (deploymentId, sessionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Delete emulator session ${sessionId}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.emulator.deleteSession(deploymentId, sessionId);
+      printSuccess("Session deleted.", { sessionId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  emulator.command("send").description("Send a message in an emulator session").argument("<deployment-id>", "Deployment ID").argument("<session-id>", "Session ID").option("--text <message>", "Message text").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator send dep-123 sess-456 --text "Hello, agent!"
+  $ nexus emulator send dep-123 sess-456 --body '{"text":"Hi","participant":"user-1","debug":true}'
+  $ nexus emulator send dep-123 sess-456 --text "Test" --json`
+  ).action(async (deploymentId, sessionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        text: opts.text
+      });
+      const result = await client.emulator.sendMessage(deploymentId, sessionId, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  const scenario = emulator.command("scenario").description("Manage emulator scenarios");
+  scenario.command("save").description("Save an emulator session as a scenario").option("--session-id <id>", "Session ID").option("--deployment-id <id>", "Deployment ID").option("--name <name>", "Scenario name").option("--description <text>", "Scenario description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator scenario save --session-id sess-123 --deployment-id dep-456 --name "Happy path"
+  $ nexus emulator scenario save --body '{"sessionId":"sess-123","deploymentId":"dep-456","name":"Edge case"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        sessionId: opts.sessionId,
+        deploymentId: opts.deploymentId,
+        name: opts.name,
+        description: opts.description
+      });
+      const result = await client.emulator.saveScenario(body);
+      printRecord(result, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" },
+        { key: "deploymentId", label: "Deployment ID" },
+        { key: "sessionId", label: "Session ID" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  scenario.command("list").description("List emulator scenarios").option("--deployment-id <id>", "Filter by deployment ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator scenario list
+  $ nexus emulator scenario list --deployment-id dep-123
+  $ nexus emulator scenario list --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.emulator.listScenarios({
+        deploymentId: opts.deploymentId
+      });
+      const items = Array.isArray(result) ? result : result.data ?? result;
+      printList(items, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "deploymentId", label: "DEPLOYMENT", width: 36 },
+        { key: "createdAt", label: "CREATED", width: 26 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  scenario.command("get").description("Get scenario details").argument("<scenario-id>", "Scenario ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator scenario get scn-123
+  $ nexus emulator scenario get scn-123 --json`
+  ).action(async (scenarioId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const s = await client.emulator.getScenario(scenarioId);
+      printRecord(s, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" },
+        { key: "deploymentId", label: "Deployment ID" },
+        { key: "sessionId", label: "Session ID" },
+        { key: "messages", label: "Messages" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  scenario.command("replay").description("Replay a scenario against a deployment").argument("<scenario-id>", "Scenario ID").option("--deployment-id <id>", "Deployment ID to replay against").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator scenario replay scn-123 --deployment-id dep-456
+  $ nexus emulator scenario replay scn-123 --body '{"deploymentId":"dep-456"}'
+  $ nexus emulator scenario replay scn-123 --deployment-id dep-456 --json`
+  ).action(async (scenarioId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        deploymentId: opts.deploymentId
+      });
+      const result = await client.emulator.replayScenario(scenarioId, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  scenario.command("delete").description("Delete a scenario").argument("<scenario-id>", "Scenario ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus emulator scenario delete scn-123
+  $ nexus emulator scenario delete scn-123 --yes`
+  ).action(async (scenarioId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Delete scenario ${scenarioId}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.emulator.deleteScenario(scenarioId);
+      printSuccess("Scenario deleted.", { scenarioId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/evaluation.ts
+init_output();
+function registerEvaluationCommands(program2) {
+  const eval_ = program2.command("eval").description("Manage evaluations for AI tasks");
+  const session = eval_.command("session").description("Manage evaluation sessions");
+  session.command("create").description("Create an evaluation session").argument("<task-id>", "Task ID").option("--name <name>", "Session name").option("--description <text>", "Session description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus eval session create task-123 --name "Accuracy Test v1"
+  $ nexus eval session create task-123 --name "Edge cases" --description "Tests edge cases"
+  $ nexus eval session create task-123 --body '{"name":"Full test","description":"..."}'`
+  ).action(async (taskId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        name: opts.name,
+        description: opts.description
+      });
+      const s = await client.evaluations.createSession(taskId, body);
+      printRecord(s, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" },
+        { key: "status", label: "Status" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  addPaginationOptions(
+    session.command("list").description("List evaluation sessions").argument("<task-id>", "Task ID").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus eval session list task-123
+  $ nexus eval session list task-123 --limit 10
+  $ nexus eval session list task-123 --json`
+    )
+  ).action(async (taskId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.evaluations.listSessions(taskId, {
+        ...getPaginationParams(opts)
+      });
+      printList(
+        data,
+        meta,
+        [
+          { key: "id", label: "ID", width: 36 },
+          { key: "name", label: "NAME", width: 30 },
+          { key: "status", label: "STATUS", width: 15 },
+          { key: "createdAt", label: "CREATED", width: 26 }
+        ]
+      );
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  session.command("get").description("Get evaluation session details").argument("<task-id>", "Task ID").argument("<session-id>", "Session ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus eval session get task-123 sess-456
+  $ nexus eval session get task-123 sess-456 --json`
+  ).action(async (taskId, sessionId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const s = await client.evaluations.getSession(taskId, sessionId);
+      printRecord(s, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" },
+        { key: "status", label: "Status" },
+        { key: "rowCount", label: "Rows" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  session.command("delete").description("Delete an evaluation session").argument("<task-id>", "Task ID").argument("<session-id>", "Session ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus eval session delete task-123 sess-456
+  $ nexus eval session delete task-123 sess-456 --yes`
+  ).action(async (taskId, sessionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Delete evaluation session ${sessionId}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.evaluations.deleteSession(taskId, sessionId);
+      printSuccess("Evaluation session deleted.", { sessionId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  const dataset = eval_.command("dataset").description("Manage evaluation dataset rows");
+  addPaginationOptions(
+    dataset.command("list").description("List dataset rows").argument("<task-id>", "Task ID").argument("<session-id>", "Session ID").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus eval dataset list task-123 sess-456
+  $ nexus eval dataset list task-123 sess-456 --limit 20
+  $ nexus eval dataset list task-123 sess-456 --json`
+    )
+  ).action(async (taskId, sessionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.evaluations.getDatasetRows(taskId, sessionId, {
+        ...getPaginationParams(opts)
+      });
+      printList(
+        data,
+        meta,
+        [
+          { key: "id", label: "ID", width: 36 },
+          { key: "input", label: "INPUT", width: 40 },
+          { key: "expectedOutput", label: "EXPECTED OUTPUT", width: 40 }
+        ]
+      );
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  dataset.command("add").description("Add a row to the evaluation dataset").argument("<task-id>", "Task ID").argument("<session-id>", "Session ID").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus eval dataset add task-123 sess-456 --body '{"input":"Hello","expectedOutput":"Hi there"}'
+  $ nexus eval dataset add task-123 sess-456 --body dataset-row.json`
+  ).action(async (taskId, sessionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const row = await client.evaluations.addDatasetRow(taskId, sessionId, body);
+      printRecord(row, [
+        { key: "id", label: "ID" },
+        { key: "input", label: "Input" },
+        { key: "expectedOutput", label: "Expected Output" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  eval_.command("execute").description("Execute an evaluation run").argument("<task-id>", "Task ID").argument("<session-id>", "Session ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus eval execute task-123 sess-456
+  $ nexus eval execute task-123 sess-456 --json`
+  ).action(async (taskId, sessionId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.evaluations.execute(taskId, sessionId);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  eval_.command("judge").description("Judge evaluation results with AI").argument("<task-id>", "Task ID").argument("<session-id>", "Session ID").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus eval judge task-123 sess-456
+  $ nexus eval judge task-123 sess-456 --body '{"judgeModel":"gpt-4o","judgePrompt":"Rate accuracy"}'
+  $ nexus eval judge task-123 sess-456 --json`
+  ).action(async (taskId, sessionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const result = await client.evaluations.judge(taskId, sessionId, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  addPaginationOptions(
+    eval_.command("results").description("Get evaluation results").argument("<task-id>", "Task ID").argument("<session-id>", "Session ID").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus eval results task-123 sess-456
+  $ nexus eval results task-123 sess-456 --limit 50
+  $ nexus eval results task-123 sess-456 --json`
+    )
+  ).action(async (taskId, sessionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.evaluations.getResults(taskId, sessionId, {
+        ...getPaginationParams(opts)
+      });
+      printList(
+        data,
+        meta,
+        [
+          { key: "id", label: "ID", width: 36 },
+          { key: "input", label: "INPUT", width: 30 },
+          { key: "output", label: "OUTPUT", width: 30 },
+          { key: "score", label: "SCORE", width: 8 },
+          { key: "passed", label: "PASSED", width: 8 }
+        ]
+      );
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  eval_.command("formats").description("List available evaluation formats").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus eval formats
+  $ nexus eval formats --json`
+  ).action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.evaluations.listFormats();
+      const items = Array.isArray(result) ? result : result.data ?? result;
+      printList(items, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "description", label: "DESCRIPTION", width: 50 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  eval_.command("judges").description("List available judge models").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus eval judges
+  $ nexus eval judges --json`
+  ).action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.evaluations.listJudges();
+      const items = Array.isArray(result) ? result : result.data ?? result;
+      printList(items, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "provider", label: "PROVIDER", width: 20 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/execution.ts
+init_output();
+function registerExecutionCommands(program2) {
+  const execution = program2.command("execution").description("View workflow execution history");
+  addPaginationOptions(
+    execution.command("list").description("List workflow executions").option("--workflow-id <id>", "Filter by workflow ID").option("--status <status>", "Filter by status").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus execution list
+  $ nexus execution list --workflow-id wf-123 --limit 5
+  $ nexus execution list --status COMPLETED --json`
+    )
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      let result;
+      if (opts.workflowId) {
+        result = await client.workflowExecutions.listByWorkflow(opts.workflowId, {
+          ...getPaginationParams(opts),
+          status: opts.status
+        });
+      } else {
+        result = await client.workflowExecutions.list({
+          ...getPaginationParams(opts),
+          status: opts.status
+        });
+      }
+      const data = result.data ?? result;
+      const meta = result.meta;
+      printList(Array.isArray(data) ? data : [data], meta, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "workflowId", label: "WORKFLOW", width: 36 },
+        { key: "status", label: "STATUS", width: 12 },
+        { key: "createdAt", label: "STARTED", width: 20 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  execution.command("get").description("Get execution details").argument("<id>", "Execution ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus execution get exec-123
+  $ nexus execution get exec-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const exec2 = await client.workflowExecutions.get(id);
+      printRecord(exec2, [
+        { key: "id", label: "ID" },
+        { key: "workflowId", label: "Workflow" },
+        { key: "status", label: "Status" },
+        { key: "createdAt", label: "Started" },
+        { key: "completedAt", label: "Completed" },
+        { key: "duration", label: "Duration" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  execution.command("graph").description("Get execution graph (node-level results)").argument("<id>", "Execution ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus execution graph exec-123
+  $ nexus execution graph exec-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const graph = await client.workflowExecutions.getGraph(id);
+      printRecord(graph);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  execution.command("output").description("Get execution output").argument("<id>", "Execution ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus execution output exec-123
+  $ nexus execution output exec-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const output = await client.workflowExecutions.getOutput(id);
+      printRecord(output);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  execution.command("retry").description("Retry a failed node in an execution").argument("<id>", "Execution ID").argument("<node-id>", "Node ID to retry").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus execution retry exec-123 node-456`
+  ).action(async (id, nodeId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflowExecutions.retryNode(id, nodeId);
+      printSuccess("Node retry initiated.", { executionId: id, nodeId, ...result });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  execution.command("export").description("Export execution data").argument("<id>", "Execution ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus execution export exec-123
+  $ nexus execution export exec-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const data = await client.workflowExecutions.export(id);
+      printRecord(data);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  execution.command("node-result").description("Get result of a specific node in an execution").argument("<id>", "Execution ID").argument("<node-id>", "Node ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus execution node-result exec-123 node-456
+  $ nexus execution node-result exec-123 node-456 --json`
+  ).action(async (id, nodeId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflowExecutions.getNodeResult(id, nodeId);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/external-tool.ts
+init_output();
+function registerExternalToolCommands(program2) {
+  const externalTool = program2.command("external-tool").description("Manage external tools (OpenAPI integrations)");
+  externalTool.command("list").description("List external tools").option("--search <query>", "Search by name").option("--limit <number>", "Max results", parseInt).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus external-tool list
+  $ nexus external-tool list --search "weather" --limit 10
+  $ nexus external-tool list --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.skills.listExternalTools({
+        search: opts.search,
+        limit: opts.limit
+      });
+      const items = Array.isArray(result) ? result : result.items ?? result.data ?? result;
+      printList(items, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "description", label: "DESCRIPTION", width: 40 },
+        { key: "createdAt", label: "CREATED", width: 26 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  externalTool.command("get").description("Get external tool details").argument("<id>", "External tool ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus external-tool get ext-123
+  $ nexus external-tool get ext-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const t = await client.skills.getExternalTool(id);
+      printRecord(t, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" },
+        { key: "baseUrl", label: "Base URL" },
+        { key: "createdAt", label: "Created" },
+        { key: "updatedAt", label: "Updated" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  externalTool.command("create").description("Create an external tool from an OpenAPI spec").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus external-tool create --body openapi-tool.json
+  $ nexus external-tool create --body '{"name":"Weather API","spec":{...}}'
+  $ cat spec.json | nexus external-tool create --body -`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const t = await client.skills.createExternalTool(body);
+      printSuccess("External tool created.", {
+        id: t.id,
+        name: t.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  externalTool.command("test").description("Test an external tool operation").argument("<id>", "External tool ID").option("--operation-id <op>", "Operation ID to test").option("--input <json>", "Input parameters as JSON").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus external-tool test ext-123 --operation-id getWeather --input '{"city":"London"}'
+  $ nexus external-tool test ext-123 --body '{"operationId":"getWeather","input":{"city":"London"}}'
+  $ nexus external-tool test ext-123 --operation-id listItems --json`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.operationId) flags.operationId = opts.operationId;
+      if (opts.input) flags.input = JSON.parse(opts.input);
+      const body = mergeBodyWithFlags(base, flags);
+      const result = await client.skills.testExternalTool(id, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/folder.ts
+init_output();
+function registerFolderCommands(program2) {
+  const folder = program2.command("folder").description("Manage agent folders");
+  folder.command("list").description("List all folders").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus folder list
+  $ nexus folder list --json`
+  ).action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.folders.list();
+      const folders = result.folders ?? result;
+      printTable(Array.isArray(folders) ? folders : [folders], [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "parentId", label: "PARENT", width: 36 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  folder.command("create").description("Create a new folder").requiredOption("--name <name>", "Folder name").option("--parent-id <id>", "Parent folder ID for nesting").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus folder create --name "Customer Support"
+  $ nexus folder create --name "Sub Team" --parent-id abc-123
+  $ nexus folder create --body '{"name":"Support"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name },
+        ...opts.parentId !== void 0 && { parentId: opts.parentId }
+      });
+      const folder2 = await client.folders.create(body);
+      printSuccess("Folder created.", {
+        id: folder2.id,
+        name: folder2.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  folder.command("update").description("Update a folder").argument("<id>", "Folder ID").option("--name <name>", "New folder name").option("--parent-id <id>", "New parent folder ID (use 'null' for root)").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus folder update abc-123 --name "Renamed Folder"
+  $ nexus folder update abc-123 --parent-id null
+  $ nexus folder update abc-123 --body '{"name":"Renamed"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.name !== void 0) flags.name = opts.name;
+      if (opts.parentId !== void 0) {
+        flags.parentId = opts.parentId === "null" ? null : opts.parentId;
+      }
+      const body = mergeBodyWithFlags(base, flags);
+      await client.folders.update(id, body);
+      printSuccess("Folder updated.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  folder.command("delete").description("Delete a folder (agents are unassigned, not deleted)").argument("<id>", "Folder ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus folder delete abc-123
+  $ nexus folder delete abc-123 --yes`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await rl.question(
+          `Delete folder ${id}? Agents will be unassigned. [y/N] `
+        );
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.folders.delete(id);
+      printSuccess("Folder deleted.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  folder.command("assign").description("Assign an agent to a folder (or remove from folder)").requiredOption("--agent-id <id>", "Agent ID").requiredOption("--folder-id <id>", "Folder ID (use 'null' to remove)").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus folder assign --agent-id agt-123 --folder-id fld-456
+  $ nexus folder assign --agent-id agt-123 --folder-id null
+  $ nexus folder assign --body '{"agentId":"agt-123","folderId":"fld-456"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.agentId !== void 0) flags.agentId = opts.agentId;
+      if (opts.folderId !== void 0) {
+        flags.folderId = opts.folderId === "null" ? null : opts.folderId;
+      }
+      const assignBody = mergeBodyWithFlags(base, flags);
+      const folderId = assignBody.folderId;
+      await client.folders.assignAgent(assignBody);
+      if (folderId) {
+        printSuccess("Agent assigned to folder.", {
+          agentId: opts.agentId,
+          folderId
+        });
+      } else {
+        printSuccess("Agent removed from folder.", {
+          agentId: opts.agentId
+        });
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/model.ts
+init_output();
+function registerModelCommands(program2) {
+  const model = program2.command("model").description("Manage AI models");
+  model.command("list").description("List available AI models").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus model list
+  $ nexus model list --json`
+  ).action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.models.list();
+      const items = Array.isArray(result) ? result : result.data ?? result;
+      printList(items, void 0, [
+        { key: "name", label: "NAME", width: 30 },
+        { key: "provider", label: "PROVIDER", width: 20 },
+        { key: "id", label: "ID", width: 36 },
+        { key: "contextWindow", label: "CONTEXT", width: 12 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/prompt-assistant.ts
+init_output();
+function registerPromptAssistantCommands(program2) {
+  const pa = program2.command("prompt-assistant").description("AI-powered prompt writing assistant");
+  pa.command("chat").description("Send a message to the prompt assistant").option("--message <text-or->", "Message text (or '-' for stdin)").option("--mode <mode>", "Mode: agent or ai-task").option("--thread-id <id>", "Thread ID for multi-turn conversations").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus prompt-assistant chat --message "Create a customer support agent" --mode agent
+  $ nexus prompt-assistant chat --message "Improve the prompt" --thread-id thr-123
+  $ echo "Write a summarization task" | nexus prompt-assistant chat --message - --mode ai-task
+  $ nexus prompt-assistant chat --body '{"message":"Help me","mode":"agent"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.mode) flags.mode = opts.mode;
+      if (opts.threadId) flags.threadId = opts.threadId;
+      if (opts.message) flags.message = await resolveInputValue(opts.message);
+      const body = mergeBodyWithFlags(base, flags);
+      const result = await client.promptAssistant.chat(body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  pa.command("get-thread").description("Get a prompt assistant thread with messages").argument("<thread-id>", "Thread ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus prompt-assistant get-thread thr-123
+  $ nexus prompt-assistant get-thread thr-123 --json`
+  ).action(async (threadId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const t = await client.promptAssistant.getThread(threadId);
+      printRecord(t, [
+        { key: "id", label: "ID" },
+        { key: "mode", label: "Mode" },
+        { key: "messages", label: "Messages" },
+        { key: "promptResult", label: "Prompt Result" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  pa.command("delete-thread").description("Delete a prompt assistant thread").argument("<thread-id>", "Thread ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus prompt-assistant delete-thread thr-123
+  $ nexus prompt-assistant delete-thread thr-123 --yes`
+  ).action(async (threadId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Delete thread ${threadId}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.promptAssistant.deleteThread(threadId);
+      printSuccess("Thread deleted.", { threadId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/task.ts
+init_output();
+function registerTaskCommands(program2) {
+  const task = program2.command("task").description("Manage AI tasks");
+  task.command("list").description("List AI tasks").option("--search <query>", "Search by name").option("--limit <number>", "Max results", parseInt).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus task list
+  $ nexus task list --search "summarize" --limit 10
+  $ nexus task list --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.skills.listTasks({
+        search: opts.search,
+        limit: opts.limit
+      });
+      const items = result.items ?? [];
+      printTable(items, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "category", label: "CATEGORY", width: 15 },
+        { key: "inputFormat", label: "INPUT", width: 10 },
+        { key: "outputFormat", label: "OUTPUT", width: 10 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  task.command("get").description("Get AI task details").argument("<id>", "Task ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus task get task-123
+  $ nexus task get task-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const t = await client.skills.getTask(id);
+      printRecord(t, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "category", label: "Category" },
+        { key: "modelName", label: "Model" },
+        { key: "modelProvider", label: "Provider" },
+        { key: "inputFormat", label: "Input Format" },
+        { key: "outputFormat", label: "Output Format" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  task.command("create").description("Create an AI task").requiredOption("--name <name>", "Task name").requiredOption("--model-name <model>", "Model name (e.g. gpt-4o)").requiredOption("--model-provider <provider>", "Model provider (e.g. OPEN_AI)").option("--expected-input <text>", "Description of expected input").option("--expected-output <text>", "Description of expected output").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus task create --name "Summarize Email" --model-name gpt-4o --model-provider OPEN_AI
+  $ nexus task create --name "Classify" --model-name gpt-4o --model-provider OPEN_AI --expected-input "Raw text" --expected-output "Category label"
+  $ nexus task create --body '{"name":"Summarize","modelName":"gpt-4o","modelProvider":"OPEN_AI"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.name !== void 0) flags.name = opts.name;
+      if (opts.modelName !== void 0) flags.modelName = opts.modelName;
+      if (opts.modelProvider !== void 0) flags.modelProvider = opts.modelProvider;
+      if (opts.expectedInput || opts.expectedOutput) {
+        flags.generation = {
+          expectedInput: opts.expectedInput,
+          expectedOutput: opts.expectedOutput
+        };
+      }
+      const body = mergeBodyWithFlags(base, flags);
+      const t = await client.skills.createTask(body);
+      printSuccess("Task created.", {
+        id: t.id,
+        name: t.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  task.command("execute").description("Execute an AI task").argument("<id>", "Task ID").requiredOption("--input <text-or-->", "Input text (or '-' for stdin)").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus task execute task-123 --input "Summarize this email..."
+  $ cat document.txt | nexus task execute task-123 --input -
+  $ nexus task execute task-123 --input "Hello world" --json
+  $ nexus task execute task-123 --body '{"input":"Hello world"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const flags = {};
+      if (opts.input) flags.input = await resolveInputValue(opts.input);
+      const execBody = mergeBodyWithFlags(base, flags);
+      const result = await client.skills.executeTask(id, execBody);
+      if (isJsonMode()) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(result.output ?? JSON.stringify(result, null, 2));
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/template.ts
+var import_node_fs3 = __toESM(require("fs"));
+var import_node_path3 = __toESM(require("path"));
+init_output();
+function registerTemplateCommands(program2) {
+  const template = program2.command("template").description("Manage document templates");
+  template.command("list").description("List document templates").option("--search <query>", "Search by name").option("--limit <number>", "Max results", parseInt).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus template list
+  $ nexus template list --search "invoice" --limit 10
+  $ nexus template list --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.skills.listDocumentTemplates({
+        search: opts.search,
+        limit: opts.limit
+      });
+      const items = Array.isArray(result) ? result : result.items ?? result.data ?? result;
+      printList(items, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "description", label: "DESCRIPTION", width: 40 },
+        { key: "createdAt", label: "CREATED", width: 26 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  template.command("get").description("Get document template details").argument("<id>", "Template ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus template get tmpl-123
+  $ nexus template get tmpl-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const t = await client.skills.getDocumentTemplate(id);
+      printRecord(t, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" },
+        { key: "fileName", label: "File Name" },
+        { key: "createdAt", label: "Created" },
+        { key: "updatedAt", label: "Updated" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  template.command("create").description("Create a document template").option("--name <name>", "Template name").option("--description <text>", "Template description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus template create --name "Invoice Template"
+  $ nexus template create --name "Report" --description "Monthly report template"
+  $ nexus template create --body '{"name":"Contract","description":"Standard contract"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        name: opts.name,
+        description: opts.description
+      });
+      const t = await client.skills.createDocumentTemplate(body);
+      printSuccess("Template created.", {
+        id: t.id,
+        name: t.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  template.command("upload").description("Upload a file to a document template").argument("<id>", "Template ID").requiredOption("--file <path>", "Path to the template file").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus template upload tmpl-123 --file ./invoice.docx
+  $ nexus template upload tmpl-123 --file ./report.pdf`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const absPath = import_node_path3.default.resolve(opts.file);
+      if (!import_node_fs3.default.existsSync(absPath)) {
+        console.error(`Error: File not found: ${absPath}`);
+        process.exitCode = 1;
+        return;
+      }
+      const buffer = import_node_fs3.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);
+      printSuccess("File uploaded to template.", {
+        templateId: id,
+        fileName
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  template.command("generate").description("Generate a document from a template").argument("<id>", "Template ID").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus template generate tmpl-123 --body '{"variables":{"name":"Acme Corp","date":"2026-01-01"}}'
+  $ nexus template generate tmpl-123 --body variables.json
+  $ nexus template generate tmpl-123 --body '{"variables":{"amount":100}}' --json`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const result = await client.skills.generateDocumentTemplate(id, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/ticket.ts
+init_output();
+function registerTicketCommands(program2) {
+  const ticket = program2.command("ticket").description("Manage tickets (bugs, feature requests, improvements)");
+  addPaginationOptions(
+    ticket.command("list").description("List tickets").option("--type <type>", "Filter by type (BUG, FEATURE_REQUEST, IMPROVEMENT)").option("--priority <priority>", "Filter by priority (NONE, URGENT, HIGH, MEDIUM, LOW)").option("--status <status>", "Filter by status").option("--search <query>", "Search by title or description").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus ticket list
+  $ nexus ticket list --type BUG --priority HIGH
+  $ nexus ticket list --search "login" --json`
+    )
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.tickets.list({
+        ...getPaginationParams(opts),
+        type: opts.type,
+        priority: opts.priority,
+        status: opts.status,
+        search: opts.search
+      });
+      printList(
+        data,
+        meta,
+        [
+          { key: "identifier", label: "IDENTIFIER", width: 12 },
+          { key: "title", label: "TITLE", width: 40 },
+          { key: "type", label: "TYPE", width: 18 },
+          { key: "priority", label: "PRIORITY", width: 10 },
+          { key: "status", label: "STATUS", width: 15 }
+        ]
+      );
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  ticket.command("get").description("Get ticket details").argument("<id>", "Ticket ID or identifier").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus ticket get TKT-42
+  $ nexus ticket get TKT-42 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const t = await client.tickets.get(id);
+      printRecord(t, [
+        { key: "id", label: "ID" },
+        { key: "identifier", label: "Identifier" },
+        { key: "title", label: "Title" },
+        { key: "type", label: "Type" },
+        { key: "priority", label: "Priority" },
+        { key: "status", label: "Status" },
+        { key: "url", label: "URL" },
+        { key: "description", label: "Description" },
+        { key: "createdAt", label: "Created" },
+        { key: "updatedAt", label: "Updated" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  ticket.command("create").description("Create a new ticket").requiredOption("--title <title>", "Ticket title").option("--type <type>", "Ticket type (BUG, FEATURE_REQUEST, IMPROVEMENT)").option("--priority <priority>", "Priority (NONE, URGENT, HIGH, MEDIUM, LOW)").option("--description <text>", "Ticket description").option("--data <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus ticket create --title "Login fails with SSO"
+  $ nexus ticket create --title "Add dark mode" --type FEATURE_REQUEST --priority MEDIUM
+  $ nexus ticket create --title "Bug report" --type BUG --description "Steps to reproduce..."
+  $ nexus ticket create --data '{"title":"Bug","type":"BUG"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.data);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.title !== void 0 && { title: opts.title },
+        ...opts.type !== void 0 && { type: opts.type },
+        ...opts.priority !== void 0 && { priority: opts.priority },
+        ...opts.description !== void 0 && { description: opts.description }
+      });
+      const t = await client.tickets.create(body);
+      printRecord(t, [
+        { key: "id", label: "ID" },
+        { key: "identifier", label: "Identifier" },
+        { key: "title", label: "Title" },
+        { key: "type", label: "Type" },
+        { key: "priority", label: "Priority" },
+        { key: "status", label: "Status" },
+        { key: "url", label: "URL" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  ticket.command("update").description("Update a ticket").argument("<id>", "Ticket ID or identifier").option("--title <title>", "Updated title").option("--type <type>", "Updated type (BUG, FEATURE_REQUEST, IMPROVEMENT)").option("--priority <priority>", "Updated priority (NONE, URGENT, HIGH, MEDIUM, LOW)").option("--description <text>", "Updated description").option("--data <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus ticket update TKT-42 --priority URGENT
+  $ nexus ticket update TKT-42 --title "Updated title" --type BUG
+  $ nexus ticket update TKT-42 --data '{"priority":"URGENT"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.data);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.title !== void 0 && { title: opts.title },
+        ...opts.type !== void 0 && { type: opts.type },
+        ...opts.priority !== void 0 && { priority: opts.priority },
+        ...opts.description !== void 0 && { description: opts.description }
+      });
+      const t = await client.tickets.update(id, body);
+      printRecord(t, [
+        { key: "id", label: "ID" },
+        { key: "identifier", label: "Identifier" },
+        { key: "title", label: "Title" },
+        { key: "type", label: "Type" },
+        { key: "priority", label: "Priority" },
+        { key: "status", label: "Status" },
+        { key: "url", label: "URL" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  ticket.command("comment").description("Add a comment to a ticket").argument("<id>", "Ticket ID or identifier").requiredOption("--body <text-or-->", "Comment body (text or '-' for stdin)").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus ticket comment TKT-42 --body "This is fixed in v2.1"
+  $ echo "Detailed comment" | nexus ticket comment TKT-42 --body -`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveInputValue(opts.body);
+      await client.tickets.addComment(id, { body });
+      printSuccess("Comment added.", { ticketId: id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  ticket.command("comments").description("List comments on a ticket").argument("<id>", "Ticket ID or identifier").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus ticket comments TKT-42
+  $ nexus ticket comments TKT-42 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.tickets.listComments(id);
+      const comments = result.comments ?? result;
+      printList(comments, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "authorName", label: "AUTHOR", width: 20 },
+        { key: "body", label: "BODY", width: 50 },
+        { key: "createdAt", label: "CREATED", width: 20 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/tool.ts
+init_output();
+function registerToolCommands(program2) {
+  const tool = program2.command("tool").description("Discover and manage marketplace tools");
+  tool.command("search").description("Search marketplace tools").option("--query <query>", "Search query").option("--category <category>", "Filter by category").option("--type <type>", "Filter by type").option("--limit <number>", "Max results", parseInt).addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus tool search --query "gmail"
+  $ nexus tool search --category "Communication" --limit 10
+  $ nexus tool search --query "slack" --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.tools.search({
+        q: opts.query,
+        category: opts.category,
+        type: opts.type,
+        limit: opts.limit
+      });
+      const tools = result.tools ?? [];
+      printTable(tools, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 25 },
+        { key: "type", label: "TYPE", width: 12 },
+        { key: "description", label: "DESCRIPTION", width: 40 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  tool.command("get").description("Get marketplace tool details").argument("<id>", "Tool ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus tool get tool-123
+  $ nexus tool get tool-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const detail = await client.tools.get(id);
+      printRecord(detail);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  tool.command("credentials").description("List credentials for a marketplace tool").argument("<id>", "Tool ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus tool credentials tool-123
+  $ nexus tool credentials tool-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.tools.credentials(id);
+      const creds = result.credentials ?? [];
+      printTable(creds, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 25 },
+        { key: "type", label: "TYPE", width: 12 },
+        { key: "createdAt", label: "CREATED", width: 20 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  tool.command("connect").description("Connect a tool via OAuth or HTTP credentials").argument("<id>", "Tool ID").option("--auth-type <type>", "Auth type: oauth or http", "oauth").option("--api-key-value <key>", "API key for HTTP auth").option("--auth-header <header>", "Authorization header type for HTTP auth", "bearer").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus tool connect tool-123
+  $ nexus tool connect tool-123 --auth-type http --api-key-value sk-abc123
+  $ nexus tool connect tool-123 --body '{"authType":"http","apiKey":"sk-abc"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      if (base) {
+        const flags = {};
+        if (opts.authType !== void 0) flags.authType = opts.authType;
+        if (opts.apiKeyValue !== void 0) flags.apiKey = opts.apiKeyValue;
+        if (opts.authHeader !== void 0) flags.authorizationType = opts.authHeader;
+        const body = mergeBodyWithFlags(base, flags);
+        const result = await client.toolConnection.connect(id, body);
+        printSuccess("Tool connected.", result);
+      } else if (opts.authType === "http") {
+        if (!opts.apiKeyValue) {
+          console.error(
+            "Error: --api-key-value is required for HTTP auth.\n  nexus tool connect <id> --auth-type http --api-key-value <key>"
+          );
+          process.exitCode = 1;
+          return;
+        }
+        const result = await client.toolConnection.connect(id, {
+          authType: "http",
+          apiKey: opts.apiKeyValue,
+          authorizationType: opts.authHeader
+        });
+        printSuccess("Tool connected via HTTP.", result);
+      } else {
+        const result = await client.toolConnection.connect(id, {
+          authType: "oauth"
+        });
+        printSuccess("OAuth flow initiated.", result);
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/version.ts
+init_output();
+function registerVersionCommands(program2) {
+  const version = program2.command("version").description("Manage agent prompt versions");
+  addPaginationOptions(
+    version.command("list").description("List prompt versions for an agent").argument("<agent-id>", "Agent ID").option("--type <type>", "Filter by type (AUTO, CHECKPOINT)").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus version list agt-123
+  $ nexus version list agt-123 --type CHECKPOINT
+  $ nexus version list agt-123 --limit 5 --json`
+    )
+  ).action(async (agentId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.agents.versions.list(agentId, {
+        ...getPaginationParams(opts),
+        type: opts.type
+      });
+      printList(
+        data,
+        meta,
+        [
+          { key: "id", label: "ID", width: 36 },
+          { key: "name", label: "NAME", width: 25 },
+          { key: "type", label: "TYPE", width: 12 },
+          { key: "isProduction", label: "PROD", width: 6, format: (v) => v ? "yes" : "no" },
+          { key: "createdAt", label: "CREATED", width: 20 }
+        ]
+      );
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  version.command("get").description("Get version details with full prompt").argument("<agent-id>", "Agent ID").argument("<version-id>", "Version ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus version get agt-123 ver-456
+  $ nexus version get agt-123 ver-456 --json`
+  ).action(async (agentId, versionId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const ver = await client.agents.versions.get(agentId, versionId);
+      printRecord(ver, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "type", label: "Type" },
+        { key: "isProduction", label: "Production", format: (v) => v ? "yes" : "no" },
+        { key: "prompt", label: "Prompt" },
+        { key: "createdAt", label: "Created" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  version.command("create").description("Create a named checkpoint of the current prompt").argument("<agent-id>", "Agent ID").option("--name <name>", "Checkpoint name").option("--description <text>", "Checkpoint description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus version create agt-123
+  $ nexus version create agt-123 --name "v1.0" --description "Initial release"
+  $ nexus version create agt-123 --body '{"name":"v1.0"}'`
+  ).action(async (agentId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name },
+        ...opts.description !== void 0 && { description: opts.description }
+      });
+      const ver = await client.agents.versions.createCheckpoint(agentId, body);
+      printSuccess("Checkpoint created.", {
+        id: ver.id,
+        name: ver.name ?? "(unnamed)"
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  version.command("update").description("Update version metadata").argument("<agent-id>", "Agent ID").argument("<version-id>", "Version ID").option("--name <name>", "New name").option("--description <text>", "New description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus version update agt-123 ver-456 --name "v1.1"
+  $ nexus version update agt-123 ver-456 --body '{"name":"v1.1"}'`
+  ).action(async (agentId, versionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name },
+        ...opts.description !== void 0 && { description: opts.description }
+      });
+      await client.agents.versions.update(agentId, versionId, body);
+      printSuccess("Version updated.", { id: versionId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  version.command("delete").description("Delete a prompt version").argument("<agent-id>", "Agent ID").argument("<version-id>", "Version ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus version delete agt-123 ver-456
+  $ nexus version delete agt-123 ver-456 --yes`
+  ).action(async (agentId, versionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(`Delete version ${versionId}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.agents.versions.delete(agentId, versionId);
+      printSuccess("Version deleted.", { id: versionId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  version.command("restore").description("Restore agent prompt to a previous version").argument("<agent-id>", "Agent ID").argument("<version-id>", "Version ID to restore").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus version restore agt-123 ver-456
+  $ nexus version restore agt-123 ver-456 --yes`
+  ).action(async (agentId, versionId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await rl.question(
+          `Restore agent ${agentId} to version ${versionId}? This will overwrite the current prompt. [y/N] `
+        );
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      const result = await client.agents.versions.restore(agentId, versionId);
+      printSuccess("Version restored.", { agentId, versionId, ...result });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  version.command("publish").description("Publish a version to production").argument("<agent-id>", "Agent ID").argument("<version-id>", "Version ID to publish").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus version publish agt-123 ver-456`
+  ).action(async (agentId, versionId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.agents.versions.publish(agentId, versionId);
+      printSuccess("Version published to production.", {
+        id: result.id,
+        isProduction: "true"
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/workflow.ts
+init_output();
+
+// src/commands/workflow-builder.ts
+init_output();
+function registerWorkflowBuilderCommands(workflow, program2) {
+  const node = workflow.command("node").description("Manage workflow nodes");
+  node.command("create").description("Create a node in a workflow").argument("<wf-id>", "Workflow ID").requiredOption("--type <type>", "Node type").option("--body <json-or-file-or-->", "Additional body JSON (merged with --type)").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node create wf-123 --type action
+  $ nexus workflow node create wf-123 --type condition --body '{"position":{"x":100,"y":200}}'
+  $ nexus workflow node create wf-123 --type action --body payload.json`
+  ).action(async (wfId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const extra = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(extra, { type: opts.type });
+      const result = await client.workflows.createNode(wfId, body);
+      printRecord(result, [
+        { key: "id", label: "ID" },
+        { key: "type", label: "Type" },
+        { key: "position", label: "Position" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  node.command("get").description("Get node details").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node get wf-123 node-456
+  $ nexus workflow node get wf-123 node-456 --json`
+  ).action(async (wfId, nodeId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.getNode(wfId, nodeId);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  node.command("update").description("Update node data/config").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").requiredOption("--body <json-or-file-or-->", "Node data/config JSON").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node update wf-123 node-456 --body '{"data":{"message":"hello"}}'
+  $ nexus workflow node update wf-123 node-456 --body config.json
+  $ echo '{"data":{"key":"val"}}' | nexus workflow node update wf-123 node-456 --body -`
+  ).action(async (wfId, nodeId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const result = await client.workflows.updateNode(wfId, nodeId, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  node.command("delete").description("Delete a node from a workflow").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node delete wf-123 node-456
+  $ nexus workflow node delete wf-123 node-456 --yes`
+  ).action(async (wfId, nodeId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await rl.question(`Delete node ${nodeId} from workflow ${wfId}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.workflows.deleteNode(wfId, nodeId);
+      printSuccess("Node deleted.", { workflowId: wfId, nodeId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  node.command("test").description("Run a test execution of a single node").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").option("--body <json-or-file-or-->", "Optional mock data JSON").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node test wf-123 node-456
+  $ nexus workflow node test wf-123 node-456 --body '{"input":"test"}'`
+  ).action(async (wfId, nodeId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const result = await client.workflows.testNode(wfId, nodeId, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  node.command("variables").description("List available upstream variables for a node").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node variables wf-123 node-456
+  $ nexus workflow node variables wf-123 node-456 --json`
+  ).action(async (wfId, nodeId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.getAvailableVariables(wfId, nodeId);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  node.command("output-format").description("Show node output schema").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node output-format wf-123 node-456
+  $ nexus workflow node output-format wf-123 node-456 --json`
+  ).action(async (wfId, nodeId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.getOutputFormat(wfId, nodeId);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  node.command("reload-props").description("Reload dynamic props for a Pipedream node").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").requiredOption("--body <json-or-file-or-->", "Configured props JSON").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node reload-props wf-123 node-456 --body '{"configuredProps":{"account":"acc-1"}}'
+  $ nexus workflow node reload-props wf-123 node-456 --body props.json`
+  ).action(async (wfId, nodeId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const result = await client.workflows.reloadProps(wfId, nodeId, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  const edge = workflow.command("edge").description("Manage workflow edges (connections between nodes)");
+  edge.command("create").description("Create an edge between two nodes").argument("<wf-id>", "Workflow ID").requiredOption("--source <node-id>", "Source node ID").requiredOption("--target <node-id>", "Target node ID").option("--source-handle <handle>", "Source handle identifier").option("--body <json-or-file-or-->", "Additional body JSON").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow edge create wf-123 --source node-1 --target node-2
+  $ nexus workflow edge create wf-123 --source node-1 --target node-2 --source-handle branch-a
+  $ nexus workflow edge create wf-123 --source node-1 --target node-2 --body '{"type":"conditional"}'`
+  ).action(async (wfId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const extra = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(extra, {
+        source: opts.source,
+        target: opts.target,
+        ...opts.sourceHandle ? { sourceHandle: opts.sourceHandle } : {}
+      });
+      const result = await client.workflows.createEdge(wfId, body);
+      printRecord(result, [
+        { key: "id", label: "ID" },
+        { key: "source", label: "Source" },
+        { key: "target", label: "Target" },
+        { key: "sourceHandle", label: "Source Handle" },
+        { key: "type", label: "Type" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  edge.command("delete").description("Delete an edge from a workflow").argument("<wf-id>", "Workflow ID").argument("<edge-id>", "Edge ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow edge delete wf-123 edge-789
+  $ nexus workflow edge delete wf-123 edge-789 --yes`
+  ).action(async (wfId, edgeId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await rl.question(`Delete edge ${edgeId} from workflow ${wfId}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.workflows.deleteEdge(wfId, edgeId);
+      printSuccess("Edge deleted.", { workflowId: wfId, edgeId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  const branch = workflow.command("branch").description("Manage branches on condition/router nodes");
+  branch.command("list").description("List branches on a node").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow branch list wf-123 node-456
+  $ nexus workflow branch list wf-123 node-456 --json`
+  ).action(async (wfId, nodeId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.listBranches(wfId, nodeId);
+      const branches = Array.isArray(result) ? result : result.data ?? result;
+      printList(branches, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "name", label: "NAME", width: 30 },
+        { key: "conditions", label: "CONDITIONS", width: 40 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  branch.command("create").description("Create a branch on a node").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").requiredOption("--name <name>", "Branch name").option("--body <json-or-file-or-->", "Additional body JSON (conditions, etc.)").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow branch create wf-123 node-456 --name "Has email"
+  $ nexus workflow branch create wf-123 node-456 --name "VIP" --body '{"conditions":[{"field":"tier","op":"eq","value":"vip"}]}'`
+  ).action(async (wfId, nodeId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const extra = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(extra, { name: opts.name });
+      const result = await client.workflows.createBranch(wfId, nodeId, body);
+      printRecord(result, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "conditions", label: "Conditions" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  branch.command("update").description("Update a branch").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").argument("<branch-id>", "Branch ID").requiredOption("--body <json-or-file-or-->", "Updated branch JSON (name, conditions)").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow branch update wf-123 node-456 br-789 --body '{"name":"Renamed","conditions":[]}'
+  $ nexus workflow branch update wf-123 node-456 br-789 --body branch.json`
+  ).action(async (wfId, nodeId, branchId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const body = await resolveBody(opts.body);
+      const result = await client.workflows.updateBranch(wfId, nodeId, branchId, body);
+      printRecord(result, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "conditions", label: "Conditions" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  branch.command("delete").description("Delete a branch from a node").argument("<wf-id>", "Workflow ID").argument("<node-id>", "Node ID").argument("<branch-id>", "Branch ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow branch delete wf-123 node-456 br-789
+  $ nexus workflow branch delete wf-123 node-456 br-789 --yes`
+  ).action(async (wfId, nodeId, branchId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await rl.question(`Delete branch ${branchId} from node ${nodeId}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.workflows.deleteBranch(wfId, nodeId, branchId);
+      printSuccess("Branch deleted.", { workflowId: wfId, nodeId, branchId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("node-types").description("List available node types").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node-types
+  $ nexus workflow node-types --json`
+  ).action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.listNodeTypes();
+      const types = Array.isArray(result) ? result : result.data ?? result;
+      printList(types, void 0, [
+        { key: "type", label: "TYPE", width: 30 },
+        { key: "category", label: "CATEGORY", width: 20 },
+        { key: "label", label: "LABEL", width: 30 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("node-type").description("Get full schema for a node type").argument("<type>", "Node type identifier").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow node-type action
+  $ nexus workflow node-type condition --json`
+  ).action(async (type) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.getNodeTypeSchema(type);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("overview").description("Get high-level workflow overview with per-node config status").argument("<wf-id>", "Workflow ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow overview wf-123
+  $ nexus workflow overview wf-123 --json`
+  ).action(async (wfId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.getOverview(wfId);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("layout").description("Auto-position nodes in a workflow").argument("<wf-id>", "Workflow ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow layout wf-123`
+  ).action(async (wfId) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      await client.workflows.layout(wfId);
+      printSuccess("Workflow layout applied.", { workflowId: wfId });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("trigger").description("Replace the trigger node of a workflow").argument("<wf-id>", "Workflow ID").requiredOption("--type <type>", "New trigger type").option("--body <json-or-file-or-->", "Additional body JSON").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow trigger wf-123 --type webhook
+  $ nexus workflow trigger wf-123 --type schedule --body '{"cron":"0 9 * * *"}'`
+  ).action(async (wfId, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const extra = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(extra, { type: opts.type });
+      const result = await client.workflows.replaceTrigger(wfId, body);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
+// src/commands/workflow.ts
+function registerWorkflowCommands(program2) {
+  const workflow = program2.command("workflow").description("Manage workflows");
+  addPaginationOptions(
+    workflow.command("list").description("List workflows").option("--status <status>", "Filter by status (DRAFT, PUBLISHED)").option("--search <query>", "Search by name").addHelpText(
+      "after",
+      `
+Examples:
+  $ nexus workflow list
+  $ nexus workflow list --status PUBLISHED --limit 10
+  $ nexus workflow list --search "onboarding" --json`
+    )
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const { data, meta } = await client.workflows.list({
+        ...getPaginationParams(opts),
+        status: opts.status,
+        search: opts.search
+      });
+      printList(
+        data,
+        meta,
+        [
+          { key: "id", label: "ID", width: 36 },
+          { key: "name", label: "NAME", width: 30 },
+          { key: "status", label: "STATUS", width: 12 },
+          { key: "createdAt", label: "CREATED", width: 20 }
+        ]
+      );
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("get").description("Get workflow details").argument("<id>", "Workflow ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow get wf-123
+  $ nexus workflow get wf-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const wf = await client.workflows.get(id);
+      printRecord(wf, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "description", label: "Description" },
+        { key: "status", label: "Status" },
+        { key: "createdAt", label: "Created" },
+        { key: "updatedAt", label: "Updated" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("create").description("Create a new workflow").requiredOption("--name <name>", "Workflow name").option("--description <text>", "Workflow description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow create --name "Customer Onboarding"
+  $ nexus workflow create --name "Data Pipeline" --description "ETL workflow"
+  $ nexus workflow create --body '{"name":"Pipeline","description":"ETL"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name },
+        ...opts.description !== void 0 && { description: opts.description }
+      });
+      const wf = await client.workflows.create(body);
+      printSuccess("Workflow created.", {
+        id: wf.id,
+        name: wf.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("update").description("Update a workflow").argument("<id>", "Workflow ID").option("--name <name>", "Workflow name").option("--description <text>", "Workflow description").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow update wf-123 --name "Renamed Workflow"
+  $ nexus workflow update wf-123 --description "Updated description"
+  $ nexus workflow update wf-123 --body '{"name":"Renamed"}'`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.name !== void 0 && { name: opts.name },
+        ...opts.description !== void 0 && { description: opts.description }
+      });
+      await client.workflows.update(id, body);
+      printSuccess("Workflow updated.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("delete").description("Delete a workflow").argument("<id>", "Workflow ID").option("--yes", "Skip confirmation").option("--dry-run", "Preview without deleting").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow delete wf-123
+  $ nexus workflow delete wf-123 --yes
+  $ nexus workflow delete wf-123 --dry-run`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      if (opts.dryRun) {
+        const wf = await client.workflows.get(id);
+        console.log(
+          color.yellow("DRY RUN:") + ` Would delete workflow "${wf.name}" (${id})`
+        );
+        return;
+      }
+      if (!opts.yes && process.stdout.isTTY) {
+        const readline2 = await import("readline/promises");
+        const rl = readline2.createInterface({
+          input: process.stdin,
+          output: process.stdout
+        });
+        const answer = await rl.question(`Delete workflow ${id}? This cannot be undone. [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.workflows.delete(id);
+      printSuccess("Workflow deleted.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("duplicate").description("Duplicate a workflow").argument("<id>", "Workflow ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow duplicate wf-123`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const wf = await client.workflows.duplicate(id);
+      printSuccess("Workflow duplicated.", {
+        id: wf.id,
+        name: wf.name
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("publish").description("Publish a workflow").argument("<id>", "Workflow ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow publish wf-123`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.publish(id);
+      printSuccess("Workflow published.", { id, ...result });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("unpublish").description("Unpublish a workflow").argument("<id>", "Workflow ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow unpublish wf-123`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.workflows.unpublish(id);
+      printSuccess("Workflow unpublished.", { id, ...result });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("validate").description("Validate a workflow").argument("<id>", "Workflow ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow validate wf-123
+  $ nexus workflow validate wf-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const report = await client.workflows.validate(id);
+      printRecord(report);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  workflow.command("test").description("Run a test execution of a workflow").argument("<id>", "Workflow ID").option("--input <json>", "Input JSON for the test").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus workflow test wf-123 --input '{"message": "hello"}'
+  $ nexus workflow test wf-123 --body '{"message": "hello"}'
+  $ nexus workflow test wf-123 --json`
+  ).action(async (id, opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const input = opts.input ? JSON.parse(opts.input) : base ?? {};
+      const result = await client.workflows.testWorkflow(id, input);
+      printRecord(result);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  registerWorkflowBuilderCommands(workflow, program2);
+}
+
+// src/index.ts
+init_output();
+
+// src/util/version-check.ts
+var import_node_fs4 = __toESM(require("fs"));
+var import_node_os2 = __toESM(require("os"));
+var import_node_path4 = __toESM(require("path"));
+var PACKAGE_NAME = "@agent-nexus/cli";
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+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_fs4.default.readFileSync(CACHE_FILE, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function saveCache(cache) {
+  try {
+    const dir = import_node_path4.default.dirname(CACHE_FILE);
+    import_node_fs4.default.mkdirSync(dir, { recursive: true, mode: 448 });
+    import_node_fs4.default.writeFileSync(CACHE_FILE, JSON.stringify(cache), { mode: 384 });
+  } catch {
+  }
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+      signal: controller.signal
+    });
+    clearTimeout(timer);
+    if (!res.ok) return null;
+    const json = await res.json();
+    return json.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function compareSemver(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (diff !== 0) return diff < 0 ? -1 : 1;
+  }
+  return 0;
+}
+async function checkForUpdate(currentVersion) {
+  try {
+    const cache = loadCache();
+    if (cache && Date.now() - cache.lastChecked < CHECK_INTERVAL_MS) {
+      if (compareSemver(currentVersion, cache.latestVersion) < 0) {
+        return formatUpdateMessage(currentVersion, cache.latestVersion);
+      }
+      return null;
+    }
+    const latest = await fetchLatestVersion();
+    if (!latest) return null;
+    saveCache({ lastChecked: Date.now(), latestVersion: latest });
+    if (compareSemver(currentVersion, latest) < 0) {
+      return formatUpdateMessage(currentVersion, latest);
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function formatUpdateMessage(current, latest) {
+  return `
+  Update available: ${current} \u2192 ${latest}
+  Run "npm update -g ${PACKAGE_NAME}" to update.
+  IMPORTANT: You MUST update before running any other nexus commands. Results from an outdated CLI may be incorrect.
+`;
+}
+
+// src/index.ts
+var VERSION = "0.1.0";
+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").hook("preAction", (thisCommand) => {
+  const opts = thisCommand.optsWithGlobals();
+  if (opts.json) setJsonMode(true);
+});
+program.addHelpText("before", getBanner(VERSION));
+program.configureHelp({
+  sortSubcommands: true
+});
+registerAuthCommands(program);
+registerAgentCommands(program);
+registerAgentToolCommands(program);
+registerVersionCommands(program);
+registerFolderCommands(program);
+registerDeploymentCommands(program);
+registerWorkflowCommands(program);
+registerExecutionCommands(program);
+registerDocumentCommands(program);
+registerCollectionCommands(program);
+registerTaskCommands(program);
+registerToolCommands(program);
+registerAnalyticsCommands(program);
+registerTicketCommands(program);
+registerApiCommand(program);
+registerEmulatorCommands(program);
+registerEvaluationCommands(program);
+registerTemplateCommands(program);
+registerExternalToolCommands(program);
+registerPromptAssistantCommands(program);
+registerModelCommands(program);
+if (process.argv.length <= 2) {
+  program.help();
+}
+program.parseAsync(process.argv).then(async () => {
+  const updateMsg = await checkForUpdate(VERSION);
+  if (updateMsg && !isJsonMode()) {
+    const { color: color2 } = await Promise.resolve().then(() => (init_output(), output_exports));
+    process.stderr.write(color2.yellow(updateMsg));
+  }
+}).catch((err) => {
+  process.exitCode = handleError(err);
+});