agentfootprint 10.10.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 (1023) hide show
  1. package/AGENTS.md +14 -4
  2. package/CAPABILITIES.md +14 -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 +189 -30
  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 +127 -17
  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 +4 -0
  51. package/dist/core/agent/buildAgentChart.js.map +1 -1
  52. package/dist/core/agent/buildDynamicAgentChart.js +17 -3
  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/gate.js +10 -2
  67. package/dist/core/agent/evidence/gate.js.map +1 -1
  68. package/dist/core/agent/evidence/numericRanges.js +1 -1
  69. package/dist/core/agent/evidence/numericRanges.js.map +1 -1
  70. package/dist/core/agent/evidence/recovery.js +3 -1
  71. package/dist/core/agent/evidence/recovery.js.map +1 -1
  72. package/dist/core/agent/evidence/resultCarries.js +3 -3
  73. package/dist/core/agent/evidence/resultCarries.js.map +1 -1
  74. package/dist/core/agent/findings/contingent.js +1 -1
  75. package/dist/core/agent/findings/contingent.js.map +1 -1
  76. package/dist/core/agent/findings/ledger.js +49 -0
  77. package/dist/core/agent/findings/ledger.js.map +1 -1
  78. package/dist/core/agent/findings/negativeProse.js +53 -0
  79. package/dist/core/agent/findings/negativeProse.js.map +1 -0
  80. package/dist/core/agent/findings/types.js +3 -2
  81. package/dist/core/agent/findings/types.js.map +1 -1
  82. package/dist/core/agent/honesty/mounts.js +6 -0
  83. package/dist/core/agent/honesty/mounts.js.map +1 -1
  84. package/dist/core/agent/nativeOutputFormat.js +19 -1
  85. package/dist/core/agent/nativeOutputFormat.js.map +1 -1
  86. package/dist/core/agent/negativeClaims/capture.js +522 -0
  87. package/dist/core/agent/negativeClaims/capture.js.map +1 -0
  88. package/dist/core/agent/negativeClaims/checkpoint.js +83 -0
  89. package/dist/core/agent/negativeClaims/checkpoint.js.map +1 -0
  90. package/dist/core/agent/negativeClaims/config.js +192 -0
  91. package/dist/core/agent/negativeClaims/config.js.map +1 -0
  92. package/dist/core/agent/negativeClaims/delivery.js +249 -0
  93. package/dist/core/agent/negativeClaims/delivery.js.map +1 -0
  94. package/dist/core/agent/negativeClaims/observe.js +38 -0
  95. package/dist/core/agent/negativeClaims/observe.js.map +1 -0
  96. package/dist/core/agent/negativeClaims/prose.js +116 -0
  97. package/dist/core/agent/negativeClaims/prose.js.map +1 -0
  98. package/dist/core/agent/negativeClaims/recheck.js +37 -0
  99. package/dist/core/agent/negativeClaims/recheck.js.map +1 -0
  100. package/dist/core/agent/outputEnforcement.js.map +1 -1
  101. package/dist/core/agent/stages/answerEvidence.js +21 -0
  102. package/dist/core/agent/stages/answerEvidence.js.map +1 -0
  103. package/dist/core/agent/stages/answerValidation.js +112 -4
  104. package/dist/core/agent/stages/answerValidation.js.map +1 -1
  105. package/dist/core/agent/stages/callLLM.js +58 -16
  106. package/dist/core/agent/stages/callLLM.js.map +1 -1
  107. package/dist/core/agent/stages/evidenceRecheck.js +16 -2
  108. package/dist/core/agent/stages/evidenceRecheck.js.map +1 -1
  109. package/dist/core/agent/stages/outputRetry.js +23 -7
  110. package/dist/core/agent/stages/outputRetry.js.map +1 -1
  111. package/dist/core/agent/stages/prepareFinal.js +6 -1
  112. package/dist/core/agent/stages/prepareFinal.js.map +1 -1
  113. package/dist/core/agent/stages/reliabilityExecution.js +3 -0
  114. package/dist/core/agent/stages/reliabilityExecution.js.map +1 -1
  115. package/dist/core/agent/stages/route.js +81 -33
  116. package/dist/core/agent/stages/route.js.map +1 -1
  117. package/dist/core/agent/stages/searchCoverage.js +121 -0
  118. package/dist/core/agent/stages/searchCoverage.js.map +1 -0
  119. package/dist/core/agent/stages/seed.js +13 -1
  120. package/dist/core/agent/stages/seed.js.map +1 -1
  121. package/dist/core/agent/stages/toolCalls.js +699 -76
  122. package/dist/core/agent/stages/toolCalls.js.map +1 -1
  123. package/dist/core/agent/toolChoice/compose.js +1 -0
  124. package/dist/core/agent/toolChoice/compose.js.map +1 -1
  125. package/dist/core/agent/toolChoice/pick.js +2 -0
  126. package/dist/core/agent/toolChoice/pick.js.map +1 -1
  127. package/dist/core/checkin.js +82 -18
  128. package/dist/core/checkin.js.map +1 -1
  129. package/dist/core/consentRequest.js +844 -0
  130. package/dist/core/consentRequest.js.map +1 -0
  131. package/dist/core/pause.js +104 -6
  132. package/dist/core/pause.js.map +1 -1
  133. package/dist/core/runCheckpoint.js +8 -1
  134. package/dist/core/runCheckpoint.js.map +1 -1
  135. package/dist/core/slots/buildToolsSlot.js +1 -0
  136. package/dist/core/slots/buildToolsSlot.js.map +1 -1
  137. package/dist/debug.js +2 -0
  138. package/dist/debug.js.map +1 -1
  139. package/dist/esm/adapters/hosting/agentCoreA2A.js +4 -0
  140. package/dist/esm/adapters/hosting/agentCoreA2A.js.map +1 -1
  141. package/dist/esm/adapters/hosting/firestoreSessions.js +9 -2
  142. package/dist/esm/adapters/hosting/firestoreSessions.js.map +1 -1
  143. package/dist/esm/adapters/hosting/googleAgentEngine.js +4 -6
  144. package/dist/esm/adapters/hosting/googleAgentEngine.js.map +1 -1
  145. package/dist/esm/adapters/llm/AnthropicProvider.d.ts +1 -0
  146. package/dist/esm/adapters/llm/AnthropicProvider.js +5 -1
  147. package/dist/esm/adapters/llm/AnthropicProvider.js.map +1 -1
  148. package/dist/esm/adapters/llm/BrowserAnthropicProvider.d.ts +1 -0
  149. package/dist/esm/adapters/llm/BrowserAnthropicProvider.js +5 -1
  150. package/dist/esm/adapters/llm/BrowserAnthropicProvider.js.map +1 -1
  151. package/dist/esm/adapters/llm/MockProvider.d.ts +2 -0
  152. package/dist/esm/adapters/llm/MockProvider.js +2 -0
  153. package/dist/esm/adapters/llm/MockProvider.js.map +1 -1
  154. package/dist/esm/ag-ui/request.d.ts +4 -1
  155. package/dist/esm/ag-ui/request.js +27 -2
  156. package/dist/esm/ag-ui/request.js.map +1 -1
  157. package/dist/esm/ag-ui/serializer.d.ts +15 -2
  158. package/dist/esm/ag-ui/serializer.js +20 -7
  159. package/dist/esm/ag-ui/serializer.js.map +1 -1
  160. package/dist/esm/answer-account/facts/howSure.js +3 -0
  161. package/dist/esm/answer-account/facts/howSure.js.map +1 -1
  162. package/dist/esm/answer-account/templates.d.ts +4 -1
  163. package/dist/esm/answer-account/templates.js +4 -1
  164. package/dist/esm/answer-account/templates.js.map +1 -1
  165. package/dist/esm/answer-validation/agentChecks.d.ts +75 -0
  166. package/dist/esm/answer-validation/agentChecks.js +125 -0
  167. package/dist/esm/answer-validation/agentChecks.js.map +1 -0
  168. package/dist/esm/answer-validation/index.d.ts +2 -1
  169. package/dist/esm/answer-validation/index.js +1 -0
  170. package/dist/esm/answer-validation/index.js.map +1 -1
  171. package/dist/esm/answer-validation/outputSchema.d.ts +18 -7
  172. package/dist/esm/answer-validation/outputSchema.js +8 -1
  173. package/dist/esm/answer-validation/outputSchema.js.map +1 -1
  174. package/dist/esm/answer-validation/types.d.ts +125 -1
  175. package/dist/esm/answer-validation/types.js +9 -2
  176. package/dist/esm/answer-validation/types.js.map +1 -1
  177. package/dist/esm/answer-validation/validate.d.ts +11 -2
  178. package/dist/esm/answer-validation/validate.js +82 -3
  179. package/dist/esm/answer-validation/validate.js.map +1 -1
  180. package/dist/esm/core/Agent.d.ts +25 -1
  181. package/dist/esm/core/Agent.js +192 -33
  182. package/dist/esm/core/Agent.js.map +1 -1
  183. package/dist/esm/core/RunnerBase.js +4 -0
  184. package/dist/esm/core/RunnerBase.js.map +1 -1
  185. package/dist/esm/core/agent/AgentBuilder.d.ts +43 -4
  186. package/dist/esm/core/agent/AgentBuilder.js +128 -18
  187. package/dist/esm/core/agent/AgentBuilder.js.map +1 -1
  188. package/dist/esm/core/agent/arguments/checks.d.ts +1 -1
  189. package/dist/esm/core/agent/arguments/checks.js +1 -1
  190. package/dist/esm/core/agent/arguments/subflow.d.ts +6 -0
  191. package/dist/esm/core/agent/arguments/subflow.js +1 -0
  192. package/dist/esm/core/agent/arguments/subflow.js.map +1 -1
  193. package/dist/esm/core/agent/assessment/assess.js +31 -0
  194. package/dist/esm/core/agent/assessment/assess.js.map +1 -1
  195. package/dist/esm/core/agent/assessment/compose.js +3 -0
  196. package/dist/esm/core/agent/assessment/compose.js.map +1 -1
  197. package/dist/esm/core/agent/assessment/reasons.js +19 -1
  198. package/dist/esm/core/agent/assessment/reasons.js.map +1 -1
  199. package/dist/esm/core/agent/assessment/types.d.ts +3 -2
  200. package/dist/esm/core/agent/buildAgentChart.d.ts +1 -0
  201. package/dist/esm/core/agent/buildAgentChart.js +4 -0
  202. package/dist/esm/core/agent/buildAgentChart.js.map +1 -1
  203. package/dist/esm/core/agent/buildDynamicAgentChart.js +17 -3
  204. package/dist/esm/core/agent/buildDynamicAgentChart.js.map +1 -1
  205. package/dist/esm/core/agent/buildToolRegistry.js +13 -0
  206. package/dist/esm/core/agent/buildToolRegistry.js.map +1 -1
  207. package/dist/esm/core/agent/composeRequest.d.ts +19 -0
  208. package/dist/esm/core/agent/composeRequest.js +17 -0
  209. package/dist/esm/core/agent/composeRequest.js.map +1 -1
  210. package/dist/esm/core/agent/evidence/answerCarriers.js +1 -1
  211. package/dist/esm/core/agent/evidence/answerCarriers.js.map +1 -1
  212. package/dist/esm/core/agent/evidence/evidenceIndex.js +1 -1
  213. package/dist/esm/core/agent/evidence/evidenceIndex.js.map +1 -1
  214. package/dist/esm/core/agent/evidence/extract.d.ts +45 -6
  215. package/dist/esm/core/agent/evidence/extract.js +136 -30
  216. package/dist/esm/core/agent/evidence/extract.js.map +1 -1
  217. package/dist/esm/core/agent/evidence/figures.js +1 -1
  218. package/dist/esm/core/agent/evidence/figures.js.map +1 -1
  219. package/dist/esm/core/agent/evidence/gate.d.ts +6 -0
  220. package/dist/esm/core/agent/evidence/gate.js +11 -3
  221. package/dist/esm/core/agent/evidence/gate.js.map +1 -1
  222. package/dist/esm/core/agent/evidence/numericRanges.js +1 -1
  223. package/dist/esm/core/agent/evidence/numericRanges.js.map +1 -1
  224. package/dist/esm/core/agent/evidence/recovery.d.ts +2 -0
  225. package/dist/esm/core/agent/evidence/recovery.js +3 -1
  226. package/dist/esm/core/agent/evidence/recovery.js.map +1 -1
  227. package/dist/esm/core/agent/evidence/resultCarries.d.ts +2 -2
  228. package/dist/esm/core/agent/evidence/resultCarries.js +3 -3
  229. package/dist/esm/core/agent/evidence/resultCarries.js.map +1 -1
  230. package/dist/esm/core/agent/evidence/types.d.ts +17 -0
  231. package/dist/esm/core/agent/findings/contingent.js +1 -1
  232. package/dist/esm/core/agent/findings/contingent.js.map +1 -1
  233. package/dist/esm/core/agent/findings/ledger.d.ts +3 -0
  234. package/dist/esm/core/agent/findings/ledger.js +49 -0
  235. package/dist/esm/core/agent/findings/ledger.js.map +1 -1
  236. package/dist/esm/core/agent/findings/negativeProse.d.ts +1 -0
  237. package/dist/esm/core/agent/findings/negativeProse.js +49 -0
  238. package/dist/esm/core/agent/findings/negativeProse.js.map +1 -0
  239. package/dist/esm/core/agent/findings/types.d.ts +11 -4
  240. package/dist/esm/core/agent/findings/types.js +3 -2
  241. package/dist/esm/core/agent/findings/types.js.map +1 -1
  242. package/dist/esm/core/agent/honesty/mounts.d.ts +7 -0
  243. package/dist/esm/core/agent/honesty/mounts.js +6 -0
  244. package/dist/esm/core/agent/honesty/mounts.js.map +1 -1
  245. package/dist/esm/core/agent/nativeOutputFormat.d.ts +2 -1
  246. package/dist/esm/core/agent/nativeOutputFormat.js +19 -1
  247. package/dist/esm/core/agent/nativeOutputFormat.js.map +1 -1
  248. package/dist/esm/core/agent/negativeClaims/capture.d.ts +65 -0
  249. package/dist/esm/core/agent/negativeClaims/capture.js +508 -0
  250. package/dist/esm/core/agent/negativeClaims/capture.js.map +1 -0
  251. package/dist/esm/core/agent/negativeClaims/checkpoint.d.ts +7 -0
  252. package/dist/esm/core/agent/negativeClaims/checkpoint.js +79 -0
  253. package/dist/esm/core/agent/negativeClaims/checkpoint.js.map +1 -0
  254. package/dist/esm/core/agent/negativeClaims/config.d.ts +66 -0
  255. package/dist/esm/core/agent/negativeClaims/config.js +185 -0
  256. package/dist/esm/core/agent/negativeClaims/config.js.map +1 -0
  257. package/dist/esm/core/agent/negativeClaims/delivery.d.ts +24 -0
  258. package/dist/esm/core/agent/negativeClaims/delivery.js +244 -0
  259. package/dist/esm/core/agent/negativeClaims/delivery.js.map +1 -0
  260. package/dist/esm/core/agent/negativeClaims/observe.d.ts +14 -0
  261. package/dist/esm/core/agent/negativeClaims/observe.js +34 -0
  262. package/dist/esm/core/agent/negativeClaims/observe.js.map +1 -0
  263. package/dist/esm/core/agent/negativeClaims/prose.d.ts +9 -0
  264. package/dist/esm/core/agent/negativeClaims/prose.js +112 -0
  265. package/dist/esm/core/agent/negativeClaims/prose.js.map +1 -0
  266. package/dist/esm/core/agent/negativeClaims/recheck.d.ts +7 -0
  267. package/dist/esm/core/agent/negativeClaims/recheck.js +32 -0
  268. package/dist/esm/core/agent/negativeClaims/recheck.js.map +1 -0
  269. package/dist/esm/core/agent/outputEnforcement.d.ts +5 -1
  270. package/dist/esm/core/agent/outputEnforcement.js.map +1 -1
  271. package/dist/esm/core/agent/receipt/receipt.d.ts +2 -2
  272. package/dist/esm/core/agent/stages/answerEvidence.d.ts +28 -0
  273. package/dist/esm/core/agent/stages/answerEvidence.js +16 -0
  274. package/dist/esm/core/agent/stages/answerEvidence.js.map +1 -0
  275. package/dist/esm/core/agent/stages/answerValidation.d.ts +15 -3
  276. package/dist/esm/core/agent/stages/answerValidation.js +113 -5
  277. package/dist/esm/core/agent/stages/answerValidation.js.map +1 -1
  278. package/dist/esm/core/agent/stages/callLLM.d.ts +10 -2
  279. package/dist/esm/core/agent/stages/callLLM.js +60 -18
  280. package/dist/esm/core/agent/stages/callLLM.js.map +1 -1
  281. package/dist/esm/core/agent/stages/evidenceRecheck.d.ts +6 -1
  282. package/dist/esm/core/agent/stages/evidenceRecheck.js +16 -2
  283. package/dist/esm/core/agent/stages/evidenceRecheck.js.map +1 -1
  284. package/dist/esm/core/agent/stages/outputRetry.js +23 -7
  285. package/dist/esm/core/agent/stages/outputRetry.js.map +1 -1
  286. package/dist/esm/core/agent/stages/prepareFinal.js +6 -1
  287. package/dist/esm/core/agent/stages/prepareFinal.js.map +1 -1
  288. package/dist/esm/core/agent/stages/reliabilityExecution.d.ts +3 -0
  289. package/dist/esm/core/agent/stages/reliabilityExecution.js +3 -0
  290. package/dist/esm/core/agent/stages/reliabilityExecution.js.map +1 -1
  291. package/dist/esm/core/agent/stages/route.d.ts +8 -2
  292. package/dist/esm/core/agent/stages/route.js +81 -33
  293. package/dist/esm/core/agent/stages/route.js.map +1 -1
  294. package/dist/esm/core/agent/stages/searchCoverage.d.ts +94 -0
  295. package/dist/esm/core/agent/stages/searchCoverage.js +117 -0
  296. package/dist/esm/core/agent/stages/searchCoverage.js.map +1 -0
  297. package/dist/esm/core/agent/stages/seed.d.ts +9 -0
  298. package/dist/esm/core/agent/stages/seed.js +13 -1
  299. package/dist/esm/core/agent/stages/seed.js.map +1 -1
  300. package/dist/esm/core/agent/stages/toolCalls.d.ts +16 -0
  301. package/dist/esm/core/agent/stages/toolCalls.js +700 -77
  302. package/dist/esm/core/agent/stages/toolCalls.js.map +1 -1
  303. package/dist/esm/core/agent/toolChoice/compose.d.ts +2 -0
  304. package/dist/esm/core/agent/toolChoice/compose.js +1 -0
  305. package/dist/esm/core/agent/toolChoice/compose.js.map +1 -1
  306. package/dist/esm/core/agent/toolChoice/pick.d.ts +2 -0
  307. package/dist/esm/core/agent/toolChoice/pick.js +2 -0
  308. package/dist/esm/core/agent/toolChoice/pick.js.map +1 -1
  309. package/dist/esm/core/agent/toolChoice/types.d.ts +1 -1
  310. package/dist/esm/core/agent/types.d.ts +79 -5
  311. package/dist/esm/core/checkin.d.ts +83 -7
  312. package/dist/esm/core/checkin.js +77 -15
  313. package/dist/esm/core/checkin.js.map +1 -1
  314. package/dist/esm/core/consentRequest.d.ts +488 -0
  315. package/dist/esm/core/consentRequest.js +817 -0
  316. package/dist/esm/core/consentRequest.js.map +1 -0
  317. package/dist/esm/core/pause.d.ts +88 -7
  318. package/dist/esm/core/pause.js +102 -5
  319. package/dist/esm/core/pause.js.map +1 -1
  320. package/dist/esm/core/runCheckpoint.d.ts +5 -1
  321. package/dist/esm/core/runCheckpoint.js +8 -1
  322. package/dist/esm/core/runCheckpoint.js.map +1 -1
  323. package/dist/esm/core/slots/buildToolsSlot.d.ts +2 -1
  324. package/dist/esm/core/slots/buildToolsSlot.js +1 -0
  325. package/dist/esm/core/slots/buildToolsSlot.js.map +1 -1
  326. package/dist/esm/debug.d.ts +1 -1
  327. package/dist/esm/debug.js +2 -0
  328. package/dist/esm/debug.js.map +1 -1
  329. package/dist/esm/events/payloads.d.ts +145 -3
  330. package/dist/esm/events/registry.d.ts +3 -1
  331. package/dist/esm/events/registry.js +2 -0
  332. package/dist/esm/events/registry.js.map +1 -1
  333. package/dist/esm/hosting/answeredPause.d.ts +301 -0
  334. package/dist/esm/hosting/answeredPause.js +522 -0
  335. package/dist/esm/hosting/answeredPause.js.map +1 -0
  336. package/dist/esm/hosting/conformance/cases.js +81 -1
  337. package/dist/esm/hosting/conformance/cases.js.map +1 -1
  338. package/dist/esm/hosting/conformance/types.d.ts +1 -1
  339. package/dist/esm/hosting/envelope.d.ts +6 -0
  340. package/dist/esm/hosting/envelope.js +14 -0
  341. package/dist/esm/hosting/envelope.js.map +1 -1
  342. package/dist/esm/hosting/errors.d.ts +14 -2
  343. package/dist/esm/hosting/errors.js +13 -6
  344. package/dist/esm/hosting/errors.js.map +1 -1
  345. package/dist/esm/hosting/index.d.ts +2 -1
  346. package/dist/esm/hosting/index.js +3 -0
  347. package/dist/esm/hosting/index.js.map +1 -1
  348. package/dist/esm/hosting/memorySessions.js +10 -2
  349. package/dist/esm/hosting/memorySessions.js.map +1 -1
  350. package/dist/esm/hosting/processLocalStore.d.ts +20 -0
  351. package/dist/esm/hosting/processLocalStore.js +26 -0
  352. package/dist/esm/hosting/processLocalStore.js.map +1 -0
  353. package/dist/esm/hosting/protocolAdapter.d.ts +13 -0
  354. package/dist/esm/hosting/refusalStatus.d.ts +6 -0
  355. package/dist/esm/hosting/refusalStatus.js +13 -0
  356. package/dist/esm/hosting/refusalStatus.js.map +1 -1
  357. package/dist/esm/hosting/sessionWire.d.ts +8 -3
  358. package/dist/esm/hosting/sessionWire.js.map +1 -1
  359. package/dist/esm/hosting/sqliteSessions.js +27 -3
  360. package/dist/esm/hosting/sqliteSessions.js.map +1 -1
  361. package/dist/esm/hosting/standingAgent.js +70 -26
  362. package/dist/esm/hosting/standingAgent.js.map +1 -1
  363. package/dist/esm/hosting/streamHandler.d.ts +3 -1
  364. package/dist/esm/hosting/streamHandler.js +150 -32
  365. package/dist/esm/hosting/streamHandler.js.map +1 -1
  366. package/dist/esm/hosting/types.d.ts +28 -6
  367. package/dist/esm/hosting/types.js.map +1 -1
  368. package/dist/esm/index.d.ts +7 -3
  369. package/dist/esm/index.js +21 -17
  370. package/dist/esm/index.js.map +1 -1
  371. package/dist/esm/integrity/negative-claim/anchor.d.ts +9 -0
  372. package/dist/esm/integrity/negative-claim/anchor.js +120 -0
  373. package/dist/esm/integrity/negative-claim/anchor.js.map +1 -0
  374. package/dist/esm/integrity/negative-claim/citation.d.ts +34 -0
  375. package/dist/esm/integrity/negative-claim/citation.js +367 -0
  376. package/dist/esm/integrity/negative-claim/citation.js.map +1 -0
  377. package/dist/esm/integrity/negative-claim/containment.d.ts +40 -0
  378. package/dist/esm/integrity/negative-claim/containment.js +257 -0
  379. package/dist/esm/integrity/negative-claim/containment.js.map +1 -0
  380. package/dist/esm/integrity/negative-claim/derive.d.ts +17 -0
  381. package/dist/esm/integrity/negative-claim/derive.js +122 -0
  382. package/dist/esm/integrity/negative-claim/derive.js.map +1 -0
  383. package/dist/esm/integrity/negative-claim/detect.d.ts +44 -0
  384. package/dist/esm/integrity/negative-claim/detect.js +65 -0
  385. package/dist/esm/integrity/negative-claim/detect.js.map +1 -0
  386. package/dist/esm/integrity/negative-claim/judge.d.ts +41 -0
  387. package/dist/esm/integrity/negative-claim/judge.js +95 -0
  388. package/dist/esm/integrity/negative-claim/judge.js.map +1 -0
  389. package/dist/esm/integrity/negative-claim/language.d.ts +14 -0
  390. package/dist/esm/integrity/negative-claim/language.js +42 -0
  391. package/dist/esm/integrity/negative-claim/language.js.map +1 -0
  392. package/dist/esm/integrity/negative-claim/limits.d.ts +2 -0
  393. package/dist/esm/integrity/negative-claim/limits.js +3 -0
  394. package/dist/esm/integrity/negative-claim/limits.js.map +1 -0
  395. package/dist/esm/integrity/negative-claim/matcher.d.ts +51 -0
  396. package/dist/esm/integrity/negative-claim/matcher.js +164 -0
  397. package/dist/esm/integrity/negative-claim/matcher.js.map +1 -0
  398. package/dist/esm/integrity/negative-claim/noRead.d.ts +8 -0
  399. package/dist/esm/integrity/negative-claim/noRead.js +9 -0
  400. package/dist/esm/integrity/negative-claim/noRead.js.map +1 -0
  401. package/dist/esm/integrity/negative-claim/phrases.d.ts +69 -0
  402. package/dist/esm/integrity/negative-claim/phrases.js +249 -0
  403. package/dist/esm/integrity/negative-claim/phrases.js.map +1 -0
  404. package/dist/esm/integrity/negative-claim/prose.d.ts +36 -0
  405. package/dist/esm/integrity/negative-claim/prose.js +143 -0
  406. package/dist/esm/integrity/negative-claim/prose.js.map +1 -0
  407. package/dist/esm/integrity/negative-claim/readings.d.ts +81 -0
  408. package/dist/esm/integrity/negative-claim/readings.js +322 -0
  409. package/dist/esm/integrity/negative-claim/readings.js.map +1 -0
  410. package/dist/esm/integrity/negative-claim/resolve.d.ts +37 -0
  411. package/dist/esm/integrity/negative-claim/resolve.js +179 -0
  412. package/dist/esm/integrity/negative-claim/resolve.js.map +1 -0
  413. package/dist/esm/integrity/negative-claim/statement.d.ts +75 -0
  414. package/dist/esm/integrity/negative-claim/statement.js +361 -0
  415. package/dist/esm/integrity/negative-claim/statement.js.map +1 -0
  416. package/dist/esm/integrity/negative-claim/types.d.ts +144 -0
  417. package/dist/esm/integrity/negative-claim/types.js +39 -0
  418. package/dist/esm/integrity/negative-claim/types.js.map +1 -0
  419. package/dist/esm/integrity/negative-claim/units.d.ts +33 -0
  420. package/dist/esm/integrity/negative-claim/units.js +185 -0
  421. package/dist/esm/integrity/negative-claim/units.js.map +1 -0
  422. package/dist/esm/integrity/negative-claim/work.d.ts +12 -0
  423. package/dist/esm/integrity/negative-claim/work.js +19 -0
  424. package/dist/esm/integrity/negative-claim/work.js.map +1 -0
  425. package/dist/esm/integrity/unsupported-claim/check.d.ts +33 -0
  426. package/dist/esm/integrity/unsupported-claim/check.js +48 -26
  427. package/dist/esm/integrity/unsupported-claim/check.js.map +1 -1
  428. package/dist/esm/integrity/unsupported-claim/delivered.d.ts +72 -0
  429. package/dist/esm/integrity/unsupported-claim/delivered.js +98 -0
  430. package/dist/esm/integrity/unsupported-claim/delivered.js.map +1 -0
  431. package/dist/esm/integrity/unsupported-claim/evaluate.d.ts +103 -1
  432. package/dist/esm/integrity/unsupported-claim/evaluate.js +373 -0
  433. package/dist/esm/integrity/unsupported-claim/evaluate.js.map +1 -1
  434. package/dist/esm/lib/conventions.d.ts +1 -0
  435. package/dist/esm/lib/conventions.js +3 -0
  436. package/dist/esm/lib/conventions.js.map +1 -1
  437. package/dist/esm/lib/frozenCopy.d.ts +75 -0
  438. package/dist/esm/lib/frozenCopy.js +198 -0
  439. package/dist/esm/lib/frozenCopy.js.map +1 -0
  440. package/dist/esm/lib/jsonFaithful.d.ts +34 -0
  441. package/dist/esm/lib/jsonFaithful.js +111 -0
  442. package/dist/esm/lib/jsonFaithful.js.map +1 -0
  443. package/dist/esm/lib/normalize.d.ts +96 -0
  444. package/dist/esm/{tools → lib}/normalize.js +142 -6
  445. package/dist/esm/lib/normalize.js.map +1 -0
  446. package/dist/esm/mcp/toolExtras.d.ts +10 -0
  447. package/dist/esm/mcp/toolExtras.js +11 -0
  448. package/dist/esm/mcp/toolExtras.js.map +1 -1
  449. package/dist/esm/provider-contract/nativeOutputSchema.d.ts +6 -2
  450. package/dist/esm/provider-contract/nativeOutputSchema.js +9 -2
  451. package/dist/esm/provider-contract/nativeOutputSchema.js.map +1 -1
  452. package/dist/esm/provider-contract/types.d.ts +12 -1
  453. package/dist/esm/provider-contract/types.js.map +1 -1
  454. package/dist/esm/recorders/core/CheckInRecorder.d.ts +6 -1
  455. package/dist/esm/recorders/core/CheckInRecorder.js +5 -1
  456. package/dist/esm/recorders/core/CheckInRecorder.js.map +1 -1
  457. package/dist/esm/redaction/conversation.js +6 -0
  458. package/dist/esm/redaction/conversation.js.map +1 -1
  459. package/dist/esm/redaction/knownStrings.d.ts +9 -7
  460. package/dist/esm/redaction/knownStrings.js +74 -0
  461. package/dist/esm/redaction/knownStrings.js.map +1 -1
  462. package/dist/esm/resilience/withCircuitBreaker.js +3 -0
  463. package/dist/esm/resilience/withCircuitBreaker.js.map +1 -1
  464. package/dist/esm/resilience/withFallback.js +8 -1
  465. package/dist/esm/resilience/withFallback.js.map +1 -1
  466. package/dist/esm/resilience/withRetry.js +3 -0
  467. package/dist/esm/resilience/withRetry.js.map +1 -1
  468. package/dist/esm/semantics/check.d.ts +44 -2
  469. package/dist/esm/semantics/check.js +112 -3
  470. package/dist/esm/semantics/check.js.map +1 -1
  471. package/dist/esm/semantics/cli.js +33 -3
  472. package/dist/esm/semantics/cli.js.map +1 -1
  473. package/dist/esm/semantics/coverage/absent.d.ts +19 -2
  474. package/dist/esm/semantics/coverage/absent.js +56 -52
  475. package/dist/esm/semantics/coverage/absent.js.map +1 -1
  476. package/dist/esm/semantics/coverage/among.d.ts +73 -0
  477. package/dist/esm/semantics/coverage/among.js +172 -0
  478. package/dist/esm/semantics/coverage/among.js.map +1 -0
  479. package/dist/esm/semantics/coverage/composedCoverage.d.ts +220 -0
  480. package/dist/esm/semantics/coverage/composedCoverage.js +42 -0
  481. package/dist/esm/semantics/coverage/composedCoverage.js.map +1 -0
  482. package/dist/esm/semantics/coverage/evidence.js +27 -2
  483. package/dist/esm/semantics/coverage/evidence.js.map +1 -1
  484. package/dist/esm/semantics/coverage/index.d.ts +4 -1
  485. package/dist/esm/semantics/coverage/index.js +2 -0
  486. package/dist/esm/semantics/coverage/index.js.map +1 -1
  487. package/dist/esm/semantics/coverage/ledger.d.ts +2 -1
  488. package/dist/esm/semantics/coverage/ledger.js +15 -53
  489. package/dist/esm/semantics/coverage/ledger.js.map +1 -1
  490. package/dist/esm/semantics/coverage/read.d.ts +19 -0
  491. package/dist/esm/semantics/coverage/read.js.map +1 -1
  492. package/dist/esm/semantics/coverage/recognize.d.ts +17 -1
  493. package/dist/esm/semantics/coverage/recognize.js +40 -0
  494. package/dist/esm/semantics/coverage/recognize.js.map +1 -1
  495. package/dist/esm/semantics/coverage/search/binding.d.ts +27 -0
  496. package/dist/esm/semantics/coverage/search/binding.js +42 -0
  497. package/dist/esm/semantics/coverage/search/binding.js.map +1 -0
  498. package/dist/esm/semantics/coverage/search/compose.d.ts +90 -0
  499. package/dist/esm/semantics/coverage/search/compose.js +120 -0
  500. package/dist/esm/semantics/coverage/search/compose.js.map +1 -0
  501. package/dist/esm/semantics/coverage/search/declaration.d.ts +75 -0
  502. package/dist/esm/semantics/coverage/search/declaration.js +453 -0
  503. package/dist/esm/semantics/coverage/search/declaration.js.map +1 -0
  504. package/dist/esm/semantics/coverage/search/door.d.ts +46 -0
  505. package/dist/esm/semantics/coverage/search/door.js +130 -0
  506. package/dist/esm/semantics/coverage/search/door.js.map +1 -0
  507. package/dist/esm/semantics/coverage/search/events.d.ts +42 -0
  508. package/dist/esm/semantics/coverage/search/events.js +100 -0
  509. package/dist/esm/semantics/coverage/search/events.js.map +1 -0
  510. package/dist/esm/semantics/coverage/search/facets.d.ts +52 -0
  511. package/dist/esm/semantics/coverage/search/facets.js +191 -0
  512. package/dist/esm/semantics/coverage/search/facets.js.map +1 -0
  513. package/dist/esm/semantics/coverage/search/gaps.d.ts +63 -0
  514. package/dist/esm/semantics/coverage/search/gaps.js +221 -0
  515. package/dist/esm/semantics/coverage/search/gaps.js.map +1 -0
  516. package/dist/esm/semantics/coverage/search/inEffect.d.ts +65 -0
  517. package/dist/esm/semantics/coverage/search/inEffect.js +48 -0
  518. package/dist/esm/semantics/coverage/search/inEffect.js.map +1 -0
  519. package/dist/esm/semantics/coverage/search/resultFacts.d.ts +42 -0
  520. package/dist/esm/semantics/coverage/search/resultFacts.js +100 -0
  521. package/dist/esm/semantics/coverage/search/resultFacts.js.map +1 -0
  522. package/dist/esm/semantics/coverage/search/review.d.ts +36 -0
  523. package/dist/esm/semantics/coverage/search/review.js +89 -0
  524. package/dist/esm/semantics/coverage/search/review.js.map +1 -0
  525. package/dist/esm/semantics/coverage/search/served.d.ts +51 -0
  526. package/dist/esm/semantics/coverage/search/served.js +130 -0
  527. package/dist/esm/semantics/coverage/search/served.js.map +1 -0
  528. package/dist/esm/semantics/coverage/search/span.d.ts +34 -0
  529. package/dist/esm/semantics/coverage/search/span.js +61 -0
  530. package/dist/esm/semantics/coverage/search/span.js.map +1 -0
  531. package/dist/esm/semantics/coverage/search/statementText.d.ts +46 -0
  532. package/dist/esm/semantics/coverage/search/statementText.js +102 -0
  533. package/dist/esm/semantics/coverage/search/statementText.js.map +1 -0
  534. package/dist/esm/semantics/coverage/search/types.d.ts +120 -0
  535. package/dist/esm/semantics/coverage/search/types.js +11 -0
  536. package/dist/esm/semantics/coverage/search/types.js.map +1 -0
  537. package/dist/esm/semantics/coverage/search/valueWords.d.ts +22 -0
  538. package/dist/esm/semantics/coverage/search/valueWords.js +32 -0
  539. package/dist/esm/semantics/coverage/search/valueWords.js.map +1 -0
  540. package/dist/esm/semantics/coverage/types.d.ts +163 -0
  541. package/dist/esm/semantics/described.js +3 -1
  542. package/dist/esm/semantics/described.js.map +1 -1
  543. package/dist/esm/semantics/envelope.js +26 -2
  544. package/dist/esm/semantics/envelope.js.map +1 -1
  545. package/dist/esm/semantics/index.d.ts +2 -1
  546. package/dist/esm/semantics/index.js.map +1 -1
  547. package/dist/esm/semantics/overclaim.d.ts +105 -0
  548. package/dist/esm/semantics/overclaim.js +397 -0
  549. package/dist/esm/semantics/overclaim.js.map +1 -0
  550. package/dist/esm/semantics/types.d.ts +13 -0
  551. package/dist/esm/semantics/types.js.map +1 -1
  552. package/dist/esm/time/forms.js +1 -1
  553. package/dist/esm/time/textForms.js +1 -1
  554. package/dist/esm/time-travel/servedView.d.ts +1 -1
  555. package/dist/esm/time-travel/servedView.js +8 -6
  556. package/dist/esm/time-travel/servedView.js.map +1 -1
  557. package/dist/esm/tools/declare.d.ts +1 -1
  558. package/dist/esm/tools/declare.js +2 -2
  559. package/dist/esm/tools/declare.js.map +1 -1
  560. package/dist/esm/tools/hostFilled.d.ts +20 -1
  561. package/dist/esm/tools/hostFilled.js +46 -1
  562. package/dist/esm/tools/hostFilled.js.map +1 -1
  563. package/dist/esm/tools/searchOf.d.ts +60 -0
  564. package/dist/esm/tools/searchOf.js +97 -0
  565. package/dist/esm/tools/searchOf.js.map +1 -0
  566. package/dist/esm/tools/tools.d.ts +49 -0
  567. package/dist/esm/tools/tools.js +76 -1
  568. package/dist/esm/tools/tools.js.map +1 -1
  569. package/dist/events/registry.js +2 -0
  570. package/dist/events/registry.js.map +1 -1
  571. package/dist/hosting/answeredPause.js +536 -0
  572. package/dist/hosting/answeredPause.js.map +1 -0
  573. package/dist/hosting/conformance/cases.js +80 -0
  574. package/dist/hosting/conformance/cases.js.map +1 -1
  575. package/dist/hosting/envelope.js +14 -0
  576. package/dist/hosting/envelope.js.map +1 -1
  577. package/dist/hosting/errors.js +13 -6
  578. package/dist/hosting/errors.js.map +1 -1
  579. package/dist/hosting/index.js +7 -3
  580. package/dist/hosting/index.js.map +1 -1
  581. package/dist/hosting/memorySessions.js +10 -2
  582. package/dist/hosting/memorySessions.js.map +1 -1
  583. package/dist/hosting/processLocalStore.js +31 -0
  584. package/dist/hosting/processLocalStore.js.map +1 -0
  585. package/dist/hosting/refusalStatus.js +13 -0
  586. package/dist/hosting/refusalStatus.js.map +1 -1
  587. package/dist/hosting/sessionWire.js.map +1 -1
  588. package/dist/hosting/sqliteSessions.js +27 -3
  589. package/dist/hosting/sqliteSessions.js.map +1 -1
  590. package/dist/hosting/standingAgent.js +69 -25
  591. package/dist/hosting/standingAgent.js.map +1 -1
  592. package/dist/hosting/streamHandler.js +149 -31
  593. package/dist/hosting/streamHandler.js.map +1 -1
  594. package/dist/hosting/types.js.map +1 -1
  595. package/dist/index.js +26 -21
  596. package/dist/index.js.map +1 -1
  597. package/dist/integrity/negative-claim/anchor.js +124 -0
  598. package/dist/integrity/negative-claim/anchor.js.map +1 -0
  599. package/dist/integrity/negative-claim/citation.js +371 -0
  600. package/dist/integrity/negative-claim/citation.js.map +1 -0
  601. package/dist/integrity/negative-claim/containment.js +262 -0
  602. package/dist/integrity/negative-claim/containment.js.map +1 -0
  603. package/dist/integrity/negative-claim/derive.js +130 -0
  604. package/dist/integrity/negative-claim/derive.js.map +1 -0
  605. package/dist/integrity/negative-claim/detect.js +69 -0
  606. package/dist/integrity/negative-claim/detect.js.map +1 -0
  607. package/dist/integrity/negative-claim/judge.js +100 -0
  608. package/dist/integrity/negative-claim/judge.js.map +1 -0
  609. package/dist/integrity/negative-claim/language.js +46 -0
  610. package/dist/integrity/negative-claim/language.js.map +1 -0
  611. package/dist/integrity/negative-claim/limits.js +6 -0
  612. package/dist/integrity/negative-claim/limits.js.map +1 -0
  613. package/dist/integrity/negative-claim/matcher.js +179 -0
  614. package/dist/integrity/negative-claim/matcher.js.map +1 -0
  615. package/dist/integrity/negative-claim/noRead.js +13 -0
  616. package/dist/integrity/negative-claim/noRead.js.map +1 -0
  617. package/dist/integrity/negative-claim/phrases.js +253 -0
  618. package/dist/integrity/negative-claim/phrases.js.map +1 -0
  619. package/dist/integrity/negative-claim/prose.js +147 -0
  620. package/dist/integrity/negative-claim/prose.js.map +1 -0
  621. package/dist/integrity/negative-claim/readings.js +338 -0
  622. package/dist/integrity/negative-claim/readings.js.map +1 -0
  623. package/dist/integrity/negative-claim/resolve.js +184 -0
  624. package/dist/integrity/negative-claim/resolve.js.map +1 -0
  625. package/dist/integrity/negative-claim/statement.js +369 -0
  626. package/dist/integrity/negative-claim/statement.js.map +1 -0
  627. package/dist/integrity/negative-claim/types.js +42 -0
  628. package/dist/integrity/negative-claim/types.js.map +1 -0
  629. package/dist/integrity/negative-claim/units.js +190 -0
  630. package/dist/integrity/negative-claim/units.js.map +1 -0
  631. package/dist/integrity/negative-claim/work.js +24 -0
  632. package/dist/integrity/negative-claim/work.js.map +1 -0
  633. package/dist/integrity/unsupported-claim/check.js +50 -27
  634. package/dist/integrity/unsupported-claim/check.js.map +1 -1
  635. package/dist/integrity/unsupported-claim/delivered.js +102 -0
  636. package/dist/integrity/unsupported-claim/delivered.js.map +1 -0
  637. package/dist/integrity/unsupported-claim/evaluate.js +377 -1
  638. package/dist/integrity/unsupported-claim/evaluate.js.map +1 -1
  639. package/dist/lib/conventions.js +3 -0
  640. package/dist/lib/conventions.js.map +1 -1
  641. package/dist/lib/frozenCopy.js +207 -0
  642. package/dist/lib/frozenCopy.js.map +1 -0
  643. package/dist/lib/jsonFaithful.js +115 -0
  644. package/dist/lib/jsonFaithful.js.map +1 -0
  645. package/dist/{tools → lib}/normalize.js +151 -7
  646. package/dist/lib/normalize.js.map +1 -0
  647. package/dist/mcp/toolExtras.js +11 -0
  648. package/dist/mcp/toolExtras.js.map +1 -1
  649. package/dist/provider-contract/nativeOutputSchema.js +11 -3
  650. package/dist/provider-contract/nativeOutputSchema.js.map +1 -1
  651. package/dist/provider-contract/types.js.map +1 -1
  652. package/dist/recorders/core/CheckInRecorder.js +5 -1
  653. package/dist/recorders/core/CheckInRecorder.js.map +1 -1
  654. package/dist/redaction/conversation.js +6 -0
  655. package/dist/redaction/conversation.js.map +1 -1
  656. package/dist/redaction/knownStrings.js +74 -0
  657. package/dist/redaction/knownStrings.js.map +1 -1
  658. package/dist/resilience/withCircuitBreaker.js +3 -0
  659. package/dist/resilience/withCircuitBreaker.js.map +1 -1
  660. package/dist/resilience/withFallback.js +7 -0
  661. package/dist/resilience/withFallback.js.map +1 -1
  662. package/dist/resilience/withRetry.js +3 -0
  663. package/dist/resilience/withRetry.js.map +1 -1
  664. package/dist/semantics/check.js +112 -3
  665. package/dist/semantics/check.js.map +1 -1
  666. package/dist/semantics/cli.js +32 -2
  667. package/dist/semantics/cli.js.map +1 -1
  668. package/dist/semantics/coverage/absent.js +56 -52
  669. package/dist/semantics/coverage/absent.js.map +1 -1
  670. package/dist/semantics/coverage/among.js +177 -0
  671. package/dist/semantics/coverage/among.js.map +1 -0
  672. package/dist/semantics/coverage/composedCoverage.js +46 -0
  673. package/dist/semantics/coverage/composedCoverage.js.map +1 -0
  674. package/dist/semantics/coverage/evidence.js +27 -2
  675. package/dist/semantics/coverage/evidence.js.map +1 -1
  676. package/dist/semantics/coverage/index.js +5 -1
  677. package/dist/semantics/coverage/index.js.map +1 -1
  678. package/dist/semantics/coverage/ledger.js +18 -56
  679. package/dist/semantics/coverage/ledger.js.map +1 -1
  680. package/dist/semantics/coverage/read.js.map +1 -1
  681. package/dist/semantics/coverage/recognize.js +43 -1
  682. package/dist/semantics/coverage/recognize.js.map +1 -1
  683. package/dist/semantics/coverage/search/binding.js +46 -0
  684. package/dist/semantics/coverage/search/binding.js.map +1 -0
  685. package/dist/semantics/coverage/search/compose.js +124 -0
  686. package/dist/semantics/coverage/search/compose.js.map +1 -0
  687. package/dist/semantics/coverage/search/declaration.js +462 -0
  688. package/dist/semantics/coverage/search/declaration.js.map +1 -0
  689. package/dist/semantics/coverage/search/door.js +134 -0
  690. package/dist/semantics/coverage/search/door.js.map +1 -0
  691. package/dist/semantics/coverage/search/events.js +104 -0
  692. package/dist/semantics/coverage/search/events.js.map +1 -0
  693. package/dist/semantics/coverage/search/facets.js +196 -0
  694. package/dist/semantics/coverage/search/facets.js.map +1 -0
  695. package/dist/semantics/coverage/search/gaps.js +226 -0
  696. package/dist/semantics/coverage/search/gaps.js.map +1 -0
  697. package/dist/semantics/coverage/search/inEffect.js +52 -0
  698. package/dist/semantics/coverage/search/inEffect.js.map +1 -0
  699. package/dist/semantics/coverage/search/resultFacts.js +109 -0
  700. package/dist/semantics/coverage/search/resultFacts.js.map +1 -0
  701. package/dist/semantics/coverage/search/review.js +93 -0
  702. package/dist/semantics/coverage/search/review.js.map +1 -0
  703. package/dist/semantics/coverage/search/served.js +137 -0
  704. package/dist/semantics/coverage/search/served.js.map +1 -0
  705. package/dist/semantics/coverage/search/span.js +66 -0
  706. package/dist/semantics/coverage/search/span.js.map +1 -0
  707. package/dist/semantics/coverage/search/statementText.js +107 -0
  708. package/dist/semantics/coverage/search/statementText.js.map +1 -0
  709. package/dist/semantics/coverage/search/types.js +12 -0
  710. package/dist/semantics/coverage/search/types.js.map +1 -0
  711. package/dist/semantics/coverage/search/valueWords.js +36 -0
  712. package/dist/semantics/coverage/search/valueWords.js.map +1 -0
  713. package/dist/semantics/described.js +3 -1
  714. package/dist/semantics/described.js.map +1 -1
  715. package/dist/semantics/envelope.js +26 -2
  716. package/dist/semantics/envelope.js.map +1 -1
  717. package/dist/semantics/index.js.map +1 -1
  718. package/dist/semantics/overclaim.js +407 -0
  719. package/dist/semantics/overclaim.js.map +1 -0
  720. package/dist/semantics/types.js.map +1 -1
  721. package/dist/time/forms.js +1 -1
  722. package/dist/time/textForms.js +1 -1
  723. package/dist/time-travel/servedView.js +7 -5
  724. package/dist/time-travel/servedView.js.map +1 -1
  725. package/dist/tools/declare.js +2 -2
  726. package/dist/tools/declare.js.map +1 -1
  727. package/dist/tools/hostFilled.js +48 -2
  728. package/dist/tools/hostFilled.js.map +1 -1
  729. package/dist/tools/searchOf.js +104 -0
  730. package/dist/tools/searchOf.js.map +1 -0
  731. package/dist/tools/tools.js +80 -2
  732. package/dist/tools/tools.js.map +1 -1
  733. package/dist/types/adapters/hosting/agentCoreA2A.d.ts.map +1 -1
  734. package/dist/types/adapters/hosting/firestoreSessions.d.ts.map +1 -1
  735. package/dist/types/adapters/hosting/googleAgentEngine.d.ts.map +1 -1
  736. package/dist/types/adapters/llm/AnthropicProvider.d.ts +1 -0
  737. package/dist/types/adapters/llm/AnthropicProvider.d.ts.map +1 -1
  738. package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts +1 -0
  739. package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts.map +1 -1
  740. package/dist/types/adapters/llm/MockProvider.d.ts +2 -0
  741. package/dist/types/adapters/llm/MockProvider.d.ts.map +1 -1
  742. package/dist/types/ag-ui/request.d.ts +4 -1
  743. package/dist/types/ag-ui/request.d.ts.map +1 -1
  744. package/dist/types/ag-ui/serializer.d.ts +15 -2
  745. package/dist/types/ag-ui/serializer.d.ts.map +1 -1
  746. package/dist/types/answer-account/facts/howSure.d.ts.map +1 -1
  747. package/dist/types/answer-account/templates.d.ts +4 -1
  748. package/dist/types/answer-account/templates.d.ts.map +1 -1
  749. package/dist/types/answer-validation/agentChecks.d.ts +76 -0
  750. package/dist/types/answer-validation/agentChecks.d.ts.map +1 -0
  751. package/dist/types/answer-validation/index.d.ts +2 -1
  752. package/dist/types/answer-validation/index.d.ts.map +1 -1
  753. package/dist/types/answer-validation/outputSchema.d.ts +18 -7
  754. package/dist/types/answer-validation/outputSchema.d.ts.map +1 -1
  755. package/dist/types/answer-validation/types.d.ts +125 -1
  756. package/dist/types/answer-validation/types.d.ts.map +1 -1
  757. package/dist/types/answer-validation/validate.d.ts +11 -2
  758. package/dist/types/answer-validation/validate.d.ts.map +1 -1
  759. package/dist/types/core/Agent.d.ts +25 -1
  760. package/dist/types/core/Agent.d.ts.map +1 -1
  761. package/dist/types/core/RunnerBase.d.ts.map +1 -1
  762. package/dist/types/core/agent/AgentBuilder.d.ts +43 -4
  763. package/dist/types/core/agent/AgentBuilder.d.ts.map +1 -1
  764. package/dist/types/core/agent/arguments/checks.d.ts +1 -1
  765. package/dist/types/core/agent/arguments/subflow.d.ts +6 -0
  766. package/dist/types/core/agent/arguments/subflow.d.ts.map +1 -1
  767. package/dist/types/core/agent/assessment/assess.d.ts.map +1 -1
  768. package/dist/types/core/agent/assessment/compose.d.ts.map +1 -1
  769. package/dist/types/core/agent/assessment/reasons.d.ts.map +1 -1
  770. package/dist/types/core/agent/assessment/types.d.ts +3 -2
  771. package/dist/types/core/agent/assessment/types.d.ts.map +1 -1
  772. package/dist/types/core/agent/buildAgentChart.d.ts +1 -0
  773. package/dist/types/core/agent/buildAgentChart.d.ts.map +1 -1
  774. package/dist/types/core/agent/buildDynamicAgentChart.d.ts.map +1 -1
  775. package/dist/types/core/agent/buildToolRegistry.d.ts.map +1 -1
  776. package/dist/types/core/agent/composeRequest.d.ts +19 -0
  777. package/dist/types/core/agent/composeRequest.d.ts.map +1 -1
  778. package/dist/types/core/agent/evidence/extract.d.ts +45 -6
  779. package/dist/types/core/agent/evidence/extract.d.ts.map +1 -1
  780. package/dist/types/core/agent/evidence/gate.d.ts +6 -0
  781. package/dist/types/core/agent/evidence/gate.d.ts.map +1 -1
  782. package/dist/types/core/agent/evidence/recovery.d.ts +2 -0
  783. package/dist/types/core/agent/evidence/recovery.d.ts.map +1 -1
  784. package/dist/types/core/agent/evidence/resultCarries.d.ts +2 -2
  785. package/dist/types/core/agent/evidence/types.d.ts +17 -0
  786. package/dist/types/core/agent/evidence/types.d.ts.map +1 -1
  787. package/dist/types/core/agent/findings/ledger.d.ts +3 -0
  788. package/dist/types/core/agent/findings/ledger.d.ts.map +1 -1
  789. package/dist/types/core/agent/findings/negativeProse.d.ts +2 -0
  790. package/dist/types/core/agent/findings/negativeProse.d.ts.map +1 -0
  791. package/dist/types/core/agent/findings/types.d.ts +11 -4
  792. package/dist/types/core/agent/findings/types.d.ts.map +1 -1
  793. package/dist/types/core/agent/honesty/mounts.d.ts +7 -0
  794. package/dist/types/core/agent/honesty/mounts.d.ts.map +1 -1
  795. package/dist/types/core/agent/nativeOutputFormat.d.ts +2 -1
  796. package/dist/types/core/agent/nativeOutputFormat.d.ts.map +1 -1
  797. package/dist/types/core/agent/negativeClaims/capture.d.ts +66 -0
  798. package/dist/types/core/agent/negativeClaims/capture.d.ts.map +1 -0
  799. package/dist/types/core/agent/negativeClaims/checkpoint.d.ts +8 -0
  800. package/dist/types/core/agent/negativeClaims/checkpoint.d.ts.map +1 -0
  801. package/dist/types/core/agent/negativeClaims/config.d.ts +67 -0
  802. package/dist/types/core/agent/negativeClaims/config.d.ts.map +1 -0
  803. package/dist/types/core/agent/negativeClaims/delivery.d.ts +25 -0
  804. package/dist/types/core/agent/negativeClaims/delivery.d.ts.map +1 -0
  805. package/dist/types/core/agent/negativeClaims/observe.d.ts +15 -0
  806. package/dist/types/core/agent/negativeClaims/observe.d.ts.map +1 -0
  807. package/dist/types/core/agent/negativeClaims/prose.d.ts +10 -0
  808. package/dist/types/core/agent/negativeClaims/prose.d.ts.map +1 -0
  809. package/dist/types/core/agent/negativeClaims/recheck.d.ts +8 -0
  810. package/dist/types/core/agent/negativeClaims/recheck.d.ts.map +1 -0
  811. package/dist/types/core/agent/outputEnforcement.d.ts +5 -1
  812. package/dist/types/core/agent/outputEnforcement.d.ts.map +1 -1
  813. package/dist/types/core/agent/receipt/receipt.d.ts +2 -2
  814. package/dist/types/core/agent/receipt/receipt.d.ts.map +1 -1
  815. package/dist/types/core/agent/stages/answerEvidence.d.ts +29 -0
  816. package/dist/types/core/agent/stages/answerEvidence.d.ts.map +1 -0
  817. package/dist/types/core/agent/stages/answerValidation.d.ts +15 -3
  818. package/dist/types/core/agent/stages/answerValidation.d.ts.map +1 -1
  819. package/dist/types/core/agent/stages/callLLM.d.ts +10 -2
  820. package/dist/types/core/agent/stages/callLLM.d.ts.map +1 -1
  821. package/dist/types/core/agent/stages/evidenceRecheck.d.ts +6 -1
  822. package/dist/types/core/agent/stages/evidenceRecheck.d.ts.map +1 -1
  823. package/dist/types/core/agent/stages/outputRetry.d.ts.map +1 -1
  824. package/dist/types/core/agent/stages/prepareFinal.d.ts.map +1 -1
  825. package/dist/types/core/agent/stages/reliabilityExecution.d.ts +3 -0
  826. package/dist/types/core/agent/stages/reliabilityExecution.d.ts.map +1 -1
  827. package/dist/types/core/agent/stages/route.d.ts +8 -2
  828. package/dist/types/core/agent/stages/route.d.ts.map +1 -1
  829. package/dist/types/core/agent/stages/searchCoverage.d.ts +95 -0
  830. package/dist/types/core/agent/stages/searchCoverage.d.ts.map +1 -0
  831. package/dist/types/core/agent/stages/seed.d.ts +9 -0
  832. package/dist/types/core/agent/stages/seed.d.ts.map +1 -1
  833. package/dist/types/core/agent/stages/toolCalls.d.ts +16 -0
  834. package/dist/types/core/agent/stages/toolCalls.d.ts.map +1 -1
  835. package/dist/types/core/agent/toolChoice/compose.d.ts +2 -0
  836. package/dist/types/core/agent/toolChoice/compose.d.ts.map +1 -1
  837. package/dist/types/core/agent/toolChoice/pick.d.ts +2 -0
  838. package/dist/types/core/agent/toolChoice/pick.d.ts.map +1 -1
  839. package/dist/types/core/agent/toolChoice/types.d.ts +1 -1
  840. package/dist/types/core/agent/toolChoice/types.d.ts.map +1 -1
  841. package/dist/types/core/agent/types.d.ts +79 -5
  842. package/dist/types/core/agent/types.d.ts.map +1 -1
  843. package/dist/types/core/checkin.d.ts +83 -7
  844. package/dist/types/core/checkin.d.ts.map +1 -1
  845. package/dist/types/core/consentRequest.d.ts +489 -0
  846. package/dist/types/core/consentRequest.d.ts.map +1 -0
  847. package/dist/types/core/pause.d.ts +88 -7
  848. package/dist/types/core/pause.d.ts.map +1 -1
  849. package/dist/types/core/runCheckpoint.d.ts +5 -1
  850. package/dist/types/core/runCheckpoint.d.ts.map +1 -1
  851. package/dist/types/core/slots/buildToolsSlot.d.ts +2 -1
  852. package/dist/types/core/slots/buildToolsSlot.d.ts.map +1 -1
  853. package/dist/types/debug.d.ts +1 -1
  854. package/dist/types/debug.d.ts.map +1 -1
  855. package/dist/types/events/payloads.d.ts +145 -3
  856. package/dist/types/events/payloads.d.ts.map +1 -1
  857. package/dist/types/events/registry.d.ts +3 -1
  858. package/dist/types/events/registry.d.ts.map +1 -1
  859. package/dist/types/hosting/answeredPause.d.ts +302 -0
  860. package/dist/types/hosting/answeredPause.d.ts.map +1 -0
  861. package/dist/types/hosting/conformance/cases.d.ts.map +1 -1
  862. package/dist/types/hosting/conformance/types.d.ts +1 -1
  863. package/dist/types/hosting/conformance/types.d.ts.map +1 -1
  864. package/dist/types/hosting/envelope.d.ts +6 -0
  865. package/dist/types/hosting/envelope.d.ts.map +1 -1
  866. package/dist/types/hosting/errors.d.ts +14 -2
  867. package/dist/types/hosting/errors.d.ts.map +1 -1
  868. package/dist/types/hosting/index.d.ts +2 -1
  869. package/dist/types/hosting/index.d.ts.map +1 -1
  870. package/dist/types/hosting/memorySessions.d.ts.map +1 -1
  871. package/dist/types/hosting/processLocalStore.d.ts +21 -0
  872. package/dist/types/hosting/processLocalStore.d.ts.map +1 -0
  873. package/dist/types/hosting/protocolAdapter.d.ts +13 -0
  874. package/dist/types/hosting/protocolAdapter.d.ts.map +1 -1
  875. package/dist/types/hosting/refusalStatus.d.ts +6 -0
  876. package/dist/types/hosting/refusalStatus.d.ts.map +1 -1
  877. package/dist/types/hosting/sessionWire.d.ts +8 -3
  878. package/dist/types/hosting/sessionWire.d.ts.map +1 -1
  879. package/dist/types/hosting/sqliteSessions.d.ts.map +1 -1
  880. package/dist/types/hosting/standingAgent.d.ts.map +1 -1
  881. package/dist/types/hosting/streamHandler.d.ts +3 -1
  882. package/dist/types/hosting/streamHandler.d.ts.map +1 -1
  883. package/dist/types/hosting/types.d.ts +28 -6
  884. package/dist/types/hosting/types.d.ts.map +1 -1
  885. package/dist/types/index.d.ts +7 -3
  886. package/dist/types/index.d.ts.map +1 -1
  887. package/dist/types/integrity/negative-claim/anchor.d.ts +10 -0
  888. package/dist/types/integrity/negative-claim/anchor.d.ts.map +1 -0
  889. package/dist/types/integrity/negative-claim/citation.d.ts +35 -0
  890. package/dist/types/integrity/negative-claim/citation.d.ts.map +1 -0
  891. package/dist/types/integrity/negative-claim/containment.d.ts +41 -0
  892. package/dist/types/integrity/negative-claim/containment.d.ts.map +1 -0
  893. package/dist/types/integrity/negative-claim/derive.d.ts +18 -0
  894. package/dist/types/integrity/negative-claim/derive.d.ts.map +1 -0
  895. package/dist/types/integrity/negative-claim/detect.d.ts +45 -0
  896. package/dist/types/integrity/negative-claim/detect.d.ts.map +1 -0
  897. package/dist/types/integrity/negative-claim/judge.d.ts +42 -0
  898. package/dist/types/integrity/negative-claim/judge.d.ts.map +1 -0
  899. package/dist/types/integrity/negative-claim/language.d.ts +15 -0
  900. package/dist/types/integrity/negative-claim/language.d.ts.map +1 -0
  901. package/dist/types/integrity/negative-claim/limits.d.ts +3 -0
  902. package/dist/types/integrity/negative-claim/limits.d.ts.map +1 -0
  903. package/dist/types/integrity/negative-claim/matcher.d.ts +52 -0
  904. package/dist/types/integrity/negative-claim/matcher.d.ts.map +1 -0
  905. package/dist/types/integrity/negative-claim/noRead.d.ts +9 -0
  906. package/dist/types/integrity/negative-claim/noRead.d.ts.map +1 -0
  907. package/dist/types/integrity/negative-claim/phrases.d.ts +70 -0
  908. package/dist/types/integrity/negative-claim/phrases.d.ts.map +1 -0
  909. package/dist/types/integrity/negative-claim/prose.d.ts +37 -0
  910. package/dist/types/integrity/negative-claim/prose.d.ts.map +1 -0
  911. package/dist/types/integrity/negative-claim/readings.d.ts +82 -0
  912. package/dist/types/integrity/negative-claim/readings.d.ts.map +1 -0
  913. package/dist/types/integrity/negative-claim/resolve.d.ts +38 -0
  914. package/dist/types/integrity/negative-claim/resolve.d.ts.map +1 -0
  915. package/dist/types/integrity/negative-claim/statement.d.ts +76 -0
  916. package/dist/types/integrity/negative-claim/statement.d.ts.map +1 -0
  917. package/dist/types/integrity/negative-claim/types.d.ts +145 -0
  918. package/dist/types/integrity/negative-claim/types.d.ts.map +1 -0
  919. package/dist/types/integrity/negative-claim/units.d.ts +34 -0
  920. package/dist/types/integrity/negative-claim/units.d.ts.map +1 -0
  921. package/dist/types/integrity/negative-claim/work.d.ts +13 -0
  922. package/dist/types/integrity/negative-claim/work.d.ts.map +1 -0
  923. package/dist/types/integrity/unsupported-claim/check.d.ts +33 -0
  924. package/dist/types/integrity/unsupported-claim/check.d.ts.map +1 -1
  925. package/dist/types/integrity/unsupported-claim/delivered.d.ts +73 -0
  926. package/dist/types/integrity/unsupported-claim/delivered.d.ts.map +1 -0
  927. package/dist/types/integrity/unsupported-claim/evaluate.d.ts +103 -1
  928. package/dist/types/integrity/unsupported-claim/evaluate.d.ts.map +1 -1
  929. package/dist/types/lib/conventions.d.ts +1 -0
  930. package/dist/types/lib/conventions.d.ts.map +1 -1
  931. package/dist/types/lib/frozenCopy.d.ts +76 -0
  932. package/dist/types/lib/frozenCopy.d.ts.map +1 -0
  933. package/dist/types/lib/jsonFaithful.d.ts +35 -0
  934. package/dist/types/lib/jsonFaithful.d.ts.map +1 -0
  935. package/dist/types/lib/normalize.d.ts +97 -0
  936. package/dist/types/lib/normalize.d.ts.map +1 -0
  937. package/dist/types/mcp/toolExtras.d.ts +10 -0
  938. package/dist/types/mcp/toolExtras.d.ts.map +1 -1
  939. package/dist/types/provider-contract/nativeOutputSchema.d.ts +6 -2
  940. package/dist/types/provider-contract/nativeOutputSchema.d.ts.map +1 -1
  941. package/dist/types/provider-contract/types.d.ts +12 -1
  942. package/dist/types/provider-contract/types.d.ts.map +1 -1
  943. package/dist/types/recorders/core/CheckInRecorder.d.ts +6 -1
  944. package/dist/types/recorders/core/CheckInRecorder.d.ts.map +1 -1
  945. package/dist/types/redaction/conversation.d.ts.map +1 -1
  946. package/dist/types/redaction/knownStrings.d.ts +9 -7
  947. package/dist/types/redaction/knownStrings.d.ts.map +1 -1
  948. package/dist/types/resilience/withCircuitBreaker.d.ts.map +1 -1
  949. package/dist/types/resilience/withFallback.d.ts.map +1 -1
  950. package/dist/types/resilience/withRetry.d.ts.map +1 -1
  951. package/dist/types/semantics/check.d.ts +44 -2
  952. package/dist/types/semantics/check.d.ts.map +1 -1
  953. package/dist/types/semantics/cli.d.ts.map +1 -1
  954. package/dist/types/semantics/coverage/absent.d.ts +19 -2
  955. package/dist/types/semantics/coverage/absent.d.ts.map +1 -1
  956. package/dist/types/semantics/coverage/among.d.ts +74 -0
  957. package/dist/types/semantics/coverage/among.d.ts.map +1 -0
  958. package/dist/types/semantics/coverage/composedCoverage.d.ts +221 -0
  959. package/dist/types/semantics/coverage/composedCoverage.d.ts.map +1 -0
  960. package/dist/types/semantics/coverage/evidence.d.ts.map +1 -1
  961. package/dist/types/semantics/coverage/index.d.ts +4 -1
  962. package/dist/types/semantics/coverage/index.d.ts.map +1 -1
  963. package/dist/types/semantics/coverage/ledger.d.ts +2 -1
  964. package/dist/types/semantics/coverage/ledger.d.ts.map +1 -1
  965. package/dist/types/semantics/coverage/read.d.ts +19 -0
  966. package/dist/types/semantics/coverage/read.d.ts.map +1 -1
  967. package/dist/types/semantics/coverage/recognize.d.ts +17 -1
  968. package/dist/types/semantics/coverage/recognize.d.ts.map +1 -1
  969. package/dist/types/semantics/coverage/search/binding.d.ts +28 -0
  970. package/dist/types/semantics/coverage/search/binding.d.ts.map +1 -0
  971. package/dist/types/semantics/coverage/search/compose.d.ts +91 -0
  972. package/dist/types/semantics/coverage/search/compose.d.ts.map +1 -0
  973. package/dist/types/semantics/coverage/search/declaration.d.ts +76 -0
  974. package/dist/types/semantics/coverage/search/declaration.d.ts.map +1 -0
  975. package/dist/types/semantics/coverage/search/door.d.ts +47 -0
  976. package/dist/types/semantics/coverage/search/door.d.ts.map +1 -0
  977. package/dist/types/semantics/coverage/search/events.d.ts +43 -0
  978. package/dist/types/semantics/coverage/search/events.d.ts.map +1 -0
  979. package/dist/types/semantics/coverage/search/facets.d.ts +53 -0
  980. package/dist/types/semantics/coverage/search/facets.d.ts.map +1 -0
  981. package/dist/types/semantics/coverage/search/gaps.d.ts +64 -0
  982. package/dist/types/semantics/coverage/search/gaps.d.ts.map +1 -0
  983. package/dist/types/semantics/coverage/search/inEffect.d.ts +66 -0
  984. package/dist/types/semantics/coverage/search/inEffect.d.ts.map +1 -0
  985. package/dist/types/semantics/coverage/search/resultFacts.d.ts +43 -0
  986. package/dist/types/semantics/coverage/search/resultFacts.d.ts.map +1 -0
  987. package/dist/types/semantics/coverage/search/review.d.ts +37 -0
  988. package/dist/types/semantics/coverage/search/review.d.ts.map +1 -0
  989. package/dist/types/semantics/coverage/search/served.d.ts +52 -0
  990. package/dist/types/semantics/coverage/search/served.d.ts.map +1 -0
  991. package/dist/types/semantics/coverage/search/span.d.ts +35 -0
  992. package/dist/types/semantics/coverage/search/span.d.ts.map +1 -0
  993. package/dist/types/semantics/coverage/search/statementText.d.ts +47 -0
  994. package/dist/types/semantics/coverage/search/statementText.d.ts.map +1 -0
  995. package/dist/types/semantics/coverage/search/types.d.ts +121 -0
  996. package/dist/types/semantics/coverage/search/types.d.ts.map +1 -0
  997. package/dist/types/semantics/coverage/search/valueWords.d.ts +23 -0
  998. package/dist/types/semantics/coverage/search/valueWords.d.ts.map +1 -0
  999. package/dist/types/semantics/coverage/types.d.ts +163 -0
  1000. package/dist/types/semantics/coverage/types.d.ts.map +1 -1
  1001. package/dist/types/semantics/described.d.ts.map +1 -1
  1002. package/dist/types/semantics/envelope.d.ts.map +1 -1
  1003. package/dist/types/semantics/index.d.ts +2 -1
  1004. package/dist/types/semantics/index.d.ts.map +1 -1
  1005. package/dist/types/semantics/overclaim.d.ts +106 -0
  1006. package/dist/types/semantics/overclaim.d.ts.map +1 -0
  1007. package/dist/types/semantics/types.d.ts +13 -0
  1008. package/dist/types/semantics/types.d.ts.map +1 -1
  1009. package/dist/types/time-travel/servedView.d.ts +1 -1
  1010. package/dist/types/time-travel/servedView.d.ts.map +1 -1
  1011. package/dist/types/tools/declare.d.ts +1 -1
  1012. package/dist/types/tools/hostFilled.d.ts +20 -1
  1013. package/dist/types/tools/hostFilled.d.ts.map +1 -1
  1014. package/dist/types/tools/searchOf.d.ts +61 -0
  1015. package/dist/types/tools/searchOf.d.ts.map +1 -0
  1016. package/dist/types/tools/tools.d.ts +49 -0
  1017. package/dist/types/tools/tools.d.ts.map +1 -1
  1018. package/package.json +1 -1
  1019. package/dist/esm/tools/normalize.d.ts +0 -43
  1020. package/dist/esm/tools/normalize.js.map +0 -1
  1021. package/dist/tools/normalize.js.map +0 -1
  1022. package/dist/types/tools/normalize.d.ts +0 -44
  1023. package/dist/types/tools/normalize.d.ts.map +0 -1
@@ -9,6 +9,7 @@
9
9
  * of what already worked.
10
10
  */
11
11
  export { ABSENCE_MARKER, ABSENCE_NOTE, absent, coverageOfAbsence, readAbsence } from './absent.js';
12
+ export { namesFacetOf } from './among.js';
12
13
  export { answerCoverageOf, composeAnswerWithCoverage, copyAnswerCoverage, copyCoverage, COVERAGE_BLOCK_HEADING, coverageOfAnswer, } from './answer.js';
13
14
  export { absenceEvidenceProjection } from './evidence.js';
14
15
  export { mergeItems, normalizeCoverageList, sameItem } from './items.js';
@@ -16,4 +17,5 @@ export { coverage, COVERAGE_MARKER, COVERAGE_NOTE, coverageOfLedger, readCoverag
16
17
  export { readCoverageResult } from './read.js';
17
18
  export { PERIOD_WIRE, periodVerdict } from './period.js';
18
19
  export { IN_PROGRESS_CLAUSE, IN_PROGRESS_SECTION_LABEL, IN_PROGRESS_WIRE, inProgressLine, } from './inProgress.js';
20
+ export { isComposedCoverage, } from './composedCoverage.js';
19
21
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/semantics/coverage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,GAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAA4C,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAuC,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/semantics/coverage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,GAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAA4C,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAuC,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,GAKnB,MAAM,uBAAuB,CAAC"}
@@ -31,7 +31,7 @@
31
31
  * become a ledger by accident. Same argument as the effects envelope's strict
32
32
  * recognizer, same guarantee.
33
33
  */
34
- import type { Coverage, CoverageLedgerDeclaration, CoveredResult } from './types.js';
34
+ import type { Coverage, CoverageLedgerDeclaration, CoveredResult, DeclaredCoveredResult, DeclaredLedgerDeclaration } from './types.js';
35
35
  import { COVERAGE_MARKER, readCoverageLedger } from './recognize.js';
36
36
  export { COVERAGE_MARKER, readCoverageLedger };
37
37
  /**
@@ -94,6 +94,7 @@ export declare const COVERAGE_NOTE: string;
94
94
  * },
95
95
  * });
96
96
  */
97
+ export declare function coverage<T>(content: T, decl: DeclaredLedgerDeclaration): DeclaredCoveredResult<T>;
97
98
  export declare function coverage<T>(content: T, decl: CoverageLedgerDeclaration): CoveredResult<T>;
98
99
  /** The ledger's coverage, in the normalized three-list shape. */
99
100
  export declare function coverageOfLedger(covered: CoveredResult): Coverage;
@@ -35,6 +35,7 @@ import { mintInProgress } from './inProgress.js';
35
35
  import { normalizeCoverageList } from './items.js';
36
36
  import { mintPeriod } from './period.js';
37
37
  import { refusal, refuseUnknownKeys } from './refusal.js';
38
+ import { DECLARED_CHECKED } from './recognize.js';
38
39
  /**
39
40
  * The keys `coverage()`'s declaration has — the three lists and, since honesty
40
41
  * step 7b, the period the value's read covered — tied to the type in BOTH
@@ -70,54 +71,6 @@ export const COVERAGE_NOTE = 'This result covers only what `checked` lists. `not
70
71
  'result here is ' +
71
72
  'NOT evidence about either, and no retry changes `cannot_cover`. Carry these limits into ' +
72
73
  'any answer you build on this result.';
73
- /**
74
- * Return a verdict with its own boundary attached.
75
- *
76
- * The model reads `{ af_coverage: {…}, result: <your value> }` — boundary
77
- * first, deliberately: a limit placed after a long result is a limit that gets
78
- * skimmed past. The framework records the ledger and, with
79
- * `.limitsTravelWithTheAnswer()` configured, appends it to the run's final
80
- * answer where the model cannot drop it.
81
- *
82
- * `period` (honesty step 7b) says what time the read behind the value
83
- * covered — `{ queried, held, readAt? }`, ISO 8601 instants with a zone; it is
84
- * a boundary on its own, served inside `af_coverage` before `result`, and the
85
- * results layer judges it. `coverage()` takes no `provenance`.
86
- *
87
- * `inProgress` says what the read found still RUNNING — its outcome not known
88
- * yet (a backup in progress, a replication session still synchronizing). The
89
- * tool decides what is in flight; this library never reads a vendor's state
90
- * name. Served as `in_progress` (the dispatch door adds one static clause after
91
- * the note), recorded, and printed under `.limitsTravelWithTheAnswer()`; it
92
- * never changes the answer's standing (`inProgress.ts`). It needs `checked`
93
- * beside it — an item in progress is ground the call read.
94
- *
95
- * Refuses (throws, where it is called) a boundary that declares nothing, a
96
- * malformed item or period, and any key the boundary does not have — naming the
97
- * spelling meant when the key is a casing slip (`not_checked` →
98
- * `notChecked`), so a list declared from plain JavaScript or JSON cannot
99
- * vanish without a word. Every refusal starts `refused: `: inside `execute`
100
- * it becomes the call's error result, which the model reads.
101
- *
102
- * @example the highest-stakes tool in a triage agent
103
- * defineTool({
104
- * name: 'replication_health',
105
- * description: 'Replication health across the estate',
106
- * inputSchema: { type: 'object', properties: {} },
107
- * execute: async () => {
108
- * const { verdict, ndmTimedOut } = await checkReplication();
109
- * return coverage(verdict, {
110
- * checked: ['SRDF pair state on all 4 arrays (live query)'],
111
- * notChecked: ndmTimedOut
112
- * ? [{ what: 'NDM migration sessions', why: 'the API timed out — ask again' }]
113
- * : [],
114
- * cannotCover: [
115
- * { what: 'host-side multipathing', why: 'no collector runs on the ESX hosts' },
116
- * ],
117
- * });
118
- * },
119
- * });
120
- */
121
74
  export function coverage(content, decl) {
122
75
  const fn = 'coverage';
123
76
  if (typeof decl !== 'object' || decl === null) {
@@ -126,7 +79,13 @@ export function coverage(content, decl) {
126
79
  `return it bare.`);
127
80
  }
128
81
  refuseUnknownKeys(decl, LEDGER_DECLARATION_KEYS);
129
- const checked = normalizeCoverageList('checked', decl.checked, false);
82
+ // `checked: 'declared'` — the tool's `search` declares the ground; the
83
+ // dispatch funnel composes it (the `absent()` twin). It is a boundary, so a
84
+ // ledger declaring only it is not the empty ledger refused below.
85
+ const declared = decl.checked === DECLARED_CHECKED;
86
+ const checked = declared
87
+ ? []
88
+ : normalizeCoverageList('checked', decl.checked, false);
130
89
  const notChecked = normalizeCoverageList('notChecked', decl.notChecked, false);
131
90
  const cannotCover = normalizeCoverageList('cannotCover', decl.cannotCover, true);
132
91
  // Honesty step 7b: the period the value's read covered, by the ONE period
@@ -139,11 +98,12 @@ export function coverage(content, decl) {
139
98
  // fired only when something happened to be running would pass every test
140
99
  // and refuse on the first busy night in production (the 7a′ lesson).
141
100
  const inProgress = mintInProgress(decl.inProgress);
142
- if (decl.inProgress != null && checked.length === 0) {
101
+ if (decl.inProgress != null && checked.length === 0 && !declared) {
143
102
  throw refusal('`inProgress` needs `checked` beside it — an item still running is ground the call ' +
144
103
  'read, so say what the call read.');
145
104
  }
146
- if (checked.length === 0 &&
105
+ if (!declared &&
106
+ checked.length === 0 &&
147
107
  notChecked.length === 0 &&
148
108
  cannotCover.length === 0 &&
149
109
  period === undefined) {
@@ -152,9 +112,10 @@ export function coverage(content, decl) {
152
112
  `nothing. Name what you checked, what you skipped, or what you can never see; or ` +
153
113
  `return the result bare.`);
154
114
  }
155
- return {
115
+ // Built untyped, then given the type its `checked` decides (the overloads).
116
+ const minted = {
156
117
  af_coverage: {
157
- ...(checked.length > 0 && { checked }),
118
+ ...(declared ? { checked: DECLARED_CHECKED } : checked.length > 0 && { checked }),
158
119
  ...(notChecked.length > 0 && { not_checked: notChecked }),
159
120
  ...(cannotCover.length > 0 && { cannot_cover: cannotCover }),
160
121
  ...(inProgress.length > 0 && { in_progress: inProgress }),
@@ -164,6 +125,7 @@ export function coverage(content, decl) {
164
125
  },
165
126
  result: content,
166
127
  };
128
+ return minted;
167
129
  }
168
130
  /** The ledger's coverage, in the normalized three-list shape. */
169
131
  export function coverageOfLedger(covered) {
@@ -1 +1 @@
1
- {"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../../../src/semantics/coverage/ledger.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../../../src/semantics/coverage/ledger.ts"],"names":[],"mappings":"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"}
@@ -19,7 +19,21 @@
19
19
  import type { ToolResultStatus } from '../toolOutcome.js';
20
20
  import { type DeclaredProvenance } from '../described.js';
21
21
  import { type DeclaredPeriod } from './period.js';
22
+ import type { ComposedCoverage } from './composedCoverage.js';
22
23
  import type { Coverage, InProgressItem, TryInsteadTool } from './types.js';
24
+ /**
25
+ * What the LIBRARY composed for a call of a tool that declares its `search`
26
+ * (`search/compose.ts`) — the fields a {@link ComposedCoverage} row adds. The
27
+ * typed items ride `CoverageFacts.coverage.checked`.
28
+ */
29
+ export interface ComposedFacts {
30
+ /** `'local'` for a first-party tool; `'remote'` over MCP or from a ToolProvider. */
31
+ readonly origin: ComposedCoverage['composed'];
32
+ readonly resultId: string;
33
+ readonly handle: string;
34
+ readonly complete: boolean;
35
+ readonly gaps: ComposedCoverage['gaps'];
36
+ }
23
37
  /** One coverage statement found in a result, before the caller stamps it with
24
38
  * the call it came from. */
25
39
  export interface CoverageFacts {
@@ -56,6 +70,11 @@ export interface CoverageFacts {
56
70
  * and the model still reads what the tool wrote.
57
71
  */
58
72
  readonly inProgress?: readonly InProgressItem[];
73
+ /**
74
+ * Present only when the library composed this statement from the tool's
75
+ * `search` — never read off an envelope: a value cannot forge it.
76
+ */
77
+ readonly composed?: ComposedFacts;
59
78
  }
60
79
  /** What one recognized result declares. `undefined` from
61
80
  * {@link readCoverageResult} means "neither shape": untouched path. */
@@ -1 +1 @@
1
- {"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/semantics/coverage/read.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/semantics/coverage/read.ts"],"names":[],"mappings":"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"}
@@ -9,7 +9,7 @@
9
9
  * tool-name checks and refusal sentences. `absent.ts` and `ledger.ts` re-export
10
10
  * these names, so every existing import keeps working.
11
11
  */
12
- import type { CoveredResult, ToolAbsence } from './types.js';
12
+ import type { CoveredResult, DeclaredCoveredResult, DeclaredToolAbsence, ToolAbsence } from './types.js';
13
13
  /**
14
14
  * The reserved key that makes an absence recognizable. Exported because tests,
15
15
  * docs and any consumer inspecting a raw tool result match on it — and
@@ -27,6 +27,16 @@ export declare const ABSENCE_MARKER = "af_absent";
27
27
  * does not guess at a shape it did not mint.
28
28
  */
29
29
  export declare function readAbsence(value: unknown): ToolAbsence | undefined;
30
+ /** The literal `absent({ checked: 'declared' })` mints in place of a list. */
31
+ export declare const DECLARED_CHECKED = "declared";
32
+ /**
33
+ * Recognize the envelope `absent({ checked: 'declared' })` mints — an absence
34
+ * whose coverage the tool's `search` declares, before the dispatch funnel
35
+ * composes it. STRICT like {@link readAbsence}: a plain object whose
36
+ * `af_absent` is exactly `true` and whose `checked` is exactly the literal.
37
+ * `readAbsence` never reads this shape, so a reader that predates it sees data.
38
+ */
39
+ export declare function readDeclaredAbsence(value: unknown): DeclaredToolAbsence | undefined;
30
40
  /** The reserved key that makes a ledger recognizable. */
31
41
  export declare const COVERAGE_MARKER = "af_coverage";
32
42
  /**
@@ -35,3 +45,9 @@ export declare const COVERAGE_MARKER = "af_coverage";
35
45
  * `af_coverage` object AND a `result` key qualifies.
36
46
  */
37
47
  export declare function readCoverageLedger(value: unknown): CoveredResult | undefined;
48
+ /**
49
+ * Recognize the envelope `coverage(rows, { checked: 'declared' })` mints — a
50
+ * ledger whose coverage the tool's `search` declares, before the dispatch
51
+ * funnel composes it. STRICT like {@link readCoverageLedger}.
52
+ */
53
+ export declare function readDeclaredLedger(value: unknown): DeclaredCoveredResult | undefined;
@@ -35,6 +35,23 @@ export function readAbsence(value) {
35
35
  return undefined;
36
36
  return value;
37
37
  }
38
+ /** The literal `absent({ checked: 'declared' })` mints in place of a list. */
39
+ export const DECLARED_CHECKED = 'declared';
40
+ /**
41
+ * Recognize the envelope `absent({ checked: 'declared' })` mints — an absence
42
+ * whose coverage the tool's `search` declares, before the dispatch funnel
43
+ * composes it. STRICT like {@link readAbsence}: a plain object whose
44
+ * `af_absent` is exactly `true` and whose `checked` is exactly the literal.
45
+ * `readAbsence` never reads this shape, so a reader that predates it sees data.
46
+ */
47
+ export function readDeclaredAbsence(value) {
48
+ if (typeof value !== 'object' || value === null || Array.isArray(value))
49
+ return undefined;
50
+ const rec = value;
51
+ if (rec[ABSENCE_MARKER] !== true || rec.checked !== DECLARED_CHECKED)
52
+ return undefined;
53
+ return value;
54
+ }
38
55
  /** The reserved key that makes a ledger recognizable. */
39
56
  export const COVERAGE_MARKER = 'af_coverage';
40
57
  /**
@@ -51,6 +68,29 @@ export function readCoverageLedger(value) {
51
68
  return undefined;
52
69
  if (!('result' in rec))
53
70
  return undefined;
71
+ // `coverage(rows, { checked: 'declared' })` before the funnel composes it:
72
+ // not a ledger a reader can read (its `checked` is not a list) — see
73
+ // `readDeclaredLedger`.
74
+ if (marker.checked === DECLARED_CHECKED)
75
+ return undefined;
76
+ return value;
77
+ }
78
+ /**
79
+ * Recognize the envelope `coverage(rows, { checked: 'declared' })` mints — a
80
+ * ledger whose coverage the tool's `search` declares, before the dispatch
81
+ * funnel composes it. STRICT like {@link readCoverageLedger}.
82
+ */
83
+ export function readDeclaredLedger(value) {
84
+ if (typeof value !== 'object' || value === null || Array.isArray(value))
85
+ return undefined;
86
+ const rec = value;
87
+ const marker = rec[COVERAGE_MARKER];
88
+ if (typeof marker !== 'object' || marker === null || Array.isArray(marker))
89
+ return undefined;
90
+ if (!('result' in rec))
91
+ return undefined;
92
+ if (marker.checked !== DECLARED_CHECKED)
93
+ return undefined;
54
94
  return value;
55
95
  }
56
96
  //# sourceMappingURL=recognize.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"recognize.js","sourceRoot":"","sources":["../../../../src/semantics/coverage/recognize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9E,OAAO,KAAoB,CAAC;AAC9B,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IACpC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7F,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,KAAsB,CAAC;AAChC,CAAC"}
1
+ {"version":3,"file":"recognize.js","sourceRoot":"","sources":["../../../../src/semantics/coverage/recognize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9E,OAAO,KAAoB,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACvF,OAAO,KAA4B,CAAC;AACtC,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IACpC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7F,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,2EAA2E;IAC3E,qEAAqE;IACrE,wBAAwB;IACxB,IAAK,MAAkC,CAAC,OAAO,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACvF,OAAO,KAAsB,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IACpC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7F,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,IAAK,MAAkC,CAAC,OAAO,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACvF,OAAO,KAA8B,CAAC;AACxC,CAAC"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * search/binding — which `resolved` entity a population value may carry.
3
+ *
4
+ * Pattern: one pure rule (review item N4).
5
+ * Role: semantics/ layer, pure.
6
+ * Emits: N/A.
7
+ *
8
+ * A tool's result may say what each population value resolved to —
9
+ * `resolved: [{ argument, id, name?, aliases? }]`. Those words later bind a
10
+ * claim's entity, so they may bind ONLY the entity the call was sent for:
11
+ * an entry attaches to a sent value when its `argument` is that value's
12
+ * argument AND the value is one of the entity's own names (`id`, `name` or an
13
+ * alias). Store data cannot bind another entity's name: an entry for
14
+ * `billing` never rides the item for `payments`.
15
+ *
16
+ * Names compare by the ONE case rule (`lib/normalize.ts` · `sameName`, the
17
+ * claim comparator's own): a foldable word may differ in case; a short word,
18
+ * a mixed-case one or anything with a digit keeps its case. Token shape
19
+ * (plural, punctuation) decides nothing.
20
+ */
21
+ import type { ResolvedEntity } from '../composedCoverage.js';
22
+ import type { ResolvedDeclaration } from './resultFacts.js';
23
+ /**
24
+ * The entity `value` (sent as `argument`) resolved to, or `undefined` when no
25
+ * entry names it among its own names.
26
+ */
27
+ export declare function resolvedFor(argument: string, value: unknown, resolved: readonly ResolvedDeclaration[] | undefined): ResolvedEntity | undefined;
@@ -0,0 +1,42 @@
1
+ /**
2
+ * search/binding — which `resolved` entity a population value may carry.
3
+ *
4
+ * Pattern: one pure rule (review item N4).
5
+ * Role: semantics/ layer, pure.
6
+ * Emits: N/A.
7
+ *
8
+ * A tool's result may say what each population value resolved to —
9
+ * `resolved: [{ argument, id, name?, aliases? }]`. Those words later bind a
10
+ * claim's entity, so they may bind ONLY the entity the call was sent for:
11
+ * an entry attaches to a sent value when its `argument` is that value's
12
+ * argument AND the value is one of the entity's own names (`id`, `name` or an
13
+ * alias). Store data cannot bind another entity's name: an entry for
14
+ * `billing` never rides the item for `payments`.
15
+ *
16
+ * Names compare by the ONE case rule (`lib/normalize.ts` · `sameName`, the
17
+ * claim comparator's own): a foldable word may differ in case; a short word,
18
+ * a mixed-case one or anything with a digit keeps its case. Token shape
19
+ * (plural, punctuation) decides nothing.
20
+ */
21
+ import { sameName } from '../../../lib/normalize.js';
22
+ /**
23
+ * The entity `value` (sent as `argument`) resolved to, or `undefined` when no
24
+ * entry names it among its own names.
25
+ */
26
+ export function resolvedFor(argument, value, resolved) {
27
+ if (resolved === undefined)
28
+ return undefined;
29
+ if (typeof value !== 'string' && typeof value !== 'number')
30
+ return undefined;
31
+ const sent = String(value);
32
+ const entry = resolved.find((r) => r.argument === argument &&
33
+ [r.id, ...(r.name !== undefined ? [r.name] : []), ...(r.aliases ?? [])].some((n) => sameName(n, sent)));
34
+ if (entry === undefined)
35
+ return undefined;
36
+ return {
37
+ id: entry.id,
38
+ ...(entry.name !== undefined && { name: entry.name }),
39
+ ...(entry.aliases !== undefined && { aliases: [...entry.aliases] }),
40
+ };
41
+ }
42
+ //# sourceMappingURL=binding.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../../../src/semantics/coverage/search/binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAIrD;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,KAAc,EACd,QAAoD;IAEpD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,QAAQ,KAAK,QAAQ;QACvB,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACjF,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAClB,CACJ,CAAC;IACF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACrD,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC"}
@@ -0,0 +1,90 @@
1
+ /**
2
+ * search/compose — ONE call's coverage, composed by the library from the
3
+ * tool's `search` declaration and the arguments the call ran with.
4
+ *
5
+ * Pattern: linear composition of small pure rules —
6
+ * door (what came back) → inEffect (each argument) → facets
7
+ * (`checked`) → gaps → complete → the reading the funnel files.
8
+ * Role: semantics/ layer, pure. Called by the dispatch funnel
9
+ * (`../../../core/agent/stages/searchCoverage.ts` · `buildSearchCoverage`) at
10
+ * every execute boundary, before `declareCoverage`.
11
+ * Emits: N/A (the funnel emits, from the reading).
12
+ *
13
+ * ## Composition can only under-claim — relative to a TRUE declaration
14
+ *
15
+ * A declaration that misdescribes the query (an undeclared qualifier, a wrong
16
+ * `complete`) is the trusted base, said out loud: the law holds relative to
17
+ * it, never to the backend.
18
+ *
19
+ * A facet enters `checked` from exactly four places — a value the call sent, a
20
+ * declared default composed as if sent, a declared fixed qualifier, the
21
+ * declared (or sent) source — plus a host-filled identity filter (which only
22
+ * narrows) and a result-declared period (which only narrows). Every
23
+ * classified argument none of them covers is a bearing gap; a cap in effect,
24
+ * a declared server cap, a page, a `partial` outcome is a completeness gap
25
+ * unless the result says otherwise. So the composed scope is never wider than
26
+ * what the declaration and the arguments say. A wrong declaration is the
27
+ * trusted base, said out loud.
28
+ *
29
+ * ## Local and remote
30
+ *
31
+ * A `search` that arrived over MCP or from a `ToolProvider` composes the same
32
+ * shape, marked `'remote'`, and is never `complete`: it establishes nothing.
33
+ */
34
+ import type { PeriodShapes } from '../../../time/periodForm.js';
35
+ import type { ToolResultStatus } from '../../toolOutcome.js';
36
+ import { type CoverageReading } from '../read.js';
37
+ import { type HostFilledArguments } from './inEffect.js';
38
+ import type { ToolSearch } from './types.js';
39
+ /** One call of a search tool, as the funnel knows it. */
40
+ export interface SearchCall {
41
+ readonly toolName: string;
42
+ readonly toolCallId: string;
43
+ readonly iteration: number;
44
+ /** The row's address — `claim-result/<namespace>/<runId>/<ordinal>`, minted by the funnel. */
45
+ readonly resultId: string;
46
+ /** The read's short handle (`r3`), minted with the identity. */
47
+ readonly handle: string;
48
+ readonly search: ToolSearch;
49
+ /** `'remote'` for a declaration that arrived over MCP or from a `ToolProvider`. */
50
+ readonly origin: 'local' | 'remote';
51
+ /** The arguments the tool ran with — after the inputs layer's fill and any before-tool rewrite. */
52
+ readonly args: Readonly<Record<string, unknown>>;
53
+ /** Arguments `hostFilled` fills inside `execute`, from its own declaration. */
54
+ readonly hostFilled?: HostFilledArguments;
55
+ /** The tool's `period`, for resolving a relative window. */
56
+ readonly period?: PeriodShapes;
57
+ /**
58
+ * When the call was DISPATCHED (an ISO instant) — the clock the time layer
59
+ * hands the tool, or the dispatch moment. A relative window resolves here,
60
+ * so a call resumed after a pause composes the span it actually ran with.
61
+ */
62
+ readonly dispatchedAt?: string;
63
+ /** The outcome the tool declared on its effects envelope, if any. */
64
+ readonly status?: ToolResultStatus;
65
+ }
66
+ /** What composition made of one result. */
67
+ export type SearchComposition = {
68
+ readonly outcome: 'composed';
69
+ /** What the model is served: the composed absence, or the value as returned. */
70
+ readonly value: unknown;
71
+ readonly reading: CoverageReading;
72
+ }
73
+ /** The result hand-wrote `checked` beside the declaration: filed as written, composed never. */
74
+ | {
75
+ readonly outcome: 'declined';
76
+ readonly code: 'checked-beside-declared';
77
+ };
78
+ /**
79
+ * Compose one call's coverage from its search, or `undefined` when the value
80
+ * came through no door (plain data: nothing is composed, nothing changes).
81
+ * THROWS a refusal (`refused: …`) for a `coverage()` wrapped around a
82
+ * declared absence — at the execute boundary, that is the call's error.
83
+ *
84
+ * @example
85
+ * ```ts
86
+ * const out = composeSearchCoverage(call, absent({ what: 'x', checked: 'declared' }));
87
+ * out?.outcome === 'composed' && out.reading.declared[0]?.composed?.complete;
88
+ * ```
89
+ */
90
+ export declare function composeSearchCoverage(call: SearchCall, result: unknown): SearchComposition | undefined;
@@ -0,0 +1,120 @@
1
+ /**
2
+ * search/compose — ONE call's coverage, composed by the library from the
3
+ * tool's `search` declaration and the arguments the call ran with.
4
+ *
5
+ * Pattern: linear composition of small pure rules —
6
+ * door (what came back) → inEffect (each argument) → facets
7
+ * (`checked`) → gaps → complete → the reading the funnel files.
8
+ * Role: semantics/ layer, pure. Called by the dispatch funnel
9
+ * (`../../../core/agent/stages/searchCoverage.ts` · `buildSearchCoverage`) at
10
+ * every execute boundary, before `declareCoverage`.
11
+ * Emits: N/A (the funnel emits, from the reading).
12
+ *
13
+ * ## Composition can only under-claim — relative to a TRUE declaration
14
+ *
15
+ * A declaration that misdescribes the query (an undeclared qualifier, a wrong
16
+ * `complete`) is the trusted base, said out loud: the law holds relative to
17
+ * it, never to the backend.
18
+ *
19
+ * A facet enters `checked` from exactly four places — a value the call sent, a
20
+ * declared default composed as if sent, a declared fixed qualifier, the
21
+ * declared (or sent) source — plus a host-filled identity filter (which only
22
+ * narrows) and a result-declared period (which only narrows). Every
23
+ * classified argument none of them covers is a bearing gap; a cap in effect,
24
+ * a declared server cap, a page, a `partial` outcome is a completeness gap
25
+ * unless the result says otherwise. So the composed scope is never wider than
26
+ * what the declaration and the arguments say. A wrong declaration is the
27
+ * trusted base, said out loud.
28
+ *
29
+ * ## Local and remote
30
+ *
31
+ * A `search` that arrived over MCP or from a `ToolProvider` composes the same
32
+ * shape, marked `'remote'`, and is never `complete`: it establishes nothing.
33
+ */
34
+ import { readCoverageResult } from '../read.js';
35
+ import { readSearchDoor } from './door.js';
36
+ import { composeChecked } from './facets.js';
37
+ import { blocksComplete, composeGaps } from './gaps.js';
38
+ import { readArgument } from './inEffect.js';
39
+ import { servedAbsence, servedLedger } from './served.js';
40
+ /** The facts the reader files for a door, before composition overrides its lists. */
41
+ function baseFacts(served, door, toolName) {
42
+ const read = readCoverageResult(served, toolName)?.declared[0];
43
+ if (read !== undefined)
44
+ return read;
45
+ return {
46
+ kind: door.door === 'declared-absence' ? 'absence' : 'ledger',
47
+ coverage: { checked: [], notChecked: [], cannotCover: [] },
48
+ ...(door.period !== undefined && { period: door.period }),
49
+ };
50
+ }
51
+ /**
52
+ * Compose one call's coverage from its search, or `undefined` when the value
53
+ * came through no door (plain data: nothing is composed, nothing changes).
54
+ * THROWS a refusal (`refused: …`) for a `coverage()` wrapped around a
55
+ * declared absence — at the execute boundary, that is the call's error.
56
+ *
57
+ * @example
58
+ * ```ts
59
+ * const out = composeSearchCoverage(call, absent({ what: 'x', checked: 'declared' }));
60
+ * out?.outcome === 'composed' && out.reading.declared[0]?.composed?.complete;
61
+ * ```
62
+ */
63
+ export function composeSearchCoverage(call, result) {
64
+ const door = readSearchDoor(result, call.toolName);
65
+ if (door === undefined)
66
+ return undefined;
67
+ if (door.outcome === 'checked-beside-declared') {
68
+ return { outcome: 'declined', code: 'checked-beside-declared' };
69
+ }
70
+ const facts = door.facts;
71
+ const readings = call.search.arguments.map((arg) => [arg, readArgument(arg, call.args, call.hostFilled)]);
72
+ const checked = composeChecked({
73
+ search: call.search,
74
+ readings,
75
+ ...(facts.resolved !== undefined && { resolved: facts.resolved }),
76
+ ...(facts.period !== undefined && { resultPeriod: facts.period }),
77
+ ...(call.period !== undefined && { period: call.period }),
78
+ ...(call.dispatchedAt !== undefined && { dispatchedAt: call.dispatchedAt }),
79
+ });
80
+ const { gaps, notChecked, cannotCover } = composeGaps({
81
+ search: call.search,
82
+ readings,
83
+ rows: facts.rows,
84
+ ...(facts.paging !== undefined && { paging: facts.paging }),
85
+ ...(facts.period !== undefined && { period: facts.period }),
86
+ ...(call.status !== undefined && { status: call.status }),
87
+ handNotChecked: facts.handNotChecked,
88
+ handCannotCover: facts.handCannotCover,
89
+ });
90
+ const complete = call.origin === 'local' &&
91
+ call.search.complete === 'within-arguments' &&
92
+ !gaps.some(blocksComplete);
93
+ const lists = { notChecked, cannotCover };
94
+ const value = facts.absence !== undefined
95
+ ? servedAbsence(facts.absence, checked, lists)
96
+ : facts.ledger !== undefined
97
+ ? servedLedger(facts.ledger, checked, lists)
98
+ : result;
99
+ const base = baseFacts(value, facts, call.toolName);
100
+ const composedFacts = {
101
+ ...base,
102
+ coverage: { checked, notChecked, cannotCover },
103
+ composed: {
104
+ origin: call.origin,
105
+ resultId: call.resultId,
106
+ handle: call.handle,
107
+ complete,
108
+ gaps,
109
+ },
110
+ };
111
+ return {
112
+ outcome: 'composed',
113
+ value,
114
+ reading: {
115
+ ...(facts.door === 'declared-absence' && { status: 'absent' }),
116
+ declared: [composedFacts],
117
+ },
118
+ };
119
+ }
120
+ //# sourceMappingURL=compose.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../../../src/semantics/coverage/search/compose.ts"],"names":[],"mappings":"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"}