@frontmcp/plugins 0.6.0 → 0.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/plugins",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "FrontMCP plugins to extend the SDK",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -21,23 +21,62 @@
   "bugs": {
     "url": "https://github.com/agentfront/frontmcp/issues"
   },
-  "main": "./src/index.js",
-  "types": "./src/index.d.ts",
+  "type": "commonjs",
+  "main": "./index.js",
+  "module": "./esm/index.mjs",
+  "types": "./index.d.ts",
+  "sideEffects": false,
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js",
-      "default": "./src/index.js"
-    }
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./esm/index.mjs"
+      }
+    },
+    "./cache": {
+      "require": {
+        "types": "./cache/index.d.ts",
+        "default": "./cache/index.js"
+      },
+      "import": {
+        "types": "./cache/index.d.ts",
+        "default": "./esm/cache/index.mjs"
+      }
+    },
+    "./codecall": {
+      "require": {
+        "types": "./codecall/index.d.ts",
+        "default": "./codecall/index.js"
+      },
+      "import": {
+        "types": "./codecall/index.d.ts",
+        "default": "./esm/codecall/index.mjs"
+      }
+    },
+    "./esm": null
   },
   "dependencies": {
     "ioredis": "^5.8.0",
-    "@frontmcp/sdk": "0.6.0",
+    "@frontmcp/sdk": "0.6.2",
     "enclave-vm": "^1.0.3",
     "vectoriadb": "^2.0.1",
     "zod": "^4.0.0",
-    "@modelcontextprotocol/sdk": "1.24.3"
+    "@modelcontextprotocol/sdk": "1.25.1"
+  },
+  "devDependencies": {
+    "reflect-metadata": "^0.2.2"
   },
-  "type": "commonjs"
+  "peerDependencies": {
+    "@vercel/kv": "^2.0.0 || ^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@vercel/kv": {
+      "optional": true
+    }
+  }
 }

package/src/cache/README.md

@@ -1,186 +0,0 @@
-# Cache Plugin
-
-## Overview
-
-### Purpose
-
-Provides **transparent response caching** for tools based on their input payloads — reducing redundant computation and
-improving response time.
-
-### Storage
-
-Supports **in-memory** caching out of the box and optional **Redis** backends. Choose `type: 'memory'`, `type: 'redis'`,
-or `type: 'redis-client'` when registering the plugin.
-
-### Keying
-
-Cache entries are keyed using a **deterministic hash** of each tool’s validated input (`ctx.input`).
-
-### Lifecycle Hooks
-
-- **Before execution:** `ToolHook.Will('execute')` checks the cache store.
-- **After execution:** `ToolHook.Did('execute')` writes new responses with the resolved TTL.
-
----
-
-## 🔄 How It Works
-
-1. Before a tool executes, the plugin hashes `ctx.input` and checks the configured store for a cached entry.
-2. On a **cache hit**, the cached output is returned immediately, and a flag
-
-   ```json
-   { "___cached__": true }
-   ```
-
-   is added to the response (useful for debugging).
-
-3. If no cached entry exists, the tool runs normally, and the output is stored with the resolved TTL.
-4. When `slideWindow` is enabled, each read refreshes the TTL to keep hot entries alive.
-
----
-
-## ⚙️ Requirements
-
-- Memory mode (`type: 'memory'` or omitted) needs no external services; data resets when the process restarts.
-- Redis mode (`type: 'redis'`) provisions a `CacheRedisProvider` using your host/port (optionally password/db).
-- Redis client mode (`type: 'redis-client'`) reuses an existing `ioredis` client that you supply.
-- Only enable caching for **deterministic** tools whose outputs depend solely on inputs.
-
----
-
-## 🧩 Registering the Plugin
-
-Assume your app class is decorated with `@App` and exposes a `plugins` array.
-
-### 1. Default configuration (in-memory, 1-day TTL)
-
-```ts
-plugins: [CachePlugin];
-```
-
-### 2. Custom default TTL (memory)
-
-```ts
-plugins: [
-  CachePlugin.init({
-    type: 'memory',
-    defaultTTL: 300, // 5 minutes
-  }),
-];
-```
-
-### 3. Redis connection via config
-
-```ts
-plugins: [
-  CachePlugin.init({
-    type: 'redis',
-    defaultTTL: 600,
-    config: {
-      host: '127.0.0.1',
-      port: 6379,
-      // password, db optional
-    },
-  }),
-];
-```
-
-### 4. Reuse an existing Redis client
-
-```ts
-plugins: [
-  CachePlugin.init({
-    type: 'redis-client',
-    defaultTTL: 900,
-    client: existingRedis,
-  }),
-];
-```
-
----
-
-## 🧠 Tool-Level Configuration
-
-Caching is **opt-in** per tool. Add the `cache` field in your tool’s metadata.
-
-### Minimal example
-
-Uses plugin defaults.
-
-```ts
-@Tool({
-  name: 'create-expense',
-  cache: true,
-})
-export default class CreateExpenseTool extends ToolContext {
-  // ...
-}
-```
-
-### Custom TTL and sliding window
-
-```ts
-@Tool({
-  name: 'get-expense-by-id',
-  cache: {
-    ttl: 60, // 1 minute
-    slideWindow: true, // refresh TTL on read
-  },
-})
-export default class GetExpenseTool extends ToolContext {
-  // ...
-}
-```
-
----
-
-## ⚖️ Behavior Details
-
-| Behavior           | Description                                                            |
-| ------------------ | ---------------------------------------------------------------------- |
-| **Key Derivation** | Deterministic hash from `ctx.input`. Changing input changes cache key. |
-| **Cache Hits**     | Adds `___cached__: true` to the output (for observability only).       |
-| **Default TTL**    | Plugin `defaultTTL` → falls back to `86400` seconds (1 day).           |
-| **Sliding Window** | Extends TTL on reads when `slideWindow` is true.                       |
-| **Store Choice**   | Memory is node-local; Redis enables multi-instance sharing.            |
-
----
-
-## 🧹 Invalidation Strategies
-
-| Strategy                | Use When                   | Notes                                    |
-| ----------------------- | -------------------------- | ---------------------------------------- |
-| **Time-based**          | Data changes often         | Use short TTLs                           |
-| **Input Shaping**       | Input determines freshness | Include relevant identifiers in input    |
-| **Manual Invalidation** | You need explicit control  | Extend or wrap the plugin to delete keys |
-
----
-
-## 🧩 Troubleshooting
-
-| Symptom                     | Possible Cause                               | Fix                                                          |
-| --------------------------- | -------------------------------------------- | ------------------------------------------------------------ |
-| No cache hits               | Tool missing `cache` config or store offline | Add `cache: {}` to tool metadata and verify store connection |
-| Output unexpectedly cached  | Previous result reused                       | Lower TTL or modify input for unique cache key               |
-| Need tenant/session scoping | Same input shared across tenants             | Include tenant/session IDs in the input payload              |
-
----
-
-## 🧾 Reference
-
-### Plugin options (registration)
-
-| Option       | Type                                             | Default    | Description                                        |
-| ------------ | ------------------------------------------------ | ---------- | -------------------------------------------------- |
-| `type`       | `'memory' \| 'redis' \| 'redis-client'`          | `'memory'` | Selects the backing store.                         |
-| `defaultTTL` | `number`                                         | `86400`    | Default time-to-live (seconds).                    |
-| `config`     | `{ host: string; port: number; password?; db? }` | —          | Redis connection details when `type: 'redis'`.     |
-| `client`     | `Redis` (from `ioredis`)                         | —          | Existing Redis client when `type: 'redis-client'`. |
-
-### Tool metadata (`@Tool` / `tool`)
-
-| Option              | Type      | Description                           |
-| ------------------- | --------- | ------------------------------------- |
-| `cache`             | `true`    | Enable caching with plugin defaults.  |
-| `cache.ttl`         | `number`  | Override TTL (seconds) for this tool. |
-| `cache.slideWindow` | `boolean` | Refresh TTL on reads for this tool.   |

package/src/cache/cache.plugin.js

@@ -1,135 +0,0 @@
-"use strict";
-var CachePlugin_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-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 = 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 = {
-            defaultTTL: 60 * 60 * 24,
-            ...options,
-        };
-    }
-    async willReadCache(flowCtx) {
-        const { tool, toolContext } = flowCtx.state;
-        if (!tool || !toolContext)
-            return;
-        const { cache } = toolContext.metadata;
-        if (!cache || typeof toolContext.input === 'undefined') {
-            // no cache or no input, skip
-            return;
-        }
-        const cacheStore = this.get(cache_symbol_1.CacheStoreToken);
-        const hash = hashObject({ tool: tool.fullName, input: toolContext.input });
-        const cached = await cacheStore.getValue(hash);
-        if (cached !== undefined && cached !== null) {
-            if (cache === true || (cache.ttl && cache.slideWindow)) {
-                const ttl = cache === true ? this.options.defaultTTL : cache.ttl ?? this.options.defaultTTL;
-                await cacheStore.setValue(hash, cached, ttl);
-            }
-            /**
-             * double check if cache still valid based on tool output schema
-             */
-            if (!tool.safeParseOutput(cached).success) {
-                await cacheStore.delete(hash);
-                return;
-            }
-            /**
-             * cache hit, set output to the main flow context
-             */
-            flowCtx.state.rawOutput = cached;
-            /**
-             * call respond to bypass tool execution
-             */
-            toolContext.respond(cached);
-        }
-    }
-    async willWriteCache(flowCtx) {
-        const { tool, toolContext } = flowCtx.state;
-        if (!tool || !toolContext)
-            return;
-        const { cache } = toolContext.metadata;
-        if (!cache || typeof toolContext.input === 'undefined') {
-            return;
-        }
-        const cacheStore = this.get(cache_symbol_1.CacheStoreToken);
-        const ttl = cache === true ? this.options.defaultTTL : cache.ttl ?? this.options.defaultTTL;
-        const hash = hashObject({ tool: tool.fullName, input: toolContext.input });
-        await cacheStore.setValue(hash, toolContext.output, ttl);
-    }
-};
-tslib_1.__decorate([
-    sdk_1.ToolHook.Will('execute', { priority: 1000 }),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], CachePlugin.prototype, "willReadCache", null);
-tslib_1.__decorate([
-    sdk_1.ToolHook.Did('execute', { priority: 1000 }),
-    tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [Object]),
-    tslib_1.__metadata("design:returntype", Promise)
-], CachePlugin.prototype, "willWriteCache", null);
-CachePlugin = CachePlugin_1 = tslib_1.__decorate([
-    (0, sdk_1.Plugin)({
-        name: 'cache',
-        description: 'Cache plugin for caching tool results',
-        providers: [
-            /* add providers that always loaded with the plugin or default providers */
-            {
-                // this is a default provider for cache, will be overridden if dynamicProviders based on config
-                name: 'cache:memory',
-                provide: cache_symbol_1.CacheStoreToken,
-                useValue: new cache_memory_provider_1.default(60 * 60 * 24),
-            },
-        ],
-    }),
-    tslib_1.__metadata("design:paramtypes", [Object])
-], CachePlugin);
-exports.default = CachePlugin;
-function hashObject(obj) {
-    const keys = Object.keys(obj).sort();
-    return keys.reduce((acc, key) => {
-        acc += key + ':';
-        const val = obj[key];
-        if (typeof val === 'object' && val !== null) {
-            acc += hashObject(val);
-        }
-        else {
-            acc += val;
-        }
-        acc += ';';
-        return acc;
-    }, '');
-}
-//# sourceMappingURL=cache.plugin.js.map

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

@@ -1 +0,0 @@
-{"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/cache.symbol.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CacheStoreToken = void 0;
-exports.CacheStoreToken = Symbol('plugin:cache:store');
-//# sourceMappingURL=cache.symbol.js.map

package/src/cache/cache.symbol.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.symbol.js","sourceRoot":"","sources":["../../../src/cache/cache.symbol.ts"],"names":[],"mappings":";;;AAGa,QAAA,eAAe,GAA+B,MAAM,CAAC,oBAAoB,CAAC,CAAC","sourcesContent":["import { CacheStoreInterface } from './cache.types';\nimport { Token } from '@frontmcp/sdk';\n\nexport const CacheStoreToken: Token<CacheStoreInterface> = Symbol('plugin:cache:store');\n"]}

package/src/cache/cache.types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=cache.types.js.map

package/src/cache/cache.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.types.js","sourceRoot":"","sources":["../../../src/cache/cache.types.ts"],"names":[],"mappings":"","sourcesContent":["import { Redis as RedisClient } from 'ioredis';\n\ndeclare global {\n  interface ExtendFrontMcpToolMetadata {\n    cache?: CachePluginToolOptions | true;\n  }\n}\n\nexport interface CachePluginToolOptions {\n  /**\n   * Time to live in seconds. Default is 1 day.\n   */\n  ttl?: number; // default 1 day\n\n  /**\n   * If true, the cache value will be updated with the new value after the TTL.\n   * Default is false.\n   */\n  slideWindow?: boolean;\n}\n\nexport interface BaseCachePluginOptions {\n  defaultTTL?: number; // default 1 day\n}\n\nexport interface RedisClientCachePluginOptions extends BaseCachePluginOptions {\n  type: 'redis-client';\n  client: RedisClient;\n}\n\nexport interface RedisCachePluginOptions extends BaseCachePluginOptions {\n  type: 'redis';\n  config: {\n    host: string;\n    port: number;\n    password?: string;\n    db?: number;\n  };\n}\n\nexport type MemoryCachePluginOptions = BaseCachePluginOptions & {\n  type: 'memory';\n};\n\nexport type RedisCacheOptions = RedisClientCachePluginOptions | RedisCachePluginOptions;\n\nexport type CachePluginOptions = MemoryCachePluginOptions | RedisCacheOptions;\n\nexport interface CacheStoreInterface {\n  setValue(key: string, value: any, ttlSeconds?: number): Promise<void>;\n\n  getValue<T = any>(key: string, defaultValue?: T): Promise<T | undefined>;\n\n  delete(key: string): Promise<void>;\n\n  exists(key: string): Promise<boolean>;\n\n  close(): Promise<void>;\n}\n"]}

package/src/cache/index.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = void 0;
-const tslib_1 = require("tslib");
-var cache_plugin_1 = require("./cache.plugin");
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return tslib_1.__importDefault(cache_plugin_1).default; } });
-tslib_1.__exportStar(require("./cache.types"), exports);
-//# sourceMappingURL=index.js.map

package/src/cache/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/index.ts"],"names":[],"mappings":";;;;AAAA,+CAAyC;AAAhC,gIAAA,OAAO,OAAA;AAChB,wDAA8B","sourcesContent":["export { default } from './cache.plugin';\nexport * from './cache.types';\n"]}

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

@@ -1,110 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-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.sweeper = setInterval(() => this.sweep(), sweepIntervalTTL * 1000);
-        // don’t keep the process alive just for the sweeper (Node >=14)
-        this.sweeper.unref?.();
-    }
-    /** Set any value (auto-stringifies objects) */
-    async setValue(key, value, ttlSeconds) {
-        const strValue = typeof value === 'string' ? value : JSON.stringify(value);
-        // clear any previous timeout on this key
-        const existing = this.memory.get(key);
-        if (existing?.timeout)
-            clearTimeout(existing.timeout);
-        const entry = { value: strValue };
-        if (ttlSeconds && ttlSeconds > 0) {
-            const ttlMs = ttlSeconds * 1000;
-            entry.expiresAt = Date.now() + ttlMs;
-            // Only schedule a timer if within Node's setTimeout limit; otherwise rely on sweeper/lazy purge
-            if (ttlMs <= MAX_TIMEOUT_MS) {
-                entry.timeout = setTimeout(() => {
-                    // final check guards against clock drift or updates
-                    const e = this.memory.get(key);
-                    if (e && e.expiresAt && e.expiresAt <= Date.now()) {
-                        this.memory.delete(key);
-                    }
-                }, ttlMs);
-                entry.timeout.unref?.();
-            }
-        }
-        this.memory.set(key, entry);
-    }
-    /** Get a value and automatically parse JSON if possible */
-    async getValue(key, defaultValue) {
-        const entry = this.memory.get(key);
-        if (!entry)
-            return defaultValue;
-        if (this.isExpired(entry)) {
-            await this.delete(key);
-            return defaultValue;
-        }
-        const raw = entry.value;
-        try {
-            return JSON.parse(raw);
-        }
-        catch {
-            // fallback for plain string values
-            return raw;
-        }
-    }
-    /** Delete a key */
-    async delete(key) {
-        const entry = this.memory.get(key);
-        if (entry?.timeout)
-            clearTimeout(entry.timeout);
-        this.memory.delete(key);
-    }
-    /** Check if a key exists (and not expired) */
-    async exists(key) {
-        const entry = this.memory.get(key);
-        if (!entry)
-            return false;
-        if (this.isExpired(entry)) {
-            await this.delete(key);
-            return false;
-        }
-        return true;
-    }
-    /** Gracefully close the provider */
-    async close() {
-        if (this.sweeper)
-            clearInterval(this.sweeper);
-        for (const [, entry] of this.memory) {
-            if (entry.timeout)
-                clearTimeout(entry.timeout);
-        }
-        this.memory.clear();
-    }
-    // ---- internals ----
-    isExpired(entry) {
-        return entry.expiresAt !== undefined && entry.expiresAt <= Date.now();
-    }
-    /** Periodically remove expired keys to keep memory tidy */
-    sweep() {
-        const now = Date.now();
-        for (const [key, entry] of this.memory) {
-            if (entry.expiresAt !== undefined && entry.expiresAt <= now) {
-                if (entry.timeout)
-                    clearTimeout(entry.timeout);
-                this.memory.delete(key);
-            }
-        }
-    }
-};
-CacheMemoryProvider = tslib_1.__decorate([
-    (0, sdk_1.Provider)({
-        name: 'provider:cache:memory',
-        description: 'Memory-based cache provider',
-        scope: sdk_1.ProviderScope.GLOBAL,
-    }),
-    tslib_1.__metadata("design:paramtypes", [Object])
-], CacheMemoryProvider);
-exports.default = CacheMemoryProvider;
-//# sourceMappingURL=cache-memory.provider.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-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');
-        }
-        if (options.type === 'redis-client') {
-            this.client = options.client;
-            return;
-        }
-        this.client = new ioredis_1.default({
-            lazyConnect: false,
-            maxRetriesPerRequest: 3,
-            ...options.config,
-        });
-        this.client.on('connect', () => console.log('[Redis] Connected'));
-        this.client.on('error', (err) => console.error('[Redis] Error:', err));
-    }
-    /** Set any value (auto-stringifies objects) */
-    async setValue(key, value, ttlSeconds) {
-        const strValue = typeof value === 'string' ? value : JSON.stringify(value);
-        if (ttlSeconds && ttlSeconds > 0) {
-            await this.client.set(key, strValue, 'EX', ttlSeconds);
-        }
-        else {
-            await this.client.set(key, strValue);
-        }
-    }
-    /** Get a value and automatically parse JSON if possible */
-    async getValue(key, defaultValue) {
-        const raw = await this.client.get(key);
-        if (raw === null)
-            return defaultValue;
-        try {
-            return JSON.parse(raw);
-        }
-        catch {
-            // fallback for plain string values
-            return raw;
-        }
-    }
-    /** Delete a key */
-    async delete(key) {
-        await this.client.del(key);
-    }
-    /** Check if a key exists */
-    async exists(key) {
-        return (await this.client.exists(key)) === 1;
-    }
-    /** Gracefully close the Redis connection */
-    async close() {
-        await this.client.quit();
-    }
-};
-CacheRedisProvider = tslib_1.__decorate([
-    (0, sdk_1.Provider)({
-        name: 'provider:cache:redis',
-        description: 'Redis-based cache provider',
-        scope: sdk_1.ProviderScope.GLOBAL,
-    }),
-    tslib_1.__metadata("design:paramtypes", [Object])
-], CacheRedisProvider);
-exports.default = CacheRedisProvider;
-//# sourceMappingURL=cache-redis.provider.js.map

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

@@ -1 +0,0 @@
-{"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"]}