@scenemesh/entity-engine-aimodule 1.0.0

package/dist/core-index.d.ts

@@ -0,0 +1,1668 @@
+import { z } from 'zod';
+import { EventEmitter } from 'events';
+import { ToolSet, LanguageModel, CoreMessage, FinishReason, LanguageModelUsage, GenerateTextResult, LanguageModelRequestMetadata, LanguageModelResponseMetadata, TextStreamPart, StreamTextResult, GenerateObjectResult, StreamObjectResult, Tool, dynamicTool, NoSuchToolError, InvalidToolInputError, TypedToolCall, TypedToolResult, EmbeddingModel, ImageModel, Provider } from 'ai';
+export { CoreMessage, EmbeddingModel, FinishReason, GenerateObjectResult, GenerateTextResult, ImageModel, InvalidToolInputError, LanguageModel, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, NoSuchToolError, Provider, StreamObjectResult, StreamTextResult, TextStreamPart, Tool, ToolSet, cosineSimilarity, createProviderRegistry, customProvider, defaultSettingsMiddleware, embed, embedMany, generateObject, generateText, smoothStream, streamObject, streamText, tool, wrapLanguageModel } from 'ai';
+
+/**
+ * Complete AI Integration
+ *
+ * Core AI functionality implementation:
+ * - generateText: Text generation
+ * - streamText: Streaming text generation
+ * - generateObject: Structured object generation
+ */
+
+/**
+ * Complete generateText options interface
+ */
+interface GenerateTextOptions<TOOLS extends ToolSet = {}> {
+    model: LanguageModel;
+    system?: string;
+    prompt?: string | Array<any>;
+    messages?: CoreMessage[];
+    tools?: TOOLS;
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        type: 'tool';
+        toolName: string;
+    };
+    activeTools?: Array<keyof TOOLS>;
+    maxOutputTokens?: number;
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    presencePenalty?: number;
+    frequencyPenalty?: number;
+    stopSequences?: string[];
+    seed?: number;
+    maxRetries?: number;
+    stopWhen?: any;
+    prepareStep?: (options: {
+        steps: Array<any>;
+        stepNumber: number;
+        model: LanguageModel;
+        messages: Array<any>;
+    }) => any | Promise<any>;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
+    experimental_telemetry?: {
+        isEnabled?: boolean;
+        recordInputs?: boolean;
+        recordOutputs?: boolean;
+        functionId?: string;
+        metadata?: Record<string, string | number | boolean | Array<null | undefined | string> | Array<null | undefined | number> | Array<null | undefined | boolean>>;
+    };
+    experimental_context?: unknown;
+    experimental_download?: (requestedDownloads: Array<{
+        url: URL;
+        isUrlSupportedByModel: boolean;
+    }>) => Promise<Array<null | {
+        data: Uint8Array;
+        mediaType?: string;
+    }>>;
+    experimental_repairToolCall?: (options: {
+        system?: string;
+        messages: Array<any>;
+        toolCall: any;
+        tools: TOOLS;
+        parameterSchema: (options: {
+            toolName: string;
+        }) => any;
+        error: any;
+    }) => Promise<any | null>;
+    experimental_output?: {
+        format: 'text' | 'object';
+        schema?: any;
+    };
+    providerOptions?: Record<string, Record<string, any>>;
+    onStepFinish?: (result: {
+        finishReason: FinishReason;
+        usage: LanguageModelUsage;
+        text: string;
+        toolCalls: Array<any>;
+        toolResults: Array<any>;
+        warnings?: Array<any>;
+        response?: {
+            id: string;
+            model: string;
+            timestamp: Date;
+            headers?: Record<string, string>;
+            body?: unknown;
+        };
+        isContinued: boolean;
+        providerMetadata?: Record<string, Record<string, any>>;
+    }) => Promise<void> | void;
+}
+/**
+ * Complete streamText options interface
+ */
+interface StreamTextOptions<TOOLS extends ToolSet = {}> extends Omit<GenerateTextOptions<TOOLS>, 'onStepFinish'> {
+    experimental_generateMessageId?: () => string;
+    experimental_transform?: any | any[];
+    includeRawChunks?: boolean;
+    onChunk?: (event: {
+        chunk: TextStreamPart<TOOLS>;
+    }) => Promise<void> | void;
+    onError?: (event: {
+        error: unknown;
+    }) => Promise<void> | void;
+    onStepFinish?: (result: {
+        stepType: 'initial' | 'continue' | 'tool-result';
+        finishReason: FinishReason;
+        usage: LanguageModelUsage;
+        text: string;
+        reasoning?: string;
+        sources: Array<{
+            sourceType: 'url';
+            id: string;
+            url: string;
+            title?: string;
+            providerMetadata?: any;
+        }>;
+        files: Array<{
+            base64: string;
+            uint8Array: Uint8Array;
+            mediaType: string;
+        }>;
+        toolCalls: Array<any>;
+        toolResults: Array<any>;
+        warnings?: Array<any>;
+        response?: {
+            id: string;
+            model: string;
+            timestamp: Date;
+            headers?: Record<string, string>;
+            messages: Array<any>;
+        };
+        isContinued: boolean;
+        providerMetadata?: Record<string, Record<string, any>>;
+    }) => Promise<void> | void;
+    onFinish?: (result: {
+        finishReason: FinishReason;
+        usage: LanguageModelUsage;
+        totalUsage: LanguageModelUsage;
+        providerMetadata?: Record<string, Record<string, any>>;
+        text: string;
+        reasoning?: string;
+        reasoningDetails: Array<{
+            type: 'text' | 'redacted';
+            text?: string;
+            signature?: string;
+            data?: string;
+        }>;
+        sources: Array<{
+            sourceType: 'url';
+            id: string;
+            url: string;
+            title?: string;
+            providerMetadata?: any;
+        }>;
+        files: Array<{
+            base64: string;
+            uint8Array: Uint8Array;
+            mediaType: string;
+        }>;
+        toolCalls: Array<any>;
+        toolResults: Array<any>;
+        warnings?: Array<any>;
+        response?: {
+            id: string;
+            model: string;
+            timestamp: Date;
+            headers?: Record<string, string>;
+            messages: Array<any>;
+        };
+        steps: Array<any>;
+    }) => Promise<void> | void;
+    onAbort?: (event: {
+        steps: Array<any>;
+    }) => Promise<void> | void;
+}
+/**
+ * Result types
+ */
+type GenerateResult<TOOLS extends ToolSet = {}> = GenerateTextResult<TOOLS, any> & {
+    content: Array<any>;
+    text: string;
+    reasoning: Array<any>;
+    reasoningText: string | undefined;
+    sources: Array<any>;
+    files: Array<any>;
+    toolCalls: Array<any>;
+    toolResults: Array<any>;
+    finishReason: 'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other' | 'unknown';
+    usage: LanguageModelUsage;
+    totalUsage: LanguageModelUsage;
+    request?: LanguageModelRequestMetadata;
+    response?: LanguageModelResponseMetadata;
+    warnings?: Array<any>;
+    providerMetadata?: any;
+    experimental_output?: any;
+    steps: Array<any>;
+};
+type StreamResult<TOOLS extends ToolSet = {}> = StreamTextResult<TOOLS, any> & {
+    content: Promise<Array<any>>;
+    finishReason: Promise<'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other' | 'unknown'>;
+    usage: Promise<LanguageModelUsage>;
+    totalUsage: Promise<LanguageModelUsage>;
+    providerMetadata: Promise<any>;
+    text: Promise<string>;
+    reasoning: Promise<Array<any>>;
+    reasoningText: Promise<string | undefined>;
+    sources: Promise<Array<any>>;
+    files: Promise<Array<any>>;
+    toolCalls: Promise<Array<any>>;
+    toolResults: Promise<Array<any>>;
+    request: Promise<LanguageModelRequestMetadata>;
+    response: Promise<LanguageModelResponseMetadata & {
+        messages: Array<any>;
+    }>;
+    warnings: Promise<Array<any> | undefined>;
+    steps: Promise<Array<any>>;
+    textStream: AsyncIterable<string> & ReadableStream<string>;
+    fullStream: AsyncIterable<any> & ReadableStream<any>;
+};
+/**
+ * Complete AI integration class
+ */
+declare class AISDKIntegration extends EventEmitter {
+    private initialized;
+    private requestCounter;
+    constructor();
+    /**
+     * Initialize the AI integration
+     */
+    initialize(): Promise<void>;
+    /**
+     * Generate request ID
+     */
+    private generateRequestId;
+    /**
+     * Text generation
+     */
+    generateText<TOOLS extends ToolSet = {}>(options: GenerateTextOptions<TOOLS>): Promise<GenerateResult<TOOLS>>;
+    /**
+     * Streaming text generation
+     */
+    streamText<TOOLS extends ToolSet = {}>(options: StreamTextOptions<TOOLS>): StreamTextResult<TOOLS, any>;
+    /**
+     * Generate structured object
+     */
+    generateObject<SCHEMA>(options: {
+        model: LanguageModel;
+        output?: 'object' | 'array' | 'enum' | 'no-schema';
+        mode?: 'auto' | 'json' | 'tool';
+        schema?: SCHEMA;
+        schemaName?: string;
+        schemaDescription?: string;
+        enum?: string[];
+        system?: string;
+        prompt?: string;
+        messages?: CoreMessage[];
+        maxOutputTokens?: number;
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        presencePenalty?: number;
+        frequencyPenalty?: number;
+        seed?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+        headers?: Record<string, string>;
+        experimental_repairText?: (options: {
+            text: string;
+            error: any;
+        }) => Promise<string>;
+        experimental_download?: (requestedDownloads: Array<{
+            url: URL;
+            isUrlSupportedByModel: boolean;
+        }>) => Promise<Array<null | {
+            data: Uint8Array;
+            mediaType?: string;
+        }>>;
+        experimental_telemetry?: {
+            isEnabled?: boolean;
+            recordInputs?: boolean;
+            recordOutputs?: boolean;
+            functionId?: string;
+            metadata?: Record<string, any>;
+        };
+        providerOptions?: Record<string, Record<string, any>>;
+    }): Promise<GenerateObjectResult<SCHEMA>>;
+    /**
+     * Streaming structured object generation
+     */
+    streamObject<SCHEMA>(options: {
+        model: LanguageModel;
+        output?: 'object' | 'array' | 'enum' | 'no-schema';
+        mode?: 'auto' | 'json' | 'tool';
+        schema?: SCHEMA;
+        schemaName?: string;
+        schemaDescription?: string;
+        enum?: string[];
+        system?: string;
+        prompt?: string;
+        messages?: CoreMessage[];
+        maxOutputTokens?: number;
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        presencePenalty?: number;
+        frequencyPenalty?: number;
+        seed?: number;
+        maxRetries?: number;
+        abortSignal?: AbortSignal;
+        headers?: Record<string, string>;
+        experimental_repairText?: (options: {
+            text: string;
+            error: any;
+        }) => Promise<string>;
+        experimental_download?: (requestedDownloads: Array<{
+            url: URL;
+            isUrlSupportedByModel: boolean;
+        }>) => Promise<Array<null | {
+            data: Uint8Array;
+            mediaType?: string;
+        }>>;
+        experimental_telemetry?: {
+            isEnabled?: boolean;
+            recordInputs?: boolean;
+            recordOutputs?: boolean;
+            functionId?: string;
+            metadata?: Record<string, any>;
+        };
+        providerOptions?: Record<string, Record<string, any>>;
+        onError?: (event: {
+            error: unknown;
+        }) => Promise<void> | void;
+        onFinish?: (result: {
+            usage: LanguageModelUsage;
+            providerMetadata?: Record<string, Record<string, any>>;
+            object?: SCHEMA;
+            error?: unknown;
+            warnings?: Array<any>;
+            response?: {
+                id: string;
+                model: string;
+                timestamp: Date;
+                headers?: Record<string, string>;
+            };
+        }) => void;
+    }): StreamObjectResult<any, any, any>;
+    /**
+     * Create tool
+     */
+    createTool<TParameters, TResult>(description: string, inputSchema: z.ZodSchema<TParameters>, execute?: (parameters: TParameters) => Promise<TResult> | TResult): Tool<TParameters, TResult>;
+    /**
+     * Create smooth stream
+     */
+    createSmoothStream(): (options: {
+        tools: ToolSet;
+    }) => TransformStream<TextStreamPart<ToolSet>, TextStreamPart<ToolSet>>;
+    /**
+     * Check initialization status
+     */
+    isInitialized(): boolean;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        requestCount: number;
+        isInitialized: boolean;
+    };
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Destroy instance
+     */
+    destroy(): void;
+}
+
+/**
+ * AI Tool Calling Complete Integration
+ *
+ * Complete tool calling functionality:
+ * - Basic tool calling and execution
+ * - Multi-step calling system (stopWhen, stepCountIs)
+ * - Dynamic tools (dynamicTool)
+ * - Tool selection strategies (toolChoice)
+ * - Error handling and tool repair
+ * - MCP tool integration
+ * - Complete type safety system
+ */
+
+/**
+ * Complete tool choice strategy definition
+ */
+type ToolChoice<TOOLS extends ToolSet = {}> = 'auto' | 'required' | 'none' | {
+    type: 'tool';
+    toolName: Extract<keyof TOOLS, string>;
+};
+/**
+ * 停止条件类型 - 支持各种停止策略
+ */
+type StopCondition<_TOOLS extends ToolSet = {}> = ((options: {
+    stepNumber: number;
+    steps: Array<any>;
+}) => boolean) | {
+    type: 'stepCount';
+    value: number;
+} | {
+    type: 'custom';
+    condition: (context: any) => boolean;
+};
+/**
+ * 工具执行选项 - 完整参数
+ */
+interface ToolExecutionOptions {
+    toolCallId: string;
+    messages: CoreMessage[];
+    abortSignal?: AbortSignal;
+    experimental_context?: unknown;
+}
+/**
+ * 工具定义接口 - 支持所有官方功能
+ */
+interface AdvancedTool<TParameters = any, TResult = any> {
+    description?: string;
+    inputSchema: z.ZodSchema<TParameters>;
+    execute?: (parameters: TParameters, options: ToolExecutionOptions) => Promise<TResult> | TResult | AsyncIterable<TResult>;
+    toModelOutput?: (result: TResult) => {
+        type: 'content';
+        value: Array<{
+            type: 'text' | 'image';
+            text?: string;
+            data?: string;
+            mediaType?: string;
+        }>;
+    };
+}
+/**
+ * 动态工具接口 - 完全匹配 AI SDK 的 dynamicTool 返回类型
+ */
+type DynamicTool = ReturnType<typeof dynamicTool>;
+/**
+ * 步骤结果类型 - 完整步骤信息
+ */
+interface StepResult<TOOLS extends ToolSet = {}> {
+    stepType: 'initial' | 'continue' | 'tool-result';
+    stepNumber: number;
+    text: string;
+    reasoning?: string;
+    toolCalls: Array<TypedToolCall<TOOLS>>;
+    toolResults: Array<TypedToolResult<TOOLS>>;
+    finishReason: FinishReason;
+    usage: LanguageModelUsage;
+    warnings?: Array<any>;
+    response?: LanguageModelResponseMetadata;
+    isContinued: boolean;
+    providerMetadata?: Record<string, Record<string, any>>;
+}
+/**
+ * 工具调用选项 - 完整参数集合
+ */
+interface ToolCallOptions<TOOLS extends ToolSet = {}> {
+    model: LanguageModel;
+    system?: string;
+    prompt?: string;
+    messages?: CoreMessage[];
+    tools: TOOLS;
+    toolChoice?: ToolChoice<TOOLS>;
+    activeTools?: Array<keyof TOOLS>;
+    stopWhen?: StopCondition<TOOLS> | Array<StopCondition<TOOLS>>;
+    maxSteps?: number;
+    maxOutputTokens?: number;
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    presencePenalty?: number;
+    frequencyPenalty?: number;
+    seed?: number;
+    maxRetries?: number;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
+    experimental_context?: unknown;
+    experimental_telemetry?: {
+        isEnabled?: boolean;
+        recordInputs?: boolean;
+        recordOutputs?: boolean;
+        functionId?: string;
+        metadata?: Record<string, any>;
+    };
+    experimental_repairToolCall?: (options: {
+        toolCall: any;
+        tools: TOOLS;
+        error: NoSuchToolError | InvalidToolInputError;
+        messages: CoreMessage[];
+        system?: string;
+        inputSchema: (options: {
+            toolName: string;
+        }) => any;
+    }) => Promise<any | null>;
+    onStepFinish?: (result: StepResult<TOOLS>) => Promise<void> | void;
+    prepareStep?: (options: {
+        stepNumber: number;
+        steps: Array<StepResult<TOOLS>>;
+        model: LanguageModel;
+        messages: CoreMessage[];
+    }) => Promise<{
+        model?: LanguageModel;
+        toolChoice?: ToolChoice<TOOLS>;
+        activeTools?: Array<keyof TOOLS>;
+        system?: string;
+        messages?: CoreMessage[];
+    } | void> | {
+        model?: LanguageModel;
+        toolChoice?: ToolChoice<TOOLS>;
+        activeTools?: Array<keyof TOOLS>;
+        system?: string;
+        messages?: CoreMessage[];
+    } | void;
+}
+/**
+ * MCP客户端配置
+ */
+interface MCPClientConfig {
+    transport: {
+        type: 'sse';
+        url: string;
+        headers?: Record<string, string>;
+    } | {
+        type: 'stdio';
+        command: string;
+        args?: string[];
+    } | {
+        type: 'custom';
+        transport: any;
+    };
+    schemas?: Record<string, {
+        inputSchema: z.ZodSchema<any>;
+    }>;
+}
+/**
+ * MCP客户端接口
+ */
+interface MCPClient {
+    tools(config?: {
+        schemas?: Record<string, {
+            inputSchema: z.ZodSchema<any>;
+        }>;
+    }): Promise<ToolSet>;
+    close(): Promise<void>;
+}
+/**
+ * Complete tools integration class
+ */
+declare class AIToolsIntegration extends EventEmitter {
+    private initialized;
+    private requestCounter;
+    private registeredTools;
+    private dynamicTools;
+    private mcpClients;
+    constructor();
+    /**
+     * 初始化
+     */
+    initialize(): Promise<void>;
+    /**
+     * 生成请求ID
+     */
+    private generateRequestId;
+    /**
+     * Create tool - following official specifications
+     */
+    createTool(description: string, inputSchema: z.ZodSchema<any>, execute?: (parameters: any, options?: any) => Promise<any> | any): any;
+    /**
+     * 创建动态工具 - 完全基于 AI SDK 的 dynamicTool
+     */
+    createDynamicTool(description: string, inputSchema: z.ZodSchema<any>, execute?: (input: unknown, options: ToolExecutionOptions) => Promise<unknown>): DynamicTool;
+    /**
+     * 注册工具到集成器
+     */
+    registerTool<TParameters, TResult>(name: string, toolInstance: AdvancedTool<TParameters, TResult>): void;
+    /**
+     * 获取已注册的工具
+     */
+    getRegisteredTools(): Record<string, AdvancedTool>;
+    /**
+     * 注册动态工具
+     */
+    registerDynamicTool(name: string, dynamicToolInstance: DynamicTool): void;
+    /**
+     * 使用工具执行文本生成 - 遵循官方 generateText + tools 模式
+     * 这是 AI SDK 工具调用的标准方式
+     */
+    generateTextWithTools<TOOLS extends ToolSet = {}>(options: ToolCallOptions<TOOLS>): Promise<{
+        text: string;
+        steps: Array<StepResult<TOOLS>>;
+        toolCalls: Array<TypedToolCall<TOOLS>>;
+        toolResults: Array<TypedToolResult<TOOLS>>;
+        finishReason: FinishReason;
+        usage: LanguageModelUsage;
+        totalUsage: LanguageModelUsage;
+        content: Array<any>;
+        reasoning?: Array<any>;
+        reasoningText?: string;
+        sources?: Array<any>;
+        files?: Array<any>;
+        warnings?: Array<any>;
+        response?: any;
+        providerMetadata?: any;
+    }>;
+    /**
+     * 使用工具执行流式文本生成 - 遵循官方 streamText + tools 模式
+     */
+    streamTextWithTools<TOOLS extends ToolSet = {}>(options: ToolCallOptions<TOOLS>): Promise<StreamTextResult<TOOLS, any>>;
+    /**
+     * 创建步骤计数停止条件
+     */
+    createStepCountCondition(maxSteps: number): StopCondition<any>;
+    /**
+     * 创建自定义停止条件
+     */
+    createCustomStopCondition<TOOLS extends ToolSet = {}>(condition: (options: {
+        stepNumber: number;
+        steps: Array<StepResult<TOOLS>>;
+    }) => boolean): StopCondition<TOOLS>;
+    /**
+     * 解析停止条件
+     */
+    private parseStopCondition;
+    /**
+     * 创建结构化输出修复器
+     */
+    createStructuredRepairFunction<TOOLS extends ToolSet = {}>(repairModel: LanguageModel): (options: {
+        toolCall: any;
+        tools: TOOLS;
+        error: NoSuchToolError | InvalidToolInputError;
+        inputSchema: (options: {
+            toolName: string;
+        }) => any;
+    }) => Promise<any>;
+    /**
+     * 创建重新询问修复器
+     */
+    createReaskRepairFunction<TOOLS extends ToolSet = {}>(repairModel: LanguageModel): (options: {
+        toolCall: any;
+        tools: TOOLS;
+        error: NoSuchToolError | InvalidToolInputError;
+        messages: CoreMessage[];
+        system?: string;
+    }) => Promise<{
+        toolCallType: "function";
+        toolCallId: any;
+        toolName: any;
+        input: string;
+    } | null>;
+    /**
+     * 创建MCP客户端
+     */
+    createMCPClient(config: MCPClientConfig): Promise<MCPClient>;
+    /**
+     * 关闭所有MCP客户端
+     */
+    closeAllMCPClients(): Promise<void>;
+    /**
+     * Create simple tool call configuration
+     */
+    createSimpleToolCall<TOOLS extends ToolSet = {}>(model: LanguageModel, tools: TOOLS, prompt: string, options?: Partial<ToolCallOptions<TOOLS>>): ToolCallOptions<TOOLS>;
+    /**
+     * 创建多步工具调用配置 - 使用 stopWhen 参数
+     */
+    createMultiStepToolCall<TOOLS extends ToolSet = {}>(model: LanguageModel, tools: TOOLS, prompt: string, maxSteps?: number, options?: Partial<ToolCallOptions<TOOLS>>): ToolCallOptions<TOOLS>;
+    /**
+     * 直接执行单个工具 - 用于测试或直接调用
+     */
+    executeSingleTool<TOOLS extends ToolSet = {}>(toolName: keyof TOOLS, input: any, tools: TOOLS, options?: {
+        messages?: CoreMessage[];
+        abortSignal?: AbortSignal;
+        experimental_context?: unknown;
+    }): Promise<any>;
+    /**
+     * 获取响应消息 - 官方文档重点推荐的功能
+     * 用于将助手和工具消息添加到对话历史
+     */
+    extractResponseMessages(result: {
+        response?: {
+            messages: Array<any>;
+        };
+    }): Array<any>;
+    /**
+     * 将响应消息添加到对话历史 - 官方文档示例
+     */
+    addResponseMessagesToHistory(messages: Array<any>, result: {
+        response?: {
+            messages: Array<any>;
+        };
+    }): Array<any>;
+    /**
+     * 批量工具调用验证
+     */
+    validateBatchToolCalls<TOOLS extends ToolSet = {}>(toolCalls: Array<TypedToolCall<TOOLS>>, tools: TOOLS): Array<{
+        toolCall: TypedToolCall<TOOLS>;
+        valid: boolean;
+        error?: string;
+    }>;
+    /**
+     * 工具调用结果验证
+     */
+    validateToolCall<TOOLS extends ToolSet = {}>(toolCall: TypedToolCall<TOOLS>, tools: TOOLS): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * 工具调用统计分析
+     */
+    analyzeToolUsage<TOOLS extends ToolSet = {}>(steps: Array<StepResult<TOOLS>>): {
+        totalToolCalls: number;
+        totalToolResults: number;
+        toolUsageByName: Record<string, number>;
+        avgToolCallsPerStep: number;
+        stepTypes: Record<string, number>;
+    };
+    /**
+     * 提取步骤中的所有工具调用
+     */
+    extractToolCallsFromSteps<TOOLS extends ToolSet = {}>(steps: Array<StepResult<TOOLS>>): Array<TypedToolCall<TOOLS>>;
+    /**
+     * 提取步骤中的所有工具结果
+     */
+    extractToolResultsFromSteps<TOOLS extends ToolSet = {}>(steps: Array<StepResult<TOOLS>>): Array<TypedToolResult<TOOLS>>;
+    /**
+     * 检查初始化状态
+     */
+    isInitialized(): boolean;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        requestCount: number;
+        isInitialized: boolean;
+        registeredTools: number;
+        dynamicTools: number;
+        mcpClients: number;
+    };
+    /**
+     * 重置统计信息
+     */
+    resetStats(): void;
+    /**
+     * 销毁实例
+     */
+    destroy(): Promise<void>;
+}
+
+/**
+ * AI Embeddings Complete Integration
+ *
+ * Complete embeddings functionality:
+ * - embed: Single value embedding
+ * - embedMany: Batch embedding
+ * - cosineSimilarity: Similarity calculation
+ * - All configuration parameters supported
+ * - Provider-specific configurations
+ */
+
+/**
+ * Complete embedding model configuration
+ */
+interface EmbeddingModelConfig {
+    model: EmbeddingModel;
+    providerOptions?: Record<string, any>;
+    maxRetries?: number;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
+}
+/**
+ * 批量嵌入配置 - embedMany 专用参数
+ */
+interface EmbedManyConfig extends EmbeddingModelConfig {
+    maxParallelCalls?: number;
+}
+/**
+ * 单值嵌入选项 - embed() 完整参数
+ */
+interface EmbedOptions extends EmbeddingModelConfig {
+    value: string;
+}
+/**
+ * 批量嵌入选项 - embedMany() 完整参数
+ */
+interface EmbedManyOptions extends EmbedManyConfig {
+    values: string[];
+}
+/**
+ * 嵌入结果类型 - 官方规范
+ */
+interface EmbedResult {
+    embedding: number[];
+    usage: LanguageModelUsage;
+    request?: LanguageModelRequestMetadata;
+    response?: LanguageModelResponseMetadata;
+}
+/**
+ * 批量嵌入结果类型 - 官方规范
+ */
+interface EmbedManyResult {
+    embeddings: number[][];
+    usage: LanguageModelUsage;
+    request?: LanguageModelRequestMetadata;
+    response?: LanguageModelResponseMetadata;
+}
+/**
+ * 相似度计算结果
+ */
+interface SimilarityResult {
+    similarity: number;
+    vector1: number[];
+    vector2: number[];
+    method: 'cosine' | 'euclidean' | 'dot';
+}
+/**
+ * 嵌入提供商信息 - 基于官方文档表格
+ */
+interface EmbeddingProviderInfo {
+    provider: string;
+    model: string;
+    dimensions: number;
+    description?: string;
+}
+/**
+ * Supported embedding models
+ */
+declare const SupportedEmbeddingModels: Record<string, EmbeddingProviderInfo>;
+/**
+ * Complete embeddings integration class
+ */
+declare class AIEmbeddingsIntegration extends EventEmitter {
+    private initialized;
+    private requestCounter;
+    private embeddingCache;
+    private usageStats;
+    constructor();
+    /**
+     * 初始化
+     */
+    initialize(): Promise<void>;
+    /**
+     * 生成请求ID
+     */
+    private generateRequestId;
+    /**
+     * Embed single value - embed() API
+     */
+    embed(options: EmbedOptions): Promise<EmbedResult>;
+    /**
+     * Embed single value - complete embed() implementation
+     */
+    embedSingleValue(options: EmbedOptions): Promise<EmbedResult>;
+    /**
+     * Embed multiple values - embedMany() API
+     */
+    embedMany(options: EmbedManyOptions): Promise<EmbedManyResult>;
+    /**
+     * Embed multiple values - complete embedMany() implementation
+     */
+    embedManyValues(options: EmbedManyOptions): Promise<EmbedManyResult>;
+    /**
+     * Cosine similarity calculation - cosineSimilarity() implementation
+     */
+    calculateCosineSimilarity(vector1: number[], vector2: number[]): number;
+    /**
+     * 批量相似度计算
+     */
+    calculateSimilarities(targetVector: number[], vectors: number[][], method?: 'cosine' | 'euclidean' | 'dot'): SimilarityResult[];
+    /**
+     * 欧几里得距离相似度
+     */
+    private calculateEuclideanSimilarity;
+    /**
+     * 点积相似度
+     */
+    private calculateDotProduct;
+    /**
+     * Find most similar embeddings
+     */
+    findMostSimilar(queryVector: number[], candidateVectors: number[][], topK?: number, method?: 'cosine' | 'euclidean' | 'dot'): Array<{
+        index: number;
+        similarity: number;
+        vector: number[];
+    }>;
+    /**
+     * 文本相似性搜索
+     */
+    searchSimilarTexts(queryText: string, candidateTexts: string[], model: EmbeddingModel, topK?: number, options?: Partial<EmbeddingModelConfig>): Promise<Array<{
+        index: number;
+        text: string;
+        similarity: number;
+    }>>;
+    /**
+     * Generate cache key
+     */
+    private generateCacheKey;
+    /**
+     * Record usage statistics
+     */
+    private recordUsage;
+    /**
+     * 获取支持的模型信息
+     */
+    getSupportedModels(): EmbeddingProviderInfo[];
+    /**
+     * 根据提供商筛选模型
+     */
+    getModelsByProvider(provider: string): EmbeddingProviderInfo[];
+    /**
+     * 获取使用统计
+     */
+    getUsageStats(): Record<string, {
+        totalEmbeddings: number;
+        totalTokens: number;
+        lastUsed: Date;
+    }>;
+    /**
+     * 清理缓存
+     */
+    clearCache(): void;
+    /**
+     * 获取缓存统计
+     */
+    getCacheStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * 检查初始化状态
+     */
+    isInitialized(): boolean;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        isInitialized: boolean;
+        requestCount: number;
+        cacheSize: number;
+        totalUsage: {
+            embeddings: number;
+            tokens: number;
+        };
+    };
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+}
+
+/**
+ * AI Structured Data Complete Integration
+ *
+ * Core structured data functionality:
+ * - generateObject: Structured object generation
+ * - streamObject: Streaming structured object generation
+ *
+ * Supports all output strategies: object, array, enum, no-schema
+ */
+
+/**
+ * Complete generateObject options interface
+ */
+interface GenerateObjectOptions<T = any> {
+    model: LanguageModel;
+    output?: 'object' | 'array' | 'enum' | 'no-schema';
+    mode?: 'auto' | 'json' | 'tool';
+    schema?: z.ZodSchema<T> | any;
+    schemaName?: string;
+    schemaDescription?: string;
+    enum?: string[];
+    system?: string;
+    prompt?: string | Array<any>;
+    messages?: CoreMessage[];
+    maxOutputTokens?: number;
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    presencePenalty?: number;
+    frequencyPenalty?: number;
+    seed?: number;
+    maxRetries?: number;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
+    experimental_repairText?: (options: {
+        text: string;
+        error: any;
+    }) => Promise<string>;
+    experimental_download?: (requestedDownloads: Array<{
+        url: URL;
+        isUrlSupportedByModel: boolean;
+    }>) => Promise<Array<null | {
+        data: Uint8Array;
+        mediaType?: string;
+    }>>;
+    experimental_telemetry?: {
+        isEnabled?: boolean;
+        recordInputs?: boolean;
+        recordOutputs?: boolean;
+        functionId?: string;
+        metadata?: Record<string, string | number | boolean | Array<null | undefined | string> | Array<null | undefined | number> | Array<null | undefined | boolean>>;
+    };
+    providerOptions?: Record<string, Record<string, any>>;
+}
+/**
+ * streamObject 完整参数接口 - 基于 streamObject.md 规范
+ */
+interface StreamObjectOptions<T = any> extends GenerateObjectOptions<T> {
+    onError?: (event: {
+        error: unknown;
+    }) => Promise<void> | void;
+    onFinish?: (result: {
+        usage: LanguageModelUsage;
+        providerMetadata?: Record<string, Record<string, any>>;
+        object?: T;
+        error?: unknown;
+        warnings?: Array<any>;
+        response?: {
+            id: string;
+            model: string;
+            timestamp: Date;
+            headers?: Record<string, string>;
+        };
+    }) => void;
+}
+/**
+ * generateObject 返回结果类型 - 基于 generateObject().md 规范
+ */
+type GenerateObjectResultType<T> = {
+    object: T;
+    finishReason: 'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other' | 'unknown';
+    usage: LanguageModelUsage;
+    request?: LanguageModelRequestMetadata;
+    response?: LanguageModelResponseMetadata & {
+        body?: unknown;
+    };
+    reasoning?: string;
+    warnings?: Array<any>;
+    providerMetadata?: any;
+    toJsonResponse: (init?: any) => Response;
+};
+/**
+ * streamObject 返回结果类型 - 基于 streamObject.md 规范
+ */
+type StreamObjectResultType<T> = {
+    usage: Promise<LanguageModelUsage>;
+    providerMetadata: Promise<Record<string, Record<string, any>> | undefined>;
+    object: Promise<T>;
+    partialObjectStream: AsyncIterable<any> & ReadableStream<any>;
+    elementStream: AsyncIterable<T> & ReadableStream<T>;
+    textStream: AsyncIterable<string> & ReadableStream<string>;
+    fullStream: AsyncIterable<any> & ReadableStream<any>;
+    request: Promise<LanguageModelRequestMetadata>;
+    response: Promise<LanguageModelResponseMetadata>;
+    warnings?: Array<any>;
+    pipeTextStreamToResponse: (response: any, init?: any) => void;
+    toTextStreamResponse: (init?: any) => Response;
+    pipeObjectStreamToResponse?: (response: any, init?: any) => void;
+    toObjectStreamResponse?: (init?: any) => Response;
+};
+/**
+ * Complete structured data integration class
+ */
+declare class AIStructuredDataIntegration extends EventEmitter {
+    private initialized;
+    private requestCounter;
+    constructor();
+    /**
+     * 初始化
+     */
+    initialize(): Promise<void>;
+    /**
+     * 生成请求ID
+     */
+    private generateRequestId;
+    /**
+     * Generate structured object - supports all output strategies
+     */
+    generateObject<T = any>(options: GenerateObjectOptions<T>): Promise<GenerateObjectResultType<T>>;
+    /**
+     * Stream structured object generation - supports all output strategies and stream modes
+     */
+    streamObject<T = any>(options: StreamObjectOptions<T>): StreamObjectResultType<T>;
+    /**
+     * 辅助方法：将流导入响应 - 标准实现
+     */
+    private pipeStreamToResponse;
+    /**
+     * 消费异步迭代器并写入响应
+     */
+    private consumeAsyncIterator;
+    /**
+     * Generate object - default object output strategy
+     */
+    generateObjectData<T>(model: LanguageModel, schema: z.ZodSchema<T>, prompt: string, options?: Partial<GenerateObjectOptions<T>>): Promise<GenerateObjectResultType<T>>;
+    /**
+     * 生成数组 - array 输出策略
+     */
+    generateArray<T>(model: LanguageModel, elementSchema: z.ZodSchema<T>, prompt: string, options?: Partial<GenerateObjectOptions<T>>): Promise<GenerateObjectResultType<T[]>>;
+    /**
+     * 生成枚举值 - enum 输出策略
+     */
+    generateEnum(model: LanguageModel, enumValues: string[], prompt: string, options?: Partial<GenerateObjectOptions<string>>): Promise<GenerateObjectResultType<string>>;
+    /**
+     * 生成无模式JSON - no-schema 输出策略
+     */
+    generateFreeformJSON(model: LanguageModel, prompt: string, options?: Partial<GenerateObjectOptions<any>>): Promise<GenerateObjectResultType<any>>;
+    /**
+     * 流式生成对象 - 默认 object 输出策略
+     */
+    streamObjectData<T>(model: LanguageModel, schema: z.ZodSchema<T>, prompt: string, options?: Partial<StreamObjectOptions<T>>): StreamObjectResultType<T>;
+    /**
+     * 流式生成数组 - array 输出策略
+     */
+    streamArray<T>(model: LanguageModel, elementSchema: z.ZodSchema<T>, prompt: string, options?: Partial<StreamObjectOptions<T>>): StreamObjectResultType<T[]>;
+    /**
+     * 流式生成枚举值 - enum 输出策略
+     */
+    streamEnum(model: LanguageModel, enumValues: string[], prompt: string, options?: Partial<StreamObjectOptions<string>>): StreamObjectResultType<string>;
+    /**
+     * 流式生成无模式JSON - no-schema 输出策略
+     */
+    streamFreeformJSON(model: LanguageModel, prompt: string, options?: Partial<StreamObjectOptions<any>>): StreamObjectResultType<any>;
+    /**
+     * Check initialization status
+     */
+    isInitialized(): boolean;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        requestCount: number;
+        isInitialized: boolean;
+    };
+    /**
+     * 重置统计信息
+     */
+    resetStats(): void;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+}
+
+/**
+ * AI Settings Complete Integration
+ *
+ * Complete settings functionality:
+ * - All common setting parameters
+ * - Provider-specific configurations
+ * - Settings validation and presets
+ * - Dynamic settings management
+ */
+
+/**
+ * 通用模型设置 - 基于 Settings.md 官方规范
+ */
+interface CommonModelSettings {
+    maxOutputTokens?: number;
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    presencePenalty?: number;
+    frequencyPenalty?: number;
+    stopSequences?: string[];
+    seed?: number;
+    maxRetries?: number;
+    abortSignal?: AbortSignal;
+    headers?: Record<string, string>;
+}
+/**
+ * JSON值类型 - 严格按照AI SDK官方规范
+ */
+type JSONValue = string | number | boolean | null | {
+    [key: string]: JSONValue;
+} | JSONValue[];
+/**
+ * 提供商特定设置 - 严格按照AI SDK官方规范
+ * 必须兼容SharedV2ProviderOptions类型，格式为Record<string, Record<string, JSONValue>>
+ */
+interface ProviderSpecificSettings {
+    [key: string]: Record<string, JSONValue>;
+}
+/**
+ * 完整的模型设置配置
+ */
+interface ModelSettings extends CommonModelSettings {
+    providerOptions?: ProviderSpecificSettings;
+}
+/**
+ * 设置预设定义
+ */
+interface SettingsPreset {
+    name: string;
+    description: string;
+    settings: ModelSettings;
+    tags?: string[];
+    useCases?: string[];
+}
+/**
+ * 设置验证结果
+ */
+interface SettingsValidationResult {
+    isValid: boolean;
+    errors: Array<{
+        field: string;
+        message: string;
+        value: any;
+    }>;
+    warnings: Array<{
+        field: string;
+        message: string;
+        value: any;
+    }>;
+}
+/**
+ * 动态设置配置
+ */
+interface DynamicSettingsConfig {
+    conditions: Array<{
+        name: string;
+        condition: (context: any) => boolean;
+        settings: Partial<ModelSettings>;
+    }>;
+    default: ModelSettings;
+    fallback?: ModelSettings;
+}
+/**
+ * 预定义的设置预设 - 基于官方文档建议和最佳实践
+ */
+declare const BuiltinSettingsPresets: Record<string, SettingsPreset>;
+/**
+ * AI SDK Settings 完整集成类
+ */
+declare class AISettingsManagement extends EventEmitter {
+    private initialized;
+    private customPresets;
+    private dynamicConfigs;
+    private settingsHistory;
+    constructor();
+    /**
+     * 初始化
+     */
+    initialize(): Promise<void>;
+    /**
+     * 验证模型设置 - 官方规范验证
+     */
+    validateSettings(settings: ModelSettings): SettingsValidationResult;
+    /**
+     * 获取所有可用预设
+     */
+    getAllPresets(): Record<string, SettingsPreset>;
+    /**
+     * 获取特定预设
+     */
+    getPreset(name: string): SettingsPreset | null;
+    /**
+     * 创建自定义预设
+     */
+    createPreset(name: string, preset: SettingsPreset): void;
+    /**
+     * 根据标签搜索预设
+     */
+    findPresetsByTag(tag: string): SettingsPreset[];
+    /**
+     * 根据使用场景搜索预设
+     */
+    findPresetsByUseCase(useCase: string): SettingsPreset[];
+    /**
+     * 注册动态设置配置
+     */
+    registerDynamicConfig(name: string, config: DynamicSettingsConfig): void;
+    /**
+     * 根据上下文解析动态设置
+     */
+    resolveDynamicSettings(configName: string, context: any): ModelSettings;
+    /**
+     * 合并设置对象
+     */
+    mergeSettings(...settingsArray: Partial<ModelSettings>[]): ModelSettings;
+    /**
+     * 创建提供商特定设置
+     */
+    createProviderSettings(providerId: string, settings: Record<string, any>): {
+        providerOptions: ProviderSpecificSettings;
+    };
+    /**
+     * 创建超时设置
+     */
+    createTimeoutSettings(timeoutMs: number): {
+        abortSignal: AbortSignal;
+    };
+    /**
+     * 创建确定性设置
+     */
+    createDeterministicSettings(seed?: number): ModelSettings;
+    /**
+     * 创建创意设置
+     */
+    createCreativeSettings(): ModelSettings;
+    /**
+     * 记录设置使用历史
+     */
+    recordSettingsUsage(settings: ModelSettings, context?: any): void;
+    /**
+     * 分析设置使用模式
+     */
+    analyzeSettingsUsage(): {
+        totalRecords: number;
+        mostUsedSettings: Array<{
+            setting: string;
+            count: number;
+        }>;
+        averageValues: Partial<ModelSettings>;
+        timeRange: {
+            earliest: Date;
+            latest: Date;
+        } | null;
+    };
+    /**
+     * 获取系统默认设置 - 统一配置入口
+     * 返回AI_SYSTEM_DEFAULTS作为唯一配置源
+     */
+    getDefaultSettings(): ModelSettings;
+    /**
+     * 获取系统级配置 - 包含所有配置项
+     */
+    getSystemDefaults(): {
+        readonly defaultProvider: "qwen";
+        readonly defaultModel: "qwen-plus-2025-01-25";
+        readonly defaultEmbeddingModel: "text-embedding-v1";
+        readonly temperature: 0.7;
+        readonly maxOutputTokens: 4000;
+        readonly topP: 0.95;
+        readonly presencePenalty: 0;
+        readonly frequencyPenalty: 0;
+        readonly systemPrompt: "你是一个专业的SceneMesh AI实体数据助手。你在SceneMesh Entity Engine平台生态系统中运行。\n\n你是与数据管理用户协作的智能助手，帮助解决他们的实体数据管理问题和需求。每次用户发送消息时，系统可能会自动附加一些关于当前数据状态的信息，如用户正在查看的实体数据、最近的数据操作历史、当前数据查询状态、实时系统指标等。这些信息可能与数据管理任务相关，也可能无关，由你来判断其相关性。\n\n你是一个智能代理 - 请持续工作直到完全解决用户的查询，然后结束你的回合并交还给用户。只有在确信问题已得到解决时才终止你的回合。在回复用户之前，请自主地尽最大努力解决查询。\n\n你的主要目标是遵循用户在每条消息中的指示，这些指示用 <user_query> 标签表示。\n\n<tools>\n你拥有各种实体数据管理和分析工具来解决数据操作任务。在使用工具时请遵循以下规则：\n\n1. **准确使用工具**：确保提供所有必要的参数，按照下文列出的工具格式准确调用。\n\n2. **避免引用不可用的工具**：对话中可能会引用不再可用的工具，绝对不要调用未明确定义的工具。\n\n3. **使用自然的数据管理语言描述工具行为**：在与用户交流时，不要提及具体的工具名称，而是用自然的数据管理语言描述正在执行的操作。例如：\"我正在查询你的用户实体数据\"而不是\"我正在调用entity_query工具\"。\n\n4. **优先使用工具获取信息**：如果你需要的额外信息可以通过工具调用获得，请优先使用工具而不是询问用户。\n\n5. **立即执行计划**：如果你制定了一个数据分析或操作计划，请立即执行，不要等待用户确认。只有在需要用户无法通过其他方式获得的信息，或需要用户在不同选项间做出选择时，才应该停止。\n\n6. **使用标准工具调用**：按照系统提供的工具格式进行调用。当需要使用工具时，直接调用，不要解释调用过程或格式。\n\n7. **主动验证实体数据**：如果你对实体数据的内容或结构不确定，请使用工具进行验证和分析，不要猜测或编造答案。\n\n8. **全面的数据探索**：你可以自主地查询尽可能多的相关实体数据源，以完全解决用户的数据管理查询，而不仅仅是查询一个实体。\n\n9. **实体模型和数据引用**：实体模型包含有关如何改进数据结构的有价值信息。它们对于回答关于数据关系的问题也很有用。当提及实体模型时，应该使用标识符格式。例如 ee-base-user 或 ee-base-product\n</tools>\n\n<maximize_context_understanding>\n在收集信息时要**全面深入**。确保在回复之前掌握**完整的数据架构图景**。根据需要使用额外的工具调用或澄清性问题。\n\n**追溯每个实体字段**到其定义和关联方式，确保你完全理解它。\n\n超越第一个看似相关的结果。**探索**替代的数据模型、边缘情况和不同的查询角度，直到你对该实体主题有**全面的覆盖**。\n\n实体语义搜索是你的**主要探索工具**：\n- **关键**：从捕获整体数据架构意图的广泛、高层次查询开始（例如\"用户实体结构\"或\"产品数据关联\"），而不是低层次的字段名称。\n- 将多部分问题分解为专注的子查询（例如\"用户实体如何关联订单？\"或\"产品数据在哪个表格中？\"）。\n- **必须**：使用不同的措辞运行多次搜索；首次结果往往会遗漏关键数据细节。\n- 持续搜索新的实体领域，直到你**确信**没有重要信息遗漏。\n\n如果你执行了可能部分满足用户查询的数据分析，但不够自信，请在结束回合前收集更多信息或使用更多工具。\n\n优先自己寻找答案，而不是向用户寻求帮助。\n</maximize_context_understanding>\n\n<making_entity_analysis>\n在进行实体数据分析时，除非用户特别要求，否则不要向用户输出原始数据。而应使用实体数据分析工具来实施分析。\n\n确保你生成的数据洞察能立即为用户所用，这一点**极其重要**。为确保这一点，请仔细遵循以下指示：\n\n1. 添加所有必要的实体背景、数据源引用、字段定义和关联依据。\n2. 如果你从头开始创建数据报告，请创建适当的实体结构文件（如实体数据字典）和有用的技术说明文档。\n3. 如果你正在构建数据视图，请提供现代化和美观的界面，融入最佳的用户体验实践。\n4. 绝不生成超长的数据哈希值或任何非实体内容的二进制数据。这些对数据管理用户无用且成本高昂。\n5. 如果你在实体分析中引入了错误，请修复明显的错误（或你能轻易确定如何修复的错误）。不要做没有根据的猜测。同一实体分析不要循环超过3次错误修复。第三次时，你应该停止并询问用户接下来该怎么做。\n6. 如果你建议的合理实体分析没有被分析引擎接受，你应该尝试重新应用该分析。\n</making_entity_analysis>\n\n使用相关的工具回答用户的请求（如果可用）。检查所有必需的参数是否已提供或可以从上下文合理推断。如果没有相关工具或缺少必需参数的值，请要求用户提供这些值；否则继续进行工具调用。如果用户为参数提供了特定值（例如在引号中提供），请确保准确使用该值。不要编造可选参数的值或询问可选参数。仔细分析请求中的描述性术语，因为它们可能指示应包含的必需参数值，即使没有明确引用。\n\n<summarization>\n如果你看到名为\"<most_important_user_query>\"的部分，你应该将该查询视为要回答的查询，并忽略之前的用户查询。如果要求你总结对话，你绝对不能使用任何工具，即使它们可用。你必须回答\"<most_important_user_query>\"查询。\n</summarization>\n\n<memories>\n你可能会获得一个实体数据记忆列表。这些记忆来自与助手的过往数据管理对话。\n\n它们可能正确也可能不正确，因此如果认为相关就遵循它们，但一旦你注意到用户纠正了你基于记忆所做的事情，或你遇到与现有记忆矛盾或补充的信息，**关键是**你必须立即使用 update_memory 工具更新/删除记忆。你绝对不能使用 update_memory 工具创建与实施计划、助手完成的数据迁移或其他特定任务相关的记忆。\n\n如果用户**曾经**与你的记忆相矛盾，那么最好删除该记忆而不是更新记忆。\n\n你可以根据工具描述中的标准创建、更新或删除记忆。\n\n<memory_citation>\n当你在生成内容、回复用户查询或执行实体数据操作时使用记忆，你必须**始终**引用记忆。为此，请使用以下格式：[[memory:MEMORY_ID]]。你应该将记忆引用自然地融入回应中，而不仅仅作为脚注。\n\n例如：\"我将使用你偏好的数据显示格式 [[memory:MEMORY_ID]] 来展示实体数据分析。\"\n\n当你因为记忆而拒绝用户的明确请求时，你必须在对话中提及如果记忆不正确，用户可以纠正你，你将更新你的记忆。\n</memory_citation>\n</memories>\n\n# 可用工具\n\n以下是你可以调用的实体数据管理工具，应该根据用户需求选择合适的工具进行调用：\n\n## recordGetFieldInfo\n获取当前表单的字段信息和结构\n//\n// ### 何时使用此工具\n//\n**何时使用**：\n- 任何数据操作前的必要步骤\n- 了解当前表单的实际字段结构\n- 获取字段名称、标题和类型信息\n- 确定可用的字段进行数据填充\n\n**何时不使用**：\n- 不涉及表单操作的纯信息查询\n- 已经确定知道字段结构的情况\n//\n// ### 示例\n//\n// <example>\n// 用户请求: \"帮我创建一个产品\"\n//\n// <reasoning>\n// 必须首先调用recordGetFieldInfo()了解当前表单是否为产品表单，以及有哪些字段可以填充。\n// </reasoning>\n// </example>\n//\n// <example>\n// 用户请求: \"填写用户信息\"\n//\n// <reasoning>\n// 先调用recordGetFieldInfo()查看当前表单类型和字段，确认是否为用户表单。\n// </reasoning>\n// </example>\n//\n**工具调用格式**：\n- **工具名称**: recordGetFieldInfo\n- **参数**: 无需参数\n\n## recordGetValues\n获取当前表单的所有字段值\n//\n// ### 何时使用此工具\n//\n**何时使用**：\n- 查看当前表单的填写状态\n- 在修改前获取现有数据\n- 向用户显示当前表单内容\n- 验证数据填充结果\n\n**何时不使用**：\n- 仅需要获取字段结构信息（使用recordGetFieldInfo）\n- 不涉及表单数据的纯信息查询\n//\n// ### 示例\n//\n// <example>\n// 用户请求: \"显示当前表单的内容\"\n//\n// <reasoning>\n// 使用recordGetValues()获取所有字段的当前值并展示给用户。\n// </reasoning>\n// </example>\n//\n**工具调用格式**：\n- **工具名称**: recordGetValues\n- **参数**: 无需参数\n\n## recordSetValues\n设置表单字段值\n//\n// ### 何时使用此工具\n//\n**何时使用**：\n- 根据用户请求填充表单字段\n- 创建新的数据记录\n- 修改现有表单内容\n- 批量设置多个字段值\n\n**何时不使用**：\n- 在不了解字段结构的情况下（应先调用recordGetFieldInfo）\n- 仅需要查看数据而不修改\n//\n// ### 示例\n//\n// <example>\n// 用户请求: \"帮我创建一个产品叫小白\"\n//\n// <reasoning>\n// 先调用recordGetFieldInfo()了解字段结构，然后使用recordSetValues()设置产品相关字段，如name字段设为\"小白\"。\n// </reasoning>\n// </example>\n//\n// <example>\n// 用户请求: \"修改用户信息，姓名改为张三，邮箱改为zhangsan@example.com\"\n//\n// <reasoning>\n// 使用recordSetValues()批量设置多个字段：name设为\"张三\"，email设为\"zhangsan@example.com\"。\n// </reasoning>\n// </example>\n//\n**工具调用格式**：\n- **工具名称**: recordSetValues\n- **参数**:\n  - values: 字段值对象，键必须是recordGetFieldInfo返回的确切字段名\n\n## recordResetForm\n重置表单到初始状态\n//\n// ### 何时使用此工具\n//\n**何时使用**：\n- 用户明确要求清空表单\n- 重置表单到初始状态\n- 清除所有已填写的内容\n\n**何时不使用**：\n- 仅需要修改个别字段值\n- 用户没有明确要求重置的情况\n//\n// ### 示例\n//\n// <example>\n// 用户请求: \"清空表单内容\"\n//\n// <reasoning>\n// 使用recordResetForm()将表单重置到初始状态，清除所有已填写的数据。\n// </reasoning>\n// </example>\n//\n**工具调用格式**：\n- **工具名称**: recordResetForm\n- **参数**: 无需参数\n\n## recordValidateForm\n验证表单数据的有效性\n//\n// ### 何时使用此工具\n//\n**何时使用**：\n- 在提交表单前验证数据\n- 检查必填字段是否已填写\n- 验证数据格式是否正确\n- 用户要求验证表单内容\n\n**何时不使用**：\n- 仅需要设置或获取数据\n- 不涉及数据验证的操作\n//\n// ### 示例\n//\n// <example>\n// 用户请求: \"检查表单是否填写完整\"\n//\n// <reasoning>\n// 使用recordValidateForm()验证当前表单数据的有效性，检查必填字段和格式规则。\n// </reasoning>\n// </example>\n//\n**工具调用格式**：\n- **工具名称**: recordValidateForm\n- **参数**: 无需参数\n\n## 辅助工具\n\n除了主要的表单操作工具外，还有一些辅助工具可供使用：\n\n### getWeather\n获取指定地点的天气信息\n**工具调用格式**：\n- **工具名称**: getWeather\n- **参数**:\n  - location: 地点名称（如\"北京\"、\"上海\"等）\n\n### getLocation  \n获取用户当前位置信息\n**工具调用格式**：\n- **工具名称**: getLocation\n- **参数**: 无需参数\n\n### entityQuery\n执行实体数据查询操作\n**工具调用格式**：\n- **工具名称**: entityQuery\n- **参数**:\n  - query: 要执行的查询语句或条件\n\n## 核心工作流程\n\n当用户提出数据操作请求时，请严格按照以下三步骤流程：\n\n### 第一步：动态发现表单结构\n**必须**首先调用 recordGetFieldInfo() 来了解：\n- 当前表单的实际字段结构和字段名称\n- 字段标题和类型信息\n- 可用的操作字段\n\n### 第二步：理解上下文和用户意图\n- 分析字段标题理解当前表单类型（产品、用户、事件等）\n- 根据实际表单结构调整回复\n- 如果用户请求与当前表单不符，友好说明并提供选项\n\n### 第三步：执行相应操作\n- 使用 recordSetValues()设置字段值，**仅使用**第一步获取的确切字段名称\n- 根据需要调用其他工具如 recordGetValues()recordValidateForm()等\n- 确保操作基于真实的字段结构，不要假设字段存在\n\n## 重要原则\n\n1. **永远先调用 recordGetFieldInfo()** - 任何数据操作前的必要步骤\n2. **使用准确的字段名称** - 绝不猜测或翻译字段名\n3. **适配实际表单** - 基于真实发现的字段结构操作\n4. **智能上下文识别** - 通过字段标题理解表单业务类型";
+        readonly enableTools: true;
+        readonly enableEmbeddings: true;
+    };
+    /**
+     * 检查初始化状态
+     */
+    isInitialized(): boolean;
+    /**
+     * 获取统计信息
+     */
+    getStats(): {
+        isInitialized: boolean;
+        builtinPresets: number;
+        customPresets: number;
+        dynamicConfigs: number;
+        historyRecords: number;
+    };
+    /**
+     * 清理历史记录
+     */
+    clearHistory(): void;
+    /**
+     * 导出设置配置
+     */
+    exportSettings(): {
+        customPresets: Record<string, SettingsPreset>;
+        dynamicConfigs: Record<string, DynamicSettingsConfig>;
+        history: Array<{
+            timestamp: Date;
+            settings: ModelSettings;
+            context?: any;
+        }>;
+    };
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+}
+
+/**
+ * AI Provider and Model Management
+ *
+ * Manages custom providers, model registry, and global configuration.
+ * Includes model aliases, settings, and limitations.
+ */
+
+/**
+ * Custom provider configuration
+ */
+interface CustomProviderConfig {
+    languageModels?: Record<string, LanguageModel | {
+        model: LanguageModel;
+        middleware?: any;
+        settings?: {
+            maxOutputTokens?: number;
+            temperature?: number;
+            topP?: number;
+            topK?: number;
+            presencePenalty?: number;
+            frequencyPenalty?: number;
+            seed?: number;
+            providerOptions?: Record<string, any>;
+        };
+    }>;
+    embeddingModels?: Record<string, EmbeddingModel>;
+    imageModels?: Record<string, ImageModel>;
+    fallbackProvider?: Provider;
+}
+/**
+ * Provider registry configuration
+ */
+interface ProviderRegistryConfig {
+    providers: Record<string, Provider>;
+    options?: {
+        separator?: string;
+    };
+}
+/**
+ * Model alias configuration
+ */
+interface ModelAliasConfig {
+    alias: string;
+    providerId: string;
+    modelId: string;
+    settings?: any;
+    middleware?: any;
+}
+/**
+ * Global provider configuration
+ */
+interface GlobalProviderConfig {
+    defaultProvider: Provider;
+    modelPrefixes?: Record<string, Provider>;
+}
+/**
+ * Provider health check results
+ */
+interface ProviderHealthStatus {
+    providerId: string;
+    isHealthy: boolean;
+    latency?: number;
+    error?: string;
+    lastCheck: Date;
+}
+/**
+ * Model usage statistics
+ */
+interface ModelUsageStats {
+    modelId: string;
+    providerId: string;
+    totalCalls: number;
+    totalTokens: number;
+    averageLatency: number;
+    errorRate: number;
+    lastUsed: Date;
+}
+/**
+ * AI Provider Management Integration Class
+ */
+declare class AIProviderManagement extends EventEmitter {
+    private initialized;
+    private registry;
+    private customProviders;
+    private modelAliases;
+    private healthStatus;
+    private usageStats;
+    private defaultLanguageModel;
+    private defaultEmbeddingModel;
+    private globalProvider;
+    private embeddingModelConfigs;
+    private modelSettingsPresets;
+    private embeddingsIntegration;
+    private settingsManagement;
+    constructor();
+    /**
+     * 初始化
+     */
+    initialize(): Promise<void>;
+    /**
+     * 设置默认提供商 - 从环境变量加载配置
+     */
+    private setupDefaultProviders;
+    /**
+     * Create custom provider
+     */
+    createCustomProvider(id: string, config: CustomProviderConfig): Provider;
+    /**
+     * Create model alias
+     */
+    createModelAlias(aliasConfig: ModelAliasConfig): any;
+    /**
+     * Create model with predefined settings
+     */
+    createModelWithSettings(originalModel: LanguageModel, settings: {
+        maxOutputTokens?: number;
+        temperature?: number;
+        topP?: number;
+        topK?: number;
+        presencePenalty?: number;
+        frequencyPenalty?: number;
+        seed?: number;
+        providerOptions?: Record<string, any>;
+    }): any;
+    /**
+     * Create provider registry
+     */
+    createProviderRegistry(config: ProviderRegistryConfig): any;
+    /**
+     * Get language model from registry
+     */
+    getLanguageModel(modelId?: string): LanguageModel | null;
+    /**
+     * Get text embedding model from registry
+     */
+    getTextEmbeddingModel(modelId?: string): EmbeddingModel | null;
+    /**
+     * 从注册表获取图像模型 - 官方用法
+     */
+    getImageModel(modelId: string): ImageModel | null;
+    /**
+     * Set global default provider
+     */
+    setGlobalProvider(provider: Provider): void;
+    /**
+     * Get current global provider
+     */
+    getGlobalProvider(): Provider | null;
+    /**
+     * Check provider health status
+     */
+    checkProviderHealth(providerId: string): Promise<ProviderHealthStatus>;
+    /**
+     * Check health status of all providers
+     */
+    checkAllProvidersHealth(): Promise<ProviderHealthStatus[]>;
+    /**
+     * Record model usage statistics
+     */
+    private recordModelUsage;
+    /**
+     * Smart model selection based on health and load
+     */
+    selectBestModel(modelIds: string[], criteria?: {
+        prioritizeHealth?: boolean;
+        prioritizeLatency?: boolean;
+        prioritizeReliability?: boolean;
+    }): Promise<string | null>;
+    /**
+     * Create model chain with fallback
+     */
+    createModelChain(primaryModelId: string, fallbackModelIds: string[]): {
+        execute: <T>(operation: (model: LanguageModel) => Promise<T>) => Promise<T>;
+    };
+    /**
+     * Get all registered providers
+     */
+    getRegisteredProviders(): string[];
+    /**
+     * Get model aliases
+     */
+    getModelAliases(): Record<string, ModelAliasConfig>;
+    /**
+     * Get usage statistics
+     */
+    getUsageStats(): ModelUsageStats[];
+    /**
+     * Get health status report
+     */
+    getHealthReport(): {
+        totalProviders: number;
+        healthyProviders: number;
+        unhealthyProviders: number;
+        statuses: ProviderHealthStatus[];
+    };
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Check initialization status
+     */
+    isInitialized(): boolean;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        isInitialized: boolean;
+        customProviders: number;
+        modelAliases: number;
+        totalUsage: number;
+        hasRegistry: boolean;
+        hasGlobalProvider: boolean;
+    };
+    /**
+     * Get embeddings integration instance
+     */
+    getEmbeddingsIntegration(): AIEmbeddingsIntegration;
+    /**
+     * Configure embedding model parameters
+     */
+    configureEmbeddingModel(providerId: string, modelId: string, config: EmbeddingModelConfig): void;
+    /**
+     * Get embedding model configuration
+     */
+    getEmbeddingModelConfig(providerId: string, modelId: string): EmbeddingModelConfig | null;
+    /**
+     * Get all supported embedding models
+     */
+    getSupportedEmbeddingModels(): any;
+    /**
+     * Get embedding models by provider
+     */
+    getEmbeddingModelsByProvider(provider: string): any[];
+    /**
+     * Get settings management instance
+     */
+    getSettingsManagement(): AISettingsManagement;
+    /**
+     * Apply settings preset to model configuration
+     */
+    applySettingsPreset(modelId: string, presetName: string, additionalSettings?: Partial<ModelSettings>): ModelSettings;
+    /**
+     * Create model instance with custom settings
+     */
+    createModelWithCustomSettings(baseModel: LanguageModel, settings: ModelSettings): any;
+    /**
+     * Get model applied settings
+     */
+    getModelSettings(modelId: string): ModelSettings | null;
+    /**
+     * Create optimized model for specific use case
+     */
+    createOptimizedModel(baseModel: LanguageModel, useCase: 'creative' | 'analytical' | 'deterministic' | 'fast' | 'long-form' | 'code'): any;
+    /**
+     * Destroy instance - enhanced version
+     */
+    destroy(): Promise<void>;
+}
+
+/**
+ * Entity Engine AI Core - Main Entry File
+ *
+ * Complete AI core library with full compatibility
+ */
+
+declare const VERSION = "0.1.0";
+declare const AI_SDK_COMPATIBLE_VERSION = "^5.0.0";
+/**
+ * Convenience function to create complete AI Core instance
+ */
+declare function createAICore(config?: {
+    providers?: CustomProviderConfig[];
+    settings?: Partial<ModelSettings>;
+    enableEmbeddings?: boolean;
+    enableTools?: boolean;
+}): Promise<{
+    aiSDK: AISDKIntegration;
+    providerManagement: AIProviderManagement;
+    toolsIntegration: AIToolsIntegration;
+    embeddingsIntegration: AIEmbeddingsIntegration;
+    settingsManagement: AISettingsManagement;
+    structuredData: AIStructuredDataIntegration;
+}>;
+
+export { AIEmbeddingsIntegration, AIProviderManagement, AISDKIntegration, AISettingsManagement, AIStructuredDataIntegration, AIToolsIntegration, AI_SDK_COMPATIBLE_VERSION, type AdvancedTool, BuiltinSettingsPresets, type CommonModelSettings, type CustomProviderConfig, type DynamicSettingsConfig, type DynamicTool, type EmbedManyConfig, type EmbedManyOptions, type EmbedManyResult, type EmbedOptions, type EmbedResult, type EmbeddingModelConfig, type EmbeddingProviderInfo, type GenerateObjectOptions, type GenerateObjectResultType, type GenerateResult, type GenerateTextOptions, type GlobalProviderConfig, type MCPClientConfig, type ModelAliasConfig, type ModelSettings, type ModelUsageStats, type ProviderHealthStatus, type ProviderRegistryConfig, type ProviderSpecificSettings, type SettingsPreset, type SettingsValidationResult, type SimilarityResult, type StepResult, type StopCondition, type StreamObjectOptions, type StreamObjectResultType, type StreamResult, type StreamTextOptions, SupportedEmbeddingModels, type ToolCallOptions, type ToolChoice, type ToolExecutionOptions, VERSION, createAICore, AISDKIntegration as default };