agentic-browser 2.3.0 → 2.4.0

package/dist/index.d.mts

@@ -0,0 +1,928 @@
+
+import WebSocket, { WebSocket as WebSocket$1 } from "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;
+  selector?: string;
+  fallbackSelectors?: string[];
+  text?: string;
+  key?: string;
+  value?: string;
+  scrollX?: number;
+  scrollY?: number;
+  timeoutMs?: number;
+}
+type PageContentMode = "title" | "text" | "html" | "a11y" | "summary";
+interface PageContentOptions {
+  mode: PageContentMode;
+  selector?: string;
+  maxChars?: number;
+}
+interface PageContentResult {
+  mode: PageContentMode;
+  content: string;
+  truncated?: boolean;
+  originalLength?: number;
+  structuredContent?: Record<string, unknown>;
+}
+type InteractiveElementRole = "link" | "button" | "input" | "select" | "textarea" | "checkbox" | "radio" | "contenteditable" | "custom";
+type ElementAction = "click" | "type" | "select" | "toggle" | "press";
+interface InteractiveElement {
+  selector: string;
+  fallbackSelectors?: string[];
+  role: InteractiveElementRole;
+  tagName: string;
+  text: string;
+  actions: ElementAction[];
+  visible: boolean;
+  enabled: boolean;
+  href?: string;
+  inputType?: string;
+  ariaLabel?: string;
+  placeholder?: string;
+  currentValue?: string;
+}
+interface InteractiveElementsOptions {
+  roles?: InteractiveElementRole[];
+  visibleOnly?: boolean;
+  limit?: number;
+  selector?: string;
+}
+interface InteractiveElementsResult {
+  elements: InteractiveElement[];
+  totalFound: number;
+  truncated: boolean;
+}
+interface LaunchOptions {
+  executablePath?: string;
+  userProfileDir?: string;
+  headless?: boolean;
+  userAgent?: string;
+}
+interface DismissCookieBannerResult {
+  dismissed: boolean;
+  method?: "a11y" | "selector" | "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";
+interface ScreenshotOptions {
+  format?: "jpeg" | "png";
+  quality?: number;
+  fullPage?: boolean;
+}
+interface ScreenshotResult {
+  data: string;
+  mimeType: string;
+}
+interface BrowserController {
+  launch(sessionId: string, options?: LaunchOptions): Promise<{
+    pid: number;
+    cdpUrl: string;
+    targetWsUrl: string;
+  }>;
+  connect(cdpUrl: string, options?: {
+    userAgent?: string;
+  }): Promise<{
+    pid: number;
+    cdpUrl: string;
+    targetWsUrl: string;
+  }>;
+  navigate(targetWsUrl: string, url: string): Promise<string>;
+  interact(targetWsUrl: string, payload: InteractPayload): Promise<string>;
+  getContent(targetWsUrl: string, options: PageContentOptions): Promise<PageContentResult>;
+  getInteractiveElements(targetWsUrl: string, options: InteractiveElementsOptions): Promise<InteractiveElementsResult>;
+  dismissCookieBanner(targetWsUrl: string): Promise<DismissCookieBannerResult>;
+  screenshot(targetWsUrl: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
+  getCurrentUrl(targetWsUrl: string): Promise<string>;
+  terminate(pid: number): void;
+  closeConnection?(targetWsUrl: string): void;
+}
+//#endregion
+//#region src/memory/memory-schemas.d.ts
+declare const InsightFreshnessSchema: z.ZodEnum<{
+  fresh: "fresh";
+  suspect: "suspect";
+  stale: "stale";
+}>;
+declare const TaskStepSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    navigate: "navigate";
+    interact: "interact";
+    assert: "assert";
+  }>;
+  summary: z.ZodString;
+  selector: z.ZodOptional<z.ZodString>;
+  payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const SelectorAliasSchema: z.ZodObject<{
+  alias: z.ZodString;
+  selector: z.ZodString;
+  fallbackSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const TaskInsightSchema: z.ZodObject<{
+  insightId: z.ZodString;
+  taskIntent: z.ZodString;
+  siteDomain: z.ZodString;
+  sitePathPattern: z.ZodString;
+  actionRecipe: z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<{
+      navigate: "navigate";
+      interact: "interact";
+      assert: "assert";
+    }>;
+    summary: z.ZodString;
+    selector: z.ZodOptional<z.ZodString>;
+    payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>>;
+  expectedOutcome: z.ZodString;
+  confidence: z.ZodNumber;
+  successCount: z.ZodNumber;
+  failureCount: z.ZodNumber;
+  useCount: z.ZodNumber;
+  freshness: z.ZodEnum<{
+    fresh: "fresh";
+    suspect: "suspect";
+    stale: "stale";
+  }>;
+  staleStrikeCount: z.ZodNumber;
+  lastVerifiedAt: z.ZodString;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+  supersedes: z.ZodOptional<z.ZodString>;
+  evidence: z.ZodArray<z.ZodObject<{
+    evidenceId: z.ZodString;
+    commandId: z.ZodString;
+    result: z.ZodEnum<{
+      success: "success";
+      failure: "failure";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    recordedAt: z.ZodString;
+  }, z.core.$strip>>;
+  selectorAliases: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    alias: z.ZodString;
+    selector: z.ZodString;
+    fallbackSelectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const SelectorPatternSchema: z.ZodObject<{
+  pattern: z.ZodString;
+  frequency: z.ZodNumber;
+  lastSeenAt: z.ZodString;
+}, z.core.$strip>;
+declare const PageLayoutFingerprintSchema: z.ZodObject<{
+  pathPattern: z.ZodString;
+  headings: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  landmarks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  lastSeenAt: z.ZodString;
+}, z.core.$strip>;
+declare const SiteProfileSchema: z.ZodObject<{
+  domain: z.ZodString;
+  selectorPatterns: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    pattern: z.ZodString;
+    frequency: z.ZodNumber;
+    lastSeenAt: z.ZodString;
+  }, z.core.$strip>>>;
+  layoutFingerprints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    pathPattern: z.ZodString;
+    headings: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    landmarks: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    lastSeenAt: z.ZodString;
+  }, z.core.$strip>>>;
+  navigationPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  cookieBanner: z.ZodOptional<z.ZodObject<{
+    detected: z.ZodBoolean;
+    autoDismissed: z.ZodOptional<z.ZodBoolean>;
+    method: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  visitCount: z.ZodDefault<z.ZodNumber>;
+  lastVisitAt: z.ZodString;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+type InsightFreshness = z.infer<typeof InsightFreshnessSchema>;
+type TaskStep = z.infer<typeof TaskStepSchema>;
+type SelectorAlias = z.infer<typeof SelectorAliasSchema>;
+type TaskInsight = z.infer<typeof TaskInsightSchema>;
+type SelectorPattern = z.infer<typeof SelectorPatternSchema>;
+type PageLayoutFingerprint = z.infer<typeof PageLayoutFingerprintSchema>;
+type SiteProfile = z.infer<typeof SiteProfileSchema>;
+interface SiteProfileSummary {
+  selectorPatterns: SelectorPattern[];
+  layoutFingerprints: PageLayoutFingerprint[];
+  cookieBanner?: {
+    detected: boolean;
+    autoDismissed?: boolean;
+    method?: string;
+  };
+  visitCount: number;
+}
+interface MemorySearchResult {
+  insightId: string;
+  taskIntent: string;
+  siteDomain: string;
+  confidence: number;
+  freshness: InsightFreshness;
+  lastVerifiedAt: string;
+  selectorHints: string[];
+  selectorAliases: SelectorAlias[];
+  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";
+  terminated: "terminated";
+}>;
+declare const CommandTypeSchema: z.ZodEnum<{
+  navigate: "navigate";
+  interact: "interact";
+  restart: "restart";
+  terminate: "terminate";
+}>;
+declare const SessionSchema: z.ZodObject<{
+  sessionId: z.ZodString;
+  status: z.ZodEnum<{
+    starting: "starting";
+    ready: "ready";
+    disconnected: "disconnected";
+    failed: "failed";
+    terminated: "terminated";
+  }>;
+  browserType: z.ZodLiteral<"chrome">;
+  startedAt: z.ZodString;
+  endedAt: z.ZodOptional<z.ZodString>;
+  authTokenRef: z.ZodString;
+}, z.core.$strip>;
+declare const CommandSchema: z.ZodObject<{
+  commandId: z.ZodString;
+  sessionId: z.ZodString;
+  type: z.ZodEnum<{
+    navigate: "navigate";
+    interact: "interact";
+    restart: "restart";
+    terminate: "terminate";
+  }>;
+  payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  submittedAt: z.ZodString;
+  completedAt: z.ZodOptional<z.ZodString>;
+  resultStatus: z.ZodOptional<z.ZodEnum<{
+    failed: "failed";
+    success: "success";
+    timed_out: "timed_out";
+  }>>;
+  resultMessage: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const SessionEventSchema: z.ZodObject<{
+  eventId: z.ZodString;
+  sessionId: z.ZodString;
+  category: z.ZodEnum<{
+    lifecycle: "lifecycle";
+    security: "security";
+    command: "command";
+  }>;
+  message: z.ZodString;
+  createdAt: z.ZodString;
+  severity: z.ZodEnum<{
+    error: "error";
+    info: "info";
+    warning: "warning";
+  }>;
+}, z.core.$strip>;
+type SessionStatus = z.infer<typeof SessionStatusSchema>;
+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 {
+  host: string;
+  wsPort: number;
+  dataDir: string;
+  browserExecutablePath?: string;
+  commandTimeoutMs: number;
+  cdpUrl?: string;
+  userProfileDir?: string;
+  headless?: boolean;
+  userAgent?: string;
+}
+declare function loadConfig(env?: NodeJS.ProcessEnv): AppConfig;
+//#endregion
+//#region src/observability/logger.d.ts
+interface LogContext {
+  [key: string]: unknown;
+}
+declare class Logger {
+  private readonly namespace;
+  constructor(namespace: string);
+  private emit;
+  info(message: string, context?: LogContext): void;
+  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;
+  private readonly bufferedLines;
+  private flushTimer;
+  private flushInFlight;
+  constructor(baseDir: string);
+  append(event: SessionEvent): void;
+  list(sessionId: string, limit?: number): SessionEvent[];
+  clear(sessionId: string): void;
+  private flushSoon;
+  private flushAsync;
+  private readonly flushSync;
+}
+//#endregion
+//#region src/auth/session-token.d.ts
+declare class SessionTokenService {
+  private readonly tokens;
+  issue(sessionId: string): string;
+  validate(sessionId: string, token: string): boolean;
+  revoke(sessionId: string): void;
+  get(sessionId: string): string | undefined;
+  seed(sessionId: string, token: string): void;
+}
+//#endregion
+//#region src/transport/ws-server.d.ts
+interface WsServerOptions {
+  host: string;
+  port: number;
+  tokenService: SessionTokenService;
+}
+declare class AuthenticatedWsServer {
+  private readonly options;
+  private readonly logger;
+  private server?;
+  constructor(options: WsServerOptions);
+  start(onMessage: (socket: WebSocket$1, data: unknown) => void): void;
+  stop(): void;
+}
+//#endregion
+//#region src/memory/memory-service.d.ts
+interface MemorySearchInput {
+  taskIntent: string;
+  siteDomain?: string;
+  limit?: number;
+}
+interface RecordExecutionInput {
+  commandId: string;
+  taskIntent: string;
+  siteDomain: string;
+  sitePathPattern: string;
+  step: TaskStep;
+  expectedOutcome: string;
+  url?: string;
+  selector?: string;
+}
+declare class MemoryService {
+  private readonly store;
+  private readonly profileStore;
+  private readonly index;
+  /** Simple TTL cache for search results keyed by intent+domain+limit. */
+  private searchCache;
+  constructor(baseDir: string);
+  /** Force an immediate synchronous flush of pending writes. */
+  flushSync(): void;
+  search(input: MemorySearchInput): MemorySearchResult[];
+  /** Invalidate search cache when data changes. */
+  private invalidateSearchCache;
+  inspect(insightId: string): TaskInsight;
+  stats(): {
+    total: number;
+    fresh: number;
+    suspect: number;
+    stale: number;
+    topDomains: Array<{
+      domain: string;
+      count: number;
+    }>;
+  };
+  verify(insightId: string): TaskInsight;
+  recordSuccess(input: RecordExecutionInput): TaskInsight;
+  recordFailure(input: 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[];
+    landmarks?: string[];
+  }): void;
+  /** Update site profile with cookie banner behavior. */
+  updateProfileCookieBanner(domain: string, result: {
+    dismissed: boolean;
+    method?: string;
+    detail?: string;
+  }): void;
+  /** Look up a site profile by domain. */
+  getSiteProfile(domain: string): SiteProfile | undefined;
+  private updateSiteProfile;
+  private createEmptyProfile;
+  private classifySelectorPattern;
+  private findBestExactMatch;
+  private scoreExactMatch;
+  private sameFirstPathSegment;
+  private createEvidence;
+  private maybeGenerateAliases;
+  private deriveAliasName;
+  private mergeRecipe;
+}
+//#endregion
+//#region src/cli/app.d.ts
+interface AppContext {
+  config: ReturnType<typeof loadConfig>;
+  logger: Logger;
+  eventStore: EventStore;
+  tokenService: SessionTokenService;
+  wsServer: AuthenticatedWsServer;
+  memoryService: MemoryService;
+}
+//#endregion
+//#region src/session/session-store.d.ts
+interface StoredSessionRecord {
+  session: Session;
+  cdpUrl: string;
+  targetWsUrl: string;
+  pid: number;
+  lastUrl?: string;
+}
+//#endregion
+//#region src/session/session-manager.d.ts
+interface CreateSessionInput {
+  browser: "chrome";
+}
+interface ExecuteCommandInput$1 {
+  commandId: string;
+  type: CommandType;
+  payload: Record<string, unknown>;
+}
+interface CleanupInput {
+  maxAgeDays?: number;
+  dryRun?: boolean;
+}
+interface CleanupResult {
+  removedSessionIds: string[];
+  removedProfileDirs: string[];
+  keptActiveSessionId?: string;
+  dryRun: boolean;
+}
+declare class SessionManager {
+  private readonly ctx;
+  private readonly browser;
+  private readonly store;
+  constructor(ctx: AppContext, browser: BrowserController);
+  createSession(input: CreateSessionInput): Promise<Session>;
+  getSession(sessionId: string): Session;
+  /** Return a healthy session, recovering automatically if needed. */
+  ensureSession(sessionId: string): Promise<StoredSessionRecord>;
+  executeCommand(sessionId: string, input: ExecuteCommandInput$1): Promise<Command>;
+  getContent(sessionId: string, options: PageContentOptions): Promise<PageContentResult>;
+  getInteractiveElements(sessionId: string, options: InteractiveElementsOptions): Promise<InteractiveElementsResult>;
+  screenshot(sessionId: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
+  getCurrentUrl(sessionId: string): Promise<string>;
+  dismissCookieBanner(sessionId: string): Promise<DismissCookieBannerResult>;
+  setStatus(status: SessionStatus, reason: string): Session;
+  terminateSession(sessionId: string): Promise<Session>;
+  restartSession(sessionId: string): Promise<Session>;
+  getAuthToken(sessionId: string): string;
+  rotateAuthToken(sessionId: string): string;
+  listEvents(sessionId: string, limit?: number): SessionEvent[];
+  searchMemory(input: {
+    taskIntent: string;
+    siteDomain?: string;
+    limit?: number;
+  }): MemorySearchResult[];
+  inspectMemory(insightId: string): {
+    insightId: string;
+    taskIntent: string;
+    siteDomain: string;
+    sitePathPattern: string;
+    actionRecipe: {
+      type: "navigate" | "interact" | "assert";
+      summary: string;
+      payload: Record<string, unknown>;
+      selector?: string | undefined;
+    }[];
+    expectedOutcome: string;
+    confidence: number;
+    successCount: number;
+    failureCount: number;
+    useCount: number;
+    freshness: "fresh" | "suspect" | "stale";
+    staleStrikeCount: number;
+    lastVerifiedAt: string;
+    createdAt: string;
+    updatedAt: string;
+    evidence: {
+      evidenceId: string;
+      commandId: string;
+      result: "success" | "failure";
+      recordedAt: string;
+      reason?: string | undefined;
+      selector?: string | undefined;
+      url?: string | undefined;
+    }[];
+    selectorAliases: {
+      alias: string;
+      selector: string;
+      fallbackSelectors: string[];
+    }[];
+    supersedes?: string | undefined;
+  };
+  verifyMemory(insightId: string): {
+    insightId: string;
+    taskIntent: string;
+    siteDomain: string;
+    sitePathPattern: string;
+    actionRecipe: {
+      type: "navigate" | "interact" | "assert";
+      summary: string;
+      payload: Record<string, unknown>;
+      selector?: string | undefined;
+    }[];
+    expectedOutcome: string;
+    confidence: number;
+    successCount: number;
+    failureCount: number;
+    useCount: number;
+    freshness: "fresh" | "suspect" | "stale";
+    staleStrikeCount: number;
+    lastVerifiedAt: string;
+    createdAt: string;
+    updatedAt: string;
+    evidence: {
+      evidenceId: string;
+      commandId: string;
+      result: "success" | "failure";
+      recordedAt: string;
+      reason?: string | undefined;
+      selector?: string | undefined;
+      url?: string | undefined;
+    }[];
+    selectorAliases: {
+      alias: string;
+      selector: string;
+      fallbackSelectors: string[];
+    }[];
+    supersedes?: string | undefined;
+  };
+  memoryStats(): {
+    total: number;
+    fresh: number;
+    suspect: number;
+    stale: number;
+    topDomains: Array<{
+      domain: string;
+      count: number;
+    }>;
+  };
+  cleanupSessions(input: CleanupInput): CleanupResult;
+  /** Quick health check — probe the CDP connection with a lightweight evaluate. */
+  private isSessionAlive;
+  /** Force-terminate a session record, cleaning up process, connection, and store. */
+  private forceTerminate;
+  private mustGetRecord;
+  private recordEvent;
+  private buildMemoryContext;
+  private parseUrl;
+}
+//#endregion
+//#region src/transport/control-api.d.ts
+declare class ControlApi {
+  private readonly sessions;
+  private readonly eventStore;
+  constructor(sessions: SessionManager, eventStore: EventStore);
+  createSession(input: {
+    browser: "chrome";
+  }): Promise<{
+    sessionId: string;
+    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    browserType: "chrome";
+    startedAt: string;
+    authTokenRef: string;
+    endedAt?: string | undefined;
+  }>;
+  getSession(sessionId: string): {
+    sessionId: string;
+    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    browserType: "chrome";
+    startedAt: string;
+    authTokenRef: string;
+    endedAt?: string | undefined;
+  };
+  terminateSession(sessionId: string): Promise<void>;
+  executeCommand(sessionId: string, input: {
+    commandId: string;
+    type: "navigate" | "interact" | "restart" | "terminate";
+    payload: Record<string, unknown>;
+  }): Promise<{
+    commandId: string;
+    sessionId: string;
+    type: "navigate" | "interact" | "restart" | "terminate";
+    payload: Record<string, unknown>;
+    submittedAt: string;
+    completedAt?: string | undefined;
+    resultStatus?: "failed" | "success" | "timed_out" | undefined;
+    resultMessage?: string | undefined;
+  }>;
+  restartSession(sessionId: string): Promise<{
+    sessionId: string;
+    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    browserType: "chrome";
+    startedAt: string;
+    authTokenRef: string;
+    endedAt?: string | undefined;
+  }>;
+  rotateSessionToken(sessionId: string): string;
+  getContent(sessionId: string, options: {
+    mode: "title" | "text" | "html" | "a11y" | "summary";
+    selector?: string;
+    maxChars?: number;
+  }): Promise<PageContentResult>;
+  getInteractiveElements(sessionId: string, options: InteractiveElementsOptions): Promise<InteractiveElementsResult>;
+  dismissCookieBanner(sessionId: string): Promise<DismissCookieBannerResult>;
+  screenshot(sessionId: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
+  getCurrentUrl(sessionId: string): Promise<string>;
+  listEvents(sessionId: string, limit?: number): {
+    events: {
+      eventId: string;
+      sessionId: string;
+      category: "lifecycle" | "security" | "command";
+      message: string;
+      createdAt: string;
+      severity: "error" | "info" | "warning";
+    }[];
+  };
+  searchMemory(input: {
+    taskIntent: string;
+    siteDomain?: string;
+    limit?: number;
+  }): {
+    results: MemorySearchResult[];
+  };
+  inspectMemory(insightId: string): {
+    insightId: string;
+    taskIntent: string;
+    siteDomain: string;
+    sitePathPattern: string;
+    actionRecipe: {
+      type: "navigate" | "interact" | "assert";
+      summary: string;
+      payload: Record<string, unknown>;
+      selector?: string | undefined;
+    }[];
+    expectedOutcome: string;
+    confidence: number;
+    successCount: number;
+    failureCount: number;
+    useCount: number;
+    freshness: "fresh" | "suspect" | "stale";
+    staleStrikeCount: number;
+    lastVerifiedAt: string;
+    createdAt: string;
+    updatedAt: string;
+    evidence: {
+      evidenceId: string;
+      commandId: string;
+      result: "success" | "failure";
+      recordedAt: string;
+      reason?: string | undefined;
+      selector?: string | undefined;
+      url?: string | undefined;
+    }[];
+    selectorAliases: {
+      alias: string;
+      selector: string;
+      fallbackSelectors: string[];
+    }[];
+    supersedes?: string | undefined;
+  };
+  verifyMemory(insightId: string): {
+    insightId: string;
+    taskIntent: string;
+    siteDomain: string;
+    sitePathPattern: string;
+    actionRecipe: {
+      type: "navigate" | "interact" | "assert";
+      summary: string;
+      payload: Record<string, unknown>;
+      selector?: string | undefined;
+    }[];
+    expectedOutcome: string;
+    confidence: number;
+    successCount: number;
+    failureCount: number;
+    useCount: number;
+    freshness: "fresh" | "suspect" | "stale";
+    staleStrikeCount: number;
+    lastVerifiedAt: string;
+    createdAt: string;
+    updatedAt: string;
+    evidence: {
+      evidenceId: string;
+      commandId: string;
+      result: "success" | "failure";
+      recordedAt: string;
+      reason?: string | undefined;
+      selector?: string | undefined;
+      url?: string | undefined;
+    }[];
+    selectorAliases: {
+      alias: string;
+      selector: string;
+      fallbackSelectors: string[];
+    }[];
+    supersedes?: string | undefined;
+  };
+  memoryStats(): {
+    total: number;
+    fresh: number;
+    suspect: number;
+    stale: number;
+    topDomains: Array<{
+      domain: string;
+      count: number;
+    }>;
+  };
+  cleanupSessions(input: {
+    maxAgeDays?: number;
+    dryRun?: boolean;
+  }): CleanupResult;
+}
+//#endregion
+//#region src/cli/runtime.d.ts
+interface AgenticBrowserCoreOptions {
+  env?: NodeJS.ProcessEnv;
+  browserController?: BrowserController;
+}
+interface ExecuteCommandInput {
+  sessionId: string;
+  commandId?: string;
+  type: CommandType;
+  payload: Record<string, unknown>;
+}
+declare class AgenticBrowserCore {
+  readonly context: AppContext;
+  readonly sessions: SessionManager;
+  readonly api: ControlApi;
+  constructor(context: AppContext, browserController: BrowserController);
+  startSession(input?: {
+    browser: "chrome";
+  }): Promise<{
+    sessionId: string;
+    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    browserType: "chrome";
+    startedAt: string;
+    authTokenRef: string;
+    endedAt?: string | undefined;
+  }>;
+  getSession(sessionId: string): {
+    sessionId: string;
+    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    browserType: "chrome";
+    startedAt: string;
+    authTokenRef: string;
+    endedAt?: string | undefined;
+  };
+  runCommand(input: ExecuteCommandInput): Promise<{
+    commandId: string;
+    sessionId: string;
+    type: "navigate" | "interact" | "restart" | "terminate";
+    payload: Record<string, unknown>;
+    submittedAt: string;
+    completedAt?: string | undefined;
+    resultStatus?: "failed" | "success" | "timed_out" | undefined;
+    resultMessage?: string | undefined;
+  }>;
+  getPageContent(input: {
+    sessionId: string;
+    mode: "title" | "text" | "html" | "a11y" | "summary";
+    selector?: string;
+    maxChars?: number;
+  }): Promise<PageContentResult>;
+  getInteractiveElements(input: {
+    sessionId: string;
+    roles?: InteractiveElementRole[];
+    visibleOnly?: boolean;
+    limit?: number;
+    selector?: string;
+  }): Promise<InteractiveElementsResult>;
+  dismissCookieBanner(sessionId: string): Promise<DismissCookieBannerResult>;
+  screenshot(sessionId: string, options?: ScreenshotOptions): Promise<ScreenshotResult>;
+  getCurrentUrl(sessionId: string): Promise<string>;
+  restartSession(sessionId: string): Promise<{
+    sessionId: string;
+    status: "starting" | "ready" | "disconnected" | "failed" | "terminated";
+    browserType: "chrome";
+    startedAt: string;
+    authTokenRef: string;
+    endedAt?: string | undefined;
+  }>;
+  stopSession(sessionId: string): Promise<void>;
+  rotateSessionToken(sessionId: string): string;
+  searchMemory(input: {
+    taskIntent: string;
+    siteDomain?: string;
+    limit?: number;
+  }): {
+    results: MemorySearchResult[];
+  };
+  inspectMemory(insightId: string): {
+    insightId: string;
+    taskIntent: string;
+    siteDomain: string;
+    sitePathPattern: string;
+    actionRecipe: {
+      type: "navigate" | "interact" | "assert";
+      summary: string;
+      payload: Record<string, unknown>;
+      selector?: string | undefined;
+    }[];
+    expectedOutcome: string;
+    confidence: number;
+    successCount: number;
+    failureCount: number;
+    useCount: number;
+    freshness: "fresh" | "suspect" | "stale";
+    staleStrikeCount: number;
+    lastVerifiedAt: string;
+    createdAt: string;
+    updatedAt: string;
+    evidence: {
+      evidenceId: string;
+      commandId: string;
+      result: "success" | "failure";
+      recordedAt: string;
+      reason?: string | undefined;
+      selector?: string | undefined;
+      url?: string | undefined;
+    }[];
+    selectorAliases: {
+      alias: string;
+      selector: string;
+      fallbackSelectors: string[];
+    }[];
+    supersedes?: string | undefined;
+  };
+  verifyMemory(insightId: string): {
+    insightId: string;
+    taskIntent: string;
+    siteDomain: string;
+    sitePathPattern: string;
+    actionRecipe: {
+      type: "navigate" | "interact" | "assert";
+      summary: string;
+      payload: Record<string, unknown>;
+      selector?: string | undefined;
+    }[];
+    expectedOutcome: string;
+    confidence: number;
+    successCount: number;
+    failureCount: number;
+    useCount: number;
+    freshness: "fresh" | "suspect" | "stale";
+    staleStrikeCount: number;
+    lastVerifiedAt: string;
+    createdAt: string;
+    updatedAt: string;
+    evidence: {
+      evidenceId: string;
+      commandId: string;
+      result: "success" | "failure";
+      recordedAt: string;
+      reason?: string | undefined;
+      selector?: string | undefined;
+      url?: string | undefined;
+    }[];
+    selectorAliases: {
+      alias: string;
+      selector: string;
+      fallbackSelectors: string[];
+    }[];
+    supersedes?: string | undefined;
+  };
+  memoryStats(): {
+    total: number;
+    fresh: number;
+    suspect: number;
+    stale: number;
+    topDomains: Array<{
+      domain: string;
+      count: number;
+    }>;
+  };
+}
+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 };