zeitlich 0.2.48 → 0.2.50

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/README.md +26 -23
  2. package/dist/{activities-DCaIPQBT.d.ts → activities-IuOIvPHO.d.ts} +6 -6
  3. package/dist/{activities-BlQR5gX4.d.cts → activities-cIlq1y1y.d.cts} +6 -6
  4. package/dist/adapters/sandbox/daytona/index.cjs.map +1 -1
  5. package/dist/adapters/sandbox/daytona/index.d.cts +3 -3
  6. package/dist/adapters/sandbox/daytona/index.d.ts +3 -3
  7. package/dist/adapters/sandbox/daytona/index.js.map +1 -1
  8. package/dist/adapters/sandbox/daytona/workflow.d.cts +2 -2
  9. package/dist/adapters/sandbox/daytona/workflow.d.ts +2 -2
  10. package/dist/adapters/sandbox/e2b/index.cjs.map +1 -1
  11. package/dist/adapters/sandbox/e2b/index.d.cts +1 -1
  12. package/dist/adapters/sandbox/e2b/index.d.ts +1 -1
  13. package/dist/adapters/sandbox/e2b/index.js.map +1 -1
  14. package/dist/adapters/sandbox/e2b/workflow.d.cts +1 -1
  15. package/dist/adapters/sandbox/e2b/workflow.d.ts +1 -1
  16. package/dist/adapters/thread/anthropic/index.cjs +45 -42
  17. package/dist/adapters/thread/anthropic/index.cjs.map +1 -1
  18. package/dist/adapters/thread/anthropic/index.d.cts +10 -10
  19. package/dist/adapters/thread/anthropic/index.d.ts +10 -10
  20. package/dist/adapters/thread/anthropic/index.js +45 -42
  21. package/dist/adapters/thread/anthropic/index.js.map +1 -1
  22. package/dist/adapters/thread/anthropic/workflow.d.cts +7 -7
  23. package/dist/adapters/thread/anthropic/workflow.d.ts +7 -7
  24. package/dist/adapters/thread/google-genai/index.cjs +117 -54
  25. package/dist/adapters/thread/google-genai/index.cjs.map +1 -1
  26. package/dist/adapters/thread/google-genai/index.d.cts +27 -23
  27. package/dist/adapters/thread/google-genai/index.d.ts +27 -23
  28. package/dist/adapters/thread/google-genai/index.js +117 -54
  29. package/dist/adapters/thread/google-genai/index.js.map +1 -1
  30. package/dist/adapters/thread/google-genai/workflow.d.cts +8 -8
  31. package/dist/adapters/thread/google-genai/workflow.d.ts +8 -8
  32. package/dist/adapters/thread/langchain/index.cjs +45 -42
  33. package/dist/adapters/thread/langchain/index.cjs.map +1 -1
  34. package/dist/adapters/thread/langchain/index.d.cts +10 -10
  35. package/dist/adapters/thread/langchain/index.d.ts +10 -10
  36. package/dist/adapters/thread/langchain/index.js +45 -42
  37. package/dist/adapters/thread/langchain/index.js.map +1 -1
  38. package/dist/adapters/thread/langchain/workflow.d.cts +7 -7
  39. package/dist/adapters/thread/langchain/workflow.d.ts +7 -7
  40. package/dist/{cold-store-UL13Sstw.d.cts → cold-store-C0uvYTSi.d.cts} +1 -1
  41. package/dist/{cold-store-aD4TSKlU.d.ts → cold-store-CCnZYWjx.d.ts} +1 -1
  42. package/dist/index.cjs +15063 -405
  43. package/dist/index.cjs.map +1 -1
  44. package/dist/index.d.cts +79 -83
  45. package/dist/index.d.ts +79 -83
  46. package/dist/index.js +15064 -402
  47. package/dist/index.js.map +1 -1
  48. package/dist/{proxy-BAty3CWM.d.cts → proxy-BVznA2_p.d.cts} +1 -1
  49. package/dist/{proxy-mbnwBhHw.d.ts → proxy-C4J1pNUk.d.ts} +1 -1
  50. package/dist/{thread-manager-CICj68PI.d.ts → thread-manager-BqjzWsP7.d.ts} +4 -4
  51. package/dist/{thread-manager-R6c3lnJy.d.cts → thread-manager-CzIs47uG.d.cts} +4 -4
  52. package/dist/{thread-manager-DsXvJ5cJ.d.cts → thread-manager-Dzl1fHhV.d.cts} +4 -4
  53. package/dist/{thread-manager-DtEtbUkp.d.ts → thread-manager-SkSWRPRc.d.ts} +4 -4
  54. package/dist/{types-gVa5XCWD.d.ts → types-BQvXWcft.d.ts} +1 -1
  55. package/dist/{types-DF4wzWQG.d.ts → types-CbPnU4RM.d.ts} +3 -3
  56. package/dist/{types-CJ7tCdl6.d.cts → types-D8W5TnSa.d.cts} +3 -3
  57. package/dist/{types-CJ7tCdl6.d.ts → types-D8W5TnSa.d.ts} +3 -3
  58. package/dist/{types-DwBYd0ij.d.ts → types-DZnUqCAP.d.cts} +709 -686
  59. package/dist/{types-CjY93AWZ.d.cts → types-OEN1xrFg.d.cts} +1 -1
  60. package/dist/{types-DWeyCTYK.d.cts → types-YNesmGKV.d.ts} +709 -686
  61. package/dist/{types-DDLPnxBh.d.cts → types-d2RvEP6v.d.cts} +3 -3
  62. package/dist/{workflow-DdaU7_j4.d.ts → workflow-B3oTe2_D.d.cts} +34 -3
  63. package/dist/{workflow-DVNPR7eX.d.cts → workflow-Bkzg0cjB.d.ts} +34 -3
  64. package/dist/workflow.cjs +15021 -362
  65. package/dist/workflow.cjs.map +1 -1
  66. package/dist/workflow.d.cts +3 -3
  67. package/dist/workflow.d.ts +3 -3
  68. package/dist/workflow.js +15022 -359
  69. package/dist/workflow.js.map +1 -1
  70. package/package.json +10 -37
  71. package/src/adapters/thread/anthropic/activities.ts +1 -1
  72. package/src/adapters/thread/anthropic/fork-transform.test.ts +17 -11
  73. package/src/adapters/thread/anthropic/model-invoker.test.ts +4 -3
  74. package/src/adapters/thread/anthropic/model-invoker.ts +1 -1
  75. package/src/adapters/thread/anthropic/thread-manager.test.ts +2 -2
  76. package/src/adapters/thread/anthropic/thread-manager.ts +1 -1
  77. package/src/adapters/thread/google-genai/activities.ts +1 -1
  78. package/src/adapters/thread/google-genai/fork-transform.test.ts +17 -11
  79. package/src/adapters/thread/google-genai/model-invoker.test.ts +337 -0
  80. package/src/adapters/thread/google-genai/model-invoker.ts +107 -23
  81. package/src/adapters/thread/google-genai/thread-manager.test.ts +2 -2
  82. package/src/adapters/thread/google-genai/thread-manager.ts +1 -1
  83. package/src/adapters/thread/langchain/activities.ts +1 -1
  84. package/src/adapters/thread/langchain/fork-transform.test.ts +17 -11
  85. package/src/adapters/thread/langchain/model-invoker.ts +1 -1
  86. package/src/adapters/thread/langchain/thread-manager.test.ts +2 -2
  87. package/src/adapters/thread/langchain/thread-manager.ts +1 -1
  88. package/src/index.ts +2 -2
  89. package/src/lib/sandbox/capability-types.test.ts +2 -2
  90. package/src/lib/sandbox/manager.ts +2 -6
  91. package/src/lib/sandbox/sandbox.test.ts +1 -1
  92. package/src/lib/sandbox/types.ts +2 -2
  93. package/src/lib/session/session.integration.test.ts +92 -0
  94. package/src/lib/session/session.ts +23 -0
  95. package/src/lib/subagent/handler.ts +23 -0
  96. package/src/lib/subagent/subagent.integration.test.ts +198 -0
  97. package/src/lib/thread/keys.test.ts +9 -9
  98. package/src/lib/thread/keys.ts +1 -1
  99. package/src/lib/thread/manager.test.ts +24 -14
  100. package/src/lib/thread/manager.ts +19 -23
  101. package/src/lib/thread/snapshot.test.ts +51 -43
  102. package/src/lib/thread/snapshot.ts +54 -32
  103. package/src/lib/thread/test-utils.ts +106 -59
  104. package/src/lib/thread/tiered.test.ts +1 -1
  105. package/src/lib/thread/types.ts +2 -2
  106. package/src/lib/tool-router/router.integration.test.ts +44 -0
  107. package/src/lib/tool-router/router.ts +149 -33
  108. package/src/lib/tool-router/types.ts +23 -0
  109. package/src/lib/workflow.ts +49 -0
  110. package/src/{adapters/sandbox/inmemory/proxy.ts → test-utils/in-memory-sandbox-proxy.ts} +5 -16
  111. package/src/{adapters/sandbox/inmemory/index.ts → test-utils/in-memory-sandbox.ts} +11 -3
  112. package/src/tools/bash/bash.test.ts +1 -1
  113. package/src/tools/edit/handler.test.ts +1 -1
  114. package/tsup.config.ts +2 -4
  115. package/dist/adapters/sandbox/inmemory/index.cjs +0 -214
  116. package/dist/adapters/sandbox/inmemory/index.cjs.map +0 -1
  117. package/dist/adapters/sandbox/inmemory/index.d.cts +0 -40
  118. package/dist/adapters/sandbox/inmemory/index.d.ts +0 -40
  119. package/dist/adapters/sandbox/inmemory/index.js +0 -211
  120. package/dist/adapters/sandbox/inmemory/index.js.map +0 -1
  121. package/dist/adapters/sandbox/inmemory/workflow.cjs +0 -36
  122. package/dist/adapters/sandbox/inmemory/workflow.cjs.map +0 -1
  123. package/dist/adapters/sandbox/inmemory/workflow.d.cts +0 -27
  124. package/dist/adapters/sandbox/inmemory/workflow.d.ts +0 -27
  125. package/dist/adapters/sandbox/inmemory/workflow.js +0 -34
  126. package/dist/adapters/sandbox/inmemory/workflow.js.map +0 -1
package/dist/index.d.cts CHANGED
@@ -1,21 +1,86 @@
1
- import { B as BashArgs, F as FileEditArgs, a as FileMultiEditArgs, G as GlobArgs, b as FileReadArgs, c as FileWriteArgs } from './workflow-DVNPR7eX.cjs';
2
- export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, d as FileTreeAccessor, e as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, f as SessionStartedEvent, g as SubagentArgs, T as THREAD_TTL_SECONDS, h as TaskCreateArgs, i as TaskGetArgs, j as TaskListArgs, k as TaskUpdateArgs, l as ToolExecutedEvent, m as TurnCompletedEvent, W as WorkflowConfig, n as WorkflowInput, o as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, p as applyVirtualTreeMutations, q as askUserQuestionTool, r as bashTool, s as composeHooks, t as createAgentStateManager, u as createAskUserQuestionHandler, v as createBashToolDescription, w as createObservabilityHooks, x as createReadSkillHandler, y as createReadSkillTool, z as createSession, C as createTaskCreateHandler, E as createTaskGetHandler, H as createTaskListHandler, I as createTaskUpdateHandler, J as createToolRouter, K as defineSubagent, L as defineSubagentWorkflow, M as defineTool, N as defineWorkflow, P as editTool, Q as filesWithMimeType, U as formatVirtualFileTree, V as getShortId, X as getThreadDedupKey, Y as getThreadListKey, _ as getThreadMetaKey, $ as getThreadStateKey, a0 as globTool, a1 as grepTool, a2 as hasDirectory, a3 as hasFileWithMimeType, a4 as hasNoOtherToolCalls, a5 as multiEditTool, a6 as parseSkillFile, a7 as proxyRunAgent, a8 as proxyVirtualFsOps, a9 as readFileTool, aa as taskCreateTool, ab as taskGetTool, ac as taskListTool, ad as taskUpdateTool, ae as writeFileTool } from './workflow-DVNPR7eX.cjs';
3
- import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-DWeyCTYK.cjs';
4
- export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-DWeyCTYK.cjs';
5
- import { b as Sandbox, c as SandboxFileSystem, a as SandboxCreateOptions, h as SandboxCapability, d as SandboxProvider, g as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-CJ7tCdl6.cjs';
6
- export { i as ExecOptions, e as SandboxCapabilities, f as SandboxCreateResult, j as SandboxNotFoundError, k as SandboxNotSupportedError, S as SandboxOps } from './types-CJ7tCdl6.cjs';
1
+ import { B as BashArgs, F as FileEditArgs, a as FileMultiEditArgs, G as GlobArgs, b as FileReadArgs, c as FileWriteArgs } from './workflow-B3oTe2_D.cjs';
2
+ export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, d as FileTreeAccessor, e as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, f as SessionStartedEvent, g as SubagentArgs, T as THREAD_TTL_SECONDS, h as TaskCreateArgs, i as TaskGetArgs, j as TaskListArgs, k as TaskUpdateArgs, l as ToolExecutedEvent, m as TurnCompletedEvent, W as WorkflowConfig, n as WorkflowInput, o as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, p as applyVirtualTreeMutations, q as askUserQuestionTool, r as bashTool, s as composeHooks, t as createAgentStateManager, u as createAskUserQuestionHandler, v as createBashToolDescription, w as createObservabilityHooks, x as createReadSkillHandler, y as createReadSkillTool, z as createSession, C as createTaskCreateHandler, E as createTaskGetHandler, H as createTaskListHandler, I as createTaskUpdateHandler, J as createToolRouter, K as defineSubagent, L as defineSubagentWorkflow, M as defineTool, N as defineWorkflow, P as editTool, Q as filesWithMimeType, U as formatVirtualFileTree, V as getShortId, X as getThreadDedupKey, Y as getThreadListKey, _ as getThreadMetaKey, $ as getThreadStateKey, a0 as globTool, a1 as grepTool, a2 as hasDirectory, a3 as hasFileWithMimeType, a4 as hasNoOtherToolCalls, a5 as multiEditTool, a6 as parseSkillFile, a7 as proxyRunAgent, a8 as proxyVirtualFsOps, a9 as readFileTool, aa as taskCreateTool, ab as taskGetTool, ac as taskListTool, ad as taskUpdateTool, ae as writeFileTool } from './workflow-B3oTe2_D.cjs';
3
+ import { B as BaseAgentState, R as RouterContext, e as RunAgentConfig, J as JsonValue, c as ToolHandlerResponse, d as ActivityToolHandler, f as ToolResultConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-DZnUqCAP.cjs';
4
+ export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-DZnUqCAP.cjs';
5
+ import { e as Sandbox, d as SandboxFileSystem, f as SandboxCreateOptions, h as SandboxCapability, S as SandboxProvider, g as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-D8W5TnSa.cjs';
6
+ export { i as ExecOptions, a as SandboxCapabilities, b as SandboxCreateResult, j as SandboxNotFoundError, k as SandboxNotSupportedError, c as SandboxOps } from './types-D8W5TnSa.cjs';
7
7
  import { WorkflowClient } from '@temporalio/client';
8
- import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-DDLPnxBh.cjs';
9
- export { P as ProviderThreadManager } from './types-DDLPnxBh.cjs';
10
- import { C as ColdThreadStore, T as ThreadSnapshot } from './cold-store-UL13Sstw.cjs';
11
- export { S as S3ColdStoreConfig, a as S3LikeClient, c as createS3ColdStore } from './cold-store-UL13Sstw.cjs';
12
- import Redis from 'ioredis';
8
+ import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-d2RvEP6v.cjs';
9
+ export { P as ProviderThreadManager } from './types-d2RvEP6v.cjs';
10
+ import { C as ColdThreadStore, T as ThreadSnapshot } from './cold-store-C0uvYTSi.cjs';
11
+ export { S as S3ColdStoreConfig, a as S3LikeClient, c as createS3ColdStore } from './cold-store-C0uvYTSi.cjs';
12
+ import { RedisClientType } from 'redis';
13
13
  import 'zod';
14
14
  import '@temporalio/common';
15
15
  import '@temporalio/workflow';
16
16
  import '@temporalio/common/lib/interfaces';
17
17
  import '@aws-sdk/client-s3';
18
18
 
19
+ /**
20
+ * Safely retrieve Temporal activity heartbeat and cancellation signal.
21
+ * Returns empty object when called outside a Temporal activity (e.g. tests).
22
+ */
23
+ declare function getActivityContext(): {
24
+ heartbeat?: () => void;
25
+ signal?: AbortSignal;
26
+ };
27
+ /**
28
+ * Query the parent workflow's state from within an activity.
29
+ * Resolves the workflow handle from the current activity context.
30
+ */
31
+ declare function queryParentWorkflowState<T>(client: WorkflowClient): Promise<T>;
32
+ /**
33
+ * Wraps a handler into a scope-prefixed `RunAgentActivity` by auto-fetching
34
+ * the parent workflow's agent state before each invocation.
35
+ *
36
+ * Returns a `Record` with a single key `run<Scope>` so it can be spread
37
+ * into the activities object alongside adapter activities.
38
+ *
39
+ * @param scope - Workflow scope used to derive the activity name.
40
+ * `"myAgentWorkflow"` produces `{ runMyAgentWorkflow: fn }`.
41
+ *
42
+ * @example
43
+ * ```typescript
44
+ * import { createRunAgentActivity } from 'zeitlich';
45
+ *
46
+ * return {
47
+ * ...adapter.createActivities("myAgentWorkflow"),
48
+ * ...createRunAgentActivity(client, adapter.invoker, "myAgentWorkflow"),
49
+ * };
50
+ * ```
51
+ */
52
+ declare function createRunAgentActivity<R, S extends BaseAgentState = BaseAgentState>(client: WorkflowClient, handler: (config: RunAgentConfig & {
53
+ state: S;
54
+ }) => Promise<R>, scope: string): Record<string, (config: RunAgentConfig) => Promise<R>>;
55
+ /**
56
+ * Context injected into tool handlers created via {@link withParentWorkflowState}.
57
+ */
58
+ interface AgentStateContext<S extends BaseAgentState = BaseAgentState> extends RouterContext {
59
+ state: S;
60
+ }
61
+ /**
62
+ * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the
63
+ * parent workflow's agent state before each invocation.
64
+ *
65
+ * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)
66
+ *
67
+ * @example
68
+ * ```typescript
69
+ * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';
70
+ *
71
+ * // With custom state:
72
+ * interface MyState extends BaseAgentState { customField: string }
73
+ * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(
74
+ * client,
75
+ * async (args, ctx) => {
76
+ * console.log(ctx.state.customField);
77
+ * return { toolResponse: 'done', data: null };
78
+ * },
79
+ * );
80
+ * ```
81
+ */
82
+ declare function withParentWorkflowState<TArgs, TResult, S extends BaseAgentState = BaseAgentState, TToolResponse = JsonValue>(client: WorkflowClient, handler: (args: TArgs, context: AgentStateContext<S>) => Promise<ToolHandlerResponse<TResult, TToolResponse>>): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse>;
83
+
19
84
  /**
20
85
  * Wraps a tool handler to automatically append its result directly to the
21
86
  * thread and sets `resultAppended: true` on the response.
@@ -126,71 +191,6 @@ declare function withSandbox<TArgs, TResult, TSandbox extends Sandbox = Sandbox,
126
191
  sandboxId: string;
127
192
  }) => Promise<ToolHandlerResponse<TResult, TToolResponse>>, options?: WithSandboxOptions): ActivityToolHandler<TArgs, TResult | null, RouterContext, TToolResponse | string>;
128
193
 
129
- /**
130
- * Safely retrieve Temporal activity heartbeat and cancellation signal.
131
- * Returns empty object when called outside a Temporal activity (e.g. tests).
132
- */
133
- declare function getActivityContext(): {
134
- heartbeat?: () => void;
135
- signal?: AbortSignal;
136
- };
137
- /**
138
- * Query the parent workflow's state from within an activity.
139
- * Resolves the workflow handle from the current activity context.
140
- */
141
- declare function queryParentWorkflowState<T>(client: WorkflowClient): Promise<T>;
142
- /**
143
- * Wraps a handler into a scope-prefixed `RunAgentActivity` by auto-fetching
144
- * the parent workflow's agent state before each invocation.
145
- *
146
- * Returns a `Record` with a single key `run<Scope>` so it can be spread
147
- * into the activities object alongside adapter activities.
148
- *
149
- * @param scope - Workflow scope used to derive the activity name.
150
- * `"myAgentWorkflow"` produces `{ runMyAgentWorkflow: fn }`.
151
- *
152
- * @example
153
- * ```typescript
154
- * import { createRunAgentActivity } from 'zeitlich';
155
- *
156
- * return {
157
- * ...adapter.createActivities("myAgentWorkflow"),
158
- * ...createRunAgentActivity(client, adapter.invoker, "myAgentWorkflow"),
159
- * };
160
- * ```
161
- */
162
- declare function createRunAgentActivity<R, S extends BaseAgentState = BaseAgentState>(client: WorkflowClient, handler: (config: RunAgentConfig & {
163
- state: S;
164
- }) => Promise<R>, scope: string): Record<string, (config: RunAgentConfig) => Promise<R>>;
165
- /**
166
- * Context injected into tool handlers created via {@link withParentWorkflowState}.
167
- */
168
- interface AgentStateContext<S extends BaseAgentState = BaseAgentState> extends RouterContext {
169
- state: S;
170
- }
171
- /**
172
- * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the
173
- * parent workflow's agent state before each invocation.
174
- *
175
- * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)
176
- *
177
- * @example
178
- * ```typescript
179
- * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';
180
- *
181
- * // With custom state:
182
- * interface MyState extends BaseAgentState { customField: string }
183
- * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(
184
- * client,
185
- * async (args, ctx) => {
186
- * console.log(ctx.state.customField);
187
- * return { toolResponse: 'done', data: null };
188
- * },
189
- * );
190
- * ```
191
- */
192
- declare function withParentWorkflowState<TArgs, TResult, S extends BaseAgentState = BaseAgentState, TToolResponse = JsonValue>(client: WorkflowClient, handler: (args: TArgs, context: AgentStateContext<S>) => Promise<ToolHandlerResponse<TResult, TToolResponse>>): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse>;
193
-
194
194
  /**
195
195
  * Loads skills from a directory following the agentskills.io layout:
196
196
  *
@@ -314,7 +314,7 @@ declare function createTieredThreadManager<T>(config: TieredThreadManagerConfig<
314
314
 
315
315
  /** Inputs shared by every snapshot operation. */
316
316
  interface SnapshotCommon {
317
- redis: Redis;
317
+ redis: RedisClientType;
318
318
  threadKey: string;
319
319
  threadId: string;
320
320
  }
@@ -424,12 +424,12 @@ interface SandboxManagerHooks<TOptions extends SandboxCreateOptions = SandboxCre
424
424
  *
425
425
  * @example
426
426
  * ```typescript
427
- * const manager = new SandboxManager(new InMemorySandboxProvider());
427
+ * const manager = new SandboxManager(new DaytonaSandboxProvider(config));
428
428
  * const activities = {
429
429
  * ...manager.createActivities("CodingAgent"),
430
430
  * bashHandler: withSandbox(manager, bashHandler),
431
431
  * };
432
- * // registers: inMemoryCodingAgentCreateSandbox, …
432
+ * // registers: daytonaCodingAgentCreateSandbox, …
433
433
  * ```
434
434
  *
435
435
  * @example
@@ -524,10 +524,6 @@ declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCrea
524
524
  *
525
525
  * @example
526
526
  * ```typescript
527
- * const manager = new SandboxManager(new InMemorySandboxProvider());
528
- * manager.createActivities("CodingAgent");
529
- * // registers: inMemoryCodingAgentCreateSandbox, inMemoryCodingAgentDestroySandbox, …
530
- *
531
527
  * const dmgr = new SandboxManager(new DaytonaSandboxProvider(config));
532
528
  * dmgr.createActivities("CodingAgent");
533
529
  * // registers: daytonaCodingAgentCreateSandbox, daytonaCodingAgentDestroySandbox
package/dist/index.d.ts CHANGED
@@ -1,21 +1,86 @@
1
- import { B as BashArgs, F as FileEditArgs, a as FileMultiEditArgs, G as GlobArgs, b as FileReadArgs, c as FileWriteArgs } from './workflow-DdaU7_j4.js';
2
- export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, d as FileTreeAccessor, e as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, f as SessionStartedEvent, g as SubagentArgs, T as THREAD_TTL_SECONDS, h as TaskCreateArgs, i as TaskGetArgs, j as TaskListArgs, k as TaskUpdateArgs, l as ToolExecutedEvent, m as TurnCompletedEvent, W as WorkflowConfig, n as WorkflowInput, o as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, p as applyVirtualTreeMutations, q as askUserQuestionTool, r as bashTool, s as composeHooks, t as createAgentStateManager, u as createAskUserQuestionHandler, v as createBashToolDescription, w as createObservabilityHooks, x as createReadSkillHandler, y as createReadSkillTool, z as createSession, C as createTaskCreateHandler, E as createTaskGetHandler, H as createTaskListHandler, I as createTaskUpdateHandler, J as createToolRouter, K as defineSubagent, L as defineSubagentWorkflow, M as defineTool, N as defineWorkflow, P as editTool, Q as filesWithMimeType, U as formatVirtualFileTree, V as getShortId, X as getThreadDedupKey, Y as getThreadListKey, _ as getThreadMetaKey, $ as getThreadStateKey, a0 as globTool, a1 as grepTool, a2 as hasDirectory, a3 as hasFileWithMimeType, a4 as hasNoOtherToolCalls, a5 as multiEditTool, a6 as parseSkillFile, a7 as proxyRunAgent, a8 as proxyVirtualFsOps, a9 as readFileTool, aa as taskCreateTool, ab as taskGetTool, ac as taskListTool, ad as taskUpdateTool, ae as writeFileTool } from './workflow-DdaU7_j4.js';
3
- import { R as RouterContext, e as ToolResultConfig, d as ActivityToolHandler, J as JsonValue, c as ToolHandlerResponse, B as BaseAgentState, f as RunAgentConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-DwBYd0ij.js';
4
- export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-DwBYd0ij.js';
5
- import { b as Sandbox, c as SandboxFileSystem, a as SandboxCreateOptions, h as SandboxCapability, d as SandboxProvider, g as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-CJ7tCdl6.js';
6
- export { i as ExecOptions, e as SandboxCapabilities, f as SandboxCreateResult, j as SandboxNotFoundError, k as SandboxNotSupportedError, S as SandboxOps } from './types-CJ7tCdl6.js';
1
+ import { B as BashArgs, F as FileEditArgs, a as FileMultiEditArgs, G as GlobArgs, b as FileReadArgs, c as FileWriteArgs } from './workflow-Bkzg0cjB.js';
2
+ export { A as AskUserQuestionArgs, D as DEFAULT_SUBAGENT_WORKFLOW_RUN_TIMEOUT, d as FileTreeAccessor, e as GrepArgs, O as ObservabilityHooks, R as ReadSkillArgs, S as SessionEndedEvent, f as SessionStartedEvent, g as SubagentArgs, T as THREAD_TTL_SECONDS, h as TaskCreateArgs, i as TaskGetArgs, j as TaskListArgs, k as TaskUpdateArgs, l as ToolExecutedEvent, m as TurnCompletedEvent, W as WorkflowConfig, n as WorkflowInput, o as WorkflowSessionInput, Z as ZeitlichObservabilitySinks, p as applyVirtualTreeMutations, q as askUserQuestionTool, r as bashTool, s as composeHooks, t as createAgentStateManager, u as createAskUserQuestionHandler, v as createBashToolDescription, w as createObservabilityHooks, x as createReadSkillHandler, y as createReadSkillTool, z as createSession, C as createTaskCreateHandler, E as createTaskGetHandler, H as createTaskListHandler, I as createTaskUpdateHandler, J as createToolRouter, K as defineSubagent, L as defineSubagentWorkflow, M as defineTool, N as defineWorkflow, P as editTool, Q as filesWithMimeType, U as formatVirtualFileTree, V as getShortId, X as getThreadDedupKey, Y as getThreadListKey, _ as getThreadMetaKey, $ as getThreadStateKey, a0 as globTool, a1 as grepTool, a2 as hasDirectory, a3 as hasFileWithMimeType, a4 as hasNoOtherToolCalls, a5 as multiEditTool, a6 as parseSkillFile, a7 as proxyRunAgent, a8 as proxyVirtualFsOps, a9 as readFileTool, aa as taskCreateTool, ab as taskGetTool, ac as taskListTool, ad as taskUpdateTool, ae as writeFileTool } from './workflow-Bkzg0cjB.js';
3
+ import { B as BaseAgentState, R as RouterContext, e as RunAgentConfig, J as JsonValue, c as ToolHandlerResponse, d as ActivityToolHandler, f as ToolResultConfig, g as SkillProvider, h as SkillMetadata, i as Skill, F as FileEntryMetadata, j as FileResolver, V as VirtualFsContext, k as TreeMutation, l as PrefixedVirtualFsOps } from './types-YNesmGKV.js';
4
+ export { m as AgentConfig, n as AgentFile, A as AgentResponse, o as AgentState, p as AgentStateManager, q as AgentStatus, r as AppendToolResultFn, s as FileEntry, H as Hooks, I as InferToolResults, t as JsonPrimitive, u as JsonSerializable, a as ModelInvoker, M as ModelInvokerConfig, v as ParsedToolCall, w as ParsedToolCallUnion, P as PersistedThreadState, x as PostHumanMessageAppendHook, y as PostHumanMessageAppendHookContext, z as PostToolUseFailureHook, C as PostToolUseFailureHookContext, D as PostToolUseFailureHookResult, E as PostToolUseHook, G as PostToolUseHookContext, K as PreHumanMessageAppendHook, L as PreHumanMessageAppendHookContext, N as PreToolUseHook, O as PreToolUseHookContext, Q as PreToolUseHookResult, b as PrefixedThreadOps, U as ProcessToolCallsContext, W as ProcessToolCallsResult, X as RawToolCall, Y as RewindSignal, Z as RunAgentActivity, _ as SandboxInit, $ as SandboxShutdown, S as ScopedPrefix, a0 as SerializableToolDefinition, a1 as SessionConfig, a2 as SessionEndHook, a3 as SessionEndHookContext, a4 as SessionExitReason, a5 as SessionRequiredCaps, a6 as SessionResult, a7 as SessionStartHook, a8 as SessionStartHookContext, a9 as SubagentChildWorkflowOptions, aa as SubagentConfig, ab as SubagentContinuationCaps, ac as SubagentDefinition, ad as SubagentFnResult, ae as SubagentHandlerResponse, af as SubagentHooks, ag as SubagentSandboxConfig, ah as SubagentSandboxShutdown, ai as SubagentSessionInput, aj as SubagentWorkflow, ak as SubagentWorkflowInput, al as TaskStatus, am as ThreadInit, T as ThreadOps, an as TokenUsage, ao as ToolArgs, ap as ToolCallResult, aq as ToolCallResultUnion, ar as ToolDefinition, as as ToolHandler, at as ToolHooks, au as ToolMap, av as ToolNames, aw as ToolResult, ax as ToolRouter, ay as ToolRouterHooks, az as ToolWithHandler, aA as VirtualFileSystem, aB as VirtualFileTree, aC as VirtualFsOps, aD as VirtualFsState, aE as WorkflowTask, aF as ZeitlichSession, aG as isTerminalStatus } from './types-YNesmGKV.js';
5
+ import { e as Sandbox, d as SandboxFileSystem, f as SandboxCreateOptions, h as SandboxCapability, S as SandboxProvider, g as SandboxSnapshot, P as PrefixedSandboxOps, F as FileStat, D as DirentEntry, E as ExecResult } from './types-D8W5TnSa.js';
6
+ export { i as ExecOptions, a as SandboxCapabilities, b as SandboxCreateResult, j as SandboxNotFoundError, k as SandboxNotSupportedError, c as SandboxOps } from './types-D8W5TnSa.js';
7
7
  import { WorkflowClient } from '@temporalio/client';
8
- import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-DF4wzWQG.js';
9
- export { P as ProviderThreadManager } from './types-DF4wzWQG.js';
10
- import { C as ColdThreadStore, T as ThreadSnapshot } from './cold-store-aD4TSKlU.js';
11
- export { S as S3ColdStoreConfig, a as S3LikeClient, c as createS3ColdStore } from './cold-store-aD4TSKlU.js';
12
- import Redis from 'ioredis';
8
+ import { a as ThreadManagerConfig, B as BaseThreadManager } from './types-CbPnU4RM.js';
9
+ export { P as ProviderThreadManager } from './types-CbPnU4RM.js';
10
+ import { C as ColdThreadStore, T as ThreadSnapshot } from './cold-store-CCnZYWjx.js';
11
+ export { S as S3ColdStoreConfig, a as S3LikeClient, c as createS3ColdStore } from './cold-store-CCnZYWjx.js';
12
+ import { RedisClientType } from 'redis';
13
13
  import 'zod';
14
14
  import '@temporalio/common';
15
15
  import '@temporalio/workflow';
16
16
  import '@temporalio/common/lib/interfaces';
17
17
  import '@aws-sdk/client-s3';
18
18
 
19
+ /**
20
+ * Safely retrieve Temporal activity heartbeat and cancellation signal.
21
+ * Returns empty object when called outside a Temporal activity (e.g. tests).
22
+ */
23
+ declare function getActivityContext(): {
24
+ heartbeat?: () => void;
25
+ signal?: AbortSignal;
26
+ };
27
+ /**
28
+ * Query the parent workflow's state from within an activity.
29
+ * Resolves the workflow handle from the current activity context.
30
+ */
31
+ declare function queryParentWorkflowState<T>(client: WorkflowClient): Promise<T>;
32
+ /**
33
+ * Wraps a handler into a scope-prefixed `RunAgentActivity` by auto-fetching
34
+ * the parent workflow's agent state before each invocation.
35
+ *
36
+ * Returns a `Record` with a single key `run<Scope>` so it can be spread
37
+ * into the activities object alongside adapter activities.
38
+ *
39
+ * @param scope - Workflow scope used to derive the activity name.
40
+ * `"myAgentWorkflow"` produces `{ runMyAgentWorkflow: fn }`.
41
+ *
42
+ * @example
43
+ * ```typescript
44
+ * import { createRunAgentActivity } from 'zeitlich';
45
+ *
46
+ * return {
47
+ * ...adapter.createActivities("myAgentWorkflow"),
48
+ * ...createRunAgentActivity(client, adapter.invoker, "myAgentWorkflow"),
49
+ * };
50
+ * ```
51
+ */
52
+ declare function createRunAgentActivity<R, S extends BaseAgentState = BaseAgentState>(client: WorkflowClient, handler: (config: RunAgentConfig & {
53
+ state: S;
54
+ }) => Promise<R>, scope: string): Record<string, (config: RunAgentConfig) => Promise<R>>;
55
+ /**
56
+ * Context injected into tool handlers created via {@link withParentWorkflowState}.
57
+ */
58
+ interface AgentStateContext<S extends BaseAgentState = BaseAgentState> extends RouterContext {
59
+ state: S;
60
+ }
61
+ /**
62
+ * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the
63
+ * parent workflow's agent state before each invocation.
64
+ *
65
+ * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)
66
+ *
67
+ * @example
68
+ * ```typescript
69
+ * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';
70
+ *
71
+ * // With custom state:
72
+ * interface MyState extends BaseAgentState { customField: string }
73
+ * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(
74
+ * client,
75
+ * async (args, ctx) => {
76
+ * console.log(ctx.state.customField);
77
+ * return { toolResponse: 'done', data: null };
78
+ * },
79
+ * );
80
+ * ```
81
+ */
82
+ declare function withParentWorkflowState<TArgs, TResult, S extends BaseAgentState = BaseAgentState, TToolResponse = JsonValue>(client: WorkflowClient, handler: (args: TArgs, context: AgentStateContext<S>) => Promise<ToolHandlerResponse<TResult, TToolResponse>>): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse>;
83
+
19
84
  /**
20
85
  * Wraps a tool handler to automatically append its result directly to the
21
86
  * thread and sets `resultAppended: true` on the response.
@@ -126,71 +191,6 @@ declare function withSandbox<TArgs, TResult, TSandbox extends Sandbox = Sandbox,
126
191
  sandboxId: string;
127
192
  }) => Promise<ToolHandlerResponse<TResult, TToolResponse>>, options?: WithSandboxOptions): ActivityToolHandler<TArgs, TResult | null, RouterContext, TToolResponse | string>;
128
193
 
129
- /**
130
- * Safely retrieve Temporal activity heartbeat and cancellation signal.
131
- * Returns empty object when called outside a Temporal activity (e.g. tests).
132
- */
133
- declare function getActivityContext(): {
134
- heartbeat?: () => void;
135
- signal?: AbortSignal;
136
- };
137
- /**
138
- * Query the parent workflow's state from within an activity.
139
- * Resolves the workflow handle from the current activity context.
140
- */
141
- declare function queryParentWorkflowState<T>(client: WorkflowClient): Promise<T>;
142
- /**
143
- * Wraps a handler into a scope-prefixed `RunAgentActivity` by auto-fetching
144
- * the parent workflow's agent state before each invocation.
145
- *
146
- * Returns a `Record` with a single key `run<Scope>` so it can be spread
147
- * into the activities object alongside adapter activities.
148
- *
149
- * @param scope - Workflow scope used to derive the activity name.
150
- * `"myAgentWorkflow"` produces `{ runMyAgentWorkflow: fn }`.
151
- *
152
- * @example
153
- * ```typescript
154
- * import { createRunAgentActivity } from 'zeitlich';
155
- *
156
- * return {
157
- * ...adapter.createActivities("myAgentWorkflow"),
158
- * ...createRunAgentActivity(client, adapter.invoker, "myAgentWorkflow"),
159
- * };
160
- * ```
161
- */
162
- declare function createRunAgentActivity<R, S extends BaseAgentState = BaseAgentState>(client: WorkflowClient, handler: (config: RunAgentConfig & {
163
- state: S;
164
- }) => Promise<R>, scope: string): Record<string, (config: RunAgentConfig) => Promise<R>>;
165
- /**
166
- * Context injected into tool handlers created via {@link withParentWorkflowState}.
167
- */
168
- interface AgentStateContext<S extends BaseAgentState = BaseAgentState> extends RouterContext {
169
- state: S;
170
- }
171
- /**
172
- * Wraps a tool handler into an `ActivityToolHandler` by auto-fetching the
173
- * parent workflow's agent state before each invocation.
174
- *
175
- * @typeParam S - Custom agent state type (defaults to `BaseAgentState`)
176
- *
177
- * @example
178
- * ```typescript
179
- * import { withParentWorkflowState, type AgentStateContext } from 'zeitlich';
180
- *
181
- * // With custom state:
182
- * interface MyState extends BaseAgentState { customField: string }
183
- * const myHandler = withParentWorkflowState<MyArgs, MyResult, MyState>(
184
- * client,
185
- * async (args, ctx) => {
186
- * console.log(ctx.state.customField);
187
- * return { toolResponse: 'done', data: null };
188
- * },
189
- * );
190
- * ```
191
- */
192
- declare function withParentWorkflowState<TArgs, TResult, S extends BaseAgentState = BaseAgentState, TToolResponse = JsonValue>(client: WorkflowClient, handler: (args: TArgs, context: AgentStateContext<S>) => Promise<ToolHandlerResponse<TResult, TToolResponse>>): ActivityToolHandler<TArgs, TResult, RouterContext, TToolResponse>;
193
-
194
194
  /**
195
195
  * Loads skills from a directory following the agentskills.io layout:
196
196
  *
@@ -314,7 +314,7 @@ declare function createTieredThreadManager<T>(config: TieredThreadManagerConfig<
314
314
 
315
315
  /** Inputs shared by every snapshot operation. */
316
316
  interface SnapshotCommon {
317
- redis: Redis;
317
+ redis: RedisClientType;
318
318
  threadKey: string;
319
319
  threadId: string;
320
320
  }
@@ -424,12 +424,12 @@ interface SandboxManagerHooks<TOptions extends SandboxCreateOptions = SandboxCre
424
424
  *
425
425
  * @example
426
426
  * ```typescript
427
- * const manager = new SandboxManager(new InMemorySandboxProvider());
427
+ * const manager = new SandboxManager(new DaytonaSandboxProvider(config));
428
428
  * const activities = {
429
429
  * ...manager.createActivities("CodingAgent"),
430
430
  * bashHandler: withSandbox(manager, bashHandler),
431
431
  * };
432
- * // registers: inMemoryCodingAgentCreateSandbox, …
432
+ * // registers: daytonaCodingAgentCreateSandbox, …
433
433
  * ```
434
434
  *
435
435
  * @example
@@ -524,10 +524,6 @@ declare class SandboxManager<TOptions extends SandboxCreateOptions = SandboxCrea
524
524
  *
525
525
  * @example
526
526
  * ```typescript
527
- * const manager = new SandboxManager(new InMemorySandboxProvider());
528
- * manager.createActivities("CodingAgent");
529
- * // registers: inMemoryCodingAgentCreateSandbox, inMemoryCodingAgentDestroySandbox, …
530
- *
531
527
  * const dmgr = new SandboxManager(new DaytonaSandboxProvider(config));
532
528
  * dmgr.createActivities("CodingAgent");
533
529
  * // registers: daytonaCodingAgentCreateSandbox, daytonaCodingAgentDestroySandbox