@agenticc/core 1.0.0

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

@@ -0,0 +1,170 @@
+/**
+ * 类型安全的 Mock 工厂函数
+ *
+ * 提供统一的 Mock 创建方法，确保类型安全和一致性
+ */
+import type { LLMManager } from '../llm/manager.js';
+import type { Tool, ToolResult, ToolContext, ToolParameterType } from '../types/tool.js';
+import type { PluginContext, AgentPlugin } from '../types/plugin.js';
+import type { AgentConfig } from '../types/config.js';
+/**
+ * LLM 响应类型
+ */
+export interface MockLLMResponse {
+    content: string;
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    finishReason?: 'stop' | 'tool_calls' | 'length' | 'content_filter';
+}
+/**
+ * Mock Tool 选项
+ */
+export interface MockToolOptions {
+    /** 工具执行结果 */
+    result?: ToolResult;
+    /** 是否需要确认 */
+    requiresConfirmation?: boolean;
+    /** 风险级别 */
+    riskLevel?: 'low' | 'medium' | 'high';
+    /** 工具分类 */
+    category?: string;
+    /** 执行时抛出的错误 */
+    shouldThrow?: Error;
+    /** 工具参数定义 */
+    parameters?: Array<{
+        name: string;
+        type: ToolParameterType;
+        description: string;
+        required: boolean;
+    }>;
+}
+/**
+ * Mock Plugin 选项
+ */
+export interface MockPluginOptions {
+    /** 命名空间 */
+    namespace?: string;
+    /** 版本号 */
+    version?: string;
+    /** 加载钩子 */
+    onLoad?: () => Promise<void>;
+    /** 卸载钩子 */
+    onUnload?: () => Promise<void>;
+    /** 健康检查 */
+    healthCheck?: () => Promise<boolean>;
+}
+/**
+ * LLM Manager Mock 类型（部分接口）
+ */
+export type MockLLMManagerType = Pick<LLMManager, 'generateWithTools' | 'generate' | 'supportsEmbeddings' | 'getLLMForTask' | 'embed'>;
+/**
+ * 创建类型安全的 LLM Manager Mock
+ *
+ * @param responses - 预定义的响应序列
+ * @returns Mock LLM Manager
+ *
+ * @example
+ * ```typescript
+ * const llm = createMockLLMManager([
+ *   { content: 'First response' },
+ *   { content: 'Second response', toolCalls: [...] },
+ * ]);
+ * ```
+ */
+export declare function createMockLLMManager(responses: MockLLMResponse[]): MockLLMManagerType;
+/**
+ * 创建可重置的 LLM Manager Mock
+ *
+ * @param responses - 预定义的响应序列
+ * @returns 带 reset 方法的 Mock LLM Manager
+ */
+export declare function createResettableMockLLMManager(responses: MockLLMResponse[]): MockLLMManagerType & {
+    reset: () => void;
+    getCallCount: () => number;
+};
+/**
+ * 创建 Mock Tool
+ *
+ * @param name - 工具名称
+ * @param options - 工具选项
+ * @returns Mock Tool
+ *
+ * @example
+ * ```typescript
+ * const tool = createMockTool('my_tool', {
+ *   requiresConfirmation: true,
+ *   riskLevel: 'high',
+ * });
+ * ```
+ */
+export declare function createMockTool(name: string, options?: MockToolOptions): Tool;
+/**
+ * 创建带参数的 Mock Tool
+ *
+ * @param name - 工具名称
+ * @param params - 参数名列表
+ * @param options - 其他选项
+ * @returns Mock Tool
+ */
+export declare function createMockToolWithParams(name: string, params: string[], options?: Omit<MockToolOptions, 'parameters'>): Tool;
+/**
+ * 创建 Mock Plugin Context
+ *
+ * @param overrides - 覆盖的属性
+ * @returns Mock Plugin Context
+ */
+export declare function createMockPluginContext(overrides?: Partial<PluginContext>): PluginContext;
+/**
+ * 创建 Mock Tool Context
+ *
+ * @param overrides - 覆盖的属性
+ * @returns Mock Tool Context
+ */
+export declare function createMockToolContext(overrides?: Partial<ToolContext>): ToolContext;
+/**
+ * 创建 Mock Plugin
+ *
+ * @param name - 插件名称
+ * @param tools - 工具列表
+ * @param options - 插件选项
+ * @returns Mock Plugin
+ *
+ * @example
+ * ```typescript
+ * const plugin = createMockPlugin('my-plugin', [tool1, tool2], {
+ *   namespace: 'myns',
+ * });
+ * ```
+ */
+export declare function createMockPlugin(name: string, tools: Tool[], options?: MockPluginOptions): AgentPlugin;
+/**
+ * 创建测试用 Agent 配置
+ *
+ * @param overrides - 覆盖的配置
+ * @returns Agent 配置
+ */
+export declare function createTestAgentConfig(overrides?: Partial<AgentConfig>): AgentConfig;
+/**
+ * 创建带确认机制的测试配置
+ */
+export declare function createTestAgentConfigWithConfirmation(): AgentConfig;
+/**
+ * 创建一系列工具调用响应
+ *
+ * @param toolName - 工具名称
+ * @param count - 调用次数
+ * @returns 响应数组
+ */
+export declare function createToolCallResponses(toolName: string, count: number): MockLLMResponse[];
+/**
+ * 创建无限工具调用响应（用于测试 maxIterations）
+ *
+ * @param toolName - 工具名称
+ * @param maxResponses - 最大响应数
+ * @returns 响应数组
+ */
+export declare function createInfiniteToolCallResponses(toolName: string, maxResponses?: number): MockLLMResponse[];
+//# sourceMappingURL=mocks.d.ts.map

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

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

package/dist/test-utils/mocks.js

@@ -0,0 +1,281 @@
+/**
+ * 类型安全的 Mock 工厂函数
+ *
+ * 提供统一的 Mock 创建方法，确保类型安全和一致性
+ */
+import { vi } from 'vitest';
+// ============================================================================
+// Mock Factories
+// ============================================================================
+/**
+ * 创建类型安全的 LLM Manager Mock
+ *
+ * @param responses - 预定义的响应序列
+ * @returns Mock LLM Manager
+ *
+ * @example
+ * ```typescript
+ * const llm = createMockLLMManager([
+ *   { content: 'First response' },
+ *   { content: 'Second response', toolCalls: [...] },
+ * ]);
+ * ```
+ */
+export function createMockLLMManager(responses) {
+    let callIndex = 0;
+    const getNextResponse = () => {
+        const response = responses[callIndex] || responses[responses.length - 1];
+        callIndex++;
+        return {
+            ...response,
+            finishReason: response.finishReason ?? (response.toolCalls ? 'tool_calls' : 'stop'),
+        };
+    };
+    return {
+        generateWithTools: vi.fn(async () => getNextResponse()),
+        generate: vi.fn(async () => getNextResponse().content),
+        supportsEmbeddings: vi.fn().mockReturnValue(false),
+        getLLMForTask: vi.fn(),
+        embed: vi.fn(async (text) => ({
+            embedding: new Array(1536).fill(0).map(() => Math.random()),
+            tokenCount: text.split(/\s+/).length,
+        })),
+    };
+}
+/**
+ * 创建可重置的 LLM Manager Mock
+ *
+ * @param responses - 预定义的响应序列
+ * @returns 带 reset 方法的 Mock LLM Manager
+ */
+export function createResettableMockLLMManager(responses) {
+    let callIndex = 0;
+    const getNextResponse = () => {
+        const response = responses[callIndex] || responses[responses.length - 1];
+        callIndex++;
+        return {
+            ...response,
+            finishReason: response.finishReason ?? (response.toolCalls ? 'tool_calls' : 'stop'),
+        };
+    };
+    const mock = {
+        generateWithTools: vi.fn(async () => getNextResponse()),
+        generate: vi.fn(async () => getNextResponse().content),
+        supportsEmbeddings: vi.fn().mockReturnValue(false),
+        getLLMForTask: vi.fn(),
+        embed: vi.fn(async (text) => ({
+            embedding: new Array(1536).fill(0).map(() => Math.random()),
+            tokenCount: text.split(/\s+/).length,
+        })),
+        reset: () => {
+            callIndex = 0;
+            vi.clearAllMocks();
+        },
+        getCallCount: () => callIndex,
+    };
+    return mock;
+}
+/**
+ * 创建 Mock Tool
+ *
+ * @param name - 工具名称
+ * @param options - 工具选项
+ * @returns Mock Tool
+ *
+ * @example
+ * ```typescript
+ * const tool = createMockTool('my_tool', {
+ *   requiresConfirmation: true,
+ *   riskLevel: 'high',
+ * });
+ * ```
+ */
+export function createMockTool(name, options = {}) {
+    const defaultResult = { success: true, content: 'Done' };
+    return {
+        name,
+        description: `Mock tool: ${name}`,
+        parameters: options.parameters ?? [],
+        category: options.category,
+        requiresConfirmation: options.requiresConfirmation,
+        riskLevel: options.riskLevel,
+        execute: vi.fn(async () => {
+            if (options.shouldThrow) {
+                throw options.shouldThrow;
+            }
+            return options.result ?? defaultResult;
+        }),
+    };
+}
+/**
+ * 创建带参数的 Mock Tool
+ *
+ * @param name - 工具名称
+ * @param params - 参数名列表
+ * @param options - 其他选项
+ * @returns Mock Tool
+ */
+export function createMockToolWithParams(name, params, options = {}) {
+    return createMockTool(name, {
+        ...options,
+        parameters: params.map((p) => ({
+            name: p,
+            type: 'string',
+            description: `Parameter: ${p}`,
+            required: true,
+        })),
+    });
+}
+/**
+ * 创建 Mock Plugin Context
+ *
+ * @param overrides - 覆盖的属性
+ * @returns Mock Plugin Context
+ */
+export function createMockPluginContext(overrides) {
+    return {
+        logger: {
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+            debug: vi.fn(),
+        },
+        knowledgeBase: {},
+        config: { env: 'test', debug: false },
+        services: {},
+        ...overrides,
+    };
+}
+/**
+ * 创建 Mock Tool Context
+ *
+ * @param overrides - 覆盖的属性
+ * @returns Mock Tool Context
+ */
+export function createMockToolContext(overrides) {
+    return {
+        knowledgeBase: {},
+        sessionId: `test-session-${Date.now()}`,
+        logger: {
+            info: vi.fn(),
+            warn: vi.fn(),
+            error: vi.fn(),
+            debug: vi.fn(),
+        },
+        ...overrides,
+    };
+}
+/**
+ * 创建 Mock Plugin
+ *
+ * @param name - 插件名称
+ * @param tools - 工具列表
+ * @param options - 插件选项
+ * @returns Mock Plugin
+ *
+ * @example
+ * ```typescript
+ * const plugin = createMockPlugin('my-plugin', [tool1, tool2], {
+ *   namespace: 'myns',
+ * });
+ * ```
+ */
+export function createMockPlugin(name, tools, options = {}) {
+    return {
+        name,
+        version: options.version ?? '1.0.0',
+        description: `Mock plugin: ${name}`,
+        namespace: options.namespace,
+        tools,
+        onLoad: options.onLoad,
+        onUnload: options.onUnload,
+        healthCheck: options.healthCheck,
+    };
+}
+/**
+ * 创建测试用 Agent 配置
+ *
+ * @param overrides - 覆盖的配置
+ * @returns Agent 配置
+ */
+export function createTestAgentConfig(overrides) {
+    return {
+        llm: {
+            mode: 'single',
+            default: {
+                provider: 'openai',
+                apiKey: 'test-key',
+                model: 'gpt-4',
+            },
+        },
+        database: {
+            url: 'memory://',
+        },
+        behavior: {
+            requireConfirmation: false,
+            maxIterations: 5,
+            timeoutMs: 5000,
+        },
+        ...overrides,
+    };
+}
+/**
+ * 创建带确认机制的测试配置
+ */
+export function createTestAgentConfigWithConfirmation() {
+    return createTestAgentConfig({
+        behavior: {
+            requireConfirmation: true,
+            maxIterations: 5,
+            timeoutMs: 5000,
+        },
+    });
+}
+// ============================================================================
+// Mock Helpers
+// ============================================================================
+/**
+ * 创建一系列工具调用响应
+ *
+ * @param toolName - 工具名称
+ * @param count - 调用次数
+ * @returns 响应数组
+ */
+export function createToolCallResponses(toolName, count) {
+    const responses = [];
+    for (let i = 0; i < count; i++) {
+        responses.push({
+            content: `Calling ${toolName} (${i + 1}/${count})`,
+            toolCalls: [
+                {
+                    id: `call_${i}`,
+                    name: toolName,
+                    arguments: {},
+                },
+            ],
+        });
+    }
+    // 最后一个响应不包含工具调用
+    responses.push({ content: 'Done!' });
+    return responses;
+}
+/**
+ * 创建无限工具调用响应（用于测试 maxIterations）
+ *
+ * @param toolName - 工具名称
+ * @param maxResponses - 最大响应数
+ * @returns 响应数组
+ */
+export function createInfiniteToolCallResponses(toolName, maxResponses = 100) {
+    return Array(maxResponses).fill({
+        content: 'Need more work.',
+        toolCalls: [
+            {
+                id: 'call_x',
+                name: toolName,
+                arguments: {},
+            },
+        ],
+    });
+}
+//# sourceMappingURL=mocks.js.map

package/dist/test-utils/mocks.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Configuration Type Definitions
+ *
+ * Defines the configuration interfaces for the Agent, LLM providers,
+ * and other system components.
+ */
+/**
+ * Supported LLM providers
+ */
+export type LLMProvider = 'openai' | 'claude' | 'qwen' | 'siliconflow' | 'mimo' | 'anyrouter' | 'custom';
+/**
+ * LLM task types for multi-LLM routing
+ */
+export type LLMTask = 'intent_parsing' | 'knowledge_retrieval' | 'tool_calling' | 'response_generation';
+/**
+ * All LLM task types as a constant array
+ */
+export declare const LLM_TASKS: LLMTask[];
+/**
+ * Configuration for a single LLM provider
+ */
+export interface LLMProviderConfig {
+    /** LLM provider type */
+    provider: LLMProvider;
+    /** API key for authentication */
+    apiKey: string;
+    /** Model identifier (e.g., 'gpt-4', 'claude-3-opus') */
+    model: string;
+    /** Custom API endpoint (for custom providers or proxies) */
+    baseUrl?: string;
+    /** Temperature for response generation (0-2) */
+    temperature?: number;
+    /** Maximum tokens in response */
+    maxTokens?: number;
+    /** Additional provider-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * LLM configuration supporting single or multi-LLM modes
+ */
+export interface LLMConfig {
+    /** Operating mode: single LLM for all tasks or multiple specialized LLMs */
+    mode: 'single' | 'multi';
+    /** Default LLM configuration (used for all tasks in single mode) */
+    default: LLMProviderConfig;
+    /** Task-specific LLM assignments (only used in multi mode) */
+    taskAssignment?: {
+        /** LLM for parsing user intent */
+        intentParsing?: LLMProviderConfig;
+        /** LLM for knowledge retrieval and embedding */
+        knowledgeRetrieval?: LLMProviderConfig;
+        /** LLM for tool calling decisions */
+        toolCalling?: LLMProviderConfig;
+        /** LLM for generating final responses */
+        responseGeneration?: LLMProviderConfig;
+    };
+    /** Fallback LLM if primary fails */
+    fallback?: LLMProviderConfig;
+    /** Retry configuration */
+    retry?: {
+        /** Maximum number of retries */
+        maxRetries: number;
+        /** Initial delay in milliseconds */
+        initialDelayMs: number;
+        /** Maximum delay in milliseconds */
+        maxDelayMs: number;
+    };
+}
+/**
+ * Database configuration (deprecated - storage is now external)
+ * @deprecated Storage is managed externally. Use @ai-agent/storage-memory or other storage packages.
+ */
+export interface DatabaseConfig {
+    /** Database connection URL */
+    url: string;
+    /** Connection pool size */
+    poolSize?: number;
+}
+/**
+ * Knowledge system configuration
+ */
+export interface KnowledgeConfig {
+    /** Embedding model configuration */
+    embedding?: {
+        /** Model to use for embeddings */
+        model: string;
+        /** Embedding dimension (e.g., 1536 for OpenAI ada-002) */
+        dimension: number;
+    };
+    /** Search configuration */
+    search?: {
+        /** Default number of results to return */
+        defaultTopK: number;
+        /** Minimum similarity score threshold */
+        minScore: number;
+        /** Default search method */
+        defaultMethod: 'keyword' | 'semantic' | 'hybrid';
+    };
+}
+/**
+ * Logging configuration
+ */
+export interface LoggingConfig {
+    /** Log level */
+    level?: 'debug' | 'info' | 'warn' | 'error';
+    /** Custom logger implementation */
+    logger?: Logger;
+    /** Enable performance metrics collection */
+    enableMetrics?: boolean;
+}
+/**
+ * Logger interface for custom logging implementations
+ */
+export interface Logger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Agent behavior configuration
+ */
+export interface BehaviorConfig {
+    /** Maximum processing time in milliseconds */
+    timeoutMs?: number;
+    /** Maximum number of tool call iterations */
+    maxIterations?: number;
+    /** Whether to require confirmation for high-risk operations */
+    requireConfirmation?: boolean;
+    /** Confidence threshold for automatic execution */
+    confidenceThreshold?: number;
+    /** System prompt customization */
+    systemPrompt?: string;
+}
+/**
+ * Complete Agent configuration
+ */
+export interface AgentConfig {
+    /** LLM configuration */
+    llm: LLMConfig;
+    /** Database configuration (deprecated - use external storage) */
+    database?: DatabaseConfig;
+    /** Knowledge system configuration */
+    knowledge?: KnowledgeConfig;
+    /** Agent behavior configuration */
+    behavior?: BehaviorConfig;
+    /** Logging configuration */
+    logging?: LoggingConfig;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Partial<AgentConfig>;
+/**
+ * Validates an LLMProviderConfig
+ */
+export declare function validateLLMProviderConfig(config: LLMProviderConfig): string[];
+/**
+ * Validates an LLMConfig
+ */
+export declare function validateLLMConfig(config: LLMConfig): string[];
+/**
+ * Validates a complete AgentConfig
+ */
+export declare function validateAgentConfig(config: AgentConfig): string[];
+/**
+ * Gets the LLM configuration for a specific task
+ */
+export declare function getLLMConfigForTask(config: LLMConfig, task: LLMTask): LLMProviderConfig;
+//# sourceMappingURL=config.d.ts.map

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

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