agentic-browser 2.1.0 → 2.3.0

package/dist/{runtime-CEvs2yzE.mjs → runtime-BCGndjhR.mjs}

@@ -5,8 +5,8 @@ import net from "node:net";
 import os from "node:os";
 import path from "node:path";
 import WebSocket, { WebSocketServer } from "ws";
-import { URL as URL$1, fileURLToPath } from "node:url";
 import crypto from "node:crypto";
+import { URL as URL$1 } from "node:url";
 import { z } from "zod";
 //#region src/session/chrome-launcher.ts
 const CANDIDATES = [
@@ -22,16 +22,6 @@ function discoverChrome(explicitPath) {
 	return found;
 }
 //#endregion
-//#region src/session/extension-loader.ts
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-function loadControlExtension() {
-	const packageRoot = path.resolve(__dirname, "..");
-	return {
-		extensionPath: path.resolve(packageRoot, "extension"),
-		loadedAt: (/* @__PURE__ */ new Date()).toISOString()
-	};
-}
-//#endregion
 //#region src/session/browser-controller.ts
 var CdpConnection = class CdpConnection {
 	nextId = 0;
@@ -274,6 +264,7 @@ function resolveDefaultProfileDir() {
 	if (platform === "win32") return path.join(process.env.LOCALAPPDATA ?? path.join(home, "AppData", "Local"), "Google", "Chrome", "User Data");
 	return path.join(home, ".config", "google-chrome");
 }
+const CONTENT_TRUNCATION_HINT = "Use a CSS selector to scope the content, or use mode=\"summary\" for a lower-token overview.";
 const LOCATOR_RUNTIME_HELPERS = String.raw`
       const LOCATOR_SEPARATOR = ' >>> ';
 
@@ -482,6 +473,168 @@ ${LOCATOR_RUNTIME_HELPERS}
 ${body}
     })()`;
 }
+const SPECIAL_KEY_PAYLOADS = new Map([
+	["Enter", {
+		key: "Enter",
+		code: "Enter",
+		windowsVirtualKeyCode: 13,
+		nativeVirtualKeyCode: 13,
+		text: "\r",
+		unmodifiedText: "\r"
+	}],
+	["Tab", {
+		key: "Tab",
+		code: "Tab",
+		windowsVirtualKeyCode: 9,
+		nativeVirtualKeyCode: 9
+	}],
+	["Escape", {
+		key: "Escape",
+		code: "Escape",
+		windowsVirtualKeyCode: 27,
+		nativeVirtualKeyCode: 27
+	}],
+	["Backspace", {
+		key: "Backspace",
+		code: "Backspace",
+		windowsVirtualKeyCode: 8,
+		nativeVirtualKeyCode: 8
+	}],
+	["Delete", {
+		key: "Delete",
+		code: "Delete",
+		windowsVirtualKeyCode: 46,
+		nativeVirtualKeyCode: 46
+	}],
+	["Space", {
+		key: " ",
+		code: "Space",
+		windowsVirtualKeyCode: 32,
+		nativeVirtualKeyCode: 32,
+		text: " ",
+		unmodifiedText: " "
+	}],
+	[" ", {
+		key: " ",
+		code: "Space",
+		windowsVirtualKeyCode: 32,
+		nativeVirtualKeyCode: 32,
+		text: " ",
+		unmodifiedText: " "
+	}],
+	["ArrowUp", {
+		key: "ArrowUp",
+		code: "ArrowUp",
+		windowsVirtualKeyCode: 38,
+		nativeVirtualKeyCode: 38
+	}],
+	["ArrowDown", {
+		key: "ArrowDown",
+		code: "ArrowDown",
+		windowsVirtualKeyCode: 40,
+		nativeVirtualKeyCode: 40
+	}],
+	["ArrowLeft", {
+		key: "ArrowLeft",
+		code: "ArrowLeft",
+		windowsVirtualKeyCode: 37,
+		nativeVirtualKeyCode: 37
+	}],
+	["ArrowRight", {
+		key: "ArrowRight",
+		code: "ArrowRight",
+		windowsVirtualKeyCode: 39,
+		nativeVirtualKeyCode: 39
+	}],
+	["Home", {
+		key: "Home",
+		code: "Home",
+		windowsVirtualKeyCode: 36,
+		nativeVirtualKeyCode: 36
+	}],
+	["End", {
+		key: "End",
+		code: "End",
+		windowsVirtualKeyCode: 35,
+		nativeVirtualKeyCode: 35
+	}],
+	["PageUp", {
+		key: "PageUp",
+		code: "PageUp",
+		windowsVirtualKeyCode: 33,
+		nativeVirtualKeyCode: 33
+	}],
+	["PageDown", {
+		key: "PageDown",
+		code: "PageDown",
+		windowsVirtualKeyCode: 34,
+		nativeVirtualKeyCode: 34
+	}]
+]);
+function appendTruncationNotice(content, limit, originalLength) {
+	return content + `\n\n[Truncated - showing first ${limit} of ${originalLength} characters. ${CONTENT_TRUNCATION_HINT}]`;
+}
+function applyContentLimit(content, limit, originalLength = content.length) {
+	if (!limit || originalLength <= limit) return {
+		content,
+		truncated: false
+	};
+	return {
+		content: appendTruncationNotice(content.slice(0, limit), limit, originalLength),
+		truncated: true,
+		originalLength
+	};
+}
+function normalizeRuntimeContentPayload(value, limit) {
+	if (typeof value === "string") {
+		const limited = applyContentLimit(value, limit);
+		return {
+			content: limited.content,
+			truncated: limited.truncated || void 0,
+			originalLength: limited.originalLength
+		};
+	}
+	const content = value?.content ?? "";
+	if (value?.truncated) {
+		const originalLength = value.originalLength ?? content.length;
+		const effectiveLimit = limit && limit > 0 ? limit : content.length;
+		return {
+			content: content.includes("[Truncated - showing first") || effectiveLimit === 0 ? content : appendTruncationNotice(content, effectiveLimit, originalLength),
+			truncated: true,
+			originalLength
+		};
+	}
+	const limited = applyContentLimit(content, limit, value?.originalLength ?? content.length);
+	return {
+		content: limited.content,
+		truncated: limited.truncated || void 0,
+		originalLength: limited.originalLength
+	};
+}
+function buildKeyDispatchPayload(inputKey) {
+	const key = inputKey || "Enter";
+	const special = SPECIAL_KEY_PAYLOADS.get(key);
+	if (special) return { ...special };
+	if (key.length === 1) {
+		const upper = key.toUpperCase();
+		const code = key >= "a" && key <= "z" ? `Key${upper}` : key >= "A" && key <= "Z" ? `Key${key}` : key >= "0" && key <= "9" ? `Digit${key}` : "Unidentified";
+		const keyCode = upper.charCodeAt(0);
+		return {
+			key,
+			code,
+			windowsVirtualKeyCode: keyCode,
+			nativeVirtualKeyCode: keyCode,
+			text: key,
+			unmodifiedText: key
+		};
+	}
+	return {
+		key,
+		code: key,
+		windowsVirtualKeyCode: 0,
+		nativeVirtualKeyCode: 0
+	};
+}
 var ChromeCdpBrowserController = class {
 	connections = /* @__PURE__ */ new Map();
 	cleanupInterval;
@@ -564,7 +717,6 @@ var ChromeCdpBrowserController = class {
 	async launch(sessionId, options) {
 		const { executablePath: explicitPath, userProfileDir, headless, userAgent } = options ?? {};
 		const executablePath = discoverChrome(explicitPath);
-		const extension = loadControlExtension();
 		let profileDir;
 		if (userProfileDir === "default") profileDir = resolveDefaultProfileDir();
 		else if (userProfileDir) profileDir = userProfileDir;
@@ -572,23 +724,7 @@ var ChromeCdpBrowserController = class {
 		fs.mkdirSync(profileDir, { recursive: true });
 		const lockFile = path.join(profileDir, "SingletonLock");
 		if (fs.existsSync(lockFile)) throw new Error(`Chrome profile is already in use (lock file exists: ${lockFile}). Quit the running Chrome instance first, or use --cdp-url to connect to it instead.`);
-		const launchAttempts = headless ? [{
-			withExtension: false,
-			headless: true
-		}] : [
-			{
-				withExtension: true,
-				headless: false
-			},
-			{
-				withExtension: false,
-				headless: false
-			},
-			{
-				withExtension: false,
-				headless: true
-			}
-		];
+		const launchAttempts = headless ? [{ headless: true }] : [{ headless: false }, { headless: true }];
 		let lastError;
 		for (const attempt of launchAttempts) {
 			const port = await getFreePort();
@@ -598,7 +734,6 @@ var ChromeCdpBrowserController = class {
 				"--no-first-run",
 				"--no-default-browser-check"
 			];
-			if (attempt.withExtension) args.push(`--disable-extensions-except=${extension.extensionPath}`, `--load-extension=${extension.extensionPath}`);
 			if (attempt.headless) args.push("--headless=new");
 			args.push("about:blank");
 			const child = spawn(executablePath, args, {
@@ -782,6 +917,42 @@ var ChromeCdpBrowserController = class {
 			clickCount: 1
 		});
 	}
+	async focusTarget(conn, payload) {
+		if (!payload.selector) return;
+		const expression = buildLocatorRuntimeExpression("payload", payload, `
+      const resolved = resolveWithFallbacks(payload.selector, payload.fallbackSelectors);
+      const el = resolved.element;
+      ensureInView(el);
+      if (typeof el.focus === 'function') {
+        el.focus();
+      }
+      return true;
+`);
+		await conn.send("Runtime.evaluate", {
+			expression,
+			returnByValue: true,
+			awaitPromise: true
+		});
+	}
+	async dispatchKeyPress(conn, keyInput) {
+		const payload = buildKeyDispatchPayload(keyInput ?? "Enter");
+		await conn.send("Input.dispatchKeyEvent", {
+			type: payload.text ? "keyDown" : "rawKeyDown",
+			key: payload.key,
+			code: payload.code,
+			windowsVirtualKeyCode: payload.windowsVirtualKeyCode,
+			nativeVirtualKeyCode: payload.nativeVirtualKeyCode,
+			text: payload.text,
+			unmodifiedText: payload.unmodifiedText
+		});
+		await conn.send("Input.dispatchKeyEvent", {
+			type: "keyUp",
+			key: payload.key,
+			code: payload.code,
+			windowsVirtualKeyCode: payload.windowsVirtualKeyCode,
+			nativeVirtualKeyCode: payload.nativeVirtualKeyCode
+		});
+	}
 	async interact(targetWsUrl, payload) {
 		if (payload.action === "goBack") return await this.withRetry(targetWsUrl, async (conn) => {
 			await this.ensureEnabled(targetWsUrl);
@@ -820,7 +991,7 @@ var ChromeCdpBrowserController = class {
 			return "page refreshed";
 		});
 		if (payload.action === "dialog") return await this.handleDialogAction(targetWsUrl, payload);
-		if (payload.action === "click" || payload.action === "hover" || payload.action === "type") return await this.withRetry(targetWsUrl, async (conn) => {
+		if (payload.action === "click" || payload.action === "hover" || payload.action === "type" || payload.action === "press") return await this.withRetry(targetWsUrl, async (conn) => {
 			await this.ensureEnabled(targetWsUrl);
 			if (payload.action === "click") {
 				const point = await this.preparePointerTarget(conn, payload);
@@ -843,18 +1014,15 @@ var ChromeCdpBrowserController = class {
 				});
 				return "hovered";
 			}
+			if (payload.action === "press") {
+				await this.focusTarget(conn, payload);
+				await this.dispatchKeyPress(conn, payload.key);
+				return "pressed";
+			}
 			if (await this.prepareTypeTarget(conn, payload) === "ready") await conn.send("Input.insertText", { text: payload.text ?? "" });
 			return "typed";
 		});
 		const expression = buildLocatorRuntimeExpression("payload", payload, `
-      if (payload.action === 'press') {
-        const target = deepActiveElement();
-        if (!target) throw new Error('No active element to press key on');
-        const key = payload.key ?? 'Enter';
-        target.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true }));
-        target.dispatchEvent(new KeyboardEvent('keyup', { key, bubbles: true }));
-        return 'pressed';
-      }
       if (payload.action === 'waitFor') {
         const timeout = payload.timeoutMs ?? 2000;
         const started = Date.now();
@@ -877,10 +1045,10 @@ var ChromeCdpBrowserController = class {
       if (payload.action === 'scroll') {
         if (payload.selector) {
           const el = resolveWithFallbacks(payload.selector, payload.fallbackSelectors).element;
-          el.scrollBy({ left: payload.scrollX ?? 0, top: payload.scrollY ?? 0, behavior: 'smooth' });
+          el.scrollBy({ left: payload.scrollX ?? 0, top: payload.scrollY ?? 0 });
           return 'scrolled element';
         }
-        window.scrollBy({ left: payload.scrollX ?? 0, top: payload.scrollY ?? 0, behavior: 'smooth' });
+        window.scrollBy({ left: payload.scrollX ?? 0, top: payload.scrollY ?? 0 });
         return 'scrolled page';
       }
       if (payload.action === 'select') {
@@ -909,37 +1077,234 @@ var ChromeCdpBrowserController = class {
 		});
 	}
 	async getContent(targetWsUrl, options) {
-		if (options.mode === "a11y") return {
-			mode: "a11y",
-			content: await this.getAccessibilityTree(targetWsUrl, options.selector)
-		};
+		if (options.mode === "summary") return await this.getSummaryContent(targetWsUrl, options);
+		if (options.mode === "a11y") {
+			const limited = normalizeRuntimeContentPayload(await this.getAccessibilityTree(targetWsUrl, options.selector), options.maxChars);
+			return {
+				mode: "a11y",
+				content: limited.content,
+				truncated: limited.truncated,
+				originalLength: limited.originalLength
+			};
+		}
 		const expression = buildLocatorRuntimeExpression("options", options, `
-      if (options.mode === 'title') return document.title ?? '';
+      const limit =
+        typeof options.maxChars === 'number' && Number.isFinite(options.maxChars) && options.maxChars > 0
+          ? Math.floor(options.maxChars)
+          : null;
+
+      function serializeContent(content) {
+        const normalized = typeof content === 'string' ? content : String(content ?? '');
+        const originalLength = normalized.length;
+        if (limit !== null && originalLength > limit) {
+          return { content: normalized.slice(0, limit), truncated: true, originalLength };
+        }
+        return { content: normalized, truncated: false, originalLength };
+      }
+
+      if (options.mode === 'title') return serializeContent(document.title ?? '');
       if (options.mode === 'html') {
         if (options.selector) {
           const el = resolveLocator(options.selector);
-          return el ? el.outerHTML : '';
+          return serializeContent(el ? el.outerHTML : '');
         }
-        return document.documentElement?.outerHTML ?? '';
+        return serializeContent(document.documentElement?.outerHTML ?? '');
       }
       if (options.selector) {
         const el = resolveLocator(options.selector);
-        return el ? el.innerText ?? '' : '';
+        return serializeContent(el ? el.innerText ?? '' : '');
       }
-      return document.body?.innerText ?? '';
+      return serializeContent(document.body?.innerText ?? '');
 `);
 		return await this.withRetry(targetWsUrl, async (conn) => {
 			await this.ensureEnabled(targetWsUrl);
-			const content = (await conn.send("Runtime.evaluate", {
+			const limited = normalizeRuntimeContentPayload((await conn.send("Runtime.evaluate", {
 				expression,
-				returnByValue: true
-			})).result.value ?? "";
+				returnByValue: true,
+				awaitPromise: true
+			})).result.value, options.maxChars);
 			return {
 				mode: options.mode,
-				content
+				content: limited.content,
+				truncated: limited.truncated,
+				originalLength: limited.originalLength
 			};
 		});
 	}
+	summarizeInteractiveElements(result) {
+		const primaryActions = [];
+		const inputs = [];
+		for (const element of result.elements) {
+			if (primaryActions.length < 8 && (element.role === "button" || element.role === "link" || element.role === "custom")) primaryActions.push({
+				role: element.role,
+				text: element.text,
+				selector: element.selector,
+				fallbackSelectors: element.fallbackSelectors,
+				href: element.href
+			});
+			if (inputs.length < 8 && (element.role === "input" || element.role === "textarea" || element.role === "select" || element.role === "checkbox" || element.role === "radio" || element.role === "contenteditable")) inputs.push({
+				role: element.role,
+				text: element.text,
+				selector: element.selector,
+				fallbackSelectors: element.fallbackSelectors,
+				inputType: element.inputType,
+				placeholder: element.placeholder,
+				ariaLabel: element.ariaLabel
+			});
+			if (primaryActions.length >= 8 && inputs.length >= 8) break;
+		}
+		return {
+			primaryActions,
+			inputs
+		};
+	}
+	async getSummaryContent(targetWsUrl, options) {
+		const expression = buildLocatorRuntimeExpression("options", options, `
+      const scopeSelector = options.selector;
+      let scopeRoot = document.body ?? document.documentElement;
+      if (scopeSelector) {
+        try {
+          scopeRoot = resolveLocator(scopeSelector) ?? scopeRoot;
+        } catch {
+          scopeRoot = scopeRoot ?? document.documentElement;
+        }
+      }
+
+      function escapeAttr(value) {
+        return String(value ?? '').replace(/\\\\/g, '\\\\\\\\').replace(/"/g, '\\\\"');
+      }
+
+      function uniqueValues(values, limit) {
+        const seen = new Set();
+        const results = [];
+        for (const value of values) {
+          const normalized = String(value ?? '').replace(/\\s+/g, ' ').trim();
+          if (!normalized || seen.has(normalized)) continue;
+          seen.add(normalized);
+          results.push(normalized.slice(0, 160));
+          if (results.length >= limit) break;
+        }
+        return results;
+      }
+
+      function textOf(el) {
+        if (!el) return '';
+        const ariaLabel = el.getAttribute && el.getAttribute('aria-label');
+        if (ariaLabel) return ariaLabel;
+        const text = el.innerText || el.textContent || '';
+        return text.replace(/\\s+/g, ' ').trim();
+      }
+
+      function frameSelector(frame) {
+        if (frame.id) return '#' + CSS.escape(frame.id);
+        const name = frame.getAttribute('name');
+        if (name) return 'iframe[name="' + escapeAttr(name) + '"]';
+        const title = frame.getAttribute('title');
+        if (title) return 'iframe[title="' + escapeAttr(title) + '"]';
+        const src = frame.getAttribute('src');
+        if (src) return 'iframe[src="' + escapeAttr(src) + '"]';
+        const parent = frame.parentElement;
+        if (!parent) return 'iframe';
+        const siblings = Array.from(parent.children).filter((candidate) => candidate.tagName === frame.tagName);
+        if (siblings.length === 1) return 'iframe';
+        return 'iframe:nth-of-type(' + (siblings.indexOf(frame) + 1) + ')';
+      }
+
+      const headingSelectors = 'h1,h2,h3,h4,h5,h6,[role="heading"]';
+      const landmarkSelectors = [
+        'main',
+        'nav',
+        'aside',
+        'header',
+        'footer',
+        '[role="main"]',
+        '[role="navigation"]',
+        '[role="banner"]',
+        '[role="complementary"]',
+        '[role="contentinfo"]',
+        '[role="search"]'
+      ].join(',');
+      const alertSelectors = '[role="alert"], [aria-live="assertive"], dialog[open], [aria-modal="true"]';
+
+      const headings = uniqueValues(
+        Array.from(scopeRoot.querySelectorAll(headingSelectors)).map((el) => textOf(el)),
+        8
+      );
+      const landmarks = uniqueValues(
+        Array.from(scopeRoot.querySelectorAll(landmarkSelectors)).map((el) => {
+          const role = el.getAttribute('role') || el.tagName.toLowerCase();
+          const label = textOf(el);
+          return label ? role + ' "' + label.slice(0, 80) + '"' : role;
+        }),
+        8
+      );
+      const alerts = uniqueValues(
+        Array.from(scopeRoot.querySelectorAll(alertSelectors)).map((el) => textOf(el)),
+        6
+      );
+
+      const allFrames = Array.from(scopeRoot.querySelectorAll('iframe'));
+      const frames = allFrames.slice(0, 8).map((frame) => {
+        let sameOrigin = false;
+        try {
+          sameOrigin = !!frame.contentDocument;
+        } catch {
+          sameOrigin = false;
+        }
+
+        return {
+          selector: frameSelector(frame),
+          name: frame.getAttribute('name') || undefined,
+          title: frame.getAttribute('title') || undefined,
+          src: frame.getAttribute('src') || frame.src || undefined,
+          sameOrigin,
+        };
+      });
+
+      return {
+        url: window.location.href,
+        title: document.title ?? '',
+        headings,
+        landmarks,
+        alerts,
+        frames,
+        crossOriginFrameCount: allFrames.filter((frame) => {
+          try {
+            return !frame.contentDocument;
+          } catch {
+            return true;
+          }
+        }).length,
+        hasMoreFrames: allFrames.length > frames.length,
+        scopedToSelector: scopeSelector || undefined,
+      };
+`);
+		const pageSummary = await this.withRetry(targetWsUrl, async (conn) => {
+			await this.ensureEnabled(targetWsUrl);
+			return (await conn.send("Runtime.evaluate", {
+				expression,
+				returnByValue: true,
+				awaitPromise: true
+			})).result.value ?? {};
+		});
+		const elements = await this.getInteractiveElements(targetWsUrl, {
+			selector: options.selector,
+			visibleOnly: true,
+			limit: 24
+		});
+		const elementSummary = this.summarizeInteractiveElements(elements);
+		return {
+			mode: "summary",
+			content: "",
+			structuredContent: {
+				mode: "summary",
+				...pageSummary,
+				...elementSummary,
+				totalInteractiveElements: elements.totalFound,
+				truncatedInteractiveElements: elements.truncated
+			}
+		};
+	}
 	formatAccessibilityTree(nodes) {
 		const childrenMap = /* @__PURE__ */ new Map();
 		const nodeMap = /* @__PURE__ */ new Map();
@@ -1616,17 +1981,29 @@ var MockBrowserController = class {
 	async getContent(cdpUrl, options) {
 		const page = this.pages.get(cdpUrl);
 		if (!page) throw new Error("mock page missing");
-		if (options.mode === "title") return {
-			mode: "title",
-			content: page.title
-		};
-		if (options.mode === "html") return {
-			mode: "html",
-			content: page.html
+		if (options.mode === "summary") return {
+			mode: "summary",
+			content: "",
+			structuredContent: {
+				mode: "summary",
+				url: page.url,
+				title: page.title,
+				headings: [page.title],
+				landmarks: [],
+				alerts: [],
+				frames: [],
+				primaryActions: [],
+				inputs: [],
+				totalInteractiveElements: 0,
+				truncatedInteractiveElements: false
+			}
 		};
+		const limited = applyContentLimit(options.mode === "title" ? page.title : options.mode === "html" ? page.html : page.text, options.maxChars);
 		return {
-			mode: "text",
-			content: page.text
+			mode: options.mode,
+			content: limited.content,
+			truncated: limited.truncated || void 0,
+			originalLength: limited.originalLength
 		};
 	}
 	async getInteractiveElements(_targetWsUrl, _options) {
@@ -1737,7 +2114,7 @@ var SessionManager = class {
 	constructor(ctx, browser) {
 		this.ctx = ctx;
 		this.browser = browser;
-		this.store = new SessionStore(this.ctx.config.logDir);
+		this.store = new SessionStore(this.ctx.config.dataDir);
 	}
 	async createSession(input) {
 		if (input.browser !== "chrome") throw new Error("Only chrome is supported");
@@ -1858,7 +2235,19 @@ var SessionManager = class {
 	}
 	async getContent(sessionId, options) {
 		const record = await this.ensureSession(sessionId);
-		return await this.browser.getContent(record.targetWsUrl, options);
+		const result = await this.browser.getContent(record.targetWsUrl, options);
+		if (options.mode === "summary" && result.structuredContent) {
+			const sc = result.structuredContent;
+			const url = typeof sc.url === "string" ? sc.url : record.lastUrl;
+			const parsed = this.parseUrl(url);
+			const headingTexts = (sc.headings ?? []).map((h) => typeof h === "string" ? h : h.text ?? "");
+			const landmarkTexts = (sc.landmarks ?? []).map((l) => typeof l === "string" ? l : l.role ?? "");
+			this.ctx.memoryService.updateProfileFromContent(parsed.domain, parsed.pathPattern, {
+				headings: headingTexts,
+				landmarks: landmarkTexts
+			});
+		}
+		return result;
 	}
 	async getInteractiveElements(sessionId, options) {
 		const record = await this.ensureSession(sessionId);
@@ -1866,7 +2255,10 @@ var SessionManager = class {
 	}
 	async dismissCookieBanner(sessionId) {
 		const record = await this.ensureSession(sessionId);
-		return await this.browser.dismissCookieBanner(record.targetWsUrl);
+		const result = await this.browser.dismissCookieBanner(record.targetWsUrl);
+		const parsed = this.parseUrl(record.lastUrl);
+		this.ctx.memoryService.updateProfileCookieBanner(parsed.domain, result);
+		return result;
 	}
 	setStatus(status, reason) {
 		const active = this.store.getActive();
@@ -1984,7 +2376,7 @@ var SessionManager = class {
 			removedSessionIds.push(record.session.sessionId);
 		}
 		const keepIds = new Set(keep.map((record) => record.session.sessionId));
-		const profilesDir = path.join(this.ctx.config.logDir, "profiles");
+		const profilesDir = path.join(this.ctx.config.dataDir, "profiles");
 		const removedProfileDirs = [];
 		if (fs.existsSync(profilesDir)) for (const entry of fs.readdirSync(profilesDir)) {
 			const fullPath = path.join(profilesDir, entry);
@@ -2172,7 +2564,7 @@ function loadConfig(env = process.env) {
 		host: env.AGENTIC_BROWSER_HOST ?? "127.0.0.1",
 		wsPort,
 		commandTimeoutMs,
-		logDir: env.AGENTIC_BROWSER_LOG_DIR ?? path.resolve(process.cwd(), ".agentic-browser"),
+		dataDir: env.AGENTIC_BROWSER_DIR ?? path.join(os.homedir(), ".agentic-browser"),
 		browserExecutablePath: env.AGENTIC_BROWSER_CHROME_EXECUTABLE_PATH ?? env.AGENTIC_BROWSER_CHROME_PATH,
 		cdpUrl: env.AGENTIC_BROWSER_CDP_URL,
 		userProfileDir,
@@ -2217,16 +2609,26 @@ const MAX_EVENTS_PER_SESSION = 500;
 var EventStore = class {
 	events = /* @__PURE__ */ new Map();
 	filePath;
+	bufferedLines = [];
+	flushTimer;
+	flushInFlight;
 	constructor(baseDir) {
 		fs.mkdirSync(baseDir, { recursive: true });
 		this.filePath = path.join(baseDir, "session-events.log");
+		process.once("beforeExit", this.flushSync);
+		process.once("exit", this.flushSync);
 	}
 	append(event) {
 		let existing = this.events.get(event.sessionId) ?? [];
 		existing.push(event);
 		if (existing.length > MAX_EVENTS_PER_SESSION) existing = existing.slice(-MAX_EVENTS_PER_SESSION);
 		this.events.set(event.sessionId, existing);
-		fs.appendFileSync(this.filePath, `${JSON.stringify(event)}\n`, "utf8");
+		this.bufferedLines.push(`${JSON.stringify(event)}\n`);
+		if (this.bufferedLines.length >= 20) {
+			this.flushSoon(0);
+			return;
+		}
+		this.flushSoon(25);
 	}
 	list(sessionId, limit = 100) {
 		const entries = this.events.get(sessionId) ?? [];
@@ -2235,6 +2637,36 @@ var EventStore = class {
 	clear(sessionId) {
 		this.events.delete(sessionId);
 	}
+	flushSoon(delayMs) {
+		if (this.flushInFlight) return this.flushInFlight;
+		if (this.flushTimer) return Promise.resolve();
+		this.flushTimer = setTimeout(() => {
+			this.flushTimer = void 0;
+			this.flushAsync();
+		}, delayMs);
+		this.flushTimer.unref();
+		return Promise.resolve();
+	}
+	async flushAsync() {
+		if (this.flushInFlight || this.bufferedLines.length === 0) return;
+		const chunk = this.bufferedLines.splice(0, this.bufferedLines.length).join("");
+		this.flushInFlight = fs.promises.appendFile(this.filePath, chunk, "utf8").catch(() => {}).finally(() => {
+			this.flushInFlight = void 0;
+			if (this.bufferedLines.length > 0) this.flushSoon(0);
+		});
+		await this.flushInFlight;
+	}
+	flushSync = () => {
+		if (this.flushTimer) {
+			clearTimeout(this.flushTimer);
+			this.flushTimer = void 0;
+		}
+		if (this.bufferedLines.length === 0) return;
+		const chunk = this.bufferedLines.splice(0, this.bufferedLines.length).join("");
+		try {
+			fs.appendFileSync(this.filePath, chunk, "utf8");
+		} catch {}
+	};
 };
 //#endregion
 //#region src/auth/session-token.ts
@@ -2334,7 +2766,7 @@ function selectorSignal(insight) {
 	const evidenceStrength = Math.min(selectorEvidence / 5, 1);
 	return .7 * recipeCoverage + .3 * evidenceStrength;
 }
-function scoreInsight(insight, normalizedIntent, normalizedDomain) {
+function scoreInsight(insight, normalizedIntent, normalizedDomain, profileLookup) {
 	const insightIntent = normalize(insight.taskIntent);
 	const intentMatch = insightIntent === normalizedIntent ? 1 : 0;
 	const intentPartial = intentMatch === 1 || insightIntent.includes(normalizedIntent) || normalizedIntent.includes(insightIntent) ? .65 : 0;
@@ -2342,7 +2774,7 @@ function scoreInsight(insight, normalizedIntent, normalizedDomain) {
 	const reliability = .6 * confidenceFromCounts(insight.successCount, insight.failureCount) + .4 * freshnessWeight(insight.freshness);
 	const selectorQuality = selectorSignal(insight);
 	const score = .5 * Math.max(intentMatch, intentPartial) + .2 * domainMatch + .15 * reliability + .15 * selectorQuality;
-	return {
+	const result = {
 		insightId: insight.insightId,
 		taskIntent: insight.taskIntent,
 		siteDomain: insight.siteDomain,
@@ -2353,6 +2785,14 @@ function scoreInsight(insight, normalizedIntent, normalizedDomain) {
 		selectorAliases: buildSelectorAliases(insight),
 		score
 	};
+	const profile = profileLookup?.(insight.siteDomain);
+	if (profile) result.siteProfile = {
+		selectorPatterns: profile.selectorPatterns.slice(0, 5),
+		layoutFingerprints: profile.layoutFingerprints.slice(0, 3),
+		cookieBanner: profile.cookieBanner,
+		visitCount: profile.visitCount
+	};
+	return result;
 }
 var MemoryIndex = class {
 	/** Domain → insights index, rebuilt lazily when insight list changes. */
@@ -2373,7 +2813,7 @@ var MemoryIndex = class {
 		}
 		this.indexedRefs = insights.slice();
 	}
-	search(insights, input) {
+	search(insights, input, profileLookup) {
 		const normalizedIntent = normalize(input.taskIntent);
 		const normalizedDomain = input.siteDomain ? normalize(input.siteDomain) : void 0;
 		const limit = input.limit ?? 10;
@@ -2382,7 +2822,7 @@ var MemoryIndex = class {
 		if (limit === 1 && normalizedDomain) {
 			let best;
 			for (const insight of candidates) {
-				const result = scoreInsight(insight, normalizedIntent, normalizedDomain);
+				const result = scoreInsight(insight, normalizedIntent, normalizedDomain, profileLookup);
 				if (result.score > 0 && (!best || result.score > best.score)) {
 					best = result;
 					if (best.score >= .95) break;
@@ -2390,7 +2830,7 @@ var MemoryIndex = class {
 			}
 			return best ? [best] : [];
 		}
-		return candidates.map((insight) => scoreInsight(insight, normalizedIntent, normalizedDomain)).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).sort((a, b) => b.score - a.score).slice(0, limit);
 	}
 };
 //#endregion
@@ -2421,6 +2861,20 @@ function applyFailure(insight, signal) {
 		updatedAt: now
 	};
 }
+function applyAgeStaleness(insight) {
+	const ageDays = (Date.now() - Date.parse(insight.lastVerifiedAt)) / (1440 * 60 * 1e3);
+	if (insight.freshness === "fresh" && ageDays > 30) return {
+		...insight,
+		freshness: "suspect",
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	if (insight.freshness === "suspect" && ageDays > 44) return {
+		...insight,
+		freshness: "stale",
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	return insight;
+}
 function applySuccess(insight) {
 	const now = (/* @__PURE__ */ new Date()).toISOString();
 	const successCount = insight.successCount + 1;
@@ -2487,6 +2941,147 @@ const TaskInsightSchema = z.object({
 	selectorAliases: z.array(SelectorAliasSchema).default([])
 });
 const MemoryStateSchema = z.object({ insights: z.array(TaskInsightSchema) });
+const SelectorPatternSchema = z.object({
+	pattern: z.string().min(1),
+	frequency: z.number().int().nonnegative(),
+	lastSeenAt: z.string().datetime()
+});
+const PageLayoutFingerprintSchema = z.object({
+	pathPattern: z.string().min(1),
+	headings: z.array(z.string()).default([]),
+	landmarks: z.array(z.string()).default([]),
+	lastSeenAt: z.string().datetime()
+});
+const SiteProfileSchema = z.object({
+	domain: z.string().min(1),
+	selectorPatterns: z.array(SelectorPatternSchema).default([]),
+	layoutFingerprints: z.array(PageLayoutFingerprintSchema).default([]),
+	navigationPaths: z.array(z.string()).default([]),
+	cookieBanner: z.object({
+		detected: z.boolean(),
+		autoDismissed: z.boolean().optional(),
+		method: z.string().optional()
+	}).optional(),
+	visitCount: z.number().int().nonnegative().default(0),
+	lastVisitAt: z.string().datetime(),
+	createdAt: z.string().datetime()
+});
+const SiteProfileStateSchema = z.object({ profiles: z.array(SiteProfileSchema) });
+//#endregion
+//#region src/memory/site-profile-store.ts
+const EMPTY_STATE$1 = { profiles: [] };
+const FLUSH_DELAY_MS$1 = 500;
+const REGISTERED_EXIT_HANDLERS$1 = Symbol.for("agentic-browser.site-profile-store.exit-handlers");
+const REGISTERED_STORES$1 = Symbol.for("agentic-browser.site-profile-store.instances");
+var SiteProfileStore = class {
+	filePath;
+	cached = null;
+	dirty = false;
+	flushTimer = null;
+	constructor(baseDir) {
+		const memoryDir = path.join(baseDir, "memory");
+		fs.mkdirSync(memoryDir, { recursive: true });
+		this.filePath = path.join(memoryDir, "site-profiles.json");
+		const tmpPath = `${this.filePath}.tmp`;
+		try {
+			if (fs.existsSync(tmpPath)) fs.unlinkSync(tmpPath);
+		} catch {}
+		if (!fs.existsSync(this.filePath)) this.writeDisk(EMPTY_STATE$1);
+		this.registerProcessHandlers();
+	}
+	list() {
+		return this.getCache();
+	}
+	get(domain) {
+		const normalized = domain.toLowerCase();
+		return this.getCache().find((p) => p.domain === normalized);
+	}
+	upsert(profile) {
+		SiteProfileSchema.parse(profile);
+		const profiles = this.getCache();
+		const index = profiles.findIndex((p) => p.domain === profile.domain);
+		if (index >= 0) profiles[index] = profile;
+		else profiles.push(profile);
+		this.markDirty();
+	}
+	flushSync() {
+		if (this.flushTimer) {
+			clearTimeout(this.flushTimer);
+			this.flushTimer = null;
+		}
+		if (this.dirty && this.cached) {
+			this.writeDisk({ profiles: this.cached });
+			this.dirty = false;
+		}
+	}
+	getCache() {
+		if (this.cached) return this.cached;
+		this.cached = this.readDisk().profiles;
+		return this.cached;
+	}
+	markDirty() {
+		this.dirty = true;
+		if (!this.flushTimer) this.flushTimer = setTimeout(() => {
+			this.flushTimer = null;
+			this.flushSync();
+		}, FLUSH_DELAY_MS$1);
+	}
+	readDisk() {
+		let raw;
+		try {
+			raw = JSON.parse(fs.readFileSync(this.filePath, "utf8"));
+		} catch {
+			this.backupAndReset();
+			return EMPTY_STATE$1;
+		}
+		try {
+			return SiteProfileStateSchema.parse(raw);
+		} catch {
+			const obj = raw;
+			if (Array.isArray(obj?.profiles)) {
+				const salvaged = obj.profiles.filter((item) => SiteProfileSchema.safeParse(item).success);
+				if (salvaged.length > 0) {
+					const state = { profiles: salvaged };
+					this.backupAndReset();
+					this.writeDisk(state);
+					return state;
+				}
+			}
+			this.backupAndReset();
+			return EMPTY_STATE$1;
+		}
+	}
+	backupAndReset() {
+		const corruptPath = `${this.filePath}.corrupt-${Date.now()}`;
+		try {
+			fs.copyFileSync(this.filePath, corruptPath);
+		} catch {}
+	}
+	writeDisk(state) {
+		const tempPath = `${this.filePath}.tmp`;
+		fs.writeFileSync(tempPath, JSON.stringify(state, null, 2), "utf8");
+		fs.renameSync(tempPath, this.filePath);
+	}
+	registerProcessHandlers() {
+		const proc = process;
+		const stores = proc[REGISTERED_STORES$1] ??= /* @__PURE__ */ new Set();
+		stores.add(this);
+		if (proc[REGISTERED_EXIT_HANDLERS$1]) return;
+		proc[REGISTERED_EXIT_HANDLERS$1] = true;
+		const flushAll = () => {
+			for (const store of stores) store.flushSync();
+		};
+		process.on("exit", flushAll);
+		process.on("SIGINT", () => {
+			flushAll();
+			process.exit(0);
+		});
+		process.on("SIGTERM", () => {
+			flushAll();
+			process.exit(0);
+		});
+	}
+};
 //#endregion
 //#region src/memory/task-insight-store.ts
 const EMPTY_STATE = { insights: [] };
@@ -2613,25 +3208,42 @@ var TaskInsightStore = class {
 //#endregion
 //#region src/memory/memory-service.ts
 const SEARCH_CACHE_TTL_MS = 2e3;
+const MAX_NAVIGATION_PATHS = 20;
+const MAX_LAYOUT_FINGERPRINTS = 10;
+const MAX_SELECTOR_PATTERNS = 15;
 var MemoryService = class {
 	store;
+	profileStore;
 	index;
 	/** Simple TTL cache for search results keyed by intent+domain+limit. */
 	searchCache = /* @__PURE__ */ new Map();
 	constructor(baseDir) {
 		this.store = new TaskInsightStore(baseDir);
+		this.profileStore = new SiteProfileStore(baseDir);
 		this.index = new MemoryIndex();
 	}
 	/** Force an immediate synchronous flush of pending writes. */
 	flushSync() {
 		this.store.flushSync();
+		this.profileStore.flushSync();
 	}
 	search(input) {
 		const cacheKey = `${input.taskIntent}\0${input.siteDomain ?? ""}\0${input.limit ?? 10}`;
 		const now = Date.now();
 		const cached = this.searchCache.get(cacheKey);
 		if (cached && now - cached.ts < SEARCH_CACHE_TTL_MS) return cached.results;
-		const results = this.index.search(this.store.list(), input);
+		const insights = this.store.list();
+		let mutated = false;
+		for (let i = 0; i < insights.length; i++) {
+			const decayed = applyAgeStaleness(insights[i]);
+			if (decayed.freshness !== insights[i].freshness) {
+				insights[i] = decayed;
+				this.store.upsert(decayed);
+				mutated = true;
+			}
+		}
+		if (mutated) this.searchCache.clear();
+		const results = this.index.search(insights, input, (domain) => this.profileStore.get(domain));
 		this.searchCache.set(cacheKey, {
 			results,
 			ts: now
@@ -2675,6 +3287,7 @@ var MemoryService = class {
 		return verified;
 	}
 	recordSuccess(input) {
+		this.updateSiteProfile(input.siteDomain, input.selector, input.url, input.sitePathPattern);
 		const insights = this.store.list();
 		const matched = this.findBestExactMatch(insights, input);
 		const evidence = this.createEvidence(input, "success");
@@ -2732,6 +3345,7 @@ var MemoryService = class {
 		return withAliases;
 	}
 	recordFailure(input, errorMessage) {
+		this.updateSiteProfile(input.siteDomain, input.selector, input.url, input.sitePathPattern);
 		const insights = this.store.list();
 		const matched = this.findBestExactMatch(insights, input);
 		if (!matched) return;
@@ -2746,6 +3360,91 @@ var MemoryService = class {
 		this.invalidateSearchCache();
 		return failed;
 	}
+	/** Update site profile from page content (call after getContent with mode="summary"). */
+	updateProfileFromContent(domain, pathPattern, structuredContent) {
+		if (!domain || domain === "unknown") return;
+		const normalized = domain.toLowerCase();
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const profile = this.profileStore.get(normalized) ?? this.createEmptyProfile(normalized, now);
+		const fingerprint = {
+			pathPattern,
+			headings: (structuredContent.headings ?? []).slice(0, 8),
+			landmarks: (structuredContent.landmarks ?? []).slice(0, 8),
+			lastSeenAt: now
+		};
+		const fpIndex = profile.layoutFingerprints.findIndex((fp) => fp.pathPattern === pathPattern);
+		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);
+		}
+		profile.lastVisitAt = now;
+		this.profileStore.upsert(profile);
+	}
+	/** Update site profile with cookie banner behavior. */
+	updateProfileCookieBanner(domain, result) {
+		if (!domain || domain === "unknown") return;
+		const normalized = domain.toLowerCase();
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const profile = this.profileStore.get(normalized) ?? this.createEmptyProfile(normalized, now);
+		profile.cookieBanner = {
+			detected: true,
+			autoDismissed: result.dismissed,
+			method: result.method
+		};
+		profile.lastVisitAt = now;
+		this.profileStore.upsert(profile);
+	}
+	/** Look up a site profile by domain. */
+	getSiteProfile(domain) {
+		return this.profileStore.get(domain);
+	}
+	updateSiteProfile(domain, selector, url, pathPattern) {
+		if (!domain || domain === "unknown") return;
+		const normalized = domain.toLowerCase();
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const profile = this.profileStore.get(normalized) ?? this.createEmptyProfile(normalized, now);
+		profile.visitCount += 1;
+		profile.lastVisitAt = now;
+		if (selector) {
+			const pattern = this.classifySelectorPattern(selector);
+			if (pattern) {
+				const existing = profile.selectorPatterns.find((p) => p.pattern === pattern);
+				if (existing) {
+					existing.frequency += 1;
+					existing.lastSeenAt = now;
+				} else if (profile.selectorPatterns.length < MAX_SELECTOR_PATTERNS) profile.selectorPatterns.push({
+					pattern,
+					frequency: 1,
+					lastSeenAt: now
+				});
+			}
+		}
+		if (pathPattern && pathPattern !== "/") {
+			if (!profile.navigationPaths.includes(pathPattern) && profile.navigationPaths.length < MAX_NAVIGATION_PATHS) profile.navigationPaths.push(pathPattern);
+		}
+		this.profileStore.upsert(profile);
+	}
+	createEmptyProfile(domain, now) {
+		return {
+			domain,
+			selectorPatterns: [],
+			layoutFingerprints: [],
+			navigationPaths: [],
+			visitCount: 0,
+			lastVisitAt: now,
+			createdAt: now
+		};
+	}
+	classifySelectorPattern(selector) {
+		if (selector.includes("[data-testid=")) return "data-testid";
+		if (selector.includes("[data-cy=")) return "data-cy";
+		if (selector.includes("[data-test=")) return "data-test";
+		if (selector.includes("[aria-label=")) return "aria-label";
+		if (selector.includes("[name=")) return "name-attribute";
+		if (/^#[\w-]+$/.test(selector)) return "id-selector";
+		if (selector.includes("[role=")) return "role-attribute";
+	}
 	findBestExactMatch(insights, input) {
 		const intentLower = input.taskIntent.toLowerCase();
 		const domainLower = input.siteDomain.toLowerCase();
@@ -2834,7 +3533,7 @@ var MemoryService = class {
 function createAppContext(env = process.env) {
 	const config = loadConfig(env);
 	const logger = new Logger("app");
-	const eventStore = new EventStore(config.logDir);
+	const eventStore = new EventStore(config.dataDir);
 	const tokenService = new SessionTokenService();
 	return {
 		config,
@@ -2846,7 +3545,7 @@ function createAppContext(env = process.env) {
 			port: config.wsPort,
 			tokenService
 		}),
-		memoryService: new MemoryService(config.logDir)
+		memoryService: new MemoryService(config.dataDir)
 	};
 }
 //#endregion
@@ -2876,7 +3575,8 @@ var AgenticBrowserCore = class {
 	async getPageContent(input) {
 		return await this.api.getContent(input.sessionId, {
 			mode: input.mode,
-			selector: input.selector
+			selector: input.selector,
+			maxChars: input.maxChars
 		});
 	}
 	async getInteractiveElements(input) {
@@ -2914,7 +3614,7 @@ var AgenticBrowserCore = class {
 };
 function createAgenticBrowserCore(options = {}) {
 	const context = createAppContext(options.env);
-	return new AgenticBrowserCore(context, options.browserController ?? new ChromeCdpBrowserController(context.config.logDir));
+	return new AgenticBrowserCore(context, options.browserController ?? new ChromeCdpBrowserController(context.config.dataDir));
 }
 function createMockAgenticBrowserCore(env) {
 	return new AgenticBrowserCore(createAppContext(env), new MockBrowserController());