knight-agent 1.1.0 → 1.1.2

package/module/ToolModule/ToolModule.js

@@ -1,220 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolModule = void 0;
-const base_1 = require("../../base");
-const ToolRAG_1 = require("./ToolRAG");
-/** 工具管理模块 — 注册表 + 缓存 + 重试 + 执行调度 */
-class ToolModule extends base_1.AbstractModule {
-    constructor() {
-        super();
-        /** 工具语义检索器(可选) */
-        this._rag = new ToolRAG_1.ToolRAG();
-        this._tools = new Map();
-        this._cache = new Map();
-    }
-    /** 已注册工具数量 */
-    get count() { return this._tools.size; }
-    // ======================== 注册 ========================
-    /** 注册单个工具 */
-    register(tool) {
-        this._tools.set(tool.name, tool);
-        this._rag.index(tool.name, `${tool.name}: ${tool.description}`);
-        return this;
-    }
-    /** 批量注册 */
-    registerAll(tools) {
-        for (const tool of tools) {
-            this.register(tool);
-        }
-        return this;
-    }
-    /** 移除工具 */
-    unregister(name) {
-        this.invalidateCache(name);
-        this._rag.remove(name);
-        return this._tools.delete(name);
-    }
-    /** 获取工具定义 */
-    get(name) {
-        return this._tools.get(name);
-    }
-    /** 获取全部工具 */
-    list() {
-        return Array.from(this._tools.values());
-    }
-    /** 按分类获取 */
-    listByCategory(category) {
-        return this.list().filter(t => t.category === category);
-    }
-    /** 设置语义检索的嵌入提供者(不设则使用内置关键词匹配) */
-    setEmbeddingProvider(provider) {
-        this._rag.setProvider(provider);
-    }
-    /**
-     * 根据用户输入从候选工具中检索最相关的 Top-K 个
-     *   先经过 RAG 语义排序，再取前 topK 个
-     * @param query      用户输入
-     * @param candidates 候选工具名列表(如 Skill 过滤后的结果)
-     * @param topK       返回数量
-     */
-    async selectTools(query, candidates, topK = 10) {
-        const pool = (candidates ?? this.list().map(t => t.name));
-        if (pool.length <= topK) {
-            return pool;
-        }
-        const items = pool
-            .map(n => this._tools.get(n))
-            .filter(Boolean)
-            .map(t => ({ name: t.name, description: t.description }));
-        return this._rag.search(query, items, topK);
-    }
-    /**
-     * 导出为 OpenAI API 工具列表(可按名称过滤)
-     * @param names     工具名白名单
-     * @param compact   精简模式：去掉 schema 中的 description/default，减少 token 开销
-     */
-    ToAPITools(names, compact = false) {
-        const tools = names
-            ? names.map(n => this._tools.get(n)).filter(Boolean)
-            : this.list();
-        return tools.map(t => ({
-            id: t.name,
-            type: "function",
-            function: {
-                name: t.name,
-                description: t.description,
-                parameters: compact ? this.stripSchema(t.schema) : t.schema,
-            },
-        }));
-    }
-    /** 递归裁剪 JSONSchema：去掉 description/default，只保留 type/enum/required/properties/items */
-    stripSchema(s) {
-        if (!s || typeof s !== "object") {
-            return s;
-        }
-        const out = {};
-        if (s.type) {
-            out.type = s.type;
-        }
-        if (s.enum) {
-            out.enum = s.enum;
-        }
-        if (s.required) {
-            out.required = s.required;
-        }
-        if (s.properties) {
-            out.properties = {};
-            for (const [k, v] of Object.entries(s.properties)) {
-                out.properties[k] = this.stripSchema(v);
-            }
-        }
-        if (s.items) {
-            out.items = this.stripSchema(s.items);
-        }
-        return out;
-    }
-    // ======================== 缓存 ========================
-    cacheKey(name, args) {
-        return `${name}:${JSON.stringify(args)}`;
-    }
-    checkCache(name, args) {
-        const key = this.cacheKey(name, args);
-        const entry = this._cache.get(key);
-        if (entry && (Date.now() - entry.timestamp) < entry.ttlMs) {
-            return entry.result;
-        }
-        this._cache.delete(key);
-        return null;
-    }
-    setCache(name, args, result, ttlMs = 60000) {
-        const key = this.cacheKey(name, args);
-        this._cache.set(key, { result, timestamp: Date.now(), ttlMs });
-    }
-    /** 清除缓存(可按工具名精确清除) */
-    invalidateCache(name) {
-        if (name) {
-            for (const [key] of this._cache) {
-                if (key.startsWith(`${name}:`)) {
-                    this._cache.delete(key);
-                }
-            }
-        }
-        else {
-            this._cache.clear();
-        }
-    }
-    // ======================== 执行 ========================
-    /** 执行单个工具调用 */
-    async Execute(toolCall, ctx) {
-        const name = toolCall.function.name;
-        const tool = this._tools.get(name);
-        if (!tool) {
-            return `工具 "${name}" 未注册`;
-        }
-        let args;
-        try {
-            args = JSON.parse(toolCall.function.arguments);
-        }
-        catch {
-            return `工具 "${name}" 参数解析失败`;
-        }
-        if (tool.cacheable) {
-            const cached = this.checkCache(name, args);
-            if (cached) {
-                return cached;
-            }
-        }
-        const maxRetries = (tool.retryable && tool.maxRetries) ? tool.maxRetries : 1;
-        let lastError = "";
-        for (let attempt = 0; attempt < maxRetries; attempt++) {
-            try {
-                const result = await tool.handler(args);
-                if (tool.cacheable) {
-                    this.setCache(name, args, result);
-                }
-                return result;
-            }
-            catch (e) {
-                lastError = String(e);
-                if (attempt < maxRetries - 1) {
-                    await new Promise(r => setTimeout(r, 200 * (attempt + 1)));
-                }
-            }
-        }
-        return `工具 "${name}" 执行失败(重试${maxRetries}次): ${lastError}`;
-    }
-    /** 批量执行(自动分组并行/串行) */
-    async ExecuteBatch(toolCalls, ctx) {
-        const results = new Map();
-        const parallel = [];
-        const sequential = [];
-        for (const tc of toolCalls) {
-            const tool = this._tools.get(tc.function.name);
-            if (tool?.parallelizable) {
-                parallel.push(tc);
-            }
-            else {
-                sequential.push(tc);
-            }
-        }
-        if (parallel.length > 0) {
-            const parallelResults = await Promise.all(parallel.map(tc => this.Execute(tc, ctx).then(r => ({ id: tc.id, result: r }))));
-            for (const { id, result } of parallelResults) {
-                results.set(id, result);
-            }
-        }
-        for (const tc of sequential) {
-            const result = await this.Execute(tc, ctx);
-            results.set(tc.id, result);
-        }
-        return results;
-    }
-    /** 清空全部工具和缓存 */
-    clear() {
-        this._tools.clear();
-        this._cache.clear();
-        // RAG 索引随工具清空，但保留 provider 设置
-    }
-}
-exports.ToolModule = ToolModule;
-//# sourceMappingURL=ToolModule.js.map

package/module/ToolModule/ToolModule.js.map

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

package/module/ToolModule/ToolRAG.d.ts

@@ -1,38 +0,0 @@
-/** 嵌入向量提供者接口 — 业务层可替换为真实 embedding 模型 */
-export interface IEmbeddingProvider {
-    /** 将文本转为向量 */
-    embed(text: string): Promise<Array<number>>;
-    /** 向量维度 */
-    readonly dims: number;
-}
-/**
- * 工具语义检索器
- *   默认使用关键词匹配(零依赖)，业务层可通过 setProvider() 替换为真实 embedding
- */
-export declare class ToolRAG {
-    private _provider;
-    private readonly _index;
-    /** 是否已加载真实 embedding 提供者 */
-    get hasProvider(): boolean;
-    /** 设置嵌入提供者(可选，不设则使用内置关键词匹配) */
-    setProvider(provider: IEmbeddingProvider): void;
-    /** 索引一个工具(注册时调用) */
-    index(name: string, description: string): Promise<void>;
-    /** 移除工具索引 */
-    remove(name: string): void;
-    /**
-     * 检索最相关的 Top-K 个工具名
-     * @param query      用户输入
-     * @param candidates 候选工具定义(name + description)
-     * @param topK       返回数量
-     */
-    search(query: string, candidates: Array<{
-        name: string;
-        description: string;
-    }>, topK?: number): Promise<Array<string>>;
-    /** 基于嵌入向量的语义检索 */
-    private _semanticSearch;
-    /** 内置关键词匹配(零依赖) */
-    private _keywordSearch;
-}
-//# sourceMappingURL=ToolRAG.d.ts.map

package/module/ToolModule/ToolRAG.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolRAG.d.ts","sourceRoot":"","sources":["../../../src/module/ToolModule/ToolRAG.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IAE/B,cAAc;IACd,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AASD;;;GAGG;AACH,qBAAa,OAAO;IAEhB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D,4BAA4B;IAC5B,IAAW,WAAW,IAAI,OAAO,CAAoC;IAErE,+BAA+B;IACxB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAOtD,oBAAoB;IACP,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE,aAAa;IACN,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC;;;;;OAKG;IACU,MAAM,CACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,EACxD,IAAI,GAAE,MAAW,GAClB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAWzB,kBAAkB;YACJ,eAAe;IAiB7B,mBAAmB;IACnB,OAAO,CAAC,cAAc;CA8BzB"}

package/module/ToolModule/ToolRAG.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolRAG = void 0;
-/**
- * 工具语义检索器
- *   默认使用关键词匹配(零依赖)，业务层可通过 setProvider() 替换为真实 embedding
- */
-class ToolRAG {
-    constructor() {
-        this._provider = null;
-        this._index = new Map();
-    }
-    /** 是否已加载真实 embedding 提供者 */
-    get hasProvider() { return this._provider !== null; }
-    /** 设置嵌入提供者(可选，不设则使用内置关键词匹配) */
-    setProvider(provider) {
-        this._provider = provider;
-        // 已有索引需要重建
-        this._index.clear();
-    }
-    /** 索引一个工具(注册时调用) */
-    async index(name, description) {
-        if (this._provider) {
-            const vector = await this._provider.embed(`${name}: ${description}`);
-            this._index.set(name, { name, vector });
-        }
-        // 关键词模式不需要索引，检索时实时计算
-        return Promise.resolve();
-    }
-    /** 移除工具索引 */
-    remove(name) {
-        this._index.delete(name);
-    }
-    /**
-     * 检索最相关的 Top-K 个工具名
-     * @param query      用户输入
-     * @param candidates 候选工具定义(name + description)
-     * @param topK       返回数量
-     */
-    async search(query, candidates, topK = 10) {
-        if (candidates.length <= topK) {
-            return candidates.map(c => c.name);
-        }
-        if (this._provider) {
-            return this._semanticSearch(query, candidates, topK);
-        }
-        return this._keywordSearch(query, candidates, topK);
-    }
-    /** 基于嵌入向量的语义检索 */
-    async _semanticSearch(query, candidates, topK) {
-        const queryVec = await this._provider.embed(query);
-        const scored = candidates.map(c => {
-            const entry = this._index.get(c.name);
-            const score = entry ? _cosineSimilarity(queryVec, entry.vector) : 0;
-            return { name: c.name, score };
-        });
-        scored.sort((a, b) => b.score - a.score);
-        return scored.slice(0, topK).map(s => s.name);
-    }
-    /** 内置关键词匹配(零依赖) */
-    _keywordSearch(query, candidates, topK) {
-        const keywords = _tokenize(query);
-        if (keywords.length === 0) {
-            return candidates.slice(0, topK).map(c => c.name);
-        }
-        const scored = candidates.map(c => {
-            const nameTokens = _tokenize(c.name);
-            const descTokens = _tokenize(c.description);
-            let score = 0;
-            for (const kw of keywords) {
-                for (const nt of nameTokens) {
-                    if (nt.includes(kw) || kw.includes(nt)) {
-                        score += 3;
-                    }
-                }
-                for (const dt of descTokens) {
-                    if (dt.includes(kw) || kw.includes(dt)) {
-                        score += 1;
-                    }
-                }
-            }
-            return { name: c.name, score };
-        });
-        scored.sort((a, b) => b.score - a.score);
-        return scored.filter(s => s.score > 0).slice(0, topK).map(s => s.name);
-    }
-}
-exports.ToolRAG = ToolRAG;
-/** 简易分词(中文按单字、英文按词) */
-function _tokenize(text) {
-    const tokens = [];
-    // 提取中文字符
-    const cjk = text.match(/[一-鿿㐀-䶿]+/g);
-    if (cjk) {
-        for (const seg of cjk) {
-            // 中文按 1-2 字滑动窗口
-            for (let i = 0; i < seg.length; i++) {
-                tokens.push(seg.substring(i, i + 2));
-            }
-        }
-    }
-    // 提取英文/数字词
-    const en = text.match(/[a-zA-Z0-9_]+/g);
-    if (en) {
-        for (const w of en) {
-            if (w.length > 1) {
-                tokens.push(w.toLowerCase());
-            }
-        }
-    }
-    return tokens;
-}
-/** 余弦相似度 */
-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 ? 0 : dot / denom;
-}
-//# sourceMappingURL=ToolRAG.js.map

package/module/ToolModule/ToolRAG.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolRAG.js","sourceRoot":"","sources":["../../../src/module/ToolModule/ToolRAG.ts"],"names":[],"mappings":";;;AAgBA;;;GAGG;AACH,MAAa,OAAO;IAApB;QAEY,cAAS,GAA8B,IAAI,CAAC;QACnC,WAAM,GAA4B,IAAI,GAAG,EAAE,CAAC;IAsGjE,CAAC;IApGG,4BAA4B;IAC5B,IAAW,WAAW,KAAc,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC;IAErE,+BAA+B;IACxB,WAAW,CAAC,QAA4B;QAE3C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,WAAW;QACX,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,oBAAoB;IACb,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,WAAmB;QAEhD,IAAI,IAAI,CAAC,SAAS,EAClB,CAAC;YACG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,WAAW,EAAE,CAAC,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,qBAAqB;QAErB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,aAAa;IACN,MAAM,CAAC,IAAY;QAEtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,MAAM,CACf,KAAa,EACb,UAAwD,EACxD,OAAe,EAAE;QAGjB,IAAI,UAAU,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YAAC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAEtE,IAAI,IAAI,CAAC,SAAS,EAClB,CAAC;YACG,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,kBAAkB;IACV,KAAK,CAAC,eAAe,CACzB,KAAa,EACb,UAAwD,EACxD,IAAY;QAGZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAE9B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,mBAAmB;IACX,cAAc,CAClB,KAAa,EACb,UAAwD,EACxD,IAAY;QAGZ,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAAC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAEjF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAE9B,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,KAAK,MAAM,EAAE,IAAI,QAAQ,EACzB,CAAC;gBACG,KAAK,MAAM,EAAE,IAAI,UAAU,EAC3B,CAAC;oBACG,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;wBAAC,KAAK,IAAI,CAAC,CAAC;oBAAC,CAAC;gBAC3D,CAAC;gBACD,KAAK,MAAM,EAAE,IAAI,UAAU,EAC3B,CAAC;oBACG,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;wBAAC,KAAK,IAAI,CAAC,CAAC;oBAAC,CAAC;gBAC3D,CAAC;YACL,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC;CACJ;AAzGD,0BAyGC;AAED,uBAAuB;AACvB,SAAS,SAAS,CAAC,IAAY;IAE3B,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,SAAS;IACT,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,GAAG,EACP,CAAC;QACG,KAAK,MAAM,GAAG,IAAI,GAAG,EACrB,CAAC;YACG,gBAAgB;YAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EACnC,CAAC;gBACG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;IACL,CAAC;IACD,WAAW;IACX,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACxC,IAAI,EAAE,EACN,CAAC;QACG,KAAK,MAAM,CAAC,IAAI,EAAE,EAClB,CAAC;YACG,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAAC,CAAC;QACvD,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,YAAY;AACZ,SAAS,iBAAiB,CAAC,CAAgB,EAAE,CAAgB;IAEzD,IAAI,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EACjC,CAAC;QACG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACzC,CAAC"}

package/module/ToolModule/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./ToolModule";
-export * from "./ToolRAG";
-//# sourceMappingURL=index.d.ts.map

package/module/ToolModule/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/module/ToolModule/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/module/ToolModule/index.js

@@ -1,19 +0,0 @@
-"use strict";
-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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./ToolModule"), exports);
-__exportStar(require("./ToolRAG"), exports);
-//# sourceMappingURL=index.js.map

package/module/ToolModule/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/module/ToolModule/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B"}