[kostandinang]

🌟 Purpose

Petrinaut's Actual Mode still names its only host. ActualModeSource is { kind: "brunch"; endpoint; runId? }, the shared context carries Brunch's raw SSE events so the Events tab can export them, and the docs and AI context describe Brunch. A flow run can't be a source without pretending to be Brunch.

This PR makes the interface generic without changing how Actual Mode works. The host still supplies the net, the initial marking and the transition firings, in the same shapes. Only the source changes, the raw stream export goes, and so does the website's Brunch Actual Mode route, which nothing produces a stream for any more.

🔍 Changes

• ActualModeSource is now { id: string; label?: string }, and Petrinaut treats both as opaque. A new id starts a new timeline, and label is kept in recordings. The execution frame's sourceId is built from id.
• receivedEvents leaves the shared context, along with the raw events recording type and helper.
• The Events tab's Export Stream becomes Export Recording, and always downloads Petrinaut's recording: the net, its initial state and the firings. It used to save the raw SSE frames instead whenever the host passed them.
• The recording version stays at 1. There are no older recordings to read, so the new source shape replaces the old one in place.
• The website's /brunch route, its stream adapter in src/main/app/brunch-demo/, and the yarn brunch:fixture script are removed, with their README section and arch-docs mentions. The website's Brunch AI assistant is untouched.
• The Actual Mode docs and the AI context description are written for any host.

⚠️ Known issues

• No host in the repo provides Actual Mode until the next one is added.
• The AI assistant's Brunch UI is untouched: [EXAMPLE PR] FE-2044: Use the assistant plugin API in Brunch's chat #10105 moves Brunch's chat into its website plugin, and FE-1776: Let the assistant panel render nothing without a plugin assistant #10106 removes the built-in chat. brunchDemoMode in the user settings provider is left too, since it's dropped the next time settings are saved.
• Left for follow-up work: Actual Mode in PetrinautPreview, places inside subnet instances, coloured tokens, and the O(n²) marking replay.

🛡 Tests

• Unit tests cover the new source in recordings, in the execution frame's sourceId, and in the Events tab.
• Typecheck, lint and tests pass for @hashintel/petrinaut-core, @hashintel/petrinaut and @apps/petrinaut-website.
• Searching libs/@hashintel/petrinaut and libs/@hashintel/petrinaut-core for brunch, sse and EventSource (any case) only finds AI assistant code and docs, brunchDemoMode and its tests, and an example plugin id in a comment.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
hash	Ready	Preview	Oct 21, 2026 7:44am UTC
petrinaut	Ready	Preview	Oct 21, 2026 7:44am UTC
petrinaut-docs	Ready	Preview	Oct 21, 2026 7:44am UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
hashdotdesign-tokens	Ignored	Preview	Oct 21, 2026 7:44am UTC

[cursor]

PR Summary

Medium Risk
Breaking public Actual Mode types and exports, and removes the /brunch demo route hosts may have relied on for integration testing.

Overview
Actual Mode is no longer Brunch-shaped in core and UI. ActualModeSource becomes opaque { id; label? }, receivedEvents and raw SSE event recordings are removed from context and exports, execution sourceId keys off id, and the Events tab always offers Export Recording (normalized net + marking + firings) instead of Export Stream.

The petrinaut-website Brunch Actual Mode demo is deleted: /brunch, the brunch-demo stack (SSE provider, parsers, route), the brunch-sse-fixture script, and the brunch:fixture npm script. Example URL docs drop the /brunch baseline exception; arch docs no longer list Brunch as a streamed-definition reference route.

User-facing and core README/docs describe host-supplied execution generically rather than Brunch/SSE.

^{Reviewed by Cursor Bugbot for commit 4ec55b0. Bugbot is set up for automated code reviews on this repo. Configure here.}

[CiaranMn]

My main suggestion is to get rid of more code to cut down on future maintenance burden – any reason to keep the old-Brunch SSE stuff around in petrinaut-website?

[kostandinang]

My main suggestion is to get rid of more code to cut down on future maintenance burden – any reason to keep the old-Brunch SSE stuff around in petrinaut-website?

Kept it on purpose as a reference host for now, since it's the only way to try Actual Mode by hand until flow runs can be shown there (noted under Known issues in the description). Planned deleting in follow-up once that lands, but happy to delete it in this PR too.

[kostandinang]

Done in 4ec55b0: removed /brunch, the brunch-demo adapter and the fixture script