gauss-ai 4.0.0

package/dist/chunk-X2GHUHAF.js

@@ -0,0 +1,436 @@
+// src/plugins/plugin-manager.ts
+var PluginManager = class {
+  plugins = [];
+  subscriptions = /* @__PURE__ */ new Map();
+  initPromise;
+  disposed = false;
+  register(plugin) {
+    if (this.initPromise) throw new Error("Cannot register plugins after initialization");
+    if (this.plugins.some((p) => p.name === plugin.name)) {
+      throw new Error(`Plugin "${plugin.name}" is already registered`);
+    }
+    this.plugins.push(plugin);
+  }
+  async initialize(ctx) {
+    if (this.disposed) throw new Error("Cannot initialize a disposed PluginManager");
+    if (!this.initPromise) {
+      this.initPromise = this.doInitialize(ctx);
+    }
+    return this.initPromise;
+  }
+  async doInitialize(ctx) {
+    const initialized = [];
+    try {
+      for (const plugin of this.plugins) {
+        const pluginCtx = {
+          ...ctx,
+          on: (eventType, handler) => {
+            const unsubscribe = ctx.on(eventType, handler);
+            let unsubscribers = this.subscriptions.get(plugin);
+            if (!unsubscribers) {
+              unsubscribers = /* @__PURE__ */ new Set();
+              this.subscriptions.set(plugin, unsubscribers);
+            }
+            const trackedUnsubscribe = () => {
+              unsubscribe();
+              unsubscribers?.delete(trackedUnsubscribe);
+            };
+            unsubscribers.add(trackedUnsubscribe);
+            return trackedUnsubscribe;
+          }
+        };
+        if (plugin.setup) {
+          await plugin.setup(pluginCtx);
+        }
+        initialized.push(plugin);
+      }
+    } catch (error) {
+      await this.rollback(initialized);
+      this.initPromise = void 0;
+      throw error;
+    }
+  }
+  async rollback(initialized) {
+    for (let i = initialized.length - 1; i >= 0; i--) {
+      const plugin = initialized[i];
+      this.detachAllSubscriptions(plugin);
+      if (!plugin.dispose) continue;
+      try {
+        await plugin.dispose();
+      } catch {
+      }
+    }
+  }
+  detachAllSubscriptions(plugin) {
+    const unsubscribers = this.subscriptions.get(plugin);
+    if (!unsubscribers) return;
+    for (const unsubscribe of unsubscribers) {
+      try {
+        unsubscribe();
+      } catch {
+      }
+    }
+    this.subscriptions.delete(plugin);
+  }
+  /** Collect all plugin tools with deterministic override protection. */
+  collectTools() {
+    const tools = {};
+    for (const plugin of this.plugins) {
+      if (!plugin.tools) continue;
+      for (const [toolName, toolDef] of Object.entries(plugin.tools)) {
+        if (toolName in tools) {
+          throw new Error(`Duplicate plugin tool "${toolName}" from plugin "${plugin.name}"`);
+        }
+        tools[toolName] = toolDef;
+      }
+    }
+    return tools;
+  }
+  async runBeforeRun(ctx, params) {
+    let prompt = params.prompt;
+    for (const plugin of this.plugins) {
+      const hook = plugin.hooks?.beforeRun;
+      if (!hook) continue;
+      const result = await hook(ctx, { prompt });
+      if (result?.prompt !== void 0) {
+        prompt = result.prompt;
+      }
+    }
+    return { prompt };
+  }
+  async runAfterRun(ctx, params) {
+    for (const plugin of this.plugins) {
+      const hook = plugin.hooks?.afterRun;
+      if (!hook) continue;
+      await hook(ctx, params);
+    }
+  }
+  async runBeforeTool(ctx, params) {
+    let args = params.args;
+    for (const plugin of this.plugins) {
+      const hook = plugin.hooks?.beforeTool;
+      if (!hook) continue;
+      const result = await hook(ctx, {
+        toolName: params.toolName,
+        args
+      });
+      if (result?.args !== void 0) {
+        args = result.args;
+      }
+      if (result?.skip) {
+        return {
+          args,
+          skip: true,
+          result: result.result
+        };
+      }
+    }
+    return { args };
+  }
+  async runAfterTool(ctx, params) {
+    for (const plugin of this.plugins) {
+      const hook = plugin.hooks?.afterTool;
+      if (!hook) continue;
+      await hook(ctx, params);
+    }
+  }
+  async runBeforeStep(ctx, params) {
+    let step = params.step;
+    for (const plugin of this.plugins) {
+      const hook = plugin.hooks?.beforeStep;
+      if (!hook) continue;
+      const result = await hook(ctx, {
+        stepIndex: params.stepIndex,
+        step
+      });
+      if (result?.step !== void 0) {
+        step = result.step;
+      }
+      if (result?.skip) {
+        return {
+          step,
+          skip: true
+        };
+      }
+    }
+    return { step };
+  }
+  async runAfterStep(ctx, params) {
+    for (const plugin of this.plugins) {
+      const hook = plugin.hooks?.afterStep;
+      if (!hook) continue;
+      await hook(ctx, params);
+    }
+  }
+  async runOnError(ctx, params) {
+    let suppress = false;
+    for (const plugin of this.plugins) {
+      const hook = plugin.hooks?.onError;
+      if (!hook) continue;
+      try {
+        const result = await hook(ctx, params);
+        if (result?.suppress) suppress = true;
+      } catch {
+      }
+    }
+    return { suppress };
+  }
+  async dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    const errors = [];
+    for (let i = this.plugins.length - 1; i >= 0; i--) {
+      const plugin = this.plugins[i];
+      this.detachAllSubscriptions(plugin);
+      if (!plugin.dispose) continue;
+      try {
+        await plugin.dispose();
+      } catch (error) {
+        errors.push(error);
+      }
+    }
+    if (errors.length > 0) {
+      throw new AggregateError(errors, "Plugin disposal errors");
+    }
+  }
+  get count() {
+    return this.plugins.length;
+  }
+  getPlugins() {
+    return this.plugins;
+  }
+};
+
+// src/adapters/resilience/circuit-breaker.ts
+var DEFAULT_CIRCUIT_BREAKER_CONFIG = {
+  failureThreshold: 5,
+  resetTimeoutMs: 3e4,
+  monitorWindowMs: 6e4
+};
+var CircuitBreaker = class {
+  constructor(config = DEFAULT_CIRCUIT_BREAKER_CONFIG) {
+    this.config = config;
+  }
+  state = "closed" /* CLOSED */;
+  failures = [];
+  lastFailureTime = 0;
+  halfOpenTestInProgress = false;
+  async execute(operation) {
+    if (this.shouldReject()) {
+      throw new CircuitBreakerError("Circuit breaker is OPEN");
+    }
+    try {
+      const result = await operation();
+      this.onSuccess();
+      return result;
+    } catch (error) {
+      this.onFailure();
+      throw error;
+    }
+  }
+  getState() {
+    this.updateState();
+    return this.state;
+  }
+  getFailureCount() {
+    this.cleanupOldFailures();
+    return this.failures.length;
+  }
+  reset() {
+    this.state = "closed" /* CLOSED */;
+    this.failures = [];
+    this.lastFailureTime = 0;
+    this.halfOpenTestInProgress = false;
+  }
+  shouldReject() {
+    this.updateState();
+    if (this.state === "open" /* OPEN */) {
+      return true;
+    }
+    if (this.state === "half-open" /* HALF_OPEN */ && this.halfOpenTestInProgress) {
+      return true;
+    }
+    return false;
+  }
+  onSuccess() {
+    if (this.state === "half-open" /* HALF_OPEN */) {
+      this.state = "closed" /* CLOSED */;
+      this.failures = [];
+      this.halfOpenTestInProgress = false;
+    }
+  }
+  onFailure() {
+    const now = Date.now();
+    this.failures.push({ timestamp: now });
+    this.lastFailureTime = now;
+    this.halfOpenTestInProgress = false;
+    if (this.state === "half-open" /* HALF_OPEN */) {
+      this.state = "open" /* OPEN */;
+      return;
+    }
+    this.cleanupOldFailures();
+    if (this.failures.length >= this.config.failureThreshold) {
+      this.state = "open" /* OPEN */;
+    }
+  }
+  updateState() {
+    if (this.state === "open" /* OPEN */) {
+      const now = Date.now();
+      if (now - this.lastFailureTime >= this.config.resetTimeoutMs) {
+        this.state = "half-open" /* HALF_OPEN */;
+        this.halfOpenTestInProgress = false;
+      }
+    } else if (this.state === "half-open" /* HALF_OPEN */ && !this.halfOpenTestInProgress) {
+      this.halfOpenTestInProgress = true;
+    }
+  }
+  cleanupOldFailures() {
+    const now = Date.now();
+    const cutoff = now - this.config.monitorWindowMs;
+    this.failures = this.failures.filter((failure) => failure.timestamp > cutoff);
+  }
+};
+var CircuitBreakerError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CircuitBreakerError";
+  }
+};
+
+// src/adapters/resilience/tool-cache.ts
+var DEFAULT_TOOL_CACHE_CONFIG = {
+  defaultTtlMs: 3e5,
+  // 5 minutes
+  maxSize: 1e3
+};
+var ToolCache = class {
+  constructor(config = DEFAULT_TOOL_CACHE_CONFIG) {
+    this.config = config;
+    this.cleanupIntervalMs = config.cleanupIntervalMs ?? 6e4;
+  }
+  cache = /* @__PURE__ */ new Map();
+  lastCleanup = 0;
+  cleanupIntervalMs;
+  /**
+   * Check if a non-expired entry exists for the key
+   */
+  has(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return false;
+    if (Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Get a cached value
+   */
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) {
+      this.missCount++;
+      return void 0;
+    }
+    const now = Date.now();
+    if (now > entry.expiresAt) {
+      this.cache.delete(key);
+      this.missCount++;
+      return void 0;
+    }
+    this.cache.delete(key);
+    this.cache.set(key, entry);
+    entry.lastAccessed = now;
+    this.hitCount++;
+    return entry.value;
+  }
+  /**
+   * Set a cached value
+   */
+  set(key, value, ttlMs) {
+    const now = Date.now();
+    const ttl = ttlMs ?? this.config.defaultTtlMs;
+    if (ttl <= 0) {
+      return;
+    }
+    const entry = {
+      value,
+      expiresAt: now + ttl,
+      lastAccessed: now
+    };
+    if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {
+      if (this.config.maxSize === 0) {
+        return;
+      }
+      this.evictLRU();
+    }
+    this.cache.delete(key);
+    this.cache.set(key, entry);
+  }
+  /**
+   * Invalidate a specific cache entry
+   */
+  invalidate(key) {
+    return this.cache.delete(key);
+  }
+  /**
+   * Clear all cache entries
+   */
+  clear() {
+    this.cache.clear();
+  }
+  /**
+   * Get current cache size
+   */
+  get size() {
+    this.cleanupExpired();
+    return this.cache.size;
+  }
+  /**
+   * Get cache hit/miss statistics
+   */
+  getStats() {
+    this.cleanupExpired();
+    return {
+      hits: this.hitCount,
+      misses: this.missCount,
+      size: this.cache.size
+    };
+  }
+  /**
+   * Reset statistics
+   */
+  resetStats() {
+    this.hitCount = 0;
+    this.missCount = 0;
+  }
+  hitCount = 0;
+  missCount = 0;
+  evictLRU() {
+    const firstKey = this.cache.keys().next().value;
+    if (firstKey !== void 0) {
+      this.cache.delete(firstKey);
+    }
+  }
+  cleanupExpired() {
+    const now = Date.now();
+    if (now - this.lastCleanup < this.cleanupIntervalMs) return;
+    this.lastCleanup = now;
+    const expired = [];
+    for (const [key, entry] of this.cache.entries()) {
+      if (now > entry.expiresAt) {
+        expired.push(key);
+      }
+    }
+    expired.forEach((key) => this.cache.delete(key));
+  }
+};
+
+export {
+  PluginManager,
+  DEFAULT_CIRCUIT_BREAKER_CONFIG,
+  CircuitBreaker,
+  DEFAULT_TOOL_CACHE_CONFIG,
+  ToolCache
+};
+//# sourceMappingURL=chunk-X2GHUHAF.js.map

package/dist/chunk-X2GHUHAF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/plugin-manager.ts","../src/adapters/resilience/circuit-breaker.ts","../src/adapters/resilience/tool-cache.ts"],"sourcesContent":["// =============================================================================\n// PluginManager — Manages plugin lifecycle, tools, and hook execution order\n// =============================================================================\n\nimport type { Tool } from \"../core/llm/index.js\";\n\nimport type {\n  AfterRunParams,\n  AfterStepParams,\n  AfterToolParams,\n  BeforeRunParams,\n  BeforeRunResult,\n  BeforeStepParams,\n  BeforeStepResult,\n  BeforeToolParams,\n  BeforeToolResult,\n  Plugin,\n  OnErrorParams,\n  OnErrorResult,\n  PluginContext,\n  PluginSetupContext,\n} from \"../ports/plugin.port.js\";\n\nexport class PluginManager {\n  private readonly plugins: Plugin[] = [];\n  private readonly subscriptions = new Map<Plugin, Set<() => void>>();\n  private initPromise?: Promise<void>;\n  private disposed = false;\n\n  register(plugin: Plugin): void {\n    if (this.initPromise) throw new Error(\"Cannot register plugins after initialization\");\n    if (this.plugins.some((p) => p.name === plugin.name)) {\n      throw new Error(`Plugin \\\"${plugin.name}\\\" is already registered`);\n    }\n    this.plugins.push(plugin);\n  }\n\n  async initialize(ctx: PluginSetupContext): Promise<void> {\n    if (this.disposed) throw new Error(\"Cannot initialize a disposed PluginManager\");\n    if (!this.initPromise) {\n      this.initPromise = this.doInitialize(ctx);\n    }\n    return this.initPromise;\n  }\n\n  private async doInitialize(ctx: PluginSetupContext): Promise<void> {\n    const initialized: Plugin[] = [];\n\n    try {\n      for (const plugin of this.plugins) {\n        const pluginCtx: PluginSetupContext = {\n          ...ctx,\n          on: (eventType, handler) => {\n            const unsubscribe = ctx.on(eventType, handler);\n            let unsubscribers = this.subscriptions.get(plugin);\n            if (!unsubscribers) {\n              unsubscribers = new Set();\n              this.subscriptions.set(plugin, unsubscribers);\n            }\n\n            const trackedUnsubscribe = (): void => {\n              unsubscribe();\n              unsubscribers?.delete(trackedUnsubscribe);\n            };\n\n            unsubscribers.add(trackedUnsubscribe);\n            return trackedUnsubscribe;\n          },\n        };\n\n        if (plugin.setup) {\n          await plugin.setup(pluginCtx);\n        }\n\n        initialized.push(plugin);\n      }\n    } catch (error) {\n      await this.rollback(initialized);\n      this.initPromise = undefined;\n      throw error;\n    }\n  }\n\n  private async rollback(initialized: Plugin[]): Promise<void> {\n    for (let i = initialized.length - 1; i >= 0; i--) {\n      const plugin = initialized[i]!;\n      this.detachAllSubscriptions(plugin);\n      if (!plugin.dispose) continue;\n      try {\n        await plugin.dispose();\n      } catch {\n        // Best-effort rollback\n      }\n    }\n  }\n\n  private detachAllSubscriptions(plugin: Plugin): void {\n    const unsubscribers = this.subscriptions.get(plugin);\n    if (!unsubscribers) return;\n    for (const unsubscribe of unsubscribers) {\n      try {\n        unsubscribe();\n      } catch {\n        // Best-effort cleanup\n      }\n    }\n    this.subscriptions.delete(plugin);\n  }\n\n  /** Collect all plugin tools with deterministic override protection. */\n  collectTools(): Record<string, Tool<any, any>> {\n    const tools: Record<string, Tool<any, any>> = {};\n\n    for (const plugin of this.plugins) {\n      if (!plugin.tools) continue;\n\n      for (const [toolName, toolDef] of Object.entries(plugin.tools)) {\n        if (toolName in tools) {\n          throw new Error(`Duplicate plugin tool \\\"${toolName}\\\" from plugin \\\"${plugin.name}\\\"`);\n        }\n        tools[toolName] = toolDef;\n      }\n    }\n\n    return tools;\n  }\n\n  async runBeforeRun(ctx: PluginContext, params: BeforeRunParams): Promise<BeforeRunResult> {\n    let prompt = params.prompt;\n\n    for (const plugin of this.plugins) {\n      const hook = plugin.hooks?.beforeRun;\n      if (!hook) continue;\n\n      const result = await hook(ctx, { prompt });\n      if (result?.prompt !== undefined) {\n        prompt = result.prompt;\n      }\n    }\n\n    return { prompt };\n  }\n\n  async runAfterRun(ctx: PluginContext, params: AfterRunParams): Promise<void> {\n    for (const plugin of this.plugins) {\n      const hook = plugin.hooks?.afterRun;\n      if (!hook) continue;\n      await hook(ctx, params);\n    }\n  }\n\n  async runBeforeTool(ctx: PluginContext, params: BeforeToolParams): Promise<BeforeToolResult> {\n    let args = params.args;\n\n    for (const plugin of this.plugins) {\n      const hook = plugin.hooks?.beforeTool;\n      if (!hook) continue;\n\n      const result = await hook(ctx, {\n        toolName: params.toolName,\n        args,\n      });\n\n      if (result?.args !== undefined) {\n        args = result.args;\n      }\n\n      if (result?.skip) {\n        return {\n          args,\n          skip: true,\n          result: result.result,\n        };\n      }\n    }\n\n    return { args };\n  }\n\n  async runAfterTool(ctx: PluginContext, params: AfterToolParams): Promise<void> {\n    for (const plugin of this.plugins) {\n      const hook = plugin.hooks?.afterTool;\n      if (!hook) continue;\n      await hook(ctx, params);\n    }\n  }\n\n  async runBeforeStep(ctx: PluginContext, params: BeforeStepParams): Promise<BeforeStepResult> {\n    let step = params.step;\n\n    for (const plugin of this.plugins) {\n      const hook = plugin.hooks?.beforeStep;\n      if (!hook) continue;\n\n      const result = await hook(ctx, {\n        stepIndex: params.stepIndex,\n        step,\n      });\n\n      if (result?.step !== undefined) {\n        step = result.step;\n      }\n\n      if (result?.skip) {\n        return {\n          step,\n          skip: true,\n        };\n      }\n    }\n\n    return { step };\n  }\n\n  async runAfterStep(ctx: PluginContext, params: AfterStepParams): Promise<void> {\n    for (const plugin of this.plugins) {\n      const hook = plugin.hooks?.afterStep;\n      if (!hook) continue;\n      await hook(ctx, params);\n    }\n  }\n\n  async runOnError(ctx: PluginContext, params: OnErrorParams): Promise<OnErrorResult> {\n    let suppress = false;\n\n    for (const plugin of this.plugins) {\n      const hook = plugin.hooks?.onError;\n      if (!hook) continue;\n\n      try {\n        const result = await hook(ctx, params);\n        if (result?.suppress) suppress = true;\n      } catch {\n        // onError must be best-effort and never mask original failures\n      }\n    }\n\n    return { suppress };\n  }\n\n  async dispose(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n\n    const errors: unknown[] = [];\n\n    for (let i = this.plugins.length - 1; i >= 0; i--) {\n      const plugin = this.plugins[i]!;\n      this.detachAllSubscriptions(plugin);\n\n      if (!plugin.dispose) continue;\n\n      try {\n        await plugin.dispose();\n      } catch (error) {\n        errors.push(error);\n      }\n    }\n\n    if (errors.length > 0) {\n      throw new AggregateError(errors, \"Plugin disposal errors\");\n    }\n  }\n\n  get count(): number {\n    return this.plugins.length;\n  }\n\n  getPlugins(): readonly Plugin[] {\n    return this.plugins;\n  }\n}\n","/**\n * Circuit Breaker implementation following the classic pattern\n * States: closed → open → half-open\n */\n\nexport interface CircuitBreakerConfig {\n  readonly failureThreshold: number;\n  readonly resetTimeoutMs: number;\n  readonly monitorWindowMs: number;\n}\n\nexport const DEFAULT_CIRCUIT_BREAKER_CONFIG: CircuitBreakerConfig = {\n  failureThreshold: 5,\n  resetTimeoutMs: 30_000,\n  monitorWindowMs: 60_000,\n};\n\nexport enum CircuitBreakerState {\n  CLOSED = 'closed',\n  OPEN = 'open',\n  HALF_OPEN = 'half-open',\n}\n\ninterface FailureRecord {\n  timestamp: number;\n}\n\nexport class CircuitBreaker {\n  private state: CircuitBreakerState = CircuitBreakerState.CLOSED;\n  private failures: FailureRecord[] = [];\n  private lastFailureTime = 0;\n  private halfOpenTestInProgress = false;\n\n  constructor(private readonly config: CircuitBreakerConfig = DEFAULT_CIRCUIT_BREAKER_CONFIG) {}\n\n  async execute<T>(operation: () => Promise<T>): Promise<T> {\n    if (this.shouldReject()) {\n      throw new CircuitBreakerError('Circuit breaker is OPEN');\n    }\n\n    try {\n      const result = await operation();\n      this.onSuccess();\n      return result;\n    } catch (error) {\n      this.onFailure();\n      throw error;\n    }\n  }\n\n  getState(): CircuitBreakerState {\n    this.updateState();\n    return this.state;\n  }\n\n  getFailureCount(): number {\n    this.cleanupOldFailures();\n    return this.failures.length;\n  }\n\n  reset(): void {\n    this.state = CircuitBreakerState.CLOSED;\n    this.failures = [];\n    this.lastFailureTime = 0;\n    this.halfOpenTestInProgress = false;\n  }\n\n  private shouldReject(): boolean {\n    this.updateState();\n    \n    if (this.state === CircuitBreakerState.OPEN) {\n      return true;\n    }\n    \n    if (this.state === CircuitBreakerState.HALF_OPEN && this.halfOpenTestInProgress) {\n      return true;\n    }\n\n    return false;\n  }\n\n  private onSuccess(): void {\n    if (this.state === CircuitBreakerState.HALF_OPEN) {\n      this.state = CircuitBreakerState.CLOSED;\n      this.failures = [];\n      this.halfOpenTestInProgress = false;\n    }\n  }\n\n  private onFailure(): void {\n    const now = Date.now();\n    this.failures.push({ timestamp: now });\n    this.lastFailureTime = now;\n    this.halfOpenTestInProgress = false;\n    \n    // A failure during HALF_OPEN always reopens the circuit immediately\n    if (this.state === CircuitBreakerState.HALF_OPEN) {\n      this.state = CircuitBreakerState.OPEN;\n      return;\n    }\n    \n    this.cleanupOldFailures();\n    \n    if (this.failures.length >= this.config.failureThreshold) {\n      this.state = CircuitBreakerState.OPEN;\n    }\n  }\n\n  private updateState(): void {\n    if (this.state === CircuitBreakerState.OPEN) {\n      const now = Date.now();\n      if (now - this.lastFailureTime >= this.config.resetTimeoutMs) {\n        this.state = CircuitBreakerState.HALF_OPEN;\n        this.halfOpenTestInProgress = false;\n      }\n    } else if (this.state === CircuitBreakerState.HALF_OPEN && !this.halfOpenTestInProgress) {\n      this.halfOpenTestInProgress = true;\n    }\n  }\n\n  private cleanupOldFailures(): void {\n    const now = Date.now();\n    const cutoff = now - this.config.monitorWindowMs;\n    this.failures = this.failures.filter(failure => failure.timestamp > cutoff);\n  }\n}\n\nexport class CircuitBreakerError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'CircuitBreakerError';\n  }\n}","/**\n * LRU Cache with TTL support for tool execution results\n */\n\nexport interface ToolCacheConfig {\n  readonly defaultTtlMs: number;\n  readonly maxSize: number;\n  readonly cleanupIntervalMs?: number;\n}\n\nexport const DEFAULT_TOOL_CACHE_CONFIG: ToolCacheConfig = {\n  defaultTtlMs: 300_000, // 5 minutes\n  maxSize: 1000,\n};\n\ninterface CacheEntry<T> {\n  value: T;\n  expiresAt: number;\n  lastAccessed: number;\n}\n\nexport class ToolCache<T = any> {\n  private cache = new Map<string, CacheEntry<T>>();\n  private lastCleanup = 0;\n  private readonly cleanupIntervalMs: number;\n\n  constructor(private readonly config: ToolCacheConfig = DEFAULT_TOOL_CACHE_CONFIG) {\n    this.cleanupIntervalMs = config.cleanupIntervalMs ?? 60_000;\n  }\n\n  /**\n   * Check if a non-expired entry exists for the key\n   */\n  has(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n    if (Date.now() > entry.expiresAt) {\n      this.cache.delete(key);\n      return false;\n    }\n    return true;\n  }\n\n  /**\n   * Get a cached value\n   */\n  get(key: string): T | undefined {\n    const entry = this.cache.get(key);\n    \n    if (!entry) {\n      this.missCount++;\n      return undefined;\n    }\n\n    const now = Date.now();\n    \n    // Check if expired\n    if (now > entry.expiresAt) {\n      this.cache.delete(key);\n      this.missCount++;\n      return undefined;\n    }\n\n    // Move to end for LRU ordering\n    this.cache.delete(key);\n    this.cache.set(key, entry);\n\n    entry.lastAccessed = now;\n    this.hitCount++;\n    \n    return entry.value;\n  }\n\n  /**\n   * Set a cached value\n   */\n  set(key: string, value: T, ttlMs?: number): void {\n    const now = Date.now();\n    const ttl = ttlMs ?? this.config.defaultTtlMs;\n    \n    // Handle zero or negative TTL - don't cache\n    if (ttl <= 0) {\n      return;\n    }\n    \n    const entry: CacheEntry<T> = {\n      value,\n      expiresAt: now + ttl,\n      lastAccessed: now,\n    };\n\n    // If cache is at capacity, remove LRU item\n    if (this.cache.size >= this.config.maxSize && !this.cache.has(key)) {\n      // Don't add if max size is 0\n      if (this.config.maxSize === 0) {\n        return;\n      }\n      this.evictLRU();\n    }\n\n    // Delete before set to move existing key to end of insertion order (LRU)\n    this.cache.delete(key);\n    this.cache.set(key, entry);\n  }\n\n  /**\n   * Invalidate a specific cache entry\n   */\n  invalidate(key: string): boolean {\n    return this.cache.delete(key);\n  }\n\n  /**\n   * Clear all cache entries\n   */\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Get current cache size\n   */\n  get size(): number {\n    this.cleanupExpired();\n    return this.cache.size;\n  }\n\n  /**\n   * Get cache hit/miss statistics\n   */\n  getStats(): { hits: number; misses: number; size: number } {\n    this.cleanupExpired();\n    return {\n      hits: this.hitCount,\n      misses: this.missCount,\n      size: this.cache.size,\n    };\n  }\n\n  /**\n   * Reset statistics\n   */\n  resetStats(): void {\n    this.hitCount = 0;\n    this.missCount = 0;\n  }\n\n  private hitCount = 0;\n  private missCount = 0;\n\n  private evictLRU(): void {\n    const firstKey = this.cache.keys().next().value;\n    if (firstKey !== undefined) {\n      this.cache.delete(firstKey);\n    }\n  }\n\n  private cleanupExpired(): void {\n    const now = Date.now();\n    if (now - this.lastCleanup < this.cleanupIntervalMs) return;\n    this.lastCleanup = now;\n\n    const expired: string[] = [];\n\n    for (const [key, entry] of this.cache.entries()) {\n      if (now > entry.expiresAt) {\n        expired.push(key);\n      }\n    }\n\n    expired.forEach(key => this.cache.delete(key));\n  }\n}"],"mappings":"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","names":[]}