@deepagents/experimental 5.0.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 (82) hide show
  1. package/README.md +22 -11
  2. package/dist/index.js +1315 -433
  3. package/dist/index.js.map +4 -4
  4. package/dist/zukhruf/agent.d.ts +4 -3
  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 +1316 -434
  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} +23 -12
  52. package/dist/zukhruf/runtime/agent-runtime.d.ts.map +1 -0
  53. package/dist/zukhruf/{agent-turn-executor.d.ts → runtime/agent-turn-executor.d.ts} +5 -3
  54. package/dist/zukhruf/runtime/agent-turn-executor.d.ts.map +1 -0
  55. package/dist/zukhruf/{approval-controller.d.ts → runtime/approval-controller.d.ts} +19 -8
  56. package/dist/zukhruf/runtime/approval-controller.d.ts.map +1 -0
  57. package/dist/zukhruf/runtime/approval-job-id.d.ts +3 -0
  58. package/dist/zukhruf/runtime/approval-job-id.d.ts.map +1 -0
  59. package/dist/zukhruf/tool.d.ts +18 -6
  60. package/dist/zukhruf/tool.d.ts.map +1 -1
  61. package/package.json +9 -9
  62. package/dist/zukhruf/agent-control-plane.d.ts.map +0 -1
  63. package/dist/zukhruf/agent-declaration-registry.d.ts.map +0 -1
  64. package/dist/zukhruf/agent-directory.d.ts.map +0 -1
  65. package/dist/zukhruf/agent-path.d.ts.map +0 -1
  66. package/dist/zukhruf/agent-runtime.d.ts.map +0 -1
  67. package/dist/zukhruf/agent-status-projector.d.ts +0 -32
  68. package/dist/zukhruf/agent-status-projector.d.ts.map +0 -1
  69. package/dist/zukhruf/agent-thread.d.ts.map +0 -1
  70. package/dist/zukhruf/agent-tool-context.d.ts +0 -6
  71. package/dist/zukhruf/agent-tool-context.d.ts.map +0 -1
  72. package/dist/zukhruf/agent-turn-executor.d.ts.map +0 -1
  73. package/dist/zukhruf/agent-turn-id.d.ts.map +0 -1
  74. package/dist/zukhruf/approval-controller.d.ts.map +0 -1
  75. package/dist/zukhruf/approval-mutex.d.ts +0 -5
  76. package/dist/zukhruf/approval-mutex.d.ts.map +0 -1
  77. package/dist/zukhruf/list-agents.d.ts.map +0 -1
  78. package/dist/zukhruf/message-tools.d.ts.map +0 -1
  79. package/dist/zukhruf/spawn-agent.d.ts.map +0 -1
  80. package/dist/zukhruf/sqlite-approval-mutex.d.ts +0 -17
  81. package/dist/zukhruf/sqlite-approval-mutex.d.ts.map +0 -1
  82. /package/dist/zukhruf/{agent-path.d.ts → control-plane/agent-path.d.ts} +0 -0
package/README.md CHANGED
@@ -14,7 +14,7 @@ for the public API and lifecycle mapping.
14
14
 
15
15
  ## `@deepagents/experimental/zukhruf`
16
16
 
17
- `zukhruf` is an internal DSL for **declaring** an agent, plus a **runtime** that
17
+ Zukhruf is an internal DSL for **declaring** an agent, plus a **runtime** that
18
18
  executes that declaration as a **durable background agent** — built on
19
19
  `@deepagents/context` primitives (`agent()`, `ContextEngine`, `AgentSandbox`,
20
20
  fragments, the stream subsystem).
@@ -24,23 +24,34 @@ import {
24
24
  AgentRuntime,
25
25
  PgBossTurnQueue,
26
26
  defineAgent,
27
+ renderTurn,
27
28
  } from '@deepagents/experimental/zukhruf';
28
29
  ```
29
30
 
30
- The customer surface contains the pure declaration layer (`defineAgent` /
31
- `defineInstructions` / `defineTool` / `defineSandbox`), `AgentRuntime`, the domain values, and the
32
- store/queue ports and adapters. Declarations have a types-only dependency on `@deepagents/context`.
33
- `AgentRuntime` exposes enqueue, host mailbox delivery, observation, approval, denial, and worker
34
- lifecycle. Its control plane, executor, status projector, mailbox coordinator, and injected
35
- collaboration-tool implementations are internal wiring. See
31
+ The public experimental surface contains the pure declaration layer
32
+ (`defineAgent` / `defineInstructions` / `defineTool` / `defineSandbox`),
33
+ `AgentRuntime`, the domain values, and the store/queue ports and adapters.
34
+ Declarations have a types-only dependency on `@deepagents/context`.
35
+ `AgentRuntime` exposes enqueue, host mailbox delivery, observation, approval,
36
+ denial, worker lifecycle, and model-facing collaboration for declared
37
+ subagents. Its control plane, executor, status projector, mailbox coordinator,
38
+ and injected collaboration-tool implementations are internal wiring. See
36
39
  [`src/zukhruf/DESIGN.md`](./src/zukhruf/DESIGN.md) for the decided semantics,
37
40
  [`TODO.md`](./src/zukhruf/TODO.md) for the convergence plan, and
38
41
  [`BUGS.md`](./src/zukhruf/BUGS.md) for known residue.
39
42
 
40
43
  Runnable end-to-end showcases live in
44
+ [`demo/zukhruf-simple`](../../demo/zukhruf-simple) (the smallest complete
45
+ deployable unit),
41
46
  [`demo/zukhruf-durable-turns`](../../demo/zukhruf-durable-turns) (the durable
42
- executor: enqueue, detach, resume, strict per-chat FIFO) and
47
+ executor: enqueue, detach, resume, strict per-chat FIFO),
43
48
  [`demo/zukhruf-mailbox`](../../demo/zukhruf-mailbox) (API-key-free host delivery,
44
- durable FIFO mail, and payload-free wakes) and
45
- [`demo/zukhruf-research-bot`](../../demo/zukhruf-research-bot) (an agentic
46
- research bot: plan → web-search subagent → streamed report).
49
+ durable FIFO mail, and payload-free wakes),
50
+ [`demo/zukhruf-research-bot`](../../demo/zukhruf-research-bot) (durable
51
+ planner and researcher chats with mailbox-delivered findings),
52
+ [`demo/zukhruf-group-chat`](../../demo/zukhruf-group-chat) (managed group-chat
53
+ orchestration over a shared transcript), and
54
+ [`demo/zukhruf-whatsapp`](../../demo/zukhruf-whatsapp) (manager-free group
55
+ notifications where specialists volunteer public replies).
56
+ `spawn_agent` can fork all parent turns, no parent turns, or a bounded number of
57
+ recent user-turn boundaries into a child chat through its `fork_turns` input.