@morphllm/morphsdk 0.2.122 → 0.2.124

package/dist/tools/warp_grep/openai.d.ts

@@ -1,7 +1,7 @@
 import { ChatCompletionTool } from 'openai/resources/chat/completions';
 export { formatResult } from './client.js';
 export { getSystemPrompt } from './agent/prompt.js';
-import { d as WarpGrepToolConfig, b as WarpGrepResult, e as GitHubSearchToolConfig } from '../../types-CA7989hK.js';
+import { d as WarpGrepToolConfig, b as WarpGrepResult, g as GitHubSearchToolConfig, h as GitHubReadFileToolConfig, e as GitHubReadFileInput, f as GitHubReadFileResult } from '../../types-DY_hq2eZ.js';
 import './agent/types.js';
 import '../utils/resilience.js';
 import './providers/types.js';
@@ -112,5 +112,32 @@ declare function createGitHubSearchTool(config: GitHubSearchToolConfig): ChatCom
     formatResult: (result: WarpGrepResult) => string;
     getSystemPrompt: () => string;
 };
+/**
+ * Create a GitHub read file tool for OpenAI SDK
+ *
+ * @param config - Optional configuration (timeout)
+ * @returns OpenAI ChatCompletionTool with execute and formatResult methods
+ *
+ * @example
+ * ```typescript
+ * import OpenAI from 'openai';
+ * import { createGitHubReadFileTool } from '@morphllm/morphsdk/tools/warp-grep/openai';
+ *
+ * const tool = createGitHubReadFileTool();
+ *
+ * const response = await openai.chat.completions.create({
+ *   model: 'gpt-4o',
+ *   tools: [tool],
+ *   messages: [{ role: 'user', content: 'Read the package.json from vercel/next.js' }]
+ * });
+ *
+ * const result = await tool.execute({ github: 'vercel/next.js', path: 'package.json' });
+ * console.log(tool.formatResult(result));
+ * ```
+ */
+declare function createGitHubReadFileTool(config?: GitHubReadFileToolConfig): ChatCompletionTool & {
+    execute: (input: GitHubReadFileInput) => Promise<GitHubReadFileResult>;
+    formatResult: (result: GitHubReadFileResult) => string;
+};
 
-export { createGitHubSearchTool, createWarpGrepTool, warpGrepTool as default, execute, warpGrepTool };
+export { createGitHubReadFileTool, createGitHubSearchTool, createWarpGrepTool, warpGrepTool as default, execute, warpGrepTool };

package/dist/tools/warp_grep/openai.js

@@ -1,18 +1,19 @@
 import {
+  createGitHubReadFileTool,
   createGitHubSearchTool,
   createWarpGrepTool,
   execute,
   openai_default,
   warpGrepTool
-} from "../../chunk-T3T4LGRD.js";
-import "../../chunk-KJZMKDDP.js";
+} from "../../chunk-27BLOUAR.js";
+import "../../chunk-OTOVGCG6.js";
 import {
   formatResult
-} from "../../chunk-TXT3W4QK.js";
-import "../../chunk-WYYR2EU6.js";
+} from "../../chunk-S4RLT56A.js";
+import "../../chunk-GVGJIXV2.js";
 import "../../chunk-PUGSTXLO.js";
 import "../../chunk-63VHBANJ.js";
-import "../../chunk-MQWEZJTP.js";
+import "../../chunk-HHRHUUGN.js";
 import "../../chunk-3MLWXJTJ.js";
 import "../../chunk-5PNMAWLC.js";
 import "../../chunk-APP75CBN.js";
@@ -20,9 +21,10 @@ import "../../chunk-GHGJAQSJ.js";
 import {
   getSystemPrompt
 } from "../../chunk-FMLHRJDF.js";
-import "../../chunk-RNKHRNSG.js";
+import "../../chunk-SGRNIWJD.js";
 import "../../chunk-PZ5AY32C.js";
 export {
+  createGitHubReadFileTool,
   createGitHubSearchTool,
   createWarpGrepTool,
   openai_default as default,

package/dist/tools/warp_grep/providers/code_storage_http.cjs

@@ -31,7 +31,12 @@ async function post(url, body, op) {
   });
   if (!res.ok) {
     const text = await res.text().catch(() => res.statusText);
-    throw new Error(`${op} failed (${res.status}): ${text}`);
+    try {
+      const parsed = JSON.parse(text);
+      if (parsed.error) return `Error: ${parsed.error}`;
+    } catch {
+    }
+    return `Error: ${op} failed (${res.status}): ${text}`;
   }
   const data = await res.json();
   if (data.error) throw new Error(data.error);

package/dist/tools/warp_grep/providers/code_storage_http.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../tools/warp_grep/providers/code_storage_http.ts"],"sourcesContent":["/**\n * HTTP-based RemoteCommands for code search against the Morph landing API.\n *\n * Translates grep/read/listDir into POST requests to the code-search endpoints,\n * so the WarpGrep agent can search GitHub repositories that have been indexed\n * by the Morph code storage service.\n */\n\nimport type { RemoteCommands } from '../types.js';\n\nexport interface CodeStorageHttpConfig {\n  /** Base URL for the code search API (e.g. \"https://morphllm.com\") */\n  baseUrl: string;\n  /** Repository ID returned by the get-or-create endpoint */\n  repoId: string;\n  /** Git branch to search */\n  branch: string;\n}\n\nasync function post(url: string, body: Record<string, unknown>, op: string): Promise<string> {\n  const res = await fetch(url, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(body),\n  });\n  if (!res.ok) {\n    const text = await res.text().catch(() => res.statusText);\n    throw new Error(`${op} failed (${res.status}): ${text}`);\n  }\n  const data = await res.json();\n  if (data.error) throw new Error(data.error);\n  return data.stdout;\n}\n\nexport function createCodeStorageHttpCommands(config: CodeStorageHttpConfig): RemoteCommands {\n  const { baseUrl, repoId, branch } = config;\n  const encodedRepoId = encodeURIComponent(repoId);\n\n  return {\n    grep: (pattern: string, path: string, glob?: string) =>\n      post(`${baseUrl}/api/code-search/${encodedRepoId}/grep`, { pattern, path, glob, branch }, 'grep'),\n\n    read: (path: string, start: number, end: number) =>\n      post(`${baseUrl}/api/code-search/${encodedRepoId}/read`, { path, start, end, branch }, 'read'),\n\n    listDir: (path: string, maxDepth: number) =>\n      post(`${baseUrl}/api/code-search/${encodedRepoId}/list`, { path, maxDepth, branch }, 'list'),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,eAAe,KAAK,KAAa,MAA+B,IAA6B;AAC3F,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C,MAAM,KAAK,UAAU,IAAI;AAAA,EAC3B,CAAC;AACD,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,OAAO,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,UAAU;AACxD,UAAM,IAAI,MAAM,GAAG,EAAE,YAAY,IAAI,MAAM,MAAM,IAAI,EAAE;AAAA,EACzD;AACA,QAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,MAAI,KAAK,MAAO,OAAM,IAAI,MAAM,KAAK,KAAK;AAC1C,SAAO,KAAK;AACd;AAEO,SAAS,8BAA8B,QAA+C;AAC3F,QAAM,EAAE,SAAS,QAAQ,OAAO,IAAI;AACpC,QAAM,gBAAgB,mBAAmB,MAAM;AAE/C,SAAO;AAAA,IACL,MAAM,CAAC,SAAiB,MAAc,SACpC,KAAK,GAAG,OAAO,oBAAoB,aAAa,SAAS,EAAE,SAAS,MAAM,MAAM,OAAO,GAAG,MAAM;AAAA,IAElG,MAAM,CAAC,MAAc,OAAe,QAClC,KAAK,GAAG,OAAO,oBAAoB,aAAa,SAAS,EAAE,MAAM,OAAO,KAAK,OAAO,GAAG,MAAM;AAAA,IAE/F,SAAS,CAAC,MAAc,aACtB,KAAK,GAAG,OAAO,oBAAoB,aAAa,SAAS,EAAE,MAAM,UAAU,OAAO,GAAG,MAAM;AAAA,EAC/F;AACF;","names":[]}
+{"version":3,"sources":["../../../../tools/warp_grep/providers/code_storage_http.ts"],"sourcesContent":["/**\n * HTTP-based RemoteCommands for code search against the Morph landing API.\n *\n * Translates grep/read/listDir into POST requests to the code-search endpoints,\n * so the WarpGrep agent can search GitHub repositories that have been indexed\n * by the Morph code storage service.\n */\n\nimport type { RemoteCommands } from '../types.js';\n\nexport interface CodeStorageHttpConfig {\n  /** Base URL for the code search API (e.g. \"https://morphllm.com\") */\n  baseUrl: string;\n  /** Repository ID returned by the get-or-create endpoint */\n  repoId: string;\n  /** Git branch to search */\n  branch: string;\n}\n\nasync function post(url: string, body: Record<string, unknown>, op: string): Promise<string> {\n  const res = await fetch(url, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify(body),\n  });\n  if (!res.ok) {\n    const text = await res.text().catch(() => res.statusText);\n    // Return error as content instead of throwing so the agent can handle it gracefully\n    try {\n      const parsed = JSON.parse(text);\n      if (parsed.error) return `Error: ${parsed.error}`;\n    } catch { /* not JSON, fall through */ }\n    return `Error: ${op} failed (${res.status}): ${text}`;\n  }\n  const data = await res.json();\n  if (data.error) throw new Error(data.error);\n  return data.stdout;\n}\n\nexport function createCodeStorageHttpCommands(config: CodeStorageHttpConfig): RemoteCommands {\n  const { baseUrl, repoId, branch } = config;\n  const encodedRepoId = encodeURIComponent(repoId);\n\n  return {\n    grep: (pattern: string, path: string, glob?: string) =>\n      post(`${baseUrl}/api/code-search/${encodedRepoId}/grep`, { pattern, path, glob, branch }, 'grep'),\n\n    read: (path: string, start: number, end: number) =>\n      post(`${baseUrl}/api/code-search/${encodedRepoId}/read`, { path, start, end, branch }, 'read'),\n\n    listDir: (path: string, maxDepth: number) =>\n      post(`${baseUrl}/api/code-search/${encodedRepoId}/list`, { path, maxDepth, branch }, 'list'),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,eAAe,KAAK,KAAa,MAA+B,IAA6B;AAC3F,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,IAC9C,MAAM,KAAK,UAAU,IAAI;AAAA,EAC3B,CAAC;AACD,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,OAAO,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,UAAU;AAExD,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,UAAI,OAAO,MAAO,QAAO,UAAU,OAAO,KAAK;AAAA,IACjD,QAAQ;AAAA,IAA+B;AACvC,WAAO,UAAU,EAAE,YAAY,IAAI,MAAM,MAAM,IAAI;AAAA,EACrD;AACA,QAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,MAAI,KAAK,MAAO,OAAM,IAAI,MAAM,KAAK,KAAK;AAC1C,SAAO,KAAK;AACd;AAEO,SAAS,8BAA8B,QAA+C;AAC3F,QAAM,EAAE,SAAS,QAAQ,OAAO,IAAI;AACpC,QAAM,gBAAgB,mBAAmB,MAAM;AAE/C,SAAO;AAAA,IACL,MAAM,CAAC,SAAiB,MAAc,SACpC,KAAK,GAAG,OAAO,oBAAoB,aAAa,SAAS,EAAE,SAAS,MAAM,MAAM,OAAO,GAAG,MAAM;AAAA,IAElG,MAAM,CAAC,MAAc,OAAe,QAClC,KAAK,GAAG,OAAO,oBAAoB,aAAa,SAAS,EAAE,MAAM,OAAO,KAAK,OAAO,GAAG,MAAM;AAAA,IAE/F,SAAS,CAAC,MAAc,aACtB,KAAK,GAAG,OAAO,oBAAoB,aAAa,SAAS,EAAE,MAAM,UAAU,OAAO,GAAG,MAAM;AAAA,EAC/F;AACF;","names":[]}

package/dist/tools/warp_grep/providers/code_storage_http.d.ts

@@ -1,4 +1,4 @@
-import { R as RemoteCommands } from '../../../types-CA7989hK.js';
+import { R as RemoteCommands } from '../../../types-DY_hq2eZ.js';
 import './types.js';
 import '../../utils/resilience.js';
 

package/dist/tools/warp_grep/providers/code_storage_http.js

@@ -1,6 +1,6 @@
 import {
   createCodeStorageHttpCommands
-} from "../../../chunk-WYYR2EU6.js";
+} from "../../../chunk-GVGJIXV2.js";
 import "../../../chunk-PZ5AY32C.js";
 export {
   createCodeStorageHttpCommands

package/dist/tools/warp_grep/providers/remote.d.ts

@@ -1,5 +1,5 @@
 import { WarpGrepProvider, GrepResult, ReadResult, ListDirectoryEntry } from './types.js';
-import { R as RemoteCommands } from '../../../types-CA7989hK.js';
+import { R as RemoteCommands } from '../../../types-DY_hq2eZ.js';
 import '../../utils/resilience.js';
 
 /**

package/dist/tools/warp_grep/vercel.cjs

@@ -572,6 +572,7 @@ Details: ${res.stderr}` : ""}`
 // tools/warp_grep/vercel.ts
 var vercel_exports = {};
 __export(vercel_exports, {
+  createGitHubReadFileTool: () => createGitHubReadFileTool,
   createGitHubSearchTool: () => createGitHubSearchTool,
   createWarpGrepTool: () => createWarpGrepTool,
   default: () => vercel_default,
@@ -1381,7 +1382,7 @@ var import_openai = __toESM(require("openai"), 1);
 // package.json
 var package_default = {
   name: "@morphllm/morphsdk",
-  version: "0.2.122",
+  version: "0.2.124",
   description: "TypeScript SDK and CLI for Morph Fast Apply integration",
   type: "module",
   main: "./dist/index.cjs",
@@ -1631,9 +1632,9 @@ async function callModel(messages, model, options = {}) {
       });
     } catch (error) {
       if (error instanceof import_openai.default.APIError && error.status === 404) {
-        throw new Error(
-          "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 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);
       }
       throw error;
     }
@@ -2170,7 +2171,12 @@ async function post(url, body, op) {
   });
   if (!res.ok) {
     const text = await res.text().catch(() => res.statusText);
-    throw new Error(`${op} failed (${res.status}): ${text}`);
+    try {
+      const parsed = JSON.parse(text);
+      if (parsed.error) return `Error: ${parsed.error}`;
+    } catch {
+    }
+    return `Error: ${op} failed (${res.status}): ${text}`;
   }
   const data = await res.json();
   if (data.error) throw new Error(data.error);
@@ -2239,6 +2245,23 @@ var WarpGrepClient = class {
     }
     return this._searchGitHubAsync(input);
   }
+  /**
+   * Read a single file from a public GitHub repository
+   *
+   * @example
+   * ```typescript
+   * const result = await client.readGitHubFile({
+   *   github: 'vercel/next.js',
+   *   path: 'src/server/app-render/index.tsx',
+   *   startLine: 1,
+   *   endLine: 50,
+   * });
+   * if (result.success) console.log(result.content);
+   * ```
+   */
+  async readGitHubFile(input) {
+    return executeGitHubReadFile(input, { timeout: this.config.timeout });
+  }
   async _resolveGitHubRepo(input) {
     const { owner, repo } = parseGitHubUrl(input.github);
     const baseUrl = this.config.codeSearchUrl || DEFAULT_CODE_SEARCH_URL;
@@ -2359,6 +2382,56 @@ async function* executeToolCallStreaming(input, config) {
   }
   return processAgentResult(agentResult);
 }
+async function fetchRawGitHubFile(owner, repo, filePath, branch, timeout) {
+  const branches = branch ? [branch] : ["HEAD"];
+  const fallbacks = ["main", "master", "develop"];
+  const fetchWithTimeout = (url) => timeout ? fetch(url, { signal: AbortSignal.timeout(timeout) }) : fetch(url);
+  for (const b of branches) {
+    const url = `https://raw.githubusercontent.com/${owner}/${repo}/${b}/${filePath}`;
+    const res = await fetchWithTimeout(url);
+    if (res.ok) return { content: await res.text(), branch: b };
+  }
+  for (const fb of fallbacks) {
+    if (branch && fb === branch) continue;
+    const url = `https://raw.githubusercontent.com/${owner}/${repo}/${fb}/${filePath}`;
+    const res = await fetchWithTimeout(url);
+    if (res.ok) return { content: await res.text(), branch: fb };
+  }
+  throw new Error(`File not found: ${owner}/${repo}/${filePath}`);
+}
+async function executeGitHubReadFile(input, config) {
+  try {
+    const { owner, repo } = parseGitHubUrl(input.github);
+    const { content: raw, branch } = await fetchRawGitHubFile(
+      owner,
+      repo,
+      input.path,
+      input.branch,
+      config?.timeout
+    );
+    const allLines = raw.split("\n");
+    const totalLines = allLines.length;
+    const start = Math.max(1, input.startLine ?? 1);
+    const end = Math.min(totalLines, input.endLine ?? totalLines);
+    const selected = allLines.slice(start - 1, end);
+    const padWidth = String(end).length;
+    const numbered = selected.map((line, i) => `${String(start + i).padStart(padWidth)}|${line}`).join("\n");
+    return {
+      success: true,
+      content: numbered,
+      path: input.path,
+      github: `${owner}/${repo}`,
+      branch,
+      lineRange: [start, end],
+      totalLines
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
 function formatResult(result) {
   if (!result.success) {
     return `Search failed: ${result.error}`;
@@ -2386,7 +2459,9 @@ function formatResult(result) {
 
 // tools/warp_grep/prompts.ts
 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.';
-var GITHUB_SEARCH_DESCRIPTION = "Search a public GitHub repository using WarpGrep. Provide a GitHub URL or owner/repo shorthand and a natural language query.";
+var GITHUB_WARP_GREP_SEARCH_DESCRIPTION = 'IMPORTANT: If you need to explore the codebase of a public GitHub repository (not your local workspace), use warpgrep_github_search instead of warpgrep_codebase_search. When the task requires understanding code in an external repo, invoke warpgrep_github_search with a GitHub URL or owner/repo shorthand (e.g., vercel/next.js) and a natural-language query describing the target functionality, bug, or architectural concern. WarpGrep searches GitHub repos the same way it searches local codebases: fast and accurate. Keep queries action-oriented (e.g., "Find where how the new use workflow directive works"), and after reviewing the results, you may verify important findings with other tools or direct file reads. WarpGrep 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 involves exploring code in an external public repo, ALWAYS use warpgrep_github_search.';
+var GITHUB_SEARCH_DESCRIPTION = GITHUB_WARP_GREP_SEARCH_DESCRIPTION;
+var GITHUB_READ_FILE_DESCRIPTION = "Read a single file (or a line range) from a public GitHub repository. Use this when you already know the exact file path you want to read, for example after finding it via warpgrep_github_search results. Takes owner/repo shorthand and the file path within the repo. Optionally specify startLine and endLine (1-based) to read a specific range. Returns the file content with line numbers.";
 
 // tools/warp_grep/vercel.ts
 var warpGrepJsonSchema = {
@@ -2457,9 +2532,29 @@ function createGitHubSearchTool(config) {
     }
   });
 }
+function createGitHubReadFileTool(config) {
+  return (0, import_ai.tool)({
+    description: GITHUB_READ_FILE_DESCRIPTION,
+    inputSchema: import_zod.z.object({
+      github: import_zod.z.string().describe('owner/repo shorthand (e.g., "vercel/next.js")'),
+      path: import_zod.z.string().describe("File path within the repository"),
+      startLine: import_zod.z.number().optional().describe("Start line number (1-based)"),
+      endLine: import_zod.z.number().optional().describe("End line number (1-based, inclusive)"),
+      branch: import_zod.z.string().optional().describe("Branch to read from (defaults to repo default branch)")
+    }),
+    execute: async (params) => {
+      const result = await executeGitHubReadFile(params, config);
+      if (!result.success) {
+        throw new Error(`GitHub read file failed: ${result.error}`);
+      }
+      return result;
+    }
+  });
+}
 var vercel_default = createWarpGrepTool;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createGitHubReadFileTool,
   createGitHubSearchTool,
   createWarpGrepTool,
   execute,