@frontmcp/sdk 0.6.2 → 0.7.1

package/adapter/adapter.instance.d.ts

@@ -1,4 +1,5 @@
-import { AdapterEntry, AdapterRecord, Reference } from '../common';
+import { Reference } from '@frontmcp/di';
+import { AdapterEntry, AdapterRecord } from '../common';
 import ProviderRegistry from '../provider/provider.registry';
 export declare class AdapterInstance extends AdapterEntry {
     readonly deps: Set<Reference>;
@@ -9,3 +10,4 @@ export declare class AdapterInstance extends AdapterEntry {
     constructor(record: AdapterRecord, deps: Set<Reference>, globalProviders: ProviderRegistry);
     protected initialize(): Promise<void>;
 }
+//# sourceMappingURL=adapter.instance.d.ts.map

package/adapter/adapter.instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.instance.d.ts","sourceRoot":"","sources":["../../src/adapter/adapter.instance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAiC,aAAa,EAAkB,MAAM,WAAW,CAAC;AACvG,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAK7D,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE3C,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB;cAQ1E,UAAU;CAkD3B"}

package/adapter/adapter.regsitry.d.ts

@@ -11,3 +11,4 @@ export default class AdapterRegistry extends RegistryAbstract<AdapterInstance, A
     protected initialize(): Promise<void>;
     getAdapters(): AdapterEntry[];
 }
+//# sourceMappingURL=adapter.regsitry.d.ts.map

package/adapter/adapter.regsitry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.regsitry.d.ts","sourceRoot":"","sources":["../../src/adapter/adapter.regsitry.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE/F,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAC,OAAO,OAAO,eACnB,SAAQ,gBAAgB,CAAC,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,CACtE,YAAW,wBAAwB;gBAEvB,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE;cAIzC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,sBAAsB,CAAC,aAAa,CAAC;IAgBvF,SAAS,CAAC,UAAU;IAcpB,0EAA0E;cAC1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3C,WAAW,IAAI,YAAY,EAAE;CAG9B"}

package/adapter/adapter.utils.d.ts

@@ -1,4 +1,5 @@
-import { Token, AdapterMetadata, AdapterRecord, AdapterType } from '../common';
+import { Token } from '@frontmcp/di';
+import { AdapterMetadata, AdapterRecord, AdapterType } from '../common';
 export declare function collectAdapterMetadata(cls: AdapterType): AdapterMetadata;
 export declare function normalizeAdapter(item: AdapterType): AdapterRecord;
 /**
@@ -8,3 +9,4 @@ export declare function normalizeAdapter(item: AdapterType): AdapterRecord;
  * - CLASS / CLASS_TOKEN: deps come from the class constructor or static with(...)
  */
 export declare function adapterDiscoveryDeps(rec: AdapterRecord): Token[];
+//# sourceMappingURL=adapter.utils.d.ts.map

package/adapter/adapter.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.utils.d.ts","sourceRoot":"","sources":["../../src/adapter/adapter.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgD,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,eAAe,EAAyB,aAAa,EAAE,WAAW,EAAe,MAAM,WAAW,CAAC;AAE5G,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe,CAMxE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAoDjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,KAAK,EAAE,CAchE"}

package/agent/adapters/adapter.factory.d.ts

@@ -0,0 +1,105 @@
+import { AgentLlmAdapter, AgentLlmConfig, AgentLlmBuiltinConfig, AgentLlmAdapterConfig, AgentApiKeyConfig, WithConfig } from '../../common';
+/**
+ * Interface for resolving configuration values.
+ * Implementations can resolve from app config, environment, etc.
+ */
+export interface ConfigResolver {
+    /**
+     * Get a configuration value by path.
+     * @param path Dot-notation path (e.g., 'llm.openai.apiKey')
+     * @returns The resolved value
+     */
+    get<T = unknown>(path: string): T;
+    /**
+     * Try to get a configuration value, returning undefined if not found.
+     */
+    tryGet<T = unknown>(path: string): T | undefined;
+}
+/**
+ * Interface for provider registry (DI).
+ */
+export interface ProviderResolver {
+    /**
+     * Get a provider by token.
+     */
+    get<T>(token: symbol | {
+        new (...args: unknown[]): T;
+    }): T;
+    /**
+     * Try to get a provider, returning undefined if not found.
+     */
+    tryGet<T>(token: symbol | {
+        new (...args: unknown[]): T;
+    }): T | undefined;
+}
+/**
+ * Resolve an API key from various sources.
+ */
+export declare function resolveApiKey(config: AgentApiKeyConfig, configResolver?: ConfigResolver): string;
+/**
+ * Resolve a string value that may be a WithConfig reference.
+ */
+export declare function resolveStringValue(value: string | WithConfig<string>, configResolver?: ConfigResolver): string;
+/**
+ * Check if config is a built-in provider config.
+ */
+export declare function isBuiltinConfig(config: AgentLlmConfig): config is AgentLlmBuiltinConfig;
+/**
+ * Check if config is a direct adapter config.
+ */
+export declare function isAdapterConfig(config: AgentLlmConfig): config is AgentLlmAdapterConfig;
+/**
+ * Check if config is a DI token.
+ */
+export declare function isTokenConfig(config: AgentLlmConfig): config is symbol;
+/**
+ * Check if value is an AgentLlmAdapter instance.
+ */
+export declare function isAdapterInstance(value: unknown): value is AgentLlmAdapter;
+/**
+ * Options for creating an LLM adapter.
+ */
+export interface CreateAdapterOptions {
+    /**
+     * Configuration resolver for WithConfig values.
+     */
+    configResolver?: ConfigResolver;
+    /**
+     * Provider resolver for DI token resolution.
+     */
+    providerResolver?: ProviderResolver;
+}
+/**
+ * Create an LLM adapter from configuration.
+ *
+ * FrontMCP uses LangChain as the standard adapter layer for all LLM providers.
+ * This provides a consistent API, built-in retry logic, and streaming support.
+ *
+ * Supported configuration types:
+ * - Provider shorthand (`{ provider: 'openai', model: 'gpt-4o', ... }`) - recommended
+ * - Direct LangChainAdapter instance (`{ adapter: new LangChainAdapter(...) }`)
+ * - Factory function (`{ adapter: (providers) => new LangChainAdapter(...) }`)
+ * - DI token (`LLM_ADAPTER` symbol)
+ *
+ * @example Provider shorthand (recommended)
+ * ```typescript
+ * const adapter = createAdapter({
+ *   provider: 'openai',
+ *   model: 'gpt-4o',
+ *   apiKey: { env: 'OPENAI_API_KEY' },
+ * });
+ * ```
+ *
+ * @example Direct LangChain adapter
+ * ```typescript
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * const adapter = createAdapter({
+ *   adapter: new LangChainAdapter({
+ *     model: new ChatOpenAI({ model: 'gpt-4o' }),
+ *   }),
+ * });
+ * ```
+ */
+export declare function createAdapter(config: AgentLlmConfig, options?: CreateAdapterOptions): AgentLlmAdapter;
+//# sourceMappingURL=adapter.factory.d.ts.map

package/agent/adapters/adapter.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.factory.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/adapter.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACX,MAAM,cAAc,CAAC;AAQtB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IAElC;;OAEG;IACH,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG;QAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,CAAC,CAAC;IAE3D;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG;QAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,SAAS,CAAC;CAC3E;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAgChG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAkB9G;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,qBAAqB,CAQvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,qBAAqB,CAOvF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB,GAAG,eAAe,CAyCzG"}

package/agent/adapters/base.adapter.d.ts

@@ -0,0 +1,116 @@
+import { AgentLlmAdapter, AgentPrompt, AgentMessage, AgentCompletion, AgentCompletionChunk, AgentToolDefinition, AgentCompletionOptions } from '../../common';
+/**
+ * Base configuration for all LLM adapters.
+ */
+export interface BaseLlmAdapterConfig {
+    /**
+     * Model identifier (e.g., 'gpt-4-turbo', 'claude-3-opus-20240229').
+     */
+    model: string;
+    /**
+     * API key for authentication.
+     */
+    apiKey: string;
+    /**
+     * Optional base URL for custom endpoints.
+     */
+    baseUrl?: string;
+    /**
+     * Default temperature for generations (0-2).
+     */
+    temperature?: number;
+    /**
+     * Default maximum tokens for responses.
+     */
+    maxTokens?: number;
+    /**
+     * Request timeout in milliseconds.
+     * @default 60000
+     */
+    timeout?: number;
+    /**
+     * Maximum number of retries for failed requests.
+     * @default 3
+     */
+    maxRetries?: number;
+}
+/**
+ * Abstract base class for LLM adapters with common functionality.
+ *
+ * Provides:
+ * - Configuration management
+ * - Retry logic
+ * - Error handling
+ * - Tool formatting utilities
+ */
+export declare abstract class BaseLlmAdapter implements AgentLlmAdapter {
+    protected readonly config: Required<Pick<BaseLlmAdapterConfig, 'model' | 'apiKey' | 'timeout' | 'maxRetries'>> & Omit<BaseLlmAdapterConfig, 'model' | 'apiKey' | 'timeout' | 'maxRetries'>;
+    constructor(config: BaseLlmAdapterConfig);
+    /**
+     * Generate a completion from the LLM.
+     */
+    abstract completion(prompt: AgentPrompt, tools?: AgentToolDefinition[], options?: AgentCompletionOptions): Promise<AgentCompletion>;
+    /**
+     * Stream a completion from the LLM.
+     * Default implementation wraps non-streaming completion.
+     */
+    streamCompletion(prompt: AgentPrompt, tools?: AgentToolDefinition[], options?: AgentCompletionOptions): AsyncGenerator<AgentCompletionChunk>;
+    /**
+     * Format messages for the provider's API.
+     */
+    protected formatMessages(messages: AgentMessage[]): unknown[];
+    /**
+     * Format a single message for the provider's API.
+     * Override in subclasses for provider-specific formatting.
+     */
+    protected abstract formatMessage(message: AgentMessage): unknown;
+    /**
+     * Format tools for the provider's API.
+     * Override in subclasses for provider-specific formatting.
+     */
+    protected abstract formatTools(tools: AgentToolDefinition[]): unknown[];
+    /**
+     * Parse the provider's response into AgentCompletion format.
+     */
+    protected abstract parseResponse(response: unknown): AgentCompletion;
+    /**
+     * Execute with retry logic.
+     */
+    protected withRetry<T>(fn: () => Promise<T>, retries?: number): Promise<T>;
+    /**
+     * Check if an error should not be retried.
+     */
+    protected isNonRetryableError(error: Error): boolean;
+    /**
+     * Sleep for a duration.
+     */
+    protected sleep(ms: number): Promise<void>;
+    /**
+     * Merge options with defaults.
+     */
+    protected mergeOptions(options?: AgentCompletionOptions): AgentCompletionOptions;
+}
+/**
+ * Error thrown when an LLM adapter encounters an error.
+ */
+export declare class LlmAdapterError extends Error {
+    readonly provider: string;
+    readonly code?: string | undefined;
+    readonly statusCode?: number | undefined;
+    readonly raw?: unknown | undefined;
+    constructor(message: string, provider: string, code?: string | undefined, statusCode?: number | undefined, raw?: unknown | undefined);
+}
+/**
+ * Error thrown when rate limited by the provider.
+ */
+export declare class LlmRateLimitError extends LlmAdapterError {
+    readonly retryAfter?: number | undefined;
+    constructor(provider: string, retryAfter?: number | undefined, raw?: unknown);
+}
+/**
+ * Error thrown when context length is exceeded.
+ */
+export declare class LlmContextLengthError extends LlmAdapterError {
+    constructor(provider: string, raw?: unknown);
+}
+//# sourceMappingURL=base.adapter.d.ts.map

package/agent/adapters/base.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.adapter.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/base.adapter.ts"],"names":[],"mappings":"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"}

package/agent/adapters/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * LLM adapters for FrontMCP agents.
+ *
+ * FrontMCP uses LangChain as the standard adapter layer for LLM integration.
+ * This provides:
+ * - Consistent API across all providers (OpenAI, Anthropic, Google, Mistral, etc.)
+ * - Built-in retry logic and error handling
+ * - Streaming support
+ * - Tool/function calling support
+ * - Token counting and usage tracking
+ *
+ * @example Using with OpenAI
+ * ```typescript
+ * import { ChatOpenAI } from '@langchain/openai';
+ * import { LangChainAdapter } from '@frontmcp/sdk';
+ *
+ * @Agent({
+ *   name: 'my-agent',
+ *   llm: {
+ *     adapter: new LangChainAdapter({
+ *       model: new ChatOpenAI({
+ *         model: 'gpt-4-turbo',
+ *         openAIApiKey: process.env.OPENAI_API_KEY,
+ *       }),
+ *     }),
+ *   },
+ * })
+ * ```
+ *
+ * @example Using built-in shorthand
+ * ```typescript
+ * @Agent({
+ *   name: 'my-agent',
+ *   llm: {
+ *     adapter: 'langchain',
+ *     provider: 'openai',
+ *     model: 'gpt-4-turbo',
+ *     apiKey: { env: 'OPENAI_API_KEY' },
+ *   },
+ * })
+ * ```
+ */
+export { BaseLlmAdapter, BaseLlmAdapterConfig, LlmAdapterError, LlmRateLimitError, LlmContextLengthError, } from './base.adapter';
+export { LangChainAdapter, LangChainAdapterConfig } from './langchain.adapter';
+export { createAdapter, CreateAdapterOptions, ConfigResolver, ProviderResolver, resolveApiKey, resolveStringValue, isBuiltinConfig, isAdapterConfig, isTokenConfig, isAdapterInstance, } from './adapter.factory';
+export { AgentLlmAdapter, AgentPrompt, AgentMessage, AgentCompletion, AgentCompletionChunk, AgentToolCall, AgentToolDefinition, AgentCompletionOptions, LLM_ADAPTER, } from '../../common/interfaces/llm-adapter.interface';
+//# sourceMappingURL=index.d.ts.map

package/agent/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,GACZ,MAAM,+CAA+C,CAAC"}

package/agent/adapters/langchain.adapter.d.ts

@@ -0,0 +1,178 @@
+import { AgentLlmAdapter, AgentPrompt, AgentCompletion, AgentCompletionChunk, AgentToolDefinition, AgentCompletionOptions } from '../../common';
+/**
+ * Minimal interface matching LangChain's BaseChatModel.
+ * This allows any LangChain model to be used without importing @langchain/core.
+ */
+export interface LangChainChatModel {
+    invoke(messages: LangChainMessage[], options?: LangChainInvokeOptions): Promise<LangChainAIMessage>;
+    stream?(messages: LangChainMessage[], options?: LangChainInvokeOptions): AsyncGenerator<LangChainStreamChunk>;
+    /**
+     * Bind tools to the model. Returns a new model instance with tools bound.
+     * This is the preferred way to add tools in LangChain.
+     */
+    bindTools?(tools: LangChainTool[]): LangChainChatModel;
+}
+interface LangChainMessage {
+    _getType(): string;
+}
+interface LangChainInvokeOptions {
+    tools?: LangChainTool[];
+    tool_choice?: string | {
+        type: string;
+        function?: {
+            name: string;
+        };
+    };
+}
+interface LangChainTool {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, unknown>;
+    };
+}
+interface LangChainAIMessage {
+    content: string;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+    }>;
+    response_metadata?: {
+        finish_reason?: string;
+        usage?: {
+            prompt_tokens?: number;
+            completion_tokens?: number;
+            total_tokens?: number;
+        };
+    };
+}
+interface LangChainStreamChunk {
+    content?: string;
+    tool_calls?: Array<{
+        id?: string;
+        name?: string;
+        args?: Record<string, unknown>;
+    }>;
+    tool_call_chunks?: Array<{
+        id?: string;
+        name?: string;
+        args?: string;
+        index?: number;
+    }>;
+    response_metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for the LangChain adapter.
+ */
+export interface LangChainAdapterConfig {
+    /**
+     * A LangChain chat model instance.
+     * Can be any model from @langchain/openai, @langchain/anthropic, etc.
+     *
+     * @example
+     * ```typescript
+     * import { ChatOpenAI } from '@langchain/openai';
+     * const model = new ChatOpenAI({ model: 'gpt-4-turbo' });
+     * const adapter = new LangChainAdapter({ model });
+     * ```
+     */
+    model: LangChainChatModel;
+    /**
+     * Default temperature for generations.
+     */
+    temperature?: number;
+    /**
+     * Default maximum tokens for responses.
+     */
+    maxTokens?: number;
+}
+/**
+ * LLM adapter that wraps any LangChain chat model.
+ *
+ * This adapter provides a unified interface for all LangChain-compatible models,
+ * including OpenAI, Anthropic, Google, Mistral, and many others.
+ *
+ * Benefits of using LangChain:
+ * - Consistent API across all providers
+ * - Built-in retry logic and error handling
+ * - Streaming support
+ * - Tool/function calling support
+ * - Token counting and usage tracking
+ *
+ * @example Using with OpenAI
+ * ```typescript
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * const adapter = new LangChainAdapter({
+ *   model: new ChatOpenAI({
+ *     model: 'gpt-4-turbo',
+ *     openAIApiKey: process.env.OPENAI_API_KEY,
+ *   }),
+ * });
+ * ```
+ *
+ * @example Using with Anthropic
+ * ```typescript
+ * import { ChatAnthropic } from '@langchain/anthropic';
+ *
+ * const adapter = new LangChainAdapter({
+ *   model: new ChatAnthropic({
+ *     model: 'claude-3-opus-20240229',
+ *     anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+ *   }),
+ * });
+ * ```
+ *
+ * @example Using with OpenRouter (via OpenAI SDK)
+ * ```typescript
+ * import { ChatOpenAI } from '@langchain/openai';
+ *
+ * const adapter = new LangChainAdapter({
+ *   model: new ChatOpenAI({
+ *     model: 'anthropic/claude-3-opus',
+ *     openAIApiKey: process.env.OPENROUTER_API_KEY,
+ *     configuration: {
+ *       baseURL: 'https://openrouter.ai/api/v1',
+ *     },
+ *   }),
+ * });
+ * ```
+ */
+export declare class LangChainAdapter implements AgentLlmAdapter {
+    private readonly model;
+    private readonly temperature?;
+    private readonly maxTokens?;
+    constructor(config: LangChainAdapterConfig);
+    /**
+     * Generate a completion using the LangChain model.
+     */
+    completion(prompt: AgentPrompt, tools?: AgentToolDefinition[], options?: AgentCompletionOptions): Promise<AgentCompletion>;
+    /**
+     * Stream a completion using the LangChain model.
+     */
+    streamCompletion(prompt: AgentPrompt, tools?: AgentToolDefinition[], options?: AgentCompletionOptions): AsyncGenerator<AgentCompletionChunk>;
+    /**
+     * Build LangChain messages from AgentPrompt.
+     */
+    private buildMessages;
+    /**
+     * Build LangChain tool definitions from AgentToolDefinition[].
+     */
+    private buildTools;
+    /**
+     * Parse LangChain response into AgentCompletion.
+     */
+    private parseResponse;
+    /**
+     * Map provider finish reason to AgentCompletion finish reason.
+     */
+    private mapFinishReason;
+    /**
+     * Wrap errors in LlmAdapterError.
+     */
+    private wrapError;
+}
+export {};
+//# sourceMappingURL=langchain.adapter.d.ts.map

package/agent/adapters/langchain.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.adapter.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/langchain.adapter.ts"],"names":[],"mappings":"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"}

package/agent/adapters/providers/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * LLM Provider Factories
+ *
+ * Auto-creates LangChain adapters based on provider configuration.
+ * OpenAI and Anthropic are included by default, other providers use dynamic imports.
+ */
+export * from './types';
+import { AgentLlmAdapter } from '../../../common';
+import type { LlmProvider, ProviderCommonOptions } from './types';
+/**
+ * Options for creating a provider-based adapter.
+ */
+export interface CreateProviderAdapterOptions extends ProviderCommonOptions {
+    /** The LLM provider to use. */
+    provider: LlmProvider;
+    /** The model identifier (e.g., 'gpt-4-turbo', 'claude-3-opus'). */
+    model: string;
+    /** API key for the provider. */
+    apiKey: string;
+    /**
+     * Custom base URL for the API endpoint.
+     * Supported by all providers for custom/self-hosted endpoints.
+     */
+    baseUrl?: string;
+}
+/**
+ * Create a LangChain adapter for the specified provider.
+ * OpenAI and Anthropic are built-in, other providers require package installation.
+ */
+export declare function createProviderAdapter(options: CreateProviderAdapterOptions): Promise<AgentLlmAdapter>;
+/**
+ * Synchronous version that throws if provider needs async loading.
+ * Used internally by the adapter factory for synchronous contexts.
+ */
+export declare function createProviderAdapterSync(options: CreateProviderAdapterOptions): AgentLlmAdapter;
+//# sourceMappingURL=index.d.ts.map

package/agent/adapters/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agent/adapters/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAC;AAExB,OAAO,EACL,eAAe,EAMhB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAMlE;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,qBAAqB;IACzE,+BAA+B;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2CD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC,CAgF3G;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,4BAA4B,GAAG,eAAe,CAIhG"}

package/agent/adapters/providers/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * LLM Provider Types and Model Definitions
+ */
+/**
+ * Supported LLM providers.
+ */
+export type LlmProvider = 'openai' | 'anthropic' | 'google' | 'mistral' | 'groq';
+/**
+ * Common options for all providers.
+ */
+export interface ProviderCommonOptions {
+    temperature?: number;
+    maxTokens?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/agent/adapters/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/agent/adapters/providers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAMjF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}