devframe 1.2.5 → 1.3.0

package/dist/{instance-shell-DmyVIJzj.mjs → instance-shell-CBgy8YzK.mjs}

@@ -1,14 +1,60 @@
 import "./constants.mjs";
 import { r as validateOriginCandidate } from "./origin-DZit9g29.mjs";
-import { t as diagnostics } from "./diagnostics-Cx4_VjlG.mjs";
-import { c as joinURL, d as withoutLeadingSlash, f as withoutTrailingSlash, u as withLeadingSlash } from "./_shared-DlRoV7v3.mjs";
-import { t as getInternalContext } from "./context-CNq7GLeT.mjs";
-import { n as createInteractiveAuth } from "./interactive-auth-FFOGnYIC.mjs";
+import { t as diagnostics } from "./diagnostics-BJjvKfVK.mjs";
+import { c as joinURL, d as withoutLeadingSlash, f as withoutTrailingSlash, u as withLeadingSlash } from "./_shared-C06DH07o.mjs";
+import { t as getInternalContext } from "./context-BY72d2gV.mjs";
+import { n as createInteractiveAuth } from "./interactive-auth-BsqLFXw8.mjs";
 import { createServer } from "node:http";
 import process from "node:process";
 import { isIP } from "node:net";
 import { Server } from "node:tls";
 import { H3, defineHandler, toNodeHandler } from "h3";
+//#region src/node/listen.ts
+function listen(server, port, host) {
+	return new Promise((resolve, reject) => {
+		const onError = (error) => reject(error);
+		server.once("error", onError);
+		server.listen(port, host, () => {
+			server.removeListener("error", onError);
+			resolve();
+		});
+	});
+}
+/** Errors meaning the machine has no such loopback address to bind. */
+const NO_LOOPBACK_ADDRESS = /* @__PURE__ */ new Set(["EADDRNOTAVAIL", "EAFNOSUPPORT"]);
+/** Whether a failed bind means another process holds the port. */
+function isAddressInUse(error) {
+	return error?.code === "EADDRINUSE";
+}
+/**
+* Listen on `host`, and when that is `localhost`, on the other loopback
+* address too. `listen(port, 'localhost')` binds only the first address
+* `localhost` resolves to (`::1` on most current Linux and macOS setups),
+* while a browser dials the page's own hostname, so a page opened on
+* `127.0.0.1` would be refused, or reach another process that holds
+* `127.0.0.1` on the same port. The twin server hands its traffic to
+* `server`. If another process holds the twin address, fail like a taken
+* port (`EADDRINUSE`), so pages on that address never reach a different
+* server. A machine without that address family skips the twin. Resolves to
+* a closer for the twin.
+*/
+async function listenWithLoopbackTwin(server, port, host) {
+	await listen(server, port, host);
+	const bound = server.address();
+	if (host !== "localhost" || !bound || typeof bound === "string") return async () => {};
+	const twin = createServer();
+	twin.on("request", (req, res) => server.emit("request", req, res));
+	twin.on("upgrade", (req, socket, head) => server.emit("upgrade", req, socket, head));
+	try {
+		await listen(twin, bound.port, bound.family === "IPv6" ? "127.0.0.1" : "::1");
+		return () => new Promise((r) => twin.close(() => r()));
+	} catch (error) {
+		if (NO_LOOPBACK_ADDRESS.has(error.code ?? "")) return async () => {};
+		await new Promise((r) => server.close(() => r()));
+		throw error;
+	}
+}
+//#endregion
 //#region src/node/runtime.ts
 /**
 * Detect the current server runtime from its runtime-specific global. The
@@ -86,15 +132,9 @@ async function bindHttpAndWs(options) {
 		ws = transport.ws;
 		closeWs = transport.close;
 	}
+	let closeLoopbackTwin = async () => {};
 	if (ownsHttpServer) try {
-		await new Promise((resolve, reject) => {
-			const onError = (error) => reject(error);
-			httpServer.once("error", onError);
-			httpServer.listen(port, bindHost, () => {
-				httpServer.removeListener("error", onError);
-				resolve();
-			});
-		});
+		closeLoopbackTwin = await listenWithLoopbackTwin(httpServer, port, bindHost);
 	} catch (error) {
 		await closeWs().catch(() => {});
 		throw diagnostics.DF0052({
@@ -128,6 +168,7 @@ async function bindHttpAndWs(options) {
 		async close() {
 			httpServer.off("listening", publishWsEndpoint);
 			await closeWs();
+			await closeLoopbackTwin();
 			if (ownsHttpServer) await new Promise((r) => httpServer.close(() => r()));
 			if (wsUrl && getInternalContext(context).wsEndpoint?.url === wsUrl) getInternalContext(context).setWsEndpoint(void 0);
 		}
@@ -321,7 +362,7 @@ function createInstanceShell(options) {
 		const origin = currentOrigin();
 		if (!cfg || registerPromise || !origin || !meta) return;
 		const resolvedMeta = meta;
-		registerPromise = import("./instance-registry-DFrZdU4B.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
+		registerPromise = import("./instance-registry-vlz81P9X.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
 			let port = 0;
 			try {
 				const url = new URL(origin);
@@ -397,7 +438,7 @@ function createInstanceShell(options) {
 	let resolvedAuth = false;
 	let corePromise;
 	function ensureCore() {
-		corePromise ??= import("./rpc-core-CXgALhUi.mjs").then((n) => n.n).then(({ createContextRpcServer }) => createContextRpcServer({
+		corePromise ??= import("./rpc-core-oXIq2hjO.mjs").then((n) => n.n).then(({ createContextRpcServer }) => createContextRpcServer({
 			context: ctx,
 			auth: resolvedAuth,
 			onPeerConnect: options.onPeerConnect,
@@ -659,4 +700,4 @@ function createInstanceShell(options) {
 	};
 }
 //#endregion
-export { normalizeHttpServerUrl as i, resolveInstanceRegister as n, samePath as r, createInstanceShell as t };
+export { isAddressInUse as a, normalizeHttpServerUrl as i, resolveInstanceRegister as n, listenWithLoopbackTwin as o, samePath as r, createInstanceShell as t };

package/dist/{instance-shell-fl3ir6RC.d.mts → instance-shell-yfm1AYk8.d.mts}

@@ -1,8 +1,8 @@
 import { n as BirpcGroup } from "./index-Bia1vKjL.mjs";
-import { At as DevframeAuthHandler, Ct as DevframeRpcClientFunctions, J as DevframeSseOptions, Y as DevframeWsOptions, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta, wt as DevframeRpcServerFunctions } from "./context-DhycZ2lx.mjs";
+import { It as DevframeAuthHandler, U as DevframeSseOptions, W as DevframeWsOptions, o as DevframeNodeContext, s as DevframeNodeRpcSession, t as ConnectionMeta, vt as DevframeRpcClientFunctions, yt as DevframeRpcServerFunctions } from "./context-Dko5QFWF.mjs";
 import { n as DevframeRpcConnection, t as DevframeNodeRpcSessionMeta } from "./session-r6PDixP6.mjs";
 import { n as WsOriginRegistry } from "./ws-server-y2R76aSW.mjs";
-import "./index-DFPsvDGu.mjs";
+import "./index-BMj-o_sP.mjs";
 import { H3 } from "h3";
 import { NodeAdapter } from "crossws/adapters/node";
 import { Buffer } from "node:buffer";

package/dist/{interactive-auth-FFOGnYIC.mjs → interactive-auth-BsqLFXw8.mjs}

@@ -2,7 +2,7 @@ import { s as colors } from "./nostics-D0PvLZsn.mjs";
 import { n as defineRpcFunction } from "./define-BLWPsH6y.mjs";
 import { isAnonymousRpcMethod } from "./constants.mjs";
 import { a as getTempAuthCodeInfo, n as describeUA, o as refreshTempAuthCode, r as exchangeTempAuthCode, s as verifyAuthToken, t as buildOtpAuthUrl } from "./state-W4wI6X5X.mjs";
-import { t as getInternalContext } from "./context-CNq7GLeT.mjs";
+import { t as getInternalContext } from "./context-BY72d2gV.mjs";
 //#region src/utils/simple-schema.ts
 function ok(value) {
 	return { value };

package/dist/internal/index.d.mts

@@ -1,11 +1,12 @@
 import { t as StandardSchemaV1 } from "../index-CeEtxDmK.mjs";
 import { g as RpcFunctionDefinitionAny } from "../types-BmDbfHCx.mjs";
-import { Bt as AgentTool, Et as DevframeHost, Ft as AgentHandle, Gt as DevframeAgentHostEvents, Ht as AgentToolProvider, It as AgentManifest, Kt as EventEmitter, Lt as AgentResource, Rt as AgentResourceContent, Ut as AgentToolProviderHandle, Vt as AgentToolInput, Wt as DevframeAgentHost$1, o as DevframeNodeContext, zt as AgentResourceInput } from "../context-DhycZ2lx.mjs";
+import { Gt as AgentResourceInput, Ht as AgentManifest, Jt as AgentToolProvider, Kt as AgentTool, Qt as EventEmitter, St as DevframeHost, Ut as AgentResource, Vt as AgentHandle, Wt as AgentResourceContent, Xt as DevframeAgentHost$1, Yt as AgentToolProviderHandle, Zt as DevframeAgentHostEvents, o as DevframeNodeContext, qt as AgentToolInput, xt as BrowserAgentClientInfo } from "../context-Dko5QFWF.mjs";
 import { a as RemoteAssetsStore } from "../remote-assets-eBvSKZMS.mjs";
-import { a as InstanceShellInit, c as StartedServer, d as samePath, f as DevframeInstanceRecord, g as registerDevframeInstance, h as probeDevframeOrigin, i as InstanceShellApi, l as createInstanceShell, m as listLiveDevframeInstances, n as InstanceRegisterConfig, o as InstanceShellInternals, p as DevframeInstanceRegistration, r as InstanceShell, s as InstanceWsTier, t as CreateInstanceShellOptions, u as resolveInstanceRegister } from "../instance-shell-fl3ir6RC.mjs";
-import { i as importAgenticMcp, n as MountMcpHttpOptions, r as MountedMcpHttp, t as AgenticMcpModule } from "../agentic-D61fXLzA.mjs";
-import { a as resolveBasePath, i as normalizeBasePath, n as ResolvedMcpConfig, r as loadAutoMcpAdapter, s as resolveMcpConfig } from "../_shared-NSl4p_om.mjs";
-import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-BcThIWzY.mjs";
+import { a as InstanceShellInit, c as StartedServer, d as samePath, f as DevframeInstanceRecord, g as registerDevframeInstance, h as probeDevframeOrigin, i as InstanceShellApi, l as createInstanceShell, m as listLiveDevframeInstances, n as InstanceRegisterConfig, o as InstanceShellInternals, p as DevframeInstanceRegistration, r as InstanceShell, s as InstanceWsTier, t as CreateInstanceShellOptions, u as resolveInstanceRegister } from "../instance-shell-yfm1AYk8.mjs";
+import { i as importAgenticMcp, n as MountMcpHttpOptions, r as MountedMcpHttp, t as AgenticMcpModule } from "../agentic-D6HePbWg.mjs";
+import { a as resolveBasePath, i as normalizeBasePath, n as ResolvedMcpConfig, r as loadAutoMcpAdapter, s as resolveMcpConfig } from "../_shared-DbO-OtUC.mjs";
+import { t as getMcpContent } from "../mcp-content-wcQxvrrW.mjs";
+import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-BQ1mesqZ.mjs";
 //#region src/agent/stringify.d.ts
 /**
  * JSON-coercing serializer for MCP text payloads.
@@ -63,6 +64,16 @@ export declare function returnToJsonSchema(schema: StandardSchemaV1 | undefined)
  */
 export declare function argsToJsonSchema(args: readonly StandardSchemaV1[] | undefined): unknown;
 //#endregion
+//#region src/node/client-agent.d.ts
+/** Id of the built-in tool listing connected browser tabs (wire name `devframe_agent_list-clients`). */
+export declare const LIST_CLIENTS_TOOL = "devframe:agent:list-clients";
+/** One connected browser tab as reported by {@link LIST_CLIENTS_TOOL}. */
+interface ConnectedClient extends BrowserAgentClientInfo {
+  id: string;
+  connectedAt: number;
+  tools: string[];
+}
+//#endregion
 //#region src/node/diagnostics.d.ts
 /**
  * DF00xx codes are allocated across packages (e.g. @devframes/json-render
@@ -380,6 +391,29 @@ export declare const diagnostics: import("nostics").Diagnostics<{
     }) => string;
     readonly fix: "Install `@devframes/agentic` next to devframe (the MCP adapter and the MCP SDK live there), or remove the explicit `mcp` setting.";
   };
+  readonly DF0081: {
+    readonly why: (p: {
+      name: string;
+      reason: string;
+    }) => string;
+    readonly fix: "Pass `withMcpContent` a non-empty array of `{ type: 'text', text }`, `{ type: 'image', data, mimeType }` or `{ type: 'audio', data, mimeType }` blocks, with string fields and base64 `data`.";
+  };
+  readonly DF0082: {
+    readonly why: (p: {
+      clientId: string;
+      tool: string;
+      live: string[];
+    }) => string;
+    readonly fix: "Re-list the connected clients (`devframe:agent:list-clients`) and retry with a live `client_id`, or omit `client_id` to target the most recently focused tab.";
+  };
+  readonly DF0084: {
+    readonly why: (p: {
+      name: string;
+      uriTemplate: string;
+      reason: string;
+    }) => string;
+    readonly fix: "Use RFC 6570 level 1 only: plain `{name}` expressions made of letters, digits, `_` and `.`, with no operator (`+`, `#`, `/`, `?`, …), modifier (`:n`, `*`) or list of names, and no `{` or `}` outside an expression.";
+  };
 }, readonly [(d: import("nostics").Diagnostic, { method }?: {
   method?: "log" | "warn" | "error";
 }) => void], never>;
@@ -510,4 +544,4 @@ export declare function peekRpcWireFrame(raw: string): {
 /** Convert tool input for a command, whose arguments must be declared. */
 export declare function toolInputToCommandArgs(input: unknown, argumentCount?: number): unknown[];
 //#endregion
-export { type AgenticMcpModule, type ContextRpcServer, type CreateContextRpcServerOptions, type CreateInstanceShellOptions, type DevframeInstanceRecord, type DevframeInstanceRegistration, type InstanceRegisterConfig, type InstanceShell, type InstanceShellApi, type InstanceShellInit, type InstanceShellInternals, type InstanceWsTier, type MountMcpHttpOptions, type MountedMcpHttp, type ResolvedMcpConfig, type RpcWireCodec, type StartedServer, createContextRpcServer, createInstanceShell, importAgenticMcp, listLiveDevframeInstances, loadAutoMcpAdapter, normalizeBasePath, probeDevframeOrigin, registerDevframeInstance, resolveBasePath, resolveInstanceRegister, resolveMcpConfig, samePath };
+export { type AgenticMcpModule, type ConnectedClient, type ContextRpcServer, type CreateContextRpcServerOptions, type CreateInstanceShellOptions, type DevframeInstanceRecord, type DevframeInstanceRegistration, type InstanceRegisterConfig, type InstanceShell, type InstanceShellApi, type InstanceShellInit, type InstanceShellInternals, type InstanceWsTier, type MountMcpHttpOptions, type MountedMcpHttp, type ResolvedMcpConfig, type RpcWireCodec, type StartedServer, createContextRpcServer, createInstanceShell, getMcpContent, importAgenticMcp, listLiveDevframeInstances, loadAutoMcpAdapter, normalizeBasePath, probeDevframeOrigin, registerDevframeInstance, resolveBasePath, resolveInstanceRegister, resolveMcpConfig, samePath };

package/dist/internal/index.mjs

@@ -1,13 +1,14 @@
+import { t as getMcpContent } from "../mcp-content-DN3O212x.mjs";
 import { t as Diagnostic } from "../nostics-D0PvLZsn.mjs";
 import { n as peekRpcWireFrame, t as createRpcWireCodec } from "../wire-codec-B1W3zH3L.mjs";
-import { t as diagnostics } from "../diagnostics-Cx4_VjlG.mjs";
-import { n as toolInputToCommandArgs, t as DevframeAgentHost } from "../host-agent-CJu735ch.mjs";
-import { a as resolveMcpConfig, n as normalizeBasePath, r as resolveBasePath, s as importAgenticMcp, t as loadAutoMcpAdapter } from "../_shared-DlRoV7v3.mjs";
+import { t as diagnostics } from "../diagnostics-BJjvKfVK.mjs";
+import { a as toolInputToCommandArgs, i as DevframeAgentHost, t as LIST_CLIENTS_TOOL } from "../client-agent-DuLhUF6d.mjs";
+import { a as resolveMcpConfig, n as normalizeBasePath, r as resolveBasePath, s as importAgenticMcp, t as loadAutoMcpAdapter } from "../_shared-C06DH07o.mjs";
 import { t as importRuntimeModule } from "../import-runtime-module-BzlEQ9PI.mjs";
 import { t as createH3DevframeHost } from "../host-h3-BROI6SQ4.mjs";
-import { i as registerDevframeInstance, n as listLiveDevframeInstances, r as probeDevframeOrigin } from "../instance-registry-DFrZdU4B.mjs";
-import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, r as samePath, t as createInstanceShell } from "../instance-shell-DmyVIJzj.mjs";
-import { t as createContextRpcServer } from "../rpc-core-CXgALhUi.mjs";
+import { i as registerDevframeInstance, n as listLiveDevframeInstances, r as probeDevframeOrigin } from "../instance-registry-vlz81P9X.mjs";
+import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, r as samePath, t as createInstanceShell } from "../instance-shell-CBgy8YzK.mjs";
+import { t as createContextRpcServer } from "../rpc-core-oXIq2hjO.mjs";
 //#region src/agent/stringify.ts
 /**
 * JSON-coercing serializer for MCP text payloads.
@@ -156,4 +157,4 @@ function argsToJsonSchema(args) {
 	};
 }
 //#endregion
-export { DevframeAgentHost, argsToJsonSchema, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, diagnostics, formatMcpError, importAgenticMcp, importRuntimeModule, listLiveDevframeInstances, loadAutoMcpAdapter, normalizeBasePath, normalizeHttpServerUrl, peekRpcWireFrame, probeDevframeOrigin, registerDevframeInstance, resolveBasePath, resolveInstanceRegister, resolveMcpConfig, returnToJsonSchema, samePath, stringifyForMcp, toolInputToCommandArgs };
+export { DevframeAgentHost, LIST_CLIENTS_TOOL, argsToJsonSchema, createContextRpcServer, createH3DevframeHost, createInstanceShell, createRpcWireCodec, diagnostics, formatMcpError, getMcpContent, importAgenticMcp, importRuntimeModule, listLiveDevframeInstances, loadAutoMcpAdapter, normalizeBasePath, normalizeHttpServerUrl, peekRpcWireFrame, probeDevframeOrigin, registerDevframeInstance, resolveBasePath, resolveInstanceRegister, resolveMcpConfig, returnToJsonSchema, samePath, stringifyForMcp, toolInputToCommandArgs };

package/dist/mcp-content-DN3O212x.mjs

@@ -0,0 +1,40 @@
+//#region src/agent/mcp-content.ts
+/**
+* Registry symbol for the content blocks attached by {@link withMcpContent}.
+* `Symbol.for` keeps the key the same across duplicate copies of devframe.
+*/
+const MCP_CONTENT = Symbol.for("devframe:mcp-content");
+/**
+* Attach MCP content blocks to a tool result, for example an image next to
+* its text. The MCP adapter sends these blocks as the `content` of the
+* `tools/call` result, in place of the default single JSON text block.
+*
+* The blocks are stored under a non-enumerable symbol key, so `value` itself
+* does not change: the RPC transport to the SPA, `returns` validation, and the
+* `structuredContent` of a tool with an output schema all see the plain value
+* and never the (often large) block data.
+*
+* `value` must be an object that is not frozen. Returns `value`.
+*/
+function withMcpContent(value, content) {
+	Object.defineProperty(value, MCP_CONTENT, {
+		value: content,
+		enumerable: false,
+		configurable: true,
+		writable: true
+	});
+	return value;
+}
+/**
+* Read the blocks attached by {@link withMcpContent}, or `undefined` when the
+* value carries none. The value is not validated here; the MCP adapter checks
+* each block before it sends it.
+*
+* @internal
+*/
+function getMcpContent(value) {
+	if (value === null || typeof value !== "object") return void 0;
+	return value[MCP_CONTENT];
+}
+//#endregion
+export { withMcpContent as n, getMcpContent as t };

package/dist/mcp-content-wcQxvrrW.d.mts

@@ -0,0 +1,25 @@
+import { kt as McpContentBlock } from "./context-Dko5QFWF.mjs";
+//#region src/agent/mcp-content.d.ts
+/**
+ * Attach MCP content blocks to a tool result, for example an image next to
+ * its text. The MCP adapter sends these blocks as the `content` of the
+ * `tools/call` result, in place of the default single JSON text block.
+ *
+ * The blocks are stored under a non-enumerable symbol key, so `value` itself
+ * does not change: the RPC transport to the SPA, `returns` validation, and the
+ * `structuredContent` of a tool with an output schema all see the plain value
+ * and never the (often large) block data.
+ *
+ * `value` must be an object that is not frozen. Returns `value`.
+ */
+declare function withMcpContent<T extends object>(value: T, content: readonly McpContentBlock[]): T;
+/**
+ * Read the blocks attached by {@link withMcpContent}, or `undefined` when the
+ * value carries none. The value is not validated here; the MCP adapter checks
+ * each block before it sends it.
+ *
+ * @internal
+ */
+declare function getMcpContent(value: unknown): unknown;
+//#endregion
+export { withMcpContent as n, getMcpContent as t };

package/dist/node/auth.d.mts

@@ -1,3 +1,3 @@
-import { At as DevframeAuthHandler } from "../context-DhycZ2lx.mjs";
-import { a as getTempAuthCodeInfo, c as revokeActiveConnectionsForToken, i as getTempAuthCode, l as revokeAuthToken, n as describeUA, o as refreshTempAuthCode, r as exchangeTempAuthCode, s as verifyAuthToken, t as buildOtpAuthUrl } from "../index-DFPsvDGu.mjs";
+import { It as DevframeAuthHandler } from "../context-Dko5QFWF.mjs";
+import { a as getTempAuthCodeInfo, c as revokeActiveConnectionsForToken, i as getTempAuthCode, l as revokeAuthToken, n as describeUA, o as refreshTempAuthCode, r as exchangeTempAuthCode, s as verifyAuthToken, t as buildOtpAuthUrl } from "../index-BMj-o_sP.mjs";
 export { DevframeAuthHandler, buildOtpAuthUrl, describeUA, exchangeTempAuthCode, getTempAuthCode, getTempAuthCodeInfo, refreshTempAuthCode, revokeActiveConnectionsForToken, revokeAuthToken, verifyAuthToken };

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

@@ -1,3 +1,3 @@
-import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-Bgvuxv1C.mjs";
-import { a as resolveBasePath, i as normalizeBasePath } from "../_shared-NSl4p_om.mjs";
+import { a as internalContextMap, i as getInternalContext, n as InternalAnonymousAuthStorage, r as RemoteTokenRecord, t as DevframeInternalContext } from "../context-eIUOSrKu.mjs";
+import { a as resolveBasePath, i as normalizeBasePath } from "../_shared-DbO-OtUC.mjs";
 export { type DevframeInternalContext, type InternalAnonymousAuthStorage, type RemoteTokenRecord, getInternalContext, internalContextMap, normalizeBasePath, resolveBasePath };

package/dist/node/hub-internals.mjs

@@ -1,3 +1,3 @@
-import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-DlRoV7v3.mjs";
-import { n as internalContextMap, t as getInternalContext } from "../context-CNq7GLeT.mjs";
+import { n as normalizeBasePath, r as resolveBasePath } from "../_shared-C06DH07o.mjs";
+import { n as internalContextMap, t as getInternalContext } from "../context-BY72d2gV.mjs";
 export { getInternalContext, internalContextMap, normalizeBasePath, resolveBasePath };

package/dist/node/index.d.mts

@@ -1,5 +1,5 @@
 import { g as RpcFunctionDefinitionAny } from "../types-BmDbfHCx.mjs";
-import { Et as DevframeHost, k as SharedState, l as RpcFunctionsHost, o as DevframeNodeContext } from "../context-DhycZ2lx.mjs";
+import { St as DevframeHost, k as SharedState, l as RpcFunctionsHost, o as DevframeNodeContext } from "../context-Dko5QFWF.mjs";
 //#region src/node/context.d.ts
 export interface CreateHostContextOptions {
   cwd: string;

package/dist/node/index.mjs

@@ -1,3 +1,3 @@
-import { t as createHostContext } from "../context-BKw9KkCR.mjs";
-import { t as createStorage } from "../storage-DPoitS2X.mjs";
+import { t as createHostContext } from "../context-CmSDJAEI.mjs";
+import { t as createStorage } from "../storage-BzAr-S6I.mjs";
 export { createHostContext, createStorage };

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

@@ -1,5 +1,5 @@
-import { At as DevframeAuthHandler, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "../context-DhycZ2lx.mjs";
-import "../index-DFPsvDGu.mjs";
+import { It as DevframeAuthHandler, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "../context-Dko5QFWF.mjs";
+import "../index-BMj-o_sP.mjs";
 import { ColorFn } from "../utils/colors.mjs";
 //#region src/recipes/interactive-auth.d.ts
 export interface CreateInteractiveAuthOptions {

package/dist/recipes/interactive-auth.mjs

@@ -1,2 +1,2 @@
-import { n as createInteractiveAuth, t as createAuthBanner } from "../interactive-auth-FFOGnYIC.mjs";
+import { n as createInteractiveAuth, t as createAuthBanner } from "../interactive-auth-BsqLFXw8.mjs";
 export { createAuthBanner, createInteractiveAuth };

package/dist/{remote-assets-B9MeWmW6.mjs → remote-assets-DOva7l3s.mjs}

@@ -1,4 +1,4 @@
-import { t as diagnostics } from "./diagnostics-Cx4_VjlG.mjs";
+import { t as diagnostics } from "./diagnostics-BJjvKfVK.mjs";
 import { t as lookup } from "./mrmime-40h5OOIp.mjs";
 import { createRequire } from "node:module";
 import { mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";

package/dist/rpc/transports/ws-bun.d.mts

@@ -1,5 +1,5 @@
 import { n as WsOriginRegistry } from "../../ws-server-y2R76aSW.mjs";
-import { t as ContextRpcServer } from "../../rpc-core-BcThIWzY.mjs";
+import { t as ContextRpcServer } from "../../rpc-core-BQ1mesqZ.mjs";
 //#region src/rpc/transports/ws-bun.d.ts
 export interface AttachBunWsTransportOptions {
   /** Same contract as `WsRpcTransportOptions.allowedOrigins`. */

package/dist/rpc/transports/ws-deno.d.mts

@@ -1,5 +1,5 @@
 import { n as WsOriginRegistry } from "../../ws-server-y2R76aSW.mjs";
-import { t as ContextRpcServer } from "../../rpc-core-BcThIWzY.mjs";
+import { t as ContextRpcServer } from "../../rpc-core-BQ1mesqZ.mjs";
 //#region src/rpc/transports/ws-deno.d.ts
 export interface AttachDenoWsTransportOptions {
   /** Same contract as `WsRpcTransportOptions.allowedOrigins`. */

package/dist/{rpc-core-BcThIWzY.d.mts → rpc-core-BQ1mesqZ.d.mts}

@@ -1,8 +1,8 @@
 import { n as BirpcGroup, o as EventOptions } from "./index-Bia1vKjL.mjs";
-import { At as DevframeAuthHandler, Ct as DevframeRpcClientFunctions, o as DevframeNodeContext, s as DevframeNodeRpcSession, wt as DevframeRpcServerFunctions } from "./context-DhycZ2lx.mjs";
+import { It as DevframeAuthHandler, o as DevframeNodeContext, s as DevframeNodeRpcSession, vt as DevframeRpcClientFunctions, yt as DevframeRpcServerFunctions } from "./context-Dko5QFWF.mjs";
 import { n as DevframeRpcConnection, t as DevframeNodeRpcSessionMeta } from "./session-r6PDixP6.mjs";
 import "./ws-server-y2R76aSW.mjs";
-import "./index-DFPsvDGu.mjs";
+import "./index-BMj-o_sP.mjs";
 //#region src/node/rpc-core.d.ts
 interface CreateContextRpcServerOptions {
   context: DevframeNodeContext;

package/dist/{rpc-core-CXgALhUi.mjs → rpc-core-oXIq2hjO.mjs}

@@ -1,7 +1,7 @@
 import { n as __exportAll } from "./rolldown-runtime-B4iAMlE-.mjs";
 import { n as getRpcResolvedSetupResult, t as getRpcHandler } from "./handler-DmaAfpGq.mjs";
 import { createRpcServer } from "./rpc/server.mjs";
-import { t as diagnostics } from "./diagnostics-Cx4_VjlG.mjs";
+import { t as diagnostics } from "./diagnostics-BJjvKfVK.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/node/rpc-core.ts
 var rpc_core_exports = /* @__PURE__ */ __exportAll({ createContextRpcServer: () => createContextRpcServer });

package/dist/{shared-state-Cow3u-_m.mjs → shared-state-Cc-Jrhma.mjs}

@@ -1,6 +1,6 @@
 import { createEventEmitter } from "./utils/events.mjs";
 import { nanoid } from "./utils/nanoid.mjs";
-//#region ../../node_modules/.pnpm/immer@11.1.21/node_modules/immer/dist/immer.mjs
+//#region ../../node_modules/.pnpm/immer@11.2.3/node_modules/immer/dist/immer.mjs
 var NOTHING = Symbol.for("immer-nothing");
 var DRAFTABLE = Symbol.for("immer-draftable");
 var DRAFT_STATE = Symbol.for("immer-state");
@@ -646,7 +646,9 @@ function currentImpl(value) {
 		copy = shallowCopy(value, state.scope_.immer_.useStrictShallowCopy_);
 		strict = state.scope_.immer_.shouldUseStrictIteration();
 	} else copy = shallowCopy(value, true);
-	each(copy, (key, childValue) => {
+	const source = copy;
+	if (isSet(copy)) copy = /* @__PURE__ */ new Set();
+	each(source, (key, childValue) => {
 		set(copy, key, currentImpl(childValue));
 	}, strict);
 	if (state) state.finalized_ = false;
@@ -674,6 +676,7 @@ function enablePatches() {
 				key = Array.from(setParent.drafts_.keys()).indexOf(state.key_);
 			} else key = state.key_;
 			if (!(isSet2 && parentCopy.size > key || has(parentCopy, key))) return null;
+			if (state.parent_.type_ === 1 && state.parent_.allIndicesReassigned_) return null;
 			path.push(key);
 		}
 		if (state.parent_) return getPath(state.parent_, path);

package/dist/{storage-DPoitS2X.mjs → storage-BzAr-S6I.mjs}

@@ -1,4 +1,4 @@
-import { t as diagnostics } from "./diagnostics-Cx4_VjlG.mjs";
+import { t as diagnostics } from "./diagnostics-BJjvKfVK.mjs";
 import { dirname } from "pathe";
 import { createSharedState } from "devframe/utils/shared-state";
 import fs from "node:fs";

package/dist/types/index.d.mts

@@ -1,6 +1,6 @@
 import { m as RpcFunctionAgentOptions } from "../types-BmDbfHCx.mjs";
-import { $ as DevframeServiceDefinition, B as DevframeDefinition, Bt as AgentTool, Ct as DevframeRpcClientFunctions, Dt as DevframeStorageScope, Et as DevframeHost, F as CreateMcpServerOptions, Ft as AgentHandle, G as DevframeSetupInfo, Gt as DevframeAgentHostEvents, H as DevframeDockDefaults, Ht as AgentToolProvider, I as McpConnectionInfo, It as AgentManifest, J as DevframeSseOptions, Jt as EventsMap, K as DevframeSnapshotRpcEntry, Kt as EventEmitter, L as McpFetchHandler, Lt as AgentResource, Ot as DevframeDiagnosticsHost, P as CreateMcpFetchHandlerOptions, Q as McpSetting, R as McpServerHandle, Rt as AgentResourceContent, St as DevframeViewHost, Tt as DevframeRpcSharedStates, U as DevframeDuplicationStrategy, Ut as AgentToolProviderHandle, V as DevframeDeploymentKind, Vt as AgentToolInput, W as DevframeRpcOptions, Wt as DevframeAgentHost, X as McpAuthorization, Y as DevframeWsOptions, Z as McpRouteOptions, _t as ScopedClientFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeServiceScopeOf, bt as ScopedSharedStates, c as RpcBroadcastOptions, ct as DevframeServicesScopeRegistry, d as RpcSharedStateHost, dt as DevframeScopedNodeRpc, et as DevframeServiceDescriptor, f as RpcStreamingChannel, ft as DevframeScopedStreamingHost, gt as ScopedBroadcastOptions, ht as DevframeSettingsStore, i as DevframeCapabilities, it as DevframeServiceOf, kt as DevframeDiagnosticsLogger, l as RpcFunctionsHost, lt as DevframeServicesState, m as RpcStreamingHost, mt as DevframeSettingsRegistry, n as ConnectionMetaSse, nt as DevframeServiceInput, o as DevframeNodeContext, ot as DevframeServicesHost, p as RpcStreamingChannelOptions, pt as DevframeSettings, q as DevframeSnapshotRpcInputs, qt as EventUnsubscribe, r as ConnectionMetaWebsocket, rt as DevframeServiceMeta, s as DevframeNodeRpcSession, st as DevframeServicesRegistry, t as ConnectionMeta, tt as DevframeServiceId, u as RpcSharedStateGetOptions, ut as DevframeScopedNodeContext, vt as ScopedRpcFn, wt as DevframeRpcServerFunctions, xt as SettingsForNamespace, yt as ScopedServerFunctions, z as DevframeCliOptions, zt as AgentResourceInput } from "../context-DhycZ2lx.mjs";
+import { $ as DevframeServiceOf, $t as EventUnsubscribe, At as McpFetchHandler, B as DevframeSetupInfo, Ct as DevframeStorageScope, Dt as CreateMcpServerOptions, Et as CreateMcpFetchHandlerOptions, F as DevframeDefinition, Ft as McpServerHandle, G as McpAuthorization, Gt as AgentResourceInput, H as DevframeSnapshotRpcInputs, Ht as AgentManifest, I as DevframeDeploymentKind, J as DevframeServiceDefinition, Jt as AgentToolProvider, K as McpRouteOptions, Kt as AgentTool, L as DevframeDockDefaults, Mt as McpResourceTemplateContent, Nt as McpResourceTemplateEntry, Ot as McpConnectionInfo, P as DevframeCliOptions, Pt as McpResourcesChangedHook, Q as DevframeServiceMeta, Qt as EventEmitter, R as DevframeDuplicationStrategy, St as DevframeHost, Tt as DevframeDiagnosticsLogger, U as DevframeSseOptions, Ut as AgentResource, V as DevframeSnapshotRpcEntry, Vt as AgentHandle, W as DevframeWsOptions, Wt as AgentResourceContent, X as DevframeServiceId, Xt as DevframeAgentHost, Y as DevframeServiceDescriptor, Yt as AgentToolProviderHandle, Z as DevframeServiceInput, Zt as DevframeAgentHostEvents, _t as DevframeViewHost, a as DevframeConnectionConfigsRegistry, at as DevframeScopedNodeContext, bt as DevframeRpcSharedStates, c as RpcBroadcastOptions, ct as DevframeSettings, d as RpcSharedStateHost, dt as ScopedBroadcastOptions, en as EventsMap, et as DevframeServiceScopeOf, f as RpcStreamingChannel, ft as ScopedClientFunctions, gt as SettingsForNamespace, ht as ScopedSharedStates, i as DevframeCapabilities, it as DevframeServicesState, jt as McpResourceTemplate, kt as McpContentBlock, l as RpcFunctionsHost, lt as DevframeSettingsRegistry, m as RpcStreamingHost, mt as ScopedServerFunctions, n as ConnectionMetaSse, nt as DevframeServicesRegistry, o as DevframeNodeContext, ot as DevframeScopedNodeRpc, p as RpcStreamingChannelOptions, pt as ScopedRpcFn, q as McpSetting, qt as AgentToolInput, r as ConnectionMetaWebsocket, rt as DevframeServicesScopeRegistry, s as DevframeNodeRpcSession, st as DevframeScopedStreamingHost, t as ConnectionMeta, tt as DevframeServicesHost, u as RpcSharedStateGetOptions, ut as DevframeSettingsStore, vt as DevframeRpcClientFunctions, wt as DevframeDiagnosticsHost, yt as DevframeRpcServerFunctions, z as DevframeRpcOptions } from "../context-Dko5QFWF.mjs";
 import { a as DevframeWsPeer, i as DevframeRpcTransportKind, n as DevframeRpcConnection, r as DevframeRpcConnectionRequest, t as DevframeNodeRpcSessionMeta } from "../session-r6PDixP6.mjs";
 import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "../remote-assets-eBvSKZMS.mjs";
 import { i as DevframeDefineDiagnosticsOptions } from "../nostics-DWvukRwa.mjs";
-export { AgentHandle, AgentManifest, AgentResource, AgentResourceContent, AgentResourceInput, AgentTool, AgentToolInput, AgentToolProvider, AgentToolProviderHandle, ConnectionMeta, ConnectionMetaSse, ConnectionMetaWebsocket, CreateMcpFetchHandlerOptions, CreateMcpServerOptions, DevframeAgentHost, DevframeAgentHostEvents, DevframeCapabilities, DevframeCliOptions, DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, DevframeDefinition, DevframeDeploymentKind, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockDefaults, DevframeDuplicationStrategy, DevframeHost, DevframeNodeContext, DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, DevframeRpcOptions, DevframeRpcServerFunctions, DevframeRpcSharedStates, type DevframeRpcTransportKind, DevframeScopedNodeContext, DevframeScopedNodeRpc, DevframeScopedStreamingHost, DevframeServiceDefinition, DevframeServiceDescriptor, DevframeServiceId, DevframeServiceInput, DevframeServiceMeta, DevframeServiceOf, DevframeServiceScopeOf, DevframeServicesHost, DevframeServicesRegistry, DevframeServicesScopeRegistry, DevframeServicesState, DevframeSettings, DevframeSettingsRegistry, DevframeSettingsStore, DevframeSetupInfo, DevframeSnapshotRpcEntry, DevframeSnapshotRpcInputs, DevframeSseOptions, DevframeStorageScope, DevframeViewHost, DevframeWsOptions, type DevframeWsPeer, EventEmitter, EventUnsubscribe, EventsMap, McpAuthorization, McpConnectionInfo, McpFetchHandler, McpRouteOptions, McpServerHandle, McpSetting, RemoteAssets, RemoteAssetsErrorMessage, RemoteAssetsProvider, RemoteAssetsProviderCustom, RemoteAssetsStore, RpcBroadcastOptions, type RpcFunctionAgentOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, ScopedBroadcastOptions, ScopedClientFunctions, ScopedRpcFn, ScopedServerFunctions, ScopedSharedStates, SettingsForNamespace, StaticAssetsSource };
+export { AgentHandle, AgentManifest, AgentResource, AgentResourceContent, AgentResourceInput, AgentTool, AgentToolInput, AgentToolProvider, AgentToolProviderHandle, ConnectionMeta, ConnectionMetaSse, ConnectionMetaWebsocket, CreateMcpFetchHandlerOptions, CreateMcpServerOptions, DevframeAgentHost, DevframeAgentHostEvents, DevframeCapabilities, DevframeCliOptions, DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, DevframeDefinition, DevframeDeploymentKind, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockDefaults, DevframeDuplicationStrategy, DevframeHost, DevframeNodeContext, DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, DevframeRpcOptions, DevframeRpcServerFunctions, DevframeRpcSharedStates, type DevframeRpcTransportKind, DevframeScopedNodeContext, DevframeScopedNodeRpc, DevframeScopedStreamingHost, DevframeServiceDefinition, DevframeServiceDescriptor, DevframeServiceId, DevframeServiceInput, DevframeServiceMeta, DevframeServiceOf, DevframeServiceScopeOf, DevframeServicesHost, DevframeServicesRegistry, DevframeServicesScopeRegistry, DevframeServicesState, DevframeSettings, DevframeSettingsRegistry, DevframeSettingsStore, DevframeSetupInfo, DevframeSnapshotRpcEntry, DevframeSnapshotRpcInputs, DevframeSseOptions, DevframeStorageScope, DevframeViewHost, DevframeWsOptions, type DevframeWsPeer, EventEmitter, EventUnsubscribe, EventsMap, McpAuthorization, McpConnectionInfo, McpContentBlock, McpFetchHandler, McpResourceTemplate, McpResourceTemplateContent, McpResourceTemplateEntry, McpResourcesChangedHook, McpRouteOptions, McpServerHandle, McpSetting, RemoteAssets, RemoteAssetsErrorMessage, RemoteAssetsProvider, RemoteAssetsProviderCustom, RemoteAssetsStore, RpcBroadcastOptions, type RpcFunctionAgentOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, ScopedBroadcastOptions, ScopedClientFunctions, ScopedRpcFn, ScopedServerFunctions, ScopedSharedStates, SettingsForNamespace, StaticAssetsSource };

package/dist/utils/events.d.mts

@@ -1,4 +1,4 @@
-import { Jt as EventsMap, Kt as EventEmitter } from "../context-DhycZ2lx.mjs";
+import { Qt as EventEmitter, en as EventsMap } from "../context-Dko5QFWF.mjs";
 //#region src/utils/events.d.ts
 /**
  * Create event emitter.

package/dist/utils/remote-assets.mjs

@@ -1,2 +1,2 @@
-import { t as resolveStaticAssetsSource } from "../remote-assets-B9MeWmW6.mjs";
+import { t as resolveStaticAssetsSource } from "../remote-assets-DOva7l3s.mjs";
 export { resolveStaticAssetsSource };

package/dist/utils/shared-state.d.mts

@@ -1,2 +1,2 @@
-import { A as SharedStateEvents, D as ImmutableObject, E as ImmutableMap, M as SharedStatePatch, N as createSharedState, O as ImmutableSet, T as ImmutableArray, j as SharedStateOptions, k as SharedState, w as Immutable } from "../context-DhycZ2lx.mjs";
+import { A as SharedStateEvents, D as ImmutableObject, E as ImmutableMap, M as SharedStatePatch, N as createSharedState, O as ImmutableSet, T as ImmutableArray, j as SharedStateOptions, k as SharedState, w as Immutable } from "../context-Dko5QFWF.mjs";
 export { Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableSet, SharedState, SharedStateEvents, SharedStateOptions, SharedStatePatch, createSharedState };

package/dist/utils/shared-state.mjs

@@ -1,2 +1,2 @@
-import { t as createSharedState } from "../shared-state-Cow3u-_m.mjs";
+import { t as createSharedState } from "../shared-state-Cc-Jrhma.mjs";
 export { createSharedState };

package/dist/utils/streaming-channel.d.mts

@@ -1,2 +1,2 @@
-import { C as createStreamSink, S as createStreamReader, _ as CreateStreamSinkOptions, b as StreamSink, g as CreateStreamReaderOptions, h as BufferedChunk, v as StreamErrorPayload, x as StreamSinkEvents, y as StreamReader } from "../context-DhycZ2lx.mjs";
+import { C as createStreamSink, S as createStreamReader, _ as CreateStreamSinkOptions, b as StreamSink, g as CreateStreamReaderOptions, h as BufferedChunk, v as StreamErrorPayload, x as StreamSinkEvents, y as StreamReader } from "../context-Dko5QFWF.mjs";
 export { BufferedChunk, CreateStreamReaderOptions, CreateStreamSinkOptions, StreamErrorPayload, StreamReader, StreamSink, StreamSinkEvents, createStreamReader, createStreamSink };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "devframe",
   "type": "module",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "description": "Framework for building one portable devtool integration that runs in any viewer.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -77,7 +77,7 @@
     "skills"
   ],
   "peerDependencies": {
-    "@devframes/agentic": "1.2.5",
+    "@devframes/agentic": "1.3.0",
     "cac": "^7.0.0"
   },
   "peerDependenciesMeta": {
@@ -89,18 +89,18 @@
     }
   },
   "dependencies": {
-    "crossws": "^0.4.12",
-    "h3": "^2.0.1",
+    "crossws": "^0.4.15",
+    "h3": "^2.0.7",
     "nostics": "^1.3.0",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@devframes/agentic": "1.2.5",
+    "@devframes/agentic": "1.3.0",
     "@standard-schema/spec": "^1.1.0",
     "birpc": "^4.2.0",
-    "cac": "^7.0.0",
+    "cac": "^7.1.0",
     "get-port-please": "^3.2.0",
-    "immer": "^11.1.21",
+    "immer": "^11.2.3",
     "launch-editor": "^2.14.2",
     "mlly": "^1.8.2",
     "mrmime": "^2.0.1",
@@ -110,7 +110,7 @@
     "perfect-debounce": "^2.1.0",
     "structured-clone-es": "^2.0.1",
     "tinyglobby": "^0.2.17",
-    "tsdown": "^0.23.0",
+    "tsdown": "0.23.0",
     "typescript": "^6.0.3",
     "ua-parser-modern": "^0.1.1",
     "valibot": "^1.5.0",