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

package/dist/src/context/contextCompressionService.test.js

@@ -0,0 +1,253 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { ContextCompressionService } from './contextCompressionService.js';
+import * as fsSync from 'node:fs';
+vi.mock('node:fs/promises', () => ({
+    readFile: vi.fn(),
+    writeFile: vi.fn(),
+}));
+vi.mock('node:fs', () => ({
+    existsSync: vi.fn(),
+}));
+describe('ContextCompressionService', () => {
+    let mockConfig;
+    let service;
+    const generateContentMock = vi.fn();
+    const generateJsonMock = vi.fn();
+    beforeEach(() => {
+        mockConfig = {
+            storage: {
+                getProjectTempDir: vi.fn().mockReturnValue('/mock/temp/dir'),
+            },
+            isContextManagementEnabled: vi.fn().mockResolvedValue(true),
+            getBaseLlmClient: vi.fn().mockReturnValue({
+                generateContent: generateContentMock,
+                generateJson: generateJsonMock,
+            }),
+        };
+        vi.mocked(fsSync.existsSync).mockReturnValue(false);
+        service = new ContextCompressionService(mockConfig);
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('compressHistory', () => {
+        it('bypasses compression if feature flag is false', async () => {
+            mockConfig.isContextManagementEnabled = vi.fn().mockResolvedValue(false);
+            const history = [{ role: 'user', parts: [{ text: 'hello' }] }];
+            const res = await service.compressHistory(history, 'test prompt');
+            expect(res).toStrictEqual(history);
+        });
+        it('protects files that were read within the RECENT_TURNS_PROTECTED window', async () => {
+            const history = [
+                // Turn 0 & 1 (Old)
+                {
+                    role: 'model',
+                    parts: [
+                        {
+                            functionCall: {
+                                name: 'read_file',
+                                args: { filepath: 'src/app.ts' },
+                            },
+                        },
+                    ],
+                },
+                {
+                    role: 'user',
+                    parts: [
+                        {
+                            functionResponse: {
+                                name: 'read_file',
+                                response: {
+                                    output: '--- src/app.ts ---\nLine 1\nLine 2\nLine 3',
+                                },
+                            },
+                        },
+                    ],
+                },
+                // Padding (Turns 2 & 3)
+                { role: 'model', parts: [{ text: 'res 1' }] },
+                { role: 'user', parts: [{ text: 'res 2' }] },
+                // Padding (Turns 4 & 5)
+                { role: 'model', parts: [{ text: 'res 3' }] },
+                { role: 'user', parts: [{ text: 'res 4' }] },
+                // Recent Turn (Turn 6 & 7, inside window, cutoff is Math.max(0, 8 - 4) = 4)
+                // Here the model explicitly reads the file again
+                {
+                    role: 'model',
+                    parts: [
+                        {
+                            functionCall: {
+                                name: 'read_file',
+                                args: { filepath: 'src/app.ts' },
+                            },
+                        },
+                    ],
+                },
+                {
+                    role: 'user',
+                    parts: [
+                        {
+                            functionResponse: {
+                                name: 'read_file',
+                                response: {
+                                    output: '--- src/app.ts ---\nLine 1\nLine 2\nLine 3',
+                                },
+                            },
+                        },
+                    ],
+                },
+            ];
+            const res = await service.compressHistory(history, 'test prompt');
+            // Because src/app.ts was re-read recently (index 6 is >= 4), the OLD response at index 1 is PROTECTED.
+            // It should NOT be compressed.
+            const compressedOutput = res[1].parts[0].functionResponse.response['output'];
+            expect(compressedOutput).toBe('--- src/app.ts ---\nLine 1\nLine 2\nLine 3');
+            // Verify generateContentMock wasn't called because it bypassed the LLM routing
+            expect(generateContentMock).not.toHaveBeenCalled();
+        });
+        it('compresses files read outside the protected window', async () => {
+            const history = [
+                // Turn 0: The original function call to read the file
+                {
+                    role: 'model',
+                    parts: [
+                        {
+                            functionCall: {
+                                name: 'read_file',
+                                args: { filepath: 'src/old.ts' },
+                            },
+                        },
+                    ],
+                },
+                // Turn 1: The tool output response
+                {
+                    role: 'user',
+                    parts: [
+                        {
+                            functionResponse: {
+                                name: 'read_file',
+                                response: {
+                                    output: '--- src/old.ts ---\nLine 1\nLine 2\nLine 3\nLine 4',
+                                },
+                            },
+                        },
+                    ],
+                },
+                // Padding turns to push it out of the recent window
+                { role: 'model', parts: [{ text: 'msg 2' }] },
+                { role: 'user', parts: [{ text: 'res 2' }] },
+                { role: 'model', parts: [{ text: 'msg 3' }] },
+                { role: 'user', parts: [{ text: 'res 3' }] },
+                { role: 'model', parts: [{ text: 'msg 4' }] },
+                { role: 'user', parts: [{ text: 'res 4' }] },
+            ];
+            // Mock the routing request to return PARTIAL
+            generateJsonMock.mockResolvedValueOnce({
+                'src/old.ts': {
+                    level: 'PARTIAL',
+                    start_line: 2,
+                    end_line: 3,
+                },
+            });
+            const res = await service.compressHistory(history, 'test prompt');
+            const compressedOutput = res[1].parts[0].functionResponse.response['output'];
+            expect(compressedOutput).toContain('[Showing lines 2–3 of 4 in old.ts.');
+            expect(compressedOutput).toContain('2 | Line 2');
+            expect(compressedOutput).toContain('3 | Line 3');
+        });
+        it('returns SUMMARY and hits cache on subsequent requests', async () => {
+            const history1 = [
+                {
+                    role: 'model',
+                    parts: [
+                        {
+                            functionCall: {
+                                name: 'read_file',
+                                args: { filepath: 'src/index.ts' },
+                            },
+                        },
+                    ],
+                },
+                {
+                    role: 'user',
+                    parts: [
+                        {
+                            functionResponse: {
+                                name: 'read_file',
+                                response: {
+                                    output: `--- src/index.ts ---\nVery long content here...`,
+                                },
+                            },
+                        },
+                    ],
+                },
+                { role: 'model', parts: [{ text: 'p1' }] },
+                { role: 'user', parts: [{ text: 'p2' }] },
+                { role: 'model', parts: [{ text: 'p3' }] },
+                { role: 'user', parts: [{ text: 'p4' }] },
+                { role: 'model', parts: [{ text: 'p5' }] },
+                { role: 'user', parts: [{ text: 'p6' }] },
+            ];
+            // 1st request: routing says SUMMARY
+            generateJsonMock.mockResolvedValueOnce({
+                'src/index.ts': { level: 'SUMMARY' },
+            });
+            // 2nd request: the actual summarization call
+            generateContentMock.mockResolvedValueOnce({
+                candidates: [
+                    { content: { parts: [{ text: 'This is a cached summary.' }] } },
+                ],
+            });
+            await service.compressHistory(history1, 'test query');
+            expect(generateJsonMock).toHaveBeenCalledTimes(1);
+            expect(generateContentMock).toHaveBeenCalledTimes(1);
+            // Time passes, we get a new query. The file is still old.
+            const history2 = [
+                ...history1,
+                { role: 'model', parts: [{ text: 'p7' }] },
+                { role: 'user', parts: [{ text: 'p8' }] },
+            ];
+            // 3rd request: routing says SUMMARY again.
+            generateJsonMock.mockResolvedValueOnce({
+                'src/index.ts': { level: 'SUMMARY' },
+            });
+            const res = await service.compressHistory(history2, 'new query');
+            // It should NOT make a 3rd fetch call for routing, since content has not changed and state is cached.
+            expect(generateJsonMock).toHaveBeenCalledTimes(1);
+            expect(generateContentMock).toHaveBeenCalledTimes(1);
+            const compressedOutput = res[1].parts[0].functionResponse.response['output'];
+            expect(compressedOutput).toContain('This is a cached summary.');
+        });
+        it('returns unmodified history if structural validation fails', async () => {
+            // Creating a broken history where functionCall is NOT followed by user functionResponse
+            const brokenHistory = [
+                {
+                    role: 'model',
+                    parts: [
+                        {
+                            functionCall: {
+                                name: 'read_file',
+                                args: { filepath: 'src/index.ts' },
+                            },
+                        },
+                    ],
+                },
+                // Missing user functionResponse!
+                { role: 'model', parts: [{ text: 'Wait, I am a model again.' }] },
+                { role: 'user', parts: [{ text: 'This is invalid.' }] },
+                { role: 'model', parts: [{ text: 'Yep.' }] },
+                { role: 'user', parts: [{ text: 'Padding.' }] },
+                { role: 'model', parts: [{ text: 'Padding.' }] },
+            ];
+            const res = await service.compressHistory(brokenHistory, 'test query');
+            // Because it's broken, it should return the exact same array by reference.
+            expect(res).toBe(brokenHistory);
+        });
+    });
+});
+//# sourceMappingURL=contextCompressionService.test.js.map

package/dist/src/context/contextCompressionService.test.js.map

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

package/dist/src/{services/contextManager.d.ts → context/memoryContextManager.d.ts}

@@ -4,13 +4,14 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Config } from '../config/config.js';
-export declare class ContextManager {
+export declare class MemoryContextManager {
     private readonly loadedPaths;
     private readonly loadedFileIdentities;
     private readonly config;
     private globalMemory;
     private extensionMemory;
     private projectMemory;
+    private userProjectMemoryContent;
     constructor(config: Config);
     /**
      * Refreshes the memory by reloading global, extension, and project memory.
@@ -28,6 +29,7 @@ export declare class ContextManager {
     getGlobalMemory(): string;
     getExtensionMemory(): string;
     getEnvironmentMemory(): string;
+    getUserProjectMemory(): string;
     private markAsLoaded;
     getLoadedPaths(): ReadonlySet<string>;
 }

package/dist/src/{services/contextManager.js → context/memoryContextManager.js}

@@ -3,15 +3,16 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { loadJitSubdirectoryMemory, concatenateInstructions, getGlobalMemoryPaths, getExtensionMemoryPaths, getEnvironmentMemoryPaths, readGeminiMdFiles, categorizeAndConcatenate, deduplicatePathsByFileIdentity, } from '../utils/memoryDiscovery.js';
+import { loadJitSubdirectoryMemory, concatenateInstructions, getGlobalMemoryPaths, getUserProjectMemoryPaths, getExtensionMemoryPaths, getEnvironmentMemoryPaths, readGeminiMdFiles, categorizeAndConcatenate, deduplicatePathsByFileIdentity, } from '../utils/memoryDiscovery.js';
 import { coreEvents, CoreEvent } from '../utils/events.js';
-export class ContextManager {
+export class MemoryContextManager {
     loadedPaths = new Set();
     loadedFileIdentities = new Set();
     config;
     globalMemory = '';
     extensionMemory = '';
     projectMemory = '';
+    userProjectMemoryContent = '';
     constructor(config) {
         this.config = config;
     }
@@ -27,22 +28,26 @@ export class ContextManager {
         this.emitMemoryChanged();
     }
     async discoverMemoryPaths() {
-        const [global, extension, project] = await Promise.all([
+        const [global, extension, project, userProjectMemory] = await Promise.all([
             getGlobalMemoryPaths(),
             Promise.resolve(getExtensionMemoryPaths(this.config.getExtensionLoader())),
             this.config.isTrustedFolder()
-                ? getEnvironmentMemoryPaths([
-                    ...this.config.getWorkspaceContext().getDirectories(),
-                ])
+                ? getEnvironmentMemoryPaths([...this.config.getWorkspaceContext().getDirectories()], this.config.getMemoryBoundaryMarkers())
                 : Promise.resolve([]),
+            getUserProjectMemoryPaths(this.config.storage.getProjectMemoryDir()),
         ]);
-        return { global, extension, project };
+        return { global, extension, project, userProjectMemory };
     }
     async loadMemoryContents(paths) {
-        const allPathsStringDeduped = Array.from(new Set([...paths.global, ...paths.extension, ...paths.project]));
+        const allPathsStringDeduped = Array.from(new Set([
+            ...paths.global,
+            ...paths.extension,
+            ...paths.project,
+            ...paths.userProjectMemory,
+        ]));
         // deduplicate by file identity to handle case-insensitive filesystems
         const { paths: allPaths, identityMap: pathIdentityMap } = await deduplicatePathsByFileIdentity(allPathsStringDeduped);
-        const allContents = await readGeminiMdFiles(allPaths, this.config.getImportFormat());
+        const allContents = await readGeminiMdFiles(allPaths, this.config.getImportFormat(), this.config.getMemoryBoundaryMarkers());
         const loadedFilePaths = allContents
             .filter((c) => c.content !== null)
             .map((c) => c.filePath);
@@ -60,6 +65,7 @@ export class ContextManager {
         const hierarchicalMemory = categorizeAndConcatenate(paths, contentsMap);
         this.globalMemory = hierarchicalMemory.global || '';
         this.extensionMemory = hierarchicalMemory.extension || '';
+        this.userProjectMemoryContent = hierarchicalMemory.userProjectMemory || '';
         const mcpInstructions = this.config.getMcpClientManager()?.getMcpInstructions() || '';
         const projectMemoryWithMcp = [
             hierarchicalMemory.project,
@@ -79,7 +85,7 @@ export class ContextManager {
         if (!this.config.isTrustedFolder()) {
             return '';
         }
-        const result = await loadJitSubdirectoryMemory(accessedPath, trustedRoots, this.loadedPaths, this.loadedFileIdentities);
+        const result = await loadJitSubdirectoryMemory(accessedPath, trustedRoots, this.loadedPaths, this.loadedFileIdentities, this.config.getMemoryBoundaryMarkers());
         if (result.files.length === 0) {
             return '';
         }
@@ -107,6 +113,9 @@ export class ContextManager {
     getEnvironmentMemory() {
         return this.projectMemory;
     }
+    getUserProjectMemory() {
+        return this.userProjectMemoryContent;
+    }
     markAsLoaded(paths) {
         paths.forEach((p) => this.loadedPaths.add(p));
     }
@@ -114,4 +123,4 @@ export class ContextManager {
         return this.loadedPaths;
     }
 }
-//# sourceMappingURL=contextManager.js.map
+//# sourceMappingURL=memoryContextManager.js.map

package/dist/src/context/memoryContextManager.js.map

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

package/dist/src/{services/contextManager.test.js → context/memoryContextManager.test.js}

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { ContextManager } from './contextManager.js';
+import { MemoryContextManager } from './memoryContextManager.js';
 import * as memoryDiscovery from '../utils/memoryDiscovery.js';
 import { coreEvents, CoreEvent } from '../utils/events.js';
 // Mock memoryDiscovery module
@@ -13,6 +13,7 @@ vi.mock('../utils/memoryDiscovery.js', async (importOriginal) => {
     return {
         ...actual,
         getGlobalMemoryPaths: vi.fn(),
+        getUserProjectMemoryPaths: vi.fn(),
         getExtensionMemoryPaths: vi.fn(),
         getEnvironmentMemoryPaths: vi.fn(),
         readGeminiMdFiles: vi.fn(),
@@ -23,8 +24,8 @@ vi.mock('../utils/memoryDiscovery.js', async (importOriginal) => {
             .mockImplementation(actual.concatenateInstructions),
     };
 });
-describe('ContextManager', () => {
-    let contextManager;
+describe('MemoryContextManager', () => {
+    let memoryContextManager;
     let mockConfig;
     beforeEach(() => {
         mockConfig = {
@@ -40,11 +41,18 @@ describe('ContextManager', () => {
                 getMcpInstructions: vi.fn().mockReturnValue('MCP Instructions'),
             }),
             isTrustedFolder: vi.fn().mockReturnValue(true),
+            getMemoryBoundaryMarkers: vi.fn().mockReturnValue(['.git']),
+            storage: {
+                getProjectMemoryDir: vi
+                    .fn()
+                    .mockReturnValue('/home/user/.cell-cli/memory/test-project'),
+            },
         };
-        contextManager = new ContextManager(mockConfig);
+        memoryContextManager = new MemoryContextManager(mockConfig);
         vi.clearAllMocks();
         vi.spyOn(coreEvents, 'emit');
         vi.mocked(memoryDiscovery.getExtensionMemoryPaths).mockReturnValue([]);
+        vi.mocked(memoryDiscovery.getUserProjectMemoryPaths).mockResolvedValue([]);
         // default mock: deduplication returns paths as-is (no deduplication)
         vi.mocked(memoryDiscovery.deduplicatePathsByFileIdentity).mockImplementation(async (paths) => ({
             paths,
@@ -61,17 +69,15 @@ describe('ContextManager', () => {
                 { filePath: globalPaths[0], content: 'Global Content' },
                 { filePath: envPaths[0], content: 'Env Content' },
             ]);
-            await contextManager.refresh();
+            await memoryContextManager.refresh();
             expect(memoryDiscovery.getGlobalMemoryPaths).toHaveBeenCalled();
-            expect(memoryDiscovery.getEnvironmentMemoryPaths).toHaveBeenCalledWith([
-                '/app',
-            ]);
-            expect(memoryDiscovery.readGeminiMdFiles).toHaveBeenCalledWith(expect.arrayContaining([...globalPaths, ...envPaths]), 'tree');
-            expect(contextManager.getGlobalMemory()).toContain('Global Content');
-            expect(contextManager.getEnvironmentMemory()).toContain('Env Content');
-            expect(contextManager.getEnvironmentMemory()).toContain('MCP Instructions');
-            expect(contextManager.getLoadedPaths()).toContain(globalPaths[0]);
-            expect(contextManager.getLoadedPaths()).toContain(envPaths[0]);
+            expect(memoryDiscovery.getEnvironmentMemoryPaths).toHaveBeenCalledWith(['/app'], ['.git']);
+            expect(memoryDiscovery.readGeminiMdFiles).toHaveBeenCalledWith(expect.arrayContaining([...globalPaths, ...envPaths]), 'tree', ['.git']);
+            expect(memoryContextManager.getGlobalMemory()).toContain('Global Content');
+            expect(memoryContextManager.getEnvironmentMemory()).toContain('Env Content');
+            expect(memoryContextManager.getEnvironmentMemory()).toContain('MCP Instructions');
+            expect(memoryContextManager.getLoadedPaths()).toContain(globalPaths[0]);
+            expect(memoryContextManager.getLoadedPaths()).toContain(envPaths[0]);
         });
         it('should emit MemoryChanged event when memory is refreshed', async () => {
             vi.mocked(memoryDiscovery.getGlobalMemoryPaths).mockResolvedValue([
@@ -84,7 +90,7 @@ describe('ContextManager', () => {
                 { filePath: '/app/GEMINI.md', content: 'content' },
                 { filePath: '/app/src/GEMINI.md', content: 'env content' },
             ]);
-            await contextManager.refresh();
+            await memoryContextManager.refresh();
             expect(coreEvents.emit).toHaveBeenCalledWith(CoreEvent.MemoryChanged, {
                 fileCount: 2,
             });
@@ -100,10 +106,10 @@ describe('ContextManager', () => {
                     content: 'Global Content',
                 },
             ]);
-            await contextManager.refresh();
+            await memoryContextManager.refresh();
             expect(memoryDiscovery.getEnvironmentMemoryPaths).not.toHaveBeenCalled();
-            expect(contextManager.getEnvironmentMemory()).toBe('');
-            expect(contextManager.getGlobalMemory()).toContain('Global Content');
+            expect(memoryContextManager.getEnvironmentMemory()).toBe('');
+            expect(memoryContextManager.getGlobalMemory()).toContain('Global Content');
         });
         it('should deduplicate files by file identity in case-insensitive filesystems', async () => {
             const globalPaths = ['/home/user/.cell-cli/GEMINI.md'];
@@ -122,14 +128,14 @@ describe('ContextManager', () => {
                 },
                 { filePath: '/app/gemini.md', content: 'Project Content' },
             ]);
-            await contextManager.refresh();
+            await memoryContextManager.refresh();
             expect(memoryDiscovery.deduplicatePathsByFileIdentity).toHaveBeenCalledWith(expect.arrayContaining([
                 '/home/user/.cell-cli/GEMINI.md',
                 '/app/gemini.md',
                 '/app/GEMINI.md',
             ]));
-            expect(memoryDiscovery.readGeminiMdFiles).toHaveBeenCalledWith(['/home/user/.cell-cli/GEMINI.md', '/app/gemini.md'], 'tree');
-            expect(contextManager.getEnvironmentMemory()).toContain('Project Content');
+            expect(memoryDiscovery.readGeminiMdFiles).toHaveBeenCalledWith(['/home/user/.cell-cli/GEMINI.md', '/app/gemini.md'], 'tree', ['.git']);
+            expect(memoryContextManager.getEnvironmentMemory()).toContain('Project Content');
         });
     });
     describe('discoverContext', () => {
@@ -138,30 +144,33 @@ describe('ContextManager', () => {
                 files: [{ path: '/app/src/GEMINI.md', content: 'Src Content' }],
             };
             vi.mocked(memoryDiscovery.loadJitSubdirectoryMemory).mockResolvedValue(mockResult);
-            const result = await contextManager.discoverContext('/app/src/file.ts', [
-                '/app',
-            ]);
-            expect(memoryDiscovery.loadJitSubdirectoryMemory).toHaveBeenCalledWith('/app/src/file.ts', ['/app'], expect.any(Set), expect.any(Set));
+            const result = await memoryContextManager.discoverContext('/app/src/file.ts', ['/app']);
+            expect(memoryDiscovery.loadJitSubdirectoryMemory).toHaveBeenCalledWith('/app/src/file.ts', ['/app'], expect.any(Set), expect.any(Set), ['.git']);
             expect(result).toMatch(/--- Context from: \/app\/src\/GEMINI\.md ---/);
             expect(result).toContain('Src Content');
-            expect(contextManager.getLoadedPaths()).toContain('/app/src/GEMINI.md');
+            expect(memoryContextManager.getLoadedPaths()).toContain('/app/src/GEMINI.md');
         });
         it('should return empty string if no new files found', async () => {
             const mockResult = { files: [] };
             vi.mocked(memoryDiscovery.loadJitSubdirectoryMemory).mockResolvedValue(mockResult);
-            const result = await contextManager.discoverContext('/app/src/file.ts', [
-                '/app',
-            ]);
+            const result = await memoryContextManager.discoverContext('/app/src/file.ts', ['/app']);
             expect(result).toBe('');
         });
         it('should return empty string if folder is not trusted', async () => {
             vi.mocked(mockConfig.isTrustedFolder).mockReturnValue(false);
-            const result = await contextManager.discoverContext('/app/src/file.ts', [
-                '/app',
-            ]);
+            const result = await memoryContextManager.discoverContext('/app/src/file.ts', ['/app']);
             expect(memoryDiscovery.loadJitSubdirectoryMemory).not.toHaveBeenCalled();
             expect(result).toBe('');
         });
+        it('should pass custom boundary markers from config', async () => {
+            const customMarkers = ['.monorepo-root', 'package.json'];
+            vi.mocked(mockConfig.getMemoryBoundaryMarkers).mockReturnValue(customMarkers);
+            vi.mocked(memoryDiscovery.loadJitSubdirectoryMemory).mockResolvedValue({
+                files: [],
+            });
+            await memoryContextManager.discoverContext('/app/src/file.ts', ['/app']);
+            expect(memoryDiscovery.loadJitSubdirectoryMemory).toHaveBeenCalledWith('/app/src/file.ts', ['/app'], expect.any(Set), expect.any(Set), customMarkers);
+        });
     });
 });
-//# sourceMappingURL=contextManager.test.js.map
+//# sourceMappingURL=memoryContextManager.test.js.map

package/dist/src/context/memoryContextManager.test.js.map

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

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

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

package/dist/src/context/profiles.js

@@ -0,0 +1,21 @@
+export const generalistProfile = {
+    enabled: true,
+    historyWindow: { maxTokens: 150_000, retainedTokens: 80_000 },
+    messageLimits: {
+        normalMaxTokens: 3_000,
+        retainedMaxTokens: 30_000,
+        normalizationHeadRatio: 0.15,
+    },
+    tools: {
+        distillation: {
+            maxOutputTokens: 10_000,
+            summarizationThresholdTokens: 20_000,
+        },
+        outputMasking: {
+            protectionThresholdTokens: 50_000,
+            minPrunableThresholdTokens: 30_000,
+            protectLatestTurn: true,
+        },
+    },
+};
+//# sourceMappingURL=profiles.js.map

package/dist/src/context/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../../src/context/profiles.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,iBAAiB,GAA4B;IACxD,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE;IAC7D,aAAa,EAAE;QACb,eAAe,EAAE,KAAK;QACtB,iBAAiB,EAAE,MAAM;QACzB,sBAAsB,EAAE,IAAI;KAC7B;IACD,KAAK,EAAE;QACL,YAAY,EAAE;YACZ,eAAe,EAAE,MAAM;YACvB,4BAA4B,EAAE,MAAM;SACrC;QACD,aAAa,EAAE;YACb,yBAAyB,EAAE,MAAM;YACjC,0BAA0B,EAAE,MAAM;YAClC,iBAAiB,EAAE,IAAI;SACxB;KACF;CACF,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Config } from '../index.js';
+import type { PartListUnion } from '@google/genai';
+import { type GeminiClient } from '../core/client.js';
+export interface DistilledToolOutput {
+    truncatedContent: PartListUnion;
+    outputFile?: string;
+}
+export declare class ToolOutputDistillationService {
+    private readonly config;
+    private readonly geminiClient;
+    private readonly promptId;
+    constructor(config: Config, geminiClient: GeminiClient, promptId: string);
+    /**
+     * Distills a tool's output if it exceeds configured length thresholds, preserving
+     * the agent's context window. This includes saving the raw output to disk, replacing
+     * the output with a truncated placeholder, and optionally summarizing the output
+     * via a secondary LLM call if the output is massively oversized.
+     */
+    distill(toolName: string, callId: string, content: PartListUnion): Promise<DistilledToolOutput>;
+    private isExemptFromDistillation;
+    private calculateContentLength;
+    private stringifyContent;
+    private performDistillation;
+    /**
+     * Truncates content while maintaining its Part structure.
+     */
+    private truncateContentStructurally;
+    /**
+     * Calls the secondary model to distill the strategic "why" signals and intent
+     * of the truncated content before it is offloaded.
+     */
+    private generateIntentSummary;
+}