dsh-iab

Embeds a CDP-driven Chrome IAB (In-App Browser) tab into the DSH better-sidebar.

Architecture

┌─────────────────────────────────────────────────────┐
│  DSH Host (Node.js)                                  │
│  ┌─────────────┐    stdio     ┌──────────────────┐  │
│  │  index.mjs  │◄════════════►│  sidecar.mjs     │  │
│  │  (host half)│  JSON-RPC     │  (CDP controller)│  │
│  └──────┬──────┘               └──────┬───────────┘  │
│         │ HTTP /zcode-iab             │ CDP WebSocket  │
│         │                              ▼               │
│         │                     ┌──────────────────┐     │
│         │                     │  Google Chrome    │     │
│         │                     │  (--remote-debug) │     │
│         │                     └──────────────────┘     │
│─────────┼─────────────────────────────────────────────│
│  DSH Client (Browser)                                │
│  ┌──────┴──────┐                                    │
│  │  client.js   │─── fetch("/zcode-iab", {POST}) ──┘
│  │  (IAB tab)   │
│  └─────────────┘
└─────────────────────────────────────────────────────┘

• index.mjs (host half): spawns lib/sidecar.mjs via child_process.spawn, communicates over stdio JSON-RPC, exposes HTTP endpoint /zcode-iab via ctx.webServer.
• client.js (client half): registers a betterSidebar tab, calls the host HTTP endpoint via fetch().
• lib/sidecar.mjs: plain Node script that controls Chrome through CDP (navigate, screenshot, click, scroll, type, snapshot, back, forward, reload).

Features

• Address bar with navigation
• Screenshot display (base64 PNG)
• Click-by-coordinate (toggle click mode, click on screenshot)
• Scroll up/down
• Text input
• Text snapshot (accessibility tree)
• Back / Forward / Reload

Install

dsh plugin --profile web add /home/mario/.ai/.projects/.dsh-plugins/dsh-iab

Then refresh the browser. The "ZCode IAB" tab (🌐) appears in the better-sidebar.

Requirements

• Google Chrome at /usr/bin/google-chrome-stable
• User data dir at ~/.dsh/iab-profile (auto-created on first run)