callkaro-cli-unofficial 0.7.2 → 0.8.0

package/dist/commands/kpi.js

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

package/dist/commands/simulations.js

@@ -15,8 +15,11 @@ exports.waitForBatch = waitForBatch;
 exports.simRunCommand = simRunCommand;
 exports.simRunsListCommand = simRunsListCommand;
 exports.simResultsCommand = simResultsCommand;
+exports.simDraftFromCallCommand = simDraftFromCallCommand;
+exports.simGenerateCommand = simGenerateCommand;
 const prompts_1 = __importDefault(require("prompts"));
 const session_1 = require("../lib/session");
+const dashboardApi_1 = require("../lib/dashboardApi");
 const ui_1 = require("../lib/ui");
 const jsonInput_1 = require("./jsonInput");
 /**
@@ -312,3 +315,68 @@ async function simResultsCommand(batchId, opts) {
         (0, ui_1.handleError)(err);
     }
 }
+/** `cku sim draft-from-call <callId>` — AI-draft a test case from a real call. */
+async function simDraftFromCallCommand(callId, opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().generateSimFromCall({
+            callId,
+            versionId: opts.version,
+            includeMetadata: opts.metadata !== false,
+            includeFunctions: opts.functions !== false,
+        });
+        const draft = res?.draft || res;
+        let saved;
+        if (opts.save && draft?.agentId) {
+            saved = await (0, session_1.requireApi)().createTestCase({
+                agentId: draft.agentId,
+                testcaseName: draft.testcaseName || `call-${callId}`,
+                userPersona: draft.userPersona,
+                userPrompt: draft.userPrompt,
+                successCriteria: draft.successCriteria,
+                testVariables: draft.testVariables || {},
+                testFunctions: draft.testFunctions || [],
+            });
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(saved ?? draft, null, 2));
+        (0, ui_1.keyValue)({ name: draft?.testcaseName, persona: draft?.userPersona, prompt: draft?.userPrompt, criteria: draft?.successCriteria });
+        if (saved)
+            (0, ui_1.success)('Test case saved.');
+        else if (opts.save)
+            (0, ui_1.info)('Draft has no agentId; nothing saved.');
+        else
+            (0, ui_1.info)('Draft only. Re-run with --save to create it.');
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}
+/** `cku sim generate <agentId> --hint <text>` — AI-draft a test case from a hint. */
+async function simGenerateCommand(agentId, opts) {
+    try {
+        const res = await (0, dashboardApi_1.dashboardApi)().generateSimFromPrompt({ agentId, versionId: opts.version, hint: opts.hint });
+        const tc = res?.testCase || res;
+        let saved;
+        if (opts.save) {
+            saved = await (0, session_1.requireApi)().createTestCase({
+                agentId,
+                testcaseName: tc.testcaseName || 'generated-test',
+                userPersona: tc.userPersona,
+                userPrompt: tc.userPrompt,
+                successCriteria: tc.successCriteria,
+                testVariables: {},
+                testFunctions: [],
+            });
+        }
+        if (opts.json)
+            return void console.log(JSON.stringify(saved ?? tc, null, 2));
+        (0, ui_1.keyValue)({ name: tc?.testcaseName, persona: tc?.userPersona, prompt: tc?.userPrompt, criteria: tc?.successCriteria });
+        if (saved)
+            (0, ui_1.success)('Test case saved.');
+        else
+            (0, ui_1.info)('Draft only. Re-run with --save to create it.');
+    }
+    catch (err) {
+        (0, ui_1.handleError)(err);
+    }
+}

package/dist/index.js

@@ -34,6 +34,10 @@ const contacts_1 = require("./commands/contacts");
 const skills_1 = require("./commands/skills");
 const update_1 = require("./commands/update");
 const analytics_1 = require("./commands/analytics");
+const dnd_1 = require("./commands/dnd");
+const feedback_1 = require("./commands/feedback");
+const knowledge_1 = require("./commands/knowledge");
+const aiTools_1 = require("./commands/aiTools");
 const batches_1 = require("./commands/batches");
 const simulations_1 = require("./commands/simulations");
 const simVariables_1 = require("./commands/simVariables");
@@ -342,7 +346,8 @@ kpi
     .command('assign')
     .description('assign a card to a person, or to AI FDE')
     .argument('<taskId>', 'task id — quote it in shells')
-    .requiredOption('--to <who>', 'team member id or name, or "ai_fde"')
+    .option('--to <who>', 'team member id or name, or "ai_fde" (required unless --unassign)')
+    .option('--unassign', 'unassign the card')
     .option('--agent <id>', 'agent to change (required for ai_fde)')
     .option('--versions <ids>', 'destination version ids (required for ai_fde)')
     .option('--version-names <names>', 'display names for the version ids')
@@ -462,8 +467,73 @@ kpi
     .command('history')
     .description('metric history for the given agents')
     .requiredOption('--agents <ids>', 'comma-separated agent ids (see `cku kpi agents`)')
+    .option('--since <date>', 'start date')
+    .option('--until <date>', 'end date')
     .option('--json', 'output raw JSON')
     .action(kpi_1.kpiHistoryCommand);
+kpi.command('import').description('import KPI cards from a JSON file')
+    .requiredOption('--file <path>', 'JSON file')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiImportCommand);
+kpi.command('detach <taskId> <url>').description('remove an attachment from a card')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiDetachCommand);
+kpi.command('rca-reports').description('daywise RCA reports')
+    .option('--agent <id>', 'agent id')
+    .option('--since <date>', 'start date')
+    .option('--until <date>', 'end date')
+    .option('--source <src>', 'report source')
+    .option('--page <n>', 'page number')
+    .option('--limit <n>', 'rows per page')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiRcaReportsCommand);
+kpi.command('rca-timeline <agentId>').description('day-by-day RCA execution events')
+    .option('--since <date>', 'start date')
+    .option('--until <date>', 'end date')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiRcaTimelineCommand);
+kpi.command('rca-pdf <agentId> <rcaDate>').description('download one RCA report as PDF')
+    .option('--manual', 'the manual-run report')
+    .option('--file <path>', 'output path')
+    .action(kpi_1.kpiRcaPdfCommand);
+kpi.command('rca-draft <agentId>').description('AI-draft the RCA prompt')
+    .requiredOption('--prompt <text>', 'what the RCA should focus on')
+    .option('--save', 'save the draft to the agent KPI config')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiRcaDraftPromptCommand);
+kpi.command('add-api-source <agentId>').description('add or replace an API data source')
+    .requiredOption('--name <name>', 'source name')
+    .requiredOption('--url <url>', 'endpoint URL')
+    .option('--headers <json>', 'headers JSON or @file')
+    .option('--params <json>', 'parameters JSON or @file')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiSourceAddApiCommand);
+kpi.command('add-python-source <agentId>').description('add or replace a Python data source')
+    .requiredOption('--name <name>', 'source name')
+    .requiredOption('--code <code|@file>', 'Python code, or @file')
+    .option('--params <json>', 'parameters JSON or @file')
+    .option('--skip-verify', 'skip the verification run')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiSourceAddPythonCommand);
+kpi.command('add-expr-source <agentId>').description('add or replace an expression data source')
+    .requiredOption('--name <name>', 'source name')
+    .option('--expression <rule>', 'rule expression')
+    .option('--conditions <json>', 'conditions JSON or @file')
+    .option('--consider-for <all|unique>', 'count all calls or unique callers')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiSourceAddExprCommand);
+kpi.command('remove-source <agentId> <name>').description('remove a data source')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiSourceRemoveCommand);
+kpi.command('set-metric <agentId>').description('add or replace a metric')
+    .requiredOption('--name <name>', 'metric name')
+    .requiredOption('--source <src>', 'data source name')
+    .requiredOption('--value <val>', 'value to match')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiMetricSetCommand);
+kpi.command('remove-metric <agentId> <name>').description('remove a metric')
+    .option('--json', 'output raw JSON')
+    .action(kpi_1.kpiMetricRemoveCommand);
 // Call analyzers and audit reports — also dashboard-side.
 const analyzers = program
     .command('analyzers')
@@ -490,6 +560,31 @@ analyzers
     .description('per-strategy audit rollup')
     .option('--json', 'output raw JSON')
     .action(analyzers_1.analyzersAuditStrategiesCommand);
+analyzers.command('summary <id>').description('analyzer summary rollup')
+    .option('--batch', 'id is a batch audit, not a call analyzer')
+    .option('--severity <sev>', 'filter by severity')
+    .option('--dimension <dim>', 'filter by dimension')
+    .option('--since <date>', 'start date')
+    .option('--until <date>', 'end date')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersSummaryCommand);
+analyzers.command('calls <id>').description('audited calls for an analyzer')
+    .option('--batch', 'id is a batch audit')
+    .option('--below-80', 'only calls scoring under 80')
+    .option('--severity <sev>', 'filter by severity')
+    .option('--dimension <dim>', 'filter by dimension')
+    .option('--category <cat>', 'filter by category')
+    .option('--var-name <name>', 'filter by call variable name')
+    .option('--var-value <val>', 'filter by call variable value')
+    .option('--sort <sort>', 'sort order')
+    .option('--page <n>', 'page number')
+    .option('--limit <n>', 'rows per page')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersCallsCommand);
+analyzers.command('call <id> <callId>').description('one call audit in full')
+    .option('--batch', 'id is a batch audit')
+    .option('--json', 'output raw JSON')
+    .action(analyzers_1.analyzersCallDetailCommand);
 program
     .command('config')
     .description('show effective CLI settings and session status')
@@ -749,6 +844,39 @@ agents.command('ab-advanced <agentId>').description('rule-based A/B: if/elseif/e
     .option('--disable', 'turn off advanced A/B testing')
     .option('--json', 'raw JSON (with --show)')
     .action(agentVersions_1.agentsAbAdvancedCommand);
+agents.command('commits <agentId>').description('commit history of an agent (needs `cku dashboard login`)')
+    .option('--versions <id>', 'limit to one version')
+    .option('--page <n>', 'page number')
+    .option('--limit <n>', 'rows per page')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsCommitsCommand);
+agents.command('commit <commitId>').description('show one commit')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsCommitShowCommand);
+agents.command('diff <agentId>').description('diff two commits or two versions')
+    .option('--commits <idA,idB>', 'two commit ids')
+    .option('--versions <vA,vB>', 'two version ids')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsDiffCommand);
+agents.command('revert <agentId> <commitId>').description('revert a version to a commit')
+    .option('--yes', 'skip confirmation')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsRevertCommand);
+agents.command('save-v2 <agentId>').description('save a version with a commit message')
+    .option('--versions <v>', 'version id')
+    .requiredOption('--set <json|@file>', 'fields to save, JSON or @file')
+    .option('--message <msg>', 'commit message')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsSaveV2Command);
+agents.command('delete-version <agentId> <versionId>').description('delete a version')
+    .option('--yes', 'skip confirmation')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsDeleteVersionCommand);
+agents.command('duplicate <agentId>').description('duplicate an agent under a new name')
+    .requiredOption('--name <name>', 'name of the copy')
+    .option('--versions <ids>', 'version ids to copy')
+    .option('--json', 'raw JSON')
+    .action(agentVersions_1.agentsDuplicateCommand);
 // --- chat agents -----------------------------------------------------------
 const chatAgents = program.command('chat-agents').description('manage chat agents');
 chatAgents.command('models').description('list models available for chat agents')
@@ -975,6 +1103,26 @@ analytics.command('version <agentId>').description('per-version analytics for an
     .option('--end <date>', 'end date')
     .option('--json', 'raw JSON')
     .action(analytics_1.analyticsVersionCommand);
+analytics.command('failed-responses').description('failed-response buckets (needs `cku dashboard login`)')
+    .option('--agent <ids>', 'agent id(s), comma-separated')
+    .option('--start <YYYY-MM-DD>', 'start date')
+    .option('--end <YYYY-MM-DD>', 'end date')
+    .option('--response <bucket>', 'drill into one bucket')
+    .option('--limit <n>', 'rows')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsFailedResponsesCommand);
+analytics.command('functions').description('function-call stats (needs `cku dashboard login`)')
+    .option('--agent <ids>', 'agent id(s), comma-separated')
+    .option('--start <YYYY-MM-DD>', 'start date')
+    .option('--end <YYYY-MM-DD>', 'end date')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsFunctionsCommand);
+analytics.command('chat').description('chat agent analytics (needs `cku dashboard login`)')
+    .option('--agent <id>', 'chat agent id')
+    .option('--start <YYYY-MM-DD>', 'start date')
+    .option('--end <YYYY-MM-DD>', 'end date')
+    .option('--json', 'raw JSON')
+    .action(analytics_1.analyticsChatCommand);
 // --- batches ---------------------------------------------------------------
 const batches = program.command('batches').description('batch calls');
 batches.command('create').description('create a batch from a local CSV (uploads + starts dialing)')
@@ -1052,6 +1200,19 @@ sim.command('results <batchId>').description('results of a simulation run').opti
     .option('--agent <agentId>', 'with --wait, the agent the batch belongs to')
     .option('--timeout <seconds>', 'with --wait, give up after this long (default 600)')
     .action(simulations_1.simResultsCommand);
+sim.command('draft-from-call <callId>').description('AI-draft a test case from a real call (needs `cku dashboard login`)')
+    .requiredOption('--version <versionId>', 'agent version the call ran on')
+    .option('--no-metadata', 'leave out call metadata')
+    .option('--no-functions', 'leave out function mocks')
+    .option('--save', 'save the draft as a test case')
+    .option('--json', 'raw JSON')
+    .action(simulations_1.simDraftFromCallCommand);
+sim.command('generate <agentId>').description('AI-draft a test case from a hint (needs `cku dashboard login`)')
+    .requiredOption('--hint <text>', 'scenario to test')
+    .option('--version <versionId>', 'agent version')
+    .option('--save', 'save the draft as a test case')
+    .option('--json', 'raw JSON')
+    .action(simulations_1.simGenerateCommand);
 // Saved variable sets are dashboard-only (cookie-authed): they need `cku dashboard login`.
 const simVars = sim.command('variables').description('saved variable sets for test cases (needs `cku dashboard login`)');
 simVars.command('list <agentId>').description('list saved variable sets').option('--json', 'raw JSON')
@@ -1174,6 +1335,71 @@ ${chalk_1.default.bold('Examples:')}
   ${chalk_1.default.cyan(`${name} agents update <agentId> --set '{"name":"New"}' --commit "rename"`)}
   ${chalk_1.default.cyan(`${name} calls make --agent <id> --to <number> --test`)}  place a test call
 `);
+// --- DND, feedback, knowledge, AI helpers (dashboard session) ---------------
+const dnd = program.command('dnd').description('do-not-disturb list (needs `cku dashboard login`)');
+dnd.command('list').description('list DND numbers')
+    .option('--page <n>', 'page').option('--limit <n>', 'rows').option('--search <text>', 'search')
+    .option('--since <date>', 'from').option('--until <date>', 'to').option('--json', 'raw JSON')
+    .action(dnd_1.dndListCommand);
+dnd.command('add <phone>').description('add a number').option('--json', 'raw JSON').action(dnd_1.dndAddCommand);
+dnd.command('update <id> <phone>').description('change a number').option('--json', 'raw JSON').action(dnd_1.dndUpdateCommand);
+dnd.command('remove <ids>').description('remove entries (comma-separated ids)')
+    .option('--yes', 'skip confirmation').option('--json', 'raw JSON').action(dnd_1.dndRemoveCommand);
+dnd.command('import').description('bulk add numbers')
+    .option('--phones <csv>', 'comma-separated numbers')
+    .option('--file <path>', 'file with numbers (comma/newline list or JSON array)')
+    .option('--json', 'raw JSON').action(dnd_1.dndImportCommand);
+const feedback = program.command('feedback').description('call feedback tickets (needs `cku dashboard login`)');
+feedback.command('list').description('list tickets')
+    .option('--status <status>', 'ticket status (default processing)').option('--page <n>', 'page').option('--json', 'raw JSON')
+    .action(feedback_1.feedbackListCommand);
+feedback.command('create').description('open a ticket about a call')
+    .option('--call <callId>', 'call with the issue')
+    .option('--version <versionId>', 'agent version')
+    .option('--engineer <id>', 'engineer to assign')
+    .option('--name <title>', 'ticket title')
+    .option('--issue <text>', 'what went wrong')
+    .option('--json', 'raw JSON')
+    .action(feedback_1.feedbackCreateCommand);
+feedback.command('comment <id> <text>').description('comment on a ticket').option('--json', 'raw JSON').action(feedback_1.feedbackCommentCommand);
+feedback.command('submit-review <id>').description('submit a ticket for review')
+    .option('--calls <urls>', 'resolved call URLs, comma-separated')
+    .option('--version-url <url>', 'resolved version URL')
+    .option('--comment <text>', 'comment')
+    .option('--json', 'raw JSON')
+    .action(feedback_1.feedbackSubmitReviewCommand);
+feedback.command('reopen <id>').description('reopen a ticket')
+    .option('--comment <text>', 'why').option('--json', 'raw JSON').action(feedback_1.feedbackReopenCommand);
+feedback.command('resolve <id>').description('resolve a ticket')
+    .option('--comment <text>', 'comment').option('--json', 'raw JSON').action(feedback_1.feedbackResolveCommand);
+const knowledge = program.command('knowledge').description('knowledge base (needs `cku dashboard login`)');
+knowledge.command('list').description('list knowledge documents').option('--json', 'raw JSON').action(knowledge_1.knowledgeListCommand);
+knowledge.command('delete <id>').description('delete a document')
+    .option('--yes', 'skip confirmation').option('--json', 'raw JSON').action(knowledge_1.knowledgeDeleteCommand);
+const ai = program.command('ai').description('AI drafting helpers (needs `cku dashboard login`)');
+ai.command('function').description('draft function code from a prompt')
+    .option('--prompt <text>', 'what the function should do')
+    .option('--name <name>', 'function name').option('--description <desc>', 'function description')
+    .option('--type <type>', 'function type')
+    .option('--code <code|@file>', 'existing code to edit')
+    .option('--vars <csv>', 'prompt variables, comma-separated')
+    .option('--chat', 'chat-agent function')
+    .option('--json', 'raw JSON')
+    .action(aiTools_1.aiGenerateFunctionCommand);
+ai.command('postcall').description('draft post-call config')
+    .option('--set <json|@file>', 'request body, JSON or @file').option('--json', 'raw JSON')
+    .action(aiTools_1.aiGeneratePostcallCommand);
+ai.command('audit-strategy <agentId>').description('draft an audit strategy for an agent')
+    .option('--prompt <text>', 'guidance').option('--existing <text>', 'existing strategy to refine').option('--json', 'raw JSON')
+    .action(aiTools_1.aiGenerateAuditStrategyCommand);
+ai.command('callflow-summary <agentId>').description('draft a call-flow summary for an agent')
+    .option('--prompt <text>', 'guidance').option('--existing <text>', 'existing summary to refine').option('--json', 'raw JSON')
+    .action(aiTools_1.aiGenerateCallflowSummaryCommand);
+ai.command('workflow-code').description('draft workflow step code')
+    .option('--prompt <text>', 'what the step should do').option('--name <name>', 'step name')
+    .option('--key <key>', 'step key').option('--existing <code|@file>', 'existing code')
+    .option('--json', 'raw JSON')
+    .action(aiTools_1.aiGenerateWorkflowCodeCommand);
 // Bare invocation → show help instead of an error.
 if (process.argv.length <= 2) {
     program.outputHelp();