pi-lean-dimension 0.2.0 → 0.2.2

package/README.md

@@ -8,7 +8,7 @@ search via SearXNG — all toggled from a single `/web` command. When the toggle
 is off, the tools are removed from the agent's context entirely, so web browsing
 doesn't consume tokens or attention on sessions that aren't doing web work.
 The same surfaces are user-extensible: author navigation guides that resurface
-by domain, or drop in a stealth browser backend like [Camoufox](https://github.com/nichochar/camoufox)
+by domain, or drop in a stealth browser backend like [Camoufox](https://github.com/daijro/camoufox)
 when a site blocks the shipped Chromium/Firefox.
 
 ## Quick start (recommended)
@@ -100,7 +100,7 @@ When search is installed, two independent glyphs appear:
 Beyond the `/web` toggle, two surfaces are user-driven rather than hardcoded:
 
 - **Navigation guides** — `web-learn` saves site-specific playbooks that auto-match by domain and resurface in later sessions.
-- **Custom browser backends** — if a site blocks the shipped Chromium/Firefox, drop a `bridge.py` subclass into `~/.pi/agent/pi-lean-portal/user-backends/` and drive a patched engine like [Camoufox](https://github.com/nichochar/camoufox) yourself. A quirks schema declares how the engine diverges from base Playwright, and `launch` options flow from `settings.json` to the subprocess at runtime. This is user-authored, user-audited code that the extension never auto-downloads — and as far as we're aware, no other Pi web plugin lets you run a browser backend you wrote yourself. Most installs never need it; the [portal README](packages/pi-lean-portal/README.md#stealth--custom-browser-backends) and [`contributed/README.md`](packages/pi-lean-portal/contributed/README.md) cover the full flow when you do.
+- **Custom browser backends** — if a site blocks the shipped Chromium/Firefox, drop a `bridge.py` subclass into `~/.pi/agent/pi-lean-portal/user-backends/` and drive a patched engine like [Camoufox](https://github.com/daijro/camoufox) yourself. A quirks schema declares how the engine diverges from base Playwright, and `launch` options flow from `settings.json` to the subprocess at runtime. This is user-authored, user-audited code that the extension never auto-downloads — and as far as we're aware, no other Pi web plugin lets you run a browser backend you wrote yourself. Most installs never need it; the [portal README](packages/pi-lean-portal/README.md#stealth--custom-browser-backends) and [`contributed/README.md`](packages/pi-lean-portal/contributed/README.md) cover the full flow when you do.
 
 ---
 

package/node_modules/pi-lean-portal/AGENTS.md

@@ -199,7 +199,7 @@ All tool calls dispatch through the router. Key responsibilities:
 - **Atomic writes + concurrency safety** (`storage-state.ts`): `saveStorageState()` writes to a temp file then renames atomically, preventing half-write races. Concurrent writers merge at the cookie level (`name+domain+path` key) and localStorage level (`origin+name` key), so two agents sharing a named profile don't clobber each other's data.
 - **Session profiles** (`profile="session"`) are scoped to one pi conversation, stored under `_session-<piSessionId>`. Default profile is now `"session"` (changed from `"none"`), so conversations persist state automatically.
 - **Named profiles** (`profile="shopping"`, `profile="work"`) are shared across conversations and agents.
-- **Conversation-scoped default profile** set via `/web profile set <name>`, survives `/reload`/`/resume`.
+- **Conversation-scoped default profile** set via `/web profile <name>` (or `/web profile none` / `/web profile session`), survives `/reload`/`/resume`.
 - **Cookie operations** (`getCookies`, `addCookies`, `clearCookies`) delegate to the browser plugin's Playwright `context.cookies()` / `context.clearCookies()`.
 
 ## Known Constraints & Debt

package/node_modules/pi-lean-portal/README.md

@@ -6,9 +6,7 @@
 > domain. A `/web` toggle removes the tools from the agent's context when
 > switched off, so web browsing doesn't consume tokens on sessions that aren't
 > doing web work. If a site blocks the shipped browsers, drop in your own
-> backend (e.g. [Camoufox](https://github.com/nichochar/camoufox)) — as far as
-> we're aware, no other Pi web plugin lets you run a browser backend you wrote
-> yourself.
+> backend (e.g. [Camoufox](https://github.com/daijro/camoufox)).
 >
 > Part of the [pi-lean-dimension](https://github.com/coreyryanhanson/pi-lean-dimension)
 > web-tools suite. For SearXNG search support, install
@@ -42,7 +40,7 @@ npx playwright install chromium firefox
 
 Once loaded, you'll see a notification like:
 
-> 🌐 Browser extension loaded (plugins: chromium, firefox)
+> 🌐 Browser extension loaded (plugins: chromium, firefox). Try: web-fetch for static pages or browser-navigate for interactive browsing.
 
 The browser tools are **enabled by default**. You can:
 
@@ -70,7 +68,7 @@ Beyond the toggle, two surfaces are user-extensible rather than hardcoded:
   [Navigation Guides](#navigation-guides-web-guide--web-learn).
 - **Custom browser backends** — if a site blocks the shipped Chromium/Firefox,
   drop a `bridge.py` subclass into `~/.pi/agent/pi-lean-portal/user-backends/`
-  and drive a patched engine like [Camoufox](https://github.com/nichochar/camoufox)
+  and drive a patched engine like [Camoufox](https://github.com/daijro/camoufox)
   yourself. The full flow lives in [Backend Architecture](#backend-architecture)
   and [`contributed/README.md`](./contributed/README.md).
 
@@ -122,7 +120,8 @@ which defaults to `true`).
 **Auto-captured screenshots:** `browser-navigate` and `browser-snapshot` automatically
 capture a screenshot to a temp file (`/tmp/pi-lean-portal/screenshot-<taskId>.jpg`).
 Use the `read` tool to visually inspect the page when the accessibility tree isn't enough.
-No viewport resizing occurs — screenshots are captured at the native 1280px width.
+Screenshots capture the 1280×720 viewport (not full-page) — the same viewport the
+browser uses for navigation.
 
 ### 1. `browser-navigate` — Visit a Page
 
@@ -201,7 +200,7 @@ Navigates back in browser history. Returns the previous page's snapshot.
 browser-press key="Enter"
 ```
 
-Useful keys: `Enter`, `Tab`, `Escape`, `ArrowDown`, `ArrowUp`, `/`.
+Useful keys: `Enter`, `Tab`, `Escape`, `ArrowDown`, `ArrowUp`, `Backspace`.
 
 ### 8. `browser-console` — Read Console / Run JS
 
@@ -306,12 +305,13 @@ Shows everything about the browser runtime in one notification:
 🌐 Browser tools: ✅ on  |  📖 Learn mode: ❌ off
 ────────────────────────────────────────
 Status: idle
-Plugins: chromium
+Plugins: chromium, firefox, chromium-py (disabled), firefox-py (disabled)
+Use web-fetch for stateless HTTP fetches.
 Active sessions: 1
   PW [chromium] https://example.com — Example Domain [profile: session]
-Profiles: 2 on disk
-  📋 session  (2.1 KB) ← active
-  shopping  (0.3 KB)
+Profiles: 1 on disk (named)
+  shopping  (0.3 KB) ← active
+Session profiles: 1 (manage with /web profile)
 ```
 
 Covers:
@@ -320,7 +320,9 @@ Covers:
 - **Backend health** — idle, busy, or error state
 - **All registered plugins** — enabled/disabled status
 - **Active sessions** — current URL, title, profile name per session
-- **Profiles on disk** — state size and which one is currently active
+- **Profiles on disk** — named profiles with state size and which is
+  currently active; session profiles are collapsed into a single count line
+  (inspect individually with `/web profile list`)
 
 When `pi-lean-search` is also installed, the status bar shows two independent
 glyphs: `● idle` (browser state) and `● searxng` (search health/state).
@@ -614,8 +616,9 @@ Size threshold for profile state warnings (default: 10 MB):
 ### Working with `@e` Element References
 
 - `@e1`, `@e2`, etc. are assigned based on the accessibility tree order
-- After clicking or scrolling, **always take a fresh snapshot** — old `@e`
-  refs become stale
+- `browser-click`/`type`/`scroll` already return a fresh snapshot and cache
+  the full tree to disk — no separate `browser-snapshot` needed unless you
+  want the uncompacted tree (`full=true`) or a screenshot
 - `browser-inspect` is cheaper than `browser-snapshot full=true` for finding
   specific elements
 
@@ -623,8 +626,9 @@ Size threshold for profile state warnings (default: 10 MB):
 
 - Snapshots are automatically compacted to ~2500 characters
 - Very large pages (>8000 chars) preserve the top ~2000 chars
-- The **full tree is cached to disk** at `/tmp/pi-lean-portal/snapshot-*.txt` —
-  you can use `read` on the cache file with offset/limit
+- The **full tree is cached to disk** at `/tmp/pi-lean-portal/snapshot-*.txt`
+  when it would otherwise be truncated — use `read` on the cache file with
+  offset/limit to retrieve the complete tree
 - `browser-inspect text=true query="keyword"` finds specific content without
   loading the full tree
 
@@ -636,8 +640,14 @@ When a page triggers anti-automation:
 2. The **bot-detection guide** footer appears with strategies available via `web-guide`
 3. If very few elements are detected (<5), the navigation is treated as
    a hard failure — the agent won't try to interact with a challenge page
-4. Try `web-fetch` on the same URL — it sometimes succeeds where the
-   interactive browser doesn't
+4. Retry with a stealth backend — the `browser-navigate` `strategy`
+   parameter lists registered backend names; a stealth backend (e.g.
+   `strategy="camoufox"`) can pass challenges the default `chromium`/
+   `firefox` triggers. Only names listed in the `strategy` description
+   are valid — there is no `"stealth"` alias
+5. Try `web-fetch` on the same URL — it skips JS execution, so it can
+   retrieve raw HTML on pages that block the interactive browser via
+   client-side fingerprinting (it won't help against server-side WAFs)
 
 ### Guide Creation Discipline
 

package/node_modules/pi-lean-portal/__tests__/plugin-config-browser.test.ts

@@ -92,6 +92,34 @@ describe("loadFullConfig().browser", () => {
 		mockGlobalSettings({ unrelated: true });
 		const config = loadFullConfig().browser;
 		expect(config.defaultProfile).toBe("session");
+		expect(config.maxStorageStateSize).toBe(10 * 1024 * 1024);
+	});
+
+	// ── maxStorageStateSize ────────────────────────────────────
+
+	describe("maxStorageStateSize", () => {
+		it("accepts a positive number", () => {
+			mockGlobalSettings({ maxStorageStateSize: 5 * 1024 * 1024 });
+			expect(loadFullConfig().browser.maxStorageStateSize).toBe(
+				5 * 1024 * 1024,
+			);
+		});
+
+		it("floors fractional values", () => {
+			mockGlobalSettings({ maxStorageStateSize: 5.9 * 1024 * 1024 });
+			expect(loadFullConfig().browser.maxStorageStateSize).toBe(
+				Math.floor(5.9 * 1024 * 1024),
+			);
+		});
+
+		it("rejects zero / negative / non-finite and falls back to default", () => {
+			for (const bad of [0, -1, Infinity, NaN, "big", null]) {
+				mockGlobalSettings({ maxStorageStateSize: bad });
+				expect(loadFullConfig().browser.maxStorageStateSize).toBe(
+					10 * 1024 * 1024,
+				);
+			}
+		});
 	});
 
 	// ── defaultProfile ─────────────────────────────────────────