@deepagents/experimental 5.0.0 → 6.1.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 (86) hide show
  1. package/README.md +30 -11
  2. package/dist/index.js +1453 -459
  3. package/dist/index.js.map +4 -4
  4. package/dist/zukhruf/agent.d.ts +9 -4
  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/{list-agents.d.ts → collaboration/list-agents.d.ts} +1 -1
  13. package/dist/zukhruf/collaboration/list-agents.d.ts.map +1 -0
  14. package/dist/zukhruf/{message-tools.d.ts → collaboration/message-tools.d.ts} +84 -88
  15. package/dist/zukhruf/collaboration/message-tools.d.ts.map +1 -0
  16. package/dist/zukhruf/{spawn-agent.d.ts → collaboration/spawn-agent.d.ts} +55 -43
  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/{agent-control-plane.d.ts → control-plane/agent-control-plane.d.ts} +17 -5
  21. package/dist/zukhruf/control-plane/agent-control-plane.d.ts.map +1 -0
  22. package/dist/zukhruf/{agent-declaration-registry.d.ts → control-plane/agent-declaration-registry.d.ts} +1 -1
  23. package/dist/zukhruf/control-plane/agent-declaration-registry.d.ts.map +1 -0
  24. package/dist/zukhruf/{agent-directory.d.ts → control-plane/agent-directory.d.ts} +2 -1
  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.map +1 -0
  29. package/dist/zukhruf/control-plane/agent-status-projector.d.ts +50 -0
  30. package/dist/zukhruf/control-plane/agent-status-projector.d.ts.map +1 -0
  31. package/dist/zukhruf/{agent-thread.d.ts → control-plane/agent-thread.d.ts} +1 -1
  32. package/dist/zukhruf/control-plane/agent-thread.d.ts.map +1 -0
  33. package/dist/zukhruf/{agent-turn-id.d.ts → control-plane/agent-turn-id.d.ts} +2 -1
  34. package/dist/zukhruf/control-plane/agent-turn-id.d.ts.map +1 -0
  35. package/dist/zukhruf/control-plane/fork-turns.d.ts +4 -0
  36. package/dist/zukhruf/control-plane/fork-turns.d.ts.map +1 -0
  37. package/dist/zukhruf/index.d.ts +6 -6
  38. package/dist/zukhruf/index.d.ts.map +1 -1
  39. package/dist/zukhruf/index.js +1453 -459
  40. package/dist/zukhruf/index.js.map +4 -4
  41. package/dist/zukhruf/mailbox/coordinator.d.ts +4 -0
  42. package/dist/zukhruf/mailbox/coordinator.d.ts.map +1 -1
  43. package/dist/zukhruf/multi-agent-v2-config.d.ts +32 -0
  44. package/dist/zukhruf/multi-agent-v2-config.d.ts.map +1 -0
  45. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts +16 -4
  46. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts.map +1 -1
  47. package/dist/zukhruf/queue/turn-queue.d.ts +35 -6
  48. package/dist/zukhruf/queue/turn-queue.d.ts.map +1 -1
  49. package/dist/zukhruf/render-turn.d.ts +9 -0
  50. package/dist/zukhruf/render-turn.d.ts.map +1 -0
  51. package/dist/zukhruf/{agent-runtime.d.ts → runtime/agent-runtime.d.ts} +24 -13
  52. package/dist/zukhruf/runtime/agent-runtime.d.ts.map +1 -0
  53. package/dist/zukhruf/runtime/agent-skills.d.ts +9 -0
  54. package/dist/zukhruf/runtime/agent-skills.d.ts.map +1 -0
  55. package/dist/zukhruf/{agent-turn-executor.d.ts → runtime/agent-turn-executor.d.ts} +5 -3
  56. package/dist/zukhruf/runtime/agent-turn-executor.d.ts.map +1 -0
  57. package/dist/zukhruf/{approval-controller.d.ts → runtime/approval-controller.d.ts} +19 -8
  58. package/dist/zukhruf/runtime/approval-controller.d.ts.map +1 -0
  59. package/dist/zukhruf/runtime/approval-job-id.d.ts +3 -0
  60. package/dist/zukhruf/runtime/approval-job-id.d.ts.map +1 -0
  61. package/dist/zukhruf/sandbox/define.d.ts +4 -3
  62. package/dist/zukhruf/sandbox/define.d.ts.map +1 -1
  63. package/dist/zukhruf/tool.d.ts +18 -6
  64. package/dist/zukhruf/tool.d.ts.map +1 -1
  65. package/package.json +9 -9
  66. package/dist/zukhruf/agent-control-plane.d.ts.map +0 -1
  67. package/dist/zukhruf/agent-declaration-registry.d.ts.map +0 -1
  68. package/dist/zukhruf/agent-directory.d.ts.map +0 -1
  69. package/dist/zukhruf/agent-path.d.ts.map +0 -1
  70. package/dist/zukhruf/agent-runtime.d.ts.map +0 -1
  71. package/dist/zukhruf/agent-status-projector.d.ts +0 -32
  72. package/dist/zukhruf/agent-status-projector.d.ts.map +0 -1
  73. package/dist/zukhruf/agent-thread.d.ts.map +0 -1
  74. package/dist/zukhruf/agent-tool-context.d.ts +0 -6
  75. package/dist/zukhruf/agent-tool-context.d.ts.map +0 -1
  76. package/dist/zukhruf/agent-turn-executor.d.ts.map +0 -1
  77. package/dist/zukhruf/agent-turn-id.d.ts.map +0 -1
  78. package/dist/zukhruf/approval-controller.d.ts.map +0 -1
  79. package/dist/zukhruf/approval-mutex.d.ts +0 -5
  80. package/dist/zukhruf/approval-mutex.d.ts.map +0 -1
  81. package/dist/zukhruf/list-agents.d.ts.map +0 -1
  82. package/dist/zukhruf/message-tools.d.ts.map +0 -1
  83. package/dist/zukhruf/spawn-agent.d.ts.map +0 -1
  84. package/dist/zukhruf/sqlite-approval-mutex.d.ts +0 -17
  85. package/dist/zukhruf/sqlite-approval-mutex.d.ts.map +0 -1
  86. /package/dist/zukhruf/{agent-path.d.ts → control-plane/agent-path.d.ts} +0 -0
@@ -0,0 +1,10 @@
1
+ import { type ContextStore } from '@deepagents/context';
2
+ import type { AgentThread } from './agent-thread.ts';
3
+ import type { ForkTurns } from './fork-turns.ts';
4
+ /** Copies a stable, filtered parent-history snapshot into a new child chat. */
5
+ export declare class AgentHistoryForker {
6
+ #private;
7
+ constructor(store: ContextStore);
8
+ fork(parent: AgentThread, child: AgentThread, forkTurns: ForkTurns): Promise<void>;
9
+ }
10
+ //# sourceMappingURL=agent-history-forker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-history-forker.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/control-plane/agent-history-forker.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAcjD,+EAA+E;AAC/E,qBAAa,kBAAkB;;gBAGjB,KAAK,EAAE,YAAY;IAIzB,IAAI,CACR,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,IAAI,CAAC;CAyTjB"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-path.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/control-plane/agent-path.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,qBAAa,SAAS;;IAGpB,OAAO;IAIP,MAAM,CAAC,IAAI,IAAI,SAAS;IAIxB,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAqBtC,qFAAqF;IACrF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAQlC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAMvC,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIjC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,IAAI,SAAS,GAAG,IAAI,CAG7B;IAED,QAAQ,IAAI,MAAM;CAGnB"}
@@ -0,0 +1,50 @@
1
+ import { z } from 'zod';
2
+ import { type ContextStore, type StreamManager } from '@deepagents/context';
3
+ import type { MailboxCoordinator } from '../mailbox/coordinator.ts';
4
+ import type { TurnQueue, TurnRef } from '../queue/turn-queue.ts';
5
+ import type { ApprovalController } from '../runtime/approval-controller.ts';
6
+ import type { AgentDirectory } from './agent-directory.ts';
7
+ import type { AgentThread } from './agent-thread.ts';
8
+ export declare const listedAgentStatusSchema: z.ZodUnion<readonly [z.ZodEnum<{
9
+ running: "running";
10
+ pending_init: "pending_init";
11
+ interrupted: "interrupted";
12
+ shutdown: "shutdown";
13
+ not_found: "not_found";
14
+ }>, z.ZodObject<{
15
+ completed: z.ZodNullable<z.ZodString>;
16
+ }, z.core.$strict>, z.ZodObject<{
17
+ errored: z.ZodString;
18
+ }, z.core.$strict>]>;
19
+ export type ListedAgentStatus = z.infer<typeof listedAgentStatusSchema>;
20
+ export declare const listedAgentSchema: z.ZodObject<{
21
+ agent_name: z.ZodString;
22
+ agent_status: z.ZodUnion<readonly [z.ZodEnum<{
23
+ running: "running";
24
+ pending_init: "pending_init";
25
+ interrupted: "interrupted";
26
+ shutdown: "shutdown";
27
+ not_found: "not_found";
28
+ }>, z.ZodObject<{
29
+ completed: z.ZodNullable<z.ZodString>;
30
+ }, z.core.$strict>, z.ZodObject<{
31
+ errored: z.ZodString;
32
+ }, z.core.$strict>]>;
33
+ }, z.core.$strict>;
34
+ export type ListedAgent = z.infer<typeof listedAgentSchema>;
35
+ export interface AgentStatusProjectorOptions {
36
+ store: ContextStore;
37
+ streams: StreamManager;
38
+ queue: TurnQueue;
39
+ mailbox: MailboxCoordinator;
40
+ directory: AgentDirectory;
41
+ approvals: ApprovalController;
42
+ }
43
+ /** Projects durable execution state into agent-facing status and terminal mail. */
44
+ export declare class AgentStatusProjector {
45
+ #private;
46
+ constructor(options: AgentStatusProjectorOptions);
47
+ projectListedAgent(currentTurn: TurnRef, thread: AgentThread): Promise<ListedAgent>;
48
+ projectTerminal(turn: TurnRef, thread: AgentThread): Promise<void>;
49
+ }
50
+ //# sourceMappingURL=agent-status-projector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-status-projector.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/control-plane/agent-status-projector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAMpE,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,uBAAuB;;;;;;;;;;oBAIlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;kBAKnB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,mFAAmF;AACnF,qBAAa,oBAAoB;;gBAQnB,OAAO,EAAE,2BAA2B;IAS1C,kBAAkB,CACtB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC;IAoCjB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAgGzE"}
@@ -1,5 +1,5 @@
1
+ import type { ConversationId } from '../mailbox/types.ts';
1
2
  import { AgentPath } from './agent-path.ts';
2
- import type { ConversationId } from './mailbox/types.ts';
3
3
  export interface AgentThreadOptions {
4
4
  conversation: ConversationId;
5
5
  treeId: string;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-thread.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/control-plane/agent-thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,cAAc,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sEAAsE;AACtE,qBAAa,WAAW;;IACtB,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,kBAAkB;IAUvC,MAAM,CAAC,IAAI,CACT,YAAY,EAAE,cAAc,EAC5B,eAAe,EAAE,MAAM,GACtB,WAAW;IAUd,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAIrE,MAAM,CAAC,mBAAmB,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,OAAO;IAQV,MAAM,CAAC,YAAY,CACjB,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,WAAW,GAAG,SAAS;IAuC1B,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAW/C,UAAU,CACR,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAwC3B"}
@@ -1,4 +1,4 @@
1
- import type { ConversationId } from './mailbox/types.ts';
1
+ import type { ConversationId } from '../mailbox/types.ts';
2
2
  /** Conversation-scoped durable identity for one caller-supplied turn key. */
3
3
  export declare class AgentTurnId {
4
4
  #private;
@@ -8,4 +8,5 @@ export declare class AgentTurnId {
8
8
  static assertOwner(conversation: ConversationId, streamId: string): void;
9
9
  toString(): string;
10
10
  }
11
+ export declare function conversationNamespace(conversation: ConversationId): string;
11
12
  //# sourceMappingURL=agent-turn-id.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-turn-id.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/control-plane/agent-turn-id.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,6EAA6E;AAC7E,qBAAa,WAAW;;IAItB,OAAO;IAIP,MAAM,CAAC,WAAW,CAChB,YAAY,EAAE,cAAc,EAC5B,SAAS,EAAE,MAAM,GAChB,WAAW;IAUd,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,GAAG,WAAW;IAIxD,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IASxE,QAAQ,IAAI,MAAM;CAGnB;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,cAAc,GAAG,MAAM,CAQ1E"}
@@ -0,0 +1,4 @@
1
+ export type ForkTurns = 'none' | 'all' | number;
2
+ export declare const forkTurnsError = "fork_turns must be `none`, `all`, or a positive integer string";
3
+ export declare function parseForkTurns(value: string): ForkTurns | undefined;
4
+ //# sourceMappingURL=fork-turns.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fork-turns.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/control-plane/fork-turns.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhD,eAAO,MAAM,cAAc,mEACuC,CAAC;AAEnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAOnE"}
@@ -1,16 +1,16 @@
1
- export * from './agent-thread.ts';
2
1
  export * from './agent.ts';
3
- export * from './agent-path.ts';
4
- export * from './agent-runtime.ts';
5
- export * from './approval-mutex.ts';
6
- export type { TurnInput } from './agent-control-plane.ts';
2
+ export * from './control-plane/agent-path.ts';
3
+ export * from './control-plane/agent-thread.ts';
4
+ export type { TurnInput } from './control-plane/agent-control-plane.ts';
5
+ export * from './runtime/agent-runtime.ts';
6
+ export type { MultiAgentV2HostConfig } from './multi-agent-v2-config.ts';
7
7
  export * from './instructions.ts';
8
8
  export * from './mailbox/sqlite.store.ts';
9
9
  export * from './mailbox/store.ts';
10
10
  export * from './mailbox/types.ts';
11
11
  export * from './queue/pg-boss.turn-queue.ts';
12
12
  export * from './queue/turn-queue.ts';
13
+ export * from './render-turn.ts';
13
14
  export * from './sandbox/define.ts';
14
- export * from './sqlite-approval-mutex.ts';
15
15
  export * from './tool.ts';
16
16
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/zukhruf/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/zukhruf/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,cAAc,4BAA4B,CAAC;AAC3C,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC"}