@akshayram1/omnibrowser-agent 0.2.1 → 0.2.2

package/README.md

@@ -1,7 +1,7 @@
 # omnibrowser-agent
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.2.0-green.svg)](package.json)
+[![Version](https://img.shields.io/badge/version-0.2.2-green.svg)](package.json)
 
 Local-first open-source browser AI operator using in-browser planning and page actions.
 
@@ -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 local WebLLM bridge
+- Pluggable planner bridges: WebLLM and page-agent
 
 ## Project structure
 
@@ -63,7 +63,7 @@ npm run build
 ## Use as a web library
 
 ```ts
-import { createBrowserAgent } from "@akshaychame/omnibrowser-agent";
+import { createBrowserAgent } from "@akshayram1/omnibrowser-agent";
 
 const agent = createBrowserAgent({
   goal: "Open CRM and find customer John Smith",
@@ -137,6 +137,11 @@ It is preconfigured to use `webllm` planner mode and loads `@mlc-ai/web-llm` fro
 
 ## Changelog
 
+### 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
+
 ### v0.2.0
 
 - **New actions**: `scroll` and `focus`
@@ -154,10 +159,44 @@ It is preconfigured to use `webllm` planner mode and loads `@mlc-ai/web-llm` fro
 - Heuristic + WebLLM planner switch
 - Human-approved mode
 
+## Planner modes
+
+| 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" }
+```
+
 ## 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.
 
 ## Roadmap
 

package/dist/content.js

@@ -214,6 +214,16 @@ 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);
+  }
   const bridge = window.__browserAgentWebLLM;
   if (!bridge) {
     return {

package/dist/content.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/shared/safety.ts", "../src/content/executor.ts", "../src/content/pageObserver.ts", "../src/content/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      mustFind(action.selector).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      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      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\") {\n    return false;\n  }\n  const style = window.getComputedStyle(el);\n  return style.display !== \"none\" && style.visibility !== \"hidden\" && style.opacity !== \"0\";\n}\n\nexport function collectSnapshot(): PageSnapshot {\n  const nodes = Array.from(\n    document.querySelectorAll<HTMLElement>(CANDIDATE_SELECTOR)\n  )\n    .filter(isVisible)\n    .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    return {\n      selector: cssPath(node),\n      role: node.getAttribute(\"role\") ?? node.tagName.toLowerCase(),\n      text: (node.innerText || node.getAttribute(\"aria-label\") || node.getAttribute(\"name\") || \"\").trim().slice(0, 120),\n      placeholder: placeholder || 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\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  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 \"./executor\";\nimport { collectSnapshot } from \"./pageObserver\";\nimport { planNextAction } from \"./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  });\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      mustFind(action.selector).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      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      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\") {\n    return false;\n  }\n  const style = window.getComputedStyle(el);\n  return style.display !== \"none\" && style.visibility !== \"hidden\" && style.opacity !== \"0\";\n}\n\nexport function collectSnapshot(): PageSnapshot {\n  const nodes = Array.from(\n    document.querySelectorAll<HTMLElement>(CANDIDATE_SELECTOR)\n  )\n    .filter(isVisible)\n    .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    return {\n      selector: cssPath(node),\n      role: node.getAttribute(\"role\") ?? node.tagName.toLowerCase(),\n      text: (node.innerText || node.getAttribute(\"aria-label\") || node.getAttribute(\"name\") || \"\").trim().slice(0, 120),\n      placeholder: placeholder || 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 \"./executor\";\nimport { collectSnapshot } from \"./pageObserver\";\nimport { planNextAction } from \"./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  });\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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",
   "names": ["input"]
 }

package/dist/lib.js

@@ -179,6 +179,16 @@ 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);
+  }
   const bridge = window.__browserAgentWebLLM;
   if (!bridge) {
     return {

package/dist/lib.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/content/executor.ts", "../src/content/pageObserver.ts", "../src/content/planner.ts", "../src/shared/safety.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      mustFind(action.selector).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      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      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\") {\n    return false;\n  }\n  const style = window.getComputedStyle(el);\n  return style.display !== \"none\" && style.visibility !== \"hidden\" && style.opacity !== \"0\";\n}\n\nexport function collectSnapshot(): PageSnapshot {\n  const nodes = Array.from(\n    document.querySelectorAll<HTMLElement>(CANDIDATE_SELECTOR)\n  )\n    .filter(isVisible)\n    .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    return {\n      selector: cssPath(node),\n      role: node.getAttribute(\"role\") ?? node.tagName.toLowerCase(),\n      text: (node.innerText || node.getAttribute(\"aria-label\") || node.getAttribute(\"name\") || \"\").trim().slice(0, 120),\n      placeholder: placeholder || 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\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  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 { executeAction } from \"../content/executor\";\nimport { collectSnapshot } from \"../content/pageObserver\";\nimport { planNextAction } from \"../content/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\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    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();\n      this.session.history.push(result.message);\n      this.events.onStep?.(result, this.getSession());\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\", \"error\"].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(): 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      });\n\n      return this.processAction(action);\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  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 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      mustFind(action.selector).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      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      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\") {\n    return false;\n  }\n  const style = window.getComputedStyle(el);\n  return style.display !== \"none\" && style.visibility !== \"hidden\" && style.opacity !== \"0\";\n}\n\nexport function collectSnapshot(): PageSnapshot {\n  const nodes = Array.from(\n    document.querySelectorAll<HTMLElement>(CANDIDATE_SELECTOR)\n  )\n    .filter(isVisible)\n    .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    return {\n      selector: cssPath(node),\n      role: node.getAttribute(\"role\") ?? node.tagName.toLowerCase(),\n      text: (node.innerText || node.getAttribute(\"aria-label\") || node.getAttribute(\"name\") || \"\").trim().slice(0, 120),\n      placeholder: placeholder || 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 { executeAction } from \"../content/executor\";\nimport { collectSnapshot } from \"../content/pageObserver\";\nimport { planNextAction } from \"../content/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\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    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();\n      this.session.history.push(result.message);\n      this.events.onStep?.(result, this.getSession());\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\", \"error\"].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(): 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      });\n\n      return this.processAction(action);\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  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 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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",
   "names": ["input", "result"]
 }

package/dist/popup.html

@@ -31,6 +31,7 @@
         <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/shared/contracts.d.ts

@@ -1,5 +1,5 @@
 export type AgentMode = "autonomous" | "human-approved";
-export type PlannerKind = "heuristic" | "webllm";
+export type PlannerKind = "heuristic" | "webllm" | "page-agent";
 export type RiskLevel = "safe" | "review" | "blocked";
 export type AgentAction = {
     type: "click";

package/docs/ARCHITECTURE.md

@@ -1,4 +1,4 @@
-# OmniBrowser Agent Architecture (v0.1)
+# OmniBrowser Agent Architecture (v0.2)
 
 ## Goals
 
@@ -12,7 +12,7 @@
 1. Popup UI (`src/popup`)
    - Starts/stops sessions
    - Picks mode (`autonomous`, `human-approved`)
-   - Picks planner (`heuristic`, `webllm`)
+   - Picks planner (`heuristic`, `webllm`, `page-agent`)
 
 2. Background Service Worker (`src/background`)
    - Session state machine per tab
@@ -21,7 +21,7 @@
 
 3. Content Agent (`src/content`)
    - `pageObserver`: page snapshot extraction
-   - `planner`: next-action decision (heuristic/WebLLM)
+   - `planner`: next-action decision (heuristic / WebLLM / page-agent)
    - `safety`: risk gating (`safe`, `review`, `blocked`)
    - `executor`: DOM action execution
 
@@ -42,13 +42,29 @@
 - Review risky actions (submit/delete/pay-like selectors)
 - In `human-approved` mode, review-level actions require manual approval
 
-## WebLLM Usage
+## Planner Bridges
 
-- Planner includes a `webllm` mode contract with a local bridge hook
-- v0.1 bridge entrypoint: `window.__browserAgentWebLLM.plan(input, modelId)`
-- Full in-extension worker integration is planned for v0.2
+All planner bridges follow the same pattern: an object attached to `window` that implements a `plan()` method returning an `AgentAction`. The core library has zero runtime dependencies — bridge implementations are provided by the consumer.
 
-## Limitations (v0.1)
+### WebLLM bridge
+
+```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) { /* ... */ }
+};
+```
+
+## Limitations (v0.2)
 
 - No persistent long-term memory yet
 - No task DSL/skills registry yet

package/docs/EMBEDDING.md

@@ -66,7 +66,41 @@ Then configure:
 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-..."
+});
+
+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" }
+```
+
+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.

package/docs/ROADMAP.md

@@ -1,13 +1,21 @@
 # Roadmap
 
-## v0.1 (current)
+## v0.1
 
 - Extension runtime loop
 - Shared action contracts
 - Heuristic + WebLLM planner switch
 - Human-approved mode
 
-## v0.2
+## v0.2 (current)
+
+- New actions: `scroll`, `focus`
+- 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
 
 - Site profile + policy engine (allowlist, blocked domains)
 - Selector healing and fallback strategy

package/index.html

@@ -0,0 +1,207 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>OmniBrowser Agent</title>
+    <meta
+      name="description"
+      content="OmniBrowser Agent - local-first browser AI operator library."
+    />
+    <link rel="stylesheet" href="./styles.css" />
+  </head>
+  <body>
+    <header class="header">
+      <div class="wrap header-row">
+        <a class="brand" href="#home">OmniBrowser Agent</a>
+        <nav class="nav">
+          <a href="#home">Home</a>
+          <a href="#docs">Docs</a>
+          <a href="#contact">Contact</a>
+        </nav>
+      </div>
+    </header>
+
+    <main>
+      <section id="home" class="section hero">
+        <div class="wrap">
+          <p class="eyebrow">Open-source browser automation SDK</p>
+          <h1>Local-first browser AI automation library</h1>
+          <p>
+            OmniBrowser Agent helps you run page observation, planning, and execution flows directly in the browser.
+          </p>
+          <div class="chips">
+            <span>Privacy-first</span>
+            <span>WebLLM-ready</span>
+            <span>Human-approved mode</span>
+            <span>Embeddable API</span>
+          </div>
+          <div class="actions">
+            <a
+              class="btn primary"
+              href="https://www.npmjs.com/package/@akshayram1/omnibrowser-agent"
+              target="_blank"
+              rel="noreferrer"
+              >NPM Package</a
+            >
+            <a
+              class="btn"
+              href="https://github.com/akshayram1/omnibrowser-agent"
+              target="_blank"
+              rel="noreferrer"
+              >GitHub Repo</a
+            >
+          </div>
+          <div class="stats" aria-label="project stats">
+            <div class="stat"><strong>2</strong><span>Execution Modes</span></div>
+            <div class="stat"><strong>3</strong><span>Planner Options</span></div>
+            <div class="stat"><strong>MIT</strong><span>License</span></div>
+          </div>
+          <div class="home-grid">
+            <article class="card">
+              <h3>Use Cases</h3>
+              <ul>
+                <li>CRM profile lookup automation</li>
+                <li>Guided web task execution</li>
+                <li>Assisted data extraction flows</li>
+              </ul>
+            </article>
+            <article class="card">
+              <h3>Core Modules</h3>
+              <ul>
+                <li><strong>Observer:</strong> page signals and candidates</li>
+                <li><strong>Planner:</strong> next best action selection</li>
+                <li><strong>Executor:</strong> safe browser action runtime</li>
+              </ul>
+            </article>
+            <article class="card">
+              <h3>Project Links</h3>
+              <ul>
+                <li><a href="https://www.npmjs.com/package/@akshayram1/omnibrowser-agent" target="_blank" rel="noreferrer">NPM package</a></li>
+                <li><a href="https://github.com/akshayram1/omnibrowser-agent" target="_blank" rel="noreferrer">GitHub repository</a></li>
+                <li><a href="./README.md" target="_blank" rel="noreferrer">README</a></li>
+              </ul>
+            </article>
+          </div>
+        </div>
+      </section>
+
+      <section id="docs" class="section">
+        <div class="wrap">
+          <div class="surface">
+          <h2>Docs</h2>
+          <p>
+            Everything you need to install, initialize, and run your first browser agent with clear defaults.
+          </p>
+
+          <h3>Installation</h3>
+          <pre><code>npm install @akshayram1/omnibrowser-agent</code></pre>
+
+          <h3>Quick Start</h3>
+          <pre><code>import { createBrowserAgent } from "@akshayram1/omnibrowser-agent";
+
+const agent = createBrowserAgent(
+  {
+    goal: "Open CRM and find customer John Smith",
+    mode: "human-approved"
+  },
+  {
+    onStep: (result) => console.log(result.message)
+  }
+);
+
+await agent.start();</code></pre>
+
+          <h3>Execution Modes</h3>
+          <div class="docs-grid">
+            <article class="doc-card">
+              <h4>human-approved</h4>
+              <p>Requires explicit approval for sensitive actions. Best for production-like workflows.</p>
+            </article>
+            <article class="doc-card">
+              <h4>autonomous</h4>
+              <p>Runs actions continuously with fewer pauses. Best for rapid iteration and demos.</p>
+            </article>
+          </div>
+
+          <h3>Planner Options</h3>
+          <div class="docs-grid">
+            <article class="doc-card">
+              <h4>heuristic</h4>
+              <p>Zero-dependency regex-based planner. Works offline. Best for simple, predictable goals.</p>
+            </article>
+            <article class="doc-card">
+              <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>Recommended Integration Flow</h3>
+          <ol>
+            <li>Create an agent with your goal and preferred mode.</li>
+            <li>Attach callbacks (`onStep`, `onApprovalRequired`, `onDone`) to drive UI state.</li>
+            <li>Call <code>start()</code> to begin planning and execution.</li>
+            <li>If approval is required, surface the action and call <code>resume()</code>.</li>
+            <li>Use <code>stop()</code> for cancellation and reset.</li>
+          </ol>
+
+          <h3>Safety Notes</h3>
+          <ul>
+            <li>Prefer scoped selectors for deterministic action targeting.</li>
+            <li>Use human-approved mode for workflows that mutate critical data.</li>
+            <li>Log `onStep` output for auditability and debugging.</li>
+          </ul>
+
+          <p>
+            Full project docs are available in this repository under
+            <a href="./docs/ARCHITECTURE.md" target="_blank" rel="noreferrer">Architecture</a>,
+            <a href="./docs/EMBEDDING.md" target="_blank" rel="noreferrer">Embedding</a>, and
+            <a href="./docs/ROADMAP.md" target="_blank" rel="noreferrer">Roadmap</a>.
+          </p>
+          </div>
+        </div>
+      </section>
+
+      <section id="contact" class="section">
+        <div class="wrap">
+          <div class="surface">
+          <h2>Contact</h2>
+          <p>Maintainer: Akshay Chame</p>
+          <ul>
+            <li>
+              Email:
+              <a href="mailto:akshaychame2@gmail.com">akshaychame2@gmail.com</a>
+            </li>
+            <li>
+              GitHub:
+              <a href="https://github.com/akshayram1" target="_blank" rel="noreferrer">@akshayram1</a>
+            </li>
+            <li>
+              Package:
+              <a
+                href="https://www.npmjs.com/package/@akshayram1/omnibrowser-agent"
+                target="_blank"
+                rel="noreferrer"
+                >@akshayram1/omnibrowser-agent</a
+              >
+            </li>
+          </ul>
+            <p class="contact-note">
+              For feature requests or bugs, please open an issue on GitHub with reproduction steps.
+            </p>
+          </div>
+        </div>
+      </section>
+    </main>
+
+      <footer class="footer">
+        <div class="wrap">
+          <p>© 2026 OmniBrowser Agent · MIT License</p>
+        </div>
+      </footer>
+  </body>
+</html>

package/package.json

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

package/styles.css

@@ -0,0 +1,294 @@
+:root {
+  color-scheme: light;
+  font-family: Inter, system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  color: #182033;
+  background:
+    radial-gradient(circle at 12% -8%, #dce7ff 0%, transparent 36%),
+    radial-gradient(circle at 88% 0%, #e4f0ff 0%, transparent 32%),
+    #f5f7fc;
+}
+
+.wrap {
+  width: min(960px, 92vw);
+  margin: 0 auto;
+}
+
+.header {
+  position: sticky;
+  top: 0;
+  border-bottom: 1px solid #dce3f3;
+  background: rgba(255, 255, 255, 0.92);
+  backdrop-filter: blur(8px);
+  z-index: 10;
+}
+
+.header-row {
+  min-height: 64px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.brand {
+  font-weight: 700;
+  text-decoration: none;
+  color: inherit;
+  letter-spacing: 0.2px;
+}
+
+.nav {
+  display: flex;
+  gap: 16px;
+}
+
+.nav a {
+  text-decoration: none;
+  color: #304265;
+  font-weight: 500;
+  padding: 6px 10px;
+  border-radius: 8px;
+}
+
+.nav a:hover {
+  background: #edf2ff;
+}
+
+.section {
+  padding: 56px 0;
+}
+
+.hero {
+  background: radial-gradient(circle at top right, #dbe6ff 0%, transparent 38%);
+  padding-top: 64px;
+}
+
+.eyebrow {
+  display: inline-block;
+  margin: 0;
+  font-size: 12px;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+  color: #3356a6;
+  background: #e9efff;
+  border: 1px solid #ccdafc;
+  border-radius: 999px;
+  padding: 6px 10px;
+}
+
+.hero h1 {
+  margin: 14px 0 0;
+  font-size: clamp(28px, 4vw, 42px);
+  line-height: 1.12;
+  max-width: 860px;
+}
+
+.hero p {
+  margin-top: 14px;
+  font-size: 18px;
+  line-height: 1.55;
+  max-width: 720px;
+}
+
+.chips {
+  margin-top: 18px;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.chips span {
+  font-size: 13px;
+  color: #2a3f72;
+  background: #e9efff;
+  border: 1px solid #ccdafc;
+  border-radius: 999px;
+  padding: 6px 10px;
+}
+
+.actions {
+  margin-top: 22px;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 12px;
+}
+
+.btn {
+  display: inline-block;
+  padding: 10px 16px;
+  border-radius: 10px;
+  text-decoration: none;
+  border: 1px solid #c8d4f1;
+  color: #1a2742;
+  background: #eef3ff;
+  transition: transform 0.18s ease, box-shadow 0.18s ease, background 0.18s ease;
+}
+
+.btn.primary {
+  background: #1f3a8a;
+  border-color: #1f3a8a;
+  color: #fff;
+}
+
+.btn:hover {
+  transform: translateY(-1px);
+  box-shadow: 0 8px 20px rgba(32, 58, 138, 0.12);
+}
+
+.stats {
+  margin-top: 18px;
+  display: grid;
+  grid-template-columns: repeat(3, minmax(120px, 1fr));
+  gap: 10px;
+  max-width: 560px;
+}
+
+.stat {
+  background: #fff;
+  border: 1px solid #dce3f3;
+  border-radius: 12px;
+  padding: 10px 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.stat strong {
+  font-size: 18px;
+  color: #1f3a8a;
+}
+
+.stat span {
+  font-size: 12px;
+  color: #4f6290;
+}
+
+.home-grid {
+  margin-top: 24px;
+  display: grid;
+  gap: 14px;
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+}
+
+.card {
+  background: #fff;
+  border: 1px solid #dce3f3;
+  border-radius: 12px;
+  padding: 14px;
+  box-shadow: 0 8px 24px rgba(18, 33, 73, 0.05);
+  transition: transform 0.2s ease, box-shadow 0.2s ease;
+}
+
+.card:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 14px 30px rgba(18, 33, 73, 0.11);
+}
+
+.card h3 {
+  margin-top: 0;
+  margin-bottom: 10px;
+}
+
+h2 {
+  margin-top: 0;
+}
+
+h3 {
+  margin-bottom: 10px;
+}
+
+h4 {
+  margin: 0 0 6px;
+}
+
+.docs-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
+  gap: 12px;
+  margin-bottom: 14px;
+}
+
+.doc-card {
+  border: 1px solid #dce3f3;
+  background: #fff;
+  border-radius: 12px;
+  padding: 12px;
+  box-shadow: 0 5px 14px rgba(18, 33, 73, 0.04);
+}
+
+.surface {
+  background: rgba(255, 255, 255, 0.86);
+  border: 1px solid #dce3f3;
+  border-radius: 16px;
+  padding: 24px;
+  box-shadow: 0 14px 28px rgba(18, 33, 73, 0.06);
+}
+
+pre {
+  overflow: auto;
+  border: 1px solid #dce3f3;
+  border-radius: 10px;
+  background: #ffffff;
+  padding: 14px;
+  line-height: 1.45;
+}
+
+code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;
+}
+
+ol {
+  padding-left: 20px;
+  line-height: 1.6;
+}
+
+ul {
+  padding-left: 18px;
+}
+
+li {
+  margin: 8px 0;
+}
+
+a {
+  color: #2647a8;
+}
+
+.contact-note {
+  margin-top: 14px;
+  color: #4b5d84;
+}
+
+.footer {
+  border-top: 1px solid #dce3f3;
+  padding: 20px 0;
+  color: #5b6c91;
+  font-size: 14px;
+}
+
+@media (max-width: 720px) {
+  .header-row {
+    min-height: 58px;
+  }
+
+  .nav {
+    gap: 8px;
+  }
+
+  .stats {
+    grid-template-columns: 1fr;
+    max-width: 100%;
+  }
+
+  .surface {
+    padding: 18px;
+  }
+}

package/vercel.json

@@ -0,0 +1,4 @@
+{
+  "cleanUrls": true,
+  "trailingSlash": false
+}