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

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

@@ -1,9 +1,9 @@
-import { _ as ConnectionMeta, f as McpRouteOptions, i as DevframeDeploymentKind, r as DevframeDefinition } from "./devframe-Bdd9YXTy.mjs";
+import { d as ConnectionMeta, l as McpRouteOptions, n as DevframeDefinition, r as DevframeDeploymentKind } from "./devframe-DJMg0WLe.mjs";
 //#region src/adapters/_shared.d.ts
 /**
  * Resolve the mount base path for a devframe's SPA. Hosted adapters
  * (`vite`, `embedded`) default to `/__<id>/` so they don't collide
- * with the host app; standalone adapters (`cli`, `spa`, `build`)
+ * with the host app; standalone adapters (`cli`, `build`)
  * default to `/` because they own the origin.
  *
  * The devframe author can override with `basePath` on the definition.
@@ -35,8 +35,6 @@ declare function resolveDevServerPort(def: DevframeDefinition, options?: Resolve
  * and the client dials `<page-host>:<port><path>`. Without `port` the path
  * stays relative, resolved against `__connection.json`'s own location (the
  * same-server default).
- *
- * @experimental
  */
 declare function resolveMcpConnectionMeta(def: DevframeDefinition, mcp: boolean | McpRouteOptions | undefined, port?: number): ConnectionMeta['mcp'];
 //#endregion

package/dist/{_shared-CttmCMBi.mjs → _shared-CbZ_yhbz.mjs}

@@ -1,12 +1,12 @@
 import "./constants.mjs";
-import { n as getPort } from "./dist-D8jAMwxU.mjs";
+import { n as getPort } from "./dist-eNI9qM_I.mjs";
 import { cleanDoubleSlashes, withLeadingSlash, withTrailingSlash, withoutLeadingSlash } from "ufo";
 //#region src/adapters/_shared.ts
 const DEFAULT_PORT = 9999;
 /**
 * Resolve the mount base path for a devframe's SPA. Hosted adapters
 * (`vite`, `embedded`) default to `/__<id>/` so they don't collide
-* with the host app; standalone adapters (`cli`, `spa`, `build`)
+* with the host app; standalone adapters (`cli`, `build`)
 * default to `/` because they own the origin.
 *
 * The devframe author can override with `basePath` on the definition.
@@ -54,8 +54,6 @@ function resolveMcpConfig(mcp) {
 * and the client dials `<page-host>:<port><path>`. Without `port` the path
 * stays relative, resolved against `__connection.json`'s own location (the
 * same-server default).
-*
-* @experimental
 */
 function resolveMcpConnectionMeta(def, mcp, port) {
 	const config = resolveMcpConfig(mcp ?? def.cli?.mcp);

package/dist/adapters/build.d.mts

@@ -1,16 +1,16 @@
-import { r as DevframeDefinition } from "../devframe-Bdd9YXTy.mjs";
+import { n as DevframeDefinition } from "../devframe-DJMg0WLe.mjs";
+import { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {
   /** Output directory. Defaults to `dist-static`. */
   outDir?: string;
-  /** Absolute URL base the output is served from (default: `/`). */
-  base?: string;
   /**
-   * Override the SPA dist directory to copy into `outDir`. When omitted
-   * the adapter reads `devframe.cli?.distDir` — authors typically set this
-   * once on the definition itself.
+   * Override the SPA dist to copy into `outDir` — a local directory or a
+   * remote-assets declaration (materialized in full at build time). When
+   * omitted the adapter reads `devframe.cli?.distDir` — authors typically
+   * set this once on the definition itself.
    */
-  distDir?: string;
+  distDir?: StaticAssetsSource;
   /**
    * Pretty-print RPC dump JSON files. Defaults to `false` so payload
    * shards (which can be multiple MB for graph-heavy tools) ship
@@ -32,11 +32,9 @@ interface CreateBuildOptions {
  *   - Copy the author's SPA dist into `<outDir>/`.
  *   - Write `<outDir>/__connection.json` (`{ backend: 'static' }`) and the
  *     sharded RPC dump under `<outDir>/__rpc-dump/` so the deployed SPA
- *     discovers both via relative paths from `document.baseURI`.
- *   - When `def.spa` is configured, also write `<outDir>/spa-loader.json`
- *     describing the SPA's data-loader mode (`'query'` / `'upload'` /
- *     `'none'`). The output is mount-path agnostic — the same bundle
- *     works at `/`, `/devframe/`, or any base, no rewriting required.
+ *     discovers both via relative paths from `document.baseURI`. The
+ *     output is mount-path agnostic — the same bundle works at `/`,
+ *     `/devframe/`, or any base, no rewriting required.
  */
 declare function createBuild(d: DevframeDefinition, options?: CreateBuildOptions): Promise<void>;
 //#endregion

package/dist/adapters/build.mjs

@@ -1,16 +1,16 @@
-import { n as colors } from "../diagnostics-reporter-CsIG85Q5.mjs";
-import { n as strictJsonStringify } from "../serialization-BHY8M5NQ.mjs";
+import { s as colors } from "../nostics-CzECRXpE.mjs";
+import { n as strictJsonStringify } from "../serialization-BGzEwAdr.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
-import { t as collectStaticRpcDump } from "../static-CvjkO8QE.mjs";
+import { t as collectStaticRpcDump } from "../static-BPZ1_OPA.mjs";
 import { n as structuredCloneStringify } from "../structured-clone-CbAV5rFI.mjs";
-import { t as diagnostics } from "../diagnostics-DLYH5oD3.mjs";
-import { t as createHostContext } from "../context-Du11TLcO.mjs";
-import { n as resolveBasePath } from "../_shared-CttmCMBi.mjs";
-import { t as createH3DevframeHost } from "../host-h3-CzCZwtuV.mjs";
+import { t as diagnostics } from "../diagnostics-DOQPnQmX.mjs";
+import { t as createHostContext } from "../context-CEe4PBz1.mjs";
+import { t as resolveStaticAssetsSource } from "../remote-assets-nTTxY2MU.mjs";
+import { t as createH3DevframeHost } from "../host-h3-Crkzm42q.mjs";
 import { existsSync } from "node:fs";
+import fs$1 from "node:fs/promises";
 import { dirname, resolve } from "pathe";
 import process from "node:process";
-import fs$1 from "node:fs/promises";
 //#region src/adapters/build.ts
 /**
 * Produce a self-contained static deploy of a devframe:
@@ -19,28 +19,33 @@ import fs$1 from "node:fs/promises";
 *   - Copy the author's SPA dist into `<outDir>/`.
 *   - Write `<outDir>/__connection.json` (`{ backend: 'static' }`) and the
 *     sharded RPC dump under `<outDir>/__rpc-dump/` so the deployed SPA
-*     discovers both via relative paths from `document.baseURI`.
-*   - When `def.spa` is configured, also write `<outDir>/spa-loader.json`
-*     describing the SPA's data-loader mode (`'query'` / `'upload'` /
-*     `'none'`). The output is mount-path agnostic — the same bundle
-*     works at `/`, `/devframe/`, or any base, no rewriting required.
+*     discovers both via relative paths from `document.baseURI`. The
+*     output is mount-path agnostic — the same bundle works at `/`,
+*     `/devframe/`, or any base, no rewriting required.
 */
 async function createBuild(d, options = {}) {
 	if (d.capabilities?.build === false && !options.force) throw diagnostics.DF0042({ id: d.id });
 	const outDir = resolve(options.outDir ?? "dist-static");
-	const distDir = options.distDir ?? d.cli?.distDir;
-	if (!distDir) throw new Error(`[devframe] createBuild: no distDir for "${d.id}". Set \`cli.distDir\` on the definition or pass it as an option.`);
+	const distSource = options.distDir ?? d.cli?.distDir;
+	if (!distSource) throw new Error(`[devframe] createBuild: no distDir for "${d.id}". Set \`cli.distDir\` on the definition or pass it as an option.`);
 	if (existsSync(outDir)) await fs$1.rm(outDir, { recursive: true });
 	await fs$1.mkdir(outDir, { recursive: true });
-	console.log(colors.cyan`[devframe] copying SPA from ${distDir} -> ${outDir}`);
-	await fs$1.cp(distDir, outDir, { recursive: true });
+	const host = createH3DevframeHost({
+		origin: "http://localhost",
+		appName: d.id
+	});
+	const resolved = resolveStaticAssetsSource(distSource, host.getStorageDir("project"));
+	if (typeof resolved === "string") {
+		console.log(colors.cyan`[devframe] copying SPA from ${resolved} -> ${outDir}`);
+		await fs$1.cp(resolved, outDir, { recursive: true });
+	} else {
+		console.log(colors.cyan`[devframe] materializing SPA from ${resolved.assets.package}@${resolved.assets.version} -> ${outDir}`);
+		await resolved.materialize(outDir);
+	}
 	const ctx = await createHostContext({
 		cwd: process.cwd(),
 		mode: "build",
-		host: createH3DevframeHost({
-			origin: "http://localhost",
-			appName: d.id
-		})
+		host
 	});
 	await d.setup(ctx);
 	await fs$1.mkdir(resolve(outDir, DEVFRAME_RPC_DUMP_DIRNAME), { recursive: true });
@@ -60,15 +65,6 @@ async function createBuild(d, options = {}) {
 		await fs$1.writeFile(fullpath, file.serialization === "json" && indent != null ? JSON.stringify(JSON.parse(text), null, indent) : text, "utf-8");
 	}
 	await fs$1.writeFile(resolve(outDir, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME), JSON.stringify(dump.manifest, null, 2), "utf-8");
-	if (d.spa) {
-		const base = options.base ?? resolveBasePath(d, "standalone");
-		const spaLoader = {
-			version: 1,
-			mode: d.spa.loader ?? "none",
-			base
-		};
-		await fs$1.writeFile(resolve(outDir, "spa-loader.json"), JSON.stringify(spaLoader, null, 2), "utf-8");
-	}
 	console.log(colors.green`[devframe] built "${d.id}" -> ${outDir}`);
 }
 //#endregion

package/dist/adapters/cac.d.mts

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

package/dist/adapters/cac.mjs

@@ -1,7 +1,7 @@
-import { n as colors } from "../diagnostics-reporter-CsIG85Q5.mjs";
-import { r as resolveDevServerPort } from "../_shared-CttmCMBi.mjs";
+import { s as colors } from "../nostics-CzECRXpE.mjs";
+import { r as resolveDevServerPort } from "../_shared-CbZ_yhbz.mjs";
 import { createBuild } from "./build.mjs";
-import { t as createDevServer } from "../dev-BEveeA5H.mjs";
+import { t as createDevServer } from "../dev--rAPzbvO.mjs";
 import process from "node:process";
 import cac$1 from "cac";
 //#region src/adapters/flags.ts
@@ -94,7 +94,7 @@ function createCac(d, options = {}) {
 	const defaultPort = options.defaultPort ?? d.cli?.port ?? 9999;
 	const defaultHost = d.cli?.host ?? "localhost";
 	const cli = cac$1(d.cli?.command ?? d.id);
-	const devCommand = cli.command("[...args]", "Start a local dev server").option("--port <port>", "Port to listen on").option("--host <host>", "Host to bind to", { default: defaultHost }).option("--open", "Open the browser on start").option("--no-open", "Do not open the browser").option("--no-auth", "Disable the interactive authentication gate").option("--mcp", "Expose an MCP server over HTTP at /__mcp (use --no-mcp to disable) [experimental]");
+	const devCommand = cli.command("[...args]", "Start a local dev server").option("--port <port>", "Port to listen on").option("--host <host>", "Host to bind to", { default: defaultHost }).option("--open", "Open the browser on start").option("--no-open", "Do not open the browser").option("--no-auth", "Disable the interactive authentication gate").option("--mcp", "Expose an MCP server over HTTP at /__mcp (use --no-mcp to disable)");
 	if (d.cli?.flags) for (const [key, schema] of Object.entries(d.cli.flags)) {
 		const optionName = flagKeyToOption(key);
 		const description = schema.description ?? "";
@@ -117,14 +117,13 @@ function createCac(d, options = {}) {
 			onReady: options.onReady
 		});
 	});
-	if (d.capabilities?.build !== false) cli.command("build", "Build a self-contained static deploy of the devframe").option("--out-dir <outDir>", "Output directory", { default: "dist-static" }).option("--base <base>", "URL base", { default: "/" }).option("--pretty", "Pretty-print dump JSON (larger on disk)").action(async (flags) => {
+	if (d.capabilities?.build !== false) cli.command("build", "Build a self-contained static deploy of the devframe").option("--out-dir <outDir>", "Output directory", { default: "dist-static" }).option("--pretty", "Pretty-print dump JSON (larger on disk)").action(async (flags) => {
 		await createBuild(d, {
 			outDir: flags.outDir,
-			base: flags.base,
 			pretty: flags.pretty
 		});
 	});
-	cli.command("mcp", "Start an MCP server exposing agent-facing tools (stdio) [experimental]").action(async () => {
+	cli.command("mcp", "Start an MCP server exposing agent-facing tools (stdio)").action(async () => {
 		const { createMcpServer } = await import("./mcp.mjs");
 		await createMcpServer(d, {
 			transport: "stdio",

package/dist/adapters/dev.d.mts

@@ -1,7 +1,8 @@
-import { G as DevframeNodeRpcSession, d as DevframeWsOptions, f as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition, u as DevframeSseOptions } from "../devframe-Bdd9YXTy.mjs";
-import { d as DevframeRpcConnection, u as DevframeNodeRpcSessionMeta } from "../ws-server-Ces08fjP.mjs";
-import { c as StartedServer } from "../instance-shell-DBTXTSjN.mjs";
-import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-DmpWW-HH.mjs";
+import { R as DevframeNodeRpcSession, c as DevframeWsOptions, l as McpRouteOptions, n as DevframeDefinition, 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 { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
+import { c as StartedServer } from "../instance-shell-CljiKq1c.mjs";
+import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-BPmX9fqK.mjs";
 import { H3 } from "h3";
 //#region src/adapters/dev.d.ts
 interface CreateDevServerOptions {
@@ -24,9 +25,9 @@ interface CreateDevServerOptions {
    * `def.cli?.distDir` is set, the dev server runs in **bridge mode** —
    * only `__connection.json` and the WS endpoint are mounted; the SPA
    * is expected to be hosted elsewhere (e.g. by a parent Vite/Nuxt
-   * dev server via `viteDevBridge({ devMiddleware })`).
+   * dev server via `devframeViteBridge` from `@devframes/vite`).
    */
-  distDir?: string;
+  distDir?: StaticAssetsSource;
   /**
    * Override the SPA mount path. Defaults to
    * `resolveBasePath(def, 'standalone')` (i.e. `def.basePath` or `/`).
@@ -39,6 +40,13 @@ interface CreateDevServerOptions {
    * clients connect over the SSE endpoint instead (`backend: 'sse'`).
    */
   ws?: DevframeWsOptions | false;
+  /**
+   * Extra origins to accept on the WS upgrade beyond the loopback default.
+   * Add your LAN/tunnel origin here when reaching the tool from another
+   * host. Pass `false` to disable origin checking entirely (not
+   * recommended). Default: loopback-only.
+   */
+  allowedOrigins?: readonly string[] | WsOriginRegistry | false;
   /**
    * Override the SSE RPC endpoint control (`def.cli?.sse`) — enabled by
    * default at `<base>__sse`. Pass `false` to disable, or a
@@ -63,7 +71,7 @@ interface CreateDevServerOptions {
    * Override how authentication resolves, taking precedence over
    * `def.cli?.auth`. Pass `false` to skip the gate entirely (the standard
    * choice for a **hosted** deployment where the host manages auth — see
-   * {@link viteDevBridge}); a {@link DevframeAuthHandler} to install a custom
+   * {@link devframeViteBridge} from `@devframes/vite`); a {@link DevframeAuthHandler} to install a custom
    * scheme; or `true` to force devframe's interactive OTP gate on. When
    * omitted, auth resolves from `flags.auth` / `def.cli?.auth` (the standalone
    * default: gated). The `--no-auth` flag (`flags.auth === false`) still forces
@@ -97,6 +105,12 @@ interface CreateDevServerOptions {
     port: number;
     app: H3;
   }) => void | Promise<void>;
+  /**
+   * Proceed even when the definition declares `capabilities.dev: false`.
+   * `createDevServer` otherwise refuses such a definition (`DF0058`) — this
+   * only matters for a caller invoking it directly, bypassing the CLI.
+   */
+  force?: boolean;
 }
 /**
  * Start a devframe dev server for a {@link DevframeDefinition} —
@@ -107,7 +121,7 @@ interface CreateDevServerOptions {
  * server runs in **bridge mode**: only `__connection.json` and the WS
  * endpoint are mounted, with no SPA mount. The SPA is expected to be
  * hosted elsewhere (e.g. by a parent Vite/Nuxt dev server) — see
- * `viteDevBridge({ devMiddleware })`.
+ * `devframeViteBridge` from `@devframes/vite`.
  *
  * Returns the underlying {@link StartedServer} handle so callers can
  * close it gracefully (SIGINT, hot-reload, test teardown).

package/dist/adapters/dev.mjs

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

package/dist/adapters/embedded.d.mts

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

package/dist/adapters/initiate.d.mts

@@ -1,6 +1,7 @@
-import { B as DevframeStorageScope, G as DevframeNodeRpcSession, _ as ConnectionMeta, d as DevframeWsOptions, f as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition, u as DevframeSseOptions, x as DevframeNodeContext } from "../devframe-Bdd9YXTy.mjs";
-import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-Ces08fjP.mjs";
-import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-DBTXTSjN.mjs";
+import { F as DevframeStorageScope, R as DevframeNodeRpcSession, c as DevframeWsOptions, d as ConnectionMeta, g as DevframeNodeContext, l as McpRouteOptions, n as DevframeDefinition, 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 { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
+import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-CljiKq1c.mjs";
 import { Buffer } from "node:buffer";
 import { IncomingMessage, Server, ServerResponse } from "node:http";
 import { Duplex } from "node:stream";
@@ -22,7 +23,7 @@ interface InitDevframeOptions {
    * **bridge mode**: only `__connection.json`, the WS endpoint, and the MCP
    * route (when enabled) are served; the SPA is hosted elsewhere.
    */
-  distDir?: string | false;
+  distDir?: StaticAssetsSource | false;
   /**
    * Share the host's `node:http` server for the WebSocket RPC endpoint: the
    * upgrade listener binds to `<base>__ws` on this server, so no extra port

package/dist/adapters/initiate.mjs

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

package/dist/adapters/mcp.d.mts

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

package/dist/adapters/mcp.mjs

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

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

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

package/dist/cli/main.d.mts

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

package/dist/cli/main.mjs

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

package/dist/client/index.d.mts

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