@devframes/hub 0.9.9 → 0.9.11

package/dist/assemble-BvY5jfgi.mjs

@@ -0,0 +1,99 @@
+import { a as resolveClientModuleSpecifier } from "./remote-url-UClKLQ5_.mjs";
+import { v as prepareDevframe, y as diagnostics } from "./context-Cdrtg-Kk.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;
+* each mounted frame is recorded on `ctx.frames`.
+*/
+async function mountDevframes(ctx, devframes, base, 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);
+	}
+	return setups;
+}
+//#endregion
+export { resolveRendererRegistrations as i, renderClientImportsModule as n, resolveDevframesInput as r, mountDevframes as t };

package/dist/client/index.d.mts

@@ -1,6 +1,6 @@
-import { C as DevframeMessageEntryInput, O as DevframeMessagesClient } from "../context-Di-fhMKP.mjs";
+import { k as DevframeMessagesClient, w as DevframeMessageEntryInput } from "../context-BmHQp89a.mjs";
 import { A as DevframeViewIframe, C as DevframeDockUserEntry, F as RemoteConnectionInfo, P as NavTarget, S as DevframeDockPanelState, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, g as DevframeDockEntriesGrouped, n as DevframeClientCommand, p as ClientScriptEntry, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings } from "../settings-CWHPzCWS.mjs";
-import "../index-faD2d5iX.mjs";
+import "../index-Dv8iu9St.mjs";
 import { DevframeClientRpcHost, DevframeConnection, DevframeConnectionStatus, DevframeRpcClient, DevframeRpcClientOptions, DevframeRpcContext, RpcClientEvents, RpcClientEvents as RpcClientEvents$1 } from "devframe/client";
 import { EventEmitter } from "devframe/types";
 import { SharedState } from "devframe/utils/shared-state";

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-Di-fhMKP.d.mts → context-BmHQp89a.d.mts}

@@ -476,6 +476,20 @@ declare module 'devframe/types' {
     'hub:terminals:resize': (id: string, cols: number, rows: number) => Promise<void>;
   }
 }
+/**
+ * A devframe mounted into a hub context, recorded as it is installed
+ * (whether through `initHub({ devframes })`, `buildHub`, or `ctx.install`).
+ * Enumerable via {@link DevframeHubContext.frames} so a host that mounted the
+ * context itself can still discover what to advertise in `__index.json`.
+ */
+interface HubMountedFrame {
+  /** Dock id the devframe mounted under (disambiguated for duplicates). */
+  id: string;
+  /** Hub-base-relative mount base of the frame's SPA (trailing slash). */
+  base: string;
+  /** Human title (the definition's `name`). */
+  title: string;
+}
 /**
  * Hub-augmented node context that extends devframe's framework-neutral
  * `DevframeNodeContext` with the hub-level subsystems (`docks`,
@@ -495,6 +509,13 @@ interface DevframeHubContext extends DevframeNodeContext {
   terminals: DevframeTerminalsHost;
   messages: DevframeMessagesHost;
   commands: DevframeCommandsHost;
+  /**
+   * Every devframe mounted into this context, in mount order. Populated by
+   * `ctx.install` (and the batch mount `initHub`/`buildHub` run through it),
+   * so a host that assembled and mounted the context itself can hand it to
+   * `buildHub({ context })` to emit the discovery documents.
+   */
+  readonly frames: readonly HubMountedFrame[];
   /**
    * Install a {@link DevframeDefinition} into this hub: serve its SPA at the
    * resolved base, synthesize an iframe dock from its metadata, and run its
@@ -518,4 +539,4 @@ interface CreateHubContextOptions extends CreateHostContextOptions {}
  */
 declare function createHubContext(options: CreateHubContextOptions): Promise<DevframeHubContext>;
 //#endregion
-export { DevframeMessagesLevelShortcuts as A, DevframeMessageEntryInput as C, DevframeMessageShortcutInput as D, DevframeMessageLevel as E, DevframeMessagesClient as O, DevframeMessageEntryFrom as S, DevframeMessageHandle as T, DevframeMessageAction as _, DevframeChildProcessExecuteOptions as a, DevframeMessageElementPosition as b, DevframeChildProcessTerminalSession as c, DevframePtyResult as d, DevframePtyTerminalSession as f, DevframeTerminalsHost as g, DevframeTerminalStatus as h, InstallDevframeOptions as i, DevframeMessagesListDelta as j, DevframeMessagesHost as k, DevframePtyExecuteOptions as l, DevframeTerminalSessionBase as m, DevframeHubContext as n, DevframeChildProcessOutput as o, DevframeTerminalSession as p, createHubContext as r, DevframeChildProcessResult as s, CreateHubContextOptions as t, DevframePtyOutput as u, DevframeMessageActivateAction as v, DevframeMessageFilePosition as w, DevframeMessageEntry as x, DevframeMessageCommandAction as y };
+export { DevframeMessagesHost as A, DevframeMessageEntryFrom as C, DevframeMessageLevel as D, DevframeMessageHandle as E, DevframeMessagesListDelta as M, DevframeMessageShortcutInput as O, DevframeMessageEntry as S, DevframeMessageFilePosition as T, DevframeTerminalsHost as _, InstallDevframeOptions as a, DevframeMessageCommandAction as b, DevframeChildProcessResult as c, DevframePtyOutput as d, DevframePtyResult as f, DevframeTerminalStatus as g, DevframeTerminalSessionBase as h, createHubContext as i, DevframeMessagesLevelShortcuts as j, DevframeMessagesClient as k, DevframeChildProcessTerminalSession as l, DevframeTerminalSession as m, DevframeHubContext as n, DevframeChildProcessExecuteOptions as o, DevframePtyTerminalSession as p, HubMountedFrame as r, DevframeChildProcessOutput as s, CreateHubContextOptions as t, DevframePtyExecuteOptions as u, DevframeMessageAction as v, DevframeMessageEntryInput as w, DevframeMessageElementPosition as x, DevframeMessageActivateAction as y };

package/dist/{context-D4L966cN.mjs → context-Cdrtg-Kk.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.
@@ -32,8 +32,8 @@ const diagnostics = defineDiagnostics({
 			fix: "The filenames directly under the hub base (`__connection.json`, `__ws`, `__index.json`, `__client-imports.js`, `__mcp`, `embedded.js`) are reserved for the hub protocol. Rename the devframe id, or override its mount with a non-colliding `basePath`."
 		},
 		DF8002: {
-			why: "initHub received both `devframes` and `context`; the two assembly modes are mutually exclusive.",
-			fix: "Pass `devframes` to let the instance create the hub context and mount each frame itself, or pass a pre-built `context` (your host already mounted the frames), but never both."
+			why: "`initHub`/`buildHub` received both `devframes` and `context`; the two assembly modes are mutually exclusive.",
+			fix: "Pass `devframes` to let it create the hub context and mount each frame itself, or pass a pre-built `context` (your host already mounted the frames), but never both."
 		},
 		DF8003: {
 			why: "connectionMeta() was called before initHub finished initializing.",
@@ -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,139 @@ 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"));
+	ctx.views.hostStatic(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.frames.push({
+		id,
+		base,
+		title: d.name
+	});
+	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 +1089,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
@@ -1275,6 +1293,7 @@ async function createHubContext(options) {
 	context.terminals = terminals;
 	context.messages = messages;
 	context.commands = commands;
+	context.frames = [];
 	context.install = (devframe, options) => installDevframe(context, devframe, options);
 	await docks.init();
 	const debounceMs = options.mode === "build" ? 0 : 10;
@@ -1324,4 +1343,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, 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, diagnostics as y };

package/dist/{index-faD2d5iX.d.mts → index-Dv8iu9St.d.mts}

@@ -1,4 +1,4 @@
-import "./context-Di-fhMKP.mjs";
+import "./context-BmHQp89a.mjs";
 import "./settings-CWHPzCWS.mjs";
 import { RpcDefinitionsFilter, RpcDefinitionsToFunctions } from "devframe/rpc";
 import { ConnectionMeta as ConnectionMeta$1, DevframeCapabilities, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeHost as DevframeHost$1, DevframeNodeRpcSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeViewHost, EventEmitter as EventEmitter$1, EventUnsubscribe, EventsMap, RpcBroadcastOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost } from "devframe/types";

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { A as DevframeMessagesLevelShortcuts, C as DevframeMessageEntryInput, D as DevframeMessageShortcutInput, E as DevframeMessageLevel, O as DevframeMessagesClient, S as DevframeMessageEntryFrom, T as DevframeMessageHandle, _ as DevframeMessageAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageElementPosition, c as DevframeChildProcessTerminalSession, d as DevframePtyResult, f as DevframePtyTerminalSession, g as DevframeTerminalsHost, h as DevframeTerminalStatus, j as DevframeMessagesListDelta, k as DevframeMessagesHost, l as DevframePtyExecuteOptions, m as DevframeTerminalSessionBase, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalSession, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyOutput, v as DevframeMessageActivateAction, w as DevframeMessageFilePosition, x as DevframeMessageEntry, y as DevframeMessageCommandAction } from "./context-Di-fhMKP.mjs";
+import { A as DevframeMessagesHost, C as DevframeMessageEntryFrom, D as DevframeMessageLevel, E as DevframeMessageHandle, M as DevframeMessagesListDelta, O as DevframeMessageShortcutInput, S as DevframeMessageEntry, T as DevframeMessageFilePosition, _ as DevframeTerminalsHost, b as DevframeMessageCommandAction, c as DevframeChildProcessResult, d as DevframePtyOutput, f as DevframePtyResult, g as DevframeTerminalStatus, h as DevframeTerminalSessionBase, j as DevframeMessagesLevelShortcuts, k as DevframeMessagesClient, l as DevframeChildProcessTerminalSession, m as DevframeTerminalSession, n as DevframeHubContext, o as DevframeChildProcessExecuteOptions, p as DevframePtyTerminalSession, s as DevframeChildProcessOutput, t as CreateHubContextOptions, u as DevframePtyExecuteOptions, v as DevframeMessageAction, w as DevframeMessageEntryInput, x as DevframeMessageElementPosition, y as DevframeMessageActivateAction } from "./context-BmHQp89a.mjs";
 import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, S as DevframeDockPanelState, T as DevframeDocksHost, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, c as DevframeCommandShortcutOverrides, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntriesGrouped, h as DevframeDockBadgeVariant, i as DevframeCommandBase, j as DevframeViewLauncher, k as DevframeViewGroup, l as DevframeCommandsHost, m as DevframeDockActivation, n as DevframeClientCommand, o as DevframeCommandHandle, p as ClientScriptEntry, r as DevframeCommandAgentOptions, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings, u as DevframeCommandsHostEvents, v as DevframeDockEntryBase, w as DevframeDocksActiveState, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "./settings-CWHPzCWS.mjs";
-import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "./index-faD2d5iX.mjs";
+import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "./index-Dv8iu9St.mjs";
 import { WhenContext, WhenExpression } from "devframe/utils/when";
 //#region src/define.d.ts
 declare const defineHubRpcFunction: <NAME extends string, TYPE extends import("devframe/rpc").RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends import("devframe/rpc").RpcArgsSchema | undefined = undefined, const RS extends import("devframe/rpc").RpcReturnSchema | undefined = undefined>(definition: import("devframe/rpc").RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeHubContext>) => import("devframe/rpc").RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeHubContext>;

package/dist/node/build.d.mts

@@ -0,0 +1,93 @@
+import { n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BmHQp89a.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;
+  /**
+   * Bring your own already-mounted hub context instead of `devframes`, the
+   * build counterpart of `initHub({ context })`: a host that assembled
+   * `createHubContext` + `ctx.install` itself (Vite DevTools' kit-augmented
+   * context, devframes mounted from Vite plugins) hands the mounted context
+   * here and `buildHub` bakes it, reading `ctx.frames` and
+   * `ctx.views.buildStaticDirs` for what to emit. `configure` and the UI
+   * slot's `setup` still run against it, so pass them here rather than running
+   * them yourself. Mutually exclusive with `devframes`.
+   */
+  context?: DevframeHubContext;
+  /** 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;
+  /**
+   * Remove {@link BuildHubOptions.outDir} before writing. Default `true`,
+   * matching a from-scratch build. Pass `false` to bake into a directory that
+   * already holds sibling output (an app's own `dist/` the hub subtree lives
+   * beside).
+   */
+  clean?: 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 (or reuse a
+ *     `context` a host mounted itself): 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,198 @@
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY } from "../constants-Da23JxCZ.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-Cdrtg-Kk.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-BvY5jfgi.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 { resolveStaticAssetsSource } from "devframe/utils/remote-assets";
+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 (or reuse a
+*     `context` a host mounted itself): 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) {
+	if (options.context && options.devframes?.length) throw diagnostics.DF8002();
+	const base = normalizeHubBase(options.base ?? "/__devframes/");
+	const cwd = options.cwd ?? process.cwd();
+	const outDir = resolve(cwd, options.outDir);
+	const rendererRegistrations = resolveRendererRegistrations(options.renderers ?? []);
+	const ctx = options.context ?? await createAndMountContext(options, base, cwd);
+	await options.configure?.(ctx);
+	await options.ui?.setup?.(ctx);
+	if (options.clean !== false && 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`. */
+	const resolveOutPath = (urlBase) => {
+		if (!urlBase.startsWith(base)) throw diagnostics.DF8006({
+			urlBase,
+			base
+		});
+		return resolve(outDir, urlBase.slice(base.length));
+	};
+	await copyBuildStatics(ctx, resolveOutPath);
+	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 writeHubIndex(ctx, base, outDir, options);
+	await writeConnectionMetas(ctx, base, outDir, 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 });
+	const count = ctx.frames.length;
+	console.log(colors.green`[devframes-hub] built ${count} devframe${count === 1 ? "" : "s"} -> ${outDir}`);
+}
+/**
+* Build a `mode: 'build'` hub context and mount the `devframes` input. The host
+* copies nothing live (`mountStatic`/`mountConnectionMeta` are no-ops): every
+* static is copied afterwards from `ctx.views.buildStaticDirs`, and each frame's
+* meta is written from `ctx.frames`.
+*/
+async function createAndMountContext(options, base, cwd) {
+	const host = {
+		...createH3DevframeHost({
+			origin: "http://localhost",
+			appName: "devframes",
+			workspaceRoot: cwd,
+			mount: () => {}
+		}),
+		...options.getStorageDir ? { getStorageDir: options.getStorageDir } : {},
+		mountConnectionMeta: () => {}
+	};
+	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 setups = await mountDevframes(ctx, devframes, base, false);
+	await ctx.services.ready();
+	for (const run of setups) await run();
+	return ctx;
+}
+/**
+* Copy every static the context registered through `ctx.views.hostStatic`
+* (recorded in `ctx.views.buildStaticDirs`): a local dir verbatim, a remote
+* source by materializing every listed file. Reads the list rather than
+* relying on a live host `mountStatic`, so a context whose host copied no
+* statics at mount time (the build host, or a kit's) still gets its assets in.
+* Each source re-resolves with the `resolveFrom` it was mounted with, so a
+* remote source (e.g. a plugin's `--assets` package) resolves to the same
+* locally-installed copy it would serve live.
+*/
+async function copyBuildStatics(ctx, resolveOutPath) {
+	const storageDir = ctx.host.getStorageDir("project");
+	for (const { baseUrl, source, resolveFrom } of ctx.views.buildStaticDirs) {
+		const target = resolveOutPath(baseUrl);
+		const resolved = resolveStaticAssetsSource(source, storageDir, resolveFrom);
+		await fs.mkdir(dirname(target), { recursive: true });
+		if (typeof resolved === "string") await fs.cp(resolved, target, { recursive: true });
+		else await resolved.materialize(target);
+	}
+}
+/**
+* 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 `<base>__index.json`: the discovery document listing every frame. */
+async function writeHubIndex(ctx, base, outDir, options) {
+	await fs.writeFile(resolve(outDir, "__index.json"), `${JSON.stringify({
+		name: options.name,
+		version: options.version,
+		base,
+		frames: ctx.frames.map(({ id, base, title }) => ({
+			id,
+			base,
+			title
+		})),
+		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");
+}
+/**
+* Write the `backend: 'static'` connection meta at the hub base, and a copy at
+* every frame base that served its own SPA (i.e. registered a static mount at
+* that 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, resolveOutPath) {
+	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)
+	};
+	const servedBases = new Set(ctx.views.buildStaticDirs.map((dir) => dir.baseUrl));
+	for (const frame of ctx.frames) {
+		if (!servedBases.has(frame.base)) continue;
+		const target = resolve(resolveOutPath(frame.base), 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.d.mts

@@ -1,4 +1,4 @@
-import { C as DevframeMessageEntryInput, D as DevframeMessageShortcutInput, T as DevframeMessageHandle, a as DevframeChildProcessExecuteOptions, c as DevframeChildProcessTerminalSession, f as DevframePtyTerminalSession, g as DevframeTerminalsHost$1, i as InstallDevframeOptions, j as DevframeMessagesListDelta, k as DevframeMessagesHost$1, l as DevframePtyExecuteOptions, m as DevframeTerminalSessionBase, n as DevframeHubContext, p as DevframeTerminalSession, r as createHubContext, t as CreateHubContextOptions, x as DevframeMessageEntry } from "../context-Di-fhMKP.mjs";
+import { A as DevframeMessagesHost$1, E as DevframeMessageHandle, M as DevframeMessagesListDelta, O as DevframeMessageShortcutInput, S as DevframeMessageEntry, _ as DevframeTerminalsHost$1, a as InstallDevframeOptions, h as DevframeTerminalSessionBase, i as createHubContext, l as DevframeChildProcessTerminalSession, m as DevframeTerminalSession, n as DevframeHubContext, o as DevframeChildProcessExecuteOptions, p as DevframePtyTerminalSession, r as HubMountedFrame, t as CreateHubContextOptions, u as DevframePtyExecuteOptions, w as DevframeMessageEntryInput } from "../context-BmHQp89a.mjs";
 import { C as DevframeDockUserEntry, T as DevframeDocksHost$1, _ as DevframeDockEntry, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, l as DevframeCommandsHost$1, o as DevframeCommandHandle, p as ClientScriptEntry, t as DevframeDocksUserSettings } from "../settings-CWHPzCWS.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { SharedState } from "devframe/utils/shared-state";
@@ -388,4 +388,4 @@ declare const builtinHubRpcDeclarations: readonly RpcFunctionDefinitionAny[];
  */
 declare function createSimpleClientScript(fn: string | ((ctx: any) => void)): ClientScriptEntry;
 //#endregion
-export { CreateHubContextOptions, DevframeCommandsHost, DevframeDocksHost, DevframeHubContext, DevframeMessagesHost, DevframeTerminalsHost, type InstallDevframeOptions, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubDocksActivate, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsRemove, hubTerminalsResize, hubTerminalsRestart, hubTerminalsTerminate, hubTerminalsWrite };
+export { CreateHubContextOptions, DevframeCommandsHost, DevframeDocksHost, DevframeHubContext, DevframeMessagesHost, DevframeTerminalsHost, HubMountedFrame, type InstallDevframeOptions, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubDocksActivate, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsRemove, hubTerminalsResize, hubTerminalsRestart, hubTerminalsTerminate, hubTerminalsWrite };

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-Cdrtg-Kk.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 { a as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BmHQp89a.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 { t as createHubContext, y as diagnostics } from "../context-Cdrtg-Kk.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-BvY5jfgi.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 /
@@ -170,7 +75,6 @@ function initHub(options) {
 	const baseNoSlash = base.slice(0, -1);
 	const app = new H3();
 	const cwd = options.cwd ?? process.cwd();
-	const frames = [];
 	const rendererRegistrations = resolveRendererRegistrations(options.renderers ?? []);
 	const shell = createInstanceShell({
 		base,
@@ -195,7 +99,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 +117,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, options.mcp !== false);
 			await ctx.services.ready();
 			for (const run of setups) await run();
 			await options.configure?.(ctx);
@@ -224,11 +128,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,
@@ -247,7 +157,11 @@ function initHub(options) {
 				name: options.name,
 				version: options.version,
 				base,
-				frames,
+				frames: ctx.frames.map(({ id, base, title }) => ({
+					id,
+					base,
+					title
+				})),
 				endpoints: {
 					connection: DEVFRAME_CONNECTION_META_FILENAME,
 					clientImports: DEVFRAME_DOCK_IMPORTS_FILENAME,

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { A as DevframeMessagesLevelShortcuts, C as DevframeMessageEntryInput, D as DevframeMessageShortcutInput, E as DevframeMessageLevel, O as DevframeMessagesClient, S as DevframeMessageEntryFrom, T as DevframeMessageHandle, _ as DevframeMessageAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageElementPosition, c as DevframeChildProcessTerminalSession, d as DevframePtyResult, f as DevframePtyTerminalSession, g as DevframeTerminalsHost, h as DevframeTerminalStatus, j as DevframeMessagesListDelta, k as DevframeMessagesHost, l as DevframePtyExecuteOptions, m as DevframeTerminalSessionBase, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalSession, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyOutput, v as DevframeMessageActivateAction, w as DevframeMessageFilePosition, x as DevframeMessageEntry, y as DevframeMessageCommandAction } from "../context-Di-fhMKP.mjs";
+import { A as DevframeMessagesHost, C as DevframeMessageEntryFrom, D as DevframeMessageLevel, E as DevframeMessageHandle, M as DevframeMessagesListDelta, O as DevframeMessageShortcutInput, S as DevframeMessageEntry, T as DevframeMessageFilePosition, _ as DevframeTerminalsHost, b as DevframeMessageCommandAction, c as DevframeChildProcessResult, d as DevframePtyOutput, f as DevframePtyResult, g as DevframeTerminalStatus, h as DevframeTerminalSessionBase, j as DevframeMessagesLevelShortcuts, k as DevframeMessagesClient, l as DevframeChildProcessTerminalSession, m as DevframeTerminalSession, n as DevframeHubContext, o as DevframeChildProcessExecuteOptions, p as DevframePtyTerminalSession, s as DevframeChildProcessOutput, t as CreateHubContextOptions, u as DevframePtyExecuteOptions, v as DevframeMessageAction, w as DevframeMessageEntryInput, x as DevframeMessageElementPosition, y as DevframeMessageActivateAction } from "../context-BmHQp89a.mjs";
 import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, S as DevframeDockPanelState, T as DevframeDocksHost, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, c as DevframeCommandShortcutOverrides, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntriesGrouped, h as DevframeDockBadgeVariant, i as DevframeCommandBase, j as DevframeViewLauncher, k as DevframeViewGroup, l as DevframeCommandsHost, m as DevframeDockActivation, n as DevframeClientCommand, o as DevframeCommandHandle, p as ClientScriptEntry, r as DevframeCommandAgentOptions, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings, u as DevframeCommandsHostEvents, v as DevframeDockEntryBase, w as DevframeDocksActiveState, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "../settings-CWHPzCWS.mjs";
-import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "../index-faD2d5iX.mjs";
+import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "../index-Dv8iu9St.mjs";
 export { ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessOutput, DevframeChildProcessResult, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandAgentOptions, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, DevframeDockActivation, DevframeDockBadgeVariant, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockEntryRegistry, DevframeDockPanelState, DevframeDockUserEntry, DevframeDocksActiveState, DevframeDocksHost, DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, DevframeMessageAction, DevframeMessageActivateAction, DevframeMessageCommandAction, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessageShortcutInput, DevframeMessagesClient, DevframeMessagesHost, DevframeMessagesLevelShortcuts, DevframeMessagesListDelta, type DevframeNodeRpcSession, DevframePtyExecuteOptions, DevframePtyOutput, DevframePtyResult, DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, type DevframeViewHost, DevframeViewIframe, DevframeViewLauncher, DevframeViewLauncherStatus, type EventEmitter, type EventUnsubscribe, type EventsMap, FrameSubTabsConfig, NavTarget, RemoteConnectionInfo, RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.9.9",
+  "version": "0.9.11",
   "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.11"
   },
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -48,7 +49,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "devframe": "0.9.9",
+    "devframe": "0.9.11",
     "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