hazo_llm_api 1.0.1

package/dist/lib/llm_api/hazo_llm_text_image_text.js

@@ -0,0 +1,152 @@
+/**
+ * hazo_llm_text_image_text Function
+ *
+ * Text → Image → Text (Chained)
+ * 1. Generate an image from prompt_image using hazo_llm_text_image
+ * 2. Analyze the generated image with prompt_text using hazo_llm_image_text
+ * 3. Return both the generated image and the analysis text
+ */
+import { hazo_llm_text_image } from './hazo_llm_text_image.js';
+import { hazo_llm_image_text } from './hazo_llm_image_text.js';
+// =============================================================================
+// hazo_llm_text_image_text Function
+// =============================================================================
+/**
+ * Generate an image from text, then analyze it with a second prompt
+ *
+ * Flow:
+ * 1. Call hazo_llm_text_image with prompt_image to generate an image
+ * 2. Call hazo_llm_image_text with the generated image and prompt_text
+ * 3. Return the generated image and the text analysis from step 2
+ *
+ * @param params - Parameters with two prompts: one for image gen, one for analysis
+ * @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 generated image and analysis text
+ */
+export async function hazo_llm_text_image_text(params, db, config, llm) {
+    const file_name = 'hazo_llm_text_image_text.ts';
+    const logger = config.logger;
+    const api_name = 'text_image_text';
+    try {
+        // ==========================================================================
+        // Log API call start
+        // ==========================================================================
+        logger.debug(`########################################################################### ${api_name}`, {
+            file: file_name,
+            line: 48,
+        });
+        // Log API call details with generation configs
+        logger.debug('API call details', {
+            file: file_name,
+            line: 53,
+            data: {
+                chain_steps: ['text_image', 'image_text'],
+                prompt_image: params.prompt_image,
+                prompt_text: params.prompt_text,
+                prompt_image_variables: params.prompt_image_variables,
+                prompt_text_variables: params.prompt_text_variables,
+                llm_requested: llm || 'primary',
+            },
+        });
+        // ==========================================================================
+        // Step 1: Generate image from prompt_image
+        // ==========================================================================
+        logger.debug('Chain Step 1: Image generation', {
+            file: file_name,
+            line: 66,
+        });
+        const image_response = await hazo_llm_text_image({
+            prompt: params.prompt_image,
+            prompt_variables: params.prompt_image_variables,
+        }, db, config, llm);
+        // Check if image generation succeeded
+        if (!image_response.success) {
+            logger.error('Image generation failed in text_image_text chain', {
+                file: file_name,
+                line: 79,
+                data: { error: image_response.error },
+            });
+            return {
+                success: false,
+                error: `Image generation failed: ${image_response.error}`,
+            };
+        }
+        // Check if we got an image
+        if (!image_response.image_b64 || !image_response.image_mime_type) {
+            logger.error('No image returned from image generation', {
+                file: file_name,
+                line: 90,
+            });
+            return {
+                success: false,
+                error: 'Image generation did not return an image',
+                text: image_response.text, // Include any text that was returned
+            };
+        }
+        // ==========================================================================
+        // Step 2: Analyze the generated image with prompt_text
+        // ==========================================================================
+        logger.debug('Chain Step 2: Image analysis', {
+            file: file_name,
+            line: 103,
+        });
+        const text_response = await hazo_llm_image_text({
+            prompt: params.prompt_text,
+            image_b64: image_response.image_b64,
+            image_mime_type: image_response.image_mime_type,
+            prompt_variables: params.prompt_text_variables,
+        }, db, config, llm);
+        // Check if text analysis succeeded
+        if (!text_response.success) {
+            logger.error('Text analysis failed in text_image_text chain', {
+                file: file_name,
+                line: 120,
+                data: { error: text_response.error },
+            });
+            return {
+                success: false,
+                error: `Image analysis failed: ${text_response.error}`,
+                // Still return the generated image even if analysis failed
+                image_b64: image_response.image_b64,
+                image_mime_type: image_response.image_mime_type,
+            };
+        }
+        // ==========================================================================
+        // Log API response
+        // ==========================================================================
+        logger.debug('API response', {
+            file: file_name,
+            line: 136,
+            data: {
+                success: true,
+                text: text_response.text,
+                image_b64: '[IMAGE_DATA_PLACEHOLDER]',
+                image_mime_type: image_response.image_mime_type,
+            },
+        });
+        // Log API call complete
+        logger.debug(`<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< ${api_name} >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>`, {
+            file: file_name,
+            line: 147,
+            data: { success: true, has_image: true },
+        });
+        return {
+            success: true,
+            text: text_response.text,
+            image_b64: image_response.image_b64,
+            image_mime_type: image_response.image_mime_type,
+        };
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : String(error);
+        logger.error('Error in hazo_llm_text_image_text', {
+            file: file_name,
+            line: 138,
+            data: { error: error_message },
+        });
+        return { success: false, error: error_message };
+    }
+}
+//# sourceMappingURL=hazo_llm_text_image_text.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * hazo_llm_text_text Function
+ *
+ * Text input → Text output
+ * Standard text generation using LLM.
+ * Supports static prompts, dynamic prompts from database, and variable substitution.
+ */
+import type { Database as SqlJsDatabase } from 'sql.js';
+import type { TextTextParams, LLMResponse, LLMApiConfig } from './types.js';
+/**
+ * Call the LLM with text input and get text output
+ *
+ * @param params - Text input parameters
+ * @param db - Database instance for dynamic prompts
+ * @param config - LLM API configuration
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns LLM response with generated text
+ */
+export declare function hazo_llm_text_text(params: TextTextParams, db: SqlJsDatabase | null, config: LLMApiConfig, llm?: string): Promise<LLMResponse>;
+//# sourceMappingURL=hazo_llm_text_text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hazo_llm_text_text.d.ts","sourceRoot":"","sources":["../../../src/lib/llm_api/hazo_llm_text_text.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAwBpB;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,aAAa,GAAG,IAAI,EACxB,MAAM,EAAE,YAAY,EACpB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,CAAC,CA0EtB"}

package/dist/lib/llm_api/hazo_llm_text_text.js

@@ -0,0 +1,89 @@
+/**
+ * hazo_llm_text_text Function
+ *
+ * Text input → Text output
+ * Standard text generation using LLM.
+ * Supports static prompts, dynamic prompts from database, and variable substitution.
+ */
+import { get_prompt_text } from '../prompts/get_prompt.js';
+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_text_text.ts';
+const API_NAME = 'text_text';
+// =============================================================================
+// hazo_llm_text_text Function
+// =============================================================================
+/**
+ * Call the LLM with text input and get text output
+ *
+ * @param params - Text input parameters
+ * @param db - Database instance for dynamic prompts
+ * @param config - LLM API configuration
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns LLM response with generated text
+ */
+export async function hazo_llm_text_text(params, db, config, llm) {
+    const logger = config.logger;
+    try {
+        log_api_start(API_NAME, FILE_NAME, logger);
+        // ==========================================================================
+        // Step 1: Get the prompt text
+        // ==========================================================================
+        let prompt_text;
+        if (params.prompt_area && params.prompt_key) {
+            if (!db) {
+                const error_msg = 'Database not initialized for dynamic prompt retrieval';
+                logger.error(error_msg, { file: FILE_NAME });
+                return { success: false, error: error_msg };
+            }
+            const dynamic_prompt = get_prompt_text(db, params.prompt_area, params.prompt_key, logger);
+            if (!dynamic_prompt) {
+                const error_msg = `Prompt not found for area="${params.prompt_area}" key="${params.prompt_key}"`;
+                logger.error(error_msg, { file: FILE_NAME });
+                return { success: false, error: error_msg };
+            }
+            prompt_text = dynamic_prompt;
+        }
+        else {
+            prompt_text = params.prompt;
+        }
+        // ==========================================================================
+        // Step 2: Substitute variables
+        // ==========================================================================
+        const final_prompt = substitute_variables(prompt_text, params.prompt_variables, logger);
+        // ==========================================================================
+        // Step 3: Get and validate provider
+        // ==========================================================================
+        const provider_result = get_validated_provider({
+            llm,
+            service_type: SERVICE_TYPES.TEXT_TEXT,
+            logger,
+        });
+        if (!provider_result.success) {
+            return provider_result.error_response;
+        }
+        const provider = provider_result.provider;
+        log_api_details(provider, SERVICE_TYPES.TEXT_TEXT, FILE_NAME, logger, {
+            prompt_text: final_prompt,
+            llm_requested: llm || 'primary',
+        });
+        // ==========================================================================
+        // Step 4: Call the provider
+        // ==========================================================================
+        const response = await provider.text_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_text_text', FILE_NAME, logger);
+    }
+}
+//# sourceMappingURL=hazo_llm_text_text.js.map

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

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

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

@@ -0,0 +1,99 @@
+/**
+ * LLM API Module
+ *
+ * Main entry point for the LLM API functionality.
+ * Provides initialization and specialized LLM functions:
+ * - hazo_llm_text_text: Text input → Text output
+ * - hazo_llm_image_text: Image input → Text output
+ * - hazo_llm_text_image: Text input → Image output
+ * - hazo_llm_image_image: Image input → Image output
+ * - hazo_llm_text_image_text: Text → Image → Text (chained)
+ * - hazo_llm_image_image_text: Images → Image → Text (chained)
+ *
+ * Database is auto-initialized on module import using config defaults.
+ */
+import type { LLMApiConfig, LLMApiClient, LLMResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams } from './types.js';
+/**
+ * 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
+ * @returns Initialized LLM API client
+ */
+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
+ */
+export declare function is_database_ready(): boolean;
+/**
+ * Wait for auto-initialization to complete
+ * Useful if you need to ensure database is ready before operations
+ */
+export declare function ensure_database_ready(): Promise<boolean>;
+/**
+ * Text input → Text output
+ * Standard text generation using LLM
+ *
+ * @param params - Text input parameters
+ * @param llm - Optional LLM provider name (uses primary LLM if not specified)
+ * @returns LLM response with generated text
+ */
+export declare function hazo_llm_text_text(params: TextTextParams, llm?: string): 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)
+ * @returns LLM response with text description
+ */
+export declare function hazo_llm_image_text(params: ImageTextParams, llm?: string): 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)
+ * @returns LLM response with generated image
+ */
+export declare function hazo_llm_text_image(params: TextImageParams, llm?: string): 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)
+ * @returns LLM response with transformed image
+ */
+export declare function hazo_llm_image_image(params: ImageImageParams, llm?: string): 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)
+ * @returns LLM response with generated image and analysis text
+ */
+export declare function hazo_llm_text_image_text(params: TextImageTextParams, llm?: string): 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)
+ * @returns LLM response with final image and description text
+ */
+export declare function hazo_llm_image_image_text(params: ImageImageTextParams, llm?: string): Promise<LLMResponse>;
+/**
+ * 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)
+ * @returns Current configuration or null if not initialized
+ */
+export declare function get_current_config(): Omit<LLMApiConfig, 'api_key' | '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

@@ -0,0 +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"}