devframe 0.7.14 → 0.7.16

package/dist/constants.mjs

@@ -4,6 +4,12 @@ const DEVFRAME_MOUNT_PATH_NO_TRAILING_SLASH = "/__devframe";
 const DEVFRAME_DIRNAME = "__devframe";
 const DEVFRAME_CONNECTION_META_FILENAME = "__connection.json";
 /**
+* Global key holding the serializable connection prepared by
+* `setupDevframeConnection()`. External viewers can use this key to read the
+* connection from another JavaScript realm.
+*/
+const DEVFRAME_CONNECTION_KEY = "__DEVFRAME_CONNECTION__";
+/**
 * Route the WebSocket RPC endpoint is bound to, relative to a devframe's
 * base path. Sits next to `__connection.json` so the deployed SPA can reach
 * it on the same origin it loaded from — the dev server shares one port for
@@ -62,4 +68,4 @@ function isAnonymousRpcMethod(name) {
 	return name.startsWith(ANONYMOUS_RPC_PREFIX);
 }
 //#endregion
-export { ANONYMOUS_RPC_PREFIX, DEVFRAME_AUTH_TOKEN_QUERY_PARAM, DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DIRNAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_DOCK_IMPORTS_VIRTUAL_ID, DEVFRAME_MCP_ROUTE, DEVFRAME_MOUNT_PATH, DEVFRAME_MOUNT_PATH_NO_TRAILING_SLASH, DEVFRAME_OTP_URL_PARAM, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME, DEVFRAME_WS_ROUTE, REMOTE_CONNECTION_KEY, isAnonymousRpcMethod };
+export { ANONYMOUS_RPC_PREFIX, DEVFRAME_AUTH_TOKEN_QUERY_PARAM, DEVFRAME_CONNECTION_KEY, DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DIRNAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_DOCK_IMPORTS_VIRTUAL_ID, DEVFRAME_MCP_ROUTE, DEVFRAME_MOUNT_PATH, DEVFRAME_MOUNT_PATH_NO_TRAILING_SLASH, DEVFRAME_OTP_URL_PARAM, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME, DEVFRAME_WS_ROUTE, REMOTE_CONNECTION_KEY, isAnonymousRpcMethod };

package/dist/{context-FonV8enL.d.mts → context-CzqPrJSz.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-Ckhf3kFw.mjs";
 //#region src/node/hub-internals/context.d.ts
 interface InternalAnonymousAuthStorage {
   trusted: Record<string, {

package/dist/{context-C1Gr2BGB.mjs → context-DY72brRI.mjs}

@@ -1,4 +1,4 @@
-import { t as createStorage } from "./storage-D_Xy9v1l.mjs";
+import { t as createStorage } from "./storage-gEnj9ASQ.mjs";
 import { i as randomToken, n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "./revoke-BtQDKTp7.mjs";
 import { join } from "pathe";
 //#region src/node/hub-internals/context.ts

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

@@ -1,7 +1,7 @@
 import { DEVFRAME_CONNECTION_META_FILENAME } from "./constants.mjs";
-import { a as diagnostics } from "./storage-D_Xy9v1l.mjs";
-import { n as createHostContext, t as createH3DevframeHost } from "./host-h3-SjwRTwkE.mjs";
-import { i as normalizeHttpServerUrl, t as startHttpAndWs } from "./server-BFsuZI9e.mjs";
+import { a as diagnostics } from "./storage-gEnj9ASQ.mjs";
+import { n as createHostContext, t as createH3DevframeHost } from "./host-h3-CgOetlNE.mjs";
+import { i as normalizeHttpServerUrl, t as startHttpAndWs } from "./server-DykHCza_.mjs";
 import { n as resolveBasePath, t as normalizeBasePath } from "./_shared-bWRzeSa0.mjs";
 import { t as open } from "./open-Deb5xmIT.mjs";
 import { mountStaticHandler } from "./utils/serve-static.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-_pPbryTQ.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-Ckhf3kFw.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`.
@@ -1708,6 +1713,16 @@ interface DevframeDefinition {
    * @default 'warn'
    */
   duplicationStrategy?: DevframeDuplicationStrategy;
+  /**
+   * Declares which runtimes meaningfully support this devframe. Consulted
+   * by adapters that can act on a plain `false` before doing any work:
+   * `createCac` skips registering the `build` subcommand entirely when
+   * `capabilities.build` is `false` — useful for a devframe whose value is
+   * inherently live (e.g. it manages real files on disk), so a static
+   * export would only ever produce a broken, write-less shell of the tool.
+   * The `Record<string, boolean>` shape is reserved for finer-grained
+   * sub-capabilities and currently unconsumed by any adapter.
+   */
   capabilities?: {
     dev?: boolean | Record<string, boolean>;
     build?: boolean | Record<string, boolean>;

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-Ckhf3kFw.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

@@ -1,8 +1,8 @@
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_WS_ROUTE } from "../constants.mjs";
-import { a as diagnostics } from "../storage-D_Xy9v1l.mjs";
+import { a as diagnostics } from "../storage-gEnj9ASQ.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-BCeaQuGE.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/{host-h3-SjwRTwkE.mjs → host-h3-CgOetlNE.mjs}

@@ -2,7 +2,7 @@ import { t as devframeReporter } from "./diagnostics-reporter-CsIG85Q5.mjs";
 import { t as diagnostics } from "./diagnostics-BXwBQmoN.mjs";
 import { RpcFunctionsCollectorBase } from "./rpc/index.mjs";
 import { defineRpcFunction } from "./index.mjs";
-import { a as diagnostics$1, i as createEventEmitter, n as createSharedState, r as nanoid, t as createStorage } from "./storage-D_Xy9v1l.mjs";
+import { a as diagnostics$1, i as createEventEmitter, n as createSharedState, r as nanoid, t as createStorage } from "./storage-gEnj9ASQ.mjs";
 import { defineDiagnostics } from "nostics";
 import { isatty } from "node:tty";
 import { formatWithOptions, inspect } from "node:util";

package/dist/{http-BaCZYhIR.mjs → http-_pPbryTQ.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-C7vTKjiQ.mjs";
 import { randomUUID } from "node:crypto";
 import { defineHandler } from "h3";
 import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";

package/dist/{index-CxpC1ItQ.d.mts → index-8dndvIxR.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-Ckhf3kFw.mjs";
+import { n as InternalAnonymousAuthStorage } from "./context-CzqPrJSz.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-Ckhf3kFw.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-Ckhf3kFw.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-8dndvIxR.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-Ckhf3kFw.mjs";
+import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-CzqPrJSz.mjs";
 //#region src/adapters/_shared.d.ts
 /**
  * Resolve the mount base path for a devframe's SPA. Hosted adapters

package/dist/node/hub-internals.mjs

@@ -1,3 +1,3 @@
-import { n as internalContextMap, t as getInternalContext } from "../context-C1Gr2BGB.mjs";
+import { n as internalContextMap, t as getInternalContext } from "../context-DY72brRI.mjs";
 import { n as resolveBasePath, t as normalizeBasePath } from "../_shared-bWRzeSa0.mjs";
 export { getInternalContext, internalContextMap, normalizeBasePath, resolveBasePath };

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-Ckhf3kFw.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-B0wiP_Oi.mjs";
 import { BirpcGroup } from "birpc";
 //#region src/node/context.d.ts
 interface CreateHostContextOptions {

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-import { t as createStorage } from "../storage-D_Xy9v1l.mjs";
-import { a as DevframeViewHost, c as createRpcSharedStateServerHost, i as createNodeSettings, l as DevframeDiagnosticsHost, n as createHostContext, o as DevframeServicesHostImpl, r as createScopedNodeContext, s as createRpcStreamingServerHost, t as createH3DevframeHost, u as DevframeAgentHost } from "../host-h3-SjwRTwkE.mjs";
-import { a as toDialableHost, i as normalizeHttpServerUrl, n as formatHostForUrl, r as isObject, t as startHttpAndWs } from "../server-BFsuZI9e.mjs";
+import { t as createStorage } from "../storage-gEnj9ASQ.mjs";
+import { a as DevframeViewHost, c as createRpcSharedStateServerHost, i as createNodeSettings, l as DevframeDiagnosticsHost, n as createHostContext, o as DevframeServicesHostImpl, r as createScopedNodeContext, s as createRpcStreamingServerHost, t as createH3DevframeHost, u as DevframeAgentHost } from "../host-h3-CgOetlNE.mjs";
+import { a as toDialableHost, i as normalizeHttpServerUrl, n as formatHostForUrl, r as isObject, t as startHttpAndWs } from "../server-DykHCza_.mjs";
 export { DevframeAgentHost, DevframeDiagnosticsHost, DevframeServicesHostImpl, DevframeViewHost, createH3DevframeHost, createHostContext, createNodeSettings, createRpcSharedStateServerHost, createRpcStreamingServerHost, createScopedNodeContext, createStorage, formatHostForUrl, isObject, normalizeHttpServerUrl, startHttpAndWs, toDialableHost };

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

@@ -0,0 +1,118 @@
+import "../devframe-Ckhf3kFw.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-Ckhf3kFw.mjs";
+import "../index-8dndvIxR.mjs";
 //#region src/recipes/interactive-auth.d.ts
 interface CreateInteractiveAuthOptions {
   /**

package/dist/recipes/interactive-auth.mjs

@@ -1,7 +1,7 @@
 import { n as colors } from "../diagnostics-reporter-CsIG85Q5.mjs";
 import { isAnonymousRpcMethod } from "../constants.mjs";
 import { n as defineRpcFunction } from "../define-BLWPsH6y.mjs";
-import { t as getInternalContext } from "../context-C1Gr2BGB.mjs";
+import { t as getInternalContext } from "../context-DY72brRI.mjs";
 import { a as verifyAuthToken, n as exchangeTempAuthCode, r as getTempAuthCode, t as buildOtpAuthUrl } from "../state-WX3HT5a3.mjs";
 import * as v from "valibot";
 //#region src/recipes/interactive-auth.ts

package/dist/recipes/open-helpers.d.mts

@@ -1,104 +1,6 @@
-import "../devframe-DfzYvlKI.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";
+import { commonRpcFunctions, openInEditor, openInFinder } from "./common-rpc-functions.mjs";
 //#region src/recipes/open-helpers.d.ts
-/**
- * Prebuilt RPC action that opens a file in the user's configured editor.
- *
- * Registered name: `devframe:open-in-editor`.
- *
- * ```ts
- * import { openInEditor } from 'devframe/recipes/open-helpers'
- *
- * 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>];
-  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;
-};
-/**
- * Prebuilt RPC action that reveals a path in the OS file explorer.
- *
- * Registered name: `devframe:open-in-finder`.
- *
- * ```ts
- * import { openInFinder } from 'devframe/recipes/open-helpers'
- *
- * 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 { openHelpers } from 'devframe/recipes/open-helpers'
- *
- * openHelpers.forEach(fn => ctx.rpc.register(fn))
- * ```
- */
-declare const openHelpers: readonly [{
-  name: "devframe:open-in-editor";
-  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;
-}, {
-  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;
-}];
+/** @deprecated Use `commonRpcFunctions` from `devframe/recipes/common-rpc-functions` instead. */
+declare const openHelpers: typeof commonRpcFunctions;
 //#endregion
 export { openHelpers, openInEditor, openInFinder };