@cicctencent/agent-core 0.1.18 → 0.1.20

package/dist/cjs/index.js

@@ -3,9 +3,12 @@
 // Core 统一导出
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-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.createToolDocTool = exports.createSkillLoaderTool = exports.createShellTools = exports.createFileSystemTools = exports.createBuiltinTools = exports.createDelegateTool = exports.ToolRegistry = exports.SkillRouter = exports.SkillManager = exports.LocalEnvCollector = exports.ContextManager = exports.BUILTIN_PROVIDERS = exports.createLLMProvider = exports.OllamaProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.createAgentConfig = exports.validateSkillRequirements = exports.createAgentRuntime = exports.buildResourceScope = exports.AgentRuntimeBuilder = 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.mapAgentEventStream = exports.mapAgentEvent = exports.defaultResolveToolDisplayName = exports.createAgentEventCollectorState = 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.InMemoryMemoryStore = exports.AuditLogMiddleware = exports.ToolGuardMiddleware = exports.TimingMiddleware = exports.FileToolResultStore = exports.JsonListStore = exports.JsonStore = exports.RunController = 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 = exports.findApprovedPermission = exports.listPermissionRequests = exports.createPermissionRequest = exports.setToolSecurityPolicyProvider = exports.clearRiskCache = exports.isLowRiskTool = exports.assessToolRisk = exports.SecurityGuard = exports.DEFAULT_PROXY_SETTINGS = exports.getWindowsSystemProxy = void 0;
-exports.mapAgentEventToA2AEvent = exports.extractTextFromMessage = exports.createA2ARemoteRunner = exports.createA2AMessage = exports.createA2AAgentCard = exports.buildAuthHeaders = exports.InMemoryA2ATaskStore = exports.A2AServerHandler = exports.A2AClient = void 0;
+exports.createToolDocTool = exports.createSkillLoaderTool = exports.createShellTools = exports.createFileSystemTools = exports.createBuiltinTools = exports.createDelegateTool = exports.ToolRegistry = exports.InMemoryVectorIndex = exports.SkillRouter = exports.SkillManager = exports.LocalEnvCollector = exports.ContextManager = exports.InMemoryUsageTracker = exports.calculateCost = exports.registerPricing = exports.getPricing = exports.BUILTIN_PROVIDERS = exports.createLLMProvider = exports.OllamaProvider = exports.AnthropicProvider = exports.OpenAIProvider = exports.createBatchRequest = exports.serializeBatchRequests = exports.isFileProvider = exports.isBatchProvider = exports.loadAgentProfilesFromDir = exports.parseAgentProfile = exports.createAgentConfig = exports.validateSkillRequirements = exports.createAgentRuntime = exports.buildResourceScope = exports.AgentRuntimeBuilder = 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 = exports.isMultimodalContent = exports.extractTextFromContent = void 0;
+exports.SceneAggregator = exports.MemoryExtractor = exports.InMemoryMemoryStore = exports.createRAGMiddleware = exports.InMemoryKnowledgeBase = exports.WorkspaceNotesMiddleware = exports.AuditLogMiddleware = exports.ToolGuardMiddleware = exports.TimingMiddleware = exports.JsonlHistoryPersistence = exports.FileToolResultStore = exports.JsonListStore = exports.JsonStore = exports.RunController = exports.InMemoryRunStateStore = exports.RunRegistry = exports.EnginePool = exports.InMemoryTracer = exports.setLogTransport = exports.logEvent = exports.createCodeExecutionTool = exports.DEFAULT_SANDBOX_CONFIG = exports.SANDBOX_SAFE_ENV_KEYS = exports.SANDBOX_BLOCKED_COMMANDS = exports.InMemoryPermissionStore = exports.configurePermissionManager = exports.decidePermissionRequest = 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 = void 0;
+exports.mapAgentEventToA2AEvent = exports.extractTextFromMessage = exports.createA2ARemoteRunner = exports.createA2AMessage = exports.createA2AAgentCard = exports.buildAuthHeaders = exports.InMemoryA2ATaskStore = exports.A2AServerHandler = exports.A2AClient = exports.mapAgentEventStream = exports.mapAgentEvent = exports.defaultResolveToolDisplayName = exports.createAgentEventCollectorState = 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 = void 0;
+var types_ts_1 = require("./types.js");
+Object.defineProperty(exports, "extractTextFromContent", { enumerable: true, get: function () { return types_ts_1.extractTextFromContent; } });
+Object.defineProperty(exports, "isMultimodalContent", { enumerable: true, get: function () { return types_ts_1.isMultimodalContent; } });
 // ---- Agent Engine ----
 var engine_ts_1 = require("./agent/engine.js");
 Object.defineProperty(exports, "AgentEngine", { enumerable: true, get: function () { return engine_ts_1.AgentEngine; } });
@@ -33,8 +36,16 @@ Object.defineProperty(exports, "AgentRuntimeBuilder", { enumerable: true, get: f
 Object.defineProperty(exports, "buildResourceScope", { enumerable: true, get: function () { return runtime_builder_ts_1.buildResourceScope; } });
 Object.defineProperty(exports, "createAgentRuntime", { enumerable: true, get: function () { return runtime_builder_ts_1.createAgentRuntime; } });
 Object.defineProperty(exports, "validateSkillRequirements", { enumerable: true, get: function () { return runtime_builder_ts_1.validateSkillRequirements; } });
-var types_ts_1 = require("./agent/types.js");
-Object.defineProperty(exports, "createAgentConfig", { enumerable: true, get: function () { return types_ts_1.createAgentConfig; } });
+var types_ts_2 = require("./agent/types.js");
+Object.defineProperty(exports, "createAgentConfig", { enumerable: true, get: function () { return types_ts_2.createAgentConfig; } });
+var profile_loader_ts_1 = require("./agent/profile-loader.js");
+Object.defineProperty(exports, "parseAgentProfile", { enumerable: true, get: function () { return profile_loader_ts_1.parseAgentProfile; } });
+Object.defineProperty(exports, "loadAgentProfilesFromDir", { enumerable: true, get: function () { return profile_loader_ts_1.loadAgentProfilesFromDir; } });
+var types_ts_3 = require("./llm/types.js");
+Object.defineProperty(exports, "isBatchProvider", { enumerable: true, get: function () { return types_ts_3.isBatchProvider; } });
+Object.defineProperty(exports, "isFileProvider", { enumerable: true, get: function () { return types_ts_3.isFileProvider; } });
+Object.defineProperty(exports, "serializeBatchRequests", { enumerable: true, get: function () { return types_ts_3.serializeBatchRequests; } });
+Object.defineProperty(exports, "createBatchRequest", { enumerable: true, get: function () { return types_ts_3.createBatchRequest; } });
 var openai_provider_ts_1 = require("./llm/openai-provider.js");
 Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return openai_provider_ts_1.OpenAIProvider; } });
 var anthropic_provider_ts_1 = require("./llm/anthropic-provider.js");
@@ -44,6 +55,12 @@ Object.defineProperty(exports, "OllamaProvider", { enumerable: true, get: functi
 var factory_ts_1 = require("./llm/factory.js");
 Object.defineProperty(exports, "createLLMProvider", { enumerable: true, get: function () { return factory_ts_1.createLLMProvider; } });
 Object.defineProperty(exports, "BUILTIN_PROVIDERS", { enumerable: true, get: function () { return factory_ts_1.BUILTIN_PROVIDERS; } });
+var pricing_ts_1 = require("./llm/pricing.js");
+Object.defineProperty(exports, "getPricing", { enumerable: true, get: function () { return pricing_ts_1.getPricing; } });
+Object.defineProperty(exports, "registerPricing", { enumerable: true, get: function () { return pricing_ts_1.registerPricing; } });
+Object.defineProperty(exports, "calculateCost", { enumerable: true, get: function () { return pricing_ts_1.calculateCost; } });
+var usage_tracker_ts_1 = require("./llm/usage-tracker.js");
+Object.defineProperty(exports, "InMemoryUsageTracker", { enumerable: true, get: function () { return usage_tracker_ts_1.InMemoryUsageTracker; } });
 // ---- Context ----
 var manager_ts_1 = require("./context/manager.js");
 Object.defineProperty(exports, "ContextManager", { enumerable: true, get: function () { return manager_ts_1.ContextManager; } });
@@ -54,6 +71,8 @@ var manager_ts_2 = require("./skill/manager.js");
 Object.defineProperty(exports, "SkillManager", { enumerable: true, get: function () { return manager_ts_2.SkillManager; } });
 var router_ts_1 = require("./skill/router.js");
 Object.defineProperty(exports, "SkillRouter", { enumerable: true, get: function () { return router_ts_1.SkillRouter; } });
+var vector_index_ts_1 = require("./skill/vector-index.js");
+Object.defineProperty(exports, "InMemoryVectorIndex", { enumerable: true, get: function () { return vector_index_ts_1.InMemoryVectorIndex; } });
 // ---- Tool ----
 var registry_ts_1 = require("./tool/registry.js");
 Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_ts_1.ToolRegistry; } });
@@ -102,14 +121,18 @@ Object.defineProperty(exports, "findApprovedPermission", { enumerable: true, get
 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_2 = require("./sandbox/types.js");
-Object.defineProperty(exports, "SANDBOX_BLOCKED_COMMANDS", { enumerable: true, get: function () { return types_ts_2.SANDBOX_BLOCKED_COMMANDS; } });
-Object.defineProperty(exports, "SANDBOX_SAFE_ENV_KEYS", { enumerable: true, get: function () { return types_ts_2.SANDBOX_SAFE_ENV_KEYS; } });
-Object.defineProperty(exports, "DEFAULT_SANDBOX_CONFIG", { enumerable: true, get: function () { return types_ts_2.DEFAULT_SANDBOX_CONFIG; } });
+var types_ts_4 = require("./sandbox/types.js");
+Object.defineProperty(exports, "SANDBOX_BLOCKED_COMMANDS", { enumerable: true, get: function () { return types_ts_4.SANDBOX_BLOCKED_COMMANDS; } });
+Object.defineProperty(exports, "SANDBOX_SAFE_ENV_KEYS", { enumerable: true, get: function () { return types_ts_4.SANDBOX_SAFE_ENV_KEYS; } });
+Object.defineProperty(exports, "DEFAULT_SANDBOX_CONFIG", { enumerable: true, get: function () { return types_ts_4.DEFAULT_SANDBOX_CONFIG; } });
+var code_sandbox_ts_1 = require("./sandbox/code-sandbox.js");
+Object.defineProperty(exports, "createCodeExecutionTool", { enumerable: true, get: function () { return code_sandbox_ts_1.createCodeExecutionTool; } });
 // ---- 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; } });
+var trace_ts_1 = require("./observability/trace.js");
+Object.defineProperty(exports, "InMemoryTracer", { enumerable: true, get: function () { return trace_ts_1.InMemoryTracer; } });
 // ---- 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; } });
@@ -125,6 +148,8 @@ Object.defineProperty(exports, "JsonStore", { enumerable: true, get: function ()
 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; } });
+var history_persistence_ts_1 = require("./store/history-persistence.js");
+Object.defineProperty(exports, "JsonlHistoryPersistence", { enumerable: true, get: function () { return history_persistence_ts_1.JsonlHistoryPersistence; } });
 // ---- Middleware (builtin) ----
 var timing_ts_1 = require("./middleware/timing.js");
 Object.defineProperty(exports, "TimingMiddleware", { enumerable: true, get: function () { return timing_ts_1.TimingMiddleware; } });
@@ -132,8 +157,14 @@ 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 types_ts_3 = require("./memory/types.js");
-Object.defineProperty(exports, "InMemoryMemoryStore", { enumerable: true, get: function () { return types_ts_3.InMemoryMemoryStore; } });
+var workspace_notes_ts_1 = require("./middleware/workspace-notes.js");
+Object.defineProperty(exports, "WorkspaceNotesMiddleware", { enumerable: true, get: function () { return workspace_notes_ts_1.WorkspaceNotesMiddleware; } });
+var in_memory_kb_ts_1 = require("./kb/in-memory-kb.js");
+Object.defineProperty(exports, "InMemoryKnowledgeBase", { enumerable: true, get: function () { return in_memory_kb_ts_1.InMemoryKnowledgeBase; } });
+var rag_middleware_ts_1 = require("./kb/rag-middleware.js");
+Object.defineProperty(exports, "createRAGMiddleware", { enumerable: true, get: function () { return rag_middleware_ts_1.createRAGMiddleware; } });
+var types_ts_5 = require("./memory/types.js");
+Object.defineProperty(exports, "InMemoryMemoryStore", { enumerable: true, get: function () { return types_ts_5.InMemoryMemoryStore; } });
 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");

package/dist/cjs/index.js.map

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

package/dist/cjs/kb/in-memory-kb.d.ts

@@ -0,0 +1,29 @@
+import type { KnowledgeBase, EmbeddingProvider, TextChunk, SearchResult, DocMeta } from './types.js';
+/**
+ * 内存知识库实现
+ *
+ * 当注入 EmbeddingProvider 时使用语义向量检索（余弦相似度）；
+ * 未注入时回退到 TF-IDF 关键词匹配（余弦相似度）。
+ *
+ * 零外部依赖，适合开发/测试及小规模知识库场景。
+ */
+export declare class InMemoryKnowledgeBase implements KnowledgeBase {
+    /** 文档存储：docId -> StoredDoc */
+    private docs;
+    /** 嵌入向量提供者（可选） */
+    private embeddingProvider?;
+    /** 全局文档频率：term -> 包含该词的文档数 */
+    private df;
+    /** 总文档数（用于 IDF 计算） */
+    private totalDocs;
+    /** 缓存的 chunk TF-IDF 向量：chunkId -> TFIDFVector */
+    private chunkVectors;
+    constructor(embeddingProvider?: EmbeddingProvider);
+    ingest(docId: string, chunks: TextChunk[]): Promise<void>;
+    search(query: string, topK?: number): Promise<SearchResult[]>;
+    remove(docId: string): Promise<void>;
+    list(): Promise<DocMeta[]>;
+    /** 计算文本的 TF-IDF 稀疏向量 */
+    private computeTFIDF;
+}
+//# sourceMappingURL=in-memory-kb.d.ts.map

package/dist/cjs/kb/in-memory-kb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-kb.d.ts","sourceRoot":"","sources":["../../../src/kb/in-memory-kb.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,OAAO,EACR,MAAM,YAAY,CAAC;AA4CpB;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,8BAA8B;IAC9B,OAAO,CAAC,IAAI,CAAgC;IAC5C,kBAAkB;IAClB,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAA6B;IACvC,sBAAsB;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,iDAAiD;IACjD,OAAO,CAAC,YAAY,CAAkC;gBAE1C,iBAAiB,CAAC,EAAE,iBAAiB;IAI3C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiChE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BpC,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAMhC,wBAAwB;IACxB,OAAO,CAAC,YAAY;CAcrB"}

package/dist/cjs/kb/in-memory-kb.js

@@ -0,0 +1,210 @@
+"use strict";
+// ============================================================
+// InMemoryKnowledgeBase — 内存知识库实现（TF-IDF 关键词匹配）
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryKnowledgeBase = void 0;
+// ---- 文本分词 ----
+/**
+ * 将文本分词为小写词项数组
+ * 按非字母数字字符分割，过滤空串和过短词
+ */
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9\u4e00-\u9fff]+/)
+        .filter(t => t.length > 0);
+}
+/** 计算词项频率（TF） */
+function computeTF(tokens) {
+    const tf = new Map();
+    for (const t of tokens) {
+        tf.set(t, (tf.get(t) || 0) + 1);
+    }
+    // 归一化：除以总词数
+    const total = tokens.length;
+    if (total > 0) {
+        for (const [k, v] of tf) {
+            tf.set(k, v / total);
+        }
+    }
+    return tf;
+}
+// ---- InMemoryKnowledgeBase ----
+/**
+ * 内存知识库实现
+ *
+ * 当注入 EmbeddingProvider 时使用语义向量检索（余弦相似度）；
+ * 未注入时回退到 TF-IDF 关键词匹配（余弦相似度）。
+ *
+ * 零外部依赖，适合开发/测试及小规模知识库场景。
+ */
+class InMemoryKnowledgeBase {
+    /** 文档存储：docId -> StoredDoc */
+    docs = new Map();
+    /** 嵌入向量提供者（可选） */
+    embeddingProvider;
+    /** 全局文档频率：term -> 包含该词的文档数 */
+    df = new Map();
+    /** 总文档数（用于 IDF 计算） */
+    totalDocs = 0;
+    /** 缓存的 chunk TF-IDF 向量：chunkId -> TFIDFVector */
+    chunkVectors = new Map();
+    constructor(embeddingProvider) {
+        this.embeddingProvider = embeddingProvider;
+    }
+    async ingest(docId, chunks) {
+        if (!chunks.length)
+            return;
+        // 如果已有同 ID 文档，先移除
+        if (this.docs.has(docId)) {
+            await this.remove(docId);
+        }
+        // 生成嵌入向量（如果提供了 EmbeddingProvider）
+        if (this.embeddingProvider) {
+            const texts = chunks.map(c => c.content);
+            const embeddings = await this.embeddingProvider.embed(texts);
+            chunks = chunks.map((c, i) => ({ ...c, embedding: embeddings[i] }));
+        }
+        const now = new Date().toISOString();
+        const title = chunks[0]?.metadata?.title || docId;
+        const doc = {
+            meta: {
+                id: docId,
+                title,
+                chunkCount: chunks.length,
+                createdAt: now,
+                metadata: chunks[0]?.metadata,
+            },
+            chunks,
+        };
+        this.docs.set(docId, doc);
+        this.totalDocs++;
+        // 更新 DF（文档频率）
+        const docTerms = new Set();
+        for (const chunk of chunks) {
+            const tokens = tokenize(chunk.content);
+            for (const t of tokens)
+                docTerms.add(t);
+        }
+        for (const t of docTerms) {
+            this.df.set(t, (this.df.get(t) || 0) + 1);
+        }
+        // 计算并缓存每个 chunk 的 TF-IDF 向量
+        for (const chunk of chunks) {
+            this.chunkVectors.set(chunk.id, this.computeTFIDF(chunk.content));
+        }
+    }
+    async search(query, topK = 5) {
+        if (this.docs.size === 0)
+            return [];
+        const results = [];
+        // 如果有 EmbeddingProvider，使用语义检索
+        if (this.embeddingProvider) {
+            const [queryEmbedding] = await this.embeddingProvider.embed([query]);
+            for (const doc of this.docs.values()) {
+                for (const chunk of doc.chunks) {
+                    if (!chunk.embedding)
+                        continue;
+                    const score = cosineSimilarity(queryEmbedding, chunk.embedding);
+                    results.push({ chunk, score });
+                }
+            }
+        }
+        else {
+            // 回退到 TF-IDF 关键词匹配
+            const queryVector = this.computeTFIDF(query);
+            for (const doc of this.docs.values()) {
+                for (const chunk of doc.chunks) {
+                    const chunkVector = this.chunkVectors.get(chunk.id);
+                    if (!chunkVector)
+                        continue;
+                    const score = cosineSimilaritySparse(queryVector, chunkVector);
+                    results.push({ chunk, score });
+                }
+            }
+        }
+        // 按得分降序排列，取 topK
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, topK);
+    }
+    async remove(docId) {
+        const doc = this.docs.get(docId);
+        if (!doc)
+            return;
+        // 移除 chunk 向量缓存
+        for (const chunk of doc.chunks) {
+            this.chunkVectors.delete(chunk.id);
+        }
+        // 更新 DF
+        const docTerms = new Set();
+        for (const chunk of doc.chunks) {
+            const tokens = tokenize(chunk.content);
+            for (const t of tokens)
+                docTerms.add(t);
+        }
+        for (const t of docTerms) {
+            const count = this.df.get(t);
+            if (count != null) {
+                if (count <= 1)
+                    this.df.delete(t);
+                else
+                    this.df.set(t, count - 1);
+            }
+        }
+        this.docs.delete(docId);
+        this.totalDocs--;
+    }
+    async list() {
+        return Array.from(this.docs.values()).map(d => d.meta);
+    }
+    // ---- TF-IDF 计算 ----
+    /** 计算文本的 TF-IDF 稀疏向量 */
+    computeTFIDF(text) {
+        const tokens = tokenize(text);
+        const tf = computeTF(tokens);
+        const vector = new Map();
+        for (const [term, tfVal] of tf) {
+            const dfVal = this.df.get(term) || 0;
+            // IDF = log((1 + N) / (1 + DF)) + 1  （平滑处理）
+            const idf = Math.log((1 + this.totalDocs) / (1 + dfVal)) + 1;
+            vector.set(term, tfVal * idf);
+        }
+        return vector;
+    }
+}
+exports.InMemoryKnowledgeBase = InMemoryKnowledgeBase;
+// ---- 向量相似度计算 ----
+/** 计算两个稠密向量的余弦相似度 */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0;
+    let magA = 0;
+    let magB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        magA += a[i] * a[i];
+        magB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(magA) * Math.sqrt(magB);
+    return denom === 0 ? 0 : dot / denom;
+}
+/** 计算两个稀疏向量（Map）的余弦相似度 */
+function cosineSimilaritySparse(a, b) {
+    let dot = 0;
+    let magA = 0;
+    let magB = 0;
+    for (const [k, v] of a) {
+        magA += v * v;
+        const bv = b.get(k);
+        if (bv != null)
+            dot += v * bv;
+    }
+    for (const [, v] of b) {
+        magB += v * v;
+    }
+    const denom = Math.sqrt(magA) * Math.sqrt(magB);
+    return denom === 0 ? 0 : dot / denom;
+}
+//# sourceMappingURL=in-memory-kb.js.map

package/dist/cjs/kb/in-memory-kb.js.map

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

package/dist/cjs/kb/rag-middleware.d.ts

@@ -0,0 +1,31 @@
+import type { Middleware } from '../middleware/types.js';
+import type { KnowledgeBase } from './types.js';
+/** RAG 中间件配置 */
+export interface RAGMiddlewareOptions {
+    /** 检索结果数量（默认 3） */
+    topK?: number;
+    /** 注入的上下文笔记标题（默认 "Retrieved Knowledge"） */
+    noteTitle?: string;
+    /** 每个分块最大字符数（默认 500，超出截断） */
+    maxChunkLength?: number;
+    /** 最低相似度阈值（低于此值的结果不注入，默认 0.01） */
+    minScore?: number;
+    /** 是否仅在首轮迭代注入（默认 false，每轮都检索） */
+    firstIterationOnly?: boolean;
+    /** 日志输出函数 */
+    logger?: (msg: string) => void;
+}
+/**
+ * 创建 RAG（检索增强生成）中间件
+ *
+ * 在每轮迭代开始前：
+ * 1. 提取用户最新消息文本
+ * 2. 检索知识库中相关分块
+ * 3. 将检索结果格式化为系统级上下文笔记，注入到消息列表末尾
+ *
+ * @param kb      知识库实例
+ * @param options 配置选项
+ * @returns Middleware 实例
+ */
+export declare function createRAGMiddleware(kb: KnowledgeBase, options?: RAGMiddlewareOptions): Middleware;
+//# sourceMappingURL=rag-middleware.d.ts.map

package/dist/cjs/kb/rag-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-middleware.d.ts","sourceRoot":"","sources":["../../../src/kb/rag-middleware.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,wBAAwB,CAAC;AAG5E,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAI9D,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa;IACb,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,aAAa,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,UAAU,CAkFZ"}

package/dist/cjs/kb/rag-middleware.js

@@ -0,0 +1,94 @@
+"use strict";
+// ============================================================
+// RAGMiddleware — 检索增强生成中间件
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRAGMiddleware = createRAGMiddleware;
+const types_ts_1 = require("../types.js");
+// ---- createRAGMiddleware ----
+/**
+ * 创建 RAG（检索增强生成）中间件
+ *
+ * 在每轮迭代开始前：
+ * 1. 提取用户最新消息文本
+ * 2. 检索知识库中相关分块
+ * 3. 将检索结果格式化为系统级上下文笔记，注入到消息列表末尾
+ *
+ * @param kb      知识库实例
+ * @param options 配置选项
+ * @returns Middleware 实例
+ */
+function createRAGMiddleware(kb, options) {
+    const topK = options?.topK ?? 3;
+    const noteTitle = options?.noteTitle ?? 'Retrieved Knowledge';
+    const maxChunkLength = options?.maxChunkLength ?? 500;
+    const minScore = options?.minScore ?? 0.01;
+    const firstIterationOnly = options?.firstIterationOnly ?? false;
+    const logger = options?.logger ?? (() => { });
+    /** 已注入过的会话集合（用于 firstIterationOnly 模式） */
+    const injectedSessions = new Set();
+    /** 格式化检索结果为上下文笔记 */
+    function formatContextNote(results) {
+        const lines = [`--- ${noteTitle} ---`];
+        for (let i = 0; i < results.length; i++) {
+            const { chunk, score } = results[i];
+            let content = chunk.content;
+            if (content.length > maxChunkLength) {
+                content = content.slice(0, maxChunkLength) + '...';
+            }
+            const source = chunk.metadata?.title
+                ? `[${chunk.metadata.title}]`
+                : `[doc: ${chunk.docId}]`;
+            lines.push(`[${i + 1}] ${source} (score: ${score.toFixed(3)})`);
+            lines.push(content);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /** 从消息列表中提取最新的用户消息文本 */
+    function getLatestUserMessage(messages) {
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            if (msg.role === 'user') {
+                return (0, types_ts_1.extractTextFromContent)(msg.content);
+            }
+        }
+        return '';
+    }
+    return {
+        name: 'rag',
+        async before(ctx) {
+            // firstIterationOnly 模式：仅首轮注入
+            if (firstIterationOnly && injectedSessions.has(ctx.sessionId)) {
+                return;
+            }
+            // 提取最新用户消息
+            const query = getLatestUserMessage(ctx.messages);
+            if (!query.trim())
+                return;
+            try {
+                const results = await kb.search(query, topK);
+                // 过滤低分结果
+                const filtered = results.filter(r => r.score >= minScore);
+                if (filtered.length === 0)
+                    return;
+                // 格式化上下文笔记
+                const note = formatContextNote(filtered);
+                // 注入系统级上下文消息
+                const contextMessage = {
+                    role: 'system',
+                    content: note,
+                };
+                // ctx.messages 是 ReadonlyArray，但底层是可变数组
+                // 与引擎内部注入消息的模式一致（如 progress nudge、iteration guard 等）
+                ctx.messages.push(contextMessage);
+                injectedSessions.add(ctx.sessionId);
+                logger(`[RAG] Injected ${filtered.length} chunks for session ${ctx.sessionId} (iter ${ctx.iteration})`);
+            }
+            catch (e) {
+                logger(`[RAG] Search failed: ${e?.message || e}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=rag-middleware.js.map

package/dist/cjs/kb/rag-middleware.js.map

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

package/dist/cjs/kb/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 文本分块
+ */
+export interface TextChunk {
+    /** 分块 ID */
+    id: string;
+    /** 所属文档 ID */
+    docId: string;
+    /** 分块文本内容 */
+    content: string;
+    /** 分块元数据（标题、页码、位置等） */
+    metadata?: Record<string, unknown>;
+    /** 向量嵌入（由 EmbeddingProvider 生成） */
+    embedding?: number[];
+}
+/**
+ * 文档元数据
+ */
+export interface DocMeta {
+    /** 文档 ID */
+    id: string;
+    /** 文档标题 */
+    title: string;
+    /** 分块数量 */
+    chunkCount: number;
+    /** 创建时间 */
+    createdAt: string;
+    /** 额外元数据 */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 搜索结果
+ */
+export interface SearchResult {
+    /** 匹配的分块 */
+    chunk: TextChunk;
+    /** 相似度分数（0-1，越高越相关） */
+    score: number;
+}
+/**
+ * 知识库接口 — Core 定义接口，App 提供持久化实现
+ */
+export interface KnowledgeBase {
+    /** 写入文档分块 */
+    ingest(docId: string, chunks: TextChunk[]): Promise<void>;
+    /** 语义搜索：返回 topK 最相关的分块 */
+    search(query: string, topK?: number): Promise<SearchResult[]>;
+    /** 删除文档的所有分块 */
+    remove(docId: string): Promise<void>;
+    /** 列出所有文档元数据 */
+    list(): Promise<DocMeta[]>;
+}
+/**
+ * Embedding 提供者接口 — 与 LLMProvider 同级
+ * App 层实现后注入到 KnowledgeBase
+ */
+export interface EmbeddingProvider {
+    /** 将文本数组转换为向量数组 */
+    embed(texts: string[]): Promise<number[][]>;
+    /** 向量维度 */
+    dimensions: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/kb/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/kb/types.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,KAAK,EAAE,SAAS,CAAC;IACjB,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,0BAA0B;IAC1B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9D,gBAAgB;IAChB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,gBAAgB;IAChB,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/cjs/kb/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// KnowledgeBase — 知识库接口定义
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/kb/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/kb/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,0BAA0B;AAC1B,+DAA+D"}

package/dist/cjs/llm/anthropic-provider.d.ts

@@ -20,6 +20,13 @@ export declare class AnthropicProvider implements LLMProvider {
      * - assistant 的 tool_calls 转换为 tool_use 块
      */
     private convertMessages;
+    /**
+     * 将 ContentPart[] 转换为 Anthropic content blocks
+     * - TextPart → {type: 'text', text}
+     * - ImagePart → {type: 'image', source: {type: 'base64'|'url', ...}}
+     * - FilePart → {type: 'text', text: '[file]\n${content}'}
+     */
+    private convertContentPartsForAnthropic;
     private convertTools;
     private buildRequestBody;
     private parseResponse;