whale-code 6.5.5 → 6.5.7

package/dist/cli/services/interactive-tools.js

@@ -4,220 +4,269 @@
  * - AskUserQuestion: Multi-choice questions with optional custom input
  * - Plan Mode: Structured planning workflow with user approval
  */
+
 import { EventEmitter } from "events";
 import { readFileSync, existsSync } from "fs";
 import { resolve } from "path";
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
 // ============================================================================
 // GLOBAL STATE
 // ============================================================================
+
 // Pending question requests (resolved by UI)
 const pendingQuestions = new Map();
+
 // Plan mode state
-let planModeState = { active: false };
+let planModeState = {
+  active: false
+};
+
 // Plan approval state — blocks exit_plan_mode until UI resolves
-let pendingPlanApproval = null;
+// Separated into data (what to show) and promise (what to resolve).
+// This prevents the race where resolvePlanApproval fires before
+// waitForPlanApproval creates the promise.
+let pendingPlanData = null;
+let pendingPlanResolve = null;
+
 // Event emitter for UI coordination
 export const interactiveEvents = new EventEmitter();
+
 // ============================================================================
 // ASK USER QUESTION
 // ============================================================================
+
 export function createQuestionRequest(questions) {
-    const id = `question-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
-    return new Promise((resolve, reject) => {
-        const request = {
-            id,
-            questions,
-            resolve,
-            reject,
-        };
-        pendingQuestions.set(id, request);
-        // Emit event for UI to pick up
-        interactiveEvents.emit("question", request);
-    });
+  const id = `question-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+  let requestRef;
+  const promise = new Promise((resolve, reject) => {
+    requestRef = {
+      id,
+      questions,
+      resolve,
+      reject
+    };
+    pendingQuestions.set(id, requestRef);
+    interactiveEvents.emit("question", requestRef);
+  });
+  return {
+    request: requestRef,
+    promise
+  };
 }
 export function getPendingQuestion() {
-    // Return first pending question
-    return pendingQuestions.values().next().value;
+  // Return first pending question
+  return pendingQuestions.values().next().value;
 }
 export function resolveQuestion(id, answers) {
-    const request = pendingQuestions.get(id);
-    if (!request)
-        return false;
-    pendingQuestions.delete(id);
-    request.resolve(answers);
-    return true;
+  const request = pendingQuestions.get(id);
+  if (!request) return false;
+  pendingQuestions.delete(id);
+  request.resolve(answers);
+  return true;
 }
 export function rejectQuestion(id, error) {
-    const request = pendingQuestions.get(id);
-    if (!request)
-        return false;
-    pendingQuestions.delete(id);
-    request.reject(error);
-    return true;
+  const request = pendingQuestions.get(id);
+  if (!request) return false;
+  pendingQuestions.delete(id);
+  request.reject(error);
+  return true;
 }
+
 // ============================================================================
 // PLAN MODE
 // ============================================================================
+
 export function enterPlanMode(planFile) {
-    if (planModeState.active) {
-        return {
-            success: false,
-            message: "Already in plan mode. Use ExitPlanMode to finish planning.",
-        };
-    }
-    planModeState = {
-        active: true,
-        planFile: planFile || ".whale/plan.md",
-        startedAt: new Date(),
-    };
-    interactiveEvents.emit("planModeEntered", planModeState);
+  if (planModeState.active) {
     return {
-        success: true,
-        message: `Entered plan mode. Write your plan to ${planModeState.planFile}, then use ExitPlanMode when ready for approval.`,
+      success: false,
+      message: "Already in plan mode. Use ExitPlanMode to finish planning."
     };
+  }
+  planModeState = {
+    active: true,
+    planFile: planFile || ".whale/plan.md",
+    startedAt: new Date()
+  };
+  interactiveEvents.emit("planModeEntered", planModeState);
+  return {
+    success: true,
+    message: `Entered plan mode. Write your plan to ${planModeState.planFile}, then use ExitPlanMode when ready for approval.`
+  };
 }
 export function exitPlanMode() {
-    if (!planModeState.active) {
-        return {
-            success: false,
-            message: "Not in plan mode. Use EnterPlanMode first.",
-        };
-    }
-    const planFile = planModeState.planFile || ".whale/plan.md";
-    planModeState = { active: false };
-    // Read the plan file content
-    const fullPath = resolve(process.cwd(), planFile);
-    let planContent = "";
-    if (existsSync(fullPath)) {
-        try {
-            planContent = readFileSync(fullPath, "utf-8").trim();
-        }
-        catch { /* ignore read errors */ }
-    }
-    // Emit event for UI to show approval overlay
-    interactiveEvents.emit("planModeExited", { planFile, planContent });
-    // Set up pending approval state so UI can resolve it via resolvePlanApproval()
-    pendingPlanApproval = {
-        resolve: () => { },
-        reject: () => { },
-        planContent,
-        planFile,
+  if (!planModeState.active) {
+    return {
+      success: false,
+      message: "Not in plan mode. Use EnterPlanMode first."
     };
-    if (planContent) {
-        return {
-            success: true,
-            message: planContent,
-        };
-    }
+  }
+  const planFile = planModeState.planFile || ".whale/plan.md";
+  planModeState = {
+    active: false
+  };
+
+  // Read the plan file content
+  const fullPath = resolve(process.cwd(), planFile);
+  let planContent = "";
+  if (existsSync(fullPath)) {
+    try {
+      planContent = readFileSync(fullPath, "utf-8").trim();
+    } catch {/* ignore read errors */}
+  }
+
+  // Emit event for UI to show approval overlay
+  interactiveEvents.emit("planModeExited", {
+    planFile,
+    planContent
+  });
+
+  // Store plan data for the UI and waitForPlanApproval().
+  // Promise handlers are created in waitForPlanApproval() — not here.
+  pendingPlanData = {
+    planContent,
+    planFile
+  };
+  pendingPlanResolve = null;
+  if (planContent) {
     return {
-        success: true,
-        message: `Plan mode complete. Plan saved to ${planFile}.`,
+      success: true,
+      message: planContent
     };
+  }
+  return {
+    success: true,
+    message: `Plan mode complete. Plan saved to ${planFile}.`
+  };
 }
+
 /**
  * Wait for user to approve/reject the plan via the UI overlay.
  * Called by the agent loop after exitPlanMode() returns.
  */
-export async function waitForPlanApproval() {
-    if (!pendingPlanApproval) {
-        return { action: "execute" };
+export async function waitForPlanApproval(abortSignal) {
+  if (!pendingPlanData) {
+    return {
+      action: "execute"
+    };
+  }
+  if (abortSignal?.aborted) {
+    pendingPlanData = null;
+    pendingPlanResolve = null;
+    return {
+      action: "cancel"
+    };
+  }
+  const decision = await new Promise(resolvePromise => {
+    pendingPlanResolve = resolvePromise;
+    if (abortSignal) {
+      const onAbort = () => {
+        pendingPlanData = null;
+        pendingPlanResolve = null;
+        resolvePromise({
+          action: "cancel"
+        });
+      };
+      abortSignal.addEventListener("abort", onAbort, {
+        once: true
+      });
     }
-    const { planContent, planFile } = pendingPlanApproval;
-    const decision = await new Promise((resolvePromise, rejectPromise) => {
-        pendingPlanApproval = {
-            resolve: resolvePromise,
-            reject: rejectPromise,
-            planContent,
-            planFile,
-        };
-    });
-    return decision;
+  });
+  return decision;
 }
 export function isPlanMode() {
-    return planModeState.active;
+  return planModeState.active;
 }
 export function getPlanModeState() {
-    return { ...planModeState };
+  return {
+    ...planModeState
+  };
 }
+
 // ============================================================================
 // PLAN APPROVAL — blocking resolution from UI
 // ============================================================================
+
 export function getPendingPlanApproval() {
-    if (!pendingPlanApproval)
-        return null;
-    return { planContent: pendingPlanApproval.planContent, planFile: pendingPlanApproval.planFile };
+  return pendingPlanData ? {
+    ...pendingPlanData
+  } : null;
 }
 export function resolvePlanApproval(decision) {
-    if (!pendingPlanApproval)
-        return false;
-    const { resolve } = pendingPlanApproval;
-    pendingPlanApproval = null;
-    resolve(decision);
-    return true;
+  if (!pendingPlanResolve) return false;
+  const resolve = pendingPlanResolve;
+  pendingPlanData = null;
+  pendingPlanResolve = null;
+  resolve(decision);
+  return true;
 }
+
 // ============================================================================
 // TOOL DEFINITIONS
 // ============================================================================
-export const INTERACTIVE_TOOL_DEFINITIONS = [
-    {
-        name: "ask_user_question",
-        description: `Ask the user questions during execution. Use this to:
+
+export const INTERACTIVE_TOOL_DEFINITIONS = [{
+  name: "ask_user_question",
+  description: `Ask the user questions during execution. Use this to:
 - Gather user preferences or requirements
 - Clarify ambiguous instructions
 - Get decisions on implementation choices
 - Offer choices about direction
 
 Users can always select "Other" to provide custom input.`,
-        input_schema: {
-            type: "object",
-            properties: {
-                questions: {
-                    type: "array",
-                    description: "1-4 questions to ask the user",
-                    items: {
-                        type: "object",
-                        properties: {
-                            question: {
-                                type: "string",
-                                description: "The complete question to ask (ends with ?)",
-                            },
-                            header: {
-                                type: "string",
-                                description: "Short label (max 12 chars) like 'Auth method' or 'Library'",
-                            },
-                            options: {
-                                type: "array",
-                                description: "2-4 choices (Other is added automatically)",
-                                items: {
-                                    type: "object",
-                                    properties: {
-                                        label: {
-                                            type: "string",
-                                            description: "Concise choice text (1-5 words)",
-                                        },
-                                        description: {
-                                            type: "string",
-                                            description: "Explanation of what this choice means",
-                                        },
-                                    },
-                                    required: ["label", "description"],
-                                },
-                            },
-                            multiSelect: {
-                                type: "boolean",
-                                description: "Allow selecting multiple options (default: false)",
-                            },
-                        },
-                        required: ["question", "header", "options"],
-                    },
+  input_schema: {
+    type: "object",
+    properties: {
+      questions: {
+        type: "array",
+        description: "1-4 questions to ask the user",
+        items: {
+          type: "object",
+          properties: {
+            question: {
+              type: "string",
+              description: "The complete question to ask (ends with ?)"
+            },
+            header: {
+              type: "string",
+              description: "Short label (max 12 chars) like 'Auth method' or 'Library'"
+            },
+            options: {
+              type: "array",
+              description: "2-4 choices (Other is added automatically)",
+              items: {
+                type: "object",
+                properties: {
+                  label: {
+                    type: "string",
+                    description: "Concise choice text (1-5 words)"
+                  },
+                  description: {
+                    type: "string",
+                    description: "Explanation of what this choice means"
+                  }
                 },
+                required: ["label", "description"]
+              }
             },
-            required: ["questions"],
-        },
+            multiSelect: {
+              type: "boolean",
+              description: "Allow selecting multiple options (default: false)"
+            }
+          },
+          required: ["question", "header", "options"]
+        }
+      }
     },
-    {
-        name: "enter_plan_mode",
-        description: `Enter plan mode for complex tasks requiring careful planning before implementation.
+    required: ["questions"]
+  }
+}, {
+  name: "enter_plan_mode",
+  description: `Enter plan mode for complex tasks requiring careful planning before implementation.
 
 Use this when:
 - Multiple valid approaches exist with trade-offs
@@ -227,79 +276,100 @@ Use this when:
 - You need to ask clarifying questions before starting
 
 In plan mode, you explore the codebase and design an approach, then present it for user approval before implementing.`,
-        input_schema: {
-            type: "object",
-            properties: {
-                plan_file: {
-                    type: "string",
-                    description: "File to write the plan to (default: .whale/plan.md)",
-                },
-            },
-            required: [],
-        },
+  input_schema: {
+    type: "object",
+    properties: {
+      plan_file: {
+        type: "string",
+        description: "File to write the plan to (default: .whale/plan.md)"
+      }
     },
-    {
-        name: "exit_plan_mode",
-        description: `Exit plan mode after writing your plan. The user will review and approve the plan before implementation begins.
+    required: []
+  }
+}, {
+  name: "exit_plan_mode",
+  description: `Exit plan mode after writing your plan. The user will review and approve the plan before implementation begins.
 
 Only use this after you have:
 1. Thoroughly explored the codebase
 2. Written a clear plan to the plan file
 3. Resolved any ambiguities with the user`,
-        input_schema: {
-            type: "object",
-            properties: {},
-            required: [],
-        },
-    },
-];
+  input_schema: {
+    type: "object",
+    properties: {},
+    required: []
+  }
+}];
+
 // ============================================================================
 // EXECUTE INTERACTIVE TOOLS
 // ============================================================================
+
 export async function executeInteractiveTool(name, input) {
-    switch (name) {
-        case "ask_user_question": {
-            const questions = input.questions;
-            if (!Array.isArray(questions) || questions.length === 0) {
-                return { success: false, output: "questions array is required" };
-            }
-            if (questions.length > 4) {
-                return { success: false, output: "Maximum 4 questions allowed" };
-            }
-            // Create the request — UI will handle it
-            const id = `question-${Date.now()}`;
-            const request = {
-                id,
-                questions: questions.map((q) => ({
-                    question: q.question,
-                    header: q.header?.slice(0, 12) || "Question",
-                    options: (q.options || []).slice(0, 4).map((o) => ({
-                        label: o.label,
-                        description: o.description || "",
-                    })),
-                    multiSelect: q.multiSelect || false,
-                })),
-                resolve: () => { },
-                reject: () => { },
-            };
-            // Store for UI to pick up
-            pendingQuestions.set(id, request);
-            interactiveEvents.emit("question", request);
-            return {
-                success: true,
-                output: `Question pending: ${questions[0].question}`,
-                pendingQuestion: request,
-            };
-        }
-        case "enter_plan_mode": {
-            const result = enterPlanMode(input.plan_file);
-            return { success: result.success, output: result.message };
+  switch (name) {
+    case "ask_user_question":
+      {
+        const questions = input.questions;
+        if (!Array.isArray(questions) || questions.length === 0) {
+          return {
+            success: false,
+            output: "questions array is required"
+          };
         }
-        case "exit_plan_mode": {
-            const result = exitPlanMode();
-            return { success: result.success, output: result.message };
+        if (questions.length > 4) {
+          return {
+            success: false,
+            output: "Maximum 4 questions allowed"
+          };
         }
-        default:
-            return { success: false, output: `Unknown interactive tool: ${name}` };
-    }
+
+        // Create the request — UI will handle it
+        const id = `question-${Date.now()}`;
+        const request = {
+          id,
+          questions: questions.map(q => ({
+            question: q.question,
+            header: q.header?.slice(0, 12) || "Question",
+            options: (q.options || []).slice(0, 4).map(o => ({
+              label: o.label,
+              description: o.description || ""
+            })),
+            multiSelect: q.multiSelect || false
+          })),
+          resolve: () => {},
+          reject: () => {}
+        };
+
+        // Store for UI to pick up
+        pendingQuestions.set(id, request);
+        interactiveEvents.emit("question", request);
+        return {
+          success: true,
+          output: `Question pending: ${questions[0].question}`,
+          pendingQuestion: request
+        };
+      }
+    case "enter_plan_mode":
+      {
+        const result = enterPlanMode(input.plan_file);
+        return {
+          success: result.success,
+          output: result.message
+        };
+      }
+    case "exit_plan_mode":
+      {
+        const result = exitPlanMode();
+        return {
+          success: result.success,
+          output: result.message
+        };
+      }
+    default:
+      return {
+        success: false,
+        output: `Unknown interactive tool: ${name}`
+      };
+  }
 }
+//# sourceMappingURL=interactive-tools.js.map

package/dist/cli/services/interactive-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-tools.js","names":["EventEmitter","readFileSync","existsSync","resolve","pendingQuestions","Map","planModeState","active","pendingPlanData","pendingPlanResolve","interactiveEvents","createQuestionRequest","questions","id","Date","now","Math","random","toString","slice","requestRef","promise","Promise","reject","set","emit","request","getPendingQuestion","values","next","value","resolveQuestion","answers","get","delete","rejectQuestion","error","enterPlanMode","planFile","success","message","startedAt","exitPlanMode","fullPath","process","cwd","planContent","trim","waitForPlanApproval","abortSignal","action","aborted","decision","resolvePromise","onAbort","addEventListener","once","isPlanMode","getPlanModeState","getPendingPlanApproval","resolvePlanApproval","INTERACTIVE_TOOL_DEFINITIONS","name","description","input_schema","type","properties","items","question","header","options","label","required","multiSelect","plan_file","executeInteractiveTool","input","Array","isArray","length","output","map","q","o","pendingQuestion","result"],"sources":["../../../src/cli/services/interactive-tools.ts"],"sourcesContent":["/**\n * Interactive Tools — user interaction during agent execution\n *\n * - AskUserQuestion: Multi-choice questions with optional custom input\n * - Plan Mode: Structured planning workflow with user approval\n */\n\nimport { EventEmitter } from \"events\";\nimport { readFileSync, existsSync } from \"fs\";\nimport { resolve } from \"path\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface QuestionOption {\n  label: string;\n  description: string;\n}\n\nexport interface Question {\n  question: string;\n  header: string;\n  options: QuestionOption[];\n  multiSelect: boolean;\n}\n\nexport interface QuestionRequest {\n  id: string;\n  questions: Question[];\n  resolve: (answers: Record<string, string | string[]>) => void;\n  reject: (error: Error) => void;\n}\n\nexport interface PlanModeState {\n  active: boolean;\n  planFile?: string;\n  planContent?: string;\n  startedAt?: Date;\n}\n\nexport interface PlanApprovalDecision {\n  action: \"execute\" | \"edit\" | \"cancel\" | \"feedback\";\n  feedback?: string;\n}\n\n// ============================================================================\n// GLOBAL STATE\n// ============================================================================\n\n// Pending question requests (resolved by UI)\nconst pendingQuestions = new Map<string, QuestionRequest>();\n\n// Plan mode state\nlet planModeState: PlanModeState = { active: false };\n\n// Plan approval state — blocks exit_plan_mode until UI resolves\n// Separated into data (what to show) and promise (what to resolve).\n// This prevents the race where resolvePlanApproval fires before\n// waitForPlanApproval creates the promise.\nlet pendingPlanData: { planContent: string; planFile: string } | null = null;\nlet pendingPlanResolve: ((decision: PlanApprovalDecision) => void) | null = null;\n\n// Event emitter for UI coordination\nexport const interactiveEvents = new EventEmitter();\n\n// ============================================================================\n// ASK USER QUESTION\n// ============================================================================\n\nexport function createQuestionRequest(questions: Question[]): { request: QuestionRequest; promise: Promise<Record<string, string | string[]>> } {\n  const id = `question-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;\n\n  let requestRef!: QuestionRequest;\n  const promise = new Promise<Record<string, string | string[]>>((resolve, reject) => {\n    requestRef = { id, questions, resolve, reject };\n    pendingQuestions.set(id, requestRef);\n    interactiveEvents.emit(\"question\", requestRef);\n  });\n\n  return { request: requestRef, promise };\n}\n\nexport function getPendingQuestion(): QuestionRequest | undefined {\n  // Return first pending question\n  return pendingQuestions.values().next().value;\n}\n\nexport function resolveQuestion(id: string, answers: Record<string, string | string[]>): boolean {\n  const request = pendingQuestions.get(id);\n  if (!request) return false;\n\n  pendingQuestions.delete(id);\n  request.resolve(answers);\n  return true;\n}\n\nexport function rejectQuestion(id: string, error: Error): boolean {\n  const request = pendingQuestions.get(id);\n  if (!request) return false;\n\n  pendingQuestions.delete(id);\n  request.reject(error);\n  return true;\n}\n\n// ============================================================================\n// PLAN MODE\n// ============================================================================\n\nexport function enterPlanMode(planFile?: string): { success: boolean; message: string } {\n  if (planModeState.active) {\n    return {\n      success: false,\n      message: \"Already in plan mode. Use ExitPlanMode to finish planning.\",\n    };\n  }\n\n  planModeState = {\n    active: true,\n    planFile: planFile || \".whale/plan.md\",\n    startedAt: new Date(),\n  };\n\n  interactiveEvents.emit(\"planModeEntered\", planModeState);\n\n  return {\n    success: true,\n    message: `Entered plan mode. Write your plan to ${planModeState.planFile}, then use ExitPlanMode when ready for approval.`,\n  };\n}\n\nexport function exitPlanMode(): { success: boolean; message: string } {\n  if (!planModeState.active) {\n    return {\n      success: false,\n      message: \"Not in plan mode. Use EnterPlanMode first.\",\n    };\n  }\n\n  const planFile = planModeState.planFile || \".whale/plan.md\";\n  planModeState = { active: false };\n\n  // Read the plan file content\n  const fullPath = resolve(process.cwd(), planFile);\n  let planContent = \"\";\n  if (existsSync(fullPath)) {\n    try {\n      planContent = readFileSync(fullPath, \"utf-8\").trim();\n    } catch { /* ignore read errors */ }\n  }\n\n  // Emit event for UI to show approval overlay\n  interactiveEvents.emit(\"planModeExited\", { planFile, planContent });\n\n  // Store plan data for the UI and waitForPlanApproval().\n  // Promise handlers are created in waitForPlanApproval() — not here.\n  pendingPlanData = { planContent, planFile };\n  pendingPlanResolve = null;\n\n  if (planContent) {\n    return {\n      success: true,\n      message: planContent,\n    };\n  }\n\n  return {\n    success: true,\n    message: `Plan mode complete. Plan saved to ${planFile}.`,\n  };\n}\n\n/**\n * Wait for user to approve/reject the plan via the UI overlay.\n * Called by the agent loop after exitPlanMode() returns.\n */\nexport async function waitForPlanApproval(abortSignal?: AbortSignal): Promise<PlanApprovalDecision> {\n  if (!pendingPlanData) {\n    return { action: \"execute\" };\n  }\n\n  if (abortSignal?.aborted) {\n    pendingPlanData = null;\n    pendingPlanResolve = null;\n    return { action: \"cancel\" };\n  }\n\n  const decision = await new Promise<PlanApprovalDecision>((resolvePromise) => {\n    pendingPlanResolve = resolvePromise;\n\n    if (abortSignal) {\n      const onAbort = () => {\n        pendingPlanData = null;\n        pendingPlanResolve = null;\n        resolvePromise({ action: \"cancel\" });\n      };\n      abortSignal.addEventListener(\"abort\", onAbort, { once: true });\n    }\n  });\n\n  return decision;\n}\n\nexport function isPlanMode(): boolean {\n  return planModeState.active;\n}\n\nexport function getPlanModeState(): PlanModeState {\n  return { ...planModeState };\n}\n\n// ============================================================================\n// PLAN APPROVAL — blocking resolution from UI\n// ============================================================================\n\nexport function getPendingPlanApproval(): { planContent: string; planFile: string } | null {\n  return pendingPlanData ? { ...pendingPlanData } : null;\n}\n\nexport function resolvePlanApproval(decision: PlanApprovalDecision): boolean {\n  if (!pendingPlanResolve) return false;\n  const resolve = pendingPlanResolve;\n  pendingPlanData = null;\n  pendingPlanResolve = null;\n  resolve(decision);\n  return true;\n}\n\n// ============================================================================\n// TOOL DEFINITIONS\n// ============================================================================\n\nexport const INTERACTIVE_TOOL_DEFINITIONS = [\n  {\n    name: \"ask_user_question\",\n    description: `Ask the user questions during execution. Use this to:\n- Gather user preferences or requirements\n- Clarify ambiguous instructions\n- Get decisions on implementation choices\n- Offer choices about direction\n\nUsers can always select \"Other\" to provide custom input.`,\n    input_schema: {\n      type: \"object\",\n      properties: {\n        questions: {\n          type: \"array\",\n          description: \"1-4 questions to ask the user\",\n          items: {\n            type: \"object\",\n            properties: {\n              question: {\n                type: \"string\",\n                description: \"The complete question to ask (ends with ?)\",\n              },\n              header: {\n                type: \"string\",\n                description: \"Short label (max 12 chars) like 'Auth method' or 'Library'\",\n              },\n              options: {\n                type: \"array\",\n                description: \"2-4 choices (Other is added automatically)\",\n                items: {\n                  type: \"object\",\n                  properties: {\n                    label: {\n                      type: \"string\",\n                      description: \"Concise choice text (1-5 words)\",\n                    },\n                    description: {\n                      type: \"string\",\n                      description: \"Explanation of what this choice means\",\n                    },\n                  },\n                  required: [\"label\", \"description\"],\n                },\n              },\n              multiSelect: {\n                type: \"boolean\",\n                description: \"Allow selecting multiple options (default: false)\",\n              },\n            },\n            required: [\"question\", \"header\", \"options\"],\n          },\n        },\n      },\n      required: [\"questions\"],\n    },\n  },\n  {\n    name: \"enter_plan_mode\",\n    description: `Enter plan mode for complex tasks requiring careful planning before implementation.\n\nUse this when:\n- Multiple valid approaches exist with trade-offs\n- Significant architectural decisions are needed\n- Large-scale changes touch many files\n- Requirements are unclear and need exploration\n- You need to ask clarifying questions before starting\n\nIn plan mode, you explore the codebase and design an approach, then present it for user approval before implementing.`,\n    input_schema: {\n      type: \"object\",\n      properties: {\n        plan_file: {\n          type: \"string\",\n          description: \"File to write the plan to (default: .whale/plan.md)\",\n        },\n      },\n      required: [],\n    },\n  },\n  {\n    name: \"exit_plan_mode\",\n    description: `Exit plan mode after writing your plan. The user will review and approve the plan before implementation begins.\n\nOnly use this after you have:\n1. Thoroughly explored the codebase\n2. Written a clear plan to the plan file\n3. Resolved any ambiguities with the user`,\n    input_schema: {\n      type: \"object\",\n      properties: {},\n      required: [],\n    },\n  },\n];\n\n// ============================================================================\n// EXECUTE INTERACTIVE TOOLS\n// ============================================================================\n\nexport async function executeInteractiveTool(\n  name: string,\n  input: Record<string, unknown>\n): Promise<{ success: boolean; output: string; pendingQuestion?: QuestionRequest }> {\n  switch (name) {\n    case \"ask_user_question\": {\n      const questions = input.questions as Question[];\n      if (!Array.isArray(questions) || questions.length === 0) {\n        return { success: false, output: \"questions array is required\" };\n      }\n      if (questions.length > 4) {\n        return { success: false, output: \"Maximum 4 questions allowed\" };\n      }\n\n      // Create the request — UI will handle it\n      const id = `question-${Date.now()}`;\n      const request: QuestionRequest = {\n        id,\n        questions: questions.map((q) => ({\n          question: q.question,\n          header: q.header?.slice(0, 12) || \"Question\",\n          options: (q.options || []).slice(0, 4).map((o) => ({\n            label: o.label,\n            description: o.description || \"\",\n          })),\n          multiSelect: q.multiSelect || false,\n        })),\n        resolve: () => {},\n        reject: () => {},\n      };\n\n      // Store for UI to pick up\n      pendingQuestions.set(id, request);\n      interactiveEvents.emit(\"question\", request);\n\n      return {\n        success: true,\n        output: `Question pending: ${questions[0].question}`,\n        pendingQuestion: request,\n      };\n    }\n\n    case \"enter_plan_mode\": {\n      const result = enterPlanMode(input.plan_file as string);\n      return { success: result.success, output: result.message };\n    }\n\n    case \"exit_plan_mode\": {\n      const result = exitPlanMode();\n      return { success: result.success, output: result.message };\n    }\n\n    default:\n      return { success: false, output: `Unknown interactive tool: ${name}` };\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cli/services/keybinding-manager.d.ts

@@ -1,7 +1,7 @@
 /**
  * Keybinding Manager — configurable keyboard shortcuts
  *
- * Loads overrides from ~/.swagmanager/keybindings.json.
+ * Loads overrides from ~/.whale/keybindings.json.
  * Only listed bindings are configurable; Enter, backspace, arrows stay hardcoded.
  */
 export interface KeybindingConfig {
@@ -30,6 +30,8 @@ export interface InkKey {
     pageDown: boolean;
 }
 export declare function loadKeybindings(): Required<KeybindingConfig>;
+/** Reset cached keybindings — call after /settings modifies keybindings.json. */
+export declare function resetKeybindingsCache(): void;
 /**
  * Check if an Ink useInput event matches a binding string.
  *
@@ -46,6 +48,16 @@ export declare function matchesBinding(binding: string, input: string, key: Part
  * "escape" -> "\x1b"
  */
 export declare function bindingToControlChar(binding: string): string;
+/**
+ * Convert a binding string to a human-readable label.
+ *
+ * "ctrl+o"  → "Ctrl+O"
+ * "escape"  → "ESC"
+ * "meta+k"  → "Alt+K"
+ * "alt+k"   → "Alt+K"
+ * "a"       → "A"
+ */
+export declare function bindingToLabel(binding: string): string;
 /**
  * Reset cached keybindings (for testing or hot-reload).
  */