hazo_llm_api 1.0.4 → 1.0.5

package/dist/lib/database/utils.js

@@ -0,0 +1,87 @@
+/**
+ * Database Utilities
+ *
+ * Shared utility functions for database operations.
+ * Single source of truth for common database helpers.
+ */
+// =============================================================================
+// Row Conversion Utilities
+// =============================================================================
+/**
+ * Convert a database row to a PromptRecord object using column names
+ *
+ * This is the single source of truth for row-to-record conversion.
+ * Used by both database initialization and prompt retrieval functions.
+ *
+ * @param row - Raw database row as array of values
+ * @param columns - Array of column names from the query result
+ * @returns PromptRecord object
+ *
+ * @example
+ * ```typescript
+ * const result = db.exec('SELECT * FROM prompts_library WHERE uuid = ?', [uuid]);
+ * if (result.length > 0 && result[0].values.length > 0) {
+ *   const record = row_to_prompt_record(result[0].values[0], result[0].columns);
+ * }
+ * ```
+ */
+export function row_to_prompt_record(row, columns) {
+    const record = {};
+    for (let i = 0; i < columns.length; i++) {
+        record[columns[i]] = row[i];
+    }
+    return {
+        uuid: String(record.uuid || ''),
+        prompt_area: String(record.prompt_area || ''),
+        prompt_key: String(record.prompt_key || ''),
+        local_1: record.local_1 != null ? String(record.local_1) : null,
+        local_2: record.local_2 != null ? String(record.local_2) : null,
+        local_3: record.local_3 != null ? String(record.local_3) : null,
+        prompt_text: String(record.prompt_text || ''),
+        prompt_variables: String(record.prompt_variables || '[]'),
+        prompt_notes: String(record.prompt_notes || ''),
+        created_at: String(record.created_at || ''),
+        changed_by: String(record.changed_by || ''),
+    };
+}
+/**
+ * Column indices for prompts_library table
+ * Use these constants when building queries to ensure consistency
+ */
+export const PROMPT_COLUMNS = {
+    UUID: 0,
+    PROMPT_AREA: 1,
+    PROMPT_KEY: 2,
+    LOCAL_1: 3,
+    LOCAL_2: 4,
+    LOCAL_3: 5,
+    PROMPT_TEXT: 6,
+    PROMPT_VARIABLES: 7,
+    PROMPT_NOTES: 8,
+    CREATED_AT: 9,
+    CHANGED_BY: 10,
+};
+/**
+ * SQL column names for prompts_library table
+ */
+export const PROMPT_COLUMN_NAMES = [
+    'uuid',
+    'prompt_area',
+    'prompt_key',
+    'local_1',
+    'local_2',
+    'local_3',
+    'prompt_text',
+    'prompt_variables',
+    'prompt_notes',
+    'created_at',
+    'changed_by',
+];
+/**
+ * Get the SELECT clause for all prompt columns
+ * @returns SQL SELECT clause string
+ */
+export function get_prompt_select_clause() {
+    return PROMPT_COLUMN_NAMES.join(', ');
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/database/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/database/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAc,EAAE,OAAiB;IACpE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC3C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAC7C,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,IAAI,IAAI,CAAC;QACzD,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;QAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC3C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,CAAC;IACP,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,CAAC;IACd,gBAAgB,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,EAAE;CACN,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM;IACN,aAAa;IACb,YAAY;IACZ,SAAS;IACT,SAAS;IACT,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,cAAc;IACd,YAAY;IACZ,YAAY;CACJ,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/lib/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Library Module Exports
+ *
+ * Export all library functions from this module
+ */
+export { initialize_llm_api, hazo_llm_text_text, hazo_llm_image_text, hazo_llm_text_image, hazo_llm_image_image, hazo_llm_text_image_text, hazo_llm_image_image_text, is_initialized, get_current_config, } from './llm_api/index.js';
+export type { LLMApiConfig, LLMApiClient, LLMResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, TextImageTextParams, ImageImageTextParams, ChainImage, Logger, PromptVariable, PromptVariables, Base64Data, PromptTextMode, PromptRecord, CallLLMParams, } from './llm_api/types.js';
+export { initialize_database, get_database, close_database, insert_prompt, update_prompt, } from './database/index.js';
+export { get_prompt_by_area_and_key, get_prompt_text, get_prompts_by_area, get_prompt_by_uuid, substitute_variables, parse_prompt_variables, validate_variables, } from './prompts/index.js';
+export { call_gemini_api, get_gemini_api_url, GeminiProvider, type GeminiProviderConfig, QwenProvider, type QwenProviderConfig, call_qwen_api, get_qwen_api_url, type QwenGenerationConfig, } from './providers/index.js';
+export type { LLMProvider, LLMProviderConfig, ServiceType, LLMCapabilities, } from './providers/types.js';
+export { SERVICE_TYPES, } from './providers/types.js';
+export { register_provider, set_enabled_llms, set_primary_llm, get_primary_llm, get_provider, get_registered_providers, is_llm_enabled, } from './providers/registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,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,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,KAAK,oBAAoB,EACzB,YAAY,EACZ,KAAK,kBAAkB,EACvB,aAAa,EACb,gBAAgB,EAChB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,GACd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,cAAc,GACf,MAAM,yBAAyB,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,17 @@
+/**
+ * Library Module Exports
+ *
+ * Export all library functions from this module
+ */
+// LLM API exports
+export { initialize_llm_api, hazo_llm_text_text, hazo_llm_image_text, hazo_llm_text_image, hazo_llm_image_image, hazo_llm_text_image_text, hazo_llm_image_image_text, is_initialized, get_current_config, } from './llm_api/index.js';
+// Database exports
+export { initialize_database, get_database, close_database, insert_prompt, update_prompt, } from './database/index.js';
+// Prompts exports
+export { get_prompt_by_area_and_key, get_prompt_text, get_prompts_by_area, get_prompt_by_uuid, substitute_variables, parse_prompt_variables, validate_variables, } from './prompts/index.js';
+// Provider exports
+export { call_gemini_api, get_gemini_api_url, GeminiProvider, QwenProvider, call_qwen_api, get_qwen_api_url, } from './providers/index.js';
+export { SERVICE_TYPES, } from './providers/types.js';
+// Provider registry exports
+export { register_provider, set_enabled_llms, set_primary_llm, get_primary_llm, get_provider, get_registered_providers, is_llm_enabled, } from './providers/registry.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAuB5B,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,kBAAkB;AAClB,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,EAEd,YAAY,EAEZ,aAAa,EACb,gBAAgB,GAEjB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EACL,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,4BAA4B;AAC5B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,cAAc,GACf,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,117 @@
+/**
+ * Chain Helper Functions
+ *
+ * Utility functions for parsing call_chain paths, resolving values,
+ * and deep merging results in prompt chains.
+ */
+import type { Logger, ChainFieldDefinition, ChainVariableDefinition, ChainImageDefinition, ChainCallResult, PromptVariables } from './types.js';
+interface ParsedPath {
+    call_index: number;
+    property_path: string[];
+}
+/**
+ * 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 declare function parse_call_chain_path(path_expr: string, logger: Logger): ParsedPath | null;
+/**
+ * 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 declare function extract_value_from_path(obj: Record<string, unknown>, path: string[], logger: Logger): string | null;
+/**
+ * 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 declare function extract_value_from_result(result: ChainCallResult, property_path: string[], logger: Logger): string | null;
+/**
+ * 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 declare function resolve_chain_field(field: ChainFieldDefinition, previous_results: ChainCallResult[], logger: Logger): string | null;
+/**
+ * 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 declare function resolve_chain_variable(variable: ChainVariableDefinition, previous_results: ChainCallResult[], logger: Logger): string | null;
+/**
+ * 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 declare function build_prompt_variables(variables_array: ChainVariableDefinition[] | undefined, previous_results: ChainCallResult[], logger: Logger): PromptVariables;
+/**
+ * Resolved image data from a ChainImageDefinition
+ */
+export interface ResolvedImage {
+    image_b64: string;
+    image_mime_type: string;
+}
+/**
+ * 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 declare function resolve_chain_image_definition(image_def: ChainImageDefinition, previous_results: ChainCallResult[], logger: Logger): ResolvedImage | null;
+/**
+ * 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 declare function deep_merge(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;
+/**
+ * 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 declare function merge_chain_results(results: ChainCallResult[], logger: Logger): Record<string, unknown>;
+/**
+ * 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 declare function parse_llm_json_response(text: string, logger: Logger): Record<string, unknown> | null;
+export {};
+//# sourceMappingURL=chain_helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chain_helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/llm_api/chain_helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAQpB,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,IAAI,CAqBnB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAsCf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,MAAM,EAAE,EACvB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CA2Cf;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,oBAAoB,EAC3B,gBAAgB,EAAE,eAAe,EAAE,EACnC,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAwDf;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,EACjC,gBAAgB,EAAE,eAAe,EAAE,EACnC,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CA2Df;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,uBAAuB,EAAE,GAAG,SAAS,EACtD,gBAAgB,EAAE,eAAe,EAAE,EACnC,MAAM,EAAE,MAAM,GACb,eAAe,CA2CjB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,oBAAoB,EAC/B,gBAAgB,EAAE,eAAe,EAAE,EACnC,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CAmCtB;AAMD;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EAAE,EAC1B,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAMD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgDhC"}