callkaro-cli-unofficial 0.1.0

package/dist/commands/calls.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCallQuery = buildCallQuery;
+exports.callsListCommand = callsListCommand;
+exports.callsGetCommand = callsGetCommand;
+exports.callsLogsCommand = callsLogsCommand;
+exports.callsMakeCommand = callsMakeCommand;
+exports.callsExportCommand = callsExportCommand;
+const fs_1 = require("fs");
+const session_1 = require("../lib/session");
+const ui_1 = require("../lib/ui");
+const versions_1 = require("../lib/versions");
+const logQuery_1 = require("../lib/logQuery");
+function fmtTime(v) {
+    if (!v)
+        return '';
+    const d = new Date(v);
+    return isNaN(d.getTime()) ? '' : d.toLocaleString('en-US');
+}
+function buildCallQuery(o) {
+    return {
+        name: o.type,
+        agent_id: o.agent,
+        version_ids: o.versions,
+        start_date: o.start,
+        end_date: o.end,
+        is_batch_call: o.batch,
+        hangup_reasons: o.hangup,
+        call_duration: o.duration,
+        to: o.to,
+        conversion_status: o.converted,
+        lead_id: o.lead,
+        buylead: o.buylead,
+    };
+}
+async function callsListCommand(opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.listCalls({
+            ...buildCallQuery(opts),
+            pageSize: (0, ui_1.intFlag)(opts.limit, '--limit', 50),
+            page: 1,
+        });
+        const calls = res.calls || [];
+        if (opts.json)
+            return void console.log(JSON.stringify(calls, null, 2));
+        if (!calls.length)
+            return void (0, ui_1.info)('No calls found.');
+        (0, ui_1.table)(['TYPE', 'FROM', 'TO', 'AGENT', 'VERSION', 'DURATION', 'HANGUP', 'TIME'], calls.map((c) => [
+            c.name || '',
+            c.from || '',
+            c.to || '',
+            c.agent?.name || '',
+            c.versionId?.versionName || '',
+            c.call_duration ?? '',
+            c.hangup_reason || '',
+            fmtTime(c.createdAt || c.time),
+        ]));
+        if (res.pagination)
+            (0, ui_1.info)(`\n${calls.length} of ${res.pagination.totalDocs} calls.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function callsGetCommand(callId, opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.getCall(callId);
+        const call = (res.calls && res.calls[0]) || null;
+        if (!call)
+            return (0, ui_1.handleError)(new Error('Call not found'));
+        // Never surface the blob URL — `cku calls logs` fetches it internally.
+        const { logfile_url: _logfileUrl, ...safeCall } = call;
+        if (opts.json)
+            return void console.log(JSON.stringify(safeCall, null, 2));
+        (0, ui_1.keyValue)({
+            id: call._id,
+            type: call.name,
+            from: call.from,
+            to: call.to,
+            agent: call.agent?.name,
+            version: call.versionId?.versionName,
+            duration: call.call_duration,
+            hangupReason: call.hangup_reason,
+            disposition: call.disposition_reason,
+            credits: call.total_credits,
+            recording: call.recording?.recordingUrl,
+            time: fmtTime(call.createdAt || call.time),
+        });
+        if (call.recording?.transcription)
+            (0, ui_1.info)('\nUse --json to see the full transcript.');
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+const DEFAULT_LOG_QUERY = 'grep -v _trace.py /call.log | tail -100';
+/**
+ * `cku calls logs <callId> [query]` — a shell-style query over the call's raw
+ * log. The log is downloaded fresh each run and never printed or written to
+ * disk; only the query's output is shown.
+ */
+async function callsLogsCommand(callId, query) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.getCall(callId);
+        const call = (res.calls && res.calls[0]) || null;
+        if (!call)
+            return (0, ui_1.handleError)(new Error('Call not found'));
+        let text;
+        try {
+            text = await (0, logQuery_1.getLogText)(call);
+        }
+        catch (err) {
+            if (err instanceof logQuery_1.LogNotFoundError)
+                return (0, ui_1.handleError)(new Error((0, logQuery_1.unavailableReason)(call)));
+            throw err;
+        }
+        const { result, truncated } = await (0, logQuery_1.runLogQuery)(text, query || DEFAULT_LOG_QUERY);
+        console.log(result);
+        if (truncated)
+            (0, ui_1.fail)('Output truncated — narrow the query (e.g. add | head, or a tighter grep).');
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function callsMakeCommand(opts) {
+    const api = (0, session_1.requireApi)();
+    if (!opts.agent)
+        return (0, ui_1.handleError)(new Error('--agent <agentId> is required'));
+    if (!opts.to)
+        return (0, ui_1.handleError)(new Error('--to <phoneNumber> is required'));
+    // Metadata from --metadata JSON, overlaid with --var key=value pairs.
+    let metadata = {};
+    if (opts.metadata) {
+        try {
+            metadata = JSON.parse(opts.metadata);
+        }
+        catch (e) {
+            return (0, ui_1.handleError)(new Error(`--metadata is not valid JSON: ${e.message}`));
+        }
+    }
+    for (const pair of opts.var || []) {
+        const idx = pair.indexOf('=');
+        if (idx === -1)
+            return (0, ui_1.handleError)(new Error(`Bad --var "${pair}" — use key=value`));
+        metadata[pair.slice(0, idx)] = pair.slice(idx + 1);
+    }
+    try {
+        const res = await api.makeCall({
+            agentId: opts.agent,
+            to: opts.to,
+            metadata,
+            version: (0, versions_1.firstVersion)(opts.versions),
+            commit_id: opts.commit,
+            is_test_call: opts.test,
+        });
+        (0, ui_1.success)(res.msg || `Call placed to ${opts.to}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function callsExportCommand(opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.exportCalls({
+            ...buildCallQuery(opts),
+            export_fields: opts.fields,
+            include_chat_history: opts.includeChat ? 'true' : undefined,
+            user_email: opts.email,
+        });
+        // Email path or "too large" → server responds JSON, not a file.
+        if (res.json) {
+            if (res.ok)
+                return void (0, ui_1.success)(res.json.msg || 'Export requested (check your email).');
+            if (res.status === 409) {
+                return (0, ui_1.handleError)(new Error('Export too large — re-run with --email <you@example.com> to receive it by email.'));
+            }
+            return (0, ui_1.handleError)(new Error(res.json.msg || `Export failed (${res.status})`));
+        }
+        if (!res.ok || !res.buffer)
+            return (0, ui_1.handleError)(new Error(`Export failed (${res.status})`));
+        const out = opts.file || `calls-export-${Date.now()}.csv`;
+        (0, fs_1.writeFileSync)(out, res.buffer);
+        (0, ui_1.success)(`Exported call history to ${out}`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/commands/chatAgents.js

@@ -0,0 +1,251 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatAgentsModelsCommand = chatAgentsModelsCommand;
+exports.chatAgentsTemplatesCommand = chatAgentsTemplatesCommand;
+exports.chatAgentsTemplateCommand = chatAgentsTemplateCommand;
+exports.chatAgentsListCommand = chatAgentsListCommand;
+exports.chatAgentsGetCommand = chatAgentsGetCommand;
+exports.chatAgentsVersionsCommand = chatAgentsVersionsCommand;
+exports.chatAgentsCreateCommand = chatAgentsCreateCommand;
+exports.chatAgentsUpdateCommand = chatAgentsUpdateCommand;
+exports.chatAgentsCreateVersionCommand = chatAgentsCreateVersionCommand;
+exports.chatAgentsPublishCommand = chatAgentsPublishCommand;
+const session_1 = require("../lib/session");
+const dashboardAuth_1 = require("../lib/dashboardAuth");
+const ui_1 = require("../lib/ui");
+const versions_1 = require("../lib/versions");
+const jsonInput_1 = require("./jsonInput");
+const dbFields_1 = require("../lib/dbFields");
+async function chatAgentsModelsCommand(opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.listChatAgentModels();
+        const rows = res.models || res.data || [];
+        if (opts.file) {
+            (await Promise.resolve().then(() => __importStar(require('fs')))).writeFileSync(opts.file, JSON.stringify(rows, null, 2));
+            return void (0, ui_1.success)(`Saved ${rows.length} model(s) to ${opts.file}`);
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(rows, null, 2));
+        if (!rows.length)
+            return void (0, ui_1.info)('No chat-agent models available.');
+        (0, ui_1.table)(['PROVIDER', 'MODEL'], rows.map((m) => [m.provider || '', m.name || m.id || m.model || '']));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function chatAgentsTemplatesCommand(opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.listChatAgentTemplates(opts.provider || 'meta');
+        const rows = res.templates || [];
+        if (opts.file) {
+            (await Promise.resolve().then(() => __importStar(require('fs')))).writeFileSync(opts.file, JSON.stringify(rows, null, 2));
+            return void (0, ui_1.success)(`Saved ${rows.length} template(s) to ${opts.file}`);
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(rows, null, 2));
+        if (!rows.length)
+            return void (0, ui_1.info)('No templates found.');
+        (0, ui_1.table)(['ID', 'NAME', 'LANGUAGE', 'CATEGORY', 'STATUS'], rows.map((t) => [t.id || '', t.name || '', t.language || '', t.category || '', t.status || '']));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function chatAgentsTemplateCommand(templateId, opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.getChatAgentTemplate(templateId, opts.provider || 'meta');
+        if (opts.file) {
+            (await Promise.resolve().then(() => __importStar(require('fs')))).writeFileSync(opts.file, JSON.stringify(res.template, null, 2));
+            return void (0, ui_1.success)(`Saved template to ${opts.file}`);
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(res.template, null, 2));
+        const t = res.template;
+        for (const [k, v] of Object.entries(t)) {
+            if (v === undefined || v === null)
+                continue;
+            console.log(`  ${String(k).padEnd(20)} ${typeof v === 'object' ? JSON.stringify(v) : v}`);
+        }
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function chatAgentsListCommand(opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.listChatAgents();
+        const list = res.chatAgents || res.agents || [];
+        if (opts.file) {
+            (await Promise.resolve().then(() => __importStar(require('fs')))).writeFileSync(opts.file, JSON.stringify(list, null, 2));
+            return void (0, ui_1.success)(`Saved ${list.length} chat agent(s) to ${opts.file}`);
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(list, null, 2));
+        if (!list.length)
+            return void (0, ui_1.info)('No chat agents yet.');
+        (0, ui_1.table)(['NAME', 'ID', 'STATUS', 'PUBLISHED'], list.map((a) => [a.name || '(unnamed)', a._id, a.agentStatus || '', a.publishedVersionId || '']));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function chatAgentsGetCommand(agentId, opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.getChatAgent(agentId, (0, versions_1.firstVersion)(opts.versions));
+        const agent = res.agent || res.chatAgent || {};
+        if (opts.file) {
+            (await Promise.resolve().then(() => __importStar(require('fs')))).writeFileSync(opts.file, JSON.stringify(agent, null, 2));
+            return void (0, ui_1.success)(`Saved chat agent ${agentId} to ${opts.file}`);
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(agent, null, 2));
+        for (const [k, v] of Object.entries(agent)) {
+            if (v === undefined || v === null)
+                continue;
+            if (typeof v === 'object')
+                continue;
+            console.log(`  ${String(k).padEnd(24)} ${v}`);
+        }
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function chatAgentsVersionsCommand(agentId, opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const res = await api.listChatAgentVersions(agentId);
+        const versions = res.versions || res || [];
+        if (opts.file) {
+            (await Promise.resolve().then(() => __importStar(require('fs')))).writeFileSync(opts.file, JSON.stringify(versions, null, 2));
+            return void (0, ui_1.success)(`Saved ${versions.length} version(s) to ${opts.file}`);
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(versions, null, 2));
+        if (!versions.length)
+            return void (0, ui_1.info)('No versions yet.');
+        (0, ui_1.table)(['VERSION', 'ID', 'ACTIVE'], versions.map((v) => [v.versionName || '', v._id, v.is_active ? 'yes' : 'no']));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** Shared: resolve a JSON arg, reject db-managed fields, require `name`. */
+async function readChatAgentJson(json, file, label) {
+    const resolved = await (0, jsonInput_1.resolveJsonInput)(json, file);
+    let obj;
+    try {
+        obj = (0, jsonInput_1.parseJsonInput)(resolved);
+    }
+    catch (e) {
+        throw new Error(`Not valid JSON: ${e.message}${(0, jsonInput_1.jsonHelpTip)(resolved.raw, resolved.fromShell)}`);
+    }
+    if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {
+        throw new Error(`${label} must be a JSON object`);
+    }
+    const found = (0, dbFields_1.dbManagedFields)(obj);
+    if (found.length)
+        throw new Error((0, dbFields_1.dbManagedFieldsError)(found, label));
+    if (!obj.name || typeof obj.name !== 'string')
+        throw new Error('"name" is required');
+    return obj;
+}
+async function chatAgentsCreateCommand(json, opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const obj = await readChatAgentJson(json, opts.file, 'chat-agent JSON');
+        const res = await api.createChatAgent(obj);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(res.msg || 'Chat agent created.');
+        if (res.agent?._id)
+            (0, ui_1.info)(`  id: ${res.agent._id}`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function chatAgentsUpdateCommand(agentId, opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        await (0, dashboardAuth_1.refreshModelCatalog)();
+        const patch = await readChatAgentJson(opts.set, undefined, '--set object');
+        const res = await api.updateChatAgent(agentId, (0, versions_1.firstVersion)(opts.versions), patch);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(res.msg || 'Chat agent updated.');
+        (0, ui_1.info)(`  updated: ${Object.keys(patch).join(', ')}`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function chatAgentsCreateVersionCommand(agentId, json, opts) {
+    const api = (0, session_1.requireApi)();
+    try {
+        const obj = await readChatAgentJson(json, opts.file, 'chat-agent version JSON');
+        const res = await api.createChatAgentVersion(agentId, obj);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(res.msg || 'Chat agent version created.');
+        if (res.version?._id)
+            (0, ui_1.info)(`  id: ${res.version._id}`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function chatAgentsPublishCommand(agentId, opts) {
+    const api = (0, session_1.requireApi)();
+    const versionId = (0, versions_1.firstVersion)(opts.versions);
+    if (!versionId)
+        return (0, ui_1.handleError)(new Error('--versions <versionId> is required'));
+    try {
+        const res = await api.publishChatAgentVersion(agentId, versionId);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(res.msg || `Published version ${versionId}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/commands/jsonInput.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonHelpTip = jsonHelpTip;
+exports.resolveJsonInput = resolveJsonInput;
+exports.parseJsonInput = parseJsonInput;
+const fs_1 = require("fs");
+const looseJson_1 = require("../lib/looseJson");
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(Buffer.from(chunk));
+    return Buffer.concat(chunks).toString('utf8');
+}
+/** The tip appended to a JSON parse error, pointing at the file-based escapes. */
+function jsonHelpTip(raw, fromShell) {
+    if (!fromShell)
+        return '\n  If this came from a file, that is a genuine JSON syntax error.';
+    return ('\n  Your shell may have stripped the quotes. The file forms are quote-proof:\n' +
+        '    --file agent.json\n' +
+        '    @agent.json\n' +
+        '    < agent.json');
+}
+/**
+ * Resolve JSON from `--file <path>`, an `@file` argument, an inline argument,
+ * or stdin (when not a TTY). Exactly one inline path gets the lenient parser.
+ */
+async function resolveJsonInput(arg, file) {
+    if (file) {
+        if (!(0, fs_1.existsSync)(file))
+            throw new Error(`File not found: ${file}`);
+        return { raw: (0, looseJson_1.readJsonFile)(file), fromShell: false };
+    }
+    if (arg && arg.startsWith('@')) {
+        const path = arg.slice(1);
+        if (!(0, fs_1.existsSync)(path))
+            throw new Error(`File not found: ${path}`);
+        return { raw: (0, looseJson_1.readJsonFile)(path), fromShell: false };
+    }
+    if (arg !== undefined && arg !== '')
+        return { raw: arg, fromShell: true };
+    if (!process.stdin.isTTY) {
+        return { raw: (0, looseJson_1.stripBom)(await readStdin()), fromShell: false }; // piped/redirected
+    }
+    throw new Error('Provide the agent JSON. Because shells mangle embedded quotes, a file is most reliable:\n' +
+        '  cku agents create --file agent.json\n' +
+        '  cku agents create @agent.json\n' +
+        '  cku agents create < agent.json');
+}
+/**
+ * Parse a resolved input using the parser its source calls for. This is the only
+ * place that decision is made — commands should not branch on `fromShell`
+ * themselves.
+ */
+function parseJsonInput({ raw, fromShell }) {
+    return fromShell ? (0, looseJson_1.parseLooseJson)(raw) : JSON.parse(raw);
+}