@anthropic-field/core 0.1.0 → 0.2.0

package/dist/src/cognitive/index.d.ts

@@ -20,3 +20,4 @@ export { executeModule, runModule, parseLLMResponse, setDefaultLLMCaller, getDef
 export { CognitiveTool, createCognitiveTool, createCognitiveTools, CognitiveModuleRegistry, getGlobalRegistry, initGlobalRegistry, resetGlobalRegistry, getDefaultConfig, type CognitiveToolParams, type CognitiveToolResult, type CognitiveConfig, } from './tool/index.js';
 export { discoverAndRegisterCognitiveTools, registerCognitiveModule, getCognitiveTools, isCognitiveTool, getCognitiveConfigFromSettings, createLLMCallerFromGeminiClient, type GeminiClientAdapter, } from './integration.js';
 export { createLLMCallerFromContentGenerator, createSimpleLLMCaller, } from './gemini-adapter.js';
+export { OpenAICompatibleClient, createLLMCallerFromOpenAI, createLLMCallerFromPreset, createLLMCallerFromEnv, PROVIDER_PRESETS, createLLMCaller, createDefaultLLMCaller, detectProviderFromEnv, DEFAULT_PROVIDER, DEFAULT_MODELS, API_KEY_ENV_VARS, type ProviderType, type ProviderSettings, } from '../providers/index.js';

package/dist/src/cognitive/index.js

@@ -47,4 +47,12 @@ export { discoverAndRegisterCognitiveTools, registerCognitiveModule, getCognitiv
 // Gemini Adapter
 // =============================================================================
 export { createLLMCallerFromContentGenerator, createSimpleLLMCaller, } from './gemini-adapter.js';
+// =============================================================================
+// OpenAI-Compatible Providers (MiniMax, DeepSeek, Qwen, etc.)
+// =============================================================================
+export { 
+// OpenAI-compatible client
+OpenAICompatibleClient, createLLMCallerFromOpenAI, createLLMCallerFromPreset, createLLMCallerFromEnv, PROVIDER_PRESETS, 
+// Provider configuration (MiniMax default)
+createLLMCaller, createDefaultLLMCaller, detectProviderFromEnv, DEFAULT_PROVIDER, DEFAULT_MODELS, API_KEY_ENV_VARS, } from '../providers/index.js';
 //# sourceMappingURL=index.js.map

package/dist/src/cognitive/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cognitive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA2CH,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,OAAO,EACL,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,cAAc,GAEf,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,OAAO;AACL,WAAW;AACX,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,oBAAoB;AAIpB,mBAAmB;AACnB,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB;AAEnB,OAAO;AACP,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,OAAO,EACP,cAAc;AAEd,SAAS;AACT,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,gBAAgB;AAGhB,SAAS;AACT,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAE5B,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC;AAEzB,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,OAAO,EACL,iCAAiC,EACjC,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,8BAA8B,EAC9B,+BAA+B,GAEhC,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EACL,mCAAmC,EACnC,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cognitive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA2CH,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,OAAO,EACL,UAAU,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,cAAc,GAEf,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,GAGnB,MAAM,sBAAsB,CAAC;AAE9B,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,OAAO;AACL,WAAW;AACX,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,oBAAoB;AAIpB,mBAAmB;AACnB,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB;AAEnB,OAAO;AACP,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,OAAO,EACP,cAAc;AAEd,SAAS;AACT,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,gBAAgB;AAGhB,SAAS;AACT,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAE5B,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC;AAEzB,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,OAAO,EACL,iCAAiC,EACjC,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,8BAA8B,EAC9B,+BAA+B,GAEhC,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EACL,mCAAmC,EACnC,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAEhF,OAAO;AACL,2BAA2B;AAC3B,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB;AAChB,2CAA2C;AAC3C,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC"}

package/dist/src/providers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * LLM Providers
+ */
+export { OpenAICompatibleClient, createLLMCallerFromOpenAI, createLLMCallerFromPreset, createLLMCallerFromEnv, PROVIDER_PRESETS, type OpenAICompatibleConfig, type ChatMessage, type ChatCompletionRequest, type ChatCompletionResponse, } from './openai-compatible.js';
+export { createLLMCaller, createDefaultLLMCaller, detectProviderFromEnv, getApiKey, DEFAULT_PROVIDER, DEFAULT_MODELS, API_KEY_ENV_VARS, type ProviderType, type ProviderSettings, } from './provider-config.js';

package/dist/src/providers/index.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * LLM Providers
+ */
+export { OpenAICompatibleClient, createLLMCallerFromOpenAI, createLLMCallerFromPreset, createLLMCallerFromEnv, PROVIDER_PRESETS, } from './openai-compatible.js';
+export { createLLMCaller, createDefaultLLMCaller, detectProviderFromEnv, getApiKey, DEFAULT_PROVIDER, DEFAULT_MODELS, API_KEY_ENV_VARS, } from './provider-config.js';
+//# sourceMappingURL=index.js.map

package/dist/src/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,GAKjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GAGjB,MAAM,sBAAsB,CAAC"}

package/dist/src/providers/openai-compatible.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * OpenAI-Compatible API Adapter
+ *
+ * Supports any provider with OpenAI-compatible API:
+ * - MiniMax
+ * - DeepSeek
+ * - Qwen
+ * - Moonshot
+ * - Together AI
+ * - OpenRouter
+ * - And more...
+ */
+import type { LLMCaller } from '../cognitive/runtime/executor.js';
+export interface OpenAICompatibleConfig {
+    /** API base URL (e.g., https://api.minimax.chat/v1) */
+    baseUrl: string;
+    /** API key */
+    apiKey: string;
+    /** Default model name */
+    defaultModel: string;
+    /** Provider name for logging */
+    providerName: string;
+    /** Optional organization ID */
+    organizationId?: string;
+    /** Optional custom headers */
+    headers?: Record<string, string>;
+}
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    stream?: boolean;
+    response_format?: {
+        type: 'json_object' | 'text';
+    };
+}
+export interface ChatCompletionResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: string;
+            content: string;
+        };
+        finish_reason: string;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export declare const PROVIDER_PRESETS: Record<string, Omit<OpenAICompatibleConfig, 'apiKey'>>;
+export declare class OpenAICompatibleClient {
+    private config;
+    constructor(config: OpenAICompatibleConfig);
+    /**
+     * Create a client from a preset provider name.
+     */
+    static fromPreset(presetName: keyof typeof PROVIDER_PRESETS, apiKey: string): OpenAICompatibleClient;
+    /**
+     * Send a chat completion request.
+     */
+    chatCompletion(request: ChatCompletionRequest): Promise<ChatCompletionResponse>;
+    /**
+     * Simple text generation.
+     */
+    generate(options: {
+        prompt: string;
+        systemPrompt?: string;
+        model?: string;
+        jsonMode?: boolean;
+    }): Promise<string>;
+    /**
+     * Get provider name.
+     */
+    getProviderName(): string;
+    /**
+     * Get default model.
+     */
+    getDefaultModel(): string;
+}
+/**
+ * Create an LLMCaller from an OpenAI-compatible client.
+ */
+export declare function createLLMCallerFromOpenAI(client: OpenAICompatibleClient): LLMCaller;
+/**
+ * Create an LLMCaller from a provider preset.
+ */
+export declare function createLLMCallerFromPreset(presetName: keyof typeof PROVIDER_PRESETS, apiKey: string): LLMCaller;
+/**
+ * Create an LLMCaller from environment variables.
+ *
+ * Checks in order:
+ * 1. MINIMAX_API_KEY → MiniMax
+ * 2. DEEPSEEK_API_KEY → DeepSeek
+ * 3. QWEN_API_KEY → Qwen
+ * 4. MOONSHOT_API_KEY → Moonshot
+ * 5. TOGETHER_API_KEY → Together AI
+ * 6. OPENROUTER_API_KEY → OpenRouter
+ * 7. OPENAI_API_KEY → OpenAI
+ * 8. GEMINI_API_KEY → Falls back to Gemini
+ */
+export declare function createLLMCallerFromEnv(): LLMCaller | null;
+export type { LLMCaller };

package/dist/src/providers/openai-compatible.js

@@ -0,0 +1,195 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * OpenAI-Compatible API Adapter
+ *
+ * Supports any provider with OpenAI-compatible API:
+ * - MiniMax
+ * - DeepSeek
+ * - Qwen
+ * - Moonshot
+ * - Together AI
+ * - OpenRouter
+ * - And more...
+ */
+// =============================================================================
+// Provider Presets
+// =============================================================================
+export const PROVIDER_PRESETS = {
+    minimax: {
+        baseUrl: 'https://api.minimax.chat/v1',
+        defaultModel: 'MiniMax-Text-01',
+        providerName: 'MiniMax',
+    },
+    'minimax-m2': {
+        baseUrl: 'https://api.minimax.chat/v1',
+        defaultModel: 'abab7-chat-preview',
+        providerName: 'MiniMax M2',
+    },
+    deepseek: {
+        baseUrl: 'https://api.deepseek.com/v1',
+        defaultModel: 'deepseek-chat',
+        providerName: 'DeepSeek',
+    },
+    qwen: {
+        baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+        defaultModel: 'qwen-max',
+        providerName: 'Qwen',
+    },
+    moonshot: {
+        baseUrl: 'https://api.moonshot.cn/v1',
+        defaultModel: 'moonshot-v1-8k',
+        providerName: 'Moonshot',
+    },
+    together: {
+        baseUrl: 'https://api.together.xyz/v1',
+        defaultModel: 'meta-llama/Llama-3.3-70B-Instruct-Turbo',
+        providerName: 'Together AI',
+    },
+    openrouter: {
+        baseUrl: 'https://openrouter.ai/api/v1',
+        defaultModel: 'anthropic/claude-3.5-sonnet',
+        providerName: 'OpenRouter',
+    },
+    openai: {
+        baseUrl: 'https://api.openai.com/v1',
+        defaultModel: 'gpt-4o',
+        providerName: 'OpenAI',
+    },
+};
+// =============================================================================
+// OpenAI Compatible Client
+// =============================================================================
+export class OpenAICompatibleClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Create a client from a preset provider name.
+     */
+    static fromPreset(presetName, apiKey) {
+        const preset = PROVIDER_PRESETS[presetName];
+        if (!preset) {
+            throw new Error(`Unknown provider preset: ${presetName}`);
+        }
+        return new OpenAICompatibleClient({ ...preset, apiKey });
+    }
+    /**
+     * Send a chat completion request.
+     */
+    async chatCompletion(request) {
+        const url = `${this.config.baseUrl}/chat/completions`;
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.config.apiKey}`,
+            ...this.config.headers,
+        };
+        if (this.config.organizationId) {
+            headers['OpenAI-Organization'] = this.config.organizationId;
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(request),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`${this.config.providerName} API error (${response.status}): ${errorText}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * Simple text generation.
+     */
+    async generate(options) {
+        const messages = [];
+        if (options.systemPrompt) {
+            messages.push({ role: 'system', content: options.systemPrompt });
+        }
+        messages.push({ role: 'user', content: options.prompt });
+        const request = {
+            model: options.model || this.config.defaultModel,
+            messages,
+            ...(options.jsonMode && { response_format: { type: 'json_object' } }),
+        };
+        const response = await this.chatCompletion(request);
+        const content = response.choices[0]?.message?.content;
+        if (!content) {
+            throw new Error('No content in response');
+        }
+        return content;
+    }
+    /**
+     * Get provider name.
+     */
+    getProviderName() {
+        return this.config.providerName;
+    }
+    /**
+     * Get default model.
+     */
+    getDefaultModel() {
+        return this.config.defaultModel;
+    }
+}
+// =============================================================================
+// LLM Caller Factory
+// =============================================================================
+/**
+ * Create an LLMCaller from an OpenAI-compatible client.
+ */
+export function createLLMCallerFromOpenAI(client) {
+    return {
+        async call({ systemPrompt, userPrompt, model }) {
+            return client.generate({
+                prompt: userPrompt,
+                systemPrompt,
+                model: model || client.getDefaultModel(),
+                jsonMode: true,
+            });
+        },
+    };
+}
+/**
+ * Create an LLMCaller from a provider preset.
+ */
+export function createLLMCallerFromPreset(presetName, apiKey) {
+    const client = OpenAICompatibleClient.fromPreset(presetName, apiKey);
+    return createLLMCallerFromOpenAI(client);
+}
+/**
+ * Create an LLMCaller from environment variables.
+ *
+ * Checks in order:
+ * 1. MINIMAX_API_KEY → MiniMax
+ * 2. DEEPSEEK_API_KEY → DeepSeek
+ * 3. QWEN_API_KEY → Qwen
+ * 4. MOONSHOT_API_KEY → Moonshot
+ * 5. TOGETHER_API_KEY → Together AI
+ * 6. OPENROUTER_API_KEY → OpenRouter
+ * 7. OPENAI_API_KEY → OpenAI
+ * 8. GEMINI_API_KEY → Falls back to Gemini
+ */
+export function createLLMCallerFromEnv() {
+    const providers = [
+        { envKey: 'MINIMAX_API_KEY', preset: 'minimax' },
+        { envKey: 'DEEPSEEK_API_KEY', preset: 'deepseek' },
+        { envKey: 'QWEN_API_KEY', preset: 'qwen' },
+        { envKey: 'MOONSHOT_API_KEY', preset: 'moonshot' },
+        { envKey: 'TOGETHER_API_KEY', preset: 'together' },
+        { envKey: 'OPENROUTER_API_KEY', preset: 'openrouter' },
+        { envKey: 'OPENAI_API_KEY', preset: 'openai' },
+    ];
+    for (const { envKey, preset } of providers) {
+        const apiKey = process.env[envKey];
+        if (apiKey) {
+            return createLLMCallerFromPreset(preset, apiKey);
+        }
+    }
+    // No OpenAI-compatible provider found
+    return null;
+}
+//# sourceMappingURL=openai-compatible.js.map

package/dist/src/providers/openai-compatible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.js","sourceRoot":"","sources":["../../../src/providers/openai-compatible.ts"],"names":[],"mappings":"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"}

package/dist/src/providers/provider-config.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Provider Configuration
+ *
+ * Manages LLM provider selection and configuration.
+ * Default provider: MiniMax M2.1
+ */
+import type { LLMCaller } from '../cognitive/runtime/executor.js';
+export type ProviderType = 'minimax' | 'deepseek' | 'qwen' | 'moonshot' | 'together' | 'openrouter' | 'openai' | 'gemini' | 'custom';
+export interface ProviderSettings {
+    /** Provider type */
+    provider: ProviderType;
+    /** Model name (optional, uses provider default if not set) */
+    model?: string;
+    /** API key (optional, reads from env if not set) */
+    apiKey?: string;
+    /** Custom base URL (for custom providers) */
+    baseUrl?: string;
+}
+/**
+ * Default provider is MiniMax.
+ * Users can override via:
+ * - FIELD_PROVIDER env var
+ * - settings.json
+ * - CLI flags
+ */
+export declare const DEFAULT_PROVIDER: ProviderType;
+/**
+ * Default model for each provider.
+ */
+export declare const DEFAULT_MODELS: Record<ProviderType, string>;
+/**
+ * Environment variable names for API keys.
+ */
+export declare const API_KEY_ENV_VARS: Record<ProviderType, string>;
+/**
+ * Detect provider from environment variables.
+ * Returns the first provider with a configured API key.
+ */
+export declare function detectProviderFromEnv(): ProviderType | null;
+/**
+ * Get API key for a provider.
+ */
+export declare function getApiKey(provider: ProviderType): string | undefined;
+/**
+ * Create an LLMCaller based on settings.
+ * Falls back to environment detection if settings are incomplete.
+ */
+export declare function createLLMCaller(settings?: Partial<ProviderSettings>): LLMCaller;
+/**
+ * Create an LLMCaller with MiniMax as default.
+ * This is the recommended entry point for Field CLI.
+ */
+export declare function createDefaultLLMCaller(): LLMCaller;

package/dist/src/providers/provider-config.js

@@ -0,0 +1,146 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Provider Configuration
+ *
+ * Manages LLM provider selection and configuration.
+ * Default provider: MiniMax M2.1
+ */
+import { OpenAICompatibleClient, createLLMCallerFromOpenAI, PROVIDER_PRESETS, } from './openai-compatible.js';
+// =============================================================================
+// Default Configuration
+// =============================================================================
+/**
+ * Default provider is MiniMax.
+ * Users can override via:
+ * - FIELD_PROVIDER env var
+ * - settings.json
+ * - CLI flags
+ */
+export const DEFAULT_PROVIDER = 'minimax';
+/**
+ * Default model for each provider.
+ */
+export const DEFAULT_MODELS = {
+    minimax: 'MiniMax-Text-01',
+    deepseek: 'deepseek-chat',
+    qwen: 'qwen-max',
+    moonshot: 'moonshot-v1-8k',
+    together: 'meta-llama/Llama-3.3-70B-Instruct-Turbo',
+    openrouter: 'anthropic/claude-3.5-sonnet',
+    openai: 'gpt-4o',
+    gemini: 'gemini-2.5-pro',
+    custom: 'custom-model',
+};
+/**
+ * Environment variable names for API keys.
+ */
+export const API_KEY_ENV_VARS = {
+    minimax: 'MINIMAX_API_KEY',
+    deepseek: 'DEEPSEEK_API_KEY',
+    qwen: 'QWEN_API_KEY',
+    moonshot: 'MOONSHOT_API_KEY',
+    together: 'TOGETHER_API_KEY',
+    openrouter: 'OPENROUTER_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    gemini: 'GEMINI_API_KEY',
+    custom: 'CUSTOM_API_KEY',
+};
+// =============================================================================
+// Provider Detection
+// =============================================================================
+/**
+ * Detect provider from environment variables.
+ * Returns the first provider with a configured API key.
+ */
+export function detectProviderFromEnv() {
+    // Check FIELD_PROVIDER first
+    const envProvider = process.env['FIELD_PROVIDER']?.toLowerCase();
+    if (envProvider && envProvider in API_KEY_ENV_VARS) {
+        return envProvider;
+    }
+    // Check API keys in priority order (MiniMax first)
+    const priorityOrder = [
+        'minimax',
+        'deepseek',
+        'qwen',
+        'moonshot',
+        'together',
+        'openrouter',
+        'openai',
+        'gemini',
+    ];
+    for (const provider of priorityOrder) {
+        const envVar = API_KEY_ENV_VARS[provider];
+        if (process.env[envVar]) {
+            return provider;
+        }
+    }
+    return null;
+}
+/**
+ * Get API key for a provider.
+ */
+export function getApiKey(provider) {
+    const envVar = API_KEY_ENV_VARS[provider];
+    return process.env[envVar];
+}
+// =============================================================================
+// LLM Caller Factory
+// =============================================================================
+/**
+ * Create an LLMCaller based on settings.
+ * Falls back to environment detection if settings are incomplete.
+ */
+export function createLLMCaller(settings) {
+    // Determine provider
+    const provider = settings?.provider || detectProviderFromEnv() || DEFAULT_PROVIDER;
+    // Get API key
+    const apiKey = settings?.apiKey || getApiKey(provider);
+    if (!apiKey) {
+        throw new Error(`No API key found for provider '${provider}'. ` +
+            `Set ${API_KEY_ENV_VARS[provider]} environment variable.`);
+    }
+    // Handle Gemini separately (uses different SDK)
+    if (provider === 'gemini') {
+        // Return a placeholder - actual Gemini caller is created elsewhere
+        throw new Error('Gemini provider should use createSimpleLLMCaller from gemini-adapter.js');
+    }
+    // Get model
+    const model = settings?.model || DEFAULT_MODELS[provider];
+    // Get preset or create custom config
+    let client;
+    if (provider === 'custom' && settings?.baseUrl) {
+        client = new OpenAICompatibleClient({
+            baseUrl: settings.baseUrl,
+            apiKey,
+            defaultModel: model,
+            providerName: 'Custom',
+        });
+    }
+    else {
+        const preset = PROVIDER_PRESETS[provider];
+        if (!preset) {
+            throw new Error(`Unknown provider: ${provider}`);
+        }
+        client = new OpenAICompatibleClient({
+            ...preset,
+            apiKey,
+            defaultModel: model,
+        });
+    }
+    return createLLMCallerFromOpenAI(client);
+}
+/**
+ * Create an LLMCaller with MiniMax as default.
+ * This is the recommended entry point for Field CLI.
+ */
+export function createDefaultLLMCaller() {
+    return createLLMCaller();
+}
+// =============================================================================
+// Exports (types and functions are already exported inline above)
+// =============================================================================
+//# sourceMappingURL=provider-config.js.map

package/dist/src/providers/provider-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-config.js","sourceRoot":"","sources":["../../../src/providers/provider-config.ts"],"names":[],"mappings":"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"}