@office-ai/aioncli-core 0.26.0 → 0.30.0

package/dist/src/tools/exit-plan-mode.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolResult, type ToolExitPlanModeConfirmationDetails } from './tools.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import type { Config } from '../config/config.js';
+export interface ExitPlanModeParams {
+    plan_path: string;
+}
+export declare class ExitPlanModeTool extends BaseDeclarativeTool<ExitPlanModeParams, ToolResult> {
+    private config;
+    constructor(config: Config, messageBus: MessageBus);
+    protected validateToolParamValues(params: ExitPlanModeParams): string | null;
+    protected createInvocation(params: ExitPlanModeParams, messageBus: MessageBus, toolName: string, toolDisplayName: string): ExitPlanModeInvocation;
+    getSchema(modelId?: string): import("@google/genai").FunctionDeclaration;
+}
+export declare class ExitPlanModeInvocation extends BaseToolInvocation<ExitPlanModeParams, ToolResult> {
+    private config;
+    private confirmationOutcome;
+    private approvalPayload;
+    private planValidationError;
+    constructor(params: ExitPlanModeParams, messageBus: MessageBus, toolName: string, toolDisplayName: string, config: Config);
+    shouldConfirmExecute(abortSignal: AbortSignal): Promise<ToolExitPlanModeConfirmationDetails | false>;
+    getDescription(): string;
+    /**
+     * Returns the resolved plan path.
+     * Note: Validation is done in validateToolParamValues, so this assumes the path is valid.
+     */
+    private getResolvedPlanPath;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}

package/dist/src/tools/exit-plan-mode.js

@@ -0,0 +1,173 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from './tools.js';
+import path from 'node:path';
+import { EXIT_PLAN_MODE_TOOL_NAME } from './tool-names.js';
+import { validatePlanPath, validatePlanContent } from '../utils/planUtils.js';
+import { ApprovalMode } from '../policy/types.js';
+import { checkExhaustive } from '../utils/checks.js';
+import { resolveToRealPath, isSubpath } from '../utils/paths.js';
+import { logPlanExecution } from '../telemetry/loggers.js';
+import { PlanExecutionEvent } from '../telemetry/types.js';
+import { getExitPlanModeDefinition } from './definitions/coreTools.js';
+import { resolveToolDeclaration } from './definitions/resolver.js';
+/**
+ * Returns a human-readable description for an approval mode.
+ */
+function getApprovalModeDescription(mode) {
+    switch (mode) {
+        case ApprovalMode.AUTO_EDIT:
+            return 'Auto-Edit mode (edits will be applied automatically)';
+        case ApprovalMode.DEFAULT:
+            return 'Default mode (edits will require confirmation)';
+        case ApprovalMode.YOLO:
+        case ApprovalMode.PLAN:
+            // YOLO and PLAN are not valid modes to enter when exiting plan mode
+            throw new Error(`Unexpected approval mode: ${mode}`);
+        default:
+            checkExhaustive(mode);
+    }
+}
+export class ExitPlanModeTool extends BaseDeclarativeTool {
+    config;
+    constructor(config, messageBus) {
+        const plansDir = config.storage.getProjectTempPlansDir();
+        const definition = getExitPlanModeDefinition(plansDir);
+        super(EXIT_PLAN_MODE_TOOL_NAME, 'Exit Plan Mode', definition.base.description, Kind.Plan, definition.base.parametersJsonSchema, messageBus);
+        this.config = config;
+    }
+    validateToolParamValues(params) {
+        if (!params.plan_path || params.plan_path.trim() === '') {
+            return 'plan_path is required.';
+        }
+        // Since validateToolParamValues is synchronous, we use a basic synchronous check
+        // for path traversal safety. High-level async validation is deferred to shouldConfirmExecute.
+        const plansDir = resolveToRealPath(this.config.storage.getProjectTempPlansDir());
+        const resolvedPath = path.resolve(this.config.getTargetDir(), params.plan_path);
+        const realPath = resolveToRealPath(resolvedPath);
+        if (!isSubpath(plansDir, realPath)) {
+            return `Access denied: plan path must be within the designated plans directory.`;
+        }
+        return null;
+    }
+    createInvocation(params, messageBus, toolName, toolDisplayName) {
+        return new ExitPlanModeInvocation(params, messageBus, toolName, toolDisplayName, this.config);
+    }
+    getSchema(modelId) {
+        const plansDir = this.config.storage.getProjectTempPlansDir();
+        return resolveToolDeclaration(getExitPlanModeDefinition(plansDir), modelId);
+    }
+}
+export class ExitPlanModeInvocation extends BaseToolInvocation {
+    config;
+    confirmationOutcome = null;
+    approvalPayload = null;
+    planValidationError = null;
+    constructor(params, messageBus, toolName, toolDisplayName, config) {
+        super(params, messageBus, toolName, toolDisplayName);
+        this.config = config;
+    }
+    async shouldConfirmExecute(abortSignal) {
+        const resolvedPlanPath = this.getResolvedPlanPath();
+        const pathError = await validatePlanPath(this.params.plan_path, this.config.storage.getProjectTempPlansDir(), this.config.getTargetDir());
+        if (pathError) {
+            this.planValidationError = pathError;
+            return false;
+        }
+        const contentError = await validatePlanContent(resolvedPlanPath);
+        if (contentError) {
+            this.planValidationError = contentError;
+            return false;
+        }
+        const decision = await this.getMessageBusDecision(abortSignal);
+        if (decision === 'DENY') {
+            throw new Error(`Tool execution for "${this._toolDisplayName || this._toolName}" denied by policy.`);
+        }
+        if (decision === 'ALLOW') {
+            // If policy is allow, auto-approve with default settings and execute.
+            this.confirmationOutcome = ToolConfirmationOutcome.ProceedOnce;
+            this.approvalPayload = {
+                approved: true,
+                approvalMode: ApprovalMode.DEFAULT,
+            };
+            return false;
+        }
+        // decision is 'ASK_USER'
+        return {
+            type: 'exit_plan_mode',
+            title: 'Plan Approval',
+            planPath: resolvedPlanPath,
+            onConfirm: async (outcome, payload) => {
+                this.confirmationOutcome = outcome;
+                if (payload && 'approved' in payload) {
+                    this.approvalPayload = payload;
+                }
+            },
+        };
+    }
+    getDescription() {
+        return `Requesting plan approval for: ${this.params.plan_path}`;
+    }
+    /**
+     * Returns the resolved plan path.
+     * Note: Validation is done in validateToolParamValues, so this assumes the path is valid.
+     */
+    getResolvedPlanPath() {
+        return path.resolve(this.config.getTargetDir(), this.params.plan_path);
+    }
+    async execute(_signal) {
+        const resolvedPlanPath = this.getResolvedPlanPath();
+        if (this.planValidationError) {
+            return {
+                llmContent: this.planValidationError,
+                returnDisplay: 'Error: Invalid plan',
+            };
+        }
+        if (this.confirmationOutcome === ToolConfirmationOutcome.Cancel) {
+            return {
+                llmContent: 'User cancelled the plan approval dialog. The plan was not approved and you are still in Plan Mode.',
+                returnDisplay: 'Cancelled',
+            };
+        }
+        const payload = this.approvalPayload;
+        if (payload?.approved) {
+            const newMode = payload.approvalMode ?? ApprovalMode.DEFAULT;
+            this.config.setApprovalMode(newMode);
+            this.config.setApprovedPlanPath(resolvedPlanPath);
+            logPlanExecution(this.config, new PlanExecutionEvent(newMode));
+            const description = getApprovalModeDescription(newMode);
+            return {
+                llmContent: `Plan approved. Switching to ${description}.
+
+The approved implementation plan is stored at: ${resolvedPlanPath}
+Read and follow the plan strictly during implementation.`,
+                returnDisplay: `Plan approved: ${resolvedPlanPath}`,
+            };
+        }
+        else {
+            const feedback = payload?.feedback?.trim();
+            if (feedback) {
+                return {
+                    llmContent: `Plan rejected. User feedback: ${feedback}
+
+The plan is stored at: ${resolvedPlanPath}
+Revise the plan based on the feedback.`,
+                    returnDisplay: `Feedback: ${feedback}`,
+                };
+            }
+            else {
+                return {
+                    llmContent: `Plan rejected. No feedback provided.
+
+The plan is stored at: ${resolvedPlanPath}
+Ask the user for specific feedback on how to improve the plan.`,
+                    returnDisplay: 'Rejected (no feedback)',
+                };
+            }
+        }
+    }
+}
+//# sourceMappingURL=exit-plan-mode.js.map

package/dist/src/tools/exit-plan-mode.js.map

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

package/dist/src/tools/exit-plan-mode.test.d.ts

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

package/dist/src/tools/exit-plan-mode.test.js

@@ -0,0 +1,311 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { ExitPlanModeTool, ExitPlanModeInvocation } from './exit-plan-mode.js';
+import { createMockMessageBus } from '../test-utils/mock-message-bus.js';
+import path from 'node:path';
+import { ToolConfirmationOutcome } from './tools.js';
+import { ApprovalMode } from '../policy/types.js';
+import * as fs from 'node:fs';
+import os from 'node:os';
+import { validatePlanPath } from '../utils/planUtils.js';
+import * as loggers from '../telemetry/loggers.js';
+vi.mock('../telemetry/loggers.js', () => ({
+    logPlanExecution: vi.fn(),
+}));
+describe('ExitPlanModeTool', () => {
+    let tool;
+    let mockMessageBus;
+    let mockConfig;
+    let tempRootDir;
+    let mockPlansDir;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        mockMessageBus = createMockMessageBus();
+        vi.mocked(mockMessageBus.publish).mockResolvedValue(undefined);
+        tempRootDir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'exit-plan-test-')));
+        const plansDirRaw = path.join(tempRootDir, 'plans');
+        fs.mkdirSync(plansDirRaw, { recursive: true });
+        mockPlansDir = fs.realpathSync(plansDirRaw);
+        mockConfig = {
+            getTargetDir: vi.fn().mockReturnValue(tempRootDir),
+            setApprovalMode: vi.fn(),
+            setApprovedPlanPath: vi.fn(),
+            storage: {
+                getProjectTempPlansDir: vi.fn().mockReturnValue(mockPlansDir),
+            },
+        };
+        tool = new ExitPlanModeTool(mockConfig, mockMessageBus);
+        // Mock getMessageBusDecision on the invocation prototype
+        vi.spyOn(ExitPlanModeInvocation.prototype, 'getMessageBusDecision').mockResolvedValue('ASK_USER');
+    });
+    afterEach(() => {
+        if (fs.existsSync(tempRootDir)) {
+            fs.rmSync(tempRootDir, { recursive: true, force: true });
+        }
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    const createPlanFile = (name, content) => {
+        const filePath = path.join(mockPlansDir, name);
+        fs.writeFileSync(filePath, content);
+        return path.join('plans', name);
+    };
+    describe('shouldConfirmExecute', () => {
+        it('should return plan approval confirmation details when plan has content', async () => {
+            const planRelativePath = createPlanFile('test-plan.md', '# My Plan');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(result).not.toBe(false);
+            if (result === false)
+                return;
+            expect(result.type).toBe('exit_plan_mode');
+            expect(result.title).toBe('Plan Approval');
+            if (result.type === 'exit_plan_mode') {
+                expect(result.planPath).toBe(path.join(mockPlansDir, 'test-plan.md'));
+            }
+            expect(typeof result.onConfirm).toBe('function');
+        });
+        it('should return false when plan file is empty', async () => {
+            const planRelativePath = createPlanFile('empty.md', '   ');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(result).toBe(false);
+        });
+        it('should return false when plan file cannot be read', async () => {
+            const planRelativePath = path.join('plans', 'non-existent.md');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(result).toBe(false);
+        });
+        it('should auto-approve when policy decision is ALLOW', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            vi.spyOn(invocation, 'getMessageBusDecision').mockResolvedValue('ALLOW');
+            const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(result).toBe(false);
+            // Verify it auto-approved internally
+            const executeResult = await invocation.execute(new AbortController().signal);
+            expect(executeResult.llmContent).toContain('Plan approved');
+        });
+        it('should throw error when policy decision is DENY', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            vi.spyOn(invocation, 'getMessageBusDecision').mockResolvedValue('DENY');
+            await expect(invocation.shouldConfirmExecute(new AbortController().signal)).rejects.toThrow(/denied by policy/);
+        });
+    });
+    describe('execute with invalid plan', () => {
+        it('should return error when plan file is empty', async () => {
+            const planRelativePath = createPlanFile('empty.md', '');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            await invocation.shouldConfirmExecute(new AbortController().signal);
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('Plan file is empty');
+            expect(result.llmContent).toContain('write content to the plan');
+        });
+        it('should return error when plan file cannot be read', async () => {
+            const planRelativePath = 'plans/ghost.md';
+            const invocation = tool.build({ plan_path: planRelativePath });
+            await invocation.shouldConfirmExecute(new AbortController().signal);
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result.llmContent).toContain('Plan file does not exist');
+        });
+    });
+    describe('execute', () => {
+        it('should return approval message when plan is approved with DEFAULT mode', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const confirmDetails = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(confirmDetails).not.toBe(false);
+            if (confirmDetails === false)
+                return;
+            await confirmDetails.onConfirm(ToolConfirmationOutcome.ProceedOnce, {
+                approved: true,
+                approvalMode: ApprovalMode.DEFAULT,
+            });
+            const result = await invocation.execute(new AbortController().signal);
+            const expectedPath = path.join(mockPlansDir, 'test.md');
+            expect(result).toEqual({
+                llmContent: `Plan approved. Switching to Default mode (edits will require confirmation).
+
+The approved implementation plan is stored at: ${expectedPath}
+Read and follow the plan strictly during implementation.`,
+                returnDisplay: `Plan approved: ${expectedPath}`,
+            });
+            expect(mockConfig.setApprovedPlanPath).toHaveBeenCalledWith(expectedPath);
+        });
+        it('should return approval message when plan is approved with AUTO_EDIT mode', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const confirmDetails = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(confirmDetails).not.toBe(false);
+            if (confirmDetails === false)
+                return;
+            await confirmDetails.onConfirm(ToolConfirmationOutcome.ProceedOnce, {
+                approved: true,
+                approvalMode: ApprovalMode.AUTO_EDIT,
+            });
+            const result = await invocation.execute(new AbortController().signal);
+            const expectedPath = path.join(mockPlansDir, 'test.md');
+            expect(result).toEqual({
+                llmContent: `Plan approved. Switching to Auto-Edit mode (edits will be applied automatically).
+
+The approved implementation plan is stored at: ${expectedPath}
+Read and follow the plan strictly during implementation.`,
+                returnDisplay: `Plan approved: ${expectedPath}`,
+            });
+            expect(mockConfig.setApprovalMode).toHaveBeenCalledWith(ApprovalMode.AUTO_EDIT);
+            expect(mockConfig.setApprovedPlanPath).toHaveBeenCalledWith(expectedPath);
+        });
+        it('should return feedback message when plan is rejected with feedback', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const confirmDetails = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(confirmDetails).not.toBe(false);
+            if (confirmDetails === false)
+                return;
+            await confirmDetails.onConfirm(ToolConfirmationOutcome.ProceedOnce, {
+                approved: false,
+                feedback: 'Please add more details.',
+            });
+            const result = await invocation.execute(new AbortController().signal);
+            const expectedPath = path.join(mockPlansDir, 'test.md');
+            expect(result).toEqual({
+                llmContent: `Plan rejected. User feedback: Please add more details.
+
+The plan is stored at: ${expectedPath}
+Revise the plan based on the feedback.`,
+                returnDisplay: 'Feedback: Please add more details.',
+            });
+        });
+        it('should handle rejection without feedback gracefully', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const confirmDetails = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(confirmDetails).not.toBe(false);
+            if (confirmDetails === false)
+                return;
+            await confirmDetails.onConfirm(ToolConfirmationOutcome.ProceedOnce, {
+                approved: false,
+            });
+            const result = await invocation.execute(new AbortController().signal);
+            const expectedPath = path.join(mockPlansDir, 'test.md');
+            expect(result).toEqual({
+                llmContent: `Plan rejected. No feedback provided.
+
+The plan is stored at: ${expectedPath}
+Ask the user for specific feedback on how to improve the plan.`,
+                returnDisplay: 'Rejected (no feedback)',
+            });
+        });
+        it('should log plan execution event when plan is approved', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const confirmDetails = await invocation.shouldConfirmExecute(new AbortController().signal);
+            if (confirmDetails === false)
+                return;
+            await confirmDetails.onConfirm(ToolConfirmationOutcome.ProceedOnce, {
+                approved: true,
+                approvalMode: ApprovalMode.AUTO_EDIT,
+            });
+            await invocation.execute(new AbortController().signal);
+            expect(loggers.logPlanExecution).toHaveBeenCalledWith(mockConfig, expect.objectContaining({
+                approval_mode: ApprovalMode.AUTO_EDIT,
+            }));
+        });
+        it('should return cancellation message when cancelled', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const confirmDetails = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(confirmDetails).not.toBe(false);
+            if (confirmDetails === false)
+                return;
+            await confirmDetails.onConfirm(ToolConfirmationOutcome.Cancel);
+            const result = await invocation.execute(new AbortController().signal);
+            expect(result).toEqual({
+                llmContent: 'User cancelled the plan approval dialog. The plan was not approved and you are still in Plan Mode.',
+                returnDisplay: 'Cancelled',
+            });
+        });
+    });
+    describe('getApprovalModeDescription (internal)', () => {
+        it('should handle all valid approval modes', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const testMode = async (mode, expected) => {
+                const confirmDetails = await invocation.shouldConfirmExecute(new AbortController().signal);
+                if (confirmDetails === false)
+                    return;
+                await confirmDetails.onConfirm(ToolConfirmationOutcome.ProceedOnce, {
+                    approved: true,
+                    approvalMode: mode,
+                });
+                const result = await invocation.execute(new AbortController().signal);
+                expect(result.llmContent).toContain(expected);
+            };
+            await testMode(ApprovalMode.AUTO_EDIT, 'Auto-Edit mode (edits will be applied automatically)');
+            await testMode(ApprovalMode.DEFAULT, 'Default mode (edits will require confirmation)');
+        });
+        it('should throw for invalid post-planning modes', async () => {
+            const planRelativePath = createPlanFile('test.md', '# Content');
+            const invocation = tool.build({ plan_path: planRelativePath });
+            const testInvalidMode = async (mode) => {
+                const confirmDetails = await invocation.shouldConfirmExecute(new AbortController().signal);
+                if (confirmDetails === false)
+                    return;
+                await confirmDetails.onConfirm(ToolConfirmationOutcome.ProceedOnce, {
+                    approved: true,
+                    approvalMode: mode,
+                });
+                await expect(invocation.execute(new AbortController().signal)).rejects.toThrow(/Unexpected approval mode/);
+            };
+            await testInvalidMode(ApprovalMode.YOLO);
+            await testInvalidMode(ApprovalMode.PLAN);
+        });
+    });
+    it('should throw error during build if plan path is outside plans directory', () => {
+        expect(() => tool.build({ plan_path: '../../../etc/passwd' })).toThrow(/Access denied/);
+    });
+    describe('validateToolParams', () => {
+        it('should reject empty plan_path', () => {
+            const result = tool.validateToolParams({ plan_path: '' });
+            expect(result).toBe('plan_path is required.');
+        });
+        it('should reject whitespace-only plan_path', () => {
+            const result = tool.validateToolParams({ plan_path: '   ' });
+            expect(result).toBe('plan_path is required.');
+        });
+        it('should reject path outside plans directory', () => {
+            const result = tool.validateToolParams({
+                plan_path: '../../../etc/passwd',
+            });
+            expect(result).toContain('Access denied');
+        });
+        it('should reject non-existent plan file', async () => {
+            const result = await validatePlanPath('plans/ghost.md', mockPlansDir, tempRootDir);
+            expect(result).toContain('Plan file does not exist');
+        });
+        it('should reject symbolic links pointing outside the plans directory', () => {
+            const outsideFile = path.join(tempRootDir, 'outside.txt');
+            fs.writeFileSync(outsideFile, 'secret');
+            const maliciousPath = path.join(mockPlansDir, 'malicious.md');
+            fs.symlinkSync(outsideFile, maliciousPath);
+            const result = tool.validateToolParams({
+                plan_path: 'plans/malicious.md',
+            });
+            expect(result).toBe('Access denied: plan path must be within the designated plans directory.');
+        });
+        it('should accept valid path within plans directory', () => {
+            createPlanFile('valid.md', '# Content');
+            const result = tool.validateToolParams({
+                plan_path: 'plans/valid.md',
+            });
+            expect(result).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=exit-plan-mode.test.js.map

package/dist/src/tools/exit-plan-mode.test.js.map

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

package/dist/src/tools/get-internal-docs.d.ts

@@ -24,4 +24,5 @@ export declare class GetInternalDocsTool extends BaseDeclarativeTool<GetInternal
     static readonly Name = "get_internal_docs";
     constructor(messageBus: MessageBus);
     protected createInvocation(params: GetInternalDocsParams, messageBus: MessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<GetInternalDocsParams, ToolResult>;
+    getSchema(modelId?: string): import("@google/genai").FunctionDeclaration;
 }

package/dist/src/tools/get-internal-docs.js

@@ -10,12 +10,14 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { glob } from 'glob';
 import { ToolErrorType } from './tool-error.js';
+import { GET_INTERNAL_DOCS_DEFINITION } from './definitions/coreTools.js';
+import { resolveToolDeclaration } from './definitions/resolver.js';
 /**
  * Helper to find the absolute path to the documentation directory.
  */
 async function getDocsRoot() {
     const currentFile = fileURLToPath(import.meta.url);
-    const currentDir = path.dirname(currentFile);
+    let searchDir = path.dirname(currentFile);
     const isDocsDir = async (dir) => {
         try {
             const stats = await fs.stat(dir);
@@ -30,23 +32,16 @@ async function getDocsRoot() {
         }
         return false;
     };
-    // 1. Check for documentation in the distributed package (dist/docs)
-    // Path: dist/src/tools/get-internal-docs.js -> dist/docs
-    const distDocsPath = path.resolve(currentDir, '..', '..', 'docs');
-    if (await isDocsDir(distDocsPath)) {
-        return distDocsPath;
-    }
-    // 2. Check for documentation in the repository root (development)
-    // Path: packages/core/src/tools/get-internal-docs.ts -> docs/
-    const repoDocsPath = path.resolve(currentDir, '..', '..', '..', '..', 'docs');
-    if (await isDocsDir(repoDocsPath)) {
-        return repoDocsPath;
-    }
-    // 3. Check for documentation in the bundle directory (bundle/docs)
-    // Path: bundle/gemini.js -> bundle/docs
-    const bundleDocsPath = path.join(currentDir, 'docs');
-    if (await isDocsDir(bundleDocsPath)) {
-        return bundleDocsPath;
+    while (true) {
+        const candidate = path.join(searchDir, 'docs');
+        if (await isDocsDir(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(searchDir);
+        if (parent === searchDir) {
+            break;
+        }
+        searchDir = parent;
     }
     throw new Error('Could not find Gemini CLI documentation directory.');
 }
@@ -110,20 +105,15 @@ class GetInternalDocsInvocation extends BaseToolInvocation {
 export class GetInternalDocsTool extends BaseDeclarativeTool {
     static Name = GET_INTERNAL_DOCS_TOOL_NAME;
     constructor(messageBus) {
-        super(GetInternalDocsTool.Name, 'GetInternalDocs', 'Returns the content of Gemini CLI internal documentation files. If no path is provided, returns a list of all available documentation paths.', Kind.Think, {
-            type: 'object',
-            properties: {
-                path: {
-                    description: "The relative path to the documentation file (e.g., 'cli/commands.md'). If omitted, lists all available documentation.",
-                    type: 'string',
-                },
-            },
-        }, messageBus, 
+        super(GetInternalDocsTool.Name, 'GetInternalDocs', GET_INTERNAL_DOCS_DEFINITION.base.description, Kind.Think, GET_INTERNAL_DOCS_DEFINITION.base.parametersJsonSchema, messageBus, 
         /* isOutputMarkdown */ true, 
         /* canUpdateOutput */ false);
     }
     createInvocation(params, messageBus, _toolName, _toolDisplayName) {
         return new GetInternalDocsInvocation(params, messageBus, _toolName ?? GetInternalDocsTool.Name, _toolDisplayName);
     }
+    getSchema(modelId) {
+        return resolveToolDeclaration(GET_INTERNAL_DOCS_DEFINITION, modelId);
+    }
 }
 //# sourceMappingURL=get-internal-docs.js.map