Skip to content

armgit / mso

Public Imported from GitHub
0

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.

refactor: delete five retired subsystems nothing could reach

Rahman7112223e04e4
diff --git a/CLAUDE.md b/CLAUDE.md
index 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` symlinks
it 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]` is
the 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 the
diff --git a/README.md b/README.md
index 95bbb1d6..88f5f44d 100644
--- a/README.md
+++ b/README.md
@@ -140,7 +140,7 @@ Global options: `--base <url>` to target another instance, `--env <file>` to pic
different secrets file. Device and service commands work even while the service is
down. If you use [Claude Code](https://claude.com/claude-code), the installer also
links 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 warning
diff --git a/app/os-root.tsx b/app/os-root.tsx
index 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 commands
import { 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.md
index 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 CLI
One 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).
```bash
OS=mso
-BR=/home/rahman/.claude/skills/mso/browser.sh
IE=/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.md
deleted file mode 100644
index 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.js
deleted file mode 100644
index 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.md
index 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 pla
headless 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 the
sandboxed-iframe browser that briefly followed it, because X-Frame-Options makes an
iframe 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-level
Camoufox skill for the in-app assistant, from ClawHub
diff --git a/claude-skills/mso-image-editor/image-editor.sh b/claude-skills/mso-image-editor/image-editor.sh
index 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" in
case "$p" in /*) ;; *) p="/$p" ;; esac
url="$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 2
else
- 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" ;;
esac
diff --git a/claude-skills/mso-list/SKILL.md b/claude-skills/mso-list/SKILL.md
index 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 end
Enumerate every mso app, its user-facing functions / AI-Inspector actions, and
verify 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.md
index 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, service
changes) with the user first.
diff --git a/claude-skills/mso/browser.sh b/claude-skills/mso/browser.sh
deleted file mode 100755
index 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" ;;
-esac
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
index 0408ca54..ddaf3e27 100644
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@ -173,30 +173,18 @@ TLS (certbot). Keep `proxy_set_header Host $host;` and forward
Either 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.tsx
index 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.ts
index 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.tsx
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.tsx
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
index 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.ts
index 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.ts
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
deleted file mode 100644
index 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.ts
index 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.ts
index 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.ts
index 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.tsx
index 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.tsx
index 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.ts
index 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.ts
index 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.tsx
deleted file mode 100644
index 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.tsx
deleted file mode 100644
index 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.ts
index 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.ts
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.mjs
deleted file mode 100644
index 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.sh
deleted file mode 100644
index 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.sh
deleted file mode 100755
index 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.sh
deleted file mode 100755
index 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 0
diff --git a/scripts/e2e/t1-commands.sh b/scripts/e2e/t1-commands.sh
deleted file mode 100755
index 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 0
diff --git a/scripts/e2e/t2-title.sh b/scripts/e2e/t2-title.sh
deleted file mode 100755
index 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 0
diff --git a/scripts/e2e/t3-clamp.sh b/scripts/e2e/t3-clamp.sh
deleted file mode 100755
index 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 0
diff --git a/scripts/e2e/t4-clipboard.sh b/scripts/e2e/t4-clipboard.sh
deleted file mode 100755
index 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 0
diff --git a/scripts/e2e/t5-quick-look.sh b/scripts/e2e/t5-quick-look.sh
deleted file mode 100755
index 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 0
diff --git a/scripts/e2e/t6-share.sh b/scripts/e2e/t6-share.sh
deleted file mode 100755
index 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