@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
@@ -18,5 +18,9 @@ export declare class MailboxCoordinator {
18
18
  }): Promise<void>;
19
19
  drainLeadingQueueOnly(recipient: ConversationId): Promise<InterAgentCommunication[]>;
20
20
  drain(recipient: ConversationId): Promise<InterAgentCommunication[]>;
21
+ waitForPending(recipient: ConversationId, options: {
22
+ timeoutMs: number;
23
+ signal?: AbortSignal;
24
+ }): Promise<boolean>;
21
25
  }
22
26
  //# sourceMappingURL=coordinator.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,gFAAgF;AAChF,qBAAa,kBAAkB;;gBAMjB,OAAO,EAAE,yBAAyB;IAMxC,OAAO,CACX,aAAa,EAAE,uBAAuB,EACtC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC;IAmBhB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CACX,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GACjC,OAAO,CAAC,IAAI,CAAC;IAUhB,qBAAqB,CACnB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAIrC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;CA0CrE"}
1
+ {"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/coordinator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC;CACxB;AAID,gFAAgF;AAChF,qBAAa,kBAAkB;;gBAMjB,OAAO,EAAE,yBAAyB;IAMxC,OAAO,CACX,aAAa,EAAE,uBAAuB,EACtC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC;IAmBhB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CACX,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GACjC,OAAO,CAAC,IAAI,CAAC;IAUhB,qBAAqB,CACnB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAIrC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAI9D,cAAc,CAClB,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACnD,OAAO,CAAC,OAAO,CAAC;CAmDpB"}
@@ -0,0 +1,32 @@
1
+ /** Host-level controls matching Codex MultiAgentV2 configuration. */
2
+ export interface MultiAgentV2HostConfig {
3
+ minWaitTimeoutMs?: number;
4
+ defaultWaitTimeoutMs?: number;
5
+ maxWaitTimeoutMs?: number;
6
+ /** Additional guidance appended to the spawn_agent tool description. */
7
+ usageHintText?: string;
8
+ /** Complete root guidance override. An empty string disables the hint. */
9
+ rootAgentUsageHintText?: string;
10
+ /** Complete child guidance override. An empty string disables the hint. */
11
+ subagentUsageHintText?: string;
12
+ /** Native OpenAI Responses namespace for the six collaboration tools. */
13
+ toolNamespace?: string;
14
+ /**
15
+ * Keeps collaboration tools on the direct model surface instead of a nested
16
+ * code-mode executor. Defaults to true. Zukhruf currently rejects false
17
+ * because it has no nested code-mode executor in which to expose the tools.
18
+ */
19
+ nonCodeModeOnly?: boolean;
20
+ }
21
+ export interface ResolvedMultiAgentV2HostConfig {
22
+ minWaitTimeoutMs: number;
23
+ defaultWaitTimeoutMs: number;
24
+ maxWaitTimeoutMs: number;
25
+ usageHintText?: string;
26
+ rootAgentUsageHintText?: string;
27
+ subagentUsageHintText?: string;
28
+ toolNamespace?: string;
29
+ nonCodeModeOnly: boolean;
30
+ }
31
+ export declare function resolveMultiAgentV2HostConfig(input?: MultiAgentV2HostConfig): ResolvedMultiAgentV2HostConfig;
32
+ //# sourceMappingURL=multi-agent-v2-config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"multi-agent-v2-config.d.ts","sourceRoot":"","sources":["../../src/zukhruf/multi-agent-v2-config.ts"],"names":[],"mappings":"AAqBA,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,GAAE,sBAA2B,GACjC,8BAA8B,CA2EhC"}
@@ -1,7 +1,9 @@
1
1
  import type { PgBoss } from 'pg-boss';
2
- import { type ConsumeContext, type ConsumeOptions, type TurnActivity, TurnQueue, type TurnRef } from './turn-queue.ts';
2
+ import { type ConsumeContext, type ConsumeOptions, type TurnActivity, type TurnPushResult, TurnQueue, type TurnRef } from './turn-queue.ts';
3
3
  export interface PgBossTurnQueueOptions {
4
4
  queue?: string;
5
+ /** Required for custom DB adapters; must match the PgBoss schema. */
6
+ schema?: string;
5
7
  /** Hard cap on one turn attempt; the job fails past this. */
6
8
  expireInSeconds?: number;
7
9
  /** Dead-worker detection window; must be >= 10 (pg-boss constraint). */
@@ -12,8 +14,11 @@ export interface PgBossTurnQueueOptions {
12
14
  * TurnQueue on pg-boss.
13
15
  *
14
16
  * - `key_strict_fifo` policy with `singletonKey = chatId` gives the per-chat
15
- * serialization contract structurally: one active turn per chat, strict
16
- * push order, cross-chat concurrency.
17
+ * serialization contract structurally: one active turn per chat and strict
18
+ * push order.
19
+ * - `group.id = chatId` with global `groupConcurrency: 1` excludes an active
20
+ * chat before pg-boss selects the next job, so its queued successor cannot
21
+ * block ready turns from other chats.
17
22
  * - `retryLimit: 0` — a crashed turn is never silently re-run (its bash
18
23
  * already executed). It dead-letters instead.
19
24
  * - A failed job blocks its chat's key until acknowledged; the dead-letter
@@ -27,6 +32,11 @@ export interface PgBossTurnQueueOptions {
27
32
  * (`retentionSeconds`, which governs still-`created` jobs, can't be 0; its
28
33
  * default 14d is never approached because a queued turn only waits behind one
29
34
  * running turn.)
35
+ * - Interrupting an active turn aborts the adapter-local handler but leaves its
36
+ * pg-boss row `active` until that handler exits. Cancelling the row itself
37
+ * would surrender the strict-FIFO key early and let the successor overlap.
38
+ * Cross-process handler abort comes from the runtime's durable stream
39
+ * cancellation; this queue remains the scheduler-ordering authority.
30
40
  *
31
41
  * The `PgBoss` instance is borrowed: the caller `start()`s and `stop()`s it.
32
42
  */
@@ -36,8 +46,10 @@ export declare class PgBossTurnQueue extends TurnQueue {
36
46
  get queue(): string;
37
47
  get deadLetterQueue(): string;
38
48
  initialize(): Promise<void>;
39
- push(turn: TurnRef): Promise<void>;
49
+ push(turn: TurnRef): Promise<TurnPushResult>;
40
50
  getTurnActivity(conversation: Pick<TurnRef, 'chatId' | 'userId'>): Promise<TurnActivity>;
51
+ getCurrentTurn(conversation: Pick<TurnRef, 'chatId' | 'userId'>): Promise<TurnRef | undefined>;
52
+ cancel(streamId: string): Promise<void>;
41
53
  consume(handler: (turn: TurnRef, context: ConsumeContext) => Promise<void>, options: ConsumeOptions): Promise<AsyncDisposable>;
42
54
  resumeParked(chatId: string): Promise<void>;
43
55
  }
@@ -1 +1 @@
1
- {"version":3,"file":"pg-boss.turn-queue.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/queue/pg-boss.turn-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,SAAS,CAAC;AAGvD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,SAAS,EACT,KAAK,OAAO,EACb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAgB,SAAQ,SAAS;;gBAOhC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;IAS9D,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzB,eAAe,CAC5B,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC/C,OAAO,CAAC,YAAY,CAAC;IAiBlB,OAAO,CACX,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EAClE,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;IAkErB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmBlD"}
1
+ {"version":3,"file":"pg-boss.turn-queue.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/queue/pg-boss.turn-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,SAAS,CAAC;AAIvD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,SAAS,EACT,KAAK,OAAO,EACb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,eAAgB,SAAQ,SAAS;;gBAchC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;IAmC9D,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6C3B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IA2BnC,eAAe,CAC5B,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC/C,OAAO,CAAC,YAAY,CAAC;IAiBT,cAAc,CAC3B,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC/C,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAehB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BhD,OAAO,CACX,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EAClE,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;IAgFrB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA6GlD"}
@@ -14,11 +14,21 @@ export type TurnRef = {
14
14
  input: string;
15
15
  } | {
16
16
  /**
17
- * Re-execution of an existing (reopened) stream after a tool approval
18
- * or denial. Carries no payload: the chain was already updated in
19
- * place by `approve()`/`deny()`.
17
+ * Recovery-only re-execution of an existing stream. Normal approval
18
+ * responses resume directly inside their approval job.
20
19
  */
21
20
  kind: 'continuation';
21
+ recovery?: 'handoff' | 'idempotent';
22
+ } | {
23
+ kind: 'approval';
24
+ toolCallId: string;
25
+ approvalId: string;
26
+ decision: {
27
+ approved: true;
28
+ } | {
29
+ approved: false;
30
+ reason?: string;
31
+ };
22
32
  } | {
23
33
  /**
24
34
  * A mailbox wake-up. The communication payload remains in MailboxStore;
@@ -26,6 +36,13 @@ export type TurnRef = {
26
36
  */
27
37
  kind: 'mailbox';
28
38
  });
39
+ export interface TurnPushResult {
40
+ jobId: string;
41
+ inserted: boolean;
42
+ }
43
+ export type ApprovalTurnRef = Extract<TurnRef, {
44
+ kind: 'approval';
45
+ }>;
29
46
  export interface ConsumeContext {
30
47
  signal: AbortSignal;
31
48
  /**
@@ -51,17 +68,25 @@ export type TurnActivity = 'idle' | 'queued' | 'running';
51
68
  *
52
69
  * Contract every implementation must honor:
53
70
  * - `push` is durable: a pushed turn survives process death until consumed.
54
- * - Delivery is AT-LEAST-ONCE: a pushed turn is delivered until settled, and
71
+ * - Delivery is AT-LEAST-ONCE: a pushed non-approval turn is delivered until settled, and
55
72
  * duplicate pushes of the same `streamId` may each be delivered. Consumers
56
73
  * MUST be idempotent on `streamId` (the zukhruf runtime skips turns whose
57
74
  * stream row is terminal — a check that, unlike queue-side dedup, never
58
75
  * expires with job retention).
76
+ * - Approval pushes use their persisted approval id as a deterministic job
77
+ * identity. The first decision inserts; later decisions for that approval
78
+ * report the existing job instead of adding a row.
59
79
  * - Per chat, at most ONE handler invocation is active at a time, and turns
60
80
  * run in the order they were pushed (strict FIFO per `chatId`) — this
61
81
  * covers duplicates too: they can never run concurrently or out of order.
62
82
  * - Turns from different chats may run concurrently.
63
83
  * - `getTurnActivity` distinguishes queued from active scheduler work for
64
84
  * status inspection; adapters must not silently fall back to stale history.
85
+ * - `getCurrentTurn` returns the active turn, or otherwise the oldest eligible
86
+ * queued turn, for exact interruption. `cancel` removes queued copies of that
87
+ * exact stream and signals an adapter-local active handler, but an active turn
88
+ * retains FIFO ownership until its handler exits. Cross-process handler abort
89
+ * is the runtime stream-control layer's responsibility.
65
90
  * - A handler that throws (or a worker that dies mid-turn) does not retry:
66
91
  * the turn surfaces once through `onOrphaned`, then the chat unblocks.
67
92
  * - Mailbox payloads NEVER live here. A `{kind: 'mailbox'}` item is only a
@@ -69,15 +94,19 @@ export type TurnActivity = 'idle' | 'queued' | 'running';
69
94
  * authority.
70
95
  * - A parked turn (`context.park()`) is not delivered again until
71
96
  * `resumeParked(chatId)`; revived turns keep their original FIFO order,
72
- * and a `'continuation'` turn pushed for the chat outranks them.
97
+ * and approval/recovery turns pushed for the chat outrank them.
73
98
  *
74
99
  * On platforms with native per-conversation serialization (e.g. Durable
75
100
  * Objects) this port is absorbed by the host rather than implemented.
76
101
  */
77
102
  export declare abstract class TurnQueue {
78
- abstract push(turn: TurnRef): Promise<void>;
103
+ abstract push(turn: TurnRef): Promise<TurnPushResult>;
79
104
  /** Whether this conversation currently has queued or active scheduler work. */
80
105
  abstract getTurnActivity(conversation: Pick<TurnRef, 'chatId' | 'userId'>): Promise<TurnActivity>;
106
+ /** Active turn, or the oldest eligible queued turn, for a conversation. */
107
+ abstract getCurrentTurn(conversation: Pick<TurnRef, 'chatId' | 'userId'>): Promise<TurnRef | undefined>;
108
+ /** Cancel queued copies and request local active cancellation by stream id. */
109
+ abstract cancel(streamId: string): Promise<void>;
81
110
  abstract consume(handler: (turn: TurnRef, context: ConsumeContext) => Promise<void>, options: ConsumeOptions): Promise<AsyncDisposable>;
82
111
  abstract resumeParked(chatId: string): Promise<void>;
83
112
  }
@@ -1 +1 @@
1
- {"version":3,"file":"turn-queue.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/queue/turn-queue.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,CACA;IACE,IAAI,EAAE,KAAK,CAAC;IACZ;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE;;;;OAIG;IACH,IAAI,EAAE,cAAc,CAAC;CACtB,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB,CACJ,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,8BAAsB,SAAS;IAC7B,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3C,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CACtB,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC/C,OAAO,CAAC,YAAY,CAAC;IAExB,QAAQ,CAAC,OAAO,CACd,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EAClE,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;IAE3B,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CACrD"}
1
+ {"version":3,"file":"turn-queue.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/queue/turn-queue.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,CACA;IACE,IAAI,EAAE,KAAK,CAAC;IACZ;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CACrC,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,KAAK,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE,GACD;IACE;;;OAGG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB,CACJ,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,8BAAsB,SAAS;IAC7B,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAErD,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CACtB,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC/C,OAAO,CAAC,YAAY,CAAC;IAExB,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CACrB,YAAY,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAC/C,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAE/B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhD,QAAQ,CAAC,OAAO,CACd,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EAClE,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC;IAE3B,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CACrD"}
@@ -0,0 +1,9 @@
1
+ import type { UIMessageChunk } from 'ai';
2
+ /**
3
+ * Render one turn stream as a conversation: assistant text streams raw, each
4
+ * tool call becomes a single dim line, and failures become a single red line.
5
+ * Reasoning shows up only as one dim ellipsis so silence never looks like a
6
+ * hang. Everything else in the chunk vocabulary is deliberately dropped.
7
+ */
8
+ export declare function renderTurn(stream: ReadableStream<UIMessageChunk>): Promise<void>;
9
+ //# sourceMappingURL=render-turn.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render-turn.d.ts","sourceRoot":"","sources":["../../src/zukhruf/render-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AA6BzC;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,CAAC,cAAc,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC,CAgDf"}
@@ -1,18 +1,19 @@
1
- import { ContextEngine, type ContextStore, StreamManager, type StreamStore } from '@deepagents/context';
2
- import { type TurnInput } from './agent-control-plane.ts';
3
- import type { AgentDeclaration } from './agent.ts';
4
- import type { ApprovalMutex } from './approval-mutex.ts';
5
- import type { MailboxStore } from './mailbox/store.ts';
6
- import type { ConversationId, InterAgentCommunication, MessageDeliveryMode } from './mailbox/types.ts';
7
- import type { TurnQueue } from './queue/turn-queue.ts';
1
+ import { ContextEngine, type ContextStore, type StreamManager } from '@deepagents/context';
2
+ import type { AgentDeclaration } from '../agent.ts';
3
+ import { type TurnInput } from '../control-plane/agent-control-plane.ts';
4
+ import type { MailboxStore } from '../mailbox/store.ts';
5
+ import type { ConversationId, InterAgentCommunication, MessageDeliveryMode } from '../mailbox/types.ts';
6
+ import { type MultiAgentV2HostConfig } from '../multi-agent-v2-config.ts';
7
+ import type { TurnQueue } from '../queue/turn-queue.ts';
8
8
  export interface AgentRuntimeOptions {
9
9
  store: ContextStore;
10
- streamStore: StreamStore;
10
+ /** Borrowed stream subsystem; the caller owns its store, change source, and lifecycle. */
11
+ streams: StreamManager;
11
12
  queue: TurnQueue;
12
13
  /** Durable pending inter-agent input. Distinct from the TurnQueue scheduler. */
13
14
  mailboxStore: MailboxStore;
14
- /** Cross-process serialization for assistant-message approval transitions. */
15
- approvalMutex: ApprovalMutex;
15
+ /** Codex MultiAgentV2-compatible host guidance and tool configuration. */
16
+ multiAgentV2?: MultiAgentV2HostConfig;
16
17
  }
17
18
  export interface AgentRuntimeWorkOptions {
18
19
  concurrency?: number;
@@ -38,14 +39,24 @@ export declare class AgentRuntime {
38
39
  toolCallId: string;
39
40
  }): Promise<{
40
41
  id: string;
41
- stream: ReadableStream<import("@deepagents/context").StreamPart>;
42
+ jobId: string;
43
+ status: "already-applied";
44
+ } | {
45
+ id: string;
46
+ jobId: string;
47
+ status: "queued" | "already-queued";
42
48
  }>;
43
49
  deny(conversation: ConversationId, input: {
44
50
  toolCallId: string;
45
51
  reason?: string;
46
52
  }): Promise<{
47
53
  id: string;
48
- stream: ReadableStream<import("@deepagents/context").StreamPart>;
54
+ jobId: string;
55
+ status: "already-applied";
56
+ } | {
57
+ id: string;
58
+ jobId: string;
59
+ status: "queued" | "already-queued";
49
60
  }>;
50
61
  observe(conversation: ConversationId): AgentObservation;
51
62
  work(options?: AgentRuntimeWorkOptions): Promise<AsyncDisposable>;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/runtime/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,yCAAyC,CAAC;AAOjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,wBAAwB,CAAC;AAIjE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,0FAA0F;IAC1F,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,gFAAgF;IAChF,YAAY,EAAE,YAAY,CAAC;IAC3B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,sBAAsB,CAAC;CACvC;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,qBAAa,gBAAgB;;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAM7B,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa;IAYlB,MAAM;IAQN,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB/C;AAED,kFAAkF;AAClF,qBAAa,YAAY;;gBAUX,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,mBAAmB;IAmD1D,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS;;;;IAKrD,OAAO,CACX,aAAa,EAAE,uBAAuB,EACtC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC;IAKhB,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;;;;;;;;;IAInE,IAAI,CACF,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;IAKhD,OAAO,CAAC,YAAY,EAAE,cAAc,GAAG,gBAAgB;IAIvD,IAAI,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;CAsFlE"}
@@ -1,14 +1,16 @@
1
1
  import { type ContextStore, type StreamManager } from '@deepagents/context';
2
- import type { AgentControlPlane } from './agent-control-plane.ts';
2
+ import type { AgentControlPlane } from '../control-plane/agent-control-plane.ts';
3
+ import type { MailboxCoordinator } from '../mailbox/coordinator.ts';
4
+ import type { ResolvedMultiAgentV2HostConfig } from '../multi-agent-v2-config.ts';
5
+ import type { ConsumeContext, TurnRef } from '../queue/turn-queue.ts';
3
6
  import type { ApprovalController } from './approval-controller.ts';
4
- import type { MailboxCoordinator } from './mailbox/coordinator.ts';
5
- import type { ConsumeContext, TurnRef } from './queue/turn-queue.ts';
6
7
  export interface AgentTurnExecutorOptions {
7
8
  store: ContextStore;
8
9
  streams: StreamManager;
9
10
  controlPlane: AgentControlPlane;
10
11
  mailbox: MailboxCoordinator;
11
12
  approvals: ApprovalController;
13
+ multiAgentV2: ResolvedMultiAgentV2HostConfig;
12
14
  }
13
15
  /** Executes one queued turn without owning host lifecycle or agent routing. */
14
16
  export declare class AgentTurnExecutor {
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-turn-executor.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/runtime/agent-turn-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAMnB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAKpE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,iBAAiB,CAAC;IAChC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,YAAY,EAAE,8BAA8B,CAAC;CAC9C;AAMD,+EAA+E;AAC/E,qBAAa,iBAAiB;;gBAShB,OAAO,EAAE,wBAAwB;IAUvC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA0PrE"}
@@ -1,13 +1,11 @@
1
1
  import { type UIMessage } from 'ai';
2
- import { type ContextStore, type StreamManager } from '@deepagents/context';
3
- import type { ApprovalMutex } from './approval-mutex.ts';
4
- import type { ConversationId } from './mailbox/types.ts';
5
- import type { TurnQueue } from './queue/turn-queue.ts';
2
+ import { type ContextStore } from '@deepagents/context';
3
+ import type { ConversationId } from '../mailbox/types.ts';
4
+ import type { ApprovalTurnRef, TurnQueue, TurnRef } from '../queue/turn-queue.ts';
5
+ import type { ZukhrufToolSet } from '../tool.ts';
6
6
  export interface ApprovalControllerOptions {
7
7
  store: ContextStore;
8
- streams: StreamManager;
9
8
  queue: TurnQueue;
10
- mutex: ApprovalMutex;
11
9
  }
12
10
  /** Durable approval-response and continuation state machine. */
13
11
  export declare class ApprovalController {
@@ -18,17 +16,30 @@ export declare class ApprovalController {
18
16
  toolCallId: string;
19
17
  }): Promise<{
20
18
  id: string;
21
- stream: ReadableStream<import("@deepagents/context").StreamPart>;
19
+ jobId: string;
20
+ status: "already-applied";
21
+ } | {
22
+ id: string;
23
+ jobId: string;
24
+ status: "queued" | "already-queued";
22
25
  }>;
23
26
  deny(conversation: ConversationId, input: {
24
27
  toolCallId: string;
25
28
  reason?: string;
26
29
  }): Promise<{
27
30
  id: string;
28
- stream: ReadableStream<import("@deepagents/context").StreamPart>;
31
+ jobId: string;
32
+ status: "already-applied";
33
+ } | {
34
+ id: string;
35
+ jobId: string;
36
+ status: "queued" | "already-queued";
29
37
  }>;
30
38
  settleDeniedApprovals(conversation: ConversationId, streamId: string): Promise<void>;
31
39
  settleFailedApprovals(conversation: ConversationId, streamId: string, error: string): Promise<void>;
32
40
  reconcileTerminalContinuation(conversation: ConversationId, streamId: string, status: 'completed' | 'failed' | 'cancelled', error?: string | null): Promise<void>;
41
+ retryIdempotentContinuation(conversation: ConversationId, streamId: string, tools: ZukhrufToolSet): Promise<boolean>;
42
+ applyDecision(turn: ApprovalTurnRef): Promise<boolean>;
43
+ recoverUnstartedContinuation(turn: TurnRef, streamId: string): Promise<boolean>;
33
44
  }
34
45
  //# sourceMappingURL=approval-controller.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval-controller.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/runtime/approval-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EAGf,MAAM,IAAI,CAAC;AAEZ,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,OAAO,EACR,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;CAClB;AAID,gEAAgE;AAChE,qBAAa,kBAAkB;;gBAUjB,OAAO,EAAE,yBAAyB;IAK9C,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO;IAOjD,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;;;;;;;;;IAMnE,IAAI,CACF,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;IAQ1C,qBAAqB,CACzB,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAiCV,qBAAqB,CACzB,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAmCV,6BAA6B,CACjC,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,EAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,IAAI,CAAC;IAaV,2BAA2B,CAC/B,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,OAAO,CAAC;IA6Bb,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBtD,4BAA4B,CAChC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;CA2GpB"}
@@ -0,0 +1,3 @@
1
+ import type { ConversationId } from '../mailbox/types.ts';
2
+ export declare function approvalJobId(conversation: ConversationId, approvalId: string): string;
3
+ //# sourceMappingURL=approval-job-id.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approval-job-id.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/runtime/approval-job-id.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,wBAAgB,aAAa,CAC3B,YAAY,EAAE,cAAc,EAC5B,UAAU,EAAE,MAAM,GACjB,MAAM,CAER"}
@@ -1,7 +1,19 @@
1
- /**
2
- * Declaration-layer tool definition: a pure passthrough of the AI SDK's
3
- * `tool()` (full generics, zero side effects). Set `needsApproval: true` to
4
- * pause the turn on this tool's call until `runtime.approve()`/`deny()`.
5
- */
6
- export { tool as defineTool } from 'ai';
1
+ import { type Tool, type ToolExecuteFunction, type ToolSet } from 'ai';
2
+ export type ToolRecovery = 'idempotent';
3
+ export type ZukhrufTool<INPUT, OUTPUT, CONTEXT extends Record<string, unknown>> = Tool<INPUT, OUTPUT, CONTEXT> & {
4
+ /** Allows one automatic replay after a worker crash. */
5
+ recovery?: ToolRecovery;
6
+ };
7
+ export type ZukhrufToolSet = ToolSet & Record<string, {
8
+ recovery?: ToolRecovery;
9
+ }>;
10
+ export declare function defineTool<INPUT, OUTPUT, CONTEXT extends Record<string, unknown>>(definition: ZukhrufTool<INPUT, OUTPUT, CONTEXT> & {
11
+ execute: ToolExecuteFunction<INPUT, OUTPUT, CONTEXT>;
12
+ }): ZukhrufTool<INPUT, OUTPUT, CONTEXT> & {
13
+ execute: ToolExecuteFunction<INPUT, OUTPUT, CONTEXT>;
14
+ };
15
+ export declare function defineTool<INPUT, OUTPUT, CONTEXT extends Record<string, unknown>>(definition: ZukhrufTool<INPUT, OUTPUT, CONTEXT>): ZukhrufTool<INPUT, OUTPUT, CONTEXT>;
16
+ export declare function defineTool<INPUT, CONTEXT extends Record<string, unknown>>(definition: ZukhrufTool<INPUT, never, CONTEXT>): ZukhrufTool<INPUT, never, CONTEXT>;
17
+ export declare function defineTool<OUTPUT, CONTEXT extends Record<string, unknown>>(definition: ZukhrufTool<never, OUTPUT, CONTEXT>): ZukhrufTool<never, OUTPUT, CONTEXT>;
18
+ export declare function defineTool<CONTEXT extends Record<string, unknown>>(definition: ZukhrufTool<never, never, CONTEXT>): ZukhrufTool<never, never, CONTEXT>;
7
19
  //# sourceMappingURL=tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/zukhruf/tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,IAAI,CAAC"}
1
+ {"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/zukhruf/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,mBAAmB,EAAE,KAAK,OAAO,EAAQ,MAAM,IAAI,CAAC;AAE7E,MAAM,MAAM,YAAY,GAAG,YAAY,CAAC;AAExC,MAAM,MAAM,WAAW,CACrB,KAAK,EACL,MAAM,EACN,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACrC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG;IACjC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,OAAO,GAClC,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AAE9C,wBAAgB,UAAU,CACxB,KAAK,EACL,MAAM,EACN,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEvC,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG;IAChD,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;CACtD,GACA,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG;IACvC,OAAO,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;CACtD,CAAC;AACF,wBAAgB,UAAU,CACxB,KAAK,EACL,MAAM,EACN,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEvC,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAC9C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAC7C,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACtC,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,GAC9C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,wBAAgB,UAAU,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAC7C,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepagents/experimental",
3
- "version": "5.0.0",
3
+ "version": "6.0.0",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -43,17 +43,17 @@
43
43
  "access": "public"
44
44
  },
45
45
  "dependencies": {
46
- "@deepagents/context": "5.0.0",
47
- "ai": "^7.0.20",
48
- "just-bash": "^3.0.1",
49
- "pg-boss": "^12.24.1",
46
+ "@deepagents/context": "6.0.0",
47
+ "ai": "^7.0.30",
48
+ "just-bash": "^3.1.0",
49
+ "pg-boss": "^12.26.1",
50
50
  "tiny-tfidf": "^1.0.0",
51
- "uuid": "^13.0.2",
52
- "zod": "^3.25.76 || ^4.0.0"
51
+ "uuid": "^14.0.1",
52
+ "zod": "^4.4.3"
53
53
  },
54
54
  "devDependencies": {
55
55
  "@ai-sdk/provider": "^4.0.3",
56
- "@electric-sql/pglite": "^0.5.3",
57
- "just-bash": "^3.0.1"
56
+ "@electric-sql/pglite": "^0.5.4",
57
+ "just-bash": "^3.1.0"
58
58
  }
59
59
  }
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-control-plane.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-control-plane.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAM9E,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,YAAY,EAAE,wBAAwB,CAAC;IACvC,SAAS,EAAE,cAAc,CAAC;IAC1B,eAAe,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY,EACV,WAAW,EACX,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAErC,kEAAkE;AAClE,qBAAa,iBAAiB;;gBAShB,OAAO,EAAE,wBAAwB;IAUvC,OAAO,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC;QACnD,WAAW,EAAE,gBAAgB,CAAC;QAC9B,MAAM,EAAE,WAAW,CAAC;KACrB,CAAC;IAcI,OAAO,CACX,YAAY,EAAE,cAAc,EAC5B,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;IAmBlB,gBAAgB,CACd,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC;IAIvB,yBAAyB,CACvB,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAQ7B,KAAK,CACT,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC;IAiDtB,WAAW,CACf,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQxB,YAAY,CAChB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQxB,UAAU,CACd,KAAK,EAAE,UAAU,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAiB/B,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAsCzE"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-declaration-registry.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-declaration-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wEAAwE;AACxE,qBAAa,wBAAwB;;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;gBAIpB,IAAI,EAAE,gBAAgB;IAKlC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;CAgChD"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-directory.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-directory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,gEAAgE;AAChE,qBAAa,cAAc;;gBAGb,KAAK,EAAE,YAAY;IAIzB,mBAAmB,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhE,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IASpE,gBAAgB,CACpB,YAAY,EAAE,cAAc,EAC5B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,WAAW,CAAC;IAyBjB,gBAAgB,CACpB,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC;IAIjB,yBAAyB,CAC7B,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAI7B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoBrD,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASlE,WAAW,CAAC,OAAO,EAAE;QACzB,MAAM,EAAE,WAAW,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,WAAW,CAAC;CA6IzB"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-path.d.ts","sourceRoot":"","sources":["../../src/zukhruf/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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,YAAY,EAEjB,aAAa,EACb,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAM7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,uBAAuB,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,gFAAgF;IAChF,YAAY,EAAE,YAAY,CAAC;IAC3B,8EAA8E;IAC9E,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,qBAAa,gBAAgB;;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAM7B,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa;IAYlB,MAAM;IAQN,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoB/C;AAED,kFAAkF;AAClF,qBAAa,YAAY;;gBAUX,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,mBAAmB;IAoD1D,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS;;;;IAKrD,OAAO,CACX,aAAa,EAAE,uBAAuB,EACtC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC;IAKhB,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;;;;IAInE,IAAI,CACF,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;IAKhD,OAAO,CAAC,YAAY,EAAE,cAAc,GAAG,gBAAgB;IAIvD,IAAI,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;CAqDlE"}
@@ -1,32 +0,0 @@
1
- import { type ContextStore, type StreamManager } from '@deepagents/context';
2
- import type { AgentDirectory } from './agent-directory.ts';
3
- import type { AgentThread } from './agent-thread.ts';
4
- import type { ApprovalController } from './approval-controller.ts';
5
- import type { MailboxCoordinator } from './mailbox/coordinator.ts';
6
- import type { TurnQueue, TurnRef } from './queue/turn-queue.ts';
7
- export type ListedAgentStatus = 'pending_init' | 'running' | 'waiting_approval' | 'interrupted' | {
8
- completed: string | null;
9
- } | {
10
- errored: string;
11
- };
12
- export interface ListedAgent {
13
- agent_name: string;
14
- agent_status: ListedAgentStatus;
15
- last_task_message: string | null;
16
- }
17
- export interface AgentStatusProjectorOptions {
18
- store: ContextStore;
19
- streams: StreamManager;
20
- queue: TurnQueue;
21
- mailbox: MailboxCoordinator;
22
- directory: AgentDirectory;
23
- approvals: ApprovalController;
24
- }
25
- /** Projects durable execution state into agent-facing status and terminal mail. */
26
- export declare class AgentStatusProjector {
27
- #private;
28
- constructor(options: AgentStatusProjectorOptions);
29
- projectListedAgent(currentTurn: TurnRef, thread: AgentThread): Promise<ListedAgent>;
30
- projectTerminal(turn: TurnRef, thread: AgentThread): Promise<void>;
31
- }
32
- //# sourceMappingURL=agent-status-projector.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-status-projector.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-status-projector.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAMnE,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,SAAS,GACT,kBAAkB,GAClB,aAAa,GACb;IAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC5B;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,iBAAiB,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,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;IAkCjB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CA0GzE"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-thread.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,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,6 +0,0 @@
1
- import type { AgentActor, AgentControlPlane } from './agent-control-plane.ts';
2
- export interface AgentToolContext extends Record<string, unknown> {
3
- controlPlane: AgentControlPlane;
4
- actor: AgentActor;
5
- }
6
- //# sourceMappingURL=agent-tool-context.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-tool-context.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-tool-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,YAAY,EAAE,iBAAiB,CAAC;IAChC,KAAK,EAAE,UAAU,CAAC;CACnB"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-turn-executor.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-turn-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAKnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAMnE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrE,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,iBAAiB,CAAC;IAChC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAMD,+EAA+E;AAC/E,qBAAa,iBAAiB;;gBAOhB,OAAO,EAAE,wBAAwB;IAQvC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAiOrE"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"agent-turn-id.d.ts","sourceRoot":"","sources":["../../src/zukhruf/agent-turn-id.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,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;CAanB"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"approval-controller.d.ts","sourceRoot":"","sources":["../../src/zukhruf/approval-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EAEf,MAAM,IAAI,CAAC;AAEZ,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB;AAID,gEAAgE;AAChE,qBAAa,kBAAkB;;gBAYjB,OAAO,EAAE,yBAAyB;IAO9C,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO;IAOjD,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;;;;IAMnE,IAAI,CACF,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;IAQ1C,qBAAqB,CACzB,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAyBV,qBAAqB,CACzB,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAwBV,6BAA6B,CACjC,YAAY,EAAE,cAAc,EAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,EAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,IAAI,CAAC;CA6IjB"}
@@ -1,5 +0,0 @@
1
- /** Serializes approval state transitions for one durable conversation. */
2
- export declare abstract class ApprovalMutex {
3
- abstract runExclusive<T>(conversationId: string, operation: () => Promise<T>): Promise<T>;
4
- }
5
- //# sourceMappingURL=approval-mutex.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"approval-mutex.d.ts","sourceRoot":"","sources":["../../src/zukhruf/approval-mutex.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8BAAsB,aAAa;IACjC,QAAQ,CAAC,YAAY,CAAC,CAAC,EACrB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC;CACd"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"list-agents.d.ts","sourceRoot":"","sources":["../../src/zukhruf/list-agents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAehE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;oBAEf,WAAW,EAAE;;;;;gBAAb,WAAW,EAAE;;;;;gBAAb,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;gBAAb,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAAb,WAAW,EAAE;;;;;gBAAb,WAAW,EAAE;;;;;gBAAb,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;gBAAb,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAAb,WAAW,EAAE;;;;;gBAAb,WAAW,EAAE;;;;;gBAAb,WAAW,EAAE;;;;;;;;;;;;;;;;gBAAb,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAAb,WAAW,EAAE;;;;;gBAAb,WAAW,EAAE;;;;;gBAAb,WAAW,EAAE;;;;;;;;;;;;;;;;gBAAb,WAAW,EAAE;;EAQvB,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"message-tools.d.ts","sourceRoot":"","sources":["../../src/zukhruf/message-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAchE,KAAK,kBAAkB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU3B,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"spawn-agent.d.ts","sourceRoot":"","sources":["../../src/zukhruf/spawn-agent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAyBhE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAEZ,MAAM;wBAAc,MAAM;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAA1B,MAAM;wBAAc,MAAM;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAA1B,MAAM;wBAAc,MAAM;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;;;;;;;;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAA1B,MAAM;wBAAc,MAAM;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;mBAA1B,MAAM;oBAAc,MAAM;;;;;;;;;;;;;;;;;;mBAA1B,MAAM;oBAAc,MAAM;;EAgBvC,CAAC"}
@@ -1,17 +0,0 @@
1
- import { ApprovalMutex } from './approval-mutex.ts';
2
- /**
3
- * Cross-process approval mutex backed by a dedicated SQLite database.
4
- *
5
- * SQLite write locks are database-wide, so one file serializes all approval
6
- * transitions that use it. Do not use the ContextStore database file: the
7
- * protected operation must be able to persist the assistant message while this
8
- * transaction is open.
9
- */
10
- export declare class SqliteApprovalMutex extends ApprovalMutex implements Disposable {
11
- #private;
12
- constructor(path: string);
13
- runExclusive<T>(conversationId: string, operation: () => Promise<T>): Promise<T>;
14
- close(): void;
15
- [Symbol.dispose](): void;
16
- }
17
- //# sourceMappingURL=sqlite-approval-mutex.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sqlite-approval-mutex.d.ts","sourceRoot":"","sources":["../../src/zukhruf/sqlite-approval-mutex.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;GAOG;AACH,qBAAa,mBAAoB,SAAQ,aAAc,YAAW,UAAU;;gBAM9D,IAAI,EAAE,MAAM;IAelB,YAAY,CAAC,CAAC,EAClB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC;IA8Bb,KAAK,IAAI,IAAI;IAIb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAmBzB"}