devframe 0.2.0 → 0.2.1

package/README.md

@@ -1,84 +1,28 @@
 # devframe
 
-Framework- and build-tool-agnostic foundation for building generic DevTools. Define your devtool once — its RPC, its data, its SPA, its CLI shape — and deploy the same definition anywhere through a set of pluggable adapters.
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![bundle][bundle-src]][bundle-href]
+[![JSDocs][jsdocs-src]][jsdocs-href]
+[![License][license-src]][license-href]
 
-Full documentation: [https://devfra.me/](https://devfra.me/).
+Framework-neutral foundation for building generic DevTools.
 
-## Install
+Documentation: [https://devfra.me/](https://devfra.me/).
 
-```sh
-pnpm add devframe
-```
-
-## Hello, Devframe
-
-```ts
-import { defineDevframe, defineRpcFunction } from 'devframe'
-import { createCli } from 'devframe/adapters/cli'
-
-const devframe = defineDevframe({
-  id: 'my-devframe',
-  name: 'My Devframe',
-  setup(ctx) {
-    ctx.rpc.register(defineRpcFunction({
-      name: 'my-devframe:hello',
-      type: 'static',
-      jsonSerializable: true,
-      handler: () => ({ message: 'hello' }),
-    }))
-  },
-})
-
-await createCli(devframe).parse()
-```
-
-## Adapters
-
-| Adapter | Use case |
-|---------|----------|
-| `cli` | Standalone CLI tool with `dev` / `build` / `mcp` subcommands. |
-| `build` | Generates a static, self-contained SPA snapshot. |
-| `vite` | Mounts the devframe into Vite DevTools (or any compatible host) via `@vitejs/devtools-kit`. |
-| `embedded` | Overlays inside another devtool's UI. |
-| `mcp` | Surfaces the devframe's RPC to coding agents over MCP. |
-
-## Agent-Native (experimental)
-
-> [!WARNING]
-> The agent-native surface — the `agent` field on `defineRpcFunction`, `DevToolsAgentHost`, and the `devframe/adapters/mcp` adapter — may change without a major version bump until it stabilizes.
-
-Devframe surfaces a devframe's RPC functions, tools, and resources to coding agents over [MCP](https://modelcontextprotocol.io). Flag an RPC function with `agent: { description }` to expose it, then spin up an MCP server:
-
-```ts
-import { defineDevframe, defineRpcFunction } from 'devframe'
-import { createMcpServer } from 'devframe/adapters/mcp'
-
-const getSummary = defineRpcFunction({
-  name: 'my-plugin:get-summary',
-  type: 'query',
-  agent: {
-    description: 'Return a short summary of the current build state.',
-  },
-  setup: ctx => ({ handler: async () => buildSummary() }),
-})
-
-const devframe = defineDevframe({
-  id: 'my-plugin',
-  setup(ctx) {
-    ctx.rpc.register(getSummary)
-    ctx.agent.registerResource({
-      id: 'latest-build',
-      name: 'Latest build',
-      read: () => ({ text: renderMarkdown(latestBuild) }),
-    })
-  },
-})
-
-await createMcpServer(devframe, { transport: 'stdio' })
-```
+## License
 
-Or via the CLI: `devframe mcp`. `@modelcontextprotocol/sdk` is a peer dependency — add it when you want MCP support. See the [Agent-Native guide](https://devfra.me/guide/agent-native) for the full API and Claude Desktop integration example.
+[MIT](../../LICENSE.md) License © [Anthony Fu](https://github.com/antfu)
 
-## License
+<!-- Badges -->
 
-[MIT](./LICENSE.md)
+[npm-version-src]: https://img.shields.io/npm/v/devframe?style=flat&colorA=080f12&colorB=517158
+[npm-version-href]: https://npmx.dev/package/devframe
+[npm-downloads-src]: https://img.shields.io/npm/dm/devframe?style=flat&colorA=080f12&colorB=517158
+[npm-downloads-href]: https://npmx.dev/package/devframe
+[bundle-src]: https://img.shields.io/bundlephobia/minzip/devframe?style=flat&colorA=080f12&colorB=517158&label=minzip
+[bundle-href]: https://bundlephobia.com/result?p=devframe
+[license-src]: https://img.shields.io/github/license/devframes/devframe.svg?style=flat&colorA=080f12&colorB=517158
+[license-href]: https://github.com/devframes/devframe/blob/main/LICENSE.md
+[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=517158
+[jsdocs-href]: https://www.jsdocs.io/package/devframe

package/dist/adapters/build.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
+import { r as DevframeDefinition } from "../devframe-BXZUBuy6.mjs";
 
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {

package/dist/adapters/build.mjs

@@ -1,11 +1,10 @@
+import { t as collectStaticRpcDump } from "../rpc-BlVCyk9W.mjs";
 import { n as strictJsonStringify } from "../serialization-CwO31axa.mjs";
+import { DEVTOOLS_CONNECTION_META_FILENAME, DEVTOOLS_RPC_DUMP_DIRNAME, DEVTOOLS_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
 import { i as structuredCloneStringify } from "../structured-clone-CD2l4fI3.mjs";
 import { t as colors } from "../colors-DS7k8ljB.mjs";
-import { t as createHostContext } from "../context-BBi2IQDm.mjs";
-import { t as createH3DevToolsHost } from "../host-h3-Dz8YnFgu.mjs";
-import { DEVTOOLS_CONNECTION_META_FILENAME, DEVTOOLS_RPC_DUMP_DIRNAME, DEVTOOLS_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
-import { t as collectStaticRpcDump } from "../static-dump-C67bCuse.mjs";
-import { n as resolveBasePath } from "../_shared-BrKv3CYt.mjs";
+import { n as createHostContext, t as createH3DevToolsHost } from "../host-h3-CpYkiCIU.mjs";
+import { n as resolveBasePath } from "../_shared-C_yZKUmx.mjs";
 import { existsSync } from "node:fs";
 import process from "node:process";
 import { dirname, resolve } from "pathe";

package/dist/adapters/cli.d.mts

@@ -1,4 +1,4 @@
-import { ct as CliFlagsSchema, dt as parseCliFlags, lt as InferCliFlags, r as DevframeDefinition, ut as defineCliFlags } from "../devframe-R5Ex5K5L.mjs";
+import { ct as CliFlagsSchema, dt as parseCliFlags, lt as InferCliFlags, r as DevframeDefinition, ut as defineCliFlags } from "../devframe-BXZUBuy6.mjs";
 import { H3 } from "h3";
 import { CAC } from "cac";
 

package/dist/adapters/cli.mjs

@@ -1,6 +1,6 @@
 import { t as colors } from "../colors-DS7k8ljB.mjs";
 import { createBuild } from "./build.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-CewNNE2R.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-CA0-8Amw.mjs";
 import process from "node:process";
 import cac from "cac";
 import { safeParse } from "valibot";

package/dist/adapters/dev.d.mts

@@ -1,5 +1,5 @@
-import { r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
-import { n as StartedServer } from "../server-DzKz023G.mjs";
+import { r as DevframeDefinition } from "../devframe-BXZUBuy6.mjs";
+import { n as StartedServer } from "../server-CgqyJG9m.mjs";
 import { H3 } from "h3";
 
 //#region src/adapters/dev.d.ts

package/dist/adapters/dev.mjs

@@ -1,2 +1,2 @@
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-CewNNE2R.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-CA0-8Amw.mjs";
 export { createDevServer, resolveDevServerPort };

package/dist/adapters/embedded.d.mts

@@ -1,4 +1,4 @@
-import { d as DevToolsNodeContext, r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
+import { d as DevToolsNodeContext, r as DevframeDefinition } from "../devframe-BXZUBuy6.mjs";
 
 //#region src/adapters/embedded.d.ts
 interface CreateEmbeddedOptions {

package/dist/adapters/mcp.d.mts

@@ -1,7 +1,7 @@
-import { r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
+import { r as DevframeDefinition } from "../devframe-BXZUBuy6.mjs";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 
-//#region src/node/mcp/build-server.d.ts
+//#region src/adapters/mcp/build-server.d.ts
 interface CreateMcpServerOptions {
   /**
    * Transport to use. Only `'stdio'` is implemented today; HTTP support

package/dist/adapters/mcp.mjs

@@ -1,12 +1,76 @@
 import { n as logger } from "../diagnostics-Cg9ycFIM.mjs";
-import { t as createHostContext } from "../context-BBi2IQDm.mjs";
+import { n as createHostContext } from "../host-h3-CpYkiCIU.mjs";
 import { homedir } from "node:os";
 import process from "node:process";
 import { join } from "pathe";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { toJsonSchema } from "@valibot/to-json-schema";
-//#region src/node/mcp/to-json-schema.ts
+//#region src/adapters/mcp/stringify.ts
+/**
+* JSON-coercing serializer for MCP text payloads.
+*
+* MCP carries tool results and resource reads as plain text over a
+* JSON-RPC transport, so we cannot use the `s:`-prefixed structured-clone
+* format the WS RPC transport falls back to for non-JSON values. Instead,
+* we coerce common non-JSON types into JSON-friendly forms so the LLM
+* client sees something useful instead of `[object Object]`.
+*
+* Coercions:
+*   - `BigInt` → `"123n"`
+*   - `Date` → ISO string (via the native `toJSON`)
+*   - `Map` → `{ __type: 'Map', entries: [[k, v], …] }`
+*   - `Set` → `{ __type: 'Set', entries: [v, …] }`
+*   - `Error` → `{ name, message, stack, cause? }` (cause recurses)
+*   - `Function` → `"[Function: name]"`
+*   - `Symbol` → `value.toString()`
+*   - cycles → `"[Circular]"`
+*/
+function stringifyForMcp(value) {
+	if (value === void 0) return "undefined";
+	if (typeof value === "string") return value;
+	const seen = /* @__PURE__ */ new WeakSet();
+	return JSON.stringify(value, (_key, val) => {
+		if (typeof val === "bigint") return `${val}n`;
+		if (val instanceof Error) {
+			const out = {
+				name: val.name,
+				message: val.message,
+				stack: val.stack
+			};
+			if (val.cause !== void 0) out.cause = val.cause;
+			return out;
+		}
+		if (val instanceof Map) return {
+			__type: "Map",
+			entries: [...val.entries()]
+		};
+		if (val instanceof Set) return {
+			__type: "Set",
+			entries: [...val]
+		};
+		if (typeof val === "function") return `[Function: ${val.name || "anonymous"}]`;
+		if (typeof val === "symbol") return val.toString();
+		if (val !== null && typeof val === "object") {
+			if (seen.has(val)) return "[Circular]";
+			seen.add(val);
+		}
+		return val;
+	}, 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.
+*/
+function formatMcpError(error) {
+	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)})` : "";
+	return `${error.name}: ${error.message}${causeText}`;
+}
+//#endregion
+//#region src/adapters/mcp/to-json-schema.ts
 const FALLBACK_OBJECT_SCHEMA = Object.freeze({
 	type: "object",
 	additionalProperties: true
@@ -75,7 +139,7 @@ function isObjectJsonSchema(value) {
 	return !!value && typeof value === "object" && value.type === "object";
 }
 //#endregion
-//#region src/node/mcp/build-server.ts
+//#region src/adapters/mcp/build-server.ts
 /**
 * Wire an MCP {@link Server} to a devframe context. Returns the server
 * plus a disposal function for the subscriptions it sets up. The
@@ -140,7 +204,7 @@ async function createMcpServer(definition, options = {}) {
 		serverVersion: options.serverVersion ?? definition.version ?? "0.0.0",
 		exposeSharedState: options.exposeSharedState ?? true
 	});
-	const { startStdioTransport } = await import("../transports-BnCs4rj9.mjs");
+	const { startStdioTransport } = await import("../transports-BLwT342H.mjs");
 	let stop;
 	try {
 		stop = await startStdioTransport(server);
@@ -166,14 +230,14 @@ function registerToolHandlers(server, ctx) {
 		try {
 			return { content: [{
 				type: "text",
-				text: stringify(await ctx.agent.invoke(name, args ?? {}))
+				text: stringifyForMcp(await ctx.agent.invoke(name, args ?? {}))
 			}] };
 		} catch (error) {
 			return {
 				isError: true,
 				content: [{
 					type: "text",
-					text: `Error invoking "${name}": ${error instanceof Error ? error.message : String(error)}`
+					text: `Error invoking "${name}": ${formatMcpError(error)}`
 				}]
 			};
 		}
@@ -209,13 +273,13 @@ function registerResourceHandlers(server, ctx, exposeSharedState) {
 			return { contents: [{
 				uri,
 				mimeType: content.mimeType ?? "application/json",
-				text: content.text ?? stringify(content.json)
+				text: content.text ?? stringifyForMcp(content.json)
 			}] };
 		}
 		if (parsed.kind === "state") return { contents: [{
 			uri,
 			mimeType: "application/json",
-			text: stringify((await ctx.rpc.sharedState.get(parsed.key)).value())
+			text: stringifyForMcp((await ctx.rpc.sharedState.get(parsed.key)).value())
 		}] };
 		throw new Error(`[devframe/mcp] unknown resource URI "${uri}"`);
 	});
@@ -269,14 +333,5 @@ function parseResourceUri(uri) {
 		key: decoded
 	};
 }
-function stringify(value) {
-	if (value === void 0) return "undefined";
-	if (typeof value === "string") return value;
-	try {
-		return JSON.stringify(value, null, 2);
-	} catch {
-		return String(value);
-	}
-}
 //#endregion
 export { createMcpServer };

package/dist/client/index.d.mts

@@ -1,7 +1,7 @@
-import { T as StreamSink, U as DevToolsRpcClientFunctions, W as DevToolsRpcServerFunctions, at as EventEmitter, g as RpcSharedStateHost, l as ConnectionMeta, w as StreamReader } from "../devframe-R5Ex5K5L.mjs";
-import { m as RpcCacheOptions, p as RpcCacheManager } from "../index-DB2Ie0Or.mjs";
-import { S as RpcFunctionsCollector } from "../types-4rdUEi2R.mjs";
-import { t as WsRpcChannelOptions } from "../ws-client-Bavoya6-.mjs";
+import { T as StreamSink, U as DevToolsRpcClientFunctions, W as DevToolsRpcServerFunctions, at as EventEmitter, g as RpcSharedStateHost, l as ConnectionMeta, w as StreamReader } from "../devframe-BXZUBuy6.mjs";
+import { C as RpcCacheManager, w as RpcCacheOptions } from "../index-BO4daMzR.mjs";
+import { C as RpcFunctionsCollector } from "../types-ip8THGH1.mjs";
+import { t as WsRpcChannelOptions } from "../ws-client-DFUf-xgm.mjs";
 import { BirpcOptions, BirpcReturn } from "birpc";
 
 //#region src/client/rpc-streaming.d.ts

package/dist/client/index.mjs

@@ -1,13 +1,13 @@
 import { t as hash } from "../hash-CIBte1yS.mjs";
-import { l as RpcCacheManager, o as RpcFunctionsCollectorBase } from "../rpc-DAzoVCR0.mjs";
+import { a as reviveDumpError, f as RpcCacheManager, l as RpcFunctionsCollectorBase } from "../rpc-BlVCyk9W.mjs";
+import { DEVTOOLS_CONNECTION_META_FILENAME, DEVTOOLS_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
 import { createRpcClient } from "../rpc/client.mjs";
 import { t as structuredCloneDeserialize } from "../structured-clone-CD2l4fI3.mjs";
 import { createWsRpcChannel } from "../rpc/transports/ws-client.mjs";
 import { createEventEmitter } from "../utils/events.mjs";
 import { t as createSharedState } from "../shared-state-q9-1EOSX.mjs";
 import { createStreamReader, createStreamSink } from "../utils/streaming-channel.mjs";
-import { DEVTOOLS_CONNECTION_META_FILENAME, DEVTOOLS_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
-import { t as humanId } from "../human-id-adtUWQLr.mjs";
+import { t as humanId } from "../human-id-mPh1HcFO.mjs";
 import { promiseWithResolver } from "../utils/promise.mjs";
 //#region src/client/rpc-shared-state.ts
 function createRpcSharedStateClientHost(rpc) {
@@ -111,11 +111,7 @@ function isRecord(value) {
 	return typeof value === "object" && value !== null && ("output" in value || "error" in value);
 }
 function resolveRecordOutput(record) {
-	if (record.error) {
-		const error = new Error(record.error.message);
-		error.name = record.error.name;
-		throw error;
-	}
+	if (record.error) throw reviveDumpError(record.error);
 	return record.output;
 }
 function createStaticRpcCaller(manifest, fetchJson) {

package/dist/{context-DRa0wGsC.d.mts → context-BaX-SZti.d.mts}

@@ -1,4 +1,4 @@
-import { P as SharedState, d as DevToolsNodeContext } from "./devframe-R5Ex5K5L.mjs";
+import { P as SharedState, d as DevToolsNodeContext } from "./devframe-BXZUBuy6.mjs";
 
 //#region src/node/internal/context.d.ts
 interface InternalAnonymousAuthStorage {

package/dist/{dev-CewNNE2R.mjs → dev-CA0-8Amw.mjs}

@@ -1,9 +1,8 @@
-import { t as createHostContext } from "./context-BBi2IQDm.mjs";
-import { t as createH3DevToolsHost } from "./host-h3-Dz8YnFgu.mjs";
-import { t as startHttpAndWs } from "./server-DOk4grlJ.mjs";
 import { DEVTOOLS_CONNECTION_META_FILENAME } from "./constants.mjs";
-import { n as resolveBasePath, t as normalizeBasePath } from "./_shared-BrKv3CYt.mjs";
-import { t as open } from "./open-B2ah1IKK.mjs";
+import { n as createHostContext, t as createH3DevToolsHost } from "./host-h3-CpYkiCIU.mjs";
+import { t as startHttpAndWs } from "./server-G1ymmN3_.mjs";
+import { n as resolveBasePath, t as normalizeBasePath } from "./_shared-C_yZKUmx.mjs";
+import { t as open } from "./open-CWL4Zasd.mjs";
 import { mountStaticHandler } from "./utils/serve-static.mjs";
 import { networkInterfaces } from "node:os";
 import process$1 from "node:process";

package/dist/{devframe-R5Ex5K5L.d.mts → devframe-BXZUBuy6.d.mts}

@@ -1,5 +1,5 @@
-import { f as RpcFunctionsCollectorBase } from "./index-DB2Ie0Or.mjs";
-import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-DjvlwLuM.mjs";
+import { S as RpcFunctionsCollectorBase } from "./index-BO4daMzR.mjs";
+import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-kW8RZXTw.mjs";
 import { Logger, createLogger, defineDiagnostics } from "logs-sdk";
 import { BirpcReturn } from "birpc";
 import { CAC } from "cac";

package/dist/helpers/vite.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
+import { r as DevframeDefinition } from "../devframe-BXZUBuy6.mjs";
 
 //#region src/helpers/vite.d.ts
 interface ViteDevBridgeOptions {

package/dist/helpers/vite.mjs

@@ -1,8 +1,8 @@
-import { n as logger } from "../diagnostics-Cg9ycFIM.mjs";
 import { DEVTOOLS_CONNECTION_META_FILENAME } from "../constants.mjs";
-import { n as resolveBasePath } from "../_shared-BrKv3CYt.mjs";
+import { n as logger } from "../diagnostics-Cg9ycFIM.mjs";
+import { n as resolveBasePath } from "../_shared-C_yZKUmx.mjs";
 import { serveStaticNodeMiddleware } from "../utils/serve-static.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-CewNNE2R.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-CA0-8Amw.mjs";
 import { resolve } from "pathe";
 //#region src/helpers/vite.ts
 /**

package/dist/{context-BBi2IQDm.mjs → host-h3-CpYkiCIU.mjs}

@@ -1,4 +1,4 @@
-import { o as RpcFunctionsCollectorBase } from "./rpc-DAzoVCR0.mjs";
+import { l as RpcFunctionsCollectorBase } from "./rpc-BlVCyk9W.mjs";
 import { r as diagnostics } from "./serialization-CwO31axa.mjs";
 import { defineRpcFunction } from "./index.mjs";
 import { t as colors$1 } from "./colors-DS7k8ljB.mjs";
@@ -11,6 +11,9 @@ import { ansiFormatter } from "logs-sdk/formatters/ansi";
 import { isatty } from "node:tty";
 import { formatWithOptions, inspect } from "node:util";
 import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import process$1 from "node:process";
+import { join } from "pathe";
 //#region src/node/host-agent.ts
 /**
 * Framework-neutral host aggregating the agent-exposed surface of a
@@ -1030,4 +1033,24 @@ async function createHostContext(options) {
 	return context;
 }
 //#endregion
-export { createRpcSharedStateServerHost as a, createRpcStreamingServerHost as i, DevToolsViewHost as n, DevToolsDiagnosticsHost as o, RpcFunctionsHost as r, DevToolsAgentHost as s, createHostContext as t };
+//#region src/node/host-h3.ts
+/**
+* h3-backed {@link DevToolsHost} — used by the standalone CLI adapter.
+*/
+function createH3DevToolsHost(options) {
+	const workspaceRoot = options.workspaceRoot ?? process$1.cwd();
+	return {
+		mountStatic(base, distDir) {
+			return options.mount?.(base, distDir);
+		},
+		resolveOrigin() {
+			return options.origin;
+		},
+		getStorageDir(scope) {
+			const namespace = `.${options.appName}/devtools`;
+			return scope === "workspace" ? join(workspaceRoot, "node_modules", namespace) : join(homedir(), namespace);
+		}
+	};
+}
+//#endregion
+export { createRpcStreamingServerHost as a, DevToolsAgentHost as c, RpcFunctionsHost as i, createHostContext as n, createRpcSharedStateServerHost as o, DevToolsViewHost as r, DevToolsDiagnosticsHost as s, createH3DevToolsHost as t };

package/dist/{index-DB2Ie0Or.d.mts → index-BO4daMzR.d.mts}

@@ -1,4 +1,4 @@
-import { C as RpcReturnSchema, S as RpcFunctionsCollector, b as RpcFunctionSetupResult, c as RpcDumpClientOptions, g as RpcFunctionDefinitionAny, h as RpcFunctionDefinition, i as RpcArgsSchema, l as RpcDumpCollectionOptions, n as BirpcReturn, o as RpcDefinitionsToFunctions, p as RpcDumpStore, x as RpcFunctionType } from "./types-4rdUEi2R.mjs";
+import { C as RpcFunctionsCollector, S as RpcFunctionType, _ as RpcFunctionDefinitionAny, c as RpcDumpClientOptions, g as RpcFunctionDefinition, i as RpcArgsSchema, l as RpcDumpCollectionOptions, m as RpcDumpStore, n as BirpcReturn, o as RpcDefinitionsToFunctions, p as RpcDumpRecordError, w as RpcReturnSchema, x as RpcFunctionSetupResult } from "./types-ip8THGH1.mjs";
 
 //#region src/rpc/cache.d.ts
 interface RpcCacheOptions {
@@ -47,7 +47,7 @@ declare class RpcFunctionsCollectorBase<LocalFunctions extends Record<string, an
 declare function defineRpcFunction<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS>): RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS>;
 declare function createDefineWrapperWithContext<CONTEXT>(): <NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, CONTEXT>) => RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, CONTEXT>;
 //#endregion
-//#region src/rpc/dumps.d.ts
+//#region src/rpc/dump/index.d.ts
 /**
  * Collects pre-computed dumps by executing functions with their defined input combinations.
  * Static functions without dump config automatically get `{ inputs: [[]] }`.
@@ -75,6 +75,54 @@ declare function createClientFromDump<T extends Record<string, any>>(store: RpcD
  */
 declare function getDefinitionsWithDumps<T extends readonly RpcFunctionDefinitionAny[]>(definitions: T): RpcFunctionDefinitionAny[];
 //#endregion
+//#region src/rpc/dump/error.d.ts
+/**
+ * Normalize a thrown value into a plain object suitable for storage in
+ * a dump record. Preserves `message`, `name`, `cause`, and any own
+ * enumerable properties of an `Error` so consumers reading the dump can
+ * reconstruct a richer Error than just `{ message, name }`.
+ *
+ * Non-`Error` throws are wrapped as `{ name: 'Error', message: String(thrown) }`.
+ */
+declare function serializeDumpError(error: unknown): RpcDumpRecordError;
+/**
+ * Inverse of {@link serializeDumpError}: rebuild a thrown `Error` from
+ * the plain object stored in a dump record. Preserves `cause`, restores
+ * the original `name`, and re-attaches any custom own properties.
+ */
+declare function reviveDumpError(stored: RpcDumpRecordError): Error;
+//#endregion
+//#region src/rpc/dump/static.d.ts
+type StaticRpcDumpSerialization = 'json' | 'structured-clone';
+interface StaticRpcDumpManifestStaticEntry {
+  type: 'static';
+  path: string;
+  /** Encoder used when this entry's file was written. Default: `'json'`. */
+  serialization?: StaticRpcDumpSerialization;
+}
+interface StaticRpcDumpManifestQueryEntry {
+  type: 'query';
+  records: Record<string, string>;
+  fallback?: string;
+  /** Encoder used when each record/fallback file was written. Default: `'json'`. */
+  serialization?: StaticRpcDumpSerialization;
+}
+type StaticRpcDumpManifestValue = StaticRpcDumpManifestStaticEntry | StaticRpcDumpManifestQueryEntry | any;
+type StaticRpcDumpManifest = Record<string, StaticRpcDumpManifestValue>;
+interface StaticRpcDumpFile {
+  /** Whether this file was written via `JSON.stringify` or `structured-clone-es.stringify`. */
+  serialization: StaticRpcDumpSerialization;
+  /** Function name the file belongs to — used to scope `DF0019` errors during write. */
+  fnName: string;
+  /** Payload to encode. */
+  data: unknown;
+}
+interface StaticRpcDumpCollection {
+  manifest: StaticRpcDumpManifest;
+  files: Record<string, StaticRpcDumpFile>;
+}
+declare function collectStaticRpcDump(definitions: Iterable<RpcFunctionDefinitionAny>, context: any): Promise<StaticRpcDumpCollection>;
+//#endregion
 //#region src/rpc/handler.d.ts
 declare function getRpcResolvedSetupResult<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, CONTEXT = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, any, any, CONTEXT>, context: CONTEXT): Promise<RpcFunctionSetupResult<ARGS, RETURN>>;
 declare function getRpcHandler<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, CONTEXT = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, any, any, CONTEXT>, context: CONTEXT): Promise<(...args: ARGS) => RETURN>;
@@ -136,4 +184,4 @@ declare function validateDefinitions(definitions: readonly RpcFunctionDefinition
  */
 declare function validateDefinition(definition: RpcFunctionDefinitionAny): void;
 //#endregion
-export { getRpcHandler as a, dumpFunctions as c, defineRpcFunction as d, RpcFunctionsCollectorBase as f, strictJsonStringify as i, getDefinitionsWithDumps as l, RpcCacheOptions as m, validateDefinitions as n, getRpcResolvedSetupResult as o, RpcCacheManager as p, STRUCTURED_CLONE_PREFIX as r, createClientFromDump as s, validateDefinition as t, createDefineWrapperWithContext as u };
+export { RpcCacheManager as C, RpcFunctionsCollectorBase as S, createClientFromDump as _, getRpcHandler as a, createDefineWrapperWithContext as b, StaticRpcDumpFile as c, StaticRpcDumpManifestStaticEntry as d, StaticRpcDumpManifestValue as f, serializeDumpError as g, reviveDumpError as h, strictJsonStringify as i, StaticRpcDumpManifest as l, collectStaticRpcDump as m, validateDefinitions as n, getRpcResolvedSetupResult as o, StaticRpcDumpSerialization as p, STRUCTURED_CLONE_PREFIX as r, StaticRpcDumpCollection as s, validateDefinition as t, StaticRpcDumpManifestQueryEntry as u, dumpFunctions as v, RpcCacheOptions as w, defineRpcFunction as x, getDefinitionsWithDumps as y };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { $ as AgentResourceContent, B as EntriesToObject, G as DevToolsRpcSharedStates, H as Thenable, J as DevToolsDiagnosticsHost, K as DevToolsHost, Q as AgentResource, U as DevToolsRpcClientFunctions, V as PartialWithoutId, W as DevToolsRpcServerFunctions, X as AgentHandle, Y as DevToolsDiagnosticsLogger, Z as AgentManifest, _ as RpcStreamingChannel, a as DevframeRuntime, at as EventEmitter, c as defineDevframe, d as DevToolsNodeContext, et as AgentResourceInput, f as DevToolsNodeRpcSession, g as RpcSharedStateHost, h as RpcSharedStateGetOptions, i as DevframeDeploymentKind, it as DevToolsAgentHostEvents, l as ConnectionMeta, m as RpcFunctionsHost, n as DevframeCliOptions, nt as AgentToolInput, o as DevframeSetupInfo, ot as EventUnsubscribe, p as RpcBroadcastOptions, q as DevToolsDiagnosticsDefinition, r as DevframeDefinition, rt as DevToolsAgentHost, s as DevframeSpaOptions, st as EventsMap, t as DevframeBrowserContext, tt as AgentTool, u as DevToolsCapabilities, v as RpcStreamingChannelOptions, y as RpcStreamingHost, z as DevToolsViewHost } from "./devframe-R5Ex5K5L.mjs";
-import { C as RpcReturnSchema, h as RpcFunctionDefinition, i as RpcArgsSchema, m as RpcFunctionAgentOptions, x as RpcFunctionType } from "./types-4rdUEi2R.mjs";
-import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-DjvlwLuM.mjs";
+import { $ as AgentResourceContent, B as EntriesToObject, G as DevToolsRpcSharedStates, H as Thenable, J as DevToolsDiagnosticsHost, K as DevToolsHost, Q as AgentResource, U as DevToolsRpcClientFunctions, V as PartialWithoutId, W as DevToolsRpcServerFunctions, X as AgentHandle, Y as DevToolsDiagnosticsLogger, Z as AgentManifest, _ as RpcStreamingChannel, a as DevframeRuntime, at as EventEmitter, c as defineDevframe, d as DevToolsNodeContext, et as AgentResourceInput, f as DevToolsNodeRpcSession, g as RpcSharedStateHost, h as RpcSharedStateGetOptions, i as DevframeDeploymentKind, it as DevToolsAgentHostEvents, l as ConnectionMeta, m as RpcFunctionsHost, n as DevframeCliOptions, nt as AgentToolInput, o as DevframeSetupInfo, ot as EventUnsubscribe, p as RpcBroadcastOptions, q as DevToolsDiagnosticsDefinition, r as DevframeDefinition, rt as DevToolsAgentHost, s as DevframeSpaOptions, st as EventsMap, t as DevframeBrowserContext, tt as AgentTool, u as DevToolsCapabilities, v as RpcStreamingChannelOptions, y as RpcStreamingHost, z as DevToolsViewHost } from "./devframe-BXZUBuy6.mjs";
+import { S as RpcFunctionType, g as RpcFunctionDefinition, h as RpcFunctionAgentOptions, i as RpcArgsSchema, w as RpcReturnSchema } from "./types-ip8THGH1.mjs";
+import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-kW8RZXTw.mjs";
 
 //#region src/define.d.ts
 declare const defineRpcFunction: <NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevToolsNodeContext>) => RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevToolsNodeContext>;

package/dist/node/auth.d.mts

@@ -1,5 +1,5 @@
-import { P as SharedState, d as DevToolsNodeContext, f as DevToolsNodeRpcSession } from "../devframe-R5Ex5K5L.mjs";
-import { n as InternalAnonymousAuthStorage } from "../context-DRa0wGsC.mjs";
+import { P as SharedState, d as DevToolsNodeContext, f as DevToolsNodeRpcSession } from "../devframe-BXZUBuy6.mjs";
+import { n as InternalAnonymousAuthStorage } from "../context-BaX-SZti.mjs";
 
 //#region src/node/auth/revoke.d.ts
 /**

package/dist/node/auth.mjs

@@ -1,5 +1,5 @@
-import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "../revoke-DIMz1r7-.mjs";
-import { t as humanId } from "../human-id-adtUWQLr.mjs";
+import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "../revoke-CWSPBbJH.mjs";
+import { t as humanId } from "../human-id-mPh1HcFO.mjs";
 //#region src/node/auth/state.ts
 let pendingAuth = null;
 let tempAuthToken = generateTempId();

package/dist/node/index.d.mts

@@ -1,8 +1,8 @@
-import { $ as AgentResourceContent, J as DevToolsDiagnosticsHost$1, K as DevToolsHost, P as SharedState, Q as AgentResource, U as DevToolsRpcClientFunctions, W as DevToolsRpcServerFunctions, X as AgentHandle, Y as DevToolsDiagnosticsLogger, Z as AgentManifest, at as EventEmitter, d as DevToolsNodeContext, et as AgentResourceInput, f as DevToolsNodeRpcSession, g as RpcSharedStateHost, it as DevToolsAgentHostEvents, m as RpcFunctionsHost$1, nt as AgentToolInput, p as RpcBroadcastOptions, rt as DevToolsAgentHost$1, tt as AgentTool, y as RpcStreamingHost, z as DevToolsViewHost$1 } from "../devframe-R5Ex5K5L.mjs";
-import { f as RpcFunctionsCollectorBase } from "../index-DB2Ie0Or.mjs";
-import { g as RpcFunctionDefinitionAny } from "../types-4rdUEi2R.mjs";
-import { t as DevToolsNodeRpcSessionMeta } from "../ws-server-DjvlwLuM.mjs";
-import { n as StartedServer, r as startHttpAndWs, t as StartHttpAndWsOptions } from "../server-DzKz023G.mjs";
+import { $ as AgentResourceContent, J as DevToolsDiagnosticsHost$1, K as DevToolsHost, P as SharedState, Q as AgentResource, U as DevToolsRpcClientFunctions, W as DevToolsRpcServerFunctions, X as AgentHandle, Y as DevToolsDiagnosticsLogger, Z as AgentManifest, at as EventEmitter, d as DevToolsNodeContext, et as AgentResourceInput, f as DevToolsNodeRpcSession, g as RpcSharedStateHost, it as DevToolsAgentHostEvents, m as RpcFunctionsHost$1, nt as AgentToolInput, p as RpcBroadcastOptions, rt as DevToolsAgentHost$1, tt as AgentTool, y as RpcStreamingHost, z as DevToolsViewHost$1 } from "../devframe-BXZUBuy6.mjs";
+import { S as RpcFunctionsCollectorBase } from "../index-BO4daMzR.mjs";
+import { _ as RpcFunctionDefinitionAny } from "../types-ip8THGH1.mjs";
+import { t as DevToolsNodeRpcSessionMeta } from "../ws-server-kW8RZXTw.mjs";
+import { n as StartedServer, r as startHttpAndWs, t as StartHttpAndWsOptions } from "../server-CgqyJG9m.mjs";
 import { createLogger, defineDiagnostics } from "logs-sdk";
 import { BirpcGroup } from "birpc";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -160,37 +160,6 @@ declare function createRpcSharedStateServerHost(rpc: RpcFunctionsHost$1): RpcSha
  */
 declare function createRpcStreamingServerHost(rpc: RpcFunctionsHost$1): RpcStreamingHost;
 //#endregion
-//#region src/node/static-dump.d.ts
-type StaticRpcDumpSerialization = 'json' | 'structured-clone';
-interface StaticRpcDumpManifestStaticEntry {
-  type: 'static';
-  path: string;
-  /** Encoder used when this entry's file was written. Default: `'json'`. */
-  serialization?: StaticRpcDumpSerialization;
-}
-interface StaticRpcDumpManifestQueryEntry {
-  type: 'query';
-  records: Record<string, string>;
-  fallback?: string;
-  /** Encoder used when each record/fallback file was written. Default: `'json'`. */
-  serialization?: StaticRpcDumpSerialization;
-}
-type StaticRpcDumpManifestValue = StaticRpcDumpManifestStaticEntry | StaticRpcDumpManifestQueryEntry | any;
-type StaticRpcDumpManifest = Record<string, StaticRpcDumpManifestValue>;
-interface StaticRpcDumpFile {
-  /** Whether this file was written via `JSON.stringify` or `structured-clone-es.stringify`. */
-  serialization: StaticRpcDumpSerialization;
-  /** Function name the file belongs to — used to scope `DF0019` errors during write. */
-  fnName: string;
-  /** Payload to encode. */
-  data: unknown;
-}
-interface StaticRpcDumpCollection {
-  manifest: StaticRpcDumpManifest;
-  files: Record<string, StaticRpcDumpFile>;
-}
-declare function collectStaticRpcDump(definitions: Iterable<RpcFunctionDefinitionAny>, context: any): Promise<StaticRpcDumpCollection>;
-//#endregion
 //#region src/node/storage.d.ts
 interface CreateStorageOptions<T extends object> {
   filepath: string;
@@ -204,4 +173,4 @@ declare function createStorage<T extends object>(options: CreateStorageOptions<T
 declare function isObject(value: unknown): value is Record<string, any>;
 declare function normalizeHttpServerUrl(host: string, port: number | string): string;
 //#endregion
-export { CreateH3DevToolsHostOptions, CreateHostContextOptions, CreateStorageOptions, DevToolsAgentHost, DevToolsDiagnosticsHost, DevToolsViewHost, RpcFunctionsHost, StartHttpAndWsOptions, StartedServer, StaticRpcDumpCollection, StaticRpcDumpFile, StaticRpcDumpManifest, StaticRpcDumpManifestQueryEntry, StaticRpcDumpManifestStaticEntry, StaticRpcDumpManifestValue, StaticRpcDumpSerialization, collectStaticRpcDump, createH3DevToolsHost, createHostContext, createRpcSharedStateServerHost, createRpcStreamingServerHost, createStorage, isObject, normalizeHttpServerUrl, startHttpAndWs };
+export { CreateH3DevToolsHostOptions, CreateHostContextOptions, CreateStorageOptions, DevToolsAgentHost, DevToolsDiagnosticsHost, DevToolsViewHost, RpcFunctionsHost, StartHttpAndWsOptions, StartedServer, createH3DevToolsHost, createHostContext, createRpcSharedStateServerHost, createRpcStreamingServerHost, createStorage, isObject, normalizeHttpServerUrl, startHttpAndWs };