super-dsh 0.1.5-a → 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/package.json

@@ -1,12 +1,12 @@
 {
   "name": "super-dsh",
-  "version": "0.1.5-a",
+  "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/index.d.ts

@@ -16,7 +16,7 @@
  */
 export { handleAgentRuntime, registerSelectorRpc, AGENT_RUNTIME_RPC_PATH, registryTargets, type RuntimeTargetSource } from './rpc.js';
 export { registerForeignTarget, unregisterForeignTarget, getTarget, listRuntimeKeys, type ForeignTarget, type GatewayFace } from './targets.js';
-export { registerAgent, unregisterAgent, setReady, listAgents, onRosterChanged, type RosterEntry } from './roster.js';
+export { registerAgent, unregisterAgent, setReady, setFailed, listAgents, onRosterChanged, type RosterEntry } from './roster.js';
 export { spawnWorld, type SpawnWorldOptions } from './spawn-world.js';
 export { provisionWorldProfile, resolveInstallAnchor, type ProvisionWorldOptions } from './world-provision.js';
 export { WorldWebServer, stripLabelFromUrl, type WorldWebRoute, type WorldWebUpgradeRoute, type RealWebServerFace } from './world-web-server.js';
@@ -29,7 +29,7 @@ export { createSwitchController, parseLandingTarget, namespacedKey, storageNames
 export { agentLinks, agentRosterRow, AGENT_ROSTER_GLOBAL, type AgentLink } from './agent-roster.js';
 export { createOwnershipIndex, type OwnershipIndex, type OwnershipRow } from './ownership.js';
 export { registerHostMount, takeHostMount, listHostMounts, noteWorldServer, worldServerOf, type HostMount } from './world-host.js';
-export { worldMountPatches, superdTrustedHosts, WORLD_MOUNT_PLUGIN, WORLD_MOUNT_ROW_ID, WORLD_HUB_PLUGIN, WORLD_HUB_ROW_ID, type WorldPatchLayer, } from './world-mount.js';
+export { worldMountPatches, superdTrustedHosts, WORLD_WAVE1_DISABLED_ROWS, WORLD_WAVE2_DISABLED_ROWS, WORLD_MOUNT_PLUGIN, WORLD_MOUNT_ROW_ID, WORLD_HUB_PLUGIN, WORLD_HUB_ROW_ID, type WorldPatchLayer, } from './world-mount.js';
 export { buildTrustScript, deriveDefaultPageAuthorities, type BootScriptRow, type TrustConfig, } from './web-trust.js';
 export { withSystemHead, type HeadAwareSessionFace, type HeadPlaceholder, type WithSystemHead } from './system-head.js';
 export { default as worldApply, name as worldPluginName, type Config as WorldEntryConfig } from './world-entry.js';

package/superd-hub/dist/index.js

@@ -16,7 +16,7 @@
  */
 export { handleAgentRuntime, registerSelectorRpc, AGENT_RUNTIME_RPC_PATH, registryTargets } from './rpc.js';
 export { registerForeignTarget, unregisterForeignTarget, getTarget, listRuntimeKeys } from './targets.js';
-export { registerAgent, unregisterAgent, setReady, listAgents, onRosterChanged } from './roster.js';
+export { registerAgent, unregisterAgent, setReady, setFailed, listAgents, onRosterChanged } from './roster.js';
 export { spawnWorld } from './spawn-world.js';
 export { provisionWorldProfile, resolveInstallAnchor } from './world-provision.js';
 export { WorldWebServer, stripLabelFromUrl } from './world-web-server.js';
@@ -29,7 +29,7 @@ export { createSwitchController, parseLandingTarget, namespacedKey, storageNames
 export { agentLinks, agentRosterRow, AGENT_ROSTER_GLOBAL } from './agent-roster.js';
 export { createOwnershipIndex } from './ownership.js';
 export { registerHostMount, takeHostMount, listHostMounts, noteWorldServer, worldServerOf } from './world-host.js';
-export { worldMountPatches, superdTrustedHosts, WORLD_MOUNT_PLUGIN, WORLD_MOUNT_ROW_ID, WORLD_HUB_PLUGIN, WORLD_HUB_ROW_ID, } from './world-mount.js';
+export { worldMountPatches, superdTrustedHosts, WORLD_WAVE1_DISABLED_ROWS, WORLD_WAVE2_DISABLED_ROWS, WORLD_MOUNT_PLUGIN, WORLD_MOUNT_ROW_ID, WORLD_HUB_PLUGIN, WORLD_HUB_ROW_ID, } from './world-mount.js';
 export { buildTrustScript, deriveDefaultPageAuthorities, } from './web-trust.js';
 export { withSystemHead } from './system-head.js';
 export { default as worldApply, name as worldPluginName } from './world-entry.js';

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

@@ -15,6 +15,8 @@ export interface RosterEntry {
     label: string;
     /** True once the adapter's world context is spawned and its target registered. */
     ready: boolean;
+    /** True once the world's spawn REJECTED (world-join catch) — stays mounted for diagnosis. */
+    failed?: boolean;
 }
 /** Register an agent. Duplicate keys are a plugin bug — throw loud. */
 export declare function registerAgent(entry: RosterEntry): void;
@@ -22,6 +24,8 @@ export declare function registerAgent(entry: RosterEntry): void;
 export declare function unregisterAgent(key: string): void;
 /** Flip readiness (world spawned / disposed). Unknown keys are a plugin bug. */
 export declare function setReady(key: string, ready: boolean): void;
+/** Flip failure (world spawn rejected). Unknown keys are a plugin bug. */
+export declare function setFailed(key: string, failed: boolean): void;
 /** Snapshot copy — callers can hold it without aliasing the roster. */
 export declare function listAgents(): RosterEntry[];
 /** Subscribe to roster changes; returns an unsubscribe function. */

package/superd-hub/dist/roster.js

@@ -9,7 +9,7 @@ function emit() {
 export function registerAgent(entry) {
     if (entries.has(entry.key))
         throw new Error(`roster: duplicate agent key ${entry.key}`);
-    entries.set(entry.key, { ...entry });
+    entries.set(entry.key, { ...entry, failed: entry.failed ?? false });
     emit();
 }
 /** Drop an agent (adapter plugin disposed). */
@@ -25,6 +25,14 @@ export function setReady(key, ready) {
     e.ready = ready;
     emit();
 }
+/** Flip failure (world spawn rejected). Unknown keys are a plugin bug. */
+export function setFailed(key, failed) {
+    const e = entries.get(key);
+    if (!e)
+        throw new Error(`roster: unknown agent ${key}`);
+    e.failed = failed;
+    emit();
+}
 /** Snapshot copy — callers can hold it without aliasing the roster. */
 export function listAgents() {
     return [...entries.values()].map((e) => ({ ...e }));

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

@@ -628,3 +628,43 @@ export interface SwitchController {
  * switch's pointer-restored view).
  */
 export declare function createSwitchController(host: SwitchHost, options?: SwitchOptions): SwitchController;
+/** What attemptSwitch does with a roster row: run the machine / report failure / wait for readiness. */
+export type PreFlightDecision = 'run' | 'failed' | 'wait';
+/** The roster fields the pre-flight reads (the projection carries both since C1 task 3). */
+export interface PreFlightRow {
+    ready?: boolean;
+    failed?: boolean;
+}
+/**
+ * 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.
+ */
+export declare function decidePreFlight(label: string, row: PreFlightRow | undefined): PreFlightDecision;
+/** Default bound on one readiness wait (the page never locks behind a stuck world). */
+export declare const WAIT_BOUND_MS = 120000;
+/** Default poll interval for one readiness wait. */
+export declare const WAIT_POLL_MS = 1000;
+/** The waiter's injected faces (tests drive time and the roster by hand). */
+export interface ReadinessWaiterFaces {
+    /** Read the target's roster row; undefined on any failure. */
+    fetchRow(): Promise<PreFlightRow | undefined>;
+    setTimeout(fn: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+/** One bounded readiness wait. */
+export interface ReadinessWaiter {
+    /** Resolves when the row flips ready ('ready'), reports failure ('failed'), the bound expires ('bound'), or the waiter is cancelled ('cancelled'). */
+    wait(label: string): Promise<'ready' | 'failed' | 'bound' | 'cancelled'>;
+    /** A newer switch attempt cancels a pending wait (it resolves 'cancelled'). */
+    cancel(): void;
+}
+/**
+ * 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.
+ */
+export declare function createReadinessWaiter(faces: ReadinessWaiterFaces, options?: {
+    boundMs?: number;
+    pollMs?: number;
+}): ReadinessWaiter;