@devframes/hub 0.9.9 → 0.9.10

package/dist/assemble-Hj36CCzH.mjs

@@ -0,0 +1,103 @@
+import { a as resolveClientModuleSpecifier } from "./remote-url-UClKLQ5_.mjs";
+import { b as diagnostics, v as prepareDevframe, y as skippedInStaticBuild } from "./context-BWaW6N53.mjs";
+import { joinURL, withTrailingSlash } from "ufo";
+import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
+import { existsSync } from "node:fs";
+import { resolve } from "pathe";
+//#region src/node/assemble.ts
+/** Reserved filenames directly under the hub base; a frame id can't shadow them. */
+const RESERVED_HUB_PATHS = [
+	DEVFRAME_CONNECTION_META_FILENAME,
+	DEVFRAME_DOCK_IMPORTS_FILENAME,
+	DEVFRAME_WS_ROUTE,
+	DEVFRAME_MCP_ROUTE,
+	"__index.json",
+	"__renderers",
+	"embedded.js"
+];
+function normalizeDevframeEntry(entry) {
+	return "devframe" in entry ? entry : { devframe: entry };
+}
+/**
+* Flatten the `devframes` input: await every thenable, call every factory,
+* spread the arrays, and drop the empty slots, so a host can build the list
+* conditionally (`isDev && loadInspect()`) without filtering it first.
+*/
+function resolveDevframesInput(input) {
+	return Promise.all(input.map(async (entry) => {
+		const resolved = await (typeof entry === "function" ? entry() : entry);
+		return (Array.isArray(resolved) ? resolved : [resolved]).filter((slot) => slot != null).map(normalizeDevframeEntry);
+	})).then((arrays) => arrays.flat());
+}
+/**
+* Validate the renderer-module registrations fail-fast: route-safe types
+* (each becomes the `<base>__renderers/<type>.mjs` URL segment), one module
+* per type, and an existing bundle file (renderer packages are prebuilt).
+*/
+function resolveRendererRegistrations(registrations) {
+	const seen = /* @__PURE__ */ new Set();
+	return registrations.map((registration) => {
+		if (!/^[\w.-]+$/.test(registration.type)) throw diagnostics.DF8110({ type: registration.type });
+		if (seen.has(registration.type)) throw diagnostics.DF8108({ type: registration.type });
+		seen.add(registration.type);
+		const file = resolve(registration.file);
+		if (!existsSync(file)) throw diagnostics.DF8109({
+			type: registration.type,
+			file
+		});
+		return {
+			...registration,
+			file
+		};
+	});
+}
+/**
+* Render the dock client-script import map as an ES module: one dynamic
+* import thunk per dock that carries a client script (`clientScript` on
+* iframe docks, `action`, `renderer`). External viewers import this module
+* from `<base>__client-imports.js` to load per-dock client code into the
+* host page; `importFrom` values are URL paths the host serves, or bare npm
+* specifiers resolved through the host's `clientModuleResolution` template.
+*/
+function renderClientImportsModule(ctx) {
+	const template = ctx.staticConfig.dock?.clientModuleResolution;
+	const entries = [];
+	for (const [id, view] of ctx.docks.views) {
+		const scripts = [];
+		const anyView = view;
+		if (anyView.clientScript) scripts.push(anyView.clientScript);
+		if (anyView.action) scripts.push(anyView.action);
+		if (anyView.renderer) scripts.push(anyView.renderer);
+		if (scripts.length === 0) continue;
+		const thunks = scripts.map((script) => `() => import(${JSON.stringify(resolveClientModuleSpecifier(script.importFrom, { template }))})`);
+		entries.push(`  ${JSON.stringify(id)}: [${thunks.join(", ")}],`);
+	}
+	return `// Generated by @devframes/hub: dock client-script import map.\nexport const clientImports = {\n${entries.join("\n")}\n}\nexport default clientImports\n`;
+}
+/**
+* Pass 1: mount each devframe under `<base><id>/` (SPA, meta, iframe dock)
+* and queue its declared services, guarding the id against reserved hub
+* filenames and route-pattern characters. Returns the deferred setup thunks.
+*/
+async function mountDevframes(ctx, devframes, base, frames, hubMcpEnabled) {
+	const setups = [];
+	for (const { devframe: def, dock } of devframes) {
+		if (RESERVED_HUB_PATHS.includes(def.id)) throw diagnostics.DF8000({ id: def.id });
+		if (!/^[\w.-]+$/.test(def.id)) throw diagnostics.DF8004({ id: def.id });
+		if (!hubMcpEnabled && def.cli?.mcp) diagnostics.DF8005({ id: def.id });
+		const frameBase = withTrailingSlash(joinURL(base, def.id));
+		const run = await prepareDevframe(ctx, def, {
+			base: frameBase,
+			...dock ? { dock } : {}
+		});
+		if (run) setups.push(run);
+		if (!skippedInStaticBuild(ctx, def)) frames.push({
+			id: def.id,
+			base: frameBase,
+			title: def.name
+		});
+	}
+	return setups;
+}
+//#endregion
+export { resolveRendererRegistrations as i, renderClientImportsModule as n, resolveDevframesInput as r, mountDevframes as t };

package/dist/client/index.mjs

@@ -1,4 +1,4 @@
-import { i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, t as DEFAULT_CATEGORIES_ORDER } from "../constants-BUd6oMci.mjs";
+import { i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, t as DEFAULT_CATEGORIES_ORDER } from "../constants-Da23JxCZ.mjs";
 import { a as resolveClientModuleSpecifier, n as stripRemoteConnectionFromUrl, r as clientScriptFailureHint, t as buildRemoteConnectionUrl } from "../remote-url-UClKLQ5_.mjs";
 import { REMOTE_CONNECTION_KEY } from "devframe/constants";
 import { connectDevframe, getDevframeRpcClient, resolveWsUrl } from "devframe/client";
@@ -362,6 +362,7 @@ function serializeNavQuery(query) {
 * dock client script reports into the very feed the server writes to.
 */
 function createMessagesClient(rpc, options = {}) {
+	if (rpc.connectionMeta?.backend === "static") return createLocalMessagesClient(options);
 	const { call } = rpc;
 	function makeHandle(entry) {
 		let current = entry;
@@ -404,6 +405,58 @@ function createMessagesClient(rpc, options = {}) {
 		debug: levelShortcut("debug")
 	};
 }
+/** In-page-only writes for a static backend: same surface, no wire. */
+function createLocalMessagesClient(options) {
+	let nextId = 0;
+	function makeEntry(input) {
+		return {
+			timestamp: Date.now(),
+			...options.defaults,
+			...input,
+			id: input.id ?? `local-${++nextId}`,
+			from: "browser"
+		};
+	}
+	function makeHandle(entry) {
+		let current = entry;
+		return {
+			get entry() {
+				return current;
+			},
+			get id() {
+				return current.id;
+			},
+			async update(patch) {
+				current = {
+					...current,
+					...patch,
+					id: current.id,
+					from: current.from
+				};
+				return current;
+			},
+			dismiss: async () => {}
+		};
+	}
+	const add = async (input) => makeHandle(makeEntry(input));
+	function levelShortcut(level) {
+		return (message, extra) => add({
+			...extra,
+			message,
+			level
+		});
+	}
+	return {
+		add,
+		remove: async () => {},
+		clear: async () => {},
+		info: levelShortcut("info"),
+		warn: levelShortcut("warn"),
+		error: levelShortcut("error"),
+		success: levelShortcut("success"),
+		debug: levelShortcut("debug")
+	};
+}
 //#endregion
 //#region src/client/renderers.ts
 /**
@@ -576,6 +629,11 @@ async function createDevframeClientRuntime(options = {}) {
 		type: "action",
 		handler: (activation) => activateHandler(activation)
 	});
+	if (rpc.connectionMeta?.backend === "static" && typeof BroadcastChannel !== "undefined") {
+		const activateChannel = new BroadcastChannel(HUB_EVENTS.broadcastChannel.docksActivate);
+		activateChannel.onmessage = (event) => activateHandler(event.data);
+		disposers.push(() => activateChannel.close());
+	}
 	if (getDevframeClientContext()) console.warn("[@devframes/hub] A client context is already published on this page; replacing it. Boot createDevframeClientRuntime() once per page (e.g. HTML injection combined with a manual import boots it twice).");
 	setDevframeClientContext(context);
 	const loadedScripts = /* @__PURE__ */ new Set();

package/dist/{constants-Coo1p3ja.d.mts → constants-Bz4yclHo.d.mts}

@@ -72,6 +72,15 @@ declare const HUB_EVENTS: {
   readonly postMessage: {
     readonly frameNav: "devframe:frame-nav";
   };
+  /**
+   * Same-origin `BroadcastChannel` names, `devframe:` prefix. Used on a
+   * `static` backend, where no live server can relay a client's request to
+   * its sibling browsing contexts (e.g. a panel iframe steering the host
+   * page's dock selection).
+   */
+  readonly broadcastChannel: {
+    readonly docksActivate: "devframe:docks:activate";
+  };
 };
 //#endregion
 //#region src/constants.d.ts

package/dist/{constants-BUd6oMci.mjs → constants-Da23JxCZ.mjs}

@@ -65,7 +65,14 @@ const HUB_EVENTS = {
 	/** Streaming channel ids (server → client), `devframe:` prefix. */
 	stream: { terminals: "devframe:terminals" },
 	/** `postMessage` channels for host ↔ iframe protocols, `devframe:` prefix. */
-	postMessage: { frameNav: "devframe:frame-nav" }
+	postMessage: { frameNav: "devframe:frame-nav" },
+	/**
+	* Same-origin `BroadcastChannel` names, `devframe:` prefix. Used on a
+	* `static` backend, where no live server can relay a client's request to
+	* its sibling browsing contexts (e.g. a panel iframe steering the host
+	* page's dock selection).
+	*/
+	broadcastChannel: { docksActivate: "devframe:docks:activate" }
 };
 //#endregion
 //#region src/constants.ts

package/dist/constants.d.mts

@@ -1,3 +1,3 @@
-import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, r as DEVFRAMES_HUB_BASE, t as DEFAULT_CATEGORIES_ORDER } from "./constants-Coo1p3ja.mjs";
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, r as DEVFRAMES_HUB_BASE, t as DEFAULT_CATEGORIES_ORDER } from "./constants-Bz4yclHo.mjs";
 export * from "devframe/constants";
 export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, HUB_EVENTS, normalizeHubBase };

package/dist/constants.mjs

@@ -1,3 +1,3 @@
-import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, r as DEVFRAMES_HUB_BASE, t as DEFAULT_CATEGORIES_ORDER } from "./constants-BUd6oMci.mjs";
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, r as DEVFRAMES_HUB_BASE, t as DEFAULT_CATEGORIES_ORDER } from "./constants-Da23JxCZ.mjs";
 export * from "devframe/constants";
 export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, HUB_EVENTS, normalizeHubBase };

package/dist/{context-D4L966cN.mjs → context-BWaW6N53.mjs}

@@ -1,17 +1,17 @@
 import { r as defineHubRpcFunction } from "./define-Ceekw2EO.mjs";
-import { n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS } from "./constants-BUd6oMci.mjs";
+import { n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS } from "./constants-Da23JxCZ.mjs";
 import { i as isBareModuleSpecifier, t as buildRemoteConnectionUrl } from "./remote-url-UClKLQ5_.mjs";
 import { joinURL, withTrailingSlash } from "ufo";
 import { createEventEmitter } from "devframe/utils/events";
-import { createHostContext, createStorage } from "devframe/node";
-import { getInternalContext, resolveBasePath } from "devframe/node/hub-internals";
-import { debounce } from "perfect-debounce";
+import { existsSync } from "node:fs";
+import process from "node:process";
 import { coerceAgentPositionalArgs, resolveClientAssets } from "devframe/internal";
-import { defineDiagnostics } from "devframe/utils/nostics";
 import { basename, dirname, isAbsolute, join, resolve } from "pathe";
+import { defineDiagnostics } from "devframe/utils/nostics";
+import { getInternalContext, resolveBasePath } from "devframe/node/hub-internals";
+import { createHostContext, createStorage } from "devframe/node";
+import { debounce } from "perfect-debounce";
 import { nanoid } from "devframe/utils/nanoid";
-import process from "node:process";
-import { existsSync } from "node:fs";
 //#region src/node/diagnostics.ts
 /**
 * Hub-side diagnostics for docks, terminals, messages, and commands.
@@ -44,8 +44,12 @@ const diagnostics = defineDiagnostics({
 			fix: "Ids become route segments, so they may only contain letters, digits, `_`, `-`, and `.`; `:` and `*` are route-pattern markers to the underlying router, and `/` would escape the segment. Set a route-safe `id` on the definition (e.g. `my_plugin` instead of `my:plugin`)."
 		},
 		DF8005: {
-			why: (p) => `Devframe "${p.id}" requests an MCP route, but the hub's aggregate MCP is off, so its tools are not exposed over MCP.`,
-			fix: "A hub exposes one aggregate MCP endpoint over every mounted devframe, so per-devframe `mcp` settings are ignored. Enable the hub's own MCP (pass `mcp` to `initHub`) to surface this devframe's tools, or drop `mcp` from the devframe to silence this warning."
+			why: (p) => `Devframe "${p.id}" requests an MCP route, but the hub's aggregate MCP is off (\`mcp: false\`), so its tools are not exposed over MCP.`,
+			fix: "A hub exposes one aggregate MCP endpoint over every mounted devframe, so per-devframe `mcp` settings are ignored. Drop `mcp: false` from `initHub` (the `'auto'` default mounts the aggregate route once agent tools exist) to surface this devframe's tools, or drop `mcp` from the devframe to silence this warning."
+		},
+		DF8006: {
+			why: (p) => `A static hub build can only write mounts under its own base: "${p.urlBase}" escapes "${p.base}".`,
+			fix: "buildHub maps each mount base to a directory under its `outDir`, so every mount must live under the hub base. Drop the `basePath` override (or the `ctx.install` base) that points outside it, or move the hub `base` up so it contains the mount."
 		},
 		DF8100: {
 			why: (p) => `Dock with id "${p.id}" is already registered`,
@@ -128,6 +132,134 @@ const diagnostics = defineDiagnostics({
 	}
 });
 //#endregion
+//#region src/node/install-devframe.ts
+/**
+* Find the next free dock id derived from `baseId`. Returns `baseId`
+* when it is unused, otherwise appends `-2`, `-3`, … until a free slot
+* is found. Used by the `'duplicate'` strategy so co-existing instances
+* never collide in the dock registry.
+*/
+function nextAvailableDockId(views, baseId) {
+	if (!views.has(baseId)) return baseId;
+	let n = 2;
+	while (views.has(`${baseId}-${n}`)) n++;
+	return `${baseId}-${n}`;
+}
+/**
+* When a dock's `clientScript.importFrom` is an absolute filesystem path, serve
+* its directory under `<base>__page-script/` and rewrite `importFrom` to that
+* URL. A URL or bare specifier (not existing on disk) passes through untouched.
+*/
+async function resolvePageScriptClientScript(ctx, clientScript, base) {
+	if (!clientScript?.importFrom) return clientScript;
+	const { importFrom } = clientScript;
+	if (!isAbsolute(importFrom) || !existsSync(importFrom)) return clientScript;
+	const scriptBase = withTrailingSlash(joinURL(base, "__page-script"));
+	await ctx.host.mountStatic(scriptBase, dirname(importFrom));
+	return {
+		...clientScript,
+		importFrom: joinURL(scriptBase, basename(importFrom))
+	};
+}
+/**
+* Framework-neutral primitive backing {@link DevframeHubContext.install} -
+* installs a {@link DevframeDefinition} as a dock inside a hub-aware context:
+* serves the devframe's SPA at the resolved base path, synthesizes an iframe
+* dock entry from the definition's metadata, and runs the definition's
+* `setup(ctx)`. Reach for it through `ctx.install(devframe)` rather than
+* calling it directly.
+*
+* Framework kits wrap `ctx.install` with their own plugin/middleware
+* machinery, e.g. `@vitejs/devtools-kit`'s `createPluginFromDevframe`
+* returns a Vite `Plugin` whose `devtools.setup` ultimately delegates here.
+*/
+/**
+* Phase one of an install: run the duplication guard, serve the SPA + meta,
+* register the iframe dock, and queue the definition's declarative wire
+* services, everything up to (but not including) `setup(ctx)`. Returns a
+* deferred setup thunk, or `null` when the devframe was deduplicated.
+*
+* The hub's initial batch uses this to collect every devframe's services
+* across the whole hub, `ready()` them once, and only then run the setups,
+* so services are ready before any setup, and a plugin can consume a service
+* another plugin declared regardless of mount order.
+*/
+/**
+* Serve a devframe's SPA (and the hub's connection meta) under `base`, if the
+* definition ships client assets.
+*/
+async function serveDevframeAssets(ctx, d, id, base) {
+	const clientAssets = resolveClientAssets(d);
+	if (!clientAssets) return;
+	if (ctx.host.mountConnectionMeta) await ctx.host.mountConnectionMeta(base);
+	else diagnostics.DF8106({
+		id,
+		name: d.name,
+		base
+	});
+	ctx.views.hostStatic(base, typeof clientAssets === "string" ? resolve(clientAssets) : clientAssets, d.importMetaUrl);
+}
+/**
+* Whether a devframe stays out of a static hub build: `capabilities.build:
+* false` declares its value inherently live (a terminal, a process proxy),
+* so `buildHub` never mounts it, registers its dock, or bakes its RPCs.
+*/
+function skippedInStaticBuild(ctx, d) {
+	return ctx.mode === "build" && d.capabilities?.build === false;
+}
+async function prepareDevframe(ctx, d, options = {}) {
+	if (skippedInStaticBuild(ctx, d)) return null;
+	const strategy = d.duplicationStrategy ?? "warn";
+	const isDuplicate = ctx.docks.views.has(d.id);
+	if (isDuplicate && strategy !== "duplicate") {
+		if (strategy === "throw") throw diagnostics.DF8105({
+			id: d.id,
+			name: d.name
+		});
+		if (strategy === "warn") diagnostics.DF8105({
+			id: d.id,
+			name: d.name
+		});
+		return null;
+	}
+	const id = isDuplicate ? nextAvailableDockId(ctx.docks.views, d.id) : d.id;
+	const base = options.base ?? (id === d.id ? resolveBasePath(d, "hosted") : resolveBasePath({
+		...d,
+		id,
+		basePath: void 0
+	}, "hosted"));
+	const dockDefaults = {
+		...d.dock,
+		...options.dock
+	};
+	const clientScript = await resolvePageScriptClientScript(ctx, dockDefaults.clientScript, base);
+	if (clientScript) dockDefaults.clientScript = clientScript;
+	await serveDevframeAssets(ctx, d, id, base);
+	ctx.docks.register({
+		id,
+		title: d.name,
+		icon: d.icon,
+		...dockDefaults,
+		type: "iframe",
+		url: base
+	});
+	for (const input of d.services ?? []) ctx.services.install(input, { resolveFrom: d.importMetaUrl });
+	return () => Promise.resolve(d.setup(ctx));
+}
+/**
+* Install a {@link DevframeDefinition} into a hub in one call: serve its SPA,
+* register its dock, ready its services, and run `setup(ctx)`. The imperative
+* counterpart to the hub's declarative `devframes` list (which batches the
+* phases via {@link prepareDevframe}); use it from `configure(ctx)` or
+* wherever you hold the context to plug in an extra devframe after startup.
+*/
+async function installDevframe(ctx, d, options = {}) {
+	const run = await prepareDevframe(ctx, d, options);
+	if (!run) return;
+	await ctx.services.ready();
+	await run();
+}
+//#endregion
 //#region src/node/host-commands.ts
 function findChildCommand(command, id) {
 	for (const child of command.children ?? []) {
@@ -952,125 +1084,6 @@ var DevframeTerminalsHost = class {
 	}
 };
 //#endregion
-//#region src/node/install-devframe.ts
-/**
-* Find the next free dock id derived from `baseId`. Returns `baseId`
-* when it is unused, otherwise appends `-2`, `-3`, … until a free slot
-* is found. Used by the `'duplicate'` strategy so co-existing instances
-* never collide in the dock registry.
-*/
-function nextAvailableDockId(views, baseId) {
-	if (!views.has(baseId)) return baseId;
-	let n = 2;
-	while (views.has(`${baseId}-${n}`)) n++;
-	return `${baseId}-${n}`;
-}
-/**
-* When a dock's `clientScript.importFrom` is an absolute filesystem path, serve
-* its directory under `<base>__page-script/` and rewrite `importFrom` to that
-* URL. A URL or bare specifier (not existing on disk) passes through untouched.
-*/
-async function resolvePageScriptClientScript(ctx, clientScript, base) {
-	if (!clientScript?.importFrom) return clientScript;
-	const { importFrom } = clientScript;
-	if (!isAbsolute(importFrom) || !existsSync(importFrom)) return clientScript;
-	const scriptBase = withTrailingSlash(joinURL(base, "__page-script"));
-	await ctx.host.mountStatic(scriptBase, dirname(importFrom));
-	return {
-		...clientScript,
-		importFrom: joinURL(scriptBase, basename(importFrom))
-	};
-}
-/**
-* Framework-neutral primitive backing {@link DevframeHubContext.install} -
-* installs a {@link DevframeDefinition} as a dock inside a hub-aware context:
-* serves the devframe's SPA at the resolved base path, synthesizes an iframe
-* dock entry from the definition's metadata, and runs the definition's
-* `setup(ctx)`. Reach for it through `ctx.install(devframe)` rather than
-* calling it directly.
-*
-* Framework kits wrap `ctx.install` with their own plugin/middleware
-* machinery, e.g. `@vitejs/devtools-kit`'s `createPluginFromDevframe`
-* returns a Vite `Plugin` whose `devtools.setup` ultimately delegates here.
-*/
-/**
-* Phase one of an install: run the duplication guard, serve the SPA + meta,
-* register the iframe dock, and queue the definition's declarative wire
-* services, everything up to (but not including) `setup(ctx)`. Returns a
-* deferred setup thunk, or `null` when the devframe was deduplicated.
-*
-* The hub's initial batch uses this to collect every devframe's services
-* across the whole hub, `ready()` them once, and only then run the setups,
-* so services are ready before any setup, and a plugin can consume a service
-* another plugin declared regardless of mount order.
-*/
-/**
-* Serve a devframe's SPA (and the hub's connection meta) under `base`, if the
-* definition ships client assets.
-*/
-async function serveDevframeAssets(ctx, d, id, base) {
-	const clientAssets = resolveClientAssets(d);
-	if (!clientAssets) return;
-	if (ctx.host.mountConnectionMeta) await ctx.host.mountConnectionMeta(base);
-	else diagnostics.DF8106({
-		id,
-		name: d.name,
-		base
-	});
-	ctx.views.hostStatic(base, typeof clientAssets === "string" ? resolve(clientAssets) : clientAssets, d.importMetaUrl);
-}
-async function prepareDevframe(ctx, d, options = {}) {
-	const strategy = d.duplicationStrategy ?? "warn";
-	const isDuplicate = ctx.docks.views.has(d.id);
-	if (isDuplicate && strategy !== "duplicate") {
-		if (strategy === "throw") throw diagnostics.DF8105({
-			id: d.id,
-			name: d.name
-		});
-		if (strategy === "warn") diagnostics.DF8105({
-			id: d.id,
-			name: d.name
-		});
-		return null;
-	}
-	const id = isDuplicate ? nextAvailableDockId(ctx.docks.views, d.id) : d.id;
-	const base = options.base ?? (id === d.id ? resolveBasePath(d, "hosted") : resolveBasePath({
-		...d,
-		id,
-		basePath: void 0
-	}, "hosted"));
-	const dockDefaults = {
-		...d.dock,
-		...options.dock
-	};
-	const clientScript = await resolvePageScriptClientScript(ctx, dockDefaults.clientScript, base);
-	if (clientScript) dockDefaults.clientScript = clientScript;
-	await serveDevframeAssets(ctx, d, id, base);
-	ctx.docks.register({
-		id,
-		title: d.name,
-		icon: d.icon,
-		...dockDefaults,
-		type: "iframe",
-		url: base
-	});
-	for (const input of d.services ?? []) ctx.services.install(input, { resolveFrom: d.importMetaUrl });
-	return () => Promise.resolve(d.setup(ctx));
-}
-/**
-* Install a {@link DevframeDefinition} into a hub in one call: serve its SPA,
-* register its dock, ready its services, and run `setup(ctx)`. The imperative
-* counterpart to the hub's declarative `devframes` list (which batches the
-* phases via {@link prepareDevframe}); use it from `configure(ctx)` or
-* wherever you hold the context to plug in an extra devframe after startup.
-*/
-async function installDevframe(ctx, d, options = {}) {
-	const run = await prepareDevframe(ctx, d, options);
-	if (!run) return;
-	await ctx.services.ready();
-	await run();
-}
-//#endregion
 //#region src/node/rpc-builtins.ts
 /**
 * Resolve an interactive (PTY) terminal session by id, or throw. Sessions
@@ -1324,4 +1337,4 @@ async function createHubContext(options) {
 	return context;
 }
 //#endregion
-export { DevframeDocksHost as _, hubMessagesAdd as a, hubMessagesUpdate as c, hubTerminalsRestart as d, hubTerminalsTerminate as f, DevframeMessagesHost as g, DevframeTerminalsHost as h, hubDocksActivate as i, hubTerminalsRemove as l, prepareDevframe as m, builtinHubRpcDeclarations as n, hubMessagesClear as o, hubTerminalsWrite as p, hubCommandsExecute as r, hubMessagesRemove as s, createHubContext as t, hubTerminalsResize as u, DevframeCommandsHost as v, diagnostics as y };
+export { DevframeCommandsHost as _, hubMessagesAdd as a, diagnostics as b, hubMessagesUpdate as c, hubTerminalsRestart as d, hubTerminalsTerminate as f, DevframeDocksHost as g, DevframeMessagesHost as h, hubDocksActivate as i, hubTerminalsRemove as l, DevframeTerminalsHost as m, builtinHubRpcDeclarations as n, hubMessagesClear as o, hubTerminalsWrite as p, hubCommandsExecute as r, hubMessagesRemove as s, createHubContext as t, hubTerminalsResize as u, prepareDevframe as v, skippedInStaticBuild as y };

package/dist/node/build.d.mts

@@ -0,0 +1,74 @@
+import { n as DevframeHubContext, t as CreateHubContextOptions } from "../context-Di-fhMKP.mjs";
+import { DevframeHubUi, DevframesInput, DockRendererRegistration } from "./initiate.mjs";
+import { DevframeServiceInput, DevframeStorageScope } from "devframe/types";
+//#region src/node/build.d.ts
+interface BuildHubOptions {
+  /**
+   * Output directory the hub subtree is written into. It corresponds to the
+   * hub {@link BuildHubOptions.base} at serve time: building with
+   * `base: '/__devframes/'` into `dist/__devframes` makes the deployed app's
+   * `dist/` servable as-is by any static file server.
+   */
+  outDir: string;
+  /**
+   * Mount base the deployed hub answers under (baked into every absolute URL
+   * the build emits: page-script rewrites, renderer modules, per-frame meta
+   * pointers). Default: `/__devframes/`.
+   */
+  base?: string;
+  /** Devframes to bake as docks, same input as `initHub({ devframes })`. */
+  devframes?: DevframesInput;
+  /** Host-level wire services, same contract as `initHub({ services })`. */
+  services?: DevframeServiceInput[];
+  /** Extra RPC declarations registered at context creation. */
+  rpcDeclarations?: CreateHubContextOptions['builtinRpcDeclarations'];
+  /**
+   * Runs once the context exists and every `devframes` entry is mounted;
+   * register docks, commands, and messages surfaces here, exactly like
+   * `initHub({ configure })`. Everything it registers is baked into the
+   * static shared-state snapshot.
+   */
+  configure?: (ctx: DevframeHubContext) => void | Promise<void>;
+  /**
+   * The hub's UI slot: the viewer SPA is copied to the hub base, the
+   * `embedded.js` bootstrap next to it, and `setup(ctx)` runs so its static
+   * config (branding, dock preferences) is baked into the connection meta.
+   */
+  ui?: DevframeHubUi;
+  /** Prebuilt dock-renderer modules, copied to `<base>__renderers/<type>.mjs`. */
+  renderers?: readonly DockRendererRegistration[];
+  /** Name written into `<base>__index.json`. */
+  name?: string;
+  /** Version written into `<base>__index.json`. */
+  version?: string;
+  /** Working directory for the hub context. Default: `process.cwd()`. */
+  cwd?: string;
+  /** Override where persisted devframe state lives during the build. */
+  getStorageDir?: (scope: DevframeStorageScope) => string;
+  /** Pretty-print RPC dump JSON files. Default: `false` (minified shards). */
+  pretty?: boolean;
+}
+/**
+ * Produce a self-contained static deploy of a whole hub, the multi-devframe
+ * counterpart of devframe's `createBuild`:
+ *
+ *   - Build a `mode: 'build'` hub context and mount every devframe: each
+ *     SPA is copied to `<outDir>/<id>/`, an absolute-path page script to
+ *     `<outDir>/<id>/__page-script/`, and its `setup(ctx)` runs.
+ *   - Copy the UI slot's viewer SPA, `embedded.js`, and the renderer
+ *     modules, and write the discovery documents (`__index.json`,
+ *     `__client-imports.js`).
+ *   - Write `__connection.json` (`{ backend: 'static' }`, carrying
+ *     `ctx.staticConfig` as `configs`) at the hub base and at every frame
+ *     base (each pointing back at the hub's own meta via `baseUrl`).
+ *   - Bake the shared RPC dump under `<outDir>/__rpc-dump/`: every
+ *     `static`/`snapshot` RPC plus a snapshot of each shared-state key
+ *     (docks, commands, renderer manifest), so `createDevframeClientRuntime`
+ *     and every frame SPA boot from the dump with no live server.
+ *
+ * Reads work from the baked dump; live writes (messages, terminals,
+ * commands execution) have no server and degrade to no-ops in the clients.
+ */
+declare function buildHub(options: BuildHubOptions): Promise<void>;
+//#endregion
+export { BuildHubOptions, buildHub };

package/dist/node/build.mjs

@@ -0,0 +1,167 @@
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY } from "../constants-Da23JxCZ.mjs";
+import { b as diagnostics, t as createHubContext } from "../context-BWaW6N53.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-Hj36CCzH.mjs";
+import { joinURL } from "ufo";
+import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME } from "devframe/constants";
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import process from "node:process";
+import { createH3DevframeHost } from "devframe/internal";
+import { collectStaticRpcDump, writeStaticRpcDump } from "devframe/rpc/dump";
+import { colors } from "devframe/utils/colors";
+import { dirname, resolve } from "pathe";
+//#region src/node/build.ts
+/**
+* Produce a self-contained static deploy of a whole hub, the multi-devframe
+* counterpart of devframe's `createBuild`:
+*
+*   - Build a `mode: 'build'` hub context and mount every devframe: each
+*     SPA is copied to `<outDir>/<id>/`, an absolute-path page script to
+*     `<outDir>/<id>/__page-script/`, and its `setup(ctx)` runs.
+*   - Copy the UI slot's viewer SPA, `embedded.js`, and the renderer
+*     modules, and write the discovery documents (`__index.json`,
+*     `__client-imports.js`).
+*   - Write `__connection.json` (`{ backend: 'static' }`, carrying
+*     `ctx.staticConfig` as `configs`) at the hub base and at every frame
+*     base (each pointing back at the hub's own meta via `baseUrl`).
+*   - Bake the shared RPC dump under `<outDir>/__rpc-dump/`: every
+*     `static`/`snapshot` RPC plus a snapshot of each shared-state key
+*     (docks, commands, renderer manifest), so `createDevframeClientRuntime`
+*     and every frame SPA boot from the dump with no live server.
+*
+* Reads work from the baked dump; live writes (messages, terminals,
+* commands execution) have no server and degrade to no-ops in the clients.
+*/
+async function buildHub(options) {
+	const base = normalizeHubBase(options.base ?? "/__devframes/");
+	const cwd = options.cwd ?? process.cwd();
+	const outDir = resolve(cwd, options.outDir);
+	const rendererRegistrations = resolveRendererRegistrations(options.renderers ?? []);
+	if (existsSync(outDir)) await fs.rm(outDir, { recursive: true });
+	await fs.mkdir(outDir, { recursive: true });
+	/** Map a hub-base-relative URL base to its on-disk location under `outDir`. */
+	function resolveOutPath(urlBase) {
+		if (!urlBase.startsWith(base)) throw diagnostics.DF8006({
+			urlBase,
+			base
+		});
+		return resolve(outDir, urlBase.slice(base.length));
+	}
+	const frameMetaBases = [];
+	const host = {
+		...createH3DevframeHost({
+			origin: "http://localhost",
+			appName: "devframes",
+			workspaceRoot: cwd,
+			/**
+			* A static build "serves" by copying: a local dist verbatim, a remote
+			* assets source by materializing every listed file.
+			*/
+			mount: async (mountBase, source) => {
+				const target = resolveOutPath(mountBase);
+				await fs.mkdir(dirname(target), { recursive: true });
+				if (typeof source === "string") await fs.cp(source, target, { recursive: true });
+				else await source.materialize(target);
+			}
+		}),
+		...options.getStorageDir ? { getStorageDir: options.getStorageDir } : {},
+		mountConnectionMeta: (frameBase) => {
+			resolveOutPath(frameBase);
+			frameMetaBases.push(frameBase);
+		}
+	};
+	const ctx = await createHubContext({
+		cwd,
+		workspaceRoot: cwd,
+		mode: "build",
+		host,
+		...options.rpcDeclarations ? { builtinRpcDeclarations: options.rpcDeclarations } : {}
+	});
+	const devframes = await resolveDevframesInput(options.devframes ?? []);
+	for (const input of options.services ?? []) ctx.services.install(input);
+	const frames = [];
+	const setups = await mountDevframes(ctx, devframes, base, frames, false);
+	await ctx.services.ready();
+	for (const run of setups) await run();
+	await options.configure?.(ctx);
+	await options.ui?.setup?.(ctx);
+	await publishRendererManifest(ctx, rendererRegistrations, base, outDir);
+	await writeUiArtifacts(options.ui, outDir);
+	await fs.writeFile(resolve(outDir, DEVFRAME_DOCK_IMPORTS_FILENAME), renderClientImportsModule(ctx), "utf-8");
+	await fs.writeFile(resolve(outDir, "__index.json"), `${JSON.stringify({
+		name: options.name,
+		version: options.version,
+		base,
+		frames,
+		endpoints: {
+			connection: DEVFRAME_CONNECTION_META_FILENAME,
+			clientImports: DEVFRAME_DOCK_IMPORTS_FILENAME,
+			index: "__index.json",
+			...options.ui?.embedded ? { embedded: "embedded.js" } : {}
+		}
+	}, null, 2)}\n`, "utf-8");
+	await writeConnectionMetas(ctx, base, outDir, frameMetaBases.map(resolveOutPath));
+	console.log(colors.cyan`[devframes-hub] writing RPC dump to ${resolve(outDir, "__rpc-dump")}`);
+	const dump = await collectStaticRpcDump(ctx.rpc.definitions.values(), ctx);
+	await writeStaticRpcDump(dump, outDir, { pretty: options.pretty });
+	console.log(colors.green`[devframes-hub] built ${frames.length} devframe${frames.length === 1 ? "" : "s"} -> ${outDir}`);
+}
+/**
+* Publish the renderer manifest exactly like `initHub` does, so it is baked
+* into the shared-state snapshot, and copy each prebuilt module to the URL
+* the manifest advertises.
+*/
+async function publishRendererManifest(ctx, registrations, base, outDir) {
+	const manifest = {};
+	for (const registration of registrations) {
+		manifest[registration.type] = {
+			importFrom: joinURL(base, "__renderers", `${registration.type}.mjs`),
+			...registration.importName ? { importName: registration.importName } : {}
+		};
+		await fs.mkdir(resolve(outDir, "__renderers"), { recursive: true });
+		await fs.copyFile(registration.file, resolve(outDir, "__renderers", `${registration.type}.mjs`));
+	}
+	(await ctx.rpc.sharedState.get(DOCK_RENDERERS_STATE_KEY, { initialValue: {} })).mutate(() => manifest);
+}
+/**
+* Copy the UI slot's artifacts: the viewer SPA owns the hub base (copied
+* before the discovery documents, so those win over same-named files it
+* ships), `embedded.js` next to it, plus any produced assets.
+*/
+async function writeUiArtifacts(ui, outDir) {
+	if (ui?.viewer) await fs.cp(resolve(ui.viewer.distDir), outDir, { recursive: true });
+	if (ui?.embedded) await fs.copyFile(resolve(ui.embedded.entry), resolve(outDir, "embedded.js"));
+	for (const [key, produce] of Object.entries(ui?.assets ?? {})) {
+		const target = resolve(outDir, key);
+		await fs.mkdir(dirname(target), { recursive: true });
+		await fs.writeFile(target, produce());
+	}
+}
+/**
+* Write the `backend: 'static'` connection meta at the hub base, and a copy
+* at every frame base whose `baseUrl` points relative resolution (the RPC
+* dump) back at the hub's own meta, so a frame SPA that fetched its
+* per-frame copy (instead of inheriting the host page's connection) still
+* finds the shared dump.
+*/
+async function writeConnectionMetas(ctx, base, outDir, frameDirs) {
+	const jsonSerializableMethods = [];
+	for (const def of ctx.rpc.definitions.values()) if (def.jsonSerializable === true) jsonSerializableMethods.push(def.name);
+	const meta = {
+		backend: "static",
+		jsonSerializableMethods,
+		...Object.keys(ctx.staticConfig).length > 0 ? { configs: ctx.staticConfig } : {}
+	};
+	await fs.writeFile(resolve(outDir, DEVFRAME_CONNECTION_META_FILENAME), JSON.stringify(meta, null, 2), "utf-8");
+	const frameMeta = {
+		...meta,
+		baseUrl: joinURL(base, DEVFRAME_CONNECTION_META_FILENAME)
+	};
+	for (const frameDir of frameDirs) {
+		const target = resolve(frameDir, DEVFRAME_CONNECTION_META_FILENAME);
+		await fs.mkdir(dirname(target), { recursive: true });
+		await fs.writeFile(target, JSON.stringify(frameMeta, null, 2), "utf-8");
+	}
+}
+//#endregion
+export { buildHub };

package/dist/node/index.mjs

@@ -1,8 +1,8 @@
-import { _ as DevframeDocksHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeMessagesHost, h as DevframeTerminalsHost, i as hubDocksActivate, l as hubTerminalsRemove, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize, v as DevframeCommandsHost } from "../context-D4L966cN.mjs";
+import { _ as DevframeCommandsHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeDocksHost, h as DevframeMessagesHost, i as hubDocksActivate, l as hubTerminalsRemove, m as DevframeTerminalsHost, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize } from "../context-BWaW6N53.mjs";
 import "ufo";
-import "pathe";
-import "node:process";
 import "node:fs";
+import "node:process";
+import "pathe";
 import { builtinModules } from "node:module";
 import "node:url";
 import assert from "node:assert";

package/dist/node/initiate.d.mts

@@ -1,7 +1,7 @@
 import { i as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-Di-fhMKP.mjs";
-import { r as DEVFRAMES_HUB_BASE } from "../constants-Coo1p3ja.mjs";
+import { r as DEVFRAMES_HUB_BASE } from "../constants-Bz4yclHo.mjs";
 import { DevframeInstanceRecord } from "devframe/internal";
-import { ConnectionMeta, DevframeDefinition, DevframeServiceInput, DevframeSseOptions, DevframeStorageScope, DevframeWsOptions, McpRouteOptions } from "devframe/types";
+import { ConnectionMeta, DevframeDefinition, DevframeServiceInput, DevframeSseOptions, DevframeStorageScope, DevframeWsOptions, McpSetting } from "devframe/types";
 import { DevframeAuthHandler } from "devframe/node/auth";
 import { WsOriginRegistry } from "devframe/rpc/transports/ws-server";
 import { Buffer } from "node:buffer";
@@ -197,14 +197,16 @@ interface InitHubOptions {
   /**
    * Expose the **aggregate** MCP endpoint at `<base>__mcp`: one
    * Streamable-HTTP server over the shared context's whole tool registry
-   * (ids are already namespaced per plugin). Disabled by default; `true`
-   * mounts it with the loopback origin gate (trusting same-machine callers),
-   * an object opts into an {@link McpRouteOptions.authorization} identity
-   * check. A mounted devframe's own `mcp` setting is ignored: the hub's
-   * aggregate route covers them all (`DF8005` warns when one asks for MCP
-   * while this is off).
+   * (ids are already namespaced per plugin). Defaults to `'auto'`: the route
+   * mounts once any mounted devframe (or an agent-flagged hub command)
+   * exposes an agent surface. `true` mounts it
+   * unconditionally with the loopback origin gate (trusting same-machine
+   * callers), an object opts into an {@link McpRouteOptions.authorization}
+   * identity check, `false` keeps it off. A mounted devframe's own `mcp`
+   * setting is ignored: the hub's aggregate route covers them all (`DF8005`
+   * warns when one asks for MCP while this is `false`).
    */
-  mcp?: boolean | McpRouteOptions;
+  mcp?: McpSetting;
   /**
    * Public origin the host app is reachable at, or a getter. Derived lazily
    * from the first request when omitted.

package/dist/node/initiate.mjs

@@ -1,19 +1,15 @@
-import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, r as DEVFRAMES_HUB_BASE } from "../constants-BUd6oMci.mjs";
-import { a as resolveClientModuleSpecifier } from "../remote-url-UClKLQ5_.mjs";
-import { m as prepareDevframe, t as createHubContext, y as diagnostics } from "../context-D4L966cN.mjs";
-import { joinURL, withTrailingSlash, withoutLeadingSlash } from "ufo";
-import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
-import { createH3DevframeHost, createInstanceShell, importRuntimeModule, resolveInstanceRegister, resolveMcpConfig } from "devframe/internal";
-import { resolve } from "pathe";
-import process from "node:process";
-import { existsSync } from "node:fs";
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, r as DEVFRAMES_HUB_BASE } from "../constants-Da23JxCZ.mjs";
+import { b as diagnostics, t as createHubContext } from "../context-BWaW6N53.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-Hj36CCzH.mjs";
+import { joinURL, withoutLeadingSlash } from "ufo";
+import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE } from "devframe/constants";
 import { readFile } from "node:fs/promises";
+import process from "node:process";
+import { createH3DevframeHost, createInstanceShell, importRuntimeModule, loadAutoMcpAdapter, resolveInstanceRegister, resolveMcpConfig } from "devframe/internal";
+import { resolve } from "pathe";
 import { mountStaticHandler } from "devframe/utils/serve-static";
 import { H3 } from "h3";
 //#region src/node/initiate.ts
-function normalizeDevframeEntry(entry) {
-	return "devframe" in entry ? entry : { devframe: entry };
-}
 /** Content-type for a UI asset key, inferred from its file extension. */
 function assetContentType(key) {
 	if (key.endsWith(".json")) return "application/json; charset=utf-8";
@@ -23,72 +19,6 @@ function assetContentType(key) {
 	if (key.endsWith(".html")) return "text/html; charset=utf-8";
 	return "application/octet-stream";
 }
-/** Reserved filenames directly under the hub base; a frame id can't shadow them. */
-const RESERVED_HUB_PATHS = [
-	DEVFRAME_CONNECTION_META_FILENAME,
-	DEVFRAME_DOCK_IMPORTS_FILENAME,
-	DEVFRAME_WS_ROUTE,
-	DEVFRAME_MCP_ROUTE,
-	"__index.json",
-	"__renderers",
-	"embedded.js"
-];
-/**
-* Flatten the `devframes` input: await every thenable, call every factory,
-* spread the arrays, and drop the empty slots, so a host can build the list
-* conditionally (`isDev && loadInspect()`) without filtering it first.
-*/
-function resolveDevframesInput(input) {
-	return Promise.all(input.map(async (entry) => {
-		const resolved = await (typeof entry === "function" ? entry() : entry);
-		return (Array.isArray(resolved) ? resolved : [resolved]).filter((slot) => slot != null).map(normalizeDevframeEntry);
-	})).then((arrays) => arrays.flat());
-}
-/**
-* Validate the renderer-module registrations fail-fast: route-safe types
-* (each becomes the `<base>__renderers/<type>.mjs` URL segment), one module
-* per type, and an existing bundle file (renderer packages are prebuilt).
-*/
-function resolveRendererRegistrations(registrations) {
-	const seen = /* @__PURE__ */ new Set();
-	return registrations.map((registration) => {
-		if (!/^[\w.-]+$/.test(registration.type)) throw diagnostics.DF8110({ type: registration.type });
-		if (seen.has(registration.type)) throw diagnostics.DF8108({ type: registration.type });
-		seen.add(registration.type);
-		const file = resolve(registration.file);
-		if (!existsSync(file)) throw diagnostics.DF8109({
-			type: registration.type,
-			file
-		});
-		return {
-			...registration,
-			file
-		};
-	});
-}
-/**
-* Render the dock client-script import map as an ES module: one dynamic
-* import thunk per dock that carries a client script (`clientScript` on
-* iframe docks, `action`, `renderer`). External viewers import this module
-* from `<base>__client-imports.js` to load per-dock client code into the
-* host page; `importFrom` values are URL paths the host serves, or bare npm
-* specifiers resolved through the host's `clientModuleResolution` template.
-*/
-function renderClientImportsModule(ctx) {
-	const template = ctx.staticConfig.dock?.clientModuleResolution;
-	const entries = [];
-	for (const [id, view] of ctx.docks.views) {
-		const scripts = [];
-		const anyView = view;
-		if (anyView.clientScript) scripts.push(anyView.clientScript);
-		if (anyView.action) scripts.push(anyView.action);
-		if (anyView.renderer) scripts.push(anyView.renderer);
-		if (scripts.length === 0) continue;
-		const thunks = scripts.map((script) => `() => import(${JSON.stringify(resolveClientModuleSpecifier(script.importFrom, { template }))})`);
-		entries.push(`  ${JSON.stringify(id)}: [${thunks.join(", ")}],`);
-	}
-	return `// Generated by @devframes/hub: dock client-script import map.\nexport const clientImports = {\n${entries.join("\n")}\n}\nexport default clientImports\n`;
-}
 /**
 * Resolve the shared hub context: reuse a caller-supplied one, or build an
 * h3-backed context that serves the hub's connection meta under every frame.
@@ -126,31 +56,6 @@ async function resolveHubContext(options, app, cwd, api) {
 	});
 }
 /**
-* Pass 1: mount each devframe under `<base><id>/` (SPA, meta, iframe dock)
-* and queue its declared services, guarding the id against reserved hub
-* filenames and route-pattern characters. Returns the deferred setup thunks.
-*/
-async function mountDevframes(ctx, devframes, base, frames, hubMcpEnabled) {
-	const setups = [];
-	for (const { devframe: def, dock } of devframes) {
-		if (RESERVED_HUB_PATHS.includes(def.id)) throw diagnostics.DF8000({ id: def.id });
-		if (!/^[\w.-]+$/.test(def.id)) throw diagnostics.DF8004({ id: def.id });
-		if (!hubMcpEnabled && def.cli?.mcp) diagnostics.DF8005({ id: def.id });
-		const frameBase = withTrailingSlash(joinURL(base, def.id));
-		const run = await prepareDevframe(ctx, def, {
-			base: frameBase,
-			...dock ? { dock } : {}
-		});
-		if (run) setups.push(run);
-		frames.push({
-			id: def.id,
-			base: frameBase,
-			title: def.name
-		});
-	}
-	return setups;
-}
-/**
 * Initiate a hub instance: the whole multi-devframe devtools surface
 * behind one framework-agnostic, web-standard handler. Every mounted
 * devframe shares one context (merged RPC registry, shared state, docks /
@@ -195,7 +100,7 @@ function initHub(options) {
 		*/
 		absoluteWsPath: true,
 		resolveSidecarPort: async (sidecarHost) => {
-			const { getPort } = await import("../dist-R0T2g9Vw.mjs");
+			const { getPort } = await import("../dist-BP3CGpgZ.mjs");
 			return getPort({
 				port: 9777,
 				portRange: [9777, 9877],
@@ -213,7 +118,7 @@ function initHub(options) {
 			};
 			const devframes = await resolveDevframesInput(options.devframes ?? []);
 			for (const input of options.services ?? []) ctx.services.install(input);
-			const setups = await mountDevframes(ctx, devframes, base, frames, !!options.mcp);
+			const setups = await mountDevframes(ctx, devframes, base, frames, options.mcp !== false);
 			await ctx.services.ready();
 			for (const run of setups) await run();
 			await options.configure?.(ctx);
@@ -224,11 +129,17 @@ function initHub(options) {
 				...registration.importName ? { importName: registration.importName } : {}
 			};
 			(await ctx.rpc.sharedState.get(DOCK_RENDERERS_STATE_KEY, { initialValue: {} })).mutate(() => manifest);
-			const mcpConfig = resolveMcpConfig(options.mcp);
+			const mcpSetting = options.mcp ?? "auto";
+			let mcpModule;
+			let mcpConfig;
+			if (mcpSetting === "auto") {
+				mcpModule = await loadAutoMcpAdapter(ctx.agent);
+				if (mcpModule) mcpConfig = { authorization: false };
+			} else mcpConfig = resolveMcpConfig(mcpSetting);
 			if (!mcpConfig) return { context: ctx };
 			const mcpRoute = withoutLeadingSlash(mcpConfig.path ?? DEVFRAME_MCP_ROUTE);
-			const { mountMcpHttp } = await importRuntimeModule("devframe/adapters/mcp");
-			const mounted = mountMcpHttp(app, ctx, joinURL(base, mcpRoute), {
+			mcpModule ??= await importRuntimeModule("devframe/adapters/mcp");
+			const mounted = mcpModule.mountMcpHttp(app, ctx, joinURL(base, mcpRoute), {
 				serverName: options.name ?? "devframes-hub",
 				serverVersion: options.version ?? "0.0.0",
 				exposeSharedState: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "Hub layer that orchestrates devframe docks, terminals, messages, and commands on any host.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -22,6 +22,7 @@
   "sideEffects": false,
   "exports": {
     ".": "./dist/index.mjs",
+    "./build": "./dist/node/build.mjs",
     "./client": "./dist/client/index.mjs",
     "./constants": "./dist/constants.mjs",
     "./initiate": "./dist/node/initiate.mjs",
@@ -34,7 +35,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.9.9"
+    "devframe": "0.9.10"
   },
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -48,7 +49,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "devframe": "0.9.9",
+    "devframe": "0.9.10",
     "get-port-please": "^3.2.0",
     "mlly": "^1.8.2",
     "tsdown": "^0.22.14",

package/dist/{dist-R0T2g9Vw.mjs → dist-BP3CGpgZ.mjs}

@@ -1,5 +1,5 @@
-import "node:path";
 import "node:fs/promises";
+import "node:path";
 import { createServer } from "node:net";
 import { networkInterfaces } from "node:os";
 //#region ../../node_modules/.pnpm/get-port-please@3.2.0/node_modules/get-port-please/dist/index.mjs