@morphllm/morphsdk 0.2.121 → 0.2.123

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

@@ -1,5 +1,5 @@
 import { WarpGrepStep } from './agent/types.js';
-import { W as WarpGrepClientConfig, a as WarpGrepInput, b as WarpGrepResult, d as WarpGrepToolConfig } from '../../types-D5p8QErL.js';
+import { W as WarpGrepClientConfig, a as WarpGrepInput, b as WarpGrepResult, G as GitHubSearchInput, e as GitHubReadFileInput, f as GitHubReadFileResult, d as WarpGrepToolConfig } from '../../types-DY_hq2eZ.js';
 import '../utils/resilience.js';
 import './providers/types.js';
 
@@ -72,6 +72,52 @@ declare class WarpGrepClient {
     execute(input: WarpGrepInput & {
         streamSteps?: false | undefined;
     }): Promise<WarpGrepResult>;
+    /**
+     * Search a public GitHub repository
+     *
+     * @example
+     * ```typescript
+     * // Simple usage
+     * const result = await client.searchGitHub({
+     *   query: 'Find authentication middleware',
+     *   github: 'vercel/next.js',
+     * });
+     *
+     * // With streaming
+     * const stream = client.searchGitHub({
+     *   query: 'Find auth middleware',
+     *   github: 'https://github.com/vercel/next.js',
+     *   streamSteps: true,
+     * });
+     * for await (const step of stream) {
+     *   console.log(`Turn ${step.turn}:`, step.toolCalls);
+     * }
+     * ```
+     */
+    searchGitHub(input: GitHubSearchInput & {
+        streamSteps: true;
+    }): AsyncGenerator<WarpGrepStep, WarpGrepResult, undefined>;
+    searchGitHub(input: GitHubSearchInput & {
+        streamSteps?: false | undefined;
+    }): Promise<WarpGrepResult>;
+    /**
+     * 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);
+     * ```
+     */
+    readGitHubFile(input: GitHubReadFileInput): Promise<GitHubReadFileResult>;
+    private _resolveGitHubRepo;
+    private _searchGitHubAsync;
+    private _searchGitHubStreaming;
 }
 /**
  * Execute a warp grep search directly
@@ -115,6 +161,16 @@ declare function executeToolCall(input: {
 declare function executeToolCallStreaming(input: {
     query: string;
 } | string, config: WarpGrepToolConfig): AsyncGenerator<WarpGrepStep, WarpGrepResult, undefined>;
+/**
+ * Read a single file (or line range) from a public GitHub repository
+ */
+declare function executeGitHubReadFile(input: GitHubReadFileInput, config?: {
+    timeout?: number;
+}): Promise<GitHubReadFileResult>;
+/**
+ * Format a GitHub read file result for display or tool responses
+ */
+declare function formatGitHubReadFileResult(result: GitHubReadFileResult): string;
 /**
  * Format warp grep results for display or tool responses
  *
@@ -123,4 +179,4 @@ declare function executeToolCallStreaming(input: {
  */
 declare function formatResult(result: WarpGrepResult): string;
 
-export { WarpGrepClient, executeToolCall, executeToolCallStreaming, executeWarpGrep, formatResult };
+export { WarpGrepClient, executeGitHubReadFile, executeToolCall, executeToolCallStreaming, executeWarpGrep, formatGitHubReadFileResult, formatResult };

package/dist/tools/warp_grep/client.js

@@ -1,24 +1,30 @@
 import {
   WarpGrepClient,
+  executeGitHubReadFile,
   executeToolCall,
   executeToolCallStreaming,
   executeWarpGrep,
+  formatGitHubReadFileResult,
   formatResult
-} from "../../chunk-C3BQUIFE.js";
+} from "../../chunk-MXSGTN7R.js";
+import "../../chunk-WYYR2EU6.js";
 import "../../chunk-PUGSTXLO.js";
-import "../../chunk-QDGB6FLI.js";
+import "../../chunk-63VHBANJ.js";
+import "../../chunk-ZZCMAFN7.js";
 import "../../chunk-3MLWXJTJ.js";
 import "../../chunk-5PNMAWLC.js";
 import "../../chunk-APP75CBN.js";
 import "../../chunk-GHGJAQSJ.js";
 import "../../chunk-FMLHRJDF.js";
-import "../../chunk-EJYFE73S.js";
+import "../../chunk-FMKJ72KT.js";
 import "../../chunk-PZ5AY32C.js";
 export {
   WarpGrepClient,
+  executeGitHubReadFile,
   executeToolCall,
   executeToolCallStreaming,
   executeWarpGrep,
+  formatGitHubReadFileResult,
   formatResult
 };
 //# sourceMappingURL=client.js.map

package/dist/tools/warp_grep/gemini.cjs

@@ -572,6 +572,8 @@ Details: ${res.stderr}` : ""}`
 // tools/warp_grep/gemini.ts
 var gemini_exports = {};
 __export(gemini_exports, {
+  createGitHubReadFileTool: () => createGitHubReadFileTool,
+  createGitHubSearchTool: () => createGitHubSearchTool,
   createMorphWarpGrepTool: () => createMorphWarpGrepTool,
   createWarpGrepTool: () => createWarpGrepTool,
   default: () => gemini_default,
@@ -1379,7 +1381,7 @@ var import_openai = __toESM(require("openai"), 1);
 // package.json
 var package_default = {
   name: "@morphllm/morphsdk",
-  version: "0.2.121",
+  version: "0.2.123",
   description: "TypeScript SDK and CLI for Morph Fast Apply integration",
   type: "module",
   main: "./dist/index.cjs",
@@ -1521,7 +1523,7 @@ var package_default = {
     "!dist/**/*.test.*"
   ],
   scripts: {
-    build: "tsup version.ts index.ts edge.ts client.ts tools/index.ts tools/fastapply/index.ts tools/fastapply/core.ts tools/fastapply/apply.ts tools/fastapply/types.ts tools/fastapply/prompts.ts tools/fastapply/anthropic.ts tools/fastapply/openai.ts tools/fastapply/vercel.ts tools/codebase_search/index.ts tools/codebase_search/core.ts tools/codebase_search/types.ts tools/codebase_search/prompts.ts tools/codebase_search/anthropic.ts tools/codebase_search/openai.ts tools/codebase_search/vercel.ts tools/warp_grep/index.ts tools/warp_grep/client.ts tools/warp_grep/openai.ts tools/warp_grep/anthropic.ts tools/warp_grep/vercel.ts tools/warp_grep/gemini.ts tools/warp_grep/harness.ts tools/warp_grep/agent/config.ts tools/warp_grep/agent/prompt.ts tools/warp_grep/agent/parser.ts tools/warp_grep/agent/runner.ts tools/warp_grep/agent/types.ts tools/warp_grep/agent/formatter.ts tools/warp_grep/providers/types.ts tools/warp_grep/providers/local.ts tools/warp_grep/providers/remote.ts tools/warp_grep/tools/grep.ts tools/warp_grep/tools/analyse.ts tools/warp_grep/tools/read.ts tools/warp_grep/tools/finish.ts tools/warp_grep/utils/paths.ts tools/warp_grep/utils/ripgrep.ts tools/warp_grep/utils/format.ts tools/warp_grep/utils/files.ts git/index.ts git/client.ts git/config.ts git/types.ts tools/browser/index.ts tools/browser/core.ts tools/browser/types.ts tools/browser/prompts.ts tools/browser/anthropic.ts tools/browser/openai.ts tools/browser/vercel.ts tools/browser/live.ts tools/browser/errors.ts tools/browser/profiles/index.ts tools/browser/profiles/core.ts tools/browser/profiles/types.ts modelrouter/index.ts modelrouter/core.ts modelrouter/types.ts tools/compact/index.ts tools/compact/core.ts tools/compact/types.ts tools/utils/resilience.ts --format esm,cjs --sourcemap --clean --dts --dts-resolve",
+    build: "tsup version.ts index.ts edge.ts client.ts tools/index.ts tools/fastapply/index.ts tools/fastapply/core.ts tools/fastapply/apply.ts tools/fastapply/types.ts tools/fastapply/prompts.ts tools/fastapply/anthropic.ts tools/fastapply/openai.ts tools/fastapply/vercel.ts tools/codebase_search/index.ts tools/codebase_search/core.ts tools/codebase_search/types.ts tools/codebase_search/prompts.ts tools/codebase_search/anthropic.ts tools/codebase_search/openai.ts tools/codebase_search/vercel.ts tools/warp_grep/index.ts tools/warp_grep/client.ts tools/warp_grep/openai.ts tools/warp_grep/anthropic.ts tools/warp_grep/vercel.ts tools/warp_grep/gemini.ts tools/warp_grep/harness.ts tools/warp_grep/agent/config.ts tools/warp_grep/agent/prompt.ts tools/warp_grep/agent/parser.ts tools/warp_grep/agent/runner.ts tools/warp_grep/agent/types.ts tools/warp_grep/agent/formatter.ts tools/warp_grep/providers/types.ts tools/warp_grep/providers/local.ts tools/warp_grep/providers/remote.ts tools/warp_grep/providers/code_storage_http.ts tools/warp_grep/tools/grep.ts tools/warp_grep/tools/analyse.ts tools/warp_grep/tools/read.ts tools/warp_grep/tools/finish.ts tools/warp_grep/utils/paths.ts tools/warp_grep/utils/github.ts tools/warp_grep/utils/ripgrep.ts tools/warp_grep/utils/format.ts tools/warp_grep/utils/files.ts git/index.ts git/client.ts git/config.ts git/types.ts tools/browser/index.ts tools/browser/core.ts tools/browser/types.ts tools/browser/prompts.ts tools/browser/anthropic.ts tools/browser/openai.ts tools/browser/vercel.ts tools/browser/live.ts tools/browser/errors.ts tools/browser/profiles/index.ts tools/browser/profiles/core.ts tools/browser/profiles/types.ts modelrouter/index.ts modelrouter/core.ts modelrouter/types.ts tools/compact/index.ts tools/compact/core.ts tools/compact/types.ts tools/utils/resilience.ts --format esm,cjs --sourcemap --clean --dts --dts-resolve",
     prepare: "npm run build",
     typecheck: "tsc --noEmit",
     lint: "eslint .",
@@ -1629,9 +1631,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;
     }
@@ -1812,6 +1814,171 @@ async function runWarpGrep(config) {
     timings
   };
 }
+async function* runWarpGrepStreaming(config) {
+  const totalStart = Date.now();
+  const timeoutMs = config.timeout ?? AGENT_CONFIG.TIMEOUT_MS;
+  const timings = { turns: [], timeout_ms: timeoutMs };
+  const repoRoot = import_path2.default.resolve(config.repoRoot || process.cwd());
+  const messages = [];
+  messages.push({ role: "system", content: getSystemPrompt() });
+  const initialStateStart = Date.now();
+  const initialState = await buildInitialState(repoRoot, config.query, config.provider);
+  timings.initial_state_ms = Date.now() - initialStateStart;
+  messages.push({ role: "user", content: initialState });
+  const maxTurns = AGENT_CONFIG.MAX_TURNS;
+  const model = config.model || DEFAULT_MODEL;
+  const provider = config.provider;
+  const errors = [];
+  let finishMeta;
+  let terminationReason = "terminated";
+  for (let turn = 1; turn <= maxTurns; turn += 1) {
+    const turnMetrics = { turn, morph_api_ms: 0, local_tools_ms: 0 };
+    enforceContextLimit(messages);
+    const modelCallStart = Date.now();
+    const assistantContent = await callModel(messages, model, {
+      morphApiKey: config.morphApiKey,
+      morphApiUrl: config.morphApiUrl,
+      retryConfig: config.retryConfig,
+      timeout: timeoutMs
+    }).catch((e) => {
+      const errMsg = e instanceof Error ? e.message : String(e);
+      console.error(`[warp_grep:stream] Morph API call failed on turn ${turn}:`, errMsg);
+      errors.push({ message: errMsg });
+      return "";
+    });
+    turnMetrics.morph_api_ms = Date.now() - modelCallStart;
+    if (!assistantContent) {
+      console.error(`[warp_grep:stream] Empty response from Morph API on turn ${turn}. Errors so far:`, errors);
+      timings.turns.push(turnMetrics);
+      break;
+    }
+    messages.push({ role: "assistant", content: assistantContent });
+    const toolCalls = parser.parse(assistantContent);
+    if (toolCalls.length === 0) {
+      console.error(`[warp_grep:stream] No tool calls parsed on turn ${turn}. Assistant content (first 500 chars):`, assistantContent.slice(0, 500));
+      errors.push({ message: "No tool calls produced by the model. Your MCP is likely out of date! Update it by running: rm -rf ~/.npm/_npx && npm cache clean --force && npx -y @morphllm/morphmcp@latest" });
+      terminationReason = "terminated";
+      timings.turns.push(turnMetrics);
+      break;
+    }
+    yield {
+      turn,
+      toolCalls: toolCalls.map((c) => ({
+        name: c.name,
+        arguments: c.arguments ?? {}
+      }))
+    };
+    const finishCalls = toolCalls.filter((c) => c.name === "finish");
+    const grepCalls = toolCalls.filter((c) => c.name === "grep");
+    const listDirCalls = toolCalls.filter((c) => c.name === "list_directory");
+    const readCalls = toolCalls.filter((c) => c.name === "read");
+    const skipCalls = toolCalls.filter((c) => c.name === "_skip");
+    const formatted = [];
+    for (const c of skipCalls) {
+      const msg = c.arguments?.message || "Command skipped due to parsing error";
+      formatted.push(msg);
+    }
+    const allPromises = [];
+    for (const c of grepCalls) {
+      const args = c.arguments ?? {};
+      allPromises.push(
+        toolGrep(provider, args).then(
+          ({ output }) => formatAgentToolOutput("grep", args, output, { isError: false }),
+          (err) => formatAgentToolOutput("grep", args, String(err), { isError: true })
+        )
+      );
+    }
+    for (const c of listDirCalls) {
+      const args = c.arguments ?? {};
+      allPromises.push(
+        toolListDirectory(provider, args).then(
+          (p) => formatAgentToolOutput("list_directory", args, p, { isError: false }),
+          (err) => formatAgentToolOutput("list_directory", args, String(err), { isError: true })
+        )
+      );
+    }
+    for (const c of readCalls) {
+      const args = c.arguments ?? {};
+      allPromises.push(
+        toolRead(provider, args).then(
+          (p) => formatAgentToolOutput("read", args, p, { isError: false }),
+          (err) => formatAgentToolOutput("read", args, String(err), { isError: true })
+        )
+      );
+    }
+    const toolExecStart = Date.now();
+    const allResults = await Promise.all(allPromises);
+    turnMetrics.local_tools_ms = Date.now() - toolExecStart;
+    for (const result of allResults) {
+      formatted.push(result);
+    }
+    if (formatted.length > 0) {
+      const turnMessage = formatTurnMessage(turn, maxTurns);
+      const contextBudget = calculateContextBudget(messages);
+      messages.push({ role: "user", content: formatted.join("\n") + turnMessage + "\n" + contextBudget });
+    }
+    timings.turns.push(turnMetrics);
+    if (finishCalls.length) {
+      const fc = finishCalls[0];
+      const files = fc.arguments?.files ?? [];
+      const textResult = fc.arguments?.textResult;
+      finishMeta = { files };
+      terminationReason = "completed";
+      if (files.length === 0) {
+        const payload2 = textResult || "No relevant code found.";
+        timings.total_ms = Date.now() - totalStart;
+        return {
+          terminationReason: "completed",
+          messages,
+          finish: { payload: payload2, metadata: finishMeta },
+          timings
+        };
+      }
+      break;
+    }
+  }
+  if (terminationReason !== "completed" || !finishMeta) {
+    timings.total_ms = Date.now() - totalStart;
+    return { terminationReason, messages, errors, timings };
+  }
+  const parts = ["Relevant context found:"];
+  for (const f of finishMeta.files) {
+    const ranges = f.lines === "*" ? "*" : Array.isArray(f.lines) ? f.lines.map(([s, e]) => `${s}-${e}`).join(", ") : "*";
+    parts.push(`- ${f.path}: ${ranges}`);
+  }
+  const payload = parts.join("\n");
+  const finishResolutionStart = Date.now();
+  const fileReadErrors = [];
+  const resolved = await readFinishFiles(
+    repoRoot,
+    finishMeta.files,
+    async (p, s, e) => {
+      try {
+        const rr = await provider.read({ path: p, start: s, end: e });
+        return rr.lines.map((l) => {
+          const idx = l.indexOf("|");
+          return idx >= 0 ? l.slice(idx + 1) : l;
+        });
+      } catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        fileReadErrors.push({ path: p, error: errorMsg });
+        console.error(`[warp_grep] Failed to read file: ${p} - ${errorMsg}`);
+        return [`[couldn't find: ${p}]`];
+      }
+    }
+  );
+  timings.finish_resolution_ms = Date.now() - finishResolutionStart;
+  if (fileReadErrors.length > 0) {
+    errors.push(...fileReadErrors.map((e) => ({ message: `File read error: ${e.path} - ${e.error}` })));
+  }
+  timings.total_ms = Date.now() - totalStart;
+  return {
+    terminationReason: "completed",
+    messages,
+    finish: { payload, metadata: finishMeta, resolved },
+    timings
+  };
+}
 
 // tools/warp_grep/providers/remote.ts
 init_config();
@@ -1994,11 +2161,153 @@ var RemoteCommandsProvider = class {
   }
 };
 
+// tools/warp_grep/providers/code_storage_http.ts
+async function post(url, body, op) {
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => res.statusText);
+    throw new Error(`${op} failed (${res.status}): ${text}`);
+  }
+  const data = await res.json();
+  if (data.error) throw new Error(data.error);
+  return data.stdout;
+}
+function createCodeStorageHttpCommands(config) {
+  const { baseUrl, repoId, branch } = config;
+  const encodedRepoId = encodeURIComponent(repoId);
+  return {
+    grep: (pattern, path5, glob) => post(`${baseUrl}/api/code-search/${encodedRepoId}/grep`, { pattern, path: path5, glob, branch }, "grep"),
+    read: (path5, start, end) => post(`${baseUrl}/api/code-search/${encodedRepoId}/read`, { path: path5, start, end, branch }, "read"),
+    listDir: (path5, maxDepth) => post(`${baseUrl}/api/code-search/${encodedRepoId}/list`, { path: path5, maxDepth, branch }, "list")
+  };
+}
+
+// tools/warp_grep/utils/github.ts
+function parseGitHubUrl(input) {
+  input = input.trim();
+  const urlPattern = /^(?:https?:\/\/)?github\.com\/([^\/]+)\/([^\/\?\#]+)/;
+  const match = input.match(urlPattern);
+  if (match) {
+    return { owner: match[1], repo: match[2].replace(/\.git$/, "") };
+  }
+  const shortPattern = /^([^\/]+)\/([^\/]+)$/;
+  const shortMatch = input.match(shortPattern);
+  if (shortMatch && !shortMatch[1].includes(".")) {
+    return { owner: shortMatch[1], repo: shortMatch[2].replace(/\.git$/, "") };
+  }
+  throw new Error(
+    `Invalid GitHub URL or shorthand: "${input}". Expected "owner/repo" or "https://github.com/owner/repo"`
+  );
+}
+
 // tools/warp_grep/client.ts
+var DEFAULT_CODE_SEARCH_URL = "https://morphllm.com";
 async function getLocalProvider(repoRoot, excludes) {
   const { LocalRipgrepProvider: LocalRipgrepProvider2 } = await Promise.resolve().then(() => (init_local(), local_exports));
   return new LocalRipgrepProvider2(repoRoot, excludes);
 }
+var WarpGrepClient = class {
+  config;
+  constructor(config = {}) {
+    this.config = { ...config };
+  }
+  execute(input) {
+    const toolConfig = {
+      repoRoot: input.repoRoot,
+      remoteCommands: input.remoteCommands,
+      provider: input.provider,
+      excludes: input.excludes,
+      includes: input.includes,
+      debug: input.debug ?? this.config.debug,
+      morphApiKey: this.config.morphApiKey,
+      morphApiUrl: this.config.morphApiUrl,
+      retryConfig: this.config.retryConfig,
+      timeout: this.config.timeout
+    };
+    if (input.streamSteps) {
+      return executeToolCallStreaming({ query: input.query }, toolConfig);
+    }
+    return executeToolCall({ query: input.query }, toolConfig);
+  }
+  searchGitHub(input) {
+    if (input.streamSteps) {
+      return this._searchGitHubStreaming(input);
+    }
+    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;
+    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);
+      throw new Error(`Failed to import repo ${owner}/${repo}: ${text}`);
+    }
+    const { repoId, defaultBranch } = await importRes.json();
+    return {
+      repo,
+      remoteCommands: createCodeStorageHttpCommands({ baseUrl, repoId, branch: input.branch || defaultBranch })
+    };
+  }
+  async _searchGitHubAsync(input) {
+    try {
+      const { repo, remoteCommands } = await this._resolveGitHubRepo(input);
+      return this.execute({
+        query: input.query,
+        repoRoot: repo,
+        remoteCommands
+      });
+    } catch (error) {
+      return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+  }
+  async *_searchGitHubStreaming(input) {
+    let repo;
+    let remoteCommands;
+    try {
+      ({ repo, remoteCommands } = await this._resolveGitHubRepo(input));
+    } catch (error) {
+      return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+    const generator = this.execute({
+      query: input.query,
+      repoRoot: repo,
+      remoteCommands,
+      streamSteps: true
+    });
+    let result;
+    for (; ; ) {
+      const { value, done } = await generator.next();
+      if (done) {
+        result = value;
+        break;
+      }
+      yield value;
+    }
+    return result;
+  }
+};
 async function executeToolCall(input, config) {
   const parsed = typeof input === "string" ? JSON.parse(input) : input;
   const provider = config.remoteCommands ? new RemoteCommandsProvider(config.repoRoot, config.remoteCommands) : config.provider ?? await getLocalProvider(config.repoRoot, config.excludes);
@@ -2027,6 +2336,105 @@ async function executeToolCall(input, config) {
   }));
   return { success: true, contexts, summary: finish.payload };
 }
+function processAgentResult(result) {
+  const finish = result.finish;
+  if (result.terminationReason !== "completed" || !finish?.metadata) {
+    const errorDetails = result.errors?.map((e) => e.message).join("; ") || "unknown reason";
+    console.error(`[warp_grep] processAgentResult failed. Reason: ${result.terminationReason}. Errors: ${errorDetails}. Turns: ${result.timings?.turns?.length ?? 0}`);
+    return { success: false, error: `Search did not complete: ${errorDetails}` };
+  }
+  const contexts = (finish.resolved ?? []).map((r) => ({
+    file: r.path,
+    content: r.content,
+    lines: r.ranges
+  }));
+  return { success: true, contexts, summary: finish.payload };
+}
+async function* executeToolCallStreaming(input, config) {
+  const parsed = typeof input === "string" ? JSON.parse(input) : input;
+  const provider = config.remoteCommands ? new RemoteCommandsProvider(config.repoRoot, config.remoteCommands) : config.provider ?? await getLocalProvider(config.repoRoot, config.excludes);
+  const generator = runWarpGrepStreaming({
+    query: parsed.query,
+    repoRoot: config.repoRoot,
+    provider,
+    excludes: config.excludes,
+    includes: config.includes,
+    debug: config.debug ?? false,
+    morphApiKey: config.morphApiKey,
+    morphApiUrl: config.morphApiUrl,
+    retryConfig: config.retryConfig,
+    timeout: config.timeout
+  });
+  let agentResult;
+  for (; ; ) {
+    const { value, done } = await generator.next();
+    if (done) {
+      agentResult = value;
+      break;
+    }
+    yield value;
+  }
+  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 formatGitHubReadFileResult(result) {
+  if (!result.success) {
+    return `Failed to read file: ${result.error}`;
+  }
+  const rangeStr = result.lineRange ? ` (lines ${result.lineRange[0]}-${result.lineRange[1]} of ${result.totalLines})` : "";
+  return `File: ${result.github}/${result.path}${rangeStr}
+
+${result.content}`;
+}
 function formatResult(result) {
   if (!result.success) {
     return `Search failed: ${result.error}`;
@@ -2055,6 +2463,12 @@ function formatResult(result) {
 // tools/warp_grep/prompts.ts
 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.';
+var GITHUB_WARP_GREP_SEARCH_TOOL_NAME = "warpgrep_github_search";
+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_TOOL_NAME = GITHUB_WARP_GREP_SEARCH_TOOL_NAME;
+var GITHUB_SEARCH_DESCRIPTION = GITHUB_WARP_GREP_SEARCH_DESCRIPTION;
+var GITHUB_READ_FILE_TOOL_NAME = "readfile_github_search";
+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/gemini.ts
 var TOOL_PARAMETERS = {
@@ -2094,9 +2508,65 @@ function createWarpGrepTool(config) {
   });
 }
 var createMorphWarpGrepTool = createWarpGrepTool;
+var GITHUB_SEARCH_PARAMETERS = {
+  type: "OBJECT",
+  properties: {
+    query: { type: "STRING", description: "Natural language search query" },
+    github: { type: "STRING", description: 'GitHub URL or "owner/repo" shorthand' },
+    branch: { type: "STRING", description: "Branch to search (defaults to repo default branch)" }
+  },
+  required: ["query", "github"]
+};
+function createGitHubSearchTool(config) {
+  const client = new WarpGrepClient(config);
+  const declaration = {
+    name: GITHUB_SEARCH_TOOL_NAME,
+    description: GITHUB_SEARCH_DESCRIPTION,
+    parameters: GITHUB_SEARCH_PARAMETERS
+  };
+  return Object.assign(declaration, {
+    execute: async (input) => {
+      return client.searchGitHub(input);
+    },
+    formatResult: (result) => {
+      return formatResult(result);
+    },
+    getSystemPrompt: () => {
+      return getSystemPrompt();
+    }
+  });
+}
+var GITHUB_READ_FILE_PARAMETERS = {
+  type: "OBJECT",
+  properties: {
+    github: { type: "STRING", description: 'owner/repo shorthand (e.g., "vercel/next.js")' },
+    path: { type: "STRING", description: "File path within the repository" },
+    startLine: { type: "NUMBER", description: "Start line number (1-based)" },
+    endLine: { type: "NUMBER", description: "End line number (1-based, inclusive)" },
+    branch: { type: "STRING", description: "Branch to read from (defaults to repo default branch)" }
+  },
+  required: ["github", "path"]
+};
+function createGitHubReadFileTool(config) {
+  const declaration = {
+    name: GITHUB_READ_FILE_TOOL_NAME,
+    description: GITHUB_READ_FILE_DESCRIPTION,
+    parameters: GITHUB_READ_FILE_PARAMETERS
+  };
+  return Object.assign(declaration, {
+    execute: async (input) => {
+      return executeGitHubReadFile(input, config);
+    },
+    formatResult: (result) => {
+      return formatGitHubReadFileResult(result);
+    }
+  });
+}
 var gemini_default = warpGrepFunctionDeclaration;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createGitHubReadFileTool,
+  createGitHubSearchTool,
   createMorphWarpGrepTool,
   createWarpGrepTool,
   execute,