devframe 0.9.5 → 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-CsBsnhuO.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-c0OlSc12.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,4 +1,4 @@
-import { F as DevframeDefinition, V as DevframeSnapshotRpcEntry, o as DevframeNodeContext } from "../context-c0OlSc12.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 {

package/dist/adapters/build.mjs

@@ -5,7 +5,7 @@ import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_
 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-Bc5S40Qt.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";

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-c0OlSc12.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-BRQA42Lh.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-c0OlSc12.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-CPuYY8pw.mjs";
-import { a as resolveMcpConnectionMeta, i as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-CsBsnhuO.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 {

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-BRQA42Lh.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-c0OlSc12.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-c0OlSc12.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-CPuYY8pw.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";

package/dist/adapters/initiate.mjs

@@ -1,2 +1,2 @@
-import { n as getInstanceInternals, r as initDevframe } from "../dev-BRQA42Lh.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-c0OlSc12.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