callkaro-cli-unofficial 0.7.1 → 0.8.0

package/dist/commands/kpi.js

@@ -12,7 +12,32 @@ exports.kpiAssignCommand = kpiAssignCommand;
 exports.kpiAssigneesCommand = kpiAssigneesCommand;
 exports.kpiTargetCommand = kpiTargetCommand;
 exports.kpiRcaCommand = kpiRcaCommand;
+exports.kpiConfigCommand = kpiConfigCommand;
+exports.kpiReportSchemaCommand = kpiReportSchemaCommand;
+exports.kpiReportGetCommand = kpiReportGetCommand;
+exports.kpiReportSetCommand = kpiReportSetCommand;
+exports.kpiReportPreviewCommand = kpiReportPreviewCommand;
+exports.kpiReportExportCommand = kpiReportExportCommand;
+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");
+const kpiReport_1 = require("../lib/kpiReport");
 const ui_1 = require("../lib/ui");
 /** Table cells are one line each; these keep a long prompt from wrapping a row. */
 function clip(value, max = 60) {
@@ -335,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,
@@ -481,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' +
@@ -606,17 +647,25 @@ async function kpiTargetCommand(opts) {
                 throw err;
         }
         const metricName = 'connected_to_conversion_percentage';
-        const body = {
-            kpi_metrics: [{ name: metricName, source: metricName, value: String(opts.value).trim() }],
-        };
-        // Only send the RCA fields when the user names them, or when the account
-        // already has them and would otherwise be wiped.
-        const rcaModel = opts.rcaModel ?? current.rca_model;
-        const rcaPrompt = opts.rcaPrompt ?? current.rca_prompt;
-        if (rcaModel)
-            body.rca_model = String(rcaModel);
-        if (rcaPrompt !== undefined)
-            body.rca_prompt = String(rcaPrompt);
+        const target = { name: metricName, source: metricName, value: String(opts.value).trim() };
+        let body;
+        if (Object.keys(current).length) {
+            // Existing config: send all 10 fields so data sources, report and extra
+            // metrics survive the wholesale PUT.
+            const rest = (Array.isArray(current.kpi_metrics) ? current.kpi_metrics : []).filter((m) => m?.name !== metricName && m?.name !== 'connected_to_conversion');
+            body = (0, kpiReport_1.buildFullKpiPayload)(current, {
+                kpi_metrics: [target, ...rest],
+                ...(opts.rcaModel !== undefined ? { rca_model: String(opts.rcaModel), rca_llms: (0, kpiReport_1.rcaLlmsFor)(String(opts.rcaModel)) } : {}),
+                ...(opts.rcaPrompt !== undefined ? { rca_prompt: String(opts.rcaPrompt) } : {}),
+            });
+        }
+        else {
+            body = { kpi_metrics: [target] };
+            if (opts.rcaModel)
+                body.rca_model = String(opts.rcaModel);
+            if (opts.rcaPrompt !== undefined)
+                body.rca_prompt = String(opts.rcaPrompt);
+        }
         const res = await api.setKpiAgentConfig(agentId, body);
         if (opts.json)
             return void console.log(JSON.stringify(res ?? body, null, 2));
@@ -684,3 +733,573 @@ function splitList(raw) {
         .map((s) => s.trim())
         .filter(Boolean);
 }
+// --- KPI config & report ------------------------------------------------------
+/** Read the agent's config; 404 is "none yet", anything else must stop the write. */
+async function loadKpiConfig(agentId) {
+    try {
+        return (await (0, dashboardApi_1.dashboardApi)().kpiAgentConfig(agentId)) || {};
+    }
+    catch (err) {
+        if (!(0, dashboardApi_1.isNotFound)(err))
+            throw err;
+        return {};
+    }
+}
+/** PUT the full 10-field payload and report. */
+async function saveKpiConfig(agentId, current, patch, json, msg) {
+    const payload = (0, kpiReport_1.buildFullKpiPayload)(current, patch);
+    const res = await (0, dashboardApi_1.dashboardApi)().setKpiAgentConfig(agentId, payload);
+    if (json)
+        return void console.log(JSON.stringify(res ?? payload, null, 2));
+    (0, ui_1.success)(msg);
+}
+/** `cku kpi config <agentId>` — show or edit the whole KPI Manager document. */
+async function kpiConfigCommand(agentId, opts) {
+    try {
+        const current = await loadKpiConfig(agentId);
+        const mutate = opts.set || opts.enableRca || opts.disableRca || opts.enableReport || opts.disableReport ||
+            opts.rcaModel !== undefined || opts.rcaPrompt !== undefined;
+        if (!mutate) {
+            if (opts.json)
+                return void console.log(JSON.stringify(current, null, 2));
+            (0, ui_1.keyValue)({
+                agentId,
+                rca_model: current.rca_model ?? '',
+                nightly_rca_enabled: String(current.nightly_rca_enabled !== false),
+                report_enabled: String(current.report_enabled === true),
+                metrics: (current.kpi_metrics || []).map((m) => `${m.name}=${m.value}`).join(', ') || '(none)',
+                api_endpoints: (current.api_endpoints || []).length,
+                python_data_sources: (current.python_data_sources || []).length,
+                expression_data_sources: (current.expression_data_sources || []).length,
+                report_elements: (current.report_config?.elements || []).length,
+                rca_prompt: clip(current.rca_prompt, 80),
+            });
+            return;
+        }
+        const setPatch = opts.set ? (0, setJson_1.readSetJson)(opts.set) : {};
+        await saveKpiConfig(agentId, current, {
+            ...setPatch,
+            ...(opts.rcaModel !== undefined ? { rca_model: opts.rcaModel } : {}),
+            ...(opts.rcaPrompt !== undefined ? { rca_prompt: opts.rcaPrompt } : {}),
+            ...(opts.enableRca ? { nightly_rca_enabled: true } : opts.disableRca ? { nightly_rca_enabled: false } : {}),
+            ...(opts.enableReport ? { report_enabled: true } : opts.disableReport ? { report_enabled: false } : {}),
+        }, opts.json, `KPI config for ${agentId} saved.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi report schema` */
+async function kpiReportSchemaCommand() {
+    console.log(kpiReport_1.REPORT_SCHEMA_REFERENCE);
+}
+/** `cku kpi report get <agentId>` */
+async function kpiReportGetCommand(agentId, opts) {
+    try {
+        const current = await loadKpiConfig(agentId);
+        const cfg = (0, kpiReport_1.normalizeReportConfig)(current.report_config);
+        const enabled = Boolean(current.report_enabled);
+        if (opts.json) {
+            return void console.log(JSON.stringify({ agentId, report_enabled: enabled, report_config: cfg }, null, 2));
+        }
+        (0, ui_1.keyValue)({
+            agentId,
+            report_enabled: enabled,
+            recipients: cfg.recipients.join(', ') || '(none)',
+            schedule: `${cfg.min_trigger_time} – ${cfg.max_trigger_time} IST, every ${cfg.interval_hours}h`,
+            custom_variables: cfg.custom_variables.length,
+            elements: cfg.elements.length,
+        });
+        if (cfg.custom_variables.length) {
+            (0, ui_1.table)(['NAME', 'MODE', 'CONSIDER FOR', 'RULE'], cfg.custom_variables.map((v) => [
+                v.name || '', v.mode || '', (v.consider_for || []).join(','), clip(v.mode === 'conditions' ? JSON.stringify(v.conditions ?? []) : (v.expression || ''), 50),
+            ]));
+        }
+        if (cfg.elements.length) {
+            (0, ui_1.table)(['ID', 'TYPE', 'POS (x,y,w,h)', 'SUMMARY'], cfg.elements.map((e) => [
+                e.id || '',
+                e.type === 'chart' ? `chart/${e.chart_type}` : e.type || '',
+                `${e.x ?? ''},${e.y ?? ''},${e.w ?? ''},${e.h ?? ''}`,
+                clip(e.type === 'chart' ? `${e.title || ''} ${(e.y_axis || []).join(' ')}` : e.type === 'table' ? `${(e.cells || []).length} rows` : e.content, 50),
+            ]));
+        }
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+const HHMM = /^\d{2}:\d{2}$/;
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/** `cku kpi report set <agentId>` */
+async function kpiReportSetCommand(agentId, opts) {
+    try {
+        const current = await loadKpiConfig(agentId);
+        let next = (0, kpiReport_1.normalizeReportConfig)(current.report_config);
+        let enabled = Boolean(current.report_enabled);
+        if (opts.set) {
+            let patch = (0, setJson_1.readSetJson)(opts.set);
+            if (patch.report_config && typeof patch.report_config === 'object') {
+                if (patch.report_enabled !== undefined)
+                    enabled = Boolean(patch.report_enabled);
+                patch = patch.report_config;
+            }
+            next = (0, kpiReport_1.normalizeReportConfig)({ ...next, ...patch });
+        }
+        if (opts.recipients !== undefined) {
+            const list = opts.recipients.split(/[,;\s]+/).map((r) => r.trim().toLowerCase()).filter(Boolean);
+            const bad = list.filter((r) => !EMAIL.test(r));
+            if (bad.length)
+                throw new Error(`Invalid recipient email(s): ${bad.join(', ')}`);
+            if (list.length > 10)
+                throw new Error(`At most 10 recipients (got ${list.length}).`);
+            next.recipients = list;
+        }
+        if (opts.interval !== undefined) {
+            const n = Number(opts.interval);
+            if (!kpiReport_1.INTERVAL_HOURS.includes(n))
+                throw new Error(`--interval must be one of: ${kpiReport_1.INTERVAL_HOURS.join(', ')} (got "${opts.interval}").`);
+            next.interval_hours = n;
+        }
+        for (const [flag, key, v] of [['--min-trigger', 'min_trigger_time', opts.minTrigger], ['--max-trigger', 'max_trigger_time', opts.maxTrigger]]) {
+            if (v === undefined)
+                continue;
+            if (!HHMM.test(v))
+                throw new Error(`${flag} must be HH:mm (got "${v}").`);
+            next[key] = v;
+        }
+        if (Number(next.interval_hours) >= 24)
+            next.max_trigger_time = next.min_trigger_time;
+        if (opts.enable)
+            enabled = true;
+        else if (opts.disable)
+            enabled = false;
+        await saveKpiConfig(agentId, current, { report_enabled: enabled, report_config: next }, opts.json, `KPI report for ${agentId} saved.`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** Saved report config with `--set` / `--interval` overlaid, for preview and export. */
+function overlayReport(current, opts) {
+    const cfg = (0, kpiReport_1.normalizeReportConfig)({
+        ...(0, kpiReport_1.normalizeReportConfig)(current.report_config),
+        ...(opts.set ? (0, setJson_1.readSetJson)(opts.set) : {}),
+        ...(opts.interval !== undefined ? { interval_hours: Number(opts.interval) } : {}),
+    });
+    return cfg;
+}
+/** `cku kpi report preview <agentId>` */
+async function kpiReportPreviewCommand(agentId, opts) {
+    try {
+        const cfg = overlayReport(await loadKpiConfig(agentId), opts);
+        const res = await (0, dashboardApi_1.dashboardApi)().previewKpiReport(agentId, cfg);
+        if (opts.json)
+            return void console.log(JSON.stringify(res, null, 2));
+        const values = res?.values || {};
+        const labels = res?.labels || {};
+        (0, ui_1.info)(`Window: ${res?.window?.label ?? '?'}   Generated: ${res?.generated_at ?? '?'}`);
+        const rows = Object.entries(values)
+            .filter(([ref]) => !ref.startsWith('chart:') && !ref.endsWith('@trend'))
+            .map(([ref, v]) => [ref, labels[ref] || v?.label || '', (0, kpiReport_1.formatPreviewValue)(v)]);
+        if (rows.length)
+            (0, ui_1.table)(['REF', 'LABEL', 'VALUE'], rows);
+        for (const el of cfg.elements) {
+            const series = values[`chart:${el.id}`] ?? res?.charts?.[el.id] ?? res?.series?.[el.id];
+            if (el.type === 'chart' && series)
+                (0, ui_1.info)(`\nchart:${el.id} (${el.title || el.chart_type})\n${JSON.stringify(series)}`);
+            else if (el.type === 'text')
+                (0, ui_1.info)(`\n${(0, kpiReport_1.interpolateReportText)(el.content, values)}`);
+            else if (el.type === 'table') {
+                const cells = (el.cells || []).map((r) => r.map((c) => (0, kpiReport_1.interpolateReportText)(c, values)));
+                if (cells.length)
+                    (0, ui_1.table)(cells[0], cells.slice(1));
+            }
+        }
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi report export <agentId>` — render to PDF. */
+async function kpiReportExportCommand(agentId, opts) {
+    try {
+        const cfg = overlayReport(await loadKpiConfig(agentId), opts);
+        const { bytes, filename } = await (0, dashboardApi_1.dashboardApi)().exportKpiReport(agentId, cfg);
+        const file = opts.file || filename || `kpi_report_${agentId}.pdf`;
+        (0, fs_1.writeFileSync)(file, bytes);
+        (0, ui_1.success)(`Wrote ${file} (${bytes.length} bytes).`);
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** Load config + its report, apply `edit`, save. Shared by the var/element commands. */
+async function editReport(agentId, json, msg, edit) {
+    const current = await loadKpiConfig(agentId);
+    const cfg = (0, kpiReport_1.normalizeReportConfig)(current.report_config);
+    edit(cfg);
+    await saveKpiConfig(agentId, current, { report_config: cfg }, json, msg);
+}
+/** `cku kpi report add-var <agentId>` */
+async function kpiReportAddVarCommand(agentId, opts) {
+    try {
+        if (!/^[a-z][a-z0-9_]{0,63}$/.test(opts.name || '')) {
+            throw new Error('--name must be lowercase letters, digits, underscores, start with a letter, max 64 chars.');
+        }
+        const mode = opts.conditions ? 'conditions' : 'expression';
+        if (mode === 'expression' && !opts.expression?.trim()) {
+            throw new Error('--expression <rule> is required (or --conditions <json>). See: cku kpi report schema');
+        }
+        const consider = (opts.considerFor || 'all').split(',').map((s) => s.trim()).filter(Boolean);
+        const badConsider = consider.filter((c) => c !== 'all' && c !== 'unique');
+        if (badConsider.length)
+            throw new Error(`--consider-for takes all and/or unique (got ${badConsider.join(', ')}).`);
+        const variable = { name: opts.name, mode, conditions: [], expression: '', equals: true, consider_for: consider };
+        if (mode === 'conditions')
+            variable.conditions = (0, setJson_1.readSetJson)(opts.conditions);
+        else
+            variable.expression = opts.expression.trim();
+        await editReport(agentId, opts.json, `Custom variable ${opts.name} saved.`, (cfg) => {
+            const i = cfg.custom_variables.findIndex((v) => v.name === opts.name);
+            if (i >= 0)
+                cfg.custom_variables[i] = variable;
+            else
+                cfg.custom_variables.push(variable);
+        });
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi report remove-var <agentId> <name>` */
+async function kpiReportRemoveVarCommand(agentId, name, opts) {
+    try {
+        await editReport(agentId, opts.json, `Custom variable ${name} removed.`, (cfg) => {
+            cfg.custom_variables = cfg.custom_variables.filter((v) => v.name !== name);
+            const strip = (list) => (list || []).filter((r) => parseCustom(r) !== name);
+            cfg.elements = cfg.elements.map((el) => el.type === 'chart' ? { ...el, refs: strip(el.refs), y_axis: strip(el.y_axis) } : el);
+        });
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `custom:foo#unique` -> `foo`; anything else -> undefined. */
+function parseCustom(ref) {
+    const m = /^custom:([^#]+)/.exec(String(ref));
+    return m ? m[1] : undefined;
+}
+/** `cku kpi report add-element <agentId>` */
+async function kpiReportAddElementCommand(agentId, opts) {
+    try {
+        const shorthand = kpiReport_1.CHART_TYPES.includes(opts.type) && opts.type !== 'table';
+        const kind = shorthand ? 'chart' : opts.type;
+        if (!['text', 'table', 'chart'].includes(kind)) {
+            throw new Error(`--type must be text | table | chart (or a chart type: tiles | bar | line | pie | funnel). Got "${opts.type}".`);
+        }
+        const chartType = (shorthand ? opts.type : opts.chartType || 'tiles');
+        if (kind === 'chart' && !kpiReport_1.CHART_TYPES.includes(chartType)) {
+            throw new Error(`--chart-type must be one of: ${kpiReport_1.CHART_TYPES.join(', ')}.`);
+        }
+        const num = (v, flag) => numeric(v, flag);
+        await editReport(agentId, opts.json, `Added ${kind} element.`, (cfg) => {
+            const w = num(opts.w, '--w') ?? (kind === 'chart' ? kpiReport_1.PAGE_W - kpiReport_1.MARGIN * 2 : kpiReport_1.DEFAULT_WIDTHS[kind]);
+            if (w < kpiReport_1.MIN_W)
+                throw new Error(`--w must be at least ${kpiReport_1.MIN_W}.`);
+            const el = {
+                id: (0, kpiReport_1.newElementId)(),
+                type: kind,
+                x: num(opts.x, '--x') ?? kpiReport_1.MARGIN,
+                y: num(opts.y, '--y') ?? (0, kpiReport_1.nextElementY)(cfg.elements),
+                w,
+            };
+            if (kind === 'text') {
+                el.content = opts.content ?? '';
+                el.style = { bold: false, italic: false, underline: false, size: 14, color: '#111827', align: 'left' };
+            }
+            else if (kind === 'table') {
+                el.header = true;
+                if (opts.cells) {
+                    const cells = (0, setJson_1.readSetJson)(opts.cells);
+                    if (!Array.isArray(cells) || !cells.length || !cells.every((r) => Array.isArray(r))) {
+                        throw new Error('--cells must be a JSON array of rows, e.g. [["Metric","Value"],["Calls","${total_calls}"]].');
+                    }
+                    el.cells = cells;
+                }
+                else {
+                    const r = num(opts.rows, '--rows') ?? 2;
+                    const c = num(opts.cols, '--cols') ?? 2;
+                    if (r < 1 || r > 8 || c < 1 || c > 8)
+                        throw new Error('--rows and --cols must be 1..8.');
+                    el.cells = Array.from({ length: r }, () => Array.from({ length: c }, () => ''));
+                }
+            }
+            else {
+                const refs = (opts.refs || '').split(',').map(kpiReport_1.canonicalRef).filter(Boolean);
+                const axes = (0, kpiReport_1.defaultChartAxes)(chartType, refs);
+                el.chart_type = chartType;
+                el.title = opts.title ?? '';
+                el.x_axis = opts.xAxis !== undefined ? opts.xAxis : axes.x_axis;
+                el.y_axis = axes.y_axis;
+                el.refs = axes.y_axis;
+                el.stack_by = opts.stackBy !== undefined ? opts.stackBy : axes.stack_by;
+                el.options = {};
+                el.h = kpiReport_1.CHART_HEIGHTS[chartType] || 280;
+            }
+            if (opts.h !== undefined)
+                el.h = num(opts.h, '--h');
+            cfg.elements.push(el);
+        });
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku kpi report remove-element <agentId> <elementId>` */
+async function kpiReportRemoveElementCommand(agentId, elementId, opts) {
+    try {
+        await editReport(agentId, opts.json, `Element ${elementId} removed.`, (cfg) => {
+            const n = cfg.elements.length;
+            cfg.elements = cfg.elements.filter((e) => e.id !== elementId);
+            if (cfg.elements.length === n) {
+                throw new Error(`No element with id "${elementId}". List ids with: cku kpi report get ${agentId}`);
+            }
+        });
+    }
+    catch (err) {
+        (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);
+    }
+}