npm - @browserbasehq/orca - Versions diffs - 3.0.9-alpha-4 → 3.1.0-headers - Mend

@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-headers

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1556) hide show

package/dist/cjs/lib/v3/flowLogger.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flowLogger.js","sourceRoot":"","sources":["../../../../lib/v3/flowLogger.ts"],"names":[],"mappings":"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","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport fs from \"node:fs\";\nimport { Writable } from \"node:stream\";\nimport { v7 as uuidv7 } from \"uuid\";\nimport path from \"node:path\";\nimport pino from \"pino\";\nimport type { LanguageModelMiddleware } from \"ai\";\nimport type { V3Options } from \"./types/public/index.js\";\n\n// =============================================================================\n// Constants\n// =============================================================================\n\nconst MAX_LINE_LENGTH = 160;\n\n// Flow logging config dir - empty string disables logging entirely\nconst CONFIG_DIR = process.env.BROWSERBASE_CONFIG_DIR || \"\";\n\nconst NOISY_CDP_EVENTS = new Set([\n \"Target.targetInfoChanged\",\n \"Runtime.executionContextCreated\",\n \"Runtime.executionContextDestroyed\",\n \"Runtime.executionContextsCleared\",\n \"Page.lifecycleEvent\",\n \"Network.dataReceived\",\n \"Network.loadingFinished\",\n \"Network.requestWillBeSentExtraInfo\",\n \"Network.responseReceivedExtraInfo\",\n \"Network.requestWillBeSent\",\n \"Network.responseReceived\",\n]);\n\n// =============================================================================\n// Types\n// =============================================================================\n\ntype EventCategory =\n | \"AgentTask\"\n | \"StagehandStep\"\n | \"UnderstudyAction\"\n | \"CDP\"\n | \"LLM\";\n\ninterface FlowEvent {\n // Core identifiers (set via mixin from child logger bindings)\n eventId: string;\n sessionId: string;\n taskId?: string | null;\n stepId?: string | null;\n stepLabel?: string | null;\n actionId?: string | null;\n actionLabel?: string | null;\n\n // Event classification\n category: EventCategory;\n event: \"started\" | \"completed\" | \"call\" | \"message\" | \"request\" | \"response\";\n method?: string;\n msg?: string;\n\n // Event-specific payload (not truncated)\n params?: unknown;\n targetId?: string | null;\n\n // LLM event fields (for individual LLM request/response events only)\n requestId?: string; // Correlation ID linking LLM request to response\n model?: string;\n prompt?: unknown;\n output?: unknown;\n inputTokens?: number; // Tokens for THIS specific LLM call\n outputTokens?: number; // Tokens for THIS specific LLM call\n\n // Aggregate metrics (for completion events only - task/step/action)\n metrics?: {\n durationMs?: number;\n llmRequests?: number; // Total LLM calls in this span\n inputTokens?: number; // Total input tokens across all LLM calls\n outputTokens?: number; // Total output tokens across all LLM calls\n cdpEvents?: number; // Total CDP events in this span\n };\n}\n\ninterface FlowLoggerMetrics {\n taskStartTime?: number;\n stepStartTime?: number;\n actionStartTime?: number;\n llmRequests: number;\n llmInputTokens: number;\n llmOutputTokens: number;\n cdpEvents: number;\n}\n\nexport interface FlowLoggerContext {\n logger: pino.Logger;\n metrics: FlowLoggerMetrics;\n sessionId: string;\n sessionDir: string;\n configDir: string;\n initPromise: Promise<void>;\n initialized: boolean;\n // Current span context (mutable, injected via mixin)\n taskId: string | null;\n stepId: string | null;\n stepLabel: string | null;\n actionId: string | null;\n actionLabel: string | null;\n // File handles for pretty streams\n fileStreams: {\n agent: fs.WriteStream | null;\n stagehand: fs.WriteStream | null;\n understudy: fs.WriteStream | null;\n cdp: fs.WriteStream | null;\n llm: fs.WriteStream | null;\n jsonl: fs.WriteStream | null;\n };\n}\n\nconst loggerContext = new AsyncLocalStorage<FlowLoggerContext>();\n\n// =============================================================================\n// Formatting Utilities (used by pretty streams)\n// =============================================================================\n\n/** Calculate base64 data size in KB */\nconst dataToKb = (data: string): string =>\n ((data.length * 0.75) / 1024).toFixed(1);\n\n/** Truncate CDP IDs: frameId:363F03EB...EF8 → frameId:363F…5EF8 */\nfunction truncateCdpIds(value: string): string {\n return value.replace(\n /([iI]d:?\"?)([0-9A-F]{32})(?=\"?[,})\\s]|$)/g,\n (_, pre: string, id: string) => `${pre}${id.slice(0, 4)}…${id.slice(-4)}`,\n );\n}\n\n/** Truncate line showing start...end */\nfunction truncateLine(value: string, maxLen: number): string {\n const collapsed = value.replace(/\\s+/g, \" \");\n if (collapsed.length <= maxLen) return collapsed;\n const endLen = Math.floor(maxLen * 0.3);\n const startLen = maxLen - endLen - 1;\n return `${collapsed.slice(0, startLen)}…${collapsed.slice(-endLen)}`;\n}\n\nfunction formatValue(value: unknown): string {\n if (typeof value === \"string\") return `'${value}'`;\n if (value == null || typeof value !== \"object\") return String(value);\n try {\n return JSON.stringify(value);\n } catch {\n return \"[unserializable]\";\n }\n}\n\nfunction formatArgs(args?: unknown | unknown[]): string {\n if (args === undefined) return \"\";\n return (Array.isArray(args) ? args : [args])\n .filter((e) => e !== undefined)\n .map(formatValue)\n .filter((e) => e.length > 0)\n .join(\", \");\n}\n\nconst shortId = (id: string | null | undefined): string =>\n id ? id.slice(-4) : \"-\";\n\nfunction formatTag(\n label: string | null | undefined,\n id: string | null | undefined,\n icon: string,\n): string {\n return id ? `[${icon} #${shortId(id)}${label ? \" \" + label : \"\"}]` : \"⤑\";\n}\n\nlet nonce = 0;\nfunction formatTimestamp(): string {\n const d = new Date();\n const pad = (n: number, w = 2) => String(n).padStart(w, \"0\");\n return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${pad(d.getMilliseconds(), 3)}${pad(nonce++ % 100)}`;\n}\n\nconst SENSITIVE_KEYS =\n /apikey|api_key|key|secret|token|password|passwd|pwd|credential|auth/i;\n\nfunction sanitizeOptions(options: V3Options): Record<string, unknown> {\n const sanitize = (obj: unknown): unknown => {\n if (typeof obj !== \"object\" || obj === null) return obj;\n if (Array.isArray(obj)) return obj.map(sanitize);\n const result: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(obj)) {\n result[key] = SENSITIVE_KEYS.test(key) ? \"******\" : sanitize(value);\n }\n return result;\n };\n return sanitize({ ...options }) as Record<string, unknown>;\n}\n\n/** Remove unescaped quotes for cleaner log output */\nfunction removeQuotes(str: string): string {\n return str\n .replace(/([^\\\\])[\"']/g, \"$1\")\n .replace(/^[\"']|[\"']$/g, \"\")\n .trim();\n}\n\n// =============================================================================\n// Pretty Formatting (converts FlowEvent to human-readable log line)\n// =============================================================================\n\nfunction prettifyEvent(event: FlowEvent): string | null {\n const parts: string[] = [];\n\n // Build context tags - always add parent span tags (formatTag returns ⤑ for null IDs)\n if (event.category === \"AgentTask\") {\n parts.push(formatTag(\"\", event.taskId, \"🅰\"));\n } else if (event.category === \"StagehandStep\") {\n parts.push(formatTag(\"\", event.taskId, \"🅰\"));\n parts.push(formatTag(event.stepLabel, event.stepId, \"🆂\"));\n } else if (event.category === \"UnderstudyAction\") {\n parts.push(formatTag(\"\", event.taskId, \"🅰\"));\n parts.push(formatTag(event.stepLabel, event.stepId, \"🆂\"));\n parts.push(formatTag(event.actionLabel, event.actionId, \"🆄\"));\n } else if (event.category === \"CDP\") {\n parts.push(formatTag(\"\", event.taskId, \"🅰\"));\n parts.push(formatTag(event.stepLabel, event.stepId, \"🆂\"));\n parts.push(formatTag(event.actionLabel, event.actionId, \"🆄\"));\n parts.push(formatTag(\"CDP\", event.targetId, \"🅲\"));\n } else if (event.category === \"LLM\") {\n parts.push(formatTag(\"\", event.taskId, \"🅰\"));\n parts.push(formatTag(event.stepLabel, event.stepId, \"🆂\"));\n parts.push(formatTag(\"LLM\", event.requestId, \"🧠\"));\n }\n\n // Build details based on event type\n let details = \"\";\n const argsStr = event.params ? formatArgs(event.params) : \"\";\n\n if (event.category === \"AgentTask\") {\n if (event.event === \"started\") {\n details = `▷ ${event.method}(${argsStr})`;\n } else if (event.event === \"completed\") {\n const m = event.metrics;\n const durationSec = m?.durationMs\n ? (m.durationMs / 1000).toFixed(1)\n : \"?\";\n const llmStats = `${m?.llmRequests ?? 0} LLM calls ꜛ${m?.inputTokens ?? 0} ꜜ${m?.outputTokens ?? 0} tokens`;\n const cdpStats = `${m?.cdpEvents ?? 0} CDP msgs`;\n details = `✓ Agent.execute() DONE in ${durationSec}s | ${llmStats} | ${cdpStats}`;\n }\n } else if (event.category === \"StagehandStep\") {\n if (event.event === \"started\") {\n details = `▷ ${event.method}(${argsStr})`;\n } else if (event.event === \"completed\") {\n const durationSec = event.metrics?.durationMs\n ? (event.metrics.durationMs / 1000).toFixed(2)\n : \"?\";\n details = `✓ ${event.stepLabel || \"STEP\"} completed in ${durationSec}s`;\n }\n } else if (event.category === \"UnderstudyAction\") {\n if (event.event === \"started\") {\n details = `▷ ${event.method}(${argsStr})`;\n } else if (event.event === \"completed\") {\n const durationSec = event.metrics?.durationMs\n ? (event.metrics.durationMs / 1000).toFixed(2)\n : \"?\";\n details = `✓ ${event.actionLabel || \"ACTION\"} completed in ${durationSec}s`;\n }\n } else if (event.category === \"CDP\") {\n const icon = event.event === \"call\" ? \"⏵\" : \"⏴\";\n details = `${icon} ${event.method}(${argsStr})`;\n } else if (event.category === \"LLM\") {\n if (event.event === \"request\") {\n const promptStr = event.prompt ? \" \" + String(event.prompt) : \"\";\n details = `${event.model} ⏴${promptStr}`;\n } else if (event.event === \"response\") {\n const hasTokens =\n event.inputTokens !== undefined || event.outputTokens !== undefined;\n const tokenStr = hasTokens\n ? ` ꜛ${event.inputTokens ?? 0} ꜜ${event.outputTokens ?? 0} |`\n : \"\";\n const outputStr = event.output ? \" \" + String(event.output) : \"\";\n details = `${event.model} ↳${tokenStr}${outputStr}`;\n }\n }\n\n if (!details) return null;\n\n // Assemble line and apply final truncation\n const fullLine = `${formatTimestamp()} ${parts.join(\" \")} ${details}`;\n const cleaned = removeQuotes(fullLine);\n const processed =\n event.category === \"CDP\" ? truncateCdpIds(cleaned) : cleaned;\n return truncateLine(processed, MAX_LINE_LENGTH);\n}\n\n/** Check if a CDP event should be filtered from pretty output */\nfunction shouldFilterCdpEvent(event: FlowEvent): boolean {\n if (event.category !== \"CDP\") return false;\n if (event.method?.endsWith(\".enable\") || event.method === \"enable\")\n return true;\n return event.event === \"message\" && NOISY_CDP_EVENTS.has(event.method!);\n}\n\n// =============================================================================\n// Stream Creation\n// =============================================================================\n\nconst isWritable = (s: fs.WriteStream | null): s is fs.WriteStream =>\n !!(s && !s.destroyed && s.writable);\n\nfunction createJsonlStream(ctx: FlowLoggerContext): Writable {\n return new Writable({\n objectMode: true,\n write(chunk: string, _, cb) {\n if (ctx.initialized && isWritable(ctx.fileStreams.jsonl)) {\n ctx.fileStreams.jsonl.write(chunk, cb);\n } else cb();\n },\n });\n}\n\nfunction createPrettyStream(\n ctx: FlowLoggerContext,\n category: EventCategory,\n streamKey: keyof FlowLoggerContext[\"fileStreams\"],\n): Writable {\n return new Writable({\n objectMode: true,\n write(chunk: string, _, cb) {\n const stream = ctx.fileStreams[streamKey];\n if (!ctx.initialized || !isWritable(stream)) return cb();\n try {\n const event = JSON.parse(chunk) as FlowEvent;\n if (event.category !== category || shouldFilterCdpEvent(event))\n return cb();\n const line = prettifyEvent(event);\n if (line) stream.write(line + \"\\n\", cb);\n else cb();\n } catch {\n cb();\n }\n },\n });\n}\n\n// =============================================================================\n// Public Helpers (used by external callers)\n// =============================================================================\n\n/**\n * Get the config directory. Returns empty string if logging is disabled.\n */\nexport function getConfigDir(): string {\n return CONFIG_DIR ? path.resolve(CONFIG_DIR) : \"\";\n}\n\n// =============================================================================\n// Prompt Preview Helpers\n// =============================================================================\n\ntype ContentPart = {\n type?: string;\n text?: string;\n content?: unknown[];\n source?: { data?: string };\n image_url?: { url?: string };\n inlineData?: { data?: string };\n};\n\n/** Extract text and image info from a content array (handles nested tool_result) */\nfunction extractFromContent(\n content: unknown[],\n result: { text?: string; extras: string[] },\n): void {\n for (const part of content) {\n const p = part as ContentPart;\n // Text\n if (!result.text && p.text) {\n result.text = p.type === \"text\" || !p.type ? p.text : undefined;\n }\n // Images - various formats\n if (p.type === \"image\" || p.type === \"image_url\") {\n const url = p.image_url?.url;\n if (url?.startsWith(\"data:\"))\n result.extras.push(`${dataToKb(url)}kb image`);\n else if (p.source?.data)\n result.extras.push(`${dataToKb(p.source.data)}kb image`);\n else result.extras.push(\"image\");\n } else if (p.source?.data) {\n result.extras.push(`${dataToKb(p.source.data)}kb image`);\n } else if (p.inlineData?.data) {\n result.extras.push(`${dataToKb(p.inlineData.data)}kb image`);\n }\n // Recurse into tool_result content\n if (p.type === \"tool_result\" && Array.isArray(p.content)) {\n extractFromContent(p.content, result);\n }\n }\n}\n\n/** Build final preview string with extras */\nfunction buildPreview(\n text: string | undefined,\n extras: string[],\n maxLen?: number,\n): string | undefined {\n if (!text && extras.length === 0) return undefined;\n let result = text || \"\";\n if (maxLen && result.length > maxLen)\n result = result.slice(0, maxLen) + \"...\";\n if (extras.length > 0) {\n const extrasStr = extras.map((e) => `+{${e}}`).join(\" \");\n result = result ? `${result} ${extrasStr}` : extrasStr;\n }\n return result || undefined;\n}\n\n/**\n * Format a prompt preview from LLM messages for logging.\n * Returns format like: \"some text... +{5.8kb image} +{schema} +{12 tools}\"\n */\nexport function formatLlmPromptPreview(\n messages: Array<{ role: string; content: unknown }>,\n options?: { toolCount?: number; hasSchema?: boolean },\n): string | undefined {\n try {\n const lastUserMsg = messages.filter((m) => m.role === \"user\").pop();\n if (!lastUserMsg) return undefined;\n\n const result = {\n text: undefined as string | undefined,\n extras: [] as string[],\n };\n\n if (typeof lastUserMsg.content === \"string\") {\n result.text = lastUserMsg.content;\n } else if (Array.isArray(lastUserMsg.content)) {\n extractFromContent(lastUserMsg.content, result);\n } else {\n return undefined;\n }\n\n // Clean instruction prefix\n if (result.text) {\n result.text = result.text.replace(/^[Ii]nstruction: /, \"\");\n }\n\n if (options?.hasSchema) result.extras.push(\"schema\");\n if (options?.toolCount) result.extras.push(`${options.toolCount} tools`);\n\n return buildPreview(result.text, result.extras);\n } catch {\n return undefined;\n }\n}\n\n/**\n * Extract a text preview from CUA-style messages.\n * Accepts various message formats (Anthropic, OpenAI, Google).\n */\nexport function formatCuaPromptPreview(\n messages: unknown[],\n maxLen = 100,\n): string | undefined {\n try {\n const lastMsg = messages\n .filter((m) => {\n const msg = m as { role?: string; type?: string };\n return msg.role === \"user\" || msg.type === \"tool_result\";\n })\n .pop() as\n | { content?: unknown; parts?: unknown[]; text?: string }\n | undefined;\n\n if (!lastMsg) return undefined;\n\n const result = {\n text: undefined as string | undefined,\n extras: [] as string[],\n };\n\n if (typeof lastMsg.content === \"string\") {\n result.text = lastMsg.content;\n } else if (typeof lastMsg.text === \"string\") {\n result.text = lastMsg.text;\n } else if (Array.isArray(lastMsg.parts)) {\n extractFromContent(lastMsg.parts, result);\n } else if (Array.isArray(lastMsg.content)) {\n extractFromContent(lastMsg.content, result);\n }\n\n return buildPreview(result.text, result.extras, maxLen);\n } catch {\n return undefined;\n }\n}\n\n/** Format CUA response output for logging */\nexport function formatCuaResponsePreview(\n output: unknown,\n maxLen = 100,\n): string {\n try {\n // Handle Google format or array\n const items: unknown[] =\n (output as { candidates?: [{ content?: { parts?: unknown[] } }] })\n ?.candidates?.[0]?.content?.parts ??\n (Array.isArray(output) ? output : []);\n\n const preview = items\n .map((item) => {\n const i = item as {\n type?: string;\n text?: string;\n name?: string;\n functionCall?: { name?: string };\n };\n if (i.text) return i.text.slice(0, 50);\n if (i.functionCall?.name) return `fn:${i.functionCall.name}`;\n if (i.type === \"tool_use\" && i.name) return `tool_use:${i.name}`;\n return i.type ? `[${i.type}]` : \"[item]\";\n })\n .join(\" \");\n\n return preview.slice(0, maxLen);\n } catch {\n return \"[error]\";\n }\n}\n\n// =============================================================================\n// SessionFileLogger - Main API\n// =============================================================================\n\nexport class SessionFileLogger {\n /**\n * Initialize a new logging context. Call this at the start of a session.\n * If BROWSERBASE_CONFIG_DIR is not set, logging is disabled.\n */\n static init(sessionId: string, v3Options?: V3Options): void {\n const configDir = getConfigDir();\n if (!configDir) return; // Logging disabled\n\n const sessionDir = path.join(configDir, \"sessions\", sessionId);\n\n // Create context with placeholder logger (will be replaced after streams init)\n const ctx: FlowLoggerContext = {\n logger: pino({ level: \"silent\" }), // Placeholder, replaced below\n metrics: {\n llmRequests: 0,\n llmInputTokens: 0,\n llmOutputTokens: 0,\n cdpEvents: 0,\n },\n sessionId,\n sessionDir,\n configDir,\n initPromise: Promise.resolve(),\n initialized: false,\n // Span context - mutable, injected into every log via mixin\n taskId: null,\n stepId: null,\n stepLabel: null,\n actionId: null,\n actionLabel: null,\n fileStreams: {\n agent: null,\n stagehand: null,\n understudy: null,\n cdp: null,\n llm: null,\n jsonl: null,\n },\n };\n\n // Store init promise for awaiting in log methods\n ctx.initPromise = SessionFileLogger.initAsync(ctx, v3Options);\n\n loggerContext.enterWith(ctx);\n }\n\n private static async initAsync(\n ctx: FlowLoggerContext,\n v3Options?: V3Options,\n ): Promise<void> {\n try {\n await fs.promises.mkdir(ctx.sessionDir, { recursive: true });\n\n if (v3Options) {\n const sanitizedOptions = sanitizeOptions(v3Options);\n const sessionJsonPath = path.join(ctx.sessionDir, \"session.json\");\n await fs.promises.writeFile(\n sessionJsonPath,\n JSON.stringify(sanitizedOptions, null, 2),\n \"utf-8\",\n );\n }\n\n // Create symlink to latest session\n const latestLink = path.join(ctx.configDir, \"sessions\", \"latest\");\n try {\n try {\n await fs.promises.unlink(latestLink);\n } catch {\n // Ignore if doesn't exist\n }\n await fs.promises.symlink(ctx.sessionId, latestLink, \"dir\");\n } catch {\n // Symlink creation can fail on Windows or due to permissions\n }\n\n // Create file streams\n const dir = ctx.sessionDir;\n ctx.fileStreams.agent = fs.createWriteStream(\n path.join(dir, \"agent_events.log\"),\n { flags: \"a\" },\n );\n ctx.fileStreams.stagehand = fs.createWriteStream(\n path.join(dir, \"stagehand_events.log\"),\n { flags: \"a\" },\n );\n ctx.fileStreams.understudy = fs.createWriteStream(\n path.join(dir, \"understudy_events.log\"),\n { flags: \"a\" },\n );\n ctx.fileStreams.cdp = fs.createWriteStream(\n path.join(dir, \"cdp_events.log\"),\n { flags: \"a\" },\n );\n ctx.fileStreams.llm = fs.createWriteStream(\n path.join(dir, \"llm_events.log\"),\n { flags: \"a\" },\n );\n ctx.fileStreams.jsonl = fs.createWriteStream(\n path.join(dir, \"session_events.jsonl\"),\n { flags: \"a\" },\n );\n\n ctx.initialized = true;\n\n // Create pino multistream: JSONL + pretty streams per category\n const streams: pino.StreamEntry[] = [\n { stream: createJsonlStream(ctx) },\n { stream: createPrettyStream(ctx, \"AgentTask\", \"agent\") },\n { stream: createPrettyStream(ctx, \"StagehandStep\", \"stagehand\") },\n { stream: createPrettyStream(ctx, \"UnderstudyAction\", \"understudy\") },\n { stream: createPrettyStream(ctx, \"CDP\", \"cdp\") },\n { stream: createPrettyStream(ctx, \"LLM\", \"llm\") },\n ];\n\n // Create logger with mixin that injects span context from AsyncLocalStorage\n ctx.logger = pino(\n {\n level: \"info\",\n // Mixin adds eventId and current span context to every log\n mixin() {\n const store = loggerContext.getStore();\n return {\n eventId: uuidv7(),\n sessionId: store?.sessionId,\n taskId: store?.taskId,\n stepId: store?.stepId,\n stepLabel: store?.stepLabel,\n actionId: store?.actionId,\n actionLabel: store?.actionLabel,\n };\n },\n },\n pino.multistream(streams),\n );\n } catch {\n // Fail silently\n }\n }\n\n static async close(): Promise<void> {\n const ctx = loggerContext.getStore();\n if (!ctx) return;\n await ctx.initPromise;\n SessionFileLogger.logAgentTaskCompleted();\n await Promise.all(\n Object.values(ctx.fileStreams)\n .filter(Boolean)\n .map((s) => new Promise<void>((r) => s!.end(r))),\n ).catch(() => {});\n }\n\n static get sessionId(): string | null {\n return loggerContext.getStore()?.sessionId ?? null;\n }\n\n static get sessionDir(): string | null {\n return loggerContext.getStore()?.sessionDir ?? null;\n }\n\n /**\n * Get the current logger context object.\n */\n static getContext(): FlowLoggerContext | null {\n return loggerContext.getStore() ?? null;\n }\n\n // ===========================================================================\n // Agent Task Events\n // ===========================================================================\n\n /**\n * Start a new task and log it.\n */\n static logAgentTaskStarted({\n invocation,\n args,\n }: {\n invocation: string;\n args?: unknown | unknown[];\n }): void {\n const ctx = loggerContext.getStore();\n if (!ctx) return;\n\n // Set up task context\n ctx.taskId = uuidv7();\n ctx.stepId = null;\n ctx.stepLabel = null;\n ctx.actionId = null;\n ctx.actionLabel = null;\n\n // Reset metrics for new task\n ctx.metrics = {\n taskStartTime: Date.now(),\n llmRequests: 0,\n llmInputTokens: 0,\n llmOutputTokens: 0,\n cdpEvents: 0,\n };\n\n ctx.logger.info({\n category: \"AgentTask\",\n event: \"started\",\n method: invocation,\n params: args,\n } as FlowEvent);\n }\n\n /**\n * Log task completion with metrics summary.\n */\n static logAgentTaskCompleted(options?: { cacheHit?: boolean }): void {\n const ctx = loggerContext.getStore();\n if (!ctx || !ctx.metrics.taskStartTime) return;\n\n const durationMs = Date.now() - ctx.metrics.taskStartTime;\n\n const event: Partial<FlowEvent> = {\n category: \"AgentTask\",\n event: \"completed\",\n method: \"Agent.execute\",\n metrics: {\n durationMs,\n llmRequests: ctx.metrics.llmRequests,\n inputTokens: ctx.metrics.llmInputTokens,\n outputTokens: ctx.metrics.llmOutputTokens,\n cdpEvents: ctx.metrics.cdpEvents,\n },\n };\n\n if (options?.cacheHit) {\n event.msg = \"CACHE HIT, NO LLM NEEDED\";\n }\n\n ctx.logger.info(event);\n\n // Clear task context\n ctx.taskId = null;\n ctx.stepId = null;\n ctx.stepLabel = null;\n ctx.actionId = null;\n ctx.actionLabel = null;\n ctx.metrics.taskStartTime = undefined;\n }\n\n // ===========================================================================\n // Stagehand Step Events\n // ===========================================================================\n\n static logStagehandStepEvent({\n invocation,\n args,\n label,\n }: {\n invocation: string;\n args?: unknown | unknown[];\n label: string;\n }): string {\n const ctx = loggerContext.getStore();\n if (!ctx) return uuidv7();\n\n // Set up step context\n ctx.stepId = uuidv7();\n ctx.stepLabel = label.toUpperCase();\n ctx.actionId = null;\n ctx.actionLabel = null;\n ctx.metrics.stepStartTime = Date.now();\n\n ctx.logger.info({\n category: \"StagehandStep\",\n event: \"started\",\n method: invocation,\n params: args,\n } as FlowEvent);\n\n return ctx.stepId;\n }\n\n static logStagehandStepCompleted(): void {\n const ctx = loggerContext.getStore();\n if (!ctx || !ctx.stepId) return;\n\n const durationMs = ctx.metrics.stepStartTime\n ? Date.now() - ctx.metrics.stepStartTime\n : 0;\n\n ctx.logger.info({\n category: \"StagehandStep\",\n event: \"completed\",\n metrics: { durationMs },\n } as FlowEvent);\n\n // Clear step context\n ctx.stepId = null;\n ctx.stepLabel = null;\n ctx.actionId = null;\n ctx.actionLabel = null;\n ctx.metrics.stepStartTime = undefined;\n }\n\n // ===========================================================================\n // Understudy Action Events\n // ===========================================================================\n\n static logUnderstudyActionEvent({\n actionType,\n target,\n args,\n }: {\n actionType: string;\n target?: string;\n args?: unknown | unknown[];\n }): string {\n const ctx = loggerContext.getStore();\n if (!ctx) return uuidv7();\n\n // Set up action context\n ctx.actionId = uuidv7();\n ctx.actionLabel = actionType\n .toUpperCase()\n .replace(\"UNDERSTUDY.\", \"\")\n .replace(\"PAGE.\", \"\");\n ctx.metrics.actionStartTime = Date.now();\n\n const params: Record<string, unknown> = {};\n if (target) params.target = target;\n if (args) params.args = args;\n\n ctx.logger.info({\n category: \"UnderstudyAction\",\n event: \"started\",\n method: actionType,\n params: Object.keys(params).length > 0 ? params : undefined,\n } as FlowEvent);\n\n return ctx.actionId;\n }\n\n static logUnderstudyActionCompleted(): void {\n const ctx = loggerContext.getStore();\n if (!ctx || !ctx.actionId) return;\n\n const durationMs = ctx.metrics.actionStartTime\n ? Date.now() - ctx.metrics.actionStartTime\n : 0;\n\n ctx.logger.info({\n category: \"UnderstudyAction\",\n event: \"completed\",\n metrics: { durationMs },\n } as FlowEvent);\n\n // Clear action context\n ctx.actionId = null;\n ctx.actionLabel = null;\n ctx.metrics.actionStartTime = undefined;\n }\n\n // ===========================================================================\n // CDP Events\n // ===========================================================================\n\n private static logCdpEvent(\n eventType: \"call\" | \"message\",\n {\n method,\n params,\n targetId,\n }: { method: string; params?: unknown; targetId?: string | null },\n explicitCtx?: FlowLoggerContext | null,\n ): void {\n const ctx = explicitCtx ?? loggerContext.getStore();\n if (!ctx) return;\n if (eventType === \"call\") ctx.metrics.cdpEvents++;\n ctx.logger.info({\n category: \"CDP\",\n event: eventType,\n method,\n params,\n targetId,\n } as FlowEvent);\n }\n\n static logCdpCallEvent(\n data: { method: string; params?: object; targetId?: string | null },\n ctx?: FlowLoggerContext | null,\n ): void {\n SessionFileLogger.logCdpEvent(\"call\", data, ctx);\n }\n\n static logCdpMessageEvent(\n data: { method: string; params?: unknown; targetId?: string | null },\n ctx?: FlowLoggerContext | null,\n ): void {\n SessionFileLogger.logCdpEvent(\"message\", data, ctx);\n }\n\n // ===========================================================================\n // LLM Events\n // ===========================================================================\n\n static logLlmRequest(\n {\n requestId,\n model,\n prompt,\n }: {\n requestId: string;\n model: string;\n operation: string;\n prompt?: string;\n },\n explicitCtx?: FlowLoggerContext | null,\n ): void {\n const ctx = explicitCtx ?? loggerContext.getStore();\n if (!ctx) return;\n\n // Track LLM requests for task metrics\n ctx.metrics.llmRequests++;\n\n ctx.logger.info({\n category: \"LLM\",\n event: \"request\",\n requestId,\n method: \"LLM.request\",\n model,\n prompt,\n });\n }\n\n static logLlmResponse(\n {\n requestId,\n model,\n output,\n inputTokens,\n outputTokens,\n }: {\n requestId: string;\n model: string;\n operation: string;\n output?: string;\n inputTokens?: number;\n outputTokens?: number;\n },\n explicitCtx?: FlowLoggerContext | null,\n ): void {\n const ctx = explicitCtx ?? loggerContext.getStore();\n if (!ctx) return;\n\n // Track tokens for task metrics\n ctx.metrics.llmInputTokens += inputTokens ?? 0;\n ctx.metrics.llmOutputTokens += outputTokens ?? 0;\n\n ctx.logger.info({\n category: \"LLM\",\n event: \"response\",\n requestId,\n method: \"LLM.response\",\n model,\n output,\n inputTokens,\n outputTokens,\n });\n }\n\n // ===========================================================================\n // LLM Logging Middleware\n // ===========================================================================\n\n /**\n * Create middleware for wrapping language models with LLM call logging.\n * Returns a no-op middleware when logging is disabled.\n */\n static createLlmLoggingMiddleware(\n modelId: string,\n ): Pick<LanguageModelMiddleware, \"wrapGenerate\"> {\n // No-op middleware when logging is disabled\n if (!CONFIG_DIR) {\n return {\n wrapGenerate: async ({ doGenerate }) => doGenerate(),\n };\n }\n\n return {\n wrapGenerate: async ({ doGenerate, params }) => {\n const ctx = SessionFileLogger.getContext();\n // Skip logging overhead if no context (shouldn't happen but be safe)\n if (!ctx) {\n return doGenerate();\n }\n const llmRequestId = uuidv7();\n const toolCount = Array.isArray(params.tools) ? params.tools.length : 0;\n\n // Extract prompt preview from last non-system message\n const messages = (params.prompt ?? []) as Array<{\n role?: string;\n content?: unknown;\n }>;\n const lastMsg = messages.filter((m) => m.role !== \"system\").pop();\n const extracted = {\n text: undefined as string | undefined,\n extras: [] as string[],\n };\n\n let rolePrefix = lastMsg?.role ?? \"?\";\n if (lastMsg) {\n if (typeof lastMsg.content === \"string\") {\n extracted.text = lastMsg.content;\n } else if (Array.isArray(lastMsg.content)) {\n // Check for tool-result first\n const toolResult = (\n lastMsg.content as Array<{\n type?: string;\n toolName?: string;\n output?: { type?: string; value?: unknown };\n }>\n ).find((p) => p.type === \"tool-result\");\n if (toolResult) {\n rolePrefix = `tool result: ${toolResult.toolName}()`;\n const out = toolResult.output;\n if (out?.type === \"json\" && out.value) {\n extracted.text = JSON.stringify(out.value).slice(0, 150);\n } else if (Array.isArray(out?.value)) {\n extractFromContent(out.value as unknown[], extracted);\n }\n } else {\n extractFromContent(lastMsg.content as unknown[], extracted);\n }\n }\n }\n\n const promptText = extracted.text || \"(no text)\";\n const promptPreview = `${rolePrefix}: ${promptText} +{${toolCount} tools}`;\n\n SessionFileLogger.logLlmRequest(\n {\n requestId: llmRequestId,\n model: modelId,\n operation: \"generateText\",\n prompt: promptPreview,\n },\n ctx,\n );\n\n const result = await doGenerate();\n\n // Extract output preview\n const res = result as {\n text?: string;\n content?: unknown;\n toolCalls?: unknown[];\n };\n let outputPreview = res.text || \"\";\n if (!outputPreview && res.content) {\n if (typeof res.content === \"string\") {\n outputPreview = res.content;\n } else if (Array.isArray(res.content)) {\n outputPreview = (\n res.content as Array<{\n type?: string;\n text?: string;\n toolName?: string;\n }>\n )\n .map(\n (c) =>\n c.text ||\n (c.type === \"tool-call\"\n ? `tool call: ${c.toolName}()`\n : `[${c.type}]`),\n )\n .join(\" \");\n }\n }\n if (!outputPreview && res.toolCalls?.length) {\n outputPreview = `[${res.toolCalls.length} tool calls]`;\n }\n\n SessionFileLogger.logLlmResponse(\n {\n requestId: llmRequestId,\n model: modelId,\n operation: \"generateText\",\n output: outputPreview || \"[empty]\",\n inputTokens: result.usage?.inputTokens,\n outputTokens: result.usage?.outputTokens,\n },\n ctx,\n );\n\n return result;\n },\n };\n }\n}\n\n/**\n * Method decorator for logging understudy actions with automatic start/complete.\n * Logs all arguments automatically. No-op when CONFIG_DIR is empty.\n */\nexport function logAction(actionType: string) {\n return function <T extends (...args: never[]) => Promise<unknown>>(\n originalMethod: T,\n ): T {\n // No-op when logging is disabled\n if (!CONFIG_DIR) {\n return originalMethod;\n }\n\n return async function (this: unknown, ...args: unknown[]) {\n SessionFileLogger.logUnderstudyActionEvent({\n actionType,\n args: args.length > 0 ? args : undefined,\n });\n\n try {\n return await originalMethod.apply(this, args as never[]);\n } finally {\n SessionFileLogger.logUnderstudyActionCompleted();\n }\n } as T;\n };\n}\n\n/**\n * Method decorator for logging Stagehand step events (act, extract, observe).\n * Only adds logging - does NOT wrap with withInstanceLogContext (caller handles that).\n * No-op when CONFIG_DIR is empty.\n */\nexport function logStagehandStep(invocation: string, label: string) {\n return function <T extends (...args: never[]) => Promise<unknown>>(\n originalMethod: T,\n ): T {\n // No-op when logging is disabled\n if (!CONFIG_DIR) {\n return originalMethod;\n }\n\n return async function (\n this: unknown,\n ...args: unknown[]\n ): Promise<unknown> {\n SessionFileLogger.logStagehandStepEvent({\n invocation,\n args: args.length > 0 ? args : undefined,\n label,\n });\n\n try {\n return await originalMethod.apply(this, args as never[]);\n } finally {\n SessionFileLogger.logStagehandStepCompleted();\n }\n } as T;\n };\n}\n"]}

package/dist/cjs/lib/v3/handlers/actHandler.d.ts ADDED Viewed

@@ -0,0 +1,22 @@
+import { ActHandlerParams } from "../types/private/handlers.js";
+import { ActResult, Action, V3FunctionName } from "../types/public/methods.js";
+import { LLMClient } from "../llm/LLMClient.js";
+import { AvailableModel, ClientOptions, ModelConfiguration } from "../types/public/model.js";
+import type { Variables } from "../types/public/agent.js";
+import type { Page } from "../understudy/page.js";
+export declare class ActHandler {
+    private readonly llmClient;
+    private readonly defaultModelName;
+    private readonly defaultClientOptions;
+    private readonly resolveLlmClient;
+    private readonly systemPrompt;
+    private readonly logInferenceToFile;
+    private readonly selfHeal;
+    private readonly onMetrics?;
+    private readonly defaultDomSettleTimeoutMs?;
+    constructor(llmClient: LLMClient, defaultModelName: AvailableModel, defaultClientOptions: ClientOptions, resolveLlmClient: (model?: ModelConfiguration) => LLMClient, systemPrompt?: string, logInferenceToFile?: boolean, selfHeal?: boolean, onMetrics?: (functionName: V3FunctionName, promptTokens: number, completionTokens: number, reasoningTokens: number, cachedInputTokens: number, inferenceTimeMs: number) => void, defaultDomSettleTimeoutMs?: number);
+    private recordActMetrics;
+    private getActionFromLLM;
+    act(params: ActHandlerParams): Promise<ActResult>;
+    takeDeterministicAction(action: Action, page: Page, domSettleTimeoutMs?: number, llmClientOverride?: LLMClient, ensureTimeRemaining?: () => void, variables?: Variables): Promise<ActResult>;
+}

package/dist/cjs/lib/v3/handlers/actHandler.js ADDED Viewed

@@ -0,0 +1,344 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActHandler = void 0;
+// lib/v3/handlers/actHandler.ts
+const inference_js_1 = require("../../inference.js");
+const prompt_js_1 = require("../../prompt.js");
+const utils_js_1 = require("../../utils.js");
+const logger_js_1 = require("../logger.js");
+const methods_js_1 = require("../types/public/methods.js");
+const sdkErrors_js_1 = require("../types/public/sdkErrors.js");
+const index_js_1 = require("../understudy/a11y/snapshot/index.js");
+const index_js_2 = require("../types/private/index.js");
+const actHandlerUtils_js_1 = require("./handlerUtils/actHandlerUtils.js");
+const timeoutGuard_js_1 = require("./handlerUtils/timeoutGuard.js");
+const variables_js_1 = require("../agent/utils/variables.js");
+class ActHandler {
+    llmClient;
+    defaultModelName;
+    defaultClientOptions;
+    resolveLlmClient;
+    systemPrompt;
+    logInferenceToFile;
+    selfHeal;
+    onMetrics;
+    defaultDomSettleTimeoutMs;
+    constructor(llmClient, defaultModelName, defaultClientOptions, resolveLlmClient, systemPrompt, logInferenceToFile, selfHeal, onMetrics, defaultDomSettleTimeoutMs) {
+        this.llmClient = llmClient;
+        this.defaultModelName = defaultModelName;
+        this.defaultClientOptions = defaultClientOptions;
+        this.resolveLlmClient = resolveLlmClient;
+        this.systemPrompt = systemPrompt ?? "";
+        this.logInferenceToFile = logInferenceToFile ?? false;
+        this.selfHeal = !!selfHeal;
+        this.onMetrics = onMetrics;
+        this.defaultDomSettleTimeoutMs = defaultDomSettleTimeoutMs;
+    }
+    recordActMetrics(response) {
+        this.onMetrics?.(methods_js_1.V3FunctionName.ACT, response.prompt_tokens ?? 0, response.completion_tokens ?? 0, response.reasoning_tokens ?? 0, response.cached_input_tokens ?? 0, response.inference_time_ms ?? 0);
+    }
+    async getActionFromLLM({ instruction, domElements, xpathMap, llmClient, requireMethodAndArguments = true, }) {
+        const response = await (0, inference_js_1.act)({
+            instruction,
+            domElements,
+            llmClient,
+            userProvidedInstructions: this.systemPrompt,
+            logger: logger_js_1.v3Logger,
+            logInferenceToFile: this.logInferenceToFile,
+        });
+        this.recordActMetrics(response);
+        const normalized = normalizeActInferenceElement(response.element, xpathMap, requireMethodAndArguments);
+        if (!normalized) {
+            return { response };
+        }
+        return {
+            action: { ...normalized },
+            response,
+        };
+    }
+    async act(params) {
+        const { instruction, page, variables, timeout, model } = params;
+        const llmClient = this.resolveLlmClient(model);
+        const ensureTimeRemaining = (0, timeoutGuard_js_1.createTimeoutGuard)(timeout, (ms) => new sdkErrors_js_1.ActTimeoutError(ms));
+        ensureTimeRemaining();
+        await (0, actHandlerUtils_js_1.waitForDomNetworkQuiet)(page.mainFrame(), this.defaultDomSettleTimeoutMs);
+        ensureTimeRemaining();
+        const { combinedTree, combinedXpathMap } = await (0, index_js_1.captureHybridSnapshot)(page, { experimental: true });
+        const actInstruction = (0, prompt_js_1.buildActPrompt)(instruction, Object.values(index_js_2.SupportedUnderstudyAction), variables);
+        ensureTimeRemaining();
+        const { action: firstAction, response: actInferenceResponse } = await this.getActionFromLLM({
+            instruction: actInstruction,
+            domElements: combinedTree,
+            xpathMap: combinedXpathMap,
+            llmClient,
+        });
+        if (!firstAction) {
+            (0, logger_js_1.v3Logger)({
+                category: "action",
+                message: "no actionable element returned by LLM",
+                level: 1,
+            });
+            return {
+                success: false,
+                message: "Failed to perform act: No action found",
+                actionDescription: instruction,
+                actions: [],
+            };
+        }
+        // First action (self-heal aware path)
+        ensureTimeRemaining();
+        const firstResult = await this.takeDeterministicAction(firstAction, page, this.defaultDomSettleTimeoutMs, llmClient, ensureTimeRemaining, variables);
+        // If not two-step, return the first action result
+        if (actInferenceResponse?.twoStep !== true) {
+            return firstResult;
+        }
+        // Take a new focused snapshot and observe again
+        ensureTimeRemaining();
+        const { combinedTree: combinedTree2, combinedXpathMap: combinedXpathMap2 } = await (0, index_js_1.captureHybridSnapshot)(page, {
+            experimental: true,
+        });
+        let diffedTree = (0, index_js_1.diffCombinedTrees)(combinedTree, combinedTree2);
+        if (!diffedTree.trim()) {
+            // Fallback: if no diff detected, use the fresh tree to avoid empty context
+            diffedTree = combinedTree2;
+        }
+        const previousAction = `method: ${firstAction.method}, description: ${firstAction.description}, arguments: ${firstAction.arguments}`;
+        const stepTwoInstructions = (0, prompt_js_1.buildStepTwoPrompt)(instruction, previousAction, Object.values(index_js_2.SupportedUnderstudyAction).filter((action) => action !== index_js_2.SupportedUnderstudyAction.SELECT_OPTION_FROM_DROPDOWN), variables);
+        ensureTimeRemaining();
+        const { action: secondAction } = await this.getActionFromLLM({
+            instruction: stepTwoInstructions,
+            domElements: diffedTree,
+            xpathMap: combinedXpathMap2,
+            llmClient,
+        });
+        if (!secondAction) {
+            // No second action found — return first result as-is
+            return firstResult;
+        }
+        ensureTimeRemaining();
+        const secondResult = await this.takeDeterministicAction(secondAction, page, this.defaultDomSettleTimeoutMs, llmClient, ensureTimeRemaining, variables);
+        // Combine results
+        return {
+            success: firstResult.success && secondResult.success,
+            message: secondResult.success
+                ? `${firstResult.message} → ${secondResult.message}`
+                : `${firstResult.message} → ${secondResult.message}`,
+            actionDescription: firstResult.actionDescription,
+            actions: [
+                ...(firstResult.actions || []),
+                ...(secondResult.actions || []),
+            ],
+        };
+    }
+    async takeDeterministicAction(action, page, domSettleTimeoutMs, llmClientOverride, ensureTimeRemaining, variables) {
+        ensureTimeRemaining?.();
+        const settleTimeout = domSettleTimeoutMs ?? this.defaultDomSettleTimeoutMs;
+        const effectiveClient = llmClientOverride ?? this.llmClient;
+        const method = action.method?.trim();
+        if (!method || method === "not-supported") {
+            (0, logger_js_1.v3Logger)({
+                category: "action",
+                message: "action has no supported method",
+                level: 0,
+                auxiliary: {
+                    act: { value: JSON.stringify(action), type: "object" },
+                },
+            });
+            return {
+                success: false,
+                message: `Unable to perform action: The method '${method ?? ""}' is not supported in Action. Please use a supported Playwright locator method.`,
+                actionDescription: action.description || `Action (${method ?? "unknown"})`,
+                actions: [],
+            };
+        }
+        const placeholderArgs = Array.isArray(action.arguments)
+            ? [...action.arguments]
+            : [];
+        const resolvedArgs = substituteVariablesInArguments(action.arguments, variables) ?? [];
+        try {
+            ensureTimeRemaining?.();
+            await (0, actHandlerUtils_js_1.performUnderstudyMethod)(page, page.mainFrame(), method, action.selector, resolvedArgs, settleTimeout);
+            return {
+                success: true,
+                message: `Action [${method}] performed successfully on selector: ${action.selector}`,
+                actionDescription: action.description || `action (${method})`,
+                actions: [
+                    {
+                        selector: action.selector,
+                        description: action.description || `action (${method})`,
+                        method,
+                        arguments: placeholderArgs,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (err instanceof sdkErrors_js_1.ActTimeoutError) {
+                throw err;
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            // Attempt self-heal: rerun actInference and retry with updated selector
+            if (this.selfHeal) {
+                (0, logger_js_1.v3Logger)({
+                    category: "action",
+                    message: "Error performing action. Reprocessing the page and trying again",
+                    level: 1,
+                    auxiliary: {
+                        error: { value: msg, type: "string" },
+                        action: {
+                            value: JSON.stringify(action),
+                            type: "object",
+                        },
+                    },
+                });
+                try {
+                    // Build an instruction combining method + description, avoiding duplication
+                    const actCommand = action.description
+                        ? action.description.toLowerCase().startsWith(method.toLowerCase())
+                            ? action.description
+                            : `${method} ${action.description}`
+                        : method;
+                    // Take a fresh snapshot and ask for a new actionable element
+                    ensureTimeRemaining?.();
+                    const { combinedTree, combinedXpathMap } = await (0, index_js_1.captureHybridSnapshot)(page, {
+                        experimental: true,
+                    });
+                    const instruction = (0, prompt_js_1.buildActPrompt)(actCommand, Object.values(index_js_2.SupportedUnderstudyAction), {});
+                    ensureTimeRemaining?.();
+                    const { action: fallbackAction, response: fallbackResponse } = await this.getActionFromLLM({
+                        instruction,
+                        domElements: combinedTree,
+                        xpathMap: combinedXpathMap,
+                        llmClient: effectiveClient,
+                        requireMethodAndArguments: false,
+                    });
+                    const fallbackElement = fallbackResponse.element;
+                    if (!fallbackElement) {
+                        return {
+                            success: false,
+                            message: "Failed to self-heal act: No observe results found for action",
+                            actionDescription: actCommand,
+                            actions: [],
+                        };
+                    }
+                    // Retry with original method/args but new selector from fallback
+                    let newSelector = action.selector;
+                    if (fallbackAction?.selector) {
+                        newSelector = fallbackAction.selector;
+                    }
+                    ensureTimeRemaining?.();
+                    await (0, actHandlerUtils_js_1.performUnderstudyMethod)(page, page.mainFrame(), method, newSelector, resolvedArgs, settleTimeout);
+                    return {
+                        success: true,
+                        message: `Action [${method}] performed successfully on selector: ${newSelector}`,
+                        actionDescription: action.description || `action (${method})`,
+                        actions: [
+                            {
+                                selector: newSelector,
+                                description: action.description || `action (${method})`,
+                                method,
+                                arguments: placeholderArgs,
+                            },
+                        ],
+                    };
+                }
+                catch (retryErr) {
+                    if (retryErr instanceof sdkErrors_js_1.ActTimeoutError) {
+                        throw retryErr;
+                    }
+                    const retryMsg = retryErr instanceof Error ? retryErr.message : String(retryErr);
+                    return {
+                        success: false,
+                        message: `Failed to perform act after self-heal: ${retryMsg}`,
+                        actionDescription: action.description || `action (${method})`,
+                        actions: [],
+                    };
+                }
+            }
+            return {
+                success: false,
+                message: `Failed to perform act: ${msg}`,
+                actionDescription: action.description || `action (${method})`,
+                actions: [],
+            };
+        }
+    }
+}
+exports.ActHandler = ActHandler;
+function normalizeActInferenceElement(element, xpathMap, requireMethodAndArguments = true) {
+    if (!element) {
+        return undefined;
+    }
+    const { elementId, description, method, arguments: args } = element;
+    const hasArgs = Array.isArray(args);
+    if (requireMethodAndArguments &&
+        (!method || method === "not-supported" || !hasArgs)) {
+        return undefined;
+    }
+    if (typeof elementId !== "string" || !elementId.includes("-")) {
+        return undefined;
+    }
+    const xp = xpathMap[elementId];
+    const trimmed = (0, utils_js_1.trimTrailingTextNode)(xp);
+    if (!trimmed) {
+        return undefined;
+    }
+    // For dragAndDrop, convert element ID in arguments to xpath (target element)
+    let resolvedArgs = hasArgs ? args : undefined;
+    if (method === "dragAndDrop" && hasArgs && args.length > 0) {
+        const targetArg = args[0];
+        // Check if argument looks like an element ID (e.g., "1-67")
+        if (typeof targetArg === "string" && /^\d+-\d+$/.test(targetArg)) {
+            const argXpath = xpathMap[targetArg];
+            const trimmedArgXpath = (0, utils_js_1.trimTrailingTextNode)(argXpath);
+            if (trimmedArgXpath) {
+                resolvedArgs = [`xpath=${trimmedArgXpath}`, ...args.slice(1)];
+            }
+            else {
+                // Target element lookup failed, filter out this action
+                (0, logger_js_1.v3Logger)({
+                    category: "action",
+                    message: "dragAndDrop target element lookup failed",
+                    level: 1,
+                    auxiliary: {
+                        targetElementId: { value: targetArg, type: "string" },
+                        sourceElementId: { value: elementId, type: "string" },
+                    },
+                });
+                return undefined;
+            }
+        }
+        else {
+            (0, logger_js_1.v3Logger)({
+                category: "action",
+                message: "dragAndDrop target element invalid ID format",
+                level: 0,
+                auxiliary: {
+                    targetElementId: { value: String(targetArg), type: "string" },
+                    sourceElementId: { value: elementId, type: "string" },
+                },
+            });
+            return undefined;
+        }
+    }
+    return {
+        description,
+        method,
+        arguments: resolvedArgs,
+        selector: `xpath=${trimmed}`,
+    };
+}
+function substituteVariablesInArguments(args, variables) {
+    if (!variables || !Array.isArray(args)) {
+        return args;
+    }
+    return args.map((arg) => {
+        let out = arg;
+        for (const [key, v] of Object.entries(variables)) {
+            const token = `%${key}%`;
+            out = out.split(token).join((0, variables_js_1.resolveVariableValue)(v));
+        }
+        return out;
+    });
+}
+//# sourceMappingURL=actHandler.js.map

package/dist/cjs/lib/v3/handlers/actHandler.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"actHandler.js","sourceRoot":"","sources":["../../../../../lib/v3/handlers/actHandler.ts"],"names":[],"mappings":"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","sourcesContent":["// lib/v3/handlers/actHandler.ts\nimport { act as actInference } from \"../../inference.js\";\nimport { buildActPrompt, buildStepTwoPrompt } from \"../../prompt.js\";\nimport { trimTrailingTextNode } from \"../../utils.js\";\nimport { v3Logger } from \"../logger.js\";\nimport { ActHandlerParams } from \"../types/private/handlers.js\";\nimport { ActResult, Action, V3FunctionName } from \"../types/public/methods.js\";\nimport { ActTimeoutError } from \"../types/public/sdkErrors.js\";\nimport {\n captureHybridSnapshot,\n diffCombinedTrees,\n} from \"../understudy/a11y/snapshot/index.js\";\nimport { LLMClient } from \"../llm/LLMClient.js\";\nimport { SupportedUnderstudyAction } from \"../types/private/index.js\";\nimport { EncodedId } from \"../types/private/internal.js\";\nimport {\n AvailableModel,\n ClientOptions,\n ModelConfiguration,\n} from \"../types/public/model.js\";\nimport type { Variables } from \"../types/public/agent.js\";\nimport type { Page } from \"../understudy/page.js\";\nimport {\n performUnderstudyMethod,\n waitForDomNetworkQuiet,\n} from \"./handlerUtils/actHandlerUtils.js\";\nimport { createTimeoutGuard } from \"./handlerUtils/timeoutGuard.js\";\nimport { resolveVariableValue } from \"../agent/utils/variables.js\";\n\ntype ActInferenceElement = {\n elementId?: string;\n description: string;\n method?: string;\n arguments?: string[];\n};\n\ntype ActInferenceResponse = Awaited<ReturnType<typeof actInference>>;\n\nexport class ActHandler {\n private readonly llmClient: LLMClient;\n private readonly defaultModelName: AvailableModel;\n private readonly defaultClientOptions: ClientOptions;\n private readonly resolveLlmClient: (model?: ModelConfiguration) => LLMClient;\n private readonly systemPrompt: string;\n private readonly logInferenceToFile: boolean;\n private readonly selfHeal: boolean;\n private readonly onMetrics?: (\n functionName: V3FunctionName,\n promptTokens: number,\n completionTokens: number,\n reasoningTokens: number,\n cachedInputTokens: number,\n inferenceTimeMs: number,\n ) => void;\n private readonly defaultDomSettleTimeoutMs?: number;\n\n constructor(\n llmClient: LLMClient,\n defaultModelName: AvailableModel,\n defaultClientOptions: ClientOptions,\n resolveLlmClient: (model?: ModelConfiguration) => LLMClient,\n systemPrompt?: string,\n logInferenceToFile?: boolean,\n selfHeal?: boolean,\n onMetrics?: (\n functionName: V3FunctionName,\n promptTokens: number,\n completionTokens: number,\n reasoningTokens: number,\n cachedInputTokens: number,\n inferenceTimeMs: number,\n ) => void,\n defaultDomSettleTimeoutMs?: number,\n ) {\n this.llmClient = llmClient;\n this.defaultModelName = defaultModelName;\n this.defaultClientOptions = defaultClientOptions;\n this.resolveLlmClient = resolveLlmClient;\n this.systemPrompt = systemPrompt ?? \"\";\n this.logInferenceToFile = logInferenceToFile ?? false;\n this.selfHeal = !!selfHeal;\n this.onMetrics = onMetrics;\n this.defaultDomSettleTimeoutMs = defaultDomSettleTimeoutMs;\n }\n\n private recordActMetrics(response: ActInferenceResponse): void {\n this.onMetrics?.(\n V3FunctionName.ACT,\n response.prompt_tokens ?? 0,\n response.completion_tokens ?? 0,\n response.reasoning_tokens ?? 0,\n response.cached_input_tokens ?? 0,\n response.inference_time_ms ?? 0,\n );\n }\n\n private async getActionFromLLM({\n instruction,\n domElements,\n xpathMap,\n llmClient,\n requireMethodAndArguments = true,\n }: {\n instruction: string;\n domElements: string;\n xpathMap: Record<string, string>;\n llmClient: LLMClient;\n requireMethodAndArguments?: boolean;\n }): Promise<{ action?: Action; response: ActInferenceResponse }> {\n const response = await actInference({\n instruction,\n domElements,\n llmClient,\n userProvidedInstructions: this.systemPrompt,\n logger: v3Logger,\n logInferenceToFile: this.logInferenceToFile,\n });\n\n this.recordActMetrics(response);\n\n const normalized = normalizeActInferenceElement(\n response.element as ActInferenceElement | undefined,\n xpathMap,\n requireMethodAndArguments,\n );\n\n if (!normalized) {\n return { response };\n }\n\n return {\n action: { ...normalized } as Action,\n response,\n };\n }\n\n async act(params: ActHandlerParams): Promise<ActResult> {\n const { instruction, page, variables, timeout, model } = params;\n\n const llmClient = this.resolveLlmClient(model);\n const ensureTimeRemaining = createTimeoutGuard(\n timeout,\n (ms) => new ActTimeoutError(ms),\n );\n\n ensureTimeRemaining();\n await waitForDomNetworkQuiet(\n page.mainFrame(),\n this.defaultDomSettleTimeoutMs,\n );\n ensureTimeRemaining();\n const { combinedTree, combinedXpathMap } = await captureHybridSnapshot(\n page,\n { experimental: true },\n );\n\n const actInstruction = buildActPrompt(\n instruction,\n Object.values(SupportedUnderstudyAction),\n variables,\n );\n\n ensureTimeRemaining();\n const { action: firstAction, response: actInferenceResponse } =\n await this.getActionFromLLM({\n instruction: actInstruction,\n domElements: combinedTree,\n xpathMap: combinedXpathMap,\n llmClient,\n });\n\n if (!firstAction) {\n v3Logger({\n category: \"action\",\n message: \"no actionable element returned by LLM\",\n level: 1,\n });\n return {\n success: false,\n message: \"Failed to perform act: No action found\",\n actionDescription: instruction,\n actions: [],\n };\n }\n\n // First action (self-heal aware path)\n ensureTimeRemaining();\n const firstResult = await this.takeDeterministicAction(\n firstAction,\n page,\n this.defaultDomSettleTimeoutMs,\n llmClient,\n ensureTimeRemaining,\n variables,\n );\n\n // If not two-step, return the first action result\n if (actInferenceResponse?.twoStep !== true) {\n return firstResult;\n }\n\n // Take a new focused snapshot and observe again\n ensureTimeRemaining();\n const { combinedTree: combinedTree2, combinedXpathMap: combinedXpathMap2 } =\n await captureHybridSnapshot(page, {\n experimental: true,\n });\n\n let diffedTree = diffCombinedTrees(combinedTree, combinedTree2);\n if (!diffedTree.trim()) {\n // Fallback: if no diff detected, use the fresh tree to avoid empty context\n diffedTree = combinedTree2;\n }\n\n const previousAction = `method: ${firstAction.method}, description: ${firstAction.description}, arguments: ${firstAction.arguments}`;\n\n const stepTwoInstructions = buildStepTwoPrompt(\n instruction,\n previousAction,\n Object.values(SupportedUnderstudyAction).filter(\n (\n action,\n ): action is Exclude<\n SupportedUnderstudyAction,\n SupportedUnderstudyAction.SELECT_OPTION_FROM_DROPDOWN\n > => action !== SupportedUnderstudyAction.SELECT_OPTION_FROM_DROPDOWN,\n ),\n variables,\n );\n\n ensureTimeRemaining();\n const { action: secondAction } = await this.getActionFromLLM({\n instruction: stepTwoInstructions,\n domElements: diffedTree,\n xpathMap: combinedXpathMap2,\n llmClient,\n });\n\n if (!secondAction) {\n // No second action found — return first result as-is\n return firstResult;\n }\n\n ensureTimeRemaining();\n const secondResult = await this.takeDeterministicAction(\n secondAction,\n page,\n this.defaultDomSettleTimeoutMs,\n llmClient,\n ensureTimeRemaining,\n variables,\n );\n\n // Combine results\n return {\n success: firstResult.success && secondResult.success,\n message: secondResult.success\n ? `${firstResult.message} → ${secondResult.message}`\n : `${firstResult.message} → ${secondResult.message}`,\n actionDescription: firstResult.actionDescription,\n actions: [\n ...(firstResult.actions || []),\n ...(secondResult.actions || []),\n ],\n };\n }\n\n async takeDeterministicAction(\n action: Action,\n page: Page,\n domSettleTimeoutMs?: number,\n llmClientOverride?: LLMClient,\n ensureTimeRemaining?: () => void,\n variables?: Variables,\n ): Promise<ActResult> {\n ensureTimeRemaining?.();\n const settleTimeout = domSettleTimeoutMs ?? this.defaultDomSettleTimeoutMs;\n const effectiveClient = llmClientOverride ?? this.llmClient;\n const method = action.method?.trim();\n if (!method || method === \"not-supported\") {\n v3Logger({\n category: \"action\",\n message: \"action has no supported method\",\n level: 0,\n auxiliary: {\n act: { value: JSON.stringify(action), type: \"object\" },\n },\n });\n return {\n success: false,\n message: `Unable to perform action: The method '${method ?? \"\"}' is not supported in Action. Please use a supported Playwright locator method.`,\n actionDescription:\n action.description || `Action (${method ?? \"unknown\"})`,\n actions: [],\n };\n }\n\n const placeholderArgs = Array.isArray(action.arguments)\n ? [...action.arguments]\n : [];\n const resolvedArgs =\n substituteVariablesInArguments(action.arguments, variables) ?? [];\n\n try {\n ensureTimeRemaining?.();\n await performUnderstudyMethod(\n page,\n page.mainFrame(),\n method,\n action.selector,\n resolvedArgs,\n settleTimeout,\n );\n return {\n success: true,\n message: `Action [${method}] performed successfully on selector: ${action.selector}`,\n actionDescription: action.description || `action (${method})`,\n actions: [\n {\n selector: action.selector,\n description: action.description || `action (${method})`,\n method,\n arguments: placeholderArgs,\n },\n ],\n };\n } catch (err) {\n if (err instanceof ActTimeoutError) {\n throw err;\n }\n const msg = err instanceof Error ? err.message : String(err);\n\n // Attempt self-heal: rerun actInference and retry with updated selector\n if (this.selfHeal) {\n v3Logger({\n category: \"action\",\n message:\n \"Error performing action. Reprocessing the page and trying again\",\n level: 1,\n auxiliary: {\n error: { value: msg, type: \"string\" },\n action: {\n value: JSON.stringify(action),\n type: \"object\",\n },\n },\n });\n\n try {\n // Build an instruction combining method + description, avoiding duplication\n const actCommand = action.description\n ? action.description.toLowerCase().startsWith(method.toLowerCase())\n ? action.description\n : `${method} ${action.description}`\n : method;\n\n // Take a fresh snapshot and ask for a new actionable element\n ensureTimeRemaining?.();\n const { combinedTree, combinedXpathMap } =\n await captureHybridSnapshot(page, {\n experimental: true,\n });\n\n const instruction = buildActPrompt(\n actCommand,\n Object.values(SupportedUnderstudyAction),\n {},\n );\n\n ensureTimeRemaining?.();\n const { action: fallbackAction, response: fallbackResponse } =\n await this.getActionFromLLM({\n instruction,\n domElements: combinedTree,\n xpathMap: combinedXpathMap,\n llmClient: effectiveClient,\n requireMethodAndArguments: false,\n });\n\n const fallbackElement = fallbackResponse.element;\n if (!fallbackElement) {\n return {\n success: false,\n message:\n \"Failed to self-heal act: No observe results found for action\",\n actionDescription: actCommand,\n actions: [],\n };\n }\n\n // Retry with original method/args but new selector from fallback\n let newSelector = action.selector;\n if (fallbackAction?.selector) {\n newSelector = fallbackAction.selector;\n }\n\n ensureTimeRemaining?.();\n await performUnderstudyMethod(\n page,\n page.mainFrame(),\n method,\n newSelector,\n resolvedArgs,\n settleTimeout,\n );\n\n return {\n success: true,\n message: `Action [${method}] performed successfully on selector: ${newSelector}`,\n actionDescription: action.description || `action (${method})`,\n actions: [\n {\n selector: newSelector,\n description: action.description || `action (${method})`,\n method,\n arguments: placeholderArgs,\n },\n ],\n };\n } catch (retryErr) {\n if (retryErr instanceof ActTimeoutError) {\n throw retryErr;\n }\n const retryMsg =\n retryErr instanceof Error ? retryErr.message : String(retryErr);\n return {\n success: false,\n message: `Failed to perform act after self-heal: ${retryMsg}`,\n actionDescription: action.description || `action (${method})`,\n actions: [],\n };\n }\n }\n\n return {\n success: false,\n message: `Failed to perform act: ${msg}`,\n actionDescription: action.description || `action (${method})`,\n actions: [],\n };\n }\n }\n}\n\nfunction normalizeActInferenceElement(\n element: ActInferenceElement | undefined,\n xpathMap: Record<string, string>,\n requireMethodAndArguments = true,\n): Action | undefined {\n if (!element) {\n return undefined;\n }\n const { elementId, description, method, arguments: args } = element;\n const hasArgs = Array.isArray(args);\n\n if (\n requireMethodAndArguments &&\n (!method || method === \"not-supported\" || !hasArgs)\n ) {\n return undefined;\n }\n\n if (typeof elementId !== \"string\" || !elementId.includes(\"-\")) {\n return undefined;\n }\n\n const xp = xpathMap[elementId as EncodedId];\n const trimmed = trimTrailingTextNode(xp);\n if (!trimmed) {\n return undefined;\n }\n\n // For dragAndDrop, convert element ID in arguments to xpath (target element)\n let resolvedArgs = hasArgs ? args : undefined;\n if (method === \"dragAndDrop\" && hasArgs && args.length > 0) {\n const targetArg = args[0];\n // Check if argument looks like an element ID (e.g., \"1-67\")\n if (typeof targetArg === \"string\" && /^\\d+-\\d+$/.test(targetArg)) {\n const argXpath = xpathMap[targetArg as EncodedId];\n const trimmedArgXpath = trimTrailingTextNode(argXpath);\n if (trimmedArgXpath) {\n resolvedArgs = [`xpath=${trimmedArgXpath}`, ...args.slice(1)];\n } else {\n // Target element lookup failed, filter out this action\n v3Logger({\n category: \"action\",\n message: \"dragAndDrop target element lookup failed\",\n level: 1,\n auxiliary: {\n targetElementId: { value: targetArg, type: \"string\" },\n sourceElementId: { value: elementId, type: \"string\" },\n },\n });\n return undefined;\n }\n } else {\n v3Logger({\n category: \"action\",\n message: \"dragAndDrop target element invalid ID format\",\n level: 0,\n auxiliary: {\n targetElementId: { value: String(targetArg), type: \"string\" },\n sourceElementId: { value: elementId, type: \"string\" },\n },\n });\n return undefined;\n }\n }\n\n return {\n description,\n method,\n arguments: resolvedArgs,\n selector: `xpath=${trimmed}`,\n } as Action;\n}\n\nfunction substituteVariablesInArguments(\n args: string[] | undefined,\n variables?: Variables,\n): string[] | undefined {\n if (!variables || !Array.isArray(args)) {\n return args;\n }\n\n return args.map((arg: string) => {\n let out = arg;\n for (const [key, v] of Object.entries(variables)) {\n const token = `%${key}%`;\n out = out.split(token).join(resolveVariableValue(v));\n }\n return out;\n });\n}\n"]}

package/dist/cjs/lib/v3/handlers/extractHandler.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+import { V3FunctionName } from "../types/public/methods.js";
+import { LLMClient } from "../llm/LLMClient.js";
+import { ExtractHandlerParams } from "../types/private/handlers.js";
+import { ZodPathSegments } from "../types/private/internal.js";
+import { AvailableModel, ClientOptions, ModelConfiguration } from "../types/public/model.js";
+import type { InferStagehandSchema, StagehandZodSchema } from "../zodCompat.js";
+/**
+ * Scans the provided Zod schema for any `z.string().url()` fields and
+ * replaces them with `z.number()`.
+ *
+ * @param schema - The Zod object schema to transform.
+ * @returns A tuple containing:
+ *   1. The transformed schema (or the original schema if no changes were needed).
+ *   2. An array of {@link ZodPathSegments} objects representing all the replaced URL fields,
+ *      with each path segment showing where in the schema the replacement occurred.
+ */
+export declare function transformUrlStringsToNumericIds<T extends StagehandZodSchema>(schema: T): [StagehandZodSchema, ZodPathSegments[]];
+export declare class ExtractHandler {
+    private readonly llmClient;
+    private readonly defaultModelName;
+    private readonly defaultClientOptions;
+    private readonly resolveLlmClient;
+    private readonly systemPrompt;
+    private readonly logInferenceToFile;
+    private readonly experimental;
+    private readonly onMetrics?;
+    constructor(llmClient: LLMClient, defaultModelName: AvailableModel, defaultClientOptions: ClientOptions, resolveLlmClient: (model?: ModelConfiguration) => LLMClient, systemPrompt?: string, logInferenceToFile?: boolean, experimental?: boolean, onMetrics?: (functionName: V3FunctionName, promptTokens: number, completionTokens: number, reasoningTokens: number, cachedInputTokens: number, inferenceTimeMs: number) => void);
+    extract<T extends StagehandZodSchema>(params: ExtractHandlerParams<T>): Promise<InferStagehandSchema<T> | {
+        pageText: string;
+    }>;
+}