harnery 0.36.0 → 0.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (432) hide show
  1. package/dist/commander.d.ts +9 -0
  2. package/dist/commander.d.ts.map +1 -1
  3. package/dist/commander.js +10 -1
  4. package/dist/commands/admission.d.ts +21 -0
  5. package/dist/commands/admission.d.ts.map +1 -0
  6. package/dist/commands/admission.js +565 -0
  7. package/dist/commands/agents.d.ts +7 -0
  8. package/dist/commands/agents.d.ts.map +1 -1
  9. package/dist/commands/agents.js +148 -47
  10. package/dist/commands/artifacts.d.ts.map +1 -1
  11. package/dist/commands/artifacts.js +73 -2
  12. package/dist/commands/browse-ai.d.ts +2 -2
  13. package/dist/commands/browse-ai.d.ts.map +1 -1
  14. package/dist/commands/browse-ai.js +6 -4
  15. package/dist/commands/browse.d.ts.map +1 -1
  16. package/dist/commands/browse.js +360 -21
  17. package/dist/commands/diagnostics.d.ts +4 -0
  18. package/dist/commands/diagnostics.d.ts.map +1 -0
  19. package/dist/commands/diagnostics.js +229 -0
  20. package/dist/commands/fetch.js +1 -0
  21. package/dist/commands/files.d.ts +12 -0
  22. package/dist/commands/files.d.ts.map +1 -1
  23. package/dist/commands/files.js +54 -1
  24. package/dist/commands/governor.d.ts.map +1 -1
  25. package/dist/commands/governor.js +4 -0
  26. package/dist/commands/ledger-v3.d.ts.map +1 -1
  27. package/dist/commands/ledger-v3.js +71 -2
  28. package/dist/commands/qa-record.d.ts +144 -0
  29. package/dist/commands/qa-record.d.ts.map +1 -0
  30. package/dist/commands/qa-record.js +0 -0
  31. package/dist/commands/qa-run.d.ts +8 -0
  32. package/dist/commands/qa-run.d.ts.map +1 -0
  33. package/dist/commands/qa-run.js +396 -0
  34. package/dist/commands/qa-status.d.ts +71 -0
  35. package/dist/commands/qa-status.d.ts.map +1 -0
  36. package/dist/commands/qa-status.js +490 -0
  37. package/dist/commands/qa-verify.d.ts +40 -0
  38. package/dist/commands/qa-verify.d.ts.map +1 -0
  39. package/dist/commands/qa-verify.js +180 -0
  40. package/dist/commands/resources.d.ts +4 -0
  41. package/dist/commands/resources.d.ts.map +1 -0
  42. package/dist/commands/resources.js +29 -0
  43. package/dist/commands/review-pack.d.ts +4 -0
  44. package/dist/commands/review-pack.d.ts.map +1 -0
  45. package/dist/commands/review-pack.js +1001 -0
  46. package/dist/commands/supervisor.d.ts +4 -0
  47. package/dist/commands/supervisor.d.ts.map +1 -0
  48. package/dist/commands/supervisor.js +101 -0
  49. package/dist/commands/web.d.ts.map +1 -1
  50. package/dist/commands/web.js +17 -0
  51. package/dist/commands/workflow.d.ts.map +1 -1
  52. package/dist/commands/workflow.js +4 -0
  53. package/dist/core/agents/cli.js +7 -3
  54. package/dist/core/agents/health.d.ts +17 -0
  55. package/dist/core/agents/health.d.ts.map +1 -0
  56. package/dist/core/agents/health.js +109 -0
  57. package/dist/core/agents/mailbox.d.ts +92 -0
  58. package/dist/core/agents/mailbox.d.ts.map +1 -0
  59. package/dist/core/agents/mailbox.js +325 -0
  60. package/dist/core/agents/qa-signal.d.ts +111 -0
  61. package/dist/core/agents/qa-signal.d.ts.map +1 -0
  62. package/dist/core/agents/qa-signal.js +231 -0
  63. package/dist/core/agents/reconcile-coordination-v3.d.ts +44 -0
  64. package/dist/core/agents/reconcile-coordination-v3.d.ts.map +1 -0
  65. package/dist/core/agents/reconcile-coordination-v3.js +58 -0
  66. package/dist/core/agents/render/prompt-context.d.ts +5 -0
  67. package/dist/core/agents/render/prompt-context.d.ts.map +1 -1
  68. package/dist/core/agents/render/prompt-context.js +34 -13
  69. package/dist/core/agents/render/session-context.d.ts +8 -0
  70. package/dist/core/agents/render/session-context.d.ts.map +1 -1
  71. package/dist/core/agents/render/session-context.js +34 -3
  72. package/dist/core/agents/rules/commit-conflict.d.ts.map +1 -1
  73. package/dist/core/agents/rules/commit-conflict.js +50 -1
  74. package/dist/core/agents/rules/stop-hook.d.ts.map +1 -1
  75. package/dist/core/agents/rules/stop-hook.js +6 -10
  76. package/dist/core/agents/session-finalizer-v3.js +4 -1
  77. package/dist/core/agents/session-name-display.d.ts +20 -5
  78. package/dist/core/agents/session-name-display.d.ts.map +1 -1
  79. package/dist/core/agents/session-name-display.js +67 -7
  80. package/dist/core/agents/state/heartbeat-reader.d.ts +7 -0
  81. package/dist/core/agents/state/heartbeat-reader.d.ts.map +1 -1
  82. package/dist/core/agents/state/heartbeat-writer.d.ts +11 -0
  83. package/dist/core/agents/state/heartbeat-writer.d.ts.map +1 -1
  84. package/dist/core/agents/state/heartbeat-writer.js +17 -0
  85. package/dist/core/agents/state/live-coordination-view.d.ts.map +1 -1
  86. package/dist/core/agents/state/live-coordination-view.js +1 -0
  87. package/dist/core/agents/state/live-coordination-writer.js +5 -0
  88. package/dist/core/artifacts/constants.d.ts +1 -1
  89. package/dist/core/artifacts/constants.js +1 -1
  90. package/dist/core/artifacts/index.d.ts +82 -6
  91. package/dist/core/artifacts/index.d.ts.map +1 -1
  92. package/dist/core/artifacts/index.js +410 -15
  93. package/dist/core/config.d.ts +20 -0
  94. package/dist/core/config.d.ts.map +1 -1
  95. package/dist/core/config.js +59 -0
  96. package/dist/core/diagnostics/advice.d.ts +9 -0
  97. package/dist/core/diagnostics/advice.d.ts.map +1 -0
  98. package/dist/core/diagnostics/advice.js +112 -0
  99. package/dist/core/diagnostics/bundle.d.ts +51 -0
  100. package/dist/core/diagnostics/bundle.d.ts.map +1 -0
  101. package/dist/core/diagnostics/bundle.js +968 -0
  102. package/dist/core/diagnostics/comparison.d.ts +5 -0
  103. package/dist/core/diagnostics/comparison.d.ts.map +1 -0
  104. package/dist/core/diagnostics/comparison.js +444 -0
  105. package/dist/core/diagnostics/contract.d.ts +245 -0
  106. package/dist/core/diagnostics/contract.d.ts.map +1 -0
  107. package/dist/core/diagnostics/contract.js +18 -0
  108. package/dist/core/diagnostics/identity.d.ts +3 -0
  109. package/dist/core/diagnostics/identity.d.ts.map +1 -0
  110. package/dist/core/diagnostics/identity.js +10 -0
  111. package/dist/core/diagnostics/index.d.ts +8 -0
  112. package/dist/core/diagnostics/index.d.ts.map +1 -0
  113. package/dist/core/diagnostics/index.js +7 -0
  114. package/dist/core/diagnostics/replay.d.ts +8 -0
  115. package/dist/core/diagnostics/replay.d.ts.map +1 -0
  116. package/dist/core/diagnostics/replay.js +213 -0
  117. package/dist/core/diagnostics/sanitize.d.ts +9 -0
  118. package/dist/core/diagnostics/sanitize.d.ts.map +1 -0
  119. package/dist/core/diagnostics/sanitize.js +84 -0
  120. package/dist/core/events/legacy-storage/compression.d.ts +13 -0
  121. package/dist/core/events/legacy-storage/compression.d.ts.map +1 -0
  122. package/dist/core/events/legacy-storage/compression.js +107 -0
  123. package/dist/core/events/legacy-storage/index.d.ts +1 -0
  124. package/dist/core/events/legacy-storage/index.d.ts.map +1 -1
  125. package/dist/core/events/legacy-storage/index.js +1 -0
  126. package/dist/core/events/v3/archive-retention.d.ts +33 -0
  127. package/dist/core/events/v3/archive-retention.d.ts.map +1 -0
  128. package/dist/core/events/v3/archive-retention.js +195 -0
  129. package/dist/core/events/v3/bootstrap.d.ts.map +1 -1
  130. package/dist/core/events/v3/bootstrap.js +10 -0
  131. package/dist/core/events/v3/capabilities.d.ts +1 -1
  132. package/dist/core/events/v3/capabilities.d.ts.map +1 -1
  133. package/dist/core/events/v3/capabilities.js +1 -0
  134. package/dist/core/events/v3/coordination-view.d.ts +3 -0
  135. package/dist/core/events/v3/coordination-view.d.ts.map +1 -1
  136. package/dist/core/events/v3/coordination-view.js +69 -8
  137. package/dist/core/events/v3/index.d.ts +1 -0
  138. package/dist/core/events/v3/index.d.ts.map +1 -1
  139. package/dist/core/events/v3/index.js +1 -0
  140. package/dist/core/events/v3/live-routing.d.ts.map +1 -1
  141. package/dist/core/events/v3/live-routing.js +1 -0
  142. package/dist/core/events/v3/producers/hook-base.d.ts +1 -1
  143. package/dist/core/events/v3/producers/hook-base.d.ts.map +1 -1
  144. package/dist/core/events/v3/producers/hook-base.js +13 -2
  145. package/dist/core/events/v3/producers/intake.d.ts.map +1 -1
  146. package/dist/core/events/v3/producers/intake.js +10 -2
  147. package/dist/core/events/v3/producers/recorder.d.ts +39 -0
  148. package/dist/core/events/v3/producers/recorder.d.ts.map +1 -1
  149. package/dist/core/events/v3/producers/recorder.js +350 -17
  150. package/dist/core/hooks/adapter/output.d.ts +8 -0
  151. package/dist/core/hooks/adapter/output.d.ts.map +1 -1
  152. package/dist/core/hooks/adapter/output.js +11 -1
  153. package/dist/core/hooks/cli.js +303 -219
  154. package/dist/core/hooks/health.d.ts +59 -0
  155. package/dist/core/hooks/health.d.ts.map +1 -0
  156. package/dist/core/hooks/health.js +84 -0
  157. package/dist/core/hooks/resolve/transcript.d.ts.map +1 -1
  158. package/dist/core/hooks/resolve/transcript.js +10 -3
  159. package/dist/core/hooks/session-name-presence.d.ts.map +1 -1
  160. package/dist/core/hooks/session-name-presence.js +4 -1
  161. package/dist/core/qa-artifacts.d.ts +20 -0
  162. package/dist/core/qa-artifacts.d.ts.map +1 -0
  163. package/dist/core/qa-artifacts.js +110 -0
  164. package/dist/core/resources/contract.d.ts +96 -0
  165. package/dist/core/resources/contract.d.ts.map +1 -0
  166. package/dist/core/resources/contract.js +2 -0
  167. package/dist/core/resources/index.d.ts +6 -0
  168. package/dist/core/resources/index.d.ts.map +1 -0
  169. package/dist/core/resources/index.js +5 -0
  170. package/dist/core/resources/sampler.d.ts +34 -0
  171. package/dist/core/resources/sampler.d.ts.map +1 -0
  172. package/dist/core/resources/sampler.js +458 -0
  173. package/dist/core/resources/service-status.d.ts +3 -0
  174. package/dist/core/resources/service-status.d.ts.map +1 -0
  175. package/dist/core/resources/service-status.js +48 -0
  176. package/dist/core/resources/service.d.ts +26 -0
  177. package/dist/core/resources/service.d.ts.map +1 -0
  178. package/dist/core/resources/service.js +292 -0
  179. package/dist/core/resources/storage.d.ts +13 -0
  180. package/dist/core/resources/storage.d.ts.map +1 -0
  181. package/dist/core/resources/storage.js +30 -0
  182. package/dist/core/storage/atomic-json.d.ts +3 -0
  183. package/dist/core/storage/atomic-json.d.ts.map +1 -0
  184. package/dist/core/storage/atomic-json.js +15 -0
  185. package/dist/core/storage/builtins.d.ts.map +1 -1
  186. package/dist/core/storage/builtins.js +45 -6
  187. package/dist/core/storage/logger.d.ts +2 -0
  188. package/dist/core/storage/logger.d.ts.map +1 -1
  189. package/dist/core/storage/logger.js +2 -0
  190. package/dist/core/storage/query.d.ts +14 -0
  191. package/dist/core/storage/query.d.ts.map +1 -1
  192. package/dist/core/storage/query.js +51 -0
  193. package/dist/core/supervisor/activity.d.ts +4 -0
  194. package/dist/core/supervisor/activity.d.ts.map +1 -0
  195. package/dist/core/supervisor/activity.js +141 -0
  196. package/dist/core/supervisor/contract.d.ts +268 -0
  197. package/dist/core/supervisor/contract.d.ts.map +1 -0
  198. package/dist/core/supervisor/contract.js +35 -0
  199. package/dist/core/supervisor/explanations.d.ts +4 -0
  200. package/dist/core/supervisor/explanations.d.ts.map +1 -0
  201. package/dist/core/supervisor/explanations.js +71 -0
  202. package/dist/core/supervisor/findings.d.ts +20 -0
  203. package/dist/core/supervisor/findings.d.ts.map +1 -0
  204. package/dist/core/supervisor/findings.js +399 -0
  205. package/dist/core/supervisor/history.d.ts +9 -0
  206. package/dist/core/supervisor/history.d.ts.map +1 -0
  207. package/dist/core/supervisor/history.js +46 -0
  208. package/dist/core/supervisor/hook-health-alerts.d.ts +14 -0
  209. package/dist/core/supervisor/hook-health-alerts.d.ts.map +1 -0
  210. package/dist/core/supervisor/hook-health-alerts.js +70 -0
  211. package/dist/core/supervisor/hook-health-storage.d.ts +5 -0
  212. package/dist/core/supervisor/hook-health-storage.d.ts.map +1 -0
  213. package/dist/core/supervisor/hook-health-storage.js +24 -0
  214. package/dist/core/supervisor/hook-health.d.ts +72 -0
  215. package/dist/core/supervisor/hook-health.d.ts.map +1 -0
  216. package/dist/core/supervisor/hook-health.js +203 -0
  217. package/dist/core/supervisor/hooks.d.ts +10 -0
  218. package/dist/core/supervisor/hooks.d.ts.map +1 -0
  219. package/dist/core/supervisor/hooks.js +28 -0
  220. package/dist/core/supervisor/index.d.ts +15 -0
  221. package/dist/core/supervisor/index.d.ts.map +1 -0
  222. package/dist/core/supervisor/index.js +14 -0
  223. package/dist/core/supervisor/log-feed.d.ts +9 -0
  224. package/dist/core/supervisor/log-feed.d.ts.map +1 -0
  225. package/dist/core/supervisor/log-feed.js +103 -0
  226. package/dist/core/supervisor/service.d.ts +29 -0
  227. package/dist/core/supervisor/service.d.ts.map +1 -0
  228. package/dist/core/supervisor/service.js +450 -0
  229. package/dist/core/supervisor/services.d.ts +11 -0
  230. package/dist/core/supervisor/services.d.ts.map +1 -0
  231. package/dist/core/supervisor/services.js +155 -0
  232. package/dist/core/supervisor/status.d.ts +3 -0
  233. package/dist/core/supervisor/status.d.ts.map +1 -0
  234. package/dist/core/supervisor/status.js +48 -0
  235. package/dist/core/supervisor/storage.d.ts +30 -0
  236. package/dist/core/supervisor/storage.d.ts.map +1 -0
  237. package/dist/core/supervisor/storage.js +73 -0
  238. package/dist/core/supervisor/timeline.d.ts +3 -0
  239. package/dist/core/supervisor/timeline.d.ts.map +1 -0
  240. package/dist/core/supervisor/timeline.js +87 -0
  241. package/dist/core/workflow/admission.d.ts +23 -0
  242. package/dist/core/workflow/admission.d.ts.map +1 -0
  243. package/dist/core/workflow/admission.js +136 -0
  244. package/dist/core/workflow/engine.d.ts.map +1 -1
  245. package/dist/core/workflow/engine.js +77 -2
  246. package/dist/core/workflow/index.d.ts +3 -2
  247. package/dist/core/workflow/index.d.ts.map +1 -1
  248. package/dist/core/workflow/index.js +2 -1
  249. package/dist/core/workflow/proof.d.ts +2 -1
  250. package/dist/core/workflow/proof.d.ts.map +1 -1
  251. package/dist/core/workflow/proof.js +39 -1
  252. package/dist/core/workflow/run-state.d.ts +3 -2
  253. package/dist/core/workflow/run-state.d.ts.map +1 -1
  254. package/dist/core/workflow/run-state.js +8 -1
  255. package/dist/core/workflow/types.d.ts +33 -1
  256. package/dist/core/workflow/types.d.ts.map +1 -1
  257. package/dist/core/workflow/types.js +2 -1
  258. package/dist/lib/admission.d.ts +71 -0
  259. package/dist/lib/admission.d.ts.map +1 -0
  260. package/dist/lib/admission.js +264 -0
  261. package/dist/lib/agent-browser/client.d.ts +1 -1
  262. package/dist/lib/agent-browser/client.d.ts.map +1 -1
  263. package/dist/lib/agent-browser/client.js +1 -5
  264. package/dist/lib/browser/capture-fidelity.d.ts +39 -0
  265. package/dist/lib/browser/capture-fidelity.d.ts.map +1 -0
  266. package/dist/lib/browser/capture-fidelity.js +84 -0
  267. package/dist/lib/browser/client.d.ts +46 -1
  268. package/dist/lib/browser/client.d.ts.map +1 -1
  269. package/dist/lib/browser/client.js +168 -9
  270. package/dist/lib/browser/critique.d.ts +38 -1
  271. package/dist/lib/browser/critique.d.ts.map +1 -1
  272. package/dist/lib/browser/critique.js +34 -6
  273. package/dist/lib/browser/index.d.ts +5 -1
  274. package/dist/lib/browser/index.d.ts.map +1 -1
  275. package/dist/lib/browser/index.js +4 -0
  276. package/dist/lib/browser/page-review-judge.d.ts +64 -0
  277. package/dist/lib/browser/page-review-judge.d.ts.map +1 -0
  278. package/dist/lib/browser/page-review-judge.js +270 -0
  279. package/dist/lib/browser/page-review-pack.d.ts +613 -0
  280. package/dist/lib/browser/page-review-pack.d.ts.map +1 -0
  281. package/dist/lib/browser/page-review-pack.js +1751 -0
  282. package/dist/lib/browser/qa-run-contracts.d.ts +377 -0
  283. package/dist/lib/browser/qa-run-contracts.d.ts.map +1 -0
  284. package/dist/lib/browser/qa-run-contracts.js +361 -0
  285. package/dist/lib/browser/qa-run.d.ts +141 -0
  286. package/dist/lib/browser/qa-run.d.ts.map +1 -0
  287. package/dist/lib/browser/qa-run.js +1283 -0
  288. package/dist/lib/browser/request-diagnostics.d.ts +13 -0
  289. package/dist/lib/browser/request-diagnostics.d.ts.map +1 -0
  290. package/dist/lib/browser/request-diagnostics.js +18 -0
  291. package/dist/lib/browser/tiling.d.ts +19 -0
  292. package/dist/lib/browser/tiling.d.ts.map +1 -1
  293. package/dist/lib/browser/tiling.js +28 -0
  294. package/dist/lib/cookies/client.d.ts +9 -0
  295. package/dist/lib/cookies/client.d.ts.map +1 -1
  296. package/dist/lib/cookies/client.js +197 -44
  297. package/dist/lib/cookies/extra.d.ts +18 -0
  298. package/dist/lib/cookies/extra.d.ts.map +1 -0
  299. package/dist/lib/cookies/extra.js +14 -0
  300. package/dist/lib/cookies/index.d.ts +2 -1
  301. package/dist/lib/cookies/index.d.ts.map +1 -1
  302. package/dist/lib/cookies/index.js +2 -1
  303. package/dist/lib/coord-root-id.d.ts +9 -0
  304. package/dist/lib/coord-root-id.d.ts.map +1 -0
  305. package/dist/lib/coord-root-id.js +17 -0
  306. package/dist/lib/durable-job.d.ts +124 -0
  307. package/dist/lib/durable-job.d.ts.map +1 -0
  308. package/dist/lib/durable-job.js +296 -0
  309. package/dist/lib/http/client.d.ts +7 -1
  310. package/dist/lib/http/client.d.ts.map +1 -1
  311. package/dist/lib/http/client.js +2 -0
  312. package/dist/lib/instructions/apply.d.ts +3 -1
  313. package/dist/lib/instructions/apply.d.ts.map +1 -1
  314. package/dist/lib/instructions/apply.js +74 -3
  315. package/dist/lib/instructions/templates.d.ts.map +1 -1
  316. package/dist/lib/instructions/templates.js +11 -2
  317. package/package.json +19 -2
  318. package/src/commander.ts +75 -1
  319. package/src/commands/admission.ts +699 -0
  320. package/src/commands/agents.ts +189 -50
  321. package/src/commands/artifacts.ts +132 -18
  322. package/src/commands/browse-ai.ts +10 -5
  323. package/src/commands/browse.ts +496 -20
  324. package/src/commands/diagnostics.ts +271 -0
  325. package/src/commands/fetch.ts +1 -0
  326. package/src/commands/files.ts +102 -2
  327. package/src/commands/governor.ts +8 -0
  328. package/src/commands/ledger-v3.ts +82 -0
  329. package/src/commands/qa-record.ts +682 -0
  330. package/src/commands/qa-run.ts +503 -0
  331. package/src/commands/qa-status.ts +608 -0
  332. package/src/commands/qa-verify.ts +238 -0
  333. package/src/commands/resources.ts +38 -0
  334. package/src/commands/review-pack.ts +1281 -0
  335. package/src/commands/supervisor.ts +141 -0
  336. package/src/commands/web.ts +19 -0
  337. package/src/commands/workflow.ts +8 -0
  338. package/src/core/agents/cli.ts +7 -3
  339. package/src/core/agents/health.ts +142 -0
  340. package/src/core/agents/mailbox.ts +373 -0
  341. package/src/core/agents/qa-signal.ts +261 -0
  342. package/src/core/agents/reconcile-coordination-v3.ts +77 -0
  343. package/src/core/agents/render/prompt-context.ts +42 -12
  344. package/src/core/agents/render/session-context.ts +37 -3
  345. package/src/core/agents/rules/commit-conflict.ts +58 -1
  346. package/src/core/agents/rules/stop-hook.ts +6 -12
  347. package/src/core/agents/session-finalizer-v3.ts +4 -1
  348. package/src/core/agents/session-name-display.ts +78 -7
  349. package/src/core/agents/state/heartbeat-reader.ts +7 -0
  350. package/src/core/agents/state/heartbeat-writer.ts +23 -0
  351. package/src/core/agents/state/live-coordination-view.ts +1 -0
  352. package/src/core/agents/state/live-coordination-writer.ts +5 -0
  353. package/src/core/artifacts/constants.ts +1 -1
  354. package/src/core/artifacts/index.ts +565 -30
  355. package/src/core/config.ts +134 -2
  356. package/src/core/diagnostics/advice.ts +147 -0
  357. package/src/core/diagnostics/bundle.ts +1250 -0
  358. package/src/core/diagnostics/comparison.ts +565 -0
  359. package/src/core/diagnostics/contract.ts +311 -0
  360. package/src/core/diagnostics/identity.ts +11 -0
  361. package/src/core/diagnostics/index.ts +7 -0
  362. package/src/core/diagnostics/replay.ts +314 -0
  363. package/src/core/diagnostics/sanitize.ts +97 -0
  364. package/src/core/events/legacy-storage/compression.ts +130 -0
  365. package/src/core/events/legacy-storage/index.ts +1 -0
  366. package/src/core/events/v3/archive-retention.ts +251 -0
  367. package/src/core/events/v3/bootstrap.ts +10 -0
  368. package/src/core/events/v3/capabilities.ts +2 -0
  369. package/src/core/events/v3/coordination-view.ts +100 -11
  370. package/src/core/events/v3/index.ts +9 -0
  371. package/src/core/events/v3/live-routing.ts +1 -0
  372. package/src/core/events/v3/producers/hook-base.ts +14 -2
  373. package/src/core/events/v3/producers/intake.ts +10 -2
  374. package/src/core/events/v3/producers/recorder.ts +420 -17
  375. package/src/core/hooks/adapter/output.ts +12 -1
  376. package/src/core/hooks/cli.ts +332 -247
  377. package/src/core/hooks/health.ts +146 -0
  378. package/src/core/hooks/resolve/transcript.ts +10 -3
  379. package/src/core/hooks/session-name-presence.ts +6 -1
  380. package/src/core/qa-artifacts.ts +126 -0
  381. package/src/core/resources/contract.ts +105 -0
  382. package/src/core/resources/index.ts +5 -0
  383. package/src/core/resources/sampler.ts +590 -0
  384. package/src/core/resources/service-status.ts +62 -0
  385. package/src/core/resources/service.ts +337 -0
  386. package/src/core/resources/storage.ts +44 -0
  387. package/src/core/storage/atomic-json.ts +15 -0
  388. package/src/core/storage/builtins.ts +62 -6
  389. package/src/core/storage/logger.ts +2 -0
  390. package/src/core/storage/query.ts +58 -0
  391. package/src/core/supervisor/activity.ts +193 -0
  392. package/src/core/supervisor/contract.ts +312 -0
  393. package/src/core/supervisor/explanations.ts +104 -0
  394. package/src/core/supervisor/findings.ts +788 -0
  395. package/src/core/supervisor/history.ts +61 -0
  396. package/src/core/supervisor/hook-health-alerts.ts +108 -0
  397. package/src/core/supervisor/hook-health-storage.ts +25 -0
  398. package/src/core/supervisor/hook-health.ts +301 -0
  399. package/src/core/supervisor/hooks.ts +35 -0
  400. package/src/core/supervisor/index.ts +14 -0
  401. package/src/core/supervisor/log-feed.ts +131 -0
  402. package/src/core/supervisor/service.ts +511 -0
  403. package/src/core/supervisor/services.ts +203 -0
  404. package/src/core/supervisor/status.ts +59 -0
  405. package/src/core/supervisor/storage.ts +126 -0
  406. package/src/core/supervisor/timeline.ts +133 -0
  407. package/src/core/workflow/admission.ts +215 -0
  408. package/src/core/workflow/engine.ts +93 -1
  409. package/src/core/workflow/index.ts +10 -0
  410. package/src/core/workflow/proof.ts +54 -1
  411. package/src/core/workflow/run-state.ts +13 -1
  412. package/src/core/workflow/types.ts +39 -1
  413. package/src/lib/admission.ts +347 -0
  414. package/src/lib/agent-browser/client.ts +2 -10
  415. package/src/lib/browser/capture-fidelity.ts +98 -0
  416. package/src/lib/browser/client.ts +212 -10
  417. package/src/lib/browser/critique.ts +62 -7
  418. package/src/lib/browser/index.ts +65 -0
  419. package/src/lib/browser/page-review-judge.ts +360 -0
  420. package/src/lib/browser/page-review-pack.ts +2384 -0
  421. package/src/lib/browser/qa-run-contracts.ts +743 -0
  422. package/src/lib/browser/qa-run.ts +1462 -0
  423. package/src/lib/browser/request-diagnostics.ts +27 -0
  424. package/src/lib/browser/tiling.ts +32 -0
  425. package/src/lib/cookies/client.ts +228 -42
  426. package/src/lib/cookies/extra.ts +28 -0
  427. package/src/lib/cookies/index.ts +2 -0
  428. package/src/lib/coord-root-id.ts +23 -0
  429. package/src/lib/durable-job.ts +407 -0
  430. package/src/lib/http/client.ts +13 -1
  431. package/src/lib/instructions/apply.ts +81 -2
  432. package/src/lib/instructions/templates.ts +11 -2
@@ -0,0 +1,458 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { existsSync, readdirSync, readFileSync, readlinkSync } from "node:fs";
3
+ import { cpus, loadavg, platform, release } from "node:os";
4
+ import { basename, join } from "node:path";
5
+ import { performance } from "node:perf_hooks";
6
+ import { readLiveCoordinationRows } from "../agents/state/live-coordination-view.js";
7
+ import { parsePidmapRow } from "../agents/state/pidmap.js";
8
+ import { checkPidToken } from "../agents/state/proc-start.js";
9
+ import { RESOURCE_SNAPSHOT_SCHEMA_VERSION, } from "./contract.js";
10
+ const DEFAULT_CLOCK_TICKS = 100;
11
+ const DEFAULT_PAGE_SIZE = 4_096;
12
+ const DEFAULT_UNATTRIBUTED_CPU_FLOOR = 0.5;
13
+ const DEFAULT_UNATTRIBUTED_RSS_FLOOR = 64 * 1_024 * 1_024;
14
+ const DEFAULT_MAX_PROCESSES = 500;
15
+ const MAX_COMMAND_CHARS = 240;
16
+ let cachedClockTicks;
17
+ let cachedPageSize;
18
+ export function sampleResources(coordRoot, previous, options = {}) {
19
+ const started = performance.now();
20
+ const cpuBefore = process.cpuUsage();
21
+ const nowMs = options.nowMs ?? Date.now();
22
+ const currentPlatform = platform();
23
+ if (currentPlatform !== "linux") {
24
+ return {
25
+ snapshot: unsupportedSnapshot(currentPlatform, nowMs, started, cpuBefore),
26
+ };
27
+ }
28
+ const procRoot = options.procRoot ?? "/proc";
29
+ if (!existsSync(join(procRoot, "stat"))) {
30
+ return {
31
+ snapshot: unsupportedSnapshot(currentPlatform, nowMs, started, cpuBefore, "procfs_unavailable"),
32
+ };
33
+ }
34
+ const clockTicks = options.clockTicks ?? systemClockTicks();
35
+ const pageSize = options.pageSize ?? systemPageSize();
36
+ const uptimeSeconds = parseUptime(readFileSync(join(procRoot, "uptime"), "utf8"));
37
+ const cpu = parseLinuxCpu(readFileSync(join(procRoot, "stat"), "utf8"));
38
+ const memory = parseMeminfo(readFileSync(join(procRoot, "meminfo"), "utf8"));
39
+ const readings = readLinuxProcesses(procRoot, clockTicks, pageSize, uptimeSeconds);
40
+ const liveSessionOwners = uniqueLiveCodexSessionOwners(options.sessionOwners ??
41
+ readLiveCoordinationRows(coordRoot).map((row) => ({
42
+ nativeSessionId: row.native_session_id ?? "",
43
+ instanceId: row.instance_id,
44
+ platform: row.platform ?? "",
45
+ kind: row.kind ?? "",
46
+ })));
47
+ const ownership = readOwnershipAnchors(coordRoot, procRoot, readings, options.services ?? [], liveSessionOwners, previous?.process_owners);
48
+ const anchors = ownership.anchors;
49
+ const byPid = new Map(readings.map((reading) => [reading.pid, reading]));
50
+ const processTicks = new Map();
51
+ const intervalMs = previous ? Math.max(0, nowMs - previous.sampled_at_ms) : null;
52
+ const totalTickDelta = previous ? Math.max(0, cpu.total - previous.cpu_total_ticks) : 0;
53
+ const logicalCpus = Math.max(1, cpus().length);
54
+ const processes = readings.map((reading) => {
55
+ const identity = `${reading.pid}:${reading.startTicks}`;
56
+ processTicks.set(identity, reading.ticks);
57
+ const priorTicks = previous?.process_ticks.get(identity);
58
+ const processDelta = priorTicks === undefined ? undefined : Math.max(0, reading.ticks - priorTicks);
59
+ const cpuPercent = processDelta === undefined || totalTickDelta <= 0
60
+ ? null
61
+ : round1((processDelta / totalTickDelta) * logicalCpus * 100);
62
+ const ownership = resolveOwnership(reading.pid, byPid, anchors);
63
+ return {
64
+ pid: reading.pid,
65
+ ppid: reading.ppid,
66
+ start_id: identity,
67
+ state: reading.state,
68
+ name: reading.name,
69
+ command: reading.command,
70
+ cpu_percent: cpuPercent,
71
+ rss_bytes: reading.rssBytes,
72
+ age_seconds: round1(reading.ageSeconds),
73
+ owner_kind: ownership?.kind ?? "unattributed",
74
+ owner_id: ownership?.id ?? null,
75
+ owner_root_pid: ownership?.rootPid ?? null,
76
+ ...(ownership ? { owner_source: ownership.source } : {}),
77
+ };
78
+ });
79
+ const visible = processes
80
+ .filter((row) => row.owner_kind !== "unattributed" ||
81
+ (row.cpu_percent ?? 0) >=
82
+ (options.unattributedCpuFloor ?? DEFAULT_UNATTRIBUTED_CPU_FLOOR) ||
83
+ row.rss_bytes >= (options.unattributedRssFloor ?? DEFAULT_UNATTRIBUTED_RSS_FLOOR))
84
+ .sort(processSort)
85
+ .slice(0, options.maxProcesses ?? DEFAULT_MAX_PROCESSES);
86
+ const groups = aggregateGroups(visible);
87
+ const cpuPercent = previous && totalTickDelta > 0
88
+ ? round1(((totalTickDelta - Math.max(0, cpu.idle - previous.cpu_idle_ticks)) / totalTickDelta) *
89
+ 100)
90
+ : null;
91
+ const memoryTotal = memory.MemTotal ?? null;
92
+ const memoryAvailable = memory.MemAvailable ?? memory.MemFree ?? null;
93
+ const memoryUsed = memoryTotal !== null && memoryAvailable !== null
94
+ ? Math.max(0, memoryTotal - memoryAvailable)
95
+ : null;
96
+ const swapTotal = memory.SwapTotal ?? null;
97
+ const swapFree = memory.SwapFree ?? null;
98
+ const swapUsed = swapTotal !== null && swapFree !== null ? Math.max(0, swapTotal - swapFree) : null;
99
+ const collectorCpu = process.cpuUsage(cpuBefore);
100
+ const snapshot = {
101
+ schema_version: RESOURCE_SNAPSHOT_SCHEMA_VERSION,
102
+ sampled_at: new Date(nowMs).toISOString(),
103
+ interval_ms: intervalMs,
104
+ sample_duration_ms: round1(performance.now() - started),
105
+ collector_cpu_ms: round1((collectorCpu.user + collectorCpu.system) / 1_000),
106
+ platform: currentPlatform,
107
+ namespace: /microsoft|wsl/i.test(release()) ? "wsl" : "host",
108
+ support: { state: "supported", sampler: "procfs" },
109
+ machine: {
110
+ cpu_percent: cpuPercent,
111
+ cpu_logical_count: logicalCpus,
112
+ load_average: loadavg(),
113
+ memory_total_bytes: memoryTotal,
114
+ memory_available_bytes: memoryAvailable,
115
+ memory_used_bytes: memoryUsed,
116
+ memory_percent: memoryUsed !== null && memoryTotal ? round1((memoryUsed / memoryTotal) * 100) : null,
117
+ swap_total_bytes: swapTotal,
118
+ swap_used_bytes: swapUsed,
119
+ process_count: readings.length,
120
+ },
121
+ groups,
122
+ processes: visible,
123
+ visible_process_count: visible.length,
124
+ omitted_process_count: Math.max(0, readings.length - visible.length),
125
+ unattributed_process_count: visible.filter((row) => row.owner_kind === "unattributed").length,
126
+ };
127
+ return {
128
+ snapshot,
129
+ state: {
130
+ sampled_at_ms: nowMs,
131
+ cpu_total_ticks: cpu.total,
132
+ cpu_idle_ticks: cpu.idle,
133
+ process_ticks: processTicks,
134
+ process_owners: ownership.processOwners,
135
+ },
136
+ };
137
+ }
138
+ export function parseLinuxProcessStat(line) {
139
+ const open = line.indexOf("(");
140
+ const close = line.lastIndexOf(")");
141
+ if (open <= 0 || close <= open)
142
+ return null;
143
+ const pid = Number(line.slice(0, open).trim());
144
+ const fields = line
145
+ .slice(close + 1)
146
+ .trim()
147
+ .split(/\s+/);
148
+ const state = fields[0] ?? "?";
149
+ const ppid = Number(fields[1]);
150
+ const userTicks = Number(fields[11]);
151
+ const systemTicks = Number(fields[12]);
152
+ const startTicks = Number(fields[19]);
153
+ const rssPages = Number(fields[21]);
154
+ if (![pid, ppid, userTicks, systemTicks, startTicks, rssPages].every(Number.isFinite))
155
+ return null;
156
+ return {
157
+ pid,
158
+ name: line.slice(open + 1, close),
159
+ state,
160
+ ppid,
161
+ ticks: userTicks + systemTicks,
162
+ startTicks,
163
+ rssPages: Math.max(0, rssPages),
164
+ };
165
+ }
166
+ export function redactCommand(args) {
167
+ const secretName = /(?:^|[-_])(token|secret|password|passwd|api[-_]?key|authorization)(?:$|[-_])/i;
168
+ const output = [];
169
+ let redactNext = false;
170
+ for (const raw of args) {
171
+ let value = raw;
172
+ if (redactNext) {
173
+ output.push("<redacted>");
174
+ redactNext = false;
175
+ continue;
176
+ }
177
+ const equals = value.indexOf("=");
178
+ if (equals > 0 && secretName.test(value.slice(0, equals))) {
179
+ value = `${value.slice(0, equals + 1)}<redacted>`;
180
+ }
181
+ else if (secretName.test(value.replace(/^--?/, ""))) {
182
+ redactNext = true;
183
+ }
184
+ value = value.replace(/(https?:\/\/)[^:@\s/]+:[^@\s/]+@/gi, "$1<redacted>@");
185
+ output.push(value.replace(/[\r\n\t]+/g, " "));
186
+ }
187
+ const joined = output.join(" ").trim();
188
+ return joined.length <= MAX_COMMAND_CHARS ? joined : `${joined.slice(0, MAX_COMMAND_CHARS - 1)}…`;
189
+ }
190
+ function readLinuxProcesses(procRoot, clockTicks, pageSize, uptimeSeconds) {
191
+ const rows = [];
192
+ for (const entry of readdirSync(procRoot, { withFileTypes: true })) {
193
+ if (!entry.isDirectory() || !/^\d+$/.test(entry.name))
194
+ continue;
195
+ const pidRoot = join(procRoot, entry.name);
196
+ try {
197
+ const parsed = parseLinuxProcessStat(readFileSync(join(pidRoot, "stat"), "utf8"));
198
+ if (!parsed)
199
+ continue;
200
+ const args = readFileSync(join(pidRoot, "cmdline"), "utf8").split("\0").filter(Boolean);
201
+ let name = parsed.name;
202
+ try {
203
+ name = basename(readlinkSync(join(pidRoot, "exe"))) || name;
204
+ }
205
+ catch {
206
+ // Kernel threads and racing processes may have no readable executable.
207
+ }
208
+ rows.push({
209
+ pid: parsed.pid,
210
+ ppid: parsed.ppid,
211
+ state: parsed.state,
212
+ name,
213
+ command: redactCommand(args.length > 0 ? args : [parsed.name]),
214
+ ticks: parsed.ticks,
215
+ startTicks: parsed.startTicks,
216
+ rssBytes: parsed.rssPages * pageSize,
217
+ ageSeconds: Math.max(0, uptimeSeconds - parsed.startTicks / clockTicks),
218
+ });
219
+ }
220
+ catch {
221
+ // Process exits and permission boundaries are normal during a table scan.
222
+ }
223
+ }
224
+ return rows;
225
+ }
226
+ function readOwnershipAnchors(coordRoot, procRoot, readings, services, liveSessionOwners, previousOwners) {
227
+ const byPid = new Set(readings.map((row) => row.pid));
228
+ const directory = join(coordRoot, ".harnery", "pid-map");
229
+ const anchors = new Map();
230
+ if (existsSync(directory)) {
231
+ for (const entry of readdirSync(directory)) {
232
+ if (!/^\d+$/.test(entry))
233
+ continue;
234
+ const pid = Number(entry);
235
+ if (!byPid.has(pid))
236
+ continue;
237
+ try {
238
+ const row = parsePidmapRow(readFileSync(join(directory, entry), "utf8"));
239
+ if (!row.instanceId || checkPidToken(pid, row.startToken) === "mismatch")
240
+ continue;
241
+ anchors.set(pid, { kind: "agent", id: row.instanceId, source: "pid-map" });
242
+ }
243
+ catch {
244
+ // An unreadable or racing row cannot prove ownership.
245
+ }
246
+ }
247
+ }
248
+ const processOwners = readBridgeProcessOwners(procRoot, readings, liveSessionOwners, previousOwners);
249
+ const byReadingPid = new Map(readings.map((row) => [row.pid, row]));
250
+ for (const reading of readings) {
251
+ const identity = `${reading.pid}:${reading.startTicks}`;
252
+ const owner = processOwners.get(identity);
253
+ if (!owner || anchors.has(reading.pid))
254
+ continue;
255
+ const parent = byReadingPid.get(reading.ppid);
256
+ const parentOwner = parent
257
+ ? processOwners.get(`${parent.pid}:${parent.startTicks}`)
258
+ : undefined;
259
+ if (parentOwner?.instance_id === owner.instance_id)
260
+ continue;
261
+ anchors.set(reading.pid, {
262
+ kind: "agent",
263
+ id: owner.instance_id,
264
+ source: "session-environment",
265
+ });
266
+ }
267
+ for (const service of services) {
268
+ if (byPid.has(service.pid) && service.id.trim()) {
269
+ anchors.set(service.pid, { kind: "service", id: service.id.trim(), source: "service" });
270
+ }
271
+ }
272
+ return { anchors, processOwners };
273
+ }
274
+ function uniqueLiveCodexSessionOwners(rows) {
275
+ const candidates = new Map();
276
+ for (const row of rows) {
277
+ const sessionId = row.nativeSessionId.trim();
278
+ const instanceId = row.instanceId.trim();
279
+ if (row.platform !== "codex" || row.kind !== "session" || !sessionId || !instanceId)
280
+ continue;
281
+ const owners = candidates.get(sessionId) ?? new Set();
282
+ owners.add(instanceId);
283
+ candidates.set(sessionId, owners);
284
+ }
285
+ const result = new Map();
286
+ for (const [sessionId, owners] of candidates) {
287
+ if (owners.size === 1)
288
+ result.set(sessionId, [...owners][0]);
289
+ }
290
+ return result;
291
+ }
292
+ function readBridgeProcessOwners(procRoot, readings, liveSessionOwners, previousOwners) {
293
+ const result = new Map();
294
+ if (liveSessionOwners.size === 0)
295
+ return result;
296
+ for (const reading of readings) {
297
+ const identity = `${reading.pid}:${reading.startTicks}`;
298
+ const previous = previousOwners?.get(identity);
299
+ if (previous && liveSessionOwners.get(previous.session_id) === previous.instance_id) {
300
+ result.set(identity, previous);
301
+ continue;
302
+ }
303
+ const sessionId = readCodexWslBridgeSessionId(procRoot, reading.pid);
304
+ if (!sessionId)
305
+ continue;
306
+ const instanceId = liveSessionOwners.get(sessionId);
307
+ if (instanceId)
308
+ result.set(identity, { session_id: sessionId, instance_id: instanceId });
309
+ }
310
+ return result;
311
+ }
312
+ function readCodexWslBridgeSessionId(procRoot, pid) {
313
+ try {
314
+ const entries = readFileSync(join(procRoot, String(pid), "environ"), "utf8").split("\0");
315
+ let bridge;
316
+ let platform;
317
+ let coordinationSessionId;
318
+ let codexThreadId;
319
+ for (const entry of entries) {
320
+ if (entry.startsWith("HARNERY_AGENT_COORD_BRIDGE=")) {
321
+ bridge = entry.slice("HARNERY_AGENT_COORD_BRIDGE=".length);
322
+ }
323
+ else if (entry.startsWith("HARNERY_AGENT_COORD_PLATFORM=")) {
324
+ platform = entry.slice("HARNERY_AGENT_COORD_PLATFORM=".length);
325
+ }
326
+ else if (entry.startsWith("HARNERY_AGENT_COORD_SESSION_ID=")) {
327
+ coordinationSessionId = entry.slice("HARNERY_AGENT_COORD_SESSION_ID=".length);
328
+ }
329
+ else if (entry.startsWith("CODEX_THREAD_ID=")) {
330
+ codexThreadId = entry.slice("CODEX_THREAD_ID=".length);
331
+ }
332
+ }
333
+ if (bridge === "codex-wsl" &&
334
+ platform === "codex" &&
335
+ coordinationSessionId &&
336
+ coordinationSessionId === codexThreadId) {
337
+ return coordinationSessionId;
338
+ }
339
+ }
340
+ catch {
341
+ // An unreadable or racing environment cannot prove ownership.
342
+ }
343
+ return undefined;
344
+ }
345
+ function resolveOwnership(pid, byPid, anchors) {
346
+ const seen = new Set();
347
+ let cursor = pid;
348
+ for (let hops = 0; hops < 64 && cursor > 0 && !seen.has(cursor); hops++) {
349
+ seen.add(cursor);
350
+ const owner = anchors.get(cursor);
351
+ if (owner)
352
+ return { ...owner, rootPid: cursor };
353
+ cursor = byPid.get(cursor)?.ppid ?? 0;
354
+ }
355
+ return undefined;
356
+ }
357
+ function aggregateGroups(processes) {
358
+ const groups = new Map();
359
+ for (const row of processes) {
360
+ const id = row.owner_id ?? "unattributed";
361
+ const key = `${row.owner_kind}:${id}`;
362
+ const group = groups.get(key) ?? {
363
+ kind: row.owner_kind,
364
+ id,
365
+ process_count: 0,
366
+ cpu_percent: null,
367
+ rss_bytes: 0,
368
+ root_pids: [],
369
+ };
370
+ group.process_count += 1;
371
+ group.rss_bytes += row.rss_bytes;
372
+ if (row.cpu_percent !== null)
373
+ group.cpu_percent = round1((group.cpu_percent ?? 0) + row.cpu_percent);
374
+ if (row.owner_root_pid !== null && !group.root_pids.includes(row.owner_root_pid)) {
375
+ group.root_pids.push(row.owner_root_pid);
376
+ }
377
+ groups.set(key, group);
378
+ }
379
+ return [...groups.values()].sort((left, right) => (right.cpu_percent ?? -1) - (left.cpu_percent ?? -1) ||
380
+ right.rss_bytes - left.rss_bytes ||
381
+ left.id.localeCompare(right.id));
382
+ }
383
+ function processSort(left, right) {
384
+ return ((right.cpu_percent ?? -1) - (left.cpu_percent ?? -1) ||
385
+ right.rss_bytes - left.rss_bytes ||
386
+ left.pid - right.pid);
387
+ }
388
+ function parseLinuxCpu(content) {
389
+ const fields = content.split("\n")[0]?.trim().split(/\s+/).slice(1).map(Number) ?? [];
390
+ if (fields.length < 4 || fields.some((value) => !Number.isFinite(value))) {
391
+ throw new Error("procfs_cpu_invalid");
392
+ }
393
+ return {
394
+ total: fields.reduce((sum, value) => sum + value, 0),
395
+ idle: (fields[3] ?? 0) + (fields[4] ?? 0),
396
+ };
397
+ }
398
+ function parseMeminfo(content) {
399
+ const result = {};
400
+ for (const line of content.split("\n")) {
401
+ const match = /^([A-Za-z_()]+):\s+(\d+)\s+kB$/.exec(line.trim());
402
+ if (match)
403
+ result[match[1]] = Number(match[2]) * 1_024;
404
+ }
405
+ return result;
406
+ }
407
+ function parseUptime(content) {
408
+ const value = Number(content.trim().split(/\s+/, 1)[0]);
409
+ if (!Number.isFinite(value) || value < 0)
410
+ throw new Error("procfs_uptime_invalid");
411
+ return value;
412
+ }
413
+ function systemClockTicks() {
414
+ cachedClockTicks ??= positiveGetconf("CLK_TCK", DEFAULT_CLOCK_TICKS);
415
+ return cachedClockTicks;
416
+ }
417
+ function systemPageSize() {
418
+ cachedPageSize ??= positiveGetconf("PAGESIZE", DEFAULT_PAGE_SIZE);
419
+ return cachedPageSize;
420
+ }
421
+ function positiveGetconf(key, fallback) {
422
+ const result = spawnSync("getconf", [key], { encoding: "utf8", timeout: 1_000 });
423
+ const value = result.status === 0 ? Number(result.stdout.trim()) : Number.NaN;
424
+ return Number.isFinite(value) && value > 0 ? value : fallback;
425
+ }
426
+ function unsupportedSnapshot(currentPlatform, nowMs, started, cpuBefore, reason = "platform_unsupported") {
427
+ const collectorCpu = process.cpuUsage(cpuBefore);
428
+ return {
429
+ schema_version: RESOURCE_SNAPSHOT_SCHEMA_VERSION,
430
+ sampled_at: new Date(nowMs).toISOString(),
431
+ interval_ms: null,
432
+ sample_duration_ms: round1(performance.now() - started),
433
+ collector_cpu_ms: round1((collectorCpu.user + collectorCpu.system) / 1_000),
434
+ platform: currentPlatform,
435
+ namespace: "unknown",
436
+ support: { state: "unsupported", sampler: "unsupported", reason },
437
+ machine: {
438
+ cpu_percent: null,
439
+ cpu_logical_count: cpus().length,
440
+ load_average: null,
441
+ memory_total_bytes: null,
442
+ memory_available_bytes: null,
443
+ memory_used_bytes: null,
444
+ memory_percent: null,
445
+ swap_total_bytes: null,
446
+ swap_used_bytes: null,
447
+ process_count: 0,
448
+ },
449
+ groups: [],
450
+ processes: [],
451
+ visible_process_count: 0,
452
+ omitted_process_count: 0,
453
+ unattributed_process_count: 0,
454
+ };
455
+ }
456
+ function round1(value) {
457
+ return Math.round(value * 10) / 10;
458
+ }
@@ -0,0 +1,3 @@
1
+ import { type ResourceServiceStatus } from "./contract.js";
2
+ export declare function readResourceServiceStatus(coordRoot: string, nowMs?: number): ResourceServiceStatus;
3
+ //# sourceMappingURL=service-status.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service-status.d.ts","sourceRoot":"","sources":["../../../src/core/resources/service-status.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,eAAe,CAAC;AAKvB,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,KAAK,SAAa,GACjB,qBAAqB,CA0BvB"}
@@ -0,0 +1,48 @@
1
+ import { hostname } from "node:os";
2
+ import { checkPidToken } from "../agents/state/proc-start.js";
3
+ import { RESOURCE_SERVICE_STATUS_SCHEMA_VERSION, } from "./contract.js";
4
+ import { readResourceServiceRecord, resourcePaths } from "./storage.js";
5
+ const STALE_HEARTBEAT_MS = 15_000;
6
+ export function readResourceServiceStatus(coordRoot, nowMs = Date.now()) {
7
+ const paths = resourcePaths(coordRoot);
8
+ const record = readResourceServiceRecord(coordRoot);
9
+ if (!validRecord(record)) {
10
+ return {
11
+ running: false,
12
+ stale: false,
13
+ status_path: paths.service,
14
+ snapshot_path: paths.snapshot,
15
+ };
16
+ }
17
+ const heartbeatAt = Date.parse(record.heartbeat_at);
18
+ const stale = !Number.isFinite(heartbeatAt) || nowMs - heartbeatAt > STALE_HEARTBEAT_MS;
19
+ const local = record.host === hostname();
20
+ const running = local &&
21
+ !stale &&
22
+ (record.state === "starting" || record.state === "running" || record.state === "stopping") &&
23
+ pidStillMatches(record.pid, record.start_token);
24
+ return {
25
+ running,
26
+ stale,
27
+ record,
28
+ status_path: paths.service,
29
+ snapshot_path: paths.snapshot,
30
+ };
31
+ }
32
+ function validRecord(value) {
33
+ return (value?.schema_version === RESOURCE_SERVICE_STATUS_SCHEMA_VERSION &&
34
+ Number.isInteger(value.pid) &&
35
+ value.pid > 0 &&
36
+ typeof value.host === "string" &&
37
+ typeof value.heartbeat_at === "string");
38
+ }
39
+ function pidStillMatches(pid, startToken) {
40
+ try {
41
+ process.kill(pid, 0);
42
+ }
43
+ catch (error) {
44
+ if (error.code !== "EPERM")
45
+ return false;
46
+ }
47
+ return checkPidToken(pid, startToken) !== "mismatch";
48
+ }
@@ -0,0 +1,26 @@
1
+ import { type ResourceServiceStatus, type ResourceServiceStatusRecord } from "./contract.js";
2
+ import { sampleResources } from "./sampler.js";
3
+ export declare const RESOURCE_SERVICE_DEFAULT_INTERVAL_MS = 2000;
4
+ export interface RunResourceServiceInput {
5
+ coordRoot: string;
6
+ intervalMs?: number;
7
+ maxSamples?: number;
8
+ now?: () => Date;
9
+ sample?: typeof sampleResources;
10
+ wait?: (milliseconds: number) => Promise<void>;
11
+ }
12
+ export type EnsureResourceServiceResult = {
13
+ state: "running" | "started";
14
+ status: ResourceServiceStatus;
15
+ } | {
16
+ state: "unsupported" | "unavailable";
17
+ status: ResourceServiceStatus;
18
+ error: string;
19
+ };
20
+ export declare function spawnResourceService(coordRootRaw: string, options?: {
21
+ intervalMs?: number;
22
+ }): Promise<ResourceServiceStatus>;
23
+ export declare function ensureResourceServiceRunning(coordRoot: string): Promise<EnsureResourceServiceResult>;
24
+ export declare function requestResourceServiceStop(coordRootRaw: string): ResourceServiceStatus;
25
+ export declare function runResourceService(input: RunResourceServiceInput): Promise<ResourceServiceStatusRecord>;
26
+ //# sourceMappingURL=service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/core/resources/service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EACjC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAI/C,eAAO,MAAM,oCAAoC,OAAQ,CAAC;AAY1D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,eAAe,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,2BAA2B,GACnC;IAAE,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC/D;IAAE,KAAK,EAAE,aAAa,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,OAAO,CAAC,qBAAqB,CAAC,CAwChC;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,2BAA2B,CAAC,CAoBtC;AAED,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAiBtF;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,2BAA2B,CAAC,CAwFtC"}