@devframes/agentic 1.3.0 → 1.3.1

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";
@@ -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. */
@@ -542,12 +589,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: () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/agentic",
   "type": "module",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "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,7 +30,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "1.3.0"
+    "devframe": "1.3.1"
   },
   "dependencies": {
     "@modelcontextprotocol/client": "^2.3.1",
@@ -41,7 +41,7 @@
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
     "@types/node": "^26.6.5",
-    "devframe": "1.3.0",
+    "devframe": "1.3.1",
     "tsdown": "0.23.0",
     "valibot": "^1.5.0"
   },