@axlsdk/axl 0.27.1 → 0.27.2

package/dist/index.d.cts

@@ -3867,6 +3867,12 @@ type ExecutionState = {
     status: 'waiting' | 'running';
     metadata?: Record<string, unknown>;
 };
+/**
+ * Computes a session's new history from what's stored, for
+ * {@link StateStore.updateSession}. Receives `null` when no session is stored.
+ * Returns `null` to write nothing. May run more than once.
+ */
+type SessionUpdate = (current: ChatMessage[] | null) => ChatMessage[] | null;
 /**
  * Pluggable state persistence interface.
  *
@@ -3877,6 +3883,18 @@ interface StateStore {
     saveCheckpoint(executionId: string, name: string, data: unknown): Promise<void>;
     getCheckpoint(executionId: string, name: string): Promise<unknown | null>;
     saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    /**
+     * Replace a session's history based on what's stored at that moment, without
+     * overwriting a write made by another process in between. Sessions use it to
+     * save each turn. The built-in stores implement it; without it, a store gets
+     * `saveSession`, where the last writer wins.
+     *
+     * **Custom store implementors:** the read and the write must be atomic. Use a
+     * transaction or a compare-and-set, and call `update` again if another writer
+     * got in first, so `update` may run more than once. It receives `null` when no
+     * session is stored. When it returns `null`, write nothing.
+     */
+    updateSession?(sessionId: string, update: SessionUpdate): Promise<void>;
     getSession(sessionId: string): Promise<ChatMessage[]>;
     deleteSession(sessionId: string): Promise<void>;
     saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
@@ -5630,22 +5648,6 @@ type SessionOptions = {
     /** Whether to persist session history to the state store. Default: true. */
     persist?: boolean;
 };
-/**
- * A stateful conversation session.
- * Persists message history across multiple interactions.
- *
- * **Concurrency contract:** `send`, `stream`, `end`, and `fork` are
- * serialized per session id within one runtime instance. Two
- * `runtime.session('x')` handles share the same lock (it lives on
- * `AxlRuntime`, not the `Session` instance). `history()` and
- * `handoffs()` bypass the lock and return the last persisted snapshot.
- *
- * **⚠️ Cross-process locking is NOT provided.** Multiple Node workers
- * behind a load balancer hitting the same Redis-backed `sessionId`
- * will still race. Pin sessions to workers (sticky routing) or use
- * distinct ids per request. See `docs/api-reference.md` →
- * Sessions → Concurrency.
- */
 declare class Session {
     private sessionId;
     private runtime;
@@ -5672,6 +5674,8 @@ declare class Session {
      *  push has no agent context and so leaves `agent` undefined — see the
      *  `ChatMessage.agent` field doc. */
     private commitHistory;
+    /** The turn is already saved, so a listener that throws can't be allowed to fail it. */
+    private notify;
     stream(workflowName: string, input: unknown, options?: {
         signal?: AbortSignal;
         events?: EventStreamOptions;
@@ -9778,6 +9782,7 @@ declare class MemoryStore implements StateStore {
     saveCheckpoint(executionId: string, name: string, data: unknown): Promise<void>;
     getCheckpoint(executionId: string, name: string): Promise<unknown | null>;
     saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    updateSession(sessionId: string, update: SessionUpdate): Promise<void>;
     getSession(sessionId: string): Promise<ChatMessage[]>;
     deleteSession(sessionId: string): Promise<void>;
     saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
@@ -9946,6 +9951,7 @@ declare class SQLiteStore implements StateStore {
     saveCheckpoint(executionId: string, name: string, data: unknown): Promise<void>;
     getCheckpoint(executionId: string, name: string): Promise<unknown | null>;
     saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    updateSession(sessionId: string, update: SessionUpdate): Promise<void>;
     getSession(sessionId: string): Promise<ChatMessage[]>;
     deleteSession(sessionId: string): Promise<void>;
     saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
@@ -10064,6 +10070,34 @@ interface RedisStoreOptions {
      * `console.error` and otherwise ignored.
      */
     onConnectionEvent?: (event: RedisConnectionEvent) => void;
+    /**
+     * Reconnect when Redis stops answering, in milliseconds. Off by default.
+     *
+     * The store sends a `PING` about every third of this time. If one goes
+     * unanswered for this long, it drops the connection and reconnects: calls in
+     * flight reject, and calls made until it reconnects reject with
+     * `REDIS_UNAVAILABLE`. `create()` also rejects if Redis hasn't finished
+     * connecting within this time.
+     *
+     * It's a limit on the whole connection, not on one command, because replies
+     * come back in order. Set it above your slowest expected command, or a large
+     * save or busy server looks like a stall. A call that rejects this way may
+     * still have been applied by Redis.
+     */
+    responseTimeoutMs?: number;
+    /**
+     * Set to `false` so that `create()` returns right away and the store connects
+     * in the background, retrying until Redis is available. Calls reject with
+     * `REDIS_UNAVAILABLE` until then. Defaults to `true`, where `create()` rejects
+     * if Redis is unavailable, which surfaces bad configuration at startup.
+     *
+     * Requires {@link responseTimeoutMs}, so that a server that accepts the
+     * connection but never answers can't leave it connecting forever. Nothing
+     * rejects if the configuration is wrong: failed attempts go to
+     * {@link onConnectionEvent}, and `isConnected` stays `false`. The startup
+     * backfill runs after the first connection instead of during `create()`.
+     */
+    waitForConnection?: boolean;
     /**
      * Skip the lazy backfill of legacy execution / eval-history entries into
      * the sorted-set indexes during `RedisStore.create()`. Default `false`
@@ -10170,6 +10204,12 @@ declare class RedisStore implements StateStore {
     private connection;
     private keyPrefix;
     private ttls;
+    /** Set when `close()` starts, while the connection is still open. */
+    private closing;
+    /** Where the next save's check of listed sessions picks up. */
+    private sessionSweepCursor;
+    /** Overlapping saves would all check the same page, so only one checks at a time. */
+    private sessionSweepRunning;
     private constructor();
     /**
      * Whether the store can send commands right now, for a health check or for
@@ -10196,6 +10236,8 @@ declare class RedisStore implements StateStore {
      * instance needs no constructor state.
      */
     private prunesInFlight?;
+    /** Stops the `responseTimeoutMs` health checks; unset when the option is off. */
+    private stopResponseWatch?;
     /**
      * Supports `listExecutions(limit, { cursor })`. A getter rather than a
      * field so it lives on the prototype.
@@ -10231,6 +10273,12 @@ declare class RedisStore implements StateStore {
      * ```
      */
     static create(options?: string | RedisStoreOptions): Promise<RedisStore>;
+    /**
+     * Run the startup backfill when a connection becomes ready, until it succeeds.
+     * Nothing is waiting on it, and listings work without it, so a failure is
+     * reported and the next connection tries again.
+     */
+    private backfillOnceConnected;
     /**
      * Backfill the execution-history sorted-set from the legacy ID set.
      * Idempotent — runs only if the ZSET is missing entries the SET has.
@@ -10244,6 +10292,10 @@ declare class RedisStore implements StateStore {
      * Shared implementation for both backfill paths. Reads SET members,
      * batch-MGETs their data blobs in chunks, and ZADDs each into the new
      * sorted-set inside a single MULTI per chunk.
+     *
+     * Ids with no data blob are removed from the id set. Left there, the set stays
+     * larger than the sorted set, so every startup repeats this walk and listing
+     * stays on its slow path.
      */
     private backfillHistoryIndex;
     private checkpointKey;
@@ -10274,6 +10326,7 @@ declare class RedisStore implements StateStore {
     saveCheckpoint(executionId: string, name: string, data: unknown): Promise<void>;
     getCheckpoint(executionId: string, name: string): Promise<unknown | null>;
     saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    updateSession(sessionId: string, update: SessionUpdate): Promise<void>;
     getSession(sessionId: string): Promise<ChatMessage[]>;
     deleteSession(sessionId: string): Promise<void>;
     saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
@@ -10386,6 +10439,7 @@ declare class RedisStore implements StateStore {
      * covers a Redis user whose ACL denies `EVAL`.
      */
     private pruneHistoryAfterSave;
+    private warnPruneFailed;
     private pruneHistory;
     /**
      * Run {@link PRUNE_HISTORY_INDEX_SCRIPT} over `ids`, at most PRUNE_BATCH
@@ -10429,6 +10483,16 @@ declare class RedisStore implements StateStore {
      */
     private readRetentionBatch;
     listSessions(): Promise<string[]>;
+    /**
+     * Check a few listed sessions after a save, so ids of expired sessions go
+     * away for apps that never list. Sessions without a TTL don't expire, so
+     * there's nothing to do. The save has already succeeded, so failing here
+     * can't fail it.
+     */
+    private sweepSessionIds;
+    /** Returns the ids removed. Without permission to run the script, removes none and warns. */
+    private pruneSessionIds;
+    private warnSessionPruneFailed;
     appendStreamingEvents(executionId: string, events: AxlEvent[]): Promise<void>;
     finalizeStreamingEvents(executionId: string): Promise<void>;
     listStreamingExecutions(): Promise<string[]>;
@@ -10442,10 +10506,13 @@ declare class RedisStore implements StateStore {
      * better-sqlite3's `close()` are both no-ops the second time; node-redis
      * instead rejects with "The client is closed", so absorb that here.
      *
-     * Bounded, so a shutdown can't hang on Redis. `QUIT` lets queued commands
-     * finish on a healthy connection, but node-redis never settles it if the
-     * socket closes first, and a stalled server may never answer it. While
-     * disconnected it couldn't be sent at all.
+     * Bounded, so a shutdown can't hang on Redis. Replies arrive in order, so a
+     * reply to this PING means every earlier command has finished.
+     *
+     * Not `quit()`: it marks the client closed before the server answers, and
+     * `destroy()` then throws without touching the socket, so a stalled server's
+     * socket could never be closed. There's no other public way to close it. A
+     * closed socket is all Redis needs to clean up, so nothing is lost.
      */
     close(): Promise<void>;
     deleteCheckpoints(executionId: string): Promise<void>;
@@ -10518,4 +10585,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 Accounting, type AccountingCompleteness, type AccountingReason, type AccountingUsage, AdmissionController, AdmissionDeniedError, type Agent, type AgentCallEndData, type AgentCallInfo, type AgentCallParams, type AgentCallStartData, type AgentConfig, AnthropicProvider, type AnyWorkflow, type ApiKeySource, type ArtifactManifest, type ArtifactOwner, type ArtifactStatus, type ArtifactWriteResult, 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 CaptureCorrelation, type CapturedCorrection, type CapturedError, type CapturedExternalRequestRecord, type CapturedJsonValue, type CapturedMessage, type CapturedModelRequestRecord, type CapturedOperationRef, type CapturedPhase, type CapturedRequest, type CapturedRequestRecord, type CapturedResponse, type ChatMessage, type ChatOptions, type CheckpointEventData, type CoalescedPartialObject, type CostProvenance, type CreateContextOptions, DEEPSEEK_PROFILE, DEFAULT_MAX_QUEUE_BYTES, DEFAULT_MAX_RECORD_BYTES, DEFAULT_MAX_RUN_BYTES, type DecisionCleanupFailedEvent, type DelegateData, type DelegateOptions, type DiagnosticArtifactStore, type DiagnosticArtifactsConfig, type DiagnosticsConfig, type DispatchAdmission, type Effort, type EffortResolution, type EmbedResult, type EmbedUsage, type Embedder, type EvalExecuteWorkflow, type EvalHistoryEntry, type EvalProgressEventShape, type EventStreamOptions, EventStreamOverflowError, type ExecuteOptions, type ExecutionCursor, type ExecutionInfo, type ExecutionInfoV1, type ExecutionInfoV2, type ExecutionState, type ExternalOperationDescriptor, type ExternalOperationRecord, type ExternalOperationReport, FileDiagnosticArtifactStore, type FinishReason, type FoldedOperationRecord, 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 HistoryRetentionCursor, type HistoryRetentionKind, type HistoryRetentionOptions, type HistoryRetentionResult, type HistoryTtls, type HumanDecision, InMemoryVectorStore, type InputAudioPart, 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 MemoryStoreOptions, type ModelCallRecord, type ModelInput, type ModelInputDescriptor, type ModelTimingRollup, NoConsensus, NoopSpanManager, OLLAMA_PROFILE, OPENAI_PRICING, OPENAI_PROFILE, OPENROUTER_PROFILE, type ObservationStatus, type OpenAICompatibleOptions, OpenAICompatibleProvider, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, OpenAITranscriptionProvider, OpenRouterTranscriptionProvider, type OpenedArtifact, type OperationKind, type OperationPurpose, type OutputGuardrail, type OutputValidator, type PendingDecision, type PerModel, type PricingSource, type PricingTable, type ProfileInputModalities, 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 ReasoningContextReset, type ReasoningEmit, type ReasoningProfile, type ReasoningRoundTrip, type RecallOptions, type RecallResult, type RecordedAudioSource, type RedisConnectionEvent, RedisStore, type RedisStoreOptions, type RememberOptions, type RememberResult, RequestCaptureChannel, type RequestCaptureOptions, type RequestCaptureSink, type RequestCaptureStatus, type ResolvedThinkingOptions, type Result, type RetryFeedbackHook, type RetryFeedbackInfo, type RetryFeedbackResult, type RetryPolicy, type RuntimeEvalConfigShape, SGLANG_PROFILE, SQLiteStore, type SQLiteStoreOptions, type SchemaCheckData, type SchemaDiagnosticData, type SchemaPromptOption, Session, type SessionOptions, type SpanAttributeValue, type SpanAttributes, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StagedArtifact, StallTimeoutError, 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 TrackExecutionMetadata, type TrackExecutionResult, type TrackOutcomeOptions, type TrackedOutcome, type Transcript, type TranscriptionCapabilities, TranscriptionOperationError, type TranscriptionProvider, TranscriptionProviderRegistry, type TranscriptionProviderRequest, type TranscriptionProviderResult, type TranscriptionRequest, UnsupportedEventSchemaVersionError, UnsupportedModelInputError, UnsupportedModelOptionError, 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, capturedJournalLineSchema, createSpanManager, defineConfig, estimateOpenAICost, eventCostContribution, expandGlob, externalOperation, externalOperationRecordSchema, extractJson, extractThinkTags, findConfig, foldJournal, foldedOperationRecordSchema, getEventSchemaVersion, getExecutionEventSchemaVersion, hasPositiveBillableWork, hasPositiveTokens, importModule, inputText, isAdmissionDeniedError, isCostBearingLeaf, isRetryableStatus, isRootLevel, isUnpricedLeaf, isUsableCost, modelCallRecordSchema, needsTsxLoader, normalizeStoredExecution, openaiReasoningEmit, parsePartialJson, pickDefault, pickExport, priceFromTable, reasoningEffortEmit, reasoningObjectEmit, redactCapturedRequest, redactEvent, redactHistoricalEvent, redactModelCallRecord, registerConditions, resolveApiKey, resolvePerModel, resolveRuntime, resolveThinkingOptions, stringStreamFromEvents, summarizeModelInput, tool, workflow, zodToJsonSchema };
+export { AXL_EVENT_TYPES, AXL_EVENT_TYPES_V2, AXL_TOOL_LIFECYCLE_TYPES_V2, AZURE_PROFILE, type Accounting, type AccountingCompleteness, type AccountingReason, type AccountingUsage, AdmissionController, AdmissionDeniedError, type Agent, type AgentCallEndData, type AgentCallInfo, type AgentCallParams, type AgentCallStartData, type AgentConfig, AnthropicProvider, type AnyWorkflow, type ApiKeySource, type ArtifactManifest, type ArtifactOwner, type ArtifactStatus, type ArtifactWriteResult, 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 CaptureCorrelation, type CapturedCorrection, type CapturedError, type CapturedExternalRequestRecord, type CapturedJsonValue, type CapturedMessage, type CapturedModelRequestRecord, type CapturedOperationRef, type CapturedPhase, type CapturedRequest, type CapturedRequestRecord, type CapturedResponse, type ChatMessage, type ChatOptions, type CheckpointEventData, type CoalescedPartialObject, type CostProvenance, type CreateContextOptions, DEEPSEEK_PROFILE, DEFAULT_MAX_QUEUE_BYTES, DEFAULT_MAX_RECORD_BYTES, DEFAULT_MAX_RUN_BYTES, type DecisionCleanupFailedEvent, type DelegateData, type DelegateOptions, type DiagnosticArtifactStore, type DiagnosticArtifactsConfig, type DiagnosticsConfig, type DispatchAdmission, type Effort, type EffortResolution, type EmbedResult, type EmbedUsage, type Embedder, type EvalExecuteWorkflow, type EvalHistoryEntry, type EvalProgressEventShape, type EventStreamOptions, EventStreamOverflowError, type ExecuteOptions, type ExecutionCursor, type ExecutionInfo, type ExecutionInfoV1, type ExecutionInfoV2, type ExecutionState, type ExternalOperationDescriptor, type ExternalOperationRecord, type ExternalOperationReport, FileDiagnosticArtifactStore, type FinishReason, type FoldedOperationRecord, 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 HistoryRetentionCursor, type HistoryRetentionKind, type HistoryRetentionOptions, type HistoryRetentionResult, type HistoryTtls, type HumanDecision, InMemoryVectorStore, type InputAudioPart, 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 MemoryStoreOptions, type ModelCallRecord, type ModelInput, type ModelInputDescriptor, type ModelTimingRollup, NoConsensus, NoopSpanManager, OLLAMA_PROFILE, OPENAI_PRICING, OPENAI_PROFILE, OPENROUTER_PROFILE, type ObservationStatus, type OpenAICompatibleOptions, OpenAICompatibleProvider, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, OpenAITranscriptionProvider, OpenRouterTranscriptionProvider, type OpenedArtifact, type OperationKind, type OperationPurpose, type OutputGuardrail, type OutputValidator, type PendingDecision, type PerModel, type PricingSource, type PricingTable, type ProfileInputModalities, 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 ReasoningContextReset, type ReasoningEmit, type ReasoningProfile, type ReasoningRoundTrip, type RecallOptions, type RecallResult, type RecordedAudioSource, type RedisConnectionEvent, RedisStore, type RedisStoreOptions, type RememberOptions, type RememberResult, RequestCaptureChannel, type RequestCaptureOptions, type RequestCaptureSink, type RequestCaptureStatus, type ResolvedThinkingOptions, type Result, type RetryFeedbackHook, type RetryFeedbackInfo, type RetryFeedbackResult, type RetryPolicy, type RuntimeEvalConfigShape, SGLANG_PROFILE, SQLiteStore, type SQLiteStoreOptions, type SchemaCheckData, type SchemaDiagnosticData, type SchemaPromptOption, Session, type SessionOptions, type SessionUpdate, type SpanAttributeValue, type SpanAttributes, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StagedArtifact, StallTimeoutError, 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 TrackExecutionMetadata, type TrackExecutionResult, type TrackOutcomeOptions, type TrackedOutcome, type Transcript, type TranscriptionCapabilities, TranscriptionOperationError, type TranscriptionProvider, TranscriptionProviderRegistry, type TranscriptionProviderRequest, type TranscriptionProviderResult, type TranscriptionRequest, UnsupportedEventSchemaVersionError, UnsupportedModelInputError, UnsupportedModelOptionError, 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, capturedJournalLineSchema, createSpanManager, defineConfig, estimateOpenAICost, eventCostContribution, expandGlob, externalOperation, externalOperationRecordSchema, extractJson, extractThinkTags, findConfig, foldJournal, foldedOperationRecordSchema, getEventSchemaVersion, getExecutionEventSchemaVersion, hasPositiveBillableWork, hasPositiveTokens, importModule, inputText, isAdmissionDeniedError, isCostBearingLeaf, isRetryableStatus, isRootLevel, isUnpricedLeaf, isUsableCost, modelCallRecordSchema, needsTsxLoader, normalizeStoredExecution, openaiReasoningEmit, parsePartialJson, pickDefault, pickExport, priceFromTable, reasoningEffortEmit, reasoningObjectEmit, redactCapturedRequest, redactEvent, redactHistoricalEvent, redactModelCallRecord, registerConditions, resolveApiKey, resolvePerModel, resolveRuntime, resolveThinkingOptions, stringStreamFromEvents, summarizeModelInput, tool, workflow, zodToJsonSchema };

package/dist/index.d.ts

@@ -3867,6 +3867,12 @@ type ExecutionState = {
     status: 'waiting' | 'running';
     metadata?: Record<string, unknown>;
 };
+/**
+ * Computes a session's new history from what's stored, for
+ * {@link StateStore.updateSession}. Receives `null` when no session is stored.
+ * Returns `null` to write nothing. May run more than once.
+ */
+type SessionUpdate = (current: ChatMessage[] | null) => ChatMessage[] | null;
 /**
  * Pluggable state persistence interface.
  *
@@ -3877,6 +3883,18 @@ interface StateStore {
     saveCheckpoint(executionId: string, name: string, data: unknown): Promise<void>;
     getCheckpoint(executionId: string, name: string): Promise<unknown | null>;
     saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    /**
+     * Replace a session's history based on what's stored at that moment, without
+     * overwriting a write made by another process in between. Sessions use it to
+     * save each turn. The built-in stores implement it; without it, a store gets
+     * `saveSession`, where the last writer wins.
+     *
+     * **Custom store implementors:** the read and the write must be atomic. Use a
+     * transaction or a compare-and-set, and call `update` again if another writer
+     * got in first, so `update` may run more than once. It receives `null` when no
+     * session is stored. When it returns `null`, write nothing.
+     */
+    updateSession?(sessionId: string, update: SessionUpdate): Promise<void>;
     getSession(sessionId: string): Promise<ChatMessage[]>;
     deleteSession(sessionId: string): Promise<void>;
     saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
@@ -5630,22 +5648,6 @@ type SessionOptions = {
     /** Whether to persist session history to the state store. Default: true. */
     persist?: boolean;
 };
-/**
- * A stateful conversation session.
- * Persists message history across multiple interactions.
- *
- * **Concurrency contract:** `send`, `stream`, `end`, and `fork` are
- * serialized per session id within one runtime instance. Two
- * `runtime.session('x')` handles share the same lock (it lives on
- * `AxlRuntime`, not the `Session` instance). `history()` and
- * `handoffs()` bypass the lock and return the last persisted snapshot.
- *
- * **⚠️ Cross-process locking is NOT provided.** Multiple Node workers
- * behind a load balancer hitting the same Redis-backed `sessionId`
- * will still race. Pin sessions to workers (sticky routing) or use
- * distinct ids per request. See `docs/api-reference.md` →
- * Sessions → Concurrency.
- */
 declare class Session {
     private sessionId;
     private runtime;
@@ -5672,6 +5674,8 @@ declare class Session {
      *  push has no agent context and so leaves `agent` undefined — see the
      *  `ChatMessage.agent` field doc. */
     private commitHistory;
+    /** The turn is already saved, so a listener that throws can't be allowed to fail it. */
+    private notify;
     stream(workflowName: string, input: unknown, options?: {
         signal?: AbortSignal;
         events?: EventStreamOptions;
@@ -9778,6 +9782,7 @@ declare class MemoryStore implements StateStore {
     saveCheckpoint(executionId: string, name: string, data: unknown): Promise<void>;
     getCheckpoint(executionId: string, name: string): Promise<unknown | null>;
     saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    updateSession(sessionId: string, update: SessionUpdate): Promise<void>;
     getSession(sessionId: string): Promise<ChatMessage[]>;
     deleteSession(sessionId: string): Promise<void>;
     saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
@@ -9946,6 +9951,7 @@ declare class SQLiteStore implements StateStore {
     saveCheckpoint(executionId: string, name: string, data: unknown): Promise<void>;
     getCheckpoint(executionId: string, name: string): Promise<unknown | null>;
     saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    updateSession(sessionId: string, update: SessionUpdate): Promise<void>;
     getSession(sessionId: string): Promise<ChatMessage[]>;
     deleteSession(sessionId: string): Promise<void>;
     saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
@@ -10064,6 +10070,34 @@ interface RedisStoreOptions {
      * `console.error` and otherwise ignored.
      */
     onConnectionEvent?: (event: RedisConnectionEvent) => void;
+    /**
+     * Reconnect when Redis stops answering, in milliseconds. Off by default.
+     *
+     * The store sends a `PING` about every third of this time. If one goes
+     * unanswered for this long, it drops the connection and reconnects: calls in
+     * flight reject, and calls made until it reconnects reject with
+     * `REDIS_UNAVAILABLE`. `create()` also rejects if Redis hasn't finished
+     * connecting within this time.
+     *
+     * It's a limit on the whole connection, not on one command, because replies
+     * come back in order. Set it above your slowest expected command, or a large
+     * save or busy server looks like a stall. A call that rejects this way may
+     * still have been applied by Redis.
+     */
+    responseTimeoutMs?: number;
+    /**
+     * Set to `false` so that `create()` returns right away and the store connects
+     * in the background, retrying until Redis is available. Calls reject with
+     * `REDIS_UNAVAILABLE` until then. Defaults to `true`, where `create()` rejects
+     * if Redis is unavailable, which surfaces bad configuration at startup.
+     *
+     * Requires {@link responseTimeoutMs}, so that a server that accepts the
+     * connection but never answers can't leave it connecting forever. Nothing
+     * rejects if the configuration is wrong: failed attempts go to
+     * {@link onConnectionEvent}, and `isConnected` stays `false`. The startup
+     * backfill runs after the first connection instead of during `create()`.
+     */
+    waitForConnection?: boolean;
     /**
      * Skip the lazy backfill of legacy execution / eval-history entries into
      * the sorted-set indexes during `RedisStore.create()`. Default `false`
@@ -10170,6 +10204,12 @@ declare class RedisStore implements StateStore {
     private connection;
     private keyPrefix;
     private ttls;
+    /** Set when `close()` starts, while the connection is still open. */
+    private closing;
+    /** Where the next save's check of listed sessions picks up. */
+    private sessionSweepCursor;
+    /** Overlapping saves would all check the same page, so only one checks at a time. */
+    private sessionSweepRunning;
     private constructor();
     /**
      * Whether the store can send commands right now, for a health check or for
@@ -10196,6 +10236,8 @@ declare class RedisStore implements StateStore {
      * instance needs no constructor state.
      */
     private prunesInFlight?;
+    /** Stops the `responseTimeoutMs` health checks; unset when the option is off. */
+    private stopResponseWatch?;
     /**
      * Supports `listExecutions(limit, { cursor })`. A getter rather than a
      * field so it lives on the prototype.
@@ -10231,6 +10273,12 @@ declare class RedisStore implements StateStore {
      * ```
      */
     static create(options?: string | RedisStoreOptions): Promise<RedisStore>;
+    /**
+     * Run the startup backfill when a connection becomes ready, until it succeeds.
+     * Nothing is waiting on it, and listings work without it, so a failure is
+     * reported and the next connection tries again.
+     */
+    private backfillOnceConnected;
     /**
      * Backfill the execution-history sorted-set from the legacy ID set.
      * Idempotent — runs only if the ZSET is missing entries the SET has.
@@ -10244,6 +10292,10 @@ declare class RedisStore implements StateStore {
      * Shared implementation for both backfill paths. Reads SET members,
      * batch-MGETs their data blobs in chunks, and ZADDs each into the new
      * sorted-set inside a single MULTI per chunk.
+     *
+     * Ids with no data blob are removed from the id set. Left there, the set stays
+     * larger than the sorted set, so every startup repeats this walk and listing
+     * stays on its slow path.
      */
     private backfillHistoryIndex;
     private checkpointKey;
@@ -10274,6 +10326,7 @@ declare class RedisStore implements StateStore {
     saveCheckpoint(executionId: string, name: string, data: unknown): Promise<void>;
     getCheckpoint(executionId: string, name: string): Promise<unknown | null>;
     saveSession(sessionId: string, history: ChatMessage[]): Promise<void>;
+    updateSession(sessionId: string, update: SessionUpdate): Promise<void>;
     getSession(sessionId: string): Promise<ChatMessage[]>;
     deleteSession(sessionId: string): Promise<void>;
     saveSessionMeta(sessionId: string, key: string, value: unknown): Promise<void>;
@@ -10386,6 +10439,7 @@ declare class RedisStore implements StateStore {
      * covers a Redis user whose ACL denies `EVAL`.
      */
     private pruneHistoryAfterSave;
+    private warnPruneFailed;
     private pruneHistory;
     /**
      * Run {@link PRUNE_HISTORY_INDEX_SCRIPT} over `ids`, at most PRUNE_BATCH
@@ -10429,6 +10483,16 @@ declare class RedisStore implements StateStore {
      */
     private readRetentionBatch;
     listSessions(): Promise<string[]>;
+    /**
+     * Check a few listed sessions after a save, so ids of expired sessions go
+     * away for apps that never list. Sessions without a TTL don't expire, so
+     * there's nothing to do. The save has already succeeded, so failing here
+     * can't fail it.
+     */
+    private sweepSessionIds;
+    /** Returns the ids removed. Without permission to run the script, removes none and warns. */
+    private pruneSessionIds;
+    private warnSessionPruneFailed;
     appendStreamingEvents(executionId: string, events: AxlEvent[]): Promise<void>;
     finalizeStreamingEvents(executionId: string): Promise<void>;
     listStreamingExecutions(): Promise<string[]>;
@@ -10442,10 +10506,13 @@ declare class RedisStore implements StateStore {
      * better-sqlite3's `close()` are both no-ops the second time; node-redis
      * instead rejects with "The client is closed", so absorb that here.
      *
-     * Bounded, so a shutdown can't hang on Redis. `QUIT` lets queued commands
-     * finish on a healthy connection, but node-redis never settles it if the
-     * socket closes first, and a stalled server may never answer it. While
-     * disconnected it couldn't be sent at all.
+     * Bounded, so a shutdown can't hang on Redis. Replies arrive in order, so a
+     * reply to this PING means every earlier command has finished.
+     *
+     * Not `quit()`: it marks the client closed before the server answers, and
+     * `destroy()` then throws without touching the socket, so a stalled server's
+     * socket could never be closed. There's no other public way to close it. A
+     * closed socket is all Redis needs to clean up, so nothing is lost.
      */
     close(): Promise<void>;
     deleteCheckpoints(executionId: string): Promise<void>;
@@ -10518,4 +10585,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 Accounting, type AccountingCompleteness, type AccountingReason, type AccountingUsage, AdmissionController, AdmissionDeniedError, type Agent, type AgentCallEndData, type AgentCallInfo, type AgentCallParams, type AgentCallStartData, type AgentConfig, AnthropicProvider, type AnyWorkflow, type ApiKeySource, type ArtifactManifest, type ArtifactOwner, type ArtifactStatus, type ArtifactWriteResult, 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 CaptureCorrelation, type CapturedCorrection, type CapturedError, type CapturedExternalRequestRecord, type CapturedJsonValue, type CapturedMessage, type CapturedModelRequestRecord, type CapturedOperationRef, type CapturedPhase, type CapturedRequest, type CapturedRequestRecord, type CapturedResponse, type ChatMessage, type ChatOptions, type CheckpointEventData, type CoalescedPartialObject, type CostProvenance, type CreateContextOptions, DEEPSEEK_PROFILE, DEFAULT_MAX_QUEUE_BYTES, DEFAULT_MAX_RECORD_BYTES, DEFAULT_MAX_RUN_BYTES, type DecisionCleanupFailedEvent, type DelegateData, type DelegateOptions, type DiagnosticArtifactStore, type DiagnosticArtifactsConfig, type DiagnosticsConfig, type DispatchAdmission, type Effort, type EffortResolution, type EmbedResult, type EmbedUsage, type Embedder, type EvalExecuteWorkflow, type EvalHistoryEntry, type EvalProgressEventShape, type EventStreamOptions, EventStreamOverflowError, type ExecuteOptions, type ExecutionCursor, type ExecutionInfo, type ExecutionInfoV1, type ExecutionInfoV2, type ExecutionState, type ExternalOperationDescriptor, type ExternalOperationRecord, type ExternalOperationReport, FileDiagnosticArtifactStore, type FinishReason, type FoldedOperationRecord, 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 HistoryRetentionCursor, type HistoryRetentionKind, type HistoryRetentionOptions, type HistoryRetentionResult, type HistoryTtls, type HumanDecision, InMemoryVectorStore, type InputAudioPart, 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 MemoryStoreOptions, type ModelCallRecord, type ModelInput, type ModelInputDescriptor, type ModelTimingRollup, NoConsensus, NoopSpanManager, OLLAMA_PROFILE, OPENAI_PRICING, OPENAI_PROFILE, OPENROUTER_PROFILE, type ObservationStatus, type OpenAICompatibleOptions, OpenAICompatibleProvider, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, OpenAITranscriptionProvider, OpenRouterTranscriptionProvider, type OpenedArtifact, type OperationKind, type OperationPurpose, type OutputGuardrail, type OutputValidator, type PendingDecision, type PerModel, type PricingSource, type PricingTable, type ProfileInputModalities, 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 ReasoningContextReset, type ReasoningEmit, type ReasoningProfile, type ReasoningRoundTrip, type RecallOptions, type RecallResult, type RecordedAudioSource, type RedisConnectionEvent, RedisStore, type RedisStoreOptions, type RememberOptions, type RememberResult, RequestCaptureChannel, type RequestCaptureOptions, type RequestCaptureSink, type RequestCaptureStatus, type ResolvedThinkingOptions, type Result, type RetryFeedbackHook, type RetryFeedbackInfo, type RetryFeedbackResult, type RetryPolicy, type RuntimeEvalConfigShape, SGLANG_PROFILE, SQLiteStore, type SQLiteStoreOptions, type SchemaCheckData, type SchemaDiagnosticData, type SchemaPromptOption, Session, type SessionOptions, type SpanAttributeValue, type SpanAttributes, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StagedArtifact, StallTimeoutError, 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 TrackExecutionMetadata, type TrackExecutionResult, type TrackOutcomeOptions, type TrackedOutcome, type Transcript, type TranscriptionCapabilities, TranscriptionOperationError, type TranscriptionProvider, TranscriptionProviderRegistry, type TranscriptionProviderRequest, type TranscriptionProviderResult, type TranscriptionRequest, UnsupportedEventSchemaVersionError, UnsupportedModelInputError, UnsupportedModelOptionError, 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, capturedJournalLineSchema, createSpanManager, defineConfig, estimateOpenAICost, eventCostContribution, expandGlob, externalOperation, externalOperationRecordSchema, extractJson, extractThinkTags, findConfig, foldJournal, foldedOperationRecordSchema, getEventSchemaVersion, getExecutionEventSchemaVersion, hasPositiveBillableWork, hasPositiveTokens, importModule, inputText, isAdmissionDeniedError, isCostBearingLeaf, isRetryableStatus, isRootLevel, isUnpricedLeaf, isUsableCost, modelCallRecordSchema, needsTsxLoader, normalizeStoredExecution, openaiReasoningEmit, parsePartialJson, pickDefault, pickExport, priceFromTable, reasoningEffortEmit, reasoningObjectEmit, redactCapturedRequest, redactEvent, redactHistoricalEvent, redactModelCallRecord, registerConditions, resolveApiKey, resolvePerModel, resolveRuntime, resolveThinkingOptions, stringStreamFromEvents, summarizeModelInput, tool, workflow, zodToJsonSchema };
+export { AXL_EVENT_TYPES, AXL_EVENT_TYPES_V2, AXL_TOOL_LIFECYCLE_TYPES_V2, AZURE_PROFILE, type Accounting, type AccountingCompleteness, type AccountingReason, type AccountingUsage, AdmissionController, AdmissionDeniedError, type Agent, type AgentCallEndData, type AgentCallInfo, type AgentCallParams, type AgentCallStartData, type AgentConfig, AnthropicProvider, type AnyWorkflow, type ApiKeySource, type ArtifactManifest, type ArtifactOwner, type ArtifactStatus, type ArtifactWriteResult, 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 CaptureCorrelation, type CapturedCorrection, type CapturedError, type CapturedExternalRequestRecord, type CapturedJsonValue, type CapturedMessage, type CapturedModelRequestRecord, type CapturedOperationRef, type CapturedPhase, type CapturedRequest, type CapturedRequestRecord, type CapturedResponse, type ChatMessage, type ChatOptions, type CheckpointEventData, type CoalescedPartialObject, type CostProvenance, type CreateContextOptions, DEEPSEEK_PROFILE, DEFAULT_MAX_QUEUE_BYTES, DEFAULT_MAX_RECORD_BYTES, DEFAULT_MAX_RUN_BYTES, type DecisionCleanupFailedEvent, type DelegateData, type DelegateOptions, type DiagnosticArtifactStore, type DiagnosticArtifactsConfig, type DiagnosticsConfig, type DispatchAdmission, type Effort, type EffortResolution, type EmbedResult, type EmbedUsage, type Embedder, type EvalExecuteWorkflow, type EvalHistoryEntry, type EvalProgressEventShape, type EventStreamOptions, EventStreamOverflowError, type ExecuteOptions, type ExecutionCursor, type ExecutionInfo, type ExecutionInfoV1, type ExecutionInfoV2, type ExecutionState, type ExternalOperationDescriptor, type ExternalOperationRecord, type ExternalOperationReport, FileDiagnosticArtifactStore, type FinishReason, type FoldedOperationRecord, 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 HistoryRetentionCursor, type HistoryRetentionKind, type HistoryRetentionOptions, type HistoryRetentionResult, type HistoryTtls, type HumanDecision, InMemoryVectorStore, type InputAudioPart, 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 MemoryStoreOptions, type ModelCallRecord, type ModelInput, type ModelInputDescriptor, type ModelTimingRollup, NoConsensus, NoopSpanManager, OLLAMA_PROFILE, OPENAI_PRICING, OPENAI_PROFILE, OPENROUTER_PROFILE, type ObservationStatus, type OpenAICompatibleOptions, OpenAICompatibleProvider, OpenAIEmbedder, OpenAIProvider, OpenAIResponsesProvider, OpenAITranscriptionProvider, OpenRouterTranscriptionProvider, type OpenedArtifact, type OperationKind, type OperationPurpose, type OutputGuardrail, type OutputValidator, type PendingDecision, type PerModel, type PricingSource, type PricingTable, type ProfileInputModalities, 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 ReasoningContextReset, type ReasoningEmit, type ReasoningProfile, type ReasoningRoundTrip, type RecallOptions, type RecallResult, type RecordedAudioSource, type RedisConnectionEvent, RedisStore, type RedisStoreOptions, type RememberOptions, type RememberResult, RequestCaptureChannel, type RequestCaptureOptions, type RequestCaptureSink, type RequestCaptureStatus, type ResolvedThinkingOptions, type Result, type RetryFeedbackHook, type RetryFeedbackInfo, type RetryFeedbackResult, type RetryPolicy, type RuntimeEvalConfigShape, SGLANG_PROFILE, SQLiteStore, type SQLiteStoreOptions, type SchemaCheckData, type SchemaDiagnosticData, type SchemaPromptOption, Session, type SessionOptions, type SessionUpdate, type SpanAttributeValue, type SpanAttributes, type SpanHandle, type SpanManager, type SpawnOptions, SqliteVectorStore, type StagedArtifact, StallTimeoutError, 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 TrackExecutionMetadata, type TrackExecutionResult, type TrackOutcomeOptions, type TrackedOutcome, type Transcript, type TranscriptionCapabilities, TranscriptionOperationError, type TranscriptionProvider, TranscriptionProviderRegistry, type TranscriptionProviderRequest, type TranscriptionProviderResult, type TranscriptionRequest, UnsupportedEventSchemaVersionError, UnsupportedModelInputError, UnsupportedModelOptionError, 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, capturedJournalLineSchema, createSpanManager, defineConfig, estimateOpenAICost, eventCostContribution, expandGlob, externalOperation, externalOperationRecordSchema, extractJson, extractThinkTags, findConfig, foldJournal, foldedOperationRecordSchema, getEventSchemaVersion, getExecutionEventSchemaVersion, hasPositiveBillableWork, hasPositiveTokens, importModule, inputText, isAdmissionDeniedError, isCostBearingLeaf, isRetryableStatus, isRootLevel, isUnpricedLeaf, isUsableCost, modelCallRecordSchema, needsTsxLoader, normalizeStoredExecution, openaiReasoningEmit, parsePartialJson, pickDefault, pickExport, priceFromTable, reasoningEffortEmit, reasoningObjectEmit, redactCapturedRequest, redactEvent, redactHistoricalEvent, redactModelCallRecord, registerConditions, resolveApiKey, resolvePerModel, resolveRuntime, resolveThinkingOptions, stringStreamFromEvents, summarizeModelInput, tool, workflow, zodToJsonSchema };