@deepagents/experimental 7.8.2 → 7.10.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 (156) hide show
  1. package/README.md +27 -10
  2. package/dist/coding-agent-reminders/context.d.ts.map +1 -1
  3. package/dist/coding-agent-reminders/evaluate.d.ts.map +1 -1
  4. package/dist/coding-agent-reminders/index.d.ts.map +1 -1
  5. package/dist/coding-agent-reminders/io.d.ts.map +1 -1
  6. package/dist/coding-agent-reminders/predicates/classifier.d.ts.map +1 -1
  7. package/dist/coding-agent-reminders/predicates/combinators.d.ts.map +1 -1
  8. package/dist/coding-agent-reminders/predicates/content.d.ts +1 -1
  9. package/dist/coding-agent-reminders/predicates/content.d.ts.map +1 -1
  10. package/dist/coding-agent-reminders/predicates/count.d.ts.map +1 -1
  11. package/dist/coding-agent-reminders/predicates/environment.d.ts.map +1 -1
  12. package/dist/coding-agent-reminders/predicates/event.d.ts.map +1 -1
  13. package/dist/coding-agent-reminders/predicates/index.d.ts.map +1 -1
  14. package/dist/coding-agent-reminders/predicates/tool.d.ts.map +1 -1
  15. package/dist/coding-agent-reminders/types.d.ts.map +1 -1
  16. package/dist/index.d.ts.map +1 -1
  17. package/dist/index.js +3305 -2625
  18. package/dist/index.js.map +4 -4
  19. package/dist/providers/account-tokens.d.ts.map +1 -1
  20. package/dist/providers/claude/accounts.d.ts.map +1 -1
  21. package/dist/providers/claude/errors.d.ts.map +1 -1
  22. package/dist/providers/claude/index.d.ts.map +1 -1
  23. package/dist/providers/claude/local-credentials.d.ts.map +1 -1
  24. package/dist/providers/claude/oauth.d.ts.map +1 -1
  25. package/dist/providers/claude/provider.d.ts.map +1 -1
  26. package/dist/providers/codex/accounts.d.ts.map +1 -1
  27. package/dist/providers/codex/errors.d.ts.map +1 -1
  28. package/dist/providers/codex/generate-via-stream.d.ts.map +1 -1
  29. package/dist/providers/codex/index.d.ts.map +1 -1
  30. package/dist/providers/codex/local-credentials.d.ts.map +1 -1
  31. package/dist/providers/codex/provider.d.ts.map +1 -1
  32. package/dist/providers/language-model-provider.d.ts.map +1 -1
  33. package/dist/providers/request-signal.d.ts.map +1 -1
  34. package/dist/zukhruf/agent.d.ts.map +1 -1
  35. package/dist/zukhruf/collaboration/agent-tool-context.d.ts.map +1 -1
  36. package/dist/zukhruf/collaboration/collaboration-tools.d.ts +24 -24
  37. package/dist/zukhruf/collaboration/collaboration-tools.d.ts.map +1 -1
  38. package/dist/zukhruf/collaboration/interrupt-agent.d.ts +4 -4
  39. package/dist/zukhruf/collaboration/interrupt-agent.d.ts.map +1 -1
  40. package/dist/zukhruf/collaboration/list-agents.d.ts +4 -4
  41. package/dist/zukhruf/collaboration/list-agents.d.ts.map +1 -1
  42. package/dist/zukhruf/collaboration/message-tools.d.ts +8 -8
  43. package/dist/zukhruf/collaboration/message-tools.d.ts.map +1 -1
  44. package/dist/zukhruf/collaboration/spawn-agent.d.ts +4 -4
  45. package/dist/zukhruf/collaboration/spawn-agent.d.ts.map +1 -1
  46. package/dist/zukhruf/collaboration/wait-agent.d.ts +4 -4
  47. package/dist/zukhruf/collaboration/wait-agent.d.ts.map +1 -1
  48. package/dist/zukhruf/control-plane/agent-control-plane.d.ts +2 -4
  49. package/dist/zukhruf/control-plane/agent-control-plane.d.ts.map +1 -1
  50. package/dist/zukhruf/control-plane/agent-declaration-registry.d.ts.map +1 -1
  51. package/dist/zukhruf/control-plane/agent-directory.d.ts +2 -0
  52. package/dist/zukhruf/control-plane/agent-directory.d.ts.map +1 -1
  53. package/dist/zukhruf/control-plane/agent-history-forker.d.ts.map +1 -1
  54. package/dist/zukhruf/control-plane/agent-path.d.ts.map +1 -1
  55. package/dist/zukhruf/control-plane/agent-residency.d.ts +60 -0
  56. package/dist/zukhruf/control-plane/agent-residency.d.ts.map +1 -0
  57. package/dist/zukhruf/control-plane/agent-status-projector.d.ts +4 -4
  58. package/dist/zukhruf/control-plane/agent-status-projector.d.ts.map +1 -1
  59. package/dist/zukhruf/control-plane/agent-thread-limit-error.d.ts.map +1 -1
  60. package/dist/zukhruf/control-plane/agent-thread.d.ts.map +1 -1
  61. package/dist/zukhruf/control-plane/agent-turn-id.d.ts.map +1 -1
  62. package/dist/zukhruf/control-plane/conversation-not-found-error.d.ts.map +1 -1
  63. package/dist/zukhruf/control-plane/fork-turns.d.ts.map +1 -1
  64. package/dist/zukhruf/control-plane/stale-turn-error.d.ts.map +1 -1
  65. package/dist/zukhruf/control-plane/turn-not-found-error.d.ts.map +1 -1
  66. package/dist/zukhruf/index.d.ts +4 -0
  67. package/dist/zukhruf/index.d.ts.map +1 -1
  68. package/dist/zukhruf/index.js +3305 -2625
  69. package/dist/zukhruf/index.js.map +4 -4
  70. package/dist/zukhruf/instructions.d.ts.map +1 -1
  71. package/dist/zukhruf/is-named-error.d.ts.map +1 -1
  72. package/dist/zukhruf/mailbox/communication-schema.d.ts +3 -3
  73. package/dist/zukhruf/mailbox/communication-schema.d.ts.map +1 -1
  74. package/dist/zukhruf/mailbox/coordinator.d.ts +8 -4
  75. package/dist/zukhruf/mailbox/coordinator.d.ts.map +1 -1
  76. package/dist/zukhruf/mailbox/ddl.postgres.d.ts.map +1 -1
  77. package/dist/zukhruf/mailbox/ddl.sqlite.d.ts +0 -1
  78. package/dist/zukhruf/mailbox/ddl.sqlite.d.ts.map +1 -1
  79. package/dist/zukhruf/mailbox/postgres.store.d.ts +9 -1
  80. package/dist/zukhruf/mailbox/postgres.store.d.ts.map +1 -1
  81. package/dist/zukhruf/mailbox/sqlite.store.d.ts +3 -1
  82. package/dist/zukhruf/mailbox/sqlite.store.d.ts.map +1 -1
  83. package/dist/zukhruf/mailbox/store.d.ts +4 -0
  84. package/dist/zukhruf/mailbox/store.d.ts.map +1 -1
  85. package/dist/zukhruf/mailbox/types.d.ts +5 -5
  86. package/dist/zukhruf/mailbox/types.d.ts.map +1 -1
  87. package/dist/zukhruf/multi-agent-config.d.ts.map +1 -1
  88. package/dist/zukhruf/plugins/conversation-scheduling/conversation-scheduler.d.ts +1 -1
  89. package/dist/zukhruf/plugins/conversation-scheduling/conversation-scheduler.d.ts.map +1 -1
  90. package/dist/zukhruf/plugins/conversation-scheduling/index.d.ts.map +1 -1
  91. package/dist/zukhruf/plugins/conversation-scheduling/index.js +85 -72
  92. package/dist/zukhruf/plugins/conversation-scheduling/index.js.map +4 -4
  93. package/dist/zukhruf/plugins/conversation-scheduling/pg-boss.wake-scheduler.d.ts.map +1 -1
  94. package/dist/zukhruf/plugins/conversation-scheduling/tools.d.ts +16 -16
  95. package/dist/zukhruf/plugins/conversation-scheduling/tools.d.ts.map +1 -1
  96. package/dist/zukhruf/plugins/conversation-scheduling/wake-scheduler.d.ts.map +1 -1
  97. package/dist/zukhruf/plugins/http/index.d.ts.map +1 -1
  98. package/dist/zukhruf/plugins/http/index.js +2 -12
  99. package/dist/zukhruf/plugins/http/index.js.map +2 -2
  100. package/dist/zukhruf/plugins/mcp/index.d.ts.map +1 -1
  101. package/dist/zukhruf/plugins/schedules/http.d.ts.map +1 -1
  102. package/dist/zukhruf/plugins/schedules/http.js +0 -1
  103. package/dist/zukhruf/plugins/schedules/http.js.map +2 -2
  104. package/dist/zukhruf/plugins/schedules/index.d.ts.map +1 -1
  105. package/dist/zukhruf/plugins/schedules/index.js +83 -70
  106. package/dist/zukhruf/plugins/schedules/index.js.map +4 -4
  107. package/dist/zukhruf/plugins/schedules/schedule-files.d.ts.map +1 -1
  108. package/dist/zukhruf/plugins/schedules/scheduled-tasks.d.ts.map +1 -1
  109. package/dist/zukhruf/plugins/uploads/http.d.ts.map +1 -1
  110. package/dist/zukhruf/plugins/uploads/http.js +16 -5
  111. package/dist/zukhruf/plugins/uploads/http.js.map +2 -2
  112. package/dist/zukhruf/plugins/uploads/index.d.ts +11 -11
  113. package/dist/zukhruf/plugins/uploads/index.d.ts.map +1 -1
  114. package/dist/zukhruf/plugins/uploads/index.js +1 -7
  115. package/dist/zukhruf/plugins/uploads/index.js.map +2 -2
  116. package/dist/zukhruf/queue/pg-boss-notifications.d.ts.map +1 -1
  117. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts +14 -1
  118. package/dist/zukhruf/queue/pg-boss.turn-queue.d.ts.map +1 -1
  119. package/dist/zukhruf/queue/turn-queue.d.ts +2 -0
  120. package/dist/zukhruf/queue/turn-queue.d.ts.map +1 -1
  121. package/dist/zukhruf/runtime/agent-runtime.d.ts +6 -7
  122. package/dist/zukhruf/runtime/agent-runtime.d.ts.map +1 -1
  123. package/dist/zukhruf/runtime/agent-turn-executor.d.ts.map +1 -1
  124. package/dist/zukhruf/runtime/approval-controller.d.ts +4 -0
  125. package/dist/zukhruf/runtime/approval-controller.d.ts.map +1 -1
  126. package/dist/zukhruf/runtime/compaction.d.ts +2 -2
  127. package/dist/zukhruf/runtime/compaction.d.ts.map +1 -1
  128. package/dist/zukhruf/runtime/conversation-sandboxes.d.ts.map +1 -1
  129. package/dist/zukhruf/runtime/conversation-status/change-source.d.ts.map +1 -1
  130. package/dist/zukhruf/runtime/conversation-status/child-progress.d.ts +18 -18
  131. package/dist/zukhruf/runtime/conversation-status/child-progress.d.ts.map +1 -1
  132. package/dist/zukhruf/runtime/conversation-status/pg-boss-change-source.d.ts.map +1 -1
  133. package/dist/zukhruf/runtime/conversation-status/projector.d.ts +5 -0
  134. package/dist/zukhruf/runtime/conversation-status/projector.d.ts.map +1 -1
  135. package/dist/zukhruf/runtime/plugin/agent-skills.d.ts.map +1 -1
  136. package/dist/zukhruf/runtime/plugin/plugin-agents.d.ts.map +1 -1
  137. package/dist/zukhruf/runtime/plugin/plugin-bindings.d.ts.map +1 -1
  138. package/dist/zukhruf/runtime/plugin/plugin-context-composition.d.ts.map +1 -1
  139. package/dist/zukhruf/runtime/plugin/plugin-manager.d.ts +1 -1
  140. package/dist/zukhruf/runtime/plugin/plugin-manager.d.ts.map +1 -1
  141. package/dist/zukhruf/runtime/plugin/plugin-tool-composition.d.ts.map +1 -1
  142. package/dist/zukhruf/sandbox/define.d.ts.map +1 -1
  143. package/dist/zukhruf/storage/agent-storage.d.ts +41 -0
  144. package/dist/zukhruf/storage/agent-storage.d.ts.map +1 -0
  145. package/dist/zukhruf/storage/embedded-agent-storage.d.ts +63 -0
  146. package/dist/zukhruf/storage/embedded-agent-storage.d.ts.map +1 -0
  147. package/dist/zukhruf/storage/postgres-agent-storage.d.ts +56 -0
  148. package/dist/zukhruf/storage/postgres-agent-storage.d.ts.map +1 -0
  149. package/dist/zukhruf/storage/sqlite-admission-gate.d.ts +29 -0
  150. package/dist/zukhruf/storage/sqlite-admission-gate.d.ts.map +1 -0
  151. package/dist/zukhruf/storage/turn-outbox.d.ts +65 -0
  152. package/dist/zukhruf/storage/turn-outbox.d.ts.map +1 -0
  153. package/dist/zukhruf/tool.d.ts.map +1 -1
  154. package/package.json +7 -8
  155. package/dist/zukhruf/runtime/conversation-status/status-publishing-turn-queue.d.ts +0 -20
  156. package/dist/zukhruf/runtime/conversation-status/status-publishing-turn-queue.d.ts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/zukhruf/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,kBAAkB,CAAC,GAAG,SAAS,EAAE,eAAe,EAAE,iEAEjE"}
1
+ {"version":3,"file":"instructions.d.ts","sources":["../../src/zukhruf/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,kBAAkB,CAAC,GAAG,SAAS,EAAE,eAAe,EAAE,iEAEjE"}
@@ -1 +1 @@
1
- {"version":3,"file":"is-named-error.d.ts","sourceRoot":"","sources":["../../src/zukhruf/is-named-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,SAAS,KAAK,EACnD,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GACvB,KAAK,IAAI,UAAU,CAErB"}
1
+ {"version":3,"file":"is-named-error.d.ts","sources":["../../src/zukhruf/is-named-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,SAAS,KAAK,EACnD,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GACvB,KAAK,IAAI,UAAU,CAErB"}
@@ -3,9 +3,9 @@ import { z } from 'zod';
3
3
  export declare const communicationSchema: z.ZodObject<{
4
4
  id: z.ZodString;
5
5
  type: z.ZodEnum<{
6
- readonly Message: "MESSAGE";
7
- readonly NewTask: "NEW_TASK";
8
- readonly FinalAnswer: "FINAL_ANSWER";
6
+ readonly Message: 'MESSAGE';
7
+ readonly NewTask: 'NEW_TASK';
8
+ readonly FinalAnswer: 'FINAL_ANSWER';
9
9
  }>;
10
10
  author: z.ZodObject<{
11
11
  chatId: z.ZodString;
@@ -1 +1 @@
1
- {"version":3,"file":"communication-schema.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/communication-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,oEAAoE;AACpE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;iBASe,CAAC"}
1
+ {"version":3,"file":"communication-schema.d.ts","sources":["../../../src/zukhruf/mailbox/communication-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,oEAAoE;AACpE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;iBASe,CAAC"}
@@ -1,16 +1,20 @@
1
- import type { StreamManager } from '@deepagents/context';
2
- import type { TurnQueue, TurnRef } from '../queue/turn-queue.ts';
1
+ import type { AgentResidency } from '../control-plane/agent-residency.ts';
2
+ import type { TurnRef } from '../queue/turn-queue.ts';
3
3
  import type { MailboxStore } from './store.ts';
4
4
  import { type ConversationId, type InterAgentCommunication, type MessageDeliveryMode } from './types.ts';
5
5
  export interface MailboxCoordinatorOptions {
6
6
  store: MailboxStore;
7
- queue: Pick<TurnQueue, 'push'>;
8
- streams: StreamManager;
7
+ residency: AgentResidency;
9
8
  }
10
9
  /** Owns durable mail delivery and the serialized turns that wake recipients. */
11
10
  export declare class MailboxCoordinator {
12
11
  #private;
13
12
  constructor(options: MailboxCoordinatorOptions);
13
+ /**
14
+ * Writes the mail and, in the same admission, the wake it needs. Trigger
15
+ * mail to a sub-agent with no resident slot rejects with
16
+ * `AgentThreadLimitError` and writes nothing.
17
+ */
14
18
  deliver(communication: InterAgentCommunication, mode: MessageDeliveryMode): Promise<void>;
15
19
  beginTurn(turn: TurnRef): Promise<void>;
16
20
  endTurn(turn: TurnRef, options?: {
@@ -1 +1 @@
1
- {"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/coordinator.ts"],"names":[],"mappings":"AAGA,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,EACnB,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EAGzB,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;;gBAKjB,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;CAwCpB"}
1
+ {"version":3,"file":"coordinator.d.ts","sources":["../../../src/zukhruf/mailbox/coordinator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,qCAAqC,CAAC;AAG7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EAGzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,cAAc,CAAC;CAC3B;AAID,gFAAgF;AAChF,qBAAa,kBAAkB;;IAI7B,YAAY,OAAO,EAAE,yBAAyB,EAG7C;IAED;;;;OAIG;IACG,OAAO,CACX,aAAa,EAAE,uBAAuB,EACtC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CA+Bf;IAED,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtC;IAEK,OAAO,CACX,IAAI,EAAE,OAAO,EACb,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAQf;IAED,qBAAqB,CACnB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAEpC;IAED,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAEnE;IAEK,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,CAWlB;CAiCF"}
@@ -1 +1 @@
1
- {"version":3,"file":"ddl.postgres.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/ddl.postgres.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BjD"}
1
+ {"version":3,"file":"ddl.postgres.d.ts","sources":["../../../src/zukhruf/mailbox/ddl.postgres.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BjD"}
@@ -1,3 +1,2 @@
1
- export declare const SETUP = "\nPRAGMA synchronous = NORMAL;\n";
2
1
  export declare const statements: string[];
3
2
  //# sourceMappingURL=ddl.sqlite.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ddl.sqlite.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/ddl.sqlite.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,KAAK,qCAEjB,CAAC;AAEF,eAAO,MAAM,UAAU,UA2BtB,CAAC"}
1
+ {"version":3,"file":"ddl.sqlite.d.ts","sources":["../../../src/zukhruf/mailbox/ddl.sqlite.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,UAAU,UA2BtB,CAAC"}
@@ -1,5 +1,6 @@
1
1
  import type { Pool } from 'pg';
2
- import { type MailboxEndTurnResult, type MailboxEnqueueResult, MailboxStore } from './store.ts';
2
+ import { type PostgresTransaction } from '@deepagents/context';
3
+ import { type MailboxEndTurnResult, type MailboxEnqueueResult, MailboxStore, type TransactionalMailboxStore } from './store.ts';
3
4
  import { type ConversationId, type InterAgentCommunication } from './types.ts';
4
5
  export interface PostgresMailboxStoreOptions {
5
6
  /** Borrowed: the host owns the pool and the store never ends it. */
@@ -13,10 +14,17 @@ export declare class PostgresMailboxStore extends MailboxStore {
13
14
  private constructor();
14
15
  /** Opens the store: creates its schema objects before it returns. */
15
16
  static create(options: PostgresMailboxStoreOptions): Promise<PostgresMailboxStore>;
17
+ /**
18
+ * A view of this store whose reads and writes run inside `tx`. Each of its
19
+ * writes takes the recipient's lock in a savepoint of `tx`, and the lock is
20
+ * held until `tx` ends.
21
+ */
22
+ bind(tx: PostgresTransaction): TransactionalMailboxStore;
16
23
  beginTurn(recipient: ConversationId, turnId: string): Promise<void>;
17
24
  enqueue(communication: InterAgentCommunication): Promise<MailboxEnqueueResult>;
18
25
  endTurn(recipient: ConversationId, turnId: string): Promise<MailboxEndTurnResult>;
19
26
  hasPending(recipient: ConversationId): Promise<boolean>;
27
+ hasPendingTriggerTurn(recipient: ConversationId): Promise<boolean>;
20
28
  drain(recipient: ConversationId): Promise<InterAgentCommunication[]>;
21
29
  drainLeadingQueueOnly(recipient: ConversationId): Promise<InterAgentCommunication[]>;
22
30
  }
@@ -1 +1 @@
1
- {"version":3,"file":"postgres.store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/postgres.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,IAAI,CAAC;AAO3C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,2BAA2B;IAC1C,oEAAoE;IACpE,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,qBAAa,oBAAqB,SAAQ,YAAY;;IAIpD,OAAO;IAMP,qEAAqE;WACxD,MAAM,CACjB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC;IA8BjB,SAAS,CACtB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAaP,OAAO,CACd,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC;IA8BvB,OAAO,CACd,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAgBvB,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,KAAK,CACZ,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAI5B,qBAAqB,CAC5B,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAsFtC"}
1
+ {"version":3,"file":"postgres.store.d.ts","sources":["../../../src/zukhruf/mailbox/postgres.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAG/B,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,YAAY,EACZ,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,2BAA2B;IAC1C,oEAAoE;IACpE,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,qBAAa,oBAAqB,SAAQ,YAAY;;IAGpD,OAAO,eAGN;IAED,qEAAqE;IACrE,OAAa,MAAM,CACjB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAM/B;IAED;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,mBAAmB,GAAG,yBAAyB,CAEvD;IAmBc,SAAS,CACtB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAWf;IAEQ,OAAO,CACd,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC,CA4B/B;IAEQ,OAAO,CACd,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAc/B;IAEQ,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;IAEQ,qBAAqB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAU1E;IAEQ,KAAK,CACZ,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAEpC;IAEQ,qBAAqB,CAC5B,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAEpC;CAoFF"}
@@ -1,13 +1,15 @@
1
+ import type { DatabaseSync } from 'node:sqlite';
1
2
  import { type MailboxEndTurnResult, type MailboxEnqueueResult, MailboxStore } from './store.ts';
2
3
  import { type ConversationId, type InterAgentCommunication } from './types.ts';
3
4
  /** SQLite-backed mailbox for durable cross-process delivery. */
4
5
  export declare class SqliteMailboxStore extends MailboxStore implements Disposable {
5
6
  #private;
6
- constructor(path: string);
7
+ constructor(pathOrDb: string | DatabaseSync);
7
8
  beginTurn(recipient: ConversationId, turnId: string): Promise<void>;
8
9
  enqueue(communication: InterAgentCommunication): Promise<MailboxEnqueueResult>;
9
10
  endTurn(recipient: ConversationId, turnId: string): Promise<MailboxEndTurnResult>;
10
11
  hasPending(recipient: ConversationId): Promise<boolean>;
12
+ hasPendingTriggerTurn(recipient: ConversationId): Promise<boolean>;
11
13
  drain(recipient: ConversationId): Promise<InterAgentCommunication[]>;
12
14
  drainLeadingQueueOnly(recipient: ConversationId): Promise<InterAgentCommunication[]>;
13
15
  close(): void;
@@ -1 +1 @@
1
- {"version":3,"file":"sqlite.store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/sqlite.store.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AAcpB,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,UAAU;;gBAG5D,IAAI,EAAE,MAAM;IAOT,SAAS,CACtB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAoBD,OAAO,CACpB,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC;IA8BjB,OAAO,CACpB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAqBjB,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA0CvD,KAAK,CAClB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAItB,qBAAqB,CAClC,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IA0DrC,KAAK,IAAI,IAAI;IAKb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}
1
+ {"version":3,"file":"sqlite.store.d.ts","sources":["../../../src/zukhruf/mailbox/sqlite.store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAE7B,MAAM,YAAY,CAAC;AAcpB,gEAAgE;AAChE,qBAAa,kBAAmB,SAAQ,YAAa,YAAW,UAAU;;IAGxE,YAAY,QAAQ,EAAE,MAAM,GAAG,YAAY,EAI1C;IAEc,SAAS,CACtB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAkBf;IAEc,OAAO,CACpB,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC,CA4B/B;IAEc,OAAO,CACpB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAmB/B;IAEc,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE;IAEc,qBAAqB,CAClC,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,OAAO,CAAC,CAYlB;IAwCc,KAAK,CAClB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAEpC;IAEc,qBAAqB,CAClC,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAEpC;IAwDD,KAAK,IAAI,IAAI,CAGZ;IAED,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAEvB;CACF"}
@@ -12,9 +12,13 @@ export declare abstract class MailboxStore {
12
12
  abstract enqueue(communication: InterAgentCommunication): Promise<MailboxEnqueueResult>;
13
13
  abstract endTurn(recipient: ConversationId, turnId: string): Promise<MailboxEndTurnResult>;
14
14
  abstract hasPending(recipient: ConversationId): Promise<boolean>;
15
+ /** Whether undelivered mail sent with `MessageDeliveryModes.TriggerTurn` waits for the recipient. */
16
+ abstract hasPendingTriggerTurn(recipient: ConversationId): Promise<boolean>;
15
17
  /** Consumes the contiguous queue-only prefix, stopping before the first trigger. */
16
18
  abstract drainLeadingQueueOnly(recipient: ConversationId): Promise<InterAgentCommunication[]>;
17
19
  /** Draining is consumption: removes and returns all pending mail in FIFO order. */
18
20
  abstract drain(recipient: ConversationId): Promise<InterAgentCommunication[]>;
19
21
  }
22
+ /** The part of the mailbox that writes inside a caller's transaction. */
23
+ export type TransactionalMailboxStore = Pick<MailboxStore, 'enqueue' | 'beginTurn' | 'hasPendingTriggerTurn'>;
20
24
  //# sourceMappingURL=store.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,iFAAiF;AACjF,8BAAsB,YAAY;IAChC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE5E,QAAQ,CAAC,OAAO,CACd,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC;IAEhC,QAAQ,CAAC,OAAO,CACd,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC;IAEhC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhE,oFAAoF;IACpF,QAAQ,CAAC,qBAAqB,CAC5B,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAErC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;CAC9E"}
1
+ {"version":3,"file":"store.d.ts","sources":["../../../src/zukhruf/mailbox/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,iFAAiF;AACjF,8BAAsB,YAAY;IAChC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7E,QAAQ,CAAC,OAAO,CACd,aAAa,EAAE,uBAAuB,GACrC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC,QAAQ,CAAC,OAAO,CACd,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAEjC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE,qGAAqG;IACrG,QAAQ,CAAC,qBAAqB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5E,oFAAoF;IACpF,QAAQ,CAAC,qBAAqB,CAC5B,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAEtC,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CAC/E;AAED,yEAAyE;AACzE,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,YAAY,EACZ,SAAS,GAAG,WAAW,GAAG,uBAAuB,CAClD,CAAC"}
@@ -4,14 +4,14 @@ export interface ConversationId {
4
4
  userId: string;
5
5
  }
6
6
  export declare const MessageDeliveryModes: {
7
- readonly QueueOnly: "queue-only";
8
- readonly TriggerTurn: "trigger-turn";
7
+ readonly QueueOnly: 'queue-only';
8
+ readonly TriggerTurn: 'trigger-turn';
9
9
  };
10
10
  export type MessageDeliveryMode = (typeof MessageDeliveryModes)[keyof typeof MessageDeliveryModes];
11
11
  export declare const InterAgentCommunicationTypes: {
12
- readonly Message: "MESSAGE";
13
- readonly NewTask: "NEW_TASK";
14
- readonly FinalAnswer: "FINAL_ANSWER";
12
+ readonly Message: 'MESSAGE';
13
+ readonly NewTask: 'NEW_TASK';
14
+ readonly FinalAnswer: 'FINAL_ANSWER';
15
15
  };
16
16
  export type InterAgentCommunicationType = (typeof InterAgentCommunicationTypes)[keyof typeof InterAgentCommunicationTypes];
17
17
  /** A model-visible message sent from one independent agent thread to another. */
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/zukhruf/mailbox/types.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEnE,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAEnF,iFAAiF;AACjF,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,cAAc,CAAC;IAC1B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,uBAAuB,EACvB,IAAI,GAAG,iBAAiB,GAAG,aAAa,GAAG,MAAM,CAClD,GAAG;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,2BAA2B,CAAC;CACpC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,0BAA0B,GACxC,uBAAuB,CAUzB;AAED,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,uBAAuB,GACrC,IAAI,CAiBN"}
1
+ {"version":3,"file":"types.d.ts","sources":["../../../src/zukhruf/mailbox/types.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,oBAAoB;aAC/B,SAAS,EAAE,YAAY;aACvB,WAAW,EAAE,cAAc;CACnB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEnE,eAAO,MAAM,4BAA4B;aACvC,OAAO,EAAE,SAAS;aAClB,OAAO,EAAE,UAAU;aACnB,WAAW,EAAE,cAAc;CACnB,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,OAAO,4BAA4B,CAAC,CAAC;AAEnF,iFAAiF;AACjF,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,2BAA2B,CAAC;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,cAAc,CAAC;IAC1B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,uBAAuB,EACvB,IAAI,GAAG,iBAAiB,GAAG,aAAa,GAAG,MAAM,CAClD,GAAG;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,2BAA2B,CAAC;CACpC,CAAC;AAEF,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,0BAA0B,GACxC,uBAAuB,CAUzB;AAED,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,uBAAuB,GACrC,IAAI,CAiBN"}
@@ -1 +1 @@
1
- {"version":3,"file":"multi-agent-config.d.ts","sourceRoot":"","sources":["../../src/zukhruf/multi-agent-config.ts"],"names":[],"mappings":"AA+BA,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,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;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B,EAAE,MAAM,CAAC;IACvC,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,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,GAAE,oBAAyB,GAC/B,4BAA4B,CA0F9B"}
1
+ {"version":3,"file":"multi-agent-config.d.ts","sources":["../../src/zukhruf/multi-agent-config.ts"],"names":[],"mappings":"AA+BA,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,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;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B,EAAE,MAAM,CAAC;IACvC,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,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,2BAA2B,CACzC,KAAK,GAAE,oBAAyB,GAC/B,4BAA4B,CA0F9B"}
@@ -23,8 +23,8 @@ declare const schedulingStateSchema: z.ZodObject<{
23
23
  }, z.core.$strict>>;
24
24
  dispatching: z.ZodOptional<z.ZodObject<{
25
25
  kind: z.ZodEnum<{
26
- dynamic: "dynamic";
27
26
  cron: "cron";
27
+ dynamic: "dynamic";
28
28
  }>;
29
29
  definitionId: z.ZodOptional<z.ZodUUID>;
30
30
  generation: z.ZodNumber;
@@ -1 +1 @@
1
- {"version":3,"file":"conversation-scheduler.d.ts","sourceRoot":"","sources":["../../../../src/zukhruf/plugins/conversation-scheduling/conversation-scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA0C/D,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0BvB,CAAC;AAEL,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAGtD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,cAAc,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAsBD,UAAU,4BAA4B;IACpC,SAAS,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACzC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,IAAI,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACpC;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,sEAAsE;AACtE,qBAAa,qBAAqB;;IAIhC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,EAAE,4BAA4B;IAO3C,UAAU,CACd,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC;IA4DpB,QAAQ,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOjE,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnE,eAAe,CACnB,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IAmCI,WAAW,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB1D,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAIvD,wBAAwB,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAmW5E"}
1
+ {"version":3,"file":"conversation-scheduler.d.ts","sources":["../../../../src/zukhruf/plugins/conversation-scheduling/conversation-scheduler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA0C/D,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0BvB,CAAC;AAEL,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC7D,KAAK,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAGtD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,cAAc,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAsBD,UAAU,4BAA4B;IACpC,SAAS,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACzC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,IAAI,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACpC;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,sEAAsE;AACtE,qBAAa,qBAAqB;;IAIhC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,OAAO,EAAE,4BAA4B,EAKhD;IAEK,UAAU,CACd,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CA0DzB;IAEK,QAAQ,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAKtE;IAEK,UAAU,CAAC,YAAY,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAexE;IAEK,eAAe,CACnB,YAAY,EAAE,cAAc,EAC5B,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC,CAiCD;IAEK,WAAW,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB/D;IAEK,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5D;IAEK,wBAAwB,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B1E;CAwUF"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/zukhruf/plugins/conversation-scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,eAAO,MAAM,kCAAkC;;;IAO7C,iEAAiE;;cACxB;YAAE,GAAG,IAAI,MAAM,CAAA;SAAE;;CAGlD,CAAC;AAEX,+EAA+E;AAC/E,wBAAgB,sBAAsB,IAAI,qBAAqB,CAkC9D"}
1
+ {"version":3,"file":"index.d.ts","sources":["../../../../src/zukhruf/plugins/conversation-scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,eAAO,MAAM,kCAAkC;aAC7C,SAAS;aAGT,QAAQ;IAGR,iEAAiE;aACjE,KAAK;cAAoC;YAAE,GAAG,IAAI,MAAM,CAAA;SAAE;;CAGlD,CAAC;AAEX,+EAA+E;AAC/E,wBAAgB,sBAAsB,IAAI,qBAAqB,CAkC9D"}
@@ -1,42 +1,91 @@
1
1
  // packages/experimental/src/zukhruf/runtime/agent-runtime.ts
2
2
  import {
3
- ContextEngine as ContextEngine5
3
+ ContextEngine as ContextEngine6
4
4
  } from "@deepagents/context";
5
5
 
6
6
  // packages/experimental/src/zukhruf/control-plane/agent-control-plane.ts
7
7
  import { v5 as uuidv54 } from "uuid";
8
8
 
9
+ // packages/experimental/src/zukhruf/runtime/conversation-status/projector.ts
10
+ import { Future, Latch } from "@zukhruf/async";
11
+ import { Mutex } from "@zukhruf/mutex";
12
+ import { MemoryStore } from "@zukhruf/mutex/memory";
13
+ import {
14
+ ContextEngine as ContextEngine2
15
+ } from "@deepagents/context";
16
+
17
+ // packages/experimental/src/zukhruf/runtime/approval-controller.ts
18
+ import {
19
+ getToolName,
20
+ isToolUIPart
21
+ } from "ai";
22
+ import {
23
+ ContextEngine,
24
+ assistant
25
+ } from "@deepagents/context";
26
+
27
+ // packages/experimental/src/zukhruf/runtime/conversation-status/child-progress.ts
28
+ import { z } from "zod";
29
+ var childActivitySchema = z.object({
30
+ id: z.string(),
31
+ type: z.enum(["spawn", "message", "followup", "interrupt", "completion"]),
32
+ at: z.number(),
33
+ actorPath: z.string(),
34
+ targetPath: z.string(),
35
+ streamId: z.string(),
36
+ outcome: z.enum(["completed", "failed", "cancelled"]).optional()
37
+ });
38
+ var childActivitiesSchema = z.partialRecord(
39
+ childActivitySchema.shape.type,
40
+ childActivitySchema
41
+ );
42
+ var childActivityMetadataSchema = z.looseObject({
43
+ childActivities: childActivitiesSchema.default({})
44
+ });
45
+
46
+ // packages/experimental/src/zukhruf/runtime/conversation-status/projector.ts
47
+ var Detached = class {
48
+ // A private member keeps the type nominal: an empty class would also
49
+ // describe RemoteAttachment, and `instanceof` could not narrow the union.
50
+ #detached = true;
51
+ };
52
+ var DETACHED = new Detached();
53
+
9
54
  // packages/experimental/src/zukhruf/control-plane/agent-directory.ts
10
55
  import { v5 as uuidv5 } from "uuid";
11
56
 
57
+ // packages/experimental/src/zukhruf/control-plane/agent-thread.ts
58
+ import { isRecord } from "@deepagents/context";
59
+
12
60
  // packages/experimental/src/zukhruf/control-plane/agent-history-forker.ts
13
61
  import { validateUIMessages } from "ai";
14
62
  import { v5 as uuidv52 } from "uuid";
15
63
  import {
64
+ isRecord as isRecord2,
16
65
  isSyntheticReminderMessage
17
66
  } from "@deepagents/context";
18
67
 
19
68
  // packages/experimental/src/zukhruf/control-plane/agent-status-projector.ts
20
69
  import { isTextUIPart } from "ai";
21
- import { z } from "zod";
70
+ import { z as z2 } from "zod";
22
71
  import {
23
- ContextEngine
72
+ ContextEngine as ContextEngine3
24
73
  } from "@deepagents/context";
25
- var listedAgentStatusSchema = z.union([
26
- z.enum(["pending_init", "running", "interrupted", "shutdown", "not_found"]),
27
- z.object({ completed: z.string().nullable() }).strict(),
28
- z.object({ errored: z.string() }).strict()
74
+ var listedAgentStatusSchema = z2.union([
75
+ z2.enum(["pending_init", "running", "interrupted", "shutdown", "not_found"]),
76
+ z2.object({ completed: z2.string().nullable() }).strict(),
77
+ z2.object({ errored: z2.string() }).strict()
29
78
  ]);
30
- var listedAgentSchema = z.object({
31
- agent_name: z.string(),
79
+ var listedAgentSchema = z2.object({
80
+ agent_name: z2.string(),
32
81
  agent_status: listedAgentStatusSchema
33
82
  }).strict();
34
83
 
35
84
  // packages/experimental/src/zukhruf/control-plane/agent-turn-id.ts
36
85
  import { v5 as uuidv53, validate as validateUuid } from "uuid";
37
- import { z as z2 } from "zod";
86
+ import { z as z3 } from "zod";
38
87
  var prefix = "zukhruf-turn";
39
- var agentTurnIdSchema = z2.string().refine((value) => {
88
+ var agentTurnIdSchema = z3.string().refine((value) => {
40
89
  const [head, scope, turn, ...rest] = value.split(":");
41
90
  return head === prefix && rest.length === 0 && validateUuid(scope) && validateUuid(turn);
42
91
  });
@@ -50,6 +99,11 @@ function conversationNamespace(conversation) {
50
99
  );
51
100
  }
52
101
 
102
+ // packages/experimental/src/zukhruf/control-plane/agent-residency.ts
103
+ import {
104
+ ContextEngine as ContextEngine4
105
+ } from "@deepagents/context";
106
+
53
107
  // packages/experimental/src/zukhruf/mailbox/coordinator.ts
54
108
  import pMemoize from "p-memoize";
55
109
 
@@ -60,10 +114,11 @@ import {
60
114
  tool
61
115
  } from "ai";
62
116
  import {
63
- ContextEngine as ContextEngine2,
117
+ ContextEngine as ContextEngine5,
64
118
  agent,
65
- assistant,
119
+ assistant as assistant2,
66
120
  chat,
121
+ isRecord as isRecord4,
67
122
  role,
68
123
  user
69
124
  } from "@deepagents/context";
@@ -78,7 +133,7 @@ import {
78
133
  asSchema,
79
134
  modelMessageSchema as modelMessageSchema2
80
135
  } from "ai";
81
- import { z as z3 } from "zod";
136
+ import { z as z4 } from "zod";
82
137
 
83
138
  // packages/compaction/dist/index.js
84
139
  import {
@@ -87,21 +142,24 @@ import {
87
142
  } from "ai";
88
143
 
89
144
  // packages/experimental/src/zukhruf/runtime/compaction.ts
90
- var checkpointSchema = z3.object({
91
- sourceCount: z3.number().int().positive(),
92
- sourceHash: z3.string(),
93
- replacement: z3.array(z3.unknown()).transform(
145
+ import {
146
+ isRecord as isRecord3
147
+ } from "@deepagents/context";
148
+ var checkpointSchema = z4.object({
149
+ sourceCount: z4.number().int().positive(),
150
+ sourceHash: z4.string(),
151
+ replacement: z4.array(z4.unknown()).transform(
94
152
  (messages) => messages.map((message) => modelMessageSchema2.parse(message))
95
153
  )
96
154
  });
97
- var cacheObservationSchema = z3.object({
98
- scope: z3.string(),
99
- prefixLength: z3.number().int().nonnegative(),
100
- prefixHash: z3.string(),
101
- startedAt: z3.number().int().nonnegative(),
102
- retentionMs: z3.number().int().positive().optional()
155
+ var cacheObservationSchema = z4.object({
156
+ scope: z4.string(),
157
+ prefixLength: z4.number().int().nonnegative(),
158
+ prefixHash: z4.string(),
159
+ startedAt: z4.number().int().nonnegative(),
160
+ retentionMs: z4.number().int().positive().optional()
103
161
  });
104
- var inputUsageSchema = cacheObservationSchema.pick({ scope: true, prefixLength: true, prefixHash: true }).extend({ inputTokens: z3.number().int().nonnegative() });
162
+ var inputUsageSchema = cacheObservationSchema.pick({ scope: true, prefixLength: true, prefixHash: true }).extend({ inputTokens: z4.number().int().nonnegative() });
105
163
 
106
164
  // packages/experimental/src/zukhruf/runtime/plugin/agent-skills.ts
107
165
  import {
@@ -109,51 +167,6 @@ import {
109
167
  skills
110
168
  } from "@deepagents/context";
111
169
 
112
- // packages/experimental/src/zukhruf/runtime/approval-controller.ts
113
- import {
114
- getToolName,
115
- isToolUIPart
116
- } from "ai";
117
- import {
118
- ContextEngine as ContextEngine3,
119
- assistant as assistant2
120
- } from "@deepagents/context";
121
-
122
- // packages/experimental/src/zukhruf/runtime/conversation-status/projector.ts
123
- import { Future, Latch } from "@zukhruf/async";
124
- import { Mutex } from "@zukhruf/mutex";
125
- import { MemoryStore } from "@zukhruf/mutex/memory";
126
- import {
127
- ContextEngine as ContextEngine4
128
- } from "@deepagents/context";
129
-
130
- // packages/experimental/src/zukhruf/runtime/conversation-status/child-progress.ts
131
- import { z as z4 } from "zod";
132
- var childActivitySchema = z4.object({
133
- id: z4.string(),
134
- type: z4.enum(["spawn", "message", "followup", "interrupt", "completion"]),
135
- at: z4.number(),
136
- actorPath: z4.string(),
137
- targetPath: z4.string(),
138
- streamId: z4.string(),
139
- outcome: z4.enum(["completed", "failed", "cancelled"]).optional()
140
- });
141
- var childActivitiesSchema = z4.partialRecord(
142
- childActivitySchema.shape.type,
143
- childActivitySchema
144
- );
145
- var childActivityMetadataSchema = z4.looseObject({
146
- childActivities: childActivitiesSchema.default({})
147
- });
148
-
149
- // packages/experimental/src/zukhruf/runtime/conversation-status/projector.ts
150
- var Detached = class {
151
- // A private member keeps the type nominal: an empty class would also
152
- // describe RemoteAttachment, and `instanceof` could not narrow the union.
153
- #detached = true;
154
- };
155
- var DETACHED = new Detached();
156
-
157
170
  // packages/experimental/src/zukhruf/collaboration/interrupt-agent.ts
158
171
  import { tool as tool2 } from "ai";
159
172
  import { z as z5 } from "zod";
@@ -277,7 +290,7 @@ var AgentPluginCapability = class {
277
290
  import { CronExpressionParser } from "cron-parser";
278
291
  import { v5 as uuidv55 } from "uuid";
279
292
  import { z as z10 } from "zod";
280
- import { isRecord } from "@deepagents/context";
293
+ import { isRecord as isRecord5 } from "@deepagents/context";
281
294
  var DAY_MS = 24 * 60 * 60 * 1e3;
282
295
  var CRON_LIFETIME_MS = 7 * DAY_MS;
283
296
  var MAX_CRON_JOBS = 50;
@@ -724,7 +737,7 @@ var ConversationScheduler = class _ConversationScheduler {
724
737
  return parsed.data;
725
738
  }
726
739
  static #record(value) {
727
- if (!isRecord(value)) {
740
+ if (!isRecord5(value)) {
728
741
  throw new Error("Invalid metadata.zukhruf state");
729
742
  }
730
743
  return value;