callkaro-cli-unofficial 0.7.2 → 0.9.0

package/dist/commands/chatAgents.js

@@ -43,6 +43,8 @@ exports.chatAgentsCreateCommand = chatAgentsCreateCommand;
 exports.chatAgentsUpdateCommand = chatAgentsUpdateCommand;
 exports.chatAgentsCreateVersionCommand = chatAgentsCreateVersionCommand;
 exports.chatAgentsPublishCommand = chatAgentsPublishCommand;
+exports.chatAgentsDiffCommand = chatAgentsDiffCommand;
+const dashboardApi_1 = require("../lib/dashboardApi");
 const session_1 = require("../lib/session");
 const dashboardAuth_1 = require("../lib/dashboardAuth");
 const ui_1 = require("../lib/ui");
@@ -249,3 +251,23 @@ async function chatAgentsPublishCommand(agentId, opts) {
         (0, ui_1.handleError)(err);
     }
 }
+/** `cku chat-agents diff <chatAgentId> --versions vA,vB | --commits cA,cB` */
+async function chatAgentsDiffCommand(chatAgentId, opts) {
+    try {
+        const pair = (s, flag) => {
+            const p = (s || '').split(',').map((x) => x.trim()).filter(Boolean);
+            if (p.length !== 2)
+                throw new Error(`${flag} needs exactly two ids, comma-separated.`);
+            return [p[0], p[1]];
+        };
+        if (!!opts.versions === !!opts.commits)
+            throw new Error('Pass exactly one of --versions <vA,vB> or --commits <cA,cB>.');
+        const res = opts.versions
+            ? await (0, dashboardApi_1.dashboardApi)().compareChatAgentVersions(pair(opts.versions, '--versions'))
+            : await (0, dashboardApi_1.dashboardApi)().compareChatAgentCommits(chatAgentId, ...pair(opts.commits, '--commits'));
+        console.log(JSON.stringify(res, null, 2));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/commands/chatAuditStrategies.js

@@ -7,6 +7,8 @@ exports.chatAuditCreateCommand = chatAuditCreateCommand;
 exports.chatAuditUpdateCommand = chatAuditUpdateCommand;
 exports.chatAuditDeleteCommand = chatAuditDeleteCommand;
 exports.chatAuditBatchCommand = chatAuditBatchCommand;
+exports.chatAuditReportsCommand = chatAuditReportsCommand;
+const dashboardApi_1 = require("../lib/dashboardApi");
 const session_1 = require("../lib/session");
 const ui_1 = require("../lib/ui");
 const setJson_1 = require("./setJson");
@@ -137,3 +139,21 @@ async function chatAuditBatchCommand(agentId, strategyId, opts) {
         (0, ui_1.handleError)(err);
     }
 }
+/** `cku chat-audit reports [--agent <id>] [--page <n>]` — dashboard session. */
+async function chatAuditReportsCommand(opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().chatAuditReportBatches({
+            agentId: opts.agent,
+            page: opts.page ? Number(opts.page) : undefined,
+        });
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        const rows = res?.data?.batches || res?.batches || (Array.isArray(res?.data) ? res.data : []);
+        if (!rows.length)
+            return void (0, ui_1.info)('No chat audit report batches.');
+        (0, ui_1.table)(['ID', 'STATUS', 'CREATED'], rows.map((r) => [r._id || r.id || '', r.status || '', r.createdAt || '']));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/commands/dashboardApiCmd.js

@@ -7,7 +7,13 @@ const jsonInput_1 = require("./jsonInput");
 const looseJson_1 = require("../lib/looseJson");
 const METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
 /** The route segments the path may contain — see `repairPosixPath`. */
-const PATH_SEGMENTS = ['auth', 'v1', 'v2', 'v3', 'kpi-manager', 'pending-tasks', 'phone-number'];
+const PATH_SEGMENTS = [
+    'auth', 'v1', 'v2', 'v3', 'kpi-manager', 'pending-tasks', 'phone-number',
+    'analytics', 'dnd-phone-numbers', 'feedback', 'knowledge', 'openai-tools',
+    'schedulecalls', 'agent-folders', 'inbox', 'finetune', 'batchcalls',
+    'team-management', 'verified-phone-numbers', 'compliance', 'integrations',
+    'wa-campaign', 'whatsapp', 'workflows', 'contacts', 'calls', 'utils',
+];
 /**
  * `cku dashboard api <METHOD> <path> [--body <json|@file>] [--query k=v ...]`
  *

package/dist/commands/dnd.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dndListCommand = dndListCommand;
+exports.dndAddCommand = dndAddCommand;
+exports.dndUpdateCommand = dndUpdateCommand;
+exports.dndRemoveCommand = dndRemoveCommand;
+exports.dndImportCommand = dndImportCommand;
+const fs_1 = require("fs");
+const dashboardApi_1 = require("../lib/dashboardApi");
+const ui_1 = require("../lib/ui");
+const day = (s) => {
+    if (!s)
+        return undefined;
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(s))
+        throw new Error(`Date "${s}" must be YYYY-MM-DD.`);
+    return s;
+};
+async function dndListCommand(opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().listDndNumbers({
+            page: Number(opts.page) || 1,
+            limit: Number(opts.limit) || 20,
+            search: opts.search,
+            startDate: day(opts.since),
+            endDate: day(opts.until),
+        });
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        const rows = res?.data || res?.numbers || res?.phoneNumbers || (Array.isArray(res) ? res : []);
+        if (!rows.length)
+            return void (0, ui_1.info)('No DND numbers.');
+        (0, ui_1.table)(['ID', 'PHONE', 'CREATED'], rows.map((r) => [r._id || r.id || '', r.phoneNumber || '', r.createdAt || '']));
+        if (res?.total !== undefined)
+            (0, ui_1.info)(`\nTotal: ${res.total}`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function dndAddCommand(phoneNumber, opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().addDndNumber(phoneNumber);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Added ${phoneNumber} to DND.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function dndUpdateCommand(id, phoneNumber, opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().updateDndNumber(id, phoneNumber);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Updated ${id} to ${phoneNumber}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function dndRemoveCommand(idsCsv, opts) {
+    try {
+        const ids = idsCsv.split(',').map((s) => s.trim()).filter(Boolean);
+        if (!ids.length)
+            throw new Error('Give one or more DND record ids (comma-separated). List them with: cku dnd list');
+        if (!(await (0, ui_1.confirm)(`Remove ${ids.length} DND record(s)? Those numbers can be called again.`, opts.yes)))
+            return;
+        const api = (0, dashboardApi_1.dashboardApi)();
+        const res = ids.length === 1 ? await api.removeDndNumber(ids[0]) : await api.removeDndNumbers(ids);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Removed ${ids.length} DND record(s).`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function dndImportCommand(opts) {
+    try {
+        if (!opts.phones && !opts.file)
+            throw new Error('Pass --phones <a,b,...> or --file <path> (comma/newline list or JSON array).');
+        const text = (opts.phones ?? (0, fs_1.readFileSync)(opts.file, 'utf8')).trim();
+        let phones;
+        if (text.startsWith('[')) {
+            const arr = JSON.parse(text);
+            if (!Array.isArray(arr))
+                throw new Error('JSON input must be an array of phone numbers.');
+            phones = arr.map((p) => String(p).trim());
+        }
+        else {
+            phones = text.split(/[,\n\r]+/).map((s) => s.trim());
+        }
+        phones = phones.filter(Boolean);
+        if (!phones.length)
+            throw new Error('No phone numbers found in input.');
+        const res = await (0, dashboardApi_1.dashboardApi)().importDndNumbers(phones);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Imported ${phones.length} number(s) to DND.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/commands/feedback.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.feedbackListCommand = feedbackListCommand;
+exports.feedbackCreateCommand = feedbackCreateCommand;
+exports.feedbackCommentCommand = feedbackCommentCommand;
+exports.feedbackSubmitReviewCommand = feedbackSubmitReviewCommand;
+exports.feedbackReopenCommand = feedbackReopenCommand;
+exports.feedbackResolveCommand = feedbackResolveCommand;
+const dashboardApi_1 = require("../lib/dashboardApi");
+const ui_1 = require("../lib/ui");
+const STATUSES = ['processing', 'in-review', 'resolved'];
+const list = (s) => (s || '').split(',').map((x) => x.trim()).filter(Boolean);
+const out = (json, res, msg) => json ? console.log(JSON.stringify(res, null, 2)) : (0, ui_1.success)(msg);
+async function feedbackListCommand(opts) {
+    try {
+        const status = opts.status || 'processing';
+        if (!STATUSES.includes(status))
+            throw new Error(`--status must be one of: ${STATUSES.join(', ')} (got "${status}").`);
+        const res = await (0, dashboardApi_1.dashboardApi)().listFeedback({ status, page: Number(opts.page) || 1 });
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        const rows = res?.data || res?.feedbacks || res?.feedback || (Array.isArray(res) ? res : []);
+        if (!rows.length)
+            return void (0, ui_1.info)(`No ${status} feedback tickets.`);
+        (0, ui_1.table)(['ID', 'NAME', 'STATUS', 'CALL', 'ISSUE'], rows.map((r) => [r._id || r.id || '', r.feedbackName || '', r.status || status, r.issueCallId || '', String(r.callIssue || '').slice(0, 60)]));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function feedbackCreateCommand(opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().createFeedback({
+            engineerId: opts.engineer,
+            callIssue: opts.issue,
+            feedbackName: opts.name,
+            issueCallId: opts.call,
+            ...(opts.version ? { versionId: opts.version } : {}),
+        });
+        out(opts.json, res, 'Feedback ticket created.');
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function feedbackCommentCommand(id, text, opts) {
+    try {
+        if (!text?.trim())
+            throw new Error('Comment text is required.');
+        out(opts.json, await (0, dashboardApi_1.dashboardApi)().commentFeedback(id, text), `Comment added to ${id}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function feedbackSubmitReviewCommand(id, opts) {
+    try {
+        const body = {
+            ...(opts.calls ? { resolvedCallUrls: list(opts.calls) } : {}),
+            ...(opts.versionUrl ? { resolvedVersionUrl: opts.versionUrl } : {}),
+            ...(opts.comment ? { comment: opts.comment } : {}),
+        };
+        out(opts.json, await (0, dashboardApi_1.dashboardApi)().submitFeedbackReview(id, body), `${id} submitted for review.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function feedbackReopenCommand(id, opts) {
+    try {
+        out(opts.json, await (0, dashboardApi_1.dashboardApi)().reopenFeedback(id, opts.comment), `${id} sent back to processing.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function feedbackResolveCommand(id, opts) {
+    try {
+        out(opts.json, await (0, dashboardApi_1.dashboardApi)().resolveFeedback(id, opts.comment), `${id} resolved.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/commands/folders.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.foldersListCommand = foldersListCommand;
+exports.foldersCreateCommand = foldersCreateCommand;
+exports.foldersRenameCommand = foldersRenameCommand;
+exports.foldersDeleteCommand = foldersDeleteCommand;
+exports.foldersMoveCommand = foldersMoveCommand;
+const dashboardApi_1 = require("../lib/dashboardApi");
+const ui_1 = require("../lib/ui");
+/** `cku folders` — agent folders, on the dashboard session. */
+async function foldersListCommand(opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().agentsWithFolders();
+        const folders = res?.agentFolders || res?.folders || [];
+        const agents = res?.agents || [];
+        const rows = folders.map((f) => ({ id: f._id, name: f.name, agents: agents.filter((a) => a.folderId === f._id).length }));
+        if (opts.json)
+            return void console.log(JSON.stringify(rows, null, 2));
+        if (!rows.length)
+            return void (0, ui_1.info)('No agent folders.');
+        (0, ui_1.table)(['ID', 'NAME', 'AGENTS'], rows.map((r) => [r.id, r.name, r.agents]));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function foldersCreateCommand(name, opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().createAgentFolder(name.trim());
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Created folder "${name.trim()}".`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function foldersRenameCommand(folderId, name, opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().renameAgentFolder(folderId, name.trim());
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Renamed folder ${folderId} to "${name.trim()}".`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function foldersDeleteCommand(folderId, opts) {
+    try {
+        if (!(await (0, ui_1.confirm)(`Delete folder ${folderId}?`, opts.yes)))
+            return;
+        const res = await (0, dashboardApi_1.dashboardApi)().deleteAgentFolder(folderId);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Deleted folder ${folderId}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function foldersMoveCommand(folderId, opts) {
+    try {
+        const ids = (opts.agents || '').split(',').map((s) => s.trim()).filter(Boolean);
+        if (!ids.length)
+            throw new Error('--agents <id,id,...> is required.');
+        const res = await (0, dashboardApi_1.dashboardApi)().moveAgentsToFolder(ids, folderId);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Moved ${ids.length} agent(s) to folder ${folderId}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/commands/knowledge.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.knowledgeListCommand = knowledgeListCommand;
+exports.knowledgeDeleteCommand = knowledgeDeleteCommand;
+const dashboardApi_1 = require("../lib/dashboardApi");
+const ui_1 = require("../lib/ui");
+async function knowledgeListCommand(opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().listKnowledge();
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        const rows = res?.data || res?.knowledge || (Array.isArray(res) ? res : []);
+        if (!rows.length)
+            return void (0, ui_1.info)('No knowledge base items.');
+        (0, ui_1.table)(['ID', 'NAME', 'TYPE', 'CREATED'], rows.map((r) => [r._id || r.id || '', r.name || r.title || '', r.type || '', r.createdAt || '']));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+async function knowledgeDeleteCommand(id, opts) {
+    try {
+        if (!(await (0, ui_1.confirm)(`Delete knowledge item ${id}? This cannot be undone.`, opts.yes)))
+            return;
+        const res = await (0, dashboardApi_1.dashboardApi)().deleteKnowledge(id);
+        if (opts.json)
+            return void console.log(JSON.stringify(res ?? { id }, null, 2));
+        (0, ui_1.success)(`Deleted ${id}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/commands/kpi.js

@@ -22,6 +22,18 @@ exports.kpiReportAddVarCommand = kpiReportAddVarCommand;
 exports.kpiReportRemoveVarCommand = kpiReportRemoveVarCommand;
 exports.kpiReportAddElementCommand = kpiReportAddElementCommand;
 exports.kpiReportRemoveElementCommand = kpiReportRemoveElementCommand;
+exports.kpiImportCommand = kpiImportCommand;
+exports.kpiDetachCommand = kpiDetachCommand;
+exports.kpiRcaReportsCommand = kpiRcaReportsCommand;
+exports.kpiRcaTimelineCommand = kpiRcaTimelineCommand;
+exports.kpiRcaPdfCommand = kpiRcaPdfCommand;
+exports.kpiRcaDraftPromptCommand = kpiRcaDraftPromptCommand;
+exports.kpiSourceAddApiCommand = kpiSourceAddApiCommand;
+exports.kpiSourceAddPythonCommand = kpiSourceAddPythonCommand;
+exports.kpiSourceAddExprCommand = kpiSourceAddExprCommand;
+exports.kpiSourceRemoveCommand = kpiSourceRemoveCommand;
+exports.kpiMetricSetCommand = kpiMetricSetCommand;
+exports.kpiMetricRemoveCommand = kpiMetricRemoveCommand;
 const fs_1 = require("fs");
 const dashboardApi_1 = require("../lib/dashboardApi");
 const setJson_1 = require("./setJson");
@@ -348,7 +360,11 @@ async function kpiHistoryCommand(opts) {
         if (!agentIds.length) {
             return (0, ui_1.handleError)(new Error(`No agent ids in --agents "${opts.agents}".\n  Use a comma-separated list, e.g. --agents abc123,def456`));
         }
-        const res = await (0, dashboardApi_1.dashboardApi)().kpiHistory({ agentIds: agentIds.join(',') });
+        const res = await (0, dashboardApi_1.dashboardApi)().kpiHistory({
+            agentIds: agentIds.join(','),
+            startDate: opts.since ? dateBound(opts.since, false) : undefined,
+            endDate: opts.until ? dateBound(opts.until, true) : undefined,
+        });
         if (opts.json)
             return void console.log(JSON.stringify(res, null, 2));
         // Deliberately generic: this response's shape was not confirmed field by field,
@@ -494,6 +510,18 @@ async function kpiCommentCommand(taskId, text, opts = {}) {
  */
 async function kpiAssignCommand(taskId, opts) {
     try {
+        if (opts.unassign) {
+            const res = await (0, dashboardApi_1.dashboardApi)().savePendingAssignments([
+                { taskId, unassign: true, versionIds: splitList(opts.versions), versionNames: splitList(opts.versionNames) },
+            ]);
+            const result = Array.isArray(res?.results) ? res.results[0] : undefined;
+            if (result && result.success === false) {
+                return (0, ui_1.handleError)(new Error(result.error || 'The server refused the unassignment.'));
+            }
+            if (opts.json)
+                return void console.log(JSON.stringify(res, null, 2));
+            return void (0, ui_1.success)(`Unassigned ${taskId}.`);
+        }
         let to = String(opts.to || '').trim();
         if (!to) {
             return (0, ui_1.handleError)(new Error('--to <who> is required.\n' +
@@ -1042,3 +1070,236 @@ async function kpiReportRemoveElementCommand(agentId, elementId, opts) {
         (0, ui_1.handleError)(err);
     }
 }
+// --- import / detach / RCA reports / data sources -----------------------------
+/** `cku kpi import --file <rows.json>` — bulk-create cards. */
+async function kpiImportCommand(opts) {
+    try {
+        const raw = (0, setJson_1.readSetJson)(opts.file.startsWith('@') ? opts.file : '@' + opts.file);
+        const list = Array.isArray(raw) ? raw : raw?.rows;
+        if (!Array.isArray(list) || !list.length) {
+            throw new Error('File must hold a non-empty JSON array of task rows, or {"rows": [...]}.');
+        }
+        const rows = list.map((r) => (r && r.columnId ? { ...r, columnId: columnId(r.columnId) } : r));
+        const res = await (0, dashboardApi_1.dashboardApi)().importPendingTasks(rows);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        (0, ui_1.success)(`Imported ${res?.created ?? 0} card(s)${res?.skipped?.length ? ` (${res.skipped.length} skipped)` : ''}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi detach <taskId> <url>` — remove one attachment. */
+async function kpiDetachCommand(taskId, url, opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().deletePendingTaskAttachment(taskId, url);
+        if (opts.json)
+            return void console.log(JSON.stringify(res ?? { taskId, url }, null, 2));
+        (0, ui_1.success)(`Detached attachment from ${taskId}.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi rca-reports` — daywise RCA reports. */
+async function kpiRcaReportsCommand(opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().daywiseRcaReports({
+            agentId: opts.agent,
+            startDate: opts.since ? dateBound(opts.since, false) : undefined,
+            endDate: opts.until ? dateBound(opts.until, true) : undefined,
+            source: opts.source,
+            page: Number(opts.page) || 1,
+            pageSize: pageSize(opts.limit, 20),
+        });
+        if (opts.json)
+            return void console.log(JSON.stringify(res?.data || res, null, 2));
+        const rows = Array.isArray(res?.data) ? res.data : [];
+        if (!rows.length)
+            return void (0, ui_1.info)('No RCA reports.');
+        (0, ui_1.table)(['DATE', 'AGENT', 'SOURCE', 'AUDITED', 'ROOT CAUSES', 'CONFIDENCE', 'GAPS'], rows.map((r) => [
+            r.rcaDate || r.date || '',
+            r.agentName || r.agentId || '',
+            r.source || r.reportSource || '',
+            r.auditedCalls ?? r.audited ?? '',
+            r.rootCauseCount ?? '',
+            r.confidence ?? '',
+            Array.isArray(r.metricGaps) && r.metricGaps.length
+                ? r.metricGaps.map((g) => `${g.metricName}: ${g.actualPct}% vs ${g.targetPct}% (${g.gapPct > 0 ? '+' : ''}${g.gapPct}pp)`).join('; ')
+                : '',
+        ]));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi rca-timeline <agentId>` — day-by-day RCA execution events. */
+async function kpiRcaTimelineCommand(agentId, opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().daywiseRcaTimeline(agentId, {
+            startDate: opts.since ? dateBound(opts.since, false) : undefined,
+            endDate: opts.until ? dateBound(opts.until, true) : undefined,
+        });
+        if (opts.json)
+            return void console.log(JSON.stringify(res?.data || res, null, 2));
+        const days = res?.data?.days || [];
+        if (!days.length)
+            return void (0, ui_1.info)('No timeline events.');
+        for (const day of days) {
+            (0, ui_1.info)(`\n${day.date || day.rcaDate || ''}`);
+            (0, ui_1.table)(['TIME', 'STAGE', 'STEP', 'STATUS', 'TITLE', 'DETAIL'], (day.events || []).map((e) => [e.at || '', e.stage || '', e.step || '', e.status || '', clip(e.title, 40), clip(e.detail, 60)]));
+        }
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi rca-pdf <agentId> <date>` — download one RCA report PDF. */
+async function kpiRcaPdfCommand(agentId, rcaDate, opts) {
+    try {
+        const { bytes, filename } = await (0, dashboardApi_1.dashboardApi)().daywiseRcaPdf(agentId, rcaDate, opts.manual ? 'manual' : undefined);
+        const file = opts.file || filename || `rca_${agentId}_${rcaDate}.pdf`;
+        (0, fs_1.writeFileSync)(file, bytes);
+        (0, ui_1.success)(`Wrote ${file} (${bytes.length} bytes).`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi rca-draft-prompt <agentId> --prompt <text>` — AI-draft the RCA prompt. */
+async function kpiRcaDraftPromptCommand(agentId, opts) {
+    try {
+        const current = await loadKpiConfig(agentId);
+        const res = await (0, dashboardApi_1.dashboardApi)().generateRcaPromptDraft({
+            agentId,
+            text_input: opts.prompt,
+            ...(current.rca_prompt ? { existingRcaPrompt: current.rca_prompt } : {}),
+            ...(current.kpi_metrics ? { kpi_metrics: current.kpi_metrics } : {}),
+        });
+        const draft = res?.response || res?.data || '';
+        if (opts.save) {
+            return void (await saveKpiConfig(agentId, current, { rca_prompt: String(draft) }, opts.json, 'Saved generated RCA prompt.'));
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        console.log(typeof draft === 'string' ? draft : JSON.stringify(draft, null, 2));
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+const PHONE_PARAM = { key_name: 'phone_number', value: 'user_phone_number' };
+/** Parameters with the mandatory phone_number entry first (bundle's `PXe`). */
+function withPhoneParam(raw) {
+    const extra = raw ? (0, setJson_1.readSetJson)(raw) : [];
+    if (!Array.isArray(extra))
+        throw new Error('--params must be a JSON array of {key_name, value}.');
+    return [PHONE_PARAM, ...extra.filter((p) => p?.key_name !== 'phone_number')];
+}
+/** Replace the entry with the same name, or append. */
+function upsertByName(list, item) {
+    const out = [...(list || [])];
+    const i = out.findIndex((x) => x?.name === item.name);
+    if (i >= 0)
+        out[i] = item;
+    else
+        out.push(item);
+    return out;
+}
+/** `cku kpi source add-api <agentId>` */
+async function kpiSourceAddApiCommand(agentId, opts) {
+    try {
+        if (!opts.name?.trim())
+            throw new Error('--name is required.');
+        if (!opts.url?.trim())
+            throw new Error('--url is required.');
+        const headers = opts.headers ? (0, setJson_1.readSetJson)(opts.headers) : {};
+        const current = await loadKpiConfig(agentId);
+        const item = { name: opts.name.trim(), url: opts.url.trim(), method: 'POST', headers, parameters: withPhoneParam(opts.params) };
+        await saveKpiConfig(agentId, current, { api_endpoints: upsertByName(current.api_endpoints, item) }, opts.json, `API data source ${item.name} saved.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi source add-python <agentId>` */
+async function kpiSourceAddPythonCommand(agentId, opts) {
+    try {
+        if (!opts.name?.trim())
+            throw new Error('--name is required.');
+        if (!opts.code)
+            throw new Error('--code is required (inline, or @file.py).');
+        const code = opts.code.startsWith('@') ? (0, fs_1.readFileSync)(opts.code.slice(1), 'utf8') : opts.code;
+        if (!opts.skipVerify)
+            await (0, dashboardApi_1.dashboardApi)().verifyKpiPythonCode(code);
+        const current = await loadKpiConfig(agentId);
+        const item = { name: opts.name.trim(), source_code: code, parameters: withPhoneParam(opts.params) };
+        await saveKpiConfig(agentId, current, { python_data_sources: upsertByName(current.python_data_sources, item) }, opts.json, `Python data source ${item.name} saved.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi source add-expr <agentId>` */
+async function kpiSourceAddExprCommand(agentId, opts) {
+    try {
+        if (!/^[A-Za-z][A-Za-z0-9_-]{0,63}$/.test(opts.name || '')) {
+            throw new Error('--name must start with a letter, then letters, digits, _ or -, max 64 chars.');
+        }
+        const item = {
+            name: opts.name,
+            mode: opts.conditions ? 'conditions' : 'expression',
+            conditions: opts.conditions ? (0, setJson_1.readSetJson)(opts.conditions) : [],
+            expression: opts.expression || '',
+            equals: true,
+            consider_for: opts.considerFor === 'unique' ? 'unique' : 'all',
+        };
+        const current = await loadKpiConfig(agentId);
+        await saveKpiConfig(agentId, current, { expression_data_sources: upsertByName(current.expression_data_sources, item) }, opts.json, `Expression data source ${item.name} saved.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi source remove <agentId> <name>` */
+async function kpiSourceRemoveCommand(agentId, name, opts) {
+    try {
+        const current = await loadKpiConfig(agentId);
+        const drop = (l) => (l || []).filter((x) => x?.name !== name);
+        await saveKpiConfig(agentId, current, {
+            api_endpoints: drop(current.api_endpoints),
+            python_data_sources: drop(current.python_data_sources),
+            expression_data_sources: drop(current.expression_data_sources),
+        }, opts.json, `Data source ${name} removed.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi metric set <agentId>` */
+async function kpiMetricSetCommand(agentId, opts) {
+    try {
+        if (!opts.name?.trim() || !opts.source?.trim() || opts.value === undefined || String(opts.value).trim() === '') {
+            throw new Error('--name, --source and --value are all required.');
+        }
+        const current = await loadKpiConfig(agentId);
+        const item = { name: opts.name.trim(), source: opts.source.trim(), value: String(opts.value) };
+        await saveKpiConfig(agentId, current, { kpi_metrics: upsertByName(current.kpi_metrics, item) }, opts.json, `Metric ${item.name} saved.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi metric remove <agentId> <name>` */
+async function kpiMetricRemoveCommand(agentId, name, opts) {
+    try {
+        if (name === 'connected_to_conversion_percentage') {
+            throw new Error('connected_to_conversion_percentage is locked by the server and cannot be removed. Change it with: cku kpi target');
+        }
+        const current = await loadKpiConfig(agentId);
+        await saveKpiConfig(agentId, current, { kpi_metrics: (current.kpi_metrics || []).filter((m) => m?.name !== name) }, opts.json, `Metric ${name} removed.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}