whale-code 6.5.4 → 6.5.6

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

@@ -4,220 +4,255 @@
  * - 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;
+
 // 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)}`;
+  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);
+  });
 }
 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
+  });
+
+  // Set up pending approval state so UI can resolve it via resolvePlanApproval()
+  pendingPlanApproval = {
+    resolve: () => {},
+    reject: () => {},
+    planContent,
+    planFile
+  };
+  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" };
-    }
-    const { planContent, planFile } = pendingPlanApproval;
-    const decision = await new Promise((resolvePromise, rejectPromise) => {
-        pendingPlanApproval = {
-            resolve: resolvePromise,
-            reject: rejectPromise,
-            planContent,
-            planFile,
-        };
-    });
-    return decision;
+  if (!pendingPlanApproval) {
+    return {
+      action: "execute"
+    };
+  }
+  const {
+    planContent,
+    planFile
+  } = pendingPlanApproval;
+  const decision = await new Promise((resolvePromise, rejectPromise) => {
+    pendingPlanApproval = {
+      resolve: resolvePromise,
+      reject: rejectPromise,
+      planContent,
+      planFile
+    };
+  });
+  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 };
+  if (!pendingPlanApproval) return null;
+  return {
+    planContent: pendingPlanApproval.planContent,
+    planFile: pendingPlanApproval.planFile
+  };
 }
 export function resolvePlanApproval(decision) {
-    if (!pendingPlanApproval)
-        return false;
-    const { resolve } = pendingPlanApproval;
-    pendingPlanApproval = null;
-    resolve(decision);
-    return true;
+  if (!pendingPlanApproval) return false;
+  const {
+    resolve
+  } = pendingPlanApproval;
+  pendingPlanApproval = 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 +262,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","pendingPlanApproval","interactiveEvents","createQuestionRequest","questions","id","Date","now","Math","random","toString","slice","Promise","reject","request","set","emit","getPendingQuestion","values","next","value","resolveQuestion","answers","get","delete","rejectQuestion","error","enterPlanMode","planFile","success","message","startedAt","exitPlanMode","fullPath","process","cwd","planContent","trim","waitForPlanApproval","action","decision","resolvePromise","rejectPromise","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\nlet pendingPlanApproval: {\n  resolve: (decision: PlanApprovalDecision) => void;\n  reject: (error: Error) => void;\n  planContent: string;\n  planFile: string;\n} | 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[]): QuestionRequest {\n  const id = `question-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;\n\n  return new Promise<Record<string, string | string[]>>((resolve, reject) => {\n    const request: QuestionRequest = {\n      id,\n      questions,\n      resolve,\n      reject,\n    };\n\n    pendingQuestions.set(id, request);\n\n    // Emit event for UI to pick up\n    interactiveEvents.emit(\"question\", request);\n  }) as unknown as QuestionRequest;\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  // Set up pending approval state so UI can resolve it via resolvePlanApproval()\n  pendingPlanApproval = {\n    resolve: () => {},\n    reject: () => {},\n    planContent,\n    planFile,\n  };\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(): Promise<PlanApprovalDecision> {\n  if (!pendingPlanApproval) {\n    return { action: \"execute\" };\n  }\n\n  const { planContent, planFile } = pendingPlanApproval;\n\n  const decision = await new Promise<PlanApprovalDecision>((resolvePromise, rejectPromise) => {\n    pendingPlanApproval = {\n      resolve: resolvePromise,\n      reject: rejectPromise,\n      planContent,\n      planFile,\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  if (!pendingPlanApproval) return null;\n  return { planContent: pendingPlanApproval.planContent, planFile: pendingPlanApproval.planFile };\n}\n\nexport function resolvePlanApproval(decision: PlanApprovalDecision): boolean {\n  if (!pendingPlanApproval) return false;\n  const { resolve } = pendingPlanApproval;\n  pendingPlanApproval = 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 {
@@ -46,6 +46,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).
  */