narai-primitives 2.0.0-rc.1

package/dist/toolkit/security_check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security_check.js","sourceRoot":"","sources":["../../src/toolkit/security_check.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,GAEd,MAAM,mBAAmB,CAAC;AAE3B,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,kBAAkB,CAAC,CAAS;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,OAAO,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,IAAI,WAAW,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAClB,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,CAAS,EAAE,QAAgB;IAC9D,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAClD,OAAO,CACL,YAAY,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC;YAChD,YAAY,KAAK,YAAY,CAC9B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,gGAAgG;AAChG,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,YAAoB,GAAG;IAClE,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/toolkit/usage/aggregate-cross-session.d.ts

@@ -0,0 +1,36 @@
+export interface CrossSessionOptions {
+    dir: string;
+    since: string;
+    connector?: string;
+    now?: Date;
+}
+export interface CrossSessionByConnector {
+    sessions: number;
+    calls: number;
+    response_bytes: number;
+    estimated_tokens: number;
+}
+export interface CrossSessionByDay {
+    day: string;
+    calls: number;
+    response_bytes: number;
+    estimated_tokens: number;
+}
+export interface CrossSessionReport {
+    scope: {
+        connector: string;
+        since: string;
+        sessions_scanned: number;
+    };
+    totals: {
+        calls: number;
+        response_bytes: number;
+        estimated_tokens: number;
+        error_rate: number;
+    };
+    by_connector: Record<string, CrossSessionByConnector>;
+    by_day: CrossSessionByDay[];
+}
+export declare function aggregateCrossSession(opts: CrossSessionOptions): Promise<CrossSessionReport>;
+export declare function renderCrossSessionMarkdown(r: CrossSessionReport): string;
+//# sourceMappingURL=aggregate-cross-session.d.ts.map

package/dist/toolkit/usage/aggregate-cross-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-cross-session.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/aggregate-cross-session.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACtD,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AA6BD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA2E7B;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAgCxE"}

package/dist/toolkit/usage/aggregate-cross-session.js

@@ -0,0 +1,142 @@
+import { readdirSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+function parseSince(spec, now) {
+    if (spec === "all")
+        return null;
+    const m = spec.match(/^(\d+)d$/);
+    if (!m)
+        return null;
+    const days = Number(m[1]);
+    return new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+}
+function listSummaries(root, connector) {
+    const result = [];
+    let connectors;
+    try {
+        connectors = readdirSync(root);
+    }
+    catch {
+        return result;
+    }
+    for (const conn of connectors) {
+        if (connector && conn !== connector)
+            continue;
+        const usageDir = join(root, conn, "usage");
+        if (!existsSync(usageDir))
+            continue;
+        let files;
+        try {
+            files = readdirSync(usageDir);
+        }
+        catch {
+            continue;
+        }
+        for (const f of files) {
+            if (f.startsWith("summary-") && f.endsWith(".json")) {
+                result.push({ connector: conn, path: join(usageDir, f) });
+            }
+        }
+    }
+    return result;
+}
+export async function aggregateCrossSession(opts) {
+    const now = opts.now ?? new Date();
+    const since = parseSince(opts.since, now);
+    const summaries = listSummaries(opts.dir, opts.connector);
+    const byConnector = {};
+    const byDay = new Map();
+    let totalCalls = 0, totalBytes = 0, totalTokens = 0, totalErrors = 0;
+    let scanned = 0;
+    for (const { connector, path } of summaries) {
+        let summary;
+        try {
+            summary = JSON.parse(readFileSync(path, "utf-8"));
+        }
+        catch {
+            continue;
+        }
+        // Use end time (or start time if end missing) as the session's effective time.
+        const endTs = summary.end || summary.start;
+        if (since && endTs && new Date(endTs) < since)
+            continue;
+        scanned += 1;
+        const calls = summary.total_calls ?? 0;
+        const bytes = summary.total_response_bytes ?? 0;
+        const tokens = summary.total_estimated_tokens ?? 0;
+        const errorCalls = Math.round((summary.error_rate ?? 0) * calls);
+        totalCalls += calls;
+        totalBytes += bytes;
+        totalTokens += tokens;
+        totalErrors += errorCalls;
+        const slot = byConnector[connector] ??= {
+            sessions: 0, calls: 0, response_bytes: 0, estimated_tokens: 0, errorCalls: 0,
+        };
+        slot.sessions += 1;
+        slot.calls += calls;
+        slot.response_bytes += bytes;
+        slot.estimated_tokens += tokens;
+        slot.errorCalls += errorCalls;
+        if (endTs) {
+            const day = endTs.slice(0, 10);
+            const d = byDay.get(day) ?? { day, calls: 0, response_bytes: 0, estimated_tokens: 0 };
+            d.calls += calls;
+            d.response_bytes += bytes;
+            d.estimated_tokens += tokens;
+            byDay.set(day, d);
+        }
+    }
+    const cleanByConnector = {};
+    for (const [k, v] of Object.entries(byConnector)) {
+        cleanByConnector[k] = {
+            sessions: v.sessions,
+            calls: v.calls,
+            response_bytes: v.response_bytes,
+            estimated_tokens: v.estimated_tokens,
+        };
+    }
+    return {
+        scope: {
+            connector: opts.connector ?? "all",
+            since: since ? since.toISOString() : "all",
+            sessions_scanned: scanned,
+        },
+        totals: {
+            calls: totalCalls,
+            response_bytes: totalBytes,
+            estimated_tokens: totalTokens,
+            error_rate: totalCalls > 0 ? totalErrors / totalCalls : 0,
+        },
+        by_connector: cleanByConnector,
+        by_day: [...byDay.values()].sort((a, b) => a.day.localeCompare(b.day)),
+    };
+}
+export function renderCrossSessionMarkdown(r) {
+    const connHeader = r.scope.connector === "all" ? "all connectors" : r.scope.connector;
+    const sinceHeader = r.scope.since === "all" ? "all time" : `since ${r.scope.since}`;
+    const connRows = Object.entries(r.by_connector)
+        .sort(([, a], [, b]) => b.response_bytes - a.response_bytes)
+        .map(([name, c]) => `| ${name} | ${c.sessions} | ${c.calls.toLocaleString()} | ${c.response_bytes.toLocaleString()} | ${c.estimated_tokens.toLocaleString()} |`)
+        .join("\n");
+    const dayRows = r.by_day
+        .map((d) => `| ${d.day} | ${d.calls.toLocaleString()} | ${d.response_bytes.toLocaleString()} | ${d.estimated_tokens.toLocaleString()} |`)
+        .join("\n");
+    return [
+        `# Usage report — ${connHeader}, ${sinceHeader}`, ``,
+        `Sessions scanned: ${r.scope.sessions_scanned}`, ``,
+        `## Totals`,
+        `- Calls: ${r.totals.calls.toLocaleString()}`,
+        `- Response bytes: ${r.totals.response_bytes.toLocaleString()}`,
+        `- Estimated tokens: ${r.totals.estimated_tokens.toLocaleString()}`,
+        `- Error rate: ${(r.totals.error_rate * 100).toFixed(1)}%`,
+        ``,
+        `## By connector`, ``,
+        `| connector | sessions | calls | bytes | est. tokens |`,
+        `|---|---|---|---|---|`,
+        connRows || "| _(none)_ |", ``,
+        `## By day`, ``,
+        `| day | calls | bytes | est. tokens |`,
+        `|---|---|---|---|`,
+        dayRows || "| _(none)_ |", ``,
+    ].join("\n");
+}
+//# sourceMappingURL=aggregate-cross-session.js.map

package/dist/toolkit/usage/aggregate-cross-session.js.map

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

package/dist/toolkit/usage/aggregate.d.ts

@@ -0,0 +1,4 @@
+import type { UsageRecord, UsageSummary } from "./types.js";
+export declare function aggregateRecords(sessionId: string, connector: string, records: UsageRecord[]): UsageSummary;
+export declare function renderSummaryMarkdown(s: UsageSummary): string;
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/toolkit/usage/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EAAE,GACrB,YAAY,CA+Ed;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAoC7D"}

package/dist/toolkit/usage/aggregate.js

@@ -0,0 +1,105 @@
+export function aggregateRecords(sessionId, connector, records) {
+    if (records.length === 0) {
+        return {
+            session_id: sessionId,
+            connector,
+            start: "",
+            end: "",
+            total_calls: 0,
+            total_response_bytes: 0,
+            total_estimated_tokens: 0,
+            error_rate: 0,
+            by_action: {},
+            top_responses: [],
+        };
+    }
+    const byAction = {};
+    let totalBytes = 0;
+    let totalTokens = 0;
+    let errors = 0;
+    let start = records[0].ts;
+    let end = records[0].ts;
+    for (const rec of records) {
+        totalBytes += rec.response_bytes;
+        totalTokens += rec.estimated_tokens;
+        if (rec.status !== "success")
+            errors += 1;
+        if (rec.ts < start)
+            start = rec.ts;
+        if (rec.ts > end)
+            end = rec.ts;
+        const slot = byAction[rec.action] ??
+            (byAction[rec.action] = {
+                calls: 0,
+                response_bytes: 0,
+                estimated_tokens: 0,
+                ms_total: 0,
+                ms_count: 0,
+            });
+        slot.calls += 1;
+        slot.response_bytes += rec.response_bytes;
+        slot.estimated_tokens += rec.estimated_tokens;
+        if (typeof rec.execution_time_ms === "number") {
+            slot.ms_total += rec.execution_time_ms;
+            slot.ms_count += 1;
+        }
+    }
+    const by_action = {};
+    for (const [action, s] of Object.entries(byAction)) {
+        by_action[action] = {
+            calls: s.calls,
+            response_bytes: s.response_bytes,
+            estimated_tokens: s.estimated_tokens,
+            avg_ms: s.ms_count > 0 ? Math.round(s.ms_total / s.ms_count) : 0,
+        };
+    }
+    const top_responses = [...records]
+        .sort((a, b) => b.response_bytes - a.response_bytes)
+        .slice(0, 3)
+        .map((r) => ({ action: r.action, response_bytes: r.response_bytes }));
+    return {
+        session_id: sessionId,
+        connector,
+        start,
+        end,
+        total_calls: records.length,
+        total_response_bytes: totalBytes,
+        total_estimated_tokens: totalTokens,
+        error_rate: errors / records.length,
+        by_action,
+        top_responses,
+    };
+}
+export function renderSummaryMarkdown(s) {
+    if (s.total_calls === 0) {
+        return `# ${s.connector} usage — session ${s.session_id}\n\nNo calls recorded.\n`;
+    }
+    const successes = s.total_calls - Math.round(s.error_rate * s.total_calls);
+    const errors = s.total_calls - successes;
+    const rows = Object.entries(s.by_action)
+        .sort(([, a], [, b]) => b.response_bytes - a.response_bytes)
+        .map(([action, a]) => `| ${action} | ${a.calls} | ${a.response_bytes.toLocaleString()} | ${a.estimated_tokens.toLocaleString()} | ${a.avg_ms} |`)
+        .join("\n");
+    const top = s.top_responses
+        .map((t, i) => `${i + 1}. ${t.action} (${t.response_bytes.toLocaleString()} bytes)`)
+        .join("\n");
+    return [
+        `# ${s.connector} usage — session ${s.session_id}`,
+        ``,
+        `- Window: ${s.start} → ${s.end}`,
+        `- Calls: ${s.total_calls} (${successes} success, ${errors} error — ${(s.error_rate * 100).toFixed(1)}%)`,
+        `- Response bytes: ${s.total_response_bytes.toLocaleString()} | Estimated tokens: ${s.total_estimated_tokens.toLocaleString()}`,
+        ``,
+        `## By action`,
+        ``,
+        `| action | calls | bytes | est. tokens | avg ms |`,
+        `|---|---|---|---|---|`,
+        rows,
+        ``,
+        `## Top responses`,
+        ``,
+        top,
+        ``,
+    ].join("\n");
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/toolkit/usage/aggregate.js.map

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

package/dist/toolkit/usage/index.d.ts

@@ -0,0 +1,11 @@
+export { parseAction, parseStatus } from "./parse.js";
+export { appendUsageRecord } from "./record.js";
+export { aggregateRecords, renderSummaryMarkdown } from "./aggregate.js";
+export { encodeTokens } from "./tokenize.js";
+export type { TokenMethod, TokenResult } from "./tokenize.js";
+export { runRetention } from "./retention.js";
+export type { RetentionOptions } from "./retention.js";
+export { aggregateCrossSession, renderCrossSessionMarkdown, } from "./aggregate-cross-session.js";
+export type { CrossSessionOptions, CrossSessionReport, CrossSessionByConnector, CrossSessionByDay, } from "./aggregate-cross-session.js";
+export type { UsageRecord, UsageSummary, UsageActionBreakdown, UsageTopResponse, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/toolkit/usage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/toolkit/usage/index.js

@@ -0,0 +1,7 @@
+export { parseAction, parseStatus } from "./parse.js";
+export { appendUsageRecord } from "./record.js";
+export { aggregateRecords, renderSummaryMarkdown } from "./aggregate.js";
+export { encodeTokens } from "./tokenize.js";
+export { runRetention } from "./retention.js";
+export { aggregateCrossSession, renderCrossSessionMarkdown, } from "./aggregate-cross-session.js";
+//# sourceMappingURL=index.js.map

package/dist/toolkit/usage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/toolkit/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC"}

package/dist/toolkit/usage/parse.d.ts

@@ -0,0 +1,5 @@
+/** Extract the value after `--action` from a Bash command string. */
+export declare function parseAction(command: string): string;
+/** Extract top-level `status` field from a connector envelope JSON string. */
+export declare function parseStatus(stdout: string): string;
+//# sourceMappingURL=parse.d.ts.map

package/dist/toolkit/usage/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/parse.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/dist/toolkit/usage/parse.js

@@ -0,0 +1,19 @@
+const ACTION_RE = /--action\s+([A-Za-z0-9_-]+)/;
+/** Extract the value after `--action` from a Bash command string. */
+export function parseAction(command) {
+    const m = command.match(ACTION_RE);
+    return m?.[1] ?? "unknown";
+}
+/** Extract top-level `status` field from a connector envelope JSON string. */
+export function parseStatus(stdout) {
+    if (!stdout)
+        return "unparseable";
+    try {
+        const parsed = JSON.parse(stdout);
+        return typeof parsed.status === "string" ? parsed.status : "unparseable";
+    }
+    catch {
+        return "unparseable";
+    }
+}
+//# sourceMappingURL=parse.js.map

package/dist/toolkit/usage/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/toolkit/usage/parse.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,6BAA6B,CAAC;AAEhD,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,IAAI,CAAC,MAAM;QAAE,OAAO,aAAa,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAyB,CAAC;QAC1D,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/toolkit/usage/record.d.ts

@@ -0,0 +1,8 @@
+import type { UsageRecord } from "./types.js";
+/**
+ * Append one UsageRecord as a JSON line to the given path. Creates parent
+ * directories as needed. Swallows all errors (hooks must never break the
+ * caller). Returns true on success, false on failure.
+ */
+export declare function appendUsageRecord(path: string, record: UsageRecord): boolean;
+//# sourceMappingURL=record.d.ts.map

package/dist/toolkit/usage/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/record.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAQ5E"}

package/dist/toolkit/usage/record.js

@@ -0,0 +1,18 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * Append one UsageRecord as a JSON line to the given path. Creates parent
+ * directories as needed. Swallows all errors (hooks must never break the
+ * caller). Returns true on success, false on failure.
+ */
+export function appendUsageRecord(path, record) {
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, JSON.stringify(record) + "\n", "utf-8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=record.js.map

package/dist/toolkit/usage/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../src/toolkit/usage/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAmB;IACjE,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/toolkit/usage/retention.d.ts

@@ -0,0 +1,6 @@
+export interface RetentionOptions {
+    gzipDays: number;
+    deleteDays: number;
+}
+export declare function runRetention(dir: string, opts: RetentionOptions): Promise<void>;
+//# sourceMappingURL=retention.d.ts.map

package/dist/toolkit/usage/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/retention.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCrF"}

package/dist/toolkit/usage/retention.js

@@ -0,0 +1,71 @@
+import { readdirSync, statSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { gzipSync } from "node:zlib";
+const TARGETS = /\.(jsonl|md)$/;
+const GZIPPED = /\.(jsonl|md)\.gz$/;
+export async function runRetention(dir, opts) {
+    const now = Date.now();
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    // Gzip pass
+    if (opts.gzipDays > 0) {
+        const cutoff = now - opts.gzipDays * 24 * 60 * 60 * 1000;
+        for (const name of entries) {
+            if (!TARGETS.test(name))
+                continue;
+            const p = join(dir, name);
+            let s;
+            try {
+                s = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (s.mtimeMs > cutoff)
+                continue;
+            try {
+                const data = readFileSync(p);
+                writeFileSync(`${p}.gz`, gzipSync(data));
+                unlinkSync(p);
+            }
+            catch {
+                // swallow — next run will retry
+            }
+        }
+    }
+    // Delete pass (re-read: gzip pass may have added .gz files)
+    if (opts.deleteDays > 0) {
+        const cutoff = now - opts.deleteDays * 24 * 60 * 60 * 1000;
+        let entries2;
+        try {
+            entries2 = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries2) {
+            if (!GZIPPED.test(name))
+                continue;
+            const p = join(dir, name);
+            let s;
+            try {
+                s = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (s.mtimeMs > cutoff)
+                continue;
+            try {
+                unlinkSync(p);
+            }
+            catch { }
+        }
+    }
+}
+//# sourceMappingURL=retention.js.map

package/dist/toolkit/usage/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../../src/toolkit/usage/retention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAOrC,MAAM,OAAO,GAAG,eAAe,CAAC;AAChC,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,IAAsB;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO;IAAC,CAAC;IAErD,YAAY;IACZ,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACzD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,CAAC;YACN,IAAI,CAAC;gBAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC5C,IAAI,CAAC,CAAC,OAAO,GAAG,MAAM;gBAAE,SAAS;YACjC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC7B,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;gBACzC,UAAU,CAAC,CAAC,CAAC,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,IAAI,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC3D,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO;QAAC,CAAC;QACtD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,CAAC;YACN,IAAI,CAAC;gBAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC5C,IAAI,CAAC,CAAC,OAAO,GAAG,MAAM;gBAAE,SAAS;YACjC,IAAI,CAAC;gBAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/toolkit/usage/tokenize.d.ts

@@ -0,0 +1,11 @@
+export type TokenMethod = "heuristic" | "gpt-4o";
+export interface TokenResult {
+    count: number;
+    method: TokenMethod;
+}
+/**
+ * Count tokens for a text payload. Best-effort: if the selected tokenizer is
+ * unavailable, falls back to the heuristic. Never throws.
+ */
+export declare function encodeTokens(text: string, method: TokenMethod | string): Promise<TokenResult>;
+//# sourceMappingURL=tokenize.d.ts.map

package/dist/toolkit/usage/tokenize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/tokenize.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACrB;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,MAAM,GAC3B,OAAO,CAAC,WAAW,CAAC,CAgBtB"}

package/dist/toolkit/usage/tokenize.js

@@ -0,0 +1,24 @@
+function heuristic(text) {
+    return { count: Math.ceil(Buffer.byteLength(text, "utf-8") / 4), method: "heuristic" };
+}
+/**
+ * Count tokens for a text payload. Best-effort: if the selected tokenizer is
+ * unavailable, falls back to the heuristic. Never throws.
+ */
+export async function encodeTokens(text, method) {
+    if (method !== "gpt-4o")
+        return heuristic(text);
+    try {
+        // Dynamic import: `gpt-tokenizer` is an optionalDependency; absence must
+        // degrade silently to the heuristic.
+        const mod = (await import("gpt-tokenizer"));
+        if (typeof mod.encode !== "function")
+            return heuristic(text);
+        const tokens = mod.encode(text);
+        return { count: tokens.length, method: "gpt-4o" };
+    }
+    catch {
+        return heuristic(text);
+    }
+}
+//# sourceMappingURL=tokenize.js.map

package/dist/toolkit/usage/tokenize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../../src/toolkit/usage/tokenize.ts"],"names":[],"mappings":"AAOA,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AACzF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,MAA4B;IAE5B,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,CAAC;QACH,yEAAyE;QACzE,qCAAqC;QACrC,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAGzC,CAAC;QACF,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/toolkit/usage/types.d.ts

@@ -0,0 +1,34 @@
+/** One line in <session-id>.jsonl — written by the PostToolUse hook. */
+export interface UsageRecord {
+    ts: string;
+    session_id: string;
+    connector: string;
+    action: string;
+    status: string;
+    response_bytes: number;
+    estimated_tokens: number;
+    execution_time_ms?: number;
+}
+export interface UsageActionBreakdown {
+    calls: number;
+    response_bytes: number;
+    estimated_tokens: number;
+    avg_ms: number;
+}
+export interface UsageTopResponse {
+    action: string;
+    response_bytes: number;
+}
+export interface UsageSummary {
+    session_id: string;
+    connector: string;
+    start: string;
+    end: string;
+    total_calls: number;
+    total_response_bytes: number;
+    total_estimated_tokens: number;
+    error_rate: number;
+    by_action: Record<string, UsageActionBreakdown>;
+    top_responses: UsageTopResponse[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/toolkit/usage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/toolkit/usage/types.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAChD,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC"}

package/dist/toolkit/usage/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/toolkit/usage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/toolkit/usage/types.ts"],"names":[],"mappings":""}