@tangle-network/browser-agent-driver 0.15.0 → 0.16.0

package/dist/runner/events.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Turn event bus — typed pub/sub for sub-turn agent events.
+ *
+ * The agent loop emits events at every phase boundary so subscribers can
+ * observe (live viewer SSE), persist (events.jsonl sink), and react (user
+ * extensions). All three consume the same event stream.
+ *
+ * Design decisions:
+ *   - In-process only. Cross-process is the SSE server's job, not the bus.
+ *   - Bounded retention (last N events buffered for late subscribers).
+ *   - Synchronous fanout. Listeners that need async work do it themselves.
+ *   - Listener errors are caught and logged — one bad subscriber must not
+ *     crash the loop.
+ *   - Each event is plain JSON-serializable (no class instances, no Buffers).
+ *     This is so events.jsonl can serialize them without surgery.
+ *
+ * The Turn type from ../types.ts is the COMPLETED-turn artifact (what
+ * `onTurn` callbacks consume). TurnEvent is the live, sub-turn stream.
+ */
+import type { Action, PageState, Turn } from '../types.js';
+/** A discriminated union of every event the runner emits. */
+export type TurnEvent = RunStartedEvent | TurnStartedEvent | ObserveStartedEvent | ObserveCompletedEvent | DecideStartedEvent | DecideTokenEvent | DecideCompletedEvent | DecideSkippedCachedEvent | DecideSkippedPatternEvent | ExecuteStartedEvent | ExecuteCompletedEvent | VerifyStartedEvent | VerifyCompletedEvent | RecoveryFiredEvent | OverrideAppliedEvent | TurnCompletedEvent | RunCompletedEvent;
+interface BaseEvent {
+    /** Monotonic sequence number, assigned by the bus on emit */
+    seq: number;
+    /** ISO 8601 timestamp */
+    ts: string;
+    /** The agent run ID this event belongs to */
+    runId: string;
+    /** 1-indexed turn number, or 0 for run-level events */
+    turn: number;
+}
+export interface RunStartedEvent extends BaseEvent {
+    type: 'run-started';
+    goal: string;
+    startUrl?: string;
+    maxTurns: number;
+}
+export interface TurnStartedEvent extends BaseEvent {
+    type: 'turn-started';
+}
+export interface ObserveStartedEvent extends BaseEvent {
+    type: 'observe-started';
+}
+export interface ObserveCompletedEvent extends BaseEvent {
+    type: 'observe-completed';
+    url: string;
+    title: string;
+    /** Snapshot byte length (don't send the snapshot itself — too big for the wire) */
+    snapshotBytes: number;
+    /** Latest screenshot as a data URL, when vision is on */
+    screenshot?: string;
+    durationMs: number;
+}
+export interface DecideStartedEvent extends BaseEvent {
+    type: 'decide-started';
+}
+/** Emitted while the LLM is streaming tokens, for the live viewer's spinner. */
+export interface DecideTokenEvent extends BaseEvent {
+    type: 'decide-token';
+    /** Cumulative tokens emitted so far (not the latest token text). */
+    tokenCount: number;
+}
+export interface DecideCompletedEvent extends BaseEvent {
+    type: 'decide-completed';
+    action: Action;
+    reasoning?: string;
+    expectedEffect?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheReadInputTokens?: number;
+    durationMs: number;
+}
+/** The decision was served from the in-session cache; no LLM call fired. */
+export interface DecideSkippedCachedEvent extends BaseEvent {
+    type: 'decide-skipped-cached';
+    action: Action;
+    /** SHA1 hash of the state key that hit */
+    cacheKey: string;
+}
+/** A deterministic UI pattern matched; no LLM call fired. */
+export interface DecideSkippedPatternEvent extends BaseEvent {
+    type: 'decide-skipped-pattern';
+    action: Action;
+    patternId: string;
+}
+export interface ExecuteStartedEvent extends BaseEvent {
+    type: 'execute-started';
+    action: Action;
+}
+export interface ExecuteCompletedEvent extends BaseEvent {
+    type: 'execute-completed';
+    action: Action;
+    success: boolean;
+    error?: string;
+    /** Bounding box of the target element, when known (for replay overlays) */
+    bounds?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    durationMs: number;
+}
+export interface VerifyStartedEvent extends BaseEvent {
+    type: 'verify-started';
+    expectedEffect: string;
+}
+export interface VerifyCompletedEvent extends BaseEvent {
+    type: 'verify-completed';
+    verified: boolean;
+    reason?: string;
+    durationMs: number;
+}
+export interface RecoveryFiredEvent extends BaseEvent {
+    type: 'recovery-fired';
+    strategy: string;
+    feedback: string;
+    forcedAction?: string;
+}
+export interface OverrideAppliedEvent extends BaseEvent {
+    type: 'override-applied';
+    source: 'override-pipeline' | 'extension';
+    reasoningTag: string;
+    feedback: string;
+}
+export interface TurnCompletedEvent extends BaseEvent {
+    type: 'turn-completed';
+    /** The full Turn artifact, ready for persistence */
+    turnArtifact: Turn;
+}
+export interface RunCompletedEvent extends BaseEvent {
+    type: 'run-completed';
+    success: boolean;
+    totalTurns: number;
+    totalMs: number;
+    reason?: string;
+}
+export type TurnEventListener = (event: TurnEvent) => void;
+export interface TurnEventBusOptions {
+    /** Max events retained for late subscribers. Default 200. */
+    retention?: number;
+    /** Logger for listener errors. Default console.error. */
+    onListenerError?: (err: unknown, listener: TurnEventListener) => void;
+}
+/**
+ * In-process typed pub/sub for TurnEvents.
+ *
+ * Subscribers receive every event after subscription, plus a buffered
+ * replay of the last N events (default 200) so a late-attaching SSE
+ * client can catch up without missing context.
+ */
+export declare class TurnEventBus {
+    private listeners;
+    private buffer;
+    private nextSeq;
+    private readonly retention;
+    private readonly onListenerError;
+    constructor(options?: TurnEventBusOptions);
+    /**
+     * Emit an event. Synchronously fans out to all listeners. Listener errors
+     * are caught — one bad subscriber must not crash the loop.
+     *
+     * The caller supplies the event without `seq` — the bus assigns it.
+     *
+     * The generic `E extends TurnEvent` form makes TypeScript distribute the
+     * `Omit` across the union so each call site sees the right per-variant
+     * shape. Without it, `Omit<TurnEvent, ...>` collapses to the intersection
+     * of all variants, which is just the BaseEvent fields.
+     */
+    emit<E extends TurnEvent>(event: DistributiveOmit<E, 'seq'>): void;
+    /**
+     * Subscribe to all future events. Returns an unsubscribe function.
+     *
+     * If `replayBuffered` is true (default), the new listener immediately
+     * receives every event currently in the retention buffer in order. This
+     * lets late subscribers (e.g., a viewer that connects mid-run) reconstruct
+     * recent state without missing anything.
+     */
+    subscribe(listener: TurnEventListener, replayBuffered?: boolean): () => void;
+    /** Snapshot the current buffer (for tests / debugging). */
+    getBuffered(): TurnEvent[];
+    /** Drop all buffered events. Listeners are NOT removed. */
+    clearBuffer(): void;
+    /** Number of currently subscribed listeners. */
+    get listenerCount(): number;
+    /** Helper for the runner: emit with an auto-filled timestamp. */
+    emitNow<E extends TurnEvent>(event: DistributiveOmit<E, 'seq' | 'ts'>): void;
+}
+/**
+ * Distributive Omit — applies `Omit` across each variant of a union type
+ * separately, so per-variant fields survive narrowing. Standard `Omit` on a
+ * union would collapse to the intersection of property keys (the common
+ * fields only), losing the discriminant.
+ */
+type DistributiveOmit<T, K extends keyof TurnEvent> = T extends unknown ? Omit<T, K> : never;
+/**
+ * Stable JSON serialization of a TurnEvent for events.jsonl persistence.
+ * The event is already plain JSON, but we drop the (potentially large)
+ * screenshot data URL when persisting — replay reads it from the per-turn
+ * report.json instead.
+ */
+export declare function serializeForJsonl(event: TurnEvent): string;
+/**
+ * Type guard for narrowing TurnEvent unions in subscribers.
+ *
+ *   bus.subscribe((e) => {
+ *     if (isEvent(e, 'execute-completed') && !e.success) {
+ *       // e is now narrowed
+ *     }
+ *   })
+ */
+export declare function isEvent<T extends TurnEvent['type']>(event: TurnEvent, type: T): event is Extract<TurnEvent, {
+    type: T;
+}>;
+/** Build a no-op bus for tests / contexts that don't need eventing. */
+export declare function createNullBus(): TurnEventBus;
+/**
+ * Lazy-init helper: returns the provided bus or constructs a no-op bus.
+ * Used by the runner so callers can opt out by passing nothing.
+ */
+export declare function ensureBus(bus?: TurnEventBus): TurnEventBus;
+export type { PageState };
+//# sourceMappingURL=events.d.ts.map

package/dist/runner/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/runner/events.ts"],"names":[],"mappings":"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"}

package/dist/runner/events.js

@@ -0,0 +1,147 @@
+/**
+ * Turn event bus — typed pub/sub for sub-turn agent events.
+ *
+ * The agent loop emits events at every phase boundary so subscribers can
+ * observe (live viewer SSE), persist (events.jsonl sink), and react (user
+ * extensions). All three consume the same event stream.
+ *
+ * Design decisions:
+ *   - In-process only. Cross-process is the SSE server's job, not the bus.
+ *   - Bounded retention (last N events buffered for late subscribers).
+ *   - Synchronous fanout. Listeners that need async work do it themselves.
+ *   - Listener errors are caught and logged — one bad subscriber must not
+ *     crash the loop.
+ *   - Each event is plain JSON-serializable (no class instances, no Buffers).
+ *     This is so events.jsonl can serialize them without surgery.
+ *
+ * The Turn type from ../types.ts is the COMPLETED-turn artifact (what
+ * `onTurn` callbacks consume). TurnEvent is the live, sub-turn stream.
+ */
+/**
+ * In-process typed pub/sub for TurnEvents.
+ *
+ * Subscribers receive every event after subscription, plus a buffered
+ * replay of the last N events (default 200) so a late-attaching SSE
+ * client can catch up without missing context.
+ */
+export class TurnEventBus {
+    listeners = new Set();
+    buffer = [];
+    nextSeq = 1;
+    retention;
+    onListenerError;
+    constructor(options = {}) {
+        this.retention = options.retention ?? 200;
+        this.onListenerError = options.onListenerError ?? ((err, _) => {
+            // eslint-disable-next-line no-console
+            console.error('[TurnEventBus] listener threw:', err);
+        });
+    }
+    /**
+     * Emit an event. Synchronously fans out to all listeners. Listener errors
+     * are caught — one bad subscriber must not crash the loop.
+     *
+     * The caller supplies the event without `seq` — the bus assigns it.
+     *
+     * The generic `E extends TurnEvent` form makes TypeScript distribute the
+     * `Omit` across the union so each call site sees the right per-variant
+     * shape. Without it, `Omit<TurnEvent, ...>` collapses to the intersection
+     * of all variants, which is just the BaseEvent fields.
+     */
+    emit(event) {
+        const full = { ...event, seq: this.nextSeq++ };
+        this.buffer.push(full);
+        if (this.buffer.length > this.retention) {
+            this.buffer.shift();
+        }
+        for (const listener of this.listeners) {
+            try {
+                listener(full);
+            }
+            catch (err) {
+                this.onListenerError(err, listener);
+            }
+        }
+    }
+    /**
+     * Subscribe to all future events. Returns an unsubscribe function.
+     *
+     * If `replayBuffered` is true (default), the new listener immediately
+     * receives every event currently in the retention buffer in order. This
+     * lets late subscribers (e.g., a viewer that connects mid-run) reconstruct
+     * recent state without missing anything.
+     */
+    subscribe(listener, replayBuffered = true) {
+        if (replayBuffered) {
+            for (const event of this.buffer) {
+                try {
+                    listener(event);
+                }
+                catch (err) {
+                    this.onListenerError(err, listener);
+                }
+            }
+        }
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** Snapshot the current buffer (for tests / debugging). */
+    getBuffered() {
+        return [...this.buffer];
+    }
+    /** Drop all buffered events. Listeners are NOT removed. */
+    clearBuffer() {
+        this.buffer = [];
+    }
+    /** Number of currently subscribed listeners. */
+    get listenerCount() {
+        return this.listeners.size;
+    }
+    /** Helper for the runner: emit with an auto-filled timestamp. */
+    emitNow(event) {
+        // The cast is safe: E extends TurnEvent and we're adding the missing
+        // ts field. The discriminated union narrowing happens at the call site.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.emit({ ...event, ts: new Date().toISOString() });
+    }
+}
+// ── Utilities ───────────────────────────────────────────────────────────
+/**
+ * Stable JSON serialization of a TurnEvent for events.jsonl persistence.
+ * The event is already plain JSON, but we drop the (potentially large)
+ * screenshot data URL when persisting — replay reads it from the per-turn
+ * report.json instead.
+ */
+export function serializeForJsonl(event) {
+    if (event.type === 'observe-completed' && event.screenshot) {
+        const { screenshot: _screenshot, ...rest } = event;
+        return JSON.stringify(rest);
+    }
+    return JSON.stringify(event);
+}
+/**
+ * Type guard for narrowing TurnEvent unions in subscribers.
+ *
+ *   bus.subscribe((e) => {
+ *     if (isEvent(e, 'execute-completed') && !e.success) {
+ *       // e is now narrowed
+ *     }
+ *   })
+ */
+export function isEvent(event, type) {
+    return event.type === type;
+}
+/** Build a no-op bus for tests / contexts that don't need eventing. */
+export function createNullBus() {
+    return new TurnEventBus({ retention: 0 });
+}
+/**
+ * Lazy-init helper: returns the provided bus or constructs a no-op bus.
+ * Used by the runner so callers can opt out by passing nothing.
+ */
+export function ensureBus(bus) {
+    return bus ?? createNullBus();
+}
+//# sourceMappingURL=events.js.map

package/dist/runner/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/runner/events.ts"],"names":[],"mappings":"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"}

package/dist/runner/runner.d.ts

@@ -13,6 +13,8 @@ import type { Driver } from '../drivers/types.js';
 import type { Scenario, AgentConfig, AgentResult, Turn } from '../types.js';
 import type { ProjectStore } from '../memory/project-store.js';
 import { RunRegistry } from '../memory/run-registry.js';
+import { TurnEventBus } from './events.js';
+import type { ResolvedExtensions } from '../extensions/types.js';
 export interface BrowserAgentOptions {
     driver: Driver;
     config?: AgentConfig;
@@ -26,6 +28,22 @@ export interface BrowserAgentOptions {
     projectStore?: ProjectStore;
     /** Run registry for orchestration-facing manifests */
     runRegistry?: RunRegistry;
+    /**
+     * Optional TurnEventBus for sub-turn observability. The runner emits events
+     * at every phase boundary (observe-start/end, decide-start/end, execute,
+     * verify, recovery, override, turn-start/end). When omitted, a no-op bus is
+     * used so existing call sites are unchanged.
+     *
+     * Subscribers: live SSE viewer, events.jsonl persistence, user extensions.
+     */
+    eventBus?: TurnEventBus;
+    /**
+     * Pre-resolved user extensions (loaded from bad.config.{js,mjs,ts} or via
+     * --extension flags). The runner subscribes them to the event bus, applies
+     * mutateDecision after the LLM decide step, and forwards rule additions to
+     * the brain's system prompt composer.
+     */
+    extensions?: ResolvedExtensions;
 }
 export declare class BrowserAgent {
     private driver;
@@ -39,6 +57,10 @@ export declare class BrowserAgent {
     private knowledge?;
     private selectorCache?;
     private cachedPostState;
+    private bus;
+    private currentRunId;
+    private decisionCache?;
+    private extensions?;
     constructor(options: BrowserAgentOptions);
     run(scenario: Scenario): Promise<AgentResult>;
     private selectFollowUpActions;

package/dist/runner/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAuC,MAAM,aAAa,CAAC;AAKjH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAsB/D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA0CxD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC9B,wDAAwD;IACxD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACnG,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sDAAsD;IACtD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAuB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAqF;IAC3G,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,SAAS,CAAC,CAAe;IACjC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,eAAe,CAAwB;gBAEnC,OAAO,EAAE,mBAAmB;IAWlC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IAmuCnD,OAAO,CAAC,qBAAqB;IA2B7B,qEAAqE;IACrE,OAAO,CAAC,UAAU;IAclB;;;;;;;;;;;;OAYG;YACW,YAAY;YAkCZ,+BAA+B;YAgE/B,mCAAmC;YAwCnC,6BAA6B;YA4C7B,qCAAqC;YAqBrC,4BAA4B;YA4B5B,4BAA4B;YAkC5B,wBAAwB;CASvC;AAED,2BAA2B;AAC3B,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAC5C,OAAO,CAAC,WAAW,CAAC,CAGtB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAuC,MAAM,aAAa,CAAC;AAKjH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAsB/D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AAGtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AA0CjE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC9B,wDAAwD;IACxD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACnG,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sDAAsD;IACtD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAuB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAqF;IAC3G,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,SAAS,CAAC,CAAe;IACjC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,YAAY,CAAM;IAK1B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAqB;gBAE5B,OAAO,EAAE,mBAAmB;IAyBlC,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;IAm9CnD,OAAO,CAAC,qBAAqB;IA2B7B,qEAAqE;IACrE,OAAO,CAAC,UAAU;IAclB;;;;;;;;;;;;OAYG;YACW,YAAY;YAkCZ,+BAA+B;YAgE/B,mCAAmC;YAwCnC,6BAA6B;YA4C7B,qCAAqC;YAqBrC,4BAA4B;YA4B5B,4BAA4B;YAkC5B,wBAAwB;CASvC;AAED,2BAA2B;AAC3B,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAC5C,OAAO,CAAC,WAAW,CAAC,CAGtB"}