@fllf/agent-sdk 0.1.0

package/dist/rag/types.d.ts.map

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

package/dist/rag/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/rag/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rag/types.ts"],"names":[],"mappings":""}

package/dist/tools/base.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { ChatToolSchema } from '../llm/types';
+export type ToolInputSchema = z.ZodType;
+export type ToolInput<TSchema extends ToolInputSchema> = z.infer<TSchema>;
+export interface ToolOptions<TSchema extends ToolInputSchema> {
+    name: string;
+    description: string;
+    schema: TSchema;
+}
+export declare class ToolValidationError extends Error {
+    readonly toolName: string;
+    readonly issues: readonly z.core.$ZodIssue[];
+    constructor(toolName: string, error: z.ZodError);
+}
+export declare abstract class Tool<TSchema extends ToolInputSchema = ToolInputSchema, TResult = unknown> {
+    readonly name: string;
+    readonly description: string;
+    readonly schema: TSchema;
+    protected constructor(options: ToolOptions<TSchema>);
+    /**
+     * 模型返回的是未可信的 JSON 参数，进入具体工具前必须先通过 schema。
+     * 子类只实现 run(validatedInput)，不用重复写参数校验样板代码。
+     */
+    execute(parameters: unknown): Promise<TResult>;
+    toOpenAISchema(): ChatToolSchema;
+    protected abstract run(parameters: ToolInput<TSchema>): TResult | Promise<TResult>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/tools/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,OAAO,CAAC;AACxC,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAE1E,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,eAAe;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAEjC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ;CAMlD;AAED,8BAAsB,IAAI,CACtB,OAAO,SAAS,eAAe,GAAG,eAAe,EACjD,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,SAAS,aAAa,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;IAMnD;;;OAGG;IACG,OAAO,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IASpD,cAAc,IAAI,cAAc;IAYhC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CACrF"}

package/dist/tools/base.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tool = exports.ToolValidationError = void 0;
+const zod_1 = require("zod");
+class ToolValidationError extends Error {
+    toolName;
+    issues;
+    constructor(toolName, error) {
+        super(`Tool "${toolName}" received invalid parameters.`);
+        this.name = 'ToolValidationError';
+        this.toolName = toolName;
+        this.issues = error.issues;
+    }
+}
+exports.ToolValidationError = ToolValidationError;
+class Tool {
+    name;
+    description;
+    schema;
+    constructor(options) {
+        this.name = options.name;
+        this.description = options.description;
+        this.schema = options.schema;
+    }
+    /**
+     * 模型返回的是未可信的 JSON 参数，进入具体工具前必须先通过 schema。
+     * 子类只实现 run(validatedInput)，不用重复写参数校验样板代码。
+     */
+    async execute(parameters) {
+        const parsed = await this.schema.safeParseAsync(parameters);
+        if (!parsed.success) {
+            throw new ToolValidationError(this.name, parsed.error);
+        }
+        return await this.run(parsed.data);
+    }
+    toOpenAISchema() {
+        return {
+            type: 'function',
+            function: {
+                name: this.name,
+                description: this.description,
+                strict: true,
+                parameters: toStrictObjectSchema(this.schema),
+            },
+        };
+    }
+}
+exports.Tool = Tool;
+function toStrictObjectSchema(schema) {
+    const jsonSchema = zod_1.z.toJSONSchema(schema);
+    const normalizedSchema = stripUnsupportedJsonSchemaFields(jsonSchema);
+    // OpenAI function calling 的参数根节点必须是 object。
+    normalizedSchema.type = 'object';
+    normalizedSchema.properties = isRecord(normalizedSchema.properties)
+        ? normalizedSchema.properties
+        : {};
+    normalizedSchema.additionalProperties = false;
+    return normalizedSchema;
+}
+function stripUnsupportedJsonSchemaFields(schema) {
+    const result = { ...schema };
+    delete result.$schema;
+    return result;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=base.js.map

package/dist/tools/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/tools/base.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAYxB,MAAa,mBAAoB,SAAQ,KAAK;IACjC,QAAQ,CAAS;IACjB,MAAM,CAA8B;IAE7C,YAAY,QAAgB,EAAE,KAAiB;QAC3C,KAAK,CAAC,SAAS,QAAQ,gCAAgC,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC/B,CAAC;CACJ;AAVD,kDAUC;AAED,MAAsB,IAAI;IAIb,IAAI,CAAS;IACb,WAAW,CAAS;IACpB,MAAM,CAAU;IAEzB,YAAsB,OAA6B;QAC/C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,UAAmB;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,cAAc;QACV,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;aAChD;SACJ,CAAC;IACN,CAAC;CAGJ;AAxCD,oBAwCC;AAED,SAAS,oBAAoB,CAAC,MAAuB;IACjD,MAAM,UAAU,GAAG,OAAC,CAAC,YAAY,CAAC,MAAM,CAA4B,CAAC;IACrE,MAAM,gBAAgB,GAAG,gCAAgC,CAAC,UAAU,CAAC,CAAC;IAEtE,4CAA4C;IAC5C,gBAAgB,CAAC,IAAI,GAAG,QAAQ,CAAC;IACjC,gBAAgB,CAAC,UAAU,GAAG,QAAQ,CAAC,gBAAgB,CAAC,UAAU,CAAC;QAC/D,CAAC,CAAC,gBAAgB,CAAC,UAAU;QAC7B,CAAC,CAAC,EAAE,CAAC;IACT,gBAAgB,CAAC,oBAAoB,GAAG,KAAK,CAAC;IAE9C,OAAO,gBAAgB,CAAC;AAC5B,CAAC;AAED,SAAS,gCAAgC,CAAC,MAA+B;IACrE,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,OAAO,MAAM,CAAC,OAAO,CAAC;IAEtB,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC"}

package/dist/tools/builtin/advancedSearchTool.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { Tool } from '../base';
+declare const AdvancedSearchToolSchema: z.ZodObject<{
+    query: z.ZodString;
+}, z.core.$strip>;
+type AdvancedSearchToolInput = z.infer<typeof AdvancedSearchToolSchema>;
+export interface AdvancedSearchToolLogger {
+    info?(message: string): void;
+    warn?(message: string): void;
+}
+export interface AdvancedSearchToolOptions {
+    logger?: AdvancedSearchToolLogger;
+}
+export declare class AdvancedSearchTool extends Tool<typeof AdvancedSearchToolSchema> {
+    private readonly searchSources;
+    private readonly logger;
+    constructor(options?: AdvancedSearchToolOptions);
+    private setupSearchSources;
+    protected run({ query }: AdvancedSearchToolInput): Promise<string>;
+    private searchWithTavily;
+    private searchWithSerpApi;
+}
+export {};
+//# sourceMappingURL=advancedSearchTool.d.ts.map

package/dist/tools/builtin/advancedSearchTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advancedSearchTool.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/advancedSearchTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,QAAA,MAAM,wBAAwB;;iBAE5B,CAAC;AAEH,KAAK,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAkBxE,MAAM,WAAW,wBAAwB;IACrC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACtC,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACrC;AAED,qBAAa,kBAAmB,SAAQ,IAAI,CAAC,OAAO,wBAAwB,CAAC;IACzE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAElD,OAAO,GAAE,yBAA8B;IAWnD,OAAO,CAAC,kBAAkB;cAsBV,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;YA4B1D,gBAAgB;YAyChB,iBAAiB;CA4BlC"}

package/dist/tools/builtin/advancedSearchTool.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdvancedSearchTool = void 0;
+const zod_1 = require("zod");
+const base_1 = require("../base");
+const AdvancedSearchToolSchema = zod_1.z.object({
+    query: zod_1.z.string().trim().min(1).describe('需要搜索的关键词或问题'),
+});
+class AdvancedSearchTool extends base_1.Tool {
+    searchSources = [];
+    logger;
+    constructor(options = {}) {
+        super({
+            name: 'advanced_search',
+            description: '高级搜索工具，整合了 Tavily 和 SerpAPI 多个搜索源，提供更全面的搜索结果。遇到特定事实、新闻或知识盲区时使用。',
+            schema: AdvancedSearchToolSchema,
+        });
+        this.logger = options.logger;
+        this.setupSearchSources();
+    }
+    setupSearchSources() {
+        if (process.env.TAVILY_API_KEY) {
+            this.searchSources.push('tavily');
+            this.logger?.info?.('Tavily 搜索源已启用');
+        }
+        else {
+            this.logger?.info?.('Tavily API Key 未配置');
+        }
+        if (process.env.SERPAPI_API_KEY) {
+            this.searchSources.push('serpapi');
+            this.logger?.info?.('SerpApi 搜索源已启用');
+        }
+        else {
+            this.logger?.info?.('SerpApi API Key 未配置');
+        }
+        if (this.searchSources.length > 0) {
+            this.logger?.info?.(`可用搜索源: ${this.searchSources.join(', ')}`);
+        }
+        else {
+            this.logger?.warn?.('没有可用的搜索源，请配置 API 密钥');
+        }
+    }
+    async run({ query }) {
+        if (this.searchSources.length === 0) {
+            return '没有可用的搜索源，请配置 TAVILY_API_KEY 或 SERPAPI_API_KEY 环境变量';
+        }
+        this.logger?.info?.(`开始智能搜索: "${query}"`);
+        for (const source of this.searchSources) {
+            try {
+                if (source === 'tavily') {
+                    const result = await this.searchWithTavily(query);
+                    if (result && !result.includes('未找到')) {
+                        return `Tavily AI 搜索结果:\n\n${result}`;
+                    }
+                }
+                else if (source === 'serpapi') {
+                    const result = await this.searchWithSerpApi(query);
+                    if (result && !result.includes('未找到')) {
+                        return `SerpApi Google 搜索结果:\n\n${result}`;
+                    }
+                }
+            }
+            catch (error) {
+                this.logger?.warn?.(`${source} 搜索失败: ${formatError(error)}`);
+            }
+        }
+        return '所有搜索源都失败了，请检查网络连接和 API 密钥配置';
+    }
+    async searchWithTavily(query) {
+        const apiKey = process.env.TAVILY_API_KEY;
+        if (!apiKey) {
+            throw new Error('TAVILY_API_KEY 未配置');
+        }
+        const response = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                api_key: apiKey,
+                query,
+                search_depth: 'basic',
+                max_results: 3,
+                include_answer: true,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Tavily 请求失败, 状态码: ${response.status}`);
+        }
+        const data = await response.json();
+        let result = '';
+        const answer = toText(data.answer);
+        if (answer) {
+            result += `AI 直接答案: ${answer}\n\n`;
+        }
+        result += '相关结果:\n';
+        const results = Array.isArray(data.results) ? data.results : [];
+        results.slice(0, 3).forEach((item, index) => {
+            const title = toText(item.title) || '未命名结果';
+            const content = toText(item.content);
+            result += `[${index + 1}] ${title}\n    ${content.slice(0, 150)}...\n\n`;
+        });
+        return result.trim() || '未找到相关结果。';
+    }
+    async searchWithSerpApi(query) {
+        const apiKey = process.env.SERPAPI_API_KEY;
+        if (!apiKey) {
+            throw new Error('SERPAPI_API_KEY 未配置');
+        }
+        const url = new URL('https://serpapi.com/search.json');
+        url.searchParams.append('q', query);
+        url.searchParams.append('api_key', apiKey);
+        url.searchParams.append('num', '3');
+        const response = await fetch(url.toString());
+        if (!response.ok) {
+            throw new Error(`SerpApi 请求失败, 状态码: ${response.status}`);
+        }
+        const data = await response.json();
+        const organicResults = Array.isArray(data.organic_results) ? data.organic_results : [];
+        let result = 'Google 搜索结果:\n';
+        organicResults.slice(0, 3).forEach((item, index) => {
+            const title = toText(item.title) || '未命名结果';
+            const snippet = toText(item.snippet);
+            result += `[${index + 1}] ${title}\n    ${snippet}\n\n`;
+        });
+        return organicResults.length > 0 ? result.trim() : '未找到相关结果。';
+    }
+}
+exports.AdvancedSearchTool = AdvancedSearchTool;
+function toText(value) {
+    return typeof value === 'string' ? value : '';
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=advancedSearchTool.js.map

package/dist/tools/builtin/advancedSearchTool.js.map

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

package/dist/tools/builtin/ragSearchTool.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { RagPipeline, RetrievedChunk, RetrieveOptions } from '../../rag';
+import { Tool } from '../base';
+export declare const RagSearchToolSchema: z.ZodObject<{
+    query: z.ZodString;
+    topK: z.ZodOptional<z.ZodNumber>;
+    minScore: z.ZodOptional<z.ZodNumber>;
+    tenantId: z.ZodOptional<z.ZodString>;
+    knowledgeBaseId: z.ZodOptional<z.ZodString>;
+    acl: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    documentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadataFilter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type RagSearchToolInput = z.infer<typeof RagSearchToolSchema>;
+export interface RagSearchToolOptions {
+    pipeline: RagPipeline;
+    defaultRetrieveOptions?: Omit<RetrieveOptions, 'trace'>;
+    emptyMessage?: string;
+}
+export declare class RagSearchTool extends Tool<typeof RagSearchToolSchema, string> {
+    private readonly pipeline;
+    private readonly defaultRetrieveOptions;
+    private readonly emptyMessage;
+    constructor(options: RagSearchToolOptions);
+    protected run(input: RagSearchToolInput): Promise<string>;
+}
+export declare function formatRetrievedChunks(chunks: RetrievedChunk[], emptyMessage?: string): string;
+//# sourceMappingURL=ragSearchTool.d.ts.map

package/dist/tools/builtin/ragSearchTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ragSearchTool.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/ragSearchTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACR,WAAW,EACX,cAAc,EACd,eAAe,EAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,eAAO,MAAM,mBAAmB;;;;;;;;;;iBAU9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,WAAW,CAAC;IACtB,sBAAsB,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,aAAc,SAAQ,IAAI,CAAC,OAAO,mBAAmB,EAAE,MAAM,CAAC;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAiC;IACxE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,EAAE,oBAAoB;cAYzB,GAAG,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;CAQlE;AAED,wBAAgB,qBAAqB,CACjC,MAAM,EAAE,cAAc,EAAE,EACxB,YAAY,SAAgB,GAC7B,MAAM,CAQR"}

package/dist/tools/builtin/ragSearchTool.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RagSearchTool = exports.RagSearchToolSchema = void 0;
+exports.formatRetrievedChunks = formatRetrievedChunks;
+const zod_1 = require("zod");
+const base_1 = require("../base");
+exports.RagSearchToolSchema = zod_1.z.object({
+    query: zod_1.z.string().trim().min(1).describe('需要检索的知识库问题或关键词。'),
+    topK: zod_1.z.number().int().positive().optional().describe('最多返回的证据片段数量。'),
+    minScore: zod_1.z.number().optional().describe('最低相关性分数。'),
+    tenantId: zod_1.z.string().trim().min(1).optional().describe('租户 ID。'),
+    knowledgeBaseId: zod_1.z.string().trim().min(1).optional().describe('知识库 ID。'),
+    acl: zod_1.z.array(zod_1.z.string().trim().min(1)).optional().describe('调用者权限标签。'),
+    documentIds: zod_1.z.array(zod_1.z.string().trim().min(1)).optional().describe('限定检索的文档 ID。'),
+    sources: zod_1.z.array(zod_1.z.string().trim().min(1)).optional().describe('限定检索的来源路径或来源标识。'),
+    metadataFilter: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional().describe('元数据精确过滤条件。'),
+});
+class RagSearchTool extends base_1.Tool {
+    pipeline;
+    defaultRetrieveOptions;
+    emptyMessage;
+    constructor(options) {
+        super({
+            name: 'rag_search',
+            description: '检索知识库证据，返回可引用的资料片段。只返回证据，不直接生成最终答案。',
+            schema: exports.RagSearchToolSchema,
+        });
+        this.pipeline = options.pipeline;
+        this.defaultRetrieveOptions = options.defaultRetrieveOptions ?? {};
+        this.emptyMessage = options.emptyMessage ?? '未找到相关知识库证据。';
+    }
+    async run(input) {
+        const retrieved = await this.pipeline.retrieve(input.query, buildRetrieveOptions(this.defaultRetrieveOptions, input));
+        return formatRetrievedChunks(retrieved, this.emptyMessage);
+    }
+}
+exports.RagSearchTool = RagSearchTool;
+function formatRetrievedChunks(chunks, emptyMessage = '未找到相关知识库证据。') {
+    if (chunks.length === 0) {
+        return emptyMessage;
+    }
+    return chunks
+        .map((item, index) => formatRetrievedChunk(item, index + 1))
+        .join('\n\n');
+}
+function formatRetrievedChunk(item, index) {
+    const attributes = [
+        `source=${formatAttribute(item.chunk.metadata.source)}`,
+        `score=${formatScore(item.score)}`,
+    ];
+    if (item.chunk.metadata.title !== undefined) {
+        attributes.push(`title=${formatAttribute(item.chunk.metadata.title)}`);
+    }
+    if (item.chunk.metadata.headingPath !== undefined
+        && item.chunk.metadata.headingPath.length > 0) {
+        attributes.push(`section=${formatAttribute(item.chunk.metadata.headingPath.join(' > '))}`);
+    }
+    if (item.chunk.metadata.page !== undefined) {
+        attributes.push(`page=${item.chunk.metadata.page}`);
+    }
+    return `[${index}] ${attributes.join(' ')}\n${item.chunk.content.trim()}`;
+}
+function buildRetrieveOptions(defaults, input) {
+    const options = {
+        ...defaults,
+    };
+    assignIfDefined(options, 'topK', input.topK);
+    assignIfDefined(options, 'minScore', input.minScore);
+    assignIfDefined(options, 'tenantId', input.tenantId);
+    assignIfDefined(options, 'knowledgeBaseId', input.knowledgeBaseId);
+    assignIfDefined(options, 'acl', input.acl);
+    assignIfDefined(options, 'documentIds', input.documentIds);
+    assignIfDefined(options, 'sources', input.sources);
+    assignIfDefined(options, 'metadataFilter', input.metadataFilter);
+    return options;
+}
+function formatAttribute(value) {
+    if (/^[A-Za-z0-9_./:-]+$/.test(value)) {
+        return value;
+    }
+    return JSON.stringify(value);
+}
+function formatScore(score) {
+    return Number.isFinite(score) ? score.toFixed(4) : String(score);
+}
+function assignIfDefined(target, key, value) {
+    if (value !== undefined) {
+        target[key] = value;
+    }
+}
+//# sourceMappingURL=ragSearchTool.js.map

package/dist/tools/builtin/ragSearchTool.js.map

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

package/dist/tools/executor.d.ts

@@ -0,0 +1,10 @@
+import type { ChatToolCall } from '../llm/types';
+import type { TraceContext } from '../observability';
+import type { ToolRegistry } from './registry';
+export declare class ToolExecutor {
+    private readonly registry;
+    private readonly trace?;
+    constructor(registry: ToolRegistry, trace?: TraceContext | undefined);
+    execute(toolCall: ChatToolCall): Promise<string>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAKjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,YAAY;IAEjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBADN,QAAQ,EAAE,YAAY,EACtB,KAAK,CAAC,EAAE,YAAY,YAAA;IAGnC,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAuEzD"}

package/dist/tools/executor.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutor = void 0;
+const observability_1 = require("../observability");
+const base_1 = require("./base");
+class ToolExecutor {
+    registry;
+    trace;
+    constructor(registry, trace) {
+        this.registry = registry;
+        this.trace = trace;
+    }
+    async execute(toolCall) {
+        const startedAt = Date.now();
+        await (0, observability_1.emitRuntimeEvent)(this.trace?.observer, {
+            type: 'tool:start',
+            runId: this.trace?.runId ?? 'standalone',
+            timestamp: new Date(),
+            agentName: this.trace?.agentName,
+            sessionId: this.trace?.sessionId,
+            toolName: toolCall.name,
+            toolCallId: toolCall.id,
+        });
+        const tool = this.registry.get(toolCall.name);
+        if (!tool) {
+            await (0, observability_1.emitRuntimeEvent)(this.trace?.observer, {
+                type: 'tool:error',
+                runId: this.trace?.runId ?? 'standalone',
+                timestamp: new Date(),
+                durationMs: Date.now() - startedAt,
+                agentName: this.trace?.agentName,
+                sessionId: this.trace?.sessionId,
+                toolName: toolCall.name,
+                toolCallId: toolCall.id,
+                error: {
+                    name: 'ToolNotFoundError',
+                    message: `Tool "${toolCall.name}" is not registered.`,
+                },
+            });
+            return `Tool "${toolCall.name}" is not registered.`;
+        }
+        try {
+            const result = await tool.execute(toolCall.arguments);
+            const output = String(result);
+            await (0, observability_1.emitRuntimeEvent)(this.trace?.observer, {
+                type: 'tool:end',
+                runId: this.trace?.runId ?? 'standalone',
+                timestamp: new Date(),
+                durationMs: Date.now() - startedAt,
+                agentName: this.trace?.agentName,
+                sessionId: this.trace?.sessionId,
+                toolName: toolCall.name,
+                toolCallId: toolCall.id,
+                outputLength: output.length,
+            });
+            return output;
+        }
+        catch (error) {
+            await (0, observability_1.emitRuntimeEvent)(this.trace?.observer, {
+                type: 'tool:error',
+                runId: this.trace?.runId ?? 'standalone',
+                timestamp: new Date(),
+                durationMs: Date.now() - startedAt,
+                agentName: this.trace?.agentName,
+                sessionId: this.trace?.sessionId,
+                toolName: toolCall.name,
+                toolCallId: toolCall.id,
+                error: (0, observability_1.toObservedError)(error),
+            });
+            if (error instanceof base_1.ToolValidationError) {
+                return formatValidationError(error);
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            return `Tool "${toolCall.name}" failed: ${message}`;
+        }
+    }
+}
+exports.ToolExecutor = ToolExecutor;
+function formatValidationError(error) {
+    const details = error.issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : '<root>';
+        return `${path}: ${issue.message}`;
+    });
+    return `Tool "${error.toolName}" received invalid parameters: ${details.join('; ')}`;
+}
+//# sourceMappingURL=executor.js.map

package/dist/tools/executor.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,9 @@
+export { Tool, ToolValidationError } from './base';
+export { ToolExecutor } from './executor';
+export { ToolRegistry } from './registry';
+export { AdvancedSearchTool } from './builtin/advancedSearchTool';
+export { RagSearchTool, formatRetrievedChunks } from './builtin/ragSearchTool';
+export type { AdvancedSearchToolLogger, AdvancedSearchToolOptions, } from './builtin/advancedSearchTool';
+export type { RagSearchToolInput, RagSearchToolOptions, } from './builtin/ragSearchTool';
+export type { ToolInput, ToolInputSchema, ToolOptions } from './base';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EACR,wBAAwB,EACxB,yBAAyB,GAC5B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACR,kBAAkB,EAClB,oBAAoB,GACvB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatRetrievedChunks = exports.RagSearchTool = exports.AdvancedSearchTool = exports.ToolRegistry = exports.ToolExecutor = exports.ToolValidationError = exports.Tool = void 0;
+var base_1 = require("./base");
+Object.defineProperty(exports, "Tool", { enumerable: true, get: function () { return base_1.Tool; } });
+Object.defineProperty(exports, "ToolValidationError", { enumerable: true, get: function () { return base_1.ToolValidationError; } });
+var executor_1 = require("./executor");
+Object.defineProperty(exports, "ToolExecutor", { enumerable: true, get: function () { return executor_1.ToolExecutor; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_1.ToolRegistry; } });
+var advancedSearchTool_1 = require("./builtin/advancedSearchTool");
+Object.defineProperty(exports, "AdvancedSearchTool", { enumerable: true, get: function () { return advancedSearchTool_1.AdvancedSearchTool; } });
+var ragSearchTool_1 = require("./builtin/ragSearchTool");
+Object.defineProperty(exports, "RagSearchTool", { enumerable: true, get: function () { return ragSearchTool_1.RagSearchTool; } });
+Object.defineProperty(exports, "formatRetrievedChunks", { enumerable: true, get: function () { return ragSearchTool_1.formatRetrievedChunks; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA,+BAAmD;AAA1C,4FAAA,IAAI,OAAA;AAAE,2GAAA,mBAAmB,OAAA;AAClC,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AACrB,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AACrB,mEAAkE;AAAzD,wHAAA,kBAAkB,OAAA;AAC3B,yDAA+E;AAAtE,8GAAA,aAAa,OAAA;AAAE,sHAAA,qBAAqB,OAAA"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,16 @@
+import type { ChatToolSchema } from '../llm/types';
+import { Tool } from './base';
+export declare class ToolRegistry {
+    private readonly tools;
+    constructor(initialTools?: Tool[]);
+    register(tool: Tool): void;
+    get(name: string): Tool | undefined;
+    has(name: string): boolean;
+    list(): Tool[];
+    toOpenAISchemas(): ChatToolSchema[];
+    /**
+     * 这个描述主要用于非 function-calling 模型，或调试 prompt 时查看工具清单。
+     */
+    getToolsDescription(): string;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;gBAErC,YAAY,GAAE,IAAI,EAAO;IAMrC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,IAAI,EAAE;IAId,eAAe,IAAI,cAAc,EAAE;IAInC;;OAEG;IACH,mBAAmB,IAAI,MAAM;CAOhC"}