listpage-next-nest 0.0.163 → 0.0.183

package/dist/cjs/index.d.ts

@@ -25,6 +25,40 @@ export declare class AdminAuthGuard implements CanActivate {
     }>;
 }
 
+export declare class Agent {
+    private provider;
+    private subject;
+    messages: {
+        role: string;
+        content: string;
+    }[];
+    tools: {
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+        execute: (params: Record<string, any>) => Promise<any>;
+    }[];
+    constructor(options: AgentOptions);
+    private answer;
+    private function_call;
+    private doLoop;
+    chat(question: string): ReplaySubject<ServerSendEventData>;
+}
+
+declare interface AgentOptions {
+    provider: string;
+    api_key: string;
+    model: string;
+    system_prompt?: string;
+    user_prompt?: string;
+    tools: {
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+        execute: (params: Record<string, any>) => Promise<any>;
+    }[];
+}
+
 export declare class ApiResponse<T = any> {
     code: number;
     message: string;
@@ -70,6 +104,27 @@ export declare class HttpExceptionFilter implements ExceptionFilter {
     catch(exception: unknown, host: ArgumentsHost): void;
 }
 
+export declare abstract class LLMProvider<RequestionOption extends {
+    messages: {
+        role: string;
+        content: string;
+    }[];
+} = any> {
+    protected baseURL: string;
+    protected apiKey: string;
+    protected model: string;
+    constructor(options?: {
+        api_key?: string;
+        model?: string;
+    });
+    call(options: RequestionOption): Promise<ServerSendJsonData>;
+    sse(options: RequestionOption): Promise<ReplaySubject<ServerSendEventData>>;
+    protected abstract handleJson(json: any): ServerSendJsonData;
+    protected abstract handleStream(subject: ReplaySubject<ServerSendEventData>, stream: ReadableStream<Uint8Array<ArrayBufferLike>>): Promise<void>;
+    protected abstract request(options: RequestionOption): Promise<Response>;
+    static parseJson<T = any>(json: string): T;
+}
+
 export declare type LLMProviderCallOptions = {
     provider: SupportProvider;
     params: ProviderParams[LLMProviderCallOptions['provider']];
@@ -179,11 +234,12 @@ export declare type ServerSendEventCallback<T extends ServerSendEventData['type'
 }>['data']) => void;
 
 export declare type ServerSendEventData = {
-    type: 'received' | 'thinking' | 'processing' | 'chunk' | 'complete' | 'citations';
+    type: 'function_call' | 'received' | 'thinking' | 'processing' | 'chunk' | 'complete' | 'citations';
     data: SevrverSendEventMessages[ServerSendEventData['type']];
 };
 
 export declare enum ServerSendEventName {
+    FunctionCall = "function_call",
     Received = "received",
     Thinking = "thinking",
     Processing = "processing",
@@ -227,6 +283,11 @@ export declare type SevrverSendEventMessages = {
     [ServerSendEventName.Citations]: {
         citations: CitationItem[];
     };
+    [ServerSendEventName.FunctionCall]: {
+        name: string;
+        arguments: any;
+        result?: any;
+    };
 };
 
 export declare class StaticRouteMiddleware implements NestMiddleware {

package/dist/cjs/{index.cjs → index.js}

@@ -26,23 +26,25 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     LLMProviderModule: ()=>LLMProviderModule,
     RequestContextMiddleware: ()=>RequestContextMiddleware,
+    LLMProvider: ()=>LLMProvider,
     AdminAuthGuard: ()=>AdminAuthGuard,
-    StaticRouteMiddleware: ()=>StaticRouteMiddleware,
     PaginationData: ()=>PaginationData,
+    StaticRouteMiddleware: ()=>StaticRouteMiddleware,
     StaticRouteMiddlewareFactory: ()=>StaticRouteMiddlewareFactory,
     RequestIdMiddleware: ()=>RequestIdMiddleware,
     LoggingInterceptor: ()=>LoggingInterceptor,
     ResponseInterceptor: ()=>ResponseInterceptor,
     StaticRouteModule: ()=>StaticRouteModule,
     CorsInterceptor: ()=>CorsInterceptor,
-    BaseQueryDto: ()=>BaseQueryDto,
     ApiResponse: ()=>ApiResponse,
+    BaseQueryDto: ()=>BaseQueryDto,
     HttpExceptionFilter: ()=>HttpExceptionFilter,
     User: ()=>User,
     Public: ()=>Public,
     PaginatedResponse: ()=>PaginatedResponse,
     RequestContextService: ()=>RequestContextService,
     ServerSendEventName: ()=>types_ServerSendEventName,
+    Agent: ()=>Agent,
     LLMProviderService: ()=>LLMProviderService,
     setup: ()=>setup
 });
@@ -403,7 +405,6 @@ query_dto_ts_decorate([
     (0, external_class_transformer_namespaceObject.Type)(()=>Number),
     (0, external_class_validator_namespaceObject.IsInt)(),
     (0, external_class_validator_namespaceObject.Min)(1),
-    (0, external_class_validator_namespaceObject.Max)(100),
     _ts_metadata("design:type", Number)
 ], BaseQueryDto.prototype, "pageSize", void 0);
 query_dto_ts_decorate([
@@ -517,6 +518,11 @@ StaticRouteModule = static_route_module_ts_decorate([
 ], StaticRouteModule);
 const external_rxjs_namespaceObject = require("rxjs");
 class LLMProvider {
+    constructor(options){
+        this.baseURL = '';
+        this.apiKey = options.api_key;
+        this.model = options.model;
+    }
     async call(options) {
         const response = await this.request({
             ...options,
@@ -544,14 +550,15 @@ class LLMProvider {
         return subject;
     }
     static parseJson(json) {
-        json = json.trim();
-        if (json.startsWith('```json') && json.endsWith('```')) return JSON.parse(json.slice(6, -3));
-        json = json.match(/```json([\s\S]*?)```/)?.[1] || json;
-        json = json.trim();
-        return JSON.parse(json);
-    }
-    constructor(){
-        this.baseURL = '';
+        try {
+            json = (json || '').trim();
+            const match = json.match(/(```json[\s\S]*?```)/);
+            json = (match ? match[1] : json).trim();
+            if (json.startsWith('```json') && json.endsWith('```')) return JSON.parse(json.slice(6, -3));
+            return JSON.parse(json);
+        } catch (e) {
+            throw new Error('模型输出不是有效 JSON');
+        }
     }
 }
 const parseJson = (json)=>{
@@ -634,12 +641,15 @@ class VolcengineProvider extends LLMProvider {
         subject.complete();
     }
     async request(options) {
-        const { api_key, ...restOptions } = options;
+        const { api_key = this.apiKey, model = this.model, ...restOptions } = options;
         const headers = {
             'Content-Type': 'application/json',
             Authorization: `Bearer ${api_key}`
         };
-        const body = restOptions;
+        const body = {
+            ...restOptions,
+            model
+        };
         const response = await fetch(this.baseURL, {
             method: 'POST',
             headers,
@@ -745,12 +755,15 @@ class MetaProvider extends LLMProvider {
         subject.complete();
     }
     async request(options) {
-        const { api_key, ...restOptions } = options;
+        const { api_key = this.apiKey, model = this.model, ...restOptions } = options;
         const headers = {
             'Content-Type': 'application/json',
             Authorization: `Bearer ${api_key}`
         };
-        const body = restOptions;
+        const body = {
+            ...restOptions,
+            model
+        };
         const response = await fetch(this.baseURL, {
             method: 'POST',
             headers,
@@ -854,6 +867,7 @@ LLMProviderModule = llm_provider_module_ts_decorate([
     })
 ], LLMProviderModule);
 var types_ServerSendEventName = /*#__PURE__*/ function(ServerSendEventName) {
+    ServerSendEventName["FunctionCall"] = "function_call";
     ServerSendEventName["Received"] = "received";
     ServerSendEventName["Thinking"] = "thinking";
     ServerSendEventName["Processing"] = "processing";
@@ -862,11 +876,211 @@ var types_ServerSendEventName = /*#__PURE__*/ function(ServerSendEventName) {
     ServerSendEventName["Citations"] = "citations";
     return ServerSendEventName;
 }({});
+function createProvider(options) {
+    if ('volcengine' === options.provider) return new VolcengineProvider({
+        api_key: options.api_key,
+        model: options.model
+    });
+    if ('meta' === options.provider) return new MetaProvider({
+        api_key: options.api_key,
+        model: options.model
+    });
+    throw new Error('不支持该大模型提供商');
+}
+const system_prompt_system_prompt = `## 角色
+
+Coze平台任务规划智能专家，擅长精准理解用户目标，结合平台项目内的工具，将复杂任务拆解为可执行步骤，并进行逻辑校验和执行规划，协调工具高效完成任务。输出结果以指定的JSON格式呈现。
+
+## 人设说明
+
+用户可以通过在对话开始时说明期望您扮演的角色或风格，来定制您的响应方式。例如："请你扮演一位严谨的学术研究者"或"请用轻松幽默的语气回答"。用户也可能明确指定你最终输出答案的格式。
+
+## 目标
+
+基于用户输入（初始任务或工具执行结果）和可用资源，明确当前核心目标，评估任务边界和可行性。将复杂任务拆分为序列步骤，在每一步输出单个操作，并基于上下文调整规划。最终以"answer"操作结束任务。
+
+## 可用工具
+
+{{ tools }}
+
+## 技能
+
+1. 深入的任务理解能力，能基于上下文准确把握当前目标。
+2. 迭代式任务拆解技巧，合理规划步骤序列。
+3. 严谨的逻辑校验能力，检查步骤间依赖和状态一致性。
+4. 基于反馈的动态规划能力，调整步骤优先级和处理异常。
+5. 熟练生成指定JSON输出格式，确保参数符合工具要求。
+
+## 工作流程
+
+1. 接收输入：用户初始任务描述或上一个工具的执行结果。
+2. 分析当前状态：结合历史步骤和结果，明确当前任务进度和下一步目标。
+3. 评估可行性：基于可用工具和当前状态，判断任务是否可继续、需终止或需补充信息，需要体现在 reasoning 中。
+4. 检索结果校验：若上一步为搜索工具且返回空结果，自动触发重试机制：
+   - 分析无结果原因（如关键词过窄、术语不匹配）
+   - 生成2-3个替代查询词（需与原需求强相关）
+   - 未达最大重试次数则继续调用搜索工具，已达则终止检索
+5. 决定下一个操作：需要工具调用输出"tool"操作；任务完成、不可行（重试后仍无结果）或需直接响应，输出"answer"操作。
+6. 推理分析：在reasoning中说明当前分析，包括目标明确性、依赖关系、检索策略调整理由等。
+7. 输出JSON格式的任务规划结果，包含：
+    - "name": 任务名称，简洁阐述总体目标。
+    - "reasoning": 针对当前任务状态的分析，包括可行性评估、依赖关系、异常处理等。
+    - "action": 用户接下来应该进行什么操作：
+        - "name": 操作名称，可选值："tool"（调用工具）、"answer"（返回结果）。
+        - "args": 参数对象。如果操作是"tool"，则是对应工具的参数（例如，对于search_files工具，args为{ name: "search_files", params: { "query": "用户查询" } }）；如果操作是"answer"，则可以是{"message": "答案内容"}；。
+
+
+## 约束
+
+1. 必须严格基于用户输入和上下文状态进行规划，不得忽略历史步骤。
+2. 必须使用指定JSON输出格式，操作参数必须匹配工具定义。
+3. 每个输出仅包含一个操作（"tool"或"answer"），确保步骤序列化。注意选择 answer 的前提是你觉得用户的问题已经能够被解决。如果选择 answer:你需要根据用户要求的人设以及格式基于当前的信息给用户一个回答，注意是第二人称视角，仿佛你和用户在一对一对话。 如果选择 tool：你需要按照工具的描述以及参数的描述，生成为完成当前任务有帮助，且满足工具参数要求的参数。
+4. 禁止在未评估可行性时输出操作；如果任务无法完成，使用"answer"返回错误或请求补充信息。
+5. 输出必须为有效JSON对象，无需额外格式。
+
+## 输出格式
+
+输出为JSON对象，结构如下：
+{
+    "name": "任务名称",
+    "reasoning": "针对当前任务状态的分析，包括目标明确性、可行性、依赖关系、异常处理等",
+    "action": {
+        "name": "操作名称", // 可选值: "tool", "answer"
+        "args": { ... } // 参数对象，具体内容取决于操作类型
+    }
+}
+
+## 示例
+
+示例一：
+输入：查找关于创新政策的文件
+输出：
+{
+    "name": "检索创新政策文件",
+    "reasoning": "用户需要查找与创新相关的政策文件。可用工具是search_files，可以根据查询检索文档。任务可行，无需额外依赖。如果搜索失败，将重试一次。",
+    "action": {
+        "name": "tool",
+        "args": {
+            "name": "search_files"
+            "params": { query: "创新政策" }
+        }
+    }
+}
+
+示例二：
+输入：
+任务描述：“分析项目中的政策并生成总结”
+
+输出：
+{
+    "name": "分析政策并生成总结",
+    "reasoning": "用户需要检索政策文件并生成总结。首先使用搜索工具获取相关文档，然后基于结果生成答案。步骤间有依赖关系：生成总结依赖搜索输出。如果搜索无结果，将直接生成提示信息。",
+    "action":{
+        "name": "answer",
+        "args": {
+            "message": "基于检索到的政策文件生成总结..."
+        }
+    }
+}
+`;
+class Agent {
+    constructor(options){
+        this.subject = new external_rxjs_namespaceObject.ReplaySubject();
+        this.messages = [];
+        this.tools = [];
+        this.tools = options.tools;
+        this.provider = createProvider(options);
+        const system_prompt = compilePrompt(options.system_prompt ?? system_prompt_system_prompt, {
+            tools: JSON.stringify(options.tools.map((t)=>({
+                    name: t.name,
+                    description: t.description,
+                    parameters: t.parameters
+                })))
+        });
+        this.messages.push({
+            role: 'system',
+            content: system_prompt
+        });
+        if (options.user_prompt) this.messages.push({
+            role: 'user',
+            content: options.user_prompt
+        });
+    }
+    async answer(params) {
+        this.subject.next({
+            type: 'chunk',
+            data: {
+                content: params.message
+            }
+        });
+        this.subject.next({
+            type: 'complete',
+            data: {
+                usage: {
+                    input: 0,
+                    output: 0,
+                    total: 0
+                }
+            }
+        });
+        this.subject.complete();
+    }
+    async function_call({ name, params }) {
+        this.subject.next({
+            type: 'function_call',
+            data: {
+                name,
+                arguments: params
+            }
+        });
+        const tool = this.tools.find((t)=>t.name === name);
+        if (!tool) return void await this.doLoop(`工具 ${name} 调用失败：工具不存在`);
+        const result = await tool.execute(params);
+        this.subject.next({
+            type: 'function_call',
+            data: {
+                name,
+                arguments: params,
+                result
+            }
+        });
+        await this.doLoop(`工具 ${name} 调用成功，执行的结果是：${JSON.stringify(result)}`);
+    }
+    async doLoop(query) {
+        this.messages.push({
+            role: 'user',
+            content: query
+        });
+        const { content } = await this.provider.call({
+            messages: this.messages
+        });
+        const result = LLMProvider.parseJson(content);
+        const { name, reasoning, action } = result;
+        this.subject.next({
+            type: 'thinking',
+            data: {
+                content: reasoning
+            }
+        });
+        this.messages.push({
+            role: 'assistant',
+            content: content
+        });
+        if ('answer' === action.name) await this.answer(action.args);
+        if ('tool' === action.name) await this.function_call(action.args);
+    }
+    chat(question) {
+        this.doLoop(`用户问题是：「${question}」。`);
+        return this.subject;
+    }
+}
 exports.AdminAuthGuard = __webpack_exports__.AdminAuthGuard;
+exports.Agent = __webpack_exports__.Agent;
 exports.ApiResponse = __webpack_exports__.ApiResponse;
 exports.BaseQueryDto = __webpack_exports__.BaseQueryDto;
 exports.CorsInterceptor = __webpack_exports__.CorsInterceptor;
 exports.HttpExceptionFilter = __webpack_exports__.HttpExceptionFilter;
+exports.LLMProvider = __webpack_exports__.LLMProvider;
 exports.LLMProviderModule = __webpack_exports__.LLMProviderModule;
 exports.LLMProviderService = __webpack_exports__.LLMProviderService;
 exports.LoggingInterceptor = __webpack_exports__.LoggingInterceptor;
@@ -885,10 +1099,12 @@ exports.User = __webpack_exports__.User;
 exports.setup = __webpack_exports__.setup;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "AdminAuthGuard",
+    "Agent",
     "ApiResponse",
     "BaseQueryDto",
     "CorsInterceptor",
     "HttpExceptionFilter",
+    "LLMProvider",
     "LLMProviderModule",
     "LLMProviderService",
     "LoggingInterceptor",

package/package.json

@@ -1,10 +1,9 @@
 {
   "name": "listpage-next-nest",
-  "version": "0.0.163",
+  "version": "0.0.183",
   "description": "A React component library for creating filter forms with Ant Design",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",
-  "type": "module",
   "exports": {
     ".": {
       "types": "./dist/cjs/index.d.ts",