callkaro-cli-unofficial 0.7.1 → 0.7.2

package/dist/commands/kpi.js

@@ -12,7 +12,20 @@ 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;
+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) {
@@ -606,17 +619,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 +705,340 @@ 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);
+    }
+}

package/dist/index.js

@@ -361,6 +361,89 @@ kpi
     .addHelpText('after', '\n  The server replaces the whole config at once, so an RCA prompt already set on\n' +
     '  the account is read back and re-sent rather than cleared.\n')
     .action(kpi_1.kpiTargetCommand);
+kpi
+    .command('config <agentId>')
+    .description("show or edit an agent's full KPI Manager config (all fields preserved on write)")
+    .option('--set <json>', 'JSON patch of top-level fields, or @file.json')
+    .option('--enable-rca', 'turn nightly RCA on')
+    .option('--disable-rca', 'turn nightly RCA off')
+    .option('--enable-report', 'turn the auto report on')
+    .option('--disable-report', 'turn the auto report off')
+    .option('--rca-model <id>', 'RCA model')
+    .option('--rca-prompt <text>', 'RCA prompt')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiConfigCommand);
+const kpiReport = kpi.command('report').description('KPI Report builder, live preview, and PDF export');
+kpiReport.command('schema').description('print the report schema and variable reference').action(kpi_1.kpiReportSchemaCommand);
+kpiReport
+    .command('get <agentId>')
+    .description("show an agent's report config")
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiReportGetCommand);
+kpiReport
+    .command('set <agentId>')
+    .description('edit schedule, recipients, enable flag, or merge a JSON patch')
+    .option('--set <json>', 'JSON merged into report_config (or @file.json)')
+    .option('--enable', 'enable the auto report')
+    .option('--disable', 'disable the auto report')
+    .option('--recipients <emails>', 'comma-separated emails (max 10); "" clears')
+    .option('--min-trigger <HH:mm>', 'earliest send time, IST')
+    .option('--max-trigger <HH:mm>', 'latest send time, IST (forced equal to min when interval >= 24)')
+    .option('--interval <hours>', 'one of 1,2,3,4,6,8,12,24,48,72,168')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiReportSetCommand);
+kpiReport
+    .command('preview <agentId>')
+    .description('live-evaluate the report (nothing is sent)')
+    .option('--set <json>', 'overlay JSON onto report_config')
+    .option('--interval <hours>', 'override interval_hours')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiReportPreviewCommand);
+kpiReport
+    .command('export <agentId>')
+    .description('render the report to a PDF file')
+    .option('--file <path>', 'output path')
+    .option('--set <json>', 'overlay JSON onto report_config')
+    .option('--interval <hours>', 'override interval_hours')
+    .action(kpi_1.kpiReportExportCommand);
+kpiReport
+    .command('add-var <agentId>')
+    .description('add or replace a custom variable')
+    .requiredOption('--name <name>', 'lowercase identifier')
+    .option('--expression <rule>', 'rule, e.g. "is_connected && post_call.x == \'YES\'"')
+    .option('--conditions <json>', 'conditions JSON (or @file.json); makes mode "conditions"')
+    .option('--consider-for <list>', 'all and/or unique, comma-separated (default all)')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiReportAddVarCommand);
+kpiReport
+    .command('remove-var <agentId> <name>')
+    .description('remove a custom variable and its chart refs')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiReportRemoveVarCommand);
+kpiReport
+    .command('add-element <agentId>')
+    .description('add a text, table or chart element to the canvas')
+    .requiredOption('--type <type>', 'text | table | chart (or tiles | bar | line | pie | funnel)')
+    .option('--chart-type <type>', 'tiles | bar | line | pie | funnel | table (default tiles)')
+    .option('--title <text>', 'chart title')
+    .option('--refs <refs>', 'comma-separated variable refs, e.g. total_calls,custom:foo')
+    .option('--x-axis <dim>', 'override x axis')
+    .option('--stack-by <dim>', 'override stack/split dimension')
+    .option('--content <text>', 'text content; ${total_calls} interpolates')
+    .option('--cells <json>', 'table cells as JSON rows (or @file.json)')
+    .option('--rows <n>', 'empty table rows (default 2)')
+    .option('--cols <n>', 'empty table cols (default 2)')
+    .option('--x <px>', 'left (default 40)')
+    .option('--y <px>', 'top (default: below existing elements)')
+    .option('--w <px>', 'width')
+    .option('--h <px>', 'height')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiReportAddElementCommand);
+kpiReport
+    .command('remove-element <agentId> <elementId>')
+    .description('remove a canvas element by id')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiReportRemoveElementCommand);
 kpi
     .command('rca')
     .description('start an RCA run for one agent over a date range')

package/dist/lib/dashboardApi.js

@@ -107,6 +107,56 @@ class DashboardApi {
         }
         return data;
     }
+    /**
+     * Like `request()`, but returns the raw bytes and suggested filename when the
+     * server answers with a binary download (PDF exports). Non-2xx still parses JSON
+     * and throws `DashboardError`.
+     */
+    async requestBinary(method, path, body) {
+        if (!path.startsWith('/'))
+            throw new Error(`Dashboard path must start with "/" (got "${path}").`);
+        const { token, sessionToken } = await (0, dashboardAuth_1.requireDashboard)();
+        const headers = {};
+        if (body !== undefined)
+            headers['Content-Type'] = 'application/json';
+        if (usesCookieAuth(path)) {
+            headers.Cookie = `access_token=${sessionToken}`;
+        }
+        else {
+            headers.Authorization = `Bearer ${token}`;
+        }
+        let res;
+        try {
+            res = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers,
+                body: body === undefined ? undefined : JSON.stringify(body),
+                redirect: 'error',
+                signal: AbortSignal.timeout(60_000),
+            });
+        }
+        catch (err) {
+            throw new Error(`Cannot reach ${this.baseUrl} (${err.message})`);
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            let data;
+            try {
+                data = text ? JSON.parse(text) : undefined;
+            }
+            catch {
+                data = { msg: text.slice(0, 200) };
+            }
+            throw new DashboardError(res.status, data?.msg || data?.message || `Request failed (${res.status})`, data);
+        }
+        const disp = typeof res.headers?.get === 'function' ? res.headers.get('content-disposition') || '' : '';
+        const m = /filename="?([^";]+)"?/i.exec(disp);
+        const contentType = typeof res.headers?.get === 'function' ? res.headers.get('content-type') || '' : '';
+        const ab = typeof res.arrayBuffer === 'function'
+            ? await res.arrayBuffer()
+            : Buffer.from(await res.text());
+        return { bytes: Buffer.from(ab), filename: m?.[1], contentType };
+    }
     /**
      * `GET /v2/agents/` — the one route that wants the body token as a bearer.
      * The only place `agentFolders` is exposed, which `/cli/agents` does not return.
@@ -225,6 +275,47 @@ class DashboardApi {
     runKpiRca(agentId, filters) {
         return this.request('POST', `/kpi-manager/${encodeURIComponent(agentId)}/rca/run-now`, { filters });
     }
+    /** Live-evaluate a KPI Report configuration (values, labels, chart series, source_fields). */
+    previewKpiReport(agentId, reportConfig) {
+        return this.request('POST', `/kpi-manager/${encodeURIComponent(agentId)}/report/preview`, {
+            report_config: { ...reportConfig, recipients: [] },
+        });
+    }
+    /** Render a KPI Report configuration to a PDF binary. */
+    exportKpiReport(agentId, reportConfig) {
+        return this.requestBinary('POST', `/kpi-manager/${encodeURIComponent(agentId)}/report/export`, {
+            report_config: reportConfig,
+        });
+    }
+    /** Draft or refine an RCA prompt with AI (`POST /openai-tools/generate-rca-prompt-draft`). */
+    generateRcaPromptDraft(body) {
+        return this.request('POST', '/openai-tools/generate-rca-prompt-draft', body);
+    }
+    /** Verify Python data source code before saving (`POST /utils/verify-code`). */
+    verifyKpiPythonCode(sourceCode, name = 'generate_kpi_data') {
+        return this.request('POST', '/utils/verify-code', {
+            name,
+            source_code: sourceCode,
+            type: 'kpi_data_source',
+        });
+    }
+    /** Bulk-import pending task cards (`POST /pending-tasks/import`). */
+    importPendingTasks(rows) {
+        return this.request('POST', '/pending-tasks/import', { rows });
+    }
+    /** Daywise RCA reports (`GET /v1/audit-reports/daywise`). */
+    daywiseRcaReports(query = {}) {
+        return this.request('GET', `/v1/audit-reports/daywise${qs(query)}`);
+    }
+    /** Day-by-day RCA execution timeline (`GET /v1/audit-reports/daywise/:agentId/timeline`). */
+    daywiseRcaTimeline(agentId, query = {}) {
+        return this.request('GET', `/v1/audit-reports/daywise/${encodeURIComponent(agentId)}/timeline${qs(query)}`);
+    }
+    /** Download a daywise RCA report PDF (`GET /v1/audit-reports/daywise/:agentId/:rcaDate/pdf`). */
+    daywiseRcaPdf(agentId, rcaDate, source) {
+        const q = source === 'manual' ? { source: 'manual' } : {};
+        return this.requestBinary('GET', `/v1/audit-reports/daywise/${encodeURIComponent(agentId)}/${encodeURIComponent(rcaDate)}/pdf${qs(q)}`);
+    }
     // --- Call analyzers -------------------------------------------------------
     listAnalyzers() { return this.request('GET', '/v1/call-analyzers'); }
     // --- Audit reports (dashboard side) ---------------------------------------

package/dist/lib/kpiReport.js

@@ -0,0 +1,363 @@
+"use strict";
+/**
+ * KPI Report canvas & config helpers, mirrored from the dashboard bundle (`XIr` / `sVe`).
+ *
+ * The backend replaces the whole `/kpi-manager/:agentId` document on `PUT`, so
+ * every edit here works on a normalized `KpiAgentConfig` and preserves all 10
+ * top-level fields (`api_endpoints`, `python_data_sources`, `expression_data_sources`,
+ * `kpi_metrics`, `rca_model`, `rca_llms`, `rca_prompt`, `nightly_rca_enabled`,
+ * `report_enabled`, `report_config`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPORT_SCHEMA_REFERENCE = exports.newElementId = exports.LOCKED_METRIC = exports.CHART_TYPES = exports.BUILTIN_DIMENSIONS = exports.BUILTIN_VARIABLES = exports.INTERVAL_HOURS = exports.CHART_HEIGHTS = exports.DEFAULT_WIDTHS = exports.MIN_H = exports.MIN_W = exports.MARGIN = exports.PAGE_H = exports.PAGE_W = void 0;
+exports.rcaLlmsFor = rcaLlmsFor;
+exports.normalizeMetrics = normalizeMetrics;
+exports.canonicalRef = canonicalRef;
+exports.shortToken = shortToken;
+exports.parseRef = parseRef;
+exports.defaultChartAxes = defaultChartAxes;
+exports.defaultReportConfig = defaultReportConfig;
+exports.nextElementY = nextElementY;
+exports.normalizeElement = normalizeElement;
+exports.normalizeReportConfig = normalizeReportConfig;
+exports.buildFullKpiPayload = buildFullKpiPayload;
+exports.formatPreviewValue = formatPreviewValue;
+exports.interpolateReportText = interpolateReportText;
+exports.PAGE_W = 794;
+exports.PAGE_H = 1123;
+exports.MARGIN = 40;
+exports.MIN_W = 80;
+exports.MIN_H = 40;
+exports.DEFAULT_WIDTHS = { chart: 520, table: 480, text: 360 };
+exports.CHART_HEIGHTS = {
+    tiles: 130, bar: 320, line: 320, pie: 260, funnel: 300, table: 260,
+};
+exports.INTERVAL_HOURS = [1, 2, 3, 4, 6, 8, 12, 24, 48, 72, 168];
+exports.BUILTIN_VARIABLES = [
+    { key: 'total_calls', label: 'Total triggered calls', valueKind: 'count' },
+    { key: 'connected_calls', label: 'Total connected calls', valueKind: 'count' },
+    { key: 'connected_pct', label: 'Connected %', valueKind: 'pct' },
+    { key: 'unique_receipts', label: 'Unique receipts', valueKind: 'count' },
+    { key: 'unique_connected', label: 'Unique connected receipts', valueKind: 'count' },
+    { key: 'unique_connected_pct', label: 'Receipt connectivity %', valueKind: 'pct' },
+    { key: 'converted_calls', label: 'Converted calls', valueKind: 'count' },
+    { key: 'converted_pct', label: 'Converted % (of connected)', valueKind: 'pct' },
+    { key: 'unique_converted', label: 'Unique converted receipts', valueKind: 'count' },
+    { key: 'avg_connected_duration', label: 'Avg connected duration (s)', valueKind: 'number' },
+    { key: 'drop_off_reasons', label: 'Drop-off reasons', valueKind: 'breakdown' },
+    { key: 'hangup_reasons', label: 'Hangup reasons', valueKind: 'breakdown' },
+];
+exports.BUILTIN_DIMENSIONS = [
+    { value: 'dim:time_hour', label: 'Hour' },
+    { value: 'dim:time_day', label: 'Day' },
+    { value: 'dim:hangup_reason', label: 'Hangup reason' },
+    { value: 'dim:drop_off_reason', label: 'Drop-off reason' },
+    { value: 'dim:is_connected', label: 'Connected / not connected' },
+    { value: 'dim:converted', label: 'Converted / not converted' },
+    { value: 'dim:direction', label: 'Direction' },
+];
+exports.CHART_TYPES = ['tiles', 'bar', 'line', 'pie', 'funnel', 'table'];
+const CHART_META = {
+    bar: { x: 'X axis', y: 'Y axis', stack: 'Stack by', multiY: true, metricsX: true },
+    line: { x: 'X axis', y: 'Y axis', stack: 'Split by', multiY: true },
+    pie: { x: 'Slices', y: 'Value', multiY: false, metricsX: true },
+    funnel: { x: 'Split by', y: 'Steps', multiY: true, optionalX: true, direction: true },
+    tiles: { y: 'Metrics', multiY: true },
+    table: { x: 'Rows', y: 'Columns', multiY: true, metricsX: true },
+};
+const RCA_MODELS = [
+    { provider: 'callkaro', name: 'callkaro/krishna-2.5' },
+    { provider: 'azure-openai', name: 'gpt-5.6-luna' },
+    { provider: 'bedrock', name: 'arn:aws:bedrock:ap-south-2:525856616822:inference-profile/global.anthropic.claude-sonnet-4-6' },
+    { provider: 'bedrock', name: 'arn:aws:bedrock:ap-south-2:525856616822:inference-profile/global.anthropic.claude-opus-4-6-v1' },
+    { provider: 'azure-openai', name: 'gpt-5.6-sol' },
+];
+const DEFAULT_RCA_MODEL = { provider: 'azure-openai', name: 'gpt-5.6-luna' };
+exports.LOCKED_METRIC = 'connected_to_conversion_percentage';
+function rcaLlmsFor(modelName) {
+    const name = (modelName || '').trim() || DEFAULT_RCA_MODEL.name;
+    const hit = RCA_MODELS.find((m) => m.name === name);
+    if (hit)
+        return { provider: hit.provider, name };
+    if (name.startsWith('callkaro/'))
+        return { provider: 'callkaro', name };
+    if (name.startsWith('arn:aws:bedrock'))
+        return { provider: 'bedrock', name };
+    return { provider: DEFAULT_RCA_MODEL.provider, name };
+}
+function normalizeMetrics(metrics) {
+    const list = Array.isArray(metrics) ? metrics : [];
+    const locked = list.find((m) => m?.name === exports.LOCKED_METRIC || m?.name === 'connected_to_conversion');
+    const rest = list
+        .filter((m) => m && m.name !== exports.LOCKED_METRIC && m.name !== 'connected_to_conversion')
+        .map((m) => ({ name: String(m.name || ''), source: String(m.source || ''), value: String(m.value ?? '') }));
+    return [
+        { name: exports.LOCKED_METRIC, source: exports.LOCKED_METRIC, value: String(locked?.value ?? '6') },
+        ...rest,
+    ];
+}
+const newElementId = () => `${Date.now().toString(36)}${Math.random().toString(36).slice(2, 8)}`;
+exports.newElementId = newElementId;
+/** Bare token (`total_calls`) becomes `builtin:total_calls`; scoped refs stay as-is. */
+function canonicalRef(raw) {
+    const trimmed = String(raw || '').trim();
+    if (!trimmed)
+        return '';
+    return trimmed.includes(':') ? trimmed : `builtin:${trimmed}`;
+}
+/** Short token inside `${...}`: strips `builtin:`, keeps `custom:...`, `postcall:...`, etc. */
+function shortToken(ref) {
+    const s = String(ref || '').trim();
+    return s.startsWith('builtin:') ? s.slice(8) : s;
+}
+function parseRef(ref) {
+    const [left, base = 'all'] = String(ref || '').split('#');
+    const idx = left.indexOf(':');
+    return idx >= 0
+        ? { kind: left.slice(0, idx), id: left.slice(idx + 1), base }
+        : { kind: 'builtin', id: left, base };
+}
+const BREAKDOWN_TO_DIM = {
+    'builtin:hangup_reasons': 'dim:hangup_reason',
+    'builtin:drop_off_reasons': 'dim:drop_off_reason',
+};
+const BASE_TO_MEASURE = {
+    all: 'builtin:total_calls',
+    connected: 'builtin:connected_calls',
+    converted: 'builtin:converted_calls',
+    unique: 'builtin:unique_receipts',
+    unique_connected: 'builtin:unique_connected',
+};
+function autoBreakdownAxes(ref) {
+    if (BREAKDOWN_TO_DIM[ref])
+        return { axis: BREAKDOWN_TO_DIM[ref], measure: 'builtin:total_calls' };
+    const { kind, id, base } = parseRef(ref);
+    if (kind === 'postcall') {
+        return { axis: `dim:postcall:${id}`, measure: BASE_TO_MEASURE[base] || 'builtin:total_calls' };
+    }
+    return null;
+}
+function defaultChartAxes(chartType, refs = []) {
+    const meta = CHART_META[chartType] || CHART_META.table;
+    const clean = refs.map(canonicalRef).filter(Boolean);
+    if (!clean.length)
+        return { x_axis: null, y_axis: [], stack_by: null };
+    const single = clean.length === 1 ? autoBreakdownAxes(clean[0]) : null;
+    if (single && meta.x)
+        return { x_axis: single.axis, y_axis: [single.measure], stack_by: null };
+    if (!meta.x || meta.optionalX)
+        return { x_axis: null, y_axis: clean, stack_by: null };
+    if (chartType === 'line')
+        return { x_axis: 'dim:time_hour', y_axis: clean, stack_by: null };
+    return {
+        x_axis: 'metrics',
+        y_axis: meta.multiY ? clean : clean.slice(0, 1),
+        stack_by: null,
+    };
+}
+function defaultReportConfig() {
+    return {
+        recipients: [],
+        min_trigger_time: '08:00',
+        max_trigger_time: '08:00',
+        interval_hours: 24,
+        anchor_at: '',
+        custom_variables: [],
+        elements: [],
+    };
+}
+function estimatedHeight(el) {
+    if (el?.h && Number.isFinite(Number(el.h)))
+        return Number(el.h);
+    if (el?.type === 'table')
+        return ((el.cells?.length || 1) * 36);
+    if (el?.type === 'text')
+        return 64;
+    return exports.CHART_HEIGHTS[el?.chart_type] || 240;
+}
+function nextElementY(elements) {
+    if (!Array.isArray(elements) || !elements.length)
+        return exports.MARGIN;
+    return elements.reduce((max, el) => Math.max(max, (Number(el.y) || 0) + estimatedHeight(el) + 24), exports.MARGIN);
+}
+function normalizeElement(el) {
+    if (!el || typeof el !== 'object')
+        return el;
+    if (el.type !== 'chart')
+        return el;
+    const chartType = (exports.CHART_TYPES.includes(el.chart_type) ? el.chart_type : 'tiles');
+    const h = el.h ?? (exports.CHART_HEIGHTS[chartType] || 280);
+    if (el.x_axis !== undefined) {
+        const yAxis = Array.isArray(el.y_axis) ? el.y_axis.map(canonicalRef) : (el.refs || []).map(canonicalRef);
+        return { ...el, chart_type: chartType, h, y_axis: yAxis, refs: yAxis };
+    }
+    const axes = defaultChartAxes(chartType, el.refs || el.y_axis || []);
+    return { ...el, chart_type: chartType, h, ...axes, refs: axes.y_axis };
+}
+function normalizeReportConfig(raw) {
+    const src = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
+    const { widgets, ...rest } = src;
+    const rawElements = Array.isArray(src.elements)
+        ? src.elements
+        : Array.isArray(widgets)
+            ? widgets.map((w) => ({
+                id: w.id || (0, exports.newElementId)(),
+                type: 'chart',
+                chart_type: w.type === 'stats' ? 'tiles' : w.type,
+                title: w.title || '',
+                refs: w.refs || [],
+                x: exports.MARGIN,
+                y: exports.MARGIN,
+                w: exports.PAGE_W - exports.MARGIN * 2,
+                options: w.options || {},
+            }))
+            : [];
+    return {
+        ...defaultReportConfig(),
+        ...rest,
+        recipients: Array.isArray(src.recipients) ? src.recipients : [],
+        custom_variables: Array.isArray(src.custom_variables) ? src.custom_variables : [],
+        elements: rawElements.map(normalizeElement),
+    };
+}
+/**
+ * Turn a `GET /kpi-manager/:agentId` response (or `{}` when 404) into a complete
+ * 10-field `PUT /kpi-manager/:agentId` body so partial CLI edits never wipe
+ * sibling fields (`api_endpoints`, `report_config`, `rca_prompt`, etc.).
+ */
+function buildFullKpiPayload(current = {}, patch = {}) {
+    const rcaModel = String(patch.rca_model ?? current?.rca_model ?? DEFAULT_RCA_MODEL.name);
+    return {
+        api_endpoints: patch.api_endpoints ?? (Array.isArray(current?.api_endpoints) ? current.api_endpoints : []),
+        python_data_sources: patch.python_data_sources ?? (Array.isArray(current?.python_data_sources) ? current.python_data_sources : []),
+        expression_data_sources: patch.expression_data_sources ??
+            (Array.isArray(current?.expression_data_sources) ? current.expression_data_sources : []),
+        kpi_metrics: normalizeMetrics(patch.kpi_metrics ?? current?.kpi_metrics),
+        rca_model: rcaModel,
+        rca_llms: patch.rca_llms ?? rcaLlmsFor(rcaModel),
+        rca_prompt: String(patch.rca_prompt ?? current?.rca_prompt ?? ''),
+        nightly_rca_enabled: patch.nightly_rca_enabled !== undefined
+            ? Boolean(patch.nightly_rca_enabled)
+            : current?.nightly_rca_enabled !== false,
+        report_enabled: patch.report_enabled !== undefined ? Boolean(patch.report_enabled) : current?.report_enabled === true,
+        report_config: normalizeReportConfig(patch.report_config ?? current?.report_config),
+    };
+}
+/** Format a preview value object (`{kind, value, actual, rows, ...}`) for terminal output. */
+function formatPreviewValue(val) {
+    if (!val)
+        return '—';
+    const fmt = (n) => n === null || n === undefined || n === '' || Number.isNaN(Number(n))
+        ? '—'
+        : Number(n).toLocaleString('en-IN', { maximumFractionDigits: 2 });
+    switch (val.kind) {
+        case 'pct':
+            return val.value === null || val.value === undefined ? '—' : `${fmt(val.value)}%`;
+        case 'count':
+            return val.pct !== null && val.pct !== undefined
+                ? `${fmt(val.value)} (${fmt(val.pct)}% of ${fmt(val.base_value)})`
+                : fmt(val.value);
+        case 'metric':
+            return val.actual === null || val.actual === undefined
+                ? `— (target ${fmt(val.target)}%)`
+                : `${fmt(val.actual)}% (target ${fmt(val.target)}%)`;
+        case 'text':
+            return val.value === null || val.value === undefined ? val.note || '—' : String(val.value);
+        case 'breakdown':
+            return Array.isArray(val.rows) && val.rows.length
+                ? val.rows.map((r) => `${r.label}: ${fmt(r.value)} (${fmt(r.pct)}%)`).join(', ')
+                : '—';
+        case 'error':
+            return `[ERROR: ${val.error}]`;
+        default:
+            return fmt(val.value);
+    }
+}
+/** Interpolate `${token}` inside a text box or table cell using `preview.values`. */
+function interpolateReportText(text, values = {}) {
+    return String(text || '').replace(/\$\{([^}]+)\}/g, (_m, raw) => {
+        const val = values[canonicalRef(raw)] ?? values[String(raw).trim()];
+        if (!val)
+            return `\${${raw}}`;
+        if (val.kind === 'count') {
+            return val.value === null || val.value === undefined
+                ? '—'
+                : Number(val.value).toLocaleString('en-IN', { maximumFractionDigits: 2 });
+        }
+        return formatPreviewValue(val);
+    });
+}
+exports.REPORT_SCHEMA_REFERENCE = `KPI Report schema & reference (PUT /kpi-manager/<agentId>)
+
+Top-level report fields on /kpi-manager/<agentId>:
+  "report_enabled": boolean          Auto Report toggle (emails report on schedule)
+  "report_config": {
+    "recipients": ["a@b.com"],       Up to 10 valid email addresses
+    "min_trigger_time": "08:00",     HH:mm IST (15-min steps)
+    "max_trigger_time": "20:00",     HH:mm IST (if interval_hours >= 24, equals min_trigger_time)
+    "interval_hours": 24,            One of: 1, 2, 3, 4, 6, 8, 12, 24, 48, 72, 168
+    "anchor_at": "",                 Set by server on save
+    "page_count": 1,                 Number of A4 pages (794 x 1123 px per page, margin 40)
+    "custom_variables": [...],       Custom call counters (conditions or expression)
+    "elements": [...]                Canvas items: text, table, chart
+  }
+
+Variable references (use in chart y_axis/refs, or as \${...} inside text & table cells):
+  Built-in (in \${...} you may omit "builtin:", e.g. \${total_calls}):
+    builtin:total_calls              Total triggered calls (count)
+    builtin:connected_calls          Total connected calls (count)
+    builtin:connected_pct            Connected % (pct)
+    builtin:unique_receipts          Unique receipts (count)
+    builtin:unique_connected         Unique connected receipts (count)
+    builtin:unique_connected_pct     Receipt connectivity % (pct)
+    builtin:converted_calls          Converted calls (count)
+    builtin:converted_pct            Converted % of connected (pct)
+    builtin:unique_converted         Unique converted receipts (count)
+    builtin:avg_connected_duration   Avg connected duration in seconds (number)
+    builtin:drop_off_reasons         Drop-off reasons (breakdown)
+    builtin:hangup_reasons           Hangup reasons (breakdown)
+
+  Post-call variables (<base> is: all | connected | unique | unique_connected; #all may be omitted):
+    postcall:<varName>               e.g. postcall:car_name, postcall:test_drive_booked#connected
+
+  Custom variables (<base> is: all | unique; #all may be omitted):
+    custom:<varName>                 e.g. custom:booked_test_drives, custom:booked_test_drives#unique
+
+  Data sources (from api_endpoints, python_data_sources, expression_data_sources):
+    source:<apiName>.data.<field>    API Endpoint response field
+    source:<pyName>.<field>          Python Code return dict key
+    source:<exprName>.count          Expression data source (.count, .total, or .pct)
+
+  KPI metrics:
+    metric:<metricName>              e.g. metric:connected_to_conversion_percentage
+
+Chart dimensions (for x_axis and stack_by on bar, line, pie, funnel, table charts):
+  "metrics"                          Each metric (compare y_axis metrics side by side)
+  "dim:time_hour"                    Hour
+  "dim:time_day"                     Day
+  "dim:hangup_reason"                Hangup reason
+  "dim:drop_off_reason"              Drop-off reason
+  "dim:is_connected"                 Connected / not connected
+  "dim:converted"                    Converted / not converted
+  "dim:direction"                    Direction
+  "dim:postcall:<varName>"           Any post-call variable on the agent
+  "dim:metadata:<key>"               Any {{variable}} in the agent's prompt
+
+Element types (A4 sheet is 794px wide x 1123px tall per page; page 2 starts at y = 1123):
+  1. text:
+     {"id":"t1","type":"text","content":"Calls: \${total_calls}","x":40,"y":40,"w":360,
+      "style":{"bold":false,"italic":false,"underline":false,"size":14,"color":"#111827","align":"left"}}
+  2. table (1..8 rows x 1..8 cols; row 0 is bold header when header !== false):
+     {"id":"tb1","type":"table","header":true,"x":40,"y":120,"w":480,
+      "cells":[["Metric","Value"],["Triggered","\${total_calls}"],["Connected","\${connected_pct}"]]}
+  3. chart (chart_type: tiles | bar | line | pie | funnel | table):
+     {"id":"c1","type":"chart","chart_type":"tiles","title":"Headline","x_axis":null,
+      "y_axis":["builtin:total_calls","builtin:connected_calls","builtin:connected_pct"],
+      "refs":["builtin:total_calls","builtin:connected_calls","builtin:connected_pct"],
+      "stack_by":null,"options":{},"x":40,"y":240,"w":714,"h":130}
+
+Custom variable & Expression data source syntax:
+  Fields: post_call.<name>, metadata.<key>, is_connected, is_converted, hangup_reason, call_duration
+  Operators: && || ! == != > >= < <= and in ['a', 'b']  (case-insensitive strings; bare field = is true)
+  Example: (is_converted==true) && post_call.test_drive_booked == 'YES' && is_connected
+`;

package/package.json

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