@machina.ai/cell-cli 1.33.0-rc1 → 1.38.1-rc1

package/dist/src/acp/commands/extensions.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Command, CommandContext, CommandExecutionResponse } from './types.js';
+export declare class ExtensionsCommand implements Command {
+    readonly name = "extensions";
+    readonly description = "Manage extensions.";
+    readonly subCommands: (ListExtensionsCommand | ExploreExtensionsCommand | EnableExtensionCommand | DisableExtensionCommand | InstallExtensionCommand | LinkExtensionCommand | UninstallExtensionCommand | RestartExtensionCommand | UpdateExtensionCommand)[];
+    execute(context: CommandContext, _: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class ListExtensionsCommand implements Command {
+    readonly name = "extensions list";
+    readonly description = "Lists all installed extensions.";
+    execute(context: CommandContext, _: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class ExploreExtensionsCommand implements Command {
+    readonly name = "extensions explore";
+    readonly description = "Explore available extensions.";
+    execute(_context: CommandContext, _: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class EnableExtensionCommand implements Command {
+    readonly name = "extensions enable";
+    readonly description = "Enable an extension.";
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class DisableExtensionCommand implements Command {
+    readonly name = "extensions disable";
+    readonly description = "Disable an extension.";
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class InstallExtensionCommand implements Command {
+    readonly name = "extensions install";
+    readonly description = "Install an extension from a git repo or local path.";
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class LinkExtensionCommand implements Command {
+    readonly name = "extensions link";
+    readonly description = "Link an extension from a local path.";
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class UninstallExtensionCommand implements Command {
+    readonly name = "extensions uninstall";
+    readonly description = "Uninstall an extension.";
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class RestartExtensionCommand implements Command {
+    readonly name = "extensions restart";
+    readonly description = "Restart an extension.";
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class UpdateExtensionCommand implements Command {
+    readonly name = "extensions update";
+    readonly description = "Update an extension.";
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}

package/dist/src/acp/commands/extensions.js

@@ -0,0 +1,331 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { listExtensions, getErrorMessage, } from '@google/gemini-cli-core';
+import { SettingScope } from '../../config/settings.js';
+import { ExtensionManager, inferInstallMetadata, } from '../../config/extension-manager.js';
+import { McpServerEnablementManager } from '../../config/mcp/mcpServerEnablement.js';
+import { stat } from 'node:fs/promises';
+export class ExtensionsCommand {
+    name = 'extensions';
+    description = 'Manage extensions.';
+    subCommands = [
+        new ListExtensionsCommand(),
+        new ExploreExtensionsCommand(),
+        new EnableExtensionCommand(),
+        new DisableExtensionCommand(),
+        new InstallExtensionCommand(),
+        new LinkExtensionCommand(),
+        new UninstallExtensionCommand(),
+        new RestartExtensionCommand(),
+        new UpdateExtensionCommand(),
+    ];
+    async execute(context, _) {
+        return new ListExtensionsCommand().execute(context, _);
+    }
+}
+export class ListExtensionsCommand {
+    name = 'extensions list';
+    description = 'Lists all installed extensions.';
+    async execute(context, _) {
+        const extensions = listExtensions(context.agentContext.config);
+        const data = extensions.length ? extensions : 'No extensions installed.';
+        return { name: this.name, data };
+    }
+}
+export class ExploreExtensionsCommand {
+    name = 'extensions explore';
+    description = 'Explore available extensions.';
+    async execute(_context, _) {
+        const extensionsUrl = 'https://geminicli.com/extensions/';
+        return {
+            name: this.name,
+            data: `View or install available extensions at ${extensionsUrl}`,
+        };
+    }
+}
+function getEnableDisableContext(config, args, invocationName) {
+    const extensionManager = config.getExtensionLoader();
+    if (!(extensionManager instanceof ExtensionManager)) {
+        return {
+            error: `Cannot ${invocationName} extensions in this environment.`,
+        };
+    }
+    if (args.length === 0) {
+        return {
+            error: `Usage: /extensions ${invocationName} <extension> [--scope=<user|workspace|session>]`,
+        };
+    }
+    let scope = SettingScope.User;
+    if (args.includes('--scope=workspace') || args.includes('workspace')) {
+        scope = SettingScope.Workspace;
+    }
+    else if (args.includes('--scope=session') || args.includes('session')) {
+        scope = SettingScope.Session;
+    }
+    const name = args.filter((a) => !a.startsWith('--scope') && !['user', 'workspace', 'session'].includes(a))[0];
+    let names = [];
+    if (name === '--all') {
+        let extensions = extensionManager.getExtensions();
+        if (invocationName === 'enable') {
+            extensions = extensions.filter((ext) => !ext.isActive);
+        }
+        if (invocationName === 'disable') {
+            extensions = extensions.filter((ext) => ext.isActive);
+        }
+        names = extensions.map((ext) => ext.name);
+    }
+    else if (name) {
+        names = [name];
+    }
+    else {
+        return { error: 'No extension name provided.' };
+    }
+    return { extensionManager, names, scope };
+}
+export class EnableExtensionCommand {
+    name = 'extensions enable';
+    description = 'Enable an extension.';
+    async execute(context, args) {
+        const enableContext = getEnableDisableContext(context.agentContext.config, args, 'enable');
+        if ('error' in enableContext) {
+            return { name: this.name, data: enableContext.error };
+        }
+        const { names, scope, extensionManager } = enableContext;
+        const output = [];
+        for (const name of names) {
+            try {
+                await extensionManager.enableExtension(name, scope);
+                output.push(`Extension "${name}" enabled for scope "${scope}".`);
+                const extension = extensionManager
+                    .getExtensions()
+                    .find((e) => e.name === name);
+                if (extension?.mcpServers) {
+                    const mcpEnablementManager = McpServerEnablementManager.getInstance();
+                    const mcpClientManager = context.agentContext.config.getMcpClientManager();
+                    const enabledServers = await mcpEnablementManager.autoEnableServers(Object.keys(extension.mcpServers));
+                    if (mcpClientManager && enabledServers.length > 0) {
+                        const restartPromises = enabledServers.map((serverName) => mcpClientManager.restartServer(serverName).catch((error) => {
+                            output.push(`Failed to restart MCP server '${serverName}': ${getErrorMessage(error)}`);
+                        }));
+                        await Promise.all(restartPromises);
+                        output.push(`Re-enabled MCP servers: ${enabledServers.join(', ')}`);
+                    }
+                }
+            }
+            catch (e) {
+                output.push(`Failed to enable "${name}": ${getErrorMessage(e)}`);
+            }
+        }
+        return { name: this.name, data: output.join('\n') || 'No action taken.' };
+    }
+}
+export class DisableExtensionCommand {
+    name = 'extensions disable';
+    description = 'Disable an extension.';
+    async execute(context, args) {
+        const enableContext = getEnableDisableContext(context.agentContext.config, args, 'disable');
+        if ('error' in enableContext) {
+            return { name: this.name, data: enableContext.error };
+        }
+        const { names, scope, extensionManager } = enableContext;
+        const output = [];
+        for (const name of names) {
+            try {
+                await extensionManager.disableExtension(name, scope);
+                output.push(`Extension "${name}" disabled for scope "${scope}".`);
+            }
+            catch (e) {
+                output.push(`Failed to disable "${name}": ${getErrorMessage(e)}`);
+            }
+        }
+        return { name: this.name, data: output.join('\n') || 'No action taken.' };
+    }
+}
+export class InstallExtensionCommand {
+    name = 'extensions install';
+    description = 'Install an extension from a git repo or local path.';
+    async execute(context, args) {
+        const extensionLoader = context.agentContext.config.getExtensionLoader();
+        if (!(extensionLoader instanceof ExtensionManager)) {
+            return {
+                name: this.name,
+                data: 'Cannot install extensions in this environment.',
+            };
+        }
+        const source = args.join(' ').trim();
+        if (!source) {
+            return { name: this.name, data: `Usage: /extensions install <source>` };
+        }
+        if (/[;&|`'"]/.test(source)) {
+            return {
+                name: this.name,
+                data: `Invalid source: contains disallowed characters.`,
+            };
+        }
+        try {
+            const installMetadata = await inferInstallMetadata(source);
+            const extension = await extensionLoader.installOrUpdateExtension(installMetadata);
+            return {
+                name: this.name,
+                data: `Extension "${extension.name}" installed successfully.`,
+            };
+        }
+        catch (error) {
+            return {
+                name: this.name,
+                data: `Failed to install extension from "${source}": ${getErrorMessage(error)}`,
+            };
+        }
+    }
+}
+export class LinkExtensionCommand {
+    name = 'extensions link';
+    description = 'Link an extension from a local path.';
+    async execute(context, args) {
+        const extensionLoader = context.agentContext.config.getExtensionLoader();
+        if (!(extensionLoader instanceof ExtensionManager)) {
+            return {
+                name: this.name,
+                data: 'Cannot link extensions in this environment.',
+            };
+        }
+        const sourceFilepath = args.join(' ').trim();
+        if (!sourceFilepath) {
+            return { name: this.name, data: `Usage: /extensions link <source>` };
+        }
+        try {
+            await stat(sourceFilepath);
+        }
+        catch {
+            return { name: this.name, data: `Invalid source: ${sourceFilepath}` };
+        }
+        try {
+            const extension = await extensionLoader.installOrUpdateExtension({
+                source: sourceFilepath,
+                type: 'link',
+            });
+            return {
+                name: this.name,
+                data: `Extension "${extension.name}" linked successfully.`,
+            };
+        }
+        catch (error) {
+            return {
+                name: this.name,
+                data: `Failed to link extension: ${getErrorMessage(error)}`,
+            };
+        }
+    }
+}
+export class UninstallExtensionCommand {
+    name = 'extensions uninstall';
+    description = 'Uninstall an extension.';
+    async execute(context, args) {
+        const extensionLoader = context.agentContext.config.getExtensionLoader();
+        if (!(extensionLoader instanceof ExtensionManager)) {
+            return {
+                name: this.name,
+                data: 'Cannot uninstall extensions in this environment.',
+            };
+        }
+        const all = args.includes('--all');
+        const names = args.filter((a) => !a.startsWith('--')).map((a) => a.trim());
+        if (!all && names.length === 0) {
+            return {
+                name: this.name,
+                data: `Usage: /extensions uninstall <extension-names...>|--all`,
+            };
+        }
+        let namesToUninstall = [];
+        if (all) {
+            namesToUninstall = extensionLoader.getExtensions().map((ext) => ext.name);
+        }
+        else {
+            namesToUninstall = names;
+        }
+        if (namesToUninstall.length === 0) {
+            return {
+                name: this.name,
+                data: all ? 'No extensions installed.' : 'No extension name provided.',
+            };
+        }
+        const output = [];
+        for (const extensionName of namesToUninstall) {
+            try {
+                await extensionLoader.uninstallExtension(extensionName, false);
+                output.push(`Extension "${extensionName}" uninstalled successfully.`);
+            }
+            catch (error) {
+                output.push(`Failed to uninstall extension "${extensionName}": ${getErrorMessage(error)}`);
+            }
+        }
+        return { name: this.name, data: output.join('\n') };
+    }
+}
+export class RestartExtensionCommand {
+    name = 'extensions restart';
+    description = 'Restart an extension.';
+    async execute(context, args) {
+        const extensionLoader = context.agentContext.config.getExtensionLoader();
+        if (!(extensionLoader instanceof ExtensionManager)) {
+            return { name: this.name, data: 'Cannot restart extensions.' };
+        }
+        const all = args.includes('--all');
+        const names = all ? null : args.filter((a) => !!a);
+        if (!all && names?.length === 0) {
+            return {
+                name: this.name,
+                data: 'Usage: /extensions restart <extension-names>|--all',
+            };
+        }
+        let extensionsToRestart = extensionLoader
+            .getExtensions()
+            .filter((e) => e.isActive);
+        if (names) {
+            extensionsToRestart = extensionsToRestart.filter((e) => names.includes(e.name));
+        }
+        if (extensionsToRestart.length === 0) {
+            return {
+                name: this.name,
+                data: 'No active extensions matched the request.',
+            };
+        }
+        const output = [];
+        for (const extension of extensionsToRestart) {
+            try {
+                await extensionLoader.restartExtension(extension);
+                output.push(`Restarted "${extension.name}".`);
+            }
+            catch (e) {
+                output.push(`Failed to restart "${extension.name}": ${getErrorMessage(e)}`);
+            }
+        }
+        return { name: this.name, data: output.join('\n') };
+    }
+}
+export class UpdateExtensionCommand {
+    name = 'extensions update';
+    description = 'Update an extension.';
+    async execute(context, args) {
+        const extensionLoader = context.agentContext.config.getExtensionLoader();
+        if (!(extensionLoader instanceof ExtensionManager)) {
+            return { name: this.name, data: 'Cannot update extensions.' };
+        }
+        const all = args.includes('--all');
+        const names = all ? null : args.filter((a) => !!a);
+        if (!all && names?.length === 0) {
+            return {
+                name: this.name,
+                data: 'Usage: /extensions update <extension-names>|--all',
+            };
+        }
+        return {
+            name: this.name,
+            data: 'Headless extension updating requires internal UI dispatches. Please use `gemini extensions update` directly in the terminal.',
+        };
+    }
+}
+//# sourceMappingURL=extensions.js.map

package/dist/src/acp/commands/extensions.js.map

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

package/dist/src/acp/commands/help.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Command, CommandContext, CommandExecutionResponse } from './types.js';
+import type { CommandRegistry } from './commandRegistry.js';
+export declare class HelpCommand implements Command {
+    private registry;
+    readonly name = "help";
+    readonly description = "Show available commands";
+    constructor(registry: CommandRegistry);
+    execute(_context: CommandContext, _args?: string[]): Promise<CommandExecutionResponse>;
+}

package/dist/src/acp/commands/help.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export class HelpCommand {
+    registry;
+    name = 'help';
+    description = 'Show available commands';
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async execute(_context, _args = []) {
+        const commands = this.registry
+            .getAllCommands()
+            .sort((a, b) => a.name.localeCompare(b.name));
+        const lines = [];
+        lines.push('Cell CLI Help:');
+        lines.push('');
+        lines.push('### Basics');
+        lines.push('- **Add context**: Use `@` to specify files for context (e.g., `@src/myFile.ts`) to target specific files or folders.');
+        lines.push('');
+        lines.push('### Commands');
+        for (const cmd of commands) {
+            if (cmd.description) {
+                lines.push(`- **/${cmd.name}** - ${cmd.description}`);
+            }
+        }
+        return {
+            name: this.name,
+            data: lines.join('\n'),
+        };
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/src/acp/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../../src/acp/commands/help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,OAAO,WAAW;IAIF;IAHX,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,yBAAyB,CAAC;IAEjD,YAAoB,QAAyB;QAAzB,aAAQ,GAAR,QAAQ,CAAiB;IAAG,CAAC;IAEjD,KAAK,CAAC,OAAO,CACX,QAAwB,EACxB,QAAkB,EAAE;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;aAC3B,cAAc,EAAE;aAChB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEhD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CACR,uHAAuH,CACxH,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;SACvB,CAAC;IACJ,CAAC;CACF"}

package/dist/src/acp/commands/help.test.js

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { HelpCommand } from './help.js';
+import { CommandRegistry } from './commandRegistry.js';
+describe('HelpCommand', () => {
+    it('returns formatted help text with sorted commands', async () => {
+        const registry = new CommandRegistry();
+        const cmdB = {
+            name: 'bravo',
+            description: 'Bravo command',
+            execute: async () => ({ name: 'bravo', data: '' }),
+        };
+        const cmdA = {
+            name: 'alpha',
+            description: 'Alpha command',
+            execute: async () => ({ name: 'alpha', data: '' }),
+        };
+        registry.register(cmdB);
+        registry.register(cmdA);
+        const helpCommand = new HelpCommand(registry);
+        const context = {};
+        const response = await helpCommand.execute(context, []);
+        expect(response.name).toBe('help');
+        const data = response.data;
+        expect(data).toContain('Cell CLI Help:');
+        expect(data).toContain('### Basics');
+        expect(data).toContain('### Commands');
+        const lines = data.split('\n');
+        const alphaIndex = lines.findIndex((l) => l.includes('/alpha'));
+        const bravoIndex = lines.findIndex((l) => l.includes('/bravo'));
+        expect(alphaIndex).toBeLessThan(bravoIndex);
+        expect(alphaIndex).not.toBe(-1);
+        expect(bravoIndex).not.toBe(-1);
+    });
+});
+//# sourceMappingURL=help.test.js.map

package/dist/src/acp/commands/help.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.test.js","sourceRoot":"","sources":["../../../../src/acp/commands/help.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QAEvC,MAAM,IAAI,GAAY;YACpB,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;SACnD,CAAC;QAEF,MAAM,IAAI,GAAY;YACpB,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;SACnD,CAAC;QAEF,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAExB,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;QAE9C,MAAM,OAAO,GAAG,EAAoB,CAAC;QAErC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAExD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAc,CAAC;QAErC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEhE,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Command, CommandContext, CommandExecutionResponse } from './types.js';
+export declare class InitCommand implements Command {
+    name: string;
+    description: string;
+    requiresWorkspace: boolean;
+    execute(context: CommandContext, _args?: string[]): Promise<CommandExecutionResponse>;
+}

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

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { performInit } from '@google/gemini-cli-core';
+export class InitCommand {
+    name = 'init';
+    description = 'Analyzes the project and creates a tailored GEMINI.md file';
+    requiresWorkspace = true;
+    async execute(context, _args = []) {
+        const targetDir = context.agentContext.config.getTargetDir();
+        if (!targetDir) {
+            throw new Error('Command requires a workspace.');
+        }
+        const geminiMdPath = path.join(targetDir, 'GEMINI.md');
+        const result = performInit(fs.existsSync(geminiMdPath));
+        switch (result.type) {
+            case 'message':
+                return {
+                    name: this.name,
+                    data: result,
+                };
+            case 'submit_prompt':
+                fs.writeFileSync(geminiMdPath, '', 'utf8');
+                if (typeof result.content !== 'string') {
+                    throw new Error('Init command content must be a string.');
+                }
+                // Inform the user since we can't trigger the UI-based interactive agent loop here directly.
+                // We output the prompt text they can use to re-trigger the generation manually,
+                // or just seed the GEMINI.md file as we've done above.
+                return {
+                    name: this.name,
+                    data: {
+                        type: 'message',
+                        messageType: 'info',
+                        content: `A template GEMINI.md has been created at ${geminiMdPath}.\n\nTo populate it with project context, you can run the following prompt in a new chat:\n\n${result.content}`,
+                    },
+                };
+            default:
+                throw new Error('Unknown result type from performInit');
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/acp/commands/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAOtD,MAAM,OAAO,WAAW;IACtB,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,4DAA4D,CAAC;IAC3E,iBAAiB,GAAG,IAAI,CAAC;IAEzB,KAAK,CAAC,OAAO,CACX,OAAuB,EACvB,QAAkB,EAAE;QAEpB,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;QAExD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,SAAS;gBACZ,OAAO;oBACL,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,MAAM;iBACb,CAAC;YACJ,KAAK,eAAe;gBAClB,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;gBAE3C,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACvC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBAC5D,CAAC;gBAED,4FAA4F;gBAC5F,gFAAgF;gBAChF,uDAAuD;gBACvD,OAAO;oBACL,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE;wBACJ,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,MAAM;wBACnB,OAAO,EAAE,4CAA4C,YAAY,gGAAgG,MAAM,CAAC,OAAO,EAAE;qBAClL;iBACF,CAAC;YAEJ;gBACE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Command, CommandContext, CommandExecutionResponse } from './types.js';
+export declare class MemoryCommand implements Command {
+    readonly name = "memory";
+    readonly description = "Manage memory.";
+    readonly subCommands: (ShowMemoryCommand | RefreshMemoryCommand | ListMemoryCommand | AddMemoryCommand)[];
+    readonly requiresWorkspace = true;
+    execute(context: CommandContext, _: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class ShowMemoryCommand implements Command {
+    readonly name = "memory show";
+    readonly description = "Shows the current memory contents.";
+    execute(context: CommandContext, _: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class RefreshMemoryCommand implements Command {
+    readonly name = "memory refresh";
+    readonly aliases: string[];
+    readonly description = "Refreshes the memory from the source.";
+    execute(context: CommandContext, _: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class ListMemoryCommand implements Command {
+    readonly name = "memory list";
+    readonly description = "Lists the paths of the GEMINI.md files in use.";
+    execute(context: CommandContext, _: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class AddMemoryCommand implements Command {
+    readonly name = "memory add";
+    readonly description = "Add content to the memory.";
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}