@devframes/hub 0.7.16 → 0.8.1

package/dist/client/index.d.mts

@@ -1,8 +1,8 @@
-import { D as DevframeViewIframe, M as NavTarget, N as RemoteConnectionInfo, b as DevframeDockUserEntry, h as DevframeDockEntry, i as DevframeCommandEntry, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, t as DevframeDocksUserSettings, v as DevframeDockEntryIcon } from "../settings-BV2OlKYo.mjs";
+import { N as NavTarget, O as DevframeViewIframe, P as RemoteConnectionInfo, a as DevframeCommandEntry, g as DevframeDockEntry, h as DevframeDockEntriesGrouped, n as DevframeClientCommand, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings, x as DevframeDockUserEntry, y as DevframeDockEntryIcon } from "../settings-Byh48aCd.mjs";
 import { DEFAULT_CATEGORIES_ORDER } from "../constants.mjs";
-import { w as DevframeMessagesClient, y as DevframeMessageEntryInput } from "../context-Bg8Y0rGG.mjs";
-import "../index-ra1YGFux.mjs";
-import { DevframeClientRpcHost, DevframeConnectionStatus, DevframeRpcClient, DevframeRpcClientOptions, DevframeRpcContext, RpcClientEvents, RpcClientEvents as RpcClientEvents$1 } from "devframe/client";
+import { w as DevframeMessagesClient, y as DevframeMessageEntryInput } from "../context-Cw5sDVoA.mjs";
+import "../index-Bx3T-R7i.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";
 import { WhenContext } from "devframe/utils/when";
@@ -256,6 +256,16 @@ declare function getDevframeClientContext(): DevframeClientContext | undefined;
  */
 declare function setDevframeClientContext(ctx: DevframeClientContext | undefined): void;
 //#endregion
+//#region src/client/dock-resources.d.ts
+/**
+ * Resolve a dock iframe URL relative to the Devframe server that provided the
+ * dock entry. This keeps root-relative and dot-relative paths on the host
+ * server when an external viewer renders the hub.
+ */
+declare function resolveDockUrl(url: string, connection: DevframeConnection): string;
+/** Resolve URL-backed dock icons while preserving Iconify names and data URLs. */
+declare function resolveDockIcon(icon: DevframeDockEntryIcon, connection: DevframeConnection): DevframeDockEntryIcon;
+//#endregion
 //#region src/client/frame-nav.d.ts
 /**
  * Shared-iframe soft navigation — the viewer-side half of a host↔iframe
@@ -463,8 +473,18 @@ interface MessagesClientOptions {
  */
 declare function createMessagesClient(rpc: DevframeRpcClient, options?: MessagesClientOptions): DevframeMessagesClient;
 //#endregion
+//#region src/remote-url.d.ts
+/** Remove the remote connection descriptor from a URL before displaying or copying it. */
+declare function stripRemoteConnectionFromUrl(input: string): string;
+//#endregion
 //#region src/client/remote.d.ts
 type ConnectRemoteDevframeOptions = Omit<DevframeRpcClientOptions, 'connectionMeta' | 'authToken'>;
+/**
+ * Build an external viewer URL from an existing trusted Devframe connection.
+ * Returns the original URL if the connection has no auth token, does not use
+ * WebSockets, or has an invalid metadata URL.
+ */
+declare function buildRemoteDevframeUrl(url: string, connection: DevframeConnection): string;
 /**
  * Parse a {@link RemoteConnectionInfo} descriptor from the current page's URL
  * (or a provided URL/string). Checks the URL fragment first, then the query.
@@ -484,4 +504,4 @@ declare function parseRemoteConnection(input?: string): RemoteConnectionInfo | n
  */
 declare function connectRemoteDevframe(options?: ConnectRemoteDevframeOptions): Promise<DevframeRpcClient>;
 //#endregion
-export { CLIENT_CONTEXT_KEY, CommandsContext, ConnectRemoteDevframeOptions, DEFAULT_CATEGORIES_ORDER, DevframeClientContext, DevframeClientHost, DevframeClientHostOptions, type DevframeClientRpcHost, DockClientScriptContext, DockClientType, DockEntryState, DockEntryStateEvents, DockPanelStorage, DockRegistration, DockRenderer, DockRendererInstance, DockRendererMountOptions, DockRenderersContext, DocksConnectionContext, DocksContext, DocksEntriesContext, DocksPanelContext, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, FrameNavClient, FrameNavClientOptions, FrameNavEnvelope, FrameNavFrameMessage, FrameNavHostMessage, FrameNavHostPayload, FrameNavListenTarget, FrameTab, MessagesClientOptions, type RpcClientEvents, WhenClauseContext, attachFrameNavClient, connectRemoteDevframe, createDevframeClientHost, createMessagesClient, getDevframeClientContext, parseRemoteConnection, setDevframeClientContext };
+export { CLIENT_CONTEXT_KEY, CommandsContext, ConnectRemoteDevframeOptions, DEFAULT_CATEGORIES_ORDER, DevframeClientContext, DevframeClientHost, DevframeClientHostOptions, type DevframeClientRpcHost, DockClientScriptContext, DockClientType, DockEntryState, DockEntryStateEvents, DockPanelStorage, DockRegistration, DockRenderer, DockRendererInstance, DockRendererMountOptions, DockRenderersContext, DocksConnectionContext, DocksContext, DocksEntriesContext, DocksPanelContext, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, FrameNavClient, FrameNavClientOptions, FrameNavEnvelope, FrameNavFrameMessage, FrameNavHostMessage, FrameNavHostPayload, FrameNavListenTarget, FrameTab, MessagesClientOptions, type RpcClientEvents, WhenClauseContext, attachFrameNavClient, buildRemoteDevframeUrl, connectRemoteDevframe, createDevframeClientHost, createMessagesClient, getDevframeClientContext, parseRemoteConnection, resolveDockIcon, resolveDockUrl, setDevframeClientContext, stripRemoteConnectionFromUrl };

package/dist/client/index.mjs

@@ -1,6 +1,7 @@
 import { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS } from "../constants.mjs";
+import { n as stripRemoteConnectionFromUrl, t as buildRemoteConnectionUrl } from "../remote-url-KVXtKP47.mjs";
 import { REMOTE_CONNECTION_KEY } from "devframe/constants";
-import { connectDevframe, getDevframeRpcClient } from "devframe/client";
+import { connectDevframe, getDevframeRpcClient, resolveWsUrl } from "devframe/client";
 import { createEventEmitter } from "devframe/utils/events";
 import { destr } from "destr";
 export * from "devframe/client";
@@ -21,6 +22,53 @@ function setDevframeClientContext(ctx) {
 	globalThis[CLIENT_CONTEXT_KEY] = ctx;
 }
 //#endregion
+//#region src/client/dock-resources.ts
+const URL_SCHEME_RE = /^[a-z][a-z\d+.-]*:/i;
+function resolveResourceUrl(value, connection) {
+	const url = value.trim();
+	if (!url || URL_SCHEME_RE.test(url) || url.startsWith("//")) return url;
+	if (!url.startsWith("/") && !url.startsWith("./") && !url.startsWith("../")) return url;
+	try {
+		return new URL(url, connection.metaBaseUrl).href;
+	} catch {
+		return url;
+	}
+}
+function resolveIconUrl(value, connection) {
+	const url = value.trim();
+	if (!url || URL_SCHEME_RE.test(url) || url.startsWith("//")) return url;
+	if (!url.includes("/") && !url.includes(".")) return url;
+	try {
+		return new URL(url, connection.metaBaseUrl).href;
+	} catch {
+		return url;
+	}
+}
+/**
+* Resolve a dock iframe URL relative to the Devframe server that provided the
+* dock entry. This keeps root-relative and dot-relative paths on the host
+* server when an external viewer renders the hub.
+*/
+function resolveDockUrl(url, connection) {
+	const resolved = resolveResourceUrl(url, connection);
+	if (resolved !== url.trim()) return resolved;
+	const value = url.trim();
+	if (!value || URL_SCHEME_RE.test(value) || value.startsWith("//")) return /^localhost:\d/i.test(value) ? `http://${value}` : value;
+	try {
+		return new URL(`http://${value}`).href;
+	} catch {
+		return value;
+	}
+}
+/** Resolve URL-backed dock icons while preserving Iconify names and data URLs. */
+function resolveDockIcon(icon, connection) {
+	if (typeof icon === "string") return resolveIconUrl(icon, connection);
+	return {
+		light: resolveIconUrl(icon.light, connection),
+		dark: resolveIconUrl(icon.dark, connection)
+	};
+}
+//#endregion
 //#region src/client/frame-nav.ts
 /**
 * Shared-iframe soft navigation — the viewer-side half of a host↔iframe
@@ -650,6 +698,27 @@ function base64UrlDecode(value) {
 	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
 	return new TextDecoder().decode(bytes);
 }
+/**
+* Build an external viewer URL from an existing trusted Devframe connection.
+* Returns the original URL if the connection has no auth token, does not use
+* WebSockets, or has an invalid metadata URL.
+*/
+function buildRemoteDevframeUrl(url, connection) {
+	if (!connection.authToken || connection.connectionMeta.backend !== "websocket") return url;
+	let base;
+	try {
+		base = new URL(connection.metaBaseUrl);
+	} catch {
+		return url;
+	}
+	return buildRemoteConnectionUrl(url, {
+		v: 1,
+		backend: "websocket",
+		websocket: resolveWsUrl(connection.connectionMeta.websocket, connection.metaBaseUrl, base),
+		authToken: connection.authToken,
+		origin: base.origin
+	});
+}
 function extractKeyFromFragment(hash) {
 	if (!hash) return null;
 	const raw = hash.startsWith("#") ? hash.slice(1) : hash;
@@ -726,4 +795,4 @@ async function connectRemoteDevframe(options = {}) {
 	});
 }
 //#endregion
-export { CLIENT_CONTEXT_KEY, DEFAULT_CATEGORIES_ORDER, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, attachFrameNavClient, connectRemoteDevframe, createDevframeClientHost, createMessagesClient, getDevframeClientContext, parseRemoteConnection, setDevframeClientContext };
+export { CLIENT_CONTEXT_KEY, DEFAULT_CATEGORIES_ORDER, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, attachFrameNavClient, buildRemoteDevframeUrl, connectRemoteDevframe, createDevframeClientHost, createMessagesClient, getDevframeClientContext, parseRemoteConnection, resolveDockIcon, resolveDockUrl, setDevframeClientContext, stripRemoteConnectionFromUrl };

package/dist/constants.d.mts

@@ -1,4 +1,4 @@
-import { t as DevframeDocksUserSettings } from "./settings-BV2OlKYo.mjs";
+import { t as DevframeDocksUserSettings } from "./settings-Byh48aCd.mjs";
 export * from "devframe/constants";
 //#region src/constants.d.ts
 /**

package/dist/{context-Bg8Y0rGG.d.mts → context-Cw5sDVoA.d.mts}

@@ -1,4 +1,4 @@
-import { I as JsonRenderSpec, L as JsonRenderer, S as DevframeDocksHost, c as DevframeCommandsHost, p as DevframeDockActivation, v as DevframeDockEntryIcon } from "./settings-BV2OlKYo.mjs";
+import { C as DevframeDocksHost, L as JsonRenderSpec, R as JsonRenderer, l as DevframeCommandsHost, m as DevframeDockActivation, y as DevframeDockEntryIcon } from "./settings-Byh48aCd.mjs";
 import { CreateHostContextOptions } from "devframe/node";
 import { DevframeHost, DevframeNodeContext, EventEmitter } from "devframe/types";
 import { ChildProcess } from "node:child_process";

package/dist/{index-ra1YGFux.d.mts → index-Bx3T-R7i.d.mts}

@@ -1,5 +1,5 @@
-import "./settings-BV2OlKYo.mjs";
-import "./context-Bg8Y0rGG.mjs";
+import "./settings-Byh48aCd.mjs";
+import "./context-Cw5sDVoA.mjs";
 import { RpcDefinitionsFilter, RpcDefinitionsToFunctions } from "devframe/rpc";
 import { ConnectionMeta as ConnectionMeta$1, DevframeCapabilities, DevframeDiagnosticsDefinition, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeHost as DevframeHost$1, DevframeNodeRpcSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeViewHost, EntriesToObject, EventEmitter as EventEmitter$1, EventUnsubscribe, EventsMap, PartialWithoutId, RpcBroadcastOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, Thenable } from "devframe/types";
 export { RpcStreamingChannel as C, Thenable as E, RpcSharedStateHost as S, RpcStreamingHost as T, RpcBroadcastOptions as _, DevframeDiagnosticsLogger as a, RpcFunctionsHost as b, DevframeRpcClientFunctions as c, DevframeViewHost as d, EntriesToObject as f, PartialWithoutId as g, EventsMap as h, DevframeDiagnosticsHost as i, DevframeRpcServerFunctions as l, EventUnsubscribe as m, DevframeCapabilities as n, DevframeHost$1 as o, EventEmitter$1 as p, DevframeDiagnosticsDefinition as r, DevframeNodeRpcSession as s, ConnectionMeta$1 as t, DevframeRpcSharedStates as u, RpcDefinitionsFilter as v, RpcStreamingChannelOptions as w, RpcSharedStateGetOptions as x, RpcDefinitionsToFunctions as y };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { A as DevframeViewLauncherStatus, C as DevframeViewAction, D as DevframeViewIframe, E as DevframeViewGroup, F as JsonRenderElement, I as JsonRenderSpec, L as JsonRenderer, M as NavTarget, N as RemoteConnectionInfo, O as DevframeViewJsonRender, P as RemoteDockOptions, S as DevframeDocksHost, T as DevframeViewCustomRender, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as FrameSubTabsConfig, k as DevframeViewLauncher, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockActivation, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewBuiltin, x as DevframeDocksActiveState, y as DevframeDockEntryRegistry } from "./settings-BV2OlKYo.mjs";
+import { A as DevframeViewLauncher, C as DevframeDocksHost, D as DevframeViewGroup, E as DevframeViewCustomRender, F as RemoteDockOptions, I as JsonRenderElement, L as JsonRenderSpec, M as FrameSubTabsConfig, N as NavTarget, O as DevframeViewIframe, P as RemoteConnectionInfo, R as JsonRenderer, S as DevframeDocksActiveState, T as DevframeViewBuiltin, _ as DevframeDockEntryBase, a as DevframeCommandEntry, b as DevframeDockEntryRegistry, c as DevframeCommandShortcutOverrides, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntry, h as DevframeDockEntriesGrouped, i as DevframeCommandBase, j as DevframeViewLauncherStatus, k as DevframeViewJsonRender, 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 DevframeDockEntryCategory, w as DevframeViewAction, x as DevframeDockUserEntry, y as DevframeDockEntryIcon } from "./settings-Byh48aCd.mjs";
 import { DEFAULT_CATEGORIES_ORDER } from "./constants.mjs";
-import { C as DevframeMessageShortcutInput, D as DevframeMessagesListDelta, E as DevframeMessagesLevelShortcuts, S as DevframeMessageLevel, T as DevframeMessagesHost, _ as DevframeMessageEntry, a as DevframeChildProcessOutput, b as DevframeMessageFilePosition, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, f as DevframeTerminalStatus, g as DevframeMessageElementPosition, h as DevframeMessageActivateAction, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, m as DevframeMessageAction, n as DevframeHubContext, o as DevframeChildProcessResult, p as DevframeTerminalsHost, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, v as DevframeMessageEntryFrom, w as DevframeMessagesClient, x as DevframeMessageHandle, y as DevframeMessageEntryInput } from "./context-Bg8Y0rGG.mjs";
-import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "./index-ra1YGFux.mjs";
+import { C as DevframeMessageShortcutInput, D as DevframeMessagesListDelta, E as DevframeMessagesLevelShortcuts, S as DevframeMessageLevel, T as DevframeMessagesHost, _ as DevframeMessageEntry, a as DevframeChildProcessOutput, b as DevframeMessageFilePosition, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, f as DevframeTerminalStatus, g as DevframeMessageElementPosition, h as DevframeMessageActivateAction, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, m as DevframeMessageAction, n as DevframeHubContext, o as DevframeChildProcessResult, p as DevframeTerminalsHost, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, v as DevframeMessageEntryFrom, w as DevframeMessagesClient, x as DevframeMessageHandle, y as DevframeMessageEntryInput } from "./context-Cw5sDVoA.mjs";
+import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "./index-Bx3T-R7i.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>;
@@ -21,4 +21,4 @@ declare function defineDockEntry<const T extends DevframeDockUserEntry, const W
  */
 declare function defineJsonRenderSpec(spec: JsonRenderSpec): JsonRenderSpec;
 //#endregion
-export { type ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, DEFAULT_CATEGORIES_ORDER, type DevframeCapabilities, type DevframeChildProcessExecuteOptions, type DevframeChildProcessOutput, type DevframeChildProcessResult, type DevframeChildProcessTerminalSession, type DevframeClientCommand, type DevframeCommandBase, type DevframeCommandEntry, type DevframeCommandHandle, type DevframeCommandKeybinding, type DevframeCommandShortcutOverrides, type DevframeCommandsHost, type DevframeCommandsHostEvents, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockActivation, type DevframeDockEntriesGrouped, type DevframeDockEntry, type DevframeDockEntryBase, type DevframeDockEntryCategory, type DevframeDockEntryIcon, type DevframeDockEntryRegistry, type DevframeDockUserEntry, type DevframeDocksActiveState, type DevframeDocksHost, type DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, type DevframeMessageAction, type DevframeMessageActivateAction, type DevframeMessageElementPosition, type DevframeMessageEntry, type DevframeMessageEntryFrom, type DevframeMessageEntryInput, type DevframeMessageFilePosition, type DevframeMessageHandle, type DevframeMessageLevel, type DevframeMessageShortcutInput, type DevframeMessagesClient, type DevframeMessagesHost, type DevframeMessagesLevelShortcuts, type DevframeMessagesListDelta, type DevframeNodeRpcSession, type DevframePtyExecuteOptions, type DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeServerCommandEntry, type DevframeServerCommandInput, type DevframeTerminalSession, type DevframeTerminalSessionBase, type DevframeTerminalStatus, type DevframeTerminalsHost, type DevframeViewAction, type DevframeViewBuiltin, type DevframeViewCustomRender, type DevframeViewGroup, type DevframeViewHost, type DevframeViewIframe, type DevframeViewJsonRender, type DevframeViewLauncher, type DevframeViewLauncherStatus, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, type FrameSubTabsConfig, type JsonRenderElement, type JsonRenderSpec, type JsonRenderer, type NavTarget, type PartialWithoutId, type RemoteConnectionInfo, type RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type Thenable, defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };
+export { type ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, DEFAULT_CATEGORIES_ORDER, type DevframeCapabilities, type DevframeChildProcessExecuteOptions, type DevframeChildProcessOutput, type DevframeChildProcessResult, type DevframeChildProcessTerminalSession, type DevframeClientCommand, type DevframeCommandAgentOptions, type DevframeCommandBase, type DevframeCommandEntry, type DevframeCommandHandle, type DevframeCommandKeybinding, type DevframeCommandShortcutOverrides, type DevframeCommandsHost, type DevframeCommandsHostEvents, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockActivation, type DevframeDockEntriesGrouped, type DevframeDockEntry, type DevframeDockEntryBase, type DevframeDockEntryCategory, type DevframeDockEntryIcon, type DevframeDockEntryRegistry, type DevframeDockUserEntry, type DevframeDocksActiveState, type DevframeDocksHost, type DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, type DevframeMessageAction, type DevframeMessageActivateAction, type DevframeMessageElementPosition, type DevframeMessageEntry, type DevframeMessageEntryFrom, type DevframeMessageEntryInput, type DevframeMessageFilePosition, type DevframeMessageHandle, type DevframeMessageLevel, type DevframeMessageShortcutInput, type DevframeMessagesClient, type DevframeMessagesHost, type DevframeMessagesLevelShortcuts, type DevframeMessagesListDelta, type DevframeNodeRpcSession, type DevframePtyExecuteOptions, type DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeServerCommandEntry, type DevframeServerCommandInput, type DevframeTerminalSession, type DevframeTerminalSessionBase, type DevframeTerminalStatus, type DevframeTerminalsHost, type DevframeViewAction, type DevframeViewBuiltin, type DevframeViewCustomRender, type DevframeViewGroup, type DevframeViewHost, type DevframeViewIframe, type DevframeViewJsonRender, type DevframeViewLauncher, type DevframeViewLauncherStatus, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, type FrameSubTabsConfig, type JsonRenderElement, type JsonRenderSpec, type JsonRenderer, type NavTarget, type PartialWithoutId, type RemoteConnectionInfo, type RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type Thenable, defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };

package/dist/node/index.d.mts

@@ -1,6 +1,6 @@
-import { D as DevframeViewIframe, S as DevframeDocksHost$1, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost$1, d as DevframeServerCommandInput, f as ClientScriptEntry, h as DevframeDockEntry, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry } from "../settings-BV2OlKYo.mjs";
+import { C as DevframeDocksHost$1, O as DevframeViewIframe, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntry, l as DevframeCommandsHost$1, o as DevframeCommandHandle, p as ClientScriptEntry, t as DevframeDocksUserSettings, x as DevframeDockUserEntry } from "../settings-Byh48aCd.mjs";
 import { DEFAULT_CATEGORIES_ORDER } from "../constants.mjs";
-import { C as DevframeMessageShortcutInput, D as DevframeMessagesListDelta, T as DevframeMessagesHost$1, _ as DevframeMessageEntry, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, n as DevframeHubContext, p as DevframeTerminalsHost$1, r as createHubContext, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, x as DevframeMessageHandle, y as DevframeMessageEntryInput } from "../context-Bg8Y0rGG.mjs";
+import { C as DevframeMessageShortcutInput, D as DevframeMessagesListDelta, T as DevframeMessagesHost$1, _ as DevframeMessageEntry, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, n as DevframeHubContext, p as DevframeTerminalsHost$1, r as createHubContext, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, x as DevframeMessageHandle, y as DevframeMessageEntryInput } from "../context-Cw5sDVoA.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { DevframeDefinition } from "devframe/types";
 import { SharedState } from "devframe/utils/shared-state";
@@ -9,6 +9,12 @@ declare class DevframeCommandsHost implements DevframeCommandsHost$1 {
   readonly context: DevframeHubContext;
   readonly commands: DevframeCommandsHost$1['commands'];
   readonly events: DevframeCommandsHost$1['events'];
+  /**
+   * Lazy agent projection: `ctx.agent` queries this provider at list/invoke
+   * time, deriving tools from {@link commands} on demand — the commands map
+   * stays the single source of truth, nothing is mirrored or kept in sync.
+   */
+  private readonly agentProvider;
   constructor(context: DevframeHubContext);
   register(command: DevframeServerCommandInput): DevframeCommandHandle;
   unregister(id: string): boolean;
@@ -16,6 +22,17 @@ declare class DevframeCommandsHost implements DevframeCommandsHost$1 {
   list(): DevframeServerCommandEntry[];
   private findCommand;
   private toSerializable;
+  /** Reject `agent` on handler-less commands anywhere in the tree, up front. */
+  private validateAgentExposure;
+  /**
+   * Derive the agent-tool projection of the current command trees: every
+   * agent-flagged, handler-bearing command (children included) becomes a
+   * callable tool. Queried lazily by the provider registered in the
+   * constructor. `when` clauses evaluate client-side only and are not
+   * enforced here — opting in a `when`-gated command is a deliberate author
+   * decision (documented on `DevframeCommandAgentOptions`).
+   */
+  private collectAgentTools;
 }
 //#endregion
 //#region src/node/host-docks.d.ts

package/dist/node/index.mjs

@@ -1,8 +1,8 @@
 import { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS } from "../constants.mjs";
 import { r as defineHubRpcFunction } from "../define-Pbx8dsKz.mjs";
-import { REMOTE_CONNECTION_KEY } from "devframe/constants";
+import { t as buildRemoteConnectionUrl } from "../remote-url-KVXtKP47.mjs";
 import { createEventEmitter } from "devframe/utils/events";
-import { createHostContext, createStorage } from "devframe/node";
+import { coerceAgentPositionalArgs, createHostContext, createStorage } from "devframe/node";
 import { debounce } from "perfect-debounce";
 import { defineDiagnostics } from "nostics";
 import { colors } from "devframe/utils/colors";
@@ -82,6 +82,10 @@ const diagnostics = defineDiagnostics({
 		DF8403: {
 			why: (p) => `Command id "${p.id}" is already used by another command or child command`,
 			fix: "Use globally unique command ids for top-level commands and all child commands."
+		},
+		DF8404: {
+			why: (p) => `Command "${p.id}" declares agent exposure but has no handler`,
+			fix: "Agent-exposed commands must be executable server-side. Add a `handler` to the command, or move the `agent` field to an executable child command."
 		}
 	}
 });
@@ -116,14 +120,23 @@ var DevframeCommandsHost = class {
 	context;
 	commands = /* @__PURE__ */ new Map();
 	events = createEventEmitter();
+	/**
+	* Lazy agent projection: `ctx.agent` queries this provider at list/invoke
+	* time, deriving tools from {@link commands} on demand — the commands map
+	* stays the single source of truth, nothing is mirrored or kept in sync.
+	*/
+	agentProvider;
 	constructor(context) {
 		this.context = context;
+		this.agentProvider = context.agent?.registerToolProvider(() => this.collectAgentTools());
 	}
 	register(command) {
 		if (this.commands.has(command.id)) throw diagnostics.DF8400({ id: command.id });
 		validateCommandIds(this.commands, command);
+		this.validateAgentExposure(command);
 		this.commands.set(command.id, command);
 		this.events.emit("command:registered", this.toSerializable(command));
+		this.agentProvider?.notifyChanged();
 		return {
 			id: command.id,
 			update: (patch) => {
@@ -136,15 +149,20 @@ var DevframeCommandsHost = class {
 					id: existing.id
 				};
 				validateCommandIds(this.commands, next, existing.id);
+				this.validateAgentExposure(next);
 				Object.assign(existing, patch);
 				this.events.emit("command:registered", this.toSerializable(existing));
+				this.agentProvider?.notifyChanged();
 			},
 			unregister: () => this.unregister(command.id)
 		};
 	}
 	unregister(id) {
 		const deleted = this.commands.delete(id);
-		if (deleted) this.events.emit("command:unregistered", id);
+		if (deleted) {
+			this.events.emit("command:unregistered", id);
+			this.agentProvider?.notifyChanged();
+		}
 		return deleted;
 	}
 	async execute(id, ...args) {
@@ -165,13 +183,44 @@ var DevframeCommandsHost = class {
 		}
 	}
 	toSerializable(cmd) {
-		const { handler: _, children, ...rest } = cmd;
+		const { handler: _, agent: __, children, ...rest } = cmd;
 		return {
 			...rest,
 			source: "server",
 			...children ? { children: children.map((c) => this.toSerializable(c)) } : {}
 		};
 	}
+	/** Reject `agent` on handler-less commands anywhere in the tree, up front. */
+	validateAgentExposure(command) {
+		if (command.agent && !command.handler) throw diagnostics.DF8404({ id: command.id });
+		for (const child of command.children ?? []) this.validateAgentExposure(child);
+	}
+	/**
+	* Derive the agent-tool projection of the current command trees: every
+	* agent-flagged, handler-bearing command (children included) becomes a
+	* callable tool. Queried lazily by the provider registered in the
+	* constructor. `when` clauses evaluate client-side only and are not
+	* enforced here — opting in a `when`-gated command is a deliberate author
+	* decision (documented on `DevframeCommandAgentOptions`).
+	*/
+	collectAgentTools() {
+		const tools = [];
+		const walk = (command) => {
+			const agent = command.agent;
+			if (agent && command.handler) tools.push({
+				id: command.id,
+				title: agent.title ?? command.title,
+				description: agent.description,
+				safety: agent.safety ?? "action",
+				tags: agent.tags,
+				args: agent.args,
+				handler: async (args) => this.execute(command.id, ...coerceAgentPositionalArgs(args, agent.args, "drop"))
+			});
+			for (const child of command.children ?? []) walk(child);
+		};
+		for (const command of this.commands.values()) walk(command);
+		return tools;
+	}
 };
 //#endregion
 //#region src/node/host-docks.ts
@@ -182,45 +231,6 @@ function normaliseRemoteOptions(remote) {
 		originLock: opts.originLock ?? true
 	};
 }
-function base64UrlEncode(value) {
-	const bytes = new TextEncoder().encode(value);
-	let binary = "";
-	for (const byte of bytes) binary += String.fromCharCode(byte);
-	return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-}
-function buildRemoteUrl(baseUrl, payload, transport) {
-	const encoded = base64UrlEncode(JSON.stringify(payload));
-	const param = `${REMOTE_CONNECTION_KEY}=${encoded}`;
-	if (transport === "fragment") {
-		const hashIdx = baseUrl.indexOf("#");
-		if (hashIdx === -1) return `${baseUrl}#${param}`;
-		const before = baseUrl.slice(0, hashIdx);
-		const rawHash = baseUrl.slice(hashIdx + 1);
-		if (!rawHash) return `${before}#${param}`;
-		const routeQueryIdx = rawHash.indexOf("?");
-		if (routeQueryIdx !== -1) {
-			const beforeQuery = rawHash.slice(0, routeQueryIdx + 1);
-			const params = new URLSearchParams(rawHash.slice(routeQueryIdx + 1));
-			params.set(REMOTE_CONNECTION_KEY, encoded);
-			return `${before}#${beforeQuery}${params.toString()}`;
-		}
-		const parts = rawHash.split("&");
-		const existingIdx = parts.findIndex((part) => {
-			const [key] = part.split("=");
-			return key === REMOTE_CONNECTION_KEY;
-		});
-		if (existingIdx >= 0) {
-			parts[existingIdx] = param;
-			return `${before}#${parts.join("&")}`;
-		}
-		return `${before}#${rawHash}&${param}`;
-	}
-	const qIdx = baseUrl.indexOf("?");
-	const hashIdx = baseUrl.indexOf("#");
-	const hash = hashIdx === -1 ? "" : baseUrl.slice(hashIdx);
-	const beforeHash = hashIdx === -1 ? baseUrl : baseUrl.slice(0, hashIdx);
-	return `${beforeHash}${qIdx === -1 || qIdx >= (hashIdx === -1 ? beforeHash.length : hashIdx) ? "?" : "&"}${param}${hash}`;
-}
 var DevframeDocksHost = class {
 	context;
 	views = /* @__PURE__ */ new Map();
@@ -254,7 +264,7 @@ var DevframeDocksHost = class {
 		};
 		return {
 			...view,
-			url: buildRemoteUrl(view.url, payload, record.options.transport)
+			url: buildRemoteConnectionUrl(view.url, payload, record.options.transport)
 		};
 	}
 	resolveDevServerOrigin() {

package/dist/remote-url-KVXtKP47.mjs

@@ -0,0 +1,73 @@
+import { REMOTE_CONNECTION_KEY } from "devframe/constants";
+//#region src/remote-url.ts
+function base64UrlEncode(value) {
+	const bytes = new TextEncoder().encode(value);
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function setRemoteConnectionParam(value, param) {
+	const parts = value ? value.split("&") : [];
+	const existingIdx = parts.findIndex((part) => part.split("=")[0] === REMOTE_CONNECTION_KEY);
+	if (existingIdx >= 0) parts[existingIdx] = param;
+	else parts.push(param);
+	return parts.join("&");
+}
+/** Encode a remote connection descriptor into an external viewer URL. */
+function buildRemoteConnectionUrl(baseUrl, payload, transport = "fragment") {
+	const param = `${REMOTE_CONNECTION_KEY}=${base64UrlEncode(JSON.stringify(payload))}`;
+	if (transport === "fragment") {
+		const hashIdx = baseUrl.indexOf("#");
+		if (hashIdx === -1) return `${baseUrl}#${param}`;
+		const beforeHash = baseUrl.slice(0, hashIdx);
+		const rawHash = baseUrl.slice(hashIdx + 1);
+		if (!rawHash) return `${beforeHash}#${param}`;
+		const routeQueryIdx = rawHash.indexOf("?");
+		if (routeQueryIdx !== -1) return `${beforeHash}#${rawHash.slice(0, routeQueryIdx + 1)}${setRemoteConnectionParam(rawHash.slice(routeQueryIdx + 1), param)}`;
+		return `${beforeHash}#${setRemoteConnectionParam(rawHash, param)}`;
+	}
+	const hashIdx = baseUrl.indexOf("#");
+	const hash = hashIdx === -1 ? "" : baseUrl.slice(hashIdx);
+	const beforeHash = hashIdx === -1 ? baseUrl : baseUrl.slice(0, hashIdx);
+	return `${beforeHash}${beforeHash.includes("?") ? "&" : "?"}${param}${hash}`;
+}
+/** Remove the remote connection descriptor from a URL before displaying or copying it. */
+function stripRemoteConnectionFromUrl(input) {
+	function stripParamList(value) {
+		const parts = value.split("&");
+		const filtered = parts.filter((part) => part.split("=")[0] !== REMOTE_CONNECTION_KEY);
+		return [filtered.join("&"), filtered.length !== parts.length];
+	}
+	const hashIdx = input.indexOf("#");
+	let beforeHash = hashIdx === -1 ? input : input.slice(0, hashIdx);
+	let hash = hashIdx === -1 ? void 0 : input.slice(hashIdx + 1);
+	let changed = false;
+	if (hash !== void 0) {
+		const routeQueryIdx = hash.indexOf("?");
+		if (routeQueryIdx === -1) {
+			const [nextHash, didChange] = stripParamList(hash);
+			hash = nextHash;
+			changed ||= didChange;
+		} else {
+			const route = hash.slice(0, routeQueryIdx);
+			const [query, didChange] = stripParamList(hash.slice(routeQueryIdx + 1));
+			if (didChange) {
+				hash = query ? `${route}?${query}` : route;
+				changed = true;
+			}
+		}
+	}
+	const queryIdx = beforeHash.indexOf("?");
+	if (queryIdx !== -1) {
+		const path = beforeHash.slice(0, queryIdx);
+		const [query, didChange] = stripParamList(beforeHash.slice(queryIdx + 1));
+		if (didChange) {
+			beforeHash = query ? `${path}?${query}` : path;
+			changed = true;
+		}
+	}
+	if (!changed) return input;
+	return hash ? `${beforeHash}#${hash}` : beforeHash;
+}
+//#endregion
+export { stripRemoteConnectionFromUrl as n, buildRemoteConnectionUrl as t };

package/dist/{settings-BV2OlKYo.d.mts → settings-Byh48aCd.d.mts}

@@ -1,3 +1,4 @@
+import { StandardSchemaV1 } from "@standard-schema/spec";
 import { ConnectionMeta, EventEmitter } from "devframe/types";
 //#region src/types/json-render.d.ts
 /** @deprecated Use `DevframeJsonRenderSpec`'s element shape from `@devframes/json-render` instead. Removed in 0.8. */
@@ -496,6 +497,43 @@ interface DevframeCommandBase {
    */
   keybindings?: DevframeCommandKeybinding[];
 }
+/**
+ * Opt-in agent exposure for a server command — mirrors the `agent` field on
+ * `defineRpcFunction`. A command carrying this field (and a `handler`) is
+ * projected into `ctx.agent` as a callable tool, reaching MCP clients through
+ * the devframe MCP adapter.
+ *
+ * `when` clauses are evaluated client-side only and are **not** enforced for
+ * agent calls — opt in a `when`-gated command only if running it outside its
+ * UI context is safe.
+ *
+ * @experimental The agent-native surface is experimental and may change
+ * without a major version bump until it stabilizes.
+ */
+interface DevframeCommandAgentOptions {
+  /**
+   * Description shown to the agent. Write it as a prompt: state when to call
+   * the command, not just what it does.
+   */
+  description: string;
+  /** Display title (falls back to the command's `title`). */
+  title?: string;
+  /**
+   * Safety classification — drives MCP hint annotations.
+   * @default 'action'
+   */
+  safety?: 'read' | 'action' | 'destructive';
+  /** Free-form tags for grouping/filtering. */
+  tags?: readonly string[];
+  /**
+   * Positional [Standard Schema](https://standardschema.dev/) validators for
+   * the handler's arguments — the same shape RPC definitions carry (valibot,
+   * zod, arktype, devframe's built-in `s` builder, …). Each is advertised
+   * under `arg0` / `arg1` / … on the tool's JSON-Schema input. Omitted: the
+   * tool takes no arguments.
+   */
+  args?: readonly StandardSchemaV1[];
+}
 /**
  * Server command input — what plugins pass to `ctx.commands.register()`.
  */
@@ -504,6 +542,13 @@ interface DevframeServerCommandInput extends DevframeCommandBase {
    * Handler for this command. Optional if the command only serves as a group for children.
    */
   handler?: (...args: any[]) => any | Promise<any>;
+  /**
+   * Opt this command in to the agent surface (`ctx.agent` → MCP). Requires a
+   * `handler`. See {@link DevframeCommandAgentOptions}.
+   *
+   * @experimental
+   */
+  agent?: DevframeCommandAgentOptions;
   /**
    * Static sub-commands. Two levels max (parent → children).
    * Each child must have a globally unique `id`.
@@ -584,4 +629,4 @@ interface DevframeDocksUserSettings {
   commandShortcuts: DevframeCommandShortcutOverrides;
 }
 //#endregion
-export { DevframeViewLauncherStatus as A, DevframeViewAction as C, DevframeViewIframe as D, DevframeViewGroup as E, JsonRenderElement as F, JsonRenderSpec as I, JsonRenderer as L, NavTarget as M, RemoteConnectionInfo as N, DevframeViewJsonRender as O, RemoteDockOptions as P, DevframeDocksHost as S, DevframeViewCustomRender as T, DevframeDockEntryCategory as _, DevframeCommandHandle as a, DevframeDockUserEntry as b, DevframeCommandsHost as c, DevframeServerCommandInput as d, ClientScriptEntry as f, DevframeDockEntryBase as g, DevframeDockEntry as h, DevframeCommandEntry as i, FrameSubTabsConfig as j, DevframeViewLauncher as k, DevframeCommandsHostEvents as l, DevframeDockEntriesGrouped as m, DevframeClientCommand as n, DevframeCommandKeybinding as o, DevframeDockActivation as p, DevframeCommandBase as r, DevframeCommandShortcutOverrides as s, DevframeDocksUserSettings as t, DevframeServerCommandEntry as u, DevframeDockEntryIcon as v, DevframeViewBuiltin as w, DevframeDocksActiveState as x, DevframeDockEntryRegistry as y };
+export { DevframeViewLauncher as A, DevframeDocksHost as C, DevframeViewGroup as D, DevframeViewCustomRender as E, RemoteDockOptions as F, JsonRenderElement as I, JsonRenderSpec as L, FrameSubTabsConfig as M, NavTarget as N, DevframeViewIframe as O, RemoteConnectionInfo as P, JsonRenderer as R, DevframeDocksActiveState as S, DevframeViewBuiltin as T, DevframeDockEntryBase as _, DevframeCommandEntry as a, DevframeDockEntryRegistry as b, DevframeCommandShortcutOverrides as c, DevframeServerCommandEntry as d, DevframeServerCommandInput as f, DevframeDockEntry as g, DevframeDockEntriesGrouped as h, DevframeCommandBase as i, DevframeViewLauncherStatus as j, DevframeViewJsonRender as k, DevframeCommandsHost as l, DevframeDockActivation as m, DevframeClientCommand as n, DevframeCommandHandle as o, ClientScriptEntry as p, DevframeCommandAgentOptions as r, DevframeCommandKeybinding as s, DevframeDocksUserSettings as t, DevframeCommandsHostEvents as u, DevframeDockEntryCategory as v, DevframeViewAction as w, DevframeDockUserEntry as x, DevframeDockEntryIcon as y };

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { A as DevframeViewLauncherStatus, C as DevframeViewAction, D as DevframeViewIframe, E as DevframeViewGroup, F as JsonRenderElement, I as JsonRenderSpec, L as JsonRenderer, M as NavTarget, N as RemoteConnectionInfo, O as DevframeViewJsonRender, P as RemoteDockOptions, S as DevframeDocksHost, T as DevframeViewCustomRender, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as FrameSubTabsConfig, k as DevframeViewLauncher, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockActivation, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewBuiltin, x as DevframeDocksActiveState, y as DevframeDockEntryRegistry } from "../settings-BV2OlKYo.mjs";
-import { C as DevframeMessageShortcutInput, D as DevframeMessagesListDelta, E as DevframeMessagesLevelShortcuts, S as DevframeMessageLevel, T as DevframeMessagesHost, _ as DevframeMessageEntry, a as DevframeChildProcessOutput, b as DevframeMessageFilePosition, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, f as DevframeTerminalStatus, g as DevframeMessageElementPosition, h as DevframeMessageActivateAction, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, m as DevframeMessageAction, n as DevframeHubContext, o as DevframeChildProcessResult, p as DevframeTerminalsHost, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, v as DevframeMessageEntryFrom, w as DevframeMessagesClient, x as DevframeMessageHandle, y as DevframeMessageEntryInput } from "../context-Bg8Y0rGG.mjs";
-import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "../index-ra1YGFux.mjs";
-export { ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessOutput, DevframeChildProcessResult, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, DevframeDockActivation, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockEntryRegistry, DevframeDockUserEntry, DevframeDocksActiveState, DevframeDocksHost, DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, DevframeMessageAction, DevframeMessageActivateAction, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessageShortcutInput, DevframeMessagesClient, DevframeMessagesHost, DevframeMessagesLevelShortcuts, DevframeMessagesListDelta, type DevframeNodeRpcSession, DevframePtyExecuteOptions, DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, type DevframeViewHost, DevframeViewIframe, DevframeViewJsonRender, DevframeViewLauncher, DevframeViewLauncherStatus, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, FrameSubTabsConfig, JsonRenderElement, JsonRenderSpec, JsonRenderer, NavTarget, type PartialWithoutId, RemoteConnectionInfo, RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type Thenable };
+import { A as DevframeViewLauncher, C as DevframeDocksHost, D as DevframeViewGroup, E as DevframeViewCustomRender, F as RemoteDockOptions, I as JsonRenderElement, L as JsonRenderSpec, M as FrameSubTabsConfig, N as NavTarget, O as DevframeViewIframe, P as RemoteConnectionInfo, R as JsonRenderer, S as DevframeDocksActiveState, T as DevframeViewBuiltin, _ as DevframeDockEntryBase, a as DevframeCommandEntry, b as DevframeDockEntryRegistry, c as DevframeCommandShortcutOverrides, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntry, h as DevframeDockEntriesGrouped, i as DevframeCommandBase, j as DevframeViewLauncherStatus, k as DevframeViewJsonRender, 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 DevframeDockEntryCategory, w as DevframeViewAction, x as DevframeDockUserEntry, y as DevframeDockEntryIcon } from "../settings-Byh48aCd.mjs";
+import { C as DevframeMessageShortcutInput, D as DevframeMessagesListDelta, E as DevframeMessagesLevelShortcuts, S as DevframeMessageLevel, T as DevframeMessagesHost, _ as DevframeMessageEntry, a as DevframeChildProcessOutput, b as DevframeMessageFilePosition, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, f as DevframeTerminalStatus, g as DevframeMessageElementPosition, h as DevframeMessageActivateAction, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, m as DevframeMessageAction, n as DevframeHubContext, o as DevframeChildProcessResult, p as DevframeTerminalsHost, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, v as DevframeMessageEntryFrom, w as DevframeMessagesClient, x as DevframeMessageHandle, y as DevframeMessageEntryInput } from "../context-Cw5sDVoA.mjs";
+import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "../index-Bx3T-R7i.mjs";
+export { ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessOutput, DevframeChildProcessResult, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandAgentOptions, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, DevframeDockActivation, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockEntryRegistry, DevframeDockUserEntry, DevframeDocksActiveState, DevframeDocksHost, DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, DevframeMessageAction, DevframeMessageActivateAction, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessageShortcutInput, DevframeMessagesClient, DevframeMessagesHost, DevframeMessagesLevelShortcuts, DevframeMessagesListDelta, type DevframeNodeRpcSession, DevframePtyExecuteOptions, DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, type DevframeViewHost, DevframeViewIframe, DevframeViewJsonRender, DevframeViewLauncher, DevframeViewLauncherStatus, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, FrameSubTabsConfig, JsonRenderElement, JsonRenderSpec, JsonRenderer, NavTarget, type PartialWithoutId, RemoteConnectionInfo, RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type Thenable };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.7.16",
+  "version": "0.8.1",
   "description": "Framework-neutral hub layer for devframe — docks, terminals, messages, commands.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -33,10 +33,10 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.7.16"
+    "devframe": "0.8.1"
   },
   "dependencies": {
-    "birpc": "^4.0.0",
+    "@standard-schema/spec": "^1.1.0",
     "destr": "^2.0.5",
     "nostics": "^1.2.0",
     "pathe": "^2.0.3",
@@ -48,7 +48,8 @@
     "@types/node": "^26.1.2",
     "mlly": "^1.8.2",
     "tsdown": "^0.22.14",
-    "devframe": "0.7.16"
+    "valibot": "^1.4.2",
+    "devframe": "0.8.1"
   },
   "scripts": {
     "build": "tsdown",