dsh-maestro-mobile

Mobile adaptation for the DeepSeek Harness (DSH) Web UI. Below 1024px it turns the sidebar into an overlay drawer, sheets the dialogs, and tunes the composer for phones; at ≥1024px it is a complete no-op, so desktop is untouched.

What you get

Capability	How it works
Sidebar → drawer	Below 1024px the sidebar becomes a left overlay drawer (~80vw, transform:none when open); desktop ≥1024px is untouched
Dialogs → sheets	Settings, explorer, and preview become mobile-friendly bottom sheets with env(safe-area-inset-*) handling and notch avoidance
Status-bar & safe areas	Status-bar / notch padding, light/dark theme-color, and touch-action: manipulation + gesturestart guard against double-tap zoom
Composer stays clean	Permission capsule, model name, and switch menus use fixed-size pinning so they never squeeze or overlap on narrow screens
Tablet friendly	768–1023px centered, width-constrained sheets; phone and tablet geometries are verified separately
Easy diagnostics	Append ?dsh-maestro-mobile-debug=1 (legacy ?mobile-nav-debug=1) for a floating bar with viewport / frame / floating-panel / JS-error state

Requirements

• Node.js ≥ 22, pnpm ≥ 11
• A running DeepSeek Harness web profile (pnpm dsh web)
• Chromium 105+ for the :has() selectors

Install

# from the registry
dsh plugin --profile web add @ddtcorex/dsh-maestro-mobile

# local development (live link: edit + rebuild just works)
dsh plugin --profile web add link:/path/to/dsh-maestro-mobile

The repo ships committed lib/ build output, so there is no allowBuilds block. Restart dsh web after installing or after any pnpm build.

Manual cordis.yml row

If you are not using dsh plugin, add this row to your cordis.yml:

- id: dsh-maestro-mobile
  name: '@ddtcorex/dsh-maestro-mobile'

Development

pnpm install        # install (pnpm@11.7.0, lockfile v9)
pnpm verify         # type-check host + client (tsc --noEmit)
pnpm test:core      # node --test tests/reconciler-core.test.ts
pnpm build          # tsc host + client && node scripts/build-client.mjs -> lib/

pnpm build is the required gate after any source change; lib/ is committed, so a change is incomplete until the build refreshes it.

Optional CDP regression probe (requires a live DSH Web on :3080):

DSH_PROBE_SESSION_ID=<id> pnpm smoke:cdp

Architecture

• Host / client split is load-bearing: src/index.ts is the intentionally empty host apply(); all browser behavior lives in src/client/.
• src/client/index.tsx injects ['slots','layout','locale','sessionLogDownload'], registers locale dictionaries, injects one <style data-plugin> tag, and registers two slots (MobileNavToggle and MobileDrawerFooter).
• Shared full-tree reconciler: reconciler-core.ts (zero-import engine) + phone-chrome.ts (a single MutationObserver driving installMobileEffect).
• Styles are concatenated base → layout → compat → misc into one tag; mobile rules target (max-width: 1023px).

License

MIT