@devframes/hub 1.2.5 → 1.3.0

package/dist/{assemble-CK2TX0FM.mjs → assemble-BO0n24su.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveClientModuleSpecifier } from "./remote-url-UClKLQ5_.mjs";
-import { v as prepareDevframe, y as diagnostics } from "./context-DRdTViYd.mjs";
+import { v as prepareDevframe, y as diagnostics } from "./context-0RunDMBy.mjs";
 import { joinURL, withTrailingSlash } from "devframe/utils/url";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
 import { existsSync } from "node:fs";

package/dist/client/index.d.mts

@@ -1,7 +1,7 @@
-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-DPLPzYfX.mjs";
-import { n as resolveTitle, t as matchLocale } from "../locale-C3-NpDlX.mjs";
-import { k as DevframeMessagesClient, w as DevframeMessageEntryInput } from "../context-BK50aJ-F.mjs";
-import "../index-BvEO3eOd.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-UN5GnTei.mjs";
+import { n as resolveTitle, t as matchLocale } from "../locale-CGR6YyCP.mjs";
+import { k as DevframeMessagesClient, w as DevframeMessageEntryInput } from "../context-Iy5i89Aq.mjs";
+import "../index-tijpvneP.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";
@@ -183,13 +183,18 @@ export interface DockSessionStorage {
    */
   selectedDockRoute: string | null;
   /**
-   * The dock entry most recently selected from beyond the float bar's inline
-   * capacity, whether from the overflow popover or from inside a dock group. A hub UI
-   * provider raises this entry into a dedicated slot between the bar's visible
-   * items and the overflow button, so deselecting it (or selecting a visible
-   * neighbour) keeps it one click away instead of folding it straight back
-   * into the overflow. `null` (or absent, for stores persisted before this
-   * field existed) when no entry has been raised.
+   * The dock entries most recently selected from beyond the float bar's
+   * inline capacity, whether from the overflow popover or from inside a dock
+   * group, newest first. A hub UI provider raises these entries into their own
+   * slots after the bar's visible items, so they stay one click away instead
+   * of folding back into the overflow or the group popover. Absent (for stores
+   * persisted before this field existed) or empty when nothing has been raised.
+   */
+  recentDockIds?: string[];
+  /**
+   * @deprecated Superseded by {@link DockSessionStorage.recentDockIds}. Still
+   * read as a one-entry list when `recentDockIds` is absent, so a tab that
+   * persisted the older field keeps its recent dock after an upgrade.
    */
   recentDockId?: string | null;
   /**
@@ -322,6 +327,14 @@ export interface DocksEntriesContext {
    * @returns Whether the selection was changed successfully
    */
   toggleEntry: (id: string) => Promise<boolean>;
+  /**
+   * Turn a {@link import('../types/docks').DevframeViewAction.toggle toggle action}
+   * on or off without touching the selection. Turning it on hides an open panel;
+   * turning it off restores that panel.
+   *
+   * @returns Whether the action's state changed
+   */
+  setActionActive: (id: string, active: boolean) => Promise<boolean>;
   /**
    * Register a **client-only** dock entry, live in this page and merged with
    * the server-provided docks (`devframe:docks` shared state) into
@@ -353,6 +366,7 @@ export interface DockRegistration<T extends DevframeDockEntry = DevframeDockEntr
 }
 export interface DockEntryState {
   entryMeta: DevframeDockEntry;
+  /** Whether the entry is selected, or, for a toggle action, whether it is on. */
   readonly isActive: boolean;
   domElements: {
     iframe?: HTMLIFrameElement | null;

package/dist/client/index.mjs

@@ -587,6 +587,10 @@ async function createDevframeClientRuntime(options = {}) {
 		rpc.sharedState.get(DOCK_RENDERERS_STATE_KEY, { initialValue: {} })
 	]);
 	let selectedId = null;
+	/** Toggle actions that are on; they never take the selection. */
+	const activeActions = /* @__PURE__ */ new Set();
+	/** Whether turning the last toggle action off should reopen the panel it hid. */
+	let reopenPanel = false;
 	/** Bumped by every `switchEntry` call, so a stale one can tell it was superseded. */
 	let switchRequest = 0;
 	const entryToStateMap = /* @__PURE__ */ new Map();
@@ -672,7 +676,7 @@ async function createDevframeClientRuntime(options = {}) {
 		return {
 			entryMeta,
 			get isActive() {
-				return selectedId === entryMeta.id;
+				return selectedId === entryMeta.id || activeActions.has(entryMeta.id);
 			},
 			domElements: {},
 			events: createEventEmitter()
@@ -731,6 +735,7 @@ async function createDevframeClientRuntime(options = {}) {
 			if (seen.has(id)) continue;
 			const removed = entryToStateMap.get(id);
 			entryToStateMap.delete(id);
+			if (activeActions.delete(id) && activeActions.size === 0) restorePanel();
 			const removedMeta = removed?.entryMeta;
 			if (removedMeta?.type === "iframe" && removedMeta.subTabs) {
 				const frameId = removedMeta.frameId ?? id;
@@ -775,6 +780,7 @@ async function createDevframeClientRuntime(options = {}) {
 			getStateById: (id) => entryToStateMap.get(id),
 			switchEntry,
 			toggleEntry: (id) => selectedId === id ? switchEntry(null) : switchEntry(id),
+			setActionActive,
 			register(entry, force) {
 				if (clientDocks.has(entry.id) && !force) throw new Error(`[@devframes/hub] a client dock "${entry.id}" is already registered; pass force to overwrite`);
 				clientDocks.set(entry.id, entry);
@@ -811,8 +817,56 @@ async function createDevframeClientRuntime(options = {}) {
 		if (entry.type === "action") await setupClientScript(entry.id, entry.action, false);
 		else if (entry.type === "custom-render") await setupClientScript(entry.id, entry.renderer);
 	}
+	function isToggleAction(entry) {
+		return entry?.type === "action" && !!entry.toggle;
+	}
+	function restorePanel() {
+		if (reopenPanel) panel.session.open = true;
+		reopenPanel = false;
+	}
+	/** A new selection wins over the panel a toggle action hid, so it is not restored. */
+	function turnOffActions() {
+		reopenPanel = false;
+		for (const id of [...activeActions]) {
+			activeActions.delete(id);
+			entryToStateMap.get(id)?.events.emit("entry:deactivated");
+		}
+	}
+	async function setActionActive(id, active) {
+		const state = entryToStateMap.get(id);
+		const entry = state?.entryMeta;
+		if (!state || entry?.type !== "action" || !entry.toggle || activeActions.has(id) === active) return false;
+		if (!active) {
+			activeActions.delete(id);
+			state.events.emit("entry:deactivated");
+			if (activeActions.size === 0) restorePanel();
+			return true;
+		}
+		if (loadScriptsEnabled) {
+			if (!rpc.isTrusted) return false;
+			await setupClientScript(id, entry.action);
+			if (disposed || activeActions.has(id) || entryToStateMap.get(id) !== state) return false;
+		}
+		if (activeActions.size === 0) {
+			reopenPanel = panel.session.open;
+			panel.session.open = false;
+		}
+		activeActions.add(id);
+		state.events.emit("entry:activated");
+		return true;
+	}
+	/** A click flips a toggle action; clearing an empty selection still turns tools off. */
+	function switchToggleAction(next) {
+		if (next !== null && isToggleAction(entryToStateMap.get(next)?.entryMeta)) return setActionActive(next, !activeActions.has(next));
+		if (next === null && selectedId === null && activeActions.size > 0) {
+			turnOffActions();
+			return Promise.resolve(true);
+		}
+	}
 	async function switchEntry(id) {
 		const next = id ?? null;
+		const toggled = switchToggleAction(next);
+		if (toggled) return toggled;
 		if (next === selectedId && entryToStateMap.get(next ?? "")?.entryMeta.type !== "action") return false;
 		if (next !== null && !entryToStateMap.has(next)) return false;
 		const entry = entryToStateMap.get(next ?? "")?.entryMeta;
@@ -822,6 +876,7 @@ async function createDevframeClientRuntime(options = {}) {
 		if (request !== switchRequest) return false;
 		const previous = selectedId;
 		selectedId = next;
+		turnOffActions();
 		panel.session.selectedDockId = next;
 		if (next === null || entryToStateMap.get(next)?.entryMeta.type !== "iframe") panel.session.selectedDockRoute = null;
 		if (previous) entryToStateMap.get(previous)?.events.emit("entry:deactivated");

package/dist/{constants-C7cDDASI.d.mts → constants-H0A2VIz0.d.mts}

@@ -1,4 +1,4 @@
-import { t as DevframeDocksUserSettings } from "./settings-DPLPzYfX.mjs";
+import { t as DevframeDocksUserSettings } from "./settings-UN5GnTei.mjs";
 //#region src/events.d.ts
 /**
  * Centralized registry of every event, broadcast, RPC method, shared-state

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-C7cDDASI.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-H0A2VIz0.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-DRdTViYd.mjs → context-0RunDMBy.mjs}

@@ -12,6 +12,7 @@ import { getInternalContext, resolveBasePath } from "devframe/node/hub-internals
 import { createHostContext, createStorage } from "devframe/node";
 import { debounce } from "devframe/utils/debounce";
 import { nanoid } from "devframe/utils/nanoid";
+import { extname, resolve as resolve$1 } from "node:path";
 //#region src/node/diagnostics.ts
 /**
 * Hub-side diagnostics for docks, terminals, messages, and commands.
@@ -671,6 +672,66 @@ var DevframeMessagesHost = class {
 	}
 };
 //#endregion
+//#region src/node/pty-command.ts
+const DEFAULT_PATHEXT = ".COM;.EXE;.BAT;.CMD";
+const CMD_META_CHARS = /[()[\]%!^"`<>&|;, *?]/g;
+function resolvePtyCommand(command, args, { cwd, env, platform = process.platform }) {
+	if (platform !== "win32") return {
+		command,
+		args
+	};
+	const comSpec = getEnv(env, "ComSpec") || "cmd.exe";
+	if (isCmd(command, comSpec)) return {
+		command,
+		args
+	};
+	const resolved = findExecutable(command, cwd, env);
+	const ext = resolved ? extname(resolved).toLowerCase() : "";
+	if (ext === ".exe" || ext === ".com") return {
+		command,
+		args
+	};
+	const isBatch = ext === ".cmd" || ext === ".bat";
+	return {
+		command: comSpec,
+		args: [
+			"/d",
+			"/c",
+			escapeCmd(command, false),
+			...args.map((arg) => escapeCmd(arg, isBatch))
+		]
+	};
+}
+function getEnv(env, name) {
+	const key = Object.keys(env).findLast((key) => key.toLowerCase() === name.toLowerCase());
+	return key ? env[key] : void 0;
+}
+function isCmd(command, comSpec) {
+	const name = command.toLowerCase();
+	return name === comSpec.toLowerCase() || name === "cmd" || name === "cmd.exe";
+}
+function findExecutable(command, cwd, env) {
+	const extensions = (getEnv(env, "PATHEXT") || DEFAULT_PATHEXT).toLowerCase().split(";").filter(Boolean);
+	const candidates = extname(command) ? [command, ...extensions.map((ext) => command + ext)] : extensions.map((ext) => command + ext);
+	const searchCwd = getEnv(env, "NoDefaultCurrentDirectoryInExePath") === void 0;
+	const dirs = /[\\/]/.test(command) ? [cwd] : [...searchCwd ? [cwd] : [], ...(getEnv(env, "PATH") || "").split(";").filter(Boolean)];
+	for (const dir of dirs) for (const candidate of candidates) {
+		const file = resolve$1(dir, candidate);
+		if (existsSync(file)) return file;
+	}
+}
+/**
+* Escape `cmd.exe` metacharacters in an argument zigpty passes unquoted.
+* zigpty double-quotes empty arguments and ones with a space, tab, quote or
+* backslash, and `cmd.exe` keeps quoted metacharacters literal, so those
+* are left alone - a `^` added there would reach the program as-is.
+*/
+function escapeCmd(arg, doubleEscape) {
+	if (!arg || /[ \t"\\]/.test(arg)) return arg;
+	const escaped = arg.replace(CMD_META_CHARS, "^$&");
+	return doubleEscape ? escaped.replace(CMD_META_CHARS, "^$&") : escaped;
+}
+//#endregion
 //#region src/node/host-terminals.ts
 /**
 * Channel name used for terminal stream output. Stable, well-known so
@@ -971,18 +1032,24 @@ var DevframeTerminalsHost = class {
 		});
 		const spawnPty = () => {
 			const currentRun = ++runId;
-			const ptyProcess = spawn(executeOptions.command, executeOptions.args ?? [], {
+			const cwd = executeOptions.cwd ?? process.cwd();
+			const env = {
+				...process.env,
+				TERM: PTY_TERM_NAME,
+				COLORTERM: "truecolor",
+				FORCE_COLOR: "1",
+				...executeOptions.env ?? {}
+			};
+			const { command, args } = resolvePtyCommand(executeOptions.command, executeOptions.args ?? [], {
+				cwd,
+				env
+			});
+			const ptyProcess = spawn(command, args, {
 				name: PTY_TERM_NAME,
 				cols,
 				rows,
-				cwd: executeOptions.cwd ?? process.cwd(),
-				env: {
-					...process.env,
-					TERM: PTY_TERM_NAME,
-					COLORTERM: "truecolor",
-					FORCE_COLOR: "1",
-					...executeOptions.env ?? {}
-				}
+				cwd,
+				env
 			});
 			const outputChunks = [];
 			let killed = false;

package/dist/{context-BK50aJ-F.d.mts → context-Iy5i89Aq.d.mts}

@@ -1,4 +1,4 @@
-import { A as DevframeViewIframe, T as DevframeDocksHost, b as DevframeDockEntryIcon, l as DevframeCommandsHost, m as DevframeDockActivation } from "./settings-DPLPzYfX.mjs";
+import { A as DevframeViewIframe, T as DevframeDocksHost, b as DevframeDockEntryIcon, l as DevframeCommandsHost, m as DevframeDockActivation } from "./settings-UN5GnTei.mjs";
 import { CreateHostContextOptions } from "devframe/node";
 import { DevframeDefinition, DevframeHost, DevframeNodeContext, EventEmitter } from "devframe/types";
 import { ChildProcess } from "node:child_process";

package/dist/{index-BvEO3eOd.d.mts → index-tijpvneP.d.mts}

@@ -1,5 +1,5 @@
-import "./settings-DPLPzYfX.mjs";
-import "./context-BK50aJ-F.mjs";
+import "./settings-UN5GnTei.mjs";
+import "./context-Iy5i89Aq.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,7 +1,7 @@
-import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, L as DevframeTitleLocales, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, R as DevframeTitled, 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-DPLPzYfX.mjs";
-import { n as resolveTitle, t as matchLocale } from "./locale-C3-NpDlX.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-BK50aJ-F.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-BvEO3eOd.mjs";
+import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, L as DevframeTitleLocales, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, R as DevframeTitled, 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-UN5GnTei.mjs";
+import { n as resolveTitle, t as matchLocale } from "./locale-CGR6YyCP.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-Iy5i89Aq.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-tijpvneP.mjs";
 import { WhenContext, WhenExpression } from "devframe/utils/when";
 //#region src/define.d.ts
 export 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/{locale-C3-NpDlX.d.mts → locale-CGR6YyCP.d.mts}

@@ -1,4 +1,4 @@
-import { R as DevframeTitled } from "./settings-DPLPzYfX.mjs";
+import { R as DevframeTitled } from "./settings-UN5GnTei.mjs";
 //#region src/locale.d.ts
 /**
  * Pick the tag in `available` closest to `tag`: exact match first, then

package/dist/node/build.d.mts

@@ -1,4 +1,4 @@
-import { n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BK50aJ-F.mjs";
+import { n as DevframeHubContext, t as CreateHubContextOptions } from "../context-Iy5i89Aq.mjs";
 import { DevframeHubUi, DevframesInput, DockRendererRegistration } from "./initiate.mjs";
 import { DevframeServiceInput, DevframeStorageScope } from "devframe/types";
 //#region src/node/build.d.ts

package/dist/node/build.mjs

@@ -1,6 +1,6 @@
 import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY } from "../constants-BSPQmlA1.mjs";
-import { t as createHubContext, y as diagnostics } from "../context-DRdTViYd.mjs";
-import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-CK2TX0FM.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-0RunDMBy.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-BO0n24su.mjs";
 import { joinURL } from "devframe/utils/url";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME } from "devframe/constants";
 import { existsSync } from "node:fs";

package/dist/node/index.d.mts

@@ -1,5 +1,5 @@
-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-DPLPzYfX.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-BK50aJ-F.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-UN5GnTei.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-Iy5i89Aq.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { SharedState } from "devframe/utils/shared-state";
 //#region src/node/host-commands.d.ts

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-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-DRdTViYd.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-0RunDMBy.mjs";
 import { Buffer } from "node:buffer";
 //#region src/node/utils.ts
 function toDataURL(code) {

package/dist/node/initiate.d.mts

@@ -1,5 +1,5 @@
-import { a as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BK50aJ-F.mjs";
-import { r as DEVFRAMES_HUB_BASE } from "../constants-C7cDDASI.mjs";
+import { a as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-Iy5i89Aq.mjs";
+import { r as DEVFRAMES_HUB_BASE } from "../constants-H0A2VIz0.mjs";
 import { DevframeInstanceRecord } from "devframe/internal";
 import { Buffer } from "node:buffer";
 import { AuthBannerFunction } from "devframe/recipes/interactive-auth";

package/dist/node/initiate.mjs

@@ -1,6 +1,6 @@
 import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, r as DEVFRAMES_HUB_BASE } from "../constants-BSPQmlA1.mjs";
-import { t as createHubContext, y as diagnostics } from "../context-DRdTViYd.mjs";
-import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-CK2TX0FM.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-0RunDMBy.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-BO0n24su.mjs";
 import { joinURL, withoutLeadingSlash } from "devframe/utils/url";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE } from "devframe/constants";
 import { readFile } from "node:fs/promises";
@@ -107,7 +107,7 @@ function initHub(options) {
 		*/
 		absoluteWsPath: true,
 		resolveSidecarPort: async (sidecarHost) => {
-			const { getPort } = await import("../dist-Q6-t0oIv.mjs");
+			const { getPort } = await import("../dist-BP3CGpgZ.mjs");
 			return getPort({
 				port: 9777,
 				portRange: [9777, 9877],
@@ -150,6 +150,9 @@ function initHub(options) {
 				serverName: options.name ?? "devframes-hub",
 				serverVersion: options.version ?? "0.0.0",
 				exposeSharedState: mcpConfig.exposeSharedState ?? true,
+				instructions: mcpConfig.instructions,
+				resourceTemplates: mcpConfig.resourceTemplates,
+				onResourcesChanged: mcpConfig.onResourcesChanged,
 				authorization: mcpConfig.authorization,
 				allowedOrigins: mcpConfig.allowedOrigins
 			});

package/dist/{settings-DPLPzYfX.d.mts → settings-UN5GnTei.d.mts}

@@ -159,6 +159,12 @@ interface DevframeDockEntryBase {
   title: string;
   /** Translations of `title` by BCP 47 tag; see `resolveTitle()` from `@devframes/hub`. */
   titleLocales?: DevframeTitleLocales;
+  /**
+   * A longer, one-line hint of what the entry does. A viewer shows it under
+   * the {@link title} in the dock button tooltip, so a button whose icon is
+   * ambiguous still explains itself on hover.
+   */
+  description?: string;
   icon: DevframeDockEntryIcon;
   /**
    * The default order of the entry in the dock.
@@ -459,6 +465,27 @@ interface DevframeViewLauncher extends DevframeDockEntryBase {
 interface DevframeViewAction extends DevframeDockEntryBase {
   type: 'action';
   action: ClientScriptEntry;
+  /**
+   * Make the action an on/off tool, such as an in-page element picker.
+   *
+   * - The {@link action} script runs once (cached like other client scripts)
+   *   and drives the tool from the entry's `entry:activated` /
+   *   `entry:deactivated` events.
+   * - Activating it does not select it: the panel's selected dock stays as is.
+   *   An open panel is hidden while the tool is on and comes back when it goes
+   *   off.
+   * - While on, the dock button renders as active (`DockEntryState.isActive`).
+   * - `docks.switchEntry(id)` (a click) flips it on and off.
+   * - It also goes off on `Escape` in a viewer that supports it, on
+   *   `docks.setActionActive(id, false)`, or when another dock is selected or
+   *   the selection is cleared (then the panel is not restored, the new
+   *   selection wins).
+   *
+   * When unset, the action is one-shot: each click runs the script again.
+   *
+   * @default false
+   */
+  toggle?: boolean;
 }
 interface DevframeViewCustomRender extends DevframeDockEntryBase {
   type: 'custom-render';

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, L as DevframeTitleLocales, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, R as DevframeTitled, 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-DPLPzYfX.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-BK50aJ-F.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-BvEO3eOd.mjs";
+import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, L as DevframeTitleLocales, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, R as DevframeTitled, 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-UN5GnTei.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-Iy5i89Aq.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-tijpvneP.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, DevframeTitleLocales, DevframeTitled, 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": "1.2.5",
+  "version": "1.3.0",
   "description": "Hub layer that orchestrates devframe docks, terminals, messages, and commands on any host.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -35,8 +35,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/agentic": "1.2.5",
-    "devframe": "1.2.5"
+    "@devframes/agentic": "1.3.0",
+    "devframe": "1.3.0"
   },
   "peerDependenciesMeta": {
     "@devframes/agentic": {
@@ -45,18 +45,18 @@
   },
   "dependencies": {
     "destr": "^2.0.5",
-    "h3": "^2.0.1",
+    "h3": "^2.0.7",
     "pathe": "^2.0.3",
     "tinyexec": "^1.3.1",
     "zigpty": "^0.2.1"
   },
   "devDependencies": {
-    "@devframes/agentic": "1.2.5",
+    "@devframes/agentic": "1.3.0",
     "@standard-schema/spec": "^1.1.0",
-    "@types/node": "^26.6.4",
-    "devframe": "1.2.5",
+    "@types/node": "^26.6.5",
+    "devframe": "1.3.0",
     "get-port-please": "^3.2.0",
-    "tsdown": "^0.23.0",
+    "tsdown": "0.23.0",
     "valibot": "^1.5.0"
   },
   "scripts": {

package/dist/{dist-Q6-t0oIv.mjs → dist-BP3CGpgZ.mjs}

@@ -1,7 +1,7 @@
 import "node:fs/promises";
+import "node:path";
 import { createServer } from "node:net";
 import { networkInterfaces } from "node:os";
-import "node:path";
 //#region ../../node_modules/.pnpm/get-port-please@3.2.0/node_modules/get-port-please/dist/index.mjs
 const unsafePorts = /* @__PURE__ */ new Set([
 	1,