hazo_llm_api 1.0.4 → 1.0.5

package/dist/lib/llm_api/chain_helpers.js

@@ -0,0 +1,445 @@
+/**
+ * Chain Helper Functions
+ *
+ * Utility functions for parsing call_chain paths, resolving values,
+ * and deep merging results in prompt chains.
+ */
+const FILE_NAME = 'chain_helpers.ts';
+// =============================================================================
+// Path Parsing Functions
+// =============================================================================
+/**
+ * Parse a call_chain path expression like "call[0].tax_category" or "call[2].data.nested.value"
+ *
+ * @param path_expr - The path expression to parse
+ * @param logger - Logger instance
+ * @returns Parsed path with call index and property path array, or null if invalid
+ */
+export function parse_call_chain_path(path_expr, logger) {
+    // Pattern: call[N].property.path
+    const match = path_expr.match(/^call\[(\d+)\]\.(.+)$/);
+    if (!match) {
+        logger.error('Invalid call_chain path format', {
+            file: FILE_NAME,
+            data: { path_expr, expected_format: 'call[N].property.path' },
+        });
+        return null;
+    }
+    const call_index = parseInt(match[1], 10);
+    const property_path = match[2].split('.');
+    logger.debug('Parsed call_chain path', {
+        file: FILE_NAME,
+        data: { path_expr, call_index, property_path },
+    });
+    return { call_index, property_path };
+}
+/**
+ * Extract a value from a nested object using a property path array
+ *
+ * @param obj - The object to extract from
+ * @param path - Array of property names to traverse
+ * @param logger - Logger instance
+ * @returns The extracted value as a string, or null if not found
+ */
+export function extract_value_from_path(obj, path, logger) {
+    let current = obj;
+    for (const key of path) {
+        if (current === null || current === undefined) {
+            logger.warn('Path traversal encountered null/undefined', {
+                file: FILE_NAME,
+                data: { path, failed_at: key },
+            });
+            return null;
+        }
+        if (typeof current !== 'object') {
+            logger.warn('Path traversal encountered non-object', {
+                file: FILE_NAME,
+                data: { path, failed_at: key, type: typeof current },
+            });
+            return null;
+        }
+        current = current[key];
+    }
+    // Convert result to string
+    if (current === null || current === undefined) {
+        return null;
+    }
+    if (typeof current === 'string') {
+        return current;
+    }
+    if (typeof current === 'number' || typeof current === 'boolean') {
+        return String(current);
+    }
+    // For objects/arrays, return JSON string
+    return JSON.stringify(current);
+}
+/**
+ * Extract a value from a ChainCallResult using a property path
+ * Supports both parsed_result fields and top-level image/text fields
+ *
+ * Examples:
+ * - "image_b64" -> returns result.image_b64
+ * - "image_mime_type" -> returns result.image_mime_type
+ * - "raw_text" -> returns result.raw_text
+ * - "country" -> traverses result.parsed_result.country
+ * - "data.nested.value" -> traverses result.parsed_result.data.nested.value
+ *
+ * @param result - The ChainCallResult to extract from
+ * @param property_path - Array of property names to traverse
+ * @param logger - Logger instance
+ * @returns The extracted value as a string, or null if not found
+ */
+export function extract_value_from_result(result, property_path, logger) {
+    if (property_path.length === 0) {
+        logger.warn('Empty property path provided', { file: FILE_NAME });
+        return null;
+    }
+    const first_key = property_path[0];
+    // Handle top-level image fields directly
+    if (property_path.length === 1) {
+        if (first_key === 'image_b64' && result.image_b64) {
+            return result.image_b64;
+        }
+        if (first_key === 'image_mime_type' && result.image_mime_type) {
+            return result.image_mime_type;
+        }
+        if (first_key === 'raw_text' && result.raw_text) {
+            return result.raw_text;
+        }
+    }
+    // For paths starting with top-level fields that don't exist, try parsed_result
+    if (first_key === 'image_b64' || first_key === 'image_mime_type' || first_key === 'raw_text') {
+        // These are top-level only, no nesting
+        if (property_path.length === 1) {
+            logger.warn('Top-level field not found in result', {
+                file: FILE_NAME,
+                data: { field: first_key, has_field: false },
+            });
+            return null;
+        }
+    }
+    // Otherwise, extract from parsed_result
+    if (!result.parsed_result) {
+        logger.warn('No parsed_result available for path extraction', {
+            file: FILE_NAME,
+            data: { property_path },
+        });
+        return null;
+    }
+    return extract_value_from_path(result.parsed_result, property_path, logger);
+}
+// =============================================================================
+// Value Resolution Functions
+// =============================================================================
+/**
+ * Resolve a chain field definition to its actual value
+ * Supports both parsed_result fields and top-level image/text fields
+ *
+ * @param field - The field definition to resolve
+ * @param previous_results - Array of previous call results
+ * @param logger - Logger instance
+ * @returns Resolved string value, or null if resolution failed
+ */
+export function resolve_chain_field(field, previous_results, logger) {
+    if (field.match_type === 'direct') {
+        return field.value;
+    }
+    // match_type === 'call_chain'
+    const parsed = parse_call_chain_path(field.value, logger);
+    if (!parsed) {
+        return null;
+    }
+    // Check if referenced call exists
+    if (parsed.call_index >= previous_results.length) {
+        logger.error('call_chain references future or non-existent call', {
+            file: FILE_NAME,
+            data: {
+                call_index: parsed.call_index,
+                available_calls: previous_results.length,
+            },
+        });
+        return null;
+    }
+    const referenced_result = previous_results[parsed.call_index];
+    // Check if referenced call was successful
+    if (!referenced_result.success) {
+        logger.warn('call_chain references failed call', {
+            file: FILE_NAME,
+            data: {
+                call_index: parsed.call_index,
+                success: referenced_result.success,
+            },
+        });
+        return null;
+    }
+    // Extract value from result (supports both image fields and parsed_result)
+    const value = extract_value_from_result(referenced_result, parsed.property_path, logger);
+    if (value === null) {
+        logger.warn('Could not extract value from call_chain path', {
+            file: FILE_NAME,
+            data: {
+                path: field.value,
+                call_index: parsed.call_index,
+            },
+        });
+    }
+    return value;
+}
+// =============================================================================
+// Variable Building Functions
+// =============================================================================
+/**
+ * Resolve a chain variable definition to its actual value
+ * Supports both parsed_result fields and top-level image/text fields
+ *
+ * @param variable - The variable definition to resolve
+ * @param previous_results - Array of previous call results
+ * @param logger - Logger instance
+ * @returns Resolved string value, or null if resolution failed
+ */
+export function resolve_chain_variable(variable, previous_results, logger) {
+    if (variable.match_type === 'direct') {
+        return variable.value;
+    }
+    // match_type === 'call_chain'
+    const parsed = parse_call_chain_path(variable.value, logger);
+    if (!parsed) {
+        return null;
+    }
+    // Check if referenced call exists
+    if (parsed.call_index >= previous_results.length) {
+        logger.error('call_chain references future or non-existent call', {
+            file: FILE_NAME,
+            data: {
+                call_index: parsed.call_index,
+                available_calls: previous_results.length,
+                variable_name: variable.variable_name,
+            },
+        });
+        return null;
+    }
+    const referenced_result = previous_results[parsed.call_index];
+    // Check if referenced call was successful
+    if (!referenced_result.success) {
+        logger.warn('call_chain references failed call', {
+            file: FILE_NAME,
+            data: {
+                call_index: parsed.call_index,
+                success: referenced_result.success,
+                variable_name: variable.variable_name,
+            },
+        });
+        return null;
+    }
+    // Extract value from result (supports both image fields and parsed_result)
+    const value = extract_value_from_result(referenced_result, parsed.property_path, logger);
+    if (value === null) {
+        logger.warn('Could not extract value from call_chain path', {
+            file: FILE_NAME,
+            data: {
+                path: variable.value,
+                call_index: parsed.call_index,
+                variable_name: variable.variable_name,
+            },
+        });
+    }
+    return value;
+}
+/**
+ * Build prompt variables from a variables array in a chain call definition
+ *
+ * @param variables_array - Array of variable definitions
+ * @param previous_results - Array of previous call results
+ * @param logger - Logger instance
+ * @returns PromptVariables array for substitution
+ */
+export function build_prompt_variables(variables_array, previous_results, logger) {
+    if (!variables_array || variables_array.length === 0) {
+        return [];
+    }
+    const variables = {};
+    variables_array.forEach((variable, index) => {
+        if (!variable.variable_name) {
+            logger.warn('Variable definition missing variable_name', {
+                file: FILE_NAME,
+                data: { index },
+            });
+            return;
+        }
+        const resolved_value = resolve_chain_variable(variable, previous_results, logger);
+        if (resolved_value !== null) {
+            variables[variable.variable_name] = resolved_value;
+            logger.debug('Built variable from definition', {
+                file: FILE_NAME,
+                data: {
+                    index,
+                    variable_name: variable.variable_name,
+                    match_type: variable.match_type,
+                    value_preview: resolved_value.substring(0, 50),
+                },
+            });
+        }
+        else {
+            logger.warn('Could not resolve variable value', {
+                file: FILE_NAME,
+                data: {
+                    index,
+                    variable_name: variable.variable_name,
+                    match_type: variable.match_type,
+                    value: variable.value,
+                },
+            });
+        }
+    });
+    return Object.keys(variables).length > 0 ? [variables] : [];
+}
+/**
+ * Resolve a ChainImageDefinition to actual image data
+ *
+ * @param image_def - The image definition to resolve
+ * @param previous_results - Array of previous call results
+ * @param logger - Logger instance
+ * @returns Resolved image data or null if resolution failed
+ */
+export function resolve_chain_image_definition(image_def, previous_results, logger) {
+    const image_b64 = resolve_chain_field(image_def.image_b64, previous_results, logger);
+    const image_mime_type = resolve_chain_field(image_def.image_mime_type, previous_results, logger);
+    if (!image_b64) {
+        logger.error('Could not resolve image_b64 from definition', {
+            file: FILE_NAME,
+            data: {
+                match_type: image_def.image_b64.match_type,
+                value: image_def.image_b64.value,
+            },
+        });
+        return null;
+    }
+    if (!image_mime_type) {
+        logger.error('Could not resolve image_mime_type from definition', {
+            file: FILE_NAME,
+            data: {
+                match_type: image_def.image_mime_type.match_type,
+                value: image_def.image_mime_type.value,
+            },
+        });
+        return null;
+    }
+    logger.debug('Resolved image definition', {
+        file: FILE_NAME,
+        data: {
+            image_b64_length: image_b64.length,
+            image_mime_type,
+        },
+    });
+    return { image_b64, image_mime_type };
+}
+// =============================================================================
+// Deep Merge Functions
+// =============================================================================
+/**
+ * Deep merge two objects, with source values overwriting target values
+ *
+ * @param target - Target object
+ * @param source - Source object to merge in
+ * @returns New merged object
+ */
+export function deep_merge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const source_value = source[key];
+        const target_value = result[key];
+        if (source_value !== null &&
+            typeof source_value === 'object' &&
+            !Array.isArray(source_value) &&
+            target_value !== null &&
+            typeof target_value === 'object' &&
+            !Array.isArray(target_value)) {
+            // Both are objects - recurse
+            result[key] = deep_merge(target_value, source_value);
+        }
+        else {
+            // Overwrite with source value
+            result[key] = source_value;
+        }
+    }
+    return result;
+}
+/**
+ * Merge multiple call results into a single object
+ *
+ * @param results - Array of chain call results
+ * @param logger - Logger instance
+ * @returns Deep-merged object from all successful calls
+ */
+export function merge_chain_results(results, logger) {
+    let merged = {};
+    for (const result of results) {
+        if (result.success && result.parsed_result) {
+            merged = deep_merge(merged, result.parsed_result);
+            logger.debug('Merged result from call', {
+                file: FILE_NAME,
+                data: { call_index: result.call_index },
+            });
+        }
+    }
+    return merged;
+}
+// =============================================================================
+// JSON Parsing Functions
+// =============================================================================
+/**
+ * Attempt to parse LLM response text as JSON
+ * Handles common LLM output formats (with markdown code blocks, etc.)
+ *
+ * @param text - Raw text response from LLM
+ * @param logger - Logger instance
+ * @returns Parsed JSON object or null if parsing fails
+ */
+export function parse_llm_json_response(text, logger) {
+    // Try direct JSON parse first
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed === 'object' && parsed !== null) {
+            return parsed;
+        }
+    }
+    catch {
+        // Continue to try other formats
+    }
+    // Try extracting JSON from markdown code block
+    const code_block_match = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (code_block_match) {
+        try {
+            const parsed = JSON.parse(code_block_match[1].trim());
+            if (typeof parsed === 'object' && parsed !== null) {
+                logger.debug('Extracted JSON from code block', { file: FILE_NAME });
+                return parsed;
+            }
+        }
+        catch {
+            // Continue
+        }
+    }
+    // Try finding first { to last }
+    const first_brace = text.indexOf('{');
+    const last_brace = text.lastIndexOf('}');
+    if (first_brace !== -1 && last_brace > first_brace) {
+        try {
+            const json_substr = text.substring(first_brace, last_brace + 1);
+            const parsed = JSON.parse(json_substr);
+            if (typeof parsed === 'object' && parsed !== null) {
+                logger.debug('Extracted JSON by brace matching', { file: FILE_NAME });
+                return parsed;
+            }
+        }
+        catch {
+            // Continue
+        }
+    }
+    logger.warn('Could not parse LLM response as JSON', {
+        file: FILE_NAME,
+        data: { text_preview: text.substring(0, 100) },
+    });
+    return null;
+}
+//# sourceMappingURL=chain_helpers.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * hazo_llm_image_image Function
+ *
+ * Image(s) input → Image output
+ * Transform/edit/combine images based on text instructions.
+ * Supports single or multiple input images.
+ * Uses image generation capable models with input image(s).
+ */
+import type { Database as SqlJsDatabase } from 'sql.js';
+import type { ImageImageParams, LLMResponse, LLMApiConfig } from './types.js';
+/**
+ * Call the LLM with image(s) input and get image output
+ * Used for image editing, transformation, style transfer, combining images, etc.
+ *
+ * Supports two modes:
+ * 1. Single image: Use image_b64 and image_mime_type
+ * 2. Multiple images: Use images array
+ *
+ * @param params - Image input parameters with transformation instructions
+ * @param _db - Database instance (unused, kept for API consistency)
+ * @param config - LLM API configuration
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns LLM response with transformed/generated image data
+ */
+export declare function hazo_llm_image_image(params: ImageImageParams, _db: SqlJsDatabase | null, config: LLMApiConfig, llm?: string): Promise<LLMResponse>;
+//# sourceMappingURL=hazo_llm_image_image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hazo_llm_image_image.d.ts","sourceRoot":"","sources":["../../../src/lib/llm_api/hazo_llm_image_image.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EAEb,MAAM,YAAY,CAAC;AAuBpB;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,MAAM,EAAE,YAAY,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CAwEtB"}

package/dist/lib/llm_api/hazo_llm_image_image.js

@@ -0,0 +1,94 @@
+/**
+ * hazo_llm_image_image Function
+ *
+ * Image(s) input → Image output
+ * Transform/edit/combine images based on text instructions.
+ * Supports single or multiple input images.
+ * Uses image generation capable models with input image(s).
+ */
+import { substitute_variables } from '../prompts/substitute_variables.js';
+import { SERVICE_TYPES } from '../providers/types.js';
+import { get_validated_provider, log_api_start, log_api_complete, log_api_details, log_api_response, handle_caught_error, } from './provider_helper.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const FILE_NAME = 'hazo_llm_image_image.ts';
+const API_NAME = 'image_image';
+// =============================================================================
+// hazo_llm_image_image Function
+// =============================================================================
+/**
+ * Call the LLM with image(s) input and get image output
+ * Used for image editing, transformation, style transfer, combining images, etc.
+ *
+ * Supports two modes:
+ * 1. Single image: Use image_b64 and image_mime_type
+ * 2. Multiple images: Use images array
+ *
+ * @param params - Image input parameters with transformation instructions
+ * @param _db - Database instance (unused, kept for API consistency)
+ * @param config - LLM API configuration
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns LLM response with transformed/generated image data
+ */
+export async function hazo_llm_image_image(params, _db, config, llm) {
+    // Use default logger if not provided
+    const { default_logger } = await import('./index.js');
+    const logger = config.logger || default_logger;
+    try {
+        log_api_start(API_NAME, FILE_NAME, logger);
+        // ==========================================================================
+        // Step 1: Validate and collect image data
+        // ==========================================================================
+        const images = [];
+        if (params.images && params.images.length > 0) {
+            images.push(...params.images);
+        }
+        else if (params.image_b64 && params.image_mime_type) {
+            images.push({
+                data: params.image_b64,
+                mime_type: params.image_mime_type,
+            });
+        }
+        if (images.length === 0) {
+            const error_msg = 'At least one image is required. Provide image_b64/image_mime_type or images array.';
+            logger.error(error_msg, { file: FILE_NAME });
+            return { success: false, error: error_msg };
+        }
+        // ==========================================================================
+        // Step 2: Prepare prompt with variable substitution
+        // ==========================================================================
+        const final_prompt = substitute_variables(params.prompt, params.prompt_variables, logger);
+        // ==========================================================================
+        // Step 3: Get and validate provider
+        // ==========================================================================
+        const provider_result = get_validated_provider({
+            llm,
+            service_type: SERVICE_TYPES.IMAGE_IMAGE,
+            logger,
+        });
+        if (!provider_result.success) {
+            return provider_result.error_response;
+        }
+        const provider = provider_result.provider;
+        log_api_details(provider, SERVICE_TYPES.IMAGE_IMAGE, FILE_NAME, logger, {
+            prompt_text: final_prompt,
+            image_count: images.length,
+            llm_requested: llm || 'primary',
+        });
+        // ==========================================================================
+        // Step 4: Call the provider
+        // ==========================================================================
+        const response = await provider.image_image({
+            ...params,
+            prompt: final_prompt,
+        }, logger);
+        log_api_response(response, FILE_NAME, logger);
+        log_api_complete(API_NAME, FILE_NAME, response.success, logger);
+        return response;
+    }
+    catch (error) {
+        return handle_caught_error(error, 'hazo_llm_image_image', FILE_NAME, logger);
+    }
+}
+//# sourceMappingURL=hazo_llm_image_image.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * hazo_llm_image_image_text Function
+ *
+ * Images → Image → Text (Chained)
+ *
+ * Flow:
+ * 1. Combine images[0] + images[1] using prompts[0] → result_1
+ * 2. Combine result_1 + images[2] using prompts[1] → result_2
+ * 3. Continue chaining through all images
+ * 4. Analyze final result with description_prompt → text output
+ *
+ * Returns both the final generated image and the text description.
+ */
+import type { Database as SqlJsDatabase } from 'sql.js';
+import type { ImageImageTextParams, LLMResponse, LLMApiConfig } from './types.js';
+/**
+ * Chain multiple image transformations, then describe the final result
+ *
+ * @param params - Parameters with images, prompts, and description prompt
+ * @param db - Database instance
+ * @param config - LLM API configuration
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns LLM response with final image and description text
+ */
+export declare function hazo_llm_image_image_text(params: ImageImageTextParams, db: SqlJsDatabase | null, config: LLMApiConfig, llm?: string): Promise<LLMResponse>;
+//# sourceMappingURL=hazo_llm_image_image_text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hazo_llm_image_image_text.d.ts","sourceRoot":"","sources":["../../../src/lib/llm_api/hazo_llm_image_image_text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAQpB;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,oBAAoB,EAC5B,EAAE,EAAE,aAAa,GAAG,IAAI,EACxB,MAAM,EAAE,YAAY,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CAqOtB"}