gencode-ai 0.1.3 → 0.2.0

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":"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"}

package/dist/planning/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Plan Mode Type Definitions
+ *
+ * Types for Plan Mode - a read-only exploration mode that allows
+ * the LLM to plan implementations before executing changes.
+ */
+/**
+ * Plan mode phases following Claude Code's workflow
+ */
+export type PlanPhase = 'understanding' | 'design' | 'review' | 'final' | 'approval';
+/**
+ * User approval options for plan mode
+ */
+export type PlanApprovalOption = 'approve' | 'approve_clear' | 'approve_manual' | 'modify' | 'cancel';
+/**
+ * Pre-approved permission request (Claude Code ExitPlanMode style)
+ */
+export interface AllowedPrompt {
+    tool: 'Bash';
+    prompt: string;
+}
+/**
+ * Plan mode state
+ */
+export interface PlanModeState {
+    /** Whether plan mode is currently active */
+    active: boolean;
+    /** Current phase of planning */
+    phase: PlanPhase;
+    /** Path to the plan file */
+    planFilePath: string | null;
+    /** User's original request that triggered plan mode */
+    originalRequest: string | null;
+    /** Requested permissions for execution phase */
+    requestedPermissions: AllowedPrompt[];
+    /** Timestamp when plan mode was entered */
+    enteredAt: Date | null;
+}
+/**
+ * Plan file structure
+ */
+export interface PlanFile {
+    /** Plan file path */
+    path: string;
+    /** Plan content in markdown */
+    content: string;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last update timestamp */
+    updatedAt: Date;
+}
+/**
+ * Tools allowed in plan mode (read-only + planning tools)
+ */
+export declare const PLAN_MODE_ALLOWED_TOOLS: readonly ["Read", "Glob", "Grep", "WebFetch", "WebSearch", "TodoWrite", "AskUserQuestion", "EnterPlanMode", "ExitPlanMode"];
+/**
+ * Tools blocked in plan mode (write/execute operations)
+ */
+export declare const PLAN_MODE_BLOCKED_TOOLS: readonly ["Write", "Edit", "Bash"];
+export type PlanModeAllowedTool = (typeof PLAN_MODE_ALLOWED_TOOLS)[number];
+export type PlanModeBlockedTool = (typeof PLAN_MODE_BLOCKED_TOOLS)[number];
+/**
+ * Operating mode (cycle with Shift+Tab: normal → plan → accept → normal)
+ * - normal: Default mode, edits require confirmation
+ * - plan: Read-only exploration mode, edits blocked
+ * - accept: Auto-accept mode, edits approved without confirmation
+ */
+export type ModeType = 'normal' | 'plan' | 'accept';
+/**
+ * Plan approval UI state
+ */
+export interface PlanApprovalState {
+    /** Plan content for display */
+    planContent: string;
+    /** Summary of files to change */
+    filesToChange: Array<{
+        path: string;
+        action: 'create' | 'modify' | 'delete';
+    }>;
+    /** Requested permissions */
+    requestedPermissions: AllowedPrompt[];
+    /** Callback when user makes decision */
+    onDecision: (option: PlanApprovalOption) => void;
+}
+/**
+ * Plan mode events for UI updates
+ */
+export type PlanModeEvent = {
+    type: 'enter';
+    planFilePath: string;
+} | {
+    type: 'phase_change';
+    phase: PlanPhase;
+} | {
+    type: 'exit';
+    approved: boolean;
+} | {
+    type: 'toggle';
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/planning/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,eAAe,GACf,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,eAAe,GACf,gBAAgB,GAChB,QAAQ,GACR,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;IAEhB,gCAAgC;IAChC,KAAK,EAAE,SAAS,CAAC;IAEjB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,uDAAuD;IACvD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,gDAAgD;IAChD,oBAAoB,EAAE,aAAa,EAAE,CAAC;IAEtC,2CAA2C;IAC3C,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAEhB,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;CACjB;AAMD;;GAEG;AACH,eAAO,MAAM,uBAAuB,6HAU1B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uBAAuB,oCAAqC,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAM3E;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IAEpB,iCAAiC;IACjC,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;KACxC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,oBAAoB,EAAE,aAAa,EAAE,CAAC;IAEtC,wCAAwC;IACxC,UAAU,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAClD;AAMD;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC"}

package/dist/planning/types.js

@@ -0,0 +1,28 @@
+/**
+ * Plan Mode Type Definitions
+ *
+ * Types for Plan Mode - a read-only exploration mode that allows
+ * the LLM to plan implementations before executing changes.
+ */
+// ============================================================================
+// Tool Filtering Types
+// ============================================================================
+/**
+ * Tools allowed in plan mode (read-only + planning tools)
+ */
+export const PLAN_MODE_ALLOWED_TOOLS = [
+    'Read',
+    'Glob',
+    'Grep',
+    'WebFetch',
+    'WebSearch',
+    'TodoWrite',
+    'AskUserQuestion',
+    'EnterPlanMode', // Can re-enter if needed
+    'ExitPlanMode', // To exit plan mode
+];
+/**
+ * Tools blocked in plan mode (write/execute operations)
+ */
+export const PLAN_MODE_BLOCKED_TOOLS = ['Write', 'Edit', 'Bash'];
+//# sourceMappingURL=types.js.map

package/dist/planning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/planning/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0EH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM;IACN,MAAM;IACN,MAAM;IACN,UAAU;IACV,WAAW;IACX,WAAW;IACX,iBAAiB;IACjB,eAAe,EAAE,yBAAyB;IAC1C,cAAc,EAAE,oBAAoB;CAC5B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC"}

package/dist/pricing/calculator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cost calculation utilities
+ */
+import { CostEstimate, TokenUsage } from './types.js';
+/**
+ * Calculate cost from token usage
+ */
+export declare function calculateCost(provider: string, model: string, tokens: TokenUsage): CostEstimate;
+/**
+ * Format cost for display
+ */
+export declare function formatCost(cost: number): string;
+/**
+ * Format token count for display
+ */
+export declare function formatTokens(count: number): string;
+/**
+ * Format cost estimate for display
+ */
+export declare function formatCostEstimate(estimate: CostEstimate): string;
+//# sourceMappingURL=calculator.d.ts.map

package/dist/pricing/calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../src/pricing/calculator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,UAAU,GACjB,YAAY,CAuBd;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEjE"}

package/dist/pricing/calculator.js

@@ -0,0 +1,59 @@
+/**
+ * Cost calculation utilities
+ */
+import { getModelPricing } from './models.js';
+/**
+ * Calculate cost from token usage
+ */
+export function calculateCost(provider, model, tokens) {
+    const pricing = getModelPricing(provider, model);
+    // If no pricing found, return zero cost
+    if (!pricing) {
+        return {
+            inputCost: 0,
+            outputCost: 0,
+            totalCost: 0,
+            currency: 'USD',
+        };
+    }
+    // Calculate cost per token type
+    const inputCost = (tokens.inputTokens / 1_000_000) * pricing.inputPer1M;
+    const outputCost = (tokens.outputTokens / 1_000_000) * pricing.outputPer1M;
+    return {
+        inputCost,
+        outputCost,
+        totalCost: inputCost + outputCost,
+        currency: 'USD',
+    };
+}
+/**
+ * Format cost for display
+ */
+export function formatCost(cost) {
+    if (cost === 0) {
+        return '$0.00';
+    }
+    if (cost < 0.01) {
+        return '<$0.01';
+    }
+    return `$${cost.toFixed(2)}`;
+}
+/**
+ * Format token count for display
+ */
+export function formatTokens(count) {
+    if (count >= 1_000_000) {
+        return `${(count / 1_000_000).toFixed(1)}M`;
+    }
+    if (count >= 1_000) {
+        return `${(count / 1_000).toFixed(1)}K`;
+    }
+    return count.toString();
+}
+/**
+ * Format cost estimate for display
+ */
+export function formatCostEstimate(estimate) {
+    return formatCost(estimate.totalCost);
+}
+//# sourceMappingURL=calculator.js.map

package/dist/pricing/calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.js","sourceRoot":"","sources":["../../src/pricing/calculator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,KAAa,EACb,MAAkB;IAElB,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEjD,wCAAwC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAED,gCAAgC;IAChC,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IACxE,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAE3E,OAAO;QACL,SAAS;QACT,UAAU;QACV,SAAS,EAAE,SAAS,GAAG,UAAU;QACjC,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9C,CAAC;IACD,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAsB;IACvD,OAAO,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC"}

package/dist/pricing/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Pricing and cost tracking module
+ */
+export * from './types.js';
+export * from './models.js';
+export * from './calculator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pricing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pricing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/pricing/index.js

@@ -0,0 +1,7 @@
+/**
+ * Pricing and cost tracking module
+ */
+export * from './types.js';
+export * from './models.js';
+export * from './calculator.js';
+//# sourceMappingURL=index.js.map

package/dist/pricing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pricing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/pricing/models.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Model pricing database
+ * Prices are per 1M tokens in USD
+ * Updated: January 2025
+ */
+import { ModelPricing } from './types.js';
+/**
+ * Pricing data for all supported models
+ * Source: Official provider pricing pages as of January 2025
+ */
+export declare const MODEL_PRICING: ModelPricing[];
+/**
+ * Get pricing for a specific model
+ */
+export declare function getModelPricing(provider: string, model: string): ModelPricing | undefined;
+/**
+ * Get all pricing for a provider
+ */
+export declare function getProviderPricing(provider: string): ModelPricing[];
+//# sourceMappingURL=models.d.ts.map

package/dist/pricing/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/pricing/models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,YAAY,EA8SvC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,YAAY,GAAG,SAAS,CAI1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAEnE"}