gencode-ai 0.1.2 → 0.2.0

package/dist/planning/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/planning/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,QAAQ,EACR,aAAa,EACd,MAAM,YAAY,CAAC;AAOpB;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,cAAc,CAAsC;;IAO5D;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,QAAQ,IAAI,QAAQ,CAAC,aAAa,CAAC;IAInC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,cAAc,IAAI,QAAQ;IAI1B;;OAEG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI;IAa3D;;OAEG;IACH,IAAI,CAAC,QAAQ,GAAE,OAAe,GAAG,IAAI;IASrC;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IASnC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAOhC;;OAEG;IACH,QAAQ,IAAI,SAAS;IAIrB;;OAEG;IACH,uBAAuB,CAAC,WAAW,EAAE,aAAa,EAAE,GAAG,IAAI;IAI3D;;OAEG;IACH,uBAAuB,IAAI,aAAa,EAAE;IAI1C;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASxC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQxC;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAO3B;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAO3B;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAY1C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAO/D;;OAEG;IACH,OAAO,CAAC,IAAI;CASb;AAWD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAEzC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAElF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,GAAE,OAAe,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAE1D"}

package/dist/planning/state.js

@@ -0,0 +1,261 @@
+/**
+ * Plan Mode State Management
+ *
+ * Singleton state manager for plan mode. Tracks whether plan mode
+ * is active, current phase, and manages tool filtering.
+ */
+import { PLAN_MODE_ALLOWED_TOOLS, PLAN_MODE_BLOCKED_TOOLS } from './types.js';
+// ============================================================================
+// State Manager
+// ============================================================================
+/**
+ * Plan Mode State Manager
+ *
+ * Manages the plan mode state and provides methods for:
+ * - Entering/exiting plan mode
+ * - Phase transitions
+ * - Tool filtering
+ * - Event notifications
+ */
+export class PlanModeManager {
+    state;
+    eventListeners;
+    constructor() {
+        this.state = this.getInitialState();
+        this.eventListeners = new Set();
+    }
+    /**
+     * Get initial state
+     */
+    getInitialState() {
+        return {
+            active: false,
+            phase: 'understanding',
+            planFilePath: null,
+            originalRequest: null,
+            requestedPermissions: [],
+            enteredAt: null,
+        };
+    }
+    /**
+     * Get current state (readonly)
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Check if plan mode is active
+     */
+    isActive() {
+        return this.state.active;
+    }
+    /**
+     * Get current mode type for UI
+     * Note: Returns 'plan' or 'normal'. 'accept' mode is managed at the App level.
+     */
+    getCurrentMode() {
+        return this.state.active ? 'plan' : 'normal';
+    }
+    /**
+     * Enter plan mode
+     */
+    enter(planFilePath, originalRequest) {
+        this.state = {
+            active: true,
+            phase: 'understanding',
+            planFilePath,
+            originalRequest: originalRequest ?? null,
+            requestedPermissions: [],
+            enteredAt: new Date(),
+        };
+        this.emit({ type: 'enter', planFilePath });
+    }
+    /**
+     * Exit plan mode
+     */
+    exit(approved = false) {
+        const wasActive = this.state.active;
+        this.state = this.getInitialState();
+        if (wasActive) {
+            this.emit({ type: 'exit', approved });
+        }
+    }
+    /**
+     * Toggle plan mode (for Shift+Tab)
+     */
+    toggle(planFilePath) {
+        if (this.state.active) {
+            this.exit(false);
+        }
+        else if (planFilePath) {
+            this.enter(planFilePath);
+        }
+        this.emit({ type: 'toggle' });
+    }
+    /**
+     * Update phase
+     */
+    setPhase(phase) {
+        if (this.state.active) {
+            this.state.phase = phase;
+            this.emit({ type: 'phase_change', phase });
+        }
+    }
+    /**
+     * Get current phase
+     */
+    getPhase() {
+        return this.state.phase;
+    }
+    /**
+     * Set requested permissions (from ExitPlanMode)
+     */
+    setRequestedPermissions(permissions) {
+        this.state.requestedPermissions = permissions;
+    }
+    /**
+     * Get requested permissions
+     */
+    getRequestedPermissions() {
+        return [...this.state.requestedPermissions];
+    }
+    /**
+     * Get plan file path
+     */
+    getPlanFilePath() {
+        return this.state.planFilePath;
+    }
+    // ============================================================================
+    // Tool Filtering
+    // ============================================================================
+    /**
+     * Check if a tool is allowed in the current mode
+     */
+    isToolAllowed(toolName) {
+        if (!this.state.active) {
+            return true; // All tools allowed in build mode
+        }
+        // In plan mode, only allow read-only tools
+        return PLAN_MODE_ALLOWED_TOOLS.includes(toolName);
+    }
+    /**
+     * Check if a tool is blocked in the current mode
+     */
+    isToolBlocked(toolName) {
+        if (!this.state.active) {
+            return false; // No tools blocked in build mode
+        }
+        return PLAN_MODE_BLOCKED_TOOLS.includes(toolName);
+    }
+    /**
+     * Get list of allowed tools for current mode
+     */
+    getAllowedTools() {
+        if (!this.state.active) {
+            return []; // Empty means all allowed
+        }
+        return [...PLAN_MODE_ALLOWED_TOOLS];
+    }
+    /**
+     * Get list of blocked tools for current mode
+     */
+    getBlockedTools() {
+        if (!this.state.active) {
+            return [];
+        }
+        return [...PLAN_MODE_BLOCKED_TOOLS];
+    }
+    /**
+     * Filter tool list based on current mode
+     */
+    filterTools(toolNames) {
+        if (!this.state.active) {
+            return toolNames;
+        }
+        return toolNames.filter((name) => this.isToolAllowed(name));
+    }
+    // ============================================================================
+    // Event System
+    // ============================================================================
+    /**
+     * Subscribe to plan mode events
+     */
+    subscribe(listener) {
+        this.eventListeners.add(listener);
+        return () => {
+            this.eventListeners.delete(listener);
+        };
+    }
+    /**
+     * Emit an event to all listeners
+     */
+    emit(event) {
+        for (const listener of this.eventListeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('Error in plan mode event listener:', error);
+            }
+        }
+    }
+}
+// ============================================================================
+// Singleton Instance
+// ============================================================================
+/**
+ * Global plan mode manager instance
+ */
+let globalPlanModeManager = null;
+/**
+ * Get the global plan mode manager
+ */
+export function getPlanModeManager() {
+    if (!globalPlanModeManager) {
+        globalPlanModeManager = new PlanModeManager();
+    }
+    return globalPlanModeManager;
+}
+/**
+ * Reset the global plan mode manager (for testing)
+ */
+export function resetPlanModeManager() {
+    if (globalPlanModeManager) {
+        globalPlanModeManager.exit(false);
+    }
+    globalPlanModeManager = null;
+}
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+/**
+ * Check if plan mode is currently active
+ */
+export function isPlanModeActive() {
+    return getPlanModeManager().isActive();
+}
+/**
+ * Get the current mode type
+ */
+export function getCurrentMode() {
+    return getPlanModeManager().getCurrentMode();
+}
+/**
+ * Enter plan mode
+ */
+export function enterPlanMode(planFilePath, originalRequest) {
+    getPlanModeManager().enter(planFilePath, originalRequest);
+}
+/**
+ * Exit plan mode
+ */
+export function exitPlanMode(approved = false) {
+    getPlanModeManager().exit(approved);
+}
+/**
+ * Toggle plan mode
+ */
+export function togglePlanMode(planFilePath) {
+    getPlanModeManager().toggle(planFilePath);
+}
+//# sourceMappingURL=state.js.map

package/dist/planning/state.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * EnterPlanMode Tool
+ *
+ * Transitions the agent into plan mode for designing implementation
+ * approaches before writing code. In plan mode, only read-only tools
+ * are available.
+ */
+import { z } from 'zod';
+import type { Tool } from '../../tools/types.js';
+declare const EnterPlanModeInputSchema: z.ZodObject<{}, z.core.$strip>;
+export type EnterPlanModeInput = z.infer<typeof EnterPlanModeInputSchema>;
+/**
+ * EnterPlanMode Tool
+ *
+ * Use this tool when you need to plan an implementation before writing code.
+ * This is recommended for:
+ * - New feature implementations
+ * - Tasks with multiple valid approaches
+ * - Architectural decisions
+ * - Multi-file changes
+ * - Unclear requirements
+ */
+export declare const enterPlanModeTool: Tool<EnterPlanModeInput>;
+export {};
+//# sourceMappingURL=enter-plan-mode.d.ts.map

package/dist/planning/tools/enter-plan-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enter-plan-mode.d.ts","sourceRoot":"","sources":["../../../src/planning/tools/enter-plan-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,sBAAsB,CAAC;AAS1E,QAAA,MAAM,wBAAwB,gCAAe,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,kBAAkB,CA6EtD,CAAC"}

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

@@ -0,0 +1,98 @@
+/**
+ * EnterPlanMode Tool
+ *
+ * Transitions the agent into plan mode for designing implementation
+ * approaches before writing code. In plan mode, only read-only tools
+ * are available.
+ */
+import { z } from 'zod';
+import { getPlanModeManager } from '../state.js';
+import { createPlanFile, getDisplayPath } from '../plan-file.js';
+import { PLAN_MODE_ALLOWED_TOOLS, PLAN_MODE_BLOCKED_TOOLS } from '../types.js';
+// ============================================================================
+// Tool Definition
+// ============================================================================
+const EnterPlanModeInputSchema = z.object({});
+/**
+ * EnterPlanMode Tool
+ *
+ * Use this tool when you need to plan an implementation before writing code.
+ * This is recommended for:
+ * - New feature implementations
+ * - Tasks with multiple valid approaches
+ * - Architectural decisions
+ * - Multi-file changes
+ * - Unclear requirements
+ */
+export const enterPlanModeTool = {
+    name: 'EnterPlanMode',
+    description: `Transition into plan mode to design an implementation approach before writing code.
+
+Use this tool when:
+- Implementing new features that require design decisions
+- Tasks with multiple valid approaches
+- Changes that affect existing behavior or structure
+- Architectural decisions between patterns or technologies
+- Multi-file changes (more than 2-3 files)
+- Unclear requirements that need exploration
+
+In plan mode:
+- Only read-only tools are available (Read, Glob, Grep, WebFetch, WebSearch, TodoWrite, AskUserQuestion)
+- Write, Edit, and Bash tools are blocked
+- You can explore the codebase and design an approach
+- Use ExitPlanMode when ready to request user approval
+
+This tool REQUIRES user approval before entering plan mode.`,
+    parameters: EnterPlanModeInputSchema,
+    async execute(_input, context) {
+        const manager = getPlanModeManager();
+        // Check if already in plan mode
+        if (manager.isActive()) {
+            return {
+                success: false,
+                output: '',
+                error: 'Already in plan mode. Use ExitPlanMode to exit first.',
+            };
+        }
+        try {
+            // Create plan file
+            const planFile = await createPlanFile(context.cwd);
+            const displayPath = getDisplayPath(planFile.path, context.cwd);
+            // Enter plan mode
+            manager.enter(planFile.path);
+            // Build response
+            const output = `
+Entered PLAN mode.
+
+Plan file: ${displayPath}
+
+In plan mode, you have access to read-only tools for exploration:
+${PLAN_MODE_ALLOWED_TOOLS.map((t) => `  - ${t}`).join('\n')}
+
+Blocked tools (write/execute operations):
+${PLAN_MODE_BLOCKED_TOOLS.map((t) => `  - ${t}`).join('\n')}
+
+Instructions:
+1. Explore the codebase using Read, Glob, Grep tools
+2. Research if needed using WebFetch, WebSearch
+3. Design your implementation approach
+4. Write your plan to the plan file using Write (plan file only)
+5. Call ExitPlanMode when ready for user approval
+
+Use Shift+Tab to toggle between Plan and Build modes.
+`.trim();
+            return {
+                success: true,
+                output,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: `Failed to enter plan mode: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=enter-plan-mode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enter-plan-mode.js","sourceRoot":"","sources":["../../../src/planning/tools/enter-plan-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE/E,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAI9C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA6B;IACzD,IAAI,EAAE,eAAe;IAErB,WAAW,EAAE;;;;;;;;;;;;;;;;4DAgB6C;IAE1D,UAAU,EAAE,wBAAwB;IAEpC,KAAK,CAAC,OAAO,CAAC,MAA0B,EAAE,OAAoB;QAC5D,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QAErC,gCAAgC;QAChC,IAAI,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,uDAAuD;aAC/D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,mBAAmB;YACnB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAE/D,kBAAkB;YAClB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAE7B,iBAAiB;YACjB,MAAM,MAAM,GAAG;;;aAGR,WAAW;;;EAGtB,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGzD,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;CAU1D,CAAC,IAAI,EAAE,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM;aACP,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC9F,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * ExitPlanMode Tool
+ *
+ * Exits plan mode and requests user approval for the implementation plan.
+ * Supports pre-approving permissions for bash commands needed during execution.
+ */
+import { z } from 'zod';
+import type { Tool } from '../../tools/types.js';
+declare const ExitPlanModeInputSchema: z.ZodObject<{
+    allowedPrompts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        tool: z.ZodLiteral<"Bash">;
+        prompt: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ExitPlanModeInput = z.infer<typeof ExitPlanModeInputSchema>;
+/**
+ * ExitPlanMode Tool
+ *
+ * Call this when you have finished writing your plan and are ready
+ * for user approval. The plan file should already be written.
+ */
+export declare const exitPlanModeTool: Tool<ExitPlanModeInput>;
+export {};
+//# sourceMappingURL=exit-plan-mode.d.ts.map

package/dist/planning/tools/exit-plan-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-plan-mode.d.ts","sourceRoot":"","sources":["../../../src/planning/tools/exit-plan-mode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,sBAAsB,CAAC;AAc1E,QAAA,MAAM,uBAAuB;;;;;iBAK3B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,IAAI,CAAC,iBAAiB,CAoIpD,CAAC"}

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

@@ -0,0 +1,149 @@
+/**
+ * ExitPlanMode Tool
+ *
+ * Exits plan mode and requests user approval for the implementation plan.
+ * Supports pre-approving permissions for bash commands needed during execution.
+ */
+import { z } from 'zod';
+import { getPlanModeManager } from '../state.js';
+import { readPlanFile, parseFilesToChange, parsePreApprovedPermissions, getDisplayPath } from '../plan-file.js';
+// ============================================================================
+// Tool Definition
+// ============================================================================
+const AllowedPromptSchema = z.object({
+    tool: z.literal('Bash').describe('The tool this permission applies to'),
+    prompt: z.string().describe('Semantic description of the action, e.g., "run tests", "install dependencies"'),
+});
+const ExitPlanModeInputSchema = z.object({
+    allowedPrompts: z
+        .array(AllowedPromptSchema)
+        .optional()
+        .describe('Prompt-based permissions needed to implement the plan'),
+});
+/**
+ * ExitPlanMode Tool
+ *
+ * Call this when you have finished writing your plan and are ready
+ * for user approval. The plan file should already be written.
+ */
+export const exitPlanModeTool = {
+    name: 'ExitPlanMode',
+    description: `Exit plan mode and request user approval for the implementation plan.
+
+## How This Tool Works
+- You should have already written your plan to the plan file
+- This tool reads the plan from the file you wrote
+- The user will see the plan contents and approve/modify/cancel
+
+## Requesting Permissions (allowedPrompts)
+Request prompt-based permissions for bash commands your plan will need:
+
+\`\`\`json
+{
+  "allowedPrompts": [
+    { "tool": "Bash", "prompt": "run tests" },
+    { "tool": "Bash", "prompt": "install dependencies" },
+    { "tool": "Bash", "prompt": "build the project" }
+  ]
+}
+\`\`\`
+
+Guidelines for prompts:
+- Use semantic descriptions that capture the action's purpose
+- "run tests" matches: npm test, pytest, go test, etc.
+- "install dependencies" matches: npm install, pip install, etc.
+- Keep descriptions concise but descriptive
+- Only request permissions you actually need
+- Scope permissions narrowly
+
+## When to Use This Tool
+Only use this tool when you have finished planning and are ready for approval.
+Do NOT use this tool for research tasks - only for implementation planning.`,
+    parameters: ExitPlanModeInputSchema,
+    async execute(input, context) {
+        const manager = getPlanModeManager();
+        // Check if in plan mode
+        if (!manager.isActive()) {
+            return {
+                success: false,
+                output: '',
+                error: 'Not in plan mode. Use EnterPlanMode first.',
+            };
+        }
+        const planFilePath = manager.getPlanFilePath();
+        if (!planFilePath) {
+            return {
+                success: false,
+                output: '',
+                error: 'No plan file found. This should not happen.',
+            };
+        }
+        try {
+            // Read plan file
+            const planFile = await readPlanFile(planFilePath);
+            if (!planFile) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `Could not read plan file: ${planFilePath}`,
+                };
+            }
+            // Parse plan content
+            const filesToChange = parseFilesToChange(planFile.content);
+            const planPermissions = parsePreApprovedPermissions(planFile.content);
+            // Combine with input permissions
+            const requestedPermissions = [
+                ...planPermissions,
+                ...(input.allowedPrompts || []),
+            ];
+            // Store permissions for approval UI
+            manager.setRequestedPermissions(requestedPermissions);
+            manager.setPhase('approval');
+            // Build response for the LLM
+            const displayPath = getDisplayPath(planFilePath, context.cwd);
+            let output = `
+Plan ready for approval.
+
+Plan file: ${displayPath}
+
+`;
+            // Summary of files to change
+            if (filesToChange.length > 0) {
+                output += 'Files to change:\n';
+                for (const file of filesToChange) {
+                    const icon = file.action === 'create' ? '+' : file.action === 'modify' ? '~' : '-';
+                    output += `  ${icon} ${file.path} (${file.action})\n`;
+                }
+                output += '\n';
+            }
+            // Requested permissions
+            if (requestedPermissions.length > 0) {
+                output += 'Requested permissions:\n';
+                for (const perm of requestedPermissions) {
+                    output += `  - ${perm.tool}(prompt: ${perm.prompt})\n`;
+                }
+                output += '\n';
+            }
+            output += `
+The user will now be prompted to:
+1. Approve - Accept plan and proceed with execution
+2. Modify - Go back and modify the plan
+3. Cancel - Exit plan mode without executing
+
+Waiting for user decision...
+`.trim();
+            return {
+                success: true,
+                output,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: '',
+                error: `Failed to exit plan mode: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=exit-plan-mode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exit-plan-mode.js","sourceRoot":"","sources":["../../../src/planning/tools/exit-plan-mode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGhH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACvE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;CAC7G,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,cAAc,EAAE,CAAC;SACd,KAAK,CAAC,mBAAmB,CAAC;SAC1B,QAAQ,EAAE;SACV,QAAQ,CAAC,uDAAuD,CAAC;CACrE,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA4B;IACvD,IAAI,EAAE,cAAc;IAEpB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EA8B6D;IAE1E,UAAU,EAAE,uBAAuB;IAEnC,KAAK,CAAC,OAAO,CAAC,KAAwB,EAAE,OAAoB;QAC1D,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QAErC,wBAAwB;QACxB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,4CAA4C;aACpD,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QAC/C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,6CAA6C;aACrD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,iBAAiB;YACjB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;YAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,6BAA6B,YAAY,EAAE;iBACnD,CAAC;YACJ,CAAC;YAED,qBAAqB;YACrB,MAAM,aAAa,GAAG,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3D,MAAM,eAAe,GAAG,2BAA2B,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAEtE,iCAAiC;YACjC,MAAM,oBAAoB,GAAoB;gBAC5C,GAAG,eAAe;gBAClB,GAAG,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC;aAChC,CAAC;YAEF,oCAAoC;YACpC,OAAO,CAAC,uBAAuB,CAAC,oBAAoB,CAAC,CAAC;YACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAE7B,6BAA6B;YAC7B,MAAM,WAAW,GAAG,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9D,IAAI,MAAM,GAAG;;;aAGN,WAAW;;CAEvB,CAAC;YAEI,6BAA6B;YAC7B,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,oBAAoB,CAAC;gBAC/B,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;oBACjC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;oBACnF,MAAM,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,KAAK,CAAC;gBACxD,CAAC;gBACD,MAAM,IAAI,IAAI,CAAC;YACjB,CAAC;YAED,wBAAwB;YACxB,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,0BAA0B,CAAC;gBACrC,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;oBACxC,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,MAAM,KAAK,CAAC;gBACzD,CAAC;gBACD,MAAM,IAAI,IAAI,CAAC;YACjB,CAAC;YAED,MAAM,IAAI;;;;;;;CAOf,CAAC,IAAI,EAAE,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM;aACP,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC7F,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}