@terminai/a2a-server 0.21.0

package/dist/src/commands/init.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, CommandContext, CommandExecutionResponse } from './types.js';
+export declare class InitCommand implements Command {
+    name: string;
+    description: string;
+    requiresWorkspace: boolean;
+    streaming: boolean;
+    private handleMessageResult;
+    private handleSubmitPromptResult;
+    execute(context: CommandContext, _args?: string[]): Promise<CommandExecutionResponse>;
+}

package/dist/src/commands/init.js

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CoderAgentEvent } from '../types.js';
+import { performInit } from '@terminai/core';
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../utils/logger.js';
+export class InitCommand {
+    name = 'init';
+    description = 'Analyzes the project and creates a tailored terminaI.md file';
+    requiresWorkspace = true;
+    streaming = true;
+    handleMessageResult(result, context, eventBus, taskId, contextId) {
+        const statusState = result.messageType === 'error' ? 'failed' : 'completed';
+        const eventType = result.messageType === 'error'
+            ? CoderAgentEvent.StateChangeEvent
+            : CoderAgentEvent.TextContentEvent;
+        const event = {
+            kind: 'status-update',
+            taskId,
+            contextId,
+            status: {
+                state: statusState,
+                message: {
+                    kind: 'message',
+                    role: 'agent',
+                    parts: [{ kind: 'text', text: result.content }],
+                    messageId: uuidv4(),
+                    taskId,
+                    contextId,
+                },
+                timestamp: new Date().toISOString(),
+            },
+            final: true,
+            metadata: {
+                coderAgent: { kind: eventType },
+                model: context.config.getModel(),
+            },
+        };
+        logger.info('[EventBus event]: ', event);
+        eventBus.publish(event);
+        return {
+            name: this.name,
+            data: result,
+        };
+    }
+    async handleSubmitPromptResult(result, context, geminiMdPath, eventBus, taskId, contextId) {
+        fs.writeFileSync(geminiMdPath, '', 'utf8');
+        if (!context.agentExecutor) {
+            throw new Error('Agent executor not found in context.');
+        }
+        const agentExecutor = context.agentExecutor;
+        const agentSettings = {
+            kind: CoderAgentEvent.StateAgentSettingsEvent,
+            workspacePath: process.env['CODER_AGENT_WORKSPACE_PATH'],
+            autoExecute: true,
+        };
+        if (typeof result.content !== 'string') {
+            throw new Error('Init command content must be a string.');
+        }
+        const promptText = result.content;
+        const requestContext = {
+            userMessage: {
+                kind: 'message',
+                role: 'user',
+                parts: [{ kind: 'text', text: promptText }],
+                messageId: uuidv4(),
+                taskId,
+                contextId,
+                metadata: {
+                    coderAgent: agentSettings,
+                },
+            },
+            taskId,
+            contextId,
+        };
+        // The executor will handle the entire agentic loop, including
+        // creating the task, streaming responses, and handling tools.
+        await agentExecutor.execute(requestContext, eventBus);
+        return {
+            name: this.name,
+            data: geminiMdPath,
+        };
+    }
+    async execute(context, _args = []) {
+        if (!context.eventBus) {
+            return {
+                name: this.name,
+                data: 'Use executeStream to get streaming results.',
+            };
+        }
+        const geminiMdPath = path.join(process.env['CODER_AGENT_WORKSPACE_PATH'], 'terminaI.md');
+        const result = performInit(fs.existsSync(geminiMdPath));
+        const taskId = uuidv4();
+        const contextId = uuidv4();
+        switch (result.type) {
+            case 'message':
+                return this.handleMessageResult(result, context, context.eventBus, taskId, contextId);
+            case 'submit_prompt':
+                return this.handleSubmitPromptResult(result, context, geminiMdPath, context.eventBus, taskId, contextId);
+            default:
+                throw new Error('Unknown result type from performInit');
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

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

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

package/dist/src/commands/init.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/init.test.js

@@ -0,0 +1,146 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { InitCommand } from './init.js';
+import { performInit } from '@terminai/core';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CoderAgentExecutor } from '../agent/executor.js';
+import { CoderAgentEvent } from '../types.js';
+import { createMockConfig } from '../utils/testing_utils.js';
+import { logger } from '../utils/logger.js';
+vi.mock('@terminai/core', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        performInit: vi.fn(),
+    };
+});
+vi.mock('node:fs', () => ({
+    existsSync: vi.fn(),
+    writeFileSync: vi.fn(),
+}));
+vi.mock('../agent/executor.js', () => ({
+    CoderAgentExecutor: vi.fn().mockImplementation(() => ({
+        execute: vi.fn(),
+    })),
+}));
+vi.mock('../utils/logger.js', () => ({
+    logger: {
+        info: vi.fn(),
+        error: vi.fn(),
+    },
+}));
+describe('InitCommand', () => {
+    let eventBus;
+    let command;
+    let context;
+    let publishSpy;
+    let mockExecute;
+    const mockWorkspacePath = path.resolve('/tmp');
+    beforeEach(() => {
+        process.env['CODER_AGENT_WORKSPACE_PATH'] = mockWorkspacePath;
+        eventBus = {
+            publish: vi.fn(),
+        };
+        command = new InitCommand();
+        const mockConfig = createMockConfig({
+            getModel: () => 'gemini-pro',
+        });
+        const mockExecutorInstance = new CoderAgentExecutor();
+        context = {
+            config: mockConfig,
+            agentExecutor: mockExecutorInstance,
+            eventBus,
+        };
+        publishSpy = vi.spyOn(eventBus, 'publish');
+        mockExecute = vi.fn();
+        vi.spyOn(mockExecutorInstance, 'execute').mockImplementation(mockExecute);
+        vi.clearAllMocks();
+    });
+    it('has requiresWorkspace set to true', () => {
+        expect(command.requiresWorkspace).toBe(true);
+    });
+    describe('execute', () => {
+        it('handles info from performInit', async () => {
+            vi.mocked(performInit).mockReturnValue({
+                type: 'message',
+                messageType: 'info',
+                content: 'terminaI.md already exists.',
+            });
+            await command.execute(context, []);
+            expect(logger.info).toHaveBeenCalledWith('[EventBus event]: ', expect.objectContaining({
+                kind: 'status-update',
+                status: expect.objectContaining({
+                    state: 'completed',
+                    message: expect.objectContaining({
+                        parts: [{ kind: 'text', text: 'terminaI.md already exists.' }],
+                    }),
+                }),
+            }));
+            expect(publishSpy).toHaveBeenCalledWith(expect.objectContaining({
+                kind: 'status-update',
+                status: expect.objectContaining({
+                    state: 'completed',
+                    message: expect.objectContaining({
+                        parts: [{ kind: 'text', text: 'terminaI.md already exists.' }],
+                    }),
+                }),
+            }));
+        });
+        it('handles error from performInit', async () => {
+            vi.mocked(performInit).mockReturnValue({
+                type: 'message',
+                messageType: 'error',
+                content: 'An error occurred.',
+            });
+            await command.execute(context, []);
+            expect(publishSpy).toHaveBeenCalledWith(expect.objectContaining({
+                kind: 'status-update',
+                status: expect.objectContaining({
+                    state: 'failed',
+                    message: expect.objectContaining({
+                        parts: [{ kind: 'text', text: 'An error occurred.' }],
+                    }),
+                }),
+            }));
+        });
+        describe('when handling submit_prompt', () => {
+            beforeEach(() => {
+                vi.mocked(performInit).mockReturnValue({
+                    type: 'submit_prompt',
+                    content: 'Create a new terminaI.md file.',
+                });
+            });
+            it('writes the file and executes the agent', async () => {
+                await command.execute(context, []);
+                expect(fs.writeFileSync).toHaveBeenCalledWith(path.join(mockWorkspacePath, 'terminaI.md'), '', 'utf8');
+                expect(mockExecute).toHaveBeenCalled();
+            });
+            it('passes autoExecute to the agent executor', async () => {
+                await command.execute(context, []);
+                expect(mockExecute).toHaveBeenCalledWith(expect.objectContaining({
+                    userMessage: expect.objectContaining({
+                        parts: expect.arrayContaining([
+                            expect.objectContaining({
+                                text: 'Create a new terminaI.md file.',
+                            }),
+                        ]),
+                        metadata: {
+                            coderAgent: {
+                                kind: CoderAgentEvent.StateAgentSettingsEvent,
+                                workspacePath: mockWorkspacePath,
+                                autoExecute: true,
+                            },
+                        },
+                    }),
+                }), eventBus);
+            });
+        });
+    });
+});
+//# sourceMappingURL=init.test.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * @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 RestoreCommand implements Command {
+    readonly name = "restore";
+    readonly description = "Restore to a previous checkpoint, or list available checkpoints to restore. This will reset the conversation and file history to the state it was in when the checkpoint was created";
+    readonly topLevel = true;
+    readonly requiresWorkspace = true;
+    readonly subCommands: ListCheckpointsCommand[];
+    execute(context: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}
+export declare class ListCheckpointsCommand implements Command {
+    readonly name = "restore list";
+    readonly description = "Lists all available checkpoints.";
+    readonly topLevel = false;
+    execute(context: CommandContext): Promise<CommandExecutionResponse>;
+}

package/dist/src/commands/restore.js

@@ -0,0 +1,126 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getCheckpointInfoList, getToolCallDataSchema, isNodeError, performRestore, } from '@terminai/core';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export class RestoreCommand {
+    name = 'restore';
+    description = 'Restore to a previous checkpoint, or list available checkpoints to restore. This will reset the conversation and file history to the state it was in when the checkpoint was created';
+    topLevel = true;
+    requiresWorkspace = true;
+    subCommands = [new ListCheckpointsCommand()];
+    async execute(context, args) {
+        const { config, git: gitService } = context;
+        const argsStr = args.join(' ');
+        try {
+            if (!argsStr) {
+                return {
+                    name: this.name,
+                    data: {
+                        type: 'message',
+                        messageType: 'error',
+                        content: 'Please provide a checkpoint name to restore.',
+                    },
+                };
+            }
+            const selectedFile = argsStr.endsWith('.json')
+                ? argsStr
+                : `${argsStr}.json`;
+            const checkpointDir = config.storage.getProjectTempCheckpointsDir();
+            const filePath = path.join(checkpointDir, selectedFile);
+            let data;
+            try {
+                data = await fs.readFile(filePath, 'utf-8');
+            }
+            catch (error) {
+                if (isNodeError(error) && error.code === 'ENOENT') {
+                    return {
+                        name: this.name,
+                        data: {
+                            type: 'message',
+                            messageType: 'error',
+                            content: `File not found: ${selectedFile}`,
+                        },
+                    };
+                }
+                throw error;
+            }
+            const toolCallData = JSON.parse(data);
+            const ToolCallDataSchema = getToolCallDataSchema();
+            const parseResult = ToolCallDataSchema.safeParse(toolCallData);
+            if (!parseResult.success) {
+                return {
+                    name: this.name,
+                    data: {
+                        type: 'message',
+                        messageType: 'error',
+                        content: 'Checkpoint file is invalid or corrupted.',
+                    },
+                };
+            }
+            const restoreResultGenerator = performRestore(parseResult.data, gitService);
+            const restoreResult = [];
+            for await (const result of restoreResultGenerator) {
+                restoreResult.push(result);
+            }
+            return {
+                name: this.name,
+                data: restoreResult,
+            };
+        }
+        catch (_error) {
+            return {
+                name: this.name,
+                data: {
+                    type: 'message',
+                    messageType: 'error',
+                    content: 'An unexpected error occurred during restore.',
+                },
+            };
+        }
+    }
+}
+export class ListCheckpointsCommand {
+    name = 'restore list';
+    description = 'Lists all available checkpoints.';
+    topLevel = false;
+    async execute(context) {
+        const { config } = context;
+        try {
+            const checkpointDir = config.storage.getProjectTempCheckpointsDir();
+            await fs.mkdir(checkpointDir, { recursive: true });
+            const files = await fs.readdir(checkpointDir);
+            const jsonFiles = files.filter((file) => file.endsWith('.json'));
+            const checkpointFiles = new Map();
+            for (const file of jsonFiles) {
+                const filePath = path.join(checkpointDir, file);
+                const data = await fs.readFile(filePath, 'utf-8');
+                checkpointFiles.set(file, data);
+            }
+            const checkpointInfoList = getCheckpointInfoList(checkpointFiles);
+            return {
+                name: this.name,
+                data: {
+                    type: 'message',
+                    messageType: 'info',
+                    content: JSON.stringify(checkpointInfoList),
+                },
+            };
+        }
+        catch (_error) {
+            return {
+                name: this.name,
+                data: {
+                    type: 'message',
+                    messageType: 'error',
+                    content: 'An unexpected error occurred while listing checkpoints.',
+                },
+            };
+        }
+    }
+}
+//# sourceMappingURL=restore.js.map

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

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

package/dist/src/commands/restore.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/restore.test.js

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { RestoreCommand, ListCheckpointsCommand } from './restore.js';
+import { createMockConfig } from '../utils/testing_utils.js';
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+const mockPerformRestore = vi.hoisted(() => vi.fn());
+const mockLoggerInfo = vi.hoisted(() => vi.fn());
+const mockGetCheckpointInfoList = vi.hoisted(() => vi.fn());
+vi.mock('@terminai/core', async (importOriginal) => {
+    const original = await importOriginal();
+    return {
+        ...original,
+        performRestore: mockPerformRestore,
+        getCheckpointInfoList: mockGetCheckpointInfoList,
+    };
+});
+const mockFs = vi.hoisted(() => ({
+    readFile: vi.fn(),
+    readdir: vi.fn(),
+    mkdir: vi.fn(),
+}));
+vi.mock('node:fs/promises', () => mockFs);
+vi.mock('../utils/logger.js', () => ({
+    logger: {
+        info: mockLoggerInfo,
+    },
+}));
+describe('RestoreCommand', () => {
+    const mockConfig = {
+        config: createMockConfig(),
+        git: {},
+    };
+    it('should return error if no checkpoint name is provided', async () => {
+        const command = new RestoreCommand();
+        const result = await command.execute(mockConfig, []);
+        expect(result.data).toEqual({
+            type: 'message',
+            messageType: 'error',
+            content: 'Please provide a checkpoint name to restore.',
+        });
+    });
+    it('should restore a checkpoint when a valid file is provided', async () => {
+        const command = new RestoreCommand();
+        const toolCallData = {
+            toolCall: {
+                name: 'test-tool',
+                args: {},
+            },
+            history: [],
+            clientHistory: [],
+            commitHash: '123',
+        };
+        mockFs.readFile.mockResolvedValue(JSON.stringify(toolCallData));
+        const restoreContent = {
+            type: 'message',
+            messageType: 'info',
+            content: 'Restored',
+        };
+        mockPerformRestore.mockReturnValue((async function* () {
+            yield restoreContent;
+        })());
+        const result = await command.execute(mockConfig, ['checkpoint1.json']);
+        expect(result.data).toEqual([restoreContent]);
+    });
+    it('should show "file not found" error for a non-existent checkpoint', async () => {
+        const command = new RestoreCommand();
+        const error = new Error('File not found');
+        error.code = 'ENOENT';
+        mockFs.readFile.mockRejectedValue(error);
+        const result = await command.execute(mockConfig, ['checkpoint2.json']);
+        expect(result.data).toEqual({
+            type: 'message',
+            messageType: 'error',
+            content: 'File not found: checkpoint2.json',
+        });
+    });
+    it('should handle invalid JSON in checkpoint file', async () => {
+        const command = new RestoreCommand();
+        mockFs.readFile.mockResolvedValue('invalid json');
+        const result = await command.execute(mockConfig, ['checkpoint1.json']);
+        expect(result.data.content).toContain('An unexpected error occurred during restore.');
+    });
+});
+describe('ListCheckpointsCommand', () => {
+    const mockConfig = {
+        config: createMockConfig(),
+    };
+    it('should list all available checkpoints', async () => {
+        const command = new ListCheckpointsCommand();
+        const checkpointInfo = [{ file: 'checkpoint1.json', description: 'Test' }];
+        mockFs.readdir.mockResolvedValue(['checkpoint1.json']);
+        mockFs.readFile.mockResolvedValue(JSON.stringify({ toolCall: { name: 'Test', args: {} } }));
+        mockGetCheckpointInfoList.mockReturnValue(checkpointInfo);
+        const result = await command.execute(mockConfig);
+        expect(result.data.content).toEqual(JSON.stringify(checkpointInfo));
+    });
+    it('should handle errors when listing checkpoints', async () => {
+        const command = new ListCheckpointsCommand();
+        mockFs.readdir.mockRejectedValue(new Error('Read error'));
+        const result = await command.execute(mockConfig);
+        expect(result.data.content).toContain('An unexpected error occurred while listing checkpoints.');
+    });
+});
+//# sourceMappingURL=restore.test.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ExecutionEventBus, AgentExecutor } from '@a2a-js/sdk/server';
+import type { Config, GitService } from '@terminai/core';
+export interface CommandContext {
+    config: Config;
+    git?: GitService;
+    agentExecutor?: AgentExecutor;
+    eventBus?: ExecutionEventBus;
+}
+export interface CommandArgument {
+    readonly name: string;
+    readonly description: string;
+    readonly isRequired?: boolean;
+}
+export interface Command {
+    readonly name: string;
+    readonly description: string;
+    readonly arguments?: CommandArgument[];
+    readonly subCommands?: Command[];
+    readonly topLevel?: boolean;
+    readonly requiresWorkspace?: boolean;
+    readonly streaming?: boolean;
+    execute(config: CommandContext, args: string[]): Promise<CommandExecutionResponse>;
+}
+export interface CommandExecutionResponse {
+    readonly name: string;
+    readonly data: unknown;
+}

package/dist/src/commands/types.js

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

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Config, type ExtensionLoader } from '@terminai/core';
+import type { LoadedSettings } from './settings.js';
+import { type AgentSettings } from '../types.js';
+export interface LoadConfigOptions {
+    /**
+     * When true, the server will start without calling `config.refreshAuth(...)`.
+     * This enables "deferred auth" flows (e.g. Desktop sidecar) where the client
+     * completes LLM auth after the server boots.
+     */
+    readonly deferLlmAuth?: boolean;
+}
+export declare function loadConfig(loadedSettings: LoadedSettings, extensionLoader: ExtensionLoader, taskId: string, targetDirOverride?: string, options?: LoadConfigOptions): Promise<Config>;
+export declare function setTargetDir(agentSettings: AgentSettings | undefined): string;
+/**
+ * Loads environment variables from .env file.
+ * Uses Core's findEnvFile for parity with CLI.
+ */
+export declare function loadEnvironment(startDir?: string): void;