@morphllm/morphsdk 0.2.6

package/dist/tools/browser/vercel.cjs

@@ -0,0 +1,242 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// tools/browser/vercel.ts
+var vercel_exports = {};
+__export(vercel_exports, {
+  browserTool: () => browserTool,
+  createBrowserTool: () => createBrowserTool
+});
+module.exports = __toCommonJS(vercel_exports);
+var import_ai = require("ai");
+var import_zod = require("zod");
+
+// tools/utils/resilience.ts
+var DEFAULT_RETRY_CONFIG = {
+  maxRetries: 3,
+  initialDelay: 1e3,
+  maxDelay: 3e4,
+  backoffMultiplier: 2,
+  retryableErrors: ["ECONNREFUSED", "ETIMEDOUT", "ENOTFOUND"]
+};
+async function fetchWithRetry(url, options, retryConfig = {}) {
+  const {
+    maxRetries = DEFAULT_RETRY_CONFIG.maxRetries,
+    initialDelay = DEFAULT_RETRY_CONFIG.initialDelay,
+    maxDelay = DEFAULT_RETRY_CONFIG.maxDelay,
+    backoffMultiplier = DEFAULT_RETRY_CONFIG.backoffMultiplier,
+    retryableErrors = DEFAULT_RETRY_CONFIG.retryableErrors,
+    onRetry
+  } = retryConfig;
+  let lastError = null;
+  let delay = initialDelay;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      const response = await fetch(url, options);
+      if (response.status === 429 || response.status === 503) {
+        if (attempt < maxRetries) {
+          const retryAfter = response.headers.get("Retry-After");
+          const waitTime = retryAfter ? parseInt(retryAfter) * 1e3 : Math.min(delay, maxDelay);
+          const error = new Error(`HTTP ${response.status}: Retrying after ${waitTime}ms`);
+          if (onRetry) {
+            onRetry(attempt + 1, error);
+          }
+          await sleep(waitTime);
+          delay *= backoffMultiplier;
+          continue;
+        }
+      }
+      return response;
+    } catch (error) {
+      lastError = error;
+      const isRetryable = retryableErrors.some(
+        (errType) => lastError?.message?.includes(errType)
+      );
+      if (!isRetryable || attempt === maxRetries) {
+        throw lastError;
+      }
+      const waitTime = Math.min(delay, maxDelay);
+      if (onRetry) {
+        onRetry(attempt + 1, lastError);
+      }
+      await sleep(waitTime);
+      delay *= backoffMultiplier;
+    }
+  }
+  throw lastError || new Error("Max retries exceeded");
+}
+async function withTimeout(promise, timeoutMs, errorMessage) {
+  let timeoutId;
+  const timeoutPromise = new Promise((_, reject) => {
+    timeoutId = setTimeout(() => {
+      reject(new Error(errorMessage || `Operation timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+  });
+  try {
+    const result = await Promise.race([promise, timeoutPromise]);
+    clearTimeout(timeoutId);
+    return result;
+  } catch (error) {
+    clearTimeout(timeoutId);
+    throw error;
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// tools/browser/core.ts
+var DEFAULT_CONFIG = {
+  apiUrl: process.env.MORPH_ENVIRONMENT === "DEV" ? "http://localhost:8000" : "https://browser.morphllm.com",
+  timeout: 12e4,
+  // 2 minutes for complex tasks
+  debug: false
+};
+async function executeBrowserTask(input, config = {}) {
+  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;
+  const timeout = config.timeout || DEFAULT_CONFIG.timeout;
+  const debug = config.debug || false;
+  if (!input.task || input.task.trim().length === 0) {
+    return { success: false, error: "Task description is required" };
+  }
+  if (input.max_steps !== void 0 && (input.max_steps < 1 || input.max_steps > 50)) {
+    return { success: false, error: "max_steps must be between 1 and 50" };
+  }
+  if (debug) {
+    console.log(`[Browser] Task: "${input.task.slice(0, 60)}..." url=${input.url || "none"} maxSteps=${input.max_steps ?? 10}`);
+    console.log(`[Browser] Recording: ${input.record_video ? "yes" : "no"} | Calling ${apiUrl}/browser-task`);
+  }
+  const startTime = Date.now();
+  try {
+    const headers = { "Content-Type": "application/json" };
+    if (config.apiKey) headers["Authorization"] = `Bearer ${config.apiKey}`;
+    const fetchPromise = fetchWithRetry(
+      `${apiUrl}/browser-task`,
+      {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+          task: input.task,
+          url: input.url,
+          max_steps: input.max_steps ?? 10,
+          model: input.model ?? "morph-computer-use-v0",
+          viewport_width: input.viewport_width ?? 1280,
+          viewport_height: input.viewport_height ?? 720,
+          repo_id: input.repo_id,
+          commit_id: input.commit_id,
+          record_video: input.record_video ?? false,
+          video_width: input.video_width ?? input.viewport_width ?? 1280,
+          video_height: input.video_height ?? input.viewport_height ?? 720,
+          structured_output: input.structured_output
+        })
+      },
+      config.retryConfig
+    );
+    const response = await withTimeout(
+      fetchPromise,
+      timeout,
+      `Browser task timed out after ${timeout}ms. Consider increasing timeout or reducing max_steps.`
+    );
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => response.statusText);
+      if (debug) console.error(`[Browser] Error: ${response.status} - ${errorText}`);
+      throw new Error(`HTTP ${response.status}: ${errorText}`);
+    }
+    const result = await response.json();
+    const elapsed = Date.now() - startTime;
+    if (debug) {
+      console.log(`[Browser] \u2705 ${result.success ? "Success" : "Failed"} in ${elapsed}ms | steps=${result.steps_taken ?? 0} recordingId=${result.recording_id ?? "none"}`);
+    }
+    return result;
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.message.includes("ECONNREFUSED") || error.message.includes("fetch failed")) {
+        return {
+          success: false,
+          error: `Cannot connect to browser worker at ${apiUrl}. Ensure the service is running.`
+        };
+      }
+      return {
+        success: false,
+        error: error.message
+      };
+    }
+    return {
+      success: false,
+      error: String(error)
+    };
+  }
+}
+
+// tools/browser/prompts.ts
+var BROWSER_TOOL_DESCRIPTION = `Execute natural language browser automation tasks using an AI-powered agent. The agent can navigate websites, interact with elements, fill forms, click buttons, and verify functionality.
+
+Use this tool to:
+- Test web applications end-to-end
+- Verify UI functionality
+- Automate user workflows
+- Extract information from web pages
+
+The agent uses GPT-4o-mini to interpret your task and execute the necessary browser actions. It runs in a remote browser via Browserless.io, so it can access any publicly accessible URL.
+
+Important:
+- Provide clear, specific task descriptions
+- Include the starting URL if navigating to a specific page
+- Use remote URLs (e.g., https://3000-xyz.e2b.dev) not localhost
+- Complex tasks may require more max_steps`;
+
+// tools/browser/vercel.ts
+function createBrowserTool(config) {
+  const schema = import_zod.z.object({
+    task: import_zod.z.string().describe('Natural language description of what to do (e.g., "Test checkout flow for buying a pineapple")'),
+    url: import_zod.z.string().optional().describe("Starting URL (e.g., https://3000-xyz.e2b.dev)"),
+    max_steps: import_zod.z.number().min(1).max(50).default(10).describe("Maximum number of browser actions to take"),
+    region: import_zod.z.enum(["sfo", "lon"]).default("sfo").describe("Browserless region: sfo (US West) or lon (Europe)")
+  });
+  return (0, import_ai.tool)({
+    description: BROWSER_TOOL_DESCRIPTION,
+    parameters: schema,
+    execute: async (params) => {
+      const { task, url, max_steps, region } = params;
+      const result = await executeBrowserTask(
+        { task, url, max_steps, region },
+        config
+      );
+      if (result.success) {
+        return {
+          success: true,
+          result: result.result,
+          steps_taken: result.steps_taken,
+          execution_time_ms: result.execution_time_ms
+        };
+      }
+      return {
+        success: false,
+        error: result.error
+      };
+    }
+  });
+}
+var browserTool = createBrowserTool();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  browserTool,
+  createBrowserTool
+});
+//# sourceMappingURL=vercel.cjs.map

package/dist/tools/browser/vercel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../tools/browser/vercel.ts","../../../tools/utils/resilience.ts","../../../tools/browser/core.ts","../../../tools/browser/prompts.ts"],"sourcesContent":["/**\n * Vercel AI SDK adapter for browser automation tool\n */\n\nimport { tool as createTool } from 'ai';\nimport { z } from 'zod';\nimport { executeBrowserTask } from './core.js';\nimport type { BrowserConfig } from './types.js';\nimport { BROWSER_TOOL_DESCRIPTION } from './prompts.js';\n\n/**\n * Create Vercel AI SDK tool for browser automation\n * \n * @param config - Optional browser worker configuration\n * @returns Vercel AI SDK tool\n * \n * @example\n * ```typescript\n * import { generateText } from 'ai';\n * import { anthropic } from '@ai-sdk/anthropic';\n * import { createBrowserTool } from 'morphsdk/tools/browser/vercel';\n * \n * const browserTool = createBrowserTool({\n *   apiUrl: 'https://browser-worker.example.com'\n * });\n * \n * const result = await generateText({\n *   model: anthropic('claude-sonnet-4-5-20250929'),\n *   tools: { browserTask: browserTool },\n *   prompt: 'Test the checkout flow at https://3000-abc.e2b.dev',\n *   maxSteps: 5\n * });\n * ```\n */\nexport function createBrowserTool(config?: BrowserConfig) {\n  const schema = z.object({\n    task: z.string().describe('Natural language description of what to do (e.g., \"Test checkout flow for buying a pineapple\")'),\n    url: z.string().optional().describe('Starting URL (e.g., https://3000-xyz.e2b.dev)'),\n    max_steps: z.number().min(1).max(50).default(10).describe('Maximum number of browser actions to take'),\n    region: z.enum(['sfo', 'lon']).default('sfo').describe('Browserless region: sfo (US West) or lon (Europe)'),\n  });\n\n  return createTool({\n    description: BROWSER_TOOL_DESCRIPTION,\n    parameters: schema,\n    execute: async (params) => {\n      const { task, url, max_steps, region } = params;\n      const result = await executeBrowserTask(\n        { task, url, max_steps, region },\n        config\n      );\n\n      if (result.success) {\n        return {\n          success: true,\n          result: result.result,\n          steps_taken: result.steps_taken,\n          execution_time_ms: result.execution_time_ms,\n        };\n      }\n\n      return {\n        success: false,\n        error: result.error,\n      };\n    },\n  });\n}\n\n/**\n * Default browser tool for Vercel AI SDK\n */\nexport const browserTool = createBrowserTool();\n\n","/**\n * Resilience utilities for retry logic and timeout handling\n */\n\nexport interface RetryConfig {\n  maxRetries?: number;        // Default: 3\n  initialDelay?: number;      // Default: 1000ms\n  maxDelay?: number;          // Default: 30000ms\n  backoffMultiplier?: number; // Default: 2\n  retryableErrors?: string[]; // Default: ['ECONNREFUSED', 'ETIMEDOUT', 'ENOTFOUND']\n  onRetry?: (attempt: number, error: Error) => void;\n}\n\nconst DEFAULT_RETRY_CONFIG: Required<Omit<RetryConfig, 'onRetry'>> = {\n  maxRetries: 3,\n  initialDelay: 1000,\n  maxDelay: 30000,\n  backoffMultiplier: 2,\n  retryableErrors: ['ECONNREFUSED', 'ETIMEDOUT', 'ENOTFOUND'],\n};\n\n/**\n * Retry a fetch request with exponential backoff\n * \n * @param url - Request URL\n * @param options - Fetch options\n * @param retryConfig - Retry configuration\n * @returns Response from fetch\n * \n * @example\n * ```typescript\n * const response = await fetchWithRetry(\n *   'https://api.example.com/data',\n *   { method: 'POST', body: JSON.stringify(data) },\n *   { maxRetries: 5, initialDelay: 500 }\n * );\n * ```\n */\nexport async function fetchWithRetry(\n  url: string,\n  options: RequestInit,\n  retryConfig: RetryConfig = {}\n): Promise<Response> {\n  const {\n    maxRetries = DEFAULT_RETRY_CONFIG.maxRetries,\n    initialDelay = DEFAULT_RETRY_CONFIG.initialDelay,\n    maxDelay = DEFAULT_RETRY_CONFIG.maxDelay,\n    backoffMultiplier = DEFAULT_RETRY_CONFIG.backoffMultiplier,\n    retryableErrors = DEFAULT_RETRY_CONFIG.retryableErrors,\n    onRetry,\n  } = retryConfig;\n\n  let lastError: Error | null = null;\n  let delay = initialDelay;\n\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    try {\n      const response = await fetch(url, options);\n      \n      // Retry on 429 (rate limit) or 503 (service unavailable)\n      if (response.status === 429 || response.status === 503) {\n        if (attempt < maxRetries) {\n          // Check for Retry-After header\n          const retryAfter = response.headers.get('Retry-After');\n          const waitTime = retryAfter \n            ? parseInt(retryAfter) * 1000 \n            : Math.min(delay, maxDelay);\n          \n          const error = new Error(`HTTP ${response.status}: Retrying after ${waitTime}ms`);\n          if (onRetry) {\n            onRetry(attempt + 1, error);\n          }\n          \n          await sleep(waitTime);\n          delay *= backoffMultiplier;\n          continue;\n        }\n      }\n\n      return response;\n    } catch (error) {\n      lastError = error as Error;\n      \n      // Check if error is retryable\n      const isRetryable = retryableErrors.some(errType => \n        lastError?.message?.includes(errType)\n      );\n\n      if (!isRetryable || attempt === maxRetries) {\n        throw lastError;\n      }\n\n      // Exponential backoff\n      const waitTime = Math.min(delay, maxDelay);\n      if (onRetry) {\n        onRetry(attempt + 1, lastError);\n      }\n      \n      await sleep(waitTime);\n      delay *= backoffMultiplier;\n    }\n  }\n\n  throw lastError || new Error('Max retries exceeded');\n}\n\n/**\n * Add timeout to any promise\n * \n * @param promise - Promise to wrap with timeout\n * @param timeoutMs - Timeout in milliseconds\n * @param errorMessage - Optional custom error message\n * @returns Promise that rejects if timeout is reached\n * \n * @example\n * ```typescript\n * const result = await withTimeout(\n *   fetchData(),\n *   5000,\n *   'Data fetch timed out'\n * );\n * ```\n */\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number,\n  errorMessage?: string\n): Promise<T> {\n  let timeoutId: NodeJS.Timeout | number;\n  \n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeoutId = setTimeout(() => {\n      reject(new Error(errorMessage || `Operation timed out after ${timeoutMs}ms`));\n    }, timeoutMs);\n  });\n\n  try {\n    const result = await Promise.race([promise, timeoutPromise]);\n    clearTimeout(timeoutId!);\n    return result;\n  } catch (error) {\n    clearTimeout(timeoutId!);\n    throw error;\n  }\n}\n\n/**\n * Sleep for specified milliseconds\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Unified error type for all tools\n */\nexport class MorphError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public statusCode?: number,\n    public retryable: boolean = false\n  ) {\n    super(message);\n    this.name = 'MorphError';\n  }\n}\n\n\n","/**\n * Core implementation for browser automation tasks\n */\n\nimport { fetchWithRetry, withTimeout } from '../utils/resilience.js';\nimport type {\n  BrowserConfig,\n  BrowserTaskInput,\n  BrowserTaskInputWithSchema,\n  BrowserTaskResult,\n  BrowserTaskWithPromise,\n  BrowserTaskWithPromiseAndSchema,\n  RecordingStatus,\n  ErrorsResponse,\n} from './types.js';\n\nconst DEFAULT_CONFIG = {\n  apiUrl: process.env.MORPH_ENVIRONMENT === 'DEV' \n    ? 'http://localhost:8000'\n    : 'https://browser.morphllm.com',\n  timeout: 120000, // 2 minutes for complex tasks\n  debug: false,\n};\n\n/**\n * BrowserClient class for easier usage with instance configuration\n */\nexport class BrowserClient {\n  private config: BrowserConfig;\n\n  constructor(config: BrowserConfig = {}) {\n    this.config = {\n      ...DEFAULT_CONFIG,\n      ...config,\n    };\n  }\n\n  /**\n   * Execute a browser automation task\n   */\n  async execute(input: BrowserTaskInput): Promise<BrowserTaskResult> {\n    return executeBrowserTask(input, this.config);\n  }\n\n  async createTask(input: BrowserTaskInput): Promise<BrowserTaskWithPromise>;\n  async createTask<T>(input: BrowserTaskInputWithSchema<T>): Promise<BrowserTaskWithPromiseAndSchema<T>>;\n  async createTask<T>(\n    input: BrowserTaskInput | BrowserTaskInputWithSchema<T>\n  ): Promise<BrowserTaskWithPromise | BrowserTaskWithPromiseAndSchema<T>> {\n    if ('schema' in input) {\n      const taskInput: BrowserTaskInput = {\n        ...input,\n        structured_output: stringifyStructuredOutput(input.schema),\n      };\n      const result = await executeBrowserTask(taskInput, this.config);\n      return wrapTaskResponseWithSchema(result, this.config, input.schema);\n    } else {\n      const result = await executeBrowserTask(input, this.config);\n      return wrapTaskResponse(result, this.config);\n    }\n  }\n\n  /**\n   * Execute task with recording and wait for video to be ready\n   */\n  async executeWithRecording(\n    input: BrowserTaskInput & { record_video: true }\n  ): Promise<BrowserTaskResult & { recording?: RecordingStatus }> {\n    return executeWithRecording(input, this.config);\n  }\n\n  /**\n   * Get recording status and URLs\n   */\n  async getRecording(recordingId: string): Promise<RecordingStatus> {\n    return getRecording(recordingId, this.config);\n  }\n\n  /**\n   * Wait for recording to complete with automatic polling\n   */\n  async waitForRecording(\n    recordingId: string,\n    options?: { timeout?: number; pollInterval?: number }\n  ): Promise<RecordingStatus> {\n    return waitForRecording(recordingId, this.config, options);\n  }\n\n  /**\n   * Get errors from recording with screenshots\n   */\n  async getErrors(recordingId: string): Promise<ErrorsResponse> {\n    return getErrors(recordingId, this.config);\n  }\n\n  /**\n   * Check if browser worker service is healthy\n   */\n  async checkHealth(): Promise<{\n    ok: boolean;\n    google_configured: boolean;\n    database_configured: boolean;\n    s3_configured: boolean;\n    error?: string;\n  }> {\n    return checkHealth(this.config);\n  }\n}\n\n/**\n * Execute a natural language browser automation task\n * \n * @param input - Task parameters\n * @param config - Optional configuration (apiKey, apiUrl to override default)\n * @returns Task result with success status and findings\n * \n * @example\n * ```typescript\n * const result = await executeBrowserTask(\n *   {\n *     task: \"Test checkout flow for buying a pineapple\",\n *     url: \"https://3000-abc.e2b.dev\",\n *     max_steps: 20,\n *     repo_id: \"my-project\",\n *     commit_id: \"uuid-here\"\n *   },\n *   {\n *     apiKey: process.env.MORPH_API_KEY,\n *     // apiUrl: 'http://localhost:8001' // Override for local testing\n *   }\n * );\n * \n * if (result.success) {\n *   console.log('Task completed:', result.result);\n *   console.log('Replay:', result.replay_url);\n * }\n * ```\n */\nexport async function executeBrowserTask(\n  input: BrowserTaskInput,\n  config: BrowserConfig = {}\n): Promise<BrowserTaskResult> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const timeout = config.timeout || DEFAULT_CONFIG.timeout;\n  const debug = config.debug || false;\n\n  if (!input.task || input.task.trim().length === 0) {\n    return { success: false, error: 'Task description is required' };\n  }\n\n  if (input.max_steps !== undefined && (input.max_steps < 1 || input.max_steps > 50)) {\n    return { success: false, error: 'max_steps must be between 1 and 50' };\n  }\n\n  if (debug) {\n    console.log(`[Browser] Task: \"${input.task.slice(0, 60)}...\" url=${input.url || 'none'} maxSteps=${input.max_steps ?? 10}`);\n    console.log(`[Browser] Recording: ${input.record_video ? 'yes' : 'no'} | Calling ${apiUrl}/browser-task`);\n  }\n\n  const startTime = Date.now();\n\n  try {\n    const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n    if (config.apiKey) headers['Authorization'] = `Bearer ${config.apiKey}`;\n\n    const fetchPromise = fetchWithRetry(\n      `${apiUrl}/browser-task`,\n      {\n        method: 'POST',\n        headers,\n        body: JSON.stringify({\n          task: input.task,\n          url: input.url,\n          max_steps: input.max_steps ?? 10,\n          model: input.model ?? 'morph-computer-use-v0',\n          viewport_width: input.viewport_width ?? 1280,\n          viewport_height: input.viewport_height ?? 720,\n          repo_id: input.repo_id,\n          commit_id: input.commit_id,\n          record_video: input.record_video ?? false,\n          video_width: input.video_width ?? input.viewport_width ?? 1280,\n          video_height: input.video_height ?? input.viewport_height ?? 720,\n          structured_output: input.structured_output,\n        }),\n      },\n      config.retryConfig\n    );\n\n    const response = await withTimeout(\n      fetchPromise,\n      timeout,\n      `Browser task timed out after ${timeout}ms. Consider increasing timeout or reducing max_steps.`\n    );\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => response.statusText);\n      if (debug) console.error(`[Browser] Error: ${response.status} - ${errorText}`);\n      throw new Error(`HTTP ${response.status}: ${errorText}`);\n    }\n\n    const result: BrowserTaskResult = await response.json();\n    const elapsed = Date.now() - startTime;\n    \n    if (debug) {\n      console.log(`[Browser] ✅ ${result.success ? 'Success' : 'Failed'} in ${elapsed}ms | steps=${result.steps_taken ?? 0} recordingId=${result.recording_id ?? 'none'}`);\n    }\n\n    return result;\n\n  } catch (error) {\n    if (error instanceof Error) {\n      // Handle network errors\n      if (error.message.includes('ECONNREFUSED') || error.message.includes('fetch failed')) {\n        return {\n          success: false,\n          error: `Cannot connect to browser worker at ${apiUrl}. Ensure the service is running.`,\n        };\n      }\n\n      return {\n        success: false,\n        error: error.message,\n      };\n    }\n\n    return {\n      success: false,\n      error: String(error),\n    };\n  }\n}\n\n/**\n * Get recording status and video URL\n * \n * @param recordingId - Recording UUID from BrowserTaskResult\n * @param config - Configuration with apiKey\n * @returns Recording status with video URL when ready\n * \n * @example\n * ```typescript\n * const status = await getRecording('uuid-here', { apiKey: 'key' });\n * if (status.status === 'COMPLETED' && status.video_url) {\n *   console.log('Video ready:', status.video_url);\n * }\n * ```\n */\nexport async function getRecording(\n  recordingId: string,\n  config: BrowserConfig = {}\n): Promise<RecordingStatus> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const debug = config.debug || false;\n\n  if (!config.apiKey) {\n    throw new Error('API key required for getRecording');\n  }\n\n  if (debug) console.log(`[Browser] getRecording: ${recordingId}`);\n\n  const response = await fetch(`${apiUrl}/recordings/${recordingId}`, {\n    method: 'GET',\n    headers: { 'Authorization': `Bearer ${config.apiKey}` },\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    if (debug) console.error(`[Browser] getRecording error: ${response.status} - ${errorText}`);\n    throw new Error(`HTTP ${response.status}: ${errorText}`);\n  }\n\n  const recording = await response.json();\n  if (debug) console.log(`[Browser] Recording status: ${recording.status}`);\n\n  return recording;\n}\n\n/**\n * Wait for recording to complete with automatic polling\n * \n * @param recordingId - Recording UUID\n * @param config - Configuration with apiKey\n * @param options - Polling options\n * @returns Recording status when completed or errored\n * \n * @example\n * ```typescript\n * const result = await executeBrowserTask({ task: '...', record_video: true }, config);\n * if (result.recording_id) {\n *   const recording = await waitForRecording(result.recording_id, config, {\n *     timeout: 60000,  // 1 minute\n *     pollInterval: 2000  // Check every 2 seconds\n *   });\n *   console.log('Video URL:', recording.video_url);\n * }\n * ```\n */\nexport async function waitForRecording(\n  recordingId: string,\n  config: BrowserConfig = {},\n  options: { timeout?: number; pollInterval?: number } = {}\n): Promise<RecordingStatus> {\n  const timeout = options.timeout ?? 60000; // Default 1 minute\n  const pollInterval = options.pollInterval ?? 2000; // Default 2 seconds\n  const startTime = Date.now();\n\n  while (Date.now() - startTime < timeout) {\n    const status = await getRecording(recordingId, config);\n    \n    if (status.status === 'COMPLETED' || status.status === 'ERROR') {\n      return status;\n    }\n\n    // Wait before next poll\n    await new Promise(resolve => setTimeout(resolve, pollInterval));\n  }\n\n  throw new Error(`Recording timeout after ${timeout}ms - status still pending`);\n}\n\n/**\n * Execute task with recording and wait for video to be ready\n * \n * @param input - Task parameters with record_video=true\n * @param config - Configuration with apiKey\n * @returns Task result with ready video URL\n * \n * @example\n * ```typescript\n * const result = await executeWithRecording(\n *   {\n *     task: \"Test checkout flow\",\n *     url: \"https://example.com\",\n *     record_video: true,\n *     repo_id: \"my-project\"\n *   },\n *   { apiKey: process.env.MORPH_API_KEY }\n * );\n * \n * console.log('Task result:', result.result);\n * console.log('Video URL:', result.recording?.video_url);\n * ```\n */\nexport async function executeWithRecording(\n  input: BrowserTaskInput & { record_video: true },\n  config: BrowserConfig = {}\n): Promise<BrowserTaskResult & { recording?: RecordingStatus }> {\n  // Execute task with recording\n  const taskResult = await executeBrowserTask(input, config);\n\n  // If recording was created, wait for it to complete\n  if (taskResult.recording_id) {\n    try {\n      const recording = await waitForRecording(\n        taskResult.recording_id,\n        config,\n        { timeout: 60000, pollInterval: 2000 }\n      );\n      return {\n        ...taskResult,\n        recording,\n      };\n    } catch (error) {\n      // Return task result even if recording fails\n      return {\n        ...taskResult,\n        recording: {\n          id: taskResult.recording_id,\n          status: 'ERROR',\n          error: error instanceof Error ? error.message : String(error),\n          created_at: new Date().toISOString(),\n        },\n      };\n    }\n  }\n\n  return taskResult;\n}\n\n/**\n * Get errors from recording with screenshots\n * \n * Screenshots are captured in real-time (500ms after error occurs) during the browser session.\n * \n * @param recordingId - Recording UUID from BrowserTaskResult\n * @param config - Configuration with apiKey\n * @returns Errors with real-time screenshots\n * \n * @example\n * ```typescript\n * const { errors, total_errors } = await getErrors('uuid-here', { apiKey: 'key' });\n * \n * console.log(`Found ${total_errors} errors`);\n * \n * errors.forEach(err => {\n *   console.log(`[${err.type}] ${err.message}`);\n *   if (err.url) console.log(`  URL: ${err.url}`);\n *   if (err.screenshot_url) console.log(`  Screenshot: ${err.screenshot_url}`);\n *   \n *   // Download screenshot\n *   if (err.screenshot_url) {\n *     const response = await fetch(err.screenshot_url);\n *     const screenshot = await response.arrayBuffer();\n *     // Save or process screenshot\n *   }\n * });\n * ```\n */\nexport async function getErrors(\n  recordingId: string,\n  config: BrowserConfig = {}\n): Promise<ErrorsResponse> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const debug = config.debug || false;\n\n  if (!config.apiKey) {\n    throw new Error('API key required for getErrors');\n  }\n\n  if (debug) console.log(`[Browser] getErrors: ${recordingId}`);\n\n  const response = await fetch(`${apiUrl}/recordings/${recordingId}/errors`, {\n    method: 'GET',\n    headers: { 'Authorization': `Bearer ${config.apiKey}` },\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    if (debug) console.error(`[Browser] getErrors error: ${response.status} - ${errorText}`);\n    throw new Error(`HTTP ${response.status}: ${errorText}`);\n  }\n\n  const errors = await response.json();\n  if (debug) console.log(`[Browser] Found ${errors.total_errors} errors`);\n\n  return errors;\n}\n\n/**\n * Helper to serialize Zod schema for API\n */\nfunction stringifyStructuredOutput(schema: any): string {\n  try {\n    return JSON.stringify({\n      type: 'object',\n      description: 'Zod schema definition (Zod v3)',\n      zodDef: schema._def,\n    });\n  } catch (error) {\n    console.warn('[Browser] Failed to serialize Zod schema:', error);\n    return JSON.stringify({\n      type: 'object',\n      description: 'Schema serialization failed',\n    });\n  }\n}\n\n/**\n * Parse and validate structured task output\n */\nfunction parseStructuredTaskOutput<T>(\n  result: BrowserTaskResult,\n  schema: any\n): BrowserTaskResult & { parsed: T | null } {\n  if (!result.output) {\n    return { ...result, parsed: null };\n  }\n\n  try {\n    const parsed = JSON.parse(result.output);\n    const validated = schema.parse(parsed) as T;\n    return { ...result, parsed: validated };\n  } catch (error) {\n    if (error instanceof SyntaxError) {\n      return { ...result, parsed: null };\n    }\n    throw error;\n  }\n}\n\n/**\n * Get current task status\n */\nasync function getTaskStatus(\n  taskId: string,\n  config: BrowserConfig\n): Promise<BrowserTaskResult> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const debug = config.debug || false;\n\n  if (debug) console.log(`[Browser] getTaskStatus: ${taskId}`);\n\n  const headers: Record<string, string> = {};\n  if (config.apiKey) headers['Authorization'] = `Bearer ${config.apiKey}`;\n\n  const response = await fetch(`${apiUrl}/tasks/${taskId}`, {\n    method: 'GET',\n    headers,\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    if (debug) console.error(`[Browser] getTaskStatus error: ${response.status} - ${errorText}`);\n    throw new Error(`HTTP ${response.status}: ${errorText}`);\n  }\n\n  const result: BrowserTaskResult = await response.json();\n  if (debug) console.log(`[Browser] Task status: ${result.status}`);\n\n  return result;\n}\n\n/**\n * Generate live URL for watching task execution in real-time\n */\nfunction generateLiveUrl(taskId: string, config: BrowserConfig): string {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const baseUrl = apiUrl.replace('/api', '');\n  return `${baseUrl}/tasks/${taskId}/live`;\n}\n\n/**\n * Poll task until completion\n */\nasync function pollTaskUntilComplete(\n  taskId: string,\n  config: BrowserConfig,\n  pollConfig: { interval?: number; timeout?: number } = {}\n): Promise<BrowserTaskResult> {\n  const interval = pollConfig.interval ?? 2000; // 2 seconds\n  const timeout = pollConfig.timeout ?? 300000; // 5 minutes\n  const startTime = Date.now();\n\n  while (Date.now() - startTime < timeout) {\n    const status = await getTaskStatus(taskId, config);\n    \n    if (status.status === 'completed' || status.status === 'failed') {\n      return status;\n    }\n\n    await new Promise(resolve => setTimeout(resolve, interval));\n  }\n\n  throw new Error(`Task polling timeout after ${timeout}ms`);\n}\n\n/**\n * Wrap task response with convenience methods\n */\nfunction wrapTaskResponse(\n  result: BrowserTaskResult,\n  config: BrowserConfig\n): BrowserTaskWithPromise {\n  if (!result.task_id) {\n    throw new Error('task_id is required to wrap response');\n  }\n\n  return {\n    ...result,\n    task_id: result.task_id,\n    liveUrl: generateLiveUrl(result.task_id, config),\n    complete: async (pollConfig?: { interval?: number; timeout?: number }) => {\n      return pollTaskUntilComplete(result.task_id!, config, pollConfig);\n    },\n  };\n}\n\n/**\n * Wrap task response with schema validation\n */\nfunction wrapTaskResponseWithSchema<T>(\n  result: BrowserTaskResult,\n  config: BrowserConfig,\n  schema: any\n): BrowserTaskWithPromiseAndSchema<T> {\n  if (!result.task_id) {\n    throw new Error('task_id is required to wrap response');\n  }\n\n  const parsed = result.output\n    ? parseStructuredTaskOutput<T>(result, schema)\n    : { ...result, parsed: null };\n\n  return {\n    ...parsed,\n    task_id: result.task_id,\n    liveUrl: generateLiveUrl(result.task_id, config),\n    complete: async (pollConfig?: { interval?: number; timeout?: number }) => {\n      const finalResult = await pollTaskUntilComplete(result.task_id!, config, pollConfig);\n      return parseStructuredTaskOutput<T>(finalResult, schema);\n    },\n  };\n}\n\n/**\n * Check if browser worker service is healthy\n * \n * @param config - Optional configuration\n * @returns Health status\n */\nexport async function checkHealth(config: BrowserConfig = {}): Promise<{\n  ok: boolean;\n  google_configured: boolean;\n  database_configured: boolean;\n  s3_configured: boolean;\n  error?: string;\n}> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n\n  try {\n    const response = await fetch(`${apiUrl}/health`, {\n      method: 'GET',\n      headers: config.apiKey\n        ? { 'Authorization': `Bearer ${config.apiKey}` }\n        : {},\n    });\n\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}`);\n    }\n\n    const data = await response.json();\n    return {\n      ok: true,\n      google_configured: data.google_configured ?? false,\n      database_configured: data.database_configured ?? false,\n      s3_configured: data.s3_configured ?? false,\n    };\n  } catch (error) {\n    return {\n      ok: false,\n      google_configured: false,\n      database_configured: false,\n      s3_configured: false,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n","/**\n * Tool descriptions and prompts for AI models\n */\n\nexport const BROWSER_TOOL_DESCRIPTION = `Execute natural language browser automation tasks using an AI-powered agent. The agent can navigate websites, interact with elements, fill forms, click buttons, and verify functionality.\n\nUse this tool to:\n- Test web applications end-to-end\n- Verify UI functionality\n- Automate user workflows\n- Extract information from web pages\n\nThe agent uses GPT-4o-mini to interpret your task and execute the necessary browser actions. It runs in a remote browser via Browserless.io, so it can access any publicly accessible URL.\n\nImportant:\n- Provide clear, specific task descriptions\n- Include the starting URL if navigating to a specific page\n- Use remote URLs (e.g., https://3000-xyz.e2b.dev) not localhost\n- Complex tasks may require more max_steps`;\n\nexport const BROWSER_SYSTEM_PROMPT = `You have access to browser automation capabilities. When testing or interacting with web applications:\n\n1. Be specific about what you're testing or verifying\n2. Break complex tasks into clear steps\n3. Always provide the full URL including protocol (https://)\n4. For localhost apps, use the remote tunnel URL (e.g., e2b.dev URLs)\n5. Specify the number of steps needed - simple tasks use 5-10, complex flows use 15-30\n\nExample good tasks:\n- \"Go to https://3000-abc.e2b.dev and verify the landing page loads with a hero section\"\n- \"Test guest checkout: add a pineapple to cart, proceed to checkout, fill shipping info, and verify order summary\"\n- \"Navigate to the dashboard and click on the settings tab, then verify the API keys section is visible\"\n\nExample bad tasks:\n- \"test the app\" (too vague)\n- \"go to localhost:3000\" (use remote URL instead)\n- \"do everything\" (not specific enough)`;\n\n"],"mappings":"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","names":["createTool"]}

package/dist/tools/browser/vercel.js

@@ -0,0 +1,49 @@
+import {
+  BROWSER_TOOL_DESCRIPTION
+} from "../../chunk-7PZJQFCY.js";
+import {
+  executeBrowserTask
+} from "../../chunk-4UVEBIDK.js";
+import "../../chunk-4VWJFZVS.js";
+import "../../chunk-PZ5AY32C.js";
+
+// tools/browser/vercel.ts
+import { tool as createTool } from "ai";
+import { z } from "zod";
+function createBrowserTool(config) {
+  const schema = z.object({
+    task: z.string().describe('Natural language description of what to do (e.g., "Test checkout flow for buying a pineapple")'),
+    url: z.string().optional().describe("Starting URL (e.g., https://3000-xyz.e2b.dev)"),
+    max_steps: z.number().min(1).max(50).default(10).describe("Maximum number of browser actions to take"),
+    region: z.enum(["sfo", "lon"]).default("sfo").describe("Browserless region: sfo (US West) or lon (Europe)")
+  });
+  return createTool({
+    description: BROWSER_TOOL_DESCRIPTION,
+    parameters: schema,
+    execute: async (params) => {
+      const { task, url, max_steps, region } = params;
+      const result = await executeBrowserTask(
+        { task, url, max_steps, region },
+        config
+      );
+      if (result.success) {
+        return {
+          success: true,
+          result: result.result,
+          steps_taken: result.steps_taken,
+          execution_time_ms: result.execution_time_ms
+        };
+      }
+      return {
+        success: false,
+        error: result.error
+      };
+    }
+  });
+}
+var browserTool = createBrowserTool();
+export {
+  browserTool,
+  createBrowserTool
+};
+//# sourceMappingURL=vercel.js.map

package/dist/tools/browser/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../tools/browser/vercel.ts"],"sourcesContent":["/**\n * Vercel AI SDK adapter for browser automation tool\n */\n\nimport { tool as createTool } from 'ai';\nimport { z } from 'zod';\nimport { executeBrowserTask } from './core.js';\nimport type { BrowserConfig } from './types.js';\nimport { BROWSER_TOOL_DESCRIPTION } from './prompts.js';\n\n/**\n * Create Vercel AI SDK tool for browser automation\n * \n * @param config - Optional browser worker configuration\n * @returns Vercel AI SDK tool\n * \n * @example\n * ```typescript\n * import { generateText } from 'ai';\n * import { anthropic } from '@ai-sdk/anthropic';\n * import { createBrowserTool } from 'morphsdk/tools/browser/vercel';\n * \n * const browserTool = createBrowserTool({\n *   apiUrl: 'https://browser-worker.example.com'\n * });\n * \n * const result = await generateText({\n *   model: anthropic('claude-sonnet-4-5-20250929'),\n *   tools: { browserTask: browserTool },\n *   prompt: 'Test the checkout flow at https://3000-abc.e2b.dev',\n *   maxSteps: 5\n * });\n * ```\n */\nexport function createBrowserTool(config?: BrowserConfig) {\n  const schema = z.object({\n    task: z.string().describe('Natural language description of what to do (e.g., \"Test checkout flow for buying a pineapple\")'),\n    url: z.string().optional().describe('Starting URL (e.g., https://3000-xyz.e2b.dev)'),\n    max_steps: z.number().min(1).max(50).default(10).describe('Maximum number of browser actions to take'),\n    region: z.enum(['sfo', 'lon']).default('sfo').describe('Browserless region: sfo (US West) or lon (Europe)'),\n  });\n\n  return createTool({\n    description: BROWSER_TOOL_DESCRIPTION,\n    parameters: schema,\n    execute: async (params) => {\n      const { task, url, max_steps, region } = params;\n      const result = await executeBrowserTask(\n        { task, url, max_steps, region },\n        config\n      );\n\n      if (result.success) {\n        return {\n          success: true,\n          result: result.result,\n          steps_taken: result.steps_taken,\n          execution_time_ms: result.execution_time_ms,\n        };\n      }\n\n      return {\n        success: false,\n        error: result.error,\n      };\n    },\n  });\n}\n\n/**\n * Default browser tool for Vercel AI SDK\n */\nexport const browserTool = createBrowserTool();\n\n"],"mappings":";;;;;;;;;;AAIA,SAAS,QAAQ,kBAAkB;AACnC,SAAS,SAAS;AA6BX,SAAS,kBAAkB,QAAwB;AACxD,QAAM,SAAS,EAAE,OAAO;AAAA,IACtB,MAAM,EAAE,OAAO,EAAE,SAAS,gGAAgG;AAAA,IAC1H,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,+CAA+C;AAAA,IACnF,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,SAAS,2CAA2C;AAAA,IACrG,QAAQ,EAAE,KAAK,CAAC,OAAO,KAAK,CAAC,EAAE,QAAQ,KAAK,EAAE,SAAS,mDAAmD;AAAA,EAC5G,CAAC;AAED,SAAO,WAAW;AAAA,IAChB,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,SAAS,OAAO,WAAW;AACzB,YAAM,EAAE,MAAM,KAAK,WAAW,OAAO,IAAI;AACzC,YAAM,SAAS,MAAM;AAAA,QACnB,EAAE,MAAM,KAAK,WAAW,OAAO;AAAA,QAC/B;AAAA,MACF;AAEA,UAAI,OAAO,SAAS;AAClB,eAAO;AAAA,UACL,SAAS;AAAA,UACT,QAAQ,OAAO;AAAA,UACf,aAAa,OAAO;AAAA,UACpB,mBAAmB,OAAO;AAAA,QAC5B;AAAA,MACF;AAEA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,OAAO;AAAA,MAChB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAKO,IAAM,cAAc,kBAAkB;","names":[]}

package/dist/tools/codebase_search/anthropic.cjs

@@ -0,0 +1,267 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// tools/codebase_search/anthropic.ts
+var anthropic_exports = {};
+__export(anthropic_exports, {
+  createCodebaseSearchTool: () => createCodebaseSearchTool
+});
+module.exports = __toCommonJS(anthropic_exports);
+
+// tools/utils/resilience.ts
+var DEFAULT_RETRY_CONFIG = {
+  maxRetries: 3,
+  initialDelay: 1e3,
+  maxDelay: 3e4,
+  backoffMultiplier: 2,
+  retryableErrors: ["ECONNREFUSED", "ETIMEDOUT", "ENOTFOUND"]
+};
+async function fetchWithRetry(url, options, retryConfig = {}) {
+  const {
+    maxRetries = DEFAULT_RETRY_CONFIG.maxRetries,
+    initialDelay = DEFAULT_RETRY_CONFIG.initialDelay,
+    maxDelay = DEFAULT_RETRY_CONFIG.maxDelay,
+    backoffMultiplier = DEFAULT_RETRY_CONFIG.backoffMultiplier,
+    retryableErrors = DEFAULT_RETRY_CONFIG.retryableErrors,
+    onRetry
+  } = retryConfig;
+  let lastError = null;
+  let delay = initialDelay;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      const response = await fetch(url, options);
+      if (response.status === 429 || response.status === 503) {
+        if (attempt < maxRetries) {
+          const retryAfter = response.headers.get("Retry-After");
+          const waitTime = retryAfter ? parseInt(retryAfter) * 1e3 : Math.min(delay, maxDelay);
+          const error = new Error(`HTTP ${response.status}: Retrying after ${waitTime}ms`);
+          if (onRetry) {
+            onRetry(attempt + 1, error);
+          }
+          await sleep(waitTime);
+          delay *= backoffMultiplier;
+          continue;
+        }
+      }
+      return response;
+    } catch (error) {
+      lastError = error;
+      const isRetryable = retryableErrors.some(
+        (errType) => lastError?.message?.includes(errType)
+      );
+      if (!isRetryable || attempt === maxRetries) {
+        throw lastError;
+      }
+      const waitTime = Math.min(delay, maxDelay);
+      if (onRetry) {
+        onRetry(attempt + 1, lastError);
+      }
+      await sleep(waitTime);
+      delay *= backoffMultiplier;
+    }
+  }
+  throw lastError || new Error("Max retries exceeded");
+}
+async function withTimeout(promise, timeoutMs, errorMessage) {
+  let timeoutId;
+  const timeoutPromise = new Promise((_, reject) => {
+    timeoutId = setTimeout(() => {
+      reject(new Error(errorMessage || `Operation timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+  });
+  try {
+    const result = await Promise.race([promise, timeoutPromise]);
+    clearTimeout(timeoutId);
+    return result;
+  } catch (error) {
+    clearTimeout(timeoutId);
+    throw error;
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// tools/codebase_search/core.ts
+async function executeCodebaseSearch(input, config) {
+  const apiKey = config.apiKey || process.env.MORPH_API_KEY;
+  if (!apiKey) {
+    throw new Error("MORPH_API_KEY not found. Set environment variable or pass in config");
+  }
+  const searchUrl = config.searchUrl || process.env.MORPH_SEARCH_URL || "http://embedrerank.morphllm.com:8081";
+  const timeout = config.timeout || 3e4;
+  const debug = config.debug || false;
+  if (debug) {
+    console.log(`[CodebaseSearch] Query: "${input.query.slice(0, 60)}..." repo=${config.repoId}`);
+    console.log(`[CodebaseSearch] URL: ${searchUrl}/v1/codebase_search`);
+  }
+  const startTime = Date.now();
+  try {
+    const fetchPromise = fetchWithRetry(
+      `${searchUrl}/v1/codebase_search`,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          query: input.query,
+          repoId: config.repoId,
+          targetDirectories: input.target_directories || [],
+          limit: input.limit || 10,
+          candidateLimit: 50
+        })
+      },
+      config.retryConfig
+    );
+    const response = await withTimeout(fetchPromise, timeout, `Codebase search timed out after ${timeout}ms`);
+    if (!response.ok) {
+      const errorText = await response.text();
+      if (debug) console.error(`[CodebaseSearch] Error: ${response.status} - ${errorText}`);
+      return {
+        success: false,
+        results: [],
+        stats: { totalResults: 0, candidatesRetrieved: 0, searchTimeMs: 0 },
+        error: `Search failed (${response.status}): ${errorText}`
+      };
+    }
+    const data = await response.json();
+    const elapsed = Date.now() - startTime;
+    if (debug) {
+      console.log(`[CodebaseSearch] \u2705 ${data.results?.length || 0} results in ${elapsed}ms`);
+    }
+    return {
+      success: true,
+      results: data.results || [],
+      stats: data.stats || { totalResults: 0, candidatesRetrieved: 0, searchTimeMs: elapsed }
+    };
+  } catch (error) {
+    if (debug) console.error(`[CodebaseSearch] Exception: ${error instanceof Error ? error.message : error}`);
+    return {
+      success: false,
+      results: [],
+      stats: { totalResults: 0, candidatesRetrieved: 0, searchTimeMs: 0 },
+      error: error instanceof Error ? error.message : "Unknown error"
+    };
+  }
+}
+
+// tools/codebase_search/prompts.ts
+var CODEBASE_SEARCH_DESCRIPTION = `Semantic search that finds code by meaning, not exact text.
+
+Use this to explore unfamiliar codebases or ask "how/where/what" questions:
+- "How does X work?" - Find implementation details
+- "Where is Y handled?" - Locate specific functionality
+- "What happens when Z?" - Understand flow
+
+The tool uses two-stage retrieval (embedding similarity + reranking) to find the most semantically relevant code chunks.
+
+Returns code chunks with file paths, line ranges, and full content ranked by relevance.`;
+var CODEBASE_SEARCH_SYSTEM_PROMPT = `You have access to the codebase_search tool that performs semantic code search.
+
+When searching:
+- Use natural language queries describing what you're looking for
+- Be specific about functionality, not variable names
+- Use target_directories to narrow search if you know the area
+- Results are ranked by relevance (rerank score is most important)
+
+The tool returns:
+- File paths with symbol names (e.g. "src/auth.ts::AuthService@L1-L17")
+- Line ranges for precise navigation
+- Full code content for each match
+- Dual relevance scores: embedding similarity + rerank score
+
+Use results to understand code or answer questions. The content is provided in full - avoid re-reading unless you need more context.`;
+
+// tools/codebase_search/anthropic.ts
+function createCodebaseSearchTool(config) {
+  const toolDefinition = {
+    name: "codebase_search",
+    description: CODEBASE_SEARCH_DESCRIPTION,
+    input_schema: {
+      type: "object",
+      properties: {
+        explanation: {
+          type: "string",
+          description: "One sentence explanation as to why this tool is being used, and how it contributes to the goal."
+        },
+        query: {
+          type: "string",
+          description: 'A complete question about what you want to understand. Ask as if talking to a colleague: "How does X work?", "What happens when Y?", "Where is Z handled?"'
+        },
+        target_directories: {
+          type: "array",
+          items: { type: "string" },
+          description: "Prefix directory paths to limit search scope (single directory only, no glob patterns). Use [] to search entire repo."
+        },
+        limit: {
+          type: "number",
+          description: "Maximum results to return (default: 10)"
+        }
+      },
+      required: ["query", "target_directories", "explanation"]
+    },
+    cache_control: { type: "ephemeral" }
+  };
+  return Object.assign(toolDefinition, {
+    execute: async (input) => {
+      return executeCodebaseSearch(input, config);
+    },
+    formatResult: (result) => {
+      return formatResult(result);
+    },
+    getSystemPrompt: () => {
+      return CODEBASE_SEARCH_SYSTEM_PROMPT;
+    }
+  });
+}
+function formatResult(result) {
+  if (!result.success) {
+    return `Search failed: ${result.error}`;
+  }
+  if (result.results.length === 0) {
+    return "No matching code found. Try rephrasing your query or broadening the search scope.";
+  }
+  const lines = [];
+  lines.push(`Found ${result.results.length} relevant code sections (searched ${result.stats.candidatesRetrieved} candidates in ${result.stats.searchTimeMs}ms):
+`);
+  result.results.forEach((r, i) => {
+    const relevance = (r.rerankScore * 100).toFixed(1);
+    lines.push(`${i + 1}. ${r.filepath} (${relevance}% relevant)`);
+    lines.push(`   Symbol: ${r.symbolPath}`);
+    lines.push(`   Language: ${r.language}`);
+    lines.push(`   Lines: ${r.startLine}-${r.endLine}`);
+    lines.push(`   Code:`);
+    const codeLines = r.content.split("\n");
+    codeLines.slice(0, Math.min(codeLines.length, 20)).forEach((line) => {
+      lines.push(`     ${line}`);
+    });
+    if (codeLines.length > 20) {
+      lines.push(`     ... (${codeLines.length - 20} more lines)`);
+    }
+    lines.push("");
+  });
+  return lines.join("\n");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCodebaseSearchTool
+});
+//# sourceMappingURL=anthropic.cjs.map