agentic-browser 2.0.1 → 2.2.0

package/README.md

@@ -113,7 +113,7 @@ agentic-browser agent start --user-agent "MyBot/1.0"
 agentic-browser agent status
 agentic-browser agent navigate https://example.com
 agentic-browser agent click "#login"
-agentic-browser agent content --mode text
+agentic-browser agent content --mode summary
 agentic-browser agent content --mode html --selector main
 agentic-browser agent elements
 agentic-browser agent elements --roles button,link --limit 20
@@ -132,7 +132,7 @@ agentic-browser agent elements --roles button,link,input --visible-only --limit
 agentic-browser agent elements --selector "#main-content"
 ```
 
-Returns a JSON array of elements with CSS selectors and fallback selectors usable in the typed agent commands like `agent click`, `agent type`, and `agent select`:
+Returns a JSON array of elements with selectors and fallback selectors usable in the typed agent commands like `agent click`, `agent type`, and `agent select`:
 
 ```json
 {
@@ -154,6 +154,10 @@ Returns a JSON array of elements with CSS selectors and fallback selectors usabl
 
 MCP responses are compact — `visible`, `actions`, and `tagName` are omitted to reduce token usage, and `enabled` is omitted when it is `true`. Responses also include a `summary` block with `countsByRole` and `primaryActions` so an LLM can identify the main controls faster. The full element shape is available via the programmatic API.
 
+When an element lives inside an open shadow root or a same-origin iframe, discovery returns a composed locator using `>>>` to cross boundaries, for example `iframe[name="checkout"] >>> button[aria-label="Pay"]`. The same locator string works with `agent click`, `agent type`, MCP `browser_interact`, and fallback selectors.
+
+`agent content` and MCP `browser_get_content` now default to `summary`, which returns a low-token overview with `title`, `headings`, `landmarks`, `primaryActions`, `inputs`, `alerts`, and iframe metadata. Use `a11y` when you need the deeper accessibility structure, and `text` or `html` only when you need raw content.
+
 ````
 
 ## MCP Server
@@ -223,8 +227,8 @@ More `interact` actions:
 ### 4. Read Page Content
 
 ```bash
+agentic-browser page:content <sessionId> --mode summary
 agentic-browser page:content <sessionId> --mode title
-agentic-browser page:content <sessionId> --mode text
 agentic-browser page:content <sessionId> --mode html --selector main
 ```
 

package/dist/cli/index.mjs

@@ -1,10 +1,9 @@
 #!/usr/bin/env node
-import { r as createCliRuntime } from "../runtime-DUSoQl5x.mjs";
+import { r as createCliRuntime } from "../runtime-CRkUsvhV.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
 import { Command } from "commander";
-
 //#region src/cli/commands/agent.ts
 const STATE_FILE_NAME = "agent-state.json";
 function stateFilePath(runtime) {
@@ -152,7 +151,8 @@ async function agentContent(runtime, input) {
 		action: "content",
 		...await runtime.api.getContent(sessionId, {
 			mode: input.mode,
-			selector: input.selector
+			selector: input.selector,
+			maxChars: input.maxChars
 		})
 	};
 }
@@ -184,7 +184,6 @@ async function agentCleanup(runtime, input) {
 		...runtime.api.cleanupSessions(input)
 	};
 }
-
 //#endregion
 //#region src/cli/output/result-formatter.ts
 function formatResult(resultStatus, message) {
@@ -193,7 +192,6 @@ function formatResult(resultStatus, message) {
 		message
 	};
 }
-
 //#endregion
 //#region src/cli/commands/session-start.ts
 async function runSessionStart(runtime, input) {
@@ -203,32 +201,27 @@ async function runSessionStart(runtime, input) {
 		sessionId: session.sessionId
 	};
 }
-
 //#endregion
 //#region src/cli/commands/session-status.ts
 async function runSessionStatus(runtime, input) {
 	return runtime.api.getSession(input.sessionId);
 }
-
 //#endregion
 //#region src/cli/commands/session-stop.ts
 async function runSessionStop(runtime, input) {
 	await runtime.api.terminateSession(input.sessionId);
 	return { terminated: true };
 }
-
 //#endregion
 //#region src/cli/commands/session-cleanup.ts
 async function runSessionCleanup(runtime, input) {
 	return runtime.api.cleanupSessions(input);
 }
-
 //#endregion
 //#region src/cli/commands/session-restart.ts
 async function runSessionRestart(runtime, input) {
 	return await runtime.api.restartSession(input.sessionId);
 }
-
 //#endregion
 //#region src/cli/commands/session-auth.ts
 async function runSessionAuth(runtime, input) {
@@ -238,7 +231,6 @@ async function runSessionAuth(runtime, input) {
 		valid: runtime.context.tokenService.validate(input.sessionId, token)
 	};
 }
-
 //#endregion
 //#region src/cli/commands/command-run.ts
 async function runCommand(runtime, input) {
@@ -253,43 +245,38 @@ async function runCommand(runtime, input) {
 		throw new Error(`Command rejected: ${error.message}`);
 	}
 }
-
 //#endregion
 //#region src/cli/commands/page-content.ts
 async function runPageContent(runtime, input) {
 	return await runtime.api.getContent(input.sessionId, {
 		mode: input.mode,
-		selector: input.selector
+		selector: input.selector,
+		maxChars: input.maxChars
 	});
 }
-
 //#endregion
 //#region src/cli/commands/memory-search.ts
 async function runMemorySearch(runtime, input) {
 	if (!input.taskIntent || !input.taskIntent.trim()) throw new Error("taskIntent is required");
 	return runtime.api.searchMemory(input);
 }
-
 //#endregion
 //#region src/cli/commands/memory-inspect.ts
 async function runMemoryInspect(runtime, input) {
 	if (!input.insightId || !input.insightId.trim()) throw new Error("insightId is required");
 	return runtime.api.inspectMemory(input.insightId);
 }
-
 //#endregion
 //#region src/cli/commands/memory-verify.ts
 async function runMemoryVerify(runtime, input) {
 	if (!input.insightId || !input.insightId.trim()) throw new Error("insightId is required");
 	return runtime.api.verifyMemory(input.insightId);
 }
-
 //#endregion
 //#region src/cli/commands/memory-stats.ts
 async function runMemoryStats(runtime) {
 	return runtime.api.memoryStats();
 }
-
 //#endregion
 //#region src/cli/index.ts
 async function main() {
@@ -337,11 +324,12 @@ async function main() {
 		});
 		console.log(JSON.stringify(result));
 	});
-	program.command("page:content").argument("<sessionId>").option("--mode <mode>", "title|text|html|a11y", "text").option("--selector <selector>", "optional CSS selector").action(async (sessionId, options) => {
+	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, {
 			sessionId,
 			mode: options.mode,
-			selector: options.selector
+			selector: options.selector,
+			maxChars: options.maxChars ? Number.parseInt(options.maxChars, 10) : void 0
 		});
 		console.log(JSON.stringify(result));
 	});
@@ -485,8 +473,12 @@ async function main() {
 		const result = await agentTerminate(runtime);
 		console.log(JSON.stringify(result));
 	});
-	agent.command("content").option("--mode <mode>", "title|text|html|a11y", "text").option("--selector <selector>", "optional CSS selector").action(async (options) => {
-		const result = await agentContent(runtime, options);
+	agent.command("content").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 (options) => {
+		const result = await agentContent(runtime, {
+			mode: options.mode,
+			selector: options.selector,
+			maxChars: options.maxChars ? Number.parseInt(options.maxChars, 10) : void 0
+		});
 		console.log(JSON.stringify(result));
 	});
 	agent.command("elements").description("List interactive elements on the current page").option("--roles <roles>", "comma-separated roles filter", (v) => v.split(",")).option("--visible-only", "only visible elements", true).option("--no-visible-only", "include hidden elements").option("--limit <n>", "max elements", "50").option("--selector <selector>", "scope to CSS selector subtree").action(async (options) => {
@@ -520,7 +512,7 @@ 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-COK-KCfv.mjs");
+		const { runSetup } = await import("../setup-BP0YyerC.mjs");
 		await runSetup();
 	});
 	await program.parseAsync(process.argv);
@@ -533,6 +525,5 @@ main().then((keepAlive) => {
 	console.error(JSON.stringify({ error: message }));
 	process.exit(1);
 });
-
 //#endregion
-export {  };
+export {};

package/dist/index.mjs

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

package/dist/mcp/index.mjs

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
-import { n as createAgenticBrowserCore } from "../runtime-DUSoQl5x.mjs";
+import { n as createAgenticBrowserCore } from "../runtime-CRkUsvhV.mjs";
 import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-
 //#region src/mcp/response-helpers.ts
 function uniqueLines(content, maxLineLength = 160) {
 	const seen = /* @__PURE__ */ new Set();
@@ -23,10 +22,27 @@ function truncateContent(content, limit) {
 	};
 	const originalLength = content.length;
 	return {
-		content: content.slice(0, limit) + `\n\n[Truncated — showing first ${limit} of ${originalLength} characters. Use a CSS selector to scope the content.]`,
+		content: content.slice(0, limit) + `\n\n[Truncated - showing first ${limit} of ${originalLength} characters. Use a CSS selector to scope the content, or use mode="summary" for a lower-token overview.]`,
 		truncated: true
 	};
 }
+function resolveCompactedContent(result, limit) {
+	if (result.truncated) return {
+		content: result.content,
+		truncated: true
+	};
+	return truncateContent(result.content, limit);
+}
+function parseStructuredSummary(result) {
+	if (result.structuredContent) return result.structuredContent;
+	if (!result.content) return;
+	try {
+		const parsed = JSON.parse(result.content);
+		return parsed && typeof parsed === "object" ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
 function summarizeTextContent(content) {
 	const lines = uniqueLines(content);
 	return {
@@ -69,9 +85,23 @@ function compactPageContent(result, maxChars) {
 		text: 8e3,
 		a11y: 1e4,
 		html: 4e3,
-		title: void 0
+		title: void 0,
+		summary: void 0
 	}[result.mode];
-	const truncated = truncateContent(result.content, limit);
+	if (result.mode === "summary") {
+		const structured = parseStructuredSummary(result);
+		if (structured) return {
+			mode: "summary",
+			...structured,
+			truncated: false
+		};
+		return {
+			mode: "summary",
+			content: result.content,
+			truncated: false
+		};
+	}
+	const truncated = resolveCompactedContent(result, limit);
 	if (result.mode === "title") return {
 		...result,
 		truncated: false
@@ -82,6 +112,7 @@ function compactPageContent(result, maxChars) {
 			mode: result.mode,
 			content: truncated.content,
 			truncated: truncated.truncated,
+			originalLength: result.originalLength,
 			summaryLines: summary.summaryLines,
 			previewLines: summary.previewLines
 		};
@@ -92,6 +123,7 @@ function compactPageContent(result, maxChars) {
 			mode: result.mode,
 			content: truncated.content,
 			truncated: truncated.truncated,
+			originalLength: result.originalLength,
 			headings: summary.headings,
 			landmarks: summary.landmarks,
 			actions: summary.actions,
@@ -102,7 +134,8 @@ function compactPageContent(result, maxChars) {
 	return {
 		mode: result.mode,
 		content: truncated.content,
-		truncated: truncated.truncated
+		truncated: truncated.truncated,
+		originalLength: result.originalLength
 	};
 }
 function summarizeElements(elements) {
@@ -156,11 +189,17 @@ function compactMemoryResults(results) {
 		return compact;
 	}) };
 }
-
 //#endregion
 //#region src/mcp/index.ts
 let core;
 let activeSessionId;
+const DEFAULT_MCP_MAX_CHARS = {
+	summary: void 0,
+	title: void 0,
+	text: 8e3,
+	a11y: 1e4,
+	html: 4e3
+};
 function getCore() {
 	if (!core) core = createAgenticBrowserCore();
 	return core;
@@ -267,26 +306,29 @@ server.tool("browser_interact", "Interact with a page element or perform browser
 		text: JSON.stringify(compact)
 	}] };
 });
-server.tool("browser_get_content", "Get the current page content. Modes: \"text\" (readable text), \"a11y\" (accessibility tree — best for understanding page structure), \"title\" (page title only), \"html\" (raw HTML). Use \"a11y\" to see the full page hierarchy with roles, names, and states. A session is auto-started if needed.", {
+server.tool("browser_get_content", "Get the current page content. Modes: \"summary\" (recommended low-token overview with headings, actions, inputs, alerts, and iframe awareness), \"text\" (readable text), \"a11y\" (accessibility tree for deeper structure), \"title\" (page title only), \"html\" (raw HTML). A session is auto-started if needed.", {
 	mode: z.enum([
 		"title",
 		"text",
 		"html",
-		"a11y"
-	]).default("text").describe("Content extraction mode"),
+		"a11y",
+		"summary"
+	]).default("summary").describe("Content extraction mode"),
 	selector: z.string().optional().describe("CSS selector to scope content (e.g. \"main\", \"#content\")"),
-	maxChars: z.number().optional().describe("Maximum characters to return (default: 12000 for text/a11y, 6000 for html, no cap for title). Use a CSS selector to scope content instead of raising this limit."),
+	maxChars: z.number().optional().describe("Maximum characters to return (default: 8000 for text, 10000 for a11y, 4000 for html, ignored for summary/title). Use a CSS selector to scope content instead of raising this limit."),
 	sessionId: z.string().optional().describe("Session ID (auto-resolved if omitted)")
 }, async ({ mode, selector, maxChars, sessionId }) => {
 	const sid = await resolveSession(sessionId);
+	const effectiveMaxChars = maxChars ?? DEFAULT_MCP_MAX_CHARS[mode];
 	const result = await getCore().getPageContent({
 		sessionId: sid,
 		mode,
-		selector
+		selector,
+		maxChars: effectiveMaxChars
 	});
 	return { content: [{
 		type: "text",
-		text: JSON.stringify(compactPageContent(result, maxChars))
+		text: JSON.stringify(compactPageContent(result))
 	}] };
 });
 server.tool("browser_get_elements", "Discover all interactive elements on the current page (buttons, links, inputs, etc.). Returns CSS selectors and fallbackSelectors you can use with browser_interact. Pass fallbackSelectors to browser_interact for automatic retry when the primary selector breaks. Actions are derived from role: link/button/custom→click, input/textarea/contenteditable→click+type+press, select→click+select, checkbox/radio→toggle. A session is auto-started if needed.", {
@@ -379,6 +421,5 @@ async function main() {
 	};
 	await server.connect(transport);
 }
-
 //#endregion
-export { main };
+export { main };