@devframes/hub 0.9.0-beta.9 → 0.9.1

package/dist/constants-CmESZCBq.d.mts

@@ -0,0 +1,105 @@
+import { t as DevframeDocksUserSettings } from "./settings-D7whfcx2.mjs";
+//#region src/events.d.ts
+/**
+ * Centralized registry of every event, broadcast, RPC method, shared-state
+ * key, and channel name the hub uses — the single source of truth that keeps
+ * these names out of scattered string literals.
+ *
+ * **Keep this in sync with [`docs/guide/events.md`](../../../docs/guide/events.md)**
+ * (the Hub Events Reference): every name here appears in that page's tables, and
+ * every name there resolves to an entry here. Add, rename, or remove a name in
+ * both places in the same change, and reference `HUB_EVENTS.*` from call sites
+ * instead of re-typing a literal.
+ *
+ * The `.events` EventEmitter maps in `types/{docks,terminals,messages,commands}.ts`
+ * and the RPC augmentation interfaces in `node/context.ts` declare these same
+ * names as type-level keys (a literal is unavoidable in a type position); those
+ * declarations mirror this map and move with it.
+ */
+declare const HUB_EVENTS: {
+  /**
+   * Internal node `EventEmitter` events on `ctx.<subsystem>.events`. Emitted
+   * and consumed inside the node process (chiefly by `createHubContext`, which
+   * fans them out onto the wire); they never cross to the browser.
+   */
+  readonly bus: {
+    readonly docksEntryUpdated: "docks:entry:updated";
+    readonly docksActivate: "docks:activate";
+    readonly terminalsSessionUpdated: "terminals:session:updated";
+    readonly messagesAdded: "messages:added";
+    readonly messagesUpdated: "messages:updated";
+    readonly messagesRemoved: "messages:removed";
+    readonly messagesCleared: "messages:cleared";
+    readonly commandsRegistered: "commands:registered";
+    readonly commandsUnregistered: "commands:unregistered";
+  };
+  /** Server RPC methods a connected client calls (client → server), `hub:` prefix. */
+  readonly rpc: {
+    readonly docksActivate: "hub:docks:activate";
+    readonly commandsExecute: "hub:commands:execute";
+    readonly messagesAdd: "hub:messages:add";
+    readonly messagesUpdate: "hub:messages:update";
+    readonly messagesRemove: "hub:messages:remove";
+    readonly messagesClear: "hub:messages:clear";
+    readonly terminalsWrite: "hub:terminals:write";
+    readonly terminalsResize: "hub:terminals:resize";
+    readonly terminalsTerminate: "hub:terminals:terminate";
+    readonly terminalsRestart: "hub:terminals:restart";
+    readonly terminalsRemove: "hub:terminals:remove";
+  };
+  /** Broadcast notifications the server pushes to clients (server → client), `devframe:` prefix. */
+  readonly broadcast: {
+    readonly docksActivate: "devframe:docks:activate";
+    readonly terminalsUpdated: "devframe:terminals:updated";
+    readonly messagesUpdated: "devframe:messages:updated";
+  };
+  /** Shared-state slot keys a hub-aware client reads (server → client), `devframe:` prefix. */
+  readonly sharedState: {
+    readonly docks: "devframe:docks";
+    readonly docksActive: "devframe:docks:active";
+    readonly commands: "devframe:commands";
+    readonly userSettings: "devframe:user-settings";
+    readonly dockRenderers: "devframe:dock-renderers";
+  };
+  /** Streaming channel ids (server → client), `devframe:` prefix. */
+  readonly stream: {
+    readonly terminals: "devframe:terminals";
+  };
+  /** `postMessage` channels for host ↔ iframe protocols, `devframe:` prefix. */
+  readonly postMessage: {
+    readonly frameNav: "devframe:frame-nav";
+  };
+};
+//#endregion
+//#region src/constants.d.ts
+/** Default mount base for a hub instance — one namespace, one catch-all. */
+declare const DEVFRAMES_HUB_BASE = "/__devframes/";
+/**
+ * Normalize a hub mount base to an absolute path with leading and trailing
+ * slashes (e.g. `devframes` → `/devframes/`), collapsing any doubled
+ * slashes the input introduced. The one implementation every hub-aware
+ * host (`@devframes/hub` itself, and the Vite/Nuxt/Next adapters) resolves
+ * `options.base` through.
+ */
+declare function normalizeHubBase(base: string): string;
+/**
+ * The default ordering weight for each known dock category — lower sorts
+ * earlier. Downstream viewers (e.g. `@vitejs/devtools-kit`) import this as the
+ * single source of truth so the hub and its viewers agree on category order.
+ * `framework` sorts first; `~builtin` (the viewer's own built-in views) last.
+ *
+ * The buckets read from "closest to your app" → "platform / analysis" →
+ * "peripheral". Gaps between the weights are intentional: a kit can interleave
+ * its own categories (or override these) without editing this table.
+ */
+declare const DEFAULT_CATEGORIES_ORDER: Record<string, number>;
+/**
+ * Shared-state slot carrying the hub's renderer manifest — one
+ * {@link import('./client/renderers').DockRendererManifest} entry per dock
+ * `type`, published by `initHub({ renderers })` and consumed by every
+ * hub-aware client (the headless client host and viewers alike).
+ */
+declare const DOCK_RENDERERS_STATE_KEY: string;
+declare const DEFAULT_STATE_USER_SETTINGS: () => DevframeDocksUserSettings;
+//#endregion
+export { normalizeHubBase as a, DOCK_RENDERERS_STATE_KEY as i, DEFAULT_STATE_USER_SETTINGS as n, HUB_EVENTS as o, DEVFRAMES_HUB_BASE as r, DEFAULT_CATEGORIES_ORDER as t };

package/dist/constants.d.mts

@@ -1,34 +1,3 @@
-import { t as DevframeDocksUserSettings } from "./settings-DfrRa9Wf.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-CmESZCBq.mjs";
 export * from "devframe/constants";
-//#region src/constants.d.ts
-/** Default mount base for a hub instance — one namespace, one catch-all. */
-declare const DEVFRAMES_HUB_BASE = "/__devframes/";
-/**
- * Normalize a hub mount base to an absolute path with leading and trailing
- * slashes (e.g. `devframes` → `/devframes/`), collapsing any doubled
- * slashes the input introduced. The one implementation every hub-aware
- * host (`@devframes/hub` itself, and the Vite/Nuxt/Next adapters) resolves
- * `options.base` through.
- */
-declare function normalizeHubBase(base: string): string;
-/**
- * The default ordering weight for each known dock category — lower sorts
- * earlier. Downstream viewers (e.g. `@vitejs/devtools-kit`) import this as the
- * single source of truth so the hub and its viewers agree on category order.
- * `framework` sorts first; `~builtin` (the viewer's own built-in views) last.
- *
- * The buckets read from "closest to your app" → "platform / analysis" →
- * "peripheral". Gaps between the weights are intentional: a kit can interleave
- * its own categories (or override these) without editing this table.
- */
-declare const DEFAULT_CATEGORIES_ORDER: Record<string, number>;
-/**
- * Shared-state slot carrying the hub's renderer manifest — one
- * {@link import('./client/renderers').DockRendererManifest} entry per dock
- * `type`, published by `initHub({ renderers })` and consumed by every
- * hub-aware client (the headless client host and viewers alike).
- */
-declare const DOCK_RENDERERS_STATE_KEY = "devframe:dock-renderers";
-declare const DEFAULT_STATE_USER_SETTINGS: () => DevframeDocksUserSettings;
-//#endregion
-export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, normalizeHubBase };
+export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, HUB_EVENTS, normalizeHubBase };

package/dist/constants.mjs

@@ -1,53 +1,3 @@
-import { cleanDoubleSlashes, withLeadingSlash, withTrailingSlash } from "ufo";
+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-C2b2cACy.mjs";
 export * from "devframe/constants";
-//#region src/constants.ts
-/** Default mount base for a hub instance — one namespace, one catch-all. */
-const DEVFRAMES_HUB_BASE = "/__devframes/";
-/**
-* Normalize a hub mount base to an absolute path with leading and trailing
-* slashes (e.g. `devframes` → `/devframes/`), collapsing any doubled
-* slashes the input introduced. The one implementation every hub-aware
-* host (`@devframes/hub` itself, and the Vite/Nuxt/Next adapters) resolves
-* `options.base` through.
-*/
-function normalizeHubBase(base) {
-	return cleanDoubleSlashes(withTrailingSlash(withLeadingSlash(base)));
-}
-/**
-* The default ordering weight for each known dock category — lower sorts
-* earlier. Downstream viewers (e.g. `@vitejs/devtools-kit`) import this as the
-* single source of truth so the hub and its viewers agree on category order.
-* `framework` sorts first; `~builtin` (the viewer's own built-in views) last.
-*
-* The buckets read from "closest to your app" → "platform / analysis" →
-* "peripheral". Gaps between the weights are intentional: a kit can interleave
-* its own categories (or override these) without editing this table.
-*/
-const DEFAULT_CATEGORIES_ORDER = {
-	"framework": -100,
-	"default": 0,
-	"app": 100,
-	"ui": 150,
-	"data": 250,
-	"web": 300,
-	"performance": 350,
-	"advanced": 400,
-	"docs": 500,
-	"~builtin": 1e3
-};
-/**
-* Shared-state slot carrying the hub's renderer manifest — one
-* {@link import('./client/renderers').DockRendererManifest} entry per dock
-* `type`, published by `initHub({ renderers })` and consumed by every
-* hub-aware client (the headless client host and viewers alike).
-*/
-const DOCK_RENDERERS_STATE_KEY = "devframe:dock-renderers";
-const DEFAULT_STATE_USER_SETTINGS = () => ({
-	docksHidden: [],
-	docksCategoriesHidden: [],
-	docksPinned: [],
-	docksCustomOrder: {},
-	commandShortcuts: {}
-});
-//#endregion
-export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, normalizeHubBase };
+export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, HUB_EVENTS, normalizeHubBase };

package/dist/{context-DzqMQ2mI.mjs → context-90I4t0S3.mjs}

@@ -1,6 +1,6 @@
 import { r as defineHubRpcFunction } from "./define-Ceekw2EO.mjs";
-import { DEFAULT_STATE_USER_SETTINGS } from "./constants.mjs";
-import { t as buildRemoteConnectionUrl } from "./remote-url-KVXtKP47.mjs";
+import { n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS } from "./constants-C2b2cACy.mjs";
+import { i as isBareModuleSpecifier, t as buildRemoteConnectionUrl } from "./remote-url-Bgc7gtsP.mjs";
 import { createEventEmitter } from "devframe/utils/events";
 import { createHostContext, createStorage } from "devframe/node";
 import { getInternalContext, resolveBasePath } from "devframe/node/hub-internals";
@@ -74,6 +74,10 @@ const diagnostics = defineDiagnostics({
 			why: (p) => `Dock type "${p.type}" is not a servable renderer-module name — the hub serves each module at \`<base>__renderers/<type>.mjs\``,
 			fix: "Renderer types become URL segments, so they may only contain letters, digits, `_`, `-`, and `.`. Use a route-safe dock type (e.g. `json-render`)."
 		},
+		DF8111: {
+			why: (p) => `Dock "${p.id}" declares the bare-specifier client script "${p.specifier}", but this host advertises no client-module resolution — the browser cannot resolve a bare npm specifier natively, so the script will fail to load.`,
+			fix: "Run under a host that declares `initHub({ clientModuleResolution })` (e.g. Vite's `'/@id/{specifier}'`), ship the script as a self-contained bundle served by URL, or resolve it in the viewer via `createDevframeClientHost({ resolveClientModule })` (then disregard this warning)."
+		},
 		DF8200: { why: (p) => `Terminal session with id "${p.id}" already registered` },
 		DF8201: { why: (p) => `Terminal session with id "${p.id}" not registered` },
 		DF8202: {
@@ -152,7 +156,7 @@ var DevframeCommandsHost = class {
 		validateCommandIds(this.commands, command);
 		this.validateAgentExposure(command);
 		this.commands.set(command.id, command);
-		this.events.emit("command:registered", this.toSerializable(command));
+		this.events.emit(HUB_EVENTS.bus.commandsRegistered, this.toSerializable(command));
 		this.agentProvider?.notifyChanged();
 		return {
 			id: command.id,
@@ -168,7 +172,7 @@ var DevframeCommandsHost = class {
 				validateCommandIds(this.commands, next, existing.id);
 				this.validateAgentExposure(next);
 				Object.assign(existing, patch);
-				this.events.emit("command:registered", this.toSerializable(existing));
+				this.events.emit(HUB_EVENTS.bus.commandsRegistered, this.toSerializable(existing));
 				this.agentProvider?.notifyChanged();
 			},
 			unregister: () => this.unregister(command.id)
@@ -177,7 +181,7 @@ var DevframeCommandsHost = class {
 	unregister(id) {
 		const deleted = this.commands.delete(id);
 		if (deleted) {
-			this.events.emit("command:unregistered", id);
+			this.events.emit(HUB_EVENTS.bus.commandsUnregistered, id);
 			this.agentProvider?.notifyChanged();
 		}
 		return deleted;
@@ -259,7 +263,7 @@ var DevframeDocksHost = class {
 		this.context = context;
 	}
 	async init() {
-		this.userSettings = await this.context.rpc.sharedState.get("devframe:user-settings", { sharedState: createStorage({
+		this.userSettings = await this.context.rpc.sharedState.get(HUB_EVENTS.sharedState.userSettings, { sharedState: createStorage({
 			filepath: join(this.context.host.getStorageDir("project"), "settings.json"),
 			initialValue: DEFAULT_STATE_USER_SETTINGS()
 		}) });
@@ -290,9 +294,10 @@ var DevframeDocksHost = class {
 	register(view, force) {
 		if (this.views.has(view.id) && !force) throw diagnostics.DF8100({ id: view.id });
 		this.validateGroupMembership(view);
+		this.warnUnresolvableClientScript(view);
 		this.prepareRemoteRegistration(view);
 		this.views.set(view.id, view);
-		this.events.emit("dock:entry:updated", view);
+		this.events.emit(HUB_EVENTS.bus.docksEntryUpdated, view);
 		return { update: (patch) => {
 			if (patch.id && patch.id !== view.id) throw diagnostics.DF8101({
 				id: view.id,
@@ -309,15 +314,30 @@ var DevframeDocksHost = class {
 		this.validateGroupMembership(view);
 		this.prepareRemoteRegistration(view);
 		this.views.set(view.id, view);
-		this.events.emit("dock:entry:updated", view);
+		this.events.emit(HUB_EVENTS.bus.docksEntryUpdated, view);
 	}
 	activate(dockId, params) {
 		if (!this.views.has(dockId)) diagnostics.DF8107({ id: dockId });
-		this.events.emit("dock:activate", {
+		this.events.emit(HUB_EVENTS.bus.docksActivate, {
 			dockId,
 			params
 		});
 	}
+	/**
+	* Warn (don't throw — a viewer-side `resolveClientModule` may still cover
+	* it) when a dock declares a **bare-specifier** client script on a host
+	* that advertises no `staticConfig.dock.clientModuleResolution`: the
+	* browser cannot resolve a bare npm specifier natively, so the script is
+	* doomed to fail there.
+	*/
+	warnUnresolvableClientScript(view) {
+		if (this.context.staticConfig?.dock?.clientModuleResolution) return;
+		const script = view.clientScript ?? view.action ?? view.renderer;
+		if (script?.importFrom && isBareModuleSpecifier(script.importFrom)) diagnostics.DF8111({
+			id: view.id,
+			specifier: script.importFrom
+		});
+	}
 	validateGroupMembership(view) {
 		if (view.groupId === void 0) return;
 		if (view.groupId === view.id) throw diagnostics.DF8103({ id: view.id });
@@ -395,7 +415,7 @@ var DevframeMessagesHost = class {
 		}
 		this.entries.set(entry.id, entry);
 		this.lastModified.set(entry.id, this._tick());
-		this.events.emit("message:added", entry);
+		this.events.emit(HUB_EVENTS.bus.messagesAdded, entry);
 		if (entry.autoDelete) this._autoDeleteTimers.set(entry.id, setTimeout(() => {
 			this.remove(entry.id);
 		}, entry.autoDelete));
@@ -413,7 +433,7 @@ var DevframeMessagesHost = class {
 		};
 		this.entries.set(id, updated);
 		this.lastModified.set(id, this._tick());
-		this.events.emit("message:updated", updated);
+		this.events.emit(HUB_EVENTS.bus.messagesUpdated, updated);
 		if (patch.autoDelete !== void 0) {
 			const timer = this._autoDeleteTimers.get(id);
 			if (timer) {
@@ -435,7 +455,7 @@ var DevframeMessagesHost = class {
 		this.entries.delete(id);
 		this.lastModified.delete(id);
 		this._recordRemoval(id, this._tick());
-		this.events.emit("message:removed", id);
+		this.events.emit(HUB_EVENTS.bus.messagesRemoved, id);
 	}
 	info(message, extra) {
 		return this.add({
@@ -479,7 +499,7 @@ var DevframeMessagesHost = class {
 		for (const id of this.entries.keys()) this._recordRemoval(id, tick);
 		this.entries.clear();
 		this.lastModified.clear();
-		this.events.emit("message:cleared");
+		this.events.emit(HUB_EVENTS.bus.messagesCleared);
 	}
 	listSince(since) {
 		const version = this._clock;
@@ -523,7 +543,7 @@ var DevframeMessagesHost = class {
 * Channel name used for terminal stream output. Stable, well-known so
 * hub-aware clients can subscribe by name.
 */
-const TERMINAL_STREAM_CHANNEL = "devframe:terminals";
+const TERMINAL_STREAM_CHANNEL = HUB_EVENTS.stream.terminals;
 const TERMINAL_REPLAY_WINDOW = 1e3;
 /** Max chunks retained in the per-session scrollback buffer (bounded like the replay window). */
 const TERMINAL_BUFFER_LIMIT = 1e3;
@@ -553,7 +573,7 @@ var DevframeTerminalsHost = class {
 		if (this.sessions.has(session.id)) throw diagnostics.DF8200({ id: session.id });
 		this.sessions.set(session.id, session);
 		this.bindStream(session);
-		this.events.emit("terminal:session:updated", session);
+		this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 		return session;
 	}
 	update(patch) {
@@ -562,12 +582,12 @@ var DevframeTerminalsHost = class {
 		Object.assign(session, patch);
 		this.sessions.set(patch.id, session);
 		this.bindStream(session);
-		this.events.emit("terminal:session:updated", session);
+		this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 	}
 	remove(session) {
 		this._boundStreams.get(session.id)?.dispose();
 		this.sessions.delete(session.id);
-		this.events.emit("terminal:session:updated", session);
+		this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 		this._boundStreams.delete(session.id);
 	}
 	bindStream(session) {
@@ -621,7 +641,7 @@ var DevframeTerminalsHost = class {
 		const markStatus = (next) => {
 			if (session.status === next) return;
 			session.status = next;
-			this.events.emit("terminal:session:updated", session);
+			this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 		};
 		const closeStream = () => {
 			if (streamClosed) return;
@@ -755,7 +775,7 @@ var DevframeTerminalsHost = class {
 		const markStatus = (next) => {
 			if (session.status === next) return;
 			session.status = next;
-			this.events.emit("terminal:session:updated", session);
+			this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 		};
 		const closeStream = () => {
 			if (streamClosed) return;
@@ -923,6 +943,7 @@ async function installDevframe(ctx, d, options = {}) {
 		type: "iframe",
 		url: base
 	});
+	for (const input of d.services ?? []) ctx.services.install(input, { resolveFrom: d.packageName });
 	await d.setup(ctx);
 }
 //#endregion
@@ -957,7 +978,7 @@ function resolveControllableSession(sessions, id) {
 * from the shared state and dispatch by id via this RPC.
 */
 const hubCommandsExecute = defineHubRpcFunction({
-	name: "hub:commands:execute",
+	name: HUB_EVENTS.rpc.commandsExecute,
 	type: "action",
 	setup: (context) => ({ async handler(id, ...args) {
 		return context.commands.execute(id, ...args);
@@ -973,7 +994,7 @@ const hubCommandsExecute = defineHubRpcFunction({
 * dock client script can report into the same feed the server writes to.
 */
 const hubMessagesAdd = defineHubRpcFunction({
-	name: "hub:messages:add",
+	name: HUB_EVENTS.rpc.messagesAdd,
 	type: "action",
 	jsonSerializable: true,
 	setup: (context) => ({ async handler(input) {
@@ -985,7 +1006,7 @@ const hubMessagesAdd = defineHubRpcFunction({
 });
 /** `hub:messages:update` — Patch a message by id; returns the updated entry (or `undefined`). */
 const hubMessagesUpdate = defineHubRpcFunction({
-	name: "hub:messages:update",
+	name: HUB_EVENTS.rpc.messagesUpdate,
 	type: "action",
 	jsonSerializable: true,
 	setup: (context) => ({ async handler(id, patch) {
@@ -994,7 +1015,7 @@ const hubMessagesUpdate = defineHubRpcFunction({
 });
 /** `hub:messages:remove` — Remove a message by id. */
 const hubMessagesRemove = defineHubRpcFunction({
-	name: "hub:messages:remove",
+	name: HUB_EVENTS.rpc.messagesRemove,
 	type: "action",
 	setup: (context) => ({ async handler(id) {
 		await context.messages.remove(id);
@@ -1002,7 +1023,7 @@ const hubMessagesRemove = defineHubRpcFunction({
 });
 /** `hub:messages:clear` — Remove every message. */
 const hubMessagesClear = defineHubRpcFunction({
-	name: "hub:messages:clear",
+	name: HUB_EVENTS.rpc.messagesClear,
 	type: "action",
 	setup: (context) => ({ async handler() {
 		await context.messages.clear();
@@ -1014,7 +1035,7 @@ const hubMessagesClear = defineHubRpcFunction({
 * terminals plugin) drive a session owned by another plugin.
 */
 const hubTerminalsWrite = defineHubRpcFunction({
-	name: "hub:terminals:write",
+	name: HUB_EVENTS.rpc.terminalsWrite,
 	type: "action",
 	setup: (context) => ({ async handler(id, data) {
 		resolveInteractiveSession(context.terminals.sessions, id).write(data);
@@ -1022,7 +1043,7 @@ const hubTerminalsWrite = defineHubRpcFunction({
 });
 /** `hub:terminals:resize` — Resize an interactive PTY session by id. */
 const hubTerminalsResize = defineHubRpcFunction({
-	name: "hub:terminals:resize",
+	name: HUB_EVENTS.rpc.terminalsResize,
 	type: "action",
 	setup: (context) => ({ async handler(id, cols, rows) {
 		resolveInteractiveSession(context.terminals.sessions, id).resize(cols, rows);
@@ -1035,7 +1056,7 @@ const hubTerminalsResize = defineHubRpcFunction({
 * force-kill a session owned by another plugin.
 */
 const hubTerminalsTerminate = defineHubRpcFunction({
-	name: "hub:terminals:terminate",
+	name: HUB_EVENTS.rpc.terminalsTerminate,
 	type: "action",
 	setup: (context) => ({ async handler(id) {
 		await resolveControllableSession(context.terminals.sessions, id).terminate();
@@ -1047,7 +1068,7 @@ const hubTerminalsTerminate = defineHubRpcFunction({
 * elsewhere.
 */
 const hubTerminalsRestart = defineHubRpcFunction({
-	name: "hub:terminals:restart",
+	name: HUB_EVENTS.rpc.terminalsRestart,
 	type: "action",
 	setup: (context) => ({ async handler(id) {
 		const session = resolveControllableSession(context.terminals.sessions, id);
@@ -1061,7 +1082,7 @@ const hubTerminalsRestart = defineHubRpcFunction({
 * terminal UI discard a stopped aggregated session.
 */
 const hubTerminalsRemove = defineHubRpcFunction({
-	name: "hub:terminals:remove",
+	name: HUB_EVENTS.rpc.terminalsRemove,
 	type: "action",
 	setup: (context) => ({ async handler(id) {
 		const session = context.terminals.sessions.get(id);
@@ -1084,7 +1105,7 @@ const hubTerminalsRemove = defineHubRpcFunction({
 * mounts in response still converges on it).
 */
 const hubDocksActivate = defineHubRpcFunction({
-	name: "hub:docks:activate",
+	name: HUB_EVENTS.rpc.docksActivate,
 	type: "action",
 	setup: (context) => ({ async handler(input) {
 		context.docks.activate(input.dockId, input.params);
@@ -1133,48 +1154,48 @@ async function createHubContext(options) {
 	context.install = (devframe, options) => installDevframe(context, devframe, options);
 	await docks.init();
 	const debounceMs = options.mode === "build" ? 0 : 10;
-	const docksSharedState = await context.rpc.sharedState.get("devframe:docks", { initialValue: [] });
+	const docksSharedState = await context.rpc.sharedState.get(HUB_EVENTS.sharedState.docks, { initialValue: [] });
 	const refreshDocks = debounce(() => {
 		docksSharedState.mutate(() => docks.values());
 	}, debounceMs);
-	docks.events.on("dock:entry:updated", refreshDocks);
+	docks.events.on(HUB_EVENTS.bus.docksEntryUpdated, refreshDocks);
 	getInternalContext(context).onWsEndpointChange(refreshDocks);
 	docksSharedState.mutate(() => docks.values());
-	const activeDockSharedState = await context.rpc.sharedState.get("devframe:docks:active", { initialValue: { activation: null } });
-	docks.events.on("dock:activate", (activation) => {
+	const activeDockSharedState = await context.rpc.sharedState.get(HUB_EVENTS.sharedState.docksActive, { initialValue: { activation: null } });
+	docks.events.on(HUB_EVENTS.bus.docksActivate, (activation) => {
 		activeDockSharedState.mutate((state) => {
 			state.activation = activation;
 		});
 		context.rpc.broadcast({
-			method: "devframe:docks:activate",
+			method: HUB_EVENTS.broadcast.docksActivate,
 			args: [activation]
 		});
 	});
 	const broadcastTerminals = debounce(() => {
 		context.rpc.broadcast({
-			method: "devframe:terminals:updated",
+			method: HUB_EVENTS.broadcast.terminalsUpdated,
 			args: []
 		});
 		docksSharedState.mutate(() => docks.values());
 	}, debounceMs);
-	terminals.events.on("terminal:session:updated", broadcastTerminals);
+	terminals.events.on(HUB_EVENTS.bus.terminalsSessionUpdated, broadcastTerminals);
 	const broadcastMessages = debounce(() => {
 		context.rpc.broadcast({
-			method: "devframe:messages:updated",
+			method: HUB_EVENTS.broadcast.messagesUpdated,
 			args: []
 		});
 		docksSharedState.mutate(() => docks.values());
 	}, debounceMs);
-	messages.events.on("message:added", broadcastMessages);
-	messages.events.on("message:updated", broadcastMessages);
-	messages.events.on("message:removed", broadcastMessages);
-	messages.events.on("message:cleared", broadcastMessages);
-	const commandsSharedState = await context.rpc.sharedState.get("devframe:commands", { initialValue: [] });
+	messages.events.on(HUB_EVENTS.bus.messagesAdded, broadcastMessages);
+	messages.events.on(HUB_EVENTS.bus.messagesUpdated, broadcastMessages);
+	messages.events.on(HUB_EVENTS.bus.messagesRemoved, broadcastMessages);
+	messages.events.on(HUB_EVENTS.bus.messagesCleared, broadcastMessages);
+	const commandsSharedState = await context.rpc.sharedState.get(HUB_EVENTS.sharedState.commands, { initialValue: [] });
 	const syncCommands = debounce(() => {
 		commandsSharedState.mutate(() => commands.list());
 	}, debounceMs);
-	commands.events.on("command:registered", syncCommands);
-	commands.events.on("command:unregistered", syncCommands);
+	commands.events.on(HUB_EVENTS.bus.commandsRegistered, syncCommands);
+	commands.events.on(HUB_EVENTS.bus.commandsUnregistered, syncCommands);
 	commandsSharedState.mutate(() => commands.list());
 	return context;
 }

package/dist/{context-D5TJIHwp.d.mts → context-BVkxwz5k.d.mts}

@@ -1,4 +1,4 @@
-import { b as DevframeDockEntryIcon, k as DevframeViewIframe, l as DevframeCommandsHost, m as DevframeDockActivation, w as DevframeDocksHost } from "./settings-DfrRa9Wf.mjs";
+import { b as DevframeDockEntryIcon, k as DevframeViewIframe, l as DevframeCommandsHost, m as DevframeDockActivation, w as DevframeDocksHost } from "./settings-D7whfcx2.mjs";
 import { CreateHostContextOptions } from "devframe/node";
 import { DevframeDefinition, DevframeHost, DevframeNodeContext, EventEmitter } from "devframe/types";
 import { ChildProcess } from "node:child_process";
@@ -207,10 +207,10 @@ interface DevframeMessagesListDelta {
 interface DevframeMessagesHost extends DevframeMessagesLevelShortcuts {
   readonly entries: Map<string, DevframeMessageEntry>;
   readonly events: EventEmitter<{
-    'message:added': (entry: DevframeMessageEntry) => void;
-    'message:updated': (entry: DevframeMessageEntry) => void;
-    'message:removed': (id: string) => void;
-    'message:cleared': () => void;
+    'messages:added': (entry: DevframeMessageEntry) => void;
+    'messages:updated': (entry: DevframeMessageEntry) => void;
+    'messages:removed': (id: string) => void;
+    'messages:cleared': () => void;
   }>;
   /**
    * Add a new message entry. If an entry with the same `id` already exists, it will be updated instead.
@@ -244,7 +244,7 @@ interface DevframeMessagesHost extends DevframeMessagesLevelShortcuts {
 interface DevframeTerminalsHost {
   readonly sessions: Map<string, DevframeTerminalSession>;
   readonly events: EventEmitter<{
-    'terminal:session:updated': (session: DevframeTerminalSession) => void;
+    'terminals:session:updated': (session: DevframeTerminalSession) => void;
   }>;
   register: (session: DevframeTerminalSession) => DevframeTerminalSession;
   update: (session: DevframeTerminalSession) => void;

package/dist/{index-coDmWngQ.d.mts → index-CyEyZHB3.d.mts}

@@ -1,5 +1,5 @@
-import "./context-D5TJIHwp.mjs";
-import "./settings-DfrRa9Wf.mjs";
+import "./context-BVkxwz5k.mjs";
+import "./settings-D7whfcx2.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";
 export { RpcStreamingHost as S, RpcFunctionsHost as _, DevframeHost$1 as a, RpcStreamingChannel as b, DevframeRpcServerFunctions as c, EventEmitter$1 as d, EventUnsubscribe as f, RpcDefinitionsToFunctions as g, RpcDefinitionsFilter as h, DevframeDiagnosticsLogger as i, DevframeRpcSharedStates as l, RpcBroadcastOptions as m, DevframeCapabilities as n, DevframeNodeRpcSession as o, EventsMap as p, DevframeDiagnosticsHost as r, DevframeRpcClientFunctions as s, ConnectionMeta$1 as t, DevframeViewHost as u, RpcSharedStateGetOptions as v, RpcStreamingChannelOptions as x, RpcSharedStateHost as y };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { C as DevframeMessageHandle, D as DevframeMessagesHost, E as DevframeMessagesClient, O as DevframeMessagesLevelShortcuts, S as DevframeMessageFilePosition, T as DevframeMessageShortcutInput, _ as DevframeMessageCommandAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageEntryFrom, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, g as DevframeMessageActivateAction, h as DevframeMessageAction, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalStatus, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyTerminalSession, v as DevframeMessageElementPosition, w as DevframeMessageLevel, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "./context-D5TJIHwp.mjs";
-import { A as DevframeViewLauncher, C as DevframeDocksActiveState, D as DevframeViewCustomRender, E as DevframeViewBuiltin, F as RemoteDockOptions, M as FrameSubTabsConfig, N as NavTarget, O as DevframeViewGroup, P as RemoteConnectionInfo, S as DevframeDockUserEntry, T as DevframeViewAction, _ 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 DevframeViewLauncherStatus, k as DevframeViewIframe, 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 DevframeDocksHost, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "./settings-DfrRa9Wf.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-coDmWngQ.mjs";
+import { C as DevframeMessageHandle, D as DevframeMessagesHost, E as DevframeMessagesClient, O as DevframeMessagesLevelShortcuts, S as DevframeMessageFilePosition, T as DevframeMessageShortcutInput, _ as DevframeMessageCommandAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageEntryFrom, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, g as DevframeMessageActivateAction, h as DevframeMessageAction, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalStatus, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyTerminalSession, v as DevframeMessageElementPosition, w as DevframeMessageLevel, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "./context-BVkxwz5k.mjs";
+import { A as DevframeViewLauncher, C as DevframeDocksActiveState, D as DevframeViewCustomRender, E as DevframeViewBuiltin, F as RemoteDockOptions, M as FrameSubTabsConfig, N as NavTarget, O as DevframeViewGroup, P as RemoteConnectionInfo, S as DevframeDockUserEntry, T as DevframeViewAction, _ 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 DevframeViewLauncherStatus, k as DevframeViewIframe, 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 DevframeDocksHost, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "./settings-D7whfcx2.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-CyEyZHB3.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/index.d.mts

@@ -1,5 +1,5 @@
-import { C as DevframeMessageHandle, D as DevframeMessagesHost$1, T as DevframeMessageShortcutInput, a as DevframeChildProcessExecuteOptions, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, i as InstallDevframeOptions, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost$1, n as DevframeHubContext, r as createHubContext, t as CreateHubContextOptions, u as DevframePtyTerminalSession, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "../context-D5TJIHwp.mjs";
-import { S as DevframeDockUserEntry, _ as DevframeDockEntry, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, l as DevframeCommandsHost$1, o as DevframeCommandHandle, p as ClientScriptEntry, t as DevframeDocksUserSettings, w as DevframeDocksHost$1 } from "../settings-DfrRa9Wf.mjs";
+import { C as DevframeMessageHandle, D as DevframeMessagesHost$1, T as DevframeMessageShortcutInput, a as DevframeChildProcessExecuteOptions, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, i as InstallDevframeOptions, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost$1, n as DevframeHubContext, r as createHubContext, t as CreateHubContextOptions, u as DevframePtyTerminalSession, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "../context-BVkxwz5k.mjs";
+import { S as DevframeDockUserEntry, _ as DevframeDockEntry, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, l as DevframeCommandsHost$1, o as DevframeCommandHandle, p as ClientScriptEntry, t as DevframeDocksUserSettings, w as DevframeDocksHost$1 } from "../settings-D7whfcx2.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { SharedState } from "devframe/utils/shared-state";
 //#region src/node/host-commands.d.ts
@@ -51,6 +51,14 @@ declare class DevframeDocksHost implements DevframeDocksHost$1 {
   };
   update(view: DevframeDockUserEntry): void;
   activate(dockId: string, params?: Record<string, unknown>): void;
+  /**
+   * Warn (don't throw — a viewer-side `resolveClientModule` may still cover
+   * it) when a dock declares a **bare-specifier** client script on a host
+   * that advertises no `staticConfig.dock.clientModuleResolution`: the
+   * browser cannot resolve a bare npm specifier natively, so the script is
+   * doomed to fail there.
+   */
+  private warnUnresolvableClientScript;
   private validateGroupMembership;
   private prepareRemoteRegistration;
 }