super-dsh 0.1.1 → 0.1.3-c

package/agent-agy/dist/agy-sessions.js

@@ -17,6 +17,8 @@ import { basename, dirname, join, resolve } from "node:path";
 /** Prod homes that must never be resolved into (repo red line). */
 const PROD_HOMES = [join(homedir(), ".dsh"), join(homedir(), ".superd")];
 function assertNotProdHome(path, label) {
+    if (process.env.SUPERD_DEV_REDLINE !== "1")
+        return; // published install: the host dsh home (~/.dsh on consumers) is authoritative — the S3/S7 world layout lives under it. Dev lines set SUPERD_DEV_REDLINE=1 (repo red line: ~/.dsh is Dash prod).
     if (PROD_HOMES.includes(path) || PROD_HOMES.some((p) => path.startsWith(`${p}/`))) {
         throw new Error(`agy-sessions: refusing prod home as ${label}: ${path}`);
     }

package/agent-agy/dist/world-plugin.js

@@ -14,6 +14,7 @@
  *      ctx0's auth domain and dispatches into this world's gateway instance.
  */
 import { mkdirSync } from 'node:fs';
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 import { join } from 'node:path';
 import { spawnWorld, registerAgent, setReady, registerForeignTarget, registerHostMount, mountWorld, worldMountPatches, provisionWorldProfile, } from '../../agent-hub/dist/index.js';
 export const name = 'aw.agent-adapter-agy';
@@ -23,7 +24,10 @@ const ANCHOR = process.env.SUPERD_DSH_ANCHOR
     ?? '/home/u1/.local/lib/node_modules/@deepseek-ai/dsh/package.json';
 export function apply(ctx) {
     registerAgent({ key: KEY, label: 'Antigravity', ready: false });
-    const root = process.env.DSH_HOME ?? join(process.cwd(), '.tests', 'aw');
+    // Harness resolver (env → ~/.dsh): a consumer install has no DSH_HOME and
+    // no cwd contract — deriving the world root from cwd spawns worlds into a
+    // garbage tree or throws inside apply() and kills the whole host boot.
+    const root = resolveDshHome();
     // Nested home: the world's DSH data lives INSIDE `agents/<label>` (sessions
     // / settings / workspaces, and the adapter's dsh-sessions.json mapping).
     // agy: RUNTIME data lives in the SDK (google-antigravity localharness reads is the native ~/.pi (2026-09-17 ruling) — ~/.gemini read-only). Nothing is
@@ -83,6 +87,11 @@ export function apply(ctx) {
             dropHostMount();
         }, `aw.agent-adapter-${KEY}: mount`);
         return ctxW;
-    })();
+    })().catch((cause) => {
+        // A failed world degrades to a not-ready roster row; a rejected provided
+        // promise would fail the entire host boot (loader entry apply).
+        console.error(`[super-dsh] ${KEY} world failed:`, cause);
+        return null;
+    });
     ctx.provide(`aw.world.${KEY}`, world);
 }

package/agent-claude/dist/claude-home.js

@@ -12,6 +12,8 @@ import { join, resolve } from "node:path";
 const PROD_HOMES = [join(homedir(), ".dsh"), join(homedir(), ".superd")];
 /** Refuse any path that resolves into a production DSH home (repo red line). */
 export function assertNotProdHome(path, label) {
+    if (process.env.SUPERD_DEV_REDLINE !== "1")
+        return; // published install: the host dsh home (~/.dsh on consumers) is authoritative — the S3/S7 world layout lives under it. Dev lines set SUPERD_DEV_REDLINE=1 (repo red line: ~/.dsh is Dash prod).
     const p = resolve(path);
     if (PROD_HOMES.includes(p) || PROD_HOMES.some((prod) => p.startsWith(`${prod}/`))) {
         throw new Error(`agent-claude: refusing prod home "${p}" for ${label} — set DSH_HOME to the test home`);

package/agent-codex/dist/codex-store.js

@@ -22,6 +22,8 @@ import { join, resolve } from "node:path";
 /** Prod homes that must never be resolved into (repo red line). */
 const PROD_HOMES = [join(homedir(), ".dsh"), join(homedir(), ".superd")];
 export function assertNotProdHome(path, label) {
+    if (process.env.SUPERD_DEV_REDLINE !== "1")
+        return; // published install: the host dsh home (~/.dsh on consumers) is authoritative — the S3/S7 world layout lives under it. Dev lines set SUPERD_DEV_REDLINE=1 (repo red line: ~/.dsh is Dash prod).
     if (PROD_HOMES.includes(path) || PROD_HOMES.some((p) => path.startsWith(`${p}/`))) {
         throw new Error(`codex-store: refusing prod home as ${label}: ${path}`);
     }

package/agent-codex/dist/world-plugin.js

@@ -14,6 +14,7 @@
  *      ctx0's auth domain and dispatches into this world's gateway instance.
  */
 import { mkdirSync } from 'node:fs';
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 import { join } from 'node:path';
 import { spawnWorld, registerAgent, setReady, registerForeignTarget, registerHostMount, mountWorld, worldMountPatches, provisionWorldProfile, } from '../../agent-hub/dist/index.js';
 export const name = 'aw.agent-adapter-codex';
@@ -23,7 +24,10 @@ const ANCHOR = process.env.SUPERD_DSH_ANCHOR
     ?? '/home/u1/.local/lib/node_modules/@deepseek-ai/dsh/package.json';
 export function apply(ctx) {
     registerAgent({ key: KEY, label: 'Codex', ready: false });
-    const root = process.env.DSH_HOME ?? join(process.cwd(), '.tests', 'aw');
+    // Harness resolver (env → ~/.dsh): a consumer install has no DSH_HOME and
+    // no cwd contract — deriving the world root from cwd spawns worlds into a
+    // garbage tree or throws inside apply() and kills the whole host boot.
+    const root = resolveDshHome();
     // S7 nested home: every runtime owns one root under `agents/<label>`; the
     // world's DSH data lives INSIDE it (sessions / settings / workspaces) and the
     // foreign app's own store (`.codex`) sits in the same root.
@@ -82,6 +86,11 @@ export function apply(ctx) {
             dropHostMount();
         }, `aw.agent-adapter-${KEY}: mount`);
         return ctxW;
-    })();
+    })().catch((cause) => {
+        // A failed world degrades to a not-ready roster row; a rejected provided
+        // promise would fail the entire host boot (loader entry apply).
+        console.error(`[super-dsh] ${KEY} world failed:`, cause);
+        return null;
+    });
     ctx.provide(`aw.world.${KEY}`, world);
 }

package/agent-hermes/dist/hermes-store.js

@@ -24,6 +24,8 @@ import { basename, dirname, join, resolve } from "node:path";
 /** Prod homes that must never be resolved into (repo red line). */
 const PROD_HOMES = [join(homedir(), ".dsh"), join(homedir(), ".superd")];
 function assertNotProdHome(path, label) {
+    if (process.env.SUPERD_DEV_REDLINE !== "1")
+        return; // published install: the host dsh home (~/.dsh on consumers) is authoritative — the S3/S7 world layout lives under it. Dev lines set SUPERD_DEV_REDLINE=1 (repo red line: ~/.dsh is Dash prod).
     if (PROD_HOMES.includes(path) || PROD_HOMES.some((p) => path.startsWith(`${p}/`))) {
         throw new Error(`hermes-store: refusing prod home as ${label}: ${path}`);
     }

package/agent-hermes/dist/world-plugin.js

@@ -15,6 +15,7 @@
  *      ctx0's auth domain and dispatches into this world's gateway instance.
  */
 import { mkdirSync } from 'node:fs';
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 import { join } from 'node:path';
 import { spawnWorld, registerAgent, setReady, registerForeignTarget, registerHostMount, mountWorld, worldMountPatches, provisionWorldProfile, } from '../../agent-hub/dist/index.js';
 export const name = 'aw.agent-adapter-hermes';
@@ -24,7 +25,10 @@ const ANCHOR = process.env.SUPERD_DSH_ANCHOR
     ?? '/home/u1/.local/lib/node_modules/@deepseek-ai/dsh/package.json';
 export function apply(ctx) {
     registerAgent({ key: KEY, label: 'Hermes', ready: false });
-    const root = process.env.DSH_HOME ?? join(process.cwd(), '.tests', 'aw');
+    // Harness resolver (env → ~/.dsh): a consumer install has no DSH_HOME and
+    // no cwd contract — deriving the world root from cwd spawns worlds into a
+    // garbage tree or throws inside apply() and kills the whole host boot.
+    const root = resolveDshHome();
     // S7 nested home: every runtime owns one root under `agents/<label>`; this
     // directory is the WORLD's DSH home (spawnWorld home/dataHome) — DSH-side
     // world data (sessions / settings / workspaces) and the adapter's identity
@@ -87,6 +91,11 @@ export function apply(ctx) {
             dropHostMount();
         }, `aw.agent-adapter-${KEY}: mount`);
         return ctxW;
-    })();
+    })().catch((cause) => {
+        // A failed world degrades to a not-ready roster row; a rejected provided
+        // promise would fail the entire host boot (loader entry apply).
+        console.error(`[super-dsh] ${KEY} world failed:`, cause);
+        return null;
+    });
     ctx.provide(`aw.world.${KEY}`, world);
 }

package/agent-hub/dist/world-join.js

@@ -26,6 +26,7 @@
  * registers and mounts what that profile composes.
  */
 import { mkdirSync } from 'node:fs';
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 import { join } from 'node:path';
 import { registerAgent, setReady } from './roster.js';
 import { registerForeignTarget } from './targets.js';
@@ -50,7 +51,10 @@ export function apply(ctx, config) {
     // S7 nested home: the world's whole tree lives under `agents/<key>` (its
     // profiles were provisioned there by the line bootstrap; DSH data lands
     // inside the same root via spawnWorld's dataHome override).
-    const root = process.env.DSH_HOME ?? join(process.cwd(), '.tests', 'aw');
+    // Harness resolver (env → ~/.dsh): a consumer install has no DSH_HOME and
+    // no cwd contract — deriving the world root from cwd spawns worlds into a
+    // garbage tree or throws inside apply() and kills the whole host boot.
+    const root = resolveDshHome();
     const worldHome = join(root, 'agents', key);
     mkdirSync(join(worldHome, 'profiles'), { recursive: true });
     // Publish story: a foreign install has no line bootstrap, so the nested
@@ -107,7 +111,12 @@ export function apply(ctx, config) {
             dropHostMount();
         }, `aw.world.join: ${key} mount`);
         return ctxW;
-    })();
+    })().catch((cause) => {
+        // A failed world degrades to a not-ready roster row; a rejected provided
+        // promise would fail the entire host boot (loader entry apply).
+        console.error(`[super-dsh] ${key} world failed:`, cause);
+        return null;
+    });
     ctx.provide(`aw.world.${key}`, world);
 }
 export default apply;

package/agent-hub/dist/world-provision.d.ts

@@ -12,5 +12,9 @@ export interface ProvisionWorldOptions {
  * Provision one world's nested profile (idempotent: rewrites profile files,
  * re-links packages — lstat-safe against dangling links). Returns the
  * `bareModuleBaseUrl` for {@link spawnWorld}, or null when unresolvable.
+ *
+ * Never throws: any provisioning failure is logged and returns null so the
+ * calling world plugin degrades to a not-ready roster row instead of failing
+ * the loader entry — a failed apply would take down the whole host boot.
  */
 export declare function provisionWorldProfile(opts: ProvisionWorldOptions): string | null;

package/agent-hub/dist/world-provision.js

@@ -32,10 +32,10 @@
  * or null when the adapter sibling does not exist next to the hub (a foreign
  * composition this module does not own — keep the caller's env/fallback path).
  */
-import { existsSync, lstatSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { existsSync, lstatSync, mkdirSync, readdirSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { createRequire } from 'node:module';
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 const HUB_SCOPE = '@pgmi-builds';
 const HARNESS_SCOPE = '@deepseek-ai';
 /** The profile bundles every world tree composes besides its adapter. */
@@ -44,8 +44,21 @@ const WORLD_BASE_BUNDLES = ['@deepseek-ai/dsh-base', '@deepseek-ai/dsh-web-app']
  * Provision one world's nested profile (idempotent: rewrites profile files,
  * re-links packages — lstat-safe against dangling links). Returns the
  * `bareModuleBaseUrl` for {@link spawnWorld}, or null when unresolvable.
+ *
+ * Never throws: any provisioning failure is logged and returns null so the
+ * calling world plugin degrades to a not-ready roster row instead of failing
+ * the loader entry — a failed apply would take down the whole host boot.
  */
 export function provisionWorldProfile(opts) {
+    try {
+        return provisionWorldProfileUnchecked(opts);
+    }
+    catch (cause) {
+        console.error(`[super-dsh] provisioning world '${opts.key}' failed:`, cause);
+        return null;
+    }
+}
+function provisionWorldProfileUnchecked(opts) {
     // Single-pack topology: this module lives at `<line>/agent-hub/dist/`, and
     // every adapter is a SIBLING directory (`<line>/agent-<key>`) — the same
     // layout in the repo (dev link: lines) and inside the published `super-dsh`
@@ -90,20 +103,33 @@ export function provisionWorldProfile(opts) {
             rmSync(dst, { recursive: true, force: true });
         symlinkSync(target, dst);
     }
-    // The harness scope rides along as ONE scope-level link into the first
-    // `@deepseek-ai` directory visible from this module (the shared heal farm
-    // in a dsh home, the repo farm in dev) — every `@deepseek-ai/*` row of the
-    // world composition resolves through it without farming per package.
-    for (const searchPath of createRequire(import.meta.url).resolve.paths(`${HARNESS_SCOPE}/x`) ?? []) {
-        const scopeDir = join(searchPath, HARNESS_SCOPE);
-        if (!existsSync(scopeDir))
+    // The harness scope for the world tree is a REAL scope directory of
+    // per-package symlinks UNIONED from two authoritative sources (farm first,
+    // installation fills the gaps — dev3 evidence: farm 244 entries missing 16
+    // newer packages the install's 260 has; ctx0 survives via the app-boot
+    // install-anchored resolver fallback, but a tree with an explicit bare
+    // base gets no such fallback). A single scope-level link cannot express
+    // that union, and a resolve.paths() walk from this module can pick the
+    // PROFILE's own partial pnpm scope (2 entries on dev3) — never use it.
+    const ANCHOR = process.env.SUPERD_DSH_ANCHOR
+        ?? '/home/u1/.local/lib/node_modules/@deepseek-ai/dsh/package.json';
+    const scopeSources = [
+        join(resolveDshHome(), 'profiles', 'node_modules', HARNESS_SCOPE),
+        join(dirname(ANCHOR), 'node_modules', HARNESS_SCOPE),
+    ];
+    const scopeDst = join(linkRoot, HARNESS_SCOPE);
+    rmSync(scopeDst, { recursive: true, force: true });
+    mkdirSync(scopeDst, { recursive: true });
+    const linked = new Set();
+    for (const scopeSrc of scopeSources) {
+        if (!existsSync(scopeSrc))
             continue;
-        const dst = join(linkRoot, HARNESS_SCOPE);
-        const st = lstatSync(dst, { throwIfNoEntry: false });
-        if (st)
-            rmSync(dst, { recursive: true, force: true });
-        symlinkSync(scopeDir, dst);
-        break;
+        for (const name of readdirSync(scopeSrc)) {
+            if (name.startsWith('.') || linked.has(name))
+                continue;
+            symlinkSync(join(scopeSrc, name), join(scopeDst, name));
+            linked.add(name);
+        }
     }
     return join(opts.worldHome, 'profiles', 'node_modules') + '/';
 }

package/agent-omp/dist/world-plugin.js

@@ -13,6 +13,7 @@
  *      ctx0's auth domain and dispatches into this world's gateway instance.
  */
 import { mkdirSync } from 'node:fs';
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 import { join } from 'node:path';
 import { spawnWorld, registerAgent, setReady, registerForeignTarget, registerHostMount, mountWorld, worldMountPatches, provisionWorldProfile, } from '../../agent-hub/dist/index.js';
 export const name = 'aw.agent-adapter-omp';
@@ -22,7 +23,10 @@ const ANCHOR = process.env.SUPERD_DSH_ANCHOR
     ?? '/home/u1/.local/lib/node_modules/@deepseek-ai/dsh/package.json';
 export function apply(ctx) {
     registerAgent({ key: KEY, label: 'OMP', ready: false });
-    const root = process.env.DSH_HOME ?? join(process.cwd(), '.tests', 'aw');
+    // Harness resolver (env → ~/.dsh): a consumer install has no DSH_HOME and
+    // no cwd contract — deriving the world root from cwd spawns worlds into a
+    // garbage tree or throws inside apply() and kills the whole host boot.
+    const root = resolveDshHome();
     // S7 nested home: every runtime owns one root under `agents/<label>`, and the
     // world's DSH data lives INSIDE it (sessions / settings / workspaces), so no
     // two runtimes ever share a session list. The foreign app's own store sits in
@@ -82,6 +86,11 @@ export function apply(ctx) {
             dropHostMount();
         }, `aw.agent-adapter-${KEY}: mount`);
         return ctxW;
-    })();
+    })().catch((cause) => {
+        // A failed world degrades to a not-ready roster row; a rejected provided
+        // promise would fail the entire host boot (loader entry apply).
+        console.error(`[super-dsh] ${KEY} world failed:`, cause);
+        return null;
+    });
     ctx.provide(`aw.world.${KEY}`, world);
 }

package/agent-pi/dist/pi-home.js

@@ -21,6 +21,8 @@ import { join, resolve } from "node:path";
 /** Prod homes that must never be resolved into (repo red line). */
 const PROD_HOMES = [join(homedir(), ".dsh"), join(homedir(), ".superd")];
 export function assertNotProdHome(path, label) {
+    if (process.env.SUPERD_DEV_REDLINE !== "1")
+        return; // published install: the host dsh home (~/.dsh on consumers) is authoritative — the S3/S7 world layout lives under it. Dev lines set SUPERD_DEV_REDLINE=1 (repo red line: ~/.dsh is Dash prod).
     if (PROD_HOMES.includes(path) || PROD_HOMES.some((p) => path.startsWith(`${p}/`))) {
         throw new Error(`pi-home: refusing prod home as ${label}: ${path}`);
     }

package/agent-pi/dist/world-plugin.js

@@ -14,6 +14,7 @@
  *      ctx0's auth domain and dispatches into this world's gateway instance.
  */
 import { mkdirSync } from 'node:fs';
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 import { join } from 'node:path';
 import { spawnWorld, registerAgent, setReady, registerForeignTarget, registerHostMount, mountWorld, worldMountPatches, provisionWorldProfile, } from '../../agent-hub/dist/index.js';
 export const name = 'aw.agent-adapter-pi';
@@ -23,7 +24,10 @@ const ANCHOR = process.env.SUPERD_DSH_ANCHOR
     ?? '/home/u1/.local/lib/node_modules/@deepseek-ai/dsh/package.json';
 export function apply(ctx) {
     registerAgent({ key: KEY, label: 'Pi', ready: false });
-    const root = process.env.DSH_HOME ?? join(process.cwd(), '.tests', 'aw');
+    // Harness resolver (env → ~/.dsh): a consumer install has no DSH_HOME and
+    // no cwd contract — deriving the world root from cwd spawns worlds into a
+    // garbage tree or throws inside apply() and kills the whole host boot.
+    const root = resolveDshHome();
     // Nested home: the world's DSH data lives INSIDE `agents/<label>` (sessions
     // / settings / workspaces, and the adapter's dsh-sessions.json mapping).
     // pi's RUNTIME home is the native ~/.pi (2026-09-17 ruling) — nothing is
@@ -83,6 +87,11 @@ export function apply(ctx) {
             dropHostMount();
         }, `aw.agent-adapter-${KEY}: mount`);
         return ctxW;
-    })();
+    })().catch((cause) => {
+        // A failed world degrades to a not-ready roster row; a rejected provided
+        // promise would fail the entire host boot (loader entry apply).
+        console.error(`[super-dsh] ${KEY} world failed:`, cause);
+        return null;
+    });
     ctx.provide(`aw.world.${KEY}`, world);
 }

package/client/index.js

@@ -0,0 +1,242 @@
+window.__ModuleLoader__.load({ id: "super-dsh", factory: (require) => {
+var module = { exports: {} }; var exports = module.exports;
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let react = require("react");
+react = __toESM(react);
+let react_jsx_runtime = require("react/jsx-runtime");
+react_jsx_runtime = __toESM(react_jsx_runtime);
+
+//#region src/client/RuntimeSeat.tsx
+const NATIVE = {
+	key: "native",
+	label: "DSH",
+	path: "/"
+};
+/** Fallback labels for the read-only face (which only reports keys). */
+const RUNTIME_LABELS = {
+	native: "DSH",
+	omp: "OMP",
+	codex: "Codex"
+};
+function fromGlobal() {
+	const agents = globalThis.__DSH_AGENT_ROSTER__?.agents;
+	if (!Array.isArray(agents)) return void 0;
+	const links = [];
+	for (const entry of agents) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const { key, label, path } = entry;
+		if (typeof key !== "string" || typeof path !== "string") continue;
+		links.push({
+			key,
+			label: typeof label === "string" ? label : RUNTIME_LABELS[key] ?? key,
+			path
+		});
+	}
+	return links.length > 0 ? links : void 0;
+}
+/** Normalize the current mount root: `/omp` and `/omp/` are the same page. */
+function currentPath() {
+	const pathname = typeof location === "undefined" ? "/" : location.pathname;
+	if (pathname === "" || pathname === "/") return "/";
+	return pathname.endsWith("/") ? pathname : `${pathname}/`;
+}
+function RuntimeSeat({ wide }) {
+	const [agents, setAgents] = react.useState(() => fromGlobal() ?? [NATIVE]);
+	const [open, setOpen] = react.useState(false);
+	const rootRef = react.useRef(null);
+	react.useEffect(() => {
+		let cancelled = false;
+		fetch("/api/agent-runtime", { credentials: "same-origin" }).then((r) => r.ok ? r.json() : Promise.reject(/* @__PURE__ */ new Error(`HTTP ${r.status}`))).then((j) => {
+			if (cancelled) return;
+			if (Array.isArray(j?.agents)) {
+				const listed = [];
+				for (const entry of j.agents) {
+					if (typeof entry !== "object" || entry === null) continue;
+					const { key, label, path } = entry;
+					if (typeof key !== "string" || typeof path !== "string") continue;
+					listed.push({
+						key,
+						label: typeof label === "string" ? label : RUNTIME_LABELS[key] ?? key,
+						path
+					});
+				}
+				if (listed.length > 0) {
+					setAgents(listed);
+					return;
+				}
+			}
+			if (!Array.isArray(j?.available)) return;
+			const links = [];
+			for (const key of j.available) {
+				if (typeof key !== "string") continue;
+				links.push(key === "native" ? NATIVE : {
+					key,
+					label: RUNTIME_LABELS[key] ?? key,
+					path: `/${key}/`
+				});
+			}
+			if (links.length > 0) setAgents(links);
+		}).catch(() => {});
+		return () => {
+			cancelled = true;
+		};
+	}, []);
+	react.useEffect(() => {
+		if (!open) return;
+		const onDown = (event) => {
+			if (rootRef.current !== null && !rootRef.current.contains(event.target)) setOpen(false);
+		};
+		document.addEventListener("mousedown", onDown);
+		return () => document.removeEventListener("mousedown", onDown);
+	}, [open]);
+	const here = currentPath();
+	const active = agents.find((agent) => agent.path === here) ?? NATIVE;
+	const styleBase = {
+		display: "flex",
+		alignItems: "center",
+		gap: 8,
+		width: "100%",
+		padding: wide ? "7px 10px" : "7px 0",
+		justifyContent: wide ? "flex-start" : "center",
+		border: "none",
+		borderRadius: 8,
+		background: "transparent",
+		color: "inherit",
+		font: "inherit",
+		fontSize: 13,
+		cursor: "pointer",
+		position: "relative"
+	};
+	const styleBadge = {
+		fontSize: 10,
+		lineHeight: 1.4,
+		padding: "1px 6px",
+		borderRadius: 999,
+		background: "color-mix(in srgb, currentColor 12%, transparent)",
+		whiteSpace: "nowrap"
+	};
+	const styleMenu = {
+		position: "absolute",
+		bottom: "calc(100% + 6px)",
+		left: 6,
+		right: 6,
+		zIndex: 40,
+		background: "var(--dsh-surface, #26262b)",
+		border: "1px solid color-mix(in srgb, currentColor 18%, transparent)",
+		borderRadius: 10,
+		boxShadow: "0 8px 24px rgba(0,0,0,.35)",
+		overflow: "hidden"
+	};
+	const styleItem = (isActive) => ({
+		display: "block",
+		width: "100%",
+		padding: "8px 12px",
+		border: "none",
+		background: isActive ? "color-mix(in srgb, currentColor 10%, transparent)" : "transparent",
+		color: "inherit",
+		font: "inherit",
+		fontSize: 13,
+		textAlign: "left",
+		cursor: "pointer"
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		ref: rootRef,
+		style: {
+			position: "relative",
+			width: "100%"
+		},
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+			type: "button",
+			style: styleBase,
+			title: "Agent runtime — picking one opens that runtime's mount (/omp/, /codex/, …)",
+			onClick: () => {
+				setOpen((v) => !v);
+			},
+			children: wide ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					"aria-hidden": true,
+					children: "⌘"
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					style: {
+						flex: 1,
+						textAlign: "left",
+						whiteSpace: "nowrap",
+						overflow: "hidden",
+						textOverflow: "ellipsis"
+					},
+					children: ["Agent · ", active.label]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					style: styleBadge,
+					children: "open"
+				})
+			] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				"aria-hidden": true,
+				children: "⌘"
+			})
+		}), open && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			style: styleMenu,
+			children: agents.map((agent) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+				href: agent.path,
+				style: {
+					...styleItem(agent.path === here),
+					textDecoration: "none"
+				},
+				"aria-current": agent.path === here ? "page" : void 0,
+				onClick: () => {
+					setOpen(false);
+				},
+				children: agent.path === here ? `${agent.label} ✓` : agent.label
+			}, agent.key))
+		})]
+	});
+}
+
+//#endregion
+//#region src/client/index.ts
+/** Required services (cordis fiber inject): the slot registry. */
+const inject = ["slots"];
+/**
+* Mount the selector. Degrades silently when the slot service is absent (a
+* composition without the sidebar renders nothing — a footer action is an
+* optional occupant by contract).
+*
+* @param ctx - client root context.
+*/
+function apply(ctx) {
+	ctx.inject(["slots"], (raw) => {
+		const scope = raw;
+		scope.effect(() => scope.slots.inject("sidebar.footer.action", () => scope.slots.register({
+			name: "sidebar.footer.action",
+			id: "agent-runtime"
+		}, RuntimeSeat)), "agent-hub: runtime footer action");
+	});
+}
+
+//#endregion
+exports.apply = apply;
+exports.inject = inject;
+return module.exports; } });

package/cordis.patch.yml

@@ -16,8 +16,11 @@
 # Profile-layer values (webserver port/host, settings path) stay in the USER's
 # profile patch layer, never here.
 - insert:
+    # BARE package row: subpath rows (…/world/omp) are permanently not client
+    # rows in client-modules' scan (exactPackageSpecifier), so THIS row is
+    # what registers the package's client half — the sidebar selector.
     - id: agent-hub
-      name: 'super-dsh/hub'
+      name: 'super-dsh'
     - id: aw-agent-adapter-omp
       name: 'super-dsh/world/omp'
     - id: aw-agent-adapter-codex

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-dsh",
-  "version": "0.1.1",
+  "version": "0.1.3-c",
   "description": "Agent Worlds for the DeepSeek Harness (DSH) — one dsh plugin that mounts the agent hub (runtime selector, roster, per-runtime worlds) 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",
@@ -9,6 +9,7 @@
     "url": "git+https://github.com/pgmi-builds/superd.git"
   },
   "exports": {
+    ".": "./agent-hub/dist/index.js",
     "./hub": "./agent-hub/dist/index.js",
     "./join": "./agent-hub/dist/world-join.js",
     "./world/omp": "./agent-omp/dist/world-plugin.js",
@@ -17,12 +18,13 @@
     "./world/pi": "./agent-pi/dist/world-plugin.js",
     "./world/hermes": "./agent-hermes/dist/world-plugin.js",
     "./world/agy": "./agent-agy/dist/world-plugin.js",
-    "./client": "./agent-hub/lib/client/index.js",
+    "./client": "./client/index.js",
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json"
   },
   "files": [
     "cordis.patch.yml",
+    "client",
     "README.md",
     "agent-hub/dist",
     "agent-hub/lib",
@@ -68,7 +70,8 @@
     "@openai/codex-sdk": "0.154.0",
     "bun": "^1.4.2",
     "ws": "^8.21.0",
-    "zod": "3.25.76"
+    "zod": "3.25.76",
+    "@modelcontextprotocol/sdk": "^1.29.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -87,20 +90,48 @@
     "@deepseek-ai/dsh-user-questions": "0.1.5-rc.2"
   },
   "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": { "optional": true },
-    "@deepseek-ai/dsh-agent": { "optional": true },
-    "@deepseek-ai/dsh-agent-presets": { "optional": true },
-    "@deepseek-ai/dsh-api-gateway": { "optional": true },
-    "@deepseek-ai/dsh-commands": { "optional": true },
-    "@deepseek-ai/dsh-home-paths": { "optional": true },
-    "@deepseek-ai/dsh-host-webserver": { "optional": true },
-    "@deepseek-ai/dsh-llm": { "optional": true },
-    "@deepseek-ai/dsh-scope": { "optional": true },
-    "@deepseek-ai/dsh-session": { "optional": true },
-    "@deepseek-ai/dsh-session-persistence": { "optional": true },
-    "@deepseek-ai/dsh-typert-protocol": { "optional": true },
-    "@deepseek-ai/dsh-user-approval": { "optional": true },
-    "@deepseek-ai/dsh-user-questions": { "optional": true }
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent-presets": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-api-gateway": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-commands": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-home-paths": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-host-webserver": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-scope": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-session-persistence": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-protocol": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-approval": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-questions": {
+      "optional": true
+    }
   },
   "publishConfig": {
     "access": "public"