@sciexpr/ai 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -21,17 +21,34 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AIPipeline: () => AIPipeline,
+  AnthropicCompatProvider: () => AnthropicCompatProvider,
   BUILTIN_PROMPTS: () => BUILTIN_PROMPTS,
   BuiltinCompletionProvider: () => BuiltinCompletionProvider,
   BuiltinFormatter: () => BuiltinFormatter,
   BuiltinKnowledgeBase: () => BuiltinKnowledgeBase,
   BuiltinNormalizer: () => BuiltinNormalizer,
-  PromptRegistry: () => PromptRegistry
+  OpenAICompatProvider: () => OpenAICompatProvider,
+  PromptRegistry: () => PromptRegistry,
+  getLastToken: () => getLastToken
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/fallback.ts
 var import_core = require("@sciexpr/core");
+
+// src/token-utils.ts
+function getLastToken(input) {
+  const backslashIdx = input.lastIndexOf("\\");
+  if (backslashIdx !== -1) {
+    const afterBackslash = input.slice(backslashIdx);
+    const match2 = afterBackslash.match(/^\\[a-zA-Z]*$/);
+    if (match2) return match2[0];
+  }
+  const match = input.match(/([a-zA-Z_]+)$/);
+  return match ? match[1] : "";
+}
+
+// src/fallback.ts
 var BUILTIN_SYMBOLS = [
   // Greek lowercase
   { text: "\\alpha", label: "\u03B1 alpha", category: "symbol", score: 100, description: "Greek alpha" },
@@ -99,16 +116,6 @@ var BuiltinCompletionProvider = class {
     };
   }
 };
-function getLastToken(input) {
-  const backslashIdx = input.lastIndexOf("\\");
-  if (backslashIdx !== -1) {
-    const afterBackslash = input.slice(backslashIdx);
-    const match2 = afterBackslash.match(/^\\[a-zA-Z]*$/);
-    if (match2) return match2[0];
-  }
-  const match = input.match(/([a-zA-Z_]+)$/);
-  return match ? match[1] : "";
-}
 var CHEMICAL_ELEMENTS = [
   { symbol: "H", name: "\u6C22 / Hydrogen", atomicNumber: 1, atomicMass: 1.008, group: 1, period: 1, block: "s", electronegativity: 2.2, oxidationStates: [1, -1] },
   { symbol: "He", name: "\u6C26 / Helium", atomicNumber: 2, atomicMass: 4.0026, group: 18, period: 1, block: "s" },
@@ -265,6 +272,10 @@ var AIPipeline = class {
   cache;
   completionCache = /* @__PURE__ */ new Map();
   kbCache = /* @__PURE__ */ new Map();
+  // Cache statistics (L2: actual tracking)
+  cacheHits = 0;
+  cacheMisses = 0;
+  /** AI Pipeline 支持的事件类型 */
   eventListeners = /* @__PURE__ */ new Map();
   constructor(config = {}) {
     this.completionProvider = config.completionProvider ?? new BuiltinCompletionProvider();
@@ -282,7 +293,7 @@ var AIPipeline = class {
    * 获取智能补全（本地 + AI 混合）
    */
   async getCompletions(context) {
-    const cacheKey = `comp:${context.currentInput}:${context.cursorPosition}`;
+    const cacheKey = `comp:${context.currentInput}:${context.cursorPosition}:${context.expressionType}`;
     const cached = this.getCached(this.completionCache, cacheKey);
     if (cached) return cached;
     const localResult = await new BuiltinCompletionProvider().complete(context);
@@ -385,11 +396,28 @@ var AIPipeline = class {
   isEnabled() {
     return this.aiEnabled;
   }
+  /** Replace completion provider without losing other configured providers (M1) */
+  setCompletionProvider(provider) {
+    this.completionProvider = provider;
+    this.completionCache.clear();
+  }
+  /** Replace knowledge base provider without losing other configured providers (M1) */
+  setKnowledgeBaseProvider(provider) {
+    this.knowledgeBaseProvider = provider;
+    this.kbCache.clear();
+  }
+  /** Replace normalizer provider without losing other configured providers */
+  setNormalizerProvider(provider) {
+    this.normalizerProvider = provider;
+  }
+  /** Replace formatter provider without losing other configured providers */
+  setFormatterProvider(provider) {
+    this.formatterProvider = provider;
+  }
   getCacheStats() {
     return {
-      hits: 0,
-      // Simplified — would need tracking
-      misses: 0,
+      hits: this.cacheHits,
+      misses: this.cacheMisses,
       completionSize: this.completionCache.size,
       kbSize: this.kbCache.size
     };
@@ -419,11 +447,18 @@ var AIPipeline = class {
   getCached(cache, key) {
     if (!this.cache.enabled) return null;
     const entry = cache.get(key);
-    if (!entry) return null;
+    if (!entry) {
+      this.cacheMisses++;
+      return null;
+    }
     if (Date.now() - entry.timestamp > this.cache.ttlMs) {
       cache.delete(key);
+      this.cacheMisses++;
       return null;
     }
+    this.cacheHits++;
+    cache.delete(key);
+    cache.set(key, entry);
     return entry.value;
   }
   setCache(cache, key, value) {
@@ -485,6 +520,36 @@ Products: {{products}}
 Arrow: {{arrow}}
 Conditions: {{conditions}}`,
     variables: ["reactants", "products", "arrow", "conditions"]
+  },
+  /** 物理公式验证 */
+  "physics-validation": {
+    name: "Physics Validation",
+    system: `You are a physics expert. Validate physical formulas.
+Check: dimensional consistency, constant correctness, physical reasonableness.
+Physics notation: \\vec{} for vectors, \\hat{} for operators, \\bra{} / \\ket{} for quantum states.
+Return JSON: {valid: boolean, errors: [{message, code}], warnings: [{message, code}], suggestions: [string]}.`,
+    user: `Validate this physics expression:
+Formula: {{formula}}
+Domain: {{domain}}
+Context: {{context}}`,
+    variables: ["formula", "domain", "context"]
+  },
+  /** 自然语言 → 物理公式 */
+  "nl-to-physics": {
+    name: "Natural Language to Physics Formula",
+    system: `Convert natural language physics descriptions to LaTeX expressions.
+Physics conventions:
+- Vector quantities: \\vec{F}, \\vec{v}, \\vec{E}, \\vec{B}
+- Unit vectors: \\hat{i}, \\hat{j}, \\hat{k}, \\hat{r}
+- Operators: \\hat{H}, \\hat{p}, \\hat{x}
+- Quantum: \\bra{}, \\ket{}, \\braket{}
+- Derivatives: \\frac{d}{dt}, \\frac{\\partial}{\\partial x}
+- Integrals: \\int_{a}^{b}, \\oint
+- Greek: \\alpha, \\beta, \\gamma, \\theta, \\phi, \\omega, \\hbar
+- Constants: c (light speed), G (gravitation), h (Planck), \\hbar
+Return JSON: [{text: latex_code, label: display_name, description, category: "formula", score: 1}].`,
+    user: `Convert to physics formula: {{query}}`,
+    variables: ["query"]
   }
 };
 var PromptRegistry = class {
@@ -533,13 +598,135 @@ var PromptRegistry = class {
     return this.templates.delete(name);
   }
 };
+
+// src/providers/openai-compat.ts
+var OpenAICompatProvider = class {
+  id = "openai-compat";
+  name;
+  baseURL;
+  apiKey;
+  model;
+  constructor(config) {
+    this.baseURL = config.baseURL.replace(/\/+$/, "");
+    this.apiKey = config.apiKey;
+    this.model = config.model;
+    this.name = `OpenAI Compat (${config.model})`;
+  }
+  async chat(messages, signal) {
+    const url = `${this.baseURL}/chat/completions`;
+    const body = {
+      model: this.model,
+      messages: messages.map((m) => ({
+        role: m.role,
+        content: m.content
+      })),
+      temperature: 0.3,
+      max_tokens: 2048
+    };
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body),
+      signal
+    });
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(
+        `[${this.name}] API error ${response.status}: ${errorText.slice(0, 200)}`
+      );
+    }
+    const data = await response.json();
+    const content = data.choices?.[0]?.message?.content;
+    if (!content) {
+      throw new Error(`[${this.name}] Empty response from API`);
+    }
+    return content.trim();
+  }
+};
+
+// src/providers/anthropic-compat.ts
+var AnthropicCompatProvider = class {
+  id = "anthropic-compat";
+  name;
+  baseURL;
+  apiKey;
+  model;
+  apiVersion;
+  constructor(config, apiVersion = "2023-06-01") {
+    this.baseURL = config.baseURL.replace(/\/+$/, "");
+    this.apiKey = config.apiKey;
+    this.model = config.model;
+    this.apiVersion = apiVersion;
+    this.name = `Anthropic Compat (${config.model})`;
+  }
+  async chat(messages, signal) {
+    const url = `${this.baseURL}/v1/messages`;
+    const systemMessages = messages.filter((m) => m.role === "system");
+    const nonSystemMessages = messages.filter((m) => m.role !== "system");
+    const anthropicMessages = nonSystemMessages.map((m) => ({
+      role: m.role,
+      content: m.content
+    }));
+    const body = {
+      model: this.model,
+      messages: anthropicMessages,
+      max_tokens: 2048,
+      temperature: 0.3
+    };
+    if (systemMessages.length > 0) {
+      body.system = systemMessages.map((m) => m.content).join("\n");
+    }
+    const headers = {
+      "Content-Type": "application/json",
+      "x-api-key": this.apiKey,
+      "anthropic-version": this.apiVersion
+    };
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body),
+      signal
+    });
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(
+        `[${this.name}] API error ${response.status}: ${errorText.slice(0, 200)}`
+      );
+    }
+    const data = await response.json();
+    if (!data.content || data.content.length === 0) {
+      throw new Error(`[${this.name}] Empty response from API`);
+    }
+    const textBlocks = data.content.filter((b) => b.type === "text" && b.text);
+    const thinkingBlocks = data.content.filter((b) => b.type === "thinking" && b.thinking);
+    let content;
+    if (textBlocks.length > 0) {
+      content = textBlocks.map((b) => b.text).join("\n").trim();
+    } else if (thinkingBlocks.length > 0) {
+      content = thinkingBlocks[thinkingBlocks.length - 1].thinking.trim();
+    } else {
+      throw new Error(`[${this.name}] No text or thinking content in response`);
+    }
+    if (!content) {
+      throw new Error(`[${this.name}] Empty response from API`);
+    }
+    return content;
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AIPipeline,
+  AnthropicCompatProvider,
   BUILTIN_PROMPTS,
   BuiltinCompletionProvider,
   BuiltinFormatter,
   BuiltinKnowledgeBase,
   BuiltinNormalizer,
-  PromptRegistry
+  OpenAICompatProvider,
+  PromptRegistry,
+  getLastToken
 });

package/dist/index.d.cts

@@ -322,6 +322,9 @@ declare class AIPipeline {
     private cache;
     private completionCache;
     private kbCache;
+    private cacheHits;
+    private cacheMisses;
+    /** AI Pipeline 支持的事件类型 */
     private eventListeners;
     constructor(config?: AIPipelineConfig);
     /**
@@ -350,6 +353,14 @@ declare class AIPipeline {
     correct(input: string, error: ValidationError): Promise<CompletionItem[]>;
     setEnabled(enabled: boolean): void;
     isEnabled(): boolean;
+    /** Replace completion provider without losing other configured providers (M1) */
+    setCompletionProvider(provider: IAICompletionProvider): void;
+    /** Replace knowledge base provider without losing other configured providers (M1) */
+    setKnowledgeBaseProvider(provider: IKnowledgeBaseProvider): void;
+    /** Replace normalizer provider without losing other configured providers */
+    setNormalizerProvider(provider: IAINormalizerProvider): void;
+    /** Replace formatter provider without losing other configured providers */
+    setFormatterProvider(provider: IAIFormatterProvider): void;
     getCacheStats(): {
         hits: number;
         misses: number;
@@ -358,7 +369,7 @@ declare class AIPipeline {
     };
     clearCache(): void;
     on(event: string, callback: (...args: any[]) => void): void;
-    off(event: string, callback: (...args: any[]) => void): void;
+    off(event: string, callback: (...args: unknown[]) => void): void;
     private emit;
     private getCached;
     private setCache;
@@ -464,4 +475,109 @@ declare class BuiltinFormatter implements IAIFormatterProvider {
     format(ast: ExpressionRoot, _style: FormatStyle): Promise<ExpressionRoot>;
 }
 
-export { type AICacheConfig, AIPipeline, type AIPipelineConfig, BUILTIN_PROMPTS, BuiltinCompletionProvider, BuiltinFormatter, BuiltinKnowledgeBase, BuiltinNormalizer, type CompletionContext, type CompletionItem, type CompletionResult, type ElementInfo, type FormatRule, type FormatStyle, type FormatSuggestion, type FormulaTemplate, type IAICompletionProvider, type IAIFormatterProvider, type IAINormalizerProvider, type IAIStreamAdapter, type IKnowledgeBaseProvider, type KBQueryParams, type KBQueryResult, type NormalizationChange, type NormalizedResult, PromptRegistry, type PromptTemplate, type StreamSource, type SymbolInfo };
+/**
+ * 获取最后一个不完整的 LaTeX token
+ *
+ * 在输入字符串中查找最后一个要进行自动补全的 token。
+ * 优先匹配 LaTeX 命令（以 \ 开头），其次匹配普通单词。
+ *
+ * @param input - 光标之前的输入文本
+ * @returns 最后一个不完整 token，如果没有则返回空字符串
+ *
+ * @example
+ * getLastToken('\\fra')   // => '\\fra'
+ * getLastToken('E = mc')  // => 'mc'
+ * getLastToken('hello ')  // => ''
+ */
+declare function getLastToken(input: string): string;
+
+/** 聊天消息 */
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** AI 提供者配置 */
+interface AIProviderConfig {
+    /** API Base URL */
+    baseURL: string;
+    /** API Key */
+    apiKey: string;
+    /** 模型名称 */
+    model: string;
+}
+/**
+ * 聊天补全提供者接口
+ *
+ * 统一的 LLM 调用接口，OpenAICompatProvider 和 AnthropicCompatProvider 都实现此接口。
+ * 返回纯文本，由调用方决定如何插入到编辑器。
+ */
+interface IChatCompletionProvider {
+    /** 发送消息并返回 AI 生成的文本。signal 用于取消请求 */
+    chat(messages: ChatMessage[], signal?: AbortSignal): Promise<string>;
+}
+
+/**
+ * OpenAI 兼容的聊天补全提供者
+ *
+ * 支持任何兼容 OpenAI Chat Completions API 的服务：
+ * - OpenAI (api.openai.com)
+ * - DeepSeek (api.deepseek.com)
+ * - 本地 Ollama / vLLM 等服务
+ *
+ * API: POST {baseURL}/chat/completions
+ *
+ * @example
+ * ```ts
+ * const provider = new OpenAICompatProvider({
+ *   baseURL: 'https://api.deepseek.com/v1',
+ *   apiKey: 'sk-...',
+ *   model: 'deepseek-chat',
+ * });
+ * const result = await provider.chat([
+ *   { role: 'user', content: '写一个麦克斯韦方程组的 LaTeX 表达式' },
+ * ]);
+ * ```
+ */
+declare class OpenAICompatProvider implements IChatCompletionProvider {
+    readonly id = "openai-compat";
+    readonly name: string;
+    private baseURL;
+    private apiKey;
+    private model;
+    constructor(config: AIProviderConfig);
+    chat(messages: ChatMessage[], signal?: AbortSignal): Promise<string>;
+}
+
+/**
+ * Anthropic 兼容的聊天补全提供者
+ *
+ * 支持 Anthropic Messages API 的服务：
+ * - Anthropic (api.anthropic.com)
+ * - 任何兼容 Anthropic API 格式的代理服务
+ *
+ * API: POST {baseURL}/v1/messages
+ *
+ * @example
+ * ```ts
+ * const provider = new AnthropicCompatProvider({
+ *   baseURL: 'https://api.anthropic.com',
+ *   apiKey: 'sk-ant-...',
+ *   model: 'claude-3-5-sonnet-20241022',
+ * });
+ * const result = await provider.chat([
+ *   { role: 'user', content: '写一个薛定谔方程的 LaTeX 表达式' },
+ * ]);
+ * ```
+ */
+declare class AnthropicCompatProvider implements IChatCompletionProvider {
+    readonly id = "anthropic-compat";
+    readonly name: string;
+    private baseURL;
+    private apiKey;
+    private model;
+    private apiVersion;
+    constructor(config: AIProviderConfig, apiVersion?: string);
+    chat(messages: ChatMessage[], signal?: AbortSignal): Promise<string>;
+}
+
+export { type AICacheConfig, AIPipeline, type AIPipelineConfig, type AIProviderConfig, AnthropicCompatProvider, BUILTIN_PROMPTS, BuiltinCompletionProvider, BuiltinFormatter, BuiltinKnowledgeBase, BuiltinNormalizer, type ChatMessage, type CompletionContext, type CompletionItem, type CompletionResult, type ElementInfo, type FormatRule, type FormatStyle, type FormatSuggestion, type FormulaTemplate, type IAICompletionProvider, type IAIFormatterProvider, type IAINormalizerProvider, type IAIStreamAdapter, type IChatCompletionProvider, type IKnowledgeBaseProvider, type KBQueryParams, type KBQueryResult, type NormalizationChange, type NormalizedResult, OpenAICompatProvider, PromptRegistry, type PromptTemplate, type StreamSource, type SymbolInfo, getLastToken };

package/dist/index.d.ts

@@ -322,6 +322,9 @@ declare class AIPipeline {
     private cache;
     private completionCache;
     private kbCache;
+    private cacheHits;
+    private cacheMisses;
+    /** AI Pipeline 支持的事件类型 */
     private eventListeners;
     constructor(config?: AIPipelineConfig);
     /**
@@ -350,6 +353,14 @@ declare class AIPipeline {
     correct(input: string, error: ValidationError): Promise<CompletionItem[]>;
     setEnabled(enabled: boolean): void;
     isEnabled(): boolean;
+    /** Replace completion provider without losing other configured providers (M1) */
+    setCompletionProvider(provider: IAICompletionProvider): void;
+    /** Replace knowledge base provider without losing other configured providers (M1) */
+    setKnowledgeBaseProvider(provider: IKnowledgeBaseProvider): void;
+    /** Replace normalizer provider without losing other configured providers */
+    setNormalizerProvider(provider: IAINormalizerProvider): void;
+    /** Replace formatter provider without losing other configured providers */
+    setFormatterProvider(provider: IAIFormatterProvider): void;
     getCacheStats(): {
         hits: number;
         misses: number;
@@ -358,7 +369,7 @@ declare class AIPipeline {
     };
     clearCache(): void;
     on(event: string, callback: (...args: any[]) => void): void;
-    off(event: string, callback: (...args: any[]) => void): void;
+    off(event: string, callback: (...args: unknown[]) => void): void;
     private emit;
     private getCached;
     private setCache;
@@ -464,4 +475,109 @@ declare class BuiltinFormatter implements IAIFormatterProvider {
     format(ast: ExpressionRoot, _style: FormatStyle): Promise<ExpressionRoot>;
 }
 
-export { type AICacheConfig, AIPipeline, type AIPipelineConfig, BUILTIN_PROMPTS, BuiltinCompletionProvider, BuiltinFormatter, BuiltinKnowledgeBase, BuiltinNormalizer, type CompletionContext, type CompletionItem, type CompletionResult, type ElementInfo, type FormatRule, type FormatStyle, type FormatSuggestion, type FormulaTemplate, type IAICompletionProvider, type IAIFormatterProvider, type IAINormalizerProvider, type IAIStreamAdapter, type IKnowledgeBaseProvider, type KBQueryParams, type KBQueryResult, type NormalizationChange, type NormalizedResult, PromptRegistry, type PromptTemplate, type StreamSource, type SymbolInfo };
+/**
+ * 获取最后一个不完整的 LaTeX token
+ *
+ * 在输入字符串中查找最后一个要进行自动补全的 token。
+ * 优先匹配 LaTeX 命令（以 \ 开头），其次匹配普通单词。
+ *
+ * @param input - 光标之前的输入文本
+ * @returns 最后一个不完整 token，如果没有则返回空字符串
+ *
+ * @example
+ * getLastToken('\\fra')   // => '\\fra'
+ * getLastToken('E = mc')  // => 'mc'
+ * getLastToken('hello ')  // => ''
+ */
+declare function getLastToken(input: string): string;
+
+/** 聊天消息 */
+interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** AI 提供者配置 */
+interface AIProviderConfig {
+    /** API Base URL */
+    baseURL: string;
+    /** API Key */
+    apiKey: string;
+    /** 模型名称 */
+    model: string;
+}
+/**
+ * 聊天补全提供者接口
+ *
+ * 统一的 LLM 调用接口，OpenAICompatProvider 和 AnthropicCompatProvider 都实现此接口。
+ * 返回纯文本，由调用方决定如何插入到编辑器。
+ */
+interface IChatCompletionProvider {
+    /** 发送消息并返回 AI 生成的文本。signal 用于取消请求 */
+    chat(messages: ChatMessage[], signal?: AbortSignal): Promise<string>;
+}
+
+/**
+ * OpenAI 兼容的聊天补全提供者
+ *
+ * 支持任何兼容 OpenAI Chat Completions API 的服务：
+ * - OpenAI (api.openai.com)
+ * - DeepSeek (api.deepseek.com)
+ * - 本地 Ollama / vLLM 等服务
+ *
+ * API: POST {baseURL}/chat/completions
+ *
+ * @example
+ * ```ts
+ * const provider = new OpenAICompatProvider({
+ *   baseURL: 'https://api.deepseek.com/v1',
+ *   apiKey: 'sk-...',
+ *   model: 'deepseek-chat',
+ * });
+ * const result = await provider.chat([
+ *   { role: 'user', content: '写一个麦克斯韦方程组的 LaTeX 表达式' },
+ * ]);
+ * ```
+ */
+declare class OpenAICompatProvider implements IChatCompletionProvider {
+    readonly id = "openai-compat";
+    readonly name: string;
+    private baseURL;
+    private apiKey;
+    private model;
+    constructor(config: AIProviderConfig);
+    chat(messages: ChatMessage[], signal?: AbortSignal): Promise<string>;
+}
+
+/**
+ * Anthropic 兼容的聊天补全提供者
+ *
+ * 支持 Anthropic Messages API 的服务：
+ * - Anthropic (api.anthropic.com)
+ * - 任何兼容 Anthropic API 格式的代理服务
+ *
+ * API: POST {baseURL}/v1/messages
+ *
+ * @example
+ * ```ts
+ * const provider = new AnthropicCompatProvider({
+ *   baseURL: 'https://api.anthropic.com',
+ *   apiKey: 'sk-ant-...',
+ *   model: 'claude-3-5-sonnet-20241022',
+ * });
+ * const result = await provider.chat([
+ *   { role: 'user', content: '写一个薛定谔方程的 LaTeX 表达式' },
+ * ]);
+ * ```
+ */
+declare class AnthropicCompatProvider implements IChatCompletionProvider {
+    readonly id = "anthropic-compat";
+    readonly name: string;
+    private baseURL;
+    private apiKey;
+    private model;
+    private apiVersion;
+    constructor(config: AIProviderConfig, apiVersion?: string);
+    chat(messages: ChatMessage[], signal?: AbortSignal): Promise<string>;
+}
+
+export { type AICacheConfig, AIPipeline, type AIPipelineConfig, type AIProviderConfig, AnthropicCompatProvider, BUILTIN_PROMPTS, BuiltinCompletionProvider, BuiltinFormatter, BuiltinKnowledgeBase, BuiltinNormalizer, type ChatMessage, type CompletionContext, type CompletionItem, type CompletionResult, type ElementInfo, type FormatRule, type FormatStyle, type FormatSuggestion, type FormulaTemplate, type IAICompletionProvider, type IAIFormatterProvider, type IAINormalizerProvider, type IAIStreamAdapter, type IChatCompletionProvider, type IKnowledgeBaseProvider, type KBQueryParams, type KBQueryResult, type NormalizationChange, type NormalizedResult, OpenAICompatProvider, PromptRegistry, type PromptTemplate, type StreamSource, type SymbolInfo, getLastToken };

package/dist/index.js

@@ -1,5 +1,19 @@
 // src/fallback.ts
 import { ExpressionKind, createRoot, createText } from "@sciexpr/core";
+
+// src/token-utils.ts
+function getLastToken(input) {
+  const backslashIdx = input.lastIndexOf("\\");
+  if (backslashIdx !== -1) {
+    const afterBackslash = input.slice(backslashIdx);
+    const match2 = afterBackslash.match(/^\\[a-zA-Z]*$/);
+    if (match2) return match2[0];
+  }
+  const match = input.match(/([a-zA-Z_]+)$/);
+  return match ? match[1] : "";
+}
+
+// src/fallback.ts
 var BUILTIN_SYMBOLS = [
   // Greek lowercase
   { text: "\\alpha", label: "\u03B1 alpha", category: "symbol", score: 100, description: "Greek alpha" },
@@ -67,16 +81,6 @@ var BuiltinCompletionProvider = class {
     };
   }
 };
-function getLastToken(input) {
-  const backslashIdx = input.lastIndexOf("\\");
-  if (backslashIdx !== -1) {
-    const afterBackslash = input.slice(backslashIdx);
-    const match2 = afterBackslash.match(/^\\[a-zA-Z]*$/);
-    if (match2) return match2[0];
-  }
-  const match = input.match(/([a-zA-Z_]+)$/);
-  return match ? match[1] : "";
-}
 var CHEMICAL_ELEMENTS = [
   { symbol: "H", name: "\u6C22 / Hydrogen", atomicNumber: 1, atomicMass: 1.008, group: 1, period: 1, block: "s", electronegativity: 2.2, oxidationStates: [1, -1] },
   { symbol: "He", name: "\u6C26 / Helium", atomicNumber: 2, atomicMass: 4.0026, group: 18, period: 1, block: "s" },
@@ -233,6 +237,10 @@ var AIPipeline = class {
   cache;
   completionCache = /* @__PURE__ */ new Map();
   kbCache = /* @__PURE__ */ new Map();
+  // Cache statistics (L2: actual tracking)
+  cacheHits = 0;
+  cacheMisses = 0;
+  /** AI Pipeline 支持的事件类型 */
   eventListeners = /* @__PURE__ */ new Map();
   constructor(config = {}) {
     this.completionProvider = config.completionProvider ?? new BuiltinCompletionProvider();
@@ -250,7 +258,7 @@ var AIPipeline = class {
    * 获取智能补全（本地 + AI 混合）
    */
   async getCompletions(context) {
-    const cacheKey = `comp:${context.currentInput}:${context.cursorPosition}`;
+    const cacheKey = `comp:${context.currentInput}:${context.cursorPosition}:${context.expressionType}`;
     const cached = this.getCached(this.completionCache, cacheKey);
     if (cached) return cached;
     const localResult = await new BuiltinCompletionProvider().complete(context);
@@ -353,11 +361,28 @@ var AIPipeline = class {
   isEnabled() {
     return this.aiEnabled;
   }
+  /** Replace completion provider without losing other configured providers (M1) */
+  setCompletionProvider(provider) {
+    this.completionProvider = provider;
+    this.completionCache.clear();
+  }
+  /** Replace knowledge base provider without losing other configured providers (M1) */
+  setKnowledgeBaseProvider(provider) {
+    this.knowledgeBaseProvider = provider;
+    this.kbCache.clear();
+  }
+  /** Replace normalizer provider without losing other configured providers */
+  setNormalizerProvider(provider) {
+    this.normalizerProvider = provider;
+  }
+  /** Replace formatter provider without losing other configured providers */
+  setFormatterProvider(provider) {
+    this.formatterProvider = provider;
+  }
   getCacheStats() {
     return {
-      hits: 0,
-      // Simplified — would need tracking
-      misses: 0,
+      hits: this.cacheHits,
+      misses: this.cacheMisses,
       completionSize: this.completionCache.size,
       kbSize: this.kbCache.size
     };
@@ -387,11 +412,18 @@ var AIPipeline = class {
   getCached(cache, key) {
     if (!this.cache.enabled) return null;
     const entry = cache.get(key);
-    if (!entry) return null;
+    if (!entry) {
+      this.cacheMisses++;
+      return null;
+    }
     if (Date.now() - entry.timestamp > this.cache.ttlMs) {
       cache.delete(key);
+      this.cacheMisses++;
       return null;
     }
+    this.cacheHits++;
+    cache.delete(key);
+    cache.set(key, entry);
     return entry.value;
   }
   setCache(cache, key, value) {
@@ -453,6 +485,36 @@ Products: {{products}}
 Arrow: {{arrow}}
 Conditions: {{conditions}}`,
     variables: ["reactants", "products", "arrow", "conditions"]
+  },
+  /** 物理公式验证 */
+  "physics-validation": {
+    name: "Physics Validation",
+    system: `You are a physics expert. Validate physical formulas.
+Check: dimensional consistency, constant correctness, physical reasonableness.
+Physics notation: \\vec{} for vectors, \\hat{} for operators, \\bra{} / \\ket{} for quantum states.
+Return JSON: {valid: boolean, errors: [{message, code}], warnings: [{message, code}], suggestions: [string]}.`,
+    user: `Validate this physics expression:
+Formula: {{formula}}
+Domain: {{domain}}
+Context: {{context}}`,
+    variables: ["formula", "domain", "context"]
+  },
+  /** 自然语言 → 物理公式 */
+  "nl-to-physics": {
+    name: "Natural Language to Physics Formula",
+    system: `Convert natural language physics descriptions to LaTeX expressions.
+Physics conventions:
+- Vector quantities: \\vec{F}, \\vec{v}, \\vec{E}, \\vec{B}
+- Unit vectors: \\hat{i}, \\hat{j}, \\hat{k}, \\hat{r}
+- Operators: \\hat{H}, \\hat{p}, \\hat{x}
+- Quantum: \\bra{}, \\ket{}, \\braket{}
+- Derivatives: \\frac{d}{dt}, \\frac{\\partial}{\\partial x}
+- Integrals: \\int_{a}^{b}, \\oint
+- Greek: \\alpha, \\beta, \\gamma, \\theta, \\phi, \\omega, \\hbar
+- Constants: c (light speed), G (gravitation), h (Planck), \\hbar
+Return JSON: [{text: latex_code, label: display_name, description, category: "formula", score: 1}].`,
+    user: `Convert to physics formula: {{query}}`,
+    variables: ["query"]
   }
 };
 var PromptRegistry = class {
@@ -501,12 +563,134 @@ var PromptRegistry = class {
     return this.templates.delete(name);
   }
 };
+
+// src/providers/openai-compat.ts
+var OpenAICompatProvider = class {
+  id = "openai-compat";
+  name;
+  baseURL;
+  apiKey;
+  model;
+  constructor(config) {
+    this.baseURL = config.baseURL.replace(/\/+$/, "");
+    this.apiKey = config.apiKey;
+    this.model = config.model;
+    this.name = `OpenAI Compat (${config.model})`;
+  }
+  async chat(messages, signal) {
+    const url = `${this.baseURL}/chat/completions`;
+    const body = {
+      model: this.model,
+      messages: messages.map((m) => ({
+        role: m.role,
+        content: m.content
+      })),
+      temperature: 0.3,
+      max_tokens: 2048
+    };
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body),
+      signal
+    });
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(
+        `[${this.name}] API error ${response.status}: ${errorText.slice(0, 200)}`
+      );
+    }
+    const data = await response.json();
+    const content = data.choices?.[0]?.message?.content;
+    if (!content) {
+      throw new Error(`[${this.name}] Empty response from API`);
+    }
+    return content.trim();
+  }
+};
+
+// src/providers/anthropic-compat.ts
+var AnthropicCompatProvider = class {
+  id = "anthropic-compat";
+  name;
+  baseURL;
+  apiKey;
+  model;
+  apiVersion;
+  constructor(config, apiVersion = "2023-06-01") {
+    this.baseURL = config.baseURL.replace(/\/+$/, "");
+    this.apiKey = config.apiKey;
+    this.model = config.model;
+    this.apiVersion = apiVersion;
+    this.name = `Anthropic Compat (${config.model})`;
+  }
+  async chat(messages, signal) {
+    const url = `${this.baseURL}/v1/messages`;
+    const systemMessages = messages.filter((m) => m.role === "system");
+    const nonSystemMessages = messages.filter((m) => m.role !== "system");
+    const anthropicMessages = nonSystemMessages.map((m) => ({
+      role: m.role,
+      content: m.content
+    }));
+    const body = {
+      model: this.model,
+      messages: anthropicMessages,
+      max_tokens: 2048,
+      temperature: 0.3
+    };
+    if (systemMessages.length > 0) {
+      body.system = systemMessages.map((m) => m.content).join("\n");
+    }
+    const headers = {
+      "Content-Type": "application/json",
+      "x-api-key": this.apiKey,
+      "anthropic-version": this.apiVersion
+    };
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body),
+      signal
+    });
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "Unknown error");
+      throw new Error(
+        `[${this.name}] API error ${response.status}: ${errorText.slice(0, 200)}`
+      );
+    }
+    const data = await response.json();
+    if (!data.content || data.content.length === 0) {
+      throw new Error(`[${this.name}] Empty response from API`);
+    }
+    const textBlocks = data.content.filter((b) => b.type === "text" && b.text);
+    const thinkingBlocks = data.content.filter((b) => b.type === "thinking" && b.thinking);
+    let content;
+    if (textBlocks.length > 0) {
+      content = textBlocks.map((b) => b.text).join("\n").trim();
+    } else if (thinkingBlocks.length > 0) {
+      content = thinkingBlocks[thinkingBlocks.length - 1].thinking.trim();
+    } else {
+      throw new Error(`[${this.name}] No text or thinking content in response`);
+    }
+    if (!content) {
+      throw new Error(`[${this.name}] Empty response from API`);
+    }
+    return content;
+  }
+};
 export {
   AIPipeline,
+  AnthropicCompatProvider,
   BUILTIN_PROMPTS,
   BuiltinCompletionProvider,
   BuiltinFormatter,
   BuiltinKnowledgeBase,
   BuiltinNormalizer,
-  PromptRegistry
+  OpenAICompatProvider,
+  PromptRegistry,
+  getLastToken
 };

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@sciexpr/ai",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scientific Expression Engine - AI Provider SPI interfaces & built-in fallbacks",
   "type": "module",
   "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
+      "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     }
   },
@@ -43,7 +43,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@sciexpr/core": "0.1.0"
+    "@sciexpr/core": "0.1.1"
   },
   "devDependencies": {
     "tsup": "^8.0.0",