footprintjs 10.0.0 → 10.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 (354) hide show
  1. package/AGENTS.md +2 -1
  2. package/CLAUDE.md +43 -7
  3. package/README.md +136 -312
  4. package/dist/esm/index.d.ts +60 -2
  5. package/dist/esm/index.js +13 -6
  6. package/dist/esm/lib/attempt/anySignal.d.ts +19 -0
  7. package/dist/esm/lib/attempt/anySignal.js +39 -0
  8. package/dist/esm/lib/attempt/call.d.ts +88 -0
  9. package/dist/esm/lib/attempt/call.js +129 -0
  10. package/dist/esm/lib/attempt/category.d.ts +31 -0
  11. package/dist/esm/lib/attempt/category.js +107 -0
  12. package/dist/esm/lib/attempt/correlation.d.ts +95 -0
  13. package/dist/esm/lib/attempt/correlation.js +178 -0
  14. package/dist/esm/lib/attempt/deadline.d.ts +44 -0
  15. package/dist/esm/lib/attempt/deadline.js +101 -0
  16. package/dist/esm/lib/attempt/decision.d.ts +52 -0
  17. package/dist/esm/lib/attempt/decision.js +134 -0
  18. package/dist/esm/lib/attempt/effect.d.ts +76 -0
  19. package/dist/esm/lib/attempt/effect.js +160 -0
  20. package/dist/esm/lib/attempt/errors.d.ts +41 -0
  21. package/dist/esm/lib/attempt/errors.js +44 -0
  22. package/dist/esm/lib/attempt/index.d.ts +18 -0
  23. package/dist/esm/lib/attempt/index.js +15 -0
  24. package/dist/esm/lib/attempt/name.d.ts +21 -0
  25. package/dist/esm/lib/attempt/name.js +43 -0
  26. package/dist/esm/lib/attempt/observed.d.ts +66 -0
  27. package/dist/esm/lib/attempt/observed.js +171 -0
  28. package/dist/esm/lib/attempt/policy.d.ts +45 -0
  29. package/dist/esm/lib/attempt/policy.js +83 -0
  30. package/dist/esm/lib/attempt/record.d.ts +11 -0
  31. package/dist/esm/lib/attempt/record.js +24 -0
  32. package/dist/esm/lib/attempt/retryLoopContext.d.ts +18 -0
  33. package/dist/esm/lib/attempt/retryLoopContext.js +24 -0
  34. package/dist/esm/lib/attempt/retryLoopTypes.d.ts +18 -0
  35. package/dist/esm/lib/attempt/retryLoopTypes.js +2 -0
  36. package/dist/esm/lib/attempt/runner.d.ts +155 -0
  37. package/dist/esm/lib/attempt/runner.js +503 -0
  38. package/dist/esm/lib/attempt/standalone.d.ts +47 -0
  39. package/dist/esm/lib/attempt/standalone.js +126 -0
  40. package/dist/esm/lib/attempt/types.d.ts +453 -0
  41. package/dist/esm/lib/attempt/types.js +16 -0
  42. package/dist/esm/lib/budget/index.d.ts +9 -0
  43. package/dist/esm/lib/budget/index.js +9 -0
  44. package/dist/esm/lib/budget/timeBudget.d.ts +136 -0
  45. package/dist/esm/lib/budget/timeBudget.js +666 -0
  46. package/dist/esm/lib/builder/FlowChartBuilder.d.ts +88 -3
  47. package/dist/esm/lib/builder/FlowChartBuilder.js +224 -16
  48. package/dist/esm/lib/builder/retryLoop.d.ts +56 -0
  49. package/dist/esm/lib/builder/retryLoop.js +283 -0
  50. package/dist/esm/lib/builder/types.d.ts +35 -1
  51. package/dist/esm/lib/builder/types.js +1 -1
  52. package/dist/esm/lib/decide/decide.js +2 -2
  53. package/dist/esm/lib/decide/index.d.ts +1 -1
  54. package/dist/esm/lib/decide/index.js +2 -2
  55. package/dist/esm/lib/decide/types.d.ts +3 -0
  56. package/dist/esm/lib/decide/types.js +1 -8
  57. package/dist/esm/lib/engine/graph/StageNode.d.ts +11 -1
  58. package/dist/esm/lib/engine/graph/StageNode.js +1 -1
  59. package/dist/esm/lib/engine/graph/prefixNodeTree.js +5 -1
  60. package/dist/esm/lib/engine/handlers/ResumeEntry.js +3 -1
  61. package/dist/esm/lib/engine/handlers/StageRunner.d.ts +8 -1
  62. package/dist/esm/lib/engine/handlers/StageRunner.js +36 -9
  63. package/dist/esm/lib/engine/handlers/SubflowExecutor.js +20 -4
  64. package/dist/esm/lib/engine/handlers/stageError.d.ts +7 -0
  65. package/dist/esm/lib/engine/handlers/stageError.js +11 -1
  66. package/dist/esm/lib/engine/index.d.ts +2 -2
  67. package/dist/esm/lib/engine/index.js +1 -1
  68. package/dist/esm/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +27 -13
  69. package/dist/esm/lib/engine/narrative/CombinedNarrativeRecorder.js +68 -40
  70. package/dist/esm/lib/engine/narrative/FlowRecorderDispatcher.d.ts +2 -0
  71. package/dist/esm/lib/engine/narrative/FlowRecorderDispatcher.js +14 -1
  72. package/dist/esm/lib/engine/narrative/NarrativeFlowRecorder.d.ts +22 -3
  73. package/dist/esm/lib/engine/narrative/NarrativeFlowRecorder.js +61 -9
  74. package/dist/esm/lib/engine/narrative/NullControlFlowNarrativeGenerator.d.ts +1 -0
  75. package/dist/esm/lib/engine/narrative/NullControlFlowNarrativeGenerator.js +2 -1
  76. package/dist/esm/lib/engine/narrative/formatting/sentences.d.ts +23 -0
  77. package/dist/esm/lib/engine/narrative/formatting/sentences.js +127 -1
  78. package/dist/esm/lib/engine/narrative/index.d.ts +2 -2
  79. package/dist/esm/lib/engine/narrative/index.js +1 -1
  80. package/dist/esm/lib/engine/narrative/narrativeTypes.d.ts +27 -21
  81. package/dist/esm/lib/engine/narrative/narrativeTypes.js +1 -1
  82. package/dist/esm/lib/engine/narrative/recorders/ManifestFlowRecorder.d.ts +45 -2
  83. package/dist/esm/lib/engine/narrative/recorders/ManifestFlowRecorder.js +55 -2
  84. package/dist/esm/lib/engine/narrative/recorders/index.d.ts +1 -1
  85. package/dist/esm/lib/engine/narrative/recorders/index.js +1 -1
  86. package/dist/esm/lib/engine/narrative/types.d.ts +70 -4
  87. package/dist/esm/lib/engine/narrative/types.js +1 -1
  88. package/dist/esm/lib/engine/traversal/FlowchartTraverser.d.ts +59 -19
  89. package/dist/esm/lib/engine/traversal/FlowchartTraverser.js +182 -114
  90. package/dist/esm/lib/engine/traversalContext.d.ts +7 -2
  91. package/dist/esm/lib/engine/traversalContext.js +6 -3
  92. package/dist/esm/lib/engine/types.d.ts +52 -57
  93. package/dist/esm/lib/engine/types.js +1 -1
  94. package/dist/esm/lib/{decide → filter}/evaluator.d.ts +7 -2
  95. package/dist/esm/lib/filter/evaluator.js +135 -0
  96. package/dist/esm/lib/ids/idempotencyKey.d.ts +14 -0
  97. package/dist/esm/lib/ids/idempotencyKey.js +24 -0
  98. package/dist/esm/lib/memory/StageContext.d.ts +109 -3
  99. package/dist/esm/lib/memory/StageContext.js +214 -4
  100. package/dist/esm/lib/memory/borrowedMutation.d.ts +8 -0
  101. package/dist/esm/lib/memory/borrowedMutation.js +14 -1
  102. package/dist/esm/lib/memory/frameTypes.d.ts +30 -0
  103. package/dist/esm/lib/memory/frameTypes.js +3 -1
  104. package/dist/esm/lib/memory/redaction.d.ts +12 -0
  105. package/dist/esm/lib/memory/redaction.js +54 -5
  106. package/dist/esm/lib/pause/record.js +10 -1
  107. package/dist/esm/lib/pause/types.d.ts +19 -0
  108. package/dist/esm/lib/pause/types.js +17 -1
  109. package/dist/esm/lib/reactive/createTypedScope.js +3 -1
  110. package/dist/esm/lib/reactive/types.d.ts +36 -4
  111. package/dist/esm/lib/reactive/types.js +3 -1
  112. package/dist/esm/lib/recorder/AttemptRecorder.d.ts +141 -0
  113. package/dist/esm/lib/recorder/AttemptRecorder.js +412 -0
  114. package/dist/esm/lib/recorder/ControlDepRecorder.d.ts +22 -2
  115. package/dist/esm/lib/recorder/ControlDepRecorder.js +33 -2
  116. package/dist/esm/lib/recorder/EmitRecorder.d.ts +3 -0
  117. package/dist/esm/lib/recorder/EmitRecorder.js +1 -1
  118. package/dist/esm/lib/recorder/InOutRecorder.d.ts +37 -1
  119. package/dist/esm/lib/recorder/InOutRecorder.js +75 -6
  120. package/dist/esm/lib/recorder/QualityRecorder.d.ts +32 -5
  121. package/dist/esm/lib/recorder/QualityRecorder.js +87 -29
  122. package/dist/esm/lib/recorder/TopologyRecorder.d.ts +35 -5
  123. package/dist/esm/lib/recorder/TopologyRecorder.js +76 -2
  124. package/dist/esm/lib/recorder/attemptMetricRows.d.ts +11 -0
  125. package/dist/esm/lib/recorder/attemptMetricRows.js +202 -0
  126. package/dist/esm/lib/recorder/attemptMetrics.d.ts +7 -0
  127. package/dist/esm/lib/recorder/attemptMetrics.js +165 -0
  128. package/dist/esm/lib/recorder/attemptMetricsTypes.d.ts +114 -0
  129. package/dist/esm/lib/recorder/attemptMetricsTypes.js +2 -0
  130. package/dist/esm/lib/recorder/attemptOTel.d.ts +78 -0
  131. package/dist/esm/lib/recorder/attemptOTel.js +107 -0
  132. package/dist/esm/lib/recorder/attemptSeries.d.ts +81 -0
  133. package/dist/esm/lib/recorder/attemptSeries.js +103 -0
  134. package/dist/esm/lib/recorder/hooks.d.ts +9 -0
  135. package/dist/esm/lib/recorder/hooks.js +4 -1
  136. package/dist/esm/lib/recorder/qualityTrace.d.ts +4 -1
  137. package/dist/esm/lib/recorder/qualityTrace.js +14 -6
  138. package/dist/esm/lib/runner/DeferredObserverTier.js +13 -1
  139. package/dist/esm/lib/runner/ExecutionRuntime.d.ts +54 -6
  140. package/dist/esm/lib/runner/ExecutionRuntime.js +57 -5
  141. package/dist/esm/lib/runner/FlowChartExecutor.d.ts +42 -2
  142. package/dist/esm/lib/runner/FlowChartExecutor.js +238 -45
  143. package/dist/esm/lib/runner/RunnableChart.d.ts +6 -0
  144. package/dist/esm/lib/runner/RunnableChart.js +5 -1
  145. package/dist/esm/lib/runner/attach.d.ts +2 -1
  146. package/dist/esm/lib/runner/attach.js +8 -2
  147. package/dist/esm/lib/runner/checkpoint.js +3 -1
  148. package/dist/esm/lib/runner/deadline.d.ts +42 -0
  149. package/dist/esm/lib/runner/deadline.js +90 -0
  150. package/dist/esm/lib/runner/index.d.ts +3 -1
  151. package/dist/esm/lib/runner/index.js +2 -1
  152. package/dist/esm/lib/runner/options.d.ts +17 -0
  153. package/dist/esm/lib/runner/options.js +3 -1
  154. package/dist/esm/lib/runner/recordSink.d.ts +128 -0
  155. package/dist/esm/lib/runner/recordSink.js +296 -0
  156. package/dist/esm/lib/runner/resume.d.ts +3 -0
  157. package/dist/esm/lib/runner/resume.js +22 -2
  158. package/dist/esm/lib/runner/snapshot.d.ts +2 -2
  159. package/dist/esm/lib/runner/snapshot.js +6 -2
  160. package/dist/esm/lib/scope/ScopeFacade.d.ts +118 -4
  161. package/dist/esm/lib/scope/ScopeFacade.js +304 -7
  162. package/dist/esm/lib/scope/recorders/DebugRecorder.d.ts +17 -3
  163. package/dist/esm/lib/scope/recorders/DebugRecorder.js +79 -13
  164. package/dist/esm/lib/scope/recorders/MetricRecorder.d.ts +10 -0
  165. package/dist/esm/lib/scope/recorders/MetricRecorder.js +15 -2
  166. package/dist/esm/lib/scope/runtime.d.ts +3 -0
  167. package/dist/esm/lib/scope/runtime.js +1 -1
  168. package/dist/esm/lib/scope/types.d.ts +6 -0
  169. package/dist/esm/lib/scope/types.js +1 -1
  170. package/dist/esm/lib/sinks/fileSink.d.ts +135 -0
  171. package/dist/esm/lib/sinks/fileSink.js +387 -0
  172. package/dist/esm/recorders.d.ts +8 -2
  173. package/dist/esm/recorders.js +7 -1
  174. package/dist/esm/sinks.d.ts +23 -0
  175. package/dist/esm/sinks.js +23 -0
  176. package/dist/esm/trace.d.ts +2 -2
  177. package/dist/esm/trace.js +1 -1
  178. package/dist/index.js +77 -60
  179. package/dist/lib/attempt/anySignal.js +43 -0
  180. package/dist/lib/attempt/call.js +134 -0
  181. package/dist/lib/attempt/category.js +111 -0
  182. package/dist/lib/attempt/correlation.js +186 -0
  183. package/dist/lib/attempt/deadline.js +112 -0
  184. package/dist/lib/attempt/decision.js +139 -0
  185. package/dist/lib/attempt/effect.js +174 -0
  186. package/dist/lib/attempt/errors.js +49 -0
  187. package/dist/lib/attempt/index.js +26 -0
  188. package/dist/lib/attempt/name.js +48 -0
  189. package/dist/lib/attempt/observed.js +177 -0
  190. package/dist/lib/attempt/policy.js +92 -0
  191. package/dist/lib/attempt/record.js +29 -0
  192. package/dist/lib/attempt/retryLoopContext.js +31 -0
  193. package/dist/lib/attempt/retryLoopTypes.js +3 -0
  194. package/dist/lib/attempt/runner.js +510 -0
  195. package/dist/lib/attempt/standalone.js +130 -0
  196. package/dist/lib/attempt/types.js +17 -0
  197. package/dist/lib/budget/index.js +17 -0
  198. package/dist/lib/budget/timeBudget.js +674 -0
  199. package/dist/lib/builder/FlowChartBuilder.js +224 -16
  200. package/dist/lib/builder/retryLoop.js +287 -0
  201. package/dist/lib/builder/types.js +1 -1
  202. package/dist/lib/decide/decide.js +2 -2
  203. package/dist/lib/decide/index.js +2 -2
  204. package/dist/lib/decide/types.js +1 -8
  205. package/dist/lib/engine/graph/StageNode.js +1 -1
  206. package/dist/lib/engine/graph/prefixNodeTree.js +5 -1
  207. package/dist/lib/engine/handlers/ResumeEntry.js +3 -1
  208. package/dist/lib/engine/handlers/StageRunner.js +36 -9
  209. package/dist/lib/engine/handlers/SubflowExecutor.js +20 -4
  210. package/dist/lib/engine/handlers/stageError.js +13 -2
  211. package/dist/lib/engine/index.js +1 -1
  212. package/dist/lib/engine/narrative/CombinedNarrativeRecorder.js +67 -39
  213. package/dist/lib/engine/narrative/FlowRecorderDispatcher.js +14 -1
  214. package/dist/lib/engine/narrative/NarrativeFlowRecorder.js +60 -8
  215. package/dist/lib/engine/narrative/NullControlFlowNarrativeGenerator.js +2 -1
  216. package/dist/lib/engine/narrative/formatting/sentences.js +131 -2
  217. package/dist/lib/engine/narrative/index.js +1 -1
  218. package/dist/lib/engine/narrative/narrativeTypes.js +1 -1
  219. package/dist/lib/engine/narrative/recorders/ManifestFlowRecorder.js +55 -2
  220. package/dist/lib/engine/narrative/recorders/index.js +1 -1
  221. package/dist/lib/engine/narrative/types.js +1 -1
  222. package/dist/lib/engine/traversal/FlowchartTraverser.js +181 -113
  223. package/dist/lib/engine/traversalContext.js +6 -3
  224. package/dist/lib/engine/types.js +1 -1
  225. package/dist/lib/filter/evaluator.js +139 -0
  226. package/dist/lib/ids/idempotencyKey.js +28 -0
  227. package/dist/lib/memory/StageContext.js +215 -5
  228. package/dist/lib/memory/borrowedMutation.js +16 -2
  229. package/dist/lib/memory/frameTypes.js +3 -1
  230. package/dist/lib/memory/redaction.js +54 -5
  231. package/dist/lib/pause/record.js +10 -1
  232. package/dist/lib/pause/types.js +17 -1
  233. package/dist/lib/reactive/createTypedScope.js +3 -1
  234. package/dist/lib/reactive/types.js +3 -1
  235. package/dist/lib/recorder/AttemptRecorder.js +417 -0
  236. package/dist/lib/recorder/ControlDepRecorder.js +33 -2
  237. package/dist/lib/recorder/EmitRecorder.js +1 -1
  238. package/dist/lib/recorder/InOutRecorder.js +75 -6
  239. package/dist/lib/recorder/QualityRecorder.js +87 -29
  240. package/dist/lib/recorder/TopologyRecorder.js +76 -2
  241. package/dist/lib/recorder/attemptMetricRows.js +209 -0
  242. package/dist/lib/recorder/attemptMetrics.js +174 -0
  243. package/dist/lib/recorder/attemptMetricsTypes.js +3 -0
  244. package/dist/lib/recorder/attemptOTel.js +111 -0
  245. package/dist/lib/recorder/attemptSeries.js +113 -0
  246. package/dist/lib/recorder/hooks.js +4 -1
  247. package/dist/lib/recorder/qualityTrace.js +14 -6
  248. package/dist/lib/runner/DeferredObserverTier.js +13 -1
  249. package/dist/lib/runner/ExecutionRuntime.js +57 -5
  250. package/dist/lib/runner/FlowChartExecutor.js +238 -45
  251. package/dist/lib/runner/RunnableChart.js +5 -1
  252. package/dist/lib/runner/attach.js +8 -2
  253. package/dist/lib/runner/checkpoint.js +3 -1
  254. package/dist/lib/runner/deadline.js +94 -0
  255. package/dist/lib/runner/index.js +4 -2
  256. package/dist/lib/runner/options.js +3 -1
  257. package/dist/lib/runner/recordSink.js +302 -0
  258. package/dist/lib/runner/resume.js +22 -2
  259. package/dist/lib/runner/snapshot.js +6 -2
  260. package/dist/lib/scope/ScopeFacade.js +303 -6
  261. package/dist/lib/scope/recorders/DebugRecorder.js +79 -13
  262. package/dist/lib/scope/recorders/MetricRecorder.js +15 -2
  263. package/dist/lib/scope/runtime.js +1 -1
  264. package/dist/lib/scope/types.js +1 -1
  265. package/dist/lib/sinks/fileSink.js +392 -0
  266. package/dist/recorders.js +10 -2
  267. package/dist/sinks.js +32 -0
  268. package/dist/trace.js +1 -1
  269. package/dist/types/index.d.ts +60 -2
  270. package/dist/types/lib/attempt/anySignal.d.ts +19 -0
  271. package/dist/types/lib/attempt/call.d.ts +88 -0
  272. package/dist/types/lib/attempt/category.d.ts +31 -0
  273. package/dist/types/lib/attempt/correlation.d.ts +95 -0
  274. package/dist/types/lib/attempt/deadline.d.ts +44 -0
  275. package/dist/types/lib/attempt/decision.d.ts +52 -0
  276. package/dist/types/lib/attempt/effect.d.ts +76 -0
  277. package/dist/types/lib/attempt/errors.d.ts +41 -0
  278. package/dist/types/lib/attempt/index.d.ts +18 -0
  279. package/dist/types/lib/attempt/name.d.ts +21 -0
  280. package/dist/types/lib/attempt/observed.d.ts +66 -0
  281. package/dist/types/lib/attempt/policy.d.ts +45 -0
  282. package/dist/types/lib/attempt/record.d.ts +11 -0
  283. package/dist/types/lib/attempt/retryLoopContext.d.ts +18 -0
  284. package/dist/types/lib/attempt/retryLoopTypes.d.ts +18 -0
  285. package/dist/types/lib/attempt/runner.d.ts +155 -0
  286. package/dist/types/lib/attempt/standalone.d.ts +47 -0
  287. package/dist/types/lib/attempt/types.d.ts +453 -0
  288. package/dist/types/lib/budget/index.d.ts +9 -0
  289. package/dist/types/lib/budget/timeBudget.d.ts +136 -0
  290. package/dist/types/lib/builder/FlowChartBuilder.d.ts +88 -3
  291. package/dist/types/lib/builder/retryLoop.d.ts +56 -0
  292. package/dist/types/lib/builder/types.d.ts +35 -1
  293. package/dist/types/lib/decide/index.d.ts +1 -1
  294. package/dist/types/lib/decide/types.d.ts +3 -0
  295. package/dist/types/lib/engine/graph/StageNode.d.ts +11 -1
  296. package/dist/types/lib/engine/handlers/StageRunner.d.ts +8 -1
  297. package/dist/types/lib/engine/handlers/stageError.d.ts +7 -0
  298. package/dist/types/lib/engine/index.d.ts +2 -2
  299. package/dist/types/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +27 -13
  300. package/dist/types/lib/engine/narrative/FlowRecorderDispatcher.d.ts +2 -0
  301. package/dist/types/lib/engine/narrative/NarrativeFlowRecorder.d.ts +22 -3
  302. package/dist/types/lib/engine/narrative/NullControlFlowNarrativeGenerator.d.ts +1 -0
  303. package/dist/types/lib/engine/narrative/formatting/sentences.d.ts +23 -0
  304. package/dist/types/lib/engine/narrative/index.d.ts +2 -2
  305. package/dist/types/lib/engine/narrative/narrativeTypes.d.ts +27 -21
  306. package/dist/types/lib/engine/narrative/recorders/ManifestFlowRecorder.d.ts +45 -2
  307. package/dist/types/lib/engine/narrative/recorders/index.d.ts +1 -1
  308. package/dist/types/lib/engine/narrative/types.d.ts +70 -4
  309. package/dist/types/lib/engine/traversal/FlowchartTraverser.d.ts +59 -19
  310. package/dist/types/lib/engine/traversalContext.d.ts +7 -2
  311. package/dist/types/lib/engine/types.d.ts +52 -57
  312. package/dist/types/lib/{decide → filter}/evaluator.d.ts +7 -2
  313. package/dist/types/lib/ids/idempotencyKey.d.ts +14 -0
  314. package/dist/types/lib/memory/StageContext.d.ts +109 -3
  315. package/dist/types/lib/memory/borrowedMutation.d.ts +8 -0
  316. package/dist/types/lib/memory/frameTypes.d.ts +30 -0
  317. package/dist/types/lib/memory/redaction.d.ts +12 -0
  318. package/dist/types/lib/pause/types.d.ts +19 -0
  319. package/dist/types/lib/reactive/types.d.ts +36 -4
  320. package/dist/types/lib/recorder/AttemptRecorder.d.ts +141 -0
  321. package/dist/types/lib/recorder/ControlDepRecorder.d.ts +22 -2
  322. package/dist/types/lib/recorder/EmitRecorder.d.ts +3 -0
  323. package/dist/types/lib/recorder/InOutRecorder.d.ts +37 -1
  324. package/dist/types/lib/recorder/QualityRecorder.d.ts +32 -5
  325. package/dist/types/lib/recorder/TopologyRecorder.d.ts +35 -5
  326. package/dist/types/lib/recorder/attemptMetricRows.d.ts +11 -0
  327. package/dist/types/lib/recorder/attemptMetrics.d.ts +7 -0
  328. package/dist/types/lib/recorder/attemptMetricsTypes.d.ts +114 -0
  329. package/dist/types/lib/recorder/attemptOTel.d.ts +78 -0
  330. package/dist/types/lib/recorder/attemptSeries.d.ts +81 -0
  331. package/dist/types/lib/recorder/hooks.d.ts +9 -0
  332. package/dist/types/lib/recorder/qualityTrace.d.ts +4 -1
  333. package/dist/types/lib/runner/ExecutionRuntime.d.ts +54 -6
  334. package/dist/types/lib/runner/FlowChartExecutor.d.ts +42 -2
  335. package/dist/types/lib/runner/RunnableChart.d.ts +6 -0
  336. package/dist/types/lib/runner/attach.d.ts +2 -1
  337. package/dist/types/lib/runner/deadline.d.ts +42 -0
  338. package/dist/types/lib/runner/index.d.ts +3 -1
  339. package/dist/types/lib/runner/options.d.ts +17 -0
  340. package/dist/types/lib/runner/recordSink.d.ts +128 -0
  341. package/dist/types/lib/runner/resume.d.ts +3 -0
  342. package/dist/types/lib/runner/snapshot.d.ts +2 -2
  343. package/dist/types/lib/scope/ScopeFacade.d.ts +118 -4
  344. package/dist/types/lib/scope/recorders/DebugRecorder.d.ts +17 -3
  345. package/dist/types/lib/scope/recorders/MetricRecorder.d.ts +10 -0
  346. package/dist/types/lib/scope/runtime.d.ts +3 -0
  347. package/dist/types/lib/scope/types.d.ts +6 -0
  348. package/dist/types/lib/sinks/fileSink.d.ts +135 -0
  349. package/dist/types/recorders.d.ts +8 -2
  350. package/dist/types/sinks.d.ts +23 -0
  351. package/dist/types/trace.d.ts +2 -2
  352. package/package.json +17 -3
  353. package/dist/esm/lib/decide/evaluator.js +0 -130
  354. package/dist/lib/decide/evaluator.js +0 -134
@@ -0,0 +1,52 @@
1
+ /**
2
+ * attempt/decision.ts — the ONE retry rule table and the runner's evidence builder (design §3.1, §3.8, law 9).
3
+ *
4
+ * `retryRules(policy)` is the retry-or-stop decision as ordinary `decide()` rules over `AttemptInputs`, first
5
+ * match wins, default `retry` ("retryable"):
6
+ *
7
+ * 1 outcome = ok → done succeeded
8
+ * 2 outcome = paused → stop paused
9
+ * 3 aborted = true → stop aborted (the run's signal — the attempt's outcome stays its own)
10
+ * 4 attempt ≥ of → stop exhausted
11
+ * 5 retryOn = false → stop declined (a function rule: it shows the verdict it saw)
12
+ * 6 timeLeftAfterWaitMs ≤ 0 → stop no-time-left
13
+ * default → retry retryable
14
+ *
15
+ * Each rule's `label` IS the reason it names, so `reason` is a projection of the evidence, never a second
16
+ * vocabulary. The ceiling is `attempt/policy.ts · attemptCeiling`, the one reading the engine and the runner
17
+ * share.
18
+ *
19
+ * `decideAttempt` evaluates that table WITHOUT a scope (the runner has none — `decide()` needs a registered
20
+ * one) and builds the evidence `decide()` would build: the filter rows come from `decide()`'s own evaluator
21
+ * (`filter/evaluator.ts · evaluateFilter`), the function rows and the first-match loop mirror
22
+ * `decide/decide.ts` field for field and key for key. A property test pins that both paths give equal evidence
23
+ * for equal inputs (test/lib/attempt/property).
24
+ *
25
+ * Inputs are READ, one key at a time, only when a rule reaches them — so the user's `retryOn` and `backoffMs`
26
+ * run exactly when a retry needs them, as they did before the record existed.
27
+ */
28
+ import type { DecideRule, DecisionEvidence } from '../decide/types.js';
29
+ import type { AttemptInputs, AttemptNext, AttemptReason, RetryPolicy } from './types.js';
30
+ /** The table's default: no rule stopped the series, so it retries. */
31
+ export declare const RETRY_DEFAULT: Readonly<{
32
+ readonly branch: "retry";
33
+ readonly label: "retryable";
34
+ }>;
35
+ /**
36
+ * The retry rule table for `policy` — six `decide()` rules, then {@link RETRY_DEFAULT}. The ceiling is the
37
+ * whole number of attempts the policy allows, never fewer than one (`attemptCeiling`): a ceiling of `NaN` or
38
+ * `Infinity` cannot make rule 4 unreachable.
39
+ */
40
+ export declare function retryRules(policy: Pick<RetryPolicy, 'attempts'>): DecideRule<AttemptInputs>[];
41
+ /** A decision: the evidence, and its compact projection. */
42
+ export interface AttemptDecision {
43
+ readonly evidence: DecisionEvidence;
44
+ readonly next: AttemptNext;
45
+ readonly reason: AttemptReason;
46
+ }
47
+ /**
48
+ * Evaluate `rules` (a `retryRules` table) over `read` — first match wins — and build the evidence `decide()`
49
+ * would record with the default {@link RETRY_DEFAULT}. `read(key)` returns one input; it is called only for the
50
+ * keys the evaluated rules touch, in rule order.
51
+ */
52
+ export declare function decideAttempt(rules: readonly DecideRule<AttemptInputs>[], read: (key: string) => unknown): AttemptDecision;
@@ -0,0 +1,134 @@
1
+ /**
2
+ * attempt/decision.ts — the ONE retry rule table and the runner's evidence builder (design §3.1, §3.8, law 9).
3
+ *
4
+ * `retryRules(policy)` is the retry-or-stop decision as ordinary `decide()` rules over `AttemptInputs`, first
5
+ * match wins, default `retry` ("retryable"):
6
+ *
7
+ * 1 outcome = ok → done succeeded
8
+ * 2 outcome = paused → stop paused
9
+ * 3 aborted = true → stop aborted (the run's signal — the attempt's outcome stays its own)
10
+ * 4 attempt ≥ of → stop exhausted
11
+ * 5 retryOn = false → stop declined (a function rule: it shows the verdict it saw)
12
+ * 6 timeLeftAfterWaitMs ≤ 0 → stop no-time-left
13
+ * default → retry retryable
14
+ *
15
+ * Each rule's `label` IS the reason it names, so `reason` is a projection of the evidence, never a second
16
+ * vocabulary. The ceiling is `attempt/policy.ts · attemptCeiling`, the one reading the engine and the runner
17
+ * share.
18
+ *
19
+ * `decideAttempt` evaluates that table WITHOUT a scope (the runner has none — `decide()` needs a registered
20
+ * one) and builds the evidence `decide()` would build: the filter rows come from `decide()`'s own evaluator
21
+ * (`filter/evaluator.ts · evaluateFilter`), the function rows and the first-match loop mirror
22
+ * `decide/decide.ts` field for field and key for key. A property test pins that both paths give equal evidence
23
+ * for equal inputs (test/lib/attempt/property).
24
+ *
25
+ * Inputs are READ, one key at a time, only when a rule reaches them — so the user's `retryOn` and `backoffMs`
26
+ * run exactly when a retry needs them, as they did before the record existed.
27
+ */
28
+ import { summarizeValue } from '../capture/summarize.js';
29
+ import { evaluateFilter } from '../filter/evaluator.js';
30
+ import { attemptCeiling } from './policy.js';
31
+ /** The table's default: no rule stopped the series, so it retries. */
32
+ export const RETRY_DEFAULT = Object.freeze({ branch: 'retry', label: 'retryable' });
33
+ /** `decide()`'s summary length for an evidence value (filter/evaluator.ts, decide/evidence.ts). */
34
+ const MAX_VALUE_LEN = 80;
35
+ /**
36
+ * The retry rule table for `policy` — six `decide()` rules, then {@link RETRY_DEFAULT}. The ceiling is the
37
+ * whole number of attempts the policy allows, never fewer than one (`attemptCeiling`): a ceiling of `NaN` or
38
+ * `Infinity` cannot make rule 4 unreachable.
39
+ */
40
+ export function retryRules(policy) {
41
+ return [
42
+ { when: { outcome: { eq: 'ok' } }, then: 'done', label: 'succeeded' },
43
+ { when: { outcome: { eq: 'paused' } }, then: 'stop', label: 'paused' },
44
+ { when: { aborted: { eq: true } }, then: 'stop', label: 'aborted' },
45
+ { when: { attempt: { gte: attemptCeiling(policy.attempts) } }, then: 'stop', label: 'exhausted' },
46
+ { when: (inputs) => inputs.retryOn === false, then: 'stop', label: 'declined' },
47
+ { when: { timeLeftAfterWaitMs: { lte: 0 } }, then: 'stop', label: 'no-time-left' },
48
+ ];
49
+ }
50
+ /**
51
+ * Evaluate `rules` (a `retryRules` table) over `read` — first match wins — and build the evidence `decide()`
52
+ * would record with the default {@link RETRY_DEFAULT}. `read(key)` returns one input; it is called only for the
53
+ * keys the evaluated rules touch, in rule order.
54
+ */
55
+ export function decideAttempt(rules, read) {
56
+ const evaluated = [];
57
+ for (const [index, rule] of rules.entries()) {
58
+ const evidence = evaluateRule(rule, index, read);
59
+ evaluated.push(evidence);
60
+ if (evidence.matched)
61
+ return decided(evaluated, rule.then, rule.label);
62
+ }
63
+ return decided(evaluated, RETRY_DEFAULT.branch, RETRY_DEFAULT.label);
64
+ }
65
+ function decided(rules, chosen, label) {
66
+ // decide()'s key order: rules, chosen, default, defaultLabel.
67
+ const evidence = {
68
+ rules,
69
+ chosen,
70
+ default: RETRY_DEFAULT.branch,
71
+ defaultLabel: RETRY_DEFAULT.label,
72
+ };
73
+ return { evidence, next: chosen, reason: label };
74
+ }
75
+ /** One rule, as `decide/decide.ts · evaluateRule` evaluates it — minus the scope. */
76
+ function evaluateRule(rule, index, read) {
77
+ if (typeof rule.when === 'function') {
78
+ const inputs = [];
79
+ let matched;
80
+ let matchError;
81
+ try {
82
+ matched = rule.when(readingView(read, inputs));
83
+ }
84
+ catch (error) {
85
+ matched = false;
86
+ matchError = error instanceof Error ? error.message : String(error);
87
+ }
88
+ const evidence = {
89
+ type: 'function',
90
+ ruleIndex: index,
91
+ branch: rule.then,
92
+ matched,
93
+ label: rule.label,
94
+ inputs,
95
+ ...(matchError !== undefined && { matchError }),
96
+ };
97
+ return evidence;
98
+ }
99
+ let matched = false;
100
+ let conditions = [];
101
+ let matchError;
102
+ try {
103
+ ({ matched, conditions } = evaluateFilter(read, () => false, rule.when));
104
+ }
105
+ catch (error) {
106
+ matchError = error instanceof Error ? error.message : String(error);
107
+ }
108
+ const evidence = {
109
+ type: 'filter',
110
+ ruleIndex: index,
111
+ branch: rule.then,
112
+ matched,
113
+ label: rule.label,
114
+ conditions,
115
+ ...(matchError !== undefined && { matchError }),
116
+ };
117
+ return evidence;
118
+ }
119
+ /**
120
+ * The inputs as a function rule sees them: each string-keyed read is recorded the way `decide()`'s evidence
121
+ * collector records a scope read (key, summary, not redacted — every input is a number, a name or a flag).
122
+ */
123
+ function readingView(read, inputs) {
124
+ return new Proxy({}, {
125
+ get(_target, key) {
126
+ if (typeof key !== 'string')
127
+ return undefined;
128
+ const value = read(key);
129
+ inputs.push({ key, valueSummary: summarizeValue(value, MAX_VALUE_LEN), redacted: false });
130
+ return value;
131
+ },
132
+ });
133
+ }
134
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVjaXNpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL2F0dGVtcHQvZGVjaXNpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBMEJHO0FBRUgsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBVXpELE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUN4RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRzdDLHNFQUFzRTtBQUN0RSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUcsTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsS0FBSyxFQUFFLFdBQVcsRUFBVyxDQUFDLENBQUM7QUFFN0YsbUdBQW1HO0FBQ25HLE1BQU0sYUFBYSxHQUFHLEVBQUUsQ0FBQztBQUV6Qjs7OztHQUlHO0FBQ0gsTUFBTSxVQUFVLFVBQVUsQ0FBQyxNQUFxQztJQUM5RCxPQUFPO1FBQ0wsRUFBRSxJQUFJLEVBQUUsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLEVBQUUsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxXQUFXLEVBQUU7UUFDckUsRUFBRSxJQUFJLEVBQUUsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFLEVBQUUsUUFBUSxFQUFFLEVBQUUsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxRQUFRLEVBQUU7UUFDdEUsRUFBRSxJQUFJLEVBQUUsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLEVBQUUsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxTQUFTLEVBQUU7UUFDbkUsRUFBRSxJQUFJLEVBQUUsRUFBRSxPQUFPLEVBQUUsRUFBRSxHQUFHLEVBQUUsY0FBYyxDQUFD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QUFDO1FBQ2YsQ0FBQztLQUNGLENBQUMsQ0FBQztBQUNMLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIGF0dGVtcHQvZGVjaXNpb24udHMg4oCUIHRoZSBPTkUgcmV0cnkgcnVsZSB0YWJsZSBhbmQgdGhlIHJ1bm5lcidzIGV2aWRlbmNlIGJ1aWxkZXIgKGRlc2lnbiDCpzMuMSwgwqczLjgsIGxhdyA5KS5cbiAqXG4gKiBgcmV0cnlSdWxlcyhwb2xpY3kpYCBpcyB0aGUgcmV0cnktb3Itc3RvcCBkZWNpc2lvbiBhcyBvcmRpbmFyeSBgZGVjaWRlKClgIHJ1bGVzIG92ZXIgYEF0dGVtcHRJbnB1dHNgLCBmaXJzdFxuICogbWF0Y2ggd2lucywgZGVmYXVsdCBgcmV0cnlgIChcInJldHJ5YWJsZVwiKTpcbiAqXG4gKiAgIDEgIG91dGNvbWUgPSBvayAgICAgICAgICAgICAgICAgICAg4oaSIGRvbmUgIHN1Y2NlZWRlZFxuICogICAyICBvdXRjb21lID0gcGF1c2VkICAgICAgICAgICAgICAgIOKGkiBzdG9wICBwYXVzZWRcbiAqICAgMyAgYWJvcnRlZCA9IHRydWUgICAgICAgICAgICAgICAgICDihpIgc3RvcCAgYWJvcnRlZCAgICAgICAgKHRoZSBydW4ncyBzaWduYWwg4oCUIHRoZSBhdHRlbXB0J3Mgb3V0Y29tZSBzdGF5cyBpdHMgb3duKVxuICogICA0ICBhdHRlbXB0IOKJpSBvZiAgICAgICAgICAgICAgICAgICAg4oaSIHN0b3AgIGV4aGF1c3RlZFxuICogICA1ICByZXRyeU9uID0gZmFsc2UgICAgICAgICAgICAgICAgIOKGkiBzdG9wICBkZWNsaW5lZCAgICAgICAoYSBmdW5jdGlvbiBydWxlOiBpdCBzaG93cyB0aGUgdmVyZGljdCBpdCBzYXcpXG4gKiAgIDYgIHRpbWVMZWZ0QWZ0ZXJXYWl0TXMg4omkIDAgICAgICAgICDihpIgc3RvcCAgbm8tdGltZS1sZWZ0XG4gKiAgICAgIGRlZmF1bHQgICAgICAgICAgICAgICAgICAgICAgICAg4oaSIHJldHJ5IHJldHJ5YWJsZVxuICpcbiAqIEVhY2ggcnVsZSdzIGBsYWJlbGAgSVMgdGhlIHJlYXNvbiBpdCBuYW1lcywgc28gYHJlYXNvbmAgaXMgYSBwcm9qZWN0aW9uIG9mIHRoZSBldmlkZW5jZSwgbmV2ZXIgYSBzZWNvbmRcbiAqIHZvY2FidWxhcnkuIFRoZSBjZWlsaW5nIGlzIGBhdHRlbXB0L3BvbGljeS50cyDCtyBhdHRlbXB0Q2VpbGluZ2AsIHRoZSBvbmUgcmVhZGluZyB0aGUgZW5naW5lIGFuZCB0aGUgcnVubmVyXG4gKiBzaGFyZS5cbiAqXG4gKiBgZGVjaWRlQXR0ZW1wdGAgZXZhbHVhdGVzIHRoYXQgdGFibGUgV0lUSE9VVCBhIHNjb3BlICh0aGUgcnVubmVyIGhhcyBub25lIOKAlCBgZGVjaWRlKClgIG5lZWRzIGEgcmVnaXN0ZXJlZFxuICogb25lKSBhbmQgYnVpbGRzIHRoZSBldmlkZW5jZSBgZGVjaWRlKClgIHdvdWxkIGJ1aWxkOiB0aGUgZmlsdGVyIHJvd3MgY29tZSBmcm9tIGBkZWNpZGUoKWAncyBvd24gZXZhbHVhdG9yXG4gKiAoYGZpbHRlci9ldmFsdWF0b3IudHMgwrcgZXZhbHVhdGVGaWx0ZXJgKSwgdGhlIGZ1bmN0aW9uIHJvd3MgYW5kIHRoZSBmaXJzdC1tYXRjaCBsb29wIG1pcnJvclxuICogYGRlY2lkZS9kZWNpZGUudHNgIGZpZWxkIGZvciBmaWVsZCBhbmQga2V5IGZvciBrZXkuIEEgcHJvcGVydHkgdGVzdCBwaW5zIHRoYXQgYm90aCBwYXRocyBnaXZlIGVxdWFsIGV2aWRlbmNlXG4gKiBmb3IgZXF1YWwgaW5wdXRzICh0ZXN0L2xpYi9hdHRlbXB0L3Byb3BlcnR5KS5cbiAqXG4gKiBJbnB1dHMgYXJlIFJFQUQsIG9uZSBrZXkgYXQgYSB0aW1lLCBvbmx5IHdoZW4gYSBydWxlIHJlYWNoZXMgdGhlbSDigJQgc28gdGhlIHVzZXIncyBgcmV0cnlPbmAgYW5kIGBiYWNrb2ZmTXNgXG4gKiBydW4gZXhhY3RseSB3aGVuIGEgcmV0cnkgbmVlZHMgdGhlbSwgYXMgdGhleSBkaWQgYmVmb3JlIHRoZSByZWNvcmQgZXhpc3RlZC5cbiAqL1xuXG5pbXBvcnQgeyBzdW1tYXJpemVWYWx1ZSB9IGZyb20gJy4uL2NhcHR1cmUvc3VtbWFyaXplLmpzJztcbmltcG9ydCB0eXBlIHtcbiAgRGVjaWRlUnVsZSxcbiAgRGVjaXNpb25FdmlkZW5jZSxcbiAgRmlsdGVyUnVsZUV2aWRlbmNlLFxuICBGdW5jdGlvblJ1bGVFdmlkZW5jZSxcbiAgUmVhZElucHV0LFxuICBSdWxlRXZpZGVuY2UsXG4gIFdoZXJlRmlsdGVyLFxufSBmcm9tICcuLi9kZWNpZGUvdHlwZXMuanMnO1xuaW1wb3J0IHsgZXZhbHVhdGVGaWx0ZXIgfSBmcm9tICcuLi9maWx0ZXIvZXZhbHVhdG9yLmpzJztcbmltcG9ydCB7IGF0dGVtcHRDZWlsaW5nIH0gZnJvbSAnLi9wb2xpY3kuanMnO1xuaW1wb3J0IHR5cGUgeyBBdHRlbXB0SW5wdXRzLCBBdHRlbXB0TmV4dCwgQXR0ZW1wdFJlYXNvbiwgUmV0cnlQb2xpY3kgfSBmcm9tICcuL3R5cGVzLmpzJztcblxuLyoqIFRoZSB0YWJsZSdzIGRlZmF1bHQ6IG5vIHJ1bGUgc3RvcHBlZCB0aGUgc2VyaWVzLCBzbyBpdCByZXRyaWVzLiAqL1xuZXhwb3J0IGNvbnN0IFJFVFJZX0RFRkFVTFQgPSBPYmplY3QuZnJlZXplKHsgYnJhbmNoOiAncmV0cnknLCBsYWJlbDogJ3JldHJ5YWJsZScgfSBhcyBjb25zdCk7XG5cbi8qKiBgZGVjaWRlKClgJ3Mgc3VtbWFyeSBsZW5ndGggZm9yIGFuIGV2aWRlbmNlIHZhbHVlIChmaWx0ZXIvZXZhbHVhdG9yLnRzLCBkZWNpZGUvZXZpZGVuY2UudHMpLiAqL1xuY29uc3QgTUFYX1ZBTFVFX0xFTiA9IDgwO1xuXG4vKipcbiAqIFRoZSByZXRyeSBydWxlIHRhYmxlIGZvciBgcG9saWN5YCDigJQgc2l4IGBkZWNpZGUoKWAgcnVsZXMsIHRoZW4ge0BsaW5rIFJFVFJZX0RFRkFVTFR9LiBUaGUgY2VpbGluZyBpcyB0aGVcbiAqIHdob2xlIG51bWJlciBvZiBhdHRlbXB0cyB0aGUgcG9saWN5IGFsbG93cywgbmV2ZXIgZmV3ZXIgdGhhbiBvbmUgKGBhdHRlbXB0Q2VpbGluZ2ApOiBhIGNlaWxpbmcgb2YgYE5hTmAgb3JcbiAqIGBJbmZpbml0eWAgY2Fubm90IG1ha2UgcnVsZSA0IHVucmVhY2hhYmxlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmV0cnlSdWxlcyhwb2xpY3k6IFBpY2s8UmV0cnlQb2xpY3ksICdhdHRlbXB0cyc+KTogRGVjaWRlUnVsZTxBdHRlbXB0SW5wdXRzPltdIHtcbiAgcmV0dXJuIFtcbiAgICB7IHdoZW46IHsgb3V0Y29tZTogeyBlcTogJ29rJyB9IH0sIHRoZW46ICdkb25lJywgbGFiZWw6ICdzdWNjZWVkZWQnIH0sXG4gICAgeyB3aGVuOiB7IG91dGNvbWU6IHsgZXE6ICdwYXVzZWQnIH0gfSwgdGhlbjogJ3N0b3AnLCBsYWJlbDogJ3BhdXNlZCcgfSxcbiAgICB7IHdoZW46IHsgYWJvcnRlZDogeyBlcTogdHJ1ZSB9IH0sIHRoZW46ICdzdG9wJywgbGFiZWw6ICdhYm9ydGVkJyB9LFxuICAgIHsgd2hlbjogeyBhdHRlbXB0OiB7IGd0ZTogYXR0ZW1wdENlaWxpbmcocG9saWN5LmF0dGVtcHRzKSB9IH0sIHRoZW46ICdzdG9wJywgbGFiZWw6ICdleGhhdXN0ZWQnIH0sXG4gICAgeyB3aGVuOiAoaW5wdXRzKSA9PiBpbnB1dHMucmV0cnlPbiA9PT0gZmFsc2UsIHRoZW46ICdzdG9wJywgbGFiZWw6ICdkZWNsaW5lZCcgfSxcbiAgICB7IHdoZW46IHsgdGltZUxlZnRBZnRlcldhaXRNczogeyBsdGU6IDAgfSB9LCB0aGVuOiAnc3RvcCcsIGxhYmVsOiAnbm8tdGltZS1sZWZ0JyB9LFxuICBdO1xufVxuXG4vKiogQSBkZWNpc2lvbjogdGhlIGV2aWRlbmNlLCBhbmQgaXRzIGNvbXBhY3QgcHJvamVjdGlvbi4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQXR0ZW1wdERlY2lzaW9uIHtcbiAgcmVhZG9ubHkgZXZpZGVuY2U6IERlY2lzaW9uRXZpZGVuY2U7XG4gIHJlYWRvbmx5IG5leHQ6IEF0dGVtcHROZXh0O1xuICByZWFkb25seSByZWFzb246IEF0dGVtcHRSZWFzb247XG59XG5cbi8qKlxuICogRXZhbHVhdGUgYHJ1bGVzYCAoYSBgcmV0cnlSdWxlc2AgdGFibGUpIG92ZXIgYHJlYWRgIOKAlCBmaXJzdCBtYXRjaCB3aW5zIOKAlCBhbmQgYnVpbGQgdGhlIGV2aWRlbmNlIGBkZWNpZGUoKWBcbiAqIHdvdWxkIHJlY29yZCB3aXRoIHRoZSBkZWZhdWx0IHtAbGluayBSRVRSWV9ERUZBVUxUfS4gYHJlYWQoa2V5KWAgcmV0dXJucyBvbmUgaW5wdXQ7IGl0IGlzIGNhbGxlZCBvbmx5IGZvciB0aGVcbiAqIGtleXMgdGhlIGV2YWx1YXRlZCBydWxlcyB0b3VjaCwgaW4gcnVsZSBvcmRlci5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGRlY2lkZUF0dGVtcHQoXG4gIHJ1bGVzOiByZWFkb25seSBEZWNpZGVSdWxlPEF0dGVtcHRJbnB1dHM+W10sXG4gIHJlYWQ6IChrZXk6IHN0cmluZykgPT4gdW5rbm93bixcbik6IEF0dGVtcHREZWNpc2lvbiB7XG4gIGNvbnN0IGV2YWx1YXRlZDogUnVsZUV2aWRlbmNlW10gPSBbXTtcbiAgZm9yIChjb25zdCBbaW5kZXgsIHJ1bGVdIG9mIHJ1bGVzLmVudHJpZXMoKSkge1xuICAgIGNvbnN0IGV2aWRlbmNlID0gZXZhbHVhdGVSdWxlKHJ1bGUsIGluZGV4LCByZWFkKTtcbiAgICBldmFsdWF0ZWQucHVzaChldmlkZW5jZSk7XG4gICAgaWYgKGV2aWRlbmNlLm1hdGNoZWQpIHJldHVybiBkZWNpZGVkKGV2YWx1YXRlZCwgcnVsZS50aGVuLCBydWxlLmxhYmVsKTtcbiAgfVxuICByZXR1cm4gZGVjaWRlZChldmFsdWF0ZWQsIFJFVFJZX0RFRkFVTFQuYnJhbmNoLCBSRVRSWV9ERUZBVUxULmxhYmVsKTtcbn1cblxuZnVuY3Rpb24gZGVjaWRlZChydWxlczogUnVsZUV2aWRlbmNlW10sIGNob3Nlbjogc3RyaW5nLCBsYWJlbDogc3RyaW5nIHwgdW5kZWZpbmVkKTogQXR0ZW1wdERlY2lzaW9uIHtcbiAgLy8gZGVjaWRlKCkncyBrZXkgb3JkZXI6IHJ1bGVzLCBjaG9zZW4sIGRlZmF1bHQsIGRlZmF1bHRMYWJlbC5cbiAgY29uc3QgZXZpZGVuY2U6IERlY2lzaW9uRXZpZGVuY2UgPSB7XG4gICAgcnVsZXMsXG4gICAgY2hvc2VuLFxuICAgIGRlZmF1bHQ6IFJFVFJZX0RFRkFVTFQuYnJhbmNoLFxuICAgIGRlZmF1bHRMYWJlbDogUkVUUllfREVGQVVMVC5sYWJlbCxcbiAgfTtcbiAgcmV0dXJuIHsgZXZpZGVuY2UsIG5leHQ6IGNob3NlbiBhcyBBdHRlbXB0TmV4dCwgcmVhc29uOiBsYWJlbCBhcyBBdHRlbXB0UmVhc29uIH07XG59XG5cbi8qKiBPbmUgcnVsZSwgYXMgYGRlY2lkZS9kZWNpZGUudHMgwrcgZXZhbHVhdGVSdWxlYCBldmFsdWF0ZXMgaXQg4oCUIG1pbnVzIHRoZSBzY29wZS4gKi9cbmZ1bmN0aW9uIGV2YWx1YXRlUnVsZShydWxlOiBEZWNpZGVSdWxlPEF0dGVtcHRJbnB1dHM+LCBpbmRleDogbnVtYmVyLCByZWFkOiAoa2V5OiBzdHJpbmcpID0+IHVua25vd24pOiBSdWxlRXZpZGVuY2Uge1xuICBpZiAodHlwZW9mIHJ1bGUud2hlbiA9PT0gJ2Z1bmN0aW9uJykge1xuICAgIGNvbnN0IGlucHV0czogUmVhZElucHV0W10gPSBbXTtcbiAgICBsZXQgbWF0Y2hlZDogYm9vbGVhbjtcbiAgICBsZXQgbWF0Y2hFcnJvcjogc3RyaW5nIHwgdW5kZWZpbmVkO1xuICAgIHRyeSB7XG4gICAgICBtYXRjaGVkID0gcnVsZS53aGVuKHJlYWRpbmdWaWV3KHJlYWQsIGlucHV0cykpO1xuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICBtYXRjaGVkID0gZmFsc2U7XG4gICAgICBtYXRjaEVycm9yID0gZXJyb3IgaW5zdGFuY2VvZiBFcnJvciA/IGVycm9yLm1lc3NhZ2UgOiBTdHJpbmcoZXJyb3IpO1xuICAgIH1cbiAgICBjb25zdCBldmlkZW5jZTogRnVuY3Rpb25SdWxlRXZpZGVuY2UgPSB7XG4gICAgICB0eXBlOiAnZnVuY3Rpb24nLFxuICAgICAgcnVsZUluZGV4OiBpbmRleCxcbiAgICAgIGJyYW5jaDogcnVsZS50aGVuLFxuICAgICAgbWF0Y2hlZCxcbiAgICAgIGxhYmVsOiBydWxlLmxhYmVsLFxuICAgICAgaW5wdXRzLFxuICAgICAgLi4uKG1hdGNoRXJyb3IgIT09IHVuZGVmaW5lZCAmJiB7IG1hdGNoRXJyb3IgfSksXG4gICAgfTtcbiAgICByZXR1cm4gZXZpZGVuY2U7XG4gIH1cbiAgbGV0IG1hdGNoZWQgPSBmYWxzZTtcbiAgbGV0IGNvbmRpdGlvbnM6IEZpbHRlclJ1bGVFdmlkZW5jZVsnY29uZGl0aW9ucyddID0gW107XG4gIGxldCBtYXRjaEVycm9yOiBzdHJpbmcgfCB1bmRlZmluZWQ7XG4gIHRyeSB7XG4gICAgKHsgbWF0Y2hlZCwgY29uZGl0aW9ucyB9ID0gZXZhbHVhdGVGaWx0ZXIocmVhZCwgKCkgPT4gZmFsc2UsIHJ1bGUud2hlbiBhcyBXaGVyZUZpbHRlcjxBdHRlbXB0SW5wdXRzPikpO1xuICB9IGNhdGNoIChlcnJvcikge1xuICAgIG1hdGNoRXJyb3IgPSBlcnJvciBpbnN0YW5jZW9mIEVycm9yID8gZXJyb3IubWVzc2FnZSA6IFN0cmluZyhlcnJvcik7XG4gIH1cbiAgY29uc3QgZXZpZGVuY2U6IEZpbHRlclJ1bGVFdmlkZW5jZSA9IHtcbiAgICB0eXBlOiAnZmlsdGVyJyxcbiAgICBydWxlSW5kZXg6IGluZGV4LFxuICAgIGJyYW5jaDogcnVsZS50aGVuLFxuICAgIG1hdGNoZWQsXG4gICAgbGFiZWw6IHJ1bGUubGFiZWwsXG4gICAgY29uZGl0aW9ucyxcbiAgICAuLi4obWF0Y2hFcnJvciAhPT0gdW5kZWZpbmVkICYmIHsgbWF0Y2hFcnJvciB9KSxcbiAgfTtcbiAgcmV0dXJuIGV2aWRlbmNlO1xufVxuXG4vKipcbiAqIFRoZSBpbnB1dHMgYXMgYSBmdW5jdGlvbiBydWxlIHNlZXMgdGhlbTogZWFjaCBzdHJpbmcta2V5ZWQgcmVhZCBpcyByZWNvcmRlZCB0aGUgd2F5IGBkZWNpZGUoKWAncyBldmlkZW5jZVxuICogY29sbGVjdG9yIHJlY29yZHMgYSBzY29wZSByZWFkIChrZXksIHN1bW1hcnksIG5vdCByZWRhY3RlZCDigJQgZXZlcnkgaW5wdXQgaXMgYSBudW1iZXIsIGEgbmFtZSBvciBhIGZsYWcpLlxuICovXG5mdW5jdGlvbiByZWFkaW5nVmlldyhyZWFkOiAoa2V5OiBzdHJpbmcpID0+IHVua25vd24sIGlucHV0czogUmVhZElucHV0W10pOiBBdHRlbXB0SW5wdXRzIHtcbiAgcmV0dXJuIG5ldyBQcm94eSh7fSBhcyBBdHRlbXB0SW5wdXRzLCB7XG4gICAgZ2V0KF90YXJnZXQsIGtleSkge1xuICAgICAgaWYgKHR5cGVvZiBrZXkgIT09ICdzdHJpbmcnKSByZXR1cm4gdW5kZWZpbmVkO1xuICAgICAgY29uc3QgdmFsdWUgPSByZWFkKGtleSk7XG4gICAgICBpbnB1dHMucHVzaCh7IGtleSwgdmFsdWVTdW1tYXJ5OiBzdW1tYXJpemVWYWx1ZSh2YWx1ZSwgTUFYX1ZBTFVFX0xFTiksIHJlZGFjdGVkOiBmYWxzZSB9KTtcbiAgICAgIHJldHVybiB2YWx1ZTtcbiAgICB9LFxuICB9KTtcbn1cbiJdfQ==
@@ -0,0 +1,76 @@
1
+ /**
2
+ * attempt/effect.ts — side-effect safety (design §3.3, packet P3): the ONE reading of what an attempt did to an
3
+ * outside system, and the ONE rule for a touching target.
4
+ *
5
+ * - `touchesProblem` — the build law, asked at every door a touching declaration enters: the builder
6
+ * (`FlowChartBuilder · applyTouches` / `applyRetryPolicy`), the traverser for a StageNode a stage returns at run
7
+ * time (`FlowchartTraverser · admitDynamicNodes`), and the stage itself (`FlowchartTraverser · executeStage`, for
8
+ * a chart edited after `build()`). A touching target that may retry without an idempotency key is refused: a
9
+ * retry of a non-idempotent effect without one can apply it twice.
10
+ * - `callTouches` — the same law for `scope.$call(target, fn, policy, { touches, idempotencyKey })`.
11
+ * - `admitIdempotencyKey` — the key's format: 1–255 printable ASCII characters, no space. It travels in a request
12
+ * header (`Idempotency-Key`), so a control character could forge one; the refusal names the field, never the
13
+ * value.
14
+ * - `effectOf` — `ok → 'applied'`; a failure whose error declares `effect: 'none'` → `'none'`; anything else →
15
+ * `'unknown'`. A timeout is the absence of an answer (law 4), so it is never `'none'`.
16
+ * - `unknownEffectError` — what a series that ends without an answer after ANY attempt of unknown effect fails
17
+ * with, in place of the attempt's own error (its `cause`).
18
+ * - `interruptProblem` — a keyless touching stage may not be re-run by an `interrupt()` resume.
19
+ */
20
+ import { UnknownEffectError } from './errors.js';
21
+ import type { AttemptEffect, AttemptOutcome, AttemptRecord, RetryPolicy, StageTouches } from './types.js';
22
+ export { MAX_IDEMPOTENCY_KEY_LENGTH } from '../ids/idempotencyKey.js';
23
+ /**
24
+ * What a touching runner series is told (`AttemptRunOptions.effect`): the system, the REAL key the attempts are made
25
+ * under, and the key as records carry it (the run's served form; the real one when no rule applies).
26
+ */
27
+ export interface EffectTarget {
28
+ readonly system: string;
29
+ readonly idempotencyKey?: string;
30
+ readonly recordedKey?: string;
31
+ }
32
+ /**
33
+ * Why a touching declaration is refused, or `undefined` when it is admitted: `touches` must be `{ system,
34
+ * idempotencyKey? }` with `system` a name and the key rule a function; and a target that may retry (`retry`'s
35
+ * ceiling above 1) must declare the key rule.
36
+ */
37
+ export declare function touchesProblem(touches: unknown, retry: Pick<RetryPolicy, 'attempts'> | undefined): string | undefined;
38
+ /** `value` as an idempotency key (`ids/idempotencyKey.ts`, the one rule), or a `TypeError` that names `where`. */
39
+ export declare function admitIdempotencyKey(where: string, value: unknown): string;
40
+ /**
41
+ * A `$call`'s side-effect declaration, admitted: `undefined` when it touches nothing; otherwise the system and the
42
+ * key, refused with a `TypeError` naming `where` when malformed, when a key comes without a system, or when the
43
+ * call may retry with no key — before anything is sent.
44
+ */
45
+ export declare function callTouches(where: string, options: unknown, policy: Pick<RetryPolicy, 'attempts'>): {
46
+ readonly system: string;
47
+ readonly idempotencyKey?: string;
48
+ } | undefined;
49
+ /** What an attempt that ended `outcome` (with `error`, when it failed) did to the outside system. */
50
+ export declare function effectOf(outcome: AttemptOutcome, error: unknown): AttemptEffect;
51
+ /**
52
+ * What a touching series fails with when any of its attempts left the effect unknown — never the attempt's own error,
53
+ * which a caller would read as a failure and retry. The key is the RECORDED one: under a redaction rule that names
54
+ * it, the error carries the placeholder, as every record does.
55
+ */
56
+ export declare function unknownEffectError(target: EffectTarget, record: AttemptRecord, cause: unknown): UnknownEffectError;
57
+ /** The key as records carry it: the served form when the caller gave one, else the key itself. */
58
+ export declare function recordedKeyOf(target: EffectTarget): string | undefined;
59
+ /** The runner's refusal of a touching series that may retry with no key — the law, at the last door. */
60
+ export declare function refuseKeylessRetry(target: EffectTarget, attempts: number): void;
61
+ /**
62
+ * Why a touching stage may not be RE-RUN by an `interrupt()` resume, or `undefined` when it may (P3). A resume
63
+ * re-runs the stage's function from its top — a second attempt of its effect — so the law that refuses a keyless
64
+ * retry refuses a keyless re-run too. Asked when the stage interrupts (`StageRunner`) and when a checkpoint is
65
+ * resumed (`runner/resume.ts · planResume`, for a checkpoint made by another version of the chart).
66
+ */
67
+ export declare function interruptProblem(touches: StageTouches | undefined): string | undefined;
68
+ /**
69
+ * The stand-in's declaration on a resume (P3): the paused stage's system, answering the key its checkpoint carried —
70
+ * the OPERATIONAL value, real (checkpoints are exempt from redaction by law). It is marked, so the run serves it
71
+ * like a key of unknown sources: under any state rule the records carry the placeholder (`isCarriedTouches`) — the
72
+ * resumed leg no longer holds the input the key was made of, so it cannot tell whether the key was masked.
73
+ */
74
+ export declare function carriedTouches(system: string, key: string): StageTouches;
75
+ /** The declaration answers a key a checkpoint carried ({@link carriedTouches}). */
76
+ export declare function isCarriedTouches(touches: unknown): boolean;
@@ -0,0 +1,160 @@
1
+ /**
2
+ * attempt/effect.ts — side-effect safety (design §3.3, packet P3): the ONE reading of what an attempt did to an
3
+ * outside system, and the ONE rule for a touching target.
4
+ *
5
+ * - `touchesProblem` — the build law, asked at every door a touching declaration enters: the builder
6
+ * (`FlowChartBuilder · applyTouches` / `applyRetryPolicy`), the traverser for a StageNode a stage returns at run
7
+ * time (`FlowchartTraverser · admitDynamicNodes`), and the stage itself (`FlowchartTraverser · executeStage`, for
8
+ * a chart edited after `build()`). A touching target that may retry without an idempotency key is refused: a
9
+ * retry of a non-idempotent effect without one can apply it twice.
10
+ * - `callTouches` — the same law for `scope.$call(target, fn, policy, { touches, idempotencyKey })`.
11
+ * - `admitIdempotencyKey` — the key's format: 1–255 printable ASCII characters, no space. It travels in a request
12
+ * header (`Idempotency-Key`), so a control character could forge one; the refusal names the field, never the
13
+ * value.
14
+ * - `effectOf` — `ok → 'applied'`; a failure whose error declares `effect: 'none'` → `'none'`; anything else →
15
+ * `'unknown'`. A timeout is the absence of an answer (law 4), so it is never `'none'`.
16
+ * - `unknownEffectError` — what a series that ends without an answer after ANY attempt of unknown effect fails
17
+ * with, in place of the attempt's own error (its `cause`).
18
+ * - `interruptProblem` — a keyless touching stage may not be re-run by an `interrupt()` resume.
19
+ */
20
+ import { idempotencyKeyProblem } from '../ids/idempotencyKey.js';
21
+ import { UnknownEffectError } from './errors.js';
22
+ import { attemptNameProblem } from './name.js';
23
+ import { attemptCeiling } from './policy.js';
24
+ export { MAX_IDEMPOTENCY_KEY_LENGTH } from '../ids/idempotencyKey.js';
25
+ /** Why `retry` with `touches` breaks the law — the shared words of every door. */
26
+ function retriedWithoutKey(system, attempts) {
27
+ return (`touches "${system}" and may retry (attempts: ${attempts}) but declares no idempotencyKey — a retry of an ` +
28
+ 'outside effect without a key can apply it twice. Declare the key rule ' +
29
+ `(.touches('${system}', { idempotencyKey: ({ args }) => \`order-\${args.orderId}\` })), or retry once.`);
30
+ }
31
+ /**
32
+ * Why a touching declaration is refused, or `undefined` when it is admitted: `touches` must be `{ system,
33
+ * idempotencyKey? }` with `system` a name and the key rule a function; and a target that may retry (`retry`'s
34
+ * ceiling above 1) must declare the key rule.
35
+ */
36
+ export function touchesProblem(touches, retry) {
37
+ if (touches === null || typeof touches !== 'object') {
38
+ return 'touches must be { system, idempotencyKey? } — the outside system and the key rule';
39
+ }
40
+ const { system, idempotencyKey } = touches;
41
+ const nameProblem = attemptNameProblem(system);
42
+ if (nameProblem !== undefined)
43
+ return `touches.system ${nameProblem} — it is a name from code, never a value`;
44
+ if (idempotencyKey !== undefined && typeof idempotencyKey !== 'function') {
45
+ return ('touches.idempotencyKey must be a function of the execution ((ctx) => string) — a constant key would make ' +
46
+ 'every run one operation');
47
+ }
48
+ const attempts = attemptCeiling(retry?.attempts);
49
+ if (attempts > 1 && idempotencyKey === undefined)
50
+ return retriedWithoutKey(system, attempts);
51
+ return undefined;
52
+ }
53
+ /** `value` as an idempotency key (`ids/idempotencyKey.ts`, the one rule), or a `TypeError` that names `where`. */
54
+ export function admitIdempotencyKey(where, value) {
55
+ const problem = idempotencyKeyProblem(value);
56
+ if (problem !== undefined) {
57
+ throw new TypeError(`${where}: idempotencyKey ${problem} (derive it from the input or the state, never from model output)`);
58
+ }
59
+ return value;
60
+ }
61
+ /**
62
+ * A `$call`'s side-effect declaration, admitted: `undefined` when it touches nothing; otherwise the system and the
63
+ * key, refused with a `TypeError` naming `where` when malformed, when a key comes without a system, or when the
64
+ * call may retry with no key — before anything is sent.
65
+ */
66
+ export function callTouches(where, options, policy) {
67
+ if (options === undefined)
68
+ return undefined;
69
+ if (options === null || typeof options !== 'object') {
70
+ throw new TypeError(`${where}: options must be { touches?, idempotencyKey? }`);
71
+ }
72
+ const { touches, idempotencyKey } = options;
73
+ if (touches === undefined) {
74
+ if (idempotencyKey !== undefined) {
75
+ throw new TypeError(`${where}: an idempotencyKey names an effect — declare the system it touches (touches)`);
76
+ }
77
+ return undefined;
78
+ }
79
+ const nameProblem = attemptNameProblem(touches);
80
+ if (nameProblem !== undefined) {
81
+ throw new TypeError(`${where}: touches ${nameProblem} — it is a name from code, never a value`);
82
+ }
83
+ const key = idempotencyKey === undefined ? undefined : admitIdempotencyKey(where, idempotencyKey);
84
+ const attempts = attemptCeiling(policy.attempts);
85
+ if (attempts > 1 && key === undefined)
86
+ throw new TypeError(`${where}: ${retriedWithoutKey(touches, attempts)}`);
87
+ return { system: touches, ...(key !== undefined && { idempotencyKey: key }) };
88
+ }
89
+ /** What an attempt that ended `outcome` (with `error`, when it failed) did to the outside system. */
90
+ export function effectOf(outcome, error) {
91
+ if (outcome === 'ok')
92
+ return 'applied';
93
+ if (outcome === 'failed' && declaresNoEffect(error))
94
+ return 'none';
95
+ return 'unknown';
96
+ }
97
+ /** The error itself says nothing was sent — `effect: 'none'`, read once; a value that cannot be read says nothing. */
98
+ function declaresNoEffect(error) {
99
+ if (error === null || typeof error !== 'object')
100
+ return false;
101
+ try {
102
+ return error.effect === 'none';
103
+ }
104
+ catch {
105
+ return false;
106
+ }
107
+ }
108
+ /**
109
+ * What a touching series fails with when any of its attempts left the effect unknown — never the attempt's own error,
110
+ * which a caller would read as a failure and retry. The key is the RECORDED one: under a redaction rule that names
111
+ * it, the error carries the placeholder, as every record does.
112
+ */
113
+ export function unknownEffectError(target, record, cause) {
114
+ return new UnknownEffectError({
115
+ system: target.system,
116
+ ...(recordedKeyOf(target) !== undefined && { idempotencyKey: recordedKeyOf(target) }),
117
+ attempts: record.attempt,
118
+ cause,
119
+ });
120
+ }
121
+ /** The key as records carry it: the served form when the caller gave one, else the key itself. */
122
+ export function recordedKeyOf(target) {
123
+ return target.recordedKey ?? target.idempotencyKey;
124
+ }
125
+ /** The runner's refusal of a touching series that may retry with no key — the law, at the last door. */
126
+ export function refuseKeylessRetry(target, attempts) {
127
+ if (attempts > 1 && target.idempotencyKey === undefined) {
128
+ throw new TypeError(`[footprint] ${retriedWithoutKey(target.system, attempts)}`);
129
+ }
130
+ }
131
+ /**
132
+ * Why a touching stage may not be RE-RUN by an `interrupt()` resume, or `undefined` when it may (P3). A resume
133
+ * re-runs the stage's function from its top — a second attempt of its effect — so the law that refuses a keyless
134
+ * retry refuses a keyless re-run too. Asked when the stage interrupts (`StageRunner`) and when a checkpoint is
135
+ * resumed (`runner/resume.ts · planResume`, for a checkpoint made by another version of the chart).
136
+ */
137
+ export function interruptProblem(touches) {
138
+ if (touches === undefined || touches.idempotencyKey !== undefined)
139
+ return undefined;
140
+ return (`touches "${touches.system}" with no idempotencyKey, and a resume after interrupt() re-runs the stage from its ` +
141
+ 'top — a second attempt of the effect without a key. Declare the key rule, or interrupt in a stage of its own.');
142
+ }
143
+ /** The touching declarations `resume()` builds around a key a checkpoint carried (`carriedTouches`). */
144
+ const CARRIED = new WeakSet();
145
+ /**
146
+ * The stand-in's declaration on a resume (P3): the paused stage's system, answering the key its checkpoint carried —
147
+ * the OPERATIONAL value, real (checkpoints are exempt from redaction by law). It is marked, so the run serves it
148
+ * like a key of unknown sources: under any state rule the records carry the placeholder (`isCarriedTouches`) — the
149
+ * resumed leg no longer holds the input the key was made of, so it cannot tell whether the key was masked.
150
+ */
151
+ export function carriedTouches(system, key) {
152
+ const touches = Object.freeze({ system, idempotencyKey: () => key });
153
+ CARRIED.add(touches);
154
+ return touches;
155
+ }
156
+ /** The declaration answers a key a checkpoint carried ({@link carriedTouches}). */
157
+ export function isCarriedTouches(touches) {
158
+ return typeof touches === 'object' && touches !== null && CARRIED.has(touches);
159
+ }
160
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZWZmZWN0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9hdHRlbXB0L2VmZmVjdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBa0JHO0FBRUgsT0FBTyxFQUFFLHFCQUFxQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDakUsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQ2pELE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUMvQyxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRzdDLE9BQU8sRUFBRSwwQkFBMEIsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBWXRFLGtGQUFrRjtBQUNsRixTQUFTLGlCQUFpQixDQUFDLE1BQWMsRUFBRSxRQUFnQjtJQUN6RCxPQUFPLENBQ0wsWUFBWSxNQUFNLDhCQUE4QixRQUFRLG1EQUFtRDtRQUMzRyx3RUFBd0U7UUFDeEUsY0FBYyxNQUFNLG1GQUFtRixDQUN4RyxDQUFDO0FBQ0osQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsY0FBYyxDQUFDLE9BQWdCLEVBQUUsS0FBZ0Q7SUFDL0YsSUFBSSxPQUFPLEtBQUssSUFBSSxJQUFJLE9BQU8sT0FBTyxLQUFLLFFBQVEsRUFBRSxDQUFDO1FBQ3BELE9BQU8sbUZBQW1GLENBQUM7SUFDN0YsQ0FBQztJQUNELE1BQU0sRUFBRSxNQUFNLEVBQUUsY0FBYyxFQUFFLEdBQUcsT0FBZ0MsQ0FBQztJQUNwRSxNQUFNLFdBQVcsR0FBRyxrQkFBa0IsQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUMvQyxJQUFJLFdBQVcsS0FBSyxTQUFTO1FBQUUsT0FBTyxrQkFBa0IsV0FBVywwQ0FBMEMsQ0FBQztJQUM5RyxJQUFJLGNBQWMsS0FBSyxTQUFTLElBQUksT0FBTyxjQUFjLEtBQUssVUFBVSxFQUFFLENBQUM7UUFDekUsT0FB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TyxDQUNMLFlBQVksT0FBTyxDQUFDLE1BQU0sc0ZBQXNGO1FBQ2hILCtHQUErRyxDQUNoSCxDQUFDO0FBQ0osQ0FBQztBQUVELHdHQUF3RztBQUN4RyxNQUFNLE9BQU8sR0FBRyxJQUFJLE9BQU8sRUFBVSxDQUFDO0FBRXRDOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLGNBQWMsQ0FBQyxNQUFjLEVBQUUsR0FBVztJQUN4RCxNQUFNLE9BQU8sR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsTUFBTSxFQUFFLGNBQWMsRUFBRSxHQUFHLEVBQUUsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxDQUFDO0lBQ3JFLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDckIsT0FBTyxPQUFPLENBQUM7QUFDakIsQ0FBQztBQUVELG1GQUFtRjtBQUNuRixNQUFNLFVBQVUsZ0JBQWdCLENBQUMsT0FBZ0I7SUFDL0MsT0FBTyxPQUFPLE9BQU8sS0FBSyxRQUFRLElBQUksT0FBTyxLQUFLLElBQUksSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0FBQ2pGLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIGF0dGVtcHQvZWZmZWN0LnRzIOKAlCBzaWRlLWVmZmVjdCBzYWZldHkgKGRlc2lnbiDCpzMuMywgcGFja2V0IFAzKTogdGhlIE9ORSByZWFkaW5nIG9mIHdoYXQgYW4gYXR0ZW1wdCBkaWQgdG8gYW5cbiAqIG91dHNpZGUgc3lzdGVtLCBhbmQgdGhlIE9ORSBydWxlIGZvciBhIHRvdWNoaW5nIHRhcmdldC5cbiAqXG4gKiAgIC0gYHRvdWNoZXNQcm9ibGVtYCDigJQgdGhlIGJ1aWxkIGxhdywgYXNrZWQgYXQgZXZlcnkgZG9vciBhIHRvdWNoaW5nIGRlY2xhcmF0aW9uIGVudGVyczogdGhlIGJ1aWxkZXJcbiAqICAgICAoYEZsb3dDaGFydEJ1aWxkZXIgwrcgYXBwbHlUb3VjaGVzYCAvIGBhcHBseVJldHJ5UG9saWN5YCksIHRoZSB0cmF2ZXJzZXIgZm9yIGEgU3RhZ2VOb2RlIGEgc3RhZ2UgcmV0dXJucyBhdCBydW5cbiAqICAgICB0aW1lIChgRmxvd2NoYXJ0VHJhdmVyc2VyIMK3IGFkbWl0RHluYW1pY05vZGVzYCksIGFuZCB0aGUgc3RhZ2UgaXRzZWxmIChgRmxvd2NoYXJ0VHJhdmVyc2VyIMK3IGV4ZWN1dGVTdGFnZWAsIGZvclxuICogICAgIGEgY2hhcnQgZWRpdGVkIGFmdGVyIGBidWlsZCgpYCkuIEEgdG91Y2hpbmcgdGFyZ2V0IHRoYXQgbWF5IHJldHJ5IHdpdGhvdXQgYW4gaWRlbXBvdGVuY3kga2V5IGlzIHJlZnVzZWQ6IGFcbiAqICAgICByZXRyeSBvZiBhIG5vbi1pZGVtcG90ZW50IGVmZmVjdCB3aXRob3V0IG9uZSBjYW4gYXBwbHkgaXQgdHdpY2UuXG4gKiAgIC0gYGNhbGxUb3VjaGVzYCDigJQgdGhlIHNhbWUgbGF3IGZvciBgc2NvcGUuJGNhbGwodGFyZ2V0LCBmbiwgcG9saWN5LCB7IHRvdWNoZXMsIGlkZW1wb3RlbmN5S2V5IH0pYC5cbiAqICAgLSBgYWRtaXRJZGVtcG90ZW5jeUtleWAg4oCUIHRoZSBrZXkncyBmb3JtYXQ6IDHigJMyNTUgcHJpbnRhYmxlIEFTQ0lJIGNoYXJhY3RlcnMsIG5vIHNwYWNlLiBJdCB0cmF2ZWxzIGluIGEgcmVxdWVzdFxuICogICAgIGhlYWRlciAoYElkZW1wb3RlbmN5LUtleWApLCBzbyBhIGNvbnRyb2wgY2hhcmFjdGVyIGNvdWxkIGZvcmdlIG9uZTsgdGhlIHJlZnVzYWwgbmFtZXMgdGhlIGZpZWxkLCBuZXZlciB0aGVcbiAqICAgICB2YWx1ZS5cbiAqICAgLSBgZWZmZWN0T2ZgIOKAlCBgb2sg4oaSICdhcHBsaWVkJ2A7IGEgZmFpbHVyZSB3aG9zZSBlcnJvciBkZWNsYXJlcyBgZWZmZWN0OiAnbm9uZSdgIOKGkiBgJ25vbmUnYDsgYW55dGhpbmcgZWxzZSDihpJcbiAqICAgICBgJ3Vua25vd24nYC4gQSB0aW1lb3V0IGlzIHRoZSBhYnNlbmNlIG9mIGFuIGFuc3dlciAobGF3IDQpLCBzbyBpdCBpcyBuZXZlciBgJ25vbmUnYC5cbiAqICAgLSBgdW5rbm93bkVmZmVjdEVycm9yYCDigJQgd2hhdCBhIHNlcmllcyB0aGF0IGVuZHMgd2l0aG91dCBhbiBhbnN3ZXIgYWZ0ZXIgQU5ZIGF0dGVtcHQgb2YgdW5rbm93biBlZmZlY3QgZmFpbHNcbiAqICAgICB3aXRoLCBpbiBwbGFjZSBvZiB0aGUgYXR0ZW1wdCdzIG93biBlcnJvciAoaXRzIGBjYXVzZWApLlxuICogICAtIGBpbnRlcnJ1cHRQcm9ibGVtYCDigJQgYSBrZXlsZXNzIHRvdWNoaW5nIHN0YWdlIG1heSBub3QgYmUgcmUtcnVuIGJ5IGFuIGBpbnRlcnJ1cHQoKWAgcmVzdW1lLlxuICovXG5cbmltcG9ydCB7IGlkZW1wb3RlbmN5S2V5UHJvYmxlbSB9IGZyb20gJy4uL2lkcy9pZGVtcG90ZW5jeUtleS5qcyc7XG5pbXBvcnQgeyBVbmtub3duRWZmZWN0RXJyb3IgfSBmcm9tICcuL2Vycm9ycy5qcyc7XG5pbXBvcnQgeyBhdHRlbXB0TmFtZVByb2JsZW0gfSBmcm9tICcuL25hbWUuanMnO1xuaW1wb3J0IHsgYXR0ZW1wdENlaWxpbmcgfSBmcm9tICcuL3BvbGljeS5qcyc7XG5pbXBvcnQgdHlwZSB7IEF0dGVtcHRFZmZlY3QsIEF0dGVtcHRPdXRjb21lLCBBdHRlbXB0UmVjb3JkLCBDYWxsT3B0aW9ucywgUmV0cnlQb2xpY3ksIFN0YWdlVG91Y2hlcyB9IGZyb20gJy4vdHlwZXMuanMnO1xuXG5leHBvcnQgeyBNQVhfSURFTVBPVEVOQ1lfS0VZX0xFTkdUSCB9IGZyb20gJy4uL2lkcy9pZGVtcG90ZW5jeUtleS5qcyc7XG5cbi8qKlxuICogV2hhdCBhIHRvdWNoaW5nIHJ1bm5lciBzZXJpZXMgaXMgdG9sZCAoYEF0dGVtcHRSdW5PcHRpb25zLmVmZmVjdGApOiB0aGUgc3lzdGVtLCB0aGUgUkVBTCBrZXkgdGhlIGF0dGVtcHRzIGFyZSBtYWRlXG4gKiB1bmRlciwgYW5kIHRoZSBrZXkgYXMgcmVjb3JkcyBjYXJyeSBpdCAodGhlIHJ1bidzIHNlcnZlZCBmb3JtOyB0aGUgcmVhbCBvbmUgd2hlbiBubyBydWxlIGFwcGxpZXMpLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEVmZmVjdFRhcmdldCB7XG4gIHJlYWRvbmx5IHN5c3RlbTogc3RyaW5nO1xuICByZWFkb25seSBpZGVtcG90ZW5jeUtleT86IHN0cmluZztcbiAgcmVhZG9ubHkgcmVjb3JkZWRLZXk/OiBzdHJpbmc7XG59XG5cbi8qKiBXaHkgYHJldHJ5YCB3aXRoIGB0b3VjaGVzYCBicmVha3MgdGhlIGxhdyDigJQgdGhlIHNoYXJlZCB3b3JkcyBvZiBldmVyeSBkb29yLiAqL1xuZnVuY3Rpb24gcmV0cmllZFdpdGhvdXRLZXkoc3lzdGVtOiBzdHJpbmcsIGF0dGVtcHRzOiBudW1iZXIpOiBzdHJpbmcge1xuICByZXR1cm4gKFxuICAgIGB0b3VjaGVzIFwiJHtzeXN0ZW19XCIgYW5kIG1heSByZXRyeSAoYXR0ZW1wdHM6ICR7YXR0ZW1wdHN9KSBidXQgZGVjbGFyZXMgbm8gaWRlbXBvdGVuY3lLZXkg4oCUIGEgcmV0cnkgb2YgYW4gYCArXG4gICAgJ291dHNpZGUgZWZmZWN0IHdpdGhvdXQgYSBrZXkgY2FuIGFwcGx5IGl0IHR3aWNlLiBEZWNsYXJlIHRoZSBrZXkgcnVsZSAnICtcbiAgICBgKC50b3VjaGVzKCcke3N5c3RlbX0nLCB7IGlkZW1wb3RlbmN5S2V5OiAoeyBhcmdzIH0pID0+IFxcYG9yZGVyLVxcJHthcmdzLm9yZGVySWR9XFxgIH0pKSwgb3IgcmV0cnkgb25jZS5gXG4gICk7XG59XG5cbi8qKlxuICogV2h5IGEgdG91Y2hpbmcgZGVjbGFyYXRpb24gaXMgcmVmdXNlZCwgb3IgYHVuZGVmaW5lZGAgd2hlbiBpdCBpcyBhZG1pdHRlZDogYHRvdWNoZXNgIG11c3QgYmUgYHsgc3lzdGVtLFxuICogaWRlbXBvdGVuY3lLZXk/IH1gIHdpdGggYHN5c3RlbWAgYSBuYW1lIGFuZCB0aGUga2V5IHJ1bGUgYSBmdW5jdGlvbjsgYW5kIGEgdGFyZ2V0IHRoYXQgbWF5IHJldHJ5IChgcmV0cnlgJ3NcbiAqIGNlaWxpbmcgYWJvdmUgMSkgbXVzdCBkZWNsYXJlIHRoZSBrZXkgcnVsZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHRvdWNoZXNQcm9ibGVtKHRvdWNoZXM6IHVua25vd24sIHJldHJ5OiBQaWNrPFJldHJ5UG9saWN5LCAnYXR0ZW1wdHMnPiB8IHVuZGVmaW5lZCk6IHN0cmluZyB8IHVuZGVmaW5lZCB7XG4gIGlmICh0b3VjaGVzID09PSBudWxsIHx8IHR5cGVvZiB0b3VjaGVzICE9PSAnb2JqZWN0Jykge1xuICAgIHJldHVybiAndG91Y2hlcyBtdXN0IGJlIHsgc3lzdGVtLCBpZGVtcG90ZW5jeUtleT8gfSDigJQgdGhlIG91dHNpZGUgc3lzdGVtIGFuZCB0aGUga2V5IHJ1bGUnO1xuICB9XG4gIGNvbnN0IHsgc3lzdGVtLCBpZGVtcG90ZW5jeUtleSB9ID0gdG91Y2hlcyBhcyBQYXJ0aWFsPFN0YWdlVG91Y2hlcz47XG4gIGNvbnN0IG5hbWVQcm9ibGVtID0gYXR0ZW1wdE5hbWVQcm9ibGVtKHN5c3RlbSk7XG4gIGlmIChuYW1lUHJvYmxlbSAhPT0gdW5kZWZpbmVkKSByZXR1cm4gYHRvdWNoZXMuc3lzdGVtICR7bmFtZVByb2JsZW19IOKAlCBpdCBpcyBhIG5hbWUgZnJvbSBjb2RlLCBuZXZlciBhIHZhbHVlYDtcbiAgaWYgKGlkZW1wb3RlbmN5S2V5ICE9PSB1bmRlZmluZWQgJiYgdHlwZW9mIGlkZW1wb3RlbmN5S2V5ICE9PSAnZnVuY3Rpb24nKSB7XG4gICAgcmV0dXJuIChcbiAgICAgICd0b3VjaGVzLmlkZW1wb3RlbmN5S2V5IG11c3QgYmUgYSBmdW5jdGlvbiBvZiB0aGUgZXhlY3V0aW9uICgoY3R4KSA9PiBzdHJpbmcpIOKAlCBhIGNvbnN0YW50IGtleSB3b3VsZCBtYWtlICcgK1xuICAgICAgJ2V2ZXJ5IHJ1biBvbmUgb3BlcmF0aW9uJ1xuICAgICk7XG4gIH1cbiAgY29uc3QgYXR0ZW1wdHMgPSBhdHRlbXB0Q2VpbGluZyhyZXRyeT8uYXR0ZW1wdHMpO1xuICBpZiAoYXR0ZW1wdHMgPiAxICYmIGlkZW1wb3RlbmN5S2V5ID09PSB1bmRlZmluZWQpIHJldHVybiByZXRyaWVkV2l0aG91dEtleShzeXN0ZW0gYXMgc3RyaW5nLCBhdHRlbXB0cyk7XG4gIHJldHVybiB1bmRlZmluZWQ7XG59XG5cbi8qKiBgdmFsdWVgIGFzIGFuIGlkZW1wb3RlbmN5IGtleSAoYGlkcy9pZGVtcG90ZW5jeUtleS50c2AsIHRoZSBvbmUgcnVsZSksIG9yIGEgYFR5cGVFcnJvcmAgdGhhdCBuYW1lcyBgd2hlcmVgLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGFkbWl0SWRlbXBvdGVuY3lLZXkod2hlcmU6IHN0cmluZywgdmFsdWU6IHVua25vd24pOiBzdHJpbmcge1xuICBjb25zdCBwcm9ibGVtID0gaWRlbXBvdGVuY3lLZXlQcm9ibGVtKHZhbHVlKTtcbiAgaWYgKHByb2JsZW0gIT09IHVuZGVmaW5lZCkge1xuICAgIHRocm93IG5ldyBUeXBlRXJyb3IoXG4gICAgICBgJHt3aGVyZX06IGlkZW1wb3RlbmN5S2V5ICR7cHJvYmxlbX0gKGRlcml2ZSBpdCBmcm9tIHRoZSBpbnB1dCBvciB0aGUgc3RhdGUsIG5ldmVyIGZyb20gbW9kZWwgb3V0cHV0KWAsXG4gICAgKTtcbiAgfVxuICByZXR1cm4gdmFsdWUgYXMgc3RyaW5nO1xufVxuXG4vKipcbiAqIEEgYCRjYWxsYCdzIHNpZGUtZWZmZWN0IGRlY2xhcmF0aW9uLCBhZG1pdHRlZDogYHVuZGVmaW5lZGAgd2hlbiBpdCB0b3VjaGVzIG5vdGhpbmc7IG90aGVyd2lzZSB0aGUgc3lzdGVtIGFuZCB0aGVcbiAqIGtleSwgcmVmdXNlZCB3aXRoIGEgYFR5cGVFcnJvcmAgbmFtaW5nIGB3aGVyZWAgd2hlbiBtYWxmb3JtZWQsIHdoZW4gYSBrZXkgY29tZXMgd2l0aG91dCBhIHN5c3RlbSwgb3Igd2hlbiB0aGVcbiAqIGNhbGwgbWF5IHJldHJ5IHdpdGggbm8ga2V5IOKAlCBiZWZvcmUgYW55dGhpbmcgaXMgc2VudC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNhbGxUb3VjaGVzKFxuICB3aGVyZTogc3RyaW5nLFxuICBvcHRpb25zOiB1bmtub3duLFxuICBwb2xpY3k6IFBpY2s8UmV0cnlQb2xpY3ksICdhdHRlbXB0cyc+LFxuKTogeyByZWFkb25seSBzeXN0ZW06IHN0cmluZzsgcmVhZG9ubHkgaWRlbXBvdGVuY3lLZXk/OiBzdHJpbmcgfSB8IHVuZGVmaW5lZCB7XG4gIGlmIChvcHRpb25zID09PSB1bmRlZmluZWQpIHJldHVybiB1bmRlZmluZWQ7XG4gIGlmIChvcHRpb25zID09PSBudWxsIHx8IHR5cGVvZiBvcHRpb25zICE9PSAnb2JqZWN0Jykge1xuICAgIHRocm93IG5ldyBUeXBlRXJyb3IoYCR7d2hlcmV9OiBvcHRpb25zIG11c3QgYmUgeyB0b3VjaGVzPywgaWRlbXBvdGVuY3lLZXk/IH1gKTtcbiAgfVxuICBjb25zdCB7IHRvdWNoZXMsIGlkZW1wb3RlbmN5S2V5IH0gPSBvcHRpb25zIGFzIENhbGxPcHRpb25zO1xuICBpZiAodG91Y2hlcyA9PT0gdW5kZWZpbmVkKSB7XG4gICAgaWYgKGlkZW1wb3RlbmN5S2V5ICE9PSB1bmRlZmluZWQpIHtcbiAgICAgIHRocm93IG5ldyBUeXBlRXJyb3IoYCR7d2hlcmV9OiBhbiBpZGVtcG90ZW5jeUtleSBuYW1lcyBhbiBlZmZlY3Qg4oCUIGRlY2xhcmUgdGhlIHN5c3RlbSBpdCB0b3VjaGVzICh0b3VjaGVzKWApO1xuICAgIH1cbiAgICByZXR1cm4gdW5kZWZpbmVkO1xuICB9XG4gIGNvbnN0IG5hbWVQcm9ibGVtID0gYXR0ZW1wdE5hbWVQcm9ibGVtKHRvdWNoZXMpO1xuICBpZiAobmFtZVByb2JsZW0gIT09IHVuZGVmaW5lZCkge1xuICAgIHRocm93IG5ldyBUeXBlRXJyb3IoYCR7d2hlcmV9OiB0b3VjaGVzICR7bmFtZVByb2JsZW19IOKAlCBpdCBpcyBhIG5hbWUgZnJvbSBjb2RlLCBuZXZlciBhIHZhbHVlYCk7XG4gIH1cbiAgY29uc3Qga2V5ID0gaWRlbXBvdGVuY3lLZXkgPT09IHVuZGVmaW5lZCA/IHVuZGVmaW5lZCA6IGFkbWl0SWRlbXBvdGVuY3lLZXkod2hlcmUsIGlkZW1wb3RlbmN5S2V5KTtcbiAgY29uc3QgYXR0ZW1wdHMgPSBhdHRlbXB0Q2VpbGluZyhwb2xpY3kuYXR0ZW1wdHMpO1xuICBpZiAoYXR0ZW1wdHMgPiAxICYmIGtleSA9PT0gdW5kZWZpbmVkKSB0aHJvdyBuZXcgVHlwZUVycm9yKGAke3doZXJlfTogJHtyZXRyaWVkV2l0aG91dEtleSh0b3VjaGVzLCBhdHRlbXB0cyl9YCk7XG4gIHJldHVybiB7IHN5c3RlbTogdG91Y2hlcywgLi4uKGtleSAhPT0gdW5kZWZpbmVkICYmIHsgaWRlbXBvdGVuY3lLZXk6IGtleSB9KSB9O1xufVxuXG4vKiogV2hhdCBhbiBhdHRlbXB0IHRoYXQgZW5kZWQgYG91dGNvbWVgICh3aXRoIGBlcnJvcmAsIHdoZW4gaXQgZmFpbGVkKSBkaWQgdG8gdGhlIG91dHNpZGUgc3lzdGVtLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVmZmVjdE9mKG91dGNvbWU6IEF0dGVtcHRPdXRjb21lLCBlcnJvcjogdW5rbm93bik6IEF0dGVtcHRFZmZlY3Qge1xuICBpZiAob3V0Y29tZSA9PT0gJ29rJykgcmV0dXJuICdhcHBsaWVkJztcbiAgaWYgKG91dGNvbWUgPT09ICdmYWlsZWQnICYmIGRlY2xhcmVzTm9FZmZlY3QoZXJyb3IpKSByZXR1cm4gJ25vbmUnO1xuICByZXR1cm4gJ3Vua25vd24nO1xufVxuXG4vKiogVGhlIGVycm9yIGl0c2VsZiBzYXlzIG5vdGhpbmcgd2FzIHNlbnQg4oCUIGBlZmZlY3Q6ICdub25lJ2AsIHJlYWQgb25jZTsgYSB2YWx1ZSB0aGF0IGNhbm5vdCBiZSByZWFkIHNheXMgbm90aGluZy4gKi9cbmZ1bmN0aW9uIGRlY2xhcmVzTm9FZmZlY3QoZXJyb3I6IHVua25vd24pOiBib29sZWFuIHtcbiAgaWYgKGVycm9yID09PSBudWxsIHx8IHR5cGVvZiBlcnJvciAhPT0gJ29iamVjdCcpIHJldHVybiBmYWxzZTtcbiAgdHJ5IHtcbiAgICByZXR1cm4gKGVycm9yIGFzIHsgZWZmZWN0PzogdW5rbm93biB9KS5lZmZlY3QgPT09ICdub25lJztcbiAgfSBjYXRjaCB7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG59XG5cbi8qKlxuICogV2hhdCBhIHRvdWNoaW5nIHNlcmllcyBmYWlscyB3aXRoIHdoZW4gYW55IG9mIGl0cyBhdHRlbXB0cyBsZWZ0IHRoZSBlZmZlY3QgdW5rbm93biDigJQgbmV2ZXIgdGhlIGF0dGVtcHQncyBvd24gZXJyb3IsXG4gKiB3aGljaCBhIGNhbGxlciB3b3VsZCByZWFkIGFzIGEgZmFpbHVyZSBhbmQgcmV0cnkuIFRoZSBrZXkgaXMgdGhlIFJFQ09SREVEIG9uZTogdW5kZXIgYSByZWRhY3Rpb24gcnVsZSB0aGF0IG5hbWVzXG4gKiBpdCwgdGhlIGVycm9yIGNhcnJpZXMgdGhlIHBsYWNlaG9sZGVyLCBhcyBldmVyeSByZWNvcmQgZG9lcy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHVua25vd25FZmZlY3RFcnJvcih0YXJnZXQ6IEVmZmVjdFRhcmdldCwgcmVjb3JkOiBBdHRlbXB0UmVjb3JkLCBjYXVzZTogdW5rbm93bik6IFVua25vd25FZmZlY3RFcnJvciB7XG4gIHJldHVybiBuZXcgVW5rbm93bkVmZmVjdEVycm9yKHtcbiAgICBzeXN0ZW06IHRhcmdldC5zeXN0ZW0sXG4gICAgLi4uKHJlY29yZGVkS2V5T2YodGFyZ2V0KSAhPT0gdW5kZWZpbmVkICYmIHsgaWRlbXBvdGVuY3lLZXk6IHJlY29yZGVkS2V5T2YodGFyZ2V0KSB9KSxcbiAgICBhdHRlbXB0czogcmVjb3JkLmF0dGVtcHQsXG4gICAgY2F1c2UsXG4gIH0pO1xufVxuXG4vKiogVGhlIGtleSBhcyByZWNvcmRzIGNhcnJ5IGl0OiB0aGUgc2VydmVkIGZvcm0gd2hlbiB0aGUgY2FsbGVyIGdhdmUgb25lLCBlbHNlIHRoZSBrZXkgaXRzZWxmLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlY29yZGVkS2V5T2YodGFyZ2V0OiBFZmZlY3RUYXJnZXQpOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICByZXR1cm4gdGFyZ2V0LnJlY29yZGVkS2V5ID8/IHRhcmdldC5pZGVtcG90ZW5jeUtleTtcbn1cblxuLyoqIFRoZSBydW5uZXIncyByZWZ1c2FsIG9mIGEgdG91Y2hpbmcgc2VyaWVzIHRoYXQgbWF5IHJldHJ5IHdpdGggbm8ga2V5IOKAlCB0aGUgbGF3LCBhdCB0aGUgbGFzdCBkb29yLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJlZnVzZUtleWxlc3NSZXRyeSh0YXJnZXQ6IEVmZmVjdFRhcmdldCwgYXR0ZW1wdHM6IG51bWJlcik6IHZvaWQge1xuICBpZiAoYXR0ZW1wdHMgPiAxICYmIHRhcmdldC5pZGVtcG90ZW5jeUtleSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgdGhyb3cgbmV3IFR5cGVFcnJvcihgW2Zvb3RwcmludF0gJHtyZXRyaWVkV2l0aG91dEtleSh0YXJnZXQuc3lzdGVtLCBhdHRlbXB0cyl9YCk7XG4gIH1cbn1cblxuLyoqXG4gKiBXaHkgYSB0b3VjaGluZyBzdGFnZSBtYXkgbm90IGJlIFJFLVJVTiBieSBhbiBgaW50ZXJydXB0KClgIHJlc3VtZSwgb3IgYHVuZGVmaW5lZGAgd2hlbiBpdCBtYXkgKFAzKS4gQSByZXN1bWVcbiAqIHJlLXJ1bnMgdGhlIHN0YWdlJ3MgZnVuY3Rpb24gZnJvbSBpdHMgdG9wIOKAlCBhIHNlY29uZCBhdHRlbXB0IG9mIGl0cyBlZmZlY3Qg4oCUIHNvIHRoZSBsYXcgdGhhdCByZWZ1c2VzIGEga2V5bGVzc1xuICogcmV0cnkgcmVmdXNlcyBhIGtleWxlc3MgcmUtcnVuIHRvby4gQXNrZWQgd2hlbiB0aGUgc3RhZ2UgaW50ZXJydXB0cyAoYFN0YWdlUnVubmVyYCkgYW5kIHdoZW4gYSBjaGVja3BvaW50IGlzXG4gKiByZXN1bWVkIChgcnVubmVyL3Jlc3VtZS50cyDCtyBwbGFuUmVzdW1lYCwgZm9yIGEgY2hlY2twb2ludCBtYWRlIGJ5IGFub3RoZXIgdmVyc2lvbiBvZiB0aGUgY2hhcnQpLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaW50ZXJydXB0UHJvYmxlbSh0b3VjaGVzOiBTdGFnZVRvdWNoZXMgfCB1bmRlZmluZWQpOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICBpZiAodG91Y2hlcyA9PT0gdW5kZWZpbmVkIHx8IHRvdWNoZXMuaWRlbXBvdGVuY3lLZXkgIT09IHVuZGVmaW5lZCkgcmV0dXJuIHVuZGVmaW5lZDtcbiAgcmV0dXJuIChcbiAgICBgdG91Y2hlcyBcIiR7dG91Y2hlcy5zeXN0ZW19XCIgd2l0aCBubyBpZGVtcG90ZW5jeUtleSwgYW5kIGEgcmVzdW1lIGFmdGVyIGludGVycnVwdCgpIHJlLXJ1bnMgdGhlIHN0YWdlIGZyb20gaXRzIGAgK1xuICAgICd0b3Ag4oCUIGEgc2Vjb25kIGF0dGVtcHQgb2YgdGhlIGVmZmVjdCB3aXRob3V0IGEga2V5LiBEZWNsYXJlIHRoZSBrZXkgcnVsZSwgb3IgaW50ZXJydXB0IGluIGEgc3RhZ2Ugb2YgaXRzIG93bi4nXG4gICk7XG59XG5cbi8qKiBUaGUgdG91Y2hpbmcgZGVjbGFyYXRpb25zIGByZXN1bWUoKWAgYnVpbGRzIGFyb3VuZCBhIGtleSBhIGNoZWNrcG9pbnQgY2FycmllZCAoYGNhcnJpZWRUb3VjaGVzYCkuICovXG5jb25zdCBDQVJSSUVEID0gbmV3IFdlYWtTZXQ8b2JqZWN0PigpO1xuXG4vKipcbiAqIFRoZSBzdGFuZC1pbidzIGRlY2xhcmF0aW9uIG9uIGEgcmVzdW1lIChQMyk6IHRoZSBwYXVzZWQgc3RhZ2UncyBzeXN0ZW0sIGFuc3dlcmluZyB0aGUga2V5IGl0cyBjaGVja3BvaW50IGNhcnJpZWQg4oCUXG4gKiB0aGUgT1BFUkFUSU9OQUwgdmFsdWUsIHJlYWwgKGNoZWNrcG9pbnRzIGFyZSBleGVtcHQgZnJvbSByZWRhY3Rpb24gYnkgbGF3KS4gSXQgaXMgbWFya2VkLCBzbyB0aGUgcnVuIHNlcnZlcyBpdFxuICogbGlrZSBhIGtleSBvZiB1bmtub3duIHNvdXJjZXM6IHVuZGVyIGFueSBzdGF0ZSBydWxlIHRoZSByZWNvcmRzIGNhcnJ5IHRoZSBwbGFjZWhvbGRlciAoYGlzQ2FycmllZFRvdWNoZXNgKSDigJQgdGhlXG4gKiByZXN1bWVkIGxlZyBubyBsb25nZXIgaG9sZHMgdGhlIGlucHV0IHRoZSBrZXkgd2FzIG1hZGUgb2YsIHNvIGl0IGNhbm5vdCB0ZWxsIHdoZXRoZXIgdGhlIGtleSB3YXMgbWFza2VkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY2FycmllZFRvdWNoZXMoc3lzdGVtOiBzdHJpbmcsIGtleTogc3RyaW5nKTogU3RhZ2VUb3VjaGVzIHtcbiAgY29uc3QgdG91Y2hlcyA9IE9iamVjdC5mcmVlemUoeyBzeXN0ZW0sIGlkZW1wb3RlbmN5S2V5OiAoKSA9PiBrZXkgfSk7XG4gIENBUlJJRUQuYWRkKHRvdWNoZXMpO1xuICByZXR1cm4gdG91Y2hlcztcbn1cblxuLyoqIFRoZSBkZWNsYXJhdGlvbiBhbnN3ZXJzIGEga2V5IGEgY2hlY2twb2ludCBjYXJyaWVkICh7QGxpbmsgY2FycmllZFRvdWNoZXN9KS4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc0NhcnJpZWRUb3VjaGVzKHRvdWNoZXM6IHVua25vd24pOiBib29sZWFuIHtcbiAgcmV0dXJuIHR5cGVvZiB0b3VjaGVzID09PSAnb2JqZWN0JyAmJiB0b3VjaGVzICE9PSBudWxsICYmIENBUlJJRUQuaGFzKHRvdWNoZXMpO1xufVxuIl19
@@ -0,0 +1,41 @@
1
+ /**
2
+ * attempt/errors.ts — the errors the attempt contract throws (design §3.3).
3
+ *
4
+ * - `AttemptTimeoutError` — the attempt's OWN timer ended it (`RetryPolicy.timeoutMs` / the run's deadline). A
5
+ * timeout is the absence of an answer, not a failure of the outside system (law 4); `errorCategory` reads it
6
+ * as `'timeout'`.
7
+ * - `UnknownEffectError` — a side-effecting target's last attempt ended with no answer, so nobody knows whether
8
+ * the effect happened. "Reconcile, do not retry blindly" is on the error, not in prose.
9
+ *
10
+ * The idempotency key is a VALUE: it rides the error as a field (a redaction rule selects it by name) and is
11
+ * never spelled in a message.
12
+ */
13
+ /** The attempt's own time cap ran out before it answered. */
14
+ export declare class AttemptTimeoutError extends Error {
15
+ /** The attempt that ran out of time, 1-based. */
16
+ readonly attempt: number;
17
+ /** The cap it ran under, in milliseconds. */
18
+ readonly timeoutMs: number;
19
+ constructor(attempt: number, timeoutMs: number, options?: {
20
+ readonly cause?: unknown;
21
+ });
22
+ }
23
+ /** What an `UnknownEffectError` names. */
24
+ export interface UnknownEffectInit {
25
+ /** The outside system the stage touches — a name, never a value. */
26
+ readonly system: string;
27
+ /** The key the effect was attempted under — a value, kept as a field and never put in the message. */
28
+ readonly idempotencyKey?: string;
29
+ /** How many attempts ran. */
30
+ readonly attempts: number;
31
+ /** The last attempt's own error. */
32
+ readonly cause?: unknown;
33
+ }
34
+ /** A side-effecting target's last attempt ended with no answer: whether the effect happened is unknown. */
35
+ export declare class UnknownEffectError extends Error {
36
+ readonly system: string;
37
+ /** Absent (not `undefined`) when no key was given — `declare`, so no class field is emitted for it. */
38
+ readonly idempotencyKey?: string;
39
+ readonly attempts: number;
40
+ constructor(init: UnknownEffectInit);
41
+ }
@@ -0,0 +1,44 @@
1
+ /**
2
+ * attempt/errors.ts — the errors the attempt contract throws (design §3.3).
3
+ *
4
+ * - `AttemptTimeoutError` — the attempt's OWN timer ended it (`RetryPolicy.timeoutMs` / the run's deadline). A
5
+ * timeout is the absence of an answer, not a failure of the outside system (law 4); `errorCategory` reads it
6
+ * as `'timeout'`.
7
+ * - `UnknownEffectError` — a side-effecting target's last attempt ended with no answer, so nobody knows whether
8
+ * the effect happened. "Reconcile, do not retry blindly" is on the error, not in prose.
9
+ *
10
+ * The idempotency key is a VALUE: it rides the error as a field (a redaction rule selects it by name) and is
11
+ * never spelled in a message.
12
+ */
13
+ /** The attempt's own time cap ran out before it answered. */
14
+ export class AttemptTimeoutError extends Error {
15
+ /** The attempt that ran out of time, 1-based. */
16
+ attempt;
17
+ /** The cap it ran under, in milliseconds. */
18
+ timeoutMs;
19
+ constructor(attempt, timeoutMs, options) {
20
+ super(`attempt ${attempt} ran out of its ${timeoutMs}ms before it answered`);
21
+ this.name = 'AttemptTimeoutError';
22
+ this.attempt = attempt;
23
+ this.timeoutMs = timeoutMs;
24
+ if (options && Object.prototype.hasOwnProperty.call(options, 'cause'))
25
+ this.cause = options.cause;
26
+ }
27
+ }
28
+ /** A side-effecting target's last attempt ended with no answer: whether the effect happened is unknown. */
29
+ export class UnknownEffectError extends Error {
30
+ system;
31
+ attempts;
32
+ constructor(init) {
33
+ super(`"${init.system}": the effect of attempt ${init.attempts} is unknown — reconcile with the system ` +
34
+ '(look the operation up by its idempotency key) before trying again');
35
+ this.name = 'UnknownEffectError';
36
+ this.system = init.system;
37
+ if (init.idempotencyKey !== undefined)
38
+ this.idempotencyKey = init.idempotencyKey;
39
+ this.attempts = init.attempts;
40
+ if (Object.prototype.hasOwnProperty.call(init, 'cause'))
41
+ this.cause = init.cause;
42
+ }
43
+ }
44
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2xpYi9hdHRlbXB0L2Vycm9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7R0FXRztBQUVILDZEQUE2RDtBQUM3RCxNQUFNLE9BQU8sbUJBQW9CLFNBQVEsS0FBSztJQUM1QyxpREFBaUQ7SUFDeEMsT0FBTyxDQUFTO0lBQ3pCLDZDQUE2QztJQUNwQyxTQUFTLENBQVM7SUFFM0IsWUFBWSxPQUFlLEVBQUUsU0FBaUIsRUFBRSxPQUFzQztRQUNwRixLQUFLLENBQUMsV0FBVyxPQUFPLG1CQUFtQixTQUFTLHVCQUF1QixDQUFDLENBQUM7UUFDN0UsSUFBSSxDQUFDLElBQUksR0FBRyxxQkFBcUIsQ0FBQztRQUNsQyxJQUFJLENBQUMsT0FBTyxHQUFHLE9BQU8sQ0FBQztRQUN2QixJQUFJLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQztRQUMzQixJQUFJLE9BQU8sSUFBSSxNQUFNLENBQUMsU0FBUyxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQztZQUFFLElBQUksQ0FBQyxLQUFLLEdBQUcsT0FBTyxDQUFDLEtBQUssQ0FBQztJQUNwRyxDQUFDO0NBQ0Y7QUFjRCwyR0FBMkc7QUFDM0csTUFBTSxPQUFPLGtCQUFtQixTQUFRLEtBQUs7SUFDbEMsTUFBTSxDQUFTO0lBR2YsUUFBUSxDQUFTO0lBRTFCLFlBQVksSUFBdUI7UUFDakMsS0FBSyxDQUNILElBQUksSUFBSSxDQUFDLE1BQU0sNEJBQTRCLElBQUksQ0FBQyxRQUFRLDBDQUEwQztZQUNoRyxvRUFBb0UsQ0FDdkUsQ0FBQztRQUNGLElBQUksQ0FBQyxJQUFJLEdBQUcsb0JBQW9CLENBQUM7UUFDakMsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDO1FBQzFCLElBQUksSUFBSSxDQUFDLGNBQWMsS0FBSyxTQUFTO1lBQUUsSUFBSSxDQUFDLGNBQWMsR0FBRyxJQUFJLENBQUMsY0FBYyxDQUFDO1FBQ2pGLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxDQUFDLFFBQVEsQ0FBQztRQUM5QixJQUFJLE1BQU0sQ0FBQyxTQUFTLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsT0FBTyxDQUFDO1lBQUUsSUFBSSxDQUFDLEtBQUssR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDO0lBQ25GLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogYXR0ZW1wdC9lcnJvcnMudHMg4oCUIHRoZSBlcnJvcnMgdGhlIGF0dGVtcHQgY29udHJhY3QgdGhyb3dzIChkZXNpZ24gwqczLjMpLlxuICpcbiAqIC0gYEF0dGVtcHRUaW1lb3V0RXJyb3JgIOKAlCB0aGUgYXR0ZW1wdCdzIE9XTiB0aW1lciBlbmRlZCBpdCAoYFJldHJ5UG9saWN5LnRpbWVvdXRNc2AgLyB0aGUgcnVuJ3MgZGVhZGxpbmUpLiBBXG4gKiAgIHRpbWVvdXQgaXMgdGhlIGFic2VuY2Ugb2YgYW4gYW5zd2VyLCBub3QgYSBmYWlsdXJlIG9mIHRoZSBvdXRzaWRlIHN5c3RlbSAobGF3IDQpOyBgZXJyb3JDYXRlZ29yeWAgcmVhZHMgaXRcbiAqICAgYXMgYCd0aW1lb3V0J2AuXG4gKiAtIGBVbmtub3duRWZmZWN0RXJyb3JgIOKAlCBhIHNpZGUtZWZmZWN0aW5nIHRhcmdldCdzIGxhc3QgYXR0ZW1wdCBlbmRlZCB3aXRoIG5vIGFuc3dlciwgc28gbm9ib2R5IGtub3dzIHdoZXRoZXJcbiAqICAgdGhlIGVmZmVjdCBoYXBwZW5lZC4gXCJSZWNvbmNpbGUsIGRvIG5vdCByZXRyeSBibGluZGx5XCIgaXMgb24gdGhlIGVycm9yLCBub3QgaW4gcHJvc2UuXG4gKlxuICogVGhlIGlkZW1wb3RlbmN5IGtleSBpcyBhIFZBTFVFOiBpdCByaWRlcyB0aGUgZXJyb3IgYXMgYSBmaWVsZCAoYSByZWRhY3Rpb24gcnVsZSBzZWxlY3RzIGl0IGJ5IG5hbWUpIGFuZCBpc1xuICogbmV2ZXIgc3BlbGxlZCBpbiBhIG1lc3NhZ2UuXG4gKi9cblxuLyoqIFRoZSBhdHRlbXB0J3Mgb3duIHRpbWUgY2FwIHJhbiBvdXQgYmVmb3JlIGl0IGFuc3dlcmVkLiAqL1xuZXhwb3J0IGNsYXNzIEF0dGVtcHRUaW1lb3V0RXJyb3IgZXh0ZW5kcyBFcnJvciB7XG4gIC8qKiBUaGUgYXR0ZW1wdCB0aGF0IHJhbiBvdXQgb2YgdGltZSwgMS1iYXNlZC4gKi9cbiAgcmVhZG9ubHkgYXR0ZW1wdDogbnVtYmVyO1xuICAvKiogVGhlIGNhcCBpdCByYW4gdW5kZXIsIGluIG1pbGxpc2Vjb25kcy4gKi9cbiAgcmVhZG9ubHkgdGltZW91dE1zOiBudW1iZXI7XG5cbiAgY29uc3RydWN0b3IoYXR0ZW1wdDogbnVtYmVyLCB0aW1lb3V0TXM6IG51bWJlciwgb3B0aW9ucz86IHsgcmVhZG9ubHkgY2F1c2U/OiB1bmtub3duIH0pIHtcbiAgICBzdXBlcihgYXR0ZW1wdCAke2F0dGVtcHR9IHJhbiBvdXQgb2YgaXRzICR7dGltZW91dE1zfW1zIGJlZm9yZSBpdCBhbnN3ZXJlZGApO1xuICAgIHRoaXMubmFtZSA9ICdBdHRlbXB0VGltZW91dEVycm9yJztcbiAgICB0aGlzLmF0dGVtcHQgPSBhdHRlbXB0O1xuICAgIHRoaXMudGltZW91dE1zID0gdGltZW91dE1zO1xuICAgIGlmIChvcHRpb25zICYmIE9iamVjdC5wcm90b3R5cGUuaGFzT3duUHJvcGVydHkuY2FsbChvcHRpb25zLCAnY2F1c2UnKSkgdGhpcy5jYXVzZSA9IG9wdGlvbnMuY2F1c2U7XG4gIH1cbn1cblxuLyoqIFdoYXQgYW4gYFVua25vd25FZmZlY3RFcnJvcmAgbmFtZXMuICovXG5leHBvcnQgaW50ZXJmYWNlIFVua25vd25FZmZlY3RJbml0IHtcbiAgLyoqIFRoZSBvdXRzaWRlIHN5c3RlbSB0aGUgc3RhZ2UgdG91Y2hlcyDigJQgYSBuYW1lLCBuZXZlciBhIHZhbHVlLiAqL1xuICByZWFkb25seSBzeXN0ZW06IHN0cmluZztcbiAgLyoqIFRoZSBrZXkgdGhlIGVmZmVjdCB3YXMgYXR0ZW1wdGVkIHVuZGVyIOKAlCBhIHZhbHVlLCBrZXB0IGFzIGEgZmllbGQgYW5kIG5ldmVyIHB1dCBpbiB0aGUgbWVzc2FnZS4gKi9cbiAgcmVhZG9ubHkgaWRlbXBvdGVuY3lLZXk/OiBzdHJpbmc7XG4gIC8qKiBIb3cgbWFueSBhdHRlbXB0cyByYW4uICovXG4gIHJlYWRvbmx5IGF0dGVtcHRzOiBudW1iZXI7XG4gIC8qKiBUaGUgbGFzdCBhdHRlbXB0J3Mgb3duIGVycm9yLiAqL1xuICByZWFkb25seSBjYXVzZT86IHVua25vd247XG59XG5cbi8qKiBBIHNpZGUtZWZmZWN0aW5nIHRhcmdldCdzIGxhc3QgYXR0ZW1wdCBlbmRlZCB3aXRoIG5vIGFuc3dlcjogd2hldGhlciB0aGUgZWZmZWN0IGhhcHBlbmVkIGlzIHVua25vd24uICovXG5leHBvcnQgY2xhc3MgVW5rbm93bkVmZmVjdEVycm9yIGV4dGVuZHMgRXJyb3Ige1xuICByZWFkb25seSBzeXN0ZW06IHN0cmluZztcbiAgLyoqIEFic2VudCAobm90IGB1bmRlZmluZWRgKSB3aGVuIG5vIGtleSB3YXMgZ2l2ZW4g4oCUIGBkZWNsYXJlYCwgc28gbm8gY2xhc3MgZmllbGQgaXMgZW1pdHRlZCBmb3IgaXQuICovXG4gIGRlY2xhcmUgcmVhZG9ubHkgaWRlbXBvdGVuY3lLZXk/OiBzdHJpbmc7XG4gIHJlYWRvbmx5IGF0dGVtcHRzOiBudW1iZXI7XG5cbiAgY29uc3RydWN0b3IoaW5pdDogVW5rbm93bkVmZmVjdEluaXQpIHtcbiAgICBzdXBlcihcbiAgICAgIGBcIiR7aW5pdC5zeXN0ZW19XCI6IHRoZSBlZmZlY3Qgb2YgYXR0ZW1wdCAke2luaXQuYXR0ZW1wdHN9IGlzIHVua25vd24g4oCUIHJlY29uY2lsZSB3aXRoIHRoZSBzeXN0ZW0gYCArXG4gICAgICAgICcobG9vayB0aGUgb3BlcmF0aW9uIHVwIGJ5IGl0cyBpZGVtcG90ZW5jeSBrZXkpIGJlZm9yZSB0cnlpbmcgYWdhaW4nLFxuICAgICk7XG4gICAgdGhpcy5uYW1lID0gJ1Vua25vd25FZmZlY3RFcnJvcic7XG4gICAgdGhpcy5zeXN0ZW0gPSBpbml0LnN5c3RlbTtcbiAgICBpZiAoaW5pdC5pZGVtcG90ZW5jeUtleSAhPT0gdW5kZWZpbmVkKSB0aGlzLmlkZW1wb3RlbmN5S2V5ID0gaW5pdC5pZGVtcG90ZW5jeUtleTtcbiAgICB0aGlzLmF0dGVtcHRzID0gaW5pdC5hdHRlbXB0cztcbiAgICBpZiAoT2JqZWN0LnByb3RvdHlwZS5oYXNPd25Qcm9wZXJ0eS5jYWxsKGluaXQsICdjYXVzZScpKSB0aGlzLmNhdXNlID0gaW5pdC5jYXVzZTtcbiAgfVxufVxuIl19
@@ -0,0 +1,18 @@
1
+ /**
2
+ * attempt/ — one runner, one record: every attempt the library runs is an `AttemptRecord` with the
3
+ * retry-or-stop decision that followed it (design docs/design/2026-10-time-and-failure-evidence.md).
4
+ *
5
+ * Public: the record's vocabulary, the one failure classifier, the one rule table, the two errors, and `attempt()`
6
+ * — the runner for code that is not a stage (P2). The loop itself (`runAttempts`), `runCall`, the evidence builder
7
+ * and `anySignal` are the engine's. `RetryPolicy` is declared in
8
+ * `./types.ts` and published through the builder's barrel, where it always was.
9
+ */
10
+ export { errorCategory } from './category.js';
11
+ export type { ParsedTraceparent, TraceparentFields, TraceparentRefusal } from './correlation.js';
12
+ export { formatTraceparent, parseTraceparent, TraceparentError } from './correlation.js';
13
+ export { retryRules } from './decision.js';
14
+ export type { UnknownEffectInit } from './errors.js';
15
+ export { AttemptTimeoutError, UnknownEffectError } from './errors.js';
16
+ export type { AttemptOptions } from './standalone.js';
17
+ export { attempt } from './standalone.js';
18
+ export type { AttemptCategory, AttemptContext, AttemptEffect, AttemptError, AttemptInputs, AttemptKind, AttemptNext, AttemptOutcome, AttemptReason, AttemptRecord, AttemptSummary, CallOptions, IdempotencyKeyContext, LateWrite, ObservedAttempt, RunCorrelation, StageTouches, } from './types.js';
@@ -0,0 +1,15 @@
1
+ /**
2
+ * attempt/ — one runner, one record: every attempt the library runs is an `AttemptRecord` with the
3
+ * retry-or-stop decision that followed it (design docs/design/2026-10-time-and-failure-evidence.md).
4
+ *
5
+ * Public: the record's vocabulary, the one failure classifier, the one rule table, the two errors, and `attempt()`
6
+ * — the runner for code that is not a stage (P2). The loop itself (`runAttempts`), `runCall`, the evidence builder
7
+ * and `anySignal` are the engine's. `RetryPolicy` is declared in
8
+ * `./types.ts` and published through the builder's barrel, where it always was.
9
+ */
10
+ export { errorCategory } from './category.js';
11
+ export { formatTraceparent, parseTraceparent, TraceparentError } from './correlation.js';
12
+ export { retryRules } from './decision.js';
13
+ export { AttemptTimeoutError, UnknownEffectError } from './errors.js';
14
+ export { attempt } from './standalone.js';
15
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL2F0dGVtcHQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUFFSCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBRTlDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxnQkFBZ0IsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ3pGLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFFM0MsT0FBTyxFQUFFLG1CQUFtQixFQUFFLGtCQUFrQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRXRFLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogYXR0ZW1wdC8g4oCUIG9uZSBydW5uZXIsIG9uZSByZWNvcmQ6IGV2ZXJ5IGF0dGVtcHQgdGhlIGxpYnJhcnkgcnVucyBpcyBhbiBgQXR0ZW1wdFJlY29yZGAgd2l0aCB0aGVcbiAqIHJldHJ5LW9yLXN0b3AgZGVjaXNpb24gdGhhdCBmb2xsb3dlZCBpdCAoZGVzaWduIGRvY3MvZGVzaWduLzIwMjYtMTAtdGltZS1hbmQtZmFpbHVyZS1ldmlkZW5jZS5tZCkuXG4gKlxuICogUHVibGljOiB0aGUgcmVjb3JkJ3Mgdm9jYWJ1bGFyeSwgdGhlIG9uZSBmYWlsdXJlIGNsYXNzaWZpZXIsIHRoZSBvbmUgcnVsZSB0YWJsZSwgdGhlIHR3byBlcnJvcnMsIGFuZCBgYXR0ZW1wdCgpYFxuICog4oCUIHRoZSBydW5uZXIgZm9yIGNvZGUgdGhhdCBpcyBub3QgYSBzdGFnZSAoUDIpLiBUaGUgbG9vcCBpdHNlbGYgKGBydW5BdHRlbXB0c2ApLCBgcnVuQ2FsbGAsIHRoZSBldmlkZW5jZSBidWlsZGVyXG4gKiBhbmQgYGFueVNpZ25hbGAgYXJlIHRoZSBlbmdpbmUncy4gYFJldHJ5UG9saWN5YCBpcyBkZWNsYXJlZCBpblxuICogYC4vdHlwZXMudHNgIGFuZCBwdWJsaXNoZWQgdGhyb3VnaCB0aGUgYnVpbGRlcidzIGJhcnJlbCwgd2hlcmUgaXQgYWx3YXlzIHdhcy5cbiAqL1xuXG5leHBvcnQgeyBlcnJvckNhdGVnb3J5IH0gZnJvbSAnLi9jYXRlZ29yeS5qcyc7XG5leHBvcnQgdHlwZSB7IFBhcnNlZFRyYWNlcGFyZW50LCBUcmFjZXBhcmVudEZpZWxkcywgVHJhY2VwYXJlbnRSZWZ1c2FsIH0gZnJvbSAnLi9jb3JyZWxhdGlvbi5qcyc7XG5leHBvcnQgeyBmb3JtYXRUcmFjZXBhcmVudCwgcGFyc2VUcmFjZXBhcmVudCwgVHJhY2VwYXJlbnRFcnJvciB9IGZyb20gJy4vY29ycmVsYXRpb24uanMnO1xuZXhwb3J0IHsgcmV0cnlSdWxlcyB9IGZyb20gJy4vZGVjaXNpb24uanMnO1xuZXhwb3J0IHR5cGUgeyBVbmtub3duRWZmZWN0SW5pdCB9IGZyb20gJy4vZXJyb3JzLmpzJztcbmV4cG9ydCB7IEF0dGVtcHRUaW1lb3V0RXJyb3IsIFVua25vd25FZmZlY3RFcnJvciB9IGZyb20gJy4vZXJyb3JzLmpzJztcbmV4cG9ydCB0eXBlIHsgQXR0ZW1wdE9wdGlvbnMgfSBmcm9tICcuL3N0YW5kYWxvbmUuanMnO1xuZXhwb3J0IHsgYXR0ZW1wdCB9IGZyb20gJy4vc3RhbmRhbG9uZS5qcyc7XG5leHBvcnQgdHlwZSB7XG4gIEF0dGVtcHRDYXRlZ29yeSxcbiAgQXR0ZW1wdENvbnRleHQsXG4gIEF0dGVtcHRFZmZlY3QsXG4gIEF0dGVtcHRFcnJvcixcbiAgQXR0ZW1wdElucHV0cyxcbiAgQXR0ZW1wdEtpbmQsXG4gIEF0dGVtcHROZXh0LFxuICBBdHRlbXB0T3V0Y29tZSxcbiAgQXR0ZW1wdFJlYXNvbixcbiAgQXR0ZW1wdFJlY29yZCxcbiAgQXR0ZW1wdFN1bW1hcnksXG4gIENhbGxPcHRpb25zLFxuICBJZGVtcG90ZW5jeUtleUNvbnRleHQsXG4gIExhdGVXcml0ZSxcbiAgT2JzZXJ2ZWRBdHRlbXB0LFxuICBSdW5Db3JyZWxhdGlvbixcbiAgU3RhZ2VUb3VjaGVzLFxufSBmcm9tICcuL3R5cGVzLmpzJztcbiJdfQ==