@agent-nexus/cli 0.1.8 → 0.1.11

package/dist/index.js

@@ -166,7 +166,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@agent-nexus/cli",
-      version: "0.1.8",
+      version: "0.1.11",
       description: "Official CLI for the Nexus AI agent platform.",
       license: "MIT",
       keywords: [
@@ -202,10 +202,10 @@ var require_package = __commonJS({
         prepublishOnly: "pnpm run build"
       },
       dependencies: {
-        "@agent-nexus/sdk": "workspace:*",
         commander: "^13.0.0"
       },
       devDependencies: {
+        "@agent-nexus/sdk": "workspace:*",
         "@types/node": "24.6.2",
         tsup: "^8.5.0",
         typescript: "^5.8.3"
@@ -244,8 +244,2224 @@ function getBanner(version) {
   return lines.join("\n");
 }
 
-// src/client.ts
-var import_sdk = require("@agent-nexus/sdk");
+// ../sdk/dist/index.mjs
+var NexusError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "NexusError";
+  }
+};
+var NexusApiError = class extends NexusError {
+  constructor(code, message, status, details) {
+    super(message);
+    this.name = "NexusApiError";
+    this.code = code;
+    this.status = status;
+    this.details = details;
+  }
+};
+var NexusAuthenticationError = class extends NexusApiError {
+  constructor(message = "Invalid or missing API key") {
+    super("UNAUTHORIZED", message, 401);
+    this.name = "NexusAuthenticationError";
+  }
+};
+var NexusConnectionError = class extends NexusError {
+  constructor(message, cause) {
+    super(message);
+    this.name = "NexusConnectionError";
+    this.cause = cause;
+  }
+};
+var HttpClient = class {
+  constructor(opts) {
+    this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+    this.apiKey = opts.apiKey;
+    this.fetchFn = opts.fetch ?? globalThis.fetch;
+    this.defaultHeaders = opts.defaultHeaders ?? {};
+    this.timeout = opts.timeout ?? 3e4;
+  }
+  /**
+   * Make a request and return the unwrapped `data` field.
+   *
+   * @param method - HTTP method (GET, POST, PATCH, DELETE).
+   * @param path - API path relative to `/api/public/v1` (e.g. `"/agents"`).
+   * @param opts - Optional body, query params, and headers.
+   * @returns The response `data` field, typed as `T`.
+   * @throws {NexusAuthenticationError} On 401 responses.
+   * @throws {NexusApiError} On other error responses.
+   * @throws {NexusConnectionError} On network failures or timeouts.
+   */
+  async request(method, path5, opts = {}) {
+    const { data } = await this.requestWithMeta(method, path5, opts);
+    return data;
+  }
+  /**
+   * Make a request and return the raw response text.
+   * Useful for endpoints that return non-JSON responses (e.g. CSV exports).
+   */
+  async requestRaw(method, path5, opts = {}) {
+    const url = new URL(`${this.baseUrl}/api/public/v1${path5}`);
+    if (opts.query) {
+      for (const [k, v] of Object.entries(opts.query)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const headers = {
+      ...this.defaultHeaders,
+      ...opts.headers,
+      "api-key": this.apiKey
+    };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    let res;
+    try {
+      res = await this.fetchFn(url.toString(), { method, headers, signal: controller.signal });
+    } catch (err) {
+      clearTimeout(timer);
+      if (err instanceof DOMException && err.name === "AbortError") {
+        throw new NexusConnectionError(`Request timed out after ${this.timeout}ms`);
+      }
+      throw new NexusConnectionError(
+        err instanceof Error ? err.message : "Network request failed",
+        err instanceof Error ? err : void 0
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+    if (!res.ok) {
+      if (res.status === 401) throw new NexusAuthenticationError();
+      throw new NexusApiError("HTTP_ERROR", `Request failed with status ${res.status}`, res.status);
+    }
+    return res.text();
+  }
+  /**
+   * Make a request and return `{ data, meta }` (useful for paginated lists).
+   *
+   * @param method - HTTP method.
+   * @param path - API path relative to `/api/public/v1`.
+   * @param opts - Optional body, query params, and headers.
+   * @returns The response `data` and optional pagination `meta`.
+   * @throws {NexusAuthenticationError} On 401 responses.
+   * @throws {NexusApiError} On other error responses.
+   * @throws {NexusConnectionError} On network failures or timeouts.
+   */
+  async requestWithMeta(method, path5, opts = {}) {
+    const url = new URL(`${this.baseUrl}/api/public/v1${path5}`);
+    if (opts.query) {
+      for (const [k, v] of Object.entries(opts.query)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    const headers = {
+      ...this.defaultHeaders,
+      ...opts.headers,
+      "api-key": this.apiKey,
+      Accept: "application/json"
+    };
+    const fetchInit = { method, headers };
+    if (opts.body !== void 0) {
+      if (opts.body instanceof FormData) {
+        fetchInit.body = opts.body;
+      } else {
+        headers["Content-Type"] = "application/json";
+        fetchInit.body = JSON.stringify(opts.body);
+      }
+    }
+    const controller = new AbortController();
+    fetchInit.signal = controller.signal;
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    let res;
+    try {
+      res = await this.fetchFn(url.toString(), fetchInit);
+    } catch (err) {
+      clearTimeout(timer);
+      if (err instanceof DOMException && err.name === "AbortError") {
+        throw new NexusConnectionError(`Request timed out after ${this.timeout}ms`);
+      }
+      throw new NexusConnectionError(
+        err instanceof Error ? err.message : "Network request failed",
+        err instanceof Error ? err : void 0
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+    if (res.status === 204) {
+      return { data: {}, meta: void 0 };
+    }
+    let json;
+    try {
+      json = await res.json();
+    } catch {
+      throw new NexusApiError(
+        "PARSE_ERROR",
+        `Failed to parse response body (status ${res.status})`,
+        res.status
+      );
+    }
+    if (!json.success) {
+      const err = json.error;
+      if (!err || typeof err !== "object") {
+        const raw = json;
+        const msg = raw.message ?? `Request failed with status ${res.status}`;
+        const code = raw.error ?? `HTTP_${res.status}`;
+        if (res.status === 401) {
+          throw new NexusAuthenticationError(msg);
+        }
+        throw new NexusApiError(code, msg, res.status);
+      }
+      if (res.status === 401) {
+        throw new NexusAuthenticationError(err.message);
+      }
+      throw new NexusApiError(err.code, err.message, res.status, err.details);
+    }
+    const success = json;
+    return { data: success.data, meta: success.meta };
+  }
+};
+var BaseResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+};
+var AgentCollectionsResource = class extends BaseResource {
+  async list(agentId) {
+    return this.http.request("GET", `/agents/${agentId}/collections`);
+  }
+  async attach(agentId, body) {
+    return this.http.request("POST", `/agents/${agentId}/collections`, { body });
+  }
+  async detach(agentId, body) {
+    return this.http.request("DELETE", `/agents/${agentId}/collections`, { body });
+  }
+};
+var AgentToolsResource = class extends BaseResource {
+  /**
+   * List all tool configurations for an agent.
+   *
+   * @param agentId - Agent UUID.
+   * @returns Array of tool configurations.
+   */
+  async list(agentId) {
+    return this.http.request("GET", `/agents/${agentId}/tools`);
+  }
+  /**
+   * Get a specific tool configuration.
+   *
+   * @param agentId - Agent UUID.
+   * @param toolId - Tool config UUID.
+   * @returns Tool configuration detail.
+   */
+  async get(agentId, toolId) {
+    return this.http.request("GET", `/agents/${agentId}/tools/${toolId}`);
+  }
+  /**
+   * Add a new tool configuration to an agent.
+   *
+   * @param agentId - Agent UUID.
+   * @param body - Tool configuration. `label` and `type` are required.
+   * @returns The created tool configuration.
+   */
+  async create(agentId, body) {
+    return this.http.request("POST", `/agents/${agentId}/tools`, { body });
+  }
+  /**
+   * Update an existing tool configuration. Only provided fields are updated.
+   *
+   * @param agentId - Agent UUID.
+   * @param toolId - Tool config UUID.
+   * @param body - Fields to update.
+   * @returns The updated tool configuration.
+   */
+  async update(agentId, toolId, body) {
+    return this.http.request("PATCH", `/agents/${agentId}/tools/${toolId}`, {
+      body
+    });
+  }
+  /**
+   * Remove a tool configuration from an agent.
+   *
+   * @param agentId - Agent UUID.
+   * @param toolId - Tool config UUID.
+   * @returns Confirmation with the deleted tool config's ID.
+   */
+  async delete(agentId, toolId) {
+    return this.http.request("DELETE", `/agents/${agentId}/tools/${toolId}`);
+  }
+  /**
+   * Attach a knowledge collection to an agent.
+   *
+   * Creates a COLLECTION-type tool that allows the agent to search the
+   * collection during conversations. If `label` is omitted, the collection
+   * name is used.
+   *
+   * @param agentId - Agent UUID.
+   * @param body - Collection ID and optional label/description/instructions.
+   * @returns The created tool configuration.
+   *
+   * @example
+   * ```ts
+   * const tool = await client.agents.tools.attachCollection("agent-uuid", {
+   *   collectionId: "collection-uuid"
+   * });
+   * ```
+   */
+  async attachCollection(agentId, body) {
+    return this.http.request(
+      "POST",
+      `/agents/${agentId}/tools/attach-collection`,
+      { body }
+    );
+  }
+};
+var VersionsResource = class extends BaseResource {
+  /**
+   * List prompt versions for an agent (paginated).
+   *
+   * @param agentId - Agent UUID.
+   * @param params - Optional type filter and pagination.
+   * @returns Paginated list of version summaries.
+   */
+  async list(agentId, params) {
+    const { data, meta } = await this.http.requestWithMeta(
+      "GET",
+      `/agents/${agentId}/versions`,
+      { query: params }
+    );
+    return { data, meta };
+  }
+  /**
+   * Get detailed information about a specific version, including the full prompt content.
+   *
+   * @param agentId - Agent UUID.
+   * @param versionId - Version UUID.
+   * @returns Version detail with the prompt text.
+   */
+  async get(agentId, versionId) {
+    return this.http.request("GET", `/agents/${agentId}/versions/${versionId}`);
+  }
+  /**
+   * Create a named checkpoint of the agent's current prompt.
+   *
+   * @param agentId - Agent UUID.
+   * @param body - Optional name and description for the checkpoint.
+   * @returns The created checkpoint version.
+   */
+  async createCheckpoint(agentId, body) {
+    return this.http.request("POST", `/agents/${agentId}/versions`, {
+      body: body ?? {}
+    });
+  }
+  /**
+   * Update a version's metadata (name or description).
+   *
+   * @param agentId - Agent UUID.
+   * @param versionId - Version UUID.
+   * @param body - Fields to update.
+   * @returns The updated version detail.
+   */
+  async update(agentId, versionId, body) {
+    return this.http.request("PATCH", `/agents/${agentId}/versions/${versionId}`, {
+      body
+    });
+  }
+  /**
+   * Delete a prompt version. Cannot delete the current production version.
+   *
+   * @param agentId - Agent UUID.
+   * @param versionId - Version UUID.
+   * @returns Confirmation with the deleted version's ID.
+   */
+  async delete(agentId, versionId) {
+    return this.http.request("DELETE", `/agents/${agentId}/versions/${versionId}`);
+  }
+  /**
+   * Restore the agent's prompt to a specific version. This overwrites the
+   * agent's current prompt with the content from the specified version.
+   *
+   * @param agentId - Agent UUID.
+   * @param versionId - Version UUID to restore.
+   * @returns The restored prompt content and a confirmation message.
+   */
+  async restore(agentId, versionId) {
+    return this.http.request(
+      "POST",
+      `/agents/${agentId}/versions/${versionId}/restore`
+    );
+  }
+  /**
+   * Publish a version to production. This marks the version as the active
+   * production version for the agent.
+   *
+   * @param agentId - Agent UUID.
+   * @param versionId - Version UUID to publish.
+   * @returns The published version detail with `isProduction: true`.
+   */
+  async publish(agentId, versionId) {
+    return this.http.request(
+      "POST",
+      `/agents/${agentId}/versions/${versionId}/publish`
+    );
+  }
+};
+var AgentsResource = class extends BaseResource {
+  constructor(http) {
+    super(http);
+    this.tools = new AgentToolsResource(http);
+    this.versions = new VersionsResource(http);
+  }
+  /**
+   * List agents with optional filtering and pagination.
+   *
+   * @param params - Optional filters and pagination.
+   * @returns Paginated list of agent summaries.
+   */
+  async list(params) {
+    const { data, meta } = await this.http.requestWithMeta("GET", "/agents", {
+      query: params
+    });
+    return { data, meta };
+  }
+  /**
+   * Get detailed information about a specific agent.
+   *
+   * @param agentId - Agent UUID.
+   * @returns Full agent detail including prompt, behaviour rules, and model configuration.
+   */
+  async get(agentId) {
+    return this.http.request("GET", `/agents/${agentId}`);
+  }
+  /**
+   * Create a new agent.
+   *
+   * @param body - Agent properties. `firstName`, `lastName`, and `role` are required.
+   * @returns The created agent detail.
+   */
+  async create(body) {
+    return this.http.request("POST", "/agents", { body });
+  }
+  /**
+   * Update an existing agent's properties. Only provided fields are updated.
+   *
+   * @param agentId - Agent UUID.
+   * @param body - Fields to update.
+   * @returns The updated agent detail.
+   */
+  async update(agentId, body) {
+    return this.http.request("PATCH", `/agents/${agentId}`, { body });
+  }
+  /**
+   * Permanently delete an agent and all its tool configurations and versions.
+   *
+   * @param agentId - Agent UUID.
+   * @returns Confirmation with the deleted agent's ID.
+   */
+  async delete(agentId) {
+    return this.http.request("DELETE", `/agents/${agentId}`);
+  }
+  /**
+   * Create a copy of an existing agent, including its configuration and tools.
+   *
+   * @param agentId - Agent UUID to duplicate.
+   * @returns The newly created agent detail.
+   */
+  async duplicate(agentId) {
+    return this.http.request("POST", `/agents/${agentId}/duplicate`);
+  }
+  /**
+   * Upload a profile picture for an agent.
+   *
+   * @param agentId - Agent UUID.
+   * @param file - Image file as a Blob or File.
+   * @returns URL to the uploaded profile picture.
+   */
+  async uploadProfilePicture(agentId, file) {
+    const formData = new FormData();
+    formData.append("file", file);
+    return this.http.request(
+      "POST",
+      `/agents/${agentId}/profile-picture`,
+      { body: formData }
+    );
+  }
+  /**
+   * Generate an AI profile picture for an agent using its name and role.
+   *
+   * @param agentId - Agent UUID.
+   * @param body - Optional custom prompt to guide image style.
+   * @returns URLs of the generated profile picture in multiple sizes.
+   */
+  async generateProfilePicture(agentId, body) {
+    return this.http.request("POST", `/agents/${agentId}/generate-profile-picture`, { body });
+  }
+};
+var ChannelsResource = class extends BaseResource {
+  // ===========================================================================
+  // Setup Orchestrator
+  // ===========================================================================
+  async getSetupStatus(type) {
+    return this.http.request("GET", "/channels/setup", {
+      query: { type }
+    });
+  }
+  async autoProvision(body) {
+    return this.http.request("POST", "/channels/setup", { body });
+  }
+  // ===========================================================================
+  // Connections
+  // ===========================================================================
+  async listConnections() {
+    return this.http.request("GET", "/channels/connections");
+  }
+  async createConnection(body) {
+    return this.http.request("POST", "/channels/connections", { body: body ?? {} });
+  }
+  async getConnection(connectionId) {
+    return this.http.request("GET", `/channels/connections/${connectionId}`);
+  }
+  // ===========================================================================
+  // Phone Numbers (mirrors /phone-numbers under /channels/)
+  // ===========================================================================
+  async searchAvailablePhoneNumbers(params) {
+    return this.http.request("GET", "/channels/phone-numbers/available", {
+      query: params
+    });
+  }
+  async buyPhoneNumber(body) {
+    return this.http.request("POST", "/channels/phone-numbers/buy", { body });
+  }
+  async listPhoneNumbers() {
+    return this.http.request("GET", "/channels/phone-numbers");
+  }
+  async getPhoneNumber(phoneNumberId) {
+    return this.http.request("GET", `/channels/phone-numbers/${phoneNumberId}`);
+  }
+  // ===========================================================================
+  // WhatsApp Senders
+  // ===========================================================================
+  async listWhatsAppSenders() {
+    return this.http.request("GET", "/channels/whatsapp-senders");
+  }
+  async createWhatsAppSender(body) {
+    return this.http.request("POST", "/channels/whatsapp-senders", { body });
+  }
+  async getWhatsAppSender(senderId) {
+    return this.http.request("GET", `/channels/whatsapp-senders/${senderId}`);
+  }
+};
+var AnalyticsResource = class extends BaseResource {
+  async getOverview(params) {
+    return this.http.request("GET", "/analytics/overview", {
+      query: params
+    });
+  }
+  async exportCsv(params) {
+    return this.http.requestRaw("GET", "/analytics/export", {
+      query: params
+    });
+  }
+  async listFeedback(params) {
+    const { data, meta } = await this.http.requestWithMeta("GET", "/analytics/feedback", {
+      query: params
+    });
+    return { data, meta };
+  }
+};
+var CloudImportsResource = class extends BaseResource {
+  // Google Drive
+  async googleDriveAuth(body) {
+    return this.http.request("POST", "/documents/google-drive/auth", { body });
+  }
+  async googleDriveRefresh(body) {
+    return this.http.request("POST", "/documents/google-drive/refresh", { body });
+  }
+  async listGoogleDriveFiles(params) {
+    return this.http.request("GET", "/documents/google-drive/files", {
+      query: params
+    });
+  }
+  async importGoogleDrive(body) {
+    return this.http.request("POST", "/documents/google-drive/import", { body });
+  }
+  // SharePoint
+  async sharePointAuth(body) {
+    return this.http.request("POST", "/documents/sharepoint/auth", { body });
+  }
+  async sharePointRefresh(body) {
+    return this.http.request("POST", "/documents/sharepoint/refresh", { body });
+  }
+  async listSharePointSites(params) {
+    return this.http.request("GET", "/documents/sharepoint/sites", {
+      query: params
+    });
+  }
+  async listSharePointFiles(params) {
+    return this.http.request("GET", "/documents/sharepoint/files", {
+      query: params
+    });
+  }
+  async importSharePoint(body) {
+    return this.http.request("POST", "/documents/sharepoint/import", { body });
+  }
+  // Notion
+  async notionAuth(body) {
+    return this.http.request("POST", "/documents/notion/auth", { body });
+  }
+  async searchNotion(params) {
+    return this.http.request("GET", "/documents/notion/search", {
+      query: params
+    });
+  }
+  async importNotion(body) {
+    return this.http.request("POST", "/documents/notion/import", { body });
+  }
+};
+var CustomModelsResource = class extends BaseResource {
+  /**
+   * List all custom models for the organization.
+   */
+  async list() {
+    return this.http.request("GET", "/custom-models");
+  }
+  /**
+   * Get a custom model by ID.
+   */
+  async get(customModelId) {
+    return this.http.request("GET", `/custom-models/${customModelId}`);
+  }
+  /**
+   * Create a new custom model.
+   */
+  async create(body) {
+    return this.http.request("POST", "/custom-models", { body });
+  }
+  /**
+   * Update a custom model.
+   */
+  async update(customModelId, body) {
+    return this.http.request("PATCH", `/custom-models/${customModelId}`, {
+      body
+    });
+  }
+  /**
+   * Delete a custom model.
+   */
+  async delete(customModelId) {
+    return this.http.request("DELETE", `/custom-models/${customModelId}`);
+  }
+};
+var DeploymentFoldersResource = class extends BaseResource {
+  async list() {
+    return this.http.request("GET", "/deployment-folders");
+  }
+  async create(body) {
+    return this.http.request("POST", "/deployment-folders", { body });
+  }
+  async update(folderId, body) {
+    return this.http.request("PATCH", `/deployment-folders/${folderId}`, { body });
+  }
+  async delete(folderId) {
+    return this.http.request("DELETE", `/deployment-folders/${folderId}`);
+  }
+  async assign(body) {
+    return this.http.request("POST", "/deployment-folders/assign", { body });
+  }
+};
+var DeploymentsResource = class extends BaseResource {
+  async list(params) {
+    const { data, meta } = await this.http.requestWithMeta("GET", "/deployments", {
+      query: params
+    });
+    return { data, meta };
+  }
+  async create(body) {
+    return this.http.request("POST", "/deployments", { body });
+  }
+  async get(deploymentId) {
+    return this.http.request("GET", `/deployments/${deploymentId}`);
+  }
+  async update(deploymentId, body) {
+    return this.http.request("PATCH", `/deployments/${deploymentId}`, { body });
+  }
+  async delete(deploymentId) {
+    return this.http.request("DELETE", `/deployments/${deploymentId}`);
+  }
+  async duplicate(deploymentId) {
+    return this.http.request("POST", `/deployments/${deploymentId}/duplicate`);
+  }
+  async getStatistics(deploymentId) {
+    return this.http.request("GET", `/deployments/${deploymentId}/statistics`);
+  }
+  async getEmbedConfig(deploymentId) {
+    return this.http.request("GET", `/deployments/${deploymentId}/embed-config`);
+  }
+  async updateEmbedConfig(deploymentId, body) {
+    return this.http.request("PATCH", `/deployments/${deploymentId}/embed-config`, { body });
+  }
+};
+var DocumentTemplateFoldersResource = class extends BaseResource {
+  async list() {
+    return this.http.request("GET", "/document-template-folders");
+  }
+  async create(body) {
+    return this.http.request("POST", "/document-template-folders", { body });
+  }
+  async update(folderId, body) {
+    return this.http.request("PATCH", `/document-template-folders/${folderId}`, { body });
+  }
+  async delete(folderId) {
+    return this.http.request("DELETE", `/document-template-folders/${folderId}`);
+  }
+  async assign(body) {
+    return this.http.request("POST", "/document-template-folders/assign", { body });
+  }
+};
+var DocumentsResource = class extends BaseResource {
+  /**
+   * Get a document by ID.
+   *
+   * @param documentId - The document's UUID.
+   * @returns Detailed document information.
+   *
+   * @example
+   * ```ts
+   * const doc = await client.documents.get("doc-uuid");
+   * console.log(doc.name, doc.status, doc.processingProgress);
+   * ```
+   */
+  async get(documentId) {
+    return this.http.request("GET", `/documents/${documentId}`);
+  }
+  /**
+   * Upload a file as a new document.
+   *
+   * @param file - File as a `Blob`, `File`, or `Buffer`.
+   * @param fileName - File name (required when passing a `Blob` or `Buffer`).
+   * @param description - Optional description.
+   * @returns Created document info.
+   *
+   * @example
+   * ```ts
+   * import fs from "fs";
+   *
+   * const buffer = fs.readFileSync("report.pdf");
+   * const doc = await client.documents.uploadFile(
+   *   new Blob([buffer]),
+   *   "report.pdf",
+   *   "Q4 financial report"
+   * );
+   * console.log(doc.id, doc.status);
+   * ```
+   */
+  async uploadFile(file, fileName, description) {
+    const formData = new FormData();
+    formData.append("file", file, fileName);
+    if (description) {
+      formData.append("description", description);
+    }
+    return this.http.request("POST", "/documents/file", { body: formData });
+  }
+  /**
+   * Create a new document from inline text content.
+   *
+   * @param body - Document name, content, and optional description.
+   * @returns Created document info.
+   *
+   * @example
+   * ```ts
+   * const doc = await client.documents.createText({
+   *   name: "Meeting Notes",
+   *   content: "Key decisions from today's meeting..."
+   * });
+   * ```
+   */
+  async createText(body) {
+    return this.http.request("POST", "/documents/text", { body });
+  }
+  /**
+   * Crawl a website and create document(s) from the content.
+   *
+   * @param body - URL, crawl mode, optional config and description.
+   * @returns Created document info (folder for crawled pages).
+   *
+   * @example
+   * ```ts
+   * const doc = await client.documents.addWebsite({
+   *   url: "https://docs.example.com",
+   *   mode: "sitemap"
+   * });
+   * ```
+   */
+  async addWebsite(body) {
+    return this.http.request("POST", "/documents/website", { body });
+  }
+  /**
+   * Import a Google Sheet as document(s).
+   *
+   * @param body - Sheet name, URL, and optional metadata.
+   * @returns Folder document, individual sheet documents, and status message.
+   *
+   * @example
+   * ```ts
+   * const result = await client.documents.createGoogleSheet({
+   *   name: "Product Catalog",
+   *   url: "https://docs.google.com/spreadsheets/d/..."
+   * });
+   * console.log(result.folder.id, result.sheets.length);
+   * ```
+   */
+  async createGoogleSheet(body) {
+    return this.http.request("POST", "/documents/google-sheet", { body });
+  }
+  async list(params) {
+    const { data, meta } = await this.http.requestWithMeta("GET", "/documents", {
+      query: params
+    });
+    return { data, meta };
+  }
+  async update(documentId, body) {
+    return this.http.request("PATCH", `/documents/${documentId}`, { body });
+  }
+  async delete(documentId) {
+    return this.http.request("DELETE", `/documents/${documentId}`);
+  }
+  async getDownloadUrl(documentId) {
+    return this.http.request(
+      "GET",
+      `/documents/${documentId}/download`
+    );
+  }
+  async listChildren(documentId, params) {
+    const { data, meta } = await this.http.requestWithMeta(
+      "GET",
+      `/documents/${documentId}/children`,
+      {
+        query: params
+      }
+    );
+    return { data, meta };
+  }
+  async reprocess(documentId) {
+    return this.http.request("POST", `/documents/${documentId}/reprocess`);
+  }
+  async createFolder(body) {
+    return this.http.request("POST", "/documents/folder", { body });
+  }
+};
+var EmulatorResource = class extends BaseResource {
+  // ─── Sessions ───────────────────────────────────────────────────────────────
+  /** Create a new emulator session for a deployment. */
+  async createSession(deploymentId, body) {
+    return this.http.request("POST", `/emulator/${deploymentId}/sessions`, {
+      body
+    });
+  }
+  /** List emulator sessions for a deployment. */
+  async listSessions(deploymentId) {
+    return this.http.request("GET", `/emulator/${deploymentId}/sessions`);
+  }
+  /** Get detailed information about an emulator session, including messages. */
+  async getSession(deploymentId, sessionId) {
+    return this.http.request(
+      "GET",
+      `/emulator/${deploymentId}/sessions/${sessionId}`
+    );
+  }
+  /** Send a message in an emulator session. Returns debug info about agent execution. */
+  async sendMessage(deploymentId, sessionId, body) {
+    return this.http.request(
+      "POST",
+      `/emulator/${deploymentId}/sessions/${sessionId}/messages`,
+      { body }
+    );
+  }
+  /** Delete an emulator session. */
+  async deleteSession(deploymentId, sessionId) {
+    await this.http.request("DELETE", `/emulator/${deploymentId}/sessions/${sessionId}`);
+  }
+  // ─── Scenarios ──────────────────────────────────────────────────────────────
+  /** Save a scenario from an existing emulator session. */
+  async saveScenario(body) {
+    return this.http.request("POST", "/emulator/scenarios", {
+      body
+    });
+  }
+  /** List scenarios, optionally filtered by deployment. */
+  async listScenarios(params) {
+    return this.http.request("GET", "/emulator/scenarios", {
+      query: params
+    });
+  }
+  /** Get detailed information about a scenario, including its messages. */
+  async getScenario(scenarioId) {
+    return this.http.request("GET", `/emulator/scenarios/${scenarioId}`);
+  }
+  /** Replay a scenario against a deployment. Runs asynchronously. */
+  async replayScenario(scenarioId, body) {
+    return this.http.request("POST", `/emulator/scenarios/${scenarioId}/replay`, { body });
+  }
+  /** Delete a scenario. */
+  async deleteScenario(scenarioId) {
+    await this.http.request("DELETE", `/emulator/scenarios/${scenarioId}`);
+  }
+};
+var EvaluationsResource = class extends BaseResource {
+  async createSession(taskId, body) {
+    return this.http.request("POST", `/skills/tasks/${taskId}/evaluations`, { body });
+  }
+  async listSessions(taskId, params) {
+    const { data, meta } = await this.http.requestWithMeta(
+      "GET",
+      `/skills/tasks/${taskId}/evaluations`,
+      {
+        query: params
+      }
+    );
+    return { data, meta };
+  }
+  async getSession(taskId, sessionId) {
+    return this.http.request("GET", `/skills/tasks/${taskId}/evaluations/${sessionId}`);
+  }
+  async deleteSession(taskId, sessionId) {
+    return this.http.request("DELETE", `/skills/tasks/${taskId}/evaluations/${sessionId}`);
+  }
+  async getDatasetRows(taskId, sessionId, params) {
+    const { data, meta } = await this.http.requestWithMeta(
+      "GET",
+      `/skills/tasks/${taskId}/evaluations/${sessionId}/dataset`,
+      {
+        query: params
+      }
+    );
+    return { data, meta };
+  }
+  async addDatasetRow(taskId, sessionId, body) {
+    return this.http.request(
+      "POST",
+      `/skills/tasks/${taskId}/evaluations/${sessionId}/dataset/rows`,
+      { body }
+    );
+  }
+  async execute(taskId, sessionId) {
+    return this.http.request(
+      "POST",
+      `/skills/tasks/${taskId}/evaluations/${sessionId}/execute`
+    );
+  }
+  async judge(taskId, sessionId, body) {
+    return this.http.request(
+      "POST",
+      `/skills/tasks/${taskId}/evaluations/${sessionId}/judge`,
+      { body }
+    );
+  }
+  async getResults(taskId, sessionId, params) {
+    const { data, meta } = await this.http.requestWithMeta(
+      "GET",
+      `/skills/tasks/${taskId}/evaluations/${sessionId}/results`,
+      {
+        query: params
+      }
+    );
+    return { data, meta };
+  }
+  async listFormats() {
+    return this.http.request("GET", "/skills/evaluations/formats");
+  }
+  async listJudges() {
+    return this.http.request("GET", "/skills/evaluations/judges");
+  }
+};
+var FoldersResource = class extends BaseResource {
+  /**
+   * List all folders and their agent assignments.
+   *
+   * @returns All folders and a flat list of agent-to-folder assignments.
+   */
+  async list() {
+    return this.http.request("GET", "/folders");
+  }
+  /**
+   * Create a new folder for organizing agents.
+   *
+   * @param body - Folder properties. `name` is required. Set `parentId` for nesting.
+   * @returns The created folder.
+   */
+  async create(body) {
+    return this.http.request("POST", "/folders", { body });
+  }
+  /**
+   * Update a folder's properties.
+   *
+   * @param folderId - Folder UUID.
+   * @param body - Fields to update. Set `parentId` to `null` to move to root level.
+   * @returns The updated folder.
+   */
+  async update(folderId, body) {
+    return this.http.request("PATCH", `/folders/${folderId}`, { body });
+  }
+  /**
+   * Delete a folder. Agents in the folder are unassigned, not deleted.
+   *
+   * @param folderId - Folder UUID.
+   * @returns Confirmation with the deleted folder's ID.
+   */
+  async delete(folderId) {
+    return this.http.request("DELETE", `/folders/${folderId}`);
+  }
+  /**
+   * Assign an agent to a folder, or remove from folder.
+   *
+   * @param body - Agent ID and target folder ID. Set `folderId` to `null` to remove the agent from its folder.
+   * @returns Confirmation of the assignment.
+   */
+  async assignAgent(body) {
+    return this.http.request("POST", "/folders/assign", {
+      body
+    });
+  }
+};
+var MeResource = class extends BaseResource {
+  constructor(http) {
+    super(http);
+  }
+  /**
+   * Get organization info for the current API key.
+   *
+   * @returns Organization ID and name.
+   */
+  async get() {
+    return this.http.request("GET", "/me");
+  }
+};
+var ModelsResource = class extends BaseResource {
+  constructor(http) {
+    super(http);
+  }
+  /**
+   * List all enabled AI models available for agents.
+   *
+   * @returns Array of model summaries with identifiers, providers, and capabilities.
+   */
+  async list() {
+    return this.http.request("GET", "/models");
+  }
+};
+var PhoneNumbersResource = class extends BaseResource {
+  async searchAvailable(params) {
+    return this.http.request("GET", "/phone-numbers/available", {
+      query: params
+    });
+  }
+  async buy(body) {
+    return this.http.request("POST", "/phone-numbers/buy", { body });
+  }
+  async list() {
+    return this.http.request("GET", "/phone-numbers");
+  }
+  async get(phoneNumberId) {
+    return this.http.request("GET", `/phone-numbers/${phoneNumberId}`);
+  }
+  async release(phoneNumberId) {
+    return this.http.request("DELETE", `/phone-numbers/${phoneNumberId}`);
+  }
+};
+var PromptAssistantResource = class extends BaseResource {
+  async chat(body) {
+    return this.http.request("POST", "/prompt-assistant/chat", {
+      body
+    });
+  }
+  async getThread(threadId) {
+    return this.http.request(
+      "GET",
+      `/prompt-assistant/threads/${threadId}`
+    );
+  }
+  async deleteThread(threadId) {
+    return this.http.request(
+      "DELETE",
+      `/prompt-assistant/threads/${threadId}`
+    );
+  }
+};
+var SkillsResource = class extends BaseResource {
+  /**
+   * List the organization's workflows.
+   *
+   * @param params - Optional search, limit, and offset.
+   * @returns Matching workflows with `agentInputSchema` and total count.
+   *
+   * @example
+   * ```ts
+   * const { items, total } = await client.skills.listWorkflows({ search: "onboarding" });
+   * for (const wf of items) {
+   *   console.log(`${wf.name} (${wf.status}) - trigger: ${wf.triggerType}`);
+   * }
+   * ```
+   */
+  async listWorkflows(params) {
+    return this.http.request("GET", "/skills/workflows", {
+      query: params
+    });
+  }
+  /**
+   * Get a single workflow by ID.
+   *
+   * @param workflowId - Workflow UUID.
+   * @returns Full workflow detail including `agentInputSchema`.
+   *
+   * @example
+   * ```ts
+   * const wf = await client.skills.getWorkflow("workflow-uuid");
+   * console.log(wf.agentInputSchema); // JSON Schema the agent fills
+   * ```
+   */
+  async getWorkflow(workflowId) {
+    return this.http.request("GET", `/skills/workflows/${workflowId}`);
+  }
+  /**
+   * List the organization's AI tasks.
+   *
+   * @param params - Optional search, limit, and offset.
+   * @returns Matching tasks (summary view) and total count.
+   *
+   * @example
+   * ```ts
+   * const { items, total } = await client.skills.listTasks({ limit: 50 });
+   * for (const task of items) {
+   *   console.log(`${task.name} (${task.category}) - ${task.inputFormat} → ${task.outputFormat}`);
+   * }
+   * ```
+   */
+  async listTasks(params) {
+    return this.http.request("GET", "/skills/tasks", {
+      query: params
+    });
+  }
+  /**
+   * Get a single AI task by ID with full detail.
+   *
+   * Includes `jsonInputSchema` and `jsonOutputSchema` when the task uses
+   * structured JSON input/output.
+   *
+   * @param taskId - AI Task UUID.
+   * @returns Full task detail.
+   *
+   * @example
+   * ```ts
+   * const task = await client.skills.getTask("task-uuid");
+   * if (task.jsonInputSchema) {
+   *   console.log("Input schema:", task.jsonInputSchema);
+   * }
+   * ```
+   */
+  async getTask(taskId) {
+    return this.http.request("GET", `/skills/tasks/${taskId}`);
+  }
+  /**
+   * List the organization's knowledge collections.
+   *
+   * @param params - Optional search, limit, and offset.
+   * @returns Matching collections (summary view) and total count.
+   *
+   * @example
+   * ```ts
+   * const { items } = await client.skills.listCollections();
+   * for (const col of items) {
+   *   console.log(`${col.name}: ${col.documentCount} documents`);
+   * }
+   * ```
+   */
+  async listCollections(params) {
+    return this.http.request("GET", "/skills/collections", {
+      query: params
+    });
+  }
+  /**
+   * Get a single knowledge collection by ID with retrieval settings.
+   *
+   * @param collectionId - Collection UUID.
+   * @returns Full collection detail with `k`, `reranker`, etc.
+   *
+   * @example
+   * ```ts
+   * const col = await client.skills.getCollection("collection-uuid");
+   * console.log(`k=${col.k}, reranker=${col.reranker}`);
+   * ```
+   */
+  async getCollection(collectionId) {
+    return this.http.request("GET", `/skills/collections/${collectionId}`);
+  }
+  /**
+   * List the organization's document templates.
+   *
+   * @param params - Optional search, limit, and offset.
+   * @returns Matching templates (summary view) and total count.
+   *
+   * @example
+   * ```ts
+   * const { items } = await client.skills.listDocumentTemplates({ search: "invoice" });
+   * for (const tpl of items) {
+   *   console.log(`${tpl.name} (${tpl.type}) - ${tpl.status}`);
+   * }
+   * ```
+   */
+  async listDocumentTemplates(params) {
+    return this.http.request("GET", "/skills/document-templates", {
+      query: params
+    });
+  }
+  /**
+   * Get a single document template by ID with full detail.
+   *
+   * Includes `inputFormat` (JSON schema of required inputs) and
+   * `slidesInputFormat` (per-slide schemas for presentations).
+   *
+   * @param templateId - Document template UUID.
+   * @returns Full template detail.
+   *
+   * @example
+   * ```ts
+   * const tpl = await client.skills.getDocumentTemplate("template-uuid");
+   * console.log("Input format:", tpl.inputFormat);
+   * ```
+   */
+  async getDocumentTemplate(templateId) {
+    return this.http.request(
+      "GET",
+      `/skills/document-templates/${templateId}`
+    );
+  }
+  // =========================================================================
+  // CREATE OPERATIONS
+  // =========================================================================
+  /**
+   * Create a new document template (metadata only).
+   *
+   * Upload a file separately with `uploadDocumentTemplateFile`.
+   *
+   * @param body - Template name, optional description, and type.
+   * @returns Created template detail.
+   *
+   * @example
+   * ```ts
+   * const tpl = await client.skills.createDocumentTemplate({
+   *   name: "Invoice",
+   *   type: "WORD_FORMAT"
+   * });
+   * ```
+   */
+  async createDocumentTemplate(body) {
+    return this.http.request("POST", "/skills/document-templates", {
+      body
+    });
+  }
+  /**
+   * Upload a file and link it to an existing document template.
+   *
+   * @param templateId - Document template UUID.
+   * @param file - File as a `Blob`, `File`, or `Buffer`.
+   * @param fileName - File name (required when passing a `Blob` or `Buffer`).
+   * @returns Updated template detail with `fileUrl` populated.
+   *
+   * @example
+   * ```ts
+   * import fs from "fs";
+   *
+   * const buffer = fs.readFileSync("template.docx");
+   * const tpl = await client.skills.uploadDocumentTemplateFile(
+   *   "template-uuid",
+   *   new Blob([buffer]),
+   *   "template.docx"
+   * );
+   * console.log(tpl.fileUrl);
+   * ```
+   */
+  async uploadDocumentTemplateFile(templateId, file, fileName) {
+    const formData = new FormData();
+    formData.append("file", file, fileName);
+    return this.http.request(
+      "POST",
+      `/skills/document-templates/${templateId}/upload-file`,
+      { body: formData }
+    );
+  }
+  /**
+   * Create a new GENERATION AI task.
+   *
+   * The category is hardcoded to "GENERATION". The `modelName` is validated
+   * against the available AI models — on invalid model, returns 400 with
+   * the list of valid model names.
+   *
+   * @param body - Task definition.
+   * @returns Created task detail.
+   *
+   * @example
+   * ```ts
+   * const task = await client.skills.createTask({
+   *   name: "Summarize Email",
+   *   modelName: "gpt-4o",
+   *   modelProvider: "OPEN_AI",
+   *   generation: {
+   *     expectedInput: "Raw email text",
+   *     expectedOutput: "A concise 2-sentence summary"
+   *   }
+   * });
+   * ```
+   */
+  async createTask(body) {
+    return this.http.request("POST", "/skills/tasks", { body });
+  }
+  /**
+   * Create a new knowledge collection.
+   *
+   * @param body - Collection name and optional settings.
+   * @returns Created collection detail.
+   *
+   * @example
+   * ```ts
+   * const col = await client.skills.createCollection({
+   *   name: "product-docs",
+   *   displayName: "Product Documentation",
+   *   k: 15
+   * });
+   * ```
+   */
+  async createCollection(body) {
+    return this.http.request("POST", "/skills/collections", { body });
+  }
+  // =========================================================================
+  // EXTERNAL TOOLS (CUSTOM_MANIFEST)
+  // =========================================================================
+  /**
+   * List the organization's external tools (CUSTOM_MANIFEST).
+   *
+   * @param params - Optional search, limit, and offset.
+   * @returns Matching external tools and total count.
+   *
+   * @example
+   * ```ts
+   * const { items, total } = await client.skills.listExternalTools({ search: "weather" });
+   * for (const tool of items) {
+   *   console.log(`${tool.name} (${tool.actionsCount} actions) - auth: ${tool.authType}`);
+   * }
+   * ```
+   */
+  async listExternalTools(params) {
+    return this.http.request("GET", "/skills/external-tools", {
+      query: params
+    });
+  }
+  /**
+   * Get a single external tool by ID.
+   *
+   * @param externalToolId - External tool UUID.
+   * @returns Full external tool detail.
+   *
+   * @example
+   * ```ts
+   * const tool = await client.skills.getExternalTool("tool-uuid");
+   * console.log(`${tool.name}: ${tool.actionsCount} actions, auth: ${tool.authType}`);
+   * ```
+   */
+  async getExternalTool(externalToolId) {
+    return this.http.request("GET", `/skills/external-tools/${externalToolId}`);
+  }
+  /**
+   * Create a new external tool from an OpenAPI spec.
+   *
+   * Parses the provided OpenAPI spec (JSON or YAML), extracts actions,
+   * and creates the tool with the specified auth configuration.
+   *
+   * @param body - Tool name, OpenAPI spec, endpoint URL, and auth config.
+   * @returns Created external tool detail with `actionsCount`.
+   *
+   * @example
+   * ```ts
+   * const tool = await client.skills.createExternalTool({
+   *   name: "Weather API",
+   *   openApiSpec: '{"openapi":"3.0.0",...}',
+   *   endpointUrl: "https://api.weather.com",
+   *   auth: { type: "service_http", apiKey: "sk-...", authorization_type: "bearer" }
+   * });
+   * console.log(`Created: ${tool.name} with ${tool.actionsCount} actions`);
+   * ```
+   */
+  async createExternalTool(body) {
+    return this.http.request("POST", "/skills/external-tools", { body });
+  }
+  /**
+   * Test an external tool action by operationId with input parameters.
+   *
+   * Executes a specific action on an external tool and returns the result.
+   * Optionally uses stored credentials for authentication.
+   *
+   * @param externalToolId - External tool UUID.
+   * @param body - operationId, input params, and optional toolCredentialId.
+   * @returns Execution result with status, output, and timing.
+   *
+   * @example
+   * ```ts
+   * const result = await client.skills.testExternalTool("tool-uuid", {
+   *   operationId: "getWeather",
+   *   input: { city: "London" }
+   * });
+   * console.log(`${result.status} in ${result.executionTimeMs}ms:`, result.output);
+   * ```
+   */
+  async testExternalTool(externalToolId, body) {
+    return this.http.request(
+      "POST",
+      `/skills/external-tools/${externalToolId}/test`,
+      { body }
+    );
+  }
+  // =========================================================================
+  // COLLECTION DOCUMENT LINKING
+  // =========================================================================
+  /**
+   * Attach existing documents to a knowledge collection.
+   *
+   * @param collectionId - Collection UUID.
+   * @param body - Array of document IDs to link.
+   * @returns Status message.
+   *
+   * @example
+   * ```ts
+   * await client.skills.attachDocumentsToCollection("collection-uuid", {
+   *   documentIds: ["doc-1", "doc-2"]
+   * });
+   * ```
+   */
+  async attachDocumentsToCollection(collectionId, body) {
+    return this.http.request(
+      "POST",
+      `/skills/collections/${collectionId}/documents`,
+      { body }
+    );
+  }
+  // =========================================================================
+  // EXECUTION OPERATIONS
+  // =========================================================================
+  /**
+   * Generate a document from a template with variable values.
+   *
+   * @param templateId - Document template UUID.
+   * @param body - Variables to fill in the template.
+   * @returns URL to the generated document.
+   *
+   * @example
+   * ```ts
+   * const { url } = await client.skills.generateDocumentTemplate("template-uuid", {
+   *   variables: { name: "John", date: "2025-01-01" }
+   * });
+   * console.log("Generated document:", url);
+   * ```
+   */
+  async generateDocumentTemplate(templateId, body) {
+    return this.http.request(
+      "POST",
+      `/skills/document-templates/${templateId}/generate`,
+      { body }
+    );
+  }
+  /**
+   * Execute an AI task with input and get the output.
+   *
+   * @param taskId - AI Task UUID.
+   * @param body - Input to the task.
+   * @returns Task output and output type.
+   *
+   * @example
+   * ```ts
+   * const { output, outputType } = await client.skills.executeTask("task-uuid", {
+   *   input: "Summarize this document"
+   * });
+   * console.log(`Output (${outputType}):`, output);
+   * ```
+   */
+  async executeTask(taskId, body) {
+    return this.http.request("POST", `/skills/tasks/${taskId}/execute`, {
+      body
+    });
+  }
+  // ===== COLLECTION MANAGEMENT (Enhanced) =====
+  async listCollectionDocuments(collectionId, params) {
+    const { data, meta } = await this.http.requestWithMeta(
+      "GET",
+      `/skills/collections/${collectionId}/documents`,
+      {
+        query: params
+      }
+    );
+    return { data, meta };
+  }
+  async removeCollectionDocument(collectionId, documentId) {
+    return this.http.request(
+      "DELETE",
+      `/skills/collections/${collectionId}/documents/${documentId}`
+    );
+  }
+  async getCollectionStatistics(collectionId) {
+    return this.http.request("GET", `/skills/collections/${collectionId}/statistics`);
+  }
+  async searchCollection(collectionId, body) {
+    return this.http.request("POST", `/skills/collections/${collectionId}/search`, { body });
+  }
+  async searchMultipleCollections(body) {
+    return this.http.request("POST", "/skills/collections/search", { body });
+  }
+  async updateCollection(collectionId, body) {
+    return this.http.request("PATCH", `/skills/collections/${collectionId}`, { body });
+  }
+  async deleteCollection(collectionId) {
+    return this.http.request("DELETE", `/skills/collections/${collectionId}`);
+  }
+};
+var TicketsResource = class extends BaseResource {
+  constructor(http) {
+    super(http);
+  }
+  async list(params) {
+    const { data, meta } = await this.http.requestWithMeta("GET", "/tickets", {
+      query: params
+    });
+    return { data, meta };
+  }
+  async get(ticketId) {
+    return this.http.request("GET", `/tickets/${ticketId}`);
+  }
+  async create(body) {
+    return this.http.request("POST", "/tickets", { body });
+  }
+  async update(ticketId, body) {
+    return this.http.request("PATCH", `/tickets/${ticketId}`, { body });
+  }
+  async addComment(ticketId, body) {
+    return this.http.request("POST", `/tickets/${ticketId}/comments`, { body });
+  }
+  async listComments(ticketId) {
+    return this.http.request("GET", `/tickets/${ticketId}/comments`);
+  }
+  async uploadAttachment(ticketId, file) {
+    const formData = new FormData();
+    formData.append("file", file);
+    return this.http.request("POST", `/tickets/${ticketId}/attachments`, {
+      body: formData
+    });
+  }
+  async listAttachments(ticketId) {
+    return this.http.request(
+      "GET",
+      `/tickets/${ticketId}/attachments`
+    );
+  }
+};
+var ToolConnectionResource = class extends BaseResource {
+  /**
+   * Initiate a tool connection via OAuth or create an HTTP credential directly.
+   *
+   * For OAuth, returns an `authorizationUrl` the user must visit, plus a
+   * `handshakeId` for polling. For HTTP, creates the credential immediately.
+   *
+   * @param toolId - Marketplace tool ID.
+   * @param body - Connection type and parameters.
+   * @returns OAuth authorization details or the created HTTP credential.
+   */
+  async connect(toolId, body) {
+    return this.http.request(
+      "POST",
+      `/tools/${toolId}/connect`,
+      { body }
+    );
+  }
+  /**
+   * Poll the status of an OAuth handshake.
+   *
+   * @param handshakeId - Handshake UUID returned by `connect()`.
+   * @returns Current handshake status and connection ID if completed.
+   */
+  async pollStatus(handshakeId) {
+    return this.http.request(
+      "GET",
+      `/tools/connect/${handshakeId}/status`
+    );
+  }
+  /**
+   * Wait for an OAuth handshake to complete by polling at regular intervals.
+   *
+   * Resolves when the status changes from `PENDING` to any terminal state
+   * (`COMPLETED`, `FAILED`, or `EXPIRED`), or when the timeout is reached.
+   *
+   * @param handshakeId - Handshake UUID returned by `connect()`.
+   * @param opts - Optional timeout (default 5 min) and polling interval (default 2 s).
+   * @returns Final handshake status.
+   */
+  async waitForConnection(handshakeId, opts) {
+    const timeout = opts?.timeoutMs ?? 5 * 60 * 1e3;
+    const interval = opts?.intervalMs ?? 2e3;
+    const deadline = Date.now() + timeout;
+    while (Date.now() < deadline) {
+      const status = await this.pollStatus(handshakeId);
+      if (status.status !== "PENDING") return status;
+      await new Promise((r) => setTimeout(r, interval));
+    }
+    return {
+      status: "EXPIRED",
+      connectionId: null,
+      errorMessage: "Polling timed out",
+      expiresAt: null
+    };
+  }
+  /**
+   * Delete a credential (connected account) from a tool.
+   *
+   * @param toolId - Marketplace tool ID.
+   * @param credentialId - Credential UUID to delete.
+   */
+  async deleteCredential(toolId, credentialId) {
+    await this.http.request("DELETE", `/tools/${toolId}/credentials/${credentialId}`);
+  }
+};
+var ToolDiscoveryResource = class extends BaseResource {
+  /**
+   * Search marketplace tools by keyword with optional category and type filters.
+   * Uses Typesense full-text search with SQL fallback.
+   *
+   * @param params - Search query and filters.
+   * @returns Matching tools, category facets, and total count.
+   *
+   * @example
+   * ```ts
+   * const result = await client.tools.search({ q: "gmail", limit: 5 });
+   * console.log(`Found ${result.total} tools`);
+   * for (const tool of result.tools) {
+   *   console.log(`${tool.name} (${tool.type}): ${tool.description}`);
+   * }
+   * ```
+   */
+  async search(params) {
+    return this.http.request("GET", "/tools/search", {
+      query: params
+    });
+  }
+  /**
+   * Get full marketplace tool detail including actions and their parameter schemas.
+   *
+   * For Pipedream tools, each action's parameters are enriched with the full
+   * component definition including types, descriptions, defaults, and
+   * `remoteOptions` flags indicating which fields need dynamic option resolution.
+   *
+   * @param toolId - Marketplace tool ID (from search results).
+   * @param params - Optional pagination/filter params for actions.
+   * @returns Full tool detail with actions and parameter schemas.
+   *
+   * @example
+   * ```ts
+   * // Get all actions
+   * const detail = await client.tools.get("tool-uuid");
+   * console.log(`${detail.totalActions} total actions`);
+   *
+   * // Paginate actions
+   * const page = await client.tools.get("tool-uuid", { actionsLimit: 10, actionsOffset: 20 });
+   *
+   * // Search for a specific action
+   * const filtered = await client.tools.get("tool-uuid", { actionsSearch: "get-values" });
+   * ```
+   */
+  async get(toolId, params) {
+    return this.http.request("GET", `/tools/${toolId}`, {
+      query: params
+    });
+  }
+  /**
+   * List existing credentials (connected accounts) for a marketplace tool.
+   *
+   * Credentials represent authenticated connections (e.g. a Gmail OAuth token).
+   * They are read-only through this endpoint — users create credentials via the
+   * Nexus dashboard. Use the credential `id` when calling `resolveOptions()` or
+   * when configuring an agent tool.
+   *
+   * @param toolId - Marketplace tool ID.
+   * @returns List of credentials for this tool in the organization.
+   *
+   * @example
+   * ```ts
+   * const { credentials } = await client.tools.credentials("tool-uuid");
+   * if (credentials.length === 0) {
+   *   console.log("No credentials — user must connect account in dashboard first");
+   * }
+   * ```
+   */
+  async credentials(toolId) {
+    return this.http.request("GET", `/tools/${toolId}/credentials`);
+  }
+  /**
+   * Resolve dynamic dropdown options for a tool action parameter.
+   *
+   * Some parameters (those with `remoteOptions: true` in the tool detail) have
+   * values that depend on the user's connected account — for example, a list of
+   * Gmail labels or Slack channels. This method fetches those options at runtime.
+   *
+   * For cascading dependencies (e.g. "select folder" → "select file in folder"),
+   * pass previously selected values in `configuredProps`.
+   *
+   * @param toolId - Marketplace tool ID.
+   * @param body - Component ID, parameter name, credential, and current values.
+   * @returns Available options for the specified parameter.
+   *
+   * @example
+   * ```ts
+   * const { options } = await client.tools.resolveOptions("tool-uuid", {
+   *   componentId: "gmail-send-email",   // from ToolAction.key
+   *   propName: "label",                  // from ToolActionParameter.name
+   *   credentialId: "cred-uuid",          // from ToolCredential.id
+   *   configuredProps: {}                  // previously selected values
+   * });
+   * for (const opt of options) {
+   *   console.log(`${opt.label}: ${opt.value}`);
+   * }
+   * ```
+   */
+  async resolveOptions(toolId, body) {
+    return this.http.request(
+      "POST",
+      `/tools/${toolId}/resolve-options`,
+      { body }
+    );
+  }
+  /**
+   * List the organization's skills — workflows, AI tasks, and collections.
+   *
+   * Skills are org-owned assets that can be attached to agents as tool
+   * configurations of type WORKFLOW, TASK, or COLLECTION (as opposed to
+   * marketplace PLUGIN tools).
+   *
+   * @param params - Optional type filter, search, and pagination.
+   * @returns Matching skills and total count.
+   *
+   * @example
+   * ```ts
+   * // List all workflows
+   * const { skills, total } = await client.tools.skills({ type: "WORKFLOW" });
+   * console.log(`${total} workflows found`);
+   *
+   * // Search across all skill types
+   * const result = await client.tools.skills({ search: "onboarding", limit: 10 });
+   * ```
+   */
+  async skills(params) {
+    return this.http.request("GET", "/tools/skills", {
+      query: params
+    });
+  }
+  /**
+   * Test-execute a configured agent tool with sample input.
+   *
+   * This runs the tool using its saved configuration (action, credentials,
+   * parameter setup) and returns the execution result. Use this to verify a
+   * tool is correctly configured before deploying the agent.
+   *
+   * @param agentId - Agent UUID that owns the tool config.
+   * @param toolConfigId - Agent tool configuration UUID (from `client.agents.tools.list()`).
+   * @param body - Sample input values to pass to the tool.
+   * @returns Execution result with status, output, and timing.
+   *
+   * @example
+   * ```ts
+   * const result = await client.tools.test("agent-uuid", "tool-config-uuid", {
+   *   input: { to: "test@example.com", subject: "Hello", body: "Test email" }
+   * });
+   * if (result.status === "success") {
+   *   console.log(`Executed in ${result.executionTimeMs}ms`, result.output);
+   * } else {
+   *   console.error(`Tool error: ${result.error}`);
+   * }
+   * ```
+   */
+  async test(agentId, toolConfigId, body) {
+    return this.http.request(
+      "POST",
+      `/agents/${agentId}/tools/${toolConfigId}/test`,
+      { body }
+    );
+  }
+};
+var WorkflowExecutionsResource = class extends BaseResource {
+  async list(params) {
+    const { data, meta } = await this.http.requestWithMeta("GET", "/workflows/executions", {
+      query: params
+    });
+    return { data, meta };
+  }
+  async listByWorkflow(workflowId, params) {
+    const { data, meta } = await this.http.requestWithMeta(
+      "GET",
+      `/workflows/${workflowId}/executions`,
+      {
+        query: params
+      }
+    );
+    return { data, meta };
+  }
+  async get(executionId) {
+    return this.http.request("GET", `/workflows/executions/${executionId}`);
+  }
+  async getGraph(executionId) {
+    return this.http.request("GET", `/workflows/executions/${executionId}/graph`);
+  }
+  async getNodeResult(executionId, nodeId) {
+    return this.http.request("GET", `/workflows/executions/${executionId}/nodes/${nodeId}`);
+  }
+  async getOutput(executionId) {
+    return this.http.request("GET", `/workflows/executions/${executionId}/output`);
+  }
+  async retryNode(executionId, nodeId) {
+    return this.http.request(
+      "POST",
+      `/workflows/executions/${executionId}/nodes/${nodeId}/retry`
+    );
+  }
+  async export(executionId) {
+    return this.http.request("POST", `/workflows/executions/${executionId}/export`);
+  }
+};
+var WorkflowsResource = class extends BaseResource {
+  // =========================================================================
+  // CRUD
+  // =========================================================================
+  /**
+   * List workflows with optional filtering and pagination.
+   *
+   * @param params - Optional status filter, search, and pagination.
+   * @returns Paginated list of workflow summaries.
+   */
+  async list(params) {
+    const { data, meta } = await this.http.requestWithMeta("GET", "/workflows", {
+      query: params
+    });
+    return { data, meta };
+  }
+  /**
+   * Create a new workflow.
+   *
+   * @param body - Workflow name and optional description.
+   * @returns The created workflow detail.
+   */
+  async create(body) {
+    return this.http.request("POST", "/workflows", { body });
+  }
+  /**
+   * Get detailed information about a specific workflow, including nodes and edges.
+   *
+   * @param workflowId - Workflow UUID.
+   * @returns Full workflow detail.
+   */
+  async get(workflowId) {
+    return this.http.request("GET", `/workflows/${workflowId}`);
+  }
+  /**
+   * Update an existing workflow's properties. Only provided fields are updated.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param body - Fields to update.
+   * @returns The updated workflow detail.
+   */
+  async update(workflowId, body) {
+    return this.http.request("PATCH", `/workflows/${workflowId}`, { body });
+  }
+  /**
+   * Permanently delete a workflow and all its nodes, edges, and executions.
+   *
+   * @param workflowId - Workflow UUID.
+   * @returns Confirmation with the deleted workflow's ID.
+   */
+  async delete(workflowId) {
+    return this.http.request("DELETE", `/workflows/${workflowId}`);
+  }
+  /**
+   * Create a copy of an existing workflow.
+   *
+   * @param workflowId - Workflow UUID to duplicate.
+   * @returns The newly created workflow detail.
+   */
+  async duplicate(workflowId) {
+    return this.http.request("POST", `/workflows/${workflowId}/duplicate`);
+  }
+  /**
+   * Publish a workflow, making it available for execution.
+   *
+   * @param workflowId - Workflow UUID.
+   * @returns Publish confirmation with updated status.
+   */
+  async publish(workflowId) {
+    return this.http.request("POST", `/workflows/${workflowId}/publish`);
+  }
+  /**
+   * Unpublish a workflow, reverting it to draft status.
+   *
+   * @param workflowId - Workflow UUID.
+   * @returns Unpublish confirmation with updated status.
+   */
+  async unpublish(workflowId) {
+    return this.http.request("POST", `/workflows/${workflowId}/unpublish`);
+  }
+  /**
+   * Upload an icon image for a workflow.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param file - Image file as a Blob or File.
+   * @returns URL of the uploaded icon.
+   */
+  async uploadIcon(workflowId, file) {
+    const formData = new FormData();
+    formData.append("file", file);
+    return this.http.request("POST", `/workflows/${workflowId}/icon`, {
+      body: formData
+    });
+  }
+  // =========================================================================
+  // BUILDER (Node Types)
+  // =========================================================================
+  /**
+   * List all available node types for the workflow builder.
+   *
+   * @returns Array of node type summaries.
+   */
+  async listNodeTypes() {
+    return this.http.request("GET", "/workflows/node-types");
+  }
+  /**
+   * Get the full schema for a specific node type, including fields and connection rules.
+   *
+   * @param nodeType - Node type identifier.
+   * @returns Node type schema with fields, configuration steps, and defaults.
+   */
+  async getNodeTypeSchema(nodeType) {
+    return this.http.request("GET", `/workflows/node-types/${nodeType}`);
+  }
+  // =========================================================================
+  // NODES
+  // =========================================================================
+  /**
+   * Create a new node in a workflow.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param body - Node type, position, data, and optional parent.
+   * @returns The created node.
+   */
+  async createNode(workflowId, body) {
+    return this.http.request("POST", `/workflows/${workflowId}/nodes`, { body });
+  }
+  /**
+   * Get a specific node within a workflow.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @returns The node detail.
+   */
+  async getNode(workflowId, nodeId) {
+    return this.http.request("GET", `/workflows/${workflowId}/nodes/${nodeId}`);
+  }
+  /**
+   * Update a node's data. Only the `data` field is replaced.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @param body - New data for the node.
+   * @returns The updated node.
+   */
+  async updateNode(workflowId, nodeId, body) {
+    return this.http.request("PATCH", `/workflows/${workflowId}/nodes/${nodeId}`, {
+      body
+    });
+  }
+  /**
+   * Delete a node from a workflow. Connected edges are also removed.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @returns Confirmation with the deleted node's ID.
+   */
+  async deleteNode(workflowId, nodeId) {
+    return this.http.request("DELETE", `/workflows/${workflowId}/nodes/${nodeId}`);
+  }
+  /**
+   * Reload dynamic properties for a node (e.g. after selecting a tool or action).
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @param body - Currently configured props and optional dynamic props ID.
+   * @returns Updated parameters setup and any errors.
+   */
+  async reloadProps(workflowId, nodeId, body) {
+    return this.http.request(
+      "POST",
+      `/workflows/${workflowId}/nodes/${nodeId}/reload-props`,
+      { body }
+    );
+  }
+  /**
+   * Replace the trigger node of a workflow with a different trigger type.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param body - New trigger type.
+   * @returns The updated workflow detail.
+   */
+  async replaceTrigger(workflowId, body) {
+    return this.http.request("PUT", `/workflows/${workflowId}/trigger`, { body });
+  }
+  // =========================================================================
+  // BRANCHES
+  // =========================================================================
+  /**
+   * List branches on a conditional or router node.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @returns Array of branches.
+   */
+  async listBranches(workflowId, nodeId) {
+    return this.http.request("GET", `/workflows/${workflowId}/nodes/${nodeId}/branches`);
+  }
+  /**
+   * Create a new branch on a conditional or router node.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @param body - Branch name and optional description.
+   * @returns The created branch.
+   */
+  async createBranch(workflowId, nodeId, body) {
+    return this.http.request("POST", `/workflows/${workflowId}/nodes/${nodeId}/branches`, {
+      body
+    });
+  }
+  /**
+   * Update a branch on a node.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @param branchId - Branch UUID.
+   * @param body - Fields to update.
+   * @returns The updated branch.
+   */
+  async updateBranch(workflowId, nodeId, branchId, body) {
+    return this.http.request(
+      "PATCH",
+      `/workflows/${workflowId}/nodes/${nodeId}/branches/${branchId}`,
+      { body }
+    );
+  }
+  /**
+   * Delete a branch from a node.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @param branchId - Branch UUID.
+   * @returns Confirmation with the deleted branch's ID.
+   */
+  async deleteBranch(workflowId, nodeId, branchId) {
+    return this.http.request(
+      "DELETE",
+      `/workflows/${workflowId}/nodes/${nodeId}/branches/${branchId}`
+    );
+  }
+  // =========================================================================
+  // EDGES
+  // =========================================================================
+  /**
+   * Create an edge between two nodes in a workflow.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param body - Source node, target node, optional handle and type.
+   * @returns The created edge.
+   */
+  async createEdge(workflowId, body) {
+    return this.http.request("POST", `/workflows/${workflowId}/edges`, { body });
+  }
+  /**
+   * Delete an edge from a workflow.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param edgeId - Edge UUID.
+   * @returns Confirmation with the deleted edge's ID.
+   */
+  async deleteEdge(workflowId, edgeId) {
+    return this.http.request("DELETE", `/workflows/${workflowId}/edges/${edgeId}`);
+  }
+  // =========================================================================
+  // OVERVIEW
+  // =========================================================================
+  /**
+   * Get a high-level overview of a workflow with node summaries.
+   *
+   * @param workflowId - Workflow UUID.
+   * @returns Workflow overview with node labels and config statuses.
+   */
+  async getOverview(workflowId) {
+    return this.http.request("GET", `/workflows/${workflowId}/overview`);
+  }
+  /**
+   * Auto-layout the nodes in a workflow graph.
+   *
+   * @param workflowId - Workflow UUID.
+   * @returns The updated workflow detail with new node positions.
+   */
+  async layout(workflowId) {
+    return this.http.request("POST", `/workflows/${workflowId}/layout`);
+  }
+  /**
+   * Get variables available to a specific node from upstream nodes.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @returns Array of available variables grouped by source node.
+   */
+  async getAvailableVariables(workflowId, nodeId) {
+    return this.http.request(
+      "GET",
+      `/workflows/${workflowId}/nodes/${nodeId}/available-variables`
+    );
+  }
+  /**
+   * Get the output format definition for a specific node.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @returns Output format with source indicator.
+   */
+  async getOutputFormat(workflowId, nodeId) {
+    return this.http.request(
+      "GET",
+      `/workflows/${workflowId}/nodes/${nodeId}/output-format`
+    );
+  }
+  /**
+   * Validate a workflow for completeness and correctness.
+   *
+   * @param workflowId - Workflow UUID.
+   * @returns Validation report with node issues and graph issues.
+   */
+  async validate(workflowId) {
+    return this.http.request("GET", `/workflows/${workflowId}/validate`);
+  }
+  // =========================================================================
+  // TESTING
+  // =========================================================================
+  /**
+   * Test-execute a single node with optional input.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param nodeId - Node UUID.
+   * @param body - Optional input data for the node.
+   * @returns Execution ID for polling status.
+   */
+  async testNode(workflowId, nodeId, body) {
+    return this.http.request("POST", `/workflows/${workflowId}/nodes/${nodeId}/test`, {
+      body
+    });
+  }
+  /**
+   * Test-execute an entire workflow with optional trigger data.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param body - Optional trigger data to start the workflow.
+   * @returns Execution ID for polling status.
+   */
+  async testWorkflow(workflowId, body) {
+    return this.http.request("POST", `/workflows/${workflowId}/test`, { body });
+  }
+  /**
+   * Get the status of a workflow execution.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param executionId - Execution UUID.
+   * @returns Execution status with per-node statuses.
+   */
+  async getExecutionStatus(workflowId, executionId) {
+    return this.http.request(
+      "GET",
+      `/workflows/${workflowId}/executions/${executionId}`
+    );
+  }
+  /**
+   * Get the execution result for a specific node within a workflow execution.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param executionId - Execution UUID.
+   * @param nodeId - Node UUID.
+   * @returns Node execution result with input, output, and logs.
+   */
+  async getNodeExecutionResult(workflowId, executionId, nodeId) {
+    return this.http.request(
+      "GET",
+      `/workflows/${workflowId}/executions/${executionId}/nodes/${nodeId}`
+    );
+  }
+  /**
+   * Stop a running workflow execution.
+   *
+   * @param workflowId - Workflow UUID.
+   * @param executionId - Execution UUID.
+   * @returns Updated execution status.
+   */
+  async stopExecution(workflowId, executionId) {
+    return this.http.request(
+      "POST",
+      `/workflows/${workflowId}/executions/${executionId}/stop`
+    );
+  }
+};
+function getEnv(key) {
+  try {
+    return typeof process !== "undefined" ? process.env[key] : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var NexusClient = class {
+  constructor(opts = {}) {
+    const apiKey = opts.apiKey ?? getEnv("NEXUS_API_KEY");
+    if (!apiKey) {
+      throw new NexusError(
+        "No API key provided. Pass `apiKey` in options or set the NEXUS_API_KEY environment variable."
+      );
+    }
+    const baseUrl = opts.baseUrl ?? getEnv("NEXUS_BASE_URL") ?? "https://api.nexusgpt.io";
+    const http = new HttpClient({
+      baseUrl,
+      apiKey,
+      fetch: opts.fetch,
+      defaultHeaders: opts.defaultHeaders,
+      timeout: opts.timeout
+    });
+    this.agents = new AgentsResource(http);
+    this.documents = new DocumentsResource(http);
+    this.folders = new FoldersResource(http);
+    this.me = new MeResource(http);
+    this.models = new ModelsResource(http);
+    this.customModels = new CustomModelsResource(http);
+    this.tools = new ToolDiscoveryResource(http);
+    this.skills = new SkillsResource(http);
+    this.workflows = new WorkflowsResource(http);
+    this.toolConnection = new ToolConnectionResource(http);
+    this.deployments = new DeploymentsResource(http);
+    this.emulator = new EmulatorResource(http);
+    this.deploymentFolders = new DeploymentFoldersResource(http);
+    this.documentTemplateFolders = new DocumentTemplateFoldersResource(http);
+    this.analytics = new AnalyticsResource(http);
+    this.agentCollections = new AgentCollectionsResource(http);
+    this.workflowExecutions = new WorkflowExecutionsResource(http);
+    this.evaluations = new EvaluationsResource(http);
+    this.cloudImports = new CloudImportsResource(http);
+    this.promptAssistant = new PromptAssistantResource(http);
+    this.phoneNumbers = new PhoneNumbersResource(http);
+    this.tickets = new TicketsResource(http);
+    this.channels = new ChannelsResource(http);
+  }
+};
 
 // src/config.ts
 var import_node_fs = __toESM(require("fs"));
@@ -447,24 +2663,23 @@ var _lastResolved = null;
 function createClient(opts) {
   const resolved = resolveProfile(opts);
   _lastResolved = resolved;
-  return new import_sdk.NexusClient({
+  return new NexusClient({
     apiKey: resolved.profile.apiKey,
     baseUrl: resolved.profile.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) {
+  if (err instanceof 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 instanceof NexusApiError) {
     if (err.status === 404) {
       printCliError(
         `Not found: ${err.message}`,
@@ -480,14 +2695,14 @@ function handleError(err) {
     }
     return 1;
   }
-  if (err instanceof import_sdk2.NexusConnectionError) {
+  if (err instanceof NexusConnectionError) {
     printCliError(
       "Could not reach the Nexus API.",
       "Check your network connection and base URL configuration."
     );
     return 1;
   }
-  if (err instanceof import_sdk2.NexusError) {
+  if (err instanceof NexusError) {
     printCliError(err.message);
     return 1;
   }
@@ -987,7 +3202,6 @@ Notes:
 }
 
 // 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(
@@ -1002,7 +3216,7 @@ Examples:
   ).action(async (method, path5, opts) => {
     try {
       const globals = program2.optsWithGlobals();
-      const http = new import_sdk3.HttpClient({
+      const http = new HttpClient({
         baseUrl: resolveBaseUrl(globals.baseUrl),
         apiKey: resolveApiKey(globals.apiKey)
       });
@@ -1295,63 +3509,224 @@ Notes:
   Use "nexus auth pin <profile>" to pin a directory to a profile via .nexusrc.`
   ).action(() => {
     try {
-      const resolved = resolveProfile(program2.optsWithGlobals());
-      const sourceExplanation = {
-        flag: "--profile flag",
-        env: "NEXUS_PROFILE environment variable",
-        directory: `.nexusrc at ${resolved.rcPath}`,
-        active: "active profile in config",
-        default: 'fallback to "default" profile',
-        override: "--api-key flag or NEXUS_API_KEY env"
-      };
-      const orgPart = resolved.profile.orgName ? ` (${resolved.profile.orgName})` : "";
-      console.log(
-        `Using profile ${color.cyan(`"${resolved.name}"`)}${orgPart} \u2014 ${color.dim(sourceExplanation[resolved.source])}`
-      );
-      console.log(
-        `  ${color.dim("key:")} ${resolved.profile.apiKey.slice(0, 8)}...${resolved.profile.apiKey.slice(-4)}`
-      );
-      console.log(`  ${color.dim("api:")} ${resolved.profile.baseUrl ?? resolveBaseUrl()}`);
+      const resolved = resolveProfile(program2.optsWithGlobals());
+      const sourceExplanation = {
+        flag: "--profile flag",
+        env: "NEXUS_PROFILE environment variable",
+        directory: `.nexusrc at ${resolved.rcPath}`,
+        active: "active profile in config",
+        default: 'fallback to "default" profile',
+        override: "--api-key flag or NEXUS_API_KEY env"
+      };
+      const orgPart = resolved.profile.orgName ? ` (${resolved.profile.orgName})` : "";
+      console.log(
+        `Using profile ${color.cyan(`"${resolved.name}"`)}${orgPart} \u2014 ${color.dim(sourceExplanation[resolved.source])}`
+      );
+      console.log(
+        `  ${color.dim("key:")} ${resolved.profile.apiKey.slice(0, 8)}...${resolved.profile.apiKey.slice(-4)}`
+      );
+      console.log(`  ${color.dim("api:")} ${resolved.profile.baseUrl ?? resolveBaseUrl()}`);
+    } catch (err) {
+      console.error(color.red("Error:") + " " + err.message);
+      process.exitCode = 1;
+    }
+  });
+  auth.command("whoami").description("Show current authentication status").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus auth whoami`
+  ).action(async () => {
+    try {
+      const resolved = resolveProfile(program2.optsWithGlobals());
+      const baseUrl = resolved.profile.baseUrl ?? resolveBaseUrl();
+      const res = await fetch(`${baseUrl}/api/public/v1/agents?limit=1`, {
+        headers: { "api-key": resolved.profile.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.", {
+        profile: resolved.name,
+        ...resolved.profile.orgName ? { organization: resolved.profile.orgName } : {},
+        api: baseUrl,
+        key: resolved.profile.apiKey.slice(0, 8) + "..." + resolved.profile.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/channel.ts
+var import_node_child_process2 = require("child_process");
+init_output();
+function openUrl2(url) {
+  const platform = process.platform;
+  const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  (0, import_node_child_process2.exec)(`${cmd} ${JSON.stringify(url)}`);
+}
+function registerChannelCommands(program2) {
+  const channel = program2.command("channel").description("Set up deployment channels: connections, phone numbers, WhatsApp senders");
+  channel.command("setup").description("Check or auto-provision channel setup prerequisites").requiredOption("--type <type>", "Deployment type (WHATSAPP, TWILIO_SMS, TWILIO_VOICE, EMBED, etc.)").option("--auto", "Auto-provision what is possible (e.g., create messaging connection)").option("--region <region>", "Region for auto-provisioning (us1 or ie1)", "us1").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus channel setup --type WHATSAPP
+  $ nexus channel setup --type WHATSAPP --auto
+  $ nexus channel setup --type TWILIO_SMS --json`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      let result;
+      if (opts.auto) {
+        result = await client.channels.autoProvision({
+          type: opts.type,
+          region: opts.region
+        });
+      } else {
+        result = await client.channels.getSetupStatus(opts.type);
+      }
+      const data = result?.data ?? result;
+      printTable(data.steps, [
+        { key: "step", label: "#", width: 3 },
+        { key: "label", label: "STEP", width: 25 },
+        { key: "status", label: "STATUS", width: 16 },
+        { key: "description", label: "DESCRIPTION", width: 45 }
+      ]);
+      if (data.ready) {
+        printSuccess("All prerequisites met. Ready to create deployment.");
+      }
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  channel.command("connect-waba").description("Open browser to connect your WhatsApp Business Account (Meta signup)").addHelpText(
+    "after",
+    `
+This step requires a browser \u2014 it cannot be done via API.
+Opens the Nexus dashboard where you can click "Connect with Meta"
+to link your WhatsApp Business Account.
+
+Examples:
+  $ nexus channel connect-waba`
+  ).action(async () => {
+    try {
+      const dashboardUrl = process.env.NEXUS_DASHBOARD_URL ?? "https://gpt.nexus";
+      const url = `${dashboardUrl}/app/settings/phone-number`;
+      console.log(`Opening ${color.cyan(url)} ...`);
+      console.log("");
+      console.log('Complete the "Connect with Meta" flow in your browser, then verify:');
+      console.log(`  ${color.dim("nexus channel setup --type WHATSAPP")}`);
+      openUrl2(url);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  const connection = channel.command("connection").description("Manage messaging connections");
+  connection.command("list").description("List messaging connections").action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.listConnections();
+      const data = result?.data ?? result;
+      printTable(Array.isArray(data) ? data : [data], [
+        { key: "id", label: "ID", width: 38 },
+        { key: "name", label: "NAME", width: 20 },
+        { key: "region", label: "REGION", width: 8 },
+        { key: "status", label: "STATUS", width: 12 }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  connection.command("create").description("Create a messaging connection (max 1 per organization)").option("--region <region>", "Region: us1 or ie1", "us1").action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.createConnection({ region: opts.region });
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "id", label: "ID" },
+        { key: "name", label: "Name" },
+        { key: "accountSid", label: "Account SID" },
+        { key: "region", label: "Region" },
+        { key: "status", label: "Status" }
+      ]);
+      printSuccess("Messaging connection created.");
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  const waSender = channel.command("whatsapp-sender").description("Manage WhatsApp senders");
+  waSender.command("list").description("List WhatsApp senders").action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.listWhatsAppSenders();
+      const data = result?.data ?? result;
+      printTable(Array.isArray(data) ? data : [data], [
+        { key: "id", label: "ID", width: 38 },
+        { key: "name", label: "NAME", width: 20 },
+        { key: "status", label: "STATUS", width: 10 },
+        { key: "phoneNumberId", label: "PHONE NUMBER ID", width: 38 }
+      ]);
     } catch (err) {
-      console.error(color.red("Error:") + " " + err.message);
-      process.exitCode = 1;
+      process.exitCode = handleError(err);
     }
   });
-  auth.command("whoami").description("Show current authentication status").addHelpText(
+  waSender.command("create").description("Create a WhatsApp sender (registers phone with WhatsApp Business)").requiredOption("--connection-id <id>", "Messaging connection ID").requiredOption("--phone-number-id <id>", "Phone number ID").requiredOption("--sender-name <name>", "Display name for the WhatsApp sender").option("--waba-id <id>", "WhatsApp Business Account ID (reads from connection if omitted)").addHelpText(
     "after",
     `
 Examples:
-  $ nexus auth whoami`
-  ).action(async () => {
+  $ nexus channel whatsapp-sender create --connection-id abc --phone-number-id def --sender-name "My Business"
+  $ nexus channel whatsapp-sender create --connection-id abc --phone-number-id def --sender-name "EU Support" --json`
+  ).action(async (opts) => {
     try {
-      const resolved = resolveProfile(program2.optsWithGlobals());
-      const baseUrl = resolved.profile.baseUrl ?? resolveBaseUrl();
-      const res = await fetch(`${baseUrl}/api/public/v1/agents?limit=1`, {
-        headers: { "api-key": resolved.profile.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.", {
-        profile: resolved.name,
-        ...resolved.profile.orgName ? { organization: resolved.profile.orgName } : {},
-        api: baseUrl,
-        key: resolved.profile.apiKey.slice(0, 8) + "..." + resolved.profile.apiKey.slice(-4)
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.createWhatsAppSender({
+        connectionId: opts.connectionId,
+        phoneNumberId: opts.phoneNumberId,
+        senderName: opts.senderName,
+        wabaId: opts.wabaId
       });
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "id", label: "ID" },
+        { key: "senderId", label: "Sender ID" },
+        { key: "name", label: "Name" },
+        { key: "wabaId", label: "WABA ID" },
+        { key: "phoneNumberId", label: "Phone Number ID" }
+      ]);
+      printSuccess("WhatsApp sender created. Status may be OFFLINE while Meta approves.");
     } catch (err) {
-      console.error(color.red("Error:") + " Not logged in. Run: nexus auth login");
-      process.exitCode = 1;
+      process.exitCode = handleError(err);
+    }
+  });
+  waSender.command("get").description("Get WhatsApp sender details").argument("<id>", "Sender ID").action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.channels.getWhatsAppSender(id);
+      const data = result?.data ?? result;
+      printRecord(data, [
+        { key: "id", label: "ID" },
+        { key: "senderId", label: "Sender ID" },
+        { key: "name", label: "Name" },
+        { key: "status", label: "Status" },
+        { key: "wabaId", label: "WABA ID" },
+        { key: "phoneNumberId", label: "Phone Number ID" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
     }
   });
-}
-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
@@ -1588,6 +3963,145 @@ Examples:
   });
 }
 
+// src/commands/custom-model.ts
+init_output();
+function registerCustomModelCommands(program2) {
+  const customModel = program2.command("custom-model").description("Manage custom AI models with OpenAI-compatible endpoints");
+  customModel.command("list").description("List custom models").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus custom-model list
+  $ nexus custom-model list --json`
+  ).action(async () => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const result = await client.customModels.list();
+      const items = Array.isArray(result) ? result : result.data ?? result;
+      printList(items, void 0, [
+        { key: "id", label: "ID", width: 36 },
+        { key: "displayName", label: "NAME", width: 25 },
+        { key: "modelName", label: "MODEL", width: 25 },
+        { key: "protocol", label: "PROTOCOL", width: 10 },
+        {
+          key: "enabled",
+          label: "ENABLED",
+          width: 8,
+          format: (v) => v ? "yes" : "no"
+        }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  customModel.command("get").description("Get custom model details").argument("<id>", "Custom model ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus custom-model get cm-123
+  $ nexus custom-model get cm-123 --json`
+  ).action(async (id) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const model = await client.customModels.get(id);
+      printRecord(model, [
+        { key: "id", label: "ID" },
+        { key: "displayName", label: "Display Name" },
+        { key: "modelName", label: "Model Name" },
+        { key: "baseUrl", label: "Base URL" },
+        { key: "protocol", label: "Protocol" },
+        { key: "enabled", label: "Enabled", format: (v) => v ? "yes" : "no" },
+        { key: "createdAt", label: "Created" },
+        { key: "updatedAt", label: "Updated" }
+      ]);
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  customModel.command("create").description("Create a custom model").requiredOption("--display-name <name>", "Human-readable display name").requiredOption("--model-name <name>", "API model ID (e.g. llama-3-70b)").requiredOption("--base-url <url>", "OpenAI-compatible API base URL (HTTPS)").requiredOption("--api-key <key>", "API key for the custom endpoint").option("--protocol <protocol>", "Inference protocol (default: openai)", "openai").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus custom-model create --display-name "My LLaMA" --model-name llama-3-70b \\
+      --base-url https://api.example.com/v1 --api-key sk-xxx
+  $ nexus custom-model create --body '{"displayName":"My Model","modelName":"gpt-4","baseUrl":"https://api.example.com/v1","apiKey":"sk-xxx"}'`
+  ).action(async (opts) => {
+    try {
+      const client = createClient(program2.optsWithGlobals());
+      const base = await resolveBody(opts.body);
+      const body = mergeBodyWithFlags(base, {
+        ...opts.displayName !== void 0 && { displayName: opts.displayName },
+        ...opts.modelName !== void 0 && { modelName: opts.modelName },
+        ...opts.baseUrl !== void 0 && { baseUrl: opts.baseUrl },
+        ...opts.apiKey !== void 0 && { apiKey: opts.apiKey },
+        ...opts.protocol !== void 0 && { protocol: opts.protocol }
+      });
+      const model = await client.customModels.create(body);
+      printSuccess("Custom model created.", {
+        id: model.id,
+        displayName: model.displayName
+      });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  customModel.command("update").description("Update a custom model").argument("<id>", "Custom model ID").option("--display-name <name>", "Display name").option("--model-name <name>", "API model ID").option("--base-url <url>", "API base URL").option("--api-key <key>", "API key").option("--protocol <protocol>", "Inference protocol").option("--enabled <bool>", "Enable/disable (true/false)").option("--body <json>", "Request body as JSON, .json file, or '-' for stdin").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus custom-model update cm-123 --display-name "Renamed Model"
+  $ nexus custom-model update cm-123 --enabled false
+  $ nexus custom-model update cm-123 --api-key sk-newkey`
+  ).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.modelName !== void 0) flags.modelName = opts.modelName;
+      if (opts.baseUrl !== void 0) flags.baseUrl = opts.baseUrl;
+      if (opts.apiKey !== void 0) flags.apiKey = opts.apiKey;
+      if (opts.protocol !== void 0) flags.protocol = opts.protocol;
+      if (opts.enabled !== void 0) flags.enabled = opts.enabled === "true";
+      const body = mergeBodyWithFlags(base, flags);
+      await client.customModels.update(id, body);
+      printSuccess("Custom model updated.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+  customModel.command("delete").description("Delete a custom model").argument("<id>", "Custom model ID").option("--yes", "Skip confirmation").addHelpText(
+    "after",
+    `
+Examples:
+  $ nexus custom-model delete cm-123
+  $ nexus custom-model delete cm-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 custom model ${id}? This cannot be undone. [y/N] `
+        );
+        rl.close();
+        if (answer.toLowerCase() !== "y") {
+          console.log("Aborted.");
+          return;
+        }
+      }
+      await client.customModels.delete(id);
+      printSuccess("Custom model deleted.", { id });
+    } catch (err) {
+      process.exitCode = handleError(err);
+    }
+  });
+}
+
 // src/commands/deployment.ts
 init_output();
 function registerDeploymentCommands(program2) {
@@ -2101,14 +4615,14 @@ nexus auth status
 
 When determining which profile to use, the CLI checks (first match wins):
 
-| Priority | Source | Example |
-|----------|--------|---------|
-| 1 | \`--api-key\` flag or \`NEXUS_API_KEY\` env | Bypasses profiles entirely |
-| 2 | \`--profile\` flag | \`nexus agent list --profile work\` |
-| 3 | \`NEXUS_PROFILE\` env var | \`export NEXUS_PROFILE=work\` |
-| 4 | \`.nexusrc\` file | Walks up directory tree to find \`.nexusrc\` |
-| 5 | Active profile | Set by \`nexus auth switch\` |
-| 6 | \`"default"\` profile | Fallback |
+| Priority | Source                                  | Example                                    |
+| -------- | --------------------------------------- | ------------------------------------------ |
+| 1        | \`--api-key\` flag or \`NEXUS_API_KEY\` env | Bypasses profiles entirely                 |
+| 2        | \`--profile\` flag                        | \`nexus agent list --profile work\`          |
+| 3        | \`NEXUS_PROFILE\` env var                 | \`export NEXUS_PROFILE=work\`                |
+| 4        | \`.nexusrc\` file                         | Walks up directory tree to find \`.nexusrc\` |
+| 5        | Active profile                          | Set by \`nexus auth switch\`                 |
+| 6        | \`"default"\` profile                     | Fallback                                   |
 
 #### Remove profiles
 
@@ -2178,13 +4692,13 @@ These flags are available on every command:
 
 | Flag               | Description                                       |
 | ------------------ | ------------------------------------------------- |
-| \`--json\`             | Output results as JSON (for scripting and piping) |
-| \`--api-key <key>\`    | Override the API key for this invocation          |
-| \`--base-url <url>\`   | Override the API base URL                         |
-| \`--profile <name>\`   | Use a specific named profile                      |
-| \`--no-auto-update\`   | Disable automatic CLI updates for this invocation |
-| \`-v, --version\`      | Print the CLI version and exit                    |
-| \`--help\`             | Show help for any command or subcommand           |
+| \`--json\`           | Output results as JSON (for scripting and piping) |
+| \`--api-key <key>\`  | Override the API key for this invocation          |
+| \`--base-url <url>\` | Override the API base URL                         |
+| \`--profile <name>\` | Use a specific named profile                      |
+| \`--no-auto-update\` | Disable automatic CLI updates for this invocation |
+| \`-v, --version\`    | Print the CLI version and exit                    |
+| \`--help\`           | Show help for any command or subcommand           |
 
 ### Environment Variables
 
@@ -2333,14 +4847,14 @@ All commands follow the pattern: \`nexus <group> <action> [arguments] [options]\
 
 ### Core Platform
 
-| Command                                                    | Subcommands                                                 | Description               |
-| ---------------------------------------------------------- | ----------------------------------------------------------- | ------------------------- |
+| Command                                                    | Subcommands                                                      | Description               |
+| ---------------------------------------------------------- | ---------------------------------------------------------------- | ------------------------- |
 | [\`auth\`](docs/command-reference.md#nexus-auth)             | \`login\` \`logout\` \`switch\` \`list\` \`pin\` \`unpin\` \`status\` \`whoami\` | Authentication            |
-| [\`agent\`](docs/command-reference.md#nexus-agent)           | \`list\` \`get\` \`create\` \`update\` \`delete\` \`duplicate\`         | AI agent management       |
-| [\`agent-tool\`](docs/command-reference.md#nexus-agent-tool) | \`list\` \`get\` \`create\` \`update\` \`delete\`                     | Agent tool configurations |
-| [\`version\`](docs/command-reference.md#nexus-version)       | \`list\` \`get\` \`create\` \`update\` \`delete\` \`restore\` \`publish\` | Prompt version management |
-| [\`folder\`](docs/command-reference.md#nexus-folder)         | \`list\` \`create\` \`update\` \`delete\` \`assign\`                  | Agent folder organization |
-| [\`model\`](docs/command-reference.md#nexus-model)           | \`list\`                                                      | Available AI models       |
+| [\`agent\`](docs/command-reference.md#nexus-agent)           | \`list\` \`get\` \`create\` \`update\` \`delete\` \`duplicate\`              | AI agent management       |
+| [\`agent-tool\`](docs/command-reference.md#nexus-agent-tool) | \`list\` \`get\` \`create\` \`update\` \`delete\`                          | Agent tool configurations |
+| [\`version\`](docs/command-reference.md#nexus-version)       | \`list\` \`get\` \`create\` \`update\` \`delete\` \`restore\` \`publish\`      | Prompt version management |
+| [\`folder\`](docs/command-reference.md#nexus-folder)         | \`list\` \`create\` \`update\` \`delete\` \`assign\`                       | Agent folder organization |
+| [\`model\`](docs/command-reference.md#nexus-model)           | \`list\`                                                           | Available AI models       |
 
 ### Workflows & Execution
 
@@ -2391,15 +4905,16 @@ All commands follow the pattern: \`nexus <group> <action> [arguments] [options]\
 | [\`eval\`](docs/command-reference.md#nexus-eval)                         | (subgroups: \`session\`, \`dataset\`, \`execute\`, \`judge\`, \`results\`, \`formats\`, \`judges\`) | AI task evaluation         |
 | [\`ticket\`](docs/command-reference.md#nexus-ticket)                     | \`list\` \`get\` \`create\` \`update\` \`comment\` \`comments\`                                   | Bug and feature tracking   |
 | [\`phone-number\`](docs/command-reference.md#nexus-phone-number)         | \`search\` \`buy\` \`list\` \`get\` \`release\`                                                 | Phone number management    |
+| [\`channel\`](docs/command-reference.md#nexus-channel)                   | \`setup\` \`connection list\\|create\` \`whatsapp-sender list\\|create\\|get\`                  | Channel setup orchestrator |
 | [\`prompt-assistant\`](docs/command-reference.md#nexus-prompt-assistant) | \`chat\` \`get-thread\` \`delete-thread\`                                                   | AI-assisted prompt writing |
 
 ### Utility
 
-| Command                                              | Subcommands   | Description                    |
-| ---------------------------------------------------- | ------------- | ------------------------------ |
-| [\`api\`](docs/command-reference.md#nexus-api)         | (passthrough)  | Call any API endpoint directly |
+| Command                                              | Subcommands     | Description                    |
+| ---------------------------------------------------- | --------------- | ------------------------------ |
+| [\`api\`](docs/command-reference.md#nexus-api)         | (passthrough)   | Call any API endpoint directly |
 | [\`docs\`](docs/command-reference.md#nexus-docs)       | (topic browser) | View built-in documentation    |
-| [\`upgrade\`](docs/command-reference.md#nexus-upgrade) | (self-update)  | Upgrade the CLI to latest      |
+| [\`upgrade\`](docs/command-reference.md#nexus-upgrade) | (self-update)   | Upgrade the CLI to latest      |
 
 > **Full reference:** See [docs/command-reference.md](docs/command-reference.md) for complete documentation of every command, option, and example.
 
@@ -2521,6 +5036,9 @@ Every CLI command maps to an SDK method. Use the SDK (\`@agent-nexus/sdk\`) when
 | \`nexus model list\`                      | \`client.models.list()\`                                |
 | \`nexus ticket create --title X ...\`     | \`client.tickets.create({ title: "X", ... })\`          |
 | \`nexus phone-number list\`               | \`client.phoneNumbers.list()\`                          |
+| \`nexus channel setup --type WHATSAPP\`   | \`client.channels.getSetupStatus("WHATSAPP")\`          |
+| \`nexus channel connection create\`       | \`client.channels.createConnection()\`                  |
+| \`nexus channel whatsapp-sender create\`  | \`client.channels.createWhatsAppSender({ ... })\`       |
 
 > **Full SDK documentation:** See [@agent-nexus/sdk README](../sdk/README.md)
 
@@ -2625,11 +5143,11 @@ sudo npm install -g @agent-nexus/cli@latest
 
 ## Configuration Files
 
-| File | Purpose | Permissions |
-|------|---------|-------------|
-| \`~/.nexus-mcp/config.json\` | Profiles with API keys and base URLs | \`0600\` |
-| \`~/.nexus-mcp/version-check.json\` | Update check cache (auto-managed, checked once/day) | \`0600\` |
-| \`.nexusrc\` | Directory-level profile pinning (created by \`nexus auth pin\`) | \u2014 |
+| File                              | Purpose                                                       | Permissions |
+| --------------------------------- | ------------------------------------------------------------- | ----------- |
+| \`~/.nexus-mcp/config.json\`        | Profiles with API keys and base URLs                          | \`0600\`      |
+| \`~/.nexus-mcp/version-check.json\` | Update check cache (auto-managed, checked once/day)           | \`0600\`      |
+| \`.nexusrc\`                        | Directory-level profile pinning (created by \`nexus auth pin\`) | \u2014           |
 
 The \`~/.nexus-mcp/\` directory is created with \`0700\` permissions. This path is shared with the [\`@nexus/mcp-server\`](../mcp-server/) package.
 
@@ -2698,15 +5216,15 @@ Complete reference for all \`@agent-nexus/cli\` commands. For installation and c
 
 These options are available on every command:
 
-| Option             | Description                                 |
-| ------------------ | ------------------------------------------- |
-| \`--json\`             | Output raw JSON instead of formatted tables   |
-| \`--api-key <key>\`    | Override API key for this invocation          |
-| \`--base-url <url>\`   | Override the API base URL                     |
-| \`--profile <name>\`   | Use a specific named profile                  |
-| \`--no-auto-update\`   | Disable automatic CLI updates for this invocation |
-| \`-v, --version\`      | Print CLI version                             |
-| \`--help\`             | Show help for any command                     |
+| Option             | Description                                       |
+| ------------------ | ------------------------------------------------- |
+| \`--json\`           | Output raw JSON instead of formatted tables       |
+| \`--api-key <key>\`  | Override API key for this invocation              |
+| \`--base-url <url>\` | Override the API base URL                         |
+| \`--profile <name>\` | Use a specific named profile                      |
+| \`--no-auto-update\` | Disable automatic CLI updates for this invocation |
+| \`-v, --version\`    | Print CLI version                                 |
+| \`--help\`           | Show help for any command                         |
 
 ---
 
@@ -2722,11 +5240,11 @@ Authenticate with the Nexus API and create a profile.
 nexus auth login [options]
 \`\`\`
 
-| Option | Description |
-|--------|-------------|
-| \`--api-key <key>\` | API key (skip interactive prompt) |
-| \`--profile <name>\` | Profile name to save as |
-| \`--env <env>\` | Environment: \`dev\` or \`production\` (default: \`production\`) |
+| Option             | Description                                                |
+| ------------------ | ---------------------------------------------------------- |
+| \`--api-key <key>\`  | API key (skip interactive prompt)                          |
+| \`--profile <name>\` | Profile name to save as                                    |
+| \`--env <env>\`      | Environment: \`dev\` or \`production\` (default: \`production\`) |
 
 \`\`\`bash
 nexus auth login
@@ -2743,12 +5261,12 @@ Remove stored credentials.
 nexus auth logout [name] [options]
 \`\`\`
 
-| Argument | Description |
-|----------|-------------|
-| \`name\` | Specific profile to remove (default: active profile) |
+| Argument | Description                                          |
+| -------- | ---------------------------------------------------- |
+| \`name\`   | Specific profile to remove (default: active profile) |
 
-| Option | Description |
-|--------|-------------|
+| Option  | Description         |
+| ------- | ------------------- |
 | \`--all\` | Remove all profiles |
 
 \`\`\`bash
@@ -3418,7 +5936,7 @@ nexus deployment list [options]
 | Option             | Description                                   |
 | ------------------ | --------------------------------------------- |
 | \`--agent-id <id>\`  | Filter by agent ID                            |
-| \`--type <type>\`    | Filter by type (\`CHAT\`, \`API\`, \`PHONE\`, etc.) |
+| \`--type <type>\`    | Filter by type (\`EMBED\`, \`API\`, \`WHATSAPP\`, \`TWILIO_SMS\`, etc.) |
 | \`--page <number>\`  | Page number                                   |
 | \`--limit <number>\` | Items per page                                |
 
@@ -3457,21 +5975,31 @@ Create a new deployment.
 nexus deployment create [options]
 \`\`\`
 
-| Option                 | Required | Description                                          |
-| ---------------------- | -------- | ---------------------------------------------------- |
-| \`--agent-id <id>\`      | Yes      | Agent ID                                             |
-| \`--name <name>\`        | Yes      | Deployment name                                      |
-| \`--type <type>\`        | Yes      | Deployment type (\`CHAT\`, \`API\`, \`PHONE\`, etc.)       |
-| \`--description <text>\` | No       | Deployment description                               |
-| \`--body <json>\`        | No       | Request body as JSON, \`.json\` file, or \`-\` for stdin |
+| Option                 | Required | Description                                                                 |
+| ---------------------- | -------- | --------------------------------------------------------------------------- |
+| \`--name <name>\`        | Yes      | Deployment name                                                             |
+| \`--type <type>\`        | Yes      | Deployment type: \`EMBED\`, \`API\`, \`WHATSAPP\`, \`TWILIO_SMS\`, \`TWILIO_VOICE\`, \`TELEGRAM\`, \`SLACK\`, \`GMAIL\`, \`OUTLOOK\`, \`TEAMS\` |
+| \`--agent-id <id>\`      | No       | Agent ID                                                                    |
+| \`--description <text>\` | No       | Deployment description                                                      |
+| \`--body <json>\`        | No       | Request body as JSON, \`.json\` file, or \`-\` for stdin                        |
+
+**Important:** Channel deployments (WhatsApp, SMS, Voice, etc.) have prerequisites. Run \`nexus channel setup --type <TYPE>\` first to see what's needed.
 
 \`\`\`bash
-nexus deployment create --agent-id agt-123 --name "Website Chat" --type CHAT
-nexus deployment create --agent-id agt-123 --name "Support API" --type API
-nexus deployment create --body '{"agentId":"agt-123","name":"Chat","type":"CHAT"}'
+# Simple deployments (no prerequisites)
+nexus deployment create --name "Website Chat" --type EMBED --agent-id agt-123
+nexus deployment create --name "Support API" --type API --agent-id agt-123
+
+# Channel deployments (require connection + phone + optional sender)
+# First check prerequisites:
+nexus channel setup --type WHATSAPP
+
+# Then create with connection fields via --body:
+nexus deployment create --name "WhatsApp Support" --type WHATSAPP --agent-id agt-123 \\
+  --body '{"phoneNumberId":"phn-456","apiKeyConnectionId":"conn-789"}'
 \`\`\`
 
-**SDK equivalent:** \`client.deployments.create({ agentId, name, type, ... })\`
+**SDK equivalent:** \`client.deployments.create({ name, type, agentId, phoneNumberId, apiKeyConnectionId, ... })\`
 
 ### deployment update
 
@@ -6157,9 +8685,142 @@ nexus model list --search "gpt-4"
 
 ---
 
+## nexus channel
+
+Set up deployment channels: connections, phone numbers, and WhatsApp senders. Use \`nexus channel setup\` to see what's needed before creating any non-EMBED/API deployment.
+
+### channel setup
+
+Check or auto-provision channel setup prerequisites. Returns a step-by-step checklist.
+
+\`\`\`
+nexus channel setup [options]
+\`\`\`
+
+| Option            | Required | Description                                                      |
+| ----------------- | -------- | ---------------------------------------------------------------- |
+| \`--type <type>\`   | Yes      | Deployment type (\`WHATSAPP\`, \`TWILIO_SMS\`, \`TWILIO_VOICE\`, etc.) |
+| \`--auto\`          | No       | Auto-provision what is possible (e.g., create messaging connection) |
+| \`--region <region>\` | No    | Region for auto-provisioning: \`us1\` or \`ie1\` (default: \`us1\`)   |
+
+\`\`\`bash
+nexus channel setup --type WHATSAPP
+nexus channel setup --type WHATSAPP --auto
+nexus channel setup --type TWILIO_SMS --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.getSetupStatus(type)\` / \`client.channels.autoProvision({ type, region })\`
+
+### channel connect-waba
+
+Open the browser to connect your WhatsApp Business Account via Meta's Embedded Signup. This step **requires a browser** and cannot be done via API.
+
+\`\`\`
+nexus channel connect-waba
+\`\`\`
+
+Opens \`{NEXUS_DASHBOARD_URL}/app/settings/phone-number\` in your default browser. Complete the "Connect with Meta" flow, then verify with \`nexus channel setup --type WHATSAPP\`.
+
+\`\`\`bash
+nexus channel connect-waba
+\`\`\`
+
+**SDK equivalent:** N/A (browser-only step)
+
+### channel connection list
+
+List messaging connections for the organization.
+
+\`\`\`
+nexus channel connection list
+\`\`\`
+
+\`\`\`bash
+nexus channel connection list --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.listConnections()\`
+
+### channel connection create
+
+Create a messaging connection (max 1 per organization via the API).
+
+\`\`\`
+nexus channel connection create [options]
+\`\`\`
+
+| Option             | Description                     |
+| ------------------ | ------------------------------- |
+| \`--region <region>\` | Region: \`us1\` or \`ie1\` (default: \`us1\`) |
+
+\`\`\`bash
+nexus channel connection create
+nexus channel connection create --region ie1 --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.createConnection({ region })\`
+
+### channel whatsapp-sender list
+
+List WhatsApp senders for the organization.
+
+\`\`\`
+nexus channel whatsapp-sender list
+\`\`\`
+
+\`\`\`bash
+nexus channel whatsapp-sender list --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.listWhatsAppSenders()\`
+
+### channel whatsapp-sender create
+
+Create a WhatsApp sender (registers a phone number with WhatsApp Business via Meta).
+
+\`\`\`
+nexus channel whatsapp-sender create [options]
+\`\`\`
+
+| Option                     | Required | Description                                           |
+| -------------------------- | -------- | ----------------------------------------------------- |
+| \`--connection-id <id>\`     | Yes      | Messaging connection ID                               |
+| \`--phone-number-id <id>\`   | Yes      | Phone number ID                                       |
+| \`--sender-name <name>\`     | Yes      | Display name for the WhatsApp sender                  |
+| \`--waba-id <id>\`           | No       | WhatsApp Business Account ID (reads from connection if omitted) |
+
+\`\`\`bash
+nexus channel whatsapp-sender create \\
+  --connection-id conn-123 \\
+  --phone-number-id phn-456 \\
+  --sender-name "My Business"
+\`\`\`
+
+**SDK equivalent:** \`client.channels.createWhatsAppSender({ connectionId, phoneNumberId, senderName, wabaId })\`
+
+### channel whatsapp-sender get
+
+Get WhatsApp sender details including status.
+
+\`\`\`
+nexus channel whatsapp-sender get <id>
+\`\`\`
+
+| Argument | Description |
+| -------- | ----------- |
+| \`id\`     | Sender ID   |
+
+\`\`\`bash
+nexus channel whatsapp-sender get sender-123 --json
+\`\`\`
+
+**SDK equivalent:** \`client.channels.getWhatsAppSender(id)\`
+
+---
+
 ## nexus phone-number
 
-Manage phone numbers for voice deployments.
+Manage phone numbers for SMS, Voice, and WhatsApp deployments.
 
 ### phone-number search
 
@@ -6277,13 +8938,13 @@ View built-in CLI documentation.
 nexus docs [topic] [options]
 \`\`\`
 
-| Argument | Description |
-|----------|-------------|
-| \`topic\` | Specific topic: \`overview\`, \`commands\`, \`gotchas\`, \`input-output\`, \`recipes\` |
+| Argument | Description                                                                  |
+| -------- | ---------------------------------------------------------------------------- |
+| \`topic\`  | Specific topic: \`overview\`, \`commands\`, \`gotchas\`, \`input-output\`, \`recipes\` |
 
-| Option | Description |
-|--------|-------------|
-| \`--list\` | List available topics |
+| Option             | Description               |
+| ------------------ | ------------------------- |
+| \`--list\`           | List available topics     |
 | \`--search <query>\` | Search docs for a keyword |
 
 \`\`\`bash
@@ -6972,6 +9633,7 @@ Before every command's output, the CLI prints a one-line context banner to stder
 The format is: \`\u25B8 <profile-name> (<org-name>) \xB7 <source>\`
 
 Where source is one of:
+
 - \`flag override\` \u2014 \`--profile\` flag was used
 - \`env\` \u2014 \`NEXUS_PROFILE\` env var
 - \`.nexusrc\` \u2014 found a \`.nexusrc\` file in directory tree
@@ -6980,6 +9642,7 @@ Where source is one of:
 - \`api-key override\` \u2014 \`--api-key\` flag or \`NEXUS_API_KEY\` env (bypasses profiles)
 
 The banner is **suppressed** when:
+
 - \`--json\` mode is active
 - stdout is not a TTY (piped)
 - Running auth, upgrade, or version commands (they handle their own output)
@@ -7230,34 +9893,46 @@ Deploy the same agent to multiple channels and monitor analytics.
 # 1. Create an agent (or use an existing one)
 AGENT_ID="your-agent-id"
 
-# 2. Deploy to web widget
+# 2. Deploy to web widget (no prerequisites)
 WEB_DEP=$(nexus deployment create \\
   --name "Website Widget" \\
-  --type web \\
+  --type EMBED \\
   --agent-id $AGENT_ID \\
   --json | jq -r '.id')
 
-# 3. Deploy to WhatsApp
+# 3. Deploy to WhatsApp (requires channel setup first!)
+# Check what's needed:
+nexus channel setup --type WHATSAPP
+
+# Auto-provision messaging connection:
+nexus channel setup --type WHATSAPP --auto
+
+# Buy a phone number:
+nexus phone-number search --country US --sms
+nexus phone-number buy --phone-number "+12025551234" --country US --price 1.15
+
+# Create WhatsApp sender (register with Meta):
+CONN_ID=$(nexus channel connection list --json | jq -r '.[0].id')
+PHONE_ID=$(nexus phone-number list --json | jq -r '.[0].id')
+nexus channel whatsapp-sender create \\
+  --connection-id $CONN_ID \\
+  --phone-number-id $PHONE_ID \\
+  --sender-name "My Business"
+
+# Now create the WhatsApp deployment:
 WA_DEP=$(nexus deployment create \\
   --name "WhatsApp Support" \\
-  --type whatsapp \\
+  --type WHATSAPP \\
   --agent-id $AGENT_ID \\
+  --body "{\\"phoneNumberId\\":\\"$PHONE_ID\\",\\"apiKeyConnectionId\\":\\"$CONN_ID\\"}" \\
   --json | jq -r '.id')
 
-# 4. Deploy to Slack
-SLACK_DEP=$(nexus deployment create \\
-  --name "Slack Bot" \\
-  --type slack \\
-  --agent-id $AGENT_ID \\
-  --json | jq -r '.id')
-
-# 5. Organize deployments in a folder
+# 4. Organize deployments in a folder
 FOLDER_ID=$(nexus deployment folder create --name "Production" --json | jq -r '.id')
 nexus deployment folder assign --deployment-id $WEB_DEP --folder-id $FOLDER_ID
 nexus deployment folder assign --deployment-id $WA_DEP --folder-id $FOLDER_ID
-nexus deployment folder assign --deployment-id $SLACK_DEP --folder-id $FOLDER_ID
 
-# 6. Get the web widget embed configuration
+# 5. Get the web widget embed configuration
 nexus deployment embed-config $WEB_DEP
 
 # 7. Customize the widget
@@ -7436,13 +10111,13 @@ jobs:
 
 ### Key Flags for CI
 
-| Flag | Purpose |
-|------|---------|
-| \`--json\` | Machine-readable output |
-| \`--yes\` | Skip confirmation prompts |
-| \`--no-auto-update\` | Prevent auto-updates in CI |
-| \`--api-key\` | Override credentials per-command |
-| \`--profile\` | Use a specific profile |`
+| Flag               | Purpose                          |
+| ------------------ | -------------------------------- |
+| \`--json\`           | Machine-readable output          |
+| \`--yes\`            | Skip confirmation prompts        |
+| \`--no-auto-update\` | Prevent auto-updates in CI       |
+| \`--api-key\`        | Override credentials per-command |
+| \`--profile\`        | Use a specific profile           |`
   }
 };
 var TOPIC_LIST = ["overview", "commands", "gotchas", "input-output", "recipes"];
@@ -7525,9 +10200,11 @@ ${TOPIC_LIST.map((t) => `  ${t.padEnd(14)} ${TOPIC_DESCRIPTIONS[t]}`).join("\n")
         return;
       }
       for (const result of results) {
-        console.log(color.bold(`
+        console.log(
+          color.bold(`
 \u2500\u2500 ${DOCS[result.topic].title} (nexus docs ${result.topic}) \u2500\u2500
-`));
+`)
+        );
         for (const chunk of result.lines) {
           console.log(chunk);
           console.log();
@@ -7836,7 +10513,7 @@ Examples:
     `
 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 --body '{"content":"Hi","participantId":"user-1"}'
   $ nexus emulator send dep-123 sess-456 --text "Test" --json
 
 Notes:
@@ -7848,7 +10525,7 @@ Notes:
       const client = createClient(program2.optsWithGlobals());
       const base = await resolveBody(opts.body);
       const body = mergeBodyWithFlags(base, {
-        text: opts.text
+        content: opts.text
       });
       const result = await client.emulator.sendMessage(deploymentId, sessionId, body);
       printRecord(result);
@@ -8290,8 +10967,8 @@ Examples:
   ).action(async (id) => {
     try {
       const client = createClient(program2.optsWithGlobals());
-      const exec2 = await client.workflowExecutions.get(id);
-      printRecord(exec2, [
+      const exec3 = await client.workflowExecutions.get(id);
+      printRecord(exec3, [
         { key: "id", label: "ID" },
         { key: "workflowId", label: "Workflow" },
         { key: "status", label: "Status" },
@@ -9354,7 +12031,7 @@ Examples:
 }
 
 // src/commands/upgrade.ts
-var import_node_child_process2 = require("child_process");
+var import_node_child_process3 = require("child_process");
 init_output();
 
 // src/util/package-manager.ts
@@ -9519,17 +12196,15 @@ Examples:
 `);
     try {
       const installCmd = getGlobalInstallCommand(PACKAGE_NAME2);
-      (0, import_node_child_process2.execSync)(installCmd, { stdio: "inherit" });
+      (0, import_node_child_process3.execSync)(installCmd, { stdio: "inherit" });
       printSuccess(`Successfully upgraded to ${latest}.`, { from: currentVersion, to: latest });
     } catch {
       const fallbackCmd = getGlobalInstallCommand(PACKAGE_NAME2);
       process.stderr.write(
-        color.red(
-          `
+        color.red(`
 Upgrade failed. Try running manually:
   ${fallbackCmd}
-`
-        )
+`)
       );
       process.exitCode = 1;
     }
@@ -10376,7 +13051,9 @@ registerTemplateCommands(program);
 registerExternalToolCommands(program);
 registerPromptAssistantCommands(program);
 registerModelCommands(program);
+registerCustomModelCommands(program);
 registerPhoneNumberCommands(program);
+registerChannelCommands(program);
 registerUpgradeCommand(program);
 registerDocsCommand(program);
 if (process.argv.length <= 2) {