@google/gemini-cli-core 0.24.0-preview.0 → 0.25.0-nightly.20260112.15891721a

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

@@ -0,0 +1,283 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { parseAgentMarkdown, markdownToAgentDefinition, loadAgentsFromDirectory, AgentLoadError, } from './agentLoader.js';
+import { GEMINI_MODEL_ALIAS_PRO } from '../config/models.js';
+describe('loader', () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'agent-test-'));
+    });
+    afterEach(async () => {
+        if (tempDir) {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+    });
+    async function writeAgentMarkdown(content, fileName = 'test.md') {
+        const filePath = path.join(tempDir, fileName);
+        await fs.writeFile(filePath, content);
+        return filePath;
+    }
+    describe('parseAgentMarkdown', () => {
+        it('should parse a valid markdown agent file', async () => {
+            const filePath = await writeAgentMarkdown(`---
+name: test-agent-md
+description: A markdown agent
+---
+You are a markdown agent.`);
+            const result = await parseAgentMarkdown(filePath);
+            expect(result).toHaveLength(1);
+            expect(result[0]).toMatchObject({
+                name: 'test-agent-md',
+                description: 'A markdown agent',
+                kind: 'local',
+                system_prompt: 'You are a markdown agent.',
+            });
+        });
+        it('should parse frontmatter with tools and model config', async () => {
+            const filePath = await writeAgentMarkdown(`---
+name: complex-agent
+description: A complex markdown agent
+tools:
+  - run_shell_command
+model: gemini-pro
+temperature: 0.7
+---
+System prompt content.`);
+            const result = await parseAgentMarkdown(filePath);
+            expect(result).toHaveLength(1);
+            expect(result[0]).toMatchObject({
+                name: 'complex-agent',
+                description: 'A complex markdown agent',
+                tools: ['run_shell_command'],
+                model: 'gemini-pro',
+                temperature: 0.7,
+                system_prompt: 'System prompt content.',
+            });
+        });
+        it('should throw AgentLoadError if frontmatter is missing', async () => {
+            const filePath = await writeAgentMarkdown(`Just some markdown content.`);
+            await expect(parseAgentMarkdown(filePath)).rejects.toThrow(AgentLoadError);
+            await expect(parseAgentMarkdown(filePath)).rejects.toThrow('Invalid markdown format');
+        });
+        it('should throw AgentLoadError if frontmatter is invalid YAML', async () => {
+            const filePath = await writeAgentMarkdown(`---
+name: [invalid yaml
+---
+Body`);
+            await expect(parseAgentMarkdown(filePath)).rejects.toThrow(AgentLoadError);
+            await expect(parseAgentMarkdown(filePath)).rejects.toThrow('YAML frontmatter parsing failed');
+        });
+        it('should throw AgentLoadError if validation fails (missing required field)', async () => {
+            const filePath = await writeAgentMarkdown(`---
+name: test-agent
+# missing description
+---
+Body`);
+            await expect(parseAgentMarkdown(filePath)).rejects.toThrow(/Validation failed/);
+        });
+        it('should throw AgentLoadError if tools list includes forbidden tool', async () => {
+            const filePath = await writeAgentMarkdown(`---
+name: test-agent
+description: Test
+tools:
+  - delegate_to_agent
+---
+Body`);
+            await expect(parseAgentMarkdown(filePath)).rejects.toThrow(/tools list cannot include 'delegate_to_agent'/);
+        });
+        it('should parse a valid remote agent markdown file', async () => {
+            const filePath = await writeAgentMarkdown(`---
+kind: remote
+name: remote-agent
+description: A remote agent
+agent_card_url: https://example.com/card
+---
+`);
+            const result = await parseAgentMarkdown(filePath);
+            expect(result).toHaveLength(1);
+            expect(result[0]).toEqual({
+                kind: 'remote',
+                name: 'remote-agent',
+                description: 'A remote agent',
+                agent_card_url: 'https://example.com/card',
+            });
+        });
+        it('should infer remote agent kind from agent_card_url', async () => {
+            const filePath = await writeAgentMarkdown(`---
+name: inferred-remote
+description: Inferred
+agent_card_url: https://example.com/inferred
+---
+`);
+            const result = await parseAgentMarkdown(filePath);
+            expect(result).toHaveLength(1);
+            expect(result[0]).toEqual({
+                kind: 'remote',
+                name: 'inferred-remote',
+                description: 'Inferred',
+                agent_card_url: 'https://example.com/inferred',
+            });
+        });
+        it('should parse a remote agent with no body', async () => {
+            const filePath = await writeAgentMarkdown(`---
+kind: remote
+name: no-body-remote
+agent_card_url: https://example.com/card
+---
+`);
+            const result = await parseAgentMarkdown(filePath);
+            expect(result).toHaveLength(1);
+            expect(result[0]).toEqual({
+                kind: 'remote',
+                name: 'no-body-remote',
+                agent_card_url: 'https://example.com/card',
+            });
+        });
+        it('should parse multiple remote agents in a list', async () => {
+            const filePath = await writeAgentMarkdown(`---
+- kind: remote
+  name: remote-1
+  agent_card_url: https://example.com/1
+- kind: remote
+  name: remote-2
+  agent_card_url: https://example.com/2
+---
+`);
+            const result = await parseAgentMarkdown(filePath);
+            expect(result).toHaveLength(2);
+            expect(result[0]).toEqual({
+                kind: 'remote',
+                name: 'remote-1',
+                agent_card_url: 'https://example.com/1',
+            });
+            expect(result[1]).toEqual({
+                kind: 'remote',
+                name: 'remote-2',
+                agent_card_url: 'https://example.com/2',
+            });
+        });
+    });
+    describe('markdownToAgentDefinition', () => {
+        it('should convert valid Markdown DTO to AgentDefinition with defaults', () => {
+            const markdown = {
+                kind: 'local',
+                name: 'test-agent',
+                description: 'A test agent',
+                system_prompt: 'You are a test agent.',
+            };
+            const result = markdownToAgentDefinition(markdown);
+            expect(result).toMatchObject({
+                name: 'test-agent',
+                description: 'A test agent',
+                promptConfig: {
+                    systemPrompt: 'You are a test agent.',
+                    query: '${query}',
+                },
+                modelConfig: {
+                    model: 'inherit',
+                    top_p: 0.95,
+                },
+                runConfig: {
+                    max_time_minutes: 5,
+                },
+                inputConfig: {
+                    inputs: {
+                        query: {
+                            type: 'string',
+                            required: false,
+                        },
+                    },
+                },
+            });
+        });
+        it('should pass through model aliases', () => {
+            const markdown = {
+                kind: 'local',
+                name: 'test-agent',
+                description: 'A test agent',
+                model: GEMINI_MODEL_ALIAS_PRO,
+                system_prompt: 'You are a test agent.',
+            };
+            const result = markdownToAgentDefinition(markdown);
+            expect(result.modelConfig.model).toBe(GEMINI_MODEL_ALIAS_PRO);
+        });
+        it('should pass through unknown model names (e.g. auto)', () => {
+            const markdown = {
+                kind: 'local',
+                name: 'test-agent',
+                description: 'A test agent',
+                model: 'auto',
+                system_prompt: 'You are a test agent.',
+            };
+            const result = markdownToAgentDefinition(markdown);
+            expect(result.modelConfig.model).toBe('auto');
+        });
+        it('should convert remote agent definition', () => {
+            const markdown = {
+                kind: 'remote',
+                name: 'remote-agent',
+                description: 'A remote agent',
+                agent_card_url: 'https://example.com/card',
+            };
+            const result = markdownToAgentDefinition(markdown);
+            expect(result).toEqual({
+                kind: 'remote',
+                name: 'remote-agent',
+                description: 'A remote agent',
+                displayName: undefined,
+                agentCardUrl: 'https://example.com/card',
+                inputConfig: {
+                    inputs: {
+                        query: {
+                            type: 'string',
+                            description: 'The task for the agent.',
+                            required: false,
+                        },
+                    },
+                },
+            });
+        });
+    });
+    describe('loadAgentsFromDirectory', () => {
+        it('should load definitions from a directory (Markdown only)', async () => {
+            await writeAgentMarkdown(`---
+name: agent-1
+description: Agent 1
+---
+Prompt 1`, 'valid.md');
+            // Create a non-supported file
+            await fs.writeFile(path.join(tempDir, 'other.txt'), 'content');
+            // Create a hidden file
+            await writeAgentMarkdown(`---
+name: hidden
+description: Hidden
+---
+Hidden`, '_hidden.md');
+            const result = await loadAgentsFromDirectory(tempDir);
+            expect(result.agents).toHaveLength(1);
+            expect(result.agents[0].name).toBe('agent-1');
+            expect(result.errors).toHaveLength(0);
+        });
+        it('should return empty result if directory does not exist', async () => {
+            const nonExistentDir = path.join(tempDir, 'does-not-exist');
+            const result = await loadAgentsFromDirectory(nonExistentDir);
+            expect(result.agents).toHaveLength(0);
+            expect(result.errors).toHaveLength(0);
+        });
+        it('should capture errors for malformed individual files', async () => {
+            // Create a malformed Markdown file
+            await writeAgentMarkdown('invalid markdown', 'malformed.md');
+            const result = await loadAgentsFromDirectory(tempDir);
+            expect(result.agents).toHaveLength(0);
+            expect(result.errors).toHaveLength(1);
+        });
+    });
+});
+//# sourceMappingURL=agentLoader.test.js.map

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

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

package/dist/src/agents/{introspection-agent.d.ts → cli-help-agent.d.ts}

@@ -5,7 +5,8 @@
  */
 import type { AgentDefinition } from './types.js';
 import { z } from 'zod';
-declare const IntrospectionReportSchema: z.ZodObject<{
+import type { Config } from '../config/config.js';
+declare const CliHelpReportSchema: z.ZodObject<{
     answer: z.ZodString;
     sources: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -19,5 +20,5 @@ declare const IntrospectionReportSchema: z.ZodObject<{
  * 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 declare const CliHelpAgent: (config: Config) => AgentDefinition<typeof CliHelpReportSchema>;
 export {};

package/dist/src/agents/{introspection-agent.js → cli-help-agent.js}

@@ -3,10 +3,10 @@
  * 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({
+import { GetInternalDocsTool } from '../tools/get-internal-docs.js';
+const CliHelpReportSchema = z.object({
     answer: z
         .string()
         .describe('The detailed answer to the user question about Gemini CLI.'),
@@ -18,11 +18,11 @@ const IntrospectionReportSchema = z.object({
  * An agent specialized in answering questions about Gemini CLI itself,
  * using its own documentation and runtime state.
  */
-export const IntrospectionAgent = {
-    name: 'introspection_agent',
+export const CliHelpAgent = (config) => ({
+    name: 'cli_help',
     kind: 'local',
-    displayName: 'Introspection Agent',
-    description: 'Specialized in answering questions about yourself (Gemini CLI): features, documentation, and current runtime configuration.',
+    displayName: 'CLI Help Agent',
+    description: 'Specialized in answering questions about how users use you, (Gemini CLI): features, documentation, and current runtime configuration.',
     inputConfig: {
         inputs: {
             question: {
@@ -35,7 +35,7 @@ export const IntrospectionAgent = {
     outputConfig: {
         outputName: 'report',
         description: 'The final answer and sources as a JSON object.',
-        schema: IntrospectionReportSchema,
+        schema: CliHelpReportSchema,
     },
     processOutput: (output) => JSON.stringify(output, null, 2),
     modelConfig: {
@@ -49,18 +49,24 @@ export const IntrospectionAgent = {
         max_turns: 10,
     },
     toolConfig: {
-        tools: [GET_INTERNAL_DOCS_TOOL_NAME],
+        tools: [new GetInternalDocsTool(config.getMessageBus())],
     },
     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" +
+        systemPrompt: "You are **CLI Help 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" +
+            (config.isAgentsEnabled()
+                ? '### Sub-Agents (Local & Remote)\n' +
+                    'User defined sub-agents are defined in `.gemini/agents/` or `~/.gemini/agents/` using YAML frontmatter for metadata and Markdown for instructions (system_prompt). Always reference the types and properties outlined here directly when answering questions about sub-agents.\n' +
+                    '- **Local Agent:** `kind = "local"`, `name`, `description`, `prompts.system_prompt`, and optional `tools`, `model`, `run`.\n' +
+                    '- **Remote Agent (A2A):** `kind = "remote"`, `name`, `agent_card_url`. Multiple remotes can be defined using a `remote_agents` array. **Note:** When users ask about "remote agents", they are referring to this Agent2Agent functionality, which is completely distinct from MCP servers.\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' +
@@ -68,5 +74,5 @@ export const IntrospectionAgent = {
             '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
+});
+//# sourceMappingURL=cli-help-agent.js.map

package/dist/src/agents/cli-help-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-help-agent.js","sourceRoot":"","sources":["../../../src/agents/cli-help-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,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,YAAY,GAAG,CAC1B,MAAc,EAC+B,EAAE,CAAC,CAAC;IACjD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EACT,uIAAuI;IACzI,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,mBAAmB;KAC5B;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,IAAI,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;KACzD;IAED,YAAY,EAAE;QACZ,KAAK,EACH,mEAAmE;YACnE,cAAc;YACd,eAAe;YACf,aAAa;QACf,YAAY,EACV,yKAAyK;YACzK,uBAAuB;YACvB,oCAAoC;YACpC,sCAAsC;YACtC,kCAAkC;YAClC,CAAC,MAAM,CAAC,eAAe,EAAE;gBACvB,CAAC,CAAC,mCAAmC;oBACnC,kRAAkR;oBAClR,8HAA8H;oBAC9H,gSAAgS;gBAClS,CAAC,CAAC,EAAE,CAAC;YACP,oBAAoB;YACpB,yNAAyN;YACzN,gGAAgG;YAChG,uGAAuG;YACvG,kLAAkL;YAClL,uGAAuG;KAC1G;CACF,CAAC,CAAC"}

package/dist/src/agents/{introspection-agent.test.js → cli-help-agent.test.js}

@@ -4,15 +4,19 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { describe, it, expect } from 'vitest';
-import { IntrospectionAgent } from './introspection-agent.js';
+import { CliHelpAgent } from './cli-help-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;
+describe('CliHelpAgent', () => {
+    const fakeConfig = {
+        getMessageBus: () => ({}),
+        isAgentsEnabled: () => false,
+    };
+    const localAgent = CliHelpAgent(fakeConfig);
     it('should have the correct agent definition metadata', () => {
-        expect(localAgent.name).toBe('introspection_agent');
+        expect(localAgent.name).toBe('cli_help');
         expect(localAgent.kind).toBe('local');
-        expect(localAgent.displayName).toBe('Introspection Agent');
+        expect(localAgent.displayName).toBe('CLI Help Agent');
         expect(localAgent.description).toContain('Gemini CLI');
     });
     it('should have correctly configured inputs and outputs', () => {
@@ -24,7 +28,7 @@ describe('IntrospectionAgent', () => {
     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);
+        const hasInternalDocsTool = tools.some((t) => typeof t !== 'string' && t.name === GET_INTERNAL_DOCS_TOOL_NAME);
         expect(hasInternalDocsTool).toBe(true);
     });
     it('should have expected prompt placeholders', () => {
@@ -35,6 +39,20 @@ describe('IntrospectionAgent', () => {
         const query = localAgent.promptConfig.query || '';
         expect(query).toContain('${question}');
     });
+    it('should include sub-agent information when agents are enabled', () => {
+        const enabledConfig = {
+            getMessageBus: () => ({}),
+            isAgentsEnabled: () => true,
+            getAgentRegistry: () => ({
+                getDirectoryContext: () => 'Mock Agent Directory',
+            }),
+        };
+        const agent = CliHelpAgent(enabledConfig);
+        const systemPrompt = agent.promptConfig.systemPrompt || '';
+        expect(systemPrompt).toContain('### Sub-Agents (Local & Remote)');
+        expect(systemPrompt).toContain('Remote Agent (A2A)');
+        expect(systemPrompt).toContain('Agent2Agent functionality');
+    });
     it('should process output to a formatted JSON string', () => {
         const mockOutput = {
             answer: 'This is the answer.',
@@ -44,4 +62,4 @@ describe('IntrospectionAgent', () => {
         expect(processed).toBe(JSON.stringify(mockOutput, null, 2));
     });
 });
-//# sourceMappingURL=introspection-agent.test.js.map
+//# sourceMappingURL=cli-help-agent.test.js.map

package/dist/src/agents/cli-help-agent.test.js.map

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

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

@@ -95,21 +95,28 @@ class DelegateInvocation extends BaseToolInvocation {
     getDescription() {
         return `Delegating to agent '${this.params.agent_name}'`;
     }
+    async shouldConfirmExecute(abortSignal) {
+        const definition = this.registry.getDefinition(this.params.agent_name);
+        if (!definition || definition.kind !== 'remote') {
+            // Local agents should execute without confirmation. Inner tool calls will bubble up their own confirmations to the user.
+            return false;
+        }
+        const { agent_name: _agent_name, ...agentArgs } = this.params;
+        const invocation = this.buildSubInvocation(definition, agentArgs);
+        return invocation.shouldConfirmExecute(abortSignal);
+    }
     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.`);
+            throw new Error(`Agent '${this.params.agent_name}' not found in 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);
+        const { agent_name: _agent_name, ...agentArgs } = this.params;
+        const invocation = this.buildSubInvocation(definition, agentArgs);
         return invocation.execute(signal, updateOutput);
     }
+    buildSubInvocation(definition, agentArgs) {
+        const wrapper = new SubagentToolWrapper(definition, this.config, this.messageBus);
+        return wrapper.build(agentArgs);
+    }
 }
 //# sourceMappingURL=delegate-to-agent-tool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"delegate-to-agent-tool.js","sourceRoot":"","sources":["../../../src/agents/delegate-to-agent-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"delegate-to-agent-tool.js","sourceRoot":"","sources":["../../../src/agents/delegate-to-agent-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,IAAI,EAGJ,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAKrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIjE,MAAM,OAAO,mBAAoB,SAAQ,mBAGxC;IAEoB;IACA;IAFnB,YACmB,QAAuB,EACvB,MAAc,EAC/B,UAAsB;QAEtB,MAAM,WAAW,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAEjD,IAAI,MAAoB,CAAC;QAEzB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,mEAAmE;YACnE,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;gBAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;aACtE,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC3C,MAAM,UAAU,GAAiC;oBAC/C,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC;iBAC1D,CAAC;gBAEF,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrE,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;wBACzB,MAAM,IAAI,KAAK,CACb,UAAU,GAAG,CAAC,IAAI,mGAAmG,CACtH,CAAC;oBACJ,CAAC;oBAED,IAAI,SAAuB,CAAC;oBAE5B,yBAAyB;oBACzB,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;wBACtB,KAAK,QAAQ;4BACX,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;4BACvB,MAAM;wBACR,KAAK,QAAQ;4BACX,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;4BACvB,MAAM;wBACR,KAAK,SAAS;4BACZ,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;4BACxB,MAAM;wBACR,KAAK,SAAS;4BACZ,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;4BAC7B,MAAM;wBACR,KAAK,UAAU;4BACb,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;4BAChC,MAAM;wBACR,KAAK,UAAU;4BACb,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;4BAChC,MAAM;wBACR,OAAO,CAAC,CAAC,CAAC;4BACR,sDAAsD;4BACtD,MAAM,gBAAgB,GAAU,QAAQ,CAAC,IAAI,CAAC;4BAC9C,KAAK,gBAAgB,CAAC;4BACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;wBACpE,CAAC;oBACH,CAAC;oBAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;wBACvB,SAAS,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;oBACnC,CAAC;oBAED,UAAU,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;gBAC7D,CAAC;gBAED,4EAA4E;gBAC5E,OAAO,CAAC,CAAC,MAAM,CACb,UAAU,CACoC,CAAC;YACnD,CAAC,CAAC,CAAC;YAEH,iCAAiC;YACjC,uFAAuF;YACvF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,CAAC,kBAAkB,CAC3B,YAAY,EACZ,YAIC,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,CACH,2BAA2B,EAC3B,mBAAmB,EACnB,QAAQ,CAAC,kBAAkB,EAAE,EAC7B,IAAI,CAAC,KAAK,EACV,eAAe,CAAC,MAAM,CAAC,EACvB,UAAU;QACV,sBAAsB,CAAC,IAAI;QAC3B,qBAAqB,CAAC,IAAI,CAC3B,CAAC;QA9Fe,aAAQ,GAAR,QAAQ,CAAe;QACvB,WAAM,GAAN,MAAM,CAAQ;IA8FjC,CAAC;IAES,gBAAgB,CACxB,MAAsB,EACtB,UAAsB,EACtB,SAAkB,EAClB,gBAAyB;QAEzB,OAAO,IAAI,kBAAkB,CAC3B,MAAM,EACN,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,MAAM,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,CACjB,CAAC;IACJ,CAAC;CACF;AAED,MAAM,kBAAmB,SAAQ,kBAGhC;IAGoB;IACA;IAHnB,YACE,MAAsB,EACL,QAAuB,EACvB,MAAc,EAC/B,UAAsB,EACtB,SAAkB,EAClB,gBAAyB;QAEzB,KAAK,CACH,MAAM,EACN,UAAU,EACV,SAAS,IAAI,2BAA2B,EACxC,gBAAgB,CACjB,CAAC;QAXe,aAAQ,GAAR,QAAQ,CAAe;QACvB,WAAM,GAAN,MAAM,CAAQ;IAWjC,CAAC;IAED,cAAc;QACZ,OAAO,wBAAwB,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC;IAC3D,CAAC;IAEQ,KAAK,CAAC,oBAAoB,CACjC,WAAwB;QAExB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChD,yHAAyH;YACzH,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CACxC,UAAU,EACV,SAAwB,CACzB,CAAC;QACF,OAAO,UAAU,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAmB,EACnB,YAAoD;QAEpD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,0BAA0B,CAC3D,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CACxC,UAAU,EACV,SAAwB,CACzB,CAAC;QAEF,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAEO,kBAAkB,CACxB,UAA2B,EAC3B,SAAsB;QAEtB,MAAM,OAAO,GAAG,IAAI,mBAAmB,CACrC,UAAU,EACV,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,UAAU,CAChB,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;CACF"}

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

@@ -16,6 +16,7 @@ vi.mock('./local-invocation.js', () => ({
         execute: vi
             .fn()
             .mockResolvedValue({ content: [{ type: 'text', text: 'Success' }] }),
+        shouldConfirmExecute: vi.fn().mockResolvedValue(false),
     })),
 }));
 vi.mock('./remote-invocation.js', () => ({
@@ -23,7 +24,12 @@ vi.mock('./remote-invocation.js', () => ({
         execute: vi.fn().mockResolvedValue({
             content: [{ type: 'text', text: 'Remote Success' }],
         }),
-        shouldConfirmExecute: vi.fn().mockResolvedValue(true),
+        shouldConfirmExecute: vi.fn().mockResolvedValue({
+            type: 'info',
+            title: 'Remote Confirmation',
+            prompt: 'Confirm remote call',
+            onConfirm: vi.fn(),
+        }),
     })),
 }));
 describe('DelegateToAgentTool', () => {
@@ -135,20 +141,20 @@ describe('DelegateToAgentTool', () => {
         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 () => {
+    it('should execute local agents silently without 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,
-            }),
-        }));
+        const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+        expect(result).toBe(false);
+        // Verify it did NOT call messageBus.publish with 'delegate_to_agent'
+        const delegateToAgentPublish = vi
+            .mocked(messageBus.publish)
+            .mock.calls.find((call) => call[0].type === MessageBusType.TOOL_CONFIRMATION_REQUEST &&
+            call[0].toolCall.name === DELEGATE_TO_AGENT_TOOL_NAME);
+        expect(delegateToAgentPublish).toBeUndefined();
     });
     it('should delegate to remote agent correctly', async () => {
         const invocation = tool.build({
@@ -161,5 +167,41 @@ describe('DelegateToAgentTool', () => {
         });
         expect(RemoteAgentInvocation).toHaveBeenCalledWith(mockRemoteAgentDef, { query: 'hello remote' }, messageBus, 'remote_agent', 'remote_agent');
     });
+    describe('Confirmation', () => {
+        it('should return false for local agents (silent execution)', async () => {
+            const invocation = tool.build({
+                agent_name: 'test_agent',
+                arg1: 'valid',
+            });
+            // Local agents should now return false directly, bypassing policy check
+            const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(result).toBe(false);
+            const delegateToAgentPublish = vi
+                .mocked(messageBus.publish)
+                .mock.calls.find((call) => call[0].type === MessageBusType.TOOL_CONFIRMATION_REQUEST &&
+                call[0].toolCall.name === DELEGATE_TO_AGENT_TOOL_NAME);
+            expect(delegateToAgentPublish).toBeUndefined();
+        });
+        it('should forward to remote agent confirmation logic', async () => {
+            const invocation = tool.build({
+                agent_name: 'remote_agent',
+                query: 'hello remote',
+            });
+            const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+            // Verify it returns the mock confirmation from RemoteAgentInvocation
+            expect(result).toMatchObject({
+                type: 'info',
+                title: 'Remote Confirmation',
+            });
+            // Verify it did NOT call messageBus.publish with 'delegate_to_agent'
+            // directly from DelegateInvocation, but instead went into RemoteAgentInvocation.
+            // RemoteAgentInvocation (the mock) doesn't call publish in its mock implementation.
+            const delegateToAgentPublish = vi
+                .mocked(messageBus.publish)
+                .mock.calls.find((call) => call[0].type === MessageBusType.TOOL_CONFIRMATION_REQUEST &&
+                call[0].toolCall.name === DELEGATE_TO_AGENT_TOOL_NAME);
+            expect(delegateToAgentPublish).toBeUndefined();
+        });
+    });
 });
 //# sourceMappingURL=delegate-to-agent-tool.test.js.map