@anthropic-field/core 0.1.0

package/dist/src/test-utils/mock-tool.js

@@ -0,0 +1,123 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from '../tools/tools.js';
+import { createMockMessageBus } from './mock-message-bus.js';
+class MockToolInvocation extends BaseToolInvocation {
+    tool;
+    constructor(tool, params, messageBus) {
+        super(params, messageBus, tool.name, tool.displayName);
+        this.tool = tool;
+    }
+    execute(signal, updateOutput) {
+        if (updateOutput) {
+            return this.tool.execute(this.params, signal, updateOutput);
+        }
+        else {
+            return this.tool.execute(this.params);
+        }
+    }
+    shouldConfirmExecute(abortSignal) {
+        return this.tool.shouldConfirmExecute(this.params, abortSignal);
+    }
+    getDescription() {
+        return `A mock tool invocation for ${this.tool.name}`;
+    }
+}
+/**
+ * A highly configurable mock tool for testing purposes.
+ */
+export class MockTool extends BaseDeclarativeTool {
+    shouldConfirmExecute;
+    execute;
+    constructor(options) {
+        super(options.name, options.displayName ?? options.name, options.description ?? options.name, Kind.Other, options.params, options.messageBus ?? createMockMessageBus(), options.isOutputMarkdown ?? false, options.canUpdateOutput ?? false);
+        if (options.shouldConfirmExecute) {
+            this.shouldConfirmExecute = options.shouldConfirmExecute;
+        }
+        else {
+            this.shouldConfirmExecute = () => Promise.resolve(false);
+        }
+        if (options.execute) {
+            this.execute = options.execute;
+        }
+        else {
+            this.execute = () => Promise.resolve({
+                llmContent: `Tool ${this.name} executed successfully.`,
+                returnDisplay: `Tool ${this.name} executed successfully.`,
+            });
+        }
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new MockToolInvocation(this, params, messageBus);
+    }
+}
+export const MOCK_TOOL_SHOULD_CONFIRM_EXECUTE = () => Promise.resolve({
+    type: 'exec',
+    title: 'Confirm mockTool',
+    command: 'mockTool',
+    rootCommand: 'mockTool',
+    rootCommands: ['mockTool'],
+    onConfirm: async () => { },
+});
+export class MockModifiableToolInvocation extends BaseToolInvocation {
+    tool;
+    constructor(tool, params, messageBus) {
+        super(params, messageBus, tool.name, tool.displayName);
+        this.tool = tool;
+    }
+    async execute(_abortSignal) {
+        const result = this.tool.executeFn(this.params);
+        return (result ?? {
+            llmContent: `Tool ${this.tool.name} executed successfully.`,
+            returnDisplay: `Tool ${this.tool.name} executed successfully.`,
+        });
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        if (this.tool.shouldConfirm) {
+            return {
+                type: 'edit',
+                title: 'Confirm Mock Tool',
+                fileName: 'test.txt',
+                filePath: 'test.txt',
+                fileDiff: 'diff',
+                originalContent: 'originalContent',
+                newContent: 'newContent',
+                onConfirm: async () => { },
+            };
+        }
+        return false;
+    }
+    getDescription() {
+        return `A mock modifiable tool invocation for ${this.tool.name}`;
+    }
+}
+/**
+ * Configurable mock modifiable tool for testing.
+ */
+export class MockModifiableTool extends BaseDeclarativeTool {
+    // Should be overridden in test file. Functionality will be updated in follow
+    // up PR which has MockModifiableTool expect MockTool
+    executeFn = () => undefined;
+    shouldConfirm = true;
+    constructor(name = 'mockModifiableTool') {
+        super(name, name, 'A mock modifiable tool for testing.', Kind.Other, {
+            type: 'object',
+            properties: { param: { type: 'string' } },
+        }, createMockMessageBus(), true, false);
+    }
+    getModifyContext(_abortSignal) {
+        return {
+            getFilePath: () => 'test.txt',
+            getCurrentContent: async () => 'old content',
+            getProposedContent: async () => 'new content',
+            createUpdatedParams: (_oldContent, modifiedProposedContent, _originalParams) => ({ newContent: modifiedProposedContent }),
+        };
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new MockModifiableToolInvocation(this, params, messageBus);
+    }
+}
+//# sourceMappingURL=mock-tool.js.map

package/dist/src/test-utils/mock-tool.js.map

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

package/dist/src/test-utils/mockWorkspaceContext.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { WorkspaceContext } from '../utils/workspaceContext.js';
+/**
+ * Creates a mock WorkspaceContext for testing
+ * @param rootDir The root directory to use for the mock
+ * @param additionalDirs Optional additional directories to include in the workspace
+ * @returns A mock WorkspaceContext instance
+ */
+export declare function createMockWorkspaceContext(rootDir: string, additionalDirs?: string[]): WorkspaceContext;

package/dist/src/test-utils/mockWorkspaceContext.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+/**
+ * Creates a mock WorkspaceContext for testing
+ * @param rootDir The root directory to use for the mock
+ * @param additionalDirs Optional additional directories to include in the workspace
+ * @returns A mock WorkspaceContext instance
+ */
+export function createMockWorkspaceContext(rootDir, additionalDirs = []) {
+    const allDirs = [rootDir, ...additionalDirs];
+    const mockWorkspaceContext = {
+        addDirectory: vi.fn(),
+        getDirectories: vi.fn().mockReturnValue(allDirs),
+        isPathWithinWorkspace: vi
+            .fn()
+            .mockImplementation((path) => allDirs.some((dir) => path.startsWith(dir))),
+    };
+    return mockWorkspaceContext;
+}
+//# sourceMappingURL=mockWorkspaceContext.js.map

package/dist/src/test-utils/mockWorkspaceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockWorkspaceContext.js","sourceRoot":"","sources":["../../../src/test-utils/mockWorkspaceContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG5B;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,iBAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC;IAE7C,MAAM,oBAAoB,GAAG;QAC3B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;QACrB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;QAChD,qBAAqB,EAAE,EAAE;aACtB,EAAE,EAAE;aACJ,kBAAkB,CAAC,CAAC,IAAY,EAAE,EAAE,CACnC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAC5C;KAC2B,CAAC;IAEjC,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/src/tools/activate-skill.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import type { ToolResult, ToolInvocation } from './tools.js';
+import { BaseDeclarativeTool } from './tools.js';
+import type { Config } from '../config/config.js';
+/**
+ * Parameters for the ActivateSkill tool
+ */
+export interface ActivateSkillToolParams {
+    /**
+     * The name of the skill to activate
+     */
+    name: string;
+}
+/**
+ * Implementation of the ActivateSkill tool logic
+ */
+export declare class ActivateSkillTool extends BaseDeclarativeTool<ActivateSkillToolParams, ToolResult> {
+    private config;
+    static readonly Name = "activate_skill";
+    constructor(config: Config, messageBus: MessageBus);
+    protected createInvocation(params: ActivateSkillToolParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<ActivateSkillToolParams, ToolResult>;
+}

package/dist/src/tools/activate-skill.js

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import * as path from 'node:path';
+import { getFolderStructure } from '../utils/getFolderStructure.js';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from './tools.js';
+import { ACTIVATE_SKILL_TOOL_NAME } from './tool-names.js';
+import { ToolErrorType } from './tool-error.js';
+class ActivateSkillToolInvocation extends BaseToolInvocation {
+    config;
+    cachedFolderStructure;
+    constructor(config, params, messageBus, _toolName, _toolDisplayName) {
+        super(params, messageBus, _toolName, _toolDisplayName);
+        this.config = config;
+    }
+    getDescription() {
+        const skillName = this.params.name;
+        const skill = this.config.getSkillManager().getSkill(skillName);
+        if (skill) {
+            return `"${skillName}": ${skill.description}`;
+        }
+        return `"${skillName}" (?) unknown skill`;
+    }
+    async getOrFetchFolderStructure(skillLocation) {
+        if (this.cachedFolderStructure === undefined) {
+            this.cachedFolderStructure = await getFolderStructure(path.dirname(skillLocation));
+        }
+        return this.cachedFolderStructure;
+    }
+    async getConfirmationDetails(_abortSignal) {
+        if (!this.messageBus) {
+            return false;
+        }
+        const skillName = this.params.name;
+        const skill = this.config.getSkillManager().getSkill(skillName);
+        if (!skill) {
+            return false;
+        }
+        if (skill.isBuiltin) {
+            return false;
+        }
+        const folderStructure = await this.getOrFetchFolderStructure(skill.location);
+        const confirmationDetails = {
+            type: 'info',
+            title: `Activate Skill: ${skillName}`,
+            prompt: `You are about to enable the specialized agent skill **${skillName}**.
+
+**Description:**
+${skill.description}
+
+**Resources to be shared with the model:**
+${folderStructure}`,
+            onConfirm: async (outcome) => {
+                await this.publishPolicyUpdate(outcome);
+            },
+        };
+        return confirmationDetails;
+    }
+    async execute(_signal) {
+        const skillName = this.params.name;
+        const skillManager = this.config.getSkillManager();
+        const skill = skillManager.getSkill(skillName);
+        if (!skill) {
+            const skills = skillManager.getSkills();
+            const availableSkills = skills.map((s) => s.name).join(', ');
+            const errorMessage = `Skill "${skillName}" not found. Available skills are: ${availableSkills}`;
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        skillManager.activateSkill(skillName);
+        // Add the skill's directory to the workspace context so the agent has permission
+        // to read its bundled resources.
+        this.config
+            .getWorkspaceContext()
+            .addDirectory(path.dirname(skill.location));
+        const folderStructure = await this.getOrFetchFolderStructure(skill.location);
+        return {
+            llmContent: `<activated_skill name="${skillName}">
+  <instructions>
+    ${skill.body}
+  </instructions>
+
+  <available_resources>
+    ${folderStructure}
+  </available_resources>
+</activated_skill>`,
+            returnDisplay: `Skill **${skillName}** activated. Resources loaded from \`${path.dirname(skill.location)}\`:\n\n${folderStructure}`,
+        };
+    }
+}
+/**
+ * Implementation of the ActivateSkill tool logic
+ */
+export class ActivateSkillTool extends BaseDeclarativeTool {
+    config;
+    static Name = ACTIVATE_SKILL_TOOL_NAME;
+    constructor(config, messageBus) {
+        const skills = config.getSkillManager().getSkills();
+        const skillNames = skills.map((s) => s.name);
+        let schema;
+        if (skillNames.length === 0) {
+            schema = z.object({
+                name: z.string().describe('No skills are currently available.'),
+            });
+        }
+        else {
+            schema = z.object({
+                name: z
+                    .enum(skillNames)
+                    .describe('The name of the skill to activate.'),
+            });
+        }
+        const availableSkillsHint = skillNames.length > 0
+            ? ` (Available: ${skillNames.map((n) => `'${n}'`).join(', ')})`
+            : '';
+        super(ActivateSkillTool.Name, 'Activate Skill', `Activates a specialized agent skill by name${availableSkillsHint}. Returns the skill's instructions wrapped in \`<activated_skill>\` tags. These provide specialized guidance for the current task. Use this when you identify a task that matches a skill's description. ONLY use names exactly as they appear in the \`<available_skills>\` section.`, Kind.Other, zodToJsonSchema(schema), messageBus, true, false);
+        this.config = config;
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new ActivateSkillToolInvocation(this.config, params, messageBus, _toolName, _toolDisplayName ?? 'Activate Skill');
+    }
+}
+//# sourceMappingURL=activate-skill.js.map

package/dist/src/tools/activate-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate-skill.js","sourceRoot":"","sources":["../../../src/tools/activate-skill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAQpE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAYhD,MAAM,2BAA4B,SAAQ,kBAGzC;IAIW;IAHF,qBAAqB,CAAqB;IAElD,YACU,MAAc,EACtB,MAA+B,EAC/B,UAAsB,EACtB,SAAkB,EAClB,gBAAyB;QAEzB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAN/C,WAAM,GAAN,MAAM,CAAQ;IAOxB,CAAC;IAED,cAAc;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,SAAS,qBAAqB,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,yBAAyB,CACrC,aAAqB;QAErB,IAAI,IAAI,CAAC,qBAAqB,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,qBAAqB,GAAG,MAAM,kBAAkB,CACnD,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAC5B,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAEkB,KAAK,CAAC,sBAAsB,CAC7C,YAAyB;QAEzB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEhE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAC1D,KAAK,CAAC,QAAQ,CACf,CAAC;QAEF,MAAM,mBAAmB,GAAgC;YACvD,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,mBAAmB,SAAS,EAAE;YACrC,MAAM,EAAE,yDAAyD,SAAS;;;EAG9E,KAAK,CAAC,WAAW;;;EAGjB,eAAe,EAAE;YACb,SAAS,EAAE,KAAK,EAAE,OAAgC,EAAE,EAAE;gBACpD,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC1C,CAAC;SACF,CAAC;QACF,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAoB;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC;YACxC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7D,MAAM,YAAY,GAAG,UAAU,SAAS,sCAAsC,eAAe,EAAE,CAAC;YAChG,OAAO;gBACL,UAAU,EAAE,UAAU,YAAY,EAAE;gBACpC,aAAa,EAAE,UAAU,YAAY,EAAE;gBACvC,KAAK,EAAE;oBACL,OAAO,EAAE,YAAY;oBACrB,IAAI,EAAE,aAAa,CAAC,mBAAmB;iBACxC;aACF,CAAC;QACJ,CAAC;QAED,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAEtC,iFAAiF;QACjF,iCAAiC;QACjC,IAAI,CAAC,MAAM;aACR,mBAAmB,EAAE;aACrB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE9C,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAC1D,KAAK,CAAC,QAAQ,CACf,CAAC;QAEF,OAAO;YACL,UAAU,EAAE,0BAA0B,SAAS;;MAE/C,KAAK,CAAC,IAAI;;;;MAIV,eAAe;;mBAEF;YACb,aAAa,EAAE,WAAW,SAAS,yCAAyC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,eAAe,EAAE;SACpI,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,mBAGtC;IAIW;IAHV,MAAM,CAAU,IAAI,GAAG,wBAAwB,CAAC;IAEhD,YACU,MAAc,EACtB,UAAsB;QAEtB,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,SAAS,EAAE,CAAC;QACpD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,MAAoB,CAAC;QACzB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;gBAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;gBAChB,IAAI,EAAE,CAAC;qBACJ,IAAI,CAAC,UAAmC,CAAC;qBACzC,QAAQ,CAAC,oCAAoC,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;QAED,MAAM,mBAAmB,GACvB,UAAU,CAAC,MAAM,GAAG,CAAC;YACnB,CAAC,CAAC,gBAAgB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC/D,CAAC,CAAC,EAAE,CAAC;QAET,KAAK,CACH,iBAAiB,CAAC,IAAI,EACtB,gBAAgB,EAChB,8CAA8C,mBAAmB,uRAAuR,EACxV,IAAI,CAAC,KAAK,EACV,eAAe,CAAC,MAAM,CAAC,EACvB,UAAU,EACV,IAAI,EACJ,KAAK,CACN,CAAC;QAjCM,WAAM,GAAN,MAAM,CAAQ;IAkCxB,CAAC;IAES,gBAAgB,CACxB,MAA+B,EAC/B,UAAsB,EACtB,SAAkB,EAClB,gBAAyB;QAEzB,OAAO,IAAI,2BAA2B,CACpC,IAAI,CAAC,MAAM,EACX,MAAM,EACN,UAAU,EACV,SAAS,EACT,gBAAgB,IAAI,gBAAgB,CACrC,CAAC;IACJ,CAAC"}

package/dist/src/tools/ask-user.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolResult, type ToolAskUserConfirmationDetails } from './tools.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import { type Question } from '../confirmation-bus/types.js';
+export interface AskUserParams {
+    questions: Question[];
+}
+export declare class AskUserTool extends BaseDeclarativeTool<AskUserParams, ToolResult> {
+    constructor(messageBus: MessageBus);
+    protected validateToolParamValues(params: AskUserParams): string | null;
+    protected createInvocation(params: AskUserParams, messageBus: MessageBus, toolName: string, toolDisplayName: string): AskUserInvocation;
+}
+export declare class AskUserInvocation extends BaseToolInvocation<AskUserParams, ToolResult> {
+    private confirmationOutcome;
+    private userAnswers;
+    shouldConfirmExecute(_abortSignal: AbortSignal): Promise<ToolAskUserConfirmationDetails | false>;
+    getDescription(): string;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}

package/dist/src/tools/ask-user.js

@@ -0,0 +1,155 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from './tools.js';
+import { QuestionType } from '../confirmation-bus/types.js';
+import { ASK_USER_TOOL_NAME, ASK_USER_DISPLAY_NAME } from './tool-names.js';
+export class AskUserTool extends BaseDeclarativeTool {
+    constructor(messageBus) {
+        super(ASK_USER_TOOL_NAME, ASK_USER_DISPLAY_NAME, 'Ask the user one or more questions to gather preferences, clarify requirements, or make decisions.', Kind.Communicate, {
+            type: 'object',
+            required: ['questions'],
+            properties: {
+                questions: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 4,
+                    items: {
+                        type: 'object',
+                        required: ['question', 'header'],
+                        properties: {
+                            question: {
+                                type: 'string',
+                                description: 'The complete question to ask the user. Should be clear, specific, and end with a question mark.',
+                            },
+                            header: {
+                                type: 'string',
+                                maxLength: 12,
+                                description: 'Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".',
+                            },
+                            type: {
+                                type: 'string',
+                                enum: ['choice', 'text', 'yesno'],
+                                default: 'choice',
+                                description: "Question type: 'choice' (default) for multiple-choice with options, 'text' for free-form input, 'yesno' for Yes/No confirmation.",
+                            },
+                            options: {
+                                type: 'array',
+                                description: "The selectable choices for 'choice' type questions. Provide 2-4 options. An 'Other' option is automatically added. Not needed for 'text' or 'yesno' types.",
+                                items: {
+                                    type: 'object',
+                                    required: ['label', 'description'],
+                                    properties: {
+                                        label: {
+                                            type: 'string',
+                                            description: 'The display text for this option (1-5 words). Example: "OAuth 2.0"',
+                                        },
+                                        description: {
+                                            type: 'string',
+                                            description: 'Brief explanation of this option. Example: "Industry standard, supports SSO"',
+                                        },
+                                    },
+                                },
+                            },
+                            multiSelect: {
+                                type: 'boolean',
+                                description: "Only applies when type='choice'. Set to true to allow selecting multiple options.",
+                            },
+                            placeholder: {
+                                type: 'string',
+                                description: "Only applies when type='text'. Hint text shown in the input field.",
+                            },
+                        },
+                    },
+                },
+            },
+        }, messageBus);
+    }
+    validateToolParamValues(params) {
+        if (!params.questions || params.questions.length === 0) {
+            return 'At least one question is required.';
+        }
+        for (let i = 0; i < params.questions.length; i++) {
+            const q = params.questions[i];
+            const questionType = q.type ?? QuestionType.CHOICE;
+            // Validate that 'choice' type has options
+            if (questionType === QuestionType.CHOICE) {
+                if (!q.options || q.options.length < 2) {
+                    return `Question ${i + 1}: type='choice' requires 'options' array with 2-4 items.`;
+                }
+                if (q.options.length > 4) {
+                    return `Question ${i + 1}: 'options' array must have at most 4 items.`;
+                }
+            }
+            // Validate option structure if provided
+            if (q.options) {
+                for (let j = 0; j < q.options.length; j++) {
+                    const opt = q.options[j];
+                    if (!opt.label ||
+                        typeof opt.label !== 'string' ||
+                        !opt.label.trim()) {
+                        return `Question ${i + 1}, option ${j + 1}: 'label' is required and must be a non-empty string.`;
+                    }
+                    if (opt.description === undefined ||
+                        typeof opt.description !== 'string') {
+                        return `Question ${i + 1}, option ${j + 1}: 'description' is required and must be a string.`;
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    createInvocation(params, messageBus, toolName, toolDisplayName) {
+        return new AskUserInvocation(params, messageBus, toolName, toolDisplayName);
+    }
+}
+export class AskUserInvocation extends BaseToolInvocation {
+    confirmationOutcome = null;
+    userAnswers = {};
+    async shouldConfirmExecute(_abortSignal) {
+        const normalizedQuestions = this.params.questions.map((q) => ({
+            ...q,
+            type: q.type ?? QuestionType.CHOICE,
+        }));
+        return {
+            type: 'ask_user',
+            title: 'Ask User',
+            questions: normalizedQuestions,
+            onConfirm: async (outcome, payload) => {
+                this.confirmationOutcome = outcome;
+                if (payload && 'answers' in payload) {
+                    this.userAnswers = payload.answers;
+                }
+            },
+        };
+    }
+    getDescription() {
+        return `Asking user: ${this.params.questions.map((q) => q.question).join(', ')}`;
+    }
+    async execute(_signal) {
+        if (this.confirmationOutcome === ToolConfirmationOutcome.Cancel) {
+            return {
+                llmContent: 'User dismissed ask_user dialog without answering.',
+                returnDisplay: 'User dismissed dialog',
+            };
+        }
+        const answerEntries = Object.entries(this.userAnswers);
+        const hasAnswers = answerEntries.length > 0;
+        const returnDisplay = hasAnswers
+            ? `**User answered:**\n${answerEntries
+                .map(([index, answer]) => {
+                const question = this.params.questions[parseInt(index, 10)];
+                const category = question?.header ?? `Q${index}`;
+                return `  ${category} → ${answer}`;
+            })
+                .join('\n')}`
+            : 'User submitted without answering questions.';
+        return {
+            llmContent: JSON.stringify({ answers: this.userAnswers }),
+            returnDisplay,
+        };
+    }
+}
+//# sourceMappingURL=ask-user.js.map

package/dist/src/tools/ask-user.js.map

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

package/dist/src/tools/constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const DEFAULT_TOTAL_MAX_MATCHES = 20000;
+export declare const DEFAULT_SEARCH_TIMEOUT_MS = 30000;

package/dist/src/tools/constants.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const DEFAULT_TOTAL_MAX_MATCHES = 20000;
+export const DEFAULT_SEARCH_TIMEOUT_MS = 30000;
+//# sourceMappingURL=constants.js.map

package/dist/src/tools/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAC/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC"}

package/dist/src/tools/diffOptions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as Diff from 'diff';
+import type { DiffStat } from './tools.js';
+export declare const DEFAULT_DIFF_OPTIONS: Diff.CreatePatchOptionsNonabortable;
+export declare function getDiffStat(fileName: string, oldStr: string, aiStr: string, userStr: string): DiffStat;

package/dist/src/tools/diffOptions.js

@@ -0,0 +1,50 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as Diff from 'diff';
+const DEFAULT_STRUCTURED_PATCH_OPTS = {
+    context: 3,
+    ignoreWhitespace: false,
+};
+export const DEFAULT_DIFF_OPTIONS = {
+    context: 3,
+    ignoreWhitespace: false,
+};
+export function getDiffStat(fileName, oldStr, aiStr, userStr) {
+    const getStats = (patch) => {
+        let addedLines = 0;
+        let removedLines = 0;
+        let addedChars = 0;
+        let removedChars = 0;
+        patch.hunks.forEach((hunk) => {
+            hunk.lines.forEach((line) => {
+                if (line.startsWith('+')) {
+                    addedLines++;
+                    addedChars += line.length - 1;
+                }
+                else if (line.startsWith('-')) {
+                    removedLines++;
+                    removedChars += line.length - 1;
+                }
+            });
+        });
+        return { addedLines, removedLines, addedChars, removedChars };
+    };
+    const modelPatch = Diff.structuredPatch(fileName, fileName, oldStr, aiStr, 'Current', 'Proposed', DEFAULT_STRUCTURED_PATCH_OPTS);
+    const modelStats = getStats(modelPatch);
+    const userPatch = Diff.structuredPatch(fileName, fileName, aiStr, userStr, 'Proposed', 'User', DEFAULT_STRUCTURED_PATCH_OPTS);
+    const userStats = getStats(userPatch);
+    return {
+        model_added_lines: modelStats.addedLines,
+        model_removed_lines: modelStats.removedLines,
+        model_added_chars: modelStats.addedChars,
+        model_removed_chars: modelStats.removedChars,
+        user_added_lines: userStats.addedLines,
+        user_removed_lines: userStats.removedLines,
+        user_added_chars: userStats.addedChars,
+        user_removed_chars: userStats.removedChars,
+    };
+}
+//# sourceMappingURL=diffOptions.js.map

package/dist/src/tools/diffOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diffOptions.js","sourceRoot":"","sources":["../../../src/tools/diffOptions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,6BAA6B,GAA4C;IAC7E,OAAO,EAAE,CAAC;IACV,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAwC;IACvE,OAAO,EAAE,CAAC;IACV,gBAAgB,EAAE,KAAK;CACxB,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,MAAc,EACd,KAAa,EACb,OAAe;IAEf,MAAM,QAAQ,GAAG,CAAC,KAA2B,EAAE,EAAE;QAC/C,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAA8B,EAAE,EAAE;YACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAY,EAAE,EAAE;gBAClC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzB,UAAU,EAAE,CAAC;oBACb,UAAU,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBAChC,CAAC;qBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChC,YAAY,EAAE,CAAC;oBACf,YAAY,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;IAChE,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CACrC,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,UAAU,EACV,6BAA6B,CAC9B,CAAC;IACF,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAExC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CACpC,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,OAAO,EACP,UAAU,EACV,MAAM,EACN,6BAA6B,CAC9B,CAAC;IACF,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEtC,OAAO;QACL,iBAAiB,EAAE,UAAU,CAAC,UAAU;QACxC,mBAAmB,EAAE,UAAU,CAAC,YAAY;QAC5C,iBAAiB,EAAE,UAAU,CAAC,UAAU;QACxC,mBAAmB,EAAE,UAAU,CAAC,YAAY;QAC5C,gBAAgB,EAAE,SAAS,CAAC,UAAU;QACtC,kBAAkB,EAAE,SAAS,CAAC,YAAY;QAC1C,gBAAgB,EAAE,SAAS,CAAC,UAAU;QACtC,kBAAkB,EAAE,SAAS,CAAC,YAAY;KAC3C,CAAC;AACJ,CAAC"}