@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 @@
1
+ {"version":3,"file":"retention.js","sourceRoot":"","sources":["../../src/session/retention.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Retention for a `jsonlStore()` folder. Nothing is ever deleted unless the caller sets a retention period: an expired\n * session is then gzipped into `.archive/`, where the store still lists and loads it, or deleted with its pointer. The\n * code only runs when a caller asks, either through `pruneSessions()` or when the store first touches a user, and never\n * on a timer. Every doubt resolves to keeping a file: a file the run cannot read, a session it cannot date and a session\n * that a surviving one continues are all left where they are.\n */\nimport { Buffer } from \"node:buffer\";\nimport { randomUUID } from \"node:crypto\";\nimport { type FileHandle, mkdir, open, readdir, readFile, rename, rm, stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { promisify } from \"node:util\";\nimport { gunzip as gunzipCallback, gzip as gzipCallback } from \"node:zlib\";\nimport { HarnessError, isHarnessError } from \"../errors.js\";\nimport type { LockHandle, SessionLock } from \"./lock.js\";\nimport { isDerivedFile } from \"./session.js\";\nimport { checkKey, encodeName } from \"./store.js\";\n\nconst gunzip = promisify(gunzipCallback);\nconst gzip = promisify(gzipCallback);\n\n/**\n * The folder under the store's folder that holds archived sessions, one folder per user. `encodeName()` encodes every\n * `.`, so no user's folder can have this name.\n */\nexport const ARCHIVE_DIR = \".archive\";\n/** The extension of an archived file: the session file's `.jsonl`, gzipped. */\nexport const ARCHIVE_EXTENSION = \".jsonl.gz\";\nconst LIVE_EXTENSION = \".jsonl\";\nconst POINTER_EXTENSION = \".pointer.json\";\nconst DAY_MS = 86_400_000;\n// How much of a live file one read takes, while the run looks for its first and last lines.\nconst CHUNK_BYTES = 64 * 1024;\n// An archive never changes in place, so what it holds is kept by path, size, time and inode; this bounds the memory.\nconst MAX_CACHED_ARCHIVES = 1024;\n\n/** How long to keep a session after its last entry, and what to do with it then. */\nexport interface Retention {\n /** Days since the session's last entry. A positive number. */\n readonly days: number;\n /** `archive` gzips the session's files into `.archive/`, where the store still reads them. `purge` deletes them. */\n readonly action: \"archive\" | \"purge\";\n}\n\n/** The options of `pruneSessions()`. */\nexport interface PruneOptions {\n /** The store's folder. */\n readonly dir: string;\n readonly userId: string;\n /** Without it nothing is touched, so a caller that has no retention period can pass its setting through unchecked. */\n readonly retention?: Retention;\n /** The clock. Default `new Date()`. */\n readonly now?: () => Date;\n /**\n * The writer lock. A session whose lock is held is kept, and the run holds each lock it takes until that session is\n * archived, purged or kept.\n */\n readonly lock?: SessionLock;\n}\n\n/**\n * Why an expired session was left alone. `locked`: a writer holds its lock. `continued`: a surviving session continues\n * its log. `unreadable`: a file of it, its pointer or, for a purge, any file in the user's folder could not be read, so\n * the run can't tell whether it is expired or continued. `error`: expiring it failed, and the error is in `errors`.\n */\nexport type KeptReason = \"locked\" | \"continued\" | \"unreadable\" | \"error\";\n\n/** What `pruneSessions()` did, by session id. */\nexport interface PruneResult {\n readonly archived: string[];\n readonly purged: string[];\n /** Expired sessions left alone, and why. */\n readonly kept: Array<{ readonly sessionId: string; readonly reason: KeptReason }>;\n /**\n * Files the run left untouched because it could not read them or tell which session they belong to, by name under the\n * user's folder or the user's archive folder. A file with no complete line holds nothing and is not listed.\n */\n readonly skipped: string[];\n /** What stopped each session in `kept` with reason `error`. The run went on with the other sessions. */\n readonly errors: Array<{ readonly sessionId: string; readonly error: unknown }>;\n}\n\n/** Throws a `HarnessError` with code `invalid_retention` unless `days` is a positive finite number and `action` is known. */\nexport function checkRetention(retention: Retention): void {\n if (!Number.isFinite(retention?.days) || retention.days <= 0) {\n throw new HarnessError(\"invalid_retention\", \"retention.days must be a positive number\");\n }\n if (retention.action !== \"archive\" && retention.action !== \"purge\") {\n throw new HarnessError(\"invalid_retention\", 'retention.action must be \"archive\" or \"purge\"');\n }\n}\n\n/** Where a session file's archive is. */\nexport const archivePath = (dir: string, userId: string, file: string): string =>\n join(dir, ARCHIVE_DIR, encodeName(userId), `${encodeName(file)}${ARCHIVE_EXTENSION}`);\n\n/** The bytes of an archived file, or `undefined` when there is none. */\nexport async function readArchive(path: string): Promise<Buffer | undefined> {\n let packed: Buffer;\n try {\n packed = await readFile(path);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n throw error;\n }\n try {\n return await gunzip(packed);\n } catch (error) {\n throw new HarnessError(\"session_corrupt\", `${path} is not a readable archive`, { cause: error });\n }\n}\n\nconst isMissing = (error: unknown): boolean => (error as NodeJS.ErrnoException)?.code === \"ENOENT\";\n\n/** A file's bytes, or `undefined` when it is gone, so a file deleted while the run goes on is simply not there. */\nasync function readIfThere(path: string): Promise<Buffer | undefined> {\n try {\n return await readFile(path);\n } catch (error) {\n if (isMissing(error)) return undefined;\n throw error;\n }\n}\n\nasync function flushFile(path: string): Promise<void> {\n const handle = await open(path, \"r\");\n try {\n await handle.sync();\n } finally {\n await handle.close();\n }\n}\n\n/** Writes `data` to `path` through a temp file and a rename, flushed, so a crash leaves the old file or the new. */\nasync function writeAtomically(path: string, data: Uint8Array): Promise<void> {\n await mkdir(join(path, \"..\"), { recursive: true });\n const temp = `${path}.${randomUUID()}.tmp`;\n try {\n const handle = await open(temp, \"wx\");\n try {\n await handle.writeFile(data);\n await handle.sync();\n } finally {\n await handle.close();\n }\n await rename(temp, path);\n } catch (error) {\n await rm(temp, { force: true });\n throw error;\n }\n await flushFile(join(path, \"..\")).catch(() => undefined);\n}\n\n/** Moves a file's archive back to its place, for a session that is written again. Returns whether there was one. */\nexport async function restoreArchive(dir: string, userId: string, file: string, live: string): Promise<boolean> {\n const archived = archivePath(dir, userId, file);\n const bytes = await readArchive(archived);\n if (bytes === undefined) return false;\n await writeAtomically(live, bytes);\n await rm(archived, { force: true });\n return true;\n}\n\n/** What a file holds, as far as retention needs to know. */\ntype Contents =\n /** A session log. `lastAt` is `undefined` when its last line can't be read, so the file can't be dated. */\n | { readonly kind: \"log\"; readonly lastAt: number | undefined; readonly continues: string | undefined }\n /** A file whose first line is not a session header, so nothing is known of it. */\n | { readonly kind: \"opaque\" };\n\n/** A file's first and last complete lines, which may be the same line. A last line without a newline doesn't count. */\ninterface Edges {\n readonly first: Buffer;\n readonly last: Buffer;\n}\n\n/** The edges of a whole file's bytes, or `undefined` for a file with no complete line, which was never acknowledged. */\nfunction edgesOf(bytes: Buffer): Edges | undefined {\n const firstEnd = bytes.indexOf(0x0a);\n if (firstEnd < 0) return undefined;\n const end = bytes.lastIndexOf(0x0a);\n const start = end === firstEnd ? 0 : bytes.lastIndexOf(0x0a, end - 1) + 1;\n return { first: bytes.subarray(0, firstEnd), last: bytes.subarray(start, end) };\n}\n\n/** Reads up to `length` bytes at `position`, fewer when the file is shorter. */\nasync function readAt(handle: FileHandle, position: number, length: number): Promise<Buffer> {\n const buffer = Buffer.alloc(length);\n const { bytesRead } = await handle.read(buffer, 0, length, position);\n return buffer.subarray(0, bytesRead);\n}\n\n/** The position of the last newline before `before`, or -1, read backwards a chunk at a time. */\nasync function newlineBefore(handle: FileHandle, before: number): Promise<number> {\n for (let end = before; end > 0; end -= CHUNK_BYTES) {\n const start = Math.max(0, end - CHUNK_BYTES);\n const at = (await readAt(handle, start, end - start)).lastIndexOf(0x0a);\n if (at >= 0) return start + at;\n }\n return -1;\n}\n\n/**\n * A live file's edges, read from its two ends, so a long log costs two short reads; `\"empty\"` for a file with no complete\n * line, and `\"gone\"` for a file that is not there. The bytes past the size the file had when it was opened don't count.\n */\nasync function liveEdges(path: string): Promise<Edges | \"empty\" | \"gone\"> {\n let handle: FileHandle;\n try {\n handle = await open(path, \"r\");\n } catch (error) {\n if (isMissing(error)) return \"gone\";\n throw error;\n }\n try {\n const { size } = await handle.stat();\n const head: Buffer[] = [];\n let firstEnd = -1;\n for (let at = 0; at < size && firstEnd < 0; ) {\n const chunk = await readAt(handle, at, Math.min(CHUNK_BYTES, size - at));\n if (chunk.length === 0) break;\n const newline = chunk.indexOf(0x0a);\n head.push(newline < 0 ? chunk : chunk.subarray(0, newline));\n if (newline >= 0) firstEnd = at + newline;\n at += chunk.length;\n }\n if (firstEnd < 0) return \"empty\";\n const first = Buffer.concat(head);\n const end = await newlineBefore(handle, size);\n if (end <= firstEnd) return { first, last: first };\n const start = (await newlineBefore(handle, end)) + 1;\n return { first, last: await readAt(handle, start, end - start) };\n } finally {\n await handle.close();\n }\n}\n\n/** What a file's first and last complete lines say about it. */\nfunction contentsOf(edges: Edges): Contents {\n let header: { type?: unknown; parent?: { session?: unknown } | null; spawn?: unknown } | null;\n try {\n header = JSON.parse(edges.first.toString(\"utf8\"));\n } catch {\n return { kind: \"opaque\" };\n }\n if (header?.type !== \"session_header\") return { kind: \"opaque\" };\n // A spawned child's header names the session that started it, but its log does not continue that session's.\n const parent = header.spawn === undefined ? header.parent?.session : undefined;\n let lastAt: number | undefined;\n try {\n const at = Date.parse(String((JSON.parse(edges.last.toString(\"utf8\")) as { timestamp?: unknown }).timestamp));\n lastAt = Number.isNaN(at) ? undefined : at;\n } catch {\n lastAt = undefined;\n }\n return { kind: \"log\", lastAt, continues: typeof parent === \"string\" ? parent : undefined };\n}\n\ninterface SessionFile {\n /** The file id: the session id for a first file, a derived name for a revert's or a migration's. */\n readonly id: string;\n /** The live copy, when there is one. The store reads it first, so it decides what the file holds. */\n live?: string;\n /** The archived copy, when there is one. */\n archived?: string;\n /**\n * A live file with no complete line beside the archived copy. The store reads past it to the archive, a purge removes\n * it with the archive, and an archive leaves it alone.\n */\n stub?: string;\n readonly contents: Contents;\n}\n\n/** The file id that a store-written name holds, or `undefined` for a name the store would not write. */\nfunction idOf(name: string, extension: string): string | undefined {\n const encoded = name.slice(0, -extension.length);\n try {\n const id = decodeURIComponent(encoded);\n return encodeName(id) === encoded ? id : undefined;\n } catch {\n return undefined;\n }\n}\n\nconst listFolder = (folder: string): Promise<string[]> =>\n readdir(folder).catch((error: unknown) => {\n if (isMissing(error)) return [];\n throw error;\n });\n\ninterface Scan {\n readonly files: Map<string, SessionFile>;\n /** Session id to the file its pointer names, or `undefined` for a pointer that can't be read. */\n readonly pointers: Map<string, string | undefined>;\n readonly skipped: string[];\n /** Whether a store-written file could not be read, so it might be any session's and continue any other. */\n opaque: boolean;\n}\n\ntype Copy = Contents | \"empty\" | \"gone\";\n\nconst archives = new Map<string, { size: number; mtimeMs: number; ino: number; copy: Copy }>();\n\n/** What an archived copy holds, unpacked once and then kept while the file keeps its size, time and inode. */\nasync function readArchivedCopy(path: string): Promise<Copy> {\n const info = await stat(path).catch((error: unknown) => {\n if (isMissing(error)) return undefined;\n throw error;\n });\n if (info === undefined) return \"gone\";\n const cached = archives.get(path);\n if (cached?.size === info.size && cached.mtimeMs === info.mtimeMs && cached.ino === info.ino) return cached.copy;\n let copy: Copy;\n try {\n const bytes = await readArchive(path);\n copy = bytes === undefined ? \"gone\" : contentsOrEmpty(edgesOf(bytes));\n } catch (error) {\n if (isHarnessError(error) && error.code === \"session_corrupt\") copy = { kind: \"opaque\" };\n else throw error;\n }\n archives.delete(path);\n if (copy !== \"gone\") archives.set(path, { size: info.size, mtimeMs: info.mtimeMs, ino: info.ino, copy });\n const oldest = archives.keys().next().value;\n if (archives.size > MAX_CACHED_ARCHIVES && oldest !== undefined) archives.delete(oldest);\n return copy;\n}\n\nconst contentsOrEmpty = (edges: Edges | undefined): Contents | \"empty\" =>\n edges === undefined ? \"empty\" : contentsOf(edges);\n\n/** What a file's live or archived copy holds: its contents, `\"empty\"` with no complete line, or `\"gone\"` when it went. */\nasync function readCopy(path: string, archived: boolean): Promise<Copy> {\n if (archived) return readArchivedCopy(path);\n const edges = await liveEdges(path);\n return edges === \"empty\" || edges === \"gone\" ? edges : contentsOf(edges);\n}\n\n/**\n * Adds one copy of a file to the scan: a name the store would not write is skipped, and a gone file is left out. `stubs`\n * holds the live files with no complete line, by file id, so the archived copy read after them can take them along.\n */\nasync function addCopy(found: Scan, stubs: Map<string, string>, folder: string, name: string, archived: boolean) {\n const path = join(folder, name);\n const id = idOf(name, archived ? ARCHIVE_EXTENSION : LIVE_EXTENSION);\n if (id === undefined) {\n found.skipped.push(path);\n return;\n }\n const known = found.files.get(id);\n if (known !== undefined) {\n // The live copy, read first, decides what the file holds, but a purge removes both copies.\n known.archived = path;\n return;\n }\n const contents = await readCopy(path, archived);\n if (contents === \"gone\") return;\n if (contents === \"empty\") {\n // A file with no complete line holds nothing. A live one is kept in mind, as its archive, if any, is the file.\n if (!archived) stubs.set(id, path);\n return;\n }\n if (contents.kind === \"opaque\") {\n found.opaque = true;\n found.skipped.push(path);\n }\n const stub = archived ? stubs.get(id) : undefined;\n if (!archived) found.files.set(id, { id, live: path, contents });\n else\n found.files.set(id, stub === undefined ? { id, archived: path, contents } : { id, archived: path, stub, contents });\n}\n\nasync function readPointer(path: string): Promise<{ file: string | undefined } | undefined> {\n const text = await readIfThere(path);\n if (text === undefined) return undefined;\n try {\n const file = (JSON.parse(text.toString(\"utf8\")) as { file?: unknown }).file;\n return { file: typeof file === \"string\" ? file : undefined };\n } catch {\n return { file: undefined };\n }\n}\n\n/** Reads the user's live and archived files and pointers. A file that goes while the run reads it is left out. */\nasync function scan(userDir: string, archiveDir: string): Promise<Scan> {\n const found: Scan = { files: new Map(), pointers: new Map(), skipped: [], opaque: false };\n const names = await listFolder(userDir);\n const stubs = new Map<string, string>();\n for (const name of names.filter((entry) => entry.endsWith(LIVE_EXTENSION))) {\n await addCopy(found, stubs, userDir, name, false);\n }\n for (const name of (await listFolder(archiveDir)).filter((entry) => entry.endsWith(ARCHIVE_EXTENSION))) {\n await addCopy(found, stubs, archiveDir, name, true);\n }\n for (const name of names.filter((entry) => entry.endsWith(POINTER_EXTENSION))) {\n const id = idOf(name, POINTER_EXTENSION);\n const pointer = id === undefined ? undefined : await readPointer(join(userDir, name));\n if (id !== undefined && pointer !== undefined) found.pointers.set(id, pointer.file);\n }\n return found;\n}\n\ninterface Session {\n readonly id: string;\n /** Its files in the order expiry handles them: each before any file it continues, the first file last. */\n readonly files: SessionFile[];\n readonly pointer: boolean;\n /** The newest last entry of its files, `-Infinity` with none, or `undefined` when a file or the pointer can't be read. */\n readonly lastAt: number | undefined;\n}\n\nconst continuesOf = (file: SessionFile): string | undefined =>\n file.contents.kind === \"log\" ? file.contents.continues : undefined;\n\n/** Each pointer's chain: the derived file it names, then each derived file that one continues, newest first. */\nfunction pointerChains(found: Scan, owner: Map<string, string>): Map<string, SessionFile[]> {\n const chains = new Map<string, SessionFile[]>();\n for (const [sessionId, target] of found.pointers) {\n const chain: SessionFile[] = [];\n for (let at = target; at !== undefined && isDerivedFile(at) && !owner.has(at); ) {\n const file = found.files.get(at);\n if (file === undefined) break;\n owner.set(at, sessionId);\n chain.push(file);\n at = continuesOf(file);\n }\n chains.set(sessionId, chain);\n }\n return chains;\n}\n\n/** The session a derived file belongs to, found by walking up the files it continues, and the files on the way. */\nfunction homeOf(file: SessionFile, found: Scan, owner: Map<string, string>) {\n const path: SessionFile[] = [file];\n for (let at = continuesOf(file); at !== undefined; ) {\n // A first file's id names its session even when the file itself is gone.\n if (!isDerivedFile(at) || owner.has(at)) return { home: owner.get(at) ?? at, path };\n const next = found.files.get(at);\n if (next === undefined || path.includes(next)) break;\n path.push(next);\n at = continuesOf(next);\n }\n return { home: undefined, path };\n}\n\n/** Orders a session's loose files so that each goes before every loose file it continues. */\nfunction newestFirst(members: SessionFile[]): SessionFile[] {\n const byId = new Map(members.map((file) => [file.id, file]));\n const depth = (file: SessionFile): number => {\n let count = 0;\n for (let at = byId.get(continuesOf(file) ?? \"\"); at !== undefined && count < members.length; count += 1) {\n at = byId.get(continuesOf(at) ?? \"\");\n }\n return count;\n };\n return members\n .map((file) => ({ file, depth: depth(file) }))\n .sort((a, b) => b.depth - a.depth)\n .map(({ file }) => file);\n}\n\n/** The derived files no pointer reaches, by the session they continue. A file whose session can't be found is skipped. */\nfunction looseFiles(found: Scan, owner: Map<string, string>): Map<string, SessionFile[]> {\n const loose = new Map<string, SessionFile[]>();\n for (const file of found.files.values()) {\n if (owner.has(file.id)) continue;\n const { home, path } = homeOf(file, found, owner);\n if (home === undefined) {\n // A file whose header can't be read is in `skipped` already, from the scan.\n const name = file.live ?? file.archived ?? file.id;\n if (!found.skipped.includes(name)) found.skipped.push(name);\n continue;\n }\n for (const member of path) owner.set(member.id, home);\n loose.set(home, [...(loose.get(home) ?? []), ...path]);\n }\n for (const [id, members] of loose) loose.set(id, newestFirst(members));\n return loose;\n}\n\n/** The newest last entry among the files, or `undefined` when one of them, or the pointer, can't be read. */\nfunction lastAtOf(files: readonly SessionFile[], readablePointer: boolean): number | undefined {\n let lastAt: number | undefined = readablePointer ? Number.NEGATIVE_INFINITY : undefined;\n for (const file of files) {\n const at = file.contents.kind === \"log\" ? file.contents.lastAt : undefined;\n lastAt = lastAt === undefined || at === undefined ? undefined : Math.max(lastAt, at);\n }\n return lastAt;\n}\n\n/**\n * Groups the files into sessions. A session owns its first file, the derived files its pointer's chain reaches, and the\n * derived files that continue one of its files. Its files are ordered so that a file goes before the file it continues:\n * the loose files, newest first, then the chain from the file the pointer names, then the first file. A run that stops\n * part-way so never leaves a file whose parent it removed, and every remaining file still continues, through files that\n * remain, the first file, so the next run finds the session again.\n */\nfunction sessionsOf(found: Scan): { sessions: Map<string, Session>; owner: Map<string, string> } {\n const owner = new Map<string, string>();\n const chains = pointerChains(found, owner);\n for (const file of found.files.values()) if (!isDerivedFile(file.id)) owner.set(file.id, file.id);\n const loose = looseFiles(found, owner);\n const sessions = new Map<string, Session>();\n for (const id of new Set([...owner.values(), ...found.pointers.keys()])) {\n const first = found.files.get(id);\n const files = [...(loose.get(id) ?? []), ...(chains.get(id) ?? []), ...(first ? [first] : [])];\n const pointer = found.pointers.has(id);\n const lastAt = lastAtOf(files, !pointer || found.pointers.get(id) !== undefined);\n sessions.set(id, { id, files, pointer, lastAt });\n }\n return { sessions, owner };\n}\n\n/** The sessions whose logs `session` continues: the owners of the files its own files name as parents. */\nfunction parentsOf(session: Session, owner: Map<string, string>, sessions: Map<string, Session>): Session[] {\n const parents: Session[] = [];\n for (const file of session.files) {\n const above = continuesOf(file);\n const parent = above === undefined ? undefined : sessions.get(owner.get(above) ?? above);\n if (parent !== undefined && parent !== session && !parents.includes(parent)) parents.push(parent);\n }\n return parents;\n}\n\n/** Whether `action` has anything to do to the session: a purge removes any copy or pointer, an archive moves live files. */\nconst hasWork = (session: Session, action: Retention[\"action\"]): boolean =>\n action === \"purge\"\n ? session.pointer || session.files.length > 0\n : session.files.some((file) => file.live !== undefined);\n\ninterface Run {\n readonly options: PruneOptions;\n readonly action: Retention[\"action\"];\n readonly userDir: string;\n readonly archiveDir: string;\n /** Whether a store call on this file id is running in this process, which makes its session count as locked. */\n readonly busy: (fileId: string) => boolean;\n /** The sessions as the latest scan found them. */\n sessions: Map<string, Session>;\n owner: Map<string, string>;\n readonly result: PruneResult;\n /** The sessions the run means to expire, with the lock it holds for each until that session's own work ends. */\n readonly acting: Map<string, LockHandle | undefined>;\n}\n\nconst keep = (run: Run, sessionId: string, reason: KeptReason, error?: unknown): void => {\n run.result.kept.push({ sessionId, reason });\n if (reason === \"error\") run.result.errors.push({ sessionId, error });\n};\n\n/** Gives up the lock of a session whose work is over, so its writer can open it before the run ends. */\nasync function release(run: Run, sessionId: string): Promise<void> {\n const handle = run.acting.get(sessionId);\n run.acting.delete(sessionId);\n await handle?.release().catch(() => undefined);\n}\n\n/** Whether a session is to be left alone, can't be judged, or is to be expired. */\nfunction verdictOf(run: Run, session: Session, cutoff: number, opaque: boolean): \"fresh\" | \"unreadable\" | \"expired\" {\n if ((session.lastAt !== undefined && session.lastAt >= cutoff) || !hasWork(session, run.action)) return \"fresh\";\n return session.lastAt === undefined || (run.action === \"purge\" && opaque) ? \"unreadable\" : \"expired\";\n}\n\nconst isBusy = (run: Run, session: Session): boolean =>\n run.busy(session.id) || session.files.some((file) => run.busy(file.id));\n\n/** Picks the expired sessions to act on and takes each one's lock, keeping those it can't date, read or lock. */\nasync function choose(run: Run, cutoff: number, opaque: boolean): Promise<void> {\n for (const session of run.sessions.values()) {\n const verdict = verdictOf(run, session, cutoff, opaque);\n if (verdict !== \"expired\") {\n if (verdict === \"unreadable\") keep(run, session.id, \"unreadable\");\n continue;\n }\n if (isBusy(run, session)) {\n keep(run, session.id, \"locked\");\n continue;\n }\n try {\n const handle = await run.options.lock?.acquire({ userId: run.options.userId, sessionId: session.id });\n if (handle === \"would_block\") keep(run, session.id, \"locked\");\n else run.acting.set(session.id, handle);\n } catch (error) {\n keep(run, session.id, \"error\", error);\n }\n }\n}\n\n/**\n * Reads the folder again once the locks are taken, so a session written between the first read and its lock is judged\n * on what it holds now: one that is fresh or unreadable now is let go, and every later decision uses this read.\n */\nasync function recheck(run: Run, cutoff: number): Promise<void> {\n const found = await scan(run.userDir, run.archiveDir);\n ({ sessions: run.sessions, owner: run.owner } = sessionsOf(found));\n for (const path of found.skipped) if (!run.result.skipped.includes(path)) run.result.skipped.push(path);\n for (const id of [...run.acting.keys()]) {\n const session = run.sessions.get(id);\n const verdict = session === undefined ? \"fresh\" : verdictOf(run, session, cutoff, found.opaque);\n if (verdict === \"expired\") continue;\n if (verdict === \"unreadable\") keep(run, id, \"unreadable\");\n await release(run, id);\n }\n}\n\n/**\n * Expires the user's sessions: each one whose last entry is more than `retention.days` old is archived or purged, and\n * with no `retention` nothing happens. A session is a first file, the derived files that continue it and its pointer,\n * and its files count wherever they are, live or archived, so an archived session expires again under a purge.\n *\n * Before anything is removed, the run takes the lock of every session it means to expire, reads the folder again, and\n * decides from that second read which sessions survive: the fresh ones, the locked ones, and the ones it can't read or\n * date. A writer that appended between the first read and the lock is so judged on what it wrote. A purge then keeps\n * every expired session that a survivor continues, directly or through another kept session, and it keeps every\n * session when any file in the user's folder can't be read, because that file could continue any of them. A purge\n * removes a fork before the session it continues, and keeps that session when the fork's removal fails. Each lock is\n * given up as soon as its session is archived, purged or kept. Without `lock`, nothing stops a writer elsewhere from\n * appending to a session while the run moves it, so pass the lock that writers hold.\n *\n * Each archived file is written and read back before its original goes, and a file deleted while the run goes on is\n * not brought back. A session's files go one at a time, newest first, then its first file and then its pointer, so a\n * run that stops part-way leaves a session the next run still finds and finishes. A failure stops only its own session:\n * it is recorded in `errors` and the run goes on.\n */\nexport function pruneSessions(options: PruneOptions): Promise<PruneResult> {\n return expireSessions(options, () => false);\n}\n\n/**\n * `pruneSessions()` for the store, which passes `busy`: a session with a file that one of the store's own calls is\n * reading or writing is kept as `locked`, so a pass never moves a file under a call that is already past expiry.\n */\nexport async function expireSessions(options: PruneOptions, busy: (fileId: string) => boolean): Promise<PruneResult> {\n const result: PruneResult = { archived: [], purged: [], kept: [], skipped: [], errors: [] };\n const { retention } = options;\n if (retention === undefined) return result;\n checkRetention(retention);\n checkKey({ userId: options.userId, sessionId: \"-\" });\n const userDir = join(options.dir, encodeName(options.userId));\n const archiveDir = join(options.dir, ARCHIVE_DIR, encodeName(options.userId));\n const found = await scan(userDir, archiveDir);\n const { sessions, owner } = sessionsOf(found);\n result.skipped.push(...found.skipped);\n const action = retention.action;\n const run: Run = { options, action, userDir, archiveDir, busy, sessions, owner, result, acting: new Map() };\n const cutoff = (options.now?.() ?? new Date()).getTime() - retention.days * DAY_MS;\n try {\n await choose(run, cutoff, found.opaque);\n if (run.acting.size > 0) await recheck(run, cutoff);\n if (retention.action === \"archive\") {\n for (const id of [...run.acting.keys()]) {\n await attempt(run, id, () => archiveSession(run, id));\n await release(run, id);\n }\n } else {\n await purgeAll(run);\n }\n } finally {\n for (const id of [...run.acting.keys()]) await release(run, id);\n }\n return result;\n}\n\n/** Runs one session's expiry, and records a failure as that session's instead of ending the run. */\nasync function attempt(run: Run, sessionId: string, task: () => Promise<void>): Promise<boolean> {\n try {\n await task();\n return true;\n } catch (error) {\n keep(run, sessionId, \"error\", error);\n return false;\n }\n}\n\n/** Takes out of `pending` every session that a survivor continues, directly or through another kept session. */\nfunction protect(run: Run, pending: Set<string>): void {\n const survivors = [...run.sessions.values()].filter((session) => !pending.has(session.id));\n for (let session = survivors.pop(); session !== undefined; session = survivors.pop()) {\n for (const parent of parentsOf(session, run.owner, run.sessions)) {\n if (!pending.delete(parent.id)) continue;\n keep(run, parent.id, \"continued\");\n survivors.push(parent);\n }\n }\n}\n\n/** For each pending session, the pending sessions that continue it. */\nfunction childrenOf(run: Run, pending: Set<string>): Map<string, string[]> {\n const children = new Map<string, string[]>();\n for (const id of pending) {\n for (const parent of parentsOf(run.sessions.get(id) as Session, run.owner, run.sessions)) {\n if (pending.has(parent.id)) children.set(parent.id, [...(children.get(parent.id) ?? []), id]);\n }\n }\n return children;\n}\n\n/**\n * Purges the chosen sessions, minus those a survivor continues, each fork before the session it continues. Every\n * decision is made before the first file goes, and each session's lock is given up as soon as its own fate is settled:\n * a parent's lock stays held until the parent itself is purged or kept, so no fork of it can start meanwhile.\n */\nasync function purgeAll(run: Run): Promise<void> {\n const pending = new Set(run.acting.keys());\n protect(run, pending);\n for (const id of [...run.acting.keys()]) if (!pending.has(id)) await release(run, id);\n const children = childrenOf(run, pending);\n const ended = new Map<string, boolean>();\n for (let progress = true; progress; ) {\n progress = false;\n for (const id of pending) {\n const waiting = children.get(id) ?? [];\n if (!waiting.every((child) => ended.has(child))) continue;\n pending.delete(id);\n progress = true;\n // A fork that could not be removed still continues this session, so it stays.\n ended.set(id, await purgeUnlessContinued(run, id, waiting, ended));\n }\n }\n // What is left is a cycle of sessions that continue each other, which only a corrupt folder has.\n for (const id of pending) keep(run, id, \"continued\");\n}\n\n/** Purges one session once its forks have ended, unless one of them failed to go, and gives up its lock. */\nasync function purgeUnlessContinued(run: Run, id: string, forks: string[], ended: Map<string, boolean>) {\n let done = false;\n if (forks.some((fork) => ended.get(fork) === false)) keep(run, id, \"continued\");\n else done = await attempt(run, id, () => purgeSession(run, run.sessions.get(id) as Session));\n if (done) run.result.purged.push(id);\n await release(run, id);\n return done;\n}\n\nasync function purgeSession(run: Run, session: Session): Promise<void> {\n for (const file of session.files) {\n if (file.live !== undefined) await rm(file.live, { force: true });\n if (file.stub !== undefined) await removeStub(file.stub);\n if (file.archived !== undefined) await rm(file.archived, { force: true });\n }\n if (session.pointer) await rm(join(run.userDir, `${encodeName(session.id)}${POINTER_EXTENSION}`), { force: true });\n}\n\n/** Removes a live file that held no complete line when the run read it, and keeps it if a line has landed since. */\nasync function removeStub(path: string): Promise<void> {\n const edges = await liveEdges(path);\n if (edges === \"gone\") return;\n if (edges !== \"empty\") {\n throw new HarnessError(\"session_conflict\", `${path} was written during the run, so the session was kept`);\n }\n await rm(path, { force: true });\n}\n\nasync function archiveSession(run: Run, sessionId: string): Promise<void> {\n let moved = false;\n for (const file of (run.sessions.get(sessionId) as Session).files) {\n if (file.live === undefined) continue;\n if (await archiveFile(run.options.dir, run.options.userId, file.id, file.live)) moved = true;\n }\n if (moved) run.result.archived.push(sessionId);\n}\n\n/**\n * Archives one file and removes the original once the archive reads back to the same bytes. A file that is gone, or\n * that goes while its archive is written, is not archived, so a delete during the run never brings a session back.\n * Returns whether the file was archived.\n */\nasync function archiveFile(dir: string, userId: string, id: string, live: string): Promise<boolean> {\n const original = await readIfThere(live);\n if (original === undefined) return false;\n const target = archivePath(dir, userId, id);\n await writeAtomically(target, await gzip(original));\n if (!(await readArchive(target))?.equals(original)) {\n throw new HarnessError(\"session_corrupt\", `${target} does not match ${live}, so the original was kept`);\n }\n // The archive is written before the original is read again, and a delete removes the original before its archive, so\n // in whichever order the two run, a deleted file leaves no archive behind.\n const again = await readIfThere(live);\n if (again === undefined || !again.equals(original)) {\n await rm(target, { force: true });\n if (again === undefined) return false;\n throw new HarnessError(\"session_corrupt\", `${live} changed while it was archived, so the original was kept`);\n }\n await rm(live, { force: true });\n return true;\n}\n"]}
@@ -0,0 +1,156 @@
1
+ /**
2
+ * `runTurn()`: one SDK run, written into a session's log. The user entries are durable before the run starts, so a turn
3
+ * that dies before its first model call leaves the question in the file. The run's own events then become entries
4
+ * through one observer: a message's blocks and end when its call ends, a tool's result when the call ends, usage, and the
5
+ * turn's end. Every write goes through one queue, so the permission pipeline's entries and the observer's never race for
6
+ * the same parent.
7
+ */
8
+ import { type ContentBlock, type Message, type Model } from "@buildanagent/gateway";
9
+ import { type SessionEntry } from "@buildanagent/protocol";
10
+ import { type CallOptions, type Observer, type Resolution, type Run, type RunResult, type ToolDefinition, type ToolResult } from "@buildanagent/sdk";
11
+ import type { Clock } from "@buildanagent/sdk/testing";
12
+ import { type CompletionSettings } from "../completion/check.js";
13
+ import type { ContextFill } from "../context/types.js";
14
+ import type { Harness } from "../harness.js";
15
+ import type { Session } from "./session.js";
16
+ import type { EntryInput } from "./store.js";
17
+ /** One call to a `client_request` tool, as `TurnOptions.clientTool` receives it. */
18
+ export interface ClientToolCall {
19
+ readonly callId: string;
20
+ /** The tool's canonical name. */
21
+ readonly tool: string;
22
+ /** The input after the SDK validated it. */
23
+ readonly input: unknown;
24
+ /** Fires when the run is aborted, so the caller can withdraw the request it sent. */
25
+ readonly signal: AbortSignal;
26
+ }
27
+ /** Runs a `client_request` tool's call by asking the client that holds the tool, and resolves with its result. */
28
+ export type ClientToolRunner = (call: ClientToolCall) => Promise<ToolResult>;
29
+ /** The options of one turn. Anything left out takes the harness's setting. */
30
+ export interface TurnOptions<H = unknown> {
31
+ readonly input: string | ContentBlock[];
32
+ /** The `origin` of the input blocks: `operator` for text the host wrote, such as a scheduled prompt. Default `user`. */
33
+ readonly inputOrigin?: "user" | "operator";
34
+ readonly budgetUsd?: number;
35
+ readonly signal?: AbortSignal;
36
+ /** This turn's host context. A tool reads it as `ctx.app`; it reaches no schema, event or entry. */
37
+ readonly hostContext?: H;
38
+ readonly system?: string;
39
+ /** The registered tools this turn may use, by name or alias. A name the registry lacks throws. Default every tool. */
40
+ readonly tools?: readonly string[];
41
+ readonly output?: ToolDefinition<unknown, unknown, unknown>;
42
+ /** The model for this turn. A change from the session's last model is recorded as a `loadout` entry. */
43
+ readonly model?: Model;
44
+ readonly maxSteps?: number;
45
+ /** How many times the loop re-issues a call that ended with a retryable error. Default none. */
46
+ readonly turnRetries?: number;
47
+ readonly modelOptions?: CallOptions;
48
+ /** Called with the run as soon as it starts, so a caller can `steer()`, `followUp()` or abort it. */
49
+ readonly onRun?: (run: Run<unknown>) => void;
50
+ /** Called with how full the request view is after each model call's view is built, when the harness has a context policy. */
51
+ readonly onContextFill?: (fill: ContextFill) => void;
52
+ /** Called when the first run has ended because the request was too large and a retry may follow. */
53
+ readonly onOverflowRetry?: () => void;
54
+ /**
55
+ * Checks the turn's completion. Before the model runs, the turn resolves the project's checks in this sandbox and
56
+ * snapshots the workspace and the check config. A turn that ends `done` then runs those checks, diffs the workspace
57
+ * and the config against the start, and writes a `completion_check` entry. The stop reason is unchanged: a failed
58
+ * check, a flag or a check that could not run is recorded, never fatal. The result's `lastEntryId` is that entry.
59
+ */
60
+ readonly completion?: CompletionSettings;
61
+ /** Called with the `completion_check` entry once it is written. */
62
+ readonly onCompletionCheck?: (entry: SessionEntry) => void;
63
+ /** Observers for this turn alone. Unlike `Run.on()`, they also see `run_start`. They run after the harness's own. */
64
+ readonly observers?: readonly Observer[];
65
+ /**
66
+ * Runs the calls of every tool registered with the `client_request` pattern, in place of the tool's own `execute`.
67
+ * The dispatcher sets it to send a `tool/call` request. Left out, the tool's own `execute` runs.
68
+ */
69
+ readonly clientTool?: ClientToolRunner;
70
+ /**
71
+ * The conversation so far. Left out, it is rebuilt from the session's log, so a turn in any process goes on from
72
+ * what the log holds. Pass it only to run on a conversation the log doesn't hold.
73
+ */
74
+ readonly history?: readonly Message[];
75
+ /** The clock of the entries and the run, for a test that needs the same bytes twice. Default the system clock. */
76
+ readonly clock?: Clock;
77
+ /** Makes the ids of the entries and of the run, for a test that needs the same bytes twice. Default `crypto.randomUUID()`. */
78
+ readonly newId?: () => string;
79
+ }
80
+ /** What a turn returns: the SDK's result, and where the turn left the log. */
81
+ export type TurnResult = RunResult<unknown> & {
82
+ sessionKey: string;
83
+ lastEntryId: string;
84
+ };
85
+ type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
86
+ type Body = DistributiveOmit<EntryInput, "id" | "parentId" | "timestamp" | "origin">;
87
+ /**
88
+ * Writes what a new session starts with: its header when the path is empty, and its `env_stamp` when the path has
89
+ * none. `write` appends one entry after the ones before it.
90
+ */
91
+ export declare function recordSessionStart<H>(harness: Harness<H>, write: (origin: "harness", body: Body) => Promise<unknown>, model: Model, started: readonly SessionEntry[]): Promise<void>;
92
+ /** The run options a turn sets only when it has a value, so a missing one leaves the SDK's default. */
93
+ type RunSettings<H> = Pick<TurnOptions<H>, "clock" | "newId" | "hostContext" | "output" | "maxSteps" | "turnRetries" | "modelOptions" | "budgetUsd" | "onContextFill">;
94
+ /**
95
+ * Runs one turn on a session and writes it to the log. The session must be open with a lock. The first turn of a new
96
+ * session writes its header and `env_stamp`; a turn whose model or tools differ from the last recorded ones writes a
97
+ * `loadout` first; the input blocks follow, and the run's events after them. The returned result is the SDK's, with the
98
+ * session id and the id of the last entry the turn wrote. When the harness has a context policy and the run ends because
99
+ * the provider said the request was too large, the policy compacts once and the turn goes on from the rebuilt context;
100
+ * a second overflow ends the turn with that error.
101
+ */
102
+ export declare function runTurn<H = unknown>(session: Session, harness: Harness<H>, options: TurnOptions<H>): Promise<TurnResult>;
103
+ /**
104
+ * Re-runs from an entry: HEAD moves to `entryId` with a `checkout` entry, and a new turn follows it as a new branch of
105
+ * the same log. The entries of the branch it left stay as they were. The entry must not leave a tool call without its
106
+ * result, because that call never ran on the new branch.
107
+ */
108
+ export declare function rerunFrom<H = unknown>(session: Session, harness: Harness<H>, entryId: string, options: TurnOptions<H>): Promise<TurnResult>;
109
+ /** One `approval_resolved` entry as written: the answer, and what it covers beyond its own call. */
110
+ export interface ResolutionRecord {
111
+ readonly resolution: Resolution;
112
+ readonly sticky?: "run" | "session";
113
+ readonly allowance?: {
114
+ tool: string;
115
+ inputHash?: string;
116
+ commandPrefix?: string[];
117
+ policyVersion?: string;
118
+ };
119
+ readonly groupId?: string;
120
+ readonly quorum?: "pending";
121
+ }
122
+ /** What resuming a paused turn takes: the answers, and the same per-turn settings a turn has. */
123
+ export interface ResumeOptions<H = unknown> extends RunSettings<H> {
124
+ /** The answers the SDK checks and applies: one per request whose answer is settled. */
125
+ readonly resolutions: readonly Resolution[];
126
+ /**
127
+ * The `approval_resolved` entries to write before the run, with what each covers. Left out, each resolution is
128
+ * written as it is. A request a quorum still waits on has a record here and no resolution.
129
+ */
130
+ readonly records?: readonly ResolutionRecord[];
131
+ /**
132
+ * The caller's app data. A request bound to app data when it paused runs only when the resume passes the same value,
133
+ * so this is the caller's identity. The tools are the paused turn's, from the log. The model is the harness's, or
134
+ * `model`, and one that differs from the paused turn's is recorded as a `loadout`. Pass the turn's `maxSteps`,
135
+ * `output`, `turnRetries` and `modelOptions` again, because the log does not hold them.
136
+ */
137
+ readonly hostContext?: H;
138
+ /** The model the resumed turn runs on, in place of the harness's. */
139
+ readonly model?: Model;
140
+ /** Aborts the resumed turn. */
141
+ readonly signal?: AbortSignal;
142
+ /** Called with the resumed run as soon as it starts, so a caller can `steer()`, `followUp()` or abort it. */
143
+ readonly onRun?: (run: Run<unknown>) => void;
144
+ /** Observers for this resume alone, as `TurnOptions.observers`. */
145
+ readonly observers?: readonly Observer[];
146
+ /** Runs the calls of `client_request` tools, as `TurnOptions.clientTool`. */
147
+ readonly clientTool?: ClientToolRunner;
148
+ }
149
+ /**
150
+ * Resumes a paused turn from the log alone. The context, with its waiting requests, is rebuilt before anything is
151
+ * written; each resolution is then written as an `approval_resolved` entry, and `continueRun()` verifies the requests
152
+ * against the harness's signer. Each approved call goes through the permission pipeline again first, and a deny now
153
+ * turns the approval into a denial.
154
+ */
155
+ export declare function resumeTurn<H = unknown>(session: Session, harness: Harness<H>, options: ResumeOptions<H>): Promise<TurnResult>;
156
+ export {};