hazo_llm_api 1.2.13 → 2.0.0

package/dist/lib/providers/types.d.ts

@@ -4,7 +4,7 @@
  * Defines the interface that all LLM providers must implement.
  * This ensures consistent behavior across different LLM implementations.
  */
-import type { LLMResponse, LLMStreamResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, DocumentTextParams, Logger } from '../llm_api/types.js';
+import type { EmbedParams, EmbedResponse, LLMResponse, LLMStreamResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, DocumentTextParams, Logger } from '../llm_api/types.js';
 /**
  * Provider name constants for type-safe LLM provider selection
  * Use these constants instead of string literals for autocomplete and type safety
@@ -46,6 +46,7 @@ export declare const SERVICE_TYPES: {
     readonly TEXT_IMAGE: "text_image";
     readonly IMAGE_IMAGE: "image_image";
     readonly DOCUMENT_TEXT: "document_text";
+    readonly EMBED: "embed";
 };
 /**
  * Service type string literal union
@@ -83,7 +84,7 @@ export interface LLMProvider {
      * @param logger - Logger instance
      * @returns LLM response with generated text
      */
-    text_text(params: TextTextParams, logger: Logger): Promise<LLMResponse>;
+    text_text?(params: TextTextParams, logger: Logger): Promise<LLMResponse>;
     /**
      * Image input → Text output
      * Analyze an image and generate text description
@@ -92,7 +93,7 @@ export interface LLMProvider {
      * @param logger - Logger instance
      * @returns LLM response with generated text
      */
-    image_text(params: ImageTextParams, logger: Logger): Promise<LLMResponse>;
+    image_text?(params: ImageTextParams, logger: Logger): Promise<LLMResponse>;
     /**
      * Text input → Image output
      * Generate an image from a text prompt
@@ -101,7 +102,7 @@ export interface LLMProvider {
      * @param logger - Logger instance
      * @returns LLM response with generated image
      */
-    text_image(params: TextImageParams, logger: Logger): Promise<LLMResponse>;
+    text_image?(params: TextImageParams, logger: Logger): Promise<LLMResponse>;
     /**
      * Image input → Image output
      * Transform/edit an image based on instructions
@@ -110,7 +111,7 @@ export interface LLMProvider {
      * @param logger - Logger instance
      * @returns LLM response with transformed image
      */
-    image_image(params: ImageImageParams, logger: Logger): Promise<LLMResponse>;
+    image_image?(params: ImageImageParams, logger: Logger): Promise<LLMResponse>;
     /**
      * Document input → Text output
      * Analyze a document (PDF) and generate text description
@@ -119,7 +120,7 @@ export interface LLMProvider {
      * @param logger - Logger instance
      * @returns LLM response with generated text
      */
-    document_text(params: DocumentTextParams, logger: Logger): Promise<LLMResponse>;
+    document_text?(params: DocumentTextParams, logger: Logger): Promise<LLMResponse>;
     /**
      * Text input → Text output (streaming)
      * Generate text from a text prompt with streaming response
@@ -138,6 +139,15 @@ export interface LLMProvider {
      * @returns Async generator yielding text chunks
      */
     image_text_stream?(params: ImageTextParams, logger: Logger): Promise<LLMStreamResponse>;
+    /**
+     * Embeddings — added in 1.3.0.
+     * Generate vector embeddings for one or more text inputs.
+     *
+     * @param params - Text string or array of strings to embed, and optional model override
+     * @param logger - Logger instance
+     * @returns Result containing vectors, dimensions, model used, and optional usage info
+     */
+    embed?(params: EmbedParams, logger: Logger): Promise<EmbedResponse>;
 }
 /**
  * Base configuration for initializing an LLM provider

package/dist/lib/providers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,EACP,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAM5F;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;AAM/C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;;OAGG;IACH,gBAAgB,IAAI,eAAe,CAAC;IAEpC;;;;OAIG;IACH,qBAAqB,CAAC,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAErE;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAExE;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1E;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1E;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5E;;;;;;;OAOG;IACH,aAAa,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAMhF;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEtF;;;;;;;OAOG;IACH,iBAAiB,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACzF;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IAEb,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,EACP,MAAM,qBAAqB,CAAC;AAM7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAM5F;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;AAM/C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;;OAGG;IACH,gBAAgB,IAAI,eAAe,CAAC;IAEpC;;;;OAIG;IACH,qBAAqB,CAAC,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IAErE;;;;;;;OAOG;IACH,SAAS,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzE;;;;;;;OAOG;IACH,UAAU,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3E;;;;;;;OAOG;IACH,UAAU,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3E;;;;;;;OAOG;IACH,WAAW,CAAC,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7E;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAMjF;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEtF;;;;;;;OAOG;IACH,iBAAiB,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAMxF;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACrE;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IAEb,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/lib/providers/types.js

@@ -34,5 +34,6 @@ export const SERVICE_TYPES = {
     TEXT_IMAGE: 'text_image',
     IMAGE_IMAGE: 'image_image',
     DOCUMENT_TEXT: 'document_text',
+    EMBED: 'embed',
 };
 //# sourceMappingURL=types.js.map

package/dist/lib/providers/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAoBX,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;CACtB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAoBX,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,KAAK,EAAE,OAAO;CACN,CAAC"}

package/dist/lib/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared UI Utilities
+ *
+ * Common utility functions used across components.
+ */
+import { type ClassValue } from 'clsx';
+/**
+ * Merge Tailwind CSS classes with clsx
+ * @param inputs - Class values to merge
+ * @returns Merged class string
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C;;;;GAIG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC"}

package/dist/lib/utils.js

@@ -0,0 +1,16 @@
+/**
+ * Shared UI Utilities
+ *
+ * Common utility functions used across components.
+ */
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+/**
+ * Merge Tailwind CSS classes with clsx
+ * @param inputs - Class values to merge
+ * @returns Merged class string
+ */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAmB,IAAI,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,EAAE,CAAC,GAAG,MAAoB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/server.d.ts

@@ -16,7 +16,10 @@
  * - hazo_llm_prompt_chain: Chain multiple prompts with dynamic value resolution
  * - hazo_llm_dynamic_data_extract: Dynamic chain where next prompt is determined by JSON output
  */
-export { initialize_llm_api, hazo_llm_text_text, hazo_llm_image_text, hazo_llm_text_image, hazo_llm_image_image, hazo_llm_document_text, hazo_llm_text_image_text, hazo_llm_image_image_text, hazo_llm_prompt_chain, hazo_llm_dynamic_data_extract, hazo_llm_text_text_stream, hazo_llm_image_text_stream, is_initialized, get_current_config, get_hazo_connect, default_logger, get_logger, set_logger, get_hooks, set_hooks, } from './lib/llm_api/index.js';
+export { initialize_llm_api, hazo_llm_text_text, hazo_llm_image_text, hazo_llm_text_image, hazo_llm_image_image, hazo_llm_document_text, hazo_llm_text_image_text, hazo_llm_image_image_text, hazo_llm_prompt_chain, hazo_llm_dynamic_data_extract, hazo_llm_text_text_stream, hazo_llm_image_text_stream, hazo_llm_embed, is_initialized, get_current_config, get_hazo_connect, default_logger, get_logger, set_logger, get_hooks, set_hooks, get_cascade_config, } from './lib/llm_api/index.js';
+export { configure_embed_cache } from './lib/llm_api/embed_cache.js';
+export type { CascadeConfig } from './lib/cascade/types.js';
+export { DEFAULT_CASCADE_ON_CODES } from './lib/cascade/types.js';
 export { initialize_database, get_database, close_database, get_default_sqlite_path, expand_path, resolve_sqlite_path, insert_prompt, update_prompt, delete_prompt, } from './lib/database/index.js';
 export { create_direct_db_connect } from './lib/hazo_connect/index.js';
 export type { HazoConnect, HazoConnectResponse, HazoConnectBulkResponse, PromptInput, LocalFilters, DirectDbConnectOptions, } from './lib/hazo_connect/index.js';
@@ -28,5 +31,16 @@ export type { ProviderName, ServiceType } from './lib/providers/types.js';
 export { LLM_ERROR_CODES } from './lib/llm_api/types.js';
 export { build_error_response } from './lib/llm_api/provider_helper.js';
 export type { LLMErrorCode, LLMError } from './lib/llm_api/types.js';
-export type { LLMApiConfig, LLMApiClient, LLMResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, DocumentTextParams, TextImageTextParams, ImageImageTextParams, ChainImage, Logger, PromptVariable, PromptVariables, Base64Data, PromptTextMode, PromptRecord, CallLLMParams, LLMHooks, LLMRequestContext, LLMResponseContext, LLMErrorContext, BeforeRequestHook, AfterResponseHook, OnErrorHook, LLMStreamChunk, LLMStreamResponse, ChainMatchType, ChainFieldDefinition, ChainVariableDefinition, ChainCallDefinition, ChainCallResult, PromptChainParams, PromptChainResponse, DynamicDataExtractParams, DynamicDataExtractResponse, DynamicExtractStepResult, DynamicExtractStopReason, NextPromptConfig, NextPromptBranch, NextPromptCondition, NextPromptOperator, } from './lib/llm_api/types.js';
+export type { LLMApiConfig, LLMApiClient, LLMResponse, TextTextParams, ImageTextParams, TextImageParams, ImageImageParams, DocumentTextParams, TextImageTextParams, ImageImageTextParams, ChainImage, Logger, PromptVariable, PromptVariables, Base64Data, PromptTextMode, PromptRecord, CallLLMParams, LLMHooks, LLMRequestContext, LLMResponseContext, LLMErrorContext, BeforeRequestHook, AfterResponseHook, OnErrorHook, LLMStreamChunk, LLMStreamResponse, EmbedParams, EmbedResponse, EmbedKeyv, PromptPart, ChainMatchType, ChainFieldDefinition, ChainVariableDefinition, ChainCallDefinition, ChainCallResult, PromptChainParams, PromptChainResponse, DynamicDataExtractParams, DynamicDataExtractResponse, DynamicExtractStepResult, DynamicExtractStopReason, NextPromptConfig, NextPromptBranch, NextPromptCondition, NextPromptOperator, } from './lib/llm_api/types.js';
+export { get_llm_usage_summary, get_llm_call_detail, } from './lib/observability/queries.js';
+export { create_default_after_response_hook, } from './lib/observability/log_writer.js';
+export { ensure_api_log_table, } from './lib/database/init_api_log.js';
+export type { ApiLogRow, UsageSummaryOptions, UsageSummaryResponse, UsageSummaryRow, UsageSummaryGroupBy, UsageSummaryWhere, } from './lib/observability/types.js';
+export { get_pricing, update_pricing, set_pricing_overrides, compute_cost, recompute_costs, load_pricing, reset_pricing_for_test, } from './lib/pricing/pricing.js';
+export type { RecomputeOpts, RecomputeResult, } from './lib/pricing/pricing.js';
+export type { PricingEntry, PricingEntryText, PricingEntryImage, PricingEntryEmbedding, PricingEntryAudio, PricingTable, PricingKind, UsageInfo, UsageTokens, UsageAttempt, FinishReason, } from './lib/pricing/types.js';
+export { query_session_cost, check_cost_cap_gate, } from './lib/cost_cap/cost_cap.js';
+export type { CostCapConfig, } from './lib/llm_api/types.js';
+export { llm_api_purge_log_job } from './lib/maintenance/purge_log_job.js';
+export type { PurgeLogPayload } from './lib/maintenance/purge_log_job.js';
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B,EAE7B,yBAAyB,EACzB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB,EAElB,gBAAgB,EAEhB,cAAc,EACd,UAAU,EACV,UAAU,EAEV,SAAS,EACT,SAAS,GACV,MAAM,wBAAwB,CAAC;AAOhC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,EAEd,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EAEnB,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAKrC,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAKvC,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAK1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAKrE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,MAAM,EACN,cAAc,EACd,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EAEb,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EAEX,cAAc,EACd,iBAAiB,EAEjB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EAEnB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -21,13 +21,22 @@
 // =============================================================================
 export { initialize_llm_api, hazo_llm_text_text, hazo_llm_image_text, hazo_llm_text_image, hazo_llm_image_image, hazo_llm_document_text, hazo_llm_text_image_text, hazo_llm_image_image_text, hazo_llm_prompt_chain, hazo_llm_dynamic_data_extract, 
 // Streaming functions
-hazo_llm_text_text_stream, hazo_llm_image_text_stream, is_initialized, get_current_config, 
+hazo_llm_text_text_stream, hazo_llm_image_text_stream, 
+// Embedding function
+hazo_llm_embed, is_initialized, get_current_config, 
 // HazoConnect accessor
 get_hazo_connect, 
 // Logger utilities
 default_logger, get_logger, set_logger, 
 // Hooks utilities
-get_hooks, set_hooks, } from './lib/llm_api/index.js';
+get_hooks, set_hooks, 
+// Cascade config accessor
+get_cascade_config, } from './lib/llm_api/index.js';
+// =============================================================================
+// Embed Cache Exports (Server-side ONLY)
+// =============================================================================
+export { configure_embed_cache } from './lib/llm_api/embed_cache.js';
+export { DEFAULT_CASCADE_ON_CODES } from './lib/cascade/types.js';
 // =============================================================================
 // Database Exports (Server-side ONLY)
 // NOTE: Prefer using hazo_connect for database operations in new code.
@@ -63,4 +72,22 @@ export { LLM_PROVIDERS, SERVICE_TYPES } from './lib/providers/types.js';
 // =============================================================================
 export { LLM_ERROR_CODES } from './lib/llm_api/types.js';
 export { build_error_response } from './lib/llm_api/provider_helper.js';
+// =============================================================================
+// Observability Exports (Server-side ONLY)
+// =============================================================================
+export { get_llm_usage_summary, get_llm_call_detail, } from './lib/observability/queries.js';
+export { create_default_after_response_hook, } from './lib/observability/log_writer.js';
+export { ensure_api_log_table, } from './lib/database/init_api_log.js';
+// =============================================================================
+// Pricing Exports (Server-side ONLY)
+// =============================================================================
+export { get_pricing, update_pricing, set_pricing_overrides, compute_cost, recompute_costs, load_pricing, reset_pricing_for_test, } from './lib/pricing/pricing.js';
+// =============================================================================
+// Cost Cap Exports (Server-side ONLY)
+// =============================================================================
+export { query_session_cost, check_cost_cap_gate, } from './lib/cost_cap/cost_cap.js';
+// =============================================================================
+// Maintenance Jobs (Server-side ONLY)
+// =============================================================================
+export { llm_api_purge_log_job } from './lib/maintenance/purge_log_job.js';
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,gFAAgF;AAChF,qCAAqC;AACrC,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,6BAA6B;AAC7B,sBAAsB;AACtB,yBAAyB,EACzB,0BAA0B,EAC1B,cAAc,EACd,kBAAkB;AAClB,uBAAuB;AACvB,gBAAgB;AAChB,mBAAmB;AACnB,cAAc,EACd,UAAU,EACV,UAAU;AACV,kBAAkB;AAClB,SAAS,EACT,SAAS,GACV,MAAM,wBAAwB,CAAC;AAEhC,gFAAgF;AAChF,sCAAsC;AACtC,uEAAuE;AACvE,kFAAkF;AAClF,gFAAgF;AAChF,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc;AACd,eAAe;AACf,uBAAuB,EACvB,WAAW,EACX,mBAAmB;AACnB,2DAA2D;AAC3D,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,gFAAgF;AAChF,qCAAqC;AACrC,gFAAgF;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAUvE,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAChF,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC;AAEhC,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AAEvC,gFAAgF;AAChF,sCAAsC;AACtC,gFAAgF;AAChF,OAAO,EACL,eAAe,EACf,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAChF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGxE,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/migrations/db_setup_postgres.sql

@@ -0,0 +1,68 @@
+-- hazo_llm_api — complete idempotent PostgreSQL schema
+-- Run this once against a fresh database, or re-run safely on an existing one.
+-- All statements use IF NOT EXISTS / IF EXISTS guards.
+
+-- ---------------------------------------------------------------------------
+-- prompts_library
+-- Stores reusable prompt templates managed via the prompt-config UI.
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS prompts_library (
+  id                  UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  prompt_area         TEXT NOT NULL,
+  prompt_key          TEXT NOT NULL,
+  prompt_name         TEXT NOT NULL,
+  prompt_text_head    TEXT DEFAULT '',
+  prompt_text_body    TEXT NOT NULL,
+  prompt_text_tail    TEXT DEFAULT '',
+  prompt_variables    TEXT DEFAULT '[]',
+  prompt_notes        TEXT DEFAULT '',
+  created_at          TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  changed_by          TEXT DEFAULT NULL,
+  UNIQUE(prompt_area, prompt_key)
+);
+
+CREATE INDEX IF NOT EXISTS idx_prompts_area_key ON prompts_library(prompt_area, prompt_key);
+
+-- ---------------------------------------------------------------------------
+-- hazo_llm_api_log
+-- Per-call observability log written by the default afterResponse hook.
+-- Cost values are frozen per-row for accurate historical audit.
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS hazo_llm_api_log (
+  id                        UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  created_at                TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  service_type              TEXT NOT NULL,
+  provider                  TEXT NOT NULL,
+  model                     TEXT,
+  success                   BOOLEAN NOT NULL,
+  tokens_input              INTEGER,
+  tokens_output             INTEGER,
+  tokens_cached_input       INTEGER,
+  tokens_total              INTEGER,
+  cost_usd                  DOUBLE PRECISION,
+  pricing_kind              TEXT,
+  pricing_input_per_1m_usd  DOUBLE PRECISION,
+  pricing_output_per_1m_usd DOUBLE PRECISION,
+  pricing_per_image_usd     DOUBLE PRECISION,
+  latency_ms                INTEGER,
+  finish_reason             TEXT,
+  error_code                TEXT,
+  error_message             TEXT,
+  prompt_area               TEXT,
+  prompt_key                TEXT,
+  prompt_id                 UUID,
+  session_id                TEXT,
+  reference                 TEXT,
+  attempts_count            INTEGER DEFAULT 1,
+  context_json              JSONB DEFAULT '{}'::jsonb
+);
+
+CREATE INDEX IF NOT EXISTS idx_llm_log_created         ON hazo_llm_api_log(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_provider        ON hazo_llm_api_log(provider, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_success         ON hazo_llm_api_log(success, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_session         ON hazo_llm_api_log(session_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_service         ON hazo_llm_api_log(service_type, created_at DESC);
+-- Cost-cap index (session window queries, no DESC — matches cost_cap.ts usage)
+CREATE INDEX IF NOT EXISTS idx_llm_log_session_created ON hazo_llm_api_log(session_id, created_at);
+
+NOTIFY pgrst, 'reload schema';

package/migrations/db_setup_sqlite.sql

@@ -0,0 +1,66 @@
+-- hazo_llm_api — complete idempotent SQLite schema
+-- Run this once against a fresh database, or re-run safely on an existing one.
+-- All statements use IF NOT EXISTS guards.
+
+-- ---------------------------------------------------------------------------
+-- prompts_library
+-- Stores reusable prompt templates managed via the prompt-config UI.
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS prompts_library (
+  id                  TEXT PRIMARY KEY,
+  prompt_area         TEXT NOT NULL,
+  prompt_key          TEXT NOT NULL,
+  prompt_name         TEXT NOT NULL,
+  prompt_text_head    TEXT DEFAULT '',
+  prompt_text_body    TEXT NOT NULL,
+  prompt_text_tail    TEXT DEFAULT '',
+  prompt_variables    TEXT DEFAULT '[]',
+  prompt_notes        TEXT DEFAULT '',
+  created_at          TEXT NOT NULL DEFAULT (datetime('now')),
+  changed_by          TEXT DEFAULT NULL,
+  UNIQUE(prompt_area, prompt_key)
+);
+
+CREATE INDEX IF NOT EXISTS idx_prompts_area_key ON prompts_library(prompt_area, prompt_key);
+
+-- ---------------------------------------------------------------------------
+-- hazo_llm_api_log
+-- Per-call observability log written by the default afterResponse hook.
+-- Cost values are frozen per-row for accurate historical audit.
+-- ---------------------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS hazo_llm_api_log (
+  id                        TEXT PRIMARY KEY,
+  created_at                TEXT NOT NULL DEFAULT (datetime('now')),
+  service_type              TEXT NOT NULL,
+  provider                  TEXT NOT NULL,
+  model                     TEXT,
+  success                   INTEGER NOT NULL,
+  tokens_input              INTEGER,
+  tokens_output             INTEGER,
+  tokens_cached_input       INTEGER,
+  tokens_total              INTEGER,
+  cost_usd                  REAL,
+  pricing_kind              TEXT,
+  pricing_input_per_1m_usd  REAL,
+  pricing_output_per_1m_usd REAL,
+  pricing_per_image_usd     REAL,
+  latency_ms                INTEGER,
+  finish_reason             TEXT,
+  error_code                TEXT,
+  error_message             TEXT,
+  prompt_area               TEXT,
+  prompt_key                TEXT,
+  prompt_id                 TEXT,
+  session_id                TEXT,
+  reference                 TEXT,
+  attempts_count            INTEGER DEFAULT 1,
+  context_json              TEXT DEFAULT '{}'
+);
+
+CREATE INDEX IF NOT EXISTS idx_llm_log_created         ON hazo_llm_api_log(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_provider        ON hazo_llm_api_log(provider, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_success         ON hazo_llm_api_log(success, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_session         ON hazo_llm_api_log(session_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_service         ON hazo_llm_api_log(service_type, created_at DESC);
+-- Cost-cap index (session window queries, no DESC — matches cost_cap.ts usage)
+CREATE INDEX IF NOT EXISTS idx_llm_log_session_created ON hazo_llm_api_log(session_id, created_at);

package/migrations/hazo_llm_api_log.sql

@@ -0,0 +1,72 @@
+-- LEGACY: This file is superseded by db_setup_postgres.sql and db_setup_sqlite.sql.
+-- Kept for historical reference only.
+--
+-- hazo_llm_api_log: per-call observability log.
+-- Written by the default afterResponse hook (on by default; disable via api_log.enabled=false).
+-- Cost values are frozen per-row for accurate historical audit.
+--
+-- SQLite version (commented):
+-- CREATE TABLE IF NOT EXISTS hazo_llm_api_log (
+--   id                        TEXT PRIMARY KEY,
+--   created_at                TEXT NOT NULL DEFAULT (datetime('now')),
+--   service_type              TEXT NOT NULL,
+--   provider                  TEXT NOT NULL,
+--   model                     TEXT,
+--   success                   INTEGER NOT NULL,
+--   tokens_input              INTEGER,
+--   tokens_output             INTEGER,
+--   tokens_cached_input       INTEGER,
+--   tokens_total              INTEGER,
+--   cost_usd                  REAL,
+--   pricing_kind              TEXT,
+--   pricing_input_per_1m_usd  REAL,
+--   pricing_output_per_1m_usd REAL,
+--   pricing_per_image_usd     REAL,
+--   latency_ms                INTEGER,
+--   finish_reason             TEXT,
+--   error_code                TEXT,
+--   error_message             TEXT,
+--   prompt_area               TEXT,
+--   prompt_key                TEXT,
+--   prompt_id                 TEXT,
+--   session_id                TEXT,
+--   reference                 TEXT,
+--   attempts_count            INTEGER DEFAULT 1,
+--   context_json              TEXT DEFAULT '{}'
+-- );
+--
+-- PostgreSQL version (active):
+CREATE TABLE IF NOT EXISTS hazo_llm_api_log (
+  id                        UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  created_at                TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  service_type              TEXT NOT NULL,
+  provider                  TEXT NOT NULL,
+  model                     TEXT,
+  success                   BOOLEAN NOT NULL,
+  tokens_input              INTEGER,
+  tokens_output             INTEGER,
+  tokens_cached_input       INTEGER,
+  tokens_total              INTEGER,
+  cost_usd                  DOUBLE PRECISION,
+  pricing_kind              TEXT,
+  pricing_input_per_1m_usd  DOUBLE PRECISION,
+  pricing_output_per_1m_usd DOUBLE PRECISION,
+  pricing_per_image_usd     DOUBLE PRECISION,
+  latency_ms                INTEGER,
+  finish_reason             TEXT,
+  error_code                TEXT,
+  error_message             TEXT,
+  prompt_area               TEXT,
+  prompt_key                TEXT,
+  prompt_id                 UUID,
+  session_id                TEXT,
+  reference                 TEXT,
+  attempts_count            INTEGER DEFAULT 1,
+  context_json              JSONB DEFAULT '{}'::jsonb
+);
+
+CREATE INDEX IF NOT EXISTS idx_llm_log_created  ON hazo_llm_api_log(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_provider ON hazo_llm_api_log(provider, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_success  ON hazo_llm_api_log(success, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_session  ON hazo_llm_api_log(session_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_llm_log_service  ON hazo_llm_api_log(service_type, created_at DESC);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_llm_api",
-  "version": "1.2.13",
+  "version": "2.0.0",
   "description": "Wrapper to call different LLMs and includes prompt management",
   "keywords": [
     "LLM",
@@ -48,21 +48,22 @@
   },
   "files": [
     "dist",
+    "migrations",
     "README.md",
     "techdoc.md",
     "config/hazo_llm_api_config.ini"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && cp src/lib/pricing/pricing.json dist/lib/pricing/pricing.json",
     "dev:package": "tsc -p tsconfig.build.json --watch",
     "dev:test-app": "cd test-app && npm run dev",
     "build:test-app": "cd test-app && npm run build",
     "start:test-app": "cd test-app && npm start",
     "install:all": "npm install",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "node --experimental-vm-modules ../node_modules/jest/bin/jest.js --config jest.config.cjs",
+    "test:watch": "node --experimental-vm-modules ../node_modules/jest/bin/jest.js --config jest.config.cjs --watch"
   },
   "dependencies": {
-    "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "ini": "^6.0.0",
     "sql.js": "^1.10.0",
@@ -72,17 +73,24 @@
     "node": ">=18.0.0"
   },
   "peerDependencies": {
+    "class-variance-authority": "^0.7.1",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-checkbox": "^1.1.4",
     "@radix-ui/react-dialog": "^1.1.5",
     "@radix-ui/react-tooltip": "^1.1.7",
-    "hazo_ui": "^2.7.0",
+    "hazo_ui": "^3.0.1",
     "lucide-react": "^0.553.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "hazo_debug": "^2.0.0"
+    "hazo_core": "^1.0.0",
+    "hazo_debug": "^3.1.0",
+    "hazo_logs": "^2.0.0",
+    "hazo_jobs": "^0.12.0"
   },
   "peerDependenciesMeta": {
+    "class-variance-authority": {
+      "optional": true
+    },
     "@radix-ui/react-alert-dialog": {
       "optional": true
     },
@@ -109,15 +117,25 @@
     },
     "hazo_debug": {
       "optional": true
+    },
+    "hazo_logs": {
+      "optional": true
+    },
+    "hazo_jobs": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@types/ini": "^4.1.1",
+    "@types/jest": "^30.0.0",
     "@types/node": "^20.14.10",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "@types/sql.js": "^1.4.9",
+    "jest": "^30.2.0",
+    "jest-environment-node": "^30.2.0",
     "lucide-react": "^0.553.0",
+    "ts-jest": "^29.4.5",
     "typescript": "^5.7.2"
   }
 }