[williamloo-scale]

Stacked on #428.

packages/agentenv-protocol/examples/website/notes/: a reference site on WebsiteEnvironment, about 130 lines of Python plus a small Vite page.

• Per-user notes stamped with self.now(), auto sign-in as the acting user, and /api/admin/notes with roles=["admin"] (403 otherwise).
• The page uses relative URLs, so it works under the gateway's /website/notes/ route. A refresh keeps text typed into a note that isn't saved yet, with its focus and cursor, and the page's clock re-reads X-Universe-Now every 5 seconds, so a stopped or faster universe clock shows.
• One image: a node stage builds the page, a python stage serves it with the API on PORT, with curl for the compose health check. env.toml declares it as the server image.

Test

Unit suite and protocol tests: 12,667 passed, lint clean.

• test_website_notes_example.py: 8 passed.
• Built and ran the image: healthy, and python -m agentenv_protocol.website.conformance http://localhost:18080 --clock-host host.docker.internal passed 8/8. Pages, session, notes and the admin route checked by curl.
• In Chromium against the site: with a title's save delayed, text typed into the body stays focused through the refresh and is saved, one save per edit.
• Registered with agent-env env website put --server-dockerfile ... --health-path /healthz against local stores only.

🤖 Generated with Claude Code

Confidence Score: 5/5

The PR appears safe to merge with the checked queued-edit fixes supplied by PR #444.

Summary

Adds a Notes reference site on WebsiteEnvironment, with per-user notes, an admin-only route, a Vite page, and one server image.

• Notes users can manage their own notes, while admins can list them all.
• The Notes page keeps typing through refreshes and follows the universe clock.
• The Notes page and server build into one website image.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  Browser[Notes page] -->|Relative API calls| Site[Notes server]
  Site -->|Owner checks| Store[Per-user notes]
  Admin[Caller with admin role key] -->|Admin route| Site
  Data[Data plane] -->|Load, export, reset| Store

Loading

_{Reviews (4) · Last reviewed commit: "Merge wloo/website-environment-sdk into ..." · Reviewed by Greptile}

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​vite@​5.4.10

View full report

[socket-security]

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Priority	Alert  (click "▶" to expand/collapse)	Action
	High CVE: launch-editor: fs.existsSync() existence check can be bypassed on Windows in npm `vite` CVE: GHSA-587h-7wmj-h5pm launch-editor: fs.existsSync() existence check can be bypassed on Windows (HIGH) Affected versions: >= 8.3.0 < 8.3.3; >= 8.2.0 < 8.2.4; >= 8.0.0 < 8.1.6; >= 7.0.0 < 7.3.7; < 6.4.4 Patched version: 6.4.4 From: packages/agentenv-protocol/examples/website/notes/web/package-lock.json → npm/vite@5.4.10 ℹ Read more on: This package | This alert | What is a CVE? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Remove or replace dependencies that include known high severity CVEs. Consumers can use dependency overrides or npm audit fix --force to remove vulnerable dependencies. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/vite@5.4.10. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.	Warn

View full report