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

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

@@ -0,0 +1,375 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileEventStore = void 0;
+exports.aggregateFlowEventMetrics = aggregateFlowEventMetrics;
+exports.getConfigDir = getConfigDir;
+exports.setEventStore = setEventStore;
+exports.getEventStore = getEventStore;
+exports.destroyEventStore = destroyEventStore;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_stream_1 = require("node:stream");
+const pino_1 = __importDefault(require("pino"));
+const MAX_LINE_LENGTH = 160;
+const CONFIG_DIR = process.env.BROWSERBASE_CONFIG_DIR || "";
+// helper to take a list of events and compute aggregate metrics
+function aggregateFlowEventMetrics(events) {
+    return events.reduce((totals, event) => {
+        if (event.eventType === "LlmRequestEvent") {
+            totals.llmRequests += 1;
+        }
+        if (event.eventType === "LlmResponseEvent") {
+            const data = event.data;
+            totals.inputTokens += data?.inputTokens ?? 0;
+            totals.outputTokens += data?.outputTokens ?? 0;
+        }
+        if (event.eventType === "CdpCallEvent") {
+            totals.cdpEvents += 1;
+        }
+        return totals;
+    }, {
+        llmRequests: 0,
+        inputTokens: 0,
+        outputTokens: 0,
+        cdpEvents: 0,
+    });
+}
+function truncateCdpIds(value) {
+    return value.replace(/([iI]d:?"?)([0-9A-F]{32})(?="?[,})\s]|$)/g, (_, prefix, id) => `${prefix}${id.slice(0, 4)}…${id.slice(-4)}`);
+}
+function sanitizeSinkValue(value) {
+    if (typeof value === "string") {
+        return truncateCdpIds(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => sanitizeSinkValue(entry));
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
+            key,
+            sanitizeSinkValue(entry),
+        ]));
+    }
+    return value;
+}
+function sanitizeEventForFileStore(event) {
+    if (!event.eventType.startsWith("Cdp")) {
+        return event;
+    }
+    return {
+        ...event,
+        data: sanitizeSinkValue(event.data),
+    };
+}
+function truncateLine(value, maxLen) {
+    const collapsed = value.replace(/\s+/g, " ");
+    if (collapsed.length <= maxLen) {
+        return collapsed;
+    }
+    const endLen = Math.floor(maxLen * 0.3);
+    const startLen = maxLen - endLen - 1;
+    return `${collapsed.slice(0, startLen)}…${collapsed.slice(-endLen)}`;
+}
+function formatValue(value) {
+    if (typeof value === "string")
+        return `'${value}'`;
+    if (value == null || typeof value !== "object")
+        return String(value);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return "[unserializable]";
+    }
+}
+function formatArgs(args) {
+    if (args === undefined) {
+        return "";
+    }
+    return (Array.isArray(args) ? args : [args])
+        .filter((entry) => entry !== undefined)
+        .map(formatValue)
+        .filter((entry) => entry.length > 0)
+        .join(", ");
+}
+function shortId(id) {
+    return id ? id.slice(-4) : "-";
+}
+let nonce = 0;
+function formatTimestamp() {
+    const date = new Date();
+    const pad = (value, width = 2) => String(value).padStart(width, "0");
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.${pad(date.getMilliseconds(), 3)}${pad(nonce++ % 100)}`;
+}
+const SENSITIVE_KEYS = /apikey|api_key|key|secret|token|password|passwd|pwd|credential|auth/i;
+function sanitizeOptions(options) {
+    const sanitize = (value) => {
+        if (typeof value !== "object" || value === null)
+            return value;
+        if (Array.isArray(value))
+            return value.map(sanitize);
+        const result = {};
+        for (const [key, entry] of Object.entries(value)) {
+            result[key] = SENSITIVE_KEYS.test(key) ? "******" : sanitize(entry);
+        }
+        return result;
+    };
+    return sanitize({ ...options });
+}
+function removeQuotes(value) {
+    return value
+        .replace(/([^\\])["']/g, "$1")
+        .replace(/^["']|["']$/g, "")
+        .trim();
+}
+function formatEventTimestamp(value) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return formatTimestamp();
+    }
+    const pad = (entry, width = 2) => String(entry).padStart(width, "0");
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.${pad(date.getMilliseconds(), 3)}${pad(nonce++ % 100)}`;
+}
+function prettifyEvent(event) {
+    const indent = "  ".repeat(event.eventParentIds.length);
+    const tag = `[#${shortId(event.eventId)}]`;
+    const data = event.data;
+    const argsStr = data?.params
+        ? formatArgs(data.params)
+        : formatArgs(event.data);
+    const durationSec = data?.durationMs
+        ? (data.durationMs / 1000).toFixed(2)
+        : null;
+    const promptStr = data?.prompt ? ` ${String(data.prompt)}` : "";
+    const outputStr = data?.output ? ` ${String(data.output)}` : "";
+    const hasTokens = data?.inputTokens !== undefined || data?.outputTokens !== undefined;
+    const tokenStr = hasTokens
+        ? ` ꜛ${data?.inputTokens ?? 0} ꜜ${data?.outputTokens ?? 0}`
+        : "";
+    const details = [
+        event.eventType,
+        argsStr ? `(${argsStr})` : "",
+        promptStr,
+        outputStr,
+        tokenStr,
+        durationSec ? ` ${durationSec}s` : "",
+        data?.msg ? ` ${data.msg}` : "",
+        data?.error ? ` ERROR ${data.error}` : "",
+    ].join("");
+    if (!details) {
+        return null;
+    }
+    const fullLine = `${formatEventTimestamp(event.createdAt)} ${indent}${tag} ${details}`;
+    const cleaned = removeQuotes(fullLine);
+    return truncateLine(cleaned, MAX_LINE_LENGTH);
+}
+function isWritable(stream) {
+    return !!(stream && !stream.destroyed && stream.writable);
+}
+function createJsonlStream(ctx) {
+    return new node_stream_1.Writable({
+        objectMode: true,
+        write(chunk, _, cb) {
+            if (ctx.initialized && isWritable(ctx.fileStreams.jsonl)) {
+                ctx.fileStreams.jsonl.write(chunk, cb);
+                return;
+            }
+            cb();
+        },
+    });
+}
+function createPrettyStream(ctx) {
+    return new node_stream_1.Writable({
+        objectMode: true,
+        write(chunk, _, cb) {
+            const stream = ctx.fileStreams.pretty;
+            if (!ctx.initialized || !isWritable(stream)) {
+                cb();
+                return;
+            }
+            try {
+                const event = JSON.parse(chunk);
+                const line = prettifyEvent(event);
+                if (line) {
+                    stream.write(line + "\n", cb);
+                    return;
+                }
+            }
+            catch {
+                // fall through
+            }
+            cb();
+        },
+    });
+}
+function getConfigDir() {
+    return CONFIG_DIR ? node_path_1.default.resolve(CONFIG_DIR) : "";
+}
+function matchesQuery(event, query) {
+    if (query.sessionId && event.sessionId !== query.sessionId)
+        return false;
+    if (query.eventId) {
+        const matchesEvent = event.eventId === query.eventId ||
+            event.eventParentIds.includes(query.eventId);
+        if (!matchesEvent) {
+            return false;
+        }
+    }
+    if (query.eventType) {
+        const pattern = new RegExp(`^${query.eventType
+            .replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+            .replace(/\\\*/g, ".*")}$`);
+        if (!pattern.test(event.eventType)) {
+            return false;
+        }
+    }
+    return true;
+}
+class FileEventStore {
+    sessionContexts = new Map();
+    eventsBySession = new Map();
+    subscribers = new Set();
+    async initializeSession(sessionId, v3Options) {
+        const existing = this.sessionContexts.get(sessionId);
+        if (existing) {
+            await existing.initPromise;
+            return;
+        }
+        const configDir = getConfigDir();
+        const sessionDir = configDir
+            ? node_path_1.default.join(configDir, "sessions", sessionId)
+            : "";
+        const ctx = {
+            logger: null,
+            sessionId,
+            sessionDir,
+            configDir,
+            initPromise: Promise.resolve(),
+            initialized: false,
+            fileStreams: {
+                pretty: null,
+                jsonl: null,
+            },
+        };
+        ctx.initPromise = this.initSessionContext(ctx, v3Options);
+        this.sessionContexts.set(sessionId, ctx);
+        await ctx.initPromise;
+    }
+    async initSessionContext(ctx, v3Options) {
+        if (!ctx.configDir) {
+            ctx.initialized = true;
+            return;
+        }
+        await node_fs_1.default.promises.mkdir(ctx.sessionDir, { recursive: true });
+        if (v3Options) {
+            const sessionJsonPath = node_path_1.default.join(ctx.sessionDir, "session.json");
+            await node_fs_1.default.promises.writeFile(sessionJsonPath, JSON.stringify(sanitizeOptions(v3Options), null, 2), "utf-8");
+        }
+        const latestLink = node_path_1.default.join(ctx.configDir, "sessions", "latest");
+        try {
+            try {
+                await node_fs_1.default.promises.unlink(latestLink);
+            }
+            catch {
+                // ignore missing link
+            }
+            await node_fs_1.default.promises.symlink(ctx.sessionId, latestLink, "dir");
+        }
+        catch {
+            // symlink best effort only
+        }
+        ctx.fileStreams.pretty = node_fs_1.default.createWriteStream(node_path_1.default.join(ctx.sessionDir, "session_events.log"), { flags: "a" });
+        ctx.fileStreams.jsonl = node_fs_1.default.createWriteStream(node_path_1.default.join(ctx.sessionDir, "session_events.jsonl"), { flags: "a" });
+        ctx.initialized = true;
+        ctx.logger = (0, pino_1.default)({ level: "info" }, pino_1.default.multistream([
+            { stream: createJsonlStream(ctx) },
+            { stream: createPrettyStream(ctx) },
+        ]));
+    }
+    async appendEvent(event) {
+        const storedEvent = sanitizeEventForFileStore(event);
+        const existing = this.eventsBySession.get(storedEvent.sessionId) ?? [];
+        existing.push(storedEvent);
+        this.eventsBySession.set(storedEvent.sessionId, existing);
+        for (const subscriber of this.subscribers) {
+            if (matchesQuery(storedEvent, subscriber.query)) {
+                subscriber.listener(storedEvent);
+            }
+        }
+        const ctx = this.sessionContexts.get(storedEvent.sessionId);
+        if (!ctx) {
+            return;
+        }
+        await ctx.initPromise;
+        ctx.logger?.info(storedEvent);
+    }
+    attachBus(sessionId, bus) {
+        const emit = bus.emit.bind(bus);
+        bus.emit = ((eventName, ...args) => {
+            const [event] = args;
+            if (event.sessionId === sessionId) {
+                void this.appendEvent(event);
+            }
+            return emit(eventName, ...args);
+        });
+        return () => {
+            bus.emit = emit;
+        };
+    }
+    async listEvents(query) {
+        const sourceEvents = query.sessionId
+            ? [...(this.eventsBySession.get(query.sessionId) ?? [])]
+            : [...this.eventsBySession.values()].flat();
+        const filtered = sourceEvents.filter((event) => matchesQuery(event, query));
+        filtered.sort((left, right) => {
+            const createdAtOrder = left.createdAt.localeCompare(right.createdAt);
+            if (createdAtOrder !== 0) {
+                return createdAtOrder;
+            }
+            return left.eventId.localeCompare(right.eventId);
+        });
+        if (!query.limit) {
+            return filtered;
+        }
+        return filtered.slice(0, query.limit);
+    }
+    subscribe(query, listener) {
+        const subscriber = { query, listener };
+        this.subscribers.add(subscriber);
+        return () => {
+            this.subscribers.delete(subscriber);
+        };
+    }
+    async destroy() {
+        this.subscribers.clear();
+        this.eventsBySession.clear();
+        await Promise.all([...this.sessionContexts.values()].flatMap((ctx) => Object.values(ctx.fileStreams)
+            .filter(Boolean)
+            .map((stream) => new Promise((resolve) => {
+            stream.end(resolve);
+        })))).catch(() => { });
+        this.sessionContexts.clear();
+    }
+}
+exports.FileEventStore = FileEventStore;
+let eventStore = null;
+function setEventStore(store) {
+    eventStore = store;
+}
+function getEventStore() {
+    if (!eventStore) {
+        eventStore = new FileEventStore();
+    }
+    return eventStore;
+}
+async function destroyEventStore() {
+    if (!eventStore) {
+        return;
+    }
+    await eventStore.destroy();
+    eventStore = null;
+}
+//# sourceMappingURL=eventStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eventStore.js","sourceRoot":"","sources":["../../../../lib/v3/eventStore.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { Writable } from \"node:stream\";\nimport type { EventEmitter } from \"node:events\";\nimport pino from \"pino\";\n\nimport type { V3Options } from \"./types/public/index.js\";\nimport { type FlowEvent } from \"./flowLogger.js\";\n\nconst MAX_LINE_LENGTH = 160;\nconst CONFIG_DIR = process.env.BROWSERBASE_CONFIG_DIR || \"\";\n\nexport interface FlowEventAggregateMetrics {\n  llmRequests: number;\n  inputTokens: number;\n  outputTokens: number;\n  cdpEvents: number;\n}\n\nexport interface EventStoreQuery {\n  sessionId?: string;\n  eventId?: string;\n  eventType?: string;\n  limit?: number;\n}\n\nexport type EventStoreListener = (event: FlowEvent) => void;\n\nexport interface EventStore {\n  initializeSession(sessionId: string, v3Options?: V3Options): Promise<void>;\n  appendEvent(event: FlowEvent): Promise<void>;\n  attachBus(sessionId: string, bus: EventEmitter): () => void;\n  listEvents(query: EventStoreQuery): Promise<FlowEvent[]>;\n  subscribe(query: EventStoreQuery, listener: EventStoreListener): () => void;\n  destroy(): Promise<void>;\n}\n\n// helper to take a list of events and compute aggregate metrics\nexport function aggregateFlowEventMetrics(\n  events: FlowEvent[],\n): FlowEventAggregateMetrics {\n  return events.reduce<FlowEventAggregateMetrics>(\n    (totals, event) => {\n      if (event.eventType === \"LlmRequestEvent\") {\n        totals.llmRequests += 1;\n      }\n\n      if (event.eventType === \"LlmResponseEvent\") {\n        const data = event.data as {\n          inputTokens?: number;\n          outputTokens?: number;\n        };\n        totals.inputTokens += data?.inputTokens ?? 0;\n        totals.outputTokens += data?.outputTokens ?? 0;\n      }\n\n      if (event.eventType === \"CdpCallEvent\") {\n        totals.cdpEvents += 1;\n      }\n\n      return totals;\n    },\n    {\n      llmRequests: 0,\n      inputTokens: 0,\n      outputTokens: 0,\n      cdpEvents: 0,\n    },\n  );\n}\n\ninterface SessionContext {\n  logger: pino.Logger | null;\n  sessionId: string;\n  sessionDir: string;\n  configDir: string;\n  initPromise: Promise<void>;\n  initialized: boolean;\n  fileStreams: {\n    pretty: fs.WriteStream | null;\n    jsonl: fs.WriteStream | null;\n  };\n}\n\ninterface EventSubscriber {\n  listener: EventStoreListener;\n  query: EventStoreQuery;\n}\n\nfunction truncateCdpIds(value: string): string {\n  return value.replace(\n    /([iI]d:?\"?)([0-9A-F]{32})(?=\"?[,})\\s]|$)/g,\n    (_, prefix: string, id: string) =>\n      `${prefix}${id.slice(0, 4)}…${id.slice(-4)}`,\n  );\n}\n\nfunction sanitizeSinkValue(value: unknown): unknown {\n  if (typeof value === \"string\") {\n    return truncateCdpIds(value);\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((entry) => sanitizeSinkValue(entry));\n  }\n\n  if (value && typeof value === \"object\") {\n    return Object.fromEntries(\n      Object.entries(value).map(([key, entry]) => [\n        key,\n        sanitizeSinkValue(entry),\n      ]),\n    );\n  }\n\n  return value;\n}\n\nfunction sanitizeEventForFileStore(event: FlowEvent): FlowEvent {\n  if (!event.eventType.startsWith(\"Cdp\")) {\n    return event;\n  }\n\n  return {\n    ...event,\n    data: sanitizeSinkValue(event.data) as Record<string, unknown>,\n  };\n}\n\nfunction truncateLine(value: string, maxLen: number): string {\n  const collapsed = value.replace(/\\s+/g, \" \");\n  if (collapsed.length <= maxLen) {\n    return collapsed;\n  }\n\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\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) {\n    return \"\";\n  }\n\n  return (Array.isArray(args) ? args : [args])\n    .filter((entry) => entry !== undefined)\n    .map(formatValue)\n    .filter((entry) => entry.length > 0)\n    .join(\", \");\n}\n\nfunction shortId(id: string | null | undefined): string {\n  return id ? id.slice(-4) : \"-\";\n}\n\nlet nonce = 0;\nfunction formatTimestamp(): string {\n  const date = new Date();\n  const pad = (value: number, width = 2) => String(value).padStart(width, \"0\");\n  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.${pad(date.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 = (value: unknown): unknown => {\n    if (typeof value !== \"object\" || value === null) return value;\n    if (Array.isArray(value)) return value.map(sanitize);\n\n    const result: Record<string, unknown> = {};\n    for (const [key, entry] of Object.entries(value)) {\n      result[key] = SENSITIVE_KEYS.test(key) ? \"******\" : sanitize(entry);\n    }\n    return result;\n  };\n\n  return sanitize({ ...options }) as Record<string, unknown>;\n}\n\nfunction removeQuotes(value: string): string {\n  return value\n    .replace(/([^\\\\])[\"']/g, \"$1\")\n    .replace(/^[\"']|[\"']$/g, \"\")\n    .trim();\n}\n\nfunction formatEventTimestamp(value: string): string {\n  const date = new Date(value);\n  if (Number.isNaN(date.getTime())) {\n    return formatTimestamp();\n  }\n\n  const pad = (entry: number, width = 2) => String(entry).padStart(width, \"0\");\n  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.${pad(date.getMilliseconds(), 3)}${pad(nonce++ % 100)}`;\n}\n\nfunction prettifyEvent(event: FlowEvent): string | null {\n  const indent = \"  \".repeat(event.eventParentIds.length);\n  const tag = `[#${shortId(event.eventId)}]`;\n  const data = event.data as {\n    params?: unknown;\n    prompt?: unknown;\n    output?: unknown;\n    durationMs?: number;\n    inputTokens?: number;\n    outputTokens?: number;\n    error?: string;\n    msg?: string;\n  };\n  const argsStr = data?.params\n    ? formatArgs(data.params)\n    : formatArgs(event.data);\n  const durationSec = data?.durationMs\n    ? (data.durationMs / 1000).toFixed(2)\n    : null;\n  const promptStr = data?.prompt ? ` ${String(data.prompt)}` : \"\";\n  const outputStr = data?.output ? ` ${String(data.output)}` : \"\";\n  const hasTokens =\n    data?.inputTokens !== undefined || data?.outputTokens !== undefined;\n  const tokenStr = hasTokens\n    ? ` ꜛ${data?.inputTokens ?? 0} ꜜ${data?.outputTokens ?? 0}`\n    : \"\";\n  const details = [\n    event.eventType,\n    argsStr ? `(${argsStr})` : \"\",\n    promptStr,\n    outputStr,\n    tokenStr,\n    durationSec ? ` ${durationSec}s` : \"\",\n    data?.msg ? ` ${data.msg}` : \"\",\n    data?.error ? ` ERROR ${data.error}` : \"\",\n  ].join(\"\");\n\n  if (!details) {\n    return null;\n  }\n\n  const fullLine = `${formatEventTimestamp(event.createdAt)} ${indent}${tag} ${details}`;\n  const cleaned = removeQuotes(fullLine);\n  return truncateLine(cleaned, MAX_LINE_LENGTH);\n}\n\nfunction isWritable(stream: fs.WriteStream | null): stream is fs.WriteStream {\n  return !!(stream && !stream.destroyed && stream.writable);\n}\n\nfunction createJsonlStream(ctx: SessionContext): 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        return;\n      }\n\n      cb();\n    },\n  });\n}\n\nfunction createPrettyStream(ctx: SessionContext): Writable {\n  return new Writable({\n    objectMode: true,\n    write(chunk: string, _, cb) {\n      const stream = ctx.fileStreams.pretty;\n      if (!ctx.initialized || !isWritable(stream)) {\n        cb();\n        return;\n      }\n\n      try {\n        const event = JSON.parse(chunk) as FlowEvent;\n        const line = prettifyEvent(event);\n        if (line) {\n          stream.write(line + \"\\n\", cb);\n          return;\n        }\n      } catch {\n        // fall through\n      }\n\n      cb();\n    },\n  });\n}\n\nexport function getConfigDir(): string {\n  return CONFIG_DIR ? path.resolve(CONFIG_DIR) : \"\";\n}\n\nfunction matchesQuery(event: FlowEvent, query: EventStoreQuery): boolean {\n  if (query.sessionId && event.sessionId !== query.sessionId) return false;\n  if (query.eventId) {\n    const matchesEvent =\n      event.eventId === query.eventId ||\n      event.eventParentIds.includes(query.eventId);\n    if (!matchesEvent) {\n      return false;\n    }\n  }\n  if (query.eventType) {\n    const pattern = new RegExp(\n      `^${query.eventType\n        .replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")\n        .replace(/\\\\\\*/g, \".*\")}$`,\n    );\n    if (!pattern.test(event.eventType)) {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport class FileEventStore implements EventStore {\n  private readonly sessionContexts = new Map<string, SessionContext>();\n  private readonly eventsBySession = new Map<string, FlowEvent[]>();\n  private readonly subscribers = new Set<EventSubscriber>();\n\n  async initializeSession(\n    sessionId: string,\n    v3Options?: V3Options,\n  ): Promise<void> {\n    const existing = this.sessionContexts.get(sessionId);\n    if (existing) {\n      await existing.initPromise;\n      return;\n    }\n\n    const configDir = getConfigDir();\n    const sessionDir = configDir\n      ? path.join(configDir, \"sessions\", sessionId)\n      : \"\";\n\n    const ctx: SessionContext = {\n      logger: null,\n      sessionId,\n      sessionDir,\n      configDir,\n      initPromise: Promise.resolve(),\n      initialized: false,\n      fileStreams: {\n        pretty: null,\n        jsonl: null,\n      },\n    };\n\n    ctx.initPromise = this.initSessionContext(ctx, v3Options);\n    this.sessionContexts.set(sessionId, ctx);\n    await ctx.initPromise;\n  }\n\n  private async initSessionContext(\n    ctx: SessionContext,\n    v3Options?: V3Options,\n  ): Promise<void> {\n    if (!ctx.configDir) {\n      ctx.initialized = true;\n      return;\n    }\n\n    await fs.promises.mkdir(ctx.sessionDir, { recursive: true });\n\n    if (v3Options) {\n      const sessionJsonPath = path.join(ctx.sessionDir, \"session.json\");\n      await fs.promises.writeFile(\n        sessionJsonPath,\n        JSON.stringify(sanitizeOptions(v3Options), null, 2),\n        \"utf-8\",\n      );\n    }\n\n    const latestLink = path.join(ctx.configDir, \"sessions\", \"latest\");\n    try {\n      try {\n        await fs.promises.unlink(latestLink);\n      } catch {\n        // ignore missing link\n      }\n      await fs.promises.symlink(ctx.sessionId, latestLink, \"dir\");\n    } catch {\n      // symlink best effort only\n    }\n\n    ctx.fileStreams.pretty = fs.createWriteStream(\n      path.join(ctx.sessionDir, \"session_events.log\"),\n      { flags: \"a\" },\n    );\n    ctx.fileStreams.jsonl = fs.createWriteStream(\n      path.join(ctx.sessionDir, \"session_events.jsonl\"),\n      { flags: \"a\" },\n    );\n\n    ctx.initialized = true;\n    ctx.logger = pino(\n      { level: \"info\" },\n      pino.multistream([\n        { stream: createJsonlStream(ctx) },\n        { stream: createPrettyStream(ctx) },\n      ]),\n    );\n  }\n\n  async appendEvent(event: FlowEvent): Promise<void> {\n    const storedEvent = sanitizeEventForFileStore(event);\n    const existing = this.eventsBySession.get(storedEvent.sessionId) ?? [];\n    existing.push(storedEvent);\n    this.eventsBySession.set(storedEvent.sessionId, existing);\n\n    for (const subscriber of this.subscribers) {\n      if (matchesQuery(storedEvent, subscriber.query)) {\n        subscriber.listener(storedEvent);\n      }\n    }\n\n    const ctx = this.sessionContexts.get(storedEvent.sessionId);\n    if (!ctx) {\n      return;\n    }\n\n    await ctx.initPromise;\n    ctx.logger?.info(storedEvent);\n  }\n\n  attachBus(sessionId: string, bus: EventEmitter): () => void {\n    const emit = bus.emit.bind(bus);\n    bus.emit = ((eventName: string | symbol, ...args: [FlowEvent]) => {\n      const [event] = args;\n      if (event.sessionId === sessionId) {\n        void this.appendEvent(event);\n      }\n      return emit(eventName, ...args);\n    }) as typeof bus.emit;\n\n    return () => {\n      bus.emit = emit;\n    };\n  }\n\n  async listEvents(query: EventStoreQuery): Promise<FlowEvent[]> {\n    const sourceEvents = query.sessionId\n      ? [...(this.eventsBySession.get(query.sessionId) ?? [])]\n      : [...this.eventsBySession.values()].flat();\n\n    const filtered = sourceEvents.filter((event) => matchesQuery(event, query));\n    filtered.sort((left, right) => {\n      const createdAtOrder = left.createdAt.localeCompare(right.createdAt);\n      if (createdAtOrder !== 0) {\n        return createdAtOrder;\n      }\n\n      return left.eventId.localeCompare(right.eventId);\n    });\n\n    if (!query.limit) {\n      return filtered;\n    }\n\n    return filtered.slice(0, query.limit);\n  }\n\n  subscribe(query: EventStoreQuery, listener: EventStoreListener): () => void {\n    const subscriber: EventSubscriber = { query, listener };\n    this.subscribers.add(subscriber);\n\n    return () => {\n      this.subscribers.delete(subscriber);\n    };\n  }\n\n  async destroy(): Promise<void> {\n    this.subscribers.clear();\n    this.eventsBySession.clear();\n\n    await Promise.all(\n      [...this.sessionContexts.values()].flatMap((ctx) =>\n        Object.values(ctx.fileStreams)\n          .filter(Boolean)\n          .map(\n            (stream) =>\n              new Promise<void>((resolve) => {\n                stream!.end(resolve);\n              }),\n          ),\n      ),\n    ).catch(() => {});\n\n    this.sessionContexts.clear();\n  }\n}\n\nlet eventStore: EventStore | null = null;\n\nexport function setEventStore(store: EventStore): void {\n  eventStore = store;\n}\n\nexport function getEventStore(): EventStore {\n  if (!eventStore) {\n    eventStore = new FileEventStore();\n  }\n\n  return eventStore;\n}\n\nexport async function destroyEventStore(): Promise<void> {\n  if (!eventStore) {\n    return;\n  }\n\n  await eventStore.destroy();\n  eventStore = null;\n}\n"]}

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

@@ -1,124 +1,76 @@
-import fs from "node:fs";
-import pino from "pino";
+import { EventEmitter } from "node:events";
 import type { LanguageModelMiddleware } from "ai";
-import type { V3Options } from "./types/public/index.js";
-interface FlowLoggerMetrics {
-    taskStartTime?: number;
-    stepStartTime?: number;
-    actionStartTime?: number;
-    llmRequests: number;
-    llmInputTokens: number;
-    llmOutputTokens: number;
-    cdpEvents: number;
+export type FlowEventData = Record<string, unknown>;
+export type FlowEventInput = Omit<FlowEvent, "eventId" | "createdAt" | "sessionId" | "eventParentIds" | "data"> & {
+    eventId?: string;
+    eventIdSuffix?: string;
+    createdAt?: string;
+    sessionId?: string;
+    eventParentIds?: string[];
+    data?: FlowEventData;
+};
+export declare class FlowEvent {
+    static createEventId(eventIdSuffix: string): string;
+    eventType: string;
+    eventId: string;
+    eventParentIds: string[];
+    createdAt: string;
+    sessionId: string;
+    data: FlowEventData;
+    constructor(input: FlowEventInput);
 }
 export interface FlowLoggerContext {
-    logger: pino.Logger;
-    metrics: FlowLoggerMetrics;
     sessionId: string;
-    sessionDir: string;
-    configDir: string;
-    initPromise: Promise<void>;
-    initialized: boolean;
-    taskId: string | null;
-    stepId: string | null;
-    stepLabel: string | null;
-    actionId: string | null;
-    actionLabel: string | null;
-    fileStreams: {
-        agent: fs.WriteStream | null;
-        stagehand: fs.WriteStream | null;
-        understudy: fs.WriteStream | null;
-        cdp: fs.WriteStream | null;
-        llm: fs.WriteStream | null;
-        jsonl: fs.WriteStream | null;
-    };
+    eventBus: EventEmitter;
+    parentEvents: FlowEvent[];
 }
-/**
- * Get the config directory. Returns empty string if logging is disabled.
- */
-export declare function getConfigDir(): string;
-/**
- * Format a prompt preview from LLM messages for logging.
- * Returns format like: "some text... +{5.8kb image} +{schema} +{12 tools}"
- */
-export declare function formatLlmPromptPreview(messages: Array<{
-    role: string;
-    content: unknown;
-}>, options?: {
-    toolCount?: number;
-    hasSchema?: boolean;
-}): string | undefined;
-/**
- * Extract a text preview from CUA-style messages.
- * Accepts various message formats (Anthropic, OpenAI, Google).
- */
-export declare function formatCuaPromptPreview(messages: unknown[], maxLen?: number): string | undefined;
-/** Format CUA response output for logging */
-export declare function formatCuaResponsePreview(output: unknown, maxLen?: number): string;
-export declare class SessionFileLogger {
+type AsyncOriginalMethod<TArgs extends unknown[] = unknown[], TResult = unknown, TThis = unknown> = (this: TThis, ...args: TArgs) => Promise<TResult>;
+type FlowLoggerLogOptions = FlowEventInput & {
+    context?: FlowLoggerContext;
+};
+export declare class FlowLogger {
+    private static cloneContext;
+    private static emit;
+    private static runWithAutoStatusEventLogging;
     /**
      * Initialize a new logging context. Call this at the start of a session.
-     * If BROWSERBASE_CONFIG_DIR is not set, logging is disabled.
-     */
-    static init(sessionId: string, v3Options?: V3Options): void;
-    private static initAsync;
-    static close(): Promise<void>;
-    static get sessionId(): string | null;
-    static get sessionDir(): string | null;
-    /**
-     * Get the current logger context object.
-     */
-    static getContext(): FlowLoggerContext | null;
-    /**
-     * Start a new task and log it.
      */
-    static logAgentTaskStarted({ invocation, args, }: {
-        invocation: string;
-        args?: unknown | unknown[];
-    }): void;
-    /**
-     * Log task completion with metrics summary.
-     */
-    static logAgentTaskCompleted(options?: {
-        cacheHit?: boolean;
-    }): void;
-    static logStagehandStepEvent({ invocation, args, label, }: {
-        invocation: string;
-        args?: unknown | unknown[];
-        label: string;
-    }): string;
-    static logStagehandStepCompleted(): void;
-    static logUnderstudyActionEvent({ actionType, target, args, }: {
-        actionType: string;
-        target?: string;
-        args?: unknown | unknown[];
-    }): string;
-    static logUnderstudyActionCompleted(): void;
+    static init(sessionId: string, eventBus: EventEmitter): FlowLoggerContext;
+    static close(context?: FlowLoggerContext | null): Promise<void>;
+    static get currentContext(): FlowLoggerContext;
+    static wrapWithLogging<TMethod extends AsyncOriginalMethod>(options: FlowLoggerLogOptions): <TWrappedMethod extends AsyncOriginalMethod<Parameters<TMethod>, Awaited<ReturnType<TMethod>>, ThisParameterType<TMethod>>>(originalMethod: TWrappedMethod) => TWrappedMethod;
+    static runWithLogging<TMethod extends AsyncOriginalMethod>(options: FlowLoggerLogOptions, originalMethod: TMethod, params: Readonly<Parameters<TMethod>>): Promise<Awaited<ReturnType<TMethod>>>;
+    static runWithLogging<TResult>(options: FlowLoggerLogOptions, originalMethod: AsyncOriginalMethod<[], TResult>, params: ReadonlyArray<unknown>): Promise<Awaited<TResult>>;
+    private static readonly NOISY_CDP_EVENTS;
     private static logCdpEvent;
-    static logCdpCallEvent(data: {
+    static logCdpCallEvent(context: FlowLoggerContext, data: {
         method: string;
         params?: object;
         targetId?: string | null;
-    }, ctx?: FlowLoggerContext | null): void;
-    static logCdpMessageEvent(data: {
+    }): FlowEvent | null;
+    static logCdpResponseEvent(context: FlowLoggerContext, parentEvent: Pick<FlowEvent, "eventId" | "eventParentIds">, data: {
+        method: string;
+        result?: unknown;
+        error?: string;
+        targetId?: string | null;
+    }): void;
+    static logCdpMessageEvent(context: FlowLoggerContext, parentEvent: Pick<FlowEvent, "eventId" | "eventParentIds">, data: {
         method: string;
         params?: unknown;
         targetId?: string | null;
-    }, ctx?: FlowLoggerContext | null): void;
+    }): void;
     static logLlmRequest({ requestId, model, prompt, }: {
         requestId: string;
         model: string;
-        operation: string;
         prompt?: string;
-    }, explicitCtx?: FlowLoggerContext | null): void;
+    }): void;
     static logLlmResponse({ requestId, model, output, inputTokens, outputTokens, }: {
         requestId: string;
         model: string;
-        operation: string;
         output?: string;
         inputTokens?: number;
         outputTokens?: number;
-    }, explicitCtx?: FlowLoggerContext | null): void;
+    }): void;
     /**
      * Create middleware for wrapping language models with LLM call logging.
      * Returns a no-op middleware when logging is disabled.
@@ -126,14 +78,21 @@ export declare class SessionFileLogger {
     static createLlmLoggingMiddleware(modelId: string): Pick<LanguageModelMiddleware, "wrapGenerate">;
 }
 /**
- * Method decorator for logging understudy actions with automatic start/complete.
- * Logs all arguments automatically. No-op when CONFIG_DIR is empty.
+ * Format a prompt summary from LLM messages for logging.
+ * Returns format like: "some text +{5.8kb image} +{schema} +{12 tools}"
  */
-export declare function logAction(actionType: string): <T extends (...args: never[]) => Promise<unknown>>(originalMethod: T) => T;
+export declare function extractLlmPromptSummary(messages: Array<{
+    role: string;
+    content: unknown;
+}>, options?: {
+    toolCount?: number;
+    hasSchema?: boolean;
+}): string | undefined;
 /**
- * Method decorator for logging Stagehand step events (act, extract, observe).
- * Only adds logging - does NOT wrap with withInstanceLogContext (caller handles that).
- * No-op when CONFIG_DIR is empty.
+ * Extract a text summary from CUA-style messages.
+ * Accepts various message formats (Anthropic, OpenAI, Google).
  */
-export declare function logStagehandStep(invocation: string, label: string): <T extends (...args: never[]) => Promise<unknown>>(originalMethod: T) => T;
+export declare function extractLlmCuaPromptSummary(messages: unknown[]): string | undefined;
+/** Format a CUA response summary for logging */
+export declare function extractLlmCuaResponseSummary(output: unknown): string;
 export {};