devframe 0.9.0-beta.1 → 0.9.0-beta.3

package/dist/{_shared-DmpWW-HH.d.mts → _shared-Bm8p4-fD.d.mts}

@@ -1,4 +1,4 @@
-import { _ as ConnectionMeta, f as McpRouteOptions, i as DevframeDeploymentKind, r as DevframeDefinition } from "./devframe-Bdd9YXTy.mjs";
+import { _ as ConnectionMeta, f as McpRouteOptions, i as DevframeDeploymentKind, r as DevframeDefinition } from "./devframe-5oblos7I.mjs";
 //#region src/adapters/_shared.d.ts
 /**
  * Resolve the mount base path for a devframe's SPA. Hosted adapters
@@ -35,8 +35,6 @@ declare function resolveDevServerPort(def: DevframeDefinition, options?: Resolve
  * and the client dials `<page-host>:<port><path>`. Without `port` the path
  * stays relative, resolved against `__connection.json`'s own location (the
  * same-server default).
- *
- * @experimental
  */
 declare function resolveMcpConnectionMeta(def: DevframeDefinition, mcp: boolean | McpRouteOptions | undefined, port?: number): ConnectionMeta['mcp'];
 //#endregion

package/dist/{dist-D8jAMwxU.mjs → _shared-CGPVmXUM.mjs}

@@ -1,6 +1,8 @@
 import { n as __exportAll } from "./rolldown-runtime-JspESFgx.mjs";
+import "./constants.mjs";
 import { createServer } from "node:net";
 import { networkInterfaces } from "node:os";
+import { cleanDoubleSlashes, withLeadingSlash, withTrailingSlash, withoutLeadingSlash } from "ufo";
 //#region ../../node_modules/.pnpm/get-port-please@3.2.0/node_modules/get-port-please/dist/index.mjs
 var dist_exports = /* @__PURE__ */ __exportAll({
 	checkPort: () => checkPort,
@@ -224,4 +226,68 @@ async function checkPort(port, host = process.env.HOST, verbose) {
 	return port;
 }
 //#endregion
-export { getPort as n, dist_exports as t };
+//#region src/adapters/_shared.ts
+const DEFAULT_PORT = 9999;
+/**
+* Resolve the mount base path for a devframe's SPA. Hosted adapters
+* (`vite`, `embedded`) default to `/__<id>/` so they don't collide
+* with the host app; standalone adapters (`cli`, `spa`, `build`)
+* default to `/` because they own the origin.
+*
+* The devframe author can override with `basePath` on the definition.
+*/
+function resolveBasePath(def, kind) {
+	if (def.basePath) return normalizeBasePath(def.basePath);
+	return kind === "standalone" ? "/" : `/__${def.id}/`;
+}
+function normalizeBasePath(base) {
+	return cleanDoubleSlashes(withTrailingSlash(withLeadingSlash(base)));
+}
+/**
+* Resolve the listening port for `createDevServer` (and `createHandler`'s
+* side-car tiers), honoring the definition's `cli.port` / `cli.portRange` /
+* `cli.random` settings. Exposed separately so authors who run their own
+* argv parsing can resolve a port up-front (to print it, log it, etc.)
+* before starting the server.
+*/
+async function resolveDevServerPort(def, options = {}) {
+	const host = options.host ?? def.cli?.host ?? "localhost";
+	const portOptions = {
+		port: options.defaultPort ?? def.cli?.port ?? DEFAULT_PORT,
+		host
+	};
+	if (def.cli?.portRange) portOptions.portRange = def.cli.portRange;
+	if (def.cli?.random) portOptions.random = def.cli.random;
+	return getPort(portOptions);
+}
+/**
+* Normalize the `cli.mcp` / `mcp` option (`boolean | McpRouteOptions`) into
+* concrete options, or `undefined` when the MCP route is disabled.
+*/
+function resolveMcpConfig(mcp) {
+	if (!mcp) return void 0;
+	return mcp === true ? {} : mcp;
+}
+/**
+* Resolve the `mcp` entry a `__connection.json` should advertise for a dev
+* server started with the given `mcp` option (falling back to `def.cli?.mcp`,
+* exactly like `createDevServer`), or `undefined` when the route is
+* disabled.
+*
+* Hosted bridges that hand-roll their connection meta pass the side-car
+* `port`: the advertised path becomes absolute (the side-car mounts at `/`)
+* and the client dials `<page-host>:<port><path>`. Without `port` the path
+* stays relative, resolved against `__connection.json`'s own location (the
+* same-server default).
+*/
+function resolveMcpConnectionMeta(def, mcp, port) {
+	const config = resolveMcpConfig(mcp ?? def.cli?.mcp);
+	if (!config) return void 0;
+	const route = withoutLeadingSlash(config.path ?? "__mcp");
+	return port != null ? {
+		path: withLeadingSlash(route),
+		port
+	} : { path: route };
+}
+//#endregion
+export { dist_exports as a, resolveMcpConnectionMeta as i, resolveBasePath as n, resolveDevServerPort as r, normalizeBasePath as t };

package/dist/adapters/build.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-Bdd9YXTy.mjs";
+import { r as DevframeDefinition } from "../devframe-5oblos7I.mjs";
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {
   /** Output directory. Defaults to `dist-static`. */

package/dist/adapters/build.mjs

@@ -3,9 +3,9 @@ import { n as strictJsonStringify } from "../serialization-BHY8M5NQ.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
 import { t as collectStaticRpcDump } from "../static-CvjkO8QE.mjs";
 import { n as structuredCloneStringify } from "../structured-clone-CbAV5rFI.mjs";
-import { t as diagnostics } from "../diagnostics-DLYH5oD3.mjs";
-import { t as createHostContext } from "../context-Du11TLcO.mjs";
-import { n as resolveBasePath } from "../_shared-CttmCMBi.mjs";
+import { t as diagnostics } from "../diagnostics-C7IGWppM.mjs";
+import { t as createHostContext } from "../context-b6iSomtv.mjs";
+import { n as resolveBasePath } from "../_shared-CGPVmXUM.mjs";
 import { t as createH3DevframeHost } from "../host-h3-CzCZwtuV.mjs";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "pathe";

package/dist/adapters/cac.d.mts

@@ -1,4 +1,4 @@
-import { Ft as CliFlagsSchema, It as InferCliFlags, Lt as defineCliFlags, Rt as parseCliFlags, r as DevframeDefinition } from "../devframe-Bdd9YXTy.mjs";
+import { It as CliFlagsSchema, Lt as InferCliFlags, Rt as defineCliFlags, r as DevframeDefinition, zt as parseCliFlags } from "../devframe-5oblos7I.mjs";
 import { CAC } from "cac";
 import { H3 } from "h3";
 //#region src/adapters/cac.d.ts

package/dist/adapters/cac.mjs

@@ -1,7 +1,7 @@
 import { n as colors } from "../diagnostics-reporter-CsIG85Q5.mjs";
-import { r as resolveDevServerPort } from "../_shared-CttmCMBi.mjs";
+import { r as resolveDevServerPort } from "../_shared-CGPVmXUM.mjs";
 import { createBuild } from "./build.mjs";
-import { t as createDevServer } from "../dev-BEveeA5H.mjs";
+import { t as createDevServer } from "../dev-4xjiynUD.mjs";
 import process from "node:process";
 import cac$1 from "cac";
 //#region src/adapters/flags.ts
@@ -94,7 +94,7 @@ function createCac(d, options = {}) {
 	const defaultPort = options.defaultPort ?? d.cli?.port ?? 9999;
 	const defaultHost = d.cli?.host ?? "localhost";
 	const cli = cac$1(d.cli?.command ?? d.id);
-	const devCommand = cli.command("[...args]", "Start a local dev server").option("--port <port>", "Port to listen on").option("--host <host>", "Host to bind to", { default: defaultHost }).option("--open", "Open the browser on start").option("--no-open", "Do not open the browser").option("--no-auth", "Disable the interactive authentication gate").option("--mcp", "Expose an MCP server over HTTP at /__mcp (use --no-mcp to disable) [experimental]");
+	const devCommand = cli.command("[...args]", "Start a local dev server").option("--port <port>", "Port to listen on").option("--host <host>", "Host to bind to", { default: defaultHost }).option("--open", "Open the browser on start").option("--no-open", "Do not open the browser").option("--no-auth", "Disable the interactive authentication gate").option("--mcp", "Expose an MCP server over HTTP at /__mcp (use --no-mcp to disable)");
 	if (d.cli?.flags) for (const [key, schema] of Object.entries(d.cli.flags)) {
 		const optionName = flagKeyToOption(key);
 		const description = schema.description ?? "";
@@ -124,7 +124,7 @@ function createCac(d, options = {}) {
 			pretty: flags.pretty
 		});
 	});
-	cli.command("mcp", "Start an MCP server exposing agent-facing tools (stdio) [experimental]").action(async () => {
+	cli.command("mcp", "Start an MCP server exposing agent-facing tools (stdio)").action(async () => {
 		const { createMcpServer } = await import("./mcp.mjs");
 		await createMcpServer(d, {
 			transport: "stdio",

package/dist/adapters/dev.d.mts

@@ -1,7 +1,7 @@
-import { G as DevframeNodeRpcSession, d as DevframeWsOptions, f as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition, u as DevframeSseOptions } from "../devframe-Bdd9YXTy.mjs";
-import { d as DevframeRpcConnection, u as DevframeNodeRpcSessionMeta } from "../ws-server-Ces08fjP.mjs";
-import { c as StartedServer } from "../instance-shell-DBTXTSjN.mjs";
-import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-DmpWW-HH.mjs";
+import { K as DevframeNodeRpcSession, d as DevframeWsOptions, f as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition, u as DevframeSseOptions } from "../devframe-5oblos7I.mjs";
+import { d as DevframeRpcConnection, u as DevframeNodeRpcSessionMeta } from "../ws-server-D1d3QM9f.mjs";
+import { c as StartedServer } from "../instance-shell-B-BSVp37.mjs";
+import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-Bm8p4-fD.mjs";
 import { H3 } from "h3";
 //#region src/adapters/dev.d.ts
 interface CreateDevServerOptions {
@@ -24,7 +24,7 @@ interface CreateDevServerOptions {
    * `def.cli?.distDir` is set, the dev server runs in **bridge mode** —
    * only `__connection.json` and the WS endpoint are mounted; the SPA
    * is expected to be hosted elsewhere (e.g. by a parent Vite/Nuxt
-   * dev server via `viteDevBridge({ devMiddleware })`).
+   * dev server via `devframeViteBridge` from `@devframes/vite`).
    */
   distDir?: string;
   /**
@@ -63,7 +63,7 @@ interface CreateDevServerOptions {
    * Override how authentication resolves, taking precedence over
    * `def.cli?.auth`. Pass `false` to skip the gate entirely (the standard
    * choice for a **hosted** deployment where the host manages auth — see
-   * {@link viteDevBridge}); a {@link DevframeAuthHandler} to install a custom
+   * {@link devframeViteBridge} from `@devframes/vite`); a {@link DevframeAuthHandler} to install a custom
    * scheme; or `true` to force devframe's interactive OTP gate on. When
    * omitted, auth resolves from `flags.auth` / `def.cli?.auth` (the standalone
    * default: gated). The `--no-auth` flag (`flags.auth === false`) still forces
@@ -107,7 +107,7 @@ interface CreateDevServerOptions {
  * server runs in **bridge mode**: only `__connection.json` and the WS
  * endpoint are mounted, with no SPA mount. The SPA is expected to be
  * hosted elsewhere (e.g. by a parent Vite/Nuxt dev server) — see
- * `viteDevBridge({ devMiddleware })`.
+ * `devframeViteBridge` from `@devframes/vite`.
  *
  * Returns the underlying {@link StartedServer} handle so callers can
  * close it gracefully (SIGINT, hot-reload, test teardown).

package/dist/adapters/dev.mjs

@@ -1,3 +1,3 @@
-import { i as resolveMcpConnectionMeta, r as resolveDevServerPort } from "../_shared-CttmCMBi.mjs";
-import { t as createDevServer } from "../dev-BEveeA5H.mjs";
+import { i as resolveMcpConnectionMeta, r as resolveDevServerPort } from "../_shared-CGPVmXUM.mjs";
+import { t as createDevServer } from "../dev-4xjiynUD.mjs";
 export { createDevServer, resolveDevServerPort, resolveMcpConnectionMeta };

package/dist/adapters/embedded.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition, x as DevframeNodeContext } from "../devframe-Bdd9YXTy.mjs";
+import { S as DevframeNodeContext, r as DevframeDefinition } from "../devframe-5oblos7I.mjs";
 //#region src/adapters/embedded.d.ts
 interface CreateEmbeddedOptions {
   /** Target context the devframe is registered into. Required. */

package/dist/adapters/initiate.d.mts

@@ -1,6 +1,6 @@
-import { B as DevframeStorageScope, G as DevframeNodeRpcSession, _ as ConnectionMeta, d as DevframeWsOptions, f as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition, u as DevframeSseOptions, x as DevframeNodeContext } from "../devframe-Bdd9YXTy.mjs";
-import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-Ces08fjP.mjs";
-import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-DBTXTSjN.mjs";
+import { K as DevframeNodeRpcSession, S as DevframeNodeContext, V as DevframeStorageScope, _ as ConnectionMeta, d as DevframeWsOptions, f as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition, u as DevframeSseOptions } from "../devframe-5oblos7I.mjs";
+import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-D1d3QM9f.mjs";
+import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-B-BSVp37.mjs";
 import { Buffer } from "node:buffer";
 import { IncomingMessage, Server, ServerResponse } from "node:http";
 import { Duplex } from "node:stream";

package/dist/adapters/initiate.mjs

@@ -1,2 +1,2 @@
-import { n as getInstanceInternals, r as initDevframe } from "../dev-BEveeA5H.mjs";
+import { n as getInstanceInternals, r as initDevframe } from "../dev-4xjiynUD.mjs";
 export { getInstanceInternals, initDevframe };

package/dist/adapters/mcp.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition, x as DevframeNodeContext } from "../devframe-Bdd9YXTy.mjs";
+import { S as DevframeNodeContext, r as DevframeDefinition } from "../devframe-5oblos7I.mjs";
 import { H3 } from "h3";
 import "@modelcontextprotocol/server";
 //#region src/adapters/mcp/build-server.d.ts
@@ -32,9 +32,6 @@ interface McpServerHandle {
 /**
  * Build an MCP server over the agent surface of a devframe definition.
  * Currently supports `stdio` transport only.
- *
- * @experimental The agent-native surface is experimental and may change
- * without a major version bump until it stabilizes.
  */
 declare function createMcpServer(definition: DevframeDefinition, options?: CreateMcpServerOptions): Promise<McpServerHandle>;
 //#endregion
@@ -81,8 +78,6 @@ interface McpFetchHandler {
  * loopback-default DNS-rebinding protection that — unlike the WS upgrade's
  * `isAllowedOrigin` — also rejects `Origin`-less requests, so a route-based
  * endpoint isn't reachable by an arbitrary local process.
- *
- * @experimental
  */
 declare function createMcpFetchHandler(ctx: DevframeNodeContext, options: CreateMcpFetchHandlerOptions): McpFetchHandler;
 //#endregion
@@ -104,8 +99,6 @@ interface MountedMcpHttp {
  * legitimate MCP 404 (unknown session) isn't swallowed by h3's
  * "Response-with-404 falls through to the next handler" rule (which would
  * otherwise hand the request to the SPA static catch-all).
- *
- * @experimental
  */
 declare function mountMcpHttp(app: H3, ctx: DevframeNodeContext, path: string, options: MountMcpHttpOptions): MountedMcpHttp;
 //#endregion

package/dist/adapters/mcp.mjs

@@ -1,2 +1,2 @@
-import { i as createMcpServer, n as mountMcpHttp, r as createMcpFetchHandler } from "../http-DLr_cJZ7.mjs";
+import { i as createMcpServer, n as mountMcpHttp, r as createMcpFetchHandler } from "../http-Z0w9baEe.mjs";
 export { createMcpFetchHandler, createMcpServer, mountMcpHttp };

package/dist/{agent-tool-name-C3b5vEwJ.mjs → agent-tool-name-EgfoFO8C.mjs}

@@ -23,9 +23,6 @@ const MAX_TOOL_NAME_LENGTH = 128;
 * A plain string transform with no node dependency, so browser-side UIs
 * that display a tool's id (e.g. the inspect plugin's agent view) can
 * import it too and show the name a client actually calls.
-*
-* @experimental The agent-native surface is experimental and may change
-* without a major version bump until it stabilizes.
 */
 function toAgentToolName(id) {
 	return id.replace(/[^\w-]+/g, "_").slice(0, MAX_TOOL_NAME_LENGTH);

package/dist/cli/main.d.mts

@@ -3,8 +3,6 @@
  * The `devframe` bin — the framework's own CLI, distinct from the per-app
  * CLI shells authors build with `createCac(definition)`. It hosts the
  * app-independent commands; today that is `connect`, the MCP connector.
- *
- * @experimental
  */
 declare function runDevframeCli(argv?: string[]): Promise<void>;
 //#endregion

package/dist/cli/main.mjs

@@ -1,6 +1,6 @@
-import { t as diagnostics } from "../diagnostics-DLYH5oD3.mjs";
-import { n as listLiveDevframeInstances, r as probeDevframeOrigin } from "../instance-registry-BQqGoDO9.mjs";
-import { t as toAgentToolName } from "../agent-tool-name-C3b5vEwJ.mjs";
+import { t as diagnostics } from "../diagnostics-C7IGWppM.mjs";
+import { n as listLiveDevframeInstances, r as probeDevframeOrigin } from "../instance-registry-Du_hbx-j.mjs";
+import { t as toAgentToolName } from "../agent-tool-name-EgfoFO8C.mjs";
 import { Diagnostic } from "nostics";
 import process from "node:process";
 import { joinURL } from "ufo";
@@ -54,8 +54,6 @@ const GATEWAY_TOOLS = [{
 * the instance registry and list each one's MCP tools) and
 * `devframe_connect_call-tool` (invoke one tool on one instance over its
 * Streamable-HTTP endpoint) — and holds no domain knowledge of its own.
-*
-* @experimental
 */
 async function startConnectServer(options = {}) {
 	const sdk = await importSdk();
@@ -259,8 +257,6 @@ function keepAlive() {
 * The `devframe` bin — the framework's own CLI, distinct from the per-app
 * CLI shells authors build with `createCac(definition)`. It hosts the
 * app-independent commands; today that is `connect`, the MCP connector.
-*
-* @experimental
 */
 async function runDevframeCli(argv = process.argv) {
 	const cli = cac("devframe");

package/dist/client/index.d.mts

@@ -1,8 +1,8 @@
-import { $ as DevframeRpcClientFunctions, F as ScopedServerFunctions, I as ScopedSharedStates, J as RpcSharedStateGetOptions, L as SettingsForNamespace, Mt as EventEmitter, P as ScopedRpcFn, Y as RpcSharedStateHost, _ as ConnectionMeta, et as DevframeRpcServerFunctions, gt as SharedState, k as DevframeSettings, ot as StreamReader, st as StreamSink } from "../devframe-Bdd9YXTy.mjs";
-import { f as RpcCacheManager, p as RpcCacheOptions } from "../index-DSCq4M4q.mjs";
-import { _ as RpcFunctionDefinition, w as RpcFunctionsCollector } from "../types-CnJSgRVa.mjs";
-import { t as SseRpcChannelOptions } from "../sse-client-BsIK3hMD.mjs";
-import { t as WsRpcChannelOptions } from "../ws-client-CdNuATYa.mjs";
+import { A as DevframeSettings, F as ScopedRpcFn, I as ScopedServerFunctions, L as ScopedSharedStates, Nt as EventEmitter, R as SettingsForNamespace, X as RpcSharedStateHost, Y as RpcSharedStateGetOptions, _ as ConnectionMeta, _t as SharedState, ct as StreamSink, et as DevframeRpcClientFunctions, st as StreamReader, tt as DevframeRpcServerFunctions } from "../devframe-5oblos7I.mjs";
+import { f as RpcCacheManager, p as RpcCacheOptions } from "../index-tdrk1bzV.mjs";
+import { _ as RpcFunctionDefinition, w as RpcFunctionsCollector } from "../types-Djq7CBXh.mjs";
+import { t as SseRpcChannelOptions } from "../sse-client-CFBOIaUi.mjs";
+import { t as WsRpcChannelOptions } from "../ws-client-DhjNyQo3.mjs";
 import { BirpcOptions, BirpcReturn } from "birpc";
 //#region src/client/connection.d.ts
 interface DevframeConnection {

package/dist/{context-C33rR7n0.mjs → context-CMSryXs-.mjs}

@@ -1,5 +1,5 @@
 import { n as randomToken } from "./crypto-token-XCqTSMg9.mjs";
-import { t as createStorage } from "./storage-BcmVEJRc.mjs";
+import { t as createStorage } from "./storage-CaUVrBrG.mjs";
 import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "./revoke-DZbJ7Cl0.mjs";
 import { join } from "pathe";
 //#region src/node/hub-internals/context.ts
@@ -11,6 +11,7 @@ function getInternalContext(context) {
 			initialValue: { trusted: {} }
 		});
 		const remoteTokens = /* @__PURE__ */ new Map();
+		const wsEndpointListeners = /* @__PURE__ */ new Set();
 		function revokeRemoteToken(token) {
 			if (!remoteTokens.delete(token)) return;
 			revokeActiveConnectionsForToken(context, token);
@@ -18,6 +19,14 @@ function getInternalContext(context) {
 		const internalContext = {
 			storage: { auth: storage },
 			revokeAuthToken: (token) => revokeAuthToken(context, storage, token),
+			setWsEndpoint(endpoint) {
+				internalContext.wsEndpoint = endpoint;
+				for (const listener of wsEndpointListeners) listener();
+			},
+			onWsEndpointChange(cb) {
+				wsEndpointListeners.add(cb);
+				return () => wsEndpointListeners.delete(cb);
+			},
 			remoteTokens,
 			allocateRemoteToken(dockId, origin, originLock) {
 				const token = randomToken();

package/dist/{context-CSCwoABx.d.mts → context-DV4uWieM.d.mts}

@@ -1,4 +1,4 @@
-import { gt as SharedState, x as DevframeNodeContext } from "./devframe-Bdd9YXTy.mjs";
+import { S as DevframeNodeContext, _t as SharedState } from "./devframe-5oblos7I.mjs";
 //#region src/node/hub-internals/context.d.ts
 interface InternalAnonymousAuthStorage {
   trusted: Record<string, {
@@ -44,6 +44,24 @@ interface DevframeInternalContext {
     /** Full `ws://` or `wss://` URL with host and port. */
     url: string;
   };
+  /**
+   * Set {@link DevframeInternalContext.wsEndpoint} and notify subscribers —
+   * the WS-binding tiers (side-car, shared-server, and the `unbound` tier's
+   * `attach()`) call this once the socket is bound (or `undefined` once torn
+   * down) instead of assigning the field directly, so anything that already
+   * projected the endpoint (a hub's remote-dock URLs, registered before an
+   * async bind resolves) gets a chance to re-project it.
+   */
+  setWsEndpoint: (endpoint: {
+    url: string;
+  } | undefined) => void;
+  /**
+   * Subscribe to every {@link DevframeInternalContext.setWsEndpoint} call.
+   * Returns an unsubscribe function. The hub context uses this to refresh
+   * the `devframe:docks` shared state so a remote dock registered before the
+   * WS port resolves still ends up with a live connection URL.
+   */
+  onWsEndpointChange: (cb: () => void) => () => void;
 }
 declare const internalContextMap: WeakMap<DevframeNodeContext, DevframeInternalContext>;
 declare function getInternalContext(context: DevframeNodeContext): DevframeInternalContext;

package/dist/{context-Du11TLcO.mjs → context-b6iSomtv.mjs}

@@ -2,9 +2,9 @@ import { t as devframeReporter } from "./diagnostics-reporter-CsIG85Q5.mjs";
 import { t as diagnostics } from "./diagnostics-hwjXp_UV.mjs";
 import { RpcFunctionsCollectorBase } from "./rpc/index.mjs";
 import { defineRpcFunction } from "./index.mjs";
-import { t as diagnostics$1 } from "./diagnostics-DLYH5oD3.mjs";
-import { i as createEventEmitter, n as createSharedState, r as nanoid, t as createStorage } from "./storage-BcmVEJRc.mjs";
-import { t as DevframeAgentHost } from "./host-agent-CpbAoqBx.mjs";
+import { t as diagnostics$1 } from "./diagnostics-C7IGWppM.mjs";
+import { i as createEventEmitter, n as createSharedState, r as nanoid, t as createStorage } from "./storage-CaUVrBrG.mjs";
+import { t as DevframeAgentHost } from "./host-agent-BBkKT27Q.mjs";
 import { defineDiagnostics } from "nostics";
 import { isatty } from "node:tty";
 import { formatWithOptions, inspect } from "node:util";
@@ -1131,8 +1131,6 @@ const agentListResources = defineRpcFunction({
 * Built-in agent introspection RPC functions. Registered automatically
 * by `createHostContext`. Not themselves agent-exposed (no `agent`
 * field) — they power the MCP adapter and any future agent CLI.
-*
-* @experimental
 */
 const BUILTIN_AGENT_RPC = [
 	defineRpcFunction({
@@ -1297,6 +1295,7 @@ async function createHostContext(options) {
 		diagnostics: void 0,
 		agent: void 0,
 		services: void 0,
+		staticConfig: {},
 		scope: void 0
 	};
 	const rpcHost = new RpcFunctionsHostImpl(context);

package/dist/{dev-BEveeA5H.mjs → dev-4xjiynUD.mjs}

@@ -1,9 +1,9 @@
 import { DEVFRAME_CONNECTION_META_FILENAME } from "./constants.mjs";
-import { t as diagnostics } from "./diagnostics-DLYH5oD3.mjs";
-import { t as createHostContext } from "./context-Du11TLcO.mjs";
-import { i as resolveMcpConnectionMeta, n as resolveBasePath, r as resolveDevServerPort, t as normalizeBasePath } from "./_shared-CttmCMBi.mjs";
+import { t as diagnostics } from "./diagnostics-C7IGWppM.mjs";
+import { t as createHostContext } from "./context-b6iSomtv.mjs";
+import { i as resolveMcpConnectionMeta, n as resolveBasePath, r as resolveDevServerPort, t as normalizeBasePath } from "./_shared-CGPVmXUM.mjs";
 import { t as createH3DevframeHost } from "./host-h3-CzCZwtuV.mjs";
-import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, t as createInstanceShell } from "./instance-shell-KRdee1QF.mjs";
+import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, t as createInstanceShell } from "./instance-shell-B0TwOxCl.mjs";
 import { t as open } from "./open-Dz4V4irZ.mjs";
 import { mountStaticHandler } from "./utils/serve-static.mjs";
 import { createServer } from "node:http";
@@ -86,7 +86,7 @@ function initDevframe(def, options) {
 				const mcpPath = joinURL(base, mcpMeta.path);
 				let mountMcpHttp;
 				try {
-					({mountMcpHttp} = await import("./http-DLr_cJZ7.mjs").then((n) => n.t));
+					({mountMcpHttp} = await import("./http-Z0w9baEe.mjs").then((n) => n.t));
 				} catch (error) {
 					const reason = error instanceof Error ? error.message : String(error);
 					throw diagnostics.DF0017({
@@ -138,7 +138,7 @@ function initDevframe(def, options) {
 * server runs in **bridge mode**: only `__connection.json` and the WS
 * endpoint are mounted, with no SPA mount. The SPA is expected to be
 * hosted elsewhere (e.g. by a parent Vite/Nuxt dev server) — see
-* `viteDevBridge({ devMiddleware })`.
+* `devframeViteBridge` from `@devframes/vite`.
 *
 * Returns the underlying {@link StartedServer} handle so callers can
 * close it gracefully (SIGINT, hot-reload, test teardown).