super-dsh 0.3.1 → 0.3.2

package/superd-hub/dist/hub-route.js

@@ -130,15 +130,15 @@ export function registerHubRoute(options) {
             });
             return;
         }
-        const gateway = options.gatewayOf(agent);
-        if (gateway === undefined) {
+        const target = options.gatewayOf(agent);
+        if (target === undefined) {
             answer404(res, { error: 'unknown-agent', label: agent });
             return;
         }
         // Consume the family plumbing: the kernel forwards a native-shaped URL
         // (the kernel carries the same fence face as the carrier's own kernel).
         req.url = worldUrlOf(req.url);
-        await forwardApiCall({ gateway, label: agent, mountPath: HUB_MOUNT_PATH, requestRejection: options.requestRejection }, req, res);
+        await forwardApiCall({ gateway: target.gateway, peer: target.peer, label: agent, mountPath: HUB_MOUNT_PATH, requestRejection: options.requestRejection }, req, res);
     };
     const handleUpgrade = (req, socket, head) => {
         if (!gateUpgrade(options, req, socket))
@@ -155,8 +155,8 @@ export function registerHubRoute(options) {
             rejectUpgrade(socket, 404, JSON.stringify({ error: 'foreign-only' }), 'application/json');
             return;
         }
-        const gateway = options.gatewayOf(agent);
-        if (gateway === undefined) {
+        const target = options.gatewayOf(agent);
+        if (target === undefined) {
             rejectUpgrade(socket, 404, JSON.stringify({ error: 'unknown-agent', label: agent }), 'application/json');
             return;
         }
@@ -165,7 +165,7 @@ export function registerHubRoute(options) {
         // a heartbeat interval and a per-connection WebSocketServer; on socket
         // close it must be CLOSED (world-mux clears the heartbeat only in close),
         // or every reconnect leaks the timer plus the mux graph forever.
-        const mux = worldMuxOf(gateway);
+        const mux = worldMuxOf(target.gateway, target.peer);
         socket.once?.('close', () => {
             void mux.close().catch(() => undefined);
         });

package/superd-hub/dist/rpc.d.ts

@@ -37,6 +37,11 @@ export interface AgentRuntimeDeps {
  * ADDITIVE contract (mesh P1): the GET body gained `hub: {machineId, label,
  * version}` and every `agents` row gained `id` (a6); `available` and all
  * pre-existing agents fields are unchanged — old clients ignore the new
+ * fields, new clients read them. Live-install staleness (2026-10-18): the
+ * hub block also carries `fusion` — the fusion row's armed state — so a
+ * page that booted before super-dsh was installed can tell its own
+ * staleness apart from a flag-off deployment and reload once (switch-core
+ * `fusionReloadDecision`).
  * fields, new clients read them.
  * @param request - the incoming `/api/agent-runtime` request.
  * @param source - live runtime registry view.

package/superd-hub/dist/rpc.js

@@ -3,6 +3,7 @@ import { PACK_VERSION } from './pack-version.js';
 import { listRuntimeKeys } from './targets.js';
 import { agentLinks } from './agent-roster.js';
 import { ensureSelf } from './machines.js';
+import { fusionTransportArmed } from './fusion-transport.js';
 /** The shared-channel Fetch route path this RPC face owns. */
 export const AGENT_RUNTIME_RPC_PATH = '/api/agent-runtime';
 /** The live registry view: native plus every registered foreign context. */
@@ -27,6 +28,11 @@ function json(status, body) {
  * ADDITIVE contract (mesh P1): the GET body gained `hub: {machineId, label,
  * version}` and every `agents` row gained `id` (a6); `available` and all
  * pre-existing agents fields are unchanged — old clients ignore the new
+ * fields, new clients read them. Live-install staleness (2026-10-18): the
+ * hub block also carries `fusion` — the fusion row's armed state — so a
+ * page that booted before super-dsh was installed can tell its own
+ * staleness apart from a flag-off deployment and reload once (switch-core
+ * `fusionReloadDecision`).
  * fields, new clients read them.
  * @param request - the incoming `/api/agent-runtime` request.
  * @param source - live runtime registry view.
@@ -51,7 +57,20 @@ export async function handleAgentRuntime(request, source, deps) {
         const links = new URL(request.url).searchParams.get('mesh') === '1'
             ? agentLinks(home).filter((l) => l.machine === 'local')
             : agentLinks(home);
-        return json(200, { available, agents: links, hub: { machineId: self.id, label: self.label, version: HUB_VERSION } });
+        return json(200, {
+            available,
+            agents: links,
+            hub: {
+                machineId: self.id,
+                label: self.label,
+                version: HUB_VERSION,
+                // Additive (live-install staleness): `true` exactly while the fusion
+                // row is armed — the fact a pre-install page cannot read off its own
+                // HTML. Peers' `?mesh=1` probes ignore it (same additivity rule as
+                // every hub-block field before it).
+                fusion: fusionTransportArmed(),
+            },
+        });
     }
     // A POST that used to switch a global selector has no meaning any more:
     // the addressed world is the mount path of the request, not a shared value.

package/superd-hub/dist/switch-core.d.ts

@@ -9,6 +9,16 @@
  * roster-probe failure → revert to native + a visible toast, never a page
  * lock).
  *
+ * Live-install staleness (2026-10-18): the fusion flag global and the
+ * transport script are baked into the SERVED index, so a page that booted
+ * before super-dsh was installed runs the freshly hot-loaded client half
+ * against a stale page — `fusionPage()` reads false and every switch
+ * affordance stays hidden until a manual restart. {@link fusionReloadDecision}
+ * is the pure decision behind the client half's heal: one roster answer later,
+ * reload the page once. The transport must precede app boot (its upload hook
+ * `__DSH_FILE_UPLOAD__` is read at construction), so a client-side flag flip
+ * can never arm a stale page honestly — the page must be re-served.
+ *
  * Host-half on purpose: plain TS with every effect injected through
  * {@link SwitchHost} — no DOM, no client imports — so `test/client-switch.test.mjs`
  * imports it from `dist/` like every other host module. The client half
@@ -445,6 +455,37 @@ export interface SwitchAffordance {
  * Host-half pure logic so `test/client-switch.test.mjs` pins it from `dist/`.
  */
 export declare function switchAffordance(fusion: boolean): SwitchAffordance;
+/** The sessionStorage marker guarding the stale-page reload: one per tab session. */
+export declare const FUSION_RELOAD_MARKER = "superd.fusion-armed.reload";
+/** What the stale-page probe decides (the client binding executes it). */
+export type FusionReloadDecision = 
+/** Flag present — the page is armed; nothing to heal. */
+'armed'
+/** The marker is set — this tab already reloaded once; never loop. */
+ | 'already-reloaded'
+/** The host answered `hub.fusion: false` — the T-E flag-off shape; stay degraded. */
+ | 'row-off'
+/** No usable answer (old host without the additive field, or the fetch failed) — stay degraded. */
+ | 'host-silent'
+/** Stale page + an armed host — set the marker and reload once. */
+ | 'reload';
+/** The inputs of one stale-page probe decision. */
+export interface FusionReloadInput {
+    /** Whether the page carries the baked `__SUPERD_UI_FUSION__` flag global. */
+    flagPresent: boolean;
+    /** Whether {@link FUSION_RELOAD_MARKER} is already in sessionStorage. */
+    markerPresent: boolean;
+    /** The roster answer's additive `hub.fusion` field (undefined: absent). */
+    hubFusion?: unknown;
+}
+/**
+ * The live-install staleness decision (host-half pure so the node tests pin
+ * the table from `dist/`). The host's `hub.fusion` field is the ONLY thing
+ * that distinguishes a page-booted-before-install from a deliberately
+ * flag-off deployment — without it the reload would loop forever on every
+ * `enabled: false` composition (the client half loads there too).
+ */
+export declare function fusionReloadDecision(input: FusionReloadInput): FusionReloadDecision;
 /**
  * Structural slice of one roster row the Hub UI helpers read (the client
  * roster's `AgentLink` shape mirrored structurally — this module never imports

package/superd-hub/dist/switch-core.js

@@ -9,6 +9,16 @@
  * roster-probe failure → revert to native + a visible toast, never a page
  * lock).
  *
+ * Live-install staleness (2026-10-18): the fusion flag global and the
+ * transport script are baked into the SERVED index, so a page that booted
+ * before super-dsh was installed runs the freshly hot-loaded client half
+ * against a stale page — `fusionPage()` reads false and every switch
+ * affordance stays hidden until a manual restart. {@link fusionReloadDecision}
+ * is the pure decision behind the client half's heal: one roster answer later,
+ * reload the page once. The transport must precede app boot (its upload hook
+ * `__DSH_FILE_UPLOAD__` is read at construction), so a client-side flag flip
+ * can never arm a stale page honestly — the page must be re-served.
+ *
  * Host-half on purpose: plain TS with every effect injected through
  * {@link SwitchHost} — no DOM, no client imports — so `test/client-switch.test.mjs`
  * imports it from `dist/` like every other host module. The client half
@@ -488,6 +498,36 @@ export const FUSION_OFF_HINT = 'fusion off — no foreign entry';
 export function switchAffordance(fusion) {
     return fusion ? { available: true, hint: '' } : { available: false, hint: FUSION_OFF_HINT };
 }
+// ---- Live-install staleness: the once-per-session reload heal -------------
+//
+// The flag global is `webserver/index-inject` state: a page served BEFORE
+// the fusion row mounted never carries it, while the client graph hot-update
+// (dsh-client-hmr) still applies the client half to that page — the Hub row
+// appears, the selector does not, and only a manual restart healed it. The
+// heal re-boots the page ONCE (a sessionStorage marker keeps a host that
+// reports fusion but never bakes the flag from looping the tab), because the
+// transport script is boot-time by design: a stale page cannot be armed in
+// place, only re-served.
+/** The sessionStorage marker guarding the stale-page reload: one per tab session. */
+export const FUSION_RELOAD_MARKER = 'superd.fusion-armed.reload';
+/**
+ * The live-install staleness decision (host-half pure so the node tests pin
+ * the table from `dist/`). The host's `hub.fusion` field is the ONLY thing
+ * that distinguishes a page-booted-before-install from a deliberately
+ * flag-off deployment — without it the reload would loop forever on every
+ * `enabled: false` composition (the client half loads there too).
+ */
+export function fusionReloadDecision(input) {
+    if (input.flagPresent)
+        return 'armed';
+    if (input.markerPresent)
+        return 'already-reloaded';
+    if (input.hubFusion === true)
+        return 'reload';
+    if (input.hubFusion === false)
+        return 'row-off';
+    return 'host-silent';
+}
 /**
  * The active agent's display name for the Hub row's right-edge selector: the
  * roster label of the atom's `activeAgent` key — the name the selector's

package/superd-hub/dist/targets.d.ts

@@ -22,6 +22,13 @@ export interface ForeignTarget {
     key: string;
     /** The context's typertGateway service instance (or a wire adapter with the same face). */
     gateway: GatewayFace;
+    /**
+     * The world's owner browser Peer (connection.browserPeer) for in-process
+     * faces — DSH 0.2.1 gateways read peer.signal/principal on every forwarded
+     * invocation, so the hub must present the world's shared owner identity.
+     * Wire adapters (mesh federation) omit it: the far end supplies its own.
+     */
+    peer?: unknown;
 }
 /** Register (or replace) the target for a runtime key. */
 export declare function registerForeignTarget(target: ForeignTarget): void;

package/superd-hub/dist/world-lifecycle.js

@@ -48,7 +48,7 @@ export function ownWorld(ctx, entry, spawn, onFailure) {
                     unregisterForeignTarget(key);
                 setReady(key, false);
             }, `superd.world.${key}: availability`);
-            target = { key, gateway: world.get('typertGateway') };
+            target = { key, gateway: world.get('typertGateway'), peer: world.get('connection')?.browserPeer };
             registerForeignTarget(target);
             setReady(key, true);
             return world;

package/superd-hub/lib/client/index.js

@@ -898,6 +898,16 @@ function machineLabelsFrom(list) {
 * roster-probe failure → revert to native + a visible toast, never a page
 * lock).
 *
+* Live-install staleness (2026-10-18): the fusion flag global and the
+* transport script are baked into the SERVED index, so a page that booted
+* before super-dsh was installed runs the freshly hot-loaded client half
+* against a stale page — `fusionPage()` reads false and every switch
+* affordance stays hidden until a manual restart. {@link fusionReloadDecision}
+* is the pure decision behind the client half's heal: one roster answer later,
+* reload the page once. The transport must precede app boot (its upload hook
+* `__DSH_FILE_UPLOAD__` is read at construction), so a client-side flag flip
+* can never arm a stale page honestly — the page must be re-served.
+*
 * Host-half on purpose: plain TS with every effect injected through
 * {@link SwitchHost} — no DOM, no client imports — so `test/client-switch.test.mjs`
 * imports it from `dist/` like every other host module. The client half
@@ -1343,6 +1353,22 @@ function switchAffordance(fusion) {
 		hint: FUSION_OFF_HINT
 	};
 }
+/** The sessionStorage marker guarding the stale-page reload: one per tab session. */
+const FUSION_RELOAD_MARKER = "superd.fusion-armed.reload";
+/**
+* The live-install staleness decision (host-half pure so the node tests pin
+* the table from `dist/`). The host's `hub.fusion` field is the ONLY thing
+* that distinguishes a page-booted-before-install from a deliberately
+* flag-off deployment — without it the reload would loop forever on every
+* `enabled: false` composition (the client half loads there too).
+*/
+function fusionReloadDecision(input) {
+	if (input.flagPresent) return "armed";
+	if (input.markerPresent) return "already-reloaded";
+	if (input.hubFusion === true) return "reload";
+	if (input.hubFusion === false) return "row-off";
+	return "host-silent";
+}
 /**
 * The active agent's display name for the Hub row's right-edge selector: the
 * roster label of the atom's `activeAgent` key — the name the selector's
@@ -1621,6 +1647,53 @@ function createReadinessWaiter(faces, options = {}) {
 function fusionPage() {
 	return globalThis.__SUPERD_UI_FUSION__ === true;
 }
+/**
+* The sessionStorage marker read (undefined-safe: a storage failure is
+* `false` — the probe then reloads without the loop guard, which only
+* matters for a host that reports fusion but never bakes the flag).
+*/
+function staleReloadMarker() {
+	try {
+		return globalThis.sessionStorage?.getItem(FUSION_RELOAD_MARKER) !== null;
+	} catch {
+		return false;
+	}
+}
+/**
+* Live-install staleness probe (2026-10-18): the ONE call the client entry
+* makes when the page does not carry the fusion flag. A flag-absent page is
+* either a pre-install page (the client half hot-loaded into HTML served
+* before the row mounted — the fresh-install case where the Hub row renders
+* but every switch affordance stays hidden until a manual restart) or a
+* deliberate flag-off deployment (T-E). The roster's additive `hub.fusion`
+* answers which; on an armed host the page re-boots ONCE — the marker keeps
+* a misbehaving host from ever looping the tab. Every failure mode (fetch
+* error, non-OK, old host without the field) degrades to no action: the
+* flag-off shapes below are the honest rendering of an unanswered probe.
+*
+* Fire-and-forget by contract — never throws, never blocks the apply.
+*/
+function probeStaleFusionPage() {
+	(async () => {
+		let hubFusion;
+		try {
+			const response = await fetch("/api/agent-runtime", { credentials: "same-origin" });
+			if (!response.ok) return;
+			hubFusion = (await response.json()).hub?.fusion;
+		} catch {
+			return;
+		}
+		if (fusionReloadDecision({
+			flagPresent: fusionPage(),
+			markerPresent: staleReloadMarker(),
+			hubFusion
+		}) !== "reload") return;
+		try {
+			globalThis.sessionStorage?.setItem(FUSION_RELOAD_MARKER, "1");
+		} catch {}
+		globalThis.location?.reload();
+	})();
+}
 /** The page atom, when the page carries one (it always does on a fusion page). */
 function uiState() {
 	const state = globalThis.__SUPERD_UI_STATE__;
@@ -3880,6 +3953,38 @@ function HubPage() {
 	});
 }
 
+//#endregion
+//#region src/client/pill-geometry.ts
+/**
+* Derive the scroll-invariant offsets from one same-frame measurement.
+* Measuring the DELTAS (not absolute coordinates) is the whole point: they
+* survive any scroll of any ancestor, so nothing needs to re-run while the
+* sidebar scrolls.
+*/
+function measurePillBox(input) {
+	return {
+		dx: input.row.right - input.wrap.left,
+		cy: (input.row.top + input.row.bottom) / 2 - input.wrap.top
+	};
+}
+/** The row's own horizontal padding (native `.panelRow`): the selector's inset. */
+const PILL_ROW_INSET = 8;
+/**
+* The pill's placement, wrapper-relative: its right edge sits `inset` px
+* inside the row's right edge, vertically centered on the row
+* (`translateY(-50%)`). `selectorWidth` is the render-time pill width (the
+* mark is present only while an agent is active), so it stays a render
+* concern; the measured box is not.
+*/
+function pillStyle(box, selectorWidth, inset = PILL_ROW_INSET) {
+	return {
+		position: "absolute",
+		left: box.dx - inset - selectorWidth,
+		top: box.cy,
+		transform: "translateY(-50%)"
+	};
+}
+
 //#endregion
 //#region src/client/HubPanelIcon.tsx
 /** Runtime-mark edge inside the selector, and the chevron's own default edge. */
@@ -3893,8 +3998,6 @@ const CHEVRON_SIZE = 14;
 const SELECTOR_HEIGHT = 28;
 const SELECTOR_PAD = 8;
 const SELECTOR_GAP = 4;
-/** The row's own horizontal padding (native `.panelRow`): the selector's inset. */
-const ROW_INSET = 8;
 function HubPanelIcon({ size }) {
 	const wide = size <= 16;
 	const rootRef = react.useRef(null);
@@ -3917,16 +4020,25 @@ function HubPanelIcon({ size }) {
 	}, [fusion]);
 	const measure = react.useCallback(() => {
 		const row = rootRef.current?.closest("button") ?? null;
-		if (row === null) {
+		const wrap = selectorRef.current?.parentElement ?? null;
+		if (row === null || wrap === null) {
 			setBox(null);
 			return;
 		}
-		const rect = row.getBoundingClientRect();
-		setBox((prev) => prev !== null && prev.top === rect.top && prev.bottom === rect.bottom && prev.right === rect.right ? prev : {
-			top: rect.top,
-			bottom: rect.bottom,
-			right: rect.right
+		const rowRect = row.getBoundingClientRect();
+		const wrapRect = wrap.getBoundingClientRect();
+		const next = measurePillBox({
+			row: {
+				top: rowRect.top,
+				bottom: rowRect.bottom,
+				right: rowRect.right
+			},
+			wrap: {
+				left: wrapRect.left,
+				top: wrapRect.top
+			}
 		});
+		setBox((prev) => prev !== null && prev.dx === next.dx && prev.cy === next.cy ? prev : next);
 	}, []);
 	react.useLayoutEffect(() => {
 		if (!wide || !switchUi.available) return;
@@ -4036,7 +4148,7 @@ function HubPanelIcon({ size }) {
 		children: [
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(HubGlyph, { size }),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SuperdToastHost, {}),
-			wide && box !== null && switchUi.available && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Menu, {
+			wide && switchUi.available && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Menu, {
 				open,
 				onClose: () => {
 					setOpen(false);
@@ -4057,10 +4169,11 @@ function HubPanelIcon({ size }) {
 					"aria-expanded": open,
 					title: activeLabel === void 0 ? "Agent selector" : `Agent selector: ${activeLabel}`,
 					style: {
-						position: "fixed",
-						left: box.right - ROW_INSET - selectorWidth,
-						top: box.top + (box.bottom - box.top) / 2,
-						transform: "translateY(-50%)",
+						...pillStyle(box ?? {
+							dx: 0,
+							cy: 0
+						}, selectorWidth),
+						visibility: box === null ? "hidden" : "visible",
 						display: "inline-flex",
 						alignItems: "center",
 						justifyContent: "center",
@@ -4105,9 +4218,17 @@ const inject = ["slots"];
 * absent (a composition without the sidebar renders nothing — every seat
 * here is an optional occupant by contract).
 *
-* @param ctx - client root context.
+* Live-install staleness: the fusion flag is baked into the SERVED index, so
+* a page that booted before super-dsh was installed carries no flag even
+* though this very apply is the hot-loaded client half — the Hub row would
+* render with every switch affordance hidden until a manual restart. When
+* the flag is absent the entry probes the roster's `hub.fusion` once and
+* re-boots the page on an armed host (switch.ts `probeStaleFusionPage`; the
+* sessionStorage marker bounds it to one reload per tab session). A flag-off
+* deployment answers `false` and keeps the T-E inert shape with no reload.
 */
 function apply(ctx) {
+	if (!fusionPage()) probeStaleFusionPage();
 	ctx.inject(["slots"], (raw) => {
 		const scope = raw;
 		scope.effect(() => scope.slots.inject("main", () => scope.slots.register({