@terminai/core 0.21.0

package/dist/src/agents/registry.js

@@ -0,0 +1,210 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Storage } from '../config/storage.js';
+import { coreEvents, CoreEvent } from '../utils/events.js';
+import { loadAgentsFromDirectory } from './toml-loader.js';
+import { CodebaseInvestigatorAgent } from './codebase-investigator.js';
+import { IntrospectionAgent } from './introspection-agent.js';
+import {} from 'zod';
+import { debugLogger } from '../utils/debugLogger.js';
+import { DEFAULT_GEMINI_MODEL, GEMINI_MODEL_ALIAS_AUTO, PREVIEW_GEMINI_FLASH_MODEL, isPreviewModel, } from '../config/models.js';
+/**
+ * Returns the model config alias for a given agent definition.
+ */
+export function getModelConfigAlias(definition) {
+    return `${definition.name}-config`;
+}
+/**
+ * Manages the discovery, loading, validation, and registration of
+ * AgentDefinitions.
+ */
+export class AgentRegistry {
+    config;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    agents = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Discovers and loads agents.
+     */
+    async initialize() {
+        this.loadBuiltInAgents();
+        coreEvents.on(CoreEvent.ModelChanged, () => {
+            this.refreshAgents();
+        });
+        if (!this.config.isAgentsEnabled()) {
+            return;
+        }
+        // Load user-level agents: ~/.gemini/agents/
+        const userAgentsDir = Storage.getUserAgentsDir();
+        const userAgents = await loadAgentsFromDirectory(userAgentsDir);
+        for (const error of userAgents.errors) {
+            debugLogger.warn(`[AgentRegistry] Error loading user agent: ${error.message}`);
+            coreEvents.emitFeedback('error', `Agent loading error: ${error.message}`);
+        }
+        for (const agent of userAgents.agents) {
+            this.registerAgent(agent);
+        }
+        // Load project-level agents: .gemini/agents/ (relative to Project Root)
+        const folderTrustEnabled = this.config.getFolderTrust();
+        const isTrustedFolder = this.config.isTrustedFolder();
+        if (!folderTrustEnabled || isTrustedFolder) {
+            const projectAgentsDir = this.config.storage.getProjectAgentsDir();
+            const projectAgents = await loadAgentsFromDirectory(projectAgentsDir);
+            for (const error of projectAgents.errors) {
+                coreEvents.emitFeedback('error', `Agent loading error: ${error.message}`);
+            }
+            for (const agent of projectAgents.agents) {
+                this.registerAgent(agent);
+            }
+        }
+        else {
+            coreEvents.emitFeedback('info', 'Skipping project agents due to untrusted folder. To enable, ensure that the project root is trusted.');
+        }
+        if (this.config.getDebugMode()) {
+            debugLogger.log(`[AgentRegistry] Initialized with ${this.agents.size} agents.`);
+        }
+    }
+    loadBuiltInAgents() {
+        const investigatorSettings = this.config.getCodebaseInvestigatorSettings();
+        const introspectionSettings = this.config.getIntrospectionAgentSettings();
+        // Only register the agent if it's enabled in the settings.
+        if (investigatorSettings?.enabled) {
+            let model;
+            const settingsModel = investigatorSettings.model;
+            // Check if the user explicitly set a model in the settings.
+            if (settingsModel && settingsModel !== GEMINI_MODEL_ALIAS_AUTO) {
+                model = settingsModel;
+            }
+            else {
+                // Use Preview Flash model if the main model is any of the preview models
+                // If the main model is not preview model, use default pro model.
+                model = isPreviewModel(this.config.getModel())
+                    ? PREVIEW_GEMINI_FLASH_MODEL
+                    : DEFAULT_GEMINI_MODEL;
+            }
+            const agentDef = {
+                ...CodebaseInvestigatorAgent,
+                modelConfig: {
+                    ...CodebaseInvestigatorAgent.modelConfig,
+                    model,
+                    thinkingBudget: investigatorSettings.thinkingBudget ??
+                        CodebaseInvestigatorAgent.modelConfig.thinkingBudget,
+                },
+                runConfig: {
+                    ...CodebaseInvestigatorAgent.runConfig,
+                    max_time_minutes: investigatorSettings.maxTimeMinutes ??
+                        CodebaseInvestigatorAgent.runConfig.max_time_minutes,
+                    max_turns: investigatorSettings.maxNumTurns ??
+                        CodebaseInvestigatorAgent.runConfig.max_turns,
+                },
+            };
+            this.registerAgent(agentDef);
+        }
+        // Register the introspection agent if it's explicitly enabled.
+        if (introspectionSettings.enabled) {
+            this.registerAgent(IntrospectionAgent);
+        }
+    }
+    refreshAgents() {
+        this.loadBuiltInAgents();
+        for (const agent of this.agents.values()) {
+            this.registerAgent(agent);
+        }
+    }
+    /**
+     * Registers an agent definition. If an agent with the same name exists,
+     * it will be overwritten, respecting the precedence established by the
+     * initialization order.
+     */
+    registerAgent(definition) {
+        // Basic validation
+        if (!definition.name || !definition.description) {
+            debugLogger.warn(`[AgentRegistry] Skipping invalid agent definition. Missing name or description.`);
+            return;
+        }
+        if (this.agents.has(definition.name) && this.config.getDebugMode()) {
+            debugLogger.log(`[AgentRegistry] Overriding agent '${definition.name}'`);
+        }
+        this.agents.set(definition.name, definition);
+        // Register model config.
+        // TODO(12916): Migrate sub-agents where possible to static configs.
+        if (definition.kind === 'local') {
+            const modelConfig = definition.modelConfig;
+            let model = modelConfig.model;
+            if (model === 'inherit') {
+                model = this.config.getModel();
+            }
+            const runtimeAlias = {
+                modelConfig: {
+                    model,
+                    generateContentConfig: {
+                        temperature: modelConfig.temp,
+                        topP: modelConfig.top_p,
+                        thinkingConfig: {
+                            includeThoughts: true,
+                            thinkingBudget: modelConfig.thinkingBudget ?? -1,
+                        },
+                    },
+                },
+            };
+            this.config.modelConfigService.registerRuntimeModelConfig(getModelConfigAlias(definition), runtimeAlias);
+        }
+        // Register configured remote A2A agents.
+        // TODO: Implement remote agent registration.
+    }
+    /**
+     * Retrieves an agent definition by name.
+     */
+    getDefinition(name) {
+        return this.agents.get(name);
+    }
+    /**
+     * Returns all active agent definitions.
+     */
+    getAllDefinitions() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Returns a list of all registered agent names.
+     */
+    getAllAgentNames() {
+        return Array.from(this.agents.keys());
+    }
+    /**
+     * Generates a description for the delegate_to_agent tool.
+     * Unlike getDirectoryContext() which is for system prompts,
+     * this is formatted for tool descriptions.
+     */
+    getToolDescription() {
+        if (this.agents.size === 0) {
+            return 'Delegates a task to a specialized sub-agent. No agents are currently available.';
+        }
+        const agentDescriptions = Array.from(this.agents.entries())
+            .map(([name, def]) => `- **${name}**: ${def.description}`)
+            .join('\n');
+        return `Delegates a task to a specialized sub-agent.\n\nAvailable agents:\n${agentDescriptions}`;
+    }
+    /**
+     * Generates a markdown "Phone Book" of available agents and their schemas.
+     * This MUST be injected into the System Prompt of the parent agent.
+     */
+    getDirectoryContext() {
+        if (this.agents.size === 0) {
+            return 'No sub-agents are currently available.';
+        }
+        let context = '## Available Sub-Agents\n';
+        context +=
+            'Use `delegate_to_agent` for complex tasks requiring specialized analysis.\n\n';
+        for (const [name, def] of this.agents) {
+            context += `- **${name}**: ${def.description}\n`;
+        }
+        return context;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/agents/registry.js.map

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

package/dist/src/agents/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/agents/registry.test.js

@@ -0,0 +1,334 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { AgentRegistry, getModelConfigAlias } from './registry.js';
+import { makeFakeConfig } from '../test-utils/config.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { coreEvents, CoreEvent } from '../utils/events.js';
+import { DEFAULT_GEMINI_FLASH_LITE_MODEL, GEMINI_MODEL_ALIAS_AUTO, PREVIEW_GEMINI_FLASH_MODEL, PREVIEW_GEMINI_MODEL, PREVIEW_GEMINI_MODEL_AUTO, } from '../config/models.js';
+import * as tomlLoader from './toml-loader.js';
+vi.mock('./toml-loader.js', () => ({
+    loadAgentsFromDirectory: vi
+        .fn()
+        .mockResolvedValue({ agents: [], errors: [] }),
+}));
+// A test-only subclass to expose the protected `registerAgent` method.
+class TestableAgentRegistry extends AgentRegistry {
+    testRegisterAgent(definition) {
+        this.registerAgent(definition);
+    }
+}
+// Define mock agent structures for testing registration logic
+const MOCK_AGENT_V1 = {
+    kind: 'local',
+    name: 'MockAgent',
+    description: 'Mock Description V1',
+    inputConfig: { inputs: {} },
+    modelConfig: { model: 'test', temp: 0, top_p: 1 },
+    runConfig: { max_time_minutes: 1 },
+    promptConfig: { systemPrompt: 'test' },
+};
+const MOCK_AGENT_V2 = {
+    ...MOCK_AGENT_V1,
+    description: 'Mock Description V2 (Updated)',
+};
+describe('AgentRegistry', () => {
+    let mockConfig;
+    let registry;
+    beforeEach(() => {
+        // Default configuration (debugMode: false)
+        mockConfig = makeFakeConfig();
+        registry = new TestableAgentRegistry(mockConfig);
+        vi.mocked(tomlLoader.loadAgentsFromDirectory).mockResolvedValue({
+            agents: [],
+            errors: [],
+        });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks(); // Restore spies after each test
+    });
+    describe('initialize', () => {
+        // TODO: Add this test once we actually have a built-in agent configured.
+        // it('should load built-in agents upon initialization', async () => {
+        //   expect(registry.getAllDefinitions()).toHaveLength(0);
+        //   await registry.initialize();
+        //   // There are currently no built-in agents.
+        //   expect(registry.getAllDefinitions()).toEqual([]);
+        // });
+        it('should log the count of loaded agents in debug mode', async () => {
+            const debugConfig = makeFakeConfig({
+                debugMode: true,
+                enableAgents: true,
+            });
+            const debugRegistry = new TestableAgentRegistry(debugConfig);
+            const debugLogSpy = vi
+                .spyOn(debugLogger, 'log')
+                .mockImplementation(() => { });
+            await debugRegistry.initialize();
+            const agentCount = debugRegistry.getAllDefinitions().length;
+            expect(debugLogSpy).toHaveBeenCalledWith(`[AgentRegistry] Initialized with ${agentCount} agents.`);
+        });
+        it('should use preview flash model for codebase investigator if main model is preview pro', async () => {
+            const previewConfig = makeFakeConfig({
+                model: PREVIEW_GEMINI_MODEL,
+                codebaseInvestigatorSettings: {
+                    enabled: true,
+                    model: GEMINI_MODEL_ALIAS_AUTO,
+                },
+            });
+            const previewRegistry = new TestableAgentRegistry(previewConfig);
+            await previewRegistry.initialize();
+            const investigatorDef = previewRegistry.getDefinition('codebase_investigator');
+            expect(investigatorDef).toBeDefined();
+            expect(investigatorDef?.modelConfig.model).toBe(PREVIEW_GEMINI_FLASH_MODEL);
+        });
+        it('should use preview flash model for codebase investigator if main model is preview auto', async () => {
+            const previewConfig = makeFakeConfig({
+                model: PREVIEW_GEMINI_MODEL_AUTO,
+                codebaseInvestigatorSettings: {
+                    enabled: true,
+                    model: GEMINI_MODEL_ALIAS_AUTO,
+                },
+            });
+            const previewRegistry = new TestableAgentRegistry(previewConfig);
+            await previewRegistry.initialize();
+            const investigatorDef = previewRegistry.getDefinition('codebase_investigator');
+            expect(investigatorDef).toBeDefined();
+            expect(investigatorDef?.modelConfig.model).toBe(PREVIEW_GEMINI_FLASH_MODEL);
+        });
+        it('should use the model from the investigator settings', async () => {
+            const previewConfig = makeFakeConfig({
+                model: PREVIEW_GEMINI_MODEL,
+                codebaseInvestigatorSettings: {
+                    enabled: true,
+                    model: DEFAULT_GEMINI_FLASH_LITE_MODEL,
+                },
+            });
+            const previewRegistry = new TestableAgentRegistry(previewConfig);
+            await previewRegistry.initialize();
+            const investigatorDef = previewRegistry.getDefinition('codebase_investigator');
+            expect(investigatorDef).toBeDefined();
+            expect(investigatorDef?.modelConfig.model).toBe(DEFAULT_GEMINI_FLASH_LITE_MODEL);
+        });
+        it('should load agents from user and project directories with correct precedence', async () => {
+            mockConfig = makeFakeConfig({ enableAgents: true });
+            registry = new TestableAgentRegistry(mockConfig);
+            const userAgent = {
+                ...MOCK_AGENT_V1,
+                name: 'common-agent',
+                description: 'User version',
+            };
+            const projectAgent = {
+                ...MOCK_AGENT_V1,
+                name: 'common-agent',
+                description: 'Project version',
+            };
+            const uniqueProjectAgent = {
+                ...MOCK_AGENT_V1,
+                name: 'project-only',
+                description: 'Project only',
+            };
+            vi.mocked(tomlLoader.loadAgentsFromDirectory)
+                .mockResolvedValueOnce({ agents: [userAgent], errors: [] }) // User dir
+                .mockResolvedValueOnce({
+                agents: [projectAgent, uniqueProjectAgent],
+                errors: [],
+            }); // Project dir
+            await registry.initialize();
+            // Project agent should override user agent
+            expect(registry.getDefinition('common-agent')?.description).toBe('Project version');
+            expect(registry.getDefinition('project-only')).toBeDefined();
+            expect(vi.mocked(tomlLoader.loadAgentsFromDirectory)).toHaveBeenCalledTimes(2);
+        });
+        it('should NOT load TOML agents when enableAgents is false', async () => {
+            const disabledConfig = makeFakeConfig({
+                enableAgents: false,
+                codebaseInvestigatorSettings: { enabled: false },
+            });
+            const disabledRegistry = new TestableAgentRegistry(disabledConfig);
+            await disabledRegistry.initialize();
+            expect(disabledRegistry.getAllDefinitions()).toHaveLength(0);
+            expect(vi.mocked(tomlLoader.loadAgentsFromDirectory)).not.toHaveBeenCalled();
+        });
+        it('should register introspection agent if enabled', async () => {
+            const config = makeFakeConfig({
+                introspectionAgentSettings: { enabled: true },
+            });
+            const registry = new TestableAgentRegistry(config);
+            await registry.initialize();
+            expect(registry.getDefinition('introspection_agent')).toBeDefined();
+        });
+        it('should NOT register introspection agent if disabled', async () => {
+            const config = makeFakeConfig({
+                introspectionAgentSettings: { enabled: false },
+            });
+            const registry = new TestableAgentRegistry(config);
+            await registry.initialize();
+            expect(registry.getDefinition('introspection_agent')).toBeUndefined();
+        });
+    });
+    describe('registration logic', () => {
+        it('should register a valid agent definition', () => {
+            registry.testRegisterAgent(MOCK_AGENT_V1);
+            expect(registry.getDefinition('MockAgent')).toEqual(MOCK_AGENT_V1);
+            expect(mockConfig.modelConfigService.getResolvedConfig({
+                model: getModelConfigAlias(MOCK_AGENT_V1),
+            })).toStrictEqual({
+                model: MOCK_AGENT_V1.modelConfig.model,
+                generateContentConfig: {
+                    temperature: MOCK_AGENT_V1.modelConfig.temp,
+                    topP: MOCK_AGENT_V1.modelConfig.top_p,
+                    thinkingConfig: {
+                        includeThoughts: true,
+                        thinkingBudget: -1,
+                    },
+                },
+            });
+        });
+        it('should handle special characters in agent names', () => {
+            const specialAgent = {
+                ...MOCK_AGENT_V1,
+                name: 'Agent-123_$pecial.v2',
+            };
+            registry.testRegisterAgent(specialAgent);
+            expect(registry.getDefinition('Agent-123_$pecial.v2')).toEqual(specialAgent);
+        });
+        it('should reject an agent definition missing a name', () => {
+            const invalidAgent = { ...MOCK_AGENT_V1, name: '' };
+            const debugWarnSpy = vi
+                .spyOn(debugLogger, 'warn')
+                .mockImplementation(() => { });
+            registry.testRegisterAgent(invalidAgent);
+            expect(registry.getDefinition('MockAgent')).toBeUndefined();
+            expect(debugWarnSpy).toHaveBeenCalledWith('[AgentRegistry] Skipping invalid agent definition. Missing name or description.');
+        });
+        it('should reject an agent definition missing a description', () => {
+            const invalidAgent = { ...MOCK_AGENT_V1, description: '' };
+            const debugWarnSpy = vi
+                .spyOn(debugLogger, 'warn')
+                .mockImplementation(() => { });
+            registry.testRegisterAgent(invalidAgent);
+            expect(registry.getDefinition('MockAgent')).toBeUndefined();
+            expect(debugWarnSpy).toHaveBeenCalledWith('[AgentRegistry] Skipping invalid agent definition. Missing name or description.');
+        });
+        it('should overwrite an existing agent definition', () => {
+            registry.testRegisterAgent(MOCK_AGENT_V1);
+            expect(registry.getDefinition('MockAgent')?.description).toBe('Mock Description V1');
+            registry.testRegisterAgent(MOCK_AGENT_V2);
+            expect(registry.getDefinition('MockAgent')?.description).toBe('Mock Description V2 (Updated)');
+            expect(registry.getAllDefinitions()).toHaveLength(1);
+        });
+        it('should log overwrites when in debug mode', () => {
+            const debugConfig = makeFakeConfig({ debugMode: true });
+            const debugRegistry = new TestableAgentRegistry(debugConfig);
+            const debugLogSpy = vi
+                .spyOn(debugLogger, 'log')
+                .mockImplementation(() => { });
+            debugRegistry.testRegisterAgent(MOCK_AGENT_V1);
+            debugRegistry.testRegisterAgent(MOCK_AGENT_V2);
+            expect(debugLogSpy).toHaveBeenCalledWith(`[AgentRegistry] Overriding agent 'MockAgent'`);
+        });
+        it('should not log overwrites when not in debug mode', () => {
+            const debugLogSpy = vi
+                .spyOn(debugLogger, 'log')
+                .mockImplementation(() => { });
+            registry.testRegisterAgent(MOCK_AGENT_V1);
+            registry.testRegisterAgent(MOCK_AGENT_V2);
+            expect(debugLogSpy).not.toHaveBeenCalledWith(`[AgentRegistry] Overriding agent 'MockAgent'`);
+        });
+        it('should handle bulk registrations correctly', async () => {
+            const promises = Array.from({ length: 100 }, (_, i) => Promise.resolve(registry.testRegisterAgent({
+                ...MOCK_AGENT_V1,
+                name: `Agent${i}`,
+            })));
+            await Promise.all(promises);
+            expect(registry.getAllDefinitions()).toHaveLength(100);
+        });
+    });
+    describe('inheritance and refresh', () => {
+        it('should resolve "inherit" to the current model from configuration', () => {
+            const config = makeFakeConfig({ model: 'current-model' });
+            const registry = new TestableAgentRegistry(config);
+            const agent = {
+                ...MOCK_AGENT_V1,
+                modelConfig: { ...MOCK_AGENT_V1.modelConfig, model: 'inherit' },
+            };
+            registry.testRegisterAgent(agent);
+            const resolved = config.modelConfigService.getResolvedConfig({
+                model: getModelConfigAlias(agent),
+            });
+            expect(resolved.model).toBe('current-model');
+        });
+        it('should update inherited models when the main model changes', async () => {
+            const config = makeFakeConfig({ model: 'initial-model' });
+            const registry = new TestableAgentRegistry(config);
+            await registry.initialize();
+            const agent = {
+                ...MOCK_AGENT_V1,
+                name: 'InheritingAgent',
+                modelConfig: { ...MOCK_AGENT_V1.modelConfig, model: 'inherit' },
+            };
+            registry.testRegisterAgent(agent);
+            // Verify initial state
+            let resolved = config.modelConfigService.getResolvedConfig({
+                model: getModelConfigAlias(agent),
+            });
+            expect(resolved.model).toBe('initial-model');
+            // Change model and emit event
+            vi.spyOn(config, 'getModel').mockReturnValue('new-model');
+            coreEvents.emit(CoreEvent.ModelChanged, {
+                model: 'new-model',
+            });
+            // Verify refreshed state
+            resolved = config.modelConfigService.getResolvedConfig({
+                model: getModelConfigAlias(agent),
+            });
+            expect(resolved.model).toBe('new-model');
+        });
+    });
+    describe('accessors', () => {
+        const ANOTHER_AGENT = {
+            ...MOCK_AGENT_V1,
+            name: 'AnotherAgent',
+        };
+        beforeEach(() => {
+            registry.testRegisterAgent(MOCK_AGENT_V1);
+            registry.testRegisterAgent(ANOTHER_AGENT);
+        });
+        it('getDefinition should return the correct definition', () => {
+            expect(registry.getDefinition('MockAgent')).toEqual(MOCK_AGENT_V1);
+            expect(registry.getDefinition('AnotherAgent')).toEqual(ANOTHER_AGENT);
+        });
+        it('getDefinition should return undefined for unknown agents', () => {
+            expect(registry.getDefinition('NonExistentAgent')).toBeUndefined();
+        });
+        it('getAllDefinitions should return all registered definitions', () => {
+            const all = registry.getAllDefinitions();
+            expect(all).toHaveLength(2);
+            expect(all).toEqual(expect.arrayContaining([MOCK_AGENT_V1, ANOTHER_AGENT]));
+        });
+    });
+    describe('getToolDescription', () => {
+        it('should return default message when no agents are registered', () => {
+            expect(registry.getToolDescription()).toContain('No agents are currently available');
+        });
+        it('should return formatted list of agents when agents are available', () => {
+            registry.testRegisterAgent(MOCK_AGENT_V1);
+            registry.testRegisterAgent({
+                ...MOCK_AGENT_V2,
+                name: 'AnotherAgent',
+                description: 'Another agent description',
+            });
+            const description = registry.getToolDescription();
+            expect(description).toContain('Delegates a task to a specialized sub-agent');
+            expect(description).toContain('Available agents:');
+            expect(description).toContain(`- **${MOCK_AGENT_V1.name}**: ${MOCK_AGENT_V1.description}`);
+            expect(description).toContain(`- **AnotherAgent**: Another agent description`);
+        });
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/src/agents/registry.test.js.map

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

package/dist/src/agents/remote-invocation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseToolInvocation, type ToolResult, type ToolCallConfirmationDetails } from '../tools/tools.js';
+import type { AgentInputs, RemoteAgentDefinition } from './types.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+/**
+ * A tool invocation that proxies to a remote A2A agent.
+ *
+ * This implementation bypasses the local `LocalAgentExecutor` loop and directly
+ * invokes the configured A2A tool.
+ */
+export declare class RemoteAgentInvocation extends BaseToolInvocation<AgentInputs, ToolResult> {
+    private readonly definition;
+    constructor(definition: RemoteAgentDefinition, params: AgentInputs, messageBus?: MessageBus);
+    getDescription(): string;
+    protected getConfirmationDetails(_abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}

package/dist/src/agents/remote-invocation.js

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseToolInvocation, } from '../tools/tools.js';
+/**
+ * A tool invocation that proxies to a remote A2A agent.
+ *
+ * This implementation bypasses the local `LocalAgentExecutor` loop and directly
+ * invokes the configured A2A tool.
+ */
+export class RemoteAgentInvocation extends BaseToolInvocation {
+    definition;
+    constructor(definition, params, messageBus) {
+        super(params, messageBus, definition.name, definition.displayName);
+        this.definition = definition;
+    }
+    getDescription() {
+        return `Calling remote agent ${this.definition.displayName ?? this.definition.name}`;
+    }
+    async getConfirmationDetails(_abortSignal) {
+        // TODO: Implement confirmation logic for remote agents.
+        return false;
+    }
+    async execute(_signal) {
+        // TODO: Implement remote agent invocation logic.
+        throw new Error(`Remote agent invocation not implemented.`);
+    }
+}
+//# sourceMappingURL=remote-invocation.js.map

package/dist/src/agents/remote-invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-invocation.js","sourceRoot":"","sources":["../../../src/agents/remote-invocation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,GAGnB,MAAM,mBAAmB,CAAC;AAI3B;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,kBAG1C;IAEoB;IADnB,YACmB,UAAiC,EAClD,MAAmB,EACnB,UAAuB;QAEvB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;QAJlD,eAAU,GAAV,UAAU,CAAuB;IAKpD,CAAC;IAED,cAAc;QACZ,OAAO,wBAAwB,IAAI,CAAC,UAAU,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACvF,CAAC;IAEkB,KAAK,CAAC,sBAAsB,CAC7C,YAAyB;QAEzB,wDAAwD;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAoB;QAChC,iDAAiD;QACjD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/src/agents/remote-invocation.test.d.ts

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