@frontmcp/plugins 0.4.1 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugins",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "FrontMCP plugins to extend the SDK",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -15,7 +15,8 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/agentfront/frontmcp.git"
+    "url": "git+https://github.com/agentfront/frontmcp.git",
+    "directory": "libs/plugins"
   },
   "bugs": {
     "url": "https://github.com/agentfront/frontmcp/issues"
@@ -32,7 +33,11 @@
   },
   "dependencies": {
     "ioredis": "^5.8.0",
-    "@frontmcp/sdk": "0.4.1"
+    "@frontmcp/sdk": "0.5.0",
+    "ast-guard": "^1.1.0",
+    "enclave-vm": "^1.0.1",
+    "vectoriadb": "^1.0.0",
+    "piscina": "^4.7.0"
   },
   "type": "commonjs"
 }

package/src/cache/cache.plugin.js

@@ -6,7 +6,33 @@ const sdk_1 = require("@frontmcp/sdk");
 const cache_redis_provider_1 = tslib_1.__importDefault(require("./providers/cache-redis.provider"));
 const cache_memory_provider_1 = tslib_1.__importDefault(require("./providers/cache-memory.provider"));
 const cache_symbol_1 = require("./cache.symbol");
-let CachePlugin = CachePlugin_1 = class CachePlugin extends sdk_1.DynamicPlugin {
+let CachePlugin = class CachePlugin extends sdk_1.DynamicPlugin {
+    static { CachePlugin_1 = this; }
+    static dynamicProviders = (options) => {
+        const providers = [];
+        switch (options.type) {
+            case 'redis':
+            case 'redis-client':
+                providers.push({
+                    name: 'cache:redis',
+                    provide: cache_symbol_1.CacheStoreToken,
+                    useValue: new cache_redis_provider_1.default(options),
+                });
+                break;
+            case 'memory':
+                providers.push({
+                    name: 'cache:memory',
+                    provide: cache_symbol_1.CacheStoreToken,
+                    useValue: new cache_memory_provider_1.default(options.defaultTTL),
+                });
+                break;
+        }
+        return providers;
+    };
+    static defaultOptions = {
+        type: 'memory',
+    };
+    options;
     constructor(options = CachePlugin_1.defaultOptions) {
         super();
         this.options = {
@@ -62,30 +88,6 @@ let CachePlugin = CachePlugin_1 = class CachePlugin extends sdk_1.DynamicPlugin
         await cacheStore.setValue(hash, toolContext.output, ttl);
     }
 };
-CachePlugin.dynamicProviders = (options) => {
-    const providers = [];
-    switch (options.type) {
-        case 'redis':
-        case 'redis-client':
-            providers.push({
-                name: 'cache:redis',
-                provide: cache_symbol_1.CacheStoreToken,
-                useValue: new cache_redis_provider_1.default(options),
-            });
-            break;
-        case 'memory':
-            providers.push({
-                name: 'cache:memory',
-                provide: cache_symbol_1.CacheStoreToken,
-                useValue: new cache_memory_provider_1.default(options.defaultTTL),
-            });
-            break;
-    }
-    return providers;
-};
-CachePlugin.defaultOptions = {
-    type: 'memory',
-};
 tslib_1.__decorate([
     sdk_1.ToolHook.Will('execute', { priority: 1000 }),
     tslib_1.__metadata("design:type", Function),

package/src/cache/cache.plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.plugin.js","sourceRoot":"","sources":["../../../src/cache/cache.plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import { DynamicPlugin, FlowCtxOf, Plugin, ProviderType, ToolHook } from '@frontmcp/sdk';\nimport CacheRedisProvider from './providers/cache-redis.provider';\nimport CacheMemoryProvider from './providers/cache-memory.provider';\nimport { CachePluginOptions } from './cache.types';\nimport { CacheStoreToken } from './cache.symbol';\n\n@Plugin({\n  name: 'cache',\n  description: 'Cache plugin for caching tool results',\n  providers: [\n    /* add providers that always loaded with the plugin or default providers */\n    {\n      // this is a default provider for cache, will be overridden if dynamicProviders based on config\n      name: 'cache:memory',\n      provide: CacheStoreToken,\n      useValue: new CacheMemoryProvider(60 * 60 * 24),\n    },\n  ],\n})\nexport default class CachePlugin extends DynamicPlugin<CachePluginOptions> {\n  static override dynamicProviders = (options: CachePluginOptions) => {\n    const providers: ProviderType[] = [];\n    switch (options.type) {\n      case 'redis':\n      case 'redis-client':\n        providers.push({\n          name: 'cache:redis',\n          provide: CacheStoreToken,\n          useValue: new CacheRedisProvider(options),\n        });\n        break;\n      case 'memory':\n        providers.push({\n          name: 'cache:memory',\n          provide: CacheStoreToken,\n          useValue: new CacheMemoryProvider(options.defaultTTL),\n        });\n        break;\n    }\n    return providers;\n  };\n\n  static defaultOptions: CachePluginOptions = {\n    type: 'memory',\n  };\n  options: CachePluginOptions;\n\n  constructor(options: CachePluginOptions = CachePlugin.defaultOptions) {\n    super();\n    this.options = {\n      defaultTTL: 60 * 60 * 24,\n      ...options,\n    };\n  }\n\n  @ToolHook.Will('execute', { priority: 1000 })\n  async willReadCache(flowCtx: FlowCtxOf<'tools:call-tool'>) {\n    const { tool, toolContext } = flowCtx.state;\n    if (!tool || !toolContext) return;\n\n    const { cache } = toolContext.metadata;\n    if (!cache || typeof toolContext.input === 'undefined') {\n      // no cache or no input, skip\n      return;\n    }\n    const cacheStore = this.get(CacheStoreToken);\n    const hash = hashObject({ tool: tool.fullName, input: toolContext.input });\n    const cached = await cacheStore.getValue(hash);\n\n    if (cached !== undefined && cached !== null) {\n      if (cache === true || (cache.ttl && cache.slideWindow)) {\n        const ttl = cache === true ? this.options.defaultTTL : cache.ttl ?? this.options.defaultTTL;\n        await cacheStore.setValue(hash, cached, ttl);\n      }\n\n      /**\n       * double check if cache still valid based on tool output schema\n       */\n      if (!tool.safeParseOutput(cached).success) {\n        await cacheStore.delete(hash);\n        return;\n      }\n      /**\n       * cache hit, set output to the main flow context\n       */\n      flowCtx.state.rawOutput = cached;\n\n      /**\n       * call respond to bypass tool execution\n       */\n      toolContext.respond(cached);\n    }\n  }\n\n  @ToolHook.Did('execute', { priority: 1000 })\n  async willWriteCache(flowCtx: FlowCtxOf<'tools:call-tool'>) {\n    const { tool, toolContext } = flowCtx.state;\n    if (!tool || !toolContext) return;\n    const { cache } = toolContext.metadata;\n    if (!cache || typeof toolContext.input === 'undefined') {\n      return;\n    }\n    const cacheStore = this.get(CacheStoreToken);\n    const ttl = cache === true ? this.options.defaultTTL : cache.ttl ?? this.options.defaultTTL;\n\n    const hash = hashObject({ tool: tool.fullName, input: toolContext.input });\n    await cacheStore.setValue(hash, toolContext.output, ttl);\n  }\n}\n\nfunction hashObject(obj: any) {\n  const keys = Object.keys(obj).sort();\n  return keys.reduce((acc, key) => {\n    acc += key + ':';\n    const val = obj[key];\n    if (typeof val === 'object' && val !== null) {\n      acc += hashObject(val);\n    } else {\n      acc += val;\n    }\n    acc += ';';\n    return acc;\n  }, '');\n}\n"]}
+{"version":3,"file":"cache.plugin.js","sourceRoot":"","sources":["../../../src/cache/cache.plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import { DynamicPlugin, FlowCtxOf, Plugin, ProviderType, ToolHook } from '@frontmcp/sdk';\nimport CacheRedisProvider from './providers/cache-redis.provider';\nimport CacheMemoryProvider from './providers/cache-memory.provider';\nimport { CachePluginOptions } from './cache.types';\nimport { CacheStoreToken } from './cache.symbol';\n\n@Plugin({\n  name: 'cache',\n  description: 'Cache plugin for caching tool results',\n  providers: [\n    /* add providers that always loaded with the plugin or default providers */\n    {\n      // this is a default provider for cache, will be overridden if dynamicProviders based on config\n      name: 'cache:memory',\n      provide: CacheStoreToken,\n      useValue: new CacheMemoryProvider(60 * 60 * 24),\n    },\n  ],\n})\nexport default class CachePlugin extends DynamicPlugin<CachePluginOptions> {\n  static override dynamicProviders = (options: CachePluginOptions) => {\n    const providers: ProviderType[] = [];\n    switch (options.type) {\n      case 'redis':\n      case 'redis-client':\n        providers.push({\n          name: 'cache:redis',\n          provide: CacheStoreToken,\n          useValue: new CacheRedisProvider(options),\n        });\n        break;\n      case 'memory':\n        providers.push({\n          name: 'cache:memory',\n          provide: CacheStoreToken,\n          useValue: new CacheMemoryProvider(options.defaultTTL),\n        });\n        break;\n    }\n    return providers;\n  };\n\n  static defaultOptions: CachePluginOptions = {\n    type: 'memory',\n  };\n  options: CachePluginOptions;\n\n  constructor(options: CachePluginOptions = CachePlugin.defaultOptions) {\n    super();\n    this.options = {\n      defaultTTL: 60 * 60 * 24,\n      ...options,\n    };\n  }\n\n  @ToolHook.Will('execute', { priority: 1000 })\n  async willReadCache(flowCtx: FlowCtxOf<'tools:call-tool'>) {\n    const { tool, toolContext } = flowCtx.state;\n    if (!tool || !toolContext) return;\n\n    const { cache } = toolContext.metadata;\n    if (!cache || typeof toolContext.input === 'undefined') {\n      // no cache or no input, skip\n      return;\n    }\n    const cacheStore = this.get(CacheStoreToken);\n    const hash = hashObject({ tool: tool.fullName, input: toolContext.input });\n    const cached = await cacheStore.getValue(hash);\n\n    if (cached !== undefined && cached !== null) {\n      if (cache === true || (cache.ttl && cache.slideWindow)) {\n        const ttl = cache === true ? this.options.defaultTTL : cache.ttl ?? this.options.defaultTTL;\n        await cacheStore.setValue(hash, cached, ttl);\n      }\n\n      /**\n       * double check if cache still valid based on tool output schema\n       */\n      if (!tool.safeParseOutput(cached).success) {\n        await cacheStore.delete(hash);\n        return;\n      }\n      /**\n       * cache hit, set output to the main flow context\n       */\n      flowCtx.state.rawOutput = cached;\n\n      /**\n       * call respond to bypass tool execution\n       */\n      toolContext.respond(cached);\n    }\n  }\n\n  @ToolHook.Did('execute', { priority: 1000 })\n  async willWriteCache(flowCtx: FlowCtxOf<'tools:call-tool'>) {\n    const { tool, toolContext } = flowCtx.state;\n    if (!tool || !toolContext) return;\n    const { cache } = toolContext.metadata;\n    if (!cache || typeof toolContext.input === 'undefined') {\n      return;\n    }\n    const cacheStore = this.get(CacheStoreToken);\n    const ttl = cache === true ? this.options.defaultTTL : cache.ttl ?? this.options.defaultTTL;\n\n    const hash = hashObject({ tool: tool.fullName, input: toolContext.input });\n    await cacheStore.setValue(hash, toolContext.output, ttl);\n  }\n}\n\nfunction hashObject(obj: any) {\n  const keys = Object.keys(obj).sort();\n  return keys.reduce((acc, key) => {\n    acc += key + ':';\n    const val = obj[key];\n    if (typeof val === 'object' && val !== null) {\n      acc += hashObject(val);\n    } else {\n      acc += val;\n    }\n    acc += ';';\n    return acc;\n  }, '');\n}\n"]}

package/src/cache/providers/cache-memory.provider.js

@@ -4,8 +4,9 @@ const tslib_1 = require("tslib");
 const sdk_1 = require("@frontmcp/sdk");
 const MAX_TIMEOUT_MS = 2 ** 31 - 1; // ~24.8 days (Node setTimeout limit)
 let CacheMemoryProvider = class CacheMemoryProvider {
+    memory = new Map();
+    sweeper;
     constructor(sweepIntervalTTL = 60) {
-        this.memory = new Map();
         this.sweeper = setInterval(() => this.sweep(), sweepIntervalTTL * 1000);
         // don’t keep the process alive just for the sweeper (Node >=14)
         this.sweeper.unref?.();

package/src/cache/providers/cache-memory.provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-memory.provider.js","sourceRoot":"","sources":["../../../../src/cache/providers/cache-memory.provider.ts"],"names":[],"mappings":"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","sourcesContent":["import { Provider, ProviderScope } from '@frontmcp/sdk';\nimport { CacheStoreInterface } from '../cache.types';\n\ntype Entry = {\n  value: string;\n  /** epoch millis when this entry expires (undefined = no TTL) */\n  expiresAt?: number;\n  /** per-key timeout when TTL is short enough to schedule */\n  timeout?: NodeJS.Timeout;\n};\n\nconst MAX_TIMEOUT_MS = 2 ** 31 - 1; // ~24.8 days (Node setTimeout limit)\n\n@Provider({\n  name: 'provider:cache:memory',\n  description: 'Memory-based cache provider',\n  scope: ProviderScope.GLOBAL,\n})\nexport default class CacheMemoryProvider  implements CacheStoreInterface{\n  private readonly memory = new Map<string, Entry>();\n  private sweeper?: NodeJS.Timeout;\n\n  constructor(sweepIntervalTTL = 60) {\n    this.sweeper = setInterval(() => this.sweep(), sweepIntervalTTL * 1000);\n    // don’t keep the process alive just for the sweeper (Node >=14)\n    (this.sweeper as any).unref?.();\n  }\n\n  /** Set any value (auto-stringifies objects) */\n  async setValue(key: string, value: any, ttlSeconds?: number): Promise<void> {\n    const strValue = typeof value === 'string' ? value : JSON.stringify(value);\n\n    // clear any previous timeout on this key\n    const existing = this.memory.get(key);\n    if (existing?.timeout) clearTimeout(existing.timeout);\n\n    const entry: Entry = { value: strValue };\n\n    if (ttlSeconds && ttlSeconds > 0) {\n      const ttlMs = ttlSeconds * 1000;\n      entry.expiresAt = Date.now() + ttlMs;\n\n      // Only schedule a timer if within Node's setTimeout limit; otherwise rely on sweeper/lazy purge\n      if (ttlMs <= MAX_TIMEOUT_MS) {\n        entry.timeout = setTimeout(() => {\n          // final check guards against clock drift or updates\n          const e = this.memory.get(key);\n          if (e && e.expiresAt && e.expiresAt <= Date.now()) {\n            this.memory.delete(key);\n          }\n        }, ttlMs);\n        (entry.timeout as any).unref?.();\n      }\n    }\n\n    this.memory.set(key, entry);\n  }\n\n  /** Get a value and automatically parse JSON if possible */\n  async getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined> {\n    const entry = this.memory.get(key);\n    if (!entry) return defaultValue;\n\n    if (this.isExpired(entry)) {\n      await this.delete(key);\n      return defaultValue;\n    }\n\n    const raw = entry.value;\n    try {\n      return JSON.parse(raw) as T;\n    } catch {\n      // fallback for plain string values\n      return raw as unknown as T;\n    }\n  }\n\n  /** Delete a key */\n  async delete(key: string): Promise<void> {\n    const entry = this.memory.get(key);\n    if (entry?.timeout) clearTimeout(entry.timeout);\n    this.memory.delete(key);\n  }\n\n  /** Check if a key exists (and not expired) */\n  async exists(key: string): Promise<boolean> {\n    const entry = this.memory.get(key);\n    if (!entry) return false;\n    if (this.isExpired(entry)) {\n      await this.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  /** Gracefully close the provider */\n  async close(): Promise<void> {\n    if (this.sweeper) clearInterval(this.sweeper);\n    for (const [, entry] of this.memory) {\n      if (entry.timeout) clearTimeout(entry.timeout);\n    }\n    this.memory.clear();\n  }\n\n  // ---- internals ----\n\n  private isExpired(entry: Entry): boolean {\n    return entry.expiresAt !== undefined && entry.expiresAt <= Date.now();\n  }\n\n  /** Periodically remove expired keys to keep memory tidy */\n  private sweep(): void {\n    const now = Date.now();\n    for (const [key, entry] of this.memory) {\n      if (entry.expiresAt !== undefined && entry.expiresAt <= now) {\n        if (entry.timeout) clearTimeout(entry.timeout);\n        this.memory.delete(key);\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"cache-memory.provider.js","sourceRoot":"","sources":["../../../../src/cache/providers/cache-memory.provider.ts"],"names":[],"mappings":"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","sourcesContent":["import { Provider, ProviderScope } from '@frontmcp/sdk';\nimport { CacheStoreInterface } from '../cache.types';\n\ntype Entry = {\n  value: string;\n  /** epoch millis when this entry expires (undefined = no TTL) */\n  expiresAt?: number;\n  /** per-key timeout when TTL is short enough to schedule */\n  timeout?: NodeJS.Timeout;\n};\n\nconst MAX_TIMEOUT_MS = 2 ** 31 - 1; // ~24.8 days (Node setTimeout limit)\n\n@Provider({\n  name: 'provider:cache:memory',\n  description: 'Memory-based cache provider',\n  scope: ProviderScope.GLOBAL,\n})\nexport default class CacheMemoryProvider  implements CacheStoreInterface{\n  private readonly memory = new Map<string, Entry>();\n  private sweeper?: NodeJS.Timeout;\n\n  constructor(sweepIntervalTTL = 60) {\n    this.sweeper = setInterval(() => this.sweep(), sweepIntervalTTL * 1000);\n    // don’t keep the process alive just for the sweeper (Node >=14)\n    (this.sweeper as any).unref?.();\n  }\n\n  /** Set any value (auto-stringifies objects) */\n  async setValue(key: string, value: any, ttlSeconds?: number): Promise<void> {\n    const strValue = typeof value === 'string' ? value : JSON.stringify(value);\n\n    // clear any previous timeout on this key\n    const existing = this.memory.get(key);\n    if (existing?.timeout) clearTimeout(existing.timeout);\n\n    const entry: Entry = { value: strValue };\n\n    if (ttlSeconds && ttlSeconds > 0) {\n      const ttlMs = ttlSeconds * 1000;\n      entry.expiresAt = Date.now() + ttlMs;\n\n      // Only schedule a timer if within Node's setTimeout limit; otherwise rely on sweeper/lazy purge\n      if (ttlMs <= MAX_TIMEOUT_MS) {\n        entry.timeout = setTimeout(() => {\n          // final check guards against clock drift or updates\n          const e = this.memory.get(key);\n          if (e && e.expiresAt && e.expiresAt <= Date.now()) {\n            this.memory.delete(key);\n          }\n        }, ttlMs);\n        (entry.timeout as any).unref?.();\n      }\n    }\n\n    this.memory.set(key, entry);\n  }\n\n  /** Get a value and automatically parse JSON if possible */\n  async getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined> {\n    const entry = this.memory.get(key);\n    if (!entry) return defaultValue;\n\n    if (this.isExpired(entry)) {\n      await this.delete(key);\n      return defaultValue;\n    }\n\n    const raw = entry.value;\n    try {\n      return JSON.parse(raw) as T;\n    } catch {\n      // fallback for plain string values\n      return raw as unknown as T;\n    }\n  }\n\n  /** Delete a key */\n  async delete(key: string): Promise<void> {\n    const entry = this.memory.get(key);\n    if (entry?.timeout) clearTimeout(entry.timeout);\n    this.memory.delete(key);\n  }\n\n  /** Check if a key exists (and not expired) */\n  async exists(key: string): Promise<boolean> {\n    const entry = this.memory.get(key);\n    if (!entry) return false;\n    if (this.isExpired(entry)) {\n      await this.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  /** Gracefully close the provider */\n  async close(): Promise<void> {\n    if (this.sweeper) clearInterval(this.sweeper);\n    for (const [, entry] of this.memory) {\n      if (entry.timeout) clearTimeout(entry.timeout);\n    }\n    this.memory.clear();\n  }\n\n  // ---- internals ----\n\n  private isExpired(entry: Entry): boolean {\n    return entry.expiresAt !== undefined && entry.expiresAt <= Date.now();\n  }\n\n  /** Periodically remove expired keys to keep memory tidy */\n  private sweep(): void {\n    const now = Date.now();\n    for (const [key, entry] of this.memory) {\n      if (entry.expiresAt !== undefined && entry.expiresAt <= now) {\n        if (entry.timeout) clearTimeout(entry.timeout);\n        this.memory.delete(key);\n      }\n    }\n  }\n}\n"]}

package/src/cache/providers/cache-redis.provider.js

@@ -4,6 +4,7 @@ const tslib_1 = require("tslib");
 const ioredis_1 = tslib_1.__importDefault(require("ioredis"));
 const sdk_1 = require("@frontmcp/sdk");
 let CacheRedisProvider = class CacheRedisProvider {
+    client;
     constructor(options) {
         if (options.type !== 'redis' && options.type !== 'redis-client') {
             throw new Error('Invalid cache provider type');

package/src/cache/providers/cache-redis.provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-redis.provider.js","sourceRoot":"","sources":["../../../../src/cache/providers/cache-redis.provider.ts"],"names":[],"mappings":";;;AAAA,8DAAsD;AACtD,uCAAwD;AAQzC,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAGrC,YAAY,OAA0B;QACpC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAK,CAAC;YACtB,WAAW,EAAE,KAAK;YAClB,oBAAoB,EAAE,CAAC;YACvB,GAAG,OAAO,CAAC,MAAM;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,KAAU,EAAE,UAAmB;QACzD,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,UAAU,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,QAAQ,CAAU,GAAW,EAAE,YAAgB;QACnD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,YAAY,CAAC;QAEtC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;YACnC,OAAO,GAAmB,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF,CAAA;AA3DoB,kBAAkB;IALtC,IAAA,cAAQ,EAAC;QACR,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,mBAAa,CAAC,MAAM;KAC5B,CAAC;;GACmB,kBAAkB,CA2DtC;kBA3DoB,kBAAkB","sourcesContent":["import Redis, { Redis as RedisClient } from 'ioredis';\nimport { Provider, ProviderScope } from '@frontmcp/sdk';\nimport { CacheStoreInterface, RedisCacheOptions } from '../cache.types';\n\n@Provider({\n  name: 'provider:cache:redis',\n  description: 'Redis-based cache provider',\n  scope: ProviderScope.GLOBAL,\n})\nexport default class CacheRedisProvider implements CacheStoreInterface {\n  private readonly client: RedisClient;\n\n  constructor(options: RedisCacheOptions) {\n    if (options.type !== 'redis' && options.type !== 'redis-client') {\n      throw new Error('Invalid cache provider type');\n    }\n\n    if (options.type === 'redis-client') {\n      this.client = options.client;\n      return;\n    }\n    this.client = new Redis({\n      lazyConnect: false,\n      maxRetriesPerRequest: 3,\n      ...options.config,\n    });\n\n    this.client.on('connect', () => console.log('[Redis] Connected'));\n    this.client.on('error', (err) => console.error('[Redis] Error:', err));\n  }\n\n  /** Set any value (auto-stringifies objects) */\n  async setValue(key: string, value: any, ttlSeconds?: number): Promise<void> {\n    const strValue = typeof value === 'string' ? value : JSON.stringify(value);\n    if (ttlSeconds && ttlSeconds > 0) {\n      await this.client.set(key, strValue, 'EX', ttlSeconds);\n    } else {\n      await this.client.set(key, strValue);\n    }\n  }\n\n  /** Get a value and automatically parse JSON if possible */\n  async getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined> {\n    const raw = await this.client.get(key);\n    if (raw === null) return defaultValue;\n\n    try {\n      return JSON.parse(raw) as T;\n    } catch {\n      // fallback for plain string values\n      return raw as unknown as T;\n    }\n  }\n\n  /** Delete a key */\n  async delete(key: string): Promise<void> {\n    await this.client.del(key);\n  }\n\n  /** Check if a key exists */\n  async exists(key: string): Promise<boolean> {\n    return (await this.client.exists(key)) === 1;\n  }\n\n  /** Gracefully close the Redis connection */\n  async close(): Promise<void> {\n    await this.client.quit();\n  }\n}\n"]}
+{"version":3,"file":"cache-redis.provider.js","sourceRoot":"","sources":["../../../../src/cache/providers/cache-redis.provider.ts"],"names":[],"mappings":";;;AAAA,8DAAsD;AACtD,uCAAwD;AAQzC,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IACpB,MAAM,CAAc;IAErC,YAAY,OAA0B;QACpC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAK,CAAC;YACtB,WAAW,EAAE,KAAK;YAClB,oBAAoB,EAAE,CAAC;YACvB,GAAG,OAAO,CAAC,MAAM;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,KAAU,EAAE,UAAmB;QACzD,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,UAAU,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,QAAQ,CAAU,GAAW,EAAE,YAAgB;QACnD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,YAAY,CAAC;QAEtC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;YACnC,OAAO,GAAmB,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF,CAAA;AA3DoB,kBAAkB;IALtC,IAAA,cAAQ,EAAC;QACR,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,mBAAa,CAAC,MAAM;KAC5B,CAAC;;GACmB,kBAAkB,CA2DtC;kBA3DoB,kBAAkB","sourcesContent":["import Redis, { Redis as RedisClient } from 'ioredis';\nimport { Provider, ProviderScope } from '@frontmcp/sdk';\nimport { CacheStoreInterface, RedisCacheOptions } from '../cache.types';\n\n@Provider({\n  name: 'provider:cache:redis',\n  description: 'Redis-based cache provider',\n  scope: ProviderScope.GLOBAL,\n})\nexport default class CacheRedisProvider implements CacheStoreInterface {\n  private readonly client: RedisClient;\n\n  constructor(options: RedisCacheOptions) {\n    if (options.type !== 'redis' && options.type !== 'redis-client') {\n      throw new Error('Invalid cache provider type');\n    }\n\n    if (options.type === 'redis-client') {\n      this.client = options.client;\n      return;\n    }\n    this.client = new Redis({\n      lazyConnect: false,\n      maxRetriesPerRequest: 3,\n      ...options.config,\n    });\n\n    this.client.on('connect', () => console.log('[Redis] Connected'));\n    this.client.on('error', (err) => console.error('[Redis] Error:', err));\n  }\n\n  /** Set any value (auto-stringifies objects) */\n  async setValue(key: string, value: any, ttlSeconds?: number): Promise<void> {\n    const strValue = typeof value === 'string' ? value : JSON.stringify(value);\n    if (ttlSeconds && ttlSeconds > 0) {\n      await this.client.set(key, strValue, 'EX', ttlSeconds);\n    } else {\n      await this.client.set(key, strValue);\n    }\n  }\n\n  /** Get a value and automatically parse JSON if possible */\n  async getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined> {\n    const raw = await this.client.get(key);\n    if (raw === null) return defaultValue;\n\n    try {\n      return JSON.parse(raw) as T;\n    } catch {\n      // fallback for plain string values\n      return raw as unknown as T;\n    }\n  }\n\n  /** Delete a key */\n  async delete(key: string): Promise<void> {\n    await this.client.del(key);\n  }\n\n  /** Check if a key exists */\n  async exists(key: string): Promise<boolean> {\n    return (await this.client.exists(key)) === 1;\n  }\n\n  /** Gracefully close the Redis connection */\n  async close(): Promise<void> {\n    await this.client.quit();\n  }\n}\n"]}