@axlsdk/axl 0.22.2 → 0.22.3

package/dist/index.d.cts

@@ -228,7 +228,46 @@ interface Provider {
      *    JSON instruction instead (e.g. Anthropic).
      */
     nativeStructuredOutputSupport?(model: string): 'schema' | 'downgraded' | 'lossy' | 'unsupported';
+    /**
+     * How this provider resolved the unified `effort` knob for this request.
+     *
+     * Adapters clamp `effort` to what each model actually accepts (Gemini 3.x
+     * cannot disable thinking; OpenAI Chat Completions caps `'max'` at `'xhigh'`;
+     * Anthropic models that always think fall back to adaptive `'low'`). That
+     * clamp used to be invisible to run provenance. The runtime calls this once
+     * per ask, right after provider resolution, and emits a
+     * `provider_diagnostic { kind: 'effort_clamped' }` event plus a deduped
+     * `console.warn` when `clamped` is true — the adapter only *reports*, the
+     * runtime decides how to surface it (only the runtime can see
+     * `AxlConfig.diagnostics.silent`).
+     *
+     * The adapter applies its own `providerOptions.model` override before
+     * resolving, so the report describes the model actually sent.
+     *
+     * Optional, and optional to answer: return `undefined` when there is nothing
+     * to report (no effort requested, the model is unknown, or the effort is
+     * honored verbatim). An adapter MAY also report an honored resolution with
+     * `clamped: false`; the runtime stays silent for those.
+     */
+    effortResolution?(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
 }
+/**
+ * An adapter's report of how it resolved the unified `effort` for one request.
+ *
+ * `effective` is a provider-NATIVE level string rather than an `Effort` because
+ * not every effective value maps back onto the unified union (Gemini's
+ * `'minimal'`, OpenAI's `'minimal'`, Anthropic's adaptive `'low'`).
+ */
+type EffortResolution = {
+    /** The unified effort the caller asked for. */
+    requested: Effort;
+    /** The provider-native level actually sent (e.g. `'minimal'`, `'xhigh'`, `'low'`). */
+    effective: string;
+    /** True when `effective` is not what `requested` asked for. */
+    clamped: boolean;
+    /** Human-readable reason, surfaced verbatim on the diagnostic event. */
+    cause?: string;
+};
 /**
  * Alias for Provider. Used for backward compatibility with index.ts exports.
  */
@@ -374,6 +413,10 @@ type AskOptions<T = unknown> = {
     validate?: OutputValidator<T>;
     /** Maximum retries for validate failures (default: 2). */
     validateRetries?: number;
+    /** Rewrite the corrective feedback the model sees when the guardrail, schema, or validate
+     *  gate rejects an attempt — or abort the retry with `{ retry: false }`. See
+     *  `RetryFeedbackHook`. */
+    retryFeedback?: RetryFeedbackHook<T>;
     /** Per-call metadata passed to dynamic model/system selector functions. */
     metadata?: Record<string, unknown>;
     /** Override temperature for this call. */
@@ -415,6 +458,9 @@ type DelegateOptions<T = unknown> = {
     validate?: OutputValidator<T>;
     /** Maximum retries for validate failures (default: 2). Passed through to the final `ctx.ask()` call. */
     validateRetries?: number;
+    /** Custom gate-retry feedback. Passed through to the final `ctx.ask()` call on both the
+     *  single-candidate and the routed path. See `RetryFeedbackHook`. */
+    retryFeedback?: RetryFeedbackHook<T>;
 };
 /** Race options */
 type RaceOptions<T = unknown> = {
@@ -430,11 +476,11 @@ type ExecutionStatus = 'running' | 'completed' | 'failed' | 'waiting';
  * derive `AxlEventType` from this tuple and use it to validate stream filters,
  * redaction tables, and exhaustiveness assertions.
  */
-declare const AXL_EVENT_TYPES: readonly ["workflow_start", "workflow_end", "transcription_start", "transcription_end", "ask_start", "ask_end", "agent_call_start", "agent_call_end", "token", "tool_call_start", "tool_call_end", "tool_call_rejected", "tool_approval", "delegate", "handoff_start", "handoff_return", "pipeline", "partial_object", "string_delta", "verify", "schema_diagnostic", "log", "memory_remember", "memory_recall", "memory_forget", "checkpoint_save", "checkpoint_replay", "await_human", "await_human_resolved", "guardrail", "schema_check", "validate", "done", "error"];
+declare const AXL_EVENT_TYPES: readonly ["workflow_start", "workflow_end", "transcription_start", "transcription_end", "ask_start", "ask_end", "agent_call_start", "agent_call_end", "token", "tool_call_start", "tool_call_end", "tool_call_rejected", "tool_approval", "delegate", "handoff_start", "handoff_return", "pipeline", "partial_object", "string_delta", "verify", "schema_diagnostic", "provider_diagnostic", "log", "memory_remember", "memory_recall", "memory_forget", "checkpoint_save", "checkpoint_replay", "await_human", "await_human_resolved", "guardrail", "schema_check", "validate", "done", "error"];
 /** Discriminator union derived from `AXL_EVENT_TYPES`. */
 type AxlEventType = (typeof AXL_EVENT_TYPES)[number];
 /** Backward-compatible name for the canonical v2 writer discriminator list. */
-declare const AXL_EVENT_TYPES_V2: readonly ["workflow_start", "workflow_end", "transcription_start", "transcription_end", "ask_start", "ask_end", "agent_call_start", "agent_call_end", "token", "tool_call_start", "tool_call_end", "tool_call_rejected", "tool_approval", "delegate", "handoff_start", "handoff_return", "pipeline", "partial_object", "string_delta", "verify", "schema_diagnostic", "log", "memory_remember", "memory_recall", "memory_forget", "checkpoint_save", "checkpoint_replay", "await_human", "await_human_resolved", "guardrail", "schema_check", "validate", "done", "error"];
+declare const AXL_EVENT_TYPES_V2: readonly ["workflow_start", "workflow_end", "transcription_start", "transcription_end", "ask_start", "ask_end", "agent_call_start", "agent_call_end", "token", "tool_call_start", "tool_call_end", "tool_call_rejected", "tool_approval", "delegate", "handoff_start", "handoff_return", "pipeline", "partial_object", "string_delta", "verify", "schema_diagnostic", "provider_diagnostic", "log", "memory_remember", "memory_recall", "memory_forget", "checkpoint_save", "checkpoint_replay", "await_human", "await_human_resolved", "guardrail", "schema_check", "validate", "done", "error"];
 /** Accepted/rejected tool lifecycle discriminators in event schema v2. */
 declare const AXL_TOOL_LIFECYCLE_TYPES_V2: readonly ["tool_call_start", "tool_call_end", "tool_call_rejected"];
 /** Resolved model parameters sent to the provider for an LLM call. */
@@ -779,6 +825,34 @@ type SchemaDiagnosticData = {
     provider?: string;
     support: 'downgraded' | 'lossy' | 'unsupported';
 };
+/**
+ * Data for the `provider_diagnostic` event — a `kind`-discriminated payload
+ * (like `SchemaDiagnosticData`) reporting that the resolved provider could not
+ * honor a portable request knob verbatim.
+ *
+ *  - `effort_clamped` — the adapter clamped the unified `effort` to what the
+ *    model actually accepts (Gemini 3.x cannot disable thinking; OpenAI Chat
+ *    Completions caps `'max'` at `'xhigh'`; Anthropic models that always think
+ *    fall back to adaptive `'low'`). `requested` is the unified value the caller
+ *    asked for; `effective` is the provider-native level actually sent, which is
+ *    deliberately a free string because not every native level maps back onto
+ *    `Effort`. One per ask, emitted before the first `agent_call_start` — join it
+ *    to `agent_call_start` (which keeps reporting the *requested* effort) by
+ *    `askId` for full provenance.
+ *
+ * The union is `kind`-discriminated so later provider cliffs can join without a
+ * new event type.
+ */
+type ProviderDiagnosticData = {
+    kind: 'effort_clamped';
+    /** Provider name (`provider.name`), when the adapter exposes one. */
+    provider?: string;
+    /** The model the request is actually sent to (after any `providerOptions.model`). */
+    model: string;
+    requested: Effort;
+    effective: string;
+    cause: string;
+};
 /** Data shape for legacy `guardrail` events. Replaced by `pipeline` in PR 2. */
 type GuardrailData = {
     guardrailType: 'input' | 'output';
@@ -1132,6 +1206,9 @@ type LegacyAxlEventPayloadV1 = (AxlEventBase & {
 }) | (AxlEventBase & AskScoped & {
     type: 'schema_diagnostic';
     data: SchemaDiagnosticData;
+}) | (AxlEventBase & AskScoped & {
+    type: 'provider_diagnostic';
+    data: ProviderDiagnosticData;
 }) | (AxlEventBase & Partial<AskScoped> & {
     type: 'guardrail';
     data?: GuardrailData;
@@ -1319,6 +1396,43 @@ type ValidateResult = {
 type OutputValidator<T = unknown> = (output: T, ctx: {
     metadata: Record<string, unknown>;
 }) => ValidateResult | Promise<ValidateResult>;
+/** What a rejecting output gate tells a `retryFeedback` hook about the attempt it is
+ *  about to retry. One shape for all three gates — `stage` discriminates. */
+type RetryFeedbackInfo<T = unknown> = {
+    /** Which gate rejected: JSON/Zod parse, post-schema `validate`, or output guardrail. */
+    stage: 'schema' | 'validate' | 'guardrail';
+    /** 1-based index of the attempt that was just rejected. */
+    attempt: number;
+    /** Total attempts this gate allows (`retries` + 1). */
+    maxAttempts: number;
+    /** Raw model output that was rejected. */
+    output: string;
+    /** The parsed, schema-valid object, typed by the ask's `schema`. Present only for
+     *  `stage: 'validate'` — the other gates run before or without a parsed value. */
+    parsed?: T;
+    /** The gate's own reason (Zod message, `ValidateResult.reason`, guardrail reason). */
+    reason: string;
+    /** The `ZodError` (or non-Zod parse error) for `schema`; the validator's thrown error for
+     *  `validate` when it threw. Absent for `guardrail` and for a clean `validate` rejection. */
+    error?: unknown;
+    /** The feedback text the runtime would send if the hook did not intervene. */
+    defaultMessage: string;
+};
+/** A non-empty string replaces `defaultMessage` verbatim; `undefined` (or `''`) keeps it;
+ *  `{ retry: false }` stops retrying and makes the gate throw its typed terminal error. */
+type RetryFeedbackResult = string | undefined | {
+    retry: false;
+};
+/** Rewrites (or aborts) the corrective turn the model sees after an output gate rejects an
+ *  attempt. Runs only while a retry is still permitted — never on the exhausting attempt —
+ *  and after the gate's own event is emitted. Exceptions propagate to the caller.
+ *
+ *  `void` is accepted alongside `RetryFeedbackResult` so a hook used purely for logging or
+ *  inspection — a block body that never returns — type-checks; it keeps the default text.
+ *  Any other return value is a contract violation and throws a `TypeError`. */
+type RetryFeedbackHook<T = unknown> = (info: RetryFeedbackInfo<T>, ctx: {
+    metadata: Record<string, unknown>;
+}) => RetryFeedbackResult | void | Promise<RetryFeedbackResult | void>;
 /** Execution info */
 type ExecutionInfoV1 = {
     executionId: string;
@@ -3534,6 +3648,20 @@ declare class WorkflowContext<TInput = unknown> {
     private observeToolInvocation;
     ask<T = string>(agent: Agent, prompt: ModelInput, options?: AskOptions<T>): Promise<T>;
     private executeAgentCall;
+    /**
+     * Resolve the corrective feedback text for one rejected attempt, giving an optional
+     * caller-supplied `retryFeedback` hook the chance to replace it or to stop retrying.
+     *
+     * Called by all three output gates, only while a retry is still permitted (never on the
+     * exhausting attempt) and only after the gate's own event has been emitted, so a hook that
+     * throws or aborts can never erase the evidence that the gate rejected. A non-empty string
+     * replaces `defaultMessage` verbatim; `undefined` / `''` keeps it; `{ retry: false }` asks
+     * the gate to throw its typed terminal error. Hook exceptions propagate — a bug in caller
+     * code is not a model failure and must not be retried into silence, and neither is a
+     * return value outside the contract: an unrecognized shape throws instead of silently
+     * degrading to the default text, which would hide the defect behind extra token spend.
+     */
+    private resolveRetryFeedback;
     /**
      * Push the final assistant message into session history, preserving providerMetadata
      * (e.g., Gemini thought signatures needed for multi-turn reasoning context) and
@@ -3557,6 +3685,20 @@ declare class WorkflowContext<TInput = unknown> {
      * (expected behavior for any tool-using agent, not a surprise).
      */
     private emitSchemaDiagnostics;
+    /**
+     * Emit a `provider_diagnostic` when the resolved provider reports that it
+     * could not honor the unified `effort` verbatim (P3/R6/R7).
+     *
+     * The adapter only *resolves* — it returns the requested and effective levels
+     * from the same pure resolver its request builder uses. The runtime decides
+     * how to surface that, because only the runtime can see the event bus and
+     * `AxlConfig.diagnostics.silent` (adapters receive `ProviderConfig` only).
+     *
+     * Called once per ask, so a tool loop with N provider round trips still emits
+     * one event; the `console.warn` dedupes once per process per distinct clamp.
+     * A throwing `effortResolution` is a provider bug and propagates.
+     */
+    private emitProviderDiagnostics;
     private buildToolDefs;
     /**
      * Summarize old messages to fit within context window.
@@ -5145,6 +5287,7 @@ declare const REDACTION_RULES: {
     string_delta: RuleFor<"string_delta">;
     verify: RuleFor<"verify">;
     schema_diagnostic: RuleFor<"schema_diagnostic">;
+    provider_diagnostic: RuleFor<"provider_diagnostic">;
     log: RuleFor<"log">;
     memory_remember: RuleFor<"memory_remember">;
     memory_recall: RuleFor<"memory_recall">;
@@ -5272,6 +5415,9 @@ declare class OpenAIProvider extends OpenAICompatibleProvider {
         dangerouslyAllowInsecureHttp?: boolean;
         rateLimit?: RateLimitConfig;
     });
+    /** Report a clamped `effort` — Chat Completions caps `'max'` at `'xhigh'` and
+     *  rejects `'none'` before gpt-5.1 (clamped to `'minimal'`). */
+    effortResolution(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
     protected computeCost(model: string, usage: ProviderResponse['usage'], _reportedCost: number | undefined, context?: DirectOpenAIPricingContext): number | undefined;
 }
 
@@ -5289,6 +5435,10 @@ declare class OpenAIResponsesProvider implements Provider {
             sources: readonly InputMediaSource['type'][];
         };
     };
+    /** Report a clamped `effort`. Responses accepts the native `'max'` tier that
+     *  Chat Completions caps, but still clamps `'none'` before gpt-5.1, `'xhigh'`
+     *  below gpt-5.2, and everything to `'high'` on gpt-5-pro. */
+    effortResolution(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
     validateInput(request: ProviderInputValidationRequest): ProviderInputValidationResult;
     /** The Responses API honors `json_schema` (structured outputs) natively. */
     nativeStructuredOutputSupport(): 'schema';
@@ -5342,6 +5492,12 @@ declare class OpenAIResponsesProvider implements Provider {
  */
 declare class AnthropicProvider implements Provider {
     readonly name = "anthropic";
+    /** Report a clamped `effort`. Anthropic clamps to each model's supported
+     *  `output_config.effort` levels, and models that always think fall back to
+     *  adaptive `'low'` when asked to disable thinking. Only reported when the
+     *  effective level is what the request body actually carries; an explicit
+     *  `thinkingBudget` is documented to override `effort`, so it is not a clamp. */
+    effortResolution(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
     inputCapabilities(model: string): {
         image?: {
             sources: readonly InputMediaSource['type'][];
@@ -5428,6 +5584,11 @@ declare class GeminiProvider implements Provider {
      *  keywords it doesn't support (`$ref`/`$defs`/`additionalProperties`/…), so a
      *  derived schema can lose constraints — lossy, not faithful. */
     nativeStructuredOutputSupport(): 'lossy';
+    /** Report a clamped `effort` (R7a). Gemini 3.x cannot disable thinking and
+     *  caps at `'high'`, so `'none'`, `'xhigh'` and `'max'` are not honored
+     *  verbatim there. Everything else — including 2.x disabled thinking — is
+     *  sent as asked, so there is nothing to report. */
+    effortResolution(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
     private baseUrl;
     private apiKeySource;
     private callCounter;
@@ -6109,4 +6270,4 @@ declare class NoopSpanManager implements SpanManager {
  */
 declare function createSpanManager(config?: TelemetryConfig): Promise<SpanManager>;
 
-export { AXL_EVENT_TYPES, AXL_EVENT_TYPES_V2, AXL_TOOL_LIFECYCLE_TYPES_V2, AZURE_PROFILE, type Agent, type AgentCallEndData, type AgentCallInfo, type AgentCallParams, type AgentCallStartData, type AgentConfig, AnthropicProvider, type AnyWorkflow, type ApiKeySource, type AskOptions, type AskScoped, type AuthHeader, type AwaitHumanData, type AwaitHumanOptions, type AwaitHumanResolvedData, type AxlConfig, AxlError, type AxlEvent, type AxlEventBase, AxlEventBus, type AxlEventOf, type AxlEventType, type AxlEventV2, type AxlEventV2Of, AxlRuntime, AxlStream, BEDROCK_PROFILE, BUILTIN_PROFILES, BudgetExceededError, type BudgetOptions, type BudgetResult, CONFIG_CANDIDATES, COST_BEARING_LEAF_TYPES, type CapabilityFlags, type ChatMessage, type ChatOptions, type CheckpointEventData, type CoalescedPartialObject, type CreateContextOptions, DEEPSEEK_PROFILE, type DecisionCleanupFailedEvent, type DelegateData, type DelegateOptions, type Effort, type EmbedResult, type EmbedUsage, type Embedder, type EvalExecuteWorkflow, type EvalHistoryEntry, type EventStreamOptions, EventStreamOverflowError, type ExecuteOptions, type ExecutionInfo, type ExecutionInfoV1, type ExecutionInfoV2, type ExecutionState, GROQ_PROFILE, GeminiProvider, GeminiTranscriptionProvider, type GuardrailBlockHandler, type GuardrailData, GuardrailError, type GuardrailResult, type GuardrailsConfig, type HandoffDescriptor, type HandoffRecord, type HandoffReturnData, type HandoffStartData, type HistoricalAxlEvent, type HistoricalExecutionInfo, type HumanDecision, InMemoryVectorStore, type InputContentPart, type InputGuardrail, type InputImagePart, type InputMediaSource, type InputModalitySupport, type InputTextPart, InvalidModelInputError, InvalidTranscriptionInputError, LLAMACPP_PROFILE, LMSTUDIO_PROFILE, type LegacyAxlEventV1, type LegacyExecutionInfoV1, MAX_INLINE_MODEL_INPUT_BYTES, MAX_INLINE_TRANSCRIPTION_BYTES, MISTRAL_PROFILE, type MapOptions, MaxTurnsError, McpManager, type McpServer, type McpServerConfig, type McpToolDefinition, type McpToolResult, type MemoryConfig, type MemoryEventData, MemoryManager, MemoryStore, type ModelInput, type ModelInputDescriptor, NoConsensus, NoopSpanManager, OLLAMA_PROFILE, OPENAI_PRICING, OPENAI_PROFILE, OPENROUTER_PROFILE, type ObservationStatus, type OpenAICompatibleOptions, OpenAICompatibleProvider, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, OpenAITranscriptionProvider, OpenRouterTranscriptionProvider, type OutputGuardrail, type OutputValidator, type PendingDecision, type PerModel, type PricingSource, type PricingTable, type Provider, type ProviderAdapter, ProviderError, type ProviderInputValidationRequest, type ProviderInputValidationResult, type ProviderProfile, ProviderRegistry, type ProviderResponse, QuorumNotMet, REDACTED, REDACTION_RULES, type RaceOptions, type RateLimitConfig, RateLimiter, type ReasoningCapture, type ReasoningEmit, type ReasoningProfile, type ReasoningRoundTrip, type RecallOptions, type RecallResult, type RecordedAudioSource, RedisStore, type RememberOptions, type RememberResult, type ResolvedThinkingOptions, type Result, type RetryPolicy, SGLANG_PROFILE, SQLiteStore, type SchemaCheckData, type SchemaDiagnosticData, type SchemaPromptOption, Session, type SessionOptions, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StateStore, type StreamChunk, type StringDeltaData, type StringStreamEvent, type StringStreamFilter, type TelemetryConfig, ThinkTagScanner, TimeoutError, type Tool, type ToolApprovalData, type ToolArgumentIssue, type ToolCallCancellation, type ToolCallData, type ToolCallEndData, type ToolCallFailure, type ToolCallMessage, type ToolCallOutcome, type ToolCallRejectedData, type ToolCallRejectedEvent, type ToolCallStartData, type ToolCallStartDataV2, type ToolChoice, type ToolConfig, type ToolDeniedData, type ToolEventError, ToolFailure, type ToolFailureConstructor, type ToolFailureOptions, type ToolHooks, type ToolLifecycleEventV2, type ToolModelOutput, ToolModelOutputError, type Transcript, type TranscriptionCapabilities, TranscriptionOperationError, type TranscriptionProvider, TranscriptionProviderRegistry, type TranscriptionProviderRequest, type TranscriptionProviderResult, type TranscriptionRequest, UnsupportedEventSchemaVersionError, UnsupportedModelInputError, UnsupportedTranscriptionInputError, VLLM_PROFILE, type ValidateData, type ValidateResult, ValidationError, type VectorEntry, type VectorResult, type VectorStore, type VerifyData, VerifyError, type VerifyOptions, type VerifyRetry, type VoteOptions, type Workflow, type WorkflowConfig, WorkflowContext, type WorkflowContextInit, type WorkflowEndData, type WorkflowStartData, XAI_PROFILE, agent, createSpanManager, defineConfig, estimateOpenAICost, eventCostContribution, expandGlob, extractJson, extractThinkTags, findConfig, getEventSchemaVersion, getExecutionEventSchemaVersion, hasPositiveBillableWork, hasPositiveTokens, importModule, inputText, isCostBearingLeaf, isRetryableStatus, isRootLevel, isUnpricedLeaf, isUsableCost, needsTsxLoader, normalizeStoredExecution, openaiReasoningEmit, parsePartialJson, pickDefault, pickExport, priceFromTable, reasoningEffortEmit, reasoningObjectEmit, redactEvent, redactHistoricalEvent, registerConditions, resolveApiKey, resolvePerModel, resolveRuntime, resolveThinkingOptions, stringStreamFromEvents, tool, workflow, zodToJsonSchema };
+export { AXL_EVENT_TYPES, AXL_EVENT_TYPES_V2, AXL_TOOL_LIFECYCLE_TYPES_V2, AZURE_PROFILE, type Agent, type AgentCallEndData, type AgentCallInfo, type AgentCallParams, type AgentCallStartData, type AgentConfig, AnthropicProvider, type AnyWorkflow, type ApiKeySource, type AskOptions, type AskScoped, type AuthHeader, type AwaitHumanData, type AwaitHumanOptions, type AwaitHumanResolvedData, type AxlConfig, AxlError, type AxlEvent, type AxlEventBase, AxlEventBus, type AxlEventOf, type AxlEventType, type AxlEventV2, type AxlEventV2Of, AxlRuntime, AxlStream, BEDROCK_PROFILE, BUILTIN_PROFILES, BudgetExceededError, type BudgetOptions, type BudgetResult, CONFIG_CANDIDATES, COST_BEARING_LEAF_TYPES, type CapabilityFlags, type ChatMessage, type ChatOptions, type CheckpointEventData, type CoalescedPartialObject, type CreateContextOptions, DEEPSEEK_PROFILE, type DecisionCleanupFailedEvent, type DelegateData, type DelegateOptions, type Effort, type EffortResolution, type EmbedResult, type EmbedUsage, type Embedder, type EvalExecuteWorkflow, type EvalHistoryEntry, type EventStreamOptions, EventStreamOverflowError, type ExecuteOptions, type ExecutionInfo, type ExecutionInfoV1, type ExecutionInfoV2, type ExecutionState, GROQ_PROFILE, GeminiProvider, GeminiTranscriptionProvider, type GuardrailBlockHandler, type GuardrailData, GuardrailError, type GuardrailResult, type GuardrailsConfig, type HandoffDescriptor, type HandoffRecord, type HandoffReturnData, type HandoffStartData, type HistoricalAxlEvent, type HistoricalExecutionInfo, type HumanDecision, InMemoryVectorStore, type InputContentPart, type InputGuardrail, type InputImagePart, type InputMediaSource, type InputModalitySupport, type InputTextPart, InvalidModelInputError, InvalidTranscriptionInputError, LLAMACPP_PROFILE, LMSTUDIO_PROFILE, type LegacyAxlEventV1, type LegacyExecutionInfoV1, MAX_INLINE_MODEL_INPUT_BYTES, MAX_INLINE_TRANSCRIPTION_BYTES, MISTRAL_PROFILE, type MapOptions, MaxTurnsError, McpManager, type McpServer, type McpServerConfig, type McpToolDefinition, type McpToolResult, type MemoryConfig, type MemoryEventData, MemoryManager, MemoryStore, type ModelInput, type ModelInputDescriptor, NoConsensus, NoopSpanManager, OLLAMA_PROFILE, OPENAI_PRICING, OPENAI_PROFILE, OPENROUTER_PROFILE, type ObservationStatus, type OpenAICompatibleOptions, OpenAICompatibleProvider, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, OpenAITranscriptionProvider, OpenRouterTranscriptionProvider, type OutputGuardrail, type OutputValidator, type PendingDecision, type PerModel, type PricingSource, type PricingTable, type Provider, type ProviderAdapter, type ProviderDiagnosticData, ProviderError, type ProviderInputValidationRequest, type ProviderInputValidationResult, type ProviderProfile, ProviderRegistry, type ProviderResponse, QuorumNotMet, REDACTED, REDACTION_RULES, type RaceOptions, type RateLimitConfig, RateLimiter, type ReasoningCapture, type ReasoningEmit, type ReasoningProfile, type ReasoningRoundTrip, type RecallOptions, type RecallResult, type RecordedAudioSource, RedisStore, type RememberOptions, type RememberResult, type ResolvedThinkingOptions, type Result, type RetryFeedbackHook, type RetryFeedbackInfo, type RetryFeedbackResult, type RetryPolicy, SGLANG_PROFILE, SQLiteStore, type SchemaCheckData, type SchemaDiagnosticData, type SchemaPromptOption, Session, type SessionOptions, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StateStore, type StreamChunk, type StringDeltaData, type StringStreamEvent, type StringStreamFilter, type TelemetryConfig, ThinkTagScanner, TimeoutError, type Tool, type ToolApprovalData, type ToolArgumentIssue, type ToolCallCancellation, type ToolCallData, type ToolCallEndData, type ToolCallFailure, type ToolCallMessage, type ToolCallOutcome, type ToolCallRejectedData, type ToolCallRejectedEvent, type ToolCallStartData, type ToolCallStartDataV2, type ToolChoice, type ToolConfig, type ToolDeniedData, type ToolEventError, ToolFailure, type ToolFailureConstructor, type ToolFailureOptions, type ToolHooks, type ToolLifecycleEventV2, type ToolModelOutput, ToolModelOutputError, type Transcript, type TranscriptionCapabilities, TranscriptionOperationError, type TranscriptionProvider, TranscriptionProviderRegistry, type TranscriptionProviderRequest, type TranscriptionProviderResult, type TranscriptionRequest, UnsupportedEventSchemaVersionError, UnsupportedModelInputError, UnsupportedTranscriptionInputError, VLLM_PROFILE, type ValidateData, type ValidateResult, ValidationError, type VectorEntry, type VectorResult, type VectorStore, type VerifyData, VerifyError, type VerifyOptions, type VerifyRetry, type VoteOptions, type Workflow, type WorkflowConfig, WorkflowContext, type WorkflowContextInit, type WorkflowEndData, type WorkflowStartData, XAI_PROFILE, agent, createSpanManager, defineConfig, estimateOpenAICost, eventCostContribution, expandGlob, extractJson, extractThinkTags, findConfig, getEventSchemaVersion, getExecutionEventSchemaVersion, hasPositiveBillableWork, hasPositiveTokens, importModule, inputText, isCostBearingLeaf, isRetryableStatus, isRootLevel, isUnpricedLeaf, isUsableCost, needsTsxLoader, normalizeStoredExecution, openaiReasoningEmit, parsePartialJson, pickDefault, pickExport, priceFromTable, reasoningEffortEmit, reasoningObjectEmit, redactEvent, redactHistoricalEvent, registerConditions, resolveApiKey, resolvePerModel, resolveRuntime, resolveThinkingOptions, stringStreamFromEvents, tool, workflow, zodToJsonSchema };

package/dist/index.d.ts

@@ -228,7 +228,46 @@ interface Provider {
      *    JSON instruction instead (e.g. Anthropic).
      */
     nativeStructuredOutputSupport?(model: string): 'schema' | 'downgraded' | 'lossy' | 'unsupported';
+    /**
+     * How this provider resolved the unified `effort` knob for this request.
+     *
+     * Adapters clamp `effort` to what each model actually accepts (Gemini 3.x
+     * cannot disable thinking; OpenAI Chat Completions caps `'max'` at `'xhigh'`;
+     * Anthropic models that always think fall back to adaptive `'low'`). That
+     * clamp used to be invisible to run provenance. The runtime calls this once
+     * per ask, right after provider resolution, and emits a
+     * `provider_diagnostic { kind: 'effort_clamped' }` event plus a deduped
+     * `console.warn` when `clamped` is true — the adapter only *reports*, the
+     * runtime decides how to surface it (only the runtime can see
+     * `AxlConfig.diagnostics.silent`).
+     *
+     * The adapter applies its own `providerOptions.model` override before
+     * resolving, so the report describes the model actually sent.
+     *
+     * Optional, and optional to answer: return `undefined` when there is nothing
+     * to report (no effort requested, the model is unknown, or the effort is
+     * honored verbatim). An adapter MAY also report an honored resolution with
+     * `clamped: false`; the runtime stays silent for those.
+     */
+    effortResolution?(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
 }
+/**
+ * An adapter's report of how it resolved the unified `effort` for one request.
+ *
+ * `effective` is a provider-NATIVE level string rather than an `Effort` because
+ * not every effective value maps back onto the unified union (Gemini's
+ * `'minimal'`, OpenAI's `'minimal'`, Anthropic's adaptive `'low'`).
+ */
+type EffortResolution = {
+    /** The unified effort the caller asked for. */
+    requested: Effort;
+    /** The provider-native level actually sent (e.g. `'minimal'`, `'xhigh'`, `'low'`). */
+    effective: string;
+    /** True when `effective` is not what `requested` asked for. */
+    clamped: boolean;
+    /** Human-readable reason, surfaced verbatim on the diagnostic event. */
+    cause?: string;
+};
 /**
  * Alias for Provider. Used for backward compatibility with index.ts exports.
  */
@@ -374,6 +413,10 @@ type AskOptions<T = unknown> = {
     validate?: OutputValidator<T>;
     /** Maximum retries for validate failures (default: 2). */
     validateRetries?: number;
+    /** Rewrite the corrective feedback the model sees when the guardrail, schema, or validate
+     *  gate rejects an attempt — or abort the retry with `{ retry: false }`. See
+     *  `RetryFeedbackHook`. */
+    retryFeedback?: RetryFeedbackHook<T>;
     /** Per-call metadata passed to dynamic model/system selector functions. */
     metadata?: Record<string, unknown>;
     /** Override temperature for this call. */
@@ -415,6 +458,9 @@ type DelegateOptions<T = unknown> = {
     validate?: OutputValidator<T>;
     /** Maximum retries for validate failures (default: 2). Passed through to the final `ctx.ask()` call. */
     validateRetries?: number;
+    /** Custom gate-retry feedback. Passed through to the final `ctx.ask()` call on both the
+     *  single-candidate and the routed path. See `RetryFeedbackHook`. */
+    retryFeedback?: RetryFeedbackHook<T>;
 };
 /** Race options */
 type RaceOptions<T = unknown> = {
@@ -430,11 +476,11 @@ type ExecutionStatus = 'running' | 'completed' | 'failed' | 'waiting';
  * derive `AxlEventType` from this tuple and use it to validate stream filters,
  * redaction tables, and exhaustiveness assertions.
  */
-declare const AXL_EVENT_TYPES: readonly ["workflow_start", "workflow_end", "transcription_start", "transcription_end", "ask_start", "ask_end", "agent_call_start", "agent_call_end", "token", "tool_call_start", "tool_call_end", "tool_call_rejected", "tool_approval", "delegate", "handoff_start", "handoff_return", "pipeline", "partial_object", "string_delta", "verify", "schema_diagnostic", "log", "memory_remember", "memory_recall", "memory_forget", "checkpoint_save", "checkpoint_replay", "await_human", "await_human_resolved", "guardrail", "schema_check", "validate", "done", "error"];
+declare const AXL_EVENT_TYPES: readonly ["workflow_start", "workflow_end", "transcription_start", "transcription_end", "ask_start", "ask_end", "agent_call_start", "agent_call_end", "token", "tool_call_start", "tool_call_end", "tool_call_rejected", "tool_approval", "delegate", "handoff_start", "handoff_return", "pipeline", "partial_object", "string_delta", "verify", "schema_diagnostic", "provider_diagnostic", "log", "memory_remember", "memory_recall", "memory_forget", "checkpoint_save", "checkpoint_replay", "await_human", "await_human_resolved", "guardrail", "schema_check", "validate", "done", "error"];
 /** Discriminator union derived from `AXL_EVENT_TYPES`. */
 type AxlEventType = (typeof AXL_EVENT_TYPES)[number];
 /** Backward-compatible name for the canonical v2 writer discriminator list. */
-declare const AXL_EVENT_TYPES_V2: readonly ["workflow_start", "workflow_end", "transcription_start", "transcription_end", "ask_start", "ask_end", "agent_call_start", "agent_call_end", "token", "tool_call_start", "tool_call_end", "tool_call_rejected", "tool_approval", "delegate", "handoff_start", "handoff_return", "pipeline", "partial_object", "string_delta", "verify", "schema_diagnostic", "log", "memory_remember", "memory_recall", "memory_forget", "checkpoint_save", "checkpoint_replay", "await_human", "await_human_resolved", "guardrail", "schema_check", "validate", "done", "error"];
+declare const AXL_EVENT_TYPES_V2: readonly ["workflow_start", "workflow_end", "transcription_start", "transcription_end", "ask_start", "ask_end", "agent_call_start", "agent_call_end", "token", "tool_call_start", "tool_call_end", "tool_call_rejected", "tool_approval", "delegate", "handoff_start", "handoff_return", "pipeline", "partial_object", "string_delta", "verify", "schema_diagnostic", "provider_diagnostic", "log", "memory_remember", "memory_recall", "memory_forget", "checkpoint_save", "checkpoint_replay", "await_human", "await_human_resolved", "guardrail", "schema_check", "validate", "done", "error"];
 /** Accepted/rejected tool lifecycle discriminators in event schema v2. */
 declare const AXL_TOOL_LIFECYCLE_TYPES_V2: readonly ["tool_call_start", "tool_call_end", "tool_call_rejected"];
 /** Resolved model parameters sent to the provider for an LLM call. */
@@ -779,6 +825,34 @@ type SchemaDiagnosticData = {
     provider?: string;
     support: 'downgraded' | 'lossy' | 'unsupported';
 };
+/**
+ * Data for the `provider_diagnostic` event — a `kind`-discriminated payload
+ * (like `SchemaDiagnosticData`) reporting that the resolved provider could not
+ * honor a portable request knob verbatim.
+ *
+ *  - `effort_clamped` — the adapter clamped the unified `effort` to what the
+ *    model actually accepts (Gemini 3.x cannot disable thinking; OpenAI Chat
+ *    Completions caps `'max'` at `'xhigh'`; Anthropic models that always think
+ *    fall back to adaptive `'low'`). `requested` is the unified value the caller
+ *    asked for; `effective` is the provider-native level actually sent, which is
+ *    deliberately a free string because not every native level maps back onto
+ *    `Effort`. One per ask, emitted before the first `agent_call_start` — join it
+ *    to `agent_call_start` (which keeps reporting the *requested* effort) by
+ *    `askId` for full provenance.
+ *
+ * The union is `kind`-discriminated so later provider cliffs can join without a
+ * new event type.
+ */
+type ProviderDiagnosticData = {
+    kind: 'effort_clamped';
+    /** Provider name (`provider.name`), when the adapter exposes one. */
+    provider?: string;
+    /** The model the request is actually sent to (after any `providerOptions.model`). */
+    model: string;
+    requested: Effort;
+    effective: string;
+    cause: string;
+};
 /** Data shape for legacy `guardrail` events. Replaced by `pipeline` in PR 2. */
 type GuardrailData = {
     guardrailType: 'input' | 'output';
@@ -1132,6 +1206,9 @@ type LegacyAxlEventPayloadV1 = (AxlEventBase & {
 }) | (AxlEventBase & AskScoped & {
     type: 'schema_diagnostic';
     data: SchemaDiagnosticData;
+}) | (AxlEventBase & AskScoped & {
+    type: 'provider_diagnostic';
+    data: ProviderDiagnosticData;
 }) | (AxlEventBase & Partial<AskScoped> & {
     type: 'guardrail';
     data?: GuardrailData;
@@ -1319,6 +1396,43 @@ type ValidateResult = {
 type OutputValidator<T = unknown> = (output: T, ctx: {
     metadata: Record<string, unknown>;
 }) => ValidateResult | Promise<ValidateResult>;
+/** What a rejecting output gate tells a `retryFeedback` hook about the attempt it is
+ *  about to retry. One shape for all three gates — `stage` discriminates. */
+type RetryFeedbackInfo<T = unknown> = {
+    /** Which gate rejected: JSON/Zod parse, post-schema `validate`, or output guardrail. */
+    stage: 'schema' | 'validate' | 'guardrail';
+    /** 1-based index of the attempt that was just rejected. */
+    attempt: number;
+    /** Total attempts this gate allows (`retries` + 1). */
+    maxAttempts: number;
+    /** Raw model output that was rejected. */
+    output: string;
+    /** The parsed, schema-valid object, typed by the ask's `schema`. Present only for
+     *  `stage: 'validate'` — the other gates run before or without a parsed value. */
+    parsed?: T;
+    /** The gate's own reason (Zod message, `ValidateResult.reason`, guardrail reason). */
+    reason: string;
+    /** The `ZodError` (or non-Zod parse error) for `schema`; the validator's thrown error for
+     *  `validate` when it threw. Absent for `guardrail` and for a clean `validate` rejection. */
+    error?: unknown;
+    /** The feedback text the runtime would send if the hook did not intervene. */
+    defaultMessage: string;
+};
+/** A non-empty string replaces `defaultMessage` verbatim; `undefined` (or `''`) keeps it;
+ *  `{ retry: false }` stops retrying and makes the gate throw its typed terminal error. */
+type RetryFeedbackResult = string | undefined | {
+    retry: false;
+};
+/** Rewrites (or aborts) the corrective turn the model sees after an output gate rejects an
+ *  attempt. Runs only while a retry is still permitted — never on the exhausting attempt —
+ *  and after the gate's own event is emitted. Exceptions propagate to the caller.
+ *
+ *  `void` is accepted alongside `RetryFeedbackResult` so a hook used purely for logging or
+ *  inspection — a block body that never returns — type-checks; it keeps the default text.
+ *  Any other return value is a contract violation and throws a `TypeError`. */
+type RetryFeedbackHook<T = unknown> = (info: RetryFeedbackInfo<T>, ctx: {
+    metadata: Record<string, unknown>;
+}) => RetryFeedbackResult | void | Promise<RetryFeedbackResult | void>;
 /** Execution info */
 type ExecutionInfoV1 = {
     executionId: string;
@@ -3534,6 +3648,20 @@ declare class WorkflowContext<TInput = unknown> {
     private observeToolInvocation;
     ask<T = string>(agent: Agent, prompt: ModelInput, options?: AskOptions<T>): Promise<T>;
     private executeAgentCall;
+    /**
+     * Resolve the corrective feedback text for one rejected attempt, giving an optional
+     * caller-supplied `retryFeedback` hook the chance to replace it or to stop retrying.
+     *
+     * Called by all three output gates, only while a retry is still permitted (never on the
+     * exhausting attempt) and only after the gate's own event has been emitted, so a hook that
+     * throws or aborts can never erase the evidence that the gate rejected. A non-empty string
+     * replaces `defaultMessage` verbatim; `undefined` / `''` keeps it; `{ retry: false }` asks
+     * the gate to throw its typed terminal error. Hook exceptions propagate — a bug in caller
+     * code is not a model failure and must not be retried into silence, and neither is a
+     * return value outside the contract: an unrecognized shape throws instead of silently
+     * degrading to the default text, which would hide the defect behind extra token spend.
+     */
+    private resolveRetryFeedback;
     /**
      * Push the final assistant message into session history, preserving providerMetadata
      * (e.g., Gemini thought signatures needed for multi-turn reasoning context) and
@@ -3557,6 +3685,20 @@ declare class WorkflowContext<TInput = unknown> {
      * (expected behavior for any tool-using agent, not a surprise).
      */
     private emitSchemaDiagnostics;
+    /**
+     * Emit a `provider_diagnostic` when the resolved provider reports that it
+     * could not honor the unified `effort` verbatim (P3/R6/R7).
+     *
+     * The adapter only *resolves* — it returns the requested and effective levels
+     * from the same pure resolver its request builder uses. The runtime decides
+     * how to surface that, because only the runtime can see the event bus and
+     * `AxlConfig.diagnostics.silent` (adapters receive `ProviderConfig` only).
+     *
+     * Called once per ask, so a tool loop with N provider round trips still emits
+     * one event; the `console.warn` dedupes once per process per distinct clamp.
+     * A throwing `effortResolution` is a provider bug and propagates.
+     */
+    private emitProviderDiagnostics;
     private buildToolDefs;
     /**
      * Summarize old messages to fit within context window.
@@ -5145,6 +5287,7 @@ declare const REDACTION_RULES: {
     string_delta: RuleFor<"string_delta">;
     verify: RuleFor<"verify">;
     schema_diagnostic: RuleFor<"schema_diagnostic">;
+    provider_diagnostic: RuleFor<"provider_diagnostic">;
     log: RuleFor<"log">;
     memory_remember: RuleFor<"memory_remember">;
     memory_recall: RuleFor<"memory_recall">;
@@ -5272,6 +5415,9 @@ declare class OpenAIProvider extends OpenAICompatibleProvider {
         dangerouslyAllowInsecureHttp?: boolean;
         rateLimit?: RateLimitConfig;
     });
+    /** Report a clamped `effort` — Chat Completions caps `'max'` at `'xhigh'` and
+     *  rejects `'none'` before gpt-5.1 (clamped to `'minimal'`). */
+    effortResolution(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
     protected computeCost(model: string, usage: ProviderResponse['usage'], _reportedCost: number | undefined, context?: DirectOpenAIPricingContext): number | undefined;
 }
 
@@ -5289,6 +5435,10 @@ declare class OpenAIResponsesProvider implements Provider {
             sources: readonly InputMediaSource['type'][];
         };
     };
+    /** Report a clamped `effort`. Responses accepts the native `'max'` tier that
+     *  Chat Completions caps, but still clamps `'none'` before gpt-5.1, `'xhigh'`
+     *  below gpt-5.2, and everything to `'high'` on gpt-5-pro. */
+    effortResolution(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
     validateInput(request: ProviderInputValidationRequest): ProviderInputValidationResult;
     /** The Responses API honors `json_schema` (structured outputs) natively. */
     nativeStructuredOutputSupport(): 'schema';
@@ -5342,6 +5492,12 @@ declare class OpenAIResponsesProvider implements Provider {
  */
 declare class AnthropicProvider implements Provider {
     readonly name = "anthropic";
+    /** Report a clamped `effort`. Anthropic clamps to each model's supported
+     *  `output_config.effort` levels, and models that always think fall back to
+     *  adaptive `'low'` when asked to disable thinking. Only reported when the
+     *  effective level is what the request body actually carries; an explicit
+     *  `thinkingBudget` is documented to override `effort`, so it is not a clamp. */
+    effortResolution(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
     inputCapabilities(model: string): {
         image?: {
             sources: readonly InputMediaSource['type'][];
@@ -5428,6 +5584,11 @@ declare class GeminiProvider implements Provider {
      *  keywords it doesn't support (`$ref`/`$defs`/`additionalProperties`/…), so a
      *  derived schema can lose constraints — lossy, not faithful. */
     nativeStructuredOutputSupport(): 'lossy';
+    /** Report a clamped `effort` (R7a). Gemini 3.x cannot disable thinking and
+     *  caps at `'high'`, so `'none'`, `'xhigh'` and `'max'` are not honored
+     *  verbatim there. Everything else — including 2.x disabled thinking — is
+     *  sent as asked, so there is nothing to report. */
+    effortResolution(options: Pick<ChatOptions, 'model' | 'effort' | 'thinkingBudget' | 'includeThoughts' | 'providerOptions'>): EffortResolution | undefined;
     private baseUrl;
     private apiKeySource;
     private callCounter;
@@ -6109,4 +6270,4 @@ declare class NoopSpanManager implements SpanManager {
  */
 declare function createSpanManager(config?: TelemetryConfig): Promise<SpanManager>;
 
-export { AXL_EVENT_TYPES, AXL_EVENT_TYPES_V2, AXL_TOOL_LIFECYCLE_TYPES_V2, AZURE_PROFILE, type Agent, type AgentCallEndData, type AgentCallInfo, type AgentCallParams, type AgentCallStartData, type AgentConfig, AnthropicProvider, type AnyWorkflow, type ApiKeySource, type AskOptions, type AskScoped, type AuthHeader, type AwaitHumanData, type AwaitHumanOptions, type AwaitHumanResolvedData, type AxlConfig, AxlError, type AxlEvent, type AxlEventBase, AxlEventBus, type AxlEventOf, type AxlEventType, type AxlEventV2, type AxlEventV2Of, AxlRuntime, AxlStream, BEDROCK_PROFILE, BUILTIN_PROFILES, BudgetExceededError, type BudgetOptions, type BudgetResult, CONFIG_CANDIDATES, COST_BEARING_LEAF_TYPES, type CapabilityFlags, type ChatMessage, type ChatOptions, type CheckpointEventData, type CoalescedPartialObject, type CreateContextOptions, DEEPSEEK_PROFILE, type DecisionCleanupFailedEvent, type DelegateData, type DelegateOptions, type Effort, type EmbedResult, type EmbedUsage, type Embedder, type EvalExecuteWorkflow, type EvalHistoryEntry, type EventStreamOptions, EventStreamOverflowError, type ExecuteOptions, type ExecutionInfo, type ExecutionInfoV1, type ExecutionInfoV2, type ExecutionState, GROQ_PROFILE, GeminiProvider, GeminiTranscriptionProvider, type GuardrailBlockHandler, type GuardrailData, GuardrailError, type GuardrailResult, type GuardrailsConfig, type HandoffDescriptor, type HandoffRecord, type HandoffReturnData, type HandoffStartData, type HistoricalAxlEvent, type HistoricalExecutionInfo, type HumanDecision, InMemoryVectorStore, type InputContentPart, type InputGuardrail, type InputImagePart, type InputMediaSource, type InputModalitySupport, type InputTextPart, InvalidModelInputError, InvalidTranscriptionInputError, LLAMACPP_PROFILE, LMSTUDIO_PROFILE, type LegacyAxlEventV1, type LegacyExecutionInfoV1, MAX_INLINE_MODEL_INPUT_BYTES, MAX_INLINE_TRANSCRIPTION_BYTES, MISTRAL_PROFILE, type MapOptions, MaxTurnsError, McpManager, type McpServer, type McpServerConfig, type McpToolDefinition, type McpToolResult, type MemoryConfig, type MemoryEventData, MemoryManager, MemoryStore, type ModelInput, type ModelInputDescriptor, NoConsensus, NoopSpanManager, OLLAMA_PROFILE, OPENAI_PRICING, OPENAI_PROFILE, OPENROUTER_PROFILE, type ObservationStatus, type OpenAICompatibleOptions, OpenAICompatibleProvider, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, OpenAITranscriptionProvider, OpenRouterTranscriptionProvider, type OutputGuardrail, type OutputValidator, type PendingDecision, type PerModel, type PricingSource, type PricingTable, type Provider, type ProviderAdapter, ProviderError, type ProviderInputValidationRequest, type ProviderInputValidationResult, type ProviderProfile, ProviderRegistry, type ProviderResponse, QuorumNotMet, REDACTED, REDACTION_RULES, type RaceOptions, type RateLimitConfig, RateLimiter, type ReasoningCapture, type ReasoningEmit, type ReasoningProfile, type ReasoningRoundTrip, type RecallOptions, type RecallResult, type RecordedAudioSource, RedisStore, type RememberOptions, type RememberResult, type ResolvedThinkingOptions, type Result, type RetryPolicy, SGLANG_PROFILE, SQLiteStore, type SchemaCheckData, type SchemaDiagnosticData, type SchemaPromptOption, Session, type SessionOptions, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StateStore, type StreamChunk, type StringDeltaData, type StringStreamEvent, type StringStreamFilter, type TelemetryConfig, ThinkTagScanner, TimeoutError, type Tool, type ToolApprovalData, type ToolArgumentIssue, type ToolCallCancellation, type ToolCallData, type ToolCallEndData, type ToolCallFailure, type ToolCallMessage, type ToolCallOutcome, type ToolCallRejectedData, type ToolCallRejectedEvent, type ToolCallStartData, type ToolCallStartDataV2, type ToolChoice, type ToolConfig, type ToolDeniedData, type ToolEventError, ToolFailure, type ToolFailureConstructor, type ToolFailureOptions, type ToolHooks, type ToolLifecycleEventV2, type ToolModelOutput, ToolModelOutputError, type Transcript, type TranscriptionCapabilities, TranscriptionOperationError, type TranscriptionProvider, TranscriptionProviderRegistry, type TranscriptionProviderRequest, type TranscriptionProviderResult, type TranscriptionRequest, UnsupportedEventSchemaVersionError, UnsupportedModelInputError, UnsupportedTranscriptionInputError, VLLM_PROFILE, type ValidateData, type ValidateResult, ValidationError, type VectorEntry, type VectorResult, type VectorStore, type VerifyData, VerifyError, type VerifyOptions, type VerifyRetry, type VoteOptions, type Workflow, type WorkflowConfig, WorkflowContext, type WorkflowContextInit, type WorkflowEndData, type WorkflowStartData, XAI_PROFILE, agent, createSpanManager, defineConfig, estimateOpenAICost, eventCostContribution, expandGlob, extractJson, extractThinkTags, findConfig, getEventSchemaVersion, getExecutionEventSchemaVersion, hasPositiveBillableWork, hasPositiveTokens, importModule, inputText, isCostBearingLeaf, isRetryableStatus, isRootLevel, isUnpricedLeaf, isUsableCost, needsTsxLoader, normalizeStoredExecution, openaiReasoningEmit, parsePartialJson, pickDefault, pickExport, priceFromTable, reasoningEffortEmit, reasoningObjectEmit, redactEvent, redactHistoricalEvent, registerConditions, resolveApiKey, resolvePerModel, resolveRuntime, resolveThinkingOptions, stringStreamFromEvents, tool, workflow, zodToJsonSchema };
+export { AXL_EVENT_TYPES, AXL_EVENT_TYPES_V2, AXL_TOOL_LIFECYCLE_TYPES_V2, AZURE_PROFILE, type Agent, type AgentCallEndData, type AgentCallInfo, type AgentCallParams, type AgentCallStartData, type AgentConfig, AnthropicProvider, type AnyWorkflow, type ApiKeySource, type AskOptions, type AskScoped, type AuthHeader, type AwaitHumanData, type AwaitHumanOptions, type AwaitHumanResolvedData, type AxlConfig, AxlError, type AxlEvent, type AxlEventBase, AxlEventBus, type AxlEventOf, type AxlEventType, type AxlEventV2, type AxlEventV2Of, AxlRuntime, AxlStream, BEDROCK_PROFILE, BUILTIN_PROFILES, BudgetExceededError, type BudgetOptions, type BudgetResult, CONFIG_CANDIDATES, COST_BEARING_LEAF_TYPES, type CapabilityFlags, type ChatMessage, type ChatOptions, type CheckpointEventData, type CoalescedPartialObject, type CreateContextOptions, DEEPSEEK_PROFILE, type DecisionCleanupFailedEvent, type DelegateData, type DelegateOptions, type Effort, type EffortResolution, type EmbedResult, type EmbedUsage, type Embedder, type EvalExecuteWorkflow, type EvalHistoryEntry, type EventStreamOptions, EventStreamOverflowError, type ExecuteOptions, type ExecutionInfo, type ExecutionInfoV1, type ExecutionInfoV2, type ExecutionState, GROQ_PROFILE, GeminiProvider, GeminiTranscriptionProvider, type GuardrailBlockHandler, type GuardrailData, GuardrailError, type GuardrailResult, type GuardrailsConfig, type HandoffDescriptor, type HandoffRecord, type HandoffReturnData, type HandoffStartData, type HistoricalAxlEvent, type HistoricalExecutionInfo, type HumanDecision, InMemoryVectorStore, type InputContentPart, type InputGuardrail, type InputImagePart, type InputMediaSource, type InputModalitySupport, type InputTextPart, InvalidModelInputError, InvalidTranscriptionInputError, LLAMACPP_PROFILE, LMSTUDIO_PROFILE, type LegacyAxlEventV1, type LegacyExecutionInfoV1, MAX_INLINE_MODEL_INPUT_BYTES, MAX_INLINE_TRANSCRIPTION_BYTES, MISTRAL_PROFILE, type MapOptions, MaxTurnsError, McpManager, type McpServer, type McpServerConfig, type McpToolDefinition, type McpToolResult, type MemoryConfig, type MemoryEventData, MemoryManager, MemoryStore, type ModelInput, type ModelInputDescriptor, NoConsensus, NoopSpanManager, OLLAMA_PROFILE, OPENAI_PRICING, OPENAI_PROFILE, OPENROUTER_PROFILE, type ObservationStatus, type OpenAICompatibleOptions, OpenAICompatibleProvider, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, OpenAITranscriptionProvider, OpenRouterTranscriptionProvider, type OutputGuardrail, type OutputValidator, type PendingDecision, type PerModel, type PricingSource, type PricingTable, type Provider, type ProviderAdapter, type ProviderDiagnosticData, ProviderError, type ProviderInputValidationRequest, type ProviderInputValidationResult, type ProviderProfile, ProviderRegistry, type ProviderResponse, QuorumNotMet, REDACTED, REDACTION_RULES, type RaceOptions, type RateLimitConfig, RateLimiter, type ReasoningCapture, type ReasoningEmit, type ReasoningProfile, type ReasoningRoundTrip, type RecallOptions, type RecallResult, type RecordedAudioSource, RedisStore, type RememberOptions, type RememberResult, type ResolvedThinkingOptions, type Result, type RetryFeedbackHook, type RetryFeedbackInfo, type RetryFeedbackResult, type RetryPolicy, SGLANG_PROFILE, SQLiteStore, type SchemaCheckData, type SchemaDiagnosticData, type SchemaPromptOption, Session, type SessionOptions, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StateStore, type StreamChunk, type StringDeltaData, type StringStreamEvent, type StringStreamFilter, type TelemetryConfig, ThinkTagScanner, TimeoutError, type Tool, type ToolApprovalData, type ToolArgumentIssue, type ToolCallCancellation, type ToolCallData, type ToolCallEndData, type ToolCallFailure, type ToolCallMessage, type ToolCallOutcome, type ToolCallRejectedData, type ToolCallRejectedEvent, type ToolCallStartData, type ToolCallStartDataV2, type ToolChoice, type ToolConfig, type ToolDeniedData, type ToolEventError, ToolFailure, type ToolFailureConstructor, type ToolFailureOptions, type ToolHooks, type ToolLifecycleEventV2, type ToolModelOutput, ToolModelOutputError, type Transcript, type TranscriptionCapabilities, TranscriptionOperationError, type TranscriptionProvider, TranscriptionProviderRegistry, type TranscriptionProviderRequest, type TranscriptionProviderResult, type TranscriptionRequest, UnsupportedEventSchemaVersionError, UnsupportedModelInputError, UnsupportedTranscriptionInputError, VLLM_PROFILE, type ValidateData, type ValidateResult, ValidationError, type VectorEntry, type VectorResult, type VectorStore, type VerifyData, VerifyError, type VerifyOptions, type VerifyRetry, type VoteOptions, type Workflow, type WorkflowConfig, WorkflowContext, type WorkflowContextInit, type WorkflowEndData, type WorkflowStartData, XAI_PROFILE, agent, createSpanManager, defineConfig, estimateOpenAICost, eventCostContribution, expandGlob, extractJson, extractThinkTags, findConfig, getEventSchemaVersion, getExecutionEventSchemaVersion, hasPositiveBillableWork, hasPositiveTokens, importModule, inputText, isCostBearingLeaf, isRetryableStatus, isRootLevel, isUnpricedLeaf, isUsableCost, needsTsxLoader, normalizeStoredExecution, openaiReasoningEmit, parsePartialJson, pickDefault, pickExport, priceFromTable, reasoningEffortEmit, reasoningObjectEmit, redactEvent, redactHistoricalEvent, registerConditions, resolveApiKey, resolvePerModel, resolveRuntime, resolveThinkingOptions, stringStreamFromEvents, tool, workflow, zodToJsonSchema };