callkaro-cli-unofficial 0.7.1 → 0.8.0

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,218 @@ 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)}`);
+    }
+    // --- Agent version commits, diff, revert & v2 save -------------------------
+    /** List commits for an agent (`GET /v2/commits/:agentId?version=&page=&pageSize=`). */
+    agentCommits(agentId, query = {}) {
+        return this.request('GET', `/v2/commits/${encodeURIComponent(agentId)}${qs(query)}`);
+    }
+    /** Fetch one commit in full (`GET /v2/commits/single/:commitId`). */
+    agentCommit(commitId) {
+        return this.request('GET', `/v2/commits/single/${encodeURIComponent(commitId)}`);
+    }
+    /** Compare two commits of an agent (`GET /v2/commits/:agentId/compare?commitA=&commitB=`). */
+    compareAgentCommits(agentId, commitA, commitB) {
+        return this.request('GET', `/v2/commits/${encodeURIComponent(agentId)}/compare${qs({ commitA, commitB })}`);
+    }
+    /** Revert an agent version to a previous commit (`POST /v2/commits/revert/:agentId/:commitId`). */
+    revertAgentCommit(agentId, commitId) {
+        return this.request('POST', `/v2/commits/revert/${encodeURIComponent(agentId)}/${encodeURIComponent(commitId)}`, {});
+    }
+    /** Compare two agent versions (`POST /v2/agents/compareVersions` with `{ versionIds: [a, b] }`). */
+    compareAgentVersions(versionIds) {
+        return this.request('POST', '/v2/agents/compareVersions', { versionIds });
+    }
+    /**
+     * Dashboard `/v2/agents/:agentId?version=:versionId` save — accepts function
+     * `source_code` and `commitMessage` that `/cli/agents` rejects.
+     */
+    updateAgentV2(agentId, versionId, body) {
+        const q = versionId ? qs({ version: versionId }) : '';
+        return this.request('PUT', `/v2/agents/${encodeURIComponent(agentId)}${q}`, body);
+    }
+    /** Delete an agent version (`DELETE /v2/agents/deleteversion/:agentId?version=:versionId`). */
+    deleteAgentVersionV2(agentId, versionId) {
+        return this.request('DELETE', `/v2/agents/deleteversion/${encodeURIComponent(agentId)}${qs({ version: versionId })}`);
+    }
+    /** Duplicate an agent (`PUT /v2/agents/duplicate/:agentId` with `{ name, versions }`). */
+    duplicateAgentV2(agentId, body) {
+        return this.request('PUT', `/v2/agents/duplicate/${encodeURIComponent(agentId)}`, body);
+    }
+    // --- Audit summary drilldowns (`/v1/audit-summary/*`) ----------------------
+    /** Summary rollup for a strategy or batch (`GET /v1/audit-summary/:scope/:id/summary`). */
+    auditSummary(scope, id, query = {}) {
+        return this.request('GET', `/v1/audit-summary/${scope}/${encodeURIComponent(id)}/summary${qs(query)}`);
+    }
+    /** Audited calls in a dimension/category (`GET /v1/audit-summary/:scope/:id/categories/:dimension/:category/calls`). */
+    auditCategoryCalls(scope, id, dimension, category, query = {}) {
+        return this.request('GET', `/v1/audit-summary/${scope}/${encodeURIComponent(id)}/categories/${encodeURIComponent(dimension)}/${encodeURIComponent(category)}/calls${qs(query)}`);
+    }
+    /** Audited calls at a severity level (`GET /v1/audit-summary/:scope/:id/severities/:severity/calls`). */
+    auditSeverityCalls(scope, id, severity, query = {}) {
+        return this.request('GET', `/v1/audit-summary/${scope}/${encodeURIComponent(id)}/severities/${encodeURIComponent(severity)}/calls${qs(query)}`);
+    }
+    /** Audited calls for an extra-variable value (`GET /v1/audit-summary/:scope/:id/extra-variables/:name/:value/calls`). */
+    auditExtraVariableCalls(scope, id, name, value, query = {}) {
+        return this.request('GET', `/v1/audit-summary/${scope}/${encodeURIComponent(id)}/extra-variables/${encodeURIComponent(name)}/${encodeURIComponent(value)}/calls${qs(query)}`);
+    }
+    /** Audited calls scoring below 80 (`GET /v1/audit-summary/:scope/:id/scores/below-80/calls`). */
+    auditBelow80Calls(scope, id, query = {}) {
+        return this.request('GET', `/v1/audit-summary/${scope}/${encodeURIComponent(id)}/scores/below-80/calls${qs(query)}`);
+    }
+    /** Single audited call report (`GET /v1/audit-summary/:scope/:id/calls/:callId`). */
+    auditCallDetail(scope, id, callId, query = {}) {
+        return this.request('GET', `/v1/audit-summary/${scope}/${encodeURIComponent(id)}/calls/${encodeURIComponent(callId)}${qs(query)}`);
+    }
+    // --- Diagnostic analytics (`/analytics/*`) ---------------------------------
+    /** Failed LLM/TTS response buckets (`GET /analytics/failed-responses`). */
+    failedResponses(query = {}) {
+        return this.request('GET', `/analytics/failed-responses${qs(query)}`);
+    }
+    /** Calls matching a failed response bucket (`GET /analytics/failed-response-calls`). */
+    failedResponseCalls(query = {}) {
+        return this.request('GET', `/analytics/failed-response-calls${qs(query)}`);
+    }
+    /** Per-function execution analytics (`GET /analytics/functions`). */
+    functionAnalytics(query = {}) {
+        return this.request('GET', `/analytics/functions${qs(query)}`);
+    }
+    /** Chat agent analytics (`GET /analytics/chat`). */
+    chatAnalytics(query = {}) {
+        return this.request('GET', `/analytics/chat${qs(query)}`);
+    }
+    // --- Do-Not-Disturb numbers (`/dnd-phone-numbers/*`) -----------------------
+    /** List DND numbers (`GET /dnd-phone-numbers`). */
+    listDndNumbers(query = {}) {
+        return this.request('GET', `/dnd-phone-numbers${qs(query)}`);
+    }
+    /** Add a single DND phone number (`POST /dnd-phone-numbers/add`). */
+    addDndNumber(phoneNumber) {
+        return this.request('POST', '/dnd-phone-numbers/add', { phoneNumber });
+    }
+    /** Update a DND record (`PUT /dnd-phone-numbers/:id`). */
+    updateDndNumber(id, phoneNumber) {
+        return this.request('PUT', `/dnd-phone-numbers/${encodeURIComponent(id)}`, { phoneNumber });
+    }
+    /** Remove a DND record by id (`DELETE /dnd-phone-numbers/:id`). */
+    removeDndNumber(id) {
+        return this.request('DELETE', `/dnd-phone-numbers/${encodeURIComponent(id)}`);
+    }
+    /** Remove multiple DND records by id (`POST /dnd-phone-numbers/delete-multiple`). */
+    removeDndNumbers(ids) {
+        return this.request('POST', '/dnd-phone-numbers/delete-multiple', { ids });
+    }
+    /** Bulk import DND phone numbers (`POST /dnd-phone-numbers/import`). */
+    importDndNumbers(phoneNumbers) {
+        return this.request('POST', '/dnd-phone-numbers/import', { phoneNumbers });
+    }
+    // --- Call QA Feedback tickets (`/feedback/*`) ------------------------------
+    /** List feedback tickets (`GET /feedback?status=processing|in-review|resolved&page=1`). */
+    listFeedback(query = {}) {
+        return this.request('GET', `/feedback${qs({ status: query.status || 'processing', page: query.page || 1 })}`);
+    }
+    /** Create a feedback ticket (`POST /feedback`). */
+    createFeedback(body) {
+        return this.request('POST', '/feedback', body);
+    }
+    /** Comment on a feedback ticket (`PUT /feedback/:id/comment`). */
+    commentFeedback(id, text) {
+        return this.request('PUT', `/feedback/${encodeURIComponent(id)}/comment`, { text });
+    }
+    /** Submit a feedback ticket for review (`PUT /feedback/:id/submit-review`). */
+    submitFeedbackReview(id, body) {
+        return this.request('PUT', `/feedback/${encodeURIComponent(id)}/submit-review`, body);
+    }
+    /** Send a feedback ticket back to processing (`PUT /feedback/:id/back-to-processing`). */
+    reopenFeedback(id, comment) {
+        return this.request('PUT', `/feedback/${encodeURIComponent(id)}/back-to-processing`, { comment });
+    }
+    /** Resolve a feedback ticket (`PUT /feedback/:id/resolve`). */
+    resolveFeedback(id, comment) {
+        return this.request('PUT', `/feedback/${encodeURIComponent(id)}/resolve`, { comment });
+    }
+    // --- Knowledge Base (`/knowledge/*`) ---------------------------------------
+    /** List knowledge base items for the user (`GET /knowledge/user`). */
+    listKnowledge() {
+        return this.request('GET', '/knowledge/user');
+    }
+    /** Delete a knowledge base item (`DELETE /knowledge/:id`). */
+    deleteKnowledge(id) {
+        return this.request('DELETE', `/knowledge/${encodeURIComponent(id)}`);
+    }
+    // --- OpenAI / AI Copilot generators (`/openai-tools/*`) --------------------
+    /** Draft a simulation test case from a real call (`POST /openai-tools/generate-simulation-testcase-draft`). */
+    generateSimFromCall(body) {
+        return this.request('POST', '/openai-tools/generate-simulation-testcase-draft', {
+            includeMetadata: true,
+            includeFunctions: true,
+            ...body,
+        });
+    }
+    /** Generate or refine a simulation test case from a hint (`POST /openai-tools/generate-simulation-testcase-from-prompt`). */
+    generateSimFromPrompt(body) {
+        return this.request('POST', '/openai-tools/generate-simulation-testcase-from-prompt', body);
+    }
+    /** Generate an audit strategy draft (`POST /openai-tools/generate-audit-strategy-draft`). */
+    generateAuditStrategyDraft(body) {
+        return this.request('POST', '/openai-tools/generate-audit-strategy-draft', body);
+    }
+    /** Generate a callflow summary draft (`POST /openai-tools/generate-callflow-summary-draft`). */
+    generateCallflowSummaryDraft(body) {
+        return this.request('POST', '/openai-tools/generate-callflow-summary-draft', body);
+    }
+    /** Generate or edit a voice agent function (`POST /openai-tools/generate-function`). */
+    generateFunctionCode(body) {
+        return this.request('POST', '/openai-tools/generate-function', body);
+    }
+    /** Generate post-call analysis config (`POST /openai-tools/generate-postcall-config`). */
+    generatePostcallConfig(body) {
+        return this.request('POST', '/openai-tools/generate-postcall-config', body);
+    }
+    /** Generate workflow code step (`POST /openai-tools/generate-workflow-code`). */
+    generateWorkflowCode(body) {
+        return this.request('POST', '/openai-tools/generate-workflow-code', body);
+    }
     // --- 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.8.0",
   "license": "Apache-2.0",
   "description": "Unofficial fork of the CallKaro CLI — manage your voice AI agents from the terminal",
   "bin": {