vern-llm 3.0.0 → 3.1.0

package/dist/index.d.cts

@@ -1,5 +1,4 @@
-import { $ as SchemaLike, $t as createStateKey, A as ConditionalToolCallParams, At as ConsecutiveTripping, B as ThinkingBlock, Bt as MiddlewareRef, C as CachedConditionalToolCallParams, Cn as hasIssues, Ct as RetryBudgetOptions, D as CallContext, Dt as CircuitBreakerOptions, E as CachedToolCallParams, Et as CircuitBreakerCallContext, F as JsonModeDisabledCallParams, Ft as AttemptContext, G as ToolCall, Gt as RequiredMiddlewareRef, H as ToolsDisabledCallParams, Ht as MiddlewareStateEntry, I as JsonModeEnabledCallParams, It as CallResult, J as ToolDefinition, Jt as WireCallRequestPatch, K as ToolCallResult, Kt as VernLLMMiddleware, L as JsonValue, Lt as MiddlewareCapabilities, M as ConversationTurn, Mt as ExponentialBackoffOptions, N as DetectSoftFailure, Nt as RollingTripping, O as CallParams, Ot as CircuitBreakerStateChangeHandler, P as ImageBlock, Pt as TrippingPolicy, Q as JsonSchemaSpec, Qt as createMiddlewareStateBag, R as LLMRequestShape, Rt as MiddlewareContext, S as CachedConditionalStringToolCallParams, Sn as UnsupportedCapabilityIssue, St as RetryBudget, T as CachedJsonModeEnabledCallParams, Tt as CircuitBreakerAdapter, U as CallWithToolsResult, Ut as MiddlewareStateKey, V as ToolEnabledCallParams, Vt as MiddlewareStateBag, W as ContentResult, Wt as PreDispatchContext, X as defineTool, Xt as WireTool, Y as ToolResult, Yt as WireResponseFormat, Z as isToolCallResult, Zt as createMiddlewareRef, _ as StreamJsonModeEnabledCallParams, _n as LLMErrorType, _t as RateLimiter, a as WireToolChoice, an as OnUsageFailure, at as FallbackOnContext, b as AssistantContent, bn as ToolIssue, c as CachedStreamConditionalToolCallParams, cn as TokenUsage, ct as TargetInfo, d as CachedStreamToolCallParams, dn as DuplicateToolNamesIssue, dt as metaRef, en as requireRef, et as CallMeta, f as StreamCallResult, fn as HistoryToolResultIssue, ft as RateLimitOption, g as StreamJsonModeDisabledCallParams, gn as LLMErrorSnapshot, gt as RateLimitState, h as StreamEnabledCallParams, hn as LLMErrorIssuesByCode, ht as RateLimitReason, i as WireToolCall, in as OnUsage, it as FallbackOn, j as ContentBlock, jt as CooldownBackoff, k as ConditionalStringToolCallParams, kt as CircuitState, l as CachedStreamJsonModeDisabledCallParams, ln as ConsoleLogger, lt as defaultFallbackOn, m as StreamConditionalStringToolCallParams, mn as LLMErrorCode, mt as RateLimitOptions, n as LLMClient, nn as OnEvent, nt as FallbackAttempt, o as CachedStreamCallParams, on as RefundUsage, ot as FallbackTarget, p as StreamChunk, pn as LLMError, pt as RateLimitAcquireResult, q as ToolChoice, qt as WireCallRequest, r as WireMessage, rn as VernLLMEvent, rt as FallbackExhaustedError, s as CachedStreamConditionalStringToolCallParams, sn as ReserveUsage, st as TargetCircuitState, t as AdapterInfo, tn as stateEntry, tt as CircuitTarget, u as CachedStreamJsonModeEnabledCallParams, un as Logger, ut as isFallbackExhaustedError, v as WireStreamChunk, vn as LLMRequestSnapshot, vt as RateLimiterAdapter, w as CachedJsonModeDisabledCallParams, wn as isLLMError, wt as CircuitBreaker, x as CachedCallParams, xn as UnknownToolChoiceIssue, xt as CircuitBreakerOption, y as isStreamResult, yn as RetryAttempt, yt as WireRequest, z as TextBlock, zt as MiddlewareContextBase } from "./client-HWxkwVvj.cjs";
-//#region src/types/cache.d.ts
+import { $ as SchemaLike, $t as WireResponseFormat, A as ConditionalToolCallParams, An as isLLMError, At as CircuitBreakerCallContext, B as ThinkingBlock, Bt as CallResult, C as CachedConditionalToolCallParams, Cn as LLMErrorType, Ct as RateLimiter, D as CallContext, Dn as UnknownToolChoiceIssue, Dt as CircuitBreakerOption, E as CachedToolCallParams, En as ToolIssue, F as JsonModeDisabledCallParams, Ft as CooldownBackoff, G as ToolCall, Gt as MiddlewareStateBag, H as ToolsDisabledCallParams, Ht as MiddlewareContext, I as JsonModeEnabledCallParams, It as ExponentialBackoffOptions, J as ToolDefinition, Jt as PreDispatchContext, K as ToolCallResult, Kt as MiddlewareStateEntry, L as JsonValue, Lt as RollingTripping, M as ConversationTurn, Mt as CircuitBreakerStateChangeHandler, N as DetectSoftFailure, Nt as CircuitState, O as CallParams, On as UnsupportedCapabilityIssue, Ot as CircuitBreaker, P as ImageBlock, Pt as ConsecutiveTripping, Q as JsonSchemaSpec, Qt as WireCallRequestPatch, R as LLMRequestShape, Rt as TrippingPolicy, S as CachedConditionalStringToolCallParams, Sn as LLMErrorSnapshot, St as RateLimitState, T as CachedJsonModeEnabledCallParams, Tn as RetryAttempt, Tt as WireRequest, U as CallWithToolsResult, Ut as MiddlewareContextBase, V as ToolEnabledCallParams, Vt as MiddlewareCapabilities, W as ContentResult, Wt as MiddlewareRef, X as defineTool, Xt as VernLLMMiddleware, Y as ToolResult, Yt as RequiredMiddlewareRef, Z as isToolCallResult, Zt as WireCallRequest, _ as StreamJsonModeEnabledCallParams, _n as DuplicateToolNamesIssue, _t as RetryBudgetSnapshot, a as WireToolChoice, an as createStateKey, at as FallbackOnContext, b as AssistantContent, bn as LLMErrorCode, bt as RateLimitOptions, c as CachedStreamConditionalToolCallParams, cn as OnEvent, ct as TargetCircuitState, d as CachedStreamToolCallParams, dn as OnUsageFailure, dt as isFallbackExhaustedError, en as WireTool, et as CallMeta, f as StreamCallResult, fn as RefundUsage, ft as metaRef, g as StreamJsonModeDisabledCallParams, gn as Logger, gt as RetryBudgetOptions, h as StreamEnabledCallParams, hn as ConsoleLogger, ht as RetryBudgetAdapter, i as WireToolCall, in as createMiddlewareStateBag, it as FallbackOn, j as ContentBlock, jt as CircuitBreakerOptions, k as ConditionalStringToolCallParams, kn as hasIssues, kt as CircuitBreakerAdapter, l as CachedStreamJsonModeDisabledCallParams, ln as VernLLMEvent, lt as TargetInfo, m as StreamConditionalStringToolCallParams, mn as TokenUsage, mt as RetryBudget, n as LLMClient, nn as WrapNextOptions, nt as FallbackAttempt, o as CachedStreamCallParams, on as requireRef, ot as FallbackTarget, p as StreamChunk, pn as ReserveUsage, pt as RetryBudgetOption, q as ToolChoice, qt as MiddlewareStateKey, r as WireMessage, rn as createMiddlewareRef, rt as FallbackExhaustedError, s as CachedStreamConditionalStringToolCallParams, sn as stateEntry, st as FinishReason, t as AdapterInfo, tn as WrapNext, tt as CircuitTarget, u as CachedStreamJsonModeEnabledCallParams, un as OnUsage, ut as defaultFallbackOn, v as WireStreamChunk, vn as HistoryToolResultIssue, vt as RateLimitOption, w as CachedJsonModeDisabledCallParams, wn as LLMRequestSnapshot, wt as RateLimiterAdapter, x as CachedCallParams, xn as LLMErrorIssuesByCode, xt as RateLimitReason, y as isStreamResult, yn as LLMError, yt as RateLimitAcquireResult, z as TextBlock, zt as AttemptContext } from "./client-D4eRQMgc.cjs";
 interface CacheAdapter<T = unknown> {
   get(key: string): Promise<{
     hit: boolean;
@@ -87,15 +86,11 @@ export declare class TieredCacheAdapter<T = unknown> implements CacheAdapter<T>
   /** Drops every tracked record that has expired, visiting only those. */
   private pruneExpired;
 }
-//#endregion
-//#region src/internal/utils/rate-limit/tokenEstimate.utils.d.ts
 /**
  * Default `estimateTokens`: chars/4 over every message's text, plus
  * `IMAGE_TOKEN_ESTIMATE` per image, plus the requested `max_tokens`.
  */
 export declare function defaultEstimateTokens(request: WireRequest): number;
-//#endregion
-//#region src/internal/utils/cache/cacheAdapter.utils.d.ts
 /**
  * Not exported. Internal shorthand for `VernLLMOptions.cache`, so the
  * union isn't duplicated between that field and `buildCache`'s own
@@ -106,8 +101,6 @@ type CacheOption = {
   maxSize?: number;
   eviction?: EvictionOption;
 } | CacheAdapter;
-//#endregion
-//#region src/types/options.d.ts
 interface VernLLMOptions {
   client: LLMClient;
   model: string;
@@ -210,9 +203,10 @@ interface VernLLMOptions {
   /**
    * Caps the share of this target's recent traffic that may be retries. Once `minCalls` calls land
    * in `windowMs` and the retry ratio reaches `retryRatio`, retries throw `retry_budget_exhausted`,
-   * even while the breaker is closed. Not inherited by fallback targets.
+   * even while the breaker is closed. Pass a `RetryBudgetAdapter` for cross-process. Not inherited
+   * by fallback targets.
    */
-  retryBudget?: RetryBudgetOptions;
+  retryBudget?: RetryBudgetOption;
   /**
    * Targets tried in order after the primary is exhausted. VernLLM never reorders them. Each keeps
    * its own retries, breaker and limiter. A single target equals `[target]`.
@@ -235,8 +229,6 @@ interface VernLLMOptions {
    */
   middlewareTimeoutMs?: number;
 }
-//#endregion
-//#region src/types/createMiddleware.d.ts
 /**
  * `VernLLMMiddleware` plus `onError`, for middleware that only cares about failures. `wrap` can't
  * be set alongside it, since `onError` builds its own.
@@ -255,8 +247,6 @@ type CreateMiddlewareOptions = Omit<VernLLMMiddleware, 'wrap'> & {
  * rethrows, so the call's outcome never changes.
  */
 export declare function createMiddleware(options: CreateMiddlewareOptions): VernLLMMiddleware;
-//#endregion
-//#region src/vernLLM.d.ts
 /**
  * The LLM call framework: retries, timeouts, circuit breaking, fallback, rate limiting, caching and
  * middleware around any provider adapter.
@@ -361,10 +351,7 @@ export declare class VernLLM {
    * Budgets are per target, not per model.
    * @throws {RangeError} If `target.index` names no target.
    */
-  getRetryBudgetState(target?: Pick<CircuitTarget, 'index'>): {
-    attempts: number;
-    retryRatio: number;
-  } | undefined;
+  getRetryBudgetState(target?: Pick<CircuitTarget, 'index'>): RetryBudgetSnapshot | undefined;
   /**
    * @param target.index Which target to read. Defaults to the primary.
    * @returns Current rate limit levels, or `undefined` without a limiter. Limiters are per target,
@@ -393,6 +380,14 @@ export declare class VernLLM {
    * @returns Every target's state, in chain order.
    */
   readCircuitStates(model?: string): Promise<TargetCircuitState[]>;
+  /**
+   * The live counterpart of `getRetryBudgetState`, asking the budget for its current window.
+   *
+   * @param target.index Which target to read. Defaults to the primary.
+   * @returns This target's live retry traffic and ratio, or `undefined` without a budget.
+   * @throws {RangeError} If `target.index` names no target.
+   */
+  readRetryBudgetState(target?: Pick<CircuitTarget, 'index'>): Promise<RetryBudgetSnapshot | undefined>;
   /**
    * Manually opens a target's breaker, e.g. to pull a provider out of
    * rotation ahead of known maintenance instead of waiting for it to fail.
@@ -412,8 +407,6 @@ export declare class VernLLM {
    */
   closeCircuit(target?: CircuitTarget): void;
 }
-//#endregion
-//#region src/paramsHelpers.d.ts
 /**
  * Keeps `params`' precise type for a reusable variable. A `CallParams<T>` annotation would widen
  * `tools` and lose the conditional tools overload. Pin `T` through `llm.call<T>(params)`.
@@ -424,6 +417,5 @@ export declare function defineCallParams<P extends CallParams<unknown>>(params:
  * type.
  */
 export declare function defineCachedCallParams<P extends CachedCallParams<unknown>>(params: P): P;
-//#endregion
-export { type AdapterInfo, type AssistantContent, type AttemptContext, type CacheAdapter, type CachedCallParams, type CachedConditionalToolCallParams, type CachedJsonModeDisabledCallParams, type CachedJsonModeEnabledCallParams, type CachedStreamCallParams, type CachedStreamConditionalToolCallParams, type CachedStreamJsonModeDisabledCallParams, type CachedStreamJsonModeEnabledCallParams, type CachedStreamToolCallParams, type CachedToolCallParams, type CallContext, type CallMeta, type CallParams, type CallResult, type CallWithToolsResult, CircuitBreaker, type CircuitBreakerAdapter, type CircuitBreakerCallContext, type CircuitBreakerOptions, type CircuitBreakerStateChangeHandler, type CircuitState, type CircuitTarget, type ConditionalToolCallParams, ConsecutiveTripping, ConsoleLogger, type ContentBlock, type ContentResult, type ConversationTurn, type CooldownBackoff, type CreateMiddlewareOptions, type DuplicateToolNamesIssue, type EvictionOption, type ExponentialBackoffOptions, type FallbackAttempt, FallbackExhaustedError, type FallbackOn, type FallbackOnContext, type FallbackTarget, type HistoryToolResultIssue, type ImageBlock, type JsonModeDisabledCallParams, type JsonModeEnabledCallParams, type JsonSchemaSpec, type JsonValue, type LLMClient, LLMError, type LLMErrorCode, type LLMErrorIssuesByCode, type LLMErrorSnapshot, type LLMErrorType, type LLMRequestShape, type LLMRequestSnapshot, type Logger, type MiddlewareCapabilities, type MiddlewareContext, type MiddlewareContextBase, type MiddlewareRef, type MiddlewareStateBag, type MiddlewareStateEntry, type MiddlewareStateKey, type OnEvent, type OnUsage, type PreDispatchContext, type RateLimitAcquireResult, type RateLimitOptions, type RateLimitReason, type RateLimitState, RateLimiter, type RateLimiterAdapter, type RefundUsage, type RequiredMiddlewareRef, type ReserveUsage, type RetryAttempt, RetryBudget, type RetryBudgetOptions, RollingTripping, type SchemaLike, type StreamCallResult, type StreamChunk, type StreamEnabledCallParams, type StreamJsonModeDisabledCallParams, type StreamJsonModeEnabledCallParams, type TargetCircuitState, type TargetInfo, type TextBlock, type ThinkingBlock, type TokenUsage, type ToolCall, type ToolCallResult, type ToolChoice, type ToolDefinition, type ToolEnabledCallParams, type ToolIssue, type ToolResult, type ToolsDisabledCallParams, type TrippingPolicy, type UnknownToolChoiceIssue, type UnsupportedCapabilityIssue, type VernLLMEvent, type VernLLMMiddleware, type VernLLMOptions, type WireCallRequest, type WireCallRequestPatch, type WireMessage, type WireRequest, type WireResponseFormat, type WireStreamChunk, type WireTool, type WireToolCall, type WireToolChoice, createMiddlewareRef, createMiddlewareStateBag, createStateKey, defaultFallbackOn, defineTool, hasIssues, isFallbackExhaustedError, isLLMError, isStreamResult, isToolCallResult, metaRef, requireRef, stateEntry };
+export { type AdapterInfo, type AssistantContent, type AttemptContext, type CacheAdapter, type CachedCallParams, type CachedConditionalToolCallParams, type CachedJsonModeDisabledCallParams, type CachedJsonModeEnabledCallParams, type CachedStreamCallParams, type CachedStreamConditionalToolCallParams, type CachedStreamJsonModeDisabledCallParams, type CachedStreamJsonModeEnabledCallParams, type CachedStreamToolCallParams, type CachedToolCallParams, type CallContext, type CallMeta, type CallParams, type CallResult, type CallWithToolsResult, CircuitBreaker, type CircuitBreakerAdapter, type CircuitBreakerCallContext, type CircuitBreakerOptions, type CircuitBreakerStateChangeHandler, type CircuitState, type CircuitTarget, type ConditionalToolCallParams, ConsecutiveTripping, ConsoleLogger, type ContentBlock, type ContentResult, type ConversationTurn, type CooldownBackoff, type CreateMiddlewareOptions, type DuplicateToolNamesIssue, type EvictionOption, type ExponentialBackoffOptions, type FallbackAttempt, FallbackExhaustedError, type FallbackOn, type FallbackOnContext, type FallbackTarget, type FinishReason, type HistoryToolResultIssue, type ImageBlock, type JsonModeDisabledCallParams, type JsonModeEnabledCallParams, type JsonSchemaSpec, type JsonValue, type LLMClient, LLMError, type LLMErrorCode, type LLMErrorIssuesByCode, type LLMErrorSnapshot, type LLMErrorType, type LLMRequestShape, type LLMRequestSnapshot, type Logger, type MiddlewareCapabilities, type MiddlewareContext, type MiddlewareContextBase, type MiddlewareRef, type MiddlewareStateBag, type MiddlewareStateEntry, type MiddlewareStateKey, type OnEvent, type OnUsage, type PreDispatchContext, type RateLimitAcquireResult, type RateLimitOptions, type RateLimitReason, type RateLimitState, RateLimiter, type RateLimiterAdapter, type RefundUsage, type RequiredMiddlewareRef, type ReserveUsage, type RetryAttempt, RetryBudget, type RetryBudgetAdapter, type RetryBudgetOptions, type RetryBudgetSnapshot, RollingTripping, type SchemaLike, type StreamCallResult, type StreamChunk, type StreamEnabledCallParams, type StreamJsonModeDisabledCallParams, type StreamJsonModeEnabledCallParams, type TargetCircuitState, type TargetInfo, type TextBlock, type ThinkingBlock, type TokenUsage, type ToolCall, type ToolCallResult, type ToolChoice, type ToolDefinition, type ToolEnabledCallParams, type ToolIssue, type ToolResult, type ToolsDisabledCallParams, type TrippingPolicy, type UnknownToolChoiceIssue, type UnsupportedCapabilityIssue, type VernLLMEvent, type VernLLMMiddleware, type VernLLMOptions, type WireCallRequest, type WireCallRequestPatch, type WireMessage, type WireRequest, type WireResponseFormat, type WireStreamChunk, type WireTool, type WireToolCall, type WireToolChoice, type WrapNext, type WrapNextOptions, createMiddlewareRef, createMiddlewareStateBag, createStateKey, defaultFallbackOn, defineTool, hasIssues, isFallbackExhaustedError, isLLMError, isStreamResult, isToolCallResult, metaRef, requireRef, stateEntry };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/cache.ts","../src/internal/utils/rate-limit/tokenEstimate.utils.ts","../src/internal/utils/cache/cacheAdapter.utils.ts","../src/types/options.ts","../src/types/createMiddleware.ts","../src/vernLLM.ts","../src/paramsHelpers.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types/cache.ts","../src/internal/utils/rate-limit/tokenEstimate.utils.ts","../src/internal/utils/cache/cacheAdapter.utils.ts","../src/types/options.ts","../src/types/createMiddleware.ts","../src/vernLLM.ts","../src/paramsHelpers.ts"],"mappings":";UAAiB,aAAa;EAC5B,IAAI,cAAc;IAAU;IAAc,OAAO;;EACjD,IAAI,aAAa,OAAO,GAAG,cAAc;EACzC,QAAQ,cAAc;EACtB,YAAY,cAAc;;;;;;;KAQhB;;;;;;;qBA4GC,qBAAqB,wBAAwB,aAAa;mBAKlD;UAJX;mBACS;EAEjB,YACmB,kBACjB,WAAU;EAKN,IAAI,cAAc;IAAU;IAAc,OAAO;;EAejD,IAAI,aAAa,OAAO,GAAG,cAAc;EAkBzC,OAAO,cAAc;UAInB;UAUA;;;;;;;qBAgBG,uBAAuB,wBAAwB,aAAa;mBAC1C;EAA7B,YAA6B,QAAO,aAAa;UAEzC;EAIF,WAAW,cAAc;EAIzB,IAAI,cAAc;IAAU;IAAc,OAAO;;EAIjD,IAAI,aAAa,OAAO,GAAG,cAAc;EAIzC,OAAO,cAAc;;;;;;;qBAahB,mBAAmB,wBAAwB,aAAa;mBAWhD;mBACA;mBACA;;mBAXF;;;;;UAMT;EAER,YACmB,IAAI,aAAa,IACjB,IAAI,aAAa,IACjB;;;;;;EAQb,WAAW,cAAc;EAMzB,IAAI,cAAc;IAAU;IAAc,OAAO;;EAajD,IAAI,aAAa,OAAO,GAAG,cAAc;EASzC,OAAO,cAAc;;UAMnB;UAiBA;;UAkCA;;;;;;wBChSM,sBAAsB,SAAS;;;;;;;KChCnC;EAAgB;EAAkB,WAAW;IAAmB;UCA3D;EACf,QAAQ;EACR;;;;;EAKA;;EAEA;;EAEA;;;;;;EAMA;;;;;;EAMA;;EAEA;;;;;EAKA;;EAEA;;;;;;EAMA;;EAEA;;EAEA;;;;;EAKA;;;;;;EAMA,UAAU;;;;;EAKV,QAAQ;;;;;;EAMR,oBAAoB;;EAEpB;;EAEA,aAAa;;EAEb,UAAU;;;;;;EAMV,iBAAiB;;;;;EAKjB,SAAS;;;;;EAKT,iBAAiB;;;;;;EAMjB,UAAU;;;;;;EAMV,YAAY;;;;;;;EAOZ,cAAc;;;;;EAKd,WAAW,iBAAiB;;;;;;EAM5B,aAAa;;;;;EAKb,aAAa;;;;;EAKb;;;;;;KCnIU,0BAA0B,KAAK;EACzC;;;;;;EAMA,WAAW,OAAO,UAAU,KAAK,8BAA8B;;;;;;wBAOjD,iBAAiB,SAAS,0BAA0B;;;;;qBC+DvD;mBACM;;mBAGA;;mBAGA;;mBAGA;;mBAGA;mBACA;;mBAGA;;;;;;mBAOA;;mBAGA;;EAGjB,YAAY,SAAS;;;;;;;;;EA+Gf,KAAK,mBAAmB,uBAAuB,mBAAmB,kBACtE,QAAQ,wBAAwB,GAAG,SAAS,wBAAwB,GAAG,SACtE,QAAQ,iBAAiB,cAAc;EAEpC,KAAK,mBAAmB,uBAAuB,mBAAmB,kBACtE,QAAQ,wBAAwB,GAAG,SAAS,sBAAsB,GAAG,SACpE,QAAQ,iBAAiB,oBAAoB,GAAG;EAE7C,WAAW,uBAAuB,mBAAmB,kBACzD,QAAQ,sCAAsC,SAC7C,QAAQ,0BAA0B,4BAA4B;EAE3D,KAAK,mBAAmB,uBAAuB,mBAAmB,kBACtE,QAAQ,wBAAwB,GAAG,SAAS,0BAA0B,GAAG,SACxE,QAAQ,iBAAiB,IAAI,oBAAoB,GAAG;EAEjD,KAAK,QAAQ,mCAAmC,QAAQ;EAExD,KAAK,QAAQ,kCAAkC,QAAQ,iBAAiB;EAExE,KAAK,aAAa,QAAQ,wBAAwB,KAAK,QAAQ,iBAAiB;EAEhF,KAAK,mBAAmB,uBAAuB,mBAAmB,kBACtE,QAAQ,wBAAwB,GAAG,SAClC,QAAQ,cAAc;EAEnB,KAAK,mBAAmB,uBAAuB,mBAAmB,kBACtE,QAAQ,sBAAsB,GAAG,SAChC,QAAQ,oBAAoB,GAAG;EAE5B,WAAW,uBAAuB,mBAAmB,kBACzD,QAAQ,gCAAgC,SACvC,iBAAiB,4BAA4B;EAE1C,KAAK,mBAAmB,uBAAuB,mBAAmB,kBACtE,QAAQ,0BAA0B,GAAG,SACpC,QAAQ,IAAI,oBAAoB,GAAG;EAEhC,KAAK,QAAQ,6BAA6B;EAE1C,KAAK,QAAQ,4BAA4B,QAAQ;EAEjD,KAAK,aAAa,QAAQ,WAAW,KAAK,QAAQ;;;;;UAyEhD;;UAKA;;;;;;EASF,YAAY,cAAc;;;;;;;;;;EAa1B,WAAW,SAAS,uBAAuB,mBAAmB,kBAClE,QAAQ,2BAA2B,GAAG,SACrC,QAAQ,iBAAiB,oBAAoB,GAAG;EAE7C,iBAAiB,uBAAuB,mBAAmB,kBAC/D,QAAQ,4CAA4C,SACnD,QAAQ,0BAA0B,4BAA4B;EAE3D,WAAW,SAAS,uBAAuB,mBAAmB,kBAClE,QAAQ,sCAAsC,GAAG,SAChD,QAAQ,iBAAiB,IAAI,oBAAoB,GAAG;EAEjD,WACJ,QAAQ,yCACP,QAAQ;EAEL,WACJ,QAAQ,wCACP,QAAQ,iBAAiB;EAEtB,WAAW,GAAG,QAAQ,uBAAuB,KAAK,QAAQ,iBAAiB;EAE3E,WAAW,SAAS,uBAAuB,mBAAmB,kBAClE,QAAQ,qBAAqB,GAAG,SAC/B,QAAQ,oBAAoB,GAAG;EAE5B,iBAAiB,uBAAuB,mBAAmB,kBAC/D,QAAQ,sCAAsC,SAC7C,iBAAiB,4BAA4B;EAE1C,WAAW,SAAS,uBAAuB,mBAAmB,kBAClE,QAAQ,gCAAgC,GAAG,SAC1C,QAAQ,IAAI,oBAAoB,GAAG;EAEhC,WAAW,QAAQ,mCAAmC;EAEtD,WAAW,QAAQ,kCAAkC,QAAQ;EAE7D,WAAW,GAAG,QAAQ,iBAAiB,KAAK,QAAQ;;;;;;;EAuM1D,gBAAgB,SAAS,gBAAgB;;;;;;;;EAczC,oBACE,SAAS,gBACR,QAAQ,OAAO;;;;;;;EAkBlB,oBAAoB,SAAS,KAAK,0BAA0B;;;;;;;EAW5D,kBAAkB,SAAS,KAAK,0BAA0B;;;;;EAS1D,iBAAiB,iBAAiB;;;;;;;;;EAkB5B,mBACJ,SAAS,KAAK,0BACb,QAAQ;;;;;;;EAWL,kBAAkB,iBAAiB,QAAQ;;;;;;;;EAmB3C,qBACJ,SAAS,KAAK,0BACb,QAAQ;;;;;;;;;EAaX,YAAY,SAAS;;;;;;;;;EAkBrB,aAAa,SAAS;;;;;;wBC/tBR,iBAAiB,UAAU,qBAAqB,QAAQ,IAAI;;;;;wBAQ5D,uBAAuB,UAAU,2BAA2B,QAAQ,IAAI"}

package/dist/index.d.mts

@@ -1,5 +1,4 @@
-import { $ as SchemaLike, $t as createStateKey, A as ConditionalToolCallParams, At as ConsecutiveTripping, B as ThinkingBlock, Bt as MiddlewareRef, C as CachedConditionalToolCallParams, Cn as hasIssues, Ct as RetryBudgetOptions, D as CallContext, Dt as CircuitBreakerOptions, E as CachedToolCallParams, Et as CircuitBreakerCallContext, F as JsonModeDisabledCallParams, Ft as AttemptContext, G as ToolCall, Gt as RequiredMiddlewareRef, H as ToolsDisabledCallParams, Ht as MiddlewareStateEntry, I as JsonModeEnabledCallParams, It as CallResult, J as ToolDefinition, Jt as WireCallRequestPatch, K as ToolCallResult, Kt as VernLLMMiddleware, L as JsonValue, Lt as MiddlewareCapabilities, M as ConversationTurn, Mt as ExponentialBackoffOptions, N as DetectSoftFailure, Nt as RollingTripping, O as CallParams, Ot as CircuitBreakerStateChangeHandler, P as ImageBlock, Pt as TrippingPolicy, Q as JsonSchemaSpec, Qt as createMiddlewareStateBag, R as LLMRequestShape, Rt as MiddlewareContext, S as CachedConditionalStringToolCallParams, Sn as UnsupportedCapabilityIssue, St as RetryBudget, T as CachedJsonModeEnabledCallParams, Tt as CircuitBreakerAdapter, U as CallWithToolsResult, Ut as MiddlewareStateKey, V as ToolEnabledCallParams, Vt as MiddlewareStateBag, W as ContentResult, Wt as PreDispatchContext, X as defineTool, Xt as WireTool, Y as ToolResult, Yt as WireResponseFormat, Z as isToolCallResult, Zt as createMiddlewareRef, _ as StreamJsonModeEnabledCallParams, _n as LLMErrorType, _t as RateLimiter, a as WireToolChoice, an as OnUsageFailure, at as FallbackOnContext, b as AssistantContent, bn as ToolIssue, c as CachedStreamConditionalToolCallParams, cn as TokenUsage, ct as TargetInfo, d as CachedStreamToolCallParams, dn as DuplicateToolNamesIssue, dt as metaRef, en as requireRef, et as CallMeta, f as StreamCallResult, fn as HistoryToolResultIssue, ft as RateLimitOption, g as StreamJsonModeDisabledCallParams, gn as LLMErrorSnapshot, gt as RateLimitState, h as StreamEnabledCallParams, hn as LLMErrorIssuesByCode, ht as RateLimitReason, i as WireToolCall, in as OnUsage, it as FallbackOn, j as ContentBlock, jt as CooldownBackoff, k as ConditionalStringToolCallParams, kt as CircuitState, l as CachedStreamJsonModeDisabledCallParams, ln as ConsoleLogger, lt as defaultFallbackOn, m as StreamConditionalStringToolCallParams, mn as LLMErrorCode, mt as RateLimitOptions, n as LLMClient, nn as OnEvent, nt as FallbackAttempt, o as CachedStreamCallParams, on as RefundUsage, ot as FallbackTarget, p as StreamChunk, pn as LLMError, pt as RateLimitAcquireResult, q as ToolChoice, qt as WireCallRequest, r as WireMessage, rn as VernLLMEvent, rt as FallbackExhaustedError, s as CachedStreamConditionalStringToolCallParams, sn as ReserveUsage, st as TargetCircuitState, t as AdapterInfo, tn as stateEntry, tt as CircuitTarget, u as CachedStreamJsonModeEnabledCallParams, un as Logger, ut as isFallbackExhaustedError, v as WireStreamChunk, vn as LLMRequestSnapshot, vt as RateLimiterAdapter, w as CachedJsonModeDisabledCallParams, wn as isLLMError, wt as CircuitBreaker, x as CachedCallParams, xn as UnknownToolChoiceIssue, xt as CircuitBreakerOption, y as isStreamResult, yn as RetryAttempt, yt as WireRequest, z as TextBlock, zt as MiddlewareContextBase } from "./client-HWxkwVvj.mjs";
-//#region src/types/cache.d.ts
+import { $ as SchemaLike, $t as WireResponseFormat, A as ConditionalToolCallParams, An as isLLMError, At as CircuitBreakerCallContext, B as ThinkingBlock, Bt as CallResult, C as CachedConditionalToolCallParams, Cn as LLMErrorType, Ct as RateLimiter, D as CallContext, Dn as UnknownToolChoiceIssue, Dt as CircuitBreakerOption, E as CachedToolCallParams, En as ToolIssue, F as JsonModeDisabledCallParams, Ft as CooldownBackoff, G as ToolCall, Gt as MiddlewareStateBag, H as ToolsDisabledCallParams, Ht as MiddlewareContext, I as JsonModeEnabledCallParams, It as ExponentialBackoffOptions, J as ToolDefinition, Jt as PreDispatchContext, K as ToolCallResult, Kt as MiddlewareStateEntry, L as JsonValue, Lt as RollingTripping, M as ConversationTurn, Mt as CircuitBreakerStateChangeHandler, N as DetectSoftFailure, Nt as CircuitState, O as CallParams, On as UnsupportedCapabilityIssue, Ot as CircuitBreaker, P as ImageBlock, Pt as ConsecutiveTripping, Q as JsonSchemaSpec, Qt as WireCallRequestPatch, R as LLMRequestShape, Rt as TrippingPolicy, S as CachedConditionalStringToolCallParams, Sn as LLMErrorSnapshot, St as RateLimitState, T as CachedJsonModeEnabledCallParams, Tn as RetryAttempt, Tt as WireRequest, U as CallWithToolsResult, Ut as MiddlewareContextBase, V as ToolEnabledCallParams, Vt as MiddlewareCapabilities, W as ContentResult, Wt as MiddlewareRef, X as defineTool, Xt as VernLLMMiddleware, Y as ToolResult, Yt as RequiredMiddlewareRef, Z as isToolCallResult, Zt as WireCallRequest, _ as StreamJsonModeEnabledCallParams, _n as DuplicateToolNamesIssue, _t as RetryBudgetSnapshot, a as WireToolChoice, an as createStateKey, at as FallbackOnContext, b as AssistantContent, bn as LLMErrorCode, bt as RateLimitOptions, c as CachedStreamConditionalToolCallParams, cn as OnEvent, ct as TargetCircuitState, d as CachedStreamToolCallParams, dn as OnUsageFailure, dt as isFallbackExhaustedError, en as WireTool, et as CallMeta, f as StreamCallResult, fn as RefundUsage, ft as metaRef, g as StreamJsonModeDisabledCallParams, gn as Logger, gt as RetryBudgetOptions, h as StreamEnabledCallParams, hn as ConsoleLogger, ht as RetryBudgetAdapter, i as WireToolCall, in as createMiddlewareStateBag, it as FallbackOn, j as ContentBlock, jt as CircuitBreakerOptions, k as ConditionalStringToolCallParams, kn as hasIssues, kt as CircuitBreakerAdapter, l as CachedStreamJsonModeDisabledCallParams, ln as VernLLMEvent, lt as TargetInfo, m as StreamConditionalStringToolCallParams, mn as TokenUsage, mt as RetryBudget, n as LLMClient, nn as WrapNextOptions, nt as FallbackAttempt, o as CachedStreamCallParams, on as requireRef, ot as FallbackTarget, p as StreamChunk, pn as ReserveUsage, pt as RetryBudgetOption, q as ToolChoice, qt as MiddlewareStateKey, r as WireMessage, rn as createMiddlewareRef, rt as FallbackExhaustedError, s as CachedStreamConditionalStringToolCallParams, sn as stateEntry, st as FinishReason, t as AdapterInfo, tn as WrapNext, tt as CircuitTarget, u as CachedStreamJsonModeEnabledCallParams, un as OnUsage, ut as defaultFallbackOn, v as WireStreamChunk, vn as HistoryToolResultIssue, vt as RateLimitOption, w as CachedJsonModeDisabledCallParams, wn as LLMRequestSnapshot, wt as RateLimiterAdapter, x as CachedCallParams, xn as LLMErrorIssuesByCode, xt as RateLimitReason, y as isStreamResult, yn as LLMError, yt as RateLimitAcquireResult, z as TextBlock, zt as AttemptContext } from "./client-D4eRQMgc.mjs";
 interface CacheAdapter<T = unknown> {
   get(key: string): Promise<{
     hit: boolean;
@@ -87,15 +86,11 @@ export declare class TieredCacheAdapter<T = unknown> implements CacheAdapter<T>
   /** Drops every tracked record that has expired, visiting only those. */
   private pruneExpired;
 }
-//#endregion
-//#region src/internal/utils/rate-limit/tokenEstimate.utils.d.ts
 /**
  * Default `estimateTokens`: chars/4 over every message's text, plus
  * `IMAGE_TOKEN_ESTIMATE` per image, plus the requested `max_tokens`.
  */
 export declare function defaultEstimateTokens(request: WireRequest): number;
-//#endregion
-//#region src/internal/utils/cache/cacheAdapter.utils.d.ts
 /**
  * Not exported. Internal shorthand for `VernLLMOptions.cache`, so the
  * union isn't duplicated between that field and `buildCache`'s own
@@ -106,8 +101,6 @@ type CacheOption = {
   maxSize?: number;
   eviction?: EvictionOption;
 } | CacheAdapter;
-//#endregion
-//#region src/types/options.d.ts
 interface VernLLMOptions {
   client: LLMClient;
   model: string;
@@ -210,9 +203,10 @@ interface VernLLMOptions {
   /**
    * Caps the share of this target's recent traffic that may be retries. Once `minCalls` calls land
    * in `windowMs` and the retry ratio reaches `retryRatio`, retries throw `retry_budget_exhausted`,
-   * even while the breaker is closed. Not inherited by fallback targets.
+   * even while the breaker is closed. Pass a `RetryBudgetAdapter` for cross-process. Not inherited
+   * by fallback targets.
    */
-  retryBudget?: RetryBudgetOptions;
+  retryBudget?: RetryBudgetOption;
   /**
    * Targets tried in order after the primary is exhausted. VernLLM never reorders them. Each keeps
    * its own retries, breaker and limiter. A single target equals `[target]`.
@@ -235,8 +229,6 @@ interface VernLLMOptions {
    */
   middlewareTimeoutMs?: number;
 }
-//#endregion
-//#region src/types/createMiddleware.d.ts
 /**
  * `VernLLMMiddleware` plus `onError`, for middleware that only cares about failures. `wrap` can't
  * be set alongside it, since `onError` builds its own.
@@ -255,8 +247,6 @@ type CreateMiddlewareOptions = Omit<VernLLMMiddleware, 'wrap'> & {
  * rethrows, so the call's outcome never changes.
  */
 export declare function createMiddleware(options: CreateMiddlewareOptions): VernLLMMiddleware;
-//#endregion
-//#region src/vernLLM.d.ts
 /**
  * The LLM call framework: retries, timeouts, circuit breaking, fallback, rate limiting, caching and
  * middleware around any provider adapter.
@@ -361,10 +351,7 @@ export declare class VernLLM {
    * Budgets are per target, not per model.
    * @throws {RangeError} If `target.index` names no target.
    */
-  getRetryBudgetState(target?: Pick<CircuitTarget, 'index'>): {
-    attempts: number;
-    retryRatio: number;
-  } | undefined;
+  getRetryBudgetState(target?: Pick<CircuitTarget, 'index'>): RetryBudgetSnapshot | undefined;
   /**
    * @param target.index Which target to read. Defaults to the primary.
    * @returns Current rate limit levels, or `undefined` without a limiter. Limiters are per target,
@@ -393,6 +380,14 @@ export declare class VernLLM {
    * @returns Every target's state, in chain order.
    */
   readCircuitStates(model?: string): Promise<TargetCircuitState[]>;
+  /**
+   * The live counterpart of `getRetryBudgetState`, asking the budget for its current window.
+   *
+   * @param target.index Which target to read. Defaults to the primary.
+   * @returns This target's live retry traffic and ratio, or `undefined` without a budget.
+   * @throws {RangeError} If `target.index` names no target.
+   */
+  readRetryBudgetState(target?: Pick<CircuitTarget, 'index'>): Promise<RetryBudgetSnapshot | undefined>;
   /**
    * Manually opens a target's breaker, e.g. to pull a provider out of
    * rotation ahead of known maintenance instead of waiting for it to fail.
@@ -412,8 +407,6 @@ export declare class VernLLM {
    */
   closeCircuit(target?: CircuitTarget): void;
 }
-//#endregion
-//#region src/paramsHelpers.d.ts
 /**
  * Keeps `params`' precise type for a reusable variable. A `CallParams<T>` annotation would widen
  * `tools` and lose the conditional tools overload. Pin `T` through `llm.call<T>(params)`.
@@ -424,6 +417,5 @@ export declare function defineCallParams<P extends CallParams<unknown>>(params:
  * type.
  */
 export declare function defineCachedCallParams<P extends CachedCallParams<unknown>>(params: P): P;
-//#endregion
-export { type AdapterInfo, type AssistantContent, type AttemptContext, type CacheAdapter, type CachedCallParams, type CachedConditionalToolCallParams, type CachedJsonModeDisabledCallParams, type CachedJsonModeEnabledCallParams, type CachedStreamCallParams, type CachedStreamConditionalToolCallParams, type CachedStreamJsonModeDisabledCallParams, type CachedStreamJsonModeEnabledCallParams, type CachedStreamToolCallParams, type CachedToolCallParams, type CallContext, type CallMeta, type CallParams, type CallResult, type CallWithToolsResult, CircuitBreaker, type CircuitBreakerAdapter, type CircuitBreakerCallContext, type CircuitBreakerOptions, type CircuitBreakerStateChangeHandler, type CircuitState, type CircuitTarget, type ConditionalToolCallParams, ConsecutiveTripping, ConsoleLogger, type ContentBlock, type ContentResult, type ConversationTurn, type CooldownBackoff, type CreateMiddlewareOptions, type DuplicateToolNamesIssue, type EvictionOption, type ExponentialBackoffOptions, type FallbackAttempt, FallbackExhaustedError, type FallbackOn, type FallbackOnContext, type FallbackTarget, type HistoryToolResultIssue, type ImageBlock, type JsonModeDisabledCallParams, type JsonModeEnabledCallParams, type JsonSchemaSpec, type JsonValue, type LLMClient, LLMError, type LLMErrorCode, type LLMErrorIssuesByCode, type LLMErrorSnapshot, type LLMErrorType, type LLMRequestShape, type LLMRequestSnapshot, type Logger, type MiddlewareCapabilities, type MiddlewareContext, type MiddlewareContextBase, type MiddlewareRef, type MiddlewareStateBag, type MiddlewareStateEntry, type MiddlewareStateKey, type OnEvent, type OnUsage, type PreDispatchContext, type RateLimitAcquireResult, type RateLimitOptions, type RateLimitReason, type RateLimitState, RateLimiter, type RateLimiterAdapter, type RefundUsage, type RequiredMiddlewareRef, type ReserveUsage, type RetryAttempt, RetryBudget, type RetryBudgetOptions, RollingTripping, type SchemaLike, type StreamCallResult, type StreamChunk, type StreamEnabledCallParams, type StreamJsonModeDisabledCallParams, type StreamJsonModeEnabledCallParams, type TargetCircuitState, type TargetInfo, type TextBlock, type ThinkingBlock, type TokenUsage, type ToolCall, type ToolCallResult, type ToolChoice, type ToolDefinition, type ToolEnabledCallParams, type ToolIssue, type ToolResult, type ToolsDisabledCallParams, type TrippingPolicy, type UnknownToolChoiceIssue, type UnsupportedCapabilityIssue, type VernLLMEvent, type VernLLMMiddleware, type VernLLMOptions, type WireCallRequest, type WireCallRequestPatch, type WireMessage, type WireRequest, type WireResponseFormat, type WireStreamChunk, type WireTool, type WireToolCall, type WireToolChoice, createMiddlewareRef, createMiddlewareStateBag, createStateKey, defaultFallbackOn, defineTool, hasIssues, isFallbackExhaustedError, isLLMError, isStreamResult, isToolCallResult, metaRef, requireRef, stateEntry };
+export { type AdapterInfo, type AssistantContent, type AttemptContext, type CacheAdapter, type CachedCallParams, type CachedConditionalToolCallParams, type CachedJsonModeDisabledCallParams, type CachedJsonModeEnabledCallParams, type CachedStreamCallParams, type CachedStreamConditionalToolCallParams, type CachedStreamJsonModeDisabledCallParams, type CachedStreamJsonModeEnabledCallParams, type CachedStreamToolCallParams, type CachedToolCallParams, type CallContext, type CallMeta, type CallParams, type CallResult, type CallWithToolsResult, CircuitBreaker, type CircuitBreakerAdapter, type CircuitBreakerCallContext, type CircuitBreakerOptions, type CircuitBreakerStateChangeHandler, type CircuitState, type CircuitTarget, type ConditionalToolCallParams, ConsecutiveTripping, ConsoleLogger, type ContentBlock, type ContentResult, type ConversationTurn, type CooldownBackoff, type CreateMiddlewareOptions, type DuplicateToolNamesIssue, type EvictionOption, type ExponentialBackoffOptions, type FallbackAttempt, FallbackExhaustedError, type FallbackOn, type FallbackOnContext, type FallbackTarget, type FinishReason, type HistoryToolResultIssue, type ImageBlock, type JsonModeDisabledCallParams, type JsonModeEnabledCallParams, type JsonSchemaSpec, type JsonValue, type LLMClient, LLMError, type LLMErrorCode, type LLMErrorIssuesByCode, type LLMErrorSnapshot, type LLMErrorType, type LLMRequestShape, type LLMRequestSnapshot, type Logger, type MiddlewareCapabilities, type MiddlewareContext, type MiddlewareContextBase, type MiddlewareRef, type MiddlewareStateBag, type MiddlewareStateEntry, type MiddlewareStateKey, type OnEvent, type OnUsage, type PreDispatchContext, type RateLimitAcquireResult, type RateLimitOptions, type RateLimitReason, type RateLimitState, RateLimiter, type RateLimiterAdapter, type RefundUsage, type RequiredMiddlewareRef, type ReserveUsage, type RetryAttempt, RetryBudget, type RetryBudgetAdapter, type RetryBudgetOptions, type RetryBudgetSnapshot, RollingTripping, type SchemaLike, type StreamCallResult, type StreamChunk, type StreamEnabledCallParams, type StreamJsonModeDisabledCallParams, type StreamJsonModeEnabledCallParams, type TargetCircuitState, type TargetInfo, type TextBlock, type ThinkingBlock, type TokenUsage, type ToolCall, type ToolCallResult, type ToolChoice, type ToolDefinition, type ToolEnabledCallParams, type ToolIssue, type ToolResult, type ToolsDisabledCallParams, type TrippingPolicy, type UnknownToolChoiceIssue, type UnsupportedCapabilityIssue, type VernLLMEvent, type VernLLMMiddleware, type VernLLMOptions, type WireCallRequest, type WireCallRequestPatch, type WireMessage, type WireRequest, type WireResponseFormat, type WireStreamChunk, type WireTool, type WireToolCall, type WireToolChoice, type WrapNext, type WrapNextOptions, createMiddlewareRef, createMiddlewareStateBag, createStateKey, defaultFallbackOn, defineTool, hasIssues, isFallbackExhaustedError, isLLMError, isStreamResult, isToolCallResult, metaRef, requireRef, stateEntry };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/cache.ts","../src/internal/utils/rate-limit/tokenEstimate.utils.ts","../src/internal/utils/cache/cacheAdapter.utils.ts","../src/types/options.ts","../src/types/createMiddleware.ts","../src/vernLLM.ts","../src/paramsHelpers.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/cache.ts","../src/internal/utils/rate-limit/tokenEstimate.utils.ts","../src/internal/utils/cache/cacheAdapter.utils.ts","../src/types/options.ts","../src/types/createMiddleware.ts","../src/vernLLM.ts","../src/paramsHelpers.ts"],"mappings":"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"}