@morphllm/morphsdk 0.2.15 → 0.2.17

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../tools/browser/index.ts","../../../tools/utils/resilience.ts","../../../tools/browser/live.ts","../../../tools/browser/core.ts","../../../tools/browser/prompts.ts"],"sourcesContent":["/**\n * Morph Browser Automation Tool\n * \n * Natural language browser automation for AI agents using browser-use + Browserless.io\n * \n * @example\n * ```typescript\n * import { executeBrowserTask } from 'morphsdk/tools/browser';\n * \n * const result = await executeBrowserTask({\n *   task: \"Test checkout flow for buying a pineapple\",\n *   url: \"https://3000-abc.e2b.dev\",\n *   max_steps: 20\n * });\n * ```\n */\n\nexport {\n  BrowserClient,\n  executeBrowserTask,\n  executeWithRecording,\n  getRecording,\n  waitForRecording,\n  getErrors,\n  checkHealth\n} from './core.js';\nexport type {\n  BrowserConfig,\n  BrowserTaskInput,\n  BrowserTaskInputWithSchema,\n  BrowserTaskResult,\n  BrowserTaskWithPromise,\n  BrowserTaskWithPromiseAndSchema,\n  RecordingStatus,\n  BrowserError,\n  ErrorsResponse,\n  LiveSessionOptions,\n  IframeOptions,\n  BrowserModel,\n} from './types.js';\nexport {\n  BROWSER_TOOL_DESCRIPTION,\n  BROWSER_SYSTEM_PROMPT,\n} from './prompts.js';\nexport {\n  buildLiveUrl,\n  buildLiveIframe,\n  buildEmbedCode,\n  LIVE_PRESETS,\n} from './live.js';\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 * Live session utilities for Morph browser sessions\n * \n * Provides helpers for embedding and sharing live browser sessions with WebRTC streaming.\n */\n\nimport type { LiveSessionOptions, IframeOptions } from './types.js';\n\n/**\n * Preset configurations for common use cases\n */\nexport const LIVE_PRESETS = {\n  /** Read-only monitoring (no interaction) */\n  readonly: { interactive: false } as LiveSessionOptions,\n  /** Interactive control (human-in-the-loop) */\n  interactive: { interactive: true } as LiveSessionOptions,\n  /** Watch-only without controls */\n  monitoring: { interactive: false, showControls: false } as LiveSessionOptions,\n} as const;\n\n/**\n * Build a live session URL with query parameters\n * \n * @param debugUrl - Live session debug URL (e.g., from task.debugUrl)\n * @param options - Live session configuration options\n * @returns URL with query parameters for iframe embedding\n * \n * @example\n * ```typescript\n * const url = buildLiveUrl(task.debugUrl, { interactive: true });\n * // Returns: https://example.com/sessions/abc?interactive=true\n * ```\n */\nexport function buildLiveUrl(\n  debugUrl: string,\n  options: LiveSessionOptions = {}\n): string {\n  if (!debugUrl) {\n    throw new Error(\n      'debugUrl is required. Ensure your backend returns debugUrl in the task response. ' +\n      'Contact support@morphllm.com if you need help.'\n    );\n  }     \n\n  const url = new URL(debugUrl);\n  \n  // Add query parameters for supported options\n  if (options.interactive !== undefined) {\n    url.searchParams.set('interactive', String(options.interactive));\n  }\n  \n  if (options.theme) {\n    url.searchParams.set('theme', options.theme);\n  }\n  \n  if (options.showControls !== undefined) {\n    url.searchParams.set('showControls', String(options.showControls));\n  }\n  \n  if (options.pageId) {\n    url.searchParams.set('pageId', options.pageId);\n  }\n  \n  if (options.pageIndex) {\n    url.searchParams.set('pageIndex', options.pageIndex);\n  }\n  \n  return url.toString();\n}\n\n/**\n * Build iframe HTML for embedding a live session\n * \n * @param debugUrl - Live session debug URL\n * @param options - Iframe configuration including dimensions and session options\n * @returns HTML iframe element as string\n * \n * @example\n * ```typescript\n * const iframe = buildLiveIframe(task.debugUrl, {\n *   interactive: true,\n *   width: '100%',\n *   height: '600px'\n * });\n * ```\n */\nexport function buildLiveIframe(\n  debugUrl: string,\n  options: IframeOptions = {}\n): string {\n  const {\n    width = '100%',\n    height = '600px',\n    style = '',\n    className = '',\n    ...sessionOptions\n  } = options;\n\n  const src = buildLiveUrl(debugUrl, sessionOptions);\n  \n  // Convert numeric dimensions to pixels\n  const widthStr = typeof width === 'number' ? `${width}px` : width;\n  const heightStr = typeof height === 'number' ? `${height}px` : height;\n  \n  // Build style attribute\n  const baseStyle = `width: ${widthStr}; height: ${heightStr}; border: none;`;\n  const fullStyle = style ? `${baseStyle} ${style}` : baseStyle;\n  \n  // Build iframe attributes\n  const attributes = [\n    `src=\"${src}\"`,\n    `style=\"${fullStyle}\"`,\n  ];\n  \n  if (className) {\n    attributes.push(`class=\"${className}\"`);\n  }\n  \n  return `<iframe ${attributes.join(' ')}></iframe>`;\n}\n\n/**\n * Build complete embed code with HTML snippet\n * \n * @param debugUrl - Live session debug URL\n * @param options - Iframe configuration\n * @returns Multi-line HTML snippet ready to copy-paste\n * \n * @example\n * ```typescript\n * const code = buildEmbedCode(task.debugUrl, { interactive: false });\n * console.log(code);\n * // <!-- Embed Morph Live Session -->\n * // <iframe src=\"...\" style=\"...\"></iframe>\n * ```\n */\nexport function buildEmbedCode(\n  debugUrl: string,\n  options: IframeOptions = {}\n): string {\n  const iframe = buildLiveIframe(debugUrl, options);\n  return `<!-- Embed Morph Live Session -->\\n${iframe}`;\n}\n\n/**\n * Get live session options from preset name or custom config\n * \n * @internal\n */\nexport function resolvePreset(\n  optionsOrPreset?: string | IframeOptions\n): IframeOptions {\n  if (!optionsOrPreset) {\n    return {};\n  }\n  \n  if (typeof optionsOrPreset === 'string') {\n    const preset = LIVE_PRESETS[optionsOrPreset as keyof typeof LIVE_PRESETS];\n    if (!preset) {\n      throw new Error(\n        `Unknown preset: ${optionsOrPreset}. Available presets: ${Object.keys(LIVE_PRESETS).join(', ')}`\n      );\n    }\n    return preset;\n  }\n  \n  return optionsOrPreset;\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  LiveSessionOptions,\n  IframeOptions,\n} from './types.js';\nimport { buildLiveUrl, buildLiveIframe, buildEmbedCode, resolvePreset } from './live.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 { \n      success: false, \n      error: 'Task description is required. Example: \"Go to example.com and click the login button\"' \n    };\n  }\n\n  if (input.max_steps !== undefined && (input.max_steps < 1 || input.max_steps > 50)) {\n    return { \n      success: false, \n      error: 'max_steps must be between 1 and 50. Use more steps for complex multi-page flows.' \n    };\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 and accessible. For local dev, set MORPH_ENVIRONMENT=DEV.`,\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  const wrapped: BrowserTaskWithPromise = {\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    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n  };\n\n  return wrapped;\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  const wrapped: BrowserTaskWithPromiseAndSchema<T> = {\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    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions. '\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n  };\n\n  return wrapped;\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":[]}
+{"version":3,"sources":["../../../tools/browser/index.ts","../../../tools/utils/resilience.ts","../../../tools/browser/live.ts","../../../tools/browser/core.ts","../../../tools/browser/prompts.ts"],"sourcesContent":["/**\n * Morph Browser Automation Tool\n * \n * Natural language browser automation for AI agents using browser-use + Browserless.io\n * \n * @example\n * ```typescript\n * import { executeBrowserTask } from 'morphsdk/tools/browser';\n * \n * const result = await executeBrowserTask({\n *   task: \"Test checkout flow for buying a pineapple\",\n *   url: \"https://3000-abc.e2b.dev\",\n *   max_steps: 20\n * });\n * ```\n */\n\nexport {\n  BrowserClient,\n  executeBrowserTask,\n  executeWithRecording,\n  getRecording,\n  waitForRecording,\n  getErrors,\n  checkHealth\n} from './core.js';\nexport type {\n  BrowserConfig,\n  BrowserTaskInput,\n  BrowserTaskInputWithSchema,\n  BrowserTaskResult,\n  BrowserTaskWithPromise,\n  BrowserTaskWithPromiseAndSchema,\n  RecordingStatus,\n  BrowserError,\n  ErrorsResponse,\n  LiveSessionOptions,\n  IframeOptions,\n  BrowserModel,\n} from './types.js';\nexport {\n  BROWSER_TOOL_DESCRIPTION,\n  BROWSER_SYSTEM_PROMPT,\n} from './prompts.js';\nexport {\n  buildLiveUrl,\n  buildLiveIframe,\n  buildEmbedCode,\n  LIVE_PRESETS,\n} from './live.js';\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 * Live session utilities for Morph browser sessions\n * \n * Provides helpers for embedding and sharing live browser sessions with WebRTC streaming.\n */\n\nimport type { LiveSessionOptions, IframeOptions } from './types.js';\n\n/**\n * Preset configurations for common use cases\n */\nexport const LIVE_PRESETS = {\n  /** Read-only monitoring (no interaction) */\n  readonly: { interactive: false } as LiveSessionOptions,\n  /** Interactive control (human-in-the-loop) */\n  interactive: { interactive: true } as LiveSessionOptions,\n  /** Watch-only without controls */\n  monitoring: { interactive: false, showControls: false } as LiveSessionOptions,\n} as const;\n\n/**\n * Build a live session URL with query parameters\n * \n * @param debugUrl - Live session debug URL (e.g., from task.debugUrl)\n * @param options - Live session configuration options\n * @returns URL with query parameters for iframe embedding\n * \n * @example\n * ```typescript\n * const url = buildLiveUrl(task.debugUrl, { interactive: true });\n * // Returns: https://example.com/sessions/abc?interactive=true\n * ```\n */\nexport function buildLiveUrl(\n  debugUrl: string,\n  options: LiveSessionOptions = {}\n): string {\n  if (!debugUrl) {\n    throw new Error(\n      'debugUrl is required. Ensure your backend returns debugUrl in the task response. ' +\n      'Contact support@morphllm.com if you need help.'\n    );\n  }     \n\n  const url = new URL(debugUrl);\n  \n  // Add query parameters for supported options\n  if (options.interactive !== undefined) {\n    url.searchParams.set('interactive', String(options.interactive));\n  }\n  \n  if (options.theme) {\n    url.searchParams.set('theme', options.theme);\n  }\n  \n  if (options.showControls !== undefined) {\n    url.searchParams.set('showControls', String(options.showControls));\n  }\n  \n  if (options.pageId) {\n    url.searchParams.set('pageId', options.pageId);\n  }\n  \n  if (options.pageIndex) {\n    url.searchParams.set('pageIndex', options.pageIndex);\n  }\n  \n  return url.toString();\n}\n\n/**\n * Build iframe HTML for embedding a live session\n * \n * @param debugUrl - Live session debug URL\n * @param options - Iframe configuration including dimensions and session options\n * @returns HTML iframe element as string\n * \n * @example\n * ```typescript\n * const iframe = buildLiveIframe(task.debugUrl, {\n *   interactive: true,\n *   width: '100%',\n *   height: '600px'\n * });\n * ```\n */\nexport function buildLiveIframe(\n  debugUrl: string,\n  options: IframeOptions = {}\n): string {\n  const {\n    width = '100%',\n    height = '600px',\n    style = '',\n    className = '',\n    ...sessionOptions\n  } = options;\n\n  const src = buildLiveUrl(debugUrl, sessionOptions);\n  \n  // Convert numeric dimensions to pixels\n  const widthStr = typeof width === 'number' ? `${width}px` : width;\n  const heightStr = typeof height === 'number' ? `${height}px` : height;\n  \n  // Build style attribute\n  const baseStyle = `width: ${widthStr}; height: ${heightStr}; border: none;`;\n  const fullStyle = style ? `${baseStyle} ${style}` : baseStyle;\n  \n  // Build iframe attributes\n  const attributes = [\n    `src=\"${src}\"`,\n    `style=\"${fullStyle}\"`,\n  ];\n  \n  if (className) {\n    attributes.push(`class=\"${className}\"`);\n  }\n  \n  return `<iframe ${attributes.join(' ')}></iframe>`;\n}\n\n/**\n * Build complete embed code with HTML snippet\n * \n * @param debugUrl - Live session debug URL\n * @param options - Iframe configuration\n * @returns Multi-line HTML snippet ready to copy-paste\n * \n * @example\n * ```typescript\n * const code = buildEmbedCode(task.debugUrl, { interactive: false });\n * console.log(code);\n * // <!-- Embed Morph Live Session -->\n * // <iframe src=\"...\" style=\"...\"></iframe>\n * ```\n */\nexport function buildEmbedCode(\n  debugUrl: string,\n  options: IframeOptions = {}\n): string {\n  const iframe = buildLiveIframe(debugUrl, options);\n  return `<!-- Embed Morph Live Session -->\\n${iframe}`;\n}\n\n/**\n * Get live session options from preset name or custom config\n * \n * @internal\n */\nexport function resolvePreset(\n  optionsOrPreset?: string | IframeOptions\n): IframeOptions {\n  if (!optionsOrPreset) {\n    return {};\n  }\n  \n  if (typeof optionsOrPreset === 'string') {\n    const preset = LIVE_PRESETS[optionsOrPreset as keyof typeof LIVE_PRESETS];\n    if (!preset) {\n      throw new Error(\n        `Unknown preset: ${optionsOrPreset}. Available presets: ${Object.keys(LIVE_PRESETS).join(', ')}`\n      );\n    }\n    return preset;\n  }\n  \n  return optionsOrPreset;\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  LiveSessionOptions,\n  IframeOptions,\n} from './types.js';\nimport { buildLiveUrl, buildLiveIframe, buildEmbedCode, resolvePreset } from './live.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 { \n      success: false, \n      error: 'Task description is required. Example: \"Go to example.com and click the login button\"' \n    };\n  }\n\n  if (input.max_steps !== undefined && (input.max_steps < 1 || input.max_steps > 50)) {\n    return { \n      success: false, \n      error: 'max_steps must be between 1 and 50. Use more steps for complex multi-page flows.' \n    };\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          external_id: input.external_id,\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 and accessible. For local dev, set MORPH_ENVIRONMENT=DEV.`,\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  const wrapped: BrowserTaskWithPromise = {\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    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n  };\n\n  return wrapped;\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  const wrapped: BrowserTaskWithPromiseAndSchema<T> = {\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    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions. '\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n  };\n\n  return wrapped;\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":[]}

package/dist/tools/browser/index.js

@@ -14,7 +14,7 @@ import {
   getErrors,
   getRecording,
   waitForRecording
-} from "../../chunk-UIEIJZA3.js";
+} from "../../chunk-GPFHYUKV.js";
 import "../../chunk-4VWJFZVS.js";
 import "../../chunk-PZ5AY32C.js";
 export {

package/dist/tools/browser/openai.cjs

@@ -145,6 +145,7 @@ async function executeBrowserTask(input, config = {}) {
           model: input.model ?? "morph-computer-use-v0",
           viewport_width: input.viewport_width ?? 1280,
           viewport_height: input.viewport_height ?? 720,
+          external_id: input.external_id,
           repo_id: input.repo_id,
           commit_id: input.commit_id,
           record_video: input.record_video ?? false,

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../tools/browser/openai.ts","../../../tools/utils/resilience.ts","../../../tools/browser/core.ts","../../../tools/browser/prompts.ts"],"sourcesContent":["/**\n * OpenAI SDK adapter for browser automation tool\n */\n\nimport type { ChatCompletionTool } from 'openai/resources/chat/completions.mjs';\nimport { executeBrowserTask } from './core.js';\nimport type {\n  BrowserConfig,\n  BrowserTaskInput,\n  BrowserTaskResult,\n} from './types.js';\nimport { BROWSER_TOOL_DESCRIPTION, BROWSER_SYSTEM_PROMPT } from './prompts.js';\n\n/**\n * OpenAI tool definition for browser automation\n */\nexport const browserTool: ChatCompletionTool = {\n  type: 'function',\n  function: {\n    name: 'browser_task',\n    description: BROWSER_TOOL_DESCRIPTION,\n    parameters: {\n      type: 'object',\n      properties: {\n        task: {\n          type: 'string',\n          description: 'Natural language description of what to do (e.g., \"Test checkout flow for buying a pineapple\")',\n        },\n        url: {\n          type: 'string',\n          description: 'Starting URL (e.g., https://3000-xyz.e2b.dev). Required if navigating to a specific page.',\n        },\n        max_steps: {\n          type: 'number',\n          description: 'Maximum number of browser actions to take (1-50). Default: 10. Use 15-30 for complex flows.',\n          default: 10,\n        },\n        region: {\n          type: 'string',\n          enum: ['sfo', 'lon'],\n          description: 'Browserless region: sfo (US West Coast) or lon (Europe). Default: sfo.',\n          default: 'sfo',\n        },\n      },\n      required: ['task'],\n    },\n  },\n};\n\n/**\n * Execute a browser task (for use in tool call handling)\n * \n * @param input - Tool input parameters (may be JSON string)\n * @param config - Optional browser worker configuration\n * @returns Task execution result\n */\nexport async function execute(\n  input: BrowserTaskInput | string,\n  config?: BrowserConfig\n): Promise<BrowserTaskResult> {\n  // Parse input if it's a JSON string (from OpenAI tool call)\n  const parsedInput = typeof input === 'string' ? JSON.parse(input) : input;\n  return executeBrowserTask(parsedInput, config);\n}\n\n/**\n * Format browser task result for OpenAI tool result\n * \n * @param result - Browser task result\n * @returns Formatted string for tool result\n */\nexport function formatResult(result: BrowserTaskResult): string {\n  if (result.success) {\n    const parts = [\n      '✅ Browser task completed successfully',\n      `Steps taken: ${result.steps_taken ?? 0}`,\n      result.execution_time_ms ? `Execution time: ${result.execution_time_ms}ms` : null,\n      '',\n      'Result:',\n      result.result || 'Task completed',\n    ];\n    return parts.filter(Boolean).join('\\n');\n  }\n\n  return `❌ Browser task failed: ${result.error || 'Unknown error'}`;\n}\n\n/**\n * Get system prompt for browser automation\n */\nexport function getSystemPrompt(): string {\n  return BROWSER_SYSTEM_PROMPT;\n}\n\n/**\n * Create a configured browser tool with execute and formatResult methods\n * \n * @param config - Browser worker configuration\n * @returns Tool definition with execute and formatResult methods\n * \n * @example\n * ```typescript\n * import OpenAI from 'openai';\n * import { createBrowserTool } from 'morphsdk/tools/browser/openai';\n * \n * const tool = createBrowserTool({\n *   apiUrl: 'https://browser-worker.example.com'\n * });\n * \n * const client = new OpenAI();\n * \n * const response = await client.chat.completions.create({\n *   model: 'gpt-4o',\n *   tools: [tool], // tool itself is the ChatCompletionTool\n *   messages: [{\n *     role: 'user',\n *     content: 'Test the checkout at https://3000-abc.e2b.dev'\n *   }]\n * });\n * \n * // Execute and format\n * const result = await tool.execute(toolCallArgs);\n * const formatted = tool.formatResult(result);\n * ```\n */\nexport function createBrowserTool(config?: BrowserConfig) {\n  return Object.assign({}, browserTool, {\n    execute: async (input: BrowserTaskInput | string): Promise<BrowserTaskResult> => {\n      return execute(input, config);\n    },\n    formatResult: (result: BrowserTaskResult): string => {\n      return formatResult(result);\n    },\n    getSystemPrompt: (): string => {\n      return getSystemPrompt();\n    },\n  });\n}\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  LiveSessionOptions,\n  IframeOptions,\n} from './types.js';\nimport { buildLiveUrl, buildLiveIframe, buildEmbedCode, resolvePreset } from './live.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 { \n      success: false, \n      error: 'Task description is required. Example: \"Go to example.com and click the login button\"' \n    };\n  }\n\n  if (input.max_steps !== undefined && (input.max_steps < 1 || input.max_steps > 50)) {\n    return { \n      success: false, \n      error: 'max_steps must be between 1 and 50. Use more steps for complex multi-page flows.' \n    };\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 and accessible. For local dev, set MORPH_ENVIRONMENT=DEV.`,\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  const wrapped: BrowserTaskWithPromise = {\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    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n  };\n\n  return wrapped;\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  const wrapped: BrowserTaskWithPromiseAndSchema<T> = {\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    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions. '\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n  };\n\n  return wrapped;\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":[]}
+{"version":3,"sources":["../../../tools/browser/openai.ts","../../../tools/utils/resilience.ts","../../../tools/browser/core.ts","../../../tools/browser/prompts.ts"],"sourcesContent":["/**\n * OpenAI SDK adapter for browser automation tool\n */\n\nimport type { ChatCompletionTool } from 'openai/resources/chat/completions.mjs';\nimport { executeBrowserTask } from './core.js';\nimport type {\n  BrowserConfig,\n  BrowserTaskInput,\n  BrowserTaskResult,\n} from './types.js';\nimport { BROWSER_TOOL_DESCRIPTION, BROWSER_SYSTEM_PROMPT } from './prompts.js';\n\n/**\n * OpenAI tool definition for browser automation\n */\nexport const browserTool: ChatCompletionTool = {\n  type: 'function',\n  function: {\n    name: 'browser_task',\n    description: BROWSER_TOOL_DESCRIPTION,\n    parameters: {\n      type: 'object',\n      properties: {\n        task: {\n          type: 'string',\n          description: 'Natural language description of what to do (e.g., \"Test checkout flow for buying a pineapple\")',\n        },\n        url: {\n          type: 'string',\n          description: 'Starting URL (e.g., https://3000-xyz.e2b.dev). Required if navigating to a specific page.',\n        },\n        max_steps: {\n          type: 'number',\n          description: 'Maximum number of browser actions to take (1-50). Default: 10. Use 15-30 for complex flows.',\n          default: 10,\n        },\n        region: {\n          type: 'string',\n          enum: ['sfo', 'lon'],\n          description: 'Browserless region: sfo (US West Coast) or lon (Europe). Default: sfo.',\n          default: 'sfo',\n        },\n      },\n      required: ['task'],\n    },\n  },\n};\n\n/**\n * Execute a browser task (for use in tool call handling)\n * \n * @param input - Tool input parameters (may be JSON string)\n * @param config - Optional browser worker configuration\n * @returns Task execution result\n */\nexport async function execute(\n  input: BrowserTaskInput | string,\n  config?: BrowserConfig\n): Promise<BrowserTaskResult> {\n  // Parse input if it's a JSON string (from OpenAI tool call)\n  const parsedInput = typeof input === 'string' ? JSON.parse(input) : input;\n  return executeBrowserTask(parsedInput, config);\n}\n\n/**\n * Format browser task result for OpenAI tool result\n * \n * @param result - Browser task result\n * @returns Formatted string for tool result\n */\nexport function formatResult(result: BrowserTaskResult): string {\n  if (result.success) {\n    const parts = [\n      '✅ Browser task completed successfully',\n      `Steps taken: ${result.steps_taken ?? 0}`,\n      result.execution_time_ms ? `Execution time: ${result.execution_time_ms}ms` : null,\n      '',\n      'Result:',\n      result.result || 'Task completed',\n    ];\n    return parts.filter(Boolean).join('\\n');\n  }\n\n  return `❌ Browser task failed: ${result.error || 'Unknown error'}`;\n}\n\n/**\n * Get system prompt for browser automation\n */\nexport function getSystemPrompt(): string {\n  return BROWSER_SYSTEM_PROMPT;\n}\n\n/**\n * Create a configured browser tool with execute and formatResult methods\n * \n * @param config - Browser worker configuration\n * @returns Tool definition with execute and formatResult methods\n * \n * @example\n * ```typescript\n * import OpenAI from 'openai';\n * import { createBrowserTool } from 'morphsdk/tools/browser/openai';\n * \n * const tool = createBrowserTool({\n *   apiUrl: 'https://browser-worker.example.com'\n * });\n * \n * const client = new OpenAI();\n * \n * const response = await client.chat.completions.create({\n *   model: 'gpt-4o',\n *   tools: [tool], // tool itself is the ChatCompletionTool\n *   messages: [{\n *     role: 'user',\n *     content: 'Test the checkout at https://3000-abc.e2b.dev'\n *   }]\n * });\n * \n * // Execute and format\n * const result = await tool.execute(toolCallArgs);\n * const formatted = tool.formatResult(result);\n * ```\n */\nexport function createBrowserTool(config?: BrowserConfig) {\n  return Object.assign({}, browserTool, {\n    execute: async (input: BrowserTaskInput | string): Promise<BrowserTaskResult> => {\n      return execute(input, config);\n    },\n    formatResult: (result: BrowserTaskResult): string => {\n      return formatResult(result);\n    },\n    getSystemPrompt: (): string => {\n      return getSystemPrompt();\n    },\n  });\n}\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  LiveSessionOptions,\n  IframeOptions,\n} from './types.js';\nimport { buildLiveUrl, buildLiveIframe, buildEmbedCode, resolvePreset } from './live.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 { \n      success: false, \n      error: 'Task description is required. Example: \"Go to example.com and click the login button\"' \n    };\n  }\n\n  if (input.max_steps !== undefined && (input.max_steps < 1 || input.max_steps > 50)) {\n    return { \n      success: false, \n      error: 'max_steps must be between 1 and 50. Use more steps for complex multi-page flows.' \n    };\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          external_id: input.external_id,\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 and accessible. For local dev, set MORPH_ENVIRONMENT=DEV.`,\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  const wrapped: BrowserTaskWithPromise = {\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    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n  };\n\n  return wrapped;\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  const wrapped: BrowserTaskWithPromiseAndSchema<T> = {\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    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions. '\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n  };\n\n  return wrapped;\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":[]}

package/dist/tools/browser/openai.js

@@ -4,7 +4,7 @@ import {
 } from "../../chunk-7PZJQFCY.js";
 import {
   executeBrowserTask
-} from "../../chunk-UIEIJZA3.js";
+} from "../../chunk-GPFHYUKV.js";
 import "../../chunk-4VWJFZVS.js";
 import "../../chunk-PZ5AY32C.js";
 

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../tools/browser/types.ts"],"sourcesContent":["/**\n * Type definitions for browser automation tool\n */\n\nimport type { RetryConfig } from '../utils/resilience.js';\n\n/**\n * Available browser automation models\n */\nexport type BrowserModel = \n  | 'gemini-flash-latest'\n  | 'morph-computer-use-v0';\n\n/**\n * Configuration for the browser worker service\n */\nexport interface BrowserConfig {\n  /** Browser worker API URL (default: https://browser.morphllm.com) */\n  apiUrl?: string;\n  /** Morph API key for authentication (required in production) */\n  apiKey?: string;\n  /** Request timeout in milliseconds (default: 120000) */\n  timeout?: number;\n  /** Retry configuration for API calls */\n  retryConfig?: RetryConfig;\n  /** Enable debug logging (default: false) */\n  debug?: boolean;\n}\n\n/**\n * Input parameters for browser automation task\n */\nexport interface BrowserTaskInput {\n  /** Natural language description of what to do */\n  task: string;\n  /** Starting URL (e.g., https://3000-xyz.e2b.dev) */\n  url?: string;\n  /** Maximum number of browser actions to take (1-50, default: 10) */\n  max_steps?: number;\n  /** Model to use for task execution (default: morph-computer-use-v0) */\n  model?: BrowserModel;\n  /** Browserless region: 'sfo' (US West) or 'lon' (Europe) */\n  region?: 'sfo' | 'lon';\n  /** Enable stealth mode to avoid bot detection (default: true) */\n  stealth?: boolean;\n  /** Browser viewport width (default: 1280) */\n  viewport_width?: number;\n  /** Browser viewport height (default: 720) */\n  viewport_height?: number;\n  /** Optional repository ID to associate with this session */\n  repo_id?: string;\n  /** Optional commit UUID to associate with this session */\n  commit_id?: string;\n  /** Record session video to S3 (default: false) */\n  record_video?: boolean;\n  /** Video width (default: 1280) */\n  video_width?: number;\n  /** Video height (default: 720) */\n  video_height?: number;\n  /** Serialized structured output schema (internal use) */\n  structured_output?: string;\n}\n\n/**\n * Input with Zod schema for structured output\n */\nexport interface BrowserTaskInputWithSchema<T> extends Omit<BrowserTaskInput, 'structured_output'> {\n  /** Zod schema for structured output */\n  schema: any;\n}\n\n/**\n * Result from executing a browser task\n */\nexport interface BrowserTaskResult {\n  /** Whether the task completed successfully */\n  success: boolean;\n  /** Task result or findings */\n  result?: string;\n  /** Error message if task failed */\n  error?: string;\n  /** Number of browser actions taken */\n  steps_taken?: number;\n  /** Total execution time in milliseconds */\n  execution_time_ms?: number;\n  /** UUID of saved replay record (if session replay enabled) */\n  replay_id?: string;\n  /** Browserless replay URL (if session replay enabled) */\n  replay_url?: string;\n  /** Recording ID (if record_video=true) */\n  recording_id?: string;\n  /** Recording status: PENDING, PROCESSING, COMPLETED, ERROR */\n  recording_status?: string;\n  /** Task ID for async task tracking */\n  task_id?: string;\n  /** Task status: pending, running, completed, failed */\n  status?: string;\n  /** Structured output (JSON string) */\n  output?: string;\n  /** Live session debug URL for real-time viewing (WebRTC streaming) */\n  debugUrl?: string;\n}\n\n/**\n * Configuration for live session viewing\n */\nexport interface LiveSessionOptions {\n  /** Enable or disable remote control (default: true for headful, varies for headless) */\n  interactive?: boolean;\n  /** UI theme: 'dark' or 'light' (headless only, default: 'dark') */\n  theme?: 'dark' | 'light';\n  /** Show or hide navigation controls (headless only, default: true) */\n  showControls?: boolean;\n  /** Focus view on specific page/tab ID (headless only) */\n  pageId?: string;\n  /** Display specific tab by index (headless only) */\n  pageIndex?: string;\n}\n\n/**\n * Configuration for iframe generation\n */\nexport interface IframeOptions extends LiveSessionOptions {\n  /** Iframe width (default: '100%') */\n  width?: string | number;\n  /** Iframe height (default: '600px') */\n  height?: string | number;\n  /** Additional inline styles */\n  style?: string;\n  /** CSS class name */\n  className?: string;\n}\n\n/**\n * Task result with convenience methods for async execution\n */\nexport interface BrowserTaskWithPromise extends BrowserTaskResult {\n  task_id: string;\n  /** Live URL to watch task execution in real-time */\n  liveUrl: string;\n  /** Wait for task completion */\n  complete: (pollConfig?: { interval?: number; timeout?: number }) => Promise<BrowserTaskResult>;\n  /** Get live session URL with optional parameters (Steel.dev) - throws if debugUrl not available */\n  getLiveUrl: (options?: LiveSessionOptions) => string;\n  /** Get iframe HTML for embedding live session - throws if debugUrl not available */\n  getLiveIframe: (optionsOrPreset?: string | IframeOptions) => string;\n  /** Get complete embed code snippet - throws if debugUrl not available */\n  getEmbedCode: () => string;\n}\n\n/**\n * Task result with schema validation\n */\nexport interface BrowserTaskWithPromiseAndSchema<T> extends BrowserTaskResult {\n  task_id: string;\n  /** Live URL to watch task execution in real-time */\n  liveUrl: string;\n  /** Parsed and validated output */\n  parsed: T | null;\n  /** Wait for task completion with schema validation */\n  complete: (pollConfig?: { interval?: number; timeout?: number }) => Promise<BrowserTaskResult & { parsed: T | null }>;\n  /** Get live session URL with optional parameters - throws if debugUrl not available */\n  getLiveUrl: (options?: LiveSessionOptions) => string;\n  /** Get iframe HTML for embedding live session - throws if debugUrl not available */\n  getLiveIframe: (optionsOrPreset?: string | IframeOptions) => string;\n  /** Get complete embed code snippet - throws if debugUrl not available */\n  getEmbedCode: () => string;\n}\n\n/**\n * Recording status and metadata\n */\nexport interface RecordingStatus {\n  /** Recording ID */\n  id: string;\n  /** Current status */\n  status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'ERROR';\n  /** Presigned S3 URL for rrweb replay JSON (interactive DOM replay) */\n  replay_url?: string;\n  /** Presigned S3 URL for network logs (NDJSON format) */\n  network_url?: string;\n  /** Presigned S3 URL for console logs (NDJSON format) */\n  console_url?: string;\n  /** Presigned S3 URL for native browser video (WebM or MP4 format, real-time recording) */\n  video_url?: string;\n  /** Total rrweb events captured */\n  total_events?: number;\n  /** Total bytes of all files */\n  file_size?: number;\n  /** Duration in milliseconds */\n  duration?: number;\n  /** Error message if status=ERROR */\n  error?: string;\n  /** When recording was created */\n  created_at: string;\n}\n\n/**\n * Browser error with screenshot captured at error time\n */\nexport interface BrowserError {\n  /** Error type: console error or network error */\n  type: 'console' | 'network';\n  /** Error message */\n  message: string;\n  /** URL where error occurred */\n  url?: string;\n  /** CDP timestamp in seconds since browser start */\n  timestamp: number;\n  /** Presigned S3 URL to screenshot JPEG (captured 500ms after error) */\n  screenshot_url?: string;\n  /** When screenshot was captured (Unix timestamp) */\n  captured_at?: number;\n  \n  // Network-specific fields\n  /** HTTP status code (for network errors) */\n  status?: number;\n}\n\n/**\n * Response from getErrors()\n */\nexport interface ErrorsResponse {\n  /** Recording ID */\n  recording_id: string;\n  /** Total number of errors */\n  total_errors: number;\n  /** Errors with real-time screenshots */\n  errors: BrowserError[];\n}\n\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../tools/browser/types.ts"],"sourcesContent":["/**\n * Type definitions for browser automation tool\n */\n\nimport type { RetryConfig } from '../utils/resilience.js';\n\n/**\n * Available browser automation models\n */\nexport type BrowserModel = \n  | 'gemini-flash-latest'\n  | 'morph-computer-use-v0';\n\n/**\n * Configuration for the browser worker service\n */\nexport interface BrowserConfig {\n  /** Browser worker API URL (default: https://browser.morphllm.com) */\n  apiUrl?: string;\n  /** Morph API key for authentication (required in production) */\n  apiKey?: string;\n  /** Request timeout in milliseconds (default: 120000) */\n  timeout?: number;\n  /** Retry configuration for API calls */\n  retryConfig?: RetryConfig;\n  /** Enable debug logging (default: false) */\n  debug?: boolean;\n}\n\n/**\n * Input parameters for browser automation task\n */\nexport interface BrowserTaskInput {\n  /** Natural language description of what to do */\n  task: string;\n  /** Starting URL (e.g., https://3000-xyz.e2b.dev) */\n  url?: string;\n  /** Maximum number of browser actions to take (1-50, default: 10) */\n  max_steps?: number;\n  /** Model to use for task execution (default: morph-computer-use-v0) */\n  model?: BrowserModel;\n  /** Browserless region: 'sfo' (US West) or 'lon' (Europe) */\n  region?: 'sfo' | 'lon';\n  /** Enable stealth mode to avoid bot detection (default: true) */\n  stealth?: boolean;\n  /** Browser viewport width (default: 1280) */\n  viewport_width?: number;\n  /** Browser viewport height (default: 720) */\n  viewport_height?: number;\n  /** User-defined reference/tracking ID (e.g., \"PR-1234\", \"jira-PROJ-567\") */\n  external_id?: string;\n  /** Optional repository ID to associate with this session */\n  repo_id?: string;\n  /** Optional commit UUID to associate with this session */\n  commit_id?: string;\n  /** Record session video to S3 (default: false) */\n  record_video?: boolean;\n  /** Video width (default: 1280) */\n  video_width?: number;\n  /** Video height (default: 720) */\n  video_height?: number;\n  /** Serialized structured output schema (internal use) */\n  structured_output?: string;\n}\n\n/**\n * Input with Zod schema for structured output\n */\nexport interface BrowserTaskInputWithSchema<T> extends Omit<BrowserTaskInput, 'structured_output'> {\n  /** Zod schema for structured output */\n  schema: any;\n}\n\n/**\n * Result from executing a browser task\n */\nexport interface BrowserTaskResult {\n  /** Whether the task completed successfully */\n  success: boolean;\n  /** Task result or findings */\n  result?: string;\n  /** Error message if task failed */\n  error?: string;\n  /** Number of browser actions taken */\n  steps_taken?: number;\n  /** Total execution time in milliseconds */\n  execution_time_ms?: number;\n  /** UUID of saved replay record (if session replay enabled) */\n  replay_id?: string;\n  /** Browserless replay URL (if session replay enabled) */\n  replay_url?: string;\n  /** Recording ID (if record_video=true) */\n  recording_id?: string;\n  /** Recording status: PENDING, PROCESSING, COMPLETED, ERROR */\n  recording_status?: string;\n  /** Task ID for async task tracking */\n  task_id?: string;\n  /** Task status: pending, running, completed, failed */\n  status?: string;\n  /** Structured output (JSON string) */\n  output?: string;\n  /** Live session debug URL for real-time viewing (WebRTC streaming) */\n  debugUrl?: string;\n}\n\n/**\n * Configuration for live session viewing\n */\nexport interface LiveSessionOptions {\n  /** Enable or disable remote control (default: true for headful, varies for headless) */\n  interactive?: boolean;\n  /** UI theme: 'dark' or 'light' (headless only, default: 'dark') */\n  theme?: 'dark' | 'light';\n  /** Show or hide navigation controls (headless only, default: true) */\n  showControls?: boolean;\n  /** Focus view on specific page/tab ID (headless only) */\n  pageId?: string;\n  /** Display specific tab by index (headless only) */\n  pageIndex?: string;\n}\n\n/**\n * Configuration for iframe generation\n */\nexport interface IframeOptions extends LiveSessionOptions {\n  /** Iframe width (default: '100%') */\n  width?: string | number;\n  /** Iframe height (default: '600px') */\n  height?: string | number;\n  /** Additional inline styles */\n  style?: string;\n  /** CSS class name */\n  className?: string;\n}\n\n/**\n * Task result with convenience methods for async execution\n */\nexport interface BrowserTaskWithPromise extends BrowserTaskResult {\n  task_id: string;\n  /** Live URL to watch task execution in real-time */\n  liveUrl: string;\n  /** Wait for task completion */\n  complete: (pollConfig?: { interval?: number; timeout?: number }) => Promise<BrowserTaskResult>;\n  /** Get live session URL with optional parameters (Steel.dev) - throws if debugUrl not available */\n  getLiveUrl: (options?: LiveSessionOptions) => string;\n  /** Get iframe HTML for embedding live session - throws if debugUrl not available */\n  getLiveIframe: (optionsOrPreset?: string | IframeOptions) => string;\n  /** Get complete embed code snippet - throws if debugUrl not available */\n  getEmbedCode: () => string;\n}\n\n/**\n * Task result with schema validation\n */\nexport interface BrowserTaskWithPromiseAndSchema<T> extends BrowserTaskResult {\n  task_id: string;\n  /** Live URL to watch task execution in real-time */\n  liveUrl: string;\n  /** Parsed and validated output */\n  parsed: T | null;\n  /** Wait for task completion with schema validation */\n  complete: (pollConfig?: { interval?: number; timeout?: number }) => Promise<BrowserTaskResult & { parsed: T | null }>;\n  /** Get live session URL with optional parameters - throws if debugUrl not available */\n  getLiveUrl: (options?: LiveSessionOptions) => string;\n  /** Get iframe HTML for embedding live session - throws if debugUrl not available */\n  getLiveIframe: (optionsOrPreset?: string | IframeOptions) => string;\n  /** Get complete embed code snippet - throws if debugUrl not available */\n  getEmbedCode: () => string;\n}\n\n/**\n * Recording status and metadata\n */\nexport interface RecordingStatus {\n  /** Recording ID */\n  id: string;\n  /** Current status */\n  status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'ERROR';\n  /** Presigned S3 URL for rrweb replay JSON (interactive DOM replay) */\n  replay_url?: string;\n  /** Presigned S3 URL for network logs (NDJSON format) */\n  network_url?: string;\n  /** Presigned S3 URL for console logs (NDJSON format) */\n  console_url?: string;\n  /** Presigned S3 URL for native browser video (WebM or MP4 format, real-time recording) */\n  video_url?: string;\n  /** Total rrweb events captured */\n  total_events?: number;\n  /** Total bytes of all files */\n  file_size?: number;\n  /** Duration in milliseconds */\n  duration?: number;\n  /** Error message if status=ERROR */\n  error?: string;\n  /** When recording was created */\n  created_at: string;\n}\n\n/**\n * Browser error with screenshot captured at error time\n */\nexport interface BrowserError {\n  /** Error type: console error or network error */\n  type: 'console' | 'network';\n  /** Error message */\n  message: string;\n  /** URL where error occurred */\n  url?: string;\n  /** CDP timestamp in seconds since browser start */\n  timestamp: number;\n  /** Presigned S3 URL to screenshot JPEG (captured 500ms after error) */\n  screenshot_url?: string;\n  /** When screenshot was captured (Unix timestamp) */\n  captured_at?: number;\n  \n  // Network-specific fields\n  /** HTTP status code (for network errors) */\n  status?: number;\n}\n\n/**\n * Response from getErrors()\n */\nexport interface ErrorsResponse {\n  /** Recording ID */\n  recording_id: string;\n  /** Total number of errors */\n  total_errors: number;\n  /** Errors with real-time screenshots */\n  errors: BrowserError[];\n}\n\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/tools/browser/types.d.ts

@@ -43,6 +43,8 @@ interface BrowserTaskInput {
     viewport_width?: number;
     /** Browser viewport height (default: 720) */
     viewport_height?: number;
+    /** User-defined reference/tracking ID (e.g., "PR-1234", "jira-PROJ-567") */
+    external_id?: string;
     /** Optional repository ID to associate with this session */
     repo_id?: string;
     /** Optional commit UUID to associate with this session */

package/dist/tools/browser/vercel.cjs

@@ -144,6 +144,7 @@ async function executeBrowserTask(input, config = {}) {
           model: input.model ?? "morph-computer-use-v0",
           viewport_width: input.viewport_width ?? 1280,
           viewport_height: input.viewport_height ?? 720,
+          external_id: input.external_id,
           repo_id: input.repo_id,
           commit_id: input.commit_id,
           record_video: input.record_video ?? false,