devframe 0.7.13 → 0.7.15

package/dist/adapters/build.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-DfzYvlKI.mjs";
+import { r as DevframeDefinition } from "../devframe-BADsX91-.mjs";
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {
   /** Output directory. Defaults to `dist-static`. */

package/dist/adapters/build.mjs

@@ -2,7 +2,7 @@ import { t as collectStaticRpcDump } from "../dump-Cz7yVvsB.mjs";
 import { n as colors } from "../diagnostics-reporter-CsIG85Q5.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
 import { n as strictJsonStringify } from "../serialization-DpLXCy13.mjs";
-import { n as structuredCloneStringify } from "../structured-clone-XpHLZ8nr.mjs";
+import { n as structuredCloneStringify } from "../structured-clone-CbAV5rFI.mjs";
 import { n as createHostContext, t as createH3DevframeHost } from "../host-h3-SjwRTwkE.mjs";
 import { n as resolveBasePath } from "../_shared-bWRzeSa0.mjs";
 import { existsSync } from "node:fs";

package/dist/adapters/cac.d.mts

@@ -1,4 +1,4 @@
-import { Ft as parseCliFlags, Mt as CliFlagsSchema, Nt as InferCliFlags, Pt as defineCliFlags, r as DevframeDefinition } from "../devframe-DfzYvlKI.mjs";
+import { Ft as parseCliFlags, Mt as CliFlagsSchema, Nt as InferCliFlags, Pt as defineCliFlags, r as DevframeDefinition } from "../devframe-BADsX91-.mjs";
 import { CAC } from "cac";
 import { H3 } from "h3";
 //#region src/adapters/cac.d.ts

package/dist/adapters/cac.mjs

@@ -1,2 +1,2 @@
-import { n as defineCliFlags, r as parseCliFlags, t as createCac } from "../cac-Drj5sjnU.mjs";
+import { n as defineCliFlags, r as parseCliFlags, t as createCac } from "../cac-CjF0haJ6.mjs";
 export { createCac, defineCliFlags, parseCliFlags };

package/dist/adapters/cli.d.mts

@@ -1,4 +1,4 @@
-import { Ft as parseCliFlags, Mt as CliFlagsSchema, Nt as InferCliFlags, Pt as defineCliFlags } from "../devframe-DfzYvlKI.mjs";
+import { Ft as parseCliFlags, Mt as CliFlagsSchema, Nt as InferCliFlags, Pt as defineCliFlags } from "../devframe-BADsX91-.mjs";
 import { CacHandle, CreateCacOptions, createCac } from "./cac.mjs";
 //#region src/adapters/cli.d.ts
 /** @deprecated Use `createCac` from `devframe/adapters/cac` instead. */

package/dist/adapters/cli.mjs

@@ -1,4 +1,4 @@
-import { n as defineCliFlags, r as parseCliFlags, t as createCac } from "../cac-Drj5sjnU.mjs";
+import { n as defineCliFlags, r as parseCliFlags, t as createCac } from "../cac-CjF0haJ6.mjs";
 //#region src/adapters/cli.ts
 /** @deprecated Use `createCac` from `devframe/adapters/cac` instead. */
 const createCli = createCac;

package/dist/adapters/dev.d.mts

@@ -1,5 +1,5 @@
-import { d as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition, u as DevframeWsOptions } from "../devframe-DfzYvlKI.mjs";
-import { n as StartedServer } from "../server-Bf27EWpv.mjs";
+import { _ as ConnectionMeta, d as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition, u as DevframeWsOptions } from "../devframe-BADsX91-.mjs";
+import { n as StartedServer } from "../server-Bu5iB3aV.mjs";
 import { H3 } from "h3";
 //#region src/adapters/dev.d.ts
 interface CreateDevServerOptions {
@@ -111,5 +111,20 @@ declare function resolveDevServerPort(def: DevframeDefinition, options?: Resolve
  * `dev` / `build` / `mcp` shell, reach for {@link createCac} instead.
  */
 declare function createDevServer(def: DevframeDefinition, options?: CreateDevServerOptions): Promise<StartedServer>;
+/**
+ * Resolve the `mcp` entry a `__connection.json` should advertise for a dev
+ * server started with the given `mcp` option (falling back to `def.cli?.mcp`,
+ * exactly like {@link createDevServer}), or `undefined` when the route is
+ * disabled.
+ *
+ * Hosted bridges that hand-roll their connection meta (`viteDevBridge`,
+ * `@devframes/next`'s handler) pass the side-car `port`: the advertised path
+ * becomes absolute (the side-car mounts at `/`) 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
-export { CreateDevServerOptions, ResolveDevServerPortOptions, createDevServer, resolveDevServerPort };
+export { CreateDevServerOptions, ResolveDevServerPortOptions, createDevServer, resolveDevServerPort, resolveMcpConnectionMeta };

package/dist/adapters/dev.mjs

@@ -1,2 +1,2 @@
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-BdegDQKt.mjs";
-export { createDevServer, resolveDevServerPort };
+import { n as resolveDevServerPort, r as resolveMcpConnectionMeta, t as createDevServer } from "../dev-OJFr4rx8.mjs";
+export { createDevServer, resolveDevServerPort, resolveMcpConnectionMeta };

package/dist/adapters/embedded.d.mts

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

package/dist/adapters/mcp.d.mts

@@ -1,10 +1,12 @@
-import { r as DevframeDefinition } from "../devframe-DfzYvlKI.mjs";
+import { r as DevframeDefinition } from "../devframe-BADsX91-.mjs";
 import "@modelcontextprotocol/sdk/server/index.js";
 //#region src/adapters/mcp/build-server.d.ts
 interface CreateMcpServerOptions {
   /**
-   * Transport to use. Only `'stdio'` is implemented today; HTTP support
-   * is planned in a follow-up PR.
+   * Transport to use. `createMcpServer` itself runs `'stdio'` (a standalone
+   * process with its own host context); the Streamable-HTTP transport is
+   * served route-based by the dev server instead — see `mountMcpHttp` and
+   * the `mcp` option on `createDevServer` / `createCac`'s `--mcp` flag.
    */
   transport?: 'stdio';
   /**

package/dist/adapters/mcp.mjs

@@ -1,2 +1,2 @@
-import { n as createMcpServer } from "../build-server-CBAxmnC8.mjs";
+import { n as createMcpServer } from "../build-server-cANnMwg0.mjs";
 export { createMcpServer };

package/dist/{build-server-CBAxmnC8.mjs → build-server-cANnMwg0.mjs}

@@ -1,5 +1,6 @@
 import { a as diagnostics } from "./storage-D_Xy9v1l.mjs";
 import { n as createHostContext } from "./host-h3-SjwRTwkE.mjs";
+import { Diagnostic } from "nostics";
 import { join } from "pathe";
 import process from "node:process";
 import { homedir } from "node:os";
@@ -59,11 +60,21 @@ function stringifyForMcp(value) {
 	}, 2);
 }
 /**
-* Format a thrown value for an MCP `isError` text payload. Surfaces the
-* `Error.name`/`message`, and one level of `cause.message` so context
-* isn't dropped silently.
+* Format a thrown value for an MCP `isError` text payload.
+*
+* A nostics `Diagnostic` (every coded devframe error) becomes structured
+* JSON — `{ error: { code, message, fix?, docs? } }` — so an agent receives
+* the actionable next step (`fix`) and the docs URL instead of a bare
+* message string. Other errors surface `Error.name`/`message`, plus one
+* level of `cause.message` so context isn't dropped silently.
 */
 function formatMcpError(error) {
+	if (error instanceof Diagnostic) return JSON.stringify({ error: {
+		code: error.code,
+		message: error.message,
+		...error.fix ? { fix: error.fix } : {},
+		...error.docs ? { docs: error.docs } : {}
+	} }, null, 2);
 	if (!(error instanceof Error)) return String(error);
 	const cause = error.cause;
 	const causeText = cause instanceof Error ? ` (cause: ${cause.message})` : cause !== void 0 ? ` (cause: ${String(cause)})` : "";

package/dist/{cac-Drj5sjnU.mjs → cac-CjF0haJ6.mjs}

@@ -1,6 +1,6 @@
 import { n as colors } from "./diagnostics-reporter-CsIG85Q5.mjs";
 import { createBuild } from "./adapters/build.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "./dev-BdegDQKt.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "./dev-OJFr4rx8.mjs";
 import process from "node:process";
 import cac from "cac";
 import { safeParse } from "valibot";

package/dist/client/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as DevframeRpcServerFunctions, F as ScopedSharedStates, I as SettingsForNamespace, J as RpcSharedStateHost, N as ScopedRpcFn, O as DevframeSettings, P as ScopedServerFunctions, Q as DevframeRpcClientFunctions, _ as ConnectionMeta, at as StreamReader, ht as SharedState, kt as EventEmitter, ot as StreamSink, q as RpcSharedStateGetOptions } from "../devframe-DfzYvlKI.mjs";
+import { $ as DevframeRpcServerFunctions, F as ScopedSharedStates, I as SettingsForNamespace, J as RpcSharedStateHost, N as ScopedRpcFn, O as DevframeSettings, P as ScopedServerFunctions, Q as DevframeRpcClientFunctions, _ as ConnectionMeta, at as StreamReader, ht as SharedState, kt as EventEmitter, ot as StreamSink, q as RpcSharedStateGetOptions } from "../devframe-BADsX91-.mjs";
 import { _ as RpcFunctionDefinition, w as RpcFunctionsCollector } from "../types-CrzNxXKq.mjs";
 import { C as RpcCacheManager, w as RpcCacheOptions } from "../index-DgsLFhZg.mjs";
 import { t as WsRpcChannelOptions } from "../ws-client-DSXiI2h7.mjs";

package/dist/client/index.mjs

@@ -2,7 +2,7 @@ import { t as hash } from "../hash-KtDZYXDN.mjs";
 import { colors } from "../utils/colors.mjs";
 import { createEventEmitter } from "../utils/events.mjs";
 import { t as createSharedState } from "../shared-state-6kHolYZy.mjs";
-import { i as structuredCloneStringify, n as structuredCloneParse, t as structuredCloneDeserialize } from "../structured-clone-CeZOHvkd.mjs";
+import { i as structuredCloneStringify, n as structuredCloneParse, t as structuredCloneDeserialize } from "../structured-clone-CgtQ61SA.mjs";
 import { createStreamReader, createStreamSink } from "../utils/streaming-channel.mjs";
 import { promiseWithResolver } from "../utils/promise.mjs";
 import { isQualifiedName, qualifyName } from "../utils/scope.mjs";
@@ -2261,7 +2261,9 @@ async function getDevframeRpcClient(options = {}) {
 	if (!connectionMeta) {
 		const errors = [];
 		for (const base of bases) try {
-			connectionMeta = await fetch(withBase(DEVFRAME_CONNECTION_META_FILENAME, base)).then((r) => r.json());
+			const response = await fetch(withBase(DEVFRAME_CONNECTION_META_FILENAME, base));
+			if (!response.ok) throw new Error(`Failed to fetch connection meta: ${response.status}`);
+			connectionMeta = await response.json();
 			resolvedBaseURL = base;
 			globalThis[CONNECTION_META_KEY] = {
 				...connectionMeta,

package/dist/{context-FonV8enL.d.mts → context-C_bqRR0i.d.mts}

@@ -1,4 +1,4 @@
-import { b as DevframeNodeContext, ht as SharedState } from "./devframe-DfzYvlKI.mjs";
+import { b as DevframeNodeContext, ht as SharedState } from "./devframe-BADsX91-.mjs";
 //#region src/node/hub-internals/context.d.ts
 interface InternalAnonymousAuthStorage {
   trusted: Record<string, {

package/dist/{dev-BdegDQKt.mjs → dev-OJFr4rx8.mjs}

@@ -294,7 +294,7 @@ async function createDevServer(def, options = {}) {
 		const mcpPath = joinURL(basePath, mcpRoute);
 		let mountMcpHttp;
 		try {
-			({mountMcpHttp} = await import("./http-BaCZYhIR.mjs"));
+			({mountMcpHttp} = await import("./http-B2P55ZXg.mjs"));
 		} catch (error) {
 			const reason = error instanceof Error ? error.message : String(error);
 			throw diagnostics.DF0017({
@@ -362,6 +362,29 @@ function resolveMcpConfig(mcp) {
 	return mcp === true ? {} : mcp;
 }
 /**
+* Resolve the `mcp` entry a `__connection.json` should advertise for a dev
+* server started with the given `mcp` option (falling back to `def.cli?.mcp`,
+* exactly like {@link createDevServer}), or `undefined` when the route is
+* disabled.
+*
+* Hosted bridges that hand-roll their connection meta (`viteDevBridge`,
+* `@devframes/next`'s handler) pass the side-car `port`: the advertised path
+* becomes absolute (the side-car mounts at `/`) 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);
+	if (!config) return void 0;
+	const route = withoutLeadingSlash(config.path ?? "__mcp");
+	return port != null ? {
+		path: withLeadingSlash(route),
+		port
+	} : { path: route };
+}
+/**
 * Resolve the three WS connection scenarios from the definition / call-site
 * config into a concrete server bind path, optional dedicated port, and the
 * `__connection.json` descriptor the browser resolves.
@@ -400,4 +423,4 @@ async function maybeOpenBrowser(def, flags, origin, override, authHandler) {
 	} catch {}
 }
 //#endregion
-export { resolveDevServerPort as n, createDevServer as t };
+export { resolveDevServerPort as n, resolveMcpConnectionMeta as r, createDevServer as t };

package/dist/{devframe-DfzYvlKI.d.mts → devframe-BADsX91-.d.mts}

@@ -1319,10 +1319,15 @@ interface ConnectionMeta {
    * (`cli.mcp`). Advertises the MCP Streamable-HTTP route so in-browser
    * tooling (e.g. an MCP inspector) can discover it without guessing the
    * path. `path` is relative to `__connection.json`'s location, like the
-   * WebSocket `path`.
+   * WebSocket `path`. `port` is set when the endpoint lives on a side-car
+   * server on its own port (bridge mode — `viteDevBridge`,
+   * `@devframes/next`): the client combines the page hostname with `port`
+   * and resolves `path` against that origin, mirroring
+   * {@link ConnectionMetaWebsocket.port}.
    */
   mcp?: {
     path: string;
+    port?: number;
   };
   /**
    * Names of RPC functions that have declared `jsonSerializable: true`.

package/dist/helpers/vite.d.mts

@@ -1,4 +1,4 @@
-import { p as DevframeAuthHandler, r as DevframeDefinition } from "../devframe-DfzYvlKI.mjs";
+import { d as McpRouteOptions, p as DevframeAuthHandler, r as DevframeDefinition } from "../devframe-BADsX91-.mjs";
 //#region src/helpers/vite.d.ts
 interface ViteDevBridgeOptions {
   /**
@@ -43,6 +43,19 @@ interface ViteDevBridgeOptions {
    * @default false
    */
   auth?: boolean | DevframeAuthHandler;
+  /**
+   * Expose the side-car's route-based MCP server (Streamable-HTTP) and
+   * advertise it in the bridge's `__connection.json`. Forwarded to
+   * {@link createDevServer}: overrides `def.cli?.mcp`, `undefined` falls
+   * through to it, `false` disables the route regardless. Only applies in
+   * bridge mode (`devMiddleware`); the static-mount mode starts no server.
+   *
+   * The endpoint lives on the side-car's own port, so the advertised meta
+   * carries `{ port, path }` — see `ConnectionMeta['mcp']`.
+   *
+   * @experimental
+   */
+  mcp?: boolean | McpRouteOptions;
 }
 interface DevframeVitePlugin {
   name: string;

package/dist/helpers/vite.mjs

@@ -2,7 +2,7 @@ import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_WS_ROUTE } from "../constan
 import { a as diagnostics } from "../storage-D_Xy9v1l.mjs";
 import { n as resolveBasePath, t as normalizeBasePath } from "../_shared-bWRzeSa0.mjs";
 import { serveStaticNodeMiddleware } from "../utils/serve-static.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-BdegDQKt.mjs";
+import { n as resolveDevServerPort, r as resolveMcpConnectionMeta, t as createDevServer } from "../dev-OJFr4rx8.mjs";
 import { resolve } from "pathe";
 //#region src/helpers/vite.ts
 /**
@@ -58,7 +58,8 @@ function viteDevBridge(d, options = {}) {
 					port,
 					flags: mw.flags,
 					openBrowser: false,
-					auth: options.auth ?? false
+					auth: options.auth ?? false,
+					mcp: options.mcp
 				});
 			} catch (e) {
 				diagnostics.DF0033({
@@ -68,6 +69,7 @@ function viteDevBridge(d, options = {}) {
 				}, { method: "warn" });
 				return;
 			}
+			const mcpMeta = resolveMcpConnectionMeta(d, options.mcp, port);
 			const metaPath = `${base}${DEVFRAME_CONNECTION_META_FILENAME}`;
 			server.middlewares.use(metaPath, (_req, res) => {
 				res.setHeader("Content-Type", "application/json");
@@ -76,7 +78,8 @@ function viteDevBridge(d, options = {}) {
 					websocket: {
 						port,
 						path: `/${DEVFRAME_WS_ROUTE}`
-					}
+					},
+					...mcpMeta ? { mcp: mcpMeta } : {}
 				}));
 			});
 			server.httpServer?.once("close", () => {

package/dist/{http-BaCZYhIR.mjs → http-B2P55ZXg.mjs}

@@ -1,5 +1,5 @@
 import { isAllowedOrigin } from "./rpc/transports/ws-server.mjs";
-import { t as buildMcpServerFromContext } from "./build-server-CBAxmnC8.mjs";
+import { t as buildMcpServerFromContext } from "./build-server-cANnMwg0.mjs";
 import { randomUUID } from "node:crypto";
 import { defineHandler } from "h3";
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";

package/dist/{index-CxpC1ItQ.d.mts → index-Brcd2V4t.d.mts}

@@ -1,5 +1,5 @@
-import { W as DevframeNodeRpcSession, b as DevframeNodeContext, ht as SharedState } from "./devframe-DfzYvlKI.mjs";
-import { n as InternalAnonymousAuthStorage } from "./context-FonV8enL.mjs";
+import { W as DevframeNodeRpcSession, b as DevframeNodeContext, ht as SharedState } from "./devframe-BADsX91-.mjs";
+import { n as InternalAnonymousAuthStorage } from "./context-C_bqRR0i.mjs";
 //#region src/node/auth/revoke.d.ts
 /**
  * Flip `isTrusted` to false on any live WS clients connected with `token`

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as DevframeRpcServerFunctions, A as DevframeSettingsStore, At as EventUnsubscribe, B as DevframeDefineDiagnosticsOptions, C as DevframeServicesHost, Ct as AgentResourceContent, D as DevframeScopedStreamingHost, Dt as DevframeAgentHost, E as DevframeScopedNodeRpc, Et as AgentToolInput, F as ScopedSharedStates, G as RpcBroadcastOptions, H as DevframeDiagnosticsHost, I as SettingsForNamespace, J as RpcSharedStateHost, K as RpcFunctionsHost, L as DevframeViewHost, M as ScopedClientFunctions, N as ScopedRpcFn, O as DevframeSettings, Ot as DevframeAgentHostEvents, P as ScopedServerFunctions, Q as DevframeRpcClientFunctions, R as DevframeHost, S as DevframeServiceOf, St as AgentResource, T as DevframeScopedNodeContext, Tt as AgentTool, U as DevframeDiagnosticsLogger, V as DevframeDiagnosticsDefinition, W as DevframeNodeRpcSession, X as RpcStreamingChannelOptions, Y as RpcStreamingChannel, Z as RpcStreamingHost, _ as ConnectionMeta, a as DevframeDockDefaults, b as DevframeNodeContext, bt as AgentHandle, c as DevframeSetupInfo, d as McpRouteOptions, et as DevframeRpcSharedStates, f as defineDevframe, g as Thenable, h as PartialWithoutId, i as DevframeDeploymentKind, j as ScopedBroadcastOptions, jt as EventsMap, k as DevframeSettingsRegistry, kt as EventEmitter, l as DevframeSpaOptions, m as EntriesToObject, n as DevframeCliOptions, o as DevframeDuplicationStrategy, q as RpcSharedStateGetOptions, r as DevframeDefinition, s as DevframeRuntime, t as DevframeBrowserContext, u as DevframeWsOptions, v as ConnectionMetaWebsocket, w as DevframeServicesRegistry, wt as AgentResourceInput, x as DevframeServiceId, xt as AgentManifest, y as DevframeCapabilities, z as DevframeStorageScope } from "./devframe-DfzYvlKI.mjs";
+import { $ as DevframeRpcServerFunctions, A as DevframeSettingsStore, At as EventUnsubscribe, B as DevframeDefineDiagnosticsOptions, C as DevframeServicesHost, Ct as AgentResourceContent, D as DevframeScopedStreamingHost, Dt as DevframeAgentHost, E as DevframeScopedNodeRpc, Et as AgentToolInput, F as ScopedSharedStates, G as RpcBroadcastOptions, H as DevframeDiagnosticsHost, I as SettingsForNamespace, J as RpcSharedStateHost, K as RpcFunctionsHost, L as DevframeViewHost, M as ScopedClientFunctions, N as ScopedRpcFn, O as DevframeSettings, Ot as DevframeAgentHostEvents, P as ScopedServerFunctions, Q as DevframeRpcClientFunctions, R as DevframeHost, S as DevframeServiceOf, St as AgentResource, T as DevframeScopedNodeContext, Tt as AgentTool, U as DevframeDiagnosticsLogger, V as DevframeDiagnosticsDefinition, W as DevframeNodeRpcSession, X as RpcStreamingChannelOptions, Y as RpcStreamingChannel, Z as RpcStreamingHost, _ as ConnectionMeta, a as DevframeDockDefaults, b as DevframeNodeContext, bt as AgentHandle, c as DevframeSetupInfo, d as McpRouteOptions, et as DevframeRpcSharedStates, f as defineDevframe, g as Thenable, h as PartialWithoutId, i as DevframeDeploymentKind, j as ScopedBroadcastOptions, jt as EventsMap, k as DevframeSettingsRegistry, kt as EventEmitter, l as DevframeSpaOptions, m as EntriesToObject, n as DevframeCliOptions, o as DevframeDuplicationStrategy, q as RpcSharedStateGetOptions, r as DevframeDefinition, s as DevframeRuntime, t as DevframeBrowserContext, u as DevframeWsOptions, v as ConnectionMetaWebsocket, w as DevframeServicesRegistry, wt as AgentResourceInput, x as DevframeServiceId, xt as AgentManifest, y as DevframeCapabilities, z as DevframeStorageScope } from "./devframe-BADsX91-.mjs";
 import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-CrzNxXKq.mjs";
 import "./index-DgsLFhZg.mjs";
 import { t as DevframeNodeRpcSessionMeta } from "./ws-server-9-wn7MNQ.mjs";

package/dist/node/auth.d.mts

@@ -1,3 +1,3 @@
-import { p as DevframeAuthHandler } from "../devframe-DfzYvlKI.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-CxpC1ItQ.mjs";
+import { p as DevframeAuthHandler } from "../devframe-BADsX91-.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-Brcd2V4t.mjs";
 export { DevframeAuthHandler, buildOtpAuthUrl, exchangeTempAuthCode, getTempAuthCode, refreshTempAuthCode, revokeActiveConnectionsForToken, revokeAuthToken, verifyAuthToken };

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

@@ -1,5 +1,5 @@
-import { i as DevframeDeploymentKind, r as DevframeDefinition } from "../devframe-DfzYvlKI.mjs";
-import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-FonV8enL.mjs";
+import { i as DevframeDeploymentKind, r as DevframeDefinition } from "../devframe-BADsX91-.mjs";
+import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-C_bqRR0i.mjs";
 //#region src/adapters/_shared.d.ts
 /**
  * Resolve the mount base path for a devframe's SPA. Hosted adapters

package/dist/node/index.d.mts

@@ -1,7 +1,7 @@
-import { C as DevframeServicesHost, Ct as AgentResourceContent, Dt as DevframeAgentHost$1, Et as AgentToolInput, H as DevframeDiagnosticsHost$1, J as RpcSharedStateHost, K as RpcFunctionsHost, L as DevframeViewHost$1, O as DevframeSettings, Ot as DevframeAgentHostEvents, R as DevframeHost, S as DevframeServiceOf, St as AgentResource, T as DevframeScopedNodeContext, Tt as AgentTool, U as DevframeDiagnosticsLogger, Z as RpcStreamingHost, b as DevframeNodeContext, bt as AgentHandle, ht as SharedState, kt as EventEmitter, wt as AgentResourceInput, x as DevframeServiceId, xt as AgentManifest } from "../devframe-DfzYvlKI.mjs";
+import { C as DevframeServicesHost, Ct as AgentResourceContent, Dt as DevframeAgentHost$1, Et as AgentToolInput, H as DevframeDiagnosticsHost$1, J as RpcSharedStateHost, K as RpcFunctionsHost, L as DevframeViewHost$1, O as DevframeSettings, Ot as DevframeAgentHostEvents, R as DevframeHost, S as DevframeServiceOf, St as AgentResource, T as DevframeScopedNodeContext, Tt as AgentTool, U as DevframeDiagnosticsLogger, Z as RpcStreamingHost, b as DevframeNodeContext, bt as AgentHandle, ht as SharedState, kt as EventEmitter, wt as AgentResourceInput, x as DevframeServiceId, xt as AgentManifest } from "../devframe-BADsX91-.mjs";
 import { v as RpcFunctionDefinitionAny } from "../types-CrzNxXKq.mjs";
 import "../index-DgsLFhZg.mjs";
-import { n as StartedServer, r as startHttpAndWs, t as StartHttpAndWsOptions } from "../server-Bf27EWpv.mjs";
+import { n as StartedServer, r as startHttpAndWs, t as StartHttpAndWsOptions } from "../server-Bu5iB3aV.mjs";
 import { BirpcGroup } from "birpc";
 //#region src/node/context.d.ts
 interface CreateHostContextOptions {

package/dist/recipes/common-rpc-functions.d.mts

@@ -0,0 +1,118 @@
+import "../devframe-BADsX91-.mjs";
+import { E as Thenable, S as RpcFunctionSetupResult, c as RpcDump, g as RpcFunctionAgentOptions } from "../types-CrzNxXKq.mjs";
+import "../index-DgsLFhZg.mjs";
+import * as v from "valibot";
+//#region src/recipes/common-rpc-functions.d.ts
+/**
+ * Editor commands that `launch-editor` (the library behind
+ * `devframe/utils/launch-editor`) recognizes with a tailored
+ * `file:line:column` invocation. `openInEditor`'s optional second argument
+ * is restricted to this union, so the RPC surface can't be used to spawn an
+ * arbitrary command.
+ */
+type KnownEditor = 'atom' | 'subl' | 'sublime' | 'sublime_text' | 'wstorm' | 'charm' | 'zed' | 'notepad++' | 'vim' | 'mvim' | 'joe' | 'gvim' | 'emacs' | 'emacsclient' | 'rmate' | 'mate' | 'code' | 'code-insiders' | 'codium' | 'vscodium' | 'trae' | 'antigravity' | 'cursor' | 'appcode' | 'clion' | 'idea' | 'phpstorm' | 'pycharm' | 'rubymine' | 'webstorm' | 'goland' | 'rider';
+/** Runtime list of every {@link KnownEditor}, in the order `v.picklist` reports them. */
+declare const KNOWN_EDITORS: KnownEditor[];
+/**
+ * Prebuilt RPC action that opens a file in the user's configured editor.
+ *
+ * Registered name: `devframe:open-in-editor`.
+ *
+ * The optional second argument picks the editor command explicitly (must be
+ * one of {@link KNOWN_EDITORS}); otherwise it's auto-detected per
+ * `devframe/utils/launch-editor`.
+ *
+ * ```ts
+ * import { openInEditor } from 'devframe/recipes/common-rpc-functions'
+ *
+ * defineDevframe({
+ *   id: 'my-tool',
+ *   name: 'My Tool',
+ *   setup(ctx) {
+ *     ctx.rpc.register(openInEditor)
+ *   },
+ * })
+ * ```
+ */
+declare const openInEditor: {
+  name: "devframe:open-in-editor";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args: readonly [v.StringSchema<undefined>, v.OptionalSchema<v.PicklistSchema<KnownEditor[], undefined>, undefined>];
+  returns: v.VoidSchema<undefined>;
+  jsonSerializable?: boolean;
+  agent?: RpcFunctionAgentOptions;
+  setup?: ((context: undefined) => Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], void>>) | undefined;
+  handler?: ((args_0: string, args_1: KnownEditor | undefined) => void) | undefined;
+  dump?: RpcDump<[string, KnownEditor | undefined], void, undefined> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], void>>> | undefined;
+  __promise?: Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], void>> | undefined;
+};
+/**
+ * Prebuilt RPC action that reveals a path in the OS file explorer.
+ *
+ * Registered name: `devframe:open-in-finder`.
+ *
+ * ```ts
+ * import { openInFinder } from 'devframe/recipes/common-rpc-functions'
+ *
+ * ctx.rpc.register(openInFinder)
+ * ```
+ */
+declare const openInFinder: {
+  name: "devframe:open-in-finder";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args: readonly [v.StringSchema<undefined>];
+  returns: v.VoidSchema<undefined>;
+  jsonSerializable?: boolean;
+  agent?: RpcFunctionAgentOptions;
+  setup?: ((context: undefined) => Thenable<RpcFunctionSetupResult<[string], void>>) | undefined;
+  handler?: ((args_0: string) => void) | undefined;
+  dump?: RpcDump<[string], void, undefined> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, Thenable<RpcFunctionSetupResult<[string], void>>> | undefined;
+  __promise?: Thenable<RpcFunctionSetupResult<[string], void>> | undefined;
+};
+/**
+ * Convenience array bundling both helpers so callers can register them
+ * in a single `forEach`.
+ *
+ * ```ts
+ * import { commonRpcFunctions } from 'devframe/recipes/common-rpc-functions'
+ *
+ * commonRpcFunctions.forEach(fn => ctx.rpc.register(fn))
+ * ```
+ */
+declare const commonRpcFunctions: readonly [{
+  name: "devframe:open-in-editor";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args: readonly [v.StringSchema<undefined>, v.OptionalSchema<v.PicklistSchema<KnownEditor[], undefined>, undefined>];
+  returns: v.VoidSchema<undefined>;
+  jsonSerializable?: boolean;
+  agent?: RpcFunctionAgentOptions;
+  setup?: ((context: undefined) => Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], void>>) | undefined;
+  handler?: ((args_0: string, args_1: KnownEditor | undefined) => void) | undefined;
+  dump?: RpcDump<[string, KnownEditor | undefined], void, undefined> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], void>>> | undefined;
+  __promise?: Thenable<RpcFunctionSetupResult<[string, KnownEditor | undefined], void>> | undefined;
+}, {
+  name: "devframe:open-in-finder";
+  type?: "action" | undefined;
+  cacheable?: boolean;
+  args: readonly [v.StringSchema<undefined>];
+  returns: v.VoidSchema<undefined>;
+  jsonSerializable?: boolean;
+  agent?: RpcFunctionAgentOptions;
+  setup?: ((context: undefined) => Thenable<RpcFunctionSetupResult<[string], void>>) | undefined;
+  handler?: ((args_0: string) => void) | undefined;
+  dump?: RpcDump<[string], void, undefined> | undefined;
+  snapshot?: boolean;
+  __cache?: WeakMap<object, Thenable<RpcFunctionSetupResult<[string], void>>> | undefined;
+  __promise?: Thenable<RpcFunctionSetupResult<[string], void>> | undefined;
+}];
+//#endregion
+export { KNOWN_EDITORS, KnownEditor, commonRpcFunctions, openInEditor, openInFinder };

package/dist/recipes/common-rpc-functions.mjs

@@ -0,0 +1,105 @@
+import { n as defineRpcFunction } from "../define-BLWPsH6y.mjs";
+import * as v from "valibot";
+//#region src/recipes/common-rpc-functions.ts
+/** Runtime list of every {@link KnownEditor}, in the order `v.picklist` reports them. */
+const KNOWN_EDITORS = [
+	"atom",
+	"subl",
+	"sublime",
+	"sublime_text",
+	"wstorm",
+	"charm",
+	"zed",
+	"notepad++",
+	"vim",
+	"mvim",
+	"joe",
+	"gvim",
+	"emacs",
+	"emacsclient",
+	"rmate",
+	"mate",
+	"code",
+	"code-insiders",
+	"codium",
+	"vscodium",
+	"trae",
+	"antigravity",
+	"cursor",
+	"appcode",
+	"clion",
+	"idea",
+	"phpstorm",
+	"pycharm",
+	"rubymine",
+	"webstorm",
+	"goland",
+	"rider"
+];
+/**
+* Prebuilt RPC action that opens a file in the user's configured editor.
+*
+* Registered name: `devframe:open-in-editor`.
+*
+* The optional second argument picks the editor command explicitly (must be
+* one of {@link KNOWN_EDITORS}); otherwise it's auto-detected per
+* `devframe/utils/launch-editor`.
+*
+* ```ts
+* import { openInEditor } from 'devframe/recipes/common-rpc-functions'
+*
+* defineDevframe({
+*   id: 'my-tool',
+*   name: 'My Tool',
+*   setup(ctx) {
+*     ctx.rpc.register(openInEditor)
+*   },
+* })
+* ```
+*/
+const openInEditor = defineRpcFunction({
+	name: "devframe:open-in-editor",
+	type: "action",
+	jsonSerializable: true,
+	args: [v.string(), v.optional(v.picklist(KNOWN_EDITORS))],
+	returns: v.void(),
+	async handler(filename, editor) {
+		const { launchEditor } = await import("../utils/launch-editor.mjs");
+		launchEditor(filename, editor);
+	}
+});
+/**
+* Prebuilt RPC action that reveals a path in the OS file explorer.
+*
+* Registered name: `devframe:open-in-finder`.
+*
+* ```ts
+* import { openInFinder } from 'devframe/recipes/common-rpc-functions'
+*
+* ctx.rpc.register(openInFinder)
+* ```
+*/
+const openInFinder = defineRpcFunction({
+	name: "devframe:open-in-finder",
+	type: "action",
+	jsonSerializable: true,
+	args: [v.string()],
+	returns: v.void(),
+	async handler(path) {
+		const { open } = await import("../utils/open.mjs");
+		await open(path);
+	}
+});
+/**
+* Convenience array bundling both helpers so callers can register them
+* in a single `forEach`.
+*
+* ```ts
+* import { commonRpcFunctions } from 'devframe/recipes/common-rpc-functions'
+*
+* commonRpcFunctions.forEach(fn => ctx.rpc.register(fn))
+* ```
+*/
+const commonRpcFunctions = [openInEditor, openInFinder];
+//#endregion
+export { KNOWN_EDITORS, commonRpcFunctions, openInEditor, openInFinder };

package/dist/recipes/interactive-auth.d.mts

@@ -1,5 +1,5 @@
-import { b as DevframeNodeContext, p as DevframeAuthHandler } from "../devframe-DfzYvlKI.mjs";
-import "../index-CxpC1ItQ.mjs";
+import { b as DevframeNodeContext, p as DevframeAuthHandler } from "../devframe-BADsX91-.mjs";
+import "../index-Brcd2V4t.mjs";
 //#region src/recipes/interactive-auth.d.ts
 interface CreateInteractiveAuthOptions {
   /**