agentic-browser 2.2.0 → 2.4.0

package/dist/index.mjs

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

package/dist/mcp/index.d.mts

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

package/dist/mcp/index.mjs

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
-import { n as createAgenticBrowserCore } from "../runtime-CRkUsvhV.mjs";
+import { n as createAgenticBrowserCore } from "../runtime-PnWvjdzU.mjs";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -186,11 +189,42 @@ function compactMemoryResults(results) {
 			if (Array.isArray(compactAlias.fallbackSelectors) && compactAlias.fallbackSelectors.length === 0) delete compactAlias.fallbackSelectors;
 			return compactAlias;
 		});
+		if (compact.siteProfile) {
+			const profile = compact.siteProfile;
+			compact.siteProfile = {
+				selectorPatterns: (profile.selectorPatterns ?? []).map((p) => `${p.pattern} (x${p.frequency})`),
+				cookieBanner: profile.cookieBanner,
+				visitCount: profile.visitCount
+			};
+		}
 		return compact;
 	}) };
 }
 //#endregion
 //#region src/mcp/index.ts
+function readPackageVersion() {
+	try {
+		const dir = dirname(fileURLToPath(import.meta.url));
+		for (const rel of ["../../package.json", "../package.json"]) try {
+			const pkg = JSON.parse(readFileSync(join(dir, rel), "utf8"));
+			if (pkg.version) return pkg.version;
+		} catch {}
+	} catch {}
+	return "0.0.0";
+}
+function classifyError(message) {
+	const lower = message.toLowerCase();
+	if (lower.includes("not found") || lower.includes("no element")) return "SELECTOR_NOT_FOUND";
+	if (lower.includes("covered") || lower.includes("overlay")) return "ELEMENT_COVERED";
+	if (lower.includes("not editable") || lower.includes("readonly")) return "ELEMENT_NOT_EDITABLE";
+	if (lower.includes("navigation failed")) return "NAVIGATION_FAILED";
+	if (lower.includes("navigation") && lower.includes("timeout")) return "NAVIGATION_TIMEOUT";
+	if (lower.includes("cdp connection") || lower.includes("websocket")) return "CDP_DISCONNECTED";
+	if (lower.includes("session") && (lower.includes("dead") || lower.includes("terminated"))) return "SESSION_DEAD";
+	if (lower.includes("dialog")) return "DIALOG_BLOCKING";
+	if (lower.includes("timeout")) return "TIMEOUT";
+	return "UNKNOWN";
+}
 let core;
 let activeSessionId;
 const DEFAULT_MCP_MAX_CHARS = {
@@ -219,7 +253,7 @@ async function resolveSession(sessionId) {
 }
 const server = new McpServer({
 	name: "agentic-browser",
-	version: "0.1.0"
+	version: readPackageVersion()
 });
 server.tool("browser_start_session", "Start a new Chrome browser session (or return the existing one if healthy). Sessions auto-start when you call any other browser tool, so you rarely need to call this explicitly. Use this to force a fresh session after stopping the previous one.", {}, async () => {
 	const session = await getCore().startSession();
@@ -246,11 +280,17 @@ server.tool("browser_navigate", "Navigate the browser to a URL. A session is aut
 		const dismissed = await getCore().dismissCookieBanner(sid);
 		if (dismissed.dismissed) cookieBanner = dismissed;
 	} catch {}
+	let currentUrl;
+	try {
+		currentUrl = await getCore().getCurrentUrl(sid);
+	} catch {}
 	const compact = {
 		resultStatus: result.resultStatus,
 		resultMessage: result.resultMessage,
+		currentUrl,
 		cookieBanner
 	};
+	if (result.resultStatus === "failed") compact.errorCode = classifyError(result.resultMessage ?? "");
 	return { content: [{
 		type: "text",
 		text: JSON.stringify(compact)
@@ -297,10 +337,16 @@ server.tool("browser_interact", "Interact with a page element or perform browser
 		type: "interact",
 		payload
 	});
+	let currentUrl;
+	try {
+		currentUrl = await getCore().getCurrentUrl(sid);
+	} catch {}
 	const compact = {
 		resultStatus: result.resultStatus,
-		resultMessage: result.resultMessage
+		resultMessage: result.resultMessage,
+		currentUrl
 	};
+	if (result.resultStatus === "failed") compact.errorCode = classifyError(result.resultMessage ?? "");
 	return { content: [{
 		type: "text",
 		text: JSON.stringify(compact)
@@ -384,6 +430,24 @@ server.tool("browser_dismiss_cookies", "Dismiss cookie consent banners on the cu
 		text: JSON.stringify(result)
 	}] };
 });
+server.tool("browser_screenshot", "Capture a screenshot of the current page. Returns a base64-encoded image. Useful for visual verification, debugging element discovery failures, or when you need to see what the page looks like. A session is auto-started if needed.", {
+	format: z.enum(["jpeg", "png"]).default("jpeg").describe("Image format (jpeg is smaller, png is lossless)"),
+	quality: z.number().optional().describe("JPEG quality 0-100 (default 60, ignored for png)"),
+	fullPage: z.boolean().default(false).describe("Capture the full scrollable page instead of just the viewport"),
+	sessionId: z.string().optional().describe("Session ID (auto-resolved if omitted)")
+}, async ({ format, quality, fullPage, sessionId }) => {
+	const sid = await resolveSession(sessionId);
+	const result = await getCore().screenshot(sid, {
+		format,
+		quality,
+		fullPage
+	});
+	return { content: [{
+		type: "image",
+		data: result.data,
+		mimeType: result.mimeType
+	}] };
+});
 server.tool("browser_stop_session", "Stop the browser session and terminate Chrome. The next browser tool call will auto-start a fresh session.", { sessionId: z.string().optional().describe("Session ID (uses active session if omitted)") }, async ({ sessionId }) => {
 	const sid = sessionId ?? activeSessionId;
 	if (!sid) return { content: [{