@happyvertical/ai 0.74.8

package/dist/node/factory.d.ts

@@ -0,0 +1,27 @@
+import { AIInterface } from '../shared/types';
+/**
+ * Re-export the universal getAI function
+ */
+export { getAI } from '../shared/factory';
+/**
+ * Node.js-enhanced auto-detection of AI provider based on available credentials
+ * Includes support for environment variables
+ *
+ * Supports both HAVE_AI_* environment variables and provider-specific variables:
+ * - HAVE_AI_PROVIDER / HAVE_AI_TYPE → provider type
+ * - HAVE_AI_API_KEY → fallback API key
+ * - LITELLM_BASE_URL / LITELLM_API_KEY / LITELLM_ADMIN_API_KEY → LiteLLM-specific gateway config
+ * - BIFROST_BASE_URL / BIFROST_API_KEY / BIFROST_ADMIN_URL / BIFROST_ADMIN_USER / BIFROST_ADMIN_PASSWORD → Bifrost gateway config
+ * - OLLAMA_HOST / OLLAMA_BASE_URL / OLLAMA_API_KEY → Ollama host/auth config
+ * - OPENAI_API_KEY → OpenAI-specific key
+ * - ANTHROPIC_API_KEY → Anthropic-specific key
+ * - GEMINI_API_KEY / GOOGLE_API_KEY → Gemini-specific key
+ * - HF_TOKEN → Hugging Face token
+ * - AWS_* → AWS Bedrock credentials
+ *
+ * @param options - Configuration options that may contain provider-specific credentials
+ * @returns Promise resolving to an AI provider instance
+ * @throws ValidationError if no provider can be detected from the options
+ */
+export declare function getAIAuto(options?: Record<string, any>): Promise<AIInterface>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/node/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/node/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,WAAW,EAWZ,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,SAAS,CAC7B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAChC,OAAO,CAAC,WAAW,CAAC,CA8NtB"}

package/dist/shared/client.d.ts

@@ -0,0 +1,410 @@
+import { default as OpenAI } from 'openai';
+import { AIMessageOptions } from './message';
+import { AIProviderType, AIRateLimitOptions } from './types';
+/**
+ * Common options for AI client configuration
+ */
+export interface AIClientOptions {
+    /**
+     * Type of AI client (e.g., 'openai')
+     */
+    type?: AIProviderType | string;
+    /**
+     * Response format for AI completions
+     */
+    responseFormat?: string;
+    /**
+     * API key for authentication
+     */
+    apiKey?: string;
+    /**
+     * Base URL for API requests
+     */
+    baseUrl?: string;
+    /**
+     * Admin API key for gateway providers that support provisioning.
+     */
+    adminApiKey?: string;
+    /**
+     * Admin base URL for gateway providers when it differs from `baseUrl`.
+     */
+    adminBaseUrl?: string;
+    /**
+     * Alias for adminBaseUrl.
+     */
+    adminUrl?: string;
+    /**
+     * Admin username for providers that use HTTP Basic auth.
+     */
+    adminUser?: string;
+    /**
+     * Admin username for providers that use HTTP Basic auth.
+     */
+    adminUsername?: string;
+    /**
+     * Admin password for providers that use HTTP Basic auth.
+     */
+    adminPassword?: string;
+    /**
+     * Custom admin headers for gateway providers.
+     */
+    adminHeaders?: Record<string, string>;
+    /**
+     * Optional shared pacing / retry configuration for getAI().
+     */
+    rateLimit?: AIRateLimitOptions;
+}
+/**
+ * Interface defining required methods for AI clients
+ */
+export interface AIClientInterface {
+    /**
+     * Configuration options for this client
+     */
+    options: AIClientOptions;
+    /**
+     * Sends a message to the AI and gets a response
+     *
+     * @param text - Message text
+     * @param options - Message options
+     * @returns Promise resolving to the AI response
+     */
+    message(text: string, options: AIMessageOptions): Promise<unknown>;
+    /**
+     * Gets a text completion from the AI
+     *
+     * @param text - Input text for completion
+     * @param options - Completion options
+     * @returns Promise resolving to the completion result
+     */
+    textCompletion(text: string, options: AIMessageOptions): Promise<unknown>;
+}
+/**
+ * Options for AI text completion requests
+ */
+export interface AITextCompletionOptions {
+    /**
+     * Model identifier to use
+     */
+    model?: string;
+    /**
+     * Timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Role of the message sender
+     */
+    role?: OpenAI.Chat.ChatCompletionRole;
+    /**
+     * Previous messages in the conversation
+     */
+    history?: OpenAI.Chat.ChatCompletionMessageParam[];
+    /**
+     * Name of the message sender
+     */
+    name?: string;
+    /**
+     * Penalty for token frequency
+     */
+    frequencyPenalty?: number;
+    /**
+     * Token bias adjustments
+     */
+    logitBias?: Record<string, number>;
+    /**
+     * Whether to return log probabilities
+     */
+    logprobs?: boolean;
+    /**
+     * Number of top log probabilities to return
+     */
+    topLogprobs?: number;
+    /**
+     * Maximum tokens to generate
+     */
+    maxTokens?: number;
+    /**
+     * Number of completions to generate
+     */
+    n?: number;
+    /**
+     * Penalty for token presence
+     */
+    presencePenalty?: number;
+    /**
+     * Format for the response
+     */
+    responseFormat?: {
+        type: 'text' | 'json_object';
+    };
+    /**
+     * Random seed for deterministic results
+     */
+    seed?: number;
+    /**
+     * Sequences that stop generation
+     */
+    stop?: string | Array<string>;
+    /**
+     * Whether to stream responses
+     */
+    stream?: boolean;
+    /**
+     * Sampling temperature
+     */
+    temperature?: number;
+    /**
+     * Top-p sampling parameter
+     */
+    topProbability?: number;
+    /**
+     * Available tools for the model
+     */
+    tools?: Array<any>;
+    /**
+     * Tool selection behavior
+     */
+    toolChoice?: 'none' | 'auto' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    /**
+     * User identifier
+     */
+    user?: string;
+    /**
+     * Callback for handling streaming responses
+     */
+    onProgress?: (partialMessage: string) => void;
+}
+/**
+ * Base class for AI clients
+ * Provides a common interface for different AI service providers
+ */
+export declare class AIClient {
+    /**
+     * Configuration options for this client
+     */
+    options: AIClientOptions;
+    /**
+     * Creates a new AIClient
+     *
+     * @param options - Client configuration options
+     */
+    constructor(options: AIClientOptions);
+    /**
+     * Sends a message to the AI
+     * Base implementation returns a placeholder response
+     *
+     * @param text - Message text
+     * @param options - Message options
+     * @returns Promise resolving to a placeholder response
+     */
+    message(_text: string, _options?: AITextCompletionOptions): Promise<string>;
+    /**
+     * Factory method to create appropriate AI client based on options
+     *
+     * @param options - Client configuration options
+     * @returns Promise resolving to an initialized AI client
+     * @throws Error if client type is invalid
+     */
+    static create(options: AIClientOptions | AIClient): Promise<AIClient | OpenAIClient>;
+    /**
+     * Gets a text completion from the AI
+     * In base class, delegates to message method
+     *
+     * @param text - Input text for completion
+     * @param options - Completion options
+     * @returns Promise resolving to the completion result
+     */
+    textCompletion(text: string, options?: AITextCompletionOptions): Promise<string>;
+}
+/**
+ * Creates an OpenAI client instance
+ *
+ * @param options - OpenAI configuration options
+ * @returns Promise resolving to an OpenAI client
+ */
+export declare function getOpenAI(options: {
+    apiKey?: string;
+    baseUrl?: string;
+}): Promise<OpenAI>;
+/**
+ * Options specific to OpenAI text completion requests
+ */
+export interface OpenAITextCompletionOptions {
+    /**
+     * Model identifier to use
+     */
+    model?: string;
+    /**
+     * Timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Role of the message sender
+     */
+    role?: OpenAI.Chat.ChatCompletionRole;
+    /**
+     * Previous messages in the conversation
+     */
+    history?: Array<OpenAI.Chat.ChatCompletionMessageParam>;
+    /**
+     * Name of the message sender
+     */
+    name?: string;
+    /**
+     * Penalty for token frequency
+     */
+    frequencyPenalty?: number;
+    /**
+     * Token bias adjustments
+     */
+    logitBias?: Record<string, number>;
+    /**
+     * Whether to return log probabilities
+     */
+    logprobs?: boolean;
+    /**
+     * Number of top log probabilities to return
+     */
+    topLogprobs?: number;
+    /**
+     * Maximum tokens to generate
+     */
+    maxTokens?: number;
+    /**
+     * Number of completions to generate
+     */
+    n?: number;
+    /**
+     * Penalty for token presence
+     */
+    presencePenalty?: number;
+    /**
+     * Format for the response
+     */
+    responseFormat?: {
+        type: 'text' | 'json_object';
+    };
+    /**
+     * Random seed for deterministic results
+     */
+    seed?: number;
+    /**
+     * Sequences that stop generation
+     */
+    stop?: string | Array<string>;
+    /**
+     * Whether to stream responses
+     */
+    stream?: boolean;
+    /**
+     * Sampling temperature
+     */
+    temperature?: number;
+    /**
+     * Top-p sampling parameter
+     */
+    topProbability?: number;
+    /**
+     * Available tools for the model
+     */
+    tools?: Array<OpenAI.Chat.ChatCompletionTool>;
+    /**
+     * Tool selection behavior
+     */
+    toolChoice?: 'none' | 'auto' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    /**
+     * User identifier
+     */
+    user?: string;
+    /**
+     * Callback for handling streaming responses
+     */
+    onProgress?: (partialMessage: string) => void;
+}
+/**
+ * Configuration options specific to OpenAI client
+ */
+export interface OpenAIClientOptions extends AIClientOptions {
+    /**
+     * OpenAI API key
+     */
+    apiKey?: string;
+    /**
+     * OpenAI API base URL
+     */
+    baseUrl?: string;
+}
+/**
+ * Client implementation for the OpenAI API
+ */
+export declare class OpenAIClient extends AIClient {
+    /**
+     * OpenAI client instance
+     */
+    protected openai: OpenAI;
+    /**
+     * Configuration options for this client
+     */
+    options: OpenAIClientOptions;
+    /**
+     * Creates a new OpenAIClient
+     *
+     * @param options - OpenAI client configuration options
+     */
+    constructor(options: OpenAIClientOptions);
+    /**
+     * Sends a message to OpenAI
+     *
+     * @param text - Message text
+     * @param options - Message options
+     * @returns Promise resolving to the OpenAI response
+     */
+    message(text: string, options?: AIMessageOptions): Promise<string>;
+    /**
+     * Factory method to create and initialize an OpenAIClient
+     *
+     * @param options - OpenAI client configuration options
+     * @returns Promise resolving to an initialized OpenAIClient
+     */
+    static create(options: OpenAIClientOptions): Promise<OpenAIClient>;
+    /**
+     * Initializes the OpenAI client
+     */
+    protected initialize(): Promise<void>;
+    /**
+     * Sends a text completion request to the OpenAI API
+     *
+     * @param message - The message to send
+     * @param options - Configuration options for the completion request
+     * @returns Promise resolving to the completion text
+     * @throws Error if the OpenAI API response is invalid
+     */
+    textCompletion(message: string, options?: OpenAITextCompletionOptions): Promise<string>;
+}
+/**
+ * Options for getting an AI client with type information
+ */
+type GetAIClientOptions = AIClientOptions & {
+    type?: AIProviderType;
+};
+/**
+ * Factory function to create and initialize an appropriate AI client
+ * Delegates to the modern getAI() factory for all provider types
+ *
+ * @param options - Client configuration options
+ * @returns Promise resolving to an initialized AI client
+ * @throws Error if client type is invalid
+ */
+export declare function getAIClient(options: GetAIClientOptions): Promise<AIClient>;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/shared/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/shared/client.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;IAE/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;OAEG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC;IAEzB;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnE;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E;AAwBD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,CAAC;IAEnD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;IAElD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EACP,MAAM,GACN,MAAM,GACN;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAErD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB;;OAEG;IACI,OAAO,EAAE,eAAe,CAAC;IAEhC;;;;OAIG;gBACS,OAAO,EAAE,eAAe;IAIpC;;;;;;;OAOG;IACU,OAAO,CAClB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,uBAA0C;IAKtD;;;;;;OAMG;WACiB,MAAM,CACxB,OAAO,EAAE,eAAe,GAAG,QAAQ,GAClC,OAAO,CAAC,QAAQ,GAAG,YAAY,CAAC;IAsCnC;;;;;;;OAOG;IACI,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAER;CAIJ;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,mBAKA;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAExD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;IAElD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9B;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAE9C;;OAEG;IACH,UAAU,CAAC,EACP,MAAM,GACN,MAAM,GACN;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAErD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IACxC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAG,MAAM,CAAC;IAE1B;;OAEG;IACI,OAAO,EAAE,mBAAmB,CAAC;IAEpC;;;;OAIG;gBACS,OAAO,EAAE,mBAAmB;IAKxC;;;;;;OAMG;IACU,OAAO,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAmC;IAM9C;;;;;OAKG;WACiB,MAAM,CACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC;IAMxB;;OAEG;cACa,UAAU;IAO1B;;;;;;;OAOG;IACU,cAAc,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,MAAM,CAAC;CAkGnB;AAED;;GAEG;AACH,KAAK,kBAAkB,GAAG,eAAe,GAAG;IAC1C,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAInB"}

package/dist/shared/factory.d.ts

@@ -0,0 +1,83 @@
+import { AIClientOptions } from './client';
+import { AIInterface, GetAIOptions } from './types';
+/**
+ * Creates an AI provider instance based on the provided options.
+ * Universal version that works in both browser and Node.js environments.
+ *
+ * Supports environment variable configuration using the pattern:
+ * - HAVE_AI_PROVIDER → provider type (string)
+ * - HAVE_AI_MODEL → defaultModel (string)
+ * - HAVE_AI_TIMEOUT → timeout (number)
+ * - HAVE_AI_MAX_RETRIES → maxRetries (number)
+ * - HAVE_AI_API_KEY → apiKey (string) - fallback if provider-specific key not set
+ * - HAVE_AI_BASE_URL → baseUrl (string)
+ *
+ * User-provided options always take precedence over environment variables.
+ *
+ * Accepts both GetAIOptions (provider-specific options with literal types)
+ * and AIClientOptions (legacy interface with generic string type) for
+ * backward compatibility with existing code.
+ *
+ * @param options - Configuration options for the AI provider. Can be GetAIOptions or AIClientOptions.
+ * @returns Promise resolving to an AI provider instance that implements the AIInterface
+ * @throws {ValidationError} When the provider type is unsupported or invalid
+ *
+ * @example
+ * ```typescript
+ * // Create OpenAI client with explicit options
+ * const openai = await getAI({
+ *   type: 'openai',
+ *   apiKey: process.env.OPENAI_API_KEY!,
+ *   defaultModel: 'gpt-4o'
+ * });
+ *
+ * // Or use environment variables (HAVE_AI_PROVIDER=openai, HAVE_AI_API_KEY=sk-...)
+ * const client = await getAI({});
+ *
+ * // Create Anthropic client
+ * const anthropic = await getAI({
+ *   type: 'anthropic',
+ *   apiKey: process.env.ANTHROPIC_API_KEY!,
+ *   defaultModel: 'claude-3-5-sonnet-20241022'
+ * });
+ *
+ * // Works with AIClientOptions (legacy interface)
+ * const clientOptions: AIClientOptions = { type: 'openai', apiKey: '...' };
+ * const legacy = await getAI(clientOptions);
+ * ```
+ */
+export declare function getAI(options?: GetAIOptions | AIClientOptions): Promise<AIInterface>;
+/**
+ * Browser-compatible auto-detection of AI provider based on available credentials.
+ * Does not rely on process.env, making it suitable for browser environments.
+ *
+ * @param options - Configuration options that may contain provider-specific credentials
+ * @returns Promise resolving to an AI provider instance based on detected credentials
+ * @throws {ValidationError} When no provider can be detected from the provided options
+ *
+ * @example
+ * ```typescript
+ * // Auto-detect OpenAI from apiKey
+ * const client1 = await getAIAuto({
+ *   apiKey: 'sk-...', // Detected as OpenAI
+ *   defaultModel: 'gpt-4o'
+ * });
+ *
+ * // Auto-detect Hugging Face from apiToken
+ * const client2 = await getAIAuto({
+ *   apiToken: 'hf_...', // Detected as Hugging Face
+ *   model: 'microsoft/DialoGPT-medium'
+ * });
+ *
+ * // Auto-detect AWS Bedrock from region and credentials
+ * const client3 = await getAIAuto({
+ *   region: 'us-east-1',
+ *   credentials: {
+ *     accessKeyId: 'AKIA...',
+ *     secretAccessKey: 'xxx'
+ *   }
+ * });
+ * ```
+ */
+export declare function getAIAuto(options: Record<string, any>): Promise<AIInterface>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/shared/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/shared/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,KAAK,EACV,WAAW,EAOX,YAAY,EAMb,MAAM,SAAS,CAAC;AAqHjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAsB,KAAK,CACzB,OAAO,GAAE,YAAY,GAAG,eAAoB,GAC3C,OAAO,CAAC,WAAW,CAAC,CAwEtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,OAAO,CAAC,WAAW,CAAC,CA6CtB"}

package/dist/shared/message.d.ts

@@ -0,0 +1,71 @@
+import { AIThread } from './thread';
+/**
+ * Options for creating AI messages
+ */
+export interface AIMessageOptions {
+    /**
+     * Role of the message sender
+     */
+    role?: 'user' | 'assistant' | 'system';
+    /**
+     * Format for the AI response
+     */
+    responseFormat?: {
+        type: 'text' | 'json_object';
+    };
+}
+/**
+ * Represents a message in an AI conversation
+ */
+export declare class AIMessage {
+    /**
+     * Original options used to create this message
+     */
+    protected options: {
+        role: "user" | "assistant" | "system";
+        content: string;
+        name: string;
+    };
+    /**
+     * Name of the message sender
+     */
+    name: string;
+    /**
+     * Content of the message
+     */
+    content: string;
+    /**
+     * Role of the message sender in the conversation
+     */
+    role: 'user' | 'assistant' | 'system';
+    /**
+     * Creates a new AI message
+     *
+     * @param options - Message configuration
+     * @param options.role - Role of the message sender
+     * @param options.content - Content of the message
+     * @param options.name - Name of the message sender
+     */
+    constructor(options: {
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+        name: string;
+    });
+    /**
+     * Factory method to create a new AI message
+     *
+     * @param options - Message configuration
+     * @param options.thread - Thread this message belongs to
+     * @param options.role - Role of the message sender
+     * @param options.content - Content of the message
+     * @param options.name - Name of the message sender
+     * @returns Promise resolving to a new AIMessage instance
+     */
+    static create(options: {
+        thread: AIThread;
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+        name: string;
+    }): Promise<AIMessage>;
+}
+//# sourceMappingURL=message.d.ts.map

package/dist/shared/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/shared/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IAEvC;;OAEG;IACH,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAAA;KAAE,CAAC;CACnD;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACH,SAAS,CAAC,OAAO;cA0BT,MAAM,GAAG,WAAW,GAAG,QAAQ;iBAC5B,MAAM;cACT,MAAM;MA5BI;IAElB;;OAEG;IACI,IAAI,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACI,OAAO,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACI,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE7C;;;;;;;OAOG;gBACS,OAAO,EAAE;QACnB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd;IAOD;;;;;;;;;OASG;WACU,MAAM,CAAC,OAAO,EAAE;QAC3B,MAAM,EAAE,QAAQ,CAAC;QACjB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QACtC,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd;CAGF"}

package/dist/shared/providers/anthropic.d.ts

@@ -0,0 +1,82 @@
+import { AICapabilities, AIInterface, AIMessage, AIModel, AIResponse, AnthropicOptions, ChatOptions, CompletionOptions, EmbeddingOptions, EmbeddingResponse, ImageDescriptionOptions, ImageEmbeddingOptions, ImageGenerationOptions, ImageGenerationResponse, MessageOptions, TTSOptions, TTSResponse, Voice, VoiceCloneOptions, VoiceDesignOptions, VoiceListOptions } from '../types';
+/**
+ * Anthropic Claude provider implementation that handles all interactions with Anthropic's API.
+ * Supports Claude models, streaming, vision capabilities, and function calling.
+ * Does not support embeddings (use OpenAI or another provider for embeddings).
+ */
+export declare class AnthropicProvider implements AIInterface {
+    private options;
+    private client;
+    /**
+     * Creates a new Anthropic provider instance
+     * @param options - Configuration options for the Anthropic provider
+     */
+    constructor(options: AnthropicOptions);
+    private initializeClientSync;
+    /**
+     * Ensures the Anthropic client is initialized by dynamically importing the SDK
+     * @throws {AIError} When the Anthropic SDK cannot be loaded
+     * @private
+     */
+    private ensureClient;
+    /**
+     * Generate a chat completion using Claude models
+     * @param messages - Array of conversation messages
+     * @param options - Optional configuration for the chat completion
+     * @returns Promise resolving to the AI response with content and metadata
+     * @throws {AIError} When the API request fails or SDK is not available
+     *
+     * @example
+     * ```typescript
+     * const response = await provider.chat([
+     *   { role: 'system', content: 'You are a helpful assistant.' },
+     *   { role: 'user', content: 'Explain quantum computing' }
+     * ], {
+     *   model: 'claude-3-5-sonnet-20241022',
+     *   maxTokens: 1000
+     * });
+     * ```
+     */
+    chat(messages: AIMessage[], options?: ChatOptions): Promise<AIResponse>;
+    complete(prompt: string, options?: CompletionOptions): Promise<AIResponse>;
+    /**
+     * Simple message interface for single-turn interactions with optional history
+     *
+     * @param text - The message text to send
+     * @param options - Configuration options including history, model, etc.
+     * @returns Promise resolving to the response content string
+     *
+     * @example
+     * ```typescript
+     * // Simple usage
+     * const response = await provider.message('Hello!');
+     *
+     * // With history
+     * const response = await provider.message('What was my question?', {
+     *   history: [
+     *     { role: 'user', content: 'What is 2+2?' },
+     *     { role: 'assistant', content: '4' }
+     *   ]
+     * });
+     * ```
+     */
+    message(text: string, options?: MessageOptions): Promise<string>;
+    embed(_text: string | string[], _options?: EmbeddingOptions): Promise<EmbeddingResponse>;
+    embedImage(_image: string | Buffer, _options?: ImageEmbeddingOptions): Promise<EmbeddingResponse>;
+    describeImage(_image: string | Buffer, _prompt?: string, _options?: ImageDescriptionOptions): Promise<string>;
+    generateImage(_prompt: string, _options?: ImageGenerationOptions): Promise<ImageGenerationResponse>;
+    stream(messages: AIMessage[], options?: ChatOptions): AsyncIterable<string>;
+    countTokens(text: string): Promise<number>;
+    getModels(): Promise<AIModel[]>;
+    getCapabilities(): Promise<AICapabilities>;
+    synthesizeSpeech(_text: string, _options?: TTSOptions): Promise<TTSResponse>;
+    streamSpeech(_text: string, _options?: TTSOptions): AsyncIterable<Buffer>;
+    cloneVoice(_options: VoiceCloneOptions): Promise<Voice>;
+    designVoice(_options: VoiceDesignOptions): Promise<Voice>;
+    getVoices(_options?: VoiceListOptions): Promise<Voice[]>;
+    private mapMessagesToAnthropic;
+    private mapToolChoice;
+    private mapFinishReason;
+    private mapError;
+}
+//# sourceMappingURL=anthropic.d.ts.map