Skip to content

docs(agents): add mermaid part kind, drop stale firstHtml ref #59

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
benvinegar merged 1 commit into from
Jun 18, 2026
+6 −4
Merged

docs(agents): add mermaid part kind, drop stale firstHtml ref #59

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .changeset/legal-nights-work.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
---
---
8 changes: 4 additions & 4 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ _use_ a running sideshow lives in `guide/AGENT_SETUP.md`, served at `/setup`.)
## What this is and why

A live visual surface for terminal coding agents: agents publish surfaces
(multi-part cards — html, markdown, diff, terminal, image) over
(multi-part cards — html, markdown, diff, terminal, image, mermaid) over
CLI/MCP/HTTP; the user watches them render in a browser and comments back. The
two-way loop — publish → live render → comment → revise/reply — is the product.
When in doubt, optimize for the loop.
Expand All @@ -33,8 +33,8 @@ consciously, not as a side effect):
(`/api/assets`, `/a/:id`), and the shared flow functions both REST and MCP call.
- `server/types.ts` — data model + `Store` interface; no runtime imports. A
surface is an ordered list of parts (`html` | `markdown` | `diff` | `terminal`
| `image`); a snippet is sugar for a single html part.
`firstHtml`/`htmlPart` bridge the legacy snippet shape. Assets (uploaded blobs)
| `image` | `mermaid`); a snippet is sugar for a single html part.
`htmlPart` bridges the legacy snippet shape. Assets (uploaded blobs)
are a separate entity, referenced by `image` parts; `selectEvictions`
is the reference-aware LRU policy.
- `server/public.ts` — the `sideshow/server` package export (`createApp`,
Expand All @@ -44,7 +44,7 @@ consciously, not as a side effect):
and both migrate legacy `snippets`/`snippetId` data to surfaces on load.
- `server/surfacePage.ts` — sandboxed document for one html part: CSP allowlist
and the postMessage bridge (resize, sendPrompt, openLink). Only html parts
reach here — markdown, diff, terminal, and image parts are data the
reach here — markdown, diff, terminal, image, and mermaid parts are data the
viewer renders natively, never markup in the sandbox.
- `server/mcpHttp.ts` — stateless MCP at `/mcp`. `mcp/server.ts` — stdio MCP,
a thin client over the HTTP API (passes response fields through untouched).
Expand Down
Loading