@zgsm/costrict-cli 0.0.1

package/dist/src/config/extensions/update.test.js

@@ -0,0 +1,231 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { updateExtension, updateAllUpdatableExtensions, checkForAllExtensionUpdates, } from './update.js';
+import { ExtensionUpdateState, } from '../../ui/state/extensions.js';
+import { ExtensionStorage } from './storage.js';
+import { copyExtension } from '../extension-manager.js';
+import { checkForExtensionUpdate } from './github.js';
+import { loadInstallMetadata } from '../extension.js';
+import * as fs from 'node:fs';
+// Mock dependencies
+vi.mock('./storage.js', () => ({
+    ExtensionStorage: {
+        createTmpDir: vi.fn(),
+    },
+}));
+vi.mock('../extension-manager.js', () => ({
+    copyExtension: vi.fn(),
+    // We don't need to mock the class implementation if we pass a mock instance
+}));
+vi.mock('./github.js', () => ({
+    checkForExtensionUpdate: vi.fn(),
+}));
+vi.mock('../extension.js', () => ({
+    loadInstallMetadata: vi.fn(),
+}));
+vi.mock('node:fs', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        promises: {
+            ...actual.promises,
+            rm: vi.fn(),
+        },
+    };
+});
+describe('Extension Update Logic', () => {
+    let mockExtensionManager;
+    let mockDispatch;
+    const mockExtension = {
+        name: 'test-extension',
+        version: '1.0.0',
+        path: '/path/to/extension',
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockExtensionManager = {
+            loadExtensionConfig: vi.fn(),
+            installOrUpdateExtension: vi.fn(),
+        };
+        mockDispatch = vi.fn();
+        // Default mock behaviors
+        vi.mocked(ExtensionStorage.createTmpDir).mockResolvedValue('/tmp/mock-dir');
+        vi.mocked(loadInstallMetadata).mockReturnValue({
+            source: 'https://example.com/repo.git',
+            type: 'git',
+        });
+    });
+    describe('updateExtension', () => {
+        it('should return undefined if state is already UPDATING', async () => {
+            const result = await updateExtension(mockExtension, mockExtensionManager, ExtensionUpdateState.UPDATING, mockDispatch);
+            expect(result).toBeUndefined();
+            expect(mockDispatch).not.toHaveBeenCalled();
+        });
+        it('should throw error and set state to ERROR if install metadata type is unknown', async () => {
+            vi.mocked(loadInstallMetadata).mockReturnValue({
+                type: undefined,
+            });
+            await expect(updateExtension(mockExtension, mockExtensionManager, ExtensionUpdateState.UPDATE_AVAILABLE, mockDispatch)).rejects.toThrow('type is unknown');
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.UPDATING,
+                },
+            });
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.ERROR,
+                },
+            });
+        });
+        it('should throw error and set state to UP_TO_DATE if extension is linked', async () => {
+            vi.mocked(loadInstallMetadata).mockReturnValue({
+                type: 'link',
+                source: '',
+            });
+            await expect(updateExtension(mockExtension, mockExtensionManager, ExtensionUpdateState.UPDATE_AVAILABLE, mockDispatch)).rejects.toThrow('Extension is linked');
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.UP_TO_DATE,
+                },
+            });
+        });
+        it('should successfully update extension and set state to UPDATED_NEEDS_RESTART by default', async () => {
+            vi.mocked(mockExtensionManager.loadExtensionConfig).mockReturnValue({
+                name: 'test-extension',
+                version: '1.0.0',
+            });
+            vi.mocked(mockExtensionManager.installOrUpdateExtension).mockResolvedValue({
+                ...mockExtension,
+                version: '1.1.0',
+            });
+            const result = await updateExtension(mockExtension, mockExtensionManager, ExtensionUpdateState.UPDATE_AVAILABLE, mockDispatch);
+            expect(mockExtensionManager.installOrUpdateExtension).toHaveBeenCalled();
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.UPDATED_NEEDS_RESTART,
+                },
+            });
+            expect(result).toEqual({
+                name: 'test-extension',
+                originalVersion: '1.0.0',
+                updatedVersion: '1.1.0',
+            });
+            expect(fs.promises.rm).toHaveBeenCalledWith('/tmp/mock-dir', {
+                recursive: true,
+                force: true,
+            });
+        });
+        it('should set state to UPDATED if enableExtensionReloading is true', async () => {
+            vi.mocked(mockExtensionManager.loadExtensionConfig).mockReturnValue({
+                name: 'test-extension',
+                version: '1.0.0',
+            });
+            vi.mocked(mockExtensionManager.installOrUpdateExtension).mockResolvedValue({
+                ...mockExtension,
+                version: '1.1.0',
+            });
+            await updateExtension(mockExtension, mockExtensionManager, ExtensionUpdateState.UPDATE_AVAILABLE, mockDispatch, true);
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.UPDATED,
+                },
+            });
+        });
+        it('should rollback and set state to ERROR if installation fails', async () => {
+            vi.mocked(mockExtensionManager.loadExtensionConfig).mockReturnValue({
+                name: 'test-extension',
+                version: '1.0.0',
+            });
+            vi.mocked(mockExtensionManager.installOrUpdateExtension).mockRejectedValue(new Error('Install failed'));
+            await expect(updateExtension(mockExtension, mockExtensionManager, ExtensionUpdateState.UPDATE_AVAILABLE, mockDispatch)).rejects.toThrow('Updated extension not found after installation');
+            expect(copyExtension).toHaveBeenCalledWith('/tmp/mock-dir', mockExtension.path);
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.ERROR,
+                },
+            });
+            expect(fs.promises.rm).toHaveBeenCalled();
+        });
+    });
+    describe('updateAllUpdatableExtensions', () => {
+        it('should update all extensions with UPDATE_AVAILABLE status', async () => {
+            const extensions = [
+                { ...mockExtension, name: 'ext1' },
+                { ...mockExtension, name: 'ext2' },
+                { ...mockExtension, name: 'ext3' },
+            ];
+            const extensionsState = new Map([
+                ['ext1', { status: ExtensionUpdateState.UPDATE_AVAILABLE }],
+                ['ext2', { status: ExtensionUpdateState.UP_TO_DATE }],
+                ['ext3', { status: ExtensionUpdateState.UPDATE_AVAILABLE }],
+            ]);
+            vi.mocked(mockExtensionManager.loadExtensionConfig).mockReturnValue({
+                name: 'ext',
+                version: '1.0.0',
+            });
+            vi.mocked(mockExtensionManager.installOrUpdateExtension).mockResolvedValue({ ...mockExtension, version: '1.1.0' });
+            const results = await updateAllUpdatableExtensions(extensions, extensionsState, mockExtensionManager, mockDispatch);
+            expect(results).toHaveLength(2);
+            expect(results.map((r) => r.name)).toEqual(['ext1', 'ext3']);
+            expect(mockExtensionManager.installOrUpdateExtension).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('checkForAllExtensionUpdates', () => {
+        it('should dispatch BATCH_CHECK_START and BATCH_CHECK_END', async () => {
+            await checkForAllExtensionUpdates([], mockExtensionManager, mockDispatch);
+            expect(mockDispatch).toHaveBeenCalledWith({ type: 'BATCH_CHECK_START' });
+            expect(mockDispatch).toHaveBeenCalledWith({ type: 'BATCH_CHECK_END' });
+        });
+        it('should set state to NOT_UPDATABLE if no install metadata', async () => {
+            const extensions = [
+                { ...mockExtension, installMetadata: undefined },
+            ];
+            await checkForAllExtensionUpdates(extensions, mockExtensionManager, mockDispatch);
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.NOT_UPDATABLE,
+                },
+            });
+        });
+        it('should check for updates and update state', async () => {
+            const extensions = [
+                { ...mockExtension, installMetadata: { type: 'git', source: '...' } },
+            ];
+            vi.mocked(checkForExtensionUpdate).mockResolvedValue(ExtensionUpdateState.UPDATE_AVAILABLE);
+            await checkForAllExtensionUpdates(extensions, mockExtensionManager, mockDispatch);
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.CHECKING_FOR_UPDATES,
+                },
+            });
+            expect(mockDispatch).toHaveBeenCalledWith({
+                type: 'SET_STATE',
+                payload: {
+                    name: mockExtension.name,
+                    state: ExtensionUpdateState.UPDATE_AVAILABLE,
+                },
+            });
+        });
+    });
+});
+//# sourceMappingURL=update.test.js.map

package/dist/src/config/extensions/update.test.js.map

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

package/dist/src/config/extensions/variableSchema.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface VariableDefinition {
+    type: 'string';
+    description: string;
+    default?: string;
+    required?: boolean;
+}
+export interface VariableSchema {
+    [key: string]: VariableDefinition;
+}
+export declare const VARIABLE_SCHEMA: {
+    readonly extensionPath: {
+        readonly type: "string";
+        readonly description: "The path of the extension in the filesystem.";
+    };
+    readonly workspacePath: {
+        readonly type: "string";
+        readonly description: "The absolute path of the current workspace.";
+    };
+    readonly '/': {
+        readonly type: "string";
+        readonly description: "The path separator.";
+    };
+    readonly pathSeparator: {
+        readonly type: "string";
+        readonly description: "The path separator.";
+    };
+};

package/dist/src/config/extensions/variableSchema.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const PATH_SEPARATOR_DEFINITION = {
+    type: 'string',
+    description: 'The path separator.',
+};
+export const VARIABLE_SCHEMA = {
+    extensionPath: {
+        type: 'string',
+        description: 'The path of the extension in the filesystem.',
+    },
+    workspacePath: {
+        type: 'string',
+        description: 'The absolute path of the current workspace.',
+    },
+    '/': PATH_SEPARATOR_DEFINITION,
+    pathSeparator: PATH_SEPARATOR_DEFINITION,
+};
+//# sourceMappingURL=variableSchema.js.map

package/dist/src/config/extensions/variableSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variableSchema.js","sourceRoot":"","sources":["../../../../src/config/extensions/variableSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,MAAM,yBAAyB,GAAG;IAChC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,qBAAqB;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,8CAA8C;KAC5D;IACD,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6CAA6C;KAC3D;IACD,GAAG,EAAE,yBAAyB;IAC9B,aAAa,EAAE,yBAAyB;CAChC,CAAC"}

package/dist/src/config/extensions/variables.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type VariableSchema, VARIABLE_SCHEMA } from './variableSchema.js';
+export declare const EXTENSIONS_DIRECTORY_NAME: string;
+export declare const EXTENSIONS_CONFIG_FILENAME = "gemini-extension.json";
+export declare const INSTALL_METADATA_FILENAME = ".gemini-extension-install.json";
+export declare const EXTENSION_SETTINGS_FILENAME = ".env";
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type JsonArray = JsonValue[];
+export type JsonValue = string | number | boolean | null | JsonObject | JsonArray;
+export type VariableContext = {
+    [key in keyof typeof VARIABLE_SCHEMA]?: string;
+};
+export declare function validateVariables(variables: VariableContext, schema: VariableSchema): void;
+export declare function hydrateString(str: string, context: VariableContext): string;
+export declare function recursivelyHydrateStrings(obj: JsonValue, values: VariableContext): JsonValue;

package/dist/src/config/extensions/variables.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+import { VARIABLE_SCHEMA } from './variableSchema.js';
+import { GEMINI_DIR } from '@google/gemini-cli-core';
+export const EXTENSIONS_DIRECTORY_NAME = path.join(GEMINI_DIR, 'extensions');
+export const EXTENSIONS_CONFIG_FILENAME = 'gemini-extension.json';
+export const INSTALL_METADATA_FILENAME = '.gemini-extension-install.json';
+export const EXTENSION_SETTINGS_FILENAME = '.env';
+export function validateVariables(variables, schema) {
+    for (const key in schema) {
+        const definition = schema[key];
+        if (definition.required && !variables[key]) {
+            throw new Error(`Missing required variable: ${key}`);
+        }
+    }
+}
+export function hydrateString(str, context) {
+    validateVariables(context, VARIABLE_SCHEMA);
+    const regex = /\${(.*?)}/g;
+    return str.replace(regex, (match, key) => context[key] == null
+        ? match
+        : context[key]);
+}
+export function recursivelyHydrateStrings(obj, values) {
+    if (typeof obj === 'string') {
+        return hydrateString(obj, values);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((item) => recursivelyHydrateStrings(item, values));
+    }
+    if (typeof obj === 'object' && obj !== null) {
+        const newObj = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                newObj[key] = recursivelyHydrateStrings(obj[key], values);
+            }
+        }
+        return newObj;
+    }
+    return obj;
+}
+//# sourceMappingURL=variables.js.map

package/dist/src/config/extensions/variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables.js","sourceRoot":"","sources":["../../../../src/config/extensions/variables.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAuB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC;AAC1E,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAgBlD,MAAM,UAAU,iBAAiB,CAC/B,SAA0B,EAC1B,MAAsB;IAEtB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,UAAU,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,GAA4B,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,OAAwB;IACjE,iBAAiB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,YAAY,CAAC;IAC3B,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACvC,OAAO,CAAC,GAA4B,CAAC,IAAI,IAAI;QAC3C,CAAC,CAAC,KAAK;QACP,CAAC,CAAE,OAAO,CAAC,GAA4B,CAAY,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,GAAc,EACd,MAAuB;IAEvB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,CAAC,GAAG,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/config/extensions/variables.test.d.ts

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

package/dist/src/config/extensions/variables.test.js

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { expect, describe, it } from 'vitest';
+import { hydrateString, recursivelyHydrateStrings, validateVariables, } from './variables.js';
+describe('validateVariables', () => {
+    it('should not throw if all required variables are present', () => {
+        const schema = {
+            extensionPath: { type: 'string', description: 'test', required: true },
+        };
+        const context = { extensionPath: 'value' };
+        expect(() => validateVariables(context, schema)).not.toThrow();
+    });
+    it('should throw if a required variable is missing', () => {
+        const schema = {
+            extensionPath: { type: 'string', description: 'test', required: true },
+        };
+        const context = {};
+        expect(() => validateVariables(context, schema)).toThrow('Missing required variable: extensionPath');
+    });
+});
+describe('hydrateString', () => {
+    it('should replace a single variable', () => {
+        const context = {
+            extensionPath: 'path/my-extension',
+        };
+        const result = hydrateString('Hello, ${extensionPath}!', context);
+        expect(result).toBe('Hello, path/my-extension!');
+    });
+    it('should replace multiple variables', () => {
+        const context = {
+            extensionPath: 'path/my-extension',
+            workspacePath: '/ws',
+        };
+        const result = hydrateString('Ext: ${extensionPath}, WS: ${workspacePath}', context);
+        expect(result).toBe('Ext: path/my-extension, WS: /ws');
+    });
+    it('should ignore unknown variables', () => {
+        const context = {
+            extensionPath: 'path/my-extension',
+        };
+        const result = hydrateString('Hello, ${unknown}!', context);
+        expect(result).toBe('Hello, ${unknown}!');
+    });
+    it('should handle null and undefined context values', () => {
+        const context = {
+            extensionPath: undefined,
+        };
+        const result = hydrateString('Ext: ${extensionPath}, WS: ${workspacePath}', context);
+        expect(result).toBe('Ext: ${extensionPath}, WS: ${workspacePath}');
+    });
+});
+describe('recursivelyHydrateStrings', () => {
+    const context = {
+        extensionPath: 'path/my-extension',
+        workspacePath: '/ws',
+    };
+    it('should hydrate strings in a flat object', () => {
+        const obj = {
+            a: 'Hello, ${workspacePath}',
+            b: 'Hi, ${extensionPath}',
+        };
+        const result = recursivelyHydrateStrings(obj, context);
+        expect(result).toEqual({
+            a: 'Hello, /ws',
+            b: 'Hi, path/my-extension',
+        });
+    });
+    it('should hydrate strings in an array', () => {
+        const arr = ['${workspacePath}', '${extensionPath}'];
+        const result = recursivelyHydrateStrings(arr, context);
+        expect(result).toEqual(['/ws', 'path/my-extension']);
+    });
+    it('should hydrate strings in a nested object', () => {
+        const obj = {
+            a: 'Hello, ${workspacePath}',
+            b: {
+                c: 'Hi, ${extensionPath}',
+                d: ['${workspacePath}/foo'],
+            },
+        };
+        const result = recursivelyHydrateStrings(obj, context);
+        expect(result).toEqual({
+            a: 'Hello, /ws',
+            b: {
+                c: 'Hi, path/my-extension',
+                d: ['/ws/foo'],
+            },
+        });
+    });
+    it('should not modify non-string values', () => {
+        const obj = {
+            a: 123,
+            b: true,
+            c: null,
+        };
+        const result = recursivelyHydrateStrings(obj, context);
+        expect(result).toEqual(obj);
+    });
+});
+//# sourceMappingURL=variables.test.js.map

package/dist/src/config/extensions/variables.test.js.map

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

package/dist/src/config/keyBindings.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Command enum for all available keyboard shortcuts
+ */
+export declare enum Command {
+    RETURN = "return",
+    ESCAPE = "escape",
+    HOME = "home",
+    END = "end",
+    KILL_LINE_RIGHT = "killLineRight",
+    KILL_LINE_LEFT = "killLineLeft",
+    CLEAR_INPUT = "clearInput",
+    DELETE_WORD_BACKWARD = "deleteWordBackward",
+    CLEAR_SCREEN = "clearScreen",
+    SCROLL_UP = "scrollUp",
+    SCROLL_DOWN = "scrollDown",
+    SCROLL_HOME = "scrollHome",
+    SCROLL_END = "scrollEnd",
+    PAGE_UP = "pageUp",
+    PAGE_DOWN = "pageDown",
+    HISTORY_UP = "historyUp",
+    HISTORY_DOWN = "historyDown",
+    NAVIGATION_UP = "navigationUp",
+    NAVIGATION_DOWN = "navigationDown",
+    DIALOG_NAVIGATION_UP = "dialogNavigationUp",
+    DIALOG_NAVIGATION_DOWN = "dialogNavigationDown",
+    ACCEPT_SUGGESTION = "acceptSuggestion",
+    COMPLETION_UP = "completionUp",
+    COMPLETION_DOWN = "completionDown",
+    SUBMIT = "submit",
+    NEWLINE = "newline",
+    OPEN_EXTERNAL_EDITOR = "openExternalEditor",
+    PASTE_CLIPBOARD = "pasteClipboard",
+    SHOW_ERROR_DETAILS = "showErrorDetails",
+    SHOW_FULL_TODOS = "showFullTodos",
+    TOGGLE_IDE_CONTEXT_DETAIL = "toggleIDEContextDetail",
+    TOGGLE_MARKDOWN = "toggleMarkdown",
+    TOGGLE_COPY_MODE = "toggleCopyMode",
+    QUIT = "quit",
+    EXIT = "exit",
+    SHOW_MORE_LINES = "showMoreLines",
+    REVERSE_SEARCH = "reverseSearch",
+    SUBMIT_REVERSE_SEARCH = "submitReverseSearch",
+    ACCEPT_SUGGESTION_REVERSE_SEARCH = "acceptSuggestionReverseSearch",
+    TOGGLE_SHELL_INPUT_FOCUS = "toggleShellInputFocus",
+    EXPAND_SUGGESTION = "expandSuggestion",
+    COLLAPSE_SUGGESTION = "collapseSuggestion"
+}
+/**
+ * Data-driven key binding structure for user configuration
+ */
+export interface KeyBinding {
+    /** The key name (e.g., 'a', 'return', 'tab', 'escape') */
+    key?: string;
+    /** The key sequence (e.g., '\x18' for Ctrl+X) - alternative to key name */
+    sequence?: string;
+    /** Control key requirement: true=must be pressed, false=must not be pressed, undefined=ignore */
+    ctrl?: boolean;
+    /** Shift key requirement: true=must be pressed, false=must not be pressed, undefined=ignore */
+    shift?: boolean;
+    /** Command/meta key requirement: true=must be pressed, false=must not be pressed, undefined=ignore */
+    command?: boolean;
+    /** Paste operation requirement: true=must be paste, false=must not be paste, undefined=ignore */
+    paste?: boolean;
+}
+/**
+ * Configuration type mapping commands to their key bindings
+ */
+export type KeyBindingConfig = {
+    readonly [C in Command]: readonly KeyBinding[];
+};
+/**
+ * Default key binding configuration
+ * Matches the original hard-coded logic exactly
+ */
+export declare const defaultKeyBindings: KeyBindingConfig;
+interface CommandCategory {
+    readonly title: string;
+    readonly commands: readonly Command[];
+}
+/**
+ * Presentation metadata for grouping commands in documentation or UI.
+ */
+export declare const commandCategories: readonly CommandCategory[];
+/**
+ * Human-readable descriptions for each command, used in docs/tooling.
+ */
+export declare const commandDescriptions: Readonly<Record<Command, string>>;
+export {};