@happyvertical/smrt-core 0.40.60 → 0.40.61

package/dist/generators/mcp.js

@@ -12,6 +12,27 @@ import { mkdir, writeFile } from "node:fs/promises";
 *
 * Exposes smrt objects as AI tools for Claude, GPT, and other AI models
 */
+var MCP_STABLE_CATALOG_TTL_MS = 864e5;
+/**
+* Resolve the generated tools/list cache policy at generation time.
+*
+* A shared cache may otherwise serve one tenant's tool catalog to another, so
+* public caching is deliberately double opt-in and unavailable when a
+* generated server exposes any tenant-scoped object.
+*/
+function resolveMCPToolListCacheHint(options, hasTenantScopedTools) {
+	const ttlMs = options?.ttlMs ?? 864e5;
+	if (!Number.isSafeInteger(ttlMs) || ttlMs < 0) throw new RangeError("MCP tools/list cache ttlMs must be a non-negative safe integer.");
+	if (options?.cacheScope !== void 0 && options.cacheScope !== "private" && options.cacheScope !== "public") throw new RangeError("MCP tools/list cacheScope must be 'private' or 'public'.");
+	return {
+		ttlMs,
+		cacheScope: !hasTenantScopedTools && options?.cacheScope === "public" && options.publicCatalog === true ? "public" : "private"
+	};
+}
+/** Return a copied, canonical tool sequence for byte-stable tools/list output. */
+function sortMCPTools(tools) {
+	return [...tools].sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
+}
 var CustomActionFailureError = class extends Error {
 	failure;
 	constructor(failure) {
@@ -84,7 +105,7 @@ var MCPGenerator = class {
 			const objectTools = await this.generateObjectTools(simpleName, shouldInclude);
 			tools.push(...objectTools);
 		}
-		return tools;
+		return sortMCPTools(tools);
 	}
 	/**
 	* Generate tools for a specific object
@@ -609,6 +630,29 @@ var MCPGenerator = class {
 		return Array.from(scoped);
 	}
 	/**
+	* Whether a catalog contains a tenant-scoped class for cache isolation.
+	*
+	* Unlike the emitted runtime tenant gate, cache visibility must also fail
+	* closed for core-declared `@smrt({ tenantScoped })` models when the optional
+	* tenancy package is not installed. The registry covers that form, while
+	* `tenantScopedObjectNames()` covers the tenancy-owned decorator form.
+	*/
+	async hasTenantScopedTools(tools) {
+		if ((await this.tenantScopedObjectNames(tools)).length > 0) return true;
+		for (const tool of tools) {
+			const [objectName] = tool.name.split("_");
+			if (!objectName) continue;
+			for (const [key, info] of ObjectRegistry.getAllClasses()) {
+				const simpleName = info.name || key;
+				if (simpleName.toLowerCase() === objectName.toLowerCase()) {
+					if (ObjectRegistry.isTenantScoped(simpleName)) return true;
+					break;
+				}
+			}
+		}
+		return false;
+	}
+	/**
 	* Execute a resolved MCP action (CRUD or custom) against a collection. Always
 	* invoked inside the tenant gate established by {@link executeAction}.
 	*/
@@ -765,6 +809,8 @@ var MCPGenerator = class {
 		if (modular) await this.generateModularServer(outputDir, serverName, serverVersion, debug);
 		else {
 			const tools = await this.generateTools();
+			const tenantScopedObjects = await this.tenantScopedObjectNames(tools);
+			const hasTenantScopedTools = tenantScopedObjects.length > 0 || await this.hasTenantScopedTools(tools);
 			await writeFile(resolvedPath, generateRuntimeBootstrap({
 				name: serverName,
 				version: serverVersion,
@@ -774,8 +820,9 @@ var MCPGenerator = class {
 				debug,
 				tools,
 				customActions: await this.runtimeCustomActions(tools),
-				tenantScopedObjects: await this.tenantScopedObjectNames(tools),
-				stiTargets: this.runtimeStiTargets(tools)
+				tenantScopedObjects,
+				stiTargets: this.runtimeStiTargets(tools),
+				toolListCacheHint: resolveMCPToolListCacheHint(this.config.cache?.toolsList, hasTenantScopedTools)
 			}), "utf-8");
 			console.log(`✅ Generated MCP server: ${resolvedPath}`);
 		}
@@ -871,15 +918,17 @@ var MCPGenerator = class {
 		const configPath = resolve(outputDir, "config.ts");
 		await writeFile(configPath, this.generateConfigFile(serverName, serverVersion, debug), "utf-8");
 		console.log(`✅ Generated config: ${configPath}`);
+		const generatedTools = await this.generateTools();
 		const toolsPath = resolve(toolsDir, "index.ts");
-		await writeFile(toolsPath, await this.generateToolsFile(), "utf-8");
+		await writeFile(toolsPath, this.generateToolsFile(generatedTools), "utf-8");
 		console.log(`✅ Generated tools: ${toolsPath}`);
 		const handlersPath = resolve(handlersDir, "index.ts");
-		const tenantScopedObjects = await this.tenantScopedObjectNames(await this.generateTools());
+		const tenantScopedObjects = await this.tenantScopedObjectNames(generatedTools);
+		const hasTenantScopedTools = tenantScopedObjects.length > 0 || await this.hasTenantScopedTools(generatedTools);
 		await writeFile(handlersPath, await this.generateHandlersFile(tenantScopedObjects), "utf-8");
 		console.log(`✅ Generated handlers: ${handlersPath}`);
 		const indexPath = resolve(outputDir, "index.js");
-		await writeFile(indexPath, this.generateModularIndex(), "utf-8");
+		await writeFile(indexPath, this.generateModularIndex(resolveMCPToolListCacheHint(this.config.cache?.toolsList, hasTenantScopedTools)), "utf-8");
 		console.log(`✅ Generated MCP server: ${indexPath}`);
 	}
 	/**
@@ -900,8 +949,7 @@ export const DEBUG = ${debug};
 	/**
 	* Generate tools definitions file for modular server
 	*/
-	async generateToolsFile() {
-		const tools = await this.generateTools();
+	generateToolsFile(tools) {
 		return `/**
  * MCP Tools Definitions
  * Auto-generated from SMRT objects
@@ -1243,7 +1291,7 @@ ${hasTenantScoped ? `
 	/**
 	* Generate modular index file (main entry point)
 	*/
-	generateModularIndex() {
+	generateModularIndex(toolListCacheHint) {
 		return `#!/usr/bin/env node
 /**
  * Auto-generated MCP Server
@@ -1266,6 +1314,8 @@ import { SERVER_NAME, SERVER_VERSION, DEBUG } from './config.js';
 import { tools } from './tools/index.js';
 import { handleToolCall } from './handlers/index.js';
 
+const TOOL_LIST_CACHE_HINT = ${JSON.stringify(toolListCacheHint)};
+
 /**
  * Main server startup function
  */
@@ -1300,6 +1350,9 @@ export async function createServer() {
         capabilities: {
           tools: {},
         },
+        cacheHints: {
+          'tools/list': TOOL_LIST_CACHE_HINT,
+        },
       }
     );
 
@@ -1310,7 +1363,7 @@ export async function createServer() {
       }
 
       return {
-        tools: tools.map(tool => ({
+        tools: [...tools].sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0).map(tool => ({
           name: tool.name,
           description: tool.description,
           inputSchema: tool.inputSchema,
@@ -1362,6 +1415,6 @@ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href)
 	}
 };
 //#endregion
-export { MCPGenerator };
+export { MCPGenerator, MCP_STABLE_CATALOG_TTL_MS, resolveMCPToolListCacheHint, sortMCPTools };
 
 //# sourceMappingURL=mcp.js.map