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

package/dist/esm/lib/v3/flowlogger/EventStore.js

@@ -0,0 +1,127 @@
+import fs from "node:fs";
+import path from "node:path";
+import { JsonlFileEventSink, PrettyLogFileEventSink, PrettyStderrEventSink, ShallowInMemoryEventSink, } from "./EventSink.js";
+import { FlowEvent } from "./FlowLogger.js";
+const DEFAULT_IN_MEMORY_EVENT_LIMIT = 500; // Per-session ancestry window retained by the default shallow query sink.
+const CONFIG_DIR = process.env.BROWSERBASE_CONFIG_DIR || ""; // Base directory for session metadata + file-backed flow logs.
+const FLOW_LOGS_ENABLED = process.env.BROWSERBASE_FLOW_LOGS === "1"; // Force-enables the pretty stderr flow sink even when `verbose !== 2`.
+const SENSITIVE_KEYS = /key|secret|token|api-key|apikey|api_key|password|passwd|pwd|credential|auth/i; // Redacts obvious secrets before session options are written to disk.
+// =============================================================================
+// Filesystem Helpers
+// =============================================================================
+// Redacts secrets before session options are written to `session.json` inside a config-dir-backed session directory.
+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 });
+}
+// Resolves the configured Browserbase config directory used by file sinks.
+export function getConfigDir() {
+    return CONFIG_DIR ? path.resolve(CONFIG_DIR) : "";
+}
+// Creates the per-session directory used by file sinks and writes best-effort metadata such as the sanitized `session.json` file and `latest` symlink.
+async function createSessionDir(sessionId, options) {
+    const configDir = getConfigDir();
+    if (!configDir) {
+        return null;
+    }
+    const sessionDir = path.join(configDir, "sessions", sessionId);
+    await fs.promises.mkdir(sessionDir, { recursive: true });
+    if (options) {
+        await fs.promises.writeFile(path.join(sessionDir, "session.json"), JSON.stringify(sanitizeOptions(options), null, 2), "utf-8");
+    }
+    const latestLink = path.join(configDir, "sessions", "latest");
+    try {
+        try {
+            await fs.promises.unlink(latestLink);
+        }
+        catch {
+            // ignore missing link
+        }
+        await fs.promises.symlink(sessionId, latestLink, "dir");
+    }
+    catch {
+        // symlink best effort only
+    }
+    return sessionDir;
+}
+// =============================================================================
+// Event Store
+// =============================================================================
+// Per-session flow event sink manager.
+// This is not an event bus. V3 forwards already-emitted FlowEvents into it so
+// the store can fan them out to configured sinks, answer `query()` calls from
+// its one query sink, and tear down its sinks when the session closes.
+// We keep this as a separate object instead of wiring sinks directly with
+// `v3.bus.on("*", sink.emit)` because pretty sinks need access to a shared
+// query interface while rendering. Prettified lines often need to look up
+// related parent/child events to recover the readable ancestry tags and labels.
+// Passing sinks into each other to share that state gets messy quickly, so the
+// EventStore contains the circular dependency: all sinks live here, and any
+// sink that needs historical context can call the one `EventStore.query()`
+// entrypoint backed by the main query sink for this session.
+export class EventStore {
+    sessionId;
+    sinks = new Set(); // All sinks attached for this session; constructor registers them here and `destroy()` tears them down.
+    destroyed = false; // Flipped by `destroy()` so later emits and teardown calls become no-ops.
+    query; // Always reads from the one query sink chosen at construction time.
+    // Creates the per-instance store owned by a single V3 session. This store is intentionally single-session; it ignores events for other session ids.
+    constructor(
+    // Usually matches `browserbaseSessionId` today, but it is the store's own Stagehand session identifier and may diverge in the future.
+    sessionId, options, querySink = new ShallowInMemoryEventSink(DEFAULT_IN_MEMORY_EVENT_LIMIT)) {
+        this.sessionId = sessionId;
+        const sessionDirPromise = createSessionDir(sessionId, options);
+        this.registerSink(querySink);
+        this.query = async (query) => {
+            if (query.sessionId && query.sessionId !== this.sessionId) {
+                return [];
+            }
+            return querySink.query({
+                ...query,
+                sessionId: this.sessionId,
+            });
+        };
+        if (getConfigDir()) {
+            this.registerSink(new JsonlFileEventSink(sessionDirPromise));
+            this.registerSink(new PrettyLogFileEventSink(sessionDirPromise, this));
+        }
+        if (options?.verbose === 2 || FLOW_LOGS_ENABLED) {
+            this.registerSink(new PrettyStderrEventSink(this));
+        }
+    }
+    // Adds a sink to the direct fanout list used by `emit()`.
+    registerSink(sink) {
+        this.sinks.add(sink);
+    }
+    // Emits an event to all attached sinks when it belongs to this store's single session.
+    emit = async (event) => {
+        if (!(event instanceof FlowEvent)) {
+            return;
+        }
+        if (this.destroyed || event.sessionId !== this.sessionId) {
+            return;
+        }
+        await Promise.allSettled([...this.sinks].map((sink) => sink.emit(event)));
+    };
+    // Tears down all sinks when the V3 instance is closed.
+    async destroy() {
+        if (this.destroyed) {
+            return;
+        }
+        this.destroyed = true;
+        await Promise.all([...this.sinks].map((sink) => sink.destroy().catch(() => {
+            // best effort cleanup
+        })));
+        this.sinks.clear();
+    }
+}
+//# sourceMappingURL=EventStore.js.map

package/dist/esm/lib/v3/flowlogger/EventStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventStore.js","sourceRoot":"","sources":["../../../../../lib/v3/flowlogger/EventStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAEL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,6BAA6B,GAAG,GAAG,CAAC,CAAC,0EAA0E;AACrH,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,+DAA+D;AAC5H,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,CAAC,CAAC,uEAAuE;AAC5I,MAAM,cAAc,GAClB,8EAA8E,CAAC,CAAC,sEAAsE;AAoBxJ,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,qHAAqH;AACrH,SAAS,eAAe,CAAC,OAAkB;IACzC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAW,EAAE;QAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAErD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,CAA4B,CAAC;AAC7D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,uJAAuJ;AACvJ,KAAK,UAAU,gBAAgB,CAC7B,SAAiB,EACjB,OAAmB;IAEnB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CACzB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EACrC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EACjD,OAAO,CACR,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,uCAAuC;AACvC,8EAA8E;AAC9E,8EAA8E;AAC9E,uEAAuE;AACvE,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAC1E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,6DAA6D;AAC7D,MAAM,OAAO,UAAU;IAQH;IAPD,KAAK,GAAG,IAAI,GAAG,EAAa,CAAC,CAAC,wGAAwG;IAC/I,SAAS,GAAG,KAAK,CAAC,CAAC,0EAA0E;IAC9F,KAAK,CAAmD,CAAC,oEAAoE;IAEpI,oJAAoJ;IACpJ;IACE,sIAAsI;IACtH,SAAiB,EACjC,OAAmB,EACnB,YAAuB,IAAI,wBAAwB,CACjD,6BAA6B,CAC9B;QAJe,cAAS,GAAT,SAAS,CAAQ;QAMjC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE/D,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE;YAC3B,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1D,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,SAAS,CAAC,KAAK,CAAC;gBACrB,GAAG,KAAK;gBACR,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,IAAI,YAAY,EAAE,EAAE,CAAC;YACnB,IAAI,CAAC,YAAY,CAAC,IAAI,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC;YAC7D,IAAI,CAAC,YAAY,CAAC,IAAI,sBAAsB,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,OAAO,EAAE,OAAO,KAAK,CAAC,IAAI,iBAAiB,EAAE,CAAC;YAChD,IAAI,CAAC,YAAY,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,0DAA0D;IAClD,YAAY,CAAC,IAAe;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,uFAAuF;IACvF,IAAI,GAAG,KAAK,EAAE,KAAgB,EAAiB,EAAE;QAC/C,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YACzD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC;IAEF,uDAAuD;IACvD,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3B,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;YACxB,sBAAsB;QACxB,CAAC,CAAC,CACH,CACF,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { V3Options } from \"../types/public/index.js\";\nimport {\n  EventSink,\n  JsonlFileEventSink,\n  PrettyLogFileEventSink,\n  PrettyStderrEventSink,\n  ShallowInMemoryEventSink,\n} from \"./EventSink.js\";\nimport { FlowEvent } from \"./FlowLogger.js\";\n\nconst DEFAULT_IN_MEMORY_EVENT_LIMIT = 500; // Per-session ancestry window retained by the default shallow query sink.\nconst CONFIG_DIR = process.env.BROWSERBASE_CONFIG_DIR || \"\"; // Base directory for session metadata + file-backed flow logs.\nconst FLOW_LOGS_ENABLED = process.env.BROWSERBASE_FLOW_LOGS === \"1\"; // Force-enables the pretty stderr flow sink even when `verbose !== 2`.\nconst SENSITIVE_KEYS =\n  /key|secret|token|api-key|apikey|api_key|password|passwd|pwd|credential|auth/i; // Redacts obvious secrets before session options are written to disk.\n\n// =============================================================================\n// Public Contracts\n// =============================================================================\n\nexport interface EventStoreQuery {\n  sessionId?: string;\n  eventId?: string;\n  eventType?: string;\n  limit?: number;\n}\n\nexport interface EventStoreApi {\n  readonly sessionId: string;\n  emit(event: FlowEvent): Promise<void>;\n  query(query: EventStoreQuery): Promise<FlowEvent[]>;\n  destroy(): Promise<void>;\n}\n\n// =============================================================================\n// Filesystem Helpers\n// =============================================================================\n\n// Redacts secrets before session options are written to `session.json` inside a config-dir-backed session directory.\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\n// Resolves the configured Browserbase config directory used by file sinks.\nexport function getConfigDir(): string {\n  return CONFIG_DIR ? path.resolve(CONFIG_DIR) : \"\";\n}\n\n// Creates the per-session directory used by file sinks and writes best-effort metadata such as the sanitized `session.json` file and `latest` symlink.\nasync function createSessionDir(\n  sessionId: string,\n  options?: V3Options,\n): Promise<string | null> {\n  const configDir = getConfigDir();\n  if (!configDir) {\n    return null;\n  }\n\n  const sessionDir = path.join(configDir, \"sessions\", sessionId);\n  await fs.promises.mkdir(sessionDir, { recursive: true });\n\n  if (options) {\n    await fs.promises.writeFile(\n      path.join(sessionDir, \"session.json\"),\n      JSON.stringify(sanitizeOptions(options), null, 2),\n      \"utf-8\",\n    );\n  }\n\n  const latestLink = path.join(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(sessionId, latestLink, \"dir\");\n  } catch {\n    // symlink best effort only\n  }\n\n  return sessionDir;\n}\n\n// =============================================================================\n// Event Store\n// =============================================================================\n\n// Per-session flow event sink manager.\n// This is not an event bus. V3 forwards already-emitted FlowEvents into it so\n// the store can fan them out to configured sinks, answer `query()` calls from\n// its one query sink, and tear down its sinks when the session closes.\n// We keep this as a separate object instead of wiring sinks directly with\n// `v3.bus.on(\"*\", sink.emit)` because pretty sinks need access to a shared\n// query interface while rendering. Prettified lines often need to look up\n// related parent/child events to recover the readable ancestry tags and labels.\n// Passing sinks into each other to share that state gets messy quickly, so the\n// EventStore contains the circular dependency: all sinks live here, and any\n// sink that needs historical context can call the one `EventStore.query()`\n// entrypoint backed by the main query sink for this session.\nexport class EventStore implements EventStoreApi {\n  private readonly sinks = new Set<EventSink>(); // All sinks attached for this session; constructor registers them here and `destroy()` tears them down.\n  private destroyed = false; // Flipped by `destroy()` so later emits and teardown calls become no-ops.\n  public query: (query: EventStoreQuery) => Promise<FlowEvent[]>; // Always reads from the one query sink chosen at construction time.\n\n  // Creates the per-instance store owned by a single V3 session. This store is intentionally single-session; it ignores events for other session ids.\n  constructor(\n    // Usually matches `browserbaseSessionId` today, but it is the store's own Stagehand session identifier and may diverge in the future.\n    public readonly sessionId: string,\n    options?: V3Options,\n    querySink: EventSink = new ShallowInMemoryEventSink(\n      DEFAULT_IN_MEMORY_EVENT_LIMIT,\n    ),\n  ) {\n    const sessionDirPromise = createSessionDir(sessionId, options);\n\n    this.registerSink(querySink);\n    this.query = async (query) => {\n      if (query.sessionId && query.sessionId !== this.sessionId) {\n        return [];\n      }\n\n      return querySink.query({\n        ...query,\n        sessionId: this.sessionId,\n      });\n    };\n\n    if (getConfigDir()) {\n      this.registerSink(new JsonlFileEventSink(sessionDirPromise));\n      this.registerSink(new PrettyLogFileEventSink(sessionDirPromise, this));\n    }\n\n    if (options?.verbose === 2 || FLOW_LOGS_ENABLED) {\n      this.registerSink(new PrettyStderrEventSink(this));\n    }\n  }\n\n  // Adds a sink to the direct fanout list used by `emit()`.\n  private registerSink(sink: EventSink): void {\n    this.sinks.add(sink);\n  }\n\n  // Emits an event to all attached sinks when it belongs to this store's single session.\n  emit = async (event: FlowEvent): Promise<void> => {\n    if (!(event instanceof FlowEvent)) {\n      return;\n    }\n\n    if (this.destroyed || event.sessionId !== this.sessionId) {\n      return;\n    }\n\n    await Promise.allSettled([...this.sinks].map((sink) => sink.emit(event)));\n  };\n\n  // Tears down all sinks when the V3 instance is closed.\n  async destroy(): Promise<void> {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.destroyed = true;\n    await Promise.all(\n      [...this.sinks].map((sink) =>\n        sink.destroy().catch(() => {\n          // best effort cleanup\n        }),\n      ),\n    );\n    this.sinks.clear();\n  }\n}\n"]}

package/dist/esm/lib/v3/flowlogger/FlowLogger.d.ts

@@ -0,0 +1,99 @@
+import type { LanguageModelMiddleware } from "ai";
+import { z } from "zod";
+import { EventEmitterWithWildcardSupport } from "./EventEmitter.js";
+export declare const FlowEventDataSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const FlowEventInputSchema: z.ZodObject<{
+    eventType: z.ZodString;
+    eventId: z.ZodOptional<z.ZodString>;
+    eventParentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    eventCreatedAt: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type FlowEventData = z.infer<typeof FlowEventDataSchema>;
+export type FlowEventInput = z.input<typeof FlowEventInputSchema>;
+type FlowEventFields = Omit<FlowEventInput, "eventId" | "eventParentIds" | "eventCreatedAt" | "sessionId" | "data"> & {
+    eventId: string;
+    eventParentIds: string[];
+    eventCreatedAt: string;
+    sessionId: string;
+    data: FlowEventData;
+};
+export declare class FlowEvent implements FlowEventFields {
+    private static deriveEventIdSuffix;
+    static createEventId(eventType: string): string;
+    eventType: string;
+    eventId: string;
+    eventParentIds: string[];
+    eventCreatedAt: string;
+    sessionId: string;
+    data: FlowEventData;
+    constructor(input: FlowEventInput);
+}
+export interface FlowLoggerContext {
+    sessionId: string;
+    eventBus: EventEmitterWithWildcardSupport;
+    parentEvents: FlowEvent[];
+}
+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 resolveReentryContext;
+    private static emit;
+    private static runWithAutoStatusEventLogging;
+    private static logCdpEvent;
+    private static emitLlmEvent;
+    private static buildMiddlewarePromptSummary;
+    private static buildMiddlewareOutputSummary;
+    static init(sessionId: string, eventBus: EventEmitterWithWildcardSupport): FlowLoggerContext;
+    static close(context?: FlowLoggerContext | null): Promise<void>;
+    static get currentContext(): FlowLoggerContext;
+    static resolveContext(fallbackContext?: FlowLoggerContext | null): FlowLoggerContext | null;
+    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>>;
+    static withContext<T>(context: FlowLoggerContext, fn: () => T): T;
+    private static readonly NOISY_CDP_EVENTS;
+    static logCdpCallEvent(context: FlowLoggerContext, data: {
+        method: string;
+        params?: object;
+        targetId?: string | null;
+    }): 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;
+    }): void;
+    static logLlmRequest({ requestId, model, prompt, }: {
+        requestId: string;
+        model: string;
+        prompt?: string;
+    }): void;
+    static logLlmResponse({ requestId, model, output, inputTokens, outputTokens, }: {
+        requestId: string;
+        model: string;
+        output?: string;
+        inputTokens?: number;
+        outputTokens?: number;
+    }): void;
+    static createLlmLoggingMiddleware(modelId: string): Pick<LanguageModelMiddleware, "wrapGenerate">;
+}
+export declare function extractLlmPromptSummary(messages: Array<{
+    role: string;
+    content: unknown;
+}>, options?: {
+    toolCount?: number;
+    hasSchema?: boolean;
+}): string | undefined;
+export declare function extractLlmCuaPromptSummary(messages: unknown[]): string | undefined;
+export declare function extractLlmCuaResponseSummary(output: unknown): string;
+export {};