callkaro-cli-unofficial 0.9.0 → 0.9.2

package/dist/commands/analytics.js

@@ -60,8 +60,12 @@ async function analyticsPerformanceCommand(opts) {
 async function analyticsVersionCommand(agentId, opts) {
     const api = (0, session_1.requireApi)();
     try {
+        if (opts.cohort && opts.cohort !== 'leads')
+            throw new Error(`--cohort must be "leads" (got "${opts.cohort}"). Omit it for the call view.`);
         const res = await api.versionAnalytics(agentId, {
             version_ids: opts.versions,
+            initial_version_ids: opts.initialVersions,
+            cohort: opts.cohort,
             startDate: opts.start,
             endDate: opts.end,
         });
@@ -71,7 +75,7 @@ async function analyticsVersionCommand(agentId, opts) {
         if (!rows.length)
             return void (0, ui_1.info)('No version analytics.');
         (0, ui_1.table)(['VERSION', 'CALLS', 'CONNECTED', 'CONVERTED', 'RECEIPT→CONV %', 'CONN→CONV %'], rows.map((r) => [
-            r._id, r.total_calls ?? '', r.connected_calls ?? '', r.converted_calls ?? '',
+            r.versionName ?? r._id, r.total_calls ?? '', r.connected_calls ?? '', r.converted_calls ?? '',
             r.overall_receipt_to_conversion_pct ?? '', r.overall_connected_to_conversion_pct ?? '',
         ]));
     }

package/dist/commands/chatAgents.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatAgentsCollectFile = void 0;
 exports.chatAgentsModelsCommand = chatAgentsModelsCommand;
 exports.chatAgentsTemplatesCommand = chatAgentsTemplatesCommand;
 exports.chatAgentsTemplateCommand = chatAgentsTemplateCommand;
@@ -44,10 +45,18 @@ exports.chatAgentsUpdateCommand = chatAgentsUpdateCommand;
 exports.chatAgentsCreateVersionCommand = chatAgentsCreateVersionCommand;
 exports.chatAgentsPublishCommand = chatAgentsPublishCommand;
 exports.chatAgentsDiffCommand = chatAgentsDiffCommand;
+exports.chatAgentsDeleteVersionCommand = chatAgentsDeleteVersionCommand;
+exports.chatAgentsImportVersionsCommand = chatAgentsImportVersionsCommand;
+exports.chatAgentsImportCommand = chatAgentsImportCommand;
+exports.chatAgentsCommitsCommand = chatAgentsCommitsCommand;
+exports.chatAgentsCommitCommand = chatAgentsCommitCommand;
+exports.chatAgentsRevertCommand = chatAgentsRevertCommand;
 const dashboardApi_1 = require("../lib/dashboardApi");
 const session_1 = require("../lib/session");
 const dashboardAuth_1 = require("../lib/dashboardAuth");
+const fs_1 = require("fs");
 const ui_1 = require("../lib/ui");
+const looseJson_1 = require("../lib/looseJson");
 const versions_1 = require("../lib/versions");
 const jsonInput_1 = require("./jsonInput");
 const dbFields_1 = require("../lib/dbFields");
@@ -271,3 +280,124 @@ async function chatAgentsDiffCommand(chatAgentId, opts) {
         (0, ui_1.handleError)(err);
     }
 }
+function readEntries(files) {
+    if (!files.length)
+        throw new Error('--file <path> is required (repeat it for several files).');
+    const entries = [];
+    for (const path of files) {
+        if (!(0, fs_1.existsSync)(path))
+            throw new Error(`File not found: ${path}`);
+        const parsed = JSON.parse((0, looseJson_1.readJsonFile)(path));
+        (Array.isArray(parsed) ? parsed : [parsed]).forEach((entry, i) => {
+            if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+                throw new Error(`${path}: entry ${i + 1} must be a JSON object.`);
+            }
+            entries.push(entry);
+        });
+    }
+    return entries;
+}
+const chatAgentsCollectFile = (value, previous = []) => [...previous, value];
+exports.chatAgentsCollectFile = chatAgentsCollectFile;
+async function chatAgentsDeleteVersionCommand(agentId, opts) {
+    const versionId = (0, versions_1.firstVersion)(opts.versions);
+    if (!versionId)
+        return (0, ui_1.handleError)(new Error('--versions <id> is required.'));
+    try {
+        const response = await (0, session_1.requireApi)().deleteChatAgentVersion(agentId, versionId);
+        if (opts.json)
+            return void console.log(JSON.stringify(response, null, 2));
+        (0, ui_1.success)(response.msg || 'Version deleted.');
+    }
+    catch (error) {
+        (0, ui_1.handleError)(error);
+    }
+}
+async function chatAgentsImportVersionsCommand(agentId, opts) {
+    try {
+        const response = await (0, session_1.requireApi)().importChatAgentVersions(agentId, readEntries(opts.file || []));
+        if (opts.json)
+            return void console.log(JSON.stringify(response, null, 2));
+        (0, ui_1.success)(response.msg || 'Versions imported.');
+        for (const v of response.newVersions || [])
+            (0, ui_1.info)(`  ${v.versionName || ''}  ${v._id}`);
+    }
+    catch (error) {
+        (0, ui_1.handleError)(error);
+    }
+}
+async function chatAgentsImportCommand(opts) {
+    try {
+        const response = await (0, session_1.requireApi)().importChatAgent(readEntries(opts.file || []));
+        if (opts.json)
+            return void console.log(JSON.stringify(response, null, 2));
+        (0, ui_1.success)(response.msg || 'Chat agent imported.');
+        if (response.chatAgent) {
+            (0, ui_1.info)(`  id:      ${response.chatAgent._id}`);
+            (0, ui_1.info)(`  version: ${response.chatAgent.versionId}`);
+        }
+    }
+    catch (error) {
+        (0, ui_1.handleError)(error);
+    }
+}
+async function chatAgentsCommitsCommand(agentId, opts) {
+    try {
+        const response = await (0, session_1.requireApi)().listChatAgentCommits(agentId, {
+            version: (0, versions_1.firstVersion)(opts.versions),
+            page: opts.page ? Number(opts.page) : undefined,
+        });
+        if (opts.file) {
+            (0, fs_1.writeFileSync)(opts.file, JSON.stringify(response, null, 2));
+            return void (0, ui_1.success)(`Saved commits for ${agentId} to ${opts.file}`);
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(response, null, 2));
+        const commits = response.commits || [];
+        if (!commits.length)
+            return void (0, ui_1.info)('No commits found.');
+        (0, ui_1.table)(['COMMIT ID', 'VERSION', 'MESSAGE', 'BY', 'WHEN'], commits.map((c) => [c._id, c.versionName || '', c.commitMessage || '', c.commited_by?.name || '', c.createdAt || '']));
+        if (response.pagination) {
+            const { page, totalPages, totalDocs } = response.pagination;
+            (0, ui_1.info)(`page ${page} of ${totalPages || 1} (${totalDocs} commits)`);
+        }
+    }
+    catch (error) {
+        (0, ui_1.handleError)(error);
+    }
+}
+async function chatAgentsCommitCommand(commitId, opts) {
+    try {
+        const response = await (0, session_1.requireApi)().getChatAgentCommit(commitId);
+        if (opts.file) {
+            (0, fs_1.writeFileSync)(opts.file, JSON.stringify(response, null, 2));
+            return void (0, ui_1.success)(`Saved commit ${commitId} to ${opts.file}`);
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(response, null, 2));
+        const c = response.commit || response;
+        (0, ui_1.keyValue)({
+            id: c._id,
+            version: c.versionName,
+            versionId: c.versionId,
+            message: c.commitMessage,
+            by: c.commited_by?.name,
+            at: c.createdAt,
+        });
+        (0, ui_1.info)('Use --json to see the full saved state.');
+    }
+    catch (error) {
+        (0, ui_1.handleError)(error);
+    }
+}
+async function chatAgentsRevertCommand(agentId, commitId, opts) {
+    try {
+        const response = await (0, session_1.requireApi)().revertChatAgentCommit(agentId, commitId);
+        if (opts.json)
+            return void console.log(JSON.stringify(response, null, 2));
+        (0, ui_1.success)(response.msg || 'Reverted.');
+    }
+    catch (error) {
+        (0, ui_1.handleError)(error);
+    }
+}

package/dist/commands/chatAuditStrategies.js

@@ -28,8 +28,10 @@ function buildFields(opts) {
         ...(opts.set ? (0, setJson_1.readSetJson)(opts.set) : {}),
         name: opts.name,
         audit_strategy: opts.strategy,
+        ...(opts.chatflowSummary !== undefined ? { chatflow_summary: opts.chatflowSummary } : {}),
         active: opts.disable ? false : opts.active,
-        llms: opts.model ? { name: opts.model } : undefined,
+        // ponytail: only add llms when --model given, so --set llms survives pruneUndefined
+        ...(opts.model ? { llms: { name: opts.model } } : {}),
         percentage_per_day: numericFlag(opts.pctPerDay, '--pct-per-day'),
         max_conversations_per_day: numericFlag(opts.maxPerDay, '--max-per-day'),
         min_user_messages: numericFlag(opts.minUserMessages, '--min-user-messages'),
@@ -63,6 +65,7 @@ async function chatAuditGetCommand(agentId, strategyId, opts) {
             id: strategy._id,
             active: strategy.active,
             audit_strategy: strategy.audit_strategy,
+            chatflow_summary: strategy.chatflow_summary,
             llms: JSON.stringify(strategy.llms),
             audit_filters: JSON.stringify(strategy.audit_filters),
             percentage_per_day: strategy.percentage_per_day,

package/dist/commands/update.js

@@ -58,7 +58,7 @@ async function updateCommand(opts) {
                 (0, ui_1.info)('Removing legacy @callkaro/cli installation …');
                 (0, child_process_1.execFileSync)(bin('npm'), ['uninstall', '--global', '@callkaro/cli'], { stdio: 'ignore', shell: win });
             }
-            (0, child_process_1.execFileSync)(bin('npm'), ['install', '--global', 'callkaro-cli-unofficial'], { stdio: 'ignore', shell: win });
+            (0, child_process_1.execFileSync)(bin('npm'), ['install', '--global', 'callkaro-cli-unofficial@latest'], { stdio: 'ignore', shell: win });
         }
         catch {
             if (win) {

package/dist/index.js

@@ -81,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
@@ -1002,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) {
@@ -1282,7 +1295,9 @@ analytics.command('performance').description('per-agent performance')
     .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('--versions <ids>', 'comma-separated final version ids')
+    .option('--initial-versions <ids>', 'comma-separated initial version ids (calls that started on these versions)')
+    .option('--cohort <view>', 'leads = Lead View (count each lead once) instead of per-call')
     .option('--start <date>', 'start date')
     .option('--end <date>', 'end date')
     .option('--json', 'raw JSON')
@@ -1453,6 +1468,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')
@@ -1465,6 +1481,7 @@ 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')
@@ -1592,6 +1609,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/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/updateCheck.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNewer = isNewer;
+exports.notifyIfOutdated = notifyIfOutdated;
+const os_1 = require("os");
+const path_1 = require("path");
+const fs_1 = require("fs");
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const CACHE = (0, path_1.join)(process.env.CK_CONFIG_DIR || (0, path_1.join)((0, os_1.homedir)(), '.config', 'callkaro-unofficial'), 'update-check.json');
+const DAY = 24 * 60 * 60 * 1000;
+const REGISTRY = 'https://registry.npmjs.org/callkaro-cli-unofficial/latest';
+/** True when `latest` is a higher x.y.z than `current` (pre-release tags ignored). */
+function isNewer(latest, current) {
+    const n = (v) => v.split('-')[0].split('.').map((x) => parseInt(x, 10) || 0);
+    const [a, b] = [n(latest), n(current)];
+    for (let i = 0; i < 3; i++) {
+        if ((a[i] || 0) !== (b[i] || 0))
+            return (a[i] || 0) > (b[i] || 0);
+    }
+    return false;
+}
+/**
+ * Tell the user (or the agent driving the CLI) when a newer release exists.
+ *
+ * Reads the answer cached by an earlier run and prints it to stderr after the
+ * command's own output, so stdout / --json stay clean. The npm lookup runs in a
+ * detached child at most once a day, so it never delays or breaks a command.
+ * Opt out with CK_NO_UPDATE_CHECK=1 (or when running under `node --test`).
+ */
+function notifyIfOutdated(current, argv) {
+    try {
+        if (process.env.CK_NO_UPDATE_CHECK || process.env.NODE_TEST_CONTEXT)
+            return;
+        if (argv.some((a) => ['update', '-v', '--version', '-h', '--help'].includes(a)))
+            return;
+        let cache = {};
+        try {
+            cache = JSON.parse((0, fs_1.readFileSync)(CACHE, 'utf8'));
+        }
+        catch {
+            /* first run */
+        }
+        if (cache.latest && isNewer(cache.latest, current)) {
+            process.on('exit', () => {
+                process.stderr.write(chalk_1.default.yellow(`\nA newer CallKaro CLI (cku) is available: ${current} -> ${cache.latest}.\n` +
+                    `AI agents: tell the user the CLI is outdated and ask if they want to upgrade; if yes, run \`cku update\`.\n`));
+            });
+        }
+        if (!cache.checkedAt || Date.now() - cache.checkedAt > DAY) {
+            const script = `
+        const fs = require('fs'), path = require('path');
+        const file = process.argv[1];
+        (async () => {
+          let latest;
+          try { latest = (await (await fetch(${JSON.stringify(REGISTRY)}, { signal: AbortSignal.timeout(5000) })).json()).version; } catch {}
+          fs.mkdirSync(path.dirname(file), { recursive: true });
+          fs.writeFileSync(file, JSON.stringify({ checkedAt: Date.now(), latest }));
+        })();`;
+            (0, child_process_1.spawn)(process.execPath, ['-e', script, CACHE], { detached: true, stdio: 'ignore' }).unref();
+        }
+    }
+    catch {
+        /* an update check must never break a command */
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "callkaro-cli-unofficial",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "license": "Apache-2.0",
   "description": "Unofficial fork of the CallKaro CLI — manage your voice AI agents from the terminal",
   "bin": {