hazo_llm_api 1.2.13 → 2.0.0

package/dist/lib/cascade/cascade_runner.js

@@ -0,0 +1,115 @@
+// file_description: Cascade runner — tries LLM providers in order until one succeeds
+import { LLM_ERROR_CODES } from '../llm_api/types.js';
+import { DEFAULT_CASCADE_ON_CODES } from './types.js';
+// =============================================================================
+// resolve_providers
+// =============================================================================
+/**
+ * Determine the ordered list of provider names to use.
+ * Precedence: per-call providers > init cascade providers > single_llm arg > primary_llm.
+ * An empty per_call array is treated as "not set" (falls through).
+ */
+export function resolve_providers(opts) {
+    const { per_call, init_cascade, single_llm, primary_llm } = opts;
+    if (per_call && per_call.length > 0) {
+        return per_call;
+    }
+    if (init_cascade?.providers && init_cascade.providers.length > 0) {
+        return init_cascade.providers;
+    }
+    if (single_llm) {
+        return [single_llm];
+    }
+    return [primary_llm];
+}
+// =============================================================================
+// run_with_cascade
+// =============================================================================
+/**
+ * Try each provider in order, returning the first successful response.
+ *
+ * Rules:
+ * - Success on first try → `attempts` is empty (no cascade record).
+ * - Cascadable error (RATE_LIMITED, NETWORK_ERROR, TIMEOUT, API_ERROR by default) →
+ *   record attempt, try next provider.
+ * - Non-cascadable error (config errors: PROVIDER_NOT_FOUND, API_KEY_MISSING, etc.) →
+ *   return immediately without trying more providers.
+ * - Timeout → treated as TIMEOUT error code, always cascadable.
+ * - All providers exhausted → return last error with all attempts recorded.
+ */
+export async function run_with_cascade(opts) {
+    const { providers, call_fn, cascade_on_codes = DEFAULT_CASCADE_ON_CODES, timeout_ms_per_attempt, logger, } = opts;
+    const attempts = [];
+    for (let i = 0; i < providers.length; i++) {
+        const provider = providers[i];
+        const provider_name = provider.get_name();
+        const is_last = i === providers.length - 1;
+        const t0 = Date.now();
+        let response;
+        try {
+            if (timeout_ms_per_attempt) {
+                response = await Promise.race([
+                    call_fn(provider),
+                    make_timeout_promise(timeout_ms_per_attempt, provider_name),
+                ]);
+            }
+            else {
+                response = await call_fn(provider);
+            }
+        }
+        catch (err) {
+            // Thrown exception: timeout or unhandled provider throw
+            const latency_ms = Date.now() - t0;
+            const error_code = err instanceof TimeoutError
+                ? LLM_ERROR_CODES.TIMEOUT
+                : LLM_ERROR_CODES.NETWORK_ERROR;
+            const error_msg = err instanceof Error ? err.message : String(err);
+            const attempt = { provider: provider_name, success: false, error_code, latency_ms };
+            if (!is_last && cascade_on_codes.includes(error_code)) {
+                logger.warn(`[cascade] ${provider_name} threw ${error_code} — trying next`, { provider: provider_name, error_code, latency_ms });
+                attempts.push(attempt);
+                continue;
+            }
+            return {
+                response: {
+                    success: false,
+                    error: error_msg,
+                    error_info: { code: error_code, message: error_msg, retryable: true },
+                },
+                attempts: [...attempts, attempt],
+            };
+        }
+        const latency_ms = Date.now() - t0;
+        if (response.success) {
+            return { response, attempts };
+        }
+        // Failed response
+        const error_code = response.error_info?.code ?? LLM_ERROR_CODES.UNKNOWN;
+        const is_cascadable = cascade_on_codes.includes(error_code);
+        if (!is_last && is_cascadable) {
+            logger.warn(`[cascade] ${provider_name} returned ${error_code} — trying next`, { provider: provider_name, error_code, latency_ms });
+            attempts.push({ provider: provider_name, success: false, error_code, latency_ms });
+            continue;
+        }
+        // Either last provider or non-cascadable error — return now
+        const final_attempts = is_last && attempts.length > 0
+            ? [...attempts, { provider: provider_name, success: false, error_code, latency_ms }]
+            : attempts;
+        return { response, attempts: final_attempts };
+    }
+    // Unreachable — loop always returns
+    return { response: { success: false, error: 'cascade: no providers' }, attempts };
+}
+// =============================================================================
+// Timeout helper
+// =============================================================================
+class TimeoutError extends Error {
+    constructor(provider, ms) {
+        super(`[cascade] provider "${provider}" timed out after ${ms}ms`);
+        this.name = 'TimeoutError';
+    }
+}
+function make_timeout_promise(ms, provider) {
+    return new Promise((_, reject) => setTimeout(() => reject(new TimeoutError(provider, ms)), ms));
+}
+//# sourceMappingURL=cascade_runner.js.map

package/dist/lib/cascade/cascade_runner.js.map

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

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

@@ -0,0 +1,5 @@
+export type { CascadeConfig } from './types.js';
+export { DEFAULT_CASCADE_ON_CODES } from './types.js';
+export { run_with_cascade, resolve_providers } from './cascade_runner.js';
+export type { CascadeRunOptions, CascadeRunResult, ResolveProvidersOptions } from './cascade_runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/cascade/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/cascade/index.js

@@ -0,0 +1,4 @@
+// file_description: Cascade module exports
+export { DEFAULT_CASCADE_ON_CODES } from './types.js';
+export { run_with_cascade, resolve_providers } from './cascade_runner.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/cascade/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/cascade/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAG3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,35 @@
+import type { LLMErrorCode } from '../llm_api/types.js';
+/**
+ * Cascade configuration — controls provider failover behavior.
+ *
+ * Precedence (highest to lowest):
+ *   1. per-call `params.providers`
+ *   2. `initialize_llm_api({ cascade })` config
+ *   3. `[llm_cascade]` ini section
+ *   4. no cascade (single primary provider)
+ */
+export interface CascadeConfig {
+    /**
+     * Ordered list of provider names to try. First is attempted first.
+     * If empty or unset, no cascade — uses primary provider.
+     */
+    providers?: string[];
+    /**
+     * Timeout per individual provider attempt in milliseconds.
+     * No timeout if not set.
+     */
+    timeout_ms_per_attempt?: number;
+    /**
+     * Error codes that permit cascade to the next provider.
+     * Defaults to: RATE_LIMITED, NETWORK_ERROR, TIMEOUT, API_ERROR.
+     */
+    cascade_on_codes?: LLMErrorCode[];
+}
+/**
+ * Default error codes that trigger cascade to the next provider.
+ * Only transient / server-side errors are included.
+ * Configuration errors (PROVIDER_NOT_FOUND, CAPABILITY_NOT_SUPPORTED, API_KEY_MISSING)
+ * are intentionally excluded — they won't succeed on retry.
+ */
+export declare const DEFAULT_CASCADE_ON_CODES: LLMErrorCode[];
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/cascade/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,YAAY,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,YAAY,EAKlD,CAAC"}

package/dist/lib/cascade/types.js

@@ -0,0 +1,14 @@
+// file_description: Cascade configuration and runner types for hazo_llm_api
+/**
+ * Default error codes that trigger cascade to the next provider.
+ * Only transient / server-side errors are included.
+ * Configuration errors (PROVIDER_NOT_FOUND, CAPABILITY_NOT_SUPPORTED, API_KEY_MISSING)
+ * are intentionally excluded — they won't succeed on retry.
+ */
+export const DEFAULT_CASCADE_ON_CODES = [
+    'RATE_LIMITED',
+    'NETWORK_ERROR',
+    'TIMEOUT',
+    'API_ERROR',
+];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/cascade/types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAiC5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmB;IACtD,cAAc;IACd,eAAe;IACf,SAAS;IACT,WAAW;CACZ,CAAC"}

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

@@ -5,4 +5,5 @@
  */
 export { type BaseGenerationConfig, type ParameterMapping, type GlobalLLMConfig, COMMON_PARAM_MAPPINGS, GEMINI_PARAM_MAPPINGS, QWEN_PARAM_MAPPINGS, find_config_file, read_config_file, parse_generation_config, parse_capabilities, parse_enabled_llms, load_api_key_from_env, get_api_key_env_var_name, get_llm_global_config, } from './config_parser.js';
 export { type BaseProviderConfig, type ProviderFactory, type ProviderLoadResult, register_provider_factory, get_provider_factory, get_registered_factory_names, load_provider_from_config, load_all_providers, } from './provider_loader.js';
+export { type HazoLLMApiConfig, getHazoLLMApiConfig, } from './llm_api_config.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAEpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EAEnB,gBAAgB,EAChB,gBAAgB,EAEhB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAElB,qBAAqB,EACrB,wBAAwB,EAExB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAEvB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAE5B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAEpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EAEnB,gBAAgB,EAChB,gBAAgB,EAEhB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAElB,qBAAqB,EACrB,wBAAwB,EAExB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAEvB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAE5B,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,gBAAgB,EAErB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/lib/config/index.js

@@ -19,4 +19,7 @@ export {
 register_provider_factory, get_provider_factory, get_registered_factory_names, 
 // Provider loading
 load_provider_from_config, load_all_providers, } from './provider_loader.js';
+export { 
+// Loader
+getHazoLLMApiConfig, } from './llm_api_config.js';
 //# sourceMappingURL=index.js.map

package/dist/lib/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO;AAKL,qBAAqB;AACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB;AACnB,wBAAwB;AACxB,gBAAgB,EAChB,gBAAgB;AAChB,oBAAoB;AACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB;AAClB,wBAAwB;AACxB,qBAAqB,EACrB,wBAAwB;AACxB,gBAAgB;AAChB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO;AAKL,uBAAuB;AACvB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B;AAC5B,mBAAmB;AACnB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO;AAKL,qBAAqB;AACrB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB;AACnB,wBAAwB;AACxB,gBAAgB,EAChB,gBAAgB;AAChB,oBAAoB;AACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB;AAClB,wBAAwB;AACxB,qBAAqB,EACrB,wBAAwB;AACxB,gBAAgB;AAChB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO;AAKL,uBAAuB;AACvB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B;AAC5B,mBAAmB;AACnB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO;AAGL,SAAS;AACT,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/lib/config/llm_api_config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Zod-validated config loader for hazo_llm_api.
+ *
+ * Covers the standard/global sections ([llm] and [log.overrides]).
+ * Provider-specific sections ([llm_gemini], [llm_qwen], etc.) are still
+ * parsed by the existing config_parser.ts / llm_api/index.ts path — this
+ * module only adds a validated overlay for the sections hazo_core knows about.
+ */
+import { z } from 'zod';
+declare const HazoLLMApiConfigSchema: z.ZodObject<{
+    llm: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+        enabled_llms: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string[], string | undefined>>;
+        primary_llm: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        sqlite_path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>>, z.ZodTransform<{
+        enabled_llms: string[];
+        primary_llm: string;
+        sqlite_path: string;
+    }, {
+        enabled_llms: string[];
+        primary_llm: string;
+        sqlite_path: string;
+    } | undefined>>;
+    log: z.ZodPipe<z.ZodOptional<z.ZodObject<{
+        overrides: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>>, z.ZodTransform<{
+        overrides: Record<string, string>;
+    }, {
+        overrides: Record<string, string>;
+    } | undefined>>;
+}, z.core.$strip>;
+export type HazoLLMApiConfig = z.infer<typeof HazoLLMApiConfigSchema>;
+/**
+ * Load and validate the hazo_llm_api config using hazo_core's loadConfig.
+ *
+ * Reads `config/hazo_llm_api_config.ini` relative to process.cwd(),
+ * applies any `HAZO_LLM_API_<SECTION>_<KEY>` env-var overrides, and
+ * validates the result with the Zod schema above.
+ */
+export declare function getHazoLLMApiConfig(): HazoLLMApiConfig;
+export {};
+//# sourceMappingURL=llm_api_config.d.ts.map

package/dist/lib/config/llm_api_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm_api_config.d.ts","sourceRoot":"","sources":["../../../src/lib/config/llm_api_config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;iBAkB1B,CAAC;AAMH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAMtE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}

package/dist/lib/config/llm_api_config.js

@@ -0,0 +1,49 @@
+/**
+ * Zod-validated config loader for hazo_llm_api.
+ *
+ * Covers the standard/global sections ([llm] and [log.overrides]).
+ * Provider-specific sections ([llm_gemini], [llm_qwen], etc.) are still
+ * parsed by the existing config_parser.ts / llm_api/index.ts path — this
+ * module only adds a validated overlay for the sections hazo_core knows about.
+ */
+import { z } from 'zod';
+import { loadConfig } from 'hazo_core';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const HazoLLMApiConfigSchema = z.object({
+    llm: z
+        .object({
+        enabled_llms: z
+            .string()
+            .optional()
+            .transform((v) => (v ? v.split(',').map((s) => s.trim()) : ['gemini'])),
+        primary_llm: z.string().optional().default('gemini'),
+        sqlite_path: z.string().optional().default('prompt_library.sqlite'),
+    })
+        .optional()
+        .transform((v) => v ?? { enabled_llms: ['gemini'], primary_llm: 'gemini', sqlite_path: 'prompt_library.sqlite' }),
+    log: z
+        .object({
+        overrides: z.record(z.string(), z.string()).optional().default({}),
+    })
+        .optional()
+        .transform((v) => v ?? { overrides: {} }),
+});
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+/**
+ * Load and validate the hazo_llm_api config using hazo_core's loadConfig.
+ *
+ * Reads `config/hazo_llm_api_config.ini` relative to process.cwd(),
+ * applies any `HAZO_LLM_API_<SECTION>_<KEY>` env-var overrides, and
+ * validates the result with the Zod schema above.
+ */
+export function getHazoLLMApiConfig() {
+    return loadConfig({
+        pkg: 'hazo_llm_api',
+        schema: HazoLLMApiConfigSchema,
+    });
+}
+//# sourceMappingURL=llm_api_config.js.map

package/dist/lib/config/llm_api_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm_api_config.js","sourceRoot":"","sources":["../../../src/lib/config/llm_api_config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;QACpD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC;KACpE,CAAC;SACD,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACnH,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACnE,CAAC;SACD,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;CAC5C,CAAC,CAAC;AAQH,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAmB;QAClC,GAAG,EAAE,cAAc;QACnB,MAAM,EAAE,sBAA+B;KACxC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/cost_cap/cost_cap.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Cost Cap Gate
+ *
+ * Pre-call gate that checks the accumulated cost for the current session
+ * against a configured cap. Returns a COST_LIMIT_EXCEEDED error response
+ * when the cap is reached (block mode) or fires a warn hook and proceeds
+ * (warn mode).
+ *
+ * Requires:
+ * - hazo_llm_api_log table to exist (ensure_api_log_table must be called first)
+ * - A session_id available via hazo_logs ALS (safe_get_log_context)
+ * - cost_cap.enabled = true in LLMApiConfig
+ */
+import type { Logger, LLMResponse, CostCapConfig } from '../llm_api/types.js';
+import type { HazoConnect } from '../hazo_connect/types.js';
+/**
+ * Ensure the session_id + created_at composite index exists on hazo_llm_api_log.
+ * Idempotent — safe to call on every initialization.
+ * Errors are swallowed to avoid crashing initialization.
+ */
+export declare function ensure_cost_cap_index(connect: HazoConnect, logger: Logger): Promise<void>;
+/**
+ * Query the total cost_usd accumulated for a session within the given window.
+ *
+ * Returns 0 if connect has no raw_sql, if there are no matching rows, or if
+ * any DB error occurs (errors are swallowed).
+ */
+export declare function query_session_cost(connect: HazoConnect, session_id: string, window_start: string, logger: Logger): Promise<number>;
+/**
+ * Pre-call cost cap gate.
+ *
+ * Returns:
+ * - `null`         if the gate should not block (cap disabled, no session, current < cap, or warn mode)
+ * - `LLMResponse`  if the call should be blocked (block mode, cap exceeded)
+ *
+ * In warn mode the `cost_cap_exceeded` hook is called (errors swallowed) and null is returned
+ * so the call proceeds.
+ */
+export declare function check_cost_cap_gate(connect: HazoConnect | null, cap_config: CostCapConfig | undefined, logger: Logger): Promise<LLMResponse | null>;
+//# sourceMappingURL=cost_cap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost_cap.d.ts","sourceRoot":"","sources":["../../../src/lib/cost_cap/cost_cap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA+B5D;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,UAAU,EAAE,aAAa,GAAG,SAAS,EACrC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAoE7B"}

package/dist/lib/cost_cap/cost_cap.js

@@ -0,0 +1,150 @@
+/**
+ * Cost Cap Gate
+ *
+ * Pre-call gate that checks the accumulated cost for the current session
+ * against a configured cap. Returns a COST_LIMIT_EXCEEDED error response
+ * when the cap is reached (block mode) or fires a warn hook and proceeds
+ * (warn mode).
+ *
+ * Requires:
+ * - hazo_llm_api_log table to exist (ensure_api_log_table must be called first)
+ * - A session_id available via hazo_logs ALS (safe_get_log_context)
+ * - cost_cap.enabled = true in LLMApiConfig
+ */
+import { build_error_response } from '../llm_api/provider_helper.js';
+import { LLM_ERROR_CODES } from '../llm_api/types.js';
+import { safe_get_log_context } from '../observability/log_context.js';
+// =============================================================================
+// Internal Helpers
+// =============================================================================
+/**
+ * Compute the window_start timestamp string for the rolling window.
+ *
+ * - 'day':     rolling 24 hours
+ * - 'hour':    rolling 1 hour
+ * - 'session': epoch (all records for this session regardless of age)
+ */
+function get_window_start(window = 'session') {
+    if (window === 'day') {
+        return new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+    }
+    if (window === 'hour') {
+        return new Date(Date.now() - 60 * 60 * 1000).toISOString();
+    }
+    // 'session': use epoch to capture all records for this session
+    return '1970-01-01T00:00:00.000Z';
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Ensure the session_id + created_at composite index exists on hazo_llm_api_log.
+ * Idempotent — safe to call on every initialization.
+ * Errors are swallowed to avoid crashing initialization.
+ */
+export async function ensure_cost_cap_index(connect, logger) {
+    if (!connect.raw_sql) {
+        return;
+    }
+    try {
+        await connect.raw_sql('CREATE INDEX IF NOT EXISTS idx_llm_log_session_created ON hazo_llm_api_log(session_id, created_at)');
+    }
+    catch (err) {
+        logger.warn('ensure_cost_cap_index: failed to create index (non-fatal)', {
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+/**
+ * Query the total cost_usd accumulated for a session within the given window.
+ *
+ * Returns 0 if connect has no raw_sql, if there are no matching rows, or if
+ * any DB error occurs (errors are swallowed).
+ */
+export async function query_session_cost(connect, session_id, window_start, logger) {
+    if (!connect.raw_sql) {
+        return 0;
+    }
+    try {
+        const rows = await connect.raw_sql('SELECT COALESCE(SUM(cost_usd), 0) AS total FROM hazo_llm_api_log WHERE session_id = ? AND created_at >= ?', [session_id, window_start]);
+        if (!rows || rows.length === 0) {
+            return 0;
+        }
+        const total = rows[0].total;
+        return typeof total === 'number' ? total : Number(total) || 0;
+    }
+    catch (err) {
+        logger.warn('query_session_cost: failed to query cost (non-fatal)', {
+            session_id,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return 0;
+    }
+}
+/**
+ * Pre-call cost cap gate.
+ *
+ * Returns:
+ * - `null`         if the gate should not block (cap disabled, no session, current < cap, or warn mode)
+ * - `LLMResponse`  if the call should be blocked (block mode, cap exceeded)
+ *
+ * In warn mode the `cost_cap_exceeded` hook is called (errors swallowed) and null is returned
+ * so the call proceeds.
+ */
+export async function check_cost_cap_gate(connect, cap_config, logger) {
+    // Skip if cap is not configured or not enabled
+    if (!cap_config || cap_config.enabled !== true) {
+        return null;
+    }
+    // Skip if no connect available
+    if (!connect) {
+        return null;
+    }
+    // Get session_id from ALS context
+    const log_ctx = await safe_get_log_context();
+    const session_id = log_ctx?.sessionId;
+    if (!session_id) {
+        return null;
+    }
+    // Compute window start
+    const window_start = get_window_start(cap_config.window ?? 'session');
+    // Query accumulated cost
+    const current_usd = await query_session_cost(connect, session_id, window_start, logger);
+    // Get cap for this session
+    let cap_usd;
+    try {
+        cap_usd = await cap_config.get_user_cap({ session_id });
+    }
+    catch (err) {
+        logger.warn('check_cost_cap_gate: get_user_cap threw (non-fatal, skipping cap check)', {
+            session_id,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+    // Skip enforcement if cap is 0 or negative
+    if (cap_usd <= 0) {
+        return null;
+    }
+    // Under cap — proceed
+    if (current_usd < cap_usd) {
+        return null;
+    }
+    // Cap exceeded — handle according to mode
+    const mode = cap_config.on_exceeded ?? 'block';
+    if (mode === 'warn') {
+        // Fire the warn hook (errors swallowed), then proceed
+        if (cap_config.cost_cap_exceeded) {
+            try {
+                await cap_config.cost_cap_exceeded({ session_id, current_usd, cap_usd });
+            }
+            catch {
+                // Swallow hook errors
+            }
+        }
+        return null; // Proceed with the call
+    }
+    // Default: block mode — return error response
+    return build_error_response(LLM_ERROR_CODES.COST_LIMIT_EXCEEDED, `Cost cap exceeded: $${current_usd.toFixed(6)} spent of $${cap_usd.toFixed(6)} limit`, false, { session_id, current_usd, cap_usd });
+}
+//# sourceMappingURL=cost_cap.js.map

package/dist/lib/cost_cap/cost_cap.js.map

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

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

@@ -0,0 +1,3 @@
+export type { CostCapConfig } from '../llm_api/types.js';
+export { check_cost_cap_gate, query_session_cost, ensure_cost_cap_index, } from './cost_cap.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/cost_cap/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,eAAe,CAAC"}

package/dist/lib/cost_cap/index.js

@@ -0,0 +1,2 @@
+export { check_cost_cap_gate, query_session_cost, ensure_cost_cap_index, } from './cost_cap.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/cost_cap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/cost_cap/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,eAAe,CAAC"}

package/dist/lib/database/init_api_log.d.ts

@@ -0,0 +1,10 @@
+import type { HazoConnect } from "../hazo_connect/types.js";
+import type { Logger } from "../llm_api/types.js";
+/**
+ * Idempotently create the hazo_llm_api_log table + its indexes on the active connection.
+ * Detects dialect from the connect adapter and runs the matching DDL.
+ *
+ * Safe to call on every initialize_llm_api() — if the table exists, this is a no-op.
+ */
+export declare function ensure_api_log_table(connect: HazoConnect, logger: Logger): Promise<void>;
+//# sourceMappingURL=init_api_log.d.ts.map

package/dist/lib/database/init_api_log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init_api_log.d.ts","sourceRoot":"","sources":["../../../src/lib/database/init_api_log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuF9F"}