@1agh/maude 0.53.2 → 0.55.0

package/apps/studio/client/styles/3-shell-maude.css

@@ -81,6 +81,13 @@
 .st-mb-sep { width: 1px; height: 16px; background: var(--border-default); }
 .st-mb-count { display: inline-flex; align-items: center; gap: var(--space-2); font-family: var(--font-mono); font-size: var(--type-xs); color: var(--fg-1); }
 .st-mb-proj { font-family: var(--font-mono); font-size: var(--type-xs); color: var(--status-success); }
+.st-reportbug {
+  appearance: none; border: 0; background: transparent; cursor: pointer;
+  width: 26px; height: 26px; display: grid; place-items: center; border-radius: var(--radius-sm);
+  color: var(--fg-1);
+}
+.st-reportbug:hover { background: var(--bg-3); color: var(--fg-0); }
+
 .st-whatsnew {
   position: relative; appearance: none; border: 0; background: transparent; cursor: pointer;
   width: 26px; height: 26px; display: grid; place-items: center; border-radius: var(--radius-sm);
@@ -2280,12 +2287,35 @@ body.st-scrubbing, body.st-scrubbing * { cursor: ew-resize !important; user-sele
 .gi-code { display: flex; align-items: center; justify-content: space-between; gap: var(--space-3); padding: var(--space-4) var(--space-5); border: 1px solid var(--border-strong); border-radius: var(--radius-md); background: var(--bg-2); }
 .gi-code-val { font-family: var(--font-mono); font-size: var(--type-2xl); font-weight: 600; letter-spacing: 0.16em; color: var(--fg-0); }
 .gi-code-copy { flex: 0 0 auto; }
+/* the manual path out of the device dialog — always rendered, never a fallback
+   that only appears once something has already failed */
+.gi-dc-link { display: flex; flex-direction: column; gap: var(--space-2); }
+.gi-dc-link-lbl { font-size: var(--type-xs); color: var(--fg-2); }
+.gi-dc-link-row { display: flex; align-items: center; gap: var(--space-2); }
+.gi-dc-link-a { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: var(--type-xs); color: var(--accent); text-decoration: none; cursor: pointer; }
+.gi-dc-link-a:hover { text-decoration: underline; }
+.gi-dc-link-a:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
 .gi-dc-status { display: flex; align-items: center; gap: var(--space-3); font-size: var(--type-sm); color: var(--fg-2); }
 .gi-pulse { width: 9px; height: 9px; flex: 0 0 auto; border-radius: var(--radius-pill); background: var(--status-info); animation: gi-pulse 1.8s var(--ease-out) infinite; }
 @keyframes gi-pulse { 0% { box-shadow: 0 0 0 0 color-mix(in oklch, var(--status-info) 55%, transparent); } 70% { box-shadow: 0 0 0 7px transparent; } 100% { box-shadow: 0 0 0 0 transparent; } }
 .gi-dc-foot { display: flex; align-items: center; gap: var(--space-3); }
 .gi-dc-foot-note { font-size: var(--type-xs); color: var(--fg-2); line-height: var(--lh-sm); }
 
+/* maude:// decision modal — same dialog family, one job: name both sides */
+.gi-dl-pair { display: flex; align-items: stretch; gap: var(--space-3); }
+.gi-dl-side { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: var(--space-1); padding: var(--space-3); border: 1px solid var(--border-default); border-radius: var(--radius-md); background: var(--bg-2); }
+.gi-dl-lbl { font-size: var(--type-xs); color: var(--fg-2); }
+.gi-dl-val { font-family: var(--font-mono); font-size: var(--type-sm); font-weight: 600; color: var(--fg-0); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.gi-dl-arrow { flex: 0 0 auto; display: grid; place-items: center; color: var(--fg-2); }
+.gi-dl-what { margin: 0; font-size: var(--type-sm); color: var(--fg-1); line-height: var(--lh-base); }
+.gi-dl-what code { font-family: var(--font-mono); font-size: var(--type-xs); background: var(--bg-2); border: 1px solid var(--border-subtle); border-radius: var(--radius-xs); padding: 1px var(--space-1); }
+.gi-dl-note { margin: 0; font-size: var(--type-xs); color: var(--fg-2); line-height: var(--lh-base); }
+/* The warn colour rides the border + wash ONLY — `--status-warn` as text fails
+   AA at this size (DDR-097's file-tree badge fix; the ACP elicitation warning
+   carries the same note). Text stays on --fg-1/--fg-0. */
+.gi-dl-warn { display: flex; flex-direction: column; gap: var(--space-2); padding: var(--space-3); border: 1px solid var(--status-warn); border-radius: var(--radius-md); background: color-mix(in oklab, var(--status-warn) 12%, transparent); font-size: var(--type-sm); line-height: var(--lh-base); color: var(--fg-1); }
+.gi-dl-warn strong { color: var(--fg-0); }
+
 /* create / pull / share dialog */
 .cp-dialog { width: min(560px, 94vw); max-height: 88vh; }
 .cp-dialog-hd { display: flex; align-items: flex-start; gap: var(--space-3); padding: var(--space-5) var(--space-5) var(--space-4); border-bottom: 1px solid var(--border-subtle); flex: none; }

package/apps/studio/client/styles/4-components.css

@@ -1911,3 +1911,43 @@
   white-space: nowrap;
   max-width: 22ch;
 }
+
+/* …and its counterpart on the right: WHICH ACCOUNT this tab is, and the way to
+   stop being it. The email is quiet (it is context, not a control); the sign-out
+   only resolves on hover, because the common case is reading it and the rare
+   case is needing it. */
+.st-cloudwho {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+.st-cloudwho-email {
+  font-size: 12px;
+  color: var(--u-fg-2);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  max-width: 24ch;
+}
+.st-cloudwho-form {
+  display: inline-flex;
+  margin: 0;
+}
+.st-cloudwho-out {
+  font: inherit;
+  font-size: 12px;
+  color: var(--u-fg-3);
+  background: none;
+  border: 0;
+  cursor: pointer;
+  text-decoration: none;
+  white-space: nowrap;
+  border-radius: 5px;
+  padding: 2px 6px;
+}
+.st-cloudwho-out:hover,
+.st-cloudwho-out:focus-visible {
+  color: var(--u-fg-0);
+  background: var(--u-bg-2);
+}

package/apps/studio/cloud/endpoints.ts

@@ -17,10 +17,10 @@
 
 import { chmodSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
+import { basename, dirname, join } from 'node:path';
 
 import { saveHubCredential } from '../sync/hub-link.ts';
-import { normalizeUrl } from '../sync/hubs-config.ts';
+import { getHubToken, normalizeUrl } from '../sync/hubs-config.ts';
 
 /**
  * Where Maude Cloud lives, resolved PER CALL rather than at module load.
@@ -113,14 +113,28 @@ interface Ctx {
 
 export function createCloudEndpoints(ctx: Ctx) {
   return {
-    /** Signed in? Who? Cheap — reads the file, never the network. */
+    /**
+     * Signed in? Who? And WHICH folder is asking? Cheap — reads two files,
+     * never the network.
+     *
+     * `project` + `linkedHub` are the local half of the answer, and they exist
+     * for one reason: a maude:// link names a CLOUD project, and the person
+     * confirming it deserves to see which LOCAL folder is about to be attached
+     * to it. Both are already-public facts (a directory name, and the
+     * token-free `linkedHub` this same module writes into a committed
+     * config.json) — no credential material widens by being reported here.
+     */
     status(): CloudEndpointResult {
       const file = readCloudFile();
       return {
         status: 200,
-        json: file
-          ? { connected: true, email: file.email ?? null, url: file.url }
-          : { connected: false, url: cloudUrl() },
+        json: {
+          connected: !!file,
+          email: file?.email ?? null,
+          url: file ? file.url : cloudUrl(),
+          project: basename(ctx.paths.repoRoot),
+          linkedHub: readLinkedHub(),
+        },
       };
     },
 
@@ -292,6 +306,34 @@ export function createCloudEndpoints(ctx: Ctx) {
     },
   };
 
+  /**
+   * The workspace this folder already answers to, if any. Address only.
+   *
+   * `credentialed` is the half that can be trusted. `config.json` is COMMITTED
+   * and travels with the repo, so a `linkedHub` in it is attacker-authorable:
+   * publish a template pointing at your own cell and the connect dialog would
+   * cheerfully print "this folder is already linked to <you>" — the strongest
+   * reassurance it can give, produced entirely by content the person merely
+   * opened (attacker pass 2026-08-04, B2). A stored hub credential for that
+   * address is the corroboration, because only a real sign-in writes one.
+   */
+  function readLinkedHub(): { url: string; credentialed: boolean } | null {
+    try {
+      const cfg = JSON.parse(readFileSync(join(ctx.paths.designRoot, 'config.json'), 'utf8'));
+      const url = cfg?.linkedHub?.url;
+      if (typeof url !== 'string' || !url) return null;
+      let credentialed = false;
+      try {
+        credentialed = !!getHubToken(normalizeUrl(url));
+      } catch {
+        /* unreadable credential store → treat as uncorroborated */
+      }
+      return { url, credentialed };
+    } catch {
+      return null; // absent/malformed → simply not linked
+    }
+  }
+
   /** The shared tail of every attach: cell exchange → credential + linkedHub. */
   async function linkToWorkspace({
     workspaceUrl,

package/apps/studio/cloud-build.ts

@@ -0,0 +1,208 @@
+// The cloud build — Cloud Phase 27 D1: ELIMINATE, do not un-route.
+//
+// A cell already refuses every one of these surfaces three times over: the
+// route table is pruned at boot (`workspace-mode.ts`), the hub's manifest denies
+// them, and a running cell 404s all of them. That is operational containment,
+// and it is not the same claim as DDR-123's "claude never runs on our
+// infrastructure" — which is a statement about what is IN the image, not about
+// what answers. Code that is present is code that a future route, a future
+// import, or a future mistake can reach.
+//
+// WHAT MADE THIS POSSIBLE. `--define` plus dead-code elimination does not work
+// here: Bun inlines a dynamically-imported module and keeps the branch, so the
+// bytes stay (verified before writing any of this — the sentinel survived a
+// minified `--define`d build). What DOES work is substitution at build time:
+// `Bun.build({ compile })` accepts plugins, and a plugin that replaces a module
+// with an inert one removes the original from the binary entirely. Verified the
+// same way: the sentinel string is absent from the compiled artifact.
+//
+// WHAT IS NOT ELIMINATED, AND WHY. System git stays — Phase 27 D2 makes it the
+// engine a cell RUNS on, because two git engines over one index is not a race a
+// careful caller can avoid. Its presence is deliberate and is not part of the
+// secret-bearing surface: it carries no credential and spawns nothing the tenant
+// can name.
+//
+// The stubs are GENERATED from each module's own export list rather than
+// hand-written. A hand-written stub is a second copy of an interface, and the
+// day it falls behind is the day the cloud build fails to boot for a reason
+// nobody can see. Reading the real file's exports means a module that grows a
+// function still stubs cleanly.
+
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+
+/**
+ * The modules a cloud build replaces, relative to `apps/studio/`.
+ *
+ * Each line is one of the surfaces DDR-209's D1 names. Grouped by WHY, because
+ * the reason is the thing to check when deciding whether a new module belongs
+ * on this list.
+ */
+export const CLOUD_ELIMINATED = Object.freeze([
+  // The agent, and everything that starts one. DDR-123: the user's own `claude`
+  // subscription, on the user's own machine, never on ours.
+  'acp/index.ts',
+  'acp/bridge.ts',
+  'acp/login-state.ts', // the `bash -c` native installer
+  'acp/probe.ts', // resolves + trusts a `claude` binary path
+  'acp/plugin-bootstrap.ts',
+  // Shell probes — `$SHELL -ilc "command -v …"`. A login shell on a server is
+  // an execution surface with a tenant-shaped input near it.
+  'readiness.ts',
+  'design-setup-readiness.ts',
+  // The exporter's subprocess spine.
+  'exporters/_runtime.ts',
+  // BYOK: provider keys at rest, and the adapters that spend them.
+  'generation/keys.ts',
+  'generation/adapters/gemini.ts',
+  'generation/adapters/elevenlabs.ts',
+  'generation/adapters/groq.ts',
+  // Endpoints that speak to somebody else's account on the user's behalf.
+  'cloud/endpoints.ts',
+  'github/endpoints.ts',
+  // …and the REST client behind it, which `git/endpoints.ts` also reaches for
+  // its "open a pull request" verb. Stubbing only the endpoints left every
+  // GitHub API URL in the image through that second importer — found by the
+  // gate below, which is the entire reason it greps the artifact instead of
+  // trusting the list.
+  'github/service.ts',
+  'sync/hub-link.ts',
+  // The debug bundle scrubs, but it still assembles an environment report.
+  'debug-bundle.ts',
+]);
+
+/**
+ * Strings that must not appear in a cloud binary.
+ *
+ * The gate greps for these because a stub that silently failed to apply is
+ * indistinguishable from one that worked, right up until it is not. Chosen to
+ * be specific to the eliminated code rather than to any word near it.
+ */
+export const CLOUD_FORBIDDEN_STRINGS = Object.freeze([
+  'claude-agent-acp', // the ACP adapter package
+  '-ilc', // the login-shell probe
+  'application/vnd.github+json', // the REST client that speaks for a user's account
+  'generativelanguage.googleapis.com', // BYOK image generation
+  'api.elevenlabs.io', // BYOK audio generation
+]);
+
+// A NOTE ON CHOOSING THESE. They must be strings only OUR code can produce.
+// `api.github.com` looked ideal and is useless: Bun's own runtime carries
+// `GITHUB_API_DOMAIN` and `GITHUB_API_URL`, so it appears in every compiled
+// binary whatever we do. A gate that can never go green teaches people to
+// ignore it. Each string above is verified present in a desktop binary and
+// absent from a cloud one — that pair is the assertion, not the absence alone.
+
+/** Runtime-visible exports of a module — what a stub has to provide. Types and
+ *  interfaces are erased before this matters, so they are deliberately absent. */
+export function exportedNames(source: string): string[] {
+  const names = new Set<string>();
+  // Leading whitespace is allowed on purpose. The two failure directions are
+  // not symmetric: a MISSED export is a boot-time crash in the cloud binary and
+  // nowhere else, while an extra one is a duplicate `const` that fails the
+  // build loudly, at the desk of whoever caused it. So this errs greedy.
+  const patterns = [
+    /^\s*export\s+(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/gm,
+    /^\s*export\s+(?:const|let|var)\s+([A-Za-z_$][\w$]*)/gm,
+    /^\s*export\s+class\s+([A-Za-z_$][\w$]*)/gm,
+  ];
+  for (const re of patterns) {
+    for (const m of source.matchAll(re)) if (m[1]) names.add(m[1]);
+  }
+  // `export { a, b as c }` — the re-export form.
+  for (const m of source.matchAll(/^\s*export\s*\{([^}]*)\}/gm)) {
+    for (const part of (m[1] ?? '').split(',')) {
+      const alias = part
+        .split(/\s+as\s+/i)
+        .pop()
+        ?.trim();
+      if (alias && /^[A-Za-z_$][\w$]*$/.test(alias) && alias !== 'default') names.add(alias);
+    }
+  }
+  return [...names];
+}
+
+/**
+ * The inert value every stubbed export becomes.
+ *
+ * A self-returning proxy rather than `() => {}` or `null`, because the callers
+ * are not all the same shape: one boot path calls `createExportJobQueue(...)`
+ * and hands the result to the route table, another calls `installLogRing()` for
+ * its side effect, a third reads a property off what `createAcp` returned. A
+ * value that answers every one of those with another inert value cannot crash a
+ * boot on a shape nobody remembered.
+ *
+ * It is deliberately NOT thenable: `await inert` must yield the proxy, not hang
+ * forever waiting for a `then` that never resolves.
+ */
+const INERT_SOURCE = `
+const inert = new Proxy(function cloudEliminated() {}, {
+  get(_t, key) {
+    if (key === 'then') return undefined;
+    if (key === Symbol.toPrimitive || key === 'toString') return () => '';
+    if (key === Symbol.iterator) return function* () {};
+    return inert;
+  },
+  apply: () => inert,
+  construct: () => inert,
+});
+`;
+
+/** Build the replacement source for one eliminated module. */
+export function stubSource(original: string): string {
+  const names = exportedNames(original);
+  const decls = names.map((n) => `export const ${n} = inert;`).join('\n');
+  return `${INERT_SOURCE}\n${decls}\nexport default inert;\n`;
+}
+
+/**
+ * The Bun plugin. Pass it to `Bun.build({ plugins: [cloudStubPlugin(root)] })`.
+ *
+ * `onLoad` rather than `onResolve`: the module still resolves to its real path
+ * (so a typo in the list is a build error rather than a silent no-op), and only
+ * its CONTENTS are replaced.
+ */
+export function cloudStubPlugin(studioRoot: string): import('bun').BunPlugin {
+  const targets = new Set(CLOUD_ELIMINATED.map((rel) => path.join(studioRoot, rel)));
+  const applied = new Set<string>();
+
+  // A LISTED PATH THAT DOES NOT EXIST IS A BUILD FAILURE, NOT A LOG LINE.
+  //
+  // The plugin matches by exact resolved path, so a rename, a move to `.tsx` or
+  // a typo silently stops eliminating that module — and the "never imported"
+  // notice below reads as ordinary, because it IS ordinary when a leaf leaves
+  // the graph with its stubbed importer. The two cases are indistinguishable at
+  // the end of a build, so they are distinguished HERE, where one of them is
+  // simply a path that is not on disk.
+  const missing = CLOUD_ELIMINATED.filter((rel) => !existsSync(path.join(studioRoot, rel)));
+  if (missing.length) {
+    throw new Error(
+      `cloud build: ${missing.length} module(s) in CLOUD_ELIMINATED do not exist — ` +
+        `a rename or a typo means they are NOT being eliminated: ${missing.join(', ')}`
+    );
+  }
+  return {
+    name: 'maude-cloud-eliminate',
+    setup(build) {
+      build.onLoad({ filter: /\.ts$/ }, (args) => {
+        if (!targets.has(args.path)) return undefined;
+        applied.add(args.path);
+        return { contents: stubSource(readFileSync(args.path, 'utf8')), loader: 'ts' };
+      });
+      build.onEnd?.(() => {
+        // A module on the list the graph never reached is USUALLY success, not
+        // drift: stubbing `acp/index.ts` takes `acp/bridge.ts` out of the graph
+        // with it, so the leaf is eliminated by the same stroke and never gets
+        // loaded. Reported at info level for exactly that reason — it is worth
+        // seeing (a typo'd path looks identical) and it is not a failure.
+        const unused = [...targets].filter((t) => !applied.has(t));
+        if (unused.length) {
+          console.log(
+            `[cloud-build] ${unused.length} listed module(s) left the graph with their importer ` +
+              `(or are no longer imported at all): ${unused.map((u) => path.basename(u)).join(', ')}`
+          );
+        }
+      });
+    },
+  };
+}

package/apps/studio/collab/room.ts

@@ -41,6 +41,18 @@ export interface RoomConn extends CollabConn {
    * default can't silently swallow a future canvas path.
    */
   realm?: 'main' | 'canvas';
+  /**
+   * Cloud collab lane (RCA issue-cloud-live-collaboration-dead) — true when
+   * this socket was opened under a read-only role (a cell's `viewer`, or a
+   * cell socket the proxy did not vouch). A read-only conn still receives every
+   * broadcast and publishes awareness — presence for viewers is the point of
+   * the channel — but its SYNC writes are gated to the comment lane, mirroring
+   * the role matrix (`viewer.comment === true`) the same way the inspector
+   * channel's `comments-patch`/`comments-delete` gate does. Absent defaults to
+   * writable ON PURPOSE, for the same reason `realm` defaults to trusted:
+   * every pre-existing caller is a loopback desktop peer.
+   */
+  readOnly?: boolean;
 }
 
 export interface RoomCallbacks {
@@ -194,8 +206,30 @@ export function createRoom(slug: string, callbacks: RoomCallbacks): Room {
   }
 
   /**
-   * Canvas-realm frame path. Awareness frames are unchanged (cursors/presence
-   * are ephemeral and already server-attributed). Sync frames are gated.
+   * Which lanes this conn's sync writes may not touch.
+   *
+   * Two independent dimensions, both fail-closed on `<unresolved>`:
+   *   - realm 'canvas' (DDR-122): body lanes are never writable from the
+   *     untrusted canvas origin, whoever is connected.
+   *   - readOnly (cloud collab lane): only the comment lane is writable — the
+   *     WS mirror of the role matrix's viewer capability.
+   */
+  function refusedLanes(conn: RoomConn, roots: ReadonlySet<string>): string[] {
+    const refused: string[] = [];
+    for (const r of roots) {
+      if (conn.realm === 'canvas' && (isBodyLane(r) || r === '<unresolved>')) {
+        refused.push(r);
+        continue;
+      }
+      if (conn.readOnly === true && r !== 'comments') refused.push(r);
+    }
+    return refused;
+  }
+
+  /**
+   * Gated frame path — canvas-realm and/or read-only conns. Awareness frames
+   * are unchanged (cursors/presence are ephemeral and already
+   * server-attributed). Sync frames are gated.
    */
   function receiveGated(conn: RoomConn, payload: Uint8Array): void {
     if (readMessageType(payload) !== MESSAGE_SYNC) {
@@ -216,14 +250,16 @@ export function createRoom(slug: string, callbacks: RoomCallbacks): Room {
     // Fail closed on anything we could not positively classify — a probe that
     // threw, or a root type we could not resolve to a name.
     const roots = probeRoots ?? new Set<string>();
-    const refused = [...roots].filter((r) => isBodyLane(r) || r === '<unresolved>');
+    const refused = refusedLanes(conn, roots);
     if (probeThrew || refused.length > 0) {
       gateRefusalCount += 1;
       discardMirror();
       console.warn(
-        `[collab/${slug}] origin gate REFUSED a canvas-realm sync frame ` +
-          `(lanes: ${refused.join(', ') || 'unclassifiable'}). Untrusted canvas script may ` +
-          `not write canvas source — see DDR-122 follow-up / collab/origins.ts.`
+        `[collab/${slug}] origin gate REFUSED a ${conn.readOnly ? 'read-only' : 'canvas-realm'} ` +
+          `sync frame (lanes: ${refused.join(', ') || 'unclassifiable'}). ` +
+          (conn.readOnly
+            ? 'A viewer-role socket may only write comments — role matrix, cloud collab lane.'
+            : 'Untrusted canvas script may not write canvas source — see DDR-122 follow-up / collab/origins.ts.')
       );
       // Re-assert server truth to that peer so it converges on the authoritative
       // state instead of silently diverging. Their locally-authored body items
@@ -315,7 +351,7 @@ export function createRoom(slug: string, callbacks: RoomCallbacks): Room {
   }
 
   function receive(conn: RoomConn, payload: Uint8Array): void {
-    if (conn.realm === 'canvas') {
+    if (conn.realm === 'canvas' || conn.readOnly === true) {
       receiveGated(conn, payload);
       return;
     }

package/apps/studio/context.ts

@@ -115,16 +115,23 @@ export interface Paths {
 
 // Tiny pub-sub bus. Lazy — modules subscribe with on('selected', fn) and emit
 // the matching event. Avoids cycling imports between inspect.ts <-> ws.ts.
+/** Who an event is about, when that matters — Cloud Phase 27 D3. A `session`
+ *  scopes a broadcast to one member of a cell; absent means everyone, which is
+ *  every event this bus carried before and every event on a desktop. */
+export interface BusMeta {
+  session?: string;
+}
+
 export interface Bus {
   // biome-ignore lint/suspicious/noExplicitAny: heterogeneous pubsub — subscribers annotate their own payload shape.
-  on(evt: string, fn: (payload: any) => void): () => void;
+  on(evt: string, fn: (payload: any, meta?: BusMeta) => void): () => void;
   // biome-ignore lint/suspicious/noExplicitAny: heterogeneous pubsub — emitters supply their own payload shape.
-  emit(evt: string, payload?: any): void;
+  emit(evt: string, payload?: any, meta?: BusMeta): void;
 }
 
 export function createBus(): Bus {
   // biome-ignore lint/suspicious/noExplicitAny: subscribers are typed at the call site; the bus stores the erased type.
-  const subs = new Map<string, Set<(p: any) => void>>();
+  const subs = new Map<string, Set<(p: any, meta?: BusMeta) => void>>();
   return {
     on(evt, fn) {
       const set = subs.get(evt) ?? new Set();
@@ -132,12 +139,12 @@ export function createBus(): Bus {
       subs.set(evt, set);
       return () => set.delete(fn);
     },
-    emit(evt, payload) {
+    emit(evt, payload, meta) {
       const set = subs.get(evt);
       if (!set) return;
       for (const fn of set) {
         try {
-          fn(payload);
+          fn(payload, meta);
         } catch (err) {
           console.error(`[bus] subscriber for ${evt} threw:`, err);
         }