@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.
- package/README.md +22 -11
- package/dist/index.js +1315 -433
- package/dist/index.js.map +4 -4
- package/dist/zukhruf/agent.d.ts +4 -3
- package/dist/zukhruf/agent.d.ts.map +1 -1
- package/dist/zukhruf/collaboration/agent-tool-context.d.ts +6 -0
- package/dist/zukhruf/collaboration/agent-tool-context.d.ts.map +1 -0
- package/dist/zukhruf/collaboration/collaboration-tools.d.ts +4 -0
- package/dist/zukhruf/collaboration/collaboration-tools.d.ts.map +1 -0
- package/dist/zukhruf/collaboration/interrupt-agent.d.ts +234 -0
- package/dist/zukhruf/collaboration/interrupt-agent.d.ts.map +1 -0
- package/dist/zukhruf/{list-agents.d.ts → collaboration/list-agents.d.ts} +1 -1
- package/dist/zukhruf/collaboration/list-agents.d.ts.map +1 -0
- package/dist/zukhruf/{message-tools.d.ts → collaboration/message-tools.d.ts} +84 -88
- package/dist/zukhruf/collaboration/message-tools.d.ts.map +1 -0
- package/dist/zukhruf/{spawn-agent.d.ts → collaboration/spawn-agent.d.ts} +55 -43
- package/dist/zukhruf/collaboration/spawn-agent.d.ts.map +1 -0
- package/dist/zukhruf/collaboration/wait-agent.d.ts +253 -0
- package/dist/zukhruf/collaboration/wait-agent.d.ts.map +1 -0
- package/dist/zukhruf/{agent-control-plane.d.ts → control-plane/agent-control-plane.d.ts} +17 -5
- package/dist/zukhruf/control-plane/agent-control-plane.d.ts.map +1 -0
- package/dist/zukhruf/{agent-declaration-registry.d.ts → control-plane/agent-declaration-registry.d.ts} +1 -1
- package/dist/zukhruf/control-plane/agent-declaration-registry.d.ts.map +1 -0
- package/dist/zukhruf/{agent-directory.d.ts → control-plane/agent-directory.d.ts} +2 -1
- package/dist/zukhruf/control-plane/agent-directory.d.ts.map +1 -0
- package/dist/zukhruf/control-plane/agent-history-forker.d.ts +10 -0
- package/dist/zukhruf/control-plane/agent-history-forker.d.ts.map +1 -0
- package/dist/zukhruf/control-plane/agent-path.d.ts.map +1 -0
- package/dist/zukhruf/control-plane/agent-status-projector.d.ts +50 -0
- package/dist/zukhruf/control-plane/agent-status-projector.d.ts.map +1 -0
- package/dist/zukhruf/{agent-thread.d.ts → control-plane/agent-thread.d.ts} +1 -1
- package/dist/zukhruf/control-plane/agent-thread.d.ts.map +1 -0
- package/dist/zukhruf/{agent-turn-id.d.ts → control-plane/agent-turn-id.d.ts} +2 -1
- package/dist/zukhruf/control-plane/agent-turn-id.d.ts.map +1 -0
- package/dist/zukhruf/control-plane/fork-turns.d.ts +4 -0
- package/dist/zukhruf/control-plane/fork-turns.d.ts.map +1 -0
- package/dist/zukhruf/index.d.ts +6 -6
- package/dist/zukhruf/index.d.ts.map +1 -1
- package/dist/zukhruf/index.js +1316 -434
- package/dist/zukhruf/index.js.map +4 -4
- package/dist/zukhruf/mailbox/coordinator.d.ts +4 -0
- package/dist/zukhruf/mailbox/coordinator.d.ts.map +1 -1
- package/dist/zukhruf/multi-agent-v2-config.d.ts +32 -0
- package/dist/zukhruf/multi-agent-v2-config.d.ts.map +1 -0
- package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts +16 -4
- package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts.map +1 -1
- package/dist/zukhruf/queue/turn-queue.d.ts +35 -6
- package/dist/zukhruf/queue/turn-queue.d.ts.map +1 -1
- package/dist/zukhruf/render-turn.d.ts +9 -0
- package/dist/zukhruf/render-turn.d.ts.map +1 -0
- package/dist/zukhruf/{agent-runtime.d.ts → runtime/agent-runtime.d.ts} +23 -12
- package/dist/zukhruf/runtime/agent-runtime.d.ts.map +1 -0
- package/dist/zukhruf/{agent-turn-executor.d.ts → runtime/agent-turn-executor.d.ts} +5 -3
- package/dist/zukhruf/runtime/agent-turn-executor.d.ts.map +1 -0
- package/dist/zukhruf/{approval-controller.d.ts → runtime/approval-controller.d.ts} +19 -8
- package/dist/zukhruf/runtime/approval-controller.d.ts.map +1 -0
- package/dist/zukhruf/runtime/approval-job-id.d.ts +3 -0
- package/dist/zukhruf/runtime/approval-job-id.d.ts.map +1 -0
- package/dist/zukhruf/tool.d.ts +18 -6
- package/dist/zukhruf/tool.d.ts.map +1 -1
- package/package.json +9 -9
- package/dist/zukhruf/agent-control-plane.d.ts.map +0 -1
- package/dist/zukhruf/agent-declaration-registry.d.ts.map +0 -1
- package/dist/zukhruf/agent-directory.d.ts.map +0 -1
- package/dist/zukhruf/agent-path.d.ts.map +0 -1
- package/dist/zukhruf/agent-runtime.d.ts.map +0 -1
- package/dist/zukhruf/agent-status-projector.d.ts +0 -32
- package/dist/zukhruf/agent-status-projector.d.ts.map +0 -1
- package/dist/zukhruf/agent-thread.d.ts.map +0 -1
- package/dist/zukhruf/agent-tool-context.d.ts +0 -6
- package/dist/zukhruf/agent-tool-context.d.ts.map +0 -1
- package/dist/zukhruf/agent-turn-executor.d.ts.map +0 -1
- package/dist/zukhruf/agent-turn-id.d.ts.map +0 -1
- package/dist/zukhruf/approval-controller.d.ts.map +0 -1
- package/dist/zukhruf/approval-mutex.d.ts +0 -5
- package/dist/zukhruf/approval-mutex.d.ts.map +0 -1
- package/dist/zukhruf/list-agents.d.ts.map +0 -1
- package/dist/zukhruf/message-tools.d.ts.map +0 -1
- package/dist/zukhruf/spawn-agent.d.ts.map +0 -1
- package/dist/zukhruf/sqlite-approval-mutex.d.ts +0 -17
- package/dist/zukhruf/sqlite-approval-mutex.d.ts.map +0 -1
- /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
|
-
|
|
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
|
|
31
|
-
`defineInstructions` / `defineTool` / `defineSandbox`),
|
|
32
|
-
store/queue ports and adapters.
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
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)
|
|
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)
|
|
45
|
-
[`demo/zukhruf-research-bot`](../../demo/zukhruf-research-bot) (
|
|
46
|
-
|
|
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.
|