@nuntly/cli 1.0.0-alpha.1

package/dist/index.js

@@ -0,0 +1,1254 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command as Command11 } from "@commander-js/extra-typings";
+import pc4 from "picocolors";
+
+// src/commands/emails.ts
+import { Command } from "@commander-js/extra-typings";
+import { Nuntly } from "@nuntly/sdk";
+
+// src/auth.ts
+import { execSync } from "child_process";
+import {
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync
+} from "fs";
+import { homedir, platform } from "os";
+import { resolve } from "path";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+var CONFIG_DIR = resolve(homedir(), ".nuntly");
+var CONFIG_PATH = resolve(CONFIG_DIR, "config.json");
+function loadRawConfig() {
+  if (!existsSync(CONFIG_PATH)) return {};
+  try {
+    return JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function resolveProfile(config, profileName) {
+  if (!config.profiles && config.apiKey) {
+    return {
+      apiKey: config.apiKey,
+      baseUrl: config.baseUrl,
+      outputFormat: config.outputFormat
+    };
+  }
+  const name = profileName ?? config.defaultProfile ?? "default";
+  return config.profiles?.[name] ?? {};
+}
+function restrictFilePermissions(filePath) {
+  if (platform() === "win32") {
+    try {
+      execSync(
+        `icacls "${filePath}" /inheritance:r /grant:r "%USERNAME%:(R,W)" /q`,
+        { stdio: "ignore" }
+      );
+    } catch {
+    }
+  } else {
+    chmodSync(filePath, 384);
+  }
+}
+function saveProfile(profileName, profile) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  const config = loadRawConfig();
+  if (!config.profiles) config.profiles = {};
+  config.profiles[profileName] = {
+    ...config.profiles[profileName],
+    ...profile
+  };
+  if (!config.defaultProfile) config.defaultProfile = profileName;
+  delete config.apiKey;
+  delete config.baseUrl;
+  delete config.outputFormat;
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + "\n", {
+    mode: 384
+  });
+  restrictFilePermissions(CONFIG_PATH);
+}
+function listProfiles() {
+  const config = loadRawConfig();
+  return Object.keys(config.profiles ?? {});
+}
+function getGlobalProfile() {
+  const idx = process.argv.indexOf("--profile");
+  if (idx >= 0 && idx + 1 < process.argv.length) return process.argv[idx + 1];
+  return process.env["NUNTLY_PROFILE"] ?? void 0;
+}
+function resolveApiKey(flagKey, profileName) {
+  const config = loadRawConfig();
+  const profile = resolveProfile(config, profileName ?? getGlobalProfile());
+  const key = flagKey ?? process.env["NUNTLY_API_KEY"] ?? profile.apiKey;
+  if (!key) {
+    console.error(pc.red("Error: API key not found."));
+    console.error(
+      `Run ${pc.bold("nuntly login")}, set ${pc.bold("NUNTLY_API_KEY")} env var, or use ${pc.bold("--api-key")}`
+    );
+    if (profileName) console.error(pc.dim(`Profile: ${profileName}`));
+    process.exit(1);
+  }
+  if (flagKey) {
+    console.error(
+      pc.yellow(
+        "Warning: passing API key via flag is less secure than env var."
+      )
+    );
+  }
+  return key;
+}
+function resolveBaseUrl(flagUrl, profileName) {
+  const config = loadRawConfig();
+  const profile = resolveProfile(config, profileName ?? getGlobalProfile());
+  return flagUrl ?? process.env["NUNTLY_BASE_URL"] ?? profile.baseUrl;
+}
+async function login(profileName) {
+  const name = profileName ?? "default";
+  p.intro(
+    pc.bold(`Nuntly Login${name !== "default" ? ` (profile: ${name})` : ""}`)
+  );
+  const apiKey = await p.text({
+    message: "Enter your API key",
+    placeholder: "nuntly_sk_...",
+    validate: (value) => {
+      if (!value || value.trim().length === 0) return "API key is required";
+      return void 0;
+    }
+  });
+  if (p.isCancel(apiKey)) {
+    p.cancel("Login cancelled.");
+    process.exit(0);
+  }
+  const baseUrl = await p.text({
+    message: "API base URL (leave empty for default)",
+    placeholder: "https://api.nuntly.com"
+  });
+  if (p.isCancel(baseUrl)) {
+    p.cancel("Login cancelled.");
+    process.exit(0);
+  }
+  const profile = { apiKey: apiKey.trim() };
+  if (baseUrl && baseUrl.trim()) profile.baseUrl = baseUrl.trim();
+  saveProfile(name, profile);
+  p.note(`Profile "${name}" saved to ${pc.dim(CONFIG_PATH)}`, "Saved");
+  p.outro(pc.green("Logged in successfully."));
+}
+async function confirmDelete(resource, id) {
+  const result = await p.confirm({
+    message: `Delete ${resource} ${pc.bold(id)}?`
+  });
+  if (p.isCancel(result)) return false;
+  return result;
+}
+
+// src/version.ts
+var CLI_VERSION = "0.0.1";
+
+// src/output.ts
+import pc2 from "picocolors";
+function extractItems(data) {
+  if (data && typeof data === "object" && "data" in data && Array.isArray(data.data))
+    return data.data;
+  if (Array.isArray(data)) return data;
+  return null;
+}
+function resolveKeys(items, fields) {
+  const allKeys = Object.keys(items[0]);
+  if (!fields) return allKeys;
+  return fields.filter((f) => allKeys.includes(f));
+}
+function formatOutput(data, format, opts) {
+  const fields = opts?.fields;
+  const noHeader = opts?.noHeader ?? false;
+  if (format === "quiet") {
+    if (data && typeof data === "object" && "id" in data) {
+      return String(data.id);
+    }
+    return "";
+  }
+  if (format === "table") {
+    const items = extractItems(data);
+    if (items) {
+      if (items.length === 0) return pc2.dim("No results.");
+      const keys = resolveKeys(items, fields);
+      const widths = keys.map(
+        (k) => Math.max(
+          k.length,
+          ...items.map((r) => String(r[k] ?? "").slice(0, 40).length)
+        )
+      );
+      const rows = items.map(
+        (r) => keys.map(
+          (k, i) => String(r[k] ?? "").slice(0, 40).padEnd(widths[i])
+        ).join("  ")
+      );
+      const parts = [];
+      if (!noHeader) {
+        const header = keys.map((k, i) => pc2.bold(k.padEnd(widths[i]))).join("  ");
+        parts.push(header, pc2.dim("-".repeat(header.length)));
+      }
+      parts.push(...rows);
+      const result = parts.join("\n");
+      const nextCursor = data?.nextCursor;
+      if (nextCursor)
+        return result + "\n" + pc2.dim(`next: --cursor ${nextCursor}`);
+      return result;
+    }
+    return JSON.stringify(data, null, 2);
+  }
+  if (format === "raw") {
+    return JSON.stringify(data);
+  }
+  if (format === "yaml") {
+    return toYaml(data);
+  }
+  if (format === "csv") {
+    const items = extractItems(data);
+    const escapeCsv = (v) => {
+      const s = typeof v === "object" && v !== null ? JSON.stringify(v) : String(v ?? "");
+      return s.includes(",") || s.includes('"') || s.includes("\n") ? `"${s.replace(/"/g, '""')}"` : s;
+    };
+    if (items && items.length > 0) {
+      const keys = resolveKeys(items, fields);
+      const rows = items.map(
+        (r) => keys.map((k) => escapeCsv(r[k])).join(",")
+      );
+      if (noHeader) return rows.join("\r\n");
+      return [keys.join(","), ...rows].join("\r\n");
+    }
+    if (data && typeof data === "object") {
+      const entries = Object.entries(data);
+      if (noHeader)
+        return entries.map(([k, v]) => `${k},${escapeCsv(v)}`).join("\r\n");
+      return [
+        "field,value",
+        ...entries.map(([k, v]) => `${k},${escapeCsv(v)}`)
+      ].join("\r\n");
+    }
+    return String(data);
+  }
+  if (format === "markdown") {
+    const items = extractItems(data);
+    if (items && items.length > 0) {
+      const keys = resolveKeys(items, fields);
+      const header = "| " + keys.join(" | ") + " |";
+      const sep = "| " + keys.map(() => "---").join(" | ") + " |";
+      const rows = items.map(
+        (r) => "| " + keys.map((k) => String(r[k] ?? "").slice(0, 60)).join(" | ") + " |"
+      );
+      if (noHeader) return rows.join("\n");
+      return [header, sep, ...rows].join("\n");
+    }
+    if (data && typeof data === "object") {
+      const entries = Object.entries(data);
+      const header = "| Field | Value |";
+      const sep = "| --- | --- |";
+      const rows = entries.map(
+        ([k, v]) => `| ${k} | ${typeof v === "object" ? JSON.stringify(v) : String(v)} |`
+      );
+      if (noHeader) return rows.join("\n");
+      return [header, sep, ...rows].join("\n");
+    }
+    return String(data);
+  }
+  return JSON.stringify(data, null, 2);
+}
+function toYaml(data, indent = 0) {
+  const prefix = "  ".repeat(indent);
+  if (data === null || data === void 0) return `${prefix}null`;
+  if (typeof data === "string")
+    return data.includes("\n") ? `${prefix}|\\n${data}` : `${prefix}${data}`;
+  if (typeof data === "number" || typeof data === "boolean")
+    return `${prefix}${data}`;
+  if (Array.isArray(data)) {
+    if (data.length === 0) return `${prefix}[]`;
+    return data.map((item) => {
+      if (typeof item === "object" && item !== null) {
+        const inner = toYaml(item, indent + 1).trim();
+        return `${prefix}- ${inner.replace(/\n/g, "\n" + prefix + "  ")}`;
+      }
+      return `${prefix}- ${item}`;
+    }).join("\n");
+  }
+  if (typeof data === "object") {
+    return Object.entries(data).map(([key, value]) => {
+      if (value === null || value === void 0)
+        return `${prefix}${key}: null`;
+      if (typeof value === "object")
+        return `${prefix}${key}:
+${toYaml(value, indent + 1)}`;
+      return `${prefix}${key}: ${value}`;
+    }).join("\n");
+  }
+  return `${prefix}${String(data)}`;
+}
+function printResult(data, opts) {
+  let format;
+  if (opts.quiet) format = "quiet";
+  else if (opts.raw) format = "raw";
+  else if (opts.format) format = opts.format;
+  else if (!process.stdout.isTTY) format = "json";
+  else {
+    const isArray = Array.isArray(data) || data && typeof data === "object" && "data" in data && Array.isArray(data.data);
+    format = isArray ? "table" : "json";
+  }
+  const fields = opts.fields?.split(",").map((f) => f.trim());
+  const noHeader = opts.header === false;
+  const output = formatOutput(data, format, { fields, noHeader });
+  if (output) console.log(output);
+}
+function isJsonMode(opts) {
+  if (opts?.format === "json" || opts?.raw) return true;
+  if (!opts?.format && !opts?.quiet && !process.stdout.isTTY) return true;
+  return false;
+}
+function printError(error, opts) {
+  const e = error;
+  const isApi = !!e?.status;
+  if (isJsonMode(opts)) {
+    const envelope = {
+      error: {
+        code: isApi ? `HTTP_${e.status}` : "CLIENT_ERROR",
+        message: e?.body?.message ?? e?.message ?? String(error),
+        ...e?.requestId && { requestId: e.requestId },
+        ...e?.body?.errors && { fields: e.body.errors }
+      }
+    };
+    console.error(JSON.stringify(envelope));
+  } else {
+    if (isApi) {
+      console.error(
+        pc2.red(`HTTP ${e.status}: ${e.body?.message ?? e.message}`)
+      );
+      if (e.requestId) console.error(pc2.dim(`request: ${e.requestId}`));
+      if (e.body?.errors) {
+        for (const err of e.body.errors) {
+          console.error(pc2.yellow(`  ${err.field}: ${err.message}`));
+        }
+      }
+    } else {
+      console.error(pc2.red(e?.message ?? String(error)));
+    }
+  }
+  process.exit(isApi ? 1 : 2);
+}
+
+// src/spinner.ts
+import pc3 from "picocolors";
+var isLegacyWindows = process.platform === "win32" && !process.env["WT_SESSION"] && !process.env["TERM_PROGRAM"];
+var FRAMES = isLegacyWindows ? ["|", "/", "-", "\\"] : [
+  "\u280B",
+  "\u2819",
+  "\u2839",
+  "\u2838",
+  "\u283C",
+  "\u2834",
+  "\u2826",
+  "\u2827",
+  "\u2807",
+  "\u280F"
+];
+var INTERVAL = 80;
+async function withSpinner(message, fn) {
+  if (!process.stderr.isTTY) return fn();
+  let i = 0;
+  const timer = setInterval(() => {
+    const frame = FRAMES[i++ % FRAMES.length];
+    process.stderr.write(`\r${pc3.cyan(frame)} ${pc3.dim(message)}`);
+  }, INTERVAL);
+  try {
+    return await fn();
+  } finally {
+    clearInterval(timer);
+    process.stderr.write(`\r${" ".repeat(message.length + 4)}\r`);
+  }
+}
+
+// src/files.ts
+import { readFileSync as readFileSync2, readSync } from "fs";
+function readStdin() {
+  const chunks = [];
+  const buf = Buffer.alloc(4096);
+  try {
+    let bytesRead;
+    while ((bytesRead = readSync(0, buf, 0, buf.length, null)) > 0) {
+      chunks.push(buf.subarray(0, bytesRead));
+    }
+  } catch (e) {
+    if (e.code !== "EOF" && e.code !== "EAGAIN") throw e;
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+function readInput(filePath) {
+  const raw = filePath === "-" ? readStdin() : readFileSync2(filePath, "utf-8");
+  return JSON.parse(raw);
+}
+
+// src/commands/emails.ts
+var emailsCommand = new Command("emails").description("Emails resource.");
+var statsSub = new Command("stats");
+emailsCommand.addCommand(statsSub);
+statsSub.command("retrieve").description("Returns aggregated daily sending statistics for the current period.").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly emails stats retrieve").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.emails.stats.retrieve());
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+var eventsSub = new Command("events");
+emailsCommand.addCommand(eventsSub);
+eventsSub.command("list").description("Returns the full delivery event history for an email (sent, delivered, opened, bounced, etc.).").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly emails events list em_1234abcd").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.emails.events.list(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+var contentSub = new Command("content");
+emailsCommand.addCommand(contentSub);
+contentSub.command("retrieve").description("Returns presigned URLs to download the HTML, plain-text, and raw MIME source of a sent email.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly emails content retrieve em_1234abcd").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.emails.content.retrieve(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+var bulkSub = new Command("bulk");
+emailsCommand.addCommand(bulkSub);
+bulkSub.command("send").description("Send up to 20 emails in a single request. Use `fallback` to set default values shared across all messages.").option("--fallback <value>", "Used as a fallback field email value if no value is present in emails").option("--emails <value>", "The bulk emails to send (required)").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", '\nExample:\n  $ nuntly emails bulk send --emails "value"\n  $ cat payload.json | nuntly emails bulk send\n  $ nuntly emails bulk send --file payload.json').action(async (opts) => {
+  try {
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      fallback: opts.fallback != null ? JSON.parse(opts.fallback) : void 0,
+      emails: JSON.parse(opts.emails)
+    };
+    const result = await withSpinner("Creating...", () => nuntly.emails.bulk.send(body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+bulkSub.command("list").description("Returns the delivery status of all emails submitted in a bulk request.").argument("<bulk-id>", "The bulkId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly emails bulk list em_1234abcd").action(async (bulkId, opts) => {
+  try {
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.emails.bulk.list(bulkId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+emailsCommand.command("retrieve").description("Returns an email with its current delivery status and metadata.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly emails retrieve em_1234abcd").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.emails.retrieve(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+emailsCommand.command("list").description("Returns sent emails ordered by submission date, newest first.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly emails list\n  $ nuntly emails list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.emails.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+emailsCommand.command("send").description("Send transactional emails through Nuntly platform. It supports HTML and plain-text emails, attachments, labels, custom headers and scheduling.").option("--from <value>", "The e-mail address of the sender (required)").option("--to <value>", "The primary recipient(s) of the email (required)").option("--cc <value>", "The carbon copy recipient(s) of the email").option("--bcc <value>", "The blind carbon copy recipient(s) of the email").option("--reply-to <value>", "The email address where replies should be sent. If a recipient replies, the response will go to this address instead of the sender's email address").option("--subject <value>", "The subject of the e-mail (required)").option("--text <value>", "The plaintext version of the email").option("--html <value>", "The HTML version of the email").option("--headers <value>", "The headers to add to the email").option("--tags <value>", "The tags to add to the email").option("--attachments <value>", "The attachements to add to the email").option("--variables <value>", "The variables for the template").option("--scheduled-at <value>", "The date at which the email is scheduled to be sent").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", '\nExample:\n  $ nuntly emails send --from hello@acme.com --to user@example.com --subject "Welcome aboard"\n  $ cat payload.json | nuntly emails send\n  $ nuntly emails send --file payload.json').action(async (opts) => {
+  try {
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      from: opts.from,
+      to: opts.to.split(","),
+      cc: opts.cc != null ? opts.cc.split(",") : void 0,
+      bcc: opts.bcc != null ? opts.bcc.split(",") : void 0,
+      replyTo: opts.replyTo != null ? opts.replyTo.split(",") : void 0,
+      subject: opts.subject,
+      text: opts.text,
+      html: opts.html,
+      headers: opts.headers != null ? JSON.parse(opts.headers) : void 0,
+      tags: opts.tags != null ? JSON.parse(opts.tags) : void 0,
+      attachments: opts.attachments != null ? JSON.parse(opts.attachments) : void 0,
+      variables: opts.variables != null ? JSON.parse(opts.variables) : void 0,
+      scheduledAt: opts.scheduledAt
+    };
+    const result = await withSpinner("Creating...", () => nuntly.emails.send(body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+emailsCommand.command("cancel").description("Cancel a scheduled email before delivery. Only emails with `scheduled` status can be cancelled.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly emails cancel em_1234abcd").action(async (id, opts) => {
+  try {
+    if (!await confirmDelete("emails", id)) return;
+    const nuntly = new Nuntly({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Deleting...", () => nuntly.emails.cancel(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/domains.ts
+import { Command as Command2 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly2 } from "@nuntly/sdk";
+var domainsCommand = new Command2("domains").description("Domains resource.");
+domainsCommand.command("list").description("Returns all domains with their verification and capability status.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly domains list\n  $ nuntly domains list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly2({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.domains.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+domainsCommand.command("retrieve").description("Returns a domain with its DNS record configuration and current verification status for each record.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly domains retrieve dm_5678efgh").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly2({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.domains.retrieve(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+domainsCommand.command("delete").description("Permanently deletes a domain along with its inboxes, received messages, attachments, and sending configuration. This action is irreversible.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly domains delete dm_5678efgh").action(async (id, opts) => {
+  try {
+    if (!await confirmDelete("domains", id)) return;
+    const nuntly = new Nuntly2({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Deleting...", () => nuntly.domains.delete(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+domainsCommand.command("create").description("Add a domain to start configuring DNS records for sending or receiving emails.").option("--name <value>", "The name of the domain to send e-mails' (required)").option("--sending", "Enable sending").option("--receiving", "Enable receiving").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly domains create --name my-resource\n  $ cat payload.json | nuntly domains create\n  $ nuntly domains create --file payload.json").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly2({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      name: opts.name,
+      sending: opts.sending,
+      receiving: opts.receiving
+    };
+    const result = await withSpinner("Creating...", () => nuntly.domains.create(body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+domainsCommand.command("update").description("Toggle sending, receiving, open tracking, or click tracking capabilities for a domain.").argument("<id>", "The id").option("--open-tracking", "Emit an event for each recipient opens an email their email client").option("--click-tracking", "Emit an event for each time the recipient clicks a link in the email").option("--sending", "Enable or disable sending").option("--receiving", "Enable or disable receiving").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly domains update dm_5678efgh\n  $ cat payload.json | nuntly domains update dm_5678efgh\n  $ nuntly domains update dm_5678efgh --file payload.json").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly2({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      openTracking: opts.openTracking,
+      clickTracking: opts.clickTracking,
+      sending: opts.sending,
+      receiving: opts.receiving
+    };
+    const result = await withSpinner("Updating...", () => nuntly.domains.update(id, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/webhooks.ts
+import { Command as Command3 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly3 } from "@nuntly/sdk";
+var webhooksCommand = new Command3("webhooks").description("Webhooks resource.");
+var eventsSub2 = new Command3("events");
+webhooksCommand.addCommand(eventsSub2);
+eventsSub2.command("list").description("Returns recent webhook events across all registered endpoints.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly webhooks events list\n  $ nuntly webhooks events list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly3({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.webhooks.events.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+eventsSub2.command("replay").description("Re-deliver a webhook event to its endpoint. Useful for retrying failed deliveries.").argument("<id>", "The id").argument("<event-id>", "The eventId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly webhooks events replay wh_9012ijkl wh_9012ijkl").action(async (id, eventId, opts) => {
+  try {
+    const nuntly = new Nuntly3({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Creating...", () => nuntly.webhooks.events.replay(id, eventId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+eventsSub2.command("deliveries").description("Returns all delivery attempts for a webhook event, including HTTP status codes and response times.").argument("<id>", "The id").argument("<event-id>", "The eventId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly webhooks events deliveries wh_9012ijkl wh_9012ijkl").action(async (id, eventId, opts) => {
+  try {
+    const nuntly = new Nuntly3({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.webhooks.events.deliveries(id, eventId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+webhooksCommand.command("retrieve").description("Returns a webhook endpoint with its URL, subscribed events, and configuration.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly webhooks retrieve wh_9012ijkl").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly3({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.webhooks.retrieve(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+webhooksCommand.command("update").description("Update the endpoint URL, subscribed event types, or rotate the signing secret.").argument("<id>", "The id").option("--name <value>", "The name of the webhook").option("--endpoint-url <value>", "The endpoint URL of the webhook").option("--events <value>", "The event types to subscribe to").option("--status <value>", "The status of the webhook.").option("--rotate-secret", "If true, a new signing secret will be generated").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly webhooks update wh_9012ijkl\n  $ cat payload.json | nuntly webhooks update wh_9012ijkl\n  $ nuntly webhooks update wh_9012ijkl --file payload.json").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly3({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      name: opts.name,
+      endpointUrl: opts.endpointUrl,
+      events: opts.events != null ? opts.events.split(",") : void 0,
+      status: opts.status,
+      rotateSecret: opts.rotateSecret
+    };
+    const result = await withSpinner("Updating...", () => nuntly.webhooks.update(id, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+webhooksCommand.command("delete").description("Remove a webhook endpoint. No further events will be delivered to this URL.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly webhooks delete wh_9012ijkl").action(async (id, opts) => {
+  try {
+    if (!await confirmDelete("webhooks", id)) return;
+    const nuntly = new Nuntly3({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Deleting...", () => nuntly.webhooks.delete(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+webhooksCommand.command("create").description("Register an endpoint to start receiving webhook events for your organization.").option("--name <value>", "The name of the webhook").option("--endpoint-url <value>", "The endpoint URL of the webhook (required)").option("--status <value>", "The status of the webhook.").option("--events <value>", "The event types to subscribe to (required)").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly webhooks create --endpoint-url https://acme.com/webhooks --events email.sent,email.delivered\n  $ cat payload.json | nuntly webhooks create\n  $ nuntly webhooks create --file payload.json").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly3({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      name: opts.name,
+      endpointUrl: opts.endpointUrl,
+      status: opts.status,
+      events: opts.events.split(",")
+    };
+    const result = await withSpinner("Creating...", () => nuntly.webhooks.create(body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+webhooksCommand.command("list").description("Returns all registered webhook endpoints for the organization.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly webhooks list\n  $ nuntly webhooks list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly3({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.webhooks.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/organizations.ts
+import { Command as Command4 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly4 } from "@nuntly/sdk";
+var organizationsCommand = new Command4("organizations").description("Organizations resource.");
+var usageSub = new Command4("usage");
+organizationsCommand.addCommand(usageSub);
+usageSub.command("retrieve").description("Returns current period usage metrics (daily and monthly) for sending and receiving, against your plan limits.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly organizations usage retrieve org_8901klmn").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly4({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.organizations.usage.retrieve(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+organizationsCommand.command("list").description("Returns all organizations the authenticated user belongs to.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly organizations list\n  $ nuntly organizations list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly4({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.organizations.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+organizationsCommand.command("retrieve").description("Returns the organization's profile, plan, region, and account status.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly organizations retrieve org_8901klmn").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly4({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.organizations.retrieve(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/inboxes.ts
+import { Command as Command5 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly5 } from "@nuntly/sdk";
+var inboxesCommand = new Command5("inboxes").description("Inboxes resource.");
+var threadsSub = new Command5("threads");
+inboxesCommand.addCommand(threadsSub);
+threadsSub.command("list").description("List threads in an inbox.").argument("<inbox-id>", "The inboxId").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly inboxes threads list ib_7890qrst\n  $ nuntly inboxes threads list ib_7890qrst --format json | jq '.data[].id'").action(async (inboxId, opts) => {
+  try {
+    const nuntly = new Nuntly5({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.inboxes.threads.list(inboxId, { cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+var messagesSub = new Command5("messages");
+inboxesCommand.addCommand(messagesSub);
+messagesSub.command("send").description("Send a new message from an inbox.").argument("<inbox-id>", "The inboxId").option("--to <value>", "The recipient addresses. (required)").option("--cc <value>", "The CC addresses.").option("--bcc <value>", "The BCC addresses.").option("--subject <value>", "The message subject. (required)").option("--text <value>", "The plain text body.").option("--html <value>", "The HTML body.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", '\nExample:\n  $ nuntly inboxes messages send ib_7890qrst --to user@example.com --subject "Welcome aboard"\n  $ cat payload.json | nuntly inboxes messages send ib_7890qrst\n  $ nuntly inboxes messages send ib_7890qrst --file payload.json').action(async (inboxId, opts) => {
+  try {
+    const nuntly = new Nuntly5({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      to: opts.to.split(","),
+      cc: opts.cc != null ? opts.cc.split(",") : void 0,
+      bcc: opts.bcc != null ? opts.bcc.split(",") : void 0,
+      subject: opts.subject,
+      text: opts.text,
+      html: opts.html
+    };
+    const result = await withSpinner("Creating...", () => nuntly.inboxes.messages.send(inboxId, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+inboxesCommand.command("create").description("Create a new inbox on a verified domain.").option("--domain-id <value>", "The id of the domain for this inbox. Defaults to your provided domain when omitted.").option("--address <value>", "The local-part of the email address (before the @). (required)").option("--name <value>", "The display name of the inbox.").option("--namespace-id <value>", "The id of the namespace to assign the inbox to.").option("--agent-id <value>", "The external AI agent identifier.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly inboxes create --address support\n  $ cat payload.json | nuntly inboxes create\n  $ nuntly inboxes create --file payload.json").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly5({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      domainId: opts.domainId,
+      address: opts.address,
+      name: opts.name,
+      namespaceId: opts.namespaceId,
+      agentId: opts.agentId
+    };
+    const result = await withSpinner("Creating...", () => nuntly.inboxes.create(body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+inboxesCommand.command("list").description("List all inboxes.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly inboxes list\n  $ nuntly inboxes list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly5({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.inboxes.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+inboxesCommand.command("retrieve").description("Retrieve an inbox with thread stats.").argument("<inbox-id>", "The inboxId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly inboxes retrieve ib_7890qrst").action(async (inboxId, opts) => {
+  try {
+    const nuntly = new Nuntly5({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.inboxes.retrieve(inboxId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+inboxesCommand.command("update").description("Update an inbox.").argument("<inbox-id>", "The inboxId").option("--name <value>", "The display name of the inbox.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly inboxes update ib_7890qrst\n  $ cat payload.json | nuntly inboxes update ib_7890qrst\n  $ nuntly inboxes update ib_7890qrst --file payload.json").action(async (inboxId, opts) => {
+  try {
+    const nuntly = new Nuntly5({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      name: opts.name
+    };
+    const result = await withSpinner("Updating...", () => nuntly.inboxes.update(inboxId, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+inboxesCommand.command("delete").description("Soft-delete an inbox.").argument("<inbox-id>", "The inboxId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly inboxes delete ib_7890qrst").action(async (inboxId, opts) => {
+  try {
+    if (!await confirmDelete("inboxes", inboxId)) return;
+    const nuntly = new Nuntly5({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Deleting...", () => nuntly.inboxes.delete(inboxId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/agents.ts
+import { Command as Command6 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly6 } from "@nuntly/sdk";
+var agentsCommand = new Command6("agents").description("Agents resource.");
+var memorySub = new Command6("memory");
+agentsCommand.addCommand(memorySub);
+memorySub.command("retrieve").description("Retrieve the memory for an AI agent.").argument("<agent-id>", "The agentId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly agents memory retrieve ag_6789yzab").action(async (agentId, opts) => {
+  try {
+    const nuntly = new Nuntly6({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.agents.memory.retrieve(agentId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+memorySub.command("upsert").description("Create or update the memory for an AI agent.").argument("<agent-id>", "The agentId").option("--inbox-id <value>", "The inbox id to scope the memory to.").option("--thread-id <value>", "The thread id to scope the memory to.").option("--memory <value>", "The agent memory key-value data. (required)").option("--summary <value>", "A human-readable conversation summary.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", '\nExample:\n  $ nuntly agents memory upsert ag_6789yzab --memory "value"\n  $ cat payload.json | nuntly agents memory upsert ag_6789yzab\n  $ nuntly agents memory upsert ag_6789yzab --file payload.json').action(async (agentId, opts) => {
+  try {
+    const nuntly = new Nuntly6({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      inboxId: opts.inboxId,
+      threadId: opts.threadId,
+      memory: JSON.parse(opts.memory),
+      summary: opts.summary
+    };
+    const result = await withSpinner("Updating...", () => nuntly.agents.memory.upsert(agentId, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/threads.ts
+import { Command as Command7 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly7 } from "@nuntly/sdk";
+var threadsCommand = new Command7("threads").description("Threads resource.");
+var messagesSub2 = new Command7("messages");
+threadsCommand.addCommand(messagesSub2);
+messagesSub2.command("list").description("List messages in a thread (chronological order).").argument("<thread-id>", "The threadId").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly threads messages list th_0123cdef\n  $ nuntly threads messages list th_0123cdef --format json | jq '.data[].id'").action(async (threadId, opts) => {
+  try {
+    const nuntly = new Nuntly7({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.threads.messages.list(threadId, { cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+threadsCommand.command("retrieve").description("Retrieve a thread. Pass ?markRead=true to automatically remove the unread label from all messages.").argument("<thread-id>", "The threadId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly threads retrieve th_0123cdef").action(async (threadId, opts) => {
+  try {
+    const nuntly = new Nuntly7({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.threads.retrieve(threadId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+threadsCommand.command("update").description("Update thread labels and agent assignment. Label operations apply to all messages in the thread.").argument("<thread-id>", "The threadId").option("--add-labels <value>", "Labels to add to all messages in the thread.").option("--remove-labels <value>", "Labels to remove from all messages in the thread.").option("--agent-id <value>", "The AI agent identifier.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly threads update th_0123cdef\n  $ cat payload.json | nuntly threads update th_0123cdef\n  $ nuntly threads update th_0123cdef --file payload.json").action(async (threadId, opts) => {
+  try {
+    const nuntly = new Nuntly7({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      addLabels: opts.addLabels != null ? opts.addLabels.split(",") : void 0,
+      removeLabels: opts.removeLabels != null ? opts.removeLabels.split(",") : void 0,
+      agentId: opts.agentId
+    };
+    const result = await withSpinner("Updating...", () => nuntly.threads.update(threadId, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/messages.ts
+import { Command as Command8 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly8 } from "@nuntly/sdk";
+var messagesCommand = new Command8("messages").description("Messages resource.");
+var contentSub2 = new Command8("content");
+messagesCommand.addCommand(contentSub2);
+contentSub2.command("retrieve").description("Returns presigned URLs to download the HTML, plain-text, and raw MIME source of a received message.").argument("<message-id>", "The messageId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly messages content retrieve mg_4567ghij").action(async (messageId, opts) => {
+  try {
+    const nuntly = new Nuntly8({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.messages.content.retrieve(messageId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+var attachmentsSub = new Command8("attachments");
+messagesCommand.addCommand(attachmentsSub);
+attachmentsSub.command("list").description("List all attachments for a message.").argument("<message-id>", "The messageId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly messages attachments list mg_4567ghij").action(async (messageId, opts) => {
+  try {
+    const nuntly = new Nuntly8({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.messages.attachments.list(messageId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+attachmentsSub.command("retrieve").description("Retrieve an attachment with a presigned download URL.").argument("<message-id>", "The messageId").argument("<attachment-id>", "The attachmentId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly messages attachments retrieve mg_4567ghij mg_4567ghij").action(async (messageId, attachmentId, opts) => {
+  try {
+    const nuntly = new Nuntly8({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.messages.attachments.retrieve(messageId, attachmentId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+messagesCommand.command("list").description("List all received messages across inboxes.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly messages list\n  $ nuntly messages list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly8({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.messages.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+messagesCommand.command("retrieve").description("Retrieve a single message with inbox enrichment.").argument("<message-id>", "The messageId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly messages retrieve mg_4567ghij").action(async (messageId, opts) => {
+  try {
+    const nuntly = new Nuntly8({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.messages.retrieve(messageId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+messagesCommand.command("update").description("Update message labels. Only available for messages in user-created inboxes.").argument("<message-id>", "The messageId").option("--add-labels <value>", "Labels to add to the message.").option("--remove-labels <value>", "Labels to remove from the message.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly messages update mg_4567ghij\n  $ cat payload.json | nuntly messages update mg_4567ghij\n  $ nuntly messages update mg_4567ghij --file payload.json").action(async (messageId, opts) => {
+  try {
+    const nuntly = new Nuntly8({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      addLabels: opts.addLabels != null ? opts.addLabels.split(",") : void 0,
+      removeLabels: opts.removeLabels != null ? opts.removeLabels.split(",") : void 0
+    };
+    const result = await withSpinner("Updating...", () => nuntly.messages.update(messageId, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+messagesCommand.command("reply").description("Reply to a message. Set replyAll to true to reply to all recipients.").argument("<message-id>", "The messageId").option("--text <value>", "The plain text body.").option("--html <value>", "The HTML body.").option("--reply-all", "Whether to reply to all recipients. (required)").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly messages reply mg_4567ghij --reply-all\n  $ cat payload.json | nuntly messages reply mg_4567ghij\n  $ nuntly messages reply mg_4567ghij --file payload.json").action(async (messageId, opts) => {
+  try {
+    const nuntly = new Nuntly8({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      text: opts.text,
+      html: opts.html,
+      replyAll: opts.replyAll
+    };
+    const result = await withSpinner("Creating...", () => nuntly.messages.reply(messageId, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+messagesCommand.command("forward").description("Forward a message to new recipients.").argument("<message-id>", "The messageId").option("--to <value>", "The recipient addresses to forward to. (required)").option("--text <value>", "An optional comment to prepend.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly messages forward mg_4567ghij --to user@example.com\n  $ cat payload.json | nuntly messages forward mg_4567ghij\n  $ nuntly messages forward mg_4567ghij --file payload.json").action(async (messageId, opts) => {
+  try {
+    const nuntly = new Nuntly8({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      to: opts.to.split(","),
+      text: opts.text
+    };
+    const result = await withSpinner("Creating...", () => nuntly.messages.forward(messageId, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/namespaces.ts
+import { Command as Command9 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly9 } from "@nuntly/sdk";
+var namespacesCommand = new Command9("namespaces").description("Namespaces resource.");
+var inboxesSub = new Command9("inboxes");
+namespacesCommand.addCommand(inboxesSub);
+inboxesSub.command("list").description("List inboxes in a namespace.").argument("<namespace-id>", "The namespaceId").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly namespaces inboxes list ib_7890qrst\n  $ nuntly namespaces inboxes list ib_7890qrst --format json | jq '.data[].id'").action(async (namespaceId, opts) => {
+  try {
+    const nuntly = new Nuntly9({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.namespaces.inboxes.list(namespaceId, { cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+namespacesCommand.command("create").description("Create a new namespace.").option("--name <value>", "The display name of the namespace. (required)").option("--external-id <value>", "An optional external identifier for the namespace.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly namespaces create --name my-resource\n  $ cat payload.json | nuntly namespaces create\n  $ nuntly namespaces create --file payload.json").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly9({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      name: opts.name,
+      externalId: opts.externalId
+    };
+    const result = await withSpinner("Creating...", () => nuntly.namespaces.create(body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+namespacesCommand.command("list").description("List all namespaces.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly namespaces list\n  $ nuntly namespaces list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly9({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.namespaces.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+namespacesCommand.command("retrieve").description("Retrieve a namespace with inbox stats.").argument("<namespace-id>", "The namespaceId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly namespaces retrieve ns_2345uvwx").action(async (namespaceId, opts) => {
+  try {
+    const nuntly = new Nuntly9({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.namespaces.retrieve(namespaceId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+namespacesCommand.command("update").description("Update a namespace.").argument("<namespace-id>", "The namespaceId").option("--name <value>", "The display name of the namespace.").option("--external-id <value>", "An optional external identifier for the namespace.").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly namespaces update ns_2345uvwx\n  $ cat payload.json | nuntly namespaces update ns_2345uvwx\n  $ nuntly namespaces update ns_2345uvwx --file payload.json").action(async (namespaceId, opts) => {
+  try {
+    const nuntly = new Nuntly9({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      name: opts.name,
+      externalId: opts.externalId
+    };
+    const result = await withSpinner("Updating...", () => nuntly.namespaces.update(namespaceId, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+namespacesCommand.command("delete").description("Soft-delete a namespace. Rejects if it has active inboxes.").argument("<namespace-id>", "The namespaceId").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly namespaces delete ns_2345uvwx").action(async (namespaceId, opts) => {
+  try {
+    if (!await confirmDelete("namespaces", namespaceId)) return;
+    const nuntly = new Nuntly9({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Deleting...", () => nuntly.namespaces.delete(namespaceId));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/commands/api-keys.ts
+import { Command as Command10 } from "@commander-js/extra-typings";
+import { Nuntly as Nuntly10 } from "@nuntly/sdk";
+var apiKeysCommand = new Command10("api-keys").description("ApiKeys resource.");
+apiKeysCommand.command("retrieve").description("Returns API key metadata. The key value is never returned after creation.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly api-keys retrieve id_example").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly10({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Loading...", () => nuntly.apiKeys.retrieve(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+apiKeysCommand.command("update").description("Update the key name, permissions, or restrict it to specific sending domains.").argument("<id>", "The id").option("--name <value>", "The name of the api key").option("--status <value>", "status").option("--permission <value>", "The permission type for the api key (required)").option("--domain-ids <value>", "The domain ids to restrict the api key to (only for sendingAccess)").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly api-keys update id_example --permission sendingAccess\n  $ cat payload.json | nuntly api-keys update id_example\n  $ nuntly api-keys update id_example --file payload.json").action(async (id, opts) => {
+  try {
+    const nuntly = new Nuntly10({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      name: opts.name,
+      status: opts.status,
+      permission: opts.permission,
+      domainIds: opts.domainIds != null ? opts.domainIds.split(",") : void 0
+    };
+    const result = await withSpinner("Updating...", () => nuntly.apiKeys.update(id, body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+apiKeysCommand.command("delete").description("Revoke an API key. Requests authenticating with this key will be rejected immediately.").argument("<id>", "The id").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly api-keys delete id_example").action(async (id, opts) => {
+  try {
+    if (!await confirmDelete("api keys", id)) return;
+    const nuntly = new Nuntly10({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const result = await withSpinner("Deleting...", () => nuntly.apiKeys.delete(id));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+apiKeysCommand.command("create").description("Generate a new API key. The key value is only returned once \u2014 store it securely.").option("--name <value>", "The name of the api key").option("--status <value>", "The status for the api key").option("--permission <value>", "The permission type for the api key (required)").option("--domain-ids <value>", "The domain ids to restrict the api key to (only for sendingAccess)").option("--file <path>", "Read JSON body from file (use - for stdin)").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly api-keys create --permission sendingAccess\n  $ cat payload.json | nuntly api-keys create\n  $ nuntly api-keys create --file payload.json").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly10({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const body = opts.file ? readInput(opts.file) : !process.stdin.isTTY ? readInput("-") : {
+      name: opts.name,
+      status: opts.status,
+      permission: opts.permission,
+      domainIds: opts.domainIds != null ? opts.domainIds.split(",") : void 0
+    };
+    const result = await withSpinner("Creating...", () => nuntly.apiKeys.create(body));
+    printResult(result, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+apiKeysCommand.command("list").description("Returns all API keys for the organization. Key values are never included in list responses.").option("--cursor <cursor>", "Pagination cursor").option("--limit <limit>", "Max items to return").option("--format <fmt>", "Output format: json, raw, yaml, csv, markdown, table, quiet").option("-q, --quiet", "Shorthand for --format quiet").option("--raw", "Shorthand for --format raw").option("--fields <fields>", "Comma-separated list of fields to display").option("--no-header", "Omit column headers in table/csv output").addHelpText("after", "\nExample:\n  $ nuntly api-keys list\n  $ nuntly api-keys list --format json | jq '.data[].id'").action(async (opts) => {
+  try {
+    const nuntly = new Nuntly10({ apiKey: resolveApiKey(), baseUrl: resolveBaseUrl(), appInfo: { name: "@nuntly/cli", version: CLI_VERSION } });
+    const page = await withSpinner("Loading...", () => nuntly.apiKeys.list({ cursor: opts.cursor, limit: opts.limit ? Number(opts.limit) : void 0 }));
+    printResult({ data: page.data, nextCursor: page.nextCursor }, opts);
+  } catch (error) {
+    printError(error, opts);
+  }
+});
+
+// src/completion.ts
+var COMMANDS = [
+  "login",
+  "profiles",
+  "completion",
+  "emails",
+  "domains",
+  "webhooks",
+  "organizations",
+  "inboxes",
+  "agents",
+  "threads",
+  "messages",
+  "namespaces",
+  "api-keys"
+];
+var SUBCOMMANDS = {
+  emails: [
+    "send",
+    "list",
+    "retrieve",
+    "cancel",
+    "stats",
+    "events",
+    "content",
+    "bulk"
+  ],
+  domains: ["create", "list", "retrieve", "update", "delete"],
+  webhooks: ["create", "list", "retrieve", "update", "delete", "events"],
+  organizations: ["list", "retrieve", "usage"],
+  inboxes: [
+    "create",
+    "list",
+    "retrieve",
+    "update",
+    "delete",
+    "threads",
+    "messages"
+  ],
+  agents: ["memory"],
+  threads: ["retrieve", "update", "messages"],
+  messages: ["list", "retrieve", "reply", "forward", "content", "attachments"],
+  namespaces: ["create", "list", "retrieve", "update", "delete", "inboxes"],
+  "api-keys": ["create", "list", "retrieve", "update", "delete"]
+};
+function bashCompletion() {
+  return `#!/bin/bash
+_nuntly_completions() {
+  local cur prev commands
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  commands="${COMMANDS.join(" ")}"
+
+  case "\${COMP_CWORD}" in
+    1)
+      COMPREPLY=( $(compgen -W "\${commands}" -- "\${cur}") )
+      ;;
+    2)
+      case "\${prev}" in
+${Object.entries(SUBCOMMANDS).map(
+    ([cmd, subs]) => `        ${cmd}) COMPREPLY=( $(compgen -W "${subs.join(" ")}" -- "\${cur}") ) ;;`
+  ).join("\n")}
+        *) ;;
+      esac
+      ;;
+    *)
+      COMPREPLY=( $(compgen -W "--json --yaml --markdown --table --quiet --profile --help" -- "\${cur}") )
+      ;;
+  esac
+}
+complete -F _nuntly_completions nuntly`;
+}
+function zshCompletion() {
+  return `#compdef nuntly
+
+_nuntly() {
+  local -a commands
+  commands=(
+${COMMANDS.map((c) => `    '${c}:${c} command'`).join("\n")}
+  )
+
+  _arguments -C \\
+    '1:command:->command' \\
+    '*::arg:->args'
+
+  case $state in
+    command)
+      _describe 'command' commands
+      ;;
+    args)
+      case $words[1] in
+${Object.entries(SUBCOMMANDS).map(
+    ([cmd, subs]) => `        ${cmd}) _values 'subcommand' ${subs.map((s) => `'${s}'`).join(" ")} ;;`
+  ).join("\n")}
+      esac
+      ;;
+  esac
+}
+
+_nuntly`;
+}
+function fishCompletion() {
+  const lines = COMMANDS.map(
+    (c) => `complete -c nuntly -n '__fish_use_subcommand' -a '${c}'`
+  );
+  for (const [cmd, subs] of Object.entries(SUBCOMMANDS)) {
+    for (const sub of subs) {
+      lines.push(
+        `complete -c nuntly -n '__fish_seen_subcommand_from ${cmd}' -a '${sub}'`
+      );
+    }
+  }
+  return lines.join("\n");
+}
+function powershellCompletion() {
+  const subBlocks = Object.entries(SUBCOMMANDS).map(
+    ([cmd, subs]) => `        '${cmd}' { @(${subs.map((s) => `'${s}'`).join(", ")}) | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) } }`
+  ).join("\n");
+  return `Register-ArgumentCompleter -CommandName nuntly -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+    $elements = $commandAst.CommandElements
+    if ($elements.Count -le 2) {
+        @(${COMMANDS.map((c) => `'${c}'`).join(", ")}) | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }
+    } else {
+        $cmd = $elements[1].ToString()
+        switch ($cmd) {
+${subBlocks}
+        }
+    }
+}`;
+}
+
+// src/index.ts
+var program = new Command11().name("nuntly").description(pc4.bold("Nuntly CLI") + " - Developer-first email platform").version("0.0.1").option("--profile <name>", "Use a specific profile from ~/.nuntly/config.json");
+program.command("login").description("Save your API key to ~/.nuntly/config.json").argument("[profile]", 'Profile name (default: "default")').action(async (profile) => {
+  await login(profile);
+});
+program.command("profiles").description("List configured profiles").action(() => {
+  const profiles = listProfiles();
+  if (profiles.length === 0) console.log(pc4.dim("No profiles configured. Run: nuntly login"));
+  else profiles.forEach((n) => console.log(n));
+});
+program.command("completion").description("Output shell completion script").argument("<shell>", "Shell type: bash, zsh, fish, or powershell").action((shell) => {
+  switch (shell) {
+    case "bash":
+      console.log(bashCompletion());
+      break;
+    case "zsh":
+      console.log(zshCompletion());
+      break;
+    case "fish":
+      console.log(fishCompletion());
+      break;
+    case "powershell":
+      console.log(powershellCompletion());
+      break;
+    default:
+      console.error(pc4.red("Unknown shell: " + shell));
+      process.exit(1);
+  }
+});
+program.addCommand(emailsCommand);
+program.addCommand(domainsCommand);
+program.addCommand(webhooksCommand);
+program.addCommand(organizationsCommand);
+program.addCommand(inboxesCommand);
+program.addCommand(agentsCommand);
+program.addCommand(threadsCommand);
+program.addCommand(messagesCommand);
+program.addCommand(namespacesCommand);
+program.addCommand(apiKeysCommand);
+program.parse();
+//# sourceMappingURL=index.js.map