callkaro-cli-unofficial 0.7.2 → 0.9.0

package/dist/index.js

@@ -1,5 +1,38 @@
 #!/usr/bin/env node
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -28,12 +61,18 @@ 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 px = __importStar(require("./commands/platformExtras"));
+const folders_1 = require("./commands/folders");
 const secrets_1 = require("./commands/secrets");
 const workflows_1 = require("./commands/workflows");
 const contacts_1 = require("./commands/contacts");
 const skills_1 = require("./commands/skills");
 const update_1 = require("./commands/update");
 const analytics_1 = require("./commands/analytics");
+const dnd_1 = require("./commands/dnd");
+const feedback_1 = require("./commands/feedback");
+const knowledge_1 = require("./commands/knowledge");
+const aiTools_1 = require("./commands/aiTools");
 const batches_1 = require("./commands/batches");
 const simulations_1 = require("./commands/simulations");
 const simVariables_1 = require("./commands/simVariables");
@@ -256,6 +295,41 @@ admin
     .description('clear the console-wide voice cache')
     .option('--yes', 'skip the confirmation')
     .action(admin_1.adminVoiceCacheCommand);
+admin
+    .command('bot-failures <agentId>')
+    .description('failed LLM/TTS responses (or --api: failed external API calls) for a bot')
+    .option('--api', 'show failed external API responses instead')
+    .option('--response <text>', 'drill into one failed response: list its call ids')
+    .option('--endpoint <url>', 'with --api --response: narrow to one endpoint')
+    .option('--version <id>', 'limit to one agent version')
+    .option('--start <YYYY-MM-DD>', 'window start (default: a month ago)')
+    .option('--end <YYYY-MM-DD>', 'window end (default: today)')
+    .option('--limit <n>', 'max call ids with --response', '20')
+    .option('--json', 'raw JSON')
+    .action(admin_1.adminBotFailuresCommand);
+admin.command('client-agents <clientId>').description("list a client account's agents")
+    .option('--json', 'raw JSON').action(admin_1.adminClientAgentsCommand);
+admin.command('client-versions <agentId>').description("list an agent's versions via the console")
+    .option('--json', 'raw JSON').action(admin_1.adminClientAgentVersionsCommand);
+const adminContext = admin.command('context').description('FDE reference agent library & semantic search (fde-api.callkaro.ai)');
+adminContext.command('list').description('list indexed reference versions')
+    .option('--search <text>', 'filter by version id, use case, description or tags').option('--json', 'raw JSON')
+    .action(admin_1.adminContextListCommand);
+adminContext.command('search <query>').description('semantic search over reference versions')
+    .option('--top-k <n>', 'max results', '3').option('--min-score <n>', 'minimum score', '0.5').option('--json', 'raw JSON')
+    .action(admin_1.adminContextSearchCommand);
+for (const [name, update] of [['add', false], ['update', true]]) {
+    adminContext.command(`${name} <versionId>`).description(`${update ? 'update' : 'index'} a reference version`)
+        .option('--description <text>', 'what the agent does (required)')
+        .option('--use-case <text>', 'use case label')
+        .option('--tags <csv>', 'comma-separated tags')
+        .option('--set <json|@file>', 'JSON with description/useCase/tags/metadata')
+        .option('--json', 'raw JSON')
+        .action((versionId, opts) => (0, admin_1.adminContextSetCommand)(versionId, { ...opts, update }));
+}
+adminContext.command('remove <versionId>').description('remove a reference version from the index')
+    .option('--yes', 'skip the confirmation').option('--json', 'raw JSON')
+    .action(admin_1.adminContextRemoveCommand);
 admin
     .command('api <method> <path>')
     .description('call any admin route with the stored session (the token never leaves the CLI)')
@@ -342,7 +416,8 @@ 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('--to <who>', 'team member id or name, or "ai_fde" (required unless --unassign)')
+    .option('--unassign', 'unassign the card')
     .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')
@@ -462,8 +537,73 @@ kpi
     .command('history')
     .description('metric history for the given agents')
     .requiredOption('--agents <ids>', 'comma-separated agent ids (see `cku kpi agents`)')
+    .option('--since <date>', 'start date')
+    .option('--until <date>', 'end date')
     .option('--json', 'output raw JSON')
     .action(kpi_1.kpiHistoryCommand);
+kpi.command('import').description('import KPI cards from a JSON file')
+    .requiredOption('--file <path>', 'JSON file')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiImportCommand);
+kpi.command('detach <taskId> <url>').description('remove an attachment from a card')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiDetachCommand);
+kpi.command('rca-reports').description('daywise RCA reports')
+    .option('--agent <id>', 'agent id')
+    .option('--since <date>', 'start date')
+    .option('--until <date>', 'end date')
+    .option('--source <src>', 'report source')
+    .option('--page <n>', 'page number')
+    .option('--limit <n>', 'rows per page')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiRcaReportsCommand);
+kpi.command('rca-timeline <agentId>').description('day-by-day RCA execution events')
+    .option('--since <date>', 'start date')
+    .option('--until <date>', 'end date')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiRcaTimelineCommand);
+kpi.command('rca-pdf <agentId> <rcaDate>').description('download one RCA report as PDF')
+    .option('--manual', 'the manual-run report')
+    .option('--file <path>', 'output path')
+    .action(kpi_1.kpiRcaPdfCommand);
+kpi.command('rca-draft <agentId>').description('AI-draft the RCA prompt')
+    .requiredOption('--prompt <text>', 'what the RCA should focus on')
+    .option('--save', 'save the draft to the agent KPI config')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiRcaDraftPromptCommand);
+kpi.command('add-api-source <agentId>').description('add or replace an API data source')
+    .requiredOption('--name <name>', 'source name')
+    .requiredOption('--url <url>', 'endpoint URL')
+    .option('--headers <json>', 'headers JSON or @file')
+    .option('--params <json>', 'parameters JSON or @file')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiSourceAddApiCommand);
+kpi.command('add-python-source <agentId>').description('add or replace a Python data source')
+    .requiredOption('--name <name>', 'source name')
+    .requiredOption('--code <code|@file>', 'Python code, or @file')
+    .option('--params <json>', 'parameters JSON or @file')
+    .option('--skip-verify', 'skip the verification run')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiSourceAddPythonCommand);
+kpi.command('add-expr-source <agentId>').description('add or replace an expression data source')
+    .requiredOption('--name <name>', 'source name')
+    .option('--expression <rule>', 'rule expression')
+    .option('--conditions <json>', 'conditions JSON or @file')
+    .option('--consider-for <all|unique>', 'count all calls or unique callers')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiSourceAddExprCommand);
+kpi.command('remove-source <agentId> <name>').description('remove a data source')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiSourceRemoveCommand);
+kpi.command('set-metric <agentId>').description('add or replace a metric')
+    .requiredOption('--name <name>', 'metric name')
+    .requiredOption('--source <src>', 'data source name')
+    .requiredOption('--value <val>', 'value to match')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiMetricSetCommand);
+kpi.command('remove-metric <agentId> <name>').description('remove a metric')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiMetricRemoveCommand);
 // Call analyzers and audit reports — also dashboard-side.
 const analyzers = program
     .command('analyzers')
@@ -490,6 +630,37 @@ analyzers
     .description('per-strategy audit rollup')
     .option('--json', 'output raw JSON')
     .action(analyzers_1.analyzersAuditStrategiesCommand);
+analyzers.command('batches').description('list batch analysis runs').option('--json', 'raw JSON').action(analyzers_1.analyzersBatchListCommand);
+analyzers.command('batch-create').description('start a batch analysis run')
+    .requiredOption('--set <json|@file>', 'request body').option('--json', 'raw JSON').action(analyzers_1.analyzersBatchCreateCommand);
+analyzers.command('batch-calls <batchId>').description('calls in a batch analysis run')
+    .option('--page <n>', 'page number', '1').option('--export', 'export mode').option('--json', 'raw JSON')
+    .action(analyzers_1.analyzersBatchCallsCommand);
+analyzers.command('summary <id>').description('analyzer summary rollup')
+    .option('--batch', 'id is a batch audit, not a call analyzer')
+    .option('--severity <sev>', 'filter by severity')
+    .option('--dimension <dim>', 'filter by dimension')
+    .option('--since <date>', 'start date')
+    .option('--until <date>', 'end date')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersSummaryCommand);
+analyzers.command('calls <id>').description('audited calls for an analyzer')
+    .option('--batch', 'id is a batch audit')
+    .option('--below-80', 'only calls scoring under 80')
+    .option('--severity <sev>', 'filter by severity')
+    .option('--dimension <dim>', 'filter by dimension')
+    .option('--category <cat>', 'filter by category')
+    .option('--var-name <name>', 'filter by call variable name')
+    .option('--var-value <val>', 'filter by call variable value')
+    .option('--sort <sort>', 'sort order')
+    .option('--page <n>', 'page number')
+    .option('--limit <n>', 'rows per page')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersCallsCommand);
+analyzers.command('call <id> <callId>').description('one call audit in full')
+    .option('--batch', 'id is a batch audit')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersCallDetailCommand);
 program
     .command('config')
     .description('show effective CLI settings and session status')
@@ -725,6 +896,12 @@ agents.command('set-whatsapp-outbound <agentId>').description("set/clear an agen
     .option('--clear', 'clear the outbound number')
     .action(agentPhone_1.setWhatsappOutboundCommand);
 // Version management: clone, publish, activate, A/B testing
+agents.command('set-languages <agentId>').description('set switchable languages on several versions at once (dashboard session)')
+    .requiredOption('--languages <csv>', 'language codes, e.g. en,hi')
+    .requiredOption('--versions <ids>', 'comma-separated version ids')
+    .option('--json', 'raw JSON').action(agentVersions_1.agentsSetLanguagesCommand);
+agents.command('postcall-info <agentId>').description('post-call variables and drop-off reasons (dashboard session)')
+    .option('--json', 'raw JSON').action(agentVersions_1.agentsPostcallInfoCommand);
 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')
@@ -749,8 +926,44 @@ agents.command('ab-advanced <agentId>').description('rule-based A/B: if/elseif/e
     .option('--disable', 'turn off advanced A/B testing')
     .option('--json', 'raw JSON (with --show)')
     .action(agentVersions_1.agentsAbAdvancedCommand);
+agents.command('commits <agentId>').description('commit history of an agent (needs `cku dashboard login`)')
+    .option('--versions <id>', 'limit to one version')
+    .option('--page <n>', 'page number')
+    .option('--limit <n>', 'rows per page')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsCommitsCommand);
+agents.command('commit <commitId>').description('show one commit')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsCommitShowCommand);
+agents.command('diff <agentId>').description('diff two commits or two versions')
+    .option('--commits <idA,idB>', 'two commit ids')
+    .option('--versions <vA,vB>', 'two version ids')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsDiffCommand);
+agents.command('revert <agentId> <commitId>').description('revert a version to a commit')
+    .option('--yes', 'skip confirmation')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsRevertCommand);
+agents.command('save-v2 <agentId>').description('save a version with a commit message')
+    .option('--versions <v>', 'version id')
+    .requiredOption('--set <json|@file>', 'fields to save, JSON or @file')
+    .option('--message <msg>', 'commit message')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsSaveV2Command);
+agents.command('delete-version <agentId> <versionId>').description('delete a version')
+    .option('--yes', 'skip confirmation')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsDeleteVersionCommand);
+agents.command('duplicate <agentId>').description('duplicate an agent under a new name')
+    .requiredOption('--name <name>', 'name of the copy')
+    .option('--versions <ids>', 'version ids to copy')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsDuplicateCommand);
 // --- chat agents -----------------------------------------------------------
 const chatAgents = program.command('chat-agents').description('manage chat agents');
+chatAgents.command('diff <chatAgentId>').description('compare two versions or two commits of a chat agent (dashboard session)')
+    .option('--versions <vA,vB>', 'two version ids').option('--commits <cA,cB>', 'two commit ids').option('--json', 'raw JSON')
+    .action(chatAgents_1.chatAgentsDiffCommand);
 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);
@@ -888,6 +1101,105 @@ program
     .option('--fields', 'show the voice_configuration keys a provider takes (needs --provider)')
     .option('--json', 'raw JSON')
     .action(voices_1.voicesCommand);
+program
+    .command('voice-preview')
+    .description('synthesize TTS preview audio to a file (POST /v2/agents/voice-preview)')
+    .requiredOption('--text <text>', 'text to speak')
+    .option('--agent <agentId>', 'read voice_configuration from this agent')
+    .option('--versions <versionId>', 'version of --agent')
+    .option('--set <json|@file>', 'voice_configuration JSON object')
+    .option('--file <path>', 'output audio file (default: voice_preview.mp3)')
+    .action(voices_1.voicesPreviewCommand);
+const folders = program.command('folders').description('manage agent folders (dashboard session)');
+folders.command('list').description('list folders with agent counts').option('--json', 'raw JSON').action(folders_1.foldersListCommand);
+folders.command('create <name>').description('create a folder').option('--json', 'raw JSON').action(folders_1.foldersCreateCommand);
+folders.command('rename <folderId> <name>').description('rename a folder').option('--json', 'raw JSON').action(folders_1.foldersRenameCommand);
+folders.command('delete <folderId>').description('delete a folder').option('--yes', 'skip the confirmation').option('--json', 'raw JSON').action(folders_1.foldersDeleteCommand);
+folders.command('move <folderId>').description('move agents into a folder')
+    .requiredOption('--agents <ids>', 'comma-separated agent ids').option('--json', 'raw JSON').action(folders_1.foldersMoveCommand);
+// --- Platform extras (dashboard session): inbox, wa-campaigns, finetune, team, compliance, verified-numbers, integrations ---
+const J = '--json';
+const JD = 'raw JSON';
+const YD = 'skip the confirmation';
+const inbox = program.command('inbox').description('WhatsApp/voice inbox and human handoff (dashboard session)');
+inbox.command('list').description('list inbox threads')
+    .option('--page <n>', 'page').option('--channel <c>', 'channel filter').option('--search <q>', 'search text')
+    .option('--number <agentPhone>', 'agent phone number').option('--since <date>', 'from date').option('--until <date>', 'to date')
+    .option(J, JD).action(px.inboxListCommand);
+inbox.command('unread').description('contacts with unread messages').option(J, JD).action(px.inboxUnreadCommand);
+inbox.command('handoffs').description('chats currently handed to a human')
+    .option('--channel <c>', 'channel filter').option(J, JD).action(px.inboxHandoffsCommand);
+inbox.command('release <fromId>').description('release a human handoff back to the agent')
+    .requiredOption('--channel <c>', 'channel of the handoff').option('--to-id <id>', 'hand to this id instead').option(J, JD).action(px.inboxReleaseHandoffCommand);
+inbox.command('contact <phone>').description('message history for one contact')
+    .option('--page <n>', 'page').option('--limit <n>', 'page size (default 25)')
+    .option('--number <agentPhone>', 'agent phone number').option('--channel <c>', 'channel').option(J, JD).action(px.inboxContactCommand);
+inbox.command('clear <phone>').description('delete a contact\'s chat history')
+    .option('--number <agentPhone>', 'agent phone number').option('--yes', YD).option(J, JD).action(px.inboxClearCommand);
+inbox.command('deassign <phone>').description('deassign a chat from its agent')
+    .option('--number <agentPhone>', 'agent phone number').option(J, JD).action(px.inboxDeassignCommand);
+const waCampaigns = program.command('wa-campaigns').description('WhatsApp campaigns (dashboard session)');
+waCampaigns.command('list').description('list campaigns').option(J, JD).action(px.waCampaignsListCommand);
+waCampaigns.command('analytics <id>').description('campaign analytics').option(J, JD).action(px.waCampaignAnalyticsCommand);
+waCampaigns.command('timeseries <id>').description('campaign timeseries')
+    .option('--start <date>', 'from date').option('--end <date>', 'to date').option(J, JD).action(px.waCampaignTimeseriesCommand);
+waCampaigns.command('export <id>').description('export campaign contacts to CSV')
+    .option('--fields <csv>', 'export_fields').option('--include-chat', 'include chat transcripts')
+    .option('--file <path>', 'output file (default wa_campaign_<id>.csv)').action(px.waCampaignExportCommand);
+waCampaigns.command('send').description('send a bulk template message')
+    .requiredOption('--set <json|@file>', 'request body').option(J, JD).action(px.waCampaignSendCommand);
+const finetune = program.command('finetune').description('fine-tuning records, buckets and jobs (dashboard session)');
+finetune.command('list').description('list fine-tune records').option('--page <n>', 'page').option(J, JD).action(px.finetuneListCommand);
+finetune.command('buckets').description('list buckets').option(J, JD).action(px.finetuneBucketsCommand);
+finetune.command('create-bucket <name>').description('create a bucket').option(J, JD).action(px.finetuneCreateBucketCommand);
+finetune.command('jobs').description('list jobs').option('--page <n>', 'page').option('--limit <n>', 'page size (default 100)').option(J, JD).action(px.finetuneJobsCommand);
+finetune.command('status <jobId>').description('job status').option(J, JD).action(px.finetuneStatusCommand);
+finetune.command('start').description('start a fine-tune job')
+    .requiredOption('--set <json|@file>', 'request body').option(J, JD).action(px.finetuneStartCommand);
+finetune.command('add-model <jobId>').description('register a finished job\'s model').option(J, JD).action(px.finetuneAddModelCommand);
+finetune.command('cancel <jobId>').description('cancel a job').option(J, JD).action(px.finetuneCancelCommand);
+finetune.command('delete-record <callId>').description('delete a fine-tune record')
+    .option('--yes', YD).option(J, JD).action(px.finetuneDeleteRecordCommand);
+const team = program.command('team').description('team members, roles and webhooks (dashboard session)');
+team.command('members').description('list members').option(J, JD).action(px.teamMembersCommand);
+team.command('roles').description('list roles').option(J, JD).action(px.teamRolesCommand);
+team.command('create-role <name>').description('create a role')
+    .requiredOption('--permissions <csv>', 'comma-separated permissions').option(J, JD).action(px.teamCreateRoleCommand);
+team.command('add-member').description('add a member')
+    .requiredOption('--name <name>', 'name').requiredOption('--email <email>', 'email')
+    .option('--password <pw>', 'password').option('--permissions <csv>', 'comma-separated permissions').option(J, JD).action(px.teamAddMemberCommand);
+team.command('update-member <id>').description('update a member')
+    .option('--name <name>', 'name').option('--email <email>', 'email').option('--password <pw>', 'password')
+    .option('--permissions <csv>', 'comma-separated permissions').option(J, JD).action(px.teamUpdateMemberCommand);
+team.command('remove-member <id>').description('remove a member').option('--yes', YD).option(J, JD).action(px.teamRemoveMemberCommand);
+team.command('set-webhook').description('set the team webhook and/or call-analysis webhook')
+    .option('--url <url>', 'team webhook URL').option('--analysis-url <url>', 'call analysis webhook URL')
+    .option('--headers <k:v,...>', 'webhook headers as Key:Value pairs').option('--events <csv>', 'webhook events').option(J, JD).action(px.teamSetWebhookCommand);
+const compliance = program.command('compliance').description('compliance records (dashboard session)');
+compliance.command('list').description('list records').option(J, JD).action(px.complianceListCommand);
+compliance.command('create').description('create a record')
+    .requiredOption('--gst <number>', 'GST number').requiredOption('--username <name>', 'username').requiredOption('--company <name>', 'company name')
+    .option('--gst-url <url>', 'GST file URL').option('--cin-url <url>', 'CIN file URL').option(J, JD).action(px.complianceCreateCommand);
+compliance.command('delete <id>').description('delete a record').option('--yes', YD).option(J, JD).action(px.complianceDeleteCommand);
+const verified = program.command('verified-numbers').description('verified phone numbers (dashboard session)');
+verified.command('list').description('list numbers').option(J, JD).action(px.verifiedNumbersListCommand);
+verified.command('add <phoneNumber>').description('add a number (sends an OTP)').option(J, JD).action(px.verifiedNumbersAddCommand);
+verified.command('verify <phoneNumber>').description('confirm a number with its OTP')
+    .requiredOption('--otp <code>', 'OTP received').option(J, JD).action(px.verifiedNumbersVerifyCommand);
+verified.command('delete <id>').description('delete a number').option('--yes', YD).option(J, JD).action(px.verifiedNumbersDeleteCommand);
+const integrations = program.command('integrations').description('third-party integrations (dashboard session)');
+integrations.command('list').description('list integrations').option(J, JD).action(px.integrationsListCommand);
+integrations.command('create').description('create an integration')
+    .requiredOption('--type <type>', 'integration type').option('--set <json|@file>', 'credentials JSON').option('--tag <tag>', 'tag').option(J, JD).action(px.integrationsCreateCommand);
+integrations.command('update <id>').description('update an integration')
+    .option('--type <type>', 'integration type').option('--set <json|@file>', 'credentials JSON').option('--tag <tag>', 'tag').option(J, JD).action(px.integrationsUpdateCommand);
+integrations.command('delete <id>').description('delete an integration').option('--yes', YD).option(J, JD).action(px.integrationsDeleteCommand);
+integrations.command('sip').description('list SIP trunks').option(J, JD).action(px.integrationsSipCommand);
+integrations.command('aisensy').description('list AiSensy campaigns, or link an agent with --agent')
+    .option('--agent <agentId>', 'link this agent').option('--campaigns', 'list campaigns (default)').option(J, JD).action(px.integrationsAisensyCommand);
+integrations.command('hubspot <agentId>').description('link HubSpot to an agent').option(J, JD).action(px.integrationsHubspotCommand);
+integrations.command('shopify').description('save Shopify config')
+    .requiredOption('--set <json|@file>', 'config JSON').option(J, JD).action(px.integrationsShopifyCommand);
 program
     .command('transcribers')
     .description('list transcriber providers, models and languages')
@@ -975,6 +1287,26 @@ analytics.command('version <agentId>').description('per-version analytics for an
     .option('--end <date>', 'end date')
     .option('--json', 'raw JSON')
     .action(analytics_1.analyticsVersionCommand);
+analytics.command('failed-responses').description('failed-response buckets (needs `cku dashboard login`)')
+    .option('--agent <ids>', 'agent id(s), comma-separated')
+    .option('--start <YYYY-MM-DD>', 'start date')
+    .option('--end <YYYY-MM-DD>', 'end date')
+    .option('--response <bucket>', 'drill into one bucket')
+    .option('--limit <n>', 'rows')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsFailedResponsesCommand);
+analytics.command('functions').description('function-call stats (needs `cku dashboard login`)')
+    .option('--agent <ids>', 'agent id(s), comma-separated')
+    .option('--start <YYYY-MM-DD>', 'start date')
+    .option('--end <YYYY-MM-DD>', 'end date')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsFunctionsCommand);
+analytics.command('chat').description('chat agent analytics (needs `cku dashboard login`)')
+    .option('--agent <id>', 'chat agent id')
+    .option('--start <YYYY-MM-DD>', 'start date')
+    .option('--end <YYYY-MM-DD>', 'end date')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsChatCommand);
 // --- batches ---------------------------------------------------------------
 const batches = program.command('batches').description('batch calls');
 batches.command('create').description('create a batch from a local CSV (uploads + starts dialing)')
@@ -1052,6 +1384,19 @@ sim.command('results <batchId>').description('results of a simulation run').opti
     .option('--agent <agentId>', 'with --wait, the agent the batch belongs to')
     .option('--timeout <seconds>', 'with --wait, give up after this long (default 600)')
     .action(simulations_1.simResultsCommand);
+sim.command('draft-from-call <callId>').description('AI-draft a test case from a real call (needs `cku dashboard login`)')
+    .requiredOption('--version <versionId>', 'agent version the call ran on')
+    .option('--no-metadata', 'leave out call metadata')
+    .option('--no-functions', 'leave out function mocks')
+    .option('--save', 'save the draft as a test case')
+    .option('--json', 'raw JSON')
+    .action(simulations_1.simDraftFromCallCommand);
+sim.command('generate <agentId>').description('AI-draft a test case from a hint (needs `cku dashboard login`)')
+    .requiredOption('--hint <text>', 'scenario to test')
+    .option('--version <versionId>', 'agent version')
+    .option('--save', 'save the draft as a test case')
+    .option('--json', 'raw JSON')
+    .action(simulations_1.simGenerateCommand);
 // Saved variable sets are dashboard-only (cookie-authed): they need `cku dashboard login`.
 const simVars = sim.command('variables').description('saved variable sets for test cases (needs `cku dashboard login`)');
 simVars.command('list <agentId>').description('list saved variable sets').option('--json', 'raw JSON')
@@ -1121,6 +1466,9 @@ chatAudit.command('update <agentId> <strategyId>').description('update a chat au
     .option('--min-messages <n>', 'skip conversations with fewer total messages')
     .option('--set <json|@file>', 'JSON for audit_filters/extra_variables/llms; each replaces the stored value')
     .action(chatAuditStrategies_1.chatAuditUpdateCommand);
+chatAudit.command('reports').description('list chat audit report batches (dashboard session)')
+    .option('--agent <id>', 'chat agent id').option('--page <n>', 'page number').option('--json', 'raw JSON')
+    .action(chatAuditStrategies_1.chatAuditReportsCommand);
 chatAudit.command('delete <strategyId>').description('delete a chat audit strategy').action(chatAuditStrategies_1.chatAuditDeleteCommand);
 chatAudit.command('batch <agentId> <strategyId>')
     .description('audit up to N conversations now (uses credits; only messages since each last audit)')
@@ -1174,6 +1522,71 @@ ${chalk_1.default.bold('Examples:')}
   ${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
 `);
+// --- DND, feedback, knowledge, AI helpers (dashboard session) ---------------
+const dnd = program.command('dnd').description('do-not-disturb list (needs `cku dashboard login`)');
+dnd.command('list').description('list DND numbers')
+    .option('--page <n>', 'page').option('--limit <n>', 'rows').option('--search <text>', 'search')
+    .option('--since <date>', 'from').option('--until <date>', 'to').option('--json', 'raw JSON')
+    .action(dnd_1.dndListCommand);
+dnd.command('add <phone>').description('add a number').option('--json', 'raw JSON').action(dnd_1.dndAddCommand);
+dnd.command('update <id> <phone>').description('change a number').option('--json', 'raw JSON').action(dnd_1.dndUpdateCommand);
+dnd.command('remove <ids>').description('remove entries (comma-separated ids)')
+    .option('--yes', 'skip confirmation').option('--json', 'raw JSON').action(dnd_1.dndRemoveCommand);
+dnd.command('import').description('bulk add numbers')
+    .option('--phones <csv>', 'comma-separated numbers')
+    .option('--file <path>', 'file with numbers (comma/newline list or JSON array)')
+    .option('--json', 'raw JSON').action(dnd_1.dndImportCommand);
+const feedback = program.command('feedback').description('call feedback tickets (needs `cku dashboard login`)');
+feedback.command('list').description('list tickets')
+    .option('--status <status>', 'ticket status (default processing)').option('--page <n>', 'page').option('--json', 'raw JSON')
+    .action(feedback_1.feedbackListCommand);
+feedback.command('create').description('open a ticket about a call')
+    .option('--call <callId>', 'call with the issue')
+    .option('--version <versionId>', 'agent version')
+    .option('--engineer <id>', 'engineer to assign')
+    .option('--name <title>', 'ticket title')
+    .option('--issue <text>', 'what went wrong')
+    .option('--json', 'raw JSON')
+    .action(feedback_1.feedbackCreateCommand);
+feedback.command('comment <id> <text>').description('comment on a ticket').option('--json', 'raw JSON').action(feedback_1.feedbackCommentCommand);
+feedback.command('submit-review <id>').description('submit a ticket for review')
+    .option('--calls <urls>', 'resolved call URLs, comma-separated')
+    .option('--version-url <url>', 'resolved version URL')
+    .option('--comment <text>', 'comment')
+    .option('--json', 'raw JSON')
+    .action(feedback_1.feedbackSubmitReviewCommand);
+feedback.command('reopen <id>').description('reopen a ticket')
+    .option('--comment <text>', 'why').option('--json', 'raw JSON').action(feedback_1.feedbackReopenCommand);
+feedback.command('resolve <id>').description('resolve a ticket')
+    .option('--comment <text>', 'comment').option('--json', 'raw JSON').action(feedback_1.feedbackResolveCommand);
+const knowledge = program.command('knowledge').description('knowledge base (needs `cku dashboard login`)');
+knowledge.command('list').description('list knowledge documents').option('--json', 'raw JSON').action(knowledge_1.knowledgeListCommand);
+knowledge.command('delete <id>').description('delete a document')
+    .option('--yes', 'skip confirmation').option('--json', 'raw JSON').action(knowledge_1.knowledgeDeleteCommand);
+const ai = program.command('ai').description('AI drafting helpers (needs `cku dashboard login`)');
+ai.command('function').description('draft function code from a prompt')
+    .option('--prompt <text>', 'what the function should do')
+    .option('--name <name>', 'function name').option('--description <desc>', 'function description')
+    .option('--type <type>', 'function type')
+    .option('--code <code|@file>', 'existing code to edit')
+    .option('--vars <csv>', 'prompt variables, comma-separated')
+    .option('--chat', 'chat-agent function')
+    .option('--json', 'raw JSON')
+    .action(aiTools_1.aiGenerateFunctionCommand);
+ai.command('postcall').description('draft post-call config')
+    .option('--set <json|@file>', 'request body, JSON or @file').option('--json', 'raw JSON')
+    .action(aiTools_1.aiGeneratePostcallCommand);
+ai.command('audit-strategy <agentId>').description('draft an audit strategy for an agent')
+    .option('--prompt <text>', 'guidance').option('--existing <text>', 'existing strategy to refine').option('--json', 'raw JSON')
+    .action(aiTools_1.aiGenerateAuditStrategyCommand);
+ai.command('callflow-summary <agentId>').description('draft a call-flow summary for an agent')
+    .option('--prompt <text>', 'guidance').option('--existing <text>', 'existing summary to refine').option('--json', 'raw JSON')
+    .action(aiTools_1.aiGenerateCallflowSummaryCommand);
+ai.command('workflow-code').description('draft workflow step code')
+    .option('--prompt <text>', 'what the step should do').option('--name <name>', 'step name')
+    .option('--key <key>', 'step key').option('--existing <code|@file>', 'existing code')
+    .option('--json', 'raw JSON')
+    .action(aiTools_1.aiGenerateWorkflowCodeCommand);
 // Bare invocation → show help instead of an error.
 if (process.argv.length <= 2) {
     program.outputHelp();

package/dist/lib/adminApi.js

@@ -42,6 +42,7 @@ const adminAuth_1 = require("./adminAuth");
  * `err.status` the same way on every surface. Extends Error so existing
  * `handleError` paths and message-based assertions keep working.
  */
+const FDE_URL = process.env.CK_FDE_URL || 'https://fde-api.callkaro.ai';
 class AdminError extends Error {
     status;
     data;
@@ -68,7 +69,8 @@ class AdminApi {
      * per request rather than once at construction: it is what proves the stored
      * 24h session is still valid, and a long-lived client must not outlive it.
      */
-    async request(method, path, body) {
+    async request(method, path, body, hostOverride) {
+        const base = hostOverride || this.baseUrl;
         // baseUrl + path is the whole URL, so a path that does not start with "/"
         // can rewrite the host ("https://backend.callkaro.ai" + "@evil.com/x") and
         // carry the session cookie with it.
@@ -81,7 +83,7 @@ class AdminApi {
         };
         let res;
         try {
-            res = await fetch(`${this.baseUrl}${path}`, {
+            res = await fetch(`${base}${path}`, {
                 method,
                 headers,
                 body: body === undefined ? undefined : JSON.stringify(body),
@@ -91,7 +93,7 @@ class AdminApi {
             });
         }
         catch (err) {
-            throw new Error(`Cannot reach ${this.baseUrl} (${err.message})`);
+            throw new Error(`Cannot reach ${base} (${err.message})`);
         }
         const text = await res.text();
         let data;
@@ -196,6 +198,51 @@ class AdminApi {
     botFunctions(query = {}) {
         return this.request('GET', `/monitor/bots/functions${qs(query)}`);
     }
+    /** List agents belonging to one or more client user_ids (`GET /monitor/agents?user_ids=`). */
+    clientAgents(userIds) {
+        return this.request('GET', `/monitor/agents${qs({ user_ids: userIds })}`);
+    }
+    /** List versions of an agent from monitor (`GET /monitor/agents/:agentId/versions`). */
+    clientAgentVersions(agentId) {
+        return this.request('GET', `/monitor/agents/${encodeURIComponent(agentId)}/versions`);
+    }
+    /** Failed LLM/TTS response buckets for a bot (`GET /monitor/bots/:agentId/failed-responses`). */
+    botFailedResponses(agentId, query = {}) {
+        return this.request('GET', `/monitor/bots/${encodeURIComponent(agentId)}/failed-responses${qs(query)}`);
+    }
+    /** Call ids that hit a specific failed response (`GET /monitor/bots/:agentId/failed-response-calls`). */
+    botFailedResponseCalls(agentId, query) {
+        return this.request('GET', `/monitor/bots/${encodeURIComponent(agentId)}/failed-response-calls${qs(query)}`);
+    }
+    /** Failed external API endpoints for a bot (`GET /monitor/bots/:agentId/failed-api-responses`). */
+    botFailedApiResponses(agentId, query = {}) {
+        return this.request('GET', `/monitor/bots/${encodeURIComponent(agentId)}/failed-api-responses${qs(query)}`);
+    }
+    /** Call ids that hit a failed API response (`GET /monitor/bots/:agentId/failed-api-response-calls`). */
+    botFailedApiResponseCalls(agentId, query) {
+        return this.request('GET', `/monitor/bots/${encodeURIComponent(agentId)}/failed-api-response-calls${qs(query)}`);
+    }
+    // --- FDE reference library (`https://fde-api.callkaro.ai/monitor/agent-context`) ---
+    /** List all curated reference agent versions in the FDE library. */
+    listAgentContext() {
+        return this.request('GET', '/monitor/agent-context', undefined, FDE_URL);
+    }
+    /** Semantic search over reference agent versions (`GET .../monitor/agent-context/search`). */
+    searchAgentContext(query) {
+        return this.request('GET', `/monitor/agent-context/search${qs(query)}`, undefined, FDE_URL);
+    }
+    /** Index a new reference agent version (`POST .../monitor/agent-context`). */
+    createAgentContext(body) {
+        return this.request('POST', '/monitor/agent-context', body, FDE_URL);
+    }
+    /** Update an indexed reference agent version (`PUT .../monitor/agent-context/:versionId`). */
+    updateAgentContext(versionId, body) {
+        return this.request('PUT', `/monitor/agent-context/${encodeURIComponent(versionId)}`, body, FDE_URL);
+    }
+    /** Remove a reference agent version from the index (`DELETE .../monitor/agent-context/:versionId`). */
+    deleteAgentContext(versionId) {
+        return this.request('DELETE', `/monitor/agent-context/${encodeURIComponent(versionId)}`, undefined, FDE_URL);
+    }
     // --- observability --------------------------------------------------------
     /** Sentry transactions over the last 24h. */
     sentryTransactions(query = {}) {