@devframes/agentic 1.0.0 → 1.1.0

package/dist/connect/index.d.mts

@@ -4,9 +4,18 @@ export interface ConnectServerOptions {
   /**
    * Explicit ports to probe besides the registry, for instances started
    * before the registry existed, or reachable only by convention. Each port
-   * is probed at `/` (`http://localhost:<port>/__connection.json`).
+   * is probed at {@link ConnectServerOptions.base} (default `/`, i.e.
+   * `http://localhost:<port>/__connection.json`).
    */
   ports?: number[];
+  /**
+   * Base path the explicit {@link ConnectServerOptions.ports} probes look for
+   * `__connection.json` under, for a devframe or hub mounted below the root
+   * of its host (e.g. `/__devtools/` for Vite DevTools). The advertised MCP
+   * path is resolved against it. Default `/`. Registry records carry their
+   * own base and ignore this.
+   */
+  base?: string;
   /** Override the registry directory (`DEVFRAME_INSTANCES_DIR` also applies). */
   instancesDir?: string;
   /** Probe timeout per instance, ms. Default 1000. */
@@ -55,4 +64,12 @@ export interface ConnectServerHandle {
  * Streamable-HTTP endpoint), and holds no domain knowledge of its own.
  */
 export declare function startConnectServer(options?: ConnectServerOptions): Promise<ConnectServerHandle>;
+/**
+ * Probe an explicit port for a devframe serving `__connection.json` under
+ * `base` (default `/`), reusing the registry's origin-candidate probe (a
+ * `localhost`-bound server may listen on either address family). The
+ * advertised MCP path is relative to that base, as in the registry records
+ * the instance shell writes. Exported for focused tests.
+ */
+export declare function probePort(port: number, base?: string, timeoutMs?: number): Promise<DevframeInstanceRecord | null>;
 //#endregion

package/dist/connect/index.mjs

@@ -4,7 +4,7 @@ import { toAgentToolName } from "devframe/utils/agent-tool-name";
 import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
 import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
 import { Diagnostic } from "devframe/utils/nostics";
-import { joinURL } from "devframe/utils/url";
+import { joinURL, withLeadingSlash, withTrailingSlash } from "devframe/utils/url";
 //#region src/connect/index.ts
 /**
 * Resolve the per-record bearer from the {@link ConnectServerOptions.authToken}
@@ -108,7 +108,7 @@ async function index(options) {
 	const records = [...live];
 	for (const port of options.ports ?? []) {
 		if (records.some((r) => r.port === port)) continue;
-		const probed = await probePort(port, options.timeoutMs);
+		const probed = await probePort(port, options.base, options.timeoutMs);
 		if (probed) records.push(probed);
 	}
 	const instances = await Promise.all(records.map(async (record) => {
@@ -137,23 +137,26 @@ async function index(options) {
 	}));
 	return {
 		instances,
-		...instances.length === 0 ? { hint: "No running devframe instances found. Start a devframe dev server (with --mcp for tools), or pass --port <n> to devframe connect if the instance predates the registry." } : {}
+		...instances.length === 0 ? { hint: "No running devframe instances found. Start a devframe dev server (with --mcp for tools), or pass --port <n> to devframe connect if the instance predates the registry (plus --base <path> when it is mounted below the root, e.g. --base /__devtools/)." } : {}
 	};
 }
 /**
-* Probe an explicit port for a devframe serving `__connection.json` at `/`,
-* reusing the registry's origin-candidate probe (a `localhost`-bound server
-* may listen on either address family).
+* Probe an explicit port for a devframe serving `__connection.json` under
+* `base` (default `/`), reusing the registry's origin-candidate probe (a
+* `localhost`-bound server may listen on either address family). The
+* advertised MCP path is relative to that base, as in the registry records
+* the instance shell writes. Exported for focused tests.
 */
-async function probePort(port, timeoutMs) {
-	const probed = await probeDevframeOrigin(`http://localhost:${port}`, "/", timeoutMs);
+async function probePort(port, base = "/", timeoutMs) {
+	const basePath = withTrailingSlash(withLeadingSlash(base));
+	const probed = await probeDevframeOrigin(`http://localhost:${port}`, basePath, timeoutMs);
 	if (!probed) return null;
-	const mcpPath = probed.meta.mcp ? joinURL("/", probed.meta.mcp.path) : null;
+	const mcpPath = probed.meta.mcp ? joinURL(basePath, probed.meta.mcp.path) : null;
 	return {
 		pid: -1,
 		port,
 		origin: probed.origin,
-		basePath: "/",
+		basePath,
 		id: `port-${port}`,
 		rootDir: "",
 		mcp: mcpPath ? { path: mcpPath } : null,
@@ -169,7 +172,7 @@ async function call(options, args) {
 		instancesDir: options.instancesDir,
 		timeoutMs: options.timeoutMs
 	});
-	const record = live.find((record) => record.port === args.port && record.mcp) ?? await probePort(args.port, options.timeoutMs);
+	const record = live.find((record) => record.port === args.port && record.mcp) ?? await probePort(args.port, options.base, options.timeoutMs);
 	if (!record) throw diagnostics.DF0050({ port: args.port });
 	if (!record.mcp) throw diagnostics.DF0051({ port: args.port });
 	return withInstanceClient(`${record.origin}${record.mcp.path}`, resolveAuthToken(options.authToken, record), async (client) => {
@@ -235,4 +238,4 @@ function errorResult(error) {
 	};
 }
 //#endregion
-export { buildInstanceRequestHeaders, resolveAuthToken, startConnectServer };
+export { buildInstanceRequestHeaders, probePort, resolveAuthToken, startConnectServer };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/agentic",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Agent-surface implementation for devframe: installing it next to devframe enables the MCP adapter (devframe/adapters/mcp) and the devframe connect gateway.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -30,18 +30,18 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "1.0.0"
+    "devframe": "1.1.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/client": "^2.0.0",
-    "@modelcontextprotocol/server": "^2.0.0",
-    "h3": "^2.0.1-rc.31",
+    "@modelcontextprotocol/client": "^2.1.0",
+    "@modelcontextprotocol/server": "^2.1.0",
+    "h3": "^2.0.1-rc.32",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
-    "@types/node": "^26.5.1",
-    "devframe": "1.0.0",
+    "@types/node": "^26.6.2",
+    "devframe": "1.1.0",
     "tsdown": "^0.23.0",
     "valibot": "^1.5.0"
   },