zeitlich 0.2.45 → 0.2.46

package/dist/index.d.cts

@@ -1,17 +1,19 @@
-import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-DMmiaw6w.cjs';
-export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as THREAD_TTL_SECONDS, g as TaskCreateArgs, h as TaskGetArgs, i as TaskListArgs, j as TaskUpdateArgs, k as ToolExecutedEvent, l as TurnCompletedEvent, W as WorkflowConfig, m as WorkflowInput, n as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, o as applyVirtualTreeMutations, p as askUserQuestionTool, q as bashTool, r as composeHooks, s as createAgentStateManager, t as createAskUserQuestionHandler, u as createBashToolDescription, v as createObservabilityHooks, w as createReadSkillHandler, x as createReadSkillTool, y as createSession, z as createTaskCreateHandler, C as createTaskGetHandler, E as createTaskListHandler, H as createTaskUpdateHandler, I as createToolRouter, J as defineSubagent, K as defineSubagentWorkflow, L as defineTool, M as defineWorkflow, N as editTool, P as filesWithMimeType, Q as formatVirtualFileTree, U as getShortId, V as getThreadListKey, X as getThreadMetaKey, Y as globTool, _ as grepTool, $ as hasDirectory, a0 as hasFileWithMimeType, a1 as hasNoOtherToolCalls, a2 as parseSkillFile, a3 as proxyRunAgent, a4 as proxyVirtualFsOps, a5 as readFileTool, a6 as taskCreateTool, a7 as taskGetTool, a8 as taskListTool, a9 as taskUpdateTool, aa as writeFileTool } from './workflow-DMmiaw6w.cjs';
-import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-CdALEF3z.cjs';
-export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-CdALEF3z.cjs';
+import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-DIaIV7L2.cjs';
+export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as THREAD_TTL_SECONDS, g as TaskCreateArgs, h as TaskGetArgs, i as TaskListArgs, j as TaskUpdateArgs, k as ToolExecutedEvent, l as TurnCompletedEvent, W as WorkflowConfig, m as WorkflowInput, n as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, o as applyVirtualTreeMutations, p as askUserQuestionTool, q as bashTool, r as composeHooks, s as createAgentStateManager, t as createAskUserQuestionHandler, u as createBashToolDescription, v as createObservabilityHooks, w as createReadSkillHandler, x as createReadSkillTool, y as createSession, z as createTaskCreateHandler, C as createTaskGetHandler, E as createTaskListHandler, H as createTaskUpdateHandler, I as createToolRouter, J as defineSubagent, K as defineSubagentWorkflow, L as defineTool, M as defineWorkflow, N as editTool, P as filesWithMimeType, Q as formatVirtualFileTree, U as getShortId, V as getThreadDedupKey, X as getThreadListKey, Y as getThreadMetaKey, _ as getThreadStateKey, $ as globTool, a0 as grepTool, a1 as hasDirectory, a2 as hasFileWithMimeType, a3 as hasNoOtherToolCalls, a4 as parseSkillFile, a5 as proxyRunAgent, a6 as proxyVirtualFsOps, a7 as readFileTool, a8 as taskCreateTool, a9 as taskGetTool, aa as taskListTool, ab as taskUpdateTool, ac as writeFileTool } from './workflow-DIaIV7L2.cjs';
+import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-CnuN9T6t.cjs';
+export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-CnuN9T6t.cjs';
 import { b as Sandbox, c as SandboxFileSystem, a as SandboxCreateOptions, h as SandboxCapability, d as SandboxProvider, g as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-CJ7tCdl6.cjs';
 export { i as ExecOptions, e as SandboxCapabilities, f as SandboxCreateResult, j as SandboxNotFoundError, k as SandboxNotSupportedError, S as SandboxOps } from './types-CJ7tCdl6.cjs';
 import { WorkflowClient } from '@temporalio/client';
-import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-C66-BVBr.cjs';
-export { P as ProviderThreadManager } from './types-C66-BVBr.cjs';
+import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-oxt8GN97.cjs';
+export { P as ProviderThreadManager } from './types-oxt8GN97.cjs';
+import { C as ColdThreadStore, T as ThreadSnapshot } from './cold-store-BC5L5Z8A.cjs';
+export { S as S3ColdStoreConfig, a as S3LikeClient, c as createS3ColdStore } from './cold-store-BC5L5Z8A.cjs';
+import Redis from 'ioredis';
 import 'zod';
 import '@temporalio/common';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
-import 'ioredis';
 
 /**
  * Wraps a tool handler to automatically append its result directly to the
@@ -232,6 +234,134 @@ declare class FileSystemSkillProvider implements SkillProvider {
  */
 declare function createThreadManager<T>(config: ThreadManagerConfig<T>): BaseThreadManager<T>;
 
+/**
+ * Tiered thread manager: Redis hot tier + pluggable cold tier.
+ *
+ * Wraps {@link createThreadManager} (Redis-only) and adds two
+ * session-boundary operations:
+ *
+ * - `hydrate()` — when the thread is cold (no meta key in Redis),
+ *   restore the latest {@link ThreadSnapshot} from the cold store.
+ *   Idempotent; no-op when the thread is already hot or when no
+ *   snapshot exists.
+ * - `flush({ deleteHot })` — write the current Redis state out to the
+ *   cold store as one snapshot, then (by default) `DEL` the hot-tier
+ *   keys so idle threads don't sit in Redis memory.
+ *
+ * All other operations (`append`, `load`, `fork`, `replaceAll`,
+ * `truncateFromId`, state I/O) delegate unchanged to the underlying
+ * Redis manager, so adapters and tests that use the
+ * `BaseThreadManager<T>` interface keep working with zero changes.
+ */
+
+/** Configuration for {@link createTieredThreadManager}. */
+interface TieredThreadManagerConfig<T> extends ThreadManagerConfig<T> {
+    /**
+     * Cold-tier archive. When omitted, `hydrate()` and `flush()` are
+     * no-ops and the manager behaves identically to
+     * {@link createThreadManager}.
+     */
+    coldStore?: ColdThreadStore;
+}
+/** Options for {@link TieredThreadManager.flush}. */
+interface FlushOptions {
+    /**
+     * Delete the hot-tier Redis keys after a successful cold-tier
+     * write. Defaults to `true` when a cold store is configured —
+     * Redis is just a cache and a future continue/fork will
+     * re-hydrate in a single round-trip.
+     *
+     * Set to `false` to keep the hot tier warm (useful for tests or
+     * for "hot-after-flush" use cases where another session is expected
+     * to pick the thread up immediately).
+     */
+    deleteHot?: boolean;
+}
+/**
+ * Extension of {@link BaseThreadManager} with the two cold-tier
+ * lifecycle methods.
+ */
+interface TieredThreadManager<T> extends BaseThreadManager<T> {
+    /**
+     * Restore the latest cold-tier snapshot into Redis when the thread
+     * is cold. Idempotent — safe to call from a retried activity.
+     */
+    hydrate(): Promise<void>;
+    /**
+     * Write the current Redis state to the cold tier and (optionally)
+     * drop the hot-tier keys. Idempotent — last-writer-wins on the
+     * cold side.
+     */
+    flush(opts?: FlushOptions): Promise<void>;
+}
+/**
+ * Build a thread manager backed by Redis (hot) and an optional
+ * pluggable cold store. See module docstring for the lifecycle
+ * semantics.
+ */
+declare function createTieredThreadManager<T>(config: TieredThreadManagerConfig<T>): TieredThreadManager<T>;
+
+/**
+ * Pure Redis I/O helpers for moving a thread between the hot tier
+ * (Redis lists + meta + state + dedup markers) and the cold tier
+ * (a single {@link ThreadSnapshot} blob in a {@link ColdThreadStore}).
+ *
+ * These helpers know nothing about S3 or the adapter-specific message
+ * envelope — they operate on the raw Redis representation. The
+ * tiered thread manager in `tiered.ts` is the only consumer.
+ */
+
+/** Inputs shared by every snapshot operation. */
+interface SnapshotCommon {
+    redis: Redis;
+    threadKey: string;
+    threadId: string;
+}
+/** Configuration for {@link encodeSnapshot}. */
+interface EncodeSnapshotConfig extends SnapshotCommon {
+    /**
+     * Extract a dedup id from each raw-serialized message currently in
+     * the thread's Redis list. When omitted, the resulting snapshot has
+     * an empty `dedupIds` array — idempotency guarantees are best-effort
+     * once a thread crosses the hot/cold boundary.
+     */
+    idOf?: (raw: string) => string;
+}
+/**
+ * Build a {@link ThreadSnapshot} from the current hot-tier state.
+ *
+ * Returns `null` when no thread exists in the hot tier (the meta key
+ * is absent) — callers should treat that as "nothing to flush".
+ */
+declare function encodeSnapshot(config: EncodeSnapshotConfig): Promise<ThreadSnapshot | null>;
+/** Configuration for {@link applySnapshot}. */
+interface ApplySnapshotConfig extends SnapshotCommon {
+    snapshot: ThreadSnapshot;
+    /** TTL applied to every Redis key. Defaults to {@link THREAD_TTL_SECONDS}. */
+    ttlSeconds?: number;
+}
+/**
+ * Restore a {@link ThreadSnapshot} into the hot tier.
+ *
+ * Idempotent — if the meta key already exists the thread is already
+ * hot and this is a no-op. The meta key is written **last** so a
+ * crash mid-restore leaves the thread cold (`load` / `append` will
+ * see "thread does not exist") and the next session's hydrate retries
+ * cleanly.
+ */
+declare function applySnapshot(config: ApplySnapshotConfig): Promise<void>;
+/** Configuration for {@link clearHotTier}. */
+interface ClearHotTierConfig extends SnapshotCommon {
+    /** Dedup ids to delete alongside the list / meta / state keys. */
+    dedupIds?: string[];
+}
+/**
+ * Delete every Redis key the thread manager wrote for `(threadKey,
+ * threadId)`. Used by the tiered manager's `flush({ deleteHot: true })`
+ * to drop hot-tier memory after a successful archive write.
+ */
+declare function clearHotTier(config: ClearHotTierConfig): Promise<void>;
+
 /**
  * Result returned by {@link SandboxManagerHooks.onPreCreate}.
  *
@@ -594,4 +724,4 @@ declare const toTree: (fs: SandboxFileSystem, opts?: {
     sort?: boolean;
 }) => Promise<string>;
 
-export { ActivityToolHandler, type AgentStateContext, BaseAgentState, BaseThreadManager, BashArgs, ExecResult, FileEditArgs, FileEntryMetadata, FileReadArgs, FileResolver, FileSystemSkillProvider, FileWriteArgs, GlobArgs, JsonValue, NodeFsSandboxFileSystem, type PreCreateHookResult, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, SandboxCapability, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, type SandboxManagerHooks, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, type WithSandboxOptions, bashHandler, createRunAgentActivity, createThreadManager, createVirtualFsActivities, editHandler, getActivityContext, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };
+export { ActivityToolHandler, type AgentStateContext, type ApplySnapshotConfig, BaseAgentState, BaseThreadManager, BashArgs, type ClearHotTierConfig, ColdThreadStore, type EncodeSnapshotConfig, ExecResult, FileEditArgs, FileEntryMetadata, FileReadArgs, FileResolver, FileSystemSkillProvider, FileWriteArgs, type FlushOptions, GlobArgs, JsonValue, NodeFsSandboxFileSystem, type PreCreateHookResult, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, SandboxCapability, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, type SandboxManagerHooks, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ThreadSnapshot, type TieredThreadManager, type TieredThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, type WithSandboxOptions, applySnapshot, bashHandler, clearHotTier, createRunAgentActivity, createThreadManager, createTieredThreadManager, createVirtualFsActivities, editHandler, encodeSnapshot, getActivityContext, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };

package/dist/index.d.ts

@@ -1,17 +1,19 @@
-import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-BwT5EybR.js';
-export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as THREAD_TTL_SECONDS, g as TaskCreateArgs, h as TaskGetArgs, i as TaskListArgs, j as TaskUpdateArgs, k as ToolExecutedEvent, l as TurnCompletedEvent, W as WorkflowConfig, m as WorkflowInput, n as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, o as applyVirtualTreeMutations, p as askUserQuestionTool, q as bashTool, r as composeHooks, s as createAgentStateManager, t as createAskUserQuestionHandler, u as createBashToolDescription, v as createObservabilityHooks, w as createReadSkillHandler, x as createReadSkillTool, y as createSession, z as createTaskCreateHandler, C as createTaskGetHandler, E as createTaskListHandler, H as createTaskUpdateHandler, I as createToolRouter, J as defineSubagent, K as defineSubagentWorkflow, L as defineTool, M as defineWorkflow, N as editTool, P as filesWithMimeType, Q as formatVirtualFileTree, U as getShortId, V as getThreadListKey, X as getThreadMetaKey, Y as globTool, _ as grepTool, $ as hasDirectory, a0 as hasFileWithMimeType, a1 as hasNoOtherToolCalls, a2 as parseSkillFile, a3 as proxyRunAgent, a4 as proxyVirtualFsOps, a5 as readFileTool, a6 as taskCreateTool, a7 as taskGetTool, a8 as taskListTool, a9 as taskUpdateTool, aa as writeFileTool } from './workflow-BwT5EybR.js';
-import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-ChAy_jSP.js';
-export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-ChAy_jSP.js';
+import { B as BashArgs, F as FileEditArgs, G as GlobArgs, a as FileReadArgs, b as FileWriteArgs } from './workflow-B1TOcHbt.js';
+export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, c as FileTreeAccessor, d as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, e as SessionStartedEvent, f as SubagentArgs, T as THREAD_TTL_SECONDS, g as TaskCreateArgs, h as TaskGetArgs, i as TaskListArgs, j as TaskUpdateArgs, k as ToolExecutedEvent, l as TurnCompletedEvent, W as WorkflowConfig, m as WorkflowInput, n as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, o as applyVirtualTreeMutations, p as askUserQuestionTool, q as bashTool, r as composeHooks, s as createAgentStateManager, t as createAskUserQuestionHandler, u as createBashToolDescription, v as createObservabilityHooks, w as createReadSkillHandler, x as createReadSkillTool, y as createSession, z as createTaskCreateHandler, C as createTaskGetHandler, E as createTaskListHandler, H as createTaskUpdateHandler, I as createToolRouter, J as defineSubagent, K as defineSubagentWorkflow, L as defineTool, M as defineWorkflow, N as editTool, P as filesWithMimeType, Q as formatVirtualFileTree, U as getShortId, V as getThreadDedupKey, X as getThreadListKey, Y as getThreadMetaKey, _ as getThreadStateKey, $ as globTool, a0 as grepTool, a1 as hasDirectory, a2 as hasFileWithMimeType, a3 as hasNoOtherToolCalls, a4 as parseSkillFile, a5 as proxyRunAgent, a6 as proxyVirtualFsOps, a7 as readFileTool, a8 as taskCreateTool, a9 as taskGetTool, aa as taskListTool, ab as taskUpdateTool, ac as writeFileTool } from './workflow-B1TOcHbt.js';
+import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-CwN6_tAL.js';
+export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-CwN6_tAL.js';
 import { b as Sandbox, c as SandboxFileSystem, a as SandboxCreateOptions, h as SandboxCapability, d as SandboxProvider, g as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-CJ7tCdl6.js';
 export { i as ExecOptions, e as SandboxCapabilities, f as SandboxCreateResult, j as SandboxNotFoundError, k as SandboxNotSupportedError, S as SandboxOps } from './types-CJ7tCdl6.js';
 import { WorkflowClient } from '@temporalio/client';
-import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-BkX4HLzi.js';
-export { P as ProviderThreadManager } from './types-BkX4HLzi.js';
+import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-L5bvbF-n.js';
+export { P as ProviderThreadManager } from './types-L5bvbF-n.js';
+import { C as ColdThreadStore, T as ThreadSnapshot } from './cold-store-CFHwemBJ.js';
+export { S as S3ColdStoreConfig, a as S3LikeClient, c as createS3ColdStore } from './cold-store-CFHwemBJ.js';
+import Redis from 'ioredis';
 import 'zod';
 import '@temporalio/common';
 import '@temporalio/workflow';
 import '@temporalio/common/lib/interfaces';
-import 'ioredis';
 
 /**
  * Wraps a tool handler to automatically append its result directly to the
@@ -232,6 +234,134 @@ declare class FileSystemSkillProvider implements SkillProvider {
  */
 declare function createThreadManager<T>(config: ThreadManagerConfig<T>): BaseThreadManager<T>;
 
+/**
+ * Tiered thread manager: Redis hot tier + pluggable cold tier.
+ *
+ * Wraps {@link createThreadManager} (Redis-only) and adds two
+ * session-boundary operations:
+ *
+ * - `hydrate()` — when the thread is cold (no meta key in Redis),
+ *   restore the latest {@link ThreadSnapshot} from the cold store.
+ *   Idempotent; no-op when the thread is already hot or when no
+ *   snapshot exists.
+ * - `flush({ deleteHot })` — write the current Redis state out to the
+ *   cold store as one snapshot, then (by default) `DEL` the hot-tier
+ *   keys so idle threads don't sit in Redis memory.
+ *
+ * All other operations (`append`, `load`, `fork`, `replaceAll`,
+ * `truncateFromId`, state I/O) delegate unchanged to the underlying
+ * Redis manager, so adapters and tests that use the
+ * `BaseThreadManager<T>` interface keep working with zero changes.
+ */
+
+/** Configuration for {@link createTieredThreadManager}. */
+interface TieredThreadManagerConfig<T> extends ThreadManagerConfig<T> {
+    /**
+     * Cold-tier archive. When omitted, `hydrate()` and `flush()` are
+     * no-ops and the manager behaves identically to
+     * {@link createThreadManager}.
+     */
+    coldStore?: ColdThreadStore;
+}
+/** Options for {@link TieredThreadManager.flush}. */
+interface FlushOptions {
+    /**
+     * Delete the hot-tier Redis keys after a successful cold-tier
+     * write. Defaults to `true` when a cold store is configured —
+     * Redis is just a cache and a future continue/fork will
+     * re-hydrate in a single round-trip.
+     *
+     * Set to `false` to keep the hot tier warm (useful for tests or
+     * for "hot-after-flush" use cases where another session is expected
+     * to pick the thread up immediately).
+     */
+    deleteHot?: boolean;
+}
+/**
+ * Extension of {@link BaseThreadManager} with the two cold-tier
+ * lifecycle methods.
+ */
+interface TieredThreadManager<T> extends BaseThreadManager<T> {
+    /**
+     * Restore the latest cold-tier snapshot into Redis when the thread
+     * is cold. Idempotent — safe to call from a retried activity.
+     */
+    hydrate(): Promise<void>;
+    /**
+     * Write the current Redis state to the cold tier and (optionally)
+     * drop the hot-tier keys. Idempotent — last-writer-wins on the
+     * cold side.
+     */
+    flush(opts?: FlushOptions): Promise<void>;
+}
+/**
+ * Build a thread manager backed by Redis (hot) and an optional
+ * pluggable cold store. See module docstring for the lifecycle
+ * semantics.
+ */
+declare function createTieredThreadManager<T>(config: TieredThreadManagerConfig<T>): TieredThreadManager<T>;
+
+/**
+ * Pure Redis I/O helpers for moving a thread between the hot tier
+ * (Redis lists + meta + state + dedup markers) and the cold tier
+ * (a single {@link ThreadSnapshot} blob in a {@link ColdThreadStore}).
+ *
+ * These helpers know nothing about S3 or the adapter-specific message
+ * envelope — they operate on the raw Redis representation. The
+ * tiered thread manager in `tiered.ts` is the only consumer.
+ */
+
+/** Inputs shared by every snapshot operation. */
+interface SnapshotCommon {
+    redis: Redis;
+    threadKey: string;
+    threadId: string;
+}
+/** Configuration for {@link encodeSnapshot}. */
+interface EncodeSnapshotConfig extends SnapshotCommon {
+    /**
+     * Extract a dedup id from each raw-serialized message currently in
+     * the thread's Redis list. When omitted, the resulting snapshot has
+     * an empty `dedupIds` array — idempotency guarantees are best-effort
+     * once a thread crosses the hot/cold boundary.
+     */
+    idOf?: (raw: string) => string;
+}
+/**
+ * Build a {@link ThreadSnapshot} from the current hot-tier state.
+ *
+ * Returns `null` when no thread exists in the hot tier (the meta key
+ * is absent) — callers should treat that as "nothing to flush".
+ */
+declare function encodeSnapshot(config: EncodeSnapshotConfig): Promise<ThreadSnapshot | null>;
+/** Configuration for {@link applySnapshot}. */
+interface ApplySnapshotConfig extends SnapshotCommon {
+    snapshot: ThreadSnapshot;
+    /** TTL applied to every Redis key. Defaults to {@link THREAD_TTL_SECONDS}. */
+    ttlSeconds?: number;
+}
+/**
+ * Restore a {@link ThreadSnapshot} into the hot tier.
+ *
+ * Idempotent — if the meta key already exists the thread is already
+ * hot and this is a no-op. The meta key is written **last** so a
+ * crash mid-restore leaves the thread cold (`load` / `append` will
+ * see "thread does not exist") and the next session's hydrate retries
+ * cleanly.
+ */
+declare function applySnapshot(config: ApplySnapshotConfig): Promise<void>;
+/** Configuration for {@link clearHotTier}. */
+interface ClearHotTierConfig extends SnapshotCommon {
+    /** Dedup ids to delete alongside the list / meta / state keys. */
+    dedupIds?: string[];
+}
+/**
+ * Delete every Redis key the thread manager wrote for `(threadKey,
+ * threadId)`. Used by the tiered manager's `flush({ deleteHot: true })`
+ * to drop hot-tier memory after a successful archive write.
+ */
+declare function clearHotTier(config: ClearHotTierConfig): Promise<void>;
+
 /**
  * Result returned by {@link SandboxManagerHooks.onPreCreate}.
  *
@@ -594,4 +724,4 @@ declare const toTree: (fs: SandboxFileSystem, opts?: {
     sort?: boolean;
 }) => Promise<string>;
 
-export { ActivityToolHandler, type AgentStateContext, BaseAgentState, BaseThreadManager, BashArgs, ExecResult, FileEditArgs, FileEntryMetadata, FileReadArgs, FileResolver, FileSystemSkillProvider, FileWriteArgs, GlobArgs, JsonValue, NodeFsSandboxFileSystem, type PreCreateHookResult, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, SandboxCapability, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, type SandboxManagerHooks, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, type WithSandboxOptions, bashHandler, createRunAgentActivity, createThreadManager, createVirtualFsActivities, editHandler, getActivityContext, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };
+export { ActivityToolHandler, type AgentStateContext, type ApplySnapshotConfig, BaseAgentState, BaseThreadManager, BashArgs, type ClearHotTierConfig, ColdThreadStore, type EncodeSnapshotConfig, ExecResult, FileEditArgs, FileEntryMetadata, FileReadArgs, FileResolver, FileSystemSkillProvider, FileWriteArgs, type FlushOptions, GlobArgs, JsonValue, NodeFsSandboxFileSystem, type PreCreateHookResult, PrefixedSandboxOps, PrefixedVirtualFsOps, RouterContext, RunAgentConfig, Sandbox, SandboxCapability, type SandboxContext, SandboxCreateOptions, DirentEntry as SandboxDirentEntry, FileStat as SandboxFileStat, SandboxFileSystem, SandboxManager, type SandboxManagerHooks, SandboxProvider, SandboxSnapshot, Skill, SkillMetadata, SkillProvider, ThreadManagerConfig, ThreadSnapshot, type TieredThreadManager, type TieredThreadManagerConfig, ToolHandlerResponse, ToolResultConfig, TreeMutation, VirtualFsContext, type WithSandboxOptions, applySnapshot, bashHandler, clearHotTier, createRunAgentActivity, createThreadManager, createTieredThreadManager, createVirtualFsActivities, editHandler, encodeSnapshot, getActivityContext, globHandler, queryParentWorkflowState, readFileHandler, toTree, withAutoAppend, withParentWorkflowState, withSandbox, withVirtualFs, writeFileHandler };