@cicctencent/agent-server 0.1.1

package/dist/esm/index.js

@@ -0,0 +1,57 @@
+// ============================================================
+// agent-server — 统一导出
+// ============================================================
+// ---- 工厂函数 ----
+export { createAgentServer } from "./agent/agent-server.js";
+// ---- 默认实现 ----
+export { DefaultSettingsProvider } from "./service/settings.service.js";
+export { DefaultChatStoreProvider } from "./service/chat.service.js";
+export { DefaultAgentProfileProvider } from "./service/agent-profile.service.js";
+export { DefaultPromptBuilder, RESULT_SYNTHESIS_PROMPT } from "./prompt/prompt-builder.js";
+// ---- 服务 ----
+export { MemoryService, getMemoryService, resetMemoryService } from "./service/memory.service.js";
+export { getEnginePool, resetEnginePool } from "./service/engine-pool.js";
+export { getRunRegistry, resetRunRegistry } from "./service/run-registry.js";
+// ---- SSE ----
+export { writeSSE, initSSEResponse, runAgentSSEStream } from "./sse/sse-handler.js";
+export { collectEngineOutput } from "./sse/sse-handler.js";
+// ---- 工具 ----
+export { LocalShellExecutor, LocalFileSystemExecutor } from "./tool/local-executors.js";
+export { createBuiltinTools } from "./tool/builtin.js";
+// ---- 安全 ----
+export { createSafetyAuditMiddleware } from "./service/safety-audit.middleware.js";
+export { getSecurityPolicy, updateSecurityPolicy } from "./service/security-policy.service.js";
+export { assessToolRisk, isLowRiskTool, clearRiskCache } from "./service/tool-risk.service.js";
+export { createPermissionRequest, listPermissionRequests, findApprovedPermission, decidePermissionRequest, initPermissionService, } from "./service/permission.service.js";
+export { appendAuditLog, listAuditLogs, redactAuditEntry } from "./service/audit.service.js";
+// ---- 可观测性 ----
+export { logEvent, setLogTransport } from "./service/observability.service.js";
+// ---- 连接器 ----
+export { registerAdapter, getAdapter, listAdapterTypes, listAdapters, resetAdapters } from "./connectors/index.js";
+// ---- Store ----
+export { JsonStore, JsonListStore } from "./store/index.js";
+export { McpServerStore } from "./store/mcp-server-store.js";
+export { getToolResultStore, FileNoteStore, WorkspaceStore, getWorkspaceStore, AutomationStore, getAutomationStore, AutomationRunStore, getAutomationRunStore, } from "./store/app-stores.js";
+// ---- Sandbox ----
+export { LocalSandbox, SandboxFileSystemExecutor, SandboxShellExecutor } from "./sandbox/local-sandbox.js";
+export { LocalSandboxManager, getSandboxManager } from "./sandbox/sandbox-manager.js";
+export { ProcessCodeSandbox } from "./sandbox/process-code-sandbox.js";
+// ---- MCP Bridge ----
+export { ApiBridgeClient } from "./mcp/api-bridge-client.js";
+export { resolveBodyTemplate } from "./mcp/body-template.js";
+export { buildFromTemplate } from "./mcp/template-builder.js";
+export { importFromOpenAPI } from "./mcp/openapi-importer.js";
+// ---- KB ----
+export { parseDocument } from "./kb/doc-parser.js";
+export { EmbeddingVectorIndex } from "./kb/embedding-vector-index.js";
+export { FileKnowledgeBase } from "./kb/file-knowledge-base.js";
+// ---- Artifact & Workspace ----
+export { saveArtifact, resolveArtifactPath, getMimeType, isImageMime } from "./service/artifact.service.js";
+export { getWorkspaces, getWorkspace, ensureDefaultWorkspace, createWorkspace, updateWorkspace, deleteWorkspace, refreshThreadCount, refreshAutomationCount, } from "./service/workspace.service.js";
+// ---- Utils ----
+export { getDataPath, getProjectDataPath, ensureDataDir, ensureProjectDataDir, expandEnvVars, setAppName, getAppName, ensureDefaultData, } from "./utils/data-dir.js";
+// ---- 向后兼容的快捷函数 ----
+export { getSettings, updateSettings, resetSettings, getSettingsProvider } from "./service/settings.service.js";
+export { getThreads, getThread, createThread, getMessages, addMessage, updateMessage, buildThreadHistory, getChatStoreProvider, } from "./service/chat.service.js";
+export { listProfiles, getProfile, getDefaultProfile, createProfile, updateProfile, deleteProfile, getAgentProfileProvider, nextId, setIdCounter, getIdCounter, } from "./service/agent-profile.service.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/kb/doc-parser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file Document Parser — 文档解析与分块
+ * @description 支持 Markdown / TXT / JSON 直接读取，其他格式提取纯文本后分块
+ */
+export interface ParsedDocument {
+    docId: string;
+    filename: string;
+    text: string;
+    chunks: TextChunkData[];
+}
+export interface TextChunkData {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 解析文档文件为纯文本
+ */
+export declare function parseDocument(filePath: string, docId: string): Promise<ParsedDocument>;
+/**
+ * 文本分块：按段落 + 固定大小切分，带重叠
+ */
+export declare function chunkText(text: string, docId: string): TextChunkData[];
+//# sourceMappingURL=doc-parser.d.ts.map

package/dist/esm/kb/doc-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-parser.d.ts","sourceRoot":"","sources":["../../../src/kb/doc-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAOD;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuC5F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAyCtE"}

package/dist/esm/kb/doc-parser.js

@@ -0,0 +1,100 @@
+/**
+ * @file Document Parser — 文档解析与分块
+ * @description 支持 Markdown / TXT / JSON 直接读取，其他格式提取纯文本后分块
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/** 分块大小（字符数） */
+const CHUNK_SIZE = 500;
+/** 分块重叠（字符数），确保上下文连续性 */
+const CHUNK_OVERLAP = 50;
+/**
+ * 解析文档文件为纯文本
+ */
+export async function parseDocument(filePath, docId) {
+    const filename = path.basename(filePath);
+    const ext = path.extname(filename).toLowerCase();
+    let text = '';
+    switch (ext) {
+        case '.md':
+        case '.txt':
+        case '.json':
+        case '.csv':
+        case '.tsv':
+        case '.log':
+            text = await fs.readFile(filePath, 'utf8');
+            break;
+        case '.html':
+        case '.htm': {
+            const raw = await fs.readFile(filePath, 'utf8');
+            // 简单 HTML 标签剥离
+            text = raw.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
+                .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
+                .replace(/<[^>]+>/g, ' ')
+                .replace(/\s+/g, ' ')
+                .trim();
+            break;
+        }
+        default:
+            // 尝试以 UTF-8 读取，失败则提示不支持
+            try {
+                text = await fs.readFile(filePath, 'utf8');
+            }
+            catch {
+                throw new Error(`Unsupported file type: ${ext}. Supported: .md, .txt, .json, .csv, .html`);
+            }
+    }
+    const chunks = chunkText(text, docId);
+    return { docId, filename, text, chunks };
+}
+/**
+ * 文本分块：按段落 + 固定大小切分，带重叠
+ */
+export function chunkText(text, docId) {
+    if (!text.trim())
+        return [];
+    const chunks = [];
+    // 先按双换行分段（段落级）
+    const paragraphs = text.split(/\n\s*\n/).filter(p => p.trim());
+    let currentChunk = '';
+    let chunkIndex = 0;
+    for (const para of paragraphs) {
+        // 如果当前段落本身超过 CHUNK_SIZE，按固定大小切分
+        if (para.length > CHUNK_SIZE) {
+            // 先保存当前累积的内容
+            if (currentChunk.trim()) {
+                chunks.push(createChunk(docId, chunkIndex++, currentChunk.trim()));
+                currentChunk = '';
+            }
+            // 固定大小切分长段落
+            for (let i = 0; i < para.length; i += CHUNK_SIZE - CHUNK_OVERLAP) {
+                const slice = para.slice(i, i + CHUNK_SIZE);
+                chunks.push(createChunk(docId, chunkIndex++, slice.trim()));
+            }
+        }
+        else if (currentChunk.length + para.length + 2 > CHUNK_SIZE) {
+            // 当前块已满，保存并开始新块
+            if (currentChunk.trim()) {
+                chunks.push(createChunk(docId, chunkIndex++, currentChunk.trim()));
+            }
+            currentChunk = para;
+        }
+        else {
+            // 追加到当前块
+            currentChunk = currentChunk ? `${currentChunk}\n\n${para}` : para;
+        }
+    }
+    // 保存最后一个块
+    if (currentChunk.trim()) {
+        chunks.push(createChunk(docId, chunkIndex++, currentChunk.trim()));
+    }
+    return chunks;
+}
+function createChunk(docId, index, content) {
+    return {
+        id: `${docId}_chunk_${index}`,
+        content,
+        metadata: { index, docId, charCount: content.length },
+    };
+}
+//# sourceMappingURL=doc-parser.js.map

package/dist/esm/kb/doc-parser.js.map

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

package/dist/esm/kb/embedding-vector-index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file Embedding Vector Index — 基于 Embedding 的向量索引实现
+ * @description 调用 EmbeddingProvider 生成向量，实现 VectorIndex 接口
+ */
+import type { VectorIndex, VectorItem, VectorSearchResult } from '@cicctencent/agent-core';
+export interface EmbeddingProviderLike {
+    embed(texts: string[]): Promise<number[][]>;
+}
+/**
+ * 基于 Embedding Provider 的向量索引
+ * - build() 时为每个 item 的文本生成 embedding
+ * - search() 时将查询文本转为 embedding，然后做余弦相似度搜索
+ */
+export declare class EmbeddingVectorIndex implements VectorIndex {
+    private items;
+    private embeddingProvider;
+    private textExtractor;
+    constructor(embeddingProvider: EmbeddingProviderLike, options?: {
+        textExtractor?: (item: VectorItem) => string;
+    });
+    build(items: VectorItem[]): Promise<void>;
+    search(query: number[], k: number): Promise<VectorSearchResult[]>;
+    searchText(queryText: string, k: number): Promise<VectorSearchResult[]>;
+    add(item: VectorItem): Promise<void>;
+    remove(id: string): void;
+    clear(): void;
+    size(): number;
+    getItems(): VectorItem[];
+}
+//# sourceMappingURL=embedding-vector-index.d.ts.map

package/dist/esm/kb/embedding-vector-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-vector-index.d.ts","sourceRoot":"","sources":["../../../src/kb/embedding-vector-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAC7C;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,WAAW;IACtD,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,iBAAiB,CAAwB;IACjD,OAAO,CAAC,aAAa,CAA+B;gBAGlD,iBAAiB,EAAE,qBAAqB,EACxC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,CAAA;KAAE;IAMtD,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAYjE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKvE,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;IAId,QAAQ,IAAI,UAAU,EAAE;CAGzB"}

package/dist/esm/kb/embedding-vector-index.js

@@ -0,0 +1,71 @@
+/**
+ * @file Embedding Vector Index — 基于 Embedding 的向量索引实现
+ * @description 调用 EmbeddingProvider 生成向量，实现 VectorIndex 接口
+ */
+/**
+ * 基于 Embedding Provider 的向量索引
+ * - build() 时为每个 item 的文本生成 embedding
+ * - search() 时将查询文本转为 embedding，然后做余弦相似度搜索
+ */
+export class EmbeddingVectorIndex {
+    items = [];
+    embeddingProvider;
+    textExtractor;
+    constructor(embeddingProvider, options) {
+        this.embeddingProvider = embeddingProvider;
+        this.textExtractor = options?.textExtractor || ((item) => item.metadata?.['text'] || '');
+    }
+    async build(items) {
+        const needEmbedding = items.filter(i => !i.vector || i.vector.length === 0);
+        if (needEmbedding.length > 0) {
+            const texts = needEmbedding.map(i => this.textExtractor(i));
+            const embeddings = await this.embeddingProvider.embed(texts);
+            needEmbedding.forEach((item, i) => {
+                item.vector = embeddings[i];
+            });
+        }
+        this.items = items;
+    }
+    async search(query, k) {
+        if (this.items.length === 0)
+            return [];
+        return this.items
+            .filter(item => item.vector && item.vector.length > 0)
+            .map(item => ({
+            item,
+            score: cosineSimilarity(query, item.vector),
+        }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, k);
+    }
+    async searchText(queryText, k) {
+        const embeddings = await this.embeddingProvider.embed([queryText]);
+        return this.search(embeddings[0], k);
+    }
+    async add(item) {
+        this.items.push(item);
+    }
+    remove(id) {
+        this.items = this.items.filter(i => i.id !== id);
+    }
+    clear() {
+        this.items = [];
+    }
+    size() {
+        return this.items.length;
+    }
+    getItems() {
+        return [...this.items];
+    }
+}
+function cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom > 0 ? dot / denom : 0;
+}
+//# sourceMappingURL=embedding-vector-index.js.map

package/dist/esm/kb/embedding-vector-index.js.map

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

package/dist/esm/kb/file-knowledge-base.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file FileKnowledgeBase — 基于文件的知识库实现
+ * @description 文档分块 + embedding 存储（data/kb/），实现 KnowledgeBase 接口
+ */
+import type { KnowledgeBase, TextChunk, SearchResult, DocMeta, EmbeddingProvider } from '@cicctencent/agent-core';
+/**
+ * 基于文件的知识库实现
+ * - 文档元数据存储在 data/kb/docs.json
+ * - 文本块存储在 data/kb/chunks.json
+ * - 搜索：有 embedding 时用余弦相似度，无时用 TF-IDF 关键词匹配
+ */
+export declare class FileKnowledgeBase implements KnowledgeBase {
+    private docStore;
+    private chunkStore;
+    private embeddingProvider?;
+    constructor(options?: {
+        embeddingProvider?: EmbeddingProvider;
+    });
+    ingest(docId: string, chunks: TextChunk[]): Promise<void>;
+    search(query: string, topK?: number): Promise<SearchResult[]>;
+    remove(docId: string): Promise<void>;
+    list(): Promise<DocMeta[]>;
+    private toTextChunk;
+}
+//# sourceMappingURL=file-knowledge-base.d.ts.map

package/dist/esm/kb/file-knowledge-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-knowledge-base.d.ts","sourceRoot":"","sources":["../../../src/kb/file-knowledge-base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAmBlH;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,iBAAiB,CAAC,CAAoB;gBAElC,OAAO,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;KAAE;IAYzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAqBhE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpC,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAWhC,OAAO,CAAC,WAAW;CASpB"}

package/dist/esm/kb/file-knowledge-base.js

@@ -0,0 +1,163 @@
+/**
+ * @file FileKnowledgeBase — 基于文件的知识库实现
+ * @description 文档分块 + embedding 存储（data/kb/），实现 KnowledgeBase 接口
+ */
+import * as fs from 'fs/promises';
+import { existsSync } from 'fs';
+import { getProjectDataPath } from "../utils/data-dir.js";
+import { JsonStore, formatLocalDateTime } from '@cicctencent/agent-core';
+/**
+ * 基于文件的知识库实现
+ * - 文档元数据存储在 data/kb/docs.json
+ * - 文本块存储在 data/kb/chunks.json
+ * - 搜索：有 embedding 时用余弦相似度，无时用 TF-IDF 关键词匹配
+ */
+export class FileKnowledgeBase {
+    docStore;
+    chunkStore;
+    embeddingProvider;
+    constructor(options) {
+        const kbDir = getProjectDataPath('kb');
+        this.docStore = new JsonStore('kb/docs.json', 0, { projectLocal: true });
+        this.chunkStore = new JsonStore('kb/chunks.json', 0, { projectLocal: true });
+        this.embeddingProvider = options?.embeddingProvider;
+        // 确保目录存在
+        if (!existsSync(kbDir)) {
+            fs.mkdir(kbDir, { recursive: true }).catch(() => { });
+        }
+    }
+    async ingest(docId, chunks) {
+        const docs = this.docStore.read([]);
+        const chunksAll = this.chunkStore.read([]);
+        // 如果文档已存在，先移除旧数据
+        const filteredChunks = chunksAll.filter(c => c.docId !== docId);
+        const filteredDocs = docs.filter(d => d.id !== docId);
+        // 添加新块
+        const newChunks = chunks.map(c => ({
+            id: c.id,
+            docId,
+            content: c.content,
+            embedding: c.embedding,
+            metadata: c.metadata,
+        }));
+        // 如果有 embedding provider，为没有 embedding 的块生成 embedding
+        if (this.embeddingProvider) {
+            const needEmbedding = newChunks.filter(c => !c.embedding);
+            if (needEmbedding.length > 0) {
+                const texts = needEmbedding.map(c => c.content);
+                const embeddings = await this.embeddingProvider.embed(texts);
+                needEmbedding.forEach((c, i) => {
+                    c.embedding = embeddings[i];
+                });
+            }
+        }
+        filteredChunks.push(...newChunks);
+        this.chunkStore.write(filteredChunks);
+        // 添加文档元数据
+        const docMeta = {
+            id: docId,
+            title: chunks[0]?.metadata?.title || docId,
+            filename: chunks[0]?.metadata?.filename || docId,
+            chunkCount: chunks.length,
+            createdAt: formatLocalDateTime(),
+            metadata: chunks[0]?.metadata,
+        };
+        filteredDocs.push(docMeta);
+        this.docStore.write(filteredDocs);
+    }
+    async search(query, topK = 5) {
+        const chunks = this.chunkStore.read([]);
+        if (chunks.length === 0)
+            return [];
+        // 如果有 embedding provider，使用向量搜索
+        if (this.embeddingProvider) {
+            const queryEmbedding = (await this.embeddingProvider.embed([query]))[0];
+            return chunks
+                .filter(c => c.embedding)
+                .map(c => ({
+                chunk: this.toTextChunk(c),
+                score: cosineSimilarity(queryEmbedding, c.embedding),
+            }))
+                .sort((a, b) => b.score - a.score)
+                .slice(0, topK);
+        }
+        // 无 embedding：使用 TF-IDF 关键词匹配
+        return tfidfSearch(query, chunks, topK);
+    }
+    async remove(docId) {
+        const docs = this.docStore.read([]);
+        const chunks = this.chunkStore.read([]);
+        this.docStore.write(docs.filter(d => d.id !== docId));
+        this.chunkStore.write(chunks.filter(c => c.docId !== docId));
+    }
+    async list() {
+        const docs = this.docStore.read([]);
+        return docs.map(d => ({
+            id: d.id,
+            title: d.title,
+            chunkCount: d.chunkCount,
+            createdAt: d.createdAt,
+            metadata: d.metadata,
+        }));
+    }
+    toTextChunk(record) {
+        return {
+            id: record.id,
+            docId: record.docId,
+            content: record.content,
+            embedding: record.embedding,
+            metadata: record.metadata,
+        };
+    }
+}
+// ===== 工具函数 =====
+function cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom > 0 ? dot / denom : 0;
+}
+function tfidfSearch(query, chunks, topK) {
+    const queryTerms = tokenize(query);
+    if (queryTerms.length === 0)
+        return [];
+    // 计算 IDF
+    const docFreq = new Map();
+    for (const chunk of chunks) {
+        const terms = new Set(tokenize(chunk.content));
+        for (const t of terms) {
+            docFreq.set(t, (docFreq.get(t) || 0) + 1);
+        }
+    }
+    const N = chunks.length;
+    // 计算每个块的 TF-IDF 得分
+    return chunks
+        .map(chunk => {
+        const terms = tokenize(chunk.content);
+        const tf = new Map();
+        for (const t of terms) {
+            tf.set(t, (tf.get(t) || 0) + 1);
+        }
+        let score = 0;
+        for (const qt of queryTerms) {
+            const tfVal = tf.get(qt) || 0;
+            const idfVal = Math.log((N + 1) / ((docFreq.get(qt) || 0) + 1)) + 1;
+            score += tfVal * idfVal;
+        }
+        return { chunk: { id: chunk.id, docId: chunk.docId, content: chunk.content, metadata: chunk.metadata }, score };
+    })
+        .filter(r => r.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, topK);
+}
+function tokenize(text) {
+    return text.toLowerCase()
+        .replace(/[^\w\u4e00-\u9fff]/g, ' ')
+        .split(/\s+/)
+        .filter(t => t.length > 1);
+}
+//# sourceMappingURL=file-knowledge-base.js.map

package/dist/esm/kb/file-knowledge-base.js.map

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

package/dist/esm/mcp/api-bridge-client.d.ts

@@ -0,0 +1,36 @@
+import type { MCPClient, MCPServerConfig, ToolDefinition } from '@cicctencent/agent-core';
+import type { RequestBuilderFn, ResponseConfig } from './api-bridge-types.js';
+/** api-bridge 扩展配置（从 MCPServerConfig.extra 中读取） */
+export interface ApiBridgeExtra {
+    /** 请求构建函数（由 mcp.service 根据 requestBuilderId 注入） */
+    buildRequest: RequestBuilderFn;
+    /** 工具名 -> 映射配置（结构由各 connector builder 解释） */
+    apiMapping: Record<string, Record<string, unknown>>;
+    /** 手动定义的工具列表 */
+    toolDefinitions?: Array<{
+        name: string;
+        description: string;
+        parameters?: Record<string, unknown>;
+    }>;
+    /** 全局响应处理配置（可被 mapping 级 response 覆盖） */
+    response?: ResponseConfig;
+}
+/**
+ * API Bridge 客户端
+ *
+ * 纯粹的 fetch 执行器，不含任何请求构建逻辑。
+ * 连接器通过 RequestBuilderFn 定义如何构建 HTTP 请求（URL、headers、body、代理等），
+ * ApiBridgeClient 仅负责：调用 buildRequest → 执行 fetch → 返回结果。
+ */
+export declare class ApiBridgeClient implements MCPClient {
+    private config;
+    private extra;
+    private connected;
+    private proxyUrl?;
+    connect(config: MCPServerConfig): Promise<void>;
+    listTools(): Promise<ToolDefinition[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<string>;
+    disconnect(): void;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=api-bridge-client.d.ts.map

package/dist/esm/mcp/api-bridge-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-bridge-client.d.ts","sourceRoot":"","sources":["../../../src/mcp/api-bridge-client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI9E,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,YAAY,EAAE,gBAAgB,CAAC;IAC/B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,gBAAgB;IAChB,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC,CAAC;IACH,yCAAyC;IACzC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAEpB,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/C,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAYtC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA6F5E,UAAU,IAAI,IAAI;IAKlB,WAAW,IAAI,OAAO;CAGvB"}