@office-ai/aioncli-core 0.18.6 → 0.24.0-preview.1

package/dist/src/agents/delegate-to-agent-tool.js

@@ -0,0 +1,115 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { BaseDeclarativeTool, Kind, BaseToolInvocation, } from '../tools/tools.js';
+import { DELEGATE_TO_AGENT_TOOL_NAME } from '../tools/tool-names.js';
+import { SubagentToolWrapper } from './subagent-tool-wrapper.js';
+export class DelegateToAgentTool extends BaseDeclarativeTool {
+    registry;
+    config;
+    constructor(registry, config, messageBus) {
+        const definitions = registry.getAllDefinitions();
+        let schema;
+        if (definitions.length === 0) {
+            // Fallback if no agents are registered (mostly for testing/safety)
+            schema = z.object({
+                agent_name: z.string().describe('No agents are currently available.'),
+            });
+        }
+        else {
+            const agentSchemas = definitions.map((def) => {
+                const inputShape = {
+                    agent_name: z.literal(def.name).describe(def.description),
+                };
+                for (const [key, inputDef] of Object.entries(def.inputConfig.inputs)) {
+                    if (key === 'agent_name') {
+                        throw new Error(`Agent '${def.name}' cannot have an input parameter named 'agent_name' as it is a reserved parameter for delegation.`);
+                    }
+                    let validator;
+                    // Map input types to Zod
+                    switch (inputDef.type) {
+                        case 'string':
+                            validator = z.string();
+                            break;
+                        case 'number':
+                            validator = z.number();
+                            break;
+                        case 'boolean':
+                            validator = z.boolean();
+                            break;
+                        case 'integer':
+                            validator = z.number().int();
+                            break;
+                        case 'string[]':
+                            validator = z.array(z.string());
+                            break;
+                        case 'number[]':
+                            validator = z.array(z.number());
+                            break;
+                        default: {
+                            // This provides compile-time exhaustiveness checking.
+                            const _exhaustiveCheck = inputDef.type;
+                            void _exhaustiveCheck;
+                            throw new Error(`Unhandled agent input type: '${inputDef.type}'`);
+                        }
+                    }
+                    if (!inputDef.required) {
+                        validator = validator.optional();
+                    }
+                    inputShape[key] = validator.describe(inputDef.description);
+                }
+                // Cast required because Zod can't infer the discriminator from dynamic keys
+                return z.object(inputShape);
+            });
+            // Create the discriminated union
+            // z.discriminatedUnion requires at least 2 options, so we handle the single agent case
+            if (agentSchemas.length === 1) {
+                schema = agentSchemas[0];
+            }
+            else {
+                schema = z.discriminatedUnion('agent_name', agentSchemas);
+            }
+        }
+        super(DELEGATE_TO_AGENT_TOOL_NAME, 'Delegate to Agent', registry.getToolDescription(), Kind.Think, zodToJsonSchema(schema), messageBus, 
+        /* isOutputMarkdown */ true, 
+        /* canUpdateOutput */ true);
+        this.registry = registry;
+        this.config = config;
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new DelegateInvocation(params, this.registry, this.config, messageBus, _toolName, _toolDisplayName);
+    }
+}
+class DelegateInvocation extends BaseToolInvocation {
+    registry;
+    config;
+    constructor(params, registry, config, messageBus, _toolName, _toolDisplayName) {
+        super(params, messageBus, _toolName ?? DELEGATE_TO_AGENT_TOOL_NAME, _toolDisplayName);
+        this.registry = registry;
+        this.config = config;
+    }
+    getDescription() {
+        return `Delegating to agent '${this.params.agent_name}'`;
+    }
+    async execute(signal, updateOutput) {
+        const definition = this.registry.getDefinition(this.params.agent_name);
+        if (!definition) {
+            throw new Error(`Agent '${this.params.agent_name}' exists in the tool definition but could not be found in the registry.`);
+        }
+        // Extract arguments (everything except agent_name)
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const { agent_name, ...agentArgs } = this.params;
+        // Delegate the creation of the specific invocation (Local or Remote) to the wrapper.
+        // This centralizes the logic and ensures consistent handling.
+        const wrapper = new SubagentToolWrapper(definition, this.config, this.messageBus);
+        // We could skip extra validation here if we trust the Registry's schema,
+        // but build() will do a safety check anyway.
+        const invocation = wrapper.build(agentArgs);
+        return invocation.execute(signal, updateOutput);
+    }
+}
+//# sourceMappingURL=delegate-to-agent-tool.js.map

package/dist/src/agents/delegate-to-agent-tool.js.map

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

package/dist/src/agents/delegate-to-agent-tool.test.d.ts

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

package/dist/src/agents/delegate-to-agent-tool.test.js

@@ -0,0 +1,165 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { DelegateToAgentTool } from './delegate-to-agent-tool.js';
+import { AgentRegistry } from './registry.js';
+import { LocalSubagentInvocation } from './local-invocation.js';
+import { MessageBusType } from '../confirmation-bus/types.js';
+import { DELEGATE_TO_AGENT_TOOL_NAME } from '../tools/tool-names.js';
+import { RemoteAgentInvocation } from './remote-invocation.js';
+import { createMockMessageBus } from '../test-utils/mock-message-bus.js';
+vi.mock('./local-invocation.js', () => ({
+    LocalSubagentInvocation: vi.fn().mockImplementation(() => ({
+        execute: vi
+            .fn()
+            .mockResolvedValue({ content: [{ type: 'text', text: 'Success' }] }),
+    })),
+}));
+vi.mock('./remote-invocation.js', () => ({
+    RemoteAgentInvocation: vi.fn().mockImplementation(() => ({
+        execute: vi.fn().mockResolvedValue({
+            content: [{ type: 'text', text: 'Remote Success' }],
+        }),
+        shouldConfirmExecute: vi.fn().mockResolvedValue(true),
+    })),
+}));
+describe('DelegateToAgentTool', () => {
+    let registry;
+    let config;
+    let tool;
+    let messageBus;
+    const mockAgentDef = {
+        kind: 'local',
+        name: 'test_agent',
+        description: 'A test agent',
+        promptConfig: {},
+        modelConfig: { model: 'test-model', temp: 0, top_p: 0 },
+        inputConfig: {
+            inputs: {
+                arg1: { type: 'string', description: 'Argument 1', required: true },
+                arg2: { type: 'number', description: 'Argument 2', required: false },
+            },
+        },
+        runConfig: { max_turns: 1, max_time_minutes: 1 },
+        toolConfig: { tools: [] },
+    };
+    const mockRemoteAgentDef = {
+        kind: 'remote',
+        name: 'remote_agent',
+        description: 'A remote agent',
+        agentCardUrl: 'https://example.com/agent.json',
+        inputConfig: {
+            inputs: {
+                query: { type: 'string', description: 'Query', required: true },
+            },
+        },
+    };
+    beforeEach(() => {
+        config = {
+            getDebugMode: () => false,
+            getActiveModel: () => 'test-model',
+            modelConfigService: {
+                registerRuntimeModelConfig: vi.fn(),
+            },
+        };
+        registry = new AgentRegistry(config);
+        // Manually register the mock agent (bypassing protected method for testing)
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        registry.agents.set(mockAgentDef.name, mockAgentDef);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        registry.agents.set(mockRemoteAgentDef.name, mockRemoteAgentDef);
+        messageBus = createMockMessageBus();
+        tool = new DelegateToAgentTool(registry, config, messageBus);
+    });
+    it('should use dynamic description from registry', () => {
+        // registry has mockAgentDef registered in beforeEach
+        expect(tool.description).toContain('Delegates a task to a specialized sub-agent');
+        expect(tool.description).toContain(`- **${mockAgentDef.name}**: ${mockAgentDef.description}`);
+    });
+    it('should validate agent_name exists in registry', async () => {
+        // Zod validation happens at build time now (or rather, build validates the schema)
+        // Since we use discriminated union, an invalid agent_name won't match any option.
+        expect(() => tool.build({
+            agent_name: 'non_existent_agent',
+        })).toThrow();
+    });
+    it('should validate correct arguments', async () => {
+        const invocation = tool.build({
+            agent_name: 'test_agent',
+            arg1: 'valid',
+        });
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result).toEqual({ content: [{ type: 'text', text: 'Success' }] });
+        expect(LocalSubagentInvocation).toHaveBeenCalledWith(mockAgentDef, config, { arg1: 'valid' }, messageBus, mockAgentDef.name, mockAgentDef.name);
+    });
+    it('should throw error for missing required argument', async () => {
+        // Missing arg1 should fail Zod validation
+        expect(() => tool.build({
+            agent_name: 'test_agent',
+            arg2: 123,
+        })).toThrow();
+    });
+    it('should throw error for invalid argument type', async () => {
+        // arg1 should be string, passing number
+        expect(() => tool.build({
+            agent_name: 'test_agent',
+            arg1: 123,
+        })).toThrow();
+    });
+    it('should allow optional arguments to be omitted', async () => {
+        const invocation = tool.build({
+            agent_name: 'test_agent',
+            arg1: 'valid',
+            // arg2 is optional
+        });
+        await expect(invocation.execute(new AbortController().signal)).resolves.toBeDefined();
+    });
+    it('should throw error if an agent has an input named "agent_name"', () => {
+        const invalidAgentDef = {
+            ...mockAgentDef,
+            name: 'invalid_agent',
+            inputConfig: {
+                inputs: {
+                    agent_name: {
+                        type: 'string',
+                        description: 'Conflict',
+                        required: true,
+                    },
+                },
+            },
+        };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        registry.agents.set(invalidAgentDef.name, invalidAgentDef);
+        expect(() => new DelegateToAgentTool(registry, config, messageBus)).toThrow("Agent 'invalid_agent' cannot have an input parameter named 'agent_name' as it is a reserved parameter for delegation.");
+    });
+    it('should use correct tool name "delegate_to_agent" when requesting confirmation', async () => {
+        const invocation = tool.build({
+            agent_name: 'test_agent',
+            arg1: 'valid',
+        });
+        // Trigger confirmation check
+        const p = invocation.shouldConfirmExecute(new AbortController().signal);
+        void p;
+        expect(messageBus.publish).toHaveBeenCalledWith(expect.objectContaining({
+            type: MessageBusType.TOOL_CONFIRMATION_REQUEST,
+            toolCall: expect.objectContaining({
+                name: DELEGATE_TO_AGENT_TOOL_NAME,
+            }),
+        }));
+    });
+    it('should delegate to remote agent correctly', async () => {
+        const invocation = tool.build({
+            agent_name: 'remote_agent',
+            query: 'hello remote',
+        });
+        const result = await invocation.execute(new AbortController().signal);
+        expect(result).toEqual({
+            content: [{ type: 'text', text: 'Remote Success' }],
+        });
+        expect(RemoteAgentInvocation).toHaveBeenCalledWith(mockRemoteAgentDef, { query: 'hello remote' }, messageBus, 'remote_agent', 'remote_agent');
+    });
+});
+//# sourceMappingURL=delegate-to-agent-tool.test.js.map

package/dist/src/agents/delegate-to-agent-tool.test.js.map

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

package/dist/src/agents/introspection-agent.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AgentDefinition } from './types.js';
+import { z } from 'zod';
+declare const IntrospectionReportSchema: z.ZodObject<{
+    answer: z.ZodString;
+    sources: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    sources: string[];
+    answer: string;
+}, {
+    sources: string[];
+    answer: string;
+}>;
+/**
+ * An agent specialized in answering questions about Gemini CLI itself,
+ * using its own documentation and runtime state.
+ */
+export declare const IntrospectionAgent: AgentDefinition<typeof IntrospectionReportSchema>;
+export {};

package/dist/src/agents/introspection-agent.js

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GET_INTERNAL_DOCS_TOOL_NAME } from '../tools/tool-names.js';
+import { GEMINI_MODEL_ALIAS_FLASH } from '../config/models.js';
+import { z } from 'zod';
+const IntrospectionReportSchema = z.object({
+    answer: z
+        .string()
+        .describe('The detailed answer to the user question about Gemini CLI.'),
+    sources: z
+        .array(z.string())
+        .describe('The documentation files used to answer the question.'),
+});
+/**
+ * An agent specialized in answering questions about Gemini CLI itself,
+ * using its own documentation and runtime state.
+ */
+export const IntrospectionAgent = {
+    name: 'introspection_agent',
+    kind: 'local',
+    displayName: 'Introspection Agent',
+    description: 'Specialized in answering questions about yourself (Gemini CLI): features, documentation, and current runtime configuration.',
+    inputConfig: {
+        inputs: {
+            question: {
+                description: 'The specific question about Gemini CLI.',
+                type: 'string',
+                required: true,
+            },
+        },
+    },
+    outputConfig: {
+        outputName: 'report',
+        description: 'The final answer and sources as a JSON object.',
+        schema: IntrospectionReportSchema,
+    },
+    processOutput: (output) => JSON.stringify(output, null, 2),
+    modelConfig: {
+        model: GEMINI_MODEL_ALIAS_FLASH,
+        temp: 0.1,
+        top_p: 0.95,
+        thinkingBudget: -1,
+    },
+    runConfig: {
+        max_time_minutes: 3,
+        max_turns: 10,
+    },
+    toolConfig: {
+        tools: [GET_INTERNAL_DOCS_TOOL_NAME],
+    },
+    promptConfig: {
+        query: 'Your task is to answer the following question about Gemini CLI:\n' +
+            '<question>\n' +
+            '${question}\n' +
+            '</question>',
+        systemPrompt: "You are **Introspection Agent**, an expert on Gemini CLI. Your purpose is to provide accurate information about Gemini CLI's features, configuration, and current state.\n\n" +
+            '### Runtime Context\n' +
+            '- **CLI Version:** ${cliVersion}\n' +
+            '- **Active Model:** ${activeModel}\n' +
+            "- **Today's Date:** ${today}\n\n" +
+            '### Instructions\n' +
+            "1. **Explore Documentation**: Use the `get_internal_docs` tool to find answers. If you don't know where to start, call `get_internal_docs()` without arguments to see the full list of available documentation files.\n" +
+            '2. **Be Precise**: Use the provided runtime context and documentation to give exact answers.\n' +
+            '3. **Cite Sources**: Always include the specific documentation files you used in your final report.\n' +
+            '4. **Non-Interactive**: You operate in a loop and cannot ask the user for more info. If the question is ambiguous, answer as best as you can with the information available.\n\n' +
+            'You MUST call `complete_task` with a JSON report containing your `answer` and the `sources` you used.',
+    },
+};
+//# sourceMappingURL=introspection-agent.js.map

package/dist/src/agents/introspection-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection-agent.js","sourceRoot":"","sources":["../../../src/agents/introspection-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CAAC,4DAA4D,CAAC;IACzE,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAE3B;IACF,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,qBAAqB;IAClC,WAAW,EACT,6HAA6H;IAC/H,WAAW,EAAE;QACX,MAAM,EAAE;YACN,QAAQ,EAAE;gBACR,WAAW,EAAE,yCAAyC;gBACtD,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,gDAAgD;QAC7D,MAAM,EAAE,yBAAyB;KAClC;IAED,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,WAAW,EAAE;QACX,KAAK,EAAE,wBAAwB;QAC/B,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,CAAC,CAAC;KACnB;IAED,SAAS,EAAE;QACT,gBAAgB,EAAE,CAAC;QACnB,SAAS,EAAE,EAAE;KACd;IAED,UAAU,EAAE;QACV,KAAK,EAAE,CAAC,2BAA2B,CAAC;KACrC;IAED,YAAY,EAAE;QACZ,KAAK,EACH,mEAAmE;YACnE,cAAc;YACd,eAAe;YACf,aAAa;QACf,YAAY,EACV,8KAA8K;YAC9K,uBAAuB;YACvB,oCAAoC;YACpC,sCAAsC;YACtC,kCAAkC;YAClC,oBAAoB;YACpB,yNAAyN;YACzN,gGAAgG;YAChG,uGAAuG;YACvG,kLAAkL;YAClL,uGAAuG;KAC1G;CACF,CAAC"}

package/dist/src/agents/introspection-agent.test.d.ts

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

package/dist/src/agents/introspection-agent.test.js

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { IntrospectionAgent } from './introspection-agent.js';
+import { GET_INTERNAL_DOCS_TOOL_NAME } from '../tools/tool-names.js';
+import { GEMINI_MODEL_ALIAS_FLASH } from '../config/models.js';
+describe('IntrospectionAgent', () => {
+    const localAgent = IntrospectionAgent;
+    it('should have the correct agent definition metadata', () => {
+        expect(localAgent.name).toBe('introspection_agent');
+        expect(localAgent.kind).toBe('local');
+        expect(localAgent.displayName).toBe('Introspection Agent');
+        expect(localAgent.description).toContain('Gemini CLI');
+    });
+    it('should have correctly configured inputs and outputs', () => {
+        expect(localAgent.inputConfig.inputs['question']).toBeDefined();
+        expect(localAgent.inputConfig.inputs['question'].required).toBe(true);
+        expect(localAgent.outputConfig?.outputName).toBe('report');
+        expect(localAgent.outputConfig?.description).toBeDefined();
+    });
+    it('should use the correct model and tools', () => {
+        expect(localAgent.modelConfig?.model).toBe(GEMINI_MODEL_ALIAS_FLASH);
+        const tools = localAgent.toolConfig?.tools || [];
+        const hasInternalDocsTool = tools.includes(GET_INTERNAL_DOCS_TOOL_NAME);
+        expect(hasInternalDocsTool).toBe(true);
+    });
+    it('should have expected prompt placeholders', () => {
+        const systemPrompt = localAgent.promptConfig.systemPrompt || '';
+        expect(systemPrompt).toContain('${cliVersion}');
+        expect(systemPrompt).toContain('${activeModel}');
+        expect(systemPrompt).toContain('${today}');
+        const query = localAgent.promptConfig.query || '';
+        expect(query).toContain('${question}');
+    });
+    it('should process output to a formatted JSON string', () => {
+        const mockOutput = {
+            answer: 'This is the answer.',
+            sources: ['file1.md', 'file2.md'],
+        };
+        const processed = localAgent.processOutput?.(mockOutput);
+        expect(processed).toBe(JSON.stringify(mockOutput, null, 2));
+    });
+});
+//# sourceMappingURL=introspection-agent.test.js.map

package/dist/src/agents/introspection-agent.test.js.map

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

package/dist/src/agents/local-executor.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { LocalAgentDefinition, AgentInputs, OutputObject, SubagentActivityEvent } from './types.js';
+import { type z } from 'zod';
+/** A callback function to report on agent activity. */
+export type ActivityCallback = (activity: SubagentActivityEvent) => void;
+/**
+ * Executes an agent loop based on an {@link AgentDefinition}.
+ *
+ * This executor runs the agent in a loop, calling tools until it calls the
+ * mandatory `complete_task` tool to signal completion.
+ */
+export declare class LocalAgentExecutor<TOutput extends z.ZodTypeAny> {
+    readonly definition: LocalAgentDefinition<TOutput>;
+    private readonly agentId;
+    private readonly toolRegistry;
+    private readonly runtimeContext;
+    private readonly onActivity?;
+    private readonly compressionService;
+    private hasFailedCompressionAttempt;
+    /**
+     * Creates and validates a new `AgentExecutor` instance.
+     *
+     * This method ensures that all tools specified in the agent's definition are
+     * safe for non-interactive use before creating the executor.
+     *
+     * @param definition The definition object for the agent.
+     * @param runtimeContext The global runtime configuration.
+     * @param onActivity An optional callback to receive activity events.
+     * @returns A promise that resolves to a new `LocalAgentExecutor` instance.
+     */
+    static create<TOutput extends z.ZodTypeAny>(definition: LocalAgentDefinition<TOutput>, runtimeContext: Config, onActivity?: ActivityCallback): Promise<LocalAgentExecutor<TOutput>>;
+    /**
+     * Constructs a new AgentExecutor instance.
+     *
+     * @private This constructor is private. Use the static `create` method to
+     * instantiate the class.
+     */
+    private constructor();
+    /**
+     * Executes a single turn of the agent's logic, from calling the model
+     * to processing its response.
+     *
+     * @returns An {@link AgentTurnResult} object indicating whether to continue
+     * or stop the agent loop.
+     */
+    private executeTurn;
+    /**
+     * Generates a specific warning message for the agent's final turn.
+     */
+    private getFinalWarningMessage;
+    /**
+     * Attempts a single, final recovery turn if the agent stops for a recoverable reason.
+     * Gives the agent a grace period to call `complete_task`.
+     *
+     * @returns The final result string if recovery was successful, or `null` if it failed.
+     */
+    private executeFinalWarningTurn;
+    /**
+     * Runs the agent.
+     *
+     * @param inputs The validated input parameters for this invocation.
+     * @param signal An `AbortSignal` for cancellation.
+     * @returns A promise that resolves to the agent's final output.
+     */
+    run(inputs: AgentInputs, signal: AbortSignal): Promise<OutputObject>;
+    private tryCompressChat;
+    /**
+     * Calls the generative model with the current context and tools.
+     *
+     * @returns The model's response, including any tool calls or text.
+     */
+    private callModel;
+    /** Initializes a `GeminiChat` instance for the agent run. */
+    private createChatObject;
+    /**
+     * Executes function calls requested by the model and returns the results.
+     *
+     * @returns A new `Content` object for history, any submitted output, and completion status.
+     */
+    private processFunctionCalls;
+    /**
+     * Prepares the list of tool function declarations to be sent to the model.
+     */
+    private prepareToolsList;
+    /** Builds the system prompt from the agent definition and inputs. */
+    private buildSystemPrompt;
+    /**
+     * Applies template strings to initial messages.
+     *
+     * @param initialMessages The initial messages from the prompt config.
+     * @param inputs The validated input parameters for this invocation.
+     * @returns A new array of `Content` with templated strings.
+     */
+    private applyTemplateToInitialMessages;
+    /**
+     * Checks if the agent should terminate due to exceeding configured limits.
+     *
+     * @returns The reason for termination, or `null` if execution can continue.
+     */
+    private checkTermination;
+    /** Emits an activity event to the configured callback. */
+    private emitActivity;
+}