@deepagents/experimental 4.3.0 → 5.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 (56) hide show
  1. package/README.md +9 -5
  2. package/dist/index.js +1716 -152
  3. package/dist/index.js.map +4 -4
  4. package/dist/zukhruf/agent-control-plane.d.ts +68 -0
  5. package/dist/zukhruf/agent-control-plane.d.ts.map +1 -0
  6. package/dist/zukhruf/agent-declaration-registry.d.ts +9 -0
  7. package/dist/zukhruf/agent-declaration-registry.d.ts.map +1 -0
  8. package/dist/zukhruf/agent-directory.d.ts +21 -0
  9. package/dist/zukhruf/agent-directory.d.ts.map +1 -0
  10. package/dist/zukhruf/agent-path.d.ts +15 -0
  11. package/dist/zukhruf/agent-path.d.ts.map +1 -0
  12. package/dist/zukhruf/agent-runtime.d.ts +53 -0
  13. package/dist/zukhruf/agent-runtime.d.ts.map +1 -0
  14. package/dist/zukhruf/agent-status-projector.d.ts +32 -0
  15. package/dist/zukhruf/agent-status-projector.d.ts.map +1 -0
  16. package/dist/zukhruf/agent-thread.d.ts +31 -0
  17. package/dist/zukhruf/agent-thread.d.ts.map +1 -0
  18. package/dist/zukhruf/agent-tool-context.d.ts +6 -0
  19. package/dist/zukhruf/agent-tool-context.d.ts.map +1 -0
  20. package/dist/zukhruf/agent-turn-executor.d.ts +19 -0
  21. package/dist/zukhruf/agent-turn-executor.d.ts.map +1 -0
  22. package/dist/zukhruf/agent-turn-id.d.ts +11 -0
  23. package/dist/zukhruf/agent-turn-id.d.ts.map +1 -0
  24. package/dist/zukhruf/agent.d.ts +13 -8
  25. package/dist/zukhruf/agent.d.ts.map +1 -1
  26. package/dist/zukhruf/approval-controller.d.ts +34 -0
  27. package/dist/zukhruf/approval-controller.d.ts.map +1 -0
  28. package/dist/zukhruf/approval-mutex.d.ts +5 -0
  29. package/dist/zukhruf/approval-mutex.d.ts.map +1 -0
  30. package/dist/zukhruf/index.d.ts +15 -11
  31. package/dist/zukhruf/index.d.ts.map +1 -1
  32. package/dist/zukhruf/index.js +1716 -152
  33. package/dist/zukhruf/index.js.map +4 -4
  34. package/dist/zukhruf/list-agents.d.ts +234 -0
  35. package/dist/zukhruf/list-agents.d.ts.map +1 -0
  36. package/dist/zukhruf/mailbox/coordinator.d.ts +22 -0
  37. package/dist/zukhruf/mailbox/coordinator.d.ts.map +1 -0
  38. package/dist/zukhruf/mailbox/sqlite.store.d.ts +16 -0
  39. package/dist/zukhruf/mailbox/sqlite.store.d.ts.map +1 -0
  40. package/dist/zukhruf/mailbox/store.d.ts +20 -0
  41. package/dist/zukhruf/mailbox/store.d.ts.map +1 -0
  42. package/dist/zukhruf/mailbox/types.d.ts +35 -0
  43. package/dist/zukhruf/mailbox/types.d.ts.map +1 -0
  44. package/dist/zukhruf/message-tools.d.ts +456 -0
  45. package/dist/zukhruf/message-tools.d.ts.map +1 -0
  46. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts +2 -1
  47. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts.map +1 -1
  48. package/dist/zukhruf/queue/turn-queue.d.ts +14 -0
  49. package/dist/zukhruf/queue/turn-queue.d.ts.map +1 -1
  50. package/dist/zukhruf/spawn-agent.d.ts +301 -0
  51. package/dist/zukhruf/spawn-agent.d.ts.map +1 -0
  52. package/dist/zukhruf/sqlite-approval-mutex.d.ts +17 -0
  53. package/dist/zukhruf/sqlite-approval-mutex.d.ts.map +1 -0
  54. package/package.json +8 -7
  55. package/dist/zukhruf/runtime.d.ts +0 -67
  56. package/dist/zukhruf/runtime.d.ts.map +0 -1
package/README.md CHANGED
@@ -21,16 +21,18 @@ fragments, the stream subsystem).
21
21
 
22
22
  ```ts
23
23
  import {
24
+ AgentRuntime,
24
25
  PgBossTurnQueue,
25
- createRuntime,
26
26
  defineAgent,
27
27
  } from '@deepagents/experimental/zukhruf';
28
28
  ```
29
29
 
30
- The declaration layer (`defineAgent` / `defineInstructions` / `defineTool` /
31
- `defineSandbox`) is pure data with a types-only dependency on
32
- `@deepagents/context`; the runtime (`createRuntime`) is the only layer that
33
- touches engines, sandboxes, and durability. See
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
34
36
  [`src/zukhruf/DESIGN.md`](./src/zukhruf/DESIGN.md) for the decided semantics,
35
37
  [`TODO.md`](./src/zukhruf/TODO.md) for the convergence plan, and
36
38
  [`BUGS.md`](./src/zukhruf/BUGS.md) for known residue.
@@ -38,5 +40,7 @@ touches engines, sandboxes, and durability. See
38
40
  Runnable end-to-end showcases live in
39
41
  [`demo/zukhruf-durable-turns`](../../demo/zukhruf-durable-turns) (the durable
40
42
  executor: enqueue, detach, resume, strict per-chat FIFO) and
43
+ [`demo/zukhruf-mailbox`](../../demo/zukhruf-mailbox) (API-key-free host delivery,
44
+ durable FIFO mail, and payload-free wakes) and
41
45
  [`demo/zukhruf-research-bot`](../../demo/zukhruf-research-bot) (an agentic
42
46
  research bot: plan → web-search subagent → streamed report).