zeitlich 0.2.18 → 0.2.20

package/dist/{queries-TwukRZ8b.d.ts → queries-KHj5Otv7.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-CmOSypVk.js';
+import { R as RouterContext } from './types-Ct2igz9y.js';
 
 /**
  * Ephemeral {@link SandboxFileSystem} backed by a {@link FileResolver}.

package/dist/{queries-DnX72m_Y.d.cts → queries-nIdzTCDS.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-CmOSypVk.cjs';
+import { R as RouterContext } from './types-Ct2igz9y.cjs';
 
 /**
  * Ephemeral {@link SandboxFileSystem} backed by a {@link FileResolver}.

package/dist/{types-CdB2D5Sq.d.ts → types-By80IE1x.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-CmOSypVk.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-Ct2igz9y.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';
 
 /**
@@ -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-CmOSypVk.d.ts → types-Ct2igz9y.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 = {
@@ -162,8 +163,8 @@ interface ToolWithHandler<TName extends string = string, TSchema extends z.ZodTy
  */
 type ToolMap = Record<string, {
     name: string;
-    description: string;
-    schema: z.ZodType;
+    description: string | (() => string);
+    schema: z.ZodType | (() => z.ZodType);
     handler: ToolHandler<any, any, any>;
     strict?: boolean;
     max_uses?: number;
@@ -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<(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-CmOSypVk.d.cts → types-Ct2igz9y.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 = {
@@ -162,8 +163,8 @@ interface ToolWithHandler<TName extends string = string, TSchema extends z.ZodTy
  */
 type ToolMap = Record<string, {
     name: string;
-    description: string;
-    schema: z.ZodType;
+    description: string | (() => string);
+    schema: z.ZodType | (() => z.ZodType);
     handler: ToolHandler<any, any, any>;
     strict?: boolean;
     max_uses?: number;
@@ -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<(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-DRvq2miV.d.cts → types-DZ7BkA3-.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-CmOSypVk.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-Ct2igz9y.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';
 
 /**
@@ -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/workflow.cjs

@@ -15,7 +15,8 @@ function createToolRouter(options) {
   for (const [_key, tool] of Object.entries(options.tools)) {
     toolMap.set(tool.name, tool);
   }
-  const isEnabled = (tool) => typeof tool.enabled === "function" ? tool.enabled() : tool.enabled ?? true;
+  const resolve = (v) => typeof v === "function" ? v() : v;
+  const isEnabled = (tool) => resolve(tool.enabled) ?? true;
   if (options.plugins) {
     for (const plugin of options.plugins) {
       toolMap.set(plugin.name, plugin);
@@ -56,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 }),
@@ -71,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 }),
@@ -109,7 +116,10 @@ function createToolRouter(options) {
         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;
     }
@@ -137,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`
+        },
+        [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 {
@@ -166,7 +195,7 @@ function createToolRouter(options) {
       if (!tool || !isEnabled(tool)) {
         throw new Error(`Tool ${toolCall.name} not found`);
       }
-      const parsedArgs = tool.schema.parse(toolCall.args);
+      const parsedArgs = resolve(tool.schema).parse(toolCall.args);
       return {
         id: toolCall.id ?? "",
         name: toolCall.name,
@@ -183,8 +212,8 @@ function createToolRouter(options) {
     getToolDefinitions() {
       return Array.from(toolMap).filter(([, tool]) => isEnabled(tool)).map(([name, tool]) => ({
         name,
-        description: tool.description,
-        schema: tool.schema,
+        description: resolve(tool.description),
+        schema: resolve(tool.schema),
         strict: tool.strict,
         max_uses: tool.max_uses
       }));
@@ -197,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
@@ -207,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);
         }
@@ -228,19 +251,28 @@ 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`
+            },
+            [
+              {
+                threadId: options.threadId,
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: response.toolResponse
+              }
+            ]
+          );
         }
         return {
           toolCallId: toolCall.id,
@@ -315,7 +347,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 {
@@ -372,7 +404,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,
@@ -395,15 +427,9 @@ function buildSubagentRegistration(subagents) {
   const resolveSubagentName = (args) => args.subagent;
   return {
     name: SUBAGENT_TOOL_NAME,
-    get enabled() {
-      return getEnabled().length > 0;
-    },
-    get description() {
-      return createSubagentTool(getEnabled()).description;
-    },
-    get schema() {
-      return createSubagentTool(getEnabled()).schema;
-    },
+    enabled: () => getEnabled().length > 0,
+    description: () => createSubagentTool(getEnabled()).description,
+    schema: () => createSubagentTool(getEnabled()).schema,
     handler: createSubagentHandler(subagents),
     ...subagentHooksMap.size > 0 && {
       hooks: {
@@ -701,8 +727,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,
@@ -712,6 +738,8 @@ function defineWorkflow(fn) {
     };
     return fn(input, sessionInput);
   };
+  Object.defineProperty(workflow, "name", { value: config.name });
+  return workflow;
 }
 
 // src/lib/types.ts
@@ -1278,10 +1306,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,