@machina.ai/cell-cli-core 1.20.2-rc1 → 1.25.0-rc1

package/dist/src/commands/init.js

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function performInit(doesGeminiMdExist) {
+    if (doesGeminiMdExist) {
+        return {
+            type: 'message',
+            messageType: 'info',
+            content: 'A GEMINI.md file already exists in this directory. No changes were made.',
+        };
+    }
+    return {
+        type: 'submit_prompt',
+        content: `
+You are an AI agent that brings the power of Gemini directly into the terminal. Your task is to analyze the current directory and generate a comprehensive GEMINI.md file to be used as instructional context for future interactions.
+
+**Analysis Process:**
+
+1.  **Initial Exploration:**
+    *   Start by listing the files and directories to get a high-level overview of the structure.
+    *   Read the README file (e.g., \`README.md\`, \`README.txt\`) if it exists. This is often the best place to start.
+
+2.  **Iterative Deep Dive (up to 10 files):**
+    *   Based on your initial findings, select a few files that seem most important (e.g., configuration files, main source files, documentation).
+    *   Read them. As you learn more, refine your understanding and decide which files to read next. You don't need to decide all 10 files at once. Let your discoveries guide your exploration.
+
+3.  **Identify Project Type:**
+    *   **Code Project:** Look for clues like \`package.json\`, \`requirements.txt\`, \`pom.xml\`, \`go.mod\`, \`Cargo.toml\`, \`build.gradle\`, or a \`src\` directory. If you find them, this is likely a software project.
+    *   **Non-Code Project:** If you don't find code-related files, this might be a directory for documentation, research papers, notes, or something else.
+
+**GEMINI.md Content Generation:**
+
+**For a Code Project:**
+
+*   **Project Overview:** Write a clear and concise summary of the project's purpose, main technologies, and architecture.
+*   **Building and Running:** Document the key commands for building, running, and testing the project. Infer these from the files you've read (e.g., \`scripts\` in \`package.json\`, \`Makefile\`, etc.). If you can't find explicit commands, provide a placeholder with a TODO.
+*   **Development Conventions:** Describe any coding styles, testing practices, or contribution guidelines you can infer from the codebase.
+
+**For a Non-Code Project:**
+
+*   **Directory Overview:** Describe the purpose and contents of the directory. What is it for? What kind of information does it hold?
+*   **Key Files:** List the most important files and briefly explain what they contain.
+*   **Usage:** Explain how the contents of this directory are intended to be used.
+
+**Final Output:**
+
+Write the complete content to the \`GEMINI.md\` file. The output must be well-formatted Markdown.
+`,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/src/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,WAAW,CAAC,iBAA0B;IACpD,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,MAAM;YACnB,OAAO,EACL,0EAA0E;SAC7E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCZ;KACE,CAAC;AACJ,CAAC"}

package/dist/src/commands/init.test.d.ts

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

package/dist/src/commands/init.test.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { expect, describe, it } from 'vitest';
+import { performInit } from './init.js';
+describe('performInit', () => {
+    it('returns info if GEMINI.md already exists', () => {
+        const result = performInit(true);
+        expect(result.type).toBe('message');
+        if (result.type === 'message') {
+            expect(result.messageType).toBe('info');
+            expect(result.content).toContain('already exists');
+        }
+    });
+    it('returns submit_prompt if GEMINI.md does not exist', () => {
+        const result = performInit(false);
+        expect(result.type).toBe('submit_prompt');
+        if (result.type === 'submit_prompt') {
+            expect(result.content).toContain('You are an AI agent');
+        }
+    });
+});
+//# sourceMappingURL=init.test.js.map

package/dist/src/commands/init.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.test.js","sourceRoot":"","sources":["../../../src/commands/init.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAEjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAE1C,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/commands/memory.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { MessageActionReturn, ToolActionReturn } from './types.js';
+export declare function showMemory(config: Config): MessageActionReturn;
+export declare function addMemory(args?: string): MessageActionReturn | ToolActionReturn;
+export declare function refreshMemory(config: Config): Promise<MessageActionReturn>;
+export declare function listMemoryFiles(config: Config): MessageActionReturn;

package/dist/src/commands/memory.js

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { refreshServerHierarchicalMemory } from '../utils/memoryDiscovery.js';
+export function showMemory(config) {
+    const memoryContent = config.getUserMemory() || '';
+    const fileCount = config.getGeminiMdFileCount() || 0;
+    let content;
+    if (memoryContent.length > 0) {
+        content = `Current memory content from ${fileCount} file(s):\n\n---\n${memoryContent}\n---`;
+    }
+    else {
+        content = 'Memory is currently empty.';
+    }
+    return {
+        type: 'message',
+        messageType: 'info',
+        content,
+    };
+}
+export function addMemory(args) {
+    if (!args || args.trim() === '') {
+        return {
+            type: 'message',
+            messageType: 'error',
+            content: 'Usage: /memory add <text to remember>',
+        };
+    }
+    return {
+        type: 'tool',
+        toolName: 'save_memory',
+        toolArgs: { fact: args.trim() },
+    };
+}
+export async function refreshMemory(config) {
+    let memoryContent = '';
+    let fileCount = 0;
+    if (config.isJitContextEnabled()) {
+        await config.getContextManager()?.refresh();
+        memoryContent = config.getUserMemory();
+        fileCount = config.getGeminiMdFileCount();
+    }
+    else {
+        const result = await refreshServerHierarchicalMemory(config);
+        memoryContent = result.memoryContent;
+        fileCount = result.fileCount;
+    }
+    await config.updateSystemInstructionIfInitialized();
+    let content;
+    if (memoryContent.length > 0) {
+        content = `Memory refreshed successfully. Loaded ${memoryContent.length} characters from ${fileCount} file(s).`;
+    }
+    else {
+        content = 'Memory refreshed successfully. No memory content found.';
+    }
+    return {
+        type: 'message',
+        messageType: 'info',
+        content,
+    };
+}
+export function listMemoryFiles(config) {
+    const filePaths = config.getGeminiMdFilePaths() || [];
+    const fileCount = filePaths.length;
+    let content;
+    if (fileCount > 0) {
+        content = `There are ${fileCount} GEMINI.md file(s) in use:\n\n${filePaths.join('\n')}`;
+    }
+    else {
+        content = 'No GEMINI.md files in use.';
+    }
+    return {
+        type: 'message',
+        messageType: 'info',
+        content,
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/commands/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/commands/memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAG9E,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACrD,IAAI,OAAe,CAAC;IAEpB,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,+BAA+B,SAAS,qBAAqB,aAAa,OAAO,CAAC;IAC9F,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,4BAA4B,CAAC;IACzC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,MAAM;QACnB,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,IAAa;IAEb,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,OAAO;YACpB,OAAO,EAAE,uCAAuC;SACjD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc;IAEd,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,IAAI,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;QACjC,MAAM,MAAM,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC;QAC5C,aAAa,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QACvC,SAAS,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,MAAM,+BAA+B,CAAC,MAAM,CAAC,CAAC;QAC7D,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;QACrC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,CAAC,oCAAoC,EAAE,CAAC;IACpD,IAAI,OAAe,CAAC;IAEpB,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,GAAG,yCAAyC,aAAa,CAAC,MAAM,oBAAoB,SAAS,WAAW,CAAC;IAClH,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,yDAAyD,CAAC;IACtE,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,MAAM;QACnB,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACtD,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC;IACnC,IAAI,OAAe,CAAC;IAEpB,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,GAAG,aAAa,SAAS,iCAAiC,SAAS,CAAC,IAAI,CAC7E,IAAI,CACL,EAAE,CAAC;IACN,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,4BAA4B,CAAC;IACzC,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,MAAM;QACnB,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/src/commands/memory.test.d.ts

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

package/dist/src/commands/memory.test.js

@@ -0,0 +1,155 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { addMemory, listMemoryFiles, refreshMemory, showMemory, } from './memory.js';
+import * as memoryDiscovery from '../utils/memoryDiscovery.js';
+vi.mock('../utils/memoryDiscovery.js', () => ({
+    refreshServerHierarchicalMemory: vi.fn(),
+}));
+const mockRefresh = vi.mocked(memoryDiscovery.refreshServerHierarchicalMemory);
+describe('memory commands', () => {
+    let mockConfig;
+    beforeEach(() => {
+        mockConfig = {
+            getUserMemory: vi.fn(),
+            getGeminiMdFileCount: vi.fn(),
+            getGeminiMdFilePaths: vi.fn(),
+            isJitContextEnabled: vi.fn(),
+            updateSystemInstructionIfInitialized: vi
+                .fn()
+                .mockResolvedValue(undefined),
+        };
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('showMemory', () => {
+        it('should show memory content if it exists', () => {
+            vi.mocked(mockConfig.getUserMemory).mockReturnValue('some memory content');
+            vi.mocked(mockConfig.getGeminiMdFileCount).mockReturnValue(1);
+            const result = showMemory(mockConfig);
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('info');
+                expect(result.content).toContain('Current memory content from 1 file(s)');
+                expect(result.content).toContain('some memory content');
+            }
+        });
+        it('should show a message if memory is empty', () => {
+            vi.mocked(mockConfig.getUserMemory).mockReturnValue('');
+            vi.mocked(mockConfig.getGeminiMdFileCount).mockReturnValue(0);
+            const result = showMemory(mockConfig);
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('info');
+                expect(result.content).toBe('Memory is currently empty.');
+            }
+        });
+    });
+    describe('addMemory', () => {
+        it('should return a tool action to save memory', () => {
+            const result = addMemory('new memory');
+            expect(result.type).toBe('tool');
+            if (result.type === 'tool') {
+                expect(result.toolName).toBe('save_memory');
+                expect(result.toolArgs).toEqual({ fact: 'new memory' });
+            }
+        });
+        it('should trim the arguments', () => {
+            const result = addMemory('  new memory  ');
+            expect(result.type).toBe('tool');
+            if (result.type === 'tool') {
+                expect(result.toolArgs).toEqual({ fact: 'new memory' });
+            }
+        });
+        it('should return an error if args are empty', () => {
+            const result = addMemory('');
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('error');
+                expect(result.content).toBe('Usage: /memory add <text to remember>');
+            }
+        });
+        it('should return an error if args are just whitespace', () => {
+            const result = addMemory('   ');
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('error');
+                expect(result.content).toBe('Usage: /memory add <text to remember>');
+            }
+        });
+        it('should return an error if args are undefined', () => {
+            const result = addMemory(undefined);
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('error');
+                expect(result.content).toBe('Usage: /memory add <text to remember>');
+            }
+        });
+    });
+    describe('refreshMemory', () => {
+        it('should refresh memory and show success message', async () => {
+            mockRefresh.mockResolvedValue({
+                memoryContent: 'refreshed content',
+                fileCount: 2,
+                filePaths: [],
+            });
+            const result = await refreshMemory(mockConfig);
+            expect(mockRefresh).toHaveBeenCalledWith(mockConfig);
+            expect(mockConfig.updateSystemInstructionIfInitialized).toHaveBeenCalled();
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('info');
+                expect(result.content).toBe('Memory refreshed successfully. Loaded 17 characters from 2 file(s).');
+            }
+        });
+        it('should show a message if no memory content is found after refresh', async () => {
+            mockRefresh.mockResolvedValue({
+                memoryContent: '',
+                fileCount: 0,
+                filePaths: [],
+            });
+            const result = await refreshMemory(mockConfig);
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('info');
+                expect(result.content).toBe('Memory refreshed successfully. No memory content found.');
+            }
+        });
+    });
+    describe('listMemoryFiles', () => {
+        it('should list the memory files in use', () => {
+            const filePaths = ['/path/to/GEMINI.md', '/other/path/GEMINI.md'];
+            vi.mocked(mockConfig.getGeminiMdFilePaths).mockReturnValue(filePaths);
+            const result = listMemoryFiles(mockConfig);
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('info');
+                expect(result.content).toContain('There are 2 GEMINI.md file(s) in use:');
+                expect(result.content).toContain(filePaths.join('\n'));
+            }
+        });
+        it('should show a message if no memory files are in use', () => {
+            vi.mocked(mockConfig.getGeminiMdFilePaths).mockReturnValue([]);
+            const result = listMemoryFiles(mockConfig);
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('info');
+                expect(result.content).toBe('No GEMINI.md files in use.');
+            }
+        });
+        it('should show a message if file paths are undefined', () => {
+            vi.mocked(mockConfig.getGeminiMdFilePaths).mockReturnValue(undefined);
+            const result = listMemoryFiles(mockConfig);
+            expect(result.type).toBe('message');
+            if (result.type === 'message') {
+                expect(result.messageType).toBe('info');
+                expect(result.content).toBe('No GEMINI.md files in use.');
+            }
+        });
+    });
+});
+//# sourceMappingURL=memory.test.js.map

package/dist/src/commands/memory.test.js.map

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

package/dist/src/commands/restore.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GitService } from '../services/gitService.js';
+import type { CommandActionReturn } from './types.js';
+import { type ToolCallData } from '../utils/checkpointUtils.js';
+export declare function performRestore<HistoryType = unknown, ArgsType = unknown>(toolCallData: ToolCallData<HistoryType, ArgsType>, gitService: GitService | undefined): AsyncGenerator<CommandActionReturn<HistoryType>>;

package/dist/src/commands/restore.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {} from '../utils/checkpointUtils.js';
+export async function* performRestore(toolCallData, gitService) {
+    if (toolCallData.history && toolCallData.clientHistory) {
+        yield {
+            type: 'load_history',
+            history: toolCallData.history,
+            clientHistory: toolCallData.clientHistory,
+        };
+    }
+    if (toolCallData.commitHash) {
+        if (!gitService) {
+            yield {
+                type: 'message',
+                messageType: 'error',
+                content: 'Git service is not available, cannot restore checkpoint. Please ensure you are in a git repository.',
+            };
+            return;
+        }
+        try {
+            await gitService.restoreProjectFromSnapshot(toolCallData.commitHash);
+            yield {
+                type: 'message',
+                messageType: 'info',
+                content: 'Restored project to the state before the tool call.',
+            };
+        }
+        catch (e) {
+            const error = e;
+            if (error.message.includes('unable to read tree')) {
+                yield {
+                    type: 'message',
+                    messageType: 'error',
+                    content: `The commit hash '${toolCallData.commitHash}' associated with this checkpoint could not be found in your Git repository. This can happen if the repository has been re-cloned, reset, or if old commits have been garbage collected. This checkpoint cannot be restored.`,
+                };
+                return;
+            }
+            throw e;
+        }
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/src/commands/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/commands/restore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAqB,MAAM,6BAA6B,CAAC;AAEhE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CAInC,YAAiD,EACjD,UAAkC;IAElC,IAAI,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;QACvD,MAAM;YACJ,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,aAAa,EAAE,YAAY,CAAC,aAAa;SAC1C,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,OAAO;gBACpB,OAAO,EACL,qGAAqG;aACxG,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,0BAA0B,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACrE,MAAM;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,MAAM;gBACnB,OAAO,EAAE,qDAAqD;aAC/D,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,CAAU,CAAC;YACzB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;gBAClD,MAAM;oBACJ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,OAAO;oBACpB,OAAO,EAAE,oBAAoB,YAAY,CAAC,UAAU,8NAA8N;iBACnR,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/commands/restore.test.d.ts

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

package/dist/src/commands/restore.test.js

@@ -0,0 +1,137 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { performRestore } from './restore.js';
+import {} from '../utils/checkpointUtils.js';
+describe('performRestore', () => {
+    let mockGitService;
+    beforeEach(() => {
+        mockGitService = {
+            initialize: vi.fn(),
+            verifyGitAvailability: vi.fn(),
+            setupShadowGitRepository: vi.fn(),
+            getCurrentCommitHash: vi.fn(),
+            createFileSnapshot: vi.fn(),
+            restoreProjectFromSnapshot: vi.fn(),
+            storage: {},
+            getHistoryDir: vi.fn().mockReturnValue('mock-history-dir'),
+            shadowGitRepository: {},
+        };
+    });
+    it('should yield load_history if history and clientHistory are present', async () => {
+        const toolCallData = {
+            toolCall: { name: 'test', args: {} },
+            history: [{ some: 'history' }],
+            clientHistory: [{ role: 'user', parts: [{ text: 'hello' }] }],
+        };
+        const generator = performRestore(toolCallData, undefined);
+        const result = await generator.next();
+        expect(result.value).toEqual({
+            type: 'load_history',
+            history: toolCallData.history,
+            clientHistory: toolCallData.clientHistory,
+        });
+        expect(result.done).toBe(false);
+        const nextResult = await generator.next();
+        expect(nextResult.done).toBe(true);
+    });
+    it('should call restoreProjectFromSnapshot and yield a message if commitHash and gitService are present', async () => {
+        const toolCallData = {
+            toolCall: { name: 'test', args: {} },
+            commitHash: 'test-commit-hash',
+        };
+        const spy = vi
+            .spyOn(mockGitService, 'restoreProjectFromSnapshot')
+            .mockResolvedValue(undefined);
+        const generator = performRestore(toolCallData, mockGitService);
+        const result = await generator.next();
+        expect(spy).toHaveBeenCalledWith('test-commit-hash');
+        expect(result.value).toEqual({
+            type: 'message',
+            messageType: 'info',
+            content: 'Restored project to the state before the tool call.',
+        });
+        expect(result.done).toBe(false);
+        const nextResult = await generator.next();
+        expect(nextResult.done).toBe(true);
+    });
+    it('should yield an error message if restoreProjectFromSnapshot throws "unable to read tree" error', async () => {
+        const toolCallData = {
+            toolCall: { name: 'test', args: {} },
+            commitHash: 'invalid-commit-hash',
+        };
+        const spy = vi
+            .spyOn(mockGitService, 'restoreProjectFromSnapshot')
+            .mockRejectedValue(new Error('fatal: unable to read tree invalid-commit-hash'));
+        const generator = performRestore(toolCallData, mockGitService);
+        const result = await generator.next();
+        expect(spy).toHaveBeenCalledWith('invalid-commit-hash');
+        expect(result.value).toEqual({
+            type: 'message',
+            messageType: 'error',
+            content: "The commit hash 'invalid-commit-hash' associated with this checkpoint could not be found in your Git repository. This can happen if the repository has been re-cloned, reset, or if old commits have been garbage collected. This checkpoint cannot be restored.",
+        });
+        expect(result.done).toBe(false);
+        const nextResult = await generator.next();
+        expect(nextResult.done).toBe(true);
+    });
+    it('should re-throw other errors from restoreProjectFromSnapshot', async () => {
+        const toolCallData = {
+            toolCall: { name: 'test', args: {} },
+            commitHash: 'some-commit-hash',
+        };
+        const testError = new Error('something went wrong');
+        vi.spyOn(mockGitService, 'restoreProjectFromSnapshot').mockRejectedValue(testError);
+        const generator = performRestore(toolCallData, mockGitService);
+        await expect(generator.next()).rejects.toThrow(testError);
+    });
+    it('should yield load_history then a message if both are present', async () => {
+        const toolCallData = {
+            toolCall: { name: 'test', args: {} },
+            history: [{ some: 'history' }],
+            clientHistory: [{ role: 'user', parts: [{ text: 'hello' }] }],
+            commitHash: 'test-commit-hash',
+        };
+        const spy = vi
+            .spyOn(mockGitService, 'restoreProjectFromSnapshot')
+            .mockResolvedValue(undefined);
+        const generator = performRestore(toolCallData, mockGitService);
+        const historyResult = await generator.next();
+        expect(historyResult.value).toEqual({
+            type: 'load_history',
+            history: toolCallData.history,
+            clientHistory: toolCallData.clientHistory,
+        });
+        expect(historyResult.done).toBe(false);
+        const messageResult = await generator.next();
+        expect(spy).toHaveBeenCalledWith('test-commit-hash');
+        expect(messageResult.value).toEqual({
+            type: 'message',
+            messageType: 'info',
+            content: 'Restored project to the state before the tool call.',
+        });
+        expect(messageResult.done).toBe(false);
+        const nextResult = await generator.next();
+        expect(nextResult.done).toBe(true);
+    });
+    it('should yield error message if commitHash is present but gitService is undefined', async () => {
+        const toolCallData = {
+            toolCall: { name: 'test', args: {} },
+            commitHash: 'test-commit-hash',
+        };
+        const generator = performRestore(toolCallData, undefined);
+        const result = await generator.next();
+        expect(result.value).toEqual({
+            type: 'message',
+            messageType: 'error',
+            content: 'Git service is not available, cannot restore checkpoint. Please ensure you are in a git repository.',
+        });
+        expect(result.done).toBe(false);
+        const nextResult = await generator.next();
+        expect(nextResult.done).toBe(true);
+    });
+});
+//# sourceMappingURL=restore.test.js.map

package/dist/src/commands/restore.test.js.map

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

package/dist/src/commands/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Content, PartListUnion } from '@google/genai';
+/**
+ * The return type for a command action that results in scheduling a tool call.
+ */
+export interface ToolActionReturn {
+    type: 'tool';
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+}
+/**
+ * The return type for a command action that results in a simple message
+ * being displayed to the user.
+ */
+export interface MessageActionReturn {
+    type: 'message';
+    messageType: 'info' | 'error';
+    content: string;
+}
+/**
+ * The return type for a command action that results in replacing
+ * the entire conversation history.
+ */
+export interface LoadHistoryActionReturn<HistoryType = unknown> {
+    type: 'load_history';
+    history: HistoryType;
+    clientHistory: Content[];
+}
+/**
+ * The return type for a command action that should immediately submit
+ * content as a prompt to the Gemini model.
+ */
+export interface SubmitPromptActionReturn {
+    type: 'submit_prompt';
+    content: PartListUnion;
+}
+export type CommandActionReturn<HistoryType = unknown> = ToolActionReturn | MessageActionReturn | LoadHistoryActionReturn<HistoryType> | SubmitPromptActionReturn;

package/dist/src/commands/types.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}