@kodax-ai/kodax 0.7.56 → 0.7.58

package/dist/types-chunks/{base.d-CwPfI8WQ.d.ts → base.d-BA9Doaj_.d.ts}

@@ -1,9 +1,9 @@
-import { s as KodaXProviderConfig, n as KodaXMessage, Y as KodaXToolDefinition, G as KodaXReasoningRequest, A as KodaXProviderStreamOptions, L as KodaXStreamResult, a2 as KodaXVerifyCredentialResult, o as KodaXModelDescriptor, r as KodaXProviderCapabilityProfile, D as KodaXReasoningCapability, F as KodaXReasoningOverride } from './types.d-BJmoMf5H.js';
+import { p as KodaXProviderConfig, j as KodaXMessage, _ as KodaXToolDefinition, G as KodaXReasoningRequest, x as KodaXProviderStreamOptions, M as KodaXStreamResult, a4 as KodaXVerifyCredentialResult, k as KodaXModelDescriptor, o as KodaXProviderCapabilityProfile, A as KodaXReasoningCapability, F as KodaXReasoningProfile, m as KodaXNormalizedReasoningRequest, a6 as KodaXWireReasoningEffort } from './types.d-Ci5YPFEh.js';
 
 /**
  * Retry-After header parsing — FEATURE_130 (v0.7.36).
  *
- * Handles the four forms KodaX's 12 provider adapters encounter when a
+ * Handles the four forms KodaX's built-in provider adapters encounter when a
  * model returns 429 (rate limit) or 503/529 (overloaded):
  *
  *   1. `Retry-After: 120`               — integer seconds (HTTP 7231 standard)
@@ -89,6 +89,27 @@ declare function extractHeadersFromError(error: unknown): HeadersLike;
  * Provider 抽象基类 - 所有 Provider 的公共基础
  */
 
+/**
+ * Passive-learning guard threaded into `withRateLimit`: when the request fails
+ * with a reasoning-effort rejection, fire `onRejected` (so the REPL records it)
+ * and surface a typed error. `effort` is the value that was on the wire (used
+ * when the provider error doesn't echo a value).
+ */
+interface ReasoningRejectionGuard {
+    readonly model: string;
+    readonly effort?: string;
+    readonly onRejected?: (event: {
+        provider: string;
+        model: string;
+        effort: string;
+    }) => void;
+}
+
+interface ResolvedV2ReasoningIntent {
+    readonly disabled: boolean;
+    readonly effort?: KodaXWireReasoningEffort;
+    readonly requestedEffort?: KodaXWireReasoningEffort;
+}
 /**
  * FEATURE_130 (v0.7.36): structured payload fired through
  * `KodaXEvents.onRetryAfter` whenever a provider's `withRateLimit`
@@ -121,6 +142,14 @@ declare abstract class KodaXBaseProvider {
      *      returns `stop_reason: max_tokens`. See `coding/src/agent.ts`.
      */
     protected maxOutputTokensOverride?: number;
+    /**
+     * One-shot flag for the passive-learning self-heal: when a request is
+     * rejected for its reasoning-effort value, `withRateLimit` flips this true
+     * and retries the SAME turn. The reasoning-application path then drops the
+     * effort param so the retry uses the provider default and the user's turn
+     * still completes — no interruption, no re-typed query. Cleared on success.
+     */
+    protected suppressReasoningEffort: boolean;
     /**
      * Public setter for the one-shot override above. Callers outside the
      * provider package (notably the agent loop's escalation branch) use this
@@ -165,6 +194,7 @@ declare abstract class KodaXBaseProvider {
      * layer sets it — matches third-party Anthropic-compat behavior.
      */
     getEffectiveStrictThinkingSignature(model?: string): boolean;
+    protected getEffectiveThinkingBudgetCap(model?: string): number | undefined;
     abstract stream(messages: KodaXMessage[], tools: KodaXToolDefinition[], system: string, reasoning?: boolean | KodaXReasoningRequest, streamOptions?: KodaXProviderStreamOptions, signal?: AbortSignal): Promise<KodaXStreamResult>;
     supportsNonStreamingFallback(): boolean;
     complete(_messages: KodaXMessage[], _tools: KodaXToolDefinition[], _system: string, _reasoning?: boolean | KodaXReasoningRequest, _streamOptions?: KodaXProviderStreamOptions, _signal?: AbortSignal): Promise<KodaXStreamResult>;
@@ -194,9 +224,7 @@ declare abstract class KodaXBaseProvider {
     getCapabilityProfile(): KodaXProviderCapabilityProfile;
     getConfiguredReasoningCapability(modelOverride?: string): KodaXReasoningCapability;
     getReasoningCapability(modelOverride?: string): KodaXReasoningCapability;
-    getReasoningOverride(modelOverride?: string): KodaXReasoningOverride | undefined;
-    getReasoningOverrideKey(modelOverride?: string): string;
-    protected persistReasoningCapabilityOverride(capability: KodaXReasoningCapability, modelOverride?: string): void;
+    getReasoningProfile(modelOverride?: string): KodaXReasoningProfile | undefined;
     protected shouldFallbackForReasoningError(error: unknown, ...terms: string[]): boolean;
     protected shouldFallbackForSpecificReasoningError(error: unknown, ...terms: string[]): boolean;
     protected shouldFallbackForForcedToolChoiceError(error: unknown): boolean;
@@ -225,7 +253,9 @@ declare abstract class KodaXBaseProvider {
     protected getApiKey(): string;
     protected shouldLogStreamDiagnostics(): boolean;
     protected logStreamDiagnostic(...args: unknown[]): void;
-    protected normalizeReasoning(reasoning?: boolean | KodaXReasoningRequest): Required<KodaXReasoningRequest>;
+    protected normalizeReasoning(reasoning?: boolean | KodaXReasoningRequest): KodaXNormalizedReasoningRequest;
+    protected validateExplicitReasoningEffort(reasoning: KodaXNormalizedReasoningRequest, modelOverride?: string): void;
+    protected resolveReasoningProfileIntent(reasoning: KodaXNormalizedReasoningRequest, capability: KodaXReasoningProfile, modelOverride?: string): ResolvedV2ReasoningIntent;
     /**
      * Called when ECONNRESET/EPIPE is detected, indicating a stale keep-alive
      * socket.  Subclasses should override to rebuild their HTTP client with a
@@ -247,7 +277,7 @@ declare abstract class KodaXBaseProvider {
      * Returns milliseconds, or undefined when no usable header is present.
      *
      * FEATURE_130 (v0.7.36): now delegates to the shared `parseRetryAfter`
-     * helper so all 12 provider adapters get 4-form coverage without each
+     * helper so all built-in provider adapters get 4-form coverage without each
      * adapter rolling its own parser. The 4 forms supported are:
      *   - `Retry-After: <integer-seconds>`
      *   - `Retry-After: <HTTP-date>`
@@ -264,7 +294,7 @@ declare abstract class KodaXBaseProvider {
      */
     protected parseContextOverflow(error: unknown): number | undefined;
     protected isContextOverflowError(error: unknown): boolean;
-    protected withRateLimit<T>(fn: () => Promise<T>, signal?: AbortSignal, retries?: number, onRateLimit?: (attempt: number, maxRetries: number, delayMs: number) => void, onRetryAfter?: KodaXOnRetryAfterCallback): Promise<T>;
+    protected withRateLimit<T>(fn: () => Promise<T>, signal?: AbortSignal, retries?: number, onRateLimit?: (attempt: number, maxRetries: number, delayMs: number) => void, onRetryAfter?: KodaXOnRetryAfterCallback, reasoningGuard?: ReasoningRejectionGuard): Promise<T>;
 }
 
 export { KodaXBaseProvider as K, extractHeadersFromError as e, parseRetryAfter as p };