@ama-mcp/github 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,17 @@
+<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 a set of MCP tools to retrieve information from GitHub.
+
+## Tools
+
+- [get_repositories_using_<library_name>](./src/find-repositories-using-library/README.md)
+- [get_release_notes_<library_name>](./src/release-notes/README.md)
+- [get_supported_releases_<library_name>](./src/supported-releases/README.md)

package/package.json

@@ -0,0 +1,165 @@
+{
+  "name": "@ama-mcp/github",
+  "version": "13.3.0-prerelease.11",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "This module provides a set of MCP tools to retrieve information from GitHub",
+  "keywords": [
+    "mcp",
+    "github",
+    "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": {
+    "@ama-mcp/core": "^13.3.0-prerelease.11",
+    "@modelcontextprotocol/sdk": "~1.19.0",
+    "@octokit/rest": "^22.0.0",
+    "zod": "~3.25.76"
+  },
+  "dependencies": {
+    "tslib": "^2.6.2"
+  },
+  "devDependencies": {
+    "@ama-mcp/core": "^13.3.0-prerelease.11",
+    "@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",
+    "@octokit/rest": "~22.0.0",
+    "@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",
+    "zod": "~3.25.76",
+    "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/find-repositories-using-library/index.d.ts

@@ -0,0 +1,40 @@
+import { type Logger, type ToolDefinition } from '@ama-mcp/core';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { GithubToolOptions } from '../utils';
+/**
+ * Options for the tool get_repositories_using_library
+ */
+export interface GetRepositoriesUsingLibraryOptions extends GithubToolOptions, ToolDefinition {
+    /**
+     * Scopes to look for when searching for repositories
+     * (e.g. for @ama-mcp/github, the scope is ama-mcp)
+     * Limit to 10 scopes to avoid hitting GitHub search API rate limit
+     * @example ['ama-mcp', 'o3r']
+     */
+    scopes: string[];
+    /**
+     * Name of the library to look for in the dependencies
+     * @example 'Otter'
+     */
+    libraryName: string;
+    /**
+     * Path to cache the results
+     */
+    cachePath?: string;
+    /**
+     * Whether to use the cached results if available
+     */
+    disableCache?: boolean;
+    /**
+     * Maximum age in days of the cache for a repository to be considered valid
+     */
+    cacheMaxAge?: number;
+}
+/**
+ * Register the tool to get repositories using a configured library.
+ * @param server
+ * @param options
+ * @param logger
+ */
+export declare function registerGetRepositoriesUsingLibraryTool(server: McpServer, options: GetRepositoriesUsingLibraryOptions, logger?: Logger): void;
+//# sourceMappingURL=index.d.ts.map

package/src/find-repositories-using-library/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/find-repositories-using-library/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,SAAS,EACV,MAAM,yCAAyC,CAAC;AAOjD,OAAO,KAAK,EACV,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,kCAAmC,SAAQ,iBAAiB,EAAE,cAAc;IAC3F;;;;;OAKG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+KD;;;;;GAKG;AACH,wBAAgB,uCAAuC,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,kCAAkC,EAAE,MAAM,CAAC,EAAE,MAAM,QAoDtI"}

package/src/find-repositories-using-library/index.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetRepositoriesUsingLibraryTool = registerGetRepositoriesUsingLibraryTool;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const core_1 = require("@ama-mcp/core");
+const rest_1 = require("@octokit/rest");
+const zod_1 = require("zod");
+async function listRepos(octokit, options, logger) {
+    // We use several requests and not only one with OR
+    // because GitHub search API has some limitations in the query length and complexity
+    // Note: We can do only 10 searches per minute,
+    // so we should found another solution if we have more than 10 scopes to look for.
+    const search = (await Promise.allSettled(options.scopes
+        .map(async (scope) => {
+        const repos = (await octokit.paginate(octokit.search.code, { q: `@${scope}/ filename:package.json`, per_page: 100 }))
+            // eslint-disable-next-line @typescript-eslint/naming-convention -- Naming convention from GitHub API
+            .map(({ repository: { name, full_name, fork, archived, default_branch } }) => ({ name, full_name, fork, archived, default_branch }))
+            .filter((repo) => !repo.archived && !repo.fork);
+        logger?.info?.(`Found ${repos.length} repositories with references to @${scope} in package.json`);
+        return repos;
+    }))).filter((result) => result.status === 'fulfilled')
+        .flatMap((result) => result.value);
+    // Deduplicate repositories in case of multiple scopes matching the same repository
+    const repositories = Array.from(new Map(search.map((repo) => [repo.full_name, repo])).values());
+    logger?.info?.(`Found ${repositories.length} repositories with references to ${options.libraryName}`);
+    return repositories;
+}
+function findPackageJsonFiles(octokit) {
+    return async (repository) => {
+        const [owner, repo] = repository.full_name.split('/');
+        const { data: { commit: { sha } } } = await octokit.repos.getBranch({
+            owner,
+            repo,
+            branch: repository.default_branch || 'main'
+        });
+        const { data: { tree } } = await octokit.git.getTree({
+            owner,
+            repo,
+            tree_sha: sha
+        });
+        return tree.filter((t) => t.type === 'blob' && t.path.endsWith('package.json'));
+    };
+}
+function dependsOnLibrary(octokit, options) {
+    return async (repository, packageJsonPath) => {
+        const [owner, repo] = repository.full_name.split('/');
+        const { data } = await octokit.repos.getContent({
+            owner,
+            repo,
+            path: packageJsonPath
+        });
+        if (Array.isArray(data) || data.type !== 'file' || data.encoding !== 'base64') {
+            throw new Error('Unexpected content response structure');
+        }
+        const content = Buffer.from(data.content, 'base64').toString('utf8');
+        const packageJson = JSON.parse(content);
+        const scopeRegex = new RegExp(`^@(?:${options.scopes.join('|')})/`);
+        return [
+            ...Object.keys(packageJson.devDependencies || {}),
+            ...Object.keys(packageJson.dependencies || {})
+        ].some((dep) => scopeRegex.test(dep));
+    };
+}
+const DEFAULT_AMA_MCP_CACHE_MAX_AGE = 90;
+const convertDaysToMs = (days) => days * 1000 * 60 * 60 * 24;
+function validateCache(cachedRepos, options, logger) {
+    const now = Date.now();
+    const maxAge = convertDaysToMs(options.cacheMaxAge || DEFAULT_AMA_MCP_CACHE_MAX_AGE);
+    Object.entries(cachedRepos).forEach(([repo, { when }]) => {
+        const whenDate = new Date(when);
+        if (Number.isNaN(whenDate.getTime()) || (now - whenDate.getTime()) > maxAge) {
+            logger.info?.(`Cache for repository ${repo} is outdated or invalid, removing it`);
+            delete cachedRepos[repo];
+        }
+    });
+}
+async function findRepositoriesUsingLibrary(octokit, reposUsingLibrary, options, logger = core_1.logger) {
+    const { cachePath = (0, node_path_1.resolve)('.cache', '@ama-mcp', `repos-using-${options.libraryName.toLowerCase().replaceAll(/\s+/g, '-')}.json`), disableCache = false } = options;
+    let cachedRepos = {};
+    if (disableCache) {
+        logger?.info?.('Ignoring cached repositories as caching is disabled');
+    }
+    else {
+        try {
+            cachedRepos = JSON.parse(await (0, promises_1.readFile)(cachePath, { encoding: 'utf8' }));
+            validateCache(cachedRepos, options, logger);
+            reposUsingLibrary.push(...Object.entries(cachedRepos).filter(([, usesLibrary]) => usesLibrary).map(([repo]) => repo));
+            logger?.info?.(`Loaded ${Object.keys(cachedRepos).length} cached repositories, ${reposUsingLibrary.length} of them using ${options.libraryName} dependencies.`);
+        }
+        catch (e) {
+            logger?.info?.(`No cache file found, starting fresh search for repositories using ${options.libraryName} dependencies.`, e);
+        }
+    }
+    const repositories = (await listRepos(octokit, options)).filter((r) => !cachedRepos[r.full_name]?.dependsOn);
+    const findPackageJsonFilesInRepo = findPackageJsonFiles(octokit);
+    const dependsOnLibraryInRepo = dependsOnLibrary(octokit, options);
+    await Promise.allSettled(repositories.map(async (repository) => {
+        logger?.debug?.(`Checking repository ${repository.full_name}...`);
+        const packageJsonFiles = [];
+        try {
+            packageJsonFiles.push(...await findPackageJsonFilesInRepo(repository));
+        }
+        catch (e) {
+            logger?.warn?.(`Failed to list package.json files in repository ${repository.full_name}`, e);
+        }
+        if (packageJsonFiles.length === 0) {
+            logger?.info?.(`No package.json files found in repository ${repository.full_name}`);
+            cachedRepos[repository.full_name] = {
+                dependsOn: false,
+                when: new Date().toISOString()
+            };
+            return;
+        }
+        try {
+            await Promise.any(packageJsonFiles.map(async (packageJsonFile) => {
+                let depFound = false;
+                try {
+                    depFound = await dependsOnLibraryInRepo(repository, packageJsonFile.path);
+                }
+                catch (e) {
+                    logger?.error?.(`Failed to check package.json file at ${packageJsonFile.path} in repository ${repository.full_name}`, e);
+                }
+                if (depFound) {
+                    reposUsingLibrary.push(repository.full_name);
+                    logger?.info?.(`Repository ${repository.full_name} uses ${options.libraryName} dependencies`);
+                    cachedRepos[repository.full_name] = {
+                        dependsOn: true,
+                        when: new Date().toISOString()
+                    };
+                }
+                else {
+                    throw new Error(`No ${options.libraryName} dependencies found in this package.json`);
+                }
+            }));
+        }
+        catch { }
+        cachedRepos[repository.full_name] ||= {
+            dependsOn: false,
+            when: new Date().toISOString()
+        };
+    }));
+    logger?.info?.(`Found ${reposUsingLibrary.length} repositories using ${options.libraryName} dependencies`);
+    if (disableCache) {
+        logger?.info?.('Not updating cache as caching is disabled');
+    }
+    else {
+        const cacheFolderPath = (0, node_path_1.dirname)(cachePath);
+        if (!(0, node_fs_1.existsSync)((0, node_path_1.dirname)(cacheFolderPath))) {
+            await (0, promises_1.mkdir)(cacheFolderPath, { recursive: true });
+        }
+        try {
+            await (0, promises_1.writeFile)(cachePath, JSON.stringify(cachedRepos));
+        }
+        catch (e) {
+            logger?.error?.('Failed to update cache', e);
+        }
+    }
+}
+/**
+ * Register the tool to get repositories using a configured library.
+ * @param server
+ * @param options
+ * @param logger
+ */
+function registerGetRepositoriesUsingLibraryTool(server, options, logger) {
+    const { githubToken, libraryName, toolName = `get_repositories_using_${options.libraryName.toLowerCase().replaceAll(/\s+/g, '_')}`, toolTitle = `Get repositories using ${options.libraryName} dependencies`, toolDescription = `List all repositories that use ${options.libraryName} dependencies (${options.scopes.map((scope) => `@${scope}`).join(' or ')}) in their package.json files.` } = options;
+    if (!githubToken) {
+        logger?.error?.(`Missing githubToken for ${toolName}`);
+        return;
+    }
+    const octokit = new rest_1.Octokit({ auth: githubToken });
+    let isLookingForRepos = true;
+    const reposUsingLibrary = [];
+    findRepositoriesUsingLibrary(octokit, reposUsingLibrary, options).catch((e) => {
+        logger?.error?.(`Error finding repositories using ${libraryName}:`, e);
+    });
+    isLookingForRepos = false;
+    server.registerTool(toolName, {
+        title: toolTitle,
+        description: toolDescription,
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: false
+        },
+        outputSchema: {
+            repositories: zod_1.z.array(zod_1.z.string()).describe(`List of repositories depending on ${libraryName}`)
+        }
+    }, () => ({
+        content: [
+            {
+                type: 'text',
+                text: (isLookingForRepos ? 'I did not finish to look for repositories. For the moment:\n' : '')
+                    + reposUsingLibrary.length
+                    ? `The following repositories use ${libraryName} dependencies:\n`
+                        + reposUsingLibrary.sort().map((repo) => `- ${repo}`).join('\n')
+                    : `No repositories found using ${libraryName} dependencies.`
+            }
+        ],
+        structuredContent: {
+            repositories: reposUsingLibrary
+        }
+    }));
+}
+//# sourceMappingURL=index.js.map

package/src/find-repositories-using-library/index.js.map

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

package/src/public_api.d.ts

@@ -0,0 +1,4 @@
+export * from './find-repositories-using-library/index';
+export * from './release-notes/index';
+export * from './supported-releases/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,yCAAyC,CAAC;AACxD,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC"}

package/src/public_api.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./find-repositories-using-library/index"), exports);
+tslib_1.__exportStar(require("./release-notes/index"), exports);
+tslib_1.__exportStar(require("./supported-releases/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,kFAAwD;AACxD,gEAAsC;AACtC,qEAA2C"}

package/src/release-notes/index.d.ts

@@ -0,0 +1,24 @@
+import { type Logger, ToolDefinition } from '@ama-mcp/core';
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { GitHubRepositoryToolOptions } from '../utils';
+/**
+ * Options for the tool to get release notes
+ */
+export interface ReleaseNotesToolOptions extends GitHubRepositoryToolOptions, ToolDefinition {
+    /**
+     * Optional library name
+     */
+    libraryName?: string;
+    /**
+     * URI prefix for the resources
+     */
+    uriPrefix?: string;
+}
+/**
+ * Register the release notes tool and resources.
+ * @param server
+ * @param options
+ * @param logger
+ */
+export declare function registerReleaseNotes(server: McpServer, options: ReleaseNotesToolOptions, logger?: Logger): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/src/release-notes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/release-notes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,MAAM,EAEX,cAAc,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,SAAS,EAEf,MAAM,yCAAyC,CAAC;AAQjD,OAAO,KAAK,EACV,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,2BAA2B,EAAE,cAAc;IAC1F;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgGD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,GAAE,MAAsB,iBAe7H"}

package/src/release-notes/index.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerReleaseNotes = registerReleaseNotes;
+const core_1 = require("@ama-mcp/core");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const rest_1 = require("@octokit/rest");
+const zod_1 = require("zod");
+const getDefaultUriPrefix = (options) => options.libraryName || options.repo;
+const getUri = (uriPrefix, tagName) => `${uriPrefix}://release-notes/${tagName}`;
+const formatContent = (releaseNote) => `# ${releaseNote.tag_name}\n\n${releaseNote.body}`;
+async function getReleaseNotes(octokit, options) {
+    const { owner, repo, uriPrefix = getDefaultUriPrefix(options) } = options;
+    const minorsReleaseNotes = (await octokit.paginate(octokit.repos.listReleases, { owner, repo }))
+        .filter((release) => /^v\d+\.\d+\.0$/.test(release.tag_name));
+    const releaseNotes = new Map(minorsReleaseNotes.map((releaseNote) => [releaseNote.tag_name, releaseNote]));
+    releaseNotes.forEach((value) => core_1.resourceRegistry.set(getUri(uriPrefix, value.tag_name), formatContent(value)));
+    return releaseNotes;
+}
+function registerReleaseNotesResources(server, releaseNotes, options) {
+    const { libraryName = `${options.owner}/${options.repo}`, uriPrefix = getDefaultUriPrefix(options) } = options;
+    server.registerResource(`${libraryName} release notes`, new mcp_js_1.ResourceTemplate(getUri(uriPrefix, '{tagName}'), {
+        list: undefined,
+        complete: {
+            tagName: (value) => {
+                const tagNames = Array.from(releaseNotes.keys());
+                return tagNames.filter((tagName) => tagName.startsWith(value));
+            }
+        }
+    }), {
+        description: `${libraryName}'s release notes`,
+        mimeType: 'text/markdown'
+    }, (uri, { tagName }) => ({
+        contents: (Array.isArray(tagName) ? tagName : [tagName])
+            .filter((tag) => !!releaseNotes.get(tag))
+            .map((tag) => ({
+            uri: uri.href,
+            text: core_1.resourceRegistry.get(getUri(uriPrefix, tag)),
+            mimeType: 'text/markdown'
+        }))
+    }));
+}
+function registerReleaseNotesTool(server, releaseNotes, options) {
+    const libraryName = options.libraryName || `${options.owner}/${options.repo}`;
+    const { toolName = `get_release_notes_${libraryName.toLowerCase().replaceAll(/\s+/g, '_')}`, toolDescription = `Get the release notes for the ${libraryName} releases`, toolTitle = `Get ${libraryName} release notes`, uriPrefix = getDefaultUriPrefix(options) } = options;
+    server.registerTool(toolName, {
+        title: toolTitle,
+        description: toolDescription,
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: false
+        },
+        inputSchema: {
+            version: zod_1.z.string().optional()
+                .describe('The version of the release notes to get, if not provided all release notes will be returned. Format to use is vX.Y.0, e.g. v13.1.0')
+        }
+    }, ({ version }) => {
+        const targetedReleaseNote = version && releaseNotes.get(version);
+        return {
+            content: (targetedReleaseNote ? [targetedReleaseNote] : Array.from(releaseNotes.values()))
+                .flatMap((releaseNote) => {
+                const uri = getUri(uriPrefix, releaseNote.tag_name);
+                return [{
+                        type: 'text',
+                        text: core_1.resourceRegistry.get(uri) || 'Not found'
+                    }, {
+                        type: 'resource_link',
+                        name: `Release note ${releaseNote.tag_name}`,
+                        uri
+                    }];
+            })
+        };
+    });
+}
+/**
+ * Register the release notes tool and resources.
+ * @param server
+ * @param options
+ * @param logger
+ */
+async function registerReleaseNotes(server, options, logger = core_1.logger) {
+    const { githubToken, libraryName = `${options.owner}/${options.repo}` } = options;
+    if (!githubToken) {
+        logger.error?.(`Missing githubToken for release notes tool and resources for ${libraryName}`);
+        return;
+    }
+    const octokit = new rest_1.Octokit({ auth: githubToken });
+    const releaseNotes = await getReleaseNotes(octokit, options);
+    logger.info?.(`Found ${releaseNotes.size} release notes for ${libraryName}`, releaseNotes);
+    registerReleaseNotesResources(server, releaseNotes, options);
+    registerReleaseNotesTool(server, releaseNotes, options);
+}
+//# sourceMappingURL=index.js.map

package/src/release-notes/index.js.map

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

package/src/supported-releases/index.d.ts

@@ -0,0 +1,20 @@
+import { type Logger, type ToolDefinition } from '@ama-mcp/core';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { GitHubRepositoryToolOptions } from '../utils';
+/**
+ * Options for the tool to get supported releases
+ */
+export interface SupportedReleasesOptions extends ToolDefinition, GitHubRepositoryToolOptions {
+    /**
+     * Optional library name
+     */
+    libraryName?: string;
+}
+/**
+ * Register the supported releases tool.
+ * @param server
+ * @param options
+ * @param logger
+ */
+export declare function registerSupportedReleasesTool(server: McpServer, options: SupportedReleasesOptions, logger?: Logger): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/src/supported-releases/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/supported-releases/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,SAAS,EACV,MAAM,yCAAyC,CAAC;AAOjD,OAAO,KAAK,EACV,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc,EAAE,2BAA2B;IAC3F;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAYD;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,wBAAwB,EAAE,MAAM,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCvJ"}

package/src/supported-releases/index.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSupportedReleasesTool = registerSupportedReleasesTool;
+const core_1 = require("@ama-mcp/core");
+const rest_1 = require("@octokit/rest");
+const zod_1 = require("zod");
+async function getSupportedReleases(octokit, options, logger) {
+    const { owner, repo } = options;
+    const supportedReleases = (await octokit.paginate(octokit.repos.listBranches, { owner, repo }))
+        .filter((branch) => /^release\/\d+\.\d+$/.test(branch.name))
+        .map((branch) => branch.name.replace('release/', ''));
+    logger.info?.(`Supported releases:\n${supportedReleases.map((r) => `  - ${r}`).join('\n')}`);
+    return supportedReleases;
+}
+/**
+ * Register the supported releases tool.
+ * @param server
+ * @param options
+ * @param logger
+ */
+async function registerSupportedReleasesTool(server, options, logger = core_1.logger) {
+    const { githubToken, libraryName = `${options.owner}/${options.repo}`, toolName = `get_supported_releases_${libraryName.toLowerCase().replaceAll(/\s+/g, '_')}`, toolDescription = `Get the list of supported releases for ${libraryName}`, toolTitle = `Get Supported Releases for ${libraryName}` } = options;
+    if (!githubToken) {
+        logger.error?.(`Missing githubToken for ${toolName}`);
+        return;
+    }
+    const octokit = new rest_1.Octokit({ auth: githubToken });
+    const supportedReleases = await getSupportedReleases(octokit, options, logger);
+    server.registerTool(toolName, {
+        title: toolTitle,
+        description: toolDescription,
+        outputSchema: {
+            releases: zod_1.z.array(zod_1.z.string()).describe('List of supported releases')
+        }
+    }, () => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `The supported releases for ${libraryName} are: \n${supportedReleases.map((r) => `  - ${r}`).join('\n')}`
+                }
+            ],
+            structuredContent: {
+                releases: supportedReleases
+            }
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/src/supported-releases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/supported-releases/index.ts"],"names":[],"mappings":";;AA4CA,sEAuCC;AAnFD,wCAIuB;AAIvB,wCAEuB;AACvB,6BAEa;AAeb,KAAK,UAAU,oBAAoB,CAAC,OAAgB,EAAE,OAAiC,EAAE,MAAc;IACrG,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAChC,MAAM,iBAAiB,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;SAC5F,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IAExD,MAAM,CAAC,IAAI,EAAE,CAAC,wBAAwB,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7F,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,6BAA6B,CAAC,MAAiB,EAAE,OAAiC,EAAE,SAAiB,aAAa;IACtI,MAAM,EACJ,WAAW,EACX,WAAW,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,EAChD,QAAQ,GAAG,0BAA0B,WAAW,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EACxF,eAAe,GAAG,0CAA0C,WAAW,EAAE,EACzE,SAAS,GAAG,8BAA8B,WAAW,EAAE,EACxD,GAAG,OAAO,CAAC;IACZ,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,EAAE,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,cAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACnD,MAAM,iBAAiB,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAE/E,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;QACE,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE;YACZ,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SACrE;KACF,EACD,GAAG,EAAE;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,8BAA8B,WAAW,WAAW,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAChH;aACF;YACD,iBAAiB,EAAE;gBACjB,QAAQ,EAAE,iBAAiB;aAC5B;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/src/utils.d.ts

@@ -0,0 +1,17 @@
+export interface GithubToolOptions {
+    /**
+     * GitHub authentication token
+     */
+    githubToken: string;
+}
+export interface GitHubRepositoryToolOptions extends GithubToolOptions {
+    /**
+     * GitHub repository owner
+     */
+    owner: string;
+    /**
+     * GitHub repository name
+     */
+    repo: string;
+}
+//# sourceMappingURL=utils.d.ts.map

package/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd"}

package/src/utils.js

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

package/src/utils.js.map

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