@methodts/runtime 0.1.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 (537) hide show
  1. package/dist/__fixtures__/executor-fixtures.d.ts +10 -0
  2. package/dist/__fixtures__/executor-fixtures.d.ts.map +1 -0
  3. package/dist/__fixtures__/executor-fixtures.js +36 -0
  4. package/dist/__fixtures__/executor-fixtures.js.map +1 -0
  5. package/dist/architecture.test.d.ts +2 -0
  6. package/dist/architecture.test.d.ts.map +1 -0
  7. package/dist/architecture.test.js +143 -0
  8. package/dist/architecture.test.js.map +1 -0
  9. package/dist/config/cost-governor-config.d.ts +40 -0
  10. package/dist/config/cost-governor-config.d.ts.map +1 -0
  11. package/dist/config/cost-governor-config.js +48 -0
  12. package/dist/config/cost-governor-config.js.map +1 -0
  13. package/dist/config/index.d.ts +7 -0
  14. package/dist/config/index.d.ts.map +1 -0
  15. package/dist/config/index.js +6 -0
  16. package/dist/config/index.js.map +1 -0
  17. package/dist/config/sessions-config.d.ts +29 -0
  18. package/dist/config/sessions-config.d.ts.map +1 -0
  19. package/dist/config/sessions-config.js +37 -0
  20. package/dist/config/sessions-config.js.map +1 -0
  21. package/dist/config/strategies-config.d.ts +38 -0
  22. package/dist/config/strategies-config.d.ts.map +1 -0
  23. package/dist/config/strategies-config.js +41 -0
  24. package/dist/config/strategies-config.js.map +1 -0
  25. package/dist/cost-governor/backpressure-queue.d.ts +20 -0
  26. package/dist/cost-governor/backpressure-queue.d.ts.map +1 -0
  27. package/dist/cost-governor/backpressure-queue.js +78 -0
  28. package/dist/cost-governor/backpressure-queue.js.map +1 -0
  29. package/dist/cost-governor/backpressure-queue.test.d.ts +2 -0
  30. package/dist/cost-governor/backpressure-queue.test.d.ts.map +1 -0
  31. package/dist/cost-governor/backpressure-queue.test.js +48 -0
  32. package/dist/cost-governor/backpressure-queue.test.js.map +1 -0
  33. package/dist/cost-governor/cost-events.d.ts +65 -0
  34. package/dist/cost-governor/cost-events.d.ts.map +1 -0
  35. package/dist/cost-governor/cost-events.js +48 -0
  36. package/dist/cost-governor/cost-events.js.map +1 -0
  37. package/dist/cost-governor/cost-governor-app-id.test.d.ts +19 -0
  38. package/dist/cost-governor/cost-governor-app-id.test.d.ts.map +1 -0
  39. package/dist/cost-governor/cost-governor-app-id.test.js +201 -0
  40. package/dist/cost-governor/cost-governor-app-id.test.js.map +1 -0
  41. package/dist/cost-governor/cost-oracle-impl.d.ts +19 -0
  42. package/dist/cost-governor/cost-oracle-impl.d.ts.map +1 -0
  43. package/dist/cost-governor/cost-oracle-impl.js +52 -0
  44. package/dist/cost-governor/cost-oracle-impl.js.map +1 -0
  45. package/dist/cost-governor/estimator.d.ts +22 -0
  46. package/dist/cost-governor/estimator.d.ts.map +1 -0
  47. package/dist/cost-governor/estimator.js +119 -0
  48. package/dist/cost-governor/estimator.js.map +1 -0
  49. package/dist/cost-governor/estimator.test.d.ts +2 -0
  50. package/dist/cost-governor/estimator.test.d.ts.map +1 -0
  51. package/dist/cost-governor/estimator.test.js +141 -0
  52. package/dist/cost-governor/estimator.test.js.map +1 -0
  53. package/dist/cost-governor/index.d.ts +75 -0
  54. package/dist/cost-governor/index.d.ts.map +1 -0
  55. package/dist/cost-governor/index.js +120 -0
  56. package/dist/cost-governor/index.js.map +1 -0
  57. package/dist/cost-governor/observations-store.d.ts +49 -0
  58. package/dist/cost-governor/observations-store.d.ts.map +1 -0
  59. package/dist/cost-governor/observations-store.js +179 -0
  60. package/dist/cost-governor/observations-store.js.map +1 -0
  61. package/dist/cost-governor/observations-store.test.d.ts +2 -0
  62. package/dist/cost-governor/observations-store.test.d.ts.map +1 -0
  63. package/dist/cost-governor/observations-store.test.js +191 -0
  64. package/dist/cost-governor/observations-store.test.js.map +1 -0
  65. package/dist/cost-governor/percentile.d.ts +17 -0
  66. package/dist/cost-governor/percentile.d.ts.map +1 -0
  67. package/dist/cost-governor/percentile.js +33 -0
  68. package/dist/cost-governor/percentile.js.map +1 -0
  69. package/dist/cost-governor/percentile.test.d.ts +2 -0
  70. package/dist/cost-governor/percentile.test.d.ts.map +1 -0
  71. package/dist/cost-governor/percentile.test.js +46 -0
  72. package/dist/cost-governor/percentile.test.js.map +1 -0
  73. package/dist/cost-governor/rate-governor-impl.d.ts +73 -0
  74. package/dist/cost-governor/rate-governor-impl.d.ts.map +1 -0
  75. package/dist/cost-governor/rate-governor-impl.js +148 -0
  76. package/dist/cost-governor/rate-governor-impl.js.map +1 -0
  77. package/dist/cost-governor/signature-builder.d.ts +22 -0
  78. package/dist/cost-governor/signature-builder.d.ts.map +1 -0
  79. package/dist/cost-governor/signature-builder.js +43 -0
  80. package/dist/cost-governor/signature-builder.js.map +1 -0
  81. package/dist/cost-governor/signature-builder.test.d.ts +2 -0
  82. package/dist/cost-governor/signature-builder.test.d.ts.map +1 -0
  83. package/dist/cost-governor/signature-builder.test.js +58 -0
  84. package/dist/cost-governor/signature-builder.test.js.map +1 -0
  85. package/dist/cost-governor/token-bucket.d.ts +57 -0
  86. package/dist/cost-governor/token-bucket.d.ts.map +1 -0
  87. package/dist/cost-governor/token-bucket.js +109 -0
  88. package/dist/cost-governor/token-bucket.js.map +1 -0
  89. package/dist/cost-governor/token-bucket.test.d.ts +2 -0
  90. package/dist/cost-governor/token-bucket.test.d.ts.map +1 -0
  91. package/dist/cost-governor/token-bucket.test.js +67 -0
  92. package/dist/cost-governor/token-bucket.test.js.map +1 -0
  93. package/dist/dlq/cortex-dlq-observer.d.ts +22 -0
  94. package/dist/dlq/cortex-dlq-observer.d.ts.map +1 -0
  95. package/dist/dlq/cortex-dlq-observer.js +29 -0
  96. package/dist/dlq/cortex-dlq-observer.js.map +1 -0
  97. package/dist/dlq/dlq-observer.test.d.ts +8 -0
  98. package/dist/dlq/dlq-observer.test.d.ts.map +1 -0
  99. package/dist/dlq/dlq-observer.test.js +103 -0
  100. package/dist/dlq/dlq-observer.test.js.map +1 -0
  101. package/dist/dlq/index.d.ts +6 -0
  102. package/dist/dlq/index.d.ts.map +1 -0
  103. package/dist/dlq/index.js +6 -0
  104. package/dist/dlq/index.js.map +1 -0
  105. package/dist/event-bus/adapters.d.ts +50 -0
  106. package/dist/event-bus/adapters.d.ts.map +1 -0
  107. package/dist/event-bus/adapters.js +51 -0
  108. package/dist/event-bus/adapters.js.map +1 -0
  109. package/dist/event-bus/adapters.test.d.ts +5 -0
  110. package/dist/event-bus/adapters.test.d.ts.map +1 -0
  111. package/dist/event-bus/adapters.test.js +73 -0
  112. package/dist/event-bus/adapters.test.js.map +1 -0
  113. package/dist/event-bus/agent-event-adapter.d.ts +22 -0
  114. package/dist/event-bus/agent-event-adapter.d.ts.map +1 -0
  115. package/dist/event-bus/agent-event-adapter.js +49 -0
  116. package/dist/event-bus/agent-event-adapter.js.map +1 -0
  117. package/dist/event-bus/agent-event-adapter.test.d.ts +5 -0
  118. package/dist/event-bus/agent-event-adapter.test.d.ts.map +1 -0
  119. package/dist/event-bus/agent-event-adapter.test.js +170 -0
  120. package/dist/event-bus/agent-event-adapter.test.js.map +1 -0
  121. package/dist/event-bus/channel-sink.d.ts +71 -0
  122. package/dist/event-bus/channel-sink.d.ts.map +1 -0
  123. package/dist/event-bus/channel-sink.js +159 -0
  124. package/dist/event-bus/channel-sink.js.map +1 -0
  125. package/dist/event-bus/channel-sink.test.d.ts +5 -0
  126. package/dist/event-bus/channel-sink.test.d.ts.map +1 -0
  127. package/dist/event-bus/channel-sink.test.js +234 -0
  128. package/dist/event-bus/channel-sink.test.js.map +1 -0
  129. package/dist/event-bus/event-types.snapshot.test.d.ts +27 -0
  130. package/dist/event-bus/event-types.snapshot.test.d.ts.map +1 -0
  131. package/dist/event-bus/event-types.snapshot.test.js +165 -0
  132. package/dist/event-bus/event-types.snapshot.test.js.map +1 -0
  133. package/dist/event-bus/genesis-sink.d.ts +55 -0
  134. package/dist/event-bus/genesis-sink.d.ts.map +1 -0
  135. package/dist/event-bus/genesis-sink.js +141 -0
  136. package/dist/event-bus/genesis-sink.js.map +1 -0
  137. package/dist/event-bus/genesis-sink.test.d.ts +5 -0
  138. package/dist/event-bus/genesis-sink.test.d.ts.map +1 -0
  139. package/dist/event-bus/genesis-sink.test.js +160 -0
  140. package/dist/event-bus/genesis-sink.test.js.map +1 -0
  141. package/dist/event-bus/in-memory-event-bus.d.ts +60 -0
  142. package/dist/event-bus/in-memory-event-bus.d.ts.map +1 -0
  143. package/dist/event-bus/in-memory-event-bus.js +274 -0
  144. package/dist/event-bus/in-memory-event-bus.js.map +1 -0
  145. package/dist/event-bus/in-memory-event-bus.test.d.ts +5 -0
  146. package/dist/event-bus/in-memory-event-bus.test.d.ts.map +1 -0
  147. package/dist/event-bus/in-memory-event-bus.test.js +457 -0
  148. package/dist/event-bus/in-memory-event-bus.test.js.map +1 -0
  149. package/dist/event-bus/index.d.ts +22 -0
  150. package/dist/event-bus/index.d.ts.map +1 -0
  151. package/dist/event-bus/index.js +17 -0
  152. package/dist/event-bus/index.js.map +1 -0
  153. package/dist/event-bus/persistence-sink.d.ts +74 -0
  154. package/dist/event-bus/persistence-sink.d.ts.map +1 -0
  155. package/dist/event-bus/persistence-sink.js +193 -0
  156. package/dist/event-bus/persistence-sink.js.map +1 -0
  157. package/dist/event-bus/persistence-sink.test.d.ts +6 -0
  158. package/dist/event-bus/persistence-sink.test.d.ts.map +1 -0
  159. package/dist/event-bus/persistence-sink.test.js +319 -0
  160. package/dist/event-bus/persistence-sink.test.js.map +1 -0
  161. package/dist/event-bus/session-checkpoint-sink.d.ts +91 -0
  162. package/dist/event-bus/session-checkpoint-sink.d.ts.map +1 -0
  163. package/dist/event-bus/session-checkpoint-sink.js +107 -0
  164. package/dist/event-bus/session-checkpoint-sink.js.map +1 -0
  165. package/dist/event-bus/session-checkpoint-sink.test.d.ts +5 -0
  166. package/dist/event-bus/session-checkpoint-sink.test.d.ts.map +1 -0
  167. package/dist/event-bus/session-checkpoint-sink.test.js +215 -0
  168. package/dist/event-bus/session-checkpoint-sink.test.js.map +1 -0
  169. package/dist/event-bus/webhook-connector.d.ts +59 -0
  170. package/dist/event-bus/webhook-connector.d.ts.map +1 -0
  171. package/dist/event-bus/webhook-connector.js +191 -0
  172. package/dist/event-bus/webhook-connector.js.map +1 -0
  173. package/dist/event-bus/webhook-connector.test.d.ts +5 -0
  174. package/dist/event-bus/webhook-connector.test.d.ts.map +1 -0
  175. package/dist/event-bus/webhook-connector.test.js +214 -0
  176. package/dist/event-bus/webhook-connector.test.js.map +1 -0
  177. package/dist/executors/cortex-job-backed-executor.d.ts +137 -0
  178. package/dist/executors/cortex-job-backed-executor.d.ts.map +1 -0
  179. package/dist/executors/cortex-job-backed-executor.js +441 -0
  180. package/dist/executors/cortex-job-backed-executor.js.map +1 -0
  181. package/dist/executors/cortex-job-backed-executor.test.d.ts +13 -0
  182. package/dist/executors/cortex-job-backed-executor.test.d.ts.map +1 -0
  183. package/dist/executors/cortex-job-backed-executor.test.js +303 -0
  184. package/dist/executors/cortex-job-backed-executor.test.js.map +1 -0
  185. package/dist/executors/index.d.ts +9 -0
  186. package/dist/executors/index.d.ts.map +1 -0
  187. package/dist/executors/index.js +9 -0
  188. package/dist/executors/index.js.map +1 -0
  189. package/dist/index.d.ts +2 -0
  190. package/dist/index.d.ts.map +1 -0
  191. package/dist/index.js +13 -0
  192. package/dist/index.js.map +1 -0
  193. package/dist/ports/checkpoint-sink.d.ts +69 -0
  194. package/dist/ports/checkpoint-sink.d.ts.map +1 -0
  195. package/dist/ports/checkpoint-sink.js +16 -0
  196. package/dist/ports/checkpoint-sink.js.map +1 -0
  197. package/dist/ports/checkpoint.d.ts +68 -0
  198. package/dist/ports/checkpoint.d.ts.map +1 -0
  199. package/dist/ports/checkpoint.js +14 -0
  200. package/dist/ports/checkpoint.js.map +1 -0
  201. package/dist/ports/continuation-envelope-cross-app.test.d.ts +10 -0
  202. package/dist/ports/continuation-envelope-cross-app.test.d.ts.map +1 -0
  203. package/dist/ports/continuation-envelope-cross-app.test.js +95 -0
  204. package/dist/ports/continuation-envelope-cross-app.test.js.map +1 -0
  205. package/dist/ports/continuation-envelope.d.ts +199 -0
  206. package/dist/ports/continuation-envelope.d.ts.map +1 -0
  207. package/dist/ports/continuation-envelope.js +69 -0
  208. package/dist/ports/continuation-envelope.js.map +1 -0
  209. package/dist/ports/conversation.d.ts +64 -0
  210. package/dist/ports/conversation.d.ts.map +1 -0
  211. package/dist/ports/conversation.js +19 -0
  212. package/dist/ports/conversation.js.map +1 -0
  213. package/dist/ports/cost-oracle.d.ts +26 -0
  214. package/dist/ports/cost-oracle.d.ts.map +1 -0
  215. package/dist/ports/cost-oracle.js +9 -0
  216. package/dist/ports/cost-oracle.js.map +1 -0
  217. package/dist/ports/cross-app-invoker.d.ts +198 -0
  218. package/dist/ports/cross-app-invoker.d.ts.map +1 -0
  219. package/dist/ports/cross-app-invoker.js +157 -0
  220. package/dist/ports/cross-app-invoker.js.map +1 -0
  221. package/dist/ports/dlq-observer.d.ts +40 -0
  222. package/dist/ports/dlq-observer.d.ts.map +1 -0
  223. package/dist/ports/dlq-observer.js +20 -0
  224. package/dist/ports/dlq-observer.js.map +1 -0
  225. package/dist/ports/event-bus.d.ts +169 -0
  226. package/dist/ports/event-bus.d.ts.map +1 -0
  227. package/dist/ports/event-bus.js +20 -0
  228. package/dist/ports/event-bus.js.map +1 -0
  229. package/dist/ports/event-reader.d.ts +21 -0
  230. package/dist/ports/event-reader.d.ts.map +1 -0
  231. package/dist/ports/event-reader.js +12 -0
  232. package/dist/ports/event-reader.js.map +1 -0
  233. package/dist/ports/event-rotator.d.ts +39 -0
  234. package/dist/ports/event-rotator.d.ts.map +1 -0
  235. package/dist/ports/event-rotator.js +15 -0
  236. package/dist/ports/event-rotator.js.map +1 -0
  237. package/dist/ports/file-system.d.ts +48 -0
  238. package/dist/ports/file-system.d.ts.map +1 -0
  239. package/dist/ports/file-system.js +10 -0
  240. package/dist/ports/file-system.js.map +1 -0
  241. package/dist/ports/historical-observations.d.ts +39 -0
  242. package/dist/ports/historical-observations.d.ts.map +1 -0
  243. package/dist/ports/historical-observations.js +12 -0
  244. package/dist/ports/historical-observations.js.map +1 -0
  245. package/dist/ports/in-memory-source.d.ts +46 -0
  246. package/dist/ports/in-memory-source.d.ts.map +1 -0
  247. package/dist/ports/in-memory-source.js +69 -0
  248. package/dist/ports/in-memory-source.js.map +1 -0
  249. package/dist/ports/index.d.ts +32 -0
  250. package/dist/ports/index.d.ts.map +1 -0
  251. package/dist/ports/index.js +10 -0
  252. package/dist/ports/index.js.map +1 -0
  253. package/dist/ports/job-backed-executor.d.ts +139 -0
  254. package/dist/ports/job-backed-executor.d.ts.map +1 -0
  255. package/dist/ports/job-backed-executor.js +56 -0
  256. package/dist/ports/job-backed-executor.js.map +1 -0
  257. package/dist/ports/methodology-source.d.ts +95 -0
  258. package/dist/ports/methodology-source.d.ts.map +1 -0
  259. package/dist/ports/methodology-source.js +26 -0
  260. package/dist/ports/methodology-source.js.map +1 -0
  261. package/dist/ports/native-session-discovery.d.ts +20 -0
  262. package/dist/ports/native-session-discovery.d.ts.map +1 -0
  263. package/dist/ports/native-session-discovery.js +13 -0
  264. package/dist/ports/native-session-discovery.js.map +1 -0
  265. package/dist/ports/projection-store.d.ts +48 -0
  266. package/dist/ports/projection-store.d.ts.map +1 -0
  267. package/dist/ports/projection-store.js +17 -0
  268. package/dist/ports/projection-store.js.map +1 -0
  269. package/dist/ports/projection.d.ts +29 -0
  270. package/dist/ports/projection.d.ts.map +1 -0
  271. package/dist/ports/projection.js +13 -0
  272. package/dist/ports/projection.js.map +1 -0
  273. package/dist/ports/rate-governor.d.ts +17 -0
  274. package/dist/ports/rate-governor.d.ts.map +1 -0
  275. package/dist/ports/rate-governor.js +11 -0
  276. package/dist/ports/rate-governor.js.map +1 -0
  277. package/dist/ports/schedule-client.d.ts +29 -0
  278. package/dist/ports/schedule-client.d.ts.map +1 -0
  279. package/dist/ports/schedule-client.js +2 -0
  280. package/dist/ports/schedule-client.js.map +1 -0
  281. package/dist/ports/session-pool.d.ts +162 -0
  282. package/dist/ports/session-pool.d.ts.map +1 -0
  283. package/dist/ports/session-pool.js +21 -0
  284. package/dist/ports/session-pool.js.map +1 -0
  285. package/dist/ports/session-store-errors.d.ts +22 -0
  286. package/dist/ports/session-store-errors.d.ts.map +1 -0
  287. package/dist/ports/session-store-errors.js +29 -0
  288. package/dist/ports/session-store-errors.js.map +1 -0
  289. package/dist/ports/session-store-types.d.ts +132 -0
  290. package/dist/ports/session-store-types.d.ts.map +1 -0
  291. package/dist/ports/session-store-types.js +14 -0
  292. package/dist/ports/session-store-types.js.map +1 -0
  293. package/dist/ports/session-store.d.ts +69 -0
  294. package/dist/ports/session-store.d.ts.map +1 -0
  295. package/dist/ports/session-store.js +23 -0
  296. package/dist/ports/session-store.js.map +1 -0
  297. package/dist/ports/yaml-loader.d.ts +15 -0
  298. package/dist/ports/yaml-loader.d.ts.map +1 -0
  299. package/dist/ports/yaml-loader.js +13 -0
  300. package/dist/ports/yaml-loader.js.map +1 -0
  301. package/dist/scheduling/index.d.ts +6 -0
  302. package/dist/scheduling/index.d.ts.map +1 -0
  303. package/dist/scheduling/index.js +6 -0
  304. package/dist/scheduling/index.js.map +1 -0
  305. package/dist/scheduling/scheduled-pact.d.ts +97 -0
  306. package/dist/scheduling/scheduled-pact.d.ts.map +1 -0
  307. package/dist/scheduling/scheduled-pact.js +89 -0
  308. package/dist/scheduling/scheduled-pact.js.map +1 -0
  309. package/dist/sessions/__tests__/cognitive-modules.test.d.ts +10 -0
  310. package/dist/sessions/__tests__/cognitive-modules.test.d.ts.map +1 -0
  311. package/dist/sessions/__tests__/cognitive-modules.test.js +535 -0
  312. package/dist/sessions/__tests__/cognitive-modules.test.js.map +1 -0
  313. package/dist/sessions/__tests__/cognitive-provider.test.d.ts +13 -0
  314. package/dist/sessions/__tests__/cognitive-provider.test.d.ts.map +1 -0
  315. package/dist/sessions/__tests__/cognitive-provider.test.js +331 -0
  316. package/dist/sessions/__tests__/cognitive-provider.test.js.map +1 -0
  317. package/dist/sessions/__tests__/cognitive-sink.test.d.ts +19 -0
  318. package/dist/sessions/__tests__/cognitive-sink.test.d.ts.map +1 -0
  319. package/dist/sessions/__tests__/cognitive-sink.test.js +334 -0
  320. package/dist/sessions/__tests__/cognitive-sink.test.js.map +1 -0
  321. package/dist/sessions/__tests__/runtime-tools.test.d.ts +2 -0
  322. package/dist/sessions/__tests__/runtime-tools.test.d.ts.map +1 -0
  323. package/dist/sessions/__tests__/runtime-tools.test.js +83 -0
  324. package/dist/sessions/__tests__/runtime-tools.test.js.map +1 -0
  325. package/dist/sessions/auto-retro.d.ts +29 -0
  326. package/dist/sessions/auto-retro.d.ts.map +1 -0
  327. package/dist/sessions/auto-retro.js +181 -0
  328. package/dist/sessions/auto-retro.js.map +1 -0
  329. package/dist/sessions/auto-retro.test.d.ts +2 -0
  330. package/dist/sessions/auto-retro.test.d.ts.map +1 -0
  331. package/dist/sessions/auto-retro.test.js +361 -0
  332. package/dist/sessions/auto-retro.test.js.map +1 -0
  333. package/dist/sessions/channels.d.ts +55 -0
  334. package/dist/sessions/channels.d.ts.map +1 -0
  335. package/dist/sessions/channels.js +118 -0
  336. package/dist/sessions/channels.js.map +1 -0
  337. package/dist/sessions/channels.test.d.ts +2 -0
  338. package/dist/sessions/channels.test.d.ts.map +1 -0
  339. package/dist/sessions/channels.test.js +285 -0
  340. package/dist/sessions/channels.test.js.map +1 -0
  341. package/dist/sessions/cognitive-modules.d.ts +100 -0
  342. package/dist/sessions/cognitive-modules.d.ts.map +1 -0
  343. package/dist/sessions/cognitive-modules.js +458 -0
  344. package/dist/sessions/cognitive-modules.js.map +1 -0
  345. package/dist/sessions/cognitive-provider.d.ts +42 -0
  346. package/dist/sessions/cognitive-provider.d.ts.map +1 -0
  347. package/dist/sessions/cognitive-provider.js +208 -0
  348. package/dist/sessions/cognitive-provider.js.map +1 -0
  349. package/dist/sessions/cognitive-sink.d.ts +73 -0
  350. package/dist/sessions/cognitive-sink.d.ts.map +1 -0
  351. package/dist/sessions/cognitive-sink.js +154 -0
  352. package/dist/sessions/cognitive-sink.js.map +1 -0
  353. package/dist/sessions/diagnostics.d.ts +70 -0
  354. package/dist/sessions/diagnostics.d.ts.map +1 -0
  355. package/dist/sessions/diagnostics.js +129 -0
  356. package/dist/sessions/diagnostics.js.map +1 -0
  357. package/dist/sessions/diagnostics.test.d.ts +2 -0
  358. package/dist/sessions/diagnostics.test.d.ts.map +1 -0
  359. package/dist/sessions/diagnostics.test.js +135 -0
  360. package/dist/sessions/diagnostics.test.js.map +1 -0
  361. package/dist/sessions/index.d.ts +32 -0
  362. package/dist/sessions/index.d.ts.map +1 -0
  363. package/dist/sessions/index.js +33 -0
  364. package/dist/sessions/index.js.map +1 -0
  365. package/dist/sessions/pool.d.ts +218 -0
  366. package/dist/sessions/pool.d.ts.map +1 -0
  367. package/dist/sessions/pool.js +991 -0
  368. package/dist/sessions/pool.js.map +1 -0
  369. package/dist/sessions/pool.test.d.ts +2 -0
  370. package/dist/sessions/pool.test.d.ts.map +1 -0
  371. package/dist/sessions/pool.test.js +633 -0
  372. package/dist/sessions/pool.test.js.map +1 -0
  373. package/dist/sessions/print-session.d.ts +142 -0
  374. package/dist/sessions/print-session.d.ts.map +1 -0
  375. package/dist/sessions/print-session.js +325 -0
  376. package/dist/sessions/print-session.js.map +1 -0
  377. package/dist/sessions/print-session.test.d.ts +2 -0
  378. package/dist/sessions/print-session.test.d.ts.map +1 -0
  379. package/dist/sessions/print-session.test.js +418 -0
  380. package/dist/sessions/print-session.test.js.map +1 -0
  381. package/dist/sessions/runtime-tools.d.ts +22 -0
  382. package/dist/sessions/runtime-tools.d.ts.map +1 -0
  383. package/dist/sessions/runtime-tools.js +162 -0
  384. package/dist/sessions/runtime-tools.js.map +1 -0
  385. package/dist/sessions/scope-hook.d.ts +77 -0
  386. package/dist/sessions/scope-hook.d.ts.map +1 -0
  387. package/dist/sessions/scope-hook.js +323 -0
  388. package/dist/sessions/scope-hook.js.map +1 -0
  389. package/dist/sessions/scope-hook.test.d.ts +2 -0
  390. package/dist/sessions/scope-hook.test.d.ts.map +1 -0
  391. package/dist/sessions/scope-hook.test.js +249 -0
  392. package/dist/sessions/scope-hook.test.js.map +1 -0
  393. package/dist/sessions/session-store/checkpoint-sink-impl.d.ts +16 -0
  394. package/dist/sessions/session-store/checkpoint-sink-impl.d.ts.map +1 -0
  395. package/dist/sessions/session-store/checkpoint-sink-impl.js +191 -0
  396. package/dist/sessions/session-store/checkpoint-sink-impl.js.map +1 -0
  397. package/dist/sessions/session-store/checkpoint-sink-impl.test.d.ts +5 -0
  398. package/dist/sessions/session-store/checkpoint-sink-impl.test.d.ts.map +1 -0
  399. package/dist/sessions/session-store/checkpoint-sink-impl.test.js +137 -0
  400. package/dist/sessions/session-store/checkpoint-sink-impl.test.js.map +1 -0
  401. package/dist/sessions/session-store/conformance.d.ts +59 -0
  402. package/dist/sessions/session-store/conformance.d.ts.map +1 -0
  403. package/dist/sessions/session-store/conformance.js +172 -0
  404. package/dist/sessions/session-store/conformance.js.map +1 -0
  405. package/dist/sessions/session-store/conformance.test.d.ts +7 -0
  406. package/dist/sessions/session-store/conformance.test.d.ts.map +1 -0
  407. package/dist/sessions/session-store/conformance.test.js +22 -0
  408. package/dist/sessions/session-store/conformance.test.js.map +1 -0
  409. package/dist/sessions/session-store/in-memory-session-store.d.ts +23 -0
  410. package/dist/sessions/session-store/in-memory-session-store.d.ts.map +1 -0
  411. package/dist/sessions/session-store/in-memory-session-store.js +197 -0
  412. package/dist/sessions/session-store/in-memory-session-store.js.map +1 -0
  413. package/dist/sessions/session-store/in-memory-session-store.test.d.ts +6 -0
  414. package/dist/sessions/session-store/in-memory-session-store.test.d.ts.map +1 -0
  415. package/dist/sessions/session-store/in-memory-session-store.test.js +183 -0
  416. package/dist/sessions/session-store/in-memory-session-store.test.js.map +1 -0
  417. package/dist/sessions/session-store/index.d.ts +20 -0
  418. package/dist/sessions/session-store/index.d.ts.map +1 -0
  419. package/dist/sessions/session-store/index.js +15 -0
  420. package/dist/sessions/session-store/index.js.map +1 -0
  421. package/dist/sessions/session-store/resume.d.ts +88 -0
  422. package/dist/sessions/session-store/resume.d.ts.map +1 -0
  423. package/dist/sessions/session-store/resume.js +96 -0
  424. package/dist/sessions/session-store/resume.js.map +1 -0
  425. package/dist/sessions/session-store/resume.test.d.ts +5 -0
  426. package/dist/sessions/session-store/resume.test.d.ts.map +1 -0
  427. package/dist/sessions/session-store/resume.test.js +119 -0
  428. package/dist/sessions/session-store/resume.test.js.map +1 -0
  429. package/dist/sessions/spawn-queue.d.ts +28 -0
  430. package/dist/sessions/spawn-queue.d.ts.map +1 -0
  431. package/dist/sessions/spawn-queue.js +63 -0
  432. package/dist/sessions/spawn-queue.js.map +1 -0
  433. package/dist/sessions/spawn-queue.test.d.ts +2 -0
  434. package/dist/sessions/spawn-queue.test.d.ts.map +1 -0
  435. package/dist/sessions/spawn-queue.test.js +65 -0
  436. package/dist/sessions/spawn-queue.test.js.map +1 -0
  437. package/dist/sessions/types.d.ts +16 -0
  438. package/dist/sessions/types.d.ts.map +1 -0
  439. package/dist/sessions/types.js +11 -0
  440. package/dist/sessions/types.js.map +1 -0
  441. package/dist/sessions/worktree-stale.test.d.ts +2 -0
  442. package/dist/sessions/worktree-stale.test.d.ts.map +1 -0
  443. package/dist/sessions/worktree-stale.test.js +468 -0
  444. package/dist/sessions/worktree-stale.test.js.map +1 -0
  445. package/dist/strategy/artifact-store.d.ts +12 -0
  446. package/dist/strategy/artifact-store.d.ts.map +1 -0
  447. package/dist/strategy/artifact-store.js +12 -0
  448. package/dist/strategy/artifact-store.js.map +1 -0
  449. package/dist/strategy/artifact-store.test.d.ts +2 -0
  450. package/dist/strategy/artifact-store.test.d.ts.map +1 -0
  451. package/dist/strategy/artifact-store.test.js +170 -0
  452. package/dist/strategy/artifact-store.test.js.map +1 -0
  453. package/dist/strategy/context-load-executor.d.ts +23 -0
  454. package/dist/strategy/context-load-executor.d.ts.map +1 -0
  455. package/dist/strategy/context-load-executor.js +87 -0
  456. package/dist/strategy/context-load-executor.js.map +1 -0
  457. package/dist/strategy/context-load-executor.test.d.ts +16 -0
  458. package/dist/strategy/context-load-executor.test.d.ts.map +1 -0
  459. package/dist/strategy/context-load-executor.test.js +158 -0
  460. package/dist/strategy/context-load-executor.test.js.map +1 -0
  461. package/dist/strategy/cortex-cross-app-invoker.stub.d.ts +65 -0
  462. package/dist/strategy/cortex-cross-app-invoker.stub.d.ts.map +1 -0
  463. package/dist/strategy/cortex-cross-app-invoker.stub.js +68 -0
  464. package/dist/strategy/cortex-cross-app-invoker.stub.js.map +1 -0
  465. package/dist/strategy/cross-app-node-executor.d.ts +54 -0
  466. package/dist/strategy/cross-app-node-executor.d.ts.map +1 -0
  467. package/dist/strategy/cross-app-node-executor.js +98 -0
  468. package/dist/strategy/cross-app-node-executor.js.map +1 -0
  469. package/dist/strategy/cross-app-node-executor.test.d.ts +13 -0
  470. package/dist/strategy/cross-app-node-executor.test.d.ts.map +1 -0
  471. package/dist/strategy/cross-app-node-executor.test.js +160 -0
  472. package/dist/strategy/cross-app-node-executor.test.js.map +1 -0
  473. package/dist/strategy/gates.d.ts +13 -0
  474. package/dist/strategy/gates.d.ts.map +1 -0
  475. package/dist/strategy/gates.js +13 -0
  476. package/dist/strategy/gates.js.map +1 -0
  477. package/dist/strategy/gates.test.d.ts +2 -0
  478. package/dist/strategy/gates.test.d.ts.map +1 -0
  479. package/dist/strategy/gates.test.js +299 -0
  480. package/dist/strategy/gates.test.js.map +1 -0
  481. package/dist/strategy/human-approval-resolver.d.ts +23 -0
  482. package/dist/strategy/human-approval-resolver.d.ts.map +1 -0
  483. package/dist/strategy/human-approval-resolver.js +94 -0
  484. package/dist/strategy/human-approval-resolver.js.map +1 -0
  485. package/dist/strategy/human-approval-resolver.test.d.ts +16 -0
  486. package/dist/strategy/human-approval-resolver.test.d.ts.map +1 -0
  487. package/dist/strategy/human-approval-resolver.test.js +200 -0
  488. package/dist/strategy/human-approval-resolver.test.js.map +1 -0
  489. package/dist/strategy/in-process-cross-app-invoker.d.ts +105 -0
  490. package/dist/strategy/in-process-cross-app-invoker.d.ts.map +1 -0
  491. package/dist/strategy/in-process-cross-app-invoker.js +206 -0
  492. package/dist/strategy/in-process-cross-app-invoker.js.map +1 -0
  493. package/dist/strategy/in-process-cross-app-invoker.test.d.ts +15 -0
  494. package/dist/strategy/in-process-cross-app-invoker.test.d.ts.map +1 -0
  495. package/dist/strategy/in-process-cross-app-invoker.test.js +190 -0
  496. package/dist/strategy/in-process-cross-app-invoker.test.js.map +1 -0
  497. package/dist/strategy/index.d.ts +29 -0
  498. package/dist/strategy/index.d.ts.map +1 -0
  499. package/dist/strategy/index.js +29 -0
  500. package/dist/strategy/index.js.map +1 -0
  501. package/dist/strategy/pacta-strategy.d.ts +97 -0
  502. package/dist/strategy/pacta-strategy.d.ts.map +1 -0
  503. package/dist/strategy/pacta-strategy.js +117 -0
  504. package/dist/strategy/pacta-strategy.js.map +1 -0
  505. package/dist/strategy/pacta-strategy.test.d.ts +2 -0
  506. package/dist/strategy/pacta-strategy.test.d.ts.map +1 -0
  507. package/dist/strategy/pacta-strategy.test.js +234 -0
  508. package/dist/strategy/pacta-strategy.test.js.map +1 -0
  509. package/dist/strategy/retro-generator.d.ts +18 -0
  510. package/dist/strategy/retro-generator.d.ts.map +1 -0
  511. package/dist/strategy/retro-generator.js +22 -0
  512. package/dist/strategy/retro-generator.js.map +1 -0
  513. package/dist/strategy/retro-writer.d.ts +25 -0
  514. package/dist/strategy/retro-writer.d.ts.map +1 -0
  515. package/dist/strategy/retro-writer.js +65 -0
  516. package/dist/strategy/retro-writer.js.map +1 -0
  517. package/dist/strategy/strategy-executor.d.ts +39 -0
  518. package/dist/strategy/strategy-executor.d.ts.map +1 -0
  519. package/dist/strategy/strategy-executor.js +253 -0
  520. package/dist/strategy/strategy-executor.js.map +1 -0
  521. package/dist/strategy/strategy-executor.test.d.ts +8 -0
  522. package/dist/strategy/strategy-executor.test.d.ts.map +1 -0
  523. package/dist/strategy/strategy-executor.test.js +1301 -0
  524. package/dist/strategy/strategy-executor.test.js.map +1 -0
  525. package/dist/strategy/strategy-parser.d.ts +30 -0
  526. package/dist/strategy/strategy-parser.d.ts.map +1 -0
  527. package/dist/strategy/strategy-parser.js +30 -0
  528. package/dist/strategy/strategy-parser.js.map +1 -0
  529. package/dist/strategy/sub-strategy-source.d.ts +27 -0
  530. package/dist/strategy/sub-strategy-source.d.ts.map +1 -0
  531. package/dist/strategy/sub-strategy-source.js +77 -0
  532. package/dist/strategy/sub-strategy-source.js.map +1 -0
  533. package/dist/strategy/types.d.ts +12 -0
  534. package/dist/strategy/types.d.ts.map +1 -0
  535. package/dist/strategy/types.js +9 -0
  536. package/dist/strategy/types.js.map +1 -0
  537. package/package.json +87 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"estimator.js","sourceRoot":"","sources":["../../src/cost-governor/estimator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=estimator.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"estimator.test.d.ts","sourceRoot":"","sources":["../../src/cost-governor/estimator.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,141 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { describe, it } from 'node:test';
3
+ import assert from 'node:assert/strict';
4
+ import { estimateStrategy, heuristicEstimate } from './estimator.js';
5
+ const sigOf = (id) => ({
6
+ methodologyId: id,
7
+ capabilities: [],
8
+ model: 'test',
9
+ inputSizeBucket: 's',
10
+ });
11
+ const knownEstimate = (sig, p50) => ({
12
+ cost: { p50Usd: p50, p90Usd: p50 * 1.5, sampleCount: 10, confidence: 'medium' },
13
+ durationMs: {
14
+ p50Usd: 10_000,
15
+ p90Usd: 15_000,
16
+ sampleCount: 10,
17
+ confidence: 'medium',
18
+ },
19
+ });
20
+ describe('heuristicEstimate', () => {
21
+ it('returns non-zero cost for unknown signature', () => {
22
+ const band = heuristicEstimate(sigOf('X'));
23
+ assert.ok(band.p50Usd > 0);
24
+ assert.equal(band.sampleCount, 0);
25
+ assert.equal(band.confidence, 'low');
26
+ });
27
+ it('xs bucket has lower cost than xl', () => {
28
+ const xs = heuristicEstimate({ ...sigOf('X'), inputSizeBucket: 'xs' });
29
+ const xl = heuristicEstimate({ ...sigOf('X'), inputSizeBucket: 'xl' });
30
+ assert.ok(xl.p50Usd > xs.p50Usd);
31
+ });
32
+ it('respects cost floor', () => {
33
+ const band = heuristicEstimate({ ...sigOf('X'), inputSizeBucket: 'xs' });
34
+ assert.ok(band.p50Usd >= 0.02); // COST_FLOOR_USD
35
+ });
36
+ });
37
+ describe('estimateStrategy — 5 DAG shapes', () => {
38
+ it('linear DAG (A -> B -> C)', () => {
39
+ const signatures = new Map([
40
+ ['A', sigOf('m1')],
41
+ ['B', sigOf('m1')],
42
+ ['C', sigOf('m1')],
43
+ ]);
44
+ const edges = new Map([
45
+ ['A', []],
46
+ ['B', ['A']],
47
+ ['C', ['B']],
48
+ ]);
49
+ const result = estimateStrategy(signatures, edges, () => knownEstimate(sigOf('m1'), 0.10));
50
+ // Total cost = 3 * 0.10 = 0.30
51
+ assert.ok(Math.abs(result.totalCost.p50Usd - 0.30) < 0.001);
52
+ // Critical path = 3 nodes * 10000ms = 30000ms
53
+ assert.equal(result.totalDurationMs.p50Usd, 30_000);
54
+ assert.equal(result.unknownNodes.length, 0);
55
+ });
56
+ it('diamond DAG (A -> B,C -> D)', () => {
57
+ const signatures = new Map([
58
+ ['A', sigOf('m')],
59
+ ['B', sigOf('m')],
60
+ ['C', sigOf('m')],
61
+ ['D', sigOf('m')],
62
+ ]);
63
+ const edges = new Map([
64
+ ['A', []],
65
+ ['B', ['A']],
66
+ ['C', ['A']],
67
+ ['D', ['B', 'C']],
68
+ ]);
69
+ const result = estimateStrategy(signatures, edges, () => knownEstimate(sigOf('m'), 0.05));
70
+ // Total cost = 4 * 0.05 = 0.20 (all nodes execute)
71
+ assert.ok(Math.abs(result.totalCost.p50Usd - 0.20) < 0.001);
72
+ // Critical path = 3 nodes on longest path (A->B->D or A->C->D) * 10000ms
73
+ assert.equal(result.totalDurationMs.p50Usd, 30_000);
74
+ });
75
+ it('fan-out DAG (A -> B, C, D)', () => {
76
+ const signatures = new Map([
77
+ ['A', sigOf('m')],
78
+ ['B', sigOf('m')],
79
+ ['C', sigOf('m')],
80
+ ['D', sigOf('m')],
81
+ ]);
82
+ const edges = new Map([
83
+ ['A', []],
84
+ ['B', ['A']],
85
+ ['C', ['A']],
86
+ ['D', ['A']],
87
+ ]);
88
+ const result = estimateStrategy(signatures, edges, () => knownEstimate(sigOf('m'), 0.05));
89
+ assert.ok(Math.abs(result.totalCost.p50Usd - 0.20) < 0.001);
90
+ // Critical path: A -> any leaf = 2 nodes * 10000ms
91
+ assert.equal(result.totalDurationMs.p50Usd, 20_000);
92
+ });
93
+ it('fan-in DAG (A, B, C -> D)', () => {
94
+ const signatures = new Map([
95
+ ['A', sigOf('m')],
96
+ ['B', sigOf('m')],
97
+ ['C', sigOf('m')],
98
+ ['D', sigOf('m')],
99
+ ]);
100
+ const edges = new Map([
101
+ ['A', []],
102
+ ['B', []],
103
+ ['C', []],
104
+ ['D', ['A', 'B', 'C']],
105
+ ]);
106
+ const result = estimateStrategy(signatures, edges, () => knownEstimate(sigOf('m'), 0.05));
107
+ assert.ok(Math.abs(result.totalCost.p50Usd - 0.20) < 0.001);
108
+ // Critical path: any of {A,B,C} -> D = 2 nodes
109
+ assert.equal(result.totalDurationMs.p50Usd, 20_000);
110
+ });
111
+ it('unknown nodes get heuristic estimates + flagged', () => {
112
+ const signatures = new Map([['A', sigOf('unknown')]]);
113
+ const edges = new Map([['A', []]]);
114
+ const result = estimateStrategy(signatures, edges, () => null);
115
+ assert.equal(result.unknownNodes.length, 1);
116
+ assert.equal(result.unknownNodes[0], 'A');
117
+ assert.ok(result.totalCost.p50Usd >= 0.02); // floor applied
118
+ assert.equal(result.totalCost.confidence, 'low');
119
+ });
120
+ });
121
+ describe('estimateStrategy — confidence', () => {
122
+ it('high confidence with 20+ samples', () => {
123
+ const signatures = new Map([['A', sigOf('m')]]);
124
+ const edges = new Map([['A', []]]);
125
+ const result = estimateStrategy(signatures, edges, () => ({
126
+ cost: { p50Usd: 0.1, p90Usd: 0.15, sampleCount: 25, confidence: 'high' },
127
+ durationMs: { p50Usd: 5000, p90Usd: 7500, sampleCount: 25, confidence: 'high' },
128
+ }));
129
+ assert.equal(result.totalCost.confidence, 'high');
130
+ });
131
+ it('low confidence with < 5 samples', () => {
132
+ const signatures = new Map([['A', sigOf('m')]]);
133
+ const edges = new Map([['A', []]]);
134
+ const result = estimateStrategy(signatures, edges, () => ({
135
+ cost: { p50Usd: 0.1, p90Usd: 0.15, sampleCount: 2, confidence: 'low' },
136
+ durationMs: { p50Usd: 5000, p90Usd: 7500, sampleCount: 2, confidence: 'low' },
137
+ }));
138
+ assert.equal(result.totalCost.confidence, 'low');
139
+ });
140
+ });
141
+ //# sourceMappingURL=estimator.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"estimator.test.js","sourceRoot":"","sources":["../../src/cost-governor/estimator.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,75 @@
1
+ /**
2
+ * @methodts/runtime/cost-governor — transport-free cost governor factory.
3
+ *
4
+ * PRD-057 / S2 §3.5, §8 / C4: moved from @methodts/bridge/domains/cost-governor.
5
+ *
6
+ * Key differences from the prior bridge factory:
7
+ *
8
+ * 1. **No Fastify coupling** (S2 Q5). `createCostGovernor` returns
9
+ * primitives only — `oracle`, `rateGovernor`, `observations`,
10
+ * `appendToken`, `sweepLeakedSlots`. Bridge keeps a thin
11
+ * `domains/cost-governor/routes.ts` that imports these primitives and
12
+ * wires Fastify.
13
+ * 2. **Optional per-`appId` scoping** (S2 §8). When `options.appId` is
14
+ * supplied (agent-runtime / Cortex case), rate-governor slots and
15
+ * emitted events are scoped by `{accountId, appId}`. When absent
16
+ * (bridge case), behavior is bit-identical to pre-PRD-057
17
+ * `createCostGovernorDomain`.
18
+ * 3. **Renamed factory**. `createCostGovernorDomain` → `createCostGovernor`.
19
+ * Old name is NOT aliased here — bridge callers migrate through the
20
+ * composition root (server-entry.ts) + the bridge-side routes module.
21
+ */
22
+ import type { EventBus } from '../ports/event-bus.js';
23
+ import type { FileSystemProvider } from '../ports/file-system.js';
24
+ import type { AppendToken } from '../ports/historical-observations.js';
25
+ import type { CostGovernorConfig } from '../config/cost-governor-config.js';
26
+ import { ObservationsStore } from './observations-store.js';
27
+ import { HistogramCostOracle } from './cost-oracle-impl.js';
28
+ import { SingleAccountRateGovernor, type AppId } from './rate-governor-impl.js';
29
+ export { CostGovernorConfigSchema, loadCostGovernorConfig } from '../config/cost-governor-config.js';
30
+ export type { CostGovernorConfig } from '../config/cost-governor-config.js';
31
+ export { buildSignature, signatureKey, inputSizeBucket } from './signature-builder.js';
32
+ export { ObservationsStore } from './observations-store.js';
33
+ export { HistogramCostOracle } from './cost-oracle-impl.js';
34
+ export { SingleAccountRateGovernor } from './rate-governor-impl.js';
35
+ export type { AppId } from './rate-governor-impl.js';
36
+ export { TokenBucket } from './token-bucket.js';
37
+ export { BackpressureQueue } from './backpressure-queue.js';
38
+ export { estimateStrategy, heuristicEstimate } from './estimator.js';
39
+ export { emitObservationRecorded, emitRateLimited, emitEstimateEmitted, emitSlotLeaked, emitAccountSaturated, emitIntegrityViolation, emitObservationsCorrupted, } from './cost-events.js';
40
+ export type { CostEventType } from './cost-events.js';
41
+ export type { CostOracle } from '../ports/cost-oracle.js';
42
+ export type { RuntimeRateGovernor } from '../ports/rate-governor.js';
43
+ export type { HistoricalObservations } from '../ports/historical-observations.js';
44
+ export interface CreateCostGovernorOptions {
45
+ eventBus: EventBus;
46
+ fileSystem: FileSystemProvider;
47
+ config?: Partial<CostGovernorConfig>;
48
+ /**
49
+ * Optional per-tenant application identifier (PRD-057 / S2 §8).
50
+ *
51
+ * - Absent → bridge's legacy behavior, slots keyed by `accountId`.
52
+ * - Present → agent-runtime / Cortex path: slots keyed by
53
+ * `${accountId}:${appId}`, emitted events carry `payload.appId`.
54
+ */
55
+ appId?: AppId;
56
+ }
57
+ /**
58
+ * Primitives returned by `createCostGovernor`. Unlike the prior bridge
59
+ * factory, this record does NOT contain `registerRoutes` — routes are a
60
+ * transport concern that stays in `@methodts/bridge` per S2 §5.1. Bridge
61
+ * imports these primitives and mounts them via its own Fastify wrapper.
62
+ */
63
+ export interface CostGovernor {
64
+ readonly oracle: HistogramCostOracle;
65
+ readonly rateGovernor: SingleAccountRateGovernor;
66
+ readonly observations: ObservationsStore;
67
+ /** Capability token for appending observations (composition-root only). */
68
+ readonly appendToken: AppendToken;
69
+ /** Run one pass of the leak-detection watchdog. */
70
+ sweepLeakedSlots(): number;
71
+ /** Expose the scoped `appId` (undefined = no scoping). */
72
+ readonly appId: AppId | undefined;
73
+ }
74
+ export declare function createCostGovernor(options: CreateCostGovernorOptions): CostGovernor;
75
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cost-governor/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,OAAO,EAAE,iBAAiB,EAAwB,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAWhF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACrG,YAAY,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAIlF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,mDAAmD;IACnD,gBAAgB,IAAI,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CAoGd"}
@@ -0,0 +1,120 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ /**
3
+ * @methodts/runtime/cost-governor — transport-free cost governor factory.
4
+ *
5
+ * PRD-057 / S2 §3.5, §8 / C4: moved from @methodts/bridge/domains/cost-governor.
6
+ *
7
+ * Key differences from the prior bridge factory:
8
+ *
9
+ * 1. **No Fastify coupling** (S2 Q5). `createCostGovernor` returns
10
+ * primitives only — `oracle`, `rateGovernor`, `observations`,
11
+ * `appendToken`, `sweepLeakedSlots`. Bridge keeps a thin
12
+ * `domains/cost-governor/routes.ts` that imports these primitives and
13
+ * wires Fastify.
14
+ * 2. **Optional per-`appId` scoping** (S2 §8). When `options.appId` is
15
+ * supplied (agent-runtime / Cortex case), rate-governor slots and
16
+ * emitted events are scoped by `{accountId, appId}`. When absent
17
+ * (bridge case), behavior is bit-identical to pre-PRD-057
18
+ * `createCostGovernorDomain`.
19
+ * 3. **Renamed factory**. `createCostGovernorDomain` → `createCostGovernor`.
20
+ * Old name is NOT aliased here — bridge callers migrate through the
21
+ * composition root (server-entry.ts) + the bridge-side routes module.
22
+ */
23
+ import { createAppendToken } from '../ports/historical-observations.js';
24
+ import { CostGovernorConfigSchema } from '../config/cost-governor-config.js';
25
+ import { ObservationsStore } from './observations-store.js';
26
+ import { HistogramCostOracle } from './cost-oracle-impl.js';
27
+ import { SingleAccountRateGovernor } from './rate-governor-impl.js';
28
+ import { emitObservationRecorded, emitIntegrityViolation, emitObservationsCorrupted, emitSlotLeaked, } from './cost-events.js';
29
+ // ── Re-exports (S2 §3.5) ────────────────────────────────────────
30
+ export { CostGovernorConfigSchema, loadCostGovernorConfig } from '../config/cost-governor-config.js';
31
+ export { buildSignature, signatureKey, inputSizeBucket } from './signature-builder.js';
32
+ export { ObservationsStore } from './observations-store.js';
33
+ export { HistogramCostOracle } from './cost-oracle-impl.js';
34
+ export { SingleAccountRateGovernor } from './rate-governor-impl.js';
35
+ export { TokenBucket } from './token-bucket.js';
36
+ export { BackpressureQueue } from './backpressure-queue.js';
37
+ export { estimateStrategy, heuristicEstimate } from './estimator.js';
38
+ export { emitObservationRecorded, emitRateLimited, emitEstimateEmitted, emitSlotLeaked, emitAccountSaturated, emitIntegrityViolation, emitObservationsCorrupted, } from './cost-events.js';
39
+ export function createCostGovernor(options) {
40
+ const config = CostGovernorConfigSchema.parse(options.config ?? {});
41
+ const { appId } = options;
42
+ // Diagnostic callback → event bus
43
+ const diagnostic = (event) => {
44
+ if (event.type === 'cost.integrity_violation') {
45
+ emitIntegrityViolation(options.eventBus, {
46
+ ...event.payload,
47
+ ...(appId !== undefined ? { appId } : {}),
48
+ });
49
+ }
50
+ else if (event.type === 'cost.observations_corrupted') {
51
+ emitObservationsCorrupted(options.eventBus, {
52
+ ...event.payload,
53
+ ...(appId !== undefined ? { appId } : {}),
54
+ });
55
+ }
56
+ };
57
+ const observations = new ObservationsStore({
58
+ dataDir: config.dataDir,
59
+ hmacSecret: config.hmacSecret,
60
+ maxPerSignature: config.maxObservationsPerSignature,
61
+ }, options.fileSystem, diagnostic);
62
+ // Load history from disk
63
+ observations.recover();
64
+ const appendToken = createAppendToken();
65
+ // Rate governor + observation callback
66
+ const rateGovernor = new SingleAccountRateGovernor({
67
+ burstCapacity: config.burstCapacity,
68
+ weeklyCap: config.weeklyCap,
69
+ concurrentCap: config.concurrentCap,
70
+ queueWaitTimeoutMs: config.slotTimeoutMs,
71
+ }, (outcome, record) => {
72
+ // Only persist successful observations (others would skew estimates)
73
+ if (outcome.outcome !== 'success')
74
+ return;
75
+ if (!record.signature)
76
+ return;
77
+ const accountId = record.slot.accountId;
78
+ const providerClass = record.slot.providerClass;
79
+ observations.append({
80
+ signature: record.signature,
81
+ costUsd: outcome.actualCostUsd,
82
+ durationMs: outcome.actualDurationMs,
83
+ tokensIn: 0,
84
+ tokensOut: 0,
85
+ tokensCacheRead: 0,
86
+ tokensCacheWrite: 0,
87
+ recordedAt: Date.now(),
88
+ accountId,
89
+ providerClass,
90
+ }, appendToken);
91
+ emitObservationRecorded(options.eventBus, {
92
+ signature: record.signature,
93
+ costUsd: outcome.actualCostUsd,
94
+ durationMs: outcome.actualDurationMs,
95
+ accountId,
96
+ ...(appId !== undefined ? { appId } : {}),
97
+ });
98
+ }, { appId });
99
+ const oracle = new HistogramCostOracle(observations);
100
+ return {
101
+ oracle,
102
+ rateGovernor,
103
+ observations,
104
+ appendToken,
105
+ appId,
106
+ sweepLeakedSlots() {
107
+ return rateGovernor.sweep((slot) => {
108
+ emitSlotLeaked(options.eventBus, {
109
+ slotId: String(slot.slotId),
110
+ accountId: slot.accountId,
111
+ ageMs: Date.now() - slot.acquiredAt,
112
+ ...(appId !== undefined ? { appId } : {}),
113
+ });
114
+ });
115
+ },
116
+ };
117
+ }
118
+ // Silence unused-import warning for ProviderClass — retained for future use.
119
+ void null;
120
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cost-governor/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,49 @@
1
+ /**
2
+ * ObservationsStore — JSONL-backed HistoricalObservations implementation.
3
+ *
4
+ * Features:
5
+ * - HMAC per line (integrity check on read)
6
+ * - In-memory index by signature hash (cap 1000 per signature)
7
+ * - AppendToken capability enforcement
8
+ * - Crash recovery: skip invalid HMAC lines, rename wholly-corrupted files
9
+ */
10
+ import type { InvocationSignature } from '@methodts/types';
11
+ import type { FileSystemProvider } from '../ports/file-system.js';
12
+ import type { HistoricalObservations, Observation, AppendToken } from '../ports/historical-observations.js';
13
+ export interface ObservationsStoreConfig {
14
+ /** Directory where JSONL files are stored. */
15
+ dataDir: string;
16
+ /** Secret key for HMAC integrity (boot-time generated). */
17
+ hmacSecret: string;
18
+ /** Max observations held in memory per signature. */
19
+ maxPerSignature?: number;
20
+ }
21
+ export interface RecoveryResult {
22
+ validLines: number;
23
+ skippedLines: number;
24
+ corruptedFile: boolean;
25
+ }
26
+ export interface DiagnosticEvent {
27
+ type: 'cost.integrity_violation' | 'cost.observations_corrupted' | 'cost.observation_parse_error';
28
+ payload: Record<string, unknown>;
29
+ }
30
+ export declare class ObservationsStore implements HistoricalObservations {
31
+ private readonly config;
32
+ private readonly fs;
33
+ private readonly diagnostic?;
34
+ private index;
35
+ private readonly maxPerSignature;
36
+ private readonly filePath;
37
+ constructor(config: ObservationsStoreConfig, fs: FileSystemProvider, diagnostic?: ((event: DiagnosticEvent) => void) | undefined);
38
+ /** Load observations from disk. Returns recovery stats. */
39
+ recover(): RecoveryResult;
40
+ query(sig: InvocationSignature, limit?: number): readonly Observation[];
41
+ append(obs: Omit<Observation, 'hmac'>, _token: AppendToken): void;
42
+ /** Total observations held in memory across all signatures. */
43
+ count(): number;
44
+ private addToIndex;
45
+ private tryParseLine;
46
+ private computeHmac;
47
+ private renameCorrupted;
48
+ }
49
+ //# sourceMappingURL=observations-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observations-store.d.ts","sourceRoot":"","sources":["../../src/cost-governor/observations-store.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EACV,sBAAsB,EACtB,WAAW,EACX,WAAW,EACZ,MAAM,qCAAqC,CAAC;AAG7C,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EACA,0BAA0B,GAC1B,6BAA6B,GAC7B,8BAA8B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,iBAAkB,YAAW,sBAAsB;IAM5D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAP9B,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,MAAM,EAAE,uBAAuB,EAC/B,EAAE,EAAE,kBAAkB,EACtB,UAAU,CAAC,GAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,aAAA;IAMhE,2DAA2D;IAC3D,OAAO,IAAI,cAAc;IA4CzB,KAAK,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE;IAQvE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAyBjE,+DAA+D;IAC/D,KAAK,IAAI,MAAM;IAMf,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,eAAe;CAaxB"}
@@ -0,0 +1,179 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ /**
3
+ * ObservationsStore — JSONL-backed HistoricalObservations implementation.
4
+ *
5
+ * Features:
6
+ * - HMAC per line (integrity check on read)
7
+ * - In-memory index by signature hash (cap 1000 per signature)
8
+ * - AppendToken capability enforcement
9
+ * - Crash recovery: skip invalid HMAC lines, rename wholly-corrupted files
10
+ */
11
+ import { createHmac } from 'node:crypto';
12
+ import { join } from 'node:path';
13
+ import { signatureKey } from './signature-builder.js';
14
+ export class ObservationsStore {
15
+ config;
16
+ fs;
17
+ diagnostic;
18
+ index = new Map();
19
+ maxPerSignature;
20
+ filePath;
21
+ constructor(config, fs, diagnostic) {
22
+ this.config = config;
23
+ this.fs = fs;
24
+ this.diagnostic = diagnostic;
25
+ this.maxPerSignature = config.maxPerSignature ?? 1000;
26
+ this.filePath = join(config.dataDir, currentMonthFilename());
27
+ }
28
+ /** Load observations from disk. Returns recovery stats. */
29
+ recover() {
30
+ if (!this.fs.existsSync(this.config.dataDir)) {
31
+ this.fs.mkdirSync(this.config.dataDir, { recursive: true });
32
+ }
33
+ if (!this.fs.existsSync(this.filePath)) {
34
+ return { validLines: 0, skippedLines: 0, corruptedFile: false };
35
+ }
36
+ let raw;
37
+ try {
38
+ raw = this.fs.readFileSync(this.filePath, 'utf-8');
39
+ }
40
+ catch {
41
+ this.renameCorrupted();
42
+ return { validLines: 0, skippedLines: 0, corruptedFile: true };
43
+ }
44
+ const lines = raw.split('\n').filter(l => l.trim().length > 0);
45
+ let validCount = 0;
46
+ let skipCount = 0;
47
+ for (let i = 0; i < lines.length; i++) {
48
+ const line = lines[i];
49
+ const result = this.tryParseLine(line, i);
50
+ if (result) {
51
+ this.addToIndex(result);
52
+ validCount++;
53
+ }
54
+ else {
55
+ skipCount++;
56
+ }
57
+ }
58
+ // If everything is bad, treat as total corruption
59
+ if (lines.length > 0 && validCount === 0) {
60
+ this.renameCorrupted();
61
+ return {
62
+ validLines: 0,
63
+ skippedLines: skipCount,
64
+ corruptedFile: true,
65
+ };
66
+ }
67
+ return { validLines: validCount, skippedLines: skipCount, corruptedFile: false };
68
+ }
69
+ query(sig, limit) {
70
+ const key = signatureKey(sig);
71
+ const arr = this.index.get(key) ?? [];
72
+ // Newest first
73
+ const reversed = [...arr].reverse();
74
+ return limit !== undefined ? reversed.slice(0, limit) : reversed;
75
+ }
76
+ append(obs, _token) {
77
+ const serialized = JSON.stringify(obs);
78
+ const hmac = this.computeHmac(serialized);
79
+ const full = { ...obs, hmac };
80
+ const line = JSON.stringify(full) + '\n';
81
+ // Append to file (best-effort, sync)
82
+ try {
83
+ // Ensure dir exists
84
+ if (!this.fs.existsSync(this.config.dataDir)) {
85
+ this.fs.mkdirSync(this.config.dataDir, { recursive: true });
86
+ }
87
+ // Append by read+write (FileSystemProvider has appendFile only async)
88
+ const existing = this.fs.existsSync(this.filePath)
89
+ ? this.fs.readFileSync(this.filePath, 'utf-8')
90
+ : '';
91
+ this.fs.writeFileSync(this.filePath, existing + line, { encoding: 'utf-8' });
92
+ }
93
+ catch (err) {
94
+ // Re-throw to caller — persistence failure is important
95
+ throw new Error(`ObservationsStore append failed: ${err.message}`);
96
+ }
97
+ this.addToIndex(full);
98
+ }
99
+ /** Total observations held in memory across all signatures. */
100
+ count() {
101
+ let total = 0;
102
+ for (const arr of this.index.values())
103
+ total += arr.length;
104
+ return total;
105
+ }
106
+ addToIndex(obs) {
107
+ const key = signatureKey(obs.signature);
108
+ let arr = this.index.get(key);
109
+ if (!arr) {
110
+ arr = [];
111
+ this.index.set(key, arr);
112
+ }
113
+ arr.push(obs);
114
+ // Cap per-signature
115
+ if (arr.length > this.maxPerSignature) {
116
+ arr.shift();
117
+ }
118
+ }
119
+ tryParseLine(line, lineNumber) {
120
+ let parsed;
121
+ try {
122
+ parsed = JSON.parse(line);
123
+ }
124
+ catch {
125
+ this.diagnostic?.({
126
+ type: 'cost.observation_parse_error',
127
+ payload: { lineNumber, reason: 'invalid JSON' },
128
+ });
129
+ return null;
130
+ }
131
+ if (!parsed || typeof parsed !== 'object' || !parsed.hmac) {
132
+ this.diagnostic?.({
133
+ type: 'cost.integrity_violation',
134
+ payload: { lineNumber, reason: 'missing hmac' },
135
+ });
136
+ return null;
137
+ }
138
+ // Verify HMAC
139
+ const { hmac: providedHmac, ...rest } = parsed;
140
+ const expected = this.computeHmac(JSON.stringify(rest));
141
+ if (providedHmac !== expected) {
142
+ this.diagnostic?.({
143
+ type: 'cost.integrity_violation',
144
+ payload: {
145
+ lineNumber,
146
+ reason: 'HMAC mismatch',
147
+ },
148
+ });
149
+ return null;
150
+ }
151
+ return parsed;
152
+ }
153
+ computeHmac(data) {
154
+ return createHmac('sha256', this.config.hmacSecret)
155
+ .update(data)
156
+ .digest('hex');
157
+ }
158
+ renameCorrupted() {
159
+ const ts = new Date().toISOString().replace(/[:.]/g, '-');
160
+ const corruptPath = `${this.filePath}.corrupt-${ts}`;
161
+ try {
162
+ this.fs.renameSync(this.filePath, corruptPath);
163
+ }
164
+ catch {
165
+ // best effort
166
+ }
167
+ this.diagnostic?.({
168
+ type: 'cost.observations_corrupted',
169
+ payload: { renamedTo: corruptPath, recordsLoaded: 0, recordsSkipped: 0 },
170
+ });
171
+ }
172
+ }
173
+ function currentMonthFilename() {
174
+ const now = new Date();
175
+ const year = now.getUTCFullYear();
176
+ const month = String(now.getUTCMonth() + 1).padStart(2, '0');
177
+ return `observations-${year}-${month}.jsonl`;
178
+ }
179
+ //# sourceMappingURL=observations-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observations-store.js","sourceRoot":"","sources":["../../src/cost-governor/observations-store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=observations-store.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observations-store.test.d.ts","sourceRoot":"","sources":["../../src/cost-governor/observations-store.test.ts"],"names":[],"mappings":""}