@jinn-network/client 0.1.8 → 0.1.9-canary.02befda9

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 (537) hide show
  1. package/README.md +6 -0
  2. package/deployments/deployment-phase1b-mech-baseSepolia-fast.json +3 -3
  3. package/deployments/deployment-stolas-l2-baseSepolia-fast.json +23 -3
  4. package/deployments/deployment-task-coordinator-router-v3-baseSepolia-fast.json +34 -6
  5. package/dist/adapters/mech/adapter.d.ts +21 -1
  6. package/dist/adapters/mech/adapter.js +107 -52
  7. package/dist/adapters/mech/adapter.js.map +1 -1
  8. package/dist/adapters/mech/contracts.d.ts +174 -13
  9. package/dist/adapters/mech/contracts.js +99 -49
  10. package/dist/adapters/mech/contracts.js.map +1 -1
  11. package/dist/adapters/mech/safe-revert.d.ts +4 -0
  12. package/dist/adapters/mech/safe-revert.js +5 -1
  13. package/dist/adapters/mech/safe-revert.js.map +1 -1
  14. package/dist/adapters/mech/safe.js +77 -1
  15. package/dist/adapters/mech/safe.js.map +1 -1
  16. package/dist/adapters/mech/types.d.ts +4 -42
  17. package/dist/adapters/mech/types.js +8 -20
  18. package/dist/adapters/mech/types.js.map +1 -1
  19. package/dist/adapters/mech/verdict-code.js +1 -1
  20. package/dist/adapters/mech/verdict-code.js.map +1 -1
  21. package/dist/api/bootstrap-endpoint.d.ts +1 -0
  22. package/dist/api/bootstrap-endpoint.js +1 -0
  23. package/dist/api/bootstrap-endpoint.js.map +1 -1
  24. package/dist/api/discovery-endpoint.d.ts +1 -0
  25. package/dist/api/discovery-endpoint.js +24 -0
  26. package/dist/api/discovery-endpoint.js.map +1 -1
  27. package/dist/api/fleet-build.d.ts +1 -7
  28. package/dist/api/fleet-build.js +0 -7
  29. package/dist/api/fleet-build.js.map +1 -1
  30. package/dist/api/gather-status.d.ts +26 -17
  31. package/dist/api/gather-status.js +57 -516
  32. package/dist/api/gather-status.js.map +1 -1
  33. package/dist/api/harness-auth-status-endpoint.d.ts +21 -0
  34. package/dist/api/harness-auth-status-endpoint.js +17 -0
  35. package/dist/api/harness-auth-status-endpoint.js.map +1 -0
  36. package/dist/api/loop-completion-build.d.ts +79 -0
  37. package/dist/api/loop-completion-build.js +155 -0
  38. package/dist/api/loop-completion-build.js.map +1 -0
  39. package/dist/api/operator-artifacts-endpoint.js +1 -1
  40. package/dist/api/operator-artifacts-endpoint.js.map +1 -1
  41. package/dist/api/peers.js +2 -0
  42. package/dist/api/peers.js.map +1 -1
  43. package/dist/api/rewards-build.d.ts +8 -1
  44. package/dist/api/rewards-build.js +32 -4
  45. package/dist/api/rewards-build.js.map +1 -1
  46. package/dist/api/rewards-endpoint.d.ts +12 -0
  47. package/dist/api/rewards-endpoint.js +46 -0
  48. package/dist/api/rewards-endpoint.js.map +1 -0
  49. package/dist/api/server.d.ts +6 -16
  50. package/dist/api/server.js +29 -26
  51. package/dist/api/server.js.map +1 -1
  52. package/dist/api/setup-endpoints.d.ts +41 -0
  53. package/dist/api/setup-endpoints.js +258 -45
  54. package/dist/api/setup-endpoints.js.map +1 -1
  55. package/dist/api/solvernets-endpoints.js +4 -1
  56. package/dist/api/solvernets-endpoints.js.map +1 -1
  57. package/dist/api/status-build.d.ts +71 -94
  58. package/dist/api/status-build.js +11 -77
  59. package/dist/api/status-build.js.map +1 -1
  60. package/dist/api/status-rollup-build.d.ts +0 -4
  61. package/dist/api/status-rollup-build.js +0 -4
  62. package/dist/api/status-rollup-build.js.map +1 -1
  63. package/dist/api/stop-hook.d.ts +1 -1
  64. package/dist/api/stop-hook.js +1 -1
  65. package/dist/api/stop-hook.js.map +1 -1
  66. package/dist/build-info.json +4 -4
  67. package/dist/build-meta.json +1 -1
  68. package/dist/captures/live-publisher.d.ts +9 -0
  69. package/dist/captures/live-publisher.js +1 -0
  70. package/dist/captures/live-publisher.js.map +1 -1
  71. package/dist/captures/publish.d.ts +11 -0
  72. package/dist/captures/publish.js +15 -5
  73. package/dist/captures/publish.js.map +1 -1
  74. package/dist/cli/commands/codedigest-revert-check.js +6 -2
  75. package/dist/cli/commands/codedigest-revert-check.js.map +1 -1
  76. package/dist/cli/commands/doctor.d.ts +3 -0
  77. package/dist/cli/commands/doctor.js +36 -4
  78. package/dist/cli/commands/doctor.js.map +1 -1
  79. package/dist/cli/commands/eval.d.ts +87 -0
  80. package/dist/cli/commands/eval.js +481 -0
  81. package/dist/cli/commands/eval.js.map +1 -0
  82. package/dist/cli/commands/rewards.d.ts +2 -0
  83. package/dist/cli/commands/rewards.js +39 -10
  84. package/dist/cli/commands/rewards.js.map +1 -1
  85. package/dist/cli/commands/solver-nets.js +68 -0
  86. package/dist/cli/commands/solver-nets.js.map +1 -1
  87. package/dist/cli/commands/status.js +0 -1
  88. package/dist/cli/commands/status.js.map +1 -1
  89. package/dist/cli/commands/update.js +8 -0
  90. package/dist/cli/commands/update.js.map +1 -1
  91. package/dist/cli/commands/version.js +4 -0
  92. package/dist/cli/commands/version.js.map +1 -1
  93. package/dist/cli/index.js +2 -0
  94. package/dist/cli/index.js.map +1 -1
  95. package/dist/cli/introspection-context.js +0 -3
  96. package/dist/cli/introspection-context.js.map +1 -1
  97. package/dist/config.d.ts +158 -541
  98. package/dist/config.js +189 -196
  99. package/dist/config.js.map +1 -1
  100. package/dist/corpus/acquire.d.ts +7 -6
  101. package/dist/corpus/acquire.js +10 -10
  102. package/dist/corpus/acquire.js.map +1 -1
  103. package/dist/corpus/fetch-artifact.d.ts +21 -0
  104. package/dist/corpus/fetch-artifact.js +33 -0
  105. package/dist/corpus/fetch-artifact.js.map +1 -0
  106. package/dist/corpus/index.d.ts +2 -2
  107. package/dist/corpus/route-resolver.d.ts +3 -3
  108. package/dist/corpus/route-resolver.js +3 -3
  109. package/dist/daemon/ai-units-gate.d.ts +6 -6
  110. package/dist/daemon/ai-units-gate.js +11 -10
  111. package/dist/daemon/ai-units-gate.js.map +1 -1
  112. package/dist/daemon/balance-topup-loop.js +3 -0
  113. package/dist/daemon/balance-topup-loop.js.map +1 -1
  114. package/dist/daemon/checkpoint-loop.js +2 -2
  115. package/dist/daemon/creator.d.ts +1 -0
  116. package/dist/daemon/creator.js +26 -14
  117. package/dist/daemon/creator.js.map +1 -1
  118. package/dist/daemon/daemon.d.ts +15 -10
  119. package/dist/daemon/daemon.js +71 -39
  120. package/dist/daemon/daemon.js.map +1 -1
  121. package/dist/daemon/delivery-watcher.d.ts +9 -0
  122. package/dist/daemon/delivery-watcher.js +24 -1
  123. package/dist/daemon/delivery-watcher.js.map +1 -1
  124. package/dist/daemon/eviction-loop.d.ts +7 -0
  125. package/dist/daemon/eviction-loop.js +19 -3
  126. package/dist/daemon/eviction-loop.js.map +1 -1
  127. package/dist/daemon/join-applier.d.ts +35 -0
  128. package/dist/daemon/join-applier.js +49 -0
  129. package/dist/daemon/join-applier.js.map +1 -0
  130. package/dist/daemon/loop-heartbeat.d.ts +34 -0
  131. package/dist/daemon/loop-heartbeat.js +38 -0
  132. package/dist/daemon/loop-heartbeat.js.map +1 -0
  133. package/dist/daemon/reward-claim-loop.js +4 -1
  134. package/dist/daemon/reward-claim-loop.js.map +1 -1
  135. package/dist/daemon/skip-log-dedup.d.ts +1 -1
  136. package/dist/daemon/skip-log-dedup.js +3 -0
  137. package/dist/daemon/skip-log-dedup.js.map +1 -1
  138. package/dist/daemon/watchdog-loop.d.ts +84 -0
  139. package/dist/daemon/watchdog-loop.js +91 -0
  140. package/dist/daemon/watchdog-loop.js.map +1 -0
  141. package/dist/dashboard/assets/index-BsrAAmvC.js +171 -0
  142. package/dist/dashboard/assets/index-DQOWJ2SF.css +1 -0
  143. package/dist/dashboard/index.html +2 -2
  144. package/dist/discovery/http.d.ts +17 -0
  145. package/dist/discovery/http.js +295 -25
  146. package/dist/discovery/http.js.map +1 -1
  147. package/dist/discovery/onchain.js +158 -2
  148. package/dist/discovery/onchain.js.map +1 -1
  149. package/dist/discovery/types.d.ts +106 -0
  150. package/dist/discovery/types.js +40 -0
  151. package/dist/discovery/types.js.map +1 -1
  152. package/dist/discovery/with-fallback.js +14 -0
  153. package/dist/discovery/with-fallback.js.map +1 -1
  154. package/dist/earning/bootstrap.d.ts +25 -0
  155. package/dist/earning/bootstrap.js +79 -28
  156. package/dist/earning/bootstrap.js.map +1 -1
  157. package/dist/earning/contracts.d.ts +0 -229
  158. package/dist/earning/contracts.js +4 -184
  159. package/dist/earning/contracts.js.map +1 -1
  160. package/dist/earning/faucet-topup-store.d.ts +41 -0
  161. package/dist/earning/faucet-topup-store.js +89 -0
  162. package/dist/earning/faucet-topup-store.js.map +1 -0
  163. package/dist/earning/faucet.d.ts +1 -1
  164. package/dist/earning/faucet.js +2 -2
  165. package/dist/earning/faucet.js.map +1 -1
  166. package/dist/earning/safe-adapter.js +11 -0
  167. package/dist/earning/safe-adapter.js.map +1 -1
  168. package/dist/earning/stolas-claim.js +8 -8
  169. package/dist/earning/stolas-claim.js.map +1 -1
  170. package/dist/earning/{jinn-rewards.d.ts → stolas-staking.d.ts} +4 -8
  171. package/dist/earning/{jinn-rewards.js → stolas-staking.js} +6 -10
  172. package/dist/earning/stolas-staking.js.map +1 -0
  173. package/dist/earning/testnet-setup-migration.d.ts +1 -0
  174. package/dist/earning/testnet-setup-migration.js +7 -2
  175. package/dist/earning/testnet-setup-migration.js.map +1 -1
  176. package/dist/earning/types.d.ts +1 -1
  177. package/dist/earning/types.js +1 -1
  178. package/dist/earning/types.js.map +1 -1
  179. package/dist/earning/viem-clients.d.ts +3 -19
  180. package/dist/earning/viem-clients.js +4 -31
  181. package/dist/earning/viem-clients.js.map +1 -1
  182. package/dist/eval/eval-harness-run.d.ts +63 -0
  183. package/dist/eval/eval-harness-run.js +123 -0
  184. package/dist/eval/eval-harness-run.js.map +1 -0
  185. package/dist/eval/orchestrator.d.ts +224 -0
  186. package/dist/eval/orchestrator.js +250 -0
  187. package/dist/eval/orchestrator.js.map +1 -0
  188. package/dist/eval/paired.d.ts +68 -0
  189. package/dist/eval/paired.js +93 -0
  190. package/dist/eval/paired.js.map +1 -0
  191. package/dist/eval/resolve-slate-tasks.d.ts +35 -0
  192. package/dist/eval/resolve-slate-tasks.js +56 -0
  193. package/dist/eval/resolve-slate-tasks.js.map +1 -0
  194. package/dist/eval/screen-discovery.d.ts +22 -0
  195. package/dist/eval/screen-discovery.js +71 -0
  196. package/dist/eval/screen-discovery.js.map +1 -0
  197. package/dist/eval/screen-progress.d.ts +41 -0
  198. package/dist/eval/screen-progress.js +60 -0
  199. package/dist/eval/screen-progress.js.map +1 -0
  200. package/dist/eval/screen-runner.d.ts +30 -0
  201. package/dist/eval/screen-runner.js +289 -0
  202. package/dist/eval/screen-runner.js.map +1 -0
  203. package/dist/eval/screen.d.ts +107 -0
  204. package/dist/eval/screen.js +159 -0
  205. package/dist/eval/screen.js.map +1 -0
  206. package/dist/eval/slope.d.ts +29 -0
  207. package/dist/eval/slope.js +46 -0
  208. package/dist/eval/slope.js.map +1 -0
  209. package/dist/eval/train-sequence.d.ts +35 -0
  210. package/dist/eval/train-sequence.js +59 -0
  211. package/dist/eval/train-sequence.js.map +1 -0
  212. package/dist/eval/wilson.d.ts +45 -0
  213. package/dist/eval/wilson.js +48 -0
  214. package/dist/eval/wilson.js.map +1 -0
  215. package/dist/events/types.d.ts +1 -1
  216. package/dist/events/types.js +1 -1
  217. package/dist/events/types.js.map +1 -1
  218. package/dist/harnesses/auth-source.d.ts +51 -0
  219. package/dist/harnesses/auth-source.js +155 -0
  220. package/dist/harnesses/auth-source.js.map +1 -0
  221. package/dist/harnesses/engine/canonical-json.js +5 -3
  222. package/dist/harnesses/engine/canonical-json.js.map +1 -1
  223. package/dist/harnesses/engine/engine.d.ts +32 -0
  224. package/dist/harnesses/engine/engine.js +76 -9
  225. package/dist/harnesses/engine/engine.js.map +1 -1
  226. package/dist/harnesses/engine/packaging.js +5 -5
  227. package/dist/harnesses/engine/packaging.js.map +1 -1
  228. package/dist/harnesses/engine/persistence.d.ts +17 -0
  229. package/dist/harnesses/engine/persistence.js +28 -0
  230. package/dist/harnesses/engine/persistence.js.map +1 -1
  231. package/dist/harnesses/impls/claude-mcp-hyperliquid/mcp-tools.d.ts +1 -1
  232. package/dist/harnesses/impls/claude-mcp-hyperliquid/mcp-tools.js +1 -1
  233. package/dist/harnesses/impls/claude-mcp-hyperliquid/mcp-tools.js.map +1 -1
  234. package/dist/harnesses/impls/hermes-agent/adapter.d.ts +2 -0
  235. package/dist/harnesses/impls/hermes-agent/adapter.js +8 -5
  236. package/dist/harnesses/impls/hermes-agent/adapter.js.map +1 -1
  237. package/dist/harnesses/impls/hermes-agent/bootstrap.d.ts +1 -0
  238. package/dist/harnesses/impls/hermes-agent/bootstrap.js +6 -1
  239. package/dist/harnesses/impls/hermes-agent/bootstrap.js.map +1 -1
  240. package/dist/harnesses/impls/hermes-agent/harness.d.ts +25 -3
  241. package/dist/harnesses/impls/hermes-agent/harness.js +89 -5
  242. package/dist/harnesses/impls/hermes-agent/harness.js.map +1 -1
  243. package/dist/harnesses/impls/index.d.ts +2 -0
  244. package/dist/harnesses/impls/index.js +10 -1
  245. package/dist/harnesses/impls/index.js.map +1 -1
  246. package/dist/harnesses/impls/jinn-repo-evaluator/eval-runner.d.ts +34 -0
  247. package/dist/harnesses/impls/jinn-repo-evaluator/eval-runner.js +111 -0
  248. package/dist/harnesses/impls/jinn-repo-evaluator/eval-runner.js.map +1 -0
  249. package/dist/harnesses/impls/jinn-repo-evaluator/evaluator.d.ts +24 -0
  250. package/dist/harnesses/impls/jinn-repo-evaluator/evaluator.js +19 -0
  251. package/dist/harnesses/impls/jinn-repo-evaluator/evaluator.js.map +1 -0
  252. package/dist/harnesses/impls/jinn-repo-evaluator/harness.d.ts +64 -0
  253. package/dist/harnesses/impls/jinn-repo-evaluator/harness.js +125 -0
  254. package/dist/harnesses/impls/jinn-repo-evaluator/harness.js.map +1 -0
  255. package/dist/harnesses/impls/jinn-repo-evaluator/repro.d.ts +32 -0
  256. package/dist/harnesses/impls/jinn-repo-evaluator/repro.js +73 -0
  257. package/dist/harnesses/impls/jinn-repo-evaluator/repro.js.map +1 -0
  258. package/dist/harnesses/impls/learner/adapters/claude-code.js +5 -0
  259. package/dist/harnesses/impls/learner/adapters/claude-code.js.map +1 -1
  260. package/dist/harnesses/impls/learner/adapters/codex-code.d.ts +8 -0
  261. package/dist/harnesses/impls/learner/adapters/codex-code.js +91 -11
  262. package/dist/harnesses/impls/learner/adapters/codex-code.js.map +1 -1
  263. package/dist/harnesses/impls/learner/harness.d.ts +29 -1
  264. package/dist/harnesses/impls/learner/harness.js +85 -1
  265. package/dist/harnesses/impls/learner/harness.js.map +1 -1
  266. package/dist/harnesses/impls/learner/harvest.d.ts +2 -0
  267. package/dist/harnesses/impls/learner/harvest.js +51 -1
  268. package/dist/harnesses/impls/learner/harvest.js.map +1 -1
  269. package/dist/harnesses/impls/learner/plugin-path.js +1 -0
  270. package/dist/harnesses/impls/learner/plugin-path.js.map +1 -1
  271. package/dist/harnesses/impls/stub.d.ts +2 -2
  272. package/dist/harnesses/impls/stub.js +2 -2
  273. package/dist/harnesses/impls/swe-rebench-v2-evaluator/harness.js +3 -1
  274. package/dist/harnesses/impls/swe-rebench-v2-evaluator/harness.js.map +1 -1
  275. package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.d.ts +2 -2
  276. package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.js +3 -1
  277. package/dist/harnesses/impls/swe-rebench-v2-evaluator/index.js.map +1 -1
  278. package/dist/harnesses/readiness-registry.d.ts +16 -0
  279. package/dist/harnesses/readiness-registry.js +28 -6
  280. package/dist/harnesses/readiness-registry.js.map +1 -1
  281. package/dist/harnesses/types.d.ts +26 -0
  282. package/dist/learner/revert-decision.d.ts +16 -1
  283. package/dist/learner/revert-decision.js +38 -18
  284. package/dist/learner/revert-decision.js.map +1 -1
  285. package/dist/learner/revert-stats.d.ts +14 -0
  286. package/dist/learner/revert-stats.js +42 -0
  287. package/dist/learner/revert-stats.js.map +1 -1
  288. package/dist/local-provider-url.d.ts +3 -0
  289. package/dist/local-provider-url.js +28 -0
  290. package/dist/local-provider-url.js.map +1 -0
  291. package/dist/main.js +125 -120
  292. package/dist/main.js.map +1 -1
  293. package/dist/mcp/acquire-artifact.d.ts +3 -3
  294. package/dist/mcp/acquire-artifact.js +3 -3
  295. package/dist/mcp/operator-server.js +1 -1
  296. package/dist/mcp/operator-server.js.map +1 -1
  297. package/dist/mcp/server.js +5 -6
  298. package/dist/mcp/server.js.map +1 -1
  299. package/dist/observability/emit-event.d.ts +1 -1
  300. package/dist/observability/emit-event.js +0 -4
  301. package/dist/observability/emit-event.js.map +1 -1
  302. package/dist/plugins/learner/.claude-plugin/plugin.json +1 -1
  303. package/dist/plugins/learner/.codex-plugin/plugin.json +1 -1
  304. package/dist/plugins/learner/hooks/session-start +30 -1
  305. package/dist/plugins/learner/skills/learn/consolidator-prompt.md +4 -0
  306. package/dist/preflight/deployment-readiness.d.ts +127 -0
  307. package/dist/preflight/deployment-readiness.js +308 -0
  308. package/dist/preflight/deployment-readiness.js.map +1 -0
  309. package/dist/preflight/pidfile-liveness.d.ts +7 -1
  310. package/dist/preflight/pidfile-liveness.js +14 -0
  311. package/dist/preflight/pidfile-liveness.js.map +1 -1
  312. package/dist/rpc/transport.d.ts +43 -5
  313. package/dist/rpc/transport.js +131 -30
  314. package/dist/rpc/transport.js.map +1 -1
  315. package/dist/scripts/swe-rebench-v2-seed-pool.json +2 -1
  316. package/dist/solver-nets/registry.d.ts +19 -0
  317. package/dist/solver-nets/registry.js +95 -66
  318. package/dist/solver-nets/registry.js.map +1 -1
  319. package/dist/solver-types/_jinn-repo-pool.d.ts +27 -0
  320. package/dist/solver-types/_jinn-repo-pool.js +27 -0
  321. package/dist/solver-types/_jinn-repo-pool.js.map +1 -0
  322. package/dist/solver-types/_swe-rebench-v2-held-out-slate.d.ts +76 -0
  323. package/dist/solver-types/_swe-rebench-v2-held-out-slate.js +156 -0
  324. package/dist/solver-types/_swe-rebench-v2-held-out-slate.js.map +1 -0
  325. package/dist/solver-types/_swe-rebench-v2-pool-recovery.d.ts +81 -0
  326. package/dist/solver-types/_swe-rebench-v2-pool-recovery.js +116 -0
  327. package/dist/solver-types/_swe-rebench-v2-pool-recovery.js.map +1 -0
  328. package/dist/solver-types/_swe-rebench-v2-state.d.ts +9 -0
  329. package/dist/solver-types/_swe-rebench-v2-state.js +14 -0
  330. package/dist/solver-types/_swe-rebench-v2-state.js.map +1 -1
  331. package/dist/solver-types/_swe-rebench-v2-validated-pool.d.ts +30 -0
  332. package/dist/solver-types/_swe-rebench-v2-validated-pool.js +40 -0
  333. package/dist/solver-types/_swe-rebench-v2-validated-pool.js.map +1 -1
  334. package/dist/solver-types/index.js +2 -0
  335. package/dist/solver-types/index.js.map +1 -1
  336. package/dist/solver-types/jinn-repo-admit.d.ts +17 -0
  337. package/dist/solver-types/jinn-repo-admit.js +16 -0
  338. package/dist/solver-types/jinn-repo-admit.js.map +1 -0
  339. package/dist/solver-types/jinn-repo-auto.d.ts +60 -0
  340. package/dist/solver-types/jinn-repo-auto.js +163 -0
  341. package/dist/solver-types/jinn-repo-auto.js.map +1 -0
  342. package/dist/solver-types/jinn-repo-definition.d.ts +15 -0
  343. package/dist/solver-types/jinn-repo-definition.js +34 -0
  344. package/dist/solver-types/jinn-repo-definition.js.map +1 -0
  345. package/dist/solver-types/jinn-repo-extract.d.ts +16 -0
  346. package/dist/solver-types/jinn-repo-extract.js +32 -0
  347. package/dist/solver-types/jinn-repo-extract.js.map +1 -0
  348. package/dist/solver-types/jinn-repo.d.ts +21 -0
  349. package/dist/solver-types/jinn-repo.js +23 -0
  350. package/dist/solver-types/jinn-repo.js.map +1 -0
  351. package/dist/solver-types/learner-loop-test.js +1 -1
  352. package/dist/solver-types/learner-loop-test.js.map +1 -1
  353. package/dist/solver-types/slates/held-out-slate.swe-rebench-v2.v1.json +20 -0
  354. package/dist/solver-types/slates/held-out-slate.swe-rebench-v2.v2.json +19 -0
  355. package/dist/solver-types/slates/held-out-slate.swe-rebench-v2.v2.screening-report.json +628 -0
  356. package/dist/solver-types/solver-type.d.ts +8 -0
  357. package/dist/solver-types/swe-rebench-v2.d.ts +2 -0
  358. package/dist/solver-types/swe-rebench-v2.js +115 -10
  359. package/dist/solver-types/swe-rebench-v2.js.map +1 -1
  360. package/dist/solvernets/launched-record-dispatcher.d.ts +5 -0
  361. package/dist/solvernets/launched-record-dispatcher.js +8 -1
  362. package/dist/solvernets/launched-record-dispatcher.js.map +1 -1
  363. package/dist/solvernets/registry-client-erc8004.js +29 -37
  364. package/dist/solvernets/registry-client-erc8004.js.map +1 -1
  365. package/dist/solvernets/registry-client.d.ts +6 -0
  366. package/dist/solvernets/store.d.ts +1 -1
  367. package/dist/solvernets/store.js +8 -3
  368. package/dist/solvernets/store.js.map +1 -1
  369. package/dist/spend/ai-units-config.d.ts +10 -0
  370. package/dist/spend/ai-units-config.js +7 -1
  371. package/dist/spend/ai-units-config.js.map +1 -1
  372. package/dist/spend/ai-units.d.ts +51 -0
  373. package/dist/spend/ai-units.js +73 -0
  374. package/dist/spend/ai-units.js.map +1 -1
  375. package/dist/spend/record.js +12 -5
  376. package/dist/spend/record.js.map +1 -1
  377. package/dist/spend/usage.js +39 -3
  378. package/dist/spend/usage.js.map +1 -1
  379. package/dist/store/store.d.ts +92 -5
  380. package/dist/store/store.js +184 -7
  381. package/dist/store/store.js.map +1 -1
  382. package/dist/trajectory/emit.d.ts +6 -0
  383. package/dist/trajectory/emit.js +9 -1
  384. package/dist/trajectory/emit.js.map +1 -1
  385. package/dist/trajectory/harness-bundle-schema.d.ts +1 -1
  386. package/dist/trajectory/harness-bundle-schema.js +1 -1
  387. package/dist/trajectory/harness-bundle-schema.js.map +1 -1
  388. package/dist/trajectory/schema.d.ts +1 -1
  389. package/dist/trajectory/schema.js +1 -1
  390. package/dist/trajectory/schema.js.map +1 -1
  391. package/dist/trajectory/scrub/build.d.ts +27 -0
  392. package/dist/trajectory/scrub/build.js +43 -0
  393. package/dist/trajectory/scrub/build.js.map +1 -0
  394. package/dist/trajectory/scrub/emit-scrub.d.ts +41 -0
  395. package/dist/trajectory/scrub/emit-scrub.js +88 -0
  396. package/dist/trajectory/scrub/emit-scrub.js.map +1 -0
  397. package/dist/trajectory/scrub/key-policy.d.ts +20 -0
  398. package/dist/trajectory/scrub/key-policy.js +43 -0
  399. package/dist/trajectory/scrub/key-policy.js.map +1 -0
  400. package/dist/trajectory/scrub/ml-pii-stage.d.ts +24 -0
  401. package/dist/trajectory/scrub/ml-pii-stage.js +43 -0
  402. package/dist/trajectory/scrub/ml-pii-stage.js.map +1 -0
  403. package/dist/trajectory/scrub/openredaction-stage.d.ts +14 -0
  404. package/dist/trajectory/scrub/openredaction-stage.js +36 -0
  405. package/dist/trajectory/scrub/openredaction-stage.js.map +1 -0
  406. package/dist/trajectory/scrub/pii-build.d.ts +31 -0
  407. package/dist/trajectory/scrub/pii-build.js +64 -0
  408. package/dist/trajectory/scrub/pii-build.js.map +1 -0
  409. package/dist/trajectory/scrub/pipeline.d.ts +16 -0
  410. package/dist/trajectory/scrub/pipeline.js +26 -0
  411. package/dist/trajectory/scrub/pipeline.js.map +1 -0
  412. package/dist/trajectory/scrub/secretlint-stage.d.ts +13 -0
  413. package/dist/trajectory/scrub/secretlint-stage.js +121 -0
  414. package/dist/trajectory/scrub/secretlint-stage.js.map +1 -0
  415. package/dist/trajectory/scrub/transformers-detector.d.ts +35 -0
  416. package/dist/trajectory/scrub/transformers-detector.js +68 -0
  417. package/dist/trajectory/scrub/transformers-detector.js.map +1 -0
  418. package/dist/trajectory/scrub/types.d.ts +25 -0
  419. package/dist/trajectory/scrub/types.js +2 -0
  420. package/dist/trajectory/scrub/types.js.map +1 -0
  421. package/dist/trajectory/transcript-parsers/types.d.ts +1 -1
  422. package/dist/trajectory/transcript-parsers/types.js +1 -1
  423. package/dist/trajectory/transcript-parsers/types.js.map +1 -1
  424. package/dist/tx-retry.d.ts +12 -0
  425. package/dist/tx-retry.js +41 -12
  426. package/dist/tx-retry.js.map +1 -1
  427. package/dist/types/envelope.d.ts +1 -1
  428. package/dist/types/envelope.js +1 -1
  429. package/dist/types/envelope.js.map +1 -1
  430. package/dist/types/payloads/index.d.ts +1 -1
  431. package/dist/types/payloads/index.js +7 -1
  432. package/dist/types/payloads/index.js.map +1 -1
  433. package/dist/types/payloads/portfolio-v0.d.ts +1 -1
  434. package/dist/types/payloads/portfolio-v0.js +1 -1
  435. package/dist/types/payloads/portfolio-v0.js.map +1 -1
  436. package/dist/types/payloads/prediction-apy-v0.d.ts +1 -1
  437. package/dist/types/payloads/prediction-apy-v0.js +1 -1
  438. package/dist/types/payloads/prediction-apy-v0.js.map +1 -1
  439. package/dist/types/payloads/prediction-v0.d.ts +1 -1
  440. package/dist/types/payloads/prediction-v0.js +1 -1
  441. package/dist/types/payloads/prediction-v0.js.map +1 -1
  442. package/dist/types/portfolio.d.ts +1 -1
  443. package/dist/types/portfolio.js +1 -1
  444. package/dist/types/portfolio.js.map +1 -1
  445. package/dist/types/prediction-apy.d.ts +1 -1
  446. package/dist/types/prediction-apy.js +1 -1
  447. package/dist/types/prediction-apy.js.map +1 -1
  448. package/dist/types/prediction.d.ts +1 -1
  449. package/dist/types/prediction.js +1 -1
  450. package/dist/types/prediction.js.map +1 -1
  451. package/dist/types/session-provenance.d.ts +1 -1
  452. package/dist/types/session-provenance.js +1 -1
  453. package/dist/types/session-provenance.js.map +1 -1
  454. package/dist/types/task-document.d.ts +315 -1
  455. package/dist/types/task-document.js +9 -1
  456. package/dist/types/task-document.js.map +1 -1
  457. package/dist/types/task.d.ts +29 -1
  458. package/dist/types/task.js +1 -1
  459. package/dist/types/task.js.map +1 -1
  460. package/dist/types/window.d.ts +1 -1
  461. package/dist/types/window.js +1 -1
  462. package/dist/types/window.js.map +1 -1
  463. package/dist/vendor/@jinn-network/sdk/dist/checkpoint.d.ts +1 -1
  464. package/dist/vendor/@jinn-network/sdk/dist/checkpoint.js +1 -1
  465. package/dist/vendor/@jinn-network/sdk/dist/contracts.d.ts +3 -2
  466. package/dist/vendor/@jinn-network/sdk/dist/contracts.js +49 -0
  467. package/dist/vendor/@jinn-network/sdk/dist/jinn-repo.d.ts +44 -0
  468. package/dist/vendor/@jinn-network/sdk/dist/jinn-repo.js +25 -0
  469. package/dist/vendor/@jinn-network/sdk/dist/json-schema.d.ts +1 -1
  470. package/dist/vendor/@jinn-network/sdk/dist/json-schema.js +1 -1
  471. package/dist/vendor/@jinn-network/sdk/dist/payloads/jinn-repo.d.ts +38 -0
  472. package/dist/vendor/@jinn-network/sdk/dist/payloads/jinn-repo.js +22 -0
  473. package/dist/vendor/@jinn-network/sdk/dist/payloads/prediction-v1.d.ts +1 -1
  474. package/dist/vendor/@jinn-network/sdk/dist/payloads/prediction-v1.js +1 -1
  475. package/dist/vendor/@jinn-network/sdk/dist/payloads/session-derived.d.ts +1 -1
  476. package/dist/vendor/@jinn-network/sdk/dist/payloads/session-derived.js +1 -1
  477. package/dist/vendor/@jinn-network/sdk/dist/payloads/swe-rebench-v2.d.ts +109 -2
  478. package/dist/vendor/@jinn-network/sdk/dist/payloads/swe-rebench-v2.js +26 -2
  479. package/dist/vendor/@jinn-network/sdk/dist/prediction-v1.d.ts +1 -1
  480. package/dist/vendor/@jinn-network/sdk/dist/prediction-v1.js +1 -1
  481. package/dist/vendor/@jinn-network/sdk/dist/solvernets/jinn-repo.d.ts +4 -0
  482. package/dist/vendor/@jinn-network/sdk/dist/solvernets/jinn-repo.js +2 -0
  483. package/dist/vendor/@jinn-network/sdk/dist/solvernets/manifest-schema.d.ts +1 -1
  484. package/dist/vendor/@jinn-network/sdk/dist/solvernets/manifest-schema.js +1 -1
  485. package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2-held-out-slate.d.ts +65 -0
  486. package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2-held-out-slate.js +123 -0
  487. package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2.d.ts +2 -2
  488. package/dist/vendor/@jinn-network/sdk/dist/solvernets/swe-rebench-v2.js +1 -1
  489. package/dist/vendor/@jinn-network/sdk/dist/swe-rebench-v2.d.ts +1 -1
  490. package/dist/vendor/@jinn-network/sdk/dist/swe-rebench-v2.js +1 -1
  491. package/dist/vendor/@jinn-network/sdk/package.json +9 -1
  492. package/docker-compose.yml +3 -2
  493. package/package.json +36 -26
  494. package/plugins/jinn-repo-runtime/.claude-plugin/plugin.json +5 -0
  495. package/plugins/jinn-repo-runtime/.codex-plugin/plugin.json +39 -0
  496. package/plugins/jinn-repo-runtime/README.md +27 -0
  497. package/plugins/jinn-repo-runtime/hooks/hooks.json +16 -0
  498. package/plugins/jinn-repo-runtime/hooks/session-start +73 -0
  499. package/plugins/jinn-repo-runtime/jinn.plugin.json +11 -0
  500. package/plugins/jinn-repo-runtime/skills/task/SKILL.md +92 -0
  501. package/plugins/learner/.claude-plugin/plugin.json +1 -1
  502. package/plugins/learner/.codex-plugin/plugin.json +1 -1
  503. package/plugins/learner/hooks/session-start +30 -1
  504. package/plugins/learner/skills/learn/consolidator-prompt.md +4 -0
  505. package/plugins/swe-rebench-v2-runtime/hooks/hooks.json +16 -0
  506. package/plugins/swe-rebench-v2-runtime/hooks/session-start +74 -0
  507. package/deployments/deployment-jinn-mvi-l1-sepolia-fast.json +0 -55
  508. package/deployments/deployment-jinn-mvi-l1-sepolia.json +0 -55
  509. package/deployments/deployment-jinn-mvi-l2-baseSepolia.json +0 -13
  510. package/deployments/deployment-jinn-testnet-faucet-baseSepolia-fast.json +0 -15
  511. package/dist/daemon/jinn-claim-loop-canonical.d.ts +0 -207
  512. package/dist/daemon/jinn-claim-loop-canonical.js +0 -296
  513. package/dist/daemon/jinn-claim-loop-canonical.js.map +0 -1
  514. package/dist/daemon/jinn-claim-loop-mock.d.ts +0 -61
  515. package/dist/daemon/jinn-claim-loop-mock.js +0 -122
  516. package/dist/daemon/jinn-claim-loop-mock.js.map +0 -1
  517. package/dist/daemon/jinn-claim-loop-wiring.d.ts +0 -33
  518. package/dist/daemon/jinn-claim-loop-wiring.js +0 -40
  519. package/dist/daemon/jinn-claim-loop-wiring.js.map +0 -1
  520. package/dist/daemon/jinn-claim-loop.d.ts +0 -130
  521. package/dist/daemon/jinn-claim-loop.js +0 -328
  522. package/dist/daemon/jinn-claim-loop.js.map +0 -1
  523. package/dist/dashboard/assets/index-CzKxvMcU.css +0 -32
  524. package/dist/dashboard/assets/index-yVemxHot.js +0 -351
  525. package/dist/earning/jinn-rewards.js.map +0 -1
  526. package/dist/scripts/donation-consumption-acceptance.d.ts +0 -85
  527. package/dist/scripts/donation-consumption-acceptance.js +0 -1382
  528. package/dist/scripts/donation-consumption-acceptance.js.map +0 -1
  529. package/dist/x402/acquire.d.ts +0 -17
  530. package/dist/x402/acquire.js +0 -49
  531. package/dist/x402/acquire.js.map +0 -1
  532. package/dist/x402/facilitator.d.ts +0 -11
  533. package/dist/x402/facilitator.js +0 -52
  534. package/dist/x402/facilitator.js.map +0 -1
  535. package/dist/x402/handler.d.ts +0 -27
  536. package/dist/x402/handler.js +0 -236
  537. package/dist/x402/handler.js.map +0 -1
@@ -0,0 +1,224 @@
1
+ /**
2
+ * `jinn eval` held-out checkpoint orchestrator (issue #818).
3
+ *
4
+ * Runs a held-out slate against a checkpoint in FROZEN mode, persists per-task
5
+ * pass/fail, and emits a Wilson-CI resolved-rate comparison vs the parent
6
+ * checkpoint. Every external boundary is constructor-injected — this is the
7
+ * thin slice #819 drives a deterministic slate against with NO Docker/IPFS.
8
+ *
9
+ * Acceptance criteria:
10
+ * AC#1 — run the slate frozen, write per-task pass/fail.
11
+ * AC#2 — emit a resolved-rate comparison vs the parent with a CI.
12
+ * AC#3 — the freeze-fence holds: a `runHarnessOnce` `{ violation }` throws
13
+ * LOUD and the instance is NOT recorded (no implStateDir mutation
14
+ * slips through; enforcement lives in `runHarnessWithFreezeFence`).
15
+ *
16
+ * Per log/decisions/2026-05-28-rl-eval-measurement.md §4: v1-simple. Only large
17
+ * deltas are trustworthy (disjoint Wilson intervals). No seed control, no
18
+ * multi-run averaging.
19
+ */
20
+ import type { Harness, HarnessContext } from '../harnesses/types.js';
21
+ import type { HarnessCheckpointManifest } from '../vendor/@jinn-network/sdk/dist/checkpoint.js';
22
+ import type { LoadedHeldOutSlate } from '../solver-types/_swe-rebench-v2-held-out-slate.js';
23
+ import type { ResolvedSlateTask } from './resolve-slate-tasks.js';
24
+ import type { EvalAggregate, EvalResultRecord } from '../store/store.js';
25
+ import { type RateComparison } from './wilson.js';
26
+ import { type PairedComparison, type PairedInput } from './paired.js';
27
+ /** Thrown when `runHarnessOnce` reports a freeze-fence violation (AC#3). */
28
+ export declare class FreezeFenceViolationError extends Error {
29
+ readonly instanceId: string;
30
+ constructor(instanceId: string);
31
+ }
32
+ /**
33
+ * Thrown when the locally-evaluated impl-state's codeDigest does not match the
34
+ * named checkpoint's manifest (C1). Guards against persisting + comparing
35
+ * results under a checkpoint name while the operator's local impl-state has
36
+ * drifted from that checkpoint.
37
+ */
38
+ export declare class CheckpointStateMismatchError extends Error {
39
+ readonly checkpointCid: string;
40
+ readonly manifestCodeDigest: string;
41
+ readonly evaluatedCodeDigest: string;
42
+ constructor(checkpointCid: string, manifestCodeDigest: string, evaluatedCodeDigest: string);
43
+ }
44
+ /** Thrown when the parent checkpoint has no aggregate for this slate version (AC#2). */
45
+ export declare class ParentNotEvaluatedError extends Error {
46
+ readonly parentCheckpointCid: string;
47
+ readonly slateVersion: string;
48
+ constructor(parentCheckpointCid: string, slateVersion: string);
49
+ }
50
+ /** A checkpoint whose recorded results carry slate hashes other than the current one. */
51
+ export interface SlateHashDrift {
52
+ checkpointCid: string;
53
+ /** The drifted hashes (each != the current slate hash). */
54
+ hashes: string[];
55
+ }
56
+ /**
57
+ * Thrown when EITHER compared checkpoint was scored on a DIFFERENT slate
58
+ * *content* under the same version label (DR-2026-05-28 §2 — confounder control).
59
+ * A slate is content-addressed and scores are comparable ONLY within identical
60
+ * content; the store keys aggregates by version, so a content edit that skipped
61
+ * the version bump (or re-derived the declared hash — which the slate loader
62
+ * admits passes), or stale rows surviving `recordEvalResult`'s by-instance
63
+ * upsert, would let the comparison silently compare two checkpoints scored on
64
+ * different task sets. That is confounder #1 (task-selection) — exactly what the
65
+ * held-out exam exists to defeat — so we refuse the comparison loudly instead.
66
+ */
67
+ export declare class SlateHashMismatchError extends Error {
68
+ readonly slateVersion: string;
69
+ readonly currentSlateHash: string;
70
+ readonly drifted: ReadonlyArray<SlateHashDrift>;
71
+ constructor(slateVersion: string, currentSlateHash: string, drifted: ReadonlyArray<SlateHashDrift>);
72
+ }
73
+ /**
74
+ * Injected `runHarnessOnce`-shaped boundary. Mirrors the production
75
+ * `runHarnessOnce` (freeze-fence + mode propagation) but also surfaces the
76
+ * harness `solution` so the orchestrator can extract the patch to grade. On a
77
+ * freeze violation it returns `{ violation }` and no solution.
78
+ */
79
+ export type RunHarnessOnceForEval = (params: {
80
+ harness: Harness;
81
+ implStateDir: string;
82
+ mode: 'train' | 'frozen';
83
+ task?: HarnessContext['task'];
84
+ }) => Promise<{
85
+ envelope?: {
86
+ executor: {
87
+ mode: 'train' | 'frozen';
88
+ codeDigest: string;
89
+ };
90
+ };
91
+ violation?: {
92
+ taskId: string;
93
+ };
94
+ solution?: {
95
+ patch: string;
96
+ };
97
+ }>;
98
+ /**
99
+ * The grade verdict the orchestrator consumes. It reads exactly two fields:
100
+ * `passed_match` (→ per-task pass/fail) and `test_log` (→ recorded excerpt).
101
+ * This is the swe-rebench-v2 verdict surface; the repo-native JinnRepoEvaluator
102
+ * is projected onto it by the adapter in eval.ts. Anything unscorable is
103
+ * signalled by THROWING (the orchestrator's catch records `unscorable`) — never
104
+ * by a verdict flag — so both backends agree on the unscorable contract.
105
+ */
106
+ export interface EvalGradeVerdict {
107
+ passed_match: boolean;
108
+ test_log: string;
109
+ }
110
+ /**
111
+ * Minimal structural evaluator the orchestrator depends on. `SweRebenchV2Evaluator`
112
+ * satisfies it directly (its verdict is a superset of `EvalGradeVerdict`); the
113
+ * jinn-repo path supplies an adapter in eval.ts that wraps `JinnRepoEvaluator`,
114
+ * translating the call and projecting its `{ passed, unscorable, logExcerpt }`
115
+ * result onto this verdict (throwing on unscorable). `task`/`solutionPayload`/`row`
116
+ * are the swe-rebench-v2 grade call; the orchestrator passes them verbatim and
117
+ * the backend adapter interprets them.
118
+ */
119
+ export interface SolutionEvaluator {
120
+ grade(args: {
121
+ task: {
122
+ instance_id: string;
123
+ };
124
+ solutionPayload: {
125
+ schemaVersion: string;
126
+ patch: string;
127
+ };
128
+ row?: unknown;
129
+ }): Promise<EvalGradeVerdict>;
130
+ }
131
+ export interface EvalOrchestratorDeps {
132
+ harness: Harness;
133
+ fetchImplStateDirToLocal(implStateDirCid: string, targetDir: string): Promise<string>;
134
+ evaluator: SolutionEvaluator;
135
+ runHarnessOnce: RunHarnessOnceForEval;
136
+ store: {
137
+ recordEvalResult(args: EvalResultRecord): void;
138
+ getEvalAggregate(checkpointCid: string, slateVersion: string): EvalAggregate;
139
+ /** Distinct slate_hash values the parent's results were recorded under (drift guard). */
140
+ getEvalSlateHashes(checkpointCid: string, slateVersion: string): string[];
141
+ /**
142
+ * Optional: per-instance results for a (checkpoint, slate version). When
143
+ * present, the orchestrator also emits the paired (matched-design) McNemar
144
+ * verdict (DR-2026-06-02-b §2a) — the same slate is scored before & after, so
145
+ * the matched test is the statistically correct one and is far more powerful
146
+ * than the marginal disjoint-interval test. Reported ALONGSIDE `comparison`,
147
+ * never replacing it (the exam is strengthened, not weakened).
148
+ */
149
+ getEvalResults?(checkpointCid: string, slateVersion: string): PairedInput[];
150
+ };
151
+ }
152
+ export interface PerTaskResult {
153
+ instance_id: string;
154
+ /** null when unscorable. */
155
+ passed: boolean | null;
156
+ unscorable: boolean;
157
+ }
158
+ /**
159
+ * Provenance of the graded artifact (Legibility). The CLI grades the operator's
160
+ * LOCAL frozen impl-state — verified == the named checkpoint via the C1
161
+ * codeDigest guard (CheckpointStateMismatchError) — NOT a state re-fetched from
162
+ * the checkpoint CID. Surfacing this stops a reader from assuming the tool
163
+ * fetched and graded the published checkpoint's state.
164
+ */
165
+ export interface EvalProvenance {
166
+ /** Local impl-state directory that was actually run. */
167
+ implStateDir: string;
168
+ /** Real codeDigest of the evaluated impl-state (verified == manifest.codeDigest). */
169
+ codeDigest: string;
170
+ /** Always true on a returned result — a mismatch throws CheckpointStateMismatchError. */
171
+ matchedCheckpoint: true;
172
+ }
173
+ export interface EvalRunResult {
174
+ perTask: PerTaskResult[];
175
+ comparison: RateComparison;
176
+ /**
177
+ * Paired (matched-design) McNemar verdict vs the parent — present only when
178
+ * the store exposes `getEvalResults`. The marginal `comparison` above is
179
+ * conservative; this is the statistically correct test for the same-slate
180
+ * before/after design and is reported alongside it (DR-2026-06-02-b §2a).
181
+ */
182
+ paired?: PairedComparison;
183
+ /** What was actually graded (local impl-state), not the checkpoint identity. */
184
+ evaluated: EvalProvenance;
185
+ }
186
+ /**
187
+ * One slate instance normalised for the backend-agnostic run/grade loop. The
188
+ * BACKEND (eval.ts) owns construction of both `harnessTask` (the LEAK-CONTROLLED
189
+ * view the solver sees — for jinn-repo this is `solverView(item)`, never the
190
+ * pool item) and `gradeTask`/`row` (what the evaluator needs — for jinn-repo the
191
+ * full pool item incl. gold tests). The swe-rebench-v2 path derives these from
192
+ * `tasksWithRows` via the default mapping below, unchanged.
193
+ */
194
+ export interface EvalSlateInstance {
195
+ instance_id: string;
196
+ /** Task handed to the solver harness — already leak-controlled by the backend. */
197
+ harnessTask: NonNullable<HarnessContext['task']>;
198
+ /** Backend-specific grade payload; passed verbatim as the evaluator's `task`. */
199
+ gradeTask: {
200
+ instance_id: string;
201
+ };
202
+ /** Solution payload `schemaVersion` the evaluator expects. */
203
+ solutionSchemaVersion: string;
204
+ /** swe-rebench-v2 HF row reused at grade time; absent for repo-native. */
205
+ row?: unknown;
206
+ }
207
+ export declare function runEval(args: {
208
+ checkpointManifest: HarnessCheckpointManifest;
209
+ checkpointCid: string;
210
+ slate: LoadedHeldOutSlate;
211
+ /**
212
+ * swe-rebench-v2 slate tasks (the historical input). When given, each is
213
+ * normalised via the default swe-rebench mapping. Mutually informative with
214
+ * `slateInstances`: a backend that builds its own leak-controlled instances
215
+ * (jinn-repo) passes `slateInstances` directly instead.
216
+ */
217
+ tasksWithRows?: ResolvedSlateTask[];
218
+ /** Pre-built, backend-normalised instances (jinn-repo path). Overrides `tasksWithRows`. */
219
+ slateInstances?: EvalSlateInstance[];
220
+ parentCheckpointCid: string;
221
+ deps: EvalOrchestratorDeps;
222
+ /** Working dir for the fetched impl-state-dir (defaults to a checkpoint-scoped tmp path). */
223
+ implStateDir?: string;
224
+ }): Promise<EvalRunResult>;
@@ -0,0 +1,250 @@
1
+ /**
2
+ * `jinn eval` held-out checkpoint orchestrator (issue #818).
3
+ *
4
+ * Runs a held-out slate against a checkpoint in FROZEN mode, persists per-task
5
+ * pass/fail, and emits a Wilson-CI resolved-rate comparison vs the parent
6
+ * checkpoint. Every external boundary is constructor-injected — this is the
7
+ * thin slice #819 drives a deterministic slate against with NO Docker/IPFS.
8
+ *
9
+ * Acceptance criteria:
10
+ * AC#1 — run the slate frozen, write per-task pass/fail.
11
+ * AC#2 — emit a resolved-rate comparison vs the parent with a CI.
12
+ * AC#3 — the freeze-fence holds: a `runHarnessOnce` `{ violation }` throws
13
+ * LOUD and the instance is NOT recorded (no implStateDir mutation
14
+ * slips through; enforcement lives in `runHarnessWithFreezeFence`).
15
+ *
16
+ * Per log/decisions/2026-05-28-rl-eval-measurement.md §4: v1-simple. Only large
17
+ * deltas are trustworthy (disjoint Wilson intervals). No seed control, no
18
+ * multi-run averaging.
19
+ */
20
+ import { compareRates } from './wilson.js';
21
+ import { comparePaired } from './paired.js';
22
+ /** Thrown when `runHarnessOnce` reports a freeze-fence violation (AC#3). */
23
+ export class FreezeFenceViolationError extends Error {
24
+ instanceId;
25
+ constructor(instanceId) {
26
+ super(`freeze-fence violation on instance ${instanceId}: the harness mutated implStateDir ` +
27
+ `during a frozen-mode eval run — refusing to record a tainted result`);
28
+ this.instanceId = instanceId;
29
+ this.name = 'FreezeFenceViolationError';
30
+ }
31
+ }
32
+ /**
33
+ * Thrown when the locally-evaluated impl-state's codeDigest does not match the
34
+ * named checkpoint's manifest (C1). Guards against persisting + comparing
35
+ * results under a checkpoint name while the operator's local impl-state has
36
+ * drifted from that checkpoint.
37
+ */
38
+ export class CheckpointStateMismatchError extends Error {
39
+ checkpointCid;
40
+ manifestCodeDigest;
41
+ evaluatedCodeDigest;
42
+ constructor(checkpointCid, manifestCodeDigest, evaluatedCodeDigest) {
43
+ super(`local impl-state does not match checkpoint ${checkpointCid}: ` +
44
+ `manifest codeDigest=${manifestCodeDigest} but the evaluated impl-state hashes to ` +
45
+ `${evaluatedCodeDigest}. Check out the impl-state for this checkpoint or pass the ` +
46
+ `correct --impl-state-dir; refusing to record results under a codeDigest that is a lie`);
47
+ this.checkpointCid = checkpointCid;
48
+ this.manifestCodeDigest = manifestCodeDigest;
49
+ this.evaluatedCodeDigest = evaluatedCodeDigest;
50
+ this.name = 'CheckpointStateMismatchError';
51
+ }
52
+ }
53
+ /** Thrown when the parent checkpoint has no aggregate for this slate version (AC#2). */
54
+ export class ParentNotEvaluatedError extends Error {
55
+ parentCheckpointCid;
56
+ slateVersion;
57
+ constructor(parentCheckpointCid, slateVersion) {
58
+ super(`parent checkpoint ${parentCheckpointCid} has no eval results for slate ${slateVersion} — ` +
59
+ `eval the parent checkpoint first (scores are only comparable within a slate version)`);
60
+ this.parentCheckpointCid = parentCheckpointCid;
61
+ this.slateVersion = slateVersion;
62
+ this.name = 'ParentNotEvaluatedError';
63
+ }
64
+ }
65
+ /**
66
+ * Thrown when EITHER compared checkpoint was scored on a DIFFERENT slate
67
+ * *content* under the same version label (DR-2026-05-28 §2 — confounder control).
68
+ * A slate is content-addressed and scores are comparable ONLY within identical
69
+ * content; the store keys aggregates by version, so a content edit that skipped
70
+ * the version bump (or re-derived the declared hash — which the slate loader
71
+ * admits passes), or stale rows surviving `recordEvalResult`'s by-instance
72
+ * upsert, would let the comparison silently compare two checkpoints scored on
73
+ * different task sets. That is confounder #1 (task-selection) — exactly what the
74
+ * held-out exam exists to defeat — so we refuse the comparison loudly instead.
75
+ */
76
+ export class SlateHashMismatchError extends Error {
77
+ slateVersion;
78
+ currentSlateHash;
79
+ drifted;
80
+ constructor(slateVersion, currentSlateHash, drifted) {
81
+ const detail = drifted
82
+ .map((d) => `${d.checkpointCid} carries [${d.hashes.join(', ')}]`)
83
+ .join('; ');
84
+ super(`a checkpoint was evaluated against a different slate content under the same version label ` +
85
+ `${slateVersion}: current slate hash is ${currentSlateHash} but ${detail}. Same version must ` +
86
+ `mean the same exam — a slate content change is a measurement discontinuity that must bump the ` +
87
+ `version. Bump the slate version and re-evaluate; refusing to report a delta across two ` +
88
+ `different task sets (confounder #1, task-selection)`);
89
+ this.slateVersion = slateVersion;
90
+ this.currentSlateHash = currentSlateHash;
91
+ this.drifted = drifted;
92
+ this.name = 'SlateHashMismatchError';
93
+ }
94
+ }
95
+ /**
96
+ * Default swe-rebench-v2 instance mapping — preserves the exact harness `task`
97
+ * envelope and grade call the orchestrator used before the backend seam existed.
98
+ */
99
+ function sweRebenchSlateInstance(rt) {
100
+ return {
101
+ instance_id: rt.task.instance_id,
102
+ // Carry the full SweRebenchV2Task in `spec` + the `solverType` dispatch key
103
+ // so the harness can restore the repo (clone/checkout from
104
+ // spec.repo/base_commit). id/description/role alone are insufficient.
105
+ harnessTask: {
106
+ id: rt.task.instance_id,
107
+ description: rt.task.problem_statement,
108
+ role: 'restoration',
109
+ solverType: 'swe-rebench-v2.v1',
110
+ spec: rt.task,
111
+ window: { startTs: 0, endTs: Date.now() + 3_600_000 },
112
+ },
113
+ gradeTask: rt.task,
114
+ solutionSchemaVersion: 'swe-rebench-v2-solution.v1',
115
+ row: rt.row,
116
+ };
117
+ }
118
+ export async function runEval(args) {
119
+ const { deps, slate, checkpointCid, parentCheckpointCid } = args;
120
+ const slateInstances = args.slateInstances ?? (args.tasksWithRows ?? []).map(sweRebenchSlateInstance);
121
+ // Confounder guard (DR-2026-05-28 §2). The store keys aggregates by slate
122
+ // VERSION; if EITHER checkpoint has results recorded under a different slate
123
+ // CONTENT for that version — a content edit that skipped the version bump, or
124
+ // stale rows surviving recordEvalResult's by-instance upsert — comparing
125
+ // child-vs-parent reintroduces confounder #1 (task-selection: two scores over
126
+ // different task sets). Both arms' hashes are known up front, so detect drift
127
+ // in EITHER before the loop and refuse — never burn N× real spend producing a
128
+ // number we'd have to throw away.
129
+ const drifted = [parentCheckpointCid, checkpointCid]
130
+ .map((cid) => ({
131
+ checkpointCid: cid,
132
+ hashes: deps.store.getEvalSlateHashes(cid, slate.version).filter((hash) => hash !== slate.hash),
133
+ }))
134
+ .filter((arm) => arm.hashes.length > 0);
135
+ if (drifted.length > 0) {
136
+ throw new SlateHashMismatchError(slate.version, slate.hash, drifted);
137
+ }
138
+ // Hoist the impl-state-dir fetch outside the loop: every slate instance runs
139
+ // against the SAME checkpoint state.
140
+ const implStateDir = args.implStateDir ?? `/tmp/jinn-eval-${checkpointCid}`;
141
+ const localImplStateDir = await deps.fetchImplStateDirToLocal(args.checkpointManifest.implStateDirCid, implStateDir);
142
+ const perTask = [];
143
+ const runAtMs = Date.now();
144
+ let digestChecked = false;
145
+ // Real digest of the evaluated impl-state (from the freeze-fence), captured on
146
+ // the first run for provenance. Falls back to the manifest digest, which the
147
+ // C1 guard proves equal.
148
+ let evaluatedDigest = args.checkpointManifest.codeDigest;
149
+ for (const inst of slateInstances) {
150
+ const task = inst.gradeTask;
151
+ let passed;
152
+ let unscorable = false;
153
+ let logExcerpt = '';
154
+ try {
155
+ const run = await deps.runHarnessOnce({
156
+ harness: deps.harness,
157
+ implStateDir: localImplStateDir,
158
+ mode: 'frozen',
159
+ // The harness task is built by the BACKEND (eval.ts) and is already
160
+ // leak-controlled (jinn-repo hands the solver `solverView(item)` only —
161
+ // no gold tests / reference solution). swe-rebench-v2 carries the full
162
+ // task in `spec` so the harness can restore the repo.
163
+ task: inst.harnessTask,
164
+ });
165
+ // AC#3: a freeze violation is loud and terminal — do NOT record this
166
+ // instance (its implStateDir mutation taints the run). Thrown OUTSIDE the
167
+ // unscorable catch below so it propagates and aborts the whole eval.
168
+ if (run.violation) {
169
+ throw new FreezeFenceViolationError(inst.instance_id);
170
+ }
171
+ if (!run.solution) {
172
+ throw new Error(`harness produced no solution for instance ${inst.instance_id}`);
173
+ }
174
+ // C1: on the FIRST successful run, verify the real digest of the evaluated
175
+ // impl-state (computed by the freeze-fence) matches the named checkpoint's
176
+ // manifest. Fail fast — before grading any instance — to avoid Docker spend
177
+ // and to never persist a result under a codeDigest that is a lie.
178
+ if (!digestChecked) {
179
+ digestChecked = true;
180
+ const runDigest = run.envelope?.executor.codeDigest;
181
+ if (runDigest && runDigest !== args.checkpointManifest.codeDigest) {
182
+ throw new CheckpointStateMismatchError(checkpointCid, args.checkpointManifest.codeDigest, runDigest);
183
+ }
184
+ if (runDigest)
185
+ evaluatedDigest = runDigest;
186
+ }
187
+ const verdict = await deps.evaluator.grade({
188
+ task,
189
+ solutionPayload: { schemaVersion: inst.solutionSchemaVersion, patch: run.solution.patch },
190
+ ...(inst.row !== undefined ? { row: inst.row } : {}),
191
+ });
192
+ passed = verdict.passed_match;
193
+ logExcerpt = verdict.test_log.slice(0, 1000);
194
+ }
195
+ catch (err) {
196
+ // A freeze-fence violation taints the run and must stay a LOUD terminal
197
+ // abort (AC#3). Likewise the C1 digest mismatch — never record results
198
+ // under a codeDigest that is a lie. Both re-throw and abort the eval.
199
+ if (err instanceof FreezeFenceViolationError || err instanceof CheckpointStateMismatchError) {
200
+ throw err;
201
+ }
202
+ // Everything else is unscorable: excluded from the denominator, NEVER
203
+ // coerced to a fail (#476). This covers both grade-side failures
204
+ // (EvalCouldNotGradeError / InsufficientDiskError) and harness-run
205
+ // failures (Defect A — harvest missing-artifact, "produced no patch",
206
+ // clone/timeout, etc.); a harness/infra failure to produce a gradeable
207
+ // solution is environment-side, not an agent capability fail. The slate
208
+ // continues to the next instance.
209
+ passed = null;
210
+ unscorable = true;
211
+ logExcerpt = (err instanceof Error ? err.message : String(err)).slice(0, 1000);
212
+ }
213
+ deps.store.recordEvalResult({
214
+ checkpoint_cid: checkpointCid,
215
+ slate_hash: slate.hash,
216
+ slate_version: slate.version,
217
+ instance_id: inst.instance_id,
218
+ passed,
219
+ unscorable,
220
+ code_digest: args.checkpointManifest.codeDigest,
221
+ run_at_ms: runAtMs,
222
+ test_log_excerpt: logExcerpt,
223
+ });
224
+ perTask.push({ instance_id: inst.instance_id, passed, unscorable });
225
+ }
226
+ // AC#2: compare child vs parent at the SAME slate version. A parent with no
227
+ // rows is a hard error — no cross-version compare, eval the parent first.
228
+ const parentAgg = deps.store.getEvalAggregate(parentCheckpointCid, slate.version);
229
+ if (parentAgg.scorable === 0 && parentAgg.unscorable === 0) {
230
+ throw new ParentNotEvaluatedError(parentCheckpointCid, slate.version);
231
+ }
232
+ const childAgg = deps.store.getEvalAggregate(checkpointCid, slate.version);
233
+ const comparison = compareRates({ passed: childAgg.passed, scorable: childAgg.scorable }, { passed: parentAgg.passed, scorable: parentAgg.scorable });
234
+ // Paired (matched-design) verdict — same slate scored before & after, so the
235
+ // matched McNemar test is the correct, higher-power one. Additive: only when
236
+ // the store exposes per-instance results (DR-2026-06-02-b §2a).
237
+ let paired;
238
+ if (deps.store.getEvalResults) {
239
+ const parentResults = deps.store.getEvalResults(parentCheckpointCid, slate.version);
240
+ const childResults = deps.store.getEvalResults(checkpointCid, slate.version);
241
+ paired = comparePaired(parentResults, childResults);
242
+ }
243
+ return {
244
+ perTask,
245
+ comparison,
246
+ ...(paired ? { paired } : {}),
247
+ evaluated: { implStateDir: localImplStateDir, codeDigest: evaluatedDigest, matchedCheckpoint: true },
248
+ };
249
+ }
250
+ //# sourceMappingURL=orchestrator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/eval/orchestrator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Paired (matched-design) comparison for the held-out exam.
3
+ *
4
+ * The exam scores the SAME slate against the before- and after-checkpoints, so
5
+ * the two result sets are MATCHED, not independent. The marginal test in
6
+ * `wilson.ts` (`compareRates`) compares two INDEPENDENT Wilson intervals and
7
+ * calls a delta trustworthy only when they are disjoint. On a matched design
8
+ * that is statistically wasteful: it carries the full between-instance
9
+ * difficulty variance ("this bug is just hard") in BOTH intervals, which swamps
10
+ * a real, consistent within-instance improvement. Example: a learner that flips
11
+ * 3 hard instances fail→pass and regresses none moves 4/10→7/10 — two Wilson
12
+ * intervals ([17,69]% vs [40,89]%) overlap → "within-noise", even though every
13
+ * observed change was an improvement.
14
+ *
15
+ * McNemar's test is the textbook test for matched binary data: it looks ONLY at
16
+ * the discordant pairs (instances that flipped) and asks whether the flips are
17
+ * asymmetric beyond chance. This is NOT a weaker bar — it is the CORRECT test
18
+ * for the design, and it still gates the claim on significance (exact two-sided
19
+ * p < alpha) AND on the improvement direction (more fail→pass than pass→fail).
20
+ * It is reported ALONGSIDE the conservative marginal verdict, never replacing it
21
+ * — so the exam is strengthened, never weakened (DR-2026-06-02-b §2a).
22
+ *
23
+ * R=1 (one run per instance) ships here: McNemar exact on per-instance flips.
24
+ * R>1 (per-instance pass RATES → Wilcoxon signed-rank / paired bootstrap) layers
25
+ * on once `eval_results` supports appended runs (DR-2026-06-02-b §2b).
26
+ */
27
+ /** Minimal per-instance result (subset of PerTaskResult / EvalResultRow). */
28
+ export interface PairedInput {
29
+ instance_id: string;
30
+ /** null when unscorable. */
31
+ passed: boolean | null;
32
+ unscorable: boolean;
33
+ }
34
+ export type PairedVerdict = 'trustworthy' | 'within-noise';
35
+ export interface PairedComparison {
36
+ /** Instances scorable (passed !== null) in BOTH arms — the matched pairs. */
37
+ pairs: number;
38
+ /** b: before fail → after pass (improvements). */
39
+ improved: number;
40
+ /** c: before pass → after fail (regressions). */
41
+ regressed: number;
42
+ concordantPass: number;
43
+ concordantFail: number;
44
+ /** Instances unscorable/absent in either arm — excluded from the paired test. */
45
+ excluded: number;
46
+ /** Exact two-sided McNemar p-value over the discordant pairs. */
47
+ pValue: number;
48
+ /** 'trustworthy' iff pValue < alpha AND improved > regressed; else 'within-noise'. */
49
+ verdict: PairedVerdict;
50
+ }
51
+ /**
52
+ * Exact two-sided McNemar p-value for discordant counts `b` (improvements) and
53
+ * `c` (regressions). Under H0 each discordant pair is an independent fair coin,
54
+ * so the count of one direction is Binomial(n=b+c, 0.5); the two-sided p is
55
+ * `2 * P(X <= min(b,c))`, capped at 1. No `b==c==0` division (returns 1: no
56
+ * evidence). Computed iteratively (term ratio) so it is exact and overflow-free
57
+ * for any slate size.
58
+ */
59
+ export declare function mcnemarExact(b: number, c: number): number;
60
+ /**
61
+ * Paired McNemar comparison of two matched per-instance result sets. An instance
62
+ * contributes a pair ONLY when it is scorable (passed !== null, not unscorable)
63
+ * in BOTH arms — an unscorable/missing side is excluded (honest: a disk-skip or
64
+ * harness failure is never coerced into a flip). `alpha` defaults to 0.05.
65
+ */
66
+ export declare function comparePaired(before: readonly PairedInput[], after: readonly PairedInput[], opts?: {
67
+ alpha?: number;
68
+ }): PairedComparison;
@@ -0,0 +1,93 @@
1
+ /**
2
+ * Paired (matched-design) comparison for the held-out exam.
3
+ *
4
+ * The exam scores the SAME slate against the before- and after-checkpoints, so
5
+ * the two result sets are MATCHED, not independent. The marginal test in
6
+ * `wilson.ts` (`compareRates`) compares two INDEPENDENT Wilson intervals and
7
+ * calls a delta trustworthy only when they are disjoint. On a matched design
8
+ * that is statistically wasteful: it carries the full between-instance
9
+ * difficulty variance ("this bug is just hard") in BOTH intervals, which swamps
10
+ * a real, consistent within-instance improvement. Example: a learner that flips
11
+ * 3 hard instances fail→pass and regresses none moves 4/10→7/10 — two Wilson
12
+ * intervals ([17,69]% vs [40,89]%) overlap → "within-noise", even though every
13
+ * observed change was an improvement.
14
+ *
15
+ * McNemar's test is the textbook test for matched binary data: it looks ONLY at
16
+ * the discordant pairs (instances that flipped) and asks whether the flips are
17
+ * asymmetric beyond chance. This is NOT a weaker bar — it is the CORRECT test
18
+ * for the design, and it still gates the claim on significance (exact two-sided
19
+ * p < alpha) AND on the improvement direction (more fail→pass than pass→fail).
20
+ * It is reported ALONGSIDE the conservative marginal verdict, never replacing it
21
+ * — so the exam is strengthened, never weakened (DR-2026-06-02-b §2a).
22
+ *
23
+ * R=1 (one run per instance) ships here: McNemar exact on per-instance flips.
24
+ * R>1 (per-instance pass RATES → Wilcoxon signed-rank / paired bootstrap) layers
25
+ * on once `eval_results` supports appended runs (DR-2026-06-02-b §2b).
26
+ */
27
+ /**
28
+ * Exact two-sided McNemar p-value for discordant counts `b` (improvements) and
29
+ * `c` (regressions). Under H0 each discordant pair is an independent fair coin,
30
+ * so the count of one direction is Binomial(n=b+c, 0.5); the two-sided p is
31
+ * `2 * P(X <= min(b,c))`, capped at 1. No `b==c==0` division (returns 1: no
32
+ * evidence). Computed iteratively (term ratio) so it is exact and overflow-free
33
+ * for any slate size.
34
+ */
35
+ export function mcnemarExact(b, c) {
36
+ const n = b + c;
37
+ if (n === 0)
38
+ return 1;
39
+ const k = Math.min(b, c);
40
+ // sum_{i=0}^{k} C(n,i) * 0.5^n, via prob_0 = 0.5^n, prob_i = prob_{i-1}*(n-i+1)/i.
41
+ let term = Math.pow(0.5, n); // i = 0
42
+ let cdf = term;
43
+ for (let i = 1; i <= k; i++) {
44
+ term = (term * (n - i + 1)) / i;
45
+ cdf += term;
46
+ }
47
+ return Math.min(1, 2 * cdf);
48
+ }
49
+ /**
50
+ * Paired McNemar comparison of two matched per-instance result sets. An instance
51
+ * contributes a pair ONLY when it is scorable (passed !== null, not unscorable)
52
+ * in BOTH arms — an unscorable/missing side is excluded (honest: a disk-skip or
53
+ * harness failure is never coerced into a flip). `alpha` defaults to 0.05.
54
+ */
55
+ export function comparePaired(before, after, opts = {}) {
56
+ const alpha = opts.alpha ?? 0.05;
57
+ const scorable = (r) => !r.unscorable && r.passed !== null;
58
+ const beforeById = new Map(before.map((r) => [r.instance_id, r]));
59
+ let improved = 0;
60
+ let regressed = 0;
61
+ let concordantPass = 0;
62
+ let concordantFail = 0;
63
+ let pairs = 0;
64
+ let excluded = 0;
65
+ const seen = new Set();
66
+ for (const a of after) {
67
+ seen.add(a.instance_id);
68
+ const b = beforeById.get(a.instance_id);
69
+ if (!b || !scorable(b) || !scorable(a)) {
70
+ excluded++;
71
+ continue;
72
+ }
73
+ pairs++;
74
+ const wasPass = b.passed === true;
75
+ const nowPass = a.passed === true;
76
+ if (!wasPass && nowPass)
77
+ improved++;
78
+ else if (wasPass && !nowPass)
79
+ regressed++;
80
+ else if (wasPass && nowPass)
81
+ concordantPass++;
82
+ else
83
+ concordantFail++;
84
+ }
85
+ // before-only instances (absent from after) are excluded too.
86
+ for (const b of before)
87
+ if (!seen.has(b.instance_id))
88
+ excluded++;
89
+ const pValue = mcnemarExact(improved, regressed);
90
+ const verdict = pValue < alpha && improved > regressed ? 'trustworthy' : 'within-noise';
91
+ return { pairs, improved, regressed, concordantPass, concordantFail, excluded, pValue, verdict };
92
+ }
93
+ //# sourceMappingURL=paired.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paired.js","sourceRoot":"","sources":["../../src/eval/paired.ts"],"names":[],"mappings":"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"}