@amodalai/runtime 0.1.26 → 0.2.0

package/dist/src/context/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Types for the context compiler.
+ *
+ * These describe the raw inputs the compiler accepts — closely mirroring
+ * the AgentBundle shape but only the fields relevant to prompt building.
+ * The compiler is the single place that transforms these into a system prompt.
+ */
+import type { StoreFieldDefinition } from '@amodalai/types';
+/** A connection's API surface for prompt inclusion. */
+export interface CompilerConnection {
+    name: string;
+    description?: string;
+    endpoints: Array<{
+        method: string;
+        path: string;
+        description: string;
+    }>;
+    entities?: string;
+    rules?: string;
+    fieldRestrictions?: Array<{
+        entity: string;
+        field: string;
+        policy: 'never_retrieve' | 'role_gated' | 'retrieve_but_redact';
+        reason?: string;
+        allowedRoles?: string[];
+    }>;
+    rowScoping?: Record<string, Record<string, {
+        type: string;
+        label?: string;
+    }>>;
+    alternativeLookups?: Array<{
+        restrictedField: string;
+        alternativeEndpoint: string;
+        description?: string;
+    }>;
+}
+/** A skill loaded from the agent repo. */
+export interface CompilerSkill {
+    name: string;
+    description: string;
+    trigger?: string;
+    body?: string;
+}
+/** A knowledge document loaded from the agent repo. */
+export interface CompilerKnowledge {
+    name: string;
+    title?: string;
+    body?: string;
+}
+/** A store definition for prompt inclusion. */
+export interface CompilerStore {
+    name: string;
+    entity: {
+        name: string;
+        key: string;
+        schema: Record<string, StoreFieldDefinition>;
+    };
+}
+/** Full input to the context compiler. */
+export interface CompilerInput {
+    /** Agent name (required). */
+    name: string;
+    /** Agent description — what the agent is. */
+    description?: string;
+    /** User context — standing instructions for the deployment. */
+    userContext?: string;
+    /** Custom agent prompt override from agents/main.md. */
+    agentOverride?: string;
+    /** Custom base prompt — if set, skip compilation entirely. */
+    basePrompt?: string;
+    /** Connections with their API surfaces and access config. */
+    connections?: CompilerConnection[];
+    /** Skills loaded from skills/. */
+    skills?: CompilerSkill[];
+    /** Knowledge docs loaded from knowledge/. */
+    knowledge?: CompilerKnowledge[];
+    /** Store definitions loaded from stores/. */
+    stores?: CompilerStore[];
+    /** User's roles for field guidance and scope resolution. */
+    userRoles?: string[];
+    /** Automation context — prompt and constraints when running as an automation. */
+    automationContext?: string;
+    /** Whether plan mode is active. */
+    planMode?: boolean;
+    /** Pre-approved plan for execution. */
+    approvedPlan?: string;
+    /** Token budget for the system prompt. If exceeded, a warning is emitted. */
+    maxSystemTokens?: number;
+}
+/** Output from the context compiler. */
+export interface CompilerOutput {
+    /** The compiled system prompt string. */
+    systemPrompt: string;
+    /** Whether the prompt was compiled or came from a basePrompt override. */
+    source: 'compiled' | 'base_prompt_override';
+    /** Per-section token estimates (chars / 4) for the context inspector. */
+    contributions: CompilerContribution[];
+    /** Warnings emitted during compilation (e.g. token budget exceeded). */
+    warnings: string[];
+}
+export interface CompilerContribution {
+    name: string;
+    category: 'system' | 'connection' | 'skill' | 'knowledge' | 'store';
+    tokens: number;
+}

package/dist/src/context/types.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/context/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/index.d.ts

@@ -4,26 +4,27 @@
  * SPDX-License-Identifier: MIT
  */
 export declare const SERVER_VERSION = "0.1.0";
+export { createAgent } from './api/create-agent.js';
+export type { Agent, AgentConfig, AgentSession } from './api/types.js';
 export { createServer } from './server.js';
 export type { ServerInstance, CreateServerOptions } from './server.js';
 export type { ServerConfig } from './types.js';
 export { createAIStreamRouter, type AIStreamRouterOptions } from './routes/ai-stream.js';
 export { createLocalServer } from './agent/local-server.js';
-export type { LocalServerConfig, AgentChatRequest, AgentSession } from './agent/agent-types.js';
-export { SessionManager } from './session/session-manager.js';
-export type { ManagedSession, SessionManagerOptions, SessionStore, StoredSessionRecord } from './session/session-manager.js';
+export type { LocalServerConfig, AgentChatRequest } from './agent/agent-types.js';
 export { ProactiveRunner } from './agent/proactive/proactive-runner.js';
 export type { AutomationInfo, ProactiveRunnerConfig } from './agent/proactive/proactive-runner.js';
 export { createSnapshotServer } from './agent/snapshot-server.js';
 export type { SnapshotServerConfig } from './agent/snapshot-server.js';
 export { createChatStreamRouter } from './routes/chat-stream.js';
 export type { ChatStreamRouterOptions } from './routes/chat-stream.js';
+export { createChatRouter } from './routes/chat.js';
+export type { ChatRouterOptions } from './routes/chat.js';
 export { createTaskRouter } from './agent/routes/task.js';
 export type { TaskRouterOptions } from './agent/routes/task.js';
 export { getAuthContext } from './middleware/auth.js';
 export type { AuthContext } from './middleware/auth.js';
-export type { StreamHooks } from './session/session-runner.js';
-export { runMessage } from './session/session-runner.js';
+export type { StreamHooks, TokenCounts } from './session/stream-hooks.js';
 export { routeOutput } from './output/output-router.js';
 export { errorHandler } from './middleware/error-handler.js';
 export { AmodalError, ProviderError, RateLimitError, ProviderTimeoutError, ToolExecutionError, StoreError, ConnectionError, SessionError, CompactionError, ConfigError, } from './errors.js';
@@ -31,4 +32,30 @@ export type { Result } from './errors.js';
 export { log, setLogLevel, getLogLevel, setLogFormat, getLogFormat, setSanitize, LogLevel, initLogLevel, interceptConsole, verbosityToLogLevel, createLogger } from './logger.js';
 export type { Logger, LoggerConfig, LogFormat } from './logger.js';
 export { loadConfig } from './config.js';
-export type { AgentConfig, ConfigOverrides, LoadConfigOptions, McpServerConfig } from './config.js';
+export type { AgentConfig as LegacyAgentConfig, ConfigOverrides, LoadConfigOptions, McpServerConfig } from './config.js';
+export { createProvider } from './providers/create-provider.js';
+export { createFailoverProvider } from './providers/failover.js';
+export type { FailoverChainConfig } from './providers/failover.js';
+export type { LLMProvider, ProviderConfig, StreamTextOptions, StreamTextResult, GenerateTextOptions, GenerateTextResult, TokenUsage, StreamEvent, } from './providers/types.js';
+export { runAgent, transition } from './agent/loop.js';
+export type { AgentState, AgentContext, AgentLoopConfig, TransitionResult, RunAgentOptions, ToolCall, ToolResult, DoneReason, ThinkingState, StreamingState, ExecutingState, ConfirmingState, CompactingState, DispatchingState, DoneState, DispatchConfig, } from './agent/loop-types.js';
+export { DEFAULT_LOOP_CONFIG } from './agent/loop-types.js';
+export { createToolRegistry } from './tools/registry.js';
+export type { ToolDefinition, ToolContext, ToolCategory, ToolMetadata, ToolRegistry, } from './tools/types.js';
+export { createMcpToolDefinition, registerMcpTools, } from './tools/mcp-tool-adapter.js';
+export { createStoreWriteTool, createStoreBatchTool, createStoreQueryTool, registerStoreTools, storeToToolName, QUERY_STORE_TOOL_NAME, } from './tools/store-tools.js';
+export { createRequestTool, REQUEST_TOOL_NAME } from './tools/request-tool.js';
+export type { ConnectionsMap, CreateRequestToolOptions } from './tools/request-tool.js';
+export { createReadRepoFileTool, createWriteRepoFileTool, createDeleteRepoFileTool, createInternalApiTool, registerAdminFileTools, } from './tools/admin-file-tools.js';
+export { StandaloneSessionManager } from './session/manager.js';
+export type { Session, CreateSessionOptions, SessionManagerOptions as StandaloneSessionManagerOptions, TurnUsage, AutomationResult, PersistedSession, } from './session/types.js';
+export { buildSessionComponents, PRESENT_TOOL_NAME, STOP_EXECUTION_TOOL_NAME } from './session/session-builder.js';
+export type { SessionComponents, BuildSessionComponentsOptions, SessionType } from './session/session-builder.js';
+export { createToolContextFactory } from './session/tool-context-factory.js';
+export type { ToolContextFactoryOptions } from './session/tool-context-factory.js';
+export { resolveSession, resolveBundle } from './routes/session-resolver.js';
+export type { BundleResolver, SharedResources, ResolvedSession, ResolveSessionOptions } from './routes/session-resolver.js';
+export { compileContext } from './context/compiler.js';
+export type { CompilerInput, CompilerOutput, CompilerContribution, CompilerConnection, CompilerSkill, CompilerKnowledge, CompilerStore, } from './context/types.js';
+export { AccessJsonPermissionChecker } from './security/permission-checker.js';
+export type { PermissionChecker, PermissionResult, PermissionCheckRequest, } from './security/permission-checker.js';

package/dist/src/index.js

@@ -6,21 +6,26 @@
 import { createServer } from './server.js';
 import { log } from './logger.js';
 export const SERVER_VERSION = '0.1.0';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export { createAgent } from './api/create-agent.js';
+// ---------------------------------------------------------------------------
 // Re-export for consumers
+// ---------------------------------------------------------------------------
 export { createServer } from './server.js';
 export { createAIStreamRouter } from './routes/ai-stream.js';
 // Local mode
 export { createLocalServer } from './agent/local-server.js';
-export { SessionManager } from './session/session-manager.js';
 export { ProactiveRunner } from './agent/proactive/proactive-runner.js';
 // Snapshot mode
 export { createSnapshotServer } from './agent/snapshot-server.js';
 // Route creators (used by hosted-runtime to build its own server)
 export { createChatStreamRouter } from './routes/chat-stream.js';
+export { createChatRouter } from './routes/chat.js';
 export { createTaskRouter } from './agent/routes/task.js';
 // Auth types (middleware implementation provided by hosting layer)
 export { getAuthContext } from './middleware/auth.js';
-export { runMessage } from './session/session-runner.js';
 // Output routing (for automation result delivery)
 export { routeOutput } from './output/output-router.js';
 // Error handler
@@ -31,6 +36,34 @@ export { AmodalError, ProviderError, RateLimitError, ProviderTimeoutError, ToolE
 export { log, setLogLevel, getLogLevel, setLogFormat, getLogFormat, setSanitize, LogLevel, initLogLevel, interceptConsole, verbosityToLogLevel, createLogger } from './logger.js';
 // Config
 export { loadConfig } from './config.js';
+// LLM Provider (Vercel AI SDK abstraction)
+export { createProvider } from './providers/create-provider.js';
+export { createFailoverProvider } from './providers/failover.js';
+// Agent loop (state machine)
+export { runAgent, transition } from './agent/loop.js';
+export { DEFAULT_LOOP_CONFIG } from './agent/loop-types.js';
+// Tool registry
+export { createToolRegistry } from './tools/registry.js';
+// MCP tool adapter
+export { createMcpToolDefinition, registerMcpTools, } from './tools/mcp-tool-adapter.js';
+// Store tools (new Zod-based implementations)
+export { createStoreWriteTool, createStoreBatchTool, createStoreQueryTool, registerStoreTools, storeToToolName, QUERY_STORE_TOOL_NAME, } from './tools/store-tools.js';
+// Connection request tool
+export { createRequestTool, REQUEST_TOOL_NAME } from './tools/request-tool.js';
+// Admin file tools
+export { createReadRepoFileTool, createWriteRepoFileTool, createDeleteRepoFileTool, createInternalApiTool, registerAdminFileTools, } from './tools/admin-file-tools.js';
+// Standalone session manager
+export { StandaloneSessionManager } from './session/manager.js';
+// Session builder
+export { buildSessionComponents, PRESENT_TOOL_NAME, STOP_EXECUTION_TOOL_NAME } from './session/session-builder.js';
+// Tool context factory
+export { createToolContextFactory } from './session/tool-context-factory.js';
+// Session resolver
+export { resolveSession, resolveBundle } from './routes/session-resolver.js';
+// Context compiler
+export { compileContext } from './context/compiler.js';
+// Permission checker
+export { AccessJsonPermissionChecker } from './security/permission-checker.js';
 // ---------------------------------------------------------------------------
 // Environment variable parsing
 // ---------------------------------------------------------------------------
@@ -52,30 +85,11 @@ async function main() {
     const port = getEnvInt('PORT', 3000);
     const host = getEnvOrDefault('HOST', '0.0.0.0');
     const sessionTtlMs = getEnvInt('SESSION_TTL_MS', 30 * 60 * 1000);
-    // LLM config comes from env. Default matches the platform API default.
-    const model = getEnvOrDefault('MODEL', 'claude-sonnet-4-20250514');
-    // WORKSPACE_DIR scopes file tools and shell_exec. In Docker, set to
-    // /workspace so the agent cannot read server source code. When unset,
-    // falls back to process.cwd() for local dev.
-    const workspaceDir = process.env['WORKSPACE_DIR'] || process.cwd();
-    // Base config params — minimal, org-agnostic defaults.
-    // Org-specific config (tools, skills, knowledge, base_prompt, agent_context)
-    // loaded per session using the API key from each request.
-    const baseParams = {
-        sessionId: 'server-init',
-        model,
-        cwd: workspaceDir,
-        targetDir: workspaceDir,
-        debugMode: process.env['DEBUG'] === 'true',
-        interactive: false,
-        noBrowser: true,
-    };
     // Create and start server
     let serverInstance;
     try {
         const corsOrigin = process.env['CORS_ORIGIN'] || undefined;
         serverInstance = createServer({
-            baseParams,
             config: {
                 port,
                 host,

package/dist/src/index.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { LLMProvider, ProviderConfig } from './types.js';
+/**
+ * Create an LLMProvider from a ProviderConfig.
+ *
+ * @example
+ * ```ts
+ * const provider = createProvider({
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-20250514',
+ *   apiKey: process.env.ANTHROPIC_API_KEY,
+ * });
+ *
+ * const result = provider.streamText({
+ *   messages: [{role: 'user', content: [{type: 'text', text: 'Hello'}]}],
+ * });
+ * ```
+ */
+export declare function createProvider(config: ProviderConfig): LLMProvider;

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

@@ -0,0 +1,185 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { streamText, generateText } from 'ai';
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { createOpenAI } from '@ai-sdk/openai';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { ConfigError } from '../errors.js';
+/** Default timeout for LLM calls when no AbortSignal is provided (2 minutes). */
+const DEFAULT_LLM_TIMEOUT_MS = 120_000;
+// ---------------------------------------------------------------------------
+// OpenAI-compatible provider base URLs
+// ---------------------------------------------------------------------------
+const OPENAI_COMPATIBLE_BASE_URLS = {
+    deepseek: 'https://api.deepseek.com/v1',
+    groq: 'https://api.groq.com/openai/v1',
+    mistral: 'https://api.mistral.ai/v1',
+    xai: 'https://api.x.ai/v1',
+    fireworks: 'https://api.fireworks.ai/inference/v1',
+    together: 'https://api.together.xyz/v1',
+};
+// ---------------------------------------------------------------------------
+// createLanguageModel — resolve config to an AI SDK LanguageModel
+// ---------------------------------------------------------------------------
+function createLanguageModel(config) {
+    const { provider, model, apiKey, baseUrl } = config;
+    switch (provider) {
+        case 'anthropic': {
+            const anthropic = createAnthropic({
+                apiKey,
+                ...(baseUrl ? { baseURL: baseUrl } : {}),
+            });
+            return anthropic(model);
+        }
+        case 'openai': {
+            const openai = createOpenAI({
+                apiKey,
+                ...(baseUrl ? { baseURL: baseUrl } : {}),
+            });
+            return openai(model);
+        }
+        case 'google': {
+            const google = createGoogleGenerativeAI({
+                apiKey,
+                ...(baseUrl ? { baseURL: baseUrl } : {}),
+            });
+            return google(model);
+        }
+        default: {
+            // OpenAI-compatible providers (DeepSeek, Groq, Mistral, xAI, etc.)
+            const compatBaseUrl = baseUrl ?? OPENAI_COMPATIBLE_BASE_URLS[provider];
+            if (!compatBaseUrl) {
+                throw new ConfigError(`Unknown provider "${provider}". Use a known provider (anthropic, openai, google) or set a baseUrl for OpenAI-compatible providers.`, {
+                    key: 'providers',
+                    context: { provider, model },
+                });
+            }
+            const openai = createOpenAI({
+                apiKey,
+                baseURL: compatBaseUrl,
+            });
+            return openai(model);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// normalizeUsage — map AI SDK LanguageModelUsage to our TokenUsage
+// ---------------------------------------------------------------------------
+function normalizeUsage(usage) {
+    return {
+        inputTokens: usage?.inputTokens ?? 0,
+        outputTokens: usage?.outputTokens ?? 0,
+        cachedInputTokens: usage?.inputTokenDetails?.cacheReadTokens ?? undefined,
+        cacheCreationInputTokens: usage?.inputTokenDetails?.cacheWriteTokens ?? undefined,
+        totalTokens: usage?.totalTokens ?? (usage?.inputTokens ?? 0) + (usage?.outputTokens ?? 0),
+    };
+}
+// ---------------------------------------------------------------------------
+// createProvider — public factory
+// ---------------------------------------------------------------------------
+/**
+ * Create an LLMProvider from a ProviderConfig.
+ *
+ * @example
+ * ```ts
+ * const provider = createProvider({
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-20250514',
+ *   apiKey: process.env.ANTHROPIC_API_KEY,
+ * });
+ *
+ * const result = provider.streamText({
+ *   messages: [{role: 'user', content: [{type: 'text', text: 'Hello'}]}],
+ * });
+ * ```
+ */
+export function createProvider(config) {
+    const languageModel = createLanguageModel(config);
+    return {
+        model: config.model,
+        provider: config.provider,
+        languageModel,
+        streamText(opts) {
+            const sdkResult = streamText({
+                model: languageModel,
+                messages: opts.messages,
+                system: opts.system,
+                tools: opts.tools,
+                toolChoice: opts.toolChoice,
+                maxOutputTokens: opts.maxOutputTokens,
+                temperature: opts.temperature,
+                abortSignal: opts.abortSignal ?? AbortSignal.timeout(DEFAULT_LLM_TIMEOUT_MS),
+            });
+            const usagePromise = sdkResult.usage.then((u) => normalizeUsage(u));
+            const textPromise = sdkResult.text;
+            return {
+                textStream: sdkResult.textStream,
+                fullStream: (async function* () {
+                    for await (const chunk of sdkResult.fullStream) {
+                        // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- intentionally ignoring SDK-internal chunk types (reasoning, source, raw, etc.)
+                        switch (chunk.type) {
+                            case 'text-delta':
+                                yield { type: 'text-delta', textDelta: chunk.text };
+                                break;
+                            case 'tool-call':
+                                yield {
+                                    type: 'tool-call',
+                                    toolCallId: chunk.toolCallId,
+                                    toolName: chunk.toolName,
+                                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- AI SDK boundary: input is tool params from provider
+                                    args: (chunk.input ?? {}),
+                                };
+                                break;
+                            case 'tool-result':
+                                yield {
+                                    type: 'tool-result',
+                                    toolCallId: chunk.toolCallId,
+                                    toolName: chunk.toolName,
+                                    result: chunk.output,
+                                };
+                                break;
+                            case 'finish':
+                                yield { type: 'finish', usage: normalizeUsage(chunk.totalUsage) };
+                                break;
+                            case 'error':
+                                yield { type: 'error', error: chunk.error };
+                                break;
+                            default:
+                                // Ignore other chunk types (step-start, step-finish, reasoning, source, etc.)
+                                break;
+                        }
+                    }
+                })(),
+                usage: usagePromise,
+                text: textPromise,
+            };
+        },
+        async generateText(opts) {
+            const result = await generateText({
+                model: languageModel,
+                messages: opts.messages,
+                system: opts.system,
+                tools: opts.tools,
+                toolChoice: opts.toolChoice,
+                maxOutputTokens: opts.maxOutputTokens,
+                temperature: opts.temperature,
+                abortSignal: opts.abortSignal ?? AbortSignal.timeout(DEFAULT_LLM_TIMEOUT_MS),
+            });
+            return {
+                text: result.text,
+                toolCalls: result.toolCalls.map((tc) => ({
+                    toolCallId: tc.toolCallId,
+                    toolName: tc.toolName,
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- AI SDK boundary: input is tool params from provider
+                    args: (tc.input ?? {}),
+                })),
+                usage: normalizeUsage(result.usage),
+                finishReason: result.finishReason,
+            };
+        },
+    };
+}
+//# sourceMappingURL=create-provider.js.map

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

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

package/dist/src/{agent/stores-e2e.test.d.ts → providers/create-provider.test.d.ts}

@@ -1,6 +1,6 @@
 /**
  * @license
- * Copyright 2025 Amodal Labs, Inc.
+ * Copyright 2026 Amodal Labs, Inc.
  * SPDX-License-Identifier: MIT
  */
 export {};

package/dist/src/providers/create-provider.test.js

@@ -0,0 +1,95 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect } from 'vitest';
+import { createProvider } from './create-provider.js';
+import { ConfigError } from '../errors.js';
+describe('createProvider', () => {
+    it('creates an Anthropic provider', () => {
+        const provider = createProvider({
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-20250514',
+            apiKey: 'test-key',
+        });
+        expect(provider.provider).toBe('anthropic');
+        expect(provider.model).toBe('claude-sonnet-4-20250514');
+        expect(provider.languageModel).toBeDefined();
+        expect(typeof provider.streamText).toBe('function');
+        expect(typeof provider.generateText).toBe('function');
+    });
+    it('creates an OpenAI provider', () => {
+        const provider = createProvider({
+            provider: 'openai',
+            model: 'gpt-4o',
+            apiKey: 'test-key',
+        });
+        expect(provider.provider).toBe('openai');
+        expect(provider.model).toBe('gpt-4o');
+        expect(provider.languageModel).toBeDefined();
+    });
+    it('creates a Google provider', () => {
+        const provider = createProvider({
+            provider: 'google',
+            model: 'gemini-2.5-flash',
+            apiKey: 'test-key',
+        });
+        expect(provider.provider).toBe('google');
+        expect(provider.model).toBe('gemini-2.5-flash');
+        expect(provider.languageModel).toBeDefined();
+    });
+    it('creates an OpenAI-compatible provider for known providers', () => {
+        const providers = [
+            { provider: 'deepseek', model: 'deepseek-chat', apiKey: 'test-key' },
+            { provider: 'groq', model: 'llama-3.1-70b', apiKey: 'test-key' },
+            { provider: 'mistral', model: 'mistral-large', apiKey: 'test-key' },
+            { provider: 'xai', model: 'grok-3', apiKey: 'test-key' },
+        ];
+        for (const config of providers) {
+            const provider = createProvider(config);
+            expect(provider.provider).toBe(config.provider);
+            expect(provider.model).toBe(config.model);
+            expect(provider.languageModel).toBeDefined();
+        }
+    });
+    it('creates a custom OpenAI-compatible provider with baseUrl', () => {
+        const provider = createProvider({
+            provider: 'custom-llm',
+            model: 'my-model',
+            apiKey: 'test-key',
+            baseUrl: 'https://my-llm.example.com/v1',
+        });
+        expect(provider.provider).toBe('custom-llm');
+        expect(provider.model).toBe('my-model');
+        expect(provider.languageModel).toBeDefined();
+    });
+    it('throws ConfigError for unknown provider without baseUrl', () => {
+        expect(() => createProvider({
+            provider: 'unknown-provider',
+            model: 'some-model',
+            apiKey: 'test-key',
+        })).toThrow(ConfigError);
+    });
+    it('supports baseUrl override for known providers', () => {
+        const provider = createProvider({
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-20250514',
+            apiKey: 'test-key',
+            baseUrl: 'https://proxy.example.com/anthropic',
+        });
+        expect(provider.provider).toBe('anthropic');
+        expect(provider.languageModel).toBeDefined();
+    });
+    it('satisfies LLMProvider interface', () => {
+        const provider = createProvider({
+            provider: 'anthropic',
+            model: 'claude-sonnet-4-20250514',
+            apiKey: 'test-key',
+        });
+        // Type-level check: assignable to LLMProvider
+        const _check = provider;
+        expect(_check).toBeDefined();
+    });
+});
+//# sourceMappingURL=create-provider.test.js.map

package/dist/src/providers/create-provider.test.js.map

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