@morphllm/morphsdk 0.2.53 → 0.2.54

package/dist/{chunk-2XNF3W7C.js → chunk-4HOUN5TW.js}

@@ -1,7 +1,8 @@
 import {
   WARP_GREP_DESCRIPTION,
+  WARP_GREP_TOOL_NAME,
   formatResult
-} from "./chunk-KYVR4QCG.js";
+} from "./chunk-D5ZSGQT4.js";
 import {
   runWarpGrep
 } from "./chunk-IFVROB4L.js";
@@ -23,7 +24,7 @@ var TOOL_PARAMETERS = {
 var warpGrepTool = {
   type: "function",
   function: {
-    name: "morph-warp-grep",
+    name: WARP_GREP_TOOL_NAME,
     description: WARP_GREP_DESCRIPTION,
     parameters: TOOL_PARAMETERS
   }
@@ -54,7 +55,7 @@ function createMorphWarpGrepTool(config) {
   const tool = {
     type: "function",
     function: {
-      name: "morph-warp-grep",
+      name: config.name ?? WARP_GREP_TOOL_NAME,
       description: config.description ?? WARP_GREP_DESCRIPTION,
       parameters: TOOL_PARAMETERS
     }
@@ -79,4 +80,4 @@ export {
   createMorphWarpGrepTool,
   openai_default
 };
-//# sourceMappingURL=chunk-2XNF3W7C.js.map
+//# sourceMappingURL=chunk-4HOUN5TW.js.map

package/dist/chunk-4HOUN5TW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../tools/warp_grep/openai.ts"],"sourcesContent":["/**\n * OpenAI SDK adapter for morph-warp-grep tool\n */\n\nimport type { ChatCompletionTool } from 'openai/resources/chat/completions';\nimport { runWarpGrep } from './agent/runner.js';\nimport { LocalRipgrepProvider } from './providers/local.js';\nimport { WARP_GREP_DESCRIPTION, WARP_GREP_TOOL_NAME, getSystemPrompt } from './prompts.js';\nimport { formatResult } from './core.js';\nimport type { WarpGrepToolConfig, WarpGrepResult, WarpGrepContext } from './types.js';\n\n/**\n * Input schema for the warp grep tool\n */\nconst TOOL_PARAMETERS = {\n  type: 'object',\n  properties: {\n    query: { type: 'string', description: 'Free-form repository question' },\n  },\n  required: ['query'],\n} as const;\n\n/**\n * OpenAI-native warp grep tool definition\n * \n * @example\n * ```typescript\n * import OpenAI from 'openai';\n * import { warpGrepTool, execute } from '@morphllm/morphsdk/tools/warp-grep/openai';\n * \n * const client = new OpenAI();\n * const response = await client.chat.completions.create({\n *   model: 'gpt-4o',\n *   tools: [warpGrepTool],\n *   messages: [{ role: 'user', content: 'Find authentication middleware' }]\n * });\n * \n * // Execute the tool call\n * const result = await execute({ query: '...' }, { repoRoot: '.' });\n * ```\n */\nexport const warpGrepTool: ChatCompletionTool = {\n  type: 'function',\n  function: {\n    name: WARP_GREP_TOOL_NAME,\n    description: WARP_GREP_DESCRIPTION,\n    parameters: TOOL_PARAMETERS,\n  },\n};\n\n/**\n * Execute warp grep search\n * \n * @param input - Tool input with query\n * @param config - Configuration with repoRoot and optional provider\n * @returns Search results\n */\nexport async function execute(\n  input: { query: string } | string,\n  config: WarpGrepToolConfig\n): Promise<WarpGrepResult> {\n  const parsed = typeof input === 'string' ? JSON.parse(input) : input;\n  const provider = config.provider ?? new LocalRipgrepProvider(config.repoRoot, config.excludes);\n  \n  const result = await runWarpGrep({\n    query: parsed.query,\n    repoRoot: config.repoRoot,\n    provider,\n    excludes: config.excludes,\n    includes: config.includes,\n    debug: config.debug ?? false,\n    apiKey: config.apiKey,\n  });\n\n  const finish = result.finish;\n  if (result.terminationReason !== 'completed' || !finish?.metadata) {\n    return { success: false, error: 'Search did not complete' };\n  }\n\n  const contexts: WarpGrepContext[] = (finish.resolved ?? []).map(r => ({\n    file: r.path,\n    content: r.content,\n  }));\n\n  return { success: true, contexts, summary: finish.payload };\n}\n\n// Re-export formatResult and getSystemPrompt for convenience\nexport { formatResult, getSystemPrompt };\n\n/**\n * Create a custom warp grep tool with configuration and methods\n * \n * @param config - Configuration options\n * @returns Tool definition with execute and formatResult methods\n * \n * @example\n * ```typescript\n * import OpenAI from 'openai';\n * import { createMorphWarpGrepTool } from '@morphllm/morphsdk/tools/warp-grep/openai';\n * \n * const tool = createMorphWarpGrepTool({\n *   repoRoot: '.',\n *   description: 'Custom tool description'\n * });\n * \n * const client = new OpenAI();\n * const response = await client.chat.completions.create({\n *   model: 'gpt-4o',\n *   tools: [tool],\n *   messages: [{ role: 'user', content: 'Find authentication middleware' }]\n * });\n * \n * // Execute and format\n * const result = await tool.execute(toolCallArgs);\n * const formatted = tool.formatResult(result);\n * ```\n */\nexport function createMorphWarpGrepTool(config: WarpGrepToolConfig) {\n  const tool: ChatCompletionTool = {\n    type: 'function',\n    function: {\n      name: config.name ?? WARP_GREP_TOOL_NAME,\n      description: config.description ?? WARP_GREP_DESCRIPTION,\n      parameters: TOOL_PARAMETERS,\n    },\n  };\n\n  return Object.assign(tool, {\n    execute: async (input: unknown): Promise<WarpGrepResult> => {\n      return execute(input as { query: string } | string, config);\n    },\n    formatResult: (result: WarpGrepResult): string => {\n      return formatResult(result);\n    },\n    getSystemPrompt: (): string => {\n      return getSystemPrompt();\n    },\n  });\n}\n\nexport default warpGrepTool;\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,IAAM,kBAAkB;AAAA,EACtB,MAAM;AAAA,EACN,YAAY;AAAA,IACV,OAAO,EAAE,MAAM,UAAU,aAAa,gCAAgC;AAAA,EACxE;AAAA,EACA,UAAU,CAAC,OAAO;AACpB;AAqBO,IAAM,eAAmC;AAAA,EAC9C,MAAM;AAAA,EACN,UAAU;AAAA,IACR,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,EACd;AACF;AASA,eAAsB,QACpB,OACA,QACyB;AACzB,QAAM,SAAS,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;AAC/D,QAAM,WAAW,OAAO,YAAY,IAAI,qBAAqB,OAAO,UAAU,OAAO,QAAQ;AAE7F,QAAM,SAAS,MAAM,YAAY;AAAA,IAC/B,OAAO,OAAO;AAAA,IACd,UAAU,OAAO;AAAA,IACjB;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,UAAU,OAAO;AAAA,IACjB,OAAO,OAAO,SAAS;AAAA,IACvB,QAAQ,OAAO;AAAA,EACjB,CAAC;AAED,QAAM,SAAS,OAAO;AACtB,MAAI,OAAO,sBAAsB,eAAe,CAAC,QAAQ,UAAU;AACjE,WAAO,EAAE,SAAS,OAAO,OAAO,0BAA0B;AAAA,EAC5D;AAEA,QAAM,YAA+B,OAAO,YAAY,CAAC,GAAG,IAAI,QAAM;AAAA,IACpE,MAAM,EAAE;AAAA,IACR,SAAS,EAAE;AAAA,EACb,EAAE;AAEF,SAAO,EAAE,SAAS,MAAM,UAAU,SAAS,OAAO,QAAQ;AAC5D;AAiCO,SAAS,wBAAwB,QAA4B;AAClE,QAAM,OAA2B;AAAA,IAC/B,MAAM;AAAA,IACN,UAAU;AAAA,MACR,MAAM,OAAO,QAAQ;AAAA,MACrB,aAAa,OAAO,eAAe;AAAA,MACnC,YAAY;AAAA,IACd;AAAA,EACF;AAEA,SAAO,OAAO,OAAO,MAAM;AAAA,IACzB,SAAS,OAAO,UAA4C;AAC1D,aAAO,QAAQ,OAAqC,MAAM;AAAA,IAC5D;AAAA,IACA,cAAc,CAAC,WAAmC;AAChD,aAAO,aAAa,MAAM;AAAA,IAC5B;AAAA,IACA,iBAAiB,MAAc;AAC7B,aAAO,gBAAgB;AAAA,IACzB;AAAA,EACF,CAAC;AACH;AAEA,IAAO,iBAAQ;","names":[]}

package/dist/{chunk-KYVR4QCG.js → chunk-D5ZSGQT4.js}

@@ -94,12 +94,14 @@ function formatResult(result) {
 }
 
 // tools/warp_grep/prompts.ts
-var WARP_GREP_DESCRIPTION = "ALWAYS use Warp Grep when you need to search a large chunk of code. Warp Grep is a fast and accurate tool that can search for all relevant context in a codebase. Warp Grep can be used for query types like: find function responsible for <small feature>; find code that does <description>; find code path for <big feature>; Where does <minimal error message> come from?; or any query of that type ";
+var WARP_GREP_TOOL_NAME = "warpgrep_codebase_search";
+var WARP_GREP_DESCRIPTION = 'IMPORTANT: If you need to explore the codebase to gather context, and the task does not involve a single file or function which is provided by name, you should ALWAYS use the warpgrep codebase search tool first instead of running search commands. When the task requires exploration beyond a single known file, invoke warpgrep first with a natural-language query describing the target functionality, bug, or architectural concern. Warp Grep is a fast and accurate tool that can search for all relevant context in a codebase. Keep queries action-oriented (e.g., "Find where billing invoices are generated and emailed"), and after reviewing the summarized results, you may verify important findings with other search tools or direct file reads to ensure completeness. Warp Grep can be used for query types like: find function responsible for <small feature>; find code that does <description>; find code path for <big feature>; Where does <minimal error message> come from?; or any query of that type. When a task requires exploration beyond a single known file, ALWAYS default to warpgrep codebase search before other search mechanisms.';
 
 export {
   WarpGrepClient,
   executeWarpGrep,
   formatResult,
+  WARP_GREP_TOOL_NAME,
   WARP_GREP_DESCRIPTION
 };
-//# sourceMappingURL=chunk-KYVR4QCG.js.map
+//# sourceMappingURL=chunk-D5ZSGQT4.js.map

package/dist/{chunk-KYVR4QCG.js.map → chunk-D5ZSGQT4.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../tools/warp_grep/core.ts","../tools/warp_grep/prompts.ts"],"sourcesContent":["/**\n * Core implementation for morph-warp-grep\n * Provides a client class for programmatic code search\n */\n\nimport { runWarpGrep } from './agent/runner.js';\nimport { LocalRipgrepProvider } from './providers/local.js';\nimport type { \n  WarpGrepClientConfig, \n  WarpGrepInput, \n  WarpGrepResult,\n  WarpGrepContext,\n} from './types.js';\n\n/**\n * WarpGrep client for programmatic code search\n * \n * @example\n * ```typescript\n * import { WarpGrepClient } from '@morphllm/morphsdk';\n * \n * const client = new WarpGrepClient({ apiKey: process.env.MORPH_API_KEY });\n * \n * // Simple usage - defaults to LocalRipgrepProvider\n * const result = await client.execute({\n *   query: 'Find authentication middleware',\n *   repoRoot: '.'\n * });\n * \n * // With custom excludes\n * const result = await client.execute({\n *   query: 'Find database models',\n *   repoRoot: '.',\n *   excludes: ['node_modules', '.git', 'dist']\n * });\n * ```\n */\nexport class WarpGrepClient {\n  private config: WarpGrepClientConfig;\n\n  constructor(config: WarpGrepClientConfig = {}) {\n    this.config = {\n      apiKey: config.apiKey,\n      debug: config.debug,\n      timeout: config.timeout,\n      retryConfig: config.retryConfig,\n    };\n  }\n\n  /**\n   * Execute a code search query\n   * \n   * @param input - Search parameters including query, repoRoot, and optional provider\n   * @returns Search results with relevant code contexts\n   * \n   * @example\n   * ```typescript\n   * const result = await client.execute({\n   *   query: 'Find authentication middleware',\n   *   repoRoot: '.'\n   * });\n   * \n   * if (result.success) {\n   *   for (const ctx of result.contexts) {\n   *     console.log(`File: ${ctx.file}`);\n   *     console.log(ctx.content);\n   *   }\n   * }\n   * ```\n   */\n  async execute(input: WarpGrepInput): Promise<WarpGrepResult> {\n    // Default to LocalRipgrepProvider if no provider specified\n    const provider = input.provider ?? new LocalRipgrepProvider(input.repoRoot, input.excludes);\n    \n    const result = await runWarpGrep({\n      query: input.query,\n      repoRoot: input.repoRoot,\n      provider,\n      excludes: input.excludes,\n      includes: input.includes,\n      debug: input.debug ?? this.config.debug ?? false,\n      apiKey: this.config.apiKey,\n    });\n\n    const finish = result.finish;\n    if (result.terminationReason !== 'completed' || !finish?.metadata) {\n      return { \n        success: false, \n        error: 'Search did not complete',\n      };\n    }\n\n    const contexts: WarpGrepContext[] = (finish.resolved ?? []).map(r => ({\n      file: r.path,\n      content: r.content,\n    }));\n\n    return { \n      success: true, \n      contexts, \n      summary: finish.payload,\n    };\n  }\n}\n\n/**\n * Execute a warp grep search directly\n * \n * @param input - Search parameters\n * @param config - Optional client configuration\n * @returns Search results\n * \n * @example\n * ```typescript\n * import { executeWarpGrep } from '@morphllm/morphsdk/tools/warp-grep';\n * \n * const result = await executeWarpGrep({\n *   query: 'Find authentication middleware',\n *   repoRoot: '.'\n * });\n * ```\n */\nexport async function executeWarpGrep(\n  input: WarpGrepInput,\n  config?: WarpGrepClientConfig\n): Promise<WarpGrepResult> {\n  const client = new WarpGrepClient(config);\n  return client.execute(input);\n}\n\n/**\n * Format warp grep results for display or tool responses\n * \n * @param result - The search result\n * @returns Formatted string representation\n */\nexport function formatResult(result: WarpGrepResult): string {\n  if (!result.success) {\n    return `Search failed: ${result.error}`;\n  }\n\n  if (!result.contexts || result.contexts.length === 0) {\n    return 'No relevant code found. Try rephrasing your query.';\n  }\n\n  const lines: string[] = [];\n  lines.push(`Found ${result.contexts.length} relevant code sections:\\n`);\n\n  result.contexts.forEach((ctx, i) => {\n    lines.push(`${i + 1}. ${ctx.file}`);\n    lines.push('```');\n    lines.push(ctx.content);\n    lines.push('```');\n    lines.push('');\n  });\n\n  if (result.summary) {\n    lines.push(`Summary: ${result.summary}`);\n  }\n\n  return lines.join('\\n');\n}\n\n","/**\n * Prompts and descriptions for morph-warp-grep\n */\n\n/**\n * Default tool description for the warp grep tool\n */\nexport const WARP_GREP_DESCRIPTION = \n  'ALWAYS use Warp Grep when you need to search a large chunk of code. ' +\n  'Warp Grep is a fast and accurate tool that can search for all relevant context in a codebase. ' +\n  'Warp Grep can be used for query types like: find function responsible for <small feature>; find code that does <description>; find code path for <big feature>; Where does <minimal error message> come from?; or any query of that type '\n\n/**\n * System prompt for the warp grep agent\n * Re-exported from agent/prompt.ts for convenience\n */\nexport { SYSTEM_PROMPT as WARP_GREP_SYSTEM_PROMPT, getSystemPrompt } from './agent/prompt.js';\n\n"],"mappings":";;;;;;;;AAqCO,IAAM,iBAAN,MAAqB;AAAA,EAClB;AAAA,EAER,YAAY,SAA+B,CAAC,GAAG;AAC7C,SAAK,SAAS;AAAA,MACZ,QAAQ,OAAO;AAAA,MACf,OAAO,OAAO;AAAA,MACd,SAAS,OAAO;AAAA,MAChB,aAAa,OAAO;AAAA,IACtB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBA,MAAM,QAAQ,OAA+C;AAE3D,UAAM,WAAW,MAAM,YAAY,IAAI,qBAAqB,MAAM,UAAU,MAAM,QAAQ;AAE1F,UAAM,SAAS,MAAM,YAAY;AAAA,MAC/B,OAAO,MAAM;AAAA,MACb,UAAU,MAAM;AAAA,MAChB;AAAA,MACA,UAAU,MAAM;AAAA,MAChB,UAAU,MAAM;AAAA,MAChB,OAAO,MAAM,SAAS,KAAK,OAAO,SAAS;AAAA,MAC3C,QAAQ,KAAK,OAAO;AAAA,IACtB,CAAC;AAED,UAAM,SAAS,OAAO;AACtB,QAAI,OAAO,sBAAsB,eAAe,CAAC,QAAQ,UAAU;AACjE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,YAA+B,OAAO,YAAY,CAAC,GAAG,IAAI,QAAM;AAAA,MACpE,MAAM,EAAE;AAAA,MACR,SAAS,EAAE;AAAA,IACb,EAAE;AAEF,WAAO;AAAA,MACL,SAAS;AAAA,MACT;AAAA,MACA,SAAS,OAAO;AAAA,IAClB;AAAA,EACF;AACF;AAmBA,eAAsB,gBACpB,OACA,QACyB;AACzB,QAAM,SAAS,IAAI,eAAe,MAAM;AACxC,SAAO,OAAO,QAAQ,KAAK;AAC7B;AAQO,SAAS,aAAa,QAAgC;AAC3D,MAAI,CAAC,OAAO,SAAS;AACnB,WAAO,kBAAkB,OAAO,KAAK;AAAA,EACvC;AAEA,MAAI,CAAC,OAAO,YAAY,OAAO,SAAS,WAAW,GAAG;AACpD,WAAO;AAAA,EACT;AAEA,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,SAAS,OAAO,SAAS,MAAM;AAAA,CAA4B;AAEtE,SAAO,SAAS,QAAQ,CAAC,KAAK,MAAM;AAClC,UAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE;AAClC,UAAM,KAAK,KAAK;AAChB,UAAM,KAAK,IAAI,OAAO;AACtB,UAAM,KAAK,KAAK;AAChB,UAAM,KAAK,EAAE;AAAA,EACf,CAAC;AAED,MAAI,OAAO,SAAS;AAClB,UAAM,KAAK,YAAY,OAAO,OAAO,EAAE;AAAA,EACzC;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;;;AC1JO,IAAM,wBACX;","names":[]}
+{"version":3,"sources":["../tools/warp_grep/core.ts","../tools/warp_grep/prompts.ts"],"sourcesContent":["/**\n * Core implementation for morph-warp-grep\n * Provides a client class for programmatic code search\n */\n\nimport { runWarpGrep } from './agent/runner.js';\nimport { LocalRipgrepProvider } from './providers/local.js';\nimport type { \n  WarpGrepClientConfig, \n  WarpGrepInput, \n  WarpGrepResult,\n  WarpGrepContext,\n} from './types.js';\n\n/**\n * WarpGrep client for programmatic code search\n * \n * @example\n * ```typescript\n * import { WarpGrepClient } from '@morphllm/morphsdk';\n * \n * const client = new WarpGrepClient({ apiKey: process.env.MORPH_API_KEY });\n * \n * // Simple usage - defaults to LocalRipgrepProvider\n * const result = await client.execute({\n *   query: 'Find authentication middleware',\n *   repoRoot: '.'\n * });\n * \n * // With custom excludes\n * const result = await client.execute({\n *   query: 'Find database models',\n *   repoRoot: '.',\n *   excludes: ['node_modules', '.git', 'dist']\n * });\n * ```\n */\nexport class WarpGrepClient {\n  private config: WarpGrepClientConfig;\n\n  constructor(config: WarpGrepClientConfig = {}) {\n    this.config = {\n      apiKey: config.apiKey,\n      debug: config.debug,\n      timeout: config.timeout,\n      retryConfig: config.retryConfig,\n    };\n  }\n\n  /**\n   * Execute a code search query\n   * \n   * @param input - Search parameters including query, repoRoot, and optional provider\n   * @returns Search results with relevant code contexts\n   * \n   * @example\n   * ```typescript\n   * const result = await client.execute({\n   *   query: 'Find authentication middleware',\n   *   repoRoot: '.'\n   * });\n   * \n   * if (result.success) {\n   *   for (const ctx of result.contexts) {\n   *     console.log(`File: ${ctx.file}`);\n   *     console.log(ctx.content);\n   *   }\n   * }\n   * ```\n   */\n  async execute(input: WarpGrepInput): Promise<WarpGrepResult> {\n    // Default to LocalRipgrepProvider if no provider specified\n    const provider = input.provider ?? new LocalRipgrepProvider(input.repoRoot, input.excludes);\n    \n    const result = await runWarpGrep({\n      query: input.query,\n      repoRoot: input.repoRoot,\n      provider,\n      excludes: input.excludes,\n      includes: input.includes,\n      debug: input.debug ?? this.config.debug ?? false,\n      apiKey: this.config.apiKey,\n    });\n\n    const finish = result.finish;\n    if (result.terminationReason !== 'completed' || !finish?.metadata) {\n      return { \n        success: false, \n        error: 'Search did not complete',\n      };\n    }\n\n    const contexts: WarpGrepContext[] = (finish.resolved ?? []).map(r => ({\n      file: r.path,\n      content: r.content,\n    }));\n\n    return { \n      success: true, \n      contexts, \n      summary: finish.payload,\n    };\n  }\n}\n\n/**\n * Execute a warp grep search directly\n * \n * @param input - Search parameters\n * @param config - Optional client configuration\n * @returns Search results\n * \n * @example\n * ```typescript\n * import { executeWarpGrep } from '@morphllm/morphsdk/tools/warp-grep';\n * \n * const result = await executeWarpGrep({\n *   query: 'Find authentication middleware',\n *   repoRoot: '.'\n * });\n * ```\n */\nexport async function executeWarpGrep(\n  input: WarpGrepInput,\n  config?: WarpGrepClientConfig\n): Promise<WarpGrepResult> {\n  const client = new WarpGrepClient(config);\n  return client.execute(input);\n}\n\n/**\n * Format warp grep results for display or tool responses\n * \n * @param result - The search result\n * @returns Formatted string representation\n */\nexport function formatResult(result: WarpGrepResult): string {\n  if (!result.success) {\n    return `Search failed: ${result.error}`;\n  }\n\n  if (!result.contexts || result.contexts.length === 0) {\n    return 'No relevant code found. Try rephrasing your query.';\n  }\n\n  const lines: string[] = [];\n  lines.push(`Found ${result.contexts.length} relevant code sections:\\n`);\n\n  result.contexts.forEach((ctx, i) => {\n    lines.push(`${i + 1}. ${ctx.file}`);\n    lines.push('```');\n    lines.push(ctx.content);\n    lines.push('```');\n    lines.push('');\n  });\n\n  if (result.summary) {\n    lines.push(`Summary: ${result.summary}`);\n  }\n\n  return lines.join('\\n');\n}\n\n","/**\n * Prompts and descriptions for warpgrep_codebase_search\n */\n\n/**\n * Default tool name for the warp grep tool\n */\nexport const WARP_GREP_TOOL_NAME = 'warpgrep_codebase_search';\n\n/**\n * Default tool description for the warp grep tool\n */\nexport const WARP_GREP_DESCRIPTION = \n  'IMPORTANT: If you need to explore the codebase to gather context, and the task does not involve a single file or function which is provided by name, you should ALWAYS use the warpgrep codebase search tool first instead of running search commands. ' +\n  'When the task requires exploration beyond a single known file, invoke warpgrep first with a natural-language query describing the target functionality, bug, or architectural concern. ' +\n  'Warp Grep is a fast and accurate tool that can search for all relevant context in a codebase. ' +\n  'Keep queries action-oriented (e.g., \"Find where billing invoices are generated and emailed\"), and after reviewing the summarized results, you may verify important findings with other search tools or direct file reads to ensure completeness. ' +\n  'Warp Grep can be used for query types like: find function responsible for <small feature>; find code that does <description>; find code path for <big feature>; Where does <minimal error message> come from?; or any query of that type. ' +\n  'When a task requires exploration beyond a single known file, ALWAYS default to warpgrep codebase search before other search mechanisms.'\n\n/**\n * System prompt for the warp grep agent\n * Re-exported from agent/prompt.ts for convenience\n */\nexport { SYSTEM_PROMPT as WARP_GREP_SYSTEM_PROMPT, getSystemPrompt } from './agent/prompt.js';\n"],"mappings":";;;;;;;;AAqCO,IAAM,iBAAN,MAAqB;AAAA,EAClB;AAAA,EAER,YAAY,SAA+B,CAAC,GAAG;AAC7C,SAAK,SAAS;AAAA,MACZ,QAAQ,OAAO;AAAA,MACf,OAAO,OAAO;AAAA,MACd,SAAS,OAAO;AAAA,MAChB,aAAa,OAAO;AAAA,IACtB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBA,MAAM,QAAQ,OAA+C;AAE3D,UAAM,WAAW,MAAM,YAAY,IAAI,qBAAqB,MAAM,UAAU,MAAM,QAAQ;AAE1F,UAAM,SAAS,MAAM,YAAY;AAAA,MAC/B,OAAO,MAAM;AAAA,MACb,UAAU,MAAM;AAAA,MAChB;AAAA,MACA,UAAU,MAAM;AAAA,MAChB,UAAU,MAAM;AAAA,MAChB,OAAO,MAAM,SAAS,KAAK,OAAO,SAAS;AAAA,MAC3C,QAAQ,KAAK,OAAO;AAAA,IACtB,CAAC;AAED,UAAM,SAAS,OAAO;AACtB,QAAI,OAAO,sBAAsB,eAAe,CAAC,QAAQ,UAAU;AACjE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,YAA+B,OAAO,YAAY,CAAC,GAAG,IAAI,QAAM;AAAA,MACpE,MAAM,EAAE;AAAA,MACR,SAAS,EAAE;AAAA,IACb,EAAE;AAEF,WAAO;AAAA,MACL,SAAS;AAAA,MACT;AAAA,MACA,SAAS,OAAO;AAAA,IAClB;AAAA,EACF;AACF;AAmBA,eAAsB,gBACpB,OACA,QACyB;AACzB,QAAM,SAAS,IAAI,eAAe,MAAM;AACxC,SAAO,OAAO,QAAQ,KAAK;AAC7B;AAQO,SAAS,aAAa,QAAgC;AAC3D,MAAI,CAAC,OAAO,SAAS;AACnB,WAAO,kBAAkB,OAAO,KAAK;AAAA,EACvC;AAEA,MAAI,CAAC,OAAO,YAAY,OAAO,SAAS,WAAW,GAAG;AACpD,WAAO;AAAA,EACT;AAEA,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,SAAS,OAAO,SAAS,MAAM;AAAA,CAA4B;AAEtE,SAAO,SAAS,QAAQ,CAAC,KAAK,MAAM;AAClC,UAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE;AAClC,UAAM,KAAK,KAAK;AAChB,UAAM,KAAK,IAAI,OAAO;AACtB,UAAM,KAAK,KAAK;AAChB,UAAM,KAAK,EAAE;AAAA,EACf,CAAC;AAED,MAAI,OAAO,SAAS;AAClB,UAAM,KAAK,YAAY,OAAO,OAAO,EAAE;AAAA,EACzC;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;;;AC1JO,IAAM,sBAAsB;AAK5B,IAAM,wBACX;","names":[]}

package/dist/{chunk-C4IXE2RM.js → chunk-FB3E5BRY.js}

@@ -1,7 +1,8 @@
 import {
   WARP_GREP_DESCRIPTION,
+  WARP_GREP_TOOL_NAME,
   formatResult
-} from "./chunk-KYVR4QCG.js";
+} from "./chunk-D5ZSGQT4.js";
 import {
   runWarpGrep
 } from "./chunk-IFVROB4L.js";
@@ -21,7 +22,7 @@ var INPUT_SCHEMA = {
   required: ["query"]
 };
 var warpGrepTool = {
-  name: "morph-warp-grep",
+  name: WARP_GREP_TOOL_NAME,
   description: WARP_GREP_DESCRIPTION,
   input_schema: INPUT_SCHEMA
 };
@@ -49,7 +50,7 @@ async function execute(input, config) {
 }
 function createMorphWarpGrepTool(config) {
   const tool = {
-    name: "morph-warp-grep",
+    name: config.name ?? WARP_GREP_TOOL_NAME,
     description: config.description ?? WARP_GREP_DESCRIPTION,
     input_schema: INPUT_SCHEMA
   };
@@ -73,4 +74,4 @@ export {
   createMorphWarpGrepTool,
   anthropic_default
 };
-//# sourceMappingURL=chunk-C4IXE2RM.js.map
+//# sourceMappingURL=chunk-FB3E5BRY.js.map

package/dist/chunk-FB3E5BRY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../tools/warp_grep/anthropic.ts"],"sourcesContent":["/**\n * Anthropic SDK adapter for morph-warp-grep tool\n */\n\nimport type { Tool } from '@anthropic-ai/sdk/resources/messages';\nimport { runWarpGrep } from './agent/runner.js';\nimport { LocalRipgrepProvider } from './providers/local.js';\nimport { WARP_GREP_DESCRIPTION, WARP_GREP_TOOL_NAME, getSystemPrompt } from './prompts.js';\nimport { formatResult } from './core.js';\nimport type { WarpGrepToolConfig, WarpGrepResult, WarpGrepContext } from './types.js';\n\n/**\n * Input schema for the warp grep tool\n */\nconst INPUT_SCHEMA = {\n  type: 'object',\n  properties: {\n    query: { type: 'string', description: 'Free-form repository question' },\n  },\n  required: ['query'],\n} as const;\n\n/**\n * Anthropic-native warp grep tool definition\n * \n * @example\n * ```typescript\n * import Anthropic from '@anthropic-ai/sdk';\n * import { warpGrepTool, execute } from '@morphllm/morphsdk/tools/warp-grep/anthropic';\n * \n * const client = new Anthropic();\n * const response = await client.messages.create({\n *   model: 'claude-sonnet-4-5-20250929',\n *   tools: [warpGrepTool],\n *   messages: [{ role: 'user', content: 'Find authentication middleware' }]\n * });\n * \n * // Execute the tool call\n * const result = await execute({ query: '...' }, { repoRoot: '.' });\n * ```\n */\nexport const warpGrepTool: Tool = {\n  name: WARP_GREP_TOOL_NAME,\n  description: WARP_GREP_DESCRIPTION,\n  input_schema: INPUT_SCHEMA,\n};\n\n/**\n * Execute warp grep search\n * \n * @param input - Tool input with query\n * @param config - Configuration with repoRoot and optional provider\n * @returns Search results\n */\nexport async function execute(\n  input: { query: string } | string,\n  config: WarpGrepToolConfig\n): Promise<WarpGrepResult> {\n  const parsed = typeof input === 'string' ? JSON.parse(input) : input;\n  const provider = config.provider ?? new LocalRipgrepProvider(config.repoRoot, config.excludes);\n  \n  const result = await runWarpGrep({\n    query: parsed.query,\n    repoRoot: config.repoRoot,\n    provider,\n    excludes: config.excludes,\n    includes: config.includes,\n    debug: config.debug ?? false,\n    apiKey: config.apiKey,\n  });\n\n  const finish = result.finish;\n  if (result.terminationReason !== 'completed' || !finish?.metadata) {\n    return { success: false, error: 'Search did not complete' };\n  }\n\n  const contexts: WarpGrepContext[] = (finish.resolved ?? []).map(r => ({\n    file: r.path,\n    content: r.content,\n  }));\n\n  return { success: true, contexts, summary: finish.payload };\n}\n\n// Re-export formatResult and getSystemPrompt for convenience\nexport { formatResult, getSystemPrompt };\n\n/**\n * Create a custom warp grep tool with configuration and methods\n * \n * @param config - Configuration options\n * @returns Tool definition with execute and formatResult methods\n * \n * @example\n * ```typescript\n * import Anthropic from '@anthropic-ai/sdk';\n * import { createMorphWarpGrepTool } from '@morphllm/morphsdk/tools/warp-grep/anthropic';\n * \n * const tool = createMorphWarpGrepTool({\n *   repoRoot: '.',\n *   description: 'Custom tool description'\n * });\n * \n * const client = new Anthropic();\n * const response = await client.messages.create({\n *   model: 'claude-sonnet-4-5-20250929',\n *   tools: [tool],\n *   messages: [{ role: 'user', content: 'Find authentication middleware' }]\n * });\n * \n * // Execute and format\n * const result = await tool.execute(toolUseBlock.input);\n * const formatted = tool.formatResult(result);\n * ```\n */\nexport function createMorphWarpGrepTool(config: WarpGrepToolConfig) {\n  const tool: Tool = {\n    name: config.name ?? WARP_GREP_TOOL_NAME,\n    description: config.description ?? WARP_GREP_DESCRIPTION,\n    input_schema: INPUT_SCHEMA,\n  };\n\n  return Object.assign(tool, {\n    execute: async (input: unknown): Promise<WarpGrepResult> => {\n      return execute(input as { query: string } | string, config);\n    },\n    formatResult: (result: WarpGrepResult): string => {\n      return formatResult(result);\n    },\n    getSystemPrompt: (): string => {\n      return getSystemPrompt();\n    },\n  });\n}\n\nexport default warpGrepTool;\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,IAAM,eAAe;AAAA,EACnB,MAAM;AAAA,EACN,YAAY;AAAA,IACV,OAAO,EAAE,MAAM,UAAU,aAAa,gCAAgC;AAAA,EACxE;AAAA,EACA,UAAU,CAAC,OAAO;AACpB;AAqBO,IAAM,eAAqB;AAAA,EAChC,MAAM;AAAA,EACN,aAAa;AAAA,EACb,cAAc;AAChB;AASA,eAAsB,QACpB,OACA,QACyB;AACzB,QAAM,SAAS,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;AAC/D,QAAM,WAAW,OAAO,YAAY,IAAI,qBAAqB,OAAO,UAAU,OAAO,QAAQ;AAE7F,QAAM,SAAS,MAAM,YAAY;AAAA,IAC/B,OAAO,OAAO;AAAA,IACd,UAAU,OAAO;AAAA,IACjB;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,UAAU,OAAO;AAAA,IACjB,OAAO,OAAO,SAAS;AAAA,IACvB,QAAQ,OAAO;AAAA,EACjB,CAAC;AAED,QAAM,SAAS,OAAO;AACtB,MAAI,OAAO,sBAAsB,eAAe,CAAC,QAAQ,UAAU;AACjE,WAAO,EAAE,SAAS,OAAO,OAAO,0BAA0B;AAAA,EAC5D;AAEA,QAAM,YAA+B,OAAO,YAAY,CAAC,GAAG,IAAI,QAAM;AAAA,IACpE,MAAM,EAAE;AAAA,IACR,SAAS,EAAE;AAAA,EACb,EAAE;AAEF,SAAO,EAAE,SAAS,MAAM,UAAU,SAAS,OAAO,QAAQ;AAC5D;AAiCO,SAAS,wBAAwB,QAA4B;AAClE,QAAM,OAAa;AAAA,IACjB,MAAM,OAAO,QAAQ;AAAA,IACrB,aAAa,OAAO,eAAe;AAAA,IACnC,cAAc;AAAA,EAChB;AAEA,SAAO,OAAO,OAAO,MAAM;AAAA,IACzB,SAAS,OAAO,UAA4C;AAC1D,aAAO,QAAQ,OAAqC,MAAM;AAAA,IAC5D;AAAA,IACA,cAAc,CAAC,WAAmC;AAChD,aAAO,aAAa,MAAM;AAAA,IAC5B;AAAA,IACA,iBAAiB,MAAc;AAC7B,aAAO,gBAAgB;AAAA,IACzB;AAAA,EACF,CAAC;AACH;AAEA,IAAO,oBAAQ;","names":[]}

package/dist/{chunk-NOQCKVY3.js → chunk-KVMZPOUT.js}

@@ -1,15 +1,15 @@
 import {
   createMorphWarpGrepTool as createMorphWarpGrepTool2
-} from "./chunk-C4IXE2RM.js";
+} from "./chunk-FB3E5BRY.js";
 import {
   createMorphWarpGrepTool
-} from "./chunk-2XNF3W7C.js";
+} from "./chunk-4HOUN5TW.js";
 import {
   createMorphWarpGrepTool as createMorphWarpGrepTool3
-} from "./chunk-563REN2T.js";
+} from "./chunk-PYTBBWL6.js";
 import {
   WarpGrepClient
-} from "./chunk-KYVR4QCG.js";
+} from "./chunk-D5ZSGQT4.js";
 import {
   createCodebaseSearchTool as createCodebaseSearchTool3
 } from "./chunk-UBX7QYBD.js";
@@ -280,4 +280,4 @@ export {
   VercelToolFactory,
   MorphClient
 };
-//# sourceMappingURL=chunk-NOQCKVY3.js.map
+//# sourceMappingURL=chunk-KVMZPOUT.js.map

package/dist/{chunk-563REN2T.js → chunk-PYTBBWL6.js}

@@ -1,6 +1,6 @@
 import {
   WARP_GREP_DESCRIPTION
-} from "./chunk-KYVR4QCG.js";
+} from "./chunk-D5ZSGQT4.js";
 import {
   runWarpGrep
 } from "./chunk-IFVROB4L.js";
@@ -67,4 +67,4 @@ export {
   execute,
   createMorphWarpGrepTool
 };
-//# sourceMappingURL=chunk-563REN2T.js.map
+//# sourceMappingURL=chunk-PYTBBWL6.js.map

package/dist/{client-BGctTHu9.d.ts → client-CFoR--IU.d.ts}

@@ -2,7 +2,7 @@ import { RetryConfig } from './tools/utils/resilience.js';
 import { FastApplyClient } from './tools/fastapply/core.js';
 import { CodebaseSearchClient } from './tools/codebase_search/core.js';
 import { BrowserClient } from './tools/browser/core.js';
-import { e as WarpGrepToolConfig, c as WarpGrepResult, d as WarpGrepContext, W as WarpGrepClient } from './core-DxiUwyBe.js';
+import { e as WarpGrepToolConfig, c as WarpGrepResult, d as WarpGrepContext, W as WarpGrepClient } from './core-CpkYEi_T.js';
 import { MorphGit } from './git/client.js';
 import { OpenAIRouter, AnthropicRouter, GeminiRouter, RawRouter } from './modelrouter/core.js';
 import { EditFileConfig, EditFileInput, EditFileResult, EditChanges } from './tools/fastapply/types.js';

package/dist/client.cjs

@@ -2874,7 +2874,8 @@ var RawRouter = class extends BaseRouter {
 };
 
 // tools/warp_grep/prompts.ts
-var WARP_GREP_DESCRIPTION = "ALWAYS use Warp Grep when you need to search a large chunk of code. Warp Grep is a fast and accurate tool that can search for all relevant context in a codebase. Warp Grep can be used for query types like: find function responsible for <small feature>; find code that does <description>; find code path for <big feature>; Where does <minimal error message> come from?; or any query of that type ";
+var WARP_GREP_TOOL_NAME = "warpgrep_codebase_search";
+var WARP_GREP_DESCRIPTION = 'IMPORTANT: If you need to explore the codebase to gather context, and the task does not involve a single file or function which is provided by name, you should ALWAYS use the warpgrep codebase search tool first instead of running search commands. When the task requires exploration beyond a single known file, invoke warpgrep first with a natural-language query describing the target functionality, bug, or architectural concern. Warp Grep is a fast and accurate tool that can search for all relevant context in a codebase. Keep queries action-oriented (e.g., "Find where billing invoices are generated and emailed"), and after reviewing the summarized results, you may verify important findings with other search tools or direct file reads to ensure completeness. Warp Grep can be used for query types like: find function responsible for <small feature>; find code that does <description>; find code path for <big feature>; Where does <minimal error message> come from?; or any query of that type. When a task requires exploration beyond a single known file, ALWAYS default to warpgrep codebase search before other search mechanisms.';
 
 // tools/warp_grep/openai.ts
 var TOOL_PARAMETERS = {
@@ -2910,7 +2911,7 @@ function createMorphWarpGrepTool(config) {
   const tool4 = {
     type: "function",
     function: {
-      name: "morph-warp-grep",
+      name: config.name ?? WARP_GREP_TOOL_NAME,
       description: config.description ?? WARP_GREP_DESCRIPTION,
       parameters: TOOL_PARAMETERS
     }
@@ -3217,7 +3218,7 @@ async function execute3(input, config) {
 }
 function createMorphWarpGrepTool2(config) {
   const tool4 = {
-    name: "morph-warp-grep",
+    name: config.name ?? WARP_GREP_TOOL_NAME,
     description: config.description ?? WARP_GREP_DESCRIPTION,
     input_schema: INPUT_SCHEMA
   };