@axlsdk/axl 0.22.3 → 0.23.0

package/dist/index.d.ts

@@ -128,6 +128,12 @@ type ChatOptions = {
      *  'none' disables thinking/reasoning (Gemini 3.x: maps to minimal).
      *  Omit to use provider defaults. */
     effort?: Effort;
+    /** Opt in to provider prompt caching of the stable request prefix (system
+     *  prompt + tool definitions). Anthropic requires an explicit `cache_control`
+     *  breakpoint; OpenAI and Gemini cache automatically, so this is a no-op
+     *  there. Off by default: a prefix that changes every call (a system prompt
+     *  built from `ctx.metadata`) pays the cache-write premium with no reads. */
+    promptCache?: boolean;
     /** Precise thinking token budget (advanced). When set alongside `effort`, overrides the
      *  thinking/reasoning allocation. On Anthropic 4.6, `effort` still controls output quality
      *  independently. On all other providers, `thinkingBudget` fully overrides `effort` for
@@ -187,6 +193,12 @@ type StreamChunk = {
     cost?: number;
     /** Provider-specific opaque metadata (e.g. raw Gemini parts with thought signatures). */
     providerMetadata?: Record<string, unknown>;
+    /**
+     * Per-call latency breakdown. The `done` chunk is the only channel a
+     * stream has back to the runtime, so every terminal `done` must carry it
+     * — including the usage-less fallbacks, or a $0 stream loses its timing.
+     */
+    timing?: CallTiming;
 };
 /**
  * Core provider interface. Every LLM adapter must implement this.
@@ -228,6 +240,16 @@ interface Provider {
      *    JSON instruction instead (e.g. Anthropic).
      */
     nativeStructuredOutputSupport?(model: string): 'schema' | 'downgraded' | 'lossy' | 'unsupported';
+    /**
+     * Whether this adapter realizes `ChatOptions.promptCache` for this model --
+     * i.e. actually places a cache breakpoint on the request. The runtime only
+     * emits the promptCache diagnostics (cold writes with no reads; no cache
+     * activity at all) for adapters that declare this, because on providers
+     * that cache automatically the absence of cache fields is not a signal.
+     * Adapters that omit this method opt out; the built-in Anthropic adapter is
+     * the only one that declares it today.
+     */
+    realizesPromptCache?(model: string): boolean;
     /**
      * How this provider resolved the unified `effort` knob for this request.
      *
@@ -429,6 +451,8 @@ type AskOptions<T = unknown> = {
     thinkingBudget?: number;
     /** Show reasoning summaries in responses. */
     includeThoughts?: boolean;
+    /** Override prompt caching of the stable prefix for this call. */
+    promptCache?: boolean;
     /** Tool choice strategy for this call. */
     toolChoice?: ToolChoice;
     /** Stop sequences for this call. */
@@ -1119,6 +1143,12 @@ type LegacyAxlEventPayloadV1 = (AxlEventBase & {
         cached?: number;
         cacheWrite?: number;
     };
+    /** Per-call latency breakdown when the provider reported one. Additive
+     *  beside `duration`, which keeps its turn-wall-clock meaning (queue,
+     *  retries, gates and all). Present on the error path too when the
+     *  provider returned a response (any non-2xx); absent when the call
+     *  never reached one (network failure, abort, non-provider throw). */
+    timing?: CallTiming;
     /** Response-side payload — response text, thinking. */
     data: AgentCallEndData;
 }) | (AxlEventBase & AskScoped & {
@@ -1548,6 +1578,13 @@ type ChatMessage = {
      *  (the option name and shape are not yet stable); today it is purely
      *  informational. */
     agent?: string;
+    /** Provenance of a message the Axl runtime synthesized rather than the caller
+     *  authored: the rolling conversation summary and the handoff header. Like
+     *  `agent`, never sent on the wire. Adapters use it to avoid treating
+     *  runtime-injected text as the caller's stable prompt -- the Anthropic
+     *  adapter will not place its prompt-cache breakpoint on a system message
+     *  with `origin: 'runtime'`. */
+    origin?: 'runtime';
 };
 type ToolCallMessage = {
     id: string;
@@ -1557,6 +1594,51 @@ type ToolCallMessage = {
         arguments: string;
     };
 };
+/**
+ * Per-call latency breakdown, reported by adapters that route through
+ * `fetchWithRetry`. Every figure is a non-negative integer count of
+ * milliseconds derived from `Date.now()` deltas — the same clock
+ * `agent_call_end.duration` uses.
+ *
+ * Entirely optional and additive: a custom `Provider` that omits `timing` stays
+ * valid, and consumers must treat every field as possibly absent.
+ *
+ * The buckets separate the three things that `duration` conflates — the SDK's
+ * own pacing, the provider's throttling, and the model's actual latency:
+ */
+type CallTiming = {
+    /**
+     * Time parked in Axl's own opt-in `RateLimiter` (concurrency cap plus
+     * `minIntervalMs` spacing) before the request was allowed out. `0` when the
+     * provider has no `rateLimit` configured. This is self-imposed wait, not
+     * provider latency.
+     */
+    queuedMs: number;
+    /** `fetch` attempts made for this call, including the final one (≥ 1). */
+    attempts: number;
+    /**
+     * First attempt's dispatch → final attempt's dispatch, i.e. everything spent
+     * on failed attempts and their backoff sleeps. `0` for a single attempt.
+     */
+    retryMs: number;
+    /** Final dispatch → response headers. Time to first byte. */
+    ttfbMs: number;
+    /**
+     * Final dispatch → first `text_delta`/`thinking_delta`. Streaming only, and
+     * absent on a stream that ends without any content delta. This is the
+     * model-discriminating figure: headers arrive at roughly one round trip
+     * regardless of model, first token does not.
+     */
+    firstTokenMs?: number;
+    /**
+     * Time attributable to the provider. For `chat()`, final dispatch → response
+     * body parsed. For `stream()`, `ttfbMs` plus the cumulative time spent
+     * *awaiting* body reads — time the runtime spends between reads (event
+     * fan-out, tool-call buffering, a slow `ctx.events` consumer) is excluded by
+     * construction, so two models stay comparable under different listener loads.
+     */
+    wireMs: number;
+};
 /** Provider response */
 type ProviderResponse = {
     content: string;
@@ -1574,6 +1656,8 @@ type ProviderResponse = {
     cost?: number;
     /** Provider-specific opaque metadata that needs to round-trip through conversation history. */
     providerMetadata?: Record<string, unknown>;
+    /** Per-call latency breakdown. Absent on providers that don't instrument it. */
+    timing?: CallTiming;
 };
 
 /** Base error class for all Axl errors */
@@ -1694,9 +1778,29 @@ declare class QuorumNotMet extends AxlError {
 declare class NoConsensus extends AxlError {
     constructor(reason: string);
 }
+/**
+ * Where a timed-out ask's elapsed budget went, summed over the turns that
+ * completed before the timeout fired. Present only when at least one of those
+ * turns reported provider `timing` — an all-zero breakdown on an uninstrumented
+ * provider would falsely blame tools and gates.
+ */
+type TimeoutBreakdown = {
+    /** Wall clock consumed by the operation when it timed out. */
+    elapsedMs: number;
+    /** Sum of `CallTiming.queuedMs` — self-imposed rate-limiter wait. */
+    queuedMs: number;
+    /** Sum of `CallTiming.retryMs` — failed provider attempts and their backoff. */
+    retryMs: number;
+    /** Sum of `CallTiming.wireMs` — provider time. */
+    wireMs: number;
+    /** `elapsedMs` minus the three sums: tools, gates, and runtime work. */
+    otherMs: number;
+};
 /** Thrown when an operation exceeds its timeout */
 declare class TimeoutError extends AxlError {
-    constructor(operation: string, timeoutMs: number);
+    /** Latency attribution for the timed-out operation, when measurable. */
+    readonly breakdown?: TimeoutBreakdown;
+    constructor(operation: string, timeoutMs: number, breakdown?: TimeoutBreakdown);
 }
 /** Thrown when a budget limit is exceeded */
 declare class BudgetExceededError extends AxlError {
@@ -1753,6 +1857,9 @@ type AgentConfig = {
     includeThoughts?: boolean;
     toolChoice?: ToolChoice;
     stop?: string[];
+    /** Opt in to prompt caching of this agent's stable prefix (system prompt +
+     *  tools). Only Anthropic needs it; off by default. See `docs/providers.md`. */
+    promptCache?: boolean;
     /** Provider-specific options merged into API requests. Not portable across providers. */
     providerOptions?: Record<string, unknown>;
     /** Default rendering of a `ctx.ask` output schema into this agent's prompt.
@@ -2183,11 +2290,14 @@ declare class AxlEventBus implements AsyncIterable<AxlEvent> {
  * shared API key can storm a provider's rate limit; a governor smooths that.
  *
  * ## Scope & caveats (v1)
- * - **Caps request concurrency, not token throughput (TPM).** Streaming `chat()`
- *   releases the permit at *headers* (the adapter gets the `Response` from
- *   `fetchWithRetry`, then iterates the body separately), so a slow stream does
- *   NOT hold a permit for its whole lifetime. Non-streaming `chat()` holds the
- *   permit through `res.json()`. Neither bounds tokens/min.
+ * - **Caps request concurrency, not token throughput (TPM).** The permit is
+ *   released at response *headers* on BOTH transports: `fetchWithRetry`
+ *   releases in its `finally` as it returns the `Response`, and every adapter
+ *   reads the body only afterwards — so `res.json()` and stream iteration alike
+ *   run outside the permit. A slow stream therefore does not hold a permit for
+ *   its whole lifetime. Non-streaming calls still hold it across generation in
+ *   practice, because a provider sends no headers until the completion is
+ *   finished. Neither bounds tokens/min.
  * - **Per provider instance.** Providers are singletons per (runtime, provider
  *   type), so one governor governs all calls through that adapter — but NOT
  *   embedder calls (the embedder is constructed outside the registry) and NOT
@@ -2517,7 +2627,21 @@ declare class OpenAICompatibleProvider implements Provider {
     }): number | undefined;
     protected parseResponse(json: OpenAIChatResponse, model: string, request?: Record<string, unknown>): ProviderResponse;
     private roundTripMetadata;
-    protected parseSSEStream(body: ReadableStream<Uint8Array>, model: string, request?: Record<string, unknown>): AsyncGenerator<StreamChunk>;
+    /**
+     * PRIVATE, and deliberately not an extension point. It was `protected`, but
+     * nothing in or out of this repo overrides it, and `protected` could not
+     * carry the guarantee it appeared to: TypeScript checks an override for
+     * assignability, and a function type with fewer parameters is assignable to
+     * one with more — so an override that simply dropped the recorder still
+     * compiled and then reported `wireMs === ttfbMs` for the whole subclass. Its
+     * type is not exported from the barrel either, so a subclass author could not
+     * name what they were required to accept.
+     *
+     * A provider with a different wire format implements `Provider` (see
+     * docs/providers.md); an OpenAI-compatible one adds a `ProviderProfile`.
+     * Neither needs to reach in here.
+     */
+    private parseSSEStream;
 }
 type OpenAIUsage = {
     prompt_tokens: number;
@@ -3522,6 +3646,13 @@ declare class WorkflowContext<TInput = unknown> {
     private readonly workflowLifecycleState;
     private signal?;
     private summaryCache?;
+    /** Consecutive provider calls with promptCache on that wrote to the cache
+     *  without reading from it (prefix changes per call), and consecutive calls
+     *  with no cache activity at all (prefix below the model's minimum, which
+     *  Anthropic silently ignores). Either reports once per context. */
+    private promptCacheColdWrites;
+    private promptCacheInactive;
+    private promptCacheWarned;
     private workflowName?;
     private mcpManager?;
     private spanManager?;
@@ -4646,12 +4777,62 @@ declare class AxlRuntime extends EventEmitter {
      */
     trackExecution<T>(fn: () => Promise<T>, options?: {
         captureTraces?: boolean;
+        captureTimingSamples?: boolean;
     }): Promise<{
         result: T;
         cost: number;
         /** True when any tracked call was unpriced — `cost` is then a LOWER BOUND.
          *  Aggregate counterpart of `ExecutionInfo.unpriced`, via `isUnpricedLeaf`. */
         unpriced: boolean;
+        /**
+         * Per-model sums of `agent_call_end.timing`, keyed by the same effective
+         * model URI as `metadata.modelCallCounts`. Present only when at least one
+         * tracked call reported timing, so absence means "nothing was instrumented"
+         * rather than "everything took zero ms".
+         *
+         * `calls` counts the SUCCESSFUL timed calls only — it can be lower than the
+         * same model's `modelCallCounts` entry when a provider omits `timing` or a
+         * call failed. Divide a sum by `calls`, never by `modelCallCounts`.
+         *
+         * Failed calls are excluded even though they now report timing: a non-2xx
+         * response is a measured round trip, but a rollup blending answers with
+         * failures describes neither, and a fast 429 would improve a model's
+         * apparent latency. The failures stay on the events themselves.
+         *
+         * `firstTokenMs` is streaming-only and is summed across the calls that
+         * reported it; it is omitted entirely when no call did, so a non-streaming
+         * model never reports a misleading `0`. Its denominator is `firstTokenCalls`,
+         * NOT `calls` — the two travel together and are present or absent together,
+         * so a mixed streaming/non-streaming model still yields an exact mean.
+         *
+         * Sums are per-call totals, so `wireMs` across concurrent calls can exceed
+         * the wall clock of `fn` — that is expected under fan-out and is why
+         * nothing in the core sums timing at the ask level.
+         *
+         * `samples` carries the raw per-call `CallTiming` blocks behind the sums, in
+         * `agent_call_end` order, so a caller that needs a DISTRIBUTION (percentiles,
+         * min/max) rather than a mean can compute one over real per-call values. It
+         * is the same data the sums were built from — `samples.length === calls` —
+         * and is deliberately not something callers should persist per item: the
+         * sums are the compact form, `samples` is the working form.
+         *
+         * It is **opt-in** via `captureTimingSamples` and the key is absent
+         * otherwise. Retaining it is O(calls) in memory for the lifetime of `fn`,
+         * which no caller should pay for a figure it never reads — the sums alone
+         * are O(models).
+         */
+        modelTiming?: Record<string, {
+            calls: number;
+            queuedMs: number;
+            retryMs: number;
+            wireMs: number;
+            firstTokenMs?: number;
+            /** Timed calls that reported a `firstTokenMs` — the denominator for it. */
+            firstTokenCalls?: number;
+            /** The per-call blocks the sums were built from, in event order.
+             *  `length === calls`. Present only under `captureTimingSamples`. */
+            samples?: CallTiming[];
+        }>;
         traces?: AxlEvent[];
         metadata: {
             models: string[];
@@ -5354,6 +5535,16 @@ declare class ProviderError extends AxlError {
      * and is redaction-eligible). See `docs/security.md`.
      */
     readonly body?: string;
+    /**
+     * Per-call latency breakdown for the failed call, when the transport reached
+     * the provider and a `Response` came back (any non-2xx, streamed or not).
+     * Absent — the KEY itself, not `undefined` — when there is nothing to
+     * report: a network-level failure (`status: 0`) never got a response, and a
+     * custom transport may not instrument timing at all. `declare` keeps the
+     * property from being defined as `undefined` under `useDefineForClassFields`,
+     * so `'timing' in err` distinguishes "not measured" from "measured as zero".
+     */
+    readonly timing?: CallTiming;
     constructor(args: {
         provider: string;
         status: number;
@@ -5362,6 +5553,7 @@ declare class ProviderError extends AxlError {
         retryAfterMs?: number;
         requestId?: string;
         body?: string;
+        timing?: CallTiming;
     });
 }
 /**
@@ -5506,6 +5698,8 @@ declare class AnthropicProvider implements Provider {
     validateInput(request: ProviderInputValidationRequest): ProviderInputValidationResult;
     /** Anthropic ignores native `json_schema` structurally — Axl uses a system
      *  prompt JSON instruction + client-side Zod validation (see buildRequest). */
+    /** The only built-in adapter that honors `promptCache` (see buildBody). */
+    realizesPromptCache(): boolean;
     nativeStructuredOutputSupport(): 'unsupported';
     private baseUrl;
     private apiKeySource;
@@ -6270,4 +6464,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 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 };
+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 CallTiming, 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, type TimeoutBreakdown, 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 };