@ax-llm/ax 10.0.46 → 10.0.47

package/index.d.cts

@@ -8,79 +8,58 @@ interface RetryConfig {
     backoffFactor: number;
     retryableStatusCodes: number[];
 }
-/**
- * Base Error class with enhanced error tracking
- */
+interface RequestValidation {
+    validateRequest?: (request: unknown) => boolean | Promise<boolean>;
+}
+interface ResponseValidation {
+    validateResponse?: (response: unknown) => boolean | Promise<boolean>;
+}
+interface AxAPI {
+    name?: string;
+    headers?: Record<string, string>;
+    put?: boolean;
+}
+interface AxAPIConfig extends AxAPI, RequestValidation, ResponseValidation {
+    url: string | URL;
+    stream?: boolean;
+    debug?: boolean;
+    fetch?: typeof fetch;
+    span?: Span;
+    timeout?: number;
+    retry?: Partial<RetryConfig>;
+}
 declare class AxAIServiceError extends Error {
     readonly url: string;
     readonly requestBody?: unknown | undefined;
-    readonly context: Record<string, unknown>;
     readonly timestamp: string;
     readonly errorId: string;
+    readonly context: Record<string, unknown>;
     constructor(message: string, url: string, requestBody?: unknown | undefined, context?: Record<string, unknown>);
     toString(): string;
     toJSON(): Record<string, unknown>;
 }
-/**
- * HTTP Status Error with enhanced context
- */
 declare class AxAIServiceStatusError extends AxAIServiceError {
     readonly status: number;
     readonly statusText: string;
     constructor(status: number, statusText: string, url: string, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * Network/IO Error with enhanced context
- */
 declare class AxAIServiceNetworkError extends AxAIServiceError {
     readonly originalError: Error;
     constructor(originalError: Error, url: string, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * Response Processing Error with validation context
- */
 declare class AxAIServiceResponseError extends AxAIServiceError {
     constructor(message: string, url: string, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * Stream Terminated Error with enhanced context
- */
 declare class AxAIServiceStreamTerminatedError extends AxAIServiceError {
     readonly lastChunk?: unknown | undefined;
     constructor(url: string, requestBody?: unknown, lastChunk?: unknown | undefined, context?: Record<string, unknown>);
 }
-/**
- * Request timeout error
- */
 declare class AxAIServiceTimeoutError extends AxAIServiceError {
     constructor(url: string, timeoutMs: number, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * Authentication error
- */
 declare class AxAIServiceAuthenticationError extends AxAIServiceError {
     constructor(url: string, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * API Configuration interface
- */
-interface AxAPI {
-    name?: string;
-    headers?: Record<string, string>;
-    put?: boolean;
-}
-/**
- * Extended API Configuration
- */
-interface AxAPIConfig extends AxAPI {
-    url: string | URL;
-    stream?: boolean;
-    debug?: boolean;
-    fetch?: typeof fetch;
-    span?: Span;
-    timeout?: number;
-    retry?: Partial<RetryConfig>;
-}
 
 type AxAIModelMap = Record<string, string>;
 type AxModelInfo = {
@@ -551,8 +530,9 @@ declare class AxAIAnthropic extends AxBaseAI<AxAIAnthropicChatRequest, unknown,
 }
 
 declare enum AxAIOpenAIModel {
-    O1Preview = "o1-preview",
+    O1 = "o1",
     O1Mini = "o1-mini",
+    O3Mini = "o3-mini",
     GPT4 = "gpt-4",
     GPT4O = "gpt-4o",
     GPT4OMini = "gpt-4o-mini",
@@ -581,6 +561,8 @@ type AxAIOpenAIConfig = Omit<AxModelConfig, 'topK'> & {
     logprobs?: number;
     echo?: boolean;
     dimensions?: number;
+    reasoningEffort?: 'low' | 'medium' | 'high';
+    store?: boolean;
 };
 type AxAIOpenAILogprob = {
     tokens: string[];
@@ -608,6 +590,8 @@ interface AxAIOpenAIResponseDelta<T> {
 }
 type AxAIOpenAIChatRequest = {
     model: string;
+    reasoning_effort?: 'low' | 'medium' | 'high';
+    store?: boolean;
     messages: ({
         role: 'system';
         content: string;
@@ -1702,6 +1686,7 @@ declare class AxApacheTika {
  */
 type AxBalancerOptions = {
     comparator?: (a: AxAIService, b: AxAIService) => number;
+    debug?: boolean;
 };
 /**
  * Balancer that rotates through services.
@@ -1710,6 +1695,7 @@ declare class AxBalancer implements AxAIService {
     private services;
     private currentServiceIndex;
     private currentService;
+    private debug;
     constructor(services: readonly AxAIService[], options?: AxBalancerOptions);
     /**
      * Service comparator that respects the input order of services.

package/index.d.ts

@@ -8,79 +8,58 @@ interface RetryConfig {
     backoffFactor: number;
     retryableStatusCodes: number[];
 }
-/**
- * Base Error class with enhanced error tracking
- */
+interface RequestValidation {
+    validateRequest?: (request: unknown) => boolean | Promise<boolean>;
+}
+interface ResponseValidation {
+    validateResponse?: (response: unknown) => boolean | Promise<boolean>;
+}
+interface AxAPI {
+    name?: string;
+    headers?: Record<string, string>;
+    put?: boolean;
+}
+interface AxAPIConfig extends AxAPI, RequestValidation, ResponseValidation {
+    url: string | URL;
+    stream?: boolean;
+    debug?: boolean;
+    fetch?: typeof fetch;
+    span?: Span;
+    timeout?: number;
+    retry?: Partial<RetryConfig>;
+}
 declare class AxAIServiceError extends Error {
     readonly url: string;
     readonly requestBody?: unknown | undefined;
-    readonly context: Record<string, unknown>;
     readonly timestamp: string;
     readonly errorId: string;
+    readonly context: Record<string, unknown>;
     constructor(message: string, url: string, requestBody?: unknown | undefined, context?: Record<string, unknown>);
     toString(): string;
     toJSON(): Record<string, unknown>;
 }
-/**
- * HTTP Status Error with enhanced context
- */
 declare class AxAIServiceStatusError extends AxAIServiceError {
     readonly status: number;
     readonly statusText: string;
     constructor(status: number, statusText: string, url: string, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * Network/IO Error with enhanced context
- */
 declare class AxAIServiceNetworkError extends AxAIServiceError {
     readonly originalError: Error;
     constructor(originalError: Error, url: string, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * Response Processing Error with validation context
- */
 declare class AxAIServiceResponseError extends AxAIServiceError {
     constructor(message: string, url: string, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * Stream Terminated Error with enhanced context
- */
 declare class AxAIServiceStreamTerminatedError extends AxAIServiceError {
     readonly lastChunk?: unknown | undefined;
     constructor(url: string, requestBody?: unknown, lastChunk?: unknown | undefined, context?: Record<string, unknown>);
 }
-/**
- * Request timeout error
- */
 declare class AxAIServiceTimeoutError extends AxAIServiceError {
     constructor(url: string, timeoutMs: number, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * Authentication error
- */
 declare class AxAIServiceAuthenticationError extends AxAIServiceError {
     constructor(url: string, requestBody?: unknown, context?: Record<string, unknown>);
 }
-/**
- * API Configuration interface
- */
-interface AxAPI {
-    name?: string;
-    headers?: Record<string, string>;
-    put?: boolean;
-}
-/**
- * Extended API Configuration
- */
-interface AxAPIConfig extends AxAPI {
-    url: string | URL;
-    stream?: boolean;
-    debug?: boolean;
-    fetch?: typeof fetch;
-    span?: Span;
-    timeout?: number;
-    retry?: Partial<RetryConfig>;
-}
 
 type AxAIModelMap = Record<string, string>;
 type AxModelInfo = {
@@ -551,8 +530,9 @@ declare class AxAIAnthropic extends AxBaseAI<AxAIAnthropicChatRequest, unknown,
 }
 
 declare enum AxAIOpenAIModel {
-    O1Preview = "o1-preview",
+    O1 = "o1",
     O1Mini = "o1-mini",
+    O3Mini = "o3-mini",
     GPT4 = "gpt-4",
     GPT4O = "gpt-4o",
     GPT4OMini = "gpt-4o-mini",
@@ -581,6 +561,8 @@ type AxAIOpenAIConfig = Omit<AxModelConfig, 'topK'> & {
     logprobs?: number;
     echo?: boolean;
     dimensions?: number;
+    reasoningEffort?: 'low' | 'medium' | 'high';
+    store?: boolean;
 };
 type AxAIOpenAILogprob = {
     tokens: string[];
@@ -608,6 +590,8 @@ interface AxAIOpenAIResponseDelta<T> {
 }
 type AxAIOpenAIChatRequest = {
     model: string;
+    reasoning_effort?: 'low' | 'medium' | 'high';
+    store?: boolean;
     messages: ({
         role: 'system';
         content: string;
@@ -1702,6 +1686,7 @@ declare class AxApacheTika {
  */
 type AxBalancerOptions = {
     comparator?: (a: AxAIService, b: AxAIService) => number;
+    debug?: boolean;
 };
 /**
  * Balancer that rotates through services.
@@ -1710,6 +1695,7 @@ declare class AxBalancer implements AxAIService {
     private services;
     private currentServiceIndex;
     private currentService;
+    private debug;
     constructor(services: readonly AxAIService[], options?: AxBalancerOptions);
     /**
      * Service comparator that respects the input order of services.