devframe 0.9.4 → 0.9.6

package/README.md

@@ -6,7 +6,7 @@
 [![JSDocs][jsdocs-src]][jsdocs-href]
 [![License][license-src]][license-href]
 
-Framework-neutral foundation for building generic devframes.
+Framework-neutral foundation for building DevTools.
 
 Documentation: [https://devfra.me/](https://devfra.me/).
 

package/dist/{_shared-BPovvJW8.d.mts → _shared-BJ6AmwTu.d.mts}

@@ -1,4 +1,4 @@
-import { F as DevframeDefinition, G as McpRouteOptions, I as DevframeDeploymentKind, t as ConnectionMeta } from "./context-_i51nYOs.mjs";
+import { F as DevframeDefinition, G as McpRouteOptions, I as DevframeDeploymentKind, t as ConnectionMeta } from "./context-BhBzOXVa.mjs";
 //#region src/adapters/_shared.d.ts
 /**
  * Resolve the mount base path for a devframe's SPA. Hosted adapters

package/dist/adapters/build.d.mts

@@ -1,5 +1,5 @@
-import { F as DevframeDefinition, V as DevframeSnapshotRpcEntry, o as DevframeNodeContext } from "../context-_i51nYOs.mjs";
-import { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
+import { F as DevframeDefinition, V as DevframeSnapshotRpcEntry, o as DevframeNodeContext } from "../context-BhBzOXVa.mjs";
+import { o as StaticAssetsSource } from "../remote-assets-B13_vRkJ.mjs";
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {
   /** Output directory. Defaults to `dist-static`. */
@@ -7,8 +7,9 @@ interface CreateBuildOptions {
   /**
    * 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.
+   * omitted the adapter reads `devframe.clientAssets` (or the deprecated
+   * `devframe.cli?.distDir`) — authors typically set this once on the
+   * definition itself.
    */
   distDir?: StaticAssetsSource;
   /**

package/dist/adapters/build.mjs

@@ -1,10 +1,11 @@
 import { s as colors } from "../nostics-CzECRXpE.mjs";
 import { n as strictJsonStringify } from "../serialization-BGzEwAdr.mjs";
+import { resolveClientAssets } from "../index.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
 import { t as collectStaticRpcDump } from "../static-DV_qUSRS.mjs";
 import { n as structuredCloneStringify } from "../structured-clone-CbAV5rFI.mjs";
 import { t as diagnostics } from "../diagnostics-BXWW3VK-.mjs";
-import { t as createHostContext } from "../context-CQW0lSw8.mjs";
+import { t as createHostContext } from "../context-omlma_1n.mjs";
 import { t as resolveStaticAssetsSource } from "../remote-assets-DezQmPQU.mjs";
 import { t as createH3DevframeHost } from "../host-h3-fRbF9yor.mjs";
 import process from "node:process";
@@ -26,8 +27,8 @@ import fs$1 from "node:fs/promises";
 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 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.`);
+	const distSource = options.distDir ?? resolveClientAssets(d);
+	if (!distSource) throw new Error(`[devframe] createBuild: no client assets for "${d.id}". Set \`clientAssets\` 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 });
 	const host = createH3DevframeHost({

package/dist/adapters/cac.d.mts

@@ -1,4 +1,4 @@
-import { Dt as parseCliFlags, Et as defineCliFlags, F as DevframeDefinition, Tt as InferCliFlags, wt as CliFlagsSchema } from "../context-_i51nYOs.mjs";
+import { Dt as parseCliFlags, Et as defineCliFlags, F as DevframeDefinition, Tt as InferCliFlags, wt as CliFlagsSchema } from "../context-BhBzOXVa.mjs";
 import { CAC } from "cac";
 import { H3 } from "h3";
 //#region src/adapters/cac.d.ts

package/dist/adapters/cac.mjs

@@ -1,7 +1,8 @@
 import { s as colors } from "../nostics-CzECRXpE.mjs";
 import { r as resolveDevServerPort } from "../_shared-BM3PdYli.mjs";
+import { a as importRuntimeModule } from "../instance-shell-CpVW4zG0.mjs";
 import { createBuild } from "./build.mjs";
-import { t as createDevServer } from "../dev-lpIvwagf.mjs";
+import { t as createDevServer } from "../dev-Czit5IP4.mjs";
 import process from "node:process";
 import cac$1 from "cac";
 //#region src/adapters/flags.ts
@@ -125,7 +126,7 @@ function createCac(d, options = {}) {
 		});
 	});
 	cli.command("mcp", "Start an MCP server exposing agent-facing tools (stdio)").action(async () => {
-		const { createMcpServer } = await import("./mcp.mjs");
+		const { createMcpServer } = await importRuntimeModule("devframe/adapters/mcp");
 		await createMcpServer(d, {
 			transport: "stdio",
 			onReady: ({ transport }) => {

package/dist/adapters/dev.d.mts

@@ -1,8 +1,8 @@
-import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-DLtEoLdR.mjs";
-import { Ct as DevframeAuthHandler, F as DevframeDefinition, G as McpRouteOptions, U as DevframeSseOptions, W as DevframeWsOptions, s as DevframeNodeRpcSession } from "../context-_i51nYOs.mjs";
-import { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
-import { c as StartedServer } from "../instance-shell-BHvBIGP4.mjs";
-import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-BPovvJW8.mjs";
+import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-Di2oqr4q.mjs";
+import { Ct as DevframeAuthHandler, F as DevframeDefinition, G as McpRouteOptions, U as DevframeSseOptions, W as DevframeWsOptions, s as DevframeNodeRpcSession } from "../context-BhBzOXVa.mjs";
+import { o as StaticAssetsSource } from "../remote-assets-B13_vRkJ.mjs";
+import { c as StartedServer } from "../instance-shell-Bh4l9Vz_.mjs";
+import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-BJ6AmwTu.mjs";
 import { H3 } from "h3";
 //#region src/adapters/dev.d.ts
 interface CreateDevServerOptions {
@@ -21,11 +21,12 @@ interface CreateDevServerOptions {
    */
   flags?: Record<string, unknown>;
   /**
-   * Override `def.cli?.distDir`. When neither this option nor
-   * `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 `devframeViteBridge` from `@devframes/vite`).
+   * Override the definition's `clientAssets` (or deprecated `cli.distDir`).
+   * When neither this option nor the definition's client assets are 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 `devframeViteBridge` from
+   * `@devframes/vite`).
    */
   distDir?: StaticAssetsSource;
   /**
@@ -117,7 +118,7 @@ interface CreateDevServerOptions {
  * h3 + WebSocket RPC + (optionally) the author's SPA mounted at the
  * resolved base path.
  *
- * When `distDir` is omitted (and `def.cli?.distDir` is unset) the
+ * When `distDir` is omitted (and the definition's client assets are unset) the
  * 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

package/dist/adapters/dev.mjs

@@ -1,3 +1,3 @@
 import { i as resolveMcpConnectionMeta, r as resolveDevServerPort } from "../_shared-BM3PdYli.mjs";
-import { t as createDevServer } from "../dev-lpIvwagf.mjs";
+import { t as createDevServer } from "../dev-Czit5IP4.mjs";
 export { createDevServer, resolveDevServerPort, resolveMcpConnectionMeta };

package/dist/adapters/embedded.d.mts

@@ -1,4 +1,4 @@
-import { F as DevframeDefinition, o as DevframeNodeContext } from "../context-_i51nYOs.mjs";
+import { F as DevframeDefinition, o as DevframeNodeContext } from "../context-BhBzOXVa.mjs";
 //#region src/adapters/embedded.d.ts
 interface CreateEmbeddedOptions {
   /** Target context the devframe is registered into. Required. */

package/dist/adapters/initiate.d.mts

@@ -1,7 +1,7 @@
-import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-DLtEoLdR.mjs";
-import { Ct as DevframeAuthHandler, F as DevframeDefinition, G as McpRouteOptions, U as DevframeSseOptions, W as DevframeWsOptions, bt as DevframeStorageScope, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta } from "../context-_i51nYOs.mjs";
-import { o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
-import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-BHvBIGP4.mjs";
+import { d as DevframeRpcConnection, n as WsOriginRegistry, u as DevframeNodeRpcSessionMeta } from "../ws-server-Di2oqr4q.mjs";
+import { Ct as DevframeAuthHandler, F as DevframeDefinition, G as McpRouteOptions, U as DevframeSseOptions, W as DevframeWsOptions, bt as DevframeStorageScope, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta } from "../context-BhBzOXVa.mjs";
+import { o as StaticAssetsSource } from "../remote-assets-B13_vRkJ.mjs";
+import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-Bh4l9Vz_.mjs";
 import { Buffer } from "node:buffer";
 import { IncomingMessage, Server, ServerResponse } from "node:http";
 import { Duplex } from "node:stream";
@@ -18,10 +18,11 @@ interface InitDevframeOptions {
    */
   base: string;
   /**
-   * Override `def.cli?.distDir`. When neither is set — or `false` is passed
-   * to suppress the definition's own `distDir` — the handler runs in
-   * **bridge mode**: only `__connection.json`, the WS endpoint, and the MCP
-   * route (when enabled) are served; the SPA is hosted elsewhere.
+   * Override the definition's `clientAssets` (or deprecated `cli.distDir`).
+   * When neither is set — or `false` is passed to suppress the definition's
+   * own client assets — the handler runs in **bridge mode**: only
+   * `__connection.json`, the WS endpoint, and the MCP route (when enabled) are
+   * served; the SPA is hosted elsewhere.
    */
   distDir?: StaticAssetsSource | false;
   /**

package/dist/adapters/initiate.mjs

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

package/dist/adapters/mcp.d.mts

@@ -1,4 +1,4 @@
-import { F as DevframeDefinition, o as DevframeNodeContext } from "../context-_i51nYOs.mjs";
+import { F as DevframeDefinition, o as DevframeNodeContext } from "../context-BhBzOXVa.mjs";
 import { H3 } from "h3";
 import "@modelcontextprotocol/server";
 //#region src/adapters/mcp/build-server.d.ts
@@ -56,49 +56,53 @@ interface CreateMcpFetchHandlerOptions {
 }
 interface McpFetchHandler {
   /**
-   * WHATWG-`fetch` handler for the MCP Streamable-HTTP endpoint. Hand every
-   * method (POST/GET/DELETE) on the endpoint's path to it — routing by path
-   * is the host's job.
+   * WHATWG-`fetch` handler for the MCP endpoint. Hand every method
+   * (POST/GET/DELETE) on the endpoint's path to it — routing by path is the
+   * host's job.
    */
   fetch: (request: Request) => Promise<Response>;
-  /** Tear down every live MCP session (closes servers, drops subscriptions). */
+  /** Tear down the handler (aborts in-flight exchanges, drops the change bridge). */
   dispose: () => Promise<void>;
 }
 /**
- * Build a framework-agnostic MCP Streamable-HTTP endpoint over a devframe
- * context: a web-standard `Request → Response` handler any host can mount —
- * h3 (see `mountMcpHttp`), a Next.js App Router route, or any other
- * fetch-shaped server.
+ * Build a framework-agnostic MCP endpoint over a devframe context: a
+ * web-standard `Request → Response` handler any host can mount — h3 (see
+ * `mountMcpHttp`), a Next.js App Router route, or any other fetch-shaped
+ * server.
  *
- * Each MCP session gets its own {@link WebStandardStreamableHTTPServerTransport}
- * and MCP server (built from the shared, live `ctx` via
- * `buildMcpServerFromContext`), correlated by the `Mcp-Session-Id` header: an
- * `initialize` POST spins up a session; later requests route to it; a `DELETE`
- * (or client disconnect) tears it down. The origin gate guards every request:
- * 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.
+ * The endpoint is **stateless**: it serves the 2026-07-28 revision per request
+ * through the SDK's {@link createMcpHandler}, which builds a fresh MCP server
+ * (from the shared, live `ctx` via `buildMcpServerFromContext`) for each
+ * request — no `Mcp-Session-Id` registry, no session-local routing, no
+ * GET/DELETE teardown protocol. 2025-era clients are still served through the
+ * SDK's default stateless legacy path. `list_changed` events reach modern
+ * `subscriptions/listen` streams through the handler's `notify` bus.
+ *
+ * The origin gate guards every request: 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.
  */
 declare function createMcpFetchHandler(ctx: DevframeNodeContext, options: CreateMcpFetchHandlerOptions): McpFetchHandler;
 //#endregion
 //#region src/adapters/mcp/http.d.ts
 interface MountMcpHttpOptions extends CreateMcpFetchHandlerOptions {}
 interface MountedMcpHttp {
-  /** Tear down every live MCP session (closes servers, drops subscriptions). */
+  /** Tear down the MCP handler (aborts in-flight exchanges, drops the change bridge). */
   dispose: () => Promise<void>;
 }
 /**
- * Mount an MCP Streamable-HTTP endpoint on an h3 app at `path` — the h3
- * binding over {@link createMcpFetchHandler}, which owns the sessions, the
+ * Mount a stateless MCP endpoint on an h3 app at `path` — the h3 binding over
+ * {@link createMcpFetchHandler}, which owns the per-request serving, the
  * origin gate, and the transport plumbing.
  *
  * The handler is web-standard — it takes the h3 event's web `Request` and
- * returns a web `Response` (an SSE `ReadableStream` body for the
- * server→client stream). We copy that response onto `event.res` and return
- * its body rather than returning the `Response` object directly, so a
- * 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).
+ * returns a web `Response` (an SSE `ReadableStream` body for a
+ * `subscriptions/listen` stream). We copy that response onto `event.res` and
+ * return its body rather than returning the `Response` object directly, so an
+ * MCP error response (e.g. a 4xx) 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).
  */
 declare function mountMcpHttp(app: H3, ctx: DevframeNodeContext, path: string, options: MountMcpHttpOptions): MountedMcpHttp;
 //#endregion