@gala-chain/launchpad-mcp-server 1.7.9 → 1.7.11

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## 1.7.11
+
+### Patch Changes
+
+- Add dynamic version tools and fix CommonJS uuid bundling conflict
+
+  **SDK Changes:**
+  - Added `getVersion()` method to LaunchpadSDK class that returns the SDK version dynamically read
+    from package.json
+  - Created `src/constants/version.ts` with SDK_VERSION constant that reads from package.json at
+    module load
+  - Version is read using require() with proper error handling for different environments
+  - **Fixed CommonJS build**: Updated `rollup.config.mjs` to bundle uuid only in CommonJS format
+    - Conditional externals: uuid excluded from CJS externals but included in ESM/UMD externals
+    - Resolves "ERR_REQUIRE_ESM" error when requiring uuid v13.0.0 (ESM-only package) in CommonJS
+      environments
+    - UMD/ESM bundles remain optimized with uuid external (~34KB)
+    - CJS bundle includes uuid (~44KB) for complete self-contained CommonJS compatibility
+
+  **MCP Server Changes:**
+  - Created version injection script (`scripts/inject-version.ts`) that runs as a prebuild step
+  - Added `build:version` npm script that injects MCP server version into `src/generated/version.ts`
+  - Updated `.gitignore` to exclude auto-generated version file
+  - Created `getVersionTool` MCP tool that returns both SDK and MCP server versions with timestamp
+
+  Both versions are now dynamically read from their respective package.json files, ensuring they
+  always stay in sync without manual version management in code. The CommonJS bundle now
+  self-contains uuid to resolve ESM-only module conflicts in Node.js require() scenarios.
+
+- Updated dependencies
+  - @gala-chain/launchpad-sdk@3.12.2
+
+## 1.7.10
+
+### Patch Changes
+
+- Comprehensive documentation for CommonJS support and module formats
+
+  **SDK Updates:**
+  - Document all three module formats (ESM, CommonJS, UMD)
+  - Add module resolution table showing automatic format selection
+  - Clarify when to use each format with concrete examples
+  - Explain package.json exports configuration
+
+  **MCP Server Updates:**
+  - Document CommonJS module format
+  - Explain integration with SDK's multi-format support
+  - Clarify automatic format selection by Node.js
+
+  **Project Configuration (CLAUDE.md):**
+  - Enhanced Build System section with detailed format breakdown
+  - Added comprehensive "Launchpad SDK Module Formats (v3.12.0+)" section
+  - Include size monitoring metrics for all three bundles
+
+- Updated dependencies
+  - @gala-chain/launchpad-sdk@3.12.1
+
 ## 1.7.9
 
 ### Patch Changes

package/README.md

@@ -18,6 +18,16 @@ MCP (Model Context Protocol) server for Gala Launchpad SDK - Enables AI agents t
 npm install -g @gala-chain/launchpad-mcp-server
 ```
 
+### Module Format
+
+The MCP server is built with **CommonJS** (`dist/index.js`) and works seamlessly with the SDK's dual-format support:
+
+- **MCP Server**: CommonJS (Node.js native)
+- **Underlying SDK**: Supports ESM, CommonJS, and UMD
+- **Compatibility**: Full support for both modern and legacy environments
+
+The MCP server automatically uses the correct SDK format for your Node.js version - no configuration needed!
+
 ## 🏁 Quick Start
 
 ### Claude Desktop Configuration

package/dist/generated/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AUTO-GENERATED VERSION FILE
+ * This file is generated by scripts/inject-version.ts during build
+ * DO NOT EDIT MANUALLY
+ */
+export declare const MCP_SERVER_VERSION = "1.7.11";
+//# sourceMappingURL=version.d.ts.map

package/dist/generated/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,WAAW,CAAC"}

package/dist/generated/version.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * AUTO-GENERATED VERSION FILE
+ * This file is generated by scripts/inject-version.ts during build
+ * DO NOT EDIT MANUALLY
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_SERVER_VERSION = void 0;
+exports.MCP_SERVER_VERSION = '1.7.11';
+//# sourceMappingURL=version.js.map

package/dist/generated/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,QAAQ,CAAC"}

package/dist/tools/utils/getVersion.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get Version Tool
+ *
+ * Returns version information for both the SDK and MCP server.
+ * Both versions are dynamically read from their respective package.json files.
+ */
+export declare const getVersionTool: import("../../types/mcp.js").MCPTool;
+//# sourceMappingURL=getVersion.d.ts.map

package/dist/tools/utils/getVersion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getVersion.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/getVersion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,cAAc,sCAczB,CAAC"}

package/dist/tools/utils/getVersion.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Get Version Tool
+ *
+ * Returns version information for both the SDK and MCP server.
+ * Both versions are dynamically read from their respective package.json files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersionTool = void 0;
+const tool_factory_js_1 = require("../../utils/tool-factory.js");
+const version_js_1 = require("../../generated/version.js");
+exports.getVersionTool = (0, tool_factory_js_1.createNoParamTool)({
+    name: 'gala_launchpad_get_version',
+    description: 'Get SDK and MCP server version information. Returns both versions which are dynamically read from package.json files.',
+    handler: async (sdk) => {
+        const sdkVersion = sdk.getVersion();
+        const mcpVersion = version_js_1.MCP_SERVER_VERSION;
+        const timestamp = new Date().toISOString();
+        return {
+            sdk: sdkVersion,
+            mcpServer: mcpVersion,
+            timestamp,
+        };
+    },
+});
+//# sourceMappingURL=getVersion.js.map

package/dist/tools/utils/getVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getVersion.js","sourceRoot":"","sources":["../../../src/tools/utils/getVersion.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iEAAgE;AAChE,2DAAgE;AAEnD,QAAA,cAAc,GAAG,IAAA,mCAAiB,EAAC;IAC9C,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,uHAAuH;IACpI,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,+BAAkB,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,OAAO;YACL,GAAG,EAAE,UAAU;YACf,SAAS,EAAE,UAAU;YACrB,SAAS;SACV,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,eAAO,MAAM,YAAY,wCAUxB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,eAAO,MAAM,YAAY,wCAWxB,CAAC"}

package/dist/tools/utils/index.js

@@ -13,6 +13,7 @@ const explainSdkUsage_js_1 = require("./explainSdkUsage.js");
 const isTokenGraduated_js_1 = require("./isTokenGraduated.js");
 const getCacheInfo_js_1 = require("./getCacheInfo.js");
 const clearCache_js_1 = require("./clearCache.js");
+const getVersion_js_1 = require("./getVersion.js");
 exports.utilityTools = [
     createWallet_js_1.createWalletTool,
     getAddress_js_1.getAddressTool,
@@ -23,5 +24,6 @@ exports.utilityTools = [
     isTokenGraduated_js_1.isTokenGraduatedTool,
     getCacheInfo_js_1.getCacheInfoTool,
     clearCache_js_1.clearCacheTool,
+    getVersion_js_1.getVersionTool,
 ];
 //# sourceMappingURL=index.js.map

package/dist/tools/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AACrD,mDAAiD;AACjD,mEAAiE;AACjE,iDAA+C;AAC/C,iEAA+D;AAC/D,6DAA2D;AAC3D,+DAA6D;AAC7D,uDAAqD;AACrD,mDAAiD;AAEpC,QAAA,YAAY,GAAG;IAC1B,kCAAgB;IAChB,8BAAc;IACd,8CAAsB;IACtB,4BAAa;IACb,4CAAqB;IACrB,wCAAmB;IACnB,0CAAoB;IACpB,kCAAgB;IAChB,8BAAc;CACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAAqD;AACrD,mDAAiD;AACjD,mEAAiE;AACjE,iDAA+C;AAC/C,iEAA+D;AAC/D,6DAA2D;AAC3D,+DAA6D;AAC7D,uDAAqD;AACrD,mDAAiD;AACjD,mDAAiD;AAEpC,QAAA,YAAY,GAAG;IAC1B,kCAAgB;IAChB,8BAAc;IACd,8CAAsB;IACtB,4BAAa;IACb,4CAAqB;IACrB,wCAAmB;IACnB,0CAAoB;IACpB,kCAAgB;IAChB,8BAAc;IACd,8BAAc;CACf,CAAC"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "1.7.9",
+  "version": "1.7.11",
   "description": "MCP server for Gala Launchpad SDK with 50 tools + 14 slash commands - Production-grade AI agent integration with comprehensive validation, optimized performance, and 80%+ test coverage",
   "main": "dist/index.js",
   "bin": {
     "gala-launchpad-mcp": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc && chmod +x dist/index.js",
+    "build": "npm run build:version && tsc && chmod +x dist/index.js",
+    "build:version": "tsx scripts/inject-version.ts",
     "dev": "tsx src/index.ts",
     "watch": "tsc --watch",
     "test": "jest --passWithNoTests",
@@ -62,7 +63,7 @@
   "dependencies": {
     "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
-    "@gala-chain/launchpad-sdk": "^3.11.8",
+    "@gala-chain/launchpad-sdk": "^3.12.2",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",
     "bignumber.js": "^9.1.2",

package/scripts/inject-version.ts

@@ -0,0 +1,31 @@
+/**
+ * Version Injection Script
+ *
+ * Reads the MCP server version from package.json and generates a version constant file.
+ * This runs as a prebuild step to ensure version is always in sync.
+ */
+
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+
+// Get package version from package.json
+const packageJsonPath = join(dirname(__filename), '../package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+const mcpVersion = packageJson.version;
+
+// Create the generated constants file
+const generatedDir = join(dirname(__filename), '../src/generated');
+mkdirSync(generatedDir, { recursive: true });
+
+const versionFile = join(generatedDir, 'version.ts');
+const versionContent = `/**
+ * AUTO-GENERATED VERSION FILE
+ * This file is generated by scripts/inject-version.ts during build
+ * DO NOT EDIT MANUALLY
+ */
+
+export const MCP_SERVER_VERSION = '${mcpVersion}';
+`;
+
+writeFileSync(versionFile, versionContent, 'utf-8');
+console.log(`✓ Injected MCP version ${mcpVersion} to ${versionFile}`);