zeitlich 0.2.44 → 0.2.46

package/dist/{proxy-DTnc5rqT.d.cts → proxy-BxFyd6cg.d.cts}

@@ -1,5 +1,5 @@
 import { proxyActivities, ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from './types-4Wmk-wRq.cjs';
+import { T as ThreadOps } from './types-CnuN9T6t.cjs';
 
 /**
  * Shared proxy helper for thread operations.

package/dist/{proxy-B7Xi1znZ.d.ts → proxy-Cskmj4Yx.d.ts}

@@ -1,5 +1,5 @@
 import { proxyActivities, ActivityInterfaceFor } from '@temporalio/workflow';
-import { T as ThreadOps } from './types-DKsCdAtQ.js';
+import { T as ThreadOps } from './types-CwN6_tAL.js';
 
 /**
  * Shared proxy helper for thread operations.

package/dist/{thread-manager-BlX2TwRN.d.cts → thread-manager-9tezUcLW.d.cts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { J as JsonValue } from './types-4Wmk-wRq.cjs';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-DRJt1TMi.cjs';
+import { J as JsonValue } from './types-CnuN9T6t.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-oxt8GN97.cjs';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];
@@ -21,6 +21,12 @@ interface AnthropicThreadManagerConfig {
     /** Thread key, defaults to 'messages' */
     key?: string;
     hooks?: AnthropicThreadManagerHooks;
+    /**
+     * Override the default thread TTL (90 days). When pairing the
+     * adapter with a durable cold tier, a shorter TTL (hours) is
+     * typically more appropriate.
+     */
+    ttlSeconds?: number;
 }
 /** Prepared payload ready to send to the Anthropic API */
 interface AnthropicInvocationPayload {
@@ -39,4 +45,4 @@ interface AnthropicThreadManager extends ProviderThreadManager<StoredMessage, An
  */
 declare function createAnthropicThreadManager(config: AnthropicThreadManagerConfig): AnthropicThreadManager;
 
-export { type AnthropicContent as A, type StoredMessage as S, type AnthropicThreadManagerHooks as a, type AnthropicThreadManager as b, createAnthropicThreadManager as c, type AnthropicThreadManagerConfig as d, type AnthropicInvocationPayload as e };
+export { type AnthropicContent as A, type StoredMessage as S, type AnthropicThreadManagerHooks as a, type AnthropicInvocationPayload as b, type AnthropicThreadManager as c, type AnthropicThreadManagerConfig as d, createAnthropicThreadManager as e };

package/dist/{thread-manager-BAv340mi.d.ts → thread-manager-B-zy3xrs.d.ts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { J as JsonValue } from './types-DKsCdAtQ.js';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-Clhqautb.js';
+import { J as JsonValue } from './types-CwN6_tAL.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-L5bvbF-n.js';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];
@@ -21,6 +21,12 @@ interface AnthropicThreadManagerConfig {
     /** Thread key, defaults to 'messages' */
     key?: string;
     hooks?: AnthropicThreadManagerHooks;
+    /**
+     * Override the default thread TTL (90 days). When pairing the
+     * adapter with a durable cold tier, a shorter TTL (hours) is
+     * typically more appropriate.
+     */
+    ttlSeconds?: number;
 }
 /** Prepared payload ready to send to the Anthropic API */
 interface AnthropicInvocationPayload {
@@ -39,4 +45,4 @@ interface AnthropicThreadManager extends ProviderThreadManager<StoredMessage, An
  */
 declare function createAnthropicThreadManager(config: AnthropicThreadManagerConfig): AnthropicThreadManager;
 
-export { type AnthropicContent as A, type StoredMessage as S, type AnthropicThreadManagerHooks as a, type AnthropicThreadManager as b, createAnthropicThreadManager as c, type AnthropicThreadManagerConfig as d, type AnthropicInvocationPayload as e };
+export { type AnthropicContent as A, type StoredMessage as S, type AnthropicThreadManagerHooks as a, type AnthropicInvocationPayload as b, type AnthropicThreadManager as c, type AnthropicThreadManagerConfig as d, createAnthropicThreadManager as e };

package/dist/{thread-manager-D2xorI-J.d.ts → thread-manager-D33SUmZa.d.cts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-DKsCdAtQ.js';
-import { StoredMessage, BaseMessage, MessageContent } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-Clhqautb.js';
+import { J as JsonValue } from './types-CnuN9T6t.cjs';
+import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-oxt8GN97.cjs';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;
@@ -14,6 +14,12 @@ interface LangChainThreadManagerConfig {
     /** Thread key, defaults to 'messages' */
     key?: string;
     hooks?: LangChainThreadManagerHooks;
+    /**
+     * Override the default thread TTL (90 days). When pairing the
+     * adapter with a durable cold tier, a shorter TTL (hours) is
+     * typically more appropriate.
+     */
+    ttlSeconds?: number;
 }
 /** Prepared payload ready to send to a LangChain chat model */
 interface LangChainInvocationPayload {
@@ -31,4 +37,4 @@ interface LangChainThreadManager extends ProviderThreadManager<StoredMessage, La
  */
 declare function createLangChainThreadManager(config: LangChainThreadManagerConfig): LangChainThreadManager;
 
-export { type LangChainContent as L, type LangChainThreadManagerHooks as a, type LangChainThreadManager as b, createLangChainThreadManager as c, type LangChainThreadManagerConfig as d, type LangChainInvocationPayload as e };
+export { type LangChainContent as L, type LangChainThreadManagerHooks as a, type LangChainInvocationPayload as b, type LangChainThreadManager as c, type LangChainThreadManagerConfig as d, createLangChainThreadManager as e };

package/dist/{thread-manager-BWv6ZXI3.d.cts → thread-manager-DduoSkvJ.d.ts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-4Wmk-wRq.cjs';
-import { StoredMessage, BaseMessage, MessageContent } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-DRJt1TMi.cjs';
+import { J as JsonValue } from './types-CwN6_tAL.js';
+import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-L5bvbF-n.js';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;
@@ -14,6 +14,12 @@ interface LangChainThreadManagerConfig {
     /** Thread key, defaults to 'messages' */
     key?: string;
     hooks?: LangChainThreadManagerHooks;
+    /**
+     * Override the default thread TTL (90 days). When pairing the
+     * adapter with a durable cold tier, a shorter TTL (hours) is
+     * typically more appropriate.
+     */
+    ttlSeconds?: number;
 }
 /** Prepared payload ready to send to a LangChain chat model */
 interface LangChainInvocationPayload {
@@ -31,4 +37,4 @@ interface LangChainThreadManager extends ProviderThreadManager<StoredMessage, La
  */
 declare function createLangChainThreadManager(config: LangChainThreadManagerConfig): LangChainThreadManager;
 
-export { type LangChainContent as L, type LangChainThreadManagerHooks as a, type LangChainThreadManager as b, createLangChainThreadManager as c, type LangChainThreadManagerConfig as d, type LangChainInvocationPayload as e };
+export { type LangChainContent as L, type LangChainThreadManagerHooks as a, type LangChainInvocationPayload as b, type LangChainThreadManager as c, type LangChainThreadManagerConfig as d, createLangChainThreadManager as e };

package/dist/{types-C90VoEpt.d.cts → types-CjY93AWZ.d.cts}

@@ -1,4 +1,4 @@
-import { c as SandboxFileSystem, F as FileStat, D as DirentEntry, a as SandboxCreateOptions, b as Sandbox$1 } from './types-CJ7tCdl6.cjs';
+import { c as SandboxFileSystem, F as FileStat, D as DirentEntry, b as Sandbox$1, a as SandboxCreateOptions } from './types-CJ7tCdl6.cjs';
 import { Sandbox } from '@daytonaio/sdk';
 
 /**

package/dist/{types-4Wmk-wRq.d.cts → types-CnuN9T6t.d.cts}

@@ -1529,6 +1529,28 @@ interface ThreadOps<TContent = string> {
      * store, continue later" works regardless of exit reason.
      */
     saveThreadState(threadId: string, state: PersistedThreadState, threadKey?: string): Promise<void>;
+    /**
+     * Restore the thread's contents from the durable cold tier (if any)
+     * into Redis. Called once on session entry for `mode: "continue"`
+     * and `mode: "fork"` so the rest of the loop reads the freshest data.
+     *
+     * Adapters configured without a cold-store implementation treat this
+     * as a no-op. Implementations must be **idempotent** — Temporal
+     * retries the activity on transient failures, and a thread that is
+     * already hot must not be wiped.
+     */
+    hydrateThread(threadId: string, threadKey?: string): Promise<void>;
+    /**
+     * Archive the thread's contents to the durable cold tier and
+     * (optionally) drop the hot-tier Redis keys. Called once in the
+     * session's `finally` block on every exit path, after
+     * `saveThreadState`.
+     *
+     * Adapters configured without a cold-store implementation treat this
+     * as a no-op. Implementations must be **idempotent** — the cold
+     * tier is last-writer-wins and a retried flush must converge.
+     */
+    flushThread(threadId: string, threadKey?: string): Promise<void>;
 }
 /**
  * Composes an adapter prefix + workflow scope for activity naming.
@@ -1774,4 +1796,4 @@ interface ZeitlichSession<M = unknown, HasSandbox extends boolean = boolean> {
     }): Promise<SessionResult<M, T, HasSandbox>>;
 }
 
-export { type PostToolUseHook as $, type AgentResponse as A, type BaseAgentState as B, type ToolMap as C, type ToolNames as D, type RawToolCall as E, type FileEntryMetadata as F, type ParsedToolCall as G, type ParsedToolCallUnion as H, type ToolRouter as I, type JsonValue as J, type ToolRouterHooks as K, type ToolHandler as L, type ModelInvokerConfig as M, type ToolArgs as N, type ToolResult as O, type PersistedThreadState as P, type ToolCallResult as Q, type RouterContext as R, type ScopedPrefix as S, type ThreadOps as T, type ToolCallResultUnion as U, type VirtualFsContext as V, type InferToolResults as W, type PreToolUseHook as X, type PreToolUseHookContext as Y, type ZeitlichSession as Z, type PreToolUseHookResult as _, type ModelInvoker as a, type PostToolUseHookContext as a0, type PostToolUseFailureHook as a1, type PostToolUseFailureHookContext as a2, type PostToolUseFailureHookResult as a3, type ToolHooks as a4, type AppendToolResultFn as a5, type ProcessToolCallsContext as a6, type ProcessToolCallsResult as a7, type RewindSignal as a8, type Hooks as a9, type SubagentWorkflow as aA, type SubagentWorkflowInput as aB, type SubagentSessionInput as aC, type FileEntry as aD, type VirtualFileTree as aE, type VirtualFsOps as aF, type VirtualFsState as aG, type ToolRouterOptions as aH, type SessionStartHook as aa, type SessionStartHookContext as ab, type SessionEndHook as ac, type SessionEndHookContext as ad, type PreHumanMessageAppendHook as ae, type PreHumanMessageAppendHookContext as af, type PostHumanMessageAppendHook as ag, type PostHumanMessageAppendHookContext as ah, type TokenUsage as ai, type AgentStatus as aj, type AgentFile as ak, type AgentConfig as al, type SessionExitReason as am, type SerializableToolDefinition as an, type TaskStatus as ao, type WorkflowTask as ap, isTerminalStatus as aq, type RunAgentActivity as ar, type SubagentConfig as as, type SubagentChildWorkflowOptions as at, type SubagentDefinition as au, type SubagentFnResult as av, type SubagentHooks as aw, type SubagentHandlerResponse as ax, type SubagentSandboxConfig as ay, type SubagentContinuationCaps as az, type PrefixedThreadOps as b, type ToolHandlerResponse as c, type ActivityToolHandler as d, type ToolResultConfig as e, type RunAgentConfig as f, type SkillProvider as g, type SkillMetadata as h, type Skill as i, type FileResolver as j, type TreeMutation as k, type PrefixedVirtualFsOps as l, VirtualFileSystem as m, type SessionResult as n, type SessionConfig as o, type SessionRequiredCaps as p, type ThreadInit as q, type SandboxInit as r, type SandboxShutdown as s, type SubagentSandboxShutdown as t, type AgentState as u, type AgentStateManager as v, type JsonSerializable as w, type JsonPrimitive as x, type ToolDefinition as y, type ToolWithHandler as z };
+export { type SandboxShutdown as $, type AgentResponse as A, type BaseAgentState as B, type PostToolUseFailureHookContext as C, type PostToolUseFailureHookResult as D, type PostToolUseHook as E, type FileEntryMetadata as F, type PostToolUseHookContext as G, type Hooks as H, type InferToolResults as I, type JsonValue as J, type PreHumanMessageAppendHook as K, type PreHumanMessageAppendHookContext as L, type ModelInvokerConfig as M, type PreToolUseHook as N, type PreToolUseHookContext as O, type PersistedThreadState as P, type PreToolUseHookResult as Q, type RouterContext as R, type ScopedPrefix as S, type ThreadOps as T, type ProcessToolCallsContext as U, type VirtualFsContext as V, type ProcessToolCallsResult as W, type RawToolCall as X, type RewindSignal as Y, type RunAgentActivity as Z, type SandboxInit as _, type ModelInvoker as a, type SerializableToolDefinition as a0, type SessionConfig as a1, type SessionEndHook as a2, type SessionEndHookContext as a3, type SessionExitReason as a4, type SessionRequiredCaps as a5, type SessionResult as a6, type SessionStartHook as a7, type SessionStartHookContext as a8, type SubagentChildWorkflowOptions as a9, VirtualFileSystem as aA, type VirtualFileTree as aB, type VirtualFsOps as aC, type VirtualFsState as aD, type WorkflowTask as aE, type ZeitlichSession as aF, isTerminalStatus as aG, type ToolRouterOptions as aH, type SubagentConfig as aa, type SubagentContinuationCaps as ab, type SubagentDefinition as ac, type SubagentFnResult as ad, type SubagentHandlerResponse as ae, type SubagentHooks as af, type SubagentSandboxConfig as ag, type SubagentSandboxShutdown as ah, type SubagentSessionInput as ai, type SubagentWorkflow as aj, type SubagentWorkflowInput as ak, type TaskStatus as al, type ThreadInit as am, type TokenUsage as an, type ToolArgs as ao, type ToolCallResult as ap, type ToolCallResultUnion as aq, type ToolDefinition as ar, type ToolHandler as as, type ToolHooks as at, type ToolMap as au, type ToolNames as av, type ToolResult as aw, type ToolRouter as ax, type ToolRouterHooks as ay, type ToolWithHandler as az, type PrefixedThreadOps as b, type ToolHandlerResponse as c, type ActivityToolHandler as d, type ToolResultConfig as e, type RunAgentConfig as f, type SkillProvider as g, type SkillMetadata as h, type Skill as i, type FileResolver as j, type TreeMutation as k, type PrefixedVirtualFsOps as l, type AgentConfig as m, type AgentFile as n, type AgentState as o, type AgentStateManager as p, type AgentStatus as q, type AppendToolResultFn as r, type FileEntry as s, type JsonPrimitive as t, type JsonSerializable as u, type ParsedToolCall as v, type ParsedToolCallUnion as w, type PostHumanMessageAppendHook as x, type PostHumanMessageAppendHookContext as y, type PostToolUseFailureHook as z };

package/dist/{types-DKsCdAtQ.d.ts → types-CwN6_tAL.d.ts}

@@ -1529,6 +1529,28 @@ interface ThreadOps<TContent = string> {
      * store, continue later" works regardless of exit reason.
      */
     saveThreadState(threadId: string, state: PersistedThreadState, threadKey?: string): Promise<void>;
+    /**
+     * Restore the thread's contents from the durable cold tier (if any)
+     * into Redis. Called once on session entry for `mode: "continue"`
+     * and `mode: "fork"` so the rest of the loop reads the freshest data.
+     *
+     * Adapters configured without a cold-store implementation treat this
+     * as a no-op. Implementations must be **idempotent** — Temporal
+     * retries the activity on transient failures, and a thread that is
+     * already hot must not be wiped.
+     */
+    hydrateThread(threadId: string, threadKey?: string): Promise<void>;
+    /**
+     * Archive the thread's contents to the durable cold tier and
+     * (optionally) drop the hot-tier Redis keys. Called once in the
+     * session's `finally` block on every exit path, after
+     * `saveThreadState`.
+     *
+     * Adapters configured without a cold-store implementation treat this
+     * as a no-op. Implementations must be **idempotent** — the cold
+     * tier is last-writer-wins and a retried flush must converge.
+     */
+    flushThread(threadId: string, threadKey?: string): Promise<void>;
 }
 /**
  * Composes an adapter prefix + workflow scope for activity naming.
@@ -1774,4 +1796,4 @@ interface ZeitlichSession<M = unknown, HasSandbox extends boolean = boolean> {
     }): Promise<SessionResult<M, T, HasSandbox>>;
 }
 
-export { type PostToolUseHook as $, type AgentResponse as A, type BaseAgentState as B, type ToolMap as C, type ToolNames as D, type RawToolCall as E, type FileEntryMetadata as F, type ParsedToolCall as G, type ParsedToolCallUnion as H, type ToolRouter as I, type JsonValue as J, type ToolRouterHooks as K, type ToolHandler as L, type ModelInvokerConfig as M, type ToolArgs as N, type ToolResult as O, type PersistedThreadState as P, type ToolCallResult as Q, type RouterContext as R, type ScopedPrefix as S, type ThreadOps as T, type ToolCallResultUnion as U, type VirtualFsContext as V, type InferToolResults as W, type PreToolUseHook as X, type PreToolUseHookContext as Y, type ZeitlichSession as Z, type PreToolUseHookResult as _, type ModelInvoker as a, type PostToolUseHookContext as a0, type PostToolUseFailureHook as a1, type PostToolUseFailureHookContext as a2, type PostToolUseFailureHookResult as a3, type ToolHooks as a4, type AppendToolResultFn as a5, type ProcessToolCallsContext as a6, type ProcessToolCallsResult as a7, type RewindSignal as a8, type Hooks as a9, type SubagentWorkflow as aA, type SubagentWorkflowInput as aB, type SubagentSessionInput as aC, type FileEntry as aD, type VirtualFileTree as aE, type VirtualFsOps as aF, type VirtualFsState as aG, type ToolRouterOptions as aH, type SessionStartHook as aa, type SessionStartHookContext as ab, type SessionEndHook as ac, type SessionEndHookContext as ad, type PreHumanMessageAppendHook as ae, type PreHumanMessageAppendHookContext as af, type PostHumanMessageAppendHook as ag, type PostHumanMessageAppendHookContext as ah, type TokenUsage as ai, type AgentStatus as aj, type AgentFile as ak, type AgentConfig as al, type SessionExitReason as am, type SerializableToolDefinition as an, type TaskStatus as ao, type WorkflowTask as ap, isTerminalStatus as aq, type RunAgentActivity as ar, type SubagentConfig as as, type SubagentChildWorkflowOptions as at, type SubagentDefinition as au, type SubagentFnResult as av, type SubagentHooks as aw, type SubagentHandlerResponse as ax, type SubagentSandboxConfig as ay, type SubagentContinuationCaps as az, type PrefixedThreadOps as b, type ToolHandlerResponse as c, type ActivityToolHandler as d, type ToolResultConfig as e, type RunAgentConfig as f, type SkillProvider as g, type SkillMetadata as h, type Skill as i, type FileResolver as j, type TreeMutation as k, type PrefixedVirtualFsOps as l, VirtualFileSystem as m, type SessionResult as n, type SessionConfig as o, type SessionRequiredCaps as p, type ThreadInit as q, type SandboxInit as r, type SandboxShutdown as s, type SubagentSandboxShutdown as t, type AgentState as u, type AgentStateManager as v, type JsonSerializable as w, type JsonPrimitive as x, type ToolDefinition as y, type ToolWithHandler as z };
+export { type SandboxShutdown as $, type AgentResponse as A, type BaseAgentState as B, type PostToolUseFailureHookContext as C, type PostToolUseFailureHookResult as D, type PostToolUseHook as E, type FileEntryMetadata as F, type PostToolUseHookContext as G, type Hooks as H, type InferToolResults as I, type JsonValue as J, type PreHumanMessageAppendHook as K, type PreHumanMessageAppendHookContext as L, type ModelInvokerConfig as M, type PreToolUseHook as N, type PreToolUseHookContext as O, type PersistedThreadState as P, type PreToolUseHookResult as Q, type RouterContext as R, type ScopedPrefix as S, type ThreadOps as T, type ProcessToolCallsContext as U, type VirtualFsContext as V, type ProcessToolCallsResult as W, type RawToolCall as X, type RewindSignal as Y, type RunAgentActivity as Z, type SandboxInit as _, type ModelInvoker as a, type SerializableToolDefinition as a0, type SessionConfig as a1, type SessionEndHook as a2, type SessionEndHookContext as a3, type SessionExitReason as a4, type SessionRequiredCaps as a5, type SessionResult as a6, type SessionStartHook as a7, type SessionStartHookContext as a8, type SubagentChildWorkflowOptions as a9, VirtualFileSystem as aA, type VirtualFileTree as aB, type VirtualFsOps as aC, type VirtualFsState as aD, type WorkflowTask as aE, type ZeitlichSession as aF, isTerminalStatus as aG, type ToolRouterOptions as aH, type SubagentConfig as aa, type SubagentContinuationCaps as ab, type SubagentDefinition as ac, type SubagentFnResult as ad, type SubagentHandlerResponse as ae, type SubagentHooks as af, type SubagentSandboxConfig as ag, type SubagentSandboxShutdown as ah, type SubagentSessionInput as ai, type SubagentWorkflow as aj, type SubagentWorkflowInput as ak, type TaskStatus as al, type ThreadInit as am, type TokenUsage as an, type ToolArgs as ao, type ToolCallResult as ap, type ToolCallResultUnion as aq, type ToolDefinition as ar, type ToolHandler as as, type ToolHooks as at, type ToolMap as au, type ToolNames as av, type ToolResult as aw, type ToolRouter as ax, type ToolRouterHooks as ay, type ToolWithHandler as az, type PrefixedThreadOps as b, type ToolHandlerResponse as c, type ActivityToolHandler as d, type ToolResultConfig as e, type RunAgentConfig as f, type SkillProvider as g, type SkillMetadata as h, type Skill as i, type FileResolver as j, type TreeMutation as k, type PrefixedVirtualFsOps as l, type AgentConfig as m, type AgentFile as n, type AgentState as o, type AgentStateManager as p, type AgentStatus as q, type AppendToolResultFn as r, type FileEntry as s, type JsonPrimitive as t, type JsonSerializable as u, type ParsedToolCall as v, type ParsedToolCallUnion as w, type PostHumanMessageAppendHook as x, type PostHumanMessageAppendHookContext as y, type PostToolUseFailureHook as z };

package/dist/{types-Clhqautb.d.ts → types-L5bvbF-n.d.ts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { P as PersistedThreadState, J as JsonValue } from './types-DKsCdAtQ.js';
+import { P as PersistedThreadState, J as JsonValue } from './types-CwN6_tAL.js';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;
@@ -15,6 +15,17 @@ interface ThreadManagerConfig<T> {
      * When provided, `append` uses an atomic Lua script to skip duplicate writes.
      */
     idOf?: (message: T) => string;
+    /**
+     * TTL (in seconds) applied to every Redis key the manager writes
+     * (the list, the meta marker, the state slice, and dedup markers).
+     *
+     * Defaults to {@link THREAD_TTL_SECONDS} (90 days) for back-compat.
+     * When the consumer pairs the thread manager with a durable cold
+     * tier (see `createTieredThreadManager`), a much shorter TTL — e.g.
+     * a few hours — is usually more appropriate since the cold tier is
+     * the source of truth and Redis is just a hot cache.
+     */
+    ttlSeconds?: number;
 }
 /** Generic thread manager for any message type */
 interface BaseThreadManager<T> {
@@ -26,6 +37,11 @@ interface BaseThreadManager<T> {
      * Append messages to the thread.
      * When `idOf` is configured, appends are idempotent — retries with the
      * same message ids are atomically skipped via a Redis Lua script.
+     *
+     * Caveat with tiered storage: multi-message batches write one composite
+     * dedup key (`"m1:m2"`); snapshots only persist per-message keys, so a
+     * batch retried after `flush` → `hydrate` will not be deduped. Adapter
+     * helpers all single-append and are unaffected.
      */
     append(messages: T[]): Promise<void>;
     /**

package/dist/{types-DpFD8ofR.d.ts → types-gVa5XCWD.d.ts}

@@ -1,4 +1,4 @@
-import { c as SandboxFileSystem, F as FileStat, D as DirentEntry, a as SandboxCreateOptions, b as Sandbox$1 } from './types-CJ7tCdl6.js';
+import { c as SandboxFileSystem, F as FileStat, D as DirentEntry, b as Sandbox$1, a as SandboxCreateOptions } from './types-CJ7tCdl6.js';
 import { Sandbox } from '@daytonaio/sdk';
 
 /**

package/dist/{types-DRJt1TMi.d.cts → types-oxt8GN97.d.cts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { P as PersistedThreadState, J as JsonValue } from './types-4Wmk-wRq.cjs';
+import { P as PersistedThreadState, J as JsonValue } from './types-CnuN9T6t.cjs';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;
@@ -15,6 +15,17 @@ interface ThreadManagerConfig<T> {
      * When provided, `append` uses an atomic Lua script to skip duplicate writes.
      */
     idOf?: (message: T) => string;
+    /**
+     * TTL (in seconds) applied to every Redis key the manager writes
+     * (the list, the meta marker, the state slice, and dedup markers).
+     *
+     * Defaults to {@link THREAD_TTL_SECONDS} (90 days) for back-compat.
+     * When the consumer pairs the thread manager with a durable cold
+     * tier (see `createTieredThreadManager`), a much shorter TTL — e.g.
+     * a few hours — is usually more appropriate since the cold tier is
+     * the source of truth and Redis is just a hot cache.
+     */
+    ttlSeconds?: number;
 }
 /** Generic thread manager for any message type */
 interface BaseThreadManager<T> {
@@ -26,6 +37,11 @@ interface BaseThreadManager<T> {
      * Append messages to the thread.
      * When `idOf` is configured, appends are idempotent — retries with the
      * same message ids are atomically skipped via a Redis Lua script.
+     *
+     * Caveat with tiered storage: multi-message batches write one composite
+     * dedup key (`"m1:m2"`); snapshots only persist per-message keys, so a
+     * batch retried after `flush` → `hydrate` will not be deduped. Adapter
+     * helpers all single-append and are unaffected.
      */
     append(messages: T[]): Promise<void>;
     /**

package/dist/{workflow-D32TRMr-.d.ts → workflow-B1TOcHbt.d.ts}

@@ -1,4 +1,4 @@
-import { C as ToolMap, r as SandboxInit, t as SubagentSandboxShutdown, o as SessionConfig, Z as ZeitlichSession, s as SandboxShutdown, q as ThreadInit, w as JsonSerializable, B as BaseAgentState, v as AgentStateManager, aH as ToolRouterOptions, I as ToolRouter, H as ParsedToolCallUnion, D as ToolNames, R as RouterContext, J as JsonValue, z as ToolWithHandler, au as SubagentDefinition, aw as SubagentHooks, ay as SubagentSandboxConfig, as as SubagentConfig, aC as SubagentSessionInput, av as SubagentFnResult, aa as SessionStartHook, ac as SessionEndHook, $ as PostToolUseHook, a1 as PostToolUseFailureHook, am as SessionExitReason, ai as TokenUsage, f as RunAgentConfig, A as AgentResponse, F as FileEntryMetadata, aE as VirtualFileTree, k as TreeMutation, aD as FileEntry, aF as VirtualFsOps, h as SkillMetadata, i as Skill, c as ToolHandlerResponse, L as ToolHandler, ap as WorkflowTask, d as ActivityToolHandler } from './types-DKsCdAtQ.js';
+import { au as ToolMap, _ as SandboxInit, ah as SubagentSandboxShutdown, a1 as SessionConfig, aF as ZeitlichSession, $ as SandboxShutdown, am as ThreadInit, u as JsonSerializable, B as BaseAgentState, p as AgentStateManager, aH as ToolRouterOptions, ax as ToolRouter, R as RouterContext, J as JsonValue, az as ToolWithHandler, w as ParsedToolCallUnion, av as ToolNames, ac as SubagentDefinition, af as SubagentHooks, ag as SubagentSandboxConfig, aa as SubagentConfig, ai as SubagentSessionInput, ad as SubagentFnResult, a7 as SessionStartHook, a2 as SessionEndHook, E as PostToolUseHook, z as PostToolUseFailureHook, a4 as SessionExitReason, an as TokenUsage, f as RunAgentConfig, A as AgentResponse, F as FileEntryMetadata, aB as VirtualFileTree, k as TreeMutation, s as FileEntry, aC as VirtualFsOps, h as SkillMetadata, i as Skill, c as ToolHandlerResponse, as as ToolHandler, aE as WorkflowTask, d as ActivityToolHandler } from './types-CwN6_tAL.js';
 import z$1, { z } from 'zod';
 import './types-CJ7tCdl6.js';
 import { Duration } from '@temporalio/common';
@@ -159,6 +159,37 @@ declare function getThreadListKey(threadKey: string, threadId: string): string;
  * @param threadId  - Thread id as provided to the thread manager.
  */
 declare function getThreadMetaKey(threadKey: string, threadId: string): string;
+/**
+ * Build the Redis key that stores a thread's persisted state slice
+ * (tasks + custom state) written by zeitlich's session loop on every
+ * exit path.
+ *
+ * Consumers can read this key with `redis.get(getThreadStateKey(key, id))`
+ * and `JSON.parse` the result into a {@link PersistedThreadState}.
+ *
+ * @param threadKey - Thread key (defaults to `"messages"` inside the
+ *                    thread manager, but downstream adapters may pass
+ *                    their own value).
+ * @param threadId  - Thread id as provided to the thread manager.
+ */
+declare function getThreadStateKey(threadKey: string, threadId: string): string;
+/**
+ * Build the Redis key that guards an idempotent append against a
+ * duplicate write of the message (or message batch) identified by
+ * `dedupId`. Zeitlich's thread manager writes one of these per
+ * single-message append (and one per batch for multi-message appends),
+ * keyed by the message id returned by the configured `idOf`.
+ *
+ * Note: the key layout intentionally does **not** include the
+ * `threadKey` prefix — the dedup namespace is shared across thread
+ * keys for a given `threadId`, mirroring the original internal
+ * implementation.
+ *
+ * @param threadId - Thread id as provided to the thread manager.
+ * @param dedupId  - Joined message ids (single message id for the
+ *                   common single-append case).
+ */
+declare function getThreadDedupKey(threadId: string, dedupId: string): string;
 
 /**
  * Creates an agent state manager for tracking workflow state.
@@ -856,4 +887,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { createTaskGetHandler as $, hasDirectory as A, type BashArgs as B, proxyVirtualFsOps as C, DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT as D, type SubagentArgs as E, type FileEditArgs as F, type GlobArgs as G, parseSkillFile as H, createReadSkillTool as I, createReadSkillHandler as J, globTool as K, grepTool as L, type GrepArgs as M, readFileTool as N, type ObservabilityHooks as O, writeFileTool as P, editTool as Q, type ReadSkillArgs as R, type SessionStartedEvent as S, THREAD_TTL_SECONDS as T, taskCreateTool as U, type TaskCreateArgs as V, type WorkflowConfig as W, createTaskCreateHandler as X, taskGetTool as Y, type ZeitlichObservabilitySinks as Z, type TaskGetArgs as _, type FileReadArgs as a, taskListTool as a0, type TaskListArgs as a1, createTaskListHandler as a2, taskUpdateTool as a3, type TaskUpdateArgs as a4, createTaskUpdateHandler as a5, bashTool as a6, createBashToolDescription as a7, askUserQuestionTool as a8, type AskUserQuestionArgs as a9, createAskUserQuestionHandler as aa, type FileWriteArgs as b, type FileTreeAccessor as c, createSession as d, defineWorkflow as e, type WorkflowInput as f, type WorkflowSessionInput as g, getShortId as h, getThreadListKey as i, getThreadMetaKey as j, createAgentStateManager as k, createToolRouter as l, hasNoOtherToolCalls as m, defineTool as n, defineSubagent as o, defineSubagentWorkflow as p, createObservabilityHooks as q, composeHooks as r, type SessionEndedEvent as s, type TurnCompletedEvent as t, type ToolExecutedEvent as u, proxyRunAgent as v, applyVirtualTreeMutations as w, formatVirtualFileTree as x, hasFileWithMimeType as y, filesWithMimeType as z };
+export { globTool as $, type AskUserQuestionArgs as A, type BashArgs as B, createTaskGetHandler as C, DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT as D, createTaskListHandler as E, type FileEditArgs as F, type GlobArgs as G, createTaskUpdateHandler as H, createToolRouter as I, defineSubagent as J, defineSubagentWorkflow as K, defineTool as L, defineWorkflow as M, editTool as N, type ObservabilityHooks as O, filesWithMimeType as P, formatVirtualFileTree as Q, type ReadSkillArgs as R, type SessionEndedEvent as S, THREAD_TTL_SECONDS as T, getShortId as U, getThreadDedupKey as V, type WorkflowConfig as W, getThreadListKey as X, getThreadMetaKey as Y, type ZeitlichObservabilitySinks as Z, getThreadStateKey as _, type FileReadArgs as a, grepTool as a0, hasDirectory as a1, hasFileWithMimeType as a2, hasNoOtherToolCalls as a3, parseSkillFile as a4, proxyRunAgent as a5, proxyVirtualFsOps as a6, readFileTool as a7, taskCreateTool as a8, taskGetTool as a9, taskListTool as aa, taskUpdateTool as ab, writeFileTool as ac, type FileWriteArgs as b, type FileTreeAccessor as c, type GrepArgs as d, type SessionStartedEvent as e, type SubagentArgs as f, type TaskCreateArgs as g, type TaskGetArgs as h, type TaskListArgs as i, type TaskUpdateArgs as j, type ToolExecutedEvent as k, type TurnCompletedEvent as l, type WorkflowInput as m, type WorkflowSessionInput as n, applyVirtualTreeMutations as o, askUserQuestionTool as p, bashTool as q, composeHooks as r, createAgentStateManager as s, createAskUserQuestionHandler as t, createBashToolDescription as u, createObservabilityHooks as v, createReadSkillHandler as w, createReadSkillTool as x, createSession as y, createTaskCreateHandler as z };

package/dist/{workflow-XVt0ww8K.d.cts → workflow-DIaIV7L2.d.cts}

@@ -1,4 +1,4 @@
-import { C as ToolMap, r as SandboxInit, t as SubagentSandboxShutdown, o as SessionConfig, Z as ZeitlichSession, s as SandboxShutdown, q as ThreadInit, w as JsonSerializable, B as BaseAgentState, v as AgentStateManager, aH as ToolRouterOptions, I as ToolRouter, H as ParsedToolCallUnion, D as ToolNames, R as RouterContext, J as JsonValue, z as ToolWithHandler, au as SubagentDefinition, aw as SubagentHooks, ay as SubagentSandboxConfig, as as SubagentConfig, aC as SubagentSessionInput, av as SubagentFnResult, aa as SessionStartHook, ac as SessionEndHook, $ as PostToolUseHook, a1 as PostToolUseFailureHook, am as SessionExitReason, ai as TokenUsage, f as RunAgentConfig, A as AgentResponse, F as FileEntryMetadata, aE as VirtualFileTree, k as TreeMutation, aD as FileEntry, aF as VirtualFsOps, h as SkillMetadata, i as Skill, c as ToolHandlerResponse, L as ToolHandler, ap as WorkflowTask, d as ActivityToolHandler } from './types-4Wmk-wRq.cjs';
+import { au as ToolMap, _ as SandboxInit, ah as SubagentSandboxShutdown, a1 as SessionConfig, aF as ZeitlichSession, $ as SandboxShutdown, am as ThreadInit, u as JsonSerializable, B as BaseAgentState, p as AgentStateManager, aH as ToolRouterOptions, ax as ToolRouter, R as RouterContext, J as JsonValue, az as ToolWithHandler, w as ParsedToolCallUnion, av as ToolNames, ac as SubagentDefinition, af as SubagentHooks, ag as SubagentSandboxConfig, aa as SubagentConfig, ai as SubagentSessionInput, ad as SubagentFnResult, a7 as SessionStartHook, a2 as SessionEndHook, E as PostToolUseHook, z as PostToolUseFailureHook, a4 as SessionExitReason, an as TokenUsage, f as RunAgentConfig, A as AgentResponse, F as FileEntryMetadata, aB as VirtualFileTree, k as TreeMutation, s as FileEntry, aC as VirtualFsOps, h as SkillMetadata, i as Skill, c as ToolHandlerResponse, as as ToolHandler, aE as WorkflowTask, d as ActivityToolHandler } from './types-CnuN9T6t.cjs';
 import z$1, { z } from 'zod';
 import './types-CJ7tCdl6.cjs';
 import { Duration } from '@temporalio/common';
@@ -159,6 +159,37 @@ declare function getThreadListKey(threadKey: string, threadId: string): string;
  * @param threadId  - Thread id as provided to the thread manager.
  */
 declare function getThreadMetaKey(threadKey: string, threadId: string): string;
+/**
+ * Build the Redis key that stores a thread's persisted state slice
+ * (tasks + custom state) written by zeitlich's session loop on every
+ * exit path.
+ *
+ * Consumers can read this key with `redis.get(getThreadStateKey(key, id))`
+ * and `JSON.parse` the result into a {@link PersistedThreadState}.
+ *
+ * @param threadKey - Thread key (defaults to `"messages"` inside the
+ *                    thread manager, but downstream adapters may pass
+ *                    their own value).
+ * @param threadId  - Thread id as provided to the thread manager.
+ */
+declare function getThreadStateKey(threadKey: string, threadId: string): string;
+/**
+ * Build the Redis key that guards an idempotent append against a
+ * duplicate write of the message (or message batch) identified by
+ * `dedupId`. Zeitlich's thread manager writes one of these per
+ * single-message append (and one per batch for multi-message appends),
+ * keyed by the message id returned by the configured `idOf`.
+ *
+ * Note: the key layout intentionally does **not** include the
+ * `threadKey` prefix — the dedup namespace is shared across thread
+ * keys for a given `threadId`, mirroring the original internal
+ * implementation.
+ *
+ * @param threadId - Thread id as provided to the thread manager.
+ * @param dedupId  - Joined message ids (single message id for the
+ *                   common single-append case).
+ */
+declare function getThreadDedupKey(threadId: string, dedupId: string): string;
 
 /**
  * Creates an agent state manager for tracking workflow state.
@@ -856,4 +887,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { createTaskGetHandler as $, hasDirectory as A, type BashArgs as B, proxyVirtualFsOps as C, DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT as D, type SubagentArgs as E, type FileEditArgs as F, type GlobArgs as G, parseSkillFile as H, createReadSkillTool as I, createReadSkillHandler as J, globTool as K, grepTool as L, type GrepArgs as M, readFileTool as N, type ObservabilityHooks as O, writeFileTool as P, editTool as Q, type ReadSkillArgs as R, type SessionStartedEvent as S, THREAD_TTL_SECONDS as T, taskCreateTool as U, type TaskCreateArgs as V, type WorkflowConfig as W, createTaskCreateHandler as X, taskGetTool as Y, type ZeitlichObservabilitySinks as Z, type TaskGetArgs as _, type FileReadArgs as a, taskListTool as a0, type TaskListArgs as a1, createTaskListHandler as a2, taskUpdateTool as a3, type TaskUpdateArgs as a4, createTaskUpdateHandler as a5, bashTool as a6, createBashToolDescription as a7, askUserQuestionTool as a8, type AskUserQuestionArgs as a9, createAskUserQuestionHandler as aa, type FileWriteArgs as b, type FileTreeAccessor as c, createSession as d, defineWorkflow as e, type WorkflowInput as f, type WorkflowSessionInput as g, getShortId as h, getThreadListKey as i, getThreadMetaKey as j, createAgentStateManager as k, createToolRouter as l, hasNoOtherToolCalls as m, defineTool as n, defineSubagent as o, defineSubagentWorkflow as p, createObservabilityHooks as q, composeHooks as r, type SessionEndedEvent as s, type TurnCompletedEvent as t, type ToolExecutedEvent as u, proxyRunAgent as v, applyVirtualTreeMutations as w, formatVirtualFileTree as x, hasFileWithMimeType as y, filesWithMimeType as z };
+export { globTool as $, type AskUserQuestionArgs as A, type BashArgs as B, createTaskGetHandler as C, DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT as D, createTaskListHandler as E, type FileEditArgs as F, type GlobArgs as G, createTaskUpdateHandler as H, createToolRouter as I, defineSubagent as J, defineSubagentWorkflow as K, defineTool as L, defineWorkflow as M, editTool as N, type ObservabilityHooks as O, filesWithMimeType as P, formatVirtualFileTree as Q, type ReadSkillArgs as R, type SessionEndedEvent as S, THREAD_TTL_SECONDS as T, getShortId as U, getThreadDedupKey as V, type WorkflowConfig as W, getThreadListKey as X, getThreadMetaKey as Y, type ZeitlichObservabilitySinks as Z, getThreadStateKey as _, type FileReadArgs as a, grepTool as a0, hasDirectory as a1, hasFileWithMimeType as a2, hasNoOtherToolCalls as a3, parseSkillFile as a4, proxyRunAgent as a5, proxyVirtualFsOps as a6, readFileTool as a7, taskCreateTool as a8, taskGetTool as a9, taskListTool as aa, taskUpdateTool as ab, writeFileTool as ac, type FileWriteArgs as b, type FileTreeAccessor as c, type GrepArgs as d, type SessionStartedEvent as e, type SubagentArgs as f, type TaskCreateArgs as g, type TaskGetArgs as h, type TaskListArgs as i, type TaskUpdateArgs as j, type ToolExecutedEvent as k, type TurnCompletedEvent as l, type WorkflowInput as m, type WorkflowSessionInput as n, applyVirtualTreeMutations as o, askUserQuestionTool as p, bashTool as q, composeHooks as r, createAgentStateManager as s, createAskUserQuestionHandler as t, createBashToolDescription as u, createObservabilityHooks as v, createReadSkillHandler as w, createReadSkillTool as x, createSession as y, createTaskCreateHandler as z };

package/dist/workflow.cjs

@@ -1034,7 +1034,9 @@ async function createSession(config) {
     appendAgentMessage,
     forkThread,
     loadThreadState,
-    saveThreadState
+    saveThreadState,
+    hydrateThread,
+    flushThread
   } = threadOps;
   const plugins = [];
   let destroySubagentSandboxes;
@@ -1094,10 +1096,7 @@ async function createSession(config) {
           stateManager.run();
         }
       );
-      const lifecycle = resolveSessionLifecycle(
-        sandboxInit,
-        sandboxShutdown
-      );
+      const lifecycle = resolveSessionLifecycle(sandboxInit, sandboxShutdown);
       const sandboxMode = lifecycle.mode;
       const resolvedShutdown = lifecycle.shutdown;
       let sandboxId;
@@ -1172,20 +1171,6 @@ async function createSession(config) {
           ...baseSnapshot && { baseSnapshot }
         });
       }
-      if (hooks.onSessionStart) {
-        await hooks.onSessionStart({
-          threadId,
-          agentName,
-          metadata
-        });
-      }
-      workflow.log.info("session started", {
-        agentName,
-        threadId,
-        threadMode,
-        maxTurns,
-        ...sandboxId && { sandboxId }
-      });
       const sessionStartMs = Date.now();
       const systemPrompt = stateManager.getSystemPrompt();
       const rehydrateFromSlice = (slice) => {
@@ -1195,10 +1180,12 @@ async function createSession(config) {
         });
       };
       if (threadMode === "fork" && sourceThreadId) {
+        await hydrateThread(sourceThreadId, threadKey);
         await forkThread(sourceThreadId, threadId, threadKey);
         const forkedSlice = await loadThreadState(threadId, threadKey);
         if (forkedSlice) rehydrateFromSlice(forkedSlice);
       } else if (threadMode === "continue") {
+        await hydrateThread(threadId, threadKey);
         const continuedSlice = await loadThreadState(threadId, threadKey);
         if (continuedSlice) rehydrateFromSlice(continuedSlice);
       } else {
@@ -1258,6 +1245,20 @@ async function createSession(config) {
       );
       let exitReason = "completed";
       let finalMessage = null;
+      if (hooks.onSessionStart) {
+        await hooks.onSessionStart({
+          threadId,
+          agentName,
+          metadata
+        });
+      }
+      workflow.log.info("session started", {
+        agentName,
+        threadId,
+        threadMode,
+        maxTurns,
+        ...sandboxId && { sandboxId }
+      });
       try {
         let assistantId;
         while (stateManager.isRunning() && !stateManager.isTerminal() && stateManager.getTurns() < maxTurns) {
@@ -1366,6 +1367,15 @@ async function createSession(config) {
             error: persistError instanceof Error ? persistError.message : String(persistError)
           });
         }
+        try {
+          await flushThread(threadId, threadKey);
+        } catch (flushError) {
+          workflow.log.warn("failed to flush thread to cold tier", {
+            agentName,
+            threadId,
+            error: flushError instanceof Error ? flushError.message : String(flushError)
+          });
+        }
         await callSessionEnd(exitReason, stateManager.getTurns());
         if (sandboxOwned && sandboxId && sandboxOps) {
           switch (resolvedShutdown) {