@morphllm/morphsdk 0.2.138 → 0.2.139

package/dist/client.cjs

@@ -36,7 +36,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@morphllm/morphsdk",
-      version: "0.2.138",
+      version: "0.2.139",
       description: "TypeScript SDK and CLI for Morph Fast Apply integration",
       type: "module",
       main: "./dist/index.cjs",
@@ -167,6 +167,21 @@ var init_package = __esm({
           types: "./dist/tools/compact/index.d.ts",
           import: "./dist/tools/compact/index.js",
           require: "./dist/tools/compact/index.cjs"
+        },
+        "./subagents": {
+          types: "./dist/subagents/index.d.ts",
+          import: "./dist/subagents/index.js",
+          require: "./dist/subagents/index.cjs"
+        },
+        "./subagents/vercel": {
+          types: "./dist/subagents/vercel.d.ts",
+          import: "./dist/subagents/vercel.js",
+          require: "./dist/subagents/vercel.cjs"
+        },
+        "./subagents/anthropic": {
+          types: "./dist/subagents/anthropic.d.ts",
+          import: "./dist/subagents/anthropic.js",
+          require: "./dist/subagents/anthropic.cjs"
         }
       },
       files: [
@@ -178,7 +193,7 @@ var init_package = __esm({
         "!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/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",
+        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/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 subagents/index.ts subagents/types.ts subagents/prompts.ts subagents/vercel.ts subagents/anthropic.ts --format esm,cjs --sourcemap --clean --dts --dts-resolve",
         prepare: "npm run build",
         typecheck: "tsc --noEmit",
         lint: "eslint .",
@@ -208,14 +223,14 @@ var init_package = __esm({
       license: "MIT",
       dependencies: {
         "@vscode/ripgrep": "^1.17.0",
-        ai: "^5.0.0",
+        ai: ">=5.0.0",
         diff: "^7.0.0",
         "isomorphic-git": "^1.25.10",
         openai: "^4.52.7",
-        zod: "^3.23.8"
+        zod: ">=3.23.0"
       },
       devDependencies: {
-        "@ai-sdk/anthropic": "^1.0.9",
+        "@ai-sdk/anthropic": "^2.0.70",
         "@ai-sdk/openai": "^2.0.35",
         "@anthropic-ai/sdk": "^0.30.1",
         "@google/generative-ai": "^0.24.1",
@@ -4901,7 +4916,7 @@ var TOOL_PARAMETERS = {
   required: ["search_term"]
 };
 function createWarpGrepTool(config) {
-  const tool4 = {
+  const tool5 = {
     type: "function",
     function: {
       name: config.name ?? WARP_GREP_TOOL_NAME,
@@ -4909,7 +4924,7 @@ function createWarpGrepTool(config) {
       parameters: TOOL_PARAMETERS
     }
   };
-  return Object.assign(tool4, {
+  return Object.assign(tool5, {
     execute: async (input) => {
       return executeToolCall(input, config);
     },
@@ -4920,7 +4935,7 @@ function createWarpGrepTool(config) {
 }
 function createGitHubSearchTool(config) {
   const client = new WarpGrepClient(config);
-  const tool4 = {
+  const tool5 = {
     type: "function",
     function: {
       name: GITHUB_SEARCH_TOOL_NAME,
@@ -4928,7 +4943,7 @@ function createGitHubSearchTool(config) {
       parameters: GITHUB_SEARCH_INPUT_SCHEMA
     }
   };
-  return Object.assign(tool4, {
+  return Object.assign(tool5, {
     execute: async (input) => {
       const github = input.github_url || input.owner_repo;
       if (!github) {
@@ -5208,12 +5223,12 @@ var INPUT_SCHEMA = {
   required: ["search_term"]
 };
 function createWarpGrepTool2(config) {
-  const tool4 = {
+  const tool5 = {
     name: config.name ?? WARP_GREP_TOOL_NAME,
     description: config.description ?? WARP_GREP_DESCRIPTION,
     input_schema: INPUT_SCHEMA
   };
-  return Object.assign(tool4, {
+  return Object.assign(tool5, {
     execute: async (input) => {
       return executeToolCall(input, config);
     },
@@ -5224,12 +5239,12 @@ function createWarpGrepTool2(config) {
 }
 function createGitHubSearchTool2(config) {
   const client = new WarpGrepClient(config);
-  const tool4 = {
+  const tool5 = {
     name: GITHUB_SEARCH_TOOL_NAME,
     description: GITHUB_SEARCH_DESCRIPTION,
     input_schema: GITHUB_SEARCH_INPUT_SCHEMA
   };
-  return Object.assign(tool4, {
+  return Object.assign(tool5, {
     execute: async (input) => {
       const github = input.github_url || input.owner_repo;
       if (!github) {
@@ -5362,6 +5377,347 @@ function createEditFileTool2(config = {}) {
   });
 }
 
+// subagents/prompts.ts
+var THOROUGHNESS_INSTRUCTIONS = {
+  quick: `Do 1-2 targeted searches. Find the most relevant file/function quickly and summarize. Don't go deep.`,
+  medium: `Do 2-4 searches. Start broad, then follow up on the most promising leads. Cover the main aspects.`,
+  thorough: `Do 4-8 searches. Explore systematically: start broad, then drill into each relevant area. Cover edge cases, related files, and the full call chain. Leave no stone unturned.`
+};
+function getSystemPrompt2(thoroughness = "medium") {
+  return `You are a codebase exploration specialist. Your job is to search a codebase and return a concise, accurate summary of what you find.
+
+## Mode
+READ-ONLY. You cannot modify files. You can only search and read code.
+
+## Strategy
+${THOROUGHNESS_INSTRUCTIONS[thoroughness]}
+
+- Use multiple focused searches rather than one vague search
+- Follow imports, function calls, and type references to build complete understanding
+- If a search returns no results, try alternative terms (e.g., "auth" vs "authentication" vs "login")
+- Look at both implementation and tests when relevant
+
+## Communication
+You have a \`send_message\` tool. Use it when:
+- You hit a fork in the road and need guidance ("Found auth in both src/middleware/ and legacy/auth/. Which should I focus on?")
+- You need clarification on ambiguous requests ("There are 3 auth strategies: JWT, session, OAuth. Which one?")
+- You want to share a key finding before continuing ("The main auth handler is in src/auth/index.ts. It delegates to strategy-specific modules. Continuing to trace JWT flow.")
+
+Do NOT use send_message for routine status updates. Only use it when you genuinely need input or have a significant finding worth sharing before you're done.
+
+## Output
+When you have enough information, output your final summary. Structure it as:
+1. Direct answer to the question
+2. Key files and their roles
+3. How the pieces connect
+
+Be concise. The summary should be useful to another AI model that will use your findings to complete a task.`;
+}
+var CODEBASE_SEARCH_TOOL = {
+  name: "codebase_search",
+  description: "Search the codebase for relevant code. Takes a natural language search request describing what you want to find. Returns matching file contents with line numbers.",
+  input_schema: {
+    type: "object",
+    properties: {
+      searchRequest: {
+        type: "string",
+        description: "Natural language description of what to search for in the codebase"
+      }
+    },
+    required: ["searchRequest"],
+    additionalProperties: false
+  }
+};
+var SEND_MESSAGE_TOOL = {
+  name: "send_message",
+  description: "Send a message to the orchestrating agent. Use this to ask questions, request clarification, or share important findings. The orchestrator may reply with additional context. Use sparingly \u2014 only when you genuinely need input or have a significant finding.",
+  input_schema: {
+    type: "object",
+    properties: {
+      message: {
+        type: "string",
+        description: "The message to send to the orchestrator"
+      }
+    },
+    required: ["message"],
+    additionalProperties: false
+  }
+};
+
+// subagents/anthropic.ts
+var DEFAULT_MAX_TURNS = {
+  quick: 3,
+  medium: 6,
+  thorough: 12
+};
+function getMaxTurns(config) {
+  return config.maxTurns ?? DEFAULT_MAX_TURNS[config.thoroughness ?? "medium"] ?? 6;
+}
+var TOOLS = [
+  {
+    name: CODEBASE_SEARCH_TOOL.name,
+    description: CODEBASE_SEARCH_TOOL.description,
+    input_schema: CODEBASE_SEARCH_TOOL.input_schema
+  },
+  {
+    name: SEND_MESSAGE_TOOL.name,
+    description: SEND_MESSAGE_TOOL.description,
+    input_schema: SEND_MESSAGE_TOOL.input_schema
+  }
+];
+function createExploreSubagent(config) {
+  if (!config.repoRoot) {
+    throw new Error("repoRoot is required for Explore subagent");
+  }
+  const warpGrep = new WarpGrepClient({
+    morphApiKey: config.morphApiKey
+  });
+  const thoroughness = config.thoroughness ?? "medium";
+  const maxTurns = getMaxTurns(config);
+  const replyTimeout = config.replyTimeout ?? 3e4;
+  async function runExplore(prompt, callbacks = {}) {
+    const startTime = Date.now();
+    const allContexts = [];
+    let searchCount = 0;
+    const timeoutMs = config.timeout;
+    try {
+      const messages = [{ role: "user", content: prompt }];
+      let turns = 0;
+      while (turns < maxTurns) {
+        if (timeoutMs && Date.now() - startTime > timeoutMs) {
+          return {
+            success: false,
+            summary: "",
+            contexts: deduplicateContexts(allContexts),
+            searchCount,
+            durationMs: Date.now() - startTime,
+            error: `Exploration timed out after ${timeoutMs}ms`
+          };
+        }
+        const response = await config.client.messages.create({
+          model: config.model,
+          max_tokens: 4096,
+          system: getSystemPrompt2(thoroughness),
+          tools: TOOLS,
+          messages
+        });
+        turns++;
+        if (response.stop_reason === "end_turn" || !response.content.some((b) => b.type === "tool_use")) {
+          const textBlock = response.content.find((b) => b.type === "text");
+          const summary = textBlock?.text || "Exploration completed but no summary was generated.";
+          callbacks.onStep?.({
+            step: searchCount,
+            searchRequest: "",
+            contextsFound: allContexts.length,
+            isFinal: true
+          });
+          return {
+            success: true,
+            summary,
+            contexts: deduplicateContexts(allContexts),
+            searchCount,
+            durationMs: Date.now() - startTime
+          };
+        }
+        messages.push({ role: "assistant", content: response.content });
+        const toolResults = [];
+        for (const block of response.content) {
+          if (block.type !== "tool_use") continue;
+          if (block.name === "codebase_search") {
+            searchCount++;
+            const input = block.input;
+            const warpResult = await warpGrep.execute({
+              searchTerm: input.searchRequest,
+              repoRoot: config.repoRoot,
+              excludes: config.excludes,
+              includes: config.includes
+            });
+            if (warpResult.contexts) {
+              allContexts.push(...warpResult.contexts);
+            }
+            callbacks.onStep?.({
+              step: searchCount,
+              searchRequest: input.searchRequest,
+              contextsFound: warpResult.contexts?.length ?? 0,
+              isFinal: false
+            });
+            toolResults.push({
+              type: "tool_result",
+              tool_use_id: block.id,
+              content: formatResult(warpResult)
+            });
+          } else if (block.name === "send_message") {
+            const input = block.input;
+            const subagentMsg = {
+              from: "explore",
+              content: input.message,
+              timestamp: Date.now()
+            };
+            let replyText = "";
+            if (callbacks.onMessage) {
+              replyText = await Promise.race([
+                new Promise((resolve2) => {
+                  callbacks.onMessage(subagentMsg, (text) => {
+                    resolve2(text);
+                  });
+                }),
+                new Promise(
+                  (resolve2) => setTimeout(() => resolve2(""), replyTimeout)
+                )
+              ]);
+            }
+            const toolResponse = replyText ? `Response from orchestrator: ${replyText}` : "No response. Continue with your best judgment.";
+            toolResults.push({
+              type: "tool_result",
+              tool_use_id: block.id,
+              content: toolResponse
+            });
+          }
+        }
+        messages.push({ role: "user", content: toolResults });
+      }
+      return {
+        success: true,
+        summary: "Exploration completed (max turns reached).",
+        contexts: deduplicateContexts(allContexts),
+        searchCount,
+        durationMs: Date.now() - startTime
+      };
+    } catch (error) {
+      return {
+        success: false,
+        summary: "",
+        contexts: deduplicateContexts(allContexts),
+        searchCount,
+        durationMs: Date.now() - startTime,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  const exploreTool = Object.assign(
+    {
+      name: "explore",
+      description: "Explore a codebase to answer questions about code structure, find implementations, trace call chains, and understand architecture. Returns a summary of findings.",
+      input_schema: {
+        type: "object",
+        properties: {
+          searchRequest: {
+            type: "string",
+            description: "What to explore in the codebase. Be specific about what you want to understand."
+          }
+        },
+        required: ["searchRequest"]
+      }
+    },
+    {
+      execute: async (input) => {
+        return runExplore(input.searchRequest);
+      },
+      formatResult: (result) => {
+        if (!result.success) {
+          return `Exploration failed: ${result.error}`;
+        }
+        return result.summary;
+      }
+    }
+  );
+  return {
+    /** Anthropic Tool definition for use in parent agents */
+    tool: exploreTool,
+    /** Run exploration with messaging support */
+    run(prompt) {
+      const messageHandlers = [];
+      const stepHandlers = [];
+      let resultPromise = null;
+      const session = {
+        on(event, handler) {
+          if (event === "message") messageHandlers.push(handler);
+          if (event === "step") stepHandlers.push(handler);
+          return session;
+        },
+        send(_text) {
+        },
+        get result() {
+          if (!resultPromise) {
+            resultPromise = runExplore(prompt, {
+              onStep: (step) => {
+                for (const handler of stepHandlers) handler(step);
+              },
+              onMessage: (msg, reply) => {
+                if (messageHandlers.length > 0) {
+                  for (const handler of messageHandlers) handler(msg, reply);
+                } else {
+                  reply("");
+                }
+              }
+            });
+          }
+          return resultPromise;
+        }
+      };
+      return session;
+    },
+    /** Stream exploration events as an async generator */
+    async *stream(prompt) {
+      const events = [];
+      let resolveNext = null;
+      let done = false;
+      const resultPromise = runExplore(prompt, {
+        onStep: (step) => {
+          events.push({
+            type: "step",
+            step: step.step,
+            searchRequest: step.searchRequest,
+            contextsFound: step.contextsFound,
+            isFinal: step.isFinal
+          });
+          resolveNext?.();
+        },
+        onMessage: (msg, reply) => {
+          events.push({
+            type: "message",
+            from: msg.from,
+            content: msg.content,
+            timestamp: msg.timestamp
+          });
+          resolveNext?.();
+          reply("Continue with your best judgment.");
+        }
+      });
+      while (!done) {
+        if (events.length > 0) {
+          yield events.shift();
+        } else {
+          const raceResult = await Promise.race([
+            resultPromise.then((r) => ({ type: "done", result: r })),
+            new Promise((resolve2) => {
+              resolveNext = () => resolve2({ type: "event" });
+            })
+          ]);
+          if (raceResult.type === "done") {
+            while (events.length > 0) {
+              yield events.shift();
+            }
+            done = true;
+            return raceResult.result;
+          }
+        }
+      }
+      return await resultPromise;
+    }
+  };
+}
+function deduplicateContexts(contexts) {
+  const map = /* @__PURE__ */ new Map();
+  for (const ctx of contexts) {
+    const existing = map.get(ctx.file);
+    if (!existing || ctx.content.length > existing.content.length) {
+      map.set(ctx.file, ctx);
+    }
+  }
+  return Array.from(map.values());
+}
+
 // factories/anthropic.ts
 var AnthropicToolFactory = class {
   constructor(config) {
@@ -5415,6 +5771,22 @@ var AnthropicToolFactory = class {
       morphApiKey: this.config.apiKey
     });
   }
+  /**
+   * Create an Explore subagent that searches the codebase and returns summaries
+   *
+   * @param client - Anthropic SDK client instance
+   * @param model - Model name (e.g., 'claude-haiku-4-5-20251001')
+   * @param toolConfig - Subagent configuration (morphApiKey inherited from MorphClient)
+   * @returns Explore subagent with .tool, .run(), and .stream() methods
+   */
+  createExploreSubagent(client, model, toolConfig) {
+    return createExploreSubagent({
+      ...toolConfig,
+      client,
+      model,
+      morphApiKey: this.config.apiKey
+    });
+  }
 };
 
 // tools/warp_grep/vercel.ts
@@ -5580,6 +5952,257 @@ function createEditFileTool3(config = {}) {
   });
 }
 
+// subagents/vercel.ts
+var import_ai4 = require("ai");
+var import_zod4 = require("zod");
+var DEFAULT_MAX_TURNS2 = {
+  quick: 3,
+  medium: 6,
+  thorough: 12
+};
+function getMaxTurns2(config) {
+  return config.maxTurns ?? DEFAULT_MAX_TURNS2[config.thoroughness ?? "medium"] ?? 6;
+}
+function createExploreSubagent2(config) {
+  if (!config.repoRoot) {
+    throw new Error("repoRoot is required for Explore subagent");
+  }
+  const warpGrep = new WarpGrepClient({
+    morphApiKey: config.morphApiKey
+  });
+  const thoroughness = config.thoroughness ?? "medium";
+  const replyTimeout = config.replyTimeout ?? 3e4;
+  async function runExplore(prompt, callbacks = {}) {
+    const startTime = Date.now();
+    const allContexts = [];
+    let searchCount = 0;
+    const timeoutMs = config.timeout;
+    const timeoutPromise = timeoutMs ? new Promise(
+      (_, reject) => setTimeout(() => reject(new Error(`Exploration timed out after ${timeoutMs}ms`)), timeoutMs)
+    ) : null;
+    const runPromise = (async () => {
+      try {
+        const codebaseSearchSchema = import_zod4.z.object({
+          searchRequest: import_zod4.z.string().describe("Natural language description of what to search for")
+        });
+        const sendMessageSchema = import_zod4.z.object({
+          message: import_zod4.z.string().describe("The message to send to the orchestrator")
+        });
+        const result = await (0, import_ai4.generateText)({
+          model: config.model,
+          system: getSystemPrompt2(thoroughness),
+          prompt,
+          tools: {
+            codebase_search: (0, import_ai4.tool)({
+              description: CODEBASE_SEARCH_TOOL.description,
+              inputSchema: codebaseSearchSchema,
+              execute: async (params) => {
+                searchCount++;
+                const warpResult = await warpGrep.execute({
+                  searchTerm: params.searchRequest,
+                  repoRoot: config.repoRoot,
+                  excludes: config.excludes,
+                  includes: config.includes
+                });
+                if (warpResult.contexts) {
+                  allContexts.push(...warpResult.contexts);
+                }
+                callbacks.onStep?.({
+                  step: searchCount,
+                  searchRequest: params.searchRequest,
+                  contextsFound: warpResult.contexts?.length ?? 0,
+                  isFinal: false
+                });
+                return formatResult(warpResult);
+              }
+            }),
+            send_message: (0, import_ai4.tool)({
+              description: SEND_MESSAGE_TOOL.description,
+              inputSchema: sendMessageSchema,
+              execute: async (params) => {
+                const subagentMsg = {
+                  from: "explore",
+                  content: params.message,
+                  timestamp: Date.now()
+                };
+                const replyPromise = new Promise((resolve2) => {
+                  if (callbacks.onMessage) {
+                    callbacks.onMessage(subagentMsg, (replyText) => {
+                      resolve2(replyText);
+                    });
+                  } else {
+                    setTimeout(() => resolve2(""), replyTimeout);
+                  }
+                });
+                const reply = await Promise.race([
+                  replyPromise,
+                  new Promise(
+                    (resolve2) => setTimeout(() => resolve2(""), replyTimeout)
+                  )
+                ]);
+                if (reply) {
+                  return `Response from orchestrator: ${reply}`;
+                }
+                return "No response. Continue with your best judgment.";
+              }
+            })
+          },
+          stopWhen: (0, import_ai4.stepCountIs)(getMaxTurns2(config))
+        });
+        callbacks.onStep?.({
+          step: searchCount,
+          searchRequest: "",
+          contextsFound: allContexts.length,
+          isFinal: true
+        });
+        const uniqueContexts = deduplicateContexts2(allContexts);
+        return {
+          success: true,
+          summary: result.text || "Exploration completed but no summary was generated.",
+          contexts: uniqueContexts,
+          searchCount,
+          durationMs: Date.now() - startTime
+        };
+      } catch (error) {
+        return {
+          success: false,
+          summary: "",
+          contexts: deduplicateContexts2(allContexts),
+          searchCount,
+          durationMs: Date.now() - startTime,
+          error: error instanceof Error ? error.message : String(error)
+        };
+      }
+    })();
+    if (timeoutPromise) {
+      try {
+        return await Promise.race([runPromise, timeoutPromise]);
+      } catch (error) {
+        return {
+          success: false,
+          summary: "",
+          contexts: deduplicateContexts2(allContexts),
+          searchCount,
+          durationMs: Date.now() - startTime,
+          error: error instanceof Error ? error.message : String(error)
+        };
+      }
+    }
+    return runPromise;
+  }
+  const exploreToolSchema = import_zod4.z.object({
+    searchRequest: import_zod4.z.string().describe("What to explore in the codebase. Be specific about what you want to understand.")
+  });
+  const exploreTool = (0, import_ai4.tool)({
+    description: "Explore a codebase to answer questions about code structure, find implementations, trace call chains, and understand architecture. Returns a summary of findings. Use this for broad exploration rather than pinpoint keyword searches.",
+    inputSchema: exploreToolSchema,
+    execute: async (params) => {
+      const result = await runExplore(params.searchRequest);
+      return {
+        success: result.success,
+        summary: result.summary,
+        searchCount: result.searchCount,
+        error: result.error
+      };
+    }
+  });
+  return {
+    /** Vercel AI SDK tool for use as a tool in parent agents */
+    tool: exploreTool,
+    /** Run exploration with messaging support */
+    run(prompt) {
+      const messageHandlers = [];
+      const stepHandlers = [];
+      let resultPromise = null;
+      const session = {
+        on(event, handler) {
+          if (event === "message") messageHandlers.push(handler);
+          if (event === "step") stepHandlers.push(handler);
+          return session;
+        },
+        send(_text) {
+        },
+        get result() {
+          if (!resultPromise) {
+            resultPromise = runExplore(prompt, {
+              onStep: (step) => {
+                for (const handler of stepHandlers) handler(step);
+              },
+              onMessage: (msg, reply) => {
+                if (messageHandlers.length > 0) {
+                  for (const handler of messageHandlers) handler(msg, reply);
+                } else {
+                  reply("");
+                }
+              }
+            });
+          }
+          return resultPromise;
+        }
+      };
+      return session;
+    },
+    /** Stream exploration events as an async generator */
+    async *stream(prompt) {
+      const events = [];
+      let resolveNext = null;
+      let done = false;
+      const resultPromise = runExplore(prompt, {
+        onStep: (step) => {
+          events.push({
+            type: "step",
+            step: step.step,
+            searchRequest: step.searchRequest,
+            contextsFound: step.contextsFound,
+            isFinal: step.isFinal
+          });
+          resolveNext?.();
+        },
+        onMessage: (msg, reply) => {
+          events.push({
+            type: "message",
+            from: msg.from,
+            content: msg.content,
+            timestamp: msg.timestamp
+          });
+          resolveNext?.();
+          reply("Continue with your best judgment.");
+        }
+      });
+      while (!done) {
+        if (events.length > 0) {
+          yield events.shift();
+        } else {
+          const raceResult = await Promise.race([
+            resultPromise.then((r) => ({ type: "done", result: r })),
+            new Promise((resolve2) => {
+              resolveNext = () => resolve2({ type: "event" });
+            })
+          ]);
+          if (raceResult.type === "done") {
+            while (events.length > 0) {
+              yield events.shift();
+            }
+            done = true;
+            return raceResult.result;
+          }
+        }
+      }
+      return await resultPromise;
+    }
+  };
+}
+function deduplicateContexts2(contexts) {
+  const map = /* @__PURE__ */ new Map();
+  for (const ctx of contexts) {
+    const existing = map.get(ctx.file);
+    if (!existing || ctx.content.length > existing.content.length) {
+      map.set(ctx.file, ctx);
+    }
+  }
+  return Array.from(map.values());
+}
+
 // factories/vercel.ts
 var VercelToolFactory = class {
   constructor(config) {
@@ -5633,6 +6256,20 @@ var VercelToolFactory = class {
       morphApiKey: this.config.apiKey
     });
   }
+  /**
+   * Create an Explore subagent that searches the codebase and returns summaries
+   *
+   * @param model - Vercel AI SDK model instance
+   * @param toolConfig - Subagent configuration (morphApiKey inherited from MorphClient)
+   * @returns Explore subagent with .tool, .run(), and .stream() methods
+   */
+  createExploreSubagent(model, toolConfig) {
+    return createExploreSubagent2({
+      ...toolConfig,
+      model,
+      morphApiKey: this.config.apiKey
+    });
+  }
 };
 
 // client.ts