@akshayram1/omnibrowser-agent 0.2.3 → 0.2.6

package/README.md

@@ -20,7 +20,7 @@ Local-first open-source browser AI operator using in-browser planning and page a
 
 - MV3 browser extension runtime
 - TypeScript + esbuild
-- Pluggable planner bridges: WebLLM and page-agent
+- Pluggable planner bridges: WebLLM (local, in-browser)
 
 ## Project structure
 
@@ -139,8 +139,12 @@ It is preconfigured to use `webllm` planner mode and loads `@mlc-ai/web-llm` fro
 
 ### v0.2.2
 
-- **page-agent planner**: added `"page-agent"` as a third `PlannerKind`, backed by a `window.__browserAgentPageAgent` bridge (same zero-deps pattern as WebLLM)
-- **Popup**: added page-agent option to the planner dropdown
+- SDK/extension separation: core logic moved to `src/core/` shared between extension and npm library
+- 22 unit tests across planner and safety modules
+- Action verification in executor (disabled-check, value-verify, empty-check)
+- `CandidateElement.label` from associated `<label>` elements
+- Retry loop with `lastError` fed back to planner on failure
+- `parseAction` utility exported from the library
 
 ### v0.2.0
 
@@ -164,39 +168,12 @@ It is preconfigured to use `webllm` planner mode and loads `@mlc-ai/web-llm` fro
 | Mode | Description |
 |---|---|
 | `heuristic` | Zero-dependency regex-based planner. Works offline. Good for simple, predictable goals. |
-| `webllm` | Delegates to a local WebLLM bridge on `window.__browserAgentWebLLM`. Fully private, no API calls. |
-| `page-agent` | Delegates to an [alibaba/page-agent](https://github.com/alibaba/page-agent) bridge on `window.__browserAgentPageAgent`. Use for complex multi-step tasks with LLM planning. |
-
-### page-agent bridge example
-
-```ts
-import { PageAgent } from "page-agent";
-
-const pa = new PageAgent({
-  baseURL: "https://api.openai.com/v1",
-  model: "gpt-4o",
-  apiKey: "sk-..."
-});
-
-window.__browserAgentPageAgent = {
-  async plan(input) {
-    const result = await pa.execute(input.goal);
-    return { type: "done", reason: result.data };
-  }
-};
-```
-
-Then configure:
-
-```ts
-planner: { kind: "page-agent" }
-```
+| `webllm` | Delegates to a local WebLLM bridge on `window.__browserAgentWebLLM`. Fully private, no API calls, runs on-device via WebGPU. |
 
 ## Notes
 
 - Local inference has no API usage charges, but uses device CPU/GPU/memory.
-- `webllm` mode expects a local bridge implementation attached to `window.__browserAgentWebLLM`.
-- `page-agent` mode expects a bridge on `window.__browserAgentPageAgent`. The `page-agent` package is not bundled — bring your own instance.
+- `webllm` mode expects a bridge implementation attached to `window.__browserAgentWebLLM`. See `docs/EMBEDDING.md` for a complete example.
 
 ## Roadmap
 

package/dist/content.js

@@ -195,7 +195,7 @@ var CLICK_PATTERN = /click(?:\s+(?:on|the))?\s+(.+)/i;
 function findByText(candidates, text) {
   const lower = text.toLowerCase();
   return candidates.find(
-    (c) => c.text.toLowerCase().includes(lower) || (c.placeholder?.toLowerCase().includes(lower) ?? false)
+    (c) => c.text.toLowerCase().includes(lower) || (c.placeholder?.toLowerCase().includes(lower) ?? false) || (c.label?.toLowerCase().includes(lower) ?? false)
   );
 }
 function findInput(candidates) {
@@ -219,14 +219,14 @@ function heuristicPlan(input) {
     const [, text, fieldHint] = fillMatch;
     const target = findByText(snapshot.candidates, fieldHint) ?? findInput(snapshot.candidates);
     if (target) {
-      return { type: "type", selector: target.selector, text, clearFirst: true, label: target.text || target.placeholder };
+      return { type: "type", selector: target.selector, text, clearFirst: true, label: target.label || target.text || target.placeholder };
     }
   }
   const searchMatch = goal.match(SEARCH_PATTERN);
   if (searchMatch) {
     const input2 = findInput(snapshot.candidates);
     if (input2) {
-      return { type: "type", selector: input2.selector, text: searchMatch[1].trim(), clearFirst: true, label: input2.text || input2.placeholder };
+      return { type: "type", selector: input2.selector, text: searchMatch[1].trim(), clearFirst: true, label: input2.label || input2.text || input2.placeholder };
     }
   }
   const clickMatch = goal.match(CLICK_PATTERN);
@@ -240,59 +240,61 @@ function heuristicPlan(input) {
   const firstButton = findButton(snapshot.candidates);
   if (firstInput && !history.some((h) => h.startsWith("Typed"))) {
     const searchTerm = goal.replace(/.*(?:search|find|look up)\s+/i, "").trim();
-    return { type: "type", selector: firstInput.selector, text: searchTerm, clearFirst: true, label: firstInput.text || firstInput.placeholder };
+    return { type: "type", selector: firstInput.selector, text: searchTerm, clearFirst: true, label: firstInput.label || firstInput.text || firstInput.placeholder };
   }
   if (firstButton && !history.some((h) => h.startsWith("Clicked"))) {
     return { type: "click", selector: firstButton.selector, label: firstButton.text };
   }
   return { type: "done", reason: "No further heuristic actions available" };
 }
+function toPlannerResult(raw) {
+  if ("action" in raw && typeof raw.action === "object") {
+    return raw;
+  }
+  return { action: raw };
+}
 async function planNextAction(config, input) {
   if (config.kind === "heuristic") {
-    return heuristicPlan(input);
-  }
-  if (config.kind === "page-agent") {
-    const pageAgentBridge = window.__browserAgentPageAgent;
-    if (!pageAgentBridge) {
-      return {
-        type: "done",
-        reason: "page-agent bridge is not configured. Assign a PageAgentBridge to window.__browserAgentPageAgent."
-      };
-    }
-    return pageAgentBridge.plan(input);
+    return { action: heuristicPlan(input) };
   }
   const bridge = window.__browserAgentWebLLM;
   if (!bridge) {
     return {
-      type: "done",
-      reason: "WebLLM bridge is not configured. Use heuristic mode or wire a local bridge implementation."
+      action: {
+        type: "done",
+        reason: "WebLLM bridge is not configured. Use heuristic mode or wire a WebLLM bridge implementation."
+      }
     };
   }
-  return bridge.plan(input, config.modelId);
+  const raw = await bridge.plan(input, config.modelId);
+  return toPlannerResult(raw);
 }
 
 // src/content/index.ts
 var stopped = false;
 async function runTick(session) {
   const snapshot = collectSnapshot();
-  const action = await planNextAction(session.planner, {
+  const plannerResult = await planNextAction(session.planner, {
     goal: session.goal,
     snapshot,
     history: session.history,
-    lastError: session.lastError
+    lastError: session.lastError,
+    memory: session.memory
   });
+  const { action } = plannerResult;
+  const reflection = plannerResult.evaluation !== void 0 || plannerResult.memory !== void 0 || plannerResult.nextGoal !== void 0 ? { evaluation: plannerResult.evaluation, memory: plannerResult.memory, nextGoal: plannerResult.nextGoal } : void 0;
   const risk = assessRisk(action);
   if (risk === "blocked") {
-    return { status: "blocked", action, message: `Blocked action: ${JSON.stringify(action)}` };
+    return { status: "blocked", action, message: `Blocked action: ${JSON.stringify(action)}`, reflection };
   }
   if (session.mode === "human-approved" && risk === "review") {
-    return { status: "needs_approval", action, message: `Approval needed for ${action.type}` };
+    return { status: "needs_approval", action, message: `Approval needed for ${action.type}`, reflection };
   }
   if (action.type === "done") {
-    return { status: "done", action, message: action.reason };
+    return { status: "done", action, message: action.reason, reflection };
   }
   const message = await executeAction(action);
-  return { status: "executed", action, message };
+  return { status: "executed", action, message, reflection };
 }
 async function executePendingAction(session) {
   if (!session.pendingAction) {

package/dist/content.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/shared/safety.ts", "../src/core/executor.ts", "../src/core/observer.ts", "../src/core/planner.ts", "../src/content/index.ts"],
-  "sourcesContent": ["import type { AgentAction, RiskLevel } from \"./contracts\";\n\nconst RISKY_KEYWORDS = /\\b(delete|remove|pay|purchase|submit|confirm|checkout|transfer|withdraw|send)\\b/i;\n\nfunction elementTextRisky(text?: string): boolean {\n  return text != null && RISKY_KEYWORDS.test(text);\n}\n\nexport function assessRisk(action: AgentAction): RiskLevel {\n  switch (action.type) {\n    case \"navigate\": {\n      try {\n        const next = new URL(action.url);\n        if (![\"http:\", \"https:\"].includes(next.protocol)) {\n          return \"blocked\";\n        }\n      } catch {\n        return \"blocked\";\n      }\n      return \"safe\";\n    }\n    case \"click\":\n      return elementTextRisky(action.label) ? \"review\" : \"safe\";\n    case \"type\":\n      return elementTextRisky(action.label) ? \"review\" : \"safe\";\n    case \"focus\":\n    case \"scroll\":\n    case \"wait\":\n      return \"safe\";\n    case \"extract\":\n      return \"review\";\n    case \"done\":\n      return \"safe\";\n    default:\n      return \"review\";\n  }\n}\n", "import type { AgentAction } from \"../shared/contracts\";\n\nfunction mustFind(selector: string): HTMLElement {\n  const node = document.querySelector(selector);\n  if (!(node instanceof HTMLElement)) {\n    throw new Error(`Selector not found: ${selector}`);\n  }\n  return node;\n}\n\nfunction dispatchInputEvents(el: HTMLInputElement | HTMLTextAreaElement): void {\n  el.dispatchEvent(new InputEvent(\"input\", { bubbles: true, cancelable: true }));\n  el.dispatchEvent(new Event(\"change\", { bubbles: true }));\n}\n\nexport async function executeAction(action: AgentAction): Promise<string> {\n  switch (action.type) {\n    case \"click\": {\n      const el = mustFind(action.selector);\n      if ((el as HTMLButtonElement).disabled) {\n        throw new Error(`Element is disabled: ${action.selector}`);\n      }\n      el.click();\n      return `Clicked ${action.selector}`;\n    }\n    case \"type\": {\n      const input = mustFind(action.selector) as HTMLInputElement | HTMLTextAreaElement;\n      input.focus();\n      if (action.clearFirst) {\n        input.value = \"\";\n        dispatchInputEvents(input);\n      }\n      input.value = `${input.value}${action.text}`;\n      dispatchInputEvents(input);\n      if (input.value.indexOf(action.text) === -1) {\n        throw new Error(`Type verification failed: value did not update for ${action.selector}`);\n      }\n      return `Typed into ${action.selector}`;\n    }\n    case \"navigate\": {\n      window.location.href = action.url;\n      return `Navigated to ${action.url}`;\n    }\n    case \"extract\": {\n      const value = mustFind(action.selector).innerText.trim();\n      if (!value) {\n        throw new Error(`Extract returned empty text from ${action.selector}`);\n      }\n      return `${action.label}: ${value}`;\n    }\n    case \"scroll\": {\n      const target = action.selector ? mustFind(action.selector) : document.documentElement;\n      target.scrollBy({ top: action.deltaY, behavior: \"smooth\" });\n      return `Scrolled ${action.deltaY > 0 ? \"down\" : \"up\"} ${Math.abs(action.deltaY)}px`;\n    }\n    case \"focus\": {\n      mustFind(action.selector).focus();\n      return `Focused ${action.selector}`;\n    }\n    case \"wait\": {\n      await new Promise((resolve) => setTimeout(resolve, action.ms));\n      return `Waited ${action.ms}ms`;\n    }\n    case \"done\": {\n      return action.reason;\n    }\n    default:\n      return \"No-op\";\n  }\n}\n", "import type { CandidateElement, PageSnapshot } from \"../shared/contracts\";\n\nconst CANDIDATE_SELECTOR =\n  \"a,button,input,textarea,select,[role='button'],[role='link'],[contenteditable='true']\";\n\nconst MAX_CANDIDATES = 60;\n\nfunction cssPath(element: Element): string {\n  if (!(element instanceof HTMLElement)) {\n    return element.tagName.toLowerCase();\n  }\n\n  if (element.id) {\n    return `#${CSS.escape(element.id)}`;\n  }\n\n  const parts: string[] = [];\n  let current: HTMLElement | null = element;\n  while (current && parts.length < 4) {\n    let part = current.tagName.toLowerCase();\n    if (current.classList.length > 0) {\n      part += `.${Array.from(current.classList).slice(0, 2).map(CSS.escape).join(\".\")}`;\n    }\n    const parent: HTMLElement | null = current.parentElement;\n    if (parent) {\n      const siblings = Array.from(parent.children).filter((s: Element) => s.tagName === current!.tagName);\n      if (siblings.length > 1) {\n        const index = siblings.indexOf(current) + 1;\n        part += `:nth-of-type(${index})`;\n      }\n    }\n    parts.unshift(part);\n    current = parent;\n  }\n  return parts.join(\" > \");\n}\n\nfunction isVisible(el: HTMLElement): boolean {\n  if (el.offsetParent === null && el.tagName !== \"BODY\") return false;\n  const style = window.getComputedStyle(el);\n  if (style.display === \"none\" || style.visibility === \"hidden\" || style.opacity === \"0\") return false;\n  // Zero-dimension elements are functionally hidden\n  const rect = el.getBoundingClientRect();\n  return rect.width > 0 || rect.height > 0;\n}\n\nfunction isInViewport(el: HTMLElement): boolean {\n  const rect = el.getBoundingClientRect();\n  return (\n    rect.bottom > 0 &&\n    rect.top < window.innerHeight &&\n    rect.right > 0 &&\n    rect.left < window.innerWidth\n  );\n}\n\n/** Resolve the visible label text via for/id, aria-labelledby, aria-label, or wrapping <label>. */\nfunction getAssociatedLabel(el: HTMLElement): string {\n  if (el.id) {\n    const label = document.querySelector<HTMLLabelElement>(`label[for=\"${CSS.escape(el.id)}\"]`);\n    if (label) return label.innerText.trim();\n  }\n\n  const labelledBy = el.getAttribute(\"aria-labelledby\");\n  if (labelledBy) {\n    const labelEl = document.getElementById(labelledBy);\n    if (labelEl) return labelEl.innerText.trim();\n  }\n\n  const ariaLabel = el.getAttribute(\"aria-label\");\n  if (ariaLabel) return ariaLabel.trim();\n\n  const parentLabel = el.closest(\"label\");\n  if (parentLabel) {\n    return Array.from(parentLabel.childNodes)\n      .filter((n) => n.nodeType === Node.TEXT_NODE)\n      .map((n) => n.textContent?.trim() ?? \"\")\n      .filter(Boolean)\n      .join(\" \");\n  }\n\n  return \"\";\n}\n\nexport function collectSnapshot(): PageSnapshot {\n  const allNodes = Array.from(\n    document.querySelectorAll<HTMLElement>(CANDIDATE_SELECTOR)\n  ).filter(isVisible);\n\n  // In-viewport elements first so the model sees the most relevant candidates first\n  const inView = allNodes.filter(isInViewport);\n  const offScreen = allNodes.filter((el) => !isInViewport(el));\n  const nodes = [...inView, ...offScreen].slice(0, MAX_CANDIDATES);\n\n  const candidates: CandidateElement[] = nodes.map((node) => {\n    const placeholder =\n      (node as HTMLInputElement).placeholder?.trim() || node.getAttribute(\"placeholder\")?.trim();\n    const associatedLabel = getAssociatedLabel(node);\n    return {\n      selector: cssPath(node),\n      role: node.getAttribute(\"role\") ?? node.tagName.toLowerCase(),\n      text: (node.innerText || node.getAttribute(\"name\") || \"\").trim().slice(0, 120),\n      placeholder: placeholder || undefined,\n      label: associatedLabel || undefined,\n    };\n  });\n\n  const textPreview = document.body.innerText.replace(/\\s+/g, \" \").trim().slice(0, 1500);\n\n  return {\n    url: window.location.href,\n    title: document.title,\n    textPreview,\n    candidates,\n  };\n}\n", "import type { AgentAction, CandidateElement, PlannerConfig, PlannerInput } from \"../shared/contracts\";\n\ntype WebLLMBridge = {\n  plan(input: PlannerInput, modelId?: string): Promise<AgentAction>;\n};\n\ntype PageAgentBridge = {\n  plan(input: PlannerInput): Promise<AgentAction>;\n};\n\nconst URL_PATTERN = /(?:go to|navigate to|open)\\s+(https?:\\/\\/\\S+)/i;\nconst SEARCH_PATTERN = /search(?:\\s+for)?\\s+(.+)/i;\nconst FILL_PATTERN = /(?:fill|type|enter)\\s+\"?([^\"]+)\"?\\s+(?:in(?:to)?|for|on)\\s+(.+)/i;\nconst CLICK_PATTERN = /click(?:\\s+(?:on|the))?\\s+(.+)/i;\n\nfunction findByText(candidates: CandidateElement[], text: string): CandidateElement | undefined {\n  const lower = text.toLowerCase();\n  return candidates.find(\n    (c) =>\n      c.text.toLowerCase().includes(lower) ||\n      (c.placeholder?.toLowerCase().includes(lower) ?? false)\n  );\n}\n\nfunction findInput(candidates: CandidateElement[]): CandidateElement | undefined {\n  return candidates.find(\n    (c) => c.role === \"input\" || c.role === \"textarea\" || c.selector.includes(\"input\") || c.selector.includes(\"textarea\")\n  );\n}\n\nfunction findButton(candidates: CandidateElement[]): CandidateElement | undefined {\n  return candidates.find(\n    (c) => c.role === \"button\" || c.role === \"a\" || c.selector.includes(\"button\") || c.selector.includes(\"a\")\n  );\n}\n\nfunction heuristicPlan(input: PlannerInput): AgentAction {\n  const { goal, snapshot, history } = input;\n\n  const navMatch = goal.match(URL_PATTERN);\n  if (navMatch) {\n    return { type: \"navigate\", url: navMatch[1] };\n  }\n\n  const fillMatch = goal.match(FILL_PATTERN);\n  if (fillMatch) {\n    const [, text, fieldHint] = fillMatch;\n    const target = findByText(snapshot.candidates, fieldHint) ?? findInput(snapshot.candidates);\n    if (target) {\n      return { type: \"type\", selector: target.selector, text, clearFirst: true, label: target.text || target.placeholder };\n    }\n  }\n\n  const searchMatch = goal.match(SEARCH_PATTERN);\n  if (searchMatch) {\n    const input = findInput(snapshot.candidates);\n    if (input) {\n      return { type: \"type\", selector: input.selector, text: searchMatch[1].trim(), clearFirst: true, label: input.text || input.placeholder };\n    }\n  }\n\n  const clickMatch = goal.match(CLICK_PATTERN);\n  if (clickMatch) {\n    const target = findByText(snapshot.candidates, clickMatch[1].trim());\n    if (target) {\n      return { type: \"click\", selector: target.selector, label: target.text };\n    }\n  }\n\n  const firstInput = findInput(snapshot.candidates);\n  const firstButton = findButton(snapshot.candidates);\n\n  if (firstInput && !history.some((h) => h.startsWith(\"Typed\"))) {\n    const searchTerm = goal.replace(/.*(?:search|find|look up)\\s+/i, \"\").trim();\n    return { type: \"type\", selector: firstInput.selector, text: searchTerm, clearFirst: true, label: firstInput.text || firstInput.placeholder };\n  }\n\n  if (firstButton && !history.some((h) => h.startsWith(\"Clicked\"))) {\n    return { type: \"click\", selector: firstButton.selector, label: firstButton.text };\n  }\n\n  return { type: \"done\", reason: \"No further heuristic actions available\" };\n}\n\nexport async function planNextAction(config: PlannerConfig, input: PlannerInput): Promise<AgentAction> {\n  if (config.kind === \"heuristic\") {\n    return heuristicPlan(input);\n  }\n\n  if (config.kind === \"page-agent\") {\n    const pageAgentBridge = (window as Window & { __browserAgentPageAgent?: PageAgentBridge }).__browserAgentPageAgent;\n    if (!pageAgentBridge) {\n      return {\n        type: \"done\",\n        reason: \"page-agent bridge is not configured. Assign a PageAgentBridge to window.__browserAgentPageAgent.\"\n      };\n    }\n    return pageAgentBridge.plan(input);\n  }\n\n  const bridge = (window as Window & { __browserAgentWebLLM?: WebLLMBridge }).__browserAgentWebLLM;\n  if (!bridge) {\n    return {\n      type: \"done\",\n      reason: \"WebLLM bridge is not configured. Use heuristic mode or wire a local bridge implementation.\"\n    };\n  }\n\n  return bridge.plan(input, config.modelId);\n}\n", "import type { AgentSession, ContentCommand, ContentResult } from \"../shared/contracts\";\nimport { assessRisk } from \"../shared/safety\";\nimport { executeAction } from \"../core/executor\";\nimport { collectSnapshot } from \"../core/observer\";\nimport { planNextAction } from \"../core/planner\";\n\nlet stopped = false;\n\nasync function runTick(session: AgentSession): Promise<ContentResult> {\n  const snapshot = collectSnapshot();\n  const action = await planNextAction(session.planner, {\n    goal: session.goal,\n    snapshot,\n    history: session.history,\n    lastError: session.lastError\n  });\n\n  const risk = assessRisk(action);\n  if (risk === \"blocked\") {\n    return { status: \"blocked\", action, message: `Blocked action: ${JSON.stringify(action)}` };\n  }\n\n  if (session.mode === \"human-approved\" && risk === \"review\") {\n    return { status: \"needs_approval\", action, message: `Approval needed for ${action.type}` };\n  }\n\n  if (action.type === \"done\") {\n    return { status: \"done\", action, message: action.reason };\n  }\n\n  const message = await executeAction(action);\n  return { status: \"executed\", action, message };\n}\n\nasync function executePendingAction(session: AgentSession): Promise<ContentResult> {\n  if (!session.pendingAction) {\n    return { status: \"error\", message: \"No pending action to approve\" };\n  }\n\n  const message = await executeAction(session.pendingAction);\n  return { status: \"executed\", action: session.pendingAction, message };\n}\n\nchrome.runtime.onMessage.addListener((command: ContentCommand, _sender, sendResponse) => {\n  if (command.type === \"AGENT_STOP\") {\n    stopped = true;\n    sendResponse({ status: \"done\", message: \"Stopped by user\" } satisfies ContentResult);\n    return true;\n  }\n\n  if (command.type !== \"AGENT_TICK\") {\n    return false;\n  }\n\n  const session = command.session;\n  const exec = session.pendingAction ? executePendingAction(session) : runTick(session);\n\n  exec\n    .then((result) => {\n      if (stopped) {\n        sendResponse({ status: \"done\", message: \"Stopped\" } satisfies ContentResult);\n        return;\n      }\n      sendResponse(result);\n    })\n    .catch((error) => {\n      sendResponse({ status: \"error\", message: String(error) } satisfies ContentResult);\n    });\n\n  return true;\n});\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { AgentAction, RiskLevel } from \"./contracts\";\n\nconst RISKY_KEYWORDS = /\\b(delete|remove|pay|purchase|submit|confirm|checkout|transfer|withdraw|send)\\b/i;\n\nfunction elementTextRisky(text?: string): boolean {\n  return text != null && RISKY_KEYWORDS.test(text);\n}\n\nexport function assessRisk(action: AgentAction): RiskLevel {\n  switch (action.type) {\n    case \"navigate\": {\n      try {\n        const next = new URL(action.url);\n        if (![\"http:\", \"https:\"].includes(next.protocol)) {\n          return \"blocked\";\n        }\n      } catch {\n        return \"blocked\";\n      }\n      return \"safe\";\n    }\n    case \"click\":\n      return elementTextRisky(action.label) ? \"review\" : \"safe\";\n    case \"type\":\n      return elementTextRisky(action.label) ? \"review\" : \"safe\";\n    case \"focus\":\n    case \"scroll\":\n    case \"wait\":\n      return \"safe\";\n    case \"extract\":\n      return \"review\";\n    case \"done\":\n      return \"safe\";\n    default:\n      return \"review\";\n  }\n}\n", "import type { AgentAction } from \"../shared/contracts\";\n\nfunction mustFind(selector: string): HTMLElement {\n  const node = document.querySelector(selector);\n  if (!(node instanceof HTMLElement)) {\n    throw new Error(`Selector not found: ${selector}`);\n  }\n  return node;\n}\n\nfunction dispatchInputEvents(el: HTMLInputElement | HTMLTextAreaElement): void {\n  el.dispatchEvent(new InputEvent(\"input\", { bubbles: true, cancelable: true }));\n  el.dispatchEvent(new Event(\"change\", { bubbles: true }));\n}\n\nexport async function executeAction(action: AgentAction): Promise<string> {\n  switch (action.type) {\n    case \"click\": {\n      const el = mustFind(action.selector);\n      if ((el as HTMLButtonElement).disabled) {\n        throw new Error(`Element is disabled: ${action.selector}`);\n      }\n      el.click();\n      return `Clicked ${action.selector}`;\n    }\n    case \"type\": {\n      const input = mustFind(action.selector) as HTMLInputElement | HTMLTextAreaElement;\n      input.focus();\n      if (action.clearFirst) {\n        input.value = \"\";\n        dispatchInputEvents(input);\n      }\n      input.value = `${input.value}${action.text}`;\n      dispatchInputEvents(input);\n      if (input.value.indexOf(action.text) === -1) {\n        throw new Error(`Type verification failed: value did not update for ${action.selector}`);\n      }\n      return `Typed into ${action.selector}`;\n    }\n    case \"navigate\": {\n      window.location.href = action.url;\n      return `Navigated to ${action.url}`;\n    }\n    case \"extract\": {\n      const value = mustFind(action.selector).innerText.trim();\n      if (!value) {\n        throw new Error(`Extract returned empty text from ${action.selector}`);\n      }\n      return `${action.label}: ${value}`;\n    }\n    case \"scroll\": {\n      const target = action.selector ? mustFind(action.selector) : document.documentElement;\n      target.scrollBy({ top: action.deltaY, behavior: \"smooth\" });\n      return `Scrolled ${action.deltaY > 0 ? \"down\" : \"up\"} ${Math.abs(action.deltaY)}px`;\n    }\n    case \"focus\": {\n      mustFind(action.selector).focus();\n      return `Focused ${action.selector}`;\n    }\n    case \"wait\": {\n      await new Promise((resolve) => setTimeout(resolve, action.ms));\n      return `Waited ${action.ms}ms`;\n    }\n    case \"done\": {\n      return action.reason;\n    }\n    default:\n      return \"No-op\";\n  }\n}\n", "import type { CandidateElement, PageSnapshot } from \"../shared/contracts\";\n\nconst CANDIDATE_SELECTOR =\n  \"a,button,input,textarea,select,[role='button'],[role='link'],[contenteditable='true']\";\n\nconst MAX_CANDIDATES = 60;\n\nfunction cssPath(element: Element): string {\n  if (!(element instanceof HTMLElement)) {\n    return element.tagName.toLowerCase();\n  }\n\n  if (element.id) {\n    return `#${CSS.escape(element.id)}`;\n  }\n\n  const parts: string[] = [];\n  let current: HTMLElement | null = element;\n  while (current && parts.length < 4) {\n    let part = current.tagName.toLowerCase();\n    if (current.classList.length > 0) {\n      part += `.${Array.from(current.classList).slice(0, 2).map(CSS.escape).join(\".\")}`;\n    }\n    const parent: HTMLElement | null = current.parentElement;\n    if (parent) {\n      const siblings = Array.from(parent.children).filter((s: Element) => s.tagName === current!.tagName);\n      if (siblings.length > 1) {\n        const index = siblings.indexOf(current) + 1;\n        part += `:nth-of-type(${index})`;\n      }\n    }\n    parts.unshift(part);\n    current = parent;\n  }\n  return parts.join(\" > \");\n}\n\nfunction isVisible(el: HTMLElement): boolean {\n  if (el.offsetParent === null && el.tagName !== \"BODY\") return false;\n  const style = window.getComputedStyle(el);\n  if (style.display === \"none\" || style.visibility === \"hidden\" || style.opacity === \"0\") return false;\n  // Zero-dimension elements are functionally hidden\n  const rect = el.getBoundingClientRect();\n  return rect.width > 0 || rect.height > 0;\n}\n\nfunction isInViewport(el: HTMLElement): boolean {\n  const rect = el.getBoundingClientRect();\n  return (\n    rect.bottom > 0 &&\n    rect.top < window.innerHeight &&\n    rect.right > 0 &&\n    rect.left < window.innerWidth\n  );\n}\n\n/** Resolve the visible label text via for/id, aria-labelledby, aria-label, or wrapping <label>. */\nfunction getAssociatedLabel(el: HTMLElement): string {\n  if (el.id) {\n    const label = document.querySelector<HTMLLabelElement>(`label[for=\"${CSS.escape(el.id)}\"]`);\n    if (label) return label.innerText.trim();\n  }\n\n  const labelledBy = el.getAttribute(\"aria-labelledby\");\n  if (labelledBy) {\n    const labelEl = document.getElementById(labelledBy);\n    if (labelEl) return labelEl.innerText.trim();\n  }\n\n  const ariaLabel = el.getAttribute(\"aria-label\");\n  if (ariaLabel) return ariaLabel.trim();\n\n  const parentLabel = el.closest(\"label\");\n  if (parentLabel) {\n    return Array.from(parentLabel.childNodes)\n      .filter((n) => n.nodeType === Node.TEXT_NODE)\n      .map((n) => n.textContent?.trim() ?? \"\")\n      .filter(Boolean)\n      .join(\" \");\n  }\n\n  return \"\";\n}\n\nexport function collectSnapshot(): PageSnapshot {\n  const allNodes = Array.from(\n    document.querySelectorAll<HTMLElement>(CANDIDATE_SELECTOR)\n  ).filter(isVisible);\n\n  // In-viewport elements first so the model sees the most relevant candidates first\n  const inView = allNodes.filter(isInViewport);\n  const offScreen = allNodes.filter((el) => !isInViewport(el));\n  const nodes = [...inView, ...offScreen].slice(0, MAX_CANDIDATES);\n\n  const candidates: CandidateElement[] = nodes.map((node) => {\n    const placeholder =\n      (node as HTMLInputElement).placeholder?.trim() || node.getAttribute(\"placeholder\")?.trim();\n    const associatedLabel = getAssociatedLabel(node);\n    return {\n      selector: cssPath(node),\n      role: node.getAttribute(\"role\") ?? node.tagName.toLowerCase(),\n      text: (node.innerText || node.getAttribute(\"name\") || \"\").trim().slice(0, 120),\n      placeholder: placeholder || undefined,\n      label: associatedLabel || undefined,\n    };\n  });\n\n  const textPreview = document.body.innerText.replace(/\\s+/g, \" \").trim().slice(0, 1500);\n\n  return {\n    url: window.location.href,\n    title: document.title,\n    textPreview,\n    candidates,\n  };\n}\n", "import type { AgentAction, CandidateElement, PlannerConfig, PlannerInput, PlannerResult } from \"../shared/contracts\";\n\ntype WebLLMBridge = {\n  // Bridge may return either PlannerResult (new, with reflection) or AgentAction (legacy)\n  plan(input: PlannerInput, modelId?: string): Promise<PlannerResult | AgentAction>;\n};\n\nconst URL_PATTERN = /(?:go to|navigate to|open)\\s+(https?:\\/\\/\\S+)/i;\nconst SEARCH_PATTERN = /search(?:\\s+for)?\\s+(.+)/i;\nconst FILL_PATTERN = /(?:fill|type|enter)\\s+\"?([^\"]+)\"?\\s+(?:in(?:to)?|for|on)\\s+(.+)/i;\nconst CLICK_PATTERN = /click(?:\\s+(?:on|the))?\\s+(.+)/i;\n\nfunction findByText(candidates: CandidateElement[], text: string): CandidateElement | undefined {\n  const lower = text.toLowerCase();\n  return candidates.find(\n    (c) =>\n      c.text.toLowerCase().includes(lower) ||\n      (c.placeholder?.toLowerCase().includes(lower) ?? false) ||\n      (c.label?.toLowerCase().includes(lower) ?? false)\n  );\n}\n\nfunction findInput(candidates: CandidateElement[]): CandidateElement | undefined {\n  return candidates.find(\n    (c) => c.role === \"input\" || c.role === \"textarea\" || c.selector.includes(\"input\") || c.selector.includes(\"textarea\")\n  );\n}\n\nfunction findButton(candidates: CandidateElement[]): CandidateElement | undefined {\n  return candidates.find(\n    (c) => c.role === \"button\" || c.role === \"a\" || c.selector.includes(\"button\") || c.selector.includes(\"a\")\n  );\n}\n\nfunction heuristicPlan(input: PlannerInput): AgentAction {\n  const { goal, snapshot, history } = input;\n\n  const navMatch = goal.match(URL_PATTERN);\n  if (navMatch) {\n    return { type: \"navigate\", url: navMatch[1] };\n  }\n\n  const fillMatch = goal.match(FILL_PATTERN);\n  if (fillMatch) {\n    const [, text, fieldHint] = fillMatch;\n    const target = findByText(snapshot.candidates, fieldHint) ?? findInput(snapshot.candidates);\n    if (target) {\n      return { type: \"type\", selector: target.selector, text, clearFirst: true, label: target.label || target.text || target.placeholder };\n    }\n  }\n\n  const searchMatch = goal.match(SEARCH_PATTERN);\n  if (searchMatch) {\n    const input = findInput(snapshot.candidates);\n    if (input) {\n      return { type: \"type\", selector: input.selector, text: searchMatch[1].trim(), clearFirst: true, label: input.label || input.text || input.placeholder };\n    }\n  }\n\n  const clickMatch = goal.match(CLICK_PATTERN);\n  if (clickMatch) {\n    const target = findByText(snapshot.candidates, clickMatch[1].trim());\n    if (target) {\n      return { type: \"click\", selector: target.selector, label: target.text };\n    }\n  }\n\n  const firstInput = findInput(snapshot.candidates);\n  const firstButton = findButton(snapshot.candidates);\n\n  if (firstInput && !history.some((h) => h.startsWith(\"Typed\"))) {\n    const searchTerm = goal.replace(/.*(?:search|find|look up)\\s+/i, \"\").trim();\n    return { type: \"type\", selector: firstInput.selector, text: searchTerm, clearFirst: true, label: firstInput.label || firstInput.text || firstInput.placeholder };\n  }\n\n  if (firstButton && !history.some((h) => h.startsWith(\"Clicked\"))) {\n    return { type: \"click\", selector: firstButton.selector, label: firstButton.text };\n  }\n\n  return { type: \"done\", reason: \"No further heuristic actions available\" };\n}\n\n/** Normalize whatever a bridge returns into a PlannerResult. */\nfunction toPlannerResult(raw: PlannerResult | AgentAction): PlannerResult {\n  // New format: has an `action` key that is an object\n  if (\"action\" in raw && typeof (raw as PlannerResult).action === \"object\") {\n    return raw as PlannerResult;\n  }\n  // Legacy format: bare AgentAction\n  return { action: raw as AgentAction };\n}\n\nexport async function planNextAction(config: PlannerConfig, input: PlannerInput): Promise<PlannerResult> {\n  if (config.kind === \"heuristic\") {\n    return { action: heuristicPlan(input) };\n  }\n\n  const bridge = (window as Window & { __browserAgentWebLLM?: WebLLMBridge }).__browserAgentWebLLM;\n  if (!bridge) {\n    return {\n      action: {\n        type: \"done\",\n        reason: \"WebLLM bridge is not configured. Use heuristic mode or wire a WebLLM bridge implementation.\"\n      }\n    };\n  }\n\n  const raw = await bridge.plan(input, config.modelId);\n  return toPlannerResult(raw);\n}\n", "import type { AgentSession, ContentCommand, ContentResult } from \"../shared/contracts\";\nimport { assessRisk } from \"../shared/safety\";\nimport { executeAction } from \"../core/executor\";\nimport { collectSnapshot } from \"../core/observer\";\nimport { planNextAction } from \"../core/planner\";\n\nlet stopped = false;\n\nasync function runTick(session: AgentSession): Promise<ContentResult> {\n  const snapshot = collectSnapshot();\n  const plannerResult = await planNextAction(session.planner, {\n    goal: session.goal,\n    snapshot,\n    history: session.history,\n    lastError: session.lastError,\n    memory: session.memory\n  });\n\n  const { action } = plannerResult;\n  const reflection = plannerResult.evaluation !== undefined || plannerResult.memory !== undefined || plannerResult.nextGoal !== undefined\n    ? { evaluation: plannerResult.evaluation, memory: plannerResult.memory, nextGoal: plannerResult.nextGoal }\n    : undefined;\n\n  const risk = assessRisk(action);\n  if (risk === \"blocked\") {\n    return { status: \"blocked\", action, message: `Blocked action: ${JSON.stringify(action)}`, reflection };\n  }\n\n  if (session.mode === \"human-approved\" && risk === \"review\") {\n    return { status: \"needs_approval\", action, message: `Approval needed for ${action.type}`, reflection };\n  }\n\n  if (action.type === \"done\") {\n    return { status: \"done\", action, message: action.reason, reflection };\n  }\n\n  const message = await executeAction(action);\n  return { status: \"executed\", action, message, reflection };\n}\n\nasync function executePendingAction(session: AgentSession): Promise<ContentResult> {\n  if (!session.pendingAction) {\n    return { status: \"error\", message: \"No pending action to approve\" };\n  }\n\n  const message = await executeAction(session.pendingAction);\n  return { status: \"executed\", action: session.pendingAction, message };\n}\n\nchrome.runtime.onMessage.addListener((command: ContentCommand, _sender, sendResponse) => {\n  if (command.type === \"AGENT_STOP\") {\n    stopped = true;\n    sendResponse({ status: \"done\", message: \"Stopped by user\" } satisfies ContentResult);\n    return true;\n  }\n\n  if (command.type !== \"AGENT_TICK\") {\n    return false;\n  }\n\n  const session = command.session;\n  const exec = session.pendingAction ? executePendingAction(session) : runTick(session);\n\n  exec\n    .then((result) => {\n      if (stopped) {\n        sendResponse({ status: \"done\", message: \"Stopped\" } satisfies ContentResult);\n        return;\n      }\n      sendResponse(result);\n    })\n    .catch((error) => {\n      sendResponse({ status: \"error\", message: String(error) } satisfies ContentResult);\n    });\n\n  return true;\n});\n"],
+  "mappings": "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",
   "names": ["input"]
 }

package/dist/lib.js

@@ -160,7 +160,7 @@ var CLICK_PATTERN = /click(?:\s+(?:on|the))?\s+(.+)/i;
 function findByText(candidates, text) {
   const lower = text.toLowerCase();
   return candidates.find(
-    (c) => c.text.toLowerCase().includes(lower) || (c.placeholder?.toLowerCase().includes(lower) ?? false)
+    (c) => c.text.toLowerCase().includes(lower) || (c.placeholder?.toLowerCase().includes(lower) ?? false) || (c.label?.toLowerCase().includes(lower) ?? false)
   );
 }
 function findInput(candidates) {
@@ -184,14 +184,14 @@ function heuristicPlan(input) {
     const [, text, fieldHint] = fillMatch;
     const target = findByText(snapshot.candidates, fieldHint) ?? findInput(snapshot.candidates);
     if (target) {
-      return { type: "type", selector: target.selector, text, clearFirst: true, label: target.text || target.placeholder };
+      return { type: "type", selector: target.selector, text, clearFirst: true, label: target.label || target.text || target.placeholder };
     }
   }
   const searchMatch = goal.match(SEARCH_PATTERN);
   if (searchMatch) {
     const input2 = findInput(snapshot.candidates);
     if (input2) {
-      return { type: "type", selector: input2.selector, text: searchMatch[1].trim(), clearFirst: true, label: input2.text || input2.placeholder };
+      return { type: "type", selector: input2.selector, text: searchMatch[1].trim(), clearFirst: true, label: input2.label || input2.text || input2.placeholder };
     }
   }
   const clickMatch = goal.match(CLICK_PATTERN);
@@ -205,35 +205,34 @@ function heuristicPlan(input) {
   const firstButton = findButton(snapshot.candidates);
   if (firstInput && !history.some((h) => h.startsWith("Typed"))) {
     const searchTerm = goal.replace(/.*(?:search|find|look up)\s+/i, "").trim();
-    return { type: "type", selector: firstInput.selector, text: searchTerm, clearFirst: true, label: firstInput.text || firstInput.placeholder };
+    return { type: "type", selector: firstInput.selector, text: searchTerm, clearFirst: true, label: firstInput.label || firstInput.text || firstInput.placeholder };
   }
   if (firstButton && !history.some((h) => h.startsWith("Clicked"))) {
     return { type: "click", selector: firstButton.selector, label: firstButton.text };
   }
   return { type: "done", reason: "No further heuristic actions available" };
 }
+function toPlannerResult(raw) {
+  if ("action" in raw && typeof raw.action === "object") {
+    return raw;
+  }
+  return { action: raw };
+}
 async function planNextAction(config, input) {
   if (config.kind === "heuristic") {
-    return heuristicPlan(input);
-  }
-  if (config.kind === "page-agent") {
-    const pageAgentBridge = window.__browserAgentPageAgent;
-    if (!pageAgentBridge) {
-      return {
-        type: "done",
-        reason: "page-agent bridge is not configured. Assign a PageAgentBridge to window.__browserAgentPageAgent."
-      };
-    }
-    return pageAgentBridge.plan(input);
+    return { action: heuristicPlan(input) };
   }
   const bridge = window.__browserAgentWebLLM;
   if (!bridge) {
     return {
-      type: "done",
-      reason: "WebLLM bridge is not configured. Use heuristic mode or wire a local bridge implementation."
+      action: {
+        type: "done",
+        reason: "WebLLM bridge is not configured. Use heuristic mode or wire a WebLLM bridge implementation."
+      }
     };
   }
-  return bridge.plan(input, config.modelId);
+  const raw = await bridge.plan(input, config.modelId);
+  return toPlannerResult(raw);
 }
 
 // src/shared/safety.ts
@@ -304,6 +303,34 @@ function parseAction(raw) {
   }
   return obj;
 }
+function parsePlannerResult(raw) {
+  const fenceMatch = raw.match(/```(?:json)?\s*([\s\S]*?)```/);
+  const candidate = fenceMatch ? fenceMatch[1].trim() : raw.trim();
+  const objectMatch = candidate.match(/\{[\s\S]*\}/);
+  if (!objectMatch) {
+    return { action: { type: "done", reason: `No JSON found in: ${raw.slice(0, 120)}` } };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(objectMatch[0]);
+  } catch {
+    return { action: { type: "done", reason: `JSON parse error: ${objectMatch[0].slice(0, 120)}` } };
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return { action: { type: "done", reason: "Parsed value is not an object" } };
+  }
+  const obj = parsed;
+  if (typeof obj.action === "object" && obj.action !== null) {
+    const action = parseAction(JSON.stringify(obj.action));
+    return {
+      action,
+      evaluation: typeof obj.evaluation === "string" ? obj.evaluation : void 0,
+      memory: typeof obj.memory === "string" ? obj.memory : void 0,
+      nextGoal: typeof obj.next_goal === "string" ? obj.next_goal : void 0
+    };
+  }
+  return { action: parseAction(objectMatch[0]) };
+}
 
 // src/lib/index.ts
 var DEFAULT_PLANNER = { kind: "heuristic" };
@@ -435,42 +462,36 @@ var BrowserAgent = class {
   async tick(lastError) {
     try {
       const snapshot = collectSnapshot();
-      const action = await planNextAction(this.session.planner, {
+      const plannerResult = await planNextAction(this.session.planner, {
         goal: this.session.goal,
         snapshot,
         history: this.session.history,
-        lastError
+        lastError,
+        memory: this.session.memory
       });
-      return this.processAction(action);
+      if (plannerResult.memory !== void 0) {
+        this.session.memory = plannerResult.memory;
+      }
+      return this.processAction(plannerResult);
     } catch (error) {
       return { status: "error", message: String(error) };
     }
   }
-  async processAction(action) {
+  async processAction(plannerResult) {
+    const { action } = plannerResult;
+    const reflection = plannerResult.evaluation !== void 0 || plannerResult.memory !== void 0 || plannerResult.nextGoal !== void 0 ? { evaluation: plannerResult.evaluation, memory: plannerResult.memory, nextGoal: plannerResult.nextGoal } : void 0;
     const risk = assessRisk(action);
     if (risk === "blocked") {
-      return {
-        status: "blocked",
-        action,
-        message: `Blocked action: ${JSON.stringify(action)}`
-      };
+      return { status: "blocked", action, message: `Blocked action: ${JSON.stringify(action)}`, reflection };
     }
     if (this.session.mode === "human-approved" && risk === "review") {
-      return {
-        status: "needs_approval",
-        action,
-        message: `Approval needed for ${action.type}`
-      };
+      return { status: "needs_approval", action, message: `Approval needed for ${action.type}`, reflection };
     }
     if (action.type === "done") {
-      return {
-        status: "done",
-        action,
-        message: action.reason
-      };
+      return { status: "done", action, message: action.reason, reflection };
     }
     const message = await executeAction(action);
-    return { status: "executed", action, message };
+    return { status: "executed", action, message, reflection };
   }
   async delay(ms) {
     await new Promise((resolve) => setTimeout(resolve, ms));
@@ -482,6 +503,7 @@ function createBrowserAgent(config, events) {
 export {
   BrowserAgent,
   createBrowserAgent,
-  parseAction
+  parseAction,
+  parsePlannerResult
 };
 //# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/core/executor.ts", "../src/core/observer.ts", "../src/core/planner.ts", "../src/shared/safety.ts", "../src/shared/parse-action.ts", "../src/lib/index.ts"],
-  "sourcesContent": ["import type { AgentAction } from \"../shared/contracts\";\n\nfunction mustFind(selector: string): HTMLElement {\n  const node = document.querySelector(selector);\n  if (!(node instanceof HTMLElement)) {\n    throw new Error(`Selector not found: ${selector}`);\n  }\n  return node;\n}\n\nfunction dispatchInputEvents(el: HTMLInputElement | HTMLTextAreaElement): void {\n  el.dispatchEvent(new InputEvent(\"input\", { bubbles: true, cancelable: true }));\n  el.dispatchEvent(new Event(\"change\", { bubbles: true }));\n}\n\nexport async function executeAction(action: AgentAction): Promise<string> {\n  switch (action.type) {\n    case \"click\": {\n      const el = mustFind(action.selector);\n      if ((el as HTMLButtonElement).disabled) {\n        throw new Error(`Element is disabled: ${action.selector}`);\n      }\n      el.click();\n      return `Clicked ${action.selector}`;\n    }\n    case \"type\": {\n      const input = mustFind(action.selector) as HTMLInputElement | HTMLTextAreaElement;\n      input.focus();\n      if (action.clearFirst) {\n        input.value = \"\";\n        dispatchInputEvents(input);\n      }\n      input.value = `${input.value}${action.text}`;\n      dispatchInputEvents(input);\n      if (input.value.indexOf(action.text) === -1) {\n        throw new Error(`Type verification failed: value did not update for ${action.selector}`);\n      }\n      return `Typed into ${action.selector}`;\n    }\n    case \"navigate\": {\n      window.location.href = action.url;\n      return `Navigated to ${action.url}`;\n    }\n    case \"extract\": {\n      const value = mustFind(action.selector).innerText.trim();\n      if (!value) {\n        throw new Error(`Extract returned empty text from ${action.selector}`);\n      }\n      return `${action.label}: ${value}`;\n    }\n    case \"scroll\": {\n      const target = action.selector ? mustFind(action.selector) : document.documentElement;\n      target.scrollBy({ top: action.deltaY, behavior: \"smooth\" });\n      return `Scrolled ${action.deltaY > 0 ? \"down\" : \"up\"} ${Math.abs(action.deltaY)}px`;\n    }\n    case \"focus\": {\n      mustFind(action.selector).focus();\n      return `Focused ${action.selector}`;\n    }\n    case \"wait\": {\n      await new Promise((resolve) => setTimeout(resolve, action.ms));\n      return `Waited ${action.ms}ms`;\n    }\n    case \"done\": {\n      return action.reason;\n    }\n    default:\n      return \"No-op\";\n  }\n}\n", "import type { CandidateElement, PageSnapshot } from \"../shared/contracts\";\n\nconst CANDIDATE_SELECTOR =\n  \"a,button,input,textarea,select,[role='button'],[role='link'],[contenteditable='true']\";\n\nconst MAX_CANDIDATES = 60;\n\nfunction cssPath(element: Element): string {\n  if (!(element instanceof HTMLElement)) {\n    return element.tagName.toLowerCase();\n  }\n\n  if (element.id) {\n    return `#${CSS.escape(element.id)}`;\n  }\n\n  const parts: string[] = [];\n  let current: HTMLElement | null = element;\n  while (current && parts.length < 4) {\n    let part = current.tagName.toLowerCase();\n    if (current.classList.length > 0) {\n      part += `.${Array.from(current.classList).slice(0, 2).map(CSS.escape).join(\".\")}`;\n    }\n    const parent: HTMLElement | null = current.parentElement;\n    if (parent) {\n      const siblings = Array.from(parent.children).filter((s: Element) => s.tagName === current!.tagName);\n      if (siblings.length > 1) {\n        const index = siblings.indexOf(current) + 1;\n        part += `:nth-of-type(${index})`;\n      }\n    }\n    parts.unshift(part);\n    current = parent;\n  }\n  return parts.join(\" > \");\n}\n\nfunction isVisible(el: HTMLElement): boolean {\n  if (el.offsetParent === null && el.tagName !== \"BODY\") return false;\n  const style = window.getComputedStyle(el);\n  if (style.display === \"none\" || style.visibility === \"hidden\" || style.opacity === \"0\") return false;\n  // Zero-dimension elements are functionally hidden\n  const rect = el.getBoundingClientRect();\n  return rect.width > 0 || rect.height > 0;\n}\n\nfunction isInViewport(el: HTMLElement): boolean {\n  const rect = el.getBoundingClientRect();\n  return (\n    rect.bottom > 0 &&\n    rect.top < window.innerHeight &&\n    rect.right > 0 &&\n    rect.left < window.innerWidth\n  );\n}\n\n/** Resolve the visible label text via for/id, aria-labelledby, aria-label, or wrapping <label>. */\nfunction getAssociatedLabel(el: HTMLElement): string {\n  if (el.id) {\n    const label = document.querySelector<HTMLLabelElement>(`label[for=\"${CSS.escape(el.id)}\"]`);\n    if (label) return label.innerText.trim();\n  }\n\n  const labelledBy = el.getAttribute(\"aria-labelledby\");\n  if (labelledBy) {\n    const labelEl = document.getElementById(labelledBy);\n    if (labelEl) return labelEl.innerText.trim();\n  }\n\n  const ariaLabel = el.getAttribute(\"aria-label\");\n  if (ariaLabel) return ariaLabel.trim();\n\n  const parentLabel = el.closest(\"label\");\n  if (parentLabel) {\n    return Array.from(parentLabel.childNodes)\n      .filter((n) => n.nodeType === Node.TEXT_NODE)\n      .map((n) => n.textContent?.trim() ?? \"\")\n      .filter(Boolean)\n      .join(\" \");\n  }\n\n  return \"\";\n}\n\nexport function collectSnapshot(): PageSnapshot {\n  const allNodes = Array.from(\n    document.querySelectorAll<HTMLElement>(CANDIDATE_SELECTOR)\n  ).filter(isVisible);\n\n  // In-viewport elements first so the model sees the most relevant candidates first\n  const inView = allNodes.filter(isInViewport);\n  const offScreen = allNodes.filter((el) => !isInViewport(el));\n  const nodes = [...inView, ...offScreen].slice(0, MAX_CANDIDATES);\n\n  const candidates: CandidateElement[] = nodes.map((node) => {\n    const placeholder =\n      (node as HTMLInputElement).placeholder?.trim() || node.getAttribute(\"placeholder\")?.trim();\n    const associatedLabel = getAssociatedLabel(node);\n    return {\n      selector: cssPath(node),\n      role: node.getAttribute(\"role\") ?? node.tagName.toLowerCase(),\n      text: (node.innerText || node.getAttribute(\"name\") || \"\").trim().slice(0, 120),\n      placeholder: placeholder || undefined,\n      label: associatedLabel || undefined,\n    };\n  });\n\n  const textPreview = document.body.innerText.replace(/\\s+/g, \" \").trim().slice(0, 1500);\n\n  return {\n    url: window.location.href,\n    title: document.title,\n    textPreview,\n    candidates,\n  };\n}\n", "import type { AgentAction, CandidateElement, PlannerConfig, PlannerInput } from \"../shared/contracts\";\n\ntype WebLLMBridge = {\n  plan(input: PlannerInput, modelId?: string): Promise<AgentAction>;\n};\n\ntype PageAgentBridge = {\n  plan(input: PlannerInput): Promise<AgentAction>;\n};\n\nconst URL_PATTERN = /(?:go to|navigate to|open)\\s+(https?:\\/\\/\\S+)/i;\nconst SEARCH_PATTERN = /search(?:\\s+for)?\\s+(.+)/i;\nconst FILL_PATTERN = /(?:fill|type|enter)\\s+\"?([^\"]+)\"?\\s+(?:in(?:to)?|for|on)\\s+(.+)/i;\nconst CLICK_PATTERN = /click(?:\\s+(?:on|the))?\\s+(.+)/i;\n\nfunction findByText(candidates: CandidateElement[], text: string): CandidateElement | undefined {\n  const lower = text.toLowerCase();\n  return candidates.find(\n    (c) =>\n      c.text.toLowerCase().includes(lower) ||\n      (c.placeholder?.toLowerCase().includes(lower) ?? false)\n  );\n}\n\nfunction findInput(candidates: CandidateElement[]): CandidateElement | undefined {\n  return candidates.find(\n    (c) => c.role === \"input\" || c.role === \"textarea\" || c.selector.includes(\"input\") || c.selector.includes(\"textarea\")\n  );\n}\n\nfunction findButton(candidates: CandidateElement[]): CandidateElement | undefined {\n  return candidates.find(\n    (c) => c.role === \"button\" || c.role === \"a\" || c.selector.includes(\"button\") || c.selector.includes(\"a\")\n  );\n}\n\nfunction heuristicPlan(input: PlannerInput): AgentAction {\n  const { goal, snapshot, history } = input;\n\n  const navMatch = goal.match(URL_PATTERN);\n  if (navMatch) {\n    return { type: \"navigate\", url: navMatch[1] };\n  }\n\n  const fillMatch = goal.match(FILL_PATTERN);\n  if (fillMatch) {\n    const [, text, fieldHint] = fillMatch;\n    const target = findByText(snapshot.candidates, fieldHint) ?? findInput(snapshot.candidates);\n    if (target) {\n      return { type: \"type\", selector: target.selector, text, clearFirst: true, label: target.text || target.placeholder };\n    }\n  }\n\n  const searchMatch = goal.match(SEARCH_PATTERN);\n  if (searchMatch) {\n    const input = findInput(snapshot.candidates);\n    if (input) {\n      return { type: \"type\", selector: input.selector, text: searchMatch[1].trim(), clearFirst: true, label: input.text || input.placeholder };\n    }\n  }\n\n  const clickMatch = goal.match(CLICK_PATTERN);\n  if (clickMatch) {\n    const target = findByText(snapshot.candidates, clickMatch[1].trim());\n    if (target) {\n      return { type: \"click\", selector: target.selector, label: target.text };\n    }\n  }\n\n  const firstInput = findInput(snapshot.candidates);\n  const firstButton = findButton(snapshot.candidates);\n\n  if (firstInput && !history.some((h) => h.startsWith(\"Typed\"))) {\n    const searchTerm = goal.replace(/.*(?:search|find|look up)\\s+/i, \"\").trim();\n    return { type: \"type\", selector: firstInput.selector, text: searchTerm, clearFirst: true, label: firstInput.text || firstInput.placeholder };\n  }\n\n  if (firstButton && !history.some((h) => h.startsWith(\"Clicked\"))) {\n    return { type: \"click\", selector: firstButton.selector, label: firstButton.text };\n  }\n\n  return { type: \"done\", reason: \"No further heuristic actions available\" };\n}\n\nexport async function planNextAction(config: PlannerConfig, input: PlannerInput): Promise<AgentAction> {\n  if (config.kind === \"heuristic\") {\n    return heuristicPlan(input);\n  }\n\n  if (config.kind === \"page-agent\") {\n    const pageAgentBridge = (window as Window & { __browserAgentPageAgent?: PageAgentBridge }).__browserAgentPageAgent;\n    if (!pageAgentBridge) {\n      return {\n        type: \"done\",\n        reason: \"page-agent bridge is not configured. Assign a PageAgentBridge to window.__browserAgentPageAgent.\"\n      };\n    }\n    return pageAgentBridge.plan(input);\n  }\n\n  const bridge = (window as Window & { __browserAgentWebLLM?: WebLLMBridge }).__browserAgentWebLLM;\n  if (!bridge) {\n    return {\n      type: \"done\",\n      reason: \"WebLLM bridge is not configured. Use heuristic mode or wire a local bridge implementation.\"\n    };\n  }\n\n  return bridge.plan(input, config.modelId);\n}\n", "import type { AgentAction, RiskLevel } from \"./contracts\";\n\nconst RISKY_KEYWORDS = /\\b(delete|remove|pay|purchase|submit|confirm|checkout|transfer|withdraw|send)\\b/i;\n\nfunction elementTextRisky(text?: string): boolean {\n  return text != null && RISKY_KEYWORDS.test(text);\n}\n\nexport function assessRisk(action: AgentAction): RiskLevel {\n  switch (action.type) {\n    case \"navigate\": {\n      try {\n        const next = new URL(action.url);\n        if (![\"http:\", \"https:\"].includes(next.protocol)) {\n          return \"blocked\";\n        }\n      } catch {\n        return \"blocked\";\n      }\n      return \"safe\";\n    }\n    case \"click\":\n      return elementTextRisky(action.label) ? \"review\" : \"safe\";\n    case \"type\":\n      return elementTextRisky(action.label) ? \"review\" : \"safe\";\n    case \"focus\":\n    case \"scroll\":\n    case \"wait\":\n      return \"safe\";\n    case \"extract\":\n      return \"review\";\n    case \"done\":\n      return \"safe\";\n    default:\n      return \"review\";\n  }\n}\n", "import type { AgentAction } from \"./contracts\";\n\nconst VALID_TYPES = new Set([\n  \"click\", \"type\", \"navigate\", \"extract\", \"scroll\", \"focus\", \"wait\", \"done\",\n]);\n\n/**\n * Parse an AgentAction from raw LLM output.\n *\n * Handles:\n * - Bare JSON objects:  {\"type\":\"click\",\"selector\":\"#btn\"}\n * - Markdown fences:   ```json\\n{\"type\":\"click\",...}\\n```\n * - JSON embedded in prose: \"Sure! {\"type\":\"click\",...}\"\n *\n * Returns a \"done\" action with the parse error as the reason if parsing fails,\n * so the caller always gets a valid AgentAction.\n */\nexport function parseAction(raw: string): AgentAction {\n  // Strip markdown code fences if present\n  const fenceMatch = raw.match(/```(?:json)?\\s*([\\s\\S]*?)```/);\n  const candidate = fenceMatch ? fenceMatch[1].trim() : raw.trim();\n\n  // Extract the first {...} block from the candidate string\n  const objectMatch = candidate.match(/\\{[\\s\\S]*\\}/);\n  if (!objectMatch) {\n    return { type: \"done\", reason: `No JSON object found in: ${raw.slice(0, 120)}` };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(objectMatch[0]);\n  } catch {\n    return { type: \"done\", reason: `JSON parse error for: ${objectMatch[0].slice(0, 120)}` };\n  }\n\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    return { type: \"done\", reason: \"Parsed value is not an object\" };\n  }\n\n  const obj = parsed as Record<string, unknown>;\n  if (typeof obj.type !== \"string\" || !VALID_TYPES.has(obj.type)) {\n    return { type: \"done\", reason: `Unknown or missing action type: ${String(obj.type)}` };\n  }\n\n  return obj as unknown as AgentAction;\n}\n", "import { executeAction } from \"../core/executor\";\nimport { collectSnapshot } from \"../core/observer\";\nimport { planNextAction } from \"../core/planner\";\nimport type {\n  AgentAction,\n  AgentSession,\n  ContentResult,\n  LibraryAgentConfig,\n  LibraryAgentEvents,\n  PlannerConfig\n} from \"../shared/contracts\";\nimport { assessRisk } from \"../shared/safety\";\n\nconst DEFAULT_PLANNER: PlannerConfig = { kind: \"heuristic\" };\n\n/** Max consecutive errors before the agent gives up instead of retrying */\nconst MAX_CONSECUTIVE_ERRORS = 2;\n\nexport class BrowserAgent {\n  private session: AgentSession;\n  private maxSteps: number;\n  private stepDelayMs: number;\n  private events: LibraryAgentEvents;\n  private isStopped = false;\n  private signal?: AbortSignal;\n\n  constructor(config: LibraryAgentConfig, events: LibraryAgentEvents = {}) {\n    this.session = {\n      id: crypto.randomUUID(),\n      tabId: null,\n      goal: config.goal,\n      mode: config.mode ?? \"human-approved\",\n      planner: config.planner ?? DEFAULT_PLANNER,\n      history: [],\n      isRunning: false\n    };\n\n    this.maxSteps = config.maxSteps ?? 20;\n    this.stepDelayMs = config.stepDelayMs ?? 500;\n    this.events = events;\n    this.signal = config.signal;\n  }\n\n  getSession(): AgentSession {\n    return { ...this.session, history: [...this.session.history] };\n  }\n\n  get isRunning(): boolean {\n    return this.session.isRunning;\n  }\n\n  get hasPendingAction(): boolean {\n    return this.session.pendingAction != null;\n  }\n\n  async start(): Promise<ContentResult> {\n    this.isStopped = false;\n    this.session.isRunning = true;\n    this.events.onStart?.(this.getSession());\n\n    return this.runLoop();\n  }\n\n  async resume(): Promise<ContentResult> {\n    if (this.session.pendingAction) {\n      const approvalResult = await this.approvePendingAction();\n      if (approvalResult.status === \"error\") {\n        return approvalResult;\n      }\n    }\n    this.session.isRunning = true;\n    return this.runLoop();\n  }\n\n  private async runLoop(): Promise<ContentResult> {\n    let consecutiveErrors = 0;\n    let lastError: string | undefined;\n\n    for (let step = 0; step < this.maxSteps; step += 1) {\n      if (this.isStopped || !this.session.isRunning) {\n        return { status: \"done\", message: \"Stopped\" };\n      }\n\n      if (this.signal?.aborted) {\n        this.session.isRunning = false;\n        return { status: \"done\", message: \"Aborted\" };\n      }\n\n      const result = await this.tick(lastError);\n      this.events.onStep?.(result, this.getSession());\n\n      if (result.status === \"error\") {\n        consecutiveErrors += 1;\n        lastError = result.message;\n        this.session.history.push(`Error: ${result.message}`);\n\n        if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {\n          this.session.isRunning = false;\n          this.events.onError?.(new Error(result.message), this.getSession());\n          this.events.onDone?.(result, this.getSession());\n          return result;\n        }\n\n        // Retry with error context on the next iteration\n        await this.delay(this.stepDelayMs);\n        continue;\n      }\n\n      consecutiveErrors = 0;\n      lastError = undefined;\n      this.session.history.push(result.message);\n\n      if (result.status === \"needs_approval\") {\n        this.session.pendingAction = result.action;\n        this.session.isRunning = false;\n        if (result.action) {\n          this.events.onApprovalRequired?.(result.action, this.getSession());\n        }\n        return result;\n      }\n\n      if ([\"done\", \"blocked\"].includes(result.status)) {\n        this.session.isRunning = false;\n        this.events.onDone?.(result, this.getSession());\n        return result;\n      }\n\n      await this.delay(this.stepDelayMs);\n    }\n\n    const result: ContentResult = { status: \"done\", message: \"Reached max steps\" };\n    this.session.history.push(result.message);\n    this.session.isRunning = false;\n    this.events.onMaxStepsReached?.(this.getSession());\n    this.events.onDone?.(result, this.getSession());\n    return result;\n  }\n\n  async approvePendingAction(): Promise<ContentResult> {\n    if (!this.session.pendingAction) {\n      return { status: \"error\", message: \"No pending action to approve\" };\n    }\n\n    try {\n      const message = await executeAction(this.session.pendingAction);\n      const result: ContentResult = {\n        status: \"executed\",\n        message,\n        action: this.session.pendingAction\n      };\n      this.session.history.push(message);\n      this.session.pendingAction = undefined;\n      this.session.isRunning = true;\n      this.events.onStep?.(result, this.getSession());\n      return result;\n    } catch (error) {\n      this.session.isRunning = false;\n      this.events.onError?.(error, this.getSession());\n      return { status: \"error\", message: String(error) };\n    }\n  }\n\n  stop(): void {\n    this.isStopped = true;\n    this.session.isRunning = false;\n  }\n\n  private async tick(lastError?: string): Promise<ContentResult> {\n    try {\n      const snapshot = collectSnapshot();\n      const action = await planNextAction(this.session.planner, {\n        goal: this.session.goal,\n        snapshot,\n        history: this.session.history,\n        lastError\n      });\n\n      return this.processAction(action);\n    } catch (error) {\n      return { status: \"error\", message: String(error) };\n    }\n  }\n\n  private async processAction(action: AgentAction): Promise<ContentResult> {\n    const risk = assessRisk(action);\n    if (risk === \"blocked\") {\n      return {\n        status: \"blocked\",\n        action,\n        message: `Blocked action: ${JSON.stringify(action)}`\n      };\n    }\n\n    if (this.session.mode === \"human-approved\" && risk === \"review\") {\n      return {\n        status: \"needs_approval\",\n        action,\n        message: `Approval needed for ${action.type}`\n      };\n    }\n\n    if (action.type === \"done\") {\n      return {\n        status: \"done\",\n        action,\n        message: action.reason\n      };\n    }\n\n    const message = await executeAction(action);\n    return { status: \"executed\", action, message };\n  }\n\n  private async delay(ms: number): Promise<void> {\n    await new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\nexport function createBrowserAgent(config: LibraryAgentConfig, events?: LibraryAgentEvents): BrowserAgent {\n  return new BrowserAgent(config, events);\n}\n\nexport { parseAction } from \"../shared/parse-action\";\n\nexport type {\n  AgentAction,\n  AgentMode,\n  AgentSession,\n  ContentResult,\n  LibraryAgentConfig,\n  LibraryAgentEvents,\n  PlannerConfig,\n  PlannerInput,\n  PlannerKind,\n  RiskLevel\n} from \"../shared/contracts\";\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { AgentAction } from \"../shared/contracts\";\n\nfunction mustFind(selector: string): HTMLElement {\n  const node = document.querySelector(selector);\n  if (!(node instanceof HTMLElement)) {\n    throw new Error(`Selector not found: ${selector}`);\n  }\n  return node;\n}\n\nfunction dispatchInputEvents(el: HTMLInputElement | HTMLTextAreaElement): void {\n  el.dispatchEvent(new InputEvent(\"input\", { bubbles: true, cancelable: true }));\n  el.dispatchEvent(new Event(\"change\", { bubbles: true }));\n}\n\nexport async function executeAction(action: AgentAction): Promise<string> {\n  switch (action.type) {\n    case \"click\": {\n      const el = mustFind(action.selector);\n      if ((el as HTMLButtonElement).disabled) {\n        throw new Error(`Element is disabled: ${action.selector}`);\n      }\n      el.click();\n      return `Clicked ${action.selector}`;\n    }\n    case \"type\": {\n      const input = mustFind(action.selector) as HTMLInputElement | HTMLTextAreaElement;\n      input.focus();\n      if (action.clearFirst) {\n        input.value = \"\";\n        dispatchInputEvents(input);\n      }\n      input.value = `${input.value}${action.text}`;\n      dispatchInputEvents(input);\n      if (input.value.indexOf(action.text) === -1) {\n        throw new Error(`Type verification failed: value did not update for ${action.selector}`);\n      }\n      return `Typed into ${action.selector}`;\n    }\n    case \"navigate\": {\n      window.location.href = action.url;\n      return `Navigated to ${action.url}`;\n    }\n    case \"extract\": {\n      const value = mustFind(action.selector).innerText.trim();\n      if (!value) {\n        throw new Error(`Extract returned empty text from ${action.selector}`);\n      }\n      return `${action.label}: ${value}`;\n    }\n    case \"scroll\": {\n      const target = action.selector ? mustFind(action.selector) : document.documentElement;\n      target.scrollBy({ top: action.deltaY, behavior: \"smooth\" });\n      return `Scrolled ${action.deltaY > 0 ? \"down\" : \"up\"} ${Math.abs(action.deltaY)}px`;\n    }\n    case \"focus\": {\n      mustFind(action.selector).focus();\n      return `Focused ${action.selector}`;\n    }\n    case \"wait\": {\n      await new Promise((resolve) => setTimeout(resolve, action.ms));\n      return `Waited ${action.ms}ms`;\n    }\n    case \"done\": {\n      return action.reason;\n    }\n    default:\n      return \"No-op\";\n  }\n}\n", "import type { CandidateElement, PageSnapshot } from \"../shared/contracts\";\n\nconst CANDIDATE_SELECTOR =\n  \"a,button,input,textarea,select,[role='button'],[role='link'],[contenteditable='true']\";\n\nconst MAX_CANDIDATES = 60;\n\nfunction cssPath(element: Element): string {\n  if (!(element instanceof HTMLElement)) {\n    return element.tagName.toLowerCase();\n  }\n\n  if (element.id) {\n    return `#${CSS.escape(element.id)}`;\n  }\n\n  const parts: string[] = [];\n  let current: HTMLElement | null = element;\n  while (current && parts.length < 4) {\n    let part = current.tagName.toLowerCase();\n    if (current.classList.length > 0) {\n      part += `.${Array.from(current.classList).slice(0, 2).map(CSS.escape).join(\".\")}`;\n    }\n    const parent: HTMLElement | null = current.parentElement;\n    if (parent) {\n      const siblings = Array.from(parent.children).filter((s: Element) => s.tagName === current!.tagName);\n      if (siblings.length > 1) {\n        const index = siblings.indexOf(current) + 1;\n        part += `:nth-of-type(${index})`;\n      }\n    }\n    parts.unshift(part);\n    current = parent;\n  }\n  return parts.join(\" > \");\n}\n\nfunction isVisible(el: HTMLElement): boolean {\n  if (el.offsetParent === null && el.tagName !== \"BODY\") return false;\n  const style = window.getComputedStyle(el);\n  if (style.display === \"none\" || style.visibility === \"hidden\" || style.opacity === \"0\") return false;\n  // Zero-dimension elements are functionally hidden\n  const rect = el.getBoundingClientRect();\n  return rect.width > 0 || rect.height > 0;\n}\n\nfunction isInViewport(el: HTMLElement): boolean {\n  const rect = el.getBoundingClientRect();\n  return (\n    rect.bottom > 0 &&\n    rect.top < window.innerHeight &&\n    rect.right > 0 &&\n    rect.left < window.innerWidth\n  );\n}\n\n/** Resolve the visible label text via for/id, aria-labelledby, aria-label, or wrapping <label>. */\nfunction getAssociatedLabel(el: HTMLElement): string {\n  if (el.id) {\n    const label = document.querySelector<HTMLLabelElement>(`label[for=\"${CSS.escape(el.id)}\"]`);\n    if (label) return label.innerText.trim();\n  }\n\n  const labelledBy = el.getAttribute(\"aria-labelledby\");\n  if (labelledBy) {\n    const labelEl = document.getElementById(labelledBy);\n    if (labelEl) return labelEl.innerText.trim();\n  }\n\n  const ariaLabel = el.getAttribute(\"aria-label\");\n  if (ariaLabel) return ariaLabel.trim();\n\n  const parentLabel = el.closest(\"label\");\n  if (parentLabel) {\n    return Array.from(parentLabel.childNodes)\n      .filter((n) => n.nodeType === Node.TEXT_NODE)\n      .map((n) => n.textContent?.trim() ?? \"\")\n      .filter(Boolean)\n      .join(\" \");\n  }\n\n  return \"\";\n}\n\nexport function collectSnapshot(): PageSnapshot {\n  const allNodes = Array.from(\n    document.querySelectorAll<HTMLElement>(CANDIDATE_SELECTOR)\n  ).filter(isVisible);\n\n  // In-viewport elements first so the model sees the most relevant candidates first\n  const inView = allNodes.filter(isInViewport);\n  const offScreen = allNodes.filter((el) => !isInViewport(el));\n  const nodes = [...inView, ...offScreen].slice(0, MAX_CANDIDATES);\n\n  const candidates: CandidateElement[] = nodes.map((node) => {\n    const placeholder =\n      (node as HTMLInputElement).placeholder?.trim() || node.getAttribute(\"placeholder\")?.trim();\n    const associatedLabel = getAssociatedLabel(node);\n    return {\n      selector: cssPath(node),\n      role: node.getAttribute(\"role\") ?? node.tagName.toLowerCase(),\n      text: (node.innerText || node.getAttribute(\"name\") || \"\").trim().slice(0, 120),\n      placeholder: placeholder || undefined,\n      label: associatedLabel || undefined,\n    };\n  });\n\n  const textPreview = document.body.innerText.replace(/\\s+/g, \" \").trim().slice(0, 1500);\n\n  return {\n    url: window.location.href,\n    title: document.title,\n    textPreview,\n    candidates,\n  };\n}\n", "import type { AgentAction, CandidateElement, PlannerConfig, PlannerInput, PlannerResult } from \"../shared/contracts\";\n\ntype WebLLMBridge = {\n  // Bridge may return either PlannerResult (new, with reflection) or AgentAction (legacy)\n  plan(input: PlannerInput, modelId?: string): Promise<PlannerResult | AgentAction>;\n};\n\nconst URL_PATTERN = /(?:go to|navigate to|open)\\s+(https?:\\/\\/\\S+)/i;\nconst SEARCH_PATTERN = /search(?:\\s+for)?\\s+(.+)/i;\nconst FILL_PATTERN = /(?:fill|type|enter)\\s+\"?([^\"]+)\"?\\s+(?:in(?:to)?|for|on)\\s+(.+)/i;\nconst CLICK_PATTERN = /click(?:\\s+(?:on|the))?\\s+(.+)/i;\n\nfunction findByText(candidates: CandidateElement[], text: string): CandidateElement | undefined {\n  const lower = text.toLowerCase();\n  return candidates.find(\n    (c) =>\n      c.text.toLowerCase().includes(lower) ||\n      (c.placeholder?.toLowerCase().includes(lower) ?? false) ||\n      (c.label?.toLowerCase().includes(lower) ?? false)\n  );\n}\n\nfunction findInput(candidates: CandidateElement[]): CandidateElement | undefined {\n  return candidates.find(\n    (c) => c.role === \"input\" || c.role === \"textarea\" || c.selector.includes(\"input\") || c.selector.includes(\"textarea\")\n  );\n}\n\nfunction findButton(candidates: CandidateElement[]): CandidateElement | undefined {\n  return candidates.find(\n    (c) => c.role === \"button\" || c.role === \"a\" || c.selector.includes(\"button\") || c.selector.includes(\"a\")\n  );\n}\n\nfunction heuristicPlan(input: PlannerInput): AgentAction {\n  const { goal, snapshot, history } = input;\n\n  const navMatch = goal.match(URL_PATTERN);\n  if (navMatch) {\n    return { type: \"navigate\", url: navMatch[1] };\n  }\n\n  const fillMatch = goal.match(FILL_PATTERN);\n  if (fillMatch) {\n    const [, text, fieldHint] = fillMatch;\n    const target = findByText(snapshot.candidates, fieldHint) ?? findInput(snapshot.candidates);\n    if (target) {\n      return { type: \"type\", selector: target.selector, text, clearFirst: true, label: target.label || target.text || target.placeholder };\n    }\n  }\n\n  const searchMatch = goal.match(SEARCH_PATTERN);\n  if (searchMatch) {\n    const input = findInput(snapshot.candidates);\n    if (input) {\n      return { type: \"type\", selector: input.selector, text: searchMatch[1].trim(), clearFirst: true, label: input.label || input.text || input.placeholder };\n    }\n  }\n\n  const clickMatch = goal.match(CLICK_PATTERN);\n  if (clickMatch) {\n    const target = findByText(snapshot.candidates, clickMatch[1].trim());\n    if (target) {\n      return { type: \"click\", selector: target.selector, label: target.text };\n    }\n  }\n\n  const firstInput = findInput(snapshot.candidates);\n  const firstButton = findButton(snapshot.candidates);\n\n  if (firstInput && !history.some((h) => h.startsWith(\"Typed\"))) {\n    const searchTerm = goal.replace(/.*(?:search|find|look up)\\s+/i, \"\").trim();\n    return { type: \"type\", selector: firstInput.selector, text: searchTerm, clearFirst: true, label: firstInput.label || firstInput.text || firstInput.placeholder };\n  }\n\n  if (firstButton && !history.some((h) => h.startsWith(\"Clicked\"))) {\n    return { type: \"click\", selector: firstButton.selector, label: firstButton.text };\n  }\n\n  return { type: \"done\", reason: \"No further heuristic actions available\" };\n}\n\n/** Normalize whatever a bridge returns into a PlannerResult. */\nfunction toPlannerResult(raw: PlannerResult | AgentAction): PlannerResult {\n  // New format: has an `action` key that is an object\n  if (\"action\" in raw && typeof (raw as PlannerResult).action === \"object\") {\n    return raw as PlannerResult;\n  }\n  // Legacy format: bare AgentAction\n  return { action: raw as AgentAction };\n}\n\nexport async function planNextAction(config: PlannerConfig, input: PlannerInput): Promise<PlannerResult> {\n  if (config.kind === \"heuristic\") {\n    return { action: heuristicPlan(input) };\n  }\n\n  const bridge = (window as Window & { __browserAgentWebLLM?: WebLLMBridge }).__browserAgentWebLLM;\n  if (!bridge) {\n    return {\n      action: {\n        type: \"done\",\n        reason: \"WebLLM bridge is not configured. Use heuristic mode or wire a WebLLM bridge implementation.\"\n      }\n    };\n  }\n\n  const raw = await bridge.plan(input, config.modelId);\n  return toPlannerResult(raw);\n}\n", "import type { AgentAction, RiskLevel } from \"./contracts\";\n\nconst RISKY_KEYWORDS = /\\b(delete|remove|pay|purchase|submit|confirm|checkout|transfer|withdraw|send)\\b/i;\n\nfunction elementTextRisky(text?: string): boolean {\n  return text != null && RISKY_KEYWORDS.test(text);\n}\n\nexport function assessRisk(action: AgentAction): RiskLevel {\n  switch (action.type) {\n    case \"navigate\": {\n      try {\n        const next = new URL(action.url);\n        if (![\"http:\", \"https:\"].includes(next.protocol)) {\n          return \"blocked\";\n        }\n      } catch {\n        return \"blocked\";\n      }\n      return \"safe\";\n    }\n    case \"click\":\n      return elementTextRisky(action.label) ? \"review\" : \"safe\";\n    case \"type\":\n      return elementTextRisky(action.label) ? \"review\" : \"safe\";\n    case \"focus\":\n    case \"scroll\":\n    case \"wait\":\n      return \"safe\";\n    case \"extract\":\n      return \"review\";\n    case \"done\":\n      return \"safe\";\n    default:\n      return \"review\";\n  }\n}\n", "import type { AgentAction, PlannerResult } from \"./contracts\";\n\nconst VALID_TYPES = new Set([\n  \"click\", \"type\", \"navigate\", \"extract\", \"scroll\", \"focus\", \"wait\", \"done\",\n]);\n\n/**\n * Parse an AgentAction from raw LLM output.\n *\n * Handles bare JSON, markdown fences, and JSON embedded in prose.\n * Returns a \"done\" action if parsing fails, so the caller always gets a valid AgentAction.\n */\nexport function parseAction(raw: string): AgentAction {\n  const fenceMatch = raw.match(/```(?:json)?\\s*([\\s\\S]*?)```/);\n  const candidate = fenceMatch ? fenceMatch[1].trim() : raw.trim();\n\n  const objectMatch = candidate.match(/\\{[\\s\\S]*\\}/);\n  if (!objectMatch) {\n    return { type: \"done\", reason: `No JSON object found in: ${raw.slice(0, 120)}` };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(objectMatch[0]);\n  } catch {\n    return { type: \"done\", reason: `JSON parse error for: ${objectMatch[0].slice(0, 120)}` };\n  }\n\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    return { type: \"done\", reason: \"Parsed value is not an object\" };\n  }\n\n  const obj = parsed as Record<string, unknown>;\n  if (typeof obj.type !== \"string\" || !VALID_TYPES.has(obj.type)) {\n    return { type: \"done\", reason: `Unknown or missing action type: ${String(obj.type)}` };\n  }\n\n  return obj as unknown as AgentAction;\n}\n\n/**\n * Parse a full PlannerResult from raw LLM output.\n *\n * Accepts the reflection+action format:\n *   { \"evaluation\": \"...\", \"memory\": \"...\", \"next_goal\": \"...\", \"action\": { ... } }\n *\n * Also accepts a bare AgentAction for backward compatibility with simple bridges.\n */\nexport function parsePlannerResult(raw: string): PlannerResult {\n  const fenceMatch = raw.match(/```(?:json)?\\s*([\\s\\S]*?)```/);\n  const candidate = fenceMatch ? fenceMatch[1].trim() : raw.trim();\n\n  const objectMatch = candidate.match(/\\{[\\s\\S]*\\}/);\n  if (!objectMatch) {\n    return { action: { type: \"done\", reason: `No JSON found in: ${raw.slice(0, 120)}` } };\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(objectMatch[0]);\n  } catch {\n    return { action: { type: \"done\", reason: `JSON parse error: ${objectMatch[0].slice(0, 120)}` } };\n  }\n\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    return { action: { type: \"done\", reason: \"Parsed value is not an object\" } };\n  }\n\n  const obj = parsed as Record<string, unknown>;\n\n  // Full reflection format: { evaluation, memory, next_goal, action }\n  if (typeof obj.action === \"object\" && obj.action !== null) {\n    const action = parseAction(JSON.stringify(obj.action));\n    return {\n      action,\n      evaluation: typeof obj.evaluation === \"string\" ? obj.evaluation : undefined,\n      memory:     typeof obj.memory     === \"string\" ? obj.memory     : undefined,\n      nextGoal:   typeof obj.next_goal  === \"string\" ? obj.next_goal  : undefined,\n    };\n  }\n\n  // Fallback: bare AgentAction (no reflection fields)\n  return { action: parseAction(objectMatch[0]) };\n}\n", "import { executeAction } from \"../core/executor\";\nimport { collectSnapshot } from \"../core/observer\";\nimport { planNextAction } from \"../core/planner\";\nimport type {\n  AgentSession,\n  ContentResult,\n  LibraryAgentConfig,\n  LibraryAgentEvents,\n  PlannerConfig,\n  PlannerResult\n} from \"../shared/contracts\";\nimport { assessRisk } from \"../shared/safety\";\n\nconst DEFAULT_PLANNER: PlannerConfig = { kind: \"heuristic\" };\n\n/** Max consecutive errors before the agent gives up instead of retrying */\nconst MAX_CONSECUTIVE_ERRORS = 2;\n\nexport class BrowserAgent {\n  private session: AgentSession;\n  private maxSteps: number;\n  private stepDelayMs: number;\n  private events: LibraryAgentEvents;\n  private isStopped = false;\n  private signal?: AbortSignal;\n\n  constructor(config: LibraryAgentConfig, events: LibraryAgentEvents = {}) {\n    this.session = {\n      id: crypto.randomUUID(),\n      tabId: null,\n      goal: config.goal,\n      mode: config.mode ?? \"human-approved\",\n      planner: config.planner ?? DEFAULT_PLANNER,\n      history: [],\n      isRunning: false\n    };\n\n    this.maxSteps = config.maxSteps ?? 20;\n    this.stepDelayMs = config.stepDelayMs ?? 500;\n    this.events = events;\n    this.signal = config.signal;\n  }\n\n  getSession(): AgentSession {\n    return { ...this.session, history: [...this.session.history] };\n  }\n\n  get isRunning(): boolean {\n    return this.session.isRunning;\n  }\n\n  get hasPendingAction(): boolean {\n    return this.session.pendingAction != null;\n  }\n\n  async start(): Promise<ContentResult> {\n    this.isStopped = false;\n    this.session.isRunning = true;\n    this.events.onStart?.(this.getSession());\n    return this.runLoop();\n  }\n\n  async resume(): Promise<ContentResult> {\n    if (this.session.pendingAction) {\n      const approvalResult = await this.approvePendingAction();\n      if (approvalResult.status === \"error\") {\n        return approvalResult;\n      }\n    }\n    this.session.isRunning = true;\n    return this.runLoop();\n  }\n\n  private async runLoop(): Promise<ContentResult> {\n    let consecutiveErrors = 0;\n    let lastError: string | undefined;\n\n    for (let step = 0; step < this.maxSteps; step += 1) {\n      if (this.isStopped || !this.session.isRunning) {\n        return { status: \"done\", message: \"Stopped\" };\n      }\n\n      if (this.signal?.aborted) {\n        this.session.isRunning = false;\n        return { status: \"done\", message: \"Aborted\" };\n      }\n\n      const result = await this.tick(lastError);\n      this.events.onStep?.(result, this.getSession());\n\n      if (result.status === \"error\") {\n        consecutiveErrors += 1;\n        lastError = result.message;\n        this.session.history.push(`Error: ${result.message}`);\n\n        if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {\n          this.session.isRunning = false;\n          this.events.onError?.(new Error(result.message), this.getSession());\n          this.events.onDone?.(result, this.getSession());\n          return result;\n        }\n\n        await this.delay(this.stepDelayMs);\n        continue;\n      }\n\n      consecutiveErrors = 0;\n      lastError = undefined;\n      this.session.history.push(result.message);\n\n      if (result.status === \"needs_approval\") {\n        this.session.pendingAction = result.action;\n        this.session.isRunning = false;\n        if (result.action) {\n          this.events.onApprovalRequired?.(result.action, this.getSession());\n        }\n        return result;\n      }\n\n      if ([\"done\", \"blocked\"].includes(result.status)) {\n        this.session.isRunning = false;\n        this.events.onDone?.(result, this.getSession());\n        return result;\n      }\n\n      await this.delay(this.stepDelayMs);\n    }\n\n    const result: ContentResult = { status: \"done\", message: \"Reached max steps\" };\n    this.session.history.push(result.message);\n    this.session.isRunning = false;\n    this.events.onMaxStepsReached?.(this.getSession());\n    this.events.onDone?.(result, this.getSession());\n    return result;\n  }\n\n  async approvePendingAction(): Promise<ContentResult> {\n    if (!this.session.pendingAction) {\n      return { status: \"error\", message: \"No pending action to approve\" };\n    }\n\n    try {\n      const message = await executeAction(this.session.pendingAction);\n      const result: ContentResult = {\n        status: \"executed\",\n        message,\n        action: this.session.pendingAction\n      };\n      this.session.history.push(message);\n      this.session.pendingAction = undefined;\n      this.session.isRunning = true;\n      this.events.onStep?.(result, this.getSession());\n      return result;\n    } catch (error) {\n      this.session.isRunning = false;\n      this.events.onError?.(error, this.getSession());\n      return { status: \"error\", message: String(error) };\n    }\n  }\n\n  stop(): void {\n    this.isStopped = true;\n    this.session.isRunning = false;\n  }\n\n  private async tick(lastError?: string): Promise<ContentResult> {\n    try {\n      const snapshot = collectSnapshot();\n      const plannerResult = await planNextAction(this.session.planner, {\n        goal: this.session.goal,\n        snapshot,\n        history: this.session.history,\n        lastError,\n        memory: this.session.memory\n      });\n\n      // Carry working memory forward across steps\n      if (plannerResult.memory !== undefined) {\n        this.session.memory = plannerResult.memory;\n      }\n\n      return this.processAction(plannerResult);\n    } catch (error) {\n      return { status: \"error\", message: String(error) };\n    }\n  }\n\n  private async processAction(plannerResult: PlannerResult): Promise<ContentResult> {\n    const { action } = plannerResult;\n    const reflection = plannerResult.evaluation !== undefined || plannerResult.memory !== undefined || plannerResult.nextGoal !== undefined\n      ? { evaluation: plannerResult.evaluation, memory: plannerResult.memory, nextGoal: plannerResult.nextGoal }\n      : undefined;\n\n    const risk = assessRisk(action);\n    if (risk === \"blocked\") {\n      return { status: \"blocked\", action, message: `Blocked action: ${JSON.stringify(action)}`, reflection };\n    }\n\n    if (this.session.mode === \"human-approved\" && risk === \"review\") {\n      return { status: \"needs_approval\", action, message: `Approval needed for ${action.type}`, reflection };\n    }\n\n    if (action.type === \"done\") {\n      return { status: \"done\", action, message: action.reason, reflection };\n    }\n\n    const message = await executeAction(action);\n    return { status: \"executed\", action, message, reflection };\n  }\n\n  private async delay(ms: number): Promise<void> {\n    await new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\nexport function createBrowserAgent(config: LibraryAgentConfig, events?: LibraryAgentEvents): BrowserAgent {\n  return new BrowserAgent(config, events);\n}\n\nexport { parseAction, parsePlannerResult } from \"../shared/parse-action\";\n\nexport type {\n  AgentAction,\n  AgentMode,\n  AgentSession,\n  ContentResult,\n  LibraryAgentConfig,\n  LibraryAgentEvents,\n  PlannerConfig,\n  PlannerInput,\n  PlannerKind,\n  PlannerResult,\n  RiskLevel\n} from \"../shared/contracts\";\n"],
+  "mappings": "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",
   "names": ["input", "result"]
 }

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "OmniBrowser Agent",
   "version": "0.2.2",
-  "description": "Local-first AI browser operator — heuristic, WebLLM, and page-agent planners.",
+  "description": "Local-first AI browser operator — heuristic and WebLLM planners.",
   "permissions": ["activeTab", "tabs", "scripting", "storage"],
   "host_permissions": ["http://*/*", "https://*/*"],
   "background": {

package/dist/popup.html

@@ -31,7 +31,6 @@
         <select id="planner">
           <option value="heuristic">Heuristic</option>
           <option value="webllm">WebLLM</option>
-          <option value="page-agent">page-agent</option>
         </select>
       </div>
     </div>

package/dist/types/core/planner.d.ts

@@ -1,2 +1,2 @@
-import type { AgentAction, PlannerConfig, PlannerInput } from "../shared/contracts";
-export declare function planNextAction(config: PlannerConfig, input: PlannerInput): Promise<AgentAction>;
+import type { PlannerConfig, PlannerInput, PlannerResult } from "../shared/contracts";
+export declare function planNextAction(config: PlannerConfig, input: PlannerInput): Promise<PlannerResult>;

package/dist/types/lib/index.d.ts

@@ -20,5 +20,5 @@ export declare class BrowserAgent {
     private delay;
 }
 export declare function createBrowserAgent(config: LibraryAgentConfig, events?: LibraryAgentEvents): BrowserAgent;
-export { parseAction } from "../shared/parse-action";
-export type { AgentAction, AgentMode, AgentSession, ContentResult, LibraryAgentConfig, LibraryAgentEvents, PlannerConfig, PlannerInput, PlannerKind, RiskLevel } from "../shared/contracts";
+export { parseAction, parsePlannerResult } from "../shared/parse-action";
+export type { AgentAction, AgentMode, AgentSession, ContentResult, LibraryAgentConfig, LibraryAgentEvents, PlannerConfig, PlannerInput, PlannerKind, PlannerResult, RiskLevel } from "../shared/contracts";

package/dist/types/shared/contracts.d.ts

@@ -1,5 +1,5 @@
 export type AgentMode = "autonomous" | "human-approved";
-export type PlannerKind = "heuristic" | "webllm" | "page-agent";
+export type PlannerKind = "heuristic" | "webllm";
 export type RiskLevel = "safe" | "review" | "blocked";
 export type AgentAction = {
     type: "click";
@@ -37,7 +37,7 @@ export interface CandidateElement {
     role: string;
     text: string;
     placeholder?: string;
-    /** Associated <label> text resolved via for/id, wrapping label, or aria-labelledby */
+    /** Associated <label> text resolved via for/id, aria-labelledby, aria-label, or wrapping <label> */
     label?: string;
 }
 export interface PageSnapshot {
@@ -52,6 +52,22 @@ export interface PlannerInput {
     history: string[];
     /** Error message from the previous step, fed back so the planner can recover */
     lastError?: string;
+    /** Accumulated working memory written by the planner across steps */
+    memory?: string;
+}
+/**
+ * What the planner returns: the next action plus optional reflection fields.
+ *
+ * Inspired by page-agent's evaluate → remember → plan → act loop.
+ * - `evaluation`  — what happened in the previous step
+ * - `memory`      — facts to carry into the next step
+ * - `nextGoal`    — what the planner intends to do next (shown as a thought bubble in UI)
+ */
+export interface PlannerResult {
+    action: AgentAction;
+    evaluation?: string;
+    memory?: string;
+    nextGoal?: string;
 }
 export interface PlannerConfig {
     kind: PlannerKind;
@@ -66,8 +82,10 @@ export interface AgentSession {
     history: string[];
     isRunning: boolean;
     pendingAction?: AgentAction;
-    /** Carried between ticks by the background/runner so the planner can see the last error */
+    /** Carried between ticks — last error for retry feedback */
     lastError?: string;
+    /** Working memory accumulated by the planner across steps */
+    memory?: string;
 }
 export interface LibraryAgentConfig {
     goal: string;
@@ -95,4 +113,10 @@ export type ContentResult = {
     status: "executed" | "needs_approval" | "blocked" | "done" | "error";
     message: string;
     action?: AgentAction;
+    /** Reflection fields from the planner — evaluation, memory, and next goal */
+    reflection?: {
+        evaluation?: string;
+        memory?: string;
+        nextGoal?: string;
+    };
 };

package/dist/types/shared/parse-action.d.ts

@@ -1,13 +1,17 @@
-import type { AgentAction } from "./contracts";
+import type { AgentAction, PlannerResult } from "./contracts";
 /**
  * Parse an AgentAction from raw LLM output.
  *
- * Handles:
- * - Bare JSON objects:  {"type":"click","selector":"#btn"}
- * - Markdown fences:   ```json\n{"type":"click",...}\n```
- * - JSON embedded in prose: "Sure! {"type":"click",...}"
- *
- * Returns a "done" action with the parse error as the reason if parsing fails,
- * so the caller always gets a valid AgentAction.
+ * Handles bare JSON, markdown fences, and JSON embedded in prose.
+ * Returns a "done" action if parsing fails, so the caller always gets a valid AgentAction.
  */
 export declare function parseAction(raw: string): AgentAction;
+/**
+ * Parse a full PlannerResult from raw LLM output.
+ *
+ * Accepts the reflection+action format:
+ *   { "evaluation": "...", "memory": "...", "next_goal": "...", "action": { ... } }
+ *
+ * Also accepts a bare AgentAction for backward compatibility with simple bridges.
+ */
+export declare function parsePlannerResult(raw: string): PlannerResult;

package/docs/ARCHITECTURE.md

@@ -12,7 +12,7 @@
 1. Popup UI (`src/popup`)
    - Starts/stops sessions
    - Picks mode (`autonomous`, `human-approved`)
-   - Picks planner (`heuristic`, `webllm`, `page-agent`)
+   - Picks planner (`heuristic`, `webllm`)
 
 2. Background Service Worker (`src/background`)
    - Session state machine per tab
@@ -20,8 +20,8 @@
    - Approval handling
 
 3. Content Agent (`src/content`)
-   - `pageObserver`: page snapshot extraction
-   - `planner`: next-action decision (heuristic / WebLLM / page-agent)
+   - `observer`: page snapshot extraction
+   - `planner`: next-action decision (heuristic / WebLLM)
    - `safety`: risk gating (`safe`, `review`, `blocked`)
    - `executor`: DOM action execution
 
@@ -33,6 +33,8 @@
   - type
   - navigate
   - extract
+  - scroll
+  - focus
   - wait
   - done
 
@@ -50,17 +52,7 @@ All planner bridges follow the same pattern: an object attached to `window` that
 
 ```ts
 window.__browserAgentWebLLM = {
-  async plan(input, modelId) { /* ... */ }
-};
-```
-
-### page-agent bridge
-
-Uses [alibaba/page-agent](https://github.com/alibaba/page-agent) (MIT) as the planning backend. The library calls `window.__browserAgentPageAgent.plan(input)`.
-
-```ts
-window.__browserAgentPageAgent = {
-  async plan(input) { /* ... */ }
+  async plan(input, modelId) { /* call local WebLLM engine, return AgentAction */ }
 };
 ```
 

package/docs/EMBEDDING.md

@@ -5,13 +5,13 @@ You can keep the extension flow and also embed OmniBrowser Agent as a library in
 ## Install
 
 ```bash
-npm install @akshaychame/omnibrowser-agent
+npm install @akshayram1/omnibrowser-agent
 ```
 
 ## Basic usage
 
 ```ts
-import { createBrowserAgent } from "@akshaychame/omnibrowser-agent";
+import { createBrowserAgent } from "@akshayram1/omnibrowser-agent";
 
 const agent = createBrowserAgent(
   {
@@ -49,58 +49,37 @@ agent.stop();
 
 ## WebLLM mode in embedded app
 
-To use planner mode `webllm`, provide a local bridge in your app:
+To use planner mode `webllm`, load the WebLLM engine and wire the bridge before starting the agent:
 
 ```ts
+import * as webllm from "@mlc-ai/web-llm";
+
+const engine = await webllm.CreateMLCEngine("Llama-3.2-1B-Instruct-q4f16_1-MLC");
+
 window.__browserAgentWebLLM = {
   async plan(input, modelId) {
-    // call your local WebLLM engine and return one AgentAction JSON
-    return { type: "done", reason: `Implement bridge with model ${modelId ?? "default"}` };
+    const resp = await engine.chat.completions.create({
+      messages: [
+        { role: "system", content: "Output only a JSON AgentAction object." },
+        { role: "user",   content: `Goal: ${input.goal}\nHistory: ${input.history.join(", ")}` }
+      ],
+      temperature: 0,
+      max_tokens: 100
+    });
+    return JSON.parse(resp.choices[0].message.content);
   }
 };
-```
-
-Then configure:
-
-```ts
-planner: { kind: "webllm", modelId: "Llama-3.2-1B-Instruct-q4f16_1-MLC" }
-```
-
-## page-agent mode in embedded app
-
-To use planner mode `page-agent`, install [page-agent](https://github.com/alibaba/page-agent) in your project and wire the bridge:
-
-```bash
-npm install page-agent
-```
-
-```ts
-import { PageAgent } from "page-agent";
 
-const pa = new PageAgent({
-  baseURL: "https://api.openai.com/v1",
-  model: "gpt-4o",
-  apiKey: "sk-..."
+const agent = createBrowserAgent({
+  goal: "Fill the contact form",
+  planner: { kind: "webllm", modelId: "Llama-3.2-1B-Instruct-q4f16_1-MLC" }
 });
 
-window.__browserAgentPageAgent = {
-  async plan(input) {
-    const result = await pa.execute(input.goal);
-    return { type: "done", reason: result.data };
-  }
-};
-```
-
-Then configure:
-
-```ts
-planner: { kind: "page-agent" }
+await agent.start();
 ```
 
-Use page-agent mode when your goals are complex, multi-step, or ambiguous — it uses LLM reasoning to determine the next action rather than regex heuristics.
-
 ## Notes
 
 - For production, mount this inside an authenticated app shell and add your own permission checks.
 - `human-approved` mode is recommended for CRM/finance/admin actions.
-- `page-agent` is not bundled with this library — it must be installed separately by the consumer.
+- The WebLLM bridge is not bundled — bring your own engine instance and wire it to `window.__browserAgentWebLLM`.

package/docs/ROADMAP.md

@@ -13,7 +13,6 @@
 - Improved heuristic planner with regex goal patterns
 - Better page observation (visibility filtering, placeholder capture)
 - Library API: `resume()`, `isRunning`, `hasPendingAction`, `AbortSignal`, `onMaxStepsReached`
-- **page-agent planner bridge** (`window.__browserAgentPageAgent`)
 
 ## v0.3
 

package/index.html

@@ -159,10 +159,7 @@ controller.abort();</code></pre>
                 <h4>webllm</h4>
                 <p>Delegates to a local WebLLM bridge (<code>window.__browserAgentWebLLM</code>). Fully private, no API calls.</p>
               </article>
-              <article class="doc-card">
-                <h4>page-agent</h4>
-                <p>Delegates to an <a href="https://github.com/alibaba/page-agent" target="_blank" rel="noreferrer">alibaba/page-agent</a> bridge (<code>window.__browserAgentPageAgent</code>). Best for complex multi-step goals.</p>
-              </article>
+
             </div>
 
             <h3>Supported Actions</h3>
@@ -211,7 +208,7 @@ controller.abort();</code></pre>
             <div class="docs-grid">
               <article class="doc-card">
                 <h4>Popup UI</h4>
-                <p>Starts/stops sessions. Picks execution mode (<code>autonomous</code>, <code>human-approved</code>) and planner (<code>heuristic</code>, <code>webllm</code>, <code>page-agent</code>).</p>
+                <p>Starts/stops sessions. Picks execution mode (<code>autonomous</code>, <code>human-approved</code>) and planner (<code>heuristic</code>, <code>webllm</code>).</p>
               </article>
               <article class="doc-card">
                 <h4>Background Service Worker</h4>
@@ -261,21 +258,6 @@ controller.abort();</code></pre>
   }
 };</code></pre>
 
-            <h4>page-agent bridge</h4>
-            <pre><code>import { PageAgent } from "page-agent";
-
-const pa = new PageAgent({
-  baseURL: "https://api.openai.com/v1",
-  model: "gpt-4o",
-  apiKey: "sk-..."
-});
-
-window.__browserAgentPageAgent = {
-  async plan(input) {
-    const result = await pa.execute(input.goal);
-    return { type: "done", reason: result.data };
-  }
-};</code></pre>
 
             <h3>Current Limitations</h3>
             <ul>
@@ -340,35 +322,11 @@ await agent.start();</code></pre>
 // Then configure:
 planner: { kind: "webllm", modelId: "Llama-3.2-1B-Instruct-q4f16_1-MLC" }</code></pre>
 
-            <h3>page-agent Mode</h3>
-            <p>
-              Install <a href="https://github.com/alibaba/page-agent" target="_blank" rel="noreferrer">page-agent</a>
-              and wire the bridge for complex multi-step goals:
-            </p>
-            <pre><code>npm install page-agent</code></pre>
-            <pre><code>import { PageAgent } from "page-agent";
-
-const pa = new PageAgent({
-  baseURL: "https://api.openai.com/v1",
-  model: "gpt-4o",
-  apiKey: "sk-..."
-});
-
-window.__browserAgentPageAgent = {
-  async plan(input) {
-    const result = await pa.execute(input.goal);
-    return { type: "done", reason: result.data };
-  }
-};
-
-// Then configure:
-planner: { kind: "page-agent" }</code></pre>
-
             <h3>Notes</h3>
             <ul>
               <li>For production, mount this inside an authenticated app shell and add your own permission checks.</li>
               <li><code>human-approved</code> mode is recommended for CRM, finance, and admin actions.</li>
-              <li><code>page-agent</code> is not bundled — it must be installed separately by the consumer.</li>
+              <li>The WebLLM bridge is not bundled — bring your own engine and attach it to <code>window.__browserAgentWebLLM</code>.</li>
             </ul>
           </div>
         </div>
@@ -394,7 +352,6 @@ planner: { kind: "page-agent" }</code></pre>
               <li>Improved heuristic planner with regex goal patterns</li>
               <li>Better page observation (visibility filtering, placeholder capture, up to 60 candidates)</li>
               <li>Library API: <code>resume()</code>, <code>isRunning</code>, <code>hasPendingAction</code>, <code>AbortSignal</code>, <code>onMaxStepsReached</code></li>
-              <li><strong>page-agent planner bridge</strong> (<code>window.__browserAgentPageAgent</code>)</li>
             </ul>
 
             <h3>v0.3</h3>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akshayram1/omnibrowser-agent",
-  "version": "0.2.3",
+  "version": "0.2.6",
   "private": false,
   "type": "module",
   "main": "./dist/lib.js",