whale-code 6.5.6 → 6.5.8

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

@@ -1 +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":[]}
+{"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

@@ -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.
  *

package/dist/cli/services/keybinding-manager.js

@@ -60,6 +60,11 @@ export function loadKeybindings() {
   };
 }
 
+/** Reset cached keybindings — call after /settings modifies keybindings.json. */
+export function resetKeybindingsCache() {
+  _cached = null;
+}
+
 // ============================================================================
 // MATCHER — checks if a binding string matches an Ink key event
 // ============================================================================

package/dist/cli/services/keybinding-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"keybinding-manager.js","names":["existsSync","readFileSync","KEYBINDINGS_PATH","DEFAULTS","cancel_stream","toggle_expand","toggle_thinking","exit","clear_line","delete_word","home","_cached","loadKeybindings","p","raw","JSON","parse","filtered","key","Object","keys","matchesBinding","binding","input","parts","toLowerCase","split","length","escape","ctrl","meta","modifier","char","CTRL_MAP","bindingToControlChar","bindingToLabel","toUpperCase","modLabel","resetKeybindingCache"],"sources":["../../../src/cli/services/keybinding-manager.ts"],"sourcesContent":["/**\n * Keybinding Manager — configurable keyboard shortcuts\n *\n * Loads overrides from ~/.whale/keybindings.json.\n * Only listed bindings are configurable; Enter, backspace, arrows stay hardcoded.\n */\n\nimport { existsSync, readFileSync } from \"fs\";\nimport { KEYBINDINGS_PATH } from \"./paths.js\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface KeybindingConfig {\n  cancel_stream?: string;     // default: \"escape\"\n  toggle_expand?: string;     // default: \"ctrl+o\"\n  toggle_thinking?: string;   // default: \"ctrl+t\"\n  exit?: string;              // default: \"ctrl+c\"\n  clear_line?: string;        // default: \"ctrl+u\"\n  delete_word?: string;       // default: \"ctrl+w\"\n  home?: string;              // default: \"ctrl+a\"\n}\n\nexport interface InkKey {\n  ctrl: boolean;\n  meta: boolean;\n  shift: boolean;\n  escape: boolean;\n  return: boolean;\n  tab: boolean;\n  backspace: boolean;\n  delete: boolean;\n  upArrow: boolean;\n  downArrow: boolean;\n  leftArrow: boolean;\n  rightArrow: boolean;\n  pageUp: boolean;\n  pageDown: boolean;\n}\n\n// ============================================================================\n// DEFAULTS\n// ============================================================================\n\nconst DEFAULTS: Required<KeybindingConfig> = {\n  cancel_stream: \"escape\",\n  toggle_expand: \"ctrl+o\",\n  toggle_thinking: \"ctrl+t\",\n  exit: \"ctrl+c\",\n  clear_line: \"ctrl+u\",\n  delete_word: \"ctrl+w\",\n  home: \"ctrl+a\",\n};\n\n// ============================================================================\n// LOADER (cached at module level)\n// ============================================================================\n\nlet _cached: KeybindingConfig | null = null;\n\nexport function loadKeybindings(): Required<KeybindingConfig> {\n  if (_cached !== null) return { ...DEFAULTS, ..._cached };\n\n  try {\n    const p = KEYBINDINGS_PATH;\n    if (existsSync(p)) {\n      const raw = JSON.parse(readFileSync(p, \"utf-8\"));\n      // Only accept known keys\n      const filtered: KeybindingConfig = {};\n      for (const key of Object.keys(DEFAULTS) as (keyof KeybindingConfig)[]) {\n        if (typeof raw[key] === \"string\") {\n          filtered[key] = raw[key];\n        }\n      }\n      _cached = filtered;\n    } else {\n      _cached = {};\n    }\n  } catch {\n    _cached = {};\n  }\n\n  return { ...DEFAULTS, ..._cached };\n}\n\n// ============================================================================\n// MATCHER — checks if a binding string matches an Ink key event\n// ============================================================================\n\n/**\n * Check if an Ink useInput event matches a binding string.\n *\n * Binding format: \"ctrl+<key>\", \"escape\", \"meta+<key>\", or single char.\n * Examples: \"ctrl+e\", \"escape\", \"ctrl+c\", \"ctrl+t\"\n */\nexport function matchesBinding(binding: string, input: string, key: Partial<InkKey>): boolean {\n  const parts = binding.toLowerCase().split(\"+\");\n\n  if (parts.length === 1) {\n    // Simple key: \"escape\", \"e\", etc.\n    if (parts[0] === \"escape\") return !!key.escape;\n    return input === parts[0] && !key.ctrl && !key.meta;\n  }\n\n  if (parts.length === 2) {\n    const [modifier, char] = parts;\n    if (modifier === \"ctrl\") {\n      return !!key.ctrl && input === char;\n    }\n    if (modifier === \"meta\" || modifier === \"alt\") {\n      return !!key.meta && input === char;\n    }\n  }\n\n  return false;\n}\n\n// ============================================================================\n// CONTROL CHAR CONVERTER — for raw stdin matching\n// ============================================================================\n\nconst CTRL_MAP: Record<string, string> = {\n  \"a\": \"\\x01\", \"b\": \"\\x02\", \"c\": \"\\x03\", \"d\": \"\\x04\", \"e\": \"\\x05\",\n  \"f\": \"\\x06\", \"g\": \"\\x07\", \"h\": \"\\x08\", \"i\": \"\\x09\", \"j\": \"\\x0a\",\n  \"k\": \"\\x0b\", \"l\": \"\\x0c\", \"m\": \"\\x0d\", \"n\": \"\\x0e\", \"o\": \"\\x0f\",\n  \"p\": \"\\x10\", \"q\": \"\\x11\", \"r\": \"\\x12\", \"s\": \"\\x13\", \"t\": \"\\x14\",\n  \"u\": \"\\x15\", \"v\": \"\\x16\", \"w\": \"\\x17\", \"x\": \"\\x18\", \"y\": \"\\x19\",\n  \"z\": \"\\x1a\",\n};\n\n/**\n * Convert a binding string to a raw control character for stdin matching.\n * Returns the string as-is if not a ctrl+<key> binding.\n *\n * \"ctrl+u\" -> \"\\x15\"\n * \"ctrl+w\" -> \"\\x17\"\n * \"escape\" -> \"\\x1b\"\n */\nexport function bindingToControlChar(binding: string): string {\n  const parts = binding.toLowerCase().split(\"+\");\n\n  if (parts.length === 1) {\n    if (parts[0] === \"escape\") return \"\\x1b\";\n    return parts[0];\n  }\n\n  if (parts.length === 2 && parts[0] === \"ctrl\") {\n    return CTRL_MAP[parts[1]] || binding;\n  }\n\n  return binding;\n}\n\n// ============================================================================\n// LABEL CONVERTER — human-readable keybinding labels for UI\n// ============================================================================\n\n/**\n * Convert a binding string to a human-readable label.\n *\n * \"ctrl+o\"  → \"Ctrl+O\"\n * \"escape\"  → \"ESC\"\n * \"meta+k\"  → \"Alt+K\"\n * \"alt+k\"   → \"Alt+K\"\n * \"a\"       → \"A\"\n */\nexport function bindingToLabel(binding: string): string {\n  const parts = binding.toLowerCase().split(\"+\");\n\n  if (parts.length === 1) {\n    if (parts[0] === \"escape\") return \"ESC\";\n    return parts[0].toUpperCase();\n  }\n\n  if (parts.length === 2) {\n    const [modifier, key] = parts;\n    const modLabel = modifier === \"ctrl\" ? \"Ctrl\"\n      : (modifier === \"meta\" || modifier === \"alt\") ? \"Alt\"\n      : modifier;\n    return `${modLabel}+${key.toUpperCase()}`;\n  }\n\n  return binding;\n}\n\n/**\n * Reset cached keybindings (for testing or hot-reload).\n */\nexport function resetKeybindingCache(): void {\n  _cached = null;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"keybinding-manager.js","names":["existsSync","readFileSync","KEYBINDINGS_PATH","DEFAULTS","cancel_stream","toggle_expand","toggle_thinking","exit","clear_line","delete_word","home","_cached","loadKeybindings","p","raw","JSON","parse","filtered","key","Object","keys","resetKeybindingsCache","matchesBinding","binding","input","parts","toLowerCase","split","length","escape","ctrl","meta","modifier","char","CTRL_MAP","bindingToControlChar","bindingToLabel","toUpperCase","modLabel","resetKeybindingCache"],"sources":["../../../src/cli/services/keybinding-manager.ts"],"sourcesContent":["/**\n * Keybinding Manager — configurable keyboard shortcuts\n *\n * Loads overrides from ~/.whale/keybindings.json.\n * Only listed bindings are configurable; Enter, backspace, arrows stay hardcoded.\n */\n\nimport { existsSync, readFileSync } from \"fs\";\nimport { KEYBINDINGS_PATH } from \"./paths.js\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface KeybindingConfig {\n  cancel_stream?: string;     // default: \"escape\"\n  toggle_expand?: string;     // default: \"ctrl+o\"\n  toggle_thinking?: string;   // default: \"ctrl+t\"\n  exit?: string;              // default: \"ctrl+c\"\n  clear_line?: string;        // default: \"ctrl+u\"\n  delete_word?: string;       // default: \"ctrl+w\"\n  home?: string;              // default: \"ctrl+a\"\n}\n\nexport interface InkKey {\n  ctrl: boolean;\n  meta: boolean;\n  shift: boolean;\n  escape: boolean;\n  return: boolean;\n  tab: boolean;\n  backspace: boolean;\n  delete: boolean;\n  upArrow: boolean;\n  downArrow: boolean;\n  leftArrow: boolean;\n  rightArrow: boolean;\n  pageUp: boolean;\n  pageDown: boolean;\n}\n\n// ============================================================================\n// DEFAULTS\n// ============================================================================\n\nconst DEFAULTS: Required<KeybindingConfig> = {\n  cancel_stream: \"escape\",\n  toggle_expand: \"ctrl+o\",\n  toggle_thinking: \"ctrl+t\",\n  exit: \"ctrl+c\",\n  clear_line: \"ctrl+u\",\n  delete_word: \"ctrl+w\",\n  home: \"ctrl+a\",\n};\n\n// ============================================================================\n// LOADER (cached at module level)\n// ============================================================================\n\nlet _cached: KeybindingConfig | null = null;\n\nexport function loadKeybindings(): Required<KeybindingConfig> {\n  if (_cached !== null) return { ...DEFAULTS, ..._cached };\n\n  try {\n    const p = KEYBINDINGS_PATH;\n    if (existsSync(p)) {\n      const raw = JSON.parse(readFileSync(p, \"utf-8\"));\n      // Only accept known keys\n      const filtered: KeybindingConfig = {};\n      for (const key of Object.keys(DEFAULTS) as (keyof KeybindingConfig)[]) {\n        if (typeof raw[key] === \"string\") {\n          filtered[key] = raw[key];\n        }\n      }\n      _cached = filtered;\n    } else {\n      _cached = {};\n    }\n  } catch {\n    _cached = {};\n  }\n\n  return { ...DEFAULTS, ..._cached };\n}\n\n/** Reset cached keybindings — call after /settings modifies keybindings.json. */\nexport function resetKeybindingsCache(): void {\n  _cached = null;\n}\n\n// ============================================================================\n// MATCHER — checks if a binding string matches an Ink key event\n// ============================================================================\n\n/**\n * Check if an Ink useInput event matches a binding string.\n *\n * Binding format: \"ctrl+<key>\", \"escape\", \"meta+<key>\", or single char.\n * Examples: \"ctrl+e\", \"escape\", \"ctrl+c\", \"ctrl+t\"\n */\nexport function matchesBinding(binding: string, input: string, key: Partial<InkKey>): boolean {\n  const parts = binding.toLowerCase().split(\"+\");\n\n  if (parts.length === 1) {\n    // Simple key: \"escape\", \"e\", etc.\n    if (parts[0] === \"escape\") return !!key.escape;\n    return input === parts[0] && !key.ctrl && !key.meta;\n  }\n\n  if (parts.length === 2) {\n    const [modifier, char] = parts;\n    if (modifier === \"ctrl\") {\n      return !!key.ctrl && input === char;\n    }\n    if (modifier === \"meta\" || modifier === \"alt\") {\n      return !!key.meta && input === char;\n    }\n  }\n\n  return false;\n}\n\n// ============================================================================\n// CONTROL CHAR CONVERTER — for raw stdin matching\n// ============================================================================\n\nconst CTRL_MAP: Record<string, string> = {\n  \"a\": \"\\x01\", \"b\": \"\\x02\", \"c\": \"\\x03\", \"d\": \"\\x04\", \"e\": \"\\x05\",\n  \"f\": \"\\x06\", \"g\": \"\\x07\", \"h\": \"\\x08\", \"i\": \"\\x09\", \"j\": \"\\x0a\",\n  \"k\": \"\\x0b\", \"l\": \"\\x0c\", \"m\": \"\\x0d\", \"n\": \"\\x0e\", \"o\": \"\\x0f\",\n  \"p\": \"\\x10\", \"q\": \"\\x11\", \"r\": \"\\x12\", \"s\": \"\\x13\", \"t\": \"\\x14\",\n  \"u\": \"\\x15\", \"v\": \"\\x16\", \"w\": \"\\x17\", \"x\": \"\\x18\", \"y\": \"\\x19\",\n  \"z\": \"\\x1a\",\n};\n\n/**\n * Convert a binding string to a raw control character for stdin matching.\n * Returns the string as-is if not a ctrl+<key> binding.\n *\n * \"ctrl+u\" -> \"\\x15\"\n * \"ctrl+w\" -> \"\\x17\"\n * \"escape\" -> \"\\x1b\"\n */\nexport function bindingToControlChar(binding: string): string {\n  const parts = binding.toLowerCase().split(\"+\");\n\n  if (parts.length === 1) {\n    if (parts[0] === \"escape\") return \"\\x1b\";\n    return parts[0];\n  }\n\n  if (parts.length === 2 && parts[0] === \"ctrl\") {\n    return CTRL_MAP[parts[1]] || binding;\n  }\n\n  return binding;\n}\n\n// ============================================================================\n// LABEL CONVERTER — human-readable keybinding labels for UI\n// ============================================================================\n\n/**\n * Convert a binding string to a human-readable label.\n *\n * \"ctrl+o\"  → \"Ctrl+O\"\n * \"escape\"  → \"ESC\"\n * \"meta+k\"  → \"Alt+K\"\n * \"alt+k\"   → \"Alt+K\"\n * \"a\"       → \"A\"\n */\nexport function bindingToLabel(binding: string): string {\n  const parts = binding.toLowerCase().split(\"+\");\n\n  if (parts.length === 1) {\n    if (parts[0] === \"escape\") return \"ESC\";\n    return parts[0].toUpperCase();\n  }\n\n  if (parts.length === 2) {\n    const [modifier, key] = parts;\n    const modLabel = modifier === \"ctrl\" ? \"Ctrl\"\n      : (modifier === \"meta\" || modifier === \"alt\") ? \"Alt\"\n      : modifier;\n    return `${modLabel}+${key.toUpperCase()}`;\n  }\n\n  return binding;\n}\n\n/**\n * Reset cached keybindings (for testing or hot-reload).\n */\nexport function resetKeybindingCache(): void {\n  _cached = null;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cli/services/local-tools-agent-defs-tasks.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Agent Tool Definitions — Tasks, Multi-Edit, Subagent, and Team tools.
+ * Extracted from local-tools-agent-defs.ts for file size management.
+ */
+import type { LocalToolDefinition } from "./local-tools.js";
+export declare const TASK_AND_TEAM_TOOL_DEFINITIONS: LocalToolDefinition[];

package/dist/cli/services/local-tools-agent-defs-tasks.js

@@ -0,0 +1,245 @@
+/**
+ * Agent Tool Definitions — Tasks, Multi-Edit, Subagent, and Team tools.
+ * Extracted from local-tools-agent-defs.ts for file size management.
+ */
+
+export const TASK_AND_TEAM_TOOL_DEFINITIONS = [
+// ------------------------------------------------------------------
+// TASKS — action-based CRUD for structured task tracking
+// ------------------------------------------------------------------
+{
+  name: "tasks",
+  description: "Track tasks for the current session. Actions: create (returns ID), update (status/deps), list (summary), get (full details). Supports dependencies via blocks/blockedBy.",
+  input_schema: {
+    type: "object",
+    properties: {
+      action: {
+        type: "string",
+        enum: ["create", "update", "list", "get"],
+        description: "Action to perform"
+      },
+      // For create:
+      subject: {
+        type: "string",
+        description: "Brief title in imperative form (create)"
+      },
+      description: {
+        type: "string",
+        description: "Detailed description (create/update)"
+      },
+      activeForm: {
+        type: "string",
+        description: "Present continuous spinner text (create/update)"
+      },
+      metadata: {
+        type: "object",
+        description: "Arbitrary metadata (create/update)"
+      },
+      // For update/get:
+      taskId: {
+        type: "string",
+        description: "Task ID (update/get)"
+      },
+      status: {
+        type: "string",
+        enum: ["pending", "in_progress", "completed", "deleted"],
+        description: "New status (update)"
+      },
+      subject_update: {
+        type: "string",
+        description: "New subject (update)"
+      },
+      addBlocks: {
+        type: "array",
+        items: {
+          type: "string"
+        },
+        description: "Task IDs this task blocks (update)"
+      },
+      addBlockedBy: {
+        type: "array",
+        items: {
+          type: "string"
+        },
+        description: "Task IDs that block this task (update)"
+      },
+      owner: {
+        type: "string",
+        description: "Task owner (update)"
+      }
+    },
+    required: ["action"]
+  }
+},
+// ------------------------------------------------------------------
+// NEW: MULTI_EDIT — multiple edits to one file in a single call
+// ------------------------------------------------------------------
+{
+  name: "multi_edit",
+  description: "Apply multiple edits to one file in a single call. Edits applied sequentially. Fails if any old_string not found.",
+  input_schema: {
+    type: "object",
+    properties: {
+      file_path: {
+        type: "string",
+        description: "Absolute or relative path to the file"
+      },
+      edits: {
+        type: "array",
+        description: "Array of edits to apply sequentially",
+        items: {
+          type: "object",
+          properties: {
+            old_string: {
+              type: "string",
+              description: "Exact text to find"
+            },
+            new_string: {
+              type: "string",
+              description: "Text to replace with"
+            }
+          },
+          required: ["old_string", "new_string"]
+        }
+      }
+    },
+    required: ["file_path", "edits"]
+  }
+},
+// ------------------------------------------------------------------
+// TASK — subagent for discrete tasks
+// ------------------------------------------------------------------
+{
+  name: "task",
+  description: "Launch a subagent in isolated context. Subagents have full tool access and batch multiple tool calls per turn (glob + grep + read_file in parallel). Launch multiple task calls in one response for parallel execution. Use for any work requiring 3+ tool calls. Subagents complete in 2-8 turns autonomously.",
+  input_schema: {
+    type: "object",
+    properties: {
+      prompt: {
+        type: "string",
+        description: "Specific task with clear completion criteria"
+      },
+      subagent_type: {
+        type: "string",
+        enum: ["explore", "plan", "general-purpose", "research"],
+        description: "Agent type: explore=find, plan=design, general-purpose=do, research=lookup"
+      },
+      model: {
+        type: "string",
+        enum: ["sonnet", "opus", "haiku"],
+        description: "Haiku for quick tasks, Sonnet (default) for most, Opus for complex"
+      },
+      run_in_background: {
+        type: "boolean",
+        description: "Run agent in background. Returns output_file path to check progress via task_output."
+      },
+      max_turns: {
+        type: "number",
+        description: "Max agentic turns (1-50). Default 8."
+      },
+      name: {
+        type: "string",
+        description: "Display name for the agent."
+      },
+      description: {
+        type: "string",
+        description: "Short 3-5 word description of the task."
+      },
+      team_name: {
+        type: "string",
+        description: "Team name for spawning. Uses current team context if omitted."
+      },
+      mode: {
+        type: "string",
+        enum: ["default", "plan", "yolo"],
+        description: "Permission mode for spawned agent (default inherits parent)."
+      }
+    },
+    required: ["prompt", "subagent_type"]
+  }
+},
+// ------------------------------------------------------------------
+// TEAM — parallel agent team for large tasks
+// ------------------------------------------------------------------
+{
+  name: "team_create",
+  description: "Create an Agent Team — multiple full Claude instances in parallel. Returns immediately with a team_id. Use task_output to check progress and task_stop to kill stuck teammates. Each teammate has full tool access. Size tasks for 5-6 items per teammate. Include file lists to prevent conflicts.",
+  input_schema: {
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "Team name (e.g., 'Feature Implementation Team')"
+      },
+      teammate_count: {
+        type: "number",
+        description: "Number of teammates to spawn (2-5 recommended)"
+      },
+      model: {
+        type: "string",
+        enum: ["sonnet", "opus", "haiku"],
+        description: "Model for all teammates (default: sonnet)"
+      },
+      tasks: {
+        type: "array",
+        description: "Tasks for the team to complete",
+        items: {
+          type: "object",
+          properties: {
+            description: {
+              type: "string",
+              description: "Clear task description with completion criteria"
+            },
+            model: {
+              type: "string",
+              description: "Model for this task: haiku (lookups), sonnet (analysis), opus (complex reasoning). Overrides team default."
+            },
+            files: {
+              type: "array",
+              items: {
+                type: "string"
+              },
+              description: "Files this task will modify (for conflict prevention)"
+            },
+            dependencies: {
+              type: "array",
+              items: {
+                type: "string"
+              },
+              description: "Task descriptions that must complete first"
+            }
+          },
+          required: ["description"]
+        }
+      }
+    },
+    required: ["name", "teammate_count", "tasks"]
+  }
+}, {
+  name: "team_auto",
+  description: "Auto-decompose a task and run it as a parallel agent team. AI breaks the task into sub-tasks with file ownership, spawns teammates, executes in parallel. Returns a team_id — use team_status to monitor progress and team_stop to kill stuck teammates.",
+  input_schema: {
+    type: "object",
+    properties: {
+      task: {
+        type: "string",
+        description: "The task to decompose and execute (e.g., 'Refactor all components to use TypeScript strict mode')"
+      },
+      max_teammates: {
+        type: "number",
+        description: "Maximum number of parallel teammates (default: 4, max: 6)"
+      },
+      model: {
+        type: "string",
+        enum: ["sonnet", "opus", "haiku"],
+        description: "Model for teammates (default: sonnet)"
+      },
+      working_directory: {
+        type: "string",
+        description: "Project directory to work in (default: cwd)"
+      }
+    },
+    required: ["task"]
+  }
+}];
+//# sourceMappingURL=local-tools-agent-defs-tasks.js.map

package/dist/cli/services/local-tools-agent-defs-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tools-agent-defs-tasks.js","names":["TASK_AND_TEAM_TOOL_DEFINITIONS","name","description","input_schema","type","properties","action","enum","subject","activeForm","metadata","taskId","status","subject_update","addBlocks","items","addBlockedBy","owner","required","file_path","edits","old_string","new_string","prompt","subagent_type","model","run_in_background","max_turns","team_name","mode","teammate_count","tasks","files","dependencies","task","max_teammates","working_directory"],"sources":["../../../src/cli/services/local-tools-agent-defs-tasks.ts"],"sourcesContent":["/**\n * Agent Tool Definitions — Tasks, Multi-Edit, Subagent, and Team tools.\n * Extracted from local-tools-agent-defs.ts for file size management.\n */\n\nimport type { LocalToolDefinition } from \"./local-tools.js\";\n\nexport const TASK_AND_TEAM_TOOL_DEFINITIONS: LocalToolDefinition[] = [\n  // ------------------------------------------------------------------\n  // TASKS — action-based CRUD for structured task tracking\n  // ------------------------------------------------------------------\n  {\n    name: \"tasks\",\n    description: \"Track tasks for the current session. Actions: create (returns ID), update (status/deps), list (summary), get (full details). Supports dependencies via blocks/blockedBy.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        action: {\n          type: \"string\",\n          enum: [\"create\", \"update\", \"list\", \"get\"],\n          description: \"Action to perform\",\n        },\n        // For create:\n        subject: { type: \"string\", description: \"Brief title in imperative form (create)\" },\n        description: { type: \"string\", description: \"Detailed description (create/update)\" },\n        activeForm: { type: \"string\", description: \"Present continuous spinner text (create/update)\" },\n        metadata: { type: \"object\", description: \"Arbitrary metadata (create/update)\" },\n        // For update/get:\n        taskId: { type: \"string\", description: \"Task ID (update/get)\" },\n        status: { type: \"string\", enum: [\"pending\", \"in_progress\", \"completed\", \"deleted\"], description: \"New status (update)\" },\n        subject_update: { type: \"string\", description: \"New subject (update)\" },\n        addBlocks: { type: \"array\", items: { type: \"string\" }, description: \"Task IDs this task blocks (update)\" },\n        addBlockedBy: { type: \"array\", items: { type: \"string\" }, description: \"Task IDs that block this task (update)\" },\n        owner: { type: \"string\", description: \"Task owner (update)\" },\n      },\n      required: [\"action\"],\n    },\n  },\n  // ------------------------------------------------------------------\n  // NEW: MULTI_EDIT — multiple edits to one file in a single call\n  // ------------------------------------------------------------------\n  {\n    name: \"multi_edit\",\n    description: \"Apply multiple edits to one file in a single call. Edits applied sequentially. Fails if any old_string not found.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        file_path: { type: \"string\", description: \"Absolute or relative path to the file\" },\n        edits: {\n          type: \"array\",\n          description: \"Array of edits to apply sequentially\",\n          items: {\n            type: \"object\",\n            properties: {\n              old_string: { type: \"string\", description: \"Exact text to find\" },\n              new_string: { type: \"string\", description: \"Text to replace with\" },\n            },\n            required: [\"old_string\", \"new_string\"],\n          },\n        },\n      },\n      required: [\"file_path\", \"edits\"],\n    },\n  },\n  // ------------------------------------------------------------------\n  // TASK — subagent for discrete tasks\n  // ------------------------------------------------------------------\n  {\n    name: \"task\",\n    description: \"Launch a subagent in isolated context. Subagents have full tool access and batch multiple tool calls per turn (glob + grep + read_file in parallel). Launch multiple task calls in one response for parallel execution. Use for any work requiring 3+ tool calls. Subagents complete in 2-8 turns autonomously.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        prompt: { type: \"string\", description: \"Specific task with clear completion criteria\" },\n        subagent_type: {\n          type: \"string\",\n          enum: [\"explore\", \"plan\", \"general-purpose\", \"research\"],\n          description: \"Agent type: explore=find, plan=design, general-purpose=do, research=lookup\",\n        },\n        model: {\n          type: \"string\",\n          enum: [\"sonnet\", \"opus\", \"haiku\"],\n          description: \"Haiku for quick tasks, Sonnet (default) for most, Opus for complex\",\n        },\n        run_in_background: {\n          type: \"boolean\",\n          description: \"Run agent in background. Returns output_file path to check progress via task_output.\",\n        },\n        max_turns: {\n          type: \"number\",\n          description: \"Max agentic turns (1-50). Default 8.\",\n        },\n        name: {\n          type: \"string\",\n          description: \"Display name for the agent.\",\n        },\n        description: {\n          type: \"string\",\n          description: \"Short 3-5 word description of the task.\",\n        },\n        team_name: {\n          type: \"string\",\n          description: \"Team name for spawning. Uses current team context if omitted.\",\n        },\n        mode: {\n          type: \"string\",\n          enum: [\"default\", \"plan\", \"yolo\"],\n          description: \"Permission mode for spawned agent (default inherits parent).\",\n        },\n      },\n      required: [\"prompt\", \"subagent_type\"],\n    },\n  },\n  // ------------------------------------------------------------------\n  // TEAM — parallel agent team for large tasks\n  // ------------------------------------------------------------------\n  {\n    name: \"team_create\",\n    description: \"Create an Agent Team — multiple full Claude instances in parallel. Returns immediately with a team_id. Use task_output to check progress and task_stop to kill stuck teammates. Each teammate has full tool access. Size tasks for 5-6 items per teammate. Include file lists to prevent conflicts.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        name: {\n          type: \"string\",\n          description: \"Team name (e.g., 'Feature Implementation Team')\",\n        },\n        teammate_count: {\n          type: \"number\",\n          description: \"Number of teammates to spawn (2-5 recommended)\",\n        },\n        model: {\n          type: \"string\",\n          enum: [\"sonnet\", \"opus\", \"haiku\"],\n          description: \"Model for all teammates (default: sonnet)\",\n        },\n        tasks: {\n          type: \"array\",\n          description: \"Tasks for the team to complete\",\n          items: {\n            type: \"object\",\n            properties: {\n              description: {\n                type: \"string\",\n                description: \"Clear task description with completion criteria\",\n              },\n              model: {\n                type: \"string\",\n                description: \"Model for this task: haiku (lookups), sonnet (analysis), opus (complex reasoning). Overrides team default.\",\n              },\n              files: {\n                type: \"array\",\n                items: { type: \"string\" },\n                description: \"Files this task will modify (for conflict prevention)\",\n              },\n              dependencies: {\n                type: \"array\",\n                items: { type: \"string\" },\n                description: \"Task descriptions that must complete first\",\n              },\n            },\n            required: [\"description\"],\n          },\n        },\n      },\n      required: [\"name\", \"teammate_count\", \"tasks\"],\n    },\n  },\n  {\n    name: \"team_auto\",\n    description: \"Auto-decompose a task and run it as a parallel agent team. AI breaks the task into sub-tasks with file ownership, spawns teammates, executes in parallel. Returns a team_id — use team_status to monitor progress and team_stop to kill stuck teammates.\",\n    input_schema: {\n      type: \"object\",\n      properties: {\n        task: {\n          type: \"string\",\n          description: \"The task to decompose and execute (e.g., 'Refactor all components to use TypeScript strict mode')\",\n        },\n        max_teammates: {\n          type: \"number\",\n          description: \"Maximum number of parallel teammates (default: 4, max: 6)\",\n        },\n        model: {\n          type: \"string\",\n          enum: [\"sonnet\", \"opus\", \"haiku\"],\n          description: \"Model for teammates (default: sonnet)\",\n        },\n        working_directory: {\n          type: \"string\",\n          description: \"Project directory to work in (default: cwd)\",\n        },\n      },\n      required: [\"task\"],\n    },\n  },\n];\n"],"mappings":"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","ignoreList":[]}

package/dist/cli/services/local-tools-agent-defs-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Agent Tool Definitions — Background processes, Config, LSP, Ask User, and Skill tools.
+ * Extracted from local-tools-agent-defs.ts for file size management.
+ */
+import type { LocalToolDefinition } from "./local-tools.js";
+export declare const UTILITY_TOOL_DEFINITIONS: LocalToolDefinition[];