zeitlich 0.2.45 → 0.2.47

package/dist/proxy-CDh3Rsa7.d.cts

@@ -0,0 +1,40 @@
+import { ActivityOptions, ActivityInterfaceFor } from '@temporalio/workflow';
+import { T as ThreadOps } from './types-DNEl5uxQ.cjs';
+
+/**
+ * Shared proxy helper for thread operations.
+ *
+ * Each adapter re-exports a thin wrapper that supplies its prefix and
+ * casts the return type to carry the adapter's native content type.
+ */
+
+type OpName = keyof ThreadOps;
+/**
+ * `perOp[op]` layers shallow-rightmost over `defaults` and the
+ * built-in cold-tier overlay (`hydrateThread` / `flushThread`).
+ * A bare {@link ActivityOptions} is also accepted (treated as `{ defaults }`).
+ *
+ * @example
+ * ```typescript
+ * proxyAnthropicThreadOps(undefined, {
+ *   defaults: { startToCloseTimeout: "5s" },
+ *   perOp: {
+ *     flushThread: { startToCloseTimeout: "180s" }, // heartbeatTimeout still inherited
+ *   },
+ * });
+ * ```
+ */
+interface ThreadOpsProxyOptions {
+    defaults?: ActivityOptions;
+    perOp?: Partial<Record<OpName, ActivityOptions>>;
+}
+/**
+ * Creates a workflow-safe Temporal activity proxy for {@link ThreadOps}.
+ *
+ * @param adapterPrefix - Adapter identifier (e.g. "anthropic", "googleGenAI", "langChain")
+ * @param scope - Workflow scope. Defaults to `workflowInfo().workflowType`.
+ * @param options - {@link ThreadOpsProxyOptions} or a bare {@link ActivityOptions}.
+ */
+declare function createThreadOpsProxy(adapterPrefix: string, scope?: string, options?: ActivityOptions | ThreadOpsProxyOptions): ActivityInterfaceFor<ThreadOps>;
+
+export { type ThreadOpsProxyOptions as T, createThreadOpsProxy as c };

package/dist/proxy-Du8ggERu.d.ts

@@ -0,0 +1,40 @@
+import { ActivityOptions, ActivityInterfaceFor } from '@temporalio/workflow';
+import { T as ThreadOps } from './types-qQVZfhoT.js';
+
+/**
+ * Shared proxy helper for thread operations.
+ *
+ * Each adapter re-exports a thin wrapper that supplies its prefix and
+ * casts the return type to carry the adapter's native content type.
+ */
+
+type OpName = keyof ThreadOps;
+/**
+ * `perOp[op]` layers shallow-rightmost over `defaults` and the
+ * built-in cold-tier overlay (`hydrateThread` / `flushThread`).
+ * A bare {@link ActivityOptions} is also accepted (treated as `{ defaults }`).
+ *
+ * @example
+ * ```typescript
+ * proxyAnthropicThreadOps(undefined, {
+ *   defaults: { startToCloseTimeout: "5s" },
+ *   perOp: {
+ *     flushThread: { startToCloseTimeout: "180s" }, // heartbeatTimeout still inherited
+ *   },
+ * });
+ * ```
+ */
+interface ThreadOpsProxyOptions {
+    defaults?: ActivityOptions;
+    perOp?: Partial<Record<OpName, ActivityOptions>>;
+}
+/**
+ * Creates a workflow-safe Temporal activity proxy for {@link ThreadOps}.
+ *
+ * @param adapterPrefix - Adapter identifier (e.g. "anthropic", "googleGenAI", "langChain")
+ * @param scope - Workflow scope. Defaults to `workflowInfo().workflowType`.
+ * @param options - {@link ThreadOpsProxyOptions} or a bare {@link ActivityOptions}.
+ */
+declare function createThreadOpsProxy(adapterPrefix: string, scope?: string, options?: ActivityOptions | ThreadOpsProxyOptions): ActivityInterfaceFor<ThreadOps>;
+
+export { type ThreadOpsProxyOptions as T, createThreadOpsProxy as c };

package/dist/{thread-manager-wRVVBFgj.d.cts → thread-manager-BjoYYXgd.d.cts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-CdALEF3z.cjs';
+import { J as JsonValue } from './types-DNEl5uxQ.cjs';
 import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-C66-BVBr.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BMJrsHo0.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 {

package/dist/{thread-manager-BsLO3Fgc.d.cts → thread-manager-D8zKNFZ9.d.cts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { J as JsonValue } from './types-CdALEF3z.cjs';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-C66-BVBr.cjs';
+import { J as JsonValue } from './types-DNEl5uxQ.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BMJrsHo0.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 {

package/dist/{thread-manager-Bi1XlbpJ.d.ts → thread-manager-DtHYws2F.d.ts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { J as JsonValue } from './types-ChAy_jSP.js';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BkX4HLzi.js';
+import { J as JsonValue } from './types-qQVZfhoT.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-CtdOquo3.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 {

package/dist/{thread-manager-BhkOyQ1I.d.ts → thread-manager-Dw96FKH1.d.ts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-ChAy_jSP.js';
+import { J as JsonValue } from './types-qQVZfhoT.js';
 import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-BkX4HLzi.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-CtdOquo3.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 {

package/dist/{types-C66-BVBr.d.cts → types-BMJrsHo0.d.cts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { P as PersistedThreadState, J as JsonValue } from './types-CdALEF3z.cjs';
+import { P as PersistedThreadState, J as JsonValue } from './types-DNEl5uxQ.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/{types-BkX4HLzi.d.ts → types-CtdOquo3.d.ts}

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { P as PersistedThreadState, J as JsonValue } from './types-ChAy_jSP.js';
+import { P as PersistedThreadState, J as JsonValue } from './types-qQVZfhoT.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-CdALEF3z.d.cts → types-DNEl5uxQ.d.cts}

@@ -1283,6 +1283,22 @@ interface SubagentConfig<TResult extends z.ZodType = z.ZodType> {
      *   directly to the existing thread in-place.
      */
     thread?: "new" | "fork" | "continue";
+    /**
+     * Where the subagent's thread comes from when the parent's tool call
+     * omits `threadId`. Only meaningful in combination with
+     * `thread: "fork"` or `"continue"`.
+     *
+     * - `"new"` (default) — start a fresh thread (the prior behavior).
+     * - `"from-parent"` — use the parent's own `threadId` (from
+     *   `RouterContext`). With `thread: "fork"` the parent's conversation
+     *   is copied into a new thread; with `thread: "continue"` the
+     *   subagent appends to the parent's thread in-place.
+     *
+     * Has no effect when `thread` is `"new"` (or omitted). A `threadId`
+     * supplied by the parent agent always wins — `newThreadSource` only
+     * applies when none is provided.
+     */
+    newThreadSource?: "new" | "from-parent";
     /**
      * Sandbox strategy for this subagent.
      *
@@ -1529,6 +1545,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.

package/dist/{types-ChAy_jSP.d.ts → types-qQVZfhoT.d.ts}

@@ -1283,6 +1283,22 @@ interface SubagentConfig<TResult extends z.ZodType = z.ZodType> {
      *   directly to the existing thread in-place.
      */
     thread?: "new" | "fork" | "continue";
+    /**
+     * Where the subagent's thread comes from when the parent's tool call
+     * omits `threadId`. Only meaningful in combination with
+     * `thread: "fork"` or `"continue"`.
+     *
+     * - `"new"` (default) — start a fresh thread (the prior behavior).
+     * - `"from-parent"` — use the parent's own `threadId` (from
+     *   `RouterContext`). With `thread: "fork"` the parent's conversation
+     *   is copied into a new thread; with `thread: "continue"` the
+     *   subagent appends to the parent's thread in-place.
+     *
+     * Has no effect when `thread` is `"new"` (or omitted). A `threadId`
+     * supplied by the parent agent always wins — `newThreadSource` only
+     * applies when none is provided.
+     */
+    newThreadSource?: "new" | "from-parent";
     /**
      * Sandbox strategy for this subagent.
      *
@@ -1529,6 +1545,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.

package/dist/{workflow-DMmiaw6w.d.cts → workflow-BH9ImDGq.d.cts}

@@ -1,4 +1,4 @@
-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-CdALEF3z.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-DNEl5uxQ.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.
@@ -304,6 +335,7 @@ declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext
     enabled?: boolean | (() => boolean);
     taskQueue?: string;
     thread?: "new" | "fork" | "continue";
+    newThreadSource?: "new" | "from-parent";
     sandbox?: SubagentSandboxConfig;
 }): SubagentConfig<TResult>;
 
@@ -709,6 +741,20 @@ declare const editTool: {
     strict: true;
 };
 type FileEditArgs = z.infer<typeof editTool.schema>;
+declare const multiEditTool: {
+    name: "FileMultiEdit";
+    description: string;
+    schema: z.ZodObject<{
+        file_path: z.ZodString;
+        edits: z.ZodArray<z.ZodObject<{
+            old_string: z.ZodString;
+            new_string: z.ZodString;
+            replace_all: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    strict: true;
+};
+type FileMultiEditArgs = z.infer<typeof multiEditTool.schema>;
 
 declare const taskCreateTool: {
     name: "TaskCreate";
@@ -856,4 +902,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { hasDirectory 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, getThreadListKey as V, type WorkflowConfig as W, getThreadMetaKey as X, globTool as Y, type ZeitlichObservabilitySinks as Z, grepTool as _, type FileReadArgs as a, hasFileWithMimeType as a0, hasNoOtherToolCalls as a1, parseSkillFile as a2, proxyRunAgent as a3, proxyVirtualFsOps as a4, readFileTool as a5, taskCreateTool as a6, taskGetTool as a7, taskListTool as a8, taskUpdateTool as a9, writeFileTool as aa, 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 };
+export { getThreadStateKey as $, type AskUserQuestionArgs as A, type BashArgs as B, createTaskCreateHandler as C, DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT as D, createTaskGetHandler as E, type FileEditArgs as F, type GlobArgs as G, createTaskListHandler as H, createTaskUpdateHandler as I, createToolRouter as J, defineSubagent as K, defineSubagentWorkflow as L, defineTool as M, defineWorkflow as N, type ObservabilityHooks as O, editTool as P, filesWithMimeType as Q, type ReadSkillArgs as R, type SessionEndedEvent as S, THREAD_TTL_SECONDS as T, formatVirtualFileTree as U, getShortId as V, type WorkflowConfig as W, getThreadDedupKey as X, getThreadListKey as Y, type ZeitlichObservabilitySinks as Z, getThreadMetaKey as _, type FileMultiEditArgs as a, globTool as a0, grepTool as a1, hasDirectory as a2, hasFileWithMimeType as a3, hasNoOtherToolCalls as a4, multiEditTool as a5, parseSkillFile as a6, proxyRunAgent as a7, proxyVirtualFsOps as a8, readFileTool as a9, taskCreateTool as aa, taskGetTool as ab, taskListTool as ac, taskUpdateTool as ad, writeFileTool as ae, type FileReadArgs as b, type FileWriteArgs as c, type FileTreeAccessor as d, type GrepArgs as e, type SessionStartedEvent as f, type SubagentArgs as g, type TaskCreateArgs as h, type TaskGetArgs as i, type TaskListArgs as j, type TaskUpdateArgs as k, type ToolExecutedEvent as l, type TurnCompletedEvent as m, type WorkflowInput as n, type WorkflowSessionInput as o, applyVirtualTreeMutations as p, askUserQuestionTool as q, bashTool as r, composeHooks as s, createAgentStateManager as t, createAskUserQuestionHandler as u, createBashToolDescription as v, createObservabilityHooks as w, createReadSkillHandler as x, createReadSkillTool as y, createSession as z };

package/dist/{workflow-BwT5EybR.d.ts → workflow-Cdw3-RNB.d.ts}

@@ -1,4 +1,4 @@
-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-ChAy_jSP.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-qQVZfhoT.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.
@@ -304,6 +335,7 @@ declare function defineSubagent<TResult extends z.ZodType = z.ZodType, TContext
     enabled?: boolean | (() => boolean);
     taskQueue?: string;
     thread?: "new" | "fork" | "continue";
+    newThreadSource?: "new" | "from-parent";
     sandbox?: SubagentSandboxConfig;
 }): SubagentConfig<TResult>;
 
@@ -709,6 +741,20 @@ declare const editTool: {
     strict: true;
 };
 type FileEditArgs = z.infer<typeof editTool.schema>;
+declare const multiEditTool: {
+    name: "FileMultiEdit";
+    description: string;
+    schema: z.ZodObject<{
+        file_path: z.ZodString;
+        edits: z.ZodArray<z.ZodObject<{
+            old_string: z.ZodString;
+            new_string: z.ZodString;
+            replace_all: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    strict: true;
+};
+type FileMultiEditArgs = z.infer<typeof multiEditTool.schema>;
 
 declare const taskCreateTool: {
     name: "TaskCreate";
@@ -856,4 +902,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-export { hasDirectory 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, getThreadListKey as V, type WorkflowConfig as W, getThreadMetaKey as X, globTool as Y, type ZeitlichObservabilitySinks as Z, grepTool as _, type FileReadArgs as a, hasFileWithMimeType as a0, hasNoOtherToolCalls as a1, parseSkillFile as a2, proxyRunAgent as a3, proxyVirtualFsOps as a4, readFileTool as a5, taskCreateTool as a6, taskGetTool as a7, taskListTool as a8, taskUpdateTool as a9, writeFileTool as aa, 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 };
+export { getThreadStateKey as $, type AskUserQuestionArgs as A, type BashArgs as B, createTaskCreateHandler as C, DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT as D, createTaskGetHandler as E, type FileEditArgs as F, type GlobArgs as G, createTaskListHandler as H, createTaskUpdateHandler as I, createToolRouter as J, defineSubagent as K, defineSubagentWorkflow as L, defineTool as M, defineWorkflow as N, type ObservabilityHooks as O, editTool as P, filesWithMimeType as Q, type ReadSkillArgs as R, type SessionEndedEvent as S, THREAD_TTL_SECONDS as T, formatVirtualFileTree as U, getShortId as V, type WorkflowConfig as W, getThreadDedupKey as X, getThreadListKey as Y, type ZeitlichObservabilitySinks as Z, getThreadMetaKey as _, type FileMultiEditArgs as a, globTool as a0, grepTool as a1, hasDirectory as a2, hasFileWithMimeType as a3, hasNoOtherToolCalls as a4, multiEditTool as a5, parseSkillFile as a6, proxyRunAgent as a7, proxyVirtualFsOps as a8, readFileTool as a9, taskCreateTool as aa, taskGetTool as ab, taskListTool as ac, taskUpdateTool as ad, writeFileTool as ae, type FileReadArgs as b, type FileWriteArgs as c, type FileTreeAccessor as d, type GrepArgs as e, type SessionStartedEvent as f, type SubagentArgs as g, type TaskCreateArgs as h, type TaskGetArgs as i, type TaskListArgs as j, type TaskUpdateArgs as k, type ToolExecutedEvent as l, type TurnCompletedEvent as m, type WorkflowInput as n, type WorkflowSessionInput as o, applyVirtualTreeMutations as p, askUserQuestionTool as q, bashTool as r, composeHooks as s, createAgentStateManager as t, createAskUserQuestionHandler as u, createBashToolDescription as v, createObservabilityHooks as w, createReadSkillHandler as x, createReadSkillTool as y, createSession as z };

package/dist/workflow.cjs

@@ -566,7 +566,8 @@ function createSubagentHandler(subagents) {
     }
     const threadMode = config.thread ?? "new";
     const allowsContinuation = threadMode !== "new";
-    const continuationThreadId = args.threadId && allowsContinuation ? args.threadId : void 0;
+    const newThreadSource = config.newThreadSource ?? "new";
+    const continuationThreadId = !allowsContinuation ? void 0 : args.threadId ?? (newThreadSource === "from-parent" ? context.threadId : void 0);
     let thread;
     if (continuationThreadId) {
       thread = {
@@ -1034,7 +1035,9 @@ async function createSession(config) {
     appendAgentMessage,
     forkThread,
     loadThreadState,
-    saveThreadState
+    saveThreadState,
+    hydrateThread,
+    flushThread
   } = threadOps;
   const plugins = [];
   let destroySubagentSandboxes;
@@ -1178,10 +1181,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 {
@@ -1363,6 +1368,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) {
@@ -2105,6 +2119,13 @@ IMPORTANT:
   }),
   strict: true
 };
+var textEditSchema = z14.z.object({
+  old_string: z14.z.string().describe("The exact text to replace"),
+  new_string: z14.z.string().describe("The text to replace it with"),
+  replace_all: z14.z.boolean().optional().describe(
+    "If true, replace all occurrences of old_string for this edit (default: false)"
+  )
+});
 var editTool = {
   name: "FileEdit",
   description: `Edit specific sections of a file by replacing text.
@@ -2133,6 +2154,27 @@ IMPORTANT:
   }),
   strict: true
 };
+var multiEditTool = {
+  name: "FileMultiEdit",
+  description: `Apply multiple exact text replacements to one file in order.
+
+Usage:
+- Use this when a task needs several related edits in the same file
+- Each edit is applied to the file content produced by the prior edit
+- The operation is atomic: if any edit fails, the file is left unchanged
+
+IMPORTANT:
+- You must read the file first (in this session) before editing it
+- Each old_string must match exactly (whitespace-sensitive)
+- Each old_string must be unique unless that edit uses replace_all: true
+- old_string and new_string must be different for every edit
+`,
+  schema: z14.z.object({
+    file_path: z14.z.string().describe("The absolute virtual path to the file to modify"),
+    edits: z14.z.array(textEditSchema).min(1).describe("Exact replacements to apply sequentially to the file")
+  }),
+  strict: true
+};
 var taskCreateTool = {
   name: "TaskCreate",
   description: `Use this tool to create a structured task list. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
@@ -2203,7 +2245,7 @@ function createTaskCreateHandler(stateManager) {
     };
     stateManager.setTask(task);
     return {
-      toolResponse: JSON.stringify(task, null, 2),
+      toolResponse: `Task ${task.id} created`,
       data: task
     };
   };
@@ -2302,7 +2344,7 @@ function createTaskUpdateHandler(stateManager) {
     }
     stateManager.setTask(task);
     return {
-      toolResponse: JSON.stringify(task, null, 2),
+      toolResponse: `Task ${task.id} updated`,
       data: task
     };
   };
@@ -2411,6 +2453,7 @@ exports.hasDirectory = hasDirectory;
 exports.hasFileWithMimeType = hasFileWithMimeType;
 exports.hasNoOtherToolCalls = hasNoOtherToolCalls;
 exports.isTerminalStatus = isTerminalStatus;
+exports.multiEditTool = multiEditTool;
 exports.parseSkillFile = parseSkillFile;
 exports.proxyRunAgent = proxyRunAgent;
 exports.proxyVirtualFsOps = proxyVirtualFsOps;