callkaro-cli-unofficial 0.1.0

package/dist/index.js

@@ -0,0 +1,684 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ui_1 = require("./lib/ui");
+const accounts_1 = require("./commands/accounts");
+const dashboardAuth_1 = require("./lib/dashboardAuth");
+const kpi_1 = require("./commands/kpi");
+/** Board columns, for `--help`. Ids are what the server keys on, not labels. */
+const KPI_COLUMNS = 'action_items | in_progress | testing_ab | live_prod | done | rejected';
+const analyzers_1 = require("./commands/analyzers");
+const models_1 = require("./commands/models");
+const agents_1 = require("./commands/agents");
+const agentVersions_1 = require("./commands/agentVersions");
+const agentPhone_1 = require("./commands/agentPhone");
+const numbers_1 = require("./commands/numbers");
+const calls_1 = require("./commands/calls");
+const ongoing_1 = require("./commands/ongoing");
+const transcribers_1 = require("./commands/transcribers");
+const voices_1 = require("./commands/voices");
+const secrets_1 = require("./commands/secrets");
+const skills_1 = require("./commands/skills");
+const update_1 = require("./commands/update");
+const analytics_1 = require("./commands/analytics");
+const batches_1 = require("./commands/batches");
+const simulations_1 = require("./commands/simulations");
+const auditStrategies_1 = require("./commands/auditStrategies");
+const chatAgents_1 = require("./commands/chatAgents");
+// The command this fork installs as. Deliberately NOT `ck` or `callkaro`:
+// those belong to @callkaro-official/cli, and both packages write to the same
+// global node_modules/.bin, so sharing a name means whichever npm install ran
+// last silently wins. `cku` cannot collide.
+const name = 'cku';
+const { version: VERSION } = require('../package.json');
+const program = new commander_1.Command();
+program
+    .name(name)
+    .description('CallKaro Unofficial CLI — manage your voice AI agents from the terminal')
+    .version(VERSION, '-v, --version', 'show version')
+    .helpOption('-h, --help', 'show help')
+    .showHelpAfterError(chalk_1.default.dim(`(run "${name} --help" for usage)`))
+    .showSuggestionAfterError()
+    .addHelpText('before', (0, ui_1.banner)(VERSION));
+// --- auth ------------------------------------------------------------------
+program
+    .command('register')
+    .description('create an account (Google, or email + password + OTP)')
+    .option('--google', 'sign up with Google in your browser (skips the picker)')
+    .option('--email <email>', 'email address')
+    .option('--name <name>', 'your name')
+    .action(accounts_1.registerCommand);
+program
+    .command('login')
+    .description('sign in through your browser (no password in the terminal)')
+    .option('--password', 'use the classic email + password prompt instead')
+    .option('--email <email>', 'email address (with --password)')
+    .action(accounts_1.loginCommand);
+program
+    .command('logout')
+    .description('revoke this session and clear the stored token')
+    .action(accounts_1.logoutCommand);
+program
+    .command('whoami')
+    .description('show the logged-in account details')
+    .option('--json', 'output raw JSON')
+    .action(accounts_1.whoamiCommand);
+// Dashboard sign-in. A different credential from the ck_ token above: it reaches
+// /auth/* and /v2/*, not /cli/*. Reproduces the web app's own email+password flow,
+// which never touches Firebase. See lib/dashboardAuth.ts.
+const dashboard = program
+    .command('dashboard')
+    .description('sign in to the CallKaro web dashboard (a different credential from the ck_ token)');
+dashboard
+    .command('login')
+    .description('sign in with email + password, exactly as the login form does')
+    .option('--email <email>', 'skip the email prompt')
+    .action(dashboardAuth_1.dashboardLoginCommand);
+dashboard
+    .command('whoami')
+    .description('prove the stored dashboard token still works')
+    .option('--json', 'output raw JSON')
+    .action(dashboardAuth_1.dashboardWhoamiCommand);
+dashboard
+    .command('probe')
+    .description('GET a set of dashboard routes and print status + shape (read-only)')
+    .action(dashboardAuth_1.dashboardProbeCommand);
+dashboard
+    .command('logout')
+    .description('forget the dashboard session (the ck_ token is kept)')
+    .option('--yes', 'skip the confirmation')
+    .action(dashboardAuth_1.dashboardLogoutCommand);
+// Which models the server accepts. Same source the validator uses, so it cannot drift.
+program
+    .command('models')
+    .description('list the models the server accepts, per slot')
+    .option('--slot <name>', 'list one slot in full, e.g. agent, post-call, kpi-rca')
+    .option('--json', 'output raw JSON')
+    .addHelpText('after', '\n  Reads the server when you have a dashboard session, otherwise the copy in\n' +
+    '  catalog.json last synced from it. Use --slot for one slot in full:\n' +
+    '    cku models --slot agent\n')
+    .action(models_1.modelsCommand);
+// KPI manager — the pending-task board. Needs a dashboard session.
+const kpi = program
+    .command('kpi')
+    .description('KPI manager: pending tasks and metric history (needs `cku dashboard login`)');
+kpi
+    .command('agents')
+    .description('list the agents this account is scored on')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiAgentsCommand);
+kpi
+    .command('tasks')
+    .description('pending tasks, filtered and paged')
+    .option('--limit <n>', 'rows to show (default 25)')
+    .option('--severity <levels>', 'Very High | High | Medium | Low | Very Low | Negligible (comma = any of)')
+    .option('--column <cols>', `board column, comma = any of. ${KPI_COLUMNS}`)
+    .option('--agent <value>', 'agent id or name (case-insensitive substring)')
+    .option('--since <date>', 'rcaDate on or after: YYYY-MM-DD, 7d, 30d, today, thisweek')
+    .option('--until <date>', 'rcaDate on or before: same formats')
+    .option('--assigned <who>', 'assignee name, or "none" for unassigned')
+    .option('--source <src>', 'report source, e.g. nightly')
+    .option('--search <text>', 'substring of cause, fix or agent')
+    .option('--has-comments', 'only tasks that have comments')
+    .option('--with-calls', 'only tasks with attached call ids')
+    .option('--json', 'output every match as raw JSON (not paged)')
+    .action(kpi_1.kpiTasksCommand);
+kpi
+    .command('create')
+    .description('add a card to the board')
+    .requiredOption('--cause <text>', 'what went wrong — the one field the server requires')
+    .option('--fix <text>', 'recommended fix')
+    .option('--description <text>', 'longer context for the card')
+    .option('--severity <level>', 'Very High | High | Medium | Low | Very Low | Negligible')
+    .option('--column <col>', `start column (default action_items). One of: ${KPI_COLUMNS}`)
+    .option('--impact <n>', 'estimated impact, a percentage')
+    .option('--calls <ids>', 'comma-separated call ids to attach')
+    .action(kpi_1.kpiCreateCommand);
+kpi
+    .command('move')
+    .description('move a card to another column — this is also how you retire one')
+    .argument('<taskId>', 'task id, e.g. <agentId>:<date>:<n> — quote it in shells')
+    .argument('<column>', `target column: ${KPI_COLUMNS}`)
+    .option('--json', 'output raw JSON')
+    .addHelpText('after', '\n  There is no delete. "rejected" retires a card without destroying it.\n')
+    .action(kpi_1.kpiMoveCommand);
+kpi
+    .command('set')
+    .description("set a card's description (the only field the board lets you edit)")
+    .argument('<taskId>', 'task id — quote it in shells')
+    .requiredOption('--description <text>', 'the new description')
+    .option('--json', 'output raw JSON')
+    .addHelpText('after', '\n  cause, --fix and --severity are fixed at create. To correct one, create a\n' +
+    '  replacement and move the original to rejected.\n')
+    .action(kpi_1.kpiSetCommand);
+kpi
+    .command('comment')
+    .description('append a comment to a card')
+    .argument('<taskId>', 'task id — quote it in shells')
+    .argument('<text>', 'the comment')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiCommentCommand);
+kpi
+    .command('assignees')
+    .description('list the people a card can be assigned to')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiAssigneesCommand);
+kpi
+    .command('assign')
+    .description('assign a card to a person, or to AI FDE')
+    .argument('<taskId>', 'task id — quote it in shells')
+    .requiredOption('--to <who>', 'team member id or name, or "ai_fde"')
+    .option('--agent <id>', 'agent to change (required for ai_fde)')
+    .option('--versions <ids>', 'destination version ids (required for ai_fde)')
+    .option('--version-names <names>', 'display names for the version ids')
+    .option('--ab-split', 'apply across the A/B split')
+    .option('--apply-to-published', 'also apply to the published version')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiAssignCommand);
+kpi
+    .command('target')
+    .description("set an agent's KPI Manager target percentage")
+    .requiredOption('--agent <id>', 'agent id (see `cku kpi agents`)')
+    .requiredOption('--value <n>', 'the target, e.g. 25 for 25%')
+    .option('--rca-model <id>', 'model used for RCA runs')
+    .option('--rca-prompt <text>', 'RCA prompt')
+    .option('--json', 'output raw JSON')
+    .addHelpText('after', '\n  The server replaces the whole config at once, so an RCA prompt already set on\n' +
+    '  the account is read back and re-sent rather than cleared.\n')
+    .action(kpi_1.kpiTargetCommand);
+kpi
+    .command('rca')
+    .description('start an RCA run for one agent over a date range')
+    .requiredOption('--agent <id>', 'agent id — one at a time (see `cku kpi agents`)')
+    .requiredOption('--since <date>', 'start: YYYY-MM-DD, 7d, 30d, today, thisweek')
+    .requiredOption('--until <date>', 'end: same formats')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiRcaCommand);
+kpi
+    .command('show')
+    .description('show one task in full, including its recommended fix')
+    .argument('<taskId>', 'task id, e.g. <agentId>:<date>:<n> — quote it in shells')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiShowCommand);
+kpi
+    .command('history')
+    .description('metric history for the given agents')
+    .requiredOption('--agents <ids>', 'comma-separated agent ids (see `cku kpi agents`)')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiHistoryCommand);
+// Call analyzers and audit reports — also dashboard-side.
+const analyzers = program
+    .command('analyzers')
+    .description('call analyzers and audit reports (needs `cku dashboard login`)');
+analyzers
+    .command('list')
+    .description('list call analyzers')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersListCommand);
+analyzers
+    .command('show')
+    .description('show one analyzer, including its full instruction')
+    .argument('<analyzerId>', 'analyzer id')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersShowCommand);
+analyzers
+    .command('audit-reports')
+    .description('completed audit runs')
+    .option('--limit <n>', 'rows to show (default 25)')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersAuditReportsCommand);
+analyzers
+    .command('audit-strategies')
+    .description('per-strategy audit rollup')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersAuditStrategiesCommand);
+program
+    .command('config')
+    .description('show effective CLI settings and session status')
+    .action(accounts_1.configCommand);
+// --- multi-account ---------------------------------------------------------
+const accounts = program.command('accounts').description('manage multiple saved logins');
+accounts
+    .command('list', { isDefault: true })
+    .description('list saved accounts (* = active)')
+    .option('--json', 'output raw JSON')
+    .action(accounts_1.accountsCommand);
+accounts
+    .command('use <email>')
+    .description('switch the global default account (shared — avoid for parallel agents)')
+    .action(accounts_1.accountsUseCommand);
+accounts
+    .command('bind <email>')
+    .description('pin an account to this folder via .cku.json (safe for parallel agents)')
+    .option('--global', 'set the shared default instead of this folder')
+    .action(accounts_1.accountsBindCommand);
+accounts
+    .command('unbind')
+    .description("remove this folder's .cku.json binding")
+    .action(accounts_1.accountsUnbindCommand);
+accounts
+    .command('status')
+    .description('show which account is in effect and where it came from')
+    .action(accounts_1.accountsStatusCommand);
+accounts
+    .command('remove <email>')
+    .description('forget a saved login')
+    .option('--yes', 'skip confirmation')
+    .action(accounts_1.accountsRemoveCommand);
+program
+    .command('update')
+    .description('upgrade the CLI to the latest release, then refresh the skill pack')
+    .option('--skip-skills', 'update the CLI only')
+    .action(update_1.updateCommand);
+// --- secrets ---------------------------------------------------------------
+const secrets = program.command('secrets').description('manage encrypted account secrets');
+secrets.command('list').description('list secret names and masked values')
+    .option('--json', 'output raw JSON with masked values').action(secrets_1.secretsListCommand);
+secrets.command('set <name>').description('create or replace a secret using a hidden prompt')
+    .option('--stdin', 'read the secret value from stdin').action(secrets_1.secretsSetCommand);
+secrets.command('remove <name>').description('remove a secret')
+    .option('--yes', 'skip confirmation').action(secrets_1.secretsRemoveCommand);
+secrets.command('rename <oldName> <newName>').description('rename a secret without changing its value')
+    .action(secrets_1.secretsRenameCommand);
+// --- agents ----------------------------------------------------------------
+const agents = program.command('agents').description('manage voice agents');
+agents.command('list').description('list all your agents')
+    .option('--json', 'output raw JSON')
+    .option('--file <path>', 'save the agent list as JSON to a file')
+    .action(agents_1.agentsListCommand);
+agents.command('get <agentId>').description('show one agent and list its versions')
+    .option('--versions <id>', 'version id to load (first id used if a list)')
+    .option('--json', 'output raw JSON')
+    .option('--file <path>', 'save the agent detail as JSON to a file')
+    .action(agents_1.agentsGetCommand);
+agents.command('versions <agentId>').description("list an agent's versions (name, id, language, prompt type, active)")
+    .option('--json', 'output raw JSON')
+    .option('--file <path>', 'save the version list as JSON to a file')
+    .action(agents_1.agentsVersionsCommand);
+agents.command('export <agentId>').description('export agent version(s) as JSON (asks which versions)')
+    .option('--versions <ids>', 'comma-separated version IDs (skips the picker)')
+    .option('--file <path>', 'output file path (default: <agent>-<timestamp>.json)')
+    .action(agents_1.agentsExportCommand);
+agents.command('import <filepath>').description('create an agent from an exported JSON file')
+    .option('--dry-run', 'validate the file without creating anything')
+    .action(agents_1.agentsImportCommand);
+agents.command('create [json]').description('create an agent from JSON (inline, @file, --file, or stdin)')
+    .option('--file <path>', 'read the agent JSON from a file (quote-proof)')
+    .action(agents_1.agentsCreateCommand);
+agents.command('update <agentId>').description('update fields via --set \'{json}\'; version fields need --versions')
+    .option('--set <json>', "JSON object of fields (or @file.json), e.g. '{\"name\":\"x\",\"temperature\":5}'")
+    .option('--versions <id>', 'target a specific version (needed for version-level fields)')
+    .option('--commit <msg>', 'commit message for the version change')
+    .option('--json', 'output the raw updated-agent response')
+    .action(agents_1.agentsUpdateCommand);
+// Phone assignment (agent-centric). The one-inbound-agent rule is enforced server-side.
+agents.command('set-inbound <agentId>').description("add/remove an agent's inbound phone number")
+    .option('--number <id>', 'phone number id')
+    .option('--remove', 'remove instead of add')
+    .action(agentPhone_1.setInboundCommand);
+agents.command('set-outbound <agentId>').description("set/clear an agent's outbound phone number")
+    .option('--number <id>', 'phone number id')
+    .option('--clear', 'clear the outbound number')
+    .action(agentPhone_1.setOutboundCommand);
+// Version management: clone, publish, activate, A/B testing
+agents.command('clone-version <agentId>').description('clone a version with a required target prompt mode and language')
+    .option('--versions <id>', 'source version id')
+    .option('--name <name>', 'name for the new version')
+    .requiredOption('--prompt-type <type>', 'target prompt type: 0, 1, 2, or 3')
+    .requiredOption('--language <code>', 'target language: en, hi, kn, ta, te, mr, gu, bn, or ml')
+    .option('--set <json>', 'optional voice, transcriber, or silence-language overrides (or @file.json)')
+    .option('--json', 'output the raw cloned-version response')
+    .action(agentVersions_1.agentsCloneVersionCommand);
+agents.command('publish <agentId>').description('publish a version')
+    .option('--versions <id>', 'version id to publish')
+    .action(agentVersions_1.agentsPublishCommand);
+agents.command('toggle-active <agentId>').description('activate/deactivate a version')
+    .option('--versions <id>', 'version id to toggle')
+    .action(agentVersions_1.agentsToggleActiveCommand);
+agents.command('ab <agentId>').description('enable/disable A/B testing with version ratios')
+    .option('--versions <spec>', 'weighted versions, e.g. "v1=60,v2=40" (ratios must sum to 100)')
+    .option('--disable', 'turn off A/B testing')
+    .action(agentVersions_1.agentsAbCommand);
+agents.command('ab-advanced <agentId>').description('rule-based A/B: if/elseif/else on call metadata → version or language')
+    .option('--rules <json>', 'rule chain as JSON array, or @rules.json')
+    .option('--show', 'print the current rule chain')
+    .option('--disable', 'turn off advanced A/B testing')
+    .option('--json', 'raw JSON (with --show)')
+    .action(agentVersions_1.agentsAbAdvancedCommand);
+// --- chat agents -----------------------------------------------------------
+const chatAgents = program.command('chat-agents').description('manage chat agents');
+chatAgents.command('models').description('list models available for chat agents')
+    .option('--json', 'output raw JSON').option('--file <path>', 'save JSON to a file')
+    .action(chatAgents_1.chatAgentsModelsCommand);
+chatAgents.command('templates').description('list provider template names and IDs')
+    .option('--provider <provider>', 'template provider: meta, aisensy', 'meta')
+    .option('--json', 'output raw JSON').option('--file <path>', 'save JSON to a file')
+    .action(chatAgents_1.chatAgentsTemplatesCommand);
+chatAgents.command('template <templateId>').description('fetch a provider template by ID')
+    .option('--provider <provider>', 'template provider: meta, aisensy', 'meta')
+    .option('--json', 'output raw JSON').option('--file <path>', 'save JSON to a file')
+    .action(chatAgents_1.chatAgentsTemplateCommand);
+chatAgents.command('list').description('list all chat agents')
+    .option('--json', 'output raw JSON').option('--file <path>', 'save JSON to a file')
+    .action(chatAgents_1.chatAgentsListCommand);
+chatAgents.command('get <agentId>').description('show a chat agent and its published or selected version')
+    .option('--versions <id>', 'version id to load')
+    .option('--json', 'output raw JSON').option('--file <path>', 'save JSON to a file')
+    .action(chatAgents_1.chatAgentsGetCommand);
+chatAgents.command('versions <agentId>').description("list a chat agent's versions")
+    .option('--json', 'output raw JSON').option('--file <path>', 'save JSON to a file')
+    .action(chatAgents_1.chatAgentsVersionsCommand);
+chatAgents.command('create [json]').description('create a chat agent from JSON; omitted fields receive safe defaults')
+    .option('--file <path>', 'read JSON from a file')
+    .option('--json', 'output the raw response')
+    .action(chatAgents_1.chatAgentsCreateCommand);
+chatAgents.command('update <agentId>').description('update chat-agent fields from a JSON object')
+    .requiredOption('--set <json>', 'JSON object or @file.json')
+    .option('--versions <id>', 'target version id')
+    .option('--json', 'output the raw response')
+    .action(chatAgents_1.chatAgentsUpdateCommand);
+chatAgents.command('create-version <agentId> [json]').description('create a chat-agent version from JSON')
+    .option('--file <path>', 'read JSON from a file')
+    .option('--json', 'output the raw response')
+    .action(chatAgents_1.chatAgentsCreateVersionCommand);
+chatAgents.command('publish <agentId>').description('publish a chat-agent version')
+    .requiredOption('--versions <id>', 'version id to publish')
+    .option('--json', 'output the raw response')
+    .action(chatAgents_1.chatAgentsPublishCommand);
+// --- skills ----------------------------------------------------------------
+const skills = program.command('skills').description('AI skill pack for Claude Code & other agents');
+function addSkillsProviderOptions(command) {
+    return command
+        .option('--copilot', 'target GitHub Copilot')
+        .option('--gemini', 'target Gemini CLI')
+        .option('--cursor', 'target Cursor')
+        .option('--windsurf', 'target Windsurf')
+        .option('--roo', 'target Roo Code')
+        .option('--opencode', 'target OpenCode')
+        .option('--cline', 'target Cline')
+        .option('--claude', 'target Claude Code')
+        .option('--codex', 'target OpenAI Codex')
+        .option('--all', 'target every supported provider');
+}
+addSkillsProviderOptions(skills.command('install'))
+    .description('download the skill pack for one or more AI coding agents')
+    .option('--project', 'install into this project instead of your user account')
+    .option('--official', "install the upstream pack instead of this fork's")
+    .action(skills_1.skillsInstallCommand);
+addSkillsProviderOptions(skills.command('update'))
+    .description('re-download the latest skill pack (refreshes every install if no flag given)')
+    .option('--project', "update this project's copy only")
+    .option('--official', "update from the upstream pack instead of this fork's")
+    .action(skills_1.skillsUpdateCommand);
+addSkillsProviderOptions(skills.command('dir'))
+    .description('print the selected install location(s)')
+    .option('--project', 'print project location(s)')
+    .action(skills_1.skillsDirCommand);
+// --- numbers ---------------------------------------------------------------
+const numbers = program.command('numbers').description('manage phone numbers');
+numbers.command('list').description('list your phone numbers').option('--json', 'raw JSON').action(numbers_1.numbersListCommand);
+numbers.command('catalog').description('list buyable pool numbers + price').option('--json', 'raw JSON').action(numbers_1.numbersCatalogCommand);
+numbers.command('buy <numberOrPhone>').description('buy (allot) a pool number (id or phone number)')
+    .option('--yes', 'skip confirmation').action(numbers_1.numbersBuyCommand);
+numbers.command('spam <numberOrPhone>').description('mark a number as spam (id or phone number)')
+    .option('--off', 'unmark spam instead').action(numbers_1.numbersSpamCommand);
+numbers.command('unspam <numberOrPhone>').description('unmark a number as spam (id or phone number)').action(numbers_1.numbersUnspamCommand);
+numbers.command('release <numberOrPhone>').description('release (unrent) a number (id or phone number)')
+    .option('--yes', 'skip confirmation').action(numbers_1.numbersReleaseCommand);
+// Shared Call History filters (mirror the web filter panel). Applied to list + export.
+function addCallFilters(cmd) {
+    return cmd
+        .option('--type <list>', 'call type(s): inbound,outbound,outbound-api,outbound-scheduled,outbound-test,agent-test')
+        .option('--agent <ids>', 'agent id(s), comma-separated')
+        .option('--versions <ids>', 'version id(s), comma-separated')
+        .option('--start <date>', 'start date (YYYY-MM-DD)')
+        .option('--end <date>', 'end date (YYYY-MM-DD)')
+        .option('--batch <bool>', 'batch calls only: true|false')
+        .option('--hangup <list>', 'hangup reason(s), comma-separated')
+        .option('--duration <list>', 'duration bucket(s): 0,1-10,11-30,31-60,>60')
+        .option('--to <number>', 'destination number')
+        .option('--converted <bool>', 'conversion status: true|false')
+        .option('--lead <id>', 'lead id')
+        .option('--buylead <value>', 'buylead value');
+}
+/** Collect repeatable --var key=value into an array. */
+const collectVar = (val, acc) => {
+    acc.push(val);
+    return acc;
+};
+// --- voices / transcribers -------------------------------------------------
+program
+    .command('voices')
+    .description('list TTS voices, providers and models')
+    .option('--provider <p>', 'filter by an account-available provider')
+    .option('--model <m>', 'filter by voice model (e.g. sonic-3, bulbul:v3, aura-2)')
+    .option('--language <l>', 'filter by language (e.g. hi, en, hi-IN)')
+    .option('--gender <g>', 'provider-specific gender (e.g. female or feminine)')
+    .option('--query <text>', 'search provider voice names and descriptions')
+    .option('--voice-id <id>', 'filter by provider-native voice id')
+    .option('--voice-name <name>', 'filter by provider-native voice name')
+    .option('--style <style>', 'filter by voice style')
+    .option('--locale <locale>', 'filter by provider locale')
+    .option('--languages <list>', 'languages, comma-separated')
+    .option('--accent <accent>', 'filter by accent')
+    .option('--use-cases <list>', 'use cases, comma-separated')
+    .option('--category <category>', 'filter by provider category')
+    .option('--voice-type <type>', 'filter by voice ownership/type')
+    .option('--high-quality', 'only high-quality voices')
+    .option('--voice-ids <list>', 'voice ids, comma-separated')
+    .option('--collection-id <id>', 'filter by collection id')
+    .option('--sort <field>', 'provider sort field')
+    .option('--sort-direction <direction>', 'sort direction: asc | desc')
+    .option('--is-owner', 'only voices owned by the account')
+    .option('--include-archived', 'include archived voices')
+    .option('--type <type>', 'provider-specific voice type')
+    .option('--project-id <id>', 'filter by project id')
+    .option('--id <id>', 'filter by provider-native id')
+    .option('--limit <n>', 'maximum voices to return', (value) => Number(value))
+    .option('--providers', 'list providers and their models instead of voices')
+    .option('--fields', 'show the voice_configuration keys a provider takes (needs --provider)')
+    .option('--json', 'raw JSON')
+    .action(voices_1.voicesCommand);
+program
+    .command('transcribers')
+    .description('list transcriber providers, models and languages')
+    .option('--provider <p>', 'filter: soniox | deepgram | sarvam | azure | elevenlabs | groq | cartesia | gnani | callkaro')
+    .option('--language <l>', 'filter by language (e.g. hi, en, hi-IN)')
+    .option('--fields', 'show the transcriber keys a provider takes (needs --provider)')
+    .option('--all', 'include admin-gated providers')
+    .option('--json', 'raw JSON')
+    .action(transcribers_1.transcribersCommand);
+// --- calls -----------------------------------------------------------------
+const calls = program.command('calls').description('calls: place & history');
+calls.command('make').description('place a single outbound call (real, or --test)')
+    .option('--agent <id>', 'agent id to call with')
+    .option('--to <number>', 'destination phone number')
+    .option('--var <k=v>', 'call metadata variable (repeatable)', collectVar, [])
+    .option('--metadata <json>', 'metadata as a JSON object')
+    .option('--versions <id>', 'use a specific version')
+    .option('--commit <id>', 'use a specific version commit')
+    .option('--test', 'place a test call (is_test_call=true)')
+    .action(calls_1.callsMakeCommand);
+addCallFilters(calls.command('list').description('list call history'))
+    .option('--limit <n>', 'page size (default 50)')
+    .option('--json', 'raw JSON')
+    .action(calls_1.callsListCommand);
+calls.command('get <callId>').description('show one call (with recording URL)')
+    .option('--json', 'raw JSON')
+    .action(calls_1.callsGetCommand);
+calls.command('logs <callId> [query]')
+    .description("run a shell-style query over a call's raw log (grep/awk/sed/cut/sort/uniq/head/tail/wc, piped). " +
+    'Default: grep -v _trace.py /call.log | tail -100. Example: cku calls logs <id> "grep -iE \'error|warning\' /call.log"')
+    .action(calls_1.callsLogsCommand);
+addCallFilters(calls.command('export').description('export call history (same filters as the web export)'))
+    .option('--fields <list>', 'export_fields — comma-separated columns to include')
+    .option('--include-chat', 'include full chat transcript in the export')
+    .option('--file <path>', 'output file (default: calls-export-<ts>.csv)')
+    .option('--email <email>', 'email the export instead (for large datasets)')
+    .action(calls_1.callsExportCommand);
+// --- ongoing ---------------------------------------------------------------
+const ongoing = program.command('ongoing').description('ongoing/live call queues');
+ongoing.command('status').description('live queue counts per agent').option('--json', 'raw JSON').action(ongoing_1.ongoingStatusCommand);
+ongoing.command('pause').description('pause dialing (all, or --agent)').option('--agent <id>', 'one agent only')
+    .action((o) => (0, ongoing_1.ongoingControlCommand)('pause', o));
+ongoing.command('resume').description('resume dialing (all, or --agent)').option('--agent <id>', 'one agent only')
+    .action((o) => (0, ongoing_1.ongoingControlCommand)('resume', o));
+ongoing.command('clear').description('clear the queue (all, or --agent)').option('--agent <id>', 'one agent only')
+    .action((o) => (0, ongoing_1.ongoingControlCommand)('clear', o));
+// --- analytics -------------------------------------------------------------
+const analytics = program.command('analytics').description('analytics & performance');
+analytics.command('overview').description('overview metrics (mirrors the Analytics page filters)')
+    .option('--agent <ids>', 'agent id(s), comma-separated')
+    .option('--versions <ids>', 'version id(s), comma-separated')
+    .option('--type <list>', 'call type(s)')
+    .option('--voice-provider <name>', 'filter by voice provider')
+    .option('--llm-model <name>', 'filter by LLM model')
+    .option('--connected <bool>', 'connected only: true|false')
+    .option('--batch <bool>', 'batch calls only: true|false')
+    .option('--start <date>', 'start date (YYYY-MM-DD)')
+    .option('--end <date>', 'end date (YYYY-MM-DD)')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsOverviewCommand);
+analytics.command('performance').description('per-agent performance')
+    .option('--start <date>', 'start date')
+    .option('--end <date>', 'end date')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsPerformanceCommand);
+analytics.command('version <agentId>').description('per-version analytics for an agent')
+    .option('--versions <ids>', 'comma-separated version ids')
+    .option('--start <date>', 'start date')
+    .option('--end <date>', 'end date')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsVersionCommand);
+// --- batches ---------------------------------------------------------------
+const batches = program.command('batches').description('batch calls');
+batches.command('create').description('create a batch from a local CSV (uploads + starts dialing)')
+    .option('--file <path>', 'path to the CSV of leads')
+    .option('--name <name>', 'batch name')
+    .option('--agent <id>', 'agent id (omit if CSV has an x_agent_id column)')
+    .option('--language <lang>', 'batch language')
+    .option('--funnel <list>', 'funnel metric names, comma-separated')
+    .option('--workflow <id>', 'workflow id')
+    .action(batches_1.batchesCreateCommand);
+batches.command('schedule').description('schedule a batch for later (like the web Schedule flow)')
+    .option('--file <path>', 'path to the CSV of leads')
+    .option('--name <name>', 'batch name')
+    .option('--at <datetime>', 'when to dial (ISO, e.g. "2026-08-05T10:00:00+05:30"); rows may override via x_schedule_at')
+    .option('--agent <id>', 'agent id (omit if CSV has an x_agent_id column)')
+    .option('--window <HH:MM-HH:MM>', 'daily calling window (default 00:00-23:59)')
+    .option('--retries <n>', 'retries for unanswered numbers (default 0)')
+    .option('--gaps <mins>', 'gap between retries, comma-separated minutes, e.g. 30,60')
+    .option('--carry-over', 'carry unfinished calls to the next day')
+    .option('--priority <n>', 'queue priority (default 0)')
+    .option('--language <lang>', 'batch language')
+    .option('--funnel <list>', 'funnel metric names, comma-separated')
+    .option('--workflow <id>', 'workflow id')
+    .action(batches_1.batchesScheduleCommand);
+batches.command('list').description('list batches').option('--limit <n>', 'page size').option('--json', 'raw JSON')
+    .action(batches_1.batchesListCommand);
+batches.command('get <batchId>').description('show one batch').option('--json', 'raw JSON').action(batches_1.batchesGetCommand);
+batches.command('status <batchId>').description('batch progress/distribution').option('--json', 'raw JSON')
+    .action(batches_1.batchesStatusCommand);
+batches.command('send-next-try <batchId>').description('dial not-connected numbers (next try)')
+    .option('--max-try <n>', "max try count (default: batch's current tries)")
+    .action(batches_1.batchesSendNextTryCommand);
+batches.command('send-untriggered <batchId>').description('dial never-triggered numbers')
+    .action(batches_1.batchesSendUntriggeredCommand);
+batches.command('download <batchId>').description('save receipts/triggered/untriggered/not-connected rows to a file')
+    .option('--type <type>', 'receipts | triggered | untriggered | not-connected', 'receipts')
+    .option('--file <path>', 'output file (default: batch-<id>-<type>.json)')
+    .action(batches_1.batchesDownloadCommand);
+// --- simulations -----------------------------------------------------------
+const sim = program.command('sim').description('agent simulations & test cases');
+sim.command('tests <agentId>').description('list test cases').option('--json', 'raw JSON').action(simulations_1.simTestsListCommand);
+sim.command('create <agentId>').description('create a test case')
+    .option('--name <name>', 'test case name')
+    .option('--prompt <text>', 'simulated user prompt')
+    .option('--criteria <text>', 'success criteria')
+    .option('--model <model>', 'test LLM model')
+    .action(simulations_1.simCreateCommand);
+sim.command('delete <testCaseId>').description('delete a test case').option('--yes', 'skip confirmation')
+    .action(simulations_1.simDeleteCommand);
+sim.command('run <agentId>').description('run a batch simulation (async)')
+    .option('--tests <ids>', 'comma-separated test case ids')
+    .option('--versions <ids>', 'comma-separated version ids')
+    .option('--name <name>', 'run name')
+    .action(simulations_1.simRunCommand);
+sim.command('runs <agentId>').description('list simulation runs').option('--json', 'raw JSON').action(simulations_1.simRunsListCommand);
+sim.command('results <batchId>').description('results of a simulation run').option('--json', 'raw JSON')
+    .action(simulations_1.simResultsCommand);
+// --- audit strategies ------------------------------------------------------
+const audit = program.command('audit-strategies').alias('audit').description('AI Auditor audit strategies');
+audit.command('list <agentId>').description('list audit strategies for an agent').option('--json', 'raw JSON')
+    .action(auditStrategies_1.auditListCommand);
+audit.command('get <agentId> <strategyId>').description('show one audit strategy').option('--json', 'raw JSON')
+    .action(auditStrategies_1.auditGetCommand);
+audit.command('filter-options <agentId>')
+    .description('drop-off reasons, postcall filters, and hangup reasons available for the agent')
+    .option('--json', 'raw JSON')
+    .action(auditStrategies_1.auditFilterOptionsCommand);
+audit.command('models').description('list allowed audit models').option('--json', 'raw JSON').action(auditStrategies_1.auditModelsCommand);
+audit.command('create <agentId>').description('create an audit strategy')
+    .option('--name <name>', 'strategy name')
+    .option('--strategy <text>', 'free-text audit instructions for the LLM auditor (required)')
+    .option('--active', 'activate immediately (default: inactive)')
+    .option('--disable', 'keep inactive (this is already the default on create)')
+    .option('--model <provider/name>', 'audit model, from `cku audit-strategies models` (default callkaro/krishna-2.5)')
+    .option('--pct-per-hour <n>', 'percentage of eligible calls to audit each hour (default 100)')
+    .option('--max-per-hour <n>', 'max calls to audit per hour, 0 = no limit (default 0)')
+    .option('--retranscribe', 'retranscribe audio before auditing')
+    .option('--set <json>', 'JSON (or @file.json) for audit_filters/postcall_filters/extra_variables/llms')
+    .action(auditStrategies_1.auditCreateCommand);
+audit.command('update <agentId> <strategyId>').description('update an audit strategy (only named fields change)')
+    .option('--name <name>', 'strategy name')
+    .option('--strategy <text>', 'free-text audit instructions for the LLM auditor')
+    .option('--active', 'activate the strategy')
+    .option('--disable', 'deactivate the strategy')
+    .option('--model <provider/name>', 'audit model, from `cku audit-strategies models`')
+    .option('--pct-per-hour <n>', 'percentage of eligible calls to audit each hour')
+    .option('--max-per-hour <n>', 'max calls to audit per hour, 0 = no limit')
+    .option('--retranscribe', 'retranscribe audio before auditing')
+    .option('--set <json>', 'JSON (or @file.json) for audit_filters/postcall_filters/extra_variables/llms — merged onto the existing strategy')
+    .action(auditStrategies_1.auditUpdateCommand);
+program.addHelpText('after', `
+${chalk_1.default.bold('Examples:')}
+  ${chalk_1.default.cyan(`${name} register`)}   sign up and log in
+  ${chalk_1.default.cyan(`${name} login`)}      log into an existing account
+  ${chalk_1.default.cyan(`${name} accounts`)}   list saved logins (* = active)
+  ${chalk_1.default.cyan(`${name} accounts use <email>`)}  switch account
+  ${chalk_1.default.cyan(`${name} whoami`)}     see who you're logged in as
+  ${chalk_1.default.cyan(`${name} config`)}     show settings and session status
+  ${chalk_1.default.cyan(`${name} agents list`)}              list your agents in a table
+  ${chalk_1.default.cyan(`${name} agents list --json`)}       output raw JSON
+  ${chalk_1.default.cyan(`${name} agents update <agentId> --set '{"name":"New"}' --commit "rename"`)}
+  ${chalk_1.default.cyan(`${name} calls make --agent <id> --to <number> --test`)}  place a test call
+`);
+// Bare invocation → show help instead of an error.
+if (process.argv.length <= 2) {
+    program.outputHelp();
+    process.exit(0);
+}
+program.parseAsync(rewriteGetVersions(process.argv));
+/**
+ * Rewrite `agents get versions <agentId>` → `agents versions <agentId>`.
+ *
+ * `get` takes a required `<agentId>`, so commander cannot also give it a
+ * `versions` subcommand. Left alone it binds "versions" to `<agentId>`, sends
+ * that to the backend, and the ObjectId guard reports "Invalid id: not a valid
+ * id" — an error about a word the user never meant as an id. Since `agents get
+ * versions` reads naturally and has no other valid meaning, accept it.
+ *
+ * Only the exact three-token prefix is rewritten; `agents get <id> --versions x`
+ * is a different, still-valid command and must pass through untouched.
+ */
+function rewriteGetVersions(argv) {
+    const i = argv.indexOf('agents');
+    if (i === -1 || argv[i + 1] !== 'get' || argv[i + 2] !== 'versions')
+        return argv;
+    return [...argv.slice(0, i + 1), ...argv.slice(i + 2)]; // drop the 'get'
+}