@google/gemini-cli-core 0.42.0 → 0.43.0-preview.1

package/dist/src/context/testing/contextTestUtils.js.map

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

package/dist/src/context/utils/adaptiveTokenCalculator.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Content, Part } from '@google/genai';
+import type { ConcreteNode } from '../graph/types.js';
+import { type AdvancedTokenCalculator } from './contextTokenCalculator.js';
+import type { NodeBehaviorRegistry } from '../graph/behaviorRegistry.js';
+import type { ContextEventBus } from '../eventBus.js';
+/**
+ * An Adaptive Token Calculator that dynamically learns the true token cost of the user's
+ * conversation by applying an Exponential Moving Average (EMA) gradient descent to
+ * real usage metadata returned from the Gemini API.
+ *
+ * It wraps the deterministic `StaticTokenCalculator` base heuristic to ensure
+ * immutable node cost caching while still surfacing a self-corrected estimate
+ * to the pipeline processors.
+ */
+export declare class AdaptiveTokenCalculator implements AdvancedTokenCalculator {
+    private learnedWeight;
+    private readonly baseCalculator;
+    constructor(charsPerToken: number, registry: NodeBehaviorRegistry, eventBus: ContextEventBus);
+    private handleGroundTruth;
+    /**
+     * Retrieves the current learned weight multiplier.
+     */
+    getLearnedWeight(): number;
+    /**
+     * Returns the exact, unweighted Base Heuristic Units for the graph.
+     * This is used exactly once per interaction to capture the baseline sent to the API.
+     */
+    getRawBaseUnits(nodes: readonly ConcreteNode[]): number;
+    /**
+     * Returns the exact, unweighted Base Heuristic Units for a raw content chunk.
+     */
+    getRawBaseUnitsForContent(content: Content): number;
+    calculateTokensAndBaseUnits(nodes: readonly ConcreteNode[]): {
+        tokens: number;
+        baseUnits: number;
+    };
+    calculateContentTokensAndBaseUnits(content: Content): {
+        tokens: number;
+        baseUnits: number;
+    };
+    garbageCollectCache(liveNodeIds: ReadonlySet<string>): void;
+    cacheNodeTokens(node: ConcreteNode): number;
+    calculateTokenBreakdown(nodes: readonly ConcreteNode[]): {
+        text: number;
+        media: number;
+        tool: number;
+        overhead: number;
+        total: number;
+    };
+    estimateTokensForParts(parts: Part[]): number;
+    getTokenCost(node: ConcreteNode): number;
+    calculateConcreteListTokens(nodes: readonly ConcreteNode[]): number;
+    calculateContentTokens(content: Content): number;
+    estimateTokensForString(text: string): number;
+    tokensToChars(tokens: number): number;
+}

package/dist/src/context/utils/adaptiveTokenCalculator.js

@@ -0,0 +1,116 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StaticTokenCalculator, } from './contextTokenCalculator.js';
+import { debugLogger } from '../../utils/debugLogger.js';
+/**
+ * An Adaptive Token Calculator that dynamically learns the true token cost of the user's
+ * conversation by applying an Exponential Moving Average (EMA) gradient descent to
+ * real usage metadata returned from the Gemini API.
+ *
+ * It wraps the deterministic `StaticTokenCalculator` base heuristic to ensure
+ * immutable node cost caching while still surfacing a self-corrected estimate
+ * to the pipeline processors.
+ */
+export class AdaptiveTokenCalculator {
+    learnedWeight = 1.0;
+    baseCalculator;
+    constructor(charsPerToken, registry, eventBus) {
+        this.baseCalculator = new StaticTokenCalculator(charsPerToken, registry);
+        eventBus.onTokenGroundTruth((event) => {
+            this.handleGroundTruth(event.actualTokens, event.promptBaseUnits);
+        });
+    }
+    handleGroundTruth(actualTokens, promptBaseUnits) {
+        if (promptBaseUnits <= 0)
+            return;
+        // Determine what ratio we should have used
+        const targetWeight = actualTokens / promptBaseUnits;
+        const oldWeight = this.learnedWeight;
+        // Apply Momentum (Learning Rate)
+        const learningRate = 0.2;
+        const newWeight = oldWeight * (1 - learningRate) + targetWeight * learningRate;
+        // Clamp to reasonable safety bounds to prevent rogue metadata poisoning the system
+        this.learnedWeight = Math.max(0.5, Math.min(newWeight, 2.0));
+        debugLogger.log(`[AdaptiveTokenCalculator] Learned weight updated to ${this.learnedWeight.toFixed(3)} ` +
+            `(API Tokens: ${actualTokens}, Base Units: ${promptBaseUnits}, Target Ratio: ${targetWeight.toFixed(3)})`);
+    }
+    /**
+     * Retrieves the current learned weight multiplier.
+     */
+    getLearnedWeight() {
+        return this.learnedWeight;
+    }
+    /**
+     * Returns the exact, unweighted Base Heuristic Units for the graph.
+     * This is used exactly once per interaction to capture the baseline sent to the API.
+     */
+    getRawBaseUnits(nodes) {
+        return this.baseCalculator.calculateConcreteListTokens(nodes);
+    }
+    /**
+     * Returns the exact, unweighted Base Heuristic Units for a raw content chunk.
+     */
+    getRawBaseUnitsForContent(content) {
+        return this.baseCalculator.calculateContentTokens(content);
+    }
+    calculateTokensAndBaseUnits(nodes) {
+        const baseUnits = this.baseCalculator.calculateConcreteListTokens(nodes);
+        return {
+            tokens: Math.round(baseUnits * this.learnedWeight),
+            baseUnits,
+        };
+    }
+    calculateContentTokensAndBaseUnits(content) {
+        const baseUnits = this.baseCalculator.calculateContentTokens(content);
+        return {
+            tokens: Math.round(baseUnits * this.learnedWeight),
+            baseUnits,
+        };
+    }
+    // --- Delegation and Weighting ---
+    garbageCollectCache(liveNodeIds) {
+        this.baseCalculator.garbageCollectCache(liveNodeIds);
+    }
+    cacheNodeTokens(node) {
+        return this.baseCalculator.cacheNodeTokens(node);
+    }
+    calculateTokenBreakdown(nodes) {
+        const raw = this.baseCalculator.calculateTokenBreakdown(nodes);
+        return {
+            text: Math.round(raw.text * this.learnedWeight),
+            media: Math.round(raw.media * this.learnedWeight),
+            tool: Math.round(raw.tool * this.learnedWeight),
+            overhead: Math.round(raw.overhead * this.learnedWeight),
+            total: Math.round(raw.total * this.learnedWeight),
+        };
+    }
+    estimateTokensForParts(parts) {
+        const baseUnits = this.baseCalculator.estimateTokensForParts(parts);
+        return Math.round(baseUnits * this.learnedWeight);
+    }
+    getTokenCost(node) {
+        const baseUnits = this.baseCalculator.getTokenCost(node);
+        return Math.round(baseUnits * this.learnedWeight);
+    }
+    calculateConcreteListTokens(nodes) {
+        const baseUnits = this.baseCalculator.calculateConcreteListTokens(nodes);
+        return Math.round(baseUnits * this.learnedWeight);
+    }
+    calculateContentTokens(content) {
+        const baseUnits = this.baseCalculator.calculateContentTokens(content);
+        return Math.round(baseUnits * this.learnedWeight);
+    }
+    estimateTokensForString(text) {
+        const baseUnits = this.baseCalculator.estimateTokensForString(text);
+        return Math.round(baseUnits * this.learnedWeight);
+    }
+    tokensToChars(tokens) {
+        // If weight is > 1.0 (we are inflating tokens), a single returned token is worth fewer chars.
+        // We reverse the math: convert requested tokens to target base units, then get chars.
+        return this.baseCalculator.tokensToChars(tokens / this.learnedWeight);
+    }
+}
+//# sourceMappingURL=adaptiveTokenCalculator.js.map

package/dist/src/context/utils/adaptiveTokenCalculator.js.map

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

package/dist/src/context/utils/adaptiveTokenCalculator.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/context/utils/adaptiveTokenCalculator.test.js

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { AdaptiveTokenCalculator } from './adaptiveTokenCalculator.js';
+import { NodeBehaviorRegistry } from '../graph/behaviorRegistry.js';
+import { registerBuiltInBehaviors } from '../graph/builtinBehaviors.js';
+import { ContextEventBus } from '../eventBus.js';
+import { createDummyNode } from '../testing/contextTestUtils.js';
+import { NodeType } from '../graph/types.js';
+describe('AdaptiveTokenCalculator', () => {
+    const registry = new NodeBehaviorRegistry();
+    registerBuiltInBehaviors(registry);
+    const charsPerToken = 1; // Simplifies math
+    it('should initialize with a learned weight of 1.0', () => {
+        const eventBus = new ContextEventBus();
+        const calculator = new AdaptiveTokenCalculator(charsPerToken, registry, eventBus);
+        expect(calculator.getLearnedWeight()).toBe(1.0);
+    });
+    it('should dynamically update learned weight based on token ground truth events', () => {
+        const eventBus = new ContextEventBus();
+        const calculator = new AdaptiveTokenCalculator(charsPerToken, registry, eventBus);
+        // Initial state: weight = 1.0
+        // Simulate an event where the API reported fewer tokens than our base units
+        // targetWeight = 50 / 100 = 0.5
+        // newWeight = 1.0 * 0.8 + 0.5 * 0.2 = 0.8 + 0.1 = 0.9
+        eventBus.emitTokenGroundTruth({
+            actualTokens: 50,
+            promptBaseUnits: 100,
+        });
+        // JavaScript floating point precision means we should use toBeCloseTo
+        expect(calculator.getLearnedWeight()).toBeCloseTo(0.9, 5);
+        // Simulate another event
+        // newWeight = 0.9 * 0.8 + (150 / 100) * 0.2 = 0.72 + 0.3 = 1.02
+        eventBus.emitTokenGroundTruth({
+            actualTokens: 150,
+            promptBaseUnits: 100,
+        });
+        expect(calculator.getLearnedWeight()).toBeCloseTo(1.02, 5);
+    });
+    it('should clamp the learned weight between 0.5 and 2.0', () => {
+        const eventBus = new ContextEventBus();
+        const calculator = new AdaptiveTokenCalculator(charsPerToken, registry, eventBus);
+        // Push weight up extremely high (API returns 10x tokens)
+        for (let i = 0; i < 20; i++) {
+            eventBus.emitTokenGroundTruth({
+                actualTokens: 1000,
+                promptBaseUnits: 100,
+            });
+        }
+        expect(calculator.getLearnedWeight()).toBe(2.0);
+        // Push weight down extremely low (API returns 0 tokens)
+        for (let i = 0; i < 20; i++) {
+            eventBus.emitTokenGroundTruth({ actualTokens: 0, promptBaseUnits: 100 });
+        }
+        expect(calculator.getLearnedWeight()).toBe(0.5);
+    });
+    it('should correctly apply the learned weight to node calculations while keeping raw base units stable', () => {
+        const eventBus = new ContextEventBus();
+        const calculator = new AdaptiveTokenCalculator(charsPerToken, registry, eventBus);
+        // Decrease the weight to exactly 0.5
+        for (let i = 0; i < 20; i++) {
+            eventBus.emitTokenGroundTruth({ actualTokens: 0, promptBaseUnits: 100 });
+        }
+        const turn1Id = 'turn-1';
+        const node1 = createDummyNode(turn1Id, NodeType.USER_PROMPT);
+        // Get raw base units directly
+        const rawTokens = calculator.calculateTokensAndBaseUnits([node1]).baseUnits;
+        // Get adjusted tokens
+        const adjustedTokens = calculator.calculateConcreteListTokens([node1]);
+        expect(adjustedTokens).toBe(Math.round(rawTokens * 0.5));
+    });
+    it('should ignore ground truth events with 0 promptBaseUnits to prevent division by zero', () => {
+        const eventBus = new ContextEventBus();
+        const calculator = new AdaptiveTokenCalculator(charsPerToken, registry, eventBus);
+        eventBus.emitTokenGroundTruth({
+            actualTokens: 100,
+            promptBaseUnits: 0,
+        });
+        expect(calculator.getLearnedWeight()).toBe(1.0);
+    });
+});
+//# sourceMappingURL=adaptiveTokenCalculator.test.js.map

package/dist/src/context/utils/adaptiveTokenCalculator.test.js.map

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

package/dist/src/context/utils/contextTokenCalculator.d.ts

@@ -10,7 +10,39 @@ import type { NodeBehaviorRegistry } from '../graph/behaviorRegistry.js';
  * The flat token cost assigned to a single multi-modal asset (like an image tile)
  * by the Gemini API. We use this as a baseline heuristic for inlineData/fileData.
  */
-export declare class ContextTokenCalculator {
+export interface ContextTokenCalculator {
+    estimateTokensForString(text: string): number;
+    tokensToChars(tokens: number): number;
+    garbageCollectCache(liveNodeIds: ReadonlySet<string>): void;
+    cacheNodeTokens(node: ConcreteNode): number;
+    getTokenCost(node: ConcreteNode): number;
+    calculateTokenBreakdown(nodes: readonly ConcreteNode[]): {
+        text: number;
+        media: number;
+        tool: number;
+        overhead: number;
+        total: number;
+    };
+    calculateConcreteListTokens(nodes: readonly ConcreteNode[]): number;
+    calculateContentTokens(content: Content): number;
+    estimateTokensForParts(parts: Part[]): number;
+}
+export interface AdvancedTokenCalculator extends ContextTokenCalculator {
+    getRawBaseUnits(nodes: readonly ConcreteNode[]): number;
+    getRawBaseUnitsForContent(content: Content): number;
+    calculateTokensAndBaseUnits(nodes: readonly ConcreteNode[]): {
+        tokens: number;
+        baseUnits: number;
+    };
+    calculateContentTokensAndBaseUnits(content: Content): {
+        tokens: number;
+        baseUnits: number;
+    };
+}
+/**
+ * A fast, deterministic token heuristic calculator.
+ */
+export declare class StaticTokenCalculator implements AdvancedTokenCalculator {
     private readonly charsPerToken;
     private readonly registry;
     private readonly tokenCache;
@@ -51,6 +83,20 @@ export declare class ContextTokenCalculator {
         tool: number;
         overhead: number;
     };
+    /**
+     * For the static calculator, Raw Base Units are exactly the same as the final tokens,
+     * because there is no dynamic learned weight (the multiplier is effectively 1.0).
+     */
+    getRawBaseUnits(nodes: readonly ConcreteNode[]): number;
+    getRawBaseUnitsForContent(content: Content): number;
+    calculateTokensAndBaseUnits(nodes: readonly ConcreteNode[]): {
+        tokens: number;
+        baseUnits: number;
+    };
+    calculateContentTokensAndBaseUnits(content: Content): {
+        tokens: number;
+        baseUnits: number;
+    };
     /**
      * Fast calculation for a flat array of ConcreteNodes (The Nodes).
      * It relies entirely on the O(1) sidecar token cache.

package/dist/src/context/utils/contextTokenCalculator.js

@@ -5,10 +5,9 @@
  */
 import { estimateTokenCountSync, MSG_OVERHEAD_TOKENS, } from '../../utils/tokenCalculation.js';
 /**
- * The flat token cost assigned to a single multi-modal asset (like an image tile)
- * by the Gemini API. We use this as a baseline heuristic for inlineData/fileData.
+ * A fast, deterministic token heuristic calculator.
  */
-export class ContextTokenCalculator {
+export class StaticTokenCalculator {
     charsPerToken;
     registry;
     tokenCache = new Map();
@@ -103,6 +102,24 @@ export class ContextTokenCalculator {
         }
         return breakdown;
     }
+    /**
+     * For the static calculator, Raw Base Units are exactly the same as the final tokens,
+     * because there is no dynamic learned weight (the multiplier is effectively 1.0).
+     */
+    getRawBaseUnits(nodes) {
+        return this.calculateConcreteListTokens(nodes);
+    }
+    getRawBaseUnitsForContent(content) {
+        return this.calculateContentTokens(content);
+    }
+    calculateTokensAndBaseUnits(nodes) {
+        const baseUnits = this.calculateConcreteListTokens(nodes);
+        return { tokens: baseUnits, baseUnits };
+    }
+    calculateContentTokensAndBaseUnits(content) {
+        const baseUnits = this.calculateContentTokens(content);
+        return { tokens: baseUnits, baseUnits };
+    }
     /**
      * Fast calculation for a flat array of ConcreteNodes (The Nodes).
      * It relies entirely on the O(1) sidecar token cache.

package/dist/src/context/utils/contextTokenCalculator.js.map

@@ -1 +1 @@
-{"version":3,"file":"contextTokenCalculator.js","sourceRoot":"","sources":["../../../../src/context/utils/contextTokenCalculator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contextTokenCalculator.js","sourceRoot":"","sources":["../../../../src/context/utils/contextTokenCalculator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AAwCzC;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAIb;IACA;IAJF,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExD,YACmB,aAAqB,EACrB,QAA8B;QAD9B,kBAAa,GAAb,aAAa,CAAQ;QACrB,aAAQ,GAAR,QAAQ,CAAsB;IAC9C,CAAC;IAEJ;;;OAGG;IACH,uBAAuB,CAAC,IAAY;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,MAAc;QAC1B,OAAO,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;IACrC,CAAC;IAED;;;OAGG;IAEH;;;OAGG;IACH,mBAAmB,CAAC,WAAgC;QAClD,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,eAAe,CAAC,IAAkB;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,IAAkB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,uBAAuB,CAAC,KAA8B;QAOpD,MAAM,SAAS,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACxE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAErB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC7B,SAAS,CAAC,QAAQ,IAAI,mBAAmB,CAAC;oBAC1C,SAAS,CAAC,KAAK,IAAI,mBAAmB,CAAC;gBACzC,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACrC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC;YAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAEjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAClC,SAAS,CAAC,IAAI,IAAI,sBAAsB,CACtC,CAAC,IAAI,CAAC,EACN,CAAC,EACD,IAAI,CAAC,aAAa,CACnB,CAAC;gBACJ,CAAC;qBAAM,IACL,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC;oBAC/C,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC7C,CAAC;oBACD,SAAS,CAAC,KAAK,IAAI,sBAAsB,CACvC,CAAC,IAAI,CAAC,EACN,CAAC,EACD,IAAI,CAAC,aAAa,CACnB,CAAC;gBACJ,CAAC;qBAAM,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtD,SAAS,CAAC,IAAI,IAAI,sBAAsB,CACtC,CAAC,IAAI,CAAC,EACN,CAAC,EACD,IAAI,CAAC,aAAa,CACnB,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,SAAS,CAAC,QAAQ,IAAI,sBAAsB,CAC1C,CAAC,IAAI,CAAC,EACN,CAAC,EACD,IAAI,CAAC,aAAa,CACnB,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,KAA8B;QAC5C,OAAO,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,yBAAyB,CAAC,OAAgB;QACxC,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,2BAA2B,CAAC,KAA8B;QAIxD,MAAM,SAAS,GAAG,IAAI,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC;QAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAC1C,CAAC;IAED,kCAAkC,CAAC,OAAgB;QAIjD,MAAM,SAAS,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACvD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,2BAA2B,CAAC,KAA8B;QACxD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACrB,MAAM,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBAElC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;wBAClC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBAC7B,MAAM,IAAI,mBAAmB,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,OAAgB;QACrC,OAAO,CACL,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,mBAAmB,CACvE,CAAC;IACJ,CAAC;IAED;;;OAGG;IACc,cAAc,GAAG,IAAI,OAAO,EAAkB,CAAC;IAEhE,sBAAsB,CAAC,KAAa;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9C,IAAI,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,IAAI,GAAG,sBAAsB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;oBAC7D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACtC,CAAC;gBACD,KAAK,IAAI,IAAI,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,sBAAsB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/src/context/utils/contextTokenCalculator.test.js

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { describe, it, expect } from 'vitest';
-import { ContextTokenCalculator } from './contextTokenCalculator.js';
+import { StaticTokenCalculator } from './contextTokenCalculator.js';
 import { NodeBehaviorRegistry } from '../graph/behaviorRegistry.js';
 import { registerBuiltInBehaviors } from '../graph/builtinBehaviors.js';
 import { createDummyNode } from '../testing/contextTestUtils.js';
@@ -14,7 +14,7 @@ describe('ContextTokenCalculator', () => {
     const registry = new NodeBehaviorRegistry();
     registerBuiltInBehaviors(registry);
     const charsPerToken = 1; // Simplifies math for text nodes in tests
-    const calculator = new ContextTokenCalculator(charsPerToken, registry);
+    const calculator = new StaticTokenCalculator(charsPerToken, registry);
     it('should include structural overhead for each unique turn', () => {
         const turn1Id = 'turn-1';
         const turn2Id = 'turn-2';
@@ -22,15 +22,15 @@ describe('ContextTokenCalculator', () => {
         const node2 = createDummyNode(turn1Id, NodeType.USER_PROMPT); // Same turn
         const node3 = createDummyNode(turn2Id, NodeType.AGENT_THOUGHT); // Different turn
         const nodes = [node1, node2, node3];
-        // Estimated tokens (using 0.33 per ASCII char heuristic):
-        // node1: floor(17 chars * 0.33) = 5 tokens
-        // node2: floor(17 chars * 0.33) = 5 tokens
-        // node3: floor(19 chars * 0.33) = 6 tokens
+        // Estimated tokens (using charsPerToken = 1):
+        // node1: 17 chars / 1 = 17 tokens
+        // node2: 17 chars / 1 = 17 tokens
+        // node3: 19 chars / 1 = 19 tokens
         // Turn 1 overhead: 5 tokens
         // Turn 2 overhead: 5 tokens
-        // Total: 5 + 5 + 6 + 5 + 5 = 26
+        // Total: 17 + 17 + 19 + 5 + 5 = 63
         const total = calculator.calculateConcreteListTokens(nodes);
-        expect(total).toBe(26);
+        expect(total).toBe(63);
     });
     it('should handle categorical breakdown with overhead', () => {
         const turn1Id = 'turn-1';

package/dist/src/context/utils/contextTokenCalculator.test.js.map

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

package/dist/src/context/utils/formatNodesForLlm.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ConcreteNode } from '../graph/types.js';
+export interface FormatNodesOptions {
+    /**
+     * The maximum number of characters to retain from a tool response.
+     * Tool responses larger than this will be truncated to preserve LLM attention span
+     * and avoid context limits during summarization operations.
+     * Defaults to 2000.
+     */
+    maxToolResponseChars?: number;
+}
+/**
+ * Formats a sequence of Context Graph nodes into a dense, human/LLM-readable text transcript.
+ * This is used by summarization processors (like SnapshotGenerator and RollingSummaryProcessor)
+ * to serialize the graph before passing it to an LLM.
+ */
+export declare function formatNodesForLlm(nodes: readonly ConcreteNode[], options?: FormatNodesOptions): string;

package/dist/src/context/utils/formatNodesForLlm.js

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Maps common tool names to semantic wrappers that improve LLM reading comprehension.
+ */
+function getSemanticToolWrapper(toolName) {
+    if (toolName.includes('search') || toolName.includes('grep'))
+        return `SEARCH RESULTS`;
+    if (toolName.includes('list') || toolName.includes('dir'))
+        return `WORKSPACE STRUCTURE`;
+    if (toolName.includes('shell') || toolName.includes('cmd'))
+        return `SHELL EXECUTION`;
+    if (toolName.includes('read') || toolName.includes('fetch'))
+        return `FILE/WEB CONTENT`;
+    return `TOOL RESPONSE`;
+}
+/**
+ * Formats a sequence of Context Graph nodes into a dense, human/LLM-readable text transcript.
+ * This is used by summarization processors (like SnapshotGenerator and RollingSummaryProcessor)
+ * to serialize the graph before passing it to an LLM.
+ */
+export function formatNodesForLlm(nodes, options = {}) {
+    const maxToolChars = options.maxToolResponseChars ?? 2000;
+    let transcript = '';
+    // Extract unique chronological turn IDs
+    const uniqueTurns = Array.from(new Set(nodes.map((n) => n.turnId).filter(Boolean)));
+    for (const node of nodes) {
+        const payload = node.payload;
+        let nodeContent = '';
+        if (payload.text) {
+            nodeContent = payload.text;
+        }
+        else if (payload.functionCall) {
+            nodeContent = `CALL: ${payload.functionCall.name}(${JSON.stringify(payload.functionCall.args)})`;
+        }
+        else if (payload.functionResponse) {
+            const toolName = payload.functionResponse.name || 'unknown_tool';
+            const rawResponse = JSON.stringify(payload.functionResponse.response);
+            const semanticWrapper = getSemanticToolWrapper(toolName);
+            let formattedResponse = rawResponse;
+            if (rawResponse.length > maxToolChars) {
+                const half = Math.floor(maxToolChars / 2);
+                const truncatedCount = rawResponse.length - maxToolChars;
+                formattedResponse = `${rawResponse.substring(0, half)}... [TRUNCATED ${truncatedCount} chars] ...${rawResponse.substring(rawResponse.length - half)}`;
+            }
+            nodeContent = `[${semanticWrapper} (${toolName})]: ${formattedResponse}`;
+        }
+        else {
+            // Fallback for unexpected node shapes
+            nodeContent = JSON.stringify(payload);
+        }
+        const role = (node.role || 'system').toUpperCase();
+        // Calculate relative turn index (e.g., -2, -1, 0)
+        let turnMarker = '';
+        if (node.turnId) {
+            const idx = uniqueTurns.indexOf(node.turnId);
+            if (idx !== -1) {
+                const relativeIdx = idx - (uniqueTurns.length - 1);
+                turnMarker = `[Turn ${relativeIdx}] `;
+            }
+        }
+        transcript += `${turnMarker}[${role}] [${node.type}]: ${nodeContent}\n`;
+    }
+    return transcript;
+}
+//# sourceMappingURL=formatNodesForLlm.js.map

package/dist/src/context/utils/formatNodesForLlm.js.map

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

package/dist/src/context/utils/formatNodesForLlm.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};