@deepagents/experimental 4.3.0 → 6.0.0

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 (70) hide show
  1. package/README.md +24 -9
  2. package/dist/index.js +2613 -167
  3. package/dist/index.js.map +4 -4
  4. package/dist/zukhruf/agent.d.ts +15 -9
  5. package/dist/zukhruf/agent.d.ts.map +1 -1
  6. package/dist/zukhruf/collaboration/agent-tool-context.d.ts +6 -0
  7. package/dist/zukhruf/collaboration/agent-tool-context.d.ts.map +1 -0
  8. package/dist/zukhruf/collaboration/collaboration-tools.d.ts +4 -0
  9. package/dist/zukhruf/collaboration/collaboration-tools.d.ts.map +1 -0
  10. package/dist/zukhruf/collaboration/interrupt-agent.d.ts +234 -0
  11. package/dist/zukhruf/collaboration/interrupt-agent.d.ts.map +1 -0
  12. package/dist/zukhruf/collaboration/list-agents.d.ts +234 -0
  13. package/dist/zukhruf/collaboration/list-agents.d.ts.map +1 -0
  14. package/dist/zukhruf/collaboration/message-tools.d.ts +452 -0
  15. package/dist/zukhruf/collaboration/message-tools.d.ts.map +1 -0
  16. package/dist/zukhruf/collaboration/spawn-agent.d.ts +313 -0
  17. package/dist/zukhruf/collaboration/spawn-agent.d.ts.map +1 -0
  18. package/dist/zukhruf/collaboration/wait-agent.d.ts +253 -0
  19. package/dist/zukhruf/collaboration/wait-agent.d.ts.map +1 -0
  20. package/dist/zukhruf/control-plane/agent-control-plane.d.ts +80 -0
  21. package/dist/zukhruf/control-plane/agent-control-plane.d.ts.map +1 -0
  22. package/dist/zukhruf/control-plane/agent-declaration-registry.d.ts +9 -0
  23. package/dist/zukhruf/control-plane/agent-declaration-registry.d.ts.map +1 -0
  24. package/dist/zukhruf/control-plane/agent-directory.d.ts +22 -0
  25. package/dist/zukhruf/control-plane/agent-directory.d.ts.map +1 -0
  26. package/dist/zukhruf/control-plane/agent-history-forker.d.ts +10 -0
  27. package/dist/zukhruf/control-plane/agent-history-forker.d.ts.map +1 -0
  28. package/dist/zukhruf/control-plane/agent-path.d.ts +15 -0
  29. package/dist/zukhruf/control-plane/agent-path.d.ts.map +1 -0
  30. package/dist/zukhruf/control-plane/agent-status-projector.d.ts +50 -0
  31. package/dist/zukhruf/control-plane/agent-status-projector.d.ts.map +1 -0
  32. package/dist/zukhruf/control-plane/agent-thread.d.ts +31 -0
  33. package/dist/zukhruf/control-plane/agent-thread.d.ts.map +1 -0
  34. package/dist/zukhruf/control-plane/agent-turn-id.d.ts +12 -0
  35. package/dist/zukhruf/control-plane/agent-turn-id.d.ts.map +1 -0
  36. package/dist/zukhruf/control-plane/fork-turns.d.ts +4 -0
  37. package/dist/zukhruf/control-plane/fork-turns.d.ts.map +1 -0
  38. package/dist/zukhruf/index.d.ts +15 -11
  39. package/dist/zukhruf/index.d.ts.map +1 -1
  40. package/dist/zukhruf/index.js +2613 -167
  41. package/dist/zukhruf/index.js.map +4 -4
  42. package/dist/zukhruf/mailbox/coordinator.d.ts +26 -0
  43. package/dist/zukhruf/mailbox/coordinator.d.ts.map +1 -0
  44. package/dist/zukhruf/mailbox/sqlite.store.d.ts +16 -0
  45. package/dist/zukhruf/mailbox/sqlite.store.d.ts.map +1 -0
  46. package/dist/zukhruf/mailbox/store.d.ts +20 -0
  47. package/dist/zukhruf/mailbox/store.d.ts.map +1 -0
  48. package/dist/zukhruf/mailbox/types.d.ts +35 -0
  49. package/dist/zukhruf/mailbox/types.d.ts.map +1 -0
  50. package/dist/zukhruf/multi-agent-v2-config.d.ts +32 -0
  51. package/dist/zukhruf/multi-agent-v2-config.d.ts.map +1 -0
  52. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts +17 -4
  53. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts.map +1 -1
  54. package/dist/zukhruf/queue/turn-queue.d.ts +49 -6
  55. package/dist/zukhruf/queue/turn-queue.d.ts.map +1 -1
  56. package/dist/zukhruf/render-turn.d.ts +9 -0
  57. package/dist/zukhruf/render-turn.d.ts.map +1 -0
  58. package/dist/zukhruf/runtime/agent-runtime.d.ts +64 -0
  59. package/dist/zukhruf/runtime/agent-runtime.d.ts.map +1 -0
  60. package/dist/zukhruf/runtime/agent-turn-executor.d.ts +21 -0
  61. package/dist/zukhruf/runtime/agent-turn-executor.d.ts.map +1 -0
  62. package/dist/zukhruf/runtime/approval-controller.d.ts +45 -0
  63. package/dist/zukhruf/runtime/approval-controller.d.ts.map +1 -0
  64. package/dist/zukhruf/runtime/approval-job-id.d.ts +3 -0
  65. package/dist/zukhruf/runtime/approval-job-id.d.ts.map +1 -0
  66. package/dist/zukhruf/tool.d.ts +18 -6
  67. package/dist/zukhruf/tool.d.ts.map +1 -1
  68. package/package.json +11 -10
  69. package/dist/zukhruf/runtime.d.ts +0 -67
  70. package/dist/zukhruf/runtime.d.ts.map +0 -1
@@ -0,0 +1,313 @@
1
+ import type { AgentToolContext } from './agent-tool-context.ts';
2
+ export declare function createSpawnAgentTool(options?: {
3
+ usageHintText?: string;
4
+ }): ({
5
+ title?: string;
6
+ providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
7
+ metadata?: import("@ai-sdk/provider").JSONObject;
8
+ inputSchema: import("ai").FlexibleSchema<{
9
+ agent_type: string;
10
+ task_name: string;
11
+ message: string;
12
+ fork_turns: string;
13
+ }>;
14
+ contextSchema?: import("ai").FlexibleSchema<AgentToolContext> | undefined;
15
+ needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
16
+ agent_type: string;
17
+ task_name: string;
18
+ message: string;
19
+ fork_turns: string;
20
+ }, NoInfer<AgentToolContext>> | undefined;
21
+ onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
22
+ onInputDelta?: ((options: {
23
+ inputTextDelta: string;
24
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
25
+ onInputAvailable?: ((options: {
26
+ input: {
27
+ agent_type: string;
28
+ task_name: string;
29
+ message: string;
30
+ fork_turns: string;
31
+ };
32
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
33
+ toModelOutput?: ((options: {
34
+ toolCallId: string;
35
+ input: {
36
+ agent_type: string;
37
+ task_name: string;
38
+ message: string;
39
+ fork_turns: string;
40
+ };
41
+ output: NoInfer<{
42
+ task_name: string;
43
+ }>;
44
+ }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
45
+ } & {
46
+ outputSchema?: import("ai").FlexibleSchema<{
47
+ task_name: string;
48
+ }> | undefined;
49
+ execute: import("ai").ToolExecuteFunction<{
50
+ agent_type: string;
51
+ task_name: string;
52
+ message: string;
53
+ fork_turns: string;
54
+ }, {
55
+ task_name: string;
56
+ }, NoInfer<AgentToolContext>>;
57
+ } & {
58
+ description?: string | ((options: {
59
+ context: NoInfer<AgentToolContext>;
60
+ experimental_sandbox?: import("ai").Experimental_SandboxSession;
61
+ }) => string) | undefined;
62
+ strict?: boolean;
63
+ inputExamples?: {
64
+ input: NoInfer<{
65
+ agent_type: string;
66
+ task_name: string;
67
+ message: string;
68
+ fork_turns: string;
69
+ }>;
70
+ }[] | undefined;
71
+ id?: never;
72
+ isProviderExecuted?: never;
73
+ args?: never;
74
+ supportsDeferredResults?: never;
75
+ } & {
76
+ type?: undefined | "function";
77
+ } & {
78
+ execute: import("ai").ToolExecuteFunction<{
79
+ agent_type: string;
80
+ task_name: string;
81
+ message: string;
82
+ fork_turns: string;
83
+ }, {
84
+ task_name: string;
85
+ }, NoInfer<AgentToolContext>>;
86
+ }) | ({
87
+ title?: string;
88
+ providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
89
+ metadata?: import("@ai-sdk/provider").JSONObject;
90
+ inputSchema: import("ai").FlexibleSchema<{
91
+ agent_type: string;
92
+ task_name: string;
93
+ message: string;
94
+ fork_turns: string;
95
+ }>;
96
+ contextSchema?: import("ai").FlexibleSchema<AgentToolContext> | undefined;
97
+ needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
98
+ agent_type: string;
99
+ task_name: string;
100
+ message: string;
101
+ fork_turns: string;
102
+ }, NoInfer<AgentToolContext>> | undefined;
103
+ onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
104
+ onInputDelta?: ((options: {
105
+ inputTextDelta: string;
106
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
107
+ onInputAvailable?: ((options: {
108
+ input: {
109
+ agent_type: string;
110
+ task_name: string;
111
+ message: string;
112
+ fork_turns: string;
113
+ };
114
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
115
+ toModelOutput?: ((options: {
116
+ toolCallId: string;
117
+ input: {
118
+ agent_type: string;
119
+ task_name: string;
120
+ message: string;
121
+ fork_turns: string;
122
+ };
123
+ output: NoInfer<{
124
+ task_name: string;
125
+ }>;
126
+ }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
127
+ } & {
128
+ outputSchema?: import("ai").FlexibleSchema<{
129
+ task_name: string;
130
+ }> | undefined;
131
+ execute: import("ai").ToolExecuteFunction<{
132
+ agent_type: string;
133
+ task_name: string;
134
+ message: string;
135
+ fork_turns: string;
136
+ }, {
137
+ task_name: string;
138
+ }, NoInfer<AgentToolContext>>;
139
+ } & {
140
+ description?: string | ((options: {
141
+ context: NoInfer<AgentToolContext>;
142
+ experimental_sandbox?: import("ai").Experimental_SandboxSession;
143
+ }) => string) | undefined;
144
+ strict?: boolean;
145
+ inputExamples?: {
146
+ input: NoInfer<{
147
+ agent_type: string;
148
+ task_name: string;
149
+ message: string;
150
+ fork_turns: string;
151
+ }>;
152
+ }[] | undefined;
153
+ id?: never;
154
+ isProviderExecuted?: never;
155
+ args?: never;
156
+ supportsDeferredResults?: never;
157
+ } & {
158
+ type: "dynamic";
159
+ } & {
160
+ execute: import("ai").ToolExecuteFunction<{
161
+ agent_type: string;
162
+ task_name: string;
163
+ message: string;
164
+ fork_turns: string;
165
+ }, {
166
+ task_name: string;
167
+ }, NoInfer<AgentToolContext>>;
168
+ }) | ({
169
+ title?: string;
170
+ providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
171
+ metadata?: import("@ai-sdk/provider").JSONObject;
172
+ inputSchema: import("ai").FlexibleSchema<{
173
+ agent_type: string;
174
+ task_name: string;
175
+ message: string;
176
+ fork_turns: string;
177
+ }>;
178
+ contextSchema?: import("ai").FlexibleSchema<AgentToolContext> | undefined;
179
+ needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
180
+ agent_type: string;
181
+ task_name: string;
182
+ message: string;
183
+ fork_turns: string;
184
+ }, NoInfer<AgentToolContext>> | undefined;
185
+ onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
186
+ onInputDelta?: ((options: {
187
+ inputTextDelta: string;
188
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
189
+ onInputAvailable?: ((options: {
190
+ input: {
191
+ agent_type: string;
192
+ task_name: string;
193
+ message: string;
194
+ fork_turns: string;
195
+ };
196
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
197
+ toModelOutput?: ((options: {
198
+ toolCallId: string;
199
+ input: {
200
+ agent_type: string;
201
+ task_name: string;
202
+ message: string;
203
+ fork_turns: string;
204
+ };
205
+ output: NoInfer<{
206
+ task_name: string;
207
+ }>;
208
+ }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
209
+ } & {
210
+ outputSchema?: import("ai").FlexibleSchema<{
211
+ task_name: string;
212
+ }> | undefined;
213
+ execute: import("ai").ToolExecuteFunction<{
214
+ agent_type: string;
215
+ task_name: string;
216
+ message: string;
217
+ fork_turns: string;
218
+ }, {
219
+ task_name: string;
220
+ }, NoInfer<AgentToolContext>>;
221
+ } & {
222
+ type: "provider";
223
+ id: `${string}.${string}`;
224
+ args: Record<string, unknown>;
225
+ description?: never;
226
+ strict?: never;
227
+ inputExamples?: never;
228
+ } & {
229
+ isProviderExecuted: false;
230
+ supportsDeferredResults?: never;
231
+ } & {
232
+ execute: import("ai").ToolExecuteFunction<{
233
+ agent_type: string;
234
+ task_name: string;
235
+ message: string;
236
+ fork_turns: string;
237
+ }, {
238
+ task_name: string;
239
+ }, NoInfer<AgentToolContext>>;
240
+ }) | ({
241
+ title?: string;
242
+ providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
243
+ metadata?: import("@ai-sdk/provider").JSONObject;
244
+ inputSchema: import("ai").FlexibleSchema<{
245
+ agent_type: string;
246
+ task_name: string;
247
+ message: string;
248
+ fork_turns: string;
249
+ }>;
250
+ contextSchema?: import("ai").FlexibleSchema<AgentToolContext> | undefined;
251
+ needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
252
+ agent_type: string;
253
+ task_name: string;
254
+ message: string;
255
+ fork_turns: string;
256
+ }, NoInfer<AgentToolContext>> | undefined;
257
+ onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
258
+ onInputDelta?: ((options: {
259
+ inputTextDelta: string;
260
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
261
+ onInputAvailable?: ((options: {
262
+ input: {
263
+ agent_type: string;
264
+ task_name: string;
265
+ message: string;
266
+ fork_turns: string;
267
+ };
268
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
269
+ toModelOutput?: ((options: {
270
+ toolCallId: string;
271
+ input: {
272
+ agent_type: string;
273
+ task_name: string;
274
+ message: string;
275
+ fork_turns: string;
276
+ };
277
+ output: NoInfer<{
278
+ task_name: string;
279
+ }>;
280
+ }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
281
+ } & {
282
+ outputSchema?: import("ai").FlexibleSchema<{
283
+ task_name: string;
284
+ }> | undefined;
285
+ execute: import("ai").ToolExecuteFunction<{
286
+ agent_type: string;
287
+ task_name: string;
288
+ message: string;
289
+ fork_turns: string;
290
+ }, {
291
+ task_name: string;
292
+ }, NoInfer<AgentToolContext>>;
293
+ } & {
294
+ type: "provider";
295
+ id: `${string}.${string}`;
296
+ args: Record<string, unknown>;
297
+ description?: never;
298
+ strict?: never;
299
+ inputExamples?: never;
300
+ } & {
301
+ isProviderExecuted: true;
302
+ supportsDeferredResults?: boolean;
303
+ } & {
304
+ execute: import("ai").ToolExecuteFunction<{
305
+ agent_type: string;
306
+ task_name: string;
307
+ message: string;
308
+ fork_turns: string;
309
+ }, {
310
+ task_name: string;
311
+ }, NoInfer<AgentToolContext>>;
312
+ });
313
+ //# sourceMappingURL=spawn-agent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spawn-agent.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/collaboration/spawn-agent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAmChE,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAC7B,MAAM;;;;;mBAAN,MAAM;;;;;;;;mBAAN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAAN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAAN,MAAM;;;;;mBAAN,MAAM;;;;;;;;mBAAN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAAN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAAN,MAAM;;;;;mBAAN,MAAM;;;;;;;;mBAAN,MAAM;;;;;;;;;;;;;;;;;;;mBAAN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAAN,MAAM;;;;;mBAAN,MAAM;;;;;;;;mBAAN,MAAM;;;;;;;;;;;;;;;;;;;mBAAN,MAAM;;GA4BjD"}
@@ -0,0 +1,253 @@
1
+ import type { AgentToolContext } from './agent-tool-context.ts';
2
+ export declare function createWaitAgentTool(options: {
3
+ minTimeoutMs: number;
4
+ defaultTimeoutMs: number;
5
+ maxTimeoutMs: number;
6
+ }): ({
7
+ title?: string;
8
+ providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
9
+ metadata?: import("@ai-sdk/provider").JSONObject;
10
+ inputSchema: import("ai").FlexibleSchema<{
11
+ timeout_ms?: number | undefined;
12
+ }>;
13
+ contextSchema?: import("ai").FlexibleSchema<AgentToolContext> | undefined;
14
+ needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
15
+ timeout_ms?: number | undefined;
16
+ }, NoInfer<AgentToolContext>> | undefined;
17
+ onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
18
+ onInputDelta?: ((options: {
19
+ inputTextDelta: string;
20
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
21
+ onInputAvailable?: ((options: {
22
+ input: {
23
+ timeout_ms?: number | undefined;
24
+ };
25
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
26
+ toModelOutput?: ((options: {
27
+ toolCallId: string;
28
+ input: {
29
+ timeout_ms?: number | undefined;
30
+ };
31
+ output: NoInfer<{
32
+ message: string;
33
+ timed_out: boolean;
34
+ }>;
35
+ }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
36
+ } & {
37
+ outputSchema?: import("ai").FlexibleSchema<{
38
+ message: string;
39
+ timed_out: boolean;
40
+ }> | undefined;
41
+ execute: import("ai").ToolExecuteFunction<{
42
+ timeout_ms?: number | undefined;
43
+ }, {
44
+ message: string;
45
+ timed_out: boolean;
46
+ }, NoInfer<AgentToolContext>>;
47
+ } & {
48
+ description?: string | ((options: {
49
+ context: NoInfer<AgentToolContext>;
50
+ experimental_sandbox?: import("ai").Experimental_SandboxSession;
51
+ }) => string) | undefined;
52
+ strict?: boolean;
53
+ inputExamples?: {
54
+ input: NoInfer<{
55
+ timeout_ms?: number | undefined;
56
+ }>;
57
+ }[] | undefined;
58
+ id?: never;
59
+ isProviderExecuted?: never;
60
+ args?: never;
61
+ supportsDeferredResults?: never;
62
+ } & {
63
+ type?: undefined | "function";
64
+ } & {
65
+ execute: import("ai").ToolExecuteFunction<{
66
+ timeout_ms?: number | undefined;
67
+ }, {
68
+ message: string;
69
+ timed_out: boolean;
70
+ }, NoInfer<AgentToolContext>>;
71
+ }) | ({
72
+ title?: string;
73
+ providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
74
+ metadata?: import("@ai-sdk/provider").JSONObject;
75
+ inputSchema: import("ai").FlexibleSchema<{
76
+ timeout_ms?: number | undefined;
77
+ }>;
78
+ contextSchema?: import("ai").FlexibleSchema<AgentToolContext> | undefined;
79
+ needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
80
+ timeout_ms?: number | undefined;
81
+ }, NoInfer<AgentToolContext>> | undefined;
82
+ onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
83
+ onInputDelta?: ((options: {
84
+ inputTextDelta: string;
85
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
86
+ onInputAvailable?: ((options: {
87
+ input: {
88
+ timeout_ms?: number | undefined;
89
+ };
90
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
91
+ toModelOutput?: ((options: {
92
+ toolCallId: string;
93
+ input: {
94
+ timeout_ms?: number | undefined;
95
+ };
96
+ output: NoInfer<{
97
+ message: string;
98
+ timed_out: boolean;
99
+ }>;
100
+ }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
101
+ } & {
102
+ outputSchema?: import("ai").FlexibleSchema<{
103
+ message: string;
104
+ timed_out: boolean;
105
+ }> | undefined;
106
+ execute: import("ai").ToolExecuteFunction<{
107
+ timeout_ms?: number | undefined;
108
+ }, {
109
+ message: string;
110
+ timed_out: boolean;
111
+ }, NoInfer<AgentToolContext>>;
112
+ } & {
113
+ description?: string | ((options: {
114
+ context: NoInfer<AgentToolContext>;
115
+ experimental_sandbox?: import("ai").Experimental_SandboxSession;
116
+ }) => string) | undefined;
117
+ strict?: boolean;
118
+ inputExamples?: {
119
+ input: NoInfer<{
120
+ timeout_ms?: number | undefined;
121
+ }>;
122
+ }[] | undefined;
123
+ id?: never;
124
+ isProviderExecuted?: never;
125
+ args?: never;
126
+ supportsDeferredResults?: never;
127
+ } & {
128
+ type: "dynamic";
129
+ } & {
130
+ execute: import("ai").ToolExecuteFunction<{
131
+ timeout_ms?: number | undefined;
132
+ }, {
133
+ message: string;
134
+ timed_out: boolean;
135
+ }, NoInfer<AgentToolContext>>;
136
+ }) | ({
137
+ title?: string;
138
+ providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
139
+ metadata?: import("@ai-sdk/provider").JSONObject;
140
+ inputSchema: import("ai").FlexibleSchema<{
141
+ timeout_ms?: number | undefined;
142
+ }>;
143
+ contextSchema?: import("ai").FlexibleSchema<AgentToolContext> | undefined;
144
+ needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
145
+ timeout_ms?: number | undefined;
146
+ }, NoInfer<AgentToolContext>> | undefined;
147
+ onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
148
+ onInputDelta?: ((options: {
149
+ inputTextDelta: string;
150
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
151
+ onInputAvailable?: ((options: {
152
+ input: {
153
+ timeout_ms?: number | undefined;
154
+ };
155
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
156
+ toModelOutput?: ((options: {
157
+ toolCallId: string;
158
+ input: {
159
+ timeout_ms?: number | undefined;
160
+ };
161
+ output: NoInfer<{
162
+ message: string;
163
+ timed_out: boolean;
164
+ }>;
165
+ }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
166
+ } & {
167
+ outputSchema?: import("ai").FlexibleSchema<{
168
+ message: string;
169
+ timed_out: boolean;
170
+ }> | undefined;
171
+ execute: import("ai").ToolExecuteFunction<{
172
+ timeout_ms?: number | undefined;
173
+ }, {
174
+ message: string;
175
+ timed_out: boolean;
176
+ }, NoInfer<AgentToolContext>>;
177
+ } & {
178
+ type: "provider";
179
+ id: `${string}.${string}`;
180
+ args: Record<string, unknown>;
181
+ description?: never;
182
+ strict?: never;
183
+ inputExamples?: never;
184
+ } & {
185
+ isProviderExecuted: false;
186
+ supportsDeferredResults?: never;
187
+ } & {
188
+ execute: import("ai").ToolExecuteFunction<{
189
+ timeout_ms?: number | undefined;
190
+ }, {
191
+ message: string;
192
+ timed_out: boolean;
193
+ }, NoInfer<AgentToolContext>>;
194
+ }) | ({
195
+ title?: string;
196
+ providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
197
+ metadata?: import("@ai-sdk/provider").JSONObject;
198
+ inputSchema: import("ai").FlexibleSchema<{
199
+ timeout_ms?: number | undefined;
200
+ }>;
201
+ contextSchema?: import("ai").FlexibleSchema<AgentToolContext> | undefined;
202
+ needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
203
+ timeout_ms?: number | undefined;
204
+ }, NoInfer<AgentToolContext>> | undefined;
205
+ onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
206
+ onInputDelta?: ((options: {
207
+ inputTextDelta: string;
208
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
209
+ onInputAvailable?: ((options: {
210
+ input: {
211
+ timeout_ms?: number | undefined;
212
+ };
213
+ } & import("ai").ToolExecutionOptions<NoInfer<AgentToolContext>>) => void | PromiseLike<void>) | undefined;
214
+ toModelOutput?: ((options: {
215
+ toolCallId: string;
216
+ input: {
217
+ timeout_ms?: number | undefined;
218
+ };
219
+ output: NoInfer<{
220
+ message: string;
221
+ timed_out: boolean;
222
+ }>;
223
+ }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
224
+ } & {
225
+ outputSchema?: import("ai").FlexibleSchema<{
226
+ message: string;
227
+ timed_out: boolean;
228
+ }> | undefined;
229
+ execute: import("ai").ToolExecuteFunction<{
230
+ timeout_ms?: number | undefined;
231
+ }, {
232
+ message: string;
233
+ timed_out: boolean;
234
+ }, NoInfer<AgentToolContext>>;
235
+ } & {
236
+ type: "provider";
237
+ id: `${string}.${string}`;
238
+ args: Record<string, unknown>;
239
+ description?: never;
240
+ strict?: never;
241
+ inputExamples?: never;
242
+ } & {
243
+ isProviderExecuted: true;
244
+ supportsDeferredResults?: boolean;
245
+ } & {
246
+ execute: import("ai").ToolExecuteFunction<{
247
+ timeout_ms?: number | undefined;
248
+ }, {
249
+ message: string;
250
+ timed_out: boolean;
251
+ }, NoInfer<AgentToolContext>>;
252
+ });
253
+ //# sourceMappingURL=wait-agent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wait-agent.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/collaboration/wait-agent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMhE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;;;;;;;;;;;;;;;;;;;;;;;;;;qBAcc,MAAM;uBAAa,OAAO;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAA1B,MAAM;uBAAa,OAAO;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAA1B,MAAM;uBAAa,OAAO;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;;;;;;;;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAA1B,MAAM;uBAAa,OAAO;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;iBAA1B,MAAM;mBAAa,OAAO;;;;;;;;;;;;;;;;iBAA1B,MAAM;mBAAa,OAAO;;GAoBxC"}
@@ -0,0 +1,80 @@
1
+ import type { StreamManager } from '@deepagents/context';
2
+ import type { AgentDeclaration } from '../agent.ts';
3
+ import type { MailboxCoordinator } from '../mailbox/coordinator.ts';
4
+ import type { ConversationId } from '../mailbox/types.ts';
5
+ import type { TurnQueue, TurnRef } from '../queue/turn-queue.ts';
6
+ import { AgentDeclarationRegistry } from './agent-declaration-registry.ts';
7
+ import { AgentDirectory } from './agent-directory.ts';
8
+ import { AgentHistoryForker } from './agent-history-forker.ts';
9
+ import { type AgentStatusProjector, type ListedAgent } from './agent-status-projector.ts';
10
+ import type { AgentThread } from './agent-thread.ts';
11
+ import type { ForkTurns } from './fork-turns.ts';
12
+ export interface AgentControlPlaneOptions {
13
+ root: AgentDeclaration;
14
+ streams: StreamManager;
15
+ queue: TurnQueue;
16
+ mailbox: MailboxCoordinator;
17
+ declarations: AgentDeclarationRegistry;
18
+ directory: AgentDirectory;
19
+ statusProjector: AgentStatusProjector;
20
+ historyForker: AgentHistoryForker;
21
+ }
22
+ export interface AgentActor {
23
+ turn: TurnRef;
24
+ thread: AgentThread;
25
+ declaration: AgentDeclaration;
26
+ }
27
+ export interface TurnInput {
28
+ /** Caller-supplied idempotency key; enqueue returns its scoped durable id. */
29
+ id: string;
30
+ input: string;
31
+ }
32
+ export interface SpawnAgentInput {
33
+ agentType: string;
34
+ taskName: string;
35
+ message: string;
36
+ forkTurns: ForkTurns;
37
+ }
38
+ export interface SpawnAgentOutput {
39
+ task_name: string;
40
+ }
41
+ export type { ListedAgent, ListedAgentStatus, } from './agent-status-projector.ts';
42
+ /** Application-level coordination for one declared agent tree. */
43
+ export declare class AgentControlPlane {
44
+ #private;
45
+ constructor(options: AgentControlPlaneOptions);
46
+ resolve(conversation: ConversationId): Promise<{
47
+ declaration: AgentDeclaration;
48
+ thread: AgentThread;
49
+ }>;
50
+ enqueue(conversation: ConversationId, turn: TurnInput): Promise<string>;
51
+ recordLatestTurn(conversation: ConversationId, streamId: string): Promise<AgentThread>;
52
+ recordLatestTurnIfCurrent(conversation: ConversationId, streamId: string, expectedLastTurnId: string | undefined): Promise<AgentThread | undefined>;
53
+ spawn(actor: AgentActor, input: SpawnAgentInput): Promise<SpawnAgentOutput>;
54
+ sendMessage(actor: AgentActor, input: {
55
+ target: string;
56
+ message: string;
57
+ }): Promise<{
58
+ target: string;
59
+ }>;
60
+ followupTask(actor: AgentActor, input: {
61
+ target: string;
62
+ message: string;
63
+ }): Promise<{
64
+ target: string;
65
+ }>;
66
+ listAgents(actor: AgentActor, pathPrefix?: string): Promise<{
67
+ agents: ListedAgent[];
68
+ }>;
69
+ interruptAgent(actor: AgentActor, input: {
70
+ target: string;
71
+ }): Promise<{
72
+ previous_status: ListedAgent['agent_status'];
73
+ }>;
74
+ waitForMailbox(actor: AgentActor, options: {
75
+ timeoutMs: number;
76
+ signal?: AbortSignal;
77
+ }): Promise<boolean>;
78
+ projectTerminal(turn: TurnRef, thread: AgentThread): Promise<void>;
79
+ }
80
+ //# sourceMappingURL=agent-control-plane.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-control-plane.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/control-plane/agent-control-plane.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import type { AgentDeclaration } from '../agent.ts';
2
+ /** Immutable declaration lookup compiled once for one agent runtime. */
3
+ export declare class AgentDeclarationRegistry {
4
+ #private;
5
+ readonly root: AgentDeclaration;
6
+ constructor(root: AgentDeclaration);
7
+ get(name: string): AgentDeclaration | undefined;
8
+ }
9
+ //# sourceMappingURL=agent-declaration-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-declaration-registry.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/control-plane/agent-declaration-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,wEAAwE;AACxE,qBAAa,wBAAwB;;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;gBAIpB,IAAI,EAAE,gBAAgB;IAKlC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;CAgChD"}