@happyvertical/ai 0.74.8

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

@@ -0,0 +1,272 @@
+import { AICapabilities, AIInterface, AIMessage, AIModel, AIResponse, BaseAIOptions, ChatOptions, CompletionOptions, EmbeddingOptions, EmbeddingResponse, ImageDescriptionOptions, ImageEmbeddingOptions, ImageGenerationOptions, ImageGenerationResponse, MessageOptions, TTSOptions, TTSResponse, Voice, VoiceCloneOptions, VoiceDesignOptions, VoiceListOptions } from '../types';
+/**
+ * Shared profile for OpenAI-compatible providers
+ */
+export interface OpenAICompatibleProfile {
+    providerLabel: string;
+    providerName: string;
+    defaultModel: string;
+    capabilities: AICapabilities;
+    describeModel(modelId: string): string;
+    getContextLength(modelId: string): number;
+    getModelCapabilities(modelId: string): string[];
+    shouldIncludeModel(modelId: string): boolean;
+    supportsFunctions(modelId: string): boolean;
+    supportsVision(modelId: string): boolean;
+}
+export interface OpenAICompatibleOptions extends BaseAIOptions {
+    type?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    organization?: string;
+}
+/**
+ * OpenAI provider implementation that handles all interactions with OpenAI's API.
+ * Supports GPT models, embeddings, function calling, streaming, and vision capabilities.
+ */
+export declare class OpenAIProvider implements AIInterface {
+    private client;
+    private options;
+    private readonly profile;
+    /**
+     * Creates a new OpenAI provider instance
+     * @param options - Configuration options for the OpenAI provider
+     */
+    constructor(options: OpenAICompatibleOptions, profile?: OpenAICompatibleProfile);
+    /**
+     * Generate a chat completion using OpenAI's chat 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 returns invalid data
+     *
+     * @example
+     * ```typescript
+     * const response = await provider.chat([
+     *   { role: 'system', content: 'You are a helpful assistant.' },
+     *   { role: 'user', content: 'What is the capital of France?' }
+     * ], {
+     *   model: 'gpt-4o',
+     *   temperature: 0.7,
+     *   maxTokens: 150
+     * });
+     * console.log(response.content); // "Paris is the capital of France."
+     * ```
+     */
+    chat(messages: AIMessage[], options?: ChatOptions): Promise<AIResponse>;
+    /**
+     * Generate a text completion for a given prompt
+     * @param prompt - The text prompt to complete
+     * @param options - Optional configuration for the completion
+     * @returns Promise resolving to the AI response
+     * @throws {AIError} When the API request fails
+     *
+     * @example
+     * ```typescript
+     * const response = await provider.complete('The weather today is', {
+     *   model: 'gpt-4o',
+     *   maxTokens: 50,
+     *   temperature: 0.5
+     * });
+     * ```
+     */
+    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 options
+     * const response = await provider.message('Analyze this', {
+     *   model: 'gpt-4o',
+     *   responseFormat: { type: 'json_object' }
+     * });
+     *
+     * // 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>;
+    /**
+     * Generate embeddings for the given text(s)
+     * @param text - Single text string or array of texts to embed
+     * @param options - Optional configuration for embeddings
+     * @returns Promise resolving to embeddings response with vector arrays
+     * @throws {AIError} When the API request fails
+     *
+     * @example
+     * ```typescript
+     * // Single text embedding
+     * const response1 = await provider.embed('Hello world');
+     * console.log(response1.embeddings[0]); // Array of numbers
+     *
+     * // Multiple text embeddings
+     * const response2 = await provider.embed(['Text 1', 'Text 2']);
+     * console.log(response2.embeddings.length); // 2
+     * ```
+     */
+    embed(text: string | string[], options?: EmbeddingOptions): Promise<EmbeddingResponse>;
+    /**
+     * Convert an image to a base64 data URL
+     * @param image - Image as URL, base64 data URL, or Buffer
+     * @returns base64 data URL string
+     * @private
+     */
+    private imageToBase64;
+    /**
+     * Generate a text description of an image
+     * @param image - Image as URL, base64 data URL, or Buffer
+     * @param prompt - Custom prompt for description (optional)
+     * @param options - Optional configuration
+     * @returns Promise resolving to the description string
+     *
+     * @example
+     * ```typescript
+     * const description = await provider.describeImage('https://example.com/image.jpg');
+     * ```
+     */
+    describeImage(image: string | Buffer, prompt?: string, options?: ImageDescriptionOptions): Promise<string>;
+    /**
+     * Generate embeddings for an image using describe-then-embed pattern
+     * @param image - Image as URL, base64 data URL, or Buffer
+     * @param options - Optional configuration for image embeddings
+     * @returns Promise resolving to embeddings response
+     *
+     * @example
+     * ```typescript
+     * const embedding = await provider.embedImage('https://example.com/image.jpg');
+     * ```
+     */
+    embedImage(image: string | Buffer, options?: ImageEmbeddingOptions): Promise<EmbeddingResponse>;
+    /**
+     * Generate an image from a text prompt using DALL-E
+     * @param prompt - Text description of the image to generate
+     * @param options - Optional configuration for image generation
+     * @returns Promise resolving to generated image(s)
+     *
+     * @example
+     * ```typescript
+     * const result = await provider.generateImage('A sunset over mountains');
+     * fs.writeFileSync('image.png', result.images[0].data);
+     * ```
+     */
+    generateImage(prompt: string, options?: ImageGenerationOptions): Promise<ImageGenerationResponse>;
+    /**
+     * Stream a chat completion response in real-time
+     * @param messages - Array of conversation messages
+     * @param options - Optional configuration for the chat completion
+     * @yields Individual content chunks as they arrive
+     * @throws {AIError} When the streaming request fails
+     *
+     * @example
+     * ```typescript
+     * for await (const chunk of provider.stream([
+     *   { role: 'user', content: 'Write a story about AI' }
+     * ])) {
+     *   process.stdout.write(chunk);
+     * }
+     * ```
+     */
+    stream(messages: AIMessage[], options?: ChatOptions): AsyncIterable<string>;
+    /**
+     * Count the number of tokens in the given text
+     * @param text - The text to count tokens for
+     * @returns Promise resolving to the estimated token count
+     *
+     * @remarks
+     * OpenAI doesn't provide a direct token counting API, so this is an approximation
+     * based on the general rule of ~4 characters per token. For precise counting,
+     * consider using a dedicated tokenizer library.
+     *
+     * @example
+     * ```typescript
+     * const count = await provider.countTokens('Hello, world!');
+     * console.log(count); // Approximately 4 tokens
+     * ```
+     */
+    countTokens(text: string): Promise<number>;
+    /**
+     * Get a list of available OpenAI models
+     * @returns Promise resolving to an array of model information
+     * @throws {AIError} When the API request fails
+     *
+     * @example
+     * ```typescript
+     * const models = await provider.getModels();
+     * const gptModels = models.filter(m => m.id.includes('gpt'));
+     * ```
+     */
+    getModels(): Promise<AIModel[]>;
+    /**
+     * Get the capabilities supported by this OpenAI provider
+     * @returns Promise resolving to provider capabilities
+     *
+     * @example
+     * ```typescript
+     * const caps = await provider.getCapabilities();
+     * if (caps.functions) {
+     *   // Provider supports function calling
+     * }
+     * ```
+     */
+    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[]>;
+    /**
+     * Maps internal AI messages to OpenAI's message format
+     * @param messages - Array of internal AI messages
+     * @returns Array of OpenAI-compatible message parameters
+     * @private
+     */
+    private mapMessagesToOpenAI;
+    /**
+     * Maps internal tool choice format to OpenAI's tool choice format
+     * @param toolChoice - Internal tool choice specification
+     * @returns OpenAI-compatible tool choice option or undefined
+     * @private
+     */
+    private mapToolChoice;
+    /**
+     * Maps OpenAI usage information to internal token usage format
+     * @param usage - OpenAI usage object from API response
+     * @returns Internal token usage object or undefined
+     * @private
+     */
+    private mapUsage;
+    /**
+     * Maps OpenAI finish reason to internal finish reason format
+     * @param reason - OpenAI finish reason from API response
+     * @returns Internal finish reason
+     * @private
+     */
+    private mapFinishReason;
+    /**
+     * Gets the context length for a given OpenAI model
+     * @param modelId - The OpenAI model identifier
+     * @returns Maximum context length in tokens
+     * @private
+     */
+    /**
+     * Maps OpenAI API errors to internal AI error types
+     * @param error - The error object from OpenAI API
+     * @returns Appropriate internal AI error instance
+     * @private
+     */
+    private mapError;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/shared/providers/openai.d.ts.map

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

package/dist/shared/providers/qwen-tts.d.ts

@@ -0,0 +1,85 @@
+import { AICapabilities, AIInterface, AIMessage, AIModel, AIResponse, ChatOptions, CompletionOptions, EmbeddingOptions, EmbeddingResponse, ImageDescriptionOptions, ImageEmbeddingOptions, ImageGenerationOptions, ImageGenerationResponse, MessageOptions, Qwen3TTSOptions, TTSOptions, TTSResponse, Voice, VoiceCloneOptions, VoiceDesignOptions, VoiceListOptions } from '../types';
+/**
+ * Qwen3-TTS provider implementation for text-to-speech synthesis.
+ *
+ * This provider focuses on TTS capabilities and throws NOT_IMPLEMENTED
+ * for text generation methods. Use alongside another provider for full
+ * AI capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { getAI } from '@happyvertical/ai';
+ *
+ * // Create TTS-only provider
+ * const tts = await getAI({
+ *   type: 'qwen3-tts',
+ *   endpoint: 'http://localhost:8880'
+ * });
+ *
+ * // Synthesize speech
+ * const result = await tts.synthesizeSpeech('Hello, world!', {
+ *   voice: 'news-anchor',
+ *   includeWordTimings: true
+ * });
+ *
+ * // Clone a voice
+ * const sample = fs.readFileSync('voice-sample.wav');
+ * const voice = await tts.cloneVoice({
+ *   sampleAudio: sample,
+ *   name: 'My Custom Voice'
+ * });
+ * ```
+ */
+export declare class Qwen3TTSProvider implements AIInterface {
+    private options;
+    private rateLimiter;
+    /**
+     * Creates a new Qwen3-TTS provider instance
+     * @param options - Configuration options for the TTS provider
+     */
+    constructor(options: Qwen3TTSOptions);
+    /**
+     * Get the TTS endpoint URL
+     */
+    private get endpoint();
+    /**
+     * Make an HTTP request to the TTS service
+     */
+    private request;
+    /**
+     * Synthesize speech from text
+     */
+    synthesizeSpeech(text: string, options?: TTSOptions): Promise<TTSResponse>;
+    /**
+     * Stream speech synthesis for real-time playback
+     */
+    streamSpeech(text: string, options?: TTSOptions): AsyncIterable<Buffer>;
+    /**
+     * Clone a voice from an audio sample
+     */
+    cloneVoice(options: VoiceCloneOptions): Promise<Voice>;
+    /**
+     * Design a voice using natural language description
+     */
+    designVoice(options: VoiceDesignOptions): Promise<Voice>;
+    /**
+     * List available voices
+     */
+    getVoices(options?: VoiceListOptions): Promise<Voice[]>;
+    /**
+     * Map API voice response to Voice interface
+     */
+    private mapVoice;
+    chat(_messages: AIMessage[], _options?: ChatOptions): Promise<AIResponse>;
+    complete(_prompt: string, _options?: CompletionOptions): Promise<AIResponse>;
+    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>;
+}
+//# sourceMappingURL=qwen-tts.d.ts.map

package/dist/shared/providers/qwen-tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen-tts.d.ts","sourceRoot":"","sources":["../../../src/shared/providers/qwen-tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,OAAO,EACP,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,UAAU,EACV,WAAW,EACX,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AA4HlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAc;IAEjC;;;OAGG;gBACS,OAAO,EAAE,eAAe;IAUpC;;OAEG;IACH,OAAO,KAAK,QAAQ,GAEnB;IAED;;OAEG;YACW,OAAO;IA0CrB;;OAEG;IACG,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,WAAW,CAAC;IAiCvB;;OAEG;IACI,YAAY,CACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,UAAe,GACvB,aAAa,CAAC,MAAM,CAAC;IA2DxB;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAsB5D;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAe9D;;OAEG;IACG,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAgBjE;;OAEG;IACH,OAAO,CAAC,QAAQ;IAkBV,IAAI,CACR,SAAS,EAAE,SAAS,EAAE,EACtB,QAAQ,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,UAAU,CAAC;IAQhB,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,UAAU,CAAC;IAQhB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlE,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,iBAAiB,CAAC;IAQvB,UAAU,CACd,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAQvB,aAAa,CACjB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,uBAAuB,GACjC,OAAO,CAAC,MAAM,CAAC;IAQZ,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,sBAAsB,GAChC,OAAO,CAAC,uBAAuB,CAAC;IAQ5B,MAAM,CACX,SAAS,EAAE,SAAS,EAAE,EACtB,QAAQ,CAAC,EAAE,WAAW,GACrB,aAAa,CAAC,MAAM,CAAC;IAQlB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ3C,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAuB/B,eAAe,IAAI,OAAO,CAAC,cAAc,CAAC;CAwBjD"}

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

@@ -0,0 +1,14 @@
+import { BaseAIOptions, TokenUsage, UsageEvent } from '../types';
+/**
+ * Emit a usage event to the `onUsage` callback configured on provider options.
+ *
+ * @param providerOptions  - The provider's stored options (for `onUsage` and global `usageTags`).
+ * @param providerName     - Provider identifier (e.g. `'openai'`).
+ * @param operation        - The operation type that generated this usage.
+ * @param model            - Model that was used.
+ * @param usage            - Token usage breakdown, if available.
+ * @param startTime        - `Date.now()` captured before the API call.
+ * @param callTags         - Per-call `usageTags` from the method's options.
+ */
+export declare function emitUsage(providerOptions: BaseAIOptions, providerName: string, operation: UsageEvent['operation'], model: string, usage: TokenUsage | undefined, startTime: number, callTags?: Record<string, string>): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/shared/providers/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/shared/providers/usage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CACvB,eAAe,EAAE,aAAa,EAC9B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,EAClC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,IAAI,CAoBN"}

package/dist/shared/rate-limit.d.ts

@@ -0,0 +1,13 @@
+import { AIClientOptions } from './client';
+import { AIInterface, GetAIOptions, AIError } from './types';
+export declare function parseRetryAfterSeconds(retryAfter: number | string | null | undefined): number | undefined;
+export declare function extractRetryAfterSeconds(error: unknown): number | undefined;
+export declare function createRateLimitedAI<T extends AIInterface>(client: T, options: GetAIOptions | AIClientOptions): T;
+export declare function __resetAIRateLimitStateForTests(): void;
+export declare function __getAIRateLimitStateForTests(): {
+    count: number;
+    maxBudgetCoordinators: number;
+    ttlMs: number;
+};
+export declare function isRetryableAIError(error: unknown): error is AIError;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/shared/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/shared/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAsB,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAkB,MAAM,SAAS,CAAC;AAiQlD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7C,MAAM,GAAG,SAAS,CAyBpB;AAkBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAmC3E;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,WAAW,EACvD,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,YAAY,GAAG,eAAe,GACtC,CAAC,CAwCH;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD;AAED,wBAAgB,6BAA6B,IAAI;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB,EAAE,MAAM,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf,CAMA;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAEnE"}

package/dist/shared/thread.d.ts

@@ -0,0 +1,104 @@
+import { default as OpenAI } from 'openai';
+import { AIClient, AIClientOptions } from './client';
+import { AIMessage } from './message';
+/**
+ * Options for creating an AI conversation thread
+ */
+export interface AIThreadOptions {
+    /**
+     * Options for the AI client to use in this thread
+     */
+    ai: AIClientOptions;
+}
+/**
+ * Represents a conversation thread with an AI model
+ * Manages messages, references, and conversation state
+ */
+export declare class AIThread {
+    /**
+     * AI client instance for this thread
+     */
+    protected ai: AIClient;
+    /**
+     * Options used to configure this thread
+     */
+    protected options: AIThreadOptions;
+    /**
+     * Messages in this conversation thread
+     */
+    private messages;
+    /**
+     * Reference materials to include in the conversation context
+     */
+    private references;
+    /**
+     * Creates a new AI thread
+     *
+     * @param options - Thread configuration options
+     */
+    constructor(options: AIThreadOptions);
+    /**
+     * Factory method to create and initialize a new AI thread
+     *
+     * @param options - Thread configuration options
+     * @returns Promise resolving to an initialized AIThread
+     */
+    static create(options: AIThreadOptions): Promise<AIThread>;
+    /**
+     * Initializes the AI client for this thread
+     */
+    initialize(): Promise<void>;
+    /**
+     * Adds a system message to the conversation
+     *
+     * @param prompt - System message content
+     * @returns Promise resolving to the created AIMessage
+     */
+    addSystem(prompt: string): Promise<AIMessage>;
+    /**
+     * Adds a message to the conversation
+     *
+     * @param options - Message options
+     * @param options.role - Role of the message sender
+     * @param options.name - Optional name of the message sender
+     * @param options.content - Content of the message
+     * @returns Promise resolving to the created AIMessage
+     */
+    add(options: {
+        role: 'user' | 'assistant' | 'system';
+        name?: string;
+        content: string;
+    }): Promise<AIMessage>;
+    /**
+     * Gets all messages in this thread
+     *
+     * @returns Array of AIMessage objects
+     */
+    get(): AIMessage[];
+    /**
+     * Adds a reference to be included in the conversation context
+     *
+     * @param name - Name of the reference
+     * @param body - Content of the reference
+     */
+    addReference(name: string, body: string): void;
+    /**
+     * Assembles the conversation history for sending to the AI
+     * Properly orders system message, references, and conversation messages
+     *
+     * @returns Array of message parameters formatted for the OpenAI API
+     */
+    assembleHistory(): OpenAI.Chat.ChatCompletionMessageParam[];
+    /**
+     * Sends a prompt to the AI and gets a response
+     *
+     * @param prompt - Prompt message to send
+     * @param options - Options for the AI response
+     * @param options.responseFormat - Format for the AI to respond with
+     * @returns Promise resolving to the AI response
+     */
+    do(prompt: string, options?: {
+        responseFormat?: 'html' | 'text' | 'json';
+    }): Promise<string>;
+}
+//# sourceMappingURL=thread.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/shared/thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,eAAe,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,EAAG,QAAQ,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAmB;IAEnC;;OAEG;IACH,OAAO,CAAC,UAAU,CAAkC;IAEpD;;;;OAIG;gBACS,OAAO,EAAE,eAAe;IAIpC;;;;;OAKG;WACU,MAAM,CAAC,OAAO,EAAE,eAAe;IAM5C;;OAEG;IACU,UAAU;IAIvB;;;;;OAKG;IACU,SAAS,CAAC,MAAM,EAAE,MAAM;IAYrC;;;;;;;;OAQG;IACU,GAAG,CAAC,OAAO,EAAE;QACxB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;QACtC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB;IAYD;;;;OAIG;IACI,GAAG,IAAI,SAAS,EAAE;IAIzB;;;;;OAKG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrD;;;;;OAKG;IACI,eAAe,IAAI,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;IA8BlE;;;;;;;OAOG;IACU,EAAE,CACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QACP,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;KAG3C;CAcJ"}