devframe 0.9.9 → 0.9.11

package/dist/{context-CwPUinjn.mjs → context-Bq27SDK-.mjs}

@@ -1,16 +1,17 @@
 import { i as defineDiagnostics } from "./nostics-D0PvLZsn.mjs";
-import { t as diagnostics } from "./diagnostics-D0EVm5M6.mjs";
+import { r as diagnostics } from "./serialization-DFg5sUt6.mjs";
 import { RpcFunctionsCollectorBase } from "./rpc/index.mjs";
 import { defineRpcFunction } from "./index.mjs";
 import { t as DEVFRAME_EVENTS } from "./events-BV4Dj59a.mjs";
 import { DEVFRAME_SERVICES_STATE_KEY } from "./constants.mjs";
-import { t as diagnostics$1 } from "./diagnostics-BMfN8mb1.mjs";
-import { a as DevframeAgentHost, i as satisfiesVersionRange, n as expandResolveFrom, r as importServicePackage, s as createEventEmitter, t as deepMergeOptionSets } from "./services-install-P_DV7VYL.mjs";
-import { n as createDebug, t as resolveStaticAssetsSource } from "./remote-assets-BIFWOlBW.mjs";
-import { t as createStorage } from "./storage-Dccf_IyD.mjs";
+import { t as diagnostics$1 } from "./diagnostics-DZA6KQ_Z.mjs";
+import { r as createEventEmitter, t as DevframeAgentHost } from "./host-agent-CKqSTEX9.mjs";
+import { n as createDebug, t as resolveStaticAssetsSource } from "./remote-assets-DMFzLSoH.mjs";
+import { i as satisfiesVersionRange, n as expandResolveFrom, r as importServicePackage, t as deepMergeOptionSets } from "./services-install-Ben4yh52.mjs";
+import { t as createStorage } from "./storage-B70AXK64.mjs";
+import { join } from "pathe";
 import { createSharedState } from "devframe/utils/shared-state";
 import process from "node:process";
-import { join } from "pathe";
 import { existsSync } from "node:fs";
 //#region src/node/host-diagnostics.ts
 var DevframeDiagnosticsHost = class {
@@ -129,9 +130,14 @@ function createRpcSharedStateServerHost(rpc) {
 		},
 		/**
 		* Pre-compute snapshots for the build-mode static dump so the SPA
-		* can read them without a live server.
+		* can read them without a live server. The `undefined` fallback makes
+		* a key the build never created resolve like the live handler does
+		* (returning `undefined`) instead of failing the dump lookup.
 		*/
-		dump: () => ({ inputs: host.keys().map((key) => [key]) })
+		dump: () => ({
+			inputs: host.keys().map((key) => [key]),
+			fallback: void 0
+		})
 	});
 	rpc.register({
 		name: "devframe:rpc:server-state:set",
@@ -777,6 +783,17 @@ var RpcFunctionsHostImpl = class extends RpcFunctionsCollectorBase {
 //#endregion
 //#region src/node/host-services.ts
 const debug = createDebug("devframe:services");
+/**
+* Per-RPC-host registry of the services already installed against it, keyed
+* by the RPC host object. A single wire service can be declared from more
+* than one devframe context that shares one RPC host (e.g. a kit that mounts
+* a definition alongside another context, so both iterate `def.services`).
+* The per-instance `installed` guard can't see across those sibling hosts, so
+* the second context would re-run the service factory and re-register its RPC,
+* hitting DF0021. Sharing the registry by RPC host makes the first install win
+* across every context on that host.
+*/
+const installedByRpcHost = /* @__PURE__ */ new WeakMap();
 function isServiceDefinition(input) {
 	return typeof input.setup === "function";
 }
@@ -825,11 +842,27 @@ var DevframeServicesHostImpl = class {
 	services = /* @__PURE__ */ new Map();
 	listeners = /* @__PURE__ */ new Map();
 	pending = /* @__PURE__ */ new Map();
-	installed = /* @__PURE__ */ new Map();
+	localInstalled = /* @__PURE__ */ new Map();
 	readyPromise;
 	constructor(context) {
 		this.context = context;
 	}
+	/**
+	* The install-dedup registry, shared across every services host that shares
+	* this host's RPC host so the first install of a package wins across sibling
+	* contexts. Falls back to a per-instance map when there is no RPC host (a
+	* context-less host only exercises the in-process `provide`/`get` tier).
+	*/
+	get installed() {
+		const rpc = this.context?.rpc;
+		if (!rpc) return this.localInstalled;
+		let registry = installedByRpcHost.get(rpc);
+		if (!registry) {
+			registry = /* @__PURE__ */ new Map();
+			installedByRpcHost.set(rpc, registry);
+		}
+		return registry;
+	}
 	provide(id, service) {
 		const key = id;
 		if (this.services.has(key)) throw diagnostics$1.DF0037({ id: key });
@@ -907,8 +940,10 @@ var DevframeServicesHostImpl = class {
 	}
 	async installPackage(pkg, entries) {
 		if (this.installed.has(pkg)) {
-			diagnostics$1.DF0066({ package: pkg });
-			return this.installed.get(pkg);
+			const api = this.installed.get(pkg);
+			if (this.services.has(pkg)) diagnostics$1.DF0066({ package: pkg });
+			else this.provide(pkg, api);
+			return api;
 		}
 		let def = entries.filter((entry) => isServiceDefinition(entry.input))[0]?.input;
 		if (!def) {
@@ -924,7 +959,7 @@ var DevframeServicesHostImpl = class {
 		debug("installing service %s@%s (scope %s)", def.package, def.version, def.scope);
 		const scoped = this.context.scope(def.scope);
 		const api = await def.setup(scoped, options === void 0 ? {} : { options });
-		this.installed.set(def.package, api);
+		this.installed.set(pkg, api);
 		this.provide(def.package, api);
 		await this.advertise(def);
 		return api;
@@ -1024,7 +1059,8 @@ var DevframeViewHost = class {
 		if (typeof resolved === "string" && !existsSync(resolved)) throw diagnostics$1.DF0008({ distDir: resolved });
 		this.buildStaticDirs.push({
 			baseUrl,
-			source
+			source,
+			resolveFrom: defaultResolveFrom
 		});
 		this.context.host.mountStatic(baseUrl, resolved);
 	}

package/dist/{context-rgBSPFHS.d.mts → context-_temOGDB.d.mts}

@@ -1,4 +1,4 @@
-import { k as SharedState, o as DevframeNodeContext } from "./context-4AIVRLYF.mjs";
+import { k as SharedState, o as DevframeNodeContext } from "./context-BBWPLDHh.mjs";
 //#region src/node/hub-internals/context.d.ts
 interface InternalAnonymousAuthStorage {
   trusted: Record<string, {

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-B32EVw5w.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-Bq27SDK-.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-BBWPLDHh.mjs";
 import { BirpcReturn } from "birpc";
 //#region src/in-page-channel/types.d.ts
 /**

package/dist/{index-pKl67H6w.d.mts → index-1ezCLThh.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-BBWPLDHh.mjs";
+import { n as InternalAnonymousAuthStorage } from "./context-_temOGDB.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-BBWPLDHh.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-BWh0JQuo.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-BBWPLDHh.mjs";
+import "./index-1ezCLThh.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-BBWPLDHh.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-BWh0JQuo.mjs";
+import { a as resolveBasePath, i as normalizeBasePath, n as ResolvedMcpConfig, r as loadAutoMcpAdapter, s as resolveMcpConfig } from "../_shared-DEAMiPfH.mjs";
+import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-DiCr5etS.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 };