footprintjs 9.48.2 → 10.0.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 (326) hide show
  1. package/AGENTS.md +12 -10
  2. package/CLAUDE.md +21 -23
  3. package/README.md +1 -1
  4. package/dist/advanced.js +71 -128
  5. package/dist/esm/advanced.d.ts +24 -58
  6. package/dist/esm/advanced.js +13 -51
  7. package/dist/esm/index.d.ts +5 -8
  8. package/dist/esm/index.js +3 -3
  9. package/dist/esm/lib/builder/FlowChartBuilder.d.ts +1 -1
  10. package/dist/esm/lib/builder/FlowChartBuilder.js +3 -3
  11. package/dist/esm/lib/builder/structure/StructureRecorder.d.ts +1 -1
  12. package/dist/esm/lib/builder/structure/StructureRecorder.js +1 -1
  13. package/dist/esm/lib/capture/index.d.ts +0 -1
  14. package/dist/esm/lib/capture/index.js +1 -2
  15. package/dist/esm/lib/engine/graph/prefixNodeTree.js +2 -2
  16. package/dist/esm/lib/engine/handlers/ResumeEntry.d.ts +3 -3
  17. package/dist/esm/lib/engine/handlers/ResumeEntry.js +4 -4
  18. package/dist/esm/lib/engine/handlers/SubflowExecutor.d.ts +1 -2
  19. package/dist/esm/lib/engine/handlers/SubflowExecutor.js +4 -8
  20. package/dist/esm/lib/engine/index.d.ts +1 -1
  21. package/dist/esm/lib/engine/index.js +1 -1
  22. package/dist/esm/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +4 -4
  23. package/dist/esm/lib/engine/narrative/CombinedNarrativeRecorder.js +1 -1
  24. package/dist/esm/lib/engine/narrative/index.d.ts +1 -1
  25. package/dist/esm/lib/engine/narrative/index.js +1 -1
  26. package/dist/esm/lib/engine/narrative/narrativeTypes.d.ts +1 -11
  27. package/dist/esm/lib/engine/narrative/narrativeTypes.js +1 -1
  28. package/dist/esm/lib/engine/traversal/FlowchartTraverser.d.ts +2 -10
  29. package/dist/esm/lib/engine/traversal/FlowchartTraverser.js +4 -6
  30. package/dist/esm/lib/engine/traversalContext.d.ts +1 -1
  31. package/dist/esm/lib/engine/traversalContext.js +2 -2
  32. package/dist/esm/lib/engine/types.d.ts +2 -10
  33. package/dist/esm/lib/engine/types.js +1 -1
  34. package/dist/esm/lib/engine/walkSubflowSpec.js +2 -2
  35. package/dist/esm/lib/ids/reservedIds.js +2 -2
  36. package/dist/esm/lib/memory/DiagnosticCollector.js +2 -2
  37. package/dist/esm/lib/memory/StageContext.d.ts +2 -4
  38. package/dist/esm/lib/memory/StageContext.js +2 -2
  39. package/dist/esm/lib/memory/borrowedMutation.js +2 -2
  40. package/dist/esm/lib/memory/index.d.ts +6 -21
  41. package/dist/esm/lib/memory/index.js +4 -22
  42. package/dist/esm/lib/memory/redaction.d.ts +1 -1
  43. package/dist/esm/lib/memory/redaction.js +2 -2
  44. package/dist/esm/lib/memory/runPolicy.d.ts +3 -2
  45. package/dist/esm/lib/memory/runPolicy.js +1 -1
  46. package/dist/esm/lib/reactive/createTypedScope.js +2 -2
  47. package/dist/esm/lib/reactive/writeTraps.js +2 -2
  48. package/dist/esm/lib/recorder/ControlDepRecorder.d.ts +3 -2
  49. package/dist/esm/lib/recorder/ControlDepRecorder.js +3 -2
  50. package/dist/esm/lib/recorder/EmitRecorder.d.ts +1 -1
  51. package/dist/esm/lib/recorder/EmitRecorder.js +1 -1
  52. package/dist/esm/lib/recorder/InOutRecorder.js +2 -2
  53. package/dist/esm/lib/recorder/qualityTrace.d.ts +1 -1
  54. package/dist/esm/lib/recorder/qualityTrace.js +2 -2
  55. package/dist/esm/lib/runner/DeferredObserverTier.js +2 -2
  56. package/dist/esm/lib/runner/ExecutionRuntime.d.ts +4 -5
  57. package/dist/esm/lib/runner/ExecutionRuntime.js +2 -5
  58. package/dist/esm/lib/runner/FlowChartExecutor.d.ts +1 -1
  59. package/dist/esm/lib/runner/FlowChartExecutor.js +1 -1
  60. package/dist/esm/lib/runner/getSubtreeSnapshot.d.ts +1 -1
  61. package/dist/esm/lib/runner/getSubtreeSnapshot.js +4 -4
  62. package/dist/esm/lib/runner/resume.js +2 -2
  63. package/dist/esm/lib/runner/snapshot.js +3 -2
  64. package/dist/esm/lib/scope/ScopeFacade.js +2 -2
  65. package/dist/esm/lib/scope/state/zod/scopeFactory.js +2 -2
  66. package/dist/esm/recorders.d.ts +2 -3
  67. package/dist/esm/recorders.js +1 -1
  68. package/dist/esm/trace.d.ts +11 -57
  69. package/dist/esm/trace.js +10 -68
  70. package/dist/index.js +3 -3
  71. package/dist/lib/builder/FlowChartBuilder.js +5 -5
  72. package/dist/lib/builder/structure/StructureRecorder.js +1 -1
  73. package/dist/lib/capture/index.js +2 -4
  74. package/dist/lib/engine/graph/prefixNodeTree.js +5 -5
  75. package/dist/lib/engine/handlers/ResumeEntry.js +4 -4
  76. package/dist/lib/engine/handlers/SubflowExecutor.js +5 -9
  77. package/dist/lib/engine/index.js +1 -1
  78. package/dist/lib/engine/narrative/CombinedNarrativeRecorder.js +1 -1
  79. package/dist/lib/engine/narrative/index.js +1 -1
  80. package/dist/lib/engine/narrative/narrativeTypes.js +1 -1
  81. package/dist/lib/engine/traversal/FlowchartTraverser.js +8 -10
  82. package/dist/lib/engine/traversalContext.js +4 -4
  83. package/dist/lib/engine/types.js +1 -1
  84. package/dist/lib/engine/walkSubflowSpec.js +3 -3
  85. package/dist/lib/ids/reservedIds.js +5 -5
  86. package/dist/lib/memory/DiagnosticCollector.js +3 -3
  87. package/dist/lib/memory/StageContext.js +3 -3
  88. package/dist/lib/memory/borrowedMutation.js +3 -3
  89. package/dist/lib/memory/index.js +7 -42
  90. package/dist/lib/memory/redaction.js +3 -3
  91. package/dist/lib/memory/runPolicy.js +1 -1
  92. package/dist/lib/reactive/createTypedScope.js +3 -3
  93. package/dist/lib/reactive/writeTraps.js +4 -4
  94. package/dist/lib/recorder/ControlDepRecorder.js +3 -2
  95. package/dist/lib/recorder/EmitRecorder.js +1 -1
  96. package/dist/lib/recorder/InOutRecorder.js +3 -3
  97. package/dist/lib/recorder/qualityTrace.js +4 -4
  98. package/dist/lib/runner/DeferredObserverTier.js +3 -3
  99. package/dist/lib/runner/ExecutionRuntime.js +6 -9
  100. package/dist/lib/runner/FlowChartExecutor.js +1 -1
  101. package/dist/lib/runner/getSubtreeSnapshot.js +6 -6
  102. package/dist/lib/runner/resume.js +3 -3
  103. package/dist/lib/runner/snapshot.js +6 -5
  104. package/dist/lib/scope/ScopeFacade.js +3 -3
  105. package/dist/lib/scope/state/zod/scopeFactory.js +4 -4
  106. package/dist/recorders.js +1 -1
  107. package/dist/trace.js +18 -120
  108. package/dist/types/advanced.d.ts +24 -58
  109. package/dist/types/index.d.ts +5 -8
  110. package/dist/types/lib/builder/FlowChartBuilder.d.ts +1 -1
  111. package/dist/types/lib/builder/structure/StructureRecorder.d.ts +1 -1
  112. package/dist/types/lib/capture/index.d.ts +0 -1
  113. package/dist/types/lib/engine/handlers/ResumeEntry.d.ts +3 -3
  114. package/dist/types/lib/engine/handlers/SubflowExecutor.d.ts +1 -2
  115. package/dist/types/lib/engine/index.d.ts +1 -1
  116. package/dist/types/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +4 -4
  117. package/dist/types/lib/engine/narrative/index.d.ts +1 -1
  118. package/dist/types/lib/engine/narrative/narrativeTypes.d.ts +1 -11
  119. package/dist/types/lib/engine/traversal/FlowchartTraverser.d.ts +2 -10
  120. package/dist/types/lib/engine/traversalContext.d.ts +1 -1
  121. package/dist/types/lib/engine/types.d.ts +2 -10
  122. package/dist/types/lib/memory/StageContext.d.ts +2 -4
  123. package/dist/types/lib/memory/index.d.ts +6 -21
  124. package/dist/types/lib/memory/redaction.d.ts +1 -1
  125. package/dist/types/lib/memory/runPolicy.d.ts +3 -2
  126. package/dist/types/lib/recorder/ControlDepRecorder.d.ts +3 -2
  127. package/dist/types/lib/recorder/EmitRecorder.d.ts +1 -1
  128. package/dist/types/lib/recorder/qualityTrace.d.ts +1 -1
  129. package/dist/types/lib/runner/ExecutionRuntime.d.ts +4 -5
  130. package/dist/types/lib/runner/FlowChartExecutor.d.ts +1 -1
  131. package/dist/types/lib/runner/getSubtreeSnapshot.d.ts +1 -1
  132. package/dist/types/recorders.d.ts +2 -3
  133. package/dist/types/trace.d.ts +11 -57
  134. package/package.json +6 -15
  135. package/dist/esm/lib/capture/freeze.d.ts +0 -91
  136. package/dist/esm/lib/capture/freeze.js +0 -314
  137. package/dist/esm/lib/capture/ownData.d.ts +0 -7
  138. package/dist/esm/lib/capture/ownData.js +0 -15
  139. package/dist/esm/lib/capture/valueKinds.d.ts +0 -57
  140. package/dist/esm/lib/capture/valueKinds.js +0 -142
  141. package/dist/esm/lib/ids/runtimeStageId.d.ts +0 -173
  142. package/dist/esm/lib/ids/runtimeStageId.js +0 -194
  143. package/dist/esm/lib/memory/EventLog.d.ts +0 -105
  144. package/dist/esm/lib/memory/EventLog.js +0 -148
  145. package/dist/esm/lib/memory/RecordFrame.d.ts +0 -232
  146. package/dist/esm/lib/memory/RecordFrame.js +0 -296
  147. package/dist/esm/lib/memory/SharedMemory.d.ts +0 -46
  148. package/dist/esm/lib/memory/SharedMemory.js +0 -88
  149. package/dist/esm/lib/memory/TransactionBuffer.d.ts +0 -521
  150. package/dist/esm/lib/memory/TransactionBuffer.js +0 -946
  151. package/dist/esm/lib/memory/admission.d.ts +0 -81
  152. package/dist/esm/lib/memory/admission.js +0 -153
  153. package/dist/esm/lib/memory/backtrack.d.ts +0 -286
  154. package/dist/esm/lib/memory/backtrack.js +0 -457
  155. package/dist/esm/lib/memory/commitLogUtils.d.ts +0 -217
  156. package/dist/esm/lib/memory/commitLogUtils.js +0 -384
  157. package/dist/esm/lib/memory/deltaEncoding.d.ts +0 -66
  158. package/dist/esm/lib/memory/deltaEncoding.js +0 -122
  159. package/dist/esm/lib/memory/equality.d.ts +0 -93
  160. package/dist/esm/lib/memory/equality.js +0 -262
  161. package/dist/esm/lib/memory/eventPosition.d.ts +0 -18
  162. package/dist/esm/lib/memory/eventPosition.js +0 -2
  163. package/dist/esm/lib/memory/honesty.d.ts +0 -93
  164. package/dist/esm/lib/memory/honesty.js +0 -92
  165. package/dist/esm/lib/memory/keyPaths.d.ts +0 -125
  166. package/dist/esm/lib/memory/keyPaths.js +0 -227
  167. package/dist/esm/lib/memory/logModel.d.ts +0 -76
  168. package/dist/esm/lib/memory/logModel.js +0 -364
  169. package/dist/esm/lib/memory/merge.d.ts +0 -26
  170. package/dist/esm/lib/memory/merge.js +0 -60
  171. package/dist/esm/lib/memory/pathOps.d.ts +0 -115
  172. package/dist/esm/lib/memory/pathOps.js +0 -290
  173. package/dist/esm/lib/memory/paths.d.ts +0 -52
  174. package/dist/esm/lib/memory/paths.js +0 -57
  175. package/dist/esm/lib/memory/placeholders.d.ts +0 -39
  176. package/dist/esm/lib/memory/placeholders.js +0 -40
  177. package/dist/esm/lib/memory/recordCommit.d.ts +0 -45
  178. package/dist/esm/lib/memory/recordCommit.js +0 -61
  179. package/dist/esm/lib/memory/scrub.d.ts +0 -53
  180. package/dist/esm/lib/memory/scrub.js +0 -74
  181. package/dist/esm/lib/memory/types.d.ts +0 -209
  182. package/dist/esm/lib/memory/types.js +0 -10
  183. package/dist/esm/lib/memory/utils.d.ts +0 -73
  184. package/dist/esm/lib/memory/utils.js +0 -159
  185. package/dist/esm/lib/memory/verbs.d.ts +0 -333
  186. package/dist/esm/lib/memory/verbs.js +0 -427
  187. package/dist/esm/lib/recorder/CommitRangeIndex.d.ts +0 -147
  188. package/dist/esm/lib/recorder/CommitRangeIndex.js +0 -207
  189. package/dist/esm/lib/scope/detectCircular.d.ts +0 -13
  190. package/dist/esm/lib/scope/detectCircular.js +0 -14
  191. package/dist/esm/lib/scope/recorders/summarizeValue.d.ts +0 -5
  192. package/dist/esm/lib/scope/recorders/summarizeValue.js +0 -6
  193. package/dist/esm/lib/slice/elementProvenance.d.ts +0 -81
  194. package/dist/esm/lib/slice/elementProvenance.js +0 -190
  195. package/dist/esm/lib/slice/forwardSliceForKey.d.ts +0 -88
  196. package/dist/esm/lib/slice/forwardSliceForKey.js +0 -243
  197. package/dist/esm/lib/slice/index.d.ts +0 -25
  198. package/dist/esm/lib/slice/index.js +0 -25
  199. package/dist/esm/lib/slice/keyIndex.d.ts +0 -137
  200. package/dist/esm/lib/slice/keyIndex.js +0 -293
  201. package/dist/esm/lib/slice/keyTimeline.d.ts +0 -49
  202. package/dist/esm/lib/slice/keyTimeline.js +0 -113
  203. package/dist/esm/lib/slice/keysReadSources.d.ts +0 -51
  204. package/dist/esm/lib/slice/keysReadSources.js +0 -95
  205. package/dist/esm/lib/slice/serialize.d.ts +0 -78
  206. package/dist/esm/lib/slice/serialize.js +0 -278
  207. package/dist/esm/lib/slice/sliceForKey.d.ts +0 -47
  208. package/dist/esm/lib/slice/sliceForKey.js +0 -88
  209. package/dist/esm/lib/slice/types.d.ts +0 -567
  210. package/dist/esm/lib/slice/types.js +0 -25
  211. package/dist/esm/lib/time-travel/axis.d.ts +0 -119
  212. package/dist/esm/lib/time-travel/axis.js +0 -179
  213. package/dist/esm/lib/time-travel/bundles.d.ts +0 -77
  214. package/dist/esm/lib/time-travel/bundles.js +0 -136
  215. package/dist/esm/lib/time-travel/chain.d.ts +0 -93
  216. package/dist/esm/lib/time-travel/chain.js +0 -188
  217. package/dist/esm/lib/time-travel/commitStops.d.ts +0 -55
  218. package/dist/esm/lib/time-travel/commitStops.js +0 -202
  219. package/dist/esm/lib/time-travel/index.d.ts +0 -22
  220. package/dist/esm/lib/time-travel/index.js +0 -21
  221. package/dist/esm/lib/time-travel/stateAt.d.ts +0 -102
  222. package/dist/esm/lib/time-travel/stateAt.js +0 -153
  223. package/dist/esm/lib/time-travel/tagStops.d.ts +0 -72
  224. package/dist/esm/lib/time-travel/tagStops.js +0 -102
  225. package/dist/esm/lib/time-travel/timeTravel.d.ts +0 -70
  226. package/dist/esm/lib/time-travel/timeTravel.js +0 -360
  227. package/dist/esm/lib/time-travel/types.d.ts +0 -470
  228. package/dist/esm/lib/time-travel/types.js +0 -23
  229. package/dist/esm/write.d.ts +0 -47
  230. package/dist/esm/write.js +0 -46
  231. package/dist/lib/capture/freeze.js +0 -320
  232. package/dist/lib/capture/ownData.js +0 -19
  233. package/dist/lib/capture/valueKinds.js +0 -146
  234. package/dist/lib/ids/runtimeStageId.js +0 -210
  235. package/dist/lib/memory/EventLog.js +0 -152
  236. package/dist/lib/memory/RecordFrame.js +0 -300
  237. package/dist/lib/memory/SharedMemory.js +0 -92
  238. package/dist/lib/memory/TransactionBuffer.js +0 -950
  239. package/dist/lib/memory/admission.js +0 -159
  240. package/dist/lib/memory/backtrack.js +0 -463
  241. package/dist/lib/memory/commitLogUtils.js +0 -399
  242. package/dist/lib/memory/deltaEncoding.js +0 -128
  243. package/dist/lib/memory/equality.js +0 -266
  244. package/dist/lib/memory/eventPosition.js +0 -3
  245. package/dist/lib/memory/honesty.js +0 -95
  246. package/dist/lib/memory/keyPaths.js +0 -243
  247. package/dist/lib/memory/logModel.js +0 -372
  248. package/dist/lib/memory/merge.js +0 -64
  249. package/dist/lib/memory/pathOps.js +0 -306
  250. package/dist/lib/memory/paths.js +0 -62
  251. package/dist/lib/memory/placeholders.js +0 -43
  252. package/dist/lib/memory/recordCommit.js +0 -65
  253. package/dist/lib/memory/scrub.js +0 -79
  254. package/dist/lib/memory/types.js +0 -11
  255. package/dist/lib/memory/utils.js +0 -178
  256. package/dist/lib/memory/verbs.js +0 -444
  257. package/dist/lib/recorder/CommitRangeIndex.js +0 -211
  258. package/dist/lib/scope/detectCircular.js +0 -21
  259. package/dist/lib/scope/recorders/summarizeValue.js +0 -10
  260. package/dist/lib/slice/elementProvenance.js +0 -195
  261. package/dist/lib/slice/forwardSliceForKey.js +0 -247
  262. package/dist/lib/slice/index.js +0 -42
  263. package/dist/lib/slice/keyIndex.js +0 -313
  264. package/dist/lib/slice/keyTimeline.js +0 -117
  265. package/dist/lib/slice/keysReadSources.js +0 -101
  266. package/dist/lib/slice/serialize.js +0 -286
  267. package/dist/lib/slice/sliceForKey.js +0 -93
  268. package/dist/lib/slice/types.js +0 -26
  269. package/dist/lib/time-travel/axis.js +0 -184
  270. package/dist/lib/time-travel/bundles.js +0 -144
  271. package/dist/lib/time-travel/chain.js +0 -193
  272. package/dist/lib/time-travel/commitStops.js +0 -206
  273. package/dist/lib/time-travel/index.js +0 -32
  274. package/dist/lib/time-travel/stateAt.js +0 -160
  275. package/dist/lib/time-travel/tagStops.js +0 -106
  276. package/dist/lib/time-travel/timeTravel.js +0 -364
  277. package/dist/lib/time-travel/types.js +0 -24
  278. package/dist/types/lib/capture/freeze.d.ts +0 -91
  279. package/dist/types/lib/capture/ownData.d.ts +0 -7
  280. package/dist/types/lib/capture/valueKinds.d.ts +0 -57
  281. package/dist/types/lib/ids/runtimeStageId.d.ts +0 -173
  282. package/dist/types/lib/memory/EventLog.d.ts +0 -105
  283. package/dist/types/lib/memory/RecordFrame.d.ts +0 -232
  284. package/dist/types/lib/memory/SharedMemory.d.ts +0 -46
  285. package/dist/types/lib/memory/TransactionBuffer.d.ts +0 -521
  286. package/dist/types/lib/memory/admission.d.ts +0 -81
  287. package/dist/types/lib/memory/backtrack.d.ts +0 -286
  288. package/dist/types/lib/memory/commitLogUtils.d.ts +0 -217
  289. package/dist/types/lib/memory/deltaEncoding.d.ts +0 -66
  290. package/dist/types/lib/memory/equality.d.ts +0 -93
  291. package/dist/types/lib/memory/eventPosition.d.ts +0 -18
  292. package/dist/types/lib/memory/honesty.d.ts +0 -93
  293. package/dist/types/lib/memory/keyPaths.d.ts +0 -125
  294. package/dist/types/lib/memory/logModel.d.ts +0 -76
  295. package/dist/types/lib/memory/merge.d.ts +0 -26
  296. package/dist/types/lib/memory/pathOps.d.ts +0 -115
  297. package/dist/types/lib/memory/paths.d.ts +0 -52
  298. package/dist/types/lib/memory/placeholders.d.ts +0 -39
  299. package/dist/types/lib/memory/recordCommit.d.ts +0 -45
  300. package/dist/types/lib/memory/scrub.d.ts +0 -53
  301. package/dist/types/lib/memory/types.d.ts +0 -209
  302. package/dist/types/lib/memory/utils.d.ts +0 -73
  303. package/dist/types/lib/memory/verbs.d.ts +0 -333
  304. package/dist/types/lib/recorder/CommitRangeIndex.d.ts +0 -147
  305. package/dist/types/lib/scope/detectCircular.d.ts +0 -13
  306. package/dist/types/lib/scope/recorders/summarizeValue.d.ts +0 -5
  307. package/dist/types/lib/slice/elementProvenance.d.ts +0 -81
  308. package/dist/types/lib/slice/forwardSliceForKey.d.ts +0 -88
  309. package/dist/types/lib/slice/index.d.ts +0 -25
  310. package/dist/types/lib/slice/keyIndex.d.ts +0 -137
  311. package/dist/types/lib/slice/keyTimeline.d.ts +0 -49
  312. package/dist/types/lib/slice/keysReadSources.d.ts +0 -51
  313. package/dist/types/lib/slice/serialize.d.ts +0 -78
  314. package/dist/types/lib/slice/sliceForKey.d.ts +0 -47
  315. package/dist/types/lib/slice/types.d.ts +0 -567
  316. package/dist/types/lib/time-travel/axis.d.ts +0 -119
  317. package/dist/types/lib/time-travel/bundles.d.ts +0 -77
  318. package/dist/types/lib/time-travel/chain.d.ts +0 -93
  319. package/dist/types/lib/time-travel/commitStops.d.ts +0 -55
  320. package/dist/types/lib/time-travel/index.d.ts +0 -22
  321. package/dist/types/lib/time-travel/stateAt.d.ts +0 -102
  322. package/dist/types/lib/time-travel/tagStops.d.ts +0 -72
  323. package/dist/types/lib/time-travel/timeTravel.d.ts +0 -70
  324. package/dist/types/lib/time-travel/types.d.ts +0 -470
  325. package/dist/types/write.d.ts +0 -47
  326. package/dist/write.js +0 -52
@@ -1,173 +0,0 @@
1
- /**
2
- * runtimeStageId — unique identifier for each execution step during traversal.
3
- *
4
- * Format: [subflowPath/]stageId#executionIndex
5
- *
6
- * Components:
7
- * stageId — stable node ID from the builder ('call-llm', 'seed')
8
- * executionIndex — monotonic counter incremented per stage execution (0, 1, 2...)
9
- * subflowPath — optional path for subflow stages ('sf-tools', 'sf-outer/sf-inner')
10
- *
11
- * Properties:
12
- * - Unique within a run (executionIndex never repeats)
13
- * - Execution-ordered (sort by executionIndex = execution order)
14
- * - Human-readable ('sf-tools/execute-tool-calls#8')
15
- * - Parseable (split on '#' for stageId and index, split stageId on '/' for subflow path)
16
- *
17
- * Naming-collision warning
18
- * ────────────────────────
19
- * The parsed-output `.stageId` field below is the LOCAL form (segment
20
- * after the last '/'). This is NOT the same as `spec.id` / `node.id`
21
- * for subflow-nested stages, which carry the FULL prefixed form
22
- * (`'sf-tools/execute-tool-calls'`). To compare safely, use
23
- * `splitStageId(spec.id)` to decompose the prefixed form the same
24
- * way `parseRuntimeStageId` decomposes a runtimeStageId.
25
- *
26
- * @example
27
- * ```
28
- * buildRuntimeStageId('call-llm', 5) // 'call-llm#5'
29
- * buildRuntimeStageId('execute-tool-calls', 8, 'sf-tools') // 'sf-tools/execute-tool-calls#8'
30
- * buildRuntimeStageId('validate', 3, 'sf-outer/sf-inner') // 'sf-outer/sf-inner/validate#3'
31
- * ```
32
- *
33
- * ## The one owner (F7, 9.37.0)
34
- *
35
- * This module is the ONE place the grammar is spelled. Every reader asks it —
36
- * `isExecutionKey`, `stageIdOf`, `subflowPathOf`, `subflowSegmentsOf`,
37
- * `lastSegmentOf`, `isWithinSubflow` — and every composer joins through
38
- * `joinPath` / `buildRuntimeStageId`; no other file splits on `#` or `/`.
39
- * It builds, parses and reads ids, and imports nothing: it is the record's
40
- * (C6). The delimiters are RESERVED (RFC 3986 §2.2 style): the engine's id
41
- * doors refuse them in user-authored ids through ONE function,
42
- * `reservedIds.ts · refuseReservedId`, which reads them here — so
43
- * last-delimiter parsing is sound by construction rather than by hope. Stores
44
- * and the prefixer never refuse — they hold runtime ids and prefixed ids,
45
- * which carry the delimiters on purpose.
46
- */
47
- /** Separates subflow path segments from each other and from the stage id. */
48
- export declare const PATH_DELIMITER = "/";
49
- /** Separates the (prefixed) stage id from the execution index. */
50
- export declare const EXECUTION_DELIMITER = "#";
51
- declare const RUNTIME_STAGE_ID: unique symbol;
52
- declare const EXECUTION_INDEX: unique symbol;
53
- declare const COMMIT_IDX: unique symbol;
54
- /** A `[subflowPath/]stageId#executionIndex` string the grammar produced. Assignable to `string`. */
55
- export type RuntimeStageId = string & {
56
- readonly [RUNTIME_STAGE_ID]: true;
57
- };
58
- /** The run-global, monotonic position of one stage execution (the `#N`). Assignable to `number`. */
59
- export type ExecutionIndex = number & {
60
- readonly [EXECUTION_INDEX]: true;
61
- };
62
- /** A bundle's position in a commit log (`bundle.idx`). Assignable to `number`. */
63
- export type CommitIdx = number & {
64
- readonly [COMMIT_IDX]: true;
65
- };
66
- /**
67
- * Build a runtimeStageId from its components.
68
- *
69
- * Note: The traverser does NOT use the subflowPath parameter — node.id already
70
- * includes the subflow prefix from the builder. This parameter exists for external
71
- * consumers constructing IDs from parsed components (round-trip via parseRuntimeStageId).
72
- */
73
- export declare function buildRuntimeStageId(stageId: string, executionIndex: number, subflowPath?: string): RuntimeStageId;
74
- /**
75
- * Parse a runtimeStageId into its components.
76
- *
77
- * IMPORTANT — naming collision: the returned `stageId` is the LOCAL
78
- * form (the segment between the last '/' and the '#'). This is NOT
79
- * the same as `spec.id` or `node.id` for subflow-nested stages,
80
- * which contain the FULL prefixed form.
81
- *
82
- * parseRuntimeStageId('sf-tools/execute-tool-calls#8').stageId
83
- * // → 'execute-tool-calls' (LOCAL)
84
- *
85
- * node.id // (post-mount, in a spec that contains subflows)
86
- * // → 'sf-tools/execute-tool-calls' (FULL prefixed)
87
- *
88
- * To compare these two safely, use `splitStageId(node.id)` to get
89
- * the local form, OR reconstruct the full form via
90
- * `(subflowPath ? subflowPath + '/' : '') + stageId`.
91
- */
92
- export declare function parseRuntimeStageId(runtimeStageId: string): {
93
- stageId: string;
94
- executionIndex: ExecutionIndex;
95
- subflowPath: string | undefined;
96
- };
97
- /**
98
- * Decompose a (possibly prefixed) stage id into its components.
99
- *
100
- * Use this when you have an id WITHOUT the `#N` execution suffix and
101
- * need the local stage name and/or the subflow path. Common sources
102
- * of such ids:
103
- * - `spec.id` (post-mount the id includes any subflow prefix)
104
- * - `CommitBundle.stageId` (post-mount id)
105
- * - `node.id` from xyflow nodes built off the spec
106
- * - the segment of `runtimeStageId` BEFORE the `#` (use
107
- * `parseRuntimeStageId` directly for full runtimeStageId strings)
108
- *
109
- * Mirrors the decomposition `parseRuntimeStageId` performs on the
110
- * stageId portion of a runtimeStageId, so the two helpers stay in
111
- * lockstep on naming and behavior.
112
- *
113
- * @example
114
- * splitStageId('sf-tools/execute-tool-calls')
115
- * // → { localStageId: 'execute-tool-calls', subflowPath: 'sf-tools' }
116
- *
117
- * splitStageId('execute-tool-calls')
118
- * // → { localStageId: 'execute-tool-calls', subflowPath: undefined }
119
- *
120
- * splitStageId('sf-outer/sf-inner/validate')
121
- * // → { localStageId: 'validate', subflowPath: 'sf-outer/sf-inner' }
122
- */
123
- export declare function splitStageId(prefixedStageId: string): {
124
- localStageId: string;
125
- subflowPath: string | undefined;
126
- };
127
- /**
128
- * True when `key` names one EXECUTION (`…#N`) rather than a stage or a subflow
129
- * path. Its presence alone decides: the delimiter is reserved in every
130
- * user-authored id (`reservedIds.ts · refuseReservedId`), so only the grammar
131
- * puts it there.
132
- *
133
- * Asked where a map is keyed by both — `subflowResults` is dual-keyed by
134
- * subflow path AND by mount runtimeStageId.
135
- */
136
- export declare function isExecutionKey(key: string): boolean;
137
- /**
138
- * The FULL (subflow-prefixed) stage id of a runtimeStageId — everything before
139
- * the last `#`, i.e. what `node.id` / `CommitBundle.stageId` hold. A string
140
- * with no `#` is returned whole.
141
- *
142
- * @example stageIdOf('sf-tools/execute#8') // 'sf-tools/execute'
143
- */
144
- export declare function stageIdOf(runtimeStageId: string): string;
145
- /** The execution index of a runtimeStageId, or `NaN` when it carries none. */
146
- export declare function executionIndexOf(runtimeStageId: string): number;
147
- /**
148
- * The subflow path a runtimeStageId executes in (`'sf-a/sf-b'`), or
149
- * `undefined` at the top level. Reads the stage-id part, so it agrees with
150
- * `splitStageId(stageIdOf(rid)).subflowPath`.
151
- */
152
- export declare function subflowPathOf(runtimeStageId: string): string | undefined;
153
- /** The subflow path of a runtimeStageId as segments (`['sf-a', 'sf-b']`); `[]` at the top level. */
154
- export declare function subflowSegmentsOf(runtimeStageId: string): string[];
155
- /** The non-empty segments of a subflow path or prefixed id (`'a//b/'` → `['a', 'b']`). */
156
- export declare function pathSegments(path: string): string[];
157
- /** The last segment of a path or prefixed id (`'sf-a/sf-b'` → `'sf-b'`); the whole string when it has none. */
158
- export declare function lastSegmentOf(path: string): string;
159
- /** Join path segments with the grammar's delimiter (`joinPath('sf', 'stage')` → `'sf/stage'`). */
160
- export declare function joinPath(...segments: readonly string[]): string;
161
- /** True when the (prefixed) id `id` sits INSIDE the subflow at `path` — at any depth below it. */
162
- export declare function isWithinSubflow(id: string, path: string): boolean;
163
- /**
164
- * Shared mutable counter for execution index.
165
- * Passed by reference to child traversers (subflows) so they
166
- * continue the global numbering instead of restarting at 0.
167
- */
168
- export interface ExecutionCounter {
169
- value: number;
170
- }
171
- /** Create a new execution counter starting at 0. */
172
- export declare function createExecutionCounter(): ExecutionCounter;
173
- export {};
@@ -1,194 +0,0 @@
1
- /**
2
- * runtimeStageId — unique identifier for each execution step during traversal.
3
- *
4
- * Format: [subflowPath/]stageId#executionIndex
5
- *
6
- * Components:
7
- * stageId — stable node ID from the builder ('call-llm', 'seed')
8
- * executionIndex — monotonic counter incremented per stage execution (0, 1, 2...)
9
- * subflowPath — optional path for subflow stages ('sf-tools', 'sf-outer/sf-inner')
10
- *
11
- * Properties:
12
- * - Unique within a run (executionIndex never repeats)
13
- * - Execution-ordered (sort by executionIndex = execution order)
14
- * - Human-readable ('sf-tools/execute-tool-calls#8')
15
- * - Parseable (split on '#' for stageId and index, split stageId on '/' for subflow path)
16
- *
17
- * Naming-collision warning
18
- * ────────────────────────
19
- * The parsed-output `.stageId` field below is the LOCAL form (segment
20
- * after the last '/'). This is NOT the same as `spec.id` / `node.id`
21
- * for subflow-nested stages, which carry the FULL prefixed form
22
- * (`'sf-tools/execute-tool-calls'`). To compare safely, use
23
- * `splitStageId(spec.id)` to decompose the prefixed form the same
24
- * way `parseRuntimeStageId` decomposes a runtimeStageId.
25
- *
26
- * @example
27
- * ```
28
- * buildRuntimeStageId('call-llm', 5) // 'call-llm#5'
29
- * buildRuntimeStageId('execute-tool-calls', 8, 'sf-tools') // 'sf-tools/execute-tool-calls#8'
30
- * buildRuntimeStageId('validate', 3, 'sf-outer/sf-inner') // 'sf-outer/sf-inner/validate#3'
31
- * ```
32
- *
33
- * ## The one owner (F7, 9.37.0)
34
- *
35
- * This module is the ONE place the grammar is spelled. Every reader asks it —
36
- * `isExecutionKey`, `stageIdOf`, `subflowPathOf`, `subflowSegmentsOf`,
37
- * `lastSegmentOf`, `isWithinSubflow` — and every composer joins through
38
- * `joinPath` / `buildRuntimeStageId`; no other file splits on `#` or `/`.
39
- * It builds, parses and reads ids, and imports nothing: it is the record's
40
- * (C6). The delimiters are RESERVED (RFC 3986 §2.2 style): the engine's id
41
- * doors refuse them in user-authored ids through ONE function,
42
- * `reservedIds.ts · refuseReservedId`, which reads them here — so
43
- * last-delimiter parsing is sound by construction rather than by hope. Stores
44
- * and the prefixer never refuse — they hold runtime ids and prefixed ids,
45
- * which carry the delimiters on purpose.
46
- */
47
- /** Separates subflow path segments from each other and from the stage id. */
48
- export const PATH_DELIMITER = '/';
49
- /** Separates the (prefixed) stage id from the execution index. */
50
- export const EXECUTION_DELIMITER = '#';
51
- /**
52
- * Build a runtimeStageId from its components.
53
- *
54
- * Note: The traverser does NOT use the subflowPath parameter — node.id already
55
- * includes the subflow prefix from the builder. This parameter exists for external
56
- * consumers constructing IDs from parsed components (round-trip via parseRuntimeStageId).
57
- */
58
- export function buildRuntimeStageId(stageId, executionIndex, subflowPath) {
59
- const prefix = subflowPath ? `${subflowPath}${PATH_DELIMITER}` : '';
60
- return `${prefix}${stageId}${EXECUTION_DELIMITER}${executionIndex}`;
61
- }
62
- /**
63
- * Parse a runtimeStageId into its components.
64
- *
65
- * IMPORTANT — naming collision: the returned `stageId` is the LOCAL
66
- * form (the segment between the last '/' and the '#'). This is NOT
67
- * the same as `spec.id` or `node.id` for subflow-nested stages,
68
- * which contain the FULL prefixed form.
69
- *
70
- * parseRuntimeStageId('sf-tools/execute-tool-calls#8').stageId
71
- * // → 'execute-tool-calls' (LOCAL)
72
- *
73
- * node.id // (post-mount, in a spec that contains subflows)
74
- * // → 'sf-tools/execute-tool-calls' (FULL prefixed)
75
- *
76
- * To compare these two safely, use `splitStageId(node.id)` to get
77
- * the local form, OR reconstruct the full form via
78
- * `(subflowPath ? subflowPath + '/' : '') + stageId`.
79
- */
80
- export function parseRuntimeStageId(runtimeStageId) {
81
- const hashIdx = runtimeStageId.lastIndexOf(EXECUTION_DELIMITER);
82
- if (hashIdx === -1) {
83
- return { stageId: runtimeStageId, executionIndex: 0, subflowPath: undefined };
84
- }
85
- const beforeHash = runtimeStageId.slice(0, hashIdx);
86
- const executionIndex = parseInt(runtimeStageId.slice(hashIdx + 1), 10);
87
- const lastSlash = beforeHash.lastIndexOf(PATH_DELIMITER);
88
- if (lastSlash === -1) {
89
- return { stageId: beforeHash, executionIndex, subflowPath: undefined };
90
- }
91
- return {
92
- stageId: beforeHash.slice(lastSlash + 1),
93
- executionIndex,
94
- subflowPath: beforeHash.slice(0, lastSlash),
95
- };
96
- }
97
- /**
98
- * Decompose a (possibly prefixed) stage id into its components.
99
- *
100
- * Use this when you have an id WITHOUT the `#N` execution suffix and
101
- * need the local stage name and/or the subflow path. Common sources
102
- * of such ids:
103
- * - `spec.id` (post-mount the id includes any subflow prefix)
104
- * - `CommitBundle.stageId` (post-mount id)
105
- * - `node.id` from xyflow nodes built off the spec
106
- * - the segment of `runtimeStageId` BEFORE the `#` (use
107
- * `parseRuntimeStageId` directly for full runtimeStageId strings)
108
- *
109
- * Mirrors the decomposition `parseRuntimeStageId` performs on the
110
- * stageId portion of a runtimeStageId, so the two helpers stay in
111
- * lockstep on naming and behavior.
112
- *
113
- * @example
114
- * splitStageId('sf-tools/execute-tool-calls')
115
- * // → { localStageId: 'execute-tool-calls', subflowPath: 'sf-tools' }
116
- *
117
- * splitStageId('execute-tool-calls')
118
- * // → { localStageId: 'execute-tool-calls', subflowPath: undefined }
119
- *
120
- * splitStageId('sf-outer/sf-inner/validate')
121
- * // → { localStageId: 'validate', subflowPath: 'sf-outer/sf-inner' }
122
- */
123
- export function splitStageId(prefixedStageId) {
124
- const lastSlash = prefixedStageId.lastIndexOf(PATH_DELIMITER);
125
- if (lastSlash === -1) {
126
- return { localStageId: prefixedStageId, subflowPath: undefined };
127
- }
128
- return {
129
- localStageId: prefixedStageId.slice(lastSlash + 1),
130
- subflowPath: prefixedStageId.slice(0, lastSlash),
131
- };
132
- }
133
- /**
134
- * True when `key` names one EXECUTION (`…#N`) rather than a stage or a subflow
135
- * path. Its presence alone decides: the delimiter is reserved in every
136
- * user-authored id (`reservedIds.ts · refuseReservedId`), so only the grammar
137
- * puts it there.
138
- *
139
- * Asked where a map is keyed by both — `subflowResults` is dual-keyed by
140
- * subflow path AND by mount runtimeStageId.
141
- */
142
- export function isExecutionKey(key) {
143
- return key.includes(EXECUTION_DELIMITER);
144
- }
145
- /**
146
- * The FULL (subflow-prefixed) stage id of a runtimeStageId — everything before
147
- * the last `#`, i.e. what `node.id` / `CommitBundle.stageId` hold. A string
148
- * with no `#` is returned whole.
149
- *
150
- * @example stageIdOf('sf-tools/execute#8') // 'sf-tools/execute'
151
- */
152
- export function stageIdOf(runtimeStageId) {
153
- const hashIdx = runtimeStageId.lastIndexOf(EXECUTION_DELIMITER);
154
- return hashIdx === -1 ? runtimeStageId : runtimeStageId.slice(0, hashIdx);
155
- }
156
- /** The execution index of a runtimeStageId, or `NaN` when it carries none. */
157
- export function executionIndexOf(runtimeStageId) {
158
- const hashIdx = runtimeStageId.lastIndexOf(EXECUTION_DELIMITER);
159
- return hashIdx === -1 ? NaN : Number.parseInt(runtimeStageId.slice(hashIdx + 1), 10);
160
- }
161
- /**
162
- * The subflow path a runtimeStageId executes in (`'sf-a/sf-b'`), or
163
- * `undefined` at the top level. Reads the stage-id part, so it agrees with
164
- * `splitStageId(stageIdOf(rid)).subflowPath`.
165
- */
166
- export function subflowPathOf(runtimeStageId) {
167
- return splitStageId(stageIdOf(runtimeStageId)).subflowPath;
168
- }
169
- /** The subflow path of a runtimeStageId as segments (`['sf-a', 'sf-b']`); `[]` at the top level. */
170
- export function subflowSegmentsOf(runtimeStageId) {
171
- const path = subflowPathOf(runtimeStageId);
172
- return path === undefined ? [] : path.split(PATH_DELIMITER);
173
- }
174
- /** The non-empty segments of a subflow path or prefixed id (`'a//b/'` → `['a', 'b']`). */
175
- export function pathSegments(path) {
176
- return path.split(PATH_DELIMITER).filter((s) => s.length > 0);
177
- }
178
- /** The last segment of a path or prefixed id (`'sf-a/sf-b'` → `'sf-b'`); the whole string when it has none. */
179
- export function lastSegmentOf(path) {
180
- return path.slice(path.lastIndexOf(PATH_DELIMITER) + 1);
181
- }
182
- /** Join path segments with the grammar's delimiter (`joinPath('sf', 'stage')` → `'sf/stage'`). */
183
- export function joinPath(...segments) {
184
- return segments.join(PATH_DELIMITER);
185
- }
186
- /** True when the (prefixed) id `id` sits INSIDE the subflow at `path` — at any depth below it. */
187
- export function isWithinSubflow(id, path) {
188
- return id.startsWith(`${path}${PATH_DELIMITER}`);
189
- }
190
- /** Create a new execution counter starting at 0. */
191
- export function createExecutionCounter() {
192
- return { value: 0 };
193
- }
194
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVudGltZVN0YWdlSWQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL2lkcy9ydW50aW1lU3RhZ2VJZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBNkNHO0FBRUgsNkVBQTZFO0FBQzdFLE1BQU0sQ0FBQyxNQUFNLGNBQWMsR0FBRyxHQUFHLENBQUM7QUFDbEMsa0VBQWtFO0FBQ2xFLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLEdBQUcsQ0FBQztBQWV2Qzs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsbUJBQW1CLENBQUMsT0FBZSxFQUFFLGNBQXNCLEVBQUUsV0FBb0I7SUFDL0YsTUFBTSxNQUFNLEdBQUcsV0FBVyxDQUFDLENBQUMsQ0FBQyxHQUFHLFdBQVcsR0FBRyxjQUFjLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQ3BFLE9BQU8sR0FBRyxNQUFNLEdBQUcsT0FBTyxHQUFHLG1CQUFtQixHQUFHLGNBQWMsRUFBb0IsQ0FBQztBQUN4RixDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBaUJHO0FBQ0gsTUFBTSxVQUFVLG1CQUFtQixDQUFDLGNBQXNCO0lBS3hELE1BQU0sT0FBTyxHQUFHLGNBQWMsQ0FBQyxXQUFXLENBQUMsbUJBQW1CLENBQUMsQ0FBQztJQUNoRSxJQUFJLE9BQU8sS0FBSyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ25CLE9BQU8sRUFBRSxPQUFPLEVBQUUsY0FBYyxFQUFFLGNBQWMsRUFBRSxDQUFtQixFQUFFLFdBQVcsRUFBRSxTQUFTLEVBQUUsQ0FBQztJQUNsRyxDQUFDO0lBRUQsTUFBTSxVQUFVLEdBQUcsY0FBYyxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDcEQsTUFBTSxjQUFjLEdBQUcsUUFBUSxDQUFDLGNBQWMsQ0FBQyxLQUFLLENBQUMsT0FBTyxHQUFHLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBbUIsQ0FBQztJQUV6RixNQUFNLFNBQVMsR0FBRyxVQUFVLENBQUMsV0FBVyxDQUFDLGNBQWMsQ0FBQyxDQUFDO0lBQ3pELElBQUksU0FBUyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUM7UUFDckIsT0FBTyxFQUFFLE9BQU8sRUFBRSxVQUFVLEVBQUUsY0FBYyxFQUFFLFdBQVcsRUFBRSxTQUFTLEVBQUUsQ0FBQztJQUN6RSxDQUFDO0lBRUQsT0FBTztRQUNMLE9BQU8sRUFBRSxVQUFVLENBQUMsS0FBSyxDQUFDLFNBQVMsR0FBRyxDQUFDLENBQUM7UUFDeEMsY0FBYztRQUNkLFdBQVcsRUFBRSxVQUFVLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxTQUFTLENBQUM7S0FDNUMsQ0FBQztBQUNKLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXlCRztBQUNILE1BQU0sVUFBVSxZQUFZLENBQUMsZUFBdUI7SUFJbEQsTUFBTSxTQUFTLEdBQUcsZUFBZSxDQUFDLFdBQVcsQ0FBQyxjQUFjLENBQUMsQ0FBQztJQUM5RCxJQUFJLFNBQVMsS0FBSyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ3JCLE9BQU8sRUFBRSxZQUFZLEVBQUUsZUFBZSxFQUFFLFdBQVcsRUFBRSxTQUFTLEVBQUUsQ0FBQztJQUNuRSxDQUFDO0lBQ0QsT0FBTztRQUNMLFlBQVksRUFBRSxlQUFlLENBQUMsS0FBSyxDQUFDLFNBQVMsR0FBRyxDQUFDLENBQUM7UUFDbEQsV0FBVyxFQUFFLGVBQWUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLFNBQVMsQ0FBQztLQUNqRCxDQUFDO0FBQ0osQ0FBQztBQUVEOzs7Ozs7OztHQVFHO0FBQ0gsTUFBTSxVQUFVLGNBQWMsQ0FBQyxHQUFXO0lBQ3hDLE9BQU8sR0FBRyxDQUFDLFFBQVEsQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDO0FBQzNDLENBQUM7QUFFRDs7Ozs7O0dBTUc7QUFDSCxNQUFNLFVBQVUsU0FBUyxDQUFDLGNBQXNCO0lBQzlDLE1BQU0sT0FBTyxHQUFHLGNBQWMsQ0FBQyxXQUFXLENBQUMsbUJBQW1CLENBQUMsQ0FBQztJQUNoRSxPQUFPLE9BQU8sS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsY0FBYyxDQUFDLENBQUMsQ0FBQyxjQUFjLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxPQUFPLENBQUMsQ0FBQztBQUM1RSxDQUFDO0FBRUQsOEVBQThFO0FBQzlFLE1BQU0sVUFBVSxnQkFBZ0IsQ0FBQyxjQUFzQjtJQUNyRCxNQUFNLE9BQU8sR0FBRyxjQUFjLENBQUMsV0FBVyxDQUFDLG1CQUFtQixDQUFDLENBQUM7SUFDaEUsT0FBTyxPQUFPLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxjQUFjLENBQUMsS0FBSyxDQUFDLE9BQU8sR0FBRyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQztBQUN2RixDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sVUFBVSxhQUFhLENBQUMsY0FBc0I7SUFDbEQsT0FBTyxZQUFZLENBQUMsU0FBUyxDQUFDLGNBQWMsQ0FBQyxDQUFDLENBQUMsV0FBVyxDQUFDO0FBQzdELENBQUM7QUFFRCxvR0FBb0c7QUFDcEcsTUFBTSxVQUFVLGlCQUFpQixDQUFDLGNBQXNCO0lBQ3RELE1BQU0sSUFBSSxHQUFHLGFBQWEsQ0FBQyxjQUFjLENBQUMsQ0FBQztJQUMzQyxPQUFPLElBQUksS0FBSyxTQUFTLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxjQUFjLENBQUMsQ0FBQztBQUM5RCxDQUFDO0FBRUQsMEZBQTBGO0FBQzFGLE1BQU0sVUFBVSxZQUFZLENBQUMsSUFBWTtJQUN2QyxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsY0FBYyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDO0FBQ2hFLENBQUM7QUFFRCwrR0FBK0c7QUFDL0csTUFBTSxVQUFVLGFBQWEsQ0FBQyxJQUFZO0lBQ3hDLE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLGNBQWMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDO0FBQzFELENBQUM7QUFFRCxrR0FBa0c7QUFDbEcsTUFBTSxVQUFVLFFBQVEsQ0FBQyxHQUFHLFFBQTJCO0lBQ3JELE9BQU8sUUFBUSxDQUFDLElBQUksQ0FBQyxjQUFjLENBQUMsQ0FBQztBQUN2QyxDQUFDO0FBRUQsa0dBQWtHO0FBQ2xHLE1BQU0sVUFBVSxlQUFlLENBQUMsRUFBVSxFQUFFLElBQVk7SUFDdEQsT0FBTyxFQUFFLENBQUMsVUFBVSxDQUFDLEdBQUcsSUFBSSxHQUFHLGNBQWMsRUFBRSxDQUFDLENBQUM7QUFDbkQsQ0FBQztBQVdELG9EQUFvRDtBQUNwRCxNQUFNLFVBQVUsc0JBQXNCO0lBQ3BDLE9BQU8sRUFBRSxLQUFLLEVBQUUsQ0FBQyxFQUFFLENBQUM7QUFDdEIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogcnVudGltZVN0YWdlSWQg4oCUIHVuaXF1ZSBpZGVudGlmaWVyIGZvciBlYWNoIGV4ZWN1dGlvbiBzdGVwIGR1cmluZyB0cmF2ZXJzYWwuXG4gKlxuICogRm9ybWF0OiBbc3ViZmxvd1BhdGgvXXN0YWdlSWQjZXhlY3V0aW9uSW5kZXhcbiAqXG4gKiBDb21wb25lbnRzOlxuICogICBzdGFnZUlkICAgICAgICDigJQgc3RhYmxlIG5vZGUgSUQgZnJvbSB0aGUgYnVpbGRlciAoJ2NhbGwtbGxtJywgJ3NlZWQnKVxuICogICBleGVjdXRpb25JbmRleCDigJQgbW9ub3RvbmljIGNvdW50ZXIgaW5jcmVtZW50ZWQgcGVyIHN0YWdlIGV4ZWN1dGlvbiAoMCwgMSwgMi4uLilcbiAqICAgc3ViZmxvd1BhdGggICAg4oCUIG9wdGlvbmFsIHBhdGggZm9yIHN1YmZsb3cgc3RhZ2VzICgnc2YtdG9vbHMnLCAnc2Ytb3V0ZXIvc2YtaW5uZXInKVxuICpcbiAqIFByb3BlcnRpZXM6XG4gKiAgIC0gVW5pcXVlIHdpdGhpbiBhIHJ1biAoZXhlY3V0aW9uSW5kZXggbmV2ZXIgcmVwZWF0cylcbiAqICAgLSBFeGVjdXRpb24tb3JkZXJlZCAoc29ydCBieSBleGVjdXRpb25JbmRleCA9IGV4ZWN1dGlvbiBvcmRlcilcbiAqICAgLSBIdW1hbi1yZWFkYWJsZSAoJ3NmLXRvb2xzL2V4ZWN1dGUtdG9vbC1jYWxscyM4JylcbiAqICAgLSBQYXJzZWFibGUgKHNwbGl0IG9uICcjJyBmb3Igc3RhZ2VJZCBhbmQgaW5kZXgsIHNwbGl0IHN0YWdlSWQgb24gJy8nIGZvciBzdWJmbG93IHBhdGgpXG4gKlxuICogTmFtaW5nLWNvbGxpc2lvbiB3YXJuaW5nXG4gKiDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIBcbiAqICAgVGhlIHBhcnNlZC1vdXRwdXQgYC5zdGFnZUlkYCBmaWVsZCBiZWxvdyBpcyB0aGUgTE9DQUwgZm9ybSAoc2VnbWVudFxuICogICBhZnRlciB0aGUgbGFzdCAnLycpLiBUaGlzIGlzIE5PVCB0aGUgc2FtZSBhcyBgc3BlYy5pZGAgLyBgbm9kZS5pZGBcbiAqICAgZm9yIHN1YmZsb3ctbmVzdGVkIHN0YWdlcywgd2hpY2ggY2FycnkgdGhlIEZVTEwgcHJlZml4ZWQgZm9ybVxuICogICAoYCdzZi10b29scy9leGVjdXRlLXRvb2wtY2FsbHMnYCkuIFRvIGNvbXBhcmUgc2FmZWx5LCB1c2VcbiAqICAgYHNwbGl0U3RhZ2VJZChzcGVjLmlkKWAgdG8gZGVjb21wb3NlIHRoZSBwcmVmaXhlZCBmb3JtIHRoZSBzYW1lXG4gKiAgIHdheSBgcGFyc2VSdW50aW1lU3RhZ2VJZGAgZGVjb21wb3NlcyBhIHJ1bnRpbWVTdGFnZUlkLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGBcbiAqIGJ1aWxkUnVudGltZVN0YWdlSWQoJ2NhbGwtbGxtJywgNSkgICAgICAgICAgICAgICAgICAgIC8vICdjYWxsLWxsbSM1J1xuICogYnVpbGRSdW50aW1lU3RhZ2VJZCgnZXhlY3V0ZS10b29sLWNhbGxzJywgOCwgJ3NmLXRvb2xzJykgLy8gJ3NmLXRvb2xzL2V4ZWN1dGUtdG9vbC1jYWxscyM4J1xuICogYnVpbGRSdW50aW1lU3RhZ2VJZCgndmFsaWRhdGUnLCAzLCAnc2Ytb3V0ZXIvc2YtaW5uZXInKSAgLy8gJ3NmLW91dGVyL3NmLWlubmVyL3ZhbGlkYXRlIzMnXG4gKiBgYGBcbiAqXG4gKiAjIyBUaGUgb25lIG93bmVyIChGNywgOS4zNy4wKVxuICpcbiAqIFRoaXMgbW9kdWxlIGlzIHRoZSBPTkUgcGxhY2UgdGhlIGdyYW1tYXIgaXMgc3BlbGxlZC4gRXZlcnkgcmVhZGVyIGFza3MgaXQg4oCUXG4gKiBgaXNFeGVjdXRpb25LZXlgLCBgc3RhZ2VJZE9mYCwgYHN1YmZsb3dQYXRoT2ZgLCBgc3ViZmxvd1NlZ21lbnRzT2ZgLFxuICogYGxhc3RTZWdtZW50T2ZgLCBgaXNXaXRoaW5TdWJmbG93YCDigJQgYW5kIGV2ZXJ5IGNvbXBvc2VyIGpvaW5zIHRocm91Z2hcbiAqIGBqb2luUGF0aGAgLyBgYnVpbGRSdW50aW1lU3RhZ2VJZGA7IG5vIG90aGVyIGZpbGUgc3BsaXRzIG9uIGAjYCBvciBgL2AuXG4gKiBJdCBidWlsZHMsIHBhcnNlcyBhbmQgcmVhZHMgaWRzLCBhbmQgaW1wb3J0cyBub3RoaW5nOiBpdCBpcyB0aGUgcmVjb3JkJ3NcbiAqIChDNikuIFRoZSBkZWxpbWl0ZXJzIGFyZSBSRVNFUlZFRCAoUkZDIDM5ODYgwqcyLjIgc3R5bGUpOiB0aGUgZW5naW5lJ3MgaWRcbiAqIGRvb3JzIHJlZnVzZSB0aGVtIGluIHVzZXItYXV0aG9yZWQgaWRzIHRocm91Z2ggT05FIGZ1bmN0aW9uLFxuICogYHJlc2VydmVkSWRzLnRzIMK3IHJlZnVzZVJlc2VydmVkSWRgLCB3aGljaCByZWFkcyB0aGVtIGhlcmUg4oCUIHNvXG4gKiBsYXN0LWRlbGltaXRlciBwYXJzaW5nIGlzIHNvdW5kIGJ5IGNvbnN0cnVjdGlvbiByYXRoZXIgdGhhbiBieSBob3BlLiBTdG9yZXNcbiAqIGFuZCB0aGUgcHJlZml4ZXIgbmV2ZXIgcmVmdXNlIOKAlCB0aGV5IGhvbGQgcnVudGltZSBpZHMgYW5kIHByZWZpeGVkIGlkcyxcbiAqIHdoaWNoIGNhcnJ5IHRoZSBkZWxpbWl0ZXJzIG9uIHB1cnBvc2UuXG4gKi9cblxuLyoqIFNlcGFyYXRlcyBzdWJmbG93IHBhdGggc2VnbWVudHMgZnJvbSBlYWNoIG90aGVyIGFuZCBmcm9tIHRoZSBzdGFnZSBpZC4gKi9cbmV4cG9ydCBjb25zdCBQQVRIX0RFTElNSVRFUiA9ICcvJztcbi8qKiBTZXBhcmF0ZXMgdGhlIChwcmVmaXhlZCkgc3RhZ2UgaWQgZnJvbSB0aGUgZXhlY3V0aW9uIGluZGV4LiAqL1xuZXhwb3J0IGNvbnN0IEVYRUNVVElPTl9ERUxJTUlURVIgPSAnIyc7XG5cbi8vIOKUgOKUgCBCcmFuZHMgKHR5cGVzIG9ubHkg4oCUIFJ1c3QtbmV3dHlwZSBzdHlsZTsgbm8gcnVudGltZSBjb3N0KSDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIBcblxuZGVjbGFyZSBjb25zdCBSVU5USU1FX1NUQUdFX0lEOiB1bmlxdWUgc3ltYm9sO1xuZGVjbGFyZSBjb25zdCBFWEVDVVRJT05fSU5ERVg6IHVuaXF1ZSBzeW1ib2w7XG5kZWNsYXJlIGNvbnN0IENPTU1JVF9JRFg6IHVuaXF1ZSBzeW1ib2w7XG5cbi8qKiBBIGBbc3ViZmxvd1BhdGgvXXN0YWdlSWQjZXhlY3V0aW9uSW5kZXhgIHN0cmluZyB0aGUgZ3JhbW1hciBwcm9kdWNlZC4gQXNzaWduYWJsZSB0byBgc3RyaW5nYC4gKi9cbmV4cG9ydCB0eXBlIFJ1bnRpbWVTdGFnZUlkID0gc3RyaW5nICYgeyByZWFkb25seSBbUlVOVElNRV9TVEFHRV9JRF06IHRydWUgfTtcbi8qKiBUaGUgcnVuLWdsb2JhbCwgbW9ub3RvbmljIHBvc2l0aW9uIG9mIG9uZSBzdGFnZSBleGVjdXRpb24gKHRoZSBgI05gKS4gQXNzaWduYWJsZSB0byBgbnVtYmVyYC4gKi9cbmV4cG9ydCB0eXBlIEV4ZWN1dGlvbkluZGV4ID0gbnVtYmVyICYgeyByZWFkb25seSBbRVhFQ1VUSU9OX0lOREVYXTogdHJ1ZSB9O1xuLyoqIEEgYnVuZGxlJ3MgcG9zaXRpb24gaW4gYSBjb21taXQgbG9nIChgYnVuZGxlLmlkeGApLiBBc3NpZ25hYmxlIHRvIGBudW1iZXJgLiAqL1xuZXhwb3J0IHR5cGUgQ29tbWl0SWR4ID0gbnVtYmVyICYgeyByZWFkb25seSBbQ09NTUlUX0lEWF06IHRydWUgfTtcblxuLyoqXG4gKiBCdWlsZCBhIHJ1bnRpbWVTdGFnZUlkIGZyb20gaXRzIGNvbXBvbmVudHMuXG4gKlxuICogTm90ZTogVGhlIHRyYXZlcnNlciBkb2VzIE5PVCB1c2UgdGhlIHN1YmZsb3dQYXRoIHBhcmFtZXRlciDigJQgbm9kZS5pZCBhbHJlYWR5XG4gKiBpbmNsdWRlcyB0aGUgc3ViZmxvdyBwcmVmaXggZnJvbSB0aGUgYnVpbGRlci4gVGhpcyBwYXJhbWV0ZXIgZXhpc3RzIGZvciBleHRlcm5hbFxuICogY29uc3VtZXJzIGNvbnN0cnVjdGluZyBJRHMgZnJvbSBwYXJzZWQgY29tcG9uZW50cyAocm91bmQtdHJpcCB2aWEgcGFyc2VSdW50aW1lU3RhZ2VJZCkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBidWlsZFJ1bnRpbWVTdGFnZUlkKHN0YWdlSWQ6IHN0cmluZywgZXhlY3V0aW9uSW5kZXg6IG51bWJlciwgc3ViZmxvd1BhdGg/OiBzdHJpbmcpOiBSdW50aW1lU3RhZ2VJZCB7XG4gIGNvbnN0IHByZWZpeCA9IHN1YmZsb3dQYXRoID8gYCR7c3ViZmxvd1BhdGh9JHtQQVRIX0RFTElNSVRFUn1gIDogJyc7XG4gIHJldHVybiBgJHtwcmVmaXh9JHtzdGFnZUlkfSR7RVhFQ1VUSU9OX0RFTElNSVRFUn0ke2V4ZWN1dGlvbkluZGV4fWAgYXMgUnVudGltZVN0YWdlSWQ7XG59XG5cbi8qKlxuICogUGFyc2UgYSBydW50aW1lU3RhZ2VJZCBpbnRvIGl0cyBjb21wb25lbnRzLlxuICpcbiAqIElNUE9SVEFOVCDigJQgbmFtaW5nIGNvbGxpc2lvbjogdGhlIHJldHVybmVkIGBzdGFnZUlkYCBpcyB0aGUgTE9DQUxcbiAqIGZvcm0gKHRoZSBzZWdtZW50IGJldHdlZW4gdGhlIGxhc3QgJy8nIGFuZCB0aGUgJyMnKS4gVGhpcyBpcyBOT1RcbiAqIHRoZSBzYW1lIGFzIGBzcGVjLmlkYCBvciBgbm9kZS5pZGAgZm9yIHN1YmZsb3ctbmVzdGVkIHN0YWdlcyxcbiAqIHdoaWNoIGNvbnRhaW4gdGhlIEZVTEwgcHJlZml4ZWQgZm9ybS5cbiAqXG4gKiAgIHBhcnNlUnVudGltZVN0YWdlSWQoJ3NmLXRvb2xzL2V4ZWN1dGUtdG9vbC1jYWxscyM4Jykuc3RhZ2VJZFxuICogICAvLyDihpIgJ2V4ZWN1dGUtdG9vbC1jYWxscycgICAoTE9DQUwpXG4gKlxuICogICBub2RlLmlkICAvLyAocG9zdC1tb3VudCwgaW4gYSBzcGVjIHRoYXQgY29udGFpbnMgc3ViZmxvd3MpXG4gKiAgIC8vIOKGkiAnc2YtdG9vbHMvZXhlY3V0ZS10b29sLWNhbGxzJyAgIChGVUxMIHByZWZpeGVkKVxuICpcbiAqIFRvIGNvbXBhcmUgdGhlc2UgdHdvIHNhZmVseSwgdXNlIGBzcGxpdFN0YWdlSWQobm9kZS5pZClgIHRvIGdldFxuICogdGhlIGxvY2FsIGZvcm0sIE9SIHJlY29uc3RydWN0IHRoZSBmdWxsIGZvcm0gdmlhXG4gKiBgKHN1YmZsb3dQYXRoID8gc3ViZmxvd1BhdGggKyAnLycgOiAnJykgKyBzdGFnZUlkYC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBhcnNlUnVudGltZVN0YWdlSWQocnVudGltZVN0YWdlSWQ6IHN0cmluZyk6IHtcbiAgc3RhZ2VJZDogc3RyaW5nO1xuICBleGVjdXRpb25JbmRleDogRXhlY3V0aW9uSW5kZXg7XG4gIHN1YmZsb3dQYXRoOiBzdHJpbmcgfCB1bmRlZmluZWQ7XG59IHtcbiAgY29uc3QgaGFzaElkeCA9IHJ1bnRpbWVTdGFnZUlkLmxhc3RJbmRleE9mKEVYRUNVVElPTl9ERUxJTUlURVIpO1xuICBpZiAoaGFzaElkeCA9PT0gLTEpIHtcbiAgICByZXR1cm4geyBzdGFnZUlkOiBydW50aW1lU3RhZ2VJZCwgZXhlY3V0aW9uSW5kZXg6IDAgYXMgRXhlY3V0aW9uSW5kZXgsIHN1YmZsb3dQYXRoOiB1bmRlZmluZWQgfTtcbiAgfVxuXG4gIGNvbnN0IGJlZm9yZUhhc2ggPSBydW50aW1lU3RhZ2VJZC5zbGljZSgwLCBoYXNoSWR4KTtcbiAgY29uc3QgZXhlY3V0aW9uSW5kZXggPSBwYXJzZUludChydW50aW1lU3RhZ2VJZC5zbGljZShoYXNoSWR4ICsgMSksIDEwKSBhcyBFeGVjdXRpb25JbmRleDtcblxuICBjb25zdCBsYXN0U2xhc2ggPSBiZWZvcmVIYXNoLmxhc3RJbmRleE9mKFBBVEhfREVMSU1JVEVSKTtcbiAgaWYgKGxhc3RTbGFzaCA9PT0gLTEpIHtcbiAgICByZXR1cm4geyBzdGFnZUlkOiBiZWZvcmVIYXNoLCBleGVjdXRpb25JbmRleCwgc3ViZmxvd1BhdGg6IHVuZGVmaW5lZCB9O1xuICB9XG5cbiAgcmV0dXJuIHtcbiAgICBzdGFnZUlkOiBiZWZvcmVIYXNoLnNsaWNlKGxhc3RTbGFzaCArIDEpLFxuICAgIGV4ZWN1dGlvbkluZGV4LFxuICAgIHN1YmZsb3dQYXRoOiBiZWZvcmVIYXNoLnNsaWNlKDAsIGxhc3RTbGFzaCksXG4gIH07XG59XG5cbi8qKlxuICogRGVjb21wb3NlIGEgKHBvc3NpYmx5IHByZWZpeGVkKSBzdGFnZSBpZCBpbnRvIGl0cyBjb21wb25lbnRzLlxuICpcbiAqIFVzZSB0aGlzIHdoZW4geW91IGhhdmUgYW4gaWQgV0lUSE9VVCB0aGUgYCNOYCBleGVjdXRpb24gc3VmZml4IGFuZFxuICogbmVlZCB0aGUgbG9jYWwgc3RhZ2UgbmFtZSBhbmQvb3IgdGhlIHN1YmZsb3cgcGF0aC4gQ29tbW9uIHNvdXJjZXNcbiAqIG9mIHN1Y2ggaWRzOlxuICogICAtIGBzcGVjLmlkYCAocG9zdC1tb3VudCB0aGUgaWQgaW5jbHVkZXMgYW55IHN1YmZsb3cgcHJlZml4KVxuICogICAtIGBDb21taXRCdW5kbGUuc3RhZ2VJZGAgKHBvc3QtbW91bnQgaWQpXG4gKiAgIC0gYG5vZGUuaWRgIGZyb20geHlmbG93IG5vZGVzIGJ1aWx0IG9mZiB0aGUgc3BlY1xuICogICAtIHRoZSBzZWdtZW50IG9mIGBydW50aW1lU3RhZ2VJZGAgQkVGT1JFIHRoZSBgI2AgKHVzZVxuICogICAgIGBwYXJzZVJ1bnRpbWVTdGFnZUlkYCBkaXJlY3RseSBmb3IgZnVsbCBydW50aW1lU3RhZ2VJZCBzdHJpbmdzKVxuICpcbiAqIE1pcnJvcnMgdGhlIGRlY29tcG9zaXRpb24gYHBhcnNlUnVudGltZVN0YWdlSWRgIHBlcmZvcm1zIG9uIHRoZVxuICogc3RhZ2VJZCBwb3J0aW9uIG9mIGEgcnVudGltZVN0YWdlSWQsIHNvIHRoZSB0d28gaGVscGVycyBzdGF5IGluXG4gKiBsb2Nrc3RlcCBvbiBuYW1pbmcgYW5kIGJlaGF2aW9yLlxuICpcbiAqIEBleGFtcGxlXG4gKiBzcGxpdFN0YWdlSWQoJ3NmLXRvb2xzL2V4ZWN1dGUtdG9vbC1jYWxscycpXG4gKiAvLyDihpIgeyBsb2NhbFN0YWdlSWQ6ICdleGVjdXRlLXRvb2wtY2FsbHMnLCBzdWJmbG93UGF0aDogJ3NmLXRvb2xzJyB9XG4gKlxuICogc3BsaXRTdGFnZUlkKCdleGVjdXRlLXRvb2wtY2FsbHMnKVxuICogLy8g4oaSIHsgbG9jYWxTdGFnZUlkOiAnZXhlY3V0ZS10b29sLWNhbGxzJywgc3ViZmxvd1BhdGg6IHVuZGVmaW5lZCB9XG4gKlxuICogc3BsaXRTdGFnZUlkKCdzZi1vdXRlci9zZi1pbm5lci92YWxpZGF0ZScpXG4gKiAvLyDihpIgeyBsb2NhbFN0YWdlSWQ6ICd2YWxpZGF0ZScsIHN1YmZsb3dQYXRoOiAnc2Ytb3V0ZXIvc2YtaW5uZXInIH1cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHNwbGl0U3RhZ2VJZChwcmVmaXhlZFN0YWdlSWQ6IHN0cmluZyk6IHtcbiAgbG9jYWxTdGFnZUlkOiBzdHJpbmc7XG4gIHN1YmZsb3dQYXRoOiBzdHJpbmcgfCB1bmRlZmluZWQ7XG59IHtcbiAgY29uc3QgbGFzdFNsYXNoID0gcHJlZml4ZWRTdGFnZUlkLmxhc3RJbmRleE9mKFBBVEhfREVMSU1JVEVSKTtcbiAgaWYgKGxhc3RTbGFzaCA9PT0gLTEpIHtcbiAgICByZXR1cm4geyBsb2NhbFN0YWdlSWQ6IHByZWZpeGVkU3RhZ2VJZCwgc3ViZmxvd1BhdGg6IHVuZGVmaW5lZCB9O1xuICB9XG4gIHJldHVybiB7XG4gICAgbG9jYWxTdGFnZUlkOiBwcmVmaXhlZFN0YWdlSWQuc2xpY2UobGFzdFNsYXNoICsgMSksXG4gICAgc3ViZmxvd1BhdGg6IHByZWZpeGVkU3RhZ2VJZC5zbGljZSgwLCBsYXN0U2xhc2gpLFxuICB9O1xufVxuXG4vKipcbiAqIFRydWUgd2hlbiBga2V5YCBuYW1lcyBvbmUgRVhFQ1VUSU9OIChg4oCmI05gKSByYXRoZXIgdGhhbiBhIHN0YWdlIG9yIGEgc3ViZmxvd1xuICogcGF0aC4gSXRzIHByZXNlbmNlIGFsb25lIGRlY2lkZXM6IHRoZSBkZWxpbWl0ZXIgaXMgcmVzZXJ2ZWQgaW4gZXZlcnlcbiAqIHVzZXItYXV0aG9yZWQgaWQgKGByZXNlcnZlZElkcy50cyDCtyByZWZ1c2VSZXNlcnZlZElkYCksIHNvIG9ubHkgdGhlIGdyYW1tYXJcbiAqIHB1dHMgaXQgdGhlcmUuXG4gKlxuICogQXNrZWQgd2hlcmUgYSBtYXAgaXMga2V5ZWQgYnkgYm90aCDigJQgYHN1YmZsb3dSZXN1bHRzYCBpcyBkdWFsLWtleWVkIGJ5XG4gKiBzdWJmbG93IHBhdGggQU5EIGJ5IG1vdW50IHJ1bnRpbWVTdGFnZUlkLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNFeGVjdXRpb25LZXkoa2V5OiBzdHJpbmcpOiBib29sZWFuIHtcbiAgcmV0dXJuIGtleS5pbmNsdWRlcyhFWEVDVVRJT05fREVMSU1JVEVSKTtcbn1cblxuLyoqXG4gKiBUaGUgRlVMTCAoc3ViZmxvdy1wcmVmaXhlZCkgc3RhZ2UgaWQgb2YgYSBydW50aW1lU3RhZ2VJZCDigJQgZXZlcnl0aGluZyBiZWZvcmVcbiAqIHRoZSBsYXN0IGAjYCwgaS5lLiB3aGF0IGBub2RlLmlkYCAvIGBDb21taXRCdW5kbGUuc3RhZ2VJZGAgaG9sZC4gQSBzdHJpbmdcbiAqIHdpdGggbm8gYCNgIGlzIHJldHVybmVkIHdob2xlLlxuICpcbiAqIEBleGFtcGxlIHN0YWdlSWRPZignc2YtdG9vbHMvZXhlY3V0ZSM4JykgLy8gJ3NmLXRvb2xzL2V4ZWN1dGUnXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzdGFnZUlkT2YocnVudGltZVN0YWdlSWQ6IHN0cmluZyk6IHN0cmluZyB7XG4gIGNvbnN0IGhhc2hJZHggPSBydW50aW1lU3RhZ2VJZC5sYXN0SW5kZXhPZihFWEVDVVRJT05fREVMSU1JVEVSKTtcbiAgcmV0dXJuIGhhc2hJZHggPT09IC0xID8gcnVudGltZVN0YWdlSWQgOiBydW50aW1lU3RhZ2VJZC5zbGljZSgwLCBoYXNoSWR4KTtcbn1cblxuLyoqIFRoZSBleGVjdXRpb24gaW5kZXggb2YgYSBydW50aW1lU3RhZ2VJZCwgb3IgYE5hTmAgd2hlbiBpdCBjYXJyaWVzIG5vbmUuICovXG5leHBvcnQgZnVuY3Rpb24gZXhlY3V0aW9uSW5kZXhPZihydW50aW1lU3RhZ2VJZDogc3RyaW5nKTogbnVtYmVyIHtcbiAgY29uc3QgaGFzaElkeCA9IHJ1bnRpbWVTdGFnZUlkLmxhc3RJbmRleE9mKEVYRUNVVElPTl9ERUxJTUlURVIpO1xuICByZXR1cm4gaGFzaElkeCA9PT0gLTEgPyBOYU4gOiBOdW1iZXIucGFyc2VJbnQocnVudGltZVN0YWdlSWQuc2xpY2UoaGFzaElkeCArIDEpLCAxMCk7XG59XG5cbi8qKlxuICogVGhlIHN1YmZsb3cgcGF0aCBhIHJ1bnRpbWVTdGFnZUlkIGV4ZWN1dGVzIGluIChgJ3NmLWEvc2YtYidgKSwgb3JcbiAqIGB1bmRlZmluZWRgIGF0IHRoZSB0b3AgbGV2ZWwuIFJlYWRzIHRoZSBzdGFnZS1pZCBwYXJ0LCBzbyBpdCBhZ3JlZXMgd2l0aFxuICogYHNwbGl0U3RhZ2VJZChzdGFnZUlkT2YocmlkKSkuc3ViZmxvd1BhdGhgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc3ViZmxvd1BhdGhPZihydW50aW1lU3RhZ2VJZDogc3RyaW5nKTogc3RyaW5nIHwgdW5kZWZpbmVkIHtcbiAgcmV0dXJuIHNwbGl0U3RhZ2VJZChzdGFnZUlkT2YocnVudGltZVN0YWdlSWQpKS5zdWJmbG93UGF0aDtcbn1cblxuLyoqIFRoZSBzdWJmbG93IHBhdGggb2YgYSBydW50aW1lU3RhZ2VJZCBhcyBzZWdtZW50cyAoYFsnc2YtYScsICdzZi1iJ11gKTsgYFtdYCBhdCB0aGUgdG9wIGxldmVsLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHN1YmZsb3dTZWdtZW50c09mKHJ1bnRpbWVTdGFnZUlkOiBzdHJpbmcpOiBzdHJpbmdbXSB7XG4gIGNvbnN0IHBhdGggPSBzdWJmbG93UGF0aE9mKHJ1bnRpbWVTdGFnZUlkKTtcbiAgcmV0dXJuIHBhdGggPT09IHVuZGVmaW5lZCA/IFtdIDogcGF0aC5zcGxpdChQQVRIX0RFTElNSVRFUik7XG59XG5cbi8qKiBUaGUgbm9uLWVtcHR5IHNlZ21lbnRzIG9mIGEgc3ViZmxvdyBwYXRoIG9yIHByZWZpeGVkIGlkIChgJ2EvL2IvJ2Ag4oaSIGBbJ2EnLCAnYiddYCkuICovXG5leHBvcnQgZnVuY3Rpb24gcGF0aFNlZ21lbnRzKHBhdGg6IHN0cmluZyk6IHN0cmluZ1tdIHtcbiAgcmV0dXJuIHBhdGguc3BsaXQoUEFUSF9ERUxJTUlURVIpLmZpbHRlcigocykgPT4gcy5sZW5ndGggPiAwKTtcbn1cblxuLyoqIFRoZSBsYXN0IHNlZ21lbnQgb2YgYSBwYXRoIG9yIHByZWZpeGVkIGlkIChgJ3NmLWEvc2YtYidgIOKGkiBgJ3NmLWInYCk7IHRoZSB3aG9sZSBzdHJpbmcgd2hlbiBpdCBoYXMgbm9uZS4gKi9cbmV4cG9ydCBmdW5jdGlvbiBsYXN0U2VnbWVudE9mKHBhdGg6IHN0cmluZyk6IHN0cmluZyB7XG4gIHJldHVybiBwYXRoLnNsaWNlKHBhdGgubGFzdEluZGV4T2YoUEFUSF9ERUxJTUlURVIpICsgMSk7XG59XG5cbi8qKiBKb2luIHBhdGggc2VnbWVudHMgd2l0aCB0aGUgZ3JhbW1hcidzIGRlbGltaXRlciAoYGpvaW5QYXRoKCdzZicsICdzdGFnZScpYCDihpIgYCdzZi9zdGFnZSdgKS4gKi9cbmV4cG9ydCBmdW5jdGlvbiBqb2luUGF0aCguLi5zZWdtZW50czogcmVhZG9ubHkgc3RyaW5nW10pOiBzdHJpbmcge1xuICByZXR1cm4gc2VnbWVudHMuam9pbihQQVRIX0RFTElNSVRFUik7XG59XG5cbi8qKiBUcnVlIHdoZW4gdGhlIChwcmVmaXhlZCkgaWQgYGlkYCBzaXRzIElOU0lERSB0aGUgc3ViZmxvdyBhdCBgcGF0aGAg4oCUIGF0IGFueSBkZXB0aCBiZWxvdyBpdC4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1dpdGhpblN1YmZsb3coaWQ6IHN0cmluZywgcGF0aDogc3RyaW5nKTogYm9vbGVhbiB7XG4gIHJldHVybiBpZC5zdGFydHNXaXRoKGAke3BhdGh9JHtQQVRIX0RFTElNSVRFUn1gKTtcbn1cblxuLyoqXG4gKiBTaGFyZWQgbXV0YWJsZSBjb3VudGVyIGZvciBleGVjdXRpb24gaW5kZXguXG4gKiBQYXNzZWQgYnkgcmVmZXJlbmNlIHRvIGNoaWxkIHRyYXZlcnNlcnMgKHN1YmZsb3dzKSBzbyB0aGV5XG4gKiBjb250aW51ZSB0aGUgZ2xvYmFsIG51bWJlcmluZyBpbnN0ZWFkIG9mIHJlc3RhcnRpbmcgYXQgMC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBFeGVjdXRpb25Db3VudGVyIHtcbiAgdmFsdWU6IG51bWJlcjtcbn1cblxuLyoqIENyZWF0ZSBhIG5ldyBleGVjdXRpb24gY291bnRlciBzdGFydGluZyBhdCAwLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGNyZWF0ZUV4ZWN1dGlvbkNvdW50ZXIoKTogRXhlY3V0aW9uQ291bnRlciB7XG4gIHJldHVybiB7IHZhbHVlOiAwIH07XG59XG4iXX0=
@@ -1,105 +0,0 @@
1
- /**
2
- * EventLog — Time-travel snapshot storage for flowchart execution
3
- *
4
- * Like git history: stores commit bundles (diffs), not full snapshots.
5
- *
6
- * THE RECORD IS IMMUTABLE FROM `record` (F3, ruling R3). Every bundle is deep-frozen as it is
7
- * recorded — the bundle, `overwrite` and `updates` at every depth, the trace and each row, the
8
- * row's `readKeys`, `redactedPaths`, `tags`, `untrackedSources` — so a holder of a snapshot can no
9
- * longer rewrite the history every later answer is folded from: an assignment into a bundle throws
10
- * a `TypeError` in strict code. Safe because nothing outside the log holds a bundle's containers:
11
- * the log's payload is the commit's own copy (`recordCommit` hands it the output of
12
- * `scrubPatch`), and live state, the redacted mirror and write retention each take their own copy
13
- * (`verbs.ts · foldRows` detaches, `StageContext · retainedForm` clones) — pinned by
14
- * test/lib/memory/property/record-reachability.property.test.ts.
15
- *
16
- * What `Object.freeze` cannot seal — a Date's time, a Map's or Set's entries, a buffer's bytes, a
17
- * RegExp, an Error's stack — is never handed out to a reader (9.44.2): `record` remembers that a
18
- * bundle holds such a value (`capture/freeze.ts · freezeRecord`), and `list()` — like the public
19
- * snapshot, `runner/snapshot.ts · servedSnapshot` — serves that bundle as a copy of its open paths
20
- * (`serveRecord`, mapped at its first serve): fresh frozen containers down to each such value, a
21
- * fresh copy of it, every other part the log's own. A reader edits only its own copy; every later
22
- * serve reads the record as recorded. `recorded()` is the engine's own, unserved read. Named holes: an object hung on an array EXPANDO (arrays are walked
23
- * by index — the `'indices'` walk, which keeps the freeze inside its budget; an expando is out of
24
- * contract for state) and a `SharedArrayBuffer` (every copy shares its memory). A frozen RegExp's
25
- * `lastIndex` is read-only, so a `/g` or `/y` regex read from a bundle throws when `exec` or
26
- * `replace` advance it.
27
- */
28
- import type { EmitSourcePosition, LogAddress } from './eventPosition.js';
29
- import type { CommitBundle } from './types.js';
30
- export declare class EventLog {
31
- /** Base snapshot BEFORE the first stage mutates anything. */
32
- private base;
33
- /** Ordered list of commit bundles. */
34
- private steps;
35
- private sourceAddress?;
36
- private sourceAddressRetired;
37
- constructor(initialMemory: any);
38
- /**
39
- * The fold BASE — the state as it stood before the first commit.
40
- *
41
- * This is the other half of the commit log: bundles are DIFFS, so a log
42
- * alone cannot reconstruct state that was seeded before the run (an
43
- * executor `initialContext`, `defaultValuesForContext`, a resume's
44
- * `checkpoint.sharedState`, a subflow's `inputMapper` seed). Travelling
45
- * with the log — `RuntimeSnapshot.initialState` — is what lets an OFFLINE
46
- * consumer fold; without it the honest answer is a partial one
47
- * (`stateAt`'s `basis: 'log-only'`).
48
- *
49
- * Returns a fresh detached clone on every call — the caller owns it.
50
- */
51
- getInitialState(): any;
52
- /**
53
- * Reconstructs the full state at any given step.
54
- * Replays commits from the beginning — O(n) but low memory footprint.
55
- *
56
- * INDEX CONVENTION — `stepIdx` is EXCLUSIVE: `materialise(3)` folds commits
57
- * 0, 1 and 2. `stateAt(source, commitIdx)` (footprintjs/trace) folds the
58
- * same log but its `commitIdx` is INCLUSIVE, because a reader's cursor asks
59
- * "the state AT this stop", which must include that stop's own commit. Two
60
- * folds over one log with opposite conventions: check which one you hold.
61
- *
62
- * One clone of the base per call, then every bundle replayed INTO that
63
- * private copy (`applySmartMergeInto` — the live commit's copy-on-write law
64
- * below the root, 9.29.0, so the fold and the live state agree at every
65
- * path). The result is the caller's: it shares nothing with the base or
66
- * the log.
67
- *
68
- * @deprecated Since 9.33.0 — use `stateAt` from `footprintjs/trace`, which folds the same log
69
- * from the same base (`RuntimeSnapshot.initialState`) and says how it was derived (`basis`).
70
- * Nothing in the library calls this; it stays for one minor and is then removed. Mind the
71
- * index: `materialise(n)` folds commits `0..n-1`, `stateAt(source, n - 1)` the same commits.
72
- */
73
- materialise(stepIdx?: number): any;
74
- /**
75
- * Persists a commit bundle for a finished stage, and FREEZES it (see the module doc): the bundle
76
- * is stamped with its position, then deep-frozen, then appended. The engine hands it a bundle
77
- * built for the log alone; a caller of this class (`footprintjs/write`) hands over a bundle it
78
- * will no longer edit — its own object is the one frozen.
79
- */
80
- record(bundle: CommitBundle): void;
81
- /**
82
- * Every recorded commit bundle, AS SERVED (9.44.2): a new array each call; a bundle freezing sealed
83
- * whole is the log's own (frozen) object, one holding a Date, Map, buffer … is a copy of its open
84
- * paths (`capture/freeze.ts · serveRecord`) — the reader's own, so no edit reaches the log.
85
- */
86
- list(): CommitBundle[];
87
- /**
88
- * @internal The bundles as the log holds them — each frozen, NOT served — in a new array, so a holder's
89
- * `splice` reaches only its own. For the engine's own snapshot (`ExecutionRuntime · getSnapshot`, which
90
- * a subflow mount takes once per mount), so the run serves nothing; a reader is served by `list()` and
91
- * `getSnapshot().commitLog`. A known open door (CHANGELOG 9.44.2): a holder of these bundles can still
92
- * edit a Date, Map or buffer inside them.
93
- */
94
- recorded(): CommitBundle[];
95
- /** Number of recorded commits. */
96
- get length(): number;
97
- /** Immutable identity of this log, absent until the engine binds it. */
98
- get address(): LogAddress | undefined;
99
- /** @internal Bind once; resuming the same log must not rename its earlier positions. */
100
- bindAddress(logRunId: string, drillPath: readonly string[]): void;
101
- /** O(1) source-time capture. No counter, observer bookkeeping, or future commit prediction. */
102
- capturePosition(runId: string): EmitSourcePosition | undefined;
103
- /** Wipes history (useful for test resets). */
104
- clear(): void;
105
- }