@cicctencent/agent-server 0.1.1 → 0.2.0

package/dist/cjs/service/cache.service.js

@@ -0,0 +1,243 @@
+"use strict";
+// ============================================================
+// CacheService — TTL 缓存包装器（多进程/多实例场景）
+// ============================================================
+//
+// 问题：上层 Web 项目多进程部署时，每次 getSettings() / getProfile() 都查 DB 会产生大量重复查询。
+// 解决：在 Provider 之上加一层 TTL 缓存，减少 DB 压力；同时支持主动失效。
+//
+// 缓存策略：
+// - TTL 到期自动过期，下次请求重新从底层 Provider 加载
+// - 主动失效通过 invalidate() 清除指定 key 或全部
+// - 跨进程失效通过 CacheInvalidationNotifier 实现（如 Redis pub/sub）
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CachedAgentProfileProvider = exports.CachedSettingsProvider = exports.TTLCache = void 0;
+/**
+ * 通用 TTL 缓存。
+ *
+ * - `ttl > 0`：启用缓存，过期后自动失效
+ * - `ttl === 0`：禁用缓存，get() 永远返回 null（每次直接查 Provider）
+ */
+class TTLCache {
+    cache = new Map();
+    ttl;
+    constructor(ttlMs = 60_000) {
+        this.ttl = ttlMs;
+    }
+    /** 是否启用缓存 */
+    get enabled() {
+        return this.ttl > 0;
+    }
+    /** 更新 TTL（不影响已缓存条目的过期时间） */
+    setTTL(ttlMs) {
+        this.ttl = ttlMs;
+    }
+    /** 获取缓存值（未命中或过期返回 null） */
+    get(key) {
+        if (!this.enabled)
+            return null;
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    /** 设置缓存值 */
+    set(key, value) {
+        if (!this.enabled)
+            return;
+        this.cache.set(key, { value, expiresAt: Date.now() + this.ttl });
+    }
+    /** 清除指定 key 的缓存 */
+    invalidate(key) {
+        if (key !== undefined) {
+            this.cache.delete(key);
+        }
+        else {
+            this.cache.clear();
+        }
+    }
+    /** 清除所有缓存 */
+    clear() {
+        this.cache.clear();
+    }
+    /** 清除已过期的条目 */
+    purgeExpired() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /** 缓存条目数量 */
+    get size() {
+        return this.cache.size;
+    }
+}
+exports.TTLCache = TTLCache;
+// ============================================================
+// CachedSettingsProvider — Settings 缓存包装器
+// ============================================================
+/**
+ * 包装 SettingsProvider，增加 TTL 缓存。
+ *
+ * 多进程部署时，每个进程独立缓存 Settings，TTL 到期后重新从底层 Provider 加载。
+ * 主动失效通过 `invalidate()` 清除缓存，上层可通过 `CacheInvalidationNotifier` 跨进程通知。
+ */
+class CachedSettingsProvider {
+    cache;
+    delegate;
+    constructor(delegate, ttlMs = 60_000) {
+        this.delegate = delegate;
+        this.cache = new TTLCache(ttlMs);
+    }
+    getSettings() {
+        const cached = this.cache.get('settings');
+        if (cached)
+            return cached;
+        const value = this.delegate.getSettings();
+        this.cache.set('settings', value);
+        return value;
+    }
+    updateSettings(updates) {
+        const value = this.delegate.updateSettings(updates);
+        // 更新后立即刷新缓存
+        this.cache.set('settings', value);
+        return value;
+    }
+    resetSettings() {
+        if (this.delegate.resetSettings) {
+            const value = this.delegate.resetSettings();
+            this.cache.set('settings', value);
+            return value;
+        }
+        this.cache.invalidate('settings');
+        return this.getSettings();
+    }
+    /** 清除缓存 */
+    invalidate() {
+        this.cache.invalidate('settings');
+    }
+}
+exports.CachedSettingsProvider = CachedSettingsProvider;
+// ============================================================
+// CachedAgentProfileProvider — Profile 缓存包装器
+// ============================================================
+/**
+ * 包装 AgentProfileProvider，增加 TTL 缓存。
+ *
+ * 多进程部署时，每个进程独立缓存 Profile，TTL 到期后重新从底层 Provider 加载。
+ * 主动失效通过 `invalidate(profileId?)` 清除指定或全部 Profile 缓存。
+ */
+class CachedAgentProfileProvider {
+    cache;
+    listCache;
+    defaultCache;
+    delegate;
+    constructor(delegate, ttlMs = 60_000) {
+        this.delegate = delegate;
+        this.cache = new TTLCache(ttlMs);
+        this.listCache = new TTLCache(ttlMs);
+        this.defaultCache = new TTLCache(ttlMs);
+    }
+    listProfiles() {
+        const cached = this.listCache.get('list');
+        if (cached)
+            return cached;
+        const result = this.delegate.listProfiles();
+        if (result instanceof Promise) {
+            return result.then(value => {
+                this.listCache.set('list', value);
+                // 同时缓存每个 profile
+                for (const p of value)
+                    this.cache.set(`profile:${p.id}`, p);
+                return value;
+            });
+        }
+        this.listCache.set('list', result);
+        for (const p of result)
+            this.cache.set(`profile:${p.id}`, p);
+        return result;
+    }
+    getProfile(id) {
+        const cacheKey = `profile:${id}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const result = this.delegate.getProfile(id);
+        if (result instanceof Promise) {
+            return result.then(value => {
+                if (value)
+                    this.cache.set(cacheKey, value);
+                return value;
+            });
+        }
+        if (result)
+            this.cache.set(cacheKey, result);
+        return result;
+    }
+    getDefaultProfile() {
+        const cached = this.defaultCache.get('default');
+        if (cached !== null)
+            return cached;
+        const result = this.delegate.getDefaultProfile();
+        if (result instanceof Promise) {
+            return result.then(value => {
+                this.defaultCache.set('default', value);
+                return value;
+            });
+        }
+        this.defaultCache.set('default', result);
+        return result;
+    }
+    createProfile(data) {
+        const result = this.delegate.createProfile(data);
+        // 创建后清除列表缓存和默认缓存
+        this.listCache.invalidate('list');
+        this.defaultCache.invalidate('default');
+        return result;
+    }
+    updateProfile(id, data) {
+        const result = this.delegate.updateProfile(id, data);
+        // 更新后清除该 profile 缓存 + 列表缓存
+        this.cache.invalidate(`profile:${id}`);
+        this.listCache.invalidate('list');
+        if (result instanceof Promise) {
+            return result.then(value => {
+                if (value)
+                    this.cache.set(`profile:${id}`, value);
+                return value;
+            });
+        }
+        if (result)
+            this.cache.set(`profile:${id}`, result);
+        return result;
+    }
+    deleteProfile(id) {
+        const result = this.delegate.deleteProfile(id);
+        this.cache.invalidate(`profile:${id}`);
+        this.listCache.invalidate('list');
+        this.defaultCache.invalidate('default');
+        return result;
+    }
+    /**
+     * 清除缓存。
+     * @param profileId 指定 profileId 时仅清除该 profile；不指定时清除全部
+     */
+    invalidate(profileId) {
+        if (profileId !== undefined) {
+            this.cache.invalidate(`profile:${profileId}`);
+        }
+        else {
+            this.cache.clear();
+            this.listCache.clear();
+            this.defaultCache.clear();
+        }
+    }
+}
+exports.CachedAgentProfileProvider = CachedAgentProfileProvider;
+//# sourceMappingURL=cache.service.js.map

package/dist/cjs/service/cache.service.js.map

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

package/dist/cjs/service/engine-pool.d.ts

@@ -1,6 +1,19 @@
 import { EnginePool } from '@cicctencent/agent-core';
 export { EnginePool } from '@cicctencent/agent-core';
-export declare function getEnginePool(): EnginePool;
-/** 重置全局池（测试用） */
+/** EnginePool 初始化配置 */
+export interface EnginePoolConfig {
+    /** TTL（ms），默认 5 分钟 */
+    ttl?: number;
+    /** 最大缓存数量，默认 10 */
+    maxSize?: number;
+}
+/**
+ * 获取全局 Engine 池单例。
+ *
+ * 首次调用时按 config 创建；后续调用忽略 config（已创建的池不会被覆盖）。
+ * 如需重新创建，请先调用 `resetEnginePool()`。
+ */
+export declare function getEnginePool(config?: EnginePoolConfig): EnginePool;
+/** 重置全局池（测试用 / 配置变更后重建） */
 export declare function resetEnginePool(): void;
 //# sourceMappingURL=engine-pool.d.ts.map

package/dist/cjs/service/engine-pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-pool.d.ts","sourceRoot":"","sources":["../../../src/service/engine-pool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD,wBAAgB,aAAa,IAAI,UAAU,CAK1C;AAED,iBAAiB;AACjB,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}
+{"version":3,"file":"engine-pool.d.ts","sourceRoot":"","sources":["../../../src/service/engine-pool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,uBAAuB;AACvB,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAOnE;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,IAAI,IAAI,CAKtC"}

package/dist/cjs/service/engine-pool.js

@@ -11,14 +11,25 @@ var agent_core_2 = require("@cicctencent/agent-core");
 Object.defineProperty(exports, "EnginePool", { enumerable: true, get: function () { return agent_core_2.EnginePool; } });
 /** 全局 Engine 池单例 */
 let globalPool = null;
-function getEnginePool() {
+/**
+ * 获取全局 Engine 池单例。
+ *
+ * 首次调用时按 config 创建；后续调用忽略 config（已创建的池不会被覆盖）。
+ * 如需重新创建，请先调用 `resetEnginePool()`。
+ */
+function getEnginePool(config) {
     if (!globalPool) {
-        globalPool = new agent_core_1.EnginePool();
+        const ttl = config?.ttl ?? 5 * 60_000;
+        const maxSize = config?.maxSize ?? 10;
+        globalPool = new agent_core_1.EnginePool(ttl, maxSize);
     }
     return globalPool;
 }
-/** 重置全局池（测试用） */
+/** 重置全局池（测试用 / 配置变更后重建） */
 function resetEnginePool() {
-    globalPool = null;
+    if (globalPool) {
+        globalPool.clear();
+        globalPool = null;
+    }
 }
 //# sourceMappingURL=engine-pool.js.map

package/dist/cjs/service/engine-pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-pool.js","sourceRoot":"","sources":["../../../src/service/engine-pool.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,gDAAgD;AAChD,+DAA+D;;;AAS/D,sCAKC;AAGD,0CAEC;AAjBD,wDAAqD;AAErD,sDAAqD;AAA5C,wGAAA,UAAU,OAAA;AAEnB,oBAAoB;AACpB,IAAI,UAAU,GAAsB,IAAI,CAAC;AAEzC,SAAgB,aAAa;IAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,IAAI,uBAAU,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,iBAAiB;AACjB,SAAgB,eAAe;IAC7B,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC"}
+{"version":3,"file":"engine-pool.js","sourceRoot":"","sources":["../../../src/service/engine-pool.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,gDAAgD;AAChD,+DAA+D;;;AAuB/D,sCAOC;AAGD,0CAKC;AApCD,wDAAqD;AAErD,sDAAqD;AAA5C,wGAAA,UAAU,OAAA;AAUnB,oBAAoB;AACpB,IAAI,UAAU,GAAsB,IAAI,CAAC;AAEzC;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,MAAyB;IACrD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;QACtC,UAAU,GAAG,IAAI,uBAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,2BAA2B;AAC3B,SAAgB,eAAe;IAC7B,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/cjs/spi/adapters.d.ts

@@ -0,0 +1,163 @@
+/**
+ * ## 设计原则
+ *
+ * agent-server 核心只定义**接口**（能力契约），不依赖具体框架。
+ *
+ * 以下适配器实现是**可选参考实现**，业务层可以：
+ * 1. 直接使用（如果满足需求）
+ * 2. 参考实现自己定制（如果有特殊需求）
+ * 3. 完全自己实现（如果框架不同）
+ *
+ * ### 使用示例
+ *
+ * ```typescript
+ * // 方式 1：直接使用提供的适配器
+ * import { KoaSSEAdapter } from '@cicctencent/agent-server';
+ * const adapter = new KoaSSEAdapter(ctx);
+ *
+ * // 方式 2：继承并扩展
+ * class MySSEAdapter extends KoaSSEAdapter {
+ *   write(data: string) {
+ *     // 添加自定义逻辑（如日志、监控）
+ *     console.log('[SSE]', data.length, 'bytes');
+ *     super.write(data);
+ *   }
+ * }
+ *
+ * // 方式 3：完全自己实现
+ * class CustomSSEAdapter implements SSEResponseAdapter {
+ *   // 完全自定义实现
+ * }
+ * ```
+ */
+import type { SSEResponseAdapter, RequestContextAdapter } from './types.js';
+/**
+ * Express SSE 适配器（参考实现）
+ *
+ * 业务层可以：
+ * - 直接使用
+ * - 继承扩展
+ * - 参考 implementation 自己实现
+ */
+export declare class ExpressSSEAdapter implements SSEResponseAdapter {
+    private res;
+    constructor(res: any);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    status(code: number): void;
+    json(data: unknown): void;
+}
+/**
+ * Koa/MidwayJS SSE 适配器（参考实现）
+ */
+export declare class KoaSSEAdapter implements SSEResponseAdapter {
+    private ctx;
+    constructor(ctx: any);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    status(code: number): void;
+    json(data: unknown): void;
+}
+/**
+ * Fastify SSE 适配器（参考实现）
+ */
+export declare class FastifySSEAdapter implements SSEResponseAdapter {
+    private reply;
+    constructor(reply: any);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    status(code: number): void;
+    json(data: unknown): void;
+}
+/**
+ * 原生 HTTP SSE 适配器
+ */
+export declare class NativeHttpSSEAdapter implements SSEResponseAdapter {
+    private res;
+    constructor(res: any);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    status(code: number): void;
+    json(data: unknown): void;
+}
+/**
+ * 自动检测框架类型并创建适配器
+ *
+ * ⚠️ 注意：此函数是便捷工具，但建议业务层显式创建适配器：
+ *
+ * ```typescript
+ * // 推荐：显式创建（更可控）
+ * const adapter = new KoaSSEAdapter(ctx);
+ *
+ * // 不推荐：自动检测（可能误判）
+ * const adapter = adaptSSE(ctx);
+ * ```
+ *
+ * 自动检测可能存在的问题：
+ * - 框架版本差异导致误判
+ * - 自定义响应对象无法识别
+ * - 难以调试
+ */
+export declare function adaptSSE(res: unknown): SSEResponseAdapter;
+/**
+ * Express 请求上下文适配器
+ */
+export declare class ExpressRequestAdapter implements RequestContextAdapter {
+    private req;
+    constructor(req: any);
+    getUserId(): string | number | undefined;
+    getWorkspaceId(): number | string | undefined;
+    getHeader(name: string): string | undefined;
+    hasPermission(permission: string): boolean;
+    getRawRequest(): unknown;
+    getRawResponse(): unknown;
+}
+/**
+ * Koa/MidwayJS 请求上下文适配器
+ */
+export declare class KoaRequestAdapter implements RequestContextAdapter {
+    private ctx;
+    constructor(ctx: any);
+    getUserId(): string | number | undefined;
+    getWorkspaceId(): number | string | undefined;
+    getHeader(name: string): string | undefined;
+    hasPermission(permission: string): boolean;
+    getRawRequest(): unknown;
+    getRawResponse(): unknown;
+}
+/**
+ * 自动检测框架类型并创建请求适配器
+ */
+export declare function adaptRequest(req: unknown): RequestContextAdapter;
+/**
+ * 自定义 SSE 适配器示例
+ * 应用层可参考此实现创建自己的适配器
+ */
+export declare class CustomSSEAdapter implements SSEResponseAdapter {
+    private onWrite;
+    private onEnd;
+    private onFlush?;
+    private _writableEnded;
+    private headers;
+    constructor(onWrite: (data: string) => void, onEnd: () => void, onFlush?: () => void);
+    write(data: string): void;
+    end(): void;
+    get writableEnded(): boolean;
+    setHeader(name: string, value: string | number): void;
+    flushHeaders(): void;
+    /** 获取已设置的响应头 */
+    getHeaders(): Record<string, string>;
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/cjs/spi/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/spi/adapters.ts"],"names":[],"mappings":"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"}