hazo_llm_api 1.0.3 → 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_prompt_chain.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 type { Database as SqlJsDatabase } from 'sql.js';
+import type { PromptChainParams, PromptChainResponse, LLMApiConfig } from './types.js';
+/**
+ * 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 declare function hazo_llm_prompt_chain(params: PromptChainParams, db: SqlJsDatabase | null, config: LLMApiConfig, llm?: string): Promise<PromptChainResponse>;
+//# sourceMappingURL=hazo_llm_prompt_chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hazo_llm_prompt_chain.d.ts","sourceRoot":"","sources":["../../../src/lib/llm_api/hazo_llm_prompt_chain.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EAGnB,YAAY,EASb,MAAM,YAAY,CAAC;AA+OpB;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,iBAAiB,EACzB,EAAE,EAAE,aAAa,GAAG,IAAI,EACxB,MAAM,EAAE,YAAY,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CA4O9B"}