callkaro-cli-unofficial 0.8.0 → 0.9.1

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,6 +61,8 @@ 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");
@@ -46,6 +81,7 @@ const adminAuth_1 = require("./lib/adminAuth");
 const admin_1 = require("./commands/admin");
 const auditStrategies_1 = require("./commands/auditStrategies");
 const chatAgents_1 = require("./commands/chatAgents");
+const updateCheck_1 = require("./lib/updateCheck");
 // 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
@@ -260,6 +296,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)')
@@ -560,6 +631,12 @@ 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')
@@ -820,6 +897,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')
@@ -879,6 +962,9 @@ agents.command('duplicate <agentId>').description('duplicate an agent under a ne
     .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);
@@ -917,6 +1003,18 @@ chatAgents.command('publish <agentId>').description('publish a chat-agent versio
     .requiredOption('--versions <id>', 'version id to publish')
     .option('--json', 'output the raw response')
     .action(chatAgents_1.chatAgentsPublishCommand);
+chatAgents.command('delete-version <agentId>').description('delete a chat-agent version and its commit history (refused if published or assigned by another version)')
+    .requiredOption('--versions <id>', 'version id to delete').option('--json', 'output the raw response').action(chatAgents_1.chatAgentsDeleteVersionCommand);
+chatAgents.command('import-versions <agentId>').description('add versions to a chat agent from exported JSON (object or array; repeat --file for several files)')
+    .requiredOption('--file <path>', 'exported JSON file', chatAgents_1.chatAgentsCollectFile).option('--json', 'output the raw response').action(chatAgents_1.chatAgentsImportVersionsCommand);
+chatAgents.command('import').description('create a chat agent from exported JSON; several versions become one agent (agent-level fields must match)')
+    .requiredOption('--file <path>', 'exported JSON file', chatAgents_1.chatAgentsCollectFile).option('--json', 'output the raw response').action(chatAgents_1.chatAgentsImportCommand);
+chatAgents.command('commits <agentId>').description("list a chat agent's version commits, newest first")
+    .option('--versions <id>', 'only this version').option('--page <n>', 'page number').option('--json', 'output raw JSON').option('--file <path>', 'save JSON to a file').action(chatAgents_1.chatAgentsCommitsCommand);
+chatAgents.command('commit <commitId>').description('show a commit (use --json for its full saved state)')
+    .option('--json', 'output raw JSON').option('--file <path>', 'save JSON to a file').action(chatAgents_1.chatAgentsCommitCommand);
+chatAgents.command('revert <agentId> <commitId>').description("set a version back to a commit's saved state")
+    .option('--json', 'output the raw response').action(chatAgents_1.chatAgentsRevertCommand);
 // --- skills ----------------------------------------------------------------
 const skills = program.command('skills').description('AI skill pack for Claude Code & other agents');
 function addSkillsProviderOptions(command) {
@@ -1016,6 +1114,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')
@@ -1269,6 +1466,7 @@ chatAudit.command('create <agentId>').description('create a chat audit strategy'
     .option('--min-user-messages <n>', 'skip conversations with fewer customer messages (default 1)')
     .option('--min-messages <n>', 'skip conversations with fewer total messages (default 2)')
     .option('--set <json|@file>', 'JSON for audit_filters/extra_variables/llms; attribute names/values: `cku contacts attributes list`')
+    .option('--chatflow-summary <text>', 'how the conversation should go (stages, required actions, outcome); the auditor judges against this, not the published version')
     .action(chatAuditStrategies_1.chatAuditCreateCommand);
 chatAudit.command('update <agentId> <strategyId>').description('update a chat audit strategy (only named fields change)')
     .option('--name <name>', 'strategy name')
@@ -1281,7 +1479,11 @@ chatAudit.command('update <agentId> <strategyId>').description('update a chat au
     .option('--min-user-messages <n>', 'skip conversations with fewer customer messages')
     .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')
+    .option('--chatflow-summary <text>', 'how the conversation should go (stages, required actions, outcome); the auditor judges against this, not the published version')
     .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)')
@@ -1405,6 +1607,7 @@ if (process.argv.length <= 2) {
     program.outputHelp();
     process.exit(0);
 }
+(0, updateCheck_1.notifyIfOutdated)(VERSION, process.argv.slice(2));
 program.parseAsync(rewriteGetVersions(process.argv));
 /**
  * Rewrite `agents get versions <agentId>` → `agents versions <agentId>`.

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 = {}) {

package/dist/lib/api.js

@@ -270,6 +270,24 @@ class Api {
     publishChatAgentVersion(agentId, versionId) {
         return this.request('POST', `/cli/chat-agents/${agentId}/publish`, { versionId });
     }
+    deleteChatAgentVersion(agentId, versionId) {
+        return this.request('DELETE', `/cli/chat-agents/${agentId}/versions/${versionId}`);
+    }
+    importChatAgentVersions(agentId, entries) {
+        return this.request('POST', `/cli/chat-agents/${agentId}/import-versions`, entries);
+    }
+    importChatAgent(entries) {
+        return this.request('POST', '/cli/chat-agents/import-multiple', entries);
+    }
+    listChatAgentCommits(agentId, opts = {}) {
+        return this.request('GET', `/cli/chat-agents/${agentId}/commits${qs(opts)}`);
+    }
+    getChatAgentCommit(commitId) {
+        return this.request('GET', `/cli/chat-agents/commits/${commitId}`);
+    }
+    revertChatAgentCommit(agentId, commitId) {
+        return this.request('POST', `/cli/chat-agents/${agentId}/commits/${commitId}/revert`, {});
+    }
     // --- whatsapp numbers -----------------------------------------------------
     // Numbers come from Meta (the linked WhatsApp Business Account), not a
     // platform pool, so there is no buy/catalog counterpart to /cli/numbers.

package/dist/lib/dashboardApi.js

@@ -487,6 +487,222 @@ class DashboardApi {
     generateWorkflowCode(body) {
         return this.request('POST', '/openai-tools/generate-workflow-code', body);
     }
+    // --- Voice preview, folders, bulk languages & postcall drop-off ------------
+    /** Render TTS audio preview (`POST /v2/agents/voice-preview`). */
+    voicePreview(voiceConfiguration, text) {
+        return this.requestBinary('POST', '/v2/agents/voice-preview', {
+            voice_configuration: voiceConfiguration,
+            text,
+        });
+    }
+    /** Create an agent folder (`POST /agent-folders`). */
+    createAgentFolder(name) {
+        return this.request('POST', '/agent-folders', { name });
+    }
+    /** Rename an agent folder (`PUT /agent-folders/:id`). */
+    renameAgentFolder(folderId, name) {
+        return this.request('PUT', `/agent-folders/${encodeURIComponent(folderId)}`, { _id: folderId, name });
+    }
+    /** Delete an agent folder (`DELETE /agent-folders/:id`). */
+    deleteAgentFolder(folderId) {
+        return this.request('DELETE', `/agent-folders/${encodeURIComponent(folderId)}`);
+    }
+    /** Move agents into a folder (`POST /agent-folders/move`). */
+    moveAgentsToFolder(agentIds, folderId) {
+        return this.request('POST', '/agent-folders/move', { agentIds, folderId });
+    }
+    /** Bulk-update switchable languages across versions (`PUT /v2/agents/:agentId/update-all-switchable-language`). */
+    updateAllSwitchableLanguage(agentId, switchableLanguages, versionIds) {
+        return this.request('PUT', `/v2/agents/${encodeURIComponent(agentId)}/update-all-switchable-language`, {
+            switchableLanguages,
+            versionIds,
+        });
+    }
+    /** Post-call variables, drop-off reasons, and versions for an agent (`GET /v2/agents/postcall/:agentId`). */
+    agentPostcallInfo(agentId) {
+        return this.request('GET', `/v2/agents/postcall/${encodeURIComponent(agentId)}`);
+    }
+    /** Get or set a custom drop-off reason description (`GET/POST /v2/agents/postcall/:agentId/other-droff-reason`). */
+    getOtherDropOffReason(agentId, versionId, dropOffReason) {
+        return this.request('GET', `/v2/agents/postcall/${encodeURIComponent(agentId)}/other-droff-reason${qs({ versionId, drop_off_reason: dropOffReason })}`);
+    }
+    setOtherDropOffReason(agentId, versionId, body) {
+        return this.request('POST', `/v2/agents/postcall/${encodeURIComponent(agentId)}/other-droff-reason${qs({ versionId })}`, body);
+    }
+    // --- Call analyzer batch runs (`/v1/batch-analysis/*`) ---------------------
+    /** List batch analysis runs (`GET /v1/batch-analysis/list`). */
+    listBatchAnalyses() {
+        return this.request('GET', '/v1/batch-analysis/list');
+    }
+    /** Create a batch analysis run (`POST /v1/batch-analysis/create`). */
+    createBatchAnalysis(body) {
+        return this.request('POST', '/v1/batch-analysis/create', body);
+    }
+    /** Calls in a batch analysis run (`GET /v1/batch-analysis/:batchId/calls`). */
+    batchAnalysisCalls(batchId, query = {}) {
+        return this.request('GET', `/v1/batch-analysis/${encodeURIComponent(batchId)}/calls${qs(query)}`);
+    }
+    // --- Chat agent commits, compare & chat audit reports ----------------------
+    /** Compare two chat agent versions (`POST /v3/chat-agents/compareVersions`). */
+    compareChatAgentVersions(versionIds) {
+        return this.request('POST', '/v3/chat-agents/compareVersions', { versionIds });
+    }
+    /** Compare two chat agent commits (`GET /v3/chat-commits/:agentId/compare?commitA=&commitB=`). */
+    compareChatAgentCommits(agentId, commitA, commitB) {
+        return this.request('GET', `/v3/chat-commits/${encodeURIComponent(agentId)}/compare${qs({ commitA, commitB })}`);
+    }
+    /** List WhatsApp chat audit report batches (`GET /v1/chat-audit-reports/batches`). */
+    chatAuditReportBatches(query = {}) {
+        return this.request('GET', `/v1/chat-audit-reports/batches${qs(query)}`);
+    }
+    // --- Inbox & Human Handoff (`/inbox/*`) ------------------------------------
+    inbox(query = {}) {
+        return this.request('GET', `/inbox${qs(query)}`);
+    }
+    inboxUnreadContacts() {
+        return this.request('GET', '/inbox/unread-contacts');
+    }
+    inboxHumanHandoffs(channel) {
+        return this.request('GET', `/inbox/human-handoffs${qs({ channel })}`);
+    }
+    inboxReleaseHandoff(body) {
+        return this.request('DELETE', '/inbox/human-handoffs', body);
+    }
+    inboxContact(phone, query = {}) {
+        return this.request('GET', `/inbox/contact/${encodeURIComponent(phone)}${qs(query)}`);
+    }
+    inboxClearContact(phone, agentPhoneNumber) {
+        return this.request('DELETE', `/inbox/contact/${encodeURIComponent(phone)}${qs({ agentPhoneNumber })}`);
+    }
+    inboxDeassignChat(body) {
+        return this.request('POST', '/inbox/deassign-chat', body);
+    }
+    inboxExport(query = {}) {
+        return this.request('GET', `/inbox/export${qs(query)}`);
+    }
+    inboxTestThreads(agentPhoneNumber) {
+        return this.request('GET', `/inbox/test-threads${qs({ agentPhoneNumber })}`);
+    }
+    // --- WhatsApp Campaigns (`/wa-campaign/*`) ---------------------------------
+    listWaCampaigns() {
+        return this.request('GET', '/wa-campaign/getWACampaign');
+    }
+    waCampaignAnalytics(id) {
+        return this.request('GET', `/wa-campaign/getWACampaignAnalytics/${encodeURIComponent(id)}`);
+    }
+    waCampaignTimeseries(id, query = {}) {
+        return this.request('GET', `/wa-campaign/getWACampaignTimeseries/${encodeURIComponent(id)}${qs(query)}`);
+    }
+    exportWaCampaignContacts(id, query = {}) {
+        return this.requestBinary('GET', `/wa-campaign/exportWACampaignContacts/${encodeURIComponent(id)}${qs(query)}`);
+    }
+    sendWaCampaign(body) {
+        return this.request('POST', '/wa-campaign/send-bulk-template-message', body);
+    }
+    // --- Fine-Tuning (`/finetune/*`) -------------------------------------------
+    listFinetuneRecords(query = {}) {
+        return this.request('GET', `/finetune/list${qs(query)}`);
+    }
+    listFinetuneBuckets() {
+        return this.request('GET', '/finetune/buckets');
+    }
+    createFinetuneBucket(name) {
+        return this.request('POST', '/finetune/buckets', { name });
+    }
+    listFinetuneJobs(query = {}) {
+        return this.request('GET', `/finetune/jobs${qs({ page: query.page || 1, pageSize: query.pageSize || 100 })}`);
+    }
+    finetuneJobStatus(jobId) {
+        return this.request('POST', '/finetune/status', { job_id: jobId });
+    }
+    startFinetuneProcess(body) {
+        return this.request('POST', '/finetune/process', body);
+    }
+    addFinetunedModel(jobId) {
+        return this.request('POST', '/finetune/add-model', { job_id: jobId });
+    }
+    cancelFinetuneJob(jobId) {
+        return this.request('POST', '/finetune/cancel', { job_id: jobId });
+    }
+    deleteFinetuneRecord(callId) {
+        return this.request('DELETE', `/finetune/delete/${encodeURIComponent(callId)}`);
+    }
+    // --- Team Management (`/team-management/*`) --------------------------------
+    listTeamMembers() {
+        return this.request('GET', '/team-management/get-members');
+    }
+    listTeamRoles() {
+        return this.request('GET', '/team-management/roles');
+    }
+    createTeamRole(body) {
+        return this.request('POST', '/team-management/roles', body);
+    }
+    addTeamMember(body) {
+        return this.request('POST', '/team-management/add-member', body);
+    }
+    updateTeamMember(id, body) {
+        return this.request('PUT', `/team-management/update-member/${encodeURIComponent(id)}`, body);
+    }
+    removeTeamMember(id) {
+        return this.request('DELETE', `/team-management/remove-member/${encodeURIComponent(id)}`);
+    }
+    updateTeamWebhook(body) {
+        return this.request('PUT', '/team-management/update-webhook', body);
+    }
+    /** Server typo: body field is `callAalysisWebhook` (missing 'n'). */
+    updateCallAnalysisWebhook(callAalysisWebhook) {
+        return this.request('PUT', '/team-management/update-call-analysis-webhook', { callAalysisWebhook });
+    }
+    // --- Compliance & Verified Phone Numbers -----------------------------------
+    listCompliance() {
+        return this.request('GET', '/compliance');
+    }
+    createCompliance(body) {
+        return this.request('POST', '/compliance', body);
+    }
+    deleteCompliance(id) {
+        return this.request('DELETE', `/compliance/${encodeURIComponent(id)}`);
+    }
+    listVerifiedNumbers() {
+        return this.request('GET', '/verified-phone-numbers');
+    }
+    addVerifiedNumber(phoneNumber) {
+        return this.request('POST', '/verified-phone-numbers/add', { phoneNumber });
+    }
+    verifyPhoneNumberOtp(phoneNumber, otp) {
+        return this.request('POST', '/verified-phone-numbers/verify', { phoneNumber, otp });
+    }
+    deleteVerifiedNumber(id) {
+        return this.request('DELETE', `/verified-phone-numbers/${encodeURIComponent(id)}`);
+    }
+    // --- Integrations (`/integrations/*`, `/shopify/*`) ------------------------
+    listIntegrations() {
+        return this.request('GET', '/integrations');
+    }
+    createIntegration(body) {
+        return this.request('POST', '/integrations', body);
+    }
+    updateIntegration(id, body) {
+        return this.request('PUT', `/integrations/${encodeURIComponent(id)}`, body);
+    }
+    deleteIntegration(id) {
+        return this.request('DELETE', `/integrations/${encodeURIComponent(id)}`);
+    }
+    listSipTrunks() {
+        return this.request('GET', '/integrations/sip');
+    }
+    setAisensyConfig(agentId) {
+        return this.request('PUT', '/integrations/aisensy/config', { agentId });
+    }
+    listAisensyCampaigns() {
+        return this.request('GET', '/integrations/aisensy/pro/campaigns');
+    }
+    setHubspotConfig(agentId) {
+        return this.request('PUT', '/integrations/hubspot-plus/config', { agentId });
+    }
+    setShopifyConfig(body) {
+        return this.request('PUT', '/shopify/config', body);
+    }
     // --- Call analyzers -------------------------------------------------------
     listAnalyzers() { return this.request('GET', '/v1/call-analyzers'); }
     // --- Audit reports (dashboard side) ---------------------------------------
@@ -516,7 +732,13 @@ function usesCookieAuth(path) {
     // version save `PUT /v2/agents/:id?version=` — takes the cookie and answers
     // the bearer with 401 (probed 21 October 2026 with getAgentVersions).
     const route = path.split('?')[0];
-    return route !== '/v2/agents/' && route !== '/v2/agents';
+    if (route === '/v2/agents/' || route === '/v2/agents')
+        return false;
+    // /knowledge/user takes the cookie, but /knowledge and DELETE /knowledge/:id
+    // take the auth-token bearer (probed live: cookie -> 401, bearer -> 200/404).
+    if (route === '/knowledge' || (route.startsWith('/knowledge/') && route !== '/knowledge/user'))
+        return false;
+    return true;
 }
 /** `?a=1&b=2`, skipping undefined and empty. Mirrors the one in api.ts. */
 function qs(params) {