@plumbus/core 0.4.2 → 0.5.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 (280) hide show
  1. package/README.md +1 -1
  2. package/dist/.tsbuildinfo +1 -1
  3. package/dist/api/route-generator.d.ts.map +1 -1
  4. package/dist/api/route-generator.js +27 -14
  5. package/dist/api/route-generator.js.map +1 -1
  6. package/dist/cli/cli.d.ts.map +1 -1
  7. package/dist/cli/cli.js +2 -1
  8. package/dist/cli/cli.js.map +1 -1
  9. package/dist/cli/commands/dev.d.ts.map +1 -1
  10. package/dist/cli/commands/dev.js +38 -149
  11. package/dist/cli/commands/dev.js.map +1 -1
  12. package/dist/cli/commands/doctor.d.ts +6 -0
  13. package/dist/cli/commands/doctor.d.ts.map +1 -1
  14. package/dist/cli/commands/doctor.js +92 -4
  15. package/dist/cli/commands/doctor.js.map +1 -1
  16. package/dist/cli/commands/event.d.ts.map +1 -1
  17. package/dist/cli/commands/event.js +3 -0
  18. package/dist/cli/commands/event.js.map +1 -1
  19. package/dist/cli/commands/events-ops.d.ts +4 -0
  20. package/dist/cli/commands/events-ops.d.ts.map +1 -0
  21. package/dist/cli/commands/events-ops.js +203 -0
  22. package/dist/cli/commands/events-ops.js.map +1 -0
  23. package/dist/cli/commands/flow.d.ts.map +1 -1
  24. package/dist/cli/commands/flow.js +49 -1
  25. package/dist/cli/commands/flow.js.map +1 -1
  26. package/dist/cli/commands/generate.d.ts +4 -0
  27. package/dist/cli/commands/generate.d.ts.map +1 -1
  28. package/dist/cli/commands/generate.js +94 -3
  29. package/dist/cli/commands/generate.js.map +1 -1
  30. package/dist/cli/commands/index.d.ts +1 -0
  31. package/dist/cli/commands/index.d.ts.map +1 -1
  32. package/dist/cli/commands/index.js +1 -0
  33. package/dist/cli/commands/index.js.map +1 -1
  34. package/dist/cli/commands/init.d.ts +1 -1
  35. package/dist/cli/commands/init.d.ts.map +1 -1
  36. package/dist/cli/commands/init.js +13 -3
  37. package/dist/cli/commands/init.js.map +1 -1
  38. package/dist/cli/commands/mcp.d.ts.map +1 -1
  39. package/dist/cli/commands/mcp.js +2 -0
  40. package/dist/cli/commands/mcp.js.map +1 -1
  41. package/dist/cli/commands/start.d.ts +3 -6
  42. package/dist/cli/commands/start.d.ts.map +1 -1
  43. package/dist/cli/commands/start.js +71 -180
  44. package/dist/cli/commands/start.js.map +1 -1
  45. package/dist/cli/commands/verify.d.ts +3 -1
  46. package/dist/cli/commands/verify.d.ts.map +1 -1
  47. package/dist/cli/commands/verify.js +17 -9
  48. package/dist/cli/commands/verify.js.map +1 -1
  49. package/dist/cli/commands/worker.d.ts +19 -0
  50. package/dist/cli/commands/worker.d.ts.map +1 -0
  51. package/dist/cli/commands/worker.js +234 -0
  52. package/dist/cli/commands/worker.js.map +1 -0
  53. package/dist/cli/mcp-serve-context.d.ts +3 -0
  54. package/dist/cli/mcp-serve-context.d.ts.map +1 -1
  55. package/dist/cli/mcp-serve-context.js +16 -1
  56. package/dist/cli/mcp-serve-context.js.map +1 -1
  57. package/dist/cli/templates/resources.d.ts.map +1 -1
  58. package/dist/cli/templates/resources.js +7 -2
  59. package/dist/cli/templates/resources.js.map +1 -1
  60. package/dist/cli/utils.d.ts +4 -0
  61. package/dist/cli/utils.d.ts.map +1 -1
  62. package/dist/cli/utils.js +9 -0
  63. package/dist/cli/utils.js.map +1 -1
  64. package/dist/data/drift-inspector.d.ts +2 -2
  65. package/dist/data/drift-inspector.d.ts.map +1 -1
  66. package/dist/data/drift-inspector.js +2 -1
  67. package/dist/data/drift-inspector.js.map +1 -1
  68. package/dist/data/migration.d.ts.map +1 -1
  69. package/dist/data/migration.js +2 -0
  70. package/dist/data/migration.js.map +1 -1
  71. package/dist/define/defineCapability.d.ts +5 -0
  72. package/dist/define/defineCapability.d.ts.map +1 -1
  73. package/dist/define/defineCapability.js +23 -0
  74. package/dist/define/defineCapability.js.map +1 -1
  75. package/dist/errors/http.d.ts.map +1 -1
  76. package/dist/errors/http.js +1 -0
  77. package/dist/errors/http.js.map +1 -1
  78. package/dist/errors/index.d.ts.map +1 -1
  79. package/dist/errors/index.js +1 -0
  80. package/dist/errors/index.js.map +1 -1
  81. package/dist/events/dispatcher.d.ts +4 -0
  82. package/dist/events/dispatcher.d.ts.map +1 -1
  83. package/dist/events/dispatcher.js +24 -1
  84. package/dist/events/dispatcher.js.map +1 -1
  85. package/dist/events/emitter.d.ts +2 -0
  86. package/dist/events/emitter.d.ts.map +1 -1
  87. package/dist/events/emitter.js +6 -3
  88. package/dist/events/emitter.js.map +1 -1
  89. package/dist/events/queue-adapter.d.ts +7 -0
  90. package/dist/events/queue-adapter.d.ts.map +1 -0
  91. package/dist/events/queue-adapter.js +4 -0
  92. package/dist/events/queue-adapter.js.map +1 -0
  93. package/dist/events/queue.d.ts +16 -13
  94. package/dist/events/queue.d.ts.map +1 -1
  95. package/dist/events/queue.js +79 -22
  96. package/dist/events/queue.js.map +1 -1
  97. package/dist/events/worker.d.ts +4 -0
  98. package/dist/events/worker.d.ts.map +1 -1
  99. package/dist/events/worker.js +47 -1
  100. package/dist/events/worker.js.map +1 -1
  101. package/dist/execution/canonical-name.d.ts +13 -0
  102. package/dist/execution/canonical-name.d.ts.map +1 -0
  103. package/dist/execution/canonical-name.js +17 -0
  104. package/dist/execution/canonical-name.js.map +1 -0
  105. package/dist/execution/capability-executor.d.ts +1 -1
  106. package/dist/execution/capability-executor.d.ts.map +1 -1
  107. package/dist/execution/capability-executor.js +52 -24
  108. package/dist/execution/capability-executor.js.map +1 -1
  109. package/dist/execution/capability-invocation.d.ts +34 -0
  110. package/dist/execution/capability-invocation.d.ts.map +1 -0
  111. package/dist/execution/capability-invocation.js +138 -0
  112. package/dist/execution/capability-invocation.js.map +1 -0
  113. package/dist/execution/capability-registry.d.ts +6 -4
  114. package/dist/execution/capability-registry.d.ts.map +1 -1
  115. package/dist/execution/capability-registry.js +13 -7
  116. package/dist/execution/capability-registry.js.map +1 -1
  117. package/dist/execution/context-factory.d.ts.map +1 -1
  118. package/dist/execution/context-factory.js +12 -1
  119. package/dist/execution/context-factory.js.map +1 -1
  120. package/dist/execution/index.d.ts +4 -0
  121. package/dist/execution/index.d.ts.map +1 -1
  122. package/dist/execution/index.js +2 -0
  123. package/dist/execution/index.js.map +1 -1
  124. package/dist/execution/invocation-emit-scope.d.ts +11 -0
  125. package/dist/execution/invocation-emit-scope.d.ts.map +1 -0
  126. package/dist/execution/invocation-emit-scope.js +8 -0
  127. package/dist/execution/invocation-emit-scope.js.map +1 -0
  128. package/dist/flows/engine.d.ts +7 -1
  129. package/dist/flows/engine.d.ts.map +1 -1
  130. package/dist/flows/engine.js +73 -10
  131. package/dist/flows/engine.js.map +1 -1
  132. package/dist/flows/flow-delayed.d.ts +34 -0
  133. package/dist/flows/flow-delayed.d.ts.map +1 -0
  134. package/dist/flows/flow-delayed.js +60 -0
  135. package/dist/flows/flow-delayed.js.map +1 -0
  136. package/dist/flows/flow-queue.d.ts +10 -0
  137. package/dist/flows/flow-queue.d.ts.map +1 -0
  138. package/dist/flows/flow-queue.js +25 -0
  139. package/dist/flows/flow-queue.js.map +1 -0
  140. package/dist/flows/scheduler.d.ts +0 -12
  141. package/dist/flows/scheduler.d.ts.map +1 -1
  142. package/dist/flows/scheduler.js +15 -0
  143. package/dist/flows/scheduler.js.map +1 -1
  144. package/dist/flows/schema.d.ts +17 -0
  145. package/dist/flows/schema.d.ts.map +1 -1
  146. package/dist/flows/schema.js +2 -0
  147. package/dist/flows/schema.js.map +1 -1
  148. package/dist/flows/step-consumer.d.ts +24 -0
  149. package/dist/flows/step-consumer.d.ts.map +1 -0
  150. package/dist/flows/step-consumer.js +72 -0
  151. package/dist/flows/step-consumer.js.map +1 -0
  152. package/dist/flows/triggers.d.ts +1 -1
  153. package/dist/flows/triggers.d.ts.map +1 -1
  154. package/dist/flows/triggers.js +5 -7
  155. package/dist/flows/triggers.js.map +1 -1
  156. package/dist/governance/capability-source-scan.d.ts +7 -0
  157. package/dist/governance/capability-source-scan.d.ts.map +1 -0
  158. package/dist/governance/capability-source-scan.js +80 -0
  159. package/dist/governance/capability-source-scan.js.map +1 -0
  160. package/dist/governance/rules/architecture.d.ts.map +1 -1
  161. package/dist/governance/rules/architecture.js +2 -0
  162. package/dist/governance/rules/architecture.js.map +1 -1
  163. package/dist/governance/rules/capability-dependencies.d.ts +8 -0
  164. package/dist/governance/rules/capability-dependencies.d.ts.map +1 -0
  165. package/dist/governance/rules/capability-dependencies.js +195 -0
  166. package/dist/governance/rules/capability-dependencies.js.map +1 -0
  167. package/dist/governance/rules/index.d.ts +2 -0
  168. package/dist/governance/rules/index.d.ts.map +1 -1
  169. package/dist/governance/rules/index.js +2 -0
  170. package/dist/governance/rules/index.js.map +1 -1
  171. package/dist/governance/rules/worker.d.ts +9 -0
  172. package/dist/governance/rules/worker.d.ts.map +1 -0
  173. package/dist/governance/rules/worker.js +89 -0
  174. package/dist/governance/rules/worker.js.map +1 -0
  175. package/dist/index.d.ts +6 -1
  176. package/dist/index.d.ts.map +1 -1
  177. package/dist/index.js +3 -1
  178. package/dist/index.js.map +1 -1
  179. package/dist/jobs/dispatch.d.ts +18 -0
  180. package/dist/jobs/dispatch.d.ts.map +1 -0
  181. package/dist/jobs/dispatch.js +50 -0
  182. package/dist/jobs/dispatch.js.map +1 -0
  183. package/dist/jobs/index.d.ts +9 -0
  184. package/dist/jobs/index.d.ts.map +1 -0
  185. package/dist/jobs/index.js +8 -0
  186. package/dist/jobs/index.js.map +1 -0
  187. package/dist/jobs/routes.d.ts +10 -0
  188. package/dist/jobs/routes.d.ts.map +1 -0
  189. package/dist/jobs/routes.js +44 -0
  190. package/dist/jobs/routes.js.map +1 -0
  191. package/dist/jobs/schema.d.ts +264 -0
  192. package/dist/jobs/schema.d.ts.map +1 -0
  193. package/dist/jobs/schema.js +34 -0
  194. package/dist/jobs/schema.js.map +1 -0
  195. package/dist/jobs/service.d.ts +52 -0
  196. package/dist/jobs/service.d.ts.map +1 -0
  197. package/dist/jobs/service.js +168 -0
  198. package/dist/jobs/service.js.map +1 -0
  199. package/dist/jobs/types.d.ts +30 -0
  200. package/dist/jobs/types.d.ts.map +1 -0
  201. package/dist/jobs/types.js +4 -0
  202. package/dist/jobs/types.js.map +1 -0
  203. package/dist/mcp/manifest-generator.d.ts.map +1 -1
  204. package/dist/mcp/manifest-generator.js +3 -2
  205. package/dist/mcp/manifest-generator.js.map +1 -1
  206. package/dist/observability/metrics.d.ts +9 -1
  207. package/dist/observability/metrics.d.ts.map +1 -1
  208. package/dist/observability/metrics.js +28 -1
  209. package/dist/observability/metrics.js.map +1 -1
  210. package/dist/runtime/bootstrap.d.ts +51 -0
  211. package/dist/runtime/bootstrap.d.ts.map +1 -0
  212. package/dist/runtime/bootstrap.js +140 -0
  213. package/dist/runtime/bootstrap.js.map +1 -0
  214. package/dist/runtime/index.d.ts +7 -0
  215. package/dist/runtime/index.d.ts.map +1 -0
  216. package/dist/runtime/index.js +6 -0
  217. package/dist/runtime/index.js.map +1 -0
  218. package/dist/runtime/load-extensions.d.ts +4 -0
  219. package/dist/runtime/load-extensions.d.ts.map +1 -0
  220. package/dist/runtime/load-extensions.js +41 -0
  221. package/dist/runtime/load-extensions.js.map +1 -0
  222. package/dist/runtime/queue-factory.d.ts +44 -0
  223. package/dist/runtime/queue-factory.d.ts.map +1 -0
  224. package/dist/runtime/queue-factory.js +156 -0
  225. package/dist/runtime/queue-factory.js.map +1 -0
  226. package/dist/runtime/register-consumers.d.ts +29 -0
  227. package/dist/runtime/register-consumers.d.ts.map +1 -0
  228. package/dist/runtime/register-consumers.js +233 -0
  229. package/dist/runtime/register-consumers.js.map +1 -0
  230. package/dist/runtime/start-worker-pool.d.ts +32 -0
  231. package/dist/runtime/start-worker-pool.d.ts.map +1 -0
  232. package/dist/runtime/start-worker-pool.js +91 -0
  233. package/dist/runtime/start-worker-pool.js.map +1 -0
  234. package/dist/runtime/worker-health.d.ts +19 -0
  235. package/dist/runtime/worker-health.d.ts.map +1 -0
  236. package/dist/runtime/worker-health.js +41 -0
  237. package/dist/runtime/worker-health.js.map +1 -0
  238. package/dist/server/bootstrap.d.ts +6 -0
  239. package/dist/server/bootstrap.d.ts.map +1 -1
  240. package/dist/server/bootstrap.js +18 -1
  241. package/dist/server/bootstrap.js.map +1 -1
  242. package/dist/testing/context.d.ts +3 -0
  243. package/dist/testing/context.d.ts.map +1 -1
  244. package/dist/testing/context.js +10 -0
  245. package/dist/testing/context.js.map +1 -1
  246. package/dist/testing/simulate-flow.d.ts.map +1 -1
  247. package/dist/testing/simulate-flow.js +10 -0
  248. package/dist/testing/simulate-flow.js.map +1 -1
  249. package/dist/types/capability.d.ts +8 -0
  250. package/dist/types/capability.d.ts.map +1 -1
  251. package/dist/types/capability.js.map +1 -1
  252. package/dist/types/config.d.ts +2 -0
  253. package/dist/types/config.d.ts.map +1 -1
  254. package/dist/types/context.d.ts +34 -1
  255. package/dist/types/context.d.ts.map +1 -1
  256. package/dist/types/enums.d.ts +1 -0
  257. package/dist/types/enums.d.ts.map +1 -1
  258. package/dist/types/enums.js +1 -0
  259. package/dist/types/enums.js.map +1 -1
  260. package/dist/types/errors.d.ts +1 -0
  261. package/dist/types/errors.d.ts.map +1 -1
  262. package/dist/types/event.d.ts +10 -0
  263. package/dist/types/event.d.ts.map +1 -1
  264. package/dist/types/event.js +5 -1
  265. package/dist/types/event.js.map +1 -1
  266. package/dist/worker/bootstrap.d.ts +32 -1
  267. package/dist/worker/bootstrap.d.ts.map +1 -1
  268. package/dist/worker/bootstrap.js +166 -2
  269. package/dist/worker/bootstrap.js.map +1 -1
  270. package/instructions/capabilities.md +36 -1
  271. package/instructions/deployment.md +96 -11
  272. package/instructions/events.md +11 -0
  273. package/instructions/flows.md +12 -4
  274. package/instructions/governance.md +6 -0
  275. package/instructions/mcp.md +1 -1
  276. package/instructions/patterns.md +1 -0
  277. package/instructions/security.md +9 -0
  278. package/instructions/testing.md +12 -1
  279. package/instructions/upgrading-0.5-capabilities.md +181 -0
  280. package/package.json +12 -4
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/jobs/routes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOhD,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,GAAoB,EAAE,MAA4B;IACvF,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEzC,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,yBAAyB,EAAE,EAAE,CAAC;QACjF,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAA2B,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC;QACpE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9E,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;QAE5F,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACzB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAAC;QACtE,CAAC;QAED,OAAO;YACL,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM,CAAC,EAAE;gBAChB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,cAAc,EAAE;gBAC5E,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;gBACzC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;gBAClD,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,IAAI;gBACtD,MAAM,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;gBACjC,KAAK,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;aAChC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,264 @@
1
+ export declare const JobExecutionStatus: {
2
+ readonly Queued: "queued";
3
+ readonly Running: "running";
4
+ readonly Completed: "completed";
5
+ readonly Failed: "failed";
6
+ readonly DeadLettered: "dead_lettered";
7
+ };
8
+ export type JobExecutionStatus = (typeof JobExecutionStatus)[keyof typeof JobExecutionStatus];
9
+ export declare const JobExecutionSource: {
10
+ readonly Http: "http";
11
+ readonly Mcp: "mcp";
12
+ readonly Flow: "flow";
13
+ readonly Schedule: "schedule";
14
+ };
15
+ export type JobExecutionSource = (typeof JobExecutionSource)[keyof typeof JobExecutionSource];
16
+ /**
17
+ * Framework job_executions table — tracks async capability job lifecycle.
18
+ */
19
+ export declare const jobExecutionsTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
20
+ name: "job_executions";
21
+ schema: undefined;
22
+ columns: {
23
+ id: import("drizzle-orm/pg-core").PgColumn<{
24
+ name: "id";
25
+ tableName: "job_executions";
26
+ dataType: "string";
27
+ columnType: "PgUUID";
28
+ data: string;
29
+ driverParam: string;
30
+ notNull: true;
31
+ hasDefault: false;
32
+ isPrimaryKey: true;
33
+ isAutoincrement: false;
34
+ hasRuntimeDefault: false;
35
+ enumValues: undefined;
36
+ baseColumn: never;
37
+ identity: undefined;
38
+ generated: undefined;
39
+ }, {}, {}>;
40
+ capabilityDomain: import("drizzle-orm/pg-core").PgColumn<{
41
+ name: "capability_domain";
42
+ tableName: "job_executions";
43
+ dataType: "string";
44
+ columnType: "PgText";
45
+ data: string;
46
+ driverParam: string;
47
+ notNull: true;
48
+ hasDefault: false;
49
+ isPrimaryKey: false;
50
+ isAutoincrement: false;
51
+ hasRuntimeDefault: false;
52
+ enumValues: [string, ...string[]];
53
+ baseColumn: never;
54
+ identity: undefined;
55
+ generated: undefined;
56
+ }, {}, {}>;
57
+ capabilityName: import("drizzle-orm/pg-core").PgColumn<{
58
+ name: "capability_name";
59
+ tableName: "job_executions";
60
+ dataType: "string";
61
+ columnType: "PgText";
62
+ data: string;
63
+ driverParam: string;
64
+ notNull: true;
65
+ hasDefault: false;
66
+ isPrimaryKey: false;
67
+ isAutoincrement: false;
68
+ hasRuntimeDefault: false;
69
+ enumValues: [string, ...string[]];
70
+ baseColumn: never;
71
+ identity: undefined;
72
+ generated: undefined;
73
+ }, {}, {}>;
74
+ status: import("drizzle-orm/pg-core").PgColumn<{
75
+ name: "status";
76
+ tableName: "job_executions";
77
+ dataType: "string";
78
+ columnType: "PgText";
79
+ data: string;
80
+ driverParam: string;
81
+ notNull: true;
82
+ hasDefault: true;
83
+ isPrimaryKey: false;
84
+ isAutoincrement: false;
85
+ hasRuntimeDefault: false;
86
+ enumValues: [string, ...string[]];
87
+ baseColumn: never;
88
+ identity: undefined;
89
+ generated: undefined;
90
+ }, {}, {}>;
91
+ inputJson: import("drizzle-orm/pg-core").PgColumn<{
92
+ name: "input_json";
93
+ tableName: "job_executions";
94
+ dataType: "json";
95
+ columnType: "PgJsonb";
96
+ data: unknown;
97
+ driverParam: unknown;
98
+ notNull: false;
99
+ hasDefault: false;
100
+ isPrimaryKey: false;
101
+ isAutoincrement: false;
102
+ hasRuntimeDefault: false;
103
+ enumValues: undefined;
104
+ baseColumn: never;
105
+ identity: undefined;
106
+ generated: undefined;
107
+ }, {}, {}>;
108
+ outputJson: import("drizzle-orm/pg-core").PgColumn<{
109
+ name: "output_json";
110
+ tableName: "job_executions";
111
+ dataType: "json";
112
+ columnType: "PgJsonb";
113
+ data: unknown;
114
+ driverParam: unknown;
115
+ notNull: false;
116
+ hasDefault: false;
117
+ isPrimaryKey: false;
118
+ isAutoincrement: false;
119
+ hasRuntimeDefault: false;
120
+ enumValues: undefined;
121
+ baseColumn: never;
122
+ identity: undefined;
123
+ generated: undefined;
124
+ }, {}, {}>;
125
+ errorJson: import("drizzle-orm/pg-core").PgColumn<{
126
+ name: "error_json";
127
+ tableName: "job_executions";
128
+ dataType: "json";
129
+ columnType: "PgJsonb";
130
+ data: unknown;
131
+ driverParam: unknown;
132
+ notNull: false;
133
+ hasDefault: false;
134
+ isPrimaryKey: false;
135
+ isAutoincrement: false;
136
+ hasRuntimeDefault: false;
137
+ enumValues: undefined;
138
+ baseColumn: never;
139
+ identity: undefined;
140
+ generated: undefined;
141
+ }, {}, {}>;
142
+ authSnapshotJson: import("drizzle-orm/pg-core").PgColumn<{
143
+ name: "auth_snapshot_json";
144
+ tableName: "job_executions";
145
+ dataType: "json";
146
+ columnType: "PgJsonb";
147
+ data: unknown;
148
+ driverParam: unknown;
149
+ notNull: false;
150
+ hasDefault: false;
151
+ isPrimaryKey: false;
152
+ isAutoincrement: false;
153
+ hasRuntimeDefault: false;
154
+ enumValues: undefined;
155
+ baseColumn: never;
156
+ identity: undefined;
157
+ generated: undefined;
158
+ }, {}, {}>;
159
+ tenantId: import("drizzle-orm/pg-core").PgColumn<{
160
+ name: "tenant_id";
161
+ tableName: "job_executions";
162
+ dataType: "string";
163
+ columnType: "PgText";
164
+ data: string;
165
+ driverParam: string;
166
+ notNull: false;
167
+ hasDefault: false;
168
+ isPrimaryKey: false;
169
+ isAutoincrement: false;
170
+ hasRuntimeDefault: false;
171
+ enumValues: [string, ...string[]];
172
+ baseColumn: never;
173
+ identity: undefined;
174
+ generated: undefined;
175
+ }, {}, {}>;
176
+ correlationId: import("drizzle-orm/pg-core").PgColumn<{
177
+ name: "correlation_id";
178
+ tableName: "job_executions";
179
+ dataType: "string";
180
+ columnType: "PgText";
181
+ data: string;
182
+ driverParam: string;
183
+ notNull: false;
184
+ hasDefault: false;
185
+ isPrimaryKey: false;
186
+ isAutoincrement: false;
187
+ hasRuntimeDefault: false;
188
+ enumValues: [string, ...string[]];
189
+ baseColumn: never;
190
+ identity: undefined;
191
+ generated: undefined;
192
+ }, {}, {}>;
193
+ source: import("drizzle-orm/pg-core").PgColumn<{
194
+ name: "source";
195
+ tableName: "job_executions";
196
+ dataType: "string";
197
+ columnType: "PgText";
198
+ data: string;
199
+ driverParam: string;
200
+ notNull: true;
201
+ hasDefault: true;
202
+ isPrimaryKey: false;
203
+ isAutoincrement: false;
204
+ hasRuntimeDefault: false;
205
+ enumValues: [string, ...string[]];
206
+ baseColumn: never;
207
+ identity: undefined;
208
+ generated: undefined;
209
+ }, {}, {}>;
210
+ createdAt: import("drizzle-orm/pg-core").PgColumn<{
211
+ name: "created_at";
212
+ tableName: "job_executions";
213
+ dataType: "date";
214
+ columnType: "PgTimestamp";
215
+ data: Date;
216
+ driverParam: string;
217
+ notNull: true;
218
+ hasDefault: true;
219
+ isPrimaryKey: false;
220
+ isAutoincrement: false;
221
+ hasRuntimeDefault: false;
222
+ enumValues: undefined;
223
+ baseColumn: never;
224
+ identity: undefined;
225
+ generated: undefined;
226
+ }, {}, {}>;
227
+ startedAt: import("drizzle-orm/pg-core").PgColumn<{
228
+ name: "started_at";
229
+ tableName: "job_executions";
230
+ dataType: "date";
231
+ columnType: "PgTimestamp";
232
+ data: Date;
233
+ driverParam: string;
234
+ notNull: false;
235
+ hasDefault: false;
236
+ isPrimaryKey: false;
237
+ isAutoincrement: false;
238
+ hasRuntimeDefault: false;
239
+ enumValues: undefined;
240
+ baseColumn: never;
241
+ identity: undefined;
242
+ generated: undefined;
243
+ }, {}, {}>;
244
+ completedAt: import("drizzle-orm/pg-core").PgColumn<{
245
+ name: "completed_at";
246
+ tableName: "job_executions";
247
+ dataType: "date";
248
+ columnType: "PgTimestamp";
249
+ data: Date;
250
+ driverParam: string;
251
+ notNull: false;
252
+ hasDefault: false;
253
+ isPrimaryKey: false;
254
+ isAutoincrement: false;
255
+ hasRuntimeDefault: false;
256
+ enumValues: undefined;
257
+ baseColumn: never;
258
+ identity: undefined;
259
+ generated: undefined;
260
+ }, {}, {}>;
261
+ };
262
+ dialect: "pg";
263
+ }>;
264
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/jobs/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe7B,CAAC"}
@@ -0,0 +1,34 @@
1
+ import { jsonb, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
2
+ export const JobExecutionStatus = {
3
+ Queued: 'queued',
4
+ Running: 'running',
5
+ Completed: 'completed',
6
+ Failed: 'failed',
7
+ DeadLettered: 'dead_lettered',
8
+ };
9
+ export const JobExecutionSource = {
10
+ Http: 'http',
11
+ Mcp: 'mcp',
12
+ Flow: 'flow',
13
+ Schedule: 'schedule',
14
+ };
15
+ /**
16
+ * Framework job_executions table — tracks async capability job lifecycle.
17
+ */
18
+ export const jobExecutionsTable = pgTable('job_executions', {
19
+ id: uuid('id').primaryKey(),
20
+ capabilityDomain: text('capability_domain').notNull(),
21
+ capabilityName: text('capability_name').notNull(),
22
+ status: text('status').notNull().default(JobExecutionStatus.Queued),
23
+ inputJson: jsonb('input_json'),
24
+ outputJson: jsonb('output_json'),
25
+ errorJson: jsonb('error_json'),
26
+ authSnapshotJson: jsonb('auth_snapshot_json'),
27
+ tenantId: text('tenant_id'),
28
+ correlationId: text('correlation_id'),
29
+ source: text('source').notNull().default(JobExecutionSource.Http),
30
+ createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
31
+ startedAt: timestamp('started_at', { withTimezone: true }),
32
+ completedAt: timestamp('completed_at', { withTimezone: true }),
33
+ });
34
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/jobs/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,eAAe;CACrB,CAAC;AAIX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;CACZ,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAC1D,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE;IACrD,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE;IACjD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC;IACnE,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC;IAC9B,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC;IAC9B,gBAAgB,EAAE,KAAK,CAAC,oBAAoB,CAAC;IAC7C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;IAC3B,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC;IACjE,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;IACjF,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1D,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;CAC/D,CAAC,CAAC"}
@@ -0,0 +1,52 @@
1
+ import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
2
+ import type { AuthContext } from '../types/security.js';
3
+ import { type JobExecutionSource as JobSource } from './schema.js';
4
+ import type { JobExecutionRecord } from './types.js';
5
+ export interface CreateJobExecutionInput {
6
+ id: string;
7
+ capabilityDomain: string;
8
+ capabilityName: string;
9
+ input: Record<string, unknown>;
10
+ auth: AuthContext;
11
+ correlationId?: string;
12
+ source?: JobSource;
13
+ }
14
+ export declare function createJobService(db: PostgresJsDatabase): {
15
+ create(input: CreateJobExecutionInput): Promise<JobExecutionRecord>;
16
+ getById(id: string): Promise<JobExecutionRecord | undefined>;
17
+ /**
18
+ * Atomically transition queued → running. Returns true when this worker won the claim.
19
+ */
20
+ markRunning(id: string): Promise<boolean>;
21
+ /**
22
+ * Reclaim a stale running job after worker crash (visibility timeout exceeded).
23
+ * Returns true when this worker won the reclaim.
24
+ */
25
+ reclaimStaleRunning(id: string, staleAfterMs: number): Promise<boolean>;
26
+ /**
27
+ * Atomically claim a job for execution, or decide whether to ack or retry delivery.
28
+ */
29
+ tryClaimForExecution(id: string, staleAfterMs: number): Promise<JobClaimResult>;
30
+ markPublishFailed(id: string, error: {
31
+ code: string;
32
+ message: string;
33
+ }): Promise<void>;
34
+ deleteQueued(id: string): Promise<boolean>;
35
+ markCompleted(id: string, output: unknown): Promise<void>;
36
+ markFailed(id: string, error: {
37
+ code: string;
38
+ message: string;
39
+ }): Promise<void>;
40
+ markDeadLettered(id: string, error: {
41
+ code: string;
42
+ message: string;
43
+ }): Promise<void>;
44
+ };
45
+ export declare const JobClaimResult: {
46
+ readonly Claimed: "claimed";
47
+ readonly Terminal: "terminal";
48
+ readonly Retry: "retry";
49
+ };
50
+ export type JobClaimResult = (typeof JobClaimResult)[keyof typeof JobClaimResult];
51
+ export type JobService = ReturnType<typeof createJobService>;
52
+ //# sourceMappingURL=service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/jobs/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAIL,KAAK,kBAAkB,IAAI,SAAS,EACrC,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AA6BD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,kBAAkB;kBAE/B,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;gBAqBvD,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAUlE;;OAEG;oBACmB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc/C;;;OAGG;4BAC2B,MAAM,gBAAgB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe7E;;OAEG;6BAC4B,MAAM,gBAAgB,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;0BAiCzD,MAAM,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;qBAgBrE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;sBAaxB,MAAM,UAAU,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;mBAW1C,MAAM,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;yBAW1D,MAAM,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;EAW9F;AAED,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
@@ -0,0 +1,168 @@
1
+ import { and, eq, lt } from 'drizzle-orm';
2
+ import { jobExecutionsTable, JobExecutionSource, JobExecutionStatus, } from './schema.js';
3
+ function rowToRecord(row) {
4
+ return {
5
+ id: row.id,
6
+ capabilityDomain: row.capabilityDomain,
7
+ capabilityName: row.capabilityName,
8
+ status: row.status,
9
+ inputJson: row.inputJson,
10
+ outputJson: row.outputJson,
11
+ errorJson: row.errorJson,
12
+ authSnapshotJson: row.authSnapshotJson,
13
+ tenantId: row.tenantId,
14
+ correlationId: row.correlationId,
15
+ source: row.source,
16
+ createdAt: row.createdAt,
17
+ startedAt: row.startedAt,
18
+ completedAt: row.completedAt,
19
+ };
20
+ }
21
+ function getRowsAffected(result) {
22
+ const r = result;
23
+ if (typeof r?.rowCount === 'number')
24
+ return r.rowCount;
25
+ if (typeof r?.count === 'number')
26
+ return r.count;
27
+ if (typeof r?.length === 'number')
28
+ return r.length;
29
+ return 0;
30
+ }
31
+ export function createJobService(db) {
32
+ return {
33
+ async create(input) {
34
+ const [row] = await db
35
+ .insert(jobExecutionsTable)
36
+ .values({
37
+ id: input.id,
38
+ capabilityDomain: input.capabilityDomain,
39
+ capabilityName: input.capabilityName,
40
+ status: JobExecutionStatus.Queued,
41
+ inputJson: input.input,
42
+ authSnapshotJson: input.auth,
43
+ tenantId: input.auth.tenantId ?? null,
44
+ correlationId: input.correlationId ?? input.id,
45
+ source: input.source ?? JobExecutionSource.Http,
46
+ })
47
+ .returning();
48
+ if (!row) {
49
+ throw new Error('Failed to create job execution record');
50
+ }
51
+ return rowToRecord(row);
52
+ },
53
+ async getById(id) {
54
+ const rows = await db
55
+ .select()
56
+ .from(jobExecutionsTable)
57
+ .where(eq(jobExecutionsTable.id, id))
58
+ .limit(1);
59
+ const row = rows[0];
60
+ return row ? rowToRecord(row) : undefined;
61
+ },
62
+ /**
63
+ * Atomically transition queued → running. Returns true when this worker won the claim.
64
+ */
65
+ async markRunning(id) {
66
+ const result = await db
67
+ .update(jobExecutionsTable)
68
+ .set({ status: JobExecutionStatus.Running, startedAt: new Date() })
69
+ .where(and(eq(jobExecutionsTable.id, id), eq(jobExecutionsTable.status, JobExecutionStatus.Queued)));
70
+ const rowsAffected = getRowsAffected(result);
71
+ return rowsAffected > 0;
72
+ },
73
+ /**
74
+ * Reclaim a stale running job after worker crash (visibility timeout exceeded).
75
+ * Returns true when this worker won the reclaim.
76
+ */
77
+ async reclaimStaleRunning(id, staleAfterMs) {
78
+ const cutoff = new Date(Date.now() - staleAfterMs);
79
+ const result = await db
80
+ .update(jobExecutionsTable)
81
+ .set({ startedAt: new Date() })
82
+ .where(and(eq(jobExecutionsTable.id, id), eq(jobExecutionsTable.status, JobExecutionStatus.Running), lt(jobExecutionsTable.startedAt, cutoff)));
83
+ return getRowsAffected(result) > 0;
84
+ },
85
+ /**
86
+ * Atomically claim a job for execution, or decide whether to ack or retry delivery.
87
+ */
88
+ async tryClaimForExecution(id, staleAfterMs) {
89
+ const claimed = await this.markRunning(id);
90
+ if (claimed) {
91
+ return JobClaimResult.Claimed;
92
+ }
93
+ const record = await this.getById(id);
94
+ if (!record) {
95
+ throw new Error(`Job execution "${id}" not found`);
96
+ }
97
+ if (record.status === JobExecutionStatus.Completed ||
98
+ record.status === JobExecutionStatus.Failed ||
99
+ record.status === JobExecutionStatus.DeadLettered) {
100
+ return JobClaimResult.Terminal;
101
+ }
102
+ if (record.status === JobExecutionStatus.Running) {
103
+ const startedAt = record.startedAt?.getTime();
104
+ if (startedAt !== undefined && Date.now() - startedAt > staleAfterMs) {
105
+ const reclaimed = await this.reclaimStaleRunning(id, staleAfterMs);
106
+ if (reclaimed) {
107
+ return JobClaimResult.Claimed;
108
+ }
109
+ }
110
+ return JobClaimResult.Retry;
111
+ }
112
+ return JobClaimResult.Retry;
113
+ },
114
+ async markPublishFailed(id, error) {
115
+ await db
116
+ .update(jobExecutionsTable)
117
+ .set({
118
+ status: JobExecutionStatus.Failed,
119
+ errorJson: error,
120
+ completedAt: new Date(),
121
+ })
122
+ .where(and(eq(jobExecutionsTable.id, id), eq(jobExecutionsTable.status, JobExecutionStatus.Queued)));
123
+ },
124
+ async deleteQueued(id) {
125
+ const result = await db
126
+ .delete(jobExecutionsTable)
127
+ .where(and(eq(jobExecutionsTable.id, id), eq(jobExecutionsTable.status, JobExecutionStatus.Queued)));
128
+ const rowsAffected = getRowsAffected(result);
129
+ return rowsAffected > 0;
130
+ },
131
+ async markCompleted(id, output) {
132
+ await db
133
+ .update(jobExecutionsTable)
134
+ .set({
135
+ status: JobExecutionStatus.Completed,
136
+ outputJson: output,
137
+ completedAt: new Date(),
138
+ })
139
+ .where(eq(jobExecutionsTable.id, id));
140
+ },
141
+ async markFailed(id, error) {
142
+ await db
143
+ .update(jobExecutionsTable)
144
+ .set({
145
+ status: JobExecutionStatus.Failed,
146
+ errorJson: error,
147
+ completedAt: new Date(),
148
+ })
149
+ .where(eq(jobExecutionsTable.id, id));
150
+ },
151
+ async markDeadLettered(id, error) {
152
+ await db
153
+ .update(jobExecutionsTable)
154
+ .set({
155
+ status: JobExecutionStatus.DeadLettered,
156
+ errorJson: error,
157
+ completedAt: new Date(),
158
+ })
159
+ .where(eq(jobExecutionsTable.id, id));
160
+ },
161
+ };
162
+ }
163
+ export const JobClaimResult = {
164
+ Claimed: 'claimed',
165
+ Terminal: 'terminal',
166
+ Retry: 'retry',
167
+ };
168
+ //# sourceMappingURL=service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/jobs/service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import type { AuthContext } from '../types/security.js';
2
+ import type { JobExecutionSource, JobExecutionStatus } from './schema.js';
3
+ /** Structured job queue envelope payload for kind: 'job' capabilities. Auth is never trusted from the queue — loaded from job_executions.auth_snapshot_json at dequeue. */
4
+ export interface JobQueuePayload {
5
+ input: Record<string, unknown>;
6
+ capability: {
7
+ domain: string;
8
+ name: string;
9
+ };
10
+ jobExecutionId: string;
11
+ source: JobExecutionSource;
12
+ }
13
+ export interface JobExecutionRecord {
14
+ id: string;
15
+ capabilityDomain: string;
16
+ capabilityName: string;
17
+ status: JobExecutionStatus;
18
+ inputJson?: unknown;
19
+ outputJson?: unknown;
20
+ errorJson?: unknown;
21
+ authSnapshotJson?: AuthContext;
22
+ tenantId?: string | null;
23
+ correlationId?: string | null;
24
+ source: JobExecutionSource;
25
+ createdAt: Date;
26
+ startedAt?: Date | null;
27
+ completedAt?: Date | null;
28
+ }
29
+ export declare function jobEventType(domain: string, name: string): string;
30
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE1E,2KAA2K;AAC3K,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE"}
@@ -0,0 +1,4 @@
1
+ export function jobEventType(domain, name) {
2
+ return `job.${domain}.${name}`;
3
+ }
4
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/jobs/types.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY;IACvD,OAAO,OAAO,MAAM,IAAI,IAAI,EAAE,CAAC;AACjC,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"manifest-generator.d.ts","sourceRoot":"","sources":["../../src/mcp/manifest-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,iBAAiB,CAejF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW,CAM1E"}
1
+ {"version":3,"file":"manifest-generator.d.ts","sourceRoot":"","sources":["../../src/mcp/manifest-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,iBAAiB,CAejF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW,CAM1E"}
@@ -1,3 +1,4 @@
1
+ import { getCanonicalCapabilityName } from '../execution/canonical-name.js';
1
2
  import { zodInputToJsonSchema } from '../schema/zod-input-to-json-schema.js';
2
3
  import { isMcpExposed } from './exposure.js';
3
4
  function isMcpEligible(cap) {
@@ -6,8 +7,8 @@ function isMcpEligible(cap) {
6
7
  export function buildMcpToolDefinition(cap) {
7
8
  const agentTags = cap.mcp?.agentTags;
8
9
  const tool = {
9
- name: cap.name,
10
- description: cap.mcp?.description ?? cap.description ?? cap.name,
10
+ name: getCanonicalCapabilityName(cap),
11
+ description: cap.mcp?.description ?? cap.description ?? getCanonicalCapabilityName(cap),
11
12
  inputSchema: zodInputToJsonSchema(cap.input),
12
13
  annotations: {
13
14
  destructiveHint: cap.mcp?.dangerous ?? false,
@@ -1 +1 @@
1
- {"version":3,"file":"manifest-generator.js","sourceRoot":"","sources":["../../src/mcp/manifest-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAmB7C,SAAS,aAAa,CAAC,GAAuB;IAC5C,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAuB;IAC5D,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC;IACrC,MAAM,IAAI,GAAsB;QAC9B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,WAAW,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI;QAChE,WAAW,EAAE,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC;QAC5C,WAAW,EAAE;YACX,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,IAAI,KAAK;YAC5C,YAAY,EAAE,GAAG,CAAC,IAAI,KAAK,OAAO;SACnC;KACF,CAAC;IACF,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAA4B;IAC3D,MAAM,KAAK,GAAG,QAAQ;SACnB,MAAM,EAAE;SACR,MAAM,CAAC,aAAa,CAAC;SACrB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}
1
+ {"version":3,"file":"manifest-generator.js","sourceRoot":"","sources":["../../src/mcp/manifest-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAE5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAmB7C,SAAS,aAAa,CAAC,GAAuB;IAC5C,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAuB;IAC5D,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC;IACrC,MAAM,IAAI,GAAsB;QAC9B,IAAI,EAAE,0BAA0B,CAAC,GAAG,CAAC;QACrC,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,WAAW,IAAI,GAAG,CAAC,WAAW,IAAI,0BAA0B,CAAC,GAAG,CAAC;QACvF,WAAW,EAAE,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC;QAC5C,WAAW,EAAE;YACX,eAAe,EAAE,GAAG,CAAC,GAAG,EAAE,SAAS,IAAI,KAAK;YAC5C,YAAY,EAAE,GAAG,CAAC,IAAI,KAAK,OAAO;SACnC;KACF,CAAC;IACF,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAA4B;IAC3D,MAAM,KAAK,GAAG,QAAQ;SACnB,MAAM,EAAE;SACR,MAAM,CAAC,aAAa,CAAC;SACrB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}
@@ -11,9 +11,14 @@ export interface Histogram {
11
11
  getCount(labels?: MetricLabels): number;
12
12
  getSum(labels?: MetricLabels): number;
13
13
  }
14
+ export interface Gauge {
15
+ set(value: number, labels?: MetricLabels): void;
16
+ get(labels?: MetricLabels): number;
17
+ }
14
18
  export interface MetricsRegistry {
15
19
  counter(name: string, help: string): Counter;
16
20
  histogram(name: string, help: string): Histogram;
21
+ gauge(name: string, help: string): Gauge;
17
22
  /** Prometheus-compatible text exposition */
18
23
  serialize(): string;
19
24
  }
@@ -28,12 +33,15 @@ export interface PlumbusMetrics {
28
33
  eventEmitted: Counter;
29
34
  eventDelivered: Counter;
30
35
  eventFailed: Counter;
36
+ eventDeliveryDuration: Histogram;
31
37
  flowStarted: Counter;
32
38
  flowCompleted: Counter;
33
39
  flowFailed: Counter;
40
+ flowStepDuration: Histogram;
34
41
  aiRequestDuration: Histogram;
35
42
  aiRequestTotal: Counter;
36
- queueDepth: Counter;
43
+ outboxPending: Gauge;
44
+ queueDepth: Gauge;
37
45
  registry: MetricsRegistry;
38
46
  }
39
47
  /** Create the standard set of Plumbus runtime metrics */