imean-service-engine 1.2.3 → 1.4.0

package/dist/mod.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
 var zod = require('zod');
+var ejson4 = require('ejson');
+var lruCache = require('lru-cache');
 var nodeServer = require('@hono/node-server');
-var ejson3 = require('ejson');
 var etcd3 = require('etcd3');
 var fs = require('fs-extra');
 var hono = require('hono');
-var lruCache = require('lru-cache');
 var api = require('@opentelemetry/api');
 var winston = require('winston');
 var prettier = require('prettier');
@@ -17,7 +17,7 @@ var dayjs = require('dayjs');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var ejson3__default = /*#__PURE__*/_interopDefault(ejson3);
+var ejson4__default = /*#__PURE__*/_interopDefault(ejson4);
 var fs__default = /*#__PURE__*/_interopDefault(fs);
 var winston__default = /*#__PURE__*/_interopDefault(winston);
 var prettier__default = /*#__PURE__*/_interopDefault(prettier);
@@ -25,6 +25,38 @@ var crypto2__default = /*#__PURE__*/_interopDefault(crypto2);
 var dayjs__default = /*#__PURE__*/_interopDefault(dayjs);
 
 // mod.ts
+var CacheAdapter = class {
+};
+var RedisCacheAdapter = class extends CacheAdapter {
+  constructor(redis) {
+    super();
+    this.redis = redis;
+  }
+  async get(key) {
+    const value = await this.redis.get(key);
+    return value ? ejson4__default.default.parse(value) : null;
+  }
+  async set(key, value, ttl) {
+    return this.redis.set(key, ejson4__default.default.stringify(value), "EX", ttl / 1e3);
+  }
+};
+var MemoryCacheAdapter = class extends CacheAdapter {
+  cache;
+  constructor(options) {
+    super();
+    this.cache = new lruCache.LRUCache({
+      max: 1e3,
+      ttl: 1e3 * 60 * 10,
+      ...options
+    });
+  }
+  async get(key) {
+    return this.cache.get(key);
+  }
+  async set(key, value, ttl) {
+    this.cache.set(key, value, { ttl });
+  }
+};
 var ACTION_METADATA = Symbol("action:metadata");
 function Action(options) {
   options.params = options.params || [];
@@ -53,7 +85,8 @@ function Action(options) {
         printError: options.printError ?? false,
         cache: options.cache,
         ttl: options.ttl,
-        stream: options.stream
+        stream: options.stream,
+        mcp: options.mcp
       };
       prototype[ACTION_METADATA] = existingMetadata;
     });
@@ -89,6 +122,8 @@ var ScheduleMode = /* @__PURE__ */ ((ScheduleMode2) => {
   ScheduleMode2["FIXED_DELAY"] = "FIXED_DELAY";
   return ScheduleMode2;
 })(ScheduleMode || {});
+var Plugin = class {
+};
 var logger = winston__default.default.createLogger({
   level: "info",
   transports: [
@@ -297,9 +332,6 @@ function getZodTypeString(schema, defaultOptional = false) {
         }).join("; ");
         return `{ ${props} }`;
       }
-      case "ZodEnum": {
-        return def.values.map((opt) => `"${opt}"`).join(" | ");
-      }
       case "ZodUnion": {
         return def.options.map((opt) => processType(opt)).join(" | ");
       }
@@ -328,8 +360,8 @@ function getZodTypeString(schema, defaultOptional = false) {
       case "ZodUnknown": {
         return "unknown";
       }
-      case "ZodEnum ": {
-        return def.values.map((opt) => `"${opt}"`).join(" | ");
+      case "ZodEnum": {
+        return "(" + def.values.map((opt) => `"${opt}"`).join(" | ") + ")";
       }
       case "ZodDefault": {
         return processType(def.innerType);
@@ -455,7 +487,7 @@ var ActionHandler = class {
       let args;
       if (typeof req === "string") {
         try {
-          args = Object.values(ejson3__default.default.parse(req));
+          args = Object.values(ejson4__default.default.parse(req));
         } catch (error) {
           throw new Error(`Invalid request body: ${error.message}`);
         }
@@ -473,7 +505,7 @@ var ActionHandler = class {
           }
         });
       }
-      const requestHash = hashText(ejson3__default.default.stringify(args));
+      const requestHash = hashText(ejson4__default.default.stringify(args));
       span.setAttribute("requestHash", requestHash);
       return { args, requestHash };
     } finally {
@@ -484,7 +516,7 @@ var ActionHandler = class {
     const span = api.trace.getActiveSpan();
     const { args, requestHash } = await this._validate(req);
     const cacheHash = typeof this.metadata.cache === "function" ? this.metadata.cache(...args) : requestHash;
-    const cacheKey = `${this.moduleName}.${this.actionName}.${hashText(ejson3__default.default.stringify(cacheHash))}`;
+    const cacheKey = `${this.microservice.options.name}:cache:${this.moduleName}:${this.actionName}:${hashText(ejson4__default.default.stringify(cacheHash))}`;
     span?.setAttribute("args", JSON.stringify(args));
     if (!this.metadata.stream && this.metadata.cache && !this.microservice.options.disableCache) {
       const cached = await this.microservice.cache.get(cacheKey);
@@ -539,7 +571,7 @@ var ActionHandler = class {
             data: parsedResult,
             expireAt: this.metadata.ttl ? now + this.metadata.ttl : void 0
           },
-          { ttl: this.metadata.ttl }
+          this.metadata.ttl ?? 1e3
         );
       }
       return parsedResult;
@@ -568,7 +600,7 @@ var WebSocketHandler = class {
     this.sockets.add(ws);
   }
   async encodeMessage(message) {
-    const jsonStr = ejson3__default.default.stringify(message);
+    const jsonStr = ejson4__default.default.stringify(message);
     const data = new TextEncoder().encode(jsonStr);
     const compressed = await brotli.compress(data, 6);
     return compressed;
@@ -577,7 +609,7 @@ var WebSocketHandler = class {
     try {
       const decompressed = await brotli.decompress(new Uint8Array(data));
       const jsonStr = new TextDecoder().decode(decompressed);
-      return ejson3__default.default.parse(jsonStr);
+      return ejson4__default.default.parse(jsonStr);
     } catch (error) {
       console.error("Error decoding message", error);
       throw error;
@@ -638,7 +670,7 @@ var WebSocketHandler = class {
           false
         );
         ws.send(
-          ejson3__default.default.stringify({
+          ejson4__default.default.stringify({
             id: message.id,
             success: false,
             error: "Request timeout"
@@ -754,17 +786,24 @@ var Microservice = class {
     this.options = {
       prefix: "/api",
       name: "microservice",
+      version: "0.0.1",
+      env: "default",
+      printError: false,
+      disableCache: false,
+      generateClient: false,
+      etcd: false,
+      events: {},
+      websocket: { enabled: false },
+      cacheAdapter: new MemoryCacheAdapter(),
+      plugins: [],
       ...options
     };
+    this.cache = this.options.cacheAdapter;
     this.fetch = this.app.request;
     this.waitingInitialization = this.initialize();
     ServiceContext.service = this;
   }
   async initialize() {
-    this.cache = new lruCache.LRUCache({
-      max: 1e3,
-      ttl: 1e3 * 60 * 10
-    });
     if (this.options.etcd) {
       this.initEtcd(this.options.etcd);
     }
@@ -775,6 +814,7 @@ var Microservice = class {
       this.initStatsEventManager();
     }
     await this.registerService(true);
+    await this.initPlugins();
   }
   async initModules() {
     for (const ModuleClass of this.options.modules) {
@@ -799,7 +839,7 @@ var Microservice = class {
         );
         this.actionHandlers.set(`${moduleName}.${actionName}`, handler);
         logger_default.info(
-          `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description}`
+          `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description} ${actionMetadata.mcp ? "MCP:" + actionMetadata.mcp?.type : ""}`
         );
       }
       const schedules = getScheduleMetadata(ModuleClass.prototype);
@@ -1128,12 +1168,12 @@ Received SIGINT signal`);
             try {
               for await (const value of result) {
                 const response = { value, done: false };
-                const chunk = encoder.encode(ejson3__default.default.stringify(response) + "\n");
+                const chunk = encoder.encode(ejson4__default.default.stringify(response) + "\n");
                 controller.enqueue(chunk);
               }
               controller.enqueue(
                 encoder.encode(
-                  ejson3__default.default.stringify({ done: true }) + "\n"
+                  ejson4__default.default.stringify({ done: true }) + "\n"
                 )
               );
               controller.close();
@@ -1143,7 +1183,7 @@ Received SIGINT signal`);
                 done: true
               };
               controller.enqueue(
-                encoder.encode(ejson3__default.default.stringify(response) + "\n")
+                encoder.encode(ejson4__default.default.stringify(response) + "\n")
               );
               controller.close();
             }
@@ -1157,37 +1197,21 @@ Received SIGINT signal`);
           }
         });
       }
-      return ctx.text(ejson3__default.default.stringify({ success: true, data: result }));
+      return ctx.text(ejson4__default.default.stringify({ success: true, data: result }));
     } catch (error) {
       return ctx.json({ success: false, error: error.message });
     }
   };
-  async init() {
-    await this.waitingInitialization;
-  }
-  /**
-   * 获取所有注册的服务
-   */
-  async getServices() {
-    if (!this.etcdClient) {
-      throw new Error("etcd is not configured");
+  async initPlugins() {
+    for (const plugin of this.options.plugins) {
+      logger_default.info(`[ \u521D\u59CB\u5316\u63D2\u4EF6 ] ${plugin.constructor.name}`);
+      await plugin.initialize(this).catch((e) => {
+        logger_default.error(`[ \u521D\u59CB\u5316\u63D2\u4EF6\u5931\u8D25 ] ${plugin.constructor.name}: ${e}`);
+      });
     }
-    const namespace = this.options.etcd?.namespace ? `${this.options.etcd.namespace}/` : "";
-    const servicesKey = `${namespace}services`;
-    const services = await this.etcdClient.getAll().prefix(servicesKey);
-    return Object.values(services).map((value) => JSON.parse(value));
   }
-  /**
-   * 获取指定服务的实例
-   */
-  async getServiceInstances(serviceName) {
-    if (!this.etcdClient) {
-      throw new Error("etcd is not configured");
-    }
-    const namespace = this.options.etcd?.namespace ? `${this.options.etcd.namespace}/` : "";
-    const serviceKey = `${namespace}services/${serviceName}`;
-    const instances = await this.etcdClient.getAll().prefix(serviceKey);
-    return Object.values(instances).map((value) => JSON.parse(value));
+  async init() {
+    await this.waitingInitialization;
   }
 };
 
@@ -1218,8 +1242,12 @@ Object.defineProperty(exports, "dayjs", {
   get: function () { return dayjs__default.default; }
 });
 exports.Action = Action;
+exports.CacheAdapter = CacheAdapter;
+exports.MemoryCacheAdapter = MemoryCacheAdapter;
 exports.Microservice = Microservice;
 exports.Module = Module;
+exports.Plugin = Plugin;
+exports.RedisCacheAdapter = RedisCacheAdapter;
 exports.Schedule = Schedule;
 exports.ScheduleMode = ScheduleMode;
 exports.ServiceContext = ServiceContext;

package/dist/mod.d.cts

@@ -1,12 +1,33 @@
 import { z } from 'zod';
 export * from 'zod';
+import { Redis, Cluster } from 'ioredis';
+import { LRUCache } from 'lru-cache';
 import { Lease, Etcd3 } from 'etcd3';
 import { Hono } from 'hono';
-import { LRUCache } from 'lru-cache';
 export { default as dayjs } from 'dayjs';
 import winston from 'winston';
 
+declare abstract class CacheAdapter {
+    abstract get(key: string): Promise<any>;
+    abstract set(key: string, value: any, ttl: number): Promise<any>;
+}
+declare class RedisCacheAdapter extends CacheAdapter {
+    private readonly redis;
+    constructor(redis: Redis | Cluster);
+    get(key: string): Promise<any>;
+    set(key: string, value: string, ttl: number): Promise<"OK">;
+}
+declare class MemoryCacheAdapter extends CacheAdapter {
+    private cache;
+    constructor(options?: LRUCache.Options<string, any, any>);
+    get(key: string): Promise<any>;
+    set(key: string, value: any, ttl: number): Promise<void>;
+}
+
 type CacheFn = (...args: any[]) => any;
+type McpOptions = {
+    type: "tool";
+};
 interface ActionOptions {
     params?: z.ZodType<any>[];
     returns?: z.ZodType<any>;
@@ -16,6 +37,7 @@ interface ActionOptions {
     cache?: boolean | CacheFn;
     ttl?: number;
     stream?: boolean;
+    mcp?: McpOptions;
 }
 interface ActionMetadata extends ActionOptions {
     name: string;
@@ -121,7 +143,7 @@ interface MicroserviceOptions {
     disableCache?: boolean;
     modules: (new () => any)[];
     generateClient?: URL | boolean;
-    etcd?: EtcdConfig;
+    etcd?: EtcdConfig | false;
     events?: StatisticsEventOptions & {
         onStats?: (event: StatisticsEvent) => void | Promise<void>;
         onRegister?: (serviceInfo: ServiceInfo) => void | Promise<void>;
@@ -131,6 +153,8 @@ interface MicroserviceOptions {
         enabled?: boolean;
         timeout?: number;
     };
+    cacheAdapter?: CacheAdapter;
+    plugins?: Plugin[];
 }
 interface ModuleInfo extends ModuleOptions {
     actions: Record<string, ActionMetadata>;
@@ -141,6 +165,9 @@ interface StreamResponse<T = any> {
     done: boolean;
     error?: string;
 }
+declare abstract class Plugin {
+    abstract initialize(engine: Microservice): Promise<void>;
+}
 
 declare class ActionHandler {
     private moduleInstance;
@@ -176,8 +203,8 @@ declare class Microservice {
     private actionHandlers;
     modules: Map<string, ModuleInfo>;
     readonly fetch: typeof fetch;
-    options: MicroserviceOptions;
-    cache: LRUCache<string, any>;
+    options: Required<MicroserviceOptions>;
+    cache: CacheAdapter;
     serviceId: string;
     constructor(options: MicroserviceOptions);
     private initialize;
@@ -205,7 +232,7 @@ declare class Microservice {
     /**
      * 获取所有模块的元数据
      */
-    private getModules;
+    getModules(withTypes?: boolean): Record<string, ModuleInfo>;
     /**
      * 停止服务
      */
@@ -222,15 +249,8 @@ declare class Microservice {
     private updateStats;
     getActionHandler(moduleName: string, actionName: string): ActionHandler;
     private handleRequest;
+    private initPlugins;
     init(): Promise<void>;
-    /**
-     * 获取所有注册的服务
-     */
-    getServices(): Promise<ServiceInfo[]>;
-    /**
-     * 获取指定服务的实例
-     */
-    getServiceInstances(serviceName: string): Promise<ServiceInfo[]>;
 }
 
 interface PreStartChecker {
@@ -259,4 +279,4 @@ declare function Schedule(options: ScheduleOptions): Function;
 
 declare const logger: winston.Logger;
 
-export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, type CacheFn, type EtcdConfig, type EventServiceInfo, Microservice, type MicroserviceOptions, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, type PreStartChecker, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };
+export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, CacheAdapter, type CacheFn, type EtcdConfig, type EventServiceInfo, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Plugin, type PreStartChecker, RedisCacheAdapter, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };

package/dist/mod.d.ts

@@ -1,12 +1,33 @@
 import { z } from 'zod';
 export * from 'zod';
+import { Redis, Cluster } from 'ioredis';
+import { LRUCache } from 'lru-cache';
 import { Lease, Etcd3 } from 'etcd3';
 import { Hono } from 'hono';
-import { LRUCache } from 'lru-cache';
 export { default as dayjs } from 'dayjs';
 import winston from 'winston';
 
+declare abstract class CacheAdapter {
+    abstract get(key: string): Promise<any>;
+    abstract set(key: string, value: any, ttl: number): Promise<any>;
+}
+declare class RedisCacheAdapter extends CacheAdapter {
+    private readonly redis;
+    constructor(redis: Redis | Cluster);
+    get(key: string): Promise<any>;
+    set(key: string, value: string, ttl: number): Promise<"OK">;
+}
+declare class MemoryCacheAdapter extends CacheAdapter {
+    private cache;
+    constructor(options?: LRUCache.Options<string, any, any>);
+    get(key: string): Promise<any>;
+    set(key: string, value: any, ttl: number): Promise<void>;
+}
+
 type CacheFn = (...args: any[]) => any;
+type McpOptions = {
+    type: "tool";
+};
 interface ActionOptions {
     params?: z.ZodType<any>[];
     returns?: z.ZodType<any>;
@@ -16,6 +37,7 @@ interface ActionOptions {
     cache?: boolean | CacheFn;
     ttl?: number;
     stream?: boolean;
+    mcp?: McpOptions;
 }
 interface ActionMetadata extends ActionOptions {
     name: string;
@@ -121,7 +143,7 @@ interface MicroserviceOptions {
     disableCache?: boolean;
     modules: (new () => any)[];
     generateClient?: URL | boolean;
-    etcd?: EtcdConfig;
+    etcd?: EtcdConfig | false;
     events?: StatisticsEventOptions & {
         onStats?: (event: StatisticsEvent) => void | Promise<void>;
         onRegister?: (serviceInfo: ServiceInfo) => void | Promise<void>;
@@ -131,6 +153,8 @@ interface MicroserviceOptions {
         enabled?: boolean;
         timeout?: number;
     };
+    cacheAdapter?: CacheAdapter;
+    plugins?: Plugin[];
 }
 interface ModuleInfo extends ModuleOptions {
     actions: Record<string, ActionMetadata>;
@@ -141,6 +165,9 @@ interface StreamResponse<T = any> {
     done: boolean;
     error?: string;
 }
+declare abstract class Plugin {
+    abstract initialize(engine: Microservice): Promise<void>;
+}
 
 declare class ActionHandler {
     private moduleInstance;
@@ -176,8 +203,8 @@ declare class Microservice {
     private actionHandlers;
     modules: Map<string, ModuleInfo>;
     readonly fetch: typeof fetch;
-    options: MicroserviceOptions;
-    cache: LRUCache<string, any>;
+    options: Required<MicroserviceOptions>;
+    cache: CacheAdapter;
     serviceId: string;
     constructor(options: MicroserviceOptions);
     private initialize;
@@ -205,7 +232,7 @@ declare class Microservice {
     /**
      * 获取所有模块的元数据
      */
-    private getModules;
+    getModules(withTypes?: boolean): Record<string, ModuleInfo>;
     /**
      * 停止服务
      */
@@ -222,15 +249,8 @@ declare class Microservice {
     private updateStats;
     getActionHandler(moduleName: string, actionName: string): ActionHandler;
     private handleRequest;
+    private initPlugins;
     init(): Promise<void>;
-    /**
-     * 获取所有注册的服务
-     */
-    getServices(): Promise<ServiceInfo[]>;
-    /**
-     * 获取指定服务的实例
-     */
-    getServiceInstances(serviceName: string): Promise<ServiceInfo[]>;
 }
 
 interface PreStartChecker {
@@ -259,4 +279,4 @@ declare function Schedule(options: ScheduleOptions): Function;
 
 declare const logger: winston.Logger;
 
-export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, type CacheFn, type EtcdConfig, type EventServiceInfo, Microservice, type MicroserviceOptions, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, type PreStartChecker, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };
+export { Action, type ActionErrorEvent, type ActionMetadata, type ActionOptions, CacheAdapter, type CacheFn, type EtcdConfig, type EventServiceInfo, type McpOptions, MemoryCacheAdapter, Microservice, type MicroserviceOptions, Module, type ModuleInfo, type ModuleMetadata, type ModuleOptions, Plugin, type PreStartChecker, RedisCacheAdapter, Schedule, type ScheduleMetadata, ScheduleMode, type ScheduleOptions, ServiceContext, type ServiceInfo, type ServiceStats, type StatisticsEvent, type StreamResponse, logger, startCheck };

package/dist/mod.js

@@ -1,11 +1,11 @@
 import { z } from 'zod';
 export * from 'zod';
+import ejson4 from 'ejson';
+import { LRUCache } from 'lru-cache';
 import { serve } from '@hono/node-server';
-import ejson3 from 'ejson';
 import { Etcd3 } from 'etcd3';
 import fs from 'fs-extra';
 import { Hono } from 'hono';
-import { LRUCache } from 'lru-cache';
 import { trace, SpanStatusCode } from '@opentelemetry/api';
 import winston, { format } from 'winston';
 import prettier from 'prettier';
@@ -16,6 +16,38 @@ import { createNodeWebSocket } from '@hono/node-ws';
 export { default as dayjs } from 'dayjs';
 
 // mod.ts
+var CacheAdapter = class {
+};
+var RedisCacheAdapter = class extends CacheAdapter {
+  constructor(redis) {
+    super();
+    this.redis = redis;
+  }
+  async get(key) {
+    const value = await this.redis.get(key);
+    return value ? ejson4.parse(value) : null;
+  }
+  async set(key, value, ttl) {
+    return this.redis.set(key, ejson4.stringify(value), "EX", ttl / 1e3);
+  }
+};
+var MemoryCacheAdapter = class extends CacheAdapter {
+  cache;
+  constructor(options) {
+    super();
+    this.cache = new LRUCache({
+      max: 1e3,
+      ttl: 1e3 * 60 * 10,
+      ...options
+    });
+  }
+  async get(key) {
+    return this.cache.get(key);
+  }
+  async set(key, value, ttl) {
+    this.cache.set(key, value, { ttl });
+  }
+};
 var ACTION_METADATA = Symbol("action:metadata");
 function Action(options) {
   options.params = options.params || [];
@@ -44,7 +76,8 @@ function Action(options) {
         printError: options.printError ?? false,
         cache: options.cache,
         ttl: options.ttl,
-        stream: options.stream
+        stream: options.stream,
+        mcp: options.mcp
       };
       prototype[ACTION_METADATA] = existingMetadata;
     });
@@ -80,6 +113,8 @@ var ScheduleMode = /* @__PURE__ */ ((ScheduleMode2) => {
   ScheduleMode2["FIXED_DELAY"] = "FIXED_DELAY";
   return ScheduleMode2;
 })(ScheduleMode || {});
+var Plugin = class {
+};
 var logger = winston.createLogger({
   level: "info",
   transports: [
@@ -288,9 +323,6 @@ function getZodTypeString(schema, defaultOptional = false) {
         }).join("; ");
         return `{ ${props} }`;
       }
-      case "ZodEnum": {
-        return def.values.map((opt) => `"${opt}"`).join(" | ");
-      }
       case "ZodUnion": {
         return def.options.map((opt) => processType(opt)).join(" | ");
       }
@@ -319,8 +351,8 @@ function getZodTypeString(schema, defaultOptional = false) {
       case "ZodUnknown": {
         return "unknown";
       }
-      case "ZodEnum ": {
-        return def.values.map((opt) => `"${opt}"`).join(" | ");
+      case "ZodEnum": {
+        return "(" + def.values.map((opt) => `"${opt}"`).join(" | ") + ")";
       }
       case "ZodDefault": {
         return processType(def.innerType);
@@ -446,7 +478,7 @@ var ActionHandler = class {
       let args;
       if (typeof req === "string") {
         try {
-          args = Object.values(ejson3.parse(req));
+          args = Object.values(ejson4.parse(req));
         } catch (error) {
           throw new Error(`Invalid request body: ${error.message}`);
         }
@@ -464,7 +496,7 @@ var ActionHandler = class {
           }
         });
       }
-      const requestHash = hashText(ejson3.stringify(args));
+      const requestHash = hashText(ejson4.stringify(args));
       span.setAttribute("requestHash", requestHash);
       return { args, requestHash };
     } finally {
@@ -475,7 +507,7 @@ var ActionHandler = class {
     const span = trace.getActiveSpan();
     const { args, requestHash } = await this._validate(req);
     const cacheHash = typeof this.metadata.cache === "function" ? this.metadata.cache(...args) : requestHash;
-    const cacheKey = `${this.moduleName}.${this.actionName}.${hashText(ejson3.stringify(cacheHash))}`;
+    const cacheKey = `${this.microservice.options.name}:cache:${this.moduleName}:${this.actionName}:${hashText(ejson4.stringify(cacheHash))}`;
     span?.setAttribute("args", JSON.stringify(args));
     if (!this.metadata.stream && this.metadata.cache && !this.microservice.options.disableCache) {
       const cached = await this.microservice.cache.get(cacheKey);
@@ -530,7 +562,7 @@ var ActionHandler = class {
             data: parsedResult,
             expireAt: this.metadata.ttl ? now + this.metadata.ttl : void 0
           },
-          { ttl: this.metadata.ttl }
+          this.metadata.ttl ?? 1e3
         );
       }
       return parsedResult;
@@ -559,7 +591,7 @@ var WebSocketHandler = class {
     this.sockets.add(ws);
   }
   async encodeMessage(message) {
-    const jsonStr = ejson3.stringify(message);
+    const jsonStr = ejson4.stringify(message);
     const data = new TextEncoder().encode(jsonStr);
     const compressed = await brotli.compress(data, 6);
     return compressed;
@@ -568,7 +600,7 @@ var WebSocketHandler = class {
     try {
       const decompressed = await brotli.decompress(new Uint8Array(data));
       const jsonStr = new TextDecoder().decode(decompressed);
-      return ejson3.parse(jsonStr);
+      return ejson4.parse(jsonStr);
     } catch (error) {
       console.error("Error decoding message", error);
       throw error;
@@ -629,7 +661,7 @@ var WebSocketHandler = class {
           false
         );
         ws.send(
-          ejson3.stringify({
+          ejson4.stringify({
             id: message.id,
             success: false,
             error: "Request timeout"
@@ -745,17 +777,24 @@ var Microservice = class {
     this.options = {
       prefix: "/api",
       name: "microservice",
+      version: "0.0.1",
+      env: "default",
+      printError: false,
+      disableCache: false,
+      generateClient: false,
+      etcd: false,
+      events: {},
+      websocket: { enabled: false },
+      cacheAdapter: new MemoryCacheAdapter(),
+      plugins: [],
       ...options
     };
+    this.cache = this.options.cacheAdapter;
     this.fetch = this.app.request;
     this.waitingInitialization = this.initialize();
     ServiceContext.service = this;
   }
   async initialize() {
-    this.cache = new LRUCache({
-      max: 1e3,
-      ttl: 1e3 * 60 * 10
-    });
     if (this.options.etcd) {
       this.initEtcd(this.options.etcd);
     }
@@ -766,6 +805,7 @@ var Microservice = class {
       this.initStatsEventManager();
     }
     await this.registerService(true);
+    await this.initPlugins();
   }
   async initModules() {
     for (const ModuleClass of this.options.modules) {
@@ -790,7 +830,7 @@ var Microservice = class {
         );
         this.actionHandlers.set(`${moduleName}.${actionName}`, handler);
         logger_default.info(
-          `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description}`
+          `[ \u6CE8\u518C\u52A8\u4F5C ] ${moduleName}.${actionName} ${actionMetadata.description} ${actionMetadata.mcp ? "MCP:" + actionMetadata.mcp?.type : ""}`
         );
       }
       const schedules = getScheduleMetadata(ModuleClass.prototype);
@@ -1119,12 +1159,12 @@ Received SIGINT signal`);
             try {
               for await (const value of result) {
                 const response = { value, done: false };
-                const chunk = encoder.encode(ejson3.stringify(response) + "\n");
+                const chunk = encoder.encode(ejson4.stringify(response) + "\n");
                 controller.enqueue(chunk);
               }
               controller.enqueue(
                 encoder.encode(
-                  ejson3.stringify({ done: true }) + "\n"
+                  ejson4.stringify({ done: true }) + "\n"
                 )
               );
               controller.close();
@@ -1134,7 +1174,7 @@ Received SIGINT signal`);
                 done: true
               };
               controller.enqueue(
-                encoder.encode(ejson3.stringify(response) + "\n")
+                encoder.encode(ejson4.stringify(response) + "\n")
               );
               controller.close();
             }
@@ -1148,37 +1188,21 @@ Received SIGINT signal`);
           }
         });
       }
-      return ctx.text(ejson3.stringify({ success: true, data: result }));
+      return ctx.text(ejson4.stringify({ success: true, data: result }));
     } catch (error) {
       return ctx.json({ success: false, error: error.message });
     }
   };
-  async init() {
-    await this.waitingInitialization;
-  }
-  /**
-   * 获取所有注册的服务
-   */
-  async getServices() {
-    if (!this.etcdClient) {
-      throw new Error("etcd is not configured");
+  async initPlugins() {
+    for (const plugin of this.options.plugins) {
+      logger_default.info(`[ \u521D\u59CB\u5316\u63D2\u4EF6 ] ${plugin.constructor.name}`);
+      await plugin.initialize(this).catch((e) => {
+        logger_default.error(`[ \u521D\u59CB\u5316\u63D2\u4EF6\u5931\u8D25 ] ${plugin.constructor.name}: ${e}`);
+      });
     }
-    const namespace = this.options.etcd?.namespace ? `${this.options.etcd.namespace}/` : "";
-    const servicesKey = `${namespace}services`;
-    const services = await this.etcdClient.getAll().prefix(servicesKey);
-    return Object.values(services).map((value) => JSON.parse(value));
   }
-  /**
-   * 获取指定服务的实例
-   */
-  async getServiceInstances(serviceName) {
-    if (!this.etcdClient) {
-      throw new Error("etcd is not configured");
-    }
-    const namespace = this.options.etcd?.namespace ? `${this.options.etcd.namespace}/` : "";
-    const serviceKey = `${namespace}services/${serviceName}`;
-    const instances = await this.etcdClient.getAll().prefix(serviceKey);
-    return Object.values(instances).map((value) => JSON.parse(value));
+  async init() {
+    await this.waitingInitialization;
   }
 };
 
@@ -1204,4 +1228,4 @@ async function startCheck(checkers, pass) {
   if (pass) await pass();
 }
 
-export { Action, Microservice, Module, Schedule, ScheduleMode, ServiceContext, logger_default as logger, startCheck };
+export { Action, CacheAdapter, MemoryCacheAdapter, Microservice, Module, Plugin, RedisCacheAdapter, Schedule, ScheduleMode, ServiceContext, logger_default as logger, startCheck };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imean-service-engine",
-  "version": "1.2.3",
+  "version": "1.4.0",
   "description": "microservice engine",
   "keywords": [
     "microservice",
@@ -39,6 +39,7 @@
   "dependencies": {
     "@hono/node-server": "^1.13.7",
     "@hono/node-ws": "^1.0.6",
+    "@modelcontextprotocol/sdk": "^1.8.0",
     "dayjs": "^1.11.13",
     "ejson": "^2.2.3",
     "etcd3": "^1.1.2",
@@ -46,11 +47,13 @@
     "hono": "^4.6.17",
     "lru-cache": "^11.0.2",
     "prettier": "^3.4.2",
+    "ulid": "^3.0.0",
     "winston": "^3.17.0",
     "zod": "^3.24.1"
   },
   "peerDependencies": {
-    "@opentelemetry/api": "^1.x"
+    "@opentelemetry/api": "^1.x",
+    "ioredis": "^5.6.0"
   },
   "devDependencies": {
     "@opentelemetry/auto-instrumentations-node": "^0.55.3",
@@ -65,9 +68,11 @@
     "@opentelemetry/winston-transport": "^0.10.0",
     "@types/ejson": "^2.2.2",
     "@types/fs-extra": "^11.0.4",
+    "@types/ioredis-mock": "^8.2.5",
     "@types/node": "^20.0.0",
     "@vitest/coverage-v8": "^3.0.4",
     "imean-service-client": "^1.5.0",
+    "ioredis-mock": "^8.9.0",
     "opentelemetry-instrumentation-fetch-node": "^1.2.3",
     "tslib": "^2.8.1",
     "tsup": "^8.0.1",