oricore 1.3.0 → 1.3.2

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,11 +164,11 @@ 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.
 
@@ -190,6 +190,13 @@ oricore/
 └── dist/              # Compiled output
 ```
 
+## Statement
+
+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 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
 
 MIT © [lyw405](https://github.com/lyw405)

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,11 +164,11 @@ 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)。
 
@@ -190,6 +190,13 @@ oricore/
 └── dist/              # 编译输出
 ```
 
+## 声明
+
+本项目参考了以下优秀项目的核心架构：
+- **[neovate-code](https://github.com/neovateai/neovate-code)** - 核心 AI 引擎架构
+
+OriCore 在此基础上进行了重新封装和精简，移除了 UI、CLI 等周边功能，专注于提供一个轻量、独立的 AI 引擎库，可轻松集成到任何项目中。
+
 ## 许可证
 
 MIT © [lyw405](https://github.com/lyw405)

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;
     }>;
 }

package/dist/session/session.d.ts

@@ -2,6 +2,7 @@ import type { ApprovalMode } from '../core/config';
 import { History } from '../core/history';
 import type { NormalizedMessage } from '../core/message';
 import { Usage } from '../core/usage';
+import type { ModeType } from '../modes/types';
 export type SessionId = string;
 export declare class Session {
     id: SessionId;
@@ -31,11 +32,14 @@ export type SessionConfig = {
 export declare class SessionConfigManager {
     logPath: string;
     config: SessionConfig;
+    mode: ModeType | null;
     constructor(opts: {
         logPath: string;
     });
     load(logPath: string): SessionConfig;
-    write(): void;
+    setMode(mode: ModeType): void;
+    getMode(): ModeType | null;
+    write(): Promise<void>;
 }
 export declare function filterMessages(messages: NormalizedMessage[]): NormalizedMessage[];
 export declare function loadSessionMessages(opts: {

package/dist/utils/fileLock.d.ts

@@ -0,0 +1,55 @@
+/**
+ * File-based lock for concurrent write safety
+ * Uses lock files with unique identifiers to prevent race conditions
+ */
+export declare class FileLock {
+    private lockFilePath;
+    private lockId;
+    private acquired;
+    constructor(filePath: string);
+    /**
+     * Attempt to acquire the lock
+     * @returns true if lock was acquired, false otherwise
+     */
+    acquire(): Promise<boolean>;
+    /**
+     * Release the lock
+     * Only releases if this instance holds the lock (matching lockId)
+     */
+    release(): void;
+    /**
+     * Execute a callback while holding the lock
+     * Automatically acquires and releases the lock
+     */
+    withLock<T>(callback: () => T | Promise<T>): Promise<T>;
+    /**
+     * Read and parse the lock file
+     */
+    private readLockFile;
+    /**
+     * Check if a lock has expired (older than timeout)
+     */
+    private isLockExpired;
+    /**
+     * Force release any existing lock (use with caution)
+     * This can be used to recover from stale locks
+     */
+    forceRelease(): void;
+}
+/**
+ * Global lock registry to manage multiple locks
+ * Helps prevent deadlocks and track active locks
+ */
+declare class LockRegistry {
+    private locks;
+    /**
+     * Get or create a lock for a file path
+     */
+    getLock(filePath: string): FileLock;
+    /**
+     * Release all locks (useful for cleanup)
+     */
+    releaseAll(): void;
+}
+export declare const lockRegistry: LockRegistry;
+export {};

package/dist/utils/pdf-parser.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PDF Parser Utility
+ * Extracts text content from PDF files
+ */
+export interface ParseResult {
+    text: string;
+    pageCount: number;
+    metadata?: {
+        title?: string;
+        author?: string;
+        subject?: string;
+        keywords?: string;
+        creator?: string;
+        producer?: string;
+        creationDate?: string;
+        modificationDate?: string;
+    };
+}
+export interface ParseOptions {
+    /**
+     * Maximum number of pages to parse (0 = all pages)
+     * @default 0
+     */
+    maxPages?: number;
+    /**
+     * Maximum text length per page (0 = no limit)
+     * @default 10000
+     */
+    maxCharsPerPage?: number;
+    /**
+     * Include metadata in the result
+     * @default true
+     */
+    includeMetadata?: boolean;
+}
+/**
+ * Parse a PDF file and extract text content
+ *
+ * @param filePath - Absolute path to the PDF file
+ * @param options - Parsing options
+ * @returns Parsed PDF content
+ */
+export declare function parsePDF(filePath: string, options?: ParseOptions): Promise<ParseResult>;
+/**
+ * Check if PDF parsing is available (pdf-parse is installed)
+ */
+export declare function isPDFParsingAvailable(): Promise<boolean>;
+/**
+ * Format PDF parse result for LLM consumption
+ */
+export declare function formatPDFResult(result: ParseResult): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oricore",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "OriCore - A powerful AI engine with multi-modal support, tool calling, and extensible architecture",
   "type": "module",
   "main": "./dist/index.js",
@@ -78,7 +78,8 @@
     "tar": "^7.5.2",
     "turndown": "^7.2.2",
     "ws": "^8.18.3",
-    "zod": "^4.1.13"
+    "zod": "^4.1.13",
+    "jsonrepair": "^3.10.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",

package/src/core/loop.ts

@@ -545,6 +545,41 @@ export async function runLoop(opts: RunLoopOpts): Promise<LoopResult> {
       input: Record<string, any>;
       result: ToolResult;
     }[] = [];
+
+    // Helper function to add denied results for unprocessed tools
+    const addDeniedResultsForRemainingTools = async () => {
+      const processedToolCallIds = new Set(
+        toolResults.map((tr) => tr.toolCallId),
+      );
+      for (const remainingToolCall of toolCalls) {
+        if (!processedToolCallIds.has(remainingToolCall.toolCallId)) {
+          const remainingToolUse: ToolUse = {
+            name: remainingToolCall.toolName,
+            params: safeParseJson(remainingToolCall.input),
+            callId: remainingToolCall.toolCallId,
+          };
+          let remainingToolResult: ToolResult = {
+            llmContent:
+              'Error: Tool execution was skipped due to previous tool denial.',
+            isError: true,
+          };
+          if (opts.onToolResult) {
+            remainingToolResult = await opts.onToolResult(
+              remainingToolUse,
+              remainingToolResult,
+              false,
+            );
+          }
+          toolResults.push({
+            toolCallId: remainingToolCall.toolCallId,
+            toolName: remainingToolCall.toolName,
+            input: safeParseJson(remainingToolCall.input),
+            result: remainingToolResult,
+          });
+        }
+      }
+    };
+
     for (const toolCall of toolCalls) {
       let toolUse: ToolUse = {
         name: toolCall.toolName,
@@ -609,6 +644,9 @@ export async function runLoop(opts: RunLoopOpts): Promise<LoopResult> {
           result: toolResult,
         });
 
+        // Add denied results for remaining unprocessed tools
+        await addDeniedResultsForRemainingTools();
+
         if (!denyReason) {
           await history.addMessage({
             role: 'tool',

package/src/core/model.ts

@@ -1812,8 +1812,18 @@ export const providers: ProvidersMap = {
     doc: 'https://cerebras.ai/docs',
     models: {
       'zai-glm-4.6': models['glm-4.6'],
-      'zai-glm-4.7': models['glm-4.7'],
-      'gpt-oss-120b': models['gpt-oss-120b'],
+      'zai-glm-4.7': {
+        ...models['glm-4.7'],
+        // ref: https://inference-docs.cerebras.ai/models/zai-glm-47
+        // default use the context of free tier
+        limit: { context: 64000, output: 40000 },
+      },
+      'gpt-oss-120b': {
+        ...models['gpt-oss-120b'],
+        // ref: https://inference-docs.cerebras.ai/models/openai-oss
+        // default use the context of free tier
+        limit: { context: 65000, output: 32000 },
+      },
     },
     createModel(name, provider) {
       const apiKey = getProviderApiKey(provider);

package/src/mcp/mcp.ts

@@ -335,10 +335,27 @@ export class MCPManager {
         '@ai-sdk/mcp/mcp-stdio'
       );
 
+      // Windows: if command is npx/npm/yarn/pnpm/bun/bunx, use cmd.exe to execute, fix: spawn npx ENOENT error
+      const windowsShellCommands = [
+        'npx',
+        'npm',
+        'yarn',
+        'pnpm',
+        'bun',
+        'bunx',
+      ];
+      let command = config.command;
+      let args = config.args;
+      const isWin = process.platform === 'win32';
+      if (isWin && windowsShellCommands.includes(command.toLowerCase())) {
+        args = ['/c', command, ...(args || [])];
+        command = 'cmd.exe';
+      }
+
       return experimental_createMCPClient({
         transport: new Experimental_StdioMCPTransport({
-          command: config.command,
-          args: config.args,
+          command,
+          args,
           stderr: 'ignore',
           env,
         }),

package/src/utils/safeParseJson.ts

@@ -1,7 +1,20 @@
+import createDebug from 'debug';
+import { jsonrepair } from 'jsonrepair';
+
+const debug = createDebug('oricore:utils:safeParseJson');
+
 export function safeParseJson(json: string) {
   try {
     return JSON.parse(json);
   } catch (_error) {
-    return {};
+    // try to repair the json
+    try {
+      debug('safeParseJson failed, trying to repair', _error);
+      const repairedJson = jsonrepair(json);
+      return JSON.parse(repairedJson);
+    } catch (_repairError) {
+      debug('safeParseJson failed, repair failed', _repairError);
+      return {};
+    }
   }
 }