devframe 0.9.0-beta.1 → 0.9.0-beta.10

package/dist/{index-CZRd2K1C.d.mts → index-CB-fSUyn.d.mts}

@@ -1,5 +1,5 @@
-import { G as DevframeNodeRpcSession, gt as SharedState, x as DevframeNodeContext } from "./devframe-Bdd9YXTy.mjs";
-import { n as InternalAnonymousAuthStorage } from "./context-CSCwoABx.mjs";
+import { R as DevframeNodeRpcSession, g as DevframeNodeContext, lt as SharedState } from "./devframe-DJMg0WLe.mjs";
+import { n as InternalAnonymousAuthStorage } from "./context-B3YUu_95.mjs";
 //#region src/node/auth/revoke.d.ts
 /**
  * Flip `isTrusted` to false on any live WS clients connected with `token`

package/dist/{index-DSCq4M4q.d.mts → index-tdrk1bzV.d.mts}

@@ -1,4 +1,4 @@
-import { C as RpcFunctionType, S as RpcFunctionSetupResult, T as RpcReturnSchema, _ as RpcFunctionDefinition, i as RpcArgsSchema, v as RpcFunctionDefinitionAny, w as RpcFunctionsCollector } from "./types-CnJSgRVa.mjs";
+import { C as RpcFunctionType, S as RpcFunctionSetupResult, T as RpcReturnSchema, _ as RpcFunctionDefinition, i as RpcArgsSchema, v as RpcFunctionDefinitionAny, w as RpcFunctionsCollector } from "./types-Djq7CBXh.mjs";
 //#region src/rpc/cache.d.ts
 interface RpcCacheOptions {
   functions: string[];

package/dist/index.d.mts

@@ -1,7 +1,9 @@
-import { $ as DevframeRpcClientFunctions, A as DevframeSettingsRegistry, At as DevframeAgentHost, B as DevframeStorageScope, C as DevframeServiceOf, Ct as AgentResource, D as DevframeScopedNodeRpc, Dt as AgentToolInput, E as DevframeScopedNodeContext, Et as AgentTool, F as ScopedServerFunctions, G as DevframeNodeRpcSession, H as DevframeDiagnosticsDefinition, I as ScopedSharedStates, J as RpcSharedStateGetOptions, K as RpcBroadcastOptions, L as SettingsForNamespace, M as ScopedBroadcastOptions, Mt as EventEmitter, N as ScopedClientFunctions, Nt as EventUnsubscribe, O as DevframeScopedStreamingHost, Ot as AgentToolProvider, P as ScopedRpcFn, Pt as EventsMap, Q as RpcStreamingHost, R as DevframeViewHost, S as DevframeServiceId, St as AgentManifest, T as DevframeServicesRegistry, Tt as AgentResourceInput, U as DevframeDiagnosticsHost, V as DevframeDefineDiagnosticsOptions, W as DevframeDiagnosticsLogger, X as RpcStreamingChannel, Y as RpcSharedStateHost, Z as RpcStreamingChannelOptions, _ as ConnectionMeta, a as DevframeDockDefaults, b as DevframeCapabilities, c as DevframeSetupInfo, d as DevframeWsOptions, et as DevframeRpcServerFunctions, f as McpRouteOptions, g as Thenable, h as PartialWithoutId, i as DevframeDeploymentKind, j as DevframeSettingsStore, jt as DevframeAgentHostEvents, k as DevframeSettings, kt as AgentToolProviderHandle, l as DevframeSpaOptions, m as EntriesToObject, n as DevframeCliOptions, o as DevframeDuplicationStrategy, q as RpcFunctionsHost, r as DevframeDefinition, s as DevframeRuntime, t as DevframeBrowserContext, tt as DevframeRpcSharedStates, u as DevframeSseOptions, v as ConnectionMetaSse, w as DevframeServicesHost, wt as AgentResourceContent, x as DevframeNodeContext, xt as AgentHandle, y as ConnectionMetaWebsocket, z as DevframeHost } from "./devframe-Bdd9YXTy.mjs";
-import "./index-DSCq4M4q.mjs";
-import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-CnJSgRVa.mjs";
-import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "./ws-server-Ces08fjP.mjs";
+import { A as ScopedServerFunctions, B as RpcFunctionsHost, C as DevframeScopedStreamingHost, Ct as DevframeAgentHost, D as ScopedBroadcastOptions, Dt as EventsMap, E as DevframeSettingsStore, Et as EventUnsubscribe, F as DevframeStorageScope, G as RpcStreamingHost, H as RpcSharedStateHost, I as DevframeDiagnosticsHost, J as DevframeRpcSharedStates, K as DevframeRpcClientFunctions, L as DevframeDiagnosticsLogger, M as SettingsForNamespace, N as DevframeViewHost, O as ScopedClientFunctions, P as DevframeHost, R as DevframeNodeRpcSession, S as DevframeScopedNodeRpc, St as AgentToolProviderHandle, T as DevframeSettingsRegistry, Tt as EventEmitter, U as RpcStreamingChannel, V as RpcSharedStateGetOptions, W as RpcStreamingChannelOptions, _ as DevframeServiceId, _t as AgentResourceContent, a as DevframeDuplicationStrategy, b as DevframeServicesRegistry, bt as AgentToolInput, c as DevframeWsOptions, d as ConnectionMeta, f as ConnectionMetaSse, g as DevframeNodeContext, gt as AgentResource, h as DevframeConnectionConfigsRegistry, ht as AgentManifest, i as DevframeDockDefaults, j as ScopedSharedStates, k as ScopedRpcFn, l as McpRouteOptions, m as DevframeCapabilities, mt as AgentHandle, n as DevframeDefinition, o as DevframeSetupInfo, p as ConnectionMetaWebsocket, q as DevframeRpcServerFunctions, r as DevframeDeploymentKind, s as DevframeSseOptions, t as DevframeCliOptions, v as DevframeServiceOf, vt as AgentResourceInput, w as DevframeSettings, wt as DevframeAgentHostEvents, x as DevframeScopedNodeContext, xt as AgentToolProvider, y as DevframeServicesHost, yt as AgentTool, z as RpcBroadcastOptions } from "./devframe-DJMg0WLe.mjs";
+import "./index-tdrk1bzV.mjs";
+import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-Djq7CBXh.mjs";
+import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "./ws-server-D1d3QM9f.mjs";
+import { i as DevframeDefineDiagnosticsOptions } from "./nostics-SPGDgHEP.mjs";
+import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "./remote-assets-Bg4gCUZ_.mjs";
 //#region src/define.d.ts
 declare const defineRpcFunction: <NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeNodeContext>) => RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeNodeContext>;
 /**
@@ -10,4 +12,4 @@ declare const defineRpcFunction: <NAME extends string, TYPE extends RpcFunctionT
  */
 declare function defineDevframe(d: DevframeDefinition): DevframeDefinition;
 //#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 DevframeBrowserContext, type DevframeCapabilities, type DevframeCliOptions, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeRuntime, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceId, type DevframeServiceOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSpaOptions, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpRouteOptions, type PartialWithoutId, 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 Thenable, defineDevframe, defineRpcFunction };
+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 DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceId, type DevframeServiceOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EventEmitter, type EventUnsubscribe, type EventsMap, 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 };

package/dist/{instance-registry-BQqGoDO9.mjs → instance-registry-WvQkt42E.mjs}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-JspESFgx.mjs";
-import { t as diagnostics } from "./diagnostics-DLYH5oD3.mjs";
+import { t as diagnostics } from "./diagnostics-DOQPnQmX.mjs";
 import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "pathe";
 import process from "node:process";
@@ -42,8 +42,6 @@ function isRegistryDisabled() {
 * crash are pruned by readers whose liveness probe fails. Registration never
 * throws — a write failure degrades to a coded warning (`DF0045`), since a
 * dev server must not die over discovery metadata.
-*
-* @experimental
 */
 function registerDevframeInstance(record, options = {}) {
 	const dir = resolveInstancesDir(options.instancesDir);
@@ -78,8 +76,6 @@ function registerDevframeInstance(record, options = {}) {
 /**
 * Read every record in the registry directory, dropping unparseable files.
 * Liveness is the caller's concern — see {@link probeDevframeInstance}.
-*
-* @experimental
 */
 function readDevframeInstances(options = {}) {
 	const dir = resolveInstancesDir(options.instancesDir);
@@ -155,8 +151,6 @@ async function probeDevframeInstance(record, options = {}) {
 * records left behind by killed processes shadow the server currently bound
 * there: per `(port, basePath)` only the newest record survives, older
 * ghosts are pruned with the dead.
-*
-* @experimental
 */
 async function listLiveDevframeInstances(options = {}) {
 	const dir = resolveInstancesDir(options.instancesDir);

package/dist/{instance-shell-KRdee1QF.mjs → instance-shell-CMFyszWJ.mjs}

@@ -1,6 +1,6 @@
 import "./constants.mjs";
-import { t as diagnostics } from "./diagnostics-DLYH5oD3.mjs";
-import { t as getInternalContext } from "./context-C33rR7n0.mjs";
+import { t as diagnostics } from "./diagnostics-DOQPnQmX.mjs";
+import { t as getInternalContext } from "./context-xdynGSLP.mjs";
 import { createInteractiveAuth } from "./recipes/interactive-auth.mjs";
 import { createServer } from "node:http";
 import process from "node:process";
@@ -83,7 +83,7 @@ async function bindHttpAndWs(options) {
 	const origin = normalizeHttpServerUrl(bindHost, resolvedPort);
 	const internal = getInternalContext(context);
 	const wsUrl = `ws://${formatHostForUrl(bindHost)}:${resolvedPort}${options.path ?? ""}`;
-	if (websocket) internal.wsEndpoint = { url: wsUrl };
+	if (websocket) internal.setWsEndpoint({ url: wsUrl });
 	function connectionMeta() {
 		const jsonSerializableMethods = [];
 		for (const def of rpcHost.definitions.values()) if (def.jsonSerializable === true) jsonSerializableMethods.push(def.name);
@@ -103,7 +103,7 @@ async function bindHttpAndWs(options) {
 		async close() {
 			await closeWs();
 			if (ownsHttpServer) await new Promise((r) => httpServer.close(() => r()));
-			if (websocket && getInternalContext(context).wsEndpoint?.url === wsUrl) getInternalContext(context).wsEndpoint = void 0;
+			if (websocket && getInternalContext(context).wsEndpoint?.url === wsUrl) getInternalContext(context).setWsEndpoint(void 0);
 		}
 	};
 }
@@ -197,7 +197,7 @@ function createInstanceShell(options) {
 		const origin = currentOrigin();
 		if (!cfg || registerPromise || !origin || !meta) return;
 		const resolvedMeta = meta;
-		registerPromise = import("./instance-registry-BQqGoDO9.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
+		registerPromise = import("./instance-registry-WvQkt42E.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
 			let port = 0;
 			try {
 				const url = new URL(origin);
@@ -257,7 +257,7 @@ function createInstanceShell(options) {
 	let resolvedAuth = false;
 	let corePromise;
 	function ensureCore() {
-		corePromise ??= import("./rpc-core-CqcJkAu9.mjs").then((n) => n.n).then(({ createContextRpcServer }) => createContextRpcServer({
+		corePromise ??= import("./rpc-core-DMTe-hLo.mjs").then((n) => n.n).then(({ createContextRpcServer }) => createContextRpcServer({
 			context: ctx,
 			auth: resolvedAuth,
 			onPeerConnect: options.onPeerConnect,
@@ -298,7 +298,7 @@ function createInstanceShell(options) {
 			allowedOrigins: options.allowedOrigins
 		});
 		if (ws.port != null) return await start(ws.port);
-		const { getPort } = await import("./dist-D8jAMwxU.mjs").then((n) => n.t);
+		const { getPort } = await import("./dist-eNI9qM_I.mjs").then((n) => n.t);
 		let lastError;
 		for (let attempt = 0; attempt < 3; attempt++) {
 			const port = attempt === 0 && options.resolveSidecarPort ? await options.resolveSidecarPort(sidecarHost) : await getPort({
@@ -347,6 +347,7 @@ function createInstanceShell(options) {
 			...sseEnabled ? { sse: { path: advertisedSsePath } } : {},
 			...result.mcp ? { mcp: result.mcp } : {}
 		};
+		if (Object.keys(ctx.staticConfig).length > 0) meta.configs = ctx.staticConfig;
 		await options.mount?.(ctx, meta, api);
 		maybePrintBanner();
 		maybeRegister();
@@ -434,7 +435,7 @@ function createInstanceShell(options) {
 			const address = server.address();
 			if (typeof address !== "object" || !address) return;
 			const host = options.host ?? (address.address === "::" || address.address === "0.0.0.0" ? "localhost" : address.address);
-			getInternalContext(ctx).wsEndpoint = { url: `ws://${formatHostForUrl(host)}:${address.port}${routePath}` };
+			getInternalContext(ctx).setWsEndpoint({ url: `ws://${formatHostForUrl(host)}:${address.port}${routePath}` });
 		};
 		if (server.listening) record();
 		else server.once("listening", record);

package/dist/{instance-shell-DBTXTSjN.d.mts → instance-shell-CljiKq1c.d.mts}

@@ -1,6 +1,6 @@
-import { $ as DevframeRpcClientFunctions, G as DevframeNodeRpcSession, _ as ConnectionMeta, d as DevframeWsOptions, et as DevframeRpcServerFunctions, p as DevframeAuthHandler, 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 "./index-CZRd2K1C.mjs";
+import { K as DevframeRpcClientFunctions, R as DevframeNodeRpcSession, c as DevframeWsOptions, d as ConnectionMeta, g as DevframeNodeContext, q as DevframeRpcServerFunctions, s as DevframeSseOptions, u as DevframeAuthHandler } from "./devframe-DJMg0WLe.mjs";
+import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "./ws-server-D1d3QM9f.mjs";
+import "./index-CB-fSUyn.mjs";
 import { BirpcGroup } from "birpc";
 import { NodeAdapter } from "crossws/adapters/node";
 import { Buffer } from "node:buffer";
@@ -11,9 +11,6 @@ import { H3 } from "h3";
 /**
  * One running devframe instance, as recorded in the instance registry.
  * Records are self-describing JSON — additive fields are safe.
- *
- * @experimental The agent-native surface is experimental and may change
- * without a major version bump until it stabilizes.
  */
 interface DevframeInstanceRecord {
   /** Process id of the dev server. */
@@ -42,8 +39,6 @@ interface DevframeInstanceRecord {
 }
 /**
  * Handle returned by {@link registerDevframeInstance}.
- *
- * @experimental
  */
 interface DevframeInstanceRegistration {
   /** The registry file backing this registration. */
@@ -65,8 +60,6 @@ interface DevframeInstanceRegistration {
  * crash are pruned by readers whose liveness probe fails. Registration never
  * throws — a write failure degrades to a coded warning (`DF0045`), since a
  * dev server must not die over discovery metadata.
- *
- * @experimental
  */
 declare function registerDevframeInstance(record: DevframeInstanceRecord, options?: {
   instancesDir?: string;
@@ -81,8 +74,6 @@ declare function registerDevframeInstance(record: DevframeInstanceRecord, option
  * records left behind by killed processes shadow the server currently bound
  * there: per `(port, basePath)` only the newest record survives, older
  * ghosts are pruned with the dead.
- *
- * @experimental
  */
 declare function listLiveDevframeInstances(options?: {
   instancesDir?: string;

package/dist/internal/index.d.mts

@@ -1,7 +1,9 @@
-import { At as DevframeAgentHost$1, Ct as AgentResource, Dt as AgentToolInput, Et as AgentTool, Mt as EventEmitter, Ot as AgentToolProvider, St as AgentManifest, Tt as AgentResourceInput, jt as DevframeAgentHostEvents, kt as AgentToolProviderHandle, wt as AgentResourceContent, x as DevframeNodeContext, xt as AgentHandle, z as DevframeHost } from "../devframe-Bdd9YXTy.mjs";
-import { v as RpcFunctionDefinitionAny } from "../types-CnJSgRVa.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-DBTXTSjN.mjs";
-import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-CGctXToO.mjs";
+import { Ct as DevframeAgentHost$1, P as DevframeHost, St as AgentToolProviderHandle, Tt as EventEmitter, _t as AgentResourceContent, bt as AgentToolInput, g as DevframeNodeContext, gt as AgentResource, ht as AgentManifest, mt as AgentHandle, vt as AgentResourceInput, wt as DevframeAgentHostEvents, xt as AgentToolProvider, yt as AgentTool } from "../devframe-DJMg0WLe.mjs";
+import { v as RpcFunctionDefinitionAny } from "../types-Djq7CBXh.mjs";
+import { a as RemoteAssetsStore } from "../remote-assets-Bg4gCUZ_.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-CljiKq1c.mjs";
+import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-BPmX9fqK.mjs";
+import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-Cc4lucI0.mjs";
 //#region src/node/agent-args.d.ts
 /**
  * How {@link coerceAgentPositionalArgs} treats an args object that carries
@@ -27,19 +29,267 @@ type AgentArgsFallback = 'wrap' | 'drop';
  * - without schemas, `arg0`/`arg1`/… keys are collected when present
  * - an empty object becomes a zero-argument call
  * - anything else follows the {@link AgentArgsFallback}
- *
- * @experimental
  */
 declare function coerceAgentPositionalArgs(args: unknown, schemas: readonly unknown[] | undefined, fallback?: AgentArgsFallback): unknown[];
 //#endregion
+//#region src/node/diagnostics.d.ts
+declare const diagnostics: import("nostics").Diagnostics<{
+  readonly DF0006: {
+    readonly why: (p: {
+      name: string;
+    }) => string;
+  };
+  readonly DF0007: {
+    readonly why: "AsyncLocalStorage is not set, it likely to be an internal bug of the Devframe foundation";
+  };
+  readonly DF0008: {
+    readonly why: (p: {
+      distDir: string;
+    }) => string;
+  };
+  readonly DF0012: {
+    readonly why: (p: {
+      filepath: string;
+    }) => string;
+  };
+  readonly DF0013: {
+    readonly why: (p: {
+      key: string;
+    }) => string;
+  };
+  readonly DF0014: {
+    readonly why: (p: {
+      name: string;
+    }) => string;
+    readonly fix: "Provide a short description (~1–3 sentences) explaining what the tool does and when agents should invoke it.";
+  };
+  readonly DF0015: {
+    readonly why: (p: {
+      id: string;
+    }) => string;
+    readonly fix: "Tool ids must be unique across RPC functions with an `agent` field and tools registered via `ctx.agent.registerTool()`.";
+  };
+  readonly DF0016: {
+    readonly why: (p: {
+      id: string;
+    }) => string;
+  };
+  readonly DF0017: {
+    readonly why: (p: {
+      transport: string;
+      reason: string;
+    }) => string;
+  };
+  readonly DF0029: {
+    readonly why: (p: {
+      channel: string;
+      id: string;
+      dropped: number;
+    }) => string;
+    readonly fix: "The consumer is too slow for the producer. Raise `highWaterMark` on the subscription, slow the producer, or batch chunks.";
+  };
+  readonly DF0030: {
+    readonly why: (p: {
+      channel: string;
+      id: string;
+    }) => string;
+    readonly fix: "Ensure the server-side producer is running before clients subscribe, or check for typos in the stream id.";
+  };
+  readonly DF0031: {
+    readonly why: (p: {
+      channel: string;
+      id: string;
+    }) => string;
+    readonly fix: "Track the producer lifecycle — guard writes with the `stream.signal.aborted` flag.";
+  };
+  readonly DF0032: {
+    readonly why: (p: {
+      channel: string;
+    }) => string;
+    readonly fix: "Each channel name must be unique within a context. Pick a different name or reuse the existing channel handle.";
+  };
+  readonly DF0033: {
+    readonly why: (p: {
+      id: string;
+      reason: string;
+    }) => string;
+    readonly fix: "Verify the bridge port is free and the devframe setup function does not throw. Pin a port via `cli.port` / `cli.portRange` on the definition, or via `port` on `devframeViteBridge` (`@devframes/vite`).";
+  };
+  readonly DF0034: {
+    readonly why: (p: {
+      namespace: string;
+      name: string;
+    }) => string;
+    readonly fix: "A scoped context auto-namespaces ids. Pass a bare name without a \":\" separator (e.g. `register({ name: \"get-cwd\" })`), or use the unscoped `ctx.base.rpc.register` for a fully-qualified name.";
+  };
+  readonly DF0035: {
+    readonly why: (p: {
+      filepath: string;
+    }) => string;
+    readonly fix: "Check that the storage directory is writable and has free space.";
+  };
+  readonly DF0036: {
+    readonly why: (p: {
+      name: string;
+    }) => string;
+    readonly fix: "Complete the auth handshake (or connect with a static/pre-shared token) before calling a trusted method. Untrusted callers may only call `anonymous:`-prefixed methods — see `isAnonymousRpcMethod`.";
+  };
+  readonly DF0037: {
+    readonly why: (p: {
+      id: string;
+    }) => string;
+    readonly fix: "Service ids are unique per context. Revoke the existing provider first (the `provide()` call returns a revoke function), or namespace the id with your plugin id to avoid collisions.";
+  };
+  readonly DF0042: {
+    readonly why: (p: {
+      id: string;
+    }) => string;
+    readonly fix: "Pass `{ force: true }` to `createBuild()` if the degraded export is still useful to you, or drop `capabilities.build: false` on the definition.";
+  };
+  readonly DF0045: {
+    readonly why: (p: {
+      file: string;
+      reason: string;
+    }) => string;
+    readonly 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.";
+  };
+  readonly DF0046: {
+    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 DF0047: {
+    readonly why: (p: {
+      name: string;
+      id: string;
+      existing: string;
+    }) => string;
+    readonly fix: "Wire names derive from tool ids (characters outside [a-zA-Z0-9_-] become \"_\"). Rename one of the two ids so they sanitize to distinct names.";
+  };
+  readonly DF0048: {
+    readonly why: (p: {
+      key: string;
+    }) => string;
+    readonly fix: "Call the devframe_state_read tool without arguments to list the available keys, then retry with one of them.";
+  };
+  readonly DF0049: {
+    readonly why: "The devframe_connect_call-tool tool requires { port: number, tool: string }.";
+    readonly fix: "Call devframe_connect_list-instances to get the port and tool names, then retry.";
+  };
+  readonly DF0050: {
+    readonly why: (p: {
+      port: number;
+    }) => string;
+    readonly fix: "Call devframe_connect_list-instances for the current instance list — the instance may have stopped or changed port.";
+  };
+  readonly DF0051: {
+    readonly why: (p: {
+      port: number;
+    }) => string;
+    readonly fix: "Restart the instance with the --mcp flag (or set `cli.mcp: true` on its definition) to expose its tools, then list instances again.";
+  };
+  readonly DF0052: {
+    readonly why: (p: {
+      host: string;
+      port: number;
+      reason: string;
+    }) => string;
+    readonly fix: "The port is likely already taken by another process (often a previous devframe instance). Free it, or pick another via `--port`, `cli.port` / `cli.portRange` on the definition, or `port` on `devframeViteBridge` (`@devframes/vite`). The original node error is available as `error.cause`.";
+  };
+  readonly DF0054: {
+    readonly why: (p: {
+      id: string;
+    }) => string;
+    readonly fix: "Await `instance.ready` (or any request through `instance.handler`) before reading `connectionMeta()` — the WebSocket binding it describes is only known once initialization completes.";
+  };
+  readonly DF0055: {
+    readonly why: (p: {
+      tier: string;
+    }) => string;
+    readonly fix: "Drop `handleUpgrade`/`attach` and let the configured transport serve the socket, or remove `server` / `ws.port` / `ws.sidecar` from the options so the instance leaves the binding to you.";
+  };
+  readonly DF0056: {
+    readonly why: (p: {
+      url: string;
+    }) => string;
+    readonly fix: "The server behind `ws.url` owns the transport (and its auth). Drop `ws.url` to have the instance serve the socket, or pair it with `server` / `ws.port` / `ws.sidecar` for the tunnel pattern, where a local binding is advertised through the relay.";
+  };
+  readonly DF0057: {
+    readonly why: () => string;
+    readonly fix: "Clients connect over the SSE endpoint instead — no upgrade wiring is needed. Remove `ws: false` if the instance should serve a WebSocket after all.";
+  };
+  readonly DF0058: {
+    readonly why: (p: {
+      id: string;
+    }) => string;
+    readonly fix: "Pass `{ force: true }` to `createDevServer()` to run it anyway, or drop `capabilities.dev: false` on the definition.";
+  };
+  readonly DF0059: {
+    readonly why: (p: {
+      package: string;
+      version: string;
+      provider: string;
+      reason: string;
+    }) => string;
+    readonly fix: "Requests fall back to probing the provider per file. Check network access to the provider, or install the assets package locally so no listing is needed.";
+  };
+  readonly DF0060: {
+    readonly why: (p: {
+      url: string;
+      package: string;
+      reason: string;
+    }) => string;
+    readonly fix: "Install the assets package locally (`npm install <package>`) to serve it with zero network, or check network access to the configured provider.";
+  };
+  readonly DF0061: {
+    readonly why: (p: {
+      package: string;
+      required: string;
+      installed: string;
+    }) => string;
+    readonly fix: "Align the installed assets package with the version its node package declares — they are published in lockstep.";
+  };
+  readonly DF0062: {
+    readonly why: (p: {
+      package: string;
+      required: string;
+      installed: string;
+    }) => string;
+    readonly fix: "Install the exact declared version to serve byte-identical assets.";
+  };
+  readonly DF0063: {
+    readonly why: (p: {
+      filepath: string;
+      reason: string;
+    }) => string;
+    readonly fix: "The response was still served; only caching failed. Check that the cache directory is writable and has free space.";
+  };
+  readonly DF0064: {
+    readonly why: (p: {
+      package: string;
+      version: string;
+      reason: string;
+    }) => string;
+    readonly fix: "Static builds need every asset file up front. Install the assets package locally, or ensure the provider (and its file-listing API) is reachable during the build.";
+  };
+  readonly DF0065: {
+    readonly why: (p: {
+      field: "package" | "version";
+      value: string;
+    }) => string;
+    readonly fix: "A remote-assets `package` must be a valid npm package name and `version` an exact semver version (e.g. `1.2.3`) — they are interpolated into CDN URLs and the cache path.";
+  };
+}, readonly [(d: import("nostics").Diagnostic, { method }?: {
+  method?: "log" | "warn" | "error";
+}) => void]>;
+//#endregion
 //#region src/node/host-agent.d.ts
 /**
  * Framework-neutral host aggregating the agent-exposed surface of a
  * devframe. Auto-discovers RPC functions with an `agent` field from
  * `ctx.rpc.definitions`, and accepts plugin-registered tools /
  * resources via `registerTool` / `registerResource`.
- *
- * @experimental
  */
 declare class DevframeAgentHost implements DevframeAgentHost$1 {
   readonly context: DevframeNodeContext;
@@ -71,8 +321,6 @@ declare class DevframeAgentHost implements DevframeAgentHost$1 {
 //#endregion
 //#region src/node/host-h3.d.ts
 interface CreateH3DevframeHostOptions {
-  /** The h3 app instance — registered once the CLI adapter lands. */
-  app?: unknown;
   /**
    * Host the standalone server listens on, e.g. `http://localhost:9999`.
    * Consumed by `resolveOrigin` for dock entries that need an absolute URL.
@@ -81,11 +329,13 @@ interface CreateH3DevframeHostOptions {
    */
   origin: string | (() => string);
   /**
-   * Register a static-file handler at `base` serving files from `distDir`.
-   * Wired into the h3 app once the CLI adapter lands (commit 5). For now
-   * the CLI isn't running, so the default is a no-op.
+   * Register a static-file handler at `base` serving files from `source` —
+   * a local directory or a resolved remote-assets back-proxy store (both
+   * accepted by `devframe/utils/serve-static`). `mountStatic` forwards to
+   * it; when omitted the host serves no SPA (bridge mode, where the SPA is
+   * hosted elsewhere).
    */
-  mount?: (base: string, distDir: string) => void | Promise<void>;
+  mount?: (base: string, source: string | RemoteAssetsStore) => void | Promise<void>;
   /**
    * Namespace for storage paths returned by `getStorageDir`. Workspace
    * state (committable) lives under `${workspaceRoot}/.devframe/`, project
@@ -114,7 +364,6 @@ declare function normalizeHttpServerUrl(host: string, port: number | string): st
  * The per-connection `serialize`/`deserialize` pair for a live RPC wire.
  *
  * @internal
- * implementations; not part of the stable public API.
  */
 interface RpcWireCodec {
   serialize: (msg: any) => string;
@@ -130,7 +379,6 @@ interface RpcWireCodec {
  * don't collide across connections.
  *
  * @internal
- * implementations; not part of the stable public API.
  */
 declare function createRpcWireCodec(definitions?: ReadonlyMap<string, Pick<RpcFunctionDefinitionAny, 'jsonSerializable'>>): RpcWireCodec;
 /**
@@ -140,11 +388,10 @@ declare function createRpcWireCodec(definitions?: ReadonlyMap<string, Pick<RpcFu
  * handed to birpc proper.
  *
  * @internal
- * implementations; not part of the stable public API.
  */
 declare function peekRpcWireFrame(raw: string): {
   t?: 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 RpcWireCodec, type StartedServer, coerceAgentPositionalArgs, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, listLiveDevframeInstances, normalizeHttpServerUrl, peekRpcWireFrame, registerDevframeInstance, resolveInstanceRegister, 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 RpcWireCodec, type StartedServer, coerceAgentPositionalArgs, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, diagnostics, listLiveDevframeInstances, normalizeBasePath, normalizeHttpServerUrl, peekRpcWireFrame, registerDevframeInstance, resolveBasePath, resolveInstanceRegister, samePath };

package/dist/internal/index.mjs

@@ -1,7 +1,9 @@
-import { n as peekRpcWireFrame, t as createRpcWireCodec } from "../wire-codec-9VhIKnyp.mjs";
-import { n as coerceAgentPositionalArgs, t as DevframeAgentHost } from "../host-agent-CpbAoqBx.mjs";
-import { t as createH3DevframeHost } from "../host-h3-CzCZwtuV.mjs";
-import { i as registerDevframeInstance, n as listLiveDevframeInstances } from "../instance-registry-BQqGoDO9.mjs";
-import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, r as samePath, t as createInstanceShell } from "../instance-shell-KRdee1QF.mjs";
-import { t as createContextRpcServer } from "../rpc-core-CqcJkAu9.mjs";
-export { DevframeAgentHost, coerceAgentPositionalArgs, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, listLiveDevframeInstances, normalizeHttpServerUrl, peekRpcWireFrame, registerDevframeInstance, resolveInstanceRegister, samePath };
+import { n as peekRpcWireFrame, t as createRpcWireCodec } from "../wire-codec-0K-o5MYW.mjs";
+import { t as diagnostics } from "../diagnostics-DOQPnQmX.mjs";
+import { n as coerceAgentPositionalArgs, t as DevframeAgentHost } from "../host-agent-xLCSe65D.mjs";
+import { n as resolveBasePath, t as normalizeBasePath } from "../_shared-CbZ_yhbz.mjs";
+import { t as createH3DevframeHost } from "../host-h3-Crkzm42q.mjs";
+import { i as registerDevframeInstance, n as listLiveDevframeInstances } from "../instance-registry-WvQkt42E.mjs";
+import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, r as samePath, t as createInstanceShell } from "../instance-shell-CMFyszWJ.mjs";
+import { t as createContextRpcServer } from "../rpc-core-DMTe-hLo.mjs";
+export { DevframeAgentHost, coerceAgentPositionalArgs, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, diagnostics, listLiveDevframeInstances, normalizeBasePath, normalizeHttpServerUrl, peekRpcWireFrame, registerDevframeInstance, resolveBasePath, resolveInstanceRegister, samePath };

package/dist/node/auth.d.mts

@@ -1,3 +1,3 @@
-import { p as DevframeAuthHandler } from "../devframe-Bdd9YXTy.mjs";
-import { a as verifyAuthToken, i as refreshTempAuthCode, n as exchangeTempAuthCode, o as revokeActiveConnectionsForToken, r as getTempAuthCode, s as revokeAuthToken, t as buildOtpAuthUrl } from "../index-CZRd2K1C.mjs";
+import { u as DevframeAuthHandler } from "../devframe-DJMg0WLe.mjs";
+import { a as verifyAuthToken, i as refreshTempAuthCode, n as exchangeTempAuthCode, o as revokeActiveConnectionsForToken, r as getTempAuthCode, s as revokeAuthToken, t as buildOtpAuthUrl } from "../index-CB-fSUyn.mjs";
 export { DevframeAuthHandler, buildOtpAuthUrl, exchangeTempAuthCode, getTempAuthCode, refreshTempAuthCode, revokeActiveConnectionsForToken, revokeAuthToken, verifyAuthToken };

package/dist/node/auth.mjs

@@ -1,3 +1,3 @@
 import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "../revoke-DZbJ7Cl0.mjs";
-import { a as verifyAuthToken, i as refreshTempAuthCode, n as exchangeTempAuthCode, r as getTempAuthCode, t as buildOtpAuthUrl } from "../state-BeUHDDjk.mjs";
+import { a as verifyAuthToken, i as refreshTempAuthCode, n as exchangeTempAuthCode, r as getTempAuthCode, t as buildOtpAuthUrl } from "../state-Cc1IeSmQ.mjs";
 export { buildOtpAuthUrl, exchangeTempAuthCode, getTempAuthCode, refreshTempAuthCode, revokeActiveConnectionsForToken, revokeAuthToken, verifyAuthToken };

package/dist/node/hub-internals.d.mts

@@ -1,3 +1,3 @@
-import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-CSCwoABx.mjs";
-import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-DmpWW-HH.mjs";
+import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-B3YUu_95.mjs";
+import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-BPmX9fqK.mjs";
 export { type DevframeInternalContext, type InternalAnonymousAuthStorage, type RemoteTokenRecord, getInternalContext, internalContextMap, normalizeBasePath, resolveBasePath };

package/dist/node/hub-internals.mjs

@@ -1,3 +1,3 @@
-import { n as resolveBasePath, t as normalizeBasePath } from "../_shared-CttmCMBi.mjs";
-import { n as internalContextMap, t as getInternalContext } from "../context-C33rR7n0.mjs";
+import { n as resolveBasePath, t as normalizeBasePath } from "../_shared-CbZ_yhbz.mjs";
+import { n as internalContextMap, t as getInternalContext } from "../context-xdynGSLP.mjs";
 export { getInternalContext, internalContextMap, normalizeBasePath, resolveBasePath };

package/dist/node/index.d.mts

@@ -1,6 +1,6 @@
-import { gt as SharedState, q as RpcFunctionsHost, x as DevframeNodeContext, z as DevframeHost } from "../devframe-Bdd9YXTy.mjs";
-import "../index-DSCq4M4q.mjs";
-import { v as RpcFunctionDefinitionAny } from "../types-CnJSgRVa.mjs";
+import { B as RpcFunctionsHost, P as DevframeHost, g as DevframeNodeContext, lt as SharedState } from "../devframe-DJMg0WLe.mjs";
+import "../index-tdrk1bzV.mjs";
+import { v as RpcFunctionDefinitionAny } from "../types-Djq7CBXh.mjs";
 import { BirpcGroup } from "birpc";
 //#region src/node/context.d.ts
 interface CreateHostContextOptions {

package/dist/node/index.mjs

@@ -1,3 +1,3 @@
-import { t as createStorage } from "../storage-BcmVEJRc.mjs";
-import { t as createHostContext } from "../context-Du11TLcO.mjs";
+import { t as createHostContext } from "../context-CEe4PBz1.mjs";
+import { t as createStorage } from "../storage-CYye7P7L.mjs";
 export { createHostContext, createStorage };