@browserbasehq/orca 3.2.0-preview.2 → 3.2.0-preview.4

package/dist/cjs/lib/v3/v3.d.ts

@@ -1,11 +1,12 @@
-import { EventEmitter } from "events";
 import { z } from "zod";
 import { InferStagehandSchema, StagehandZodSchema } from "./zodCompat.js";
 import { LLMClient } from "./llm/LLMClient.js";
 import { AgentReplayStep } from "./types/private/index.js";
 import { AgentConfig, AgentExecuteOptions, AgentStreamExecuteOptions, AgentResult, LogLine, StagehandMetrics, Action, ActOptions, ActResult, defaultExtractSchema, ExtractOptions, HistoryEntry, ObserveOptions, pageTextSchema, V3FunctionName, V3Options, AgentStreamResult } from "./types/public/index.js";
 import { V3Context } from "./understudy/context.js";
-import { type FlowLoggerContext } from "./flowLogger.js";
+import { type FlowLoggerContext } from "./flowlogger/FlowLogger.js";
+import { EventEmitterWithWildcardSupport } from "./flowlogger/EventEmitter.js";
+import { EventStore } from "./flowlogger/EventStore.js";
 /**
  * V3
  *
@@ -33,7 +34,7 @@ export declare class V3 {
      * Event bus for internal communication.
      * Emits events like 'screenshot' when screenshots are captured during agent execution.
      */
-    readonly bus: EventEmitter;
+    readonly bus: EventEmitterWithWildcardSupport;
     private modelName;
     private modelClientOptions;
     private llmProvider;
@@ -72,6 +73,7 @@ export declare class V3 {
     private _history;
     private readonly instanceId;
     private readonly sessionId;
+    readonly eventStore: EventStore;
     readonly flowLoggerContext: FlowLoggerContext;
     private static _processGuardsInstalled;
     private static _instances;
@@ -81,8 +83,6 @@ export declare class V3 {
     private apiClient;
     private keepAlive?;
     private shutdownSupervisor;
-    private detachEventStoreListener;
-    private withLoggingContext;
     stagehandMetrics: StagehandMetrics;
     constructor(opts: V3Options);
     /**

package/dist/cjs/lib/v3/v3.js

@@ -71,7 +71,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.V3 = void 0;
-const events_1 = require("events");
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
@@ -102,8 +101,9 @@ const modelUtils_js_2 = require("../modelUtils.js");
 const api_js_1 = require("./api.js");
 const validateExperimentalFeatures_js_1 = require("./agent/utils/validateExperimentalFeatures.js");
 const variables_js_1 = require("./agent/utils/variables.js");
-const flowLogger_js_1 = require("./flowLogger.js");
-const eventStore_js_1 = require("./eventStore.js");
+const FlowLogger_js_1 = require("./flowlogger/FlowLogger.js");
+const EventEmitter_js_1 = require("./flowlogger/EventEmitter.js");
+const EventStore_js_1 = require("./flowlogger/EventStore.js");
 const timeoutGuard_js_1 = require("./handlers/handlerUtils/timeoutGuard.js");
 const sdkErrors_js_1 = require("./types/public/sdkErrors.js");
 const DEFAULT_MODEL_NAME = "openai/gpt-4.1-mini";
@@ -151,17 +151,14 @@ let V3 = (() => {
     return class V3 {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
-            _act_decorators = [flowLogger_js_1.FlowLogger.wrapWithLogging({
+            _act_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({
                     eventType: "StagehandAct",
-                    eventIdSuffix: "4",
                 })];
-            _extract_decorators = [flowLogger_js_1.FlowLogger.wrapWithLogging({
+            _extract_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({
                     eventType: "StagehandExtract",
-                    eventIdSuffix: "4",
                 })];
-            _observe_decorators = [flowLogger_js_1.FlowLogger.wrapWithLogging({
+            _observe_decorators = [FlowLogger_js_1.FlowLogger.wrapWithLogging({
                     eventType: "StagehandObserve",
-                    eventIdSuffix: "4",
                 })];
             __esDecorate(this, null, _act_decorators, { kind: "method", name: "act", static: false, private: false, access: { has: obj => "act" in obj, get: obj => obj.act }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _extract_decorators, { kind: "method", name: "extract", static: false, private: false, access: { has: obj => "extract" in obj, get: obj => obj.extract }, metadata: _metadata }, null, _instanceExtraInitializers);
@@ -179,7 +176,7 @@ let V3 = (() => {
          * Event bus for internal communication.
          * Emits events like 'screenshot' when screenshots are captured during agent execution.
          */
-        bus = new events_1.EventEmitter();
+        bus = new EventEmitter_js_1.EventEmitterWithWildcardSupport();
         modelName;
         modelClientOptions;
         llmProvider;
@@ -248,6 +245,7 @@ let V3 = (() => {
         _history = [];
         instanceId;
         sessionId;
+        eventStore;
         flowLoggerContext;
         static _processGuardsInstalled = false;
         static _instances = new Set();
@@ -257,10 +255,6 @@ let V3 = (() => {
         apiClient = null;
         keepAlive;
         shutdownSupervisor = null;
-        detachEventStoreListener = null;
-        withLoggingContext(fn) {
-            return (0, logger_js_2.withInstanceLogContext)(this.instanceId, fn);
-        }
         stagehandMetrics = {
             actPromptTokens: 0,
             actCompletionTokens: 0,
@@ -385,9 +379,21 @@ let V3 = (() => {
                 act: this.act.bind(this),
             });
             this.opts = opts;
-            void (0, eventStore_js_1.getEventStore)().initializeSession(this.sessionId, opts);
-            this.flowLoggerContext = flowLogger_js_1.FlowLogger.init(this.sessionId, this.bus);
-            this.detachEventStoreListener = (0, eventStore_js_1.getEventStore)().attachBus(this.sessionId, this.bus);
+            // FlowLogger always gets a per-instance session context and shared event
+            // bus. The attached EventStore decides which sinks are active:
+            // `verbose: 2` or `BROWSERBASE_FLOW_LOGS=1` enables pretty stderr output,
+            // and `BROWSERBASE_CONFIG_DIR` enables the pretty/jsonl file sinks for this session.
+            this.eventStore = new EventStore_js_1.EventStore(this.sessionId, opts);
+            this.flowLoggerContext = FlowLogger_js_1.FlowLogger.init(this.sessionId, this.bus);
+            // Flow event pipeline:
+            // FlowLogger -> this.bus -> this.eventStore -> configured sinks/query history.
+            // V3 owns the bus for this session. EventStore is not another bus; it just
+            // receives already-emitted FlowEvents here, then fans them out to sinks and
+            // keeps the queryable per-session history used by /v4/log, parent/ancestor lookups, and tests.
+            // `on()` stores a strong reference to the handler, so the EventStore
+            // stays alive until this bus is garbage-collected with the rest of the V3
+            // object graph.
+            this.bus.on("*", this.eventStore.emit);
             // Track instance for global process guard handling
             V3._instances.add(this);
         }
@@ -594,7 +600,7 @@ let V3 = (() => {
          */
         async init() {
             try {
-                return await this.withLoggingContext(async () => {
+                return await (0, logger_js_2.withInstanceLogContext)(this.instanceId, async () => {
                     this.actHandler = new actHandler_js_1.ActHandler(this.llmClient, this.modelName, this.modelClientOptions, (model) => this.resolveLlmClient(model), this.opts.systemPrompt ?? "", this.logInferenceToFile, this.opts.selfHeal ?? true, (functionName, promptTokens, completionTokens, reasoningTokens, cachedInputTokens, inferenceTimeMs) => this.updateMetrics(functionName, promptTokens, completionTokens, reasoningTokens, cachedInputTokens, inferenceTimeMs), this.domSettleTimeoutMs);
                     this.extractHandler = new extractHandler_js_1.ExtractHandler(this.llmClient, this.modelName, this.modelClientOptions, (model) => this.resolveLlmClient(model), this.opts.systemPrompt ?? "", this.logInferenceToFile, this.experimental, (functionName, promptTokens, completionTokens, reasoningTokens, cachedInputTokens, inferenceTimeMs) => this.updateMetrics(functionName, promptTokens, completionTokens, reasoningTokens, cachedInputTokens, inferenceTimeMs));
                     this.observeHandler = new observeHandler_js_1.ObserveHandler(this.llmClient, this.modelName, this.modelClientOptions, (model) => this.resolveLlmClient(model), this.opts.systemPrompt ?? "", this.logInferenceToFile, this.experimental, (functionName, promptTokens, completionTokens, reasoningTokens, cachedInputTokens, inferenceTimeMs) => this.updateMetrics(functionName, promptTokens, completionTokens, reasoningTokens, cachedInputTokens, inferenceTimeMs));
@@ -759,9 +765,13 @@ let V3 = (() => {
                         const baseSessionParams = this.opts.browserbaseSessionCreateParams ?? {};
                         const resolvedKeepAlive = this.keepAlive;
                         const keepAlive = this.keepAlive === true;
-                        const effectiveSessionParams = resolvedKeepAlive !== undefined
-                            ? { ...baseSessionParams, keepAlive: resolvedKeepAlive }
-                            : baseSessionParams;
+                        let effectiveSessionParams = baseSessionParams;
+                        if (resolvedKeepAlive !== undefined) {
+                            effectiveSessionParams = {
+                                ...baseSessionParams,
+                                keepAlive: resolvedKeepAlive,
+                            };
+                        }
                         if (!this.disableAPI && !this.experimental) {
                             this.apiClient = new api_js_1.StagehandAPIClient({
                                 apiKey,
@@ -868,13 +878,6 @@ let V3 = (() => {
                         // ignore cleanup errors
                     }
                 }
-                try {
-                    this.detachEventStoreListener?.();
-                    this.detachEventStoreListener = null;
-                }
-                catch {
-                    // ignore cleanup errors
-                }
                 throw error;
             }
         }
@@ -918,7 +921,7 @@ let V3 = (() => {
             this.browserbaseDebugUrl = undefined;
         }
         async act(input, options) {
-            return await this.withLoggingContext(async () => {
+            return await (0, logger_js_2.withInstanceLogContext)(this.instanceId, async () => {
                 if (!this.actHandler)
                     throw new index_js_1.StagehandNotInitializedError("act()");
                 let actResult;
@@ -1002,7 +1005,7 @@ let V3 = (() => {
             });
         }
         async extract(a, b, c) {
-            return await this.withLoggingContext(async () => {
+            return await (0, logger_js_2.withInstanceLogContext)(this.instanceId, async () => {
                 if (!this.extractHandler) {
                     throw new index_js_1.StagehandNotInitializedError("extract()");
                 }
@@ -1070,7 +1073,7 @@ let V3 = (() => {
             });
         }
         async observe(a, b) {
-            return await this.withLoggingContext(async () => {
+            return await (0, logger_js_2.withInstanceLogContext)(this.instanceId, async () => {
                 if (!this.observeHandler) {
                     throw new index_js_1.StagehandNotInitializedError("observe()");
                 }
@@ -1156,7 +1159,7 @@ let V3 = (() => {
             try {
                 // Close session file logger
                 try {
-                    await flowLogger_js_1.FlowLogger.close(this.flowLoggerContext);
+                    await FlowLogger_js_1.FlowLogger.close(this.flowLoggerContext);
                 }
                 catch {
                     // ignore
@@ -1193,8 +1196,7 @@ let V3 = (() => {
                     // ignore
                 }
                 try {
-                    this.detachEventStoreListener?.();
-                    this.detachEventStoreListener = null;
+                    await this.eventStore.destroy();
                 }
                 catch {
                     // ignore
@@ -1465,10 +1467,7 @@ let V3 = (() => {
                     throw new index_js_1.CuaModelRequiredError(index_js_1.AVAILABLE_CUA_MODELS);
                 }
                 const agentConfigSignature = this.agentCache.buildConfigSignature(options);
-                const execute = flowLogger_js_1.FlowLogger.wrapWithLogging({
-                    eventType: "AgentExecute",
-                    eventIdSuffix: "3",
-                })(async (instructionOrOptions) => this.withLoggingContext(async () => {
+                const execute = async (instructionOrOptions) => (0, logger_js_2.withInstanceLogContext)(this.instanceId, async () => {
                     (0, validateExperimentalFeatures_js_1.validateExperimentalFeatures)({
                         isExperimental: this.experimental,
                         agentConfig: options,
@@ -1558,18 +1557,18 @@ let V3 = (() => {
                             this.discardAgentReplayRecording();
                         }
                     }
-                }));
+                });
                 return {
-                    execute,
+                    execute: FlowLogger_js_1.FlowLogger.wrapWithLogging({
+                        eventType: "AgentExecute",
+                        context: this.flowLoggerContext,
+                    })(execute),
                 };
             }
             // Default: AISDK tools-based agent
             const agentConfigSignature = this.agentCache.buildConfigSignature(options);
             const isStreaming = options?.stream ?? false;
-            const execute = flowLogger_js_1.FlowLogger.wrapWithLogging({
-                eventType: "AgentExecute",
-                eventIdSuffix: "3",
-            })(async (instructionOrOptions) => this.withLoggingContext(async () => {
+            const execute = async (instructionOrOptions) => (0, logger_js_2.withInstanceLogContext)(this.instanceId, async () => {
                 (0, validateExperimentalFeatures_js_1.validateExperimentalFeatures)({
                     isExperimental: this.experimental,
                     agentConfig: options,
@@ -1641,9 +1640,12 @@ let V3 = (() => {
                         this.discardAgentReplayRecording();
                     }
                 }
-            }));
+            });
             return {
-                execute,
+                execute: FlowLogger_js_1.FlowLogger.wrapWithLogging({
+                    eventType: "AgentExecute",
+                    context: this.flowLoggerContext,
+                })(execute),
             };
         }
     };