@buildanagent/harness 0.0.0-stage → 0.1.0-alpha.29

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 (397) hide show
  1. package/LICENSE +54 -0
  2. package/LICENSE-APACHE +202 -0
  3. package/LICENSE-MIT +21 -0
  4. package/README.md +822 -2
  5. package/dist/ablation.d.ts +2 -0
  6. package/dist/ablation.js +3 -0
  7. package/dist/ablation.js.map +1 -0
  8. package/dist/completion/check.d.ts +64 -0
  9. package/dist/completion/check.js +152 -0
  10. package/dist/completion/check.js.map +1 -0
  11. package/dist/completion/checks.d.ts +45 -0
  12. package/dist/completion/checks.js +173 -0
  13. package/dist/completion/checks.js.map +1 -0
  14. package/dist/completion/flags.d.ts +25 -0
  15. package/dist/completion/flags.js +87 -0
  16. package/dist/completion/flags.js.map +1 -0
  17. package/dist/completion/index.d.ts +8 -0
  18. package/dist/completion/index.js +9 -0
  19. package/dist/completion/index.js.map +1 -0
  20. package/dist/completion/snapshot.d.ts +33 -0
  21. package/dist/completion/snapshot.js +83 -0
  22. package/dist/completion/snapshot.js.map +1 -0
  23. package/dist/context/cap.d.ts +32 -0
  24. package/dist/context/cap.js +50 -0
  25. package/dist/context/cap.js.map +1 -0
  26. package/dist/context/estimate.d.ts +18 -0
  27. package/dist/context/estimate.js +20 -0
  28. package/dist/context/estimate.js.map +1 -0
  29. package/dist/context/file-spill.d.ts +15 -0
  30. package/dist/context/file-spill.js +40 -0
  31. package/dist/context/file-spill.js.map +1 -0
  32. package/dist/context/index.d.ts +10 -0
  33. package/dist/context/index.js +10 -0
  34. package/dist/context/index.js.map +1 -0
  35. package/dist/context/mask.d.ts +27 -0
  36. package/dist/context/mask.js +71 -0
  37. package/dist/context/mask.js.map +1 -0
  38. package/dist/context/mid-turn.d.ts +40 -0
  39. package/dist/context/mid-turn.js +82 -0
  40. package/dist/context/mid-turn.js.map +1 -0
  41. package/dist/context/policy.d.ts +9 -0
  42. package/dist/context/policy.js +140 -0
  43. package/dist/context/policy.js.map +1 -0
  44. package/dist/context/spill-ledger.d.ts +25 -0
  45. package/dist/context/spill-ledger.js +54 -0
  46. package/dist/context/spill-ledger.js.map +1 -0
  47. package/dist/context/spill.d.ts +10 -0
  48. package/dist/context/spill.js +18 -0
  49. package/dist/context/spill.js.map +1 -0
  50. package/dist/context/summarize.d.ts +53 -0
  51. package/dist/context/summarize.js +204 -0
  52. package/dist/context/summarize.js.map +1 -0
  53. package/dist/context/summary-template.d.ts +29 -0
  54. package/dist/context/summary-template.js +69 -0
  55. package/dist/context/summary-template.js.map +1 -0
  56. package/dist/context/types.d.ts +150 -0
  57. package/dist/context/types.js +2 -0
  58. package/dist/context/types.js.map +1 -0
  59. package/dist/context/write-cap.d.ts +19 -0
  60. package/dist/context/write-cap.js +41 -0
  61. package/dist/context/write-cap.js.map +1 -0
  62. package/dist/create-harness.d.ts +7 -0
  63. package/dist/create-harness.js +21 -0
  64. package/dist/create-harness.js.map +1 -0
  65. package/dist/credentials/addresses.d.ts +14 -0
  66. package/dist/credentials/addresses.js +144 -0
  67. package/dist/credentials/addresses.js.map +1 -0
  68. package/dist/credentials/allowlist.d.ts +54 -0
  69. package/dist/credentials/allowlist.js +134 -0
  70. package/dist/credentials/allowlist.js.map +1 -0
  71. package/dist/credentials/egress-policy.d.ts +69 -0
  72. package/dist/credentials/egress-policy.js +170 -0
  73. package/dist/credentials/egress-policy.js.map +1 -0
  74. package/dist/credentials/egress-proxy.d.ts +82 -0
  75. package/dist/credentials/egress-proxy.js +650 -0
  76. package/dist/credentials/egress-proxy.js.map +1 -0
  77. package/dist/credentials/git-route.d.ts +68 -0
  78. package/dist/credentials/git-route.js +288 -0
  79. package/dist/credentials/git-route.js.map +1 -0
  80. package/dist/credentials/index.d.ts +13 -0
  81. package/dist/credentials/index.js +14 -0
  82. package/dist/credentials/index.js.map +1 -0
  83. package/dist/credentials/scrub.d.ts +23 -0
  84. package/dist/credentials/scrub.js +115 -0
  85. package/dist/credentials/scrub.js.map +1 -0
  86. package/dist/errors.d.ts +60 -0
  87. package/dist/errors.js +67 -0
  88. package/dist/errors.js.map +1 -0
  89. package/dist/extensions/compose.d.ts +27 -0
  90. package/dist/extensions/compose.js +83 -0
  91. package/dist/extensions/compose.js.map +1 -0
  92. package/dist/extensions/context-files-node.d.ts +28 -0
  93. package/dist/extensions/context-files-node.js +74 -0
  94. package/dist/extensions/context-files-node.js.map +1 -0
  95. package/dist/extensions/context-files.d.ts +68 -0
  96. package/dist/extensions/context-files.js +214 -0
  97. package/dist/extensions/context-files.js.map +1 -0
  98. package/dist/extensions/digest.d.ts +6 -0
  99. package/dist/extensions/digest.js +68 -0
  100. package/dist/extensions/digest.js.map +1 -0
  101. package/dist/extensions/index.d.ts +10 -0
  102. package/dist/extensions/index.js +10 -0
  103. package/dist/extensions/index.js.map +1 -0
  104. package/dist/extensions/load.d.ts +42 -0
  105. package/dist/extensions/load.js +211 -0
  106. package/dist/extensions/load.js.map +1 -0
  107. package/dist/extensions/lock.d.ts +8 -0
  108. package/dist/extensions/lock.js +95 -0
  109. package/dist/extensions/lock.js.map +1 -0
  110. package/dist/extensions/node.d.ts +10 -0
  111. package/dist/extensions/node.js +11 -0
  112. package/dist/extensions/node.js.map +1 -0
  113. package/dist/extensions/project-dirs.d.ts +24 -0
  114. package/dist/extensions/project-dirs.js +97 -0
  115. package/dist/extensions/project-dirs.js.map +1 -0
  116. package/dist/extensions/skills-node.d.ts +34 -0
  117. package/dist/extensions/skills-node.js +123 -0
  118. package/dist/extensions/skills-node.js.map +1 -0
  119. package/dist/extensions/skills.d.ts +51 -0
  120. package/dist/extensions/skills.js +175 -0
  121. package/dist/extensions/skills.js.map +1 -0
  122. package/dist/extensions/trust-file.d.ts +3 -0
  123. package/dist/extensions/trust-file.js +62 -0
  124. package/dist/extensions/trust-file.js.map +1 -0
  125. package/dist/extensions/trust-store-node.d.ts +10 -0
  126. package/dist/extensions/trust-store-node.js +33 -0
  127. package/dist/extensions/trust-store-node.js.map +1 -0
  128. package/dist/extensions/types.d.ts +42 -0
  129. package/dist/extensions/types.js +2 -0
  130. package/dist/extensions/types.js.map +1 -0
  131. package/dist/harness.d.ts +156 -0
  132. package/dist/harness.js +2 -0
  133. package/dist/harness.js.map +1 -0
  134. package/dist/index.d.ts +4 -0
  135. package/dist/index.js +5 -0
  136. package/dist/index.js.map +1 -0
  137. package/dist/mcp/connection.d.ts +22 -0
  138. package/dist/mcp/connection.js +267 -0
  139. package/dist/mcp/connection.js.map +1 -0
  140. package/dist/mcp/content.d.ts +27 -0
  141. package/dist/mcp/content.js +177 -0
  142. package/dist/mcp/content.js.map +1 -0
  143. package/dist/mcp/errors.d.ts +19 -0
  144. package/dist/mcp/errors.js +21 -0
  145. package/dist/mcp/errors.js.map +1 -0
  146. package/dist/mcp/index.d.ts +10 -0
  147. package/dist/mcp/index.js +10 -0
  148. package/dist/mcp/index.js.map +1 -0
  149. package/dist/mcp/manager.d.ts +7 -0
  150. package/dist/mcp/manager.js +173 -0
  151. package/dist/mcp/manager.js.map +1 -0
  152. package/dist/mcp/record.d.ts +7 -0
  153. package/dist/mcp/record.js +20 -0
  154. package/dist/mcp/record.js.map +1 -0
  155. package/dist/mcp/stdio.d.ts +39 -0
  156. package/dist/mcp/stdio.js +382 -0
  157. package/dist/mcp/stdio.js.map +1 -0
  158. package/dist/mcp/types.d.ts +172 -0
  159. package/dist/mcp/types.js +2 -0
  160. package/dist/mcp/types.js.map +1 -0
  161. package/dist/memory/index.d.ts +2 -0
  162. package/dist/memory/index.js +3 -0
  163. package/dist/memory/index.js.map +1 -0
  164. package/dist/permissions/default-rules.d.ts +7 -0
  165. package/dist/permissions/default-rules.js +42 -0
  166. package/dist/permissions/default-rules.js.map +1 -0
  167. package/dist/permissions/errors.d.ts +11 -0
  168. package/dist/permissions/errors.js +14 -0
  169. package/dist/permissions/errors.js.map +1 -0
  170. package/dist/permissions/index.d.ts +9 -0
  171. package/dist/permissions/index.js +9 -0
  172. package/dist/permissions/index.js.map +1 -0
  173. package/dist/permissions/match.d.ts +33 -0
  174. package/dist/permissions/match.js +287 -0
  175. package/dist/permissions/match.js.map +1 -0
  176. package/dist/permissions/pipeline.d.ts +9 -0
  177. package/dist/permissions/pipeline.js +235 -0
  178. package/dist/permissions/pipeline.js.map +1 -0
  179. package/dist/permissions/rules.d.ts +22 -0
  180. package/dist/permissions/rules.js +74 -0
  181. package/dist/permissions/rules.js.map +1 -0
  182. package/dist/permissions/shadow.d.ts +5 -0
  183. package/dist/permissions/shadow.js +22 -0
  184. package/dist/permissions/shadow.js.map +1 -0
  185. package/dist/permissions/types.d.ts +104 -0
  186. package/dist/permissions/types.js +2 -0
  187. package/dist/permissions/types.js.map +1 -0
  188. package/dist/sandbox/base.d.ts +45 -0
  189. package/dist/sandbox/base.js +74 -0
  190. package/dist/sandbox/base.js.map +1 -0
  191. package/dist/sandbox/docker/index.d.ts +41 -0
  192. package/dist/sandbox/docker/index.js +497 -0
  193. package/dist/sandbox/docker/index.js.map +1 -0
  194. package/dist/sandbox/errors.d.ts +44 -0
  195. package/dist/sandbox/errors.js +57 -0
  196. package/dist/sandbox/errors.js.map +1 -0
  197. package/dist/sandbox/host-files.d.ts +65 -0
  198. package/dist/sandbox/host-files.js +258 -0
  199. package/dist/sandbox/host-files.js.map +1 -0
  200. package/dist/sandbox/index.d.ts +10 -0
  201. package/dist/sandbox/index.js +10 -0
  202. package/dist/sandbox/index.js.map +1 -0
  203. package/dist/sandbox/none.d.ts +17 -0
  204. package/dist/sandbox/none.js +108 -0
  205. package/dist/sandbox/none.js.map +1 -0
  206. package/dist/sandbox/policy.d.ts +49 -0
  207. package/dist/sandbox/policy.js +149 -0
  208. package/dist/sandbox/policy.js.map +1 -0
  209. package/dist/sandbox/process.d.ts +61 -0
  210. package/dist/sandbox/process.js +253 -0
  211. package/dist/sandbox/process.js.map +1 -0
  212. package/dist/sandbox/spawn-env.d.ts +20 -0
  213. package/dist/sandbox/spawn-env.js +128 -0
  214. package/dist/sandbox/spawn-env.js.map +1 -0
  215. package/dist/sandbox/srt/index.d.ts +38 -0
  216. package/dist/sandbox/srt/index.js +283 -0
  217. package/dist/sandbox/srt/index.js.map +1 -0
  218. package/dist/sandbox/srt/settings.d.ts +60 -0
  219. package/dist/sandbox/srt/settings.js +84 -0
  220. package/dist/sandbox/srt/settings.js.map +1 -0
  221. package/dist/sandbox/types.d.ts +125 -0
  222. package/dist/sandbox/types.js +6 -0
  223. package/dist/sandbox/types.js.map +1 -0
  224. package/dist/server/answers.d.ts +16 -0
  225. package/dist/server/answers.js +43 -0
  226. package/dist/server/answers.js.map +1 -0
  227. package/dist/server/connection.d.ts +99 -0
  228. package/dist/server/connection.js +309 -0
  229. package/dist/server/connection.js.map +1 -0
  230. package/dist/server/dispatcher.d.ts +86 -0
  231. package/dist/server/dispatcher.js +800 -0
  232. package/dist/server/dispatcher.js.map +1 -0
  233. package/dist/server/index.d.ts +13 -0
  234. package/dist/server/index.js +12 -0
  235. package/dist/server/index.js.map +1 -0
  236. package/dist/server/local-transport.d.ts +44 -0
  237. package/dist/server/local-transport.js +103 -0
  238. package/dist/server/local-transport.js.map +1 -0
  239. package/dist/server/outbox.d.ts +31 -0
  240. package/dist/server/outbox.js +130 -0
  241. package/dist/server/outbox.js.map +1 -0
  242. package/dist/server/params.d.ts +25 -0
  243. package/dist/server/params.js +112 -0
  244. package/dist/server/params.js.map +1 -0
  245. package/dist/server/protocol.schema.json +2448 -0
  246. package/dist/server/rpc-session.d.ts +43 -0
  247. package/dist/server/rpc-session.js +167 -0
  248. package/dist/server/rpc-session.js.map +1 -0
  249. package/dist/server/stdio-streams.d.ts +67 -0
  250. package/dist/server/stdio-streams.js +218 -0
  251. package/dist/server/stdio-streams.js.map +1 -0
  252. package/dist/server/stdio.d.ts +59 -0
  253. package/dist/server/stdio.js +189 -0
  254. package/dist/server/stdio.js.map +1 -0
  255. package/dist/server/websocket.d.ts +106 -0
  256. package/dist/server/websocket.js +327 -0
  257. package/dist/server/websocket.js.map +1 -0
  258. package/dist/session/approvals.d.ts +81 -0
  259. package/dist/session/approvals.js +217 -0
  260. package/dist/session/approvals.js.map +1 -0
  261. package/dist/session/code-call-log.d.ts +42 -0
  262. package/dist/session/code-call-log.js +63 -0
  263. package/dist/session/code-call-log.js.map +1 -0
  264. package/dist/session/code-call-result.d.ts +19 -0
  265. package/dist/session/code-call-result.js +95 -0
  266. package/dist/session/code-call-result.js.map +1 -0
  267. package/dist/session/code-call.d.ts +49 -0
  268. package/dist/session/code-call.js +345 -0
  269. package/dist/session/code-call.js.map +1 -0
  270. package/dist/session/effect-scope.d.ts +11 -0
  271. package/dist/session/effect-scope.js +10 -0
  272. package/dist/session/effect-scope.js.map +1 -0
  273. package/dist/session/errors.d.ts +19 -0
  274. package/dist/session/errors.js +27 -0
  275. package/dist/session/errors.js.map +1 -0
  276. package/dist/session/file-index.d.ts +8 -0
  277. package/dist/session/file-index.js +70 -0
  278. package/dist/session/file-index.js.map +1 -0
  279. package/dist/session/file-key-store.d.ts +16 -0
  280. package/dist/session/file-key-store.js +169 -0
  281. package/dist/session/file-key-store.js.map +1 -0
  282. package/dist/session/file-lock.d.ts +52 -0
  283. package/dist/session/file-lock.js +324 -0
  284. package/dist/session/file-lock.js.map +1 -0
  285. package/dist/session/index.d.ts +22 -0
  286. package/dist/session/index.js +20 -0
  287. package/dist/session/index.js.map +1 -0
  288. package/dist/session/jsonl-store.d.ts +37 -0
  289. package/dist/session/jsonl-store.js +386 -0
  290. package/dist/session/jsonl-store.js.map +1 -0
  291. package/dist/session/jsonl.d.ts +9 -0
  292. package/dist/session/jsonl.js +10 -0
  293. package/dist/session/jsonl.js.map +1 -0
  294. package/dist/session/lock.d.ts +19 -0
  295. package/dist/session/lock.js +2 -0
  296. package/dist/session/lock.js.map +1 -0
  297. package/dist/session/memory-store.d.ts +12 -0
  298. package/dist/session/memory-store.js +60 -0
  299. package/dist/session/memory-store.js.map +1 -0
  300. package/dist/session/migrate.d.ts +41 -0
  301. package/dist/session/migrate.js +86 -0
  302. package/dist/session/migrate.js.map +1 -0
  303. package/dist/session/pointer.d.ts +15 -0
  304. package/dist/session/pointer.js +22 -0
  305. package/dist/session/pointer.js.map +1 -0
  306. package/dist/session/rebuild.d.ts +53 -0
  307. package/dist/session/rebuild.js +230 -0
  308. package/dist/session/rebuild.js.map +1 -0
  309. package/dist/session/resume.d.ts +26 -0
  310. package/dist/session/resume.js +128 -0
  311. package/dist/session/resume.js.map +1 -0
  312. package/dist/session/retention.d.ts +97 -0
  313. package/dist/session/retention.js +702 -0
  314. package/dist/session/retention.js.map +1 -0
  315. package/dist/session/runner.d.ts +156 -0
  316. package/dist/session/runner.js +656 -0
  317. package/dist/session/runner.js.map +1 -0
  318. package/dist/session/scheduler.d.ts +47 -0
  319. package/dist/session/scheduler.js +85 -0
  320. package/dist/session/scheduler.js.map +1 -0
  321. package/dist/session/secret-key-store.d.ts +47 -0
  322. package/dist/session/secret-key-store.js +79 -0
  323. package/dist/session/secret-key-store.js.map +1 -0
  324. package/dist/session/session.d.ts +106 -0
  325. package/dist/session/session.js +353 -0
  326. package/dist/session/session.js.map +1 -0
  327. package/dist/session/sticky.d.ts +48 -0
  328. package/dist/session/sticky.js +232 -0
  329. package/dist/session/sticky.js.map +1 -0
  330. package/dist/session/store.d.ts +108 -0
  331. package/dist/session/store.js +163 -0
  332. package/dist/session/store.js.map +1 -0
  333. package/dist/telemetry/index.d.ts +2 -0
  334. package/dist/telemetry/index.js +3 -0
  335. package/dist/telemetry/index.js.map +1 -0
  336. package/dist/testing/fake-sandbox.d.ts +52 -0
  337. package/dist/testing/fake-sandbox.js +370 -0
  338. package/dist/testing/fake-sandbox.js.map +1 -0
  339. package/dist/testing/index.d.ts +10 -0
  340. package/dist/testing/index.js +11 -0
  341. package/dist/testing/index.js.map +1 -0
  342. package/dist/testing/key-store-conformance.d.ts +22 -0
  343. package/dist/testing/key-store-conformance.js +97 -0
  344. package/dist/testing/key-store-conformance.js.map +1 -0
  345. package/dist/testing/run-cases.d.ts +21 -0
  346. package/dist/testing/run-cases.js +20 -0
  347. package/dist/testing/run-cases.js.map +1 -0
  348. package/dist/testing/sandbox-conformance.d.ts +64 -0
  349. package/dist/testing/sandbox-conformance.js +468 -0
  350. package/dist/testing/sandbox-conformance.js.map +1 -0
  351. package/dist/testing/scheduler-conformance.d.ts +32 -0
  352. package/dist/testing/scheduler-conformance.js +72 -0
  353. package/dist/testing/scheduler-conformance.js.map +1 -0
  354. package/dist/testing/store-conformance.d.ts +21 -0
  355. package/dist/testing/store-conformance.js +320 -0
  356. package/dist/testing/store-conformance.js.map +1 -0
  357. package/dist/tools/builtins/bash.d.ts +9 -0
  358. package/dist/tools/builtins/bash.js +75 -0
  359. package/dist/tools/builtins/bash.js.map +1 -0
  360. package/dist/tools/builtins/builtins.d.ts +38 -0
  361. package/dist/tools/builtins/builtins.js +48 -0
  362. package/dist/tools/builtins/builtins.js.map +1 -0
  363. package/dist/tools/builtins/descriptions.d.ts +69 -0
  364. package/dist/tools/builtins/descriptions.js +94 -0
  365. package/dist/tools/builtins/descriptions.js.map +1 -0
  366. package/dist/tools/builtins/fetch.d.ts +12 -0
  367. package/dist/tools/builtins/fetch.js +157 -0
  368. package/dist/tools/builtins/fetch.js.map +1 -0
  369. package/dist/tools/builtins/files.d.ts +27 -0
  370. package/dist/tools/builtins/files.js +274 -0
  371. package/dist/tools/builtins/files.js.map +1 -0
  372. package/dist/tools/builtins/paths.d.ts +30 -0
  373. package/dist/tools/builtins/paths.js +62 -0
  374. package/dist/tools/builtins/paths.js.map +1 -0
  375. package/dist/tools/builtins/results.d.ts +15 -0
  376. package/dist/tools/builtins/results.js +31 -0
  377. package/dist/tools/builtins/results.js.map +1 -0
  378. package/dist/tools/builtins/search.d.ts +18 -0
  379. package/dist/tools/builtins/search.js +217 -0
  380. package/dist/tools/builtins/search.js.map +1 -0
  381. package/dist/tools/errors.d.ts +13 -0
  382. package/dist/tools/errors.js +17 -0
  383. package/dist/tools/errors.js.map +1 -0
  384. package/dist/tools/index.d.ts +12 -0
  385. package/dist/tools/index.js +11 -0
  386. package/dist/tools/index.js.map +1 -0
  387. package/dist/tools/registry.d.ts +3 -0
  388. package/dist/tools/registry.js +234 -0
  389. package/dist/tools/registry.js.map +1 -0
  390. package/dist/tools/tool-search.d.ts +30 -0
  391. package/dist/tools/tool-search.js +118 -0
  392. package/dist/tools/tool-search.js.map +1 -0
  393. package/dist/tools/types.d.ts +106 -0
  394. package/dist/tools/types.js +2 -0
  395. package/dist/tools/types.js.map +1 -0
  396. package/llms.txt +469 -0
  397. package/package.json +118 -3
@@ -0,0 +1,468 @@
1
+ /**
2
+ * The sandbox conformance suite: what every `SandboxClient` must do, whatever its tier. The cases that need a backend to
3
+ * enforce something run only when its `stops` claim it, so a `none` backend passes the rest and an honest `srt` or
4
+ * Docker backend passes them all. A backend that can't start makes every case skip with its reason, never fail. The cases
5
+ * import no test runner and no Node module, so any runner can call them, in workerd too.
6
+ */
7
+ import { isHarnessError } from "../errors.js";
8
+ import { confirmPolicy, hasCapability, pauseSandbox, policyDifference, resumeSandbox, snapshotSandbox, stopsFor, } from "../sandbox/policy.js";
9
+ import { runCases } from "./run-cases.js";
10
+ const STOPS = ["mistakes", "exfiltration", "hostile_process"];
11
+ const CAPABILITIES = ["resume", "snapshot", "pause"];
12
+ const ALLOWED_HOST = "allowed.test";
13
+ const SETTLE_MS = 5000;
14
+ // Variables a program may add to its own environment on start, which a case ignores when it counts the variables.
15
+ const ADDED_BY_RUNTIMES = new Set(["PWD", "OLDPWD", "SHLVL", "_"]);
16
+ const CREDENTIALS = ["ANTHROPIC_API_KEY", "OPENAI_API_KEY", "GITHUB_TOKEN", "AWS_SECRET_ACCESS_KEY"];
17
+ function check(condition, message) {
18
+ if (!condition)
19
+ throw new Error(`Sandbox conformance: ${message}`);
20
+ }
21
+ const never = () => new AbortController().signal;
22
+ const text = (data) => new TextDecoder().decode(data);
23
+ /** The error's `code` when it is a `HarnessError`, which works across two bundled copies of this package. */
24
+ function codeOf(error) {
25
+ return isHarnessError(error) ? error.code : undefined;
26
+ }
27
+ /** The denial a `sandbox_denied` error carries, or `undefined` for any other error. */
28
+ function denialOf(error) {
29
+ return codeOf(error) === "sandbox_denied" ? error.denial : undefined;
30
+ }
31
+ /** Provisions a sandbox for a case, or the skip that a backend reporting itself unavailable gets. */
32
+ async function provision(context) {
33
+ try {
34
+ return await context.under.client.provision({ root: context.under.root }, context.policy);
35
+ }
36
+ catch (error) {
37
+ if (codeOf(error) === "sandbox_unavailable")
38
+ return { skipped: error.message };
39
+ throw error;
40
+ }
41
+ }
42
+ const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
43
+ /** Polls until `test` is true, for at most `SETTLE_MS`. */
44
+ async function eventually(test) {
45
+ const stop = Date.now() + SETTLE_MS;
46
+ while (Date.now() < stop) {
47
+ if (await test())
48
+ return true;
49
+ await sleep(50);
50
+ }
51
+ return test();
52
+ }
53
+ /** Runs `action` and returns the denial it ended in, as a thrown error or as a command's `denied` result. */
54
+ async function denialFrom(action) {
55
+ try {
56
+ const result = await action();
57
+ return typeof result === "object" && result !== null && "denied" in result
58
+ ? result.denied
59
+ : undefined;
60
+ }
61
+ catch (error) {
62
+ return denialOf(error);
63
+ }
64
+ }
65
+ /** Wraps a case's check so it provisions first, disposes after, and skips when the backend is unavailable. */
66
+ function withSandbox(factory, options, body) {
67
+ return async () => {
68
+ const under = await factory();
69
+ const root = under.root;
70
+ const policy = {
71
+ readRoots: [root],
72
+ writeRoots: [root],
73
+ network: { allow: [options.network?.allowed ?? ALLOWED_HOST], deny: [] },
74
+ };
75
+ const context = { under, options, policy, outside: `${root}-outside` };
76
+ const sandbox = await provision(context);
77
+ if ("skipped" in sandbox)
78
+ return sandbox;
79
+ try {
80
+ return await body(sandbox, context);
81
+ }
82
+ finally {
83
+ await sandbox.dispose();
84
+ }
85
+ };
86
+ }
87
+ async function exec(sandbox, command, extra = {}) {
88
+ return sandbox.exec(command, {
89
+ env: extra.env ?? {},
90
+ signal: extra.signal ?? never(),
91
+ ...(extra.cwd === undefined ? {} : { cwd: extra.cwd }),
92
+ ...(extra.timeoutMs === undefined ? {} : { timeoutMs: extra.timeoutMs }),
93
+ });
94
+ }
95
+ function finished(result) {
96
+ check(!("denied" in result), "a command inside the workspace must not be denied");
97
+ return result;
98
+ }
99
+ /** The case that checks a backend's claims about itself. */
100
+ function honestyCases(factory) {
101
+ return [
102
+ {
103
+ name: "a backend names its tier and stops honestly: a none tier stops nothing, and every stop is a known one",
104
+ async run() {
105
+ const { client } = await factory();
106
+ check(["none", "os", "container", "gvisor", "microvm"].includes(client.tier), `unknown tier ${String(client.tier)}`);
107
+ check(client.stops.every((stop) => STOPS.includes(stop)), "every stop must be a known one");
108
+ check(client.tier !== "none" || client.stops.length === 0, "a none tier must stop nothing");
109
+ return undefined;
110
+ },
111
+ },
112
+ ];
113
+ }
114
+ /** The cases that run in a provisioned sandbox. */
115
+ function workspaceCases(sandboxed) {
116
+ return [
117
+ {
118
+ name: "a file written in the workspace reads back as the same bytes",
119
+ run: sandboxed(async (sandbox) => {
120
+ await sandbox.writeFile("notes/a.txt", new TextEncoder().encode("hello"));
121
+ check(text(await sandbox.readFile("notes/a.txt")) === "hello", "the bytes written must be the bytes read");
122
+ return undefined;
123
+ }),
124
+ },
125
+ {
126
+ name: "exec resolves with the exit code and output, and a failing command is a result, not an error",
127
+ run: sandboxed(async (sandbox) => {
128
+ const echoed = finished(await exec(sandbox, ["echo", "hello"]));
129
+ check(echoed.exitCode === 0 && echoed.stdout.trim() === "hello", "echo must print its argument and exit 0");
130
+ const failed = finished(await exec(sandbox, ["false"]));
131
+ check(failed.exitCode !== 0, "a failing command must resolve with a non-zero exit code");
132
+ return undefined;
133
+ }),
134
+ },
135
+ {
136
+ name: "exec's environment holds only the variables it was given, and no credential",
137
+ run: sandboxed(async (sandbox, context) => {
138
+ const given = { ALPHA: "1", BETA: "2" };
139
+ const printed = finished(await exec(sandbox, ["env"], { env: given }));
140
+ const lines = printed.stdout.split("\n").filter((line) => line !== "");
141
+ const names = lines.map((line) => line.slice(0, line.indexOf("=")));
142
+ check(lines.includes("ALPHA=1") && lines.includes("BETA=2"), "the given variables must reach the command");
143
+ const addedByBackend = new Set(context.options.addedEnvironment ?? []);
144
+ const extra = names.filter((name) => !(name in given) && !ADDED_BY_RUNTIMES.has(name) && !addedByBackend.has(name));
145
+ check(extra.length === 0, `the command saw variables that were not given: ${extra.join(", ")}`);
146
+ check(!names.some((name) => CREDENTIALS.includes(name)), "no credential may be in the environment");
147
+ return undefined;
148
+ }),
149
+ },
150
+ {
151
+ name: "reading a file that doesn't exist rejects with sandbox_not_found",
152
+ run: sandboxed(async (sandbox) => {
153
+ const code = await sandbox.readFile("no/such/file.txt").then(() => "it resolved", (error) => codeOf(error) ?? String(error));
154
+ check(code === "sandbox_not_found", `a missing file must reject with sandbox_not_found, not ${code}`);
155
+ return undefined;
156
+ }),
157
+ },
158
+ {
159
+ name: "an already aborted signal rejects exec before the command runs",
160
+ run: sandboxed(async (sandbox) => {
161
+ const controller = new AbortController();
162
+ controller.abort(new Error("stop"));
163
+ let rejected = false;
164
+ await exec(sandbox, ["echo", "never"], { signal: controller.signal }).catch(() => {
165
+ rejected = true;
166
+ });
167
+ check(rejected, "exec must reject for an aborted signal");
168
+ return undefined;
169
+ }),
170
+ },
171
+ {
172
+ name: "a command that runs past its timeout is stopped with exit code 124 and timedOut",
173
+ run: sandboxed(async (sandbox) => {
174
+ const started = Date.now();
175
+ const result = finished(await exec(sandbox, ["sleep", "10"], { timeoutMs: 200 }));
176
+ check(result.exitCode === 124, `a timed out command must exit with 124, not ${result.exitCode}`);
177
+ check(result.timedOut === true, "a timed out command's result must say timedOut: true");
178
+ check(Date.now() - started < 5000, "the command must be stopped at the timeout");
179
+ return undefined;
180
+ }),
181
+ },
182
+ ];
183
+ }
184
+ /** The case that checks `dispose()`. */
185
+ function disposeCases(factory, options, sandboxed) {
186
+ return [
187
+ {
188
+ name: "dispose ends a command that is still running, which rejects with sandbox_disposed",
189
+ run: sandboxed(async (sandbox) => {
190
+ const running = exec(sandbox, ["sleep", "30"]).then(() => "it resolved", (error) => codeOf(error) ?? String(error));
191
+ await sleep(100);
192
+ await sandbox.dispose();
193
+ const outcome = await Promise.race([running, sleep(SETTLE_MS).then(() => "it never settled")]);
194
+ check(outcome === "sandbox_disposed", `a command running at dispose must reject with sandbox_disposed, not ${outcome}`);
195
+ return undefined;
196
+ }),
197
+ },
198
+ {
199
+ name: "dispose ends the sandbox: a later call rejects, and a second dispose does nothing",
200
+ async run() {
201
+ const under = await factory();
202
+ const context = {
203
+ under,
204
+ options,
205
+ policy: { readRoots: [under.root], writeRoots: [under.root], network: { allow: [], deny: [] } },
206
+ outside: `${under.root}-outside`,
207
+ };
208
+ const sandbox = await provision(context);
209
+ if ("skipped" in sandbox)
210
+ return sandbox;
211
+ await sandbox.dispose();
212
+ await sandbox.dispose();
213
+ let code = "";
214
+ await sandbox.readFile("a.txt").catch((error) => {
215
+ code = isHarnessError(error) ? error.code : String(error);
216
+ });
217
+ check(code === "sandbox_disposed", `a call after dispose must reject with sandbox_disposed, not ${code}`);
218
+ return undefined;
219
+ },
220
+ },
221
+ ];
222
+ }
223
+ const MISTAKES = "the backend does not claim to stop mistakes";
224
+ /** The name of the workspace's folder, for a path that climbs out of it and back into its sibling. */
225
+ function outsideViaParent(context) {
226
+ const root = context.under.root;
227
+ return `../${root.slice(root.lastIndexOf("/") + 1)}-outside`;
228
+ }
229
+ /** The cases that need a backend to enforce its policy, which run only when its `stops` claim it. */
230
+ function policyCases(sandboxed) {
231
+ return [
232
+ {
233
+ name: "a write outside the write roots is denied",
234
+ run: sandboxed(async (sandbox, context) => {
235
+ if (!context.under.client.stops.includes("mistakes"))
236
+ return { skipped: MISTAKES };
237
+ const denial = await denialFrom(() => sandbox.writeFile(`${context.outside}/x.txt`, new Uint8Array([1])));
238
+ check(denial?.kind === "filesystem_write", "a write outside the write roots must be denied");
239
+ return undefined;
240
+ }),
241
+ },
242
+ {
243
+ name: "a read outside the read roots is denied",
244
+ run: sandboxed(async (sandbox, context) => {
245
+ if (!context.under.client.stops.includes("mistakes"))
246
+ return { skipped: MISTAKES };
247
+ const denial = await denialFrom(() => sandbox.readFile(`${context.outside}/x.txt`));
248
+ check(denial?.kind === "filesystem_read", "a read outside the read roots must be denied");
249
+ return undefined;
250
+ }),
251
+ },
252
+ {
253
+ name: "a path that climbs out of the workspace with .. is denied for reads and writes",
254
+ run: sandboxed(async (sandbox, context) => {
255
+ if (!context.under.client.stops.includes("mistakes"))
256
+ return { skipped: MISTAKES };
257
+ const climb = `${outsideViaParent(context)}/x.txt`;
258
+ const write = await denialFrom(() => sandbox.writeFile(climb, new Uint8Array([1])));
259
+ check(write?.kind === "filesystem_write", "a write that climbs out with .. must be denied");
260
+ const read = await denialFrom(() => sandbox.readFile(climb));
261
+ check(read?.kind === "filesystem_read", "a read that climbs out with .. must be denied");
262
+ return undefined;
263
+ }),
264
+ },
265
+ {
266
+ name: "a symlink in the workspace that points outside it is denied for reads and writes",
267
+ run: sandboxed(async (sandbox, context) => {
268
+ if (!context.under.client.stops.includes("mistakes"))
269
+ return { skipped: MISTAKES };
270
+ const symlink = context.under.symlink;
271
+ if (symlink === undefined)
272
+ return { skipped: "the factory gave no symlink function" };
273
+ await symlink(`${context.under.root}/link`, context.outside);
274
+ const write = await denialFrom(() => sandbox.writeFile("link/x.txt", new Uint8Array([1])));
275
+ check(write?.kind === "filesystem_write", "a write through a symlink that points outside must be denied");
276
+ const read = await denialFrom(() => sandbox.readFile("link/x.txt"));
277
+ check(read?.kind === "filesystem_read", "a read through a symlink that points outside must be denied");
278
+ return undefined;
279
+ }),
280
+ },
281
+ {
282
+ name: "a working directory outside the workspace is denied",
283
+ run: sandboxed(async (sandbox, context) => {
284
+ if (!context.under.client.stops.includes("mistakes"))
285
+ return { skipped: MISTAKES };
286
+ const denial = await denialFrom(() => exec(sandbox, ["echo", "hi"], { cwd: "../.." }));
287
+ check(denial !== undefined, "a command whose cwd climbs out of the workspace must be denied");
288
+ return undefined;
289
+ }),
290
+ },
291
+ {
292
+ name: "the network is denied unless the host is on the allowlist",
293
+ run: sandboxed(async (sandbox, context) => {
294
+ const network = context.options.network;
295
+ if (!context.under.client.stops.includes("exfiltration"))
296
+ return { skipped: "the backend does not claim to stop exfiltration" };
297
+ if (network === undefined)
298
+ return { skipped: "no network probe was given" };
299
+ const reached = await exec(sandbox, network.command(network.allowed));
300
+ check(!("denied" in reached) && reached.exitCode === 0, "the allowed host must be reached");
301
+ const blocked = await exec(sandbox, network.command(network.blocked));
302
+ check("denied" in blocked || blocked.exitCode !== 0, "a host that is not allowed must not be reached");
303
+ return undefined;
304
+ }),
305
+ },
306
+ ];
307
+ }
308
+ /** Starts the tree's command, stops it by `stop`, and checks that exec settled the right way and the tree is dead. */
309
+ async function endTree(sandbox, tree, stop) {
310
+ // Clear the previous round's id, so a stale one can't pass for this round's.
311
+ await sandbox.writeFile("pid", new Uint8Array());
312
+ const controller = new AbortController();
313
+ const running = exec(sandbox, tree.command, {
314
+ signal: controller.signal,
315
+ ...(stop === "timeout" ? { timeoutMs: 1500 } : {}),
316
+ }).then((result) => ({ result }), (error) => ({ error }));
317
+ let pid = Number.NaN;
318
+ const wrote = await eventually(async () => {
319
+ pid = Number(text(await sandbox.readFile("pid").catch(() => new Uint8Array())).trim());
320
+ return Number.isInteger(pid) && pid > 0;
321
+ });
322
+ check(wrote, "the command must write its background process's id");
323
+ if (stop === "abort")
324
+ controller.abort(new Error("stop"));
325
+ const outcome = await Promise.race([running, sleep(SETTLE_MS).then(() => undefined)]);
326
+ check(outcome !== undefined, `exec must settle after ${stop}, though a background process held its pipes`);
327
+ check(stop === "abort" ? "error" in outcome : "result" in outcome, `${stop} must ${stop === "abort" ? "reject" : "resolve"}`);
328
+ check(await eventually(async () => !(await tree.isAlive(pid))), `the background process must die on ${stop}`);
329
+ }
330
+ /** The case that checks an abort and a timeout end a command's whole process tree. */
331
+ function processCases(sandboxed) {
332
+ return [
333
+ {
334
+ name: "an abort and a timeout end the command's whole process tree, and exec settles",
335
+ run: sandboxed(async (sandbox, context) => {
336
+ const tree = context.options.processTree;
337
+ if (tree === undefined)
338
+ return { skipped: "no processTree was given" };
339
+ await endTree(sandbox, tree, "abort");
340
+ await endTree(sandbox, tree, "timeout");
341
+ return undefined;
342
+ }),
343
+ },
344
+ ];
345
+ }
346
+ /** The code a call rejects with, or `"it resolved"`. */
347
+ async function rejection(action) {
348
+ return action().then(() => "it resolved", (error) => codeOf(error) ?? String(error));
349
+ }
350
+ /** Checks that a capability the client doesn't list is refused, and that one it lists works and keeps the files. */
351
+ async function checkCapability(sandbox, context, capability) {
352
+ const { client } = context.under;
353
+ if (!hasCapability(client, capability)) {
354
+ const refused = capability === "resume"
355
+ ? await rejection(() => resumeSandbox(client, "no-such-sandbox", context.policy))
356
+ : await rejection(() => (capability === "snapshot" ? snapshotSandbox : pauseSandbox)(client, sandbox));
357
+ check(refused === "sandbox_unsupported", `an unlisted ${capability} must be refused, not ${refused}`);
358
+ return;
359
+ }
360
+ const encoder = new TextEncoder();
361
+ await sandbox.writeFile(`kept-${capability}.txt`, encoder.encode(capability));
362
+ let id = sandbox.id;
363
+ if (capability === "snapshot")
364
+ id = await snapshotSandbox(client, sandbox);
365
+ if (capability === "pause")
366
+ await pauseSandbox(client, sandbox);
367
+ check(typeof id === "string" && id !== "", `a sandbox that can ${capability} must have an id to resume`);
368
+ if (!hasCapability(client, "resume"))
369
+ return;
370
+ const resumed = await resumeSandbox(client, id, context.policy);
371
+ try {
372
+ const kept = text(await resumed.readFile(`kept-${capability}.txt`));
373
+ check(kept === capability, `a sandbox resumed after ${capability} must keep its files`);
374
+ }
375
+ finally {
376
+ // A resume by the sandbox's own id reattaches to it, which the case's own dispose ends.
377
+ if (resumed.id !== sandbox.id)
378
+ await resumed.dispose();
379
+ }
380
+ }
381
+ /** The case that checks the resume, snapshot and pause capabilities. */
382
+ function capabilityCases(sandboxed) {
383
+ return [
384
+ {
385
+ name: "a backend lists only known capabilities, each one it lists works, and one it doesn't is refused with sandbox_unsupported",
386
+ run: sandboxed(async (sandbox, context) => {
387
+ const listed = context.under.client.capabilities ?? [];
388
+ check(Array.isArray(listed) && listed.every((capability) => CAPABILITIES.includes(capability)), "every capability must be a known one");
389
+ for (const capability of CAPABILITIES)
390
+ await checkCapability(sandbox, context, capability);
391
+ return undefined;
392
+ }),
393
+ },
394
+ ];
395
+ }
396
+ const NO_STOP = "the backend does not claim to stop anything, so it enforces no policy to read back";
397
+ /** The cases that check the policy a backend reads back, which run only when it claims a stop. */
398
+ function readBackCases(sandboxed) {
399
+ return [
400
+ {
401
+ name: "a backend that claims a stop reads back the policy it applied, which equals the request, and delivers its stops",
402
+ run: sandboxed(async (sandbox, context) => {
403
+ const { client } = context.under;
404
+ if (client.stops.length === 0)
405
+ return { skipped: NO_STOP };
406
+ check(typeof sandbox.readBack === "function", "a backend that claims a stop must read its policy back");
407
+ const applied = await sandbox.readBack();
408
+ const field = policyDifference(context.policy, applied);
409
+ check(field === undefined, `the read-back must equal the request, but ${field} differs`);
410
+ const delivered = stopsFor(client.tier, applied);
411
+ check(client.stops.every((stop) => delivered.includes(stop)), "the applied policy must deliver every stop claimed");
412
+ const stops = sandbox.stops ?? [];
413
+ check(stops.length === delivered.length && stops.every((stop) => delivered.includes(stop)), "the sandbox's stops must be the ones its applied policy delivers");
414
+ return undefined;
415
+ }),
416
+ },
417
+ {
418
+ name: "a read-back that differs from the request throws sandbox_policy_mismatch, names the field and disposes the sandbox",
419
+ run: sandboxed(async (sandbox, context) => {
420
+ const { client } = context.under;
421
+ if (client.stops.length === 0)
422
+ return { skipped: NO_STOP };
423
+ check(typeof sandbox.readBack === "function", "a backend that claims a stop must read its policy back");
424
+ const applied = await sandbox.readBack();
425
+ const { policy, outside } = context;
426
+ const widened = [
427
+ ["readRoots", { ...policy, readRoots: [...policy.readRoots, outside] }],
428
+ ["writeRoots", { ...policy, writeRoots: [] }],
429
+ ["network.allow", { ...policy, network: { ...policy.network, allow: [...policy.network.allow, "x.test"] } }],
430
+ ["network.deny", { ...policy, network: { ...policy.network, deny: ["y.test"] } }],
431
+ ];
432
+ for (const [field, other] of widened) {
433
+ const found = policyDifference(other, applied);
434
+ check(found === field, `a request that differs in ${field} must be found to differ there, not in ${found}`);
435
+ }
436
+ const asked = widened[2]?.[1] ?? policy;
437
+ const error = await confirmPolicy(client, sandbox, asked).then(() => undefined, (caught) => caught);
438
+ check(codeOf(error) === "sandbox_policy_mismatch", "a mismatch must throw sandbox_policy_mismatch");
439
+ check(error.field === "network.allow", "the error must name the field");
440
+ check(!String(error.message).includes("x.test"), "the message must not name a host");
441
+ const after = await rejection(() => sandbox.readFile("a.txt"));
442
+ check(after === "sandbox_disposed", `a mismatch must dispose the sandbox, but a later call gave ${after}`);
443
+ return undefined;
444
+ }),
445
+ },
446
+ ];
447
+ }
448
+ /** The cases, for a backend from `factory`. Run each one; a case that doesn't apply resolves with `{ skipped }`. */
449
+ export function sandboxConformanceCases(factory, options = {}) {
450
+ const sandboxed = (body) => withSandbox(factory, options, body);
451
+ return [
452
+ ...honestyCases(factory),
453
+ ...workspaceCases(sandboxed),
454
+ ...processCases(sandboxed),
455
+ ...disposeCases(factory, options, sandboxed),
456
+ ...policyCases(sandboxed),
457
+ ...capabilityCases(sandboxed),
458
+ ...readBackCases(sandboxed),
459
+ ];
460
+ }
461
+ /**
462
+ * Runs every case against backends from `factory` and reports which passed, which skipped with a reason and which
463
+ * failed. A backend that reports itself unavailable skips; any other error fails the case.
464
+ */
465
+ export async function runSandboxConformance(factory, options = {}) {
466
+ return runCases(sandboxConformanceCases(factory, options));
467
+ }
468
+ //# sourceMappingURL=sandbox-conformance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sandbox-conformance.js","sourceRoot":"","sources":["../../src/testing/sandbox-conformance.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The sandbox conformance suite: what every `SandboxClient` must do, whatever its tier. The cases that need a backend to\n * enforce something run only when its `stops` claim it, so a `none` backend passes the rest and an honest `srt` or\n * Docker backend passes them all. A backend that can't start makes every case skip with its reason, never fail. The cases\n * import no test runner and no Node module, so any runner can call them, in workerd too.\n */\n\nimport { isHarnessError } from \"../errors.js\";\nimport {\n confirmPolicy,\n hasCapability,\n pauseSandbox,\n policyDifference,\n resumeSandbox,\n snapshotSandbox,\n stopsFor,\n} from \"../sandbox/policy.js\";\nimport type {\n ExecResult,\n Sandbox,\n SandboxCapability,\n SandboxClient,\n SandboxDenial,\n SandboxPolicy,\n} from \"../sandbox/types.js\";\nimport { type CaseReport, type RunnableCase, runCases } from \"./run-cases.js\";\n\n/** What a factory returns: the backend, and the absolute folder to use as the workspace root. */\nexport interface SandboxUnderTest {\n readonly client: SandboxClient;\n /** An absolute folder that exists, empty. A sibling named `<root>-outside` stands for a path the policy refuses. */\n readonly root: string;\n /**\n * Makes `link` an absolute path inside the workspace that stands for `target`, as a symlink does, before or after the\n * sandbox starts. Without it the symlink case skips, because a portable command to make one doesn't exist.\n */\n readonly symlink?: (link: string, target: string) => void | Promise<void>;\n}\n\n/** Makes a fresh backend and workspace for each case. */\nexport type SandboxFactory = () => SandboxUnderTest | Promise<SandboxUnderTest>;\n\n/** The options of the suite. */\nexport interface SandboxConformanceOptions {\n /**\n * The network case: `command(host)` is a command that exits 0 if it reaches `host`. The policy allows only `allowed`,\n * so both hosts must accept a connection from the test, such as two loopback listeners the test owns: a host that never\n * resolves would fail with no policy at all and prove nothing. The case checks that `allowed` is reached and `blocked`\n * is not. Without it that case skips, because a portable command to open a connection doesn't exist.\n */\n readonly network?: {\n readonly allowed: string;\n readonly blocked: string;\n /** The command that exits 0 if it reaches `host`. */\n readonly command: (host: string) => readonly string[];\n };\n /**\n * Variables the backend adds to a command's environment on its own, such as the proxy variables an OS sandbox sets so a\n * program finds its network proxy. The environment case accepts these besides the given ones, and still fails on any\n * other variable and on any credential.\n */\n readonly addedEnvironment?: readonly string[];\n /**\n * The case that checks an abort and a timeout end the command's whole tree. `command` starts a background process,\n * writes its process id to the file `pid` in the workspace and then waits for it, and `isAlive` says whether a process\n * is still running. Without it the case skips, because a portable command that forks doesn't exist.\n */\n readonly processTree?: {\n /** The command that starts a background process, writes its id to `pid` and waits for it. */\n readonly command: readonly string[];\n /** Whether the process with id `pid` is still running. */\n readonly isAlive: (pid: number) => boolean | Promise<boolean>;\n };\n}\n\n/** One case of the sandbox conformance suite, which a runner can register as a test of its own. */\nexport type SandboxCase = RunnableCase;\n\n/** The report the sandbox conformance suite returns: which cases passed, which skipped with a reason and which failed. */\nexport type SandboxConformanceReport = CaseReport;\n\nconst STOPS = [\"mistakes\", \"exfiltration\", \"hostile_process\"];\nconst CAPABILITIES: readonly SandboxCapability[] = [\"resume\", \"snapshot\", \"pause\"];\nconst ALLOWED_HOST = \"allowed.test\";\nconst SETTLE_MS = 5000;\n// Variables a program may add to its own environment on start, which a case ignores when it counts the variables.\nconst ADDED_BY_RUNTIMES = new Set([\"PWD\", \"OLDPWD\", \"SHLVL\", \"_\"]);\nconst CREDENTIALS = [\"ANTHROPIC_API_KEY\", \"OPENAI_API_KEY\", \"GITHUB_TOKEN\", \"AWS_SECRET_ACCESS_KEY\"];\n\nfunction check(condition: boolean, message: string): asserts condition {\n if (!condition) throw new Error(`Sandbox conformance: ${message}`);\n}\n\nconst never = () => new AbortController().signal;\nconst text = (data: Uint8Array) => new TextDecoder().decode(data);\n\n/** The skip a case answers with when the backend can't start. */\ntype Skip = { readonly skipped: string };\n\ninterface Context {\n readonly under: SandboxUnderTest;\n readonly options: SandboxConformanceOptions;\n readonly policy: SandboxPolicy;\n readonly outside: string;\n}\n\n/** The error's `code` when it is a `HarnessError`, which works across two bundled copies of this package. */\nfunction codeOf(error: unknown): string | undefined {\n return isHarnessError(error) ? error.code : undefined;\n}\n\n/** The denial a `sandbox_denied` error carries, or `undefined` for any other error. */\nfunction denialOf(error: unknown): SandboxDenial | undefined {\n return codeOf(error) === \"sandbox_denied\" ? (error as { denial?: SandboxDenial }).denial : undefined;\n}\n\n/** Provisions a sandbox for a case, or the skip that a backend reporting itself unavailable gets. */\nasync function provision(context: Context): Promise<Sandbox | Skip> {\n try {\n return await context.under.client.provision({ root: context.under.root }, context.policy);\n } catch (error) {\n if (codeOf(error) === \"sandbox_unavailable\") return { skipped: (error as Error).message };\n throw error;\n }\n}\n\nconst sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));\n\n/** Polls until `test` is true, for at most `SETTLE_MS`. */\nasync function eventually(test: () => boolean | Promise<boolean>): Promise<boolean> {\n const stop = Date.now() + SETTLE_MS;\n while (Date.now() < stop) {\n if (await test()) return true;\n await sleep(50);\n }\n return test();\n}\n\n/** Runs `action` and returns the denial it ended in, as a thrown error or as a command's `denied` result. */\nasync function denialFrom(action: () => Promise<unknown>): Promise<SandboxDenial | undefined> {\n try {\n const result = await action();\n return typeof result === \"object\" && result !== null && \"denied\" in result\n ? (result as { denied: SandboxDenial }).denied\n : undefined;\n } catch (error) {\n return denialOf(error);\n }\n}\n\n/** Wraps a case's check so it provisions first, disposes after, and skips when the backend is unavailable. */\nfunction withSandbox(\n factory: SandboxFactory,\n options: SandboxConformanceOptions,\n body: (sandbox: Sandbox, context: Context) => Promise<Skip | undefined>,\n) {\n return async (): Promise<Skip | undefined> => {\n const under = await factory();\n const root = under.root;\n const policy: SandboxPolicy = {\n readRoots: [root],\n writeRoots: [root],\n network: { allow: [options.network?.allowed ?? ALLOWED_HOST], deny: [] },\n };\n const context: Context = { under, options, policy, outside: `${root}-outside` };\n const sandbox = await provision(context);\n if (\"skipped\" in sandbox) return sandbox;\n try {\n return await body(sandbox, context);\n } finally {\n await sandbox.dispose();\n }\n };\n}\n\nasync function exec(\n sandbox: Sandbox,\n command: readonly string[],\n extra: { env?: Record<string, string>; timeoutMs?: number; signal?: AbortSignal; cwd?: string } = {},\n): Promise<ExecResult> {\n return sandbox.exec(command, {\n env: extra.env ?? {},\n signal: extra.signal ?? never(),\n ...(extra.cwd === undefined ? {} : { cwd: extra.cwd }),\n ...(extra.timeoutMs === undefined ? {} : { timeoutMs: extra.timeoutMs }),\n });\n}\n\nfunction finished(result: ExecResult): Extract<ExecResult, { exitCode: number }> {\n check(!(\"denied\" in result), \"a command inside the workspace must not be denied\");\n return result;\n}\n\ntype Sandboxed = (\n body: (sandbox: Sandbox, context: Context) => Promise<Skip | undefined>,\n) => () => Promise<Skip | undefined>;\n\n/** The case that checks a backend's claims about itself. */\nfunction honestyCases(factory: SandboxFactory): readonly SandboxCase[] {\n return [\n {\n name: \"a backend names its tier and stops honestly: a none tier stops nothing, and every stop is a known one\",\n async run() {\n const { client } = await factory();\n check(\n [\"none\", \"os\", \"container\", \"gvisor\", \"microvm\"].includes(client.tier),\n `unknown tier ${String(client.tier)}`,\n );\n check(\n client.stops.every((stop) => STOPS.includes(stop)),\n \"every stop must be a known one\",\n );\n check(client.tier !== \"none\" || client.stops.length === 0, \"a none tier must stop nothing\");\n return undefined;\n },\n },\n ];\n}\n\n/** The cases that run in a provisioned sandbox. */\nfunction workspaceCases(sandboxed: Sandboxed): readonly SandboxCase[] {\n return [\n {\n name: \"a file written in the workspace reads back as the same bytes\",\n run: sandboxed(async (sandbox) => {\n await sandbox.writeFile(\"notes/a.txt\", new TextEncoder().encode(\"hello\"));\n check(text(await sandbox.readFile(\"notes/a.txt\")) === \"hello\", \"the bytes written must be the bytes read\");\n return undefined;\n }),\n },\n {\n name: \"exec resolves with the exit code and output, and a failing command is a result, not an error\",\n run: sandboxed(async (sandbox) => {\n const echoed = finished(await exec(sandbox, [\"echo\", \"hello\"]));\n check(echoed.exitCode === 0 && echoed.stdout.trim() === \"hello\", \"echo must print its argument and exit 0\");\n const failed = finished(await exec(sandbox, [\"false\"]));\n check(failed.exitCode !== 0, \"a failing command must resolve with a non-zero exit code\");\n return undefined;\n }),\n },\n {\n name: \"exec's environment holds only the variables it was given, and no credential\",\n run: sandboxed(async (sandbox, context) => {\n const given = { ALPHA: \"1\", BETA: \"2\" };\n const printed = finished(await exec(sandbox, [\"env\"], { env: given }));\n const lines = printed.stdout.split(\"\\n\").filter((line) => line !== \"\");\n const names = lines.map((line) => line.slice(0, line.indexOf(\"=\")));\n check(lines.includes(\"ALPHA=1\") && lines.includes(\"BETA=2\"), \"the given variables must reach the command\");\n const addedByBackend = new Set(context.options.addedEnvironment ?? []);\n const extra = names.filter(\n (name) => !(name in given) && !ADDED_BY_RUNTIMES.has(name) && !addedByBackend.has(name),\n );\n check(extra.length === 0, `the command saw variables that were not given: ${extra.join(\", \")}`);\n check(!names.some((name) => CREDENTIALS.includes(name)), \"no credential may be in the environment\");\n return undefined;\n }),\n },\n {\n name: \"reading a file that doesn't exist rejects with sandbox_not_found\",\n run: sandboxed(async (sandbox) => {\n const code = await sandbox.readFile(\"no/such/file.txt\").then(\n () => \"it resolved\",\n (error: unknown) => codeOf(error) ?? String(error),\n );\n check(code === \"sandbox_not_found\", `a missing file must reject with sandbox_not_found, not ${code}`);\n return undefined;\n }),\n },\n {\n name: \"an already aborted signal rejects exec before the command runs\",\n run: sandboxed(async (sandbox) => {\n const controller = new AbortController();\n controller.abort(new Error(\"stop\"));\n let rejected = false;\n await exec(sandbox, [\"echo\", \"never\"], { signal: controller.signal }).catch(() => {\n rejected = true;\n });\n check(rejected, \"exec must reject for an aborted signal\");\n return undefined;\n }),\n },\n {\n name: \"a command that runs past its timeout is stopped with exit code 124 and timedOut\",\n run: sandboxed(async (sandbox) => {\n const started = Date.now();\n const result = finished(await exec(sandbox, [\"sleep\", \"10\"], { timeoutMs: 200 }));\n check(result.exitCode === 124, `a timed out command must exit with 124, not ${result.exitCode}`);\n check(result.timedOut === true, \"a timed out command's result must say timedOut: true\");\n check(Date.now() - started < 5000, \"the command must be stopped at the timeout\");\n return undefined;\n }),\n },\n ];\n}\n\n/** The case that checks `dispose()`. */\nfunction disposeCases(\n factory: SandboxFactory,\n options: SandboxConformanceOptions,\n sandboxed: Sandboxed,\n): readonly SandboxCase[] {\n return [\n {\n name: \"dispose ends a command that is still running, which rejects with sandbox_disposed\",\n run: sandboxed(async (sandbox) => {\n const running = exec(sandbox, [\"sleep\", \"30\"]).then(\n () => \"it resolved\",\n (error: unknown) => codeOf(error) ?? String(error),\n );\n await sleep(100);\n await sandbox.dispose();\n const outcome = await Promise.race([running, sleep(SETTLE_MS).then(() => \"it never settled\")]);\n check(\n outcome === \"sandbox_disposed\",\n `a command running at dispose must reject with sandbox_disposed, not ${outcome}`,\n );\n return undefined;\n }),\n },\n {\n name: \"dispose ends the sandbox: a later call rejects, and a second dispose does nothing\",\n async run() {\n const under = await factory();\n const context: Context = {\n under,\n options,\n policy: { readRoots: [under.root], writeRoots: [under.root], network: { allow: [], deny: [] } },\n outside: `${under.root}-outside`,\n };\n const sandbox = await provision(context);\n if (\"skipped\" in sandbox) return sandbox;\n await sandbox.dispose();\n await sandbox.dispose();\n let code = \"\";\n await sandbox.readFile(\"a.txt\").catch((error: unknown) => {\n code = isHarnessError(error) ? error.code : String(error);\n });\n check(code === \"sandbox_disposed\", `a call after dispose must reject with sandbox_disposed, not ${code}`);\n return undefined;\n },\n },\n ];\n}\n\nconst MISTAKES = \"the backend does not claim to stop mistakes\";\n\n/** The name of the workspace's folder, for a path that climbs out of it and back into its sibling. */\nfunction outsideViaParent(context: Context): string {\n const root = context.under.root;\n return `../${root.slice(root.lastIndexOf(\"/\") + 1)}-outside`;\n}\n\n/** The cases that need a backend to enforce its policy, which run only when its `stops` claim it. */\nfunction policyCases(sandboxed: Sandboxed): readonly SandboxCase[] {\n return [\n {\n name: \"a write outside the write roots is denied\",\n run: sandboxed(async (sandbox, context) => {\n if (!context.under.client.stops.includes(\"mistakes\")) return { skipped: MISTAKES };\n const denial = await denialFrom(() => sandbox.writeFile(`${context.outside}/x.txt`, new Uint8Array([1])));\n check(denial?.kind === \"filesystem_write\", \"a write outside the write roots must be denied\");\n return undefined;\n }),\n },\n {\n name: \"a read outside the read roots is denied\",\n run: sandboxed(async (sandbox, context) => {\n if (!context.under.client.stops.includes(\"mistakes\")) return { skipped: MISTAKES };\n const denial = await denialFrom(() => sandbox.readFile(`${context.outside}/x.txt`));\n check(denial?.kind === \"filesystem_read\", \"a read outside the read roots must be denied\");\n return undefined;\n }),\n },\n {\n name: \"a path that climbs out of the workspace with .. is denied for reads and writes\",\n run: sandboxed(async (sandbox, context) => {\n if (!context.under.client.stops.includes(\"mistakes\")) return { skipped: MISTAKES };\n const climb = `${outsideViaParent(context)}/x.txt`;\n const write = await denialFrom(() => sandbox.writeFile(climb, new Uint8Array([1])));\n check(write?.kind === \"filesystem_write\", \"a write that climbs out with .. must be denied\");\n const read = await denialFrom(() => sandbox.readFile(climb));\n check(read?.kind === \"filesystem_read\", \"a read that climbs out with .. must be denied\");\n return undefined;\n }),\n },\n {\n name: \"a symlink in the workspace that points outside it is denied for reads and writes\",\n run: sandboxed(async (sandbox, context) => {\n if (!context.under.client.stops.includes(\"mistakes\")) return { skipped: MISTAKES };\n const symlink = context.under.symlink;\n if (symlink === undefined) return { skipped: \"the factory gave no symlink function\" };\n await symlink(`${context.under.root}/link`, context.outside);\n const write = await denialFrom(() => sandbox.writeFile(\"link/x.txt\", new Uint8Array([1])));\n check(write?.kind === \"filesystem_write\", \"a write through a symlink that points outside must be denied\");\n const read = await denialFrom(() => sandbox.readFile(\"link/x.txt\"));\n check(read?.kind === \"filesystem_read\", \"a read through a symlink that points outside must be denied\");\n return undefined;\n }),\n },\n {\n name: \"a working directory outside the workspace is denied\",\n run: sandboxed(async (sandbox, context) => {\n if (!context.under.client.stops.includes(\"mistakes\")) return { skipped: MISTAKES };\n const denial = await denialFrom(() => exec(sandbox, [\"echo\", \"hi\"], { cwd: \"../..\" }));\n check(denial !== undefined, \"a command whose cwd climbs out of the workspace must be denied\");\n return undefined;\n }),\n },\n {\n name: \"the network is denied unless the host is on the allowlist\",\n run: sandboxed(async (sandbox, context) => {\n const network = context.options.network;\n if (!context.under.client.stops.includes(\"exfiltration\"))\n return { skipped: \"the backend does not claim to stop exfiltration\" };\n if (network === undefined) return { skipped: \"no network probe was given\" };\n const reached = await exec(sandbox, network.command(network.allowed));\n check(!(\"denied\" in reached) && reached.exitCode === 0, \"the allowed host must be reached\");\n const blocked = await exec(sandbox, network.command(network.blocked));\n check(\"denied\" in blocked || blocked.exitCode !== 0, \"a host that is not allowed must not be reached\");\n return undefined;\n }),\n },\n ];\n}\n\ntype ProcessTree = NonNullable<SandboxConformanceOptions[\"processTree\"]>;\n\n/** Starts the tree's command, stops it by `stop`, and checks that exec settled the right way and the tree is dead. */\nasync function endTree(sandbox: Sandbox, tree: ProcessTree, stop: \"abort\" | \"timeout\"): Promise<void> {\n // Clear the previous round's id, so a stale one can't pass for this round's.\n await sandbox.writeFile(\"pid\", new Uint8Array());\n const controller = new AbortController();\n const running = exec(sandbox, tree.command, {\n signal: controller.signal,\n ...(stop === \"timeout\" ? { timeoutMs: 1500 } : {}),\n }).then(\n (result) => ({ result }),\n (error: unknown) => ({ error }),\n );\n let pid = Number.NaN;\n const wrote = await eventually(async () => {\n pid = Number(text(await sandbox.readFile(\"pid\").catch(() => new Uint8Array())).trim());\n return Number.isInteger(pid) && pid > 0;\n });\n check(wrote, \"the command must write its background process's id\");\n if (stop === \"abort\") controller.abort(new Error(\"stop\"));\n const outcome = await Promise.race([running, sleep(SETTLE_MS).then(() => undefined)]);\n check(outcome !== undefined, `exec must settle after ${stop}, though a background process held its pipes`);\n check(\n stop === \"abort\" ? \"error\" in outcome : \"result\" in outcome,\n `${stop} must ${stop === \"abort\" ? \"reject\" : \"resolve\"}`,\n );\n check(await eventually(async () => !(await tree.isAlive(pid))), `the background process must die on ${stop}`);\n}\n\n/** The case that checks an abort and a timeout end a command's whole process tree. */\nfunction processCases(sandboxed: Sandboxed): readonly SandboxCase[] {\n return [\n {\n name: \"an abort and a timeout end the command's whole process tree, and exec settles\",\n run: sandboxed(async (sandbox, context) => {\n const tree = context.options.processTree;\n if (tree === undefined) return { skipped: \"no processTree was given\" };\n await endTree(sandbox, tree, \"abort\");\n await endTree(sandbox, tree, \"timeout\");\n return undefined;\n }),\n },\n ];\n}\n\n/** The code a call rejects with, or `\"it resolved\"`. */\nasync function rejection(action: () => Promise<unknown>): Promise<string> {\n return action().then(\n () => \"it resolved\",\n (error: unknown) => codeOf(error) ?? String(error),\n );\n}\n\n/** Checks that a capability the client doesn't list is refused, and that one it lists works and keeps the files. */\nasync function checkCapability(sandbox: Sandbox, context: Context, capability: SandboxCapability): Promise<void> {\n const { client } = context.under;\n if (!hasCapability(client, capability)) {\n const refused =\n capability === \"resume\"\n ? await rejection(() => resumeSandbox(client, \"no-such-sandbox\", context.policy))\n : await rejection(() => (capability === \"snapshot\" ? snapshotSandbox : pauseSandbox)(client, sandbox));\n check(refused === \"sandbox_unsupported\", `an unlisted ${capability} must be refused, not ${refused}`);\n return;\n }\n const encoder = new TextEncoder();\n await sandbox.writeFile(`kept-${capability}.txt`, encoder.encode(capability));\n let id = sandbox.id;\n if (capability === \"snapshot\") id = await snapshotSandbox(client, sandbox);\n if (capability === \"pause\") await pauseSandbox(client, sandbox);\n check(typeof id === \"string\" && id !== \"\", `a sandbox that can ${capability} must have an id to resume`);\n if (!hasCapability(client, \"resume\")) return;\n const resumed = await resumeSandbox(client, id, context.policy);\n try {\n const kept = text(await resumed.readFile(`kept-${capability}.txt`));\n check(kept === capability, `a sandbox resumed after ${capability} must keep its files`);\n } finally {\n // A resume by the sandbox's own id reattaches to it, which the case's own dispose ends.\n if (resumed.id !== sandbox.id) await resumed.dispose();\n }\n}\n\n/** The case that checks the resume, snapshot and pause capabilities. */\nfunction capabilityCases(sandboxed: Sandboxed): readonly SandboxCase[] {\n return [\n {\n name: \"a backend lists only known capabilities, each one it lists works, and one it doesn't is refused with sandbox_unsupported\",\n run: sandboxed(async (sandbox, context) => {\n const listed = context.under.client.capabilities ?? [];\n check(\n Array.isArray(listed) && listed.every((capability) => CAPABILITIES.includes(capability)),\n \"every capability must be a known one\",\n );\n for (const capability of CAPABILITIES) await checkCapability(sandbox, context, capability);\n return undefined;\n }),\n },\n ];\n}\n\nconst NO_STOP = \"the backend does not claim to stop anything, so it enforces no policy to read back\";\n\n/** The cases that check the policy a backend reads back, which run only when it claims a stop. */\nfunction readBackCases(sandboxed: Sandboxed): readonly SandboxCase[] {\n return [\n {\n name: \"a backend that claims a stop reads back the policy it applied, which equals the request, and delivers its stops\",\n run: sandboxed(async (sandbox, context) => {\n const { client } = context.under;\n if (client.stops.length === 0) return { skipped: NO_STOP };\n check(typeof sandbox.readBack === \"function\", \"a backend that claims a stop must read its policy back\");\n const applied = await sandbox.readBack();\n const field = policyDifference(context.policy, applied);\n check(field === undefined, `the read-back must equal the request, but ${field} differs`);\n const delivered = stopsFor(client.tier, applied);\n check(\n client.stops.every((stop) => delivered.includes(stop)),\n \"the applied policy must deliver every stop claimed\",\n );\n const stops = sandbox.stops ?? [];\n check(\n stops.length === delivered.length && stops.every((stop) => delivered.includes(stop)),\n \"the sandbox's stops must be the ones its applied policy delivers\",\n );\n return undefined;\n }),\n },\n {\n name: \"a read-back that differs from the request throws sandbox_policy_mismatch, names the field and disposes the sandbox\",\n run: sandboxed(async (sandbox, context) => {\n const { client } = context.under;\n if (client.stops.length === 0) return { skipped: NO_STOP };\n check(typeof sandbox.readBack === \"function\", \"a backend that claims a stop must read its policy back\");\n const applied = await sandbox.readBack();\n const { policy, outside } = context;\n const widened: [string, SandboxPolicy][] = [\n [\"readRoots\", { ...policy, readRoots: [...policy.readRoots, outside] }],\n [\"writeRoots\", { ...policy, writeRoots: [] }],\n [\"network.allow\", { ...policy, network: { ...policy.network, allow: [...policy.network.allow, \"x.test\"] } }],\n [\"network.deny\", { ...policy, network: { ...policy.network, deny: [\"y.test\"] } }],\n ];\n for (const [field, other] of widened) {\n const found = policyDifference(other, applied);\n check(found === field, `a request that differs in ${field} must be found to differ there, not in ${found}`);\n }\n const asked = widened[2]?.[1] ?? policy;\n const error = await confirmPolicy(client, sandbox, asked).then(\n () => undefined,\n (caught: unknown) => caught,\n );\n check(codeOf(error) === \"sandbox_policy_mismatch\", \"a mismatch must throw sandbox_policy_mismatch\");\n check((error as { field?: unknown }).field === \"network.allow\", \"the error must name the field\");\n check(!String((error as Error).message).includes(\"x.test\"), \"the message must not name a host\");\n const after = await rejection(() => sandbox.readFile(\"a.txt\"));\n check(after === \"sandbox_disposed\", `a mismatch must dispose the sandbox, but a later call gave ${after}`);\n return undefined;\n }),\n },\n ];\n}\n\n/** The cases, for a backend from `factory`. Run each one; a case that doesn't apply resolves with `{ skipped }`. */\nexport function sandboxConformanceCases(\n factory: SandboxFactory,\n options: SandboxConformanceOptions = {},\n): readonly SandboxCase[] {\n const sandboxed: Sandboxed = (body) => withSandbox(factory, options, body);\n return [\n ...honestyCases(factory),\n ...workspaceCases(sandboxed),\n ...processCases(sandboxed),\n ...disposeCases(factory, options, sandboxed),\n ...policyCases(sandboxed),\n ...capabilityCases(sandboxed),\n ...readBackCases(sandboxed),\n ];\n}\n\n/**\n * Runs every case against backends from `factory` and reports which passed, which skipped with a reason and which\n * failed. A backend that reports itself unavailable skips; any other error fails the case.\n */\nexport async function runSandboxConformance(\n factory: SandboxFactory,\n options: SandboxConformanceOptions = {},\n): Promise<SandboxConformanceReport> {\n return runCases(sandboxConformanceCases(factory, options));\n}\n"]}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * The scheduler conformance suite: what every `Scheduler` must do. A wake arrives at or after its time, never before;
3
+ * a duplicate wake is allowed but carries the right id and time; a cancel drops only the id it names. The cases import
4
+ * no test runner and no Node module, so any runner can call them, in workerd too.
5
+ */
6
+ import type { Scheduler } from "../session/scheduler.js";
7
+ import { type CaseReport, type RunnableCase } from "./run-cases.js";
8
+ /** One wake a scheduler delivered. */
9
+ export interface DeliveredWake {
10
+ readonly sessionId: string;
11
+ readonly at: Date;
12
+ }
13
+ /** What a factory returns: the scheduler, and the means to move its clock and read what it delivered. */
14
+ export interface SchedulerUnderTest {
15
+ readonly scheduler: Scheduler;
16
+ /** The scheduler's clock now. */
17
+ readonly now: () => Date;
18
+ /** Moves the clock to `to` and lets every wake that has come due by then be delivered before it resolves. */
19
+ readonly advanceTo: (to: Date) => Promise<void>;
20
+ /** Every wake delivered so far, in the order delivered. */
21
+ readonly delivered: () => readonly DeliveredWake[];
22
+ }
23
+ /** Makes a fresh scheduler for each case. */
24
+ export type SchedulerFactory = () => SchedulerUnderTest | Promise<SchedulerUnderTest>;
25
+ /** One case of the scheduler conformance suite, which a runner can register as a test of its own. */
26
+ export type SchedulerCase = RunnableCase;
27
+ /** The report the scheduler conformance suite returns: which cases passed, which skipped with a reason and which failed. */
28
+ export type SchedulerConformanceReport = CaseReport;
29
+ /** The cases, each run against a scheduler from `factory`. */
30
+ export declare function schedulerConformanceCases(factory: SchedulerFactory): readonly SchedulerCase[];
31
+ /** Runs every case and reports which passed, which skipped and which failed. */
32
+ export declare function runSchedulerConformance(factory: SchedulerFactory): Promise<SchedulerConformanceReport>;