@egain/egain-mcp-server 1.0.1 → 1.0.3

package/esm/src/hooks/registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../src/hooks/registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAYnC,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,QA8BrC"}
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../src/hooks/registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAanC,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,QAoCrC"}

package/esm/src/hooks/registration.js

@@ -2,6 +2,7 @@ import { AuthenticationHook } from "./auth-hook.js";
 import { PortalCacheHook } from "./portal-cache-hook.js";
 import { PortalLookupHook } from "./portal-lookup-hook.js";
 import { ServerRoutingHook } from "./server-routing-hook.js";
+import { VersionCheckHook } from "./version-check-hook.js";
 /*
  * This file is only ever generated once on the first generation and then is free to be modified.
  * Any hooks you wish to add should be registered in the initHooks function. Feel free to define them
@@ -9,6 +10,11 @@ import { ServerRoutingHook } from "./server-routing-hook.js";
  */
 export function initHooks(hooks) {
     console.error('🚀 Initializing eGain MCP hooks...');
+    // 0. Version Check Hook - checks for updates from npm
+    // Register this FIRST so users see update notifications early
+    const versionCheckHook = new VersionCheckHook();
+    hooks.registerSDKInitHook(versionCheckHook);
+    console.error('✅ VERSION: Registered version check hook for SDK init');
     // 1. Server Routing Hook - routes operations to correct API server
     // Register this FIRST before request creation so URLs are correct from the start
     const serverRoutingHook = new ServerRoutingHook();

package/esm/src/hooks/registration.js.map

@@ -1 +1 @@
-{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../src/hooks/registration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D;;;;GAIG;AAEH,MAAM,UAAU,SAAS,CAAC,KAAY;IACpC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAEpD,mEAAmE;IACnE,iFAAiF;IACjF,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAClD,KAAK,CAAC,+BAA+B,CAAC,iBAAiB,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAErF,sEAAsE;IACtE,iDAAiD;IACjD,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,KAAK,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAC,8BAA8B;IAC1E,KAAK,CAAC,+BAA+B,CAAC,eAAe,CAAC,CAAC,CAAC,mCAAmC;IAC3F,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAE9F,oEAAoE;IACpE,qFAAqF;IACrF,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACzD,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC,CAAC,uCAAuC;IAClF,OAAO,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAExF,qEAAqE;IACrE,gEAAgE;IAChE,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAC/D,KAAK,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC,CAAC,mCAAmC;IACtF,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAE5E,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../src/hooks/registration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;GAIG;AAEH,MAAM,UAAU,SAAS,CAAC,KAAY;IACpC,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAEpD,sDAAsD;IACtD,8DAA8D;IAC9D,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAChD,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAEvE,mEAAmE;IACnE,iFAAiF;IACjF,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAClD,KAAK,CAAC,+BAA+B,CAAC,iBAAiB,CAAC,CAAC;IACzD,OAAO,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;IAErF,sEAAsE;IACtE,iDAAiD;IACjD,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,KAAK,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAC,8BAA8B;IAC1E,KAAK,CAAC,+BAA+B,CAAC,eAAe,CAAC,CAAC,CAAC,mCAAmC;IAC3F,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAE9F,oEAAoE;IACpE,qFAAqF;IACrF,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACzD,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC,CAAC,uCAAuC;IAClF,OAAO,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAExF,qEAAqE;IACrE,gEAAgE;IAChE,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,eAAe,CAAC,CAAC;IAC/D,KAAK,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC,CAAC,mCAAmC;IACtF,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAE5E,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACnE,CAAC"}

package/esm/src/hooks/version-check-hook.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Version Check Hook for eGain MCP Server
+ * Checks for updates by comparing local version with latest version on npm
+ */
+import { SDKInitHook } from "./types.js";
+import { SDKOptions } from "../lib/config.js";
+export declare class VersionCheckHook implements SDKInitHook {
+    private checkPerformed;
+    sdkInit(opts: SDKOptions): SDKOptions;
+}
+//# sourceMappingURL=version-check-hook.d.ts.map

package/esm/src/hooks/version-check-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check-hook.d.ts","sourceRoot":"","sources":["../../../src/hooks/version-check-hook.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAmG9C,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU;CA0DtC"}

package/esm/src/hooks/version-check-hook.js

@@ -0,0 +1,147 @@
+/**
+ * Version Check Hook for eGain MCP Server
+ * Checks for updates by comparing local version with latest version on npm
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from 'url';
+// ES module __dirname equivalent
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Get the project root directory by finding package.json
+const getProjectRoot = () => {
+    // Start from current directory and walk up until we find package.json
+    let currentDir = __dirname;
+    while (currentDir !== path.dirname(currentDir)) { // Stop at filesystem root
+        if (fs.existsSync(path.join(currentDir, 'package.json'))) {
+            return currentDir;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    // If package.json not found, use current working directory as fallback
+    return process.cwd();
+};
+/**
+ * Compare two semantic version strings
+ * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+function compareVersions(v1, v2) {
+    const parts1 = v1.split('.').map(Number);
+    const parts2 = v2.split('.').map(Number);
+    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+        const part1 = parts1[i] || 0;
+        const part2 = parts2[i] || 0;
+        if (part1 > part2)
+            return 1;
+        if (part1 < part2)
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Check if we're running from a git repository
+ */
+function isGitRepo(projectRoot) {
+    try {
+        const gitDir = path.join(projectRoot, '.git');
+        return fs.existsSync(gitDir) || fs.existsSync(path.join(projectRoot, '.git', 'HEAD'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get local version from package.json
+ */
+function getLocalVersion() {
+    try {
+        const projectRoot = getProjectRoot();
+        const packageJsonPath = path.join(projectRoot, 'package.json');
+        if (fs.existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+            return packageJson.version || null;
+        }
+    }
+    catch (error) {
+        console.error('⚠️  Could not read local version:', error);
+    }
+    return null;
+}
+/**
+ * Fetch latest version from npm registry
+ */
+async function getLatestVersion() {
+    try {
+        const packageName = '@egain/egain-mcp-server';
+        const registryUrl = `https://registry.npmjs.org/${packageName}`;
+        const response = await fetch(registryUrl, {
+            headers: {
+                'Accept': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`npm registry returned ${response.status}`);
+        }
+        const data = await response.json();
+        return data['dist-tags']?.latest || null;
+    }
+    catch (error) {
+        // Silently fail - network issues shouldn't block initialization
+        return null;
+    }
+}
+export class VersionCheckHook {
+    checkPerformed = false;
+    sdkInit(opts) {
+        // Only check once per SDK initialization
+        if (this.checkPerformed) {
+            return opts;
+        }
+        this.checkPerformed = true;
+        // Perform version check asynchronously (non-blocking)
+        setImmediate(async () => {
+            try {
+                const localVersion = getLocalVersion();
+                if (!localVersion) {
+                    console.error('⚠️  Could not determine local version');
+                    return;
+                }
+                console.error(`📦 Checking for updates (current version: ${localVersion})...`);
+                const latestVersion = await getLatestVersion();
+                if (!latestVersion) {
+                    // Silently fail - network issues shouldn't be noisy
+                    return;
+                }
+                if (compareVersions(latestVersion, localVersion) > 0) {
+                    const projectRoot = getProjectRoot();
+                    const isGit = isGitRepo(projectRoot);
+                    console.error('');
+                    console.error('⚠️  UPDATE AVAILABLE');
+                    console.error(`   Current version: ${localVersion}`);
+                    console.error(`   Latest version:  ${latestVersion}`);
+                    if (isGit) {
+                        console.error(`   Update with: git pull && npm run build`);
+                        console.error(`   Or visit: https://github.com/eGain/egain-mcp-server`);
+                    }
+                    else {
+                        console.error(`   Update with: npm install -g @egain/egain-mcp-server@latest`);
+                        console.error(`   Or visit: https://www.npmjs.com/package/@egain/egain-mcp-server`);
+                    }
+                    console.error('');
+                }
+                else {
+                    console.error(`✅ You are running the latest version (${localVersion})`);
+                }
+            }
+            catch (error) {
+                // Silently fail - version check shouldn't break initialization
+                // Only log if it's a non-network error
+                if (error instanceof Error && !error.message.includes('fetch')) {
+                    console.error('⚠️  Version check failed:', error.message);
+                }
+            }
+        });
+        return opts;
+    }
+}
+//# sourceMappingURL=version-check-hook.js.map

package/esm/src/hooks/version-check-hook.js.map

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

package/esm/src/lib/config.d.ts

@@ -50,8 +50,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "1.0.1";
+    readonly sdkVersion: "1.0.3";
     readonly genVersion: "2.723.8";
-    readonly userAgent: "speakeasy-sdk/mcp-typescript 1.0.1 2.723.8 1.0.0 @egain/egain-mcp-server";
+    readonly userAgent: "speakeasy-sdk/mcp-typescript 1.0.3 2.723.8 1.0.0 @egain/egain-mcp-server";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/src/lib/config.js

@@ -39,8 +39,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "1.0.1",
+    sdkVersion: "1.0.3",
     genVersion: "2.723.8",
-    userAgent: "speakeasy-sdk/mcp-typescript 1.0.1 2.723.8 1.0.0 @egain/egain-mcp-server",
+    userAgent: "speakeasy-sdk/mcp-typescript 1.0.3 2.723.8 1.0.0 @egain/egain-mcp-server",
 };
 //# sourceMappingURL=config.js.map

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

@@ -16,7 +16,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
     name: "mcp",
     versionInfo: {
-        currentVersion: "1.0.1",
+        currentVersion: "1.0.3",
     },
 });
 run(app, process.argv.slice(2), buildContext(process));

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

@@ -17,7 +17,7 @@ import { tool$querySearch } from "./tools/querySearch.js";
 export function createMCPServer(deps) {
     const server = new McpServer({
         name: "EgainMcp",
-        version: "1.0.1",
+        version: "1.0.3",
     });
     const getClient = deps.getSDK || (() => new EgainMcpCore({
         security: deps.security,

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.1",
   "name": "@egain/egain-mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "",
   "long_description": "eGain Portal, Retrieve, Search, Answers APIs: Enterprise knowledge APIs for managing portals, searching content, retrieving AI-powered answers, and accessing content chunks for custom integrations.",
   "author": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@egain/egain-mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "author": "Emily Loh - eGain Corporation",
   "type": "module",
   "sideEffects": false,

package/src/hooks/registration.ts

@@ -3,6 +3,7 @@ import { AuthenticationHook } from "./auth-hook.js";
 import { PortalCacheHook } from "./portal-cache-hook.js";
 import { PortalLookupHook } from "./portal-lookup-hook.js";
 import { ServerRoutingHook } from "./server-routing-hook.js";
+import { VersionCheckHook } from "./version-check-hook.js";
 
 /*
  * This file is only ever generated once on the first generation and then is free to be modified.
@@ -13,6 +14,12 @@ import { ServerRoutingHook } from "./server-routing-hook.js";
 export function initHooks(hooks: Hooks) {
   console.error('🚀 Initializing eGain MCP hooks...');
   
+  // 0. Version Check Hook - checks for updates from npm
+  // Register this FIRST so users see update notifications early
+  const versionCheckHook = new VersionCheckHook();
+  hooks.registerSDKInitHook(versionCheckHook);
+  console.error('✅ VERSION: Registered version check hook for SDK init');
+  
   // 1. Server Routing Hook - routes operations to correct API server
   // Register this FIRST before request creation so URLs are correct from the start
   const serverRoutingHook = new ServerRoutingHook();

package/src/hooks/version-check-hook.ts

@@ -0,0 +1,168 @@
+/**
+ * Version Check Hook for eGain MCP Server
+ * Checks for updates by comparing local version with latest version on npm
+ */
+
+import { SDKInitHook } from "./types.js";
+import { SDKOptions } from "../lib/config.js";
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from 'url';
+
+// ES module __dirname equivalent
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Get the project root directory by finding package.json
+const getProjectRoot = (): string => {
+  // Start from current directory and walk up until we find package.json
+  let currentDir = __dirname;
+  while (currentDir !== path.dirname(currentDir)) { // Stop at filesystem root
+    if (fs.existsSync(path.join(currentDir, 'package.json'))) {
+      return currentDir;
+    }
+    currentDir = path.dirname(currentDir);
+  }
+  // If package.json not found, use current working directory as fallback
+  return process.cwd();
+};
+
+/**
+ * Compare two semantic version strings
+ * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+function compareVersions(v1: string, v2: string): number {
+  const parts1 = v1.split('.').map(Number);
+  const parts2 = v2.split('.').map(Number);
+  
+  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+    const part1 = parts1[i] || 0;
+    const part2 = parts2[i] || 0;
+    
+    if (part1 > part2) return 1;
+    if (part1 < part2) return -1;
+  }
+  
+  return 0;
+}
+
+/**
+ * Check if we're running from a git repository
+ */
+function isGitRepo(projectRoot: string): boolean {
+  try {
+    const gitDir = path.join(projectRoot, '.git');
+    return fs.existsSync(gitDir) || fs.existsSync(path.join(projectRoot, '.git', 'HEAD'));
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get local version from package.json
+ */
+function getLocalVersion(): string | null {
+  try {
+    const projectRoot = getProjectRoot();
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    
+    if (fs.existsSync(packageJsonPath)) {
+      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+      return packageJson.version || null;
+    }
+  } catch (error) {
+    console.error('⚠️  Could not read local version:', error);
+  }
+  
+  return null;
+}
+
+/**
+ * Fetch latest version from npm registry
+ */
+async function getLatestVersion(): Promise<string | null> {
+  try {
+    const packageName = '@egain/egain-mcp-server';
+    const registryUrl = `https://registry.npmjs.org/${packageName}`;
+    
+    const response = await fetch(registryUrl, {
+      headers: {
+        'Accept': 'application/json',
+      },
+    });
+    
+    if (!response.ok) {
+      throw new Error(`npm registry returned ${response.status}`);
+    }
+    
+    const data = await response.json() as { 'dist-tags'?: { latest?: string } };
+    return data['dist-tags']?.latest || null;
+  } catch (error) {
+    // Silently fail - network issues shouldn't block initialization
+    return null;
+  }
+}
+
+export class VersionCheckHook implements SDKInitHook {
+  private checkPerformed = false;
+
+  sdkInit(opts: SDKOptions): SDKOptions {
+    // Only check once per SDK initialization
+    if (this.checkPerformed) {
+      return opts;
+    }
+    
+    this.checkPerformed = true;
+    
+    // Perform version check asynchronously (non-blocking)
+    setImmediate(async () => {
+      try {
+        const localVersion = getLocalVersion();
+        
+        if (!localVersion) {
+          console.error('⚠️  Could not determine local version');
+          return;
+        }
+        
+        console.error(`📦 Checking for updates (current version: ${localVersion})...`);
+        
+        const latestVersion = await getLatestVersion();
+        
+        if (!latestVersion) {
+          // Silently fail - network issues shouldn't be noisy
+          return;
+        }
+        
+        if (compareVersions(latestVersion, localVersion) > 0) {
+          const projectRoot = getProjectRoot();
+          const isGit = isGitRepo(projectRoot);
+          
+          console.error('');
+          console.error('⚠️  UPDATE AVAILABLE');
+          console.error(`   Current version: ${localVersion}`);
+          console.error(`   Latest version:  ${latestVersion}`);
+          
+          if (isGit) {
+            console.error(`   Update with: git pull && npm run build`);
+            console.error(`   Or visit: https://github.com/eGain/egain-mcp-server`);
+          } else {
+            console.error(`   Update with: npm install -g @egain/egain-mcp-server@latest`);
+            console.error(`   Or visit: https://www.npmjs.com/package/@egain/egain-mcp-server`);
+          }
+          console.error('');
+        } else {
+          console.error(`✅ You are running the latest version (${localVersion})`);
+        }
+      } catch (error) {
+        // Silently fail - version check shouldn't break initialization
+        // Only log if it's a non-network error
+        if (error instanceof Error && !error.message.includes('fetch')) {
+          console.error('⚠️  Version check failed:', error.message);
+        }
+      }
+    });
+    
+    return opts;
+  }
+}
+

package/src/lib/config.ts

@@ -82,8 +82,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "1.0.1",
+  sdkVersion: "1.0.3",
   genVersion: "2.723.8",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 1.0.1 2.723.8 1.0.0 @egain/egain-mcp-server",
+    "speakeasy-sdk/mcp-typescript 1.0.3 2.723.8 1.0.0 @egain/egain-mcp-server",
 } as const;

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "1.0.1",
+    currentVersion: "1.0.3",
   },
 });
 

package/src/mcp-server/server.ts

@@ -34,7 +34,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "EgainMcp",
-    version: "1.0.1",
+    version: "1.0.3",
   });
 
   const getClient = deps.getSDK || (() =>