This repository has been archived on 2026-10-08. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
maestro/web
naps62-yoloandClaude Opus 4.7 a671e15114
ci / rust (push) Failing after 7m28s
feat(maestro): daemon WS /api/events for live catalog updates (NAP-248)
New module `local_events::LocalEventBus` (broadcast<RegistryEvent>) with
two publishers:

* `spawn_session_publisher` — translates SessionManager's own session
  events into the matching `RegistryEvent` variants (with daemon_id
  filled in for the SessionRemoved case).
* `CatalogMirror::apply` — re-publishes peer events after applying them
  to the local mirror, so subscribers see the post-apply state.

New `WS /api/events` route on the daemon: subscribes to the bus, sends
an initial `Snapshot` built from manager.snapshot() ∪ catalog state,
then forwards live deltas. `Lagged` follows the registry's convention
(client resyncs via REST).

Revert the REST-seed hack in web/src/events.ts — the WS endpoint now
exists, so `CatalogStore::start()` can go back to just `connect()`.

E2E: subscribe to a daemon's events WS, expect Snapshot then a
SessionAdded after POSTing /api/sessions.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 22:01:08 +00:00
..

maestro-web

Browser UI for Maestro. Connects to the registry HTTP/WS API for the catalog and to individual daemons (via direct WebSocket) for terminal I/O.

Framework choice: vanilla TypeScript

No frontend framework. The UI is small enough that the cost of pulling in Preact / Solid / Leptos doesn't pay back. xterm.js does all the heavy rendering; everything else is a session tree and a spawn form, both trivial in plain DOM.

This decision is non-architectural — swap in a framework later without touching the registry or daemon if needed.

Layout

src/
  main.ts        # entry point, hash-route dispatch
  api.ts         # registry HTTP API client
  events.ts      # `/api/events` WebSocket subscriber
  catalog.ts     # session tree view (groups by metadata.label)
  attach.ts     # xterm.js + daemon WS attach view
  spawn.ts       # spawn-session modal
  types.ts       # mirror of `maestro-protocol` JSON shapes
  styles.css     # mobile-first base styles

Routing is hash-based:

  • #/ → catalog
  • #/attach/<session-id> → terminal

This keeps the registry's static handler dumb (no SPA fallback needed). Concurrent attaches: open the same #/attach/<id> URL in another tab.

Dev

pnpm install
pnpm dev      # http://localhost:5173, proxies /api → http://127.0.0.1:8080
pnpm build    # → dist/, embedded into the registry binary at cargo build time

The Vite dev server proxies /api and the events WebSocket to a maestro-registry. Default is http://127.0.0.1:8080; point it elsewhere by exporting MAESTRO_REGISTRY before pnpm dev:

MAESTRO_REGISTRY=https://maestro-registry.example.com pnpm dev
# Daemon-facing URL also works — `wss://...` is rewritten to `https://...`
# and a trailing `/daemon` is stripped.
MAESTRO_REGISTRY=wss://maestro-registry.example.com/daemon pnpm dev

Direct daemon WS connections (for attach) bypass the proxy and use the URL returned by GET /api/sessions/:id/connect-info.

Production

pnpm build writes the bundle to web/dist/. The Rust registry crate embeds that directory via rust-embed at compile time and serves it from /. See crates/maestro-registry/src/web_assets.rs.