zeitlich 0.2.49 → 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.
- package/README.md +26 -23
- package/dist/{activities-zG_FBoY2.d.ts → activities-IuOIvPHO.d.ts} +6 -6
- package/dist/{activities-7OcT_vdR.d.cts → activities-cIlq1y1y.d.cts} +6 -6
- package/dist/adapters/sandbox/daytona/index.cjs.map +1 -1
- package/dist/adapters/sandbox/daytona/index.d.cts +3 -3
- package/dist/adapters/sandbox/daytona/index.d.ts +3 -3
- package/dist/adapters/sandbox/daytona/index.js.map +1 -1
- package/dist/adapters/sandbox/daytona/workflow.d.cts +2 -2
- package/dist/adapters/sandbox/daytona/workflow.d.ts +2 -2
- package/dist/adapters/sandbox/e2b/index.cjs.map +1 -1
- package/dist/adapters/sandbox/e2b/index.d.cts +1 -1
- package/dist/adapters/sandbox/e2b/index.d.ts +1 -1
- package/dist/adapters/sandbox/e2b/index.js.map +1 -1
- package/dist/adapters/sandbox/e2b/workflow.d.cts +1 -1
- package/dist/adapters/sandbox/e2b/workflow.d.ts +1 -1
- package/dist/adapters/thread/anthropic/index.cjs +45 -42
- package/dist/adapters/thread/anthropic/index.cjs.map +1 -1
- package/dist/adapters/thread/anthropic/index.d.cts +10 -10
- package/dist/adapters/thread/anthropic/index.d.ts +10 -10
- package/dist/adapters/thread/anthropic/index.js +45 -42
- package/dist/adapters/thread/anthropic/index.js.map +1 -1
- package/dist/adapters/thread/anthropic/workflow.d.cts +7 -7
- package/dist/adapters/thread/anthropic/workflow.d.ts +7 -7
- package/dist/adapters/thread/google-genai/index.cjs +117 -54
- package/dist/adapters/thread/google-genai/index.cjs.map +1 -1
- package/dist/adapters/thread/google-genai/index.d.cts +27 -23
- package/dist/adapters/thread/google-genai/index.d.ts +27 -23
- package/dist/adapters/thread/google-genai/index.js +117 -54
- package/dist/adapters/thread/google-genai/index.js.map +1 -1
- package/dist/adapters/thread/google-genai/workflow.d.cts +8 -8
- package/dist/adapters/thread/google-genai/workflow.d.ts +8 -8
- package/dist/adapters/thread/langchain/index.cjs +45 -42
- package/dist/adapters/thread/langchain/index.cjs.map +1 -1
- package/dist/adapters/thread/langchain/index.d.cts +10 -10
- package/dist/adapters/thread/langchain/index.d.ts +10 -10
- package/dist/adapters/thread/langchain/index.js +45 -42
- package/dist/adapters/thread/langchain/index.js.map +1 -1
- package/dist/adapters/thread/langchain/workflow.d.cts +7 -7
- package/dist/adapters/thread/langchain/workflow.d.ts +7 -7
- package/dist/{cold-store-CkWoNtMh.d.cts → cold-store-C0uvYTSi.d.cts} +1 -1
- package/dist/{cold-store-DKMAO1Dd.d.ts → cold-store-CCnZYWjx.d.ts} +1 -1
- package/dist/index.cjs +15050 -420
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +79 -83
- package/dist/index.d.ts +79 -83
- package/dist/index.js +15051 -417
- package/dist/index.js.map +1 -1
- package/dist/{proxy-B7CWEV-T.d.cts → proxy-BVznA2_p.d.cts} +1 -1
- package/dist/{proxy-ByFHMVRX.d.ts → proxy-C4J1pNUk.d.ts} +1 -1
- package/dist/{thread-manager-Cibe0X5m.d.cts → thread-manager-BqjzWsP7.d.ts} +4 -4
- package/dist/{thread-manager-B9rtMEVn.d.cts → thread-manager-CzIs47uG.d.cts} +4 -4
- package/dist/{thread-manager-nK-WcFzM.d.ts → thread-manager-Dzl1fHhV.d.cts} +4 -4
- package/dist/{thread-manager-7AW4rhfu.d.ts → thread-manager-SkSWRPRc.d.ts} +4 -4
- package/dist/{types-gVa5XCWD.d.ts → types-BQvXWcft.d.ts} +1 -1
- package/dist/{types-DO4Tkwxo.d.ts → types-CbPnU4RM.d.ts} +3 -3
- package/dist/{types-CJ7tCdl6.d.ts → types-D8W5TnSa.d.cts} +3 -3
- package/dist/{types-CJ7tCdl6.d.cts → types-D8W5TnSa.d.ts} +3 -3
- package/dist/{types-DeVNWqlb.d.ts → types-DZnUqCAP.d.cts} +709 -709
- package/dist/{types-CjY93AWZ.d.cts → types-OEN1xrFg.d.cts} +1 -1
- package/dist/{types-XUUFvrJ9.d.cts → types-YNesmGKV.d.ts} +709 -709
- package/dist/{types-BR-k7h0e.d.cts → types-d2RvEP6v.d.cts} +3 -3
- package/dist/{workflow-uhOIj9D-.d.ts → workflow-B3oTe2_D.d.cts} +34 -3
- package/dist/{workflow-KbGsxpfh.d.cts → workflow-Bkzg0cjB.d.ts} +34 -3
- package/dist/workflow.cjs +15008 -377
- package/dist/workflow.cjs.map +1 -1
- package/dist/workflow.d.cts +3 -3
- package/dist/workflow.d.ts +3 -3
- package/dist/workflow.js +15009 -374
- package/dist/workflow.js.map +1 -1
- package/package.json +10 -37
- package/src/adapters/thread/anthropic/activities.ts +1 -1
- package/src/adapters/thread/anthropic/fork-transform.test.ts +17 -11
- package/src/adapters/thread/anthropic/model-invoker.test.ts +4 -3
- package/src/adapters/thread/anthropic/model-invoker.ts +1 -1
- package/src/adapters/thread/anthropic/thread-manager.test.ts +2 -2
- package/src/adapters/thread/anthropic/thread-manager.ts +1 -1
- package/src/adapters/thread/google-genai/activities.ts +1 -1
- package/src/adapters/thread/google-genai/fork-transform.test.ts +17 -11
- package/src/adapters/thread/google-genai/model-invoker.test.ts +337 -0
- package/src/adapters/thread/google-genai/model-invoker.ts +107 -23
- package/src/adapters/thread/google-genai/thread-manager.test.ts +2 -2
- package/src/adapters/thread/google-genai/thread-manager.ts +1 -1
- package/src/adapters/thread/langchain/activities.ts +1 -1
- package/src/adapters/thread/langchain/fork-transform.test.ts +17 -11
- package/src/adapters/thread/langchain/model-invoker.ts +1 -1
- package/src/adapters/thread/langchain/thread-manager.test.ts +2 -2
- package/src/adapters/thread/langchain/thread-manager.ts +1 -1
- package/src/index.ts +2 -2
- package/src/lib/sandbox/capability-types.test.ts +2 -2
- package/src/lib/sandbox/manager.ts +2 -6
- package/src/lib/sandbox/sandbox.test.ts +1 -1
- package/src/lib/sandbox/types.ts +2 -2
- package/src/lib/session/session.integration.test.ts +92 -0
- package/src/lib/session/session.ts +23 -11
- package/src/lib/thread/keys.test.ts +9 -9
- package/src/lib/thread/keys.ts +1 -1
- package/src/lib/thread/manager.test.ts +24 -14
- package/src/lib/thread/manager.ts +19 -23
- package/src/lib/thread/snapshot.test.ts +51 -43
- package/src/lib/thread/snapshot.ts +54 -32
- package/src/lib/thread/test-utils.ts +106 -59
- package/src/lib/thread/tiered.test.ts +1 -1
- package/src/lib/thread/types.ts +2 -2
- package/src/lib/tool-router/router.integration.test.ts +44 -0
- package/src/lib/tool-router/router.ts +140 -32
- package/src/lib/workflow.ts +49 -0
- package/src/{adapters/sandbox/inmemory/proxy.ts → test-utils/in-memory-sandbox-proxy.ts} +5 -16
- package/src/{adapters/sandbox/inmemory/index.ts → test-utils/in-memory-sandbox.ts} +11 -3
- package/src/tools/bash/bash.test.ts +1 -1
- package/src/tools/edit/handler.test.ts +1 -1
- package/tsup.config.ts +2 -4
- package/dist/adapters/sandbox/inmemory/index.cjs +0 -214
- package/dist/adapters/sandbox/inmemory/index.cjs.map +0 -1
- package/dist/adapters/sandbox/inmemory/index.d.cts +0 -40
- package/dist/adapters/sandbox/inmemory/index.d.ts +0 -40
- package/dist/adapters/sandbox/inmemory/index.js +0 -211
- package/dist/adapters/sandbox/inmemory/index.js.map +0 -1
- package/dist/adapters/sandbox/inmemory/workflow.cjs +0 -36
- package/dist/adapters/sandbox/inmemory/workflow.cjs.map +0 -1
- package/dist/adapters/sandbox/inmemory/workflow.d.cts +0 -27
- package/dist/adapters/sandbox/inmemory/workflow.d.ts +0 -27
- package/dist/adapters/sandbox/inmemory/workflow.js +0 -34
- 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-
|
|
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-
|
|
3
|
-
import {
|
|
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-
|
|
5
|
-
import {
|
|
6
|
-
export { i as ExecOptions,
|
|
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-
|
|
9
|
-
export { P as ProviderThreadManager } from './types-
|
|
10
|
-
import { C as ColdThreadStore, T as ThreadSnapshot } from './cold-store-
|
|
11
|
-
export { S as S3ColdStoreConfig, a as S3LikeClient, c as createS3ColdStore } from './cold-store-
|
|
12
|
-
import
|
|
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:
|
|
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
|
|
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:
|
|
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-
|
|
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-
|
|
3
|
-
import {
|
|
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-
|
|
5
|
-
import {
|
|
6
|
-
export { i as ExecOptions,
|
|
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-
|
|
9
|
-
export { P as ProviderThreadManager } from './types-
|
|
10
|
-
import { C as ColdThreadStore, T as ThreadSnapshot } from './cold-store-
|
|
11
|
-
export { S as S3ColdStoreConfig, a as S3LikeClient, c as createS3ColdStore } from './cold-store-
|
|
12
|
-
import
|
|
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:
|
|
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
|
|
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:
|
|
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
|