super-dsh 0.3.1 → 0.3.2-d

package/remote/provenance.json

@@ -3,32 +3,37 @@
   "entry": "better-dsh/src/remote/plugin.ts",
   "workerEntry": "better-dsh/src/remote/file-worker.ts",
   "sources": {
-    "better-dsh/src/remote/agent-registration.ts": "459301354ea1ab713984bb01bc491a080256d4e983e55ff074e2665c3213d355",
+    "better-dsh/src/remote/agent-registration.ts": "cb08eb9f5d592201054410da69b3bf383e2604899d9494a8cbd8ba2f86b3f7ad",
     "better-dsh/src/remote/archive.ts": "fd32f96dc63421be7d56eb545badf355c6ee2498599605ffa48958b9efca9a63",
-    "better-dsh/src/remote/copy.ts": "bd6f290d3f8ec3e33f9980f160b26390a3be38ead891b81de7cf610940a7af87",
-    "better-dsh/src/remote/driver.ts": "f56d68f0eded0f4c145f6442170630a5f38d2e2a340be717adc97380d5a463ce",
-    "better-dsh/src/remote/endpoints.ts": "315b6c37e6e5dbd51301aa971566b8345593560e1f2ba299e71143e147a8a17c",
+    "better-dsh/src/remote/copy.ts": "ab2aec5ee8df814f4bc568370977d229c402489248c738eff147431a52650c52",
+    "better-dsh/src/remote/driver.ts": "89a690159bc64056c6b740ae76722b13a922f36cb2fc908adbbe2ccce1b9ebb3",
+    "better-dsh/src/remote/endpoints.ts": "e4ab0fa1afcee815ad78976eba4036e2ed2b21eaea11f7451874b56229f12eac",
     "better-dsh/src/remote/file-worker.ts": "31ac019a944cf7fdcd0ff044f8b330d923bf4d384c77056f9b7e3032bc8c9598",
-    "better-dsh/src/remote/hub-contract.ts": "4bd333f3ef3e94305a64f04c03948a9dae4bbf5268b0d26d9de99770be2d8ac9",
-    "better-dsh/src/remote/input.ts": "7e543adb0973c25cbd24103c2d838db0fdacdd32525278d789004fc237dcd924",
-    "better-dsh/src/remote/jobs.ts": "9587f2694426fcf00ff33d9db164d5b15ea659aed7dbcb1df2640fa3f08b2149",
-    "better-dsh/src/remote/native-copy.ts": "49e1e1384c05637421f62d0eb562d9d5dfe00185ff2f6a15ae71d6881546d7fd",
-    "better-dsh/src/remote/nonce-framing.ts": "5592fec76cec0c1e1ac75f4806d0904cd111bf2061b1fada4f0dfa12014d1233",
+    "better-dsh/src/remote/helper.ts": "789a802610fc480bb1c922dd284787ca22d7394fa906c729ee33d78ade79973c",
+    "better-dsh/src/remote/hub-contract.ts": "a7ae5501c4ffe63ced1526c2d64d7d83798fc2025f9b4aea998e033a124fe598",
+    "better-dsh/src/remote/hub-pty-pump.mjs": "dfe0cb331cc585eb4d858fbb6d8f3ff22414f3ee55109c933df0fc14502aee5c",
+    "better-dsh/src/remote/input.ts": "dfe087d34e9e9aefc0d8ec2e33371dc86981b05723d436419ad1afb6ac8426b4",
+    "better-dsh/src/remote/jobs.ts": "4556bd9f30580a8bf90800c7a945282e276abb548df6db7fe95e7091bb1543c6",
+    "better-dsh/src/remote/labels.ts": "d9dcfdc1c6bb292b37d3250e7897b239c416b55b3102943bcc4f1d0ce7d2e709",
+    "better-dsh/src/remote/native-copy.ts": "3f8691abb14dfb7a94e956956fb4d182b7732ffbe70f1a8ff7dec5dd2b9afb7c",
+    "better-dsh/src/remote/nonce-framing.ts": "e2590293fe44c2997f6d65e0d6828aa67e51e0fc6d12cb71726063eec2f922b2",
     "better-dsh/src/remote/oneshot.ts": "99f2c809ba1159c7865ec3cff2e6d7b1f165a7f03185a6fc9505c1a534ba57bc",
     "better-dsh/src/remote/output-ring.ts": "a79104bd3dcddab06a3fe7e52d239a70becd4f2dcddd0c9b6513f5fe3c4ed0bc",
-    "better-dsh/src/remote/plugin.ts": "43fac84f229dda3bf11edb96864ed979d29bdebe5342d861d3520593844eb92b",
+    "better-dsh/src/remote/plugin.ts": "058c35172c32b347b14d5ea6db89234ccdde6f13d94eea550c5f2b8f31726288",
     "better-dsh/src/remote/process.ts": "f4491c76457b662703e0b1e4a876299b9c8b7b3da5b304c6baee5576017de448",
-    "better-dsh/src/remote/pty-session.ts": "8ea63b3357c681c5dcacacbfb99da532cae8ed293482e7a54c0362b0f9f27a3d",
-    "better-dsh/src/remote/roster.ts": "753803521accb7a5eacc19a9bada648af8ee5fc67a152247915b92e9ddeb6887",
-    "better-dsh/src/remote/rsync.ts": "21f10f0a24fd5148e298c938aaabeff85c96becc76317a1d3cc5c2e8a517c7c0",
+    "better-dsh/src/remote/pty-session.ts": "3cb07345b90f0e54cbcea00204ae0b5346d9bb6edf3a784f009fc1b07357f799",
+    "better-dsh/src/remote/roster.ts": "b84f75edc87550bb96803042487cfd7c39135b1710ff9715dd5ca402df0aa378",
+    "better-dsh/src/remote/rsync.ts": "f9c15279fdfa67b3265eeda216bcd0c46d8b4f05c6026cf2750a1c818ff333ba",
+    "better-dsh/src/remote/ssh-argv.ts": "e7f46ef3e53eaba6cfe92033afad046435db18b0b2f4b86832353d609c535662",
     "better-dsh/src/remote/ssh-config.ts": "71ce833be5c934430e8a9ca982af055fccb71d6c3e64513ae83e7937b070e446",
     "better-dsh/src/remote/ssh-process.ts": "9b4d754af5af0fe6a903e683642e94842f8662358b72467d41f2288e1e67fd79",
-    "better-dsh/src/remote/ssh-rsync-native-relay.ts": "3376cd389f11c6057408709ac65a58c8922ba04fd0b226feff5be8a84b6b04b5",
-    "better-dsh/src/remote/ssh-targets.ts": "d463357d03fec88f9cdc3c47bba85ae9213f2641b2c08689fe9a7af42fe8bcd4",
-    "better-dsh/src/remote/status.ts": "54264917bd50401c5a2f2ff9df325af7a5e790597e6307fcdc46a8455d18b530",
-    "better-dsh/src/remote/target.ts": "965a04b3561aa56ee089876a869fd2116b1773ef34b053b3006905fcde063a43",
-    "better-dsh/src/remote/tool.ts": "a9a17c37a9554e1184a644160c5677eac08fced8e89358fce60092c86cfb142f",
-    "better-dsh/src/remote/transports.ts": "c7dbe00f827aee9925146667a9a9f331527c3c1867d6f7f2a0ceedebcce1e225",
+    "better-dsh/src/remote/ssh-rsync-native-relay.ts": "5d9585ab30a11aeeba19ce7b43aa31f47e2ee0bde2e7c006ac3e811cf7940bdf",
+    "better-dsh/src/remote/ssh-targets.ts": "2a7e754fc26cf34e05ffb5d7f7406f35c09fd0770684db904dbf4c56d2c00beb",
+    "better-dsh/src/remote/status.ts": "e144c1cf98388dbaca8dab5622e6e37ceac85d898119e37d07f88e129113a82e",
+    "better-dsh/src/remote/target.ts": "bce47c6c61975a52e5cb77a6b727f68cbe78ecdcb3866c237fb932444ecc954e",
+    "better-dsh/src/remote/tool.ts": "e2dda347880a8787196720e71f32da473f9135ba6ab9a21cb22a7241628c0744",
+    "better-dsh/src/remote/transfer-tool.ts": "d02b216a31314e98fdf6933230b57adce58b9c8aebe9798aae7be808105b41e2",
+    "better-dsh/src/remote/transports.ts": "8a7190d6013f12901d9007e6b30708645baa4aa0770fcb1087ae6fcde656a8d0",
     "better-dsh/third_party/schemastery/lib/index.cjs": "aca1c1a47c7b6034feee01501aefca3e6dd97a0bac4fe334fd30647ae5a9e480",
     "better-dsh/third_party/schemastery/lib/index.d.mts": "66847f605af58c42575333c825eefdec4ad38278ad6cb260e37aa0cc63803bbd",
     "better-dsh/third_party/schemastery/lib/index.mjs": "cfcbe46c7416bdb35ce891c252152bbf519e08199bede5930dd7cb880c65f1ef",
@@ -56,7 +61,17 @@
   },
   "outputs": {
     "file-worker.js": "f84f5b48de915949d85c3d0340a343cc5901218c3bc2dafdf5cecaa244f7b6e3",
-    "plugin.d.ts": "a1ea4b56c323bb1409c72160ccb75c54e6cfa73fb790505f51dce78caa148966",
-    "plugin.js": "c5ff1c08b5548609517adaec736238425ee1753a4b65385c226af581f3508f70"
+    "helper-bin/MANIFEST.json": "efce4956d5c23f7916f48218b81848717a425ccf78ebeb6fcc7c788015250884",
+    "helper-bin/aarch64-apple-darwin/BUILT-VER": "8601d3c2ff79795c9657b02080afffe91c42775534dd6687c6dbdc0f4924db70",
+    "helper-bin/aarch64-apple-darwin/superd-run": "a8fd11a5e6a2cb146deb599414434a299ebf78c53cfc1d3e5f42617ee11c1706",
+    "helper-bin/aarch64-unknown-linux-musl/BUILT-VER": "8601d3c2ff79795c9657b02080afffe91c42775534dd6687c6dbdc0f4924db70",
+    "helper-bin/aarch64-unknown-linux-musl/superd-run": "3a8660fa099f1e71de6e08313ee2aaace00503f74365475ee46e2d2a89228397",
+    "helper-bin/x86_64-pc-windows-gnu/BUILT-VER": "8601d3c2ff79795c9657b02080afffe91c42775534dd6687c6dbdc0f4924db70",
+    "helper-bin/x86_64-pc-windows-gnu/superd-run.exe": "1372450238c5bda702b4529f4148aa79e80a255c3c125d1a6229afd4693e9d90",
+    "helper-bin/x86_64-unknown-linux-musl/BUILT-VER": "8601d3c2ff79795c9657b02080afffe91c42775534dd6687c6dbdc0f4924db70",
+    "helper-bin/x86_64-unknown-linux-musl/superd-run": "05b428657942abf22a0ad609433d5cab6b6182fe389851345459a0274b5a6533",
+    "hub-pty-pump.mjs": "dfe0cb331cc585eb4d858fbb6d8f3ff22414f3ee55109c933df0fc14502aee5c",
+    "plugin.d.ts": "92ea2007e5eb9907031de1cf0c53b30758804def9ebb957900cd3fb58d92be90",
+    "plugin.js": "c98040cb2f1e9d4e15f1c0aa61d3b0213e9281aa254baff92ab40549e0e22d48"
   }
 }

package/superd-hub/dist/a2a-host.d.ts

@@ -10,6 +10,14 @@ export interface A2aHostOptions {
      * ({@link bridgeTypertGateway}).
      */
     nativeGateway?: RawTypertGatewayFace;
+    /**
+     * LAZY provider of ctx0's owner browser Peer (connection.browserPeer) —
+     * 0.2.1 gateways read peer.signal/principal on every invocation. A
+     * provider, not a value: typertGateway mounts before connection, so a
+     * wiring-time read would capture undefined forever; resolution happens
+     * per call, when connection is long live.
+     */
+    nativePeer?: () => unknown;
 }
 /**
  * The RAW typertGateway service face — upstream canonical stream order
@@ -20,8 +28,8 @@ export interface A2aHostOptions {
  * mesh-gateway wire adapters (dual-face, 3rd-argument dispatch).
  */
 export interface RawTypertGatewayFace {
-    dispatchRpc(endpoint: string, payload: unknown, signal: AbortSignal): Promise<unknown>;
-    openWireStream(endpoint: string, payload: unknown, uplink: undefined, peer: undefined, signal: AbortSignal, control: AbortController): Promise<AsyncIterable<unknown>> | AsyncIterable<unknown>;
+    dispatchRpc(endpoint: string, payload: unknown, signal: AbortSignal, peer: unknown): Promise<unknown>;
+    openWireStream(endpoint: string, payload: unknown, uplink: undefined, peer: unknown, signal: AbortSignal, control: AbortController): Promise<AsyncIterable<unknown>> | AsyncIterable<unknown>;
 }
 /**
  * Bridge one RAW typertGateway instance to Task 2's 3-arg `A2aGateway` face
@@ -38,7 +46,7 @@ export interface RawTypertGatewayFace {
  * @param real - a raw in-process typertGateway instance (ctx0's own or a local world's).
  * @returns the gateway Task 2's service consumes.
  */
-export declare function bridgeTypertGateway(real: RawTypertGatewayFace): A2aGateway;
+export declare function bridgeTypertGateway(real: RawTypertGatewayFace, peer?: unknown): A2aGateway;
 /**
  * Build the gatewayFor resolver Task 2's service consumes: federated table
  * first, shared target registry second, local id-map inversion third,

package/superd-hub/dist/a2a-host.js

@@ -59,10 +59,10 @@ function localKeyOfA6(home, a6) {
  * @param real - a raw in-process typertGateway instance (ctx0's own or a local world's).
  * @returns the gateway Task 2's service consumes.
  */
-export function bridgeTypertGateway(real) {
+export function bridgeTypertGateway(real, peer) {
     return {
-        dispatchRpc: (endpoint, payload, signal) => real.dispatchRpc(endpoint, payload, signal),
-        openWireStream: (endpoint, payload, signal) => real.openWireStream(endpoint, payload, undefined, undefined, signal, new AbortController()),
+        dispatchRpc: (endpoint, payload, signal) => real.dispatchRpc(endpoint, payload, signal, peer),
+        openWireStream: (endpoint, payload, signal) => real.openWireStream(endpoint, payload, undefined, peer, signal, new AbortController()),
     };
 }
 /**
@@ -95,17 +95,17 @@ export function resolveA2aGatewayFor(options) {
             if (key === 'native') {
                 if (options.nativeGateway === undefined)
                     throw new A2aAddressError('unreachable', addr);
-                return bridgeTypertGateway(options.nativeGateway);
+                return bridgeTypertGateway(options.nativeGateway, options.nativePeer?.());
             }
             // The registry's declared GatewayFace (targets.ts) types the stream
             // face as the 3-arg subset, but a LOCAL row's runtime object is the RAW
             // typertGateway instance (world-join.ts registers it verbatim) — re-cast
             // to RawTypertGatewayFace so the bridge above binds the canonical 6-arg
             // positional order instead of the declared subset.
-            const local = getTarget(key)?.gateway;
-            if (local === undefined)
+            const target = getTarget(key);
+            if (target?.gateway === undefined)
                 throw new A2aAddressError('unreachable', addr);
-            return bridgeTypertGateway(local);
+            return bridgeTypertGateway(target.gateway, target.peer);
         }
         // The a6 resolves nowhere — classify the miss (D7): a roster row exists →
         // its plane is down; else the machine decides agent-vs-machine blame.

package/superd-hub/dist/a2a-row.js

@@ -56,12 +56,18 @@ export function wireHubToolRow(ctx, opts = {}) {
         // RAW instance in, bridged at the resolver (fix round 1: one shared
         // bridge in a2a-host.ts covers the native seam AND all local world rows).
         const raw = t.get('typertGateway');
+        // 0.2.1: every invocation reads the caller Peer — ctx0's owner browser
+        // Peer rides the native seam as a LAZY provider: typertGateway mounts
+        // BEFORE connection (the service registers in its constructor), so a
+        // wiring-time value would capture undefined forever; resolution happens
+        // per call, when connection is long live.
+        const nativePeer = () => ctx.get('connection')?.browserPeer;
         // postoffice R4: ONE resolver, ONE ingest, TWO consumers — the initiator
         // service's self-routing leg calls the very same ingest handler the HTTP
         // endpoint calls (protocol-identical by construction). The service takes
         // a LAZY provider: the ingest's delivery face buffers through the
         // service's own buffer leg, so it can only be built after the service.
-        const gatewayFor = resolveA2aGatewayFor({ home, nativeGateway: raw });
+        const gatewayFor = resolveA2aGatewayFor({ home, nativeGateway: raw, nativePeer });
         // Operational journal: the pure modules only format lines; this is
         // where they meet the process console and land in the unit log (4999 rig
         // / dev3 dsh.service journal). NOT ctx.logger: the pack composes no

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

@@ -1,22 +1,24 @@
 import { type WorldRequest, type WorldResponse } from './world-web-server.js';
 import { WorldMuxServer, type MuxFailure } from './world-mux.js';
-/** The three-method face of a world's typertGateway service instance. */
+/** The face of a world's typertGateway service instance the hub forwards through. */
 export interface CarrierGatewayFace {
-    dispatchRpc(endpoint: string, payload: unknown, signal: AbortSignal): Promise<unknown>;
+    dispatchRpc(endpoint: string, payload: unknown, signal: AbortSignal, peer: unknown): Promise<unknown>;
     /**
      * Streams return an async iterable (upstream face is synchronous-returning).
      * Canonical order: (endpoint, payload, uplink, peer, signal, control) — the
-     * carrier passes no peer (ctx0's fence already authenticated the client),
-     * the mux controller's signal, and the controller itself, exactly as the
-     * native gateway's mux wires its own streams.
+     * carrier passes the world's owner browser Peer (0.2.1 gateways read it on
+     * every invocation), the mux controller's signal, and the controller
+     * itself, exactly as the native gateway's mux wires its own streams.
      */
-    openWireStream(endpoint: string, payload: unknown, uplink: AsyncIterable<unknown>, peer: undefined, signal: AbortSignal, control: AbortController): Promise<AsyncIterable<unknown>> | AsyncIterable<unknown>;
+    openWireStream(endpoint: string, payload: unknown, uplink: AsyncIterable<unknown>, peer: unknown, signal: AbortSignal, control: AbortController): Promise<AsyncIterable<unknown>> | AsyncIterable<unknown>;
 }
 export declare function writeJson(res: WorldResponse, status: number, body: string): void;
 /** Deps the forwarding kernel needs to answer for one world's traffic. */
 export interface ForwardOptions {
     /** The addressed world's gateway instance. */
     gateway: CarrierGatewayFace;
+    /** The addressed world's owner browser Peer (0.2.1 invocation identity). */
+    peer?: unknown;
     /** World key addressing the world's published `/api` fetch handler. */
     label: string;
     /** URL prefix this carrier strips before the world sees the request (`/omp`, `/hub`). */
@@ -47,7 +49,7 @@ export declare function forwardWorldFetch(options: {
  */
 export declare function forwardApiCall(options: ForwardOptions, req: WorldRequest, res: WorldResponse): Promise<void>;
 /** One WorldMuxServer bound to `gateway` — the canonical openWireStream wiring in one place. */
-export declare function worldMuxOf(gateway: CarrierGatewayFace, options?: {
+export declare function worldMuxOf(gateway: CarrierGatewayFace, peer?: unknown, options?: {
     heartbeatIntervalMs?: number;
     failure?: (error: unknown) => MuxFailure;
 }): WorldMuxServer;

package/superd-hub/dist/carrier.js

@@ -177,7 +177,7 @@ export async function forwardApiCall(options, req, res) {
         }
         rpcId = envelope.rpcId;
         const controller = new AbortController();
-        const result = await options.gateway.dispatchRpc(envelope.method, envelope.payload, controller.signal);
+        const result = await options.gateway.dispatchRpc(envelope.method, envelope.payload, controller.signal, options.peer);
         // The gateway already returns a Result (`{ok:true,value}` | `{ok:false,error}`),
         // which is exactly the server-response's `result` field.
         writeJson(res, 200, serverResult(rpcId, result));
@@ -194,8 +194,8 @@ export async function forwardApiCall(options, req, res) {
     }
 }
 /** One WorldMuxServer bound to `gateway` — the canonical openWireStream wiring in one place. */
-export function worldMuxOf(gateway, options) {
-    return new WorldMuxServer((endpoint, payload, uplink, control) => Promise.resolve(gateway.openWireStream(endpoint, payload, uplink, undefined, control.signal, control)), {
+export function worldMuxOf(gateway, peer, options) {
+    return new WorldMuxServer((endpoint, payload, uplink, control) => Promise.resolve(gateway.openWireStream(endpoint, payload, uplink, peer, control.signal, control)), {
         ...(options?.heartbeatIntervalMs === undefined ? {} : { heartbeatIntervalMs: options.heartbeatIntervalMs }),
         ...(options?.failure === undefined ? {} : { failure: options.failure }),
     });

package/superd-hub/dist/client/pill-geometry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Pill geometry for the Hub sidebar row's agent selector (2026-10-18): the
+ * pure math behind anchoring the selector to its row. Split out of
+ * HubPanelIcon so node tests can pin it from `dist/client/` — the
+ * mesh-groups precedent (pure logic beside the components, no DOM, no
+ * React, no @deepseek-ai imports).
+ *
+ * Why absolute-in-flow and not `position: fixed` + re-measure: the native
+ * sidebar scrolls (many workspaces; iOS Safari drags the whole page), and a
+ * fixed pill tracks the VIEWPORT, not the content — without a scroll
+ * listener it stayed at its mount-time viewport spot while the row moved
+ * (the reported mis-alignment). Anchoring the pill to its positioned
+ * ancestor (the `Menu` wrapper span — upstream `.root` is
+ * `position: relative`, in-flow inside the row) makes the composite ride ANY
+ * scroll natively: zero JS per scrolled frame, exact by construction, and
+ * the open menu keeps following through its own capture-phase scroll
+ * placement (`getAnchorRect` reads the pill live).
+ *
+ * @module superd-hub/client/pill-geometry
+ */
+/**
+ * The measured boxes one anchoring reads. All viewport px, straight from
+ * `getBoundingClientRect()` — same-frame reads, so any scroll moves both
+ * boxes equally and the derived offsets are scroll-invariant by
+ * construction.
+ */
+export interface PillMeasureInput {
+    /** The row button's box (the `.panelRow` the glyph sits in). */
+    row: {
+        readonly top: number;
+        readonly bottom: number;
+        readonly right: number;
+    };
+    /** The pill's positioned ancestor box (the `Menu` wrapper span). */
+    wrap: {
+        readonly left: number;
+        readonly top: number;
+    };
+}
+/** Wrapper-relative offsets the pill is placed from. */
+export interface PillBox {
+    /** Wrapper left edge → row right edge (px; both ride the same flow). */
+    readonly dx: number;
+    /** Wrapper top edge → row vertical center (px). */
+    readonly cy: number;
+}
+/**
+ * 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.
+ */
+export declare function measurePillBox(input: PillMeasureInput): PillBox;
+/** The row's own horizontal padding (native `.panelRow`): the selector's inset. */
+export declare const PILL_ROW_INSET = 8;
+/** Structural CSS style the render side spreads into the pill span. */
+export interface PillStyle {
+    readonly position: 'absolute';
+    readonly left: number;
+    readonly top: number;
+    readonly transform: string;
+}
+/**
+ * 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.
+ */
+export declare function pillStyle(box: PillBox, selectorWidth: number, inset?: number): PillStyle;

package/superd-hub/dist/client/pill-geometry.js

@@ -0,0 +1,49 @@
+/**
+ * Pill geometry for the Hub sidebar row's agent selector (2026-10-18): the
+ * pure math behind anchoring the selector to its row. Split out of
+ * HubPanelIcon so node tests can pin it from `dist/client/` — the
+ * mesh-groups precedent (pure logic beside the components, no DOM, no
+ * React, no @deepseek-ai imports).
+ *
+ * Why absolute-in-flow and not `position: fixed` + re-measure: the native
+ * sidebar scrolls (many workspaces; iOS Safari drags the whole page), and a
+ * fixed pill tracks the VIEWPORT, not the content — without a scroll
+ * listener it stayed at its mount-time viewport spot while the row moved
+ * (the reported mis-alignment). Anchoring the pill to its positioned
+ * ancestor (the `Menu` wrapper span — upstream `.root` is
+ * `position: relative`, in-flow inside the row) makes the composite ride ANY
+ * scroll natively: zero JS per scrolled frame, exact by construction, and
+ * the open menu keeps following through its own capture-phase scroll
+ * placement (`getAnchorRect` reads the pill live).
+ *
+ * @module superd-hub/client/pill-geometry
+ */
+/**
+ * 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.
+ */
+export 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. */
+export 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.
+ */
+export function pillStyle(box, selectorWidth, inset = PILL_ROW_INSET) {
+    return {
+        position: 'absolute',
+        left: box.dx - inset - selectorWidth,
+        top: box.cy,
+        transform: 'translateY(-50%)',
+    };
+}

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

@@ -107,6 +107,21 @@ export interface SwitchSessions {
 }
 /** Whether this page is a fusion page: the baked flag global is present. */
 export declare function fusionPage(): boolean;
+/**
+ * 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.
+ */
+export declare function probeStaleFusionPage(): void;
 /** The page atom, when the page carries one (it always does on a fusion page). */
 export declare function uiState(): SuperdUiState | undefined;
 /**

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

@@ -37,7 +37,7 @@
  *
  * @module superd-hub/client/switch
  */
-import { createReadinessWaiter, createSwitchController, decidePreFlight, observeCachesRefreshed, runMachineDownFeedback, SESSIONS_CURRENT_KEY, } from '../switch-core.js';
+import { createReadinessWaiter, createSwitchController, decidePreFlight, observeCachesRefreshed, runMachineDownFeedback, SESSIONS_CURRENT_KEY, FUSION_RELOAD_MARKER, fusionReloadDecision, } from '../switch-core.js';
 import { showSuperdToast } from '../toast-core.js';
 import { fetchMachines, reprobeMachine } from './mesh-api.js';
 import { fetchRoster } from './roster.js';
@@ -45,6 +45,59 @@ import { fetchRoster } from './roster.js';
 export 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 {
+        const storage = globalThis.sessionStorage;
+        return storage?.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.
+ */
+export function probeStaleFusionPage() {
+    void (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 {
+            /* private-mode storage: reload without the marker (a truthful host re-arms the page, ending the flow) */
+        }
+        ;
+        globalThis.location?.reload();
+    })();
+}
 /** The page atom, when the page carries one (it always does on a fusion page). */
 export function uiState() {
     const state = globalThis.__SUPERD_UI_STATE__;

package/superd-hub/dist/companions.js

@@ -3,8 +3,9 @@ import { createHash } from 'node:crypto';
 import { readFile, mkdir, unlink, rmdir } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
 import { writeFileAtomic } from '@deepseek-ai/dsh-atomic-write';
-// done marks a CONFIRMED first use (Better observed installed). A receipt with attempted
-// but neither done nor error is an interrupted first use — e.g. killed by the restart
+// done marks a CONFIRMED first use (Better observed installed); removed marks a
+// migrated legacy removal record. A receipt with attempted but neither done,
+// error, nor removed is an interrupted first use — e.g. killed by the restart
 // that installing Super itself triggers — and must re-arm, not suppress, the retry.
 const message = (error) => error instanceof Error ? error.message : String(error);
 async function optionalJson(path) {
@@ -48,9 +49,10 @@ export class BetterDashCompanion {
         return this.initialized ??= (async () => {
             const saved = await optionalJson(this.receipt);
             if (saved !== undefined) {
-                // Never-resurrect applies only to a CONFIRMED first use or a recorded
-                // failure; an interrupted first use (no done, no error) re-arms.
-                this.intent = saved.attempted && saved.done !== true && saved.error === undefined
+                // Never-resurrect applies to a CONFIRMED first use, a recorded failure,
+                // or a migrated removal record; an interrupted first use (no done, no
+                // error, no removal marker) re-arms.
+                this.intent = saved.attempted && saved.done !== true && saved.error === undefined && saved.removed !== true
                     ? { attempted: false } : saved;
                 await this.cleanLegacy();
                 return;
@@ -59,7 +61,7 @@ export class BetterDashCompanion {
             // Any old registration was first use. An absent Better now means removal,
             // including when Super has since changed version; never resurrect it.
             if (old?.['super-dsh:better-dsh'] !== undefined) {
-                this.intent = { attempted: true };
+                this.intent = { attempted: true, removed: true };
                 await this.save();
                 await this.cleanLegacy();
             }

package/superd-hub/dist/fusion-transport.d.ts

@@ -117,6 +117,13 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
 }>>, Schemastery.ObjectT<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
 }>>, "plain">;
+/**
+ * Whether the fusion row currently injects the transport script + flag
+ * global into served indexes. `false` before the first mount and after
+ * disposal — the roster GET answers with exactly this, and a stale page's
+ * client half reloads on `true` only (switch-core's `fusionReloadDecision`).
+ */
+export declare function fusionTransportArmed(): boolean;
 /** Cordis plugin name. */
 export declare const name = "superd-fusion-transport";
 /**
@@ -132,8 +139,18 @@ export declare const inject: string[];
  * the {@link FUSION_FLAG_GLOBAL} baked global row (Task 4): one gate, both
  * halves.
  *
+ * Armed state: while the listener is registered the row publishes
+ * {@link fusionTransportArmed} = true (counter-owned, reset on effect
+ * disposal) — the one fact an already-open page needs to know that its
+ * stale, pre-install HTML cannot tell it. Consumed additively as
+ * `hub.fusion` on the roster GET (rpc.ts).
  * Off → the component registers nothing: no listener, no row, no script,
- * no flag global.
+ * no flag global. When ON, the row also publishes its armed state through
+ * {@link fusionTransportArmed}, which the roster RPC's additive `hub.fusion`
+ * field carries to already-open pages: their client half probes it and
+ * re-boots the page once (see switch-core's live-install staleness block —
+ * the served index predates the install, so only a re-serve can bake the
+ * flag + transport script).
  * @param ctx - host plugin context.
  * @param config - the row config (`enabled`, default on).
  */

package/superd-hub/dist/fusion-transport.js

@@ -356,6 +356,25 @@ export const FUSION_FLAG_GLOBAL = '__SUPERD_UI_FUSION__';
 export const Config = z.object({
     enabled: z.boolean().default(true),
 });
+/**
+ * How many live index-inject listeners this row has registered (one per
+ * mounted component fiber). Module-level because the consumer (the roster
+ * RPC) is a DIFFERENT row in the same bundle: a cross-row import of live
+ * composition state, the same single-instance guarantee that lets the
+ * client half share the shell's module table. Reset by the listener
+ * effect's disposal, so a runtime row disable stops the advertisement
+ * immediately.
+ */
+let armedRows = 0;
+/**
+ * Whether the fusion row currently injects the transport script + flag
+ * global into served indexes. `false` before the first mount and after
+ * disposal — the roster GET answers with exactly this, and a stale page's
+ * client half reloads on `true` only (switch-core's `fusionReloadDecision`).
+ */
+export function fusionTransportArmed() {
+    return armedRows > 0;
+}
 /** Cordis plugin name. */
 export const name = 'superd-fusion-transport';
 /**
@@ -371,8 +390,18 @@ export const inject = [];
  * the {@link FUSION_FLAG_GLOBAL} baked global row (Task 4): one gate, both
  * halves.
  *
+ * Armed state: while the listener is registered the row publishes
+ * {@link fusionTransportArmed} = true (counter-owned, reset on effect
+ * disposal) — the one fact an already-open page needs to know that its
+ * stale, pre-install HTML cannot tell it. Consumed additively as
+ * `hub.fusion` on the roster GET (rpc.ts).
  * Off → the component registers nothing: no listener, no row, no script,
- * no flag global.
+ * no flag global. When ON, the row also publishes its armed state through
+ * {@link fusionTransportArmed}, which the roster RPC's additive `hub.fusion`
+ * field carries to already-open pages: their client half probes it and
+ * re-boots the page once (see switch-core's live-install staleness block —
+ * the served index predates the install, so only a re-serve can bake the
+ * flag + transport script).
  * @param ctx - host plugin context.
  * @param config - the row config (`enabled`, default on).
  */
@@ -382,10 +411,20 @@ export function apply(ctx, config) {
     if (config?.enabled === false)
         return;
     ctx.inject(['webServer'], () => {
-        ctx.on('webserver/index-inject', (table) => {
-            table.push({ kind: 'script', placement: 'head', text: renderFusionTransport() });
-            table.push({ kind: 'global', name: FUSION_FLAG_GLOBAL, value: true });
-        });
+        // The armed state rides the LISTENER's lifetime (an effect, not a bare
+        // mount): a live row disable/unload resets it, so the roster answer can
+        // never advertise fusion for a row that no longer injects anything.
+        ctx.effect(() => {
+            armedRows += 1;
+            const offInject = ctx.on('webserver/index-inject', (table) => {
+                table.push({ kind: 'script', placement: 'head', text: renderFusionTransport() });
+                table.push({ kind: 'global', name: FUSION_FLAG_GLOBAL, value: true });
+            });
+            return () => {
+                armedRows -= 1;
+                offInject();
+            };
+        }, 'superd-fusion-transport: index injection (armed state)');
     });
 }
 export default { name, inject, Config, apply };

package/superd-hub/dist/gateway.js

@@ -90,7 +90,14 @@ export function apply(ctx, config) {
             real: real,
             authorize: (req, res) => connection.authorizeIndex(req, res),
             requestRejection: (req) => connection.requestRejection(req),
-            gatewayOf: (label) => (federatedGatewayOf(label) ?? getTarget(label)?.gateway),
+            gatewayOf: (label) => {
+                const federated = federatedGatewayOf(label);
+                if (federated !== undefined)
+                    return { key: label, gateway: federated };
+                // The stored face IS the service instance (canonical methods); targets.ts
+                // keeps a looser structural view for the mesh wire adapters.
+                return getTarget(label);
+            },
         }), 'superd-hub: /hub route family');
         // P4 §8.2: the PTY executor's upgrade route — same gate as the /hub family
         // (authorizeIndex cookie auth first, then the browser-trust fence). The

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

@@ -63,8 +63,11 @@ export interface HubRouteOptions {
      * answer, so even the demux 404s never speak to untrusted traffic.
      */
     requestRejection?(req: unknown): number | undefined;
-    /** The live gateway of a registered label, or undefined (unknown / not yet spawned). */
-    gatewayOf(label: string): CarrierGatewayFace | undefined;
+    /** The live target (gateway + owner peer) of a registered label, or undefined (unknown / not yet spawned). */
+    gatewayOf(label: string): {
+        gateway: CarrierGatewayFace;
+        peer?: unknown;
+    } | undefined;
 }
 /**
  * Register the family on ctx0's webServer.