@alfe.ai/browser 0.2.0 → 0.2.1

package/dist/index.d.cts

@@ -125,16 +125,11 @@ interface BrowserSessionOptions {
   idleShutdownMs?: number;
   /** Extra Chrome args. */
   extraArgs?: string[];
-  logger?: Logger;
-}
-interface BrowserSurfaceOptions extends BrowserSessionOptions {
-  /**
-   * Guard consulted before agent-driven or human navigation. Return false to
-   * block (SSRF policy). Defaults to allow-all; Phase 11 wires the integration
-   * SSRF allowlist here.
-   */
+  /** Guard applied to every intercepted HTTP(S) page request. */
   isNavigationAllowed?: (url: string) => boolean;
+  logger?: Logger;
 }
+type BrowserSurfaceOptions = BrowserSessionOptions;
 //#endregion
 //#region src/browser-session.d.ts
 declare class BrowserSession {
@@ -144,6 +139,9 @@ declare class BrowserSession {
   private launching;
   private holds;
   private idleTimer;
+  private generation;
+  private readonly preparedPages;
+  private readonly activePageListeners;
   private readonly log;
   private readonly idleMs;
   constructor(options: BrowserSessionOptions);
@@ -158,6 +156,7 @@ declare class BrowserSession {
   private adoptIfNavigable;
   /** The current active page, launching Chrome first if needed. */
   getActivePage(): Promise<Page>;
+  onActivePageChange(listener: (page: Page) => void | Promise<void>): () => void;
   /** Prevent idle shutdown while a viewer or op is active. */
   addHold(): void;
   /** Release a hold; arm idle shutdown when the last one is released. */
@@ -167,6 +166,9 @@ declare class BrowserSession {
   private armIdleTimer;
   private clearIdleTimer;
   shutdown(): Promise<void>;
+  private setActivePage;
+  private preparePage;
+  private isLaunchCurrent;
 }
 //#endregion
 //#region src/automation.d.ts
@@ -178,6 +180,7 @@ declare class BrowserAutomation {
   private readonly session;
   private readonly turn;
   private readonly isNavigationAllowed;
+  private operationTail;
   constructor(session: BrowserSession, turn: TurnController, isNavigationAllowed: (url: string) => boolean);
   navigate(url: string): Promise<NavigateResult>;
   click(selector: string): Promise<void>;
@@ -192,6 +195,9 @@ declare class BrowserAutomation {
   screenshot(): Promise<string>;
   /** Evaluate an expression in the page context via CDP (no eval on our side). */
   evaluate(expression: string): Promise<unknown>;
+  /** Wait until all agent operations that were already queued have settled. */
+  waitUntilIdle(): Promise<void>;
+  private run;
 }
 //#endregion
 //#region src/browser-surface.d.ts
@@ -213,6 +219,12 @@ declare class BrowserSurface implements SurfaceHandler {
   private readonly viewers;
   private viewport;
   private handoff;
+  private controllerSessionId;
+  private pendingControllerSessionId;
+  private streamGeneration;
+  private streamQueue;
+  private closed;
+  private readonly removePageListener;
   private readonly log;
   constructor(options: BrowserSurfaceOptions, sendFrame: (buf: Buffer) => void);
   openSession(sessionId: number, open: SessionOpenPayload): Promise<void>;
@@ -244,13 +256,16 @@ declare class BrowserSurface implements SurfaceHandler {
   removeHold(): void;
   shutdown(): Promise<void>;
   private releaseToAgent;
-  private ensureStreaming;
+  private restartStreaming;
+  private enqueueStreamCleanup;
+  private shouldStream;
   private applyResize;
   private broadcastFrame;
   private broadcast;
   private broadcastState;
   private sendState;
   private currentPageInfo;
+  private sendFrameSafe;
 }
 //#endregion
 export { BrowserAutomation, BrowserSession, type BrowserSessionOptions, BrowserSurface, type BrowserSurfaceOptions, type HandoffResult, type Logger, type NavigateResult };

package/dist/index.d.ts

@@ -125,16 +125,11 @@ interface BrowserSessionOptions {
   idleShutdownMs?: number;
   /** Extra Chrome args. */
   extraArgs?: string[];
-  logger?: Logger;
-}
-interface BrowserSurfaceOptions extends BrowserSessionOptions {
-  /**
-   * Guard consulted before agent-driven or human navigation. Return false to
-   * block (SSRF policy). Defaults to allow-all; Phase 11 wires the integration
-   * SSRF allowlist here.
-   */
+  /** Guard applied to every intercepted HTTP(S) page request. */
   isNavigationAllowed?: (url: string) => boolean;
+  logger?: Logger;
 }
+type BrowserSurfaceOptions = BrowserSessionOptions;
 //#endregion
 //#region src/browser-session.d.ts
 declare class BrowserSession {
@@ -144,6 +139,9 @@ declare class BrowserSession {
   private launching;
   private holds;
   private idleTimer;
+  private generation;
+  private readonly preparedPages;
+  private readonly activePageListeners;
   private readonly log;
   private readonly idleMs;
   constructor(options: BrowserSessionOptions);
@@ -158,6 +156,7 @@ declare class BrowserSession {
   private adoptIfNavigable;
   /** The current active page, launching Chrome first if needed. */
   getActivePage(): Promise<Page>;
+  onActivePageChange(listener: (page: Page) => void | Promise<void>): () => void;
   /** Prevent idle shutdown while a viewer or op is active. */
   addHold(): void;
   /** Release a hold; arm idle shutdown when the last one is released. */
@@ -167,6 +166,9 @@ declare class BrowserSession {
   private armIdleTimer;
   private clearIdleTimer;
   shutdown(): Promise<void>;
+  private setActivePage;
+  private preparePage;
+  private isLaunchCurrent;
 }
 //#endregion
 //#region src/automation.d.ts
@@ -178,6 +180,7 @@ declare class BrowserAutomation {
   private readonly session;
   private readonly turn;
   private readonly isNavigationAllowed;
+  private operationTail;
   constructor(session: BrowserSession, turn: TurnController, isNavigationAllowed: (url: string) => boolean);
   navigate(url: string): Promise<NavigateResult>;
   click(selector: string): Promise<void>;
@@ -192,6 +195,9 @@ declare class BrowserAutomation {
   screenshot(): Promise<string>;
   /** Evaluate an expression in the page context via CDP (no eval on our side). */
   evaluate(expression: string): Promise<unknown>;
+  /** Wait until all agent operations that were already queued have settled. */
+  waitUntilIdle(): Promise<void>;
+  private run;
 }
 //#endregion
 //#region src/browser-surface.d.ts
@@ -213,6 +219,12 @@ declare class BrowserSurface implements SurfaceHandler {
   private readonly viewers;
   private viewport;
   private handoff;
+  private controllerSessionId;
+  private pendingControllerSessionId;
+  private streamGeneration;
+  private streamQueue;
+  private closed;
+  private readonly removePageListener;
   private readonly log;
   constructor(options: BrowserSurfaceOptions, sendFrame: (buf: Buffer) => void);
   openSession(sessionId: number, open: SessionOpenPayload): Promise<void>;
@@ -244,13 +256,16 @@ declare class BrowserSurface implements SurfaceHandler {
   removeHold(): void;
   shutdown(): Promise<void>;
   private releaseToAgent;
-  private ensureStreaming;
+  private restartStreaming;
+  private enqueueStreamCleanup;
+  private shouldStream;
   private applyResize;
   private broadcastFrame;
   private broadcast;
   private broadcastState;
   private sendState;
   private currentPageInfo;
+  private sendFrameSafe;
 }
 //#endregion
 export { BrowserAutomation, BrowserSession, type BrowserSessionOptions, BrowserSurface, type BrowserSurfaceOptions, type HandoffResult, type Logger, type NavigateResult };