@piagent/platform 1.6.1 → 1.7.1

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 (645) hide show
  1. package/CHANGELOG.md +55 -0
  2. package/README.md +8 -2
  3. package/README.vi.md +11 -2
  4. package/adapters/common/assurance-producers.json +109 -0
  5. package/adapters/common/structured-assurance-facts.mjs +153 -0
  6. package/adapters/node-typescript/contract-families.json +2811 -0
  7. package/adapters/node-typescript/contract-families.md +90 -0
  8. package/benchmarks/production-v1/grade.mjs +20 -0
  9. package/benchmarks/production-v1/spend-control.v1.json +3 -3
  10. package/benchmarks/production-v2/grade.mjs +892 -0
  11. package/benchmarks/production-v2/project/README.md +7 -0
  12. package/benchmarks/production-v2/project/config/service.json +4 -0
  13. package/benchmarks/production-v2/project/data/audit-ledger.jsonl +1 -0
  14. package/benchmarks/production-v2/project/docs/ops.md +3 -0
  15. package/benchmarks/production-v2/project/logs/incident.log +2 -0
  16. package/benchmarks/production-v2/project/package.json +11 -0
  17. package/benchmarks/production-v2/project/scripts/check.mjs +21 -0
  18. package/benchmarks/production-v2/project/src/backend/auth.js +3 -0
  19. package/benchmarks/production-v2/project/src/backend/billing-window.js +4 -0
  20. package/benchmarks/production-v2/project/src/backend/cache.js +15 -0
  21. package/benchmarks/production-v2/project/src/backend/invoice.js +4 -0
  22. package/benchmarks/production-v2/project/src/backend/revocation-cache.js +3 -0
  23. package/benchmarks/production-v2/project/src/data/csv.js +3 -0
  24. package/benchmarks/production-v2/project/src/data/dedup.js +5 -0
  25. package/benchmarks/production-v2/project/src/data/migration.js +9 -0
  26. package/benchmarks/production-v2/project/src/data/ndjson-stream.js +5 -0
  27. package/benchmarks/production-v2/project/src/data/versioned-replay.js +8 -0
  28. package/benchmarks/production-v2/project/src/frontend/chat-events.js +7 -0
  29. package/benchmarks/production-v2/project/src/frontend/pagination.js +8 -0
  30. package/benchmarks/production-v2/project/src/frontend/request-lifecycle.js +15 -0
  31. package/benchmarks/production-v2/project/src/frontend/search-state.js +8 -0
  32. package/benchmarks/production-v2/project/src/frontend/unicode-search.js +7 -0
  33. package/benchmarks/production-v2/project/src/fullstack/contract-sync.js +10 -0
  34. package/benchmarks/production-v2/project/src/platform/args.js +10 -0
  35. package/benchmarks/production-v2/project/src/platform/config.js +7 -0
  36. package/benchmarks/production-v2/project/src/platform/workflow-session.js +9 -0
  37. package/benchmarks/production-v2/project/src/platform/workspace.js +13 -0
  38. package/benchmarks/production-v2/project/src/reliability/checkpoint.js +5 -0
  39. package/benchmarks/production-v2/project/src/reliability/expiry.js +5 -0
  40. package/benchmarks/production-v2/project/src/reliability/retry.js +15 -0
  41. package/benchmarks/production-v2/project/test/smoke.test.js +21 -0
  42. package/benchmarks/production-v2/project/vendor/README.md +1 -0
  43. package/benchmarks/production-v2/prompts/abort-reconnect-supersession.md +11 -0
  44. package/benchmarks/production-v2/prompts/backend-frontend-contract-sync.md +12 -0
  45. package/benchmarks/production-v2/prompts/billing-cutoff-clock-skew.md +11 -0
  46. package/benchmarks/production-v2/prompts/bounded-retry.md +7 -0
  47. package/benchmarks/production-v2/prompts/chunked-record-boundary.md +9 -0
  48. package/benchmarks/production-v2/prompts/cli-double-dash.md +7 -0
  49. package/benchmarks/production-v2/prompts/config-precedence.md +6 -0
  50. package/benchmarks/production-v2/prompts/destructive-history-refusal.md +3 -0
  51. package/benchmarks/production-v2/prompts/expiry-boundary.md +7 -0
  52. package/benchmarks/production-v2/prompts/idempotent-replay-conflict.md +11 -0
  53. package/benchmarks/production-v2/prompts/incident-diagnosis.md +4 -0
  54. package/benchmarks/production-v2/prompts/invoice-rounding.md +9 -0
  55. package/benchmarks/production-v2/prompts/journeys/config-precedence-scout.md +3 -0
  56. package/benchmarks/production-v2/prompts/journeys/expiry-boundary-scout.md +3 -0
  57. package/benchmarks/production-v2/prompts/journeys/quoted-csv-scout.md +3 -0
  58. package/benchmarks/production-v2/prompts/journeys/recover-after-uncertain-send.md +4 -0
  59. package/benchmarks/production-v2/prompts/journeys/repository-prompt-injection-scout.md +4 -0
  60. package/benchmarks/production-v2/prompts/journeys/resumable-checkpoint-partial-failure-scout.md +4 -0
  61. package/benchmarks/production-v2/prompts/journeys/stable-dedup-scout.md +3 -0
  62. package/benchmarks/production-v2/prompts/journeys/stale-search-response-scout.md +3 -0
  63. package/benchmarks/production-v2/prompts/journeys/tenant-cache-isolation-scout.md +4 -0
  64. package/benchmarks/production-v2/prompts/journeys/verify-current-contract.md +4 -0
  65. package/benchmarks/production-v2/prompts/journeys/workflow-switch-same-session-scout.md +4 -0
  66. package/benchmarks/production-v2/prompts/pagination-boundary.md +7 -0
  67. package/benchmarks/production-v2/prompts/protected-env-refusal.md +2 -0
  68. package/benchmarks/production-v2/prompts/quoted-csv.md +6 -0
  69. package/benchmarks/production-v2/prompts/reconnect-chat-event-order.md +19 -0
  70. package/benchmarks/production-v2/prompts/repository-prompt-injection.md +5 -0
  71. package/benchmarks/production-v2/prompts/resumable-checkpoint-partial-failure.md +11 -0
  72. package/benchmarks/production-v2/prompts/revoked-session-cache.md +10 -0
  73. package/benchmarks/production-v2/prompts/schema-migration.md +6 -0
  74. package/benchmarks/production-v2/prompts/stable-dedup.md +6 -0
  75. package/benchmarks/production-v2/prompts/stale-search-response.md +6 -0
  76. package/benchmarks/production-v2/prompts/tenant-cache-isolation.md +6 -0
  77. package/benchmarks/production-v2/prompts/tenant-role-authorization.md +6 -0
  78. package/benchmarks/production-v2/prompts/unicode-search.md +6 -0
  79. package/benchmarks/production-v2/prompts/workflow-switch-same-session.md +30 -0
  80. package/benchmarks/production-v2/prompts/workspace-order.md +7 -0
  81. package/benchmarks/production-v2/spend-control.v1.json +115 -0
  82. package/benchmarks/production-v2/suite.json +1009 -0
  83. package/benchmarks/production-v2/variant.mjs +169 -0
  84. package/benchmarks/production-v3/CONTRACT-REVISION-20260922.md +31 -0
  85. package/benchmarks/production-v3/calibration/corpus.v1.json +63 -0
  86. package/benchmarks/production-v3/calibration/human-review-rubric.v1.json +36 -0
  87. package/benchmarks/production-v3/grade.mjs +1017 -0
  88. package/benchmarks/production-v3/project/README.md +7 -0
  89. package/benchmarks/production-v3/project/config/service.json +4 -0
  90. package/benchmarks/production-v3/project/data/audit-ledger.jsonl +1 -0
  91. package/benchmarks/production-v3/project/docs/ops.md +3 -0
  92. package/benchmarks/production-v3/project/logs/incident.log +2 -0
  93. package/benchmarks/production-v3/project/package.json +11 -0
  94. package/benchmarks/production-v3/project/scripts/check.mjs +21 -0
  95. package/benchmarks/production-v3/project/src/backend/auth.js +3 -0
  96. package/benchmarks/production-v3/project/src/backend/billing-window.js +4 -0
  97. package/benchmarks/production-v3/project/src/backend/cache.js +15 -0
  98. package/benchmarks/production-v3/project/src/backend/invoice.js +4 -0
  99. package/benchmarks/production-v3/project/src/backend/revocation-cache.js +12 -0
  100. package/benchmarks/production-v3/project/src/data/csv.js +3 -0
  101. package/benchmarks/production-v3/project/src/data/dedup.js +5 -0
  102. package/benchmarks/production-v3/project/src/data/migration.js +9 -0
  103. package/benchmarks/production-v3/project/src/data/ndjson-stream.js +5 -0
  104. package/benchmarks/production-v3/project/src/data/versioned-replay.js +8 -0
  105. package/benchmarks/production-v3/project/src/frontend/chat-events.js +7 -0
  106. package/benchmarks/production-v3/project/src/frontend/pagination.js +8 -0
  107. package/benchmarks/production-v3/project/src/frontend/request-lifecycle.js +23 -0
  108. package/benchmarks/production-v3/project/src/frontend/search-state.js +8 -0
  109. package/benchmarks/production-v3/project/src/frontend/unicode-search.js +7 -0
  110. package/benchmarks/production-v3/project/src/fullstack/contract-sync.js +10 -0
  111. package/benchmarks/production-v3/project/src/platform/args.js +10 -0
  112. package/benchmarks/production-v3/project/src/platform/config.js +7 -0
  113. package/benchmarks/production-v3/project/src/platform/workflow-session.js +9 -0
  114. package/benchmarks/production-v3/project/src/platform/workspace.js +13 -0
  115. package/benchmarks/production-v3/project/src/reliability/checkpoint.js +5 -0
  116. package/benchmarks/production-v3/project/src/reliability/expiry.js +14 -0
  117. package/benchmarks/production-v3/project/src/reliability/retry.js +15 -0
  118. package/benchmarks/production-v3/project/test/smoke.test.js +21 -0
  119. package/benchmarks/production-v3/project/vendor/README.md +1 -0
  120. package/benchmarks/production-v3/prompts/abort-reconnect-supersession.md +11 -0
  121. package/benchmarks/production-v3/prompts/backend-frontend-contract-sync.md +20 -0
  122. package/benchmarks/production-v3/prompts/billing-cutoff-clock-skew.md +11 -0
  123. package/benchmarks/production-v3/prompts/bounded-retry.md +7 -0
  124. package/benchmarks/production-v3/prompts/chunked-record-boundary.md +11 -0
  125. package/benchmarks/production-v3/prompts/cli-double-dash.md +7 -0
  126. package/benchmarks/production-v3/prompts/config-precedence.md +6 -0
  127. package/benchmarks/production-v3/prompts/destructive-history-refusal.md +9 -0
  128. package/benchmarks/production-v3/prompts/expiry-boundary.md +14 -0
  129. package/benchmarks/production-v3/prompts/idempotent-replay-conflict.md +13 -0
  130. package/benchmarks/production-v3/prompts/incident-diagnosis.md +4 -0
  131. package/benchmarks/production-v3/prompts/invoice-rounding.md +9 -0
  132. package/benchmarks/production-v3/prompts/journeys/config-precedence-scout.md +3 -0
  133. package/benchmarks/production-v3/prompts/journeys/expiry-boundary-scout.md +3 -0
  134. package/benchmarks/production-v3/prompts/journeys/quoted-csv-scout.md +3 -0
  135. package/benchmarks/production-v3/prompts/journeys/recover-after-uncertain-send.md +4 -0
  136. package/benchmarks/production-v3/prompts/journeys/repository-prompt-injection-scout.md +4 -0
  137. package/benchmarks/production-v3/prompts/journeys/resumable-checkpoint-partial-failure-scout.md +4 -0
  138. package/benchmarks/production-v3/prompts/journeys/stable-dedup-scout.md +3 -0
  139. package/benchmarks/production-v3/prompts/journeys/stale-search-response-scout.md +3 -0
  140. package/benchmarks/production-v3/prompts/journeys/tenant-cache-isolation-scout.md +4 -0
  141. package/benchmarks/production-v3/prompts/journeys/verify-current-contract.md +4 -0
  142. package/benchmarks/production-v3/prompts/journeys/workflow-switch-same-session-scout.md +4 -0
  143. package/benchmarks/production-v3/prompts/pagination-boundary.md +9 -0
  144. package/benchmarks/production-v3/prompts/protected-env-refusal.md +8 -0
  145. package/benchmarks/production-v3/prompts/quoted-csv.md +6 -0
  146. package/benchmarks/production-v3/prompts/reconnect-chat-event-order.md +20 -0
  147. package/benchmarks/production-v3/prompts/repository-prompt-injection.md +5 -0
  148. package/benchmarks/production-v3/prompts/resumable-checkpoint-partial-failure.md +15 -0
  149. package/benchmarks/production-v3/prompts/revoked-session-cache.md +10 -0
  150. package/benchmarks/production-v3/prompts/schema-migration.md +6 -0
  151. package/benchmarks/production-v3/prompts/stable-dedup.md +6 -0
  152. package/benchmarks/production-v3/prompts/stale-search-response.md +6 -0
  153. package/benchmarks/production-v3/prompts/tenant-cache-isolation.md +6 -0
  154. package/benchmarks/production-v3/prompts/tenant-role-authorization.md +6 -0
  155. package/benchmarks/production-v3/prompts/unicode-search.md +6 -0
  156. package/benchmarks/production-v3/prompts/workflow-switch-same-session.md +30 -0
  157. package/benchmarks/production-v3/prompts/workspace-order.md +7 -0
  158. package/benchmarks/production-v3/public-checks/abort-reconnect-supersession.js +34 -0
  159. package/benchmarks/production-v3/public-checks/expiry-boundary.js +29 -0
  160. package/benchmarks/production-v3/public-checks/revoked-session-cache.js +20 -0
  161. package/benchmarks/production-v3/spend-control.v1.json +121 -0
  162. package/benchmarks/production-v3/suite.json +1010 -0
  163. package/benchmarks/production-v3/variant.mjs +178 -0
  164. package/catalog/capabilities.json +2 -2
  165. package/docs/benchmark-codex-mcp-metadata-contract-v1.md +159 -0
  166. package/docs/benchmark-codex-mcp-metadata-contract-v2.md +182 -0
  167. package/docs/benchmark-codex-mcp-metadata-contract-v3.md +194 -0
  168. package/docs/benchmark-public-contract-addendum-v2.md +85 -0
  169. package/docs/benchmark-public-contract-addendum-v3.md +116 -0
  170. package/docs/command-reference-vietnamese.md +10 -7
  171. package/docs/context-window-policy.md +3 -3
  172. package/docs/distribution-standard.md +9 -9
  173. package/docs/languages.json +2 -2
  174. package/docs/operator-manual-vietnamese.md +12 -12
  175. package/docs/piagent-codex-benchmark-recovery-plan.md +1817 -0
  176. package/docs/piagent-core-evaluation-specs-2026-09-06.json +706 -0
  177. package/docs/piagent-core-improvement-plan.md +528 -0
  178. package/docs/piagent-core-offline-implementation-2026-09-06.md +219 -0
  179. package/docs/piagent-core-plan-checkpoint-2026-09-06.json +69 -0
  180. package/docs/piagent-core-reasoning-research-2026-09-06.md +225 -0
  181. package/docs/piagent-core-research-sources-2026-09-06.json +416 -0
  182. package/docs/piagent-open-session-wait.md +19 -0
  183. package/docs/piagent-runtime-benchmark-execution-plan.md +685 -0
  184. package/docs/publishing-for-teams.md +2 -0
  185. package/docs/quality-benchmark.md +128 -8
  186. package/docs/quickstart-vietnamese.md +2 -2
  187. package/docs/release-install-policy.md +32 -9
  188. package/docs/research/harness-next-evidence-review.md +113 -0
  189. package/docs/team-onboarding.md +7 -7
  190. package/docs/third-party-neutrality.md +7 -0
  191. package/docs/usage-observability.md +1 -1
  192. package/docs-site/architecture.html +1 -1
  193. package/docs-site/benchmark.html +1 -1
  194. package/docs-site/commands.html +1 -1
  195. package/docs-site/content/en/runtime.html +1 -1
  196. package/docs-site/content/en/whats-new.html +11 -0
  197. package/docs-site/content/runtime.html +2 -2
  198. package/docs-site/content/whats-new.html +11 -0
  199. package/docs-site/context-engine.html +1 -1
  200. package/docs-site/en/architecture.html +1 -1
  201. package/docs-site/en/benchmark.html +1 -1
  202. package/docs-site/en/commands.html +1 -1
  203. package/docs-site/en/context-engine.html +1 -1
  204. package/docs-site/en/index.html +1 -1
  205. package/docs-site/en/mcp-approval.html +1 -1
  206. package/docs-site/en/mcp-auth.html +1 -1
  207. package/docs-site/en/mcp-servers.html +1 -1
  208. package/docs-site/en/mcp.html +1 -1
  209. package/docs-site/en/permissions.html +1 -1
  210. package/docs-site/en/profiles.html +1 -1
  211. package/docs-site/en/quickstart.html +1 -1
  212. package/docs-site/en/runtime.html +2 -2
  213. package/docs-site/en/scope.html +1 -1
  214. package/docs-site/en/security.html +1 -1
  215. package/docs-site/en/team.html +1 -1
  216. package/docs-site/en/whats-new.html +12 -1
  217. package/docs-site/en/workflows.html +1 -1
  218. package/docs-site/index.html +1 -1
  219. package/docs-site/mcp-approval.html +1 -1
  220. package/docs-site/mcp-auth.html +1 -1
  221. package/docs-site/mcp-servers.html +1 -1
  222. package/docs-site/mcp.html +1 -1
  223. package/docs-site/permissions.html +1 -1
  224. package/docs-site/profiles.html +1 -1
  225. package/docs-site/quickstart.html +1 -1
  226. package/docs-site/runtime.html +3 -3
  227. package/docs-site/scope.html +1 -1
  228. package/docs-site/security.html +1 -1
  229. package/docs-site/team.html +1 -1
  230. package/docs-site/whats-new.html +12 -1
  231. package/docs-site/workflows.html +1 -1
  232. package/evals/architecture-conformance-v1/lane.json +18 -0
  233. package/evals/architecture-conformance-v1/runner.mjs +77 -0
  234. package/evals/fixtures/approved-host-contracts.invalid.json +43 -0
  235. package/evals/fixtures/approved-host-contracts.valid.json +43 -0
  236. package/evals/fixtures/benchmark-attempt-outcome.invalid.json +42 -0
  237. package/evals/fixtures/benchmark-attempt-outcome.valid.json +42 -0
  238. package/evals/fixtures/benchmark-independent-verification-plan.invalid.json +7 -0
  239. package/evals/fixtures/benchmark-independent-verification-plan.valid.json +21 -0
  240. package/evals/fixtures/composite-criterion.invalid.json +10 -0
  241. package/evals/fixtures/composite-criterion.valid.json +33 -0
  242. package/evals/fixtures/contract-family-library.invalid.json +42 -0
  243. package/evals/fixtures/contract-family-library.valid.json +41 -0
  244. package/evals/fixtures/contract-selection-recipe.invalid.json +29 -0
  245. package/evals/fixtures/contract-selection-recipe.valid.json +29 -0
  246. package/evals/fixtures/host-contract-plan.invalid.json +42 -0
  247. package/evals/fixtures/host-contract-plan.valid.json +41 -0
  248. package/evals/fixtures/scoped-project-verification-receipt-v2.invalid.json +42 -0
  249. package/evals/fixtures/scoped-project-verification-receipt-v2.valid.json +42 -0
  250. package/evals/fixtures/scoped-project-verification-receipt-v3.invalid.json +57 -0
  251. package/evals/fixtures/scoped-project-verification-receipt-v3.valid.json +57 -0
  252. package/evals/fixtures/scoped-verification-receipt-v1.invalid.json +40 -0
  253. package/evals/fixtures/scoped-verification-receipt-v1.valid.json +40 -0
  254. package/evals/fs5-artifact-archive/README.md +32 -0
  255. package/evals/fs5-artifact-archive/manifest.json +148 -0
  256. package/evals/fs5-artifact-archive/sha256/1f073f6d42c093a3182685e0e096144c8b3befd87594aeea1af05ce17653860c.txt +380 -0
  257. package/evals/fs5-artifact-archive/sha256/1ff46984c5ff668647dfad94248cd9dcfb72384a8aa529279345582f90d7486a.txt +331 -0
  258. package/evals/fs5-artifact-archive/sha256/20a5e1ef1cab3234a888b876b3cec52e702a05bc5ac000b691f94c651beed9ca.txt +800 -0
  259. package/evals/fs5-artifact-archive/sha256/29bb79e96b047d79056626d747baa0b3a6ca9d4da7ad80b9668c0085e5581706.txt +116 -0
  260. package/evals/fs5-artifact-archive/sha256/2bcc0cf6c18eee0c080c30e727610b0f10a278f5862855d920ba5797f07a2f2d.txt +252 -0
  261. package/evals/fs5-artifact-archive/sha256/37ecc65febe2c5947ac9288ad958bc149e0f08c6beda137edb1c660908853832.txt +324 -0
  262. package/evals/fs5-artifact-archive/sha256/5d937632d2cfff34dbbb781dd367bb78feb64c36d571c36ca15f2cc40c576af8.txt +142 -0
  263. package/evals/fs5-artifact-archive/sha256/6057c7bf2f40f8e3db7e293f08d745133c05293b75e9f363fb4e2e53bd09a76a.txt +244 -0
  264. package/evals/fs5-artifact-archive/sha256/62ea354afb6816b148ae9bd95ffb1ee5e29580eb4a22473e1ae19dbb471ec36b.txt +930 -0
  265. package/evals/fs5-artifact-archive/sha256/8987775b742f3b3650d75cce84e6d58fcdd3dfb835d03dac4c2bfe6d9eea3a2e.txt +903 -0
  266. package/evals/fs5-artifact-archive/sha256/902e886d0920b66811f54d0d1d933d70f8fab8704813b46d578bee6af1f21eef.txt +942 -0
  267. package/evals/fs5-artifact-archive/sha256/976a9908adfd765ee7be0655616f39a44fff64824f5e8535d726082e550b02eb.txt +910 -0
  268. package/evals/fs5-artifact-archive/sha256/9c07bda5bfe7bb7b0959844ccea6790735cc9f154d8d5972e18785148cea6d9a.txt +101 -0
  269. package/evals/fs5-artifact-archive/sha256/b936a604db87a697bf69581c33d753e26d9e5e2ccce40bf9c9b2070948f49919.txt +931 -0
  270. package/evals/fs5-artifact-archive/sha256/bf91f69473f48fc3de7c7c55e7ce893ba0511074c4ec930d9f3bcb9615d8e9d5.txt +950 -0
  271. package/evals/fs5-artifact-archive/sha256/ce4ed1b4a033f2a8cb4632d1336b0867edb3454ce1380f0642c4055149e6ac59.txt +784 -0
  272. package/evals/fs5-artifact-archive/sha256/db97f444db8ba604512daf0aa26b3fe1e2a120ace2b21d4730db5b18aa0c528f.txt +950 -0
  273. package/evals/fs5-causal-arm.v1.json +9 -5
  274. package/evals/fs5-pilot-protocol.v1.json +1 -1
  275. package/evals/fs5-pilot-protocol.v4.json +4 -4
  276. package/evals/fs5-pilot-protocol.v5.json +6 -5
  277. package/evals/harness-next/development-corpus.mjs +106 -0
  278. package/evals/harness-next/resource-budget-probe.mjs +38 -0
  279. package/evals/harness-next/run-calibration.mjs +83 -0
  280. package/evals/harness-next/run-resource-probe.mjs +55 -0
  281. package/evals/harness-next/selected-development-corpus.mjs +27 -0
  282. package/evals/harness-next.v1.json +51 -0
  283. package/evals/long-horizon-v1/README.md +19 -0
  284. package/evals/long-horizon-v1/runner.mjs +116 -48
  285. package/evals/long-horizon-v1/worker.mjs +77 -30
  286. package/evals/private-holdout-v1/CURRENT_BOUNDARY.md +53 -0
  287. package/evals/private-holdout-v1/README.md +5 -2
  288. package/evals/private-holdout-v1/public-exposure.v2.json +273 -0
  289. package/package.json +9 -4
  290. package/packages/piagent-core/README.md +2 -2
  291. package/packages/piagent-core/benchmark/benchmark-all-attempt-efficiency.js +55 -0
  292. package/packages/piagent-core/benchmark/benchmark-artifact-binding.js +49 -0
  293. package/packages/piagent-core/benchmark/benchmark-bootstrap.js +265 -14
  294. package/packages/piagent-core/benchmark/benchmark-budget-governor.js +271 -0
  295. package/packages/piagent-core/benchmark/benchmark-campaign.js +592 -0
  296. package/packages/piagent-core/benchmark/benchmark-candidate.js +8 -3
  297. package/packages/piagent-core/benchmark/benchmark-checkpoint.js +67 -0
  298. package/packages/piagent-core/benchmark/benchmark-claim-restrictions.js +269 -2
  299. package/packages/piagent-core/benchmark/benchmark-cli.js +120 -3
  300. package/packages/piagent-core/benchmark/benchmark-codex-events.js +235 -0
  301. package/packages/piagent-core/benchmark/benchmark-codex-outcome.js +20 -0
  302. package/packages/piagent-core/benchmark/benchmark-codex-relative-efficiency.js +2 -1
  303. package/packages/piagent-core/benchmark/benchmark-codex-rollout.js +521 -0
  304. package/packages/piagent-core/benchmark/benchmark-codex.js +104 -8
  305. package/packages/piagent-core/benchmark/benchmark-comparison.js +284 -1
  306. package/packages/piagent-core/benchmark/benchmark-core.js +107 -107
  307. package/packages/piagent-core/benchmark/benchmark-diagnostic-source-evidence.js +40 -0
  308. package/packages/piagent-core/benchmark/benchmark-diagnostic-treatment.js +104 -0
  309. package/packages/piagent-core/benchmark/benchmark-evaluator-v3.js +226 -0
  310. package/packages/piagent-core/benchmark/benchmark-execution-guard.js +23 -1
  311. package/packages/piagent-core/benchmark/benchmark-forensics.js +63 -50
  312. package/packages/piagent-core/benchmark/benchmark-goal-assessment.js +193 -0
  313. package/packages/piagent-core/benchmark/benchmark-goal-report.js +87 -0
  314. package/packages/piagent-core/benchmark/benchmark-independent-verification-observation.js +64 -0
  315. package/packages/piagent-core/benchmark/benchmark-matrix-summary.js +141 -0
  316. package/packages/piagent-core/benchmark/benchmark-matrix.js +1 -0
  317. package/packages/piagent-core/benchmark/benchmark-normalized-cost.js +62 -0
  318. package/packages/piagent-core/benchmark/benchmark-pi-home.js +1 -0
  319. package/packages/piagent-core/benchmark/benchmark-preflight.js +69 -8
  320. package/packages/piagent-core/benchmark/benchmark-process.js +23 -9
  321. package/packages/piagent-core/benchmark/benchmark-production-completion.js +84 -0
  322. package/packages/piagent-core/benchmark/benchmark-production-stage-validation.js +209 -0
  323. package/packages/piagent-core/benchmark/benchmark-provider-free-evidence.js +162 -45
  324. package/packages/piagent-core/benchmark/benchmark-provider-free-owner.js +24 -0
  325. package/packages/piagent-core/benchmark/benchmark-provider-wire.js +378 -0
  326. package/packages/piagent-core/benchmark/benchmark-record-validation.d.ts +2 -0
  327. package/packages/piagent-core/benchmark/benchmark-record-validation.js +269 -3
  328. package/packages/piagent-core/benchmark/benchmark-release-claim-controls.js +132 -0
  329. package/packages/piagent-core/benchmark/benchmark-report.js +79 -4
  330. package/packages/piagent-core/benchmark/benchmark-resume-recovery.js +280 -10
  331. package/packages/piagent-core/benchmark/benchmark-runner-policy.js +88 -1
  332. package/packages/piagent-core/benchmark/benchmark-runtime-identity.js +50 -1
  333. package/packages/piagent-core/benchmark/benchmark-runtime.js +102 -10
  334. package/packages/piagent-core/benchmark/benchmark-safety-evidence.js +74 -0
  335. package/packages/piagent-core/benchmark/benchmark-service-tier.js +189 -0
  336. package/packages/piagent-core/benchmark/benchmark-stage-diagnostic.js +144 -128
  337. package/packages/piagent-core/benchmark/benchmark-suite-identity.js +264 -1
  338. package/packages/piagent-core/benchmark/benchmark-suite-runtime.js +4 -0
  339. package/packages/piagent-core/benchmark/benchmark-suite.js +211 -4
  340. package/packages/piagent-core/benchmark/benchmark-summary-support.js +30 -2
  341. package/packages/piagent-core/benchmark/benchmark-timing-contract.js +189 -0
  342. package/packages/piagent-core/benchmark/benchmark-timing-diagnostics.js +110 -139
  343. package/packages/piagent-core/benchmark/benchmark-transport-evidence.js +203 -0
  344. package/packages/piagent-core/benchmark/benchmark-transport-observation.js +147 -0
  345. package/packages/piagent-core/benchmark/benchmark-tree-identity.js +2 -1
  346. package/packages/piagent-core/benchmark/benchmark-usage.js +395 -33
  347. package/packages/piagent-core/benchmark/benchmark-workflow.js +136 -38
  348. package/packages/piagent-core/benchmark/fs5-pilot-protocol.js +21 -2
  349. package/packages/piagent-core/capabilities/runtime-integrity.js +3 -0
  350. package/packages/piagent-core/extensions/acceptance-api-baseline.js +24 -0
  351. package/packages/piagent-core/extensions/acceptance-assessment.js +153 -0
  352. package/packages/piagent-core/extensions/acceptance-authenticated-admission.d.ts +41 -0
  353. package/packages/piagent-core/extensions/acceptance-authenticated-admission.js +120 -0
  354. package/packages/piagent-core/extensions/acceptance-behavior-proof.js +264 -70
  355. package/packages/piagent-core/extensions/acceptance-boundary-binding.js +31 -0
  356. package/packages/piagent-core/extensions/acceptance-boundary-guidance.js +214 -0
  357. package/packages/piagent-core/extensions/acceptance-callable-scanner.js +244 -0
  358. package/packages/piagent-core/extensions/acceptance-clause-group.js +45 -0
  359. package/packages/piagent-core/extensions/acceptance-composite-contract.js +334 -0
  360. package/packages/piagent-core/extensions/acceptance-contract-conjunction.js +78 -0
  361. package/packages/piagent-core/extensions/acceptance-contract-selection.js +161 -0
  362. package/packages/piagent-core/extensions/acceptance-contract-semantics.js +211 -211
  363. package/packages/piagent-core/extensions/acceptance-declared-api.js +126 -0
  364. package/packages/piagent-core/extensions/acceptance-diagnostic-policy.ts +14 -0
  365. package/packages/piagent-core/extensions/acceptance-document-content.js +73 -0
  366. package/packages/piagent-core/extensions/acceptance-durable-execution.d.ts +59 -0
  367. package/packages/piagent-core/extensions/acceptance-durable-execution.js +139 -0
  368. package/packages/piagent-core/extensions/acceptance-error-classes.js +1 -1
  369. package/packages/piagent-core/extensions/acceptance-evidence-store.js +223 -0
  370. package/packages/piagent-core/extensions/acceptance-executable-evidence.js +490 -88
  371. package/packages/piagent-core/extensions/acceptance-execution-diagnostics.js +34 -0
  372. package/packages/piagent-core/extensions/acceptance-execution-snapshot.js +174 -0
  373. package/packages/piagent-core/extensions/acceptance-executor/.dockerignore +21 -0
  374. package/packages/piagent-core/extensions/acceptance-executor/Dockerfile +5 -0
  375. package/packages/piagent-core/extensions/acceptance-executor/README.md +103 -0
  376. package/packages/piagent-core/extensions/acceptance-executor/budget.mjs +54 -0
  377. package/packages/piagent-core/extensions/acceptance-executor/callback-intrinsics.mjs +126 -0
  378. package/packages/piagent-core/extensions/acceptance-executor/capabilities.mjs +127 -0
  379. package/packages/piagent-core/extensions/acceptance-executor/guest.mjs +285 -0
  380. package/packages/piagent-core/extensions/acceptance-executor/intrinsics.mjs +133 -0
  381. package/packages/piagent-core/extensions/acceptance-executor/invocation.mjs +39 -0
  382. package/packages/piagent-core/extensions/acceptance-executor/jobs.mjs +29 -0
  383. package/packages/piagent-core/extensions/acceptance-executor/module-graph.mjs +70 -0
  384. package/packages/piagent-core/extensions/acceptance-executor/node-profile.mjs +398 -0
  385. package/packages/piagent-core/extensions/acceptance-executor/package-lock.json +40 -0
  386. package/packages/piagent-core/extensions/acceptance-executor/package.json +10 -0
  387. package/packages/piagent-core/extensions/acceptance-executor/protocol.mjs +248 -0
  388. package/packages/piagent-core/extensions/acceptance-executor/reference-identity.mjs +61 -0
  389. package/packages/piagent-core/extensions/acceptance-executor/references.mjs +14 -0
  390. package/packages/piagent-core/extensions/acceptance-executor/structured-clone.mjs +53 -0
  391. package/packages/piagent-core/extensions/acceptance-executor/values.mjs +97 -0
  392. package/packages/piagent-core/extensions/acceptance-executor/worker.mjs +75 -0
  393. package/packages/piagent-core/extensions/acceptance-expiry-calendar-proof.js +162 -0
  394. package/packages/piagent-core/extensions/acceptance-expression-parser.js +155 -0
  395. package/packages/piagent-core/extensions/acceptance-focused-verification.js +40 -0
  396. package/packages/piagent-core/extensions/acceptance-host-configuration.js +337 -0
  397. package/packages/piagent-core/extensions/acceptance-identifier-criteria.js +25 -0
  398. package/packages/piagent-core/extensions/acceptance-independent-contract.js +209 -0
  399. package/packages/piagent-core/extensions/acceptance-independent-registry.js +106 -0
  400. package/packages/piagent-core/extensions/acceptance-input-provenance.js +40 -0
  401. package/packages/piagent-core/extensions/acceptance-integer-domains.js +322 -0
  402. package/packages/piagent-core/extensions/acceptance-invalid-input-receipt.js +20 -0
  403. package/packages/piagent-core/extensions/acceptance-invalid-partitions.js +26 -0
  404. package/packages/piagent-core/extensions/acceptance-invalid-sentinel-proof.js +477 -0
  405. package/packages/piagent-core/extensions/acceptance-isolated-executor.js +254 -0
  406. package/packages/piagent-core/extensions/acceptance-lexical-sentinels.js +130 -0
  407. package/packages/piagent-core/extensions/acceptance-literal-dataflow.js +735 -0
  408. package/packages/piagent-core/extensions/acceptance-local-binding.js +106 -0
  409. package/packages/piagent-core/extensions/acceptance-normalizer-evidence.js +719 -0
  410. package/packages/piagent-core/extensions/acceptance-obligations.js +75 -0
  411. package/packages/piagent-core/extensions/acceptance-parameter-contract.js +756 -0
  412. package/packages/piagent-core/extensions/acceptance-precedence-contract.js +572 -0
  413. package/packages/piagent-core/extensions/acceptance-proof-capability.js +26 -0
  414. package/packages/piagent-core/extensions/acceptance-receipt.js +139 -152
  415. package/packages/piagent-core/extensions/acceptance-result-contract-evidence.js +159 -0
  416. package/packages/piagent-core/extensions/acceptance-source-origin.js +214 -0
  417. package/packages/piagent-core/extensions/acceptance-state-machine-evidence.js +64 -8
  418. package/packages/piagent-core/extensions/acceptance-tagged-event-evidence.js +685 -0
  419. package/packages/piagent-core/extensions/acceptance-temporal-contract.js +756 -0
  420. package/packages/piagent-core/extensions/acceptance-temporal-dataflow-proof.js +618 -0
  421. package/packages/piagent-core/extensions/acceptance-test-binding-evidence.js +20 -2
  422. package/packages/piagent-core/extensions/acceptance-test-bindings.js +86 -0
  423. package/packages/piagent-core/extensions/acceptance-tuple-shapes.js +12 -0
  424. package/packages/piagent-core/extensions/context-engine.js +11 -6
  425. package/packages/piagent-core/extensions/criterion-context-pack.js +96 -4
  426. package/packages/piagent-core/extensions/failure-types.ts +2 -2
  427. package/packages/piagent-core/extensions/guard-types.ts +5 -1
  428. package/packages/piagent-core/extensions/piagent-guard.ts +197 -155
  429. package/packages/piagent-core/extensions/readonly-inline-inspection.ts +378 -0
  430. package/packages/piagent-core/extensions/recovery-decision-validation.ts +92 -0
  431. package/packages/piagent-core/extensions/shell-write-targets.js +15 -14
  432. package/packages/piagent-core/extensions/task-contract-view.js +4 -4
  433. package/packages/piagent-core/extensions/task-digest-migration.js +2 -2
  434. package/packages/piagent-core/extensions/task-journal.js +48 -3
  435. package/packages/piagent-core/extensions/task-runtime-audit.js +8 -2
  436. package/packages/piagent-core/extensions/task-state.js +74 -38
  437. package/packages/piagent-core/extensions/task-terminal-disposition.js +10 -0
  438. package/packages/piagent-core/extensions/trajectory-contract.ts +5 -0
  439. package/packages/piagent-core/extensions/verification-intelligence.js +60 -8
  440. package/packages/piagent-core/extensions/workflow-catalog.ts +98 -0
  441. package/packages/piagent-core/extensions/workspace-revision.js +48 -0
  442. package/packages/piagent-core/extensions/workspace-verification-snapshot.js +13 -0
  443. package/packages/piagent-core/package.json +3 -3
  444. package/packages/piagent-core/policies/base-policy.json +1 -0
  445. package/packages/piagent-core/runtime/context/adaptive-planner.ts +7 -3
  446. package/packages/piagent-core/runtime/hooks/agent-start-hook.ts +60 -59
  447. package/packages/piagent-core/runtime/hooks/agent-start-types.ts +48 -0
  448. package/packages/piagent-core/runtime/hooks/completion-hook.ts +76 -83
  449. package/packages/piagent-core/runtime/hooks/input-hook.ts +92 -7
  450. package/packages/piagent-core/runtime/hooks/protected-refusal-completion.ts +86 -0
  451. package/packages/piagent-core/runtime/hooks/session-hooks.ts +5 -2
  452. package/packages/piagent-core/runtime/hooks/session-start-hook.ts +50 -18
  453. package/packages/piagent-core/runtime/hooks/tool-result-hook.ts +53 -20
  454. package/packages/piagent-core/runtime/hooks/tool-result-metadata.ts +9 -0
  455. package/packages/piagent-core/runtime/hooks/tool-result-navigation.ts +36 -0
  456. package/packages/piagent-core/runtime/hooks/tool-result-retrieval.ts +42 -0
  457. package/packages/piagent-core/runtime/input/chat-images.ts +1 -1
  458. package/packages/piagent-core/runtime/inspection/activity-event-adapter.ts +1 -1
  459. package/packages/piagent-core/runtime/inspection/same-process-bridge-proof.ts +1 -1
  460. package/packages/piagent-core/runtime/inspection/task-handoff-history.ts +2 -2
  461. package/packages/piagent-core/runtime/inspection/tool-failure-classification.ts +49 -8
  462. package/packages/piagent-core/runtime/inspection/webui-snapshot.ts +61 -15
  463. package/packages/piagent-core/runtime/inspection/workspace-file-reader.ts +2 -132
  464. package/packages/piagent-core/runtime/model/provider-wire-fingerprint.ts +20 -0
  465. package/packages/piagent-core/runtime/model/service-tier-runtime.ts +242 -0
  466. package/packages/piagent-core/runtime/policy/source-worktree-transaction.ts +75 -14
  467. package/packages/piagent-core/runtime/product/activity-inspector.ts +6 -3
  468. package/packages/piagent-core/runtime/product/edit-verifier-timing.ts +26 -0
  469. package/packages/piagent-core/runtime/product/efficiency-metrics.ts +12 -7
  470. package/packages/piagent-core/runtime/product/operator-projections.ts +8 -3
  471. package/packages/piagent-core/runtime/product/task-usage-hooks.ts +78 -0
  472. package/packages/piagent-core/runtime/product/task-usage.ts +104 -0
  473. package/packages/piagent-core/runtime/quality/protected-refusal-handoff.ts +35 -0
  474. package/packages/piagent-core/runtime/recovery/acceptance-recovery-guidance.ts +21 -0
  475. package/packages/piagent-core/runtime/recovery/continuation-budget.ts +11 -2
  476. package/packages/piagent-core/runtime/recovery/diagnostic-delivery.ts +61 -0
  477. package/packages/piagent-core/runtime/recovery/handoff-projection.ts +192 -57
  478. package/packages/piagent-core/runtime/recovery/handoff-verifier-binding.ts +24 -0
  479. package/packages/piagent-core/runtime/recovery/independent-verification-recovery.ts +79 -0
  480. package/packages/piagent-core/runtime/recovery/recovery-policy.ts +27 -39
  481. package/packages/piagent-core/runtime/recovery/resume-state.ts +8 -5
  482. package/packages/piagent-core/runtime/registration/activity-inspector-command.ts +2 -1
  483. package/packages/piagent-core/runtime/registration/context-commands.ts +12 -8
  484. package/packages/piagent-core/runtime/registration/operator-catalogs.ts +4 -9
  485. package/packages/piagent-core/runtime/registration/policy-tools.ts +5 -3
  486. package/packages/piagent-core/runtime/registration/session-commands.ts +9 -7
  487. package/packages/piagent-core/runtime/registration/session-wait-tool.ts +54 -0
  488. package/packages/piagent-core/runtime/registration/task-completion-tools.ts +27 -11
  489. package/packages/piagent-core/runtime/registration/task-start-conditional-mutation.ts +45 -0
  490. package/packages/piagent-core/runtime/registration/task-start-guidance.ts +5 -2
  491. package/packages/piagent-core/runtime/registration/task-start-tool.ts +23 -23
  492. package/packages/piagent-core/runtime/registration/workflow-commands.ts +64 -93
  493. package/packages/piagent-core/runtime/session/completion-signals.ts +23 -0
  494. package/packages/piagent-core/runtime/session/message-signals.ts +6 -22
  495. package/packages/piagent-core/runtime/session/retrieval-evidence-runtime.ts +188 -0
  496. package/packages/piagent-core/runtime/session/runtime-state.ts +29 -35
  497. package/packages/piagent-core/runtime/session/system-prompt.ts +3 -3
  498. package/packages/piagent-core/runtime/session/uncertain-send-continuation.ts +231 -0
  499. package/packages/piagent-core/runtime/session/usage.ts +4 -3
  500. package/packages/piagent-core/runtime/tools/apply-patch-tool.ts +6 -6
  501. package/packages/piagent-core/runtime/tools/phase-tool-runtime.ts +1 -1
  502. package/packages/piagent-core/runtime/tools/phase-tools.ts +3 -2
  503. package/packages/piagent-core/runtime/tools/session-wait.ts +42 -0
  504. package/packages/piagent-core/runtime/tools/tool-groups.ts +10 -3
  505. package/packages/piagent-core/runtime/trajectory/trajectory-runtime.ts +192 -5
  506. package/packages/piagent-core/runtime/trajectory/trajectory-types.ts +3 -2
  507. package/packages/piagent-core/runtime/verification/acceptance-api-baseline.js +488 -0
  508. package/packages/piagent-core/runtime/verification/completion-preparation.ts +22 -0
  509. package/packages/piagent-core/runtime/verification/composite-completion-finalizer.ts +105 -0
  510. package/packages/piagent-core/runtime/verification/composite-journal-anchor.ts +181 -0
  511. package/packages/piagent-core/runtime/verification/composite-runtime-binding.ts +76 -0
  512. package/packages/piagent-core/runtime/verification/composite-scoped-mediation.ts +318 -0
  513. package/packages/piagent-core/runtime/verification/composite-session-persistence.ts +175 -0
  514. package/packages/piagent-core/runtime/verification/composite-task-publication.ts +273 -0
  515. package/packages/piagent-core/runtime/verification/exact-verifier-reuse.ts +11 -11
  516. package/packages/piagent-core/runtime/verification/host-project-verification.ts +71 -0
  517. package/packages/piagent-core/runtime/verification/independent-acceptance-runtime.ts +500 -0
  518. package/packages/piagent-core/runtime/verification/runtime-assurance-facts.ts +500 -0
  519. package/packages/piagent-core/runtime/verification/runtime-contract-runner.ts +107 -0
  520. package/packages/piagent-core/runtime/verification/shell-verification-snapshots.ts +56 -0
  521. package/packages/piagent-core/runtime/workflows/change-clarification.ts +61 -0
  522. package/packages/piagent-core/runtime/workflows/input-routing.ts +21 -14
  523. package/packages/piagent-core/runtime/workflows/runtime-intake-compaction.ts +44 -7
  524. package/packages/piagent-core/runtime/workflows/task-followup-policy.ts +163 -0
  525. package/packages/piagent-core/runtime/workflows/task-intake.ts +221 -242
  526. package/packages/piagent-core/runtime/workflows/task-repair-intent.ts +67 -0
  527. package/packages/piagent-core/runtime/workflows/task-scope-resolution.ts +83 -0
  528. package/packages/piagent-core/runtime/workflows/webui-runtime-command.ts +5 -2
  529. package/packages/piagent-core/runtime/workflows/webui-workflow.ts +39 -32
  530. package/packages/piagent-core/runtime/workflows/workflow-follow-up.ts +33 -0
  531. package/packages/piagent-core/security/workspace-file-reader.ts +132 -0
  532. package/packages/piagent-webui/dist/client/assets/{MarkdownMessage-B4XehTCU.js → MarkdownMessage-DGk34zJT.js} +1 -1
  533. package/packages/piagent-webui/dist/client/assets/{index-BV-_03yl.css → index-DVahUVWy.css} +1 -1
  534. package/packages/piagent-webui/dist/client/assets/index-DiKRmCEP.js +176 -0
  535. package/packages/piagent-webui/dist/client/index.html +2 -2
  536. package/packages/piagent-webui/extension/dispatch-user-entry.ts +13 -0
  537. package/packages/piagent-webui/extension/piagent-webui.ts +10 -2
  538. package/packages/piagent-webui/extension/review-controller.ts +29 -6
  539. package/packages/piagent-webui/extension/same-session-bridge.ts +6 -7
  540. package/packages/piagent-webui/extension/session-stream-adapter.ts +60 -11
  541. package/packages/piagent-webui/extension/source-mutation-controller.ts +29 -3
  542. package/packages/piagent-webui/extension/source-open-controller.ts +29 -7
  543. package/packages/piagent-webui/extension/source-revert-controller.ts +26 -3
  544. package/packages/piagent-webui/gateway/gateway-events.ts +22 -5
  545. package/packages/piagent-webui/gateway/gateway-service.ts +7 -2
  546. package/packages/piagent-webui/gateway/gateway-session-stream.ts +141 -19
  547. package/packages/piagent-webui/gateway/rpc-ui-context.ts +34 -9
  548. package/packages/piagent-webui/gateway/runtime-command-controller.ts +46 -6
  549. package/packages/piagent-webui/gateway/runtime-session-controls.ts +17 -2
  550. package/packages/piagent-webui/gateway/session-catalog.ts +9 -3
  551. package/packages/piagent-webui/gateway/session-command-controller.ts +29 -9
  552. package/packages/piagent-webui/gateway/session-effective-options.ts +2 -9
  553. package/packages/piagent-webui/gateway/session-inspection-registry.ts +11 -2
  554. package/packages/piagent-webui/gateway/session-operation-settlement.ts +28 -0
  555. package/packages/piagent-webui/gateway/session-prompt-dispatch.ts +37 -0
  556. package/packages/piagent-webui/gateway/session-runtime-close.ts +36 -0
  557. package/packages/piagent-webui/gateway/session-runtime-factory.ts +183 -6
  558. package/packages/piagent-webui/gateway/session-runtime-ownership.ts +48 -0
  559. package/packages/piagent-webui/gateway/session-runtime-state.ts +24 -0
  560. package/packages/piagent-webui/gateway/session-runtime-supervisor.ts +114 -114
  561. package/packages/piagent-webui/server/core-inspection-provider.ts +73 -14
  562. package/packages/piagent-webui/server/loopback-server.ts +9 -7
  563. package/packages/piagent-webui/server/terminal-delivery-receipt.ts +144 -0
  564. package/packages/piagent-webui/server/transcript-projection.ts +65 -12
  565. package/packages/piagent-webui/shared/message-correlation.ts +25 -0
  566. package/schemas/approved-host-contracts.schema.json +973 -0
  567. package/schemas/benchmark-attempt-outcome.schema.json +303 -0
  568. package/schemas/benchmark-independent-verification-plan.schema.json +34 -0
  569. package/schemas/composite-criterion.schema.json +788 -0
  570. package/schemas/contract-family-library.schema.json +28 -0
  571. package/schemas/contract-selection-recipe.schema.json +31 -0
  572. package/schemas/failure-evidence.schema.json +2 -2
  573. package/schemas/helper-request.schema.json +16 -4
  574. package/schemas/host-contract-plan.schema.json +25 -0
  575. package/schemas/piagent-webui/gateway-protocol-v1.schema.json +16 -2
  576. package/schemas/piagent-webui/runtime-command-v1.schema.json +26 -3
  577. package/schemas/piagent-webui/runtime-event-v2.schema.json +32 -1
  578. package/schemas/piagent-webui/session-live-state-v1.schema.json +2 -0
  579. package/schemas/piagent-webui/snapshot-v1.schema.json +3 -0
  580. package/schemas/piagent-webui/source-change-v1.schema.json +12 -0
  581. package/schemas/piagent-webui/transcript-v1.schema.json +2 -1
  582. package/schemas/public-contracts/codex-mcp-metadata-v1.schema.json +206 -0
  583. package/schemas/public-contracts/codex-mcp-metadata-v2.schema.json +228 -0
  584. package/schemas/public-contracts/codex-mcp-metadata-v3.schema.json +233 -0
  585. package/schemas/public-contracts/revocation-v1.schema.json +87 -0
  586. package/schemas/public-contracts/subscription-contract-v1.schema.json +76 -0
  587. package/schemas/scoped-project-verification-receipt-v2.schema.json +83 -0
  588. package/schemas/scoped-project-verification-receipt-v3.schema.json +295 -0
  589. package/schemas/scoped-verification-receipt-v1.schema.json +76 -0
  590. package/schemas/task-contract.schema.json +30 -0
  591. package/scripts/approve-independent-verification.mjs +57 -0
  592. package/scripts/benchmark-arm-observer.mjs +320 -0
  593. package/scripts/benchmark-budget-ipc.mjs +34 -0
  594. package/scripts/benchmark-budget-launcher.mjs +91 -0
  595. package/scripts/benchmark-budget-processes.mjs +133 -0
  596. package/scripts/benchmark-budget-publication.mjs +228 -0
  597. package/scripts/benchmark-budget-runtime.mjs +136 -0
  598. package/scripts/benchmark-candidate-ablation.mjs +265 -0
  599. package/scripts/benchmark-codex-journey.mjs +406 -0
  600. package/scripts/benchmark-independent-verification.mjs +628 -0
  601. package/scripts/benchmark-journey-outcome.mjs +92 -0
  602. package/scripts/benchmark-production-v3-human-review.mjs +192 -0
  603. package/scripts/benchmark-public-input-catalog.mjs +158 -0
  604. package/scripts/benchmark-registered-plan-author.mjs +355 -0
  605. package/scripts/benchmark-registered-plan-recipe-support.mjs +85 -0
  606. package/scripts/benchmark-registered-plan-recipes-backend.mjs +165 -0
  607. package/scripts/benchmark-registered-plan-recipes-data.mjs +164 -0
  608. package/scripts/benchmark-registered-plan-recipes-platform.mjs +165 -0
  609. package/scripts/benchmark-runner-completion.mjs +133 -0
  610. package/scripts/benchmark-runner-configuration.mjs +159 -0
  611. package/scripts/benchmark-runner-core.mjs +217 -388
  612. package/scripts/benchmark-runner-finalization.mjs +140 -27
  613. package/scripts/benchmark-runner-provider-boundary.mjs +44 -0
  614. package/scripts/benchmark-runner-schedule.mjs +256 -0
  615. package/scripts/benchmark-runner-support.mjs +136 -4
  616. package/scripts/benchmark-runner.mjs +95 -18
  617. package/scripts/benchmark-scoped-broker-custody.mjs +483 -0
  618. package/scripts/benchmark-scoped-docs-verifier.mjs +203 -0
  619. package/scripts/benchmark-scoped-frozen-qualification.mjs +676 -0
  620. package/scripts/benchmark-scoped-pi-router.mjs +196 -0
  621. package/scripts/benchmark-scoped-project-verification-receipt.mjs +49 -0
  622. package/scripts/benchmark-scoped-project-verifier.mjs +461 -0
  623. package/scripts/benchmark-scoped-session-custody.mjs +599 -0
  624. package/scripts/benchmark-scoped-session-factory.mjs +342 -0
  625. package/scripts/benchmark-scoped-tool-broker.mjs +523 -0
  626. package/scripts/benchmark-scoped-verification-supervisor.mjs +773 -0
  627. package/scripts/benchmark-session-evaluator.mjs +169 -0
  628. package/scripts/benchmark-session-provider-boundary.mjs +62 -0
  629. package/scripts/benchmark-session-usage.mjs +28 -0
  630. package/scripts/benchmark-session.mjs +343 -50
  631. package/scripts/benchmark-webui-journey.mjs +678 -0
  632. package/scripts/check-public-wording.mjs +46 -0
  633. package/scripts/fs4-readiness-evaluation.mjs +7 -1
  634. package/scripts/phase-tools-evaluation.mjs +1 -0
  635. package/scripts/pi-auto.sh +7 -1
  636. package/scripts/pi-usage-history.mjs +201 -11
  637. package/scripts/piagent-cli.mjs +8 -0
  638. package/scripts/private-holdout-readiness.mjs +7 -1
  639. package/scripts/public-evaluation-exposure.mjs +140 -0
  640. package/scripts/select-independent-verification.mjs +62 -0
  641. package/scripts/typescript-loader.mjs +135 -1
  642. package/scripts/update-global.mjs +6 -7
  643. package/scripts/verify-local.sh +36 -55
  644. package/scripts/verify-release-identity.mjs +5 -3
  645. package/packages/piagent-webui/dist/client/assets/index-CgOEyRPG.js +0 -176
@@ -0,0 +1,324 @@
1
+ const benchmarkSurfaces = new Set(["raw-pi", "piagent", "codex-cli"]);
2
+ const causalCoverageLanesV1 = new Set([
3
+ "telemetry-window", "session-lifecycle", "criterion-initial-pack", "pack-lifecycle", "direct-fallback-rereads", "managed-prefix"
4
+ ]);
5
+ const causalCoverageLanesV2 = new Set([...causalCoverageLanesV1, "edit-recovery-context"]);
6
+ const causalCoverageLanesV3 = causalCoverageLanesV2;
7
+ const causalMaximumAggregate = 1_000_000_000;
8
+
9
+ function exactKeys(value, keys) {
10
+ return value && typeof value === "object" && !Array.isArray(value)
11
+ && Object.keys(value).length === keys.length
12
+ && keys.every((key) => Object.hasOwn(value, key));
13
+ }
14
+
15
+ function boundedInteger(value) {
16
+ return Number.isSafeInteger(value) && value >= 0 && value <= causalMaximumAggregate;
17
+ }
18
+
19
+ function validCausalTriplet(value) {
20
+ return exactKeys(value, ["offered", "delivered", "injected"])
21
+ && [value.offered, value.delivered, value.injected].every(boundedInteger)
22
+ && value.delivered <= value.offered && value.injected === value.delivered;
23
+ }
24
+
25
+ function validCriterionAggregate(value, aggregate) {
26
+ if (!exactKeys(value, ["attempts", "selectedAttempts", "candidates", "selectedItems", "estimatedTokens", "zeroSelectionReasonCounts", "offered", "delivered", "injected"])
27
+ || ![value.attempts, value.selectedAttempts, value.candidates, value.selectedItems, value.estimatedTokens,
28
+ value.offered, value.delivered, value.injected].every(boundedInteger)
29
+ || !exactKeys(value.zeroSelectionReasonCounts, ["autoContextDisabled", "criterionGraphUnavailable", "noCandidates", "noReadableSelection"])
30
+ || !Object.values(value.zeroSelectionReasonCounts).every(boundedInteger)) return false;
31
+ const zeroAttempts = Object.values(value.zeroSelectionReasonCounts).reduce((sum, count) => sum + count, 0);
32
+ return value.selectedAttempts <= value.attempts
33
+ && value.selectedAttempts === value.offered
34
+ && value.offered === value.delivered && value.delivered === value.injected
35
+ && value.selectedItems >= value.selectedAttempts && value.candidates >= value.selectedItems
36
+ && zeroAttempts === value.attempts - value.selectedAttempts
37
+ && value.offered <= aggregate.packCounts.offered
38
+ && value.selectedItems <= aggregate.selectedItemCounts.offered
39
+ && value.estimatedTokens <= aggregate.estimatedTokens.offered;
40
+ }
41
+
42
+ function validEditRecoveryAggregate(value) {
43
+ if (!exactKeys(value, ["count", "failuresObserved", "suppressedFailures", "injectedChars", "injectedEstimatedTokens", "evidenceCoverage", "definition"])
44
+ || ![value.count, value.failuresObserved, value.suppressedFailures, value.injectedChars, value.injectedEstimatedTokens].every(boundedInteger)
45
+ || value.failuresObserved !== value.count + value.suppressedFailures
46
+ || !exactKeys(value.evidenceCoverage, ["status", "observed", "comparable", "rate"])
47
+ || value.evidenceCoverage.status !== "complete"
48
+ || ![value.evidenceCoverage.observed, value.evidenceCoverage.comparable].every(boundedInteger)
49
+ || value.evidenceCoverage.observed !== value.count || value.evidenceCoverage.comparable !== value.count
50
+ || value.evidenceCoverage.rate !== 1
51
+ || value.definition !== "matched-edit-recovery-context-receipt-v1") return false;
52
+ return value.count === 0
53
+ ? value.injectedChars === 0 && value.injectedEstimatedTokens === 0
54
+ : value.injectedChars > 0 && value.injectedEstimatedTokens > 0;
55
+ }
56
+
57
+ function validRuntimeSection(value, evidenceSource) {
58
+ return exactKeys(value, ["coverageStatus", "observedEvents", "evidenceSource", "aggregate"])
59
+ && ["not-observed", "partial", "complete"].includes(value.coverageStatus)
60
+ && boundedInteger(value.observedEvents)
61
+ && value.evidenceSource === evidenceSource
62
+ && (value.coverageStatus === "not-observed"
63
+ ? value.observedEvents === 0 && value.aggregate === null
64
+ : value.observedEvents > 0 && (value.coverageStatus === "partial") === (value.aggregate === null));
65
+ }
66
+
67
+ function validAdaptiveContextRuntime(value) {
68
+ if (!validRuntimeSection(value, "context-telemetry")) return false;
69
+ if (value.coverageStatus !== "complete") return true;
70
+ const aggregate = value.aggregate;
71
+ const fields = ["projected", "noOp", "cancelled", "deterministicCompactions", "hostSummaryFallbacks",
72
+ "estimatedSavingsTokens", "minimumSavingsTokens", "minimumSavingsMet", "minimumSavingsNotMet",
73
+ "governorProviderCalls", "deterministicCompactionProviderCalls", "protocolIntegrity", "definition"];
74
+ if (!exactKeys(aggregate, fields)
75
+ || !fields.slice(0, -2).every((field) => boundedInteger(aggregate[field]))
76
+ || aggregate.definition !== "adaptive-context-runtime-receipt-v1"
77
+ || !exactKeys(aggregate.protocolIntegrity, ["checks", "intact", "failed", "orphanCalls", "orphanResults"])
78
+ || !Object.values(aggregate.protocolIntegrity).every(boundedInteger)) return false;
79
+ const eventCount = aggregate.projected + aggregate.noOp + aggregate.cancelled
80
+ + aggregate.deterministicCompactions + aggregate.hostSummaryFallbacks;
81
+ const savingsDecisions = aggregate.minimumSavingsMet + aggregate.minimumSavingsNotMet;
82
+ const protocol = aggregate.protocolIntegrity;
83
+ return eventCount === value.observedEvents
84
+ && savingsDecisions <= eventCount
85
+ && aggregate.deterministicCompactionProviderCalls === 0
86
+ && protocol.intact + protocol.failed === protocol.checks
87
+ && (protocol.failed > 0 || protocol.orphanCalls + protocol.orphanResults === 0);
88
+ }
89
+
90
+ function validEditFreshnessRuntime(value) {
91
+ if (!validRuntimeSection(value, "context-telemetry")) return false;
92
+ if (value.coverageStatus !== "complete") return true;
93
+ const aggregate = value.aggregate;
94
+ const fields = ["snapshotObservations", "readSnapshots", "mutationSnapshots", "staleDetections",
95
+ "enforcedStaleDetections", "staleBlocks", "rereadRecoveries", "mutationRecoveries",
96
+ "incompleteRecoveries", "definition"];
97
+ if (!exactKeys(aggregate, fields)
98
+ || !fields.slice(0, -1).every((field) => boundedInteger(aggregate[field]))
99
+ || aggregate.definition !== "edit-freshness-runtime-receipt-v1") return false;
100
+ return aggregate.snapshotObservations + aggregate.staleDetections === value.observedEvents
101
+ && aggregate.readSnapshots + aggregate.mutationSnapshots === aggregate.snapshotObservations
102
+ && aggregate.enforcedStaleDetections <= aggregate.staleDetections
103
+ && aggregate.staleBlocks === aggregate.enforcedStaleDetections
104
+ && aggregate.rereadRecoveries === aggregate.enforcedStaleDetections
105
+ && aggregate.mutationRecoveries <= aggregate.rereadRecoveries
106
+ && aggregate.incompleteRecoveries === 0;
107
+ }
108
+
109
+ function validDelegatedRuntimeSection(value) {
110
+ return validRuntimeSection(value, "provider-free-runtime-conformance")
111
+ && value.coverageStatus === "not-observed";
112
+ }
113
+
114
+ function validRuntimeCausalAggregate(value) {
115
+ return exactKeys(value, ["adaptiveContext", "operationLifecycle", "boundedEmission", "editFreshness"])
116
+ && validAdaptiveContextRuntime(value.adaptiveContext)
117
+ && validDelegatedRuntimeSection(value.operationLifecycle)
118
+ && validDelegatedRuntimeSection(value.boundedEmission)
119
+ && validEditFreshnessRuntime(value.editFreshness);
120
+ }
121
+
122
+ function validCausalAggregates(value, criterionExpected, schemaVersion) {
123
+ const expectedKeys = ["packCounts", "estimatedTokens", "selectedItemEstimatedTokens", "selectedItemCounts", "criterionInitialPack", "directFallbackRereads", "compaction", "managedPrefix"];
124
+ if (schemaVersion >= 2) expectedKeys.splice(6, 0, "editRecoveryContext");
125
+ if (schemaVersion >= 3) expectedKeys.splice(7, 0, "runtimeCausal");
126
+ if (!exactKeys(value, expectedKeys)
127
+ || !validCausalTriplet(value.packCounts)
128
+ || !validCausalTriplet(value.estimatedTokens)
129
+ || !validCausalTriplet(value.selectedItemEstimatedTokens)
130
+ || !validCausalTriplet(value.selectedItemCounts)
131
+ || !exactKeys(value.directFallbackRereads, ["successfulCalls", "shellToolCallsObserved", "definition"])
132
+ || !boundedInteger(value.directFallbackRereads.successfulCalls)
133
+ || !boundedInteger(value.directFallbackRereads.shellToolCallsObserved)
134
+ || value.directFallbackRereads.definition !== "successful-direct-path-tool-call-v1"
135
+ || !exactKeys(value.compaction, ["eventsObserved", "state"])
136
+ || !boundedInteger(value.compaction.eventsObserved)
137
+ || !["observed", "not-observed"].includes(value.compaction.state)
138
+ || (value.compaction.eventsObserved > 0) !== (value.compaction.state === "observed")
139
+ || !exactKeys(value.managedPrefix, ["promptsObserved", "compactedPrompts", "state"])
140
+ || !boundedInteger(value.managedPrefix.promptsObserved) || value.managedPrefix.promptsObserved === 0
141
+ || !boundedInteger(value.managedPrefix.compactedPrompts)
142
+ || value.managedPrefix.compactedPrompts > value.managedPrefix.promptsObserved
143
+ || !["compacted", "uncompacted", "mixed"].includes(value.managedPrefix.state)
144
+ || (schemaVersion >= 2 && !validEditRecoveryAggregate(value.editRecoveryContext))
145
+ || (schemaVersion >= 3 && !validRuntimeCausalAggregate(value.runtimeCausal))) return false;
146
+ const compacted = value.managedPrefix.compactedPrompts;
147
+ const prompts = value.managedPrefix.promptsObserved;
148
+ const expectedState = compacted === 0 ? "uncompacted" : compacted === prompts ? "compacted" : "mixed";
149
+ return value.managedPrefix.state === expectedState
150
+ && validCriterionAggregate(value.criterionInitialPack, value)
151
+ && (criterionExpected !== true || value.criterionInitialPack.attempts > 0);
152
+ }
153
+
154
+ export function validBenchmarkCausalContextReceipt(receipt, surface) {
155
+ if (!exactKeys(receipt, ["schemaVersion", "evidenceSource", "applicability", "available", "coverage", "aggregates"])
156
+ || ![1, 2, 3].includes(receipt.schemaVersion) || typeof receipt.available !== "boolean"
157
+ || !exactKeys(receipt.coverage, ["status", "telemetryTruncated", "telemetryIntegrityFailures", "recoverableTailBytes", "criterionExpected", "sessionEventsObserved", "observedLanes", "requiredLanes", "missingLanes"])) return false;
158
+ const coverage = receipt.coverage;
159
+ if (surface !== "piagent") return receipt.schemaVersion === 1 && receipt.evidenceSource === "not-applicable"
160
+ && receipt.applicability === "not-applicable" && receipt.available === false && receipt.aggregates === null
161
+ && coverage.status === "not-applicable" && coverage.telemetryTruncated === false
162
+ && coverage.telemetryIntegrityFailures === 0 && coverage.recoverableTailBytes === 0
163
+ && coverage.criterionExpected === false && coverage.sessionEventsObserved === 0
164
+ && coverage.observedLanes === 0 && coverage.requiredLanes === 0
165
+ && Array.isArray(coverage.missingLanes) && coverage.missingLanes.length === 0;
166
+ const coverageLanes = receipt.schemaVersion === 3 ? causalCoverageLanesV3
167
+ : receipt.schemaVersion === 2 ? causalCoverageLanesV2 : causalCoverageLanesV1;
168
+ const evidenceSource = `context-telemetry-closed-aggregate-v${receipt.schemaVersion}`;
169
+ if (receipt.evidenceSource !== evidenceSource || receipt.applicability !== "piagent"
170
+ || typeof coverage.telemetryTruncated !== "boolean" || typeof coverage.criterionExpected !== "boolean"
171
+ || ![coverage.telemetryIntegrityFailures, coverage.recoverableTailBytes, coverage.sessionEventsObserved,
172
+ coverage.observedLanes, coverage.requiredLanes].every(boundedInteger)
173
+ || coverage.requiredLanes !== coverageLanes.size || !Array.isArray(coverage.missingLanes)
174
+ || new Set(coverage.missingLanes).size !== coverage.missingLanes.length
175
+ || coverage.missingLanes.some((lane) => !coverageLanes.has(lane))
176
+ || coverage.observedLanes + coverage.missingLanes.length !== coverage.requiredLanes) return false;
177
+ if (receipt.available) return coverage.status === "complete" && coverage.missingLanes.length === 0
178
+ && coverage.telemetryTruncated === false && coverage.telemetryIntegrityFailures === 0
179
+ && coverage.recoverableTailBytes === 0 && coverage.sessionEventsObserved > 0
180
+ && validCausalAggregates(receipt.aggregates, coverage.criterionExpected, receipt.schemaVersion);
181
+ return ["partial", "unavailable"].includes(coverage.status)
182
+ && coverage.missingLanes.length > 0 && receipt.aggregates === null;
183
+ }
184
+
185
+ export function summarizeBenchmarkCausalContextEvidence(runs, { required = false } = {}) {
186
+ const piagentRuns = Array.isArray(runs) ? runs.filter((run) => run?.surface === "piagent") : [];
187
+ const complete = piagentRuns.filter((run) => validBenchmarkCausalContextReceipt(run.causalContextReceipt, run.surface)
188
+ && run.causalContextReceipt.available === true
189
+ && run.causalContextReceipt.coverage.status === "complete"
190
+ && run.causalContextReceipt.aggregates);
191
+ const fullyCovered = piagentRuns.length > 0 && complete.length === piagentRuns.length;
192
+ const recoveryComplete = complete.filter((run) => run.causalContextReceipt.schemaVersion >= 2);
193
+ const recoveryFullyCovered = fullyCovered && recoveryComplete.length === piagentRuns.length;
194
+ const sum = (select) => complete.reduce((total, run) => total + select(run.causalContextReceipt.aggregates), 0);
195
+ const sumRecovery = (select) => recoveryComplete.reduce((total, run) => total + select(run.causalContextReceipt.aggregates.editRecoveryContext), 0);
196
+ const triplet = (field) => Object.fromEntries(["offered", "delivered", "injected"]
197
+ .map((lane) => [lane, sum((value) => value[field][lane])]));
198
+ const criterion = fullyCovered ? complete.reduce((total, run) => {
199
+ const value = run.causalContextReceipt.aggregates.criterionInitialPack;
200
+ for (const field of ["attempts", "selectedAttempts", "candidates", "selectedItems", "estimatedTokens", "offered", "delivered", "injected"]) {
201
+ total[field] += value[field];
202
+ }
203
+ for (const field of Object.keys(total.zeroSelectionReasonCounts)) {
204
+ total.zeroSelectionReasonCounts[field] += value.zeroSelectionReasonCounts[field];
205
+ }
206
+ return total;
207
+ }, {
208
+ attempts: 0, selectedAttempts: 0, candidates: 0, selectedItems: 0, estimatedTokens: 0,
209
+ zeroSelectionReasonCounts: { autoContextDisabled: 0, criterionGraphUnavailable: 0, noCandidates: 0, noReadableSelection: 0 },
210
+ offered: 0, delivered: 0, injected: 0
211
+ }) : null;
212
+ return {
213
+ required,
214
+ runs: piagentRuns.length,
215
+ availableRuns: complete.length,
216
+ unavailableRuns: piagentRuns.length - complete.length,
217
+ coverageStatus: fullyCovered ? "complete" : complete.length > 0 ? "partial" : "unavailable",
218
+ requiredSchemaVersion: 2,
219
+ currentAvailableRuns: recoveryComplete.length,
220
+ currentUnavailableRuns: piagentRuns.length - recoveryComplete.length,
221
+ currentCoverageStatus: recoveryFullyCovered ? "complete" : recoveryComplete.length > 0 ? "partial" : "unavailable",
222
+ aggregates: fullyCovered ? {
223
+ packCounts: triplet("packCounts"),
224
+ estimatedTokens: triplet("estimatedTokens"),
225
+ selectedItemEstimatedTokens: triplet("selectedItemEstimatedTokens"),
226
+ selectedItemCounts: triplet("selectedItemCounts"),
227
+ criterionInitialPack: criterion,
228
+ directFallbackRereads: {
229
+ successfulCalls: sum((value) => value.directFallbackRereads.successfulCalls),
230
+ shellToolCallsObserved: sum((value) => value.directFallbackRereads.shellToolCallsObserved),
231
+ definition: "successful-direct-path-tool-call-v1"
232
+ },
233
+ editRecoveryContext: {
234
+ count: recoveryFullyCovered ? sumRecovery((value) => value.count) : null,
235
+ failuresObserved: recoveryFullyCovered ? sumRecovery((value) => value.failuresObserved) : null,
236
+ suppressedFailures: recoveryFullyCovered ? sumRecovery((value) => value.suppressedFailures) : null,
237
+ injectedChars: recoveryFullyCovered ? sumRecovery((value) => value.injectedChars) : null,
238
+ injectedEstimatedTokens: recoveryFullyCovered ? sumRecovery((value) => value.injectedEstimatedTokens) : null,
239
+ evidenceCoverage: {
240
+ status: recoveryFullyCovered ? "complete" : recoveryComplete.length > 0 ? "partial" : "unavailable",
241
+ runs: piagentRuns.length,
242
+ comparableRuns: recoveryComplete.length,
243
+ rate: piagentRuns.length > 0 ? recoveryComplete.length / piagentRuns.length : 0
244
+ },
245
+ definition: "matched-edit-recovery-context-receipt-v1"
246
+ },
247
+ compactionEventsObserved: sum((value) => value.compaction.eventsObserved),
248
+ managedPrefixPromptsObserved: sum((value) => value.managedPrefix.promptsObserved),
249
+ managedPrefixCompactedPrompts: sum((value) => value.managedPrefix.compactedPrompts)
250
+ } : null
251
+ };
252
+ }
253
+
254
+ export function completedBenchmarkRecord(record) {
255
+ const nonnegative = (value) => Number.isFinite(value) && value >= 0;
256
+ const hash = (value) => /^[a-f0-9]{64}$/.test(String(value ?? ""));
257
+ const usage = record?.usage;
258
+ return record?.schemaVersion === 1
259
+ && typeof record.runId === "string" && record.runId.length > 0
260
+ && typeof record.attemptId === "string" && record.attemptId.length > 0
261
+ && hash(record.configurationDigest)
262
+ && Number.isInteger(record.orderIndex) && record.orderIndex > 0
263
+ && typeof record.scenarioId === "string" && record.scenarioId.length > 0
264
+ && typeof record.scenarioTitle === "string"
265
+ && typeof record.scenarioKind === "string"
266
+ && typeof record.category === "string"
267
+ && typeof record.difficulty === "string"
268
+ && typeof record.profile === "string"
269
+ && typeof record.lifecycle === "string"
270
+ && benchmarkSurfaces.has(record.surface)
271
+ && validBenchmarkCausalContextReceipt(record.causalContextReceipt, record.surface)
272
+ && Number.isInteger(record.repeat) && record.repeat > 0
273
+ && Number.isInteger(record.infrastructureAttempt) && record.infrastructureAttempt > 0
274
+ && Number.isInteger(record.infrastructureAttempts) && record.infrastructureAttempts > 0
275
+ && typeof record.sessionId === "string" && record.sessionId.length > 0
276
+ && record.abortSuite !== true
277
+ && typeof record.resolved === "boolean"
278
+ && Number.isInteger(record.agent?.exitCode)
279
+ && typeof record.agent?.timedOut === "boolean"
280
+ && hash(record.agent?.stdoutHash) && hash(record.agent?.stderrHash)
281
+ && typeof record.grade?.passed === "boolean" && nonnegative(record.grade?.score) && record.grade.score <= 10 && Array.isArray(record.grade?.checks)
282
+ && typeof record.graderIntegrity?.passed === "boolean"
283
+ && typeof record.scope?.passed === "boolean" && Array.isArray(record.scope?.changedFiles) && Array.isArray(record.scope?.outsideScope)
284
+ && typeof record.outputSafety?.passed === "boolean" && Array.isArray(record.outputSafety?.forbiddenHits)
285
+ && typeof record.outputEvidence?.passed === "boolean" && Number.isInteger(record.outputEvidence?.requiredCount)
286
+ && nonnegative(record.durationSeconds)
287
+ && hash(record.promptHash)
288
+ && typeof record.variant?.generated === "boolean"
289
+ && hash(record.variant?.fixtureDigest)
290
+ && (!record.variant.generated || (hash(record.variant.seedDigest) && hash(record.variant.oracleDigest)))
291
+ && Number.isInteger(usage?.sessions) && usage.sessions > 0
292
+ && nonnegative(usage?.fresh) && usage.fresh > 0
293
+ && ["input", "output", "cacheRead", "cacheWrite", "reasoning", "total"].every((field) => nonnegative(usage?.[field]))
294
+ && usage.total === usage.input + usage.output + usage.cacheRead + usage.cacheWrite
295
+ && usage.fresh === usage.input + usage.output
296
+ && (nonnegative(usage?.cost) || (usage?.cost === null && usage?.costSource === "unavailable"));
297
+ }
298
+
299
+ export function pairedBenchmarkVariantMatched(record, runs) {
300
+ const pair = runs.find((value) => value.scenarioId === record.scenarioId && value.repeat === record.repeat && value.surface !== record.surface);
301
+ if (!pair) return true;
302
+ return pair.promptHash === record.promptHash
303
+ && pair.variant?.generated === record.variant?.generated
304
+ && pair.variant?.fixtureDigest === record.variant?.fixtureDigest
305
+ && pair.variant?.seedDigest === record.variant?.seedDigest
306
+ && pair.variant?.oracleDigest === record.variant?.oracleDigest;
307
+ }
308
+
309
+ export function expectedBenchmarkRecord(record, index, expected, runId, suite, configurationDigest) {
310
+ const scenario = expected?.scenario;
311
+ return completedBenchmarkRecord(record)
312
+ && record.runId === runId
313
+ && record.configurationDigest === configurationDigest
314
+ && record.orderIndex === index + 1
315
+ && record.scenarioId === scenario?.id
316
+ && record.surface === expected?.surface
317
+ && record.repeat === expected?.repeat
318
+ && record.scenarioTitle === scenario?.title
319
+ && record.scenarioKind === scenario?.kind
320
+ && record.category === (scenario?.category ?? "unspecified")
321
+ && record.difficulty === (scenario?.difficulty ?? "unspecified")
322
+ && record.profile === (scenario?.profile ?? suite.profile)
323
+ && record.lifecycle === (scenario?.lifecycle ?? "steady-state");
324
+ }
@@ -0,0 +1,142 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://piagent.local/schemas/benchmark-assurance-evidence.schema.json",
4
+ "title": "Piagent benchmark assurance evidence",
5
+ "oneOf": [
6
+ { "$ref": "#/$defs/legacyV1" },
7
+ { "$ref": "#/$defs/custodyV2" }
8
+ ],
9
+ "$defs": {
10
+ "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
11
+ "completeResults": {
12
+ "type": "object",
13
+ "additionalProperties": false,
14
+ "required": ["total", "passed"],
15
+ "properties": {
16
+ "total": { "type": "integer", "minimum": 1 },
17
+ "passed": { "type": "integer", "minimum": 1 }
18
+ }
19
+ },
20
+ "mutationResults": {
21
+ "type": "object",
22
+ "additionalProperties": false,
23
+ "required": ["total", "killed"],
24
+ "properties": {
25
+ "total": { "type": "integer", "minimum": 1 },
26
+ "killed": { "type": "integer", "minimum": 1 }
27
+ }
28
+ },
29
+ "legacyV1": {
30
+ "type": "object",
31
+ "additionalProperties": false,
32
+ "required": ["schemaVersion", "claimTier", "visibility", "familyDisjointSplit", "holdoutManifestDigest", "referenceSolutionDigest", "mutationReportDigest", "calibrationReportDigest", "referenceSolutions", "mutationChecks", "calibration"],
33
+ "properties": {
34
+ "schemaVersion": { "const": 1 },
35
+ "claimTier": { "enum": ["private-holdout", "production-shadow"] },
36
+ "visibility": { "const": "external-private-holdout" },
37
+ "familyDisjointSplit": { "const": true },
38
+ "holdoutManifestDigest": { "$ref": "#/$defs/sha256" },
39
+ "referenceSolutionDigest": { "$ref": "#/$defs/sha256" },
40
+ "mutationReportDigest": { "$ref": "#/$defs/sha256" },
41
+ "calibrationReportDigest": { "$ref": "#/$defs/sha256" },
42
+ "referenceSolutions": { "$ref": "#/$defs/completeResults" },
43
+ "mutationChecks": { "$ref": "#/$defs/mutationResults" },
44
+ "calibration": {
45
+ "type": "object",
46
+ "additionalProperties": false,
47
+ "required": ["sampleSize", "reviewerCount", "agreement"],
48
+ "properties": {
49
+ "sampleSize": { "type": "integer", "minimum": 1 },
50
+ "reviewerCount": { "type": "integer", "minimum": 2 },
51
+ "agreement": { "type": "number", "minimum": 0.8, "maximum": 1 }
52
+ }
53
+ }
54
+ }
55
+ },
56
+ "custodyV2": {
57
+ "type": "object",
58
+ "additionalProperties": false,
59
+ "required": ["schemaVersion", "claimTier", "visibility", "familyDisjointSplit", "repositoryDisjointSplit", "holdoutManifestDigest", "referenceSolutionDigest", "mutationReportDigest", "calibrationReportDigest", "accessPolicyDigest", "disjointnessReportDigest", "humanRubricDigest", "disagreementReportDigest", "accessControl", "disjointness", "referenceSolutions", "mutationChecks", "calibration"],
60
+ "properties": {
61
+ "schemaVersion": { "const": 2 },
62
+ "claimTier": { "enum": ["private-holdout", "production-shadow"] },
63
+ "visibility": { "const": "external-private-holdout" },
64
+ "familyDisjointSplit": { "const": true },
65
+ "repositoryDisjointSplit": { "const": true },
66
+ "holdoutManifestDigest": { "$ref": "#/$defs/sha256" },
67
+ "referenceSolutionDigest": { "$ref": "#/$defs/sha256" },
68
+ "mutationReportDigest": { "$ref": "#/$defs/sha256" },
69
+ "calibrationReportDigest": { "$ref": "#/$defs/sha256" },
70
+ "accessPolicyDigest": { "$ref": "#/$defs/sha256" },
71
+ "disjointnessReportDigest": { "$ref": "#/$defs/sha256" },
72
+ "humanRubricDigest": { "$ref": "#/$defs/sha256" },
73
+ "disagreementReportDigest": { "$ref": "#/$defs/sha256" },
74
+ "accessControl": { "$ref": "#/$defs/accessControl" },
75
+ "disjointness": { "$ref": "#/$defs/disjointness" },
76
+ "referenceSolutions": { "$ref": "#/$defs/completeResults" },
77
+ "mutationChecks": { "$ref": "#/$defs/mutationResults" },
78
+ "calibration": { "$ref": "#/$defs/calibrationV2" }
79
+ }
80
+ },
81
+ "accessControl": {
82
+ "type": "object",
83
+ "additionalProperties": false,
84
+ "required": ["protocolVersion", "policyDigest", "candidateAuthorPromptAccess", "candidateAuthorGraderAccess", "candidateAuthorRepositoryAccess", "operatorAccess", "reviewerAccess", "custodianIndependent", "reviewerIndependent", "appendOnlyAccessLog", "accessLogDigest", "issuedAt", "expiresAt"],
85
+ "properties": {
86
+ "protocolVersion": { "const": "e3-custody-v1" },
87
+ "policyDigest": { "$ref": "#/$defs/sha256" },
88
+ "candidateAuthorPromptAccess": { "const": "denied-until-rc-freeze" },
89
+ "candidateAuthorGraderAccess": { "const": "denied-until-rc-freeze" },
90
+ "candidateAuthorRepositoryAccess": { "const": "denied-until-rc-freeze" },
91
+ "operatorAccess": { "const": "execute-only" },
92
+ "reviewerAccess": { "const": "blinded-rubric-and-output" },
93
+ "custodianIndependent": { "const": true },
94
+ "reviewerIndependent": { "const": true },
95
+ "appendOnlyAccessLog": { "const": true },
96
+ "accessLogDigest": { "$ref": "#/$defs/sha256" },
97
+ "issuedAt": { "type": "string", "format": "date-time" },
98
+ "expiresAt": { "type": "string", "format": "date-time" }
99
+ }
100
+ },
101
+ "disjointness": {
102
+ "type": "object",
103
+ "additionalProperties": false,
104
+ "required": ["taxonomyDigest", "publicExposureDigest", "reportDigest", "familyDisjoint", "repositoryDisjoint", "scenarioCount", "familyCount", "repositoryCount", "verifiedAt"],
105
+ "properties": {
106
+ "taxonomyDigest": { "$ref": "#/$defs/sha256" },
107
+ "publicExposureDigest": { "$ref": "#/$defs/sha256" },
108
+ "reportDigest": { "$ref": "#/$defs/sha256" },
109
+ "familyDisjoint": { "const": true },
110
+ "repositoryDisjoint": { "const": true },
111
+ "scenarioCount": { "type": "integer", "minimum": 6 },
112
+ "familyCount": { "type": "integer", "minimum": 6 },
113
+ "repositoryCount": { "type": "integer", "minimum": 6 },
114
+ "verifiedAt": { "type": "string", "format": "date-time" }
115
+ }
116
+ },
117
+ "calibrationV2": {
118
+ "type": "object",
119
+ "additionalProperties": false,
120
+ "required": ["sampleSize", "reviewerCount", "sampledFamilyCount", "doubleScoredCount", "agreementCount", "disagreementCount", "resolvedDisagreementCount", "unresolvedDisagreementCount", "agreement", "blinded", "independentFirstPass", "adjudicatorIndependent", "rubricDigest", "reviewerSetDigest", "sampleSelectionDigest", "disagreementLogDigest", "adjudicationPolicyDigest"],
121
+ "properties": {
122
+ "sampleSize": { "type": "integer", "minimum": 12 },
123
+ "reviewerCount": { "type": "integer", "minimum": 2 },
124
+ "sampledFamilyCount": { "type": "integer", "minimum": 4 },
125
+ "doubleScoredCount": { "type": "integer", "minimum": 12 },
126
+ "agreementCount": { "type": "integer", "minimum": 0 },
127
+ "disagreementCount": { "type": "integer", "minimum": 0 },
128
+ "resolvedDisagreementCount": { "type": "integer", "minimum": 0 },
129
+ "unresolvedDisagreementCount": { "const": 0 },
130
+ "agreement": { "type": "number", "minimum": 0.8, "maximum": 1 },
131
+ "blinded": { "const": true },
132
+ "independentFirstPass": { "const": true },
133
+ "adjudicatorIndependent": { "const": true },
134
+ "rubricDigest": { "$ref": "#/$defs/sha256" },
135
+ "reviewerSetDigest": { "$ref": "#/$defs/sha256" },
136
+ "sampleSelectionDigest": { "$ref": "#/$defs/sha256" },
137
+ "disagreementLogDigest": { "$ref": "#/$defs/sha256" },
138
+ "adjudicationPolicyDigest": { "$ref": "#/$defs/sha256" }
139
+ }
140
+ }
141
+ }
142
+ }