agentic-browser 2.6.1 → 2.7.0

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 
-import WebSocket from "ws";
+import "ws";
 import { z } from "zod";
-//#region src/session/browser-controller.d.ts
 type InteractAction = "click" | "type" | "press" | "waitFor" | "evaluate" | "scroll" | "hover" | "select" | "toggle" | "goBack" | "goForward" | "refresh" | "dialog";
 interface InteractPayload {
   action: InteractAction;
@@ -13,6 +12,13 @@ interface InteractPayload {
   scrollX?: number;
   scrollY?: number;
   timeoutMs?: number;
+  /**
+   * Locator of an iframe to run the action in. Needed for cross-origin frames,
+   * which `>>>` cannot pierce from the page. Composed selectors like
+   * `iframe#consent >>> button` are split automatically when the frame is
+   * cross-origin, so this is only required for explicit control.
+   */
+  frame?: string;
 }
 type PageContentMode = "title" | "text" | "html" | "a11y" | "summary";
 interface PageContentOptions {
@@ -49,11 +55,36 @@ interface InteractiveElementsOptions {
   visibleOnly?: boolean;
   limit?: number;
   selector?: string;
+  /** Case-insensitive substring filter on the element's href. */
+  href?: string;
+  /** Case-insensitive substring filter on text, aria-label, placeholder, value or title. */
+  text?: string;
+  /** Discover elements inside this iframe (works for cross-origin frames). */
+  frame?: string;
+}
+/** An iframe whose content discovery could not enter from the page context. */
+interface CrossOriginFrameInfo {
+  selector: string;
+  title?: string;
+  src?: string;
 }
 interface InteractiveElementsResult {
   elements: InteractiveElement[];
   totalFound: number;
   truncated: boolean;
+  /** Cross-origin iframes skipped by discovery — pass one as `frame` to look inside. */
+  crossOriginFrames?: CrossOriginFrameInfo[];
+}
+interface PageState {
+  url: string;
+  title: string;
+  readyState: string;
+}
+interface TabInfo {
+  id: string;
+  url: string;
+  title: string;
+  targetWsUrl: string;
 }
 interface LaunchOptions {
   executablePath?: string;
@@ -63,7 +94,7 @@ interface LaunchOptions {
 }
 interface DismissCookieBannerResult {
   dismissed: boolean;
-  method?: "a11y" | "selector" | "text";
+  method?: "a11y" | "selector" | "text" | "iframe" | "iframe-text";
   detail?: string;
 }
 type ErrorCode = "SELECTOR_NOT_FOUND" | "ELEMENT_COVERED" | "ELEMENT_NOT_EDITABLE" | "NAVIGATION_TIMEOUT" | "NAVIGATION_FAILED" | "CDP_DISCONNECTED" | "SESSION_DEAD" | "DIALOG_BLOCKING" | "TIMEOUT" | "UNKNOWN";
@@ -96,22 +127,25 @@ interface BrowserController {
   dismissCookieBanner(targetWsUrl: string): Promise<DismissCookieBannerResult>;
   screenshot(targetWsUrl: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
   getCurrentUrl(targetWsUrl: string): Promise<string>;
+  getPageState(targetWsUrl: string): Promise<PageState>;
+  listTabs(cdpUrl: string): Promise<TabInfo[]>;
+  openTab(cdpUrl: string): Promise<TabInfo>;
+  activateTab(cdpUrl: string, tabId: string): Promise<void>;
+  closeTab(cdpUrl: string, tabId: string): Promise<void>;
   terminate(pid: number): void;
   closeConnection?(targetWsUrl: string): void;
   dispose?(): void;
 }
-//#endregion
-//#region src/memory/memory-schemas.d.ts
 declare const InsightFreshnessSchema: z.ZodEnum<{
   fresh: "fresh";
-  suspect: "suspect";
   stale: "stale";
+  suspect: "suspect";
 }>;
 declare const TaskStepSchema: z.ZodObject<{
   type: z.ZodEnum<{
-    navigate: "navigate";
-    interact: "interact";
     assert: "assert";
+    interact: "interact";
+    navigate: "navigate";
   }>;
   summary: z.ZodString;
   selector: z.ZodOptional<z.ZodString>;
@@ -129,9 +163,9 @@ declare const TaskInsightSchema: z.ZodObject<{
   sitePathPattern: z.ZodString;
   actionRecipe: z.ZodArray<z.ZodObject<{
     type: z.ZodEnum<{
-      navigate: "navigate";
-      interact: "interact";
       assert: "assert";
+      interact: "interact";
+      navigate: "navigate";
     }>;
     summary: z.ZodString;
     selector: z.ZodOptional<z.ZodString>;
@@ -144,8 +178,8 @@ declare const TaskInsightSchema: z.ZodObject<{
   useCount: z.ZodNumber;
   freshness: z.ZodEnum<{
     fresh: "fresh";
-    suspect: "suspect";
     stale: "stale";
+    suspect: "suspect";
   }>;
   staleStrikeCount: z.ZodNumber;
   lastVerifiedAt: z.ZodString;
@@ -156,8 +190,8 @@ declare const TaskInsightSchema: z.ZodObject<{
     evidenceId: z.ZodString;
     commandId: z.ZodString;
     result: z.ZodEnum<{
-      success: "success";
       failure: "failure";
+      success: "success";
     }>;
     reason: z.ZodOptional<z.ZodString>;
     selector: z.ZodOptional<z.ZodString>;
@@ -233,28 +267,26 @@ interface MemorySearchResult {
   score: number;
   siteProfile?: SiteProfileSummary;
 }
-//#endregion
-//#region src/lib/domain-schemas.d.ts
 declare const SessionStatusSchema: z.ZodEnum<{
-  starting: "starting";
-  ready: "ready";
   disconnected: "disconnected";
   failed: "failed";
+  ready: "ready";
+  starting: "starting";
   terminated: "terminated";
 }>;
 declare const CommandTypeSchema: z.ZodEnum<{
-  navigate: "navigate";
   interact: "interact";
+  navigate: "navigate";
   restart: "restart";
   terminate: "terminate";
 }>;
 declare const SessionSchema: z.ZodObject<{
   sessionId: z.ZodString;
   status: z.ZodEnum<{
-    starting: "starting";
-    ready: "ready";
     disconnected: "disconnected";
     failed: "failed";
+    ready: "ready";
+    starting: "starting";
     terminated: "terminated";
   }>;
   browserType: z.ZodLiteral<"chrome">;
@@ -266,8 +298,8 @@ declare const CommandSchema: z.ZodObject<{
   commandId: z.ZodString;
   sessionId: z.ZodString;
   type: z.ZodEnum<{
-    navigate: "navigate";
     interact: "interact";
+    navigate: "navigate";
     restart: "restart";
     terminate: "terminate";
   }>;
@@ -285,9 +317,9 @@ declare const SessionEventSchema: z.ZodObject<{
   eventId: z.ZodString;
   sessionId: z.ZodString;
   category: z.ZodEnum<{
+    command: "command";
     lifecycle: "lifecycle";
     security: "security";
-    command: "command";
   }>;
   message: z.ZodString;
   createdAt: z.ZodString;
@@ -302,8 +334,6 @@ type CommandType = z.infer<typeof CommandTypeSchema>;
 type Session = z.infer<typeof SessionSchema>;
 type Command = z.infer<typeof CommandSchema>;
 type SessionEvent = z.infer<typeof SessionEventSchema>;
-//#endregion
-//#region src/lib/config.d.ts
 interface AppConfig {
   dataDir: string;
   browserExecutablePath?: string;
@@ -311,10 +341,9 @@ interface AppConfig {
   userProfileDir?: string;
   headless?: boolean;
   userAgent?: string;
+  allowFileUrls: boolean;
 }
 declare function loadConfig(env?: NodeJS.ProcessEnv): AppConfig;
-//#endregion
-//#region src/observability/logger.d.ts
 interface LogContext {
   [key: string]: unknown;
 }
@@ -326,8 +355,6 @@ declare class Logger {
   warning(message: string, context?: LogContext): void;
   error(message: string, context?: LogContext): void;
 }
-//#endregion
-//#region src/observability/event-store.d.ts
 declare class EventStore {
   private readonly events;
   private readonly filePath;
@@ -349,8 +376,6 @@ declare class EventStore {
   private flushAsync;
   private readonly flushSync;
 }
-//#endregion
-//#region src/auth/session-token.d.ts
 declare class SessionTokenService {
   private readonly tokens;
   issue(sessionId: string): string;
@@ -359,8 +384,6 @@ declare class SessionTokenService {
   get(sessionId: string): string | undefined;
   seed(sessionId: string, token: string): void;
 }
-//#endregion
-//#region src/memory/memory-service.d.ts
 interface MemorySearchInput {
   taskIntent: string;
   siteDomain?: string;
@@ -385,6 +408,8 @@ declare class MemoryService {
   constructor(baseDir: string);
   /** Force an immediate synchronous flush of pending writes. */
   flushSync(): void;
+  /** Flush pending writes and release the stores' process exit hooks. */
+  dispose(): void;
   search(input: MemorySearchInput): MemorySearchResult[];
   /** Invalidate search cache when data changes. */
   private invalidateSearchCache;
@@ -400,8 +425,8 @@ declare class MemoryService {
     }>;
   };
   verify(insightId: string): TaskInsight;
-  recordSuccess(input: RecordExecutionInput): TaskInsight;
-  recordFailure(input: RecordExecutionInput, errorMessage: string): TaskInsight | undefined;
+  recordSuccess(rawInput: RecordExecutionInput): TaskInsight;
+  recordFailure(rawInput: RecordExecutionInput, errorMessage: string): TaskInsight | undefined;
   /** Update site profile from page content (call after getContent with mode="summary"). */
   updateProfileFromContent(domain: string, pathPattern: string, structuredContent: {
     headings?: string[];
@@ -421,13 +446,13 @@ declare class MemoryService {
   private findBestExactMatch;
   private scoreExactMatch;
   private sameFirstPathSegment;
+  /** Strip query strings and fragments from every URL-bearing field before it is persisted. */
+  private sanitizeInput;
   private createEvidence;
   private maybeGenerateAliases;
   private deriveAliasName;
   private mergeRecipe;
 }
-//#endregion
-//#region src/cli/app.d.ts
 interface AppContext {
   config: ReturnType<typeof loadConfig>;
   logger: Logger;
@@ -435,8 +460,6 @@ interface AppContext {
   tokenService: SessionTokenService;
   memoryService: MemoryService;
 }
-//#endregion
-//#region src/session/session-store.d.ts
 interface StoredSessionRecord {
   session: Session;
   cdpUrl: string;
@@ -444,8 +467,6 @@ interface StoredSessionRecord {
   pid: number;
   lastUrl?: string;
 }
-//#endregion
-//#region src/session/session-manager.d.ts
 interface CreateSessionInput {
   browser: "chrome";
 }
@@ -478,6 +499,18 @@ declare class SessionManager {
   getInteractiveElements(sessionId: string, options: InteractiveElementsOptions): Promise<InteractiveElementsResult>;
   screenshot(sessionId: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
   getCurrentUrl(sessionId: string): Promise<string>;
+  getPageState(sessionId: string): Promise<PageState>;
+  listTabs(sessionId: string): Promise<Array<TabInfo & {
+    active: boolean;
+  }>>;
+  /** Points the session at another tab; later commands run there. */
+  switchTab(sessionId: string, tabId: string): Promise<TabInfo>;
+  newTab(sessionId: string): Promise<TabInfo>;
+  /** Closes a tab; closing the active one moves the session to a remaining tab. */
+  closeTab(sessionId: string, tabId: string): Promise<{
+    closed: string;
+    active: TabInfo;
+  }>;
   dismissCookieBanner(sessionId: string): Promise<DismissCookieBannerResult>;
   setStatus(status: SessionStatus, reason: string): Session;
   terminateSession(sessionId: string): Promise<Session>;
@@ -496,36 +529,36 @@ declare class SessionManager {
     siteDomain: string;
     sitePathPattern: string;
     actionRecipe: {
-      type: "navigate" | "interact" | "assert";
+      type: "assert" | "interact" | "navigate";
       summary: string;
-      payload: Record<string, unknown>;
       selector?: string | undefined;
+      payload: Record<string, unknown>;
     }[];
     expectedOutcome: string;
     confidence: number;
     successCount: number;
     failureCount: number;
     useCount: number;
-    freshness: "fresh" | "suspect" | "stale";
+    freshness: "fresh" | "stale" | "suspect";
     staleStrikeCount: number;
     lastVerifiedAt: string;
     createdAt: string;
     updatedAt: string;
+    supersedes?: string | undefined;
     evidence: {
       evidenceId: string;
       commandId: string;
-      result: "success" | "failure";
-      recordedAt: string;
+      result: "failure" | "success";
       reason?: string | undefined;
       selector?: string | undefined;
       url?: string | undefined;
+      recordedAt: string;
     }[];
     selectorAliases: {
       alias: string;
       selector: string;
       fallbackSelectors: string[];
     }[];
-    supersedes?: string | undefined;
   };
   verifyMemory(insightId: string): {
     insightId: string;
@@ -533,36 +566,36 @@ declare class SessionManager {
     siteDomain: string;
     sitePathPattern: string;
     actionRecipe: {
-      type: "navigate" | "interact" | "assert";
+      type: "assert" | "interact" | "navigate";
       summary: string;
-      payload: Record<string, unknown>;
       selector?: string | undefined;
+      payload: Record<string, unknown>;
     }[];
     expectedOutcome: string;
     confidence: number;
     successCount: number;
     failureCount: number;
     useCount: number;
-    freshness: "fresh" | "suspect" | "stale";
+    freshness: "fresh" | "stale" | "suspect";
     staleStrikeCount: number;
     lastVerifiedAt: string;
     createdAt: string;
     updatedAt: string;
+    supersedes?: string | undefined;
     evidence: {
       evidenceId: string;
       commandId: string;
-      result: "success" | "failure";
-      recordedAt: string;
+      result: "failure" | "success";
       reason?: string | undefined;
       selector?: string | undefined;
       url?: string | undefined;
+      recordedAt: string;
     }[];
     selectorAliases: {
       alias: string;
       selector: string;
       fallbackSelectors: string[];
     }[];
-    supersedes?: string | undefined;
   };
   memoryStats(): {
     total: number;
@@ -584,8 +617,6 @@ declare class SessionManager {
   private buildMemoryContext;
   private parseUrl;
 }
-//#endregion
-//#region src/transport/control-api.d.ts
 declare class ControlApi {
   private readonly sessions;
   constructor(sessions: SessionManager);
@@ -593,19 +624,19 @@ declare class ControlApi {
     browser: "chrome";
   }): Promise<{
     sessionId: string;
-    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    status: "disconnected" | "failed" | "ready" | "starting" | "terminated";
     browserType: "chrome";
     startedAt: string;
-    authTokenRef: string;
     endedAt?: string | undefined;
+    authTokenRef: string;
   }>;
   getSession(sessionId: string): {
     sessionId: string;
-    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    status: "disconnected" | "failed" | "ready" | "starting" | "terminated";
     browserType: "chrome";
     startedAt: string;
-    authTokenRef: string;
     endedAt?: string | undefined;
+    authTokenRef: string;
   };
   terminateSession(sessionId: string): Promise<void>;
   executeCommand(sessionId: string, input: {
@@ -615,7 +646,7 @@ declare class ControlApi {
   }): Promise<{
     commandId: string;
     sessionId: string;
-    type: "navigate" | "interact" | "restart" | "terminate";
+    type: "interact" | "navigate" | "restart" | "terminate";
     payload: Record<string, unknown>;
     submittedAt: string;
     completedAt?: string | undefined;
@@ -624,11 +655,11 @@ declare class ControlApi {
   }>;
   restartSession(sessionId: string): Promise<{
     sessionId: string;
-    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    status: "disconnected" | "failed" | "ready" | "starting" | "terminated";
     browserType: "chrome";
     startedAt: string;
-    authTokenRef: string;
     endedAt?: string | undefined;
+    authTokenRef: string;
   }>;
   rotateSessionToken(sessionId: string): string;
   getContent(sessionId: string, options: {
@@ -640,11 +671,21 @@ declare class ControlApi {
   dismissCookieBanner(sessionId: string): Promise<DismissCookieBannerResult>;
   screenshot(sessionId: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
   getCurrentUrl(sessionId: string): Promise<string>;
+  getPageState(sessionId: string): Promise<PageState>;
+  listTabs(sessionId: string): Promise<(TabInfo & {
+    active: boolean;
+  })[]>;
+  switchTab(sessionId: string, tabId: string): Promise<TabInfo>;
+  newTab(sessionId: string): Promise<TabInfo>;
+  closeTab(sessionId: string, tabId: string): Promise<{
+    closed: string;
+    active: TabInfo;
+  }>;
   listEvents(sessionId: string, limit?: number): {
     events: {
       eventId: string;
       sessionId: string;
-      category: "lifecycle" | "security" | "command";
+      category: "command" | "lifecycle" | "security";
       message: string;
       createdAt: string;
       severity: "error" | "info" | "warning";
@@ -663,36 +704,36 @@ declare class ControlApi {
     siteDomain: string;
     sitePathPattern: string;
     actionRecipe: {
-      type: "navigate" | "interact" | "assert";
+      type: "assert" | "interact" | "navigate";
       summary: string;
-      payload: Record<string, unknown>;
       selector?: string | undefined;
+      payload: Record<string, unknown>;
     }[];
     expectedOutcome: string;
     confidence: number;
     successCount: number;
     failureCount: number;
     useCount: number;
-    freshness: "fresh" | "suspect" | "stale";
+    freshness: "fresh" | "stale" | "suspect";
     staleStrikeCount: number;
     lastVerifiedAt: string;
     createdAt: string;
     updatedAt: string;
+    supersedes?: string | undefined;
     evidence: {
       evidenceId: string;
       commandId: string;
-      result: "success" | "failure";
-      recordedAt: string;
+      result: "failure" | "success";
       reason?: string | undefined;
       selector?: string | undefined;
       url?: string | undefined;
+      recordedAt: string;
     }[];
     selectorAliases: {
       alias: string;
       selector: string;
       fallbackSelectors: string[];
     }[];
-    supersedes?: string | undefined;
   };
   verifyMemory(insightId: string): {
     insightId: string;
@@ -700,36 +741,36 @@ declare class ControlApi {
     siteDomain: string;
     sitePathPattern: string;
     actionRecipe: {
-      type: "navigate" | "interact" | "assert";
+      type: "assert" | "interact" | "navigate";
       summary: string;
-      payload: Record<string, unknown>;
       selector?: string | undefined;
+      payload: Record<string, unknown>;
     }[];
     expectedOutcome: string;
     confidence: number;
     successCount: number;
     failureCount: number;
     useCount: number;
-    freshness: "fresh" | "suspect" | "stale";
+    freshness: "fresh" | "stale" | "suspect";
     staleStrikeCount: number;
     lastVerifiedAt: string;
     createdAt: string;
     updatedAt: string;
+    supersedes?: string | undefined;
     evidence: {
       evidenceId: string;
       commandId: string;
-      result: "success" | "failure";
-      recordedAt: string;
+      result: "failure" | "success";
       reason?: string | undefined;
       selector?: string | undefined;
       url?: string | undefined;
+      recordedAt: string;
     }[];
     selectorAliases: {
       alias: string;
       selector: string;
       fallbackSelectors: string[];
     }[];
-    supersedes?: string | undefined;
   };
   memoryStats(): {
     total: number;
@@ -746,8 +787,6 @@ declare class ControlApi {
     dryRun?: boolean;
   }): CleanupResult;
 }
-//#endregion
-//#region src/cli/runtime.d.ts
 interface AgenticBrowserCoreOptions {
   env?: NodeJS.ProcessEnv;
   browserController?: BrowserController;
@@ -758,33 +797,41 @@ interface ExecuteCommandInput {
   type: CommandType;
   payload: Record<string, unknown>;
 }
-declare class AgenticBrowserCore {
+export declare class AgenticBrowserCore {
   readonly context: AppContext;
   readonly sessions: SessionManager;
   readonly api: ControlApi;
+  private readonly browserController;
+  private disposed;
   constructor(context: AppContext, browserController: BrowserController);
+  /**
+   * Release process-level resources (event store and memory store exit handlers,
+   * controller timers). Flushes pending memory writes.
+   * Does not terminate browser sessions. Idempotent.
+   */
+  dispose(): Promise<void>;
   startSession(input?: {
     browser: "chrome";
   }): Promise<{
     sessionId: string;
-    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    status: "disconnected" | "failed" | "ready" | "starting" | "terminated";
     browserType: "chrome";
     startedAt: string;
-    authTokenRef: string;
     endedAt?: string | undefined;
+    authTokenRef: string;
   }>;
   getSession(sessionId: string): {
     sessionId: string;
-    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    status: "disconnected" | "failed" | "ready" | "starting" | "terminated";
     browserType: "chrome";
     startedAt: string;
-    authTokenRef: string;
     endedAt?: string | undefined;
+    authTokenRef: string;
   };
   runCommand(input: ExecuteCommandInput): Promise<{
     commandId: string;
     sessionId: string;
-    type: "navigate" | "interact" | "restart" | "terminate";
+    type: "interact" | "navigate" | "restart" | "terminate";
     payload: Record<string, unknown>;
     submittedAt: string;
     completedAt?: string | undefined;
@@ -803,17 +850,30 @@ declare class AgenticBrowserCore {
     visibleOnly?: boolean;
     limit?: number;
     selector?: string;
+    href?: string;
+    text?: string;
+    frame?: string;
   }): Promise<InteractiveElementsResult>;
   dismissCookieBanner(sessionId: string): Promise<DismissCookieBannerResult>;
   screenshot(sessionId: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
   getCurrentUrl(sessionId: string): Promise<string>;
+  getPageState(sessionId: string): Promise<PageState>;
+  listTabs(sessionId: string): Promise<(TabInfo & {
+    active: boolean;
+  })[]>;
+  switchTab(sessionId: string, tabId: string): Promise<TabInfo>;
+  newTab(sessionId: string): Promise<TabInfo>;
+  closeTab(sessionId: string, tabId: string): Promise<{
+    closed: string;
+    active: TabInfo;
+  }>;
   restartSession(sessionId: string): Promise<{
     sessionId: string;
-    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    status: "disconnected" | "failed" | "ready" | "starting" | "terminated";
     browserType: "chrome";
     startedAt: string;
-    authTokenRef: string;
     endedAt?: string | undefined;
+    authTokenRef: string;
   }>;
   stopSession(sessionId: string): Promise<void>;
   rotateSessionToken(sessionId: string): string;
@@ -830,36 +890,36 @@ declare class AgenticBrowserCore {
     siteDomain: string;
     sitePathPattern: string;
     actionRecipe: {
-      type: "navigate" | "interact" | "assert";
+      type: "assert" | "interact" | "navigate";
       summary: string;
-      payload: Record<string, unknown>;
       selector?: string | undefined;
+      payload: Record<string, unknown>;
     }[];
     expectedOutcome: string;
     confidence: number;
     successCount: number;
     failureCount: number;
     useCount: number;
-    freshness: "fresh" | "suspect" | "stale";
+    freshness: "fresh" | "stale" | "suspect";
     staleStrikeCount: number;
     lastVerifiedAt: string;
     createdAt: string;
     updatedAt: string;
+    supersedes?: string | undefined;
     evidence: {
       evidenceId: string;
       commandId: string;
-      result: "success" | "failure";
-      recordedAt: string;
+      result: "failure" | "success";
       reason?: string | undefined;
       selector?: string | undefined;
       url?: string | undefined;
+      recordedAt: string;
     }[];
     selectorAliases: {
       alias: string;
       selector: string;
       fallbackSelectors: string[];
     }[];
-    supersedes?: string | undefined;
   };
   verifyMemory(insightId: string): {
     insightId: string;
@@ -867,36 +927,36 @@ declare class AgenticBrowserCore {
     siteDomain: string;
     sitePathPattern: string;
     actionRecipe: {
-      type: "navigate" | "interact" | "assert";
+      type: "assert" | "interact" | "navigate";
       summary: string;
-      payload: Record<string, unknown>;
       selector?: string | undefined;
+      payload: Record<string, unknown>;
     }[];
     expectedOutcome: string;
     confidence: number;
     successCount: number;
     failureCount: number;
     useCount: number;
-    freshness: "fresh" | "suspect" | "stale";
+    freshness: "fresh" | "stale" | "suspect";
     staleStrikeCount: number;
     lastVerifiedAt: string;
     createdAt: string;
     updatedAt: string;
+    supersedes?: string | undefined;
     evidence: {
       evidenceId: string;
       commandId: string;
-      result: "success" | "failure";
-      recordedAt: string;
+      result: "failure" | "success";
       reason?: string | undefined;
       selector?: string | undefined;
       url?: string | undefined;
+      recordedAt: string;
     }[];
     selectorAliases: {
       alias: string;
       selector: string;
       fallbackSelectors: string[];
     }[];
-    supersedes?: string | undefined;
   };
   memoryStats(): {
     total: number;
@@ -909,7 +969,6 @@ declare class AgenticBrowserCore {
     }>;
   };
 }
-declare function createAgenticBrowserCore(options?: AgenticBrowserCoreOptions): AgenticBrowserCore;
-declare function createMockAgenticBrowserCore(env: NodeJS.ProcessEnv): AgenticBrowserCore;
-//#endregion
-export { AgenticBrowserCore, type AgenticBrowserCoreOptions, type DismissCookieBannerResult, type ElementAction, type ErrorCode, type ExecuteCommandInput, type InteractiveElement, type InteractiveElementRole, type InteractiveElementsOptions, type InteractiveElementsResult, type LaunchOptions, type ScreenshotOptions, type ScreenshotResult, createAgenticBrowserCore, createMockAgenticBrowserCore };
+export declare function createAgenticBrowserCore(options?: AgenticBrowserCoreOptions): AgenticBrowserCore;
+export declare function createMockAgenticBrowserCore(env: NodeJS.ProcessEnv): AgenticBrowserCore;
+export type { AgenticBrowserCoreOptions, DismissCookieBannerResult, ElementAction, ErrorCode, ExecuteCommandInput, InteractiveElement, InteractiveElementRole, InteractiveElementsOptions, InteractiveElementsResult, LaunchOptions, ScreenshotOptions, ScreenshotResult };