agentfootprint 10.9.0 → 11.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1100) hide show
  1. package/AGENTS.md +14 -4
  2. package/CAPABILITIES.md +16 -3
  3. package/README.md +115 -52
  4. package/ai-instructions/claude-code/SKILL.md +14 -4
  5. package/dist/adapters/hosting/agentCoreA2A.js +4 -0
  6. package/dist/adapters/hosting/agentCoreA2A.js.map +1 -1
  7. package/dist/adapters/hosting/firestoreSessions.js +9 -2
  8. package/dist/adapters/hosting/firestoreSessions.js.map +1 -1
  9. package/dist/adapters/hosting/googleAgentEngine.js +4 -6
  10. package/dist/adapters/hosting/googleAgentEngine.js.map +1 -1
  11. package/dist/adapters/llm/AnthropicProvider.js +4 -0
  12. package/dist/adapters/llm/AnthropicProvider.js.map +1 -1
  13. package/dist/adapters/llm/BrowserAnthropicProvider.js +4 -0
  14. package/dist/adapters/llm/BrowserAnthropicProvider.js.map +1 -1
  15. package/dist/adapters/llm/MockProvider.js +2 -0
  16. package/dist/adapters/llm/MockProvider.js.map +1 -1
  17. package/dist/ag-ui/request.js +27 -2
  18. package/dist/ag-ui/request.js.map +1 -1
  19. package/dist/ag-ui/serializer.js +21 -8
  20. package/dist/ag-ui/serializer.js.map +1 -1
  21. package/dist/answer-account/facts/howSure.js +3 -0
  22. package/dist/answer-account/facts/howSure.js.map +1 -1
  23. package/dist/answer-account/templates.js +4 -1
  24. package/dist/answer-account/templates.js.map +1 -1
  25. package/dist/answer-validation/agentChecks.js +130 -0
  26. package/dist/answer-validation/agentChecks.js.map +1 -0
  27. package/dist/answer-validation/index.js +5 -1
  28. package/dist/answer-validation/index.js.map +1 -1
  29. package/dist/answer-validation/outputSchema.js +8 -1
  30. package/dist/answer-validation/outputSchema.js.map +1 -1
  31. package/dist/answer-validation/types.js +9 -2
  32. package/dist/answer-validation/types.js.map +1 -1
  33. package/dist/answer-validation/validate.js +82 -3
  34. package/dist/answer-validation/validate.js.map +1 -1
  35. package/dist/core/Agent.js +214 -59
  36. package/dist/core/Agent.js.map +1 -1
  37. package/dist/core/RunnerBase.js +4 -0
  38. package/dist/core/RunnerBase.js.map +1 -1
  39. package/dist/core/agent/AgentBuilder.js +139 -33
  40. package/dist/core/agent/AgentBuilder.js.map +1 -1
  41. package/dist/core/agent/arguments/checks.js +1 -1
  42. package/dist/core/agent/arguments/subflow.js +1 -0
  43. package/dist/core/agent/arguments/subflow.js.map +1 -1
  44. package/dist/core/agent/assessment/assess.js +31 -0
  45. package/dist/core/agent/assessment/assess.js.map +1 -1
  46. package/dist/core/agent/assessment/compose.js +3 -0
  47. package/dist/core/agent/assessment/compose.js.map +1 -1
  48. package/dist/core/agent/assessment/reasons.js +19 -1
  49. package/dist/core/agent/assessment/reasons.js.map +1 -1
  50. package/dist/core/agent/buildAgentChart.js +7 -17
  51. package/dist/core/agent/buildAgentChart.js.map +1 -1
  52. package/dist/core/agent/buildDynamicAgentChart.js +18 -15
  53. package/dist/core/agent/buildDynamicAgentChart.js.map +1 -1
  54. package/dist/core/agent/buildToolRegistry.js +13 -0
  55. package/dist/core/agent/buildToolRegistry.js.map +1 -1
  56. package/dist/core/agent/composeRequest.js +19 -1
  57. package/dist/core/agent/composeRequest.js.map +1 -1
  58. package/dist/core/agent/evidence/answerCarriers.js +1 -1
  59. package/dist/core/agent/evidence/answerCarriers.js.map +1 -1
  60. package/dist/core/agent/evidence/evidenceIndex.js +1 -1
  61. package/dist/core/agent/evidence/evidenceIndex.js.map +1 -1
  62. package/dist/core/agent/evidence/extract.js +139 -32
  63. package/dist/core/agent/evidence/extract.js.map +1 -1
  64. package/dist/core/agent/evidence/figures.js +1 -1
  65. package/dist/core/agent/evidence/figures.js.map +1 -1
  66. package/dist/core/agent/evidence/frames.js +3 -1
  67. package/dist/core/agent/evidence/frames.js.map +1 -1
  68. package/dist/core/agent/evidence/gate.js +10 -2
  69. package/dist/core/agent/evidence/gate.js.map +1 -1
  70. package/dist/core/agent/evidence/numericRanges.js +1 -1
  71. package/dist/core/agent/evidence/numericRanges.js.map +1 -1
  72. package/dist/core/agent/evidence/recovery.js +3 -1
  73. package/dist/core/agent/evidence/recovery.js.map +1 -1
  74. package/dist/core/agent/evidence/resultCarries.js +3 -3
  75. package/dist/core/agent/evidence/resultCarries.js.map +1 -1
  76. package/dist/core/agent/findings/context.js +163 -0
  77. package/dist/core/agent/findings/context.js.map +1 -0
  78. package/dist/core/agent/findings/contingent.js +1 -1
  79. package/dist/core/agent/findings/contingent.js.map +1 -1
  80. package/dist/core/agent/findings/instruction.js +26 -0
  81. package/dist/core/agent/findings/instruction.js.map +1 -0
  82. package/dist/core/agent/findings/ledger.js +49 -0
  83. package/dist/core/agent/findings/ledger.js.map +1 -1
  84. package/dist/core/agent/findings/negativeProse.js +53 -0
  85. package/dist/core/agent/findings/negativeProse.js.map +1 -0
  86. package/dist/core/agent/findings/offer.js +9 -57
  87. package/dist/core/agent/findings/offer.js.map +1 -1
  88. package/dist/core/agent/findings/reserved.js +12 -83
  89. package/dist/core/agent/findings/reserved.js.map +1 -1
  90. package/dist/core/agent/findings/types.js +3 -2
  91. package/dist/core/agent/findings/types.js.map +1 -1
  92. package/dist/core/agent/honesty/mounts.js +6 -0
  93. package/dist/core/agent/honesty/mounts.js.map +1 -1
  94. package/dist/core/agent/nativeOutputFormat.js +19 -1
  95. package/dist/core/agent/nativeOutputFormat.js.map +1 -1
  96. package/dist/core/agent/negativeClaims/capture.js +522 -0
  97. package/dist/core/agent/negativeClaims/capture.js.map +1 -0
  98. package/dist/core/agent/negativeClaims/checkpoint.js +83 -0
  99. package/dist/core/agent/negativeClaims/checkpoint.js.map +1 -0
  100. package/dist/core/agent/negativeClaims/config.js +192 -0
  101. package/dist/core/agent/negativeClaims/config.js.map +1 -0
  102. package/dist/core/agent/negativeClaims/delivery.js +249 -0
  103. package/dist/core/agent/negativeClaims/delivery.js.map +1 -0
  104. package/dist/core/agent/negativeClaims/observe.js +38 -0
  105. package/dist/core/agent/negativeClaims/observe.js.map +1 -0
  106. package/dist/core/agent/negativeClaims/prose.js +116 -0
  107. package/dist/core/agent/negativeClaims/prose.js.map +1 -0
  108. package/dist/core/agent/negativeClaims/recheck.js +37 -0
  109. package/dist/core/agent/negativeClaims/recheck.js.map +1 -0
  110. package/dist/core/agent/outputEnforcement.js.map +1 -1
  111. package/dist/core/agent/stages/answerEvidence.js +21 -0
  112. package/dist/core/agent/stages/answerEvidence.js.map +1 -0
  113. package/dist/core/agent/stages/answerValidation.js +112 -4
  114. package/dist/core/agent/stages/answerValidation.js.map +1 -1
  115. package/dist/core/agent/stages/callLLM.js +82 -41
  116. package/dist/core/agent/stages/callLLM.js.map +1 -1
  117. package/dist/core/agent/stages/evidenceRecheck.js +16 -2
  118. package/dist/core/agent/stages/evidenceRecheck.js.map +1 -1
  119. package/dist/core/agent/stages/outputRetry.js +23 -7
  120. package/dist/core/agent/stages/outputRetry.js.map +1 -1
  121. package/dist/core/agent/stages/prepareFinal.js +6 -1
  122. package/dist/core/agent/stages/prepareFinal.js.map +1 -1
  123. package/dist/core/agent/stages/reliabilityExecution.js +3 -0
  124. package/dist/core/agent/stages/reliabilityExecution.js.map +1 -1
  125. package/dist/core/agent/stages/route.js +81 -33
  126. package/dist/core/agent/stages/route.js.map +1 -1
  127. package/dist/core/agent/stages/searchCoverage.js +121 -0
  128. package/dist/core/agent/stages/searchCoverage.js.map +1 -0
  129. package/dist/core/agent/stages/seed.js +19 -21
  130. package/dist/core/agent/stages/seed.js.map +1 -1
  131. package/dist/core/agent/stages/toolCalls.js +699 -76
  132. package/dist/core/agent/stages/toolCalls.js.map +1 -1
  133. package/dist/core/agent/toolChoice/compose.js +1 -0
  134. package/dist/core/agent/toolChoice/compose.js.map +1 -1
  135. package/dist/core/agent/toolChoice/pick.js +2 -0
  136. package/dist/core/agent/toolChoice/pick.js.map +1 -1
  137. package/dist/core/checkin.js +82 -18
  138. package/dist/core/checkin.js.map +1 -1
  139. package/dist/core/consentRequest.js +844 -0
  140. package/dist/core/consentRequest.js.map +1 -0
  141. package/dist/core/pause.js +104 -6
  142. package/dist/core/pause.js.map +1 -1
  143. package/dist/core/runCheckpoint.js +8 -1
  144. package/dist/core/runCheckpoint.js.map +1 -1
  145. package/dist/core/slots/buildToolsSlot.js +4 -24
  146. package/dist/core/slots/buildToolsSlot.js.map +1 -1
  147. package/dist/debug.js +2 -0
  148. package/dist/debug.js.map +1 -1
  149. package/dist/esm/adapters/hosting/agentCoreA2A.js +4 -0
  150. package/dist/esm/adapters/hosting/agentCoreA2A.js.map +1 -1
  151. package/dist/esm/adapters/hosting/firestoreSessions.js +9 -2
  152. package/dist/esm/adapters/hosting/firestoreSessions.js.map +1 -1
  153. package/dist/esm/adapters/hosting/googleAgentEngine.js +4 -6
  154. package/dist/esm/adapters/hosting/googleAgentEngine.js.map +1 -1
  155. package/dist/esm/adapters/llm/AnthropicProvider.d.ts +1 -0
  156. package/dist/esm/adapters/llm/AnthropicProvider.js +5 -1
  157. package/dist/esm/adapters/llm/AnthropicProvider.js.map +1 -1
  158. package/dist/esm/adapters/llm/BrowserAnthropicProvider.d.ts +1 -0
  159. package/dist/esm/adapters/llm/BrowserAnthropicProvider.js +5 -1
  160. package/dist/esm/adapters/llm/BrowserAnthropicProvider.js.map +1 -1
  161. package/dist/esm/adapters/llm/MockProvider.d.ts +2 -0
  162. package/dist/esm/adapters/llm/MockProvider.js +2 -0
  163. package/dist/esm/adapters/llm/MockProvider.js.map +1 -1
  164. package/dist/esm/ag-ui/request.d.ts +4 -1
  165. package/dist/esm/ag-ui/request.js +27 -2
  166. package/dist/esm/ag-ui/request.js.map +1 -1
  167. package/dist/esm/ag-ui/serializer.d.ts +15 -2
  168. package/dist/esm/ag-ui/serializer.js +20 -7
  169. package/dist/esm/ag-ui/serializer.js.map +1 -1
  170. package/dist/esm/answer-account/facts/howSure.js +3 -0
  171. package/dist/esm/answer-account/facts/howSure.js.map +1 -1
  172. package/dist/esm/answer-account/templates.d.ts +4 -1
  173. package/dist/esm/answer-account/templates.js +4 -1
  174. package/dist/esm/answer-account/templates.js.map +1 -1
  175. package/dist/esm/answer-validation/agentChecks.d.ts +75 -0
  176. package/dist/esm/answer-validation/agentChecks.js +125 -0
  177. package/dist/esm/answer-validation/agentChecks.js.map +1 -0
  178. package/dist/esm/answer-validation/index.d.ts +2 -1
  179. package/dist/esm/answer-validation/index.js +1 -0
  180. package/dist/esm/answer-validation/index.js.map +1 -1
  181. package/dist/esm/answer-validation/outputSchema.d.ts +18 -7
  182. package/dist/esm/answer-validation/outputSchema.js +8 -1
  183. package/dist/esm/answer-validation/outputSchema.js.map +1 -1
  184. package/dist/esm/answer-validation/types.d.ts +125 -1
  185. package/dist/esm/answer-validation/types.js +9 -2
  186. package/dist/esm/answer-validation/types.js.map +1 -1
  187. package/dist/esm/answer-validation/validate.d.ts +11 -2
  188. package/dist/esm/answer-validation/validate.js +82 -3
  189. package/dist/esm/answer-validation/validate.js.map +1 -1
  190. package/dist/esm/core/Agent.d.ts +25 -1
  191. package/dist/esm/core/Agent.js +202 -47
  192. package/dist/esm/core/Agent.js.map +1 -1
  193. package/dist/esm/core/RunnerBase.js +4 -0
  194. package/dist/esm/core/RunnerBase.js.map +1 -1
  195. package/dist/esm/core/agent/AgentBuilder.d.ts +43 -12
  196. package/dist/esm/core/agent/AgentBuilder.js +135 -29
  197. package/dist/esm/core/agent/AgentBuilder.js.map +1 -1
  198. package/dist/esm/core/agent/arguments/checks.d.ts +1 -1
  199. package/dist/esm/core/agent/arguments/checks.js +1 -1
  200. package/dist/esm/core/agent/arguments/subflow.d.ts +6 -0
  201. package/dist/esm/core/agent/arguments/subflow.js +1 -0
  202. package/dist/esm/core/agent/arguments/subflow.js.map +1 -1
  203. package/dist/esm/core/agent/assessment/assess.js +31 -0
  204. package/dist/esm/core/agent/assessment/assess.js.map +1 -1
  205. package/dist/esm/core/agent/assessment/compose.js +3 -0
  206. package/dist/esm/core/agent/assessment/compose.js.map +1 -1
  207. package/dist/esm/core/agent/assessment/reasons.js +19 -1
  208. package/dist/esm/core/agent/assessment/reasons.js.map +1 -1
  209. package/dist/esm/core/agent/assessment/types.d.ts +3 -2
  210. package/dist/esm/core/agent/buildAgentChart.d.ts +4 -12
  211. package/dist/esm/core/agent/buildAgentChart.js +7 -17
  212. package/dist/esm/core/agent/buildAgentChart.js.map +1 -1
  213. package/dist/esm/core/agent/buildDynamicAgentChart.js +18 -15
  214. package/dist/esm/core/agent/buildDynamicAgentChart.js.map +1 -1
  215. package/dist/esm/core/agent/buildToolRegistry.js +13 -0
  216. package/dist/esm/core/agent/buildToolRegistry.js.map +1 -1
  217. package/dist/esm/core/agent/composeRequest.d.ts +19 -0
  218. package/dist/esm/core/agent/composeRequest.js +17 -0
  219. package/dist/esm/core/agent/composeRequest.js.map +1 -1
  220. package/dist/esm/core/agent/evidence/answerCarriers.js +1 -1
  221. package/dist/esm/core/agent/evidence/answerCarriers.js.map +1 -1
  222. package/dist/esm/core/agent/evidence/evidenceIndex.js +1 -1
  223. package/dist/esm/core/agent/evidence/evidenceIndex.js.map +1 -1
  224. package/dist/esm/core/agent/evidence/extract.d.ts +45 -6
  225. package/dist/esm/core/agent/evidence/extract.js +136 -30
  226. package/dist/esm/core/agent/evidence/extract.js.map +1 -1
  227. package/dist/esm/core/agent/evidence/figures.js +1 -1
  228. package/dist/esm/core/agent/evidence/figures.js.map +1 -1
  229. package/dist/esm/core/agent/evidence/frames.js +4 -2
  230. package/dist/esm/core/agent/evidence/frames.js.map +1 -1
  231. package/dist/esm/core/agent/evidence/gate.d.ts +6 -0
  232. package/dist/esm/core/agent/evidence/gate.js +11 -3
  233. package/dist/esm/core/agent/evidence/gate.js.map +1 -1
  234. package/dist/esm/core/agent/evidence/numericRanges.js +1 -1
  235. package/dist/esm/core/agent/evidence/numericRanges.js.map +1 -1
  236. package/dist/esm/core/agent/evidence/recovery.d.ts +2 -0
  237. package/dist/esm/core/agent/evidence/recovery.js +3 -1
  238. package/dist/esm/core/agent/evidence/recovery.js.map +1 -1
  239. package/dist/esm/core/agent/evidence/resultCarries.d.ts +2 -2
  240. package/dist/esm/core/agent/evidence/resultCarries.js +3 -3
  241. package/dist/esm/core/agent/evidence/resultCarries.js.map +1 -1
  242. package/dist/esm/core/agent/evidence/types.d.ts +17 -0
  243. package/dist/esm/core/agent/findings/context.d.ts +13 -0
  244. package/dist/esm/core/agent/findings/context.js +158 -0
  245. package/dist/esm/core/agent/findings/context.js.map +1 -0
  246. package/dist/esm/core/agent/findings/contingent.js +1 -1
  247. package/dist/esm/core/agent/findings/contingent.js.map +1 -1
  248. package/dist/esm/core/agent/findings/instruction.d.ts +12 -0
  249. package/dist/esm/core/agent/findings/instruction.js +22 -0
  250. package/dist/esm/core/agent/findings/instruction.js.map +1 -0
  251. package/dist/esm/core/agent/findings/ledger.d.ts +3 -0
  252. package/dist/esm/core/agent/findings/ledger.js +49 -0
  253. package/dist/esm/core/agent/findings/ledger.js.map +1 -1
  254. package/dist/esm/core/agent/findings/negativeProse.d.ts +1 -0
  255. package/dist/esm/core/agent/findings/negativeProse.js +49 -0
  256. package/dist/esm/core/agent/findings/negativeProse.js.map +1 -0
  257. package/dist/esm/core/agent/findings/offer.d.ts +9 -57
  258. package/dist/esm/core/agent/findings/offer.js +9 -57
  259. package/dist/esm/core/agent/findings/offer.js.map +1 -1
  260. package/dist/esm/core/agent/findings/reserved.d.ts +7 -31
  261. package/dist/esm/core/agent/findings/reserved.js +12 -83
  262. package/dist/esm/core/agent/findings/reserved.js.map +1 -1
  263. package/dist/esm/core/agent/findings/types.d.ts +11 -4
  264. package/dist/esm/core/agent/findings/types.js +3 -2
  265. package/dist/esm/core/agent/findings/types.js.map +1 -1
  266. package/dist/esm/core/agent/honesty/mounts.d.ts +7 -0
  267. package/dist/esm/core/agent/honesty/mounts.js +6 -0
  268. package/dist/esm/core/agent/honesty/mounts.js.map +1 -1
  269. package/dist/esm/core/agent/nativeOutputFormat.d.ts +2 -1
  270. package/dist/esm/core/agent/nativeOutputFormat.js +19 -1
  271. package/dist/esm/core/agent/nativeOutputFormat.js.map +1 -1
  272. package/dist/esm/core/agent/negativeClaims/capture.d.ts +65 -0
  273. package/dist/esm/core/agent/negativeClaims/capture.js +508 -0
  274. package/dist/esm/core/agent/negativeClaims/capture.js.map +1 -0
  275. package/dist/esm/core/agent/negativeClaims/checkpoint.d.ts +7 -0
  276. package/dist/esm/core/agent/negativeClaims/checkpoint.js +79 -0
  277. package/dist/esm/core/agent/negativeClaims/checkpoint.js.map +1 -0
  278. package/dist/esm/core/agent/negativeClaims/config.d.ts +66 -0
  279. package/dist/esm/core/agent/negativeClaims/config.js +185 -0
  280. package/dist/esm/core/agent/negativeClaims/config.js.map +1 -0
  281. package/dist/esm/core/agent/negativeClaims/delivery.d.ts +24 -0
  282. package/dist/esm/core/agent/negativeClaims/delivery.js +244 -0
  283. package/dist/esm/core/agent/negativeClaims/delivery.js.map +1 -0
  284. package/dist/esm/core/agent/negativeClaims/observe.d.ts +14 -0
  285. package/dist/esm/core/agent/negativeClaims/observe.js +34 -0
  286. package/dist/esm/core/agent/negativeClaims/observe.js.map +1 -0
  287. package/dist/esm/core/agent/negativeClaims/prose.d.ts +9 -0
  288. package/dist/esm/core/agent/negativeClaims/prose.js +112 -0
  289. package/dist/esm/core/agent/negativeClaims/prose.js.map +1 -0
  290. package/dist/esm/core/agent/negativeClaims/recheck.d.ts +7 -0
  291. package/dist/esm/core/agent/negativeClaims/recheck.js +32 -0
  292. package/dist/esm/core/agent/negativeClaims/recheck.js.map +1 -0
  293. package/dist/esm/core/agent/outputEnforcement.d.ts +5 -1
  294. package/dist/esm/core/agent/outputEnforcement.js.map +1 -1
  295. package/dist/esm/core/agent/receipt/receipt.d.ts +2 -2
  296. package/dist/esm/core/agent/stages/answerEvidence.d.ts +28 -0
  297. package/dist/esm/core/agent/stages/answerEvidence.js +16 -0
  298. package/dist/esm/core/agent/stages/answerEvidence.js.map +1 -0
  299. package/dist/esm/core/agent/stages/answerValidation.d.ts +15 -3
  300. package/dist/esm/core/agent/stages/answerValidation.js +113 -5
  301. package/dist/esm/core/agent/stages/answerValidation.js.map +1 -1
  302. package/dist/esm/core/agent/stages/callLLM.d.ts +11 -2
  303. package/dist/esm/core/agent/stages/callLLM.js +85 -44
  304. package/dist/esm/core/agent/stages/callLLM.js.map +1 -1
  305. package/dist/esm/core/agent/stages/evidenceRecheck.d.ts +6 -1
  306. package/dist/esm/core/agent/stages/evidenceRecheck.js +16 -2
  307. package/dist/esm/core/agent/stages/evidenceRecheck.js.map +1 -1
  308. package/dist/esm/core/agent/stages/outputRetry.js +23 -7
  309. package/dist/esm/core/agent/stages/outputRetry.js.map +1 -1
  310. package/dist/esm/core/agent/stages/prepareFinal.js +6 -1
  311. package/dist/esm/core/agent/stages/prepareFinal.js.map +1 -1
  312. package/dist/esm/core/agent/stages/reliabilityExecution.d.ts +3 -0
  313. package/dist/esm/core/agent/stages/reliabilityExecution.js +3 -0
  314. package/dist/esm/core/agent/stages/reliabilityExecution.js.map +1 -1
  315. package/dist/esm/core/agent/stages/route.d.ts +8 -2
  316. package/dist/esm/core/agent/stages/route.js +81 -33
  317. package/dist/esm/core/agent/stages/route.js.map +1 -1
  318. package/dist/esm/core/agent/stages/searchCoverage.d.ts +94 -0
  319. package/dist/esm/core/agent/stages/searchCoverage.js +117 -0
  320. package/dist/esm/core/agent/stages/searchCoverage.js.map +1 -0
  321. package/dist/esm/core/agent/stages/seed.d.ts +10 -0
  322. package/dist/esm/core/agent/stages/seed.js +19 -21
  323. package/dist/esm/core/agent/stages/seed.js.map +1 -1
  324. package/dist/esm/core/agent/stages/toolCalls.d.ts +16 -0
  325. package/dist/esm/core/agent/stages/toolCalls.js +700 -77
  326. package/dist/esm/core/agent/stages/toolCalls.js.map +1 -1
  327. package/dist/esm/core/agent/toolChoice/compose.d.ts +2 -0
  328. package/dist/esm/core/agent/toolChoice/compose.js +1 -0
  329. package/dist/esm/core/agent/toolChoice/compose.js.map +1 -1
  330. package/dist/esm/core/agent/toolChoice/pick.d.ts +2 -0
  331. package/dist/esm/core/agent/toolChoice/pick.js +2 -0
  332. package/dist/esm/core/agent/toolChoice/pick.js.map +1 -1
  333. package/dist/esm/core/agent/toolChoice/types.d.ts +1 -1
  334. package/dist/esm/core/agent/types.d.ts +86 -5
  335. package/dist/esm/core/checkin.d.ts +83 -7
  336. package/dist/esm/core/checkin.js +77 -15
  337. package/dist/esm/core/checkin.js.map +1 -1
  338. package/dist/esm/core/consentRequest.d.ts +488 -0
  339. package/dist/esm/core/consentRequest.js +817 -0
  340. package/dist/esm/core/consentRequest.js.map +1 -0
  341. package/dist/esm/core/pause.d.ts +88 -7
  342. package/dist/esm/core/pause.js +102 -5
  343. package/dist/esm/core/pause.js.map +1 -1
  344. package/dist/esm/core/runCheckpoint.d.ts +5 -1
  345. package/dist/esm/core/runCheckpoint.js +8 -1
  346. package/dist/esm/core/runCheckpoint.js.map +1 -1
  347. package/dist/esm/core/slots/buildToolsSlot.d.ts +4 -11
  348. package/dist/esm/core/slots/buildToolsSlot.js +4 -24
  349. package/dist/esm/core/slots/buildToolsSlot.js.map +1 -1
  350. package/dist/esm/debug.d.ts +1 -1
  351. package/dist/esm/debug.js +2 -0
  352. package/dist/esm/debug.js.map +1 -1
  353. package/dist/esm/events/payloads.d.ts +145 -3
  354. package/dist/esm/events/registry.d.ts +3 -1
  355. package/dist/esm/events/registry.js +2 -0
  356. package/dist/esm/events/registry.js.map +1 -1
  357. package/dist/esm/hosting/answeredPause.d.ts +301 -0
  358. package/dist/esm/hosting/answeredPause.js +522 -0
  359. package/dist/esm/hosting/answeredPause.js.map +1 -0
  360. package/dist/esm/hosting/conformance/cases.js +81 -1
  361. package/dist/esm/hosting/conformance/cases.js.map +1 -1
  362. package/dist/esm/hosting/conformance/types.d.ts +1 -1
  363. package/dist/esm/hosting/envelope.d.ts +6 -0
  364. package/dist/esm/hosting/envelope.js +14 -0
  365. package/dist/esm/hosting/envelope.js.map +1 -1
  366. package/dist/esm/hosting/errors.d.ts +14 -2
  367. package/dist/esm/hosting/errors.js +13 -6
  368. package/dist/esm/hosting/errors.js.map +1 -1
  369. package/dist/esm/hosting/index.d.ts +2 -1
  370. package/dist/esm/hosting/index.js +3 -0
  371. package/dist/esm/hosting/index.js.map +1 -1
  372. package/dist/esm/hosting/memorySessions.js +10 -2
  373. package/dist/esm/hosting/memorySessions.js.map +1 -1
  374. package/dist/esm/hosting/processLocalStore.d.ts +20 -0
  375. package/dist/esm/hosting/processLocalStore.js +26 -0
  376. package/dist/esm/hosting/processLocalStore.js.map +1 -0
  377. package/dist/esm/hosting/protocolAdapter.d.ts +13 -0
  378. package/dist/esm/hosting/refusalStatus.d.ts +6 -0
  379. package/dist/esm/hosting/refusalStatus.js +13 -0
  380. package/dist/esm/hosting/refusalStatus.js.map +1 -1
  381. package/dist/esm/hosting/sessionWire.d.ts +8 -3
  382. package/dist/esm/hosting/sessionWire.js.map +1 -1
  383. package/dist/esm/hosting/sqliteSessions.js +27 -3
  384. package/dist/esm/hosting/sqliteSessions.js.map +1 -1
  385. package/dist/esm/hosting/standingAgent.js +70 -26
  386. package/dist/esm/hosting/standingAgent.js.map +1 -1
  387. package/dist/esm/hosting/streamHandler.d.ts +3 -1
  388. package/dist/esm/hosting/streamHandler.js +150 -32
  389. package/dist/esm/hosting/streamHandler.js.map +1 -1
  390. package/dist/esm/hosting/types.d.ts +28 -6
  391. package/dist/esm/hosting/types.js.map +1 -1
  392. package/dist/esm/index.d.ts +7 -3
  393. package/dist/esm/index.js +21 -17
  394. package/dist/esm/index.js.map +1 -1
  395. package/dist/esm/integrity/negative-claim/anchor.d.ts +9 -0
  396. package/dist/esm/integrity/negative-claim/anchor.js +120 -0
  397. package/dist/esm/integrity/negative-claim/anchor.js.map +1 -0
  398. package/dist/esm/integrity/negative-claim/citation.d.ts +34 -0
  399. package/dist/esm/integrity/negative-claim/citation.js +367 -0
  400. package/dist/esm/integrity/negative-claim/citation.js.map +1 -0
  401. package/dist/esm/integrity/negative-claim/containment.d.ts +40 -0
  402. package/dist/esm/integrity/negative-claim/containment.js +257 -0
  403. package/dist/esm/integrity/negative-claim/containment.js.map +1 -0
  404. package/dist/esm/integrity/negative-claim/derive.d.ts +17 -0
  405. package/dist/esm/integrity/negative-claim/derive.js +122 -0
  406. package/dist/esm/integrity/negative-claim/derive.js.map +1 -0
  407. package/dist/esm/integrity/negative-claim/detect.d.ts +44 -0
  408. package/dist/esm/integrity/negative-claim/detect.js +65 -0
  409. package/dist/esm/integrity/negative-claim/detect.js.map +1 -0
  410. package/dist/esm/integrity/negative-claim/judge.d.ts +41 -0
  411. package/dist/esm/integrity/negative-claim/judge.js +95 -0
  412. package/dist/esm/integrity/negative-claim/judge.js.map +1 -0
  413. package/dist/esm/integrity/negative-claim/language.d.ts +14 -0
  414. package/dist/esm/integrity/negative-claim/language.js +42 -0
  415. package/dist/esm/integrity/negative-claim/language.js.map +1 -0
  416. package/dist/esm/integrity/negative-claim/limits.d.ts +2 -0
  417. package/dist/esm/integrity/negative-claim/limits.js +3 -0
  418. package/dist/esm/integrity/negative-claim/limits.js.map +1 -0
  419. package/dist/esm/integrity/negative-claim/matcher.d.ts +51 -0
  420. package/dist/esm/integrity/negative-claim/matcher.js +164 -0
  421. package/dist/esm/integrity/negative-claim/matcher.js.map +1 -0
  422. package/dist/esm/integrity/negative-claim/noRead.d.ts +8 -0
  423. package/dist/esm/integrity/negative-claim/noRead.js +9 -0
  424. package/dist/esm/integrity/negative-claim/noRead.js.map +1 -0
  425. package/dist/esm/integrity/negative-claim/phrases.d.ts +69 -0
  426. package/dist/esm/integrity/negative-claim/phrases.js +249 -0
  427. package/dist/esm/integrity/negative-claim/phrases.js.map +1 -0
  428. package/dist/esm/integrity/negative-claim/prose.d.ts +36 -0
  429. package/dist/esm/integrity/negative-claim/prose.js +143 -0
  430. package/dist/esm/integrity/negative-claim/prose.js.map +1 -0
  431. package/dist/esm/integrity/negative-claim/readings.d.ts +81 -0
  432. package/dist/esm/integrity/negative-claim/readings.js +322 -0
  433. package/dist/esm/integrity/negative-claim/readings.js.map +1 -0
  434. package/dist/esm/integrity/negative-claim/resolve.d.ts +37 -0
  435. package/dist/esm/integrity/negative-claim/resolve.js +179 -0
  436. package/dist/esm/integrity/negative-claim/resolve.js.map +1 -0
  437. package/dist/esm/integrity/negative-claim/statement.d.ts +75 -0
  438. package/dist/esm/integrity/negative-claim/statement.js +361 -0
  439. package/dist/esm/integrity/negative-claim/statement.js.map +1 -0
  440. package/dist/esm/integrity/negative-claim/types.d.ts +144 -0
  441. package/dist/esm/integrity/negative-claim/types.js +39 -0
  442. package/dist/esm/integrity/negative-claim/types.js.map +1 -0
  443. package/dist/esm/integrity/negative-claim/units.d.ts +33 -0
  444. package/dist/esm/integrity/negative-claim/units.js +185 -0
  445. package/dist/esm/integrity/negative-claim/units.js.map +1 -0
  446. package/dist/esm/integrity/negative-claim/work.d.ts +12 -0
  447. package/dist/esm/integrity/negative-claim/work.js +19 -0
  448. package/dist/esm/integrity/negative-claim/work.js.map +1 -0
  449. package/dist/esm/integrity/unsupported-claim/check.d.ts +33 -0
  450. package/dist/esm/integrity/unsupported-claim/check.js +48 -26
  451. package/dist/esm/integrity/unsupported-claim/check.js.map +1 -1
  452. package/dist/esm/integrity/unsupported-claim/delivered.d.ts +72 -0
  453. package/dist/esm/integrity/unsupported-claim/delivered.js +98 -0
  454. package/dist/esm/integrity/unsupported-claim/delivered.js.map +1 -0
  455. package/dist/esm/integrity/unsupported-claim/evaluate.d.ts +103 -1
  456. package/dist/esm/integrity/unsupported-claim/evaluate.js +373 -0
  457. package/dist/esm/integrity/unsupported-claim/evaluate.js.map +1 -1
  458. package/dist/esm/lib/conventions.d.ts +1 -0
  459. package/dist/esm/lib/conventions.js +3 -0
  460. package/dist/esm/lib/conventions.js.map +1 -1
  461. package/dist/esm/lib/frozenCopy.d.ts +75 -0
  462. package/dist/esm/lib/frozenCopy.js +198 -0
  463. package/dist/esm/lib/frozenCopy.js.map +1 -0
  464. package/dist/esm/lib/jsonFaithful.d.ts +34 -0
  465. package/dist/esm/lib/jsonFaithful.js +111 -0
  466. package/dist/esm/lib/jsonFaithful.js.map +1 -0
  467. package/dist/esm/lib/normalize.d.ts +96 -0
  468. package/dist/esm/{tools → lib}/normalize.js +142 -6
  469. package/dist/esm/lib/normalize.js.map +1 -0
  470. package/dist/esm/lib/saidByPerson.d.ts +2 -0
  471. package/dist/esm/lib/saidByPerson.js +3 -0
  472. package/dist/esm/lib/saidByPerson.js.map +1 -1
  473. package/dist/esm/mcp/toolExtras.d.ts +10 -0
  474. package/dist/esm/mcp/toolExtras.js +11 -0
  475. package/dist/esm/mcp/toolExtras.js.map +1 -1
  476. package/dist/esm/provider-contract/nativeOutputSchema.d.ts +6 -2
  477. package/dist/esm/provider-contract/nativeOutputSchema.js +9 -2
  478. package/dist/esm/provider-contract/nativeOutputSchema.js.map +1 -1
  479. package/dist/esm/provider-contract/types.d.ts +12 -1
  480. package/dist/esm/provider-contract/types.js.map +1 -1
  481. package/dist/esm/recorders/core/CheckInRecorder.d.ts +6 -1
  482. package/dist/esm/recorders/core/CheckInRecorder.js +5 -1
  483. package/dist/esm/recorders/core/CheckInRecorder.js.map +1 -1
  484. package/dist/esm/redaction/conversation.js +6 -0
  485. package/dist/esm/redaction/conversation.js.map +1 -1
  486. package/dist/esm/redaction/knownStrings.d.ts +9 -7
  487. package/dist/esm/redaction/knownStrings.js +74 -0
  488. package/dist/esm/redaction/knownStrings.js.map +1 -1
  489. package/dist/esm/resilience/withCircuitBreaker.js +3 -0
  490. package/dist/esm/resilience/withCircuitBreaker.js.map +1 -1
  491. package/dist/esm/resilience/withFallback.js +8 -1
  492. package/dist/esm/resilience/withFallback.js.map +1 -1
  493. package/dist/esm/resilience/withRetry.js +3 -0
  494. package/dist/esm/resilience/withRetry.js.map +1 -1
  495. package/dist/esm/semantics/check.d.ts +44 -2
  496. package/dist/esm/semantics/check.js +112 -3
  497. package/dist/esm/semantics/check.js.map +1 -1
  498. package/dist/esm/semantics/cli.js +33 -3
  499. package/dist/esm/semantics/cli.js.map +1 -1
  500. package/dist/esm/semantics/coverage/absent.d.ts +19 -2
  501. package/dist/esm/semantics/coverage/absent.js +56 -52
  502. package/dist/esm/semantics/coverage/absent.js.map +1 -1
  503. package/dist/esm/semantics/coverage/among.d.ts +73 -0
  504. package/dist/esm/semantics/coverage/among.js +172 -0
  505. package/dist/esm/semantics/coverage/among.js.map +1 -0
  506. package/dist/esm/semantics/coverage/composedCoverage.d.ts +220 -0
  507. package/dist/esm/semantics/coverage/composedCoverage.js +42 -0
  508. package/dist/esm/semantics/coverage/composedCoverage.js.map +1 -0
  509. package/dist/esm/semantics/coverage/evidence.js +27 -2
  510. package/dist/esm/semantics/coverage/evidence.js.map +1 -1
  511. package/dist/esm/semantics/coverage/index.d.ts +4 -1
  512. package/dist/esm/semantics/coverage/index.js +2 -0
  513. package/dist/esm/semantics/coverage/index.js.map +1 -1
  514. package/dist/esm/semantics/coverage/ledger.d.ts +2 -1
  515. package/dist/esm/semantics/coverage/ledger.js +15 -53
  516. package/dist/esm/semantics/coverage/ledger.js.map +1 -1
  517. package/dist/esm/semantics/coverage/read.d.ts +19 -0
  518. package/dist/esm/semantics/coverage/read.js.map +1 -1
  519. package/dist/esm/semantics/coverage/recognize.d.ts +17 -1
  520. package/dist/esm/semantics/coverage/recognize.js +40 -0
  521. package/dist/esm/semantics/coverage/recognize.js.map +1 -1
  522. package/dist/esm/semantics/coverage/search/binding.d.ts +27 -0
  523. package/dist/esm/semantics/coverage/search/binding.js +42 -0
  524. package/dist/esm/semantics/coverage/search/binding.js.map +1 -0
  525. package/dist/esm/semantics/coverage/search/compose.d.ts +90 -0
  526. package/dist/esm/semantics/coverage/search/compose.js +120 -0
  527. package/dist/esm/semantics/coverage/search/compose.js.map +1 -0
  528. package/dist/esm/semantics/coverage/search/declaration.d.ts +75 -0
  529. package/dist/esm/semantics/coverage/search/declaration.js +453 -0
  530. package/dist/esm/semantics/coverage/search/declaration.js.map +1 -0
  531. package/dist/esm/semantics/coverage/search/door.d.ts +46 -0
  532. package/dist/esm/semantics/coverage/search/door.js +130 -0
  533. package/dist/esm/semantics/coverage/search/door.js.map +1 -0
  534. package/dist/esm/semantics/coverage/search/events.d.ts +42 -0
  535. package/dist/esm/semantics/coverage/search/events.js +100 -0
  536. package/dist/esm/semantics/coverage/search/events.js.map +1 -0
  537. package/dist/esm/semantics/coverage/search/facets.d.ts +52 -0
  538. package/dist/esm/semantics/coverage/search/facets.js +191 -0
  539. package/dist/esm/semantics/coverage/search/facets.js.map +1 -0
  540. package/dist/esm/semantics/coverage/search/gaps.d.ts +63 -0
  541. package/dist/esm/semantics/coverage/search/gaps.js +221 -0
  542. package/dist/esm/semantics/coverage/search/gaps.js.map +1 -0
  543. package/dist/esm/semantics/coverage/search/inEffect.d.ts +65 -0
  544. package/dist/esm/semantics/coverage/search/inEffect.js +48 -0
  545. package/dist/esm/semantics/coverage/search/inEffect.js.map +1 -0
  546. package/dist/esm/semantics/coverage/search/resultFacts.d.ts +42 -0
  547. package/dist/esm/semantics/coverage/search/resultFacts.js +100 -0
  548. package/dist/esm/semantics/coverage/search/resultFacts.js.map +1 -0
  549. package/dist/esm/semantics/coverage/search/review.d.ts +36 -0
  550. package/dist/esm/semantics/coverage/search/review.js +89 -0
  551. package/dist/esm/semantics/coverage/search/review.js.map +1 -0
  552. package/dist/esm/semantics/coverage/search/served.d.ts +51 -0
  553. package/dist/esm/semantics/coverage/search/served.js +130 -0
  554. package/dist/esm/semantics/coverage/search/served.js.map +1 -0
  555. package/dist/esm/semantics/coverage/search/span.d.ts +34 -0
  556. package/dist/esm/semantics/coverage/search/span.js +61 -0
  557. package/dist/esm/semantics/coverage/search/span.js.map +1 -0
  558. package/dist/esm/semantics/coverage/search/statementText.d.ts +46 -0
  559. package/dist/esm/semantics/coverage/search/statementText.js +102 -0
  560. package/dist/esm/semantics/coverage/search/statementText.js.map +1 -0
  561. package/dist/esm/semantics/coverage/search/types.d.ts +120 -0
  562. package/dist/esm/semantics/coverage/search/types.js +11 -0
  563. package/dist/esm/semantics/coverage/search/types.js.map +1 -0
  564. package/dist/esm/semantics/coverage/search/valueWords.d.ts +22 -0
  565. package/dist/esm/semantics/coverage/search/valueWords.js +32 -0
  566. package/dist/esm/semantics/coverage/search/valueWords.js.map +1 -0
  567. package/dist/esm/semantics/coverage/types.d.ts +163 -0
  568. package/dist/esm/semantics/described.js +3 -1
  569. package/dist/esm/semantics/described.js.map +1 -1
  570. package/dist/esm/semantics/envelope.js +26 -2
  571. package/dist/esm/semantics/envelope.js.map +1 -1
  572. package/dist/esm/semantics/index.d.ts +2 -1
  573. package/dist/esm/semantics/index.js.map +1 -1
  574. package/dist/esm/semantics/overclaim.d.ts +105 -0
  575. package/dist/esm/semantics/overclaim.js +397 -0
  576. package/dist/esm/semantics/overclaim.js.map +1 -0
  577. package/dist/esm/semantics/types.d.ts +13 -0
  578. package/dist/esm/semantics/types.js.map +1 -1
  579. package/dist/esm/time/forms.js +1 -1
  580. package/dist/esm/time/textForms.js +1 -1
  581. package/dist/esm/time-travel/servedView.d.ts +2 -2
  582. package/dist/esm/time-travel/servedView.js +52 -160
  583. package/dist/esm/time-travel/servedView.js.map +1 -1
  584. package/dist/esm/tools/declare.d.ts +1 -1
  585. package/dist/esm/tools/declare.js +2 -2
  586. package/dist/esm/tools/declare.js.map +1 -1
  587. package/dist/esm/tools/hostFilled.d.ts +20 -1
  588. package/dist/esm/tools/hostFilled.js +46 -1
  589. package/dist/esm/tools/hostFilled.js.map +1 -1
  590. package/dist/esm/tools/searchOf.d.ts +60 -0
  591. package/dist/esm/tools/searchOf.js +97 -0
  592. package/dist/esm/tools/searchOf.js.map +1 -0
  593. package/dist/esm/tools/tools.d.ts +49 -0
  594. package/dist/esm/tools/tools.js +76 -1
  595. package/dist/esm/tools/tools.js.map +1 -1
  596. package/dist/esm/trace-toolpack/causeCapture.d.ts +17 -0
  597. package/dist/esm/trace-toolpack/causeCapture.js +96 -0
  598. package/dist/esm/trace-toolpack/causeCapture.js.map +1 -0
  599. package/dist/esm/trace-toolpack/causeControl.d.ts +6 -0
  600. package/dist/esm/trace-toolpack/causeControl.js +45 -0
  601. package/dist/esm/trace-toolpack/causeControl.js.map +1 -0
  602. package/dist/esm/trace-toolpack/causeReader.js +11 -9
  603. package/dist/esm/trace-toolpack/causeReader.js.map +1 -1
  604. package/dist/esm/trace-toolpack/causeResponse.d.ts +3 -2
  605. package/dist/esm/trace-toolpack/causeResponse.js +27 -7
  606. package/dist/esm/trace-toolpack/causeResponse.js.map +1 -1
  607. package/dist/esm/trace-toolpack/causeSnapshot.d.ts +6 -1
  608. package/dist/esm/trace-toolpack/causeSnapshot.js +26 -15
  609. package/dist/esm/trace-toolpack/causeSnapshot.js.map +1 -1
  610. package/dist/esm/trace-toolpack/causeTools.js +1 -1
  611. package/dist/esm/trace-toolpack/causeTools.js.map +1 -1
  612. package/dist/events/registry.js +2 -0
  613. package/dist/events/registry.js.map +1 -1
  614. package/dist/hosting/answeredPause.js +536 -0
  615. package/dist/hosting/answeredPause.js.map +1 -0
  616. package/dist/hosting/conformance/cases.js +80 -0
  617. package/dist/hosting/conformance/cases.js.map +1 -1
  618. package/dist/hosting/envelope.js +14 -0
  619. package/dist/hosting/envelope.js.map +1 -1
  620. package/dist/hosting/errors.js +13 -6
  621. package/dist/hosting/errors.js.map +1 -1
  622. package/dist/hosting/index.js +7 -3
  623. package/dist/hosting/index.js.map +1 -1
  624. package/dist/hosting/memorySessions.js +10 -2
  625. package/dist/hosting/memorySessions.js.map +1 -1
  626. package/dist/hosting/processLocalStore.js +31 -0
  627. package/dist/hosting/processLocalStore.js.map +1 -0
  628. package/dist/hosting/refusalStatus.js +13 -0
  629. package/dist/hosting/refusalStatus.js.map +1 -1
  630. package/dist/hosting/sessionWire.js.map +1 -1
  631. package/dist/hosting/sqliteSessions.js +27 -3
  632. package/dist/hosting/sqliteSessions.js.map +1 -1
  633. package/dist/hosting/standingAgent.js +69 -25
  634. package/dist/hosting/standingAgent.js.map +1 -1
  635. package/dist/hosting/streamHandler.js +149 -31
  636. package/dist/hosting/streamHandler.js.map +1 -1
  637. package/dist/hosting/types.js.map +1 -1
  638. package/dist/index.js +26 -21
  639. package/dist/index.js.map +1 -1
  640. package/dist/integrity/negative-claim/anchor.js +124 -0
  641. package/dist/integrity/negative-claim/anchor.js.map +1 -0
  642. package/dist/integrity/negative-claim/citation.js +371 -0
  643. package/dist/integrity/negative-claim/citation.js.map +1 -0
  644. package/dist/integrity/negative-claim/containment.js +262 -0
  645. package/dist/integrity/negative-claim/containment.js.map +1 -0
  646. package/dist/integrity/negative-claim/derive.js +130 -0
  647. package/dist/integrity/negative-claim/derive.js.map +1 -0
  648. package/dist/integrity/negative-claim/detect.js +69 -0
  649. package/dist/integrity/negative-claim/detect.js.map +1 -0
  650. package/dist/integrity/negative-claim/judge.js +100 -0
  651. package/dist/integrity/negative-claim/judge.js.map +1 -0
  652. package/dist/integrity/negative-claim/language.js +46 -0
  653. package/dist/integrity/negative-claim/language.js.map +1 -0
  654. package/dist/integrity/negative-claim/limits.js +6 -0
  655. package/dist/integrity/negative-claim/limits.js.map +1 -0
  656. package/dist/integrity/negative-claim/matcher.js +179 -0
  657. package/dist/integrity/negative-claim/matcher.js.map +1 -0
  658. package/dist/integrity/negative-claim/noRead.js +13 -0
  659. package/dist/integrity/negative-claim/noRead.js.map +1 -0
  660. package/dist/integrity/negative-claim/phrases.js +253 -0
  661. package/dist/integrity/negative-claim/phrases.js.map +1 -0
  662. package/dist/integrity/negative-claim/prose.js +147 -0
  663. package/dist/integrity/negative-claim/prose.js.map +1 -0
  664. package/dist/integrity/negative-claim/readings.js +338 -0
  665. package/dist/integrity/negative-claim/readings.js.map +1 -0
  666. package/dist/integrity/negative-claim/resolve.js +184 -0
  667. package/dist/integrity/negative-claim/resolve.js.map +1 -0
  668. package/dist/integrity/negative-claim/statement.js +369 -0
  669. package/dist/integrity/negative-claim/statement.js.map +1 -0
  670. package/dist/integrity/negative-claim/types.js +42 -0
  671. package/dist/integrity/negative-claim/types.js.map +1 -0
  672. package/dist/integrity/negative-claim/units.js +190 -0
  673. package/dist/integrity/negative-claim/units.js.map +1 -0
  674. package/dist/integrity/negative-claim/work.js +24 -0
  675. package/dist/integrity/negative-claim/work.js.map +1 -0
  676. package/dist/integrity/unsupported-claim/check.js +50 -27
  677. package/dist/integrity/unsupported-claim/check.js.map +1 -1
  678. package/dist/integrity/unsupported-claim/delivered.js +102 -0
  679. package/dist/integrity/unsupported-claim/delivered.js.map +1 -0
  680. package/dist/integrity/unsupported-claim/evaluate.js +377 -1
  681. package/dist/integrity/unsupported-claim/evaluate.js.map +1 -1
  682. package/dist/lib/conventions.js +3 -0
  683. package/dist/lib/conventions.js.map +1 -1
  684. package/dist/lib/frozenCopy.js +207 -0
  685. package/dist/lib/frozenCopy.js.map +1 -0
  686. package/dist/lib/jsonFaithful.js +115 -0
  687. package/dist/lib/jsonFaithful.js.map +1 -0
  688. package/dist/{tools → lib}/normalize.js +151 -7
  689. package/dist/lib/normalize.js.map +1 -0
  690. package/dist/lib/saidByPerson.js +4 -1
  691. package/dist/lib/saidByPerson.js.map +1 -1
  692. package/dist/mcp/toolExtras.js +11 -0
  693. package/dist/mcp/toolExtras.js.map +1 -1
  694. package/dist/provider-contract/nativeOutputSchema.js +11 -3
  695. package/dist/provider-contract/nativeOutputSchema.js.map +1 -1
  696. package/dist/provider-contract/types.js.map +1 -1
  697. package/dist/recorders/core/CheckInRecorder.js +5 -1
  698. package/dist/recorders/core/CheckInRecorder.js.map +1 -1
  699. package/dist/redaction/conversation.js +6 -0
  700. package/dist/redaction/conversation.js.map +1 -1
  701. package/dist/redaction/knownStrings.js +74 -0
  702. package/dist/redaction/knownStrings.js.map +1 -1
  703. package/dist/resilience/withCircuitBreaker.js +3 -0
  704. package/dist/resilience/withCircuitBreaker.js.map +1 -1
  705. package/dist/resilience/withFallback.js +7 -0
  706. package/dist/resilience/withFallback.js.map +1 -1
  707. package/dist/resilience/withRetry.js +3 -0
  708. package/dist/resilience/withRetry.js.map +1 -1
  709. package/dist/semantics/check.js +112 -3
  710. package/dist/semantics/check.js.map +1 -1
  711. package/dist/semantics/cli.js +32 -2
  712. package/dist/semantics/cli.js.map +1 -1
  713. package/dist/semantics/coverage/absent.js +56 -52
  714. package/dist/semantics/coverage/absent.js.map +1 -1
  715. package/dist/semantics/coverage/among.js +177 -0
  716. package/dist/semantics/coverage/among.js.map +1 -0
  717. package/dist/semantics/coverage/composedCoverage.js +46 -0
  718. package/dist/semantics/coverage/composedCoverage.js.map +1 -0
  719. package/dist/semantics/coverage/evidence.js +27 -2
  720. package/dist/semantics/coverage/evidence.js.map +1 -1
  721. package/dist/semantics/coverage/index.js +5 -1
  722. package/dist/semantics/coverage/index.js.map +1 -1
  723. package/dist/semantics/coverage/ledger.js +18 -56
  724. package/dist/semantics/coverage/ledger.js.map +1 -1
  725. package/dist/semantics/coverage/read.js.map +1 -1
  726. package/dist/semantics/coverage/recognize.js +43 -1
  727. package/dist/semantics/coverage/recognize.js.map +1 -1
  728. package/dist/semantics/coverage/search/binding.js +46 -0
  729. package/dist/semantics/coverage/search/binding.js.map +1 -0
  730. package/dist/semantics/coverage/search/compose.js +124 -0
  731. package/dist/semantics/coverage/search/compose.js.map +1 -0
  732. package/dist/semantics/coverage/search/declaration.js +462 -0
  733. package/dist/semantics/coverage/search/declaration.js.map +1 -0
  734. package/dist/semantics/coverage/search/door.js +134 -0
  735. package/dist/semantics/coverage/search/door.js.map +1 -0
  736. package/dist/semantics/coverage/search/events.js +104 -0
  737. package/dist/semantics/coverage/search/events.js.map +1 -0
  738. package/dist/semantics/coverage/search/facets.js +196 -0
  739. package/dist/semantics/coverage/search/facets.js.map +1 -0
  740. package/dist/semantics/coverage/search/gaps.js +226 -0
  741. package/dist/semantics/coverage/search/gaps.js.map +1 -0
  742. package/dist/semantics/coverage/search/inEffect.js +52 -0
  743. package/dist/semantics/coverage/search/inEffect.js.map +1 -0
  744. package/dist/semantics/coverage/search/resultFacts.js +109 -0
  745. package/dist/semantics/coverage/search/resultFacts.js.map +1 -0
  746. package/dist/semantics/coverage/search/review.js +93 -0
  747. package/dist/semantics/coverage/search/review.js.map +1 -0
  748. package/dist/semantics/coverage/search/served.js +137 -0
  749. package/dist/semantics/coverage/search/served.js.map +1 -0
  750. package/dist/semantics/coverage/search/span.js +66 -0
  751. package/dist/semantics/coverage/search/span.js.map +1 -0
  752. package/dist/semantics/coverage/search/statementText.js +107 -0
  753. package/dist/semantics/coverage/search/statementText.js.map +1 -0
  754. package/dist/semantics/coverage/search/types.js +12 -0
  755. package/dist/semantics/coverage/search/types.js.map +1 -0
  756. package/dist/semantics/coverage/search/valueWords.js +36 -0
  757. package/dist/semantics/coverage/search/valueWords.js.map +1 -0
  758. package/dist/semantics/described.js +3 -1
  759. package/dist/semantics/described.js.map +1 -1
  760. package/dist/semantics/envelope.js +26 -2
  761. package/dist/semantics/envelope.js.map +1 -1
  762. package/dist/semantics/index.js.map +1 -1
  763. package/dist/semantics/overclaim.js +407 -0
  764. package/dist/semantics/overclaim.js.map +1 -0
  765. package/dist/semantics/types.js.map +1 -1
  766. package/dist/time/forms.js +1 -1
  767. package/dist/time/textForms.js +1 -1
  768. package/dist/time-travel/servedView.js +51 -159
  769. package/dist/time-travel/servedView.js.map +1 -1
  770. package/dist/tools/declare.js +2 -2
  771. package/dist/tools/declare.js.map +1 -1
  772. package/dist/tools/hostFilled.js +48 -2
  773. package/dist/tools/hostFilled.js.map +1 -1
  774. package/dist/tools/searchOf.js +104 -0
  775. package/dist/tools/searchOf.js.map +1 -0
  776. package/dist/tools/tools.js +80 -2
  777. package/dist/tools/tools.js.map +1 -1
  778. package/dist/trace-toolpack/causeCapture.js +103 -0
  779. package/dist/trace-toolpack/causeCapture.js.map +1 -0
  780. package/dist/trace-toolpack/causeControl.js +49 -0
  781. package/dist/trace-toolpack/causeControl.js.map +1 -0
  782. package/dist/trace-toolpack/causeReader.js +11 -9
  783. package/dist/trace-toolpack/causeReader.js.map +1 -1
  784. package/dist/trace-toolpack/causeResponse.js +27 -7
  785. package/dist/trace-toolpack/causeResponse.js.map +1 -1
  786. package/dist/trace-toolpack/causeSnapshot.js +31 -20
  787. package/dist/trace-toolpack/causeSnapshot.js.map +1 -1
  788. package/dist/trace-toolpack/causeTools.js +1 -1
  789. package/dist/trace-toolpack/causeTools.js.map +1 -1
  790. package/dist/types/adapters/hosting/agentCoreA2A.d.ts.map +1 -1
  791. package/dist/types/adapters/hosting/firestoreSessions.d.ts.map +1 -1
  792. package/dist/types/adapters/hosting/googleAgentEngine.d.ts.map +1 -1
  793. package/dist/types/adapters/llm/AnthropicProvider.d.ts +1 -0
  794. package/dist/types/adapters/llm/AnthropicProvider.d.ts.map +1 -1
  795. package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts +1 -0
  796. package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts.map +1 -1
  797. package/dist/types/adapters/llm/MockProvider.d.ts +2 -0
  798. package/dist/types/adapters/llm/MockProvider.d.ts.map +1 -1
  799. package/dist/types/ag-ui/request.d.ts +4 -1
  800. package/dist/types/ag-ui/request.d.ts.map +1 -1
  801. package/dist/types/ag-ui/serializer.d.ts +15 -2
  802. package/dist/types/ag-ui/serializer.d.ts.map +1 -1
  803. package/dist/types/answer-account/facts/howSure.d.ts.map +1 -1
  804. package/dist/types/answer-account/templates.d.ts +4 -1
  805. package/dist/types/answer-account/templates.d.ts.map +1 -1
  806. package/dist/types/answer-validation/agentChecks.d.ts +76 -0
  807. package/dist/types/answer-validation/agentChecks.d.ts.map +1 -0
  808. package/dist/types/answer-validation/index.d.ts +2 -1
  809. package/dist/types/answer-validation/index.d.ts.map +1 -1
  810. package/dist/types/answer-validation/outputSchema.d.ts +18 -7
  811. package/dist/types/answer-validation/outputSchema.d.ts.map +1 -1
  812. package/dist/types/answer-validation/types.d.ts +125 -1
  813. package/dist/types/answer-validation/types.d.ts.map +1 -1
  814. package/dist/types/answer-validation/validate.d.ts +11 -2
  815. package/dist/types/answer-validation/validate.d.ts.map +1 -1
  816. package/dist/types/core/Agent.d.ts +25 -1
  817. package/dist/types/core/Agent.d.ts.map +1 -1
  818. package/dist/types/core/RunnerBase.d.ts.map +1 -1
  819. package/dist/types/core/agent/AgentBuilder.d.ts +43 -12
  820. package/dist/types/core/agent/AgentBuilder.d.ts.map +1 -1
  821. package/dist/types/core/agent/arguments/checks.d.ts +1 -1
  822. package/dist/types/core/agent/arguments/subflow.d.ts +6 -0
  823. package/dist/types/core/agent/arguments/subflow.d.ts.map +1 -1
  824. package/dist/types/core/agent/assessment/assess.d.ts.map +1 -1
  825. package/dist/types/core/agent/assessment/compose.d.ts.map +1 -1
  826. package/dist/types/core/agent/assessment/reasons.d.ts.map +1 -1
  827. package/dist/types/core/agent/assessment/types.d.ts +3 -2
  828. package/dist/types/core/agent/assessment/types.d.ts.map +1 -1
  829. package/dist/types/core/agent/buildAgentChart.d.ts +4 -12
  830. package/dist/types/core/agent/buildAgentChart.d.ts.map +1 -1
  831. package/dist/types/core/agent/buildDynamicAgentChart.d.ts.map +1 -1
  832. package/dist/types/core/agent/buildToolRegistry.d.ts.map +1 -1
  833. package/dist/types/core/agent/composeRequest.d.ts +19 -0
  834. package/dist/types/core/agent/composeRequest.d.ts.map +1 -1
  835. package/dist/types/core/agent/evidence/extract.d.ts +45 -6
  836. package/dist/types/core/agent/evidence/extract.d.ts.map +1 -1
  837. package/dist/types/core/agent/evidence/frames.d.ts.map +1 -1
  838. package/dist/types/core/agent/evidence/gate.d.ts +6 -0
  839. package/dist/types/core/agent/evidence/gate.d.ts.map +1 -1
  840. package/dist/types/core/agent/evidence/recovery.d.ts +2 -0
  841. package/dist/types/core/agent/evidence/recovery.d.ts.map +1 -1
  842. package/dist/types/core/agent/evidence/resultCarries.d.ts +2 -2
  843. package/dist/types/core/agent/evidence/types.d.ts +17 -0
  844. package/dist/types/core/agent/evidence/types.d.ts.map +1 -1
  845. package/dist/types/core/agent/findings/context.d.ts +14 -0
  846. package/dist/types/core/agent/findings/context.d.ts.map +1 -0
  847. package/dist/types/core/agent/findings/instruction.d.ts +13 -0
  848. package/dist/types/core/agent/findings/instruction.d.ts.map +1 -0
  849. package/dist/types/core/agent/findings/ledger.d.ts +3 -0
  850. package/dist/types/core/agent/findings/ledger.d.ts.map +1 -1
  851. package/dist/types/core/agent/findings/negativeProse.d.ts +2 -0
  852. package/dist/types/core/agent/findings/negativeProse.d.ts.map +1 -0
  853. package/dist/types/core/agent/findings/offer.d.ts +9 -57
  854. package/dist/types/core/agent/findings/offer.d.ts.map +1 -1
  855. package/dist/types/core/agent/findings/reserved.d.ts +7 -31
  856. package/dist/types/core/agent/findings/reserved.d.ts.map +1 -1
  857. package/dist/types/core/agent/findings/types.d.ts +11 -4
  858. package/dist/types/core/agent/findings/types.d.ts.map +1 -1
  859. package/dist/types/core/agent/honesty/mounts.d.ts +7 -0
  860. package/dist/types/core/agent/honesty/mounts.d.ts.map +1 -1
  861. package/dist/types/core/agent/nativeOutputFormat.d.ts +2 -1
  862. package/dist/types/core/agent/nativeOutputFormat.d.ts.map +1 -1
  863. package/dist/types/core/agent/negativeClaims/capture.d.ts +66 -0
  864. package/dist/types/core/agent/negativeClaims/capture.d.ts.map +1 -0
  865. package/dist/types/core/agent/negativeClaims/checkpoint.d.ts +8 -0
  866. package/dist/types/core/agent/negativeClaims/checkpoint.d.ts.map +1 -0
  867. package/dist/types/core/agent/negativeClaims/config.d.ts +67 -0
  868. package/dist/types/core/agent/negativeClaims/config.d.ts.map +1 -0
  869. package/dist/types/core/agent/negativeClaims/delivery.d.ts +25 -0
  870. package/dist/types/core/agent/negativeClaims/delivery.d.ts.map +1 -0
  871. package/dist/types/core/agent/negativeClaims/observe.d.ts +15 -0
  872. package/dist/types/core/agent/negativeClaims/observe.d.ts.map +1 -0
  873. package/dist/types/core/agent/negativeClaims/prose.d.ts +10 -0
  874. package/dist/types/core/agent/negativeClaims/prose.d.ts.map +1 -0
  875. package/dist/types/core/agent/negativeClaims/recheck.d.ts +8 -0
  876. package/dist/types/core/agent/negativeClaims/recheck.d.ts.map +1 -0
  877. package/dist/types/core/agent/outputEnforcement.d.ts +5 -1
  878. package/dist/types/core/agent/outputEnforcement.d.ts.map +1 -1
  879. package/dist/types/core/agent/receipt/receipt.d.ts +2 -2
  880. package/dist/types/core/agent/receipt/receipt.d.ts.map +1 -1
  881. package/dist/types/core/agent/stages/answerEvidence.d.ts +29 -0
  882. package/dist/types/core/agent/stages/answerEvidence.d.ts.map +1 -0
  883. package/dist/types/core/agent/stages/answerValidation.d.ts +15 -3
  884. package/dist/types/core/agent/stages/answerValidation.d.ts.map +1 -1
  885. package/dist/types/core/agent/stages/callLLM.d.ts +11 -2
  886. package/dist/types/core/agent/stages/callLLM.d.ts.map +1 -1
  887. package/dist/types/core/agent/stages/evidenceRecheck.d.ts +6 -1
  888. package/dist/types/core/agent/stages/evidenceRecheck.d.ts.map +1 -1
  889. package/dist/types/core/agent/stages/outputRetry.d.ts.map +1 -1
  890. package/dist/types/core/agent/stages/prepareFinal.d.ts.map +1 -1
  891. package/dist/types/core/agent/stages/reliabilityExecution.d.ts +3 -0
  892. package/dist/types/core/agent/stages/reliabilityExecution.d.ts.map +1 -1
  893. package/dist/types/core/agent/stages/route.d.ts +8 -2
  894. package/dist/types/core/agent/stages/route.d.ts.map +1 -1
  895. package/dist/types/core/agent/stages/searchCoverage.d.ts +95 -0
  896. package/dist/types/core/agent/stages/searchCoverage.d.ts.map +1 -0
  897. package/dist/types/core/agent/stages/seed.d.ts +10 -0
  898. package/dist/types/core/agent/stages/seed.d.ts.map +1 -1
  899. package/dist/types/core/agent/stages/toolCalls.d.ts +16 -0
  900. package/dist/types/core/agent/stages/toolCalls.d.ts.map +1 -1
  901. package/dist/types/core/agent/toolChoice/compose.d.ts +2 -0
  902. package/dist/types/core/agent/toolChoice/compose.d.ts.map +1 -1
  903. package/dist/types/core/agent/toolChoice/pick.d.ts +2 -0
  904. package/dist/types/core/agent/toolChoice/pick.d.ts.map +1 -1
  905. package/dist/types/core/agent/toolChoice/types.d.ts +1 -1
  906. package/dist/types/core/agent/toolChoice/types.d.ts.map +1 -1
  907. package/dist/types/core/agent/types.d.ts +86 -5
  908. package/dist/types/core/agent/types.d.ts.map +1 -1
  909. package/dist/types/core/checkin.d.ts +83 -7
  910. package/dist/types/core/checkin.d.ts.map +1 -1
  911. package/dist/types/core/consentRequest.d.ts +489 -0
  912. package/dist/types/core/consentRequest.d.ts.map +1 -0
  913. package/dist/types/core/pause.d.ts +88 -7
  914. package/dist/types/core/pause.d.ts.map +1 -1
  915. package/dist/types/core/runCheckpoint.d.ts +5 -1
  916. package/dist/types/core/runCheckpoint.d.ts.map +1 -1
  917. package/dist/types/core/slots/buildToolsSlot.d.ts +4 -11
  918. package/dist/types/core/slots/buildToolsSlot.d.ts.map +1 -1
  919. package/dist/types/debug.d.ts +1 -1
  920. package/dist/types/debug.d.ts.map +1 -1
  921. package/dist/types/events/payloads.d.ts +145 -3
  922. package/dist/types/events/payloads.d.ts.map +1 -1
  923. package/dist/types/events/registry.d.ts +3 -1
  924. package/dist/types/events/registry.d.ts.map +1 -1
  925. package/dist/types/hosting/answeredPause.d.ts +302 -0
  926. package/dist/types/hosting/answeredPause.d.ts.map +1 -0
  927. package/dist/types/hosting/conformance/cases.d.ts.map +1 -1
  928. package/dist/types/hosting/conformance/types.d.ts +1 -1
  929. package/dist/types/hosting/conformance/types.d.ts.map +1 -1
  930. package/dist/types/hosting/envelope.d.ts +6 -0
  931. package/dist/types/hosting/envelope.d.ts.map +1 -1
  932. package/dist/types/hosting/errors.d.ts +14 -2
  933. package/dist/types/hosting/errors.d.ts.map +1 -1
  934. package/dist/types/hosting/index.d.ts +2 -1
  935. package/dist/types/hosting/index.d.ts.map +1 -1
  936. package/dist/types/hosting/memorySessions.d.ts.map +1 -1
  937. package/dist/types/hosting/processLocalStore.d.ts +21 -0
  938. package/dist/types/hosting/processLocalStore.d.ts.map +1 -0
  939. package/dist/types/hosting/protocolAdapter.d.ts +13 -0
  940. package/dist/types/hosting/protocolAdapter.d.ts.map +1 -1
  941. package/dist/types/hosting/refusalStatus.d.ts +6 -0
  942. package/dist/types/hosting/refusalStatus.d.ts.map +1 -1
  943. package/dist/types/hosting/sessionWire.d.ts +8 -3
  944. package/dist/types/hosting/sessionWire.d.ts.map +1 -1
  945. package/dist/types/hosting/sqliteSessions.d.ts.map +1 -1
  946. package/dist/types/hosting/standingAgent.d.ts.map +1 -1
  947. package/dist/types/hosting/streamHandler.d.ts +3 -1
  948. package/dist/types/hosting/streamHandler.d.ts.map +1 -1
  949. package/dist/types/hosting/types.d.ts +28 -6
  950. package/dist/types/hosting/types.d.ts.map +1 -1
  951. package/dist/types/index.d.ts +7 -3
  952. package/dist/types/index.d.ts.map +1 -1
  953. package/dist/types/integrity/negative-claim/anchor.d.ts +10 -0
  954. package/dist/types/integrity/negative-claim/anchor.d.ts.map +1 -0
  955. package/dist/types/integrity/negative-claim/citation.d.ts +35 -0
  956. package/dist/types/integrity/negative-claim/citation.d.ts.map +1 -0
  957. package/dist/types/integrity/negative-claim/containment.d.ts +41 -0
  958. package/dist/types/integrity/negative-claim/containment.d.ts.map +1 -0
  959. package/dist/types/integrity/negative-claim/derive.d.ts +18 -0
  960. package/dist/types/integrity/negative-claim/derive.d.ts.map +1 -0
  961. package/dist/types/integrity/negative-claim/detect.d.ts +45 -0
  962. package/dist/types/integrity/negative-claim/detect.d.ts.map +1 -0
  963. package/dist/types/integrity/negative-claim/judge.d.ts +42 -0
  964. package/dist/types/integrity/negative-claim/judge.d.ts.map +1 -0
  965. package/dist/types/integrity/negative-claim/language.d.ts +15 -0
  966. package/dist/types/integrity/negative-claim/language.d.ts.map +1 -0
  967. package/dist/types/integrity/negative-claim/limits.d.ts +3 -0
  968. package/dist/types/integrity/negative-claim/limits.d.ts.map +1 -0
  969. package/dist/types/integrity/negative-claim/matcher.d.ts +52 -0
  970. package/dist/types/integrity/negative-claim/matcher.d.ts.map +1 -0
  971. package/dist/types/integrity/negative-claim/noRead.d.ts +9 -0
  972. package/dist/types/integrity/negative-claim/noRead.d.ts.map +1 -0
  973. package/dist/types/integrity/negative-claim/phrases.d.ts +70 -0
  974. package/dist/types/integrity/negative-claim/phrases.d.ts.map +1 -0
  975. package/dist/types/integrity/negative-claim/prose.d.ts +37 -0
  976. package/dist/types/integrity/negative-claim/prose.d.ts.map +1 -0
  977. package/dist/types/integrity/negative-claim/readings.d.ts +82 -0
  978. package/dist/types/integrity/negative-claim/readings.d.ts.map +1 -0
  979. package/dist/types/integrity/negative-claim/resolve.d.ts +38 -0
  980. package/dist/types/integrity/negative-claim/resolve.d.ts.map +1 -0
  981. package/dist/types/integrity/negative-claim/statement.d.ts +76 -0
  982. package/dist/types/integrity/negative-claim/statement.d.ts.map +1 -0
  983. package/dist/types/integrity/negative-claim/types.d.ts +145 -0
  984. package/dist/types/integrity/negative-claim/types.d.ts.map +1 -0
  985. package/dist/types/integrity/negative-claim/units.d.ts +34 -0
  986. package/dist/types/integrity/negative-claim/units.d.ts.map +1 -0
  987. package/dist/types/integrity/negative-claim/work.d.ts +13 -0
  988. package/dist/types/integrity/negative-claim/work.d.ts.map +1 -0
  989. package/dist/types/integrity/unsupported-claim/check.d.ts +33 -0
  990. package/dist/types/integrity/unsupported-claim/check.d.ts.map +1 -1
  991. package/dist/types/integrity/unsupported-claim/delivered.d.ts +73 -0
  992. package/dist/types/integrity/unsupported-claim/delivered.d.ts.map +1 -0
  993. package/dist/types/integrity/unsupported-claim/evaluate.d.ts +103 -1
  994. package/dist/types/integrity/unsupported-claim/evaluate.d.ts.map +1 -1
  995. package/dist/types/lib/conventions.d.ts +1 -0
  996. package/dist/types/lib/conventions.d.ts.map +1 -1
  997. package/dist/types/lib/frozenCopy.d.ts +76 -0
  998. package/dist/types/lib/frozenCopy.d.ts.map +1 -0
  999. package/dist/types/lib/jsonFaithful.d.ts +35 -0
  1000. package/dist/types/lib/jsonFaithful.d.ts.map +1 -0
  1001. package/dist/types/lib/normalize.d.ts +97 -0
  1002. package/dist/types/lib/normalize.d.ts.map +1 -0
  1003. package/dist/types/lib/saidByPerson.d.ts +2 -0
  1004. package/dist/types/lib/saidByPerson.d.ts.map +1 -1
  1005. package/dist/types/mcp/toolExtras.d.ts +10 -0
  1006. package/dist/types/mcp/toolExtras.d.ts.map +1 -1
  1007. package/dist/types/provider-contract/nativeOutputSchema.d.ts +6 -2
  1008. package/dist/types/provider-contract/nativeOutputSchema.d.ts.map +1 -1
  1009. package/dist/types/provider-contract/types.d.ts +12 -1
  1010. package/dist/types/provider-contract/types.d.ts.map +1 -1
  1011. package/dist/types/recorders/core/CheckInRecorder.d.ts +6 -1
  1012. package/dist/types/recorders/core/CheckInRecorder.d.ts.map +1 -1
  1013. package/dist/types/redaction/conversation.d.ts.map +1 -1
  1014. package/dist/types/redaction/knownStrings.d.ts +9 -7
  1015. package/dist/types/redaction/knownStrings.d.ts.map +1 -1
  1016. package/dist/types/resilience/withCircuitBreaker.d.ts.map +1 -1
  1017. package/dist/types/resilience/withFallback.d.ts.map +1 -1
  1018. package/dist/types/resilience/withRetry.d.ts.map +1 -1
  1019. package/dist/types/semantics/check.d.ts +44 -2
  1020. package/dist/types/semantics/check.d.ts.map +1 -1
  1021. package/dist/types/semantics/cli.d.ts.map +1 -1
  1022. package/dist/types/semantics/coverage/absent.d.ts +19 -2
  1023. package/dist/types/semantics/coverage/absent.d.ts.map +1 -1
  1024. package/dist/types/semantics/coverage/among.d.ts +74 -0
  1025. package/dist/types/semantics/coverage/among.d.ts.map +1 -0
  1026. package/dist/types/semantics/coverage/composedCoverage.d.ts +221 -0
  1027. package/dist/types/semantics/coverage/composedCoverage.d.ts.map +1 -0
  1028. package/dist/types/semantics/coverage/evidence.d.ts.map +1 -1
  1029. package/dist/types/semantics/coverage/index.d.ts +4 -1
  1030. package/dist/types/semantics/coverage/index.d.ts.map +1 -1
  1031. package/dist/types/semantics/coverage/ledger.d.ts +2 -1
  1032. package/dist/types/semantics/coverage/ledger.d.ts.map +1 -1
  1033. package/dist/types/semantics/coverage/read.d.ts +19 -0
  1034. package/dist/types/semantics/coverage/read.d.ts.map +1 -1
  1035. package/dist/types/semantics/coverage/recognize.d.ts +17 -1
  1036. package/dist/types/semantics/coverage/recognize.d.ts.map +1 -1
  1037. package/dist/types/semantics/coverage/search/binding.d.ts +28 -0
  1038. package/dist/types/semantics/coverage/search/binding.d.ts.map +1 -0
  1039. package/dist/types/semantics/coverage/search/compose.d.ts +91 -0
  1040. package/dist/types/semantics/coverage/search/compose.d.ts.map +1 -0
  1041. package/dist/types/semantics/coverage/search/declaration.d.ts +76 -0
  1042. package/dist/types/semantics/coverage/search/declaration.d.ts.map +1 -0
  1043. package/dist/types/semantics/coverage/search/door.d.ts +47 -0
  1044. package/dist/types/semantics/coverage/search/door.d.ts.map +1 -0
  1045. package/dist/types/semantics/coverage/search/events.d.ts +43 -0
  1046. package/dist/types/semantics/coverage/search/events.d.ts.map +1 -0
  1047. package/dist/types/semantics/coverage/search/facets.d.ts +53 -0
  1048. package/dist/types/semantics/coverage/search/facets.d.ts.map +1 -0
  1049. package/dist/types/semantics/coverage/search/gaps.d.ts +64 -0
  1050. package/dist/types/semantics/coverage/search/gaps.d.ts.map +1 -0
  1051. package/dist/types/semantics/coverage/search/inEffect.d.ts +66 -0
  1052. package/dist/types/semantics/coverage/search/inEffect.d.ts.map +1 -0
  1053. package/dist/types/semantics/coverage/search/resultFacts.d.ts +43 -0
  1054. package/dist/types/semantics/coverage/search/resultFacts.d.ts.map +1 -0
  1055. package/dist/types/semantics/coverage/search/review.d.ts +37 -0
  1056. package/dist/types/semantics/coverage/search/review.d.ts.map +1 -0
  1057. package/dist/types/semantics/coverage/search/served.d.ts +52 -0
  1058. package/dist/types/semantics/coverage/search/served.d.ts.map +1 -0
  1059. package/dist/types/semantics/coverage/search/span.d.ts +35 -0
  1060. package/dist/types/semantics/coverage/search/span.d.ts.map +1 -0
  1061. package/dist/types/semantics/coverage/search/statementText.d.ts +47 -0
  1062. package/dist/types/semantics/coverage/search/statementText.d.ts.map +1 -0
  1063. package/dist/types/semantics/coverage/search/types.d.ts +121 -0
  1064. package/dist/types/semantics/coverage/search/types.d.ts.map +1 -0
  1065. package/dist/types/semantics/coverage/search/valueWords.d.ts +23 -0
  1066. package/dist/types/semantics/coverage/search/valueWords.d.ts.map +1 -0
  1067. package/dist/types/semantics/coverage/types.d.ts +163 -0
  1068. package/dist/types/semantics/coverage/types.d.ts.map +1 -1
  1069. package/dist/types/semantics/described.d.ts.map +1 -1
  1070. package/dist/types/semantics/envelope.d.ts.map +1 -1
  1071. package/dist/types/semantics/index.d.ts +2 -1
  1072. package/dist/types/semantics/index.d.ts.map +1 -1
  1073. package/dist/types/semantics/overclaim.d.ts +106 -0
  1074. package/dist/types/semantics/overclaim.d.ts.map +1 -0
  1075. package/dist/types/semantics/types.d.ts +13 -0
  1076. package/dist/types/semantics/types.d.ts.map +1 -1
  1077. package/dist/types/time-travel/servedView.d.ts +2 -2
  1078. package/dist/types/time-travel/servedView.d.ts.map +1 -1
  1079. package/dist/types/tools/declare.d.ts +1 -1
  1080. package/dist/types/tools/hostFilled.d.ts +20 -1
  1081. package/dist/types/tools/hostFilled.d.ts.map +1 -1
  1082. package/dist/types/tools/searchOf.d.ts +61 -0
  1083. package/dist/types/tools/searchOf.d.ts.map +1 -0
  1084. package/dist/types/tools/tools.d.ts +49 -0
  1085. package/dist/types/tools/tools.d.ts.map +1 -1
  1086. package/dist/types/trace-toolpack/causeCapture.d.ts +18 -0
  1087. package/dist/types/trace-toolpack/causeCapture.d.ts.map +1 -0
  1088. package/dist/types/trace-toolpack/causeControl.d.ts +7 -0
  1089. package/dist/types/trace-toolpack/causeControl.d.ts.map +1 -0
  1090. package/dist/types/trace-toolpack/causeReader.d.ts.map +1 -1
  1091. package/dist/types/trace-toolpack/causeResponse.d.ts +3 -2
  1092. package/dist/types/trace-toolpack/causeResponse.d.ts.map +1 -1
  1093. package/dist/types/trace-toolpack/causeSnapshot.d.ts +6 -1
  1094. package/dist/types/trace-toolpack/causeSnapshot.d.ts.map +1 -1
  1095. package/package.json +3 -2
  1096. package/dist/esm/tools/normalize.d.ts +0 -43
  1097. package/dist/esm/tools/normalize.js.map +0 -1
  1098. package/dist/tools/normalize.js.map +0 -1
  1099. package/dist/types/tools/normalize.d.ts +0 -44
  1100. package/dist/types/tools/normalize.d.ts.map +0 -1
@@ -1,8 +1,11 @@
1
1
  import type { TypedScope } from 'footprintjs';
2
2
  import { type ResolvedAnswerValidation } from '../../../answer-validation/index.js';
3
3
  import type { ArtifactStore } from '../../../artifacts/types.js';
4
- import type { OutputSchemaParser } from '../../../answer-validation/outputSchema.js';
4
+ import { type OutputSchemaParser } from '../../../answer-validation/outputSchema.js';
5
+ import type { DeclaredClaim } from '../../../integrity/unsupported-claim/check.js';
5
6
  import type { AgentState } from '../types.js';
7
+ import { type NegativeDeliveryConfig } from '../negativeClaims/delivery.js';
8
+ import type { ResolvedNegativeClaimPhrases } from '../../../integrity/negative-claim/phrases.js';
6
9
  import type { RouteBranch } from './route.js';
7
10
  /** Wrap only the configured agent's terminal decision, in the outer scope.
8
11
  * The final branch can consume the verdict, while snapshots retain its owner.
@@ -11,5 +14,14 @@ import type { RouteBranch } from './route.js';
11
14
  * by a break here: a decider that breaks ends the chart with the branch name
12
15
  * as its result, and a composition mounting the chart took `'final'` for the
13
16
  * agent's answer. Routed on, the chart ends with no answer and the verdict in
14
- * its state (`core/terminalVerdict.ts`). */
15
- export declare function withAnswerValidation(decide: (scope: TypedScope<AgentState>) => RouteBranch | Promise<RouteBranch>, config: ResolvedAnswerValidation, parser: OutputSchemaParser<unknown> | undefined, store: ArtifactStore | undefined, hasOutstandingConsent: () => boolean, nativeOutput?: boolean): (scope: TypedScope<AgentState>) => Promise<RouteBranch>;
17
+ * its state (`core/terminalVerdict.ts`).
18
+ *
19
+ * `claims` is the agent's `.claims()` contract, read only when
20
+ * `config.agentChecks` lists `'claims'` (refused here without one, so a listed
21
+ * check can never silently judge nothing). */
22
+ export declare function withAnswerValidation(decide: (scope: TypedScope<AgentState>) => RouteBranch | Promise<RouteBranch>, config: ResolvedAnswerValidation, parser: OutputSchemaParser<unknown> | undefined, store: ArtifactStore | undefined, hasOutstandingConsent: () => boolean, nativeOutput?: boolean, claims?: readonly DeclaredClaim[], negatives?: {
23
+ readonly config: NegativeDeliveryConfig;
24
+ readonly applicationValidation: boolean;
25
+ readonly runId: () => string;
26
+ readonly phrases?: ResolvedNegativeClaimPhrases;
27
+ }): (scope: TypedScope<AgentState>) => Promise<RouteBranch>;
@@ -1,5 +1,12 @@
1
- import { executeAnswerValidation, } from '../../../answer-validation/index.js';
1
+ import { claimChecksOf, evidenceCheckOf, executeAnswerValidation, } from '../../../answer-validation/index.js';
2
2
  import { ledgerAtCheck } from '../../../answer-validation/toolLedger.js';
3
+ import { applyOutputSchema, } from '../../../answer-validation/outputSchema.js';
4
+ import { renderNegativeCandidate, reportWithNegatives, } from '../negativeClaims/delivery.js';
5
+ import { observeNegativeProse } from '../negativeClaims/prose.js';
6
+ import { recordFindings } from '../findings/ledger.js';
7
+ import { negativeRecordOf } from '../negativeClaims/capture.js';
8
+ import { prepareNegativeCorrection } from '../negativeClaims/recheck.js';
9
+ import { takeAnswerEvidence } from './answerEvidence.js';
3
10
  /** Wrap only the configured agent's terminal decision, in the outer scope.
4
11
  * The final branch can consume the verdict, while snapshots retain its owner.
5
12
  * A refusal stops before conversation capture and memory writes — stopped by
@@ -7,12 +14,28 @@ import { ledgerAtCheck } from '../../../answer-validation/toolLedger.js';
7
14
  * by a break here: a decider that breaks ends the chart with the branch name
8
15
  * as its result, and a composition mounting the chart took `'final'` for the
9
16
  * agent's answer. Routed on, the chart ends with no answer and the verdict in
10
- * its state (`core/terminalVerdict.ts`). */
11
- export function withAnswerValidation(decide, config, parser, store, hasOutstandingConsent, nativeOutput = false) {
17
+ * its state (`core/terminalVerdict.ts`).
18
+ *
19
+ * `claims` is the agent's `.claims()` contract, read only when
20
+ * `config.agentChecks` lists `'claims'` (refused here without one, so a listed
21
+ * check can never silently judge nothing). */
22
+ export function withAnswerValidation(decide, config, parser, store, hasOutstandingConsent, nativeOutput = false, claims, negatives) {
12
23
  if (parser === undefined) {
13
24
  throw new Error('Agent.answerValidation requires .outputSchema(parser).');
14
25
  }
26
+ const declaredClaims = claims ?? [];
27
+ if (config.agentChecks.includes('claims') && declaredClaims.length === 0) {
28
+ throw new Error("Agent.answerValidation({ agentChecks: ['claims'] }) requires .claims().");
29
+ }
30
+ // Reserve agent-owned row identities even when the app listed no checks.
31
+ // An app validator cannot mint the checker's own evidence verdicts.
32
+ const effectiveConfig = negatives === undefined || config.agentChecks.includes('negative-claims')
33
+ ? config
34
+ : { ...config, agentChecks: [...config.agentChecks, 'negative-claims'] };
15
35
  return async (scope) => {
36
+ // Even a provider that ignores the no-tools repair request cannot dispatch.
37
+ if (negatives !== undefined && scope.toolsOffAfterRevision === true)
38
+ scope.llmLatestToolCalls = [];
16
39
  const branch = await decide(scope);
17
40
  if (branch !== 'final')
18
41
  return branch;
@@ -48,8 +71,57 @@ export function withAnswerValidation(decide, config, parser, store, hasOutstandi
48
71
  }
49
72
  return 'final';
50
73
  }
74
+ let raw = scope.llmLatestContent;
75
+ let candidateParser = parser;
76
+ let prepared;
77
+ if (negatives !== undefined) {
78
+ const record = negativeRecordOf(scope, negatives.runId());
79
+ try {
80
+ const candidate = applyOutputSchema(raw, parser);
81
+ prepared = renderNegativeCandidate(candidate, negatives.config, record, (call) => scope.negativeClaimState?.calls.find((c) => c.resultId === call.resultId)
82
+ ?.trustedContext === true && record.ledgerComplete);
83
+ const overclaims = scope.negativeClaimState?.overclaims.filter((row) => row.turn === record.turn) ?? [];
84
+ if (overclaims.length > 0)
85
+ prepared.answer = {
86
+ ...prepared.answer,
87
+ checks: [
88
+ ...prepared.answer.checks,
89
+ ...overclaims.map((row, index) => ({
90
+ id: `agent:negative-claims:declaration:${index}`,
91
+ path: '/',
92
+ index,
93
+ kind: 'unknown',
94
+ code: 'declaration-overclaimed',
95
+ disposition: 'not-applicable',
96
+ tools: [row.tool],
97
+ results: [],
98
+ })),
99
+ ],
100
+ };
101
+ if (prepared.correction && prepareNegativeCorrection(scope, record, negatives.config.field))
102
+ return 'negative-recheck';
103
+ // Observe the model's original strings, never the statements just composed
104
+ // by the library. Rejected correction drafts return before this writer.
105
+ const prose = observeNegativeProse(candidate, record, negatives.config.field, negatives.phrases);
106
+ recordFindings(scope, prose.map((row) => ({ ...row, iteration: scope.iteration })), { turn: record.turn });
107
+ if (prose.length > 0 && prepared.answer.delivery === 'as-checked') {
108
+ prepared.answer = { ...prepared.answer, delivery: 'recorded' };
109
+ }
110
+ raw = JSON.stringify(prepared.candidate);
111
+ candidateParser = { parse: (value) => value };
112
+ scope.answerNegatives = prepared.answer;
113
+ }
114
+ catch {
115
+ // The app's parser was already invoked once; do not repeat a stateful parser.
116
+ candidateParser = {
117
+ parse: () => {
118
+ throw new Error('Negative candidate could not be admitted.');
119
+ },
120
+ };
121
+ }
122
+ }
51
123
  const identity = scope.runIdentity;
52
- const result = await executeAnswerValidation(scope.llmLatestContent, parser, config, store, {
124
+ const result = await executeAnswerValidation(raw, candidateParser, effectiveConfig, store, {
53
125
  conversationId: identity.conversationId,
54
126
  ...(identity.tenant !== undefined && { tenant: identity.tenant }),
55
127
  ...(identity.principal !== undefined && { principal: identity.principal }),
@@ -59,7 +131,22 @@ export function withAnswerValidation(decide, config, parser, store, hasOutstandi
59
131
  // call is open or the last reply's calls never went out (this is the
60
132
  // terminal branch, so they never will). `executeAnswerValidation`
61
133
  // detaches and freezes it before the check runs.
62
- ledgerAtCheck(scope.toolCallLedger, undispatchedCalls(scope)));
134
+ ledgerAtCheck(scope.toolCallLedger, undispatchedCalls(scope)), agentRowsFor(scope, effectiveConfig, declaredClaims));
135
+ if (negatives !== undefined) {
136
+ const appAllows = !negatives.applicationValidation ||
137
+ config.mode === 'observe' ||
138
+ result.report.status === 'passed';
139
+ const allowed = prepared !== undefined && prepared.allowed && appAllows && result.report.schemaAccepted;
140
+ scope.answerValidation =
141
+ prepared === undefined
142
+ ? { ...result.report, delivery: 'fallback' }
143
+ : reportWithNegatives(result.report, prepared.answer, allowed);
144
+ if (!allowed)
145
+ scope.answerValidationBlocked = true;
146
+ else
147
+ scope.llmLatestContent = result.content ?? raw;
148
+ return 'final';
149
+ }
63
150
  scope.answerValidation = result.report;
64
151
  if (config.mode === 'enforce' && result.report.status !== 'passed') {
65
152
  scope.answerValidationBlocked = true;
@@ -70,6 +157,27 @@ export function withAnswerValidation(decide, config, parser, store, hasOutstandi
70
157
  return 'final';
71
158
  };
72
159
  }
160
+ /**
161
+ * The rows of the agent's own checks this validation lists, every one judged
162
+ * on the candidate it DELIVERS (`answer-validation/agentChecks.ts`) — after
163
+ * every output transform, never the draft the Route decider judged. Reads
164
+ * state only for a listed check: this Route stage's evidence judge, the claim
165
+ * ledger for `'claims'`. `undefined` when nothing is listed.
166
+ */
167
+ function agentRowsFor(scope, config, claims) {
168
+ if (config.agentChecks.length === 0)
169
+ return undefined;
170
+ const listsEvidence = config.agentChecks.includes('names-and-numbers');
171
+ const listsClaims = config.agentChecks.includes('claims');
172
+ const judge = listsEvidence ? takeAnswerEvidence(scope) : undefined;
173
+ const ledger = listsClaims ? [...(scope.claimFacts ?? [])] : [];
174
+ const epoch = listsClaims ? scope.iteration ?? 0 : 0;
175
+ // Fixed order — the Route decider's own: the evidence gate, then the claims.
176
+ return (candidate, canonical) => [
177
+ ...(listsEvidence ? [evidenceCheckOf(judge?.(canonical))] : []),
178
+ ...(listsClaims ? claimChecksOf(claims, ledger, candidate, epoch) : []),
179
+ ];
180
+ }
73
181
  /** Calls the model asked for that the terminal branch will never dispatch:
74
182
  * the last reply's (all but a forced-output strategy's own answer tool), or —
75
183
  * on a wrapped-up turn, whose last reply was asked with the tools withheld —
@@ -1 +1 @@
1
- {"version":3,"file":"answerValidation.js","sourceRoot":"","sources":["../../../../../src/core/agent/stages/answerValidation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"answerValidation.js","sourceRoot":"","sources":["../../../../../src/core/agent/stages/answerValidation.ts"],"names":[],"mappings":"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"}
@@ -46,6 +46,12 @@ export interface CallLLMStageDeps {
46
46
  readonly withholdDraftContent?: true;
47
47
  /** Read recovery state only on an agent whose evidence gate can revise. */
48
48
  readonly hasEvidenceRecovery?: boolean;
49
+ /**
50
+ * The evidence gate's revision turns the tools off (an enforcing answer
51
+ * validation, `AgentState.toolsOffAfterRevision`). Present only then: an
52
+ * unarmed agent never reads the key.
53
+ */
54
+ readonly toolsOffAfterRevision?: true;
49
55
  /**
50
56
  * THE FINDINGS LEDGER IS ARMED (9.101.0, `.findings()`) — present only
51
57
  * then, only ever `true`. Three reads change and nothing else: the choice
@@ -92,6 +98,7 @@ export interface CallLLMStageDeps {
92
98
  * is how the rebuild collapses the way the wire did.
93
99
  */
94
100
  readonly findingsServe?: FindingsServeMode;
101
+ readonly findingsContextBytes?: number;
95
102
  /**
96
103
  * The answer-turn ask (9.103.0) — `AgentOptions.findings.answerAsk`,
97
104
  * threaded under the same gate and ONLY when it is `'quote-facts'`; absent
@@ -246,13 +253,15 @@ export interface CallLLMStageDeps {
246
253
  */
247
254
  readonly schemaTool?: LLMToolSchema;
248
255
  /**
249
- * The structured-output format the `'native'` output strategy sends
250
- * (`nativeOutputFormat.ts`). Present ONLY under that strategy: the request
256
+ * The format that `'native'` requires and `'auto'` selects when supported
257
+ * (`nativeOutputFormat.ts`). When selected, the request
251
258
  * carries it as `outputFormat`, this stage refuses a provider manifest that
252
259
  * says it did not cross, and it records `llmLatestStopReason` for the Route
253
260
  * decider. Absent, not one line of that runs.
254
261
  */
255
262
  readonly outputFormat?: NonNullable<LLMRequest['outputFormat']>;
263
+ /** Select native per effective request, otherwise retain instruction + parsing. */
264
+ readonly nativeOutputAuto?: true;
256
265
  /** v2.14+ — request-side thinking budget. When set, every LLMRequest
257
266
  * carries `thinking: { budget }` so the provider activates extended
258
267
  * thinking. Undefined = no activation (default). */
@@ -1,8 +1,10 @@
1
+ import { FINDINGS_DATA_FRAME_PREFIX } from '../../../lib/saidByPerson.js';
2
+ import { FINDINGS_LAYOUT, findingsContext, findingsContextBytes } from '../findings/context.js';
1
3
  import { captureFindingsRequest } from '../findings/admission.js';
2
4
  import { observeRequests } from '../../../provider-contract/requestObserver.js';
3
5
  import { iterationsRemainingOf } from '../../../lib/iterationBudget.js';
4
6
  import { forcedToolChoiceFor, UnsupportedToolChoiceError, } from '../../../provider-contract/forcedToolChoice.js';
5
- import { nativeOutputSchemaFor, UnsupportedNativeOutputError, } from '../../../provider-contract/nativeOutputSchema.js';
7
+ import { autoNativeOutputSchemaFor, nativeOutputSchemaFor, UnsupportedNativeOutputError, } from '../../../provider-contract/nativeOutputSchema.js';
6
8
  import { cacheStrategyFor } from '../../../cache/cacheStrategyFor.js';
7
9
  import { typedEmit } from '../../../recorders/core/typedEmit.js';
8
10
  import { wireViolationsOf } from '../../../integrity/invariant-violation/wire.js';
@@ -10,7 +12,7 @@ import { danglingReferencesOf } from '../../../integrity/dangling-reference/chec
10
12
  import { declaredEnumValuesOf, unsupportedArgumentsOf, } from '../../../integrity/unsupported-argument/check.js';
11
13
  import { toolNameOfMessage } from '../window/toolNames.js';
12
14
  import { evidenceConclusionLine, evidenceRecoveryPiece } from '../evidence/recovery.js';
13
- import { joinSystemPrompt, stripFrameworkFields } from '../composeRequest.js';
15
+ import { joinSystemPrompt, stripFrameworkFields, toolsWithheld } from '../composeRequest.js';
14
16
  import { toolBytesOf } from '../../../lib/toolBytes.js';
15
17
  import { buildReceipt, receiptPieces } from '../receipt/receipt.js';
16
18
  import { RECEIPT_KEY } from '../../../lib/conventions.js';
@@ -23,7 +25,7 @@ import { tagThinkingResponse } from '../../../thinking/dispatch.js';
23
25
  import { emitCostTick } from '../../cost.js';
24
26
  import { applyOutputSchema, } from '../../../answer-validation/outputSchema.js';
25
27
  import { carriesFindingsDecoration, splitFindings, withoutFindingsArgument, } from '../findings/reserved.js';
26
- import { collapseJudged, findingsLedgerPiece, servedToolCallIds, } from '../findings/serve.js';
28
+ import { collapseJudged, } from '../findings/serve.js';
27
29
  import { readSchemaToolAnswer } from '../outputEnforcement.js';
28
30
  import { executeWithReliability, ValidationFailure, } from './reliabilityExecution.js';
29
31
  /** The wrap-up call's tool list (9.56.0). A frozen module constant so the
@@ -78,7 +80,8 @@ function readExternalGrounds(provider) {
78
80
  function groundedTextOf(frame, committed) {
79
81
  const grounds = [];
80
82
  frame.forEach((message, i) => {
81
- if (message.role === 'assistant')
83
+ if (message.role === 'assistant' ||
84
+ (message.role === 'user' && message.content.startsWith(FINDINGS_DATA_FRAME_PREFIX)))
82
85
  return;
83
86
  const twin = committed[i];
84
87
  grounds.push(twin !== undefined && twin.role === 'tool' && twin.content === message.content
@@ -91,7 +94,7 @@ function groundedTextOf(frame, committed) {
91
94
  // reads: systemPrompt ← scope.systemPromptInjections, joined by `systemPrompt` below (the system-prompt slot's output)
92
95
  // messages ← scope.history (`history`; `messages` is its wire-only collapse of judged tool results under `.findings()` — `collapseJudged`); tools ← scope.dynamicToolSchemas (`registeredToolSchemas`), EMPTIED to EMPTY_TOOL_SCHEMAS under scope.wrapUpAsked
93
96
  // ontology piece ← scope.ontology (`ontologyPieceRecord`, under `deps.ontology` only), joined after the recovery piece
94
- // findings piece ← scope.findingsLedger (`ledgerPiece`, under `deps.hasFindingsLedger` only), joined after the ontology piece
97
+ // findings DATA ← scope.findingsLedger (under `deps.hasFindingsLedger` only), appended after committed history
95
98
  // brain ← deps.brainFor(nextSkillCursor ?? currentSkillId)
96
99
  // THIS is the wire, and it is assembled inside `buildCallLLMStage` — cite THAT, not this header,
97
100
  // when another file points at the assembly. The three slots feed it; they are not it. The staged-refs
@@ -187,23 +190,11 @@ export function buildCallLLMStage(deps) {
187
190
  // conversation the model reads and the receipt hashes what was sent.
188
191
  // Count, order, `toolCallId` and `toolName` are unchanged, so
189
192
  // `messages[i]` is still the message the cache marker's index names and
190
- // the tool_use/tool_result pair stays wire-valid; when nothing collapses
191
- // it IS `history`, the same instance. `scope.history` is never written:
192
- // the window stage stays its only writer. The PIECE quotes the ledger's
193
- // current standings under the context contract's own field meanings and
194
- // names every served result no standing covers as undeclared — the ids
195
- // come from the SAME list the rebuild derives them from, before or after
196
- // the collapse (an id is never rewritten). The piece carries no per-call
197
- // byte — it is a function of the ledger and those ids alone — because it
198
- // joins the ONE system block the cache marker covers: a re-ask that
199
- // serves the same ledger over the same ids reuses the cached prefix, and
200
- // a call after the ledger moved does not (`findings/serve.ts` · "The cache"). An
201
- // unarmed agent reads no key and serves the bytes it always did.
202
- // Both read the COMMITTED conversation, then the wire is stripped
203
- // (9.113.0): a message the batch settlement wrote is no result
204
- // (`findings/offer.ts` · `isResultMessage`) and only its marker says so —
205
- // the marker `stripFrameworkFields` takes off. Same ids, same order, same
206
- // wire; `time-travel/servedView.ts` rebuilds it the same way.
193
+ // The tool_use/tool_result pair remains valid. Collapse changes only the
194
+ // wire copy, never committed history. Current declarations and advisory
195
+ // IDs are composed later as request-only DATA, outside the cached prefix.
196
+ // Both DATA and collapse read the committed twin, whose notDispatched
197
+ // marker distinguishes a settlement notice from an actual result.
207
198
  const ledger = deps.hasFindingsLedger === true
208
199
  ? scope.findingsLedger
209
200
  : undefined;
@@ -211,9 +202,6 @@ export function buildCallLLMStage(deps) {
211
202
  ? collapseJudged(committed, ledger, deps.findingsServe ?? 'ledger-and-facts')
212
203
  : committed;
213
204
  const messages = collapsed === committed ? history : stripFrameworkFields(collapsed);
214
- const ledgerPiece = deps.hasFindingsLedger === true
215
- ? findingsLedgerPiece(ledger, servedToolCallIds(committed), deps.findingsAnswerAsk ?? 'none')
216
- : undefined;
217
205
  // ── the declared ontology, served (9.106.0) ──────────────────────────
218
206
  // ONE gated read of the run constant seed wrote; the piece is a pure
219
207
  // function of the spec and nothing else (no call number, no clock — the
@@ -253,13 +241,12 @@ export function buildCallLLMStage(deps) {
253
241
  // exempt from the evidence gate (`evidenceIndex.ts · exemptFromRun`
254
242
  // indexes every injection's rawContent), and the ledger quotes the
255
243
  // model's own words.
256
- const systemPieces = recoveryPiece === undefined && ontologyPieceRecord === undefined && ledgerPiece === undefined
244
+ const systemPieces = recoveryPiece === undefined && ontologyPieceRecord === undefined
257
245
  ? systemPromptInjections
258
246
  : [
259
247
  ...systemPromptInjections,
260
248
  ...(recoveryPiece === undefined ? [] : [recoveryPiece]),
261
249
  ...(ontologyPieceRecord === undefined ? [] : [ontologyPieceRecord]),
262
- ...(ledgerPiece === undefined ? [] : [ledgerPiece]),
263
250
  ];
264
251
  const systemPrompt = joinSystemPrompt(systemPieces);
265
252
  // Dynamic schemas — registry tools + injection-supplied tools (Skills'
@@ -279,7 +266,14 @@ export function buildCallLLMStage(deps) {
279
266
  //
280
267
  // `llm_start` reports the truth (`toolsCount: 0`, no catalog), because its
281
268
  // whole claim is what the model actually saw this call.
282
- const registeredToolSchemas = scope.wrapUpAsked === true
269
+ //
270
+ // The same seam withholds them once the evidence gate asked for its
271
+ // revision under an ENFORCING answer validation
272
+ // (`AgentState.toolsOffAfterRevision`): the answer may yet be withheld, so
273
+ // no tool that writes or sends may run again, and the library cannot tell
274
+ // one that only reads. Route refuses any call the model returns anyway.
275
+ const withheld = toolsWithheld(scope.wrapUpAsked, deps.toolsOffAfterRevision === true ? scope.toolsOffAfterRevision : undefined);
276
+ const registeredToolSchemas = withheld !== null
283
277
  ? EMPTY_TOOL_SCHEMAS
284
278
  : scope.dynamicToolSchemas ?? deps.toolSchemas;
285
279
  // Under `'tool-forced'` the schema rides along as one more tool ON THE
@@ -325,7 +319,10 @@ export function buildCallLLMStage(deps) {
325
319
  if (timeLine !== undefined &&
326
320
  timeLine.iteration === iteration &&
327
321
  timeLine.text.length > 0 &&
328
- scope.wrapUpAsked !== true) {
322
+ // `wrapUpAsked` is read here as it always was (an unarmed agent's reads
323
+ // are unchanged); `withheld` adds the revision's rule.
324
+ scope.wrapUpAsked !== true &&
325
+ withheld === null) {
329
326
  const line = { role: 'user', content: timeLine.text };
330
327
  requestOnly.push({ message: line, reason: 'time-window-line' });
331
328
  wireMessages = [...wireMessages, line];
@@ -342,6 +339,18 @@ export function buildCallLLMStage(deps) {
342
339
  requestOnly.push({ message: line, reason: 'evidence-conclusion' });
343
340
  wireMessages = [...wireMessages, line];
344
341
  }
342
+ if (deps.hasFindingsLedger === true) {
343
+ // A resumed leg can have a different host configuration from its checkpoint.
344
+ // Record the layout actually used by THIS call; replay reads its commit.
345
+ scope.findingsLayout = FINDINGS_LAYOUT;
346
+ scope.findingsContextBytes = findingsContextBytes(deps.findingsContextBytes);
347
+ const line = {
348
+ role: 'user',
349
+ content: findingsContext(committed, ledger, deps.findingsContextBytes),
350
+ };
351
+ requestOnly.push({ message: line, reason: 'findings-data' });
352
+ wireMessages = [...wireMessages, line];
353
+ }
345
354
  typedEmit(scope, 'agentfootprint.stream.llm_start', {
346
355
  iteration,
347
356
  provider: provider.name,
@@ -369,7 +378,19 @@ export function buildCallLLMStage(deps) {
369
378
  ...(deps.temperature !== undefined && { temperature: deps.temperature }),
370
379
  });
371
380
  const startMs = Date.now();
372
- const baseRequest = {
381
+ // Auto follows the actual provider/model, including cache-selected models
382
+ // and each reliability fallback. Explicit strategies retain their refusals.
383
+ const selectOutputFormat = (request, selected) => {
384
+ if (deps.nativeOutputAuto !== true || deps.outputFormat === undefined)
385
+ return request;
386
+ if (autoNativeOutputSchemaFor(selected, request.model)) {
387
+ return { ...request, outputFormat: deps.outputFormat };
388
+ }
389
+ const { outputFormat: _unused, ...ordinary } = request;
390
+ void _unused;
391
+ return ordinary;
392
+ };
393
+ const baseRequest = selectOutputFormat({
373
394
  ...(systemPrompt.length > 0 && { systemPrompt }),
374
395
  messages: wireMessages,
375
396
  ...(activeToolSchemas.length > 0 && { tools: activeToolSchemas }),
@@ -383,7 +404,7 @@ export function buildCallLLMStage(deps) {
383
404
  toolChoice: { type: 'tool', name: deps.schemaTool.name },
384
405
  }),
385
406
  ...(deps.outputFormat !== undefined && { outputFormat: deps.outputFormat }),
386
- };
407
+ }, provider);
387
408
  // v2.6+ — call cache strategy to attach provider-specific cache
388
409
  // hints. CacheGate has already routed (apply-markers / no-markers)
389
410
  // and populated scope.cacheMarkers accordingly. Strategy.prepareRequest
@@ -398,7 +419,7 @@ export function buildCallLLMStage(deps) {
398
419
  recentHitRate: scope.recentHitRate,
399
420
  cachingDisabled: scope.cachingDisabled ?? false,
400
421
  });
401
- const llmRequest = cachePrepared.request;
422
+ const llmRequest = selectOutputFormat(cachePrepared.request, provider);
402
423
  // Judge the final request on the effective brain/configured model, not
403
424
  // the agent's build-time default. This is before provider I/O and outside
404
425
  // the reliability loop: retrying cannot repair an unsupported contract.
@@ -437,7 +458,8 @@ export function buildCallLLMStage(deps) {
437
458
  requestOnly,
438
459
  tools: activeToolSchemas,
439
460
  forced: deps.schemaTool?.name ?? null,
440
- withheld: scope.wrapUpAsked === true ? 'wrap-up' : null,
461
+ // Read as it always was; the revision's rule rides `withheld`.
462
+ withheld: scope.wrapUpAsked === true ? 'wrap-up' : withheld,
441
463
  baseRequest,
442
464
  preparedRequest: llmRequest,
443
465
  // The breakpoints the strategy really APPLIED, not the candidates it
@@ -533,7 +555,8 @@ export function buildCallLLMStage(deps) {
533
555
  // iterations. Named to avoid shadowing `singleProviderCall`'s own
534
556
  // `hooks` parameter, which is the unrelated `{ onFirstChunk }` bag.
535
557
  const providerHooks = resilienceHooks(scope, deps.recordReceipt !== false, deps.onReplayPrepared);
536
- let answeredBy = { provider: provider.name, model };
558
+ let answeredBy = { provider: provider.name, model, native: false };
559
+ let localFallback = false;
537
560
  let acceptedFindingsRequest;
538
561
  // THE RUN'S SIGNAL REACHES THE WIRE. Every attempt carries it on its
539
562
  // request (`LLMRequest.signal`), so an aborted or timed-out run cancels the
@@ -548,6 +571,7 @@ export function buildCallLLMStage(deps) {
548
571
  const runSignal = scope.$getEnv?.()?.signal;
549
572
  const singleProviderCall = async (req, hooks) => {
550
573
  const selectedProvider = hooks.provider ?? provider;
574
+ req = selectOutputFormat(req, selectedProvider);
551
575
  assertForcedRequestSupported(selectedProvider, req);
552
576
  throwIfAborted(runSignal);
553
577
  const attempts = replayAttempts(withRequestSignal(req, runSignal), hooks.providerHooks ?? providerHooks);
@@ -666,7 +690,11 @@ export function buildCallLLMStage(deps) {
666
690
  const answered = hooks.providerIndex === undefined
667
691
  ? resp
668
692
  : tagThinkingResponse(resp, String(hooks.providerIndex));
669
- answeredBy = { provider: selectedProvider.name, model: req.model };
693
+ answeredBy = {
694
+ provider: selectedProvider.name,
695
+ model: req.model,
696
+ native: req.outputFormat !== undefined,
697
+ };
670
698
  acceptedFindingsRequest = candidate;
671
699
  return attempts.response(answered);
672
700
  };
@@ -719,14 +747,22 @@ export function buildCallLLMStage(deps) {
719
747
  response = await executeWithReliability(scope, llmRequest, deps.reliability, provider, provider.name, model, singleProviderCall, postValidate, {
720
748
  ...(deps.withholdDraftContent === true && { withholdDraftContent: true }),
721
749
  providerHooks,
722
- ...(deps.findings === true && {
750
+ ...((deps.findings === true || deps.outputFormat !== undefined) && {
723
751
  prepareFallback: (request) => {
724
- const witness = captureFindingsRequest(request, committed, iteration);
752
+ const witness = deps.findings === true
753
+ ? captureFindingsRequest(request, committed, iteration)
754
+ : undefined;
725
755
  return () => {
756
+ // A callback may return arbitrary text; it did not inherit
757
+ // native generation from the provider response it replaces.
758
+ localFallback = true;
726
759
  acceptedFindingsRequest = witness;
727
760
  };
728
761
  },
729
762
  }),
763
+ ...(deps.outputFormat !== undefined && {
764
+ isTerminalRefusal: (response) => answeredBy.native && response.stopReason === 'refusal',
765
+ }),
730
766
  });
731
767
  // `executeWithReliability` returns `undefined` when it took the
732
768
  // fail-fast path. It already wrote scope state and called
@@ -752,13 +788,16 @@ export function buildCallLLMStage(deps) {
752
788
  if (typeof response.usage.cacheRead === 'number') {
753
789
  scope.totalCacheReadTokens = (scope.totalCacheReadTokens ?? 0) + response.usage.cacheRead;
754
790
  }
755
- // `'native'` only. A provider that states its manifest (wireManifest.ts)
791
+ const nativeOutput = deps.outputFormat !== undefined &&
792
+ !localFallback &&
793
+ (deps.nativeOutputAuto !== true || answeredBy.native);
794
+ // A provider that states its manifest (wireManifest.ts)
756
795
  // and says no format crossed sent the request unconstrained while it
757
796
  // declared the capability — refused, never delivered as constrained.
758
- if (deps.outputFormat !== undefined &&
797
+ if (nativeOutput &&
759
798
  response.wireManifest !== undefined &&
760
799
  response.wireManifest.outputFormat === undefined) {
761
- throw new Error(`Agent: .outputSchema(parser, { strategy: 'native' }) — '${answeredBy.provider}' ` +
800
+ throw new Error(`Agent: native structured output — '${answeredBy.provider}' ` +
762
801
  `declares a native structured-output format, but its wire manifest says the request ` +
763
802
  `it sent carried none. The answer was not constrained, so it is not delivered as if ` +
764
803
  `it were.`);
@@ -768,12 +807,14 @@ export function buildCallLLMStage(deps) {
768
807
  acceptedFindingsRequest === undefined ? undefined : [acceptedFindingsRequest];
769
808
  scope.llmLatestContent = response.content;
770
809
  scope.llmLatestToolCalls = response.toolCalls;
771
- // `'native'` only, every call (so it is never stale): the stop reason the
810
+ // Native candidates only, every call (so it is never stale): the stop reason the
772
811
  // Route decider judges a constrained answer by — a 'refusal' or
773
812
  // 'max_tokens' stop does not hold the format (outputEnforcement.ts ·
774
813
  // nativeStopFailure). Absent on every other agent, so their bytes are unchanged.
775
- if (deps.outputFormat !== undefined)
776
- scope.llmLatestStopReason = response.stopReason;
814
+ if (deps.outputFormat !== undefined) {
815
+ scope.llmLatestStopReason = nativeOutput ? response.stopReason : undefined;
816
+ scope.llmLatestNativeOutput = nativeOutput;
817
+ }
777
818
  // A response owns its replay evidence, never the previous response's.
778
819
  // The presence trap does not record a read on never-replay providers.
779
820
  if (response.replay !== undefined || 'llmLatestReplay' in scope) {
@@ -892,7 +933,7 @@ export function buildCallLLMStage(deps) {
892
933
  // so a value that exists only there must not excuse an
893
934
  // argument. Either request-only piece narrows the credited
894
935
  // system text to the trusted injections.
895
- ...(recoveryPiece === undefined && ledgerPiece === undefined
936
+ ...(recoveryPiece === undefined
896
937
  ? llmRequest.systemPrompt === undefined
897
938
  ? []
898
939
  : [llmRequest.systemPrompt]