@dofe/infra-clients 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from './plugin';
+export * from './internal/agentx';
+export * from './internal/ai';
+export * from './internal/ai-provider';
+export * from './internal/crypt';
+export * from './internal/email';
+export * from './internal/exchange-rate';
+export * from './internal/file-cdn';
+export * from './internal/file-storage';
+export * from './internal/ip-info';
+export * from './internal/ocr';
+export * from './internal/openai';
+export * from './internal/openspeech';
+export * from './internal/sms';
+export * from './internal/sse';
+export * from './internal/third-party-sse';
+export * from './internal/verify';
+export * from './internal/volcengine-tts';
+export * from './internal/wechat';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+"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("./plugin"), exports);
+__exportStar(require("./internal/agentx"), exports);
+__exportStar(require("./internal/ai"), exports);
+__exportStar(require("./internal/ai-provider"), exports);
+__exportStar(require("./internal/crypt"), exports);
+__exportStar(require("./internal/email"), exports);
+__exportStar(require("./internal/exchange-rate"), exports);
+__exportStar(require("./internal/file-cdn"), exports);
+__exportStar(require("./internal/file-storage"), exports);
+__exportStar(require("./internal/ip-info"), exports);
+__exportStar(require("./internal/ocr"), exports);
+__exportStar(require("./internal/openai"), exports);
+__exportStar(require("./internal/openspeech"), exports);
+__exportStar(require("./internal/sms"), exports);
+__exportStar(require("./internal/sse"), exports);
+__exportStar(require("./internal/third-party-sse"), exports);
+__exportStar(require("./internal/verify"), exports);
+__exportStar(require("./internal/volcengine-tts"), exports);
+__exportStar(require("./internal/wechat"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,oDAAkC;AAClC,gDAA8B;AAC9B,yDAAuC;AACvC,mDAAiC;AACjC,mDAAiC;AACjC,2DAAyC;AACzC,sDAAoC;AACpC,0DAAwC;AACxC,qDAAmC;AACnC,iDAA+B;AAC/B,oDAAkC;AAClC,wDAAsC;AACtC,iDAA+B;AAC/B,iDAA+B;AAC/B,6DAA2C;AAC3C,oDAAkC;AAClC,4DAA0C;AAC1C,oDAAkC"}

package/dist/internal/agentx/agentx-client.module.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AgentX Client Module
+ *
+ * 提供与 Python AgentX API 交互的客户端服务
+ * - AgentXClient: 任务管理
+ * - AgentXFileClient: 文件上传
+ */
+export declare class AgentXClientModule {
+}
+//# sourceMappingURL=agentx-client.module.d.ts.map

package/dist/internal/agentx/agentx-client.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentx-client.module.d.ts","sourceRoot":"","sources":["../../../src/internal/agentx/agentx-client.module.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,qBAWa,kBAAkB;CAAG"}

package/dist/internal/agentx/agentx-client.module.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentXClientModule = void 0;
+const common_1 = require("@nestjs/common");
+const axios_1 = require("@nestjs/axios");
+const config_1 = require("@nestjs/config");
+const agentx_client_service_1 = require("./agentx-client.service");
+const agentx_file_client_service_1 = require("./agentx-file-client.service");
+/**
+ * AgentX Client Module
+ *
+ * 提供与 Python AgentX API 交互的客户端服务
+ * - AgentXClient: 任务管理
+ * - AgentXFileClient: 文件上传
+ */
+let AgentXClientModule = class AgentXClientModule {
+};
+exports.AgentXClientModule = AgentXClientModule;
+exports.AgentXClientModule = AgentXClientModule = __decorate([
+    (0, common_1.Module)({
+        imports: [
+            axios_1.HttpModule.register({
+                timeout: 30000, // 默认 30 秒超时
+                maxRedirects: 5,
+            }),
+            config_1.ConfigModule,
+        ],
+        providers: [agentx_client_service_1.AgentXClient, agentx_file_client_service_1.AgentXFileClient],
+        exports: [agentx_client_service_1.AgentXClient, agentx_file_client_service_1.AgentXFileClient],
+    })
+], AgentXClientModule);
+//# sourceMappingURL=agentx-client.module.js.map

package/dist/internal/agentx/agentx-client.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentx-client.module.js","sourceRoot":"","sources":["../../../src/internal/agentx/agentx-client.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,yCAA2C;AAC3C,2CAA8C;AAC9C,mEAAuD;AACvD,6EAAgE;AAEhE;;;;;;GAMG;AAYI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;CAAG,CAAA;AAArB,gDAAkB;6BAAlB,kBAAkB;IAX9B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE;YACP,kBAAU,CAAC,QAAQ,CAAC;gBAClB,OAAO,EAAE,KAAK,EAAE,YAAY;gBAC5B,YAAY,EAAE,CAAC;aAChB,CAAC;YACF,qBAAY;SACb;QACD,SAAS,EAAE,CAAC,oCAAY,EAAE,6CAAgB,CAAC;QAC3C,OAAO,EAAE,CAAC,oCAAY,EAAE,6CAAgB,CAAC;KAC1C,CAAC;GACW,kBAAkB,CAAG"}

package/dist/internal/agentx/agentx-client.service.d.ts

@@ -0,0 +1,570 @@
+import { OnModuleInit } from '@nestjs/common';
+import { Logger } from 'winston';
+import { HttpService } from '@nestjs/axios';
+import { ConfigService } from '@nestjs/config';
+import { z } from 'zod';
+import { CreateTaskRequest, TaskStatusResponse, CancelTaskResponse } from './interfaces/task.interface';
+export interface CollaborativeRecommendationRequest {
+    team_id: string;
+    user_id: string;
+    algorithm?: 'item-based' | 'user-based' | 'hybrid';
+    top_k?: number;
+    time_window_days?: number;
+    exclude_ids?: string[];
+    min_similarity?: number;
+    k_neighbors?: number;
+    item_weight?: number;
+    user_weight?: number;
+}
+export interface CollaborativeRecommendationItem {
+    knowledge_id: string;
+    title: string | null;
+    recommendation_score: number;
+    reason: string;
+    similarity_score: number;
+    matched_tags: string[] | null;
+}
+export interface CollaborativeRecommendationResponse {
+    user_id: string;
+    team_id: string;
+    algorithm: string;
+    recommendations: CollaborativeRecommendationItem[];
+    total: number;
+    execution_time_ms: number;
+    metadata: {
+        time_window_days: number;
+        excluded_count: number;
+    };
+}
+export interface GenerateProductKeywordsRequest {
+    productName: string;
+    productSellingPoints: string;
+}
+export interface LLMChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LLMChatCompletionRequest {
+    model: string;
+    messages: LLMChatMessage[];
+    stream?: boolean;
+    temperature?: number;
+    response_format?: {
+        type: 'json_object' | 'text';
+    };
+}
+export interface LLMChatCompletionResponse {
+    choices: Array<{
+        message: {
+            role: string;
+            content: string;
+        };
+        finish_reason: string;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * 图像生成请求 Schema
+ */
+export declare const ImageGenerationRequestSchema: z.ZodObject<{
+    model: z.ZodString;
+    prompt: z.ZodString;
+    n: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    response_format: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        url: "url";
+        b64_json: "b64_json";
+    }>>>;
+    aspect_ratio: z.ZodOptional<z.ZodString>;
+    image_size: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ImageGenerationRequest = z.infer<typeof ImageGenerationRequestSchema>;
+/**
+ * 图像编辑请求 Schema
+ */
+export declare const ImageEditRequestSchema: z.ZodObject<{
+    model: z.ZodString;
+    prompt: z.ZodString;
+    n: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    response_format: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        url: "url";
+        b64_json: "b64_json";
+    }>>>;
+    aspect_ratio: z.ZodOptional<z.ZodString>;
+    image_size: z.ZodOptional<z.ZodString>;
+    image: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ImageEditRequest = z.infer<typeof ImageEditRequestSchema>;
+/**
+ * 图像生成响应 Schema
+ */
+export declare const ImageGenerationResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        url: z.ZodOptional<z.ZodString>;
+        b64_json: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>;
+    created: z.ZodNumber;
+}, z.core.$strip>;
+export type ImageGenerationResponse = z.infer<typeof ImageGenerationResponseSchema>;
+/**
+ * AgentX Internal Client
+ *
+ * 封装所有与 Python AgentX API 的交互
+ * - 统一的 HTTP 请求处理
+ * - 统一的错误处理和重试机制
+ * - 统一的超时管理
+ * - 统一的 callback URL 管理
+ * - 协同过滤推荐
+ * - 健康检查
+ */
+export declare class AgentXClient implements OnModuleInit {
+    private readonly logger;
+    private readonly httpService;
+    private readonly configService;
+    private baseUrl;
+    private internalApiUrl;
+    private agentxConfig;
+    constructor(logger: Logger, httpService: HttpService, configService: ConfigService);
+    onModuleInit(): void;
+    /**
+     * 获取包含认证头的请求配置
+     */
+    private getAuthHeaders;
+    /**
+     * 创建 Python 任务
+     *
+     * @param request 创建任务请求参数
+     * @returns 任务 ID
+     */
+    createTask(request: CreateTaskRequest): Promise<string>;
+    /**
+     * 查询任务状态
+     *
+     * @param taskId 任务 ID
+     * @returns 任务状态信息
+     */
+    getTaskStatus(taskId: string): Promise<TaskStatusResponse>;
+    /**
+     * 取消任务
+     *
+     * @param taskId 任务 ID
+     * @returns 取消结果
+     */
+    cancelTask(taskId: string): Promise<CancelTaskResponse>;
+    /**
+     * 统一错误处理
+     *
+     * @param operation 操作名称
+     * @param error Axios 错误对象
+     * @param context 上下文信息
+     */
+    private handleError;
+    /**
+     * 提取错误消息
+     *
+     * @param error Axios 错误对象
+     * @returns 错误消息
+     */
+    private extractErrorMessage;
+    /**
+     * 通用 GET 请求
+     */
+    get<T = any>(url: string, config?: any): Promise<T>;
+    /**
+     * 通用 POST 请求
+     */
+    post<T = any>(url: string, data?: any, config?: any): Promise<T>;
+    /**
+     * 通用 PUT 请求
+     */
+    put<T = any>(url: string, data?: any, config?: any): Promise<T>;
+    /**
+     * 通用 DELETE 请求
+     */
+    delete<T = any>(url: string, config?: any): Promise<T>;
+    /**
+     * 检查 AgentX 服务是否可用
+     *
+     * @returns 是否可用
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * 健康检查（别名方法，兼容旧代码）
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * 生成协同过滤推荐
+     *
+     * @param request - 推荐请求参数
+     * @returns 推荐结果
+     * @throws 如果 AgentX 服务不可用或返回错误
+     */
+    generateCollaborativeRecommendations(request: CollaborativeRecommendationRequest): Promise<CollaborativeRecommendationResponse>;
+    /**
+     * 生成产品关键词
+     *
+     * @param request - 关键词生成请求参数
+     * @returns 关键词数组
+     * @throws 如果 AgentX 服务不可用或返回错误
+     */
+    generateProductKeywords(request: GenerateProductKeywordsRequest): Promise<string[]>;
+    /**
+     * LLM Chat Completion
+     *
+     * @param request - LLM 请求参数
+     * @returns LLM 响应
+     * @throws 如果 AgentX 服务不可用或返回错误
+     */
+    chatCompletion(request: LLMChatCompletionRequest): Promise<LLMChatCompletionResponse>;
+    /**
+     * 生成图像
+     *
+     * @param request - 图像生成请求参数
+     * @returns 图像生成响应
+     * @throws 如果 AgentX 服务不可用或返回错误
+     */
+    generateImage(request: ImageGenerationRequest): Promise<ImageGenerationResponse>;
+    /**
+     * 编辑图像
+     *
+     * @param request - 图像编辑请求参数
+     * @returns 图像生成响应
+     * @throws 如果 AgentX 服务不可用或返回错误
+     */
+    editImage(request: ImageEditRequest): Promise<ImageGenerationResponse>;
+    /**
+     * 创建对话记忆
+     */
+    createConversationMemory(request: {
+        user_id: string;
+        team_id: string;
+        session_id: string;
+        user_message: string;
+        agent_response: string;
+        intent?: string;
+        importance_score?: number;
+        metadata?: Record<string, any>;
+    }): Promise<{
+        memory_id: string;
+        message: string;
+        summary: string;
+        entities?: string[];
+        keywords?: string[];
+        indexed: boolean;
+        created_at: string;
+    }>;
+    /**
+     * 创建任务记忆
+     */
+    createTaskMemory(request: {
+        user_id: string;
+        team_id: string;
+        task_id: string;
+        task_name: string;
+        task_result: Record<string, any>;
+        success: boolean;
+        importance_score?: number;
+        metadata?: Record<string, any>;
+    }): Promise<{
+        memory_id: string;
+        message: string;
+        summary: string;
+        entities?: string[];
+        keywords?: string[];
+        indexed: boolean;
+        created_at: string;
+    }>;
+    /**
+     * 创建决策记忆
+     */
+    createDecisionMemory(request: {
+        user_id: string;
+        team_id: string;
+        decision_context: string;
+        decision_result: Record<string, any>;
+        workflow_id?: string;
+        importance_score?: number;
+        metadata?: Record<string, any>;
+    }): Promise<{
+        memory_id: string;
+        message: string;
+        summary: string;
+        entities?: string[];
+        keywords?: string[];
+        indexed: boolean;
+        created_at: string;
+    }>;
+    /**
+     * 搜索记忆 (GET)
+     */
+    searchMemories(params: {
+        q: string;
+        user_id: string;
+        team_id: string;
+        memory_types?: string;
+        top_k?: number;
+        min_score?: number;
+        time_decay?: boolean;
+    }): Promise<{
+        query: string;
+        results_count: number;
+        memories: Array<{
+            memory_id: string;
+            memory_type: string;
+            content: string;
+            summary: string;
+            entities?: string[];
+            keywords?: string[];
+            similarity_score: number;
+            importance_score: number;
+            final_score: number;
+            access_count: number;
+            session_id?: string;
+            created_at: string;
+            last_accessed_at?: string;
+        }>;
+    }>;
+    /**
+     * 搜索记忆 (POST - 复杂查询)
+     */
+    searchMemoriesPost(data: {
+        user_id: string;
+        team_id: string;
+        query: string;
+        memory_types?: string[];
+        session_id?: string;
+        top_k?: number;
+        min_score?: number;
+        time_decay?: boolean;
+        filters?: {
+            importanceMin?: number;
+            importanceMax?: number;
+            startDate?: string;
+            endDate?: string;
+            hasEntities?: string[];
+            hasKeywords?: string[];
+        };
+    }): Promise<{
+        query: string;
+        results_count: number;
+        memories: Array<{
+            memory_id: string;
+            memory_type: string;
+            content: string;
+            summary: string;
+            entities?: string[];
+            keywords?: string[];
+            similarity_score: number;
+            importance_score: number;
+            final_score: number;
+            access_count: number;
+            session_id?: string;
+            created_at: string;
+            last_accessed_at?: string;
+        }>;
+    }>;
+    /**
+     * 获取记忆详情
+     */
+    getMemoryById(memoryId: string): Promise<{
+        memory_id: string;
+        team_id: string;
+        user_id: string;
+        memory_type: string;
+        content: string;
+        summary: string;
+        entities?: string[];
+        keywords?: string[];
+        session_id?: string;
+        importance_score: number;
+        access_count: number;
+        decay_rate: number;
+        source: string;
+        metadata?: Record<string, any>;
+        indexed: boolean;
+        created_at: string;
+        last_accessed_at?: string;
+    }>;
+    /**
+     * 删除记忆
+     */
+    deleteMemory(memoryId: string): Promise<{
+        memory_id: string;
+        deleted: boolean;
+        message: string;
+    }>;
+    /**
+     * 获取记忆列表
+     */
+    listMemories(params: {
+        user_id: string;
+        team_id: string;
+        memory_types?: string;
+        session_id?: string;
+        page?: number;
+        page_size?: number;
+        sort_by?: string;
+        sort_order?: string;
+        start_date?: string;
+        end_date?: string;
+    }): Promise<{
+        total: number;
+        page: number;
+        page_size: number;
+        total_pages: number;
+        memories: Array<{
+            memory_id: string;
+            memory_type: string;
+            summary: string;
+            importance_score: number;
+            created_at: string;
+        }>;
+    }>;
+    /**
+     * 获取记忆统计
+     */
+    getMemoryStats(params: {
+        user_id: string;
+        team_id: string;
+        start_date?: string;
+        end_date?: string;
+    }): Promise<{
+        team_id: string;
+        user_id?: string;
+        total_memories: number;
+        by_type: Record<string, number>;
+        avg_importance_score: number;
+        totalAccessCount: number;
+        dateRange: {
+            start: string;
+            end: string;
+        };
+        recentActivity?: Array<{
+            date: string;
+            newMemories: number;
+            totalAccesses: number;
+        }>;
+    }>;
+    /**
+     * 获取会话历史
+     */
+    getSessionHistory(sessionId: string): Promise<{
+        session_id: string;
+        user_id: string;
+        total_messages: number;
+        messages: Array<{
+            memory_id: string;
+            user_message: string;
+            agent_response: string;
+            intent?: string;
+            created_at: string;
+        }>;
+        summary?: string;
+        created_at: string;
+        last_activity_at: string;
+    }>;
+    /**
+     * 推断用户偏好
+     */
+    inferPreference(request: {
+        user_id: string;
+        team_id: string;
+        category?: string;
+        preference_key: string;
+        preference_value: string;
+        confidence_score?: number;
+        context?: Record<string, any>;
+    }): Promise<{
+        preference_id: string;
+        created: boolean;
+        confidence_score: number;
+        use_count: number;
+    }>;
+    /**
+     * 获取用户偏好
+     */
+    getUserPreferences(params: {
+        user_id: string;
+        team_id: string;
+        category?: string;
+        min_confidence?: number;
+    }): Promise<{
+        user_id: string;
+        category?: string;
+        preferences: Record<string, string>;
+        preferences_details: Array<{
+            preference_id: string;
+            preference_key: string;
+            preference_value: string;
+            confidence_score: number;
+            explicit: boolean;
+            use_count: number;
+            last_used_at?: string;
+            created_at: string;
+        }>;
+    }>;
+    /**
+     * 更新用户偏好
+     */
+    updatePreference(preferenceId: string, data: {
+        user_id: string;
+        team_id: string;
+        preference_value?: string;
+        confidence_score?: number;
+        explicit?: boolean;
+    }): Promise<{
+        preference_id: string;
+        updated: boolean;
+        preference_value: string;
+        confidence_score: number;
+        explicit: boolean;
+    }>;
+    /**
+     * 删除用户偏好
+     */
+    deletePreference(preferenceId: string, params: {
+        user_id: string;
+        team_id: string;
+    }): Promise<{
+        preference_id: string;
+        deleted: boolean;
+    }>;
+    /**
+     * 获取偏好统计
+     */
+    getPreferenceStats(params: {
+        user_id: string;
+        team_id: string;
+    }): Promise<{
+        user_id: string;
+        total_preferences: number;
+        by_category: Record<string, number>;
+        explicit_preferences: number;
+        inferred_preferences: number;
+        avg_confidence_score: number;
+        most_used?: Array<{
+            category: string;
+            preference_key: string;
+            preference_value: string;
+            use_count: number;
+        }>;
+    }>;
+    /**
+     * 使用 SSE 监控任务进度
+     * @param taskId 任务ID
+     * @returns Promise that resolves when task completes
+     */
+    monitorTaskWithSSE(taskId: string): Promise<any>;
+    /**
+     * 轮询任务状态（SSE 失败时的降级方案）
+     */
+    private pollTaskStatus;
+    /**
+     * 睡眠函数
+     */
+    private sleep;
+}
+//# sourceMappingURL=agentx-client.service.d.ts.map