@wenathlan/devthink 2.0.15 → 2.0.19

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 (444) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/{dist/bridge.d.ts → bridge.d.ts} +1 -1
  3. package/bridge.d.ts.map +1 -0
  4. package/bridge.js +1877 -0
  5. package/bun.d.ts.map +1 -0
  6. package/bun.js +52329 -0
  7. package/caps/background.json +712 -0
  8. package/caps/cli.json +360 -0
  9. package/caps/library.json +3611 -0
  10. package/caps/mcp.json +126 -0
  11. package/caps/pagebridge.json +377 -0
  12. package/caps/popup.json +51 -0
  13. package/caps/sidepanel.json +522 -0
  14. package/checksums.txt +142 -0
  15. package/cli.d.ts.map +1 -0
  16. package/{dist/cli.js → cli.js} +2 -2
  17. package/companion.d.ts.map +1 -0
  18. package/companion.js +389 -0
  19. package/crossbrowser.d.ts.map +1 -0
  20. package/crossbrowser.js +1191 -0
  21. package/dashdone.d.ts.map +1 -0
  22. package/dashdone.js +368 -0
  23. package/deno.d.ts.map +1 -0
  24. package/deno.js +52325 -0
  25. package/devthink.umd.js +52346 -0
  26. package/fixtures/bun.ts +7 -0
  27. package/fixtures/cjs.js +6 -0
  28. package/fixtures/deno.ts +6 -0
  29. package/fixtures/example-org-pagestate.json +22 -0
  30. package/fixtures/importers/automa-workflow.json +18 -0
  31. package/fixtures/importers/selenium-side.json +20 -0
  32. package/fixtures/importers/tabular-plan.csv +7 -0
  33. package/fixtures/importers/uivision-macro.json +10 -0
  34. package/fixtures/importers/v1-plan.json +13 -0
  35. package/fixtures/mcp-client.mjs +14 -0
  36. package/fixtures/pages/checkout.html +192 -0
  37. package/fixtures/pages/dashboard.html +110 -0
  38. package/fixtures/pages/feed.html +113 -0
  39. package/fixtures/pages/product-grid.html +150 -0
  40. package/fixtures/plans/form-inventory-plan.json +11 -0
  41. package/fixtures/plans/release-notes-plan.json +11 -0
  42. package/fixtures/recipes/agentscompete.json +11 -0
  43. package/fixtures/recipes/agentsforms.json +11 -0
  44. package/fixtures/recipes/agentsmonitor.json +11 -0
  45. package/fixtures/recipes/agentsreview.json +29 -0
  46. package/fixtures/recipes/agentswarm.json +11 -0
  47. package/fixtures/recipes/fillcalendar.json +12 -0
  48. package/fixtures/recipes/fillcheckout.json +13 -0
  49. package/fixtures/recipes/filldependentdropdowns.json +12 -0
  50. package/fixtures/recipes/fillfromcsv.json +13 -0
  51. package/fixtures/recipes/fillloginform.json +12 -0
  52. package/fixtures/recipes/fillmultistepwizard.json +13 -0
  53. package/fixtures/recipes/fillregistration.json +12 -0
  54. package/fixtures/recipes/fillsearchfilters.json +12 -0
  55. package/fixtures/recipes/filltypeahead.json +11 -0
  56. package/fixtures/recipes/monitoralerts.json +12 -0
  57. package/fixtures/recipes/monitoravailability.json +11 -0
  58. package/fixtures/recipes/monitornetworkquiet.json +12 -0
  59. package/fixtures/recipes/monitorpagechanges.json +11 -0
  60. package/fixtures/recipes/monitorpricechange.json +11 -0
  61. package/fixtures/recipes/monitorschedule.json +12 -0
  62. package/fixtures/recipes/scrapedynamicprices.json +13 -0
  63. package/fixtures/recipes/scrapeimagegallery.json +12 -0
  64. package/fixtures/recipes/scrapeinfinitefeed.json +13 -0
  65. package/fixtures/recipes/scrapenestedlists.json +12 -0
  66. package/fixtures/recipes/scrapeproductgrid.json +12 -0
  67. package/fixtures/recipes/scrapereviews.json +12 -0
  68. package/fixtures/recipes/scrapesearchresults.json +12 -0
  69. package/fixtures/recipes/scrapetablepagination.json +12 -0
  70. package/fixtures/recipes/testaccessibility.json +34 -0
  71. package/fixtures/recipes/testconsoleerrors.json +12 -0
  72. package/fixtures/recipes/testdeeplinks.json +12 -0
  73. package/fixtures/recipes/testformvalidation.json +13 -0
  74. package/fixtures/recipes/testlayoutshift.json +12 -0
  75. package/fixtures/recipes/testlinkcheck.json +12 -0
  76. package/fixtures/recipes/testloadtiming.json +12 -0
  77. package/fixtures/recipes/testvisualdiff.json +12 -0
  78. package/fixtures/workflows/changelog-digest-workflow.json +13 -0
  79. package/fixtures/workflows/form-survey-workflow.json +13 -0
  80. package/gallery.json +706 -0
  81. package/hardening.d.ts.map +1 -0
  82. package/hardening.js +188 -0
  83. package/headless.d.ts.map +1 -0
  84. package/headless.js +11522 -0
  85. package/http.d.ts.map +1 -0
  86. package/http.js +2165 -0
  87. package/index.cjs +54682 -0
  88. package/index.d.ts.map +1 -0
  89. package/index.js +52310 -0
  90. package/index.neutral.js +46343 -0
  91. package/{web/manifest.json → manifest.json} +1 -1
  92. package/mcp.d.ts.map +1 -0
  93. package/mcp.js +20515 -0
  94. package/memory.d.ts.map +1 -0
  95. package/{memory.ts → memory.js} +2310 -3834
  96. package/nativehost.template.json +10 -0
  97. package/node.cjs +54686 -0
  98. package/node.d.ts.map +1 -0
  99. package/pack.d.ts.map +1 -0
  100. package/pack.js +805 -0
  101. package/package.json +83 -176
  102. package/policy.d.ts.map +1 -0
  103. package/{policy.ts → policy.js} +4679 -5073
  104. package/progress.d.ts.map +1 -0
  105. package/progress.js +645 -0
  106. package/protocol.d.ts.map +1 -0
  107. package/protocol.js +8334 -0
  108. package/schemas/audit.schema.json +226 -0
  109. package/schemas/capability.schema.json +113 -0
  110. package/schemas/envelope.schema.json +162 -0
  111. package/schemas/memory.schema.json +51 -0
  112. package/schemas/observation.schema.json +113 -0
  113. package/schemas/plan.schema.json +208 -0
  114. package/schemas/progress.schema.json +126 -0
  115. package/schemas/proposal.schema.json +68 -0
  116. package/schemas/session.schema.json +82 -0
  117. package/schemas/tool.schema.json +94 -0
  118. package/server.d.ts.map +1 -0
  119. package/server.js +28877 -0
  120. package/umd-example.html +18 -0
  121. package/umd.d.ts.map +1 -0
  122. package/accounts.ts +0 -2087
  123. package/agent.ts +0 -2331
  124. package/antigravity.ts +0 -2139
  125. package/apifreeze.ts +0 -4146
  126. package/auth.ts +0 -642
  127. package/background.ts +0 -16837
  128. package/bridge.ts +0 -2080
  129. package/build.ts +0 -54
  130. package/bun.ts +0 -26
  131. package/capture.ts +0 -1614
  132. package/checksecrets.ts +0 -72
  133. package/cjs.ts +0 -9
  134. package/cli.ts +0 -3500
  135. package/commands.ts +0 -1101
  136. package/companion.ts +0 -450
  137. package/compatibility.ts +0 -37
  138. package/config.ts +0 -3137
  139. package/constants.ts +0 -943
  140. package/core.ts +0 -1473
  141. package/crossbrowser.ts +0 -1359
  142. package/dashdone.ts +0 -605
  143. package/data.ts +0 -943
  144. package/database.ts +0 -133
  145. package/debug.ts +0 -850
  146. package/deno.ts +0 -27
  147. package/devthink.ts +0 -707
  148. package/dist/accounts.d.ts +0 -409
  149. package/dist/agent.d.ts +0 -837
  150. package/dist/antigravity.d.ts +0 -380
  151. package/dist/apifreeze.d.ts +0 -113
  152. package/dist/auth.d.ts +0 -224
  153. package/dist/capture.d.ts +0 -595
  154. package/dist/cjs.d.ts +0 -6
  155. package/dist/commands.d.ts +0 -310
  156. package/dist/compatibility.d.ts +0 -17
  157. package/dist/config.d.ts +0 -1853
  158. package/dist/constants.d.ts +0 -637
  159. package/dist/core.d.ts +0 -361
  160. package/dist/data.d.ts +0 -330
  161. package/dist/database.d.ts +0 -24
  162. package/dist/debug.d.ts +0 -270
  163. package/dist/engine.d.ts +0 -74
  164. package/dist/environments.d.ts +0 -244
  165. package/dist/evidence.d.ts +0 -277
  166. package/dist/export.d.ts +0 -311
  167. package/dist/fingerprint.d.ts +0 -594
  168. package/dist/flow.d.ts +0 -300
  169. package/dist/gates.d.ts +0 -103
  170. package/dist/identity.d.ts +0 -51
  171. package/dist/ids.d.ts +0 -7
  172. package/dist/llm.d.ts +0 -652
  173. package/dist/models.d.ts +0 -1807
  174. package/dist/net.d.ts +0 -325
  175. package/dist/neutral.d.ts +0 -41
  176. package/dist/oauth.d.ts +0 -703
  177. package/dist/page.d.ts +0 -1166
  178. package/dist/perf.d.ts +0 -481
  179. package/dist/plan.d.ts +0 -134
  180. package/dist/project.d.ts +0 -395
  181. package/dist/providers.d.ts +0 -37
  182. package/dist/quota.d.ts +0 -453
  183. package/dist/recovery.d.ts +0 -621
  184. package/dist/request.d.ts +0 -1492
  185. package/dist/run.d.ts +0 -779
  186. package/dist/runtime.d.ts +0 -212
  187. package/dist/search.d.ts +0 -375
  188. package/dist/security.d.ts +0 -534
  189. package/dist/serve.d.ts +0 -136
  190. package/dist/session.d.ts +0 -296
  191. package/dist/storage.d.ts +0 -53
  192. package/dist/streaming.d.ts +0 -1119
  193. package/dist/swarm.d.ts +0 -328
  194. package/dist/tools.d.ts +0 -170
  195. package/dist/types.d.ts +0 -8357
  196. package/dist/utils.d.ts +0 -82
  197. package/dist/version.d.ts +0 -7
  198. package/dist/versionregistry.d.ts +0 -406
  199. package/dist/views.d.ts +0 -579
  200. package/dist/workbenchsession.d.ts +0 -69
  201. package/dist/workflow.d.ts +0 -649
  202. package/docs/readme.md +0 -92
  203. package/docs/schemas/antigravity.json +0 -192
  204. package/engine.ts +0 -1524
  205. package/environments.ts +0 -1005
  206. package/evidence.ts +0 -643
  207. package/export.ts +0 -889
  208. package/fingerprint.ts +0 -1458
  209. package/flow.ts +0 -1190
  210. package/gates.ts +0 -307
  211. package/gateway.ts +0 -34
  212. package/hardening.ts +0 -191
  213. package/headless.ts +0 -369
  214. package/http.ts +0 -2110
  215. package/identity.ts +0 -246
  216. package/ids.ts +0 -26
  217. package/index.ts +0 -369
  218. package/llm.ts +0 -2682
  219. package/mcp.ts +0 -1835
  220. package/models.ts +0 -3805
  221. package/modes.ts +0 -43
  222. package/net.ts +0 -1214
  223. package/neutral.ts +0 -362
  224. package/node.ts +0 -26
  225. package/oauth.ts +0 -2216
  226. package/offscreen.ts +0 -170
  227. package/pack.ts +0 -956
  228. package/page.ts +0 -7824
  229. package/pagebridge.ts +0 -1116
  230. package/perf.ts +0 -957
  231. package/plan.ts +0 -672
  232. package/plugin.ts +0 -76
  233. package/prisma.config.ts +0 -27
  234. package/progress.ts +0 -1308
  235. package/project.ts +0 -1291
  236. package/protocol.ts +0 -4187
  237. package/providers.ts +0 -246
  238. package/quota.ts +0 -1887
  239. package/recovery.ts +0 -2433
  240. package/request.ts +0 -4482
  241. package/run.ts +0 -2135
  242. package/runtime.ts +0 -526
  243. package/search.ts +0 -1760
  244. package/security.ts +0 -1673
  245. package/serve.ts +0 -419
  246. package/server.ts +0 -5538
  247. package/session.ts +0 -1162
  248. package/storage.ts +0 -182
  249. package/streaming.ts +0 -4101
  250. package/swarm.ts +0 -884
  251. package/sync.ts +0 -56
  252. package/tests/agentcert.test.ts +0 -128
  253. package/tests/agentfleet.test.ts +0 -214
  254. package/tests/agentreview.test.ts +0 -241
  255. package/tests/agentstream.test.ts +0 -335
  256. package/tests/agentwork.test.ts +0 -356
  257. package/tests/apifreeze.test.ts +0 -290
  258. package/tests/apimap.test.ts +0 -112
  259. package/tests/approvalgate.test.ts +0 -175
  260. package/tests/artifactmanifest.test.ts +0 -204
  261. package/tests/attentionfeed.test.ts +0 -163
  262. package/tests/backgroundruns.test.ts +0 -100
  263. package/tests/batchscheduling.test.ts +0 -131
  264. package/tests/blackboard.test.ts +0 -238
  265. package/tests/bridge.test.ts +0 -1088
  266. package/tests/browsercoverage.test.ts +0 -134
  267. package/tests/browserpolyfills.test.ts +0 -124
  268. package/tests/build.mjs +0 -1260
  269. package/tests/clientauth.test.ts +0 -223
  270. package/tests/clitools.test.ts +0 -578
  271. package/tests/confirmgates.test.ts +0 -190
  272. package/tests/containerpack.test.ts +0 -143
  273. package/tests/controlflow.test.ts +0 -2120
  274. package/tests/coordination.test.ts +0 -345
  275. package/tests/copyscreen.test.ts +0 -139
  276. package/tests/core.test.ts +0 -417
  277. package/tests/costcert.test.ts +0 -95
  278. package/tests/crossbrowser.test.ts +0 -115
  279. package/tests/cspaudit.test.ts +0 -79
  280. package/tests/dashdone.test.ts +0 -615
  281. package/tests/datagrid.test.ts +0 -137
  282. package/tests/doccheck.test.ts +0 -107
  283. package/tests/dombatch.test.ts +0 -109
  284. package/tests/emulation.test.ts +0 -282
  285. package/tests/environments.test.ts +0 -259
  286. package/tests/evidenceviews.test.ts +0 -88
  287. package/tests/exporttools.test.ts +0 -185
  288. package/tests/firefoxprep.test.ts +0 -134
  289. package/tests/flowlibrary.test.ts +0 -242
  290. package/tests/flowrun.test.ts +0 -303
  291. package/tests/forensics.test.ts +0 -439
  292. package/tests/gateway.test.ts +0 -939
  293. package/tests/headlesslib.test.ts +0 -171
  294. package/tests/httpstream.test.ts +0 -277
  295. package/tests/immutablelog.test.ts +0 -157
  296. package/tests/inboundguard.test.ts +0 -177
  297. package/tests/lazyload.test.ts +0 -72
  298. package/tests/librarymodes.test.ts +0 -623
  299. package/tests/llm.test.ts +0 -696
  300. package/tests/manifest.test.ts +0 -226
  301. package/tests/maskinputs.test.ts +0 -150
  302. package/tests/matrixverify.test.ts +0 -111
  303. package/tests/mavenpack.test.ts +0 -75
  304. package/tests/mcpserver.test.ts +0 -704
  305. package/tests/memory.test.ts +0 -4155
  306. package/tests/memorycare.test.ts +0 -230
  307. package/tests/migrateplan.test.ts +0 -349
  308. package/tests/minimization.test.ts +0 -414
  309. package/tests/modelroute.test.ts +0 -112
  310. package/tests/multiagent.test.ts +0 -440
  311. package/tests/nativebridge.test.ts +0 -807
  312. package/tests/navigation.test.ts +0 -284
  313. package/tests/nugetpack.test.ts +0 -83
  314. package/tests/orchestration.test.ts +0 -449
  315. package/tests/originpolicy.test.ts +0 -405
  316. package/tests/outputcompare.test.ts +0 -97
  317. package/tests/package.test.ts +0 -91
  318. package/tests/pagebridge.test.ts +0 -5909
  319. package/tests/pentest.test.ts +0 -75
  320. package/tests/perfrecords.test.ts +0 -257
  321. package/tests/permdiff.test.ts +0 -85
  322. package/tests/phishguard.test.ts +0 -128
  323. package/tests/pickerviews.test.ts +0 -155
  324. package/tests/pipelines.test.ts +0 -381
  325. package/tests/planlint.test.ts +0 -240
  326. package/tests/planreview.test.ts +0 -383
  327. package/tests/platformtargets.test.ts +0 -56
  328. package/tests/policy.test.ts +0 -8284
  329. package/tests/portability.test.ts +0 -96
  330. package/tests/progress.test.ts +0 -1036
  331. package/tests/promptlibrary.test.ts +0 -116
  332. package/tests/protocol.test.ts +0 -4793
  333. package/tests/publishingpipeline.test.ts +0 -314
  334. package/tests/quickactions.test.ts +0 -164
  335. package/tests/readiness.test.ts +0 -78
  336. package/tests/recipes.test.ts +0 -163
  337. package/tests/redactshots.test.ts +0 -216
  338. package/tests/registernvidiakeys.ts +0 -51
  339. package/tests/relayserve.test.ts +0 -304
  340. package/tests/releasenotes.test.ts +0 -276
  341. package/tests/resilience.test.ts +0 -467
  342. package/tests/resourceaware.test.ts +0 -187
  343. package/tests/runbudget.test.ts +0 -125
  344. package/tests/runhistory.test.ts +0 -299
  345. package/tests/runreplay.test.ts +0 -113
  346. package/tests/runresume.test.ts +0 -184
  347. package/tests/runstate.test.ts +0 -288
  348. package/tests/runtimeadapters.test.ts +0 -251
  349. package/tests/safariskeleton.test.ts +0 -115
  350. package/tests/sandboxframe.test.ts +0 -196
  351. package/tests/sbom.test.ts +0 -105
  352. package/tests/secretvault.test.ts +0 -188
  353. package/tests/selcache.test.ts +0 -111
  354. package/tests/sessioninterface.test.ts +0 -791
  355. package/tests/sessions.test.ts +0 -591
  356. package/tests/siteprefs.test.ts +0 -228
  357. package/tests/snapshotdelta.test.ts +0 -165
  358. package/tests/statusviews.test.ts +0 -237
  359. package/tests/stepmeter.test.ts +0 -200
  360. package/tests/streamparse.test.ts +0 -163
  361. package/tests/stylepruning.test.ts +0 -90
  362. package/tests/surfaces.test.ts +0 -282
  363. package/tests/sweep.test.ts +0 -78
  364. package/tests/syncbridge.test.ts +0 -164
  365. package/tests/taskqueue.test.ts +0 -206
  366. package/tests/toolcalls.test.ts +0 -336
  367. package/tests/toolcatalog.test.ts +0 -201
  368. package/tests/torture-agent.test.ts +0 -706
  369. package/tests/torture-auth.test.ts +0 -461
  370. package/tests/torture-commands.test.ts +0 -895
  371. package/tests/torture-data.test.ts +0 -923
  372. package/tests/torture-environments.test.ts +0 -285
  373. package/tests/torture-export.test.ts +0 -263
  374. package/tests/torture-http.test.ts +0 -1379
  375. package/tests/torture-llm.test.ts +0 -808
  376. package/tests/torture-memory.test.ts +0 -1084
  377. package/tests/torture-plan.test.ts +0 -829
  378. package/tests/torture-run.test.ts +0 -626
  379. package/tests/torture-session.test.ts +0 -928
  380. package/tests/torture-swarm.test.ts +0 -1245
  381. package/tests/torture-tools.test.ts +0 -964
  382. package/tests/torture-workflow.test.ts +0 -2354
  383. package/tests/tourviews.test.ts +0 -52
  384. package/tests/transparency.test.ts +0 -147
  385. package/tests/trigger.test.ts +0 -941
  386. package/tests/v1sunset.test.ts +0 -428
  387. package/tests/virtlist.test.ts +0 -94
  388. package/tests/vision.test.ts +0 -540
  389. package/tests/vsixpack.test.ts +0 -145
  390. package/tests/webapi.test.ts +0 -523
  391. package/tests/workflow.test.ts +0 -1785
  392. package/tests/workfloweditor.test.ts +0 -759
  393. package/tests/xpipack.test.ts +0 -128
  394. package/tools.ts +0 -734
  395. package/types.ts +0 -9908
  396. package/umd.ts +0 -9
  397. package/utils.ts +0 -249
  398. package/version.ts +0 -8
  399. package/versionregistry.ts +0 -1310
  400. package/views.ts +0 -2153
  401. package/vitest.config.ts +0 -12
  402. package/web/App.tsx +0 -78
  403. package/web/README.md +0 -47
  404. package/web/capacitor.config.ts +0 -46
  405. package/web/const.ts +0 -19
  406. package/web/control.shell.tsx +0 -66
  407. package/web/dashboardpage.ts +0 -554
  408. package/web/db.ts +0 -493
  409. package/web/design.html +0 -541
  410. package/web/gatewayview/Gateway.tsx +0 -345
  411. package/web/gatewayview/config.ts +0 -1042
  412. package/web/gatewayview/definition.ts +0 -174
  413. package/web/icons.ts +0 -15
  414. package/web/optionspage.ts +0 -691
  415. package/web/popup.ts +0 -1651
  416. package/web/schema.prisma +0 -176
  417. package/web/sidepanel.ts +0 -7941
  418. package/web/sitemanifest.json +0 -13
  419. package/web/terminal-ui.tsx +0 -622
  420. package/web/transparencypage.ts +0 -541
  421. package/web/vite.config.ts +0 -39
  422. package/web/workspace.ts +0 -23
  423. package/workbenchmemory.ts +0 -104
  424. package/workbenchsession.ts +0 -304
  425. package/workflow.ts +0 -4495
  426. /package/{dist/bun.d.ts → bun.d.ts} +0 -0
  427. /package/{dist/cli.d.ts → cli.d.ts} +0 -0
  428. /package/{dist/companion.d.ts → companion.d.ts} +0 -0
  429. /package/{dist/crossbrowser.d.ts → crossbrowser.d.ts} +0 -0
  430. /package/{dist/dashdone.d.ts → dashdone.d.ts} +0 -0
  431. /package/{dist/deno.d.ts → deno.d.ts} +0 -0
  432. /package/{dist/hardening.d.ts → hardening.d.ts} +0 -0
  433. /package/{dist/headless.d.ts → headless.d.ts} +0 -0
  434. /package/{dist/http.d.ts → http.d.ts} +0 -0
  435. /package/{dist/index.d.ts → index.d.ts} +0 -0
  436. /package/{dist/mcp.d.ts → mcp.d.ts} +0 -0
  437. /package/{dist/memory.d.ts → memory.d.ts} +0 -0
  438. /package/{dist/node.d.ts → node.d.ts} +0 -0
  439. /package/{dist/pack.d.ts → pack.d.ts} +0 -0
  440. /package/{dist/policy.d.ts → policy.d.ts} +0 -0
  441. /package/{dist/progress.d.ts → progress.d.ts} +0 -0
  442. /package/{dist/protocol.d.ts → protocol.d.ts} +0 -0
  443. /package/{dist/server.d.ts → server.d.ts} +0 -0
  444. /package/{dist/umd.d.ts → umd.d.ts} +0 -0
@@ -1,626 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import {
3
- acquirerunlock,
4
- advancerun,
5
- beatrun,
6
- budgetalertstate,
7
- cancelrollback,
8
- checkpointisvalid,
9
- closerun,
10
- dequeueoffline,
11
- enqueueoffline,
12
- expirerunlocks,
13
- heartbeatwindowof,
14
- heartbeatisstale,
15
- initialrun,
16
- makecheckpoint,
17
- openrun,
18
- reattachrun,
19
- recordenvironment,
20
- recordturnaround,
21
- recordurl,
22
- recoveryplan,
23
- releaserunlock,
24
- replayqueue,
25
- resumecheckpoint,
26
- rollbackrun,
27
- runbudgetof,
28
- runcomplete,
29
- runfail,
30
- runfromplan,
31
- runheartbeat,
32
- runpausesforalerts,
33
- runstatemachine,
34
- serializesteps,
35
- sideeffects,
36
- stepkey,
37
- timeoutcanceldecision,
38
- transitionislegal,
39
- zombiecheck,
40
- zombiesweep,
41
- } from "../run.js";
42
- import type { agentplan, heartbeatrecord, planprogress, runrecord, runsettings, toolstep } from "../types.js";
43
-
44
- const now = 1_800_000_000_000;
45
-
46
- /** Builds one minimal approved plan fixture. */
47
- function plan(over: Partial<agentplan> = {}): agentplan {
48
- return {
49
- id: "p1",
50
- objective: "Check the pricing page",
51
- origin: "https://example.com",
52
- steps: [],
53
- createdat: now - 1000,
54
- expiresat: now + 60_000,
55
- state: "approved",
56
- ...over,
57
- };
58
- }
59
-
60
- /** Builds one queued run fixture. */
61
- function run(over: Partial<runrecord> = {}): runrecord {
62
- return { runid: "r1", planid: "p1", sessionid: "s1", state: "queued", createdat: now, updatedat: now, ...over };
63
- }
64
-
65
- /** Builds one heartbeat fixture. */
66
- function beat(over: Partial<heartbeatrecord> = {}): heartbeatrecord {
67
- return { runid: "r1", beat: 1, at: now, ...over };
68
- }
69
-
70
- /** Builds one read only step fixture. */
71
- function readstep(id: string, over: Partial<toolstep> = {}): toolstep {
72
- return { id, kind: "readtext", summary: `read ${id}`, risk: "read", ...over };
73
- }
74
-
75
- /** Builds one mutating step fixture. */
76
- function writestep(id: string, over: Partial<toolstep> = {}): toolstep {
77
- return { id, kind: "type", target: "#field", value: "x", summary: `type ${id}`, risk: "interaction", ...over };
78
- }
79
-
80
- describe("torture: run lifecycle state machine", () => {
81
- it("refuses every illegal transition from every terminal state", () => {
82
- for (const to of [
83
- "queued",
84
- "running",
85
- "paused",
86
- "awaitingapproval",
87
- "completed",
88
- "failed",
89
- "cancelled",
90
- "rolledback",
91
- ] as const) {
92
- expect(() => advancerun(run({ state: "completed" }), to, now)).toThrow(/cannot move/i);
93
- expect(() => advancerun(run({ state: "rolledback" }), to, now)).toThrow(/cannot move/i);
94
- }
95
- expect(() => advancerun(run({ state: "failed" }), "completed", now)).toThrow(/cannot move/i);
96
- expect(() => advancerun(run({ state: "cancelled" }), "running", now)).toThrow(/cannot move/i);
97
- expect(() => advancerun(run({ state: "failed" }), "failed", now)).toThrow(/cannot move/i);
98
- });
99
-
100
- it("accepts every legal transition the machine declares and only those", () => {
101
- const machine = runstatemachine();
102
- for (const [from, targets] of Object.entries(machine)) {
103
- for (const to of targets) {
104
- expect(transitionislegal({ from: from as never, to: to as never })).toBe(true);
105
- const moved = advancerun(run({ state: from as never }), to, now);
106
- expect(moved.state).toBe(to);
107
- expect(moved.updatedat).toBe(now);
108
- }
109
- }
110
- });
111
-
112
- it("keeps the record immutable through transitions", () => {
113
- const original = run();
114
- const moved = advancerun(original, "running", now);
115
- expect(original.state).toBe("queued");
116
- expect(moved.runid).toBe("r1");
117
- expect(moved).not.toBe(original);
118
- });
119
-
120
- it("refuses blank ids when creating runs and steps", () => {
121
- expect(() => initialrun({ planid: "", sessionid: "s1", now })).toThrow(/plan id/i);
122
- expect(() => initialrun({ planid: " ", sessionid: "s1", now })).toThrow(/plan id/i);
123
- expect(() => initialrun({ planid: "p1", sessionid: "", now })).toThrow(/session id/i);
124
- expect(() => stepkey({ planid: "", stepid: "s1", kind: "click" })).toThrow(/plan and step ids/i);
125
- expect(() => stepkey({ planid: "p1", stepid: "", kind: "click" })).toThrow(/plan and step ids/i);
126
- expect(() => stepkey({ planid: "p1", stepid: "s1", kind: " " })).toThrow(/step kind/i);
127
- expect(stepkey({ planid: "p1", stepid: "s1", kind: "click" })).toBe("p1:s1:click");
128
- expect(stepkey({ planid: "p:1", stepid: "s:1", kind: "navigate" })).toBe("p:1:s:1:navigate");
129
- });
130
-
131
- it("derives unique step keys across plans, steps and kinds", () => {
132
- const keys = new Set<string>();
133
- for (const planid of ["p1", "p2"]) {
134
- for (const stepid of ["s1", "s2"]) {
135
- for (const kind of ["click", "readtext"]) {
136
- keys.add(stepkey({ planid, stepid, kind }));
137
- }
138
- }
139
- }
140
- expect(keys.size).toBe(8);
141
- });
142
- });
143
-
144
- describe("torture: keepalive lifecycle and zombie reaping", () => {
145
- it("refuses heartbeats and reattachment on stopped runs while closed runs stay frozen", () => {
146
- const state = openrun({ runid: "r1", sessionid: "s1", planid: "p1", profileid: "u1", interval: 1_000, now });
147
- const closed = closerun(state, now + 5_000);
148
- expect(() => beatrun(closed, now + 6_000)).toThrow(/stopped/i);
149
- expect(() => reattachrun(closed, now + 6_000)).toThrow(/stopped/i);
150
- expect(() => closerun(closed, now + 7_000)).toThrow(/already stopped/i);
151
- expect(closed.state).toBe("completed");
152
- expect(closed.keepalive.portopen).toBe(false);
153
- });
154
-
155
- it("refuses negative and non finite intervals at open time", () => {
156
- for (const interval of [0, -1, Number.NaN, Number.POSITIVE_INFINITY, Number.NEGATIVE_INFINITY]) {
157
- expect(() => openrun({ runid: "r1", sessionid: "s1", planid: "p1", profileid: "u1", interval, now })).toThrow(
158
- /positive user value/i,
159
- );
160
- }
161
- expect(() => openrun({ runid: "", sessionid: "s1", planid: "p1", profileid: "u1", interval: 1_000, now })).toThrow(
162
- /run and session ids/i,
163
- );
164
- });
165
-
166
- it("caps the heartbeat event trail at two hundred beats", () => {
167
- let state = openrun({ runid: "r1", sessionid: "s1", planid: "p1", profileid: "u1", interval: 1_000, now });
168
- for (let index = 0; index < 250; index += 1) state = beatrun(state, now + index * 1_000);
169
- expect(state.keepalive.beats).toBe(250);
170
- expect(state.keepalive.events.length).toBe(200);
171
- expect(state.keepalive.lastbeatat).toBe(now + 249_000);
172
- });
173
-
174
- it("reaps exactly the runs whose silence passed the tolerance and only active ones", () => {
175
- const base = openrun({ runid: "base", sessionid: "s1", planid: "p1", profileid: "u1", interval: 1_000, now });
176
- const alive = { ...base, runid: "alive", keepalive: { ...base.keepalive, runid: "alive", lastbeatat: now } };
177
- const silent = {
178
- ...base,
179
- runid: "silent",
180
- keepalive: { ...base.keepalive, runid: "silent", lastbeatat: now - 10_000 },
181
- };
182
- const stopped = closerun({ ...base, runid: "stopped", keepalive: { ...base.keepalive, runid: "stopped" } }, now);
183
- const alreadyreaped = { ...base, runid: "reapedalready", state: "reaped" as const };
184
- const result = zombiesweep({
185
- states: [alive, silent, stopped, alreadyreaped],
186
- now,
187
- interval: 1_000,
188
- missedlimit: 3,
189
- });
190
- expect(result.reaped).toEqual(["silent"]);
191
- expect(result.states.find((state) => state.runid === "silent")?.state).toBe("reaped");
192
- expect(result.states.find((state) => state.runid === "alive")?.state).toBe("active");
193
- expect(result.states.find((state) => state.runid === "stopped")?.state).toBe("completed");
194
- expect(result.states.find((state) => state.runid === "reapedalready")?.state).toBe("reaped");
195
- });
196
-
197
- it("reaps at exactly the tolerated boundary plus one and never at the boundary", () => {
198
- const base = openrun({ runid: "base", sessionid: "s1", planid: "p1", profileid: "u1", interval: 1_000, now });
199
- const atboundary = { ...base, runid: "r1", keepalive: { ...base.keepalive, runid: "r1", lastbeatat: now - 3_000 } };
200
- const overboundary = {
201
- ...base,
202
- runid: "over",
203
- keepalive: { ...base.keepalive, runid: "over", lastbeatat: now - 3_001 },
204
- };
205
- const exactly = zombiesweep({ states: [atboundary], now, interval: 1_000, missedlimit: 3 });
206
- expect(exactly.reaped).toEqual([]);
207
- const over = zombiesweep({ states: [overboundary], now, interval: 1_000, missedlimit: 3 });
208
- expect(over.reaped).toEqual(["over"]);
209
- });
210
-
211
- it("refuses invalid sweep parameters", () => {
212
- expect(() => zombiesweep({ states: [], now, interval: 0, missedlimit: 3 })).toThrow(/positive user value/i);
213
- expect(() => zombiesweep({ states: [], now, interval: 1_000, missedlimit: 0 })).toThrow(/positive whole number/i);
214
- expect(() => zombiesweep({ states: [], now, interval: Number.NaN, missedlimit: 3 })).toThrow(
215
- /positive user value/i,
216
- );
217
- expect(() => zombiesweep({ states: [], now, interval: 1_000, missedlimit: 1.5 })).toThrow(/positive whole number/i);
218
- });
219
-
220
- it("answers recovery for every terminal state and the pending step rule", () => {
221
- const base = openrun({ runid: "r1", sessionid: "s1", planid: "p1", profileid: "u1", interval: 1_000, now });
222
- expect(recoveryplan(closerun(base, now + 1)).recoverable).toBe(false);
223
- expect(recoveryplan({ ...base, state: "reaped" }).recoverable).toBe(false);
224
- expect(recoveryplan(base).recoverable).toBe(false);
225
- expect(recoveryplan(base).reason).toMatch(/no pending step/i);
226
- const pending = { ...base, pendingstepid: "s5" };
227
- const recovery = recoveryplan(pending);
228
- expect(recovery.recoverable).toBe(true);
229
- expect(recovery.pendingstepid).toBe("s5");
230
- });
231
-
232
- it("records urls, environments and turnarounds with validation", () => {
233
- let state = openrun({ runid: "r1", sessionid: "s1", planid: "p1", profileid: "u1", interval: 1_000, now });
234
- expect(() => recordurl(state, { url: " ", stepid: "s1", now })).toThrow(/needs its url/i);
235
- state = recordurl(state, { url: "https://example.com/a", stepid: "s1", now });
236
- state = recordurl(state, { url: "https://example.com/a", stepid: "s1", now: now + 1 });
237
- expect(state.urlhistory.length).toBe(1);
238
- state = recordurl(state, { url: "https://example.com/a", stepid: "s2", now: now + 2 });
239
- expect(state.urlhistory.length).toBe(2);
240
- expect(() =>
241
- recordenvironment(state, { stepid: "", environment: "pagecontext", origin: "https://example.com", now }),
242
- ).toThrow(/step id/i);
243
- state = recordenvironment(state, {
244
- stepid: "s1",
245
- environment: "offscreenworker",
246
- origin: "https://example.com",
247
- now,
248
- });
249
- expect(state.environments["s1"]).toBe("offscreenworker");
250
- expect(state.lastprovenance?.environment).toBe("offscreenworker");
251
- expect(() => recordturnaround(state, { stepid: "s1", milliseconds: -1, now })).toThrow(/non-negative/i);
252
- expect(() => recordturnaround(state, { stepid: "s1", milliseconds: Number.NaN, now })).toThrow(/non-negative/i);
253
- state = recordturnaround(state, { stepid: "s1", milliseconds: 0, now });
254
- expect(state.turnarounds["s1"]).toBe(0);
255
- });
256
- });
257
-
258
- describe("torture: run locks and concurrency refusal", () => {
259
- it("refuses a second concurrent run of the same session while the same run renews", () => {
260
- const first = acquirerunlock({ locks: [], sessionid: "s1", runid: "r1", holder: "executor", now });
261
- expect(first.acquired).toBe(true);
262
- const second = acquirerunlock({
263
- locks: first.locks,
264
- sessionid: "s1",
265
- runid: "r2",
266
- holder: "executor",
267
- now: now + 1,
268
- });
269
- expect(second.acquired).toBe(false);
270
- expect(second.reason).toMatch(/never carries two concurrent runs/i);
271
- expect(second.locks).toBe(first.locks);
272
- const renew = acquirerunlock({
273
- locks: first.locks,
274
- sessionid: "s1",
275
- runid: "r1",
276
- holder: "executor",
277
- now: now + 2,
278
- });
279
- expect(renew.acquired).toBe(true);
280
- expect(renew.locks.length).toBe(1);
281
- });
282
-
283
- it("expires the locks past their expiry naming their sessions and never at the boundary", () => {
284
- const { locks } = acquirerunlock({
285
- locks: [],
286
- sessionid: "s1",
287
- runid: "r1",
288
- holder: "executor",
289
- expiresat: now + 1_000,
290
- now,
291
- });
292
- expect(expirerunlocks(locks, now).expired).toEqual([]);
293
- expect(expirerunlocks(locks, now + 999).expired).toEqual([]);
294
- expect(expirerunlocks(locks, now + 1_000).expired).toEqual([]);
295
- expect(expirerunlocks(locks, now + 1_001).expired).toEqual(["s1"]);
296
- expect(expirerunlocks(locks, now + 1_001).locks).toEqual([]);
297
- const takenover = acquirerunlock({ locks, sessionid: "s1", runid: "r2", holder: "executor", now: now + 1_001 });
298
- expect(takenover.acquired).toBe(true);
299
- });
300
-
301
- it("releases the run lock exactly for its own run", () => {
302
- const { locks } = acquirerunlock({ locks: [], sessionid: "s1", runid: "r1", holder: "executor", now });
303
- const released = releaserunlock({ locks, sessionid: "s1", runid: "r1", now });
304
- expect(released.released).toBe(true);
305
- expect(released.locks.length).toBe(0);
306
- const missing = releaserunlock({ locks: released.locks, sessionid: "s1", runid: "other", now });
307
- expect(missing.released).toBe(false);
308
- expect(missing.reason).toMatch(/holds no lock/i);
309
- });
310
-
311
- it("serializes steps that share one tab across parallel branches", () => {
312
- const order = serializesteps({
313
- branches: [
314
- {
315
- branchid: "b1",
316
- steps: [
317
- { stepid: "a1", tabid: 7 },
318
- { stepid: "a2", tabid: 8 },
319
- ],
320
- },
321
- {
322
- branchid: "b2",
323
- steps: [
324
- { stepid: "b1", tabid: 7 },
325
- { stepid: "b2", tabid: 9 },
326
- ],
327
- },
328
- ],
329
- });
330
- const tabseven = order.filter((entry) => entry.tabid === 7).map((entry) => entry.stepid);
331
- expect(tabseven).toEqual(["a1", "b1"]);
332
- const unique = new Set(order.map((entry) => entry.order));
333
- expect(unique.size).toBe(order.length);
334
- expect(order.length).toBe(4);
335
- });
336
- });
337
-
338
- describe("torture: offline queue ordering and replay", () => {
339
- it("queues only approved plans with monotonic sequence and drains in order", () => {
340
- const queue = [
341
- enqueueoffline([], { plan: plan({ id: "p1" }), sessionid: "s1", now }),
342
- enqueueoffline(enqueueoffline([], { plan: plan({ id: "p1" }), sessionid: "s1", now }), {
343
- plan: plan({ id: "p2" }),
344
- sessionid: "s2",
345
- now: now + 1,
346
- }),
347
- ];
348
- expect(() => enqueueoffline(queue[0]!, { plan: plan({ id: "px", state: "draft" }), sessionid: "s1", now })).toThrow(
349
- /only an approved plan/i,
350
- );
351
- const drained: string[] = [];
352
- let rest = queue[1]!;
353
- for (let index = 0; index < 3; index += 1) {
354
- const next = dequeueoffline(rest);
355
- if (next.task) drained.push(next.task.planid);
356
- rest = next.queue;
357
- }
358
- expect(drained).toEqual(["p1", "p2"]);
359
- expect(dequeueoffline(rest).task).toBeUndefined();
360
- });
361
-
362
- it("expires exactly the plans whose window passed while draining offline (the expiry tick is exclusive)", () => {
363
- const early = enqueueoffline([], { plan: plan({ id: "p1", expiresat: now + 1_000 }), sessionid: "s1", now });
364
- const late = enqueueoffline(early, { plan: plan({ id: "p2", expiresat: now + 60_000 }), sessionid: "s1", now });
365
- const before = replayqueue(late, now + 999);
366
- expect(before.expired.map((task) => task.planid)).toEqual([]);
367
- expect(before.ready.map((task) => task.planid)).toEqual(["p1", "p2"]);
368
- const atboundary = replayqueue(late, now + 1_000);
369
- expect(atboundary.expired.map((task) => task.planid)).toEqual(["p1"]);
370
- expect(atboundary.ready.map((task) => task.planid)).toEqual(["p2"]);
371
- const after = replayqueue(late, now + 1_001);
372
- expect(after.expired.map((task) => task.planid)).toEqual(["p1"]);
373
- expect(after.ready.map((task) => task.planid)).toEqual(["p2"]);
374
- });
375
-
376
- it("keeps sequence order under interleaved enqueue bursts", () => {
377
- let queue: ReturnType<typeof enqueueoffline> = [];
378
- for (let index = 0; index < 50; index += 1) {
379
- queue = enqueueoffline(queue, { plan: plan({ id: `p${index}` }), sessionid: "s1", now: now + index });
380
- }
381
- const order: number[] = [];
382
- let rest = queue;
383
- while (rest.length > 0) {
384
- const next = dequeueoffline(rest);
385
- if (next.task) order.push(next.task.sequence);
386
- rest = next.queue;
387
- }
388
- expect(order).toEqual([...order].sort((one, two) => one - two));
389
- expect(order.length).toBe(50);
390
- });
391
- });
392
-
393
- describe("torture: checkpoints, digests and resume", () => {
394
- it("refuses checkpoints without their ids and digest", () => {
395
- expect(() => makecheckpoint({ runid: "", stepid: "s1", completed: [], digest: "d", now })).toThrow(/run id/i);
396
- expect(() => makecheckpoint({ runid: "r1", stepid: "", completed: [], digest: "d", now })).toThrow(/step id/i);
397
- expect(() => makecheckpoint({ runid: "r1", stepid: "s1", completed: [], digest: " ", now })).toThrow(
398
- /page digest/i,
399
- );
400
- const checkpoint = makecheckpoint({ runid: "r1", stepid: "s3", completed: ["s1", "s2"], digest: "digest-a", now });
401
- expect(checkpoint.completed).toEqual(["s1", "s2"]);
402
- expect(checkpoint.completed).not.toBe(["s1", "s2"]);
403
- });
404
-
405
- it("validates only the checkpoint of its own run and unchanged digest", () => {
406
- const checkpoint = makecheckpoint({ runid: "r1", stepid: "s3", completed: ["s1"], digest: "digest-a", now });
407
- expect(checkpointisvalid({ checkpoint, runid: "r1", digest: "digest-a" })).toBe(true);
408
- expect(checkpointisvalid({ checkpoint, runid: "r2", digest: "digest-a" })).toBe(false);
409
- expect(checkpointisvalid({ checkpoint, runid: "r1", digest: "digest-b" })).toBe(false);
410
- });
411
-
412
- it("resumes from the first open step while a foreign checkpoint skips only named steps", () => {
413
- const steps = ["s1", "s2", "s3", "s4"];
414
- expect(resumecheckpoint({ checkpoint: undefined, steps })).toEqual(steps);
415
- const checkpoint = makecheckpoint({ runid: "r1", stepid: "s2", completed: ["s1", "s2"], digest: "d", now });
416
- expect(resumecheckpoint({ checkpoint, steps })).toEqual(["s3", "s4"]);
417
- expect(resumecheckpoint({ checkpoint, steps: [] })).toEqual([]);
418
- const foreign = makecheckpoint({ runid: "r2", stepid: "s9", completed: ["s1", "s9"], digest: "d", now });
419
- expect(resumecheckpoint({ checkpoint: foreign, steps })).toEqual(["s2", "s3", "s4"]);
420
- });
421
-
422
- it("freezes progress on failure with the run id stamped", () => {
423
- const moving = advancerun(run(), "running", now);
424
- const failed = runfail({
425
- run: moving,
426
- progress: { planid: "p1", completedsteps: ["s1"], updatedat: now },
427
- now: now + 1,
428
- });
429
- expect(failed.run.state).toBe("failed");
430
- expect(failed.frozen?.runid).toBe("r1");
431
- expect(failed.frozen?.updatedat).toBe(now + 1);
432
- const bare = runfail({ run: moving, now: now + 2 });
433
- expect(bare.frozen).toBeUndefined();
434
- });
435
-
436
- it("completes only a run whose plan finished every step", () => {
437
- const planfixture = plan({ steps: [readstep("s1"), readstep("s2")] });
438
- const moving = advancerun(run(), "running", now);
439
- expect(() =>
440
- runcomplete({
441
- run: moving,
442
- plan: planfixture,
443
- progress: { planid: "p1", completedsteps: ["s1"], updatedat: now },
444
- now,
445
- }),
446
- ).toThrow(/never completes/i);
447
- const done = runcomplete({
448
- run: moving,
449
- plan: planfixture,
450
- progress: { planid: "p1", completedsteps: ["s1", "s2"], updatedat: now },
451
- now: now + 1,
452
- });
453
- expect(done.state).toBe("completed");
454
- });
455
-
456
- it("rebuilds a failed run from an expired or unapproved plan and a running one otherwise", () => {
457
- expect(runfromplan(plan({ state: "draft" }), "s1", now).state).toBe("failed");
458
- expect(runfromplan(plan({ expiresat: now }), "s1", now).state).toBe("failed");
459
- expect(runfromplan(plan({ expiresat: now + 1 }), "s1", now).state).toBe("running");
460
- expect(runfromplan(plan(), "s1", now).runid).toBe("p1");
461
- });
462
- });
463
-
464
- describe("torture: heartbeats and the zombie check", () => {
465
- it("stale heartbeat sits exactly past the window and never at it", () => {
466
- const beat = runheartbeat({ runid: "r1", beat: 5, now });
467
- expect(beat.beat).toBe(6);
468
- expect(heartbeatisstale({ heartbeat: beat, now: now + 10_000, window: 10_000 })).toBe(false);
469
- expect(heartbeatisstale({ heartbeat: beat, now: now + 10_001, window: 10_000 })).toBe(true);
470
- expect(heartbeatisstale({ heartbeat: undefined, now, window: 1 })).toBe(true);
471
- });
472
-
473
- it("refuses blank run ids on heartbeats", () => {
474
- expect(() => runheartbeat({ runid: " ", now })).toThrow(/run id/i);
475
- expect(() => runheartbeat({ runid: "", now })).toThrow(/run id/i);
476
- });
477
-
478
- it("zombiecheck names only running runs with stale heartbeats", () => {
479
- const runs = [
480
- run({ runid: "alive", state: "running" }),
481
- run({ runid: "zombie", state: "running" }),
482
- run({ runid: "queued", state: "queued" }),
483
- run({ runid: "done", state: "completed" }),
484
- ];
485
- const heartbeats: Record<string, heartbeatrecord> = {
486
- alive: { runid: "alive", beat: 1, at: now - 5_000 },
487
- zombie: { runid: "zombie", beat: 1, at: now - 50_000 },
488
- queued: { runid: "queued", beat: 1, at: now - 50_000 },
489
- done: { runid: "done", beat: 1, at: now - 50_000 },
490
- };
491
- const zombies = zombiecheck({ runs, heartbeats, now, window: 10_000 });
492
- expect(zombies.map((entry) => entry.runid)).toEqual(["zombie"]);
493
- });
494
-
495
- it("reads the heartbeat window from settings with the roadmap default", () => {
496
- expect(heartbeatwindowof(undefined)).toBe(60_000);
497
- const settings: runsettings = {};
498
- expect(heartbeatwindowof(settings)).toBe(60_000);
499
- });
500
- });
501
-
502
- describe("torture: side effects and rollback compensations", () => {
503
- it("compensates only the executed mutating steps while read steps carry none", () => {
504
- const steps = [readstep("r1"), writestep("w1"), writestep("w2"), writestep("w3")];
505
- const executed = ["r1", "w1", "w3"];
506
- const effects = sideeffects(steps, executed);
507
- expect(effects.map((step) => step.id)).toEqual(["w1", "w3"]);
508
- const items = rollbackrun({ runid: "r1", steps, executedstepids: executed, origin: "https://example.com", now });
509
- expect(items.map((item) => item.stepid)).toEqual(["w1", "w3"]);
510
- expect(items.every((item) => item.compensation.length > 0)).toBe(true);
511
- expect(items.every((item) => item.origin === "https://example.com")).toBe(true);
512
- expect(rollbackrun({ runid: "r1", steps, executedstepids: [], origin: "https://example.com", now })).toEqual([]);
513
- });
514
-
515
- it("reports the fallback compensation for an unknown mutating kind", () => {
516
- const alien = { id: "x1", kind: "dimensionhop", summary: "unknown", risk: "sensitive" } as unknown as toolstep;
517
- const items = rollbackrun({
518
- runid: "r1",
519
- steps: [alien],
520
- executedstepids: ["x1"],
521
- origin: "https://example.com",
522
- now,
523
- });
524
- expect(items[0]?.compensation).toMatch(/dimensionhop step stays executed/i);
525
- });
526
-
527
- it("cancel pairs the rollback choice with compensations only under the explicit user choice", () => {
528
- const steps = [writestep("w1"), readstep("r1")];
529
- const moving = advancerun(run(), "running", now);
530
- const none = cancelrollback({
531
- run: moving,
532
- steps,
533
- executedstepids: ["w1", "r1"],
534
- origin: "https://example.com",
535
- choice: "none",
536
- now: now + 1,
537
- });
538
- expect(none.run.state).toBe("cancelled");
539
- expect(none.compensations).toEqual([]);
540
- expect(none.reason).toMatch(/without a rollback/i);
541
- const fresh = advancerun(run({ runid: "r2" }), "running", now);
542
- const rollback = cancelrollback({
543
- run: fresh,
544
- steps,
545
- executedstepids: ["w1", "r1"],
546
- origin: "https://example.com",
547
- choice: "rollback",
548
- now: now + 1,
549
- });
550
- expect(rollback.run.state).toBe("rolledback");
551
- expect(rollback.compensations.map((item) => item.stepid)).toEqual(["w1"]);
552
- expect(rollback.reason).toMatch(/explicit user choice/i);
553
- expect(() =>
554
- cancelrollback({
555
- run: rollback.run,
556
- steps,
557
- executedstepids: ["w1"],
558
- origin: "https://example.com",
559
- choice: "none",
560
- now: now + 2,
561
- }),
562
- ).toThrow(/cannot move/i);
563
- expect(() =>
564
- cancelrollback({
565
- run: none.run,
566
- steps,
567
- executedstepids: [],
568
- origin: "https://example.com",
569
- choice: "none",
570
- now: now + 2,
571
- }),
572
- ).toThrow(/cannot move/i);
573
- });
574
- });
575
-
576
- describe("torture: budget alerts and timeout cancels", () => {
577
- it("budget alerts fire at their reached severity with critical pausing and warnings informational", () => {
578
- const atwarning = budgetalertstate({
579
- budget: runbudgetof({ runid: "r1", steps: 80, stepbudget: 100, pressure: 0.5, now }),
580
- thresholds: { warning: 0.8, critical: 0.95 },
581
- });
582
- expect(atwarning.map((alert) => alert.level)).toEqual(["warning"]);
583
- expect(runpausesforalerts(atwarning)).toBe(false);
584
- const atcritical = budgetalertstate({
585
- budget: runbudgetof({ runid: "r1", steps: 100, stepbudget: 100, pressure: 0.5, now }),
586
- thresholds: { warning: 0.8, critical: 0.95 },
587
- });
588
- expect(atcritical.map((alert) => alert.level)).toEqual(["critical"]);
589
- expect(runpausesforalerts(atcritical)).toBe(true);
590
- const over = budgetalertstate({
591
- budget: runbudgetof({ runid: "r1", steps: 101, stepbudget: 100, pressure: 0.5, now }),
592
- thresholds: { warning: 0.5, critical: 0.5 },
593
- });
594
- expect(runpausesforalerts(over)).toBe(true);
595
- const under = budgetalertstate({
596
- budget: runbudgetof({ runid: "r1", steps: 10, stepbudget: 100, pressure: 0.5, now }),
597
- thresholds: { warning: 0.8, critical: 0.95 },
598
- });
599
- expect(under).toEqual([]);
600
- const nobudget = budgetalertstate({
601
- budget: runbudgetof({ runid: "r1", steps: 10, pressure: 0.5, now }),
602
- thresholds: { warning: 0.5, critical: 0.5 },
603
- });
604
- expect(nobudget).toEqual([]);
605
- });
606
-
607
- it("timeout cancels at exactly the bound and one past it while memory pressure alerts beside the steps", () => {
608
- expect(timeoutcanceldecision({ elapsed: 999, bound: 1_000 }).abort).toBe(false);
609
- expect(timeoutcanceldecision({ elapsed: 1_000, bound: 1_000 }).abort).toBe(false);
610
- expect(timeoutcanceldecision({ elapsed: 1_001, bound: 1_000 }).abort).toBe(true);
611
- expect(timeoutcanceldecision({ elapsed: 0, bound: 0 }).abort).toBe(false);
612
- expect(timeoutcanceldecision({ elapsed: -5, bound: 1_000 }).abort).toBe(false);
613
- const unbound = timeoutcanceldecision({ elapsed: 10_000_000 });
614
- expect(unbound.abort).toBe(false);
615
- expect(unbound.reason).toMatch(/no timeout bound/i);
616
- const gap = timeoutcanceldecision({ elapsed: Number.NaN, bound: 1_000 });
617
- expect(gap.abort).toBe(false);
618
- expect(gap.reason).toMatch(/no finite elapsed/i);
619
- const memory = budgetalertstate({
620
- budget: runbudgetof({ runid: "r1", steps: 1, pressure: 1, memorybudget: 1, now }),
621
- thresholds: { warning: 0.5, critical: 0.9 },
622
- });
623
- expect(memory.map((alert) => alert.kind)).toEqual(["memory"]);
624
- expect(runpausesforalerts(memory)).toBe(true);
625
- });
626
- });