hazo_llm_api 1.0.3 → 1.0.5

package/dist/lib/llm_api/hazo_llm_prompt_chain.js

@@ -0,0 +1,368 @@
+/**
+ * hazo_llm_prompt_chain Function
+ *
+ * Executes a sequence of LLM calls where each call can reference
+ * values from previous call results. Supports all 4 service types:
+ * text_text, image_text, text_image, image_image.
+ */
+import { hazo_llm_text_text } from './hazo_llm_text_text.js';
+import { hazo_llm_image_text } from './hazo_llm_image_text.js';
+import { hazo_llm_text_image } from './hazo_llm_text_image.js';
+import { hazo_llm_image_image } from './hazo_llm_image_image.js';
+import { resolve_chain_field, build_prompt_variables, merge_chain_results, parse_llm_json_response, resolve_chain_image_definition, } from './chain_helpers.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const FILE_NAME = 'hazo_llm_prompt_chain.ts';
+const API_NAME = 'prompt_chain';
+// Default call type for backward compatibility
+const DEFAULT_CALL_TYPE = 'text_text';
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Build service-specific parameters based on call type
+ *
+ * @param call_def - The chain call definition
+ * @param call_type - The service type to build params for
+ * @param prompt_variables - Resolved prompt variables
+ * @param previous_results - Array of previous call results
+ * @param logger - Logger instance
+ * @returns Build result with params or error
+ */
+function build_service_params(call_def, call_type, prompt_variables, previous_results, logger) {
+    // Base params common to all types
+    const base_params = {
+        prompt: '', // Will be overridden by dynamic prompt
+        prompt_variables,
+    };
+    switch (call_type) {
+        case 'text_text':
+            return { success: true, params: base_params };
+        case 'text_image':
+            return { success: true, params: base_params };
+        case 'image_text': {
+            // Resolve image_b64 and image_mime_type
+            if (!call_def.image_b64 || !call_def.image_mime_type) {
+                return {
+                    success: false,
+                    error: 'image_text requires image_b64 and image_mime_type fields',
+                };
+            }
+            const image_b64 = resolve_chain_field(call_def.image_b64, previous_results, logger);
+            const image_mime_type = resolve_chain_field(call_def.image_mime_type, previous_results, logger);
+            if (!image_b64) {
+                return {
+                    success: false,
+                    error: 'Could not resolve image_b64 for image_text call',
+                };
+            }
+            if (!image_mime_type) {
+                return {
+                    success: false,
+                    error: 'Could not resolve image_mime_type for image_text call',
+                };
+            }
+            logger.debug('Resolved image for image_text', {
+                file: FILE_NAME,
+                data: {
+                    image_b64_length: image_b64.length,
+                    image_mime_type,
+                },
+            });
+            return {
+                success: true,
+                params: {
+                    ...base_params,
+                    image_b64,
+                    image_mime_type,
+                },
+            };
+        }
+        case 'image_image': {
+            const images = [];
+            // Multi-image mode - prefer images array if provided
+            if (call_def.images && call_def.images.length > 0) {
+                for (const img_def of call_def.images) {
+                    const resolved = resolve_chain_image_definition(img_def, previous_results, logger);
+                    if (resolved) {
+                        images.push({
+                            data: resolved.image_b64,
+                            mime_type: resolved.image_mime_type,
+                        });
+                    }
+                    else {
+                        logger.warn('Failed to resolve image in images array', {
+                            file: FILE_NAME,
+                        });
+                    }
+                }
+            }
+            // Single image mode
+            else if (call_def.image_b64 && call_def.image_mime_type) {
+                const image_b64 = resolve_chain_field(call_def.image_b64, previous_results, logger);
+                const image_mime_type = resolve_chain_field(call_def.image_mime_type, previous_results, logger);
+                if (image_b64 && image_mime_type) {
+                    images.push({
+                        data: image_b64,
+                        mime_type: image_mime_type,
+                    });
+                }
+            }
+            if (images.length === 0) {
+                return {
+                    success: false,
+                    error: 'image_image requires at least one image (via image_b64/image_mime_type or images array)',
+                };
+            }
+            logger.debug('Resolved images for image_image', {
+                file: FILE_NAME,
+                data: { image_count: images.length },
+            });
+            return {
+                success: true,
+                params: {
+                    ...base_params,
+                    images,
+                },
+            };
+        }
+        default:
+            return {
+                success: false,
+                error: `Unknown call_type: ${call_type}`,
+            };
+    }
+}
+/**
+ * Dispatch to the appropriate service function based on call type
+ *
+ * @param call_type - The service type to invoke
+ * @param params - Service-specific parameters
+ * @param prompt_area - Prompt area for dynamic prompt lookup
+ * @param prompt_key - Prompt key for dynamic prompt lookup
+ * @param db - Database instance
+ * @param config - LLM API configuration
+ * @param llm - Optional LLM provider name
+ * @returns LLM response
+ */
+async function dispatch_service_call(call_type, params, prompt_area, prompt_key, db, config, llm) {
+    // Add prompt_area and prompt_key for dynamic prompt lookup
+    const params_with_prompt = {
+        ...params,
+        prompt_area,
+        prompt_key,
+    };
+    switch (call_type) {
+        case 'text_text':
+            return await hazo_llm_text_text(params_with_prompt, db, config, llm);
+        case 'image_text':
+            return await hazo_llm_image_text(params_with_prompt, db, config, llm);
+        case 'text_image':
+            return await hazo_llm_text_image(params_with_prompt, db, config, llm);
+        case 'image_image':
+            return await hazo_llm_image_image(params_with_prompt, db, config, llm);
+        default:
+            throw new Error(`Unsupported call_type: ${call_type}`);
+    }
+}
+/**
+ * Check if a call type produces text output
+ */
+function is_text_output_type(call_type) {
+    return call_type === 'text_text' || call_type === 'image_text';
+}
+/**
+ * Check if a call type produces image output
+ */
+function is_image_output_type(call_type) {
+    return call_type === 'text_image' || call_type === 'image_image';
+}
+// =============================================================================
+// hazo_llm_prompt_chain Function
+// =============================================================================
+/**
+ * Execute a chain of prompt calls with dynamic value resolution
+ *
+ * @param params - Chain parameters including call definitions
+ * @param db - Database instance for prompt retrieval
+ * @param config - LLM API configuration
+ * @param llm - Optional LLM provider name
+ * @returns Chain response with merged results and individual call outcomes
+ */
+export async function hazo_llm_prompt_chain(params, db, config, llm) {
+    // Use default logger if not provided
+    const { default_logger } = await import('./index.js');
+    const logger = config.logger || default_logger;
+    const continue_on_error = params.continue_on_error ?? true;
+    const call_results = [];
+    const errors = [];
+    logger.debug(`########################################################################### ${API_NAME}`, {
+        file: FILE_NAME,
+    });
+    logger.info('Starting prompt chain execution', {
+        file: FILE_NAME,
+        data: {
+            total_calls: params.chain_calls.length,
+            continue_on_error,
+        },
+    });
+    // Execute each call in sequence
+    for (let i = 0; i < params.chain_calls.length; i++) {
+        const call_def = params.chain_calls[i];
+        logger.debug(`Chain Step ${i + 1}/${params.chain_calls.length}`, {
+            file: FILE_NAME,
+        });
+        // Resolve prompt_area and prompt_key
+        const prompt_area = resolve_chain_field(call_def.prompt_area, call_results, logger);
+        const prompt_key = resolve_chain_field(call_def.prompt_key, call_results, logger);
+        if (!prompt_area || !prompt_key) {
+            const error_msg = `Could not resolve prompt_area or prompt_key for call ${i}`;
+            logger.error(error_msg, {
+                file: FILE_NAME,
+                data: { call_index: i, prompt_area, prompt_key },
+            });
+            errors.push({ call_index: i, error: error_msg });
+            call_results.push({
+                call_index: i,
+                success: false,
+                error: error_msg,
+                prompt_area: prompt_area || 'unresolved',
+                prompt_key: prompt_key || 'unresolved',
+            });
+            if (!continue_on_error) {
+                break;
+            }
+            continue;
+        }
+        // Get call type (default to text_text for backward compatibility)
+        const call_type = call_def.call_type || DEFAULT_CALL_TYPE;
+        // Build prompt variables from variables array
+        const prompt_variables = build_prompt_variables(call_def.variables, call_results, logger);
+        // Build service-specific parameters
+        const param_result = build_service_params(call_def, call_type, prompt_variables, call_results, logger);
+        if (!param_result.success) {
+            const error_msg = param_result.error || 'Failed to build parameters';
+            logger.error(error_msg, {
+                file: FILE_NAME,
+                data: { call_index: i, call_type },
+            });
+            errors.push({ call_index: i, error: error_msg });
+            call_results.push({
+                call_index: i,
+                success: false,
+                error: error_msg,
+                prompt_area,
+                prompt_key,
+            });
+            if (!continue_on_error) {
+                break;
+            }
+            continue;
+        }
+        logger.info(`Executing ${call_type} call`, {
+            file: FILE_NAME,
+            data: {
+                call_index: i,
+                call_type,
+                prompt_area,
+                prompt_key,
+                variables_defined: call_def.variables?.length || 0,
+                variables_resolved: prompt_variables.length > 0 ? prompt_variables[0] : {},
+            },
+        });
+        // Execute the LLM call
+        try {
+            const response = await dispatch_service_call(call_type, param_result.params, prompt_area, prompt_key, db, config, llm);
+            if (!response.success) {
+                const error_msg = response.error || 'Unknown error';
+                logger.error(`Call ${i} failed`, {
+                    file: FILE_NAME,
+                    data: { call_index: i, call_type, error: error_msg },
+                });
+                errors.push({ call_index: i, error: error_msg });
+                call_results.push({
+                    call_index: i,
+                    success: false,
+                    error: error_msg,
+                    prompt_area,
+                    prompt_key,
+                });
+                if (!continue_on_error) {
+                    break;
+                }
+                continue;
+            }
+            // Build result based on call type
+            const result = {
+                call_index: i,
+                success: true,
+                prompt_area,
+                prompt_key,
+            };
+            // Text output types (text_text, image_text)
+            if (is_text_output_type(call_type)) {
+                result.raw_text = response.text || '';
+                result.parsed_result = parse_llm_json_response(result.raw_text, logger) || undefined;
+            }
+            // Image output types (text_image, image_image)
+            if (is_image_output_type(call_type)) {
+                result.image_b64 = response.image_b64;
+                result.image_mime_type = response.image_mime_type;
+            }
+            call_results.push(result);
+            logger.info(`Call ${i} completed successfully`, {
+                file: FILE_NAME,
+                data: {
+                    call_index: i,
+                    call_type,
+                    has_text: !!result.raw_text,
+                    has_parsed_result: !!result.parsed_result,
+                    has_image: !!result.image_b64,
+                },
+            });
+        }
+        catch (error) {
+            const error_msg = error instanceof Error ? error.message : String(error);
+            logger.error(`Call ${i} threw exception`, {
+                file: FILE_NAME,
+                data: { call_index: i, call_type, error: error_msg },
+            });
+            errors.push({ call_index: i, error: error_msg });
+            call_results.push({
+                call_index: i,
+                success: false,
+                error: error_msg,
+                prompt_area,
+                prompt_key,
+            });
+            if (!continue_on_error) {
+                break;
+            }
+        }
+    }
+    // Merge all successful results
+    const merged_result = merge_chain_results(call_results, logger);
+    const successful_calls = call_results.filter((r) => r.success).length;
+    logger.info('Prompt chain execution complete', {
+        file: FILE_NAME,
+        data: {
+            total_calls: params.chain_calls.length,
+            successful_calls,
+            error_count: errors.length,
+        },
+    });
+    logger.debug(`<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ${API_NAME} >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>`, {
+        file: FILE_NAME,
+        data: { success: successful_calls > 0 },
+    });
+    return {
+        success: successful_calls > 0,
+        merged_result,
+        call_results,
+        errors,
+        total_calls: params.chain_calls.length,
+        successful_calls,
+    };
+}
+//# sourceMappingURL=hazo_llm_prompt_chain.js.map

package/dist/lib/llm_api/hazo_llm_prompt_chain.js.map

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

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

@@ -12,7 +12,7 @@
  *
  * Database is auto-initialized on module import using config defaults.
  */
-import type { LLMApiConfig, LLMApiClient, LLMResponse, LLMStreamResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams, Logger } from './types.js';
+import type { LLMApiConfig, LLMApiClient, LLMResponse, LLMStreamResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams, PromptChainParams, PromptChainResponse, Logger } from './types.js';
 import type { ProviderName } from '../providers/types.js';
 /**
  * Default console logger used when no custom logger is provided
@@ -145,6 +145,38 @@ export declare function hazo_llm_text_image_text(params: TextImageTextParams, ll
  * @returns LLM response with final image and description text
  */
 export declare function hazo_llm_image_image_text(params: ImageImageTextParams, llm?: ProviderName): Promise<LLMResponse>;
+/**
+ * Execute a chain of prompts with dynamic value resolution
+ * Each call can reference values from previous call results
+ *
+ * @param params - Chain parameters including call definitions
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
+ * @returns Chain response with merged results and individual call outcomes
+ *
+ * @example
+ * ```typescript
+ * import { hazo_llm_prompt_chain } from 'hazo_llm_api/server';
+ *
+ * const response = await hazo_llm_prompt_chain({
+ *   chain_calls: [
+ *     {
+ *       prompt_area: { match_type: 'direct', value: 'document' },
+ *       prompt_key: { match_type: 'direct', value: 'initial_read' }
+ *     },
+ *     {
+ *       prompt_area: { match_type: 'direct', value: 'document' },
+ *       prompt_key: { match_type: 'direct', value: 'process_results' },
+ *       local_1: {
+ *         match_type: 'call_chain',
+ *         value: 'call[0].tax_category',
+ *         variable_name: 'previous_category'
+ *       }
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+export declare function hazo_llm_prompt_chain(params: PromptChainParams, llm?: ProviderName): Promise<PromptChainResponse>;
 /**
  * Text input → Text output (Streaming)
  * Generate text from a prompt with streaming response
@@ -187,5 +219,5 @@ export declare function is_initialized(): boolean;
  * @returns Current configuration or null if not initialized
  */
 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';
+export type { LLMApiConfig, LLMApiClient, LLMResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams, ChainImage, Logger, PromptVariable, PromptVariables, Base64Data, PromptTextMode, PromptRecord, CallLLMParams, GeminiGenerationConfig, GeminiApiGenerationConfig, ChainMatchType, ChainFieldDefinition, ChainCallDefinition, ChainCallResult, PromptChainParams, PromptChainResponse, } 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":"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"}
+{"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

@@ -20,6 +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 { hazo_llm_prompt_chain as hazo_llm_prompt_chain_internal } from './hazo_llm_prompt_chain.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';
@@ -110,16 +111,16 @@ export function set_hooks(hooks) {
 // =============================================================================
 /**
  * Find the config file path
- * Searches in current directory and parent directories
+ * Searches in config/ subdirectory and parent directories
  * @returns The path to the config file or null if not found
  */
 function find_config_file() {
     const config_filename = 'hazo_llm_api_config.ini';
-    // Search paths: current dir, parent dir, grandparent dir
+    // Search paths: config/ in current dir, parent dir, grandparent dir
     const search_paths = [
-        path.join(process.cwd(), config_filename),
-        path.join(process.cwd(), '..', config_filename),
-        path.join(process.cwd(), '..', '..', config_filename),
+        path.join(process.cwd(), 'config', config_filename),
+        path.join(process.cwd(), '..', 'config', config_filename),
+        path.join(process.cwd(), '..', '..', 'config', config_filename),
     ];
     for (const config_path of search_paths) {
         try {
@@ -853,6 +854,9 @@ export async function initialize_llm_api(config = {}) {
         hazo_llm_image_image_text: async (params, llm) => {
             return hazo_llm_image_image_text(params, llm);
         },
+        hazo_llm_prompt_chain: async (params, llm) => {
+            return hazo_llm_prompt_chain(params, llm);
+        },
     };
     return client;
 }
@@ -1007,6 +1011,54 @@ export async function hazo_llm_image_image_text(params, llm) {
         return { success: false, error: error instanceof Error ? error.message : String(error) };
     }
 }
+/**
+ * Execute a chain of prompts with dynamic value resolution
+ * Each call can reference values from previous call results
+ *
+ * @param params - Chain parameters including call definitions
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified). Use LLM_PROVIDERS constants for type safety.
+ * @returns Chain response with merged results and individual call outcomes
+ *
+ * @example
+ * ```typescript
+ * import { hazo_llm_prompt_chain } from 'hazo_llm_api/server';
+ *
+ * const response = await hazo_llm_prompt_chain({
+ *   chain_calls: [
+ *     {
+ *       prompt_area: { match_type: 'direct', value: 'document' },
+ *       prompt_key: { match_type: 'direct', value: 'initial_read' }
+ *     },
+ *     {
+ *       prompt_area: { match_type: 'direct', value: 'document' },
+ *       prompt_key: { match_type: 'direct', value: 'process_results' },
+ *       local_1: {
+ *         match_type: 'call_chain',
+ *         value: 'call[0].tax_category',
+ *         variable_name: 'previous_category'
+ *       }
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+export async function hazo_llm_prompt_chain(params, llm) {
+    try {
+        const config = check_initialized();
+        const db = get_database();
+        return hazo_llm_prompt_chain_internal(params, db, config, llm);
+    }
+    catch (error) {
+        return {
+            success: false,
+            merged_result: {},
+            call_results: [],
+            errors: [{ call_index: -1, error: error instanceof Error ? error.message : String(error) }],
+            total_calls: params.chain_calls.length,
+            successful_calls: 0,
+        };
+    }
+}
 // =============================================================================
 // Streaming Functions
 // =============================================================================