@devframes/hub 0.8.0 → 0.8.2

package/dist/client/index.d.mts

@@ -1,8 +1,8 @@
 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-Cw5sDVoA.mjs";
-import "../index-Bx3T-R7i.mjs";
-import { DevframeClientRpcHost, DevframeConnectionStatus, DevframeRpcClient, DevframeRpcClientOptions, DevframeRpcContext, RpcClientEvents, RpcClientEvents as RpcClientEvents$1 } from "devframe/client";
+import { w as DevframeMessagesClient, y as DevframeMessageEntryInput } from "../context-BSgzLnsu.mjs";
+import "../index-IzywMKfP.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/{context-Cw5sDVoA.d.mts → context-BSgzLnsu.d.mts}

@@ -319,6 +319,7 @@ interface DevframeChildProcessTerminalSession extends DevframeTerminalSession {
    */
   getResult: () => DevframeChildProcessResult;
   terminate: () => Promise<void>;
+  /** Throws `DF8206` once the session's output stream has closed (after a natural exit or `terminate()`) — drop it with `ctx.terminals.remove(session)` and start a fresh session instead. */
   restart: () => Promise<void>;
 }
 interface DevframePtyExecuteOptions {
@@ -342,6 +343,7 @@ interface DevframePtyTerminalSession extends DevframeTerminalSession {
   /** Current foreground process name, when the backend can resolve it. */
   getProcessName: () => string | undefined;
   terminate: () => Promise<void>;
+  /** Throws `DF8206` once the session's output stream has closed (after a natural exit or `terminate()`) — drop it with `ctx.terminals.remove(session)` and start a fresh session instead. */
   restart: () => Promise<void>;
 }
 //#endregion

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

@@ -1,5 +1,5 @@
 import "./settings-Byh48aCd.mjs";
-import "./context-Cw5sDVoA.mjs";
+import "./context-BSgzLnsu.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 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-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 { 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-BSgzLnsu.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-IzywMKfP.mjs";
 import { WhenContext, WhenExpression } from "devframe/utils/when";
 //#region src/define.d.ts
 declare const defineHubRpcFunction: <NAME extends string, TYPE extends import("devframe/rpc").RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends import("devframe/rpc").RpcArgsSchema | undefined = undefined, const RS extends import("devframe/rpc").RpcReturnSchema | undefined = undefined>(definition: import("devframe/rpc").RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeHubContext>) => import("devframe/rpc").RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeHubContext>;

package/dist/node/index.d.mts

@@ -1,6 +1,6 @@
 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-Cw5sDVoA.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-BSgzLnsu.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { DevframeDefinition } from "devframe/types";
 import { SharedState } from "devframe/utils/shared-state";

package/dist/node/index.mjs

@@ -1,6 +1,6 @@
 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 { coerceAgentPositionalArgs, createHostContext, createStorage } from "devframe/node";
 import { debounce } from "perfect-debounce";
@@ -76,6 +76,10 @@ const diagnostics = defineDiagnostics({
 			why: (p) => `Terminal session "${p.id}" is not restartable`,
 			fix: "It was registered with `restartable: false`; restart it through its owner's controls, or spawn it with `restartable: true` (the default) to allow in-place restarts."
 		},
+		DF8206: {
+			why: (p) => `Terminal session "${p.id}" cannot be restarted — its output stream is already closed`,
+			fix: "The session already exited (or was terminated) and its stream is spent. Drop it with `ctx.terminals.remove(session)`, then spawn a replacement via `ctx.terminals.startChildProcess()` or `ctx.terminals.startPtySession()` with a fresh id."
+		},
 		DF8400: { why: (p) => `Command "${p.id}" is already registered` },
 		DF8401: { why: "Cannot change the id of a command. Use register() to add new commands" },
 		DF8402: { why: (p) => `Command "${p.id}" is not registered` },
@@ -231,45 +235,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();
@@ -303,7 +268,7 @@ var DevframeDocksHost = class {
 		};
 		return {
 			...view,
-			url: buildRemoteUrl(view.url, payload, record.options.transport)
+			url: buildRemoteConnectionUrl(view.url, payload, record.options.transport)
 		};
 	}
 	resolveDevServerOrigin() {
@@ -739,7 +704,7 @@ var DevframeTerminalsHost = class {
 		}
 		cp = createChildProcess();
 		const restart = async () => {
-			if (streamClosed) return;
+			if (streamClosed) throw diagnostics.DF8206({ id: terminal.id });
 			cp?.kill();
 			cp = createChildProcess();
 			markStatus("running");
@@ -870,7 +835,7 @@ var DevframeTerminalsHost = class {
 				markStatus("stopped");
 			},
 			restart: async () => {
-				if (streamClosed) return;
+				if (streamClosed) throw diagnostics.DF8206({ id: terminal.id });
 				pty?.kill();
 				pty = spawnPty();
 				markStatus("running");

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/types/index.d.mts

@@ -1,4 +1,4 @@
 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";
+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-BSgzLnsu.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-IzywMKfP.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.8.0",
+  "version": "0.8.2",
   "description": "Framework-neutral hub layer for devframe — docks, terminals, messages, commands.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.8.0"
+    "devframe": "0.8.2"
   },
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -41,7 +41,7 @@
     "nostics": "^1.2.0",
     "pathe": "^2.0.3",
     "perfect-debounce": "^2.1.0",
-    "tinyexec": "^1.2.4",
+    "tinyexec": "^1.3.0",
     "zigpty": "^0.2.1"
   },
   "devDependencies": {
@@ -49,7 +49,7 @@
     "mlly": "^1.8.2",
     "tsdown": "^0.22.14",
     "valibot": "^1.4.2",
-    "devframe": "0.8.0"
+    "devframe": "0.8.2"
   },
   "scripts": {
     "build": "tsdown",