@cicctencent/agent-core 1.0.34 → 1.0.37

package/dist/esm/utils/ttl-lru-cache.d.ts

@@ -0,0 +1,49 @@
+export interface TtlCacheEntry<V> {
+    value: V;
+    createdAt: number;
+    lastUsed: number;
+    version?: string;
+}
+export interface TtlLruCacheOptions {
+    /** 条目最大存活毫秒数；超过则视为过期并在 reap 时淘汰 */
+    ttlMs: number;
+    /** 容量上限；超过时按 idle（最久未用优先）强制淘汰未过期项 */
+    maxSize?: number;
+    /**
+     * 淘汰回调：当条目因过期或容量超限被移除时调用，用于释放资源
+     * （如 AgentEngine.destroy）。可选。
+     */
+    onEvict?: (value: any) => void;
+}
+/**
+ * 通用缓存：支持 TTL 过期清理与容量超限时的 LRU 强制淘汰。
+ * 被 EnginePool 与 agent-server 的客户端池复用，避免重复实现。
+ */
+export declare class TtlLruCache<V = unknown> {
+    private readonly map;
+    private readonly ttlMs;
+    private readonly maxSize;
+    private readonly onEvict?;
+    constructor(options: TtlLruCacheOptions);
+    get(key: string): V | null;
+    getWithVersion(key: string): {
+        value: V;
+        version?: string;
+    } | null;
+    set(key: string, value: V, version?: string): void;
+    has(key: string): boolean;
+    delete(key: string): void;
+    clear(): void;
+    get size(): number;
+    /** 枚举所有缓存值（不含过期判定） */
+    values(): V[];
+    /** 判断是否过期（不触发淘汰，仅作判定） */
+    private isExpired;
+    private remove;
+    /**
+     * 清理过期项；若清理后 size 仍超过 maxSize，按 idle 降序（最久未用优先）
+     * 强制淘汰未过期项，直至 size <= maxSize。
+     */
+    reapStale(): void;
+}
+//# sourceMappingURL=ttl-lru-cache.d.ts.map

package/dist/esm/utils/ttl-lru-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl-lru-cache.d.ts","sourceRoot":"","sources":["../../../src/utils/ttl-lru-cache.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuC;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAqB;gBAElC,OAAO,EAAE,kBAAkB;IAMvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAW1B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAWlE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAWlD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sBAAsB;IACtB,MAAM,IAAI,CAAC,EAAE;IAIb,yBAAyB;IACzB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAOd;;;OAGG;IACH,SAAS,IAAI,IAAI;CAsBlB"}

package/dist/esm/utils/ttl-lru-cache.js

@@ -0,0 +1,104 @@
+// ============================================================
+// TtlLruCache — 通用 TTL + LRU 容量淘汰缓存
+// ============================================================
+/**
+ * 通用缓存：支持 TTL 过期清理与容量超限时的 LRU 强制淘汰。
+ * 被 EnginePool 与 agent-server 的客户端池复用，避免重复实现。
+ */
+export class TtlLruCache {
+    map = new Map();
+    ttlMs;
+    maxSize;
+    onEvict;
+    constructor(options) {
+        this.ttlMs = options.ttlMs;
+        this.maxSize = options.maxSize ?? Infinity;
+        this.onEvict = options.onEvict;
+    }
+    get(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return null;
+        if (this.isExpired(entry)) {
+            this.remove(key);
+            return null;
+        }
+        entry.lastUsed = Date.now();
+        return entry.value;
+    }
+    getWithVersion(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return null;
+        if (this.isExpired(entry)) {
+            this.remove(key);
+            return null;
+        }
+        entry.lastUsed = Date.now();
+        return { value: entry.value, version: entry.version };
+    }
+    set(key, value, version) {
+        const existing = this.map.get(key);
+        if (existing)
+            this.onEvict?.(existing.value);
+        this.map.set(key, {
+            value,
+            createdAt: Date.now(),
+            lastUsed: Date.now(),
+            version,
+        });
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    delete(key) {
+        this.remove(key);
+    }
+    clear() {
+        for (const [key] of this.map)
+            this.remove(key);
+    }
+    get size() {
+        return this.map.size;
+    }
+    /** 枚举所有缓存值（不含过期判定） */
+    values() {
+        return [...this.map.values()].map((entry) => entry.value);
+    }
+    /** 判断是否过期（不触发淘汰，仅作判定） */
+    isExpired(entry) {
+        return Date.now() - entry.createdAt > this.ttlMs;
+    }
+    remove(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return;
+        this.map.delete(key);
+        this.onEvict?.(entry.value);
+    }
+    /**
+     * 清理过期项；若清理后 size 仍超过 maxSize，按 idle 降序（最久未用优先）
+     * 强制淘汰未过期项，直至 size <= maxSize。
+     */
+    reapStale() {
+        const now = Date.now();
+        // 阶段 1：清理过期项
+        for (const [key, entry] of this.map) {
+            if (now - entry.createdAt > this.ttlMs) {
+                this.remove(key);
+            }
+        }
+        // 阶段 2：容量超限时强制 LRU 淘汰未过期项
+        if (this.map.size > this.maxSize) {
+            const candidates = [...this.map.entries()]
+                .map(([key, entry]) => ({ key, idle: now - entry.lastUsed }))
+                .sort((a, b) => b.idle - a.idle); // idle 大（最久未用）优先淘汰
+            for (const { key } of candidates) {
+                if (this.map.size <= this.maxSize)
+                    break;
+                this.remove(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=ttl-lru-cache.js.map

package/dist/esm/utils/ttl-lru-cache.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cicctencent/agent-core",
-  "version": "1.0.34",
+  "version": "1.0.37",
   "description": "Core engine for AI agent — LLM orchestration, tool execution, MCP, skill routing, security, and memory pipeline.",
   "type": "module",
   "main": "./dist/cjs/index.js",