@sentropic/agent-stats-core 0.1.0 → 0.2.0

package/dist/secrets.js

@@ -1,12 +1,19 @@
 /**
- * Thin wrapper over secretlint to scan ad-hoc strings.
+ * Secret scanning. Combines two sources:
+ *   1. secretlint preset-recommend (28 rules: AWS, Anthropic, OpenAI, GitHub,
+ *      GitLab, Slack, Stripe, JWT, private keys, …) — the generic baseline.
+ *   2. Optional **custom patterns** (regexes), e.g. an organisation's internal
+ *      token formats that the generic rules don't know about. These are loaded
+ *      from a small YAML file (see `loadSecretPatterns`).
  *
- * Uses the preset-recommend bundle as the default rule set. The function
- * returns the list of match ranges so callers can either redact in place
- * (cleanser) or report them (anomalies / audit).
+ * Returns match ranges so callers can redact in place (cleanser) or report
+ * them (audit). The two sources are merged and overlapping ranges are kept
+ * once so a string is never double-redacted.
  */
+import { readFileSync } from 'node:fs';
 import { lintSource } from '@secretlint/core';
 import { creator as presetRecommend } from '@secretlint/secretlint-rule-preset-recommend';
+import yaml from 'js-yaml';
 const DEFAULT_CONFIG = {
     rules: [
         {
@@ -16,16 +23,93 @@ const DEFAULT_CONFIG = {
     ],
 };
 /**
- * Scan a single string for secrets. Returns an empty array if nothing
- * looks suspicious. Safe to call on small or empty strings — secretlint
- * short-circuits.
+ * Load custom secret patterns from a YAML file. Accepts either a top-level
+ * list, or a `patterns:` key holding the list:
+ *
+ *   - id: sentropic-token
+ *     pattern: "stp_[A-Za-z0-9]{32}"
+ *     flags: ""
+ *
+ * Invalid entries are skipped defensively (bad regex, missing fields).
+ */
+export function loadSecretPatterns(filePath) {
+    let raw;
+    try {
+        raw = yaml.load(readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    const list = Array.isArray(raw)
+        ? raw
+        : raw && typeof raw === 'object' && Array.isArray(raw.patterns)
+            ? raw.patterns
+            : [];
+    const out = [];
+    for (const item of list) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const { id, pattern, flags } = item;
+        if (typeof id !== 'string' || typeof pattern !== 'string')
+            continue;
+        try {
+            new RegExp(pattern, typeof flags === 'string' ? flags : ''); // validate
+        }
+        catch {
+            continue;
+        }
+        out.push({ id, pattern, ...(typeof flags === 'string' ? { flags } : {}) });
+    }
+    return out;
+}
+function scanCustom(text, patterns) {
+    const matches = [];
+    for (const p of patterns) {
+        let re;
+        try {
+            const flags = new Set((p.flags ?? '').split(''));
+            flags.add('g'); // global is required to walk all occurrences
+            re = new RegExp(p.pattern, [...flags].join(''));
+        }
+        catch {
+            continue;
+        }
+        for (const m of text.matchAll(re)) {
+            if (m.index === undefined || m[0].length === 0)
+                continue;
+            matches.push({
+                start: m.index,
+                end: m.index + m[0].length,
+                ruleId: `custom:${p.id}`,
+                message: `custom pattern ${p.id}`,
+            });
+        }
+    }
+    return matches;
+}
+/** Drop ranges fully covered by an earlier-starting / longer range. */
+function dedupeRanges(matches) {
+    const sorted = [...matches].sort((a, b) => a.start - b.start || b.end - a.end);
+    const kept = [];
+    let lastEnd = -1;
+    for (const m of sorted) {
+        if (m.start >= lastEnd || m.end > lastEnd) {
+            kept.push(m);
+            lastEnd = Math.max(lastEnd, m.end);
+        }
+    }
+    return kept;
+}
+/**
+ * Scan a single string for secrets (preset rules + optional custom patterns).
+ * Returns an empty array if nothing looks suspicious. Safe on empty strings.
  */
-export async function scanString(text, filePath = 'inline.txt') {
+export async function scanString(text, opts = {}) {
     if (!text)
         return [];
     const result = await lintSource({
         source: {
-            filePath,
+            filePath: opts.filePath ?? 'inline.txt',
             content: text,
             contentType: 'text',
         },
@@ -35,11 +119,13 @@ export async function scanString(text, filePath = 'inline.txt') {
             noPhysicFilePath: true,
         },
     });
-    return (result.messages ?? []).map((m) => ({
+    const preset = (result.messages ?? []).map((m) => ({
         start: m.range[0],
         end: m.range[1],
         ruleId: m.ruleId,
         message: m.message,
     }));
+    const custom = opts.customPatterns?.length ? scanCustom(text, opts.customPatterns) : [];
+    return dedupeRanges([...preset, ...custom]);
 }
 //# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -1 +1 @@
-{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAc1F,MAAM,cAAc,GAAyB;IAC3C,KAAK,EAAE;QACL;YACE,EAAE,EAAE,8CAA8C;YAClD,IAAI,EAAE,eAAe;SACtB;KACF;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,QAAQ,GAAG,YAAY;IACpE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,MAAM,EAAE;YACN,QAAQ;YACR,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,MAAM;SACpB;QACD,OAAO,EAAE;YACP,MAAM,EAAE,cAAc;YACtB,WAAW,EAAE,KAAK;YAClB,gBAAgB,EAAE,IAAI;SACvB;KACF,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACjB,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACf,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"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"}

package/dist/series.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pure helpers to turn weekly aggregation rows into single-series chart data
+ * (e.g. for the design-system LineChart / Sparkline which take {x,y}[] /
+ * number[]). Lives in core (no UI dependency) so it is unit-tested without the
+ * SvelteKit toolchain.
+ */
+export type SeriesMetric = 'tokens' | 'credits' | 'quota7d' | 'sessions' | 'inputNew' | 'output' | 'inout' | 'cached';
+export type ToolFilter = 'all' | 'claude' | 'codex' | 'cursor';
+/** The subset of a WeeklyAggregation row the charts need (structural). */
+export interface SeriesRow {
+    weekStart: string;
+    tool: 'claude' | 'codex' | 'cursor';
+    sessions: number;
+    totalUsage: {
+        newInputTokens: number;
+        cachedInputTokens: number;
+        cacheWriteTokens: number;
+        outputTokens: number;
+        reasoningTokens?: number;
+    };
+    estimatedCost: {
+        codexCredits: number;
+    };
+    rateLimitMax?: {
+        secondaryPercent: number;
+    };
+}
+export interface SeriesPoint {
+    x: string;
+    y: number;
+}
+/**
+ * Bucket rows by their bucket start (`weekStart`, which holds the day for daily
+ * rows) for one metric and tool filter. Most metrics sum within a bucket;
+ * `quota7d` is a rate-limit peak so it takes the max. Sorted ascending.
+ */
+export declare function periodSeries(rows: SeriesRow[], metric: SeriesMetric, tool: ToolFilter): SeriesPoint[];
+/** @deprecated use {@link periodSeries} (granularity-agnostic). */
+export declare const weeklySeries: typeof periodSeries;
+//# sourceMappingURL=series.d.ts.map

package/dist/series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"series.d.ts","sourceRoot":"","sources":["../src/series.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAEpB,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GAEV,UAAU,GACV,QAAQ,GACR,OAAO,GACP,QAAQ,CAAC;AACb,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/D,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,aAAa,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,YAAY,CAAC,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AA0BD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EAAE,EACjB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GACf,WAAW,EAAE,CAWf;AAED,mEAAmE;AACnE,eAAO,MAAM,YAAY,qBAAe,CAAC"}

package/dist/series.js

@@ -0,0 +1,51 @@
+/**
+ * Pure helpers to turn weekly aggregation rows into single-series chart data
+ * (e.g. for the design-system LineChart / Sparkline which take {x,y}[] /
+ * number[]). Lives in core (no UI dependency) so it is unit-tested without the
+ * SvelteKit toolchain.
+ */
+function metricValue(r, metric) {
+    const u = r.totalUsage;
+    const inputNew = u.newInputTokens + u.cacheWriteTokens;
+    const output = u.outputTokens + (u.reasoningTokens ?? 0);
+    switch (metric) {
+        case 'tokens': // legacy headline metric: all input + output (cache included)
+            return u.newInputTokens + u.cachedInputTokens + u.cacheWriteTokens + u.outputTokens;
+        case 'credits':
+            return r.estimatedCost.codexCredits;
+        case 'sessions':
+            return r.sessions;
+        case 'quota7d':
+            return r.rateLimitMax?.secondaryPercent ?? 0;
+        case 'inputNew':
+            return inputNew;
+        case 'output':
+            return output;
+        case 'inout': // cached read excluded
+            return inputNew + output;
+        case 'cached':
+            return u.cachedInputTokens;
+    }
+}
+/**
+ * Bucket rows by their bucket start (`weekStart`, which holds the day for daily
+ * rows) for one metric and tool filter. Most metrics sum within a bucket;
+ * `quota7d` is a rate-limit peak so it takes the max. Sorted ascending.
+ */
+export function periodSeries(rows, metric, tool) {
+    const filtered = tool === 'all' ? rows : rows.filter((r) => r.tool === tool);
+    const isMax = metric === 'quota7d';
+    const byWeek = new Map();
+    for (const r of filtered) {
+        const v = metricValue(r, metric);
+        const prev = byWeek.get(r.weekStart);
+        if (prev === undefined)
+            byWeek.set(r.weekStart, v);
+        else
+            byWeek.set(r.weekStart, isMax ? Math.max(prev, v) : prev + v);
+    }
+    return [...byWeek.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([x, y]) => ({ x, y }));
+}
+/** @deprecated use {@link periodSeries} (granularity-agnostic). */
+export const weeklySeries = periodSeries;
+//# sourceMappingURL=series.js.map

package/dist/series.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"series.js","sourceRoot":"","sources":["../src/series.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,SAAS,WAAW,CAAC,CAAY,EAAE,MAAoB;IACrD,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;IACvB,MAAM,QAAQ,GAAG,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,gBAAgB,CAAC;IACvD,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;IACzD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ,EAAE,8DAA8D;YAC3E,OAAO,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,YAAY,CAAC;QACtF,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,aAAa,CAAC,YAAY,CAAC;QACtC,KAAK,UAAU;YACb,OAAO,CAAC,CAAC,QAAQ,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,YAAY,EAAE,gBAAgB,IAAI,CAAC,CAAC;QAC/C,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO,EAAE,uBAAuB;YACnC,OAAO,QAAQ,GAAG,MAAM,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,iBAAiB,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAiB,EACjB,MAAoB,EACpB,IAAgB;IAEhB,MAAM,QAAQ,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;;YAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC"}

package/dist/tool-stats.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Helpers to surface tool / skill usage as top-N tables.
+ *
+ * MCP tools are reported as a single `mcp:{server}` bucket rather than one row
+ * per leaf tool (e.g. `mcp__playwright__browser_click`), so a chatty server
+ * does not flood the table. Native tools (Bash, Read, …) keep their name.
+ */
+/** Collapse an MCP tool id (`mcp__server__tool…`) to a `mcp:{server}` bucket. */
+export declare function mcpBucket(name: string): string;
+/** Sum a list of name→count maps, optionally normalizing each key. */
+export declare function mergeNameCounts(maps: Array<Record<string, number>>, normalize?: (name: string) => string): Record<string, number>;
+export interface NameCount {
+    name: string;
+    count: number;
+}
+/**
+ * Top-N entries from a name→count map. Deterministic ordering: count
+ * descending, then name ascending to break ties.
+ */
+export declare function topN(counts: Record<string, number>, n: number): NameCount[];
+//# sourceMappingURL=tool-stats.d.ts.map

package/dist/tool-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-stats.d.ts","sourceRoot":"","sources":["../src/tool-stats.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACnC,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAiB,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAK3E"}

package/dist/tool-stats.js

@@ -0,0 +1,38 @@
+/**
+ * Helpers to surface tool / skill usage as top-N tables.
+ *
+ * MCP tools are reported as a single `mcp:{server}` bucket rather than one row
+ * per leaf tool (e.g. `mcp__playwright__browser_click`), so a chatty server
+ * does not flood the table. Native tools (Bash, Read, …) keep their name.
+ */
+/** Collapse an MCP tool id (`mcp__server__tool…`) to a `mcp:{server}` bucket. */
+export function mcpBucket(name) {
+    if (!name.startsWith('mcp__'))
+        return name;
+    // The server is always the first `__`-delimited segment after the `mcp__`
+    // prefix, even when the tool part contains extra underscores.
+    const server = name.slice(5).split('__')[0];
+    return server ? `mcp:${server}` : 'mcp:unknown';
+}
+/** Sum a list of name→count maps, optionally normalizing each key. */
+export function mergeNameCounts(maps, normalize = (n) => n) {
+    const out = {};
+    for (const m of maps) {
+        for (const [k, v] of Object.entries(m)) {
+            const key = normalize(k);
+            out[key] = (out[key] ?? 0) + v;
+        }
+    }
+    return out;
+}
+/**
+ * Top-N entries from a name→count map. Deterministic ordering: count
+ * descending, then name ascending to break ties.
+ */
+export function topN(counts, n) {
+    return Object.entries(counts)
+        .map(([name, count]) => ({ name, count }))
+        .sort((a, b) => b.count - a.count || a.name.localeCompare(b.name))
+        .slice(0, n);
+}
+//# sourceMappingURL=tool-stats.js.map

package/dist/tool-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-stats.js","sourceRoot":"","sources":["../src/tool-stats.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,0EAA0E;IAC1E,8DAA8D;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;AAClD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAC7B,IAAmC,EACnC,YAAsC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE9C,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,MAA8B,EAAE,CAAS;IAC5D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACjE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentropic/agent-stats-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Parsers, aggregations and schema for agent-stats (Claude Code + Codex CLI session analyzer).",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,9 +45,11 @@
     "@secretlint/types": "^13.0.2",
     "@types/better-sqlite3": "^7.6.13",
     "better-sqlite3": "^12.10.0",
+    "js-yaml": "^4.1.0",
     "secretlint": "^13.0.2"
   },
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
     "@vitest/coverage-v8": "^4.1.7"
   }
 }