@x-code-cli/core 0.1.11 → 0.2.1

package/dist/permissions/session-store.d.ts

@@ -0,0 +1,60 @@
+export interface AllowRule {
+    tool: string;
+    pattern: string;
+    type: 'exact' | 'prefix' | 'tool';
+}
+/**
+ * Extract a command prefix suitable for prefix-match rules.
+ * Returns `null` when no meaningful prefix can be derived.
+ *
+ *   'git commit -m "fix"'                          → 'git commit'
+ *   'pnpm run build'                               → 'pnpm run'
+ *   'npm install lodash'                           → 'npm install'
+ *   'NODE_ENV=prod npm run dev'                    → 'npm run'
+ *   'powershell -Command "Get-CimInstance ..."'    → 'Get-CimInstance'
+ *   'powershell -Command "git status"'             → 'git'
+ *   'ls -la'                                       → null
+ *   ''                                             → null
+ */
+export declare function extractCommandPrefix(command: string): string | null;
+/**
+ * Generate the display label for the "don't ask again" option.
+ * Returns `null` when no meaningful rule can be suggested — the UI
+ * should hide the "don't ask again" option entirely in that case.
+ *
+ * Shell with prefix: `git commit:*`
+ * Shell without prefix: null (no safe rule to suggest)
+ * Write tools (writeFile, edit): `all edits this session` (session-only)
+ */
+export declare function suggestRuleLabel(toolName: string, input: Record<string, unknown>): string | null;
+/**
+ * Build the AllowRule for a "don't ask again" approval.
+ * Returns `null` when no meaningful rule can be built (shell command
+ * without derivable prefix) — caller should not save a rule.
+ *
+ * - Shell with derivable prefix (e.g. `git commit`) → prefix rule
+ * - Shell without prefix → null (UI should not offer this option)
+ * - writeFile / edit → tool-wide allow (session-only, not persisted)
+ *
+ * `persist` indicates whether the rule should be saved to disk.
+ * Write tools return persist=false (session-only, matching Claude Code).
+ */
+export declare function buildAllowRule(toolName: string, input: Record<string, unknown>): {
+    rule: AllowRule;
+    persist: boolean;
+} | null;
+export declare function addSessionAllowRule(rule: AllowRule): void;
+export declare function sessionRulesMatch(toolName: string, input: Record<string, unknown>): boolean;
+export declare function clearSessionRules(): void;
+/**
+ * Load persisted permission rules from `.x-code/local/permissions.json`
+ * into the in-memory store. Safe to call multiple times (deduplicates).
+ * Silently no-ops if the file doesn't exist or is malformed.
+ */
+export declare function loadPersistedRules(cwd: string): void;
+/**
+ * Persist a new rule to `.x-code/local/permissions.json`.
+ * Creates the file if it doesn't exist. Appends without duplicating.
+ */
+export declare function persistRule(cwd: string, rule: AllowRule): void;
+//# sourceMappingURL=session-store.d.ts.map

package/dist/permissions/session-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/permissions/session-store.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;CAClC;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAQhG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAU7H;AA6ED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAEzD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAE3F;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAoBpD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAsB9D"}

package/dist/permissions/session-store.js

@@ -0,0 +1,233 @@
+// @x-code-cli/core — Permission memory with disk persistence.
+//
+// When a user approves a tool call with "don't ask again", the decision
+// is stored as an AllowRule both in-memory AND on disk at
+// `.x-code/local/permissions.json`. On next startup the persisted rules
+// are loaded so approvals survive across sessions.
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { XCODE_DIR } from '../utils.js';
+// Env-var assignment prefix: VAR=value (unquoted, safe chars only).
+const ENV_VAR_RE = /^[A-Za-z_]\w*=[A-Za-z0-9_./:@-]*\s+/;
+// Matches `powershell -Command "..."` or `powershell -c "..."` (case-insensitive).
+const POWERSHELL_CMD_RE = /^powershell(?:\.exe)?\s+(?:-(?:Command|c)\s+)?["']/i;
+// Extracts the first cmdlet or command name from inside quoted PowerShell.
+// Handles Verb-Noun cmdlets (Get-Process) and plain commands (git, npm).
+const PS_INNER_CMD_RE = /["']?\s*(?:&\s*)?([A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)+|[a-z][a-z0-9._-]*)/;
+/**
+ * Extract a command prefix suitable for prefix-match rules.
+ * Returns `null` when no meaningful prefix can be derived.
+ *
+ *   'git commit -m "fix"'                          → 'git commit'
+ *   'pnpm run build'                               → 'pnpm run'
+ *   'npm install lodash'                           → 'npm install'
+ *   'NODE_ENV=prod npm run dev'                    → 'npm run'
+ *   'powershell -Command "Get-CimInstance ..."'    → 'Get-CimInstance'
+ *   'powershell -Command "git status"'             → 'git'
+ *   'ls -la'                                       → null
+ *   ''                                             → null
+ */
+export function extractCommandPrefix(command) {
+    let cmd = command.trim();
+    while (ENV_VAR_RE.test(cmd)) {
+        cmd = cmd.replace(ENV_VAR_RE, '');
+    }
+    // Handle `powershell -Command "..."`: extract the inner cmdlet/command.
+    if (POWERSHELL_CMD_RE.test(cmd)) {
+        const quoteStart = cmd.indexOf('"') !== -1 ? cmd.indexOf('"') : cmd.indexOf("'");
+        if (quoteStart !== -1) {
+            const inner = cmd.slice(quoteStart);
+            const m = PS_INNER_CMD_RE.exec(inner);
+            if (m?.[1])
+                return m[1];
+        }
+        return null;
+    }
+    const tokens = cmd.split(/\s+/).filter(Boolean);
+    if (tokens.length < 2)
+        return null;
+    const second = tokens[1];
+    if (/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(second)) {
+        return `${tokens[0]} ${second}`;
+    }
+    return null;
+}
+/**
+ * Generate the display label for the "don't ask again" option.
+ * Returns `null` when no meaningful rule can be suggested — the UI
+ * should hide the "don't ask again" option entirely in that case.
+ *
+ * Shell with prefix: `git commit:*`
+ * Shell without prefix: null (no safe rule to suggest)
+ * Write tools (writeFile, edit): `all edits this session` (session-only)
+ */
+export function suggestRuleLabel(toolName, input) {
+    if (toolName === 'shell') {
+        const cmd = input.command ?? '';
+        const prefix = extractCommandPrefix(cmd);
+        if (prefix)
+            return `${prefix}:*`;
+        return null;
+    }
+    return 'all edits this session';
+}
+/**
+ * Build the AllowRule for a "don't ask again" approval.
+ * Returns `null` when no meaningful rule can be built (shell command
+ * without derivable prefix) — caller should not save a rule.
+ *
+ * - Shell with derivable prefix (e.g. `git commit`) → prefix rule
+ * - Shell without prefix → null (UI should not offer this option)
+ * - writeFile / edit → tool-wide allow (session-only, not persisted)
+ *
+ * `persist` indicates whether the rule should be saved to disk.
+ * Write tools return persist=false (session-only, matching Claude Code).
+ */
+export function buildAllowRule(toolName, input) {
+    if (toolName === 'shell') {
+        const cmd = input.command ?? '';
+        const prefix = extractCommandPrefix(cmd);
+        if (prefix) {
+            return { rule: { tool: toolName, pattern: prefix, type: 'prefix' }, persist: true };
+        }
+        return null;
+    }
+    return { rule: { tool: toolName, pattern: '*', type: 'tool' }, persist: false };
+}
+function stripEnvVars(command) {
+    let cmd = command.trim();
+    while (ENV_VAR_RE.test(cmd)) {
+        cmd = cmd.replace(ENV_VAR_RE, '');
+    }
+    return cmd.trim();
+}
+// ─── Serialization helpers ───
+function ruleToString(rule) {
+    if (rule.type === 'tool')
+        return `${rule.tool}:*`;
+    if (rule.type === 'prefix')
+        return `${rule.tool}:${rule.pattern}:*`;
+    return `${rule.tool}:=${rule.pattern}`;
+}
+function parseRuleString(s) {
+    // tool:*  → tool-wide
+    const toolWide = s.match(/^([^:]+):\*$/);
+    if (toolWide)
+        return { tool: toolWide[1], pattern: '*', type: 'tool' };
+    // tool:prefix:*  → prefix match
+    const prefix = s.match(/^([^:]+):(.+):\*$/);
+    if (prefix)
+        return { tool: prefix[1], pattern: prefix[2], type: 'prefix' };
+    // tool:=exact  → exact match
+    const exact = s.match(/^([^:]+):=(.+)$/);
+    if (exact)
+        return { tool: exact[1], pattern: exact[2], type: 'exact' };
+    return null;
+}
+function getPermissionsPath(cwd) {
+    return path.join(cwd, XCODE_DIR, 'local', 'permissions.json');
+}
+// ─── Store ───
+class SessionPermissionStore {
+    rules = [];
+    addRule(rule) {
+        const exists = this.rules.some((r) => r.tool === rule.tool && r.pattern === rule.pattern && r.type === rule.type);
+        if (!exists)
+            this.rules.push(rule);
+    }
+    matches(toolName, input) {
+        for (const rule of this.rules) {
+            if (rule.tool !== toolName)
+                continue;
+            if (rule.type === 'tool')
+                return true;
+            if (toolName === 'shell') {
+                const cmd = input.command ?? '';
+                const prefix = extractCommandPrefix(cmd);
+                if (rule.type === 'exact' && stripEnvVars(cmd) === rule.pattern)
+                    return true;
+                if (rule.type === 'prefix' && prefix) {
+                    if (prefix === rule.pattern)
+                        return true;
+                    if (prefix.startsWith(rule.pattern + ' '))
+                        return true;
+                }
+            }
+        }
+        return false;
+    }
+    clear() {
+        this.rules = [];
+    }
+    get size() {
+        return this.rules.length;
+    }
+}
+const store = new SessionPermissionStore();
+export function addSessionAllowRule(rule) {
+    store.addRule(rule);
+}
+export function sessionRulesMatch(toolName, input) {
+    return store.matches(toolName, input);
+}
+export function clearSessionRules() {
+    store.clear();
+}
+// ─── Disk persistence ───
+/**
+ * Load persisted permission rules from `.x-code/local/permissions.json`
+ * into the in-memory store. Safe to call multiple times (deduplicates).
+ * Silently no-ops if the file doesn't exist or is malformed.
+ */
+export function loadPersistedRules(cwd) {
+    const filePath = getPermissionsPath(cwd);
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    if (!Array.isArray(data.allow))
+        return;
+    for (const entry of data.allow) {
+        if (typeof entry !== 'string')
+            continue;
+        const rule = parseRuleString(entry);
+        if (rule)
+            store.addRule(rule);
+    }
+}
+/**
+ * Persist a new rule to `.x-code/local/permissions.json`.
+ * Creates the file if it doesn't exist. Appends without duplicating.
+ */
+export function persistRule(cwd, rule) {
+    const filePath = getPermissionsPath(cwd);
+    const ruleStr = ruleToString(rule);
+    let data = { allow: [] };
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed.allow)) {
+            data.allow = parsed.allow.filter((s) => typeof s === 'string');
+        }
+    }
+    catch {
+        // File doesn't exist or is malformed — start fresh.
+    }
+    if (data.allow.includes(ruleStr))
+        return;
+    data.allow.push(ruleStr);
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+//# sourceMappingURL=session-store.js.map

package/dist/permissions/session-store.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO;;;;;;SAiBlB,CAAA"}
+{"version":3,"file":"ask-user.d.ts","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO;;;;;;SAqBlB,CAAA"}

package/dist/tools/ask-user.js

@@ -2,17 +2,19 @@
 import { tool } from 'ai';
 import { z } from 'zod';
 export const askUser = tool({
-    description: 'Ask the user a clarifying question with multiple-choice options. Use when you need user input to decide between approaches.',
+    description: 'Ask the user a clarifying question with multiple-choice options. Use when you need user input to decide between approaches. In **plan mode** this is also the primary "interview" tool — call it after every meaningful analysis or exploration to hand decision points back to the user with concrete next-step choices.',
     inputSchema: z.object({
-        question: z.string().describe('The question to ask'),
+        question: z.string().describe('The question to ask. Markdown is rendered.'),
         options: z
             .array(z.object({
-            label: z.string().describe('Option label (1-5 words)'),
-            description: z.string().describe('What this option means'),
+            label: z.string().describe('Option label (1-8 words). Shown as the choice itself.'),
+            description: z
+                .string()
+                .describe('One-line tradeoff or scope hint shown beneath the label.'),
         }))
             .min(2)
-            .max(4)
-            .describe('Choices (an "Other" option is auto-appended)'),
+            .max(6)
+            .describe('Choices. DO NOT include an "Other"/freeform/custom-input option — the UI auto-appends one as the last row, so adding your own creates a duplicate. 2-6 entries — for plan-mode interview menus 4-6 entries with both action options ("plan high-priority items") and meta options ("just discuss further") work best.'),
     }),
     // No execute — through callback to trigger UI rendering
 });

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

@@ -1 +1 @@
-{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC;IAC1B,WAAW,EACT,6HAA6H;IAC/H,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QACpD,OAAO,EAAE,CAAC;aACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACtD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SAC3D,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,8CAA8C,CAAC;KAC5D,CAAC;IACF,wDAAwD;CACzD,CAAC,CAAA"}
+{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../src/tools/ask-user.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC;IAC1B,WAAW,EACT,2TAA2T;IAC7T,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QAC3E,OAAO,EAAE,CAAC;aACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;YACnF,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,0DAA0D,CAAC;SACxE,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,uTAAuT,CACxT;KACJ,CAAC;IACF,wDAAwD;CACzD,CAAC,CAAA"}

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

@@ -0,0 +1,25 @@
+/** The tool description below is the heart of plan-mode auto-trigger
+ *  behavior — it's what the model reads in the tool list and uses to
+ *  decide whether to recommend plan mode. Ported (with naming
+ *  adjustments for our tool surface) from Claude Code's
+ *  `EnterPlanModeTool/prompt.ts` external-user prompt
+ *  (`/d/res/claude-code/src/tools/EnterPlanModeTool/prompt.ts:16-99`).
+ *
+ *  WHY THIS IS LONG: a one-line description ("use for complex tasks")
+ *  produces a model that almost never calls the tool — it has no
+ *  concrete trigger pattern to match against the user's request. CC's
+ *  prompt deliberately includes 7 numbered criteria, multiple worked
+ *  examples per criterion, and an explicit "PREFER plan mode unless
+ *  simple" anchor — that's what gets the model to actually recommend
+ *  plan mode for refactors, new features, architectural decisions,
+ *  etc. The token cost (~600 tokens in tool list each turn) is what
+ *  buys the auto-trigger behavior; without it plan mode is dead UX.
+ *
+ *  No `execute` field — the side-effect (asking the user to confirm,
+ *  mutating LoopState.permissionMode, invalidating the system-prompt
+ *  cache) is handled manually in `processToolCalls`. Same pattern as
+ *  `askUser`. */
+export declare const enterPlanMode: import("ai").Tool<{
+    topic?: string | undefined;
+}, never>;
+//# sourceMappingURL=enter-plan-mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enter-plan-mode.d.ts","sourceRoot":"","sources":["../../src/tools/enter-plan-mode.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;iBAoBiB;AACjB,eAAO,MAAM,aAAa;;SAgGxB,CAAA"}

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

@@ -0,0 +1,120 @@
+// @x-code-cli/core — enterPlanMode tool (mode switch, no execute — handled in agent loop)
+import { tool } from 'ai';
+import { z } from 'zod';
+/** The tool description below is the heart of plan-mode auto-trigger
+ *  behavior — it's what the model reads in the tool list and uses to
+ *  decide whether to recommend plan mode. Ported (with naming
+ *  adjustments for our tool surface) from Claude Code's
+ *  `EnterPlanModeTool/prompt.ts` external-user prompt
+ *  (`/d/res/claude-code/src/tools/EnterPlanModeTool/prompt.ts:16-99`).
+ *
+ *  WHY THIS IS LONG: a one-line description ("use for complex tasks")
+ *  produces a model that almost never calls the tool — it has no
+ *  concrete trigger pattern to match against the user's request. CC's
+ *  prompt deliberately includes 7 numbered criteria, multiple worked
+ *  examples per criterion, and an explicit "PREFER plan mode unless
+ *  simple" anchor — that's what gets the model to actually recommend
+ *  plan mode for refactors, new features, architectural decisions,
+ *  etc. The token cost (~600 tokens in tool list each turn) is what
+ *  buys the auto-trigger behavior; without it plan mode is dead UX.
+ *
+ *  No `execute` field — the side-effect (asking the user to confirm,
+ *  mutating LoopState.permissionMode, invalidating the system-prompt
+ *  cache) is handled manually in `processToolCalls`. Same pattern as
+ *  `askUser`. */
+export const enterPlanMode = tool({
+    description: `Use this tool proactively when you're about to start a non-trivial implementation task. Getting user sign-off on your approach before writing code prevents wasted effort and ensures alignment. This tool transitions you into plan mode where you can explore the codebase and design an implementation approach for user approval.
+
+## When to Use This Tool
+
+**Prefer using enterPlanMode** for implementation tasks unless they're simple. Use it when ANY of these conditions apply:
+
+1. **New Feature Implementation**: Adding meaningful new functionality
+   - Example: "Add a logout button" - where should it go? What should happen on click?
+   - Example: "Add form validation" - what rules? What error messages?
+
+2. **Multiple Valid Approaches**: The task can be solved in several different ways
+   - Example: "Add caching to the API" - could use Redis, in-memory, file-based, etc.
+   - Example: "Improve performance" - many optimization strategies possible
+
+3. **Code Modifications**: Changes that affect existing behavior or structure
+   - Example: "Update the login flow" - what exactly should change?
+   - Example: "Refactor this component" - what's the target architecture?
+
+4. **Architectural Decisions**: The task requires choosing between patterns or technologies
+   - Example: "Add real-time updates" - WebSockets vs SSE vs polling
+   - Example: "Implement state management" - Redux vs Context vs custom solution
+
+5. **Multi-File Changes**: The task will likely touch more than 2-3 files
+   - Example: "Refactor the authentication system"
+   - Example: "Add a new API endpoint with tests"
+
+6. **Unclear Requirements**: You need to explore before understanding the full scope
+   - Example: "Make the app faster" - need to profile and identify bottlenecks
+   - Example: "Fix the bug in checkout" - need to investigate root cause
+
+7. **User Preferences Matter**: The implementation could reasonably go multiple ways
+   - If you would use askUser to clarify the approach, use enterPlanMode instead
+   - Plan mode lets you explore first, then present options with context
+
+## When NOT to Use This Tool
+
+Only skip enterPlanMode for simple tasks:
+- Single-line or few-line fixes (typos, obvious bugs, small tweaks)
+- Adding a single function with clear requirements
+- Tasks where the user has given very specific, detailed instructions
+- Pure research / "what does X do" questions — just answer them directly
+
+## What Happens in Plan Mode
+
+In plan mode, you'll:
+1. Thoroughly explore the codebase using readFile, glob, grep, and listDir
+2. Understand existing patterns and architecture
+3. Design an implementation approach
+4. Use askUser to clarify approaches with the user when needed
+5. Write the plan incrementally to a session-scoped plan file
+6. Exit plan mode with exitPlanMode when ready to implement
+
+## Examples
+
+### GOOD - Use enterPlanMode:
+User: "Add user authentication to the app"
+- Requires architectural decisions (session vs JWT, where to store tokens, middleware structure)
+
+User: "Optimize the database queries"
+- Multiple approaches possible, need to profile first, significant impact
+
+User: "Implement dark mode"
+- Architectural decision on theme system, affects many components
+
+User: "Add a delete button to the user profile"
+- Seems simple but involves: where to place it, confirmation dialog, API call, error handling, state updates
+
+User: "Update the error handling in the API"
+- Affects multiple files, user should approve the approach
+
+### BAD - Don't use enterPlanMode:
+User: "Fix the typo in the README"
+- Straightforward, no planning needed
+
+User: "Add a console.log to debug this function"
+- Simple, obvious implementation
+
+User: "What files handle routing?"
+- Research / Q&A task, not implementation — just answer
+
+## Important Notes
+
+- This tool REQUIRES user approval — they must consent to entering plan mode (an approval dialog appears).
+- If unsure whether to use it, err on the side of planning — it's better to get alignment upfront than to redo work.
+- Do not call enterPlanMode if you are already in plan mode (check the system prompt; if you see plan-mode instructions you are already in it).`,
+    inputSchema: z.object({
+        topic: z
+            .string()
+            .min(1)
+            .max(60)
+            .optional()
+            .describe('STRONGLY RECOMMENDED. A 3-5 word English filename slug summarizing the user\'s task. Lowercase, hyphen-separated, no spaces or special chars. The plan file is named `<topic>-<YYYYMMDD-HHMMSS>.md` so this makes the file identifiable in `ls .x-code/plans/`. Translate non-English requests into English keywords (e.g. user asks "重构这个项目" → topic: "refactor-x-code-cli"; user asks "加 OAuth 登录" → topic: "add-oauth-login"). Omit only when you genuinely cannot summarize — the file then falls back to timestamp-only naming.'),
+    }),
+});
+//# sourceMappingURL=enter-plan-mode.js.map

package/dist/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":"AAAA,0FAA0F;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;;;;;;iBAoBiB;AACjB,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gJAoFiI;IAC9I,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,QAAQ,EAAE;aACV,QAAQ,CACP,sgBAAsgB,CACvgB;KACJ,CAAC;CACH,CAAC,CAAA"}

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

@@ -0,0 +1,13 @@
+/** Present the plan to the user for approval. The user sees a Yes/No
+ *  dialog with the plan body inline; on Yes, the session leaves plan mode
+ *  and the next turn can write code; on No, the session stays in plan
+ *  mode and the model is told to revise.
+ *
+ *  No `execute` field — the dispatch path in `processToolCalls` reads the
+ *  plan file, calls `callbacks.onPlanApprovalRequest(planText)`, and
+ *  feeds the verdict back as a synthetic tool result so the model knows
+ *  whether to proceed or iterate. */
+export declare const exitPlanMode: import("ai").Tool<{
+    plan?: string | undefined;
+}, never>;
+//# sourceMappingURL=exit-plan-mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exit-plan-mode.d.ts","sourceRoot":"","sources":["../../src/tools/exit-plan-mode.ts"],"names":[],"mappings":"AAKA;;;;;;;;qCAQqC;AACrC,eAAO,MAAM,YAAY;;SAWvB,CAAA"}

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

@@ -0,0 +1,22 @@
+// @x-code-cli/core — exitPlanMode tool (user-approval gate, no execute — handled in agent loop)
+import { tool } from 'ai';
+import { z } from 'zod';
+/** Present the plan to the user for approval. The user sees a Yes/No
+ *  dialog with the plan body inline; on Yes, the session leaves plan mode
+ *  and the next turn can write code; on No, the session stays in plan
+ *  mode and the model is told to revise.
+ *
+ *  No `execute` field — the dispatch path in `processToolCalls` reads the
+ *  plan file, calls `callbacks.onPlanApprovalRequest(planText)`, and
+ *  feeds the verdict back as a synthetic tool result so the model knows
+ *  whether to proceed or iterate. */
+export const exitPlanMode = tool({
+    description: 'Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval. This tool reads the plan from the file you wrote during planning — pass an optional `plan` parameter only if you want to override what is in the file. The user sees the plan content in an approval dialog and chooses Yes/No. The model cannot leave plan mode without user approval; if rejected, revise the plan file (using edit) and call this again. Do NOT use this for research / Q&A — only when the user has asked you to implement something and you have a complete plan written to the plan file. Do NOT use askUser to ask "is this plan okay?" — exitPlanMode is the only correct way to request plan approval.',
+    inputSchema: z.object({
+        plan: z
+            .string()
+            .optional()
+            .describe('Optional override for the plan body. By default the plan body comes from the plan file you wrote during planning — only pass this argument if you want to use different content (rare).'),
+    }),
+});
+//# sourceMappingURL=exit-plan-mode.js.map

package/dist/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":"AAAA,gGAAgG;AAChG,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAEzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;qCAQqC;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;IAC/B,WAAW,EACT,+tBAA+tB;IACjuB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,yLAAyL,CAC1L;KACJ,CAAC;CACH,CAAC,CAAA"}

package/dist/tools/grep.d.ts

@@ -1,7 +1,7 @@
 export declare const grep: import("ai").Tool<{
     pattern: string;
-    path?: string | undefined;
     glob?: string | undefined;
+    path?: string | undefined;
     maxResults?: number | undefined;
 }, string>;
 //# sourceMappingURL=grep.d.ts.map

package/dist/tools/index.d.ts

@@ -1,11 +1,14 @@
 import { askUser } from './ask-user.js';
 import { edit } from './edit.js';
+import { enterPlanMode } from './enter-plan-mode.js';
+import { exitPlanMode } from './exit-plan-mode.js';
 import { glob } from './glob.js';
 import { grep } from './grep.js';
 import { listDir } from './list-dir.js';
 import { readFile } from './read-file.js';
 import { saveKnowledge } from './save-knowledge.js';
 import { shell } from './shell.js';
+import { todoWrite } from './todo-write.js';
 import { webFetch } from './web-fetch.js';
 import { webSearch } from './web-search.js';
 import { writeFile } from './write-file.js';
@@ -63,8 +66,8 @@ export declare const toolRegistry: {
     }, string>;
     grep: import("ai").Tool<{
         pattern: string;
-        path?: string | undefined;
         glob?: string | undefined;
+        path?: string | undefined;
         maxResults?: number | undefined;
     }, string>;
     listDir: import("ai").Tool<{
@@ -86,14 +89,27 @@ export declare const toolRegistry: {
         question: string;
     }, never>;
     saveKnowledge: import("ai").Tool<{
-        category: "user" | "feedback" | "project" | "reference";
+        category: "project" | "user" | "feedback" | "reference";
         action: "add" | "delete";
         key: string;
         fact: string;
-        scope: "project" | "global";
+        scope: "global" | "project";
     }, string>;
+    enterPlanMode: import("ai").Tool<{
+        topic?: string | undefined;
+    }, never>;
+    exitPlanMode: import("ai").Tool<{
+        plan?: string | undefined;
+    }, never>;
+    todoWrite: import("ai").Tool<{
+        todos: {
+            content?: string | undefined;
+            status?: "pending" | "in_progress" | "completed" | undefined;
+            activeForm?: string | undefined;
+        }[];
+    }, never>;
 };
-export { readFile, writeFile, edit, shell, glob, grep, listDir, webSearch, webFetch, askUser, saveKnowledge, };
+export { readFile, writeFile, edit, shell, glob, grep, listDir, webSearch, webFetch, askUser, saveKnowledge, enterPlanMode, exitPlanMode, todoWrite, };
 export { MAX_TOOL_RESULT_LINES, MAX_TOOL_RESULT_BYTES, MAX_AGGREGATE_TOOL_RESULT_BYTES, truncateToolResult, } from './truncate.js';
 export type { TruncateOptions } from './truncate.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYxB,CAAA;AAED,OAAO,EACL,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa,GACd,CAAA;AAED,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAexB,CAAA;AAED,OAAO,EACL,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,GACV,CAAA;AAED,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}