@axlsdk/axl 0.27.0 → 0.27.1

package/dist/index.d.cts

@@ -4890,10 +4890,7 @@ type WorkflowContextInit = {
      *    fn callbacks). Composed name: `__auto/<primitive>/<n>`.
      *
      *  Root contexts default to a fresh `{ byAgent: new Map(), root: 0 }`. */
-    autoCheckpointCounters?: {
-        byAgent: Map<string, number>;
-        root: number;
-    };
+    autoCheckpointCounters?: AutoCheckpointState;
     /** Internal: root-shared state for branch continuations that must settle
      *  before the runtime emits the workflow terminal and snapshots cost. */
     branchDrainState?: BranchDrainState;
@@ -4923,6 +4920,13 @@ type PendingDecisionResolver = {
      *  deleteExecution joins this barrier before its total store sweep. */
     cleanupFinished: Promise<void>;
 };
+/** Automatic checkpoint bookkeeping, shared by an execution's child contexts. */
+type AutoCheckpointState = {
+    byAgent: Map<string, number>;
+    root: number;
+    /** An automatic checkpoint failed to save, so none are saved from here on. */
+    saveFailed?: boolean;
+};
 /**
  * The central coordination object for all Axl primitives.
  * Carries execution state, tracing, budget tracking, and session history.
@@ -10012,6 +10016,20 @@ declare class SQLiteStore implements StateStore {
     deleteCheckpoints(executionId: string): Promise<void>;
 }
 
+/**
+ * A change in a {@link RedisStore}'s connection, passed to
+ * {@link RedisStoreOptions.onConnectionEvent}.
+ *
+ * - `error`: the connection was lost or a reconnect attempt failed. Arrives
+ *   once per attempt while Redis is down.
+ * - `reconnected`: the store is connected again and commands work.
+ */
+type RedisConnectionEvent = {
+    type: 'error';
+    error: Error;
+} | {
+    type: 'reconnected';
+};
 /** Options accepted by {@link RedisStore.create}. */
 interface RedisStoreOptions {
     /** Redis connection URL (e.g. `redis://localhost:6379`). Defaults to `redis://localhost:6379`. */
@@ -10036,6 +10054,16 @@ interface RedisStoreOptions {
      * operator experience.
      */
     keyPrefix?: string;
+    /**
+     * Called when the connection is lost, a reconnect attempt fails, or the
+     * connection comes back, for routing to a logger, metrics, or a health check.
+     * Replaces the default logging of one line per outage and one on recovery.
+     *
+     * Not called for a failed `create()`, whose rejection reports the failure,
+     * or after `close()`. A callback that throws or rejects is reported with
+     * `console.error` and otherwise ignored.
+     */
+    onConnectionEvent?: (event: RedisConnectionEvent) => void;
     /**
      * Skip the lazy backfill of legacy execution / eval-history entries into
      * the sorted-set indexes during `RedisStore.create()`. Default `false`
@@ -10139,10 +10167,28 @@ interface RedisStoreOptions {
  * async `RedisStore.create()` factory, which connects before returning.
  */
 declare class RedisStore implements StateStore {
-    private client;
+    private connection;
     private keyPrefix;
     private ttls;
     private constructor();
+    /**
+     * Whether the store can send commands right now, for a health check or for
+     * telling an outage from other failures when a call rejects. `false` while
+     * reconnecting and after `close()`.
+     */
+    get isConnected(): boolean;
+    /**
+     * The client for sending a command, failing immediately while disconnected.
+     *
+     * Every command goes through here because node-redis's `disableOfflineQueue`
+     * rejects single commands but not `multi().exec()`, which would wait for a
+     * reconnect attempt to fail or succeed. Nothing may `await` between
+     * `client.multi()` and `.exec()`, or a transaction could get past this check.
+     *
+     * A closed store isn't "unavailable": it falls through to node-redis's own
+     * "The client is closed" rejection.
+     */
+    private get client();
     /**
      * History kinds with a prune running in this process. A save skips its
      * prune while another one of the same kind is in flight: the running one
@@ -10395,6 +10441,11 @@ declare class RedisStore implements StateStore {
      * must not get a rejected promise for it. `MemoryStore.close()` and
      * 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.
      */
     close(): Promise<void>;
     deleteCheckpoints(executionId: string): Promise<void>;
@@ -10467,4 +10518,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, RedisStore, 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 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

@@ -4890,10 +4890,7 @@ type WorkflowContextInit = {
      *    fn callbacks). Composed name: `__auto/<primitive>/<n>`.
      *
      *  Root contexts default to a fresh `{ byAgent: new Map(), root: 0 }`. */
-    autoCheckpointCounters?: {
-        byAgent: Map<string, number>;
-        root: number;
-    };
+    autoCheckpointCounters?: AutoCheckpointState;
     /** Internal: root-shared state for branch continuations that must settle
      *  before the runtime emits the workflow terminal and snapshots cost. */
     branchDrainState?: BranchDrainState;
@@ -4923,6 +4920,13 @@ type PendingDecisionResolver = {
      *  deleteExecution joins this barrier before its total store sweep. */
     cleanupFinished: Promise<void>;
 };
+/** Automatic checkpoint bookkeeping, shared by an execution's child contexts. */
+type AutoCheckpointState = {
+    byAgent: Map<string, number>;
+    root: number;
+    /** An automatic checkpoint failed to save, so none are saved from here on. */
+    saveFailed?: boolean;
+};
 /**
  * The central coordination object for all Axl primitives.
  * Carries execution state, tracing, budget tracking, and session history.
@@ -10012,6 +10016,20 @@ declare class SQLiteStore implements StateStore {
     deleteCheckpoints(executionId: string): Promise<void>;
 }
 
+/**
+ * A change in a {@link RedisStore}'s connection, passed to
+ * {@link RedisStoreOptions.onConnectionEvent}.
+ *
+ * - `error`: the connection was lost or a reconnect attempt failed. Arrives
+ *   once per attempt while Redis is down.
+ * - `reconnected`: the store is connected again and commands work.
+ */
+type RedisConnectionEvent = {
+    type: 'error';
+    error: Error;
+} | {
+    type: 'reconnected';
+};
 /** Options accepted by {@link RedisStore.create}. */
 interface RedisStoreOptions {
     /** Redis connection URL (e.g. `redis://localhost:6379`). Defaults to `redis://localhost:6379`. */
@@ -10036,6 +10054,16 @@ interface RedisStoreOptions {
      * operator experience.
      */
     keyPrefix?: string;
+    /**
+     * Called when the connection is lost, a reconnect attempt fails, or the
+     * connection comes back, for routing to a logger, metrics, or a health check.
+     * Replaces the default logging of one line per outage and one on recovery.
+     *
+     * Not called for a failed `create()`, whose rejection reports the failure,
+     * or after `close()`. A callback that throws or rejects is reported with
+     * `console.error` and otherwise ignored.
+     */
+    onConnectionEvent?: (event: RedisConnectionEvent) => void;
     /**
      * Skip the lazy backfill of legacy execution / eval-history entries into
      * the sorted-set indexes during `RedisStore.create()`. Default `false`
@@ -10139,10 +10167,28 @@ interface RedisStoreOptions {
  * async `RedisStore.create()` factory, which connects before returning.
  */
 declare class RedisStore implements StateStore {
-    private client;
+    private connection;
     private keyPrefix;
     private ttls;
     private constructor();
+    /**
+     * Whether the store can send commands right now, for a health check or for
+     * telling an outage from other failures when a call rejects. `false` while
+     * reconnecting and after `close()`.
+     */
+    get isConnected(): boolean;
+    /**
+     * The client for sending a command, failing immediately while disconnected.
+     *
+     * Every command goes through here because node-redis's `disableOfflineQueue`
+     * rejects single commands but not `multi().exec()`, which would wait for a
+     * reconnect attempt to fail or succeed. Nothing may `await` between
+     * `client.multi()` and `.exec()`, or a transaction could get past this check.
+     *
+     * A closed store isn't "unavailable": it falls through to node-redis's own
+     * "The client is closed" rejection.
+     */
+    private get client();
     /**
      * History kinds with a prune running in this process. A save skips its
      * prune while another one of the same kind is in flight: the running one
@@ -10395,6 +10441,11 @@ declare class RedisStore implements StateStore {
      * must not get a rejected promise for it. `MemoryStore.close()` and
      * 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.
      */
     close(): Promise<void>;
     deleteCheckpoints(executionId: string): Promise<void>;
@@ -10467,4 +10518,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, RedisStore, 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 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.js

@@ -348,7 +348,7 @@ var sharedGuard = typeof installedGuard === "object" && installedGuard !== null
 var buildPath = typeof __AXL_BUILD_PATH__ === "string" ? __AXL_BUILD_PATH__ : "<source>";
 var thisCopy = {
   path: buildPath.startsWith("file:") ? fileURLToPath(buildPath) : buildPath,
-  version: true ? "0.27.0" : "unknown"
+  version: true ? "0.27.1" : "unknown"
 };
 function warnCrossCopy(other, joined) {
   if (other === thisCopy) return;
@@ -17026,7 +17026,7 @@ ${appendedSchemaText}`;
         `ctx.checkpoint name "${name}" is reserved \u2014 names starting with "__auto/" (case-insensitive) are used by the runtime for ask/spawn/race/parallel/map auto-checkpointing.`
       );
     }
-    return this._checkpoint(name, fn);
+    return this._checkpoint(name, fn, { saveRequired: true });
   }
   /**
    * Internal checkpoint implementation shared by both the public
@@ -17056,7 +17056,17 @@ ${appendedSchemaText}`;
       return saved;
     }
     const result = await fn();
-    await this.stateStore.saveCheckpoint(this.executionId, name, result);
+    if (!options?.saveRequired && this.autoCheckpointCounters.saveFailed) return result;
+    try {
+      await this.stateStore.saveCheckpoint(this.executionId, name, result);
+    } catch (err) {
+      if (options?.saveRequired) throw err;
+      this.autoCheckpointCounters.saveFailed = true;
+      console.error(
+        `[axl] Failed to save checkpoint "${name}" for executionId=${this.executionId}; a replay would run this step and later ones again: ${err instanceof Error ? err.message : String(err)}`
+      );
+      return result;
+    }
     this.emitEvent({
       type: "checkpoint_save",
       ...agentStamp,
@@ -19977,11 +19987,18 @@ var Session = class _Session {
     try {
       const completion = axlStream.promise.then(
         (result) => this.commitHistory(history, result).catch((err) => {
-          this.runtime.emit("error", {
-            type: "session_history_save_failed",
-            sessionId: this.sessionId,
-            error: err instanceof Error ? err.message : String(err)
-          });
+          const error = err instanceof Error ? err.message : String(err);
+          try {
+            this.runtime.emit("error", {
+              type: "session_history_save_failed",
+              sessionId: this.sessionId,
+              error
+            });
+          } catch {
+            console.error(
+              `[axl] Failed to save session history for sessionId=${this.sessionId}: ${error}`
+            );
+          }
         }),
         () => void 0
       );
@@ -22057,7 +22074,11 @@ var AxlRuntime = class extends EventEmitter2 {
         observation
       });
       if (this.stateStore.deleteCheckpoints) {
-        await this.stateStore.deleteCheckpoints(execInfo.executionId);
+        await this.stateStore.deleteCheckpoints(execInfo.executionId).catch((err) => {
+          console.error(
+            `[axl] Failed to delete checkpoints for executionId=${execInfo.executionId}: ` + (err instanceof Error ? err.message : String(err))
+          );
+        });
       }
       span?.setAttribute("axl.workflow.cost", execInfo.totalCost);
       span?.setAttribute("axl.workflow.duration", execInfo.duration);
@@ -22129,7 +22150,10 @@ var AxlRuntime = class extends EventEmitter2 {
       const chain = this.stateStore.saveExecution(snapshot).then(() => {
         return this.streamingFlusher?.finalize(id).catch(() => {
         });
-      }).catch(() => {
+      }).catch((err) => {
+        console.error(
+          `[axl] Failed to save execution history for executionId=${id}: ` + (err instanceof Error ? err.message : String(err))
+        );
       }).then(() => void 0);
       this.persistInflight.add(chain);
       const pending = { snapshot, settled: chain };
@@ -24552,12 +24576,108 @@ function warnIfRedisExecutionRetentionUnset(opts) {
     warnExecutionRetentionUnset("RedisStore");
   }
 }
+var CLOSE_TIMEOUT_MS = 2e3;
+function reconnectDelayMs(retries) {
+  return Math.min(2 ** retries * 50, 2e3) + Math.floor(Math.random() * 200);
+}
+function abandonConnection(client) {
+  try {
+    client.destroy?.();
+  } catch {
+  }
+  client.unref?.();
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function connectionEventReporter(client, onConnectionEvent) {
+  if (onConnectionEvent) {
+    const reportFailure = (error) => console.error(`[axl] RedisStore: onConnectionEvent failed: ${errorMessage(error)}`);
+    return (event) => {
+      try {
+        Promise.resolve(onConnectionEvent(event)).catch(reportFailure);
+      } catch (error) {
+        reportFailure(error);
+      }
+    };
+  }
+  let outageLogged = false;
+  return (event) => {
+    if (event.type === "reconnected") {
+      outageLogged = false;
+      console.warn("[axl] RedisStore: reconnected to Redis.");
+    } else if (!outageLogged) {
+      outageLogged = client.isReady === false;
+      console.warn(
+        `[axl] RedisStore: Redis connection lost (${event.error.message}). Store calls fail until it reconnects, which happens automatically.`
+      );
+    }
+  };
+}
+async function connectClient(createClient, opts) {
+  let established = false;
+  const client = createClient({
+    ...opts.url ? { url: opts.url } : {},
+    // A command accepted just before a drop rejects instead of waiting for
+    // the reconnect.
+    disableOfflineQueue: true,
+    socket: { reconnectStrategy: (retries) => established ? reconnectDelayMs(retries) : false }
+  });
+  const reportConnectionEvent = connectionEventReporter(client, opts.onConnectionEvent);
+  client.on("error", (error) => {
+    if (!established || client.isOpen === false) return;
+    reportConnectionEvent({
+      type: "error",
+      error: error instanceof Error ? error : new Error(String(error))
+    });
+  });
+  client.on("connect", () => {
+    if (client.isOpen === false) client.unref?.();
+  });
+  client.on("ready", () => {
+    if (!established) {
+      established = true;
+    } else if (client.isOpen !== false) {
+      reportConnectionEvent({ type: "reconnected" });
+    }
+  });
+  await client.connect();
+  return client;
+}
 var RedisStore = class _RedisStore {
-  constructor(client, keyPrefix, ttls) {
-    this.client = client;
+  constructor(connection, keyPrefix, ttls) {
+    this.connection = connection;
     this.keyPrefix = keyPrefix;
     this.ttls = ttls;
   }
+  /**
+   * Whether the store can send commands right now, for a health check or for
+   * telling an outage from other failures when a call rejects. `false` while
+   * reconnecting and after `close()`.
+   */
+  get isConnected() {
+    return this.connection.isOpen !== false && this.connection.isReady !== false;
+  }
+  /**
+   * The client for sending a command, failing immediately while disconnected.
+   *
+   * Every command goes through here because node-redis's `disableOfflineQueue`
+   * rejects single commands but not `multi().exec()`, which would wait for a
+   * reconnect attempt to fail or succeed. Nothing may `await` between
+   * `client.multi()` and `.exec()`, or a transaction could get past this check.
+   *
+   * A closed store isn't "unavailable": it falls through to node-redis's own
+   * "The client is closed" rejection.
+   */
+  get client() {
+    if (this.connection.isOpen !== false && this.connection.isReady === false) {
+      throw new AxlError(
+        "REDIS_UNAVAILABLE",
+        "RedisStore: not connected to Redis, so the command was not sent. The store reconnects automatically; retry once Redis is back."
+      );
+    }
+    return this.connection;
+  }
   /**
    * History kinds with a prune running in this process. A save skips its
    * prune while another one of the same kind is in flight: the running one
@@ -24627,8 +24747,7 @@ var RedisStore = class _RedisStore {
       if (err instanceof Error && err.message.includes("createClient")) throw err;
       throw new Error("redis is required for RedisStore. Install it with: npm install redis");
     }
-    const client = opts.url ? createClient({ url: opts.url }) : createClient();
-    await client.connect();
+    const client = await connectClient(createClient, opts);
     const resolveCategory = (override) => {
       if (override === null) return null;
       if (typeof override === "number") return override;
@@ -24652,8 +24771,13 @@ var RedisStore = class _RedisStore {
     const store = new _RedisStore(client, keyPrefix, effectiveTtls);
     warnIfRedisExecutionRetentionUnset(opts);
     if (!opts.skipMigration) {
-      await store.backfillExecutionIndex();
-      await store.backfillEvalIndex();
+      try {
+        await store.backfillExecutionIndex();
+        await store.backfillEvalIndex();
+      } catch (error) {
+        abandonConnection(client);
+        throw error;
+      }
     }
     return store;
   }
@@ -24922,7 +25046,7 @@ var RedisStore = class _RedisStore {
       }
     }
     if (dead.length > 0) {
-      this.client.sRem(this.pendingExecSetKey(), dead).catch((err) => {
+      this.connection.sRem(this.pendingExecSetKey(), dead).catch((err) => {
         console.error(
           `[axl] RedisStore: failed to prune ${dead.length} stale pending-exec ids: ` + (err instanceof Error ? err.message : String(err))
         );
@@ -24968,7 +25092,7 @@ var RedisStore = class _RedisStore {
     }
     const ttl = this.ttlFor("memory");
     if (ttl !== void 0) {
-      this.client.expire(this.memoryKey(scope), ttl).catch((err) => {
+      this.connection.expire(this.memoryKey(scope), ttl).catch((err) => {
         console.error(
           `[axl] RedisStore: failed to set TTL on migrated memory key ${this.memoryKey(scope)}: ` + (err instanceof Error ? err.message : String(err))
         );
@@ -25260,6 +25384,7 @@ var RedisStore = class _RedisStore {
     try {
       await this.pruneHistory(index);
     } catch (err) {
+      if (this.connection.isReady === false) return;
       warnDiagnosticOnce(
         `redis_history_prune_failed\0${index.kind}`,
         `RedisStore: removing expired ${index.label} index entries failed (${err instanceof Error ? err.message : String(err)}). The record was saved; the next save retries the cleanup. Listings stay correct meanwhile. The cleanup runs a Lua script, so the Redis user needs permission to run EVAL.`,
@@ -25464,10 +25589,31 @@ var RedisStore = class _RedisStore {
    * must not get a rejected promise for it. `MemoryStore.close()` and
    * 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.
    */
   async close() {
-    if (this.client.isOpen === false) return;
-    await this.client.quit();
+    if (this.connection.isOpen === false) return;
+    if (this.connection.isReady === false) {
+      abandonConnection(this.connection);
+      return;
+    }
+    let timer;
+    try {
+      await Promise.race([
+        this.connection.quit(),
+        new Promise((_resolve, reject) => {
+          timer = setTimeout(() => reject(new Error("QUIT timed out")), CLOSE_TIMEOUT_MS);
+        })
+      ]);
+    } catch {
+      abandonConnection(this.connection);
+    } finally {
+      clearTimeout(timer);
+    }
   }
   async deleteCheckpoints(executionId) {
     await this.client.del(this.checkpointKey(executionId));