@devframes/agentic 1.3.0 → 1.3.2

package/dist/connect/index.d.mts

@@ -1,5 +1,4 @@
 import { DevframeInstanceRecord } from "devframe/internal";
-//#region src/connect/index.d.ts
 export interface ConnectServerOptions {
   /**
    * Explicit ports to probe besides the registry, for instances started
@@ -71,5 +70,4 @@ export declare function startConnectServer(options?: ConnectServerOptions): Prom
  * 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
+export declare function probePort(port: number, base?: string, timeoutMs?: number): Promise<DevframeInstanceRecord | null>;

package/dist/connect/index.mjs

@@ -5,7 +5,7 @@ import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/cli
 import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
 import { Diagnostic } from "devframe/utils/nostics";
 import { joinURL, withLeadingSlash, withTrailingSlash } from "devframe/utils/url";
-//#region src/connect/index.ts
+// src/connect/index.ts
 /**
 * Resolve the per-record bearer from the {@link ConnectServerOptions.authToken}
 * option. Exported for focused tests of the credential resolution.
@@ -249,5 +249,4 @@ function errorResult(error) {
 		}]
 	};
 }
-//#endregion
 export { buildInstanceRequestHeaders, probePort, resolveAuthToken, startConnectServer };

package/dist/index.mjs

@@ -1,4 +1,3 @@
-//#region src/index.ts
+// src/index.ts
 throw new Error("[@devframes/agentic] is not imported directly; installing it enables devframe's agent surfaces.\n  • import from \"devframe/adapters/mcp\" to serve a devframe over MCP\n  • run \"devframe connect\" for the stdio discovery gateway\n");
-//#endregion
 export {};

package/dist/mcp/index.d.mts

@@ -2,14 +2,11 @@ import { Server } from "@modelcontextprotocol/server";
 import { MountMcpHttpOptions, MountMcpHttpOptions as MountMcpHttpOptions$1, MountedMcpHttp, MountedMcpHttp as MountedMcpHttp$1 } from "devframe/internal";
 import { H3 } from "h3";
 import { CreateMcpFetchHandlerOptions, CreateMcpFetchHandlerOptions as CreateMcpFetchHandlerOptions$1, CreateMcpServerOptions, CreateMcpServerOptions as CreateMcpServerOptions$1, DevframeDefinition, DevframeNodeContext, McpConnectionInfo, McpFetchHandler, McpFetchHandler as McpFetchHandler$1, McpServerHandle, McpServerHandle as McpServerHandle$1 } from "devframe/types";
-//#region src/mcp/build-server.d.ts
 /**
  * Build an MCP server over the agent surface of a devframe definition.
  * Currently supports `stdio` transport only.
  */
 export declare function createMcpServer(definition: DevframeDefinition, options?: CreateMcpServerOptions$1): Promise<McpServerHandle$1>;
-//#endregion
-//#region src/mcp/fetch.d.ts
 /**
  * Build a framework-agnostic MCP endpoint over a devframe context: a
  * web-standard `Request → Response` handler any host can mount: h3 (see
@@ -41,8 +38,6 @@ export declare function createMcpServer(definition: DevframeDefinition, options?
  * callers.
  */
 export declare function createMcpFetchHandler(ctx: DevframeNodeContext, options: CreateMcpFetchHandlerOptions$1): McpFetchHandler$1;
-//#endregion
-//#region src/mcp/http.d.ts
 /**
  * Mount a stateless MCP endpoint on an h3 app at `path`: the h3 binding over
  * {@link createMcpFetchHandler}, which owns the per-request serving, the
@@ -57,5 +52,4 @@ export declare function createMcpFetchHandler(ctx: DevframeNodeContext, options:
  * request to the SPA static catch-all).
  */
 export declare function mountMcpHttp(app: H3, ctx: DevframeNodeContext, path: string, options: MountMcpHttpOptions$1): MountedMcpHttp$1;
-//#endregion
 export type { CreateMcpFetchHandlerOptions, CreateMcpServerOptions, McpConnectionInfo, McpFetchHandler, McpServerHandle, MountMcpHttpOptions, MountedMcpHttp };

package/dist/mcp/index.mjs

@@ -1,6 +1,6 @@
 import { homedir } from "node:os";
 import process from "node:process";
-import { Server, createMcpHandler } from "@modelcontextprotocol/server";
+import { ProtocolError, ProtocolErrorCode, Server, createMcpHandler } from "@modelcontextprotocol/server";
 import { DEVFRAME_EVENTS } from "devframe/constants";
 import { argsToJsonSchema, diagnostics, formatMcpError, getMcpContent, returnToJsonSchema, stringifyForMcp } from "devframe/internal";
 import { createHostContext } from "devframe/node";
@@ -9,7 +9,7 @@ import { join } from "pathe";
 import { timingSafeEqual } from "devframe/utils/crypto-token";
 import { isAllowedOrigin, isLoopbackAddress } from "devframe/utils/origin";
 import { defineHandler, getRequestIP } from "h3";
-//#region src/mcp/build-server.ts
+// src/mcp/build-server.ts
 /**
 * Build a fresh MCP {@link Server} over a devframe context, registering its
 * tool and resource handlers. This is a pure factory: it sets up no
@@ -29,7 +29,8 @@ function buildMcpServerFromContext(ctx, options) {
 	}, {
 		capabilities: {
 			tools: { listChanged: true },
-			resources: { listChanged: true }
+			resources: { listChanged: true },
+			...options.prompts?.size ? { prompts: { listChanged: false } } : {}
 		},
 		...options.instructions ? { instructions: options.instructions } : {}
 	});
@@ -43,6 +44,7 @@ function buildMcpServerFromContext(ctx, options) {
 		description,
 		mimeType
 	})) }));
+	if (options.prompts?.size) registerPromptHandlers(server, options.prompts);
 	return server;
 }
 /**
@@ -89,6 +91,7 @@ async function createMcpServer(definition, options = {}) {
 		reason: "Only stdio transport is supported in this release."
 	});
 	const resourceTemplates = compileResourceTemplates(options.resourceTemplates);
+	const prompts = compilePrompts(options.prompts);
 	const ctx = await createHostContext({
 		cwd: process.cwd(),
 		mode: "dev",
@@ -111,7 +114,8 @@ async function createMcpServer(definition, options = {}) {
 		serverVersion: options.serverVersion ?? definition.version ?? "0.0.0",
 		exposeSharedState: options.exposeSharedState ?? true,
 		instructions: options.instructions,
-		resourceTemplates
+		resourceTemplates,
+		prompts
 	};
 	let handle;
 	try {
@@ -313,6 +317,49 @@ function registerResourceHandlers(server, ctx, exposeSharedState, templates) {
 		throw new Error(`[devframe/mcp] unknown resource URI "${uri}"`);
 	});
 }
+/**
+* Index prompts by name, once per endpoint. A repeated name throws
+* `DF0085`, since `prompts/get` finds a prompt by its name.
+*
+* @internal
+*/
+function compilePrompts(prompts = []) {
+	const byName = /* @__PURE__ */ new Map();
+	for (const prompt of prompts) {
+		if (byName.has(prompt.name)) throw diagnostics.DF0085({ name: prompt.name });
+		byName.set(prompt.name, prompt);
+	}
+	return byName;
+}
+/**
+* Serve `prompts/list` and `prompts/get`. An unknown name, or a required
+* argument that is missing or empty, is an invalid-params error. An error
+* thrown by `get` goes to the MCP client.
+*/
+function registerPromptHandlers(server, prompts) {
+	server.setRequestHandler("prompts/list", async () => ({ prompts: [...prompts.values()].map(({ name, title, description, arguments: args }) => ({
+		name,
+		title,
+		description,
+		...args?.length ? { arguments: args.map((argument) => ({
+			name: argument.name,
+			description: argument.description,
+			required: argument.required
+		})) } : {}
+	})) }));
+	server.setRequestHandler("prompts/get", async (request) => {
+		const { name, arguments: given = {} } = request.params;
+		const prompt = prompts.get(name);
+		if (!prompt) throw new ProtocolError(ProtocolErrorCode.InvalidParams, `[devframe/mcp] unknown prompt "${name}"`);
+		const missing = (prompt.arguments ?? []).filter((argument) => argument.required && !(Object.hasOwn(given, argument.name) && given[argument.name])).map((argument) => argument.name);
+		if (missing.length) throw new ProtocolError(ProtocolErrorCode.InvalidParams, `[devframe/mcp] prompt "${name}" needs the argument(s): ${missing.join(", ")}`);
+		const { description, messages } = await prompt.get(given);
+		return {
+			description,
+			messages
+		};
+	});
+}
 /** One `{name}` expression of a URI template. */
 const TEMPLATE_EXPRESSION_RE = /\{([^{}]*)\}/;
 /** RFC 6570 `varname`: letters, digits and `_`, with single dots between them. */
@@ -482,8 +529,7 @@ function parseResourceUri(uri) {
 		key: decoded
 	};
 }
-//#endregion
-//#region src/mcp/fetch.ts
+// src/mcp/fetch.ts
 /**
 * Parse exactly one `Authorization: Bearer <token>` credential, returning the
 * token or `undefined` for a missing, malformed, empty, or multi-credential
@@ -542,12 +588,14 @@ function createMcpFetchHandler(ctx, options) {
 	const allowedOrigins = options.allowedOrigins;
 	const authorization = options.authorization ?? false;
 	const resourceTemplates = compileResourceTemplates(options.resourceTemplates);
+	const prompts = compilePrompts(options.prompts);
 	const handler = createMcpHandler(() => buildMcpServerFromContext(ctx, {
 		serverName: options.serverName,
 		serverVersion: options.serverVersion,
 		exposeSharedState: options.exposeSharedState,
 		instructions: options.instructions,
-		resourceTemplates
+		resourceTemplates,
+		prompts
 	}));
 	const unbridge = bridgeListChanged(ctx, {
 		tools: () => {
@@ -576,8 +624,7 @@ function createMcpFetchHandler(ctx, options) {
 		}
 	};
 }
-//#endregion
-//#region src/mcp/http.ts
+// src/mcp/http.ts
 /**
 * Mount a stateless MCP endpoint on an h3 app at `path`: the h3 binding over
 * {@link createMcpFetchHandler}, which owns the per-request serving, the
@@ -609,5 +656,4 @@ function respond(event, response) {
 	});
 	return response.body ?? "";
 }
-//#endregion
 export { createMcpFetchHandler, createMcpServer, mountMcpHttp };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/agentic",
   "type": "module",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "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,19 +30,19 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "1.3.0"
+    "devframe": "1.3.2"
   },
   "dependencies": {
-    "@modelcontextprotocol/client": "^2.3.1",
-    "@modelcontextprotocol/server": "^2.3.1",
-    "h3": "^2.0.7",
+    "@modelcontextprotocol/client": "^2.4.0",
+    "@modelcontextprotocol/server": "^2.4.0",
+    "h3": "^2.0.8",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
-    "@types/node": "^26.6.5",
-    "devframe": "1.3.0",
-    "tsdown": "0.23.0",
+    "@types/node": "^26.6.6",
+    "devframe": "1.3.2",
+    "tsdown": "^0.23.4",
     "valibot": "^1.5.0"
   },
   "scripts": {