@morphllm/morphsdk 0.2.161 → 0.2.163

package/dist/tools/warp_grep/gemini.js

@@ -12,9 +12,9 @@ import {
   executeToolCall,
   formatGitHubReadFileResult,
   formatResult
-} from "../../chunk-LGF2WTXG.js";
+} from "../../chunk-LSHQISAX.js";
 import "../../chunk-63VHBANJ.js";
-import "../../chunk-CMRUAJYD.js";
+import "../../chunk-ZMCDGAGF.js";
 import "../../chunk-GVGJIXV2.js";
 import "../../chunk-B3AKP3RA.js";
 import "../../chunk-VNAGVCSP.js";
@@ -22,7 +22,8 @@ import "../../chunk-FBRNUWEB.js";
 import "../../chunk-I3J46TSB.js";
 import "../../chunk-GLQWEINZ.js";
 import "../../chunk-SCVWDNQP.js";
-import "../../chunk-L6WYOSFK.js";
+import "../../chunk-5AM23TC7.js";
+import "../../chunk-LST7MZOZ.js";
 import "../../chunk-PZ5AY32C.js";
 
 // tools/warp_grep/gemini.ts

package/dist/tools/warp_grep/gemini.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../tools/warp_grep/gemini.ts"],"sourcesContent":["/**\n * Google Gemini SDK adapter for morph-warp-grep tool\n * \n * Requires @google/generative-ai as a peer dependency.\n * Install with: npm install @google/generative-ai\n */\n\nimport type { FunctionDeclaration, FunctionDeclarationSchema } from '@google/generative-ai';\nimport { executeToolCall, formatResult, WarpGrepClient, executeGitHubReadFile, formatGitHubReadFileResult } from './client.js';\nimport { WARP_GREP_DESCRIPTION, WARP_GREP_TOOL_NAME, GITHUB_SEARCH_TOOL_NAME, GITHUB_SEARCH_DESCRIPTION, GITHUB_READ_FILE_TOOL_NAME, GITHUB_READ_FILE_DESCRIPTION, GITHUB_READ_FILE_INPUT_SCHEMA } from './prompts.js';\nimport type { WarpGrepToolConfig, WarpGrepResult, GitHubSearchToolConfig, GitHubReadFileInput, GitHubReadFileResult, GitHubReadFileToolConfig } from './types.js';\n\n// Use plain object to avoid runtime import of SchemaType enum\nconst TOOL_PARAMETERS = {\n  type: 'OBJECT',\n  properties: {\n    search_term: { \n      type: 'STRING', \n      description: 'Search problem statement that this subagent is supposed to research for' \n    },\n  },\n  required: ['search_term'],\n} as unknown as FunctionDeclarationSchema;\n\n/**\n * Gemini-native warp grep function declaration\n * \n * @example\n * ```typescript\n * import { GoogleGenerativeAI } from '@google/generative-ai';\n * import { warpGrepFunctionDeclaration, execute } from '@morphllm/morphsdk/tools/warp-grep/gemini';\n * \n * const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);\n * const model = genAI.getGenerativeModel({\n *   model: 'gemini-2.0-flash',\n *   tools: [{ functionDeclarations: [warpGrepFunctionDeclaration] }]\n * });\n * \n * const chat = model.startChat();\n * const result = await chat.sendMessage('Find authentication middleware');\n * \n * // Handle function call\n * const call = result.response.functionCalls()?.[0];\n * if (call) {\n *   const searchResult = await execute(call.args, { repoRoot: '.' });\n *   console.log(searchResult);\n * }\n * ```\n */\nexport const warpGrepFunctionDeclaration: FunctionDeclaration = {\n  name: WARP_GREP_TOOL_NAME,\n  description: WARP_GREP_DESCRIPTION,\n  parameters: TOOL_PARAMETERS,\n};\n\n/**\n * Execute warp grep search\n * \n * @param input - Tool input with search_term\n * @param config - Configuration with repoRoot and optional provider\n * @returns Search results\n */\nexport async function execute(\n  input: { search_term: string } | string,\n  config: WarpGrepToolConfig\n): Promise<WarpGrepResult> {\n  return executeToolCall(input, config);\n}\n\nexport { formatResult };\n\n/**\n * Gemini tool with execute method attached\n */\nexport interface GeminiWarpGrepTool extends FunctionDeclaration {\n  execute: (input: unknown) => Promise<WarpGrepResult>;\n  formatResult: (result: WarpGrepResult) => string;\n}\n\n/**\n * Create a custom warp grep tool with configuration and methods\n * \n * @param config - Configuration options\n * @returns Function declaration with execute and formatResult methods\n * \n * @example Local usage\n * ```typescript\n * import { GoogleGenerativeAI } from '@google/generative-ai';\n * import { createMorphWarpGrepTool } from '@morphllm/morphsdk/tools/warp-grep/gemini';\n * \n * const tool = createMorphWarpGrepTool({ repoRoot: '.' });\n * \n * const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);\n * const model = genAI.getGenerativeModel({\n *   model: 'gemini-2.0-flash',\n *   tools: [{ functionDeclarations: [tool] }]\n * });\n * \n * const chat = model.startChat();\n * const result = await chat.sendMessage('Find authentication middleware');\n * \n * // Handle function call\n * const call = result.response.functionCalls()?.[0];\n * if (call && call.name === tool.name) {\n *   const searchResult = await tool.execute(call.args);\n *   console.log(tool.formatResult(searchResult));\n *   \n *   // Send result back to model\n *   await chat.sendMessage([{\n *     functionResponse: {\n *       name: call.name,\n *       response: { result: tool.formatResult(searchResult) }\n *     }\n *   }]);\n * }\n * ```\n * \n * @example Remote sandbox (E2B, Modal, etc.)\n * ```typescript\n * const tool = createMorphWarpGrepTool({\n *   repoRoot: '/home/repo',\n *   remoteCommands: {\n *     grep: async (pattern, path) => (await sandbox.run(`rg '${pattern}' '${path}'`)).stdout,\n *     read: async (path, start, end) => (await sandbox.run(`sed -n '${start},${end}p' '${path}'`)).stdout,\n *     listDir: async (path, maxDepth) => (await sandbox.run(`find '${path}' -maxdepth ${maxDepth}`)).stdout,\n *   },\n * });\n * ```\n */\nexport function createWarpGrepTool(config: WarpGrepToolConfig): GeminiWarpGrepTool {\n  const declaration: FunctionDeclaration = {\n    name: config.name ?? WARP_GREP_TOOL_NAME,\n    description: config.description ?? WARP_GREP_DESCRIPTION,\n    parameters: TOOL_PARAMETERS,\n  };\n\n  return Object.assign(declaration, {\n    execute: async (input: unknown): Promise<WarpGrepResult> => {\n      return executeToolCall(input as { search_term: string } | string, config);\n    },\n    formatResult: (result: WarpGrepResult): string => {\n      return formatResult(result);\n    },\n  });\n}\n\n// Legacy alias for backwards compatibility\nexport const createMorphWarpGrepTool = createWarpGrepTool;\n\nconst GITHUB_SEARCH_PARAMETERS = {\n  type: 'OBJECT',\n  properties: {\n    search_term: { type: 'STRING', description: 'Search problem statement that this subagent is supposed to research for' },\n    github_url: { type: 'STRING', description: 'GitHub repository URL to search (e.g. \"https://github.com/vercel/next.js\"). You must provide either github_url or owner_repo.' },\n    owner_repo: { type: 'STRING', description: 'Repository owner/repo shorthand (e.g. \"vercel/next.js\"). You must provide either github_url or owner_repo.' },\n    branch: { type: 'STRING', description: 'Branch to search (defaults to repo default branch)' },\n  },\n  required: ['search_term'],\n} as unknown as FunctionDeclarationSchema;\n\n/**\n * Create a GitHub search tool for Google Gemini SDK\n *\n * @param config - Configuration options (morphApiKey, morphApiUrl, codeSearchUrl, timeout)\n * @returns Gemini FunctionDeclaration with execute and formatResult methods\n *\n * @example\n * ```typescript\n * import { GoogleGenerativeAI } from '@google/generative-ai';\n * import { createGitHubSearchTool } from '@morphllm/morphsdk/tools/warp-grep/gemini';\n *\n * const tool = createGitHubSearchTool({ morphApiKey: process.env.MORPH_API_KEY });\n *\n * const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);\n * const model = genAI.getGenerativeModel({\n *   model: 'gemini-2.0-flash',\n *   tools: [{ functionDeclarations: [tool] }]\n * });\n *\n * // Execute\n * const result = await tool.execute({ search_term: 'auth middleware', github_url: 'https://github.com/vercel/next.js' });\n * console.log(tool.formatResult(result));\n * ```\n */\nexport function createGitHubSearchTool(config: GitHubSearchToolConfig) {\n  const client = new WarpGrepClient(config);\n\n  const declaration: FunctionDeclaration = {\n    name: GITHUB_SEARCH_TOOL_NAME,\n    description: GITHUB_SEARCH_DESCRIPTION,\n    parameters: GITHUB_SEARCH_PARAMETERS,\n  };\n\n  return Object.assign(declaration, {\n    execute: async (input: { search_term: string; github_url?: string; owner_repo?: string; branch?: string }): Promise<WarpGrepResult> => {\n      const github = input.github_url || input.owner_repo;\n      if (!github) {\n        throw new Error('Please provide github search url or owner/repo id');\n      }\n      return client.searchGitHub({ searchTerm: input.search_term, github, branch: input.branch });\n    },\n    formatResult: (result: WarpGrepResult): string => {\n      return formatResult(result);\n    },\n  });\n}\n\nconst GITHUB_READ_FILE_PARAMETERS = {\n  type: 'OBJECT',\n  properties: {\n    github: { type: 'STRING', description: 'owner/repo shorthand (e.g., \"vercel/next.js\")' },\n    path: { type: 'STRING', description: 'File path within the repository' },\n    startLine: { type: 'NUMBER', description: 'Start line number (1-based)' },\n    endLine: { type: 'NUMBER', description: 'End line number (1-based, inclusive)' },\n    branch: { type: 'STRING', description: 'Branch to read from (defaults to repo default branch)' },\n  },\n  required: ['github', 'path'],\n} as unknown as FunctionDeclarationSchema;\n\n/**\n * Create a GitHub read file tool for Google Gemini SDK\n *\n * @param config - Optional configuration (timeout)\n * @returns Gemini FunctionDeclaration with execute and formatResult methods\n *\n * @example\n * ```typescript\n * import { GoogleGenerativeAI } from '@google/generative-ai';\n * import { createGitHubReadFileTool } from '@morphllm/morphsdk/tools/warp-grep/gemini';\n *\n * const tool = createGitHubReadFileTool();\n *\n * const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);\n * const model = genAI.getGenerativeModel({\n *   model: 'gemini-2.0-flash',\n *   tools: [{ functionDeclarations: [tool] }]\n * });\n *\n * const result = await tool.execute({ github: 'vercel/next.js', path: 'package.json' });\n * console.log(tool.formatResult(result));\n * ```\n */\nexport function createGitHubReadFileTool(config?: GitHubReadFileToolConfig) {\n  const declaration: FunctionDeclaration = {\n    name: GITHUB_READ_FILE_TOOL_NAME,\n    description: GITHUB_READ_FILE_DESCRIPTION,\n    parameters: GITHUB_READ_FILE_PARAMETERS,\n  };\n\n  return Object.assign(declaration, {\n    execute: async (input: GitHubReadFileInput): Promise<GitHubReadFileResult> => {\n      return executeGitHubReadFile(input, config);\n    },\n    formatResult: (result: GitHubReadFileResult): string => {\n      return formatGitHubReadFileResult(result);\n    },\n  });\n}\n\nexport default warpGrepFunctionDeclaration;\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,IAAM,kBAAkB;AAAA,EACtB,MAAM;AAAA,EACN,YAAY;AAAA,IACV,aAAa;AAAA,MACX,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,UAAU,CAAC,aAAa;AAC1B;AA2BO,IAAM,8BAAmD;AAAA,EAC9D,MAAM;AAAA,EACN,aAAa;AAAA,EACb,YAAY;AACd;AASA,eAAsB,QACpB,OACA,QACyB;AACzB,SAAO,gBAAgB,OAAO,MAAM;AACtC;AA8DO,SAAS,mBAAmB,QAAgD;AACjF,QAAM,cAAmC;AAAA,IACvC,MAAM,OAAO,QAAQ;AAAA,IACrB,aAAa,OAAO,eAAe;AAAA,IACnC,YAAY;AAAA,EACd;AAEA,SAAO,OAAO,OAAO,aAAa;AAAA,IAChC,SAAS,OAAO,UAA4C;AAC1D,aAAO,gBAAgB,OAA2C,MAAM;AAAA,IAC1E;AAAA,IACA,cAAc,CAAC,WAAmC;AAChD,aAAO,aAAa,MAAM;AAAA,IAC5B;AAAA,EACF,CAAC;AACH;AAGO,IAAM,0BAA0B;AAEvC,IAAM,2BAA2B;AAAA,EAC/B,MAAM;AAAA,EACN,YAAY;AAAA,IACV,aAAa,EAAE,MAAM,UAAU,aAAa,0EAA0E;AAAA,IACtH,YAAY,EAAE,MAAM,UAAU,aAAa,gIAAgI;AAAA,IAC3K,YAAY,EAAE,MAAM,UAAU,aAAa,6GAA6G;AAAA,IACxJ,QAAQ,EAAE,MAAM,UAAU,aAAa,qDAAqD;AAAA,EAC9F;AAAA,EACA,UAAU,CAAC,aAAa;AAC1B;AA0BO,SAAS,uBAAuB,QAAgC;AACrE,QAAM,SAAS,IAAI,eAAe,MAAM;AAExC,QAAM,cAAmC;AAAA,IACvC,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,EACd;AAEA,SAAO,OAAO,OAAO,aAAa;AAAA,IAChC,SAAS,OAAO,UAAuH;AACrI,YAAM,SAAS,MAAM,cAAc,MAAM;AACzC,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI,MAAM,mDAAmD;AAAA,MACrE;AACA,aAAO,OAAO,aAAa,EAAE,YAAY,MAAM,aAAa,QAAQ,QAAQ,MAAM,OAAO,CAAC;AAAA,IAC5F;AAAA,IACA,cAAc,CAAC,WAAmC;AAChD,aAAO,aAAa,MAAM;AAAA,IAC5B;AAAA,EACF,CAAC;AACH;AAEA,IAAM,8BAA8B;AAAA,EAClC,MAAM;AAAA,EACN,YAAY;AAAA,IACV,QAAQ,EAAE,MAAM,UAAU,aAAa,gDAAgD;AAAA,IACvF,MAAM,EAAE,MAAM,UAAU,aAAa,kCAAkC;AAAA,IACvE,WAAW,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IACxE,SAAS,EAAE,MAAM,UAAU,aAAa,uCAAuC;AAAA,IAC/E,QAAQ,EAAE,MAAM,UAAU,aAAa,wDAAwD;AAAA,EACjG;AAAA,EACA,UAAU,CAAC,UAAU,MAAM;AAC7B;AAyBO,SAAS,yBAAyB,QAAmC;AAC1E,QAAM,cAAmC;AAAA,IACvC,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,EACd;AAEA,SAAO,OAAO,OAAO,aAAa;AAAA,IAChC,SAAS,OAAO,UAA8D;AAC5E,aAAO,sBAAsB,OAAO,MAAM;AAAA,IAC5C;AAAA,IACA,cAAc,CAAC,WAAyC;AACtD,aAAO,2BAA2B,MAAM;AAAA,IAC1C;AAAA,EACF,CAAC;AACH;AAEA,IAAO,iBAAQ;","names":[]}
+{"version":3,"sources":["../../../tools/warp_grep/gemini.ts"],"sourcesContent":["/**\n * Google Gemini SDK adapter for morph-warp-grep tool\n * \n * Requires @google/generative-ai as a peer dependency.\n * Install with: npm install @google/generative-ai\n */\n\nimport type { FunctionDeclaration, FunctionDeclarationSchema } from '@google/generative-ai';\nimport { executeToolCall, formatResult, WarpGrepClient, executeGitHubReadFile, formatGitHubReadFileResult } from './client.js';\nimport { WARP_GREP_DESCRIPTION, WARP_GREP_TOOL_NAME, GITHUB_SEARCH_TOOL_NAME, GITHUB_SEARCH_DESCRIPTION, GITHUB_READ_FILE_TOOL_NAME, GITHUB_READ_FILE_DESCRIPTION, GITHUB_READ_FILE_INPUT_SCHEMA } from './prompts.js';\nimport type { WarpGrepToolConfig, WarpGrepResult, GitHubSearchToolConfig, GitHubReadFileInput, GitHubReadFileResult, GitHubReadFileToolConfig } from './types.js';\n\n// Use plain object to avoid runtime import of SchemaType enum\nconst TOOL_PARAMETERS = {\n  type: 'OBJECT',\n  properties: {\n    search_term: { \n      type: 'STRING', \n      description: 'Search problem statement that this subagent is supposed to research for' \n    },\n  },\n  required: ['search_term'],\n} as unknown as FunctionDeclarationSchema;\n\n/**\n * Gemini-native warp grep function declaration\n * \n * @example\n * ```typescript\n * import { GoogleGenerativeAI } from '@google/generative-ai';\n * import { warpGrepFunctionDeclaration, execute } from '@morphllm/morphsdk/tools/warp-grep/gemini';\n * \n * const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);\n * const model = genAI.getGenerativeModel({\n *   model: 'gemini-2.0-flash',\n *   tools: [{ functionDeclarations: [warpGrepFunctionDeclaration] }]\n * });\n * \n * const chat = model.startChat();\n * const result = await chat.sendMessage('Find authentication middleware');\n * \n * // Handle function call\n * const call = result.response.functionCalls()?.[0];\n * if (call) {\n *   const searchResult = await execute(call.args, { repoRoot: '.' });\n *   console.log(searchResult);\n * }\n * ```\n */\nexport const warpGrepFunctionDeclaration: FunctionDeclaration = {\n  name: WARP_GREP_TOOL_NAME,\n  description: WARP_GREP_DESCRIPTION,\n  parameters: TOOL_PARAMETERS,\n};\n\n/**\n * Execute warp grep search\n * \n * @param input - Tool input with search_term\n * @param config - Configuration with repoRoot and optional provider\n * @returns Search results\n */\nexport async function execute(\n  input: { search_term: string } | string,\n  config: WarpGrepToolConfig\n): Promise<WarpGrepResult> {\n  return executeToolCall(input, config);\n}\n\nexport { formatResult };\n\n/**\n * Gemini tool with execute method attached\n */\nexport interface GeminiWarpGrepTool extends FunctionDeclaration {\n  execute: (input: unknown) => Promise<WarpGrepResult>;\n  formatResult: (result: WarpGrepResult) => string;\n}\n\n/**\n * Create a custom warp grep tool with configuration and methods\n * \n * @param config - Configuration options\n * @returns Function declaration with execute and formatResult methods\n * \n * @example Local usage\n * ```typescript\n * import { GoogleGenerativeAI } from '@google/generative-ai';\n * import { createMorphWarpGrepTool } from '@morphllm/morphsdk/tools/warp-grep/gemini';\n * \n * const tool = createMorphWarpGrepTool({ repoRoot: '.' });\n * \n * const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);\n * const model = genAI.getGenerativeModel({\n *   model: 'gemini-2.0-flash',\n *   tools: [{ functionDeclarations: [tool] }]\n * });\n * \n * const chat = model.startChat();\n * const result = await chat.sendMessage('Find authentication middleware');\n * \n * // Handle function call\n * const call = result.response.functionCalls()?.[0];\n * if (call && call.name === tool.name) {\n *   const searchResult = await tool.execute(call.args);\n *   console.log(tool.formatResult(searchResult));\n *   \n *   // Send result back to model\n *   await chat.sendMessage([{\n *     functionResponse: {\n *       name: call.name,\n *       response: { result: tool.formatResult(searchResult) }\n *     }\n *   }]);\n * }\n * ```\n * \n * @example Remote sandbox (E2B, Modal, etc.)\n * ```typescript\n * const tool = createMorphWarpGrepTool({\n *   repoRoot: '/home/repo',\n *   remoteCommands: {\n *     grep: async (pattern, path) => (await sandbox.run(`rg '${pattern}' '${path}'`)).stdout,\n *     read: async (path, start, end) => (await sandbox.run(`sed -n '${start},${end}p' '${path}'`)).stdout,\n *     listDir: async (path, maxDepth) => (await sandbox.run(`find '${path}' -maxdepth ${maxDepth}`)).stdout,\n *   },\n * });\n * ```\n */\nexport function createWarpGrepTool(config: WarpGrepToolConfig): GeminiWarpGrepTool {\n  const declaration: FunctionDeclaration = {\n    name: config.name ?? WARP_GREP_TOOL_NAME,\n    description: config.description ?? WARP_GREP_DESCRIPTION,\n    parameters: TOOL_PARAMETERS,\n  };\n\n  return Object.assign(declaration, {\n    execute: async (input: unknown): Promise<WarpGrepResult> => {\n      return executeToolCall(input as { search_term: string } | string, config);\n    },\n    formatResult: (result: WarpGrepResult): string => {\n      return formatResult(result);\n    },\n  });\n}\n\n// Legacy alias for backwards compatibility\nexport const createMorphWarpGrepTool = createWarpGrepTool;\n\nconst GITHUB_SEARCH_PARAMETERS = {\n  type: 'OBJECT',\n  properties: {\n    search_term: { type: 'STRING', description: 'Search problem statement that this subagent is supposed to research for' },\n    github_url: { type: 'STRING', description: 'GitHub repository URL to search (e.g. \"https://github.com/vercel/next.js\"). You must provide either github_url or owner_repo.' },\n    owner_repo: { type: 'STRING', description: 'Repository owner/repo shorthand (e.g. \"vercel/next.js\"). You must provide either github_url or owner_repo.' },\n    branch: { type: 'STRING', description: 'Branch to search (defaults to repo default branch)' },\n  },\n  required: ['search_term'],\n} as unknown as FunctionDeclarationSchema;\n\n/**\n * Create a GitHub search tool for Google Gemini SDK\n *\n * @param config - Configuration options (morphApiKey, morphApiUrl, codeSearchUrl, timeout)\n * @returns Gemini FunctionDeclaration with execute and formatResult methods\n *\n * @example\n * ```typescript\n * import { GoogleGenerativeAI } from '@google/generative-ai';\n * import { createGitHubSearchTool } from '@morphllm/morphsdk/tools/warp-grep/gemini';\n *\n * const tool = createGitHubSearchTool({ morphApiKey: process.env.MORPH_API_KEY });\n *\n * const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);\n * const model = genAI.getGenerativeModel({\n *   model: 'gemini-2.0-flash',\n *   tools: [{ functionDeclarations: [tool] }]\n * });\n *\n * // Execute\n * const result = await tool.execute({ search_term: 'auth middleware', github_url: 'https://github.com/vercel/next.js' });\n * console.log(tool.formatResult(result));\n * ```\n */\nexport function createGitHubSearchTool(config: GitHubSearchToolConfig) {\n  const client = new WarpGrepClient(config);\n\n  const declaration: FunctionDeclaration = {\n    name: GITHUB_SEARCH_TOOL_NAME,\n    description: GITHUB_SEARCH_DESCRIPTION,\n    parameters: GITHUB_SEARCH_PARAMETERS,\n  };\n\n  return Object.assign(declaration, {\n    execute: async (input: { search_term: string; github_url?: string; owner_repo?: string; branch?: string }): Promise<WarpGrepResult> => {\n      const github = input.github_url || input.owner_repo;\n      if (!github) {\n        throw new Error('Please provide github search url or owner/repo id');\n      }\n      return client.searchGitHub({ searchTerm: input.search_term, github, branch: input.branch });\n    },\n    formatResult: (result: WarpGrepResult): string => {\n      return formatResult(result);\n    },\n  });\n}\n\nconst GITHUB_READ_FILE_PARAMETERS = {\n  type: 'OBJECT',\n  properties: {\n    github: { type: 'STRING', description: 'owner/repo shorthand (e.g., \"vercel/next.js\")' },\n    path: { type: 'STRING', description: 'File path within the repository' },\n    startLine: { type: 'NUMBER', description: 'Start line number (1-based)' },\n    endLine: { type: 'NUMBER', description: 'End line number (1-based, inclusive)' },\n    branch: { type: 'STRING', description: 'Branch to read from (defaults to repo default branch)' },\n  },\n  required: ['github', 'path'],\n} as unknown as FunctionDeclarationSchema;\n\n/**\n * Create a GitHub read file tool for Google Gemini SDK\n *\n * @param config - Optional configuration (timeout)\n * @returns Gemini FunctionDeclaration with execute and formatResult methods\n *\n * @example\n * ```typescript\n * import { GoogleGenerativeAI } from '@google/generative-ai';\n * import { createGitHubReadFileTool } from '@morphllm/morphsdk/tools/warp-grep/gemini';\n *\n * const tool = createGitHubReadFileTool();\n *\n * const genAI = new GoogleGenerativeAI(process.env.GOOGLE_API_KEY);\n * const model = genAI.getGenerativeModel({\n *   model: 'gemini-2.0-flash',\n *   tools: [{ functionDeclarations: [tool] }]\n * });\n *\n * const result = await tool.execute({ github: 'vercel/next.js', path: 'package.json' });\n * console.log(tool.formatResult(result));\n * ```\n */\nexport function createGitHubReadFileTool(config?: GitHubReadFileToolConfig) {\n  const declaration: FunctionDeclaration = {\n    name: GITHUB_READ_FILE_TOOL_NAME,\n    description: GITHUB_READ_FILE_DESCRIPTION,\n    parameters: GITHUB_READ_FILE_PARAMETERS,\n  };\n\n  return Object.assign(declaration, {\n    execute: async (input: GitHubReadFileInput): Promise<GitHubReadFileResult> => {\n      return executeGitHubReadFile(input, config);\n    },\n    formatResult: (result: GitHubReadFileResult): string => {\n      return formatGitHubReadFileResult(result);\n    },\n  });\n}\n\nexport default warpGrepFunctionDeclaration;\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,IAAM,kBAAkB;AAAA,EACtB,MAAM;AAAA,EACN,YAAY;AAAA,IACV,aAAa;AAAA,MACX,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,UAAU,CAAC,aAAa;AAC1B;AA2BO,IAAM,8BAAmD;AAAA,EAC9D,MAAM;AAAA,EACN,aAAa;AAAA,EACb,YAAY;AACd;AASA,eAAsB,QACpB,OACA,QACyB;AACzB,SAAO,gBAAgB,OAAO,MAAM;AACtC;AA8DO,SAAS,mBAAmB,QAAgD;AACjF,QAAM,cAAmC;AAAA,IACvC,MAAM,OAAO,QAAQ;AAAA,IACrB,aAAa,OAAO,eAAe;AAAA,IACnC,YAAY;AAAA,EACd;AAEA,SAAO,OAAO,OAAO,aAAa;AAAA,IAChC,SAAS,OAAO,UAA4C;AAC1D,aAAO,gBAAgB,OAA2C,MAAM;AAAA,IAC1E;AAAA,IACA,cAAc,CAAC,WAAmC;AAChD,aAAO,aAAa,MAAM;AAAA,IAC5B;AAAA,EACF,CAAC;AACH;AAGO,IAAM,0BAA0B;AAEvC,IAAM,2BAA2B;AAAA,EAC/B,MAAM;AAAA,EACN,YAAY;AAAA,IACV,aAAa,EAAE,MAAM,UAAU,aAAa,0EAA0E;AAAA,IACtH,YAAY,EAAE,MAAM,UAAU,aAAa,gIAAgI;AAAA,IAC3K,YAAY,EAAE,MAAM,UAAU,aAAa,6GAA6G;AAAA,IACxJ,QAAQ,EAAE,MAAM,UAAU,aAAa,qDAAqD;AAAA,EAC9F;AAAA,EACA,UAAU,CAAC,aAAa;AAC1B;AA0BO,SAAS,uBAAuB,QAAgC;AACrE,QAAM,SAAS,IAAI,eAAe,MAAM;AAExC,QAAM,cAAmC;AAAA,IACvC,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,EACd;AAEA,SAAO,OAAO,OAAO,aAAa;AAAA,IAChC,SAAS,OAAO,UAAuH;AACrI,YAAM,SAAS,MAAM,cAAc,MAAM;AACzC,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI,MAAM,mDAAmD;AAAA,MACrE;AACA,aAAO,OAAO,aAAa,EAAE,YAAY,MAAM,aAAa,QAAQ,QAAQ,MAAM,OAAO,CAAC;AAAA,IAC5F;AAAA,IACA,cAAc,CAAC,WAAmC;AAChD,aAAO,aAAa,MAAM;AAAA,IAC5B;AAAA,EACF,CAAC;AACH;AAEA,IAAM,8BAA8B;AAAA,EAClC,MAAM;AAAA,EACN,YAAY;AAAA,IACV,QAAQ,EAAE,MAAM,UAAU,aAAa,gDAAgD;AAAA,IACvF,MAAM,EAAE,MAAM,UAAU,aAAa,kCAAkC;AAAA,IACvE,WAAW,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,IACxE,SAAS,EAAE,MAAM,UAAU,aAAa,uCAAuC;AAAA,IAC/E,QAAQ,EAAE,MAAM,UAAU,aAAa,wDAAwD;AAAA,EACjG;AAAA,EACA,UAAU,CAAC,UAAU,MAAM;AAC7B;AAyBO,SAAS,yBAAyB,QAAmC;AAC1E,QAAM,cAAmC;AAAA,IACvC,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,EACd;AAEA,SAAO,OAAO,OAAO,aAAa;AAAA,IAChC,SAAS,OAAO,UAA8D;AAC5E,aAAO,sBAAsB,OAAO,MAAM;AAAA,IAC5C;AAAA,IACA,cAAc,CAAC,WAAyC;AACtD,aAAO,2BAA2B,MAAM;AAAA,IAC1C;AAAA,EACF,CAAC;AACH;AAEA,IAAO,iBAAQ;","names":[]}

package/dist/tools/warp_grep/index.cjs

@@ -220,7 +220,7 @@ function toRepoRelative(repoRoot, absPath) {
 }
 function isSymlink(p) {
   try {
-    const st = import_fs.default.lstatSync(p);
+    const st = import_fs2.default.lstatSync(p);
     return st.isSymbolicLink();
   } catch {
     return false;
@@ -243,13 +243,13 @@ function fixPathRepetition(fullPath) {
 }
 function isTextualFile(filePath, maxBytes = 2e6) {
   try {
-    const st = import_fs.default.statSync(filePath);
+    const st = import_fs2.default.statSync(filePath);
     if (!st.isFile()) return false;
     if (st.size > maxBytes) return false;
-    const fd = import_fs.default.openSync(filePath, "r");
+    const fd = import_fs2.default.openSync(filePath, "r");
     const buf = Buffer.alloc(512);
-    const read = import_fs.default.readSync(fd, buf, 0, buf.length, 0);
-    import_fs.default.closeSync(fd);
+    const read = import_fs2.default.readSync(fd, buf, 0, buf.length, 0);
+    import_fs2.default.closeSync(fd);
     for (let i = 0; i < read; i++) {
       const c = buf[i];
       if (c === 0) return false;
@@ -259,11 +259,11 @@ function isTextualFile(filePath, maxBytes = 2e6) {
     return false;
   }
 }
-var import_fs, import_path4;
+var import_fs2, import_path4;
 var init_paths = __esm({
   "tools/warp_grep/utils/paths.ts"() {
     "use strict";
-    import_fs = __toESM(require("fs"), 1);
+    import_fs2 = __toESM(require("fs"), 1);
     import_path4 = __toESM(require("path"), 1);
   }
 });
@@ -968,7 +968,7 @@ var import_openai = __toESM(require("openai"), 1);
 // package.json
 var package_default = {
   name: "@morphllm/morphsdk",
-  version: "0.2.161",
+  version: "0.2.163",
   description: "TypeScript SDK and CLI for Morph Fast Apply integration",
   type: "module",
   main: "./dist/index.cjs",
@@ -980,6 +980,11 @@ var package_default = {
       import: "./dist/index.js",
       require: "./dist/index.cjs"
     },
+    "./logger": {
+      types: "./dist/logger.d.ts",
+      import: "./dist/logger.js",
+      require: "./dist/logger.cjs"
+    },
     "./edge": {
       types: "./dist/edge.d.ts",
       import: "./dist/edge.js",
@@ -1208,6 +1213,46 @@ var SDK_VERSION = package_default.version;
 
 // tools/warp_grep/agent/runner.ts
 var import_path3 = __toESM(require("path"), 1);
+
+// logger.ts
+var import_fs = require("fs");
+var MorphLogger = class {
+  enabled;
+  fileStream;
+  constructor() {
+    this.enabled = process.env.MORPH_DEBUG === "1" || !!process.env.MORPH_LOG_FILE;
+    const f = process.env.MORPH_LOG_FILE;
+    this.fileStream = f ? (0, import_fs.createWriteStream)(f, { flags: "a" }) : null;
+  }
+  debug(component, msg, data) {
+    this._log("debug", component, msg, data);
+  }
+  info(component, msg, data) {
+    this._log("info", component, msg, data);
+  }
+  warn(component, msg, data) {
+    this._log("warn", component, msg, data);
+  }
+  error(component, msg, data) {
+    this._log("error", component, msg, data);
+  }
+  enable() {
+    this.enabled = true;
+  }
+  get isEnabled() {
+    return this.enabled;
+  }
+  _log(level, component, msg, data) {
+    if (level !== "error" && !this.enabled) return;
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    const prefix = `[${ts}] [${level.toUpperCase()}] [${component}]`;
+    console.error(data ? `${prefix} ${msg} ${JSON.stringify(data)}` : `${prefix} ${msg}`);
+    this.fileStream?.write(JSON.stringify({ ts, level, component, msg, ...data && { data } }) + "\n");
+  }
+};
+var logger = new MorphLogger();
+
+// tools/warp_grep/agent/runner.ts
 var DEFAULT_API_URL = "https://api.morphllm.com";
 var TOOL_SPECS = [
   {
@@ -1330,6 +1375,8 @@ async function callModel(messages, model, options = {}) {
     defaultHeaders: { "X-Morph-SDK-Version": SDK_VERSION }
   });
   const MAX_EMPTY_RETRIES = 1;
+  logger.debug("WarpGrep", "model_call", { url: baseURL, model, message_count: messages.length });
+  const callStartTime = Date.now();
   for (let attempt = 0; attempt <= MAX_EMPTY_RETRIES; attempt++) {
     let data;
     try {
@@ -1342,10 +1389,16 @@ async function callModel(messages, model, options = {}) {
         ...options.search_type ? { search_type: options.search_type } : {}
       });
     } catch (error) {
-      if (error instanceof import_openai.default.APIError && error.status === 404) {
-        const defaultMsg = "The endpoint you are trying to call is likely deprecated. Please update with: npm cache clean --force && npx -y @morphllm/morphmcp@latest or visit: https://morphllm.com/mcp";
-        const errorText = error.message?.trim();
-        throw new Error(errorText || defaultMsg);
+      const callLatencyMs = Date.now() - callStartTime;
+      if (error instanceof import_openai.default.APIError) {
+        logger.error("WarpGrep", "model_call_error", { status: error.status, error: error.message, latency_ms: callLatencyMs });
+        if (error.status === 404) {
+          const defaultMsg = "The endpoint you are trying to call is likely deprecated. Please update with: npm cache clean --force && npx -y @morphllm/morphmcp@latest or visit: https://morphllm.com/mcp";
+          const errorText = error.message?.trim();
+          throw new Error(errorText || defaultMsg);
+        }
+      } else {
+        logger.error("WarpGrep", "model_call_error", { status: void 0, error: error instanceof Error ? error.message : String(error), latency_ms: callLatencyMs });
       }
       throw error;
     }
@@ -1364,6 +1417,7 @@ async function callModel(messages, model, options = {}) {
       function: { name: tc.function.name, arguments: tc.function.arguments }
     }));
     if (message.content || toolCalls.length > 0) {
+      logger.debug("WarpGrep", "model_call_complete", { latency_ms: Date.now() - callStartTime, tool_calls_count: toolCalls.length, finish_reason: choice?.finish_reason ?? "unknown" });
       return { content: message.content ?? null, tool_calls: toolCalls };
     }
     if (attempt === MAX_EMPTY_RETRIES) {
@@ -1434,9 +1488,11 @@ async function* runWarpGrepStreaming(config) {
   const model = config.model || DEFAULT_MODEL;
   const messages = [];
   const maxTurns = AGENT_CONFIG.MAX_TURNS;
+  logger.debug("WarpGrep", "session_start", { search_term: config.searchTerm, model, max_turns: maxTurns });
   const initialStateStart = Date.now();
   const initialState = await buildInitialState(repoRoot, config.searchTerm, config.provider, { search_type: config.search_type });
   timings.initial_state_ms = Date.now() - initialStateStart;
+  logger.debug("WarpGrep", "initial_state", { system_prompt_len: initialState.length, user_message_len: initialState.length });
   messages.push({ role: "user", content: initialState });
   const provider = config.provider;
   const errors = [];
@@ -1444,7 +1500,13 @@ async function* runWarpGrepStreaming(config) {
   let terminationReason = "terminated";
   for (let turn = 1; turn <= maxTurns; turn += 1) {
     const turnMetrics = { turn, morph_api_ms: 0, local_tools_ms: 0 };
+    logger.debug("WarpGrep", "turn_start", { turn, message_count: messages.length });
+    const beforeChars = messages.reduce((sum, m) => sum + (typeof m.content === "string" ? m.content.length : 0), 0);
     enforceContextLimit(messages);
+    const afterChars = messages.reduce((sum, m) => sum + (typeof m.content === "string" ? m.content.length : 0), 0);
+    if (afterChars < beforeChars) {
+      logger.debug("WarpGrep", "context_truncated", { before_chars: beforeChars, after_chars: afterChars });
+    }
     const modelCallStart = Date.now();
     const response = await callModel(messages, model, {
       morphApiKey: config.morphApiKey,
@@ -1455,6 +1517,7 @@ async function* runWarpGrepStreaming(config) {
     }).catch((e) => {
       const errMsg = e instanceof Error ? e.message : String(e);
       console.error(`[warp_grep] Morph API call failed on turn ${turn}:`, errMsg);
+      logger.error("WarpGrep", "error", { turn, error: errMsg, phase: "model_call" });
       errors.push({ message: errMsg });
       return null;
     });
@@ -1464,6 +1527,7 @@ async function* runWarpGrepStreaming(config) {
       break;
     }
     const toolCalls = response.tool_calls;
+    logger.debug("WarpGrep", "model_response", { turn, tool_calls: toolCalls.map((tc) => tc.function.name), latency_ms: turnMetrics.morph_api_ms });
     messages.push({
       role: "assistant",
       content: response.content,
@@ -1490,6 +1554,7 @@ async function* runWarpGrepStreaming(config) {
       const files = parseFinishFiles(filesStr);
       finishMeta = { files };
       terminationReason = "completed";
+      logger.debug("WarpGrep", "finish", { turns: turn, files: files.map((f) => f.path) });
       if (files.length === 0) {
         const payload2 = filesStr || "No relevant code found.";
         timings.turns.push(turnMetrics);
@@ -1508,7 +1573,11 @@ async function* runWarpGrepStreaming(config) {
     const results = await Promise.all(
       toolCalls.map(async (tc) => {
         const args = safeParseJSON(tc.function.arguments);
+        const argsSummary = Object.fromEntries(Object.entries(args).map(([k, v]) => [k, typeof v === "string" && v.length > 100 ? v.slice(0, 100) + "..." : v]));
+        logger.debug("WarpGrep", "tool_exec", { turn, tool: tc.function.name, args_summary: argsSummary });
+        const toolStart = Date.now();
         const output = await executeTool(provider, tc.function.name, args, repoRoot).catch((err) => String(err));
+        logger.debug("WarpGrep", "tool_result", { turn, tool: tc.function.name, result_len: output.length, latency_ms: Date.now() - toolStart });
         return { tool_call_id: tc.id, content: output };
       })
     );
@@ -2016,12 +2085,16 @@ var WarpGrepClient = class {
   async _resolveGitHubRepo(input) {
     const { owner, repo } = parseGitHubUrl(input.github);
     const baseUrl = this.config.codeSearchUrl || DEFAULT_CODE_SEARCH_URL;
+    logger.debug("WarpGrep", "github_resolve", { owner_repo: `${owner}/${repo}`, branch: input.branch });
+    const resolveStart = Date.now();
     const importRes = await fetch(`${baseUrl}/api/code-search/get-or-create?url=${encodeURIComponent(`${owner}/${repo}`)}`);
     if (!importRes.ok) {
       const text = await importRes.text().catch(() => importRes.statusText);
+      logger.error("WarpGrep", "github_resolve_failed", { owner_repo: `${owner}/${repo}`, status: importRes.status, error: text });
       throw new Error(`Failed to import repo ${owner}/${repo}: ${text}`);
     }
     const { repoId, defaultBranch } = await importRes.json();
+    logger.debug("WarpGrep", "github_repo_fetched", { repo_id: repoId, default_branch: defaultBranch, latency_ms: Date.now() - resolveStart });
     return {
       repo,
       remoteCommands: createCodeStorageHttpCommands({ baseUrl, repoId, branch: input.branch || defaultBranch })