@sentropic/agent-stats-core 0.1.0

package/dist/anomalies.js

@@ -0,0 +1,188 @@
+/**
+ * Anomaly detection heuristics (no LLM).
+ *
+ * Operates on a stream of `SessionEvent`s and emits `Anomaly` records
+ * flagging sessions that exhibit known costly or stuck patterns:
+ *   - runaway_compactions : auto-compaction triggered N+ times in one session.
+ *   - high_error_rate     : tool error rate > threshold (min 10 calls).
+ *   - prompt_retry_loop   : same user prompt textHash repeated N+ times.
+ *   - tool_loop           : same tool name called N+ times consecutively.
+ *   - zombie_session      : > N minutes between consecutive turns.
+ *
+ * Frustration via user-prompt content is intentionally out of scope for
+ * WP5; the parser stores only prompt hashes (privacy). That heuristic
+ * is deferred to WP7 (LLM phase 2).
+ */
+function emptyAcc(ev) {
+    return {
+        sessionId: ev.sessionId,
+        tool: ev.tool,
+        projectCwd: ev.projectCwd,
+        compactions: 0,
+        toolCallTotal: 0,
+        toolCallErrors: 0,
+        promptHashCounts: new Map(),
+        lastToolName: '',
+        lastToolStreak: 0,
+        maxToolStreak: { name: '', count: 0 },
+        turnTs: [],
+    };
+}
+function severityFromRatio(ratio) {
+    if (ratio >= 3)
+        return 'high';
+    if (ratio >= 2)
+        return 'medium';
+    return 'low';
+}
+export async function detectAnomalies(events, opts = {}) {
+    const runawayCompactions = opts.runawayCompactions ?? 10;
+    const errorRateThreshold = opts.errorRateThreshold ?? 0.3;
+    const minToolCallsForErrorRate = opts.minToolCallsForErrorRate ?? 10;
+    const promptRetryCount = opts.promptRetryCount ?? 4;
+    const toolLoopCount = opts.toolLoopCount ?? 5;
+    const zombieGapMinutes = opts.zombieGapMinutes ?? 120;
+    const sessions = new Map();
+    for await (const ev of events) {
+        if (!ev.sessionId)
+            continue;
+        let s = sessions.get(ev.sessionId);
+        if (!s) {
+            s = emptyAcc(ev);
+            sessions.set(ev.sessionId, s);
+        }
+        // Update fields shared by all session events
+        if (ev.projectCwd)
+            s.projectCwd = ev.projectCwd;
+        s.tool = ev.tool;
+        switch (ev.kind) {
+            case 'compaction':
+                s.compactions += 1;
+                break;
+            case 'tool_call': {
+                s.toolCallTotal += 1;
+                if (ev.error)
+                    s.toolCallErrors += 1;
+                if (ev.name === s.lastToolName) {
+                    s.lastToolStreak += 1;
+                }
+                else {
+                    s.lastToolName = ev.name;
+                    s.lastToolStreak = 1;
+                }
+                if (s.lastToolStreak > s.maxToolStreak.count) {
+                    s.maxToolStreak = { name: ev.name, count: s.lastToolStreak };
+                }
+                break;
+            }
+            case 'user_prompt': {
+                s.promptHashCounts.set(ev.textHash, (s.promptHashCounts.get(ev.textHash) ?? 0) + 1);
+                // user prompts also break tool streaks
+                s.lastToolName = '';
+                s.lastToolStreak = 0;
+                break;
+            }
+            case 'turn': {
+                if (ev.ts)
+                    s.turnTs.push(ev.ts);
+                // turns also break tool streaks (different assistant action)
+                s.lastToolName = '';
+                s.lastToolStreak = 0;
+                break;
+            }
+            case 'session_start':
+            case 'session_end':
+            case 'skill_invoke':
+                break;
+        }
+    }
+    const anomalies = [];
+    for (const s of sessions.values()) {
+        if (s.compactions >= runawayCompactions) {
+            anomalies.push({
+                sessionId: s.sessionId,
+                tool: s.tool,
+                projectCwd: s.projectCwd,
+                type: 'runaway_compactions',
+                severity: severityFromRatio(s.compactions / runawayCompactions),
+                evidence: { compactions: s.compactions, threshold: runawayCompactions },
+            });
+        }
+        if (s.toolCallTotal >= minToolCallsForErrorRate) {
+            const rate = s.toolCallErrors / s.toolCallTotal;
+            if (rate >= errorRateThreshold) {
+                anomalies.push({
+                    sessionId: s.sessionId,
+                    tool: s.tool,
+                    projectCwd: s.projectCwd,
+                    type: 'high_error_rate',
+                    severity: severityFromRatio(rate / errorRateThreshold),
+                    evidence: {
+                        errors: s.toolCallErrors,
+                        total: s.toolCallTotal,
+                        rate: Number(rate.toFixed(3)),
+                        threshold: errorRateThreshold,
+                    },
+                });
+            }
+        }
+        let topHash = '';
+        let topHashCount = 0;
+        for (const [h, n] of s.promptHashCounts) {
+            if (n > topHashCount) {
+                topHashCount = n;
+                topHash = h;
+            }
+        }
+        if (topHashCount >= promptRetryCount) {
+            anomalies.push({
+                sessionId: s.sessionId,
+                tool: s.tool,
+                projectCwd: s.projectCwd,
+                type: 'prompt_retry_loop',
+                severity: severityFromRatio(topHashCount / promptRetryCount),
+                evidence: { textHash: topHash, count: topHashCount, threshold: promptRetryCount },
+            });
+        }
+        if (s.maxToolStreak.count >= toolLoopCount) {
+            anomalies.push({
+                sessionId: s.sessionId,
+                tool: s.tool,
+                projectCwd: s.projectCwd,
+                type: 'tool_loop',
+                severity: severityFromRatio(s.maxToolStreak.count / toolLoopCount),
+                evidence: {
+                    tool: s.maxToolStreak.name,
+                    consecutive: s.maxToolStreak.count,
+                    threshold: toolLoopCount,
+                },
+            });
+        }
+        // zombie gap
+        let maxGapMin = 0;
+        for (let i = 1; i < s.turnTs.length; i++) {
+            const a = Date.parse(s.turnTs[i - 1]);
+            const b = Date.parse(s.turnTs[i]);
+            if (!Number.isNaN(a) && !Number.isNaN(b)) {
+                const gap = (b - a) / 60_000;
+                if (gap > maxGapMin)
+                    maxGapMin = gap;
+            }
+        }
+        if (maxGapMin >= zombieGapMinutes) {
+            anomalies.push({
+                sessionId: s.sessionId,
+                tool: s.tool,
+                projectCwd: s.projectCwd,
+                type: 'zombie_session',
+                severity: severityFromRatio(maxGapMin / zombieGapMinutes),
+                evidence: {
+                    maxGapMinutes: Math.round(maxGapMin),
+                    threshold: zombieGapMinutes,
+                },
+            });
+        }
+    }
+    return anomalies;
+}
+//# sourceMappingURL=anomalies.js.map

package/dist/anomalies.js.map

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

package/dist/cleanser.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Cleanser: redact secrets (and optionally compact verbose tool outputs)
+ * from agent-stats session jsonl files.
+ *
+ * Modes:
+ *   - `archive`     : write a redacted copy into an output dir.
+ *   - `inplace`     : rewrite the file in place after saving a `.bak`.
+ *   - `llm-input`   : same as `archive` plus truncate tool-result strings
+ *                     longer than `maxToolResultBytes`.
+ *
+ * Replacement marker is `<<SECRET:<ruleId>:<hash>>>` where `<hash>` is the
+ * first 16 hex chars of sha256(secret); identical secrets keep the same
+ * tag across files, which is handy for dedup analysis.
+ */
+export type CleanMode = 'archive' | 'inplace' | 'llm-input';
+export interface CleanFileOptions {
+    /** Absolute path of the source jsonl. */
+    filePath: string;
+    /** Output mode. */
+    mode?: CleanMode;
+    /**
+     * Output file path; required for `archive` and `llm-input` modes.
+     * Ignored for `inplace`.
+     */
+    outputPath?: string;
+    /**
+     * For `llm-input`: truncate any string longer than this many bytes.
+     * Default 2048.
+     */
+    maxToolResultBytes?: number;
+    /**
+     * For tests: skip the secret scan and only handle truncation.
+     * Default false.
+     */
+    skipSecrets?: boolean;
+}
+export interface CleanStats {
+    filePath: string;
+    outputPath: string;
+    /** Number of secret matches found and redacted. */
+    secretsFound: number;
+    /** Number of strings truncated (llm-input mode). */
+    truncations: number;
+    /** Number of lines processed. */
+    lines: number;
+    /** Source byte size. */
+    bytesIn: number;
+    /** Output byte size. */
+    bytesOut: number;
+}
+/**
+ * Clean a single jsonl file. Writes the redacted version according to the
+ * requested mode and returns aggregate stats.
+ */
+export declare function cleanFile(opts: CleanFileOptions): Promise<CleanStats>;
+//# sourceMappingURL=cleanser.d.ts.map

package/dist/cleanser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanser.d.ts","sourceRoot":"","sources":["../src/cleanser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4DD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4D3E"}

package/dist/cleanser.js

@@ -0,0 +1,132 @@
+/**
+ * Cleanser: redact secrets (and optionally compact verbose tool outputs)
+ * from agent-stats session jsonl files.
+ *
+ * Modes:
+ *   - `archive`     : write a redacted copy into an output dir.
+ *   - `inplace`     : rewrite the file in place after saving a `.bak`.
+ *   - `llm-input`   : same as `archive` plus truncate tool-result strings
+ *                     longer than `maxToolResultBytes`.
+ *
+ * Replacement marker is `<<SECRET:<ruleId>:<hash>>>` where `<hash>` is the
+ * first 16 hex chars of sha256(secret); identical secrets keep the same
+ * tag across files, which is handy for dedup analysis.
+ */
+import { createHash } from 'node:crypto';
+import { copyFile, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { scanString } from './secrets.js';
+const sha256short = (text) => createHash('sha256').update(text).digest('hex').slice(0, 16);
+function redact(text, matches) {
+    if (matches.length === 0)
+        return text;
+    const sorted = [...matches].sort((a, b) => b.start - a.start);
+    let out = text;
+    for (const m of sorted) {
+        const secret = out.slice(m.start, m.end);
+        const safeRule = m.ruleId.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const tag = `<<SECRET:${safeRule}:${sha256short(secret)}>>`;
+        out = out.slice(0, m.start) + tag + out.slice(m.end);
+    }
+    return out;
+}
+async function cleanString(s, ctx) {
+    let out = s;
+    if (ctx.scanSecrets && s.length >= 8) {
+        const matches = await scanString(s);
+        if (matches.length > 0) {
+            ctx.secretsFound += matches.length;
+            out = redact(s, matches);
+        }
+    }
+    if (ctx.truncate && Buffer.byteLength(out, 'utf8') > ctx.maxToolResultBytes) {
+        ctx.truncations += 1;
+        const kept = Buffer.from(out, 'utf8').subarray(0, ctx.maxToolResultBytes).toString('utf8');
+        const dropped = Buffer.byteLength(out, 'utf8') - Buffer.byteLength(kept, 'utf8');
+        out = `${kept}…[${dropped} bytes truncated by agent-stats clean]`;
+    }
+    return out;
+}
+async function cleanJson(val, ctx) {
+    if (typeof val === 'string')
+        return cleanString(val, ctx);
+    if (Array.isArray(val)) {
+        const out = [];
+        for (const item of val)
+            out.push(await cleanJson(item, ctx));
+        return out;
+    }
+    if (val !== null && typeof val === 'object') {
+        const obj = val;
+        const out = {};
+        for (const [k, v] of Object.entries(obj))
+            out[k] = await cleanJson(v, ctx);
+        return out;
+    }
+    return val;
+}
+/**
+ * Clean a single jsonl file. Writes the redacted version according to the
+ * requested mode and returns aggregate stats.
+ */
+export async function cleanFile(opts) {
+    const mode = opts.mode ?? 'archive';
+    const src = await readFile(opts.filePath, 'utf8');
+    const ctx = {
+        secretsFound: 0,
+        truncations: 0,
+        maxToolResultBytes: opts.maxToolResultBytes ?? 2048,
+        truncate: mode === 'llm-input',
+        scanSecrets: !opts.skipSecrets,
+    };
+    const lines = src.split('\n');
+    const outLines = [];
+    let processed = 0;
+    for (const line of lines) {
+        if (!line.trim()) {
+            outLines.push(line);
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            // Not JSON: scan as raw text (defensive — still redact).
+            outLines.push(await cleanString(line, ctx));
+            processed += 1;
+            continue;
+        }
+        const redacted = await cleanJson(parsed, ctx);
+        outLines.push(JSON.stringify(redacted));
+        processed += 1;
+    }
+    const cleaned = outLines.join('\n');
+    let outputPath;
+    if (mode === 'inplace') {
+        outputPath = opts.filePath;
+        const bak = `${opts.filePath}.bak`;
+        await copyFile(opts.filePath, bak);
+        const tmp = `${opts.filePath}.tmp-${process.pid}`;
+        await writeFile(tmp, cleaned);
+        await rename(tmp, opts.filePath);
+    }
+    else {
+        if (!opts.outputPath) {
+            throw new Error(`cleanFile: --output is required for mode "${mode}"`);
+        }
+        outputPath = opts.outputPath;
+        await mkdir(path.dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, cleaned);
+    }
+    return {
+        filePath: opts.filePath,
+        outputPath,
+        secretsFound: ctx.secretsFound,
+        truncations: ctx.truncations,
+        lines: processed,
+        bytesIn: Buffer.byteLength(src, 'utf8'),
+        bytesOut: Buffer.byteLength(cleaned, 'utf8'),
+    };
+}
+//# sourceMappingURL=cleanser.js.map

package/dist/cleanser.js.map

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

package/dist/collect.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `collect()` is the public entry point that merges the Claude Code and
+ * Codex CLI parsers into a single async iterator of normalized events,
+ * filtered by tool / project / time window.
+ *
+ * Discovery rules:
+ *  - Claude sessions: scan `~/.claude/projects/<cwd-encoded>/<sessionId>.jsonl`.
+ *    The directory name encodes the cwd by replacing `/` with `-` and
+ *    prepending a leading dash (e.g. `/home/u/src/demo` ↔
+ *    `-home-u-src-demo`). The project filter is applied on the decoded cwd.
+ *  - Codex sessions: query `~/.codex/state_5.sqlite` via `indexCodexSessions`,
+ *    then stream each matching rollout.
+ *
+ * Time filtering is applied at the file level when possible (mtime / DB
+ * created_at), then enforced per-event using the event `ts`.
+ */
+import type { SessionEvent } from './schema.js';
+export interface CollectOptions {
+    sources?: {
+        claude?: boolean;
+        codex?: boolean;
+    };
+    since?: Date;
+    until?: Date;
+    /**
+     * Exact cwd OR cwd prefix when ending with `/`. Applied to BOTH Claude
+     * and Codex sources.
+     */
+    projectCwd?: string;
+    /** Override path for ~/.claude/projects/ */
+    claudeProjectsDir?: string;
+    /** Override path for the Codex sqlite index. */
+    codexDbPath?: string;
+}
+/** Decode a Claude project dir name back to its absolute cwd. */
+export declare function decodeClaudeProjectDir(name: string): string;
+/**
+ * Yield events from one or both sources, optionally filtered by project /
+ * time window. The order across sources is NOT guaranteed; callers that
+ * need a global timeline should sort by `ts` after collecting.
+ */
+export declare function collect(opts?: CollectOptions): AsyncGenerator<SessionEvent, void, unknown>;
+//# sourceMappingURL=collect.d.ts.map

package/dist/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../src/collect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,IAAI,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3D;AAoFD;;;;GAIG;AACH,wBAAuB,OAAO,CAC5B,IAAI,GAAE,cAAmB,GACxB,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAQ7C"}

package/dist/collect.js

@@ -0,0 +1,140 @@
+/**
+ * `collect()` is the public entry point that merges the Claude Code and
+ * Codex CLI parsers into a single async iterator of normalized events,
+ * filtered by tool / project / time window.
+ *
+ * Discovery rules:
+ *  - Claude sessions: scan `~/.claude/projects/<cwd-encoded>/<sessionId>.jsonl`.
+ *    The directory name encodes the cwd by replacing `/` with `-` and
+ *    prepending a leading dash (e.g. `/home/u/src/demo` ↔
+ *    `-home-u-src-demo`). The project filter is applied on the decoded cwd.
+ *  - Codex sessions: query `~/.codex/state_5.sqlite` via `indexCodexSessions`,
+ *    then stream each matching rollout.
+ *
+ * Time filtering is applied at the file level when possible (mtime / DB
+ * created_at), then enforced per-event using the event `ts`.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { parseClaudeSession } from './parsers/claude.js';
+import { indexCodexSessions, parseCodexRollout } from './parsers/codex.js';
+const DEFAULT_HOME = () => process.env['HOME'] ?? '';
+/** Decode a Claude project dir name back to its absolute cwd. */
+export function decodeClaudeProjectDir(name) {
+    // `-home-u-src-demo` → `/home/u/src/demo`
+    return name.startsWith('-') ? name.replace(/-/g, '/') : name;
+}
+function matchesProjectCwd(cwd, filter) {
+    if (!filter)
+        return true;
+    if (filter.endsWith('/'))
+        return cwd.startsWith(filter);
+    return cwd === filter;
+}
+function eventInWindow(ev, since, until) {
+    const t = Date.parse(ev.ts);
+    if (Number.isNaN(t))
+        return true; // keep events without ts
+    if (since && t < since.getTime())
+        return false;
+    if (until && t > until.getTime())
+        return false;
+    return true;
+}
+async function* collectClaude(opts) {
+    const projectsDir = opts.claudeProjectsDir ?? path.join(DEFAULT_HOME(), '.claude', 'projects');
+    let entries;
+    try {
+        entries = await fs.readdir(projectsDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const decoded = decodeClaudeProjectDir(entry.name);
+        if (!matchesProjectCwd(decoded, opts.projectCwd))
+            continue;
+        const dir = path.join(projectsDir, entry.name);
+        let files;
+        try {
+            files = await fs.readdir(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const f of files) {
+            if (!f.endsWith('.jsonl'))
+                continue;
+            const filePath = path.join(dir, f);
+            let stat;
+            try {
+                stat = await fs.stat(filePath);
+            }
+            catch {
+                continue;
+            }
+            if (opts.since && stat.mtime < opts.since)
+                continue;
+            // upper bound on mtime is permissive (a file might still be open).
+            for await (const ev of parseClaudeSession({ filePath })) {
+                if (!eventInWindow(ev, opts.since, opts.until))
+                    continue;
+                yield ev;
+            }
+        }
+    }
+}
+async function* collectCodex(opts) {
+    const indexOpts = {};
+    if (opts.codexDbPath !== undefined)
+        indexOpts.dbPath = opts.codexDbPath;
+    if (opts.since !== undefined)
+        indexOpts.since = opts.since;
+    if (opts.until !== undefined)
+        indexOpts.until = opts.until;
+    if (opts.projectCwd !== undefined)
+        indexOpts.projectCwd = opts.projectCwd;
+    let entries;
+    try {
+        entries = indexCodexSessions(indexOpts);
+    }
+    catch {
+        return;
+    }
+    for (const e of entries) {
+        if (!matchesProjectCwd(e.cwd, opts.projectCwd))
+            continue;
+        try {
+            await fs.access(e.rolloutPath);
+        }
+        catch {
+            continue;
+        }
+        for await (const ev of parseCodexRollout({
+            filePath: e.rolloutPath,
+            sessionId: e.id,
+            projectCwd: e.cwd,
+        })) {
+            if (!eventInWindow(ev, opts.since, opts.until))
+                continue;
+            yield ev;
+        }
+    }
+}
+/**
+ * Yield events from one or both sources, optionally filtered by project /
+ * time window. The order across sources is NOT guaranteed; callers that
+ * need a global timeline should sort by `ts` after collecting.
+ */
+export async function* collect(opts = {}) {
+    const sources = { claude: true, codex: true, ...(opts.sources ?? {}) };
+    if (sources.claude) {
+        yield* collectClaude(opts);
+    }
+    if (sources.codex) {
+        yield* collectCodex(opts);
+    }
+}
+//# sourceMappingURL=collect.js.map

package/dist/collect.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @sentropic/agent-stats-core
+ *
+ * Public surface: schema types and parsers.
+ */
+export declare const VERSION = "0.1.0";
+export * from './schema.js';
+export { parseClaudeSession } from './parsers/claude.js';
+export { indexCodexSessions, parseCodexRollout, type CodexIndexEntry, type IndexCodexOptions, type ParseCodexRolloutOptions, } from './parsers/codex.js';
+export { collect, decodeClaudeProjectDir, type CollectOptions } from './collect.js';
+export { aggregateSessions, aggregateWeekly, bucketWeekly, cacheEfficiency, weekStartIso, type AggregateOptions, type SessionAggregate, type WeeklyAggregation, } from './aggregations.js';
+export { DEFAULT_RATE_CARD, ZERO_RATES, estimateCost, resolveRates, type CostCurrency, type ModelRates, } from './rate-card.js';
+export { JsonStorage, type JsonStorageOptions, type StorageAdapter, type StorageFilter, } from './storage.js';
+export { scanString, type SecretMatch } from './secrets.js';
+export { cleanFile, type CleanFileOptions, type CleanMode, type CleanStats } from './cleanser.js';
+export { detectAnomalies, type Anomaly, type AnomalySeverity, type AnomalyType, type DetectAnomaliesOptions, } from './anomalies.js';
+export { analyzeWithLlm, benchModels, type AnalysisVerdict, type AnalyzeCache, type AnalyzeOptions, type BenchModelConfig, type BenchModelResult, type BenchOptions, type BenchSampleBaseline, type LlmMeshLike, } from './analyze.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,EACL,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,sBAAsB,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @sentropic/agent-stats-core
+ *
+ * Public surface: schema types and parsers.
+ */
+export const VERSION = '0.1.0';
+export * from './schema.js';
+export { parseClaudeSession } from './parsers/claude.js';
+export { indexCodexSessions, parseCodexRollout, } from './parsers/codex.js';
+export { collect, decodeClaudeProjectDir } from './collect.js';
+export { aggregateSessions, aggregateWeekly, bucketWeekly, cacheEfficiency, weekStartIso, } from './aggregations.js';
+export { DEFAULT_RATE_CARD, ZERO_RATES, estimateCost, resolveRates, } from './rate-card.js';
+export { JsonStorage, } from './storage.js';
+export { scanString } from './secrets.js';
+export { cleanFile } from './cleanser.js';
+export { detectAnomalies, } from './anomalies.js';
+export { analyzeWithLlm, benchModels, } from './analyze.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAIlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAuB,MAAM,cAAc,CAAC;AACpF,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,GAIb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,YAAY,GAGb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,WAAW,GAIZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAA0D,MAAM,eAAe,CAAC;AAClG,OAAO,EACL,eAAe,GAKhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,WAAW,GASZ,MAAM,cAAc,CAAC"}