super-dsh 0.1.5 → 0.1.6

package/client/index.js

@@ -268,7 +268,9 @@ const NATIVE_LINK = {
 	key: "native",
 	label: "DSH",
 	path: "/",
-	machine: "local"
+	machine: "local",
+	ready: true,
+	failed: false
 };
 /** Labels for the read-only face's bare keys (it reports keys, not labels). */
 const FALLBACK_LABELS = {
@@ -292,7 +294,9 @@ function coerceAgents(raw) {
 			key,
 			label: typeof label === "string" ? label : FALLBACK_LABELS[key] ?? key,
 			path,
-			machine: typeof machine === "string" ? machine : "local"
+			machine: typeof machine === "string" ? machine : "local",
+			ready: entry.ready === true,
+			failed: entry.failed === true
 		});
 	}
 	return links.length > 0 ? links : void 0;
@@ -329,7 +333,8 @@ async function fetchRoster() {
 				key,
 				label: FALLBACK_LABELS[key] ?? key,
 				path: `/${key}/`,
-				machine: "local"
+				machine: "local",
+				ready: key === "native"
 			});
 		}
 		if (links.length > 0) return links;
@@ -931,10 +936,10 @@ function machineGroups(rows) {
 function createSwitchController(host, options = {}) {
 	const fallbackMs = options.fallbackMs ?? SWITCH_FALLBACK_MS;
 	const quietWindowMs = options.quietWindowMs ?? LANDING_QUIET_MS;
-	let current;
+	let current$1;
 	let armedLanding;
 	return { run(label) {
-		const prior = current;
+		const prior = current$1;
 		return new Promise((resolve) => {
 			let timer;
 			let watchdog;
@@ -961,7 +966,7 @@ function createSwitchController(host, options = {}) {
 					attempt.finished = true;
 					host.clearTimeout(timer);
 					disposer();
-					if (current === attempt) current = void 0;
+					if (current$1 === attempt) current$1 = void 0;
 					if (landingArmed) watchdog = host.setTimeout(() => {
 						attempt.cancelLanding();
 					}, fallbackMs);
@@ -974,9 +979,9 @@ function createSwitchController(host, options = {}) {
 				cancelPriorLanding();
 			}
 			if (prior !== void 0 && !prior.finished) prior.finish();
-			current = attempt;
+			current$1 = attempt;
 			const revert = (reason) => {
-				if (attempt.finished || current !== attempt) return;
+				if (attempt.finished || current$1 !== attempt) return;
 				attempt.cancelLanding();
 				try {
 					host.setAgent(NATIVE_AGENT);
@@ -999,7 +1004,7 @@ function createSwitchController(host, options = {}) {
 				revert("timeout");
 			}, fallbackMs);
 			disposer = host.onGenerationEstablished(() => {
-				if (attempt.finished || current !== attempt) return;
+				if (attempt.finished || current$1 !== attempt) return;
 				attempt.finish();
 			});
 			landingArmed = true;
@@ -1056,6 +1061,121 @@ function createSwitchController(host, options = {}) {
 		});
 	} };
 }
+/**
+* The pure pre-flight decision. `native` always runs; an absent row (roster
+* fetch failed, or the key is not listed) also runs — the machine's roster
+* probe is the authority on unknown targets, exactly as before C1.
+*/
+function decidePreFlight(label, row) {
+	if (label === NATIVE_AGENT) return "run";
+	if (row === void 0) return "run";
+	if (row.failed === true) return "failed";
+	if (row.ready !== true) return "wait";
+	return "run";
+}
+/** Default bound on one readiness wait (the page never locks behind a stuck world). */
+const WAIT_BOUND_MS = 12e4;
+/** Default poll interval for one readiness wait. */
+const WAIT_POLL_MS = 1e3;
+/**
+* Build a bounded readiness waiter over injected faces. The poll re-reads
+* the roster row every {@link ReadinessWaiterOptions.pollMs}; `failed`
+* short-circuits immediately; the bound always terminates the wait.
+*/
+function createReadinessWaiter(faces, options = {}) {
+	const boundMs = options.boundMs ?? WAIT_BOUND_MS;
+	const pollMs = options.pollMs ?? WAIT_POLL_MS;
+	let pending;
+	let pollHandle;
+	let boundHandle;
+	let settled = false;
+	const settle = (outcome) => {
+		if (settled) return;
+		settled = true;
+		if (pollHandle !== void 0) faces.clearTimeout(pollHandle);
+		if (boundHandle !== void 0) faces.clearTimeout(boundHandle);
+		pending?.(outcome);
+		pending = void 0;
+	};
+	return {
+		wait(label) {
+			return new Promise((resolve) => {
+				pending = resolve;
+				boundHandle = faces.setTimeout(() => {
+					settle("bound");
+				}, boundMs);
+				const tick = () => {
+					if (settled) return;
+					faces.fetchRow().then((row) => {
+						if (settled) return;
+						if (row?.failed === true) {
+							settle("failed");
+							return;
+						}
+						if (row?.ready === true) {
+							settle("ready");
+							return;
+						}
+						pollHandle = faces.setTimeout(tick, pollMs);
+					}, () => {
+						if (!settled) pollHandle = faces.setTimeout(tick, pollMs);
+					});
+				};
+				tick();
+			});
+		},
+		cancel() {
+			settle("cancelled");
+		}
+	};
+}
+
+//#endregion
+//#region src/toast-core.ts
+/** Failures that name what broke need a longer read than a one-liner. */
+const TOAST_DEFAULT_HOLD_MS = 6e3;
+/** The exact props the official primitive receives (pure — the unit seam). */
+function toastProps(text, options = {}) {
+	const props = {
+		text,
+		holdMs: options.holdMs ?? TOAST_DEFAULT_HOLD_MS
+	};
+	if (options.tone !== void 0) props.tone = options.tone;
+	return props;
+}
+let seq = 0;
+let current;
+const listeners = /* @__PURE__ */ new Set();
+function emit() {
+	for (const fn of [...listeners]) try {
+		fn(current);
+	} catch {}
+}
+/** Fire one toast (best-effort: without a mounted owner nothing renders). */
+function showSuperdToast(text, options = {}) {
+	current = {
+		seq: ++seq,
+		text,
+		options
+	};
+	emit();
+}
+/** Clear a shown toast (the fade's `onDone`); stale sequences are no-ops. */
+function clearSuperdToast(done) {
+	if (current === void 0 || current.seq !== done) return;
+	current = void 0;
+	emit();
+}
+/** Subscribe to the store (the host's effect face); returns unsubscribe. */
+function onSuperdToast(fn) {
+	listeners.add(fn);
+	try {
+		fn(current);
+	} catch {}
+	return () => {
+		listeners.delete(fn);
+	};
+}
 
 //#endregion
 //#region src/client/switch.ts
@@ -1071,39 +1191,14 @@ function uiState() {
 	if (typeof state.subscribe !== "function" || typeof state.activeAgent !== "string") return void 0;
 	return state;
 }
-/** How long one revert toast stays on screen. */
-const TOAST_HOLD_MS = 6e3;
 /**
-* One transient message, fixed above the sidebar footer. Self-owned
-* presentation only — no read from any foreign DOM, nothing is a state input.
+* One transient message through the official `Toast` primitive (C1 task 4:
+* the platform's top-center banner — dark surface in both themes, warn icon
+* seat — rendered by the host's React tree from the Hub sidebar row's
+* always-mounted owner; see client/toast.ts).
 */
 function showToast(message) {
-	try {
-		const doc = globalThis.document;
-		if (doc === void 0 || doc.body === null) return;
-		const el = doc.createElement("div");
-		el.textContent = message;
-		el.setAttribute("style", [
-			"position:fixed",
-			"left:50%",
-			"bottom:64px",
-			"transform:translateX(-50%)",
-			"z-index:9999",
-			"max-width:80vw",
-			"padding:10px 14px",
-			"border-radius:8px",
-			"background:rgba(24,24,28,.94)",
-			"color:#ececf0",
-			"font:13px/1.4 system-ui,sans-serif",
-			"box-shadow:0 8px 24px rgba(0,0,0,.35)"
-		].join(";"));
-		doc.body.appendChild(el);
-		globalThis.setTimeout(() => {
-			try {
-				el.remove();
-			} catch {}
-		}, TOAST_HOLD_MS);
-	} catch {}
+	showSuperdToast(message);
 }
 /** The bound `switchAgent`, or `undefined` until the entry binds it. */
 let bound;
@@ -1211,10 +1306,63 @@ function bindSwitchAgent(deps) {
 *   `false` means the click is swallowed, never that the anchor navigates
 *   the fused page away (review round 1).
 */
+let pendingWait;
+/**
+* The Hub switch surfaces' entry point. Attempts the in-page switch for
+* `label`, gated on the target world's readiness (C1): a not-ready world
+* holds the UI on native with starting feedback and a bounded poll; a
+* failed world reports and never switches; a ready/native/unknown target
+* runs the machine (whose roster probe stays the fallback).
+* @returns `true` when the fusion switch took the click over; `false` when
+*   this page is not a fusion page or the orchestration is unbound.
+*   Informational only — the interception contract (`seatClickDecision`)
+*   prevents navigation on every fusion-page left click regardless: a
+*   `false` means the click is swallowed, never that the anchor navigates
+*   the fused page away (review round 1).
+*/
 function attemptSwitch(label) {
 	const run = bound;
 	if (run === void 0 || !fusionPage()) return false;
-	run(label).catch(() => {});
+	pendingWait?.cancel();
+	pendingWait = void 0;
+	(async () => {
+		let row;
+		try {
+			row = (await fetchRoster()).find((agent) => agent.key === label);
+		} catch {
+			row = void 0;
+		}
+		const decision = decidePreFlight(label, row);
+		if (decision === "failed") {
+			showToast(`Super D: ${label} failed to start — see the service log.`);
+			return;
+		}
+		if (decision === "wait") {
+			showToast(`Super D: ${label} is starting…`);
+			const waiter = createReadinessWaiter({
+				fetchRow: async () => {
+					try {
+						return (await fetchRoster()).find((agent) => agent.key === label);
+					} catch {
+						return;
+					}
+				},
+				setTimeout: (fn, ms) => globalThis.setTimeout(fn, ms),
+				clearTimeout: (handle) => globalThis.clearTimeout(handle)
+			});
+			pendingWait = waiter;
+			const outcome = await waiter.wait(label);
+			if (pendingWait === waiter) pendingWait = void 0;
+			if (outcome === "ready") {
+				run(label).catch(() => {});
+				return;
+			}
+			if (outcome === "failed") showToast(`Super D: ${label} failed to start — see the service log.`);
+			else if (outcome === "bound") showToast(`Super D: ${label} is still starting — try again in a moment.`);
+			return;
+		}
+		run(label).catch(() => {});
+	})();
 	return true;
 }
 
@@ -1847,6 +1995,34 @@ function HubPage() {
 	});
 }
 
+//#endregion
+//#region src/client/toast.ts
+/**
+* The element for one pending toast: keyed by sequence so a newer toast
+* remounts the primitive and restarts its slide-in cycle (the primitive's
+* own re-show contract).
+*/
+function superdToastElement(toast) {
+	return react.createElement(__deepseek_ai_dsh_client_ui_primitives.Toast, {
+		key: toast.seq,
+		...toastProps(toast.text, toast.options),
+		onDone: () => {
+			clearSuperdToast(toast.seq);
+		}
+	});
+}
+/**
+* The always-mounted owner: subscribes to the store and renders the current
+* toast (nothing while the store is empty). Mounted inside the Hub sidebar
+* row — the primitive's body portal places the banner top-center regardless
+* of where the owner sits.
+*/
+function SuperdToastHost() {
+	const [toast, setToast] = react.useState(void 0);
+	react.useEffect(() => onSuperdToast(setToast), []);
+	return toast === void 0 ? null : superdToastElement(toast);
+}
+
 //#endregion
 //#region src/client/HubPanelIcon.tsx
 /** Runtime-mark edge inside the selector, and the chevron's own default edge. */
@@ -1986,61 +2162,65 @@ function HubPanelIcon({ size }) {
 			alignItems: "center",
 			justifyContent: "center"
 		},
-		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(HubGlyph, { size }), wide && box !== null && switchUi.available && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.Menu, {
-			open,
-			onClose: () => {
-				setOpen(false);
-			},
-			items,
-			selectedIds: activeKey === void 0 ? [] : [activeKey],
-			onSelect: select,
-			dense: true,
-			portal: true,
-			align: "end",
-			getAnchorRect: anchorRect,
-			anchor: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-				ref: selectorRef,
-				role: "button",
-				tabIndex: 0,
-				"aria-label": "Agent selector",
-				"aria-haspopup": "menu",
-				"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%)",
-					display: "inline-flex",
-					alignItems: "center",
-					justifyContent: "center",
-					gap: SELECTOR_GAP,
-					boxSizing: "border-box",
-					width: selectorWidth,
-					height: SELECTOR_HEIGHT,
-					padding: `0 ${SELECTOR_PAD}px`,
-					borderRadius: 16,
-					background: hover || open ? "var(--dsw-alias-interactive-bg-hover)" : "transparent",
-					color: "var(--dsw-alias-label-caption)",
-					cursor: "pointer",
-					zIndex: 50
-				},
-				onMouseEnter: () => {
-					setHover(true);
-				},
-				onMouseLeave: () => {
-					setHover(false);
-				},
-				onClick: toggle,
-				onKeyDown: (event) => {
-					if (event.key === "Enter" || event.key === " ") toggle(event);
+		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, {
+				open,
+				onClose: () => {
+					setOpen(false);
 				},
-				children: [activeKey !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RuntimeMark, {
-					agentKey: activeKey,
-					size: MARK_SIZE
-				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineRegular, { size: CHEVRON_SIZE })]
+				items,
+				selectedIds: activeKey === void 0 ? [] : [activeKey],
+				onSelect: select,
+				dense: true,
+				portal: true,
+				align: "end",
+				getAnchorRect: anchorRect,
+				anchor: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					ref: selectorRef,
+					role: "button",
+					tabIndex: 0,
+					"aria-label": "Agent selector",
+					"aria-haspopup": "menu",
+					"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%)",
+						display: "inline-flex",
+						alignItems: "center",
+						justifyContent: "center",
+						gap: SELECTOR_GAP,
+						boxSizing: "border-box",
+						width: selectorWidth,
+						height: SELECTOR_HEIGHT,
+						padding: `0 ${SELECTOR_PAD}px`,
+						borderRadius: 16,
+						background: hover || open ? "var(--dsw-alias-interactive-bg-hover)" : "transparent",
+						color: "var(--dsw-alias-label-caption)",
+						cursor: "pointer",
+						zIndex: 50
+					},
+					onMouseEnter: () => {
+						setHover(true);
+					},
+					onMouseLeave: () => {
+						setHover(false);
+					},
+					onClick: toggle,
+					onKeyDown: (event) => {
+						if (event.key === "Enter" || event.key === " ") toggle(event);
+					},
+					children: [activeKey !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RuntimeMark, {
+						agentKey: activeKey,
+						size: MARK_SIZE
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(__deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineRegular, { size: CHEVRON_SIZE })]
+				})
 			})
-		})]
+		]
 	});
 }
 

package/cordis.patch.yml

@@ -33,15 +33,16 @@
     - id: superd-web-trust
       name: 'super-dsh/web-trust'
     # Native UI fusion transport (plan Task 3): the ctx0 page-level state atom
-    # + five call-time patches, flag-gated (SUPERD_UI_FUSION, default off).
+    # + five call-time patches. Composing this row IS the switch — there is no
+    # environment variable in the decision (2026-09-27 user ruling: a release
+    # gate living in an env var is deployment state no patch layer can see).
     # ROW ORDER IS LOAD ORDER and the row MUST stay after superd-web-trust:
     # the trust script's non-merging `if(!window.__DSH_TRANSPORT__)` verdict
     # must be evaluated before the fusion script could own that global
     # (spec §3.4, hard; precedent world-web-server.ts renderIndex).
-    # On/off (Task 5 formalization): env `SUPERD_UI_FUSION` derives the
-    # schema default (off when unset); a profile layer may restate this row
-    # (same id, same name) with `config: {enabled: true|false}` to override.
-    # Off = the component registers nothing: no script, no flag global.
+    # To turn the fused surface off: restate this row (same id, same name) with
+    # `config: {enabled: false}` or `disabled: true`, or drop it from the
+    # composition. Off = the component registers nothing: no script, no global.
     - id: superd-fusion-transport
       name: 'super-dsh/fusion-transport'
     - id: agent-omp

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "super-dsh",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Super D for the DeepSeek Harness (DSH) — one dsh plugin that mounts the superd hub (runtime selector, roster, per-runtime agents) and joins local foreign-agent runtimes (OMP, Codex, Claude, Pi, Hermes, Antigravity) into the DSH Web UI. Each runtime keeps its native home and session store; the hub only bridges.",
   "type": "module",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pgmi-builds/superd.git"
+    "url": "git+https://github.com/pgmi-builds/super-dsh.git"
   },
   "exports": {
     ".": "./superd-hub/dist/index.js",

package/superd-hub/dist/agent-roster.d.ts

@@ -22,6 +22,10 @@ export interface AgentLink {
     path: string;
     /** Machine the runtime runs on — the Hub UI's grouping key. */
     machine: string;
+    /** Whether the world's data plane is up (spawn resolved). Native is always ready. */
+    ready: boolean;
+    /** Whether the world's spawn REJECTED (mount stays for diagnosis). */
+    failed: boolean;
 }
 /** The global this module publishes the roster under. */
 export declare const AGENT_ROSTER_GLOBAL = "__DSH_AGENT_ROSTER__";

package/superd-hub/dist/agent-roster.js

@@ -3,7 +3,7 @@ import { takeHostMount } from './world-host.js';
 /** Machine of every roster row today — the local constant; the extension point a multi-machine registry replaces. */
 const LOCAL_MACHINE = 'local';
 /** The native runtime's synthetic entry (no adapter plugin backs it). */
-const NATIVE = { key: 'native', label: 'DSH', path: '/', machine: LOCAL_MACHINE };
+const NATIVE = { key: 'native', label: 'DSH', path: '/', machine: LOCAL_MACHINE, ready: true, failed: false };
 /** The global this module publishes the roster under. */
 export const AGENT_ROSTER_GLOBAL = '__DSH_AGENT_ROSTER__';
 /**
@@ -19,7 +19,7 @@ export function agentLinks() {
         if (mount === undefined)
             continue;
         const path = mount.labelPath.endsWith('/') ? mount.labelPath : `${mount.labelPath}/`;
-        links.push({ key: agent.key, label: agent.label, path, machine: LOCAL_MACHINE });
+        links.push({ key: agent.key, label: agent.label, path, machine: LOCAL_MACHINE, ready: agent.ready === true, failed: agent.failed === true });
     }
     return links;
 }

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

@@ -0,0 +1,28 @@
+/**
+ * Client mount shim (AW-B DL8).
+ *
+ * ONE head script installs every client-side break point:
+ *   - `__DSH_TRANSPORT__.fetch`  → the Connection RPC fetch (URL object input)
+ *   - `WebSocket` / `EventSource` / `XMLHttpRequest` constructors → path rewrite
+ *   - `__DSH_FILE_UPLOAD__`      → uploads bypass the blob worker + its XHR
+ *   - Storage.prototype get/set/remove → per-world key namespace
+ *   - `globalThis.fetch`         → global-fetch calls asking for ctx0-root `/api`
+ *     URLs (2026-09-17 H1: upstream session-log-export resolves the GLOBAL
+ *     fetch at call time; narrow `/api`-only rule, query + hash preserved)
+ *   - `HTMLAnchorElement.prototype.click` → download-anchor clicks re-rooted
+ *     (2026-09-18 H1 r2: upstream hands the UNREWRITTEN absolute URL to a
+ *     DETACHED `<a download>` and clicks it — detached clicks never reach
+ *     document, so a document-level listener cannot see them, and a blanket
+ *     rewrite breaks the runtime selector's root-absolute anchors
+ *     (live-found 2026-09-18). Narrow rule: ONLY anchors carrying a
+ *     `download` attribute AND a same-authority root-absolute `/api` href.)
+ * The rule is namespace-agnostic: a same-origin root-absolute URL is re-rooted
+ * under the mount (`/omp`), nothing else is touched. That covers every prefix
+ * a plugin may declare later — no list to keep in sync.
+ */
+/**
+ * Render the shim as a classic script (parser-blocking head injection).
+ * @param labelPath - mount root, e.g. `/omp`.
+ * @returns JavaScript source.
+ */
+export declare function renderClientShim(labelPath: string): string;