[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

This PR appears safe to merge; no new actionable issue remains.

Summary

Adds a shared browser client and commands to create and run website environments locally.

• Website pages share a client for API calls, sign-in, and universe time.
• The website command creates a starter project with editable routes and a web app.
• The website dev command runs a site with reload and a local clock.
• Website registration uses the site's readiness declaration by default.

Diagram

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

Loading

_{Reviews (13) · Last reviewed commit: "fix(website): a new site's page reloads ..." · Reviewed by Greptile}