devframe 1.0.0 → 1.1.0

package/dist/adapters/build.mjs

@@ -1,6 +1,6 @@
 import { s as colors } from "../nostics-D0PvLZsn.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
-import { n as collectStaticRpcDump, t as writeStaticRpcDump } from "../write-DoXJzGUH.mjs";
+import { n as collectStaticRpcDump, t as writeStaticRpcDump } from "../write-BWIO0h0Z.mjs";
 import { t as diagnostics } from "../diagnostics-Cx4_VjlG.mjs";
 import { t as createHostContext } from "../context-BqpgC5tq.mjs";
 import { t as resolveStaticAssetsSource } from "../remote-assets-B9MeWmW6.mjs";

package/dist/adapters/cac.mjs

@@ -1,7 +1,7 @@
 import { s as colors } from "../nostics-D0PvLZsn.mjs";
 import { i as resolveDevServerPort, s as importAgenticMcp } from "../_shared-B2PZsp-J.mjs";
 import { createBuild } from "./build.mjs";
-import { t as createDevServer } from "../dev-BTbLJekh.mjs";
+import { t as createDevServer } from "../dev-IkdtaiLZ.mjs";
 import process from "node:process";
 import cac$1 from "cac";
 //#region src/adapters/flags.ts

package/dist/adapters/dev.d.mts

@@ -2,7 +2,7 @@ import { At as DevframeAuthHandler, B as DevframeDefinition, J as DevframeSseOpt
 import { n as DevframeRpcConnection, t as DevframeNodeRpcSessionMeta } from "../session-r6PDixP6.mjs";
 import { o as StaticAssetsSource } from "../remote-assets-eBvSKZMS.mjs";
 import { n as WsOriginRegistry } from "../ws-server-y2R76aSW.mjs";
-import { c as StartedServer } from "../instance-shell-CXnpSuK7.mjs";
+import { c as StartedServer } from "../instance-shell-Cpz5d2CI.mjs";
 import { c as resolveMcpConnectionMeta, o as resolveDevServerPort, t as ResolveDevServerPortOptions } from "../_shared-D1ebaX_J.mjs";
 import { H3 } from "h3";
 //#region src/adapters/dev.d.ts

package/dist/adapters/dev.mjs

@@ -1,3 +1,3 @@
 import { i as resolveDevServerPort, o as resolveMcpConnectionMeta } from "../_shared-B2PZsp-J.mjs";
-import { t as createDevServer } from "../dev-BTbLJekh.mjs";
+import { t as createDevServer } from "../dev-IkdtaiLZ.mjs";
 export { createDevServer, resolveDevServerPort, resolveMcpConnectionMeta };

package/dist/adapters/initiate.d.mts

@@ -2,7 +2,7 @@ import { At as DevframeAuthHandler, B as DevframeDefinition, Dt as DevframeStora
 import { n as DevframeRpcConnection, t as DevframeNodeRpcSessionMeta } from "../session-r6PDixP6.mjs";
 import { o as StaticAssetsSource } from "../remote-assets-eBvSKZMS.mjs";
 import { n as WsOriginRegistry } from "../ws-server-y2R76aSW.mjs";
-import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-CXnpSuK7.mjs";
+import { c as StartedServer, f as DevframeInstanceRecord } from "../instance-shell-Cpz5d2CI.mjs";
 import { H3 } from "h3";
 import { Buffer } from "node:buffer";
 import { IncomingMessage, Server, ServerResponse } from "node:http";

package/dist/adapters/initiate.mjs

@@ -1,2 +1,2 @@
-import { n as getInstanceInternals, r as initDevframe } from "../dev-BTbLJekh.mjs";
+import { n as getInstanceInternals, r as initDevframe } from "../dev-IkdtaiLZ.mjs";
 export { getInstanceInternals, initDevframe };

package/dist/cli/main.mjs

@@ -29,10 +29,11 @@ async function importConnect() {
 */
 async function runDevframeCli(argv = process.argv) {
 	const cli = cac("devframe");
-	cli.command("connect", "Run the devframe MCP connector on stdio (discovers running devframe dev servers and proxies their tools)").option("--port <port>", "Probe an explicit port besides the instance registry (repeatable)").option("--instances-dir <dir>", "Override the instance registry directory (default: ~/.devframe/instances, or $DEVFRAME_INSTANCES_DIR)").option("--timeout <ms>", "Probe timeout per instance in milliseconds", { default: 1e3 }).action(async (options) => {
+	cli.command("connect", "Run the devframe MCP connector on stdio (discovers running devframe dev servers and proxies their tools)").option("--port <port>", "Probe an explicit port besides the instance registry (repeatable)").option("--base <path>", "Base path the --port probes look for __connection.json under, for a devframe mounted below the root (e.g. /__devtools/ for Vite DevTools)", { default: "/" }).option("--instances-dir <dir>", "Override the instance registry directory (default: ~/.devframe/instances, or $DEVFRAME_INSTANCES_DIR)").option("--timeout <ms>", "Probe timeout per instance in milliseconds", { default: 1e3 }).action(async (options) => {
 		const { startConnectServer } = await importConnect();
 		await startConnectServer({
 			ports: parsePortsFlag(options.port),
+			base: typeof options.base === "string" ? options.base : void 0,
 			instancesDir: options.instancesDir,
 			timeoutMs: options.timeout,
 			/**

package/dist/{dev-BTbLJekh.mjs → dev-IkdtaiLZ.mjs}

@@ -4,7 +4,7 @@ import { t as createHostContext } from "./context-BqpgC5tq.mjs";
 import { t as resolveStaticAssetsSource } from "./remote-assets-B9MeWmW6.mjs";
 import { a as resolveMcpConfig, c as joinURL, d as withoutLeadingSlash, i as resolveDevServerPort, l as withBase, n as normalizeBasePath, r as resolveBasePath, s as importAgenticMcp, t as loadAutoMcpAdapter } from "./_shared-B2PZsp-J.mjs";
 import { t as createH3DevframeHost } from "./host-h3-BROI6SQ4.mjs";
-import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, t as createInstanceShell } from "./instance-shell-wC2sfEU_.mjs";
+import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, t as createInstanceShell } from "./instance-shell-kUeR59CR.mjs";
 import { open } from "./utils/open.mjs";
 import { mountStaticHandler } from "./utils/serve-static.mjs";
 import { resolve } from "pathe";

package/dist/{instance-registry-DtvYxc0Y.mjs → instance-registry-C-nC0By7.mjs}

@@ -116,7 +116,9 @@ function originCandidates(origin) {
 * Probe `<origin><basePath>__connection.json`, trying each dialable
 * candidate for the origin (see {@link originCandidates}). The single
 * probe primitive behind both registry liveness checks and the
-* connector's explicit `--port` probes.
+* connector's explicit `--port` probes. A candidate counts only when it
+* answers `2xx` with a JSON object; anything else (an HTML SPA fallback, a
+* JSON array, an unparseable body) is treated as "no devframe here".
 *
 * @internal
 */
@@ -125,9 +127,11 @@ async function probeDevframeOrigin(origin, basePath, timeoutMs) {
 	for (const candidate of originCandidates(origin)) try {
 		const response = await fetch(`${candidate}${base}__connection.json`, { signal: AbortSignal.timeout(timeoutMs ?? 1e3) });
 		if (!response.ok) continue;
+		const meta = await response.json().catch(() => void 0);
+		if (!meta || typeof meta !== "object" || Array.isArray(meta)) continue;
 		return {
 			origin: candidate,
-			meta: await response.json().catch(() => ({}))
+			meta
 		};
 	} catch {}
 	return null;

package/dist/{instance-shell-CXnpSuK7.d.mts → instance-shell-Cpz5d2CI.d.mts}

@@ -74,7 +74,7 @@ declare function registerDevframeInstance(record: DevframeInstanceRecord, option
 interface ProbedDevframeOrigin {
   /** The origin that answered (may be an explicit address family for a `localhost` bind). */
   origin: string;
-  /** The parsed `__connection.json` payload (`{}` when unparseable). */
+  /** The parsed `__connection.json` payload (always a JSON object). */
   meta: {
     mcp?: {
       path: string;
@@ -86,7 +86,9 @@ interface ProbedDevframeOrigin {
  * Probe `<origin><basePath>__connection.json`, trying each dialable
  * candidate for the origin (see {@link originCandidates}). The single
  * probe primitive behind both registry liveness checks and the
- * connector's explicit `--port` probes.
+ * connector's explicit `--port` probes. A candidate counts only when it
+ * answers `2xx` with a JSON object; anything else (an HTML SPA fallback, a
+ * JSON array, an unparseable body) is treated as "no devframe here".
  *
  * @internal
  */

package/dist/{instance-shell-wC2sfEU_.mjs → instance-shell-kUeR59CR.mjs}

@@ -311,7 +311,7 @@ function createInstanceShell(options) {
 		const origin = currentOrigin();
 		if (!cfg || registerPromise || !origin || !meta) return;
 		const resolvedMeta = meta;
-		registerPromise = import("./instance-registry-DtvYxc0Y.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
+		registerPromise = import("./instance-registry-C-nC0By7.mjs").then((n) => n.t).then(({ registerDevframeInstance }) => {
 			let port = 0;
 			try {
 				const url = new URL(origin);

package/dist/internal/index.d.mts

@@ -2,7 +2,7 @@ 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--tVkJw3W.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-CXnpSuK7.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-Cpz5d2CI.mjs";
 import { i as importAgenticMcp, n as MountMcpHttpOptions, r as MountedMcpHttp, t as AgenticMcpModule } from "../agentic-DLqHMOyN.mjs";
 import { a as resolveBasePath, i as normalizeBasePath, n as ResolvedMcpConfig, r as loadAutoMcpAdapter, s as resolveMcpConfig } from "../_shared-D1ebaX_J.mjs";
 import { n as CreateContextRpcServerOptions, r as createContextRpcServer, t as ContextRpcServer } from "../rpc-core-B6n9MQsc.mjs";
@@ -41,6 +41,14 @@ export declare function formatMcpError(error: unknown): string;
 //#region src/agent/to-json-schema.d.ts
 /**
  * JSON Schema for an RPC return value on the agent/MCP surface.
+ *
+ * Unlike args, a return value has no permissive fallback: the schema is
+ * advertised as an MCP `outputSchema`, which obliges the tool to return a
+ * matching object on every call. A validator with no native converter
+ * (e.g. valibot), or one whose converter cannot express the schema, yields
+ * no output schema rather than an unfounded object one, so array- and
+ * primitive-returning tools still work. Conversion uses the converter's
+ * `output`, since a transforming validator returns its output type.
  * @internal
  */
 export declare function returnToJsonSchema(schema: StandardSchemaV1 | undefined): unknown;
@@ -374,7 +382,7 @@ export declare const diagnostics: import("nostics").Diagnostics<{
   };
 }, readonly [(d: import("nostics").Diagnostic, { method }?: {
   method?: "log" | "warn" | "error";
-}) => void]>;
+}) => void], never>;
 //#endregion
 //#region src/node/host-agent.d.ts
 /**

package/dist/internal/index.mjs

@@ -5,8 +5,8 @@ import { n as toolInputToCommandArgs, t as DevframeAgentHost } from "../host-age
 import { a as resolveMcpConfig, n as normalizeBasePath, r as resolveBasePath, s as importAgenticMcp, t as loadAutoMcpAdapter } from "../_shared-B2PZsp-J.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-DtvYxc0Y.mjs";
-import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, r as samePath, t as createInstanceShell } from "../instance-shell-wC2sfEU_.mjs";
+import { i as registerDevframeInstance, n as listLiveDevframeInstances, r as probeDevframeOrigin } from "../instance-registry-C-nC0By7.mjs";
+import { i as normalizeHttpServerUrl, n as resolveInstanceRegister, r as samePath, t as createInstanceShell } from "../instance-shell-kUeR59CR.mjs";
 import { t as createContextRpcServer } from "../rpc-core-BXyMjbKG.mjs";
 //#region src/agent/stringify.ts
 /**
@@ -107,11 +107,25 @@ function safeToJsonSchema(schema) {
 }
 /**
 * JSON Schema for an RPC return value on the agent/MCP surface.
+*
+* Unlike args, a return value has no permissive fallback: the schema is
+* advertised as an MCP `outputSchema`, which obliges the tool to return a
+* matching object on every call. A validator with no native converter
+* (e.g. valibot), or one whose converter cannot express the schema, yields
+* no output schema rather than an unfounded object one, so array- and
+* primitive-returning tools still work. Conversion uses the converter's
+* `output`, since a transforming validator returns its output type.
 * @internal
 */
 function returnToJsonSchema(schema) {
 	if (!schema) return void 0;
-	return safeToJsonSchema(schema);
+	const standard = schema["~standard"];
+	if (!standard.jsonSchema) return void 0;
+	try {
+		return standard.jsonSchema.output({ target: "draft-2020-12" });
+	} catch {
+		return;
+	}
 }
 /**
 * JSON Schema for an RPC function's positional args on the agent/MCP

package/dist/rpc/dump.mjs

@@ -1,2 +1,2 @@
-import { a as getDefinitionsWithDumps, i as dumpFunctions, n as collectStaticRpcDump, o as reviveDumpError, r as createClientFromDump, s as serializeDumpError, t as writeStaticRpcDump } from "../write-DoXJzGUH.mjs";
+import { a as getDefinitionsWithDumps, i as dumpFunctions, n as collectStaticRpcDump, o as reviveDumpError, r as createClientFromDump, s as serializeDumpError, t as writeStaticRpcDump } from "../write-BWIO0h0Z.mjs";
 export { collectStaticRpcDump, createClientFromDump, dumpFunctions, getDefinitionsWithDumps, reviveDumpError, serializeDumpError, writeStaticRpcDump };

package/dist/{write-DoXJzGUH.mjs → write-BWIO0h0Z.mjs}

@@ -62,7 +62,7 @@ var Queue = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/p-limit@7.3.2/node_modules/p-limit/index.js
+//#region ../../node_modules/.pnpm/p-limit@7.3.3/node_modules/p-limit/index.js
 function pLimit(concurrency) {
 	let rejectOnClear = false;
 	if (typeof concurrency === "object") ({concurrency, rejectOnClear = false} = concurrency);
@@ -121,7 +121,17 @@ function pLimit(concurrency) {
 			}
 		},
 		map: { async value(iterable, function_) {
-			const promises = Array.from(iterable, (value, index) => generator(function_, value, index));
+			const promises = [];
+			try {
+				Array.from(iterable, (value, index) => {
+					const promise = generator(function_, value, index);
+					promises.push(promise);
+					return promise;
+				});
+			} catch (error) {
+				for (const promise of promises) promise.catch(() => {});
+				throw error;
+			}
 			return Promise.all(promises);
 		} }
 	});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "devframe",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.1.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.0.0",
+    "@devframes/agentic": "1.1.0",
     "cac": "^7.0.0"
   },
   "peerDependenciesMeta": {
@@ -90,12 +90,12 @@
   },
   "dependencies": {
     "crossws": "^0.4.12",
-    "h3": "^2.0.1-rc.31",
-    "nostics": "^1.2.0",
+    "h3": "^2.0.1-rc.32",
+    "nostics": "^1.3.0",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@devframes/agentic": "1.0.0",
+    "@devframes/agentic": "1.1.0",
     "@standard-schema/spec": "^1.1.0",
     "birpc": "^4.2.0",
     "cac": "^7.0.0",
@@ -106,7 +106,7 @@
     "mrmime": "^2.0.1",
     "obug": "^3.0.0",
     "ohash": "^2.0.12",
-    "p-limit": "^7.3.2",
+    "p-limit": "^7.3.3",
     "perfect-debounce": "^2.1.0",
     "structured-clone-es": "^2.0.1",
     "tinyglobby": "^0.2.17",