@chanl/cli 2.0.4 → 3.1.0

package/dist/commands/customers.js

@@ -0,0 +1,289 @@
+import { Command } from "commander";
+import ora from "ora";
+import { readFileSync } from "fs";
+import { createSdk } from "../utils/sdk-factory.js";
+import {
+  printError,
+  printSuccess,
+  printInfo,
+  printBlank,
+  printSimpleTable,
+  printLabel,
+  isJsonOutput,
+  printJson,
+  formatDate
+} from "../utils/output.js";
+function createCustomersCommand() {
+  const customers = new Command("customers").description("Manage the customer record \u2014 the profile every conversation attaches to").addHelpText(
+    "after",
+    `
+What are Customers?
+  The customer record is Chanl's primary surface: every conversation
+  (voice, chat, WhatsApp) attaches to a customer. Records carry contact
+  info, sourced attributes, and channel identities.
+
+Quick Start:
+  $ chanl customers list                        # List customers
+  $ chanl customers list --search dean          # Free-text search
+  $ chanl customers get <id>                    # View a record
+  $ chanl customers create --phone +14155551234 --first-name Dean
+  $ chanl customers resolve --phone +14155551234  # Find-or-create by phone/email
+  $ chanl customers delete <id>                 # Delete a record`
+  );
+  customers.command("list").description("List customers in the workspace").option("-s, --search <text>", "Free-text search (name, phone, email)").option("--limit <number>", "Number of items per page", "20").option("-p, --page <number>", "Page number", "1").addHelpText(
+    "after",
+    `
+Examples:
+  $ chanl customers list                     # First page
+  $ chanl customers list --search dean       # Search by name/phone/email
+  $ chanl customers list --json              # Output as JSON`
+  ).action(handleCustomersList);
+  customers.command("get <id>").description("Get customer details").action(handleCustomersGet);
+  customers.command("create").description("Create a customer").option("--first-name <name>", "First name").option("--last-name <name>", "Last name").option("--email <email>", "Email address").option("--phone <e164>", "Phone number in E.164 format (+14155551234)").option("--agent <agentId>", "Route this customer to a specific agent").option("-f, --file <path>", "Path to JSON file with customer data (overrides flags)").addHelpText(
+    "after",
+    `
+Examples:
+  $ chanl customers create --phone +14155551234 --first-name Dean
+  $ chanl customers create -f customer.json`
+  ).action(handleCustomersCreate);
+  customers.command("update <id>").description("Update a customer").option("--first-name <name>", "First name").option("--last-name <name>", "Last name").option("--email <email>", "Email address").option("--phone <e164>", "Phone number in E.164 format").option("--agent <agentId>", "Route this customer to a specific agent").option("-f, --file <path>", "Path to JSON file with fields to update (overrides flags)").action(handleCustomersUpdate);
+  customers.command("resolve").description("Resolve by phone/email \u2014 returns existing customer or creates one").option("--phone <e164>", "Phone number in E.164 format").option("--email <email>", "Email address").option("--first-name <name>", "First name (used only on create)").option("--last-name <name>", "Last name (used only on create)").addHelpText(
+    "after",
+    `
+Examples:
+  $ chanl customers resolve --phone +14155551234
+  $ chanl customers resolve --email dean@example.com --first-name Dean`
+  ).action(handleCustomersResolve);
+  customers.command("delete <id>").description("Delete a customer").action(handleCustomersDelete);
+  return customers;
+}
+function customerDisplayName(c) {
+  const name = [c.firstName, c.lastName].filter(Boolean).join(" ");
+  return name || c.displayName || "-";
+}
+async function handleCustomersList(options) {
+  const sdk = createSdk();
+  if (!sdk) return;
+  const spinner = ora("Fetching customers...").start();
+  try {
+    const response = await sdk.customers.list({
+      search: options.search,
+      limit: parseInt(options.limit, 10),
+      page: parseInt(options.page, 10)
+    });
+    spinner.stop();
+    if (!response.success || !response.data) {
+      printError("Failed to fetch customers", response.message);
+      process.exitCode = 1;
+      return;
+    }
+    const { data: customers, pagination } = response.data;
+    if (isJsonOutput()) {
+      printJson(response.data);
+      return;
+    }
+    if (customers.length === 0) {
+      printInfo("No customers found");
+      printInfo("Use 'chanl customers create' or 'chanl customers resolve' to add one");
+      return;
+    }
+    printBlank();
+    printSimpleTable(
+      ["ID", "Name", "Phone", "Email", "Type", "Last seen"],
+      customers.map((c) => [
+        c.id.slice(-12),
+        customerDisplayName(c).slice(0, 24),
+        c.phoneNumber || "-",
+        (c.email || "-").slice(0, 28),
+        c.contactType || "-",
+        c.lastSeenAt ? formatDate(c.lastSeenAt) : "-"
+      ])
+    );
+    printBlank();
+    if (pagination) {
+      printInfo(`Total: ${pagination.total} customers (Page ${pagination.page} of ${pagination.totalPages})`);
+    }
+  } catch (error) {
+    spinner.fail("Failed to fetch customers");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    printError("Error", message);
+    process.exitCode = 1;
+  }
+}
+async function handleCustomersGet(id) {
+  const sdk = createSdk();
+  if (!sdk) return;
+  const spinner = ora("Fetching customer...").start();
+  try {
+    const response = await sdk.customers.get(id);
+    spinner.stop();
+    if (!response.success || !response.data) {
+      printError("Failed to fetch customer", response.message);
+      process.exitCode = 1;
+      return;
+    }
+    if (isJsonOutput()) {
+      printJson(response.data);
+      return;
+    }
+    const c = response.data;
+    printBlank();
+    printLabel("ID", c.id);
+    printLabel("Name", customerDisplayName(c));
+    printLabel("Phone", c.phoneNumber || "-");
+    printLabel("Email", c.email || "-");
+    printLabel("Type", c.contactType || "-");
+    printLabel("Agent override", c.agentId || "-");
+    printLabel("Language", c.language || "-");
+    printLabel("Last seen", c.lastSeenAt ? formatDate(c.lastSeenAt) : "-");
+    printLabel("Created", formatDate(c.createdAt));
+    if (c.customAttributes && Object.keys(c.customAttributes).length > 0) {
+      printBlank();
+      printInfo("Attributes:");
+      for (const [key, value] of Object.entries(c.customAttributes)) {
+        printLabel(`  ${key}`, typeof value === "object" ? JSON.stringify(value) : String(value));
+      }
+    }
+    printBlank();
+  } catch (error) {
+    spinner.fail("Failed to fetch customer");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    printError("Error", message);
+    process.exitCode = 1;
+  }
+}
+function customerDataFromOptions(options) {
+  if (options.file) {
+    return JSON.parse(readFileSync(options.file, "utf-8"));
+  }
+  const data = {};
+  if (options.firstName) data.firstName = options.firstName;
+  if (options.lastName) data.lastName = options.lastName;
+  if (options.email) data.email = options.email;
+  if (options.phone) data.phoneNumber = options.phone;
+  if (options.agent) data.agentId = options.agent;
+  return data;
+}
+async function handleCustomersCreate(options) {
+  const sdk = createSdk();
+  if (!sdk) return;
+  const data = customerDataFromOptions(options);
+  if (Object.keys(data).length === 0) {
+    printError("Nothing to create", "Provide --phone/--email/--first-name flags or -f <file>");
+    process.exitCode = 1;
+    return;
+  }
+  const spinner = ora("Creating customer...").start();
+  try {
+    const response = await sdk.customers.create(data);
+    spinner.stop();
+    if (!response.success || !response.data) {
+      printError("Failed to create customer", response.message);
+      process.exitCode = 1;
+      return;
+    }
+    if (isJsonOutput()) {
+      printJson(response.data);
+      return;
+    }
+    printSuccess(`Customer created: ${response.data.id}`);
+    printInfo(`View it: chanl customers get ${response.data.id}`);
+  } catch (error) {
+    spinner.fail("Failed to create customer");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    printError("Error", message);
+    process.exitCode = 1;
+  }
+}
+async function handleCustomersUpdate(id, options) {
+  const sdk = createSdk();
+  if (!sdk) return;
+  const data = customerDataFromOptions(options);
+  if (Object.keys(data).length === 0) {
+    printError("Nothing to update", "Provide flags or -f <file>");
+    process.exitCode = 1;
+    return;
+  }
+  const spinner = ora("Updating customer...").start();
+  try {
+    const response = await sdk.customers.update(id, data);
+    spinner.stop();
+    if (!response.success || !response.data) {
+      printError("Failed to update customer", response.message);
+      process.exitCode = 1;
+      return;
+    }
+    if (isJsonOutput()) {
+      printJson(response.data);
+      return;
+    }
+    printSuccess(`Customer updated: ${id}`);
+  } catch (error) {
+    spinner.fail("Failed to update customer");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    printError("Error", message);
+    process.exitCode = 1;
+  }
+}
+async function handleCustomersResolve(options) {
+  const sdk = createSdk();
+  if (!sdk) return;
+  if (!options.phone && !options.email) {
+    printError("Phone or email required", "Use --phone +E164 or --email");
+    process.exitCode = 1;
+    return;
+  }
+  const spinner = ora("Resolving customer...").start();
+  try {
+    const response = await sdk.customers.resolve({
+      phone: options.phone,
+      email: options.email,
+      firstName: options.firstName,
+      lastName: options.lastName
+    });
+    spinner.stop();
+    if (!response.success || !response.data) {
+      printError("Failed to resolve customer", response.message);
+      process.exitCode = 1;
+      return;
+    }
+    if (isJsonOutput()) {
+      printJson(response.data);
+      return;
+    }
+    const { customer, created } = response.data;
+    printSuccess(
+      created ? `Customer created: ${customer.id}` : `Existing customer: ${customer.id} (${customerDisplayName(customer)})`
+    );
+    printInfo(`View it: chanl customers get ${customer.id}`);
+  } catch (error) {
+    spinner.fail("Failed to resolve customer");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    printError("Error", message);
+    process.exitCode = 1;
+  }
+}
+async function handleCustomersDelete(id) {
+  const sdk = createSdk();
+  if (!sdk) return;
+  const spinner = ora("Deleting customer...").start();
+  try {
+    const response = await sdk.customers.delete(id);
+    spinner.stop();
+    if (!response.success) {
+      printError("Failed to delete customer", response.message);
+      process.exitCode = 1;
+      return;
+    }
+    printSuccess(`Customer deleted: ${id}`);
+  } catch (error) {
+    spinner.fail("Failed to delete customer");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    printError("Error", message);
+    process.exitCode = 1;
+  }
+}
+export {
+  createCustomersCommand
+};
+//# sourceMappingURL=customers.js.map

package/dist/commands/customers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/customers.ts"],"sourcesContent":["import { Command } from 'commander';\nimport ora from 'ora';\nimport { readFileSync } from 'fs';\nimport type { Customer, CreateCustomerData } from '@chanl/sdk';\nimport { createSdk } from '../utils/sdk-factory.js';\nimport {\n  printError,\n  printSuccess,\n  printInfo,\n  printBlank,\n  printSimpleTable,\n  printLabel,\n  isJsonOutput,\n  printJson,\n  formatDate,\n} from '../utils/output.js';\n\n/**\n * Create the customers command group\n */\nexport function createCustomersCommand(): Command {\n  const customers = new Command('customers')\n    .description('Manage the customer record — the profile every conversation attaches to')\n    .addHelpText(\n      'after',\n      `\nWhat are Customers?\n  The customer record is Chanl's primary surface: every conversation\n  (voice, chat, WhatsApp) attaches to a customer. Records carry contact\n  info, sourced attributes, and channel identities.\n\nQuick Start:\n  $ chanl customers list                        # List customers\n  $ chanl customers list --search dean          # Free-text search\n  $ chanl customers get <id>                    # View a record\n  $ chanl customers create --phone +14155551234 --first-name Dean\n  $ chanl customers resolve --phone +14155551234  # Find-or-create by phone/email\n  $ chanl customers delete <id>                 # Delete a record`\n    );\n\n  // customers list\n  customers\n    .command('list')\n    .description('List customers in the workspace')\n    .option('-s, --search <text>', 'Free-text search (name, phone, email)')\n    .option('--limit <number>', 'Number of items per page', '20')\n    .option('-p, --page <number>', 'Page number', '1')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ chanl customers list                     # First page\n  $ chanl customers list --search dean       # Search by name/phone/email\n  $ chanl customers list --json              # Output as JSON`\n    )\n    .action(handleCustomersList);\n\n  // customers get <id>\n  customers\n    .command('get <id>')\n    .description('Get customer details')\n    .action(handleCustomersGet);\n\n  // customers create\n  customers\n    .command('create')\n    .description('Create a customer')\n    .option('--first-name <name>', 'First name')\n    .option('--last-name <name>', 'Last name')\n    .option('--email <email>', 'Email address')\n    .option('--phone <e164>', 'Phone number in E.164 format (+14155551234)')\n    .option('--agent <agentId>', 'Route this customer to a specific agent')\n    .option('-f, --file <path>', 'Path to JSON file with customer data (overrides flags)')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ chanl customers create --phone +14155551234 --first-name Dean\n  $ chanl customers create -f customer.json`\n    )\n    .action(handleCustomersCreate);\n\n  // customers update <id>\n  customers\n    .command('update <id>')\n    .description('Update a customer')\n    .option('--first-name <name>', 'First name')\n    .option('--last-name <name>', 'Last name')\n    .option('--email <email>', 'Email address')\n    .option('--phone <e164>', 'Phone number in E.164 format')\n    .option('--agent <agentId>', 'Route this customer to a specific agent')\n    .option('-f, --file <path>', 'Path to JSON file with fields to update (overrides flags)')\n    .action(handleCustomersUpdate);\n\n  // customers resolve\n  customers\n    .command('resolve')\n    .description('Resolve by phone/email — returns existing customer or creates one')\n    .option('--phone <e164>', 'Phone number in E.164 format')\n    .option('--email <email>', 'Email address')\n    .option('--first-name <name>', 'First name (used only on create)')\n    .option('--last-name <name>', 'Last name (used only on create)')\n    .addHelpText(\n      'after',\n      `\nExamples:\n  $ chanl customers resolve --phone +14155551234\n  $ chanl customers resolve --email dean@example.com --first-name Dean`\n    )\n    .action(handleCustomersResolve);\n\n  // customers delete <id>\n  customers\n    .command('delete <id>')\n    .description('Delete a customer')\n    .action(handleCustomersDelete);\n\n  return customers;\n}\n\nfunction customerDisplayName(c: Customer): string {\n  const name = [c.firstName, c.lastName].filter(Boolean).join(' ');\n  return name || c.displayName || '-';\n}\n\nasync function handleCustomersList(options: {\n  search?: string;\n  limit: string;\n  page: string;\n}): Promise<void> {\n  const sdk = createSdk();\n  if (!sdk) return;\n\n  const spinner = ora('Fetching customers...').start();\n\n  try {\n    const response = await sdk.customers.list({\n      search: options.search,\n      limit: parseInt(options.limit, 10),\n      page: parseInt(options.page, 10),\n    });\n\n    spinner.stop();\n\n    if (!response.success || !response.data) {\n      printError('Failed to fetch customers', response.message);\n      process.exitCode = 1;\n      return;\n    }\n\n    const { data: customers, pagination } = response.data;\n\n    if (isJsonOutput()) {\n      printJson(response.data);\n      return;\n    }\n\n    if (customers.length === 0) {\n      printInfo('No customers found');\n      printInfo(\"Use 'chanl customers create' or 'chanl customers resolve' to add one\");\n      return;\n    }\n\n    printBlank();\n    printSimpleTable(\n      ['ID', 'Name', 'Phone', 'Email', 'Type', 'Last seen'],\n      customers.map((c: Customer) => [\n        c.id.slice(-12),\n        customerDisplayName(c).slice(0, 24),\n        c.phoneNumber || '-',\n        (c.email || '-').slice(0, 28),\n        c.contactType || '-',\n        c.lastSeenAt ? formatDate(c.lastSeenAt) : '-',\n      ])\n    );\n\n    printBlank();\n    if (pagination) {\n      printInfo(`Total: ${pagination.total} customers (Page ${pagination.page} of ${pagination.totalPages})`);\n    }\n  } catch (error) {\n    spinner.fail('Failed to fetch customers');\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    printError('Error', message);\n    process.exitCode = 1;\n  }\n}\n\nasync function handleCustomersGet(id: string): Promise<void> {\n  const sdk = createSdk();\n  if (!sdk) return;\n\n  const spinner = ora('Fetching customer...').start();\n\n  try {\n    const response = await sdk.customers.get(id);\n    spinner.stop();\n\n    if (!response.success || !response.data) {\n      printError('Failed to fetch customer', response.message);\n      process.exitCode = 1;\n      return;\n    }\n\n    if (isJsonOutput()) {\n      printJson(response.data);\n      return;\n    }\n\n    const c = response.data;\n    printBlank();\n    printLabel('ID', c.id);\n    printLabel('Name', customerDisplayName(c));\n    printLabel('Phone', c.phoneNumber || '-');\n    printLabel('Email', c.email || '-');\n    printLabel('Type', c.contactType || '-');\n    printLabel('Agent override', c.agentId || '-');\n    printLabel('Language', c.language || '-');\n    printLabel('Last seen', c.lastSeenAt ? formatDate(c.lastSeenAt) : '-');\n    printLabel('Created', formatDate(c.createdAt));\n    if (c.customAttributes && Object.keys(c.customAttributes).length > 0) {\n      printBlank();\n      printInfo('Attributes:');\n      for (const [key, value] of Object.entries(c.customAttributes)) {\n        printLabel(`  ${key}`, typeof value === 'object' ? JSON.stringify(value) : String(value));\n      }\n    }\n    printBlank();\n  } catch (error) {\n    spinner.fail('Failed to fetch customer');\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    printError('Error', message);\n    process.exitCode = 1;\n  }\n}\n\nfunction customerDataFromOptions(options: {\n  firstName?: string;\n  lastName?: string;\n  email?: string;\n  phone?: string;\n  agent?: string;\n  file?: string;\n}): CreateCustomerData {\n  if (options.file) {\n    return JSON.parse(readFileSync(options.file, 'utf-8')) as CreateCustomerData;\n  }\n  const data: CreateCustomerData = {};\n  if (options.firstName) data.firstName = options.firstName;\n  if (options.lastName) data.lastName = options.lastName;\n  if (options.email) data.email = options.email;\n  if (options.phone) data.phoneNumber = options.phone;\n  if (options.agent) data.agentId = options.agent;\n  return data;\n}\n\nasync function handleCustomersCreate(options: {\n  firstName?: string;\n  lastName?: string;\n  email?: string;\n  phone?: string;\n  agent?: string;\n  file?: string;\n}): Promise<void> {\n  const sdk = createSdk();\n  if (!sdk) return;\n\n  const data = customerDataFromOptions(options);\n  if (Object.keys(data).length === 0) {\n    printError('Nothing to create', 'Provide --phone/--email/--first-name flags or -f <file>');\n    process.exitCode = 1;\n    return;\n  }\n\n  const spinner = ora('Creating customer...').start();\n\n  try {\n    const response = await sdk.customers.create(data);\n    spinner.stop();\n\n    if (!response.success || !response.data) {\n      printError('Failed to create customer', response.message);\n      process.exitCode = 1;\n      return;\n    }\n\n    if (isJsonOutput()) {\n      printJson(response.data);\n      return;\n    }\n\n    printSuccess(`Customer created: ${response.data.id}`);\n    printInfo(`View it: chanl customers get ${response.data.id}`);\n  } catch (error) {\n    spinner.fail('Failed to create customer');\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    printError('Error', message);\n    process.exitCode = 1;\n  }\n}\n\nasync function handleCustomersUpdate(\n  id: string,\n  options: {\n    firstName?: string;\n    lastName?: string;\n    email?: string;\n    phone?: string;\n    agent?: string;\n    file?: string;\n  }\n): Promise<void> {\n  const sdk = createSdk();\n  if (!sdk) return;\n\n  const data = customerDataFromOptions(options);\n  if (Object.keys(data).length === 0) {\n    printError('Nothing to update', 'Provide flags or -f <file>');\n    process.exitCode = 1;\n    return;\n  }\n\n  const spinner = ora('Updating customer...').start();\n\n  try {\n    const response = await sdk.customers.update(id, data);\n    spinner.stop();\n\n    if (!response.success || !response.data) {\n      printError('Failed to update customer', response.message);\n      process.exitCode = 1;\n      return;\n    }\n\n    if (isJsonOutput()) {\n      printJson(response.data);\n      return;\n    }\n\n    printSuccess(`Customer updated: ${id}`);\n  } catch (error) {\n    spinner.fail('Failed to update customer');\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    printError('Error', message);\n    process.exitCode = 1;\n  }\n}\n\nasync function handleCustomersResolve(options: {\n  phone?: string;\n  email?: string;\n  firstName?: string;\n  lastName?: string;\n}): Promise<void> {\n  const sdk = createSdk();\n  if (!sdk) return;\n\n  if (!options.phone && !options.email) {\n    printError('Phone or email required', 'Use --phone +E164 or --email');\n    process.exitCode = 1;\n    return;\n  }\n\n  const spinner = ora('Resolving customer...').start();\n\n  try {\n    const response = await sdk.customers.resolve({\n      phone: options.phone,\n      email: options.email,\n      firstName: options.firstName,\n      lastName: options.lastName,\n    });\n    spinner.stop();\n\n    if (!response.success || !response.data) {\n      printError('Failed to resolve customer', response.message);\n      process.exitCode = 1;\n      return;\n    }\n\n    if (isJsonOutput()) {\n      printJson(response.data);\n      return;\n    }\n\n    const { customer, created } = response.data;\n    printSuccess(\n      created\n        ? `Customer created: ${customer.id}`\n        : `Existing customer: ${customer.id} (${customerDisplayName(customer)})`\n    );\n    printInfo(`View it: chanl customers get ${customer.id}`);\n  } catch (error) {\n    spinner.fail('Failed to resolve customer');\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    printError('Error', message);\n    process.exitCode = 1;\n  }\n}\n\nasync function handleCustomersDelete(id: string): Promise<void> {\n  const sdk = createSdk();\n  if (!sdk) return;\n\n  const spinner = ora('Deleting customer...').start();\n\n  try {\n    const response = await sdk.customers.delete(id);\n    spinner.stop();\n\n    if (!response.success) {\n      printError('Failed to delete customer', response.message);\n      process.exitCode = 1;\n      return;\n    }\n\n    printSuccess(`Customer deleted: ${id}`);\n  } catch (error) {\n    spinner.fail('Failed to delete customer');\n    const message = error instanceof Error ? error.message : 'Unknown error';\n    printError('Error', message);\n    process.exitCode = 1;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/commands/index.d.ts

@@ -6,6 +6,9 @@ export { createScenariosCommand } from './scenarios.js';
 export { createCallCommand } from './call.js';
 export { createCallsCommand } from './calls.js';
 export { createPersonasCommand } from './personas.js';
+export { createCustomersCommand } from './customers.js';
+export { createConversationsCommand, createMessagesCommand } from './messaging.js';
+export { createWhatsAppCommand } from './whatsapp.js';
 export { createAgentsCommand } from './agents.js';
 export { createHealthCommand } from './health.js';
 export { createMcpCommand } from './mcp.js';

package/dist/commands/index.js

@@ -6,6 +6,9 @@ import { createScenariosCommand } from "./scenarios.js";
 import { createCallCommand } from "./call.js";
 import { createCallsCommand } from "./calls.js";
 import { createPersonasCommand } from "./personas.js";
+import { createCustomersCommand } from "./customers.js";
+import { createConversationsCommand, createMessagesCommand } from "./messaging.js";
+import { createWhatsAppCommand } from "./whatsapp.js";
 import { createAgentsCommand } from "./agents.js";
 import { createHealthCommand } from "./health.js";
 import { createMcpCommand } from "./mcp.js";
@@ -22,18 +25,22 @@ export {
   createCallsCommand,
   createChatCommand,
   createConfigCommand,
+  createConversationsCommand,
+  createCustomersCommand,
   createHealthCommand,
   createKnowledgeCommand,
   createLoginCommand,
   createLogoutCommand,
   createMcpCommand,
   createMemoryCommand,
+  createMessagesCommand,
   createPersonasCommand,
   createPromptsCommand,
   createScenariosCommand,
   createScorecardsCommand,
   createToolsCommand,
   createToolsetsCommand,
+  createWhatsAppCommand,
   createWorkspacesCommand
 };
 //# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/commands/index.ts"],"sourcesContent":["/**\n * Command exports for the Chanl CLI\n */\n\nexport { createAuthCommand, createLoginCommand, createLogoutCommand } from './auth.js';\nexport { createConfigCommand } from './config.js';\nexport { createToolsCommand } from './tools.js';\nexport { createToolsetsCommand } from './toolsets.js';\nexport { createScenariosCommand } from './scenarios.js';\nexport { createCallCommand } from './call.js';\nexport { createCallsCommand } from './calls.js';\nexport { createPersonasCommand } from './personas.js';\nexport { createAgentsCommand } from './agents.js';\nexport { createHealthCommand } from './health.js';\nexport { createMcpCommand } from './mcp.js';\nexport { createScorecardsCommand } from './scorecards.js';\nexport { createKnowledgeCommand } from './knowledge.js';\nexport { createMemoryCommand } from './memory.js';\nexport { createChatCommand } from './chat.js';\nexport { createPromptsCommand } from './prompts.js';\nexport { createWorkspacesCommand } from './workspaces.js';\n"],"mappings":"AAIA,SAAS,mBAAmB,oBAAoB,2BAA2B;AAC3E,SAAS,2BAA2B;AACpC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,8BAA8B;AACvC,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AACpC,SAAS,2BAA2B;AACpC,SAAS,wBAAwB;AACjC,SAAS,+BAA+B;AACxC,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AACpC,SAAS,yBAAyB;AAClC,SAAS,4BAA4B;AACrC,SAAS,+BAA+B;","names":[]}
+{"version":3,"sources":["../../src/commands/index.ts"],"sourcesContent":["/**\n * Command exports for the Chanl CLI\n */\n\nexport { createAuthCommand, createLoginCommand, createLogoutCommand } from './auth.js';\nexport { createConfigCommand } from './config.js';\nexport { createToolsCommand } from './tools.js';\nexport { createToolsetsCommand } from './toolsets.js';\nexport { createScenariosCommand } from './scenarios.js';\nexport { createCallCommand } from './call.js';\nexport { createCallsCommand } from './calls.js';\nexport { createPersonasCommand } from './personas.js';\nexport { createCustomersCommand } from './customers.js';\nexport { createConversationsCommand, createMessagesCommand } from './messaging.js';\nexport { createWhatsAppCommand } from './whatsapp.js';\nexport { createAgentsCommand } from './agents.js';\nexport { createHealthCommand } from './health.js';\nexport { createMcpCommand } from './mcp.js';\nexport { createScorecardsCommand } from './scorecards.js';\nexport { createKnowledgeCommand } from './knowledge.js';\nexport { createMemoryCommand } from './memory.js';\nexport { createChatCommand } from './chat.js';\nexport { createPromptsCommand } from './prompts.js';\nexport { createWorkspacesCommand } from './workspaces.js';\n"],"mappings":"AAIA,SAAS,mBAAmB,oBAAoB,2BAA2B;AAC3E,SAAS,2BAA2B;AACpC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,8BAA8B;AACvC,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,8BAA8B;AACvC,SAAS,4BAA4B,6BAA6B;AAClE,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AACpC,SAAS,2BAA2B;AACpC,SAAS,wBAAwB;AACjC,SAAS,+BAA+B;AACxC,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AACpC,SAAS,yBAAyB;AAClC,SAAS,4BAA4B;AACrC,SAAS,+BAA+B;","names":[]}

package/dist/commands/memory.js

@@ -71,15 +71,32 @@ Examples:
   $ chanl memory delete 680a1b2c3d4e5f6789012345       # With confirmation
   $ chanl memory delete 680a1b2c3d4e5f6789012345 -y    # Skip confirmation`
   ).action(handleMemoryDelete);
-  memory.command("search").description("Search memories using semantic similarity").option("--entity-type <type>", "Entity type (required): customer, session, agent, conversation").option("--entity-id <id>", "Entity ID (required)").option("--query <text>", "Search query text (required)").option("--agent-id <id>", "Optional agent scope filter").option("-l, --limit <number>", "Maximum results").option("--min-score <number>", "Minimum relevance score (0-1)").addHelpText(
+  memory.command("search").description("Search memories using semantic similarity").option("--entity-type <type>", "Entity type (required): customer, session, agent, conversation").option("--entity-id <id>", "Entity ID (required)").option("--query <text>", "Search query text (required)").option("--agent-id <id>", "Optional agent scope filter").option("-l, --limit <number>", "Maximum results").option("--min-score <number>", "Minimum relevance score (0-1)").option("--min-confidence <number>", "Minimum extraction confidence (0-1)").option("--created-after <iso>", "Only memories created at/after this ISO-8601 timestamp").option("--created-before <iso>", "Only memories created at/before this ISO-8601 timestamp").addHelpText(
     "after",
     `
 Examples:
   $ chanl memory search --entity-type customer --entity-id cust_123 --query "email preferences"
   $ chanl memory search --entity-type customer --entity-id cust_123 --query "contact" --limit 5
   $ chanl memory search --entity-type customer --entity-id cust_123 --query "VIP" --min-score 0.8
+  $ chanl memory search --entity-type customer --entity-id cust_123 --query "recent" --created-after 2026-05-01T00:00:00Z
   $ chanl memory search --entity-type customer --entity-id cust_123 --query "test" --json`
   ).action(handleMemorySearch);
+  memory.command("search-global").description("Search ALL memories in the workspace (no entity scope)").option("--query <text>", "Search query text (required)").option("--entity-type <type>", "Optional: narrow to an entity type").option("--agent-id <id>", "Optional agent scope filter").option("--source <source>", "Filter by source: conversation, manual, extraction").option("-l, --limit <number>", "Maximum results").option("--min-score <number>", "Minimum relevance score (0-1)").addHelpText(
+    "after",
+    `
+Examples:
+  $ chanl memory search-global --query "billing preferences"
+  $ chanl memory search-global --query "VIP" --entity-type customer --limit 10
+  $ chanl memory search-global --query "test" --json`
+  ).action(handleMemorySearchGlobal);
+  memory.command("stats").description("Aggregate memory statistics (totals, by type/source, top-accessed)").option("--entity-type <type>", "Optionally scope stats to an entity type").option("--entity-id <id>", "Optionally scope stats to an entity ID").addHelpText(
+    "after",
+    `
+Examples:
+  $ chanl memory stats                                       # Workspace-wide
+  $ chanl memory stats --entity-type customer --entity-id cust_123
+  $ chanl memory stats --json`
+  ).action(handleMemoryStats);
   return memory;
 }
 function truncate(str, maxLen) {
@@ -336,6 +353,15 @@ async function handleMemorySearch(options) {
   if (options.minScore) {
     input.minScore = parseFloat(options.minScore);
   }
+  if (options.minConfidence) {
+    input.minConfidence = parseFloat(options.minConfidence);
+  }
+  if (options.createdAfter) {
+    input.createdAfter = options.createdAfter;
+  }
+  if (options.createdBefore) {
+    input.createdBefore = options.createdBefore;
+  }
   const spinner = ora("Searching memories...").start();
   try {
     const response = await sdk.memory.search(input);
@@ -374,6 +400,113 @@ async function handleMemorySearch(options) {
     process.exitCode = 1;
   }
 }
+async function handleMemorySearchGlobal(options) {
+  if (!options.query) {
+    printError("Missing required option", "Provide --query");
+    printInfo("Run 'chanl memory search-global --help' for usage");
+    process.exitCode = 1;
+    return;
+  }
+  const sdk = createSdk();
+  if (!sdk) return;
+  const input = { query: options.query };
+  if (options.entityType) input.entityType = options.entityType;
+  if (options.agentId) input.agentId = options.agentId;
+  if (options.source) input.source = options.source;
+  if (options.limit) input.limit = parseInt(options.limit, 10);
+  if (options.minScore) input.minScore = parseFloat(options.minScore);
+  const spinner = ora("Searching all memories...").start();
+  try {
+    const response = await sdk.memory.searchGlobal(input);
+    spinner.stop();
+    if (!response.success || !response.data) {
+      printError("Failed to search memories", response.message);
+      process.exitCode = 1;
+      return;
+    }
+    const { memories } = response.data;
+    if (isJsonOutput()) {
+      printJson({ memories });
+      return;
+    }
+    if (memories.length === 0) {
+      printInfo("No matching memories found");
+      return;
+    }
+    printBlank();
+    printSimpleTable(
+      ["ID", "Score", "Content", "Entity Type", "Entity ID"],
+      memories.map((m) => [
+        truncate(m.id, 12),
+        (m.score ?? 0).toFixed(2),
+        truncate(m.content, 50),
+        m.entityType,
+        m.entityId
+      ])
+    );
+    printBlank();
+    printInfo(`Found ${memories.length} matching memories`);
+  } catch (error) {
+    spinner.fail("Failed to search memories");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    printError("Error", message);
+    process.exitCode = 1;
+  }
+}
+async function handleMemoryStats(options) {
+  const sdk = createSdk();
+  if (!sdk) return;
+  const spinner = ora("Aggregating memory stats...").start();
+  try {
+    const response = await sdk.memory.stats({
+      entityType: options.entityType,
+      entityId: options.entityId
+    });
+    spinner.stop();
+    if (!response.success || !response.data) {
+      printError("Failed to fetch memory stats", response.message);
+      process.exitCode = 1;
+      return;
+    }
+    const stats = response.data;
+    if (isJsonOutput()) {
+      printJson(stats);
+      return;
+    }
+    printBlank();
+    printLabel("Total", String(stats.total));
+    printLabel("Active", chalk.green(String(stats.active)));
+    printLabel("Inactive", String(stats.inactive));
+    printLabel("Expired", stats.expired > 0 ? chalk.yellow(String(stats.expired)) : "0");
+    printLabel("Avg confidence", stats.avgConfidence.toFixed(3));
+    printBlank();
+    printInfo("By type:");
+    printSimpleTable(
+      ["Entity Type", "Count"],
+      Object.entries(stats.byType).map(([k, v]) => [k, String(v)])
+    );
+    printBlank();
+    printInfo("By source:");
+    printSimpleTable(
+      ["Source", "Count"],
+      Object.entries(stats.bySource).map(([k, v]) => [k, String(v)])
+    );
+    if (stats.topAccessed.length > 0) {
+      printBlank();
+      printInfo("Top accessed:");
+      printSimpleTable(
+        ["ID", "Access Count", "Content"],
+        stats.topAccessed.map((t) => [truncate(t.id, 12), String(t.accessCount), truncate(t.content, 50)])
+      );
+    }
+    printBlank();
+  } catch (error) {
+    spinner.fail("Failed to fetch memory stats");
+    const message = error instanceof Error ? error.message : "Unknown error";
+    printError("Error", message);
+    process.exitCode = 1;
+  }
+}
 function printMemoryDetails(memory) {
   printLabel("ID", memory.id);
   printLabel("Entity Type", memory.entityType);