@cicctencent/agent-core 0.1.6 → 0.1.7

package/README.md

@@ -2,11 +2,12 @@
 
 > **内部库，仅供项目内部使用，不对外发布。**
 
-AI Agent 核心引擎，提供 ReAct 循环编排、多 LLM 供应商抽象、工具注册与执行、MCP 协议集成、Skill 路由、安全守卫和渐进式记忆管道。
+AI Agent 核心引擎，提供 ReAct 循环编排、多 LLM 供应商抽象、工具注册与执行、MCP 协议集成、Skill 路由、安全守卫、渐进式记忆管道，以及工具风险评估、审批管理、运行注册表、引擎复用池、JSON 存储、可观测性日志等应用级能力。
 
 ## 文档
 
-完整 API 文档请查阅 [docs/API.md](./docs/API.md)。
+- [完整 API 文档](./docs/API.md) — 所有模块的接口说明和使用示例
+- [v0.2 升级指南](./docs/UPGRADE_v0.2.md) — 新增 12 个下沉模块的集成指南
 
 ## 快速开始
 
@@ -36,4 +37,4 @@ pnpm build       # 生成 .d.ts
 
 ## 运行时要求
 
-Node.js >= 18
+Node.js >= 22

package/dist/cjs/index.d.ts

@@ -34,8 +34,25 @@ export type { ProxyMode, ProxyCategoryConfig, ProxySettings, } from './mcp/proxy
 export type { MCPClient, MCPServerConfig, MCPTransport, } from './mcp/types.ts';
 export { SecurityGuard } from './security/guard.ts';
 export type { SanitizeResult, SecurityRule, SecurityPolicy, Severity, } from './security/types.ts';
+export { assessToolRisk, isLowRiskTool, clearRiskCache, setToolSecurityPolicyProvider, } from './security/risk.ts';
+export type { ToolRiskLevel, ToolRiskAssessment, ToolSecurityPolicy, ToolSecurityPolicyProvider, } from './security/risk.ts';
+export { createPermissionRequest, listPermissionRequests, findApprovedPermission, decidePermissionRequest, configurePermissionManager, InMemoryPermissionStore, } from './security/permission.ts';
+export type { PermissionDecision, PermissionRequest, PermissionStore, } from './security/permission.ts';
 export type { Sandbox, SandboxConfig, SandboxManager, ScriptLanguage, } from './sandbox/types.ts';
 export { SANDBOX_BLOCKED_COMMANDS, SANDBOX_SAFE_ENV_KEYS, DEFAULT_SANDBOX_CONFIG } from './sandbox/types.ts';
+export { logEvent, setLogTransport } from './observability/logger.ts';
+export type { LogLevel, ObservabilityEvent, LogTransport, } from './observability/logger.ts';
+export { EnginePool } from './pool/engine-pool.ts';
+export { RunRegistry, InMemoryRunStateStore } from './runtime/run-registry.ts';
+export type { BufferedEvent, RunToolCallRecord, EventSubscriber, RunStatus, ActiveRun, RunSnapshot, RunStateStore, } from './runtime/run-registry.ts';
+export { JsonStore, JsonListStore } from './store/json-store.ts';
+export type { JsonStoreOptions } from './store/json-store.ts';
+export { FileToolResultStore } from './store/file-tool-result-store.ts';
+export type { FileToolResultStoreOptions } from './store/file-tool-result-store.ts';
+export { TimingMiddleware } from './middleware/timing.ts';
+export type { TimingReport } from './middleware/timing.ts';
+export { ToolGuardMiddleware } from './middleware/tool-guard.ts';
+export { AuditLogMiddleware } from './middleware/audit-log.ts';
 export type { Hook, HookEvent, HookContext, HookResult, } from './hooks/types.ts';
 export type { Middleware, MiddlewareContext, } from './middleware/types.ts';
 export type { MemoryEntry, MemoryLayer, MemoryServiceLike, } from './memory/types.ts';
@@ -51,4 +68,7 @@ export { MemoryRecallEngine, formatRecallForPrompt } from './memory/recall.ts';
 export type { RecallResult, ScoredMemoryEntry, RecallOptions } from './memory/recall.ts';
 export { MemoryPipeline } from './memory/pipeline.ts';
 export type { PipelineOptions, PipelineResult } from './memory/pipeline.ts';
+export { getDataPath, getProjectDataPath, ensureDataDir, ensureProjectDataDir, expandEnvVars, setAppName, getAppName, } from './utils/data-dir.ts';
+export { collectEngineOutput } from './utils/event-collector.ts';
+export type { EngineRunResult } from './utils/event-collector.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

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

package/dist/cjs/index.js

@@ -3,8 +3,8 @@
 // Core 统一导出
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemoryCheckpoint = exports.PersonaGenerator = exports.SceneAggregator = exports.MemoryExtractor = exports.DEFAULT_SANDBOX_CONFIG = exports.SANDBOX_SAFE_ENV_KEYS = exports.SANDBOX_BLOCKED_COMMANDS = exports.SecurityGuard = exports.DEFAULT_PROXY_SETTINGS = exports.getWindowsSystemProxy = exports.clearSystemProxyCache = exports.getSystemProxyUrl = exports.resolveProxyUrlForCategory = exports.resolveProxyAgentForCategory = exports.HttpMCPClient = exports.StdioMCPClient = exports.MCPClientBase = exports.registerTransport = exports.createMCPClient = exports.sanitizeForToolName = exports.buildMCPToolName = exports.MCP_TOOL_PREFIX = exports.registerMCPTools = exports.createDelegateTool = exports.ToolRegistry = exports.SkillRouter = exports.SkillManager = exports.LocalEnvCollector = exports.ContextManager = exports.BUILTIN_PROVIDERS = exports.createLLMProvider = exports.OllamaProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.AgentToolExecutor = exports.LLMCaller = exports.HistoryManager = exports.wrapTaskWithWorkflowInstructions = exports.parseStructuredAgentOutput = exports.parseDebateOutput = exports.getWorkflowTemplate = exports.getWorkflowRoleStage = exports.formatWorkflowTemplateForPrompt = exports.formatStructuredAgentOutput = exports.formatDebateOutput = exports.buildWorkflowDecisionMemory = exports.buildStructuredOutputInstruction = exports.buildDebateInstructions = exports.DEFAULT_COMPLEX_WORKFLOW_TEMPLATE = exports.AgentEngine = void 0;
-exports.MemoryPipeline = exports.formatRecallForPrompt = exports.MemoryRecallEngine = exports.resetMemoryCheckpoint = exports.getMemoryCheckpoint = void 0;
+exports.findApprovedPermission = exports.listPermissionRequests = exports.createPermissionRequest = exports.setToolSecurityPolicyProvider = exports.clearRiskCache = exports.isLowRiskTool = exports.assessToolRisk = exports.SecurityGuard = exports.DEFAULT_PROXY_SETTINGS = exports.getWindowsSystemProxy = exports.clearSystemProxyCache = exports.getSystemProxyUrl = exports.resolveProxyUrlForCategory = exports.resolveProxyAgentForCategory = exports.HttpMCPClient = exports.StdioMCPClient = exports.MCPClientBase = exports.registerTransport = exports.createMCPClient = exports.sanitizeForToolName = exports.buildMCPToolName = exports.MCP_TOOL_PREFIX = exports.registerMCPTools = exports.createDelegateTool = exports.ToolRegistry = exports.SkillRouter = exports.SkillManager = exports.LocalEnvCollector = exports.ContextManager = exports.BUILTIN_PROVIDERS = exports.createLLMProvider = exports.OllamaProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.AgentToolExecutor = exports.LLMCaller = exports.HistoryManager = exports.wrapTaskWithWorkflowInstructions = exports.parseStructuredAgentOutput = exports.parseDebateOutput = exports.getWorkflowTemplate = exports.getWorkflowRoleStage = exports.formatWorkflowTemplateForPrompt = exports.formatStructuredAgentOutput = exports.formatDebateOutput = exports.buildWorkflowDecisionMemory = exports.buildStructuredOutputInstruction = exports.buildDebateInstructions = exports.DEFAULT_COMPLEX_WORKFLOW_TEMPLATE = exports.AgentEngine = void 0;
+exports.collectEngineOutput = exports.getAppName = exports.setAppName = exports.expandEnvVars = exports.ensureProjectDataDir = exports.ensureDataDir = exports.getProjectDataPath = exports.getDataPath = exports.MemoryPipeline = exports.formatRecallForPrompt = exports.MemoryRecallEngine = exports.resetMemoryCheckpoint = exports.getMemoryCheckpoint = exports.MemoryCheckpoint = exports.PersonaGenerator = exports.SceneAggregator = exports.MemoryExtractor = exports.AuditLogMiddleware = exports.ToolGuardMiddleware = exports.TimingMiddleware = exports.FileToolResultStore = exports.JsonListStore = exports.JsonStore = exports.InMemoryRunStateStore = exports.RunRegistry = exports.EnginePool = exports.setLogTransport = exports.logEvent = exports.DEFAULT_SANDBOX_CONFIG = exports.SANDBOX_SAFE_ENV_KEYS = exports.SANDBOX_BLOCKED_COMMANDS = exports.InMemoryPermissionStore = exports.configurePermissionManager = exports.decidePermissionRequest = void 0;
 // ---- Agent Engine ----
 var engine_ts_1 = require("./agent/engine.js");
 Object.defineProperty(exports, "AgentEngine", { enumerable: true, get: function () { return engine_ts_1.AgentEngine; } });
@@ -76,10 +76,46 @@ Object.defineProperty(exports, "DEFAULT_PROXY_SETTINGS", { enumerable: true, get
 // ---- Security ----
 var guard_ts_1 = require("./security/guard.js");
 Object.defineProperty(exports, "SecurityGuard", { enumerable: true, get: function () { return guard_ts_1.SecurityGuard; } });
+var risk_ts_1 = require("./security/risk.js");
+Object.defineProperty(exports, "assessToolRisk", { enumerable: true, get: function () { return risk_ts_1.assessToolRisk; } });
+Object.defineProperty(exports, "isLowRiskTool", { enumerable: true, get: function () { return risk_ts_1.isLowRiskTool; } });
+Object.defineProperty(exports, "clearRiskCache", { enumerable: true, get: function () { return risk_ts_1.clearRiskCache; } });
+Object.defineProperty(exports, "setToolSecurityPolicyProvider", { enumerable: true, get: function () { return risk_ts_1.setToolSecurityPolicyProvider; } });
+var permission_ts_1 = require("./security/permission.js");
+Object.defineProperty(exports, "createPermissionRequest", { enumerable: true, get: function () { return permission_ts_1.createPermissionRequest; } });
+Object.defineProperty(exports, "listPermissionRequests", { enumerable: true, get: function () { return permission_ts_1.listPermissionRequests; } });
+Object.defineProperty(exports, "findApprovedPermission", { enumerable: true, get: function () { return permission_ts_1.findApprovedPermission; } });
+Object.defineProperty(exports, "decidePermissionRequest", { enumerable: true, get: function () { return permission_ts_1.decidePermissionRequest; } });
+Object.defineProperty(exports, "configurePermissionManager", { enumerable: true, get: function () { return permission_ts_1.configurePermissionManager; } });
+Object.defineProperty(exports, "InMemoryPermissionStore", { enumerable: true, get: function () { return permission_ts_1.InMemoryPermissionStore; } });
 var types_ts_1 = require("./sandbox/types.js");
 Object.defineProperty(exports, "SANDBOX_BLOCKED_COMMANDS", { enumerable: true, get: function () { return types_ts_1.SANDBOX_BLOCKED_COMMANDS; } });
 Object.defineProperty(exports, "SANDBOX_SAFE_ENV_KEYS", { enumerable: true, get: function () { return types_ts_1.SANDBOX_SAFE_ENV_KEYS; } });
 Object.defineProperty(exports, "DEFAULT_SANDBOX_CONFIG", { enumerable: true, get: function () { return types_ts_1.DEFAULT_SANDBOX_CONFIG; } });
+// ---- Observability ----
+var logger_ts_1 = require("./observability/logger.js");
+Object.defineProperty(exports, "logEvent", { enumerable: true, get: function () { return logger_ts_1.logEvent; } });
+Object.defineProperty(exports, "setLogTransport", { enumerable: true, get: function () { return logger_ts_1.setLogTransport; } });
+// ---- Pool ----
+var engine_pool_ts_1 = require("./pool/engine-pool.js");
+Object.defineProperty(exports, "EnginePool", { enumerable: true, get: function () { return engine_pool_ts_1.EnginePool; } });
+// ---- Runtime ----
+var run_registry_ts_1 = require("./runtime/run-registry.js");
+Object.defineProperty(exports, "RunRegistry", { enumerable: true, get: function () { return run_registry_ts_1.RunRegistry; } });
+Object.defineProperty(exports, "InMemoryRunStateStore", { enumerable: true, get: function () { return run_registry_ts_1.InMemoryRunStateStore; } });
+// ---- Store ----
+var json_store_ts_1 = require("./store/json-store.js");
+Object.defineProperty(exports, "JsonStore", { enumerable: true, get: function () { return json_store_ts_1.JsonStore; } });
+Object.defineProperty(exports, "JsonListStore", { enumerable: true, get: function () { return json_store_ts_1.JsonListStore; } });
+var file_tool_result_store_ts_1 = require("./store/file-tool-result-store.js");
+Object.defineProperty(exports, "FileToolResultStore", { enumerable: true, get: function () { return file_tool_result_store_ts_1.FileToolResultStore; } });
+// ---- Middleware (builtin) ----
+var timing_ts_1 = require("./middleware/timing.js");
+Object.defineProperty(exports, "TimingMiddleware", { enumerable: true, get: function () { return timing_ts_1.TimingMiddleware; } });
+var tool_guard_ts_1 = require("./middleware/tool-guard.js");
+Object.defineProperty(exports, "ToolGuardMiddleware", { enumerable: true, get: function () { return tool_guard_ts_1.ToolGuardMiddleware; } });
+var audit_log_ts_1 = require("./middleware/audit-log.js");
+Object.defineProperty(exports, "AuditLogMiddleware", { enumerable: true, get: function () { return audit_log_ts_1.AuditLogMiddleware; } });
 var extractor_ts_1 = require("./memory/extractor.js");
 Object.defineProperty(exports, "MemoryExtractor", { enumerable: true, get: function () { return extractor_ts_1.MemoryExtractor; } });
 var scene_ts_1 = require("./memory/scene.js");
@@ -95,4 +131,15 @@ Object.defineProperty(exports, "MemoryRecallEngine", { enumerable: true, get: fu
 Object.defineProperty(exports, "formatRecallForPrompt", { enumerable: true, get: function () { return recall_ts_1.formatRecallForPrompt; } });
 var pipeline_ts_1 = require("./memory/pipeline.js");
 Object.defineProperty(exports, "MemoryPipeline", { enumerable: true, get: function () { return pipeline_ts_1.MemoryPipeline; } });
+// ---- Utils ----
+var data_dir_ts_1 = require("./utils/data-dir.js");
+Object.defineProperty(exports, "getDataPath", { enumerable: true, get: function () { return data_dir_ts_1.getDataPath; } });
+Object.defineProperty(exports, "getProjectDataPath", { enumerable: true, get: function () { return data_dir_ts_1.getProjectDataPath; } });
+Object.defineProperty(exports, "ensureDataDir", { enumerable: true, get: function () { return data_dir_ts_1.ensureDataDir; } });
+Object.defineProperty(exports, "ensureProjectDataDir", { enumerable: true, get: function () { return data_dir_ts_1.ensureProjectDataDir; } });
+Object.defineProperty(exports, "expandEnvVars", { enumerable: true, get: function () { return data_dir_ts_1.expandEnvVars; } });
+Object.defineProperty(exports, "setAppName", { enumerable: true, get: function () { return data_dir_ts_1.setAppName; } });
+Object.defineProperty(exports, "getAppName", { enumerable: true, get: function () { return data_dir_ts_1.getAppName; } });
+var event_collector_ts_1 = require("./utils/event-collector.js");
+Object.defineProperty(exports, "collectEngineOutput", { enumerable: true, get: function () { return event_collector_ts_1.collectEngineOutput; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;;;;AAwB/D,yBAAyB;AACzB,+CAAgD;AAAvC,wGAAA,WAAW,OAAA;AACpB,mDAa6B;AAZ3B,gIAAA,iCAAiC,OAAA;AACjC,sHAAA,uBAAuB,OAAA;AACvB,+HAAA,gCAAgC,OAAA;AAChC,0HAAA,2BAA2B,OAAA;AAC3B,iHAAA,kBAAkB,OAAA;AAClB,0HAAA,2BAA2B,OAAA;AAC3B,8HAAA,+BAA+B,OAAA;AAC/B,mHAAA,oBAAoB,OAAA;AACpB,kHAAA,mBAAmB,OAAA;AACnB,gHAAA,iBAAiB,OAAA;AACjB,yHAAA,0BAA0B,OAAA;AAC1B,+HAAA,gCAAgC,OAAA;AAGlC,iEAA4D;AAAnD,oHAAA,cAAc,OAAA;AACvB,uDAAkD;AAAzC,0GAAA,SAAS,OAAA;AAClB,6DAA6D;AAApD,qHAAA,iBAAiB,OAAA;AAY1B,+DAA0D;AAAjD,oHAAA,cAAc,OAAA;AACvB,qEAAgE;AAAvD,0HAAA,iBAAiB,OAAA;AAC1B,+DAA0D;AAAjD,oHAAA,cAAc,OAAA;AACvB,+CAAwE;AAA/D,+GAAA,iBAAiB,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAG7C,oBAAoB;AACpB,mDAAsD;AAA7C,4GAAA,cAAc,OAAA;AACvB,uDAA2D;AAAlD,iHAAA,iBAAiB,OAAA;AAO1B,kBAAkB;AAClB,iDAAkD;AAAzC,0GAAA,YAAY,OAAA;AACrB,+CAAgD;AAAvC,wGAAA,WAAW,OAAA;AAUpB,iBAAiB;AACjB,kDAAkD;AAAzC,2GAAA,YAAY,OAAA;AAErB,kDAAwD;AAA/C,iHAAA,kBAAkB,OAAA;AAgB3B,gBAAgB;AAChB,6CAA2G;AAAlG,6GAAA,gBAAgB,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AACjF,+CAAsE;AAA7D,6GAAA,eAAe,OAAA;AAAE,+GAAA,iBAAiB,OAAA;AAE3C,uDAAqD;AAA5C,+GAAA,aAAa,OAAA;AACtB,yDAAuD;AAA9C,iHAAA,cAAc,OAAA;AACvB,uDAAqD;AAA5C,+GAAA,aAAa,OAAA;AACtB,uDAO8B;AAN5B,8HAAA,4BAA4B,OAAA;AAC5B,4HAAA,0BAA0B,OAAA;AAC1B,mHAAA,iBAAiB,OAAA;AACjB,uHAAA,qBAAqB,OAAA;AACrB,uHAAA,qBAAqB,OAAA;AACrB,wHAAA,sBAAsB,OAAA;AAaxB,qBAAqB;AACrB,gDAAoD;AAA3C,yGAAA,aAAa,OAAA;AAetB,+CAA6G;AAApG,oHAAA,wBAAwB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AAsBhF,sDAAwD;AAA/C,+GAAA,eAAe,OAAA;AAExB,8CAAoD;AAA3C,2GAAA,eAAe,OAAA;AAExB,kDAAuD;AAA9C,8GAAA,gBAAgB,OAAA;AAEzB,wDAAsG;AAA7F,iHAAA,gBAAgB,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAAE,sHAAA,qBAAqB,OAAA;AAErE,gDAA+E;AAAtE,+GAAA,kBAAkB,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAElD,oDAAsD;AAA7C,6GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/middleware/audit-log.d.ts

@@ -0,0 +1,22 @@
+import type { Middleware, MiddlewareContext } from '../middleware/types.ts';
+import type { HookContext, HookResult } from '../hooks/types.ts';
+/**
+ * 记录每轮迭代和工具调用的审计日志
+ * - before/after: 记录迭代开始/结束 + 消息数量
+ * - onToolBefore/onToolAfter: 记录工具调用名称、参数、耗时
+ */
+export declare class AuditLogMiddleware implements Middleware {
+    name: string;
+    private logger;
+    /**
+     * @param logger 自定义日志输出函数，默认写入文件 data/logs/audit-YYYY-MM-DD.log
+     *               传入 'console' 字符串则输出到 console.log
+     *               也可传入自定义函数
+     */
+    constructor(logger?: ((msg: string) => void) | 'console' | string);
+    before(ctx: MiddlewareContext): Promise<void>;
+    after(ctx: MiddlewareContext): Promise<void>;
+    onToolBefore(ctx: HookContext): Promise<HookResult | void>;
+    onToolAfter(ctx: HookContext): Promise<HookResult | void>;
+}
+//# sourceMappingURL=audit-log.d.ts.map

package/dist/cjs/middleware/audit-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-log.d.ts","sourceRoot":"","sources":["../../../src/middleware/audit-log.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA2BjE;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,IAAI,SAAe;IAEnB,OAAO,CAAC,MAAM,CAAwB;IAEtC;;;;OAIG;gBACS,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,MAAM;IAY3D,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI1D,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAIhE"}

package/dist/cjs/middleware/audit-log.js

@@ -0,0 +1,104 @@
+"use strict";
+// ============================================================
+// AuditLogMiddleware — 审计日志中间件
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogMiddleware = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 文件审计日志器 — 以 JSONL 格式追加写入日志文件
+ * 默认路径：{logDir}/audit-YYYY-MM-DD.log
+ */
+function createFileAuditLogger(logDir) {
+    const dir = logDir || path.join(process.cwd(), 'data', 'logs');
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return (msg) => {
+        const now = new Date();
+        const dateStr = now.toISOString().slice(0, 10);
+        const logFile = path.join(dir, `audit-${dateStr}.log`);
+        const entry = JSON.stringify({
+            ts: now.toISOString(),
+            msg,
+        }) + '\n';
+        fs.appendFileSync(logFile, entry, 'utf-8');
+    };
+}
+/**
+ * 记录每轮迭代和工具调用的审计日志
+ * - before/after: 记录迭代开始/结束 + 消息数量
+ * - onToolBefore/onToolAfter: 记录工具调用名称、参数、耗时
+ */
+class AuditLogMiddleware {
+    name = 'audit-log';
+    logger;
+    /**
+     * @param logger 自定义日志输出函数，默认写入文件 data/logs/audit-YYYY-MM-DD.log
+     *               传入 'console' 字符串则输出到 console.log
+     *               也可传入自定义函数
+     */
+    constructor(logger) {
+        if (logger === 'console') {
+            this.logger = (msg) => console.log(`[Audit] ${msg}`);
+        }
+        else if (typeof logger === 'function') {
+            this.logger = logger;
+        }
+        else if (typeof logger === 'string') {
+            this.logger = createFileAuditLogger(logger);
+        }
+        else {
+            this.logger = createFileAuditLogger();
+        }
+    }
+    async before(ctx) {
+        this.logger(`Session=${ctx.sessionId} Iter=${ctx.iteration} START | messages=${ctx.messages.length} tools=${ctx.toolCount}`);
+    }
+    async after(ctx) {
+        this.logger(`Session=${ctx.sessionId} Iter=${ctx.iteration} END | messages=${ctx.messages.length}`);
+    }
+    async onToolBefore(ctx) {
+        this.logger(`Tool CALL: ${ctx.tool} | args=${JSON.stringify(ctx.args || {}).slice(0, 200)}`);
+    }
+    async onToolAfter(ctx) {
+        const output = ctx.result ? String(ctx.result).slice(0, 200) : '(empty)';
+        this.logger(`Tool DONE: ${ctx.tool} | output=${output}`);
+    }
+}
+exports.AuditLogMiddleware = AuditLogMiddleware;
+//# sourceMappingURL=audit-log.js.map

package/dist/cjs/middleware/audit-log.js.map

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

package/dist/cjs/middleware/timing.d.ts

@@ -0,0 +1,25 @@
+import type { Middleware, MiddlewareContext } from '../middleware/types.ts';
+import type { HookContext, HookResult } from '../hooks/types.ts';
+export interface TimingReport {
+    type: 'iteration' | 'tool';
+    sessionId?: string;
+    iteration?: number;
+    toolName?: string;
+    elapsedMs: number;
+}
+/**
+ * 统计每轮迭代和每次工具调用的耗时
+ * 可通过 onReport 回调获取汇总数据（如写入监控）
+ */
+export declare class TimingMiddleware implements Middleware {
+    name: string;
+    private iterStarts;
+    private toolTimings;
+    private onReport?;
+    constructor(onReport?: (report: TimingReport) => void);
+    before(ctx: MiddlewareContext): Promise<void>;
+    after(ctx: MiddlewareContext): Promise<void>;
+    onToolBefore(ctx: HookContext): Promise<HookResult | void>;
+    onToolAfter(ctx: HookContext): Promise<HookResult | void>;
+}
+//# sourceMappingURL=timing.d.ts.map

package/dist/cjs/middleware/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/middleware/timing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,IAAI,SAAY;IAEhB,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,QAAQ,CAAC,CAAiC;gBAEtC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI;IAI/C,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5C,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAM1D,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAgBhE"}

package/dist/cjs/middleware/timing.js

@@ -0,0 +1,62 @@
+"use strict";
+// ============================================================
+// TimingMiddleware — 执行耗时统计中间件
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimingMiddleware = void 0;
+/**
+ * 统计每轮迭代和每次工具调用的耗时
+ * 可通过 onReport 回调获取汇总数据（如写入监控）
+ */
+class TimingMiddleware {
+    name = 'timing';
+    iterStarts = new Map();
+    toolTimings = new Map();
+    onReport;
+    constructor(onReport) {
+        this.onReport = onReport;
+    }
+    async before(ctx) {
+        this.iterStarts.set(ctx.sessionId, Date.now());
+    }
+    async after(ctx) {
+        const start = this.iterStarts.get(ctx.sessionId);
+        const elapsed = start ? Date.now() - start : -1;
+        this.iterStarts.delete(ctx.sessionId);
+        if (this.onReport) {
+            this.onReport({
+                type: 'iteration',
+                sessionId: ctx.sessionId,
+                iteration: ctx.iteration,
+                elapsedMs: elapsed,
+            });
+        }
+        else {
+            console.log(`[Timing] Session=${ctx.sessionId} Iter=${ctx.iteration} elapsed=${elapsed}ms`);
+        }
+    }
+    async onToolBefore(ctx) {
+        const key = `${ctx.tool}_${Date.now()}`;
+        this.toolTimings.set(key, { name: ctx.tool || 'unknown', start: Date.now() });
+        ctx._timingKey = key;
+    }
+    async onToolAfter(ctx) {
+        const key = ctx._timingKey;
+        const timing = key ? this.toolTimings.get(key) : undefined;
+        const elapsed = timing ? Date.now() - timing.start : -1;
+        if (key)
+            this.toolTimings.delete(key);
+        if (this.onReport) {
+            this.onReport({
+                type: 'tool',
+                toolName: ctx.tool,
+                elapsedMs: elapsed,
+            });
+        }
+        else {
+            console.log(`[Timing] Tool=${ctx.tool} elapsed=${elapsed}ms`);
+        }
+    }
+}
+exports.TimingMiddleware = TimingMiddleware;
+//# sourceMappingURL=timing.js.map

package/dist/cjs/middleware/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../../src/middleware/timing.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,+BAA+B;AAC/B,+DAA+D;;;AAkB/D;;;GAGG;AACH,MAAa,gBAAgB;IAC3B,IAAI,GAAG,QAAQ,CAAC;IAER,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,QAAQ,CAAkC;IAElD,YAAY,QAAyC;QACnD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAsB;QACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAsB;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEtC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC;gBACZ,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,SAAS,SAAS,GAAG,CAAC,SAAS,YAAY,OAAO,IAAI,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAgB;QACjC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7E,GAAW,CAAC,UAAU,GAAG,GAAG,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAgB;QAChC,MAAM,GAAG,GAAI,GAAW,CAAC,UAAoB,CAAC;QAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,GAAG;YAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC;gBACZ,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,GAAG,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,IAAI,YAAY,OAAO,IAAI,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;CACF;AAtDD,4CAsDC"}

package/dist/cjs/middleware/tool-guard.d.ts

@@ -0,0 +1,15 @@
+import type { Middleware } from '../middleware/types.ts';
+import type { HookContext, HookResult } from '../hooks/types.ts';
+/**
+ * 工具调用守卫：对指定工具进行拦截
+ * - 可配置需要拦截的工具名列表
+ * - 匹配时 onToolBefore 返回 block，阻止工具执行
+ */
+export declare class ToolGuardMiddleware implements Middleware {
+    name: string;
+    private blockedTools;
+    private logger;
+    constructor(blockedTools: string[], logger?: (msg: string) => void);
+    onToolBefore(ctx: HookContext): Promise<HookResult | void>;
+}
+//# sourceMappingURL=tool-guard.d.ts.map

package/dist/cjs/middleware/tool-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-guard.d.ts","sourceRoot":"","sources":["../../../src/middleware/tool-guard.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IACpD,IAAI,SAAgB;IAEpB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,MAAM,CAAwB;gBAE1B,YAAY,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAK5D,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CASjE"}

package/dist/cjs/middleware/tool-guard.js

@@ -0,0 +1,31 @@
+"use strict";
+// ============================================================
+// ToolGuardMiddleware — 工具安全守卫中间件
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolGuardMiddleware = void 0;
+/**
+ * 工具调用守卫：对指定工具进行拦截
+ * - 可配置需要拦截的工具名列表
+ * - 匹配时 onToolBefore 返回 block，阻止工具执行
+ */
+class ToolGuardMiddleware {
+    name = 'tool-guard';
+    blockedTools;
+    logger;
+    constructor(blockedTools, logger) {
+        this.blockedTools = new Set(blockedTools);
+        this.logger = logger || ((msg) => console.warn(`[ToolGuard] ${msg}`));
+    }
+    async onToolBefore(ctx) {
+        if (ctx.tool && this.blockedTools.has(ctx.tool)) {
+            this.logger(`BLOCKED tool call: ${ctx.tool}`);
+            return {
+                block: true,
+                reason: `Tool "${ctx.tool}" is blocked by ToolGuard middleware`,
+            };
+        }
+    }
+}
+exports.ToolGuardMiddleware = ToolGuardMiddleware;
+//# sourceMappingURL=tool-guard.js.map

package/dist/cjs/middleware/tool-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-guard.js","sourceRoot":"","sources":["../../../src/middleware/tool-guard.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,kCAAkC;AAClC,+DAA+D;;;AAK/D;;;;GAIG;AACH,MAAa,mBAAmB;IAC9B,IAAI,GAAG,YAAY,CAAC;IAEZ,YAAY,CAAc;IAC1B,MAAM,CAAwB;IAEtC,YAAY,YAAsB,EAAE,MAA8B;QAChE,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAgB;QACjC,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,sBAAsB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,SAAS,GAAG,CAAC,IAAI,sCAAsC;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AApBD,kDAoBC"}

package/dist/cjs/observability/logger.d.ts

@@ -0,0 +1,16 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface ObservabilityEvent {
+    ts?: number;
+    level?: LogLevel;
+    event: string;
+    traceId?: string;
+    sessionId?: string;
+    data?: Record<string, unknown>;
+}
+/** 日志传输层接口 */
+export type LogTransport = (payload: Required<Pick<ObservabilityEvent, 'ts' | 'level'>> & ObservabilityEvent) => void;
+/** 设置自定义日志传输层 */
+export declare function setLogTransport(transport: LogTransport): void;
+/** 记录可观测性事件 */
+export declare function logEvent(input: ObservabilityEvent): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/cjs/observability/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/observability/logger.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,cAAc;AACd,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,kBAAkB,KAAK,IAAI,CAAC;AAYtH,iBAAiB;AACjB,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAE7D;AAED,eAAe;AACf,wBAAgB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAUxD"}

package/dist/cjs/observability/logger.js

@@ -0,0 +1,35 @@
+"use strict";
+// ============================================================
+// Observability — 结构化可观测性日志
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLogTransport = setLogTransport;
+exports.logEvent = logEvent;
+/** 默认传输：console 输出 */
+const defaultTransport = (payload) => {
+    const line = `[obs] ${JSON.stringify(payload)}`;
+    if (payload.level === 'error')
+        console.error(line);
+    else if (payload.level === 'warn')
+        console.warn(line);
+    else
+        console.log(line);
+};
+let _transport = defaultTransport;
+/** 设置自定义日志传输层 */
+function setLogTransport(transport) {
+    _transport = transport;
+}
+/** 记录可观测性事件 */
+function logEvent(input) {
+    const payload = {
+        ts: input.ts || Date.now(),
+        level: input.level || 'info',
+        event: input.event,
+        traceId: input.traceId,
+        sessionId: input.sessionId,
+        data: input.data || {},
+    };
+    _transport(payload);
+}
+//# sourceMappingURL=logger.js.map

package/dist/cjs/observability/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/observability/logger.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,4BAA4B;AAC5B,+DAA+D;;AA2B/D,0CAEC;AAGD,4BAUC;AA1BD,sBAAsB;AACtB,MAAM,gBAAgB,GAAiB,CAAC,OAAO,EAAE,EAAE;IACjD,MAAM,IAAI,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC9C,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;QACjD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,IAAI,UAAU,GAAiB,gBAAgB,CAAC;AAEhD,iBAAiB;AACjB,SAAgB,eAAe,CAAC,SAAuB;IACrD,UAAU,GAAG,SAAS,CAAC;AACzB,CAAC;AAED,eAAe;AACf,SAAgB,QAAQ,CAAC,KAAyB;IAChD,MAAM,OAAO,GAAG;QACd,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;KACvB,CAAC;IACF,UAAU,CAAC,OAAO,CAAC,CAAC;AACtB,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { AgentEngine } from '../agent/engine.ts';
+/** AgentEngine 实例复用池 */
+export declare class EnginePool {
+    private pool;
+    private readonly ttl;
+    private readonly maxSize;
+    constructor(ttlMs?: number, maxSize?: number);
+    /** 生成缓存 key */
+    static key(profileId?: number | string, scopeKey?: string): string;
+    /** 从池中获取 Engine（未命中或过期返回 null） */
+    get(profileId?: number | string, scopeKey?: string): AgentEngine | null;
+    /** 将 Engine 放入池中 */
+    set(profileId: number | string | undefined, engine: AgentEngine, scopeKey?: string): void;
+    /** 清除所有缓存（配置变更时调用） */
+    clear(): void;
+    /** 仅清除过期的实例 */
+    purgeExpired(): void;
+    /** 池大小 */
+    get size(): number;
+    private evictOldest;
+}
+//# sourceMappingURL=engine-pool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine-pool.d.ts","sourceRoot":"","sources":["../../../src/pool/engine-pool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQtD,wBAAwB;AACxB,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,KAAK,GAAE,MAAmB,EAAE,OAAO,GAAE,MAAW;IAK5D,eAAe;IACf,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlE,kCAAkC;IAClC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAcvE,oBAAoB;IACpB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAazF,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAOb,eAAe;IACf,YAAY,IAAI,IAAI;IAUpB,UAAU;IACV,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,WAAW;CAQpB"}