hazo_llm_api 1.0.4 → 1.0.6

package/dist/lib/llm_api/hazo_llm_image_image_text.js

@@ -0,0 +1,222 @@
+/**
+ * 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 { hazo_llm_image_image } from './hazo_llm_image_image.js';
+import { hazo_llm_image_text } from './hazo_llm_image_text.js';
+// =============================================================================
+// hazo_llm_image_image_text Function
+// =============================================================================
+/**
+ * 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 async function hazo_llm_image_image_text(params, db, config, llm) {
+    const file_name = 'hazo_llm_image_image_text.ts';
+    // Use default logger if not provided
+    const { default_logger } = await import('./index.js');
+    const logger = config.logger || default_logger;
+    const api_name = 'image_image_text';
+    try {
+        // ==========================================================================
+        // Log API call start
+        // ==========================================================================
+        logger.debug(`########################################################################### ${api_name}`, {
+            file: file_name,
+            line: 48,
+        });
+        // ==========================================================================
+        // Validate input
+        // ==========================================================================
+        if (!params.images || params.images.length < 2) {
+            const error_msg = 'At least two images are required';
+            logger.error(error_msg, { file: file_name, line: 58 });
+            return { success: false, error: error_msg };
+        }
+        const expected_prompts = params.images.length - 1;
+        if (!params.prompts || params.prompts.length !== expected_prompts) {
+            const error_msg = `Expected ${expected_prompts} prompts for ${params.images.length} images, got ${params.prompts?.length || 0}`;
+            logger.error(error_msg, { file: file_name, line: 65 });
+            return { success: false, error: error_msg };
+        }
+        if (!params.description_prompt?.trim()) {
+            const error_msg = 'Description prompt is required';
+            logger.error(error_msg, { file: file_name, line: 71 });
+            return { success: false, error: error_msg };
+        }
+        // Log API call details with generation configs
+        logger.debug('API call details', {
+            file: file_name,
+            line: 77,
+            data: {
+                chain_steps: Array.from({ length: params.images.length }, (_, i) => i < params.images.length - 1 ? 'image_image' : 'image_text'),
+                image_count: params.images.length,
+                prompts: params.prompts,
+                description_prompt: params.description_prompt,
+                image_data: params.images.map(img => ({
+                    mime_type: img.image_mime_type,
+                    data: '[IMAGE_DATA_PLACEHOLDER]',
+                })),
+                llm_requested: llm || 'primary',
+            },
+        });
+        // ==========================================================================
+        // Step 1: Combine first two images
+        // ==========================================================================
+        logger.debug('Chain Step 1: Combining first two images', {
+            file: file_name,
+            line: 94,
+        });
+        let current_result = await hazo_llm_image_image({
+            prompt: params.prompts[0],
+            images: [
+                { data: params.images[0].image_b64, mime_type: params.images[0].image_mime_type },
+                { data: params.images[1].image_b64, mime_type: params.images[1].image_mime_type },
+            ],
+        }, db, config, llm);
+        if (!current_result.success) {
+            logger.error('Step 1 failed: combining first two images', {
+                file: file_name,
+                line: 111,
+                data: { error: current_result.error },
+            });
+            return {
+                success: false,
+                error: `Step 1 failed: ${current_result.error}`,
+            };
+        }
+        if (!current_result.image_b64 || !current_result.image_mime_type) {
+            logger.error('Step 1 did not return an image', {
+                file: file_name,
+                line: 122,
+            });
+            return {
+                success: false,
+                error: 'Step 1 did not return an image',
+                text: current_result.text,
+            };
+        }
+        // ==========================================================================
+        // Steps 2+: Chain through remaining images
+        // ==========================================================================
+        for (let i = 2; i < params.images.length; i++) {
+            const step_num = i;
+            const prompt_index = i - 1;
+            logger.debug(`Chain Step ${step_num}: Adding image ${i + 1}`, {
+                file: file_name,
+                line: 139,
+            });
+            // Combine current result with next image
+            current_result = await hazo_llm_image_image({
+                prompt: params.prompts[prompt_index],
+                images: [
+                    { data: current_result.image_b64, mime_type: current_result.image_mime_type },
+                    { data: params.images[i].image_b64, mime_type: params.images[i].image_mime_type },
+                ],
+            }, db, config, llm);
+            if (!current_result.success) {
+                logger.error(`Step ${step_num} failed`, {
+                    file: file_name,
+                    line: 157,
+                    data: { step: step_num, error: current_result.error },
+                });
+                return {
+                    success: false,
+                    error: `Step ${step_num} failed: ${current_result.error}`,
+                };
+            }
+            if (!current_result.image_b64 || !current_result.image_mime_type) {
+                logger.error(`Step ${step_num} did not return an image`, {
+                    file: file_name,
+                    line: 168,
+                    data: { step: step_num },
+                });
+                return {
+                    success: false,
+                    error: `Step ${step_num} did not return an image`,
+                    text: current_result.text,
+                };
+            }
+        }
+        // ==========================================================================
+        // Final Step: Describe the final image
+        // ==========================================================================
+        logger.debug('Chain Final Step: Generating description', {
+            file: file_name,
+            line: 183,
+        });
+        const text_response = await hazo_llm_image_text({
+            prompt: params.description_prompt,
+            image_b64: current_result.image_b64,
+            image_mime_type: current_result.image_mime_type,
+            prompt_variables: params.description_prompt_variables,
+        }, db, config, llm);
+        if (!text_response.success) {
+            logger.error('Description generation failed', {
+                file: file_name,
+                line: 199,
+                data: { error: text_response.error },
+            });
+            return {
+                success: false,
+                error: `Description failed: ${text_response.error}`,
+                // Still return the final image even if description failed
+                image_b64: current_result.image_b64,
+                image_mime_type: current_result.image_mime_type,
+            };
+        }
+        // ==========================================================================
+        // Log API response
+        // ==========================================================================
+        logger.debug('API response', {
+            file: file_name,
+            line: 215,
+            data: {
+                success: true,
+                text: text_response.text,
+                image_b64: '[IMAGE_DATA_PLACEHOLDER]',
+                image_mime_type: current_result.image_mime_type,
+            },
+        });
+        // Log API call complete
+        logger.debug(`<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ${api_name} >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>`, {
+            file: file_name,
+            line: 226,
+            data: {
+                success: true,
+                total_steps: params.images.length,
+                has_image: true,
+            },
+        });
+        return {
+            success: true,
+            text: text_response.text,
+            image_b64: current_result.image_b64,
+            image_mime_type: current_result.image_mime_type,
+        };
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : String(error);
+        logger.error('Error in hazo_llm_image_image_text', {
+            file: file_name,
+            line: 231,
+            data: { error: error_message },
+        });
+        return { success: false, error: error_message };
+    }
+}
+//# sourceMappingURL=hazo_llm_image_image_text.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * hazo_llm_image_text Function
+ *
+ * Image input → Text output
+ * Analyze an image and get text description/response.
+ * Supports image analysis, OCR, object detection descriptions, etc.
+ */
+import type { Database as SqlJsDatabase } from 'sql.js';
+import type { ImageTextParams, LLMResponse, LLMApiConfig } from './types.js';
+/**
+ * Call the LLM with an image input and get text output
+ *
+ * @param params - Image input parameters
+ * @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 generated text description
+ */
+export declare function hazo_llm_image_text(params: ImageTextParams, _db: SqlJsDatabase | null, config: LLMApiConfig, llm?: string): Promise<LLMResponse>;
+//# sourceMappingURL=hazo_llm_image_text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hazo_llm_image_text.d.ts","sourceRoot":"","sources":["../../../src/lib/llm_api/hazo_llm_image_text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAuBpB;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,MAAM,EAAE,YAAY,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CA6DtB"}

package/dist/lib/llm_api/hazo_llm_image_text.js

@@ -0,0 +1,78 @@
+/**
+ * hazo_llm_image_text Function
+ *
+ * Image input → Text output
+ * Analyze an image and get text description/response.
+ * Supports image analysis, OCR, object detection descriptions, etc.
+ */
+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_text.ts';
+const API_NAME = 'image_text';
+// =============================================================================
+// hazo_llm_image_text Function
+// =============================================================================
+/**
+ * Call the LLM with an image input and get text output
+ *
+ * @param params - Image input parameters
+ * @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 generated text description
+ */
+export async function hazo_llm_image_text(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 image data
+        // ==========================================================================
+        if (!params.image_b64 || !params.image_mime_type) {
+            const error_msg = 'image_b64 and image_mime_type are required';
+            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_TEXT,
+            logger,
+        });
+        if (!provider_result.success) {
+            return provider_result.error_response;
+        }
+        const provider = provider_result.provider;
+        log_api_details(provider, SERVICE_TYPES.IMAGE_TEXT, FILE_NAME, logger, {
+            prompt_text: final_prompt,
+            image_mime_type: params.image_mime_type,
+            llm_requested: llm || 'primary',
+        });
+        // ==========================================================================
+        // Step 4: Call the provider
+        // ==========================================================================
+        const response = await provider.image_text({
+            ...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_text', FILE_NAME, logger);
+    }
+}
+//# sourceMappingURL=hazo_llm_image_text.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hazo_llm_image_text.js","sourceRoot":"","sources":["../../../src/lib/llm_api/hazo_llm_image_text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,SAAS,GAAG,wBAAwB,CAAC;AAC3C,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAuB,EACvB,GAAyB,EACzB,MAAoB,EACpB,GAAY;IAEZ,qCAAqC;IACrC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC;IAE/C,IAAI,CAAC;QACH,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAE3C,6EAA6E;QAC7E,8BAA8B;QAC9B,6EAA6E;QAC7E,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACjD,MAAM,SAAS,GAAG,4CAA4C,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC9C,CAAC;QAED,6EAA6E;QAC7E,oDAAoD;QACpD,6EAA6E;QAC7E,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAE1F,6EAA6E;QAC7E,oCAAoC;QACpC,6EAA6E;QAC7E,MAAM,eAAe,GAAG,sBAAsB,CAAC;YAC7C,GAAG;YACH,YAAY,EAAE,aAAa,CAAC,UAAU;YACtC,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YAC7B,OAAO,eAAe,CAAC,cAAc,CAAC;QACxC,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;QAE1C,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE;YACrE,WAAW,EAAE,YAAY;YACzB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,aAAa,EAAE,GAAG,IAAI,SAAS;SAChC,CAAC,CAAC;QAEH,6EAA6E;QAC7E,4BAA4B;QAC5B,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,CACxC;YACE,GAAG,MAAM;YACT,MAAM,EAAE,YAAY;SACrB,EACD,MAAM,CACP,CAAC;QAEF,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9C,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEhE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

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"}