@deepagents/experimental 6.1.0 → 7.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 (129) hide show
  1. package/README.md +151 -10
  2. package/dist/coding-agent-reminders/types.d.ts.map +1 -1
  3. package/dist/index.js +3084 -1206
  4. package/dist/index.js.map +4 -4
  5. package/dist/providers/claude/index.d.ts +4 -0
  6. package/dist/providers/claude/index.d.ts.map +1 -0
  7. package/dist/providers/claude/index.js +196 -0
  8. package/dist/providers/claude/index.js.map +7 -0
  9. package/dist/providers/claude/local-credentials.d.ts +3 -0
  10. package/dist/providers/claude/local-credentials.d.ts.map +1 -0
  11. package/dist/providers/codex/generate-via-stream.d.ts +8 -0
  12. package/dist/providers/codex/generate-via-stream.d.ts.map +1 -0
  13. package/dist/providers/codex/index.d.ts +4 -0
  14. package/dist/providers/codex/index.d.ts.map +1 -0
  15. package/dist/providers/codex/index.js +358 -0
  16. package/dist/providers/codex/index.js.map +7 -0
  17. package/dist/providers/codex/local-credentials.d.ts +4 -0
  18. package/dist/providers/codex/local-credentials.d.ts.map +1 -0
  19. package/dist/providers/language-model-provider.d.ts +5 -0
  20. package/dist/providers/language-model-provider.d.ts.map +1 -0
  21. package/dist/zukhruf/agent.d.ts +17 -2
  22. package/dist/zukhruf/agent.d.ts.map +1 -1
  23. package/dist/zukhruf/collaboration/agent-tool-context.d.ts +2 -2
  24. package/dist/zukhruf/collaboration/agent-tool-context.d.ts.map +1 -1
  25. package/dist/zukhruf/collaboration/collaboration-tools.d.ts +1807 -3
  26. package/dist/zukhruf/collaboration/collaboration-tools.d.ts.map +1 -1
  27. package/dist/zukhruf/collaboration/spawn-agent.d.ts.map +1 -1
  28. package/dist/zukhruf/collaboration/wait-agent.d.ts.map +1 -1
  29. package/dist/zukhruf/control-plane/agent-control-plane.d.ts +6 -7
  30. package/dist/zukhruf/control-plane/agent-control-plane.d.ts.map +1 -1
  31. package/dist/zukhruf/control-plane/agent-declaration-registry.d.ts +1 -0
  32. package/dist/zukhruf/control-plane/agent-declaration-registry.d.ts.map +1 -1
  33. package/dist/zukhruf/control-plane/agent-status-projector.d.ts +6 -3
  34. package/dist/zukhruf/control-plane/agent-status-projector.d.ts.map +1 -1
  35. package/dist/zukhruf/control-plane/agent-thread.d.ts.map +1 -1
  36. package/dist/zukhruf/index.d.ts +7 -3
  37. package/dist/zukhruf/index.d.ts.map +1 -1
  38. package/dist/zukhruf/index.js +3085 -1207
  39. package/dist/zukhruf/index.js.map +4 -4
  40. package/dist/zukhruf/{multi-agent-v2-config.d.ts → multi-agent-config.d.ts} +14 -9
  41. package/dist/zukhruf/multi-agent-config.d.ts.map +1 -0
  42. package/dist/zukhruf/plugins/conversation-scheduling/conversation-scheduler.d.ts +76 -0
  43. package/dist/zukhruf/plugins/conversation-scheduling/conversation-scheduler.d.ts.map +1 -0
  44. package/dist/zukhruf/plugins/conversation-scheduling/index.d.ts +13 -0
  45. package/dist/zukhruf/plugins/conversation-scheduling/index.d.ts.map +1 -0
  46. package/dist/zukhruf/plugins/conversation-scheduling/index.js +999 -0
  47. package/dist/zukhruf/plugins/conversation-scheduling/index.js.map +7 -0
  48. package/dist/zukhruf/plugins/conversation-scheduling/pg-boss.wake-scheduler.d.ts +19 -0
  49. package/dist/zukhruf/plugins/conversation-scheduling/pg-boss.wake-scheduler.d.ts.map +1 -0
  50. package/dist/zukhruf/plugins/conversation-scheduling/tools.d.ts +1305 -0
  51. package/dist/zukhruf/plugins/conversation-scheduling/tools.d.ts.map +1 -0
  52. package/dist/zukhruf/plugins/conversation-scheduling/wake-scheduler.d.ts +12 -0
  53. package/dist/zukhruf/plugins/conversation-scheduling/wake-scheduler.d.ts.map +1 -0
  54. package/dist/zukhruf/plugins/http/index.d.ts +50 -0
  55. package/dist/zukhruf/plugins/http/index.d.ts.map +1 -0
  56. package/dist/zukhruf/plugins/http/index.js +618 -0
  57. package/dist/zukhruf/plugins/http/index.js.map +7 -0
  58. package/dist/zukhruf/plugins/http/parse.d.ts +3 -0
  59. package/dist/zukhruf/plugins/http/parse.d.ts.map +1 -0
  60. package/dist/zukhruf/plugins/http/validator.d.ts +64 -0
  61. package/dist/zukhruf/plugins/http/validator.d.ts.map +1 -0
  62. package/dist/zukhruf/plugins/mcp/index.d.ts +8 -0
  63. package/dist/zukhruf/plugins/mcp/index.d.ts.map +1 -0
  64. package/dist/zukhruf/plugins/mcp/index.js +25 -0
  65. package/dist/zukhruf/plugins/mcp/index.js.map +7 -0
  66. package/dist/zukhruf/plugins/schedules/http.d.ts +45 -0
  67. package/dist/zukhruf/plugins/schedules/http.d.ts.map +1 -0
  68. package/dist/zukhruf/plugins/schedules/http.js +528 -0
  69. package/dist/zukhruf/plugins/schedules/http.js.map +7 -0
  70. package/dist/zukhruf/plugins/schedules/index.d.ts +35 -0
  71. package/dist/zukhruf/plugins/schedules/index.d.ts.map +1 -0
  72. package/dist/zukhruf/plugins/schedules/index.js +1873 -0
  73. package/dist/zukhruf/plugins/schedules/index.js.map +7 -0
  74. package/dist/zukhruf/plugins/schedules/schedule-files.d.ts +6 -0
  75. package/dist/zukhruf/plugins/schedules/schedule-files.d.ts.map +1 -0
  76. package/dist/zukhruf/plugins/schedules/scheduled-tasks.d.ts +157 -0
  77. package/dist/zukhruf/plugins/schedules/scheduled-tasks.d.ts.map +1 -0
  78. package/dist/zukhruf/plugins/uploads/http.d.ts +27 -0
  79. package/dist/zukhruf/plugins/uploads/http.d.ts.map +1 -0
  80. package/dist/zukhruf/plugins/uploads/http.js +426 -0
  81. package/dist/zukhruf/plugins/uploads/http.js.map +7 -0
  82. package/dist/zukhruf/plugins/uploads/index.d.ts +73 -0
  83. package/dist/zukhruf/plugins/uploads/index.d.ts.map +1 -0
  84. package/dist/zukhruf/plugins/uploads/index.js +247 -0
  85. package/dist/zukhruf/plugins/uploads/index.js.map +7 -0
  86. package/dist/zukhruf/queue/pg-boss-notifications.d.ts +10 -0
  87. package/dist/zukhruf/queue/pg-boss-notifications.d.ts.map +1 -0
  88. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts +8 -11
  89. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts.map +1 -1
  90. package/dist/zukhruf/queue/turn-queue.d.ts +43 -38
  91. package/dist/zukhruf/queue/turn-queue.d.ts.map +1 -1
  92. package/dist/zukhruf/runtime/agent-runtime.d.ts +163 -43
  93. package/dist/zukhruf/runtime/agent-runtime.d.ts.map +1 -1
  94. package/dist/zukhruf/runtime/agent-turn-executor.d.ts +9 -2
  95. package/dist/zukhruf/runtime/agent-turn-executor.d.ts.map +1 -1
  96. package/dist/zukhruf/runtime/approval-controller.d.ts +10 -25
  97. package/dist/zukhruf/runtime/approval-controller.d.ts.map +1 -1
  98. package/dist/zukhruf/runtime/compaction.d.ts +47 -0
  99. package/dist/zukhruf/runtime/compaction.d.ts.map +1 -0
  100. package/dist/zukhruf/runtime/conversation-status/change-source.d.ts +19 -0
  101. package/dist/zukhruf/runtime/conversation-status/change-source.d.ts.map +1 -0
  102. package/dist/zukhruf/runtime/conversation-status/child-progress.d.ts +84 -0
  103. package/dist/zukhruf/runtime/conversation-status/child-progress.d.ts.map +1 -0
  104. package/dist/zukhruf/runtime/conversation-status/pg-boss-change-source.d.ts +22 -0
  105. package/dist/zukhruf/runtime/conversation-status/pg-boss-change-source.d.ts.map +1 -0
  106. package/dist/zukhruf/runtime/conversation-status/projector.d.ts +62 -0
  107. package/dist/zukhruf/runtime/conversation-status/projector.d.ts.map +1 -0
  108. package/dist/zukhruf/runtime/conversation-status/status-publishing-turn-queue.d.ts +20 -0
  109. package/dist/zukhruf/runtime/conversation-status/status-publishing-turn-queue.d.ts.map +1 -0
  110. package/dist/zukhruf/runtime/plugin/agent-skills.d.ts +22 -0
  111. package/dist/zukhruf/runtime/plugin/agent-skills.d.ts.map +1 -0
  112. package/dist/zukhruf/runtime/plugin/plugin-agents.d.ts +14 -0
  113. package/dist/zukhruf/runtime/plugin/plugin-agents.d.ts.map +1 -0
  114. package/dist/zukhruf/runtime/plugin/plugin-bindings.d.ts +8 -0
  115. package/dist/zukhruf/runtime/plugin/plugin-bindings.d.ts.map +1 -0
  116. package/dist/zukhruf/runtime/plugin/plugin-context-composition.d.ts +7 -0
  117. package/dist/zukhruf/runtime/plugin/plugin-context-composition.d.ts.map +1 -0
  118. package/dist/zukhruf/runtime/plugin/plugin-manager.d.ts +38 -0
  119. package/dist/zukhruf/runtime/plugin/plugin-manager.d.ts.map +1 -0
  120. package/dist/zukhruf/runtime/plugin/plugin-tool-composition.d.ts +10 -0
  121. package/dist/zukhruf/runtime/plugin/plugin-tool-composition.d.ts.map +1 -0
  122. package/dist/zukhruf/tool.d.ts +5 -1
  123. package/dist/zukhruf/tool.d.ts.map +1 -1
  124. package/package.json +74 -6
  125. package/dist/zukhruf/multi-agent-v2-config.d.ts.map +0 -1
  126. package/dist/zukhruf/runtime/agent-skills.d.ts +0 -9
  127. package/dist/zukhruf/runtime/agent-skills.d.ts.map +0 -1
  128. package/dist/zukhruf/runtime/approval-job-id.d.ts +0 -3
  129. package/dist/zukhruf/runtime/approval-job-id.d.ts.map +0 -1
@@ -1,34 +1,40 @@
1
+ import type { UIMessage } from 'ai';
2
+ import type { ElementDescriptor } from '@deepagents/elements';
3
+ import type { ClientToolSet } from '../tool.ts';
4
+ export type TurnRequest = {
5
+ /** Client-declared tools available to the model and completed by that client. */
6
+ tools?: ClientToolSet;
7
+ /**
8
+ * Interactive-element catalog declared by the client. When present it
9
+ * overwrites the chat's durable catalog snapshot (an empty array clears
10
+ * it); when absent the turn inherits the stored snapshot, so recovery and
11
+ * later turns keep rendering with the same catalog.
12
+ */
13
+ elements?: ElementDescriptor[];
14
+ } & ({
15
+ message: UIMessage & {
16
+ role: 'user';
17
+ };
18
+ trigger: 'submit-message' | 'regenerate-message';
19
+ } | {
20
+ message: UIMessage & {
21
+ role: 'assistant';
22
+ };
23
+ trigger: 'submit-message';
24
+ });
1
25
  export type TurnRef = {
2
26
  streamId: string;
3
27
  chatId: string;
4
28
  userId: string;
5
- } & ({
6
- kind: 'ask';
29
+ } & (({
30
+ kind: 'message';
31
+ } & TurnRequest) | {
7
32
  /**
8
- * The user message, carried by the queue until the turn executes. It
9
- * enters the context chain only when the turn RUNS — enqueue-time
10
- * persistence would let a queued turn's message leak into the running
11
- * turn's prompt (and `chat()` streams into the chain head, which must
12
- * be THIS turn's placeholder).
33
+ * Internal re-execution of an existing assistant stream after a worker
34
+ * handoff or a proven-idempotent tool failure.
13
35
  */
14
- input: string;
15
- } | {
16
- /**
17
- * Recovery-only re-execution of an existing stream. Normal approval
18
- * responses resume directly inside their approval job.
19
- */
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
- };
36
+ kind: 'recovery';
37
+ mode: 'handoff' | 'idempotent';
32
38
  } | {
33
39
  /**
34
40
  * A mailbox wake-up. The communication payload remains in MailboxStore;
@@ -36,13 +42,6 @@ export type TurnRef = {
36
42
  */
37
43
  kind: 'mailbox';
38
44
  });
39
- export interface TurnPushResult {
40
- jobId: string;
41
- inserted: boolean;
42
- }
43
- export type ApprovalTurnRef = Extract<TurnRef, {
44
- kind: 'approval';
45
- }>;
46
45
  export interface ConsumeContext {
47
46
  signal: AbortSignal;
48
47
  /**
@@ -55,12 +54,19 @@ export interface ConsumeContext {
55
54
  export interface ConsumeOptions {
56
55
  /** Max turns processed concurrently by this consumer (across chats). */
57
56
  concurrency?: number;
57
+ /** Wait for active handlers and settlement on disposal; otherwise only stop new claims. */
58
+ waitForActive?: boolean;
58
59
  /**
59
60
  * Fires for a turn whose handler crashed or whose worker died mid-turn.
60
61
  * After it resolves, the turn's chat is unblocked and its next queued
61
62
  * turn becomes eligible.
62
63
  */
63
64
  onOrphaned: (turn: TurnRef, error: string) => Promise<void>;
65
+ /**
66
+ * Runs after a non-parked turn releases its conversation's FIFO ownership.
67
+ * Implementations report failures without rolling back the settled turn.
68
+ */
69
+ onSettled?: (turn: TurnRef) => Promise<void>;
64
70
  }
65
71
  export type TurnActivity = 'idle' | 'queued' | 'running';
66
72
  /**
@@ -68,17 +74,16 @@ export type TurnActivity = 'idle' | 'queued' | 'running';
68
74
  *
69
75
  * Contract every implementation must honor:
70
76
  * - `push` is durable: a pushed turn survives process death until consumed.
71
- * - Delivery is AT-LEAST-ONCE: a pushed non-approval turn is delivered until settled, and
77
+ * - Delivery is AT-LEAST-ONCE: a pushed turn is delivered until settled, and
72
78
  * duplicate pushes of the same `streamId` may each be delivered. Consumers
73
79
  * MUST be idempotent on `streamId` (the zukhruf runtime skips turns whose
74
80
  * stream row is terminal — a check that, unlike queue-side dedup, never
75
81
  * 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.
79
82
  * - Per chat, at most ONE handler invocation is active at a time, and turns
80
83
  * run in the order they were pushed (strict FIFO per `chatId`) — this
81
84
  * covers duplicates too: they can never run concurrently or out of order.
85
+ * - After a non-parked job releases its FIFO ownership, `consume` invokes the
86
+ * optional `onSettled` hook before considering that delivery complete.
82
87
  * - Turns from different chats may run concurrently.
83
88
  * - `getTurnActivity` distinguishes queued from active scheduler work for
84
89
  * status inspection; adapters must not silently fall back to stale history.
@@ -94,13 +99,13 @@ export type TurnActivity = 'idle' | 'queued' | 'running';
94
99
  * authority.
95
100
  * - A parked turn (`context.park()`) is not delivered again until
96
101
  * `resumeParked(chatId)`; revived turns keep their original FIFO order,
97
- * and approval/recovery turns pushed for the chat outrank them.
102
+ * and recovery turns pushed for the chat outrank them.
98
103
  *
99
104
  * On platforms with native per-conversation serialization (e.g. Durable
100
105
  * Objects) this port is absorbed by the host rather than implemented.
101
106
  */
102
107
  export declare abstract class TurnQueue {
103
- abstract push(turn: TurnRef): Promise<TurnPushResult>;
108
+ abstract push(turn: TurnRef): Promise<void>;
104
109
  /** Whether this conversation currently has queued or active scheduler work. */
105
110
  abstract getTurnActivity(conversation: Pick<TurnRef, 'chatId' | 'userId'>): Promise<TurnActivity>;
106
111
  /** Active turn, or the oldest eligible queued turn, for a conversation. */
@@ -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;;;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"}
1
+ {"version":3,"file":"turn-queue.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/queue/turn-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG;IACxB,iFAAiF;IACjF,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC,GAAG,CACA;IACE,OAAO,EAAE,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,OAAO,EAAE,gBAAgB,GAAG,oBAAoB,CAAC;CAClD,GACD;IACE,OAAO,EAAE,SAAS,GAAG;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAC3C,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CACJ,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,CACA,CAAC;IACC,IAAI,EAAE,SAAS,CAAC;CAQjB,GAAG,WAAW,CAAC,GAChB;IACE;;;OAGG;IACH,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC;CAChC,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,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;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,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"}
@@ -1,64 +1,184 @@
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';
1
+ import type { Telemetry } from 'ai';
2
+ import { ContextEngine, type ContextStore, type StreamManager, type StreamPart, type StreamStatus } from '@deepagents/context';
3
+ import type { AgentDeclaration, ZukhrufSandbox } from '../agent.ts';
4
+ import { AgentDirectory } from '../control-plane/agent-directory.ts';
4
5
  import type { MailboxStore } from '../mailbox/store.ts';
5
6
  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
- export interface AgentRuntimeOptions {
9
- store: ContextStore;
10
- /** Borrowed stream subsystem; the caller owns its store, change source, and lifecycle. */
11
- streams: StreamManager;
12
- queue: TurnQueue;
13
- /** Durable pending inter-agent input. Distinct from the TurnQueue scheduler. */
14
- mailboxStore: MailboxStore;
15
- /** Codex MultiAgentV2-compatible host guidance and tool configuration. */
16
- multiAgentV2?: MultiAgentV2HostConfig;
7
+ import { type MultiAgentHostConfig } from '../multi-agent-config.ts';
8
+ import type { TurnQueue, TurnRequest } from '../queue/turn-queue.ts';
9
+ import type { ZukhrufToolSet } from '../tool.ts';
10
+ import type { ConversationStatusChangeSource } from './conversation-status/change-source.ts';
11
+ import type { ChildProgress } from './conversation-status/child-progress.ts';
12
+ import { type ConversationStatus, type ConversationStatusEvent } from './conversation-status/projector.ts';
13
+ export interface AgentPluginToolContext extends Readonly<Record<string, unknown>> {
14
+ readonly conversation: ConversationId;
15
+ /** Root conversation id of this agent tree, which is the session id per-conversation plugin state is scoped by. */
16
+ readonly treeId: string;
17
+ readonly streamId: string;
18
+ readonly agentName: string;
19
+ readonly agentPath: string;
20
+ }
21
+ export interface AgentPluginHost {
22
+ readonly info: AgentRuntimeInfo;
23
+ enqueue(conversation: ConversationId, turn: TurnRequest): Promise<{
24
+ id: string;
25
+ stream: ReadableStream<StreamPart>;
26
+ }>;
27
+ /**
28
+ * Attach the root agent's sandbox for `conversation`. The handle is
29
+ * borrowed: a plugin must never dispose it. The backend is named by
30
+ * `chatId` and re-attached across turns, workers, and restarts (see
31
+ * `SandboxContext` in `agent.ts`), so this works before the conversation
32
+ * exists.
33
+ */
34
+ sandbox(conversation: ConversationId): Promise<ZukhrufSandbox>;
35
+ conversationExists(conversation: ConversationId): Promise<boolean>;
36
+ isConversationAvailable(conversation: ConversationId): Promise<boolean>;
37
+ readConversationMetadata(conversation: ConversationId): Promise<Record<string, unknown> | undefined>;
38
+ updateConversationMetadata(conversation: ConversationId, update: (metadata: Record<string, unknown> | undefined) => Record<string, unknown>): Promise<void>;
39
+ listHistory(): Promise<readonly AgentHistoryItem[]>;
40
+ observe(conversation: ConversationId): AgentObservation;
41
+ /** Status changes observed by this process; ends when `signal` aborts. */
42
+ subscribeConversationStatus(signal: AbortSignal): Promise<AsyncIterable<ConversationStatusEvent>>;
43
+ }
44
+ export interface AgentPluginBinding {
45
+ readonly capability: AgentPluginCapability<unknown>;
46
+ readonly value: unknown;
47
+ }
48
+ export declare class AgentPluginCapability<Value> {
49
+ readonly name: string;
50
+ constructor(name: string);
51
+ bind(value: Value): AgentPluginBinding;
52
+ }
53
+ export interface AgentPluginBindings {
54
+ get<Value>(capability: AgentPluginCapability<Value>): Value;
55
+ }
56
+ /** Resources and tools acquired by asynchronous plugin initialization. */
57
+ export interface AgentPluginInitialization extends AsyncDisposable {
58
+ readonly tools?: ZukhrufToolSet;
59
+ }
60
+ export interface AgentPluginInstance {
61
+ readonly tools?: ZukhrufToolSet;
62
+ /** Per-turn AI SDK telemetry integration contributed by this plugin. */
63
+ telemetry?(context: AgentPluginToolContext): Telemetry;
64
+ /** Directories whose immediate Markdown files declare plugin-scoped agents. */
65
+ readonly agents?: readonly (string | URL)[];
66
+ /** Skill directories available for agents to select by frontmatter name. */
67
+ readonly skills?: readonly (string | URL)[];
68
+ /** Static namespaced context merged into every model call made by this runtime. */
69
+ readonly runtimeContext?: Readonly<Record<string, unknown>>;
70
+ configure?(root: AgentDeclaration): AgentDeclaration;
71
+ initialize?(host: AgentPluginHost): Promise<void | AgentPluginInitialization>;
72
+ /** Hosts wait for active plugin work before releasing infrastructure. */
73
+ work?(host: AgentPluginHost, waitForActive?: boolean): Promise<AsyncDisposable>;
74
+ conversationAvailable?(host: AgentPluginHost, conversation: ConversationId): Promise<void>;
75
+ }
76
+ export interface AgentPluginDefinition<Instance extends object = object> {
77
+ readonly name: string;
78
+ readonly capabilities?: readonly AgentPluginCapability<unknown>[];
79
+ create(bindings: AgentPluginBindings): AgentPluginInstance & Instance;
17
80
  }
18
81
  export interface AgentRuntimeWorkOptions {
19
82
  concurrency?: number;
20
83
  }
84
+ export interface AgentRuntimeInfo {
85
+ readonly root: string;
86
+ readonly agents: readonly {
87
+ readonly name: string;
88
+ readonly description?: string;
89
+ readonly plugin?: string;
90
+ readonly model: {
91
+ readonly provider: string;
92
+ readonly modelId: string;
93
+ };
94
+ readonly tools: readonly string[];
95
+ readonly subagents: readonly string[];
96
+ }[];
97
+ }
98
+ export interface AgentHistoryItem {
99
+ readonly chatId: string;
100
+ readonly userId: string;
101
+ readonly title?: string;
102
+ readonly createdAt: number;
103
+ readonly updatedAt: number;
104
+ readonly messageCount: number;
105
+ readonly status: ConversationStatus;
106
+ readonly children?: readonly ChildProgress[];
107
+ }
108
+ export interface AgentTurnStatus {
109
+ status: StreamStatus;
110
+ startedAt: number | null;
111
+ finishedAt: number | null;
112
+ error: string | null;
113
+ }
114
+ interface AgentObservationStatus {
115
+ read: () => Promise<ConversationStatus>;
116
+ publish: () => Promise<void>;
117
+ }
21
118
  /** Reconnect and cancellation view over one durable conversation. */
22
119
  export declare class AgentObservation {
23
120
  #private;
24
121
  readonly engine: ContextEngine;
25
- constructor(conversation: ConversationId, store: ContextStore, streams: StreamManager, queue: TurnQueue);
26
- resume(): Promise<ReadableStream<import("@deepagents/context").StreamPart> | null>;
122
+ constructor(conversation: ConversationId, store: ContextStore, directory: AgentDirectory, streams: StreamManager, queue: TurnQueue, status: AgentObservationStatus, conversationAvailable?: () => Promise<void>);
123
+ /** Codex-shaped conversation status derived from durable state. */
124
+ conversationStatus(): Promise<ConversationStatus>;
125
+ resume(): Promise<ReadableStream<StreamPart> | null>;
126
+ status(streamId?: string): Promise<AgentTurnStatus | undefined>;
27
127
  cancel(streamId?: string): Promise<void>;
28
128
  }
29
- /** Thin host-facing composition and lifecycle façade for a Zukhruf agent tree. */
129
+ /** A reusable recipe. Register only resources the returned host should own. */
130
+ export type AgentStack = (resources: AsyncDisposableStack) => Promise<{
131
+ store: ContextStore;
132
+ /** Stream subsystem backed by the adapters composed in this recipe. */
133
+ streams: StreamManager;
134
+ queue: TurnQueue;
135
+ /** Durable pending inter-agent input. Distinct from the TurnQueue scheduler. */
136
+ mailboxStore: MailboxStore;
137
+ /** Codex-compatible multi-agent host guidance and tool configuration. */
138
+ multiAgent?: MultiAgentHostConfig;
139
+ /** Host implementations for capabilities required by root-owned plugins. */
140
+ bindings?: readonly AgentPluginBinding[];
141
+ /**
142
+ * Cross-process conversation status hints. Without it, status changes are
143
+ * observed only by the process where the transition happened.
144
+ */
145
+ conversationStatusChanges?: ConversationStatusChangeSource;
146
+ }>;
147
+ /** Defines infrastructure without acquiring it; each initialization opens its own scope. */
148
+ export declare function defineStack(create: AgentStack): AgentStack;
149
+ /** Ready operations and ownership, available only after initialize() succeeds. */
150
+ export type AgentHost = Omit<RuntimeHost, 'initialize'>;
151
+ /** Creates independent ready hosts from an agent declaration. */
30
152
  export declare class AgentRuntime {
31
153
  #private;
32
- constructor(root: AgentDeclaration, options: AgentRuntimeOptions);
33
- enqueue(conversation: ConversationId, turn: TurnInput): Promise<{
154
+ constructor(root: AgentDeclaration);
155
+ initialize(stack: AgentStack): Promise<AgentHost>;
156
+ }
157
+ /** Compiles an initialized adapter set and supplies the plugin host. */
158
+ declare class RuntimeHost implements AsyncDisposable {
159
+ #private;
160
+ readonly info: AgentRuntimeInfo;
161
+ constructor(root: AgentDeclaration, options: Awaited<ReturnType<AgentStack>>, resources: AsyncDisposableStack);
162
+ initialize(): Promise<void>;
163
+ [Symbol.asyncDispose](): Promise<void>;
164
+ plugin<Instance extends object>(definition: AgentPluginDefinition<Instance>): AgentPluginInstance & Instance;
165
+ createSession(conversation: ConversationId): Promise<void>;
166
+ sessionExists(conversation: ConversationId): Promise<boolean>;
167
+ enqueue(conversation: ConversationId, turn: TurnRequest): Promise<{
34
168
  id: string;
35
- stream: ReadableStream<import("@deepagents/context").StreamPart>;
169
+ stream: ReadableStream<StreamPart>;
36
170
  }>;
37
171
  deliver(communication: InterAgentCommunication, mode: MessageDeliveryMode): Promise<void>;
38
- approve(conversation: ConversationId, input: {
39
- toolCallId: string;
40
- }): Promise<{
41
- id: string;
42
- jobId: string;
43
- status: "already-applied";
44
- } | {
45
- id: string;
46
- jobId: string;
47
- status: "queued" | "already-queued";
48
- }>;
49
- deny(conversation: ConversationId, input: {
50
- toolCallId: string;
51
- reason?: string;
52
- }): Promise<{
53
- id: string;
54
- jobId: string;
55
- status: "already-applied";
56
- } | {
57
- id: string;
58
- jobId: string;
59
- status: "queued" | "already-queued";
60
- }>;
61
172
  observe(conversation: ConversationId): AgentObservation;
173
+ /**
174
+ * Conversation status changes observed by this process, in the shape of
175
+ * Codex's `thread/status/changed`. Execution transitions are observed by the
176
+ * process running `work()`; `observe(...).conversationStatus()` is always
177
+ * authoritative.
178
+ */
179
+ subscribeConversationStatus(signal: AbortSignal): Promise<AsyncIterable<ConversationStatusEvent>>;
180
+ listHistory(userId?: string): Promise<readonly AgentHistoryItem[]>;
62
181
  work(options?: AgentRuntimeWorkOptions): Promise<AsyncDisposable>;
63
182
  }
183
+ export {};
64
184
  //# sourceMappingURL=agent-runtime.d.ts.map
@@ -1 +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;gBAO7B,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,SAAS;IAaZ,MAAM;IAQN,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAqB/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;IASvD,IAAI,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC;CAsFlE"}
1
+ {"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/runtime/agent-runtime.ts"],"names":[],"mappings":"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"}
@@ -1,16 +1,22 @@
1
1
  import { type ContextStore, type StreamManager } from '@deepagents/context';
2
2
  import type { AgentControlPlane } from '../control-plane/agent-control-plane.ts';
3
3
  import type { MailboxCoordinator } from '../mailbox/coordinator.ts';
4
- import type { ResolvedMultiAgentV2HostConfig } from '../multi-agent-v2-config.ts';
4
+ import type { ConversationId } from '../mailbox/types.ts';
5
+ import type { ResolvedMultiAgentHostConfig } from '../multi-agent-config.ts';
5
6
  import type { ConsumeContext, TurnRef } from '../queue/turn-queue.ts';
6
7
  import type { ApprovalController } from './approval-controller.ts';
8
+ import type { PluginManager } from './plugin/plugin-manager.ts';
9
+ type TurnPlugins = Pick<PluginManager, 'collaborationTools' | 'tools' | 'skillsByAgent' | 'runtimeContext' | 'configureTelemetry'>;
7
10
  export interface AgentTurnExecutorOptions {
8
11
  store: ContextStore;
9
12
  streams: StreamManager;
10
13
  controlPlane: AgentControlPlane;
11
14
  mailbox: MailboxCoordinator;
12
15
  approvals: ApprovalController;
13
- multiAgentV2: ResolvedMultiAgentV2HostConfig;
16
+ multiAgent: ResolvedMultiAgentHostConfig;
17
+ plugins: TurnPlugins;
18
+ /** Signals that the conversation's status may have changed. Never rejects. */
19
+ publishConversationStatus: (conversation: ConversationId) => Promise<void>;
14
20
  }
15
21
  /** Executes one queued turn without owning host lifecycle or agent routing. */
16
22
  export declare class AgentTurnExecutor {
@@ -18,4 +24,5 @@ export declare class AgentTurnExecutor {
18
24
  constructor(options: AgentTurnExecutorOptions);
19
25
  execute(turn: TurnRef, context: ConsumeContext): Promise<void>;
20
26
  }
27
+ export {};
21
28
  //# sourceMappingURL=agent-turn-executor.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"agent-turn-executor.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/runtime/agent-turn-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAMnB,MAAM,qBAAqB,CAAC;AAK7B,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;AAMtE,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;CA8RrE"}
1
+ {"version":3,"file":"agent-turn-executor.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/runtime/agent-turn-executor.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAMnB,MAAM,qBAAqB,CAAC;AAS7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,KAAK,WAAW,GAAG,IAAI,CACrB,aAAa,EACX,oBAAoB,GACpB,OAAO,GACP,eAAe,GACf,gBAAgB,GAChB,oBAAoB,CACvB,CAAC;AAEF,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,UAAU,EAAE,4BAA4B,CAAC;IACzC,OAAO,EAAE,WAAW,CAAC;IACrB,8EAA8E;IAC9E,yBAAyB,EAAE,CAAC,YAAY,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAMD,+EAA+E;AAC/E,qBAAa,iBAAiB;;gBAUhB,OAAO,EAAE,wBAAwB;IAWvC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAocrE"}
@@ -1,45 +1,30 @@
1
1
  import { type UIMessage } from 'ai';
2
2
  import { type ContextStore } from '@deepagents/context';
3
3
  import type { ConversationId } from '../mailbox/types.ts';
4
- import type { ApprovalTurnRef, TurnQueue, TurnRef } from '../queue/turn-queue.ts';
4
+ import type { TurnQueue, TurnRef } from '../queue/turn-queue.ts';
5
5
  import type { ZukhrufToolSet } from '../tool.ts';
6
6
  export interface ApprovalControllerOptions {
7
7
  store: ContextStore;
8
8
  queue: TurnQueue;
9
9
  }
10
+ /** The head assistant message holds a tool call the host has not approved or denied. */
11
+ export declare function hasUnansweredApprovals(message: UIMessage): boolean;
12
+ /**
13
+ * The head assistant message holds a tool call whose output must come from
14
+ * outside the runtime. Every server-side tool executes before its turn
15
+ * completes, so `input-available` at a completed head is a client tool.
16
+ */
17
+ export declare function hasPendingClientInput(message: UIMessage): boolean;
10
18
  /** Durable approval-response and continuation state machine. */
11
19
  export declare class ApprovalController {
12
20
  #private;
13
21
  constructor(options: ApprovalControllerOptions);
14
22
  isPaused(message: UIMessage | undefined): boolean;
15
- approve(conversation: ConversationId, input: {
16
- toolCallId: string;
17
- }): Promise<{
18
- id: string;
19
- jobId: string;
20
- status: "already-applied";
21
- } | {
22
- id: string;
23
- jobId: string;
24
- status: "queued" | "already-queued";
25
- }>;
26
- deny(conversation: ConversationId, input: {
27
- toolCallId: string;
28
- reason?: string;
29
- }): Promise<{
30
- id: string;
31
- jobId: string;
32
- status: "already-applied";
33
- } | {
34
- id: string;
35
- jobId: string;
36
- status: "queued" | "already-queued";
37
- }>;
23
+ isConversationPaused(conversation: ConversationId): Promise<boolean>;
38
24
  settleDeniedApprovals(conversation: ConversationId, streamId: string): Promise<void>;
39
25
  settleFailedApprovals(conversation: ConversationId, streamId: string, error: string): Promise<void>;
40
26
  reconcileTerminalContinuation(conversation: ConversationId, streamId: string, status: 'completed' | 'failed' | 'cancelled', error?: string | null): Promise<void>;
41
27
  retryIdempotentContinuation(conversation: ConversationId, streamId: string, tools: ZukhrufToolSet): Promise<boolean>;
42
- applyDecision(turn: ApprovalTurnRef): Promise<boolean>;
43
28
  recoverUnstartedContinuation(turn: TurnRef, streamId: string): Promise<boolean>;
44
29
  }
45
30
  //# sourceMappingURL=approval-controller.d.ts.map
@@ -1 +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"}
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,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;CAClB;AAID,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAIjE;AAED,gEAAgE;AAChE,qBAAa,kBAAkB;;gBAUjB,OAAO,EAAE,yBAAyB;IAK9C,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO;IAO3C,oBAAoB,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAMpE,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,4BAA4B,CAChC,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;CAkCpB"}
@@ -0,0 +1,47 @@
1
+ import { type GenerateTextOnStartCallback, type GenerateTextOnStepEndCallback, type GenerateTextOnStepStartCallback, type ModelMessage, type PrepareStepFunction, type ToolSet } from 'ai';
2
+ import { type CompactResult, type CompactionFailureReason } from '@deepagents/compaction';
3
+ import type { ContextEngine, ContextStore } from '@deepagents/context';
4
+ import type { AgentCompaction } from '../agent.ts';
5
+ /** Payload of AI SDK `data-compaction` parts; IDs group one evaluation. */
6
+ export type CompactionEvent = {
7
+ id: string;
8
+ } & ({
9
+ status: 'restored';
10
+ sourceMessages: number;
11
+ replacementMessages: number;
12
+ } | {
13
+ status: 'started';
14
+ /** Absent on historical events that counted only messages. */
15
+ tokenScope?: 'request';
16
+ triggerIndex: number;
17
+ tokensBefore: number;
18
+ targetTokens: number;
19
+ messageCount: number;
20
+ } | {
21
+ status: 'completed';
22
+ /** Absent on historical events that counted only messages. */
23
+ tokenScope?: 'request';
24
+ tokens: CompactResult['tokens'];
25
+ replacedRange: {
26
+ start: number;
27
+ end: number;
28
+ };
29
+ usage: CompactResult['usage'];
30
+ } | {
31
+ status: 'failed';
32
+ phase: 'restore' | 'evaluate' | 'compact' | 'persist';
33
+ reason: CompactionFailureReason | 'request-overhead' | 'error';
34
+ });
35
+ /** Projects model history while leaving the durable UI transcript untouched. */
36
+ export declare function createCompaction(config: AgentCompaction, engine: ContextEngine, store: ContextStore, signal: AbortSignal, onEvent: (event: CompactionEvent) => void): {
37
+ prepareStep: (input: Pick<Parameters<PrepareStepFunction<ToolSet>>[0], "messages" | "model" | "instructions" | "toolsContext" | "experimental_sandbox">) => Promise<{
38
+ messages: ModelMessage[];
39
+ }>;
40
+ onStart: GenerateTextOnStartCallback<ToolSet>;
41
+ onStepStart: GenerateTextOnStepStartCallback<ToolSet>;
42
+ onStepEnd: GenerateTextOnStepEndCallback<ToolSet>;
43
+ include: {
44
+ requestBody: boolean;
45
+ };
46
+ };
47
+ //# sourceMappingURL=compaction.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/runtime/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACpC,KAAK,YAAY,EACjB,KAAK,mBAAmB,EAExB,KAAK,OAAO,EAGb,MAAM,IAAI,CAAC;AAIZ,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAG7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,CAC3C;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAC/B,GACD;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACtD,MAAM,EAAE,uBAAuB,GAAG,kBAAkB,GAAG,OAAO,CAAC;CAChE,CACJ,CAAC;AAgIF,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI;yBA8FhC,IAAI,CACT,UAAU,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EACzC,UAAU,GACV,OAAO,GACP,cAAc,GACd,cAAc,GACd,sBAAsB,CACzB;;;;;;;;;EA0PJ"}
@@ -0,0 +1,19 @@
1
+ import type { ConversationId } from '../../mailbox/types.ts';
2
+ /**
3
+ * Cross-process wake hints for conversation status.
4
+ *
5
+ * A hint names a conversation whose status may have changed; it carries no
6
+ * status, because `observe(conversation).conversationStatus()` is the
7
+ * authority in every process and a stale or reordered payload would not be.
8
+ */
9
+ export interface ConversationStatusChangeSource {
10
+ notify(conversation: ConversationId): Promise<void>;
11
+ subscribe(signal: AbortSignal): Promise<AsyncIterable<ConversationStatusChangeHint>>;
12
+ }
13
+ export type ConversationStatusChangeHint = {
14
+ type: 'change';
15
+ conversation: ConversationId;
16
+ } | {
17
+ type: 'reset';
18
+ };
19
+ //# sourceMappingURL=change-source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"change-source.d.ts","sourceRoot":"","sources":["../../../../src/zukhruf/runtime/conversation-status/change-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,SAAS,CACP,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC,4BAA4B,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,MAAM,4BAA4B,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC"}