zeitlich 0.2.46 → 0.2.48

package/dist/proxy-BAty3CWM.d.cts

@@ -0,0 +1,40 @@
+import { ActivityOptions, ActivityInterfaceFor } from '@temporalio/workflow';
+import { T as ThreadOps } from './types-DWeyCTYK.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-mbnwBhHw.d.ts

@@ -0,0 +1,40 @@
+import { ActivityOptions, ActivityInterfaceFor } from '@temporalio/workflow';
+import { T as ThreadOps } from './types-DwBYd0ij.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-DduoSkvJ.d.ts → thread-manager-CICj68PI.d.ts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-CwN6_tAL.js';
+import { J as JsonValue } from './types-DwBYd0ij.js';
 import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-L5bvbF-n.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-DF4wzWQG.js';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;

package/dist/{thread-manager-D33SUmZa.d.cts → thread-manager-DsXvJ5cJ.d.cts}

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
-import { J as JsonValue } from './types-CnuN9T6t.cjs';
+import { J as JsonValue } from './types-DWeyCTYK.cjs';
 import { MessageContent, StoredMessage, BaseMessage } from '@langchain/core/messages';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-oxt8GN97.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-DDLPnxBh.cjs';
 
 /** SDK-native content type for LangChain human messages */
 type LangChainContent = string | MessageContent;

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

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { J as JsonValue } from './types-CwN6_tAL.js';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-L5bvbF-n.js';
+import { J as JsonValue } from './types-DwBYd0ij.js';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-DF4wzWQG.js';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];

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

@@ -1,7 +1,7 @@
 import Redis from 'ioredis';
 import Anthropic from '@anthropic-ai/sdk';
-import { J as JsonValue } from './types-CnuN9T6t.cjs';
-import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-oxt8GN97.cjs';
+import { J as JsonValue } from './types-DWeyCTYK.cjs';
+import { T as ThreadManagerHooks, P as ProviderThreadManager } from './types-DDLPnxBh.cjs';
 
 /** SDK-native content type for Anthropic human messages */
 type AnthropicContent = string | Anthropic.Messages.ContentBlockParam[];

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

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { P as PersistedThreadState, J as JsonValue } from './types-CnuN9T6t.cjs';
+import { P as PersistedThreadState, J as JsonValue } from './types-DWeyCTYK.cjs';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;

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

@@ -1,5 +1,5 @@
 import Redis from 'ioredis';
-import { P as PersistedThreadState, J as JsonValue } from './types-CwN6_tAL.js';
+import { P as PersistedThreadState, J as JsonValue } from './types-DwBYd0ij.js';
 
 interface ThreadManagerConfig<T> {
     redis: Redis;

package/dist/{types-CnuN9T6t.d.cts → types-DWeyCTYK.d.cts}

@@ -134,6 +134,18 @@ interface RouterContext {
     toolCallId: string;
     toolName: string;
     sandboxId?: string;
+    /**
+     * Id of the assistant message that issued this tool call (the message
+     * the session passed as `assistantMessageId` into `runAgent`). Present
+     * for any tool call processed through `processToolCalls` from a
+     * session; may be absent when the router is driven manually (e.g.
+     * tests, custom orchestrators).
+     *
+     * Subagent handlers that fork the parent's thread mid-call use this
+     * to truncate the orphan trailing assistant message from the forked
+     * thread so the child's first model call sees a well-formed history.
+     */
+    assistantMessageId?: string;
 }
 /**
  * A handler function for a specific tool.
@@ -201,6 +213,14 @@ interface ProcessToolCallsContext {
     turn?: number;
     /** Active sandbox ID (when a sandbox is configured for this session) */
     sandboxId?: string;
+    /**
+     * Id of the assistant message that produced these tool calls. The
+     * router forwards it into every handler's {@link RouterContext} so
+     * handlers can reference the message they were issued from (e.g.
+     * subagent forks that need to truncate the orphan assistant message
+     * out of a parent-forked thread).
+     */
+    assistantMessageId?: string;
 }
 /**
  * Signal that a tool handler requested a rewind. Attached to the
@@ -887,6 +907,14 @@ interface Hooks<T extends ToolMap, TResult = unknown, TContent = unknown> extend
  *   continue there. When the adapter has `onForkPrepareThread` and/or
  *   `onForkTransform` hooks configured, they are applied once to the forked
  *   thread before the session starts.
+ *
+ *   The optional `truncateAfterFork.fromMessageId` directs the session to
+ *   call `truncateThread` on the freshly forked thread immediately after
+ *   the fork, dropping that message and everything after. Used by
+ *   subagents that fork their parent's thread mid-tool-call to strip the
+ *   orphan assistant `tool_use` block (the one whose `tool_result` will
+ *   never arrive in the child's thread) so the first model call doesn't
+ *   reject on an unmatched tool-use/tool-result pair.
  */
 type ThreadInit = {
     mode: "new";
@@ -897,6 +925,9 @@ type ThreadInit = {
 } | {
     mode: "fork";
     threadId: string;
+    truncateAfterFork?: {
+        fromMessageId: string;
+    };
 };
 
 /**
@@ -1283,6 +1314,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.
      *

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

@@ -134,6 +134,18 @@ interface RouterContext {
     toolCallId: string;
     toolName: string;
     sandboxId?: string;
+    /**
+     * Id of the assistant message that issued this tool call (the message
+     * the session passed as `assistantMessageId` into `runAgent`). Present
+     * for any tool call processed through `processToolCalls` from a
+     * session; may be absent when the router is driven manually (e.g.
+     * tests, custom orchestrators).
+     *
+     * Subagent handlers that fork the parent's thread mid-call use this
+     * to truncate the orphan trailing assistant message from the forked
+     * thread so the child's first model call sees a well-formed history.
+     */
+    assistantMessageId?: string;
 }
 /**
  * A handler function for a specific tool.
@@ -201,6 +213,14 @@ interface ProcessToolCallsContext {
     turn?: number;
     /** Active sandbox ID (when a sandbox is configured for this session) */
     sandboxId?: string;
+    /**
+     * Id of the assistant message that produced these tool calls. The
+     * router forwards it into every handler's {@link RouterContext} so
+     * handlers can reference the message they were issued from (e.g.
+     * subagent forks that need to truncate the orphan assistant message
+     * out of a parent-forked thread).
+     */
+    assistantMessageId?: string;
 }
 /**
  * Signal that a tool handler requested a rewind. Attached to the
@@ -887,6 +907,14 @@ interface Hooks<T extends ToolMap, TResult = unknown, TContent = unknown> extend
  *   continue there. When the adapter has `onForkPrepareThread` and/or
  *   `onForkTransform` hooks configured, they are applied once to the forked
  *   thread before the session starts.
+ *
+ *   The optional `truncateAfterFork.fromMessageId` directs the session to
+ *   call `truncateThread` on the freshly forked thread immediately after
+ *   the fork, dropping that message and everything after. Used by
+ *   subagents that fork their parent's thread mid-tool-call to strip the
+ *   orphan assistant `tool_use` block (the one whose `tool_result` will
+ *   never arrive in the child's thread) so the first model call doesn't
+ *   reject on an unmatched tool-use/tool-result pair.
  */
 type ThreadInit = {
     mode: "new";
@@ -897,6 +925,9 @@ type ThreadInit = {
 } | {
     mode: "fork";
     threadId: string;
+    truncateAfterFork?: {
+        fromMessageId: string;
+    };
 };
 
 /**
@@ -1283,6 +1314,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.
      *

package/dist/{workflow-DIaIV7L2.d.cts → workflow-DVNPR7eX.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-CnuN9T6t.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-DWeyCTYK.cjs';
 import z$1, { z } from 'zod';
 import './types-CJ7tCdl6.cjs';
 import { Duration } from '@temporalio/common';
@@ -335,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>;
 
@@ -740,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";
@@ -887,4 +902,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-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 };
+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-B1TOcHbt.d.ts → workflow-DdaU7_j4.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-CwN6_tAL.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-DwBYd0ij.js';
 import z$1, { z } from 'zod';
 import './types-CJ7tCdl6.js';
 import { Duration } from '@temporalio/common';
@@ -335,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>;
 
@@ -740,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";
@@ -887,4 +902,4 @@ declare const createAskUserQuestionHandler: () => ActivityToolHandler<AskUserQue
     }[];
 }>;
 
-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 };
+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

@@ -123,7 +123,7 @@ function createToolRouter(options) {
       });
     }
   }
-  async function processToolCall(toolCall, turn, sandboxId, onRewindRequested) {
+  async function processToolCall(toolCall, turn, sandboxId, onRewindRequested, assistantMessageId) {
     const startTime = Date.now();
     const tool = toolMap.get(toolCall.name);
     const preResult = await runPreHooks(toolCall, tool, turn);
@@ -158,7 +158,8 @@ function createToolRouter(options) {
           ...options.threadKey && { threadKey: options.threadKey },
           toolCallId: toolCall.id,
           toolName: toolCall.name,
-          ...sandboxId !== void 0 && { sandboxId }
+          ...sandboxId !== void 0 && { sandboxId },
+          ...assistantMessageId !== void 0 && { assistantMessageId }
         };
         const response = await tool.handler(
           effectiveArgs,
@@ -285,6 +286,7 @@ function createToolRouter(options) {
       }
       const turn = context?.turn ?? 0;
       const sandboxId = context?.sandboxId;
+      const assistantMessageId = context?.assistantMessageId;
       let rewindSignal;
       if (options.parallel) {
         const scope = new workflow.CancellationScope({ cancellable: true });
@@ -297,7 +299,13 @@ function createToolRouter(options) {
         const outcomes = await scope.run(
           async () => Promise.allSettled(
             toolCalls.map(
-              (tc) => processToolCall(tc, turn, sandboxId, onRewindRequested)
+              (tc) => processToolCall(
+                tc,
+                turn,
+                sandboxId,
+                onRewindRequested,
+                assistantMessageId
+              )
             )
           )
         );
@@ -317,7 +325,13 @@ function createToolRouter(options) {
       }
       const results = [];
       for (const toolCall of toolCalls) {
-        const outcome = await processToolCall(toolCall, turn, sandboxId);
+        const outcome = await processToolCall(
+          toolCall,
+          turn,
+          sandboxId,
+          void 0,
+          assistantMessageId
+        );
         if (outcome.kind === "rewind") {
           rewindSignal = outcome.signal;
           break;
@@ -341,6 +355,9 @@ function createToolRouter(options) {
           toolName: toolCall.name,
           ...context?.sandboxId !== void 0 && {
             sandboxId: context.sandboxId
+          },
+          ...context?.assistantMessageId !== void 0 && {
+            assistantMessageId: context.assistantMessageId
           }
         };
         const response = await handler(
@@ -566,13 +583,27 @@ 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 usingParentFallback = allowsContinuation && !args.threadId && newThreadSource === "from-parent";
+    const continuationThreadId = !allowsContinuation ? void 0 : args.threadId ?? (usingParentFallback ? context.threadId : void 0);
     let thread;
     if (continuationThreadId) {
-      thread = {
-        mode: threadMode,
-        threadId: continuationThreadId
-      };
+      if (threadMode === "fork") {
+        thread = {
+          mode: "fork",
+          threadId: continuationThreadId,
+          ...usingParentFallback && context.assistantMessageId ? {
+            truncateAfterFork: {
+              fromMessageId: context.assistantMessageId
+            }
+          } : {}
+        };
+      } else {
+        thread = {
+          mode: "continue",
+          threadId: continuationThreadId
+        };
+      }
     }
     let sandbox;
     let sandboxShutdownOverride;
@@ -1033,6 +1064,7 @@ async function createSession(config) {
     appendSystemMessage,
     appendAgentMessage,
     forkThread,
+    truncateThread,
     loadThreadState,
     saveThreadState,
     hydrateThread,
@@ -1182,6 +1214,10 @@ async function createSession(config) {
       if (threadMode === "fork" && sourceThreadId) {
         await hydrateThread(sourceThreadId, threadKey);
         await forkThread(sourceThreadId, threadId, threadKey);
+        const truncate = threadInit.truncateAfterFork;
+        if (truncate?.fromMessageId) {
+          await truncateThread(threadId, truncate.fromMessageId, threadKey);
+        }
         const forkedSlice = await loadThreadState(threadId, threadKey);
         if (forkedSlice) rehydrateFromSlice(forkedSlice);
       } else if (threadMode === "continue") {
@@ -1311,7 +1347,10 @@ async function createSession(config) {
             parsedToolCalls,
             {
               turn: currentTurn,
-              ...sandboxId !== void 0 && { sandboxId }
+              ...sandboxId !== void 0 && { sandboxId },
+              ...assistantId !== void 0 && {
+                assistantMessageId: assistantId
+              }
             }
           );
           for (const result of toolCallResults) {
@@ -2118,6 +2157,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.
@@ -2146,6 +2192,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.
@@ -2216,7 +2283,7 @@ function createTaskCreateHandler(stateManager) {
     };
     stateManager.setTask(task);
     return {
-      toolResponse: JSON.stringify(task, null, 2),
+      toolResponse: `Task ${task.id} created`,
       data: task
     };
   };
@@ -2315,7 +2382,7 @@ function createTaskUpdateHandler(stateManager) {
     }
     stateManager.setTask(task);
     return {
-      toolResponse: JSON.stringify(task, null, 2),
+      toolResponse: `Task ${task.id} updated`,
       data: task
     };
   };
@@ -2424,6 +2491,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;