agentic-browser 2.0.1 → 2.1.0

package/README.md

@@ -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,8 @@ 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.
+
 ````
 
 ## MCP Server

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-CEvs2yzE.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) {
@@ -184,7 +183,6 @@ async function agentCleanup(runtime, input) {
 		...runtime.api.cleanupSessions(input)
 	};
 }
-
 //#endregion
 //#region src/cli/output/result-formatter.ts
 function formatResult(resultStatus, message) {
@@ -193,7 +191,6 @@ function formatResult(resultStatus, message) {
 		message
 	};
 }
-
 //#endregion
 //#region src/cli/commands/session-start.ts
 async function runSessionStart(runtime, input) {
@@ -203,32 +200,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 +230,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,7 +244,6 @@ 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) {
@@ -262,34 +252,29 @@ async function runPageContent(runtime, input) {
 		selector: input.selector
 	});
 }
-
 //#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() {
@@ -520,7 +505,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 +518,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-CEvs2yzE.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-CEvs2yzE.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();
@@ -156,7 +155,6 @@ function compactMemoryResults(results) {
 		return compact;
 	}) };
 }
-
 //#endregion
 //#region src/mcp/index.ts
 let core;
@@ -379,6 +377,5 @@ async function main() {
 	};
 	await server.connect(transport);
 }
-
 //#endregion
-export { main };
+export { main };