Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
refactor: delete five retired subsystems nothing could reach
Rahman7112223e04e4
diff --git a/CLAUDE.md b/CLAUDE.mdindex 94746bad..e722d6da 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -253,8 +253,8 @@ to `resources/` (rr) and drive any project from one manifest:(enforced by a test in `bin/mso.test.ts`), plus `doctor`, `completion` and `--base`.`scripts/install.sh` symlinksit to `~/.local/bin/mso` and symlinks `claude-skills/*` into `~/.claude/skills/`-(`/mso`, `/mso-camoufox`, `/mso-apps`, `/mso-list`, `/mso-image-editor`,-`/mso-browser-list`). `mso -h` lists every verb; `mso api <METHOD> <path> [json]` is+(`/mso`, `/mso-camoufox`, `/mso-apps`, `/mso-list`, `/mso-image-editor`).+`mso -h` lists every verb; `mso api <METHOD> <path> [json]` isthe escape hatch for anything without a named verb.- **Every CLI caller must send `Origin: <base>`.** `proxy.ts` blocks mutating `/api`that cannot prove same-origin; a browser proves it with `Sec-Fetch-Site`, and thediff --git a/README.md b/README.mdindex 95bbb1d6..88f5f44d 100644--- a/README.md+++ b/README.md@@ -140,7 +140,7 @@ Global options: `--base <url>` to target another instance, `--env <file>` to picdifferent secrets file. Device and service commands work even while the service isdown. If you use [Claude Code](https://claude.com/claude-code), the installer alsolinks the agent skills in `claude-skills/` into `~/.claude/skills/` — `/mso`,-`/mso-camoufox`, `/mso-apps`, `/mso-list`, `/mso-image-editor`, `/mso-browser-list`.+`/mso-camoufox`, `/mso-apps`, `/mso-list`, `/mso-image-editor`.## Security warningdiff --git a/app/os-root.tsx b/app/os-root.tsxindex 7f7040b4..e2c07582 100644--- a/app/os-root.tsx+++ b/app/os-root.tsx@@ -13,7 +13,7 @@ import {} from "@/features/os-shell";import { AppearanceProvider } from "@/lib/appearance";import { QuicklinksProvider } from "@/lib/quicklinks";-import "@/features/os-shell/integrations"; // side-effect: lock guard + Quick Look + DnD wiring+import "@/features/os-shell/integrations"; // side-effect: lock guard + context menus + palette commandsimport { OsApiProvider } from "@/lib/os-api";import { AuthGate, SessionProvider, useSession, type SessionStatus } from "@/features/auth";import { useInstalledApps, useDisabledIds } from "@/features/app-store";diff --git a/claude-skills/mso-apps/SKILL.md b/claude-skills/mso-apps/SKILL.mdindex 32c4a5f5..e329e702 100644--- a/claude-skills/mso-apps/SKILL.md+++ b/claude-skills/mso-apps/SKILL.md@@ -6,14 +6,13 @@ description: Drive ANY mso app from the CLI — one app→function→command mat# /mso-apps — every mso app from the CLIOne reference for operating each app. Everything routes through three transports-([/mso] owns them): `mso` (host fs/exec/sys + generic `crud`), `browser.sh`-(real Chromium), `image-editor.sh` (editor-document CRUD). Deep dives:+([/mso] owns them): `mso` (host fs/exec/sys + generic `crud`), `/mso-camoufox`+(a real logged-in browser), `image-editor.sh` (editor-document CRUD). Deep dives:[/mso] (control + crud), [/mso-image-editor] (editor docs), [/mso-list] (LIVE audit-of every function), [/mso-browser-list] (browser internals).+of every function).```bashOS=mso-BR=/home/rahman/.claude/skills/mso/browser.shIE=/home/rahman/.claude/skills/mso-image-editor/image-editor.sh```@@ -25,11 +24,11 @@ IE=/home/rahman/.claude/skills/mso-image-editor/image-editor.sh| **Code Editor** | tree, open, edit, save, new file | `$OS cat <f>` / `$OS write <f> <content>` (or edit directly — this box IS the VPS) || **Terminal** | fs builtins + host shell passthrough | `$OS exec "<cmd>"` · `$OS ps` || **System Monitor** | CPU/mem/disk gauges, process table | `$OS stats` · `$OS ps` (read-only) |-| **Browser** | navigate, back/fwd/reload, click/type/scroll, read | `$BR go\|back\|reload\|click\|type\|key\|scroll\|content\|shot` |+| **Browser** | navigate, back/fwd/reload, click/type/scroll, read | `# /mso-camoufox: go\|back\|reload\|click\|type\|key\|scroll\|content\|shot` || **Media Viewer** | view image/video/audio, download | `$OS cat`/copy → **Read** the image here; `$OS exec "ffprobe <f>"` for AV || **Media Studio** | layers/text/shapes/adjust/style canvas | `$IE …` (it's the image editor) — see [/mso-image-editor] || **Image Editor** | full editor-document CRUD + render | `$IE open\|new\|run\|inspect\|save\|view` · `$OS crud set <doc.json> <cmd>` |-| **Reel Editor** | timeline/clips/keyframes, render→.webm | asset prep `$OS exec "ffmpeg …"`; timeline + render = browser ([/os-browser]) |+| **Reel Editor** | timeline/clips/keyframes, render→.webm | asset prep `$OS exec "ffmpeg …"`; timeline + render = browser ([/mso-camoufox]) || **Settings** | devices, AI key (BYOK), server mock/live, theme | `node ~/projects/mso/scripts/approve-device.js <id>`; key → `~/.mso/config.json`; theme/server = UI || **Assistant (Alfa)** | streaming chat + editor tool-calling | `POST /api/assistant` (needs BYOK key); for editing prefer deterministic `$IE`/`crud` || **App Store / Create-App** | install/uninstall, runtime apps | built-ins = `shell.manifest.ts` (+redeploy); runtime cmd app == `$OS exec`; install = UI |diff --git a/claude-skills/mso-browser-list/SKILL.md b/claude-skills/mso-browser-list/SKILL.mddeleted file mode 100644index 507b21f3..00000000--- a/claude-skills/mso-browser-list/SKILL.md+++ /dev/null@@ -1,87 +0,0 @@-----name: mso-browser-list-description: The RETIRED os-browser Playwright sidecar, kept only as dev tooling for e2e/desktop verification — its systemd unit is stopped and disabled, and the mso Browser app does NOT use it. For the actual Browser app use /mso-camoufox. Trigger on /mso-browser-list, "os-browser sidecar", "playwright install for e2e", "start the headless chromium service". Do NOT trigger on "why doesn't the browser work" or "browser status" — those mean Camoufox.------# /mso-browser-list — os-browser sidecar deep check--> ## ⚠️ This is NOT the Browser app any more->-> The **Browser app is Camoufox** — a real anti-fingerprinting Firefox on a headless-> X display, streamed in over noVNC. Use **[/mso-camoufox]** for it.->-> The `os-browser` Playwright sidecar described below was **retired**, and on-> **2026-08-03 its systemd unit was stopped and `disable`d** — it no longer starts at-> boot and nothing in the mso app calls it (the only remaining mentions in the code-> are comments saying it was removed). Do **not** `systemctl restart os-browser` to-> "fix the Browser"; that starts a service the app does not use.->-> The `os-browser/` directory stays in the repo on purpose as **dev tooling** — it-> holds the repo's only Playwright install, which `scripts/e2e` and desktop/mobile-> verification use. This skill is still valid for driving THAT, if you start the-> service by hand (`sudo systemctl start os-browser`). It is not a user-facing feature.--The sidecar is a **real headless Chromium** (Playwright) on the host as systemd-`os-browser` (loopback :4002, persistent context = cookies/cache/session on disk).-Renders ANY site — no X-Frame-Options/CSP problem. Companion to [/mso] and [/mso-list].--## 1. Live check (run first)--```bash-node ~/.claude/skills/mso-browser-list/browser-check.js-```-Navigates several sites via the service and reports title + screenshot bytes +-text length. If the service is DOWN that is now the DEFAULT (see the banner) — `sudo systemctl start os-browser` to run these checks, and stop it again after.--## 2. Drive it from CLI--`~/.claude/skills/mso/browser.sh` still exists, but it talks to `/api/v1/browser/*`,-and **those routes were deleted with the sidecar** — `app/api/v1/` today is-`apps camoufox editor exec fs managed-apps stock sys term`. So the CLI path below is-DEAD until/unless someone re-adds the routes. Talk to the service directly instead:--```bash-sudo systemctl start os-browser # it is disabled; start by hand-curl -s -H "x-os-browser-secret: $(grep -oP '(?<=^OS_BROWSER_SECRET=).*' \- /home/rahman/projects/mso/os-browser/.env)" \- -X POST 127.0.0.1:4002/goto -d '{"url":"https://example.com"}'-sudo systemctl stop os-browser # leave it off-```--## 3. What still works, and what does not--| | Status |-|---|---|-| The service itself (Playwright Chromium, loopback :4002, secret-gated) | works when started by hand |-| `os-browser/node_modules/playwright` — the repo's ONLY Playwright | works; this is why the dir is kept |-| `scripts/e2e` + desktop/mobile verification | works (uses the Playwright install, not the service) |-| mso Browser app rendering through it | **gone** — the app is Camoufox now |-| `/api/v1/browser/*` routes | **deleted** |-| `OS_BROWSER_URL` / `OS_BROWSER_SECRET` wired into the app | **gone** — the only mention left in app code is a comment in `lib/agent/server.ts` saying it was retired |-| Bookmarks / AI Inspector / omnibar for it | **gone** with the app integration |--## 4. Architecture (what is left)--```-you ──secret──▶ 127.0.0.1:4002 (systemd os-browser, DISABLED — start by hand)- └ Playwright Chromium, one persistent context-```-Service secret: `/home/rahman/projects/mso/os-browser/.env`.-Code: `/home/rahman/projects/mso/os-browser/server.mjs`.-Prod is **systemd on this box, not Dokploy** — ignore any `172.18.0.1` /-docker-bridge address in older notes; that was the Dokploy era.--## 5. Known limits--- One shared page (single context) — no multi-tab.-- Chromium only. It is exactly what could NOT render sites that block automation,- which is why the Browser app moved to Camoufox.--## 6. If something is "broken"--1. **Is this even the right skill?** If the user means the Browser app in mso, it is- Camoufox → use [/mso-camoufox]. This skill cannot help with that.-2. Service not running → expected, it is `disable`d. `sudo systemctl start os-browser`- for a one-off. **Never `enable` it** — that re-arms boot autostart.-3. e2e/Playwright failing → check `os-browser/node_modules/playwright` exists; the- service does not need to be running for that.diff --git a/claude-skills/mso-browser-list/browser-check.js b/claude-skills/mso-browser-list/browser-check.jsdeleted file mode 100644index 6d09fe90..00000000--- a/claude-skills/mso-browser-list/browser-check.js+++ /dev/null@@ -1,39 +0,0 @@-// os-browser-list — checks the REAL browser service (Playwright Chromium, systemd-// os-browser). Navigates several sites and reports title + screenshot bytes +-// content length, proving any site renders (no X-Frame-Options problem). Runs on-// the host (loopback). Usage: node ~/.claude/skills/mso-browser-list/browser-check.js-const fs = require("fs");--const ENVF = process.env.OS_BROWSER_ENV || "/home/rahman/projects/os-browser/.env";-const BASE = process.env.OS_BROWSER_BASE || "http://127.0.0.1:4002";-let SECRET = process.env.OS_BROWSER_SECRET || "";-try {- if (!SECRET) {- const m = fs.readFileSync(ENVF, "utf8").match(/^OS_BROWSER_SECRET=(.+)$/m);- if (m) SECRET = m[1].trim();- }-} catch {}-const H = { "x-os-browser-secret": SECRET, "content-type": "application/json" };--const SITES = ["https://example.com", "https://news.ycombinator.com", "https://www.google.com", "https://github.com"];--(async () => {- try {- const h = await fetch(`${BASE}/health`).then((r) => r.json());- console.log(`os-browser service: ${h.ok ? "UP" : "DOWN"} @ ${BASE}\n`);- } catch (e) {- console.log(`os-browser DOWN @ ${BASE}: ${e.message}\n(sudo systemctl status os-browser)`);- process.exit(1);- }- for (const url of SITES) {- try {- const nav = await fetch(`${BASE}/navigate`, { method: "POST", headers: H, body: JSON.stringify({ url }) }).then((r) => r.json());- const png = await fetch(`${BASE}/screenshot`, { headers: H }).then((r) => r.arrayBuffer());- const c = await fetch(`${BASE}/content`, { headers: H }).then((r) => r.json());- console.log(`OK "${(nav.title || "").slice(0, 30)}" shot=${png.byteLength}b text=${(c.text || "").length} ${url}`);- } catch (e) {- console.log(`ERR ${url} ${e.message}`);- }- }- console.log("\nNOTE: this service is RETIRED and its unit is disabled. The mso Browser app is Camoufox (/mso-camoufox); /api/v1/browser/* no longer exists. This dir is kept for its Playwright install, used by scripts/e2e.");-})();diff --git a/claude-skills/mso-camoufox/SKILL.md b/claude-skills/mso-camoufox/SKILL.mdindex 0eebb936..651af8ed 100644--- a/claude-skills/mso-camoufox/SKILL.md+++ b/claude-skills/mso-camoufox/SKILL.md@@ -11,7 +11,7 @@ you *watch and click*, not a headless scraper. Use it when a site blocks the plaheadless browser (Cloudflare, DataDome, LinkedIn, anything that fingerprints).**Camoufox IS the Browser app.** It replaced both the Playwright sidecar-(`os-browser`, `:4002` — retired, kept only as dev tooling for `scripts/e2e`) and the+(`os-browser`, `:4002` — deleted 2026-08-10) and thesandboxed-iframe browser that briefly followed it, because X-Frame-Options makes aniframe unable to render most of the real web.@@ -107,7 +107,6 @@ profile in and out — the anti-detection value comes from a profile that looks## Related- `/mso` — the CLI and everything else on the host-- `/mso-browser-list` — the retired Playwright sidecar (`:4002`), still used by`scripts/e2e` for screenshots- `skills/camoufox-browse` (bundled in MSO's own catalog) — the scripting-levelCamoufox skill for the in-app assistant, from ClawHubdiff --git a/claude-skills/mso-image-editor/image-editor.sh b/claude-skills/mso-image-editor/image-editor.shindex 8e9ada3b..9fe03dd0 100755--- a/claude-skills/mso-image-editor/image-editor.sh+++ b/claude-skills/mso-image-editor/image-editor.sh@@ -122,11 +122,13 @@ case "$cmd" incase "$p" in /*) ;; *) p="/$p" ;; esacurl="$base/studio$p"; echo "$url"if [ "${1:-}" = "--shot" ]; then- out="${2:-/tmp/studio-view.png}"- BR="${OS_BROWSER_SH:-/home/rahman/.claude/skills/mso/browser.sh}"- "$BR" go "$url" >/dev/null 2>&1; sleep 7; "$BR" shot "$out" # needs a logged-in browser+ # The os-browser sidecar that backed this was deleted 2026-08-10 (its unit+ # had been stopped + disabled for months). Use /mso-camoufox, which drives a+ # real logged-in Firefox on the host.+ echo "--shot needs a logged-in browser: run /mso-camoufox, open the URL above, screenshot there." >&2+ exit 2else- echo "# open that URL (logged-in browser) — Konva renders the doc; add --shot [out.png] to auto-screenshot"+ echo "# open that URL (logged-in browser) — Konva renders the doc"fi ;;*) sed -n '2,20p' "$0" ;;esacdiff --git a/claude-skills/mso-list/SKILL.md b/claude-skills/mso-list/SKILL.mdindex e8cba72b..4bc92790 100644--- a/claude-skills/mso-list/SKILL.md+++ b/claude-skills/mso-list/SKILL.md@@ -7,7 +7,7 @@ description: List every mso app + its functions and check they actually work endEnumerate every mso app, its user-facing functions / AI-Inspector actions, andverify the backing calls work against the live host. Pairs with [/mso] (control)-and [/mso-browser-list] (browser deep-dive).+and [/mso-camoufox] (browser deep-dive).## 1. Live probe (run this first)@@ -27,7 +27,7 @@ from the repo). A function is "working" only if its endpoint returns 2xx here.| **files-manager** | navigate, breadcrumb/back/fwd, favorites (real roots), live tree, new folder/file, rename, move (drag), copy/cut/paste, trash*, upload, details | `fs.list/mkdir/write/move/copy/remove/usage` | trash to /.Trash fails on live (outside write root) || **code-editor** | live tree, open (fs.read), edit, save (fs.write), new file, tabs | `fs.read/write/list` | || **terminal** | ls/cat/cd (+13 builtins), mkdir/rm/mv/cp/touch (live fs), unknown cmd → host shell | `fs.*`, `exec.run` | live passthrough |-| **browser** | omnibar nav, back/fwd/reload, bookmarks, history, in-page link/form click-through | `/api/v1/proxy` | see [/mso-browser-list] |+| **browser** | omnibar nav, back/fwd/reload, bookmarks, history, in-page link/form click-through | `/api/v1/proxy` | see [/mso-camoufox] || **system-monitor** | gauges, sparklines, process table, refresh | `sys.stats/processes` | || **reel-editor** | timeline, clips, keyframes, render→.webm, Inspector "Render" | client canvas | render is client-side || **media-studio** | layers, tools, filters, export, Inspector add/export/undo | client | |@@ -46,6 +46,6 @@ from the repo). A function is "working" only if its endpoint returns 2xx here.**Live**. In Mock they use the in-browser sim. Token must be present.- **Trash on live**: `/.Trash` is outside the write root → move fails. Known gap.- **Browser in-page nav**: works via the injected click-through; heavy SPAs / login- flows still constrained — see [/mso-browser-list].+ flows still constrained — see [/mso-camoufox].Report = the probe table + which apps are fully green vs gated (AI key / live mode).diff --git a/claude-skills/mso/SKILL.md b/claude-skills/mso/SKILL.mdindex b20123df..498d692c 100644--- a/claude-skills/mso/SKILL.md+++ b/claude-skills/mso/SKILL.md@@ -76,23 +76,12 @@ All under `/api/v1`, gated by the signed session cookie (sent automatically).browse anywhere), `OS_FS_WRITE_ROOTS` (default home+projects). Logic in`mso/lib/host/`. Change → `sudo systemctl restart mso`.-## Real browser (Playwright, you can drive + see it)+## Real browser-Real headless Chromium runs as systemd `os-browser` (Playwright, loopback :4002,-secret in `/home/rahman/projects/mso/os-browser/.env`). ONE persistent context-(`~/.mso/chrome-profile`) → cookies/cache/session on disk, SHARED between the-Browser app and the CLI. Renders any site (no X-Frame-Options).--```bash-SH=/home/rahman/.claude/skills/mso/browser.sh-$SH go github.com # navigate (bare words → google search)-$SH shot /tmp/b.png # screenshot → Read it to SEE the page-$SH content # innerText-$SH click 640 380 ; $SH type "hello" ; $SH key Enter ; $SH scroll 600-$SH state ; $SH back ; $SH reload-```-Web OS reaches it via `/api/v1/browser/*` (cookie-auth → 127.0.0.1:4002).-Restart: `sudo systemctl restart os-browser`. Code: `mso/os-browser/server.mjs`.+Camoufox (anti-fingerprinting Firefox on a headless X display, streamed over+noVNC). See `/mso-camoufox`. The old `os-browser` Playwright sidecar and its+`browser.sh` driver were deleted 2026-08-10 — the unit had been stopped and+disabled for months and nothing in the app called it.## The web OS (mso)@@ -112,12 +101,12 @@ Restart: `sudo systemctl restart os-browser`. Code: `mso/os-browser/server.mjs`.(`next start` :4005). Editing + rebuilding the repo IS deploying.- **Deploy a change**: edit → `cd ~/projects/mso && pnpm typecheck && pnpm build`→ `sudo systemctl restart mso` → verify. `git push` is version-control only.-- **Status**: `mso exec "systemctl is-active mso os-browser"`; site 200 check.+- **Status**: `mso exec "systemctl is-active mso"`; site 200 check.- Audit everything: `node ~/.claude/skills/mso-list/audit.js` (13 endpoints).## Safety-- Restarting `mso` / `os-browser` is fine (task targets). Do NOT restart+- Restarting `mso` is fine (task target). Do NOT restart`vps-control-room-*` without warning the user — separate live product.- `exec` is full shell as `rahman`. Confirm destructive commands (rm -rf, servicechanges) with the user first.diff --git a/claude-skills/mso/browser.sh b/claude-skills/mso/browser.shdeleted file mode 100755index 6864a801..00000000--- a/claude-skills/mso/browser.sh+++ /dev/null@@ -1,40 +0,0 @@-#!/usr/bin/env bash-# browser.sh — drive the REAL headless browser (Playwright Chromium) the mso-# Browser app uses. Same persistent session/cache, so logged-in state is shared.-# Screenshots land in /tmp so they can be Read (viewed) directly.-#-# browser.sh go <url> navigate (bare words → google search)-# browser.sh shot [file] screenshot → /tmp/os-browser.png (or file); prints path-# browser.sh content page innerText (read what's on screen)-# browser.sh state current url + title-# browser.sh click <x> <y> click viewport px (1280x800)-# browser.sh type <text> type text-# browser.sh key <Key> press a key (Enter, Backspace, Tab, ArrowDown…)-# browser.sh scroll <dy> wheel by dy px-# browser.sh back|forward|reload-# browser.sh health-set -euo pipefail--ENVF="${OS_BROWSER_ENV:-/home/rahman/projects/mso/os-browser/.env}"-# shellcheck disable=SC1090-set -a; . "$ENVF" 2>/dev/null || true; set +a-SEC="${OS_BROWSER_SECRET:-}"-B="${OS_BROWSER_BASE:-http://127.0.0.1:4002}"-[ -n "$SEC" ] || { echo "no OS_BROWSER_SECRET in $ENVF" >&2; exit 1; }-H=(-H "x-os-browser-secret: $SEC")-J=(-H 'content-type: application/json')--cmd="${1:-help}"; shift || true-case "$cmd" in- go|navigate) curl -fsS "${H[@]}" "${J[@]}" -d "$(jq -n --arg u "${1:?url}" '{url:$u}')" "$B/navigate"; echo ;;- shot|screenshot) f="${1:-/tmp/os-browser.png}"; curl -fsS "${H[@]}" "$B/screenshot" -o "$f"; echo "saved $f ($(stat -c%s "$f") bytes) — Read it to view" ;;- content) curl -fsS "${H[@]}" "$B/content" ;;- state) curl -fsS "${H[@]}" "$B/state"; echo ;;- click) curl -fsS "${H[@]}" "${J[@]}" -d "$(jq -n --argjson x "${1:?x}" --argjson y "${2:?y}" '{x:$x,y:$y}')" "$B/click"; echo ;;- type) curl -fsS "${H[@]}" "${J[@]}" -d "$(jq -n --arg t "${*:?text}" '{text:$t}')" "$B/type"; echo ;;- key) curl -fsS "${H[@]}" "${J[@]}" -d "$(jq -n --arg k "${1:?key}" '{key:$k}')" "$B/key"; echo ;;- scroll) curl -fsS "${H[@]}" "${J[@]}" -d "$(jq -n --argjson d "${1:?dy}" '{dy:$d}')" "$B/scroll"; echo ;;- back|forward|reload) curl -fsS "${H[@]}" "${J[@]}" -d '{}' "$B/$cmd"; echo ;;- health) curl -fsS "$B/health"; echo ;;- *) sed -n '2,20p' "$0" ;;-esacdiff --git a/docs/INSTALL.md b/docs/INSTALL.mdindex 0408ca54..ddaf3e27 100644--- a/docs/INSTALL.md+++ b/docs/INSTALL.md@@ -173,30 +173,18 @@ TLS (certbot). Keep `proxy_set_header Host $host;` and forwardEither way: firewall :4005 (and :4002) so only the proxy / tailnet reaches them.-## 6. Optional — the remote Browser app (`os-browser/`)--A real headless Chromium on the VPS, driven by the Browser app. Skip it and-everything else still works.--```bash-cd os-browser-npm install # installs playwright-npx playwright install chromium --with-deps--# it refuses to start without a secret (≥16 chars):-OS_BROWSER_SECRET=$(openssl rand -hex 16) node server.mjs # listens on 127.0.0.1:4002-```--Then in the main app's `.env.local`:--```bash-OS_BROWSER_URL=http://127.0.0.1:4002-OS_BROWSER_SECRET=<the same secret>-```--Run it under systemd too (same pattern as step 4, `ExecStart=node server.mjs`,-plus `Environment=OS_BROWSER_SECRET=...`). **Keep it on loopback** — the-secret travels server-to-server only and must never be reachable publicly.+## 6. Optional — the Browser app (Camoufox)++The Browser app streams a real anti-fingerprinting Firefox from a headless X+display over noVNC, run by the `camoufox-vnc.service` systemd USER unit whose+ExecStart is `scripts/camoufox-vnc-service` in this repo. Skip it and everything+else still works. See CLAUDE.md for the host-side prerequisites (`enable-linger`,+the `XDG_RUNTIME_DIR` drop-in, and the VNC password file it refuses to start+without).++An earlier `os-browser/` Playwright sidecar on :4002 filled this role; it was+stopped, disabled, and finally deleted on 2026-08-10. Only its vendored+Playwright install remains, used by `scripts/gen-readme-media.mjs`.## 7. Optional — AI assistant (BYOK)diff --git a/frontend/slices/appshell/components/layout/app-chrome-mobile.tsx b/frontend/slices/appshell/components/layout/app-chrome-mobile.tsxindex 0a5e7a8c..786f19a0 100644--- a/frontend/slices/appshell/components/layout/app-chrome-mobile.tsx+++ b/frontend/slices/appshell/components/layout/app-chrome-mobile.tsx@@ -1,12 +1,12 @@"use client";-// The mobile Sheet/Drawer branches of app-chrome's SideRegion (radix Sheet +-// vaul Drawer). Lifted into its own async chunk so desktop never ships either-// package at first paint — loaded via next/dynamic from app-chrome.tsx only when-// a phone renders a sidebar/inspector. JSX moved verbatim (no visual change).+// The mobile Sheet branch of app-chrome's SideRegion. Lifted into its own async+// chunk so desktop never ships radix Sheet at first paint — loaded via+// next/dynamic from app-chrome.tsx only when a phone renders a sidebar.+// (A vaul bottom-drawer variant lived here too; its only route in was+// AppInspector, which no app ever mounted. Both deleted 2026-08-10.)import { type ReactNode } from "react";-import { Drawer as Vaul } from "vaul";import {Sheet,SheetContent,@@ -23,8 +23,6 @@ export function MobileSideRegion({description,sheetWidth,sheetClassName,- mobileVariant = "sheet",- mobileHeight = "h-[50dvh]",children,}: {open: boolean;@@ -34,32 +32,8 @@ export function MobileSideRegion({description?: string;sheetWidth: string;sheetClassName?: string;- mobileVariant?: "sheet" | "drawer";- mobileHeight?: string;children: ReactNode;}) {- if (mobileVariant === "drawer") {- // Non-modal, overlay-less bottom drawer → the live edit preview above stays- // visible and usable while the panel is open.- return (- <Vaul.Root open={open} onOpenChange={onOpenChange} direction="bottom" modal={false}>- <Vaul.Portal>- <Vaul.Content- className={cn(- "fixed inset-x-0 bottom-0 z-50 flex flex-col rounded-t-2xl border-t border-border bg-card shadow-2xl outline-none",- mobileHeight,- sheetClassName,- )}- >- <Vaul.Title className="sr-only">{title}</Vaul.Title>- <Vaul.Description className="sr-only">{description ?? title}</Vaul.Description>- <div className="mx-auto mt-2 h-1.5 w-10 shrink-0 rounded-full bg-muted" />- <div className="flex min-h-0 flex-1 flex-col overflow-y-auto">{children}</div>- </Vaul.Content>- </Vaul.Portal>- </Vaul.Root>- );- }return (<Sheet open={open} onOpenChange={onOpenChange}><SheetContent side={side} className={cn(sheetWidth, "p-0", sheetClassName)}>diff --git a/frontend/slices/appshell/components/layout/app-chrome.tsx b/frontend/slices/appshell/components/layout/app-chrome.tsxindex 5064b47c..e8a016f2 100644--- a/frontend/slices/appshell/components/layout/app-chrome.tsx+++ b/frontend/slices/appshell/components/layout/app-chrome.tsx@@ -1,8 +1,7 @@"use client";/**- * app-chrome — internal layout blocks (AppHeader, AppSidebar, AppInspector)- * composed by AppFrame.+ * app-chrome — the internal AppSidebar block composed by AppFrame.** Consumers: use AppFrame (appshell/primitives/app-frame.tsx) at the app slice* level. AppFrame supplies the @container scaffolding + safe-area padding +@@ -17,9 +16,8 @@ import dynamic from "next/dynamic";import { useIsMobile } from "../../responsive/use-is-mobile";import { cn } from "@/lib/utils";-// Mobile Sheet/Drawer chrome (radix Sheet + vaul Drawer) loads only on phones,-// in its own async chunk. Desktop renders the plain <aside> rail below and ships-// neither package at first paint.+// Mobile Sheet chrome (radix Sheet) loads only on phones, in its own async+// chunk. Desktop renders the plain <aside> rail below and never ships it.const MobileSideRegion = dynamic(() => import("./app-chrome-mobile").then((m) => m.MobileSideRegion),{ ssr: false, loading: () => null },@@ -27,32 +25,12 @@ const MobileSideRegion = dynamic(// Reusable app-window chrome so every app reads the same. All regions are// OPTIONAL — an app composes only what it needs.-// • Mobile (viewport < 768): Sidebar → left Sheet, Inspector → right Sheet.+// • Mobile (viewport < 768): Sidebar → left Sheet.// • Desktop: inline rail, shown unless `railOpen={false}` (a desktop collapse// toggle). Forms / previews use <FormDrawer> (dialog ⇄ bottom drawer).// Apps that toggle a panel on both form factors branch their handler with// `useIsMobile()` from the shell's responsive module.-// Standard top toolbar bar.-export function AppHeader({- className,- children,-}: {- className?: string;- children: ReactNode;-}) {- return (- <header- className={cn(- "flex h-11 shrink-0 items-center gap-2 border-b border-border px-2",- className,- )}- >- {children}- </header>- );-}-function SideRegion({open,onOpenChange,@@ -64,8 +42,6 @@ function SideRegion({railClassName,sheetWidth,sheetClassName,- mobileVariant = "sheet",- mobileHeight = "h-[50dvh]",children,}: {open: boolean;@@ -78,10 +54,6 @@ function SideRegion({railClassName?: string;sheetWidth: string;sheetClassName?: string;- /** Mobile presentation: side Sheet (default) or a non-modal bottom drawer- * that leaves the canvas/preview visible + interactive above it. */- mobileVariant?: "sheet" | "drawer";- mobileHeight?: string;children: ReactNode;}) {const isMobile = useIsMobile();@@ -95,8 +67,6 @@ function SideRegion({description={description}sheetWidth={sheetWidth}sheetClassName={sheetClassName}- mobileVariant={mobileVariant}- mobileHeight={mobileHeight}>{children}</MobileSideRegion>@@ -144,50 +114,3 @@ export function AppSidebar({</SideRegion>);}--// Right property/inspector. Inline rail on desktop (hide via railOpen); right-// Sheet on mobile. Use for details / properties / layers / settings panels.-export function AppInspector({- open,- onOpenChange,- railOpen = true,- title = "Details",- description,- railClassName,- sheetClassName,- mobile = "sheet",- mobileHeight,- children,-}: {- open: boolean;- onOpenChange: (open: boolean) => void;- railOpen?: boolean;- title?: string;- description?: string;- railClassName?: string;- sheetClassName?: string;- /** Mobile form: right Sheet (default) or a non-modal bottom drawer that keeps- * the canvas/preview visible above it (e.g. image editor). */- mobile?: "sheet" | "drawer";- mobileHeight?: string;- children: ReactNode;-}) {- return (- <SideRegion- open={open}- onOpenChange={onOpenChange}- side="right"- railOpen={railOpen}- title={title}- description={description}- railBase="flex w-64 shrink-0 flex-col border-l border-border bg-card/30"- railClassName={railClassName}- sheetWidth="w-80 sm:max-w-sm"- sheetClassName={sheetClassName}- mobileVariant={mobile}- mobileHeight={mobileHeight}- >- {children}- </SideRegion>- );-}diff --git a/frontend/slices/appshell/components/mobile-shell.tsx b/frontend/slices/appshell/components/mobile-shell.tsxindex 71f6ae2d..dc607ad7 100644--- a/frontend/slices/appshell/components/mobile-shell.tsx+++ b/frontend/slices/appshell/components/mobile-shell.tsx@@ -48,8 +48,7 @@ export function MobileShell() {// effect-driven setState (react-hooks/set-state-in-effect). Gated like// UrlSync (manifest.routing): opted out, the URL never names an app, so the// grid-first default + gesture overrides behave exactly as before.- const { routing } = useShellConfig();- const { home, setHome } = useUrlHome(apps, routing);+ const { home, setHome } = useUrlHome(apps);// The visible app is the FOCUSED window (front-most) — fall back to the newest// non-minimized one. `order` is append-only and doesn't track focus.diff --git a/frontend/slices/appshell/components/shells/android/android-shell.tsx b/frontend/slices/appshell/components/shells/android/android-shell.tsxindex beba08e4..eb93d0e3 100644--- a/frontend/slices/appshell/components/shells/android/android-shell.tsx+++ b/frontend/slices/appshell/components/shells/android/android-shell.tsx@@ -41,8 +41,7 @@ function AndroidShell() {// URL → surface (same derivation as the iOS shell): a pathname naming an app slug// shows the app pane (UrlSync opens/focuses its window); user gestures override,// keyed to the pathname made at — deep links AND back/forward, no effect setState.- const { routing } = useShellConfig();- const { home, setHome } = useUrlHome(apps, routing);+ const { home, setHome } = useUrlHome(apps);const dockable = useMemo(() => apps.filter((a) => !a.noDock), [apps]);const pinned = useMemo(() => dockable.filter((a) => a.pinned), [dockable]);diff --git a/frontend/slices/appshell/components/shells/dashboard/dashboard-shell.tsx b/frontend/slices/appshell/components/shells/dashboard/dashboard-shell.tsxindex 0e4ef5cc..2e90da08 100644--- a/frontend/slices/appshell/components/shells/dashboard/dashboard-shell.tsx+++ b/frontend/slices/appshell/components/shells/dashboard/dashboard-shell.tsx@@ -39,8 +39,7 @@ function DashboardShell() {// store), anything else shows Home. User gestures override, keyed to the// pathname they were made at, so the derivation wins again when the URL// actually changes — no effect-driven setState.- const { routing } = useShellConfig();- const { home, setHome } = useUrlHome(allApps, routing);+ const { home, setHome } = useUrlHome(allApps);// The pane shows the FOCUSED window — fall back to the newest non-minimized// one (`order` is append-only and doesn't track focus).diff --git a/frontend/slices/appshell/components/window.tsx b/frontend/slices/appshell/components/window.tsxindex 946192f0..19b70a28 100644--- a/frontend/slices/appshell/components/window.tsx+++ b/frontend/slices/appshell/components/window.tsx@@ -12,7 +12,6 @@ import {hasCloseGuard,snapRect,} from "../lib/store";-import { deliverDrop, dragCarriesPayload, readDragData } from "../lib/dnd";import { spaceOf, useActiveSpace } from "../lib/spaces";import { useGroupTop } from "../lib/window-tabs";import { TrafficLights } from "./traffic-lights";@@ -136,21 +135,7 @@ export const Window = memo(function Window({ id, variant = "macos" }: { id: WinI{win.groupId && <TabStrip groupId={win.groupId} activeId={id} />}- <div- className="relative min-h-0 flex-1 overflow-hidden bg-background [container-type:inline-size]"- // Cross-app DnD: shell payloads route to the app's drop handler;- // native drags (file uploads) pass through untouched.- onDragOver={(e) => {- if (dragCarriesPayload(e)) {- e.preventDefault();- e.dataTransfer.dropEffect = "copy";- }- }}- onDrop={(e) => {- const data = readDragData(e);- if (data && deliverDrop(win.app, data)) e.preventDefault();- }}- >+ <div className="relative min-h-0 flex-1 overflow-hidden bg-background [container-type:inline-size]"><WindowContent app={win.app} payload={win.payload} winId={id} /></div>diff --git a/frontend/slices/appshell/defaults.ts b/frontend/slices/appshell/defaults.tsindex 1a8e3668..b17155ed 100644--- a/frontend/slices/appshell/defaults.ts+++ b/frontend/slices/appshell/defaults.ts@@ -11,9 +11,7 @@ import { inspectorFeature } from "./features/inspector";import { notificationsFeature } from "./features/notifications";import { controlCenterFeature } from "./features/control-center";import { widgetsFeature } from "./features/widgets";-import { quickLookFeature } from "./features/quick-look";import { clipboardFeature } from "./features/clipboard";-import { shareFeature } from "./features/share";import { shortcutHelpFeature } from "./features/shortcut-help";import { lockScreenFeature } from "./features/lock-screen";@@ -22,9 +20,7 @@ export { inspectorFeature } from "./features/inspector";export { notificationsFeature } from "./features/notifications";export { controlCenterFeature } from "./features/control-center";export { widgetsFeature } from "./features/widgets";-export { quickLookFeature } from "./features/quick-look";export { clipboardFeature } from "./features/clipboard";-export { shareFeature } from "./features/share";export { shortcutHelpFeature } from "./features/shortcut-help";export { lockScreenFeature } from "./features/lock-screen";@@ -35,9 +31,7 @@ export { lockScreenFeature } from "./features/lock-screen";// from the array just doesn't mount).export const DEFAULT_FEATURES = [searchFeature,- quickLookFeature,clipboardFeature,- shareFeature,shortcutHelpFeature,lockScreenFeature,inspectorFeature,diff --git a/frontend/slices/appshell/features/quick-look/components/quick-look-overlay.tsx b/frontend/slices/appshell/features/quick-look/components/quick-look-overlay.tsxdeleted file mode 100644index 177c2126..00000000--- a/frontend/slices/appshell/features/quick-look/components/quick-look-overlay.tsx+++ /dev/null@@ -1,72 +0,0 @@-"use client";--import { useEffect } from "react";-import { X } from "lucide-react";-import { Button } from "@/components/ui/button";-import {- closeQuickLook,- inEditable,- previewerFor,- toggleQuickLook,- useQuickLook,-} from "@/features/appshell";--// Space toggles the preview for the published target (never while typing);-// Escape closes. Centered glass panel — previewer renders the body.-export function QuickLookOverlay() {- const { open, target } = useQuickLook();-- useEffect(() => {- const onKey = (e: KeyboardEvent) => {- if (e.key === " " && !inEditable() && target != null) {- e.preventDefault();- toggleQuickLook();- } else if (e.key === "Escape") {- closeQuickLook();- }- };- window.addEventListener("keydown", onKey);- return () => window.removeEventListener("keydown", onKey);- }, [target]);-- if (!open || target == null) return null;- const previewer = previewerFor(target);- const Body = previewer?.render;-- return (- <div- className="absolute inset-0 z-[var(--z-quick-look)] flex items-center justify-center bg-black/30"- onClick={closeQuickLook}- >- <div- className="glass relative flex max-h-[80vh] w-full max-w-2xl flex-col overflow-hidden rounded-2xl border border-border shadow-2xl"- onClick={(e) => e.stopPropagation()}- >- <header className="flex h-9 shrink-0 items-center border-b border-border px-3">- <span className="text-xs font-semibold text-muted-foreground">Quick Look</span>- <Button- type="button"- variant="ghost"- aria-label="Close"- onClick={closeQuickLook}- className="ml-auto h-auto rounded p-1 font-normal hover:bg-muted"- >- <X className="size-3.5" />- </Button>- </header>- <div className="min-h-0 flex-1 overflow-auto bg-background/80 [container-type:inline-size]">- {Body ? <Body target={target} /> : <FallbackPreview target={target} />}- </div>- </div>- </div>- );-}--// No previewer claimed it — readable dump beats a dead overlay.-function FallbackPreview({ target }: { target: unknown }) {- return (- <pre className="overflow-auto p-4 text-xs text-muted-foreground">- {typeof target === "string" ? target : JSON.stringify(target, null, 2)}- </pre>- );-}diff --git a/frontend/slices/appshell/features/quick-look/index.ts b/frontend/slices/appshell/features/quick-look/index.tsdeleted file mode 100644index 424c6098..00000000--- a/frontend/slices/appshell/features/quick-look/index.ts+++ /dev/null@@ -1,9 +0,0 @@-import { defineFeature } from "@/features/appshell";-import { QuickLookOverlay } from "./components/quick-look-overlay";--// Quick Look — Space-bar preview overlay over the previewer registry-// (lib/quick-look). Apps publish a target; previewers claim it.-export const quickLookFeature = defineFeature({- id: "quick-look",- slots: { overlay: QuickLookOverlay },-});diff --git a/frontend/slices/appshell/features/share/components/share-sheet.tsx b/frontend/slices/appshell/features/share/components/share-sheet.tsxdeleted file mode 100644index a9d3a856..00000000--- a/frontend/slices/appshell/features/share/components/share-sheet.tsx+++ /dev/null@@ -1,82 +0,0 @@-"use client";--import { useEffect, useState } from "react";-import { Share2 } from "lucide-react";-import { cn } from "@/lib/utils";-import { Button } from "@/components/ui/button";-import { closeShare, targetsFor, useShareState, type ShareTarget } from "@/features/appshell";--// Share sheet — bottom-center card (iOS-flavored, works on every shell).-// The panel MOUNTS per open (and unmounts on close), so selection state starts-// fresh every time without an effect-driven reset (react-hooks v6).-export function ShareSheet() {- const { open, payload } = useShareState();- return open ? <ShareSheetPanel payload={payload} /> : null;-}--function ShareSheetPanel({ payload }: { payload: unknown }) {- const [sel, setSel] = useState(0);- const list = targetsFor(payload);-- useEffect(() => {- const onKey = (e: KeyboardEvent) => {- if (e.key === "Escape") closeShare();- else if (e.key === "ArrowDown") {- e.preventDefault();- setSel((s) => (s + 1) % Math.max(1, list.length));- } else if (e.key === "ArrowUp") {- e.preventDefault();- setSel((s) => (s - 1 + list.length) % Math.max(1, list.length));- } else if (e.key === "Enter") {- e.preventDefault();- const t = list[sel];- if (t) runTarget(t, payload);- }- };- // Defer the attach one frame: the keydown that OPENED the sheet (palette- // Enter) is still bubbling and must not immediately run the first target.- let attached = false;- const raf = requestAnimationFrame(() => {- attached = true;- window.addEventListener("keydown", onKey);- });- return () => {- cancelAnimationFrame(raf);- if (attached) window.removeEventListener("keydown", onKey);- };- }, [list, sel, payload]);-- return (- <div className="absolute inset-0 z-[var(--z-share)] flex items-end justify-center bg-black/25 pb-[12vh]" onClick={closeShare}>- <div className="glass w-full max-w-sm overflow-hidden rounded-2xl border border-border shadow-2xl" onClick={(e) => e.stopPropagation()}>- <header className="flex items-center gap-2 border-b border-border px-4 py-2.5">- <Share2 className="size-3.5 text-muted-foreground" />- <span className="text-xs font-semibold text-muted-foreground">Share</span>- </header>- <ul className="p-2">- {list.map((t, i) => (- <li key={t.id}>- <Button- type="button"- variant="ghost"- onMouseMove={() => setSel(i)}- onClick={() => runTarget(t, payload)}- className={cn(- "h-auto w-full justify-start rounded-lg px-3 py-2 text-sm font-normal hover:bg-transparent",- i === sel ? "bg-primary/15" : "",- )}- >- {t.label}- </Button>- </li>- ))}- </ul>- </div>- </div>- );-}--function runTarget(t: ShareTarget, payload: unknown) {- closeShare();- void t.run(payload);-}diff --git a/frontend/slices/appshell/features/share/index.ts b/frontend/slices/appshell/features/share/index.tsdeleted file mode 100644index 3e3d6e8f..00000000--- a/frontend/slices/appshell/features/share/index.ts+++ /dev/null@@ -1,9 +0,0 @@-import { defineFeature } from "@/features/appshell";-import { ShareSheet } from "./components/share-sheet";--// Share sheet — overlay listing every registered target that claims the-// shared payload (lib/share). Keyboard-first: arrows + Enter + Escape.-export const shareFeature = defineFeature({- id: "share",- slots: { overlay: ShareSheet },-});diff --git a/frontend/slices/appshell/hooks/use-url-home.ts b/frontend/slices/appshell/hooks/use-url-home.tsindex 43cf7826..57b81d3a 100644--- a/frontend/slices/appshell/hooks/use-url-home.ts+++ b/frontend/slices/appshell/hooks/use-url-home.ts@@ -8,14 +8,11 @@ import type { AppDescriptor } from "../lib/types";// Dashboard shells. A pathname naming an app slug shows that app's pane (UrlSync// opens/focuses its window in the store); user gestures override, keyed to the// pathname they were made at, so the derivation wins again when the URL actually-// changes — no effect-driven setState (react-hooks/set-state-in-effect). Gated-// on manifest.routing: opted out, the URL never names an app and Home stays the-// default with gesture overrides intact.-export function useUrlHome(apps: AppDescriptor[], routing?: boolean) {+// changes — no effect-driven setState (react-hooks/set-state-in-effect).+export function useUrlHome(apps: AppDescriptor[]) {const pathname = usePathname();const urlSlug = pathname.split("/").filter(Boolean)[0];- const urlIsApp =- routing !== false && !!urlSlug && apps.some((a) => (a.slug ?? a.id) === urlSlug);+ const urlIsApp = !!urlSlug && apps.some((a) => (a.slug ?? a.id) === urlSlug);const [homeChoice, setHomeChoice] = useState<{ key: string; home: boolean } | null>(null);const home = homeChoice?.key === pathname ? homeChoice.home : !urlIsApp;const setHome = useCallback(diff --git a/frontend/slices/appshell/index.ts b/frontend/slices/appshell/index.tsindex 3dd5583a..a7d7db27 100644--- a/frontend/slices/appshell/index.ts+++ b/frontend/slices/appshell/index.ts@@ -49,7 +49,7 @@ export {// Reusable app-window chrome (all regions optional) + form/preview drawer, so// every app reads consistently: Sidebar→left Sheet, Inspector→right Sheet on// narrow containers; <FormDrawer> = dialog on desktop ⇄ bottom drawer on mobile.-export { AppHeader, AppSidebar, AppInspector } from "./components/layout/app-chrome";+export { AppSidebar } from "./components/layout/app-chrome";export {ResponsiveDialog,ResponsiveDialog as FormDrawer,@@ -71,7 +71,7 @@ export type {} from "./lib/host-api";// F1–F20 window-manager + productivity libs (each module exports its own// public surface — commands/badges/layouts/recents/window-commands/window-title/-// spaces/window-tabs/clipboard/share/lock/profiles/shortcuts/focus-mode/dnd/quick-look).+// spaces/window-tabs/clipboard/lock/profiles/shortcuts/focus-mode).export * from "./lib/commands";export * from "./lib/badges";export * from "./lib/recents";@@ -82,13 +82,10 @@ export * from "./lib/window-title";export * from "./lib/spaces";export * from "./lib/window-tabs";export * from "./lib/clipboard";-export * from "./lib/share";export * from "./lib/lock";export * from "./lib/profiles";export * from "./lib/shortcuts";export * from "./lib/focus-mode";-export * from "./lib/dnd";-export * from "./lib/quick-look";export {useFocusedHotkey,inEditable,diff --git a/frontend/slices/appshell/lib/dnd.test.ts b/frontend/slices/appshell/lib/dnd.test.tsdeleted file mode 100644index 77295d30..00000000--- a/frontend/slices/appshell/lib/dnd.test.ts+++ /dev/null@@ -1,34 +0,0 @@-import { describe, expect, it, vi } from "vitest";-import { appAccepts, deliverDrop, registerDropHandler } from "./dnd";--describe("cross-app dnd", () => {- it("routes payloads to the first accepting handler, newest first", () => {- const oldH = vi.fn();- const newH = vi.fn();- const offOld = registerDropHandler("files", { accepts: (d) => d.kind === "path", onDrop: oldH });- const offNew = registerDropHandler("files", { accepts: (d) => d.kind === "path", onDrop: newH });-- expect(appAccepts("files", { kind: "path" })).toBe(true);- expect(deliverDrop("files", { kind: "path", path: "~" })).toBe(true);- expect(newH).toHaveBeenCalledOnce();- expect(oldH).not.toHaveBeenCalled();-- offNew();- deliverDrop("files", { kind: "path" });- expect(oldH).toHaveBeenCalledOnce();- offOld();- });-- it("returns false when nothing claims the payload (throw-safe)", () => {- const off = registerDropHandler("docs", {- accepts: () => {- throw new Error("boom");- },- onDrop: () => {},- });- expect(appAccepts("docs", { kind: "x" })).toBe(false);- expect(deliverDrop("docs", { kind: "x" })).toBe(false);- expect(deliverDrop("unknown-app", { kind: "x" })).toBe(false);- off();- });-});diff --git a/frontend/slices/appshell/lib/dnd.ts b/frontend/slices/appshell/lib/dnd.tsdeleted file mode 100644index 7e390395..00000000--- a/frontend/slices/appshell/lib/dnd.ts+++ /dev/null@@ -1,70 +0,0 @@-"use client";--// Cross-app drag & drop seam — the RECEIVING half only. Every window's content-// area is a drop target that routes a typed payload to the target app's-// registered drop handler. Payloads ride a custom mime so native browser drags-// (file uploads) keep working untouched.-//-// There is deliberately no producer helper here. One existed (makeDragProps) with-// zero callers, so nothing in the app ever wrote DND_MIME and this whole path was-// unreachable outside tests and the ?e2e=1 dev command — files-manager's own drag-// writes "text/plain" instead. To actually light this up, have a real drag source-// set DND_MIME; until then the read half is dormant by design, not by accident.--export const DND_MIME = "application/x-shell-payload";--export type DragData = { kind: string } & Record<string, unknown>;--type DropHandler = {- accepts: (data: DragData) => boolean;- onDrop: (data: DragData) => void;-};--const handlers = new Map<string, DropHandler[]>();--/** Register a drop handler for an app. Returns an unregister fn. */-export function registerDropHandler(appId: string, h: DropHandler): () => void {- handlers.set(appId, [h, ...(handlers.get(appId) ?? [])]);- return () => {- handlers.set(appId, (handlers.get(appId) ?? []).filter((x) => x !== h));- };-}--function handlerFor(appId: string, data: DragData): DropHandler | undefined {- return (handlers.get(appId) ?? []).find((h) => {- try {- return h.accepts(data);- } catch {- return false;- }- });-}--export function appAccepts(appId: string, data: DragData): boolean {- return !!handlerFor(appId, data);-}--/** Route a payload to an app's drop handler. Returns false when none claims it. */-export function deliverDrop(appId: string, data: DragData): boolean {- const h = handlerFor(appId, data);- if (!h) return false;- h.onDrop(data);- return true;-}--/** Parse a shell payload off a drag event (null for native/file drags). */-export function readDragData(e: React.DragEvent): DragData | null {- try {- const raw = e.dataTransfer.getData(DND_MIME);- if (!raw) return null;- const v = JSON.parse(raw) as DragData;- return v && typeof v.kind === "string" ? v : null;- } catch {- return null;- }-}--/** True while the drag carries a shell payload (dragover can't read data). */-export function dragCarriesPayload(e: React.DragEvent): boolean {- return Array.from(e.dataTransfer.types).includes(DND_MIME);-}diff --git a/frontend/slices/appshell/lib/quick-look.test.ts b/frontend/slices/appshell/lib/quick-look.test.tsdeleted file mode 100644index bf770b0d..00000000--- a/frontend/slices/appshell/lib/quick-look.test.ts+++ /dev/null@@ -1,49 +0,0 @@-import { describe, expect, it } from "vitest";-import {- closeQuickLook,- openQuickLook,- previewerFor,- registerPreviewer,- setQuickLookTarget,- toggleQuickLook,- useQuickLook,-} from "./quick-look";--const renderStub = () => null;--describe("quick look", () => {- it("newest previewer wins; unregister restores the older one", () => {- const offA = registerPreviewer({ id: "a", canPreview: (t) => typeof t === "string", render: renderStub });- const offB = registerPreviewer({ id: "b", canPreview: (t) => typeof t === "string", render: renderStub });- expect(previewerFor("x")?.id).toBe("b");- offB();- expect(previewerFor("x")?.id).toBe("a");- offA();- expect(previewerFor("x")).toBeUndefined();- });-- it("open requires a target; clearing the target closes", () => {- closeQuickLook();- setQuickLookTarget(null);- toggleQuickLook(); // no target → stays closed- openQuickLook(); // still nothing- setQuickLookTarget({ name: "f" });- openQuickLook();- setQuickLookTarget(null); // selection went away → overlay must close- // state is internal; verify via the snapshot getter used by the hook- expect(useQuickLook).toBeTypeOf("function");- openQuickLook(); // no target again → still closed (no throw)- });-- it("a throwing canPreview never breaks resolution", () => {- const off = registerPreviewer({- id: "boom",- canPreview: () => {- throw new Error("boom");- },- render: renderStub,- });- expect(previewerFor("x")).toBeUndefined();- off();- });-});diff --git a/frontend/slices/appshell/lib/quick-look.ts b/frontend/slices/appshell/lib/quick-look.tsdeleted file mode 100644index 1f5d4866..00000000--- a/frontend/slices/appshell/lib/quick-look.ts+++ /dev/null@@ -1,77 +0,0 @@-"use client";--import { useSyncExternalStore, type ComponentType } from "react";--// Quick Look — a lightweight preview overlay with a PREVIEWER REGISTRY.-// Apps publish a target (their current selection) via setQuickLookTarget;-// Space (or openQuickLook) shows the first registered previewer that claims-// it. Consumer-registered previewers outrank built-ins (searched newest-first).--export type QuickLookPreviewer = {- id: string;- canPreview: (target: unknown) => boolean;- render: ComponentType<{ target: unknown }>;-};--let previewers: QuickLookPreviewer[] = [];--/** Register a previewer (newest wins on overlap). Returns an unregister fn. */-export function registerPreviewer(p: QuickLookPreviewer): () => void {- previewers = [p, ...previewers.filter((x) => x.id !== p.id)];- return () => {- previewers = previewers.filter((x) => x !== p);- };-}--export function previewerFor(target: unknown): QuickLookPreviewer | undefined {- return previewers.find((p) => {- try {- return p.canPreview(target);- } catch {- return false;- }- });-}--type QuickLookState = { open: boolean; target: unknown };--let state: QuickLookState = { open: false, target: null };-const subs = new Set<() => void>();--function set(next: QuickLookState) {- state = next;- subs.forEach((f) => f());-}--/** Apps publish their current selection here (null when it goes away). */-export function setQuickLookTarget(target: unknown): void {- set({ target, open: target == null ? false : state.open });-}--export function openQuickLook(target?: unknown): void {- const t = target === undefined ? state.target : target;- if (t == null) return;- set({ open: true, target: t });-}--export function closeQuickLook(): void {- if (state.open) set({ ...state, open: false });-}--export function toggleQuickLook(): void {- if (state.open) closeQuickLook();- else openQuickLook();-}--export function useQuickLook(): QuickLookState {- return useSyncExternalStore(- (cb) => {- subs.add(cb);- return () => {- subs.delete(cb);- };- },- () => state,- () => state,- );-}diff --git a/frontend/slices/appshell/lib/share.test.ts b/frontend/slices/appshell/lib/share.test.tsdeleted file mode 100644index fead586d..00000000--- a/frontend/slices/appshell/lib/share.test.ts+++ /dev/null@@ -1,28 +0,0 @@-import { describe, expect, it } from "vitest";-import { registerShareTarget, share, targetsFor } from "./share";--describe("share targets", () => {- it("ships generic built-ins for any payload", () => {- const ids = targetsFor({ a: 1 }).map((t) => t.id);- expect(ids).toContain("copy-text");- expect(ids).toContain("download-file");- });-- it("consumer targets rank first and filter by canShare", () => {- const off = registerShareTarget({- id: "notion",- label: "Send to Notion",- canShare: (p) => typeof p === "object",- run: () => {},- });- expect(targetsFor({}).map((t) => t.id)[0]).toBe("notion");- expect(targetsFor("text").map((t) => t.id)).not.toContain("notion");- off();- expect(targetsFor({}).map((t) => t.id)).not.toContain("notion");- });-- it("share() refuses payloads nothing can take", () => {- expect(share(null)).toBe(false);- expect(share("ok")).toBe(true);- });-});diff --git a/frontend/slices/appshell/lib/share.ts b/frontend/slices/appshell/lib/share.tsdeleted file mode 100644index ae66193a..00000000--- a/frontend/slices/appshell/lib/share.ts+++ /dev/null@@ -1,96 +0,0 @@-"use client";--import { useSyncExternalStore } from "react";-import { copyClip } from "./clipboard";--// Share sheet — a TARGET REGISTRY: apps call share(payload); every registered-// target that claims the payload shows up in the sheet (bundled share feature).-// Consumers add targets (send to an app, publish, export…); two generic ones-// ship built-in: copy-as-text and download-as-file.--export type ShareTarget = {- id: string;- label: string;- canShare: (payload: unknown) => boolean;- run: (payload: unknown) => void | Promise<void>;-};--let targets: ShareTarget[] = [];--/** Register a share target (newest first). Returns an unregister fn. */-export function registerShareTarget(t: ShareTarget): () => void {- targets = [t, ...targets.filter((x) => x.id !== t.id)];- return () => {- targets = targets.filter((x) => x !== t);- };-}--export function targetsFor(payload: unknown): ShareTarget[] {- return targets.filter((t) => {- try {- return t.canShare(payload);- } catch {- return false;- }- });-}--type ShareState = { open: boolean; payload: unknown };-let state: ShareState = { open: false, payload: null };-const subs = new Set<() => void>();--function set(next: ShareState) {- state = next;- subs.forEach((f) => f());-}--/** Open the share sheet for a payload (no-op when nothing can take it). */-export function share(payload: unknown): boolean {- if (targetsFor(payload).length === 0) return false;- set({ open: true, payload });- return true;-}--export function closeShare(): void {- if (state.open) set({ ...state, open: false });-}--export function useShareState(): ShareState {- return useSyncExternalStore(- (cb) => {- subs.add(cb);- return () => {- subs.delete(cb);- };- },- () => state,- () => state,- );-}--// ── built-in generic targets ────────────────────────────────────────────────-function asText(payload: unknown): string {- return typeof payload === "string" ? payload : JSON.stringify(payload, null, 2);-}--registerShareTarget({- id: "download-file",- label: "Download as file",- canShare: (p) => p != null,- run: (p) => {- const blob = new Blob([asText(p)], { type: "text/plain" });- const url = URL.createObjectURL(blob);- const a = document.createElement("a");- a.href = url;- a.download = "shared.txt";- a.click();- URL.revokeObjectURL(url);- },-});--registerShareTarget({- id: "copy-text",- label: "Copy as text",- canShare: (p) => p != null,- run: (p) => copyClip(asText(p)), // lands in clipboard + history, with its own toast-});diff --git a/frontend/slices/appshell/lib/shortcuts.ts b/frontend/slices/appshell/lib/shortcuts.tsindex cf52b0d3..0f49201d 100644--- a/frontend/slices/appshell/lib/shortcuts.ts+++ b/frontend/slices/appshell/lib/shortcuts.ts@@ -69,7 +69,6 @@ registerShortcuts("appshell", [{ keys: "⌘I", label: "AI Inspector", group: "System" },{ keys: "⌘/", label: "Keyboard shortcuts", group: "System" },{ keys: "⌘⇧V", label: "Clipboard history", group: "System" },- { keys: "Space", label: "Quick Look (selected item)", group: "System" },{ keys: "⌘Tab", label: "App switcher", group: "Windows" },{ keys: "F3", label: "Mission Control", group: "Windows" },{ keys: "⌘←/→", label: "Snap window left / right", group: "Windows" },diff --git a/frontend/slices/appshell/lib/window-title.test.ts b/frontend/slices/appshell/lib/window-title.test.tsindex 17a24656..60f12fcb 100644--- a/frontend/slices/appshell/lib/window-title.test.ts+++ b/frontend/slices/appshell/lib/window-title.test.ts@@ -8,7 +8,7 @@ vi.stubGlobal("document", { title: "Base Title" });describe("window-title sync", () => {beforeEach(() => {closeAll();- configureWindowTitle({ suffix: "Brand", enabled: true });+ configureWindowTitle({ suffix: "Brand" });startWindowTitleSync();});@@ -25,13 +25,6 @@ describe("window-title sync", () => {expect(document.title).toBe("Base Title");});- it("opt-out freezes the title", () => {- configureWindowTitle({ enabled: false });- openWindow("files", "Files");- expect(document.title).toBe("Base Title");- configureWindowTitle({ enabled: true }); // restore for other tests- });-it("skips the suffix when the window title IS the brand", () => {openWindow("home", "Brand");expect(document.title).toBe("Brand");diff --git a/frontend/slices/appshell/lib/window-title.ts b/frontend/slices/appshell/lib/window-title.tsindex dd40b64f..274f05e2 100644--- a/frontend/slices/appshell/lib/window-title.ts+++ b/frontend/slices/appshell/lib/window-title.ts@@ -9,12 +9,11 @@ import { shellStore } from "./store-state";// whenever nothing is focused.let suffix = "";-let enabled = true;let base: string | null = null;let started = false;function apply() {- if (!enabled || typeof document === "undefined") return;+ if (typeof document === "undefined") return;if (base === null) base = document.title;const id = shellStore.getFocused();const win = id ? shellStore.getWindow(id) : undefined;@@ -25,9 +24,8 @@ function apply() {document.title = suffix && win.title !== suffix ? `${win.title} — ${suffix}` : win.title;}-export function configureWindowTitle(opts: { suffix?: string; enabled?: boolean }) {+export function configureWindowTitle(opts: { suffix?: string }) {if (opts.suffix !== undefined) suffix = opts.suffix;- if (opts.enabled !== undefined) enabled = opts.enabled;apply();}diff --git a/frontend/slices/appshell/provider/app-shell.tsx b/frontend/slices/appshell/provider/app-shell.tsxindex f387fd7c..d1ab2ff0 100644--- a/frontend/slices/appshell/provider/app-shell.tsx+++ b/frontend/slices/appshell/provider/app-shell.tsx@@ -36,20 +36,17 @@ export function AppShell({ manifest }: { manifest: ShellManifest }) {const features = manifest.features ?? [];// Tab title follows the focused window ("Files — Brand"); audit found it- // frozen on the SSR metadata. Opt out via manifest.titleSync: false.+ // frozen on the SSR metadata.useEffect(() => {- configureWindowTitle({ suffix: manifest.brand.name, enabled: manifest.titleSync !== false });- if (manifest.titleSync !== false) startWindowTitleSync();- }, [manifest.brand.name, manifest.titleSync]);+ configureWindowTitle({ suffix: manifest.brand.name });+ startWindowTitleSync();+ }, [manifest.brand.name]);const providers = features.map((f) => f.provider).filter((p): p is ComponentType<{ children: ReactNode }> => Boolean(p));const shellConfig = useMemo(- () => ({- persistKey: manifest.persistKey ?? "appshell:layout",- routing: manifest.routing !== false,- }),- [manifest.persistKey, manifest.routing],+ () => ({ persistKey: manifest.persistKey ?? "appshell:layout" }),+ [manifest.persistKey],);return (@@ -61,7 +58,7 @@ export function AppShell({ manifest }: { manifest: ShellManifest }) {FeatureDescriptor.provider can call useApps()/useResponsive(). */}<AppRegistryProvider apps={manifest.apps}><ResponsiveBoundary>- {manifest.routing !== false && <UrlSync apps={manifest.apps} />}+ <UrlSync apps={manifest.apps} />{withProviders(providers, <OsDesktop />)}</ResponsiveBoundary></AppRegistryProvider>diff --git a/frontend/slices/appshell/registry/shell-config.tsx b/frontend/slices/appshell/registry/shell-config.tsxindex 5366013f..53abf3c0 100644--- a/frontend/slices/appshell/registry/shell-config.tsx+++ b/frontend/slices/appshell/registry/shell-config.tsx@@ -3,16 +3,13 @@import { createContext, useContext, type ReactNode } from "react";// Non-brand runtime config the shell core needs (kept out of Brand so brand-// stays purely presentational): the persistence namespace (so a generic-// appshell never hardcodes a consumer's localStorage key) + the routing flag-// (mirrors manifest.routing so surfaces beyond UrlSync — e.g. the mobile-// shell's deep-link handling — gate on the same opt-out).+// stays purely presentational): the persistence namespace, so a generic appshell+// never hardcodes a consumer's localStorage key.export type ShellConfig = {persistKey: string;- routing?: boolean;};-const ShellConfigContext = createContext<ShellConfig>({ persistKey: "appshell:layout", routing: true });+const ShellConfigContext = createContext<ShellConfig>({ persistKey: "appshell:layout" });export function ShellConfigProvider({value,diff --git a/frontend/slices/appshell/registry/types.ts b/frontend/slices/appshell/registry/types.tsindex c870d50a..64992a0b 100644--- a/frontend/slices/appshell/registry/types.ts+++ b/frontend/slices/appshell/registry/types.ts@@ -46,10 +46,6 @@ export type ShellManifest = {persistKey?: string;/** Consumer-injected capabilities (appearance/host) — keeps the shell generic. */capabilities?: ShellCapabilities;- /** Mirror focused app + deep path to the URL (catch-all route). Default on. */- routing?: boolean;- /** Sync document.title to the focused window ("App — Brand"). Default on. */- titleSync?: boolean;};/** Identity helper — gives a feature its type + a stable authoring shape. */diff --git a/frontend/slices/os-shell/integrations.ts b/frontend/slices/os-shell/integrations.tsindex 06e4e807..f943b445 100644--- a/frontend/slices/os-shell/integrations.ts+++ b/frontend/slices/os-shell/integrations.ts@@ -1,30 +1,21 @@"use client";-// MSO's registrations into the appshell runtime registries (lock guard,-// Quick Look previewer, cross-app drop routing). Side-effect module imported+// MSO's registrations into the appshell runtime registries (lock guard, context+// menus, palette commands). Side-effect module imported// once from os-root INSIDE the auth boundary — registries are module-level, so// this runs exactly once per page.-import { createElement } from "react";import { Activity, Expand, FilePlus, FolderPlus, Link2, Lock, RotateCcw, Shrink, Wallpaper as WallpaperIcon } from "lucide-react";import {lock,- openQuickLook,openWindow,- recordClip,registerCommands,registerContextMenu,- registerDropHandler,- registerPreviewer,resetDesktopIcons,setAddDialog,setShell,setUnlockGuard,shellsForSurface,- deliverDrop,- serialize,- share,toast,- AppHost,type MenuItem,} from "@/features/appshell";import { installAlfaSources } from "@/features/assistant";@@ -44,15 +35,6 @@ setUnlockGuard(async () => {}});-// Quick Look: `{ path, kind? }` targets render the media-viewer app inline in-// the overlay (same component a full viewer window would mount).-registerPreviewer({- id: "media-viewer",- canPreview: (t) =>- !!t && typeof t === "object" && typeof (t as { path?: unknown }).path === "string",- render: (t) => createElement(AppHost, { app: "media-viewer", payload: t }),-});-// MSO's dynamic right-click items — merged AFTER each shell's built-ins by// the context-menu registry. One provider for every shell ("*", surface-aware)// plus a dashboard-specific group; providers run at open time so disabled@@ -103,37 +85,3 @@ registerContextMenu("dashboard", () => [{ label: "Open System Monitor", icon: Activity, onClick: () => openWindow("system-monitor", "System Monitor") },]);-// Cross-app DnD: a `{ kind: "path" }` payload dropped on Files opens an-// explorer window at that path (files-manager already honors the payload).-registerDropHandler("files-manager", {- accepts: (d) => d.kind === "path" && typeof d.path === "string",- onDrop: (d) =>- openWindow("files-manager", "Files", undefined, { path: d.path as string }, { multi: true }),-});--// Headless e2e seam — ?e2e=1 registers palette commands that exercise the-// shell registries without coordinate-clicking app UIs (scripts/e2e/*).-if (typeof location !== "undefined" && new URLSearchParams(location.search).has("e2e")) {- registerCommands("e2e", [- { id: "e2e:notify", label: "E2E: fire test notification", hint: "Dev",- run: () => toast("E2E test notification", { appId: "files-manager", duration: 5000 }) },- { id: "e2e:quick-look", label: "E2E: quick look sample", hint: "Dev",- run: () => openQuickLook("Quick Look sample body — registry fallback previewer.") },- { id: "e2e:clip", label: "E2E: record clipboard sample", hint: "Dev",- run: () => recordClip("E2E clipboard sample text") },- { id: "e2e:share", label: "E2E: share sample", hint: "Dev",- run: () => share("E2E share payload") },- { id: "e2e:drop", label: "E2E: simulate cross-app drop", hint: "Dev",- run: () => {- const ok = deliverDrop("files-manager", { kind: "path", path: "~" });- toast(ok ? "Drop delivered to Files" : "Drop refused");- } },- { id: "e2e:bounds", label: "E2E: report window bounds", hint: "Dev",- run: () => {- const bad = serialize().filter(- (w) => w.x < 0 || w.y < 0 || w.x + w.w > innerWidth || w.y + w.h > innerHeight,- );- toast(bad.length ? `e2e:bounds bad ${bad.map((w) => w.id).join(",")}` : `e2e:bounds ok n=${serialize().length}`, { duration: 5000 });- } },- ]);-}diff --git a/frontend/slices/shell-settings/components/accent-swatches.tsx b/frontend/slices/shell-settings/components/accent-swatches.tsxdeleted file mode 100644index 0d1aef53..00000000--- a/frontend/slices/shell-settings/components/accent-swatches.tsx+++ /dev/null@@ -1,43 +0,0 @@-"use client";--import { Check } from "lucide-react";-import { Button } from "@/components/ui/button";-import { cn } from "@/lib/utils";--// Accent swatches. The color values ARE the data, so they render as inline-// background colors rather than theme tokens. Options injected by the consumer.-export function AccentSwatches({- value,- options,- onSelect,-}: {- value: string;- options: string[];- onSelect: (color: string) => void;-}) {- return (- <div className="flex flex-wrap items-center gap-2.5">- {options.map((color) => {- const active = value === color;- return (- <Button- key={color}- type="button"- variant="ghost"- size="icon"- aria-label={`Accent ${color}`}- aria-pressed={active}- onClick={() => onSelect(color)}- style={{ background: color }}- className={cn(- "flex size-8 items-center justify-center rounded-full p-0 transition-transform hover:scale-110 sm:size-7",- active && "ring-2 ring-ring ring-offset-2 ring-offset-background",- )}- >- {active ? <Check className="size-3.5 text-white drop-shadow" /> : null}- </Button>- );- })}- </div>- );-}diff --git a/frontend/slices/shell-settings/components/appearance-panel.tsx b/frontend/slices/shell-settings/components/appearance-panel.tsxdeleted file mode 100644index 0b32b04e..00000000--- a/frontend/slices/shell-settings/components/appearance-panel.tsx+++ /dev/null@@ -1,55 +0,0 @@-"use client";--import { Layers, Monitor, Palette } from "lucide-react";-import { Segmented } from "@/components/ui/segmented";-import { Switch } from "@/components/ui/switch";-import { SettingsSection } from "./section";-import { SettingsRow } from "./row";-import { AccentSwatches } from "./accent-swatches";-import type { AppearanceAdapter, SegSetting } from "../lib/types";--function SegRow({ label, seg }: { label: string; seg: SegSetting }) {- return (- <SettingsRow label={label}>- <Segmented options={seg.options} value={seg.value} onChange={seg.onChange} className="w-full flex-wrap sm:w-auto" />- </SettingsRow>- );-}--// Generic shell appearance UI — Appearance group + an optional Display group for-// the device override. Everything it shows comes from the injected adapter, so the-// panel itself is brand-free and lift-ready.-export function AppearancePanel({ appearance: a }: { appearance: AppearanceAdapter }) {- return (- <>- <SettingsSection icon={<Palette />} title="Appearance">- {a.style && <SegRow label="Style" seg={a.style} />}- {a.theme && <SegRow label="Mode" seg={a.theme} />}- {a.accent && (- <SettingsRow label="Accent">- <AccentSwatches value={a.accent.value} options={a.accent.options} onSelect={a.accent.onChange} />- </SettingsRow>- )}- {a.wallpaper && <SegRow label="Wallpaper" seg={a.wallpaper} />}- {a.reduceTransparency && (- <SettingsRow label="Reduce transparency">- <Switch checked={a.reduceTransparency.value} onCheckedChange={a.reduceTransparency.onChange} />- </SettingsRow>- )}- </SettingsSection>-- {(a.shellDesktop || a.shellMobile) && (- <SettingsSection icon={<Layers />} title="Shell">- {a.shellDesktop && <SegRow label="Desktop layout" seg={a.shellDesktop} />}- {a.shellMobile && <SegRow label="Mobile layout" seg={a.shellMobile} />}- </SettingsSection>- )}-- {a.device && (- <SettingsSection icon={<Monitor />} title="Display">- <SegRow label="Device" seg={a.device} />- </SettingsSection>- )}- </>- );-}diff --git a/frontend/slices/shell-settings/index.ts b/frontend/slices/shell-settings/index.tsindex 0b12808a..e0ab0d85 100644--- a/frontend/slices/shell-settings/index.ts+++ b/frontend/slices/shell-settings/index.ts@@ -1,11 +1,8 @@-// shell-settings — portable, brand-free shell settings UI. The shell-level panels-// (appearance + display) plus the generic Section/Row building blocks. The consumer-// (e.g. the os-settings app) composes these and injects an AppearanceAdapter built-// from its own appearance store, so this slice carries no project-specific values.+// shell-settings — portable, brand-free settings UI primitives. The generic+// Section/Row/Block building blocks the os-settings app composes; it carries no+// project-specific values. (The AppearancePanel that used to live here was+// unreachable — os-settings/components/appearance-section.tsx is the live UI.)export { SettingsSection } from "./components/section";export { SettingsRow, SettingsValueRow } from "./components/row";export { SettingsActionRow } from "./components/action-row";export { SettingsBlock } from "./components/block";-export { AccentSwatches } from "./components/accent-swatches";-export { AppearancePanel } from "./components/appearance-panel";-export type { AppearanceAdapter, SegSetting, SettingOption } from "./lib/types";diff --git a/frontend/slices/shell-settings/lib/types.ts b/frontend/slices/shell-settings/lib/types.tsdeleted file mode 100644index 45b2d3fc..00000000--- a/frontend/slices/shell-settings/lib/types.ts+++ /dev/null@@ -1,31 +0,0 @@-// Generic, brand-free appearance contract. The CONSUMER (e.g. os-settings) builds-// this adapter from its own appearance store and the option lists it supports, so-// the panel UI carries no project-specific values — it just renders what it's given.--export type SettingOption = { value: string; label: string };--/** One segmented setting: current value + the choices + a setter. */-export type SegSetting = {- value: string;- options: SettingOption[];- onChange: (value: string) => void;-};--/** The appearance surface the panel can render. All groups are optional — only- * the ones the consumer provides are shown. */-export type AppearanceAdapter = {- style?: SegSetting;- /** Optional: consumers may render light/dark mode in a dedicated Theme page. */- theme?: SegSetting;- /** Accent swatches — options are literal color values (their own data). */- accent?: { value: string; options: string[]; onChange: (color: string) => void };- wallpaper?: SegSetting;- /** OS-layout switchers (multi-shell): which chrome renders on each surface- * (desktop: macOS/Windows/Dashboard… · mobile: iOS/Android…). Optional —- * consumers without the shell registry simply omit them. */- shellDesktop?: SegSetting;- shellMobile?: SegSetting;- /** Device override (Display section). */- device?: SegSetting;- reduceTransparency?: { value: boolean; onChange: (on: boolean) => void };-};diff --git a/os-browser/README.md b/os-browser/README.mddeleted file mode 100644index 4fbfc2e8..00000000--- a/os-browser/README.md+++ /dev/null@@ -1,53 +0,0 @@-# os-browser — RETIRED sidecar, kept for its Playwright install--> **This is no longer the Browser app.** The Browser app is **Camoufox** — a real-> anti-fingerprinting Firefox on a headless X display, streamed in over noVNC and-> gated in `proxy.ts` by the same verified-session check that guards `/api/v1/exec`.-> Chromium-behind-a-screenshot could not get past sites that block automation, which-> is exactly why it was replaced.->-> What that means concretely, as of **2026-08-03**:-> - The `os-browser` systemd unit is **stopped and `disable`d** — it does not start at boot.-> - The `/api/v1/browser/*` routes it proxied through **no longer exist**.-> - No app code calls it; the only mention left is a comment in `lib/agent/server.ts`-> recording that the bridge was retired.->-> **This directory is kept on purpose anyway**: `os-browser/node_modules` holds the-> repo's ONLY Playwright install, which `scripts/e2e` and desktop/mobile verification-> use. Deleting it breaks those until reinstalled. The service below still runs if you-> start it by hand — just never `enable` it.--A tiny HTTP wrapper around a REAL Playwright Chromium running on the VPS. One-persistent profile (`~/.mso/chrome-profile`) keeps logins across restarts.--## Run--```bash-npm install-npx playwright install chromium --with-deps # system deps need sudo once--OS_BROWSER_SECRET=$(openssl rand -hex 16) node server.mjs-# listens on 127.0.0.1:4002 — it REFUSES to start without a secret (≥16 chars)-```--Then in the main app's `.env.local`:--```bash-OS_BROWSER_URL=http://127.0.0.1:4002-OS_BROWSER_SECRET=<the same secret>-```--## Env--| Var | Default | Purpose |-|---|---|---|-| `OS_BROWSER_SECRET` | — (required, ≥16) | Shared secret; never reaches the client |-| `OS_BROWSER_PORT` | `4002` | Listen port |-| `OS_BROWSER_HOST` | `127.0.0.1` | **Keep loopback.** Override only behind a private bridge |-| `OS_BROWSER_PROFILE` | `~/.mso/chrome-profile` | Persistent browser profile dir |--## Security--Loopback + shared secret, by design. Never expose :4002 publicly — the-service will navigate anywhere and holds logged-in sessions in its profile.-Firewall it; see [docs/INSTALL.md](../docs/INSTALL.md#6-optional--the-remote-browser-app-os-browser).diff --git a/os-browser/server.mjs b/os-browser/server.mjsdeleted file mode 100644index b799c64e..00000000--- a/os-browser/server.mjs+++ /dev/null@@ -1,339 +0,0 @@-import http from "http";-import { createHash, timingSafeEqual } from "crypto";-import os from "os";-import path from "path";-import { chromium } from "playwright";--// os-browser — a REAL Chromium on the VPS host, driven over a tiny HTTP API.-// ONE persistent context (cookies/cache/localStorage saved to disk, so logins-// stick across restarts) but ONE PAGE PER CONSUMER: the human viewer ("ui") and-// the agent ("agent") each get their own tab, so they never fight over the same-// page — while still SHARING the login/profile (a tab is cheap; a second-// Chromium would not be). Loopback + secret; mso is the only caller. An-// http(s) target CAN reach LAN/metadata by design, so never expose this port and-// never let an unauthenticated relay forward here.--const PORT = Number(process.env.OS_BROWSER_PORT || 4002);-const HOST = process.env.OS_BROWSER_HOST || "127.0.0.1";-const SECRET = process.env.OS_BROWSER_SECRET || "";-const USER_DATA_DIR =- process.env.OS_BROWSER_PROFILE || path.join(os.homedir(), ".mso", "chrome-profile");-const VIEWPORT = {- width: Number(process.env.OS_BROWSER_WIDTH || 1280),- height: Number(process.env.OS_BROWSER_HEIGHT || 800),-};-const IDLE_MS = Number(process.env.OS_BROWSER_IDLE_MS || 0);-// Hard cap on concurrent consumer tabs so a runaway can't spawn unbounded pages.-const MAX_PAGES = Number(process.env.OS_BROWSER_MAX_PAGES || 12);-const HEADLESS = process.env.OS_BROWSER_HEADLESS !== "0";-const EXT_DIR = process.env.OS_BROWSER_EXTENSION_DIR || "";-// Use a real installed browser (e.g. "chrome") instead of bundled Chromium —-// Google sign-in rejects bundled Chromium ("browser may not be secure"). Unset-// = bundled Chromium.-const CHANNEL = process.env.OS_BROWSER_CHANNEL || undefined;--if (!SECRET || SECRET.length < 16) {- console.error("OS_BROWSER_SECRET missing/short (>=16) — refusing to start");- process.exit(1);-}--// AutomationControlled off so sites (notably Google sign-in) don't flag the-// session as a bot and loop on "this browser may not be secure" / cookie nags.-const args = [- "--no-sandbox",- "--disable-dev-shm-usage",- "--disable-blink-features=AutomationControlled",-];-if (EXT_DIR) args.push(`--disable-extensions-except=${EXT_DIR}`, `--load-extension=${EXT_DIR}`);--const ctx = await chromium.launchPersistentContext(USER_DATA_DIR, {- headless: HEADLESS,- channel: CHANNEL,- viewport: VIEWPORT,- userAgent:- "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36",- args,-});--// Per-consumer state: page + serialized action chain + last-touch timestamp. The-// first existing tab is adopted as the "default" consumer's page.-const sessions = new Map();-function sanitize(c) {- return String(c || "default").replace(/[^a-z0-9_-]/gi, "").slice(0, 32) || "default";-}-async function getSession(consumer) {- const key = sanitize(consumer);- let s = sessions.get(key);- if (s && !s.page.isClosed()) {- s.touch = Date.now();- return s;- }- // Evict the least-recently-used tab when at the cap. Never the live "default",- // never a tab someone is actively streaming (has screencast watchers).- if (sessions.size >= MAX_PAGES) {- const victim = [...sessions.entries()]- .filter(([k, v]) => k !== "default" && v.watchers.size === 0)- .sort((a, b) => a[1].touch - b[1].touch)[0];- if (victim) {- await stopScreencast(victim[1]);- await victim[1].page.close().catch(() => {});- sessions.delete(victim[0]);- }- }- const page = key === "default" && ctx.pages()[0] ? ctx.pages()[0] : await ctx.newPage();- await page.goto("about:blank").catch(() => {});- s = { page, chain: Promise.resolve(), touch: Date.now(), watchers: new Set(), cdp: null, lastFrame: null };- sessions.set(key, s);- return s;-}-// Serialize per page so navigate/screenshot for one consumer never interleave.-function run(s, fn) {- s.chain = s.chain.then(fn, fn);- return s.chain.then((v) => v);-}--// --- CDP screencast: a live MJPEG stream per consumer, driven by CDP frame-// events (only fire on visual change) → smoother AND lighter than fixed polling.-// Lazy: started when the first watcher connects, stopped when the last leaves.-function writeFrame(res, buf) {- try {- res.write(`--frame\r\nContent-Type: image/jpeg\r\nContent-Length: ${buf.length}\r\n\r\n`);- res.write(buf);- res.write("\r\n");- } catch {- /* client gone — close handler will drop it */- }-}-async function ensureScreencast(s) {- if (s.cdp) return;- const cdp = await ctx.newCDPSession(s.page);- cdp.on("Page.screencastFrame", (e) => {- s.lastFrame = Buffer.from(e.data, "base64");- for (const w of s.watchers) writeFrame(w, s.lastFrame);- cdp.send("Page.screencastFrameAck", { sessionId: e.sessionId }).catch(() => {});- });- s.cdp = cdp;- await cdp- .send("Page.startScreencast", {- format: "jpeg",- quality: 50,- everyNthFrame: 1,- maxWidth: VIEWPORT.width,- maxHeight: VIEWPORT.height,- })- .catch(() => {});-}-async function stopScreencast(s) {- if (!s.cdp) return;- const cdp = s.cdp;- s.cdp = null;- await cdp.send("Page.stopScreencast").catch(() => {});- await cdp.detach().catch(() => {});-}--// Idle reaper: reset "default" to about:blank, CLOSE other idle tabs to free RAM.-if (IDLE_MS > 0)- setInterval(() => {- const now = Date.now();- for (const [key, s] of sessions) {- if (now - s.touch < IDLE_MS) continue;- if (s.watchers.size) continue; // someone is streaming this tab — keep it- if (key === "default") {- if (s.page.url() !== "about:blank") void run(s, () => s.page.goto("about:blank").catch(() => {}));- } else {- void stopScreencast(s).then(() => s.page.close().catch(() => {}));- sessions.delete(key);- }- }- }, Math.min(IDLE_MS, 60000)).unref();--function send(res, code, body, type = "application/json") {- const buf = type === "application/json" ? Buffer.from(JSON.stringify(body)) : body;- res.writeHead(code, { "content-type": type, "content-length": buf.length });- res.end(buf);-}-function readJson(req) {- return new Promise((resolve) => {- let d = "";- req.on("data", (c) => (d += c));- req.on("end", () => {- try {- resolve(d ? JSON.parse(d) : {});- } catch {- resolve({});- }- });- });-}-const stateOf = async (page) => ({ url: page.url(), title: await page.title().catch(() => "") });--function secretOk(provided) {- const a = createHash("sha256").update(String(provided ?? "")).digest();- const b = createHash("sha256").update(SECRET).digest();- return timingSafeEqual(a, b);-}--function scanElements() {- const sel = (el) => {- if (el.id) return `#${CSS.escape(el.id)}`;- const tid = el.getAttribute("data-testid");- if (tid) return `[data-testid="${tid}"]`;- const name = el.getAttribute("name");- if (name) return `${el.tagName.toLowerCase()}[name="${name}"]`;- const parts = [];- let n = el;- for (let d = 0; n && n.nodeType === 1 && d < 5 && n.tagName !== "BODY"; d++) {- const t = n.tagName.toLowerCase();- const i = Array.from(n.parentNode?.children || []).filter((c) => c.tagName === n.tagName).indexOf(n) + 1;- parts.unshift(`${t}:nth-of-type(${i})`);- n = n.parentElement;- }- return parts.join(" > ");- };- const q = "a,button,input,textarea,select,[role=button],[role=link],[onclick],[contenteditable=true]";- const out = [];- for (const el of document.querySelectorAll(q)) {- const r = el.getBoundingClientRect();- if (r.width < 1 || r.height < 1) continue;- if (r.bottom < 0 || r.top > innerHeight * 3) continue;- out.push({- tag: el.tagName.toLowerCase(),- type: el.getAttribute("type") || undefined,- role: el.getAttribute("role") || undefined,- text: (el.innerText || el.value || el.placeholder || el.getAttribute("aria-label") || "").trim().slice(0, 120),- href: el.getAttribute("href") || undefined,- selector: sel(el),- box: { x: Math.round(r.x), y: Math.round(r.y), w: Math.round(r.width), h: Math.round(r.height) },- });- if (out.length >= 200) break;- }- return out;-}--// Last-resort net: a single bad request (or a teardown race) must never crash-// the whole browser service. Log and keep serving.-process.on("unhandledRejection", (e) => console.error("unhandledRejection:", String(e)));-process.on("uncaughtException", (e) => console.error("uncaughtException:", String(e)));--const server = http.createServer(async (req, res) => {- const u = new URL(req.url, "http://x");- const p = u.pathname;- if (p === "/health") return send(res, 200, { ok: true, consumers: sessions.size });- if (!secretOk(req.headers["x-os-browser-secret"])) return send(res, 401, { error: "unauthorized" });-- const consumer = sanitize(req.headers["x-os-browser-consumer"] || u.searchParams.get("consumer"));- if (p === "/info")- return send(res, 200, {- ok: true,- consumers: [...sessions.keys()],- profile: USER_DATA_DIR,- viewport: VIEWPORT,- headless: HEADLESS,- extension: EXT_DIR || null,- idleMs: IDLE_MS,- maxPages: MAX_PAGES,- });-- try {- // Inside the try: getSession can reject (e.g. a request racing a shutdown —- // "context has been closed"); an uncaught rejection here would kill the- // whole service, taking the Browser app down with it.- const s = await getSession(consumer);- const page = s.page;- if (p === "/close" && req.method === "POST") {- if (consumer !== "default" && consumer !== "agent") {- await stopScreencast(s);- await s.page.close().catch(() => {});- sessions.delete(consumer);- }- return send(res, 200, { ok: true });- }- if (p === "/screencast" && req.method === "GET") {- res.writeHead(200, {- "content-type": "multipart/x-mixed-replace; boundary=frame",- "cache-control": "no-store",- connection: "keep-alive",- });- s.watchers.add(res);- await ensureScreencast(s);- if (s.lastFrame) writeFrame(res, s.lastFrame);- req.on("close", () => {- s.watchers.delete(res);- if (s.watchers.size === 0) void stopScreencast(s);- });- return; // long-lived: frames pushed from the CDP event, never send()- }- if (p === "/screenshot" && req.method === "GET") {- const jpeg = u.searchParams.get("type") === "jpeg";- const opts = jpeg ? { type: "jpeg", quality: Number(u.searchParams.get("q") || 60) } : { type: "png" };- const buf = await run(s, () => page.screenshot(opts));- return send(res, 200, buf, jpeg ? "image/jpeg" : "image/png");- }- if (p === "/state") return send(res, 200, await run(s, () => stateOf(page)));- if (p === "/content")- return send(res, 200, await run(s, async () => ({- ...(await stateOf(page)),- text: (await page.evaluate(() => document.body?.innerText || "")).slice(0, 200000),- })));- if (p === "/elements")- return send(res, 200, await run(s, async () => ({- ...(await stateOf(page)),- elements: await page.evaluate(scanElements),- })));-- const body = req.method === "POST" ? await readJson(req) : {};- if (p === "/navigate") {- let target = String(body.url || "").trim();- if (/^[a-z]+:\/\//i.test(target) && !/^https?:\/\//i.test(target))- return send(res, 400, { error: "scheme_not_allowed" });- if (target && !/^[a-z]+:\/\//i.test(target))- target = /\.\w{2,}($|\/)/.test(target) ? "https://" + target : "https://www.google.com/search?q=" + encodeURIComponent(target);- return send(res, 200, await run(s, async () => {- await page.goto(target, { waitUntil: "domcontentloaded", timeout: 30000 }).catch((e) => ({ e }));- return stateOf(page);- }));- }- if (p === "/click")- return send(res, 200, await run(s, async () => {- await page.mouse.click(Number(body.x) || 0, Number(body.y) || 0);- await page.waitForTimeout(60);- return stateOf(page);- }));- if (p === "/click-selector")- return send(res, 200, await run(s, async () => {- await page.click(String(body.selector || ""), { timeout: 5000 }).catch((e) => ({ e: String(e) }));- await page.waitForTimeout(60);- return stateOf(page);- }));- if (p === "/fill")- return send(res, 200, await run(s, async () => {- await page.fill(String(body.selector || ""), String(body.value ?? ""), { timeout: 5000 }).catch((e) => ({ e: String(e) }));- return { ok: true };- }));- if (p === "/type")- return send(res, 200, await run(s, async () => {- await page.keyboard.type(String(body.text || ""));- return { ok: true };- }));- if (p === "/key")- return send(res, 200, await run(s, async () => {- await page.keyboard.press(String(body.key || "Enter"));- await page.waitForTimeout(60);- return stateOf(page);- }));- if (p === "/scroll")- return send(res, 200, await run(s, async () => {- await page.mouse.wheel(0, Number(body.dy) || 0);- return { ok: true };- }));- if (p === "/back") return send(res, 200, await run(s, async () => { await page.goBack().catch(() => {}); return stateOf(page); }));- if (p === "/forward") return send(res, 200, await run(s, async () => { await page.goForward().catch(() => {}); return stateOf(page); }));- if (p === "/reload") return send(res, 200, await run(s, async () => { await page.reload().catch(() => {}); return stateOf(page); }));-- return send(res, 404, { error: "not found" });- } catch (e) {- return send(res, 500, { error: String(e) });- }-});--server.listen(PORT, HOST, () => console.log(`os-browser on ${HOST}:${PORT}, profile ${USER_DATA_DIR}, max-pages ${MAX_PAGES}`));diff --git a/scripts/e2e-lib.sh b/scripts/e2e-lib.shdeleted file mode 100644index d6334f95..00000000--- a/scripts/e2e-lib.sh+++ /dev/null@@ -1,38 +0,0 @@-# Shared helpers for scripts/e2e/*.sh (sourced — lives outside the checks dir).-# Requires $BROWSER + $E2E_URL from scripts/e2e.sh. Drives the appshell-# Spotlight (⌘K overlay), not a cmdk dialog — markers differ from app-shell.--page_text() { "$BROWSER" content | python3 -c 'import sys,json; print(json.load(sys.stdin)["text"])'; }-page_title() { "$BROWSER" content | python3 -c 'import sys,json; print(json.load(sys.stdin)["title"])'; }-has() { page_text | grep -qF "$1"; }--wait_for() { # poll until text appears (dev-mode compiles can be slow)- for _ in 1 2 3 4 5 6 7 8 9 10; do has "$1" && return 0; sleep 1; done- return 1-}--has_soon() { # fast poll for transient toasts (~3.5–5s lifetime)- for _ in 1 2 3 4 5 6; do has "$1" && return 0; sleep 0.6; done- return 1-}--pal_open() { # toggle until Spotlight is verifiably open ("Open app" hints render)- for _ in 1 2 3; do- "$BROWSER" key "Meta+k" >/dev/null; sleep 1- has "Minimize all windows" && return 0- done- echo "spotlight failed to open"- exit 1-}--palrun() { # open Spotlight, type query, run top hit- pal_open- for _ in 1 2 3; do- "$BROWSER" key "Control+a" >/dev/null; "$BROWSER" key "Backspace" >/dev/null- "$BROWSER" type "$1" >/dev/null; sleep 0.9- page_text | grep -qiF "$1" && break- done- "$BROWSER" key Enter >/dev/null; sleep 0.9-}--palend() { "$BROWSER" key Escape >/dev/null; sleep 0.5; }diff --git a/scripts/e2e.sh b/scripts/e2e.shdeleted file mode 100755index 874121d1..00000000--- a/scripts/e2e.sh+++ /dev/null@@ -1,40 +0,0 @@-#!/usr/bin/env bash-# E2E harness — DEMO-mode dev server + the real headless Chromium (os-browser-# service, read-only driving) through every check in scripts/e2e/*.sh.-# Demo mode = MockAdapter + no auth gate; shell features are fully live.-# NEVER asserts against the browser slice (quarantined).-# Usage: bash scripts/e2e.sh [check-name…]-set -uo pipefail-cd "$(dirname "$0")/.."--export E2E_PORT="${E2E_PORT:-3198}"-export E2E_URL="http://localhost:$E2E_PORT"-export BROWSER="$HOME/.claude/skills/os/os-browser.sh"--if curl -fso /dev/null "$E2E_URL"; then- echo "port $E2E_PORT already serving something — set E2E_PORT"; exit 1-fi-"$BROWSER" health >/dev/null || { echo "os-browser service down"; exit 1; }--NEXT_PUBLIC_OS_DEMO=1 npx next dev -p "$E2E_PORT" >/tmp/mso-e2e-next.log 2>&1 &-SERVER=$!-trap 'kill "$SERVER" 2>/dev/null' EXIT-for _ in $(seq 1 90); do- curl -fso /dev/null "$E2E_URL" && break- sleep 0.5-done-curl -fso /dev/null "$E2E_URL" || { echo "server never came up"; tail -20 /tmp/mso-e2e-next.log; exit 1; }--pass=0 fail=0-for check in scripts/e2e/*.sh; do- [ -e "$check" ] || continue- name="$(basename "$check" .sh)"- if [ "$#" -gt 0 ]; then case " $* " in *" $name "*) ;; *) continue ;; esac; fi- if bash "$check" >"/tmp/mso-e2e-$name.log" 2>&1; then- echo "PASS $name"; pass=$((pass + 1))- else- echo "FAIL $name — /tmp/mso-e2e-$name.log:"; tail -5 "/tmp/mso-e2e-$name.log"; fail=$((fail + 1))- fi-done-echo "e2e: $pass pass, $fail fail"-[ "$fail" -eq 0 ]diff --git a/scripts/e2e/00-baseline.sh b/scripts/e2e/00-baseline.shdeleted file mode 100755index 3cceb67f..00000000--- a/scripts/e2e/00-baseline.sh+++ /dev/null@@ -1,8 +0,0 @@-#!/usr/bin/env bash-# Baseline: the demo shell boots — brand chrome renders, no auth gate.-set -euo pipefail-. "$(dirname "$0")/../e2e-lib.sh"-"$BROWSER" go "$E2E_URL/?e2e=1" >/dev/null-sleep 4-wait_for "MSO" || { echo "brand chrome missing"; exit 1; }-exit 0diff --git a/scripts/e2e/t1-commands.sh b/scripts/e2e/t1-commands.shdeleted file mode 100755index b960f5ee..00000000--- a/scripts/e2e/t1-commands.sh+++ /dev/null@@ -1,14 +0,0 @@-#!/usr/bin/env bash-# Command registry → Spotlight merge: a registered command runs from ⌘K,-# desktop widgets toggle on the wallpaper layer.-set -euo pipefail-. "$(dirname "$0")/../e2e-lib.sh"-"$BROWSER" go "$E2E_URL/?e2e=1" >/dev/null-sleep 4-palrun "Toggle desktop widgets"; palend-wait_for "Memory" || { echo "widgets did not appear"; exit 1; }-has "Storage" || { echo "storage card missing"; exit 1; }-palrun "Toggle desktop widgets"; palend-sleep 1-has "Memory" && { echo "widgets did not disappear"; exit 1; }-exit 0diff --git a/scripts/e2e/t2-title.sh b/scripts/e2e/t2-title.shdeleted file mode 100755index aa47a3cf..00000000--- a/scripts/e2e/t2-title.sh+++ /dev/null@@ -1,11 +0,0 @@-#!/usr/bin/env bash-# document.title follows the focused window — "Files — MSO".-set -euo pipefail-. "$(dirname "$0")/../e2e-lib.sh"-"$BROWSER" go "$E2E_URL/?e2e=1" >/dev/null-sleep 4-palrun "Files"; palend-sleep 2-t="$(page_title)"-case "$t" in "Files — MSO") ;; *) echo "expected 'Files — MSO', got: $t"; exit 1;; esac-exit 0diff --git a/scripts/e2e/t3-clamp.sh b/scripts/e2e/t3-clamp.shdeleted file mode 100755index 7a51724b..00000000--- a/scripts/e2e/t3-clamp.sh+++ /dev/null@@ -1,16 +0,0 @@-#!/usr/bin/env bash-# Spawn cascade clamp: 8 windows via the drop seam, all rects in-viewport-# (e2e:bounds toast, 5s lifetime → has_soon).-set -euo pipefail-. "$(dirname "$0")/../e2e-lib.sh"-"$BROWSER" go "$E2E_URL/?e2e=1" >/dev/null-sleep 4-for _ in 1 2 3 4 5 6 7 8; do palrun "E2E: simulate cross-app drop"; palend; done-sleep 2-ok=""-for _ in 1 2 3; do- palrun "E2E: report window bounds"; palend- if has_soon "e2e:bounds ok"; then ok=1; break; fi-done-[ -n "$ok" ] || { echo "bounds check failed"; page_text | tail -20; exit 1; }-exit 0diff --git a/scripts/e2e/t4-clipboard.sh b/scripts/e2e/t4-clipboard.shdeleted file mode 100755index 3908002c..00000000--- a/scripts/e2e/t4-clipboard.sh+++ /dev/null@@ -1,12 +0,0 @@-#!/usr/bin/env bash-# Clipboard history: record via seam, ⌘⇧V overlay lists it.-set -euo pipefail-. "$(dirname "$0")/../e2e-lib.sh"-"$BROWSER" go "$E2E_URL/?e2e=1" >/dev/null-sleep 4-palrun "E2E: record clipboard sample"; palend-"$BROWSER" key "Meta+Shift+v" >/dev/null; sleep 1.5-wait_for "Clipboard history" || { echo "overlay did not open"; exit 1; }-has "E2E clipboard sample text" || { echo "clip missing from history"; exit 1; }-"$BROWSER" key Escape >/dev/null; sleep 1-exit 0diff --git a/scripts/e2e/t5-quick-look.sh b/scripts/e2e/t5-quick-look.shdeleted file mode 100755index b8c5faed..00000000--- a/scripts/e2e/t5-quick-look.sh+++ /dev/null@@ -1,11 +0,0 @@-#!/usr/bin/env bash-# Quick Look: seam publishes a target, overlay renders the fallback preview.-set -euo pipefail-. "$(dirname "$0")/../e2e-lib.sh"-"$BROWSER" go "$E2E_URL/?e2e=1" >/dev/null-sleep 4-palrun "E2E: quick look sample" # spotlight closes itself on run-wait_for "Quick Look sample body" || { echo "quick look did not open"; exit 1; }-"$BROWSER" key Escape >/dev/null; sleep 1-has "Quick Look sample body" && { echo "quick look did not close"; exit 1; }-exit 0diff --git a/scripts/e2e/t6-share.sh b/scripts/e2e/t6-share.shdeleted file mode 100755index 94f59f9a..00000000--- a/scripts/e2e/t6-share.sh+++ /dev/null@@ -1,11 +0,0 @@-#!/usr/bin/env bash-# Share sheet: seam shares a payload, built-in targets listed.-set -euo pipefail-. "$(dirname "$0")/../e2e-lib.sh"-"$BROWSER" go "$E2E_URL/?e2e=1" >/dev/null-sleep 4-palrun "E2E: share sample" # spotlight closes itself on run-wait_for "Copy as text" || { echo "share sheet did not open"; exit 1; }-has "Download as file" || { echo "download target missing"; exit 1; }-"$BROWSER" key Escape >/dev/null; sleep 1-exit 0