oricore 1.3.1 → 1.3.3

package/README.md

@@ -74,11 +74,11 @@ const engine = createEngine({
 
 // 2. Initialize with model and API key
 await engine.initialize({
-  model: 'zhipuai/glm-4.7',
+  model: 'openai/gpt-5.2-codex',
   provider: {
-    zhipuai: {
+    openai: {
       apiKey: 'your-api-key',
-      baseURL: 'https://open.bigmodel.cn/api/paas/v4',
+      baseURL: 'https://api.openai.com/v1',
     },
   },
 });
@@ -142,19 +142,19 @@ OriCore includes a comprehensive set of tools:
 
 ```typescript
 await engine.initialize({
-  model: 'zhipuai/glm-4.7',
-  planModel: 'zhipuai/glm-4.7',
+  model: 'openai/gpt-5.2-codex',
+  planModel: 'openai/gpt-5.2-codex',
   approvalMode: 'autoEdit',
-  language: 'zh-CN',
+  language: 'en',
   tools: {
     read: true,
     write: true,
     bash: true,
   },
   provider: {
-    zhipuai: {
+    openai: {
       apiKey: 'your-api-key',
-      baseURL: 'https://open.bigmodel.cn/api/paas/v4',
+      baseURL: 'https://api.openai.com/v1',
     },
   },
 });
@@ -164,14 +164,16 @@ await engine.initialize({
 
 | Provider | Model Example | API Base URL |
 |----------|---------------|--------------|
-| Zhipu AI | `zhipuai/glm-4.7` | `https://open.bigmodel.cn/api/paas/v4` |
+| OpenAI | `openai/gpt-5.2-codex` | `https://api.openai.com/v1` |
+| Anthropic | `anthropic/claude-opus-4-5` | `https://api.anthropic.com` |
+| Google | `google/gemini-3-flash-preview` | `https://generativelanguage.googleapis.com` |
 | DeepSeek | `deepseek/deepseek-chat` | `https://api.deepseek.com` |
-| OpenAI | `openai/gpt-4o` | `https://api.openai.com/v1` |
-| Anthropic | `anthropic/claude-sonnet-4` | `https://api.anthropic.com` |
-| Google | `google/gemini-2.5-flash` | `https://generativelanguage.googleapis.com` |
+| Zhipu AI | `zhipuai/glm-4.7` | `https://open.bigmodel.cn/api/paas/v4` |
 
 See [USAGE.md](./USAGE.md) for more configuration options.
 
+**Tool Approval System:** See [APPROVAL.md](./APPROVAL.md) for detailed information about the approval system, including approval modes (`default`, `autoEdit`, `yolo`), custom approval handlers, and best practices.
+
 ## Project Structure
 
 ```
@@ -190,12 +192,12 @@ oricore/
 └── dist/              # Compiled output
 ```
 
-## Acknowledgments
+## Statement
 
-This project is based on the core architecture of excellent projects:
-- **[neovate-code](https://github.com/neovacode/neovate-code)** - Core AI engine architecture
+This project references the core architecture of the following excellent project:
+- **[neovate-code](https://github.com/neovateai/neovate-code)** - Core AI engine architecture
 
-OriCore has been refactored and streamlined, removing UI, CLI, and other peripheral features to focus on providing a lightweight, standalone AI engine library that can be easily integrated into any project.
+OriCore has been refactored and streamlined on this foundation, removing UI, CLI, and other peripheral features to focus on providing a lightweight, standalone AI engine library that can be easily integrated into any project.
 
 ## License
 

package/README.zh-CN.md

@@ -74,11 +74,11 @@ const engine = createEngine({
 
 // 2. 初始化模型和 API Key
 await engine.initialize({
-  model: 'zhipuai/glm-4.7',
+  model: 'openai/gpt-5.2-codex',
   provider: {
-    zhipuai: {
+    openai: {
       apiKey: 'your-api-key',
-      baseURL: 'https://open.bigmodel.cn/api/paas/v4',
+      baseURL: 'https://api.openai.com/v1',
     },
   },
 });
@@ -142,8 +142,8 @@ OriCore 包含一套完整的工具：
 
 ```typescript
 await engine.initialize({
-  model: 'zhipuai/glm-4.7',
-  planModel: 'zhipuai/glm-4.7',
+  model: 'openai/gpt-5.2-codex',
+  planModel: 'openai/gpt-5.2-codex',
   approvalMode: 'autoEdit',
   language: 'zh-CN',
   tools: {
@@ -152,9 +152,9 @@ await engine.initialize({
     bash: true,
   },
   provider: {
-    zhipuai: {
+    openai: {
       apiKey: 'your-api-key',
-      baseURL: 'https://open.bigmodel.cn/api/paas/v4',
+      baseURL: 'https://api.openai.com/v1',
     },
   },
 });
@@ -164,14 +164,16 @@ await engine.initialize({
 
 | 提供商 | 模型示例 | API 地址 |
 |----------|---------------|--------------|
-| 智谱 AI | `zhipuai/glm-4.7` | `https://open.bigmodel.cn/api/paas/v4` |
+| OpenAI | `openai/gpt-5.2-codex` | `https://api.openai.com/v1` |
+| Anthropic | `anthropic/claude-opus-4-5` | `https://api.anthropic.com` |
+| Google | `google/gemini-3-flash-preview` | `https://generativelanguage.googleapis.com` |
 | DeepSeek | `deepseek/deepseek-chat` | `https://api.deepseek.com` |
-| OpenAI | `openai/gpt-4o` | `https://api.openai.com/v1` |
-| Anthropic | `anthropic/claude-sonnet-4` | `https://api.anthropic.com` |
-| Google | `google/gemini-2.5-flash` | `https://generativelanguage.googleapis.com` |
+| 智谱 AI | `zhipuai/glm-4.7` | `https://open.bigmodel.cn/api/paas/v4` |
 
 更多配置选项请参阅 [USAGE.zh-CN.md](./USAGE.zh-CN.md)。
 
+**工具审批系统：** 有关审批系统的详细信息，包括审批模式（`default`、`autoEdit`、`yolo`）、自定义审批处理程序和最佳实践，请参阅 [APPROVAL.zh-CN.md](./APPROVAL.zh-CN.md)。
+
 ## 项目结构
 
 ```
@@ -190,10 +192,10 @@ oricore/
 └── dist/              # 编译输出
 ```
 
-## 致谢
+## 声明
 
 本项目参考了以下优秀项目的核心架构：
-- **[neovate-code](https://github.com/neovacode/neovate-code)** - 核心 AI 引擎架构
+- **[neovate-code](https://github.com/neovateai/neovate-code)** - 核心 AI 引擎架构
 
 OriCore 在此基础上进行了重新封装和精简，移除了 UI、CLI 等周边功能，专注于提供一个轻量、独立的 AI 引擎库，可轻松集成到任何项目中。
 

package/dist/core/config.d.ts

@@ -1,4 +1,5 @@
 import type { Provider } from '../core/model';
+import { type ValidationResult } from './configValidation';
 export type McpStdioServerConfig = {
     type: 'stdio';
     command: string;
@@ -93,8 +94,27 @@ export declare class ConfigManager {
     argvConfig: Partial<Config>;
     globalConfigPath: string;
     projectConfigPath: string;
+    private validationEnabled;
     constructor(cwd: string, productName: string, argvConfig: Partial<Config>);
     get config(): Config;
+    /**
+     * Enable configuration validation
+     * When enabled, invalid configurations will throw errors
+     */
+    enableValidation(): void;
+    /**
+     * Disable configuration validation
+     */
+    disableValidation(): void;
+    /**
+     * Validate the current configuration
+     * Returns validation result without throwing
+     */
+    validate(): ValidationResult;
+    /**
+     * Get validation errors as a formatted string
+     */
+    getValidationErrors(): string;
     removeConfig(global: boolean, key: string, values?: string[]): void;
     addConfig(global: boolean, key: string, values: string[]): void;
     getConfig(global: boolean, key: string): any;

package/dist/core/configValidation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Configuration Validation
+ * Runtime validation for engine configuration
+ */
+import type { Config } from './config';
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    value?: any;
+}
+export interface ValidationWarning {
+    path: string;
+    message: string;
+    value?: any;
+}
+/**
+ * Validate a configuration object
+ */
+export declare function validateConfig(config: Partial<Config>): ValidationResult;
+/**
+ * Format validation errors for display
+ */
+export declare function formatValidationErrors(result: ValidationResult): string;
+/**
+ * Assert that configuration is valid, throws if not
+ */
+export declare function assertValidConfig(config: Partial<Config>): void;

package/dist/core/history.d.ts

@@ -17,8 +17,17 @@ export declare class History {
     compress(model: ModelInfo): Promise<{
         compressed: boolean;
         summary?: undefined;
+        fallback?: undefined;
+        error?: undefined;
     } | {
         compressed: boolean;
         summary: string;
+        fallback: boolean;
+        error: string;
+    } | {
+        compressed: boolean;
+        summary: string;
+        fallback: boolean;
+        error?: undefined;
     }>;
 }