@morphllm/morphsdk 0.2.99 → 0.2.100

package/dist/tools/browser/index.js

@@ -1,12 +1,12 @@
 import {
   vercel_exports
-} from "../../chunk-R7IQWNSA.js";
+} from "../../chunk-ZGFVS6RQ.js";
 import {
   anthropic_exports
-} from "../../chunk-TSENDJQI.js";
+} from "../../chunk-Q6TDFDOB.js";
 import {
   openai_exports
-} from "../../chunk-YZ5NCWO2.js";
+} from "../../chunk-HONHUMCS.js";
 import {
   BROWSER_SYSTEM_PROMPT,
   BROWSER_TOOL_DESCRIPTION
@@ -20,7 +20,7 @@ import {
   getRecording,
   getWebp,
   waitForRecording
-} from "../../chunk-QJP62BXH.js";
+} from "../../chunk-5754T27Z.js";
 import {
   ProfilesClient
 } from "../../chunk-SI2CKRKJ.js";

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../tools/browser/openai.ts","../../../tools/utils/resilience.ts","../../../tools/browser/profiles/core.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        maxSteps: {\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 * Returns a concise summary suitable for agent context. The full result object\n * (with urls, errors, action_history, judgement, etc.) is available when calling\n * execute() directly, but this formatted string omits those details to save tokens.\n * \n * @param result - Browser task result with full history data\n * @returns Formatted string summary 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.stepsTaken ?? 0}`,\n      result.executionTimeMs ? `Execution time: ${result.executionTimeMs}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 * 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 * ProfilesClient - Manage browser profiles for storing login state.\n *\n * @example\n * ```typescript\n * const morph = new MorphClient({ apiKey: '...' });\n *\n * // Create a profile + live setup session\n * const setup = await morph.browser.profiles.createProfile({\n *   name: 'LinkedIn',\n *   repoId: 'owner/repo'\n * });\n *\n * console.log('Sign in at:', setup.session.debugUrl);\n * // User logs in, then explicitly save\n * await setup.save();\n *\n * // Use profile in browser tasks\n * await morph.browser.execute({\n *   task: 'Check notifications',\n *   url: 'https://linkedin.com',\n *   profileId: profile.id\n * });\n * ```\n */\n\nimport { fetchWithRetry } from '../../utils/resilience.js';\nimport type { BrowserConfig } from '../types.js';\nimport {\n  MorphValidationError,\n  MorphAuthenticationError,\n  parseAPIError,\n} from '../errors.js';\nimport type {\n  Profile,\n  ProfileSetup,\n  ProfileWithMethods,\n  CreateProfileInput,\n  ProfileListResponse,\n  ProfileSession,\n  ProfileSessionInput,\n  SaveProfileSessionInput,\n  ProfileStateResponse,\n  RepoSummary,\n  RepoListResponse,\n  APIProfile,\n  APIProfileSession,\n  APIProfileStateResponse,\n} from './types.js';\nimport {\n  transformProfile,\n  transformCreateInput,\n  transformSession,\n  transformSaveInput,\n  transformStateResponse,\n} from './types.js';\n\nconst DEFAULT_API_URL = process.env.MORPH_ENVIRONMENT === 'DEV'\n  ? 'http://localhost:8000'\n  : 'https://browser.morphllm.com';\n\n/**\n * ProfilesClient class for managing browser profiles.\n *\n * Access via `morph.browser.profiles` on a MorphClient instance.\n */\nexport class ProfilesClient {\n  private config: BrowserConfig;\n\n  constructor(config: BrowserConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Create a new browser profile and immediately start a live session.\n   *\n   * @param input - Profile creation parameters\n   * @returns Profile setup handle with live URL + save()\n   * @throws {MorphValidationError} If input validation fails\n   * @throws {MorphProfileLimitError} If profile limit is exceeded\n   * @throws {MorphAuthenticationError} If API key is missing or invalid\n   *\n   * @example\n   * ```typescript\n * const setup = await morph.browser.profiles.createProfile({\n *   name: 'LinkedIn Production',\n *   repoId: 'owner/repo'\n * });\n * console.log(setup.session.debugUrl);\n * await setup.save();\n   * ```\n   */\n  async createProfile(input: CreateProfileInput): Promise<ProfileSetup> {\n    return createProfile(input, this.config);\n  }\n\n  /**\n   * List all profiles for the authenticated user.\n   *\n   * @param repoId - Optional repository ID to filter by\n   * @returns Array of profiles\n   *\n   * @example\n   * ```typescript\n   * // List all profiles\n   * const allProfiles = await morph.browser.profiles.listProfiles();\n   *\n   * // List profiles for a specific repo\n   * const repoProfiles = await morph.browser.profiles.listProfiles('owner/repo');\n   * ```\n   */\n  async listProfiles(repoId?: string): Promise<Profile[]> {\n    return listProfiles(this.config, repoId);\n  }\n\n  /**\n   * Get a profile by ID with convenience methods.\n   *\n   * @param id - Profile ID\n   * @returns Profile with attached methods\n   * @throws {MorphNotFoundError} If profile is not found\n   *\n   * @example\n   * ```typescript\n   * const profile = await morph.browser.profiles.getProfile('profile-id');\n   * const state = await profile.getState();\n   * await profile.delete();\n   * ```\n   */\n  async getProfile(id: string): Promise<ProfileWithMethods> {\n    return getProfile(id, this.config);\n  }\n\n  /**\n   * Update a profile by opening a live session (no rename).\n   *\n   * @param id - Profile ID\n   * @returns Profile setup handle with live URL + save()\n   */\n  async updateProfile(id: string): Promise<ProfileSetup> {\n    return updateProfile(id, this.config);\n  }\n\n  /**\n   * Delete a profile.\n   *\n   * @param id - Profile ID\n   * @throws {MorphNotFoundError} If profile is not found\n   */\n  async deleteProfile(id: string): Promise<void> {\n    return deleteProfile(id, this.config);\n  }\n\n  /**\n   * Start a browser session for profile setup.\n   *\n   * Returns a live URL where the user can sign into accounts.\n   * After signing in, call `saveSession` to persist the state.\n   *\n   * @param input - Optional session parameters\n   * @returns Session with debug URL\n   *\n   * @example\n   * ```typescript\n   * const session = await morph.browser.profiles.startSession();\n   * console.log('Sign in at:', session.debugUrl);\n   * // Open debugUrl in browser, user signs in...\n   * await morph.browser.profiles.saveSession(session.sessionId, profile.id);\n   * ```\n   */\n  async startSession(input?: ProfileSessionInput): Promise<ProfileSession> {\n    return startProfileSession(this.config, input);\n  }\n\n  /**\n   * Save browser state from a session to a profile.\n   *\n   * Call this after the user is done signing into accounts.\n   * Extracts cookies, localStorage, and sessionStorage.\n   *\n   * @param sessionId - Browser session ID from startSession\n   * @param profileId - Profile ID to save state to\n   * @returns Updated profile with cookie domains\n   */\n  async saveSession(sessionId: string, profileId: string): Promise<Profile> {\n    return saveProfileSession({ sessionId, profileId }, this.config);\n  }\n\n  /**\n   * List available repo IDs (discovery).\n   *\n   * @returns Repo summaries with profile counts\n   */\n  async listRepos(): Promise<RepoSummary[]> {\n    return listRepos(this.config);\n  }\n\n  /**\n   * Get the presigned URL for a profile's state.\n   *\n   * Use this to download the raw state JSON for debugging\n   * or to restore state manually.\n   *\n   * @param profileId - Profile ID\n   * @returns State URL with expiry information\n   */\n  async getProfileState(profileId: string): Promise<ProfileStateResponse> {\n    return getProfileState(profileId, this.config);\n  }\n}\n\n// ============================================================================\n// Validation Helpers\n// ============================================================================\n\nfunction validateCreateInput(input: CreateProfileInput): void {\n  if (!input.name || typeof input.name !== 'string') {\n    throw new MorphValidationError('name is required', 'name');\n  }\n\n  const trimmedName = input.name.trim();\n  if (trimmedName.length === 0) {\n    throw new MorphValidationError('name cannot be empty', 'name');\n  }\n\n  if (trimmedName.length > 100) {\n    throw new MorphValidationError('name must be 100 characters or less', 'name');\n  }\n\n  if (!input.repoId || typeof input.repoId !== 'string') {\n    throw new MorphValidationError('repoId is required', 'repoId');\n  }\n\n  if (input.repoId.trim().length === 0) {\n    throw new MorphValidationError('repoId cannot be empty', 'repoId');\n  }\n}\n\nfunction validateId(id: string, fieldName: string): void {\n  if (!id || typeof id !== 'string') {\n    throw new MorphValidationError(`${fieldName} is required`, fieldName);\n  }\n\n  if (id.trim().length === 0) {\n    throw new MorphValidationError(`${fieldName} cannot be empty`, fieldName);\n  }\n}\n\n// ============================================================================\n// Standalone Functions\n// ============================================================================\n\n/**\n * Create a new browser profile.\n */\nexport async function createProfile(\n  input: CreateProfileInput,\n  config: BrowserConfig = {}\n): Promise<ProfileSetup> {\n  validateCreateInput(input);\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles`,\n    {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(transformCreateInput(input)),\n    },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiProfile: APIProfile = await response.json();\n  const profile = transformProfile(apiProfile);\n  const session = await startProfileSession(config, { profileId: profile.id });\n  return buildProfileSetup(profile, session, config);\n}\n\n/**\n * List all profiles for the authenticated user.\n */\nexport async function listProfiles(\n  config: BrowserConfig = {},\n  repoId?: string\n): Promise<Profile[]> {\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const url = repoId\n    ? `${apiUrl}/profiles?repo_id=${encodeURIComponent(repoId)}`\n    : `${apiUrl}/profiles`;\n\n  const response = await fetchWithRetry(\n    url,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const data: { profiles: APIProfile[] } = await response.json();\n  return data.profiles.map(transformProfile);\n}\n\n/**\n * Get a profile by ID with convenience methods.\n */\nexport async function getProfile(\n  id: string,\n  config: BrowserConfig = {}\n): Promise<ProfileWithMethods> {\n  validateId(id, 'id');\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/${encodeURIComponent(id)}`,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiProfile: APIProfile = await response.json();\n  const profile = transformProfile(apiProfile);\n\n  // Attach convenience methods\n  return {\n    ...profile,\n    getState: () => getProfileState(id, config),\n    delete: () => deleteProfile(id, config),\n  };\n}\n\n/**\n * Update a profile.\n */\nexport async function updateProfile(\n  id: string,\n  config: BrowserConfig = {}\n): Promise<ProfileSetup> {\n  validateId(id, 'id');\n  const profile = await fetchProfile(id, config);\n  const session = await startProfileSession(config, { profileId: profile.id });\n  return buildProfileSetup(profile, session, config);\n}\n\n/**\n * Delete a profile.\n */\nexport async function deleteProfile(\n  id: string,\n  config: BrowserConfig = {}\n): Promise<void> {\n  validateId(id, 'id');\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/${encodeURIComponent(id)}`,\n    { method: 'DELETE', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n}\n\n/**\n * Start a browser session for profile setup.\n */\nexport async function startProfileSession(\n  config: BrowserConfig = {},\n  input?: ProfileSessionInput\n): Promise<ProfileSession> {\n  if (!config.apiKey) {\n    throw new MorphAuthenticationError();\n  }\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  // Transform input if provided\n  const body = input?.profileId\n    ? { profile_id: input.profileId }\n    : {};\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/session/start`,\n    {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(body),\n    },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiSession: APIProfileSession = await response.json();\n  return transformSession(apiSession);\n}\n\n/**\n * Save browser state from a session to a profile.\n */\nexport async function saveProfileSession(\n  input: SaveProfileSessionInput,\n  config: BrowserConfig = {}\n): Promise<Profile> {\n  validateId(input.sessionId, 'sessionId');\n  validateId(input.profileId, 'profileId');\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/session/save`,\n    {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(transformSaveInput(input)),\n    },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiProfile: APIProfile = await response.json();\n  return transformProfile(apiProfile);\n}\n\n/**\n * List repo IDs available to the authenticated user/org.\n */\nexport async function listRepos(config: BrowserConfig = {}): Promise<RepoSummary[]> {\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/repos`,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const data = await response.json();\n  const repos = Array.isArray(data?.repos) ? data.repos : [];\n\n  return repos.map((repo: any) => ({\n    repoId: repo.repo_id,\n    repoFullName: repo.repo_full_name,\n    profileCount: repo.profile_count ?? 0,\n  })) satisfies RepoSummary[];\n}\n\n/**\n * Get the presigned URL for a profile's state.\n */\nexport async function getProfileState(\n  profileId: string,\n  config: BrowserConfig = {}\n): Promise<ProfileStateResponse> {\n  validateId(profileId, 'profileId');\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/${encodeURIComponent(profileId)}/state`,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiState: APIProfileStateResponse = await response.json();\n  return transformStateResponse(apiState);\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction buildHeaders(config: BrowserConfig): Record<string, string> {\n  const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n  if (config.apiKey) {\n    headers['Authorization'] = `Bearer ${config.apiKey}`;\n  }\n  return headers;\n}\n\nasync function fetchProfile(id: string, config: BrowserConfig): Promise<Profile> {\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/${encodeURIComponent(id)}`,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiProfile: APIProfile = await response.json();\n  return transformProfile(apiProfile);\n}\n\nfunction buildProfileSetup(profile: Profile, session: ProfileSession, config: BrowserConfig): ProfileSetup {\n  return {\n    profile,\n    session,\n    save: () => saveProfileSession({ sessionId: session.sessionId, profileId: profile.id }, config),\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  RecordingWithMethods,\n  ErrorsResponse,\n  LiveSessionOptions,\n  IframeOptions,\n  WebpOptions,\n  WebpResponse,\n} from './types.js';\nimport { buildLiveUrl, buildLiveIframe, buildEmbedCode, resolvePreset } from './live.js';\nimport { ProfilesClient } from './profiles/core.js';\n\nconst DEFAULT_CONFIG = {\n  apiUrl: process.env.MORPH_ENVIRONMENT === 'DEV' \n    ? 'http://localhost:8000'\n    : 'https://browser.morphllm.com',\n  timeout: 1000000, // 10 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  /**\n   * Profile management - create and manage browser profiles for storing login state.\n   */\n  public profiles: ProfilesClient;\n\n  constructor(config: BrowserConfig = {}) {\n    this.config = {\n      ...DEFAULT_CONFIG,\n      ...config,\n    };\n    this.profiles = new ProfilesClient(this.config);\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    const apiUrl = this.config.apiUrl || DEFAULT_CONFIG.apiUrl;\n    const debug = this.config.debug || false;\n    \n    if (debug) {\n      console.log(`[Browser] createTask: \"${input.task.slice(0, 60)}...\" url=${input.url || 'none'}`);\n      console.log(`[Browser] Calling async endpoint: ${apiUrl}/browser-task/async`);\n    }\n    \n    const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n    if (this.config.apiKey) headers['Authorization'] = `Bearer ${this.config.apiKey}`;\n    \n    // Call ASYNC endpoint for immediate return with live URL\n    const response = await fetch(`${apiUrl}/browser-task/async`, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify({\n        task: input.task,\n        url: input.url,\n        max_steps: input.maxSteps ?? 10,\n        model: input.model ?? 'morph-computer-use-v0',\n        viewport_width: input.viewportWidth ?? 1280,\n        viewport_height: input.viewportHeight ?? 720,\n        external_id: input.externalId,\n        repo_id: input.repoId,\n        repo_full_name: input.repoFullName,\n        commit_id: input.commitId,\n        record_video: input.recordVideo ?? false,\n        video_width: input.videoWidth ?? input.viewportWidth ?? 1280,\n        video_height: input.videoHeight ?? input.viewportHeight ?? 720,\n        allow_resizing: input.allowResizing ?? false,\n        structured_output: 'schema' in input ? stringifyStructuredOutput(input.schema) : undefined,\n        auth: input.auth,\n        profile_id: input.profileId,\n      }),\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 = mapTaskResult(await response.json());\n    \n    if (debug) {\n      const debugUrl = result.debugUrl;\n      console.log(`[Browser] ✅ Task created: recordingId=${result.recordingId ?? 'none'} debugUrl=${debugUrl ? 'available' : 'none'}`);\n    }\n    \n    if ('schema' in input) {\n      return wrapTaskResponseWithSchema(result, this.config, input.schema);\n    } else {\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 & { recordVideo: true }\n  ): Promise<BrowserTaskResult & { recording?: RecordingWithMethods }> {\n    return executeWithRecording(input, this.config);\n  }\n\n  /**\n   * Get recording status and URLs\n   */\n  async getRecording(recordingId: string): Promise<RecordingWithMethods> {\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<RecordingWithMethods> {\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   * Get animated WebP preview of recording\n   */\n  async getWebp(\n    recordingId: string,\n    options?: WebpOptions\n  ): Promise<WebpResponse> {\n    return getWebp(recordingId, this.config, options);\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 * Returns the full task result including rich agent history data (urls, errors, \n * action_history, judgement, etc.). When using this as an agent tool, use the\n * formatResult() functions from the SDK adapters to return a concise summary.\n * \n * @param input - Task parameters\n * @param config - Optional configuration (apiKey, apiUrl to override default)\n * @returns Task result with success status, findings, and comprehensive execution history\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 *     maxSteps: 20,\n *     repoId: \"my-project\",\n *     commitId: \"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('URLs visited:', result.urls);\n *   console.log('Actions taken:', result.actionNames);\n *   console.log('Has errors:', result.hasErrors);\n *   console.log('Replay:', result.replayUrl);\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.maxSteps !== undefined && (input.maxSteps < 1 || input.maxSteps > 50)) {\n    return { \n      success: false, \n      error: 'maxSteps 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.maxSteps ?? 10}`);\n    console.log(`[Browser] Recording: ${input.recordVideo ? '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.maxSteps ?? 10,\n          model: input.model ?? 'morph-computer-use-v0',\n          viewport_width: input.viewportWidth ?? 1280,\n          viewport_height: input.viewportHeight ?? 720,\n          external_id: input.externalId,\n          repo_id: input.repoId,\n          commit_id: input.commitId,\n          record_video: input.recordVideo ?? false,\n          video_width: input.videoWidth ?? input.viewportWidth ?? 1280,\n          video_height: input.videoHeight ?? input.viewportHeight ?? 720,\n          allow_resizing: input.allowResizing ?? false,\n          structured_output: input.structuredOutput,\n          auth: input.auth,\n          profile_id: input.profileId,\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 maxSteps.`\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 = mapTaskResult(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.stepsTaken ?? 0} recordingId=${result.recordingId ?? '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 with convenience methods (.getWebp(), .getErrors())\n * \n * @example\n * ```typescript\n * const recording = await getRecording('uuid-here', { apiKey: 'key' });\n * \n * // Get animated WebP\n * const { webpUrl } = await recording.getWebp({ width: 780 });\n * \n * // Get errors with screenshots\n * const { errors } = await recording.getErrors();\n * ```\n */\nexport async function getRecording(\n  recordingId: string,\n  config: BrowserConfig = {}\n): Promise<RecordingWithMethods> {\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 data: RecordingStatus = mapRecordingStatus(await response.json());\n  if (debug) console.log(`[Browser] Recording status: ${data.status}`);\n\n  // Return recording with convenience methods\n  return {\n    ...data,\n    getWebp: (options?: WebpOptions) => getWebp(recordingId, config, options),\n    getErrors: () => getErrors(recordingId, config),\n  };\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: '...', recordVideo: true }, config);\n * if (result.recordingId) {\n *   const recording = await waitForRecording(result.recordingId, config, {\n *     timeout: 60000,  // 1 minute\n *     pollInterval: 2000  // Check every 2 seconds\n *   });\n *   console.log('Video URL:', recording.videoUrl);\n * }\n * ```\n */\nexport async function waitForRecording(\n  recordingId: string,\n  config: BrowserConfig = {},\n  options: { timeout?: number; pollInterval?: number } = {}\n): Promise<RecordingWithMethods> {\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 recordVideo=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 *     recordVideo: true,\n *     repoId: \"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?.videoUrl);\n * ```\n */\nexport async function executeWithRecording(\n  input: BrowserTaskInput & { recordVideo: true },\n  config: BrowserConfig = {}\n): Promise<BrowserTaskResult & { recording?: RecordingWithMethods }> {\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.recordingId) {\n    try {\n      const recording = await waitForRecording(\n        taskResult.recordingId,\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      // Still attach convenience methods for consistent API\n      const errorRecording: RecordingWithMethods = {\n        id: taskResult.recordingId,\n        status: 'ERROR',\n        error: error instanceof Error ? error.message : String(error),\n        createdAt: new Date().toISOString(),\n        getWebp: (options?: WebpOptions) => getWebp(taskResult.recordingId!, config, options),\n        getErrors: () => getErrors(taskResult.recordingId!, config),\n      };\n      return {\n        ...taskResult,\n        recording: errorRecording,\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, totalErrors } = await getErrors('uuid-here', { apiKey: 'key' });\n * \n * console.log(`Found ${totalErrors} 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.screenshotUrl) console.log(`  Screenshot: ${err.screenshotUrl}`);\n *   \n *   // Download screenshot\n *   if (err.screenshotUrl) {\n *     const response = await fetch(err.screenshotUrl);\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 = mapErrorsResponse(await response.json());\n  if (debug) console.log(`[Browser] Found ${errors.totalErrors} 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\nfunction mapTaskResult(api: any): BrowserTaskResult {\n  if (!api || typeof api !== 'object') {\n    return api as BrowserTaskResult;\n  }\n\n  return {\n    success: api.success,\n    result: api.result,\n    error: api.error,\n    stepsTaken: api.steps_taken,\n    executionTimeMs: api.execution_time_ms,\n    urls: api.urls,\n    actionNames: api.action_names,\n    errors: api.errors,\n    modelActions: api.model_actions,\n    isDone: api.is_done,\n    actionHistory: api.action_history,\n    actionResults: api.action_results,\n    hasErrors: api.has_errors,\n    numberOfSteps: api.number_of_steps,\n    judgement: api.judgement,\n    isValidated: api.is_validated,\n    replayId: api.replay_id,\n    replayUrl: api.replay_url,\n    recordingId: api.recording_id,\n    recordingStatus: api.recording_status,\n    taskId: api.task_id,\n    status: api.status,\n    output: api.output,\n    debugUrl: api.debug_url,\n  };\n}\n\nfunction mapRecordingStatus(api: any): RecordingStatus {\n  return {\n    id: api.id,\n    status: api.status,\n    replayUrl: api.replay_url,\n    networkUrl: api.network_url,\n    consoleUrl: api.console_url,\n    videoUrl: api.video_url,\n    totalEvents: api.total_events,\n    fileSize: api.file_size,\n    duration: api.duration,\n    error: api.error,\n    createdAt: api.created_at,\n  };\n}\n\nfunction mapBrowserError(api: any): ErrorsResponse['errors'][number] {\n  return {\n    type: api.type,\n    message: api.message,\n    url: api.url,\n    timestamp: api.timestamp,\n    screenshotUrl: api.screenshot_url,\n    capturedAt: api.captured_at,\n    status: api.status,\n  };\n}\n\nfunction mapErrorsResponse(api: any): ErrorsResponse {\n  return {\n    recordingId: api.recording_id,\n    totalErrors: api.total_errors,\n    errors: Array.isArray(api.errors) ? api.errors.map(mapBrowserError) : [],\n  };\n}\n\nfunction mapWebpResponse(api: any): WebpResponse {\n  return {\n    webpUrl: api.webp_url,\n    cached: api.cached,\n    width: api.width,\n    fps: api.fps,\n    maxDuration: api.max_duration,\n    fileSize: api.file_size,\n    maxSizeMb: api.max_size_mb,\n    budgetMet: api.budget_met,\n    qualityUsed: api.quality_used,\n    attempts: api.attempts,\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 = mapTaskResult(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  const debugUrl = result.debugUrl ?? '';\n\n  const wrapped: BrowserTaskWithPromise = {\n    ...result,\n    debugUrl,\n    taskId: result.taskId || '',\n    liveUrl: result.taskId\n      ? generateLiveUrl(result.taskId, config)\n      : debugUrl,\n    complete: async (pollConfig?: { interval?: number; timeout?: number }) => {\n      // If we have a taskId, poll task status endpoint\n      if (result.taskId) {\n        return pollTaskUntilComplete(result.taskId!, config, pollConfig);\n      }\n      // If we have a recordingId, poll recording status instead\n      if (result.recordingId) {\n        const recording = await waitForRecording(\n          result.recordingId,\n          config,\n          pollConfig\n        );\n        // Return a result-like object (recording doesn't have full task result)\n        return {\n          ...result,\n          recordingStatus: recording.status,\n        } as BrowserTaskResult;\n      }\n      // No way to poll completion\n      throw new Error('Cannot poll completion: no taskId or recordingId available');\n    },\n    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(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: debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(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: debugUrl\n      ? () => buildEmbedCode(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  const debugUrl = result.debugUrl ?? '';\n  const parsed = result.output\n    ? parseStructuredTaskOutput<T>(result, schema)\n    : { ...result, parsed: null };\n\n  const wrapped: BrowserTaskWithPromiseAndSchema<T> = {\n    ...parsed,\n    debugUrl,\n    taskId: result.taskId || '',\n    liveUrl: result.taskId\n      ? generateLiveUrl(result.taskId, config)\n      : debugUrl,\n    complete: async (pollConfig?: { interval?: number; timeout?: number }) => {\n      // If we have a taskId, poll task status endpoint\n      if (result.taskId) {\n        const finalResult = await pollTaskUntilComplete(result.taskId!, config, pollConfig);\n        return parseStructuredTaskOutput<T>(finalResult, schema);\n      }\n      // If we have a recordingId, poll recording status instead\n      if (result.recordingId) {\n        const recording = await waitForRecording(\n          result.recordingId,\n          config,\n          pollConfig\n        );\n        // Return parsed result (recording doesn't have task output)\n        return {\n          ...parsed,\n          recordingStatus: recording.status,\n        };\n      }\n      // No way to poll completion\n      throw new Error('Cannot poll completion: no taskId or recordingId available');\n    },\n    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(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: debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(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: debugUrl\n      ? () => buildEmbedCode(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 * Get animated WebP preview of recording\n * \n * Converts the native video recording to an animated WebP. Results are cached in S3.\n * \n * @param recordingId - Recording UUID from BrowserTaskResult\n * @param config - Configuration with apiKey\n * @param options - WebP generation options\n * @returns WebP URL and metadata\n * \n * @example\n * ```typescript\n * const webp = await getWebp('uuid-here', { apiKey: 'key' }, {\n *   width: 780,\n *   fps: 10,\n *   quality: 65,\n *   maxDuration: 15\n * });\n * console.log('WebP URL:', webp.webpUrl);\n * console.log('From cache:', webp.cached);\n * ```\n */\nexport async function getWebp(\n  recordingId: string,\n  config: BrowserConfig = {},\n  options: WebpOptions = {}\n): Promise<WebpResponse> {\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 getWebp');\n  }\n\n  // Build query params\n  const params = new URLSearchParams();\n  if (options.maxDuration !== undefined) params.set('max_duration', String(options.maxDuration));\n  if (options.fps !== undefined) params.set('fps', String(options.fps));\n  if (options.width !== undefined) params.set('width', String(options.width));\n  if (options.quality !== undefined) params.set('quality', String(options.quality));\n  if (options.maxSizeMb !== undefined) params.set('max_size_mb', String(options.maxSizeMb));\n\n  const url = `${apiUrl}/recordings/${recordingId}/webp${params.toString() ? '?' + params.toString() : ''}`;\n  \n  if (debug) console.log(`[Browser] getWebp: ${url}`);\n\n  const response = await fetch(url, {\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] getWebp error: ${response.status} - ${errorText}`);\n    throw new Error(`HTTP ${response.status}: ${errorText}`);\n  }\n\n  const result = mapWebpResponse(await response.json());\n  if (debug) console.log(`[Browser] WebP ready: ${result.webpUrl} (cached: ${result.cached})`);\n\n  return result;\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 * Tool descriptions and prompts for AI models\n */\n\nexport const BROWSER_TOOL_DESCRIPTION = `Test and verify your implemented code in a live browser. This tool executes natural language test instructions and returns a video recording plus detailed logs to help you debug issues.\n\n## When to Use\nUse this AFTER coding is complete to verify your implementation:\n- You've finished writing/modifying code and need to verify it works\n- You need to test user interactions end-to-end (clicks, forms, navigation)\n- You want to catch runtime errors, console warnings, or network failures\n- You need visual confirmation that UI elements render and behave correctly\n\n## What You Get Back\nThe tool returns debugging artifacts to help you identify and fix issues:\n- **Video recording**: Watch exactly what happened in the browser session\n- **Console logs**: All console.log, warnings, and errors with timestamps\n- **Network logs**: Failed requests, 404s, API errors with screenshots\n- **Error screenshots**: Visual snapshots captured when errors occur\n\n## How to Write Good Tests\nBe specific about the user journey you're testing:\n❌ Bad: \"Test the login feature\"\n✅ Good: \"Navigate to /login, enter 'test@example.com' and 'password123', click the Login button, verify we reach the /dashboard page\"\n\nInclude verification steps:\n✅ \"Click the Add Item button, verify the item appears in the list\"\n✅ \"Submit the form, verify a success message is displayed\"\n\n## Iterating on Failures\n1. Run the test and review the video + logs\n2. Identify the specific issue (console error, failed request, wrong behavior)\n3. Fix the code based on the evidence\n4. Re-run the test to verify the fix\n5. Repeat until test passes\n\n## Requirements\n- **URL**: Must be publicly accessible (use tunnels like ngrok, Cloudflare, or deploy to staging)\n- **Timing**: Use this after implementation, not during coding\n- **Complexity**: Set maxSteps higher (20-30) for multi-step user workflows`;\n\n\nexport const BROWSER_SYSTEM_PROMPT = `You are an AI agent designed to automate browser tasks to accomplish the <user_request>. Respond with a valid JSON object in the format: {\"thinking\": \"Reason step-by-step about your current state, history, and the user request to decide your next goal and action. Analyze the browser state and screenshot to confirm the outcome of your last action.\", \"evaluation_previous_goal\": \"A concise, one-sentence evaluation of your last action's outcome (e.g., Success, Failure, or Uncertain).\", \"memory\": \"1-3 sentences summarizing key information and progress so far. This helps you track progress across multiple steps (e.g., items collected, pages visited).\", \"next_goal\": \"A clear, one-sentence description of your immediate next objective.\", \"action\": [{\"action_name\": {\"parameter\": \"value\"}}]}`;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../tools/browser/openai.ts","../../../tools/utils/resilience.ts","../../../tools/browser/profiles/core.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        maxSteps: {\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 * Returns a concise summary suitable for agent context. The full result object\n * (with urls, errors, action_history, judgement, etc.) is available when calling\n * execute() directly, but this formatted string omits those details to save tokens.\n * \n * @param result - Browser task result with full history data\n * @returns Formatted string summary 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.stepsTaken ?? 0}`,\n      result.executionTimeMs ? `Execution time: ${result.executionTimeMs}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 * 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 * ProfilesClient - Manage browser profiles for storing login state.\n *\n * @example\n * ```typescript\n * const morph = new MorphClient({ apiKey: '...' });\n *\n * // Create a profile + live setup session\n * const setup = await morph.browser.profiles.createProfile({\n *   name: 'LinkedIn',\n *   repoId: 'owner/repo'\n * });\n *\n * console.log('Sign in at:', setup.session.debugUrl);\n * // User logs in, then explicitly save\n * await setup.save();\n *\n * // Use profile in browser tasks\n * await morph.browser.execute({\n *   task: 'Check notifications',\n *   url: 'https://linkedin.com',\n *   profileId: profile.id\n * });\n * ```\n */\n\nimport { fetchWithRetry } from '../../utils/resilience.js';\nimport type { BrowserConfig } from '../types.js';\nimport {\n  MorphValidationError,\n  MorphAuthenticationError,\n  parseAPIError,\n} from '../errors.js';\nimport type {\n  Profile,\n  ProfileSetup,\n  ProfileWithMethods,\n  CreateProfileInput,\n  ProfileListResponse,\n  ProfileSession,\n  ProfileSessionInput,\n  SaveProfileSessionInput,\n  ProfileStateResponse,\n  RepoSummary,\n  RepoListResponse,\n  APIProfile,\n  APIProfileSession,\n  APIProfileStateResponse,\n} from './types.js';\nimport {\n  transformProfile,\n  transformCreateInput,\n  transformSession,\n  transformSaveInput,\n  transformStateResponse,\n} from './types.js';\n\nconst DEFAULT_API_URL = process.env.MORPH_ENVIRONMENT === 'DEV'\n  ? 'http://localhost:8000'\n  : 'https://browser.morphllm.com';\n\n/**\n * ProfilesClient class for managing browser profiles.\n *\n * Access via `morph.browser.profiles` on a MorphClient instance.\n */\nexport class ProfilesClient {\n  private config: BrowserConfig;\n\n  constructor(config: BrowserConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Create a new browser profile and immediately start a live session.\n   *\n   * @param input - Profile creation parameters\n   * @returns Profile setup handle with live URL + save()\n   * @throws {MorphValidationError} If input validation fails\n   * @throws {MorphProfileLimitError} If profile limit is exceeded\n   * @throws {MorphAuthenticationError} If API key is missing or invalid\n   *\n   * @example\n   * ```typescript\n * const setup = await morph.browser.profiles.createProfile({\n *   name: 'LinkedIn Production',\n *   repoId: 'owner/repo'\n * });\n * console.log(setup.session.debugUrl);\n * await setup.save();\n   * ```\n   */\n  async createProfile(input: CreateProfileInput): Promise<ProfileSetup> {\n    return createProfile(input, this.config);\n  }\n\n  /**\n   * List all profiles for the authenticated user.\n   *\n   * @param repoId - Optional repository ID to filter by\n   * @returns Array of profiles\n   *\n   * @example\n   * ```typescript\n   * // List all profiles\n   * const allProfiles = await morph.browser.profiles.listProfiles();\n   *\n   * // List profiles for a specific repo\n   * const repoProfiles = await morph.browser.profiles.listProfiles('owner/repo');\n   * ```\n   */\n  async listProfiles(repoId?: string): Promise<Profile[]> {\n    return listProfiles(this.config, repoId);\n  }\n\n  /**\n   * Get a profile by ID with convenience methods.\n   *\n   * @param id - Profile ID\n   * @returns Profile with attached methods\n   * @throws {MorphNotFoundError} If profile is not found\n   *\n   * @example\n   * ```typescript\n   * const profile = await morph.browser.profiles.getProfile('profile-id');\n   * const state = await profile.getState();\n   * await profile.delete();\n   * ```\n   */\n  async getProfile(id: string): Promise<ProfileWithMethods> {\n    return getProfile(id, this.config);\n  }\n\n  /**\n   * Update a profile by opening a live session (no rename).\n   *\n   * @param id - Profile ID\n   * @returns Profile setup handle with live URL + save()\n   */\n  async updateProfile(id: string): Promise<ProfileSetup> {\n    return updateProfile(id, this.config);\n  }\n\n  /**\n   * Delete a profile.\n   *\n   * @param id - Profile ID\n   * @throws {MorphNotFoundError} If profile is not found\n   */\n  async deleteProfile(id: string): Promise<void> {\n    return deleteProfile(id, this.config);\n  }\n\n  /**\n   * Start a browser session for profile setup.\n   *\n   * Returns a live URL where the user can sign into accounts.\n   * After signing in, call `saveSession` to persist the state.\n   *\n   * @param input - Optional session parameters\n   * @returns Session with debug URL\n   *\n   * @example\n   * ```typescript\n   * const session = await morph.browser.profiles.startSession();\n   * console.log('Sign in at:', session.debugUrl);\n   * // Open debugUrl in browser, user signs in...\n   * await morph.browser.profiles.saveSession(session.sessionId, profile.id);\n   * ```\n   */\n  async startSession(input?: ProfileSessionInput): Promise<ProfileSession> {\n    return startProfileSession(this.config, input);\n  }\n\n  /**\n   * Save browser state from a session to a profile.\n   *\n   * Call this after the user is done signing into accounts.\n   * Extracts cookies, localStorage, and sessionStorage.\n   *\n   * @param sessionId - Browser session ID from startSession\n   * @param profileId - Profile ID to save state to\n   * @returns Updated profile with cookie domains\n   */\n  async saveSession(sessionId: string, profileId: string): Promise<Profile> {\n    return saveProfileSession({ sessionId, profileId }, this.config);\n  }\n\n  /**\n   * List available repo IDs (discovery).\n   *\n   * @returns Repo summaries with profile counts\n   */\n  async listRepos(): Promise<RepoSummary[]> {\n    return listRepos(this.config);\n  }\n\n  /**\n   * Get the presigned URL for a profile's state.\n   *\n   * Use this to download the raw state JSON for debugging\n   * or to restore state manually.\n   *\n   * @param profileId - Profile ID\n   * @returns State URL with expiry information\n   */\n  async getProfileState(profileId: string): Promise<ProfileStateResponse> {\n    return getProfileState(profileId, this.config);\n  }\n}\n\n// ============================================================================\n// Validation Helpers\n// ============================================================================\n\nfunction validateCreateInput(input: CreateProfileInput): void {\n  if (!input.name || typeof input.name !== 'string') {\n    throw new MorphValidationError('name is required', 'name');\n  }\n\n  const trimmedName = input.name.trim();\n  if (trimmedName.length === 0) {\n    throw new MorphValidationError('name cannot be empty', 'name');\n  }\n\n  if (trimmedName.length > 100) {\n    throw new MorphValidationError('name must be 100 characters or less', 'name');\n  }\n\n  if (!input.repoId || typeof input.repoId !== 'string') {\n    throw new MorphValidationError('repoId is required', 'repoId');\n  }\n\n  if (input.repoId.trim().length === 0) {\n    throw new MorphValidationError('repoId cannot be empty', 'repoId');\n  }\n}\n\nfunction validateId(id: string, fieldName: string): void {\n  if (!id || typeof id !== 'string') {\n    throw new MorphValidationError(`${fieldName} is required`, fieldName);\n  }\n\n  if (id.trim().length === 0) {\n    throw new MorphValidationError(`${fieldName} cannot be empty`, fieldName);\n  }\n}\n\n// ============================================================================\n// Standalone Functions\n// ============================================================================\n\n/**\n * Create a new browser profile.\n */\nexport async function createProfile(\n  input: CreateProfileInput,\n  config: BrowserConfig = {}\n): Promise<ProfileSetup> {\n  validateCreateInput(input);\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles`,\n    {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(transformCreateInput(input)),\n    },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiProfile: APIProfile = await response.json();\n  const profile = transformProfile(apiProfile);\n  const session = await startProfileSession(config, { profileId: profile.id });\n  return buildProfileSetup(profile, session, config);\n}\n\n/**\n * List all profiles for the authenticated user.\n */\nexport async function listProfiles(\n  config: BrowserConfig = {},\n  repoId?: string\n): Promise<Profile[]> {\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const url = repoId\n    ? `${apiUrl}/profiles?repo_id=${encodeURIComponent(repoId)}`\n    : `${apiUrl}/profiles`;\n\n  const response = await fetchWithRetry(\n    url,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const data: { profiles: APIProfile[] } = await response.json();\n  return data.profiles.map(transformProfile);\n}\n\n/**\n * Get a profile by ID with convenience methods.\n */\nexport async function getProfile(\n  id: string,\n  config: BrowserConfig = {}\n): Promise<ProfileWithMethods> {\n  validateId(id, 'id');\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/${encodeURIComponent(id)}`,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiProfile: APIProfile = await response.json();\n  const profile = transformProfile(apiProfile);\n\n  // Attach convenience methods\n  return {\n    ...profile,\n    getState: () => getProfileState(id, config),\n    delete: () => deleteProfile(id, config),\n  };\n}\n\n/**\n * Update a profile.\n */\nexport async function updateProfile(\n  id: string,\n  config: BrowserConfig = {}\n): Promise<ProfileSetup> {\n  validateId(id, 'id');\n  const profile = await fetchProfile(id, config);\n  const session = await startProfileSession(config, { profileId: profile.id });\n  return buildProfileSetup(profile, session, config);\n}\n\n/**\n * Delete a profile.\n */\nexport async function deleteProfile(\n  id: string,\n  config: BrowserConfig = {}\n): Promise<void> {\n  validateId(id, 'id');\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/${encodeURIComponent(id)}`,\n    { method: 'DELETE', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n}\n\n/**\n * Start a browser session for profile setup.\n */\nexport async function startProfileSession(\n  config: BrowserConfig = {},\n  input?: ProfileSessionInput\n): Promise<ProfileSession> {\n  if (!config.apiKey) {\n    throw new MorphAuthenticationError();\n  }\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  // Transform input if provided\n  const body = input?.profileId\n    ? { profile_id: input.profileId }\n    : {};\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/session/start`,\n    {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(body),\n    },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiSession: APIProfileSession = await response.json();\n  return transformSession(apiSession);\n}\n\n/**\n * Save browser state from a session to a profile.\n */\nexport async function saveProfileSession(\n  input: SaveProfileSessionInput,\n  config: BrowserConfig = {}\n): Promise<Profile> {\n  validateId(input.sessionId, 'sessionId');\n  validateId(input.profileId, 'profileId');\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/session/save`,\n    {\n      method: 'POST',\n      headers,\n      body: JSON.stringify(transformSaveInput(input)),\n    },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiProfile: APIProfile = await response.json();\n  return transformProfile(apiProfile);\n}\n\n/**\n * List repo IDs available to the authenticated user/org.\n */\nexport async function listRepos(config: BrowserConfig = {}): Promise<RepoSummary[]> {\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/repos`,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const data = await response.json();\n  const repos = Array.isArray(data?.repos) ? data.repos : [];\n\n  return repos.map((repo: any) => ({\n    repoId: repo.repo_id,\n    repoFullName: repo.repo_full_name,\n    profileCount: repo.profile_count ?? 0,\n  })) satisfies RepoSummary[];\n}\n\n/**\n * Get the presigned URL for a profile's state.\n */\nexport async function getProfileState(\n  profileId: string,\n  config: BrowserConfig = {}\n): Promise<ProfileStateResponse> {\n  validateId(profileId, 'profileId');\n\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/${encodeURIComponent(profileId)}/state`,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiState: APIProfileStateResponse = await response.json();\n  return transformStateResponse(apiState);\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction buildHeaders(config: BrowserConfig): Record<string, string> {\n  const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n  if (config.apiKey) {\n    headers['Authorization'] = `Bearer ${config.apiKey}`;\n  }\n  return headers;\n}\n\nasync function fetchProfile(id: string, config: BrowserConfig): Promise<Profile> {\n  const apiUrl = config.apiUrl || DEFAULT_API_URL;\n  const headers = buildHeaders(config);\n\n  const response = await fetchWithRetry(\n    `${apiUrl}/profiles/${encodeURIComponent(id)}`,\n    { method: 'GET', headers },\n    config.retryConfig\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    const requestId = response.headers.get('x-request-id') || undefined;\n    throw parseAPIError(response.status, errorText, requestId);\n  }\n\n  const apiProfile: APIProfile = await response.json();\n  return transformProfile(apiProfile);\n}\n\nfunction buildProfileSetup(profile: Profile, session: ProfileSession, config: BrowserConfig): ProfileSetup {\n  return {\n    profile,\n    session,\n    save: () => saveProfileSession({ sessionId: session.sessionId, profileId: profile.id }, config),\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  RecordingWithMethods,\n  ErrorsResponse,\n  LiveSessionOptions,\n  IframeOptions,\n  WebpOptions,\n  WebpResponse,\n} from './types.js';\nimport { buildLiveUrl, buildLiveIframe, buildEmbedCode, resolvePreset } from './live.js';\nimport { ProfilesClient } from './profiles/core.js';\n\nconst DEFAULT_CONFIG = {\n  apiUrl: process.env.MORPH_ENVIRONMENT === 'DEV' \n    ? 'http://localhost:8000'\n    : 'https://browser.morphllm.com',\n  timeout: 1000000, // 10 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  /**\n   * Profile management - create and manage browser profiles for storing login state.\n   */\n  public profiles: ProfilesClient;\n\n  constructor(config: BrowserConfig = {}) {\n    this.config = {\n      ...DEFAULT_CONFIG,\n      ...config,\n    };\n    this.profiles = new ProfilesClient(this.config);\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    const apiUrl = this.config.apiUrl || DEFAULT_CONFIG.apiUrl;\n    const debug = this.config.debug || false;\n    \n    const hasTask = typeof input.task === 'string' && input.task.trim().length > 0;\n    const hasDiff = typeof (input as any).diff === 'string' && (input as any).diff.trim().length > 0;\n\n    if (!hasTask && !hasDiff) {\n      throw new Error('Browser task requires either \"task\" (natural language) or \"diff\" (PR-review planning)');\n    }\n\n    if (debug) {\n      const preview = (input.task ?? '').slice(0, 60);\n      console.log(`[Browser] createTask: \"${preview}...\" url=${input.url || 'none'}`);\n      console.log(`[Browser] Calling async endpoint: ${apiUrl}/browser-task/async`);\n    }\n    \n    const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n    if (this.config.apiKey) headers['Authorization'] = `Bearer ${this.config.apiKey}`;\n    \n    // Call ASYNC endpoint for immediate return with live URL\n    const response = await fetch(`${apiUrl}/browser-task/async`, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify({\n        task: input.task,\n        diff: input.diff,\n        url: input.url,\n        max_steps: input.maxSteps ?? 10,\n        model: input.model ?? 'morph-computer-use-v0',\n        viewport_width: input.viewportWidth ?? 1280,\n        viewport_height: input.viewportHeight ?? 720,\n        external_id: input.externalId,\n        repo_id: input.repoId,\n        repo_full_name: input.repoFullName,\n        commit_id: input.commitId,\n        record_video: input.recordVideo ?? false,\n        video_width: input.videoWidth ?? input.viewportWidth ?? 1280,\n        video_height: input.videoHeight ?? input.viewportHeight ?? 720,\n        allow_resizing: input.allowResizing ?? false,\n        structured_output: 'schema' in input ? stringifyStructuredOutput(input.schema) : undefined,\n        auth: input.auth,\n        profile_id: input.profileId,\n      }),\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 = mapTaskResult(await response.json());\n    \n    if (debug) {\n      const debugUrl = result.debugUrl;\n      console.log(`[Browser] ✅ Task created: recordingId=${result.recordingId ?? 'none'} debugUrl=${debugUrl ? 'available' : 'none'}`);\n    }\n    \n    if ('schema' in input) {\n      return wrapTaskResponseWithSchema(result, this.config, input.schema);\n    } else {\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 & { recordVideo: true }\n  ): Promise<BrowserTaskResult & { recording?: RecordingWithMethods }> {\n    return executeWithRecording(input, this.config);\n  }\n\n  /**\n   * Get recording status and URLs\n   */\n  async getRecording(recordingId: string): Promise<RecordingWithMethods> {\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<RecordingWithMethods> {\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   * Get animated WebP preview of recording\n   */\n  async getWebp(\n    recordingId: string,\n    options?: WebpOptions\n  ): Promise<WebpResponse> {\n    return getWebp(recordingId, this.config, options);\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 * Returns the full task result including rich agent history data (urls, errors, \n * action_history, judgement, etc.). When using this as an agent tool, use the\n * formatResult() functions from the SDK adapters to return a concise summary.\n * \n * @param input - Task parameters\n * @param config - Optional configuration (apiKey, apiUrl to override default)\n * @returns Task result with success status, findings, and comprehensive execution history\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 *     maxSteps: 20,\n *     repoId: \"my-project\",\n *     commitId: \"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('URLs visited:', result.urls);\n *   console.log('Actions taken:', result.actionNames);\n *   console.log('Has errors:', result.hasErrors);\n *   console.log('Replay:', result.replayUrl);\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.maxSteps !== undefined && (input.maxSteps < 1 || input.maxSteps > 50)) {\n    return { \n      success: false, \n      error: 'maxSteps 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.maxSteps ?? 10}`);\n    console.log(`[Browser] Recording: ${input.recordVideo ? '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.maxSteps ?? 10,\n          model: input.model ?? 'morph-computer-use-v0',\n          viewport_width: input.viewportWidth ?? 1280,\n          viewport_height: input.viewportHeight ?? 720,\n          external_id: input.externalId,\n          repo_id: input.repoId,\n          commit_id: input.commitId,\n          record_video: input.recordVideo ?? false,\n          video_width: input.videoWidth ?? input.viewportWidth ?? 1280,\n          video_height: input.videoHeight ?? input.viewportHeight ?? 720,\n          allow_resizing: input.allowResizing ?? false,\n          structured_output: input.structuredOutput,\n          auth: input.auth,\n          profile_id: input.profileId,\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 maxSteps.`\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 = mapTaskResult(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.stepsTaken ?? 0} recordingId=${result.recordingId ?? '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 with convenience methods (.getWebp(), .getErrors())\n * \n * @example\n * ```typescript\n * const recording = await getRecording('uuid-here', { apiKey: 'key' });\n * \n * // Get animated WebP\n * const { webpUrl } = await recording.getWebp({ width: 780 });\n * \n * // Get errors with screenshots\n * const { errors } = await recording.getErrors();\n * ```\n */\nexport async function getRecording(\n  recordingId: string,\n  config: BrowserConfig = {}\n): Promise<RecordingWithMethods> {\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 data: RecordingStatus = mapRecordingStatus(await response.json());\n  if (debug) console.log(`[Browser] Recording status: ${data.status}`);\n\n  // Return recording with convenience methods\n  return {\n    ...data,\n    getWebp: (options?: WebpOptions) => getWebp(recordingId, config, options),\n    getErrors: () => getErrors(recordingId, config),\n  };\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: '...', recordVideo: true }, config);\n * if (result.recordingId) {\n *   const recording = await waitForRecording(result.recordingId, config, {\n *     timeout: 60000,  // 1 minute\n *     pollInterval: 2000  // Check every 2 seconds\n *   });\n *   console.log('Video URL:', recording.videoUrl);\n * }\n * ```\n */\nexport async function waitForRecording(\n  recordingId: string,\n  config: BrowserConfig = {},\n  options: { timeout?: number; pollInterval?: number } = {}\n): Promise<RecordingWithMethods> {\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 recordVideo=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 *     recordVideo: true,\n *     repoId: \"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?.videoUrl);\n * ```\n */\nexport async function executeWithRecording(\n  input: BrowserTaskInput & { recordVideo: true },\n  config: BrowserConfig = {}\n): Promise<BrowserTaskResult & { recording?: RecordingWithMethods }> {\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.recordingId) {\n    try {\n      const recording = await waitForRecording(\n        taskResult.recordingId,\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      // Still attach convenience methods for consistent API\n      const errorRecording: RecordingWithMethods = {\n        id: taskResult.recordingId,\n        status: 'ERROR',\n        error: error instanceof Error ? error.message : String(error),\n        createdAt: new Date().toISOString(),\n        getWebp: (options?: WebpOptions) => getWebp(taskResult.recordingId!, config, options),\n        getErrors: () => getErrors(taskResult.recordingId!, config),\n      };\n      return {\n        ...taskResult,\n        recording: errorRecording,\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, totalErrors } = await getErrors('uuid-here', { apiKey: 'key' });\n * \n * console.log(`Found ${totalErrors} 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.screenshotUrl) console.log(`  Screenshot: ${err.screenshotUrl}`);\n *   \n *   // Download screenshot\n *   if (err.screenshotUrl) {\n *     const response = await fetch(err.screenshotUrl);\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 = mapErrorsResponse(await response.json());\n  if (debug) console.log(`[Browser] Found ${errors.totalErrors} 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\nfunction mapTaskResult(api: any): BrowserTaskResult {\n  if (!api || typeof api !== 'object') {\n    return api as BrowserTaskResult;\n  }\n\n  return {\n    success: api.success,\n    result: api.result,\n    error: api.error,\n    stepsTaken: api.steps_taken,\n    executionTimeMs: api.execution_time_ms,\n    urls: api.urls,\n    actionNames: api.action_names,\n    errors: api.errors,\n    modelActions: api.model_actions,\n    isDone: api.is_done,\n    actionHistory: api.action_history,\n    actionResults: api.action_results,\n    hasErrors: api.has_errors,\n    numberOfSteps: api.number_of_steps,\n    judgement: api.judgement,\n    isValidated: api.is_validated,\n    replayId: api.replay_id,\n    replayUrl: api.replay_url,\n    recordingId: api.recording_id,\n    recordingStatus: api.recording_status,\n    taskId: api.task_id,\n    status: api.status,\n    output: api.output,\n    debugUrl: api.debug_url,\n  };\n}\n\nfunction mapRecordingStatus(api: any): RecordingStatus {\n  return {\n    id: api.id,\n    status: api.status,\n    replayUrl: api.replay_url,\n    networkUrl: api.network_url,\n    consoleUrl: api.console_url,\n    videoUrl: api.video_url,\n    totalEvents: api.total_events,\n    fileSize: api.file_size,\n    duration: api.duration,\n    error: api.error,\n    createdAt: api.created_at,\n  };\n}\n\nfunction mapBrowserError(api: any): ErrorsResponse['errors'][number] {\n  return {\n    type: api.type,\n    message: api.message,\n    url: api.url,\n    timestamp: api.timestamp,\n    screenshotUrl: api.screenshot_url,\n    capturedAt: api.captured_at,\n    status: api.status,\n  };\n}\n\nfunction mapErrorsResponse(api: any): ErrorsResponse {\n  return {\n    recordingId: api.recording_id,\n    totalErrors: api.total_errors,\n    errors: Array.isArray(api.errors) ? api.errors.map(mapBrowserError) : [],\n  };\n}\n\nfunction mapWebpResponse(api: any): WebpResponse {\n  return {\n    webpUrl: api.webp_url,\n    cached: api.cached,\n    width: api.width,\n    fps: api.fps,\n    maxDuration: api.max_duration,\n    fileSize: api.file_size,\n    maxSizeMb: api.max_size_mb,\n    budgetMet: api.budget_met,\n    qualityUsed: api.quality_used,\n    attempts: api.attempts,\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 = mapTaskResult(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  const debugUrl = result.debugUrl ?? '';\n\n  const wrapped: BrowserTaskWithPromise = {\n    ...result,\n    debugUrl,\n    taskId: result.taskId || '',\n    liveUrl: result.taskId\n      ? generateLiveUrl(result.taskId, config)\n      : debugUrl,\n    complete: async (pollConfig?: { interval?: number; timeout?: number }) => {\n      // If we have a taskId, poll task status endpoint\n      if (result.taskId) {\n        return pollTaskUntilComplete(result.taskId!, config, pollConfig);\n      }\n      // If we have a recordingId, poll recording status instead\n      if (result.recordingId) {\n        const recording = await waitForRecording(\n          result.recordingId,\n          config,\n          pollConfig\n        );\n        // Return a result-like object (recording doesn't have full task result)\n        return {\n          ...result,\n          recordingStatus: recording.status,\n        } as BrowserTaskResult;\n      }\n      // No way to poll completion\n      throw new Error('Cannot poll completion: no taskId or recordingId available');\n    },\n    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(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: debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(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: debugUrl\n      ? () => buildEmbedCode(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  const debugUrl = result.debugUrl ?? '';\n  const parsed = result.output\n    ? parseStructuredTaskOutput<T>(result, schema)\n    : { ...result, parsed: null };\n\n  const wrapped: BrowserTaskWithPromiseAndSchema<T> = {\n    ...parsed,\n    debugUrl,\n    taskId: result.taskId || '',\n    liveUrl: result.taskId\n      ? generateLiveUrl(result.taskId, config)\n      : debugUrl,\n    complete: async (pollConfig?: { interval?: number; timeout?: number }) => {\n      // If we have a taskId, poll task status endpoint\n      if (result.taskId) {\n        const finalResult = await pollTaskUntilComplete(result.taskId!, config, pollConfig);\n        return parseStructuredTaskOutput<T>(finalResult, schema);\n      }\n      // If we have a recordingId, poll recording status instead\n      if (result.recordingId) {\n        const recording = await waitForRecording(\n          result.recordingId,\n          config,\n          pollConfig\n        );\n        // Return parsed result (recording doesn't have task output)\n        return {\n          ...parsed,\n          recordingStatus: recording.status,\n        };\n      }\n      // No way to poll completion\n      throw new Error('Cannot poll completion: no taskId or recordingId available');\n    },\n    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(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: debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(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: debugUrl\n      ? () => buildEmbedCode(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 * Get animated WebP preview of recording\n * \n * Converts the native video recording to an animated WebP. Results are cached in S3.\n * \n * @param recordingId - Recording UUID from BrowserTaskResult\n * @param config - Configuration with apiKey\n * @param options - WebP generation options\n * @returns WebP URL and metadata\n * \n * @example\n * ```typescript\n * const webp = await getWebp('uuid-here', { apiKey: 'key' }, {\n *   width: 780,\n *   fps: 10,\n *   quality: 65,\n *   maxDuration: 15\n * });\n * console.log('WebP URL:', webp.webpUrl);\n * console.log('From cache:', webp.cached);\n * ```\n */\nexport async function getWebp(\n  recordingId: string,\n  config: BrowserConfig = {},\n  options: WebpOptions = {}\n): Promise<WebpResponse> {\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 getWebp');\n  }\n\n  // Build query params\n  const params = new URLSearchParams();\n  if (options.maxDuration !== undefined) params.set('max_duration', String(options.maxDuration));\n  if (options.fps !== undefined) params.set('fps', String(options.fps));\n  if (options.width !== undefined) params.set('width', String(options.width));\n  if (options.quality !== undefined) params.set('quality', String(options.quality));\n  if (options.maxSizeMb !== undefined) params.set('max_size_mb', String(options.maxSizeMb));\n\n  const url = `${apiUrl}/recordings/${recordingId}/webp${params.toString() ? '?' + params.toString() : ''}`;\n  \n  if (debug) console.log(`[Browser] getWebp: ${url}`);\n\n  const response = await fetch(url, {\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] getWebp error: ${response.status} - ${errorText}`);\n    throw new Error(`HTTP ${response.status}: ${errorText}`);\n  }\n\n  const result = mapWebpResponse(await response.json());\n  if (debug) console.log(`[Browser] WebP ready: ${result.webpUrl} (cached: ${result.cached})`);\n\n  return result;\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 * Tool descriptions and prompts for AI models\n */\n\nexport const BROWSER_TOOL_DESCRIPTION = `Test and verify your implemented code in a live browser. This tool executes natural language test instructions and returns a video recording plus detailed logs to help you debug issues.\n\n## When to Use\nUse this AFTER coding is complete to verify your implementation:\n- You've finished writing/modifying code and need to verify it works\n- You need to test user interactions end-to-end (clicks, forms, navigation)\n- You want to catch runtime errors, console warnings, or network failures\n- You need visual confirmation that UI elements render and behave correctly\n\n## What You Get Back\nThe tool returns debugging artifacts to help you identify and fix issues:\n- **Video recording**: Watch exactly what happened in the browser session\n- **Console logs**: All console.log, warnings, and errors with timestamps\n- **Network logs**: Failed requests, 404s, API errors with screenshots\n- **Error screenshots**: Visual snapshots captured when errors occur\n\n## How to Write Good Tests\nBe specific about the user journey you're testing:\n❌ Bad: \"Test the login feature\"\n✅ Good: \"Navigate to /login, enter 'test@example.com' and 'password123', click the Login button, verify we reach the /dashboard page\"\n\nInclude verification steps:\n✅ \"Click the Add Item button, verify the item appears in the list\"\n✅ \"Submit the form, verify a success message is displayed\"\n\n## Iterating on Failures\n1. Run the test and review the video + logs\n2. Identify the specific issue (console error, failed request, wrong behavior)\n3. Fix the code based on the evidence\n4. Re-run the test to verify the fix\n5. Repeat until test passes\n\n## Requirements\n- **URL**: Must be publicly accessible (use tunnels like ngrok, Cloudflare, or deploy to staging)\n- **Timing**: Use this after implementation, not during coding\n- **Complexity**: Set maxSteps higher (20-30) for multi-step user workflows`;\n\n\nexport const BROWSER_SYSTEM_PROMPT = `You are an AI agent designed to automate browser tasks to accomplish the <user_request>. Respond with a valid JSON object in the format: {\"thinking\": \"Reason step-by-step about your current state, history, and the user request to decide your next goal and action. Analyze the browser state and screenshot to confirm the outcome of your last action.\", \"evaluation_previous_goal\": \"A concise, one-sentence evaluation of your last action's outcome (e.g., Success, Failure, or Uncertain).\", \"memory\": \"1-3 sentences summarizing key information and progress so far. This helps you track progress across multiple steps (e.g., items collected, pages visited).\", \"next_goal\": \"A clear, one-sentence description of your immediate next objective.\", \"action\": [{\"action_name\": {\"parameter\": \"value\"}}]}`;\n"],"mappings":"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","names":[]}

package/dist/tools/browser/openai.js

@@ -4,9 +4,9 @@ import {
   execute,
   formatResult,
   getSystemPrompt
-} from "../../chunk-YZ5NCWO2.js";
+} from "../../chunk-HONHUMCS.js";
 import "../../chunk-2HMEZZKK.js";
-import "../../chunk-QJP62BXH.js";
+import "../../chunk-5754T27Z.js";
 import "../../chunk-SI2CKRKJ.js";
 import "../../chunk-2AMEQAO2.js";
 import "../../chunk-2VERUKO2.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-3-flash-preview'\n  | 'morph-computer-use-v0'\n  | 'morph-computer-use-v1';\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: 1000000) */\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 * Authentication credentials for site login (follows browser-use sensitive_data pattern)\n */\nexport interface AuthCredentials {\n  /** Username/email for login */\n  username?: string;\n  /** Password for login */\n  password?: string;\n  /** Cookies in any JSON format, passed through to browser-use */\n  cookies?: any;\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  maxSteps?: 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  viewportWidth?: number;\n  /** Browser viewport height (default: 720) */\n  viewportHeight?: number;\n  /** User-defined reference/tracking ID (e.g., \"PR-1234\", \"jira-PROJ-567\") */\n  externalId?: string;\n  /** Optional repository database ID (UUID) to associate with this session - for internal use */\n  repoId?: string;\n  /** Optional repository full name (e.g., \"owner/repo\") - for external SDK users */\n  repoFullName?: string;\n  /** Optional commit UUID to associate with this session */\n  commitId?: string;\n  /** Record session video to S3 (default: false) */\n  recordVideo?: boolean;\n  /** Video width (default: 1280) */\n  videoWidth?: number;\n  /** Video height (default: 720) */\n  videoHeight?: number;\n  /** Enable window resizing for responsive/mobile testing. Disables stealth mode. (default: false) */\n  allowResizing?: boolean;\n  /** Serialized structured output schema (internal use) */\n  structuredOutput?: string;\n  /** Site authentication - global credentials or per-domain dict (follows browser-use pattern) */\n  auth?: AuthCredentials | Record<string, AuthCredentials>;\n  /** Profile ID - restore cookies/localStorage from a saved browser profile */\n  profileId?: string;\n}\n\n/**\n * Input with Zod schema for structured output\n */\nexport interface BrowserTaskInputWithSchema<T> extends Omit<BrowserTaskInput, 'structuredOutput'> {\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  stepsTaken?: number;\n  /** Total execution time in milliseconds */\n  executionTimeMs?: number;\n  \n  // Rich agent history data\n  /** All URLs visited during execution */\n  urls?: (string | null)[];\n  /** Names of all actions executed */\n  actionNames?: string[];\n  /** Per-step errors (null for steps without errors) */\n  errors?: (string | null)[];\n  /** All model actions with parameters */\n  modelActions?: any[];\n  /** Whether agent marked task as done */\n  isDone?: boolean;\n  /** Truncated action history with essential fields */\n  actionHistory?: any[][];\n  /** All action results */\n  actionResults?: any[];\n  /** Whether any errors occurred */\n  hasErrors?: boolean;\n  /** Total number of steps executed */\n  numberOfSteps?: number;\n  \n  // Judge validation\n  /** Judge validation result if available */\n  judgement?: {\n    reasoning?: string;\n    verdict: boolean;\n    failure_reason?: string;\n    impossible_task?: boolean;\n    reached_captcha?: boolean;\n  };\n  /** Whether judge validated the execution */\n  isValidated?: boolean;\n  \n  /** UUID of saved replay record (if session replay enabled) */\n  replayId?: string;\n  /** Browserless replay URL (if session replay enabled) */\n  replayUrl?: string;\n  /** Recording ID (if recordVideo=true) */\n  recordingId?: string;\n  /** Recording status: PENDING, PROCESSING, COMPLETED, ERROR */\n  recordingStatus?: string;\n  /** Task ID for async task tracking */\n  taskId?: 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  taskId: 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  taskId: 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  replayUrl?: string;\n  /** Presigned S3 URL for network logs (NDJSON format) */\n  networkUrl?: string;\n  /** Presigned S3 URL for console logs (NDJSON format) */\n  consoleUrl?: string;\n  /** Presigned S3 URL for native browser video (WebM or MP4 format, real-time recording) */\n  videoUrl?: string;\n  /** Total rrweb events captured */\n  totalEvents?: number;\n  /** Total bytes of all files */\n  fileSize?: number;\n  /** Duration in milliseconds */\n  duration?: number;\n  /** Error message if status=ERROR */\n  error?: string;\n  /** When recording was created */\n  createdAt: 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  screenshotUrl?: string;\n  /** When screenshot was captured (Unix timestamp) */\n  capturedAt?: 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  recordingId: string;\n  /** Total number of errors */\n  totalErrors: number;\n  /** Errors with real-time screenshots */\n  errors: BrowserError[];\n}\n\n/**\n * Options for WebP generation\n */\nexport interface WebpOptions {\n  /** Maximum duration in seconds (1-120, default: 60) */\n  maxDuration?: number;\n  /** Frame rate (5-30, default: 15) */\n  fps?: number;\n  /** Output width in pixels (320-1920, default: 780) */\n  width?: number;\n  /** Quality (10-100, default: 65) */\n  quality?: number;\n  /** Enable auto-zoom that follows click/input actions (default: false) */\n  autoZoom?: boolean;\n  /** Maximum file size in MB (0.5-50). Uses iterative reduction to guarantee budget. */\n  maxSizeMb?: number;\n}\n\n/**\n * Response from getWebp()\n */\nexport interface WebpResponse {\n  /** Presigned S3 URL for the WebP file */\n  webpUrl: string;\n  /** Whether the WebP was served from cache */\n  cached: boolean;\n  /** Width of the WebP (may differ from requested if budget-constrained) */\n  width: number;\n  /** Frame rate of the WebP (may differ from requested if budget-constrained) */\n  fps: number;\n  /** Max duration used (may differ from requested if budget-constrained) */\n  maxDuration: number;\n  /** File size in bytes */\n  fileSize?: number;\n  /** Max size budget in MB (if specified) */\n  maxSizeMb?: number;\n  /** Whether the file fits within the budget */\n  budgetMet?: boolean;\n  /** Quality setting used (may differ from requested if budget-constrained) */\n  qualityUsed?: number;\n  /** Number of encoding attempts needed to meet budget */\n  attempts?: number;\n}\n\n/**\n * Recording with convenience methods\n */\nexport interface RecordingWithMethods extends RecordingStatus {\n  /** Get animated WebP preview */\n  getWebp: (options?: WebpOptions) => Promise<WebpResponse>;\n  /** Get errors with screenshots */\n  getErrors: () => Promise<ErrorsResponse>;\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-3-flash-preview'\n  | 'morph-computer-use-v0'\n  | 'morph-computer-use-v1';\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: 1000000) */\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 * Authentication credentials for site login (follows browser-use sensitive_data pattern)\n */\nexport interface AuthCredentials {\n  /** Username/email for login */\n  username?: string;\n  /** Password for login */\n  password?: string;\n  /** Cookies in any JSON format, passed through to browser-use */\n  cookies?: any;\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  /**\n   * Optional PR diff used to generate a deterministic test plan on the backend.\n   * If provided, `task` is treated as optional human instructions / focus areas.\n   */\n  diff?: 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  maxSteps?: 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  viewportWidth?: number;\n  /** Browser viewport height (default: 720) */\n  viewportHeight?: number;\n  /** User-defined reference/tracking ID (e.g., \"PR-1234\", \"jira-PROJ-567\") */\n  externalId?: string;\n  /** Optional repository database ID (UUID) to associate with this session - for internal use */\n  repoId?: string;\n  /** Optional repository full name (e.g., \"owner/repo\") - for external SDK users */\n  repoFullName?: string;\n  /** Optional commit UUID to associate with this session */\n  commitId?: string;\n  /** Record session video to S3 (default: false) */\n  recordVideo?: boolean;\n  /** Video width (default: 1280) */\n  videoWidth?: number;\n  /** Video height (default: 720) */\n  videoHeight?: number;\n  /** Enable window resizing for responsive/mobile testing. Disables stealth mode. (default: false) */\n  allowResizing?: boolean;\n  /** Serialized structured output schema (internal use) */\n  structuredOutput?: string;\n  /** Site authentication - global credentials or per-domain dict (follows browser-use pattern) */\n  auth?: AuthCredentials | Record<string, AuthCredentials>;\n  /** Profile ID - restore cookies/localStorage from a saved browser profile */\n  profileId?: string;\n}\n\n/**\n * Input with Zod schema for structured output\n */\nexport interface BrowserTaskInputWithSchema<T> extends Omit<BrowserTaskInput, 'structuredOutput'> {\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  stepsTaken?: number;\n  /** Total execution time in milliseconds */\n  executionTimeMs?: number;\n  \n  // Rich agent history data\n  /** All URLs visited during execution */\n  urls?: (string | null)[];\n  /** Names of all actions executed */\n  actionNames?: string[];\n  /** Per-step errors (null for steps without errors) */\n  errors?: (string | null)[];\n  /** All model actions with parameters */\n  modelActions?: any[];\n  /** Whether agent marked task as done */\n  isDone?: boolean;\n  /** Truncated action history with essential fields */\n  actionHistory?: any[][];\n  /** All action results */\n  actionResults?: any[];\n  /** Whether any errors occurred */\n  hasErrors?: boolean;\n  /** Total number of steps executed */\n  numberOfSteps?: number;\n  \n  // Judge validation\n  /** Judge validation result if available */\n  judgement?: {\n    reasoning?: string;\n    verdict: boolean;\n    failure_reason?: string;\n    impossible_task?: boolean;\n    reached_captcha?: boolean;\n  };\n  /** Whether judge validated the execution */\n  isValidated?: boolean;\n  \n  /** UUID of saved replay record (if session replay enabled) */\n  replayId?: string;\n  /** Browserless replay URL (if session replay enabled) */\n  replayUrl?: string;\n  /** Recording ID (if recordVideo=true) */\n  recordingId?: string;\n  /** Recording status: PENDING, PROCESSING, COMPLETED, ERROR */\n  recordingStatus?: string;\n  /** Task ID for async task tracking */\n  taskId?: 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  taskId: 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  taskId: 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  replayUrl?: string;\n  /** Presigned S3 URL for network logs (NDJSON format) */\n  networkUrl?: string;\n  /** Presigned S3 URL for console logs (NDJSON format) */\n  consoleUrl?: string;\n  /** Presigned S3 URL for native browser video (WebM or MP4 format, real-time recording) */\n  videoUrl?: string;\n  /** Total rrweb events captured */\n  totalEvents?: number;\n  /** Total bytes of all files */\n  fileSize?: number;\n  /** Duration in milliseconds */\n  duration?: number;\n  /** Error message if status=ERROR */\n  error?: string;\n  /** When recording was created */\n  createdAt: 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  screenshotUrl?: string;\n  /** When screenshot was captured (Unix timestamp) */\n  capturedAt?: 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  recordingId: string;\n  /** Total number of errors */\n  totalErrors: number;\n  /** Errors with real-time screenshots */\n  errors: BrowserError[];\n}\n\n/**\n * Options for WebP generation\n */\nexport interface WebpOptions {\n  /** Maximum duration in seconds (1-120, default: 60) */\n  maxDuration?: number;\n  /** Frame rate (5-30, default: 15) */\n  fps?: number;\n  /** Output width in pixels (320-1920, default: 780) */\n  width?: number;\n  /** Quality (10-100, default: 65) */\n  quality?: number;\n  /** Enable auto-zoom that follows click/input actions (default: false) */\n  autoZoom?: boolean;\n  /** Maximum file size in MB (0.5-50). Uses iterative reduction to guarantee budget. */\n  maxSizeMb?: number;\n}\n\n/**\n * Response from getWebp()\n */\nexport interface WebpResponse {\n  /** Presigned S3 URL for the WebP file */\n  webpUrl: string;\n  /** Whether the WebP was served from cache */\n  cached: boolean;\n  /** Width of the WebP (may differ from requested if budget-constrained) */\n  width: number;\n  /** Frame rate of the WebP (may differ from requested if budget-constrained) */\n  fps: number;\n  /** Max duration used (may differ from requested if budget-constrained) */\n  maxDuration: number;\n  /** File size in bytes */\n  fileSize?: number;\n  /** Max size budget in MB (if specified) */\n  maxSizeMb?: number;\n  /** Whether the file fits within the budget */\n  budgetMet?: boolean;\n  /** Quality setting used (may differ from requested if budget-constrained) */\n  qualityUsed?: number;\n  /** Number of encoding attempts needed to meet budget */\n  attempts?: number;\n}\n\n/**\n * Recording with convenience methods\n */\nexport interface RecordingWithMethods extends RecordingStatus {\n  /** Get animated WebP preview */\n  getWebp: (options?: WebpOptions) => Promise<WebpResponse>;\n  /** Get errors with screenshots */\n  getErrors: () => Promise<ErrorsResponse>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

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

@@ -39,7 +39,12 @@ interface AuthCredentials {
  */
 interface BrowserTaskInput {
     /** Natural language description of what to do */
-    task: string;
+    task?: string;
+    /**
+     * Optional PR diff used to generate a deterministic test plan on the backend.
+     * If provided, `task` is treated as optional human instructions / focus areas.
+     */
+    diff?: string;
     /** Starting URL (e.g., https://3000-xyz.e2b.dev) */
     url?: string;
     /** Maximum number of browser actions to take (1-50, default: 10) */