agentic-browser 2.5.0 → 2.6.0

package/AGENTS.md

@@ -37,7 +37,7 @@ src/
     chrome-launcher.ts    — Chrome executable discovery & launch
   transport/
     control-api.ts        — ControlApi facade (delegates to SessionManager)
-    ws-server.ts          — Authenticated WebSocket server
+    auth-middleware.ts    — verifyBearerAuth() token check helper
   memory/
     memory-service.ts     — Task memory coordination
     memory-index.ts       — Search/ranking (fuzzy match + freshness + domain)

package/dist/cli/index.d.mts

@@ -1,2 +1,2 @@
 
-export { };
+export {}

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as createCliRuntime } from "../runtime-C3Y-UgC1.mjs";
+import { r as createCliRuntime } from "../runtime-BzdbtFF4.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
@@ -242,7 +242,7 @@ async function runCommand(runtime, input) {
 			payload: input.payload
 		});
 	} catch (error) {
-		throw new Error(`Command rejected: ${error.message}`);
+		throw new Error(`Command rejected: ${error.message}`, { cause: error });
 	}
 }
 //#endregion
@@ -279,11 +279,11 @@ async function runMemoryStats(runtime) {
 }
 //#endregion
 //#region src/cli/index.ts
+const collect = (value, previous = []) => [...previous, value];
 async function main() {
 	const runtime = createCliRuntime();
 	const program = new Command();
 	program.name("agentic-browser").description("Agentic browser CLI");
-	const collect = (value, previous = []) => [...previous, value];
 	program.command("session:start").option("--cdp-url <url>", "connect to existing Chrome via CDP endpoint URL").option("--user-profile <path>", "use 'default' for system Chrome profile or an absolute path").option("--headless", "run Chrome in headless mode (no visible window)").option("--user-agent <string>", "override the browser user-agent string").action(async (options) => {
 		if (options.cdpUrl) runtime.context.config.cdpUrl = options.cdpUrl;
 		if (options.userProfile) runtime.context.config.userProfileDir = options.userProfile === "true" || options.userProfile === "default" ? "default" : options.userProfile;
@@ -323,6 +323,7 @@ async function main() {
 			payload: JSON.parse(payloadJson)
 		});
 		console.log(JSON.stringify(result));
+		if (result.resultStatus === "failed" || result.resultStatus === "timed_out") process.exitCode = 1;
 	});
 	program.command("page:content").argument("<sessionId>").option("--mode <mode>", "title|text|html|a11y|summary", "summary").option("--selector <selector>", "optional CSS selector").option("--max-chars <n>", "max characters for text/html/a11y modes").action(async (sessionId, options) => {
 		const result = await runPageContent(runtime, {
@@ -512,14 +513,14 @@ async function main() {
 		await startMcpServer();
 	});
 	program.command("setup").description("Configure agentic-browser as MCP server for your AI tool").action(async () => {
-		const { runSetup } = await import("../setup-BP0YyerC.mjs");
+		const { runSetup } = await import("../setup-DUAjdbQ3.mjs");
 		await runSetup();
 	});
 	await program.parseAsync(process.argv);
 	return keepAlive;
 }
 main().then((keepAlive) => {
-	if (!keepAlive) process.exit(0);
+	if (!keepAlive) process.exit(process.exitCode ?? 0);
 }).catch((error) => {
 	const message = error instanceof Error ? error.message : String(error);
 	console.error(JSON.stringify({ error: message }));

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 
-import WebSocket, { WebSocket as WebSocket$1 } from "ws";
+import WebSocket 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 {
@@ -99,19 +98,20 @@ interface BrowserController {
   getCurrentUrl(targetWsUrl: string): Promise<string>;
   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 +129,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 +144,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 +156,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>;
@@ -236,25 +236,25 @@ interface MemorySearchResult {
 //#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 +266,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 +285,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;
@@ -305,11 +305,8 @@ 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;
@@ -336,8 +333,15 @@ declare class EventStore {
   private readonly filePath;
   private readonly bufferedLines;
   private flushTimer;
+  private pendingFlushDelayMs;
   private flushInFlight;
   constructor(baseDir: string);
+  /**
+   * Remove the process exit handlers and flush any buffered lines.
+   * Call when discarding a store (repeated context creation in tests/embedders
+   * would otherwise leak a listener pair per instance).
+   */
+  dispose(): void;
   append(event: SessionEvent): void;
   list(sessionId: string, limit?: number): SessionEvent[];
   clear(sessionId: string): void;
@@ -356,21 +360,6 @@ declare class SessionTokenService {
   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;
@@ -444,7 +433,6 @@ interface AppContext {
   logger: Logger;
   eventStore: EventStore;
   tokenService: SessionTokenService;
-  wsServer: AuthenticatedWsServer;
   memoryService: MemoryService;
 }
 //#endregion
@@ -508,36 +496,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;
@@ -545,36 +533,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;
@@ -600,25 +588,24 @@ declare class SessionManager {
 //#region src/transport/control-api.d.ts
 declare class ControlApi {
   private readonly sessions;
-  private readonly eventStore;
-  constructor(sessions: SessionManager, eventStore: EventStore);
+  constructor(sessions: SessionManager);
   createSession(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;
   };
   terminateSession(sessionId: string): Promise<void>;
   executeCommand(sessionId: string, input: {
@@ -628,7 +615,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;
@@ -637,11 +624,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: {
@@ -657,7 +644,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";
@@ -676,36 +663,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;
@@ -713,36 +700,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;
@@ -780,24 +767,24 @@ declare class AgenticBrowserCore {
     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;
@@ -822,11 +809,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;
@@ -843,36 +830,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;
@@ -880,36 +867,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;

package/dist/index.mjs

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