hazo_llm_api 1.0.1 → 1.0.3

package/dist/lib/llm_api/index.d.ts

@@ -12,15 +12,68 @@
  *
  * Database is auto-initialized on module import using config defaults.
  */
-import type { LLMApiConfig, LLMApiClient, LLMResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams } from './types.js';
+import type { LLMApiConfig, LLMApiClient, LLMResponse, LLMStreamResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams, Logger } from './types.js';
+import type { ProviderName } from '../providers/types.js';
+/**
+ * Default console logger used when no custom logger is provided
+ * Can be used directly or as a fallback in functions
+ */
+export declare const default_logger: Logger;
+/**
+ * Get the current logger instance
+ * Returns the stored logger (set during initialization) or default logger
+ *
+ * @returns Current logger instance
+ *
+ * @example
+ * ```typescript
+ * import { get_logger } from 'hazo_llm_api/server';
+ *
+ * const logger = get_logger();
+ * logger.info('My message');
+ * ```
+ */
+export declare function get_logger(): Logger;
+/**
+ * Set the logger instance
+ * Called internally during initialization, but can also be called directly
+ *
+ * @param logger - Logger instance to use
+ */
+export declare function set_logger(logger: Logger): void;
+/**
+ * Get the current hooks configuration
+ *
+ * @returns Current hooks configuration
+ */
+export declare function get_hooks(): import('./types.js').LLMHooks;
+/**
+ * Set the hooks configuration
+ * Called internally during initialization, but can also be called directly
+ *
+ * @param hooks - Hooks configuration to use
+ */
+export declare function set_hooks(hooks: import('./types.js').LLMHooks): void;
 /**
  * Initialize the LLM API with the given configuration
  * Creates/connects to the database and prepares the client for use
  *
- * @param config - Configuration options for the LLM API
+ * @param config - Configuration options for the LLM API (all fields optional)
  * @returns Initialized LLM API client
+ *
+ * @example
+ * ```typescript
+ * // Minimal initialization (uses defaults)
+ * const api = await initialize_llm_api({});
+ *
+ * // With custom logger
+ * const api = await initialize_llm_api({ logger: myLogger });
+ *
+ * // With custom database path
+ * const api = await initialize_llm_api({ sqlite_path: '~/data/prompts.db' });
+ * ```
  */
-export declare function initialize_llm_api(config: LLMApiConfig): Promise<LLMApiClient>;
+export declare function initialize_llm_api(config?: LLMApiConfig): Promise<LLMApiClient>;
 /**
  * Check if database has been initialized (either auto or manual)
  * @returns true if database is ready for use
@@ -36,64 +89,103 @@ export declare function ensure_database_ready(): Promise<boolean>;
  * Standard text generation using LLM
  *
  * @param params - Text input parameters
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with generated text
+ *
+ * @example
+ * ```typescript
+ * import { hazo_llm_text_text, LLM_PROVIDERS } from 'hazo_llm_api/server';
+ *
+ * const response = await hazo_llm_text_text({ prompt: 'Hello' }, LLM_PROVIDERS.GEMINI);
+ * ```
  */
-export declare function hazo_llm_text_text(params: TextTextParams, llm?: string): Promise<LLMResponse>;
+export declare function hazo_llm_text_text(params: TextTextParams, llm?: ProviderName): Promise<LLMResponse>;
 /**
  * Image input → Text output
  * Analyze an image and get text description
  *
  * @param params - Image input parameters
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with text description
  */
-export declare function hazo_llm_image_text(params: ImageTextParams, llm?: string): Promise<LLMResponse>;
+export declare function hazo_llm_image_text(params: ImageTextParams, llm?: ProviderName): Promise<LLMResponse>;
 /**
  * Text input → Image output
  * Generate an image from text description
  *
  * @param params - Text input parameters for image generation
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with generated image
  */
-export declare function hazo_llm_text_image(params: TextImageParams, llm?: string): Promise<LLMResponse>;
+export declare function hazo_llm_text_image(params: TextImageParams, llm?: ProviderName): Promise<LLMResponse>;
 /**
  * Image input → Image output
  * Transform/edit an image based on instructions
  *
  * @param params - Image input parameters with transformation instructions
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with transformed image
  */
-export declare function hazo_llm_image_image(params: ImageImageParams, llm?: string): Promise<LLMResponse>;
+export declare function hazo_llm_image_image(params: ImageImageParams, llm?: ProviderName): Promise<LLMResponse>;
 /**
  * Text → Image → Text (Chained)
  * Generate an image from prompt_image, then analyze it with prompt_text
  *
  * @param params - Parameters with two prompts: one for image gen, one for analysis
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with generated image and analysis text
  */
-export declare function hazo_llm_text_image_text(params: TextImageTextParams, llm?: string): Promise<LLMResponse>;
+export declare function hazo_llm_text_image_text(params: TextImageTextParams, llm?: ProviderName): Promise<LLMResponse>;
 /**
  * Images → Image → Text (Chained)
  * Chain multiple image transformations, then describe the final result
  *
  * @param params - Parameters with images, prompts, and description prompt
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with final image and description text
  */
-export declare function hazo_llm_image_image_text(params: ImageImageTextParams, llm?: string): Promise<LLMResponse>;
+export declare function hazo_llm_image_image_text(params: ImageImageTextParams, llm?: ProviderName): Promise<LLMResponse>;
+/**
+ * Text input → Text output (Streaming)
+ * Generate text from a prompt with streaming response
+ *
+ * @param params - Text input parameters
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns Async generator yielding text chunks
+ *
+ * @example
+ * ```typescript
+ * const stream = await hazo_llm_text_text_stream({ prompt: 'Tell me a story' });
+ *
+ * for await (const chunk of stream) {
+ *   if (chunk.error) {
+ *     console.error(chunk.error);
+ *     break;
+ *   }
+ *   process.stdout.write(chunk.text);
+ *   if (chunk.done) break;
+ * }
+ * ```
+ */
+export declare function hazo_llm_text_text_stream(params: TextTextParams, llm?: ProviderName): LLMStreamResponse;
+/**
+ * Image input → Text output (Streaming)
+ * Analyze an image and stream text description
+ *
+ * @param params - Image input parameters
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns Async generator yielding text chunks
+ */
+export declare function hazo_llm_image_text_stream(params: ImageTextParams, llm?: ProviderName): LLMStreamResponse;
 /**
  * Check if the LLM API has been initialized
  * @returns true if initialized
  */
 export declare function is_initialized(): boolean;
 /**
- * Get the current configuration (without sensitive data)
+ * Get the current configuration (without sensitive logger)
  * @returns Current configuration or null if not initialized
  */
-export declare function get_current_config(): Omit<LLMApiConfig, 'api_key' | 'logger'> | null;
+export declare function get_current_config(): Omit<LLMApiConfig, 'logger'> | null;
 export type { LLMApiConfig, LLMApiClient, LLMResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams, ChainImage, Logger, PromptVariable, PromptVariables, Base64Data, PromptTextMode, PromptRecord, CallLLMParams, GeminiGenerationConfig, GeminiApiGenerationConfig, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/llm_api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/llm_api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAqwBpB;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA8FpF;AAgBD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ9D;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQnG;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQrG;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQrG;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQvG;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQ9G;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQhH;AAMD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG,IAAI,CAUpF;AAMD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,MAAM,EACN,cAAc,EACd,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/llm_api/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/llm_api/index.js

@@ -12,6 +12,7 @@
  *
  * Database is auto-initialized on module import using config defaults.
  */
+import { LLM_ERROR_CODES } from './types.js';
 import { initialize_database, get_database } from '../database/init_database.js';
 import { hazo_llm_text_text as hazo_llm_text_text_internal } from './hazo_llm_text_text.js';
 import { hazo_llm_image_text as hazo_llm_image_text_internal } from './hazo_llm_image_text.js';
@@ -19,7 +20,7 @@ import { hazo_llm_text_image as hazo_llm_text_image_internal } from './hazo_llm_
 import { hazo_llm_image_image as hazo_llm_image_image_internal } from './hazo_llm_image_image.js';
 import { hazo_llm_text_image_text as hazo_llm_text_image_text_internal } from './hazo_llm_text_image_text.js';
 import { hazo_llm_image_image_text as hazo_llm_image_image_text_internal } from './hazo_llm_image_image_text.js';
-import { register_provider, set_enabled_llms, set_primary_llm, get_primary_llm, get_registered_providers, } from '../providers/registry.js';
+import { register_provider, set_enabled_llms, set_primary_llm, get_primary_llm, get_registered_providers, get_provider, } from '../providers/registry.js';
 import { GeminiProvider } from '../providers/gemini/index.js';
 import { QwenProvider } from '../providers/qwen/index.js';
 import { SERVICE_TYPES } from '../providers/types.js';
@@ -33,12 +34,13 @@ let initialized = false;
 let db_auto_initialized = false;
 let current_config = null;
 // =============================================================================
-// Default Logger (for auto-initialization)
+// Default Logger
 // =============================================================================
 /**
- * Default console logger for auto-initialization when no custom logger provided
+ * Default console logger used when no custom logger is provided
+ * Can be used directly or as a fallback in functions
  */
-const default_logger = {
+export const default_logger = {
     error: (message, meta) => {
         console.error(`[HAZO_LLM_API ERROR] ${message}`, meta ? JSON.stringify(meta, null, 2) : '');
     },
@@ -52,6 +54,57 @@ const default_logger = {
         console.debug(`[HAZO_LLM_API DEBUG] ${message}`, meta ? JSON.stringify(meta, null, 2) : '');
     },
 };
+/**
+ * Stored logger instance - set during initialization
+ */
+let stored_logger = default_logger;
+/**
+ * Stored hooks instance - set during initialization
+ */
+let stored_hooks = {};
+/**
+ * Get the current logger instance
+ * Returns the stored logger (set during initialization) or default logger
+ *
+ * @returns Current logger instance
+ *
+ * @example
+ * ```typescript
+ * import { get_logger } from 'hazo_llm_api/server';
+ *
+ * const logger = get_logger();
+ * logger.info('My message');
+ * ```
+ */
+export function get_logger() {
+    return stored_logger;
+}
+/**
+ * Set the logger instance
+ * Called internally during initialization, but can also be called directly
+ *
+ * @param logger - Logger instance to use
+ */
+export function set_logger(logger) {
+    stored_logger = logger;
+}
+/**
+ * Get the current hooks configuration
+ *
+ * @returns Current hooks configuration
+ */
+export function get_hooks() {
+    return stored_hooks;
+}
+/**
+ * Set the hooks configuration
+ * Called internally during initialization, but can also be called directly
+ *
+ * @param hooks - Hooks configuration to use
+ */
+export function set_hooks(hooks) {
+    stored_hooks = hooks;
+}
 // =============================================================================
 // Config Reader
 // =============================================================================
@@ -387,13 +440,14 @@ function load_gemini_provider_from_config(logger) {
         const config_content = fs.readFileSync(config_path, 'utf-8');
         const config = ini.parse(config_content);
         const gemini_section = config.llm_gemini || {};
-        // Load API key from environment
-        const api_key = load_api_key_from_env('gemini');
+        // Support custom env var name via api_key_env config option
+        const env_var_name = gemini_section.api_key_env || 'GEMINI_API_KEY';
+        const api_key = process.env[env_var_name];
         if (!api_key) {
-            logger.error('GEMINI_API_KEY not found in environment variables', {
+            logger.error(`${env_var_name} not found in environment variables`, {
                 file: 'index.ts',
                 line: 352,
-                data: { config_path },
+                data: { config_path, env_var_name },
             });
             return null;
         }
@@ -544,13 +598,14 @@ function load_qwen_provider_from_config(logger) {
         const config_content = fs.readFileSync(config_path, 'utf-8');
         const config = ini.parse(config_content);
         const qwen_section = config.llm_qwen || {};
-        // Load API key from environment
-        const api_key = load_api_key_from_env('qwen');
+        // Support custom env var name via api_key_env config option
+        const env_var_name = qwen_section.api_key_env || 'QWEN_API_KEY';
+        const api_key = process.env[env_var_name];
         if (!api_key) {
-            logger.error('QWEN_API_KEY not found in environment variables', {
+            logger.error(`${env_var_name} not found in environment variables`, {
                 file: 'index.ts',
                 line: 512,
-                data: { config_path },
+                data: { config_path, env_var_name },
             });
             return null;
         }
@@ -697,12 +752,31 @@ void auto_initialize_database();
  * Initialize the LLM API with the given configuration
  * Creates/connects to the database and prepares the client for use
  *
- * @param config - Configuration options for the LLM API
+ * @param config - Configuration options for the LLM API (all fields optional)
  * @returns Initialized LLM API client
+ *
+ * @example
+ * ```typescript
+ * // Minimal initialization (uses defaults)
+ * const api = await initialize_llm_api({});
+ *
+ * // With custom logger
+ * const api = await initialize_llm_api({ logger: myLogger });
+ *
+ * // With custom database path
+ * const api = await initialize_llm_api({ sqlite_path: '~/data/prompts.db' });
+ * ```
  */
-export async function initialize_llm_api(config) {
+export async function initialize_llm_api(config = {}) {
     const file_name = 'index.ts (llm_api)';
-    const logger = config.logger;
+    // Use provided logger or default
+    const logger = config.logger || default_logger;
+    // Store the logger for use by other functions
+    set_logger(logger);
+    // Store hooks if provided
+    if (config.hooks) {
+        set_hooks(config.hooks);
+    }
     // Get global config from file
     const global_config = get_llm_global_config();
     // Use provided sqlite_path or fall back to config file value
@@ -728,15 +802,11 @@ export async function initialize_llm_api(config) {
             primary_llm: primary_llm_name,
         },
     });
-    // Set final config for backward compatibility (simplified)
+    // Set final config
     const final_config = {
-        logger: config.logger,
+        logger,
         sqlite_path,
-        // Legacy fields kept for backward compatibility but not used by providers
-        api_url: config.api_url,
-        api_url_image: config.api_url_image,
-        api_key: config.api_key,
-        llm_model: primary_llm_name, // Use primary_llm as default
+        hooks: config.hooks,
     };
     // Initialize the database (async)
     try {
@@ -791,12 +861,17 @@ export async function initialize_llm_api(config) {
 // =============================================================================
 /**
  * Helper to check full LLM API initialization (required for LLM calls)
+ * Ensures logger is always present in returned config
  */
 function check_initialized() {
     if (!initialized || !current_config) {
         throw new Error('LLM API not initialized. Call initialize_llm_api first.');
     }
-    return current_config;
+    // Ensure logger is always present
+    return {
+        ...current_config,
+        logger: current_config.logger || get_logger(),
+    };
 }
 /**
  * Check if database has been initialized (either auto or manual)
@@ -822,8 +897,15 @@ export async function ensure_database_ready() {
  * Standard text generation using LLM
  *
  * @param params - Text input parameters
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with generated text
+ *
+ * @example
+ * ```typescript
+ * import { hazo_llm_text_text, LLM_PROVIDERS } from 'hazo_llm_api/server';
+ *
+ * const response = await hazo_llm_text_text({ prompt: 'Hello' }, LLM_PROVIDERS.GEMINI);
+ * ```
  */
 export async function hazo_llm_text_text(params, llm) {
     try {
@@ -840,7 +922,7 @@ export async function hazo_llm_text_text(params, llm) {
  * Analyze an image and get text description
  *
  * @param params - Image input parameters
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with text description
  */
 export async function hazo_llm_image_text(params, llm) {
@@ -858,7 +940,7 @@ export async function hazo_llm_image_text(params, llm) {
  * Generate an image from text description
  *
  * @param params - Text input parameters for image generation
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with generated image
  */
 export async function hazo_llm_text_image(params, llm) {
@@ -876,7 +958,7 @@ export async function hazo_llm_text_image(params, llm) {
  * Transform/edit an image based on instructions
  *
  * @param params - Image input parameters with transformation instructions
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with transformed image
  */
 export async function hazo_llm_image_image(params, llm) {
@@ -894,7 +976,7 @@ export async function hazo_llm_image_image(params, llm) {
  * Generate an image from prompt_image, then analyze it with prompt_text
  *
  * @param params - Parameters with two prompts: one for image gen, one for analysis
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with generated image and analysis text
  */
 export async function hazo_llm_text_image_text(params, llm) {
@@ -912,7 +994,7 @@ export async function hazo_llm_text_image_text(params, llm) {
  * Chain multiple image transformations, then describe the final result
  *
  * @param params - Parameters with images, prompts, and description prompt
- * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
  * @returns LLM response with final image and description text
  */
 export async function hazo_llm_image_image_text(params, llm) {
@@ -926,6 +1008,141 @@ export async function hazo_llm_image_image_text(params, llm) {
     }
 }
 // =============================================================================
+// Streaming Functions
+// =============================================================================
+/**
+ * Text input → Text output (Streaming)
+ * Generate text from a prompt with streaming response
+ *
+ * @param params - Text input parameters
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns Async generator yielding text chunks
+ *
+ * @example
+ * ```typescript
+ * const stream = await hazo_llm_text_text_stream({ prompt: 'Tell me a story' });
+ *
+ * for await (const chunk of stream) {
+ *   if (chunk.error) {
+ *     console.error(chunk.error);
+ *     break;
+ *   }
+ *   process.stdout.write(chunk.text);
+ *   if (chunk.done) break;
+ * }
+ * ```
+ */
+export async function* hazo_llm_text_text_stream(params, llm) {
+    try {
+        const config = check_initialized();
+        const logger = config.logger || get_logger();
+        // Get provider
+        const provider = get_provider(llm, logger);
+        if (!provider) {
+            yield {
+                text: '',
+                done: true,
+                error: `Provider "${llm || 'primary'}" not found`,
+                error_info: {
+                    code: LLM_ERROR_CODES.PROVIDER_NOT_FOUND,
+                    message: `Provider "${llm || 'primary'}" not found`,
+                    retryable: false,
+                },
+            };
+            return;
+        }
+        // Check if provider supports streaming
+        if (!provider.text_text_stream) {
+            yield {
+                text: '',
+                done: true,
+                error: `Provider "${provider.get_name()}" does not support streaming`,
+                error_info: {
+                    code: LLM_ERROR_CODES.CAPABILITY_NOT_SUPPORTED,
+                    message: `Provider "${provider.get_name()}" does not support streaming for text_text`,
+                    retryable: false,
+                },
+            };
+            return;
+        }
+        // Call streaming method
+        const stream = await provider.text_text_stream(params, logger);
+        yield* stream;
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : String(error);
+        yield {
+            text: '',
+            done: true,
+            error: error_message,
+            error_info: {
+                code: LLM_ERROR_CODES.UNKNOWN,
+                message: error_message,
+                retryable: false,
+            },
+        };
+    }
+}
+/**
+ * Image input → Text output (Streaming)
+ * Analyze an image and stream text description
+ *
+ * @param params - Image input parameters
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns Async generator yielding text chunks
+ */
+export async function* hazo_llm_image_text_stream(params, llm) {
+    try {
+        const config = check_initialized();
+        const logger = config.logger || get_logger();
+        // Get provider
+        const provider = get_provider(llm, logger);
+        if (!provider) {
+            yield {
+                text: '',
+                done: true,
+                error: `Provider "${llm || 'primary'}" not found`,
+                error_info: {
+                    code: LLM_ERROR_CODES.PROVIDER_NOT_FOUND,
+                    message: `Provider "${llm || 'primary'}" not found`,
+                    retryable: false,
+                },
+            };
+            return;
+        }
+        // Check if provider supports streaming
+        if (!provider.image_text_stream) {
+            yield {
+                text: '',
+                done: true,
+                error: `Provider "${provider.get_name()}" does not support streaming`,
+                error_info: {
+                    code: LLM_ERROR_CODES.CAPABILITY_NOT_SUPPORTED,
+                    message: `Provider "${provider.get_name()}" does not support streaming for image_text`,
+                    retryable: false,
+                },
+            };
+            return;
+        }
+        // Call streaming method
+        const stream = await provider.image_text_stream(params, logger);
+        yield* stream;
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : String(error);
+        yield {
+            text: '',
+            done: true,
+            error: error_message,
+            error_info: {
+                code: LLM_ERROR_CODES.UNKNOWN,
+                message: error_message,
+                retryable: false,
+            },
+        };
+    }
+}
+// =============================================================================
 // Utility Functions
 // =============================================================================
 /**
@@ -936,7 +1153,7 @@ export function is_initialized() {
     return initialized;
 }
 /**
- * Get the current configuration (without sensitive data)
+ * Get the current configuration (without sensitive logger)
  * @returns Current configuration or null if not initialized
  */
 export function get_current_config() {
@@ -944,9 +1161,8 @@ export function get_current_config() {
         return null;
     }
     return {
-        llm_model: current_config.llm_model,
         sqlite_path: current_config.sqlite_path,
-        api_url: current_config.api_url,
+        hooks: current_config.hooks,
     };
 }
 //# sourceMappingURL=index.js.map