zeitlich 0.2.19 → 0.2.21

package/dist/{queries-D8T4pEeu.d.ts → queries-6Avfh74U.d.ts}

@@ -1,5 +1,5 @@
 import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, S as Sandbox, d as SandboxCreateOptions } from './types-BMRzfELQ.js';
-import { R as RouterContext } from './types-DjT78Sdp.js';
+import { R as RouterContext } from './types-YbL7JpEA.js';
 
 /**
  * Ephemeral {@link SandboxFileSystem} backed by a {@link FileResolver}.

package/dist/{queries-D22uWTOb.d.cts → queries-CHa2iv_I.d.cts}

@@ -1,5 +1,5 @@
 import { a as SandboxFileSystem, F as FileStat, D as DirentEntry, S as Sandbox, d as SandboxCreateOptions } from './types-BMRzfELQ.cjs';
-import { R as RouterContext } from './types-DjT78Sdp.cjs';
+import { R as RouterContext } from './types-YbL7JpEA.cjs';
 
 /**
  * Ephemeral {@link SandboxFileSystem} backed by a {@link FileResolver}.

package/dist/{types-CxWLeJTB.d.ts → types-BkAYmc96.d.ts}

@@ -1,8 +1,8 @@
 import { Duration } from '@temporalio/common';
-import { a as ToolMap, b as ToolRouterHooks, M as MessageContent, S as SessionExitReason, c as ToolHandlerResponse, P as PreToolUseHookResult, d as PostToolUseFailureHookResult, e as RawToolCall, f as TokenUsage, B as BaseAgentState, g as RunAgentConfig, h as AgentStatus, W as WorkflowTask, i as ToolDefinition, j as ToolResultConfig, k as ToolCallResultUnion, I as InferToolResults } from './types-DjT78Sdp.js';
+import { a as ToolMap, b as ToolRouterHooks, M as MessageContent, S as SessionExitReason, c as ToolHandlerResponse, P as PreToolUseHookResult, d as PostToolUseFailureHookResult, e as RawToolCall, f as TokenUsage, B as BaseAgentState, g as RunAgentConfig, h as AgentStatus, W as WorkflowTask, i as ToolDefinition, j as ToolResultConfig, k as ToolCallResultUnion, I as InferToolResults } from './types-YbL7JpEA.js';
 import { z } from 'zod';
 import { g as SandboxOps } from './types-BMRzfELQ.js';
-import { QueryDefinition } from '@temporalio/workflow';
+import { QueryDefinition, ActivityInterfaceFor } from '@temporalio/workflow';
 import { UpdateDefinition } from '@temporalio/common/lib/interfaces';
 
 /**
@@ -342,11 +342,11 @@ interface ThreadOps {
     /** Initialize an empty thread */
     initializeThread(threadId: string): Promise<void>;
     /** Append a human message to the thread */
-    appendHumanMessage(threadId: string, content: string | MessageContent): Promise<void>;
+    appendHumanMessage(threadId: string, id: string, content: string | MessageContent): Promise<void>;
     /** Append a tool result to the thread */
-    appendToolResult(config: ToolResultConfig): Promise<void>;
+    appendToolResult(id: string, config: ToolResultConfig): Promise<void>;
     /** Append a system message to the thread */
-    appendSystemMessage(threadId: string, content: string): Promise<void>;
+    appendSystemMessage(threadId: string, id: string, content: string): Promise<void>;
     /** Copy all messages from sourceThreadId into a new thread at targetThreadId */
     forkThread(sourceThreadId: string, targetThreadId: string): Promise<void>;
 }
@@ -367,7 +367,7 @@ interface SessionConfig<T extends ToolMap, M = unknown> {
     /** Workflow-specific runAgent activity (with tools pre-bound) */
     runAgent: RunAgentActivity<M>;
     /** Thread operations (initialize, append messages, parse tool calls) */
-    threadOps?: ThreadOps;
+    threadOps?: ActivityInterfaceFor<ThreadOps>;
     /** Tool router for processing tool calls (optional if agent has no tools) */
     tools?: T;
     /** Subagent configurations */

package/dist/{types-CCfJb5Jl.d.cts → types-CES_30qx.d.cts}

@@ -1,8 +1,8 @@
 import { Duration } from '@temporalio/common';
-import { a as ToolMap, b as ToolRouterHooks, M as MessageContent, S as SessionExitReason, c as ToolHandlerResponse, P as PreToolUseHookResult, d as PostToolUseFailureHookResult, e as RawToolCall, f as TokenUsage, B as BaseAgentState, g as RunAgentConfig, h as AgentStatus, W as WorkflowTask, i as ToolDefinition, j as ToolResultConfig, k as ToolCallResultUnion, I as InferToolResults } from './types-DjT78Sdp.cjs';
+import { a as ToolMap, b as ToolRouterHooks, M as MessageContent, S as SessionExitReason, c as ToolHandlerResponse, P as PreToolUseHookResult, d as PostToolUseFailureHookResult, e as RawToolCall, f as TokenUsage, B as BaseAgentState, g as RunAgentConfig, h as AgentStatus, W as WorkflowTask, i as ToolDefinition, j as ToolResultConfig, k as ToolCallResultUnion, I as InferToolResults } from './types-YbL7JpEA.cjs';
 import { z } from 'zod';
 import { g as SandboxOps } from './types-BMRzfELQ.cjs';
-import { QueryDefinition } from '@temporalio/workflow';
+import { QueryDefinition, ActivityInterfaceFor } from '@temporalio/workflow';
 import { UpdateDefinition } from '@temporalio/common/lib/interfaces';
 
 /**
@@ -342,11 +342,11 @@ interface ThreadOps {
     /** Initialize an empty thread */
     initializeThread(threadId: string): Promise<void>;
     /** Append a human message to the thread */
-    appendHumanMessage(threadId: string, content: string | MessageContent): Promise<void>;
+    appendHumanMessage(threadId: string, id: string, content: string | MessageContent): Promise<void>;
     /** Append a tool result to the thread */
-    appendToolResult(config: ToolResultConfig): Promise<void>;
+    appendToolResult(id: string, config: ToolResultConfig): Promise<void>;
     /** Append a system message to the thread */
-    appendSystemMessage(threadId: string, content: string): Promise<void>;
+    appendSystemMessage(threadId: string, id: string, content: string): Promise<void>;
     /** Copy all messages from sourceThreadId into a new thread at targetThreadId */
     forkThread(sourceThreadId: string, targetThreadId: string): Promise<void>;
 }
@@ -367,7 +367,7 @@ interface SessionConfig<T extends ToolMap, M = unknown> {
     /** Workflow-specific runAgent activity (with tools pre-bound) */
     runAgent: RunAgentActivity<M>;
     /** Thread operations (initialize, append messages, parse tool calls) */
-    threadOps?: ThreadOps;
+    threadOps?: ActivityInterfaceFor<ThreadOps>;
     /** Tool router for processing tool calls (optional if agent has no tools) */
     tools?: T;
     /** Subagent configurations */

package/dist/{types-DjT78Sdp.d.cts → types-YbL7JpEA.d.cts}

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { ActivityFunctionWithOptions } from '@temporalio/workflow';
 
 /** A single content part within a structured message (text, image, etc.) */
 type ContentPart = {
@@ -199,7 +200,7 @@ type ParsedToolCallUnion<T extends ToolMap> = {
 /**
  * Function signature for appending tool results to a thread.
  */
-type AppendToolResultFn = (config: ToolResultConfig) => Promise<void>;
+type AppendToolResultFn = ActivityFunctionWithOptions<(id: string, config: ToolResultConfig) => Promise<void>>;
 /**
  * The response from a tool handler.
  * Contains the content for the tool message and the result to return from processToolCalls.
@@ -415,7 +416,8 @@ interface ToolRouterOptions<T extends ToolMap> {
     tools: T;
     /** Thread ID for appending tool results */
     threadId: string;
-    /** Function to append tool results to the thread (called automatically after each handler) */
+    /** Function to append tool results to the thread (called automatically after each handler).
+     *  Accepts a Temporal activity proxy with {@link ActivityFunctionWithOptions}. */
     appendToolResult: AppendToolResultFn;
     /** Whether to process tools in parallel (default: true) */
     parallel?: boolean;

package/dist/{types-DjT78Sdp.d.ts → types-YbL7JpEA.d.ts}

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { ActivityFunctionWithOptions } from '@temporalio/workflow';
 
 /** A single content part within a structured message (text, image, etc.) */
 type ContentPart = {
@@ -199,7 +200,7 @@ type ParsedToolCallUnion<T extends ToolMap> = {
 /**
  * Function signature for appending tool results to a thread.
  */
-type AppendToolResultFn = (config: ToolResultConfig) => Promise<void>;
+type AppendToolResultFn = ActivityFunctionWithOptions<(id: string, config: ToolResultConfig) => Promise<void>>;
 /**
  * The response from a tool handler.
  * Contains the content for the tool message and the result to return from processToolCalls.
@@ -415,7 +416,8 @@ interface ToolRouterOptions<T extends ToolMap> {
     tools: T;
     /** Thread ID for appending tool results */
     threadId: string;
-    /** Function to append tool results to the thread (called automatically after each handler) */
+    /** Function to append tool results to the thread (called automatically after each handler).
+     *  Accepts a Temporal activity proxy with {@link ActivityFunctionWithOptions}. */
     appendToolResult: AppendToolResultFn;
     /** Whether to process tools in parallel (default: true) */
     parallel?: boolean;

package/dist/workflow.cjs

@@ -57,7 +57,10 @@ function createToolRouter(options) {
         turn
       });
       if (r?.fallbackContent !== void 0)
-        return { content: r.fallbackContent, result: { error: errorStr, recovered: true } };
+        return {
+          content: r.fallbackContent,
+          result: { error: errorStr, recovered: true }
+        };
       if (r?.suppress)
         return {
           content: JSON.stringify({ error: errorStr, suppressed: true }),
@@ -72,7 +75,10 @@ function createToolRouter(options) {
         turn
       });
       if (r?.fallbackContent !== void 0)
-        return { content: r.fallbackContent, result: { error: errorStr, recovered: true } };
+        return {
+          content: r.fallbackContent,
+          result: { error: errorStr, recovered: true }
+        };
       if (r?.suppress)
         return {
           content: JSON.stringify({ error: errorStr, suppressed: true }),
@@ -106,11 +112,14 @@ function createToolRouter(options) {
     const tool = toolMap.get(toolCall.name);
     const preResult = await runPreHooks(toolCall, tool, turn);
     if (preResult.skip) {
-      await appendToolResult({
+      await appendToolResult(workflow.uuid4(), {
         threadId: options.threadId,
         toolCallId: toolCall.id,
         toolName: toolCall.name,
-        content: JSON.stringify({ skipped: true, reason: "Skipped by PreToolUse hook" })
+        content: JSON.stringify({
+          skipped: true,
+          reason: "Skipped by PreToolUse hook"
+        })
       });
       return null;
     }
@@ -138,24 +147,43 @@ function createToolRouter(options) {
         content = JSON.stringify(result, null, 2);
       }
     } catch (error) {
-      const recovery = await runFailureHooks(toolCall, tool, error, effectiveArgs, turn);
+      const recovery = await runFailureHooks(
+        toolCall,
+        tool,
+        error,
+        effectiveArgs,
+        turn
+      );
       result = recovery.result;
       content = recovery.content;
     }
     if (!resultAppended) {
-      await appendToolResult({
+      const config = {
         threadId: options.threadId,
         toolCallId: toolCall.id,
         toolName: toolCall.name,
         content
-      });
+      };
+      await appendToolResult.executeWithOptions(
+        {
+          summary: `Append ${toolCall.name} result`
+        },
+        [workflow.uuid4(), config]
+      );
     }
     const toolResult = {
       toolCallId: toolCall.id,
       name: toolCall.name,
       data: result
     };
-    await runPostHooks(toolCall, tool, toolResult, effectiveArgs, turn, Date.now() - startTime);
+    await runPostHooks(
+      toolCall,
+      tool,
+      toolResult,
+      effectiveArgs,
+      turn,
+      Date.now() - startTime
+    );
     return toolResult;
   }
   return {
@@ -198,9 +226,7 @@ function createToolRouter(options) {
       const sandboxId = context?.sandboxId;
       if (options.parallel) {
         const results2 = await Promise.all(
-          toolCalls.map(
-            (tc) => processToolCall(tc, turn, sandboxId)
-          )
+          toolCalls.map((tc) => processToolCall(tc, turn, sandboxId))
         );
         return results2.filter(
           (r) => r !== null
@@ -208,11 +234,7 @@ function createToolRouter(options) {
       }
       const results = [];
       for (const toolCall of toolCalls) {
-        const result = await processToolCall(
-          toolCall,
-          turn,
-          sandboxId
-        );
+        const result = await processToolCall(toolCall, turn, sandboxId);
         if (result !== null) {
           results.push(result);
         }
@@ -229,19 +251,29 @@ function createToolRouter(options) {
           threadId: options.threadId,
           toolCallId: toolCall.id,
           toolName: toolCall.name,
-          ...context?.sandboxId !== void 0 && { sandboxId: context.sandboxId }
+          ...context?.sandboxId !== void 0 && {
+            sandboxId: context.sandboxId
+          }
         };
         const response = await handler(
           toolCall.args,
           routerContext
         );
         if (!response.resultAppended) {
-          await appendToolResult({
-            threadId: options.threadId,
-            toolCallId: toolCall.id,
-            toolName: toolCall.name,
-            content: response.toolResponse
-          });
+          await appendToolResult.executeWithOptions(
+            {
+              summary: `Append ${toolCall.name} result`
+            },
+            [
+              workflow.uuid4(),
+              {
+                threadId: options.threadId,
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: response.toolResponse
+              }
+            ]
+          );
         }
         return {
           toolCallId: toolCall.id,
@@ -316,7 +348,7 @@ function createSubagentTool(subagents) {
   const schema = hasThreadContinuation ? z14__default.default.object({
     ...baseFields,
     threadId: z14__default.default.string().nullable().describe(
-      "Thread ID to continue an existing conversation, or null to start a new one"
+      "Thread ID to continue an existing conversation from the same subagent, or null to start a new one"
     )
   }) : z14__default.default.object(baseFields);
   return {
@@ -373,7 +405,7 @@ function createSubagentHandler(subagents) {
     if (config.allowThreadContinuation && childThreadId) {
       finalToolResponse = typeof toolResponse === "string" ? `${toolResponse}
 
-[Thread ID: ${childThreadId}]` : toolResponse;
+[${config.agentName} Thread ID: ${childThreadId}]` : toolResponse;
     }
     return {
       toolResponse: finalToolResponse,
@@ -469,8 +501,6 @@ function buildSkillRegistration(skills) {
     handler: createReadSkillHandler(skills)
   };
 }
-
-// src/lib/session/session.ts
 var createSession = async ({
   threadId: providedThreadId,
   agentName,
@@ -540,7 +570,7 @@ var createSession = async ({
               threadId
             });
           }
-          await appendHumanMessage(threadId, message);
+          await appendHumanMessage(threadId, workflow.uuid4(), message);
           if (hooks.onPostHumanMessageAppend) {
             await hooks.onPostHumanMessageAppend({
               message,
@@ -577,12 +607,12 @@ var createSession = async ({
               nonRetryable: true
             });
           }
-          await appendSystemMessage(threadId, systemPrompt);
+          await appendSystemMessage(threadId, workflow.uuid4(), systemPrompt);
         } else {
           await initializeThread(threadId);
         }
       }
-      await appendHumanMessage(threadId, await buildContextMessage());
+      await appendHumanMessage(threadId, workflow.uuid4(), await buildContextMessage());
       let exitReason = "completed";
       try {
         while (stateManager.isRunning() && !stateManager.isTerminal() && stateManager.getTurns() < maxTurns) {
@@ -612,7 +642,7 @@ var createSession = async ({
             try {
               parsedToolCalls.push(toolRouter.parseToolCall(tc));
             } catch (error) {
-              await appendToolResult({
+              await appendToolResult(workflow.uuid4(), {
                 threadId,
                 toolCallId: tc.id ?? "",
                 toolName: tc.name,
@@ -696,8 +726,8 @@ function proxySandboxOps(options) {
 }
 
 // src/lib/workflow.ts
-function defineWorkflow(fn) {
-  return async (input, workflowInput = {}) => {
+function defineWorkflow(config, fn) {
+  const workflow = async (input, workflowInput = {}) => {
     const sessionInput = {
       ...workflowInput.previousThreadId && {
         threadId: workflowInput.previousThreadId,
@@ -707,6 +737,8 @@ function defineWorkflow(fn) {
     };
     return fn(input, sessionInput);
   };
+  Object.defineProperty(workflow, "name", { value: config.name });
+  return workflow;
 }
 
 // src/lib/types.ts
@@ -1273,10 +1305,12 @@ var taskCreateTool = {
     metadata: z14__default.default.record(z14__default.default.string(), z14__default.default.string()).describe("Arbitrary key-value pairs for tracking")
   })
 };
+
+// src/tools/task-create/handler.ts
 function createTaskCreateHandler(stateManager) {
   return (args) => {
     const task = {
-      id: workflow.uuid4(),
+      id: getShortId(),
       subject: args.subject,
       description: args.description,
       activeForm: args.activeForm,