@machina.ai/cell-cli-core 1.38.1-rc2 → 1.40.1-rc2

package/dist/src/context/system-tests/lifecycle.golden.test.js

@@ -0,0 +1,195 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeAll, afterAll } from 'vitest';
+import { SimulationHarness } from './simulationHarness.js';
+import { createMockLlmClient } from '../testing/contextTestUtils.js';
+import { createToolMaskingProcessor } from '../processors/toolMaskingProcessor.js';
+import { createBlobDegradationProcessor } from '../processors/blobDegradationProcessor.js';
+import { createStateSnapshotProcessor } from '../processors/stateSnapshotProcessor.js';
+import { createHistoryTruncationProcessor } from '../processors/historyTruncationProcessor.js';
+import { createStateSnapshotAsyncProcessor } from '../processors/stateSnapshotAsyncProcessor.js';
+expect.addSnapshotSerializer({
+    test: (val) => typeof val === 'string' &&
+        (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(val) ||
+            /^\/tmp\/sim/.test(val)), // Mask temp directories and UUIDs
+    print: (val) => typeof val === 'string' && /^\/tmp\/sim/.test(val)
+        ? '"<MOCKED_DIR>"'
+        : '"<UUID>"',
+});
+describe('System Lifecycle Golden Tests', () => {
+    beforeAll(() => {
+        vi.spyOn(Math, 'random').mockReturnValue(0.5);
+    });
+    afterAll(() => {
+        vi.restoreAllMocks();
+    });
+    const getAggressiveConfig = () => ({
+        config: {
+            budget: { maxTokens: 1000, retainedTokens: 500 }, // Extremely tight limits
+        },
+        buildPipelines: (env) => [
+            {
+                name: 'Pressure Relief', // Emits from eventBus 'retained_exceeded'
+                triggers: ['retained_exceeded'],
+                processors: [
+                    createBlobDegradationProcessor('BlobDegradationProcessor', env),
+                    createToolMaskingProcessor('ToolMaskingProcessor', env, {
+                        stringLengthThresholdTokens: 50,
+                    }),
+                    createStateSnapshotProcessor('StateSnapshotProcessor', env, {}),
+                ],
+            },
+            {
+                name: 'Immediate Sanitization', // The magic string the projector is hardcoded to use
+                triggers: ['retained_exceeded'],
+                processors: [
+                    createHistoryTruncationProcessor('HistoryTruncationProcessor', env, {}),
+                ],
+            },
+        ],
+        buildAsyncPipelines: (env) => [
+            {
+                name: 'Async',
+                triggers: ['nodes_aged_out'],
+                processors: [
+                    createStateSnapshotAsyncProcessor('StateSnapshotAsyncProcessor', env, {}),
+                ],
+            },
+        ],
+    });
+    const mockLlmClient = createMockLlmClient([
+        '<MOCKED_STATE_SNAPSHOT_SUMMARY>',
+    ]);
+    it('Scenario 1: Organic Growth with Huge Tool Output & Images', async () => {
+        const harness = await SimulationHarness.create(getAggressiveConfig(), mockLlmClient);
+        // Turn 0: System Prompt
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'System Instructions' }] },
+            { role: 'model', parts: [{ text: 'Ack.' }] },
+        ]);
+        // Turn 1: Normal conversation
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'Hello!' }] },
+            { role: 'model', parts: [{ text: 'Hi, how can I help?' }] },
+        ]);
+        // Turn 2: Massive Tool Output (Should trigger ToolMaskingProcessor in background)
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'Read the logs.' }] },
+            {
+                role: 'model',
+                parts: [
+                    {
+                        functionCall: {
+                            name: 'run_shell_command',
+                            args: { cmd: 'cat server.log' },
+                        },
+                    },
+                ],
+            },
+            {
+                role: 'user',
+                parts: [
+                    {
+                        functionResponse: {
+                            name: 'run_shell_command',
+                            response: { output: 'LOG '.repeat(5000) },
+                        },
+                    },
+                ],
+            },
+            { role: 'model', parts: [{ text: 'The logs are very long.' }] },
+        ]);
+        // Turn 3: Multi-modal blob (Should trigger BlobDegradationProcessor)
+        await harness.simulateTurn([
+            {
+                role: 'user',
+                parts: [
+                    { text: 'Look at this architecture diagram:' },
+                    {
+                        inlineData: {
+                            mimeType: 'image/png',
+                            data: 'fake_base64_data_'.repeat(1000),
+                        },
+                    },
+                ],
+            },
+            { role: 'model', parts: [{ text: 'Nice diagram.' }] },
+        ]);
+        // Turn 4: More conversation to trigger StateSnapshot
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'Can we refactor?' }] },
+            { role: 'model', parts: [{ text: 'Yes we can.' }] },
+        ]);
+        // Get final state
+        const goldenState = await harness.getGoldenState();
+        // In a perfectly functioning opportunistic system, the token trajectory should show
+        // the massive spikes in Turn 2 and 3 being immediately resolved by the background tasks.
+        // The final projection should fit neatly under the Max Tokens limit.
+        expect(goldenState).toMatchSnapshot();
+    });
+    it('Scenario 2: Under Budget (No Modifications)', async () => {
+        const generousConfig = {
+            config: {
+                budget: { maxTokens: 100000, retainedTokens: 50000 },
+            },
+            buildPipelines: () => [],
+            buildAsyncPipelines: () => [],
+        };
+        const harness = await SimulationHarness.create(generousConfig, mockLlmClient);
+        // Turn 0: System Prompt
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'System Instructions' }] },
+            { role: 'model', parts: [{ text: 'Ack.' }] },
+        ]);
+        // Turn 1: Normal conversation
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'Hello!' }] },
+            { role: 'model', parts: [{ text: 'Hi, how can I help?' }] },
+        ]);
+        const goldenState = await harness.getGoldenState();
+        // Total tokens should cleanly match character count with no synthetic nodes
+        expect(goldenState).toMatchSnapshot();
+    });
+    it('Scenario 3: Async-Driven Background GC', async () => {
+        const gcConfig = {
+            config: {
+                budget: { maxTokens: 200, retainedTokens: 100 },
+            },
+            buildPipelines: () => [],
+            buildAsyncPipelines: (env) => [
+                {
+                    name: 'Async',
+                    triggers: ['nodes_aged_out'],
+                    processors: [
+                        createStateSnapshotAsyncProcessor('StateSnapshotAsyncProcessor', env, {}),
+                    ],
+                },
+            ],
+        };
+        const harness = await SimulationHarness.create(gcConfig, mockLlmClient);
+        // Turn 0
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'A'.repeat(50) }] },
+            { role: 'model', parts: [{ text: 'B'.repeat(50) }] },
+        ]);
+        // Turn 1 (Should trigger StateSnapshotasync pipeline because we exceed 100 retainedTokens)
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'C'.repeat(50) }] },
+            { role: 'model', parts: [{ text: 'D'.repeat(50) }] },
+        ]);
+        // Give the async background pipeline an extra beat to complete its async execution and emit variants
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        // Turn 2
+        await harness.simulateTurn([
+            { role: 'user', parts: [{ text: 'E'.repeat(50) }] },
+            { role: 'model', parts: [{ text: 'F'.repeat(50) }] },
+        ]);
+        const goldenState = await harness.getGoldenState();
+        // We should see ROLLING_SUMMARY nodes injected into the graph, proving the async pipeline ran in the background
+        expect(goldenState).toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=lifecycle.golden.test.js.map

package/dist/src/context/system-tests/lifecycle.golden.test.js.map

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

package/dist/src/context/system-tests/simulationHarness.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ContextManager } from '../contextManager.js';
+import { AgentChatHistory } from '../../core/agentChatHistory.js';
+import type { Content } from '@google/genai';
+import type { ContextProfile } from '../config/profiles.js';
+import { ContextEnvironmentImpl } from '../pipeline/environmentImpl.js';
+import { ContextEventBus } from '../eventBus.js';
+import { PipelineOrchestrator } from '../pipeline/orchestrator.js';
+import type { BaseLlmClient } from '../../core/baseLlmClient.js';
+export interface TurnSummary {
+    turnIndex: number;
+    tokensBeforeBackground: number;
+    tokensAfterBackground: number;
+}
+export declare class SimulationHarness {
+    readonly chatHistory: AgentChatHistory;
+    contextManager: ContextManager;
+    env: ContextEnvironmentImpl;
+    orchestrator: PipelineOrchestrator;
+    readonly eventBus: ContextEventBus;
+    config: ContextProfile;
+    private tracer;
+    private currentTurnIndex;
+    private tokenTrajectory;
+    static create(config: ContextProfile, mockLlmClient: BaseLlmClient, mockTempDir?: string): Promise<SimulationHarness>;
+    private constructor();
+    private init;
+    /**
+     * Simulates a single "Turn" (User input + Model/Tool outputs)
+     * A turn might consist of multiple Content messages (e.g. user prompt -> model call -> user response -> model answer)
+     */
+    simulateTurn(messages: Content[]): Promise<void>;
+    getGoldenState(): Promise<{
+        tokenTrajectory: TurnSummary[];
+        finalProjection: Content[];
+    }>;
+}

package/dist/src/context/system-tests/simulationHarness.js

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ContextManager } from '../contextManager.js';
+import { AgentChatHistory } from '../../core/agentChatHistory.js';
+import { ContextEnvironmentImpl } from '../pipeline/environmentImpl.js';
+import { ContextTracer } from '../tracer.js';
+import { ContextEventBus } from '../eventBus.js';
+import { PipelineOrchestrator } from '../pipeline/orchestrator.js';
+import { debugLogger } from '../../utils/debugLogger.js';
+export class SimulationHarness {
+    chatHistory;
+    contextManager;
+    env;
+    orchestrator;
+    eventBus;
+    config;
+    tracer;
+    currentTurnIndex = 0;
+    tokenTrajectory = [];
+    static async create(config, mockLlmClient, mockTempDir = '/tmp/sim') {
+        const harness = new SimulationHarness();
+        await harness.init(config, mockLlmClient, mockTempDir);
+        return harness;
+    }
+    constructor() {
+        this.chatHistory = new AgentChatHistory();
+        this.eventBus = new ContextEventBus();
+    }
+    async init(config, mockLlmClient, mockTempDir) {
+        this.config = config;
+        this.tracer = new ContextTracer({
+            targetDir: mockTempDir,
+            sessionId: 'sim-session',
+        });
+        this.env = new ContextEnvironmentImpl(mockLlmClient, 'sim-prompt', 'sim-session', mockTempDir, mockTempDir, this.tracer, 1, // 1 char per token average
+        this.eventBus);
+        this.orchestrator = new PipelineOrchestrator(config.buildPipelines(this.env), config.buildAsyncPipelines(this.env), this.env, this.eventBus, this.tracer);
+        this.contextManager = new ContextManager(config, this.env, this.tracer, this.orchestrator, this.chatHistory);
+    }
+    /**
+     * Simulates a single "Turn" (User input + Model/Tool outputs)
+     * A turn might consist of multiple Content messages (e.g. user prompt -> model call -> user response -> model answer)
+     */
+    async simulateTurn(messages) {
+        // 1. Append the new messages
+        const currentHistory = this.chatHistory.get();
+        this.chatHistory.set([...currentHistory, ...messages]);
+        // 2. Measure tokens immediately after append (Before background processing)
+        const tokensBefore = this.env.tokenCalculator.calculateConcreteListTokens(this.contextManager.getNodes());
+        debugLogger.log(`[Turn ${this.currentTurnIndex}] Tokens BEFORE: ${tokensBefore}`);
+        // 3. Yield to event loop to allow internal async subscribers and orchestrator to finish
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        // 3.1 Simulate what projectCompressedHistory does with the sync handlers
+        let currentView = this.contextManager.getNodes();
+        const currentTokens = this.env.tokenCalculator.calculateConcreteListTokens(currentView);
+        if (this.config.config.budget &&
+            currentTokens > this.config.config.budget.maxTokens) {
+            debugLogger.log(`[Turn ${this.currentTurnIndex}] Sync panic triggered! ${currentTokens} > ${this.config.config.budget.maxTokens}`);
+            const orchestrator = this.orchestrator;
+            // In the V2 simulation, we trigger the 'gc_backstop' to simulate emergency pressure.
+            // Since contextManager owns its buffer natively, the simulation now properly matches reality
+            // where the manager runs the orchestrator and keeps the resulting modified view.
+            const modifiedView = await orchestrator.executeTriggerSync('gc_backstop', currentView, new Set(currentView.map((e) => e.id)), new Set());
+            // In the real system, ContextManager triggers this and retains it.
+            // We will emulate that behavior internally in the test loop for token counting.
+            currentView = modifiedView;
+        }
+        // 4. Measure tokens after background processors have processed inboxes
+        const tokensAfter = this.env.tokenCalculator.calculateConcreteListTokens(this.contextManager.getNodes());
+        debugLogger.log(`[Turn ${this.currentTurnIndex}] Tokens AFTER: ${tokensAfter}`);
+        this.tokenTrajectory.push({
+            turnIndex: this.currentTurnIndex++,
+            tokensBeforeBackground: tokensBefore,
+            tokensAfterBackground: tokensAfter,
+        });
+    }
+    async getGoldenState() {
+        const finalProjection = await this.contextManager.renderHistory();
+        return {
+            tokenTrajectory: this.tokenTrajectory,
+            finalProjection,
+        };
+    }
+}
+//# sourceMappingURL=simulationHarness.js.map

package/dist/src/context/system-tests/simulationHarness.js.map

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

package/dist/src/context/testing/contextTestUtils.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AgentChatHistory } from '../../core/agentChatHistory.js';
+import { ContextManager } from '../contextManager.js';
+import type { ConcreteNode, ToolExecution } from '../graph/types.js';
+import type { ContextEnvironment } from '../pipeline/environment.js';
+import type { Config } from '../../config/config.js';
+import type { BaseLlmClient } from '../../core/baseLlmClient.js';
+import type { Content, GenerateContentResponse } from '@google/genai';
+import type { InboxMessage, ProcessArgs } from '../pipeline.js';
+import type { ContextProfile } from '../config/profiles.js';
+import type { Mock } from 'vitest';
+/**
+ * Creates a valid mock GenerateContentResponse with the provided text.
+ * Used to avoid having to manually construct the deeply nested candidate/content/part structure.
+ */
+export declare const createMockGenerateContentResponse: (text: string) => GenerateContentResponse;
+export declare function createDummyNode(logicalParentId: string, type: ConcreteNode['type'], tokens?: number, overrides?: Partial<ConcreteNode>, id?: string): ConcreteNode;
+export declare function createDummyToolNode(logicalParentId: string, intentTokens?: number, obsTokens?: number, overrides?: Partial<ToolExecution>, id?: string): ToolExecution;
+export interface MockLlmClient extends BaseLlmClient {
+    generateContent: Mock;
+}
+export declare function createMockLlmClient(responses?: Array<string | GenerateContentResponse>): MockLlmClient;
+export declare function createMockEnvironment(overrides?: Partial<ContextEnvironment>): ContextEnvironment;
+/**
+ * Creates a block of synthetic conversation history designed to consume a specific number of tokens.
+ * Assumes roughly 4 characters per token for standard English text.
+ */
+export declare function createMockProcessArgs(targets: ConcreteNode[], bufferNodes?: ConcreteNode[], inboxMessages?: InboxMessage[]): ProcessArgs;
+export declare function createSyntheticHistory(numTurns: number, tokensPerTurn: number): Content[];
+/**
+ * Creates a fully mocked Config object tailored for Context Component testing.
+ */
+export declare function createMockContextConfig(overrides?: Record<string, unknown>, llmClientOverride?: unknown): Config;
+/**
+ * Wires up a full ContextManager component with an AgentChatHistory and active background async pipelines.
+ */
+export declare function setupContextComponentTest(config: Config, sidecarOverride?: ContextProfile): {
+    chatHistory: AgentChatHistory;
+    contextManager: ContextManager;
+};

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

@@ -0,0 +1,176 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+import { AgentChatHistory } from '../../core/agentChatHistory.js';
+import { ContextManager } from '../contextManager.js';
+import { randomUUID } from 'node:crypto';
+import { ContextTracer } from '../tracer.js';
+import { ContextEnvironmentImpl } from '../pipeline/environmentImpl.js';
+import { ContextEventBus } from '../eventBus.js';
+import { PipelineOrchestrator } from '../pipeline/orchestrator.js';
+import { InboxSnapshotImpl } from '../pipeline/inbox.js';
+import { ContextWorkingBufferImpl } from '../pipeline/contextWorkingBuffer.js';
+import { testTruncateProfile } from './testProfile.js';
+/**
+ * Creates a valid mock GenerateContentResponse with the provided text.
+ * Used to avoid having to manually construct the deeply nested candidate/content/part structure.
+ */
+export const createMockGenerateContentResponse = (text) => 
+// eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+({
+    candidates: [{ content: { role: 'model', parts: [{ text }] }, index: 0 }],
+});
+export function createDummyNode(logicalParentId, type, tokens = 100, overrides, id) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return {
+        id: id || randomUUID(),
+        episodeId: logicalParentId,
+        logicalParentId,
+        type,
+        timestamp: Date.now(),
+        text: `Dummy ${type}`,
+        name: type === 'SYSTEM_EVENT' ? 'dummy_event' : undefined,
+        payload: type === 'SYSTEM_EVENT' ? {} : undefined,
+        semanticParts: [],
+        metadata: {
+            originalTokens: tokens,
+            currentTokens: tokens,
+            transformations: [],
+        },
+        ...overrides,
+    };
+}
+export function createDummyToolNode(logicalParentId, intentTokens = 100, obsTokens = 200, overrides, id) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return {
+        id: id || randomUUID(),
+        episodeId: logicalParentId,
+        logicalParentId,
+        type: 'TOOL_EXECUTION',
+        timestamp: Date.now(),
+        toolName: 'dummy_tool',
+        intent: { action: 'test' },
+        observation: { result: 'ok' },
+        tokens: {
+            intent: intentTokens,
+            observation: obsTokens,
+        },
+        metadata: {
+            originalTokens: intentTokens + obsTokens,
+            currentTokens: intentTokens + obsTokens,
+            transformations: [],
+        },
+        ...overrides,
+    };
+}
+export function createMockLlmClient(responses) {
+    const generateContentMock = vi.fn();
+    if (responses && responses.length > 0) {
+        for (const response of responses) {
+            if (typeof response === 'string') {
+                generateContentMock.mockResolvedValueOnce(createMockGenerateContentResponse(response));
+            }
+            else {
+                generateContentMock.mockResolvedValueOnce(response);
+            }
+        }
+        // Fallback to the last response for any subsequent calls
+        const lastResponse = responses[responses.length - 1];
+        if (typeof lastResponse === 'string') {
+            generateContentMock.mockResolvedValue(createMockGenerateContentResponse(lastResponse));
+        }
+        else {
+            generateContentMock.mockResolvedValue(lastResponse);
+        }
+    }
+    else {
+        // Default fallback
+        generateContentMock.mockResolvedValue(createMockGenerateContentResponse('Mock LLM response'));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return {
+        generateContent: generateContentMock,
+    };
+}
+export function createMockEnvironment(overrides) {
+    const llmClient = createMockLlmClient(['Mock LLM summary response']);
+    const tracer = new ContextTracer({
+        targetDir: '/tmp',
+        sessionId: 'mock-session',
+    });
+    const eventBus = new ContextEventBus();
+    const env = new ContextEnvironmentImpl(llmClient, 'mock-session', 'mock-prompt-id', '/tmp/.cell-cli/trace', '/tmp/.cell-cli/tool-outputs', tracer, 1, eventBus);
+    if (overrides) {
+        Object.assign(env, overrides);
+    }
+    return env;
+}
+/**
+ * Creates a block of synthetic conversation history designed to consume a specific number of tokens.
+ * Assumes roughly 4 characters per token for standard English text.
+ */
+export function createMockProcessArgs(targets, bufferNodes = [], inboxMessages = []) {
+    return {
+        targets,
+        buffer: ContextWorkingBufferImpl.initialize(bufferNodes.length ? bufferNodes : targets),
+        inbox: new InboxSnapshotImpl(inboxMessages),
+    };
+}
+export function createSyntheticHistory(numTurns, tokensPerTurn) {
+    const history = [];
+    const charsPerTurn = tokensPerTurn * 1;
+    for (let i = 0; i < numTurns; i++) {
+        history.push({
+            role: 'user',
+            parts: [{ text: `User turn ${i}. ` + 'A'.repeat(charsPerTurn) }],
+        });
+        history.push({
+            role: 'model',
+            parts: [{ text: `Model response ${i}. ` + 'B'.repeat(charsPerTurn) }],
+        });
+    }
+    return history;
+}
+/**
+ * Creates a fully mocked Config object tailored for Context Component testing.
+ */
+export function createMockContextConfig(overrides, llmClientOverride) {
+    const defaultConfig = {
+        isContextManagementEnabled: vi.fn().mockReturnValue(true),
+        storage: {
+            getProjectTempDir: vi.fn().mockReturnValue('/tmp/gemini-test'),
+        },
+        getBaseLlmClient: vi.fn().mockReturnValue(llmClientOverride || {
+            generateContent: vi.fn().mockResolvedValue({
+                text: '<mocked_snapshot>Synthesized state</mocked_snapshot>',
+            }),
+        }),
+        getUsageStatisticsEnabled: vi.fn().mockReturnValue(false),
+        getTargetDir: vi.fn().mockReturnValue('/tmp'),
+        getSessionId: vi.fn().mockReturnValue('test-session'),
+        getExperimentalContextManagementConfig: vi.fn().mockReturnValue(undefined),
+    };
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    return { ...defaultConfig, ...overrides };
+}
+/**
+ * Wires up a full ContextManager component with an AgentChatHistory and active background async pipelines.
+ */
+export function setupContextComponentTest(config, sidecarOverride) {
+    const chatHistory = new AgentChatHistory();
+    const sidecar = sidecarOverride || testTruncateProfile;
+    const tracer = new ContextTracer({
+        targetDir: '/tmp',
+        sessionId: 'test-session',
+    });
+    const eventBus = new ContextEventBus();
+    const env = new ContextEnvironmentImpl(config.getBaseLlmClient(), 'test prompt-id', 'test-session', '/tmp', '/tmp/gemini-test', tracer, 1, eventBus);
+    const orchestrator = new PipelineOrchestrator(sidecar.buildPipelines(env), sidecar.buildAsyncPipelines(env), env, eventBus, tracer);
+    const contextManager = new ContextManager(sidecar, env, tracer, orchestrator, chatHistory);
+    // The async async pipeline is now internally managed by ContextManager
+    return { chatHistory, contextManager };
+}
+//# sourceMappingURL=contextTestUtils.js.map

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

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

package/dist/src/context/testing/testProfile.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ContextProfile } from '../config/profiles.js';
+export declare const testTruncateProfile: ContextProfile;

package/dist/src/context/testing/testProfile.js

@@ -0,0 +1,20 @@
+import { createHistoryTruncationProcessor } from '../processors/historyTruncationProcessor.js';
+export const testTruncateProfile = {
+    config: {
+        budget: {
+            retainedTokens: 65000,
+            maxTokens: 150000,
+        },
+    },
+    buildPipelines: (env) => [
+        {
+            name: 'Emergency Backstop (Truncate Only)',
+            triggers: ['gc_backstop', 'retained_exceeded'],
+            processors: [
+                createHistoryTruncationProcessor('HistoryTruncation', env, {}),
+            ],
+        },
+    ],
+    buildAsyncPipelines: () => [],
+};
+//# sourceMappingURL=testProfile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testProfile.js","sourceRoot":"","sources":["../../../../src/context/testing/testProfile.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAE/F,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,MAAM,EAAE;QACN,MAAM,EAAE;YACN,cAAc,EAAE,KAAK;YACrB,SAAS,EAAE,MAAM;SAClB;KACF;IACD,cAAc,EAAE,CAAC,GAAuB,EAAiB,EAAE,CAAC;QAC1D;YACE,IAAI,EAAE,oCAAoC;YAC1C,QAAQ,EAAE,CAAC,aAAa,EAAE,mBAAmB,CAAC;YAC9C,UAAU,EAAE;gBACV,gCAAgC,CAAC,mBAAmB,EAAE,GAAG,EAAE,EAAE,CAAC;aAC/D;SACF;KACF;IACD,mBAAmB,EAAE,GAAG,EAAE,CAAC,EAAE;CAC9B,CAAC"}

package/dist/src/context/tracer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface ContextTracerOptions {
+    enabled?: boolean;
+    targetDir: string;
+    sessionId: string;
+}
+export declare class ContextTracer {
+    private traceDir;
+    private assetsDir;
+    private enabled;
+    private readonly MAX_INLINE_SIZE;
+    constructor(options: ContextTracerOptions);
+    logEvent(component: string, action: string, details?: Record<string, unknown>): void;
+    private saveAsset;
+}