[williamloo-scale]

Stacked on #445.

Authoring tools for SDK sites.

• site-client.js (with .d.ts), shipped in the protocol package: api(), universeNow() from X-Universe-Now, followUniverseClock(), which re-reads it from the health path so an idle page follows a stopped or faster clock, session(), signIn(), signOut(), errors as ApiError. Notes uses a copy, which a test keeps identical.
• agent-env env website new NAME scaffolds a site like Notes: site.py, seed, a Vite web/ with the client, Dockerfile, env.toml, README. --from-mcp reads an MCP server's tools from its source (AST, without running it) and --from-tools-json from a tools/list answer; each tool becomes a stub route answering 501.
• agent-env env website dev runs a site locally without Docker: vite build --watch, uvicorn reload, and a local clock with the gateway's /clock routes. Each reload is synced to the clock and seeded, and conformance runs once.

A scaffolded image installs the protocol from PyPI, so it needs a protocol release with these changes.

Test

Unit suite: 12,814 passed (one GitHub-clone test from main, which hangs on the local machine on main too, deselected). Generated sites pass the conformance check in the tests.

🤖 Generated with Claude Code

Confidence Score: 5/5

The PR appears safe to merge; no new blocking issue was found.

Summary

Adds browser helpers and commands for creating and developing website environments.

• Website pages can share API, session, and universe-time helpers.
• website new creates a starter site from a name or tool list.
• website dev runs a site with live reload, a local clock, and seed data.
• Website registration no longer sets a default health path.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  New["env website new"] --> Files["Site, seed, web files, Dockerfile"]
  Dev["env website dev"] --> Build["Build and watch web files"]
  Dev --> Server["Serve site with reload"]
  Dev --> Clock["Local clock"]
  Server --> Poll["Detect each server boot"]
  Poll --> Sync["Sync clock and load seed"]
  Sync --> Check["Run conformance once"]
  Check --> Restore["Restore local clock and seed"]

Loading

_{Reviews (15) · Last reviewed commit: "refactor(website): env website new no lo..." · Reviewed by Greptile}