@plumbus/core 0.7.1 → 0.8.0-beta.1

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 (513) hide show
  1. package/CHANGELOG.md +49 -0
  2. package/README.md +2 -1
  3. package/dist/.tsbuildinfo +1 -1
  4. package/dist/admission/client.d.ts +9 -0
  5. package/dist/admission/client.d.ts.map +1 -0
  6. package/dist/admission/client.js +34 -0
  7. package/dist/admission/client.js.map +1 -0
  8. package/dist/admission/index.d.ts +5 -0
  9. package/dist/admission/index.d.ts.map +1 -0
  10. package/dist/admission/index.js +4 -0
  11. package/dist/admission/index.js.map +1 -0
  12. package/dist/admission/request-admission.d.ts +26 -0
  13. package/dist/admission/request-admission.d.ts.map +1 -0
  14. package/dist/admission/request-admission.js +85 -0
  15. package/dist/admission/request-admission.js.map +1 -0
  16. package/dist/admission/shared.d.ts +31 -0
  17. package/dist/admission/shared.d.ts.map +1 -0
  18. package/dist/admission/shared.js +30 -0
  19. package/dist/admission/shared.js.map +1 -0
  20. package/dist/ai/ai/provider.d.ts +5 -7
  21. package/dist/ai/ai-service.d.ts +8 -1
  22. package/dist/ai/ai-service.d.ts.map +1 -1
  23. package/dist/ai/ai-service.js +23 -13
  24. package/dist/ai/ai-service.js.map +1 -1
  25. package/dist/ai/errors/data-errors.d.ts +6 -0
  26. package/dist/ai/errors/index.d.ts +4 -1
  27. package/dist/ai/fill-prompt-template.d.ts +12 -0
  28. package/dist/ai/fill-prompt-template.d.ts.map +1 -0
  29. package/dist/ai/fill-prompt-template.js +19 -0
  30. package/dist/ai/fill-prompt-template.js.map +1 -0
  31. package/dist/ai/governed-artifacts.d.ts +49 -0
  32. package/dist/ai/governed-artifacts.d.ts.map +1 -0
  33. package/dist/ai/governed-artifacts.js +277 -0
  34. package/dist/ai/governed-artifacts.js.map +1 -0
  35. package/dist/ai/governed-budget.d.ts +17 -0
  36. package/dist/ai/governed-budget.d.ts.map +1 -0
  37. package/dist/ai/governed-budget.js +52 -0
  38. package/dist/ai/governed-budget.js.map +1 -0
  39. package/dist/ai/governed-host.d.ts +54 -0
  40. package/dist/ai/governed-host.d.ts.map +1 -0
  41. package/dist/ai/governed-host.js +8 -0
  42. package/dist/ai/governed-host.js.map +1 -0
  43. package/dist/ai/governed-invoke.d.ts +41 -0
  44. package/dist/ai/governed-invoke.d.ts.map +1 -0
  45. package/dist/ai/governed-invoke.js +102 -0
  46. package/dist/ai/governed-invoke.js.map +1 -0
  47. package/dist/ai/governed-runtime.d.ts +103 -0
  48. package/dist/ai/governed-runtime.d.ts.map +1 -0
  49. package/dist/ai/governed-runtime.js +151 -0
  50. package/dist/ai/governed-runtime.js.map +1 -0
  51. package/dist/ai/index.d.ts +12 -2
  52. package/dist/ai/index.d.ts.map +1 -1
  53. package/dist/ai/index.js +8 -2
  54. package/dist/ai/index.js.map +1 -1
  55. package/dist/ai/prompt-registry.d.ts +6 -0
  56. package/dist/ai/prompt-registry.d.ts.map +1 -1
  57. package/dist/ai/prompt-registry.js +12 -0
  58. package/dist/ai/prompt-registry.js.map +1 -1
  59. package/dist/ai/provider.d.ts +5 -7
  60. package/dist/ai/provider.d.ts.map +1 -1
  61. package/dist/ai/provider.js +29 -0
  62. package/dist/ai/provider.js.map +1 -1
  63. package/dist/ai/types/enums.d.ts +2 -0
  64. package/dist/ai/types/fields.d.ts +7 -0
  65. package/dist/ai/types/prompt.d.ts +8 -0
  66. package/dist/ai/validation.d.ts.map +1 -1
  67. package/dist/ai/validation.js +10 -1
  68. package/dist/ai/validation.js.map +1 -1
  69. package/dist/api/exposure.d.ts +14 -0
  70. package/dist/api/exposure.d.ts.map +1 -1
  71. package/dist/api/exposure.js +16 -0
  72. package/dist/api/exposure.js.map +1 -1
  73. package/dist/api/idempotency.d.ts +67 -0
  74. package/dist/api/idempotency.d.ts.map +1 -0
  75. package/dist/api/idempotency.js +176 -0
  76. package/dist/api/idempotency.js.map +1 -0
  77. package/dist/api/index.d.ts +3 -1
  78. package/dist/api/index.d.ts.map +1 -1
  79. package/dist/api/index.js +4 -2
  80. package/dist/api/index.js.map +1 -1
  81. package/dist/api/route-generator.d.ts +50 -6
  82. package/dist/api/route-generator.d.ts.map +1 -1
  83. package/dist/api/route-generator.js +254 -12
  84. package/dist/api/route-generator.js.map +1 -1
  85. package/dist/approvals/action-risk.d.ts +41 -0
  86. package/dist/approvals/action-risk.d.ts.map +1 -0
  87. package/dist/approvals/action-risk.js +56 -0
  88. package/dist/approvals/action-risk.js.map +1 -0
  89. package/dist/approvals/actors.d.ts +8 -0
  90. package/dist/approvals/actors.d.ts.map +1 -0
  91. package/dist/approvals/actors.js +26 -0
  92. package/dist/approvals/actors.js.map +1 -0
  93. package/dist/approvals/authorization.d.ts +5 -0
  94. package/dist/approvals/authorization.d.ts.map +1 -0
  95. package/dist/approvals/authorization.js +16 -0
  96. package/dist/approvals/authorization.js.map +1 -0
  97. package/dist/approvals/digest.d.ts +3 -0
  98. package/dist/approvals/digest.d.ts.map +1 -0
  99. package/dist/approvals/digest.js +21 -0
  100. package/dist/approvals/digest.js.map +1 -0
  101. package/dist/approvals/gate.d.ts +15 -0
  102. package/dist/approvals/gate.d.ts.map +1 -0
  103. package/dist/approvals/gate.js +102 -0
  104. package/dist/approvals/gate.js.map +1 -0
  105. package/dist/approvals/host-runtime.d.ts +16 -0
  106. package/dist/approvals/host-runtime.d.ts.map +1 -0
  107. package/dist/approvals/host-runtime.js +12 -0
  108. package/dist/approvals/host-runtime.js.map +1 -0
  109. package/dist/approvals/index.d.ts +19 -0
  110. package/dist/approvals/index.d.ts.map +1 -0
  111. package/dist/approvals/index.js +13 -0
  112. package/dist/approvals/index.js.map +1 -0
  113. package/dist/approvals/memory-store.d.ts +3 -0
  114. package/dist/approvals/memory-store.d.ts.map +1 -0
  115. package/dist/approvals/memory-store.js +33 -0
  116. package/dist/approvals/memory-store.js.map +1 -0
  117. package/dist/approvals/schema.d.ts +484 -0
  118. package/dist/approvals/schema.d.ts.map +1 -0
  119. package/dist/approvals/schema.js +55 -0
  120. package/dist/approvals/schema.js.map +1 -0
  121. package/dist/approvals/service.d.ts +17 -0
  122. package/dist/approvals/service.d.ts.map +1 -0
  123. package/dist/approvals/service.js +240 -0
  124. package/dist/approvals/service.js.map +1 -0
  125. package/dist/approvals/sql-store.d.ts +9 -0
  126. package/dist/approvals/sql-store.d.ts.map +1 -0
  127. package/dist/approvals/sql-store.js +179 -0
  128. package/dist/approvals/sql-store.js.map +1 -0
  129. package/dist/approvals/types.d.ts +156 -0
  130. package/dist/approvals/types.d.ts.map +1 -0
  131. package/dist/approvals/types.js +32 -0
  132. package/dist/approvals/types.js.map +1 -0
  133. package/dist/approvals/wait.d.ts +10 -0
  134. package/dist/approvals/wait.d.ts.map +1 -0
  135. package/dist/approvals/wait.js +11 -0
  136. package/dist/approvals/wait.js.map +1 -0
  137. package/dist/audit/service.d.ts.map +1 -1
  138. package/dist/audit/service.js +6 -1
  139. package/dist/audit/service.js.map +1 -1
  140. package/dist/cli/cli.d.ts.map +1 -1
  141. package/dist/cli/cli.js +2 -1
  142. package/dist/cli/cli.js.map +1 -1
  143. package/dist/cli/commands/api.d.ts +65 -0
  144. package/dist/cli/commands/api.d.ts.map +1 -1
  145. package/dist/cli/commands/api.js +79 -4
  146. package/dist/cli/commands/api.js.map +1 -1
  147. package/dist/cli/commands/compile-flows.d.ts +9 -0
  148. package/dist/cli/commands/compile-flows.d.ts.map +1 -0
  149. package/dist/cli/commands/compile-flows.js +55 -0
  150. package/dist/cli/commands/compile-flows.js.map +1 -0
  151. package/dist/cli/commands/dev.d.ts +6 -0
  152. package/dist/cli/commands/dev.d.ts.map +1 -1
  153. package/dist/cli/commands/dev.js +22 -5
  154. package/dist/cli/commands/dev.js.map +1 -1
  155. package/dist/cli/commands/e2e.d.ts +5 -0
  156. package/dist/cli/commands/e2e.d.ts.map +1 -1
  157. package/dist/cli/commands/e2e.js +42 -3
  158. package/dist/cli/commands/e2e.js.map +1 -1
  159. package/dist/cli/commands/flow.d.ts.map +1 -1
  160. package/dist/cli/commands/flow.js +12 -3
  161. package/dist/cli/commands/flow.js.map +1 -1
  162. package/dist/cli/commands/generate-openapi-from-zod.d.ts +26 -0
  163. package/dist/cli/commands/generate-openapi-from-zod.d.ts.map +1 -0
  164. package/dist/cli/commands/generate-openapi-from-zod.js +189 -0
  165. package/dist/cli/commands/generate-openapi-from-zod.js.map +1 -0
  166. package/dist/cli/commands/generate.d.ts +10 -4
  167. package/dist/cli/commands/generate.d.ts.map +1 -1
  168. package/dist/cli/commands/generate.js +27 -70
  169. package/dist/cli/commands/generate.js.map +1 -1
  170. package/dist/cli/commands/index.d.ts +1 -0
  171. package/dist/cli/commands/index.d.ts.map +1 -1
  172. package/dist/cli/commands/index.js +2 -0
  173. package/dist/cli/commands/index.js.map +1 -1
  174. package/dist/cli/commands/mcp.d.ts +5 -0
  175. package/dist/cli/commands/mcp.d.ts.map +1 -1
  176. package/dist/cli/commands/mcp.js +28 -2
  177. package/dist/cli/commands/mcp.js.map +1 -1
  178. package/dist/cli/commands/migrate.d.ts +1 -0
  179. package/dist/cli/commands/migrate.d.ts.map +1 -1
  180. package/dist/cli/commands/migrate.js +145 -34
  181. package/dist/cli/commands/migrate.js.map +1 -1
  182. package/dist/cli/commands/openapi-3-1.d.ts +34 -0
  183. package/dist/cli/commands/openapi-3-1.d.ts.map +1 -0
  184. package/dist/cli/commands/openapi-3-1.js +333 -0
  185. package/dist/cli/commands/openapi-3-1.js.map +1 -0
  186. package/dist/cli/commands/start.d.ts +5 -0
  187. package/dist/cli/commands/start.d.ts.map +1 -1
  188. package/dist/cli/commands/start.js +20 -2
  189. package/dist/cli/commands/start.js.map +1 -1
  190. package/dist/cli/commands/ui.d.ts +11 -0
  191. package/dist/cli/commands/ui.d.ts.map +1 -1
  192. package/dist/cli/commands/ui.js +105 -20
  193. package/dist/cli/commands/ui.js.map +1 -1
  194. package/dist/cli/commands/verify.d.ts.map +1 -1
  195. package/dist/cli/commands/verify.js +2 -0
  196. package/dist/cli/commands/verify.js.map +1 -1
  197. package/dist/cli/commands/worker.d.ts +5 -0
  198. package/dist/cli/commands/worker.d.ts.map +1 -1
  199. package/dist/cli/commands/worker.js +18 -2
  200. package/dist/cli/commands/worker.js.map +1 -1
  201. package/dist/cli/index.d.ts +1 -1
  202. package/dist/cli/index.d.ts.map +1 -1
  203. package/dist/cli/index.js +1 -1
  204. package/dist/cli/index.js.map +1 -1
  205. package/dist/credentials/catalog.d.ts +71 -0
  206. package/dist/credentials/catalog.d.ts.map +1 -0
  207. package/dist/credentials/catalog.js +293 -0
  208. package/dist/credentials/catalog.js.map +1 -0
  209. package/dist/credentials/index.d.ts +3 -0
  210. package/dist/credentials/index.d.ts.map +1 -0
  211. package/dist/credentials/index.js +2 -0
  212. package/dist/credentials/index.js.map +1 -0
  213. package/dist/data/drift-inspector.d.ts +1 -4
  214. package/dist/data/drift-inspector.d.ts.map +1 -1
  215. package/dist/data/drift-inspector.js +39 -5
  216. package/dist/data/drift-inspector.js.map +1 -1
  217. package/dist/data/field-encryption.d.ts +7 -0
  218. package/dist/data/field-encryption.d.ts.map +1 -1
  219. package/dist/data/field-encryption.js +35 -17
  220. package/dist/data/field-encryption.js.map +1 -1
  221. package/dist/data/framework-migration-rewriter.js +1 -1
  222. package/dist/data/framework-migration-rewriter.js.map +1 -1
  223. package/dist/data/index.d.ts +1 -1
  224. package/dist/data/index.d.ts.map +1 -1
  225. package/dist/data/index.js +1 -1
  226. package/dist/data/index.js.map +1 -1
  227. package/dist/data/mask-fields.d.ts +2 -0
  228. package/dist/data/mask-fields.d.ts.map +1 -1
  229. package/dist/data/mask-fields.js +6 -0
  230. package/dist/data/mask-fields.js.map +1 -1
  231. package/dist/data/migration.d.ts.map +1 -1
  232. package/dist/data/migration.js +25 -1
  233. package/dist/data/migration.js.map +1 -1
  234. package/dist/data/repository.d.ts.map +1 -1
  235. package/dist/data/repository.js +15 -3
  236. package/dist/data/repository.js.map +1 -1
  237. package/dist/data/schema-generator.d.ts +95 -3
  238. package/dist/data/schema-generator.d.ts.map +1 -1
  239. package/dist/data/schema-generator.js +122 -6
  240. package/dist/data/schema-generator.js.map +1 -1
  241. package/dist/define/defineCapability.d.ts +7 -0
  242. package/dist/define/defineCapability.d.ts.map +1 -1
  243. package/dist/define/defineCapability.js +15 -0
  244. package/dist/define/defineCapability.js.map +1 -1
  245. package/dist/define/defineFlow.d.ts +3 -1
  246. package/dist/define/defineFlow.d.ts.map +1 -1
  247. package/dist/define/defineFlow.js.map +1 -1
  248. package/dist/durable/apply-ddl.d.ts +13 -0
  249. package/dist/durable/apply-ddl.d.ts.map +1 -0
  250. package/dist/durable/apply-ddl.js +278 -0
  251. package/dist/durable/apply-ddl.js.map +1 -0
  252. package/dist/durable/harness.d.ts +31 -0
  253. package/dist/durable/harness.d.ts.map +1 -0
  254. package/dist/durable/harness.js +136 -0
  255. package/dist/durable/harness.js.map +1 -0
  256. package/dist/durable/index.d.ts +18 -0
  257. package/dist/durable/index.d.ts.map +1 -0
  258. package/dist/durable/index.js +16 -0
  259. package/dist/durable/index.js.map +1 -0
  260. package/dist/durable/memory-store.d.ts +48 -0
  261. package/dist/durable/memory-store.d.ts.map +1 -0
  262. package/dist/durable/memory-store.js +260 -0
  263. package/dist/durable/memory-store.js.map +1 -0
  264. package/dist/durable/migrations-path.d.ts +5 -0
  265. package/dist/durable/migrations-path.d.ts.map +1 -0
  266. package/dist/durable/migrations-path.js +8 -0
  267. package/dist/durable/migrations-path.js.map +1 -0
  268. package/dist/durable/opaque-dispatch.d.ts +7 -0
  269. package/dist/durable/opaque-dispatch.d.ts.map +1 -0
  270. package/dist/durable/opaque-dispatch.js +67 -0
  271. package/dist/durable/opaque-dispatch.js.map +1 -0
  272. package/dist/durable/persist-before-ack.d.ts +52 -0
  273. package/dist/durable/persist-before-ack.d.ts.map +1 -0
  274. package/dist/durable/persist-before-ack.js +153 -0
  275. package/dist/durable/persist-before-ack.js.map +1 -0
  276. package/dist/durable/pg-env.d.ts +9 -0
  277. package/dist/durable/pg-env.d.ts.map +1 -0
  278. package/dist/durable/pg-env.js +20 -0
  279. package/dist/durable/pg-env.js.map +1 -0
  280. package/dist/durable/postgres-persist.d.ts +33 -0
  281. package/dist/durable/postgres-persist.d.ts.map +1 -0
  282. package/dist/durable/postgres-persist.js +239 -0
  283. package/dist/durable/postgres-persist.js.map +1 -0
  284. package/dist/durable/reconciliation.d.ts +20 -0
  285. package/dist/durable/reconciliation.d.ts.map +1 -0
  286. package/dist/durable/reconciliation.js +91 -0
  287. package/dist/durable/reconciliation.js.map +1 -0
  288. package/dist/durable/schema.d.ts +1448 -0
  289. package/dist/durable/schema.d.ts.map +1 -0
  290. package/dist/durable/schema.js +138 -0
  291. package/dist/durable/schema.js.map +1 -0
  292. package/dist/durable/spine-claim.d.ts +16 -0
  293. package/dist/durable/spine-claim.d.ts.map +1 -0
  294. package/dist/durable/spine-claim.js +131 -0
  295. package/dist/durable/spine-claim.js.map +1 -0
  296. package/dist/durable/types.d.ts +153 -0
  297. package/dist/durable/types.d.ts.map +1 -0
  298. package/dist/durable/types.js +114 -0
  299. package/dist/durable/types.js.map +1 -0
  300. package/dist/errors/data-errors.d.ts +6 -0
  301. package/dist/errors/data-errors.d.ts.map +1 -1
  302. package/dist/errors/data-errors.js +9 -0
  303. package/dist/errors/data-errors.js.map +1 -1
  304. package/dist/errors/http.d.ts.map +1 -1
  305. package/dist/errors/http.js +9 -1
  306. package/dist/errors/http.js.map +1 -1
  307. package/dist/errors/index.d.ts +4 -1
  308. package/dist/errors/index.d.ts.map +1 -1
  309. package/dist/errors/index.js +11 -1
  310. package/dist/errors/index.js.map +1 -1
  311. package/dist/errors-entry.d.ts +1 -1
  312. package/dist/errors-entry.d.ts.map +1 -1
  313. package/dist/errors-entry.js +1 -1
  314. package/dist/errors-entry.js.map +1 -1
  315. package/dist/events/consumer-registry.d.ts +6 -0
  316. package/dist/events/consumer-registry.d.ts.map +1 -1
  317. package/dist/events/consumer-registry.js.map +1 -1
  318. package/dist/events/dispatcher.d.ts +19 -0
  319. package/dist/events/dispatcher.d.ts.map +1 -1
  320. package/dist/events/dispatcher.js +161 -114
  321. package/dist/events/dispatcher.js.map +1 -1
  322. package/dist/events/idempotency.d.ts +3 -2
  323. package/dist/events/idempotency.d.ts.map +1 -1
  324. package/dist/events/idempotency.js +3 -2
  325. package/dist/events/idempotency.js.map +1 -1
  326. package/dist/events/index.d.ts +2 -0
  327. package/dist/events/index.d.ts.map +1 -1
  328. package/dist/events/index.js +1 -0
  329. package/dist/events/index.js.map +1 -1
  330. package/dist/events/subscription.d.ts +29 -0
  331. package/dist/events/subscription.d.ts.map +1 -0
  332. package/dist/events/subscription.js +19 -0
  333. package/dist/events/subscription.js.map +1 -0
  334. package/dist/events/worker.d.ts +8 -1
  335. package/dist/events/worker.d.ts.map +1 -1
  336. package/dist/events/worker.js +32 -5
  337. package/dist/events/worker.js.map +1 -1
  338. package/dist/execution/capability-executor.d.ts +6 -3
  339. package/dist/execution/capability-executor.d.ts.map +1 -1
  340. package/dist/execution/capability-executor.js +34 -6
  341. package/dist/execution/capability-executor.js.map +1 -1
  342. package/dist/execution/context-deps.d.ts +2 -0
  343. package/dist/execution/context-deps.d.ts.map +1 -1
  344. package/dist/execution/context-deps.js +2 -1
  345. package/dist/execution/context-deps.js.map +1 -1
  346. package/dist/execution/context-factory.d.ts +38 -1
  347. package/dist/execution/context-factory.d.ts.map +1 -1
  348. package/dist/execution/context-factory.js +102 -4
  349. package/dist/execution/context-factory.js.map +1 -1
  350. package/dist/execution/index.d.ts +2 -2
  351. package/dist/execution/index.d.ts.map +1 -1
  352. package/dist/execution/index.js +1 -1
  353. package/dist/execution/index.js.map +1 -1
  354. package/dist/execution/transactional-outbox.d.ts +10 -0
  355. package/dist/execution/transactional-outbox.d.ts.map +1 -1
  356. package/dist/execution/transactional-outbox.js +41 -2
  357. package/dist/execution/transactional-outbox.js.map +1 -1
  358. package/dist/flows/budget.d.ts +44 -0
  359. package/dist/flows/budget.d.ts.map +1 -0
  360. package/dist/flows/budget.js +81 -0
  361. package/dist/flows/budget.js.map +1 -0
  362. package/dist/flows/compile-flow.d.ts +23 -0
  363. package/dist/flows/compile-flow.d.ts.map +1 -0
  364. package/dist/flows/compile-flow.js +176 -0
  365. package/dist/flows/compile-flow.js.map +1 -0
  366. package/dist/flows/compiled-registry.d.ts +43 -0
  367. package/dist/flows/compiled-registry.d.ts.map +1 -0
  368. package/dist/flows/compiled-registry.js +198 -0
  369. package/dist/flows/compiled-registry.js.map +1 -0
  370. package/dist/flows/dead-letter.d.ts +16 -0
  371. package/dist/flows/dead-letter.d.ts.map +1 -1
  372. package/dist/flows/dead-letter.js +67 -0
  373. package/dist/flows/dead-letter.js.map +1 -1
  374. package/dist/flows/definition-strategy.d.ts +13 -0
  375. package/dist/flows/definition-strategy.d.ts.map +1 -0
  376. package/dist/flows/definition-strategy.js +30 -0
  377. package/dist/flows/definition-strategy.js.map +1 -0
  378. package/dist/flows/engine.d.ts +38 -1
  379. package/dist/flows/engine.d.ts.map +1 -1
  380. package/dist/flows/engine.js +375 -32
  381. package/dist/flows/engine.js.map +1 -1
  382. package/dist/flows/index.d.ts +12 -4
  383. package/dist/flows/index.d.ts.map +1 -1
  384. package/dist/flows/index.js +7 -2
  385. package/dist/flows/index.js.map +1 -1
  386. package/dist/flows/scheduler.d.ts +26 -0
  387. package/dist/flows/scheduler.d.ts.map +1 -1
  388. package/dist/flows/scheduler.js +157 -37
  389. package/dist/flows/scheduler.js.map +1 -1
  390. package/dist/flows/schema.d.ts +34 -0
  391. package/dist/flows/schema.d.ts.map +1 -1
  392. package/dist/flows/schema.js +4 -0
  393. package/dist/flows/schema.js.map +1 -1
  394. package/dist/flows/step-executor.d.ts +3 -0
  395. package/dist/flows/step-executor.d.ts.map +1 -1
  396. package/dist/flows/step-executor.js +33 -0
  397. package/dist/flows/step-executor.js.map +1 -1
  398. package/dist/governance/capability-source-scan.d.ts.map +1 -1
  399. package/dist/governance/capability-source-scan.js +2 -29
  400. package/dist/governance/capability-source-scan.js.map +1 -1
  401. package/dist/governance/forbidden-path-scan.d.ts +7 -0
  402. package/dist/governance/forbidden-path-scan.d.ts.map +1 -0
  403. package/dist/governance/forbidden-path-scan.js +60 -0
  404. package/dist/governance/forbidden-path-scan.js.map +1 -0
  405. package/dist/governance/index.d.ts +2 -0
  406. package/dist/governance/index.d.ts.map +1 -1
  407. package/dist/governance/index.js +2 -0
  408. package/dist/governance/index.js.map +1 -1
  409. package/dist/governance/source-walk.d.ts +3 -0
  410. package/dist/governance/source-walk.d.ts.map +1 -0
  411. package/dist/governance/source-walk.js +33 -0
  412. package/dist/governance/source-walk.js.map +1 -0
  413. package/dist/index.d.ts +21 -12
  414. package/dist/index.d.ts.map +1 -1
  415. package/dist/index.js +22 -9
  416. package/dist/index.js.map +1 -1
  417. package/dist/runtime/bootstrap.d.ts +3 -1
  418. package/dist/runtime/bootstrap.d.ts.map +1 -1
  419. package/dist/runtime/load-extensions.d.ts.map +1 -1
  420. package/dist/runtime/load-extensions.js +11 -0
  421. package/dist/runtime/load-extensions.js.map +1 -1
  422. package/dist/runtime/register-consumers.d.ts +3 -0
  423. package/dist/runtime/register-consumers.d.ts.map +1 -1
  424. package/dist/runtime/register-consumers.js +4 -0
  425. package/dist/runtime/register-consumers.js.map +1 -1
  426. package/dist/runtime/start-worker-pool.d.ts.map +1 -1
  427. package/dist/runtime/start-worker-pool.js +1 -0
  428. package/dist/runtime/start-worker-pool.js.map +1 -1
  429. package/dist/runtime-entry.d.ts +4 -0
  430. package/dist/runtime-entry.d.ts.map +1 -0
  431. package/dist/runtime-entry.js +30 -0
  432. package/dist/runtime-entry.js.map +1 -0
  433. package/dist/server/bootstrap.d.ts +116 -8
  434. package/dist/server/bootstrap.d.ts.map +1 -1
  435. package/dist/server/bootstrap.js +139 -62
  436. package/dist/server/bootstrap.js.map +1 -1
  437. package/dist/tenancy/data-plane-connection.d.ts +108 -0
  438. package/dist/tenancy/data-plane-connection.d.ts.map +1 -0
  439. package/dist/tenancy/data-plane-connection.js +320 -0
  440. package/dist/tenancy/data-plane-connection.js.map +1 -0
  441. package/dist/tenancy/data-plane-migrate.d.ts +30 -0
  442. package/dist/tenancy/data-plane-migrate.d.ts.map +1 -0
  443. package/dist/tenancy/data-plane-migrate.js +44 -0
  444. package/dist/tenancy/data-plane-migrate.js.map +1 -0
  445. package/dist/tenancy/data-plane-provisioning.d.ts +135 -0
  446. package/dist/tenancy/data-plane-provisioning.d.ts.map +1 -0
  447. package/dist/tenancy/data-plane-provisioning.js +639 -0
  448. package/dist/tenancy/data-plane-provisioning.js.map +1 -0
  449. package/dist/tenancy/data-plane-resolver.d.ts +37 -0
  450. package/dist/tenancy/data-plane-resolver.d.ts.map +1 -0
  451. package/dist/tenancy/data-plane-resolver.js +302 -0
  452. package/dist/tenancy/data-plane-resolver.js.map +1 -0
  453. package/dist/tenancy/index.d.ts +9 -0
  454. package/dist/tenancy/index.d.ts.map +1 -0
  455. package/dist/tenancy/index.js +22 -0
  456. package/dist/tenancy/index.js.map +1 -0
  457. package/dist/tenancy/types.d.ts +117 -0
  458. package/dist/tenancy/types.d.ts.map +1 -0
  459. package/dist/tenancy/types.js +8 -0
  460. package/dist/tenancy/types.js.map +1 -0
  461. package/dist/testing/context.d.ts.map +1 -1
  462. package/dist/testing/context.js +6 -1
  463. package/dist/testing/context.js.map +1 -1
  464. package/dist/testing/crash-matrix-simulation.d.ts +51 -0
  465. package/dist/testing/crash-matrix-simulation.d.ts.map +1 -0
  466. package/dist/testing/crash-matrix-simulation.js +350 -0
  467. package/dist/testing/crash-matrix-simulation.js.map +1 -0
  468. package/dist/testing/scaffolding.d.ts.map +1 -1
  469. package/dist/testing/scaffolding.js +4 -1
  470. package/dist/testing/scaffolding.js.map +1 -1
  471. package/dist/types/capability.d.ts +16 -0
  472. package/dist/types/capability.d.ts.map +1 -1
  473. package/dist/types/capability.js.map +1 -1
  474. package/dist/types/context.d.ts +62 -0
  475. package/dist/types/context.d.ts.map +1 -1
  476. package/dist/types/enums.d.ts +2 -0
  477. package/dist/types/enums.d.ts.map +1 -1
  478. package/dist/types/enums.js +2 -0
  479. package/dist/types/enums.js.map +1 -1
  480. package/dist/types/fields.d.ts +7 -0
  481. package/dist/types/fields.d.ts.map +1 -1
  482. package/dist/types/flow.d.ts +96 -1
  483. package/dist/types/flow.d.ts.map +1 -1
  484. package/dist/types/flow.js +7 -1
  485. package/dist/types/flow.js.map +1 -1
  486. package/dist/types/index.d.ts +9 -6
  487. package/dist/types/index.d.ts.map +1 -1
  488. package/dist/types/index.js +5 -1
  489. package/dist/types/index.js.map +1 -1
  490. package/dist/types/prompt.d.ts +8 -0
  491. package/dist/types/prompt.d.ts.map +1 -1
  492. package/dist/types/prompt.js +7 -0
  493. package/dist/types/prompt.js.map +1 -1
  494. package/dist/worker/bootstrap.d.ts +100 -1
  495. package/dist/worker/bootstrap.d.ts.map +1 -1
  496. package/dist/worker/bootstrap.js +155 -14
  497. package/dist/worker/bootstrap.js.map +1 -1
  498. package/instructions/api.md +21 -0
  499. package/instructions/cli.md +15 -9
  500. package/instructions/deployment.md +27 -25
  501. package/instructions/flows.md +8 -1
  502. package/instructions/framework.md +2 -1
  503. package/instructions/mcp.md +1 -1
  504. package/instructions/peer-dependencies.md +16 -14
  505. package/instructions/prompts.md +3 -0
  506. package/instructions/security.md +4 -0
  507. package/instructions/testing.md +2 -2
  508. package/migrations/durable-tenant/0000_durable_tenant.sql +92 -0
  509. package/migrations/durable-tenant/0001_human_task.sql +45 -0
  510. package/migrations/durable-tenant/meta/_journal.json +20 -0
  511. package/migrations/spine/0000_opaque_dispatch.sql +26 -0
  512. package/migrations/spine/meta/_journal.json +13 -0
  513. package/package.json +26 -8
@@ -1,6 +1,6 @@
1
1
  export { createExecutionContext } from './context-factory.js';
2
2
  export type { ContextDependencies } from './context-factory.js';
3
- export { executeCapability } from './capability-executor.js';
3
+ export { executeCapability, authorizeCapability } from './capability-executor.js';
4
4
  export type { CapabilityResult, ExecutionFailure, ExecutionResult, } from './capability-executor.js';
5
5
  export { evaluateAccess } from './authorization.js';
6
6
  export type { AuthorizationResult } from './authorization.js';
@@ -12,5 +12,5 @@ export type { DependencyViolationMetadata, DependencyViolationReason, InternalCa
12
12
  export { wireContextDependencies } from './context-deps.js';
13
13
  export type { WireContextDependenciesOptions } from './context-deps.js';
14
14
  export { CapabilityOutputValidationError, createTransactionRunner, shouldUseTransactionalOutbox, } from './transactional-outbox.js';
15
- export type { TransactionRunnerConfig } from './transactional-outbox.js';
15
+ export type { DurableDispatchRunnerConfig, TransactionRunnerConfig, } from './transactional-outbox.js';
16
16
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,EACpB,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EACL,+BAA+B,EAC/B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAClF,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,EACpB,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EACL,+BAA+B,EAC/B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC"}
@@ -4,7 +4,7 @@
4
4
  //
5
5
  // Key exports: executeCapability, createExecutionContext, evaluateAccess, CapabilityRegistry
6
6
  export { createExecutionContext } from './context-factory.js';
7
- export { executeCapability } from './capability-executor.js';
7
+ export { executeCapability, authorizeCapability } from './capability-executor.js';
8
8
  export { evaluateAccess } from './authorization.js';
9
9
  export { CapabilityRegistry } from './capability-registry.js';
10
10
  export { getCanonicalCapabilityName, isCanonicalCapabilityName, } from './canonical-name.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,mFAAmF;AACnF,yFAAyF;AACzF,EAAE;AACF,6FAA6F;AAE7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAO7D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,EACpB,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EACL,+BAA+B,EAC/B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,mFAAmF;AACnF,yFAAyF;AACzF,EAAE;AACF,6FAA6F;AAE7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAOlF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,EACpB,6BAA6B,EAC7B,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EACL,+BAA+B,EAC/B,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAC"}
@@ -4,6 +4,10 @@ import type { EventRegistry } from '../events/registry.js';
4
4
  import type { AuditService } from '../types/audit.js';
5
5
  import type { CapabilityContract } from '../types/capability.js';
6
6
  import type { ExecutionContext, WithTransactionFn } from '../types/context.js';
7
+ export interface DurableDispatchRunnerConfig {
8
+ /** Schema for Protocol A tables. Default `core_plumbus`. */
9
+ schemaName?: string;
10
+ }
7
11
  export interface TransactionRunnerConfig {
8
12
  db: PostgresJsDatabase;
9
13
  entities: EntityRegistry;
@@ -14,6 +18,12 @@ export interface TransactionRunnerConfig {
14
18
  correlationId?: string;
15
19
  bypassTenantScope?: boolean;
16
20
  encryptionKey?: Buffer;
21
+ /**
22
+ * When set, the transaction scope can write `dispatch_outbox` (and
23
+ * persist-before-ack acceptance) in the same tenant transaction. Omitted,
24
+ * the runner is unchanged: handler + `event_outbox` only.
25
+ */
26
+ durableDispatch?: DurableDispatchRunnerConfig;
17
27
  }
18
28
  /**
19
29
  * Build a `withTransaction` hook that runs work inside `db.transaction`,
@@ -1 +1 @@
1
- {"version":3,"file":"transactional-outbox.d.ts","sourceRoot":"","sources":["../../src/execution/transactional-outbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAoB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGjG,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,kBAAkB,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,OAAO,sBAAsB,EAAE,WAAW,CAAC;IAC1D,QAAQ,EAAE,MAAM,YAAY,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAoD1F;AAOD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAmBT;AAED,0EAA0E;AAC1E,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,OAAO;CAK5B"}
1
+ {"version":3,"file":"transactional-outbox.d.ts","sourceRoot":"","sources":["../../src/execution/transactional-outbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAoB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGjG,MAAM,WAAW,2BAA2B;IAC1C,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,kBAAkB,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,OAAO,sBAAsB,EAAE,WAAW,CAAC;IAC1D,QAAQ,EAAE,MAAM,YAAY,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,2BAA2B,CAAC;CAC/C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAsG1F;AAOD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAmBT;AAED,0EAA0E;AAC1E,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,OAAO;CAK5B"}
@@ -5,7 +5,7 @@ import { CapabilityKind } from '../types/enums.js';
5
5
  * providing tx-scoped data + events while audit stays on the outer db.
6
6
  */
7
7
  export function createTransactionRunner(config) {
8
- const { db, entities, events: eventRegistry, getAuth, getAudit, getCausationId, correlationId, bypassTenantScope, encryptionKey, } = config;
8
+ const { db, entities, events: eventRegistry, getAuth, getAudit, getCausationId, correlationId, bypassTenantScope, encryptionKey, durableDispatch, } = config;
9
9
  function createScope(tx) {
10
10
  const auth = getAuth();
11
11
  const audit = getAudit();
@@ -24,7 +24,46 @@ export function createTransactionRunner(config) {
24
24
  correlationId,
25
25
  getCausationId,
26
26
  });
27
- return { data, events };
27
+ const scope = { data, events };
28
+ if (durableDispatch) {
29
+ const schemaName = durableDispatch.schemaName;
30
+ scope.persistAcceptance = async (input) => {
31
+ const { persistAcceptanceOnDb } = await import('../durable/postgres-persist.js');
32
+ const result = await persistAcceptanceOnDb(tx, {
33
+ executionId: input.executionId,
34
+ tenantRef: input.tenantRef,
35
+ definitionId: input.definitionId,
36
+ definitionVersion: input.definitionVersion,
37
+ firstStepId: input.firstStepId,
38
+ correlationId: input.correlationId,
39
+ nowIso: input.nowIso ?? new Date().toISOString(),
40
+ }, schemaName);
41
+ return { executionId: result.execution.executionId, outboxId: result.outbox.outboxId };
42
+ };
43
+ scope.enqueueDispatch = async (input) => {
44
+ const { insertDispatchOutbox } = await import('../durable/postgres-persist.js');
45
+ const nowIso = input.nowIso ?? new Date().toISOString();
46
+ const outbox = await insertDispatchOutbox(tx, {
47
+ executionId: input.executionId,
48
+ stateRefId: input.stateRefId,
49
+ tenantRef: input.tenantRef,
50
+ revision: input.revision,
51
+ tenantEpoch: input.tenantEpoch,
52
+ status: 'running',
53
+ definitionId: input.definitionId,
54
+ definitionVersion: input.definitionVersion,
55
+ currentStepId: input.stepId,
56
+ stepIndex: 0,
57
+ attempt: 0,
58
+ correlationId: input.correlationId,
59
+ createdAt: nowIso,
60
+ updatedAt: nowIso,
61
+ terminal: false,
62
+ }, input.stepId, nowIso, schemaName);
63
+ return { outboxId: outbox.outboxId };
64
+ };
65
+ }
66
+ return scope;
28
67
  }
29
68
  return async (fn) => {
30
69
  const deferred = [];
@@ -1 +1 @@
1
- {"version":3,"file":"transactional-outbox.js","sourceRoot":"","sources":["../../src/execution/transactional-outbox.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transactional-outbox.js","sourceRoot":"","sources":["../../src/execution/transactional-outbox.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import { BudgetExhaustedError } from '../errors/index.js';
2
+ export declare const BUDGET_STATE_KEY = "__budget";
3
+ export declare const BUDGET_EXHAUSTED = "budget-exhausted";
4
+ export { BudgetExhaustedError };
5
+ /** Per-execution ledger (recovery.schema BudgetLedger v1 subset). */
6
+ export interface ExecutionBudgetAmount {
7
+ dimensionId: string;
8
+ unitId: string;
9
+ allocated: number;
10
+ consumed: number;
11
+ reserved: number;
12
+ }
13
+ export interface ExecutionBudgetLedger {
14
+ contractVersion: '0.1.0';
15
+ budgetLedgerId: string;
16
+ executionId: string;
17
+ budgetProfileId: string;
18
+ state: 'active' | 'exhausted' | 'closed';
19
+ amounts: ExecutionBudgetAmount[];
20
+ revision: number;
21
+ createdAt: string;
22
+ updatedAt: string;
23
+ }
24
+ export type { FlowBudget } from '../types/flow.js';
25
+ export declare function createExecutionBudgetLedger(input: {
26
+ executionId: string;
27
+ profileId: string;
28
+ allocated: number;
29
+ unitId?: string;
30
+ dimensionId?: string;
31
+ now?: Date;
32
+ }): ExecutionBudgetLedger;
33
+ export declare function readExecutionBudget(state: unknown): ExecutionBudgetLedger | undefined;
34
+ export declare function writeExecutionBudget(state: unknown, ledger: ExecutionBudgetLedger): Record<string, unknown>;
35
+ export declare function chargeExecutionBudget(ledger: ExecutionBudgetLedger, amount: number, now?: Date): ExecutionBudgetLedger;
36
+ /**
37
+ * Charge one unit from `state.__budget` when a ledger is present.
38
+ * Returns null when the flow has no budget (no-op).
39
+ */
40
+ export declare function consumeExecutionBudget(state: unknown, amount?: number): {
41
+ state: Record<string, unknown>;
42
+ exhausted: boolean;
43
+ } | null;
44
+ //# sourceMappingURL=budget.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/flows/budget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,qBAAqB,CAqBxB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAOrF;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,EACd,GAAG,OAAa,GACf,qBAAqB,CAoBvB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,MAAM,SAAI,GACT;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAQ/D"}
@@ -0,0 +1,81 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { BudgetExhaustedError } from '../errors/index.js';
3
+ export const BUDGET_STATE_KEY = '__budget';
4
+ export const BUDGET_EXHAUSTED = 'budget-exhausted';
5
+ export { BudgetExhaustedError };
6
+ export function createExecutionBudgetLedger(input) {
7
+ const now = (input.now ?? new Date()).toISOString();
8
+ return {
9
+ contractVersion: '0.1.0',
10
+ budgetLedgerId: randomUUID(),
11
+ executionId: input.executionId,
12
+ budgetProfileId: input.profileId,
13
+ state: input.allocated <= 0 ? 'exhausted' : 'active',
14
+ amounts: [
15
+ {
16
+ dimensionId: input.dimensionId ?? 'plumbus.execution.step',
17
+ unitId: input.unitId ?? 'plumbus.unit.step',
18
+ allocated: input.allocated,
19
+ consumed: 0,
20
+ reserved: 0,
21
+ },
22
+ ],
23
+ revision: 1,
24
+ createdAt: now,
25
+ updatedAt: now,
26
+ };
27
+ }
28
+ export function readExecutionBudget(state) {
29
+ if (!state || typeof state !== 'object' || Array.isArray(state))
30
+ return undefined;
31
+ const ledger = state[BUDGET_STATE_KEY];
32
+ if (!ledger || typeof ledger !== 'object' || Array.isArray(ledger))
33
+ return undefined;
34
+ const typed = ledger;
35
+ if (typed.contractVersion !== '0.1.0' || !Array.isArray(typed.amounts))
36
+ return undefined;
37
+ return typed;
38
+ }
39
+ export function writeExecutionBudget(state, ledger) {
40
+ const base = state && typeof state === 'object' && !Array.isArray(state)
41
+ ? { ...state }
42
+ : {};
43
+ base[BUDGET_STATE_KEY] = ledger;
44
+ return base;
45
+ }
46
+ export function chargeExecutionBudget(ledger, amount, now = new Date()) {
47
+ const primary = ledger.amounts[0];
48
+ if (!primary) {
49
+ return {
50
+ ...ledger,
51
+ state: 'exhausted',
52
+ revision: ledger.revision + 1,
53
+ updatedAt: now.toISOString(),
54
+ };
55
+ }
56
+ const nextConsumed = primary.consumed + amount;
57
+ const next = { ...primary, consumed: nextConsumed };
58
+ const exhausted = nextConsumed > primary.allocated;
59
+ return {
60
+ ...ledger,
61
+ amounts: [next, ...ledger.amounts.slice(1)],
62
+ state: exhausted ? 'exhausted' : ledger.state,
63
+ revision: ledger.revision + 1,
64
+ updatedAt: now.toISOString(),
65
+ };
66
+ }
67
+ /**
68
+ * Charge one unit from `state.__budget` when a ledger is present.
69
+ * Returns null when the flow has no budget (no-op).
70
+ */
71
+ export function consumeExecutionBudget(state, amount = 1) {
72
+ const ledger = readExecutionBudget(state);
73
+ if (!ledger)
74
+ return null;
75
+ if (ledger.state === 'exhausted' || ledger.state === 'closed') {
76
+ return { state: writeExecutionBudget(state, ledger), exhausted: true };
77
+ }
78
+ const next = chargeExecutionBudget(ledger, amount);
79
+ return { state: writeExecutionBudget(state, next), exhausted: next.state === 'exhausted' };
80
+ }
81
+ //# sourceMappingURL=budget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/flows/budget.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import type { CompiledFlowDefinition, FlowDefinition } from '../types/flow.js';
2
+ export declare const COMPILED_FLOW_CONTRACT_VERSION: "0.1.0";
3
+ /** SHA-256 of canonical JSON (key-sorted). Used for definition and binding digests. */
4
+ export declare function digestCanonicalJson(value: unknown): string;
5
+ /** Stable identity: `{domain}.{name}`. */
6
+ export declare function flowDefinitionId(flow: {
7
+ domain: string;
8
+ name: string;
9
+ }): string;
10
+ export interface CompileFlowOptions {
11
+ definitionVersion?: string;
12
+ }
13
+ /**
14
+ * Compile a live `defineFlow` object into a signed artifact.
15
+ * Recompiling an identical flow yields the same `definitionDigest`.
16
+ */
17
+ export declare function compileFlowDefinition(flow: FlowDefinition, options?: CompileFlowOptions): CompiledFlowDefinition;
18
+ /**
19
+ * Reconstruct live `FlowStep[]` from a compiled artifact, keeping Zod
20
+ * schemas and metadata from the authoring `FlowDefinition`.
21
+ */
22
+ export declare function hydrateCompiledFlow(compiled: CompiledFlowDefinition, authoring: FlowDefinition): FlowDefinition;
23
+ //# sourceMappingURL=compile-flow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compile-flow.d.ts","sourceRoot":"","sources":["../../src/flows/compile-flow.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,sBAAsB,EAEtB,cAAc,EAEf,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,8BAA8B,EAAG,OAAgB,CAAC;AAiB/D,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG1D;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/E;AAuED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,sBAAsB,CAwBxB;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE,cAAc,GACxB,cAAc,CAsDhB"}
@@ -0,0 +1,176 @@
1
+ // Compile defineFlow authoring objects into a signed FlowDefinition JSON
2
+ // artifact. Inline condition expressions and step IO mappings are hoisted
3
+ // into individually digested bindings.
4
+ // The existing flow engine hydrates these back to FlowStep[] — this is
5
+ // not a second workflow engine.
6
+ import { createHash } from 'node:crypto';
7
+ import { FlowStepType } from '../types/enums.js';
8
+ export const COMPILED_FLOW_CONTRACT_VERSION = '0.1.0';
9
+ function sortKeys(value) {
10
+ if (Array.isArray(value)) {
11
+ return value.map(sortKeys);
12
+ }
13
+ if (value !== null && typeof value === 'object') {
14
+ const record = value;
15
+ const sorted = {};
16
+ for (const key of Object.keys(record).sort()) {
17
+ sorted[key] = sortKeys(record[key]);
18
+ }
19
+ return sorted;
20
+ }
21
+ return value;
22
+ }
23
+ /** SHA-256 of canonical JSON (key-sorted). Used for definition and binding digests. */
24
+ export function digestCanonicalJson(value) {
25
+ const json = JSON.stringify(sortKeys(value));
26
+ return createHash('sha256').update(json).digest('hex');
27
+ }
28
+ /** Stable identity: `{domain}.{name}`. */
29
+ export function flowDefinitionId(flow) {
30
+ return `${flow.domain}.${flow.name}`;
31
+ }
32
+ function bindingId(id, kind, stepName) {
33
+ return `${id}:${kind}:${stepName}`;
34
+ }
35
+ function hoistBinding(bindings, id, kind, stepName, source) {
36
+ const compiled = {
37
+ bindingId: bindingId(id, kind, stepName),
38
+ kind,
39
+ source,
40
+ digest: digestCanonicalJson(source),
41
+ };
42
+ bindings.push(compiled);
43
+ return compiled.bindingId;
44
+ }
45
+ function compileStep(step, id, bindings) {
46
+ const compiled = { name: step.name, type: step.type };
47
+ if (step.type === FlowStepType.Capability) {
48
+ if (step.capability)
49
+ compiled.capability = step.capability;
50
+ if (step.compensate)
51
+ compiled.compensate = step.compensate;
52
+ if (step.input) {
53
+ compiled.inputBindingId = hoistBinding(bindings, id, 'input-mapping', step.name, JSON.stringify(sortKeys(step.input)));
54
+ }
55
+ return compiled;
56
+ }
57
+ if (step.type === FlowStepType.Conditional) {
58
+ compiled.conditionBindingId = hoistBinding(bindings, id, 'condition', step.name, step.if);
59
+ compiled.then = step.then;
60
+ if (step.else)
61
+ compiled.else = step.else;
62
+ return compiled;
63
+ }
64
+ if (step.type === FlowStepType.Wait || step.type === FlowStepType.EventEmit) {
65
+ compiled.event = step.event;
66
+ return compiled;
67
+ }
68
+ if (step.type === FlowStepType.Delay) {
69
+ compiled.duration = step.duration;
70
+ return compiled;
71
+ }
72
+ if (step.type === FlowStepType.Parallel) {
73
+ compiled.branches = [...step.branches];
74
+ return compiled;
75
+ }
76
+ if (step.type === FlowStepType.ApprovalOutcome) {
77
+ compiled.outcomes = { ...step.outcomes };
78
+ return compiled;
79
+ }
80
+ return compiled;
81
+ }
82
+ /**
83
+ * Compile a live `defineFlow` object into a signed artifact.
84
+ * Recompiling an identical flow yields the same `definitionDigest`.
85
+ */
86
+ export function compileFlowDefinition(flow, options) {
87
+ const id = flowDefinitionId(flow);
88
+ const definitionVersion = options?.definitionVersion ?? flow.version ?? '1';
89
+ const bindings = [];
90
+ const steps = flow.steps.map((step) => compileStep(step, id, bindings));
91
+ const unsigned = {
92
+ contractVersion: COMPILED_FLOW_CONTRACT_VERSION,
93
+ flowDefinitionId: id,
94
+ definitionVersion,
95
+ domain: flow.domain,
96
+ name: flow.name,
97
+ steps,
98
+ bindings,
99
+ };
100
+ if (flow.description)
101
+ unsigned.description = flow.description;
102
+ if (flow.trigger)
103
+ unsigned.trigger = flow.trigger;
104
+ if (flow.schedule)
105
+ unsigned.schedule = flow.schedule;
106
+ if (flow.retry)
107
+ unsigned.retry = flow.retry;
108
+ return {
109
+ ...unsigned,
110
+ definitionDigest: digestCanonicalJson(unsigned),
111
+ };
112
+ }
113
+ function bindingSource(compiled, bindingId) {
114
+ if (!bindingId)
115
+ return undefined;
116
+ return compiled.bindings.find((b) => b.bindingId === bindingId)?.source;
117
+ }
118
+ /**
119
+ * Reconstruct live `FlowStep[]` from a compiled artifact, keeping Zod
120
+ * schemas and metadata from the authoring `FlowDefinition`.
121
+ */
122
+ export function hydrateCompiledFlow(compiled, authoring) {
123
+ const steps = compiled.steps.map((step) => {
124
+ if (step.type === FlowStepType.Capability) {
125
+ const source = bindingSource(compiled, step.inputBindingId);
126
+ return {
127
+ name: step.name,
128
+ type: FlowStepType.Capability,
129
+ ...(step.capability ? { capability: step.capability } : {}),
130
+ ...(step.compensate ? { compensate: step.compensate } : {}),
131
+ ...(source ? { input: JSON.parse(source) } : {}),
132
+ };
133
+ }
134
+ if (step.type === FlowStepType.Conditional) {
135
+ return {
136
+ name: step.name,
137
+ type: FlowStepType.Conditional,
138
+ if: bindingSource(compiled, step.conditionBindingId) ?? '',
139
+ then: step.then ?? '',
140
+ ...(step.else ? { else: step.else } : {}),
141
+ };
142
+ }
143
+ if (step.type === FlowStepType.Wait) {
144
+ return { name: step.name, type: FlowStepType.Wait, event: step.event ?? '' };
145
+ }
146
+ if (step.type === FlowStepType.EventEmit) {
147
+ return { name: step.name, type: FlowStepType.EventEmit, event: step.event ?? '' };
148
+ }
149
+ if (step.type === FlowStepType.Delay) {
150
+ return { name: step.name, type: FlowStepType.Delay, duration: step.duration ?? '0s' };
151
+ }
152
+ if (step.type === FlowStepType.Parallel) {
153
+ return { name: step.name, type: FlowStepType.Parallel, branches: step.branches ?? [] };
154
+ }
155
+ if (step.type === FlowStepType.ApprovalOutcome) {
156
+ return {
157
+ name: step.name,
158
+ type: FlowStepType.ApprovalOutcome,
159
+ outcomes: step.outcomes ?? {},
160
+ };
161
+ }
162
+ return { name: step.name, type: FlowStepType.Capability };
163
+ });
164
+ return {
165
+ ...authoring,
166
+ name: compiled.name,
167
+ domain: compiled.domain,
168
+ description: compiled.description ?? authoring.description,
169
+ steps,
170
+ trigger: compiled.trigger ?? authoring.trigger,
171
+ schedule: compiled.schedule ?? authoring.schedule,
172
+ retry: compiled.retry ?? authoring.retry,
173
+ version: compiled.definitionVersion,
174
+ };
175
+ }
176
+ //# sourceMappingURL=compile-flow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compile-flow.js","sourceRoot":"","sources":["../../src/flows/compile-flow.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ import type { CompiledFlowDefinition } from '../types/flow.js';
2
+ /** Project-relative default used by `plumbus compile-flows` and boot load. */
3
+ export declare const DEFAULT_COMPILED_FLOWS_DIRECTORY = ".plumbus/compiled-flows";
4
+ export declare class CompiledFlowRegistry {
5
+ private readonly versions;
6
+ private readonly publishOrder;
7
+ /**
8
+ * Publish a compiled definition. Same version + same digest is a no-op.
9
+ * Same version + different digest is rejected (immutable retain-all).
10
+ */
11
+ publish(compiled: CompiledFlowDefinition): void;
12
+ get(flowDefinitionId: string, definitionVersion: string): CompiledFlowDefinition | undefined;
13
+ /** Most recently published version for this id (not semver-max). */
14
+ getLatest(flowDefinitionId: string): CompiledFlowDefinition | undefined;
15
+ listVersions(flowDefinitionId: string): string[];
16
+ }
17
+ /**
18
+ * Parse one signed artifact. Recomputes `definitionDigest` and refuses a
19
+ * mismatch so a tampered file cannot enter the registry.
20
+ */
21
+ export declare function parseCompiledFlowArtifact(value: unknown, fileName?: string): CompiledFlowDefinition;
22
+ /**
23
+ * Load signed JSON from a host-owned directory (the `plumbus compile-flows`
24
+ * output). Each file is digest-checked; a mismatch refuses the whole load.
25
+ */
26
+ export declare function loadCompiledFlowRegistryFromDirectory(directory: string): CompiledFlowRegistry;
27
+ /**
28
+ * Same as `loadCompiledFlowRegistryFromDirectory`, but a missing or empty
29
+ * directory is "not configured" (`undefined`) so live TypeScript flows stay
30
+ * on. A directory that exists with invalid JSON still throws.
31
+ */
32
+ export declare function tryLoadCompiledFlowRegistryFromDirectory(directory: string): CompiledFlowRegistry | undefined;
33
+ export interface ResolveCompiledFlowRegistryOptions {
34
+ compiledRegistry?: CompiledFlowRegistry;
35
+ compiledFlowsDirectory?: string;
36
+ cwd?: string;
37
+ }
38
+ /**
39
+ * Prefer an explicit registry. Else load `compiledFlowsDirectory` (required
40
+ * when set). Else try `{cwd}/.plumbus/compiled-flows` when that tree has JSON.
41
+ */
42
+ export declare function resolveCompiledFlowRegistry(options?: ResolveCompiledFlowRegistryOptions): CompiledFlowRegistry | undefined;
43
+ //# sourceMappingURL=compiled-registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiled-registry.d.ts","sourceRoot":"","sources":["../../src/flows/compiled-registry.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAE1E,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0D;IACnF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAE5D;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IA4B/C,GAAG,CAAC,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI5F,oEAAoE;IACpE,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAKvE,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE;CAGjD;AAwBD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,QAAQ,SAAuB,GAC9B,sBAAsB,CA6CxB;AA6BD;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAc7F;AAED;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,MAAM,GAChB,oBAAoB,GAAG,SAAS,CAkBlC;AAED,MAAM,WAAW,kCAAkC;IACjD,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,kCAAuC,GAC/C,oBAAoB,GAAG,SAAS,CAiBlC"}