@office-ai/aioncli-core 0.26.0 → 0.30.1

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

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, type ToolResult, type ToolInfoConfirmationDetails } from './tools.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import type { Config } from '../config/config.js';
+export interface EnterPlanModeParams {
+    reason?: string;
+}
+export declare class EnterPlanModeTool extends BaseDeclarativeTool<EnterPlanModeParams, ToolResult> {
+    private config;
+    constructor(config: Config, messageBus: MessageBus);
+    protected createInvocation(params: EnterPlanModeParams, messageBus: MessageBus, toolName: string, toolDisplayName: string): EnterPlanModeInvocation;
+    getSchema(modelId?: string): import("@google/genai").FunctionDeclaration;
+}
+export declare class EnterPlanModeInvocation extends BaseToolInvocation<EnterPlanModeParams, ToolResult> {
+    private config;
+    private confirmationOutcome;
+    constructor(params: EnterPlanModeParams, messageBus: MessageBus, toolName: string, toolDisplayName: string, config: Config);
+    getDescription(): string;
+    shouldConfirmExecute(abortSignal: AbortSignal): Promise<ToolInfoConfirmationDetails | false>;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}

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

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from './tools.js';
+import { ENTER_PLAN_MODE_TOOL_NAME } from './tool-names.js';
+import { ApprovalMode } from '../policy/types.js';
+import { ENTER_PLAN_MODE_DEFINITION } from './definitions/coreTools.js';
+import { resolveToolDeclaration } from './definitions/resolver.js';
+export class EnterPlanModeTool extends BaseDeclarativeTool {
+    config;
+    constructor(config, messageBus) {
+        super(ENTER_PLAN_MODE_TOOL_NAME, 'Enter Plan Mode', ENTER_PLAN_MODE_DEFINITION.base.description, Kind.Plan, ENTER_PLAN_MODE_DEFINITION.base.parametersJsonSchema, messageBus);
+        this.config = config;
+    }
+    createInvocation(params, messageBus, toolName, toolDisplayName) {
+        return new EnterPlanModeInvocation(params, messageBus, toolName, toolDisplayName, this.config);
+    }
+    getSchema(modelId) {
+        return resolveToolDeclaration(ENTER_PLAN_MODE_DEFINITION, modelId);
+    }
+}
+export class EnterPlanModeInvocation extends BaseToolInvocation {
+    config;
+    confirmationOutcome = null;
+    constructor(params, messageBus, toolName, toolDisplayName, config) {
+        super(params, messageBus, toolName, toolDisplayName);
+        this.config = config;
+    }
+    getDescription() {
+        return this.params.reason || 'Initiating Plan Mode';
+    }
+    async shouldConfirmExecute(abortSignal) {
+        const decision = await this.getMessageBusDecision(abortSignal);
+        if (decision === 'ALLOW') {
+            return false;
+        }
+        if (decision === 'DENY') {
+            throw new Error(`Tool execution for "${this._toolDisplayName || this._toolName}" denied by policy.`);
+        }
+        // ASK_USER
+        return {
+            type: 'info',
+            title: 'Enter Plan Mode',
+            prompt: 'This will restrict the agent to read-only tools to allow for safe planning.',
+            onConfirm: async (outcome) => {
+                this.confirmationOutcome = outcome;
+                await this.publishPolicyUpdate(outcome);
+            },
+        };
+    }
+    async execute(_signal) {
+        if (this.confirmationOutcome === ToolConfirmationOutcome.Cancel) {
+            return {
+                llmContent: 'User cancelled entering Plan Mode.',
+                returnDisplay: 'Cancelled',
+            };
+        }
+        this.config.setApprovalMode(ApprovalMode.PLAN);
+        return {
+            llmContent: 'Switching to Plan mode.',
+            returnDisplay: this.params.reason
+                ? `Switching to Plan mode: ${this.params.reason}`
+                : 'Switching to Plan mode',
+        };
+    }
+}
+//# sourceMappingURL=enter-plan-mode.js.map

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

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

package/dist/src/tools/enter-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/enter-plan-mode.test.js

@@ -0,0 +1,102 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { EnterPlanModeTool } from './enter-plan-mode.js';
+import { createMockMessageBus } from '../test-utils/mock-message-bus.js';
+import { ToolConfirmationOutcome } from './tools.js';
+import { ApprovalMode } from '../policy/types.js';
+describe('EnterPlanModeTool', () => {
+    let tool;
+    let mockMessageBus;
+    let mockConfig;
+    beforeEach(() => {
+        mockMessageBus = createMockMessageBus();
+        vi.mocked(mockMessageBus.publish).mockResolvedValue(undefined);
+        mockConfig = {
+            setApprovalMode: vi.fn(),
+            storage: {
+                getProjectTempPlansDir: vi.fn().mockReturnValue('/mock/plans/dir'),
+            },
+        };
+        tool = new EnterPlanModeTool(mockConfig, mockMessageBus);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('shouldConfirmExecute', () => {
+        it('should return info confirmation details when policy says ASK_USER', async () => {
+            const invocation = tool.build({});
+            // Mock getMessageBusDecision to return ASK_USER
+            vi.spyOn(invocation, 'getMessageBusDecision').mockResolvedValue('ASK_USER');
+            const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(result).not.toBe(false);
+            if (result === false)
+                return;
+            expect(result.type).toBe('info');
+            expect(result.title).toBe('Enter Plan Mode');
+            if (result.type === 'info') {
+                expect(result.prompt).toBe('This will restrict the agent to read-only tools to allow for safe planning.');
+            }
+        });
+        it('should return false when policy decision is ALLOW', async () => {
+            const invocation = tool.build({});
+            // Mock getMessageBusDecision to return ALLOW
+            vi.spyOn(invocation, 'getMessageBusDecision').mockResolvedValue('ALLOW');
+            const result = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(result).toBe(false);
+        });
+        it('should throw error when policy decision is DENY', async () => {
+            const invocation = tool.build({});
+            // Mock getMessageBusDecision to return DENY
+            vi.spyOn(invocation, 'getMessageBusDecision').mockResolvedValue('DENY');
+            await expect(invocation.shouldConfirmExecute(new AbortController().signal)).rejects.toThrow(/denied by policy/);
+        });
+    });
+    describe('execute', () => {
+        it('should set approval mode to PLAN and return message', async () => {
+            const invocation = tool.build({});
+            const result = await invocation.execute(new AbortController().signal);
+            expect(mockConfig.setApprovalMode).toHaveBeenCalledWith(ApprovalMode.PLAN);
+            expect(result.llmContent).toContain('Switching to Plan mode');
+            expect(result.returnDisplay).toBe('Switching to Plan mode');
+        });
+        it('should include optional reason in output display but not in llmContent', async () => {
+            const reason = 'Design new database schema';
+            const invocation = tool.build({ reason });
+            const result = await invocation.execute(new AbortController().signal);
+            expect(mockConfig.setApprovalMode).toHaveBeenCalledWith(ApprovalMode.PLAN);
+            expect(result.llmContent).toBe('Switching to Plan mode.');
+            expect(result.llmContent).not.toContain(reason);
+            expect(result.returnDisplay).toContain(reason);
+        });
+        it('should not enter plan mode if cancelled', async () => {
+            const invocation = tool.build({});
+            // Simulate getting confirmation details
+            vi.spyOn(invocation, 'getMessageBusDecision').mockResolvedValue('ASK_USER');
+            const details = await invocation.shouldConfirmExecute(new AbortController().signal);
+            expect(details).not.toBe(false);
+            if (details) {
+                // Simulate user cancelling
+                await details.onConfirm(ToolConfirmationOutcome.Cancel);
+            }
+            const result = await invocation.execute(new AbortController().signal);
+            expect(mockConfig.setApprovalMode).not.toHaveBeenCalled();
+            expect(result.returnDisplay).toBe('Cancelled');
+            expect(result.llmContent).toContain('User cancelled');
+        });
+    });
+    describe('validateToolParams', () => {
+        it('should allow empty params', () => {
+            const result = tool.validateToolParams({});
+            expect(result).toBeNull();
+        });
+        it('should allow reason param', () => {
+            const result = tool.validateToolParams({ reason: 'test' });
+            expect(result).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=enter-plan-mode.test.js.map

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

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

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