@google/gemini-cli 0.0.3-preview.4

package/dist/src/config/extension.js

@@ -0,0 +1,372 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Storage } from '@google/gemini-cli-core';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { simpleGit } from 'simple-git';
+import { SettingScope, loadSettings } from '../config/settings.js';
+import { getErrorMessage } from '../utils/errors.js';
+import { recursivelyHydrateStrings } from './extensions/variables.js';
+export const EXTENSIONS_DIRECTORY_NAME = '.gemini/extensions';
+export const EXTENSIONS_CONFIG_FILENAME = 'gemini-extension.json';
+export const INSTALL_METADATA_FILENAME = '.gemini-extension-install.json';
+export class ExtensionStorage {
+    extensionName;
+    constructor(extensionName) {
+        this.extensionName = extensionName;
+    }
+    getExtensionDir() {
+        return path.join(ExtensionStorage.getUserExtensionsDir(), this.extensionName);
+    }
+    getConfigPath() {
+        return path.join(this.getExtensionDir(), EXTENSIONS_CONFIG_FILENAME);
+    }
+    static getUserExtensionsDir() {
+        const storage = new Storage(os.homedir());
+        return storage.getExtensionsDir();
+    }
+    static async createTmpDir() {
+        return await fs.promises.mkdtemp(path.join(os.tmpdir(), 'gemini-extension'));
+    }
+}
+export function getWorkspaceExtensions(workspaceDir) {
+    return loadExtensionsFromDir(workspaceDir);
+}
+async function copyExtension(source, destination) {
+    await fs.promises.cp(source, destination, { recursive: true });
+}
+export async function performWorkspaceExtensionMigration(extensions) {
+    const failedInstallNames = [];
+    for (const extension of extensions) {
+        try {
+            const installMetadata = {
+                source: extension.path,
+                type: 'local',
+            };
+            await installExtension(installMetadata);
+        }
+        catch (_) {
+            failedInstallNames.push(extension.config.name);
+        }
+    }
+    return failedInstallNames;
+}
+export function loadExtensions(workspaceDir) {
+    const settings = loadSettings(workspaceDir).merged;
+    const disabledExtensions = settings.extensions?.disabled ?? [];
+    const allExtensions = [...loadUserExtensions()];
+    if (!settings.experimental?.extensionManagement) {
+        allExtensions.push(...getWorkspaceExtensions(workspaceDir));
+    }
+    const uniqueExtensions = new Map();
+    for (const extension of allExtensions) {
+        if (!uniqueExtensions.has(extension.config.name) &&
+            !disabledExtensions.includes(extension.config.name)) {
+            uniqueExtensions.set(extension.config.name, extension);
+        }
+    }
+    return Array.from(uniqueExtensions.values());
+}
+export function loadUserExtensions() {
+    const userExtensions = loadExtensionsFromDir(os.homedir());
+    const uniqueExtensions = new Map();
+    for (const extension of userExtensions) {
+        if (!uniqueExtensions.has(extension.config.name)) {
+            uniqueExtensions.set(extension.config.name, extension);
+        }
+    }
+    return Array.from(uniqueExtensions.values());
+}
+export function loadExtensionsFromDir(dir) {
+    const storage = new Storage(dir);
+    const extensionsDir = storage.getExtensionsDir();
+    if (!fs.existsSync(extensionsDir)) {
+        return [];
+    }
+    const extensions = [];
+    for (const subdir of fs.readdirSync(extensionsDir)) {
+        const extensionDir = path.join(extensionsDir, subdir);
+        const extension = loadExtension(extensionDir);
+        if (extension != null) {
+            extensions.push(extension);
+        }
+    }
+    return extensions;
+}
+export function loadExtension(extensionDir) {
+    if (!fs.statSync(extensionDir).isDirectory()) {
+        console.error(`Warning: unexpected file ${extensionDir} in extensions directory.`);
+        return null;
+    }
+    const configFilePath = path.join(extensionDir, EXTENSIONS_CONFIG_FILENAME);
+    if (!fs.existsSync(configFilePath)) {
+        console.error(`Warning: extension directory ${extensionDir} does not contain a config file ${configFilePath}.`);
+        return null;
+    }
+    try {
+        const configContent = fs.readFileSync(configFilePath, 'utf-8');
+        const config = recursivelyHydrateStrings(JSON.parse(configContent), {
+            extensionPath: extensionDir,
+            '/': path.sep,
+            pathSeparator: path.sep,
+        });
+        if (!config.name || !config.version) {
+            console.error(`Invalid extension config in ${configFilePath}: missing name or version.`);
+            return null;
+        }
+        const contextFiles = getContextFileNames(config)
+            .map((contextFileName) => path.join(extensionDir, contextFileName))
+            .filter((contextFilePath) => fs.existsSync(contextFilePath));
+        return {
+            path: extensionDir,
+            config,
+            contextFiles,
+            installMetadata: loadInstallMetadata(extensionDir),
+        };
+    }
+    catch (e) {
+        console.error(`Warning: error parsing extension config in ${configFilePath}: ${getErrorMessage(e)}`);
+        return null;
+    }
+}
+function loadInstallMetadata(extensionDir) {
+    const metadataFilePath = path.join(extensionDir, INSTALL_METADATA_FILENAME);
+    try {
+        const configContent = fs.readFileSync(metadataFilePath, 'utf-8');
+        const metadata = JSON.parse(configContent);
+        return metadata;
+    }
+    catch (_e) {
+        return undefined;
+    }
+}
+function getContextFileNames(config) {
+    if (!config.contextFileName) {
+        return ['GEMINI.md'];
+    }
+    else if (!Array.isArray(config.contextFileName)) {
+        return [config.contextFileName];
+    }
+    return config.contextFileName;
+}
+/**
+ * Returns an annotated list of extensions. If an extension is listed in enabledExtensionNames, it will be active.
+ * If enabledExtensionNames is empty, an extension is active unless it is in list of disabled extensions in settings.
+ * @param extensions The base list of extensions.
+ * @param enabledExtensionNames The names of explicitly enabled extensions.
+ * @param workspaceDir The current workspace directory.
+ */
+export function annotateActiveExtensions(extensions, enabledExtensionNames, workspaceDir) {
+    const settings = loadSettings(workspaceDir).merged;
+    const disabledExtensions = settings.extensions?.disabled ?? [];
+    const annotatedExtensions = [];
+    if (enabledExtensionNames.length === 0) {
+        return extensions.map((extension) => ({
+            name: extension.config.name,
+            version: extension.config.version,
+            isActive: !disabledExtensions.includes(extension.config.name),
+            path: extension.path,
+        }));
+    }
+    const lowerCaseEnabledExtensions = new Set(enabledExtensionNames.map((e) => e.trim().toLowerCase()));
+    if (lowerCaseEnabledExtensions.size === 1 &&
+        lowerCaseEnabledExtensions.has('none')) {
+        return extensions.map((extension) => ({
+            name: extension.config.name,
+            version: extension.config.version,
+            isActive: false,
+            path: extension.path,
+        }));
+    }
+    const notFoundNames = new Set(lowerCaseEnabledExtensions);
+    for (const extension of extensions) {
+        const lowerCaseName = extension.config.name.toLowerCase();
+        const isActive = lowerCaseEnabledExtensions.has(lowerCaseName);
+        if (isActive) {
+            notFoundNames.delete(lowerCaseName);
+        }
+        annotatedExtensions.push({
+            name: extension.config.name,
+            version: extension.config.version,
+            isActive,
+            path: extension.path,
+        });
+    }
+    for (const requestedName of notFoundNames) {
+        console.error(`Extension not found: ${requestedName}`);
+    }
+    return annotatedExtensions;
+}
+/**
+ * Clones a Git repository to a specified local path.
+ * @param gitUrl The Git URL to clone.
+ * @param destination The destination path to clone the repository to.
+ */
+async function cloneFromGit(gitUrl, destination) {
+    try {
+        // TODO(chrstnb): Download the archive instead to avoid unnecessary .git info.
+        await simpleGit().clone(gitUrl, destination, ['--depth', '1']);
+    }
+    catch (error) {
+        throw new Error(`Failed to clone Git repository from ${gitUrl}`, {
+            cause: error,
+        });
+    }
+}
+export async function installExtension(installMetadata, cwd = process.cwd()) {
+    const extensionsDir = ExtensionStorage.getUserExtensionsDir();
+    await fs.promises.mkdir(extensionsDir, { recursive: true });
+    // Convert relative paths to absolute paths for the metadata file.
+    if (installMetadata.type === 'local' &&
+        !path.isAbsolute(installMetadata.source)) {
+        installMetadata.source = path.resolve(cwd, installMetadata.source);
+    }
+    let localSourcePath;
+    let tempDir;
+    if (installMetadata.type === 'git') {
+        tempDir = await ExtensionStorage.createTmpDir();
+        await cloneFromGit(installMetadata.source, tempDir);
+        localSourcePath = tempDir;
+    }
+    else {
+        localSourcePath = installMetadata.source;
+    }
+    let newExtensionName;
+    try {
+        const newExtension = loadExtension(localSourcePath);
+        if (!newExtension) {
+            throw new Error(`Invalid extension at ${installMetadata.source}. Please make sure it has a valid gemini-extension.json file.`);
+        }
+        // ~/.gemini/extensions/{ExtensionConfig.name}.
+        newExtensionName = newExtension.config.name;
+        const extensionStorage = new ExtensionStorage(newExtensionName);
+        const destinationPath = extensionStorage.getExtensionDir();
+        const installedExtensions = loadUserExtensions();
+        if (installedExtensions.some((installed) => installed.config.name === newExtensionName)) {
+            throw new Error(`Extension "${newExtensionName}" is already installed. Please uninstall it first.`);
+        }
+        await copyExtension(localSourcePath, destinationPath);
+        const metadataString = JSON.stringify(installMetadata, null, 2);
+        const metadataPath = path.join(destinationPath, INSTALL_METADATA_FILENAME);
+        await fs.promises.writeFile(metadataPath, metadataString);
+    }
+    finally {
+        if (tempDir) {
+            await fs.promises.rm(tempDir, { recursive: true, force: true });
+        }
+    }
+    return newExtensionName;
+}
+export async function uninstallExtension(extensionName, cwd = process.cwd()) {
+    const installedExtensions = loadUserExtensions();
+    if (!installedExtensions.some((installed) => installed.config.name === extensionName)) {
+        throw new Error(`Extension "${extensionName}" not found.`);
+    }
+    removeFromDisabledExtensions(extensionName, [SettingScope.User, SettingScope.Workspace], cwd);
+    const storage = new ExtensionStorage(extensionName);
+    return await fs.promises.rm(storage.getExtensionDir(), {
+        recursive: true,
+        force: true,
+    });
+}
+export function toOutputString(extension) {
+    let output = `${extension.config.name} (${extension.config.version})`;
+    output += `\n Path: ${extension.path}`;
+    if (extension.installMetadata) {
+        output += `\n Source: ${extension.installMetadata.source}`;
+    }
+    if (extension.contextFiles.length > 0) {
+        output += `\n Context files:`;
+        extension.contextFiles.forEach((contextFile) => {
+            output += `\n  ${contextFile}`;
+        });
+    }
+    if (extension.config.mcpServers) {
+        output += `\n MCP servers:`;
+        Object.keys(extension.config.mcpServers).forEach((key) => {
+            output += `\n  ${key}`;
+        });
+    }
+    if (extension.config.excludeTools) {
+        output += `\n Excluded tools:`;
+        extension.config.excludeTools.forEach((tool) => {
+            output += `\n  ${tool}`;
+        });
+    }
+    return output;
+}
+export async function updateExtension(extensionName, cwd = process.cwd()) {
+    const installedExtensions = loadUserExtensions();
+    const extension = installedExtensions.find((installed) => installed.config.name === extensionName);
+    if (!extension) {
+        throw new Error(`Extension "${extensionName}" not found. Run gemini extensions list to see available extensions.`);
+    }
+    if (!extension.installMetadata) {
+        throw new Error(`Extension cannot be updated because it is missing the .gemini-extension.install.json file. To update manually, uninstall and then reinstall the updated version.`);
+    }
+    const originalVersion = extension.config.version;
+    const tempDir = await ExtensionStorage.createTmpDir();
+    try {
+        await copyExtension(extension.path, tempDir);
+        await uninstallExtension(extensionName, cwd);
+        await installExtension(extension.installMetadata, cwd);
+        const updatedExtension = loadExtension(extension.path);
+        if (!updatedExtension) {
+            throw new Error('Updated extension not found after installation.');
+        }
+        const updatedVersion = updatedExtension.config.version;
+        return {
+            originalVersion,
+            updatedVersion,
+        };
+    }
+    catch (e) {
+        console.error(`Error updating extension, rolling back. ${getErrorMessage(e)}`);
+        await copyExtension(tempDir, extension.path);
+        throw e;
+    }
+    finally {
+        await fs.promises.rm(tempDir, { recursive: true, force: true });
+    }
+}
+export function disableExtension(name, scope, cwd = process.cwd()) {
+    if (scope === SettingScope.System || scope === SettingScope.SystemDefaults) {
+        throw new Error('System and SystemDefaults scopes are not supported.');
+    }
+    const settings = loadSettings(cwd);
+    const settingsFile = settings.forScope(scope);
+    const extensionSettings = settingsFile.settings.extensions || {
+        disabled: [],
+    };
+    const disabledExtensions = extensionSettings.disabled || [];
+    if (!disabledExtensions.includes(name)) {
+        disabledExtensions.push(name);
+        extensionSettings.disabled = disabledExtensions;
+        settings.setValue(scope, 'extensions', extensionSettings);
+    }
+}
+export function enableExtension(name, scopes) {
+    removeFromDisabledExtensions(name, scopes);
+}
+/**
+ * Removes an extension from the list of disabled extensions.
+ * @param name The name of the extension to remove.
+ * @param scope The scopes to remove the name from.
+ */
+function removeFromDisabledExtensions(name, scopes, cwd = process.cwd()) {
+    const settings = loadSettings(cwd);
+    for (const scope of scopes) {
+        const settingsFile = settings.forScope(scope);
+        const extensionSettings = settingsFile.settings.extensions || {
+            disabled: [],
+        };
+        const disabledExtensions = extensionSettings.disabled || [];
+        extensionSettings.disabled = disabledExtensions.filter((extension) => extension !== name);
+        settings.setValue(scope, 'extensions', extensionSettings);
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/src/config/extension.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * @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 '/': {
+        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,18 @@
+/**
+ * @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.',
+    },
+    '/': 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,GAAG,EAAE,yBAAyB;IAC9B,aAAa,EAAE,yBAAyB;CAChC,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type VariableSchema, VARIABLE_SCHEMA } from './variableSchema.js';
+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,40 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { VARIABLE_SCHEMA } from './variableSchema.js';
+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,EAAuB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAgB3E,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,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { expect, describe, it } from 'vitest';
+import { hydrateString } from './variables.js';
+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!');
+    });
+});
+//# 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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,OAAO,GAAG;YACd,aAAa,EAAE,mBAAmB;SACnC,CAAC;QACF,MAAM,MAAM,GAAG,aAAa,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,66 @@
+/**
+ * @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",
+    CLEAR_SCREEN = "clearScreen",
+    HISTORY_UP = "historyUp",
+    HISTORY_DOWN = "historyDown",
+    NAVIGATION_UP = "navigationUp",
+    NAVIGATION_DOWN = "navigationDown",
+    ACCEPT_SUGGESTION = "acceptSuggestion",
+    COMPLETION_UP = "completionUp",
+    COMPLETION_DOWN = "completionDown",
+    SUBMIT = "submit",
+    NEWLINE = "newline",
+    OPEN_EXTERNAL_EDITOR = "openExternalEditor",
+    PASTE_CLIPBOARD_IMAGE = "pasteClipboardImage",
+    SHOW_ERROR_DETAILS = "showErrorDetails",
+    TOGGLE_TOOL_DESCRIPTIONS = "toggleToolDescriptions",
+    TOGGLE_IDE_CONTEXT_DETAIL = "toggleIDEContextDetail",
+    QUIT = "quit",
+    EXIT = "exit",
+    SHOW_MORE_LINES = "showMoreLines",
+    REVERSE_SEARCH = "reverseSearch",
+    SUBMIT_REVERSE_SEARCH = "submitReverseSearch",
+    ACCEPT_SUGGESTION_REVERSE_SEARCH = "acceptSuggestionReverseSearch"
+}
+/**
+ * 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;