@anthropic-field/core 0.1.0

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface AcknowledgedAgentsMap {
+    [projectPath: string]: {
+        [agentName: string]: string;
+    };
+}
+export declare class AcknowledgedAgentsService {
+    private acknowledgedAgents;
+    private loaded;
+    load(): Promise<void>;
+    save(): Promise<void>;
+    isAcknowledged(projectPath: string, agentName: string, hash: string): Promise<boolean>;
+    acknowledge(projectPath: string, agentName: string, hash: string): Promise<void>;
+}

package/dist/src/agents/acknowledgedAgents.js

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { Storage } from '../config/storage.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { getErrorMessage, isNodeError } from '../utils/errors.js';
+export class AcknowledgedAgentsService {
+    acknowledgedAgents = {};
+    loaded = false;
+    async load() {
+        if (this.loaded)
+            return;
+        const filePath = Storage.getAcknowledgedAgentsPath();
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            this.acknowledgedAgents = JSON.parse(content);
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== 'ENOENT') {
+                debugLogger.error('Failed to load acknowledged agents:', getErrorMessage(error));
+            }
+            // If file doesn't exist or there's a parsing error, fallback to empty
+            this.acknowledgedAgents = {};
+        }
+        this.loaded = true;
+    }
+    async save() {
+        const filePath = Storage.getAcknowledgedAgentsPath();
+        try {
+            const dir = path.dirname(filePath);
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(filePath, JSON.stringify(this.acknowledgedAgents, null, 2), 'utf-8');
+        }
+        catch (error) {
+            debugLogger.error('Failed to save acknowledged agents:', getErrorMessage(error));
+        }
+    }
+    async isAcknowledged(projectPath, agentName, hash) {
+        await this.load();
+        const projectAgents = this.acknowledgedAgents[projectPath];
+        if (!projectAgents)
+            return false;
+        return projectAgents[agentName] === hash;
+    }
+    async acknowledge(projectPath, agentName, hash) {
+        await this.load();
+        if (!this.acknowledgedAgents[projectPath]) {
+            this.acknowledgedAgents[projectPath] = {};
+        }
+        this.acknowledgedAgents[projectPath][agentName] = hash;
+        await this.save();
+    }
+}
+//# sourceMappingURL=acknowledgedAgents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acknowledgedAgents.js","sourceRoot":"","sources":["../../../src/agents/acknowledgedAgents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AASlE,MAAM,OAAO,yBAAyB;IAC5B,kBAAkB,GAA0B,EAAE,CAAC;IAC/C,MAAM,GAAG,KAAK,CAAC;IAEvB,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,MAAM,QAAQ,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnD,WAAW,CAAC,KAAK,CACf,qCAAqC,EACrC,eAAe,CAAC,KAAK,CAAC,CACvB,CAAC;YACJ,CAAC;YACD,sEAAsE;YACtE,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,MAAM,EAAE,CAAC,SAAS,CAChB,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,EAChD,OAAO,CACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CACf,qCAAqC,EACrC,eAAe,CAAC,KAAK,CAAC,CACvB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,SAAiB,EACjB,IAAY;QAEZ,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QACjC,OAAO,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,WAAW,CACf,WAAmB,EACnB,SAAiB,EACjB,IAAY;QAEZ,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QACvD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF"}

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { ToolCallRequestInfo, CompletedToolCall } from '../scheduler/types.js';
+import type { ToolRegistry } from '../tools/tool-registry.js';
+import type { EditorType } from '../utils/editor.js';
+/**
+ * Options for scheduling agent tools.
+ */
+export interface AgentSchedulingOptions {
+    /** The unique ID for this agent's scheduler. */
+    schedulerId: string;
+    /** The ID of the tool call that invoked this agent. */
+    parentCallId?: string;
+    /** The tool registry specific to this agent. */
+    toolRegistry: ToolRegistry;
+    /** AbortSignal for cancellation. */
+    signal: AbortSignal;
+    /** Optional function to get the preferred editor for tool modifications. */
+    getPreferredEditor?: () => EditorType | undefined;
+}
+/**
+ * Schedules a batch of tool calls for an agent using the new event-driven Scheduler.
+ *
+ * @param config The global runtime configuration.
+ * @param requests The list of tool call requests from the agent.
+ * @param options Scheduling options including registry and IDs.
+ * @returns A promise that resolves to the completed tool calls.
+ */
+export declare function scheduleAgentTools(config: Config, requests: ToolCallRequestInfo[], options: AgentSchedulingOptions): Promise<CompletedToolCall[]>;

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Scheduler } from '../scheduler/scheduler.js';
+/**
+ * Schedules a batch of tool calls for an agent using the new event-driven Scheduler.
+ *
+ * @param config The global runtime configuration.
+ * @param requests The list of tool call requests from the agent.
+ * @param options Scheduling options including registry and IDs.
+ * @returns A promise that resolves to the completed tool calls.
+ */
+export async function scheduleAgentTools(config, requests, options) {
+    const { schedulerId, parentCallId, toolRegistry, signal, getPreferredEditor, } = options;
+    // Create a proxy/override of the config to provide the agent-specific tool registry.
+    const agentConfig = Object.create(config);
+    agentConfig.getToolRegistry = () => toolRegistry;
+    const scheduler = new Scheduler({
+        config: agentConfig,
+        messageBus: config.getMessageBus(),
+        getPreferredEditor: getPreferredEditor ?? (() => undefined),
+        schedulerId,
+        parentCallId,
+    });
+    return scheduler.schedule(requests, signal);
+}
+//# sourceMappingURL=agent-scheduler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-scheduler.js","sourceRoot":"","sources":["../../../src/agents/agent-scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAwBtD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,QAA+B,EAC/B,OAA+B;IAE/B,MAAM,EACJ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,kBAAkB,GACnB,GAAG,OAAO,CAAC;IAEZ,qFAAqF;IACrF,MAAM,WAAW,GAAW,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,WAAW,CAAC,eAAe,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC;IAEjD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;QAC9B,MAAM,EAAE,WAAW;QACnB,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE;QAClC,kBAAkB,EAAE,kBAAkB,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;QAC3D,WAAW;QACX,YAAY;KACb,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AgentDefinition } from './types.js';
+/**
+ * DTO for Markdown parsing - represents the structure from frontmatter.
+ */
+interface FrontmatterBaseAgentDefinition {
+    name: string;
+    display_name?: string;
+}
+interface FrontmatterLocalAgentDefinition extends FrontmatterBaseAgentDefinition {
+    kind: 'local';
+    description: string;
+    tools?: string[];
+    system_prompt: string;
+    model?: string;
+    temperature?: number;
+    max_turns?: number;
+    timeout_mins?: number;
+}
+interface FrontmatterRemoteAgentDefinition extends FrontmatterBaseAgentDefinition {
+    kind: 'remote';
+    description?: string;
+    agent_card_url: string;
+}
+type FrontmatterAgentDefinition = FrontmatterLocalAgentDefinition | FrontmatterRemoteAgentDefinition;
+/**
+ * Error thrown when an agent definition is invalid or cannot be loaded.
+ */
+export declare class AgentLoadError extends Error {
+    filePath: string;
+    constructor(filePath: string, message: string);
+}
+/**
+ * Result of loading agents from a directory.
+ */
+export interface AgentLoadResult {
+    agents: AgentDefinition[];
+    errors: AgentLoadError[];
+}
+/**
+ * Parses and validates an agent Markdown file with frontmatter.
+ *
+ * @param filePath Path to the Markdown file.
+ * @param content Optional pre-loaded content of the file.
+ * @returns An array containing the single parsed agent definition.
+ * @throws AgentLoadError if parsing or validation fails.
+ */
+export declare function parseAgentMarkdown(filePath: string, content?: string): Promise<FrontmatterAgentDefinition[]>;
+/**
+ * Converts a FrontmatterAgentDefinition DTO to the internal AgentDefinition structure.
+ *
+ * @param markdown The parsed Markdown/Frontmatter definition.
+ * @param metadata Optional metadata including hash and file path.
+ * @returns The internal AgentDefinition.
+ */
+export declare function markdownToAgentDefinition(markdown: FrontmatterAgentDefinition, metadata?: {
+    hash?: string;
+    filePath?: string;
+}): AgentDefinition;
+/**
+ * Loads all agents from a specific directory.
+ * 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.
+ */
+export declare function loadAgentsFromDirectory(dir: string): Promise<AgentLoadResult>;
+export {};

package/dist/src/agents/agentLoader.js

@@ -0,0 +1,268 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import yaml from 'js-yaml';
+import * as fs from 'node:fs/promises';
+import {} from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { z } from 'zod';
+import { isValidToolName } from '../tools/tool-names.js';
+import { FRONTMATTER_REGEX } from '../skills/skillLoader.js';
+import { getErrorMessage } from '../utils/errors.js';
+/**
+ * Error thrown when an agent definition is invalid or cannot be loaded.
+ */
+export class AgentLoadError extends Error {
+    filePath;
+    constructor(filePath, message) {
+        super(`Failed to load agent from ${filePath}: ${message}`);
+        this.filePath = filePath;
+        this.name = 'AgentLoadError';
+    }
+}
+const nameSchema = z
+    .string()
+    .regex(/^[a-z0-9-_]+$/, 'Name must be a valid slug');
+const localAgentSchema = z
+    .object({
+    kind: z.literal('local').optional().default('local'),
+    name: nameSchema,
+    description: z.string().min(1),
+    display_name: z.string().optional(),
+    tools: z
+        .array(z.string().refine((val) => isValidToolName(val), {
+        message: 'Invalid tool name',
+    }))
+        .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
+    .object({
+    kind: z.literal('remote').optional().default('remote'),
+    name: nameSchema,
+    description: z.string().optional(),
+    display_name: z.string().optional(),
+    agent_card_url: z.string().url(),
+})
+    .strict();
+// Use a Zod union to automatically discriminate between local and remote
+// agent types.
+const agentUnionOptions = [
+    { schema: localAgentSchema, label: 'Local Agent' },
+    { schema: remoteAgentSchema, label: 'Remote Agent' },
+];
+const remoteAgentsListSchema = z.array(remoteAgentSchema);
+const markdownFrontmatterSchema = z.union([
+    agentUnionOptions[0].schema,
+    agentUnionOptions[1].schema,
+]);
+function formatZodError(error, context) {
+    const issues = error.issues
+        .map((i) => {
+        // Handle union errors specifically to give better context
+        if (i.code === z.ZodIssueCode.invalid_union) {
+            return i.unionErrors
+                .map((unionError, index) => {
+                const label = agentUnionOptions[index]?.label ?? `Agent type #${index + 1}`;
+                const unionIssues = unionError.issues
+                    .map((u) => `${u.path.join('.')}: ${u.message}`)
+                    .join(', ');
+                return `(${label}) ${unionIssues}`;
+            })
+                .join('\n');
+        }
+        return `${i.path.join('.')}: ${i.message}`;
+    })
+        .join('\n');
+    return `${context}:\n${issues}`;
+}
+/**
+ * Parses and validates an agent Markdown file with frontmatter.
+ *
+ * @param filePath Path to the Markdown file.
+ * @param content Optional pre-loaded content of the file.
+ * @returns An array containing the single parsed agent definition.
+ * @throws AgentLoadError if parsing or validation fails.
+ */
+export async function parseAgentMarkdown(filePath, content) {
+    let fileContent;
+    if (content !== undefined) {
+        fileContent = content;
+    }
+    else {
+        try {
+            fileContent = await fs.readFile(filePath, 'utf-8');
+        }
+        catch (error) {
+            throw new AgentLoadError(filePath, `Could not read file: ${getErrorMessage(error)}`);
+        }
+    }
+    // Split frontmatter and body
+    const match = fileContent.match(FRONTMATTER_REGEX);
+    if (!match) {
+        throw new AgentLoadError(filePath, 'Invalid agent definition: Missing mandatory YAML frontmatter. Agent Markdown files MUST start with YAML frontmatter enclosed in triple-dashes "---" (e.g., ---\nname: my-agent\n---).');
+    }
+    const frontmatterStr = match[1];
+    const body = match[2] || '';
+    let rawFrontmatter;
+    try {
+        rawFrontmatter = yaml.load(frontmatterStr);
+    }
+    catch (error) {
+        throw new AgentLoadError(filePath, `YAML frontmatter parsing failed: ${error.message}`);
+    }
+    // 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 List')}`);
+        }
+        return result.data.map((agent) => ({
+            ...agent,
+            kind: 'remote',
+        }));
+    }
+    const result = markdownFrontmatterSchema.safeParse(rawFrontmatter);
+    if (!result.success) {
+        throw new AgentLoadError(filePath, `Validation failed: ${formatZodError(result.error, 'Agent Definition')}`);
+    }
+    const frontmatter = result.data;
+    if (frontmatter.kind === 'remote') {
+        return [
+            {
+                ...frontmatter,
+                kind: 'remote',
+            },
+        ];
+    }
+    // Local agent validation
+    // Validate tools
+    // Construct the local agent definition
+    const agentDef = {
+        ...frontmatter,
+        kind: 'local',
+        system_prompt: body.trim(),
+    };
+    return [agentDef];
+}
+/**
+ * Converts a FrontmatterAgentDefinition DTO to the internal AgentDefinition structure.
+ *
+ * @param markdown The parsed Markdown/Frontmatter definition.
+ * @param metadata Optional metadata including hash and file path.
+ * @returns The internal AgentDefinition.
+ */
+export function markdownToAgentDefinition(markdown, metadata) {
+    const inputConfig = {
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The task for the agent.',
+                },
+            },
+            // query is not required because it defaults to "Get Started!" if not provided
+            required: [],
+        },
+    };
+    if (markdown.kind === 'remote') {
+        return {
+            kind: 'remote',
+            name: markdown.name,
+            description: markdown.description || '(Loading description...)',
+            displayName: markdown.display_name,
+            agentCardUrl: markdown.agent_card_url,
+            inputConfig,
+            metadata,
+        };
+    }
+    // If a model is specified, use it. Otherwise, inherit
+    const modelName = markdown.model || 'inherit';
+    return {
+        kind: 'local',
+        name: markdown.name,
+        description: markdown.description,
+        displayName: markdown.display_name,
+        promptConfig: {
+            systemPrompt: markdown.system_prompt,
+            query: '${query}',
+        },
+        modelConfig: {
+            model: modelName,
+            generateContentConfig: {
+                temperature: markdown.temperature ?? 1,
+                topP: 0.95,
+            },
+        },
+        runConfig: {
+            maxTurns: markdown.max_turns,
+            maxTimeMinutes: markdown.timeout_mins || 5,
+        },
+        toolConfig: markdown.tools
+            ? {
+                tools: markdown.tools,
+            }
+            : undefined,
+        inputConfig,
+        metadata,
+    };
+}
+/**
+ * Loads all agents from a specific directory.
+ * 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.
+ */
+export async function loadAgentsFromDirectory(dir) {
+    const result = {
+        agents: [],
+        errors: [],
+    };
+    let dirEntries;
+    try {
+        dirEntries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch (error) {
+        // If directory doesn't exist, just return empty
+        if (error.code === 'ENOENT') {
+            return result;
+        }
+        result.errors.push(new AgentLoadError(dir, `Could not list directory: ${error.message}`));
+        return result;
+    }
+    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 content = await fs.readFile(filePath, 'utf-8');
+            const hash = crypto.createHash('sha256').update(content).digest('hex');
+            const agentDefs = await parseAgentMarkdown(filePath, content);
+            for (const def of agentDefs) {
+                const agent = markdownToAgentDefinition(def, { hash, filePath });
+                result.agents.push(agent);
+            }
+        }
+        catch (error) {
+            if (error instanceof AgentLoadError) {
+                result.errors.push(error);
+            }
+            else {
+                result.errors.push(new AgentLoadError(filePath, `Unexpected error: ${error.message}`));
+            }
+        }
+    }
+    return result;
+}
+//# 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/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 Gemini 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,80 @@
+/**
+ * @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 Gemini CLI.'),
+    sources: z
+        .array(z.string())
+        .describe('The documentation files used to answer the question.'),
+});
+/**
+ * An agent specialized in answering questions about Gemini CLI itself,
+ * using its own documentation and runtime state.
+ */
+export const CliHelpAgent = (config) => ({
+    name: 'cli_help',
+    kind: 'local',
+    displayName: 'CLI Help Agent',
+    description: 'Specialized in answering questions about how users use you, (Gemini CLI): features, documentation, and current runtime configuration.',
+    inputConfig: {
+        inputSchema: {
+            type: 'object',
+            properties: {
+                question: {
+                    type: 'string',
+                    description: 'The specific question about Gemini CLI.',
+                },
+            },
+            required: ['question'],
+        },
+    },
+    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 Gemini CLI:\n' +
+            '<question>\n' +
+            '${question}\n' +
+            '</question>',
+        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" +
+            '### 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,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,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;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,mEAAmE;YACnE,cAAc;YACd,eAAe;YACf,aAAa;QACf,YAAY,EACV,yKAAyK;YACzK,uBAAuB;YACvB,oCAAoC;YACpC,sCAAsC;YACtC,kCAAkC;YAClC,oBAAoB;YACpB,yNAAyN;YACzN,gGAAgG;YAChG,uGAAuG;YACvG,kLAAkL;YAClL,uGAAuG;KAC1G;CACF,CAAC,CAAC"}