@sezzlee/sdk-nestjs 0.1.0 → 0.2.0

package/README.md

@@ -4,7 +4,7 @@ An MCP layer that embeds into your existing NestJS backend. It exposes your endp
 a search-first tool catalog and replays each call through **your own** pipeline, so your guards,
 pipes and interceptors keep running unchanged. Not a gateway, not duplicated business logic.
 
-> Status: `0.1.0`, alpha; breaking changes are possible. [samples/demo-api](samples/demo-api) is
+> Status: `0.2.0`, alpha; breaking changes are possible. [samples/demo-api](samples/demo-api) is
 > the reference wiring.
 
 ## Requirements

package/dist/meta-tools.js

@@ -1,4 +1,4 @@
-import { catalogGenerationMetaKey, compose, createDetail, emitGuarded as emitWithin, errorResult, invokeArgumentsDescription, invokeDescription, isInvokeError, knownFields, loadDescription, missingArgument, narrowingArguments, normalizeInvokeArguments, notInvocable, operationNameDescription, refuseTimedOutInvoke, refuseUnresolvedFile, resolveDeferred as resolveDeferredWith, searchCatalog, searchDescription, searchDetailDescription, searchLimitDescription, searchQueryDescription, searchTagsDescription, SezzleeArgumentError, SezzleeDispatchAborted, textResult, unknownTool, vocabularyOf, wrongArgumentType, defaultSearchLimit, describeRankerEvent, } from "@sezzlee/core";
+import { catalogGenerationMetaKey, checkPinnedVersion, compose, createLoadedTool, emitGuarded as emitWithin, errorResult, invokeArgumentsDescription, invokeDescription, invokeVersionDescription, isInvokeError, knownFields, loadDescription, missingArgument, narrowingArguments, normalizeInvokeArguments, notInvocable, operationNameDescription, refuseTimedOutInvoke, refuseUnresolvedFile, resolveDeferred as resolveDeferredWith, searchCatalog, searchDescription, searchDetailDescription, searchLimitDescription, searchQueryDescription, searchTagsDescription, SezzleeArgumentError, SezzleeDispatchAborted, textResult, unknownTool, vocabularyOf, wrongArgumentType, defaultSearchLimit, describeRankerEvent, } from "@sezzlee/core";
 import { Logger } from "@nestjs/common";
 import { z } from "zod";
 import { SezzleeFileRefused } from "./files.js";
@@ -186,7 +186,7 @@ export function registerSezzleeTools(server, deps) {
         if (!deps.visibility.visible(decision)) {
             return unknownTool(name);
         }
-        return textResult(createDetail(entry.tool, decision), false);
+        return textResult(createLoadedTool(entry.tool, decision), false);
     }));
     server.registerTool("invoke_tool", {
         description: invokeDescription,
@@ -203,9 +203,20 @@ export function registerSezzleeTools(server, deps) {
             arguments: z.unknown().optional().meta({
                 description: invokeArgumentsDescription,
             }),
+            /**
+             * Guard: `meta` publishes the `default: null` the ASP.NET SDK emits for this optional
+             * string and cannot omit, the same trap `tags` has. It binds as `unknown` so a value that
+             * is not a string reaches checkPinnedVersion and leaves as an envelope. Pinned by T18 and
+             * by test/meta-tools.spec.ts.
+             */
+            version: z.unknown().optional().meta({
+                type: "string",
+                description: invokeVersionDescription,
+                default: null,
+            }),
         })
             .meta({ required: ["name", "arguments"] }),
-    }, async ({ name, arguments: args }, ctx) => emitGuarded(deps, async () => {
+    }, async ({ name, arguments: args, version }, ctx) => emitGuarded(deps, async () => {
         if (name === undefined) {
             return missingArgument("invoke_tool", "name");
         }
@@ -217,6 +228,10 @@ export function registerSezzleeTools(server, deps) {
         if (entry === undefined) {
             return unknownTool(name);
         }
+        const stale = checkPinnedVersion(entry.tool, version);
+        if (stale !== undefined) {
+            return stale;
+        }
         if (entry.template === undefined) {
             return notInvocable(name);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sezzlee/sdk-nestjs",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Embeds an MCP layer into an existing NestJS backend: search-first tool discovery over your real endpoints, dispatched through your own guards, pipes and interceptors.",
   "keywords": [
     "mcp",
@@ -41,7 +41,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@sezzlee/core": "^0.1.0"
+    "@sezzlee/core": "^0.2.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/express": ">=2.0.0",