@jsonstudio/llms 0.4.2

package/dist/conversion/conversion-v3/types/config-types.d.ts

@@ -0,0 +1,242 @@
+/**
+ * 配置相关类型定义
+ */
+/**
+ * 配置类型枚举
+ */
+export declare enum ConfigType {
+    NODE = "node",
+    PIPELINE = "pipeline",
+    SYSTEM = "system",
+    USER = "user"
+}
+/**
+ * 配置验证规则
+ */
+export interface ConfigValidationRule {
+    /** 字段路径 */
+    path: string;
+    /** 验证类型 */
+    type: 'required' | 'type' | 'range' | 'enum' | 'custom';
+    /** 验证参数 */
+    params: {
+        /** 期望类型 */
+        expectedType?: string;
+        /** 最小值 */
+        min?: number;
+        /** 最大值 */
+        max?: number;
+        /** 枚举值 */
+        enum?: any[];
+        /** 自定义验证函数 */
+        validator?: (value: any) => boolean;
+    };
+    /** 错误消息 */
+    message: string;
+}
+/**
+ * 配置验证结果
+ */
+export interface ConfigValidationResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 错误列表 */
+    errors: ConfigValidationError[];
+    /** 警告列表 */
+    warnings: ConfigValidationWarning[];
+}
+/**
+ * 配置验证错误
+ */
+export interface ConfigValidationError {
+    /** 字段路径 */
+    path: string;
+    /** 错误消息 */
+    message: string;
+    /** 当前值 */
+    value?: any;
+    /** 错误代码 */
+    code: string;
+}
+/**
+ * 配置验证警告
+ */
+export interface ConfigValidationWarning {
+    /** 字段路径 */
+    path: string;
+    /** 警告消息 */
+    message: string;
+    /** 当前值 */
+    value?: any;
+    /** 警告代码 */
+    code: string;
+}
+/**
+ * 配置加载选项
+ */
+export interface ConfigLoadOptions {
+    /** 配置文件路径 */
+    configPath?: string;
+    /** 是否覆盖默认配置 */
+    overrideDefaults?: boolean;
+    /** 环境变量前缀 */
+    envPrefix?: string;
+    /** 是否启用配置缓存 */
+    enableCache?: boolean;
+    /** 配置文件格式 */
+    format?: 'json' | 'yaml' | 'js' | 'ts';
+}
+/**
+ * 已加载的配置
+ */
+export interface LoadedConfig {
+    /** 配置ID */
+    id: string;
+    /** 配置类型 */
+    type: ConfigType;
+    /** 配置数据 */
+    data: Record<string, unknown>;
+    /** 加载时间 */
+    loadedAt: number;
+    /** 配置来源 */
+    source: string;
+    /** 是否为缓存配置 */
+    cached: boolean;
+    /** 配置版本 */
+    version?: string;
+}
+/**
+ * 配置合并策略
+ */
+export interface ConfigMergeStrategy {
+    /** 合并类型 */
+    type: 'deep' | 'shallow' | 'replace' | 'merge';
+    /** 数组合并策略 */
+    arrayStrategy: 'replace' | 'append' | 'prepend' | 'merge';
+    /** 自定义合并函数 */
+    customMerger?: (target: any, source: any, path: string) => any;
+}
+/**
+ * 系统配置
+ */
+export interface SystemConfig {
+    /** 系统基本配置 */
+    basic: {
+        /** 系统名称 */
+        name: string;
+        /** 版本 */
+        version: string;
+        /** 环境 */
+        environment: 'development' | 'staging' | 'production';
+    };
+    /** 性能配置 */
+    performance: {
+        /** 最大并发数 */
+        maxConcurrency: number;
+        /** 默认超时时间 */
+        defaultTimeout: number;
+        /** 内存限制 */
+        memoryLimit: number;
+        /** 缓存配置 */
+        cache: {
+            /** 缓存大小 */
+            maxSize: number;
+            /** 过期时间 */
+            ttl: number;
+        };
+    };
+    /** 日志配置 */
+    logging: {
+        /** 日志级别 */
+        level: 'debug' | 'info' | 'warn' | 'error';
+        /** 是否启用详细日志 */
+        verbose: boolean;
+        /** 日志格式 */
+        format: 'json' | 'text';
+        /** 日志输出 */
+        outputs: string[];
+    };
+    /** 监控配置 */
+    monitoring: {
+        /** 是否启用监控 */
+        enabled: boolean;
+        /** 采样率 */
+        samplingRate: number;
+        /** 指标收集 */
+        metrics: {
+            performance: boolean;
+            errors: boolean;
+            usage: boolean;
+        };
+    };
+}
+/**
+ * 用户配置
+ */
+export interface UserConfig {
+    /** 用户自定义节点配置 */
+    nodes?: Record<string, any>;
+    /** 用户自定义流水线配置 */
+    pipelines?: Record<string, any>;
+    /** 功能开关 */
+    features?: {
+        [featureName: string]: boolean;
+    };
+    /** 端点映射 */
+    endpointMappings?: {
+        [endpoint: string]: string;
+    };
+    /** 规则覆盖 */
+    ruleOverrides?: {
+        [ruleName: string]: any;
+    };
+}
+/**
+ * 配置模板
+ */
+export interface ConfigTemplate {
+    /** 模板ID */
+    id: string;
+    /** 模板名称 */
+    name: string;
+    /** 模板描述 */
+    description?: string;
+    /** 模板类型 */
+    type: ConfigType;
+    /** 模板数据 */
+    template: Record<string, unknown>;
+    /** 默认值 */
+    defaults?: Record<string, unknown>;
+    /** 验证规则 */
+    validation?: ConfigValidationRule[];
+    /** 模板版本 */
+    version?: string;
+}
+/**
+ * 配置导出选项
+ */
+export interface ConfigExportOptions {
+    /** 导出格式 */
+    format: 'json' | 'yaml' | 'env';
+    /** 是否包含默认值 */
+    includeDefaults?: boolean;
+    /** 是否包含注释 */
+    includeComments?: boolean;
+    /** 是否美化输出 */
+    pretty?: boolean;
+    /** 字段过滤 */
+    filter?: string[];
+}
+/**
+ * 配置上下文
+ */
+export interface ConfigContext {
+    /** 当前环境 */
+    environment: string;
+    /** 配置加载时间 */
+    loadTime: number;
+    /** 配置来源 */
+    sources: string[];
+    /** 上下文数据 */
+    data: Record<string, unknown>;
+}

package/dist/conversion/conversion-v3/types/config-types.js

@@ -0,0 +1,13 @@
+/**
+ * 配置相关类型定义
+ */
+/**
+ * 配置类型枚举
+ */
+export var ConfigType;
+(function (ConfigType) {
+    ConfigType["NODE"] = "node";
+    ConfigType["PIPELINE"] = "pipeline";
+    ConfigType["SYSTEM"] = "system";
+    ConfigType["USER"] = "user";
+})(ConfigType || (ConfigType = {}));

package/dist/conversion/conversion-v3/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 类型定义统一导出
+ */
+export * from './node-types.js';
+export * from './pipeline-types.js';
+export * from './request-types.js';
+export * from './config-types.js';
+export type { PipelineResult as ConversionResult } from './pipeline-types.js';

package/dist/conversion/conversion-v3/types/index.js

@@ -0,0 +1,11 @@
+/**
+ * 类型定义统一导出
+ */
+// 节点相关类型
+export * from './node-types.js';
+// 流水线相关类型
+export * from './pipeline-types.js';
+// 请求响应相关类型
+export * from './request-types.js';
+// 配置相关类型
+export * from './config-types.js';

package/dist/conversion/conversion-v3/types/node-types.d.ts

@@ -0,0 +1,211 @@
+/**
+ * 节点相关类型定义
+ */
+import type { PipelineErrorCallbacks } from '../standards/errors.js';
+/**
+ * 节点类型枚举
+ */
+export declare enum NodeType {
+    INPUT = "input",
+    PROCESS = "process",
+    OUTPUT = "output"
+}
+/**
+ * 节点状态枚举
+ */
+export declare enum NodeStatus {
+    IDLE = "idle",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    SKIPPED = "skipped"
+}
+/**
+ * 节点配置接口
+ */
+export interface NodeConfig {
+    /** 节点唯一标识 */
+    id: string;
+    /** 节点类型 */
+    type: NodeType;
+    /** 节点名称 */
+    name: string;
+    /** 节点描述 */
+    description?: string;
+    /** 输入格式 */
+    inputFormat: string;
+    /** 输出格式 */
+    outputFormat: string;
+    /** 映射规则列表 */
+    rules: string[];
+    /** 验证配置 */
+    validation: {
+        strict: boolean;
+        required: string[];
+        optional: string[];
+    };
+    /** 性能配置 */
+    timeout: number;
+    retry?: RetryConfig;
+    /** 可选自定义配置 */
+    options?: Record<string, unknown>;
+    /** 快照配置 */
+    snapshot?: {
+        enabled?: boolean;
+        channel?: string;
+        label?: string;
+        metadata?: Record<string, unknown>;
+    };
+    /** 监控配置 */
+    monitoring?: MonitoringConfig;
+}
+/**
+ * 节点执行上下文
+ */
+export interface NodeContext {
+    /** 原始请求 */
+    request: ConversionRequest;
+    /** 节点间传递的数据 */
+    data: Record<string, unknown>;
+    /** 流水线状态信息 */
+    pipeline: {
+        /** 当前节点ID */
+        currentNode: string;
+        /** 前序节点结果 */
+        previousResults: NodeResult[];
+        /** 是否为 Passthrough 模式 */
+        isPassthrough: boolean;
+        /** 流水线开始时间 */
+        startTime: number;
+        /** 原始请求载荷（用于 passthrough） */
+        originalPayload?: Record<string, unknown>;
+    };
+    /** 节点配置 */
+    nodeConfig: NodeConfig;
+    /** 错误/告警回调 */
+    callbacks?: PipelineErrorCallbacks | null;
+}
+/**
+ * 节点执行结果
+ */
+export interface NodeResult {
+    /** 是否执行成功 */
+    success: boolean;
+    /** 节点输出数据 */
+    data?: Record<string, unknown>;
+    /** 错误信息 */
+    error?: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    };
+    /** 执行元数据 */
+    metadata: {
+        /** 节点ID */
+        node: string;
+        /** 执行耗时 */
+        executionTime: number;
+        /** 开始时间 */
+        startTime: number;
+        /** 结束时间 */
+        endTime: number;
+        /** 处理的数据量 */
+        dataProcessed?: {
+            messages?: number;
+            tools?: number;
+            tokens?: number;
+            /** 可选：输出大小（字符/字节） */
+            responseSize?: number;
+        };
+    };
+}
+/**
+ * 重试配置
+ */
+export interface RetryConfig {
+    /** 最大重试次数 */
+    maxRetries: number;
+    /** 重试间隔（毫秒） */
+    retryDelay: number;
+    /** 指数退避 */
+    exponentialBackoff: boolean;
+    /** 可重试的错误类型 */
+    retryableErrors: string[];
+}
+/**
+ * 监控配置
+ */
+export interface MonitoringConfig {
+    /** 是否启用监控 */
+    enabled: boolean;
+    /** 是否记录详细日志 */
+    detailedLogging: boolean;
+    /** 性能采样率 */
+    performanceSampling: number;
+    /** 自定义指标 */
+    customMetrics: string[];
+}
+/**
+ * 流水线节点接口
+ */
+export interface PipelineNode {
+    /** 节点唯一标识 */
+    readonly id: string;
+    /** 节点类型 */
+    readonly type: NodeType;
+    /** 节点名称 */
+    readonly name: string;
+    /** 节点配置 */
+    config: NodeConfig;
+    /** 节点状态 */
+    status: NodeStatus;
+    /**
+     * 执行节点逻辑
+     *
+     * @param context 执行上下文
+     * @returns 执行结果
+     */
+    execute(context: NodeContext): Promise<NodeResult>;
+    /**
+     * 验证输入数据
+     *
+     * @param data 输入数据
+     * @returns 验证结果
+     */
+    validate(data: Record<string, unknown>): ValidationResult;
+    /**
+     * 清理资源
+     */
+    cleanup?(): Promise<void>;
+}
+/**
+ * 验证结果
+ */
+export interface ValidationResult {
+    /** 是否验证通过 */
+    valid: boolean;
+    /** 错误信息 */
+    errors: ValidationError[];
+    /** 警告信息 */
+    warnings: ValidationWarning[];
+}
+/**
+ * 验证错误
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    code: string;
+    value?: unknown;
+}
+/**
+ * 验证警告
+ */
+export interface ValidationWarning {
+    field: string;
+    message: string;
+    code: string;
+    value?: unknown;
+}
+import type { ConversionRequest } from './request-types.js';

package/dist/conversion/conversion-v3/types/node-types.js

@@ -0,0 +1,20 @@
+/**
+ * 节点类型枚举
+ */
+export var NodeType;
+(function (NodeType) {
+    NodeType["INPUT"] = "input";
+    NodeType["PROCESS"] = "process";
+    NodeType["OUTPUT"] = "output";
+})(NodeType || (NodeType = {}));
+/**
+ * 节点状态枚举
+ */
+export var NodeStatus;
+(function (NodeStatus) {
+    NodeStatus["IDLE"] = "idle";
+    NodeStatus["RUNNING"] = "running";
+    NodeStatus["COMPLETED"] = "completed";
+    NodeStatus["FAILED"] = "failed";
+    NodeStatus["SKIPPED"] = "skipped";
+})(NodeStatus || (NodeStatus = {}));