@zhivex-ai/gateway 0.3.0 → 0.3.1-next.0

package/dist/types.d.ts

@@ -1,8 +1,12 @@
-import type { GenerateObjectOutput, GenerateTextOutput, ModelCatalog, ProviderAdapter, ReasoningConfig, StreamObjectResult, StreamTextResult, TokenUsage, ToolChoice, ToolExecutionOptions, ToolSet } from "@zhivex-ai/core";
+import type { AgentStepType, GenerateObjectOutput, GenerateTextOutput, GroundedLanguageModel, ModelCapabilities, ModelCatalog, LanguageModel, ProviderAdapter, ReasoningConfig, StreamObjectResult, StreamTextResult, TokenUsage, ToolChoice, ToolExecutionOptions, ToolSet } from "@zhivex-ai/core";
 import type { ZodTypeAny } from "zod";
 export type GatewayProviderId = "openai" | "anthropic" | "gemini" | "vertex" | "qwen" | "kimi" | "bedrock" | "ollama" | "azure-openai" | "openrouter";
 export type GatewayRoutingMode = "speed" | "balanced" | "quality";
 export type GatewayTaskIntent = "chat" | "reasoning" | "tool-heavy";
+export type GatewayCostStrategy = "strict" | "prefer-cheaper" | "ignore";
+export type GatewaySkipReason = "missing-adapter" | "capabilities" | "cost" | "cooldown" | "latency-budget";
+export type GatewayCircuitState = "closed" | "open" | "half-open";
+export type GatewayErrorClass = "timeout" | "rate-limit" | "connectivity" | "provider" | "validation" | "unknown";
 export interface GatewayImageAttachment {
     dataUrl: string;
     mimeType: string;
@@ -16,6 +20,13 @@ export interface GatewayModelTarget {
     provider: GatewayProviderId;
     modelId: string;
 }
+export type GatewayRequiredCapabilities = Partial<Record<"streaming" | "tools" | "structuredOutput" | "jsonMode" | "vision" | "reasoning" | "webSearch", boolean>>;
+export interface GatewayRetryPolicyOverride {
+    maxRetries?: number;
+    backoffMs?: number;
+    cooldownAfterRetryableFailures?: number;
+    cooldownMs?: number;
+}
 export interface GatewayRequest {
     messages: GatewayMessage[];
     systemPrompt?: string;
@@ -27,21 +38,191 @@ export interface GatewayRequest {
     maxSteps?: number;
     reasoning?: ReasoningConfig;
     providerOptions?: Record<string, unknown>;
-    requiredCapabilities?: Partial<Record<"streaming" | "tools" | "structuredOutput" | "jsonMode" | "vision" | "reasoning", boolean>>;
+    requiredCapabilities?: GatewayRequiredCapabilities;
     maxCostPer1kTokens?: number;
     routingMode?: GatewayRoutingMode;
     taskIntent?: GatewayTaskIntent;
+    stepType?: AgentStepType;
     abortSignal?: AbortSignal;
     primary: GatewayModelTarget;
     fallbacks?: GatewayModelTarget[];
+    latencyBudgetMs?: number;
+    costStrategy?: GatewayCostStrategy;
+    retryPolicy?: GatewayRetryPolicyOverride;
+    allowDegradedCapabilities?: boolean;
+    preferLocal?: boolean;
 }
 export interface GatewayAttempt {
     provider: GatewayProviderId;
     modelId: string;
     ok: boolean;
     latencyMs: number;
+    retry: number;
+    targetRank: number;
     errorMessage?: string;
+    retryable?: boolean;
+    skipReason?: GatewaySkipReason;
+}
+export interface GatewayTargetRuntimeState {
+    targetKey: string;
+    provider: GatewayProviderId;
+    modelId: string;
+    circuitState: GatewayCircuitState;
+    requestCount: number;
+    successCount: number;
+    failureCount: number;
+    retryableFailureCount: number;
+    nonRetryableFailureCount: number;
+    consecutiveFailures: number;
+    consecutiveRetryableFailures: number;
+    consecutiveErrorClass?: GatewayErrorClass;
+    lastLatencyMs?: number;
+    avgLatencyMs?: number;
+    latencyEwmaMs?: number;
+    latencyP95Ms?: number;
+    recentLatenciesMs: number[];
+    lastErrorMessage?: string;
+    lastErrorClass?: GatewayErrorClass;
+    errorCounts: Partial<Record<GatewayErrorClass, number>>;
+    cooldownUntil?: number;
+    createdAt: number;
+    lastUpdatedAt: number;
+    expiresAt?: number;
+}
+export interface GatewayRuntimeStore {
+    get(targetKey: string): GatewayTargetRuntimeState | undefined | Promise<GatewayTargetRuntimeState | undefined>;
+    set(targetKey: string, state: GatewayTargetRuntimeState): void | Promise<void>;
+    update(targetKey: string, updater: (state: GatewayTargetRuntimeState | undefined) => GatewayTargetRuntimeState): GatewayTargetRuntimeState | Promise<GatewayTargetRuntimeState>;
+    list?(): GatewayTargetRuntimeState[] | Promise<GatewayTargetRuntimeState[]>;
+    delete?(targetKey: string): void | Promise<void>;
+    clear?(): void | Promise<void>;
+    prune?(): number | Promise<number>;
+}
+export interface GatewayRetryErrorInfo {
+    message: string;
+    retryable: boolean;
+    errorClass: GatewayErrorClass;
+}
+export interface GatewayRetryPolicyContext {
+    request: GatewayRequest;
+    target: GatewayModelTarget;
+    state?: GatewayTargetRuntimeState;
+    retry: number;
+    targetRank: number;
+    error: GatewayRetryErrorInfo;
+}
+export interface GatewayRetryPolicy {
+    name: string;
+    classifyError(error: unknown): GatewayRetryErrorInfo;
+    shouldRetry(context: GatewayRetryPolicyContext): boolean;
+    getBackoffMs(context: GatewayRetryPolicyContext): number;
+    getCooldownMs(context: GatewayRetryPolicyContext): number;
+}
+export interface GatewayEvaluatedTarget {
+    target: GatewayModelTarget;
+    score: number;
+    available: boolean;
+    estimatedCostPer1kTokens?: number;
+    degradedCapabilities?: Array<keyof GatewayRequiredCapabilities>;
+    skipReason?: GatewaySkipReason;
+    state?: GatewayTargetRuntimeState;
+}
+export interface GatewayRouteDecision {
+    mode: GatewayRoutingMode;
+    intent: GatewayTaskIntent;
+    policy: string;
+    orderedTargets: GatewayModelTarget[];
+    evaluatedTargets: GatewayEvaluatedTarget[];
+    reason: string;
+}
+export interface GatewayResolvedModel {
+    target: GatewayModelTarget;
+    routeDecision: GatewayRouteDecision;
+    model: LanguageModel | GroundedLanguageModel;
+    kind: "language" | "grounded";
+}
+export interface GatewayRoutePlanningContext {
+    request: GatewayRequest;
+    targets: GatewayModelTarget[];
+    requiredCapabilities: GatewayRequiredCapabilities;
+    adapters: Partial<Record<GatewayProviderId, ProviderAdapter>>;
+    runtimeStates: Map<string, GatewayTargetRuntimeState | undefined>;
+    modelCatalog?: ModelCatalog;
+    providerCostsPer1kTokens?: Partial<Record<GatewayProviderId, number>>;
+    latencyBiasMs?: Partial<Record<GatewayProviderId, number>>;
+    now: number;
+}
+export interface GatewayRouterPolicy {
+    name: string;
+    plan(context: GatewayRoutePlanningContext): GatewayRouteDecision | Promise<GatewayRouteDecision>;
+}
+export interface GatewayAttemptStartedEvent {
+    type: "attempt-started";
+    request: GatewayRequest;
+    target: GatewayModelTarget;
+    retry: number;
+    targetRank: number;
+    timestamp: number;
+}
+export interface GatewayAttemptSucceededEvent {
+    type: "attempt-succeeded";
+    request: GatewayRequest;
+    target: GatewayModelTarget;
+    retry: number;
+    targetRank: number;
+    timestamp: number;
+    latencyMs: number;
+}
+export interface GatewayAttemptFailedEvent {
+    type: "attempt-failed";
+    request: GatewayRequest;
+    target: GatewayModelTarget;
+    retry: number;
+    targetRank: number;
+    timestamp: number;
+    latencyMs: number;
+    errorMessage: string;
+    retryable: boolean;
+    errorClass: GatewayErrorClass;
+}
+export interface GatewayAttemptRetriedEvent {
+    type: "attempt-retried";
+    request: GatewayRequest;
+    target: GatewayModelTarget;
+    retry: number;
+    targetRank: number;
+    timestamp: number;
+    delayMs: number;
 }
+export interface GatewayTargetSkippedEvent {
+    type: "target-skipped";
+    request: GatewayRequest;
+    target: GatewayModelTarget;
+    targetRank: number;
+    timestamp: number;
+    reason: GatewaySkipReason;
+}
+export interface GatewayRouteSelectedEvent {
+    type: "route-selected";
+    request: GatewayRequest;
+    timestamp: number;
+    decision: GatewayRouteDecision;
+}
+export interface GatewayTargetCooledDownEvent {
+    type: "target-cooled-down";
+    request: GatewayRequest;
+    target: GatewayModelTarget;
+    timestamp: number;
+    cooldownUntil: number;
+}
+export interface GatewayRouteFailedEvent {
+    type: "route-failed";
+    request: GatewayRequest;
+    timestamp: number;
+    attempts: GatewayAttempt[];
+    errorMessage: string;
+}
+export type GatewayEvent = GatewayAttemptStartedEvent | GatewayAttemptSucceededEvent | GatewayAttemptFailedEvent | GatewayAttemptRetriedEvent | GatewayTargetSkippedEvent | GatewayRouteSelectedEvent | GatewayTargetCooledDownEvent | GatewayRouteFailedEvent;
 export interface GatewayResponse {
     text: string;
     finishReason?: GenerateTextOutput["finishReason"];
@@ -53,12 +234,7 @@ export interface GatewayResponse {
     usage: TokenUsage & {
         estimated: boolean;
     };
-    routeDecision: {
-        mode: GatewayRoutingMode;
-        intent: GatewayTaskIntent;
-        orderedTargets: GatewayModelTarget[];
-        reason: string;
-    };
+    routeDecision: GatewayRouteDecision;
     steps: GenerateTextOutput["steps"];
     messages: GenerateTextOutput["messages"];
     toolResults: GenerateTextOutput["toolResults"];
@@ -81,21 +257,25 @@ export interface GatewayStreamObjectResult<TSchema extends ZodTypeAny> extends O
 }
 export interface GatewayConfig {
     adapters: Partial<Record<GatewayProviderId, ProviderAdapter>>;
-    groundedAdapters?: Partial<Record<GatewayProviderId, Pick<ProviderAdapter, "groundedLanguageModel">>>;
     modelCatalog?: ModelCatalog;
     providerCostsPer1kTokens?: Partial<Record<GatewayProviderId, number>>;
     latencyBiasMs?: Partial<Record<GatewayProviderId, number>>;
-    maxRetries?: number;
     attemptTimeoutMs?: number;
     attemptTimeoutsMs?: Partial<Record<GatewayProviderId, number>>;
+    runtimeStore?: GatewayRuntimeStore;
+    routerPolicy?: GatewayRouterPolicy;
+    retryPolicy?: GatewayRetryPolicy;
+    onAttempt?: (attempt: GatewayAttempt) => void | Promise<void>;
+    onEvent?: (event: GatewayEvent) => void | Promise<void>;
+    maxRetries?: number;
     retryBackoffMs?: number;
-    onAttempt?: (attempt: GatewayAttempt & {
-        retry: number;
-        targetRank: number;
-    }) => void | Promise<void>;
+    now?: () => number;
 }
 export declare class GatewayError extends Error {
     readonly retryable: boolean;
     constructor(message: string, retryable: boolean);
 }
+export declare const gatewayCapabilityKeys: readonly ["streaming", "tools", "structuredOutput", "jsonMode", "vision", "reasoning", "webSearch"];
+export type GatewayCapabilityKey = (typeof gatewayCapabilityKeys)[number];
+export declare const toCapabilityMismatch: (capabilities: ModelCapabilities, requiredCapabilities: GatewayRequiredCapabilities) => GatewayCapabilityKey[];
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -6,4 +6,14 @@ export class GatewayError extends Error {
         this.name = "GatewayError";
     }
 }
+export const gatewayCapabilityKeys = [
+    "streaming",
+    "tools",
+    "structuredOutput",
+    "jsonMode",
+    "vision",
+    "reasoning",
+    "webSearch"
+];
+export const toCapabilityMismatch = (capabilities, requiredCapabilities) => gatewayCapabilityKeys.filter((key) => requiredCapabilities[key] === true && capabilities[key] !== true);
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkIA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG1B;IAFX,YACE,OAAe,EACN,SAAkB;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,cAAS,GAAT,SAAS,CAAS;QAG3B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA2VA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG1B;IAFX,YACE,OAAe,EACN,SAAkB;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,cAAS,GAAT,SAAS,CAAS;QAG3B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW;IACX,OAAO;IACP,kBAAkB;IAClB,UAAU;IACV,QAAQ;IACR,WAAW;IACX,WAAW;CACwD,CAAC;AAItE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,YAA+B,EAC/B,oBAAiD,EACzB,EAAE,CAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhivex-ai/gateway",
-  "version": "0.3.0",
+  "version": "0.3.1-next.0",
   "description": "Routing and fallback helpers for Zhivex AI SDK.",
   "license": "MIT",
   "type": "module",
@@ -41,6 +41,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@zhivex-ai/core": "^0.4.0"
+    "@zhivex-ai/core": "^0.5.0-next.0"
   }
 }