agentic-browser 2.5.0 → 2.5.1

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-BeD8ZcjH.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;

package/dist/index.d.mts

@@ -99,6 +99,7 @@ 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
@@ -600,8 +601,7 @@ 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<{

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-BeD8ZcjH.mjs";
 export { AgenticBrowserCore, createAgenticBrowserCore, createMockAgenticBrowserCore };

package/dist/mcp/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as createAgenticBrowserCore } from "../runtime-C3Y-UgC1.mjs";
+import { n as createAgenticBrowserCore } from "../runtime-BeD8ZcjH.mjs";
 import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -155,7 +155,7 @@ function summarizeElements(elements) {
 		});
 	}
 	return {
-		countsByRole: Object.fromEntries([...byRole.entries()].sort((a, b) => b[1] - a[1])),
+		countsByRole: Object.fromEntries([...byRole.entries()].toSorted((a, b) => b[1] - a[1])),
 		primaryActions
 	};
 }

package/dist/{runtime-C3Y-UgC1.mjs → runtime-BeD8ZcjH.mjs}

@@ -175,6 +175,10 @@ async function getJson(url, timeoutMs = 5e3) {
 	if (!response.ok) throw new Error(`HTTP ${response.status}: ${url}`);
 	return await response.json();
 }
+/** Debugger connection timing */
+const DEBUGGER_READY_TIMEOUT_MS = 15e3;
+const DEBUGGER_INITIAL_RETRY_DELAY_MS = 50;
+const DEBUGGER_MAX_RETRY_DELAY_MS = 250;
 /** Check if the debug port is accepting TCP connections (faster than an HTTP fetch). */
 function probePort(port) {
 	return new Promise((resolve) => {
@@ -193,16 +197,15 @@ function probePort(port) {
 	});
 }
 async function waitForDebugger(port) {
-	const maxMs = 15e3;
 	const start = Date.now();
-	let delay = 50;
-	while (Date.now() - start < maxMs) {
+	let delay = DEBUGGER_INITIAL_RETRY_DELAY_MS;
+	while (Date.now() - start < DEBUGGER_READY_TIMEOUT_MS) {
 		if (await probePort(port)) try {
 			await getJson(`http://127.0.0.1:${port}/json/version`);
 			return;
 		} catch {}
 		await new Promise((resolve) => setTimeout(resolve, delay));
-		delay = Math.min(delay * 2, 250);
+		delay = Math.min(delay * 2, DEBUGGER_MAX_RETRY_DELAY_MS);
 	}
 	throw new Error("Chrome debug endpoint did not become ready in time");
 }
@@ -694,6 +697,9 @@ function buildKeyDispatchPayload(inputKey) {
 		nativeVirtualKeyCode: 0
 	};
 }
+/** Connection pool configuration */
+const CONNECTION_IDLE_TIMEOUT_MS = 300 * 1e3;
+const CONNECTION_CLEANUP_INTERVAL_MS = 6e4;
 var ChromeCdpBrowserController = class {
 	connections = /* @__PURE__ */ new Map();
 	cleanupInterval;
@@ -701,11 +707,16 @@ var ChromeCdpBrowserController = class {
 		this.baseDir = baseDir;
 		this.connectionFactory = connectionFactory;
 		this.cleanupInterval = setInterval(() => {
-			const cutoff = Date.now() - 300 * 1e3;
+			const cutoff = Date.now() - CONNECTION_IDLE_TIMEOUT_MS;
 			for (const [url, entry] of this.connections) if (entry.lastUsedAt < cutoff) this.dropConnection(url);
-		}, 6e4);
+		}, CONNECTION_CLEANUP_INTERVAL_MS);
 		this.cleanupInterval.unref();
 	}
+	/** Stop the cleanup interval and close all connections. Call when disposing the controller. */
+	dispose() {
+		clearInterval(this.cleanupInterval);
+		for (const url of this.connections.keys()) this.dropConnection(url);
+	}
 	async getConnection(targetWsUrl) {
 		const cached = this.connections.get(targetWsUrl);
 		if (cached) {
@@ -849,12 +860,18 @@ var ChromeCdpBrowserController = class {
 		});
 	}
 	async handleDialogAction(targetWsUrl, payload) {
+		const DIALOG_WAIT_TIMEOUT_MS = 500;
+		const DIALOG_POLL_INTERVAL_MS = 10;
+		const MAX_POLL_ATTEMPTS = 10;
 		return await this.withRetry(targetWsUrl, async (conn) => {
 			await this.ensureEnabled(targetWsUrl);
 			const cached = this.connections.get(targetWsUrl);
 			if (!cached?.pendingDialog) try {
-				await conn.waitForEvent("Page.javascriptDialogOpening", 500);
-				await new Promise((r) => setTimeout(r, 50));
+				await conn.waitForEvent("Page.javascriptDialogOpening", DIALOG_WAIT_TIMEOUT_MS);
+				for (let attempt = 0; attempt < MAX_POLL_ATTEMPTS; attempt++) {
+					if (cached?.pendingDialog) break;
+					await new Promise((r) => setTimeout(r, DIALOG_POLL_INTERVAL_MS));
+				}
 			} catch {
 				return "no dialog present";
 			}
@@ -2467,6 +2484,113 @@ var MockBrowserController = class {
 	closeConnection(_targetWsUrl) {}
 };
 //#endregion
+//#region src/lib/domain-schemas.ts
+const InteractActionSchema = z.enum([
+	"click",
+	"type",
+	"press",
+	"waitFor",
+	"evaluate",
+	"scroll",
+	"hover",
+	"select",
+	"toggle",
+	"goBack",
+	"goForward",
+	"refresh",
+	"dialog"
+]);
+const InteractPayloadSchema = z.object({
+	action: InteractActionSchema,
+	selector: z.string().optional(),
+	fallbackSelectors: z.array(z.string()).optional(),
+	text: z.string().optional(),
+	key: z.string().optional(),
+	value: z.string().optional(),
+	scrollX: z.number().optional(),
+	scrollY: z.number().optional(),
+	timeoutMs: z.number().optional()
+});
+const SessionStatusSchema = z.enum([
+	"starting",
+	"ready",
+	"disconnected",
+	"failed",
+	"terminated"
+]);
+const CommandTypeSchema = z.enum([
+	"navigate",
+	"interact",
+	"restart",
+	"terminate"
+]);
+const ResultStatusSchema = z.enum([
+	"success",
+	"failed",
+	"timed_out"
+]);
+const ConnectionStateSchema = z.enum([
+	"connecting",
+	"ready",
+	"disconnected",
+	"failed"
+]);
+const EventCategorySchema = z.enum([
+	"lifecycle",
+	"security",
+	"command"
+]);
+const EventSeveritySchema = z.enum([
+	"info",
+	"warning",
+	"error"
+]);
+z.object({
+	sessionId: z.string().min(1),
+	status: SessionStatusSchema,
+	browserType: z.literal("chrome"),
+	startedAt: z.string().datetime(),
+	endedAt: z.string().datetime().optional(),
+	authTokenRef: z.string().min(1)
+}).refine((session) => session.status === "terminated" ? Boolean(session.endedAt) : true, {
+	message: "endedAt is required for terminated sessions",
+	path: ["endedAt"]
+});
+z.object({
+	commandId: z.string().min(1),
+	sessionId: z.string().min(1),
+	type: CommandTypeSchema,
+	payload: z.record(z.string(), z.unknown()),
+	submittedAt: z.string().datetime(),
+	completedAt: z.string().datetime().optional(),
+	resultStatus: ResultStatusSchema.optional(),
+	resultMessage: z.string().optional()
+}).refine((command) => command.completedAt ? Boolean(command.resultStatus) : true, {
+	message: "resultStatus is required when completedAt is set",
+	path: ["resultStatus"]
+});
+z.object({
+	sessionId: z.string().min(1),
+	state: ConnectionStateSchema,
+	lastHeartbeatAt: z.string().datetime().optional(),
+	disconnectReason: z.string().optional()
+});
+z.object({
+	sessionId: z.string().min(1),
+	tokenId: z.string().min(1),
+	issuedAt: z.string().datetime(),
+	expiresAt: z.string().datetime().optional(),
+	revokedAt: z.string().datetime().optional()
+});
+z.object({
+	eventId: z.string().min(1),
+	sessionId: z.string().min(1),
+	category: EventCategorySchema,
+	message: z.string().min(1),
+	createdAt: z.string().datetime(),
+	severity: EventSeveritySchema
+});
+//#endregion
 //#region src/session/session-store.ts
 var SessionStore = class {
 	filePath;
@@ -2610,7 +2734,7 @@ var SessionManager = class {
 			return this.mustGetRecord(recovered.sessionId);
 		} catch (restartError) {
 			this.recordEvent(sessionId, "lifecycle", "error", `Recovery failed: ${restartError.message}`);
-			throw new Error(`Session is not ready and recovery failed: ${restartError.message}`);
+			throw new Error(`Session is not ready and recovery failed: ${restartError.message}`, { cause: restartError });
 		}
 		throw new Error("Session is terminated. Start a new session.");
 	}
@@ -2639,8 +2763,11 @@ var SessionManager = class {
 				const finalUrl = await this.browser.navigate(record.targetWsUrl, url);
 				this.store.setLastUrl(sessionId, finalUrl);
 				resultMessage = `Navigated to ${finalUrl}`;
-			} else if (input.type === "interact") resultMessage = `Interaction result: ${await this.browser.interact(record.targetWsUrl, input.payload)}`;
-			else if (input.type === "restart") {
+			} else if (input.type === "interact") {
+				const parsedPayload = InteractPayloadSchema.safeParse(input.payload);
+				if (!parsedPayload.success) throw new Error(`Invalid interact payload: ${parsedPayload.error.message}`);
+				resultMessage = `Interaction result: ${await this.browser.interact(record.targetWsUrl, parsedPayload.data)}`;
+			} else if (input.type === "restart") {
 				await this.restartSession(sessionId);
 				resultMessage = "Session restarted";
 			} else if (input.type === "terminate") {
@@ -2952,9 +3079,8 @@ var SessionManager = class {
 //#endregion
 //#region src/transport/control-api.ts
 var ControlApi = class {
-	constructor(sessions, eventStore) {
+	constructor(sessions) {
 		this.sessions = sessions;
-		this.eventStore = eventStore;
 	}
 	async createSession(input) {
 		return await this.sessions.createSession(input);
@@ -2990,7 +3116,7 @@ var ControlApi = class {
 		return await this.sessions.getCurrentUrl(sessionId);
 	}
 	listEvents(sessionId, limit = 100) {
-		return { events: this.eventStore.list(sessionId, limit) };
+		return { events: this.sessions.listEvents(sessionId, limit) };
 	}
 	searchMemory(input) {
 		return { results: this.sessions.searchMemory(input) };
@@ -3215,7 +3341,7 @@ function buildSelectorHints(insight) {
 		if (!evidence.selector || evidence.result !== "success") continue;
 		weightedSelectors.set(evidence.selector, (weightedSelectors.get(evidence.selector) ?? 0) + 3);
 	}
-	return [...weightedSelectors.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5).map(([selector]) => selector);
+	return [...weightedSelectors.entries()].toSorted((a, b) => b[1] - a[1]).slice(0, 5).map(([selector]) => selector);
 }
 function buildSelectorAliases(insight) {
 	return insight.selectorAliases ?? [];
@@ -3291,7 +3417,7 @@ var MemoryIndex = class {
 			}
 			return best ? [best] : [];
 		}
-		return candidates.map((insight) => scoreInsight(insight, normalizedIntent, normalizedDomain, profileLookup)).filter((result) => result.score > 0).sort((a, b) => b.score - a.score).slice(0, limit);
+		return candidates.map((insight) => scoreInsight(insight, normalizedIntent, normalizedDomain, profileLookup)).filter((result) => result.score > 0).toSorted((a, b) => b.score - a.score).slice(0, limit);
 	}
 };
 //#endregion
@@ -3668,10 +3794,19 @@ var TaskInsightStore = class {
 };
 //#endregion
 //#region src/memory/memory-service.ts
+/** Memory service configuration */
 const SEARCH_CACHE_TTL_MS = 2e3;
+const MAX_EVIDENCE_RECORDS = 50;
+const MAX_RECIPE_STEPS = 8;
+const MAX_SELECTOR_ALIASES = 10;
+/** Site profile limits */
 const MAX_NAVIGATION_PATHS = 20;
 const MAX_LAYOUT_FINGERPRINTS = 10;
 const MAX_SELECTOR_PATTERNS = 15;
+function normalizePathSegment(value) {
+	const [firstSegment = ""] = value.replace(/\/\*$/, "").split("/").filter(Boolean);
+	return firstSegment.toLowerCase();
+}
 var MemoryService = class {
 	store;
 	profileStore;
@@ -3729,7 +3864,7 @@ var MemoryService = class {
 			fresh: insights.filter((x) => x.freshness === "fresh").length,
 			suspect: insights.filter((x) => x.freshness === "suspect").length,
 			stale: insights.filter((x) => x.freshness === "stale").length,
-			topDomains: [...byDomain.entries()].sort((a, b) => b[1] - a[1]).slice(0, 10).map(([domain, count]) => ({
+			topDomains: [...byDomain.entries()].toSorted((a, b) => b[1] - a[1]).slice(0, 10).map(([domain, count]) => ({
 				domain,
 				count
 			}))
@@ -3781,7 +3916,7 @@ var MemoryService = class {
 		const refreshed = applySuccess({
 			...matched,
 			useCount: matched.useCount + 1,
-			evidence: [...matched.evidence.slice(-49), evidence],
+			evidence: [...matched.evidence.slice(-(MAX_EVIDENCE_RECORDS - 1)), evidence],
 			actionRecipe: this.mergeRecipe(matched.actionRecipe, input.step),
 			expectedOutcome: input.expectedOutcome
 		});
@@ -3815,7 +3950,7 @@ var MemoryService = class {
 		const failed = applyFailure({
 			...matched,
 			useCount: matched.useCount + 1,
-			evidence: [...matched.evidence.slice(-49), evidence]
+			evidence: [...matched.evidence.slice(-(MAX_EVIDENCE_RECORDS - 1)), evidence]
 		}, signal);
 		this.store.upsert(failed);
 		this.invalidateSearchCache();
@@ -3837,7 +3972,7 @@ var MemoryService = class {
 		if (fpIndex >= 0) profile.layoutFingerprints[fpIndex] = fingerprint;
 		else {
 			profile.layoutFingerprints.push(fingerprint);
-			if (profile.layoutFingerprints.length > MAX_LAYOUT_FINGERPRINTS) profile.layoutFingerprints = profile.layoutFingerprints.sort((a, b) => b.lastSeenAt.localeCompare(a.lastSeenAt)).slice(0, MAX_LAYOUT_FINGERPRINTS);
+			if (profile.layoutFingerprints.length > MAX_LAYOUT_FINGERPRINTS) profile.layoutFingerprints = profile.layoutFingerprints.toSorted((a, b) => b.lastSeenAt.localeCompare(a.lastSeenAt)).slice(0, MAX_LAYOUT_FINGERPRINTS);
 		}
 		profile.lastVisitAt = now;
 		this.profileStore.upsert(profile);
@@ -3929,12 +4064,8 @@ var MemoryService = class {
 		return score;
 	}
 	sameFirstPathSegment(left, right) {
-		const normalize = (value) => {
-			const [firstSegment = ""] = value.replace(/\/\*$/, "").split("/").filter(Boolean);
-			return firstSegment.toLowerCase();
-		};
-		const leftSegment = normalize(left);
-		const rightSegment = normalize(right);
+		const leftSegment = normalizePathSegment(left);
+		const rightSegment = normalizePathSegment(right);
 		return Boolean(leftSegment) && leftSegment === rightSegment;
 	}
 	createEvidence(input, result, reason) {
@@ -3963,11 +4094,11 @@ var MemoryService = class {
 				selector,
 				fallbackSelectors: []
 			});
-			if (aliasMap.size >= 10) break;
+			if (aliasMap.size >= MAX_SELECTOR_ALIASES) break;
 		}
 		return {
 			...insight,
-			selectorAliases: [...aliasMap.values()].slice(0, 10)
+			selectorAliases: [...aliasMap.values()].slice(0, MAX_SELECTOR_ALIASES)
 		};
 	}
 	deriveAliasName(selector) {
@@ -3986,7 +4117,7 @@ var MemoryService = class {
 	}
 	mergeRecipe(recipe, step) {
 		if (recipe.find((existing) => existing.summary === step.summary && existing.selector === step.selector)) return recipe;
-		return [...recipe, step].slice(-8);
+		return [...recipe, step].slice(-MAX_RECIPE_STEPS);
 	}
 };
 //#endregion
@@ -4018,7 +4149,7 @@ var AgenticBrowserCore = class {
 	constructor(context, browserController) {
 		this.context = context;
 		this.sessions = new SessionManager(context, browserController);
-		this.api = new ControlApi(this.sessions, context.eventStore);
+		this.api = new ControlApi(this.sessions);
 	}
 	async startSession(input = { browser: "chrome" }) {
 		return await this.api.createSession(input);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-browser",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "CLI and MCP server for AI agents to control Chrome via CDP",
   "keywords": [
     "agent",
@@ -66,9 +66,9 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^14.0.3",
-    "ws": "^8.19.0",
+    "ws": "^8.20.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
@@ -76,20 +76,20 @@
     "@semantic-release/github": "^12.0.6",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@types/node": "^25.4.0",
+    "@types/node": "^25.6.0",
     "@types/ws": "^8.18.1",
-    "oxfmt": "^0.37.0",
-    "oxlint": "^1.52.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.59.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
     "semantic-release": "^25.0.3",
-    "tsdown": "^0.21.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
+    "tsdown": "^0.21.7",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4",
     "vocs": "1.4.1"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
-  "packageManager": "pnpm@10.32.0"
+  "packageManager": "pnpm@10.33.0"
 }