@ama-mcp/core 13.3.0-prerelease.14 → 13.3.0-prerelease.22

package/README.md

@@ -6,6 +6,9 @@
 <br />
 <br />
 
+> [!WARNING]
+> [Experimental](https://github.com/AmadeusITGroup/otter/blob/main/README.md#experimental)
+
 ## Description
 
 This module provides utilities to interact inside an MCP server.

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@ama-mcp/core",
-  "version": "13.3.0-prerelease.14",
+  "version": "13.3.0-prerelease.22",
   "publishConfig": {
     "access": "public"
   },
-  "description": "This module provides utilities to interact inside an MCP server",
+  "description": "Experimental package — This module provides utilities to interact inside an MCP server",
   "keywords": [
     "mcp",
     "otter",
@@ -42,15 +42,15 @@
     "@angular/platform-browser": "~20.3.0",
     "@angular/platform-browser-dynamic": "~20.3.0",
     "@eslint-community/eslint-plugin-eslint-comments": "^4.4.0",
-    "@modelcontextprotocol/sdk": "~1.19.0",
+    "@modelcontextprotocol/sdk": "~1.20.0",
     "@nx/eslint": "~21.6.0",
     "@nx/eslint-plugin": "~21.6.0",
     "@nx/jest": "~21.6.0",
     "@nx/js": "~21.6.0",
-    "@o3r/build-helpers": "^13.3.0-prerelease.14",
-    "@o3r/eslint-config": "^13.3.0-prerelease.14",
-    "@o3r/eslint-plugin": "^13.3.0-prerelease.14",
-    "@o3r/test-helpers": "^13.3.0-prerelease.14",
+    "@o3r/build-helpers": "^13.3.0-prerelease.22",
+    "@o3r/eslint-config": "^13.3.0-prerelease.22",
+    "@o3r/eslint-plugin": "^13.3.0-prerelease.22",
+    "@o3r/test-helpers": "^13.3.0-prerelease.22",
     "@stylistic/eslint-plugin": "~5.4.0",
     "@types/jest": "~29.5.2",
     "@types/node": "~22.18.0",

package/src/cache/index.d.ts

@@ -0,0 +1,95 @@
+import { type LoggerToolOptions } from '../logger';
+/**
+ * Default maximum age for cache entries before they are considered expired.
+ * @experimental
+ */
+export declare const DEFAULT_AMA_MCP_CACHE_MAX_AGE_DAYS = 90;
+/**
+ * Options for a tool using the cache manager.
+ * @experimental
+ */
+export interface CacheToolOptions extends LoggerToolOptions {
+    /**
+     * Path to the cache file.
+     */
+    cacheFilePath?: string;
+    /**
+     * Maximum age for cache entries before they are considered expired.
+     */
+    cacheEntryExpireAfterDays?: number;
+    /**
+     * Whether to prettify the cache file when writing to disk.
+     */
+    prettifyCacheFile?: boolean;
+    /**
+     * Whether to disable the cache.
+     */
+    disableCache?: boolean;
+}
+interface GetOptions {
+    /**
+     * Whether to exclude expired entries.
+     */
+    excludeExpiredEntries?: boolean;
+}
+/**
+ * A simple cache manager that stores cache entries in a JSON file.
+ * @experimental
+ */
+export declare class CacheManager<T> {
+    private cache;
+    private readonly options;
+    /**
+     * Creates a new CacheManager.
+     * @param options CacheManager options.
+     */
+    constructor(options: CacheToolOptions);
+    private writeCache;
+    /**
+     * Retrieves a cache entry by key.
+     * @param key
+     * @param options
+     */
+    get(key: string, options?: GetOptions): T | undefined;
+    /**
+     * Sets a cache entry.
+     * @param key
+     * @param value
+     */
+    set(key: string, value: T): Promise<void>;
+    /**
+     * Clears the entire cache.
+     */
+    clear(): Promise<void>;
+    /**
+     * Loads the cache from the cache file.
+     * @param options
+     * @param options.throwOnError Whether to throw an error if the cache file cannot be read.
+     */
+    initialize(options?: GetOptions & {
+        throwOnError?: boolean;
+    }): Promise<void>;
+    /**
+     * Iterates over all cache entries.
+     * @param callback
+     * @param options
+     */
+    forEach(callback: (key: string, entry: T | undefined) => void, options?: GetOptions): void;
+    /**
+     * Checks if a cache entry is expired.
+     * @param key
+     */
+    isExpired(key: string): boolean;
+    /**
+     * Returns the available keys
+     * @param options
+     */
+    getKeys(options?: GetOptions): string[];
+    /**
+     * Returns the available entries
+     * @param options
+     */
+    getEntries(options?: GetOptions): [string, T][];
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/src/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,WAAW,CAAC;AAWnB;;;GAGG;AACH,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,UAAU,UAAU;IAClB;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqF;IAE7G;;;OAGG;gBAED,OAAO,EAAE,gBAAgB;YAYb,UAAU;IAcxB;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,CAAC,GAAG,SAAS;IAQhE;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAQhC;;OAEG;IACI,KAAK;IAKZ;;;;OAIG;IACU,UAAU,CAAC,OAAO,GAAE,UAAU,GAAG;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO;IA4B7E;;;;OAIG;IACI,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EAAE,OAAO,GAAE,UAAe;IAM9F;;;OAGG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAYtC;;;OAGG;IACI,OAAO,CAAC,OAAO,GAAE,UAAe,GAAG,MAAM,EAAE;IAQlD;;;OAGG;IACI,UAAU,CAAC,OAAO,GAAE,UAAe,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;CAS3D"}

package/src/cache/index.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = exports.DEFAULT_AMA_MCP_CACHE_MAX_AGE_DAYS = void 0;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const logger_1 = require("../logger");
+const MS_IN_A_DAY = 1000 * 60 * 60 * 24;
+/**
+ * Default maximum age for cache entries before they are considered expired.
+ * @experimental
+ */
+exports.DEFAULT_AMA_MCP_CACHE_MAX_AGE_DAYS = 90;
+/**
+ * A simple cache manager that stores cache entries in a JSON file.
+ * @experimental
+ */
+class CacheManager {
+    /**
+     * Creates a new CacheManager.
+     * @param options CacheManager options.
+     */
+    constructor(options) {
+        this.cache = {};
+        this.options = {
+            cacheFilePath: (0, node_path_1.resolve)((0, node_os_1.tmpdir)(), 'ama-mcp-cache.json'),
+            cacheEntryExpireAfterDays: exports.DEFAULT_AMA_MCP_CACHE_MAX_AGE_DAYS,
+            prettifyCacheFile: false,
+            disableCache: false,
+            logger: new logger_1.MCPLogger('CacheManager', options.logLevel),
+            ...options
+        };
+    }
+    async writeCache() {
+        if (this.options.disableCache) {
+            this.options.logger.debug?.('Cache is disabled; skipping write.');
+            return;
+        }
+        const directory = (0, node_path_1.dirname)(this.options.cacheFilePath);
+        if (!(0, node_fs_1.existsSync)(directory)) {
+            this.options.logger.debug?.(`Creating cache directory at ${directory}`);
+            await (0, promises_1.mkdir)(directory, { recursive: true });
+        }
+        this.options.logger.debug?.(`Writing cache to ${this.options.cacheFilePath}`, this.cache);
+        return (0, promises_1.writeFile)(this.options.cacheFilePath, JSON.stringify(this.cache, null, this.options.prettifyCacheFile ? 2 : 0));
+    }
+    /**
+     * Retrieves a cache entry by key.
+     * @param key
+     * @param options
+     */
+    get(key, options = {}) {
+        const { excludeExpiredEntries = true } = options;
+        if (excludeExpiredEntries && this.isExpired(key)) {
+            return;
+        }
+        return this.cache[key]?.data;
+    }
+    /**
+     * Sets a cache entry.
+     * @param key
+     * @param value
+     */
+    set(key, value) {
+        this.cache[key] = {
+            updatedAt: new Date().toISOString(),
+            data: value
+        };
+        return this.writeCache();
+    }
+    /**
+     * Clears the entire cache.
+     */
+    clear() {
+        this.cache = {};
+        return this.writeCache();
+    }
+    /**
+     * Loads the cache from the cache file.
+     * @param options
+     * @param options.throwOnError Whether to throw an error if the cache file cannot be read.
+     */
+    async initialize(options = {}) {
+        const { excludeExpiredEntries = true, throwOnError = false } = options;
+        if (this.options.disableCache) {
+            this.options.logger.debug?.('Cache is disabled; skipping initialization.');
+            return;
+        }
+        try {
+            this.cache = JSON.parse(await (0, promises_1.readFile)(this.options.cacheFilePath, { encoding: 'utf8' }));
+            if (excludeExpiredEntries) {
+                let cacheUpdated = false;
+                Object.keys(this.cache).forEach((key) => {
+                    if (this.isExpired(key)) {
+                        delete this.cache[key];
+                        cacheUpdated = true;
+                    }
+                });
+                if (cacheUpdated) {
+                    await this.writeCache();
+                }
+            }
+        }
+        catch (e) {
+            this.options.logger.warn?.(`Could not read cache file at ${this.options.cacheFilePath}, starting with empty cache.`);
+            if (throwOnError) {
+                throw e;
+            }
+        }
+    }
+    /**
+     * Iterates over all cache entries.
+     * @param callback
+     * @param options
+     */
+    forEach(callback, options = {}) {
+        Object.keys(this.cache).forEach((key) => callback(key, this.get(key, options)));
+    }
+    /**
+     * Checks if a cache entry is expired.
+     * @param key
+     */
+    isExpired(key) {
+        const entry = this.cache[key];
+        if (!entry) {
+            return true;
+        }
+        if (this.options.cacheEntryExpireAfterDays) {
+            const ageMs = Date.now() - new Date(entry.updatedAt).getTime();
+            return ageMs > (this.options.cacheEntryExpireAfterDays * MS_IN_A_DAY);
+        }
+        return false;
+    }
+    /**
+     * Returns the available keys
+     * @param options
+     */
+    getKeys(options = {}) {
+        const { excludeExpiredEntries = true } = options;
+        if (!excludeExpiredEntries) {
+            return Object.keys(this.cache);
+        }
+        return Object.keys(this.cache).filter((key) => !this.isExpired(key));
+    }
+    /**
+     * Returns the available entries
+     * @param options
+     */
+    getEntries(options = {}) {
+        const { excludeExpiredEntries = true } = options;
+        if (!excludeExpiredEntries) {
+            return Object.entries(this.cache).map(([key, entry]) => [key, entry.data]);
+        }
+        return Object.entries(this.cache)
+            .filter(([key]) => !this.isExpired(key))
+            .map(([key, entry]) => [key, entry.data]);
+    }
+}
+exports.CacheManager = CacheManager;
+//# sourceMappingURL=index.js.map

package/src/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":"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"}

package/src/logger/index.d.ts

@@ -1,10 +1,33 @@
+/**
+ * Log levels for MCP server logging
+ * @experimental
+ */
 export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
 /**
  * Logger type for MCP server
+ * @experimental
  */
 export type Logger = {
     [K in LogLevel]?: (message: string, meta?: any) => any;
 };
+/**
+ * Options for a tool using a logger
+ * @experimental
+ */
+export interface LoggerToolOptions {
+    /**
+     * Logger instance to use for the tool
+     */
+    logger?: Logger;
+    /**
+     * Log level for the tool logger
+     */
+    logLevel?: LogLevel;
+}
+/**
+ * MCP Logger implementation
+ * @experimental
+ */
 export declare class MCPLogger implements Logger {
     private readonly name;
     private level;

package/src/logger/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;KAMlB,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG;CACvD,CAAC;AAmBF,qBAAa,SAAU,YAAW,MAAM;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,KAAK;gBADI,IAAI,EAAE,MAAM,EACrB,KAAK,GAAE,QAAiB;IAKlC,OAAO,CAAC,GAAG;IAMJ,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAOxB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAIjC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAIhC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAIhC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAGzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;KAMlB,CAAC,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAoBD;;;GAGG;AACH,qBAAa,SAAU,YAAW,MAAM;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,KAAK;gBADI,IAAI,EAAE,MAAM,EACrB,KAAK,GAAE,QAAiB;IAKlC,OAAO,CAAC,GAAG;IAMJ,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAOxB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAIjC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAIhC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAIhC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAGzC"}

package/src/logger/index.js

@@ -15,6 +15,10 @@ const logInStderr = (name, level, message, meta) => process.stderr.write(JSON.st
     message,
     meta
 }) + '\n');
+/**
+ * MCP Logger implementation
+ * @experimental
+ */
 class MCPLogger {
     constructor(name, level = 'info') {
         this.name = name;

package/src/logger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":";;;AAcA,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAA+B,CAAC;AAE/F;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,KAAe,EAAE,OAAe,EAAE,IAAU,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CACtG,IAAI,CAAC,SAAS,CAAC;IACb,IAAI;IACJ,KAAK;IACL,OAAO;IACP,IAAI;CACL,CAAC,GAAG,IAAI,CACV,CAAC;AACF,MAAa,SAAS;IACpB,YACmB,IAAY,EACrB,QAAkB,MAAM;QADf,SAAI,GAAJ,IAAI,CAAQ;QACrB,UAAK,GAAL,KAAK,CAAmB;QAEhC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAU;QACtD,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEM,QAAQ,CAAC,KAAe;QAC7B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAAU;QACtC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAAU;QACrC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAAU;QACrC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAAU;QACtC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AApCD,8BAoCC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":";;;AAkCA,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAA+B,CAAC;AAE/F;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,KAAe,EAAE,OAAe,EAAE,IAAU,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CACtG,IAAI,CAAC,SAAS,CAAC;IACb,IAAI;IACJ,KAAK;IACL,OAAO;IACP,IAAI;CACL,CAAC,GAAG,IAAI,CACV,CAAC;AAEF;;;GAGG;AACH,MAAa,SAAS;IACpB,YACmB,IAAY,EACrB,QAAkB,MAAM;QADf,SAAI,GAAJ,IAAI,CAAQ;QACrB,UAAK,GAAL,KAAK,CAAmB;QAEhC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAU;QACtD,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClE,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEM,QAAQ,CAAC,KAAe;QAC7B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAAU;QACtC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAAU;QACrC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAAU;QACrC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAAU;QACtC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AApCD,8BAoCC"}

package/src/public_api.d.ts

@@ -1,3 +1,4 @@
+export * from './cache/index';
 export * from './logger/index';
 export * from './resource/index';
 export * from './testing/index';

package/src/public_api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/src/public_api.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./cache/index"), exports);
 tslib_1.__exportStar(require("./logger/index"), exports);
 tslib_1.__exportStar(require("./resource/index"), exports);
 tslib_1.__exportStar(require("./testing/index"), exports);

package/src/public_api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public_api.js","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":";;;AAAA,yDAA+B;AAC/B,2DAAiC;AACjC,0DAAgC;AAChC,uDAA6B"}
+{"version":3,"file":"public_api.js","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,yDAA+B;AAC/B,2DAAiC;AACjC,0DAAgC;AAChC,uDAA6B"}

package/src/resource/index.d.ts

@@ -4,4 +4,10 @@
  * value: resource content
  */
 export declare const resourceRegistry: Map<string, string>;
+export interface ResourceToolOptions {
+    /**
+     * Prefix for resource URIs managed by the tool.
+     */
+    uriPrefix: string;
+}
 //# sourceMappingURL=index.d.ts.map

package/src/resource/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resource/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,qBAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resource/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,qBAA4B,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/src/testing/index.d.ts

@@ -4,6 +4,7 @@ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
  * Set up an MCP client and server for testing purposes.
  * DO NOT USE OUTSIDE OF TESTS.
  * @param mcpServer
+ * @experimental
  */
 export declare const setUpClientAndServerForTesting: (mcpServer: McpServer) => Promise<{
     mcpServer: McpServer;

package/src/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACP,MAAM,2CAA2C,CAAC;AAInD,OAAO,KAAK,EACV,SAAS,EACV,MAAM,yCAAyC,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GAAU,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAWxE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACP,MAAM,2CAA2C,CAAC;AAInD,OAAO,KAAK,EACV,SAAS,EACV,MAAM,yCAAyC,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GAAU,WAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;EAWxE,CAAC"}

package/src/testing/index.js

@@ -7,6 +7,7 @@ const inMemory_js_1 = require("@modelcontextprotocol/sdk/inMemory.js");
  * Set up an MCP client and server for testing purposes.
  * DO NOT USE OUTSIDE OF TESTS.
  * @param mcpServer
+ * @experimental
  */
 const setUpClientAndServerForTesting = async (mcpServer) => {
     const [clientTransport, serverTransport] = inMemory_js_1.InMemoryTransport.createLinkedPair();

package/src/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":";;;AAAA,wEAEmD;AACnD,uEAE+C;AAK/C;;;;GAIG;AACI,MAAM,8BAA8B,GAAG,KAAK,EAAE,SAAoB,EAAE,EAAE;IAC3E,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,+BAAiB,CAAC,gBAAgB,EAAE,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,iBAAM,CAAC;QACxB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;QAC/B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;KAC1C,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC,CAAC;AAXW,QAAA,8BAA8B,kCAWzC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":";;;AAAA,wEAEmD;AACnD,uEAE+C;AAK/C;;;;;GAKG;AACI,MAAM,8BAA8B,GAAG,KAAK,EAAE,SAAoB,EAAE,EAAE;IAC3E,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,+BAAiB,CAAC,gBAAgB,EAAE,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,iBAAM,CAAC;QACxB,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;QAC/B,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;KAC1C,CAAC,CAAC;IACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC,CAAC;AAXW,QAAA,8BAA8B,kCAWzC"}

package/src/tool/index.d.ts

@@ -1,16 +1,9 @@
-import type { Logger, LogLevel } from '../logger';
+import type { LoggerToolOptions } from '../logger';
 /**
  * Possible override for tool definition
+ * @experimental
  */
-export interface ToolDefinition {
-    /**
-     * Logger instance to use for the tool
-     */
-    logger?: Logger;
-    /**
-     * Log level for the tool logger
-     */
-    logLevel?: LogLevel;
+export interface ToolDefinition extends LoggerToolOptions {
     /**
      * Tool name
      */

package/src/tool/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tool/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACT,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tool/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAEnB;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}