@devframes/agentic 1.2.5 → 1.2.6

package/dist/mcp/index.mjs

@@ -2,7 +2,7 @@ import { homedir } from "node:os";
 import process from "node:process";
 import { Server, createMcpHandler } from "@modelcontextprotocol/server";
 import { DEVFRAME_EVENTS } from "devframe/constants";
-import { argsToJsonSchema, diagnostics, formatMcpError, returnToJsonSchema, stringifyForMcp } from "devframe/internal";
+import { argsToJsonSchema, diagnostics, formatMcpError, getMcpContent, returnToJsonSchema, stringifyForMcp } from "devframe/internal";
 import { createHostContext } from "devframe/node";
 import { toAgentToolName } from "devframe/utils/agent-tool-name";
 import { join } from "pathe";
@@ -26,10 +26,13 @@ function buildMcpServerFromContext(ctx, options) {
 	const server = new Server({
 		name: options.serverName,
 		version: options.serverVersion
-	}, { capabilities: {
-		tools: { listChanged: true },
-		resources: { listChanged: true }
-	} });
+	}, {
+		capabilities: {
+			tools: { listChanged: true },
+			resources: { listChanged: true }
+		},
+		...options.instructions ? { instructions: options.instructions } : {}
+	});
 	registerToolHandlers(server, ctx, options.exposeSharedState);
 	registerResourceHandlers(server, ctx, options.exposeSharedState);
 	return server;
@@ -89,7 +92,8 @@ async function createMcpServer(definition, options = {}) {
 	const buildOptions = {
 		serverName: options.serverName ?? `${definition.id} (devframe)`,
 		serverVersion: options.serverVersion ?? definition.version ?? "0.0.0",
-		exposeSharedState: options.exposeSharedState ?? true
+		exposeSharedState: options.exposeSharedState ?? true,
+		instructions: options.instructions
 	};
 	let handle;
 	try {
@@ -217,7 +221,7 @@ function registerToolHandlers(server, ctx, exposeSharedState) {
 			const outputSchema = tool ? usableOutputSchema(tool.outputSchema ?? computeOutputSchema(tool, ctx)) : void 0;
 			const result = await ctx.agent.invoke(tool?.id ?? name, args ?? {});
 			return {
-				content: [{
+				content: mcpContentOf(name, result) ?? [{
 					type: "text",
 					text: stringifyForMcp(result)
 				}],
@@ -278,6 +282,36 @@ function registerResourceHandlers(server, ctx, exposeSharedState) {
 	});
 }
 /**
+* The content blocks a tool result carries through `withMcpContent`, checked
+* and copied field by field, or `undefined` when it carries none. Invalid
+* blocks throw DF0081, which the `tools/call` handler turns into an
+* `isError` result.
+*/
+function mcpContentOf(name, result) {
+	const blocks = getMcpContent(result);
+	if (blocks === void 0) return void 0;
+	if (!Array.isArray(blocks) || blocks.length === 0) throw diagnostics.DF0081({
+		name,
+		reason: "expected a non-empty array"
+	});
+	return Array.from(blocks, (block, index) => {
+		const b = block ?? {};
+		if (b.type === "text" && typeof b.text === "string") return {
+			type: "text",
+			text: b.text
+		};
+		if ((b.type === "image" || b.type === "audio") && typeof b.data === "string" && typeof b.mimeType === "string") return {
+			type: b.type,
+			data: b.data,
+			mimeType: b.mimeType
+		};
+		throw diagnostics.DF0081({
+			name,
+			reason: `block ${index} is not a valid text, image or audio block`
+		});
+	});
+}
+/**
 * MCP constrains a tool's `outputSchema` to a JSON Schema of `type:
 * "object"`; clients (the SDK included) reject anything else. Non-object
 * return schemas (e.g. a schema for `void` / a bare string) simply project
@@ -398,7 +432,8 @@ function createMcpFetchHandler(ctx, options) {
 	const handler = createMcpHandler(() => buildMcpServerFromContext(ctx, {
 		serverName: options.serverName,
 		serverVersion: options.serverVersion,
-		exposeSharedState: options.exposeSharedState
+		exposeSharedState: options.exposeSharedState,
+		instructions: options.instructions
 	}));
 	const unbridge = bridgeListChanged(ctx, {
 		tools: () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/agentic",
   "type": "module",
-  "version": "1.2.5",
+  "version": "1.2.6",
   "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.2.5"
+    "devframe": "1.2.6"
   },
   "dependencies": {
     "@modelcontextprotocol/client": "^2.3.1",
@@ -41,7 +41,7 @@
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
     "@types/node": "^26.6.4",
-    "devframe": "1.2.5",
+    "devframe": "1.2.6",
     "tsdown": "^0.23.0",
     "valibot": "^1.5.0"
   },