@machina.ai/cell-cli-core 1.20.2-rc1 → 1.25.0-rc1

package/dist/src/agents/cli-help-agent.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AgentDefinition } from './types.js';
+import { z } from 'zod';
+import type { Config } from '../config/config.js';
+declare const CliHelpReportSchema: 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 Cell CLI itself,
+ * using its own documentation and runtime state.
+ */
+export declare const CliHelpAgent: (config: Config) => AgentDefinition<typeof CliHelpReportSchema>;
+export {};

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

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GEMINI_MODEL_ALIAS_FLASH } from '../config/models.js';
+import { z } from 'zod';
+import { GetInternalDocsTool } from '../tools/get-internal-docs.js';
+const CliHelpReportSchema = z.object({
+    answer: z
+        .string()
+        .describe('The detailed answer to the user question about Cell CLI.'),
+    sources: z
+        .array(z.string())
+        .describe('The documentation files used to answer the question.'),
+});
+/**
+ * An agent specialized in answering questions about Cell CLI itself,
+ * using its own documentation and runtime state.
+ */
+export const CliHelpAgent = (config) => ({
+    name: 'cli_help',
+    kind: 'local',
+    displayName: 'CLI Help Agent',
+    description: 'Specialized in answering questions about how users use you, (Cell CLI): features, documentation, and current runtime configuration.',
+    inputConfig: {
+        inputs: {
+            question: {
+                description: 'The specific question about Cell CLI.',
+                type: 'string',
+                required: true,
+            },
+        },
+    },
+    outputConfig: {
+        outputName: 'report',
+        description: 'The final answer and sources as a JSON object.',
+        schema: CliHelpReportSchema,
+    },
+    processOutput: (output) => JSON.stringify(output, null, 2),
+    modelConfig: {
+        model: GEMINI_MODEL_ALIAS_FLASH,
+        generateContentConfig: {
+            temperature: 0.1,
+            topP: 0.95,
+            thinkingConfig: {
+                includeThoughts: true,
+                thinkingBudget: -1,
+            },
+        },
+    },
+    runConfig: {
+        maxTimeMinutes: 3,
+        maxTurns: 10,
+    },
+    toolConfig: {
+        tools: [new GetInternalDocsTool(config.getMessageBus())],
+    },
+    promptConfig: {
+        query: 'Your task is to answer the following question about Cell CLI:\n' +
+            '<question>\n' +
+            '${question}\n' +
+            '</question>',
+        systemPrompt: "You are **CLI Help Agent**, an expert on Cell CLI. Your purpose is to provide accurate information about Cell 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 `.cell-cli/agents/` or `~/.cell-cli/agents/` as .md files. **CRITICAL:** These files **MUST** start with YAML frontmatter enclosed in triple-dashes `---`, for example:\n\n```yaml\n---\nname: my-agent\n---\n```\n\nWithout this mandatory frontmatter, the agent will not be discovered or loaded by Cell CLI. The Markdown body following the frontmatter becomes the agent's system prompt (`system_prompt`). Always reference the types and properties outlined here directly when answering questions about sub-agents.\n" +
+                    '- **Local Agent:** `kind = "local"`, `name`, `description`, `system_prompt`, and optional `tools`, `model`, `temperate`, `max_turns`, `timeout_mins`.\n' +
+                    '- **Remote Agent (A2A):** `kind = "remote"`, `name`, `agent_card_url`. Remote Agents do not use `system_prompt`. Multiple remote agents can be defined by using a YAML array at the top level of the frontmatter. **Note:** When users ask about "remote agents", they are referring to this Agent2Agent functionality, which is completely distinct from MCP servers.\n' +
+                    '- **Agent Names:** Must be valid slugs (lowercase letters, numbers, hyphens, and underscores only).\n' +
+                    '- **User Commands:** The user can manage agents using `/agents list` to see all available agents and `/agents refresh` to reload the registry after modifying definition files. You (the agent) cannot run these commands.\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=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,0DAA0D,CAAC;IACvE,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,qIAAqI;IACvI,WAAW,EAAE;QACX,MAAM,EAAE;YACN,QAAQ,EAAE;gBACR,WAAW,EAAE,uCAAuC;gBACpD,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,qBAAqB,EAAE;YACrB,WAAW,EAAE,GAAG;YAChB,IAAI,EAAE,IAAI;YACV,cAAc,EAAE;gBACd,eAAe,EAAE,IAAI;gBACrB,cAAc,EAAE,CAAC,CAAC;aACnB;SACF;KACF;IAED,SAAS,EAAE;QACT,cAAc,EAAE,CAAC;QACjB,QAAQ,EAAE,EAAE;KACb;IAED,UAAU,EAAE;QACV,KAAK,EAAE,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;KACzD;IAED,YAAY,EAAE;QACZ,KAAK,EACH,iEAAiE;YACjE,cAAc;YACd,eAAe;YACf,aAAa;QACf,YAAY,EACV,qKAAqK;YACrK,uBAAuB;YACvB,oCAAoC;YACpC,sCAAsC;YACtC,kCAAkC;YAClC,CAAC,MAAM,CAAC,eAAe,EAAE;gBACvB,CAAC,CAAC,mCAAmC;oBACnC,wiBAAwiB;oBACxiB,yJAAyJ;oBACzJ,0WAA0W;oBAC1W,uGAAuG;oBACvG,gOAAgO;gBAClO,CAAC,CAAC,EAAE,CAAC;YACP,oBAAoB;YACpB,yNAAyN;YACzN,gGAAgG;YAChG,uGAAuG;YACvG,kLAAkL;YAClL,uGAAuG;KAC1G;CACF,CAAC,CAAC"}

package/dist/src/agents/cli-help-agent.test.d.ts

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

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

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+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('CliHelpAgent', () => {
+    const fakeConfig = {
+        getMessageBus: () => ({}),
+        isAgentsEnabled: () => false,
+    };
+    const localAgent = CliHelpAgent(fakeConfig);
+    it('should have the correct agent definition metadata', () => {
+        expect(localAgent.name).toBe('cli_help');
+        expect(localAgent.kind).toBe('local');
+        expect(localAgent.displayName).toBe('CLI Help Agent');
+        expect(localAgent.description).toContain('Cell 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.some((t) => typeof t !== 'string' && t.name === 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 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.',
+            sources: ['file1.md', 'file2.md'],
+        };
+        const processed = localAgent.processOutput?.(mockOutput);
+        expect(processed).toBe(JSON.stringify(mockOutput, null, 2));
+    });
+});
+//# 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/codebase-investigator.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { AgentDefinition } from './types.js';
+import type { LocalAgentDefinition } from './types.js';
 import { z } from 'zod';
 declare const CodebaseInvestigationReportSchema: z.ZodObject<{
     SummaryOfFindings: z.ZodString;
@@ -42,5 +42,5 @@ declare const CodebaseInvestigationReportSchema: z.ZodObject<{
  * A Proof-of-Concept subagent specialized in analyzing codebase structure,
  * dependencies, and technologies.
  */
-export declare const CodebaseInvestigatorAgent: AgentDefinition<typeof CodebaseInvestigationReportSchema>;
+export declare const CodebaseInvestigatorAgent: LocalAgentDefinition<typeof CodebaseInvestigationReportSchema>;
 export {};

package/dist/src/agents/codebase-investigator.js

@@ -28,14 +28,15 @@ const CodebaseInvestigationReportSchema = z.object({
  */
 export const CodebaseInvestigatorAgent = {
     name: 'codebase_investigator',
+    kind: 'local',
     displayName: 'Codebase Investigator Agent',
-    description: `The specialized tool for codebase analysis, architectural mapping, and understanding system-wide dependencies. 
-    Invoke this tool for tasks like vague requests, bug root-cause analysis, system refactoring, comprehensive feature implementation or to answer questions about the codebase that require investigation. 
+    description: `The specialized tool for codebase analysis, architectural mapping, and understanding system-wide dependencies.
+    Invoke this tool for tasks like vague requests, bug root-cause analysis, system refactoring, comprehensive feature implementation or to answer questions about the codebase that require investigation.
     It returns a structured report with key file paths, symbols, and actionable architectural insights.`,
     inputConfig: {
         inputs: {
             objective: {
-                description: `A comprehensive and detailed description of the user's ultimate goal. 
+                description: `A comprehensive and detailed description of the user's ultimate goal.
           You must include original user's objective as well as questions and any extra context and questions you may have.`,
                 type: 'string',
                 required: true,
@@ -51,13 +52,18 @@ export const CodebaseInvestigatorAgent = {
     processOutput: (output) => JSON.stringify(output, null, 2),
     modelConfig: {
         model: DEFAULT_GEMINI_MODEL,
-        temp: 0.1,
-        top_p: 0.95,
-        thinkingBudget: -1,
+        generateContentConfig: {
+            temperature: 0.1,
+            topP: 0.95,
+            thinkingConfig: {
+                includeThoughts: true,
+                thinkingBudget: -1,
+            },
+        },
     },
     runConfig: {
-        max_time_minutes: 5,
-        max_turns: 15,
+        maxTimeMinutes: 5,
+        maxTurns: 15,
     },
     toolConfig: {
         // Grant access only to read-only tools.

package/dist/src/agents/codebase-investigator.js.map

@@ -1 +1 @@
-{"version":3,"file":"codebase-investigator.js","sourceRoot":"","sources":["../../../src/agents/codebase-investigator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sEAAsE;AACtE,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,CACP,+EAA+E,CAChF;IACH,gBAAgB,EAAE,CAAC;SAChB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CACP,yEAAyE,CAC1E;IACH,iBAAiB,EAAE,CAAC;SACjB,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAChC,CAAC,CACH;SACA,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAElC;IACF,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,6BAA6B;IAC1C,WAAW,EAAE;;wGAEyF;IACtG,WAAW,EAAE;QACX,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,WAAW,EAAE;4HACuG;gBACpH,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,kDAAkD;QAC/D,MAAM,EAAE,iCAAiC;KAC1C;IAED,oFAAoF;IACpF,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,WAAW,EAAE;QACX,KAAK,EAAE,oBAAoB;QAC3B,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,wCAAwC;QACxC,KAAK,EAAE,CAAC,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,CAAC;KAC3E;IAED,YAAY,EAAE;QACZ,KAAK,EAAE;;;aAGE;QACT,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DjB;KACE;CACF,CAAC"}
+{"version":3,"file":"codebase-investigator.js","sourceRoot":"","sources":["../../../src/agents/codebase-investigator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sEAAsE;AACtE,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,CACP,+EAA+E,CAChF;IACH,gBAAgB,EAAE,CAAC;SAChB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CACP,yEAAyE,CAC1E;IACH,iBAAiB,EAAE,CAAC;SACjB,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAChC,CAAC,CACH;SACA,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAElC;IACF,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,6BAA6B;IAC1C,WAAW,EAAE;;wGAEyF;IACtG,WAAW,EAAE;QACX,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,WAAW,EAAE;4HACuG;gBACpH,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,kDAAkD;QAC/D,MAAM,EAAE,iCAAiC;KAC1C;IAED,oFAAoF;IACpF,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,WAAW,EAAE;QACX,KAAK,EAAE,oBAAoB;QAC3B,qBAAqB,EAAE;YACrB,WAAW,EAAE,GAAG;YAChB,IAAI,EAAE,IAAI;YACV,cAAc,EAAE;gBACd,eAAe,EAAE,IAAI;gBACrB,cAAc,EAAE,CAAC,CAAC;aACnB;SACF;KACF;IAED,SAAS,EAAE;QACT,cAAc,EAAE,CAAC;QACjB,QAAQ,EAAE,EAAE;KACb;IAED,UAAU,EAAE;QACV,wCAAwC;QACxC,KAAK,EAAE,CAAC,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,CAAC;KAC3E;IAED,YAAY,EAAE;QACZ,KAAK,EAAE;;;aAGE;QACT,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DjB;KACE;CACF,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, type ToolInvocation, type ToolResult } from '../tools/tools.js';
+import type { AgentRegistry } from './registry.js';
+import type { Config } from '../config/config.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+type DelegateParams = {
+    agent_name: string;
+} & Record<string, unknown>;
+export declare class DelegateToAgentTool extends BaseDeclarativeTool<DelegateParams, ToolResult> {
+    private readonly registry;
+    private readonly config;
+    constructor(registry: AgentRegistry, config: Config, messageBus: MessageBus);
+    protected createInvocation(params: DelegateParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<DelegateParams, ToolResult>;
+}
+export {};

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

@@ -0,0 +1,122 @@
+/**
+ * @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 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}' not found in registry.`);
+        }
+        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

@@ -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,213 @@
+/**
+ * @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' }] }),
+        shouldConfirmExecute: vi.fn().mockResolvedValue(false),
+    })),
+}));
+vi.mock('./remote-invocation.js', () => ({
+    RemoteAgentInvocation: vi.fn().mockImplementation(() => ({
+        execute: vi.fn().mockResolvedValue({
+            content: [{ type: 'text', text: 'Remote Success' }],
+        }),
+        shouldConfirmExecute: vi.fn().mockResolvedValue({
+            type: 'info',
+            title: 'Remote Confirmation',
+            prompt: 'Confirm remote call',
+            onConfirm: vi.fn(),
+        }),
+    })),
+}));
+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',
+            generateContentConfig: {
+                temperature: 0,
+                topP: 0,
+            },
+        },
+        inputConfig: {
+            inputs: {
+                arg1: { type: 'string', description: 'Argument 1', required: true },
+                arg2: { type: 'number', description: 'Argument 2', required: false },
+            },
+        },
+        runConfig: { maxTurns: 1, maxTimeMinutes: 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 execute local agents silently without requesting confirmation', async () => {
+        const invocation = tool.build({
+            agent_name: 'test_agent',
+            arg1: 'valid',
+        });
+        // Trigger confirmation check
+        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({
+            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');
+    });
+    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