@ama-mcp/core 13.3.0-prerelease.11

package/LICENSE

@@ -0,0 +1,26 @@
+Copyright Amadeus SAS
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,11 @@
+<h1 align="center">Otter MCP</h1>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/AmadeusITGroup/otter/main/assets/logo/otter.png" alt="Super cute Otter!" width="40%"/>
+</p>
+
+<br />
+<br />
+
+## Description
+
+This module provides utilities to interact inside an MCP server.

package/package.json

@@ -0,0 +1,158 @@
+{
+  "name": "@ama-mcp/core",
+  "version": "13.3.0-prerelease.11",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "This module provides utilities to interact inside an MCP server",
+  "keywords": [
+    "mcp",
+    "otter",
+    "otter-module"
+  ],
+  "module": "src/public_api.js",
+  "typings": "src/public_api.d.ts",
+  "sideEffects": false,
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "typings": "./src/public_api.d.ts",
+      "default": "./src/public_api.js"
+    }
+  },
+  "scripts": {
+    "nx": "nx",
+    "ng": "yarn nx",
+    "build": "yarn nx build ama-mcp-github",
+    "compile": "tsc -b ./tsconfig.build.json && yarn cpy package.json dist && patch-package-json-main"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.19.0"
+  },
+  "dependencies": {
+    "tslib": "^2.6.2"
+  },
+  "devDependencies": {
+    "@angular/common": "~20.3.0",
+    "@angular/compiler": "~20.3.0",
+    "@angular/compiler-cli": "~20.3.0",
+    "@angular/core": "~20.3.0",
+    "@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",
+    "@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.11",
+    "@o3r/eslint-config": "^13.3.0-prerelease.11",
+    "@o3r/eslint-plugin": "^13.3.0-prerelease.11",
+    "@o3r/test-helpers": "^13.3.0-prerelease.11",
+    "@stylistic/eslint-plugin": "~5.4.0",
+    "@types/jest": "~29.5.2",
+    "@types/node": "~22.18.0",
+    "@typescript-eslint/parser": "~8.46.0",
+    "angular-eslint": "~20.3.0",
+    "cpy-cli": "^6.0.0",
+    "eslint": "~9.37.0",
+    "eslint-import-resolver-node": "~0.3.9",
+    "eslint-import-resolver-typescript": "~4.4.0",
+    "eslint-plugin-import": "~2.32.0",
+    "eslint-plugin-import-newlines": "~1.4.0",
+    "eslint-plugin-jest": "~29.0.0",
+    "eslint-plugin-jsdoc": "~54.7.0",
+    "eslint-plugin-prefer-arrow": "~1.2.3",
+    "eslint-plugin-unicorn": "~60.0.0",
+    "eslint-plugin-unused-imports": "~4.2.0",
+    "globals": "^16.0.0",
+    "jest": "~29.7.0",
+    "jest-environment-jsdom": "~29.7.0",
+    "jest-junit": "~16.0.0",
+    "jest-preset-angular": "~14.6.0",
+    "jest-util": "~29.7.0",
+    "jsonc-eslint-parser": "~2.4.0",
+    "nx": "~21.6.0",
+    "rxjs": "^7.8.1",
+    "ts-jest": "~29.4.0",
+    "ts-node": "~10.9.2",
+    "type-fest": "^4.30.1",
+    "typescript": "~5.9.2",
+    "typescript-eslint": "~8.46.0",
+    "zone.js": "~0.15.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || ^22.17.0 || ^24.0.0"
+  },
+  "contributors": [
+    {
+      "name": "Yannick Adam",
+      "url": "https://github.com/yannickadam",
+      "email": "yannickadam@users.noreply.github.com"
+    },
+    {
+      "name": "Kilian Panot",
+      "url": "https://github.com/kpanot",
+      "email": "kpanot@users.noreply.github.com"
+    },
+    {
+      "name": "Jeremy Bourgeois",
+      "url": "https://github.com/jbourgeois-1A",
+      "email": "jbourgeois-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Pierre Henri Ginoux",
+      "url": "https://github.com/pginoux-1A",
+      "email": "pginoux-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Mircea Vasile Rednic",
+      "url": "https://github.com/mrednic-1A",
+      "email": "mrednic-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Stephane Dalle",
+      "url": "https://github.com/sdalle-1A",
+      "email": "sdalle-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Nicolas Hoffmann",
+      "url": "https://github.com/nhoffmann-1A",
+      "email": "nhoffmann-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Victor Scaiceanu",
+      "url": "https://github.com/vscaiceanu-1a",
+      "email": "vscaiceanu-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Florian Paul",
+      "url": "https://github.com/fpaul-1A",
+      "email": "fpaul-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Corinne Paulve",
+      "url": "https://github.com/cpaulve-1A",
+      "email": "cpaulve-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Matthieu Crouzet",
+      "url": "https://github.com/matthieu-crouzet",
+      "email": "matthieu-crouzet@users.noreply.github.com"
+    },
+    {
+      "name": "Salome Do",
+      "url": "https://github.com/sdo-1A",
+      "email": "sdo-1A@users.noreply.github.com"
+    }
+  ],
+  "bugs": "https://github.com/AmadeusITGroup/otter/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AmadeusITGroup/otter.git"
+  },
+  "license": "BSD-3-Clause",
+  "homepage": "https://amadeusitgroup.github.io/otter/"
+}

package/src/logger/index.d.ts

@@ -0,0 +1,18 @@
+type Level = 'error' | 'warn' | 'info' | 'debug';
+/**
+ * Logger type for MCP server
+ */
+export type Logger = {
+    [K in Level]?: (message: string, meta?: any) => any;
+};
+/**
+ * Logger for MCP server
+ */
+export declare const logger: {
+    readonly error: (message: string, meta?: any) => any;
+    readonly warn: (message: string, meta?: any) => any;
+    readonly info: (message: string, meta?: any) => any;
+    readonly debug: (message: string, meta?: any) => any;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":"AAAA,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;KAMlB,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,GAAG;CACpD,CAAC;AAcF;;GAEG;AACH,eAAO,MAAM,MAAM;8BAlBQ,MAAM,SAAS,GAAG,KAAK,GAAG;6BAA1B,MAAM,SAAS,GAAG,KAAK,GAAG;6BAA1B,MAAM,SAAS,GAAG,KAAK,GAAG;8BAA1B,MAAM,SAAS,GAAG,KAAK,GAAG;CAuB1B,CAAC"}

package/src/logger/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+/**
+ * Logging as error as recommended by modelcontextprotocol.io (https://modelcontextprotocol.io/quickstart/server#quick-examples-2)
+ * @param level
+ */
+const logInStderr = (level) => (message, meta) => process.stderr.write(JSON.stringify({
+    level,
+    message,
+    meta
+}) + '\n');
+/**
+ * Logger for MCP server
+ */
+exports.logger = {
+    error: logInStderr('error'),
+    warn: logInStderr('warn'),
+    info: logInStderr('info'),
+    debug: logInStderr('debug')
+};
+//# sourceMappingURL=index.js.map

package/src/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":";;;AAcA;;;GAGG;AACH,MAAM,WAAW,GAAG,CAAC,KAAY,EAA2B,EAAE,CAAC,CAAC,OAAe,EAAE,IAAU,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClH,IAAI,CAAC,SAAS,CAAC;IACb,KAAK;IACL,OAAO;IACP,IAAI;CACL,CAAC,GAAG,IAAI,CACV,CAAC;AAEF;;GAEG;AACU,QAAA,MAAM,GAAG;IACpB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;IAC3B,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC;CACF,CAAC"}

package/src/public_api.d.ts

@@ -0,0 +1,5 @@
+export * from './logger/index';
+export * from './resource/index';
+export * from './testing/index';
+export * from './tool/index';
+//# sourceMappingURL=public_api.d.ts.map

package/src/public_api.d.ts.map

@@ -0,0 +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"}

package/src/public_api.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./logger/index"), exports);
+tslib_1.__exportStar(require("./resource/index"), exports);
+tslib_1.__exportStar(require("./testing/index"), exports);
+tslib_1.__exportStar(require("./tool/index"), exports);
+//# sourceMappingURL=public_api.js.map

package/src/public_api.js.map

@@ -0,0 +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"}

package/src/resource/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A registry to store resources in memory and retrieve them by their URI.
+ * key: resource URI
+ * value: resource content
+ */
+export declare const resourceRegistry: Map<string, string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resource/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,qBAA4B,CAAC"}

package/src/resource/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resourceRegistry = void 0;
+/**
+ * A registry to store resources in memory and retrieve them by their URI.
+ * key: resource URI
+ * value: resource content
+ */
+exports.resourceRegistry = new Map();
+//# sourceMappingURL=index.js.map

package/src/resource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resource/index.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC"}

package/src/testing/index.d.ts

@@ -0,0 +1,34 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+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
+ */
+export declare const setUpClientAndServerForTesting: (mcpServer: McpServer) => Promise<{
+    mcpServer: McpServer;
+    client: Client<{
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | undefined;
+    }, {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    }>;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/src/testing/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUpClientAndServerForTesting = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+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
+ */
+const setUpClientAndServerForTesting = async (mcpServer) => {
+    const [clientTransport, serverTransport] = inMemory_js_1.InMemoryTransport.createLinkedPair();
+    const client = new index_js_1.Client({
+        name: 'test-client',
+        version: '1.0.0'
+    });
+    await Promise.all([
+        client.connect(clientTransport),
+        mcpServer.server.connect(serverTransport)
+    ]);
+    return { mcpServer, client };
+};
+exports.setUpClientAndServerForTesting = setUpClientAndServerForTesting;
+//# sourceMappingURL=index.js.map

package/src/testing/index.js.map

@@ -0,0 +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"}

package/src/tool/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Possible override for tool definition
+ */
+export interface ToolDefinition {
+    /**
+     * Tool name
+     */
+    toolName?: string;
+    /**
+     * Tool description
+     */
+    toolDescription?: string;
+    /**
+     * Tool title
+     */
+    toolTitle?: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tool/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/src/tool/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/src/tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tool/index.ts"],"names":[],"mappings":""}