@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
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,42 @@ 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
 
43
+ Zukhruf discovers immediate `skills/<name>/SKILL.md` children from each
44
+ configured sandbox once per conversation. It persists only the ordered catalog
45
+ (`name`, `description`, and model-visible `path`) in chat metadata so later turns
46
+ and process restarts reconstruct the same prompt fragment without rediscovery.
47
+ Skill bodies, scripts, references, and assets remain in the sandbox. Providers
48
+ may preinstall or mount them, or opt into the existing `uploadDirectory` support
49
+ when creating the sandbox.
50
+
40
51
  Runnable end-to-end showcases live in
52
+ [`demo/zukhruf-simple`](../../demo/zukhruf-simple) (the smallest complete
53
+ deployable unit),
41
54
  [`demo/zukhruf-durable-turns`](../../demo/zukhruf-durable-turns) (the durable
42
- executor: enqueue, detach, resume, strict per-chat FIFO) and
55
+ executor: enqueue, detach, resume, strict per-chat FIFO),
43
56
  [`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).
57
+ durable FIFO mail, and payload-free wakes),
58
+ [`demo/zukhruf-research-bot`](../../demo/zukhruf-research-bot) (durable
59
+ planner and researcher chats with mailbox-delivered findings),
60
+ [`demo/zukhruf-group-chat`](../../demo/zukhruf-group-chat) (managed group-chat
61
+ orchestration over a shared transcript), and
62
+ [`demo/zukhruf-whatsapp`](../../demo/zukhruf-whatsapp) (manager-free group
63
+ notifications where specialists volunteer public replies).
64
+ `spawn_agent` can fork all parent turns, no parent turns, or a bounded number of
65
+ recent user-turn boundaries into a child chat through its `fork_turns` input.