@skillstate/core 0.0.1 → 2.0.1

package/dist/state-manager.js

@@ -0,0 +1,129 @@
+// ---------------------------------------------------------------------------
+// 1. createInitialState — Σ₀ from schema defaults + optional overrides
+// ---------------------------------------------------------------------------
+export function createInitialState(schema, overrides) {
+    const state = {};
+    for (const [key, field] of Object.entries(schema)) {
+        state[key] = field.default;
+    }
+    if (overrides) {
+        for (const [key, value] of Object.entries(overrides)) {
+            state[key] = value;
+        }
+    }
+    return state;
+}
+// ---------------------------------------------------------------------------
+// 2. mergeState — ⊕ operator from SKILL.state paper
+//    - Non-null values overwrite
+//    - null values DELETE the key entirely
+//    - Nested dicts are merged recursively
+//    - Original state is NOT mutated
+// ---------------------------------------------------------------------------
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function mergeState(state, patch) {
+    const result = { ...state };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete result[key];
+        }
+        else if (isPlainObject(value) && isPlainObject(result[key])) {
+            // Recursive merge for nested objects — apply null-deletion inside too
+            result[key] = mergeNestedObjects(result[key], value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/** Deep merge two plain objects with null-deletion semantics. */
+function mergeNestedObjects(base, patch) {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete result[key];
+        }
+        else if (isPlainObject(value) && isPlainObject(result[key])) {
+            result[key] = mergeNestedObjects(result[key], value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// 3. validatePatch — reject unknown keys, wrong types; accept null for deletion
+// ---------------------------------------------------------------------------
+function checkType(value, field) {
+    if (value === null)
+        return true; // null is always valid (deletion)
+    switch (field.type) {
+        case 'string':
+            return typeof value === 'string';
+        case 'number':
+            return typeof value === 'number';
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'array':
+            return Array.isArray(value);
+        case 'object':
+            return isPlainObject(value);
+        default:
+            return false;
+    }
+}
+export function validatePatch(schema, patch) {
+    for (const [key, value] of Object.entries(patch)) {
+        const field = schema[key];
+        if (!field) {
+            return { valid: false, error: `Unknown key: ${key}`, field: key };
+        }
+        if (!checkType(value, field)) {
+            return {
+                valid: false,
+                error: `Invalid type for field '${key}': expected ${field.type}, got ${Array.isArray(value) ? 'array' : typeof value}`,
+                field: key,
+            };
+        }
+    }
+    return { valid: true };
+}
+// ---------------------------------------------------------------------------
+// 4. serializeState / deserializeState — JSON round-trip
+// ---------------------------------------------------------------------------
+export function serializeState(state, options) {
+    if (options?.pretty) {
+        return JSON.stringify(state, null, 2);
+    }
+    return JSON.stringify(state);
+}
+export function deserializeState(json) {
+    return JSON.parse(json);
+}
+// ---------------------------------------------------------------------------
+// 5. StateManager class — convenience wrapper with static methods
+// ---------------------------------------------------------------------------
+export class StateManager {
+    static createInitialState = createInitialState;
+    static mergeState = mergeState;
+    static validatePatch = validatePatch;
+    static serializeState = serializeState;
+    static deserializeState = deserializeState;
+}
+// ---------------------------------------------------------------------------
+// 6. createStateManager — factory function
+// ---------------------------------------------------------------------------
+export function createStateManager() {
+    return {
+        createInitialState,
+        mergeState,
+        validatePatch,
+        serializeState,
+        deserializeState,
+    };
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/state-manager.js.map

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

package/dist/state-store.d.ts

@@ -0,0 +1,48 @@
+import type { VersionedState } from './migrations.js';
+/**
+ * @non-paper async persistence seam over versioned states.
+ * `snapshot` is optional: a best-effort side copy for forensics/rollback.
+ */
+export interface StateStore {
+    /** Last committed state, or `null` when nothing resumable exists. */
+    load(): Promise<VersionedState | null>;
+    /** Durably commit `s` (atomic on disk-backed stores). */
+    save(s: VersionedState): Promise<void>;
+    /** Best-effort side copy of the last commit; no-op when there is none. */
+    snapshot?(): Promise<void>;
+}
+/**
+ * @non-paper in-memory `StateStore`. Copies on both `save` and `load`
+ * so callers can never alias the held commit.
+ */
+export declare class MemoryStore implements StateStore {
+    private current;
+    private readonly snaps;
+    load(): Promise<VersionedState | null>;
+    save(s: VersionedState): Promise<void>;
+    snapshot(): Promise<void>;
+    /** Deep copies of every `snapshot()` taken so far (oldest first). */
+    get snapshots(): VersionedState[];
+}
+/**
+ * @non-paper disk-backed `StateStore`.
+ *
+ * - `root`/`name` resolve via `resolveStatePath` (`..` escapes throw);
+ * - `save` serializes the envelope with `atomicWriteFile` — a crash can
+ *   leave a `.tmp.*` sibling but never a truncated commit;
+ * - snapshots land next to the commit at `<path>.snapshot` (same atomic
+ *   write; a missing commit snapshots to a no-op).
+ */
+export declare class FileStore implements StateStore {
+    private readonly root;
+    private readonly name;
+    private readonly filePath;
+    private readonly snapshotPath;
+    constructor(root: string, name: string);
+    /** Absolute commit path (inside `root`). */
+    get path(): string;
+    save(s: VersionedState): Promise<void>;
+    load(): Promise<VersionedState | null>;
+    snapshot(): Promise<void>;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/dist/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../src/state-store.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACvC,yDAAyD;IACzD,IAAI,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,WAAY,YAAW,UAAU;IAC5C,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAExC,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAE3C;IAEK,IAAI,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3C;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAI9B;IAED,qEAAqE;IACrE,IAAI,SAAS,IAAI,cAAc,EAAE,CAEhC;CACF;AAED;;;;;;;;GAQG;AACH,qBAAa,SAAU,YAAW,UAAU;IAKxC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,YACmB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAI9B;IAED,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,IAAI,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3C;IAEK,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAY3C;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ9B;CACF"}

package/dist/state-store.js

@@ -0,0 +1,101 @@
+/**
+ * @non-paper crash-safe state persistence (kill-mid-run → resume).
+ *
+ * The paper is pure in-memory Algorithm 1; this module adds an OPTIONAL
+ * persistence seam on top WITHOUT touching paper semantics:
+ *
+ * - `StateStore` — async `{ load, save, snapshot? }` over `VersionedState`;
+ * - `MemoryStore` — in-memory implementation (tests, dry-runs);
+ * - `FileStore(root, name)` — disk implementation built on the Wave-2
+ *   `@non-paper` primitives: `resolveStatePath` confines `name` inside
+ *   `root` (traversal throws) and `atomicWriteFile` (temp + fsync + rename)
+ *   guarantees readers never see a half-written commit — a kill mid-run
+ *   resumes from the LAST COMPLETE commit on `load()`.
+ *
+ * `load()` runs `migrate()` over the parsed JSON, so pre-envelope (v0)
+ * bare-state files resume losslessly. Missing files and corrupted JSON
+ * resolve to `null` (fresh start), never throw.
+ *
+ * Zero dependencies, Node >= 20, ESM.
+ */
+import * as fs from 'node:fs';
+import { atomicWriteFile, resolveStatePath } from './atomic-write.js';
+import { migrate } from './migrations.js';
+import { clone } from './clock.js';
+/**
+ * @non-paper in-memory `StateStore`. Copies on both `save` and `load`
+ * so callers can never alias the held commit.
+ */
+export class MemoryStore {
+    current = null;
+    snaps = [];
+    async load() {
+        return this.current === null ? null : clone(this.current);
+    }
+    async save(s) {
+        this.current = clone(s);
+    }
+    async snapshot() {
+        if (this.current !== null) {
+            this.snaps.push(clone(this.current));
+        }
+    }
+    /** Deep copies of every `snapshot()` taken so far (oldest first). */
+    get snapshots() {
+        return this.snaps.map((s) => clone(s));
+    }
+}
+/**
+ * @non-paper disk-backed `StateStore`.
+ *
+ * - `root`/`name` resolve via `resolveStatePath` (`..` escapes throw);
+ * - `save` serializes the envelope with `atomicWriteFile` — a crash can
+ *   leave a `.tmp.*` sibling but never a truncated commit;
+ * - snapshots land next to the commit at `<path>.snapshot` (same atomic
+ *   write; a missing commit snapshots to a no-op).
+ */
+export class FileStore {
+    root;
+    name;
+    filePath;
+    snapshotPath;
+    constructor(root, name) {
+        this.root = root;
+        this.name = name;
+        this.filePath = resolveStatePath(root, name);
+        this.snapshotPath = `${this.filePath}.snapshot`;
+    }
+    /** Absolute commit path (inside `root`). */
+    get path() {
+        return this.filePath;
+    }
+    async save(s) {
+        await atomicWriteFile(this.filePath, JSON.stringify(s));
+    }
+    async load() {
+        let raw;
+        try {
+            raw = await fs.promises.readFile(this.filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+        try {
+            return migrate(JSON.parse(raw));
+        }
+        catch {
+            return null;
+        }
+    }
+    async snapshot() {
+        let raw;
+        try {
+            raw = await fs.promises.readFile(this.filePath, 'utf-8');
+        }
+        catch {
+            return;
+        }
+        await atomicWriteFile(this.snapshotPath, raw);
+    }
+}
+//# sourceMappingURL=state-store.js.map

package/dist/state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../src/state-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAenC;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,OAAO,GAA0B,IAAI,CAAC;IAC7B,KAAK,GAAqB,EAAE,CAAC;IAE9C,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAiB;QAC1B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAS;IAKD,IAAI;IACJ,IAAI;IALN,QAAQ,CAAS;IACjB,YAAY,CAAS;IAEtC,YACmB,IAAY,EACZ,IAAY;oBADZ,IAAI;oBACJ,IAAI;QAErB,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,GAAG,IAAI,CAAC,QAAQ,WAAW,CAAC;IAClD,CAAC;IAED,4CAA4C;IAC5C,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAiB;QAC1B,MAAM,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,MAAM,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/token-tracker.d.ts

@@ -0,0 +1,104 @@
+import type { TrackerConfig, ExecutionStep } from './types.js';
+/**
+ * Paper §4.3 primary metrics — EXACTLY three, measured in raw string CHARS:
+ * - accuracy (Task Accuracy): accepted patches / actionable steps (null when none).
+ * - averagePromptSize (Average Prompt Size): mean prompt char length per call.
+ * - totalTokens (Total Token Cost): cumulative char burn (prompts + responses).
+ *
+ * No tokenizer lives here: `recordStep` consumes the char counts the
+ * runtime measured (`promptChars` / `responseChars`). Anything estimated
+ * (len/4 heuristics, dollar pricing) belongs to `./instrumentation.js`
+ * and is explicitly marked @non-paper.
+ */
+export interface PaperMetrics {
+    /** Task Accuracy (§4.3). Null when no step was actionable. */
+    accuracy: number | null;
+    /** Mean prompt char length per recorded call (§4.3 Average Prompt Size). */
+    averagePromptSize: number;
+    /** Cumulative burn: prompt chars + response chars (§4.3 Total Token Cost). */
+    totalTokens: number;
+}
+/**
+ * @non-paper session bookkeeping beyond the §4.3 triad. Kept on a separate
+ * accessor (`getBookkeeping`) so the primary metrics object stays clean —
+ * `totalChars` here equals `totalTokens` (both are the cumulative char burn)
+ * and is retained for the CLI/dashboard/report consumers that grew up on it.
+ */
+export interface BookkeepingMetrics {
+    stepCount: number;
+    /** Cumulative prompt chars across all steps. */
+    totalPromptChars: number;
+    /** Cumulative burn: prompt chars + response chars (same value as totalTokens). */
+    totalChars: number;
+    sessionName: string;
+    lastStepTimestamp: number | null;
+}
+/**
+ * Baseline comparison from MEASURED chars (paper Table 1 methodology):
+ * the conversation baseline re-sends every prior turn at each step
+ * (O(T²) cumulative), SKILL sends only the current Σt (O(T)).
+ */
+interface BaselineComparison {
+    /** Σ(t=1..T) Σ(i=1..t) promptChars[i] — the O(T²) conversation model. */
+    conversationChars: number;
+    /** Σ(t=1..T) promptChars[t] — the O(T) state model. */
+    stateChars: number;
+    /** conversationChars / stateChars (0 when nothing was recorded). */
+    reductionFactor: number;
+}
+export declare class TokenTracker {
+    private config;
+    private steps;
+    private totalPromptChars;
+    private totalResponseChars;
+    private cumulativePromptChars;
+    private lastStepTimestamp;
+    private startedAt;
+    constructor(config: TrackerConfig);
+    recordStep(step: ExecutionStep): void;
+    /**
+     * Paper §4.3 primary metrics — EXACTLY three fields.
+     *
+     * This is the clean §4.3 surface: Task Accuracy, Average Prompt Size
+     * (mean prompt char length per call), Total Token Cost (cumulative char
+     * burn). Bookkeeping (stepCount, sessionName, lastStepTimestamp,
+     * totalPromptChars, totalChars) lives on {@link getBookkeeping} so this
+     * object is never contaminated by non-§4.3 concerns.
+     */
+    getMetrics(): PaperMetrics;
+    /**
+     * @non-paper session bookkeeping separate from the §4.3 triad. Keeps the
+     * step count, cumulative prompt chars, cumulative char burn (same value
+     * as `totalTokens`), session name, and last-step timestamp for the CLI,
+     * dashboard, and report consumers.
+     */
+    getBookkeeping(): BookkeepingMetrics;
+    compareWithBaseline(): BaselineComparison;
+    exportReport(): string;
+    save(overridePath?: string): void;
+    /**
+     * @non-paper best-effort persist: returns the current report and writes
+     * it to `overridePath ?? persistPath` when a path is available. Unlike
+     * `save`, NEVER throws for a missing path — teardown/flush call sites
+     * must be safe to run unconditionally.
+     */
+    flush(overridePath?: string): string;
+    /**
+     * @non-paper archive-and-reset: returns the current report, persists it
+     * to `archivePath ?? persistPath` when a path is available, then resets
+     * step history and char counters to zero. Session identity
+     * (`sessionName`/`platform`) is kept; `startedAt` restarts at now so the
+     * next segment reads as a fresh session tail.
+     */
+    rotate(archivePath?: string): string;
+    /**
+     * @non-paper rollback helper for budget enforcement: keep only the first
+     * `keep` steps and rebuild every counter through the single `recordStep`
+     * accounting path, so `compareWithBaseline` stays exact after truncation.
+     * `keep >= stepCount` is a no-op; negatives clamp to zero.
+     */
+    truncateTo(keep: number): void;
+    load(overridePath?: string): void;
+}
+export {};
+//# sourceMappingURL=token-tracker.d.ts.map

package/dist/token-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-tracker.d.ts","sourceRoot":"","sources":["../src/token-tracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4EAA4E;IAC5E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,UAAU,kBAAkB;IAC1B,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;CACzB;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,kBAAkB,CAAK;IAG/B,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,SAAS,CAAS;IAE1B,YAAY,MAAM,EAAE,aAAa,EAOhC;IAED,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAMpC;IAED;;;;;;;;OAQG;IACH,UAAU,IAAI,YAAY,CAqBzB;IAED;;;;;OAKG;IACH,cAAc,IAAI,kBAAkB,CAQnC;IAED,mBAAmB,IAAI,kBAAkB,CAmBxC;IAED,YAAY,IAAI,MAAM,CAYrB;IAED,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAWhC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CASnC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAenC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAc7B;IAED,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAoChC;CACF"}

package/dist/token-tracker.js

@@ -0,0 +1,204 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export class TokenTracker {
+    config;
+    steps = [];
+    totalPromptChars = 0;
+    totalResponseChars = 0;
+    // Σ(t=1..N) Σ(i=1..t) promptChars[i], built incrementally: each new
+    // step adds the running prompt-char total (paper §3.3 eq.5: |C_t| = O(t)).
+    cumulativePromptChars = 0;
+    lastStepTimestamp = null;
+    startedAt;
+    constructor(config) {
+        this.config = {
+            persistPath: undefined,
+            sessionName: `session-${Date.now()}`,
+            ...config,
+        };
+        this.startedAt = Date.now();
+    }
+    recordStep(step) {
+        this.steps.push(step);
+        this.totalPromptChars += step.promptChars;
+        this.totalResponseChars += step.responseChars;
+        this.cumulativePromptChars += this.totalPromptChars;
+        this.lastStepTimestamp = step.timestamp;
+    }
+    /**
+     * Paper §4.3 primary metrics — EXACTLY three fields.
+     *
+     * This is the clean §4.3 surface: Task Accuracy, Average Prompt Size
+     * (mean prompt char length per call), Total Token Cost (cumulative char
+     * burn). Bookkeeping (stepCount, sessionName, lastStepTimestamp,
+     * totalPromptChars, totalChars) lives on {@link getBookkeeping} so this
+     * object is never contaminated by non-§4.3 concerns.
+     */
+    getMetrics() {
+        const stepCount = this.steps.length;
+        const averagePromptSize = stepCount > 0 ? this.totalPromptChars / stepCount : 0;
+        // Task Accuracy (paper §4.3): fraction of actionable steps whose patch
+        // was accepted. Steps with success === undefined are not actionable and
+        // are excluded from both numerator and denominator. Null when no step
+        // was actionable (including the zero-step session).
+        const actionableSteps = this.steps.filter((s) => s.success !== undefined);
+        const accuracy = actionableSteps.length === 0
+            ? null
+            : actionableSteps.filter((s) => s.success === true).length /
+                actionableSteps.length;
+        return {
+            accuracy,
+            averagePromptSize,
+            totalTokens: this.totalPromptChars + this.totalResponseChars,
+        };
+    }
+    /**
+     * @non-paper session bookkeeping separate from the §4.3 triad. Keeps the
+     * step count, cumulative prompt chars, cumulative char burn (same value
+     * as `totalTokens`), session name, and last-step timestamp for the CLI,
+     * dashboard, and report consumers.
+     */
+    getBookkeeping() {
+        return {
+            stepCount: this.steps.length,
+            totalPromptChars: this.totalPromptChars,
+            totalChars: this.totalPromptChars + this.totalResponseChars,
+            sessionName: this.config.sessionName ?? `session-${this.startedAt}`,
+            lastStepTimestamp: this.lastStepTimestamp,
+        };
+    }
+    compareWithBaseline() {
+        if (this.steps.length === 0) {
+            return {
+                conversationChars: 0,
+                stateChars: 0,
+                reductionFactor: 0,
+            };
+        }
+        const conversationChars = this.cumulativePromptChars;
+        const stateChars = this.totalPromptChars;
+        const reductionFactor = stateChars > 0 ? conversationChars / stateChars : 0;
+        return {
+            conversationChars,
+            stateChars,
+            reductionFactor,
+        };
+    }
+    exportReport() {
+        const report = {
+            metrics: { ...this.getMetrics(), ...this.getBookkeeping() },
+            steps: this.steps,
+            session: {
+                name: this.config.sessionName ?? `session-${this.startedAt}`,
+                platform: this.config.platform,
+                startedAt: this.startedAt,
+            },
+        };
+        return JSON.stringify(report);
+    }
+    save(overridePath) {
+        const filePath = overridePath ?? this.config.persistPath;
+        if (!filePath) {
+            throw new Error('No persist path configured');
+        }
+        const dir = path.dirname(filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        const report = this.exportReport();
+        fs.writeFileSync(filePath, report, 'utf-8');
+    }
+    /**
+     * @non-paper best-effort persist: returns the current report and writes
+     * it to `overridePath ?? persistPath` when a path is available. Unlike
+     * `save`, NEVER throws for a missing path — teardown/flush call sites
+     * must be safe to run unconditionally.
+     */
+    flush(overridePath) {
+        const report = this.exportReport();
+        const filePath = overridePath ?? this.config.persistPath;
+        if (filePath !== undefined) {
+            const dir = path.dirname(filePath);
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(filePath, report, 'utf-8');
+        }
+        return report;
+    }
+    /**
+     * @non-paper archive-and-reset: returns the current report, persists it
+     * to `archivePath ?? persistPath` when a path is available, then resets
+     * step history and char counters to zero. Session identity
+     * (`sessionName`/`platform`) is kept; `startedAt` restarts at now so the
+     * next segment reads as a fresh session tail.
+     */
+    rotate(archivePath) {
+        const report = this.exportReport();
+        const filePath = archivePath ?? this.config.persistPath;
+        if (filePath !== undefined) {
+            const dir = path.dirname(filePath);
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(filePath, report, 'utf-8');
+        }
+        this.steps = [];
+        this.totalPromptChars = 0;
+        this.totalResponseChars = 0;
+        this.cumulativePromptChars = 0;
+        this.lastStepTimestamp = null;
+        this.startedAt = Date.now();
+        return report;
+    }
+    /**
+     * @non-paper rollback helper for budget enforcement: keep only the first
+     * `keep` steps and rebuild every counter through the single `recordStep`
+     * accounting path, so `compareWithBaseline` stays exact after truncation.
+     * `keep >= stepCount` is a no-op; negatives clamp to zero.
+     */
+    truncateTo(keep) {
+        const clamped = Math.max(0, keep);
+        if (clamped >= this.steps.length) {
+            return;
+        }
+        const kept = this.steps.slice(0, clamped);
+        this.steps = [];
+        this.totalPromptChars = 0;
+        this.totalResponseChars = 0;
+        this.cumulativePromptChars = 0;
+        this.lastStepTimestamp = null;
+        for (const step of kept) {
+            this.recordStep(step);
+        }
+    }
+    load(overridePath) {
+        const filePath = overridePath ?? this.config.persistPath;
+        if (!filePath) {
+            return;
+        }
+        try {
+            const data = fs.readFileSync(filePath, 'utf-8');
+            const report = JSON.parse(data);
+            // Restore steps through the single accounting path
+            this.steps = [];
+            this.totalPromptChars = 0;
+            this.totalResponseChars = 0;
+            this.cumulativePromptChars = 0;
+            this.lastStepTimestamp = null;
+            for (const step of report.steps ?? []) {
+                this.recordStep(step);
+            }
+            // Restore session metadata
+            if (report.session?.name) {
+                this.config.sessionName = report.session.name;
+            }
+            if (report.session?.startedAt) {
+                this.startedAt = report.session.startedAt;
+            }
+        }
+        catch {
+            // Gracefully handle missing or corrupted files — reset to defaults
+            this.steps = [];
+            this.totalPromptChars = 0;
+            this.totalResponseChars = 0;
+            this.cumulativePromptChars = 0;
+            this.lastStepTimestamp = null;
+        }
+    }
+}
+//# sourceMappingURL=token-tracker.js.map

package/dist/token-tracker.js.map

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