@google/gemini-cli-core 0.8.0-nightly.20250930.ddcbd0c2 → 0.8.0-preview.0

package/dist/src/agents/executor.test.js

@@ -0,0 +1,419 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach, } from 'vitest';
+import { AgentExecutor } from './executor.js';
+import { AgentTerminateMode } from './types.js';
+import { makeFakeConfig } from '../test-utils/config.js';
+import { ToolRegistry } from '../tools/tool-registry.js';
+import { LSTool } from '../tools/ls.js';
+import { ReadFileTool } from '../tools/read-file.js';
+import { GeminiChat, StreamEventType, } from '../core/geminiChat.js';
+import { MockTool } from '../test-utils/mock-tool.js';
+import { getDirectoryContextString } from '../utils/environmentContext.js';
+const { mockSendMessageStream, mockExecuteToolCall } = vi.hoisted(() => ({
+    mockSendMessageStream: vi.fn(),
+    mockExecuteToolCall: vi.fn(),
+}));
+vi.mock('../core/geminiChat.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        GeminiChat: vi.fn().mockImplementation(() => ({
+            sendMessageStream: mockSendMessageStream,
+        })),
+    };
+});
+vi.mock('../core/nonInteractiveToolExecutor.js', () => ({
+    executeToolCall: mockExecuteToolCall,
+}));
+vi.mock('../utils/environmentContext.js');
+const MockedGeminiChat = GeminiChat;
+// A mock tool that is NOT on the NON_INTERACTIVE_TOOL_ALLOWLIST
+const MOCK_TOOL_NOT_ALLOWED = new MockTool({ name: 'write_file' });
+const createMockResponseChunk = (parts, functionCalls) => ({
+    candidates: [{ index: 0, content: { role: 'model', parts } }],
+    functionCalls,
+});
+const mockModelResponse = (functionCalls, thought, text) => {
+    const parts = [];
+    if (thought) {
+        parts.push({
+            text: `**${thought}** This is the reasoning part.`,
+            thought: true,
+        });
+    }
+    if (text)
+        parts.push({ text });
+    const responseChunk = createMockResponseChunk(parts, 
+    // Ensure functionCalls is undefined if the array is empty, matching API behavior
+    functionCalls.length > 0 ? functionCalls : undefined);
+    mockSendMessageStream.mockImplementationOnce(async () => (async function* () {
+        yield {
+            type: StreamEventType.CHUNK,
+            value: responseChunk,
+        };
+    })());
+};
+let mockConfig;
+let parentToolRegistry;
+const createTestDefinition = (tools = [LSTool.Name], runConfigOverrides = {}, outputConfigOverrides = {}) => ({
+    name: 'TestAgent',
+    description: 'An agent for testing.',
+    inputConfig: {
+        inputs: { goal: { type: 'string', required: true, description: 'goal' } },
+    },
+    modelConfig: { model: 'gemini-test-model', temp: 0, top_p: 1 },
+    runConfig: { max_time_minutes: 5, max_turns: 5, ...runConfigOverrides },
+    promptConfig: { systemPrompt: 'Achieve the goal: ${goal}.' },
+    toolConfig: { tools },
+    outputConfig: { description: 'The final result.', ...outputConfigOverrides },
+});
+describe('AgentExecutor', () => {
+    let activities;
+    let onActivity;
+    let abortController;
+    let signal;
+    beforeEach(async () => {
+        mockSendMessageStream.mockClear();
+        mockExecuteToolCall.mockClear();
+        vi.clearAllMocks();
+        // Use fake timers for timeout and concurrency testing
+        vi.useFakeTimers();
+        mockConfig = makeFakeConfig();
+        parentToolRegistry = new ToolRegistry(mockConfig);
+        parentToolRegistry.registerTool(new LSTool(mockConfig));
+        parentToolRegistry.registerTool(new ReadFileTool(mockConfig));
+        parentToolRegistry.registerTool(MOCK_TOOL_NOT_ALLOWED);
+        vi.spyOn(mockConfig, 'getToolRegistry').mockResolvedValue(parentToolRegistry);
+        vi.mocked(getDirectoryContextString).mockResolvedValue('Mocked Environment Context');
+        activities = [];
+        onActivity = (activity) => activities.push(activity);
+        abortController = new AbortController();
+        signal = abortController.signal;
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe('create (Initialization and Validation)', () => {
+        it('should create successfully with allowed tools', async () => {
+            const definition = createTestDefinition([LSTool.Name]);
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            expect(executor).toBeInstanceOf(AgentExecutor);
+        });
+        it('SECURITY: should throw if a tool is not on the non-interactive allowlist', async () => {
+            const definition = createTestDefinition([MOCK_TOOL_NOT_ALLOWED.name]);
+            await expect(AgentExecutor.create(definition, mockConfig, onActivity)).rejects.toThrow(`Tool "${MOCK_TOOL_NOT_ALLOWED.name}" is not on the allow-list for non-interactive execution`);
+        });
+        it('should create an isolated ToolRegistry for the agent', async () => {
+            const definition = createTestDefinition([LSTool.Name, ReadFileTool.Name]);
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            // @ts-expect-error - accessing private property for test validation
+            const agentRegistry = executor.toolRegistry;
+            expect(agentRegistry).not.toBe(parentToolRegistry);
+            expect(agentRegistry.getAllToolNames()).toEqual(expect.arrayContaining([LSTool.Name, ReadFileTool.Name]));
+            expect(agentRegistry.getAllToolNames()).toHaveLength(2);
+            expect(agentRegistry.getTool(MOCK_TOOL_NOT_ALLOWED.name)).toBeUndefined();
+        });
+    });
+    describe('run (Execution Loop and Logic)', () => {
+        it('should execute a successful work and extraction phase (Happy Path) and emit activities', async () => {
+            const definition = createTestDefinition();
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            const inputs = { goal: 'Find files' };
+            // Turn 1: Model calls ls
+            mockModelResponse([{ name: LSTool.Name, args: { path: '.' }, id: 'call1' }], 'T1: Listing');
+            mockExecuteToolCall.mockResolvedValueOnce({
+                callId: 'call1',
+                resultDisplay: 'file1.txt',
+                responseParts: [
+                    {
+                        functionResponse: {
+                            name: LSTool.Name,
+                            response: { result: 'file1.txt' },
+                            id: 'call1',
+                        },
+                    },
+                ],
+                error: undefined,
+            });
+            // Turn 2: Model stops
+            mockModelResponse([], 'T2: Done');
+            // Extraction Phase
+            mockModelResponse([], undefined, 'Result: file1.txt.');
+            const output = await executor.run(inputs, signal);
+            expect(mockSendMessageStream).toHaveBeenCalledTimes(3);
+            expect(mockExecuteToolCall).toHaveBeenCalledTimes(1);
+            // Verify System Prompt Templating
+            const chatConstructorArgs = MockedGeminiChat.mock.calls[0];
+            const chatConfig = chatConstructorArgs[1];
+            expect(chatConfig?.systemInstruction).toContain('Achieve the goal: Find files.');
+            // Verify environment context is appended
+            expect(chatConfig?.systemInstruction).toContain('# Environment Context\nMocked Environment Context');
+            // Verify standard rules are appended
+            expect(chatConfig?.systemInstruction).toContain('You are running in a non-interactive mode.');
+            // Verify absolute path rule is appended
+            expect(chatConfig?.systemInstruction).toContain('Always use absolute paths for file operations.');
+            // Verify Extraction Phase Call (Specific arguments)
+            expect(mockSendMessageStream).toHaveBeenCalledWith('gemini-test-model', expect.objectContaining({
+                // Extraction message should be based on outputConfig.description
+                message: expect.arrayContaining([
+                    {
+                        text: expect.stringContaining('Based on your work so far, provide: The final result.'),
+                    },
+                ]),
+                config: expect.objectContaining({ tools: undefined }), // No tools in extraction
+            }), expect.stringContaining('#extraction'));
+            expect(output.result).toBe('Result: file1.txt.');
+            expect(output.terminate_reason).toBe(AgentTerminateMode.GOAL);
+            // Verify Activity Stream (Observability)
+            expect(activities).toEqual(expect.arrayContaining([
+                // Thought subjects are extracted by the executor (parseThought)
+                expect.objectContaining({
+                    type: 'THOUGHT_CHUNK',
+                    data: { text: 'T1: Listing' },
+                }),
+                expect.objectContaining({
+                    type: 'TOOL_CALL_START',
+                    data: { name: LSTool.Name, args: { path: '.' } },
+                }),
+                expect.objectContaining({
+                    type: 'TOOL_CALL_END',
+                    data: { name: LSTool.Name, output: 'file1.txt' },
+                }),
+                expect.objectContaining({
+                    type: 'THOUGHT_CHUNK',
+                    data: { text: 'T2: Done' },
+                }),
+            ]));
+        });
+        it('should execute parallel tool calls concurrently', async () => {
+            const definition = createTestDefinition([LSTool.Name, ReadFileTool.Name]);
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            const call1 = {
+                name: LSTool.Name,
+                args: { path: '/dir1' },
+                id: 'call1',
+            };
+            // Using LSTool twice for simplicity in mocking standardized responses.
+            const call2 = {
+                name: LSTool.Name,
+                args: { path: '/dir2' },
+                id: 'call2',
+            };
+            // Turn 1: Model calls two tools simultaneously
+            mockModelResponse([call1, call2], 'T1: Listing both');
+            // Use concurrency tracking to ensure parallelism
+            let activeCalls = 0;
+            let maxActiveCalls = 0;
+            mockExecuteToolCall.mockImplementation(async (_ctx, reqInfo) => {
+                activeCalls++;
+                maxActiveCalls = Math.max(maxActiveCalls, activeCalls);
+                // Simulate latency. We must advance the fake timers for this to resolve.
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                activeCalls--;
+                return {
+                    callId: reqInfo.callId,
+                    resultDisplay: `Result for ${reqInfo.name}`,
+                    responseParts: [
+                        {
+                            functionResponse: {
+                                name: reqInfo.name,
+                                response: {},
+                                id: reqInfo.callId,
+                            },
+                        },
+                    ],
+                    error: undefined,
+                };
+            });
+            // Turn 2: Model stops
+            mockModelResponse([]);
+            // Extraction
+            mockModelResponse([], undefined, 'Done.');
+            const runPromise = executor.run({ goal: 'Parallel test' }, signal);
+            // Advance timers while the parallel calls (Promise.all + setTimeout) are running
+            await vi.advanceTimersByTimeAsync(150);
+            await runPromise;
+            expect(mockExecuteToolCall).toHaveBeenCalledTimes(2);
+            expect(maxActiveCalls).toBe(2);
+            // Verify the input to the next model call (Turn 2) contains both responses
+            // sendMessageStream calls: [0] Turn 1, [1] Turn 2, [2] Extraction
+            const turn2Input = mockSendMessageStream.mock.calls[1][1];
+            const turn2Parts = turn2Input.message;
+            // Promise.all preserves the order of the input array.
+            expect(turn2Parts.length).toBe(2);
+            expect(turn2Parts[0]).toEqual(expect.objectContaining({
+                functionResponse: expect.objectContaining({ id: 'call1' }),
+            }));
+            expect(turn2Parts[1]).toEqual(expect.objectContaining({
+                functionResponse: expect.objectContaining({ id: 'call2' }),
+            }));
+        });
+        it('should handle tool execution failure gracefully and report error', async () => {
+            const definition = createTestDefinition([LSTool.Name]);
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            // Turn 1: Model calls ls, but it fails
+            mockModelResponse([
+                { name: LSTool.Name, args: { path: '/invalid' }, id: 'call1' },
+            ]);
+            const errorMessage = 'Internal failure.';
+            mockExecuteToolCall.mockResolvedValueOnce({
+                callId: 'call1',
+                resultDisplay: `Error: ${errorMessage}`,
+                responseParts: undefined, // Failed tools might return undefined parts
+                error: { message: errorMessage },
+            });
+            // Turn 2: Model stops
+            mockModelResponse([]);
+            mockModelResponse([], undefined, 'Failed.');
+            await executor.run({ goal: 'Failure test' }, signal);
+            // Verify that the error was reported in the activity stream
+            expect(activities).toContainEqual(expect.objectContaining({
+                type: 'ERROR',
+                data: {
+                    error: errorMessage,
+                    context: 'tool_call',
+                    name: LSTool.Name,
+                },
+            }));
+            // Verify the input to the next model call (Turn 2) contains the fallback error message
+            const turn2Input = mockSendMessageStream.mock.calls[1][1];
+            const turn2Parts = turn2Input.message;
+            expect(turn2Parts).toEqual([
+                {
+                    text: 'All tool calls failed. Please analyze the errors and try an alternative approach.',
+                },
+            ]);
+        });
+        it('SECURITY: should block calls to tools not registered for the agent at runtime', async () => {
+            // Agent definition only includes LSTool
+            const definition = createTestDefinition([LSTool.Name]);
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            // Turn 1: Model hallucinates a call to ReadFileTool
+            // (ReadFileTool exists in the parent registry but not the agent's isolated registry)
+            mockModelResponse([
+                {
+                    name: ReadFileTool.Name,
+                    args: { path: 'config.txt' },
+                    id: 'call_blocked',
+                },
+            ]);
+            // Turn 2: Model stops
+            mockModelResponse([]);
+            // Extraction
+            mockModelResponse([], undefined, 'Done.');
+            const consoleWarnSpy = vi
+                .spyOn(console, 'warn')
+                .mockImplementation(() => { });
+            await executor.run({ goal: 'Security test' }, signal);
+            // Verify executeToolCall was NEVER called because the tool was unauthorized
+            expect(mockExecuteToolCall).not.toHaveBeenCalled();
+            expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining(`attempted to call unauthorized tool '${ReadFileTool.Name}'`));
+            consoleWarnSpy.mockRestore();
+            // Verify the input to the next model call (Turn 2) indicates failure (as the only call was blocked)
+            const turn2Input = mockSendMessageStream.mock.calls[1][1];
+            const turn2Parts = turn2Input.message;
+            expect(turn2Parts[0].text).toContain('All tool calls failed');
+        });
+        it('should use OutputConfig completion_criteria in the extraction message', async () => {
+            const definition = createTestDefinition([LSTool.Name], {}, {
+                description: 'A summary.',
+                completion_criteria: ['Must include file names', 'Must be concise'],
+            });
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            // Turn 1: Model stops immediately
+            mockModelResponse([]);
+            // Extraction Phase
+            mockModelResponse([], undefined, 'Result: Done.');
+            await executor.run({ goal: 'Extraction test' }, signal);
+            // Verify the extraction call (the second call)
+            const extractionCallArgs = mockSendMessageStream.mock.calls[1][1];
+            const extractionMessageParts = extractionCallArgs.message;
+            const extractionText = extractionMessageParts[0].text;
+            expect(extractionText).toContain('Based on your work so far, provide: A summary.');
+            expect(extractionText).toContain('Be sure you have addressed:');
+            expect(extractionText).toContain('- Must include file names');
+            expect(extractionText).toContain('- Must be concise');
+        });
+    });
+    describe('run (Termination Conditions)', () => {
+        const mockKeepAliveResponse = () => {
+            mockModelResponse([{ name: LSTool.Name, args: { path: '.' }, id: 'loop' }], 'Looping');
+            mockExecuteToolCall.mockResolvedValue({
+                callId: 'loop',
+                resultDisplay: 'ok',
+                responseParts: [
+                    { functionResponse: { name: LSTool.Name, response: {}, id: 'loop' } },
+                ],
+                error: undefined,
+            });
+        };
+        it('should terminate when max_turns is reached', async () => {
+            const MAX_TURNS = 2;
+            const definition = createTestDefinition([LSTool.Name], {
+                max_turns: MAX_TURNS,
+            });
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            // Turn 1
+            mockKeepAliveResponse();
+            // Turn 2
+            mockKeepAliveResponse();
+            const output = await executor.run({ goal: 'Termination test' }, signal);
+            expect(output.terminate_reason).toBe(AgentTerminateMode.MAX_TURNS);
+            expect(mockSendMessageStream).toHaveBeenCalledTimes(MAX_TURNS);
+            // Extraction phase should be skipped when termination is forced
+            expect(mockSendMessageStream).not.toHaveBeenCalledWith(expect.any(String), expect.any(Object), expect.stringContaining('#extraction'));
+        });
+        it('should terminate if timeout is reached', async () => {
+            const definition = createTestDefinition([LSTool.Name], {
+                max_time_minutes: 5,
+                max_turns: 100,
+            });
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            // Turn 1 setup
+            mockModelResponse([{ name: LSTool.Name, args: { path: '.' }, id: 'loop' }], 'Looping');
+            // Mock a tool call that takes a long time, causing the overall timeout
+            mockExecuteToolCall.mockImplementation(async () => {
+                // Advance time past the 5-minute limit during the tool call execution
+                await vi.advanceTimersByTimeAsync(5 * 60 * 1000 + 1);
+                return {
+                    callId: 'loop',
+                    resultDisplay: 'ok',
+                    responseParts: [
+                        {
+                            functionResponse: { name: LSTool.Name, response: {}, id: 'loop' },
+                        },
+                    ],
+                    error: undefined,
+                };
+            });
+            const output = await executor.run({ goal: 'Termination test' }, signal);
+            expect(output.terminate_reason).toBe(AgentTerminateMode.TIMEOUT);
+            // Should only have called the model once before the timeout check stopped it
+            expect(mockSendMessageStream).toHaveBeenCalledTimes(1);
+        });
+        it('should terminate when AbortSignal is triggered mid-stream', async () => {
+            const definition = createTestDefinition();
+            const executor = await AgentExecutor.create(definition, mockConfig, onActivity);
+            // Mock the model response stream
+            mockSendMessageStream.mockImplementation(async () => (async function* () {
+                // Yield the first chunk
+                yield {
+                    type: StreamEventType.CHUNK,
+                    value: createMockResponseChunk([
+                        { text: '**Thinking** Step 1', thought: true },
+                    ]),
+                };
+                // Simulate abort happening mid-stream
+                abortController.abort();
+                // The loop in callModel should break immediately due to signal check.
+            })());
+            const output = await executor.run({ goal: 'Termination test' }, signal);
+            expect(output.terminate_reason).toBe(AgentTerminateMode.ABORTED);
+        });
+    });
+});
+//# sourceMappingURL=executor.test.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { AnsiOutput } from '../utils/terminalSerializer.js';
+import { BaseToolInvocation, type ToolResult } from '../tools/tools.js';
+import type { AgentDefinition, AgentInputs } from './types.js';
+/**
+ * Represents a validated, executable instance of a subagent tool.
+ *
+ * This class orchestrates the execution of a defined agent by:
+ * 1. Initializing the {@link AgentExecutor}.
+ * 2. Running the agent's execution loop.
+ * 3. Bridging the agent's streaming activity (e.g., thoughts) to the tool's
+ * live output stream.
+ * 4. Formatting the final result into a {@link ToolResult}.
+ */
+export declare class SubagentInvocation extends BaseToolInvocation<AgentInputs, ToolResult> {
+    private readonly definition;
+    private readonly config;
+    /**
+     * @param params The validated input parameters for the agent.
+     * @param definition The definition object that configures the agent.
+     * @param config The global runtime configuration.
+     */
+    constructor(params: AgentInputs, definition: AgentDefinition, config: Config);
+    /**
+     * Returns a concise, human-readable description of the invocation.
+     * Used for logging and display purposes.
+     */
+    getDescription(): string;
+    /**
+     * Executes the subagent.
+     *
+     * @param signal An `AbortSignal` to cancel the agent's execution.
+     * @param updateOutput A callback to stream intermediate output, such as the
+     * agent's thoughts, to the user interface.
+     * @returns A `Promise` that resolves with the final `ToolResult`.
+     */
+    execute(signal: AbortSignal, updateOutput?: (output: string | AnsiOutput) => void): Promise<ToolResult>;
+}

package/dist/src/agents/invocation.js

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AgentExecutor } from './executor.js';
+import { BaseToolInvocation } from '../tools/tools.js';
+import { ToolErrorType } from '../tools/tool-error.js';
+const INPUT_PREVIEW_MAX_LENGTH = 50;
+const DESCRIPTION_MAX_LENGTH = 200;
+/**
+ * Represents a validated, executable instance of a subagent tool.
+ *
+ * This class orchestrates the execution of a defined agent by:
+ * 1. Initializing the {@link AgentExecutor}.
+ * 2. Running the agent's execution loop.
+ * 3. Bridging the agent's streaming activity (e.g., thoughts) to the tool's
+ * live output stream.
+ * 4. Formatting the final result into a {@link ToolResult}.
+ */
+export class SubagentInvocation extends BaseToolInvocation {
+    definition;
+    config;
+    /**
+     * @param params The validated input parameters for the agent.
+     * @param definition The definition object that configures the agent.
+     * @param config The global runtime configuration.
+     */
+    constructor(params, definition, config) {
+        super(params);
+        this.definition = definition;
+        this.config = config;
+    }
+    /**
+     * Returns a concise, human-readable description of the invocation.
+     * Used for logging and display purposes.
+     */
+    getDescription() {
+        const inputSummary = Object.entries(this.params)
+            .map(([key, value]) => `${key}: ${String(value).slice(0, INPUT_PREVIEW_MAX_LENGTH)}`)
+            .join(', ');
+        const description = `Running subagent '${this.definition.name}' with inputs: { ${inputSummary} }`;
+        return description.slice(0, DESCRIPTION_MAX_LENGTH);
+    }
+    /**
+     * Executes the subagent.
+     *
+     * @param signal An `AbortSignal` to cancel the agent's execution.
+     * @param updateOutput A callback to stream intermediate output, such as the
+     * agent's thoughts, to the user interface.
+     * @returns A `Promise` that resolves with the final `ToolResult`.
+     */
+    async execute(signal, updateOutput) {
+        try {
+            if (updateOutput) {
+                updateOutput('Subagent starting...\n');
+            }
+            // Create an activity callback to bridge the executor's events to the
+            // tool's streaming output.
+            const onActivity = (activity) => {
+                if (!updateOutput)
+                    return;
+                if (activity.type === 'THOUGHT_CHUNK' &&
+                    typeof activity.data['text'] === 'string') {
+                    updateOutput(`🤖💭 ${activity.data['text']}`);
+                }
+            };
+            const executor = await AgentExecutor.create(this.definition, this.config, onActivity);
+            const output = await executor.run(this.params, signal);
+            const resultContent = `Subagent '${this.definition.name}' finished.
+Termination Reason: ${output.terminate_reason}
+Result:
+${output.result}`;
+            const displayContent = `
+Subagent ${this.definition.name} Finished
+
+Termination Reason:\n ${output.terminate_reason}
+
+Result:
+${output.result}
+`;
+            return {
+                llmContent: [{ text: resultContent }],
+                returnDisplay: displayContent,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                llmContent: `Subagent '${this.definition.name}' failed. Error: ${errorMessage}`,
+                returnDisplay: `Subagent Failed: ${this.definition.name}\nError: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+    }
+}
+//# sourceMappingURL=invocation.js.map

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

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

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

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