@nxuss/lemma 1.40.0 → 1.41.0

package/dist/cjs/utils/SavingsLedger.d.ts

@@ -48,12 +48,29 @@ export interface CostAttribution {
      * through an explicit channel — never inferred by dividing totals by call counts.
      */
     origin?: string;
+    /** Workspace the call ran in (the MCP process cwd). Absent for what the proxy computes itself. */
+    project?: string;
 }
 /** Per-tool rollup of one CostSource — the breakdown token_budget prints. Bounded. */
 export interface ToolCostStats {
     events: number;
     tokensSpent: number;
 }
+/**
+ * Per-(source, tool) rollup of what was SAVED, keyed "<source>:<tool>". The ledger used to say
+ * "contextSqueeze saved 4.6M" with no way to see which tool produced it, so the claim could not be
+ * audited. Bounded like the cost rollups.
+ */
+export interface ToolSavedStats {
+    events: number;
+    tokensSaved: number;
+}
+/** Who a saving belongs to. Optional: older callers and the proxy's own squeezes carry none. */
+export interface SavingAttribution {
+    tool?: string;
+    /** Workspace the saving happened in; absent for the proxy's own squeezes. */
+    project?: string;
+}
 export interface NetStats {
     /** tokensSaved - tokensSpent. Negative means Lemma cost more than it saved. */
     netTokens: number;
@@ -104,38 +121,58 @@ export interface SavingsSnapshot {
         byTool: Record<string, ToolCostStats>;
         byHost: Record<string, ToolCostStats>;
         byOrigin: Record<string, ToolCostStats>;
+        /** "<tool>|<host>" → cost: who called which tool. Tool names never contain "|", so split on the first one. */
+        byToolHost: Record<string, ToolCostStats>;
+    };
+    /**
+     * Which tool each saving came from, keyed "<source>:<tool>". Savings recorded without a tool
+     * name (the proxy's own squeezes) are in the source totals but in no row here: compare the sum
+     * of the rows with the source total to see how much is unattributed.
+     */
+    savingsAttribution: {
+        byTool: Record<string, ToolSavedStats>;
     };
+    /** Which project this snapshot is scoped to; null = the whole daemon. */
+    project: string | null;
+    /**
+     * Saved/spent per project, always the whole picture whatever the snapshot is scoped to, so the
+     * dashboard can rank projects and show how much of the total belongs to none. Only events that
+     * carried a project are in here: everything recorded before projects were attributed, and what
+     * the proxy computes itself (clipboard, its own squeezes), is in the total and in no row.
+     */
+    projectTotals: Record<string, ProjectTotals>;
+}
+/** One project's net position, for ranking next to the others. */
+export interface ProjectTotals {
+    tokensSaved: number;
+    tokensSpent: number;
+    netTokens: number;
 }
 /** Average blended cost per input token across GPT-4o / Claude Sonnet / Gemini Pro */
 export declare const AVG_COST_PER_TOKEN = 0.000008;
 declare class SavingsLedger {
-    private sources;
-    private costs;
-    /** Per-tool rollup of toolResult spend: tool name -> { events, tokensSpent }. */
-    private costByTool;
-    /** Per-host rollup (hosts are a handful of known values — no cap needed). */
-    private costByHost;
-    /** Per-origin rollup: "lemma" vs anything explicitly reported otherwise. */
-    private costByOrigin;
+    /** The whole daemon: every event, with or without a project. */
+    private readonly all;
+    /** One slice per workspace path, fed only by events that said which project they came from. */
+    private projects;
     private readonly sessionStartedAt;
-    /** Local day (YYYY-MM-DD) -> tokens saved/spent that day. */
-    private daily;
     constructor();
     private load;
     private save;
+    /** The slice an event belongs to, created on first sight; past MAX_PROJECTS they share one overflow slice. */
+    private projectState;
+    private applySaved;
     /**
      * Record a savings event by char counts (automatically converts to token estimate).
      * @param source  Which module recorded the savings
      * @param charsBefore  Original char count before compression/routing
      * @param charsAfter   Resulting char count after compression/routing
      */
-    record(source: SavingsSource, charsBefore: number, charsAfter: number): void;
-    /** Adds to today's totals and drops days past MAX_DAYS_KEPT. */
-    private bumpDay;
+    record(source: SavingsSource, charsBefore: number, charsAfter: number, attribution?: SavingAttribution): void;
     /**
      * Record a savings event directly in tokens (for sources that already know their token count).
      */
-    recordTokens(source: SavingsSource, tokensSaved: number): void;
+    recordTokens(source: SavingsSource, tokensSaved: number, attribution?: SavingAttribution): void;
     /**
      * Record tokens Lemma *spent*. Counterpart to record()/recordTokens() — without
      * this the ledger can only ever grow, which is not evidence of anything.
@@ -146,12 +183,15 @@ declare class SavingsLedger {
      * ever incremented alongside the bucket they annotate.
      */
     recordCost(source: CostSource, tokensSpent: number, attribution?: CostAttribution): void;
-    /** One attributed event into a rollup map. byTool is capped; host/origin are naturally small. */
-    private bumpRollup;
     /** Record a cost event by char count (converts with the same chars/4 heuristic). */
     recordCostChars(source: CostSource, chars: number, attribution?: CostAttribution): void;
-    /** Returns a full snapshot including computed totals, costs and net position */
-    getSnapshot(): SavingsSnapshot;
+    private projectTotals;
+    /**
+     * A full snapshot: totals, costs and net position. With `project`, the same shape scoped to that
+     * workspace (zeros when nothing was attributed to it yet — never the daemon's totals, which would
+     * read as that project's own).
+     */
+    getSnapshot(project?: string | null): SavingsSnapshot;
     /** Returns a pretty terminal summary block */
     getTerminalSummary(): string;
     /** Reset all counters (e.g., on cache clear) */

package/dist/cjs/utils/SavingsLedger.d.ts.map

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