@terminai/a2a-server 0.21.0

package/dist/src/auth/llmAuthManager.js

@@ -0,0 +1,209 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Config, checkGeminiAuthStatusNonInteractive, beginGeminiOAuthLoopbackFlow, AuthType, saveApiKey, clearCachedCredentialFile, } from '@terminai/core';
+import { logger } from '../utils/logger.js';
+export class AuthConflictError extends Error {
+    statusCode = 409;
+}
+export class LlmAuthManager {
+    config;
+    getSelectedAuthType;
+    effectiveAuthType;
+    oauthFlow = null;
+    lastErrorMessage = null;
+    lastErrorCode;
+    constructor(input) {
+        this.config = input.config;
+        this.getSelectedAuthType = input.getSelectedAuthType;
+        this.effectiveAuthType = this.getSelectedAuthType();
+    }
+    async getStatus() {
+        const authType = this.effectiveAuthType ?? this.getSelectedAuthType();
+        if (this.oauthFlow) {
+            return {
+                status: 'in_progress',
+                authType,
+                message: 'OAuth sign-in in progress',
+            };
+        }
+        const check = await checkGeminiAuthStatusNonInteractive(authType, process.env);
+        if (check.status === 'ok') {
+            return { status: 'ok', authType };
+        }
+        if (check.status === 'required') {
+            return {
+                status: 'required',
+                authType,
+                message: check.message ?? this.lastErrorMessage ?? undefined,
+                errorCode: this.lastErrorCode,
+            };
+        }
+        return {
+            status: 'error',
+            authType,
+            message: check.message ?? this.lastErrorMessage ?? undefined,
+            errorCode: this.lastErrorCode,
+        };
+    }
+    async submitGeminiApiKey(apiKey) {
+        const trimmed = apiKey.trim();
+        if (trimmed.length === 0) {
+            return {
+                status: 'required',
+                authType: AuthType.USE_GEMINI,
+                message: 'API key must be a non-empty string',
+            };
+        }
+        this.effectiveAuthType = AuthType.USE_GEMINI;
+        this.lastErrorMessage = null;
+        await saveApiKey(trimmed);
+        await this.config.refreshAuth(AuthType.USE_GEMINI);
+        return this.getStatus();
+    }
+    async startGeminiOAuth() {
+        if (this.oauthFlow) {
+            throw new AuthConflictError('OAuth already in progress');
+        }
+        this.effectiveAuthType = AuthType.LOGIN_WITH_GOOGLE;
+        this.lastErrorMessage = null;
+        const { authUrl, waitForCompletion, cancel } = await beginGeminiOAuthLoopbackFlow(this.config);
+        this.oauthFlow = { waitForCompletion, cancel };
+        // Do not block the request; update auth in the background.
+        void waitForCompletion
+            .then(async () => {
+            await this.config.refreshAuth(AuthType.LOGIN_WITH_GOOGLE);
+            this.lastErrorMessage = null;
+            this.lastErrorCode = undefined;
+        })
+            .catch((err) => {
+            const error = err instanceof Error ? err : new Error('OAuth failed');
+            const { message, code } = this.mapOAuthError(error);
+            this.lastErrorMessage = message;
+            this.lastErrorCode = code;
+            logger.warn('[LlmAuthManager] OAuth did not complete:', {
+                message,
+                code,
+            });
+        })
+            .finally(() => {
+            this.oauthFlow = null;
+        });
+        return { authUrl };
+    }
+    async cancelGeminiOAuth() {
+        if (this.oauthFlow) {
+            const cancel = this.oauthFlow.cancel;
+            this.oauthFlow = null;
+            try {
+                cancel();
+            }
+            catch (err) {
+                logger.warn('[LlmAuthManager] OAuth cancel threw:', err);
+            }
+        }
+        this.lastErrorMessage = null;
+        this.lastErrorCode = undefined;
+        return this.getStatus();
+    }
+    async useGeminiVertex() {
+        this.effectiveAuthType = AuthType.USE_VERTEX_AI;
+        const hasVertexEnv = (process.env['GOOGLE_CLOUD_PROJECT'] &&
+            process.env['GOOGLE_CLOUD_LOCATION']) ||
+            process.env['GOOGLE_API_KEY'];
+        if (!hasVertexEnv) {
+            return {
+                status: 'required',
+                authType: AuthType.USE_VERTEX_AI,
+                message: 'Vertex AI requires either GOOGLE_CLOUD_PROJECT + GOOGLE_CLOUD_LOCATION, or GOOGLE_API_KEY (express mode).',
+            };
+        }
+        await this.config.refreshAuth(AuthType.USE_VERTEX_AI);
+        return this.getStatus();
+    }
+    async clearGeminiAuth() {
+        // Cancel any in-progress OAuth flow
+        if (this.oauthFlow) {
+            const cancel = this.oauthFlow.cancel;
+            this.oauthFlow = null;
+            try {
+                cancel();
+            }
+            catch (err) {
+                logger.warn('[LlmAuthManager] OAuth cancel during clear threw:', err);
+            }
+        }
+        // Clear OAuth credentials
+        try {
+            await clearCachedCredentialFile();
+        }
+        catch (err) {
+            logger.warn('[LlmAuthManager] Failed to clear cached credentials:', err);
+        }
+        // Reset effective auth type to undefined to force re-selection
+        this.effectiveAuthType = undefined;
+        this.lastErrorMessage = null;
+        this.lastErrorCode = undefined;
+        // Try to refresh with undefined auth type, which should fail gracefully
+        try {
+            await this.config.refreshAuth(undefined);
+        }
+        catch (err) {
+            // Expected to fail when no auth is configured
+        }
+        return this.getStatus();
+    }
+    mapOAuthError(error) {
+        const message = error.message.toLowerCase();
+        if (message.includes('timeout') || message.includes('timed out')) {
+            return {
+                message: 'The sign-in request timed out. Please try again.',
+                code: 'timeout',
+            };
+        }
+        if (message.includes('denied') || message.includes('access_denied')) {
+            return {
+                message: 'Sign-in was denied. Please try again and grant the requested permissions.',
+                code: 'denied',
+            };
+        }
+        if (message.includes('state') && message.includes('mismatch')) {
+            return {
+                message: 'Security error occurred during sign-in. Please try again.',
+                code: 'state_mismatch',
+            };
+        }
+        if (message.includes('bind') ||
+            message.includes('port') ||
+            message.includes('address')) {
+            return {
+                message: 'Could not start local server for sign-in. Please check if another application is using the required port.',
+                code: 'server_bind_failed',
+            };
+        }
+        if (message.includes('token') ||
+            message.includes('exchange') ||
+            message.includes('authorization code')) {
+            return {
+                message: 'Failed to exchange authorization code for access token. Please try again.',
+                code: 'token_exchange_failed',
+            };
+        }
+        if (message.includes('network') ||
+            message.includes('fetch') ||
+            message.includes('connection')) {
+            return {
+                message: 'Network error occurred. Please check your internet connection and try again.',
+                code: 'network_error',
+            };
+        }
+        return {
+            message: 'An unexpected error occurred during sign-in. Please try again.',
+            code: 'network_error',
+        };
+    }
+}
+//# sourceMappingURL=llmAuthManager.js.map

package/dist/src/auth/llmAuthManager.js.map

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

package/dist/src/auth/llmAuthManager.test.d.ts

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

package/dist/src/auth/llmAuthManager.test.js

@@ -0,0 +1,92 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { AuthType } from '@terminai/core';
+import { AuthConflictError, LlmAuthManager } from './llmAuthManager.js';
+const mockCheck = vi.hoisted(() => vi.fn());
+const mockBeginFlow = vi.hoisted(() => vi.fn());
+const mockSaveApiKey = vi.hoisted(() => vi.fn());
+vi.mock('@terminai/core', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        checkGeminiAuthStatusNonInteractive: mockCheck,
+        beginGeminiOAuthLoopbackFlow: mockBeginFlow,
+        saveApiKey: mockSaveApiKey,
+    };
+});
+describe('LlmAuthManager', () => {
+    let mockConfig;
+    beforeEach(() => {
+        mockConfig = {
+            // Config is heavyweight; we only need refreshAuth for these unit tests.
+            refreshAuth: vi.fn().mockResolvedValue(undefined),
+            getProxy: vi.fn().mockReturnValue(undefined),
+        };
+        mockCheck.mockResolvedValue({ status: 'required' });
+        mockSaveApiKey.mockResolvedValue(undefined);
+        delete process.env['GOOGLE_CLOUD_PROJECT'];
+        delete process.env['GOOGLE_CLOUD_LOCATION'];
+        delete process.env['GOOGLE_API_KEY'];
+    });
+    afterEach(() => {
+        vi.resetAllMocks();
+    });
+    it('reports in_progress after starting OAuth', async () => {
+        const waitForCompletion = new Promise(() => { });
+        const cancel = vi.fn();
+        mockBeginFlow.mockResolvedValue({
+            authUrl: 'https://example.test/auth',
+            waitForCompletion,
+            cancel,
+        });
+        const manager = new LlmAuthManager({
+            config: mockConfig,
+            getSelectedAuthType: () => AuthType.LOGIN_WITH_GOOGLE,
+        });
+        const start = await manager.startGeminiOAuth();
+        expect(start.authUrl).toBe('https://example.test/auth');
+        const status = await manager.getStatus();
+        expect(status.status).toBe('in_progress');
+        expect(status.authType).toBe(AuthType.LOGIN_WITH_GOOGLE);
+    });
+    it('prevents starting a second OAuth flow concurrently', async () => {
+        const waitForCompletion = new Promise(() => { });
+        mockBeginFlow.mockResolvedValue({
+            authUrl: 'https://example.test/auth',
+            waitForCompletion,
+            cancel: vi.fn(),
+        });
+        const manager = new LlmAuthManager({
+            config: mockConfig,
+            getSelectedAuthType: () => AuthType.LOGIN_WITH_GOOGLE,
+        });
+        await manager.startGeminiOAuth();
+        await expect(manager.startGeminiOAuth()).rejects.toBeInstanceOf(AuthConflictError);
+    });
+    it('submits Gemini API key via keychain and refreshAuth', async () => {
+        mockCheck.mockResolvedValue({ status: 'ok' });
+        const manager = new LlmAuthManager({
+            config: mockConfig,
+            getSelectedAuthType: () => AuthType.USE_GEMINI,
+        });
+        const status = await manager.submitGeminiApiKey('  test-key  ');
+        expect(mockSaveApiKey).toHaveBeenCalledWith('test-key');
+        expect(mockConfig.refreshAuth).toHaveBeenCalledWith(AuthType.USE_GEMINI);
+        expect(status.status).toBe('ok');
+    });
+    it('returns required for Vertex when env is missing', async () => {
+        const manager = new LlmAuthManager({
+            config: mockConfig,
+            getSelectedAuthType: () => AuthType.USE_VERTEX_AI,
+        });
+        const status = await manager.useGeminiVertex();
+        expect(status.status).toBe('required');
+        expect(status.authType).toBe(AuthType.USE_VERTEX_AI);
+    });
+});
+//# sourceMappingURL=llmAuthManager.test.js.map

package/dist/src/auth/llmAuthManager.test.js.map

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

package/dist/src/commands/command-registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Command } from './types.js';
+declare class CommandRegistry {
+    private readonly commands;
+    constructor();
+    register(command: Command): void;
+    get(commandName: string): Command | undefined;
+    getAllCommands(): Command[];
+}
+export declare const commandRegistry: CommandRegistry;
+export {};

package/dist/src/commands/command-registry.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ExtensionsCommand } from './extensions.js';
+import { InitCommand } from './init.js';
+import { RestoreCommand } from './restore.js';
+class CommandRegistry {
+    commands = new Map();
+    constructor() {
+        this.register(new ExtensionsCommand());
+        this.register(new RestoreCommand());
+        this.register(new InitCommand());
+    }
+    register(command) {
+        if (this.commands.has(command.name)) {
+            console.warn(`Command ${command.name} already registered. Skipping.`);
+            return;
+        }
+        this.commands.set(command.name, command);
+        for (const subCommand of command.subCommands ?? []) {
+            this.register(subCommand);
+        }
+    }
+    get(commandName) {
+        return this.commands.get(commandName);
+    }
+    getAllCommands() {
+        return [...this.commands.values()];
+    }
+}
+export const commandRegistry = new CommandRegistry();
+//# sourceMappingURL=command-registry.js.map

package/dist/src/commands/command-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../../src/commands/command-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,eAAe;IACF,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEvD;QACE,IAAI,CAAC,QAAQ,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,OAAgB;QACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,IAAI,gCAAgC,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEzC,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,GAAG,CAAC,WAAmB;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/src/commands/command-registry.test.d.ts

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

package/dist/src/commands/command-registry.test.js

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+describe('CommandRegistry', () => {
+    const mockListExtensionsCommandInstance = {
+        name: 'extensions list',
+        description: 'Lists all installed extensions.',
+        execute: vi.fn(),
+    };
+    const mockListExtensionsCommand = vi.fn(() => mockListExtensionsCommandInstance);
+    const mockExtensionsCommandInstance = {
+        name: 'extensions',
+        description: 'Manage extensions.',
+        execute: vi.fn(),
+        subCommands: [mockListExtensionsCommandInstance],
+    };
+    const mockExtensionsCommand = vi.fn(() => mockExtensionsCommandInstance);
+    beforeEach(async () => {
+        vi.resetModules();
+        vi.doMock('./extensions.js', () => ({
+            ExtensionsCommand: mockExtensionsCommand,
+            ListExtensionsCommand: mockListExtensionsCommand,
+        }));
+    });
+    it('should register ExtensionsCommand on initialization', async () => {
+        const { commandRegistry } = await import('./command-registry.js');
+        expect(mockExtensionsCommand).toHaveBeenCalled();
+        const command = commandRegistry.get('extensions');
+        expect(command).toBe(mockExtensionsCommandInstance);
+    });
+    it('should register sub commands on initialization', async () => {
+        const { commandRegistry } = await import('./command-registry.js');
+        const command = commandRegistry.get('extensions list');
+        expect(command).toBe(mockListExtensionsCommandInstance);
+    });
+    it('get() should return undefined for a non-existent command', async () => {
+        const { commandRegistry } = await import('./command-registry.js');
+        const command = commandRegistry.get('non-existent');
+        expect(command).toBeUndefined();
+    });
+    it('register() should register a new command', async () => {
+        const { commandRegistry } = await import('./command-registry.js');
+        const mockCommand = {
+            name: 'test-command',
+            description: '',
+            execute: vi.fn(),
+        };
+        commandRegistry.register(mockCommand);
+        const command = commandRegistry.get('test-command');
+        expect(command).toBe(mockCommand);
+    });
+    it('register() should register a nested command', async () => {
+        const { commandRegistry } = await import('./command-registry.js');
+        const mockSubSubCommand = {
+            name: 'test-command-sub-sub',
+            description: '',
+            execute: vi.fn(),
+        };
+        const mockSubCommand = {
+            name: 'test-command-sub',
+            description: '',
+            execute: vi.fn(),
+            subCommands: [mockSubSubCommand],
+        };
+        const mockCommand = {
+            name: 'test-command',
+            description: '',
+            execute: vi.fn(),
+            subCommands: [mockSubCommand],
+        };
+        commandRegistry.register(mockCommand);
+        const command = commandRegistry.get('test-command');
+        const subCommand = commandRegistry.get('test-command-sub');
+        const subSubCommand = commandRegistry.get('test-command-sub-sub');
+        expect(command).toBe(mockCommand);
+        expect(subCommand).toBe(mockSubCommand);
+        expect(subSubCommand).toBe(mockSubSubCommand);
+    });
+    it('register() should not enter an infinite loop with a cyclic command', async () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const { commandRegistry } = await import('./command-registry.js');
+        const mockCommand = {
+            name: 'cyclic-command',
+            description: '',
+            subCommands: [],
+            execute: vi.fn(),
+        };
+        mockCommand.subCommands?.push(mockCommand); // Create cycle
+        commandRegistry.register(mockCommand);
+        expect(commandRegistry.get('cyclic-command')).toBe(mockCommand);
+        expect(warnSpy).toHaveBeenCalledWith('Command cyclic-command already registered. Skipping.');
+        // If the test finishes, it means we didn't get into an infinite loop.
+        warnSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=command-registry.test.js.map

package/dist/src/commands/command-registry.test.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * 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[];
+    readonly topLevel = true;
+    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>;
+}

package/dist/src/commands/extensions.js

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { listExtensions } from '@terminai/core';
+export class ExtensionsCommand {
+    name = 'extensions';
+    description = 'Manage extensions.';
+    subCommands = [new ListExtensionsCommand()];
+    topLevel = true;
+    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.config);
+        const data = extensions.length ? extensions : 'No extensions installed.';
+        return { name: this.name, data };
+    }
+}
+//# sourceMappingURL=extensions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../../src/commands/extensions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOhD,MAAM,OAAO,iBAAiB;IACnB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,oBAAoB,CAAC;IACnC,WAAW,GAAG,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAC5C,QAAQ,GAAG,IAAI,CAAC;IAEzB,KAAK,CAAC,OAAO,CACX,OAAuB,EACvB,CAAW;QAEX,OAAO,IAAI,qBAAqB,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IACvB,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GAAG,iCAAiC,CAAC;IAEzD,KAAK,CAAC,OAAO,CACX,OAAuB,EACvB,CAAW;QAEX,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,0BAA0B,CAAC;QAEzE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;CACF"}

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

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

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

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { ExtensionsCommand, ListExtensionsCommand } from './extensions.js';
+const mockListExtensions = vi.hoisted(() => vi.fn());
+vi.mock('@terminai/core', async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        listExtensions: mockListExtensions,
+    };
+});
+describe('ExtensionsCommand', () => {
+    it('should have the correct name', () => {
+        const command = new ExtensionsCommand();
+        expect(command.name).toEqual('extensions');
+    });
+    it('should have the correct description', () => {
+        const command = new ExtensionsCommand();
+        expect(command.description).toEqual('Manage extensions.');
+    });
+    it('should have "extensions list" as a subcommand', () => {
+        const command = new ExtensionsCommand();
+        expect(command.subCommands.map((c) => c.name)).toContain('extensions list');
+    });
+    it('should be a top-level command', () => {
+        const command = new ExtensionsCommand();
+        expect(command.topLevel).toBe(true);
+    });
+    it('should default to listing extensions', async () => {
+        const command = new ExtensionsCommand();
+        const mockConfig = { config: {} };
+        const mockExtensions = [{ name: 'ext1' }];
+        mockListExtensions.mockReturnValue(mockExtensions);
+        const result = await command.execute(mockConfig, []);
+        expect(result).toEqual({ name: 'extensions list', data: mockExtensions });
+        expect(mockListExtensions).toHaveBeenCalledWith(mockConfig.config);
+    });
+});
+describe('ListExtensionsCommand', () => {
+    it('should have the correct name', () => {
+        const command = new ListExtensionsCommand();
+        expect(command.name).toEqual('extensions list');
+    });
+    it('should call listExtensions with the provided config', async () => {
+        const command = new ListExtensionsCommand();
+        const mockConfig = { config: {} };
+        const mockExtensions = [{ name: 'ext1' }];
+        mockListExtensions.mockReturnValue(mockExtensions);
+        const result = await command.execute(mockConfig, []);
+        expect(result).toEqual({ name: 'extensions list', data: mockExtensions });
+        expect(mockListExtensions).toHaveBeenCalledWith(mockConfig.config);
+    });
+    it('should return a message when no extensions are installed', async () => {
+        const command = new ListExtensionsCommand();
+        const mockConfig = { config: {} };
+        mockListExtensions.mockReturnValue([]);
+        const result = await command.execute(mockConfig, []);
+        expect(result).toEqual({
+            name: 'extensions list',
+            data: 'No extensions installed.',
+        });
+        expect(mockListExtensions).toHaveBeenCalledWith(mockConfig.config);
+    });
+});
+//# sourceMappingURL=extensions.test.js.map

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

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