@agentlensai/cli 0.2.0 → 0.3.0

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+export declare function runConfigCommand(args: string[]): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA4CrD"}

package/dist/commands/config.js

@@ -0,0 +1,43 @@
+/**
+ * agentlens config — get/set configuration
+ */
+import { loadConfig, saveConfig, maskApiKey } from '../lib/config.js';
+export function runConfigCommand(args) {
+    const subcommand = args[0];
+    if (subcommand === 'set') {
+        const key = args[1];
+        const value = args[2];
+        if (!key || !value) {
+            console.error('Usage: agentlens config set <key> <value>');
+            console.error('Keys: url, api-key');
+            process.exit(1);
+        }
+        const config = loadConfig();
+        switch (key) {
+            case 'url':
+                config.url = value;
+                break;
+            case 'api-key':
+                config.apiKey = value;
+                break;
+            default:
+                console.error(`Unknown config key: ${key}`);
+                console.error('Valid keys: url, api-key');
+                process.exit(1);
+        }
+        saveConfig(config);
+        console.log(`✓ Set ${key}`);
+        return;
+    }
+    if (subcommand === 'get' || !subcommand) {
+        const config = loadConfig();
+        console.log('AgentLens CLI Configuration:');
+        console.log(`  url:     ${config.url}`);
+        console.log(`  api-key: ${config.apiKey ? maskApiKey(config.apiKey) : '(not set)'}`);
+        return;
+    }
+    console.error(`Unknown config subcommand: ${subcommand}`);
+    console.error('Usage: agentlens config [get|set <key> <value>]');
+    process.exit(1);
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEtE,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3B,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC3D,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,KAAK;gBACR,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC;gBACnB,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;gBACtB,MAAM;YACR;gBACE,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;gBAC5C,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED,UAAU,CAAC,MAAM,CAAC,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACrF,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,8BAA8B,UAAU,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/commands/events.d.ts

@@ -0,0 +1,2 @@
+export declare function runEventsCommand(argv: string[]): Promise<void>;
+//# sourceMappingURL=events.d.ts.map

package/dist/commands/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AAQA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDpE"}

package/dist/commands/events.js

@@ -0,0 +1,58 @@
+/**
+ * agentlens events — query events
+ */
+import { parseArgs } from 'node:util';
+import { createClientFromConfig } from '../lib/client.js';
+import { printTable, printJson, formatTimestamp, truncate } from '../lib/output.js';
+export async function runEventsCommand(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            session: { type: 'string', short: 's' },
+            type: { type: 'string', short: 't' },
+            limit: { type: 'string', short: 'l' },
+            json: { type: 'boolean', short: 'j', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+        },
+        allowPositionals: true,
+    });
+    if (values.help) {
+        console.log(`Usage: agentlens events [options]
+
+Options:
+  -s, --session <id>    Filter by session ID
+  -t, --type <type>     Filter by event type (e.g. tool_call)
+  -l, --limit <n>       Max number of events (default: 20)
+  -j, --json            Output raw JSON
+  -h, --help            Show help`);
+        return;
+    }
+    const client = createClientFromConfig();
+    const limit = values.limit ? parseInt(values.limit, 10) : 20;
+    const result = await client.queryEvents({
+        sessionId: values.session ?? undefined,
+        eventType: values.type ?? undefined,
+        limit,
+        order: 'desc',
+    });
+    if (values.json) {
+        printJson(result);
+        return;
+    }
+    if (result.events.length === 0) {
+        console.log('No events found.');
+        return;
+    }
+    const headers = ['ID', 'Time', 'Session', 'Type', 'Severity', 'Agent'];
+    const rows = result.events.map((e) => [
+        truncate(e.id, 16),
+        formatTimestamp(e.timestamp),
+        truncate(e.sessionId, 14),
+        e.eventType,
+        e.severity,
+        truncate(e.agentId, 14),
+    ]);
+    printTable(headers, rows);
+    console.log(`\nShowing ${result.events.length} of ${result.total} events.`);
+}
+//# sourceMappingURL=events.js.map

package/dist/commands/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/commands/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEpF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACvC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACpC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;YACrD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;SACtD;QACD,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;kCAOkB,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS;QACtC,SAAS,EAAG,MAAM,CAAC,IAAkB,IAAI,SAAS;QAClD,KAAK;QACL,KAAK,EAAE,MAAM;KACd,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACpC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QAClB,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5B,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,QAAQ;QACV,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;KACxB,CAAC,CAAC;IAEH,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,UAAU,CAAC,CAAC;AAC9E,CAAC"}

package/dist/commands/llm.d.ts

@@ -0,0 +1,2 @@
+export declare function runLlmCommand(argv: string[]): Promise<void>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/commands/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/commands/llm.ts"],"names":[],"mappings":"AAwBA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBjE"}

package/dist/commands/llm.js

@@ -0,0 +1,226 @@
+/**
+ * agentlens llm — LLM call tracking stats, model breakdown, and recent calls
+ */
+import { parseArgs } from 'node:util';
+import { createClientFromConfig } from '../lib/client.js';
+import { printTable, printJson, formatTimestamp, truncate } from '../lib/output.js';
+const HELP = `Usage: agentlens llm <subcommand> [options]
+
+Subcommands:
+  stats               Show LLM usage summary
+  models              List models with cost breakdown
+  recent              Show recent LLM calls
+
+Options:
+  --from <date>       Start date (ISO 8601)
+  --to <date>         End date (ISO 8601)
+  --agent <id>        Filter by agent ID
+  --model <name>      Filter by model name
+  --url <url>         Server URL (overrides config)
+  -j, --json          Output raw JSON
+  -h, --help          Show help`;
+export async function runLlmCommand(argv) {
+    const subcommand = argv[0];
+    const rest = argv.slice(1);
+    switch (subcommand) {
+        case 'stats':
+            await runLlmStats(rest);
+            break;
+        case 'models':
+            await runLlmModels(rest);
+            break;
+        case 'recent':
+            await runLlmRecent(rest);
+            break;
+        case '--help':
+        case '-h':
+        case undefined:
+            console.log(HELP);
+            break;
+        default:
+            console.error(`Unknown llm subcommand: ${subcommand}`);
+            console.log(HELP);
+            process.exit(1);
+    }
+}
+function parseLlmArgs(argv) {
+    return parseArgs({
+        args: argv,
+        options: {
+            from: { type: 'string' },
+            to: { type: 'string' },
+            agent: { type: 'string', short: 'a' },
+            model: { type: 'string', short: 'm' },
+            url: { type: 'string' },
+            json: { type: 'boolean', short: 'j', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+        },
+        allowPositionals: false,
+    });
+}
+function formatCost(usd) {
+    return `$${usd.toFixed(4)}`;
+}
+function formatNumber(n) {
+    return n.toLocaleString('en-US');
+}
+function formatLatency(ms) {
+    return `${formatNumber(Math.round(ms))}ms`;
+}
+/**
+ * agentlens llm stats — show LLM usage summary
+ */
+async function runLlmStats(argv) {
+    const { values } = parseLlmArgs(argv);
+    if (values.help) {
+        console.log(`Usage: agentlens llm stats [options]
+
+Show overall LLM usage summary: total calls, cost, tokens, and latency.
+
+Options:
+  --from <date>       Start date (ISO 8601)
+  --to <date>         End date (ISO 8601)
+  --agent <id>        Filter by agent ID
+  --model <name>      Filter by model name
+  --url <url>         Server URL (overrides config)
+  -j, --json          Output raw JSON
+  -h, --help          Show help`);
+        return;
+    }
+    const client = createClientFromConfig(values.url);
+    const analytics = await client.getLlmAnalytics({
+        from: values.from ?? undefined,
+        to: values.to ?? undefined,
+        agentId: values.agent ?? undefined,
+        model: values.model ?? undefined,
+    });
+    if (values.json) {
+        printJson(analytics.summary);
+        return;
+    }
+    const s = analytics.summary;
+    const totalTokens = s.totalInputTokens + s.totalOutputTokens;
+    console.log('');
+    console.log('LLM Usage Summary');
+    console.log(`  Total Calls:     ${formatNumber(s.totalCalls)}`);
+    console.log(`  Total Cost:      ${formatCost(s.totalCostUsd)}`);
+    console.log(`  Total Tokens:    ${formatNumber(totalTokens)} (${formatNumber(s.totalInputTokens)} in / ${formatNumber(s.totalOutputTokens)} out)`);
+    console.log(`  Avg Latency:     ${formatLatency(s.avgLatencyMs)}`);
+    console.log(`  Avg Cost/Call:   ${formatCost(s.avgCostPerCall)}`);
+    console.log('');
+}
+/**
+ * agentlens llm models — list models with cost breakdown
+ */
+async function runLlmModels(argv) {
+    const { values } = parseLlmArgs(argv);
+    if (values.help) {
+        console.log(`Usage: agentlens llm models [options]
+
+List models used with cost breakdown.
+
+Options:
+  --from <date>       Start date (ISO 8601)
+  --to <date>         End date (ISO 8601)
+  --agent <id>        Filter by agent ID
+  --model <name>      Filter by model name
+  --url <url>         Server URL (overrides config)
+  -j, --json          Output raw JSON
+  -h, --help          Show help`);
+        return;
+    }
+    const client = createClientFromConfig(values.url);
+    const analytics = await client.getLlmAnalytics({
+        from: values.from ?? undefined,
+        to: values.to ?? undefined,
+        agentId: values.agent ?? undefined,
+        model: values.model ?? undefined,
+    });
+    if (values.json) {
+        printJson(analytics.byModel);
+        return;
+    }
+    if (analytics.byModel.length === 0) {
+        console.log('No LLM calls found.');
+        return;
+    }
+    const headers = ['Provider', 'Model', 'Calls', 'Tokens', 'Cost', 'Avg Latency'];
+    const rows = analytics.byModel.map((m) => [
+        m.provider,
+        truncate(m.model, 28),
+        formatNumber(m.calls),
+        formatNumber(m.inputTokens + m.outputTokens),
+        formatCost(m.costUsd),
+        formatLatency(m.avgLatencyMs),
+    ]);
+    printTable(headers, rows);
+    console.log(`\n${analytics.byModel.length} model(s).`);
+}
+/**
+ * agentlens llm recent — show recent LLM calls
+ */
+async function runLlmRecent(argv) {
+    const { values } = parseLlmArgs(argv);
+    if (values.help) {
+        console.log(`Usage: agentlens llm recent [options]
+
+Show recent LLM calls with latency and cost.
+
+Options:
+  --from <date>       Start date (ISO 8601)
+  --to <date>         End date (ISO 8601)
+  --agent <id>        Filter by agent ID
+  --model <name>      Filter by model name
+  --url <url>         Server URL (overrides config)
+  -j, --json          Output raw JSON
+  -h, --help          Show help`);
+        return;
+    }
+    const client = createClientFromConfig(values.url);
+    // Query recent llm_response events (they carry all the metrics)
+    const result = await client.queryEvents({
+        eventType: 'llm_response',
+        from: values.from ?? undefined,
+        to: values.to ?? undefined,
+        agentId: values.agent ?? undefined,
+        limit: 10,
+        order: 'desc',
+    });
+    if (values.json) {
+        printJson(result);
+        return;
+    }
+    if (result.events.length === 0) {
+        console.log('No recent LLM calls found.');
+        return;
+    }
+    // Filter by model if specified (server may not support model filter on events query)
+    let events = result.events;
+    if (values.model) {
+        events = events.filter((e) => {
+            const p = e.payload;
+            return p['model'] === values.model;
+        });
+    }
+    const headers = ['Timestamp', 'Model', 'Tokens', 'Cost', 'Latency', 'Finish'];
+    const rows = events.map((e) => {
+        const p = e.payload;
+        const usage = p['usage'];
+        const totalTokens = usage?.['totalTokens'] ?? 0;
+        const costUsd = p['costUsd'] ?? 0;
+        const latencyMs = p['latencyMs'] ?? 0;
+        const model = String(p['model'] ?? 'unknown');
+        const finishReason = String(p['finishReason'] ?? '');
+        return [
+            formatTimestamp(e.timestamp),
+            truncate(model, 24),
+            formatNumber(totalTokens),
+            formatCost(costUsd),
+            formatLatency(latencyMs),
+            finishReason,
+        ];
+    });
+    printTable(headers, rows);
+    console.log(`\nShowing ${events.length} of ${result.total} LLM calls.`);
+}
+//# sourceMappingURL=llm.js.map

package/dist/commands/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/commands/llm.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEpF,MAAM,IAAI,GAAG;;;;;;;;;;;;;;gCAcmB,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,OAAO;YACV,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YACzB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YACzB,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAAc;IAClC,OAAO,SAAS,CAAC;QACf,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;YACrD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;SACtD;QACD,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,aAAa,CAAC,EAAU;IAC/B,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,IAAc;IACvC,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;gCAWgB,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;QAC7C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;QAC9B,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,SAAS;QAC1B,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;QAClC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;KACjC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;IAC5B,MAAM,WAAW,GAAG,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,iBAAiB,CAAC;IAE7D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,sBAAsB,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,sBAAsB,YAAY,CAAC,WAAW,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACnJ,OAAO,CAAC,GAAG,CAAC,sBAAsB,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,IAAc;IACxC,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;gCAWgB,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;QAC7C,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;QAC9B,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,SAAS;QAC1B,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;QAClC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;KACjC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACxC,CAAC,CAAC,QAAQ;QACV,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QACrB,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;QACrB,YAAY,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC;QAC5C,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;QACrB,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;KAC9B,CAAC,CAAC;IAEH,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAC,IAAc;IACxC,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEtC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;gCAWgB,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAElD,gEAAgE;IAChE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACtC,SAAS,EAAE,cAA2B;QACtC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,SAAS;QAC9B,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,SAAS;QAC1B,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;QAClC,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,MAAM;KACd,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IAED,qFAAqF;IACrF,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAkC,CAAC;YAC/C,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAkC,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAuC,CAAC;QAC/D,MAAM,WAAW,GAAG,KAAK,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,OAAO,GAAI,CAAC,CAAC,SAAS,CAAY,IAAI,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAI,CAAC,CAAC,WAAW,CAAY,IAAI,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;QAErD,OAAO;YACL,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5B,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;YACnB,YAAY,CAAC,WAAW,CAAC;YACzB,UAAU,CAAC,OAAO,CAAC;YACnB,aAAa,CAAC,SAAS,CAAC;YACxB,YAAY;SACb,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,aAAa,CAAC,CAAC;AAC1E,CAAC"}

package/dist/commands/sessions.d.ts

@@ -0,0 +1,2 @@
+export declare function runSessionsCommand(argv: string[]): Promise<void>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/commands/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/commands/sessions.ts"],"names":[],"mappings":"AAcA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEtE"}

package/dist/commands/sessions.js

@@ -0,0 +1,120 @@
+/**
+ * agentlens sessions — list and inspect sessions
+ */
+import { parseArgs } from 'node:util';
+import { createClientFromConfig } from '../lib/client.js';
+import { printTable, printJson, formatTimestamp, formatDuration, truncate, } from '../lib/output.js';
+export async function runSessionsCommand(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            status: { type: 'string' },
+            agent: { type: 'string', short: 'a' },
+            limit: { type: 'string', short: 'l' },
+            json: { type: 'boolean', short: 'j', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+        },
+        allowPositionals: true,
+    });
+    // agentlens sessions show <id>
+    if (positionals[0] === 'show') {
+        const sessionId = positionals[1];
+        if (!sessionId) {
+            console.error('Usage: agentlens sessions show <session-id>');
+            process.exit(1);
+        }
+        await showSession(sessionId, values.json ?? false);
+        return;
+    }
+    if (values.help) {
+        console.log(`Usage: agentlens sessions [options]
+       agentlens sessions show <id>
+
+Options:
+  --status <status>   Filter by status (active, completed, error)
+  -a, --agent <id>    Filter by agent ID
+  -l, --limit <n>     Max number of sessions (default: 20)
+  -j, --json          Output raw JSON
+  -h, --help          Show help`);
+        return;
+    }
+    const client = createClientFromConfig();
+    const limit = values.limit ? parseInt(values.limit, 10) : 20;
+    const result = await client.getSessions({
+        status: values.status ?? undefined,
+        agentId: values.agent ?? undefined,
+        limit,
+    });
+    if (values.json) {
+        printJson(result);
+        return;
+    }
+    if (result.sessions.length === 0) {
+        console.log('No sessions found.');
+        return;
+    }
+    const headers = ['ID', 'Agent', 'Status', 'Started', 'Duration', 'Events', 'Errors'];
+    const rows = result.sessions.map((s) => [
+        truncate(s.id, 16),
+        truncate(s.agentId, 14),
+        s.status,
+        formatTimestamp(s.startedAt),
+        formatDuration(s.startedAt, s.endedAt),
+        String(s.eventCount),
+        String(s.errorCount),
+    ]);
+    printTable(headers, rows);
+    console.log(`\nShowing ${result.sessions.length} of ${result.total} sessions.`);
+}
+async function showSession(sessionId, json) {
+    const client = createClientFromConfig();
+    const [session, timeline] = await Promise.all([
+        client.getSession(sessionId),
+        client.getSessionTimeline(sessionId),
+    ]);
+    if (json) {
+        printJson({ session, timeline });
+        return;
+    }
+    console.log(`\nSession: ${session.id}`);
+    console.log(`  Agent:    ${session.agentId}${session.agentName ? ` (${session.agentName})` : ''}`);
+    console.log(`  Status:   ${session.status}`);
+    console.log(`  Started:  ${formatTimestamp(session.startedAt)}`);
+    console.log(`  Duration: ${formatDuration(session.startedAt, session.endedAt)}`);
+    console.log(`  Events:   ${session.eventCount} total, ${session.toolCallCount} tool calls, ${session.errorCount} errors`);
+    if (session.totalCostUsd > 0) {
+        console.log(`  Cost:     $${session.totalCostUsd.toFixed(4)}`);
+    }
+    console.log(`  Chain:    ${timeline.chainValid ? '✓ valid' : '✗ broken'}`);
+    if (timeline.events.length > 0) {
+        console.log(`\nTimeline (${timeline.events.length} events):`);
+        const headers = ['Time', 'Type', 'Severity', 'Summary'];
+        const rows = timeline.events.map((e) => [
+            formatTimestamp(e.timestamp),
+            e.eventType,
+            e.severity,
+            truncate(summarizePayload(e.eventType, e.payload), 40),
+        ]);
+        printTable(headers, rows);
+    }
+}
+function summarizePayload(eventType, payload) {
+    if (!payload || typeof payload !== 'object')
+        return '';
+    const p = payload;
+    switch (eventType) {
+        case 'tool_call':
+            return `${p['toolName'] ?? 'unknown'}()`;
+        case 'tool_response':
+            return `${p['toolName'] ?? ''} → ${p['durationMs'] ?? '?'}ms`;
+        case 'tool_error':
+            return `${p['toolName'] ?? ''}: ${p['error'] ?? 'error'}`;
+        case 'session_started':
+            return p['agentName'] ? String(p['agentName']) : '';
+        case 'session_ended':
+            return String(p['reason'] ?? 'ended');
+        default:
+            return '';
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/commands/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/commands/sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,UAAU,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAc;IACrD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;YACrC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;YACrD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;SACtD;QACD,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IAEH,+BAA+B;IAC/B,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;gCAQgB,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACtC,MAAM,EAAG,MAAM,CAAC,MAAwB,IAAI,SAAS;QACrD,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS;QAClC,KAAK;KACN,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,SAAS,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QAClB,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACvB,CAAC,CAAC,MAAM;QACR,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5B,cAAc,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;QACpB,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;KACrB,CAAC,CAAC;IAEH,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,YAAY,CAAC,CAAC;AAClF,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,SAAiB,EAAE,IAAa;IACzD,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IAExC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;QAC5B,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC;KACrC,CAAC,CAAC;IAEH,IAAI,IAAI,EAAE,CAAC;QACT,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnG,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,eAAe,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,eAAe,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,UAAU,WAAW,OAAO,CAAC,aAAa,gBAAgB,OAAO,CAAC,UAAU,SAAS,CAAC,CAAC;IAC1H,IAAI,OAAO,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IAE3E,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACtC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,QAAQ;YACV,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;SACvD,CAAC,CAAC;QACH,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,OAAgB;IAC3D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,CAAC,GAAG,OAAkC,CAAC;IAE7C,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,SAAS,IAAI,CAAC;QAC3C,KAAK,eAAe;YAClB,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC;QAChE,KAAK,YAAY;YACf,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,OAAO,EAAE,CAAC;QAC5D,KAAK,iBAAiB;YACpB,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC;QACxC;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/commands/tail.d.ts

@@ -0,0 +1,2 @@
+export declare function runTailCommand(argv: string[]): Promise<void>;
+//# sourceMappingURL=tail.d.ts.map

package/dist/commands/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../src/commands/tail.ts"],"names":[],"mappings":"AAUA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoGlE"}

package/dist/commands/tail.js

@@ -0,0 +1,151 @@
+/**
+ * agentlens tail — stream live events via SSE
+ *
+ * Connects to the /api/stream SSE endpoint. The endpoint is being built
+ * in Epic 14 in parallel — the command structure is ready for it.
+ */
+import { parseArgs } from 'node:util';
+import { loadConfig } from '../lib/config.js';
+import { formatTimestamp, truncate } from '../lib/output.js';
+export async function runTailCommand(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            session: { type: 'string', short: 's' },
+            type: { type: 'string', short: 't' },
+            json: { type: 'boolean', short: 'j', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+        },
+        allowPositionals: false,
+    });
+    if (values.help) {
+        console.log(`Usage: agentlens tail [options]
+
+Stream live events as they arrive.
+
+Options:
+  -s, --session <id>    Filter by session ID
+  -t, --type <type>     Filter by event type
+  -j, --json            Output raw JSON per event
+  -h, --help            Show help
+
+Press Ctrl+C to stop.`);
+        return;
+    }
+    const config = loadConfig();
+    const baseUrl = config.url.replace(/\/+$/, '');
+    // Build SSE URL with filters
+    const params = new URLSearchParams();
+    if (values.session)
+        params.set('sessionId', values.session);
+    if (values.type)
+        params.set('eventType', values.type);
+    const sseUrl = `${baseUrl}/api/stream${params.toString() ? '?' + params.toString() : ''}`;
+    const headers = {
+        'Accept': 'text/event-stream',
+    };
+    if (config.apiKey) {
+        headers['Authorization'] = `Bearer ${config.apiKey}`;
+    }
+    console.log(`Connecting to ${baseUrl}...`);
+    // Use native fetch with streaming (works in Node.js ≥ 18)
+    let response;
+    try {
+        response = await fetch(sseUrl, {
+            headers,
+            signal: createAbortOnSigint(),
+        });
+    }
+    catch (err) {
+        if (err.name === 'AbortError') {
+            console.log('\nDisconnected.');
+            return;
+        }
+        console.error(`Failed to connect: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        console.error(`Server returned ${response.status}: ${text}`);
+        process.exit(1);
+    }
+    if (!response.body) {
+        console.error('No response body (streaming not supported)');
+        process.exit(1);
+    }
+    console.log('Connected. Streaming events (Ctrl+C to stop)...\n');
+    // Parse SSE stream
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        for await (const chunk of response.body) {
+            buffer += decoder.decode(chunk, { stream: true });
+            // Process complete SSE messages (double newline separated)
+            const messages = buffer.split('\n\n');
+            buffer = messages.pop() ?? '';
+            for (const msg of messages) {
+                processSSEMessage(msg, values.json ?? false);
+            }
+        }
+    }
+    catch (err) {
+        if (err.name === 'AbortError') {
+            // Normal Ctrl+C
+        }
+        else {
+            console.error(`\nStream error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    console.log('\nDisconnected.');
+}
+/**
+ * Parse and display a single SSE message.
+ */
+function processSSEMessage(raw, jsonOutput) {
+    let eventType = 'message';
+    let data = '';
+    for (const line of raw.split('\n')) {
+        if (line.startsWith('event:')) {
+            eventType = line.slice(6).trim();
+        }
+        else if (line.startsWith('data:')) {
+            data += line.slice(5).trim();
+        }
+    }
+    // Skip heartbeats
+    if (eventType === 'heartbeat')
+        return;
+    if (!data)
+        return;
+    if (jsonOutput) {
+        console.log(data);
+        return;
+    }
+    // Try to parse as event JSON
+    try {
+        const event = JSON.parse(data);
+        const ts = typeof event['timestamp'] === 'string' ? formatTimestamp(event['timestamp']) : '';
+        const type = event['eventType'] ?? eventType;
+        const severity = event['severity'] ?? 'info';
+        const session = truncate(String(event['sessionId'] ?? ''), 14);
+        const agent = truncate(String(event['agentId'] ?? ''), 14);
+        console.log(`[${ts}] ${String(type).padEnd(16)} ${String(severity).padEnd(8)} ${session}  ${agent}`);
+    }
+    catch {
+        // Raw message
+        console.log(`[${eventType}] ${truncate(data, 100)}`);
+    }
+}
+/**
+ * Create an AbortSignal that triggers on SIGINT (Ctrl+C).
+ */
+function createAbortOnSigint() {
+    const controller = new AbortController();
+    const handler = () => {
+        controller.abort();
+        process.removeListener('SIGINT', handler);
+    };
+    process.on('SIGINT', handler);
+    return controller.signal;
+}
+//# sourceMappingURL=tail.js.map

package/dist/commands/tail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.js","sourceRoot":"","sources":["../../src/commands/tail.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
+#!/usr/bin/env node
 /**
- * @agentlens/cli — Command-line interface for AgentLens
+ * @agentlensai/cli — Command-line interface for AgentLens
+ *
+ * Uses node:util parseArgs for lightweight argument parsing.
  */
-export declare const PACKAGE_NAME: "@agentlens/cli";
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,YAAY,EAAG,gBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/index.js

@@ -1,5 +1,87 @@
+#!/usr/bin/env node
 /**
- * @agentlens/cli — Command-line interface for AgentLens
+ * @agentlensai/cli — Command-line interface for AgentLens
+ *
+ * Uses node:util parseArgs for lightweight argument parsing.
  */
-export const PACKAGE_NAME = '@agentlens/cli';
+import { runConfigCommand } from './commands/config.js';
+import { runEventsCommand } from './commands/events.js';
+import { runLlmCommand } from './commands/llm.js';
+import { runSessionsCommand } from './commands/sessions.js';
+import { runTailCommand } from './commands/tail.js';
+const HELP = `AgentLens CLI — Observability for AI agents
+
+Usage: agentlens <command> [options]
+
+Commands:
+  config              Get or set configuration (url, api-key)
+  events              Query events
+  sessions            List and inspect sessions
+  tail                Stream live events (SSE)
+  llm                 LLM call tracking (stats, models, recent)
+
+Run "agentlens <command> --help" for command-specific help.
+
+Configuration:
+  agentlens config set url http://localhost:3400
+  agentlens config set api-key als_xxx
+  agentlens config get
+`;
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    const rest = args.slice(1);
+    switch (command) {
+        case 'config':
+            runConfigCommand(rest);
+            break;
+        case 'events':
+            await runEventsCommand(rest);
+            break;
+        case 'llm':
+            await runLlmCommand(rest);
+            break;
+        case 'sessions':
+            await runSessionsCommand(rest);
+            break;
+        case 'tail':
+            await runTailCommand(rest);
+            break;
+        case '--help':
+        case '-h':
+        case undefined:
+            console.log(HELP);
+            break;
+        case '--version':
+        case '-v':
+            console.log('0.0.0');
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.log(HELP);
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    if (err && typeof err === 'object' && 'name' in err) {
+        const e = err;
+        // Show friendly error for SDK errors
+        if (e.name === 'ConnectionError') {
+            console.error(`Error: Cannot connect to AgentLens server.`);
+            console.error(`  ${e.message}`);
+            console.error(`\nMake sure the server is running and check your config with: agentlens config get`);
+        }
+        else if (e.name === 'AuthenticationError') {
+            console.error(`Error: Authentication failed.`);
+            console.error(`  Set your API key with: agentlens config set api-key <key>`);
+        }
+        else {
+            console.error(`Error: ${e.message}`);
+        }
+    }
+    else {
+        console.error(`Error: ${err}`);
+    }
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;CAiBZ,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE3B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvB,MAAM;QAER,KAAK,QAAQ;YACX,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM;QAER,KAAK,KAAK;YACR,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM;QAER,KAAK,UAAU;YACb,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM;QAER,KAAK,MAAM;YACT,MAAM,cAAc,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM;QAER,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM;QAER,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,MAAM;QAER;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QACpD,MAAM,CAAC,GAAG,GAAyD,CAAC;QACpE,qCAAqC;QACrC,IAAI,CAAC,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAC5D,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,oFAAoF,CAAC,CAAC;QACtG,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/lib/client.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Create an AgentLensClient from CLI config.
+ *
+ * @param urlOverride - Optional URL that takes precedence over the stored config.
+ */
+import { AgentLensClient } from '@agentlensai/sdk';
+export declare function createClientFromConfig(urlOverride?: string): AgentLensClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGnD,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAM5E"}

package/dist/lib/client.js

@@ -0,0 +1,15 @@
+/**
+ * Create an AgentLensClient from CLI config.
+ *
+ * @param urlOverride - Optional URL that takes precedence over the stored config.
+ */
+import { AgentLensClient } from '@agentlensai/sdk';
+import { loadConfig } from './config.js';
+export function createClientFromConfig(urlOverride) {
+    const config = loadConfig();
+    return new AgentLensClient({
+        url: urlOverride ?? config.url,
+        apiKey: config.apiKey,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,sBAAsB,CAAC,WAAoB;IACzD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,OAAO,IAAI,eAAe,CAAC;QACzB,GAAG,EAAE,WAAW,IAAI,MAAM,CAAC,GAAG;QAC9B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,17 @@
+export interface CliConfig {
+    url: string;
+    apiKey?: string;
+}
+/**
+ * Load config from ~/.agentlens/config.json (returns defaults if missing).
+ */
+export declare function loadConfig(): CliConfig;
+/**
+ * Save config to ~/.agentlens/config.json.
+ */
+export declare function saveConfig(config: CliConfig): void;
+/**
+ * Mask an API key for display: show first 8 chars + mask the rest.
+ */
+export declare function maskApiKey(key: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD;;GAEG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAOtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAGlD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C"}

package/dist/lib/config.js

@@ -0,0 +1,39 @@
+/**
+ * CLI Configuration — stored in ~/.agentlens/config.json
+ */
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const CONFIG_DIR = join(homedir(), '.agentlens');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const DEFAULT_CONFIG = {
+    url: 'http://localhost:3400',
+};
+/**
+ * Load config from ~/.agentlens/config.json (returns defaults if missing).
+ */
+export function loadConfig() {
+    try {
+        const raw = readFileSync(CONFIG_FILE, 'utf-8');
+        return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+/**
+ * Save config to ~/.agentlens/config.json.
+ */
+export function saveConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Mask an API key for display: show first 8 chars + mask the rest.
+ */
+export function maskApiKey(key) {
+    if (key.length <= 8)
+        return key;
+    return key.slice(0, 8) + '•'.repeat(Math.min(key.length - 8, 24));
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAOlC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,cAAc,GAAc;IAChC,GAAG,EAAE,uBAAuB;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC1C,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAChC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CLI Output Formatting Utilities
+ */
+/**
+ * Print data as a simple aligned table to stdout.
+ */
+export declare function printTable(headers: string[], rows: string[][]): void;
+/**
+ * Print JSON to stdout (pretty if tty, compact otherwise).
+ */
+export declare function printJson(data: unknown): void;
+/**
+ * Format a timestamp for table display.
+ */
+export declare function formatTimestamp(ts: string): string;
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ */
+export declare function formatDuration(startedAt: string, endedAt?: string): string;
+/**
+ * Truncate a string to a max length with "…" suffix.
+ */
+export declare function truncate(str: string, max: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,GACf,IAAI,CAeN;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAG7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAclD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/lib/output.js

@@ -0,0 +1,69 @@
+/**
+ * CLI Output Formatting Utilities
+ */
+/**
+ * Print data as a simple aligned table to stdout.
+ */
+export function printTable(headers, rows) {
+    const colWidths = headers.map((h, i) => {
+        const maxData = rows.reduce((max, row) => Math.max(max, (row[i] ?? '').length), 0);
+        return Math.max(h.length, maxData);
+    });
+    const sep = colWidths.map((w) => '─'.repeat(w + 2)).join('┼');
+    const formatRow = (cells) => cells.map((cell, i) => ` ${(cell ?? '').padEnd(colWidths[i])} `).join('│');
+    console.log(formatRow(headers));
+    console.log(sep);
+    for (const row of rows) {
+        console.log(formatRow(row));
+    }
+}
+/**
+ * Print JSON to stdout (pretty if tty, compact otherwise).
+ */
+export function printJson(data) {
+    const indent = process.stdout.isTTY ? 2 : 0;
+    console.log(JSON.stringify(data, null, indent));
+}
+/**
+ * Format a timestamp for table display.
+ */
+export function formatTimestamp(ts) {
+    try {
+        const d = new Date(ts);
+        return d.toLocaleString('en-US', {
+            month: 'short',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hour12: false,
+        });
+    }
+    catch {
+        return ts;
+    }
+}
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ */
+export function formatDuration(startedAt, endedAt) {
+    if (!endedAt)
+        return 'running';
+    const ms = new Date(endedAt).getTime() - new Date(startedAt).getTime();
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60_000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const mins = Math.floor(ms / 60_000);
+    const secs = Math.floor((ms % 60_000) / 1000);
+    return `${mins}m${secs}s`;
+}
+/**
+ * Truncate a string to a max length with "…" suffix.
+ */
+export function truncate(str, max) {
+    if (str.length <= max)
+        return str;
+    return str.slice(0, max - 1) + '…';
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentlensai/cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Command-line interface for AgentLens — query events, sessions, and manage your observability server",
   "type": "module",
   "license": "MIT",
@@ -37,7 +37,7 @@
     "dist"
   ],
   "dependencies": {
-    "@agentlensai/sdk": "0.2.0"
+    "@agentlensai/sdk": "0.3.0"
   },
   "scripts": {
     "build": "tsc -b",