agentic-browser 2.6.1 → 2.6.2

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;
@@ -100,18 +99,16 @@ interface BrowserController {
   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 +126,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 +141,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 +153,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 +230,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 +261,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 +280,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 +297,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 +304,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 +318,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 +339,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 +347,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 +371,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 +388,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 +409,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 +423,6 @@ interface AppContext {
   tokenService: SessionTokenService;
   memoryService: MemoryService;
 }
-//#endregion
-//#region src/session/session-store.d.ts
 interface StoredSessionRecord {
   session: Session;
   cdpUrl: string;
@@ -444,8 +430,6 @@ interface StoredSessionRecord {
   pid: number;
   lastUrl?: string;
 }
-//#endregion
-//#region src/session/session-manager.d.ts
 interface CreateSessionInput {
   browser: "chrome";
 }
@@ -496,36 +480,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 +517,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 +568,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 +575,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 +597,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 +606,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: {
@@ -644,7 +626,7 @@ declare class ControlApi {
     events: {
       eventId: string;
       sessionId: string;
-      category: "lifecycle" | "security" | "command";
+      category: "command" | "lifecycle" | "security";
       message: string;
       createdAt: string;
       severity: "error" | "info" | "warning";
@@ -663,36 +645,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 +682,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 +728,6 @@ declare class ControlApi {
     dryRun?: boolean;
   }): CleanupResult;
 }
-//#endregion
-//#region src/cli/runtime.d.ts
 interface AgenticBrowserCoreOptions {
   env?: NodeJS.ProcessEnv;
   browserController?: BrowserController;
@@ -758,33 +738,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;
@@ -809,11 +797,11 @@ declare class AgenticBrowserCore {
   getCurrentUrl(sessionId: string): Promise<string>;
   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 +818,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 +855,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 +897,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 };

package/dist/index.mjs

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
-import { i as createMockAgenticBrowserCore, n as createAgenticBrowserCore, t as AgenticBrowserCore } from "./runtime-BzdbtFF4.mjs";
-export { AgenticBrowserCore, createAgenticBrowserCore, createMockAgenticBrowserCore };
+export { t as AgenticBrowserCore, n as createAgenticBrowserCore, i as createMockAgenticBrowserCore } from "./runtime-Bo7FmRYk.mjs";

package/dist/mcp/index.d.mts

@@ -1,5 +1,2 @@
 
-//#region src/mcp/index.d.ts
-declare function main(): Promise<void>;
-//#endregion
-export { main };
+export declare function main(): Promise<void>;