@google/gemini-cli-core 0.24.0-nightly.20260103.30f5c4af4 → 0.25.0-nightly.20260112.15891721a

package/dist/src/agents/{toml-loader.js → agentLoader.js}

@@ -1,14 +1,15 @@
 /**
  * @license
- * Copyright 2025 Google LLC
+ * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import TOML from '@iarna/toml';
+import yaml from 'js-yaml';
 import * as fs from 'node:fs/promises';
 import {} from 'node:fs';
 import * as path from 'node:path';
 import { z } from 'zod';
 import { isValidToolName, DELEGATE_TO_AGENT_TOOL_NAME, } from '../tools/tool-names.js';
+import { FRONTMATTER_REGEX } from '../skills/skillLoader.js';
 /**
  * Error thrown when an agent definition is invalid or cannot be loaded.
  */
@@ -34,22 +35,10 @@ const localAgentSchema = z
         message: 'Invalid tool name',
     }))
         .optional(),
-    prompts: z.object({
-        system_prompt: z.string().min(1),
-        query: z.string().optional(),
-    }),
-    model: z
-        .object({
-        model: z.string().optional(),
-        temperature: z.number().optional(),
-    })
-        .optional(),
-    run: z
-        .object({
-        max_turns: z.number().int().positive().optional(),
-        timeout_mins: z.number().int().positive().optional(),
-    })
-        .optional(),
+    model: z.string().optional(),
+    temperature: z.number().optional(),
+    max_turns: z.number().int().positive().optional(),
+    timeout_mins: z.number().int().positive().optional(),
 })
     .strict();
 const remoteAgentSchema = z
@@ -61,20 +50,14 @@ const remoteAgentSchema = z
     agent_card_url: z.string().url(),
 })
     .strict();
-const remoteAgentsConfigSchema = z
-    .object({
-    remote_agents: z.array(remoteAgentSchema),
-})
-    .strict();
 // Use a Zod union to automatically discriminate between local and remote
-// agent types. This is more robust than manually checking the 'kind' field,
-// as it correctly handles cases where 'kind' is omitted by relying on
-// the presence of unique fields like `agent_card_url` or `prompts`.
+// agent types.
 const agentUnionOptions = [
     { schema: localAgentSchema, label: 'Local Agent' },
     { schema: remoteAgentSchema, label: 'Remote Agent' },
 ];
-const singleAgentSchema = z.union([
+const remoteAgentsListSchema = z.array(remoteAgentSchema);
+const markdownFrontmatterSchema = z.union([
     agentUnionOptions[0].schema,
     agentUnionOptions[1].schema,
 ]);
@@ -99,13 +82,13 @@ function formatZodError(error, context) {
     return `${context}:\n${issues}`;
 }
 /**
- * Parses and validates an agent TOML file. Returns a validated array of RemoteAgentDefinitions or a single LocalAgentDefinition.
+ * Parses and validates an agent Markdown file with frontmatter.
  *
- * @param filePath Path to the TOML file.
- * @returns An array of parsed and validated TomlAgentDefinitions.
+ * @param filePath Path to the Markdown file.
+ * @returns An array containing the single parsed agent definition.
  * @throws AgentLoadError if parsing or validation fails.
  */
-export async function parseAgentToml(filePath) {
+export async function parseAgentMarkdown(filePath) {
     let content;
     try {
         content = await fs.readFile(filePath, 'utf-8');
@@ -113,42 +96,65 @@ export async function parseAgentToml(filePath) {
     catch (error) {
         throw new AgentLoadError(filePath, `Could not read file: ${error.message}`);
     }
-    let raw;
+    // Split frontmatter and body
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        throw new AgentLoadError(filePath, 'Invalid markdown format. File must start with YAML frontmatter enclosed in "---".');
+    }
+    const frontmatterStr = match[1];
+    const body = match[2] || '';
+    let rawFrontmatter;
     try {
-        raw = TOML.parse(content);
+        rawFrontmatter = yaml.load(frontmatterStr);
     }
     catch (error) {
-        throw new AgentLoadError(filePath, `TOML parsing failed: ${error.message}`);
+        throw new AgentLoadError(filePath, `YAML frontmatter parsing failed: ${error.message}`);
     }
-    // Check for `remote_agents` array
-    if (typeof raw === 'object' &&
-        raw !== null &&
-        'remote_agents' in raw) {
-        const result = remoteAgentsConfigSchema.safeParse(raw);
+    // Handle array of remote agents
+    if (Array.isArray(rawFrontmatter)) {
+        const result = remoteAgentsListSchema.safeParse(rawFrontmatter);
         if (!result.success) {
-            throw new AgentLoadError(filePath, `Validation failed: ${formatZodError(result.error, 'Remote Agents Config')}`);
+            throw new AgentLoadError(filePath, `Validation failed: ${formatZodError(result.error, 'Remote Agents List')}`);
         }
-        return result.data.remote_agents;
+        return result.data.map((agent) => ({
+            ...agent,
+            kind: 'remote',
+        }));
     }
-    // Single Agent Logic
-    const result = singleAgentSchema.safeParse(raw);
+    const result = markdownFrontmatterSchema.safeParse(rawFrontmatter);
     if (!result.success) {
         throw new AgentLoadError(filePath, `Validation failed: ${formatZodError(result.error, 'Agent Definition')}`);
     }
-    const toml = result.data;
-    // Prevent sub-agents from delegating to other agents (to prevent recursion/complexity)
-    if ('tools' in toml && toml.tools?.includes(DELEGATE_TO_AGENT_TOOL_NAME)) {
+    const frontmatter = result.data;
+    if (frontmatter.kind === 'remote') {
+        return [
+            {
+                ...frontmatter,
+                kind: 'remote',
+            },
+        ];
+    }
+    // Local agent validation
+    // Validate tools
+    if (frontmatter.tools &&
+        frontmatter.tools.includes(DELEGATE_TO_AGENT_TOOL_NAME)) {
         throw new AgentLoadError(filePath, `Validation failed: tools list cannot include '${DELEGATE_TO_AGENT_TOOL_NAME}'. Sub-agents cannot delegate to other agents.`);
     }
-    return [toml];
+    // Construct the local agent definition
+    const agentDef = {
+        ...frontmatter,
+        kind: 'local',
+        system_prompt: body.trim(),
+    };
+    return [agentDef];
 }
 /**
- * Converts a TomlAgentDefinition DTO to the internal AgentDefinition structure.
+ * Converts a FrontmatterAgentDefinition DTO to the internal AgentDefinition structure.
  *
- * @param toml The parsed TOML definition.
+ * @param markdown The parsed Markdown/Frontmatter definition.
  * @returns The internal AgentDefinition.
  */
-export function tomlToAgentDefinition(toml) {
+export function markdownToAgentDefinition(markdown) {
     const inputConfig = {
         inputs: {
             query: {
@@ -158,39 +164,39 @@ export function tomlToAgentDefinition(toml) {
             },
         },
     };
-    if (toml.kind === 'remote') {
+    if (markdown.kind === 'remote') {
         return {
             kind: 'remote',
-            name: toml.name,
-            description: toml.description || '(Loading description...)',
-            displayName: toml.display_name,
-            agentCardUrl: toml.agent_card_url,
+            name: markdown.name,
+            description: markdown.description || '(Loading description...)',
+            displayName: markdown.display_name,
+            agentCardUrl: markdown.agent_card_url,
             inputConfig,
         };
     }
     // If a model is specified, use it. Otherwise, inherit
-    const modelName = toml.model?.model || 'inherit';
+    const modelName = markdown.model || 'inherit';
     return {
         kind: 'local',
-        name: toml.name,
-        description: toml.description,
-        displayName: toml.display_name,
+        name: markdown.name,
+        description: markdown.description,
+        displayName: markdown.display_name,
         promptConfig: {
-            systemPrompt: toml.prompts.system_prompt,
-            query: toml.prompts.query,
+            systemPrompt: markdown.system_prompt,
+            query: '${query}',
         },
         modelConfig: {
             model: modelName,
-            temp: toml.model?.temperature ?? 1,
+            temp: markdown.temperature ?? 1,
             top_p: 0.95,
         },
         runConfig: {
-            max_turns: toml.run?.max_turns,
-            max_time_minutes: toml.run?.timeout_mins || 5,
+            max_turns: markdown.max_turns,
+            max_time_minutes: markdown.timeout_mins || 5,
         },
-        toolConfig: toml.tools
+        toolConfig: markdown.tools
             ? {
-                tools: toml.tools,
+                tools: markdown.tools,
             }
             : undefined,
         inputConfig,
@@ -198,7 +204,8 @@ export function tomlToAgentDefinition(toml) {
 }
 /**
  * Loads all agents from a specific directory.
- * Ignores non-TOML files and files starting with _.
+ * Ignores files starting with _ and non-supported extensions.
+ * Supported extensions: .md
  *
  * @param dir Directory path to scan.
  * @returns Object containing successfully loaded agents and any errors.
@@ -220,17 +227,15 @@ export async function loadAgentsFromDirectory(dir) {
         result.errors.push(new AgentLoadError(dir, `Could not list directory: ${error.message}`));
         return result;
     }
-    const files = dirEntries
-        .filter((entry) => entry.isFile() &&
-        entry.name.endsWith('.toml') &&
-        !entry.name.startsWith('_'))
-        .map((entry) => entry.name);
-    for (const file of files) {
-        const filePath = path.join(dir, file);
+    const files = dirEntries.filter((entry) => entry.isFile() &&
+        !entry.name.startsWith('_') &&
+        entry.name.endsWith('.md'));
+    for (const entry of files) {
+        const filePath = path.join(dir, entry.name);
         try {
-            const tomls = await parseAgentToml(filePath);
-            for (const toml of tomls) {
-                const agent = tomlToAgentDefinition(toml);
+            const agentDefs = await parseAgentMarkdown(filePath);
+            for (const def of agentDefs) {
+                const agent = markdownToAgentDefinition(def);
                 result.agents.push(agent);
             }
         }
@@ -245,4 +250,4 @@ export async function loadAgentsFromDirectory(dir) {
     }
     return result;
 }
-//# sourceMappingURL=toml-loader.js.map
+//# sourceMappingURL=agentLoader.js.map

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

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

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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAQ,GAAG,SAAS;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;;0BAItB,CAAC,CAAC;YAEtB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;gBAC9B,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,OAAO;gBACb,aAAa,EAAE,2BAA2B;aAC3C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;;;;;;uBAQzB,CAAC,CAAC;YAEnB,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;gBAC9B,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,0BAA0B;gBACvC,KAAK,EAAE,CAAC,mBAAmB,CAAC;gBAC5B,KAAK,EAAE,YAAY;gBACnB,WAAW,EAAE,GAAG;gBAChB,aAAa,EAAE,wBAAwB;aACxC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YACrE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,6BAA6B,CAAC,CAAC;YACzE,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACxD,cAAc,CACf,CAAC;YACF,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACxD,yBAAyB,CAC1B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;KAG3C,CAAC,CAAC;YACD,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACxD,cAAc,CACf,CAAC;YACF,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACxD,iCAAiC,CAClC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;YACxF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;;KAI3C,CAAC,CAAC;YACD,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACxD,mBAAmB,CACpB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;YACjF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;;;;KAM3C,CAAC,CAAC;YACD,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACxD,+CAA+C,CAChD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YAC/D,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;;;;CAM/C,CAAC,CAAC;YACG,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACxB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,gBAAgB;gBAC7B,cAAc,EAAE,0BAA0B;aAC3C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;YAClE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;;;CAK/C,CAAC,CAAC;YACG,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACxB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,UAAU;gBACvB,cAAc,EAAE,8BAA8B;aAC/C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;;;CAK/C,CAAC,CAAC;YACG,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACxB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,gBAAgB;gBACtB,cAAc,EAAE,0BAA0B;aAC3C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;;;;;;;;CAQ/C,CAAC,CAAC;YACG,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACxB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,cAAc,EAAE,uBAAuB;aACxC,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACxB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,cAAc,EAAE,uBAAuB;aACxC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;YAC5E,MAAM,QAAQ,GAAG;gBACf,IAAI,EAAE,OAAgB;gBACtB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,cAAc;gBAC3B,aAAa,EAAE,uBAAuB;aACvC,CAAC;YAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;gBAC3B,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,cAAc;gBAC3B,YAAY,EAAE;oBACZ,YAAY,EAAE,uBAAuB;oBACrC,KAAK,EAAE,UAAU;iBAClB;gBACD,WAAW,EAAE;oBACX,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,IAAI;iBACZ;gBACD,SAAS,EAAE;oBACT,gBAAgB,EAAE,CAAC;iBACpB;gBACD,WAAW,EAAE;oBACX,MAAM,EAAE;wBACN,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,KAAK;yBAChB;qBACF;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,QAAQ,GAAG;gBACf,IAAI,EAAE,OAAgB;gBACtB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,cAAc;gBAC3B,KAAK,EAAE,sBAAsB;gBAC7B,aAAa,EAAE,uBAAuB;aACvC,CAAC;YAEF,MAAM,MAAM,GAAG,yBAAyB,CACtC,QAAQ,CACe,CAAC;YAC1B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,QAAQ,GAAG;gBACf,IAAI,EAAE,OAAgB;gBACtB,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,cAAc;gBAC3B,KAAK,EAAE,MAAM;gBACb,aAAa,EAAE,uBAAuB;aACvC,CAAC;YAEF,MAAM,MAAM,GAAG,yBAAyB,CACtC,QAAQ,CACe,CAAC;YAC1B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,QAAQ,GAAG;gBACf,IAAI,EAAE,QAAiB;gBACvB,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,gBAAgB;gBAC7B,cAAc,EAAE,0BAA0B;aAC3C,CAAC;YAEF,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,gBAAgB;gBAC7B,WAAW,EAAE,SAAS;gBACtB,YAAY,EAAE,0BAA0B;gBACxC,WAAW,EAAE;oBACX,MAAM,EAAE;wBACN,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,yBAAyB;4BACtC,QAAQ,EAAE,KAAK;yBAChB;qBACF;iBACF;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;YACxE,MAAM,kBAAkB,CACtB;;;;SAIC,EACD,UAAU,CACX,CAAC;YAEF,8BAA8B;YAC9B,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;YAE/D,uBAAuB;YACvB,MAAM,kBAAkB,CACtB;;;;OAID,EACC,YAAY,CACb,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;YACtE,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,cAAc,CAAC,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;YACpE,mCAAmC;YACnC,MAAM,kBAAkB,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;YAE7D,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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 {};