@reverse-craft/ai-tools 1.0.0 → 1.0.2

package/README.md

@@ -1,12 +1,14 @@
 # @reverse-craft/ai-tools
 
-AI-powered code analysis tools for smart-fs. Provides LLM-driven functionality including JSVMP (JavaScript Virtual Machine Protection) dispatcher detection.
+MCP server for AI-powered JSVMP detection. Provides LLM-driven code analysis tools for identifying JavaScript Virtual Machine Protection patterns.
 
 ## Features
 
+- **MCP Server** - Model Context Protocol server for AI assistant integration
 - **JSVMP Detection** - Detect VM protection patterns using LLM analysis
-- **LLM Configuration** - Flexible OpenAI-compatible API configuration
-- **Code Formatting** - Format code for LLM analysis with source map coordinates
+- **Multiple LLM Providers** - Support for OpenAI, Anthropic Claude, and Google Gemini
+- **Multiple Pattern Types** - Identifies dispatchers, instruction arrays, stack operations
+- **Confidence Levels** - Results include ultra_high, high, medium, low confidence ratings
 
 ## Installation
 
@@ -16,114 +18,239 @@ npm install @reverse-craft/ai-tools
 
 ## Configuration
 
-Set environment variables for LLM access:
+### LLM Provider Selection
+
+Set `LLM_PROVIDER` to choose your AI provider (defaults to `openai`):
+
+```bash
+export LLM_PROVIDER=openai    # or anthropic, google
+```
+
+### Universal Configuration (applies to any provider)
+
+```bash
+export LLM_PROVIDER=openai           # Provider selection
+export LLM_MODEL=gpt-4o              # Override model for any provider
+export LLM_BASE_URL=https://custom.api.com  # Override base URL for any provider
+```
+
+### OpenAI Configuration
 
 ```bash
-# Required
+export LLM_PROVIDER=openai
 export OPENAI_API_KEY=your-api-key
+export OPENAI_MODEL=gpt-4o-mini          # Optional, default: gpt-4o-mini
+export OPENAI_BASE_URL=https://api.openai.com/v1  # Optional, for custom endpoints
+```
+
+### Anthropic Claude Configuration
+
+```bash
+export LLM_PROVIDER=anthropic
+export ANTHROPIC_API_KEY=your-api-key
+export ANTHROPIC_MODEL=claude-sonnet-4-20250514  # Optional, default: claude-sonnet-4-20250514
+export ANTHROPIC_BASE_URL=https://api.anthropic.com  # Optional, for custom endpoints
+```
+
+### Google Gemini Configuration
+
+```bash
+export LLM_PROVIDER=google
+export GOOGLE_API_KEY=your-api-key
+export GOOGLE_MODEL=gemini-2.0-flash     # Optional, default: gemini-2.0-flash
+export GOOGLE_BASE_URL=https://generativelanguage.googleapis.com  # Optional, for custom endpoints
+```
+
+### Environment Variables Summary
+
+| Variable | Provider | Required | Default | Description |
+|----------|----------|----------|---------|-------------|
+| `LLM_PROVIDER` | All | No | `openai` | LLM provider selection |
+| `LLM_MODEL` | All | No | - | Universal model override (highest priority) |
+| `LLM_BASE_URL` | All | No | - | Universal base URL override (highest priority) |
+| `OPENAI_API_KEY` | OpenAI | Yes* | - | OpenAI API key |
+| `OPENAI_MODEL` | OpenAI | No | `gpt-4o-mini` | Model to use |
+| `OPENAI_BASE_URL` | OpenAI | No | SDK default | Custom API endpoint |
+| `ANTHROPIC_API_KEY` | Anthropic | Yes* | - | Anthropic API key |
+| `ANTHROPIC_MODEL` | Anthropic | No | `claude-sonnet-4-20250514` | Model to use |
+| `ANTHROPIC_BASE_URL` | Anthropic | No | SDK default | Custom API endpoint |
+| `GOOGLE_API_KEY` | Google | Yes* | - | Google API key |
+| `GOOGLE_MODEL` | Google | No | `gemini-2.0-flash` | Model to use |
+| `GOOGLE_BASE_URL` | Google | No | SDK default | Custom API endpoint |
+
+*Required only when using the corresponding provider
+
+**Priority Order:**
+- Model: `LLM_MODEL` > `{PROVIDER}_MODEL` > default
+- Base URL: `LLM_BASE_URL` > `{PROVIDER}_BASE_URL` > SDK default
+
+## MCP Server Usage
 
-# Optional (defaults shown)
-export OPENAI_BASE_URL=https://api.openai.com/v1
-export OPENAI_MODEL=gpt-4
+### Running the Server
+
+```bash
+# Via npx
+npx @reverse-craft/ai-tools
+
+# Or if installed globally
+ai-tools-mcp
 ```
 
-## Usage
+### MCP Configuration
 
-### JSVMP Dispatcher Detection
+Add to your MCP client configuration (e.g., Claude Desktop, Kiro):
 
-```typescript
-import { findJsvmpDispatcher } from '@reverse-craft/ai-tools';
+**Using OpenAI:**
 
-const result = await findJsvmpDispatcher(
-  './obfuscated.js',
-  1,      // startLine
-  500,    // endLine
-  { charLimit: 300 }
-);
+```json
+{
+  "mcpServers": {
+    "ai-tools": {
+      "command": "npx",
+      "args": ["@reverse-craft/ai-tools"],
+      "env": {
+        "OPENAI_API_KEY": "your-api-key",
+        "OPENAI_MODEL": "gpt-4o-mini",
+        "OPENAI_BASE_URL": "https://api.openai.com/v1"
+      }
+    }
+  }
+}
+```
 
-if (result.success) {
-  console.log(result.formattedOutput);
-  // Detected regions with confidence levels
-  for (const region of result.result.regions) {
-    console.log(`[${region.confidence}] Lines ${region.start}-${region.end}: ${region.type}`);
+**Using Anthropic Claude:**
+
+```json
+{
+  "mcpServers": {
+    "ai-tools": {
+      "command": "npx",
+      "args": ["@reverse-craft/ai-tools"],
+      "env": {
+        "LLM_PROVIDER": "anthropic",
+        "ANTHROPIC_API_KEY": "your-api-key",
+        "ANTHROPIC_MODEL": "claude-sonnet-4-20250514",
+        "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
+      }
+    }
   }
 }
 ```
 
-### LLM Configuration
+**Using Google Gemini:**
+
+```json
+{
+  "mcpServers": {
+    "ai-tools": {
+      "command": "npx",
+      "args": ["@reverse-craft/ai-tools"],
+      "env": {
+        "LLM_PROVIDER": "google",
+        "GOOGLE_API_KEY": "your-api-key",
+        "GOOGLE_MODEL": "gemini-2.0-flash",
+        "GOOGLE_BASE_URL": "https://generativelanguage.googleapis.com"
+      }
+    }
+  }
+}
+```
 
-```typescript
-import { getLLMConfig, isLLMConfigured, createLLMClient } from '@reverse-craft/ai-tools';
+**Using Universal Configuration (works with any provider):**
+
+```json
+{
+  "mcpServers": {
+    "ai-tools": {
+      "command": "npx",
+      "args": ["@reverse-craft/ai-tools"],
+      "env": {
+        "LLM_PROVIDER": "openai",
+        "OPENAI_API_KEY": "your-api-key",
+        "LLM_MODEL": "gpt-4o",
+        "LLM_BASE_URL": "https://your-custom-endpoint.com/v1"
+      }
+    }
+  }
+}
+```
 
-// Check if LLM is configured
-if (isLLMConfigured()) {
-  const config = getLLMConfig();
-  const client = createLLMClient(config);
+Or with a local installation:
+
+```json
+{
+  "mcpServers": {
+    "ai-tools": {
+      "command": "node",
+      "args": ["/path/to/ai-tools/dist/server.js"],
+      "env": {
+        "OPENAI_API_KEY": "your-api-key"
+      }
+    }
+  }
 }
 ```
 
-### Code Formatting for Analysis
+## MCP Tools
 
-```typescript
-import { formatCodeForAnalysis } from '@reverse-craft/ai-tools';
+### find_jsvmp_dispatcher
 
-const formatted = await formatCodeForAnalysis(
-  './app.min.js',
-  1,      // startLine
-  100,    // endLine
-  300     // charLimit
-);
+Detect JSVMP (JavaScript Virtual Machine Protection) patterns in code using LLM analysis.
 
-console.log(formatted.content);
-// Output: "LineNo SourceLoc Code" format
-```
+**Parameters:**
 
-## API
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| filePath | string | Yes | Path to the JavaScript file to analyze |
+| startLine | number | Yes | Start line number (1-based) |
+| endLine | number | Yes | End line number (1-based) |
+| charLimit | number | No | Character limit for string truncation (default: 300) |
 
-### Types
+**Detection Types:**
 
-```typescript
-// Detection types
-type DetectionType = 
-  | "If-Else Dispatcher" 
-  | "Switch Dispatcher" 
-  | "Instruction Array" 
-  | "Stack Operation";
+- **If-Else Dispatcher** - Nested if-else chains for instruction dispatch
+- **Switch Dispatcher** - Large switch statements (>20 cases) for opcode handling
+- **Instruction Array** - Arrays storing bytecode instructions
+- **Stack Operation** - Virtual stack push/pop patterns
 
-type ConfidenceLevel = "ultra_high" | "high" | "medium" | "low";
+**Confidence Levels:**
 
-interface DetectionRegion {
-  start: number;
-  end: number;
-  type: DetectionType;
-  confidence: ConfidenceLevel;
-  description: string;
-}
+- `ultra_high` - Multiple JSVMP features present (loop + dispatcher + stack)
+- `high` - Clear dispatcher structure (>20 cases or >10 nesting levels)
+- `medium` - Partial JSVMP features
+- `low` - Possible but uncertain patterns
+
+**Example Response:**
 
-interface JsvmpDetectionResult {
-  success: boolean;
-  filePath: string;
-  startLine: number;
-  endLine: number;
-  result?: DetectionResult;
-  formattedOutput?: string;
-  error?: string;
-}
 ```
+=== JSVMP Dispatcher Detection Result ===
+File: ./obfuscated.js (1-500)
+
+Summary: 检测到典型的 JSVMP 保护结构，包含主分发器和栈操作
+
+Detected Regions:
+[ultra_high] Lines 45-280: Switch Dispatcher
+  大型 switch 语句包含 47 个 case，典型的 JSVMP 指令分发器
+
+[high] Lines 12-44: Stack Operation
+  虚拟栈初始化和操作，使用数组索引进行 push/pop
+```
+
+## What is JSVMP?
+
+JSVMP (JavaScript Virtual Machine Protection) is a code protection technique that:
 
-### Functions
+1. Converts JavaScript source code to custom bytecode
+2. Implements a virtual machine to execute the bytecode
+3. Uses dispatchers (switch/if-else) to handle different opcodes
+4. Maintains a virtual stack for operand storage
 
-- `findJsvmpDispatcher(filePath, startLine, endLine, options?)` - Detect JSVMP patterns
-- `formatCodeForAnalysis(filePath, startLine, endLine, charLimit?)` - Format code for LLM
-- `parseDetectionResult(jsonString)` - Parse LLM response
-- `getLLMConfig()` - Get LLM configuration from environment
-- `isLLMConfigured()` - Check if LLM is configured
-- `createLLMClient(config)` - Create LLM client instance
+This makes reverse engineering significantly harder as the original logic is hidden behind VM interpretation.
 
 ## Related Packages
 
-- **[@reverse-craft/smart-fs](https://github.com/reverse-craft/smart-fs)** - Core library
-- **[@reverse-craft/smart-fs-mcp](https://github.com/reverse-craft/smart-fs-mcp)** - MCP server
+- **[@reverse-craft/smart-fs](https://github.com/reverse-craft/smart-fs)** - Core library for code processing
+- **[@reverse-craft/smart-fs-mcp](https://github.com/reverse-craft/smart-fs-mcp)** - MCP server for smart-fs
 
 ## License
 

package/dist/__tests__/batchProcessing.property.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Property-based tests for batch processing logic
+ *
+ * Tests the createBatches function and line number preservation.
+ *
+ * **Property 4: Original line numbers preserved in batches**
+ * **Validates: Requirements 4.4**
+ */
+export {};
+//# sourceMappingURL=batchProcessing.property.test.d.ts.map

package/dist/__tests__/batchProcessing.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchProcessing.property.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/batchProcessing.property.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/errorHandling.property.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Property-based tests for error handling logic
+ *
+ * Tests the processBatchesWithErrorHandling function.
+ *
+ * **Property 8: Partial failure continues processing**
+ * **Property 9: Total failure reports all errors**
+ * **Validates: Requirements 6.1, 6.2, 6.3**
+ */
+export {};
+//# sourceMappingURL=errorHandling.property.test.d.ts.map

package/dist/__tests__/errorHandling.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandling.property.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/errorHandling.property.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/llmConfig.property.test.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Property-Based Tests for LLM Configuration Module
+ *
+ * **Feature: multi-provider-llm**
+ *
+ * **Property 1: Valid Provider Selection**
+ * *For any* valid provider value ('openai', 'anthropic', 'google'), when `LLM_PROVIDER` is set
+ * to that value and the corresponding API key is present, `getLLMConfig()` SHALL return a config
+ * with that provider.
+ * **Validates: Requirements 1.1, 1.2, 1.3**
+ *
+ * **Property 2: Invalid Provider Returns Null**
+ * *For any* string that is not a valid provider value ('openai', 'anthropic', 'google'),
+ * when `LLM_PROVIDER` is set to that string, `getLLMConfig()` SHALL return null.
+ * **Validates: Requirements 1.5**
+ *
+ * **Property 3: Correct API Key Selection**
+ * *For any* provider, `getLLMConfig()` SHALL read the API key from the provider-specific
+ * environment variable.
+ * **Validates: Requirements 2.1, 2.2, 2.3**
+ *
+ * **Property 4: Missing API Key Returns Null**
+ * *For any* provider, if the corresponding API key environment variable is not set,
+ * `getLLMConfig()` SHALL return null.
+ * **Validates: Requirements 2.4**
+ *
+ * **Property 5: Custom Model Selection**
+ * *For any* provider, when the provider-specific model environment variable is set,
+ * `getLLMConfig()` SHALL return a config with that model value.
+ * **Validates: Requirements 3.1, 3.3, 3.5**
+ *
+ * **Property 6: Default Model Fallback**
+ * *For any* provider, when the provider-specific model environment variable is not set,
+ * `getLLMConfig()` SHALL return a config with the default model for that provider.
+ * **Validates: Requirements 3.2, 3.4, 3.6**
+ *
+ * **Property 7: Base URL Configuration**
+ * *For any* provider configuration, when the provider-specific BASE_URL is set, `getLLMConfig()` SHALL
+ * return a config with that baseUrl value.
+ * **Validates: Requirements 4.1, 4.2**
+ *
+ * **Property 8: Backward Compatibility**
+ * *For any* environment where only `OPENAI_API_KEY` is set (without `LLM_PROVIDER`),
+ * `getLLMConfig()` SHALL return a config with provider 'openai'.
+ * **Validates: Requirements 8.1, 8.2**
+ */
+export {};
+//# sourceMappingURL=llmConfig.property.test.d.ts.map

package/dist/__tests__/llmConfig.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmConfig.property.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/llmConfig.property.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG"}

package/dist/__tests__/mergeResults.property.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Property-based tests for result merging logic
+ *
+ * Tests the mergeDetectionResults function.
+ *
+ * **Property 5: Merge preserves all detection regions**
+ * **Property 6: Merged regions are sorted by start line**
+ * **Property 7: Overlapping regions deduplicated by confidence**
+ * **Validates: Requirements 5.1, 5.2, 5.3, 5.4**
+ */
+export {};
+//# sourceMappingURL=mergeResults.property.test.d.ts.map

package/dist/__tests__/mergeResults.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeResults.property.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/mergeResults.property.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/__tests__/tokenizer.property.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Property-Based Tests for Tokenizer Module
+ *
+ * **Property 1: Token counting consistency**
+ * *For any* valid text string, calling `countTokens` multiple times with the same input
+ * SHALL return the same token count.
+ * **Validates: Requirements 3.1**
+ *
+ * **Property 2: Batch splitting preserves all content**
+ * *For any* array of code lines and any maxTokens limit, splitting into batches and
+ * concatenating all batches SHALL produce the original content (no lines lost or duplicated).
+ * **Validates: Requirements 4.1, 4.2**
+ *
+ * **Property 3: Batch splitting respects line boundaries**
+ * *For any* batch produced by `splitByTokenLimit`, the batch content SHALL contain
+ * only complete lines (no partial lines).
+ * **Validates: Requirements 4.2**
+ */
+export {};
+//# sourceMappingURL=tokenizer.property.test.d.ts.map

package/dist/__tests__/tokenizer.property.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.property.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tokenizer.property.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/index.d.ts

@@ -1,11 +1,16 @@
 /**
- * AI Tools - AI-powered code analysis tools
+ * AI Tools - MCP server for AI-powered JSVMP detection
  *
- * This package provides LLM-driven functionality for code analysis,
+ * This package provides an MCP server with LLM-driven functionality for code analysis,
  * including JSVMP (JavaScript Virtual Machine Protection) detection.
  *
+ * Run as MCP server: npx @reverse-craft/ai-tools
+ *
  * @packageDocumentation
  */
-export { type LLMConfig, type LLMClient, getLLMConfig, isLLMConfigured, createLLMClient, } from './llmConfig.js';
+export { type LLMConfig, type LLMClient, type LLMProvider, PROVIDER_DEFAULTS, PROVIDER_ENV_KEYS, getLLMConfig, isLLMConfigured, createLLMClient, } from './llmConfig.js';
 export { type FormattedCode, type DetectionType, type ConfidenceLevel, type DetectionRegion, type DetectionResult, type JsvmpDetectionOptions, type JsvmpDetectionResult, formatCodeForAnalysis, parseDetectionResult, findJsvmpDispatcher, } from './jsvmpDetector.js';
+export { tools } from './tools/index.js';
+export { findJsvmpDispatcherTool, FindJsvmpDispatcherInputSchema } from './tools/findJsvmpDispatcherTool.js';
+export { ToolDefinition, defineTool } from './tools/ToolDefinition.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/jsvmpDetector.d.ts

@@ -2,6 +2,7 @@
  * JSVMP Detector Module
  * AI-powered detection of JSVMP (JavaScript Virtual Machine Protection) patterns
  */
+import { LLMClient } from './llmConfig.js';
 /**
  * Formatted code result interface
  */
@@ -41,6 +42,7 @@ export interface DetectionResult {
  */
 export interface JsvmpDetectionOptions {
     charLimit?: number;
+    maxTokensPerBatch?: number;
 }
 /**
  * Result from findJsvmpDispatcher function
@@ -48,11 +50,28 @@ export interface JsvmpDetectionOptions {
 export interface JsvmpDetectionResult {
     success: boolean;
     filePath: string;
-    startLine: number;
-    endLine: number;
+    totalLines: number;
+    batchCount: number;
     result?: DetectionResult;
     formattedOutput?: string;
     error?: string;
+    partialErrors?: string[];
+}
+/**
+ * Batch information for processing
+ */
+export interface BatchInfo {
+    startLine: number;
+    endLine: number;
+    content: string;
+    tokenCount: number;
+}
+/**
+ * Result from formatEntireFile function
+ */
+export interface FormattedFileResult {
+    lines: string[];
+    totalLines: number;
 }
 /**
  * 格式化代码为 LLM 分析格式
@@ -71,6 +90,30 @@ export interface JsvmpDetectionResult {
  * @returns FormattedCode object with formatted content and metadata
  */
 export declare function formatCodeForAnalysis(filePath: string, startLine: number, endLine: number, charLimit?: number): Promise<FormattedCode>;
+/**
+ * 格式化整个文件为 LLM 分析格式
+ * 格式: "LineNo SourceLoc Code"
+ *
+ * 处理流程：
+ * 1. 调用 ensureBeautified 美化代码
+ * 2. 调用 truncateCodeHighPerf 截断长字符串
+ * 3. 使用 SourceMapConsumer 获取原始坐标
+ * 4. 返回格式化后的行数组（保留原始行号）
+ *
+ * @param filePath - Path to the JavaScript file
+ * @param charLimit - Character limit for string truncation (default 300)
+ * @returns FormattedFileResult with formatted lines array and metadata
+ */
+export declare function formatEntireFile(filePath: string, charLimit?: number): Promise<FormattedFileResult>;
+/**
+ * 创建批次用于分批处理
+ * 使用 tokenizer 分割代码，记录每个批次的 startLine/endLine
+ *
+ * @param formattedLines - 格式化后的代码行数组
+ * @param maxTokensPerBatch - 每批次最大 token 数量
+ * @returns BatchInfo 数组
+ */
+export declare function createBatches(formattedLines: string[], maxTokensPerBatch: number): BatchInfo[];
 /**
  * Parse and validate LLM detection result from JSON string
  *
@@ -85,14 +128,36 @@ export declare function formatCodeForAnalysis(filePath: string, startLine: numbe
  * @throws Error if JSON is invalid or structure doesn't match expected format
  */
 export declare function parseDetectionResult(jsonString: string): DetectionResult;
+/**
+ * Merge detection results from multiple batches
+ * - Combines all regions from all batches
+ * - Combines summaries from all batches
+ * - Sorts regions by start line
+ * - Deduplicates overlapping regions (keeps higher confidence)
+ *
+ * @param results - Array of DetectionResult from each batch
+ * @returns Merged DetectionResult
+ */
+export declare function mergeDetectionResults(results: DetectionResult[]): DetectionResult;
+/**
+ * Process batches with error handling
+ * - Continues processing if some batches fail
+ * - Collects partial results and error information
+ *
+ * @param client - LLM client
+ * @param batches - Array of BatchInfo
+ * @returns Object with successful results and error messages
+ */
+export declare function processBatchesWithErrorHandling(client: LLMClient, batches: BatchInfo[]): Promise<{
+    results: DetectionResult[];
+    errors: string[];
+}>;
 /**
  * Find JSVMP dispatcher patterns in JavaScript code using LLM analysis
  *
  * @param filePath - Path to the JavaScript file to analyze
- * @param startLine - Start line number (1-based)
- * @param endLine - End line number (1-based)
  * @param options - Optional configuration
  * @returns JsvmpDetectionResult with detection results or error
  */
-export declare function findJsvmpDispatcher(filePath: string, startLine: number, endLine: number, options?: JsvmpDetectionOptions): Promise<JsvmpDetectionResult>;
+export declare function findJsvmpDispatcher(filePath: string, options?: JsvmpDetectionOptions): Promise<JsvmpDetectionResult>;
 //# sourceMappingURL=jsvmpDetector.d.ts.map

package/dist/jsvmpDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsvmpDetector.d.ts","sourceRoot":"","sources":["../src/jsvmpDetector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,aAAa,CAAC,CAuDxB;AAoCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAoFxE;AAiCD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CA+D/B"}
+{"version":3,"file":"jsvmpDetector.d.ts","sourceRoot":"","sources":["../src/jsvmpDetector.ts"],"names":[],"mappings":"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"}

package/dist/llmConfig.d.ts

@@ -2,11 +2,40 @@
  * LLM Configuration Module
  * Handles reading and validating LLM configuration from environment variables
  */
-export interface LLMConfig {
+import type { LanguageModel } from 'ai';
+/**
+ * Supported LLM providers
+ */
+export type LLMProvider = 'openai' | 'anthropic' | 'google';
+/**
+ * Provider-specific default configurations
+ */
+export declare const PROVIDER_DEFAULTS: Record<LLMProvider, {
+    model: string;
+}>;
+/**
+ * Environment variable names for each provider
+ */
+export declare const PROVIDER_ENV_KEYS: Record<LLMProvider, {
     apiKey: string;
+    model: string;
     baseUrl: string;
+}>;
+/**
+ * Extended LLM configuration with provider information
+ */
+export interface LLMConfig {
+    provider: LLMProvider;
+    apiKey: string;
     model: string;
+    baseUrl?: string;
 }
+/**
+ * Validates provider string against valid values
+ * @param value - The provider string to validate
+ * @returns The validated LLMProvider or null if invalid
+ */
+export declare function validateProvider(value: string | undefined): LLMProvider | null;
 /**
  * 从环境变量读取 LLM 配置
  * @returns LLMConfig | null (null 表示未配置)
@@ -27,6 +56,12 @@ export interface LLMClient {
      */
     analyzeJSVMP(formattedCode: string): Promise<string>;
 }
+/**
+ * Creates a provider-specific model instance using the AI SDK
+ * @param config - The LLM configuration
+ * @returns A LanguageModel instance for the configured provider
+ */
+export declare function createProviderModel(config: LLMConfig): LanguageModel;
 /**
  * 创建 LLM 客户端实例
  */