@agenticc/core 1.0.0

package/dist/llm/manager.js

@@ -0,0 +1,337 @@
+/**
+ * LLM Manager
+ *
+ * Manages multiple LLM adapters and routes tasks to the appropriate LLM.
+ * Supports single LLM mode (all tasks use one LLM) and multi-LLM mode
+ * (different LLMs for different task types).
+ */
+import { LLMError } from './adapter.js';
+import { getLLMConfigForTask } from '../types/config.js';
+import { OpenAIAdapter } from './adapters/openai.js';
+import { ClaudeAdapter } from './adapters/claude.js';
+import { QwenAdapter } from './adapters/qwen.js';
+import { SiliconFlowAdapter } from './adapters/siliconflow.js';
+import { MiMoAdapter } from './adapters/mimo.js';
+import { AnyRouterAdapter } from './adapters/anyrouter.js';
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 10000,
+};
+/**
+ * LLM Manager
+ *
+ * Provides a unified interface for working with multiple LLM providers.
+ */
+export class LLMManager {
+    config;
+    adapters = new Map();
+    retryConfig;
+    constructor(config) {
+        this.config = config;
+        this.retryConfig = config.retry ?? DEFAULT_RETRY_CONFIG;
+        // Pre-create adapters for configured LLMs
+        this.initializeAdapters();
+    }
+    /**
+     * Get the LLM adapter for a specific task
+     */
+    getLLMForTask(task) {
+        const providerConfig = getLLMConfigForTask(this.config, task);
+        return this.getOrCreateAdapter(providerConfig);
+    }
+    /**
+     * Generate text for a specific task
+     */
+    async generate(task, prompt, options) {
+        return this.executeWithRetry(task, async (adapter) => adapter.generate(prompt, options), options?.abortSignal);
+    }
+    /**
+     * Generate text with tool calling for a specific task
+     */
+    async generateWithTools(task, prompt, tools, options) {
+        return this.executeWithRetry(task, async (adapter) => adapter.generateWithTools(prompt, tools, options), options?.abortSignal);
+    }
+    /**
+     * Generate text with tool calling for a specific task (streaming)
+     *
+     * Note: Streaming does not support automatic retry since we can't replay the stream.
+     * If you need retry behavior, use the non-streaming version.
+     */
+    async generateWithToolsStream(task, prompt, tools, onChunk, options) {
+        // Check if already aborted before starting
+        if (options?.abortSignal?.aborted) {
+            const adapter = this.getLLMForTask(task);
+            throw new LLMError('Operation cancelled', 'CANCELLED', adapter.provider);
+        }
+        const adapter = this.getLLMForTask(task);
+        // Check if adapter supports streaming
+        if (!adapter.supportsStreaming()) {
+            // Fall back to non-streaming and send a single chunk at the end
+            const response = await adapter.generateWithTools(prompt, tools, options);
+            if (response.content) {
+                onChunk({ type: 'content', content: response.content });
+            }
+            onChunk({ type: 'done', response });
+            return response;
+        }
+        return adapter.generateWithToolsStream(prompt, tools, onChunk, options);
+    }
+    /**
+     * Check if the adapter for a task supports streaming
+     */
+    supportsStreaming(task) {
+        const adapter = this.getLLMForTask(task);
+        return adapter.supportsStreaming();
+    }
+    /**
+     * Generate embedding using the knowledge retrieval LLM
+     */
+    async embed(text) {
+        // Use knowledge_retrieval task for embeddings
+        const adapter = this.getLLMForTask('knowledge_retrieval');
+        if (!adapter.supportsEmbeddings()) {
+            // Try fallback if available
+            if (this.config.fallback) {
+                const fallbackAdapter = this.getOrCreateAdapter(this.config.fallback);
+                if (fallbackAdapter.supportsEmbeddings()) {
+                    return fallbackAdapter.embed(text);
+                }
+            }
+            // Try default adapter
+            const defaultAdapter = this.getOrCreateAdapter(this.config.default);
+            if (defaultAdapter.supportsEmbeddings()) {
+                return defaultAdapter.embed(text);
+            }
+            throw new LLMError('No adapter supports embeddings', 'INVALID_REQUEST', adapter.provider);
+        }
+        return adapter.embed(text);
+    }
+    /**
+     * Check if any configured adapter supports embeddings
+     */
+    supportsEmbeddings() {
+        for (const adapter of this.adapters.values()) {
+            if (adapter.supportsEmbeddings()) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Check if the adapter for a task supports tool calling
+     */
+    supportsToolCalling(task) {
+        const adapter = this.getLLMForTask(task);
+        return adapter.supportsToolCalling();
+    }
+    /**
+     * Get all initialized adapters
+     */
+    getAdapters() {
+        return new Map(this.adapters);
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Initialize adapters for all configured LLMs
+     */
+    initializeAdapters() {
+        // Initialize default adapter
+        this.getOrCreateAdapter(this.config.default);
+        // Initialize fallback adapter if configured
+        if (this.config.fallback) {
+            this.getOrCreateAdapter(this.config.fallback);
+        }
+        // Initialize task-specific adapters in multi-LLM mode
+        if (this.config.mode === 'multi' && this.config.taskAssignment) {
+            const { intentParsing, knowledgeRetrieval, toolCalling, responseGeneration } = this.config.taskAssignment;
+            if (intentParsing)
+                this.getOrCreateAdapter(intentParsing);
+            if (knowledgeRetrieval)
+                this.getOrCreateAdapter(knowledgeRetrieval);
+            if (toolCalling)
+                this.getOrCreateAdapter(toolCalling);
+            if (responseGeneration)
+                this.getOrCreateAdapter(responseGeneration);
+        }
+    }
+    /**
+     * Get or create an adapter for a provider configuration
+     */
+    getOrCreateAdapter(config) {
+        const key = this.getAdapterKey(config);
+        let adapter = this.adapters.get(key);
+        if (!adapter) {
+            adapter = this.createAdapter(config);
+            this.adapters.set(key, adapter);
+        }
+        return adapter;
+    }
+    /**
+     * Create a unique key for an adapter configuration
+     */
+    getAdapterKey(config) {
+        return `${config.provider}:${config.model}:${config.baseUrl ?? 'default'}`;
+    }
+    /**
+     * Create an adapter based on provider configuration
+     */
+    createAdapter(config) {
+        switch (config.provider) {
+            case 'openai':
+                return new OpenAIAdapter({
+                    apiKey: config.apiKey,
+                    model: config.model,
+                    baseUrl: config.baseUrl,
+                    temperature: config.temperature,
+                    maxTokens: config.maxTokens,
+                });
+            case 'claude':
+                return new ClaudeAdapter({
+                    apiKey: config.apiKey,
+                    model: config.model,
+                    baseUrl: config.baseUrl,
+                    temperature: config.temperature,
+                    maxTokens: config.maxTokens,
+                });
+            case 'qwen':
+                return new QwenAdapter({
+                    apiKey: config.apiKey,
+                    model: config.model,
+                    baseUrl: config.baseUrl,
+                    temperature: config.temperature,
+                    maxTokens: config.maxTokens,
+                });
+            case 'siliconflow':
+                return new SiliconFlowAdapter({
+                    apiKey: config.apiKey,
+                    model: config.model,
+                    baseUrl: config.baseUrl,
+                    temperature: config.temperature,
+                    maxTokens: config.maxTokens,
+                });
+            case 'mimo':
+                return new MiMoAdapter({
+                    apiKey: config.apiKey,
+                    model: config.model,
+                    baseUrl: config.baseUrl,
+                    temperature: config.temperature,
+                    maxTokens: config.maxTokens,
+                });
+            case 'anyrouter':
+                return new AnyRouterAdapter({
+                    apiKey: config.apiKey,
+                    model: config.model,
+                    baseUrl: config.baseUrl,
+                    temperature: config.temperature,
+                    maxTokens: config.maxTokens,
+                });
+            case 'custom':
+                // Custom providers use OpenAI-compatible API
+                return new OpenAIAdapter({
+                    apiKey: config.apiKey,
+                    model: config.model,
+                    baseUrl: config.baseUrl,
+                    temperature: config.temperature,
+                    maxTokens: config.maxTokens,
+                });
+            default:
+                throw new LLMError(`Unknown provider: ${config.provider}`, 'INVALID_REQUEST', config.provider);
+        }
+    }
+    /**
+     * Execute an LLM operation with retry and fallback
+     */
+    async executeWithRetry(task, operation, abortSignal) {
+        // Check if already aborted before starting
+        if (abortSignal?.aborted) {
+            const adapter = this.getLLMForTask(task);
+            throw new LLMError('Operation cancelled', 'CANCELLED', adapter.provider);
+        }
+        const adapter = this.getLLMForTask(task);
+        let lastError;
+        let delay = this.retryConfig.initialDelayMs;
+        for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {
+            // Check if aborted before each retry attempt
+            if (abortSignal?.aborted) {
+                throw new LLMError('Operation cancelled', 'CANCELLED', adapter.provider);
+            }
+            try {
+                return await operation(adapter);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Don't retry if cancelled
+                if (error instanceof LLMError && error.code === 'CANCELLED') {
+                    throw error;
+                }
+                // Check if we should retry
+                if (!this.shouldRetry(error, attempt)) {
+                    break;
+                }
+                // Wait before retrying
+                await this.sleep(delay);
+                delay = Math.min(delay * 2, this.retryConfig.maxDelayMs);
+            }
+        }
+        // Try fallback if available
+        if (this.config.fallback) {
+            // Check if aborted before fallback
+            if (abortSignal?.aborted) {
+                throw new LLMError('Operation cancelled', 'CANCELLED', adapter.provider);
+            }
+            try {
+                const fallbackAdapter = this.getOrCreateAdapter(this.config.fallback);
+                return await operation(fallbackAdapter);
+            }
+            catch (fallbackError) {
+                // Don't swallow cancelled errors from fallback
+                if (fallbackError instanceof LLMError && fallbackError.code === 'CANCELLED') {
+                    throw fallbackError;
+                }
+                // Fallback also failed, throw original error
+            }
+        }
+        throw (lastError ??
+            new LLMError('Unknown error during LLM operation', 'UNKNOWN_ERROR', adapter.provider));
+    }
+    /**
+     * Determine if an error should trigger a retry
+     */
+    shouldRetry(error, attempt) {
+        if (attempt >= this.retryConfig.maxRetries) {
+            return false;
+        }
+        if (error instanceof LLMError) {
+            // Retry on rate limits and network errors
+            return error.code === 'RATE_LIMIT_ERROR' || error.code === 'NETWORK_ERROR';
+        }
+        return false;
+    }
+    /**
+     * Sleep for a specified duration
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Create an LLMManager with a simple single-LLM configuration
+ */
+export function createSimpleLLMManager(provider, apiKey, model, options) {
+    return new LLMManager({
+        mode: 'single',
+        default: {
+            provider,
+            apiKey,
+            model,
+            ...options,
+        },
+    });
+}
+//# sourceMappingURL=manager.js.map

package/dist/llm/manager.js.map

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

package/dist/test-utils/arbitraries.d.ts

@@ -0,0 +1,230 @@
+/**
+ * 共享的 Arbitrary 生成器
+ *
+ * 为 Property-based 测试提供统一的数据生成器
+ */
+import * as fc from 'fast-check';
+/**
+ * 有效的标识符（用于工具名、变量名等）
+ * 规则：以字母开头，只包含字母、数字、下划线
+ */
+export declare const arbIdentifier: fc.Arbitrary<string>;
+/**
+ * 有效的插件名（允许连字符）
+ */
+export declare const arbPluginName: fc.Arbitrary<string>;
+/**
+ * 有效的工具名（不允许连字符）
+ */
+export declare const arbToolName: fc.Arbitrary<string>;
+/**
+ * 有效的命名空间（小写字母开头）
+ */
+export declare const arbNamespace: fc.Arbitrary<string>;
+/**
+ * 有效的分类名
+ */
+export declare const arbCategory: fc.Arbitrary<string>;
+/**
+ * Session ID（UUID 格式）
+ */
+export declare const arbSessionId: fc.Arbitrary<string>;
+/**
+ * Message ID
+ */
+export declare const arbMessageId: fc.Arbitrary<string>;
+/**
+ * 消息角色
+ */
+export declare const arbMessageRole: fc.Arbitrary<string>;
+/**
+ * 响应类型
+ */
+export declare const arbResponseType: fc.Arbitrary<string>;
+/**
+ * 非空字符串
+ *
+ * @param maxLength - 最大长度
+ */
+export declare const arbNonEmptyString: (maxLength?: number) => fc.Arbitrary<string>;
+/**
+ * 消息内容
+ */
+export declare const arbMessageContent: fc.Arbitrary<string>;
+/**
+ * 用户消息
+ */
+export declare const arbUserMessage: fc.Arbitrary<string>;
+/**
+ * 安全的字符串（只包含常见字符）
+ */
+export declare const arbSafeString: (maxLength?: number) => fc.Arbitrary<string>;
+/**
+ * 有效的 JSON 值（排除 undefined）
+ */
+export declare const arbJsonValue: fc.Arbitrary<fc.JsonValue>;
+/**
+ * 元数据对象
+ */
+export declare const arbMetadata: fc.Arbitrary<any>;
+/**
+ * 简单的键值对对象
+ */
+export declare const arbSimpleObject: fc.Arbitrary<Record<string, any>>;
+/**
+ * 工具参数
+ */
+export declare const arbToolArgs: fc.Arbitrary<Record<string, any>>;
+/**
+ * 错误代码
+ */
+export declare const arbErrorCode: fc.Arbitrary<string>;
+/**
+ * 工具执行结果
+ */
+export declare const arbToolResult: fc.Arbitrary<{
+    success: boolean;
+    content: string;
+    data: any;
+    error: any;
+}>;
+/**
+ * 成功的工具结果
+ */
+export declare const arbSuccessToolResult: fc.Arbitrary<{
+    success: boolean;
+    content: string;
+    data: any;
+}>;
+/**
+ * 失败的工具结果
+ */
+export declare const arbFailureToolResult: fc.Arbitrary<{
+    success: boolean;
+    content: string;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+/**
+ * 正整数
+ *
+ * @param max - 最大值
+ */
+export declare const arbPositiveInt: (max?: number) => fc.Arbitrary<number>;
+/**
+ * 非负整数
+ *
+ * @param max - 最大值
+ */
+export declare const arbNonNegativeInt: (max?: number) => fc.Arbitrary<number>;
+/**
+ * 持续时间（毫秒）
+ */
+export declare const arbDurationMs: fc.Arbitrary<number>;
+/**
+ * 温度参数（0-2）
+ */
+export declare const arbTemperature: fc.Arbitrary<number>;
+/**
+ * maxTokens 参数
+ */
+export declare const arbMaxTokens: fc.Arbitrary<number>;
+/**
+ * maxIterations 参数
+ */
+export declare const arbMaxIterations: fc.Arbitrary<number>;
+/**
+ * 合理范围内的时间戳
+ */
+export declare const arbTimestamp: fc.Arbitrary<Date>;
+/**
+ * 过去的时间戳
+ */
+export declare const arbPastTimestamp: fc.Arbitrary<Date>;
+/**
+ * LLM 提供商
+ */
+export declare const arbLLMProvider: fc.Arbitrary<string>;
+/**
+ * LLM 任务类型
+ */
+export declare const arbLLMTask: fc.Arbitrary<string>;
+/**
+ * LLM 错误代码
+ */
+export declare const arbLLMErrorCode: fc.Arbitrary<string>;
+/**
+ * 风险级别
+ */
+export declare const arbRiskLevel: fc.Arbitrary<string>;
+/**
+ * 消息操作
+ */
+export interface MessageOperation {
+    type: 'user' | 'assistant' | 'system';
+    content: string;
+}
+/**
+ * 消息操作生成器
+ */
+export declare const arbMessageOperation: fc.Arbitrary<MessageOperation>;
+/**
+ * 消息操作序列
+ */
+export declare const arbMessageOperations: fc.Arbitrary<MessageOperation[]>;
+/**
+ * 工具调用
+ */
+export declare const arbToolCall: fc.Arbitrary<{
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}>;
+/**
+ * 工具调用数组
+ */
+export declare const arbToolCalls: fc.Arbitrary<{
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}[]>;
+/**
+ * LLM 响应
+ */
+export declare const arbLLMResponse: fc.Arbitrary<{
+    content: string;
+    toolCalls: any;
+}>;
+/**
+ * 创建唯一标识符生成器
+ *
+ * @param prefix - 前缀
+ */
+export declare function arbUniqueId(prefix: string): fc.Arbitrary<string>;
+/**
+ * 创建带索引的唯一标识符生成器
+ *
+ * @param prefix - 前缀
+ */
+export declare function arbIndexedId(prefix: string): fc.Arbitrary<string>;
+/**
+ * 创建枚举生成器
+ *
+ * @param values - 枚举值数组
+ */
+export declare function arbEnum<T extends string>(...values: T[]): fc.Arbitrary<T>;
+/**
+ * 创建可选值生成器
+ *
+ * @param arb - 基础生成器
+ */
+export declare function arbOptional<T>(arb: fc.Arbitrary<T>): fc.Arbitrary<T | undefined>;
+//# sourceMappingURL=arbitraries.d.ts.map

package/dist/test-utils/arbitraries.d.ts.map

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