devframe 0.9.9 → 0.9.10

package/dist/{context-4AIVRLYF.d.mts → context-CHW4BZOj.d.mts}

@@ -261,6 +261,13 @@ interface DevframeAgentHost {
    * tools/resources registered on the host.
    */
   list: () => AgentManifest;
+  /**
+   * Whether the devframe exposes anything to agents: an `agent`-flagged RPC
+   * function, a registered tool or resource, or a provider currently
+   * yielding at least one tool. The `mcp: 'auto'` default consults this to
+   * decide whether a route is worth mounting.
+   */
+  hasSurface: () => boolean;
   /**
    * Invoke any tool by id. Routes to the underlying RPC handler for
    * `kind === 'rpc'`, or to the registered handler for `kind === 'tool'`.
@@ -1169,9 +1176,27 @@ interface DevframeSseOptions {
  * - `false`, the default: **origin-only**, trusting same-machine callers.
  */
 type McpAuthorization = string | ((request: Request) => boolean | Promise<boolean>) | false;
+/**
+ * The route-based MCP setting accepted everywhere a host mounts a devframe
+ * (`cli.mcp`, `initDevframe` / `initHub` / `createDevServer` options, the
+ * framework kits):
+ *
+ * - `'auto'`, the default: mount the route when the devframe exposes an
+ *   agent surface (an `agent`-flagged RPC function, or a tool / resource /
+ *   provider registered on `ctx.agent`). An empty agent surface mounts
+ *   nothing and loads no MCP code.
+ * - `true`: always mount at the default `__mcp` route.
+ * - `false`: never mount.
+ * - {@link McpRouteOptions}: always mount, with a custom route path, origin
+ *   allow-list, or {@link McpAuthorization} identity check.
+ *
+ * A mounted route trusts same-machine callers by default (the loopback
+ * origin gate), exactly like `mcp: true`.
+ */
+type McpSetting = boolean | 'auto' | McpRouteOptions;
 /**
  * Configuration for the route-based MCP server mounted alongside the dev
- * server (opt-in via {@link DevframeCliOptions.mcp}). The endpoint speaks
+ * server (via {@link DevframeCliOptions.mcp}). The endpoint speaks
  * the MCP Streamable-HTTP transport over the same origin as the SPA,
  * exposing the definition's `ctx.agent` tools + shared-state resources to
  * external MCP clients connected to the *running* server.
@@ -1253,11 +1278,11 @@ interface DevframeCliOptions {
    * base path). It surfaces the same `ctx.agent` tools + shared-state
    * resources as the stdio `mcp` command, but against the live server.
    *
-   * - `false` / omitted (default): no MCP route is mounted.
-   * - `true`: mount at the default `__mcp` route with the loopback origin
-   *   gate (trusting same-machine callers).
-   * - {@link McpRouteOptions}: customise the route path, origin allow-list,
-   *   and opt into an {@link McpAuthorization} identity check.
+   * Defaults to `'auto'`: the route mounts once the devframe exposes an
+   * agent surface (an `agent`-flagged RPC, a registered tool / resource).
+   * See {@link McpSetting} for the full contract, and
+   * {@link McpRouteOptions} for the route path, origin allow-list, and
+   * {@link McpAuthorization} identity check.
    *
    * The `--mcp` / `--no-mcp` CLI flags override this per run. Whether to expose
    * MCP is a hosting decision, so programmatic hosts pass it to
@@ -1268,7 +1293,7 @@ interface DevframeCliOptions {
    * This field is still read as a fallback, and will be removed in a future
    * release.
    */
-  mcp?: boolean | McpRouteOptions;
+  mcp?: McpSetting;
   /**
    * Author's SPA dist, served as the devframe's UI.
    *
@@ -1461,10 +1486,11 @@ interface DevframeDefinition {
    * act on a `false` before doing any work:
    *
    * - `build: false`: `createCac` skips registering the `build` subcommand,
-   *   and `createBuild` refuses (throws `DF0042`) unless `{ force: true }`.
-   *   Useful for a devframe whose value is inherently live (e.g. it manages
-   *   real files on disk), so a static export would only ever produce a
-   *   broken, write-less shell of the tool.
+   *   `createBuild` refuses (throws `DF0042`) unless `{ force: true }`, and
+   *   a hub static build (`buildHub`) silently skips the devframe - no dock,
+   *   no SPA copy, no RPCs in the dump. Useful for a devframe whose value is
+   *   inherently live (e.g. it manages real files on disk), so a static
+   *   export would only ever produce a broken, write-less shell of the tool.
    * - `dev: false`: `createDevServer` refuses (throws `DF0058`) unless
    *   `{ force: true }`. Useful for a devframe that only makes sense as a
    *   static export (e.g. a report generator with nothing to serve live).
@@ -2060,12 +2086,19 @@ interface ConnectionMeta {
    */
   jsonSerializableMethods?: string[];
   /**
-   * Absolute URL of the `__connection.json` this meta was loaded from.
-   * Annotated by the client (not served) when it publishes the meta on a
-   * shared window for same-origin inheritance: a relative `websocket.path`
-   * resolves against this, so a child SPA mounted at another base (e.g. a hub
-   * mounting several devframes at `/__foo/`, `/__bar/`, …) inherits a dialable
-   * endpoint rather than resolving the path against its own mount.
+   * URL of the `__connection.json` that owns this meta's relative paths.
+   * Two producers write it:
+   *
+   *   - The client annotates it (absolute) when it publishes the meta on a
+   *     shared window for same-origin inheritance: a relative
+   *     `websocket.path` resolves against this, so a child SPA mounted at
+   *     another base (e.g. a hub mounting several devframes at `/__foo/`,
+   *     `/__bar/`, …) inherits a dialable endpoint rather than resolving the
+   *     path against its own mount.
+   *   - A static hub build serves it (base-absolute, e.g.
+   *     `/__devframes/__connection.json`) in each **per-frame** meta, so a
+   *     frame SPA that fetched its own copy still resolves the shared RPC
+   *     dump from the hub base. Resolved against the fetched URL.
    */
   baseUrl?: string;
   /**
@@ -2125,4 +2158,4 @@ interface ConnectionMeta {
  */
 interface DevframeConnectionConfigsRegistry {}
 //#endregion
-export { DevframeServiceScopeOf as $, SharedStateEvents as A, AgentManifest as At, DevframeSetupInfo as B, EventEmitter as Bt, createStreamSink as C, DevframeDiagnosticsLogger as Ct, ImmutableObject as D, defineCliFlags as Dt, ImmutableMap as E, InferCliFlags as Et, DevframeDefinition as F, AgentToolInput as Ft, McpAuthorization as G, DevframeSnapshotRpcInputs as H, EventsMap as Ht, DevframeDeploymentKind as I, AgentToolProvider as It, DevframeServiceDescriptor as J, McpRouteOptions as K, DevframeDockDefaults as L, AgentToolProviderHandle as Lt, SharedStatePatch as M, AgentResourceContent as Mt, createSharedState as N, AgentResourceInput as Nt, ImmutableSet as O, parseCliFlags as Ot, DevframeCliOptions as P, AgentTool as Pt, DevframeServiceOf as Q, DevframeDuplicationStrategy as R, DevframeAgentHost as Rt, createStreamReader as S, DevframeDiagnosticsHost as St, ImmutableArray as T, CliFlagsSchema as Tt, DevframeSseOptions as U, DevframeSnapshotRpcEntry as V, EventUnsubscribe as Vt, DevframeWsOptions as W, DevframeServiceInput as X, DevframeServiceId as Y, DevframeServiceMeta as Z, CreateStreamSinkOptions as _, DevframeRpcClientFunctions as _t, DevframeConnectionConfigsRegistry as a, DevframeScopedNodeRpc as at, StreamSink as b, DevframeHost as bt, RpcBroadcastOptions as c, DevframeSettingsRegistry as ct, RpcSharedStateHost as d, ScopedClientFunctions as dt, DevframeServicesHost as et, RpcStreamingChannel as f, ScopedRpcFn as ft, CreateStreamReaderOptions as g, DevframeViewHost as gt, BufferedChunk as h, SettingsForNamespace as ht, DevframeCapabilities as i, DevframeScopedNodeContext as it, SharedStateOptions as j, AgentResource as jt, SharedState as k, AgentHandle as kt, RpcFunctionsHost as l, DevframeSettingsStore as lt, RpcStreamingHost as m, ScopedSharedStates as mt, ConnectionMetaSse as n, DevframeServicesScopeRegistry as nt, DevframeNodeContext as o, DevframeScopedStreamingHost as ot, RpcStreamingChannelOptions as p, ScopedServerFunctions as pt, DevframeServiceDefinition as q, ConnectionMetaWebsocket as r, DevframeServicesState as rt, DevframeNodeRpcSession as s, DevframeSettings as st, ConnectionMeta as t, DevframeServicesRegistry as tt, RpcSharedStateGetOptions as u, ScopedBroadcastOptions as ut, StreamErrorPayload as v, DevframeRpcServerFunctions as vt, Immutable as w, DevframeAuthHandler as wt, StreamSinkEvents as x, DevframeStorageScope as xt, StreamReader as y, DevframeRpcSharedStates as yt, DevframeRpcOptions as z, DevframeAgentHostEvents as zt };
+export { DevframeServiceOf as $, SharedStateEvents as A, AgentHandle as At, DevframeSetupInfo as B, DevframeAgentHostEvents as Bt, createStreamSink as C, DevframeDiagnosticsHost as Ct, ImmutableObject as D, InferCliFlags as Dt, ImmutableMap as E, CliFlagsSchema as Et, DevframeDefinition as F, AgentTool as Ft, McpAuthorization as G, DevframeSnapshotRpcInputs as H, EventUnsubscribe as Ht, DevframeDeploymentKind as I, AgentToolInput as It, DevframeServiceDefinition as J, McpRouteOptions as K, DevframeDockDefaults as L, AgentToolProvider as Lt, SharedStatePatch as M, AgentResource as Mt, createSharedState as N, AgentResourceContent as Nt, ImmutableSet as O, defineCliFlags as Ot, DevframeCliOptions as P, AgentResourceInput as Pt, DevframeServiceMeta as Q, DevframeDuplicationStrategy as R, AgentToolProviderHandle as Rt, createStreamReader as S, DevframeStorageScope as St, ImmutableArray as T, DevframeAuthHandler as Tt, DevframeSseOptions as U, EventsMap as Ut, DevframeSnapshotRpcEntry as V, EventEmitter as Vt, DevframeWsOptions as W, DevframeServiceId as X, DevframeServiceDescriptor as Y, DevframeServiceInput as Z, CreateStreamSinkOptions as _, DevframeViewHost as _t, DevframeConnectionConfigsRegistry as a, DevframeScopedNodeContext as at, StreamSink as b, DevframeRpcSharedStates as bt, RpcBroadcastOptions as c, DevframeSettings as ct, RpcSharedStateHost as d, ScopedBroadcastOptions as dt, DevframeServiceScopeOf as et, RpcStreamingChannel as f, ScopedClientFunctions as ft, CreateStreamReaderOptions as g, SettingsForNamespace as gt, BufferedChunk as h, ScopedSharedStates as ht, DevframeCapabilities as i, DevframeServicesState as it, SharedStateOptions as j, AgentManifest as jt, SharedState as k, parseCliFlags as kt, RpcFunctionsHost as l, DevframeSettingsRegistry as lt, RpcStreamingHost as m, ScopedServerFunctions as mt, ConnectionMetaSse as n, DevframeServicesRegistry as nt, DevframeNodeContext as o, DevframeScopedNodeRpc as ot, RpcStreamingChannelOptions as p, ScopedRpcFn as pt, McpSetting as q, ConnectionMetaWebsocket as r, DevframeServicesScopeRegistry as rt, DevframeNodeRpcSession as s, DevframeScopedStreamingHost as st, ConnectionMeta as t, DevframeServicesHost as tt, RpcSharedStateGetOptions as u, DevframeSettingsStore as ut, StreamErrorPayload as v, DevframeRpcClientFunctions as vt, Immutable as w, DevframeDiagnosticsLogger as wt, StreamSinkEvents as x, DevframeHost as xt, StreamReader as y, DevframeRpcServerFunctions as yt, DevframeRpcOptions as z, DevframeAgentHost as zt };

package/dist/{context-DIUvJW4D.mjs → context-jXO5vzjH.mjs}

@@ -1,5 +1,5 @@
 import { n as randomToken } from "./crypto-token-TVbGGFuj.mjs";
-import { t as createStorage } from "./storage-Dccf_IyD.mjs";
+import { t as createStorage } from "./storage-B70AXK64.mjs";
 import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "./revoke-cqztiCX4.mjs";
 import { join } from "pathe";
 //#region src/node/hub-internals/context.ts

package/dist/{dev-Eqq5PX0k.mjs → dev-CRYHx7iG.mjs}

@@ -1,16 +1,16 @@
 import { t as resolveClientAssets } from "./client-assets-DNdhagGm.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME } from "./constants.mjs";
-import { t as diagnostics } from "./diagnostics-BMfN8mb1.mjs";
-import { t as createHostContext } from "./context-CwPUinjn.mjs";
-import { t as resolveStaticAssetsSource } from "./remote-assets-BIFWOlBW.mjs";
-import { i as resolveMcpConfig, n as resolveBasePath, r as resolveDevServerPort, t as normalizeBasePath } from "./_shared-C08SdQRl.mjs";
-import { t as createH3DevframeHost } from "./host-h3-BJ4siyz7.mjs";
-import { a as importRuntimeModule, i as normalizeHttpServerUrl, n as resolveInstanceRegister, t as createInstanceShell } from "./instance-shell-cdVETpfz.mjs";
+import { t as diagnostics } from "./diagnostics-DZA6KQ_Z.mjs";
+import { t as createHostContext } from "./context-B29Oh0oA.mjs";
+import { t as resolveStaticAssetsSource } from "./remote-assets-DMFzLSoH.mjs";
+import { a as resolveMcpConfig, i as resolveDevServerPort, n as normalizeBasePath, r as resolveBasePath, s as importRuntimeModule, t as loadAutoMcpAdapter } from "./_shared-U8D-xzrp.mjs";
+import { t as createH3DevframeHost } from "./host-h3-BROI6SQ4.mjs";
+import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, t as createInstanceShell } from "./instance-shell-DvYCwrDy.mjs";
 import { open } from "./utils/open.mjs";
 import { mountStaticHandler } from "./utils/serve-static.mjs";
+import { resolve } from "pathe";
 import { createServer } from "node:http";
 import process from "node:process";
-import { resolve } from "pathe";
 import { joinURL, withBase, withoutLeadingSlash } from "ufo";
 import { H3, toNodeHandler } from "h3";
 //#region src/adapters/initiate.ts
@@ -88,36 +88,11 @@ function initDevframe(def, options) {
 			for (const input of def.services ?? []) context.services.install(input, { resolveFrom: def.importMetaUrl });
 			await context.services.ready();
 			await def.setup(context, setupInfo);
-			const mcpConfig = resolveMcpConfig(options.mcp ?? def.cli?.mcp);
-			let mcpMeta;
-			let mcpDispose;
-			if (mcpConfig) {
-				const mcpRoute = withoutLeadingSlash(mcpConfig.path ?? "__mcp");
-				mcpMeta = { path: mcpRoute };
-				const mcpPath = joinURL(base, mcpRoute);
-				let mountMcpHttp;
-				try {
-					({mountMcpHttp} = await importRuntimeModule("devframe/adapters/mcp"));
-				} catch (error) {
-					const reason = error instanceof Error ? error.message : String(error);
-					throw diagnostics.DF0017({
-						transport: "http",
-						reason,
-						cause: error
-					});
-				}
-				mcpDispose = mountMcpHttp(app, context, mcpPath, {
-					serverName: `${def.id} (devframe)`,
-					serverVersion: def.version ?? "0.0.0",
-					exposeSharedState: true,
-					authorization: mcpConfig.authorization,
-					allowedOrigins: mcpConfig.allowedOrigins
-				}).dispose;
-			}
+			const mcp = await mountMcpRoute(app, context, def, base, options.mcp ?? def.cli?.mcp ?? "auto");
 			return {
 				context,
-				...mcpMeta ? { mcp: mcpMeta } : {},
-				...mcpDispose ? { dispose: mcpDispose } : {}
+				...mcp?.meta ? { mcp: mcp.meta } : {},
+				...mcp?.dispose ? { dispose: mcp.dispose } : {}
 			};
 		},
 		mount(context, meta) {
@@ -142,6 +117,45 @@ function initDevframe(def, options) {
 	INSTANCE_INTERNALS.set(instance, shell.internals);
 	return instance;
 }
+/**
+* Mount the route-based MCP server at `<base>__mcp`, before the SPA static
+* catch-all so the exact route wins. The MCP SDK is pulled in dynamically
+* only when the route mounts, keeping it out of consumer bundles: `'auto'`
+* mounts once `setup()` left a non-empty agent surface (an empty surface
+* loads no MCP code); an explicit setting mounts unconditionally. The
+* resolved config is origin-only unless it opts into a bearer/callback.
+*/
+async function mountMcpRoute(app, context, def, base, setting) {
+	let module;
+	let config;
+	if (setting === "auto") {
+		module = await loadAutoMcpAdapter(context.agent);
+		if (module) config = { authorization: false };
+	} else config = resolveMcpConfig(setting);
+	if (!config) return void 0;
+	const route = withoutLeadingSlash(config.path ?? "__mcp");
+	if (!module) try {
+		module = await importRuntimeModule("devframe/adapters/mcp");
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		throw diagnostics.DF0017({
+			transport: "http",
+			reason,
+			cause: error
+		});
+	}
+	const mounted = module.mountMcpHttp(app, context, joinURL(base, route), {
+		serverName: `${def.id} (devframe)`,
+		serverVersion: def.version ?? "0.0.0",
+		exposeSharedState: true,
+		authorization: config.authorization,
+		allowedOrigins: config.allowedOrigins
+	});
+	return {
+		meta: { path: route },
+		dispose: mounted.dispose
+	};
+}
 //#endregion
 //#region src/adapters/dev.ts
 /**

package/dist/{diagnostics-BMfN8mb1.mjs → diagnostics-DZA6KQ_Z.mjs}

@@ -68,8 +68,8 @@ const diagnostics = defineDiagnostics({
 			fix: "Discovery tooling (`devframe connect`) will not see this instance. Check that the registry directory is writable, point `DEVFRAME_INSTANCES_DIR` at a writable directory, or set `DEVFRAME_DISABLE_INSTANCE_REGISTRY=1` to opt out of registration."
 		},
 		DF0046: {
-			why: (p) => `\`devframe connect\` requires the optional peer dependency @modelcontextprotocol/server: ${p.reason}`,
-			fix: "Install it next to devframe (e.g. `npm install @modelcontextprotocol/server`) and run `devframe connect` again."
+			why: (p) => `\`devframe connect\` requires the optional peer dependency @modelcontextprotocol/client: ${p.reason}`,
+			fix: "Install it next to devframe (e.g. `npm install @modelcontextprotocol/client`) and run `devframe connect` again."
 		},
 		DF0047: {
 			why: (p) => `Agent tool "${p.id}" is hidden from the MCP surface: its wire name "${p.name}" collides with the tool "${p.existing}".`,
@@ -173,7 +173,7 @@ const diagnostics = defineDiagnostics({
 		},
 		DF0076: {
 			why: (p) => `\`attach\` / \`handleUpgrade\` drive a raw \`node:http\` upgrade into crossws's Node adapter, which refuses to run on ${p.runtime}.`,
-			fix: "On Bun/Deno, serve the advertised `__ws` route from `Bun.serve` / `Deno.serve` with `attachBunWsTransport` / `attachDenoWsTransport` (see the hub-deno-minimal example), or connect over the SSE endpoint instead."
+			fix: "On Bun/Deno, serve the advertised `__ws` route from `Bun.serve` / `Deno.serve` with `attachBunWsTransport` / `attachDenoWsTransport` (see the hub-deno example), or connect over the SSE endpoint instead."
 		}
 	}
 });

package/dist/{services-install-P_DV7VYL.mjs → host-agent-CKqSTEX9.mjs}

@@ -1,8 +1,5 @@
 import { t as DEVFRAME_EVENTS } from "./events-BV4Dj59a.mjs";
-import { t as diagnostics } from "./diagnostics-BMfN8mb1.mjs";
-import { createRequire } from "node:module";
-import { pathToFileURL } from "node:url";
-import { isAbsolute, join } from "pathe";
+import { t as diagnostics } from "./diagnostics-DZA6KQ_Z.mjs";
 //#region src/utils/events.ts
 /**
 * Create event emitter.
@@ -174,6 +171,12 @@ var DevframeAgentHost = class {
 			resources
 		};
 	}
+	hasSurface() {
+		if (this.tools.size > 0 || this.resources.size > 0) return true;
+		for (const [, def] of this.context.rpc.definitions) if (def.agent) return true;
+		for (const provider of this.providers) if (provider().length > 0) return true;
+		return false;
+	}
 	getTool(id) {
 		const plain = this.tools.get(id);
 		if (plain) return plain.tool;
@@ -271,154 +274,4 @@ function inferSafety(type) {
 	return "action";
 }
 //#endregion
-//#region src/node/services-install.ts
-/**
-* Turn a `resolveFrom` value (a file path, a file URL like `import.meta.url`,
-* or a directory) into something `createRequire` accepts; a directory gets a
-* synthetic filename appended so resolution starts inside it.
-*/
-function toRequireBase(resolveFrom) {
-	if (resolveFrom.startsWith("file://")) return resolveFrom;
-	if ((resolveFrom.split(/[/\\]/).pop() ?? "").includes(".")) return resolveFrom;
-	return join(resolveFrom, "_devframe_resolve.js");
-}
-/**
-* Normalize an `install()` `resolveFrom` into a resolution base. Paths and
-* file URLs pass through (the common case: the declaring plugin's
-* `importMetaUrl`, so a service it declares resolves against the plugin's own
-* dependencies); a bare npm package name resolves to that package's location
-* from `cwd`. An unresolvable package name reads as no base (the caller's
-* workspace fallbacks apply).
-*/
-function expandResolveFrom(resolveFrom, cwd) {
-	if (resolveFrom.startsWith("file://") || resolveFrom.startsWith(".") || isAbsolute(resolveFrom)) return resolveFrom;
-	const require = createRequire(join(cwd, "_devframe_resolve.js"));
-	try {
-		return require.resolve(`${resolveFrom}/package.json`);
-	} catch {}
-	try {
-		return require.resolve(resolveFrom);
-	} catch {}
-}
-/**
-* Import a service package's module, trying each `resolveFrom` candidate in
-* order (so a plugin-declared service resolves against the plugin's own
-* dependency tree first, then the workspace fallback). Throws the last
-* resolution error when no candidate succeeds.
-*/
-async function importServicePackage(pkg, resolveFroms) {
-	const candidates = [...new Set(resolveFroms.filter((x) => typeof x === "string" && x.length > 0))];
-	let lastError = /* @__PURE__ */ new Error(`no resolution base available for "${pkg}"`);
-	for (const from of candidates) {
-		let resolved;
-		try {
-			resolved = createRequire(toRequireBase(from)).resolve(pkg);
-		} catch (error) {
-			lastError = error;
-			continue;
-		}
-		return await import(
-			/* webpackIgnore: true */
-			/* @vite-ignore */
-			/* turbopackIgnore: true */
-			pathToFileURL(resolved).href
-);
-	}
-	throw lastError;
-}
-function parseVersion(input) {
-	const [core, ...prerelease] = input.trim().replace(/^v/, "").split("-");
-	if (!core) return void 0;
-	const parts = core.split(".").map((part) => Number.parseInt(part, 10));
-	if (parts.length === 0 || parts.some((part) => Number.isNaN(part) || part < 0)) return void 0;
-	while (parts.length < 3) parts.push(0);
-	return {
-		parts,
-		...prerelease.length ? { prerelease: prerelease.join("-") } : {}
-	};
-}
-function compareVersions(a, b) {
-	for (let i = 0; i < 3; i++) {
-		const diff = (a.parts[i] ?? 0) - (b.parts[i] ?? 0);
-		if (diff !== 0) return diff;
-	}
-	if (a.prerelease && !b.prerelease) return -1;
-	if (!a.prerelease && b.prerelease) return 1;
-	if (a.prerelease && b.prerelease) return a.prerelease < b.prerelease ? -1 : a.prerelease > b.prerelease ? 1 : 0;
-	return 0;
-}
-/** Whether `version` and `base` share their first `lockUpTo + 1` parts. */
-function partsMatchUpTo(version, base, lockUpTo) {
-	for (let i = 0; i <= lockUpTo; i++) if ((version.parts[i] ?? 0) !== (base.parts[i] ?? 0)) return false;
-	return true;
-}
-function satisfiesCaret(version, base) {
-	if (compareVersions(version, base) < 0) return false;
-	const fixedIndex = base.parts.findIndex((part) => part !== 0);
-	return partsMatchUpTo(version, base, fixedIndex === -1 ? base.parts.length - 1 : fixedIndex);
-}
-function satisfiesTilde(version, base, segments) {
-	if (compareVersions(version, base) < 0) return false;
-	return partsMatchUpTo(version, base, segments.length >= 2 ? 1 : 0);
-}
-function satisfiesExactOrPrefix(version, base, segments) {
-	for (let i = 0; i < Math.max(segments.length, 3); i++) if (i < segments.length && (version.parts[i] ?? 0) !== (base.parts[i] ?? 0)) return false;
-	return segments.length >= 3 ? compareVersions(version, base) === 0 : true;
-}
-function satisfiesComparator(version, comparator) {
-	const raw = comparator.trim();
-	if (!raw || raw === "*" || raw === "x") return true;
-	const operatorMatch = raw.match(/^([\^~]|>=|<=|[><=])?(.+)$/);
-	if (!operatorMatch) return false;
-	const operator = operatorMatch[1];
-	const rest = operatorMatch[2].trim();
-	const segments = rest.replace(/\.[x*]/gi, "").split(".").filter(Boolean);
-	const base = parseVersion(rest.replace(/[x*]/gi, "0"));
-	if (!base) return false;
-	switch (operator) {
-		case ">": return compareVersions(version, base) > 0;
-		case ">=": return compareVersions(version, base) >= 0;
-		case "<": return compareVersions(version, base) < 0;
-		case "<=": return compareVersions(version, base) <= 0;
-		case "^": return satisfiesCaret(version, base);
-		case "~": return satisfiesTilde(version, base, segments);
-		default: return satisfiesExactOrPrefix(version, base, segments);
-	}
-}
-/**
-* Pragmatic semver range check for service version declarations; supports
-* the common forms (`1.2.3`, `^1.2.3`, `~1.2`, `>=1 <3`, `1.x`, `*`, and
-* `||`-joined alternatives) without pulling in a semver dependency. An
-* unparseable version or range reads as **not satisfied**.
-*/
-function satisfiesVersionRange(version, range) {
-	const parsed = parseVersion(version);
-	if (!parsed) return false;
-	const alternatives = range.split("||").map((alt) => alt.trim()).filter(Boolean);
-	if (alternatives.length === 0) return true;
-	return alternatives.some((alternative) => alternative.split(/\s+/).every((comparator) => satisfiesComparator(parsed, comparator)));
-}
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** Deep-merge two values with the service option-set rules (see below). */
-function deepMergeTwo(a, b) {
-	if (Array.isArray(a) && Array.isArray(b)) return [.../* @__PURE__ */ new Set([...a, ...b])];
-	if (isPlainObject(a) && isPlainObject(b)) {
-		const out = { ...a };
-		for (const key of Object.keys(b)) out[key] = key in a ? deepMergeTwo(a[key], b[key]) : b[key];
-		return out;
-	}
-	return b;
-}
-/**
-* Default option-set merge when a service declares no `mergeOptions`:
-* deep-merge in declaration order: objects recurse, arrays union-dedupe,
-* scalars take the later value. Covers the built-in services (`roots` /
-* `langs` union, `themes` per-key last-wins) without a custom hook.
-*/
-function deepMergeOptionSets(sets) {
-	return sets.reduce((merged, set) => deepMergeTwo(merged, set));
-}
-//#endregion
-export { DevframeAgentHost as a, satisfiesVersionRange as i, expandResolveFrom as n, coerceAgentPositionalArgs as o, importServicePackage as r, createEventEmitter as s, deepMergeOptionSets as t };
+export { coerceAgentPositionalArgs as n, createEventEmitter as r, DevframeAgentHost as t };

package/dist/in-page-channel/index.d.mts

@@ -1,5 +1,5 @@
 import { D as InferArgsType, E as Thenable, O as InferReturnType, T as RpcReturnSchema, i as RpcArgsSchema } from "../types-Dq4i156u.mjs";
-import { Bt as EventEmitter, k as SharedState } from "../context-4AIVRLYF.mjs";
+import { Vt as EventEmitter, k as SharedState } from "../context-CHW4BZOj.mjs";
 import { BirpcReturn } from "birpc";
 //#region src/in-page-channel/types.d.ts
 /**

package/dist/{index-pKl67H6w.d.mts → index-CNC390b_.d.mts}

@@ -1,5 +1,5 @@
-import { k as SharedState, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "./context-4AIVRLYF.mjs";
-import { n as InternalAnonymousAuthStorage } from "./context-rgBSPFHS.mjs";
+import { k as SharedState, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "./context-CHW4BZOj.mjs";
+import { n as InternalAnonymousAuthStorage } from "./context-BJiKJqyW.mjs";
 //#region src/node/auth/revoke.d.ts
 /**
  * Flip `isTrusted` to false on any live WS clients connected with `token`

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import "./index-pIVt92jP.mjs";
 import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-Dq4i156u.mjs";
 import { c as DevframeNodeRpcSessionMeta, d as DevframeRpcTransportKind, l as DevframeRpcConnection, u as DevframeRpcConnectionRequest } from "./ws-server-D2nv68Hg.mjs";
-import { $ as DevframeServiceScopeOf, At as AgentManifest, B as DevframeSetupInfo, Bt as EventEmitter, Ct as DevframeDiagnosticsLogger, F as DevframeDefinition, Ft as AgentToolInput, G as McpAuthorization, H as DevframeSnapshotRpcInputs, Ht as EventsMap, I as DevframeDeploymentKind, It as AgentToolProvider, J as DevframeServiceDescriptor, K as McpRouteOptions, L as DevframeDockDefaults, Lt as AgentToolProviderHandle, Mt as AgentResourceContent, Nt as AgentResourceInput, P as DevframeCliOptions, Pt as AgentTool, Q as DevframeServiceOf, R as DevframeDuplicationStrategy, Rt as DevframeAgentHost, St as DevframeDiagnosticsHost, U as DevframeSseOptions, V as DevframeSnapshotRpcEntry, Vt as EventUnsubscribe, W as DevframeWsOptions, X as DevframeServiceInput, Y as DevframeServiceId, Z as DevframeServiceMeta, _t as DevframeRpcClientFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeScopedNodeRpc, bt as DevframeHost, c as RpcBroadcastOptions, ct as DevframeSettingsRegistry, d as RpcSharedStateHost, dt as ScopedClientFunctions, et as DevframeServicesHost, f as RpcStreamingChannel, ft as ScopedRpcFn, gt as DevframeViewHost, ht as SettingsForNamespace, i as DevframeCapabilities, it as DevframeScopedNodeContext, jt as AgentResource, kt as AgentHandle, l as RpcFunctionsHost, lt as DevframeSettingsStore, m as RpcStreamingHost, mt as ScopedSharedStates, n as ConnectionMetaSse, nt as DevframeServicesScopeRegistry, o as DevframeNodeContext, ot as DevframeScopedStreamingHost, p as RpcStreamingChannelOptions, pt as ScopedServerFunctions, q as DevframeServiceDefinition, r as ConnectionMetaWebsocket, rt as DevframeServicesState, s as DevframeNodeRpcSession, st as DevframeSettings, t as ConnectionMeta, tt as DevframeServicesRegistry, u as RpcSharedStateGetOptions, ut as ScopedBroadcastOptions, vt as DevframeRpcServerFunctions, xt as DevframeStorageScope, yt as DevframeRpcSharedStates, z as DevframeRpcOptions, zt as DevframeAgentHostEvents } from "./context-4AIVRLYF.mjs";
+import { $ as DevframeServiceOf, At as AgentHandle, B as DevframeSetupInfo, Bt as DevframeAgentHostEvents, Ct as DevframeDiagnosticsHost, F as DevframeDefinition, Ft as AgentTool, G as McpAuthorization, H as DevframeSnapshotRpcInputs, Ht as EventUnsubscribe, I as DevframeDeploymentKind, It as AgentToolInput, J as DevframeServiceDefinition, K as McpRouteOptions, L as DevframeDockDefaults, Lt as AgentToolProvider, Mt as AgentResource, Nt as AgentResourceContent, P as DevframeCliOptions, Pt as AgentResourceInput, Q as DevframeServiceMeta, R as DevframeDuplicationStrategy, Rt as AgentToolProviderHandle, St as DevframeStorageScope, U as DevframeSseOptions, Ut as EventsMap, V as DevframeSnapshotRpcEntry, Vt as EventEmitter, W as DevframeWsOptions, X as DevframeServiceId, Y as DevframeServiceDescriptor, Z as DevframeServiceInput, _t as DevframeViewHost, a as DevframeConnectionConfigsRegistry, at as DevframeScopedNodeContext, bt as DevframeRpcSharedStates, c as RpcBroadcastOptions, ct as DevframeSettings, d as RpcSharedStateHost, dt as ScopedBroadcastOptions, et as DevframeServiceScopeOf, f as RpcStreamingChannel, ft as ScopedClientFunctions, gt as SettingsForNamespace, ht as ScopedSharedStates, i as DevframeCapabilities, it as DevframeServicesState, jt as AgentManifest, l as RpcFunctionsHost, lt as DevframeSettingsRegistry, m as RpcStreamingHost, mt as ScopedServerFunctions, n as ConnectionMetaSse, nt as DevframeServicesRegistry, o as DevframeNodeContext, ot as DevframeScopedNodeRpc, p as RpcStreamingChannelOptions, pt as ScopedRpcFn, q as McpSetting, r as ConnectionMetaWebsocket, rt as DevframeServicesScopeRegistry, s as DevframeNodeRpcSession, st as DevframeScopedStreamingHost, t as ConnectionMeta, tt as DevframeServicesHost, u as RpcSharedStateGetOptions, ut as DevframeSettingsStore, vt as DevframeRpcClientFunctions, wt as DevframeDiagnosticsLogger, xt as DevframeHost, yt as DevframeRpcServerFunctions, z as DevframeRpcOptions, zt as DevframeAgentHost } from "./context-CHW4BZOj.mjs";
 import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "./remote-assets-eBvSKZMS.mjs";
 import { i as DevframeDefineDiagnosticsOptions } from "./nostics-0sKe5HIj.mjs";
 //#region src/define.d.ts
@@ -18,4 +18,4 @@ declare function defineDevframe(d: DevframeDefinition): DevframeDefinition;
  */
 declare function resolveClientAssets(d: DevframeDefinition): StaticAssetsSource | undefined;
 //#endregion
-export { type AgentHandle, type AgentManifest, type AgentResource, type AgentResourceContent, type AgentResourceInput, type AgentTool, type AgentToolInput, type AgentToolProvider, type AgentToolProviderHandle, type ConnectionMeta, type ConnectionMetaSse, type ConnectionMetaWebsocket, type DevframeAgentHost, type DevframeAgentHostEvents, type DevframeCapabilities, type DevframeCliOptions, type DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcOptions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceDefinition, type DevframeServiceDescriptor, type DevframeServiceId, type DevframeServiceInput, type DevframeServiceMeta, type DevframeServiceOf, type DevframeServiceScopeOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeServicesScopeRegistry, type DevframeServicesState, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSnapshotRpcEntry, type DevframeSnapshotRpcInputs, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpAuthorization, type McpRouteOptions, type RemoteAssets, type RemoteAssetsErrorMessage, type RemoteAssetsProvider, type RemoteAssetsProviderCustom, type RemoteAssetsStore, type RpcBroadcastOptions, type RpcFunctionAgentOptions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type ScopedBroadcastOptions, type ScopedClientFunctions, type ScopedRpcFn, type ScopedServerFunctions, type ScopedSharedStates, type SettingsForNamespace, type StaticAssetsSource, defineDevframe, defineRpcFunction, resolveClientAssets };
+export { type AgentHandle, type AgentManifest, type AgentResource, type AgentResourceContent, type AgentResourceInput, type AgentTool, type AgentToolInput, type AgentToolProvider, type AgentToolProviderHandle, type ConnectionMeta, type ConnectionMetaSse, type ConnectionMetaWebsocket, type DevframeAgentHost, type DevframeAgentHostEvents, type DevframeCapabilities, type DevframeCliOptions, type DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcOptions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceDefinition, type DevframeServiceDescriptor, type DevframeServiceId, type DevframeServiceInput, type DevframeServiceMeta, type DevframeServiceOf, type DevframeServiceScopeOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeServicesScopeRegistry, type DevframeServicesState, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSnapshotRpcEntry, type DevframeSnapshotRpcInputs, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpAuthorization, type McpRouteOptions, type McpSetting, type RemoteAssets, type RemoteAssetsErrorMessage, type RemoteAssetsProvider, type RemoteAssetsProviderCustom, type RemoteAssetsStore, type RpcBroadcastOptions, type RpcFunctionAgentOptions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type ScopedBroadcastOptions, type ScopedClientFunctions, type ScopedRpcFn, type ScopedServerFunctions, type ScopedSharedStates, type SettingsForNamespace, type StaticAssetsSource, defineDevframe, defineRpcFunction, resolveClientAssets };

package/dist/{instance-registry-C7-41RSp.mjs → instance-registry-DCq762YJ.mjs}

@@ -1,7 +1,7 @@
 import { n as __exportAll } from "./rolldown-runtime-B4iAMlE-.mjs";
-import { t as diagnostics } from "./diagnostics-BMfN8mb1.mjs";
-import process from "node:process";
+import { t as diagnostics } from "./diagnostics-DZA6KQ_Z.mjs";
 import { join } from "pathe";
+import process from "node:process";
 import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 //#region src/node/instance-registry.ts

package/dist/{instance-shell-7Z52PE4_.d.mts → instance-shell-DZipaP9k.d.mts}

@@ -1,6 +1,6 @@
 import { c as DevframeNodeRpcSessionMeta, l as DevframeRpcConnection, n as WsOriginRegistry } from "./ws-server-D2nv68Hg.mjs";
-import { U as DevframeSseOptions, W as DevframeWsOptions, _t as DevframeRpcClientFunctions, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta, vt as DevframeRpcServerFunctions, wt as DevframeAuthHandler } from "./context-4AIVRLYF.mjs";
-import "./index-pKl67H6w.mjs";
+import { Tt as DevframeAuthHandler, U as DevframeSseOptions, W as DevframeWsOptions, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta, vt as DevframeRpcClientFunctions, yt as DevframeRpcServerFunctions } from "./context-CHW4BZOj.mjs";
+import "./index-CNC390b_.mjs";
 import { BirpcGroup } from "birpc";
 import { NodeAdapter } from "crossws/adapters/node";
 import { Buffer } from "node:buffer";

package/dist/{instance-shell-cdVETpfz.mjs → instance-shell-DvYCwrDy.mjs}

@@ -1,26 +1,13 @@
 import "./constants.mjs";
 import { r as validateOriginCandidate } from "./origin-DZit9g29.mjs";
-import { t as diagnostics } from "./diagnostics-BMfN8mb1.mjs";
-import { r as importServicePackage } from "./services-install-P_DV7VYL.mjs";
-import { t as getInternalContext } from "./context-DIUvJW4D.mjs";
+import { t as diagnostics } from "./diagnostics-DZA6KQ_Z.mjs";
+import { t as getInternalContext } from "./context-jXO5vzjH.mjs";
 import { createInteractiveAuth } from "./recipes/interactive-auth.mjs";
 import { createServer } from "node:http";
 import process from "node:process";
 import { isIP } from "node:net";
 import { joinURL, withLeadingSlash, withoutLeadingSlash, withoutTrailingSlash } from "ufo";
 import { H3, defineHandler, toNodeHandler } from "h3";
-//#region src/node/import-runtime-module.ts
-/**
-* Resolve and import a package at runtime without adding it to a consumer's
-* bundle graph. First-party adapters use this for optional peers whose code
-* is needed only when the matching feature is enabled.
-*
-* @internal
-*/
-async function importRuntimeModule(specifier) {
-	return await importServicePackage(specifier, [import.meta.url]);
-}
-//#endregion
 //#region src/node/runtime.ts
 /**
 * Detect the current server runtime from its runtime-specific global. The
@@ -330,7 +317,7 @@ function createInstanceShell(options) {
 		const origin = currentOrigin();
 		if (!cfg || registerPromise || !origin || !meta) return;
 		const resolvedMeta = meta;
-		registerPromise = import("./instance-registry-C7-41RSp.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
+		registerPromise = import("./instance-registry-DCq762YJ.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
 			let port = 0;
 			try {
 				const url = new URL(origin);
@@ -402,7 +389,7 @@ function createInstanceShell(options) {
 	let resolvedAuth = false;
 	let corePromise;
 	function ensureCore() {
-		corePromise ??= import("./rpc-core-DVQ7xi89.mjs").then((n) => n.n).then(({ createContextRpcServer }) => createContextRpcServer({
+		corePromise ??= import("./rpc-core-CvkU23bQ.mjs").then((n) => n.n).then(({ createContextRpcServer }) => createContextRpcServer({
 			context: ctx,
 			auth: resolvedAuth,
 			onPeerConnect: options.onPeerConnect,
@@ -665,4 +652,4 @@ function createInstanceShell(options) {
 	};
 }
 //#endregion
-export { importRuntimeModule as a, normalizeHttpServerUrl as i, resolveInstanceRegister as n, samePath as r, createInstanceShell as t };
+export { normalizeHttpServerUrl as i, resolveInstanceRegister as n, samePath as r, createInstanceShell as t };

package/dist/internal/index.d.mts

@@ -1,9 +1,9 @@
 import { v as RpcFunctionDefinitionAny } from "../types-Dq4i156u.mjs";
-import { At as AgentManifest, Bt as EventEmitter, F as DevframeDefinition, Ft as AgentToolInput, It as AgentToolProvider, Lt as AgentToolProviderHandle, Mt as AgentResourceContent, Nt as AgentResourceInput, Pt as AgentTool, Rt as DevframeAgentHost$1, bt as DevframeHost, jt as AgentResource, kt as AgentHandle, o as DevframeNodeContext, zt as DevframeAgentHostEvents } from "../context-4AIVRLYF.mjs";
+import { At as AgentHandle, Bt as DevframeAgentHostEvents, F as DevframeDefinition, Ft as AgentTool, It as AgentToolInput, Lt as AgentToolProvider, Mt as AgentResource, Nt as AgentResourceContent, Pt as AgentResourceInput, Rt as AgentToolProviderHandle, Vt as EventEmitter, jt as AgentManifest, o as DevframeNodeContext, xt as DevframeHost, zt as DevframeAgentHost$1 } from "../context-CHW4BZOj.mjs";
 import { a as RemoteAssetsStore, o as StaticAssetsSource } from "../remote-assets-eBvSKZMS.mjs";
-import { a as InstanceShellInit, c as StartedServer, d as samePath, f as DevframeInstanceRecord, h as registerDevframeInstance, i as InstanceShellApi, l as createInstanceShell, m as listLiveDevframeInstances, n as InstanceRegisterConfig, o as InstanceShellInternals, p as DevframeInstanceRegistration, r as InstanceShell, s as InstanceWsTier, t as CreateInstanceShellOptions, u as resolveInstanceRegister } from "../instance-shell-7Z52PE4_.mjs";
-import { i as resolveBasePath, n as ResolvedMcpConfig, o as resolveMcpConfig, r as normalizeBasePath } from "../_shared-CK3czkH4.mjs";
-import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-Ceu6AUz8.mjs";
+import { a as InstanceShellInit, c as StartedServer, d as samePath, f as DevframeInstanceRecord, h as registerDevframeInstance, i as InstanceShellApi, l as createInstanceShell, m as listLiveDevframeInstances, n as InstanceRegisterConfig, o as InstanceShellInternals, p as DevframeInstanceRegistration, r as InstanceShell, s as InstanceWsTier, t as CreateInstanceShellOptions, u as resolveInstanceRegister } from "../instance-shell-DZipaP9k.mjs";
+import { a as resolveBasePath, i as normalizeBasePath, n as ResolvedMcpConfig, r as loadAutoMcpAdapter, s as resolveMcpConfig } from "../_shared-CCzf9Hub.mjs";
+import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-DsyDViQy.mjs";
 //#region src/client-assets.d.ts
 /**
  * Resolve a definition's client assets source: the built SPA served as its
@@ -175,7 +175,7 @@ declare const diagnostics: import("nostics").Diagnostics<{
     readonly why: (p: {
       reason: string;
     }) => string;
-    readonly fix: "Install it next to devframe (e.g. `npm install @modelcontextprotocol/server`) and run `devframe connect` again.";
+    readonly fix: "Install it next to devframe (e.g. `npm install @modelcontextprotocol/client`) and run `devframe connect` again.";
   };
   readonly DF0047: {
     readonly why: (p: {
@@ -350,7 +350,7 @@ declare const diagnostics: import("nostics").Diagnostics<{
     readonly why: (p: {
       runtime: string;
     }) => string;
-    readonly fix: "On Bun/Deno, serve the advertised `__ws` route from `Bun.serve` / `Deno.serve` with `attachBunWsTransport` / `attachDenoWsTransport` (see the hub-deno-minimal example), or connect over the SSE endpoint instead.";
+    readonly fix: "On Bun/Deno, serve the advertised `__ws` route from `Bun.serve` / `Deno.serve` with `attachBunWsTransport` / `attachDenoWsTransport` (see the hub-deno example), or connect over the SSE endpoint instead.";
   };
 }, readonly [(d: import("nostics").Diagnostic, { method }?: {
   method?: "log" | "warn" | "error";
@@ -377,6 +377,7 @@ declare class DevframeAgentHost implements DevframeAgentHost$1 {
   registerResource(input: AgentResourceInput): AgentHandle;
   unregisterResource(id: string): boolean;
   list(): AgentManifest;
+  hasSurface(): boolean;
   getTool(id: string): AgentTool | undefined;
   getResource(id: string): AgentResource | undefined;
   invoke(id: string, args: unknown): Promise<unknown>;
@@ -431,8 +432,9 @@ declare function createH3DevframeHost(options: CreateH3DevframeHostOptions): Dev
 //#region src/node/import-runtime-module.d.ts
 /**
  * Resolve and import a package at runtime without adding it to a consumer's
- * bundle graph. First-party adapters use this for optional peers whose code
- * is needed only when the matching feature is enabled.
+ * bundle graph. First-party adapters use this for modules whose code is
+ * needed only when the matching feature is enabled (optional peers, and the
+ * MCP adapter with the SDK behind it).
  *
  * @internal
  */
@@ -476,4 +478,4 @@ declare function peekRpcWireFrame(raw: string): {
   i?: string;
 };
 //#endregion
-export { type AgentArgsFallback, type ContextRpcServer, type CreateContextRpcServerOptions, CreateH3DevframeHostOptions, type CreateInstanceShellOptions, DevframeAgentHost, type DevframeInstanceRecord, type DevframeInstanceRegistration, type InstanceRegisterConfig, type InstanceShell, type InstanceShellApi, type InstanceShellInit, type InstanceShellInternals, type InstanceWsTier, type ResolvedMcpConfig, type RpcWireCodec, type StartedServer, coerceAgentPositionalArgs, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, diagnostics, importRuntimeModule, listLiveDevframeInstances, normalizeBasePath, normalizeHttpServerUrl, peekRpcWireFrame, registerDevframeInstance, resolveBasePath, resolveClientAssets, resolveInstanceRegister, resolveMcpConfig, samePath };
+export { type AgentArgsFallback, type ContextRpcServer, type CreateContextRpcServerOptions, CreateH3DevframeHostOptions, type CreateInstanceShellOptions, DevframeAgentHost, type DevframeInstanceRecord, type DevframeInstanceRegistration, type InstanceRegisterConfig, type InstanceShell, type InstanceShellApi, type InstanceShellInit, type InstanceShellInternals, type InstanceWsTier, type ResolvedMcpConfig, type RpcWireCodec, type StartedServer, coerceAgentPositionalArgs, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, diagnostics, importRuntimeModule, listLiveDevframeInstances, loadAutoMcpAdapter, normalizeBasePath, normalizeHttpServerUrl, peekRpcWireFrame, registerDevframeInstance, resolveBasePath, resolveClientAssets, resolveInstanceRegister, resolveMcpConfig, samePath };