@ama-mcp/sdk 0.0.0 → 14.2.0-prerelease.19

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,124 @@
+# @ama-mcp/sdk
+
+MCP module to expose `SDK_CONTEXT.md` from installed packages to AI assistants.
+
+## Purpose
+
+When SDKs are generated using [@ama-sdk/schematics](https://www.npmjs.com/package/@ama-sdk/schematics), they can include an `SDK_CONTEXT.md` file that describes:
+- Available API domains and operations
+- Models used by each domain
+- Guidelines for AI tools to avoid hallucinations
+
+This MCP module automatically discovers and loads these context files from installed packages using Node.js's module resolution, then exposes them to AI assistants.
+
+## Configuration
+
+### VS Code `.vscode/mcp.json`
+
+Configure SDK packages directly in your `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "sdk-context": {
+      "command": "npx",
+      "args": ["ama-mcp-sdk", "--packages", "@my-scope/my-sdk-package", "@other-scope/other-sdk"]
+    }
+  }
+}
+```
+
+## Usage
+
+### CLI (for mcp.json)
+
+```bash
+# Specify packages with --packages flag
+ama-mcp-sdk --packages @my-scope/my-sdk @other-scope/other-sdk
+
+# Show help
+ama-mcp-sdk --help
+```
+
+### Programmatic (in custom MCP server)
+
+```typescript
+import { registerSdkContextToolAndResources } from '@ama-mcp/sdk';
+
+// With explicit packages
+await registerSdkContextToolAndResources(server, {
+  sdkPackages: ['@my-scope/my-sdk']
+});
+
+// Or reads from package.json sdkContext.packages automatically
+await registerSdkContextToolAndResources(server);
+```
+
+### Available Tool
+
+**`get_sdk_context`** - Retrieve SDK context for configured packages
+
+```
+// List all configured SDKs with context
+get_sdk_context()
+
+// Get context for specific package
+get_sdk_context({ packageName: "@my-scope/my-sdk-package" })
+```
+
+### Available Resources
+
+**`sdk-context://instructions`** - Usage guidelines for AI assistants
+
+This resource provides instructions on how to use SDK context effectively to avoid hallucinations when implementing features. AI assistants should read this resource before using the `get_sdk_context` tool.
+
+**`sdk-context://<package-name>`** - SDK context for each configured package
+
+Each configured SDK package that has an `SDK_CONTEXT.md` file is exposed as a resource.
+
+## How It Works
+
+1. Reads `sdkContext.packages` from project's `package.json` or uses CLI arguments
+2. Uses Node.js `require.resolve()` to automatically locate packages
+3. Loads `SDK_CONTEXT.md` from each resolved package
+4. Registers each as an MCP resource
+5. Provides a tool for AI assistants to query SDK information
+
+## Package Resolution
+
+The SDK automatically discovers packages using Node.js's `require.resolve()`. This means:
+
+- **No manual path configuration needed** - packages are found automatically
+- **Works with workspaces** - supports npm/yarn/pnpm workspace configurations
+- **Flexible installation** - works with local, global, or custom module paths
+- **Error handling** - clear error messages when packages aren't found
+
+If a package isn't found, ensure:
+1. The package is installed (`npm install <package-name>`)
+2. The package name is spelled correctly
+3. The package has an `SDK_CONTEXT.md` file in its root
+
+**Security**: The system validates package names to prevent path traversal attacks and only accepts valid npm package name patterns.
+
+## Troubleshooting
+
+### Package Not Found
+```
+Package "@my-scope/my-sdk" not found. Is it installed?
+```
+**Solution**: Install the package or verify the name in your configuration.
+
+### No SDK_CONTEXT.md Found
+```
+No SDK_CONTEXT.md found for @my-scope/my-sdk
+```
+**Solution**: Generate the context file using the command below.
+
+## Generating SDK Context
+
+SDK maintainers can generate `SDK_CONTEXT.md` using:
+
+```bash
+cd /path/to/sdk-project
+npx amasdk-update-sdk-context --interactive
+```

package/package.json

@@ -1,7 +1,146 @@
 {
   "name": "@ama-mcp/sdk",
-  "version": "0.0.0",
+  "version": "14.2.0-prerelease.19",
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "description": "Experimental package -- MCP module to expose SDK_CONTEXT.md from installed packages to AI assistants",
+  "keywords": [
+    "mcp",
+    "sdk",
+    "ai-context",
+    "otter-module"
+  ],
+  "sideEffects": false,
+  "bin": {
+    "ama-mcp-sdk": "./src/cli.js"
+  },
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    }
+  },
+  "scripts": {
+    "nx": "nx",
+    "ng": "yarn nx",
+    "build": "yarn nx build ama-mcp-sdk",
+    "compile": "tsc -b ./tsconfig.build.json && yarn cpy package.json dist && patch-package-json-main",
+    "copy:resources": "yarn cpy resources dist"
+  },
+  "dependencies": {
+    "@ama-mcp/core": "~14.2.0-prerelease.19",
+    "@modelcontextprotocol/sdk": "~1.27.0",
+    "@o3r/telemetry": "~14.2.0-prerelease.19",
+    "commander": "^14.0.0",
+    "tslib": "^2.6.2",
+    "zod": "~4.3.0"
+  },
+  "devDependencies": {
+    "@ama-mcp/core": "~14.2.0-prerelease.19",
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.4.0",
+    "@modelcontextprotocol/sdk": "~1.27.0",
+    "@nx/eslint": "~22.6.0",
+    "@nx/eslint-plugin": "~22.6.0",
+    "@nx/jest": "~22.6.0",
+    "@nx/js": "~22.6.0",
+    "@o3r/build-helpers": "^14.2.0-prerelease.19",
+    "@o3r/eslint-config": "^14.2.0-prerelease.19",
+    "@o3r/eslint-plugin": "^14.2.0-prerelease.19",
+    "@o3r/test-helpers": "^14.2.0-prerelease.19",
+    "@stylistic/eslint-plugin": "~5.10.0",
+    "@types/jest": "~30.0.0",
+    "@types/node": "~24.12.0",
+    "@typescript-eslint/parser": "~8.57.0",
+    "cpy-cli": "^6.0.0",
+    "eslint": "~9.39.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.15.0",
+    "eslint-plugin-jsdoc": "~61.7.0",
+    "eslint-plugin-prefer-arrow": "~1.2.3",
+    "eslint-plugin-unicorn": "~62.0.0",
+    "eslint-plugin-unused-imports": "~4.4.0",
+    "globals": "^16.0.0",
+    "jest": "~30.3.0",
+    "jest-junit": "~16.0.0",
+    "jsonc-eslint-parser": "~2.4.0",
+    "ts-jest": "~29.4.0",
+    "typescript": "~5.9.2",
+    "typescript-eslint": "~8.57.0",
+    "zod": "~4.3.0"
+  },
+  "engines": {
+    "node": "^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/resources/INSTRUCTIONS.md

@@ -0,0 +1,40 @@
+# SDK Context Usage Instructions
+
+When implementing features that use installed SDKs, use the `get_sdk_context` tool as your primary source of truth. The SDK context provides a structured methodology for understanding available operations, models, and their organization.
+
+> **Note**: The SDKs available through this MCP server are those explicitly configured in the server launch parameters (via `--packages` arguments or `sdkContext.packages` in `package.json`). Only these SDKs will have context available through the `get_sdk_context` tool.
+
+## Core Principle
+
+**Let the SDK context guide your implementation.** The context document describes the SDK's structure, available operations, and models. Base your responses on what you discover in the context rather than making assumptions.
+
+## Using the SDK Context
+
+1. **Query available SDK contexts** using `get_sdk_context` without arguments to discover configured SDKs
+2. **Retrieve the relevant SDK context** by calling `get_sdk_context` with the package name
+3. **Study the context's structure and methodology** - each SDK context describes how its operations and models are organized
+4. **Follow the patterns provided** - use the exact operation IDs, model imports, and domain organization as documented in the context
+
+## Fallback Discovery
+
+If the SDK context is unavailable or incomplete for a specific operation:
+
+- Search for OpenAPI/Swagger specification files (e.g., `openapi.yaml`, `swagger.json`, `spec.yaml`) in the project
+- Browse the SDK's source files to discover available API classes and methods
+- Check the SDK's `package.json` for entry points or documentation references
+
+## Key Principles
+
+- **Ground your responses in the context** - only use operations, models, and paths that exist in the SDK context or specification
+- **Respect the SDK's organization** - follow the domain structure and naming conventions provided
+- **Avoid assumptions** - if something is not documented in the context, verify its existence before using it
+
+## Troubleshooting
+
+### No SDK contexts found
+
+Ensure the SDK packages are:
+1. Listed in `package.json` under `sdkContext.packages`
+2. Or provided via CLI arguments: `--packages @scope/sdk-name`
+3. Installed in node_modules
+4. Have `SDK_CONTEXT.md` generated (use `amasdk-update-sdk-context` in the SDK project)

package/src/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/src/cli.d.ts.map

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

package/src/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@ama-mcp/core");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const telemetry_1 = require("@o3r/telemetry");
+const commander_1 = require("commander");
+const utils_1 = require("./helpers/utils");
+const mcp_server_1 = require("./server/mcp-server");
+const run = async () => {
+    const logger = new core_1.MCPLogger('@ama-mcp/sdk');
+    /**
+     * Validate and filter package names, logging warnings for invalid ones
+     * @param packageNames Raw package names from CLI
+     * @returns Validated package names
+     */
+    const validatePackages = (packageNames) => packageNames.filter((pkg) => {
+        const isValid = (0, utils_1.isValidPackageName)(pkg);
+        if (!isValid) {
+            logger.warn?.(`Invalid package name "${pkg}", skipping`);
+        }
+        return isValid;
+    });
+    /**
+     * CLI program configuration using Commander.js
+     *
+     * Sets up the command-line interface with options and help text for the SDK Context MCP server.
+     */
+    const program = new commander_1.Command();
+    program
+        .name('ama-mcp-sdk')
+        .description('SDK Context MCP Server\n\nExposes SDK_CONTEXT.md from installed packages to AI assistants.')
+        .option('-p, --packages <packages...>', 'List of SDK package names to expose (required if not configured in package.json)')
+        .addHelpText('after', `
+Examples:
+  ama-mcp-sdk --packages @my-scope/my-sdk @other-scope/other-sdk
+
+VS Code mcp.json example:
+  {
+    "servers": {
+      "sdk-context": {
+        "command": "npx",
+        "args": ["ama-mcp-sdk", "--packages", "@my-scope/my-sdk", "@other-scope/other-sdk"]
+      }
+    }
+  }`);
+    /**
+     * Parse CLI arguments and validate package names
+     *
+     * Extracts package names from command line arguments and validates them using
+     * the package name validation rules.
+     */
+    const { packages: rawPackages } = program.parse().opts();
+    const packages = validatePackages(rawPackages || []);
+    /**
+     * Main entry point for the SDK Context MCP server
+     *
+     * Initializes and starts the MCP server with SDK context tools and resources.
+     * The server exposes SDK_CONTEXT.md files from configured packages to AI assistants.
+     * @returns Promise that resolves when the server is successfully started
+     */
+    try {
+        const server = (0, mcp_server_1.createSdkContextServer)({
+            sdkPackages: packages.length > 0 ? packages : undefined,
+            logger
+        });
+        const transport = new stdio_js_1.StdioServerTransport();
+        await server.connect(transport);
+    }
+    catch (error) {
+        logger.error?.('Failed to start SDK Context MCP server:', error);
+        throw error;
+    }
+};
+void (0, telemetry_1.createCliWithMetrics)(run, '@ama-sdk/cli')();
+//# sourceMappingURL=cli.js.map

package/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";;;AAEA,wCAEuB;AACvB,wEAEmD;AACnD,8CAEwB;AACxB,yCAEmB;AACnB,2CAEyB;AACzB,oDAE6B;AAE7B,MAAM,GAAG,GAAG,KAAK,IAAmB,EAAE;IACpC,MAAM,MAAM,GAAG,IAAI,gBAAS,CAAC,cAAc,CAAC,CAAC;IAE7C;;;;OAIG;IACH,MAAM,gBAAgB,GAAG,CAAC,YAAsB,EAAY,EAAE,CAC5D,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,MAAM,OAAO,GAAG,IAAA,0BAAkB,EAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,EAAE,CAAC,yBAAyB,GAAG,aAAa,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IAEL;;;;OAIG;IACH,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,aAAa,CAAC;SACnB,WAAW,CAAC,4FAA4F,CAAC;SACzG,MAAM,CAAC,8BAA8B,EAAE,kFAAkF,CAAC;SAC1H,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;IAYtB,CAAC,CAAC;IAEJ;;;;;OAKG;IACH,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAErD;;;;;;OAMG;IACH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,mCAAsB,EAAC;YACpC,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACvD,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,EAAE,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;QACjE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AACF,KAAK,IAAA,gCAAoB,EAAC,GAAG,EAAE,cAAc,CAAC,EAAE,CAAC"}

package/src/helpers/context.d.ts

@@ -0,0 +1,21 @@
+import type { Logger } from '@ama-mcp/core';
+/**
+ * Information about a loaded SDK context
+ */
+export interface SdkContextInfo {
+    /** The npm package name */
+    packageName: string;
+    /** The content of the SDK_CONTEXT.md file */
+    content: string;
+    /** The resource URI for this context */
+    uri: string;
+}
+/**
+ * Load SDK contexts from explicitly configured packages
+ * @param sdkPackages List of package names to load
+ * @param contextFileName Name of the context file to load
+ * @param logger Optional logger for debug output
+ * @returns Array of loaded SDK context information
+ */
+export declare const loadSdkContexts: (sdkPackages: string[], contextFileName: string, logger?: Logger) => SdkContextInfo[];
+//# sourceMappingURL=context.d.ts.map

package/src/helpers/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/helpers/context.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,eAAe,CAAC;AAMvB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AA+CD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,EAAE,EAAE,iBAAiB,MAAM,EAAE,SAAS,MAAM,KAAG,cAAc,EAGvD,CAAC"}

package/src/helpers/context.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSdkContexts = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const utils_1 = require("./utils");
+/**
+ * Try to load SDK context for a single package using Node's module resolution
+ * @param packageName Package name to load
+ * @param contextFileName Name of the context file to load
+ * @param logger Optional logger for debug output
+ * @returns SDK context info or null if not found/invalid
+ */
+const tryLoadSdkContext = (packageName, contextFileName, logger) => {
+    if (!(0, utils_1.isValidPackageName)(packageName)) {
+        logger?.warn?.(`Skipping invalid package name: "${packageName}"`);
+        return null;
+    }
+    let packagePath = null;
+    // Try to resolve using Node's module resolution
+    try {
+        const packageJsonPath = require.resolve(`${packageName}/package.json`, { paths: [process.cwd()] });
+        packagePath = (0, node_path_1.dirname)(packageJsonPath);
+        logger?.debug?.(`Resolved ${packageName} using require.resolve: ${packagePath}`);
+    }
+    catch {
+        logger?.warn?.(`Package "${packageName}" not found. Is it installed?`);
+        return null;
+    }
+    const contextPath = (0, node_path_1.join)(packagePath, contextFileName);
+    if (!(0, node_fs_1.existsSync)(contextPath)) {
+        logger?.debug?.(`No SDK_CONTEXT.md found for ${packageName} at ${contextPath}`);
+        return null;
+    }
+    try {
+        const content = (0, node_fs_1.readFileSync)(contextPath, 'utf8');
+        logger?.debug?.(`Loaded SDK context for ${packageName}`);
+        return { packageName, content, uri: (0, utils_1.generateUri)(packageName) };
+    }
+    catch (error) {
+        logger?.error?.(`Failed to read SDK context for ${packageName}:`, error);
+        return null;
+    }
+};
+/**
+ * Load SDK contexts from explicitly configured packages
+ * @param sdkPackages List of package names to load
+ * @param contextFileName Name of the context file to load
+ * @param logger Optional logger for debug output
+ * @returns Array of loaded SDK context information
+ */
+const loadSdkContexts = (sdkPackages, contextFileName, logger) => sdkPackages
+    .map((pkg) => tryLoadSdkContext(pkg, contextFileName, logger))
+    .filter((ctx) => ctx !== null);
+exports.loadSdkContexts = loadSdkContexts;
+//# sourceMappingURL=context.js.map

package/src/helpers/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/helpers/context.ts"],"names":[],"mappings":";;;AAAA,qCAGiB;AACjB,yCAGmB;AAInB,mCAGiB;AAcjB;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,CACxB,WAAmB,EACnB,eAAuB,EACvB,MAAe,EACQ,EAAE;IACzB,IAAI,CAAC,IAAA,0BAAkB,EAAC,WAAW,CAAC,EAAE,CAAC;QACrC,MAAM,EAAE,IAAI,EAAE,CAAC,mCAAmC,WAAW,GAAG,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,WAAW,GAAkB,IAAI,CAAC;IAEtC,gDAAgD;IAChD,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACnG,WAAW,GAAG,IAAA,mBAAO,EAAC,eAAe,CAAC,CAAC;QACvC,MAAM,EAAE,KAAK,EAAE,CAAC,YAAY,WAAW,2BAA2B,WAAW,EAAE,CAAC,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,IAAI,EAAE,CAAC,YAAY,WAAW,+BAA+B,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,gBAAI,EAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IACvD,IAAI,CAAC,IAAA,oBAAU,EAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,EAAE,KAAK,EAAE,CAAC,+BAA+B,WAAW,OAAO,WAAW,EAAE,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,EAAE,KAAK,EAAE,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC;QACzD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,IAAA,mBAAW,EAAC,WAAW,CAAC,EAAE,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,KAAK,EAAE,CAAC,kCAAkC,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,CAAC,WAAqB,EAAE,eAAuB,EAAE,MAAe,EAAoB,EAAE,CACnH,WAAW;KACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;KAC7D,MAAM,CAAC,CAAC,GAAG,EAAyB,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;AAH7C,QAAA,eAAe,mBAG8B"}

package/src/helpers/utils.d.ts

@@ -0,0 +1,22 @@
+import type { Logger } from '@ama-mcp/core';
+/**
+ * Validates that a package name is safe and follows npm naming conventions.
+ * Prevents path traversal attacks and ensures the name is a valid npm package.
+ * @param packageName The package name to validate
+ * @returns true if the package name is valid and safe
+ */
+export declare const isValidPackageName: (packageName: string) => boolean;
+/**
+ * Load SDK packages list from package.json
+ * @param projectPath Path to project root
+ * @param logger Optional logger for debug output
+ * @returns Array of package names configured in sdkContext.packages
+ */
+export declare const loadSdkPackagesFromPackageJson: (projectPath: string, logger?: Logger) => string[];
+/**
+ * Generates a safe URI from a package name
+ * @param packageName The npm package name
+ * @returns A URI-safe identifier
+ */
+export declare const generateUri: (packageName: string) => string;
+//# sourceMappingURL=utils.d.ts.map

package/src/helpers/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/helpers/utils.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,MAAM,EACP,MAAM,eAAe,CAAC;AAQvB;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,aAAa,MAAM,KAAG,OAGR,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GAAI,aAAa,MAAM,EAAE,SAAS,MAAM,KAAG,MAAM,EAmB3F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,aAAa,MAAM,KAAG,MACsB,CAAC"}

package/src/helpers/utils.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUri = exports.loadSdkPackagesFromPackageJson = exports.isValidPackageName = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/** URI prefix for SDK context resources */
+const RESOURCE_URI_PREFIX = 'sdk-context';
+/** Pattern for valid npm package names (scoped and unscoped) - must be lowercase per npm spec */
+const VALID_PACKAGE_NAME_PATTERN = /^(@[a-z\d][\w.-]*\/)?[a-z\d][\w.-]*$/;
+/**
+ * Validates that a package name is safe and follows npm naming conventions.
+ * Prevents path traversal attacks and ensures the name is a valid npm package.
+ * @param packageName The package name to validate
+ * @returns true if the package name is valid and safe
+ */
+const isValidPackageName = (packageName) => Boolean(packageName)
+    && typeof packageName === 'string'
+    && VALID_PACKAGE_NAME_PATTERN.test(packageName);
+exports.isValidPackageName = isValidPackageName;
+/**
+ * Load SDK packages list from package.json
+ * @param projectPath Path to project root
+ * @param logger Optional logger for debug output
+ * @returns Array of package names configured in sdkContext.packages
+ */
+const loadSdkPackagesFromPackageJson = (projectPath, logger) => {
+    const packageJsonPath = (0, node_path_1.join)(projectPath, 'package.json');
+    if (!(0, node_fs_1.existsSync)(packageJsonPath)) {
+        logger?.debug?.(`No package.json found at ${packageJsonPath}`);
+        return [];
+    }
+    try {
+        const packageJson = JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, 'utf8'));
+        return (packageJson.sdkContext?.packages ?? []).filter((pkg) => {
+            const valid = (0, exports.isValidPackageName)(pkg);
+            if (!valid) {
+                logger?.warn?.(`Invalid package name in sdkContext.packages: "${pkg}", skipping`);
+            }
+            return valid;
+        });
+    }
+    catch (error) {
+        logger?.error?.(`Failed to parse package.json at ${packageJsonPath}:`, error);
+        return [];
+    }
+};
+exports.loadSdkPackagesFromPackageJson = loadSdkPackagesFromPackageJson;
+/**
+ * Generates a safe URI from a package name
+ * @param packageName The npm package name
+ * @returns A URI-safe identifier
+ */
+const generateUri = (packageName) => `${RESOURCE_URI_PREFIX}://${packageName.replace(/[^a-z0-9.]/gi, '-')}`;
+exports.generateUri = generateUri;
+//# sourceMappingURL=utils.js.map

package/src/helpers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/helpers/utils.ts"],"names":[],"mappings":";;;AAAA,qCAGiB;AACjB,yCAEmB;AAKnB,2CAA2C;AAC3C,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAE1C,iGAAiG;AACjG,MAAM,0BAA0B,GAAG,sCAAsC,CAAC;AAE1E;;;;;GAKG;AACI,MAAM,kBAAkB,GAAG,CAAC,WAAmB,EAAW,EAAE,CACjE,OAAO,CAAC,WAAW,CAAC;OACjB,OAAO,WAAW,KAAK,QAAQ;OAC/B,0BAA0B,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAHrC,QAAA,kBAAkB,sBAGmB;AAElD;;;;;GAKG;AACI,MAAM,8BAA8B,GAAG,CAAC,WAAmB,EAAE,MAAe,EAAY,EAAE;IAC/F,MAAM,eAAe,GAAG,IAAA,gBAAI,EAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAA,oBAAU,EAAC,eAAe,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,KAAK,EAAE,CAAC,4BAA4B,eAAe,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,eAAe,EAAE,MAAM,CAAC,CAA6C,CAAC;QAClH,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;YAC7D,MAAM,KAAK,GAAG,IAAA,0BAAkB,EAAC,GAAG,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,EAAE,IAAI,EAAE,CAAC,iDAAiD,GAAG,aAAa,CAAC,CAAC;YACpF,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,KAAK,EAAE,CAAC,mCAAmC,eAAe,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9E,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAnBW,QAAA,8BAA8B,kCAmBzC;AAEF;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,WAAmB,EAAU,EAAE,CACzD,GAAG,mBAAmB,MAAM,WAAW,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC;AAD5D,QAAA,WAAW,eACiD"}

package/src/server/mcp-server.d.ts

@@ -0,0 +1,42 @@
+import { AmaMcpServer, type ResourceToolOptions, type ToolDefinition } from '@ama-mcp/core';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Options for SDK context registration
+ */
+export interface SdkContextOptions extends Partial<ResourceToolOptions>, ToolDefinition {
+    /**
+     * Path to project root where package.json is located
+     * @default '.'
+     */
+    projectPath?: string;
+    /**
+     * Explicit list of SDK packages (overrides package.json sdkContext.packages)
+     */
+    sdkPackages?: string[];
+}
+/**
+ * Type of the response from the SDK context retriever tool
+ */
+export type SdkContextResponse = {
+    content: ({
+        type: 'text';
+        text: string;
+    } | {
+        type: 'resource_link';
+        name: string;
+        uri: string;
+    })[];
+};
+/**
+ * Register both SDK context resources and tool
+ * @param server MCP server instance
+ * @param options Configuration options
+ */
+export declare const registerSdkContextToolAndResources: (server: McpServer, options?: SdkContextOptions) => void;
+/**
+ * Create and configure an SDK Context MCP server
+ * @param options Configuration options for the server
+ * @returns Configured AmaMcpServer instance with SDK context tools and resources registered
+ */
+export declare const createSdkContextServer: (options?: SdkContextOptions) => AmaMcpServer;
+//# sourceMappingURL=mcp-server.d.ts.map

package/src/server/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,YAAY,EAIZ,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,SAAS,EACV,MAAM,yCAAyC,CAAC;AAyBjD;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,mBAAmB,CAAC,EAAE,cAAc;IACrF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACpC;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CAC7D,CAAC;AAuGF;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,GAC7C,QAAQ,SAAS,EACjB,UAAS,iBAAsB,KAC9B,IAeF,CAAC;AAwDF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,UAAS,iBAAsB,KAAG,YAkBxE,CAAC"}

package/src/server/mcp-server.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSdkContextServer = exports.registerSdkContextToolAndResources = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const core_1 = require("@ama-mcp/core");
+const telemetry_1 = require("@o3r/telemetry");
+const zod_1 = require("zod");
+const context_1 = require("../helpers/context");
+const utils_1 = require("../helpers/utils");
+/** Filename for SDK context documentation */
+const SDK_CONTEXT_FILENAME = 'SDK_CONTEXT.md';
+/** Filename for SDK usage instructions */
+const INSTRUCTIONS_FILENAME = 'INSTRUCTIONS.md';
+/** URI for the instructions resource */
+const INSTRUCTIONS_URI = 'sdk-context://instructions';
+/**
+ * Register a single SDK context as a resource
+ * @param server MCP server instance
+ * @param ctx SDK context info
+ */
+const registerSingleResource = (server, ctx) => {
+    core_1.resourceRegistry.set(ctx.uri, ctx.content);
+    server.registerResource(`SDK Context: ${ctx.packageName}`, ctx.uri, {
+        title: `SDK Context for ${ctx.packageName}`,
+        description: `API structure and domain information for ${ctx.packageName}.
+      Use this to avoid hallucinations when implementing features with this SDK.`,
+        mimeType: 'text/markdown'
+    }, () => ({ contents: [{ uri: ctx.uri, text: ctx.content }] }));
+};
+/**
+ * Factory that creates a retriever for SDK context information
+ * @param contexts Loaded SDK contexts
+ * @param logger Logger instance
+ * @returns Retriever that fetches SDK context by package name
+ */
+const sdkContextRetriever = (contexts, logger) => ({ packageName }) => {
+    if (!(0, utils_1.isValidPackageName)(packageName)) {
+        logger.warn?.(`Invalid package name requested: "${packageName}"`);
+        return {
+            content: [
+                { type: 'text', text: `Invalid package name: "${packageName}". Package names must follow npm naming conventions.` }
+            ]
+        };
+    }
+    const ctx = contexts.find((c) => c.packageName === packageName);
+    if (ctx) {
+        return {
+            content: [
+                { type: 'text', text: ctx.content },
+                { type: 'resource_link', name: `SDK Context: ${ctx.packageName}`, uri: ctx.uri }
+            ]
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `No SDK_CONTEXT.md found for package "${packageName}". Check that:\n
+          1. The package is listed in package.json sdkContext.packages or provided via CLI args\n
+          2. The package has SDK_CONTEXT.md generated`
+            }
+        ]
+    };
+};
+/**
+ * Register the SDK context tool on the server
+ * @param server MCP server instance
+ * @param contexts Loaded SDK contexts
+ * @param logger Logger instance
+ * @param toolOptions Tool definition options
+ */
+const registerTool = (server, contexts, logger, toolOptions) => {
+    const { toolName = 'get_sdk_context', toolTitle = 'Get SDK Context', toolDescription = `Retrieve SDK context information for configured SDK packages to understand their
+      API structure, available operations, and models. Use this before implementing features that rely on
+      an SDK to avoid hallucinations.` } = toolOptions;
+    logger.info?.(`Registering SDK context tool with ${contexts.length} contexts`);
+    server.registerTool(toolName, {
+        title: toolTitle,
+        description: toolDescription,
+        annotations: {
+            readOnlyHint: true,
+            openWorldHint: false
+        },
+        inputSchema: {
+            packageName: zod_1.z.string()
+                .describe('The npm package name of the SDK (e.g., "@my-scope/my-sdk-package")')
+        }
+    }, sdkContextRetriever(contexts, logger));
+};
+/**
+ * Register both SDK context resources and tool
+ * @param server MCP server instance
+ * @param options Configuration options
+ */
+const registerSdkContextToolAndResources = (server, options = {}) => {
+    const projectPath = options.projectPath ?? '.';
+    const logger = options.logger || new core_1.MCPLogger('@ama-mcp/sdk');
+    const sdkPackages = options.sdkPackages ?? (0, utils_1.loadSdkPackagesFromPackageJson)(projectPath, logger);
+    const contexts = (0, context_1.loadSdkContexts)(sdkPackages, SDK_CONTEXT_FILENAME, logger);
+    // Register resources
+    logger.info?.(`Registering ${contexts.length} SDK context resources`);
+    contexts.forEach((ctx) => registerSingleResource(server, ctx));
+    // Register tool
+    registerTool(server, contexts, logger, options);
+    // Register instructions
+    registerInstructionsResource(server, logger);
+};
+exports.registerSdkContextToolAndResources = registerSdkContextToolAndResources;
+/**
+ * Load the instructions content from the bundled INSTRUCTIONS.md file
+ * @param logger Optional logger for debug output
+ * @returns The instructions content or null if not found
+ */
+const loadInstructionsContent = (logger) => {
+    try {
+        // Resolve the path relative to this module's location (dist/src/index.js -> dist/resources/INSTRUCTIONS.md)
+        const instructionsPath = (0, node_path_1.resolve)(__dirname, '..', '..', 'resources', INSTRUCTIONS_FILENAME);
+        if (!(0, node_fs_1.existsSync)(instructionsPath)) {
+            logger?.debug?.(`Instructions file not found at ${instructionsPath}`);
+            return null;
+        }
+        return (0, node_fs_1.readFileSync)(instructionsPath, 'utf8');
+    }
+    catch (error) {
+        logger?.error?.('Failed to load instructions:', error);
+        return null;
+    }
+};
+/**
+ * Register the SDK context usage instructions as an MCP resource
+ * @param server MCP server instance
+ * @param logger Optional logger for debug output
+ */
+const registerInstructionsResource = (server, logger) => {
+    const content = loadInstructionsContent(logger);
+    if (!content) {
+        logger?.warn?.('Could not load SDK context instructions');
+        return;
+    }
+    core_1.resourceRegistry.set(INSTRUCTIONS_URI, content);
+    server.registerResource('SDK Context Instructions', INSTRUCTIONS_URI, {
+        title: 'SDK Context Usage Instructions',
+        description: `Guidelines for using SDK context to avoid hallucinations when implementing features with installed SDKs.
+        Read this before using the get_sdk_context tool.`,
+        mimeType: 'text/markdown'
+    }, () => ({ contents: [{ uri: INSTRUCTIONS_URI, text: content }] }));
+    logger?.info?.('Registered SDK context instructions resource');
+};
+/**
+ * Create and configure an SDK Context MCP server
+ * @param options Configuration options for the server
+ * @returns Configured AmaMcpServer instance with SDK context tools and resources registered
+ */
+const createSdkContextServer = (options = {}) => {
+    const name = '@ama-mcp/sdk';
+    const logger = options.logger ?? new core_1.MCPLogger(name, options.logLevel);
+    const server = new core_1.AmaMcpServer(logger, {
+        name,
+        version: '0.0.0'
+    });
+    void (0, telemetry_1.sendGenAIEventMetricsIfAuthorized)(name, 'registrationStart', { logger });
+    (0, exports.registerSdkContextToolAndResources)(server, { ...options, logger });
+    void (0, telemetry_1.sendGenAIEventMetricsIfAuthorized)(name, 'registrationEnd', { logger });
+    return server;
+};
+exports.createSdkContextServer = createSdkContextServer;
+//# sourceMappingURL=mcp-server.js.map

package/src/server/mcp-server.js.map

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