[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 blocking findings remain.

Summary

Adds browser helpers and commands for creating and running website environments locally.

• Authors can scaffold a starter website from a name or tool list.
• Authors can run a website locally with reload, a clock, and seeded data.
• Website pages can share browser helpers for API calls, sessions, and time.
• Website deploys use site-card readiness by default and keep health paths as a fallback.

Diagram

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

Loading

_{Reviews (17) · Last reviewed commit: "fix(website): the browser client reports..." · Reviewed by Greptile}