agentfootprint 10.9.0 → 11.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1100) hide show
  1. package/AGENTS.md +14 -4
  2. package/CAPABILITIES.md +16 -3
  3. package/README.md +115 -52
  4. package/ai-instructions/claude-code/SKILL.md +14 -4
  5. package/dist/adapters/hosting/agentCoreA2A.js +4 -0
  6. package/dist/adapters/hosting/agentCoreA2A.js.map +1 -1
  7. package/dist/adapters/hosting/firestoreSessions.js +9 -2
  8. package/dist/adapters/hosting/firestoreSessions.js.map +1 -1
  9. package/dist/adapters/hosting/googleAgentEngine.js +4 -6
  10. package/dist/adapters/hosting/googleAgentEngine.js.map +1 -1
  11. package/dist/adapters/llm/AnthropicProvider.js +4 -0
  12. package/dist/adapters/llm/AnthropicProvider.js.map +1 -1
  13. package/dist/adapters/llm/BrowserAnthropicProvider.js +4 -0
  14. package/dist/adapters/llm/BrowserAnthropicProvider.js.map +1 -1
  15. package/dist/adapters/llm/MockProvider.js +2 -0
  16. package/dist/adapters/llm/MockProvider.js.map +1 -1
  17. package/dist/ag-ui/request.js +27 -2
  18. package/dist/ag-ui/request.js.map +1 -1
  19. package/dist/ag-ui/serializer.js +21 -8
  20. package/dist/ag-ui/serializer.js.map +1 -1
  21. package/dist/answer-account/facts/howSure.js +3 -0
  22. package/dist/answer-account/facts/howSure.js.map +1 -1
  23. package/dist/answer-account/templates.js +4 -1
  24. package/dist/answer-account/templates.js.map +1 -1
  25. package/dist/answer-validation/agentChecks.js +130 -0
  26. package/dist/answer-validation/agentChecks.js.map +1 -0
  27. package/dist/answer-validation/index.js +5 -1
  28. package/dist/answer-validation/index.js.map +1 -1
  29. package/dist/answer-validation/outputSchema.js +8 -1
  30. package/dist/answer-validation/outputSchema.js.map +1 -1
  31. package/dist/answer-validation/types.js +9 -2
  32. package/dist/answer-validation/types.js.map +1 -1
  33. package/dist/answer-validation/validate.js +82 -3
  34. package/dist/answer-validation/validate.js.map +1 -1
  35. package/dist/core/Agent.js +214 -59
  36. package/dist/core/Agent.js.map +1 -1
  37. package/dist/core/RunnerBase.js +4 -0
  38. package/dist/core/RunnerBase.js.map +1 -1
  39. package/dist/core/agent/AgentBuilder.js +139 -33
  40. package/dist/core/agent/AgentBuilder.js.map +1 -1
  41. package/dist/core/agent/arguments/checks.js +1 -1
  42. package/dist/core/agent/arguments/subflow.js +1 -0
  43. package/dist/core/agent/arguments/subflow.js.map +1 -1
  44. package/dist/core/agent/assessment/assess.js +31 -0
  45. package/dist/core/agent/assessment/assess.js.map +1 -1
  46. package/dist/core/agent/assessment/compose.js +3 -0
  47. package/dist/core/agent/assessment/compose.js.map +1 -1
  48. package/dist/core/agent/assessment/reasons.js +19 -1
  49. package/dist/core/agent/assessment/reasons.js.map +1 -1
  50. package/dist/core/agent/buildAgentChart.js +7 -17
  51. package/dist/core/agent/buildAgentChart.js.map +1 -1
  52. package/dist/core/agent/buildDynamicAgentChart.js +18 -15
  53. package/dist/core/agent/buildDynamicAgentChart.js.map +1 -1
  54. package/dist/core/agent/buildToolRegistry.js +13 -0
  55. package/dist/core/agent/buildToolRegistry.js.map +1 -1
  56. package/dist/core/agent/composeRequest.js +19 -1
  57. package/dist/core/agent/composeRequest.js.map +1 -1
  58. package/dist/core/agent/evidence/answerCarriers.js +1 -1
  59. package/dist/core/agent/evidence/answerCarriers.js.map +1 -1
  60. package/dist/core/agent/evidence/evidenceIndex.js +1 -1
  61. package/dist/core/agent/evidence/evidenceIndex.js.map +1 -1
  62. package/dist/core/agent/evidence/extract.js +139 -32
  63. package/dist/core/agent/evidence/extract.js.map +1 -1
  64. package/dist/core/agent/evidence/figures.js +1 -1
  65. package/dist/core/agent/evidence/figures.js.map +1 -1
  66. package/dist/core/agent/evidence/frames.js +3 -1
  67. package/dist/core/agent/evidence/frames.js.map +1 -1
  68. package/dist/core/agent/evidence/gate.js +10 -2
  69. package/dist/core/agent/evidence/gate.js.map +1 -1
  70. package/dist/core/agent/evidence/numericRanges.js +1 -1
  71. package/dist/core/agent/evidence/numericRanges.js.map +1 -1
  72. package/dist/core/agent/evidence/recovery.js +3 -1
  73. package/dist/core/agent/evidence/recovery.js.map +1 -1
  74. package/dist/core/agent/evidence/resultCarries.js +3 -3
  75. package/dist/core/agent/evidence/resultCarries.js.map +1 -1
  76. package/dist/core/agent/findings/context.js +163 -0
  77. package/dist/core/agent/findings/context.js.map +1 -0
  78. package/dist/core/agent/findings/contingent.js +1 -1
  79. package/dist/core/agent/findings/contingent.js.map +1 -1
  80. package/dist/core/agent/findings/instruction.js +26 -0
  81. package/dist/core/agent/findings/instruction.js.map +1 -0
  82. package/dist/core/agent/findings/ledger.js +49 -0
  83. package/dist/core/agent/findings/ledger.js.map +1 -1
  84. package/dist/core/agent/findings/negativeProse.js +53 -0
  85. package/dist/core/agent/findings/negativeProse.js.map +1 -0
  86. package/dist/core/agent/findings/offer.js +9 -57
  87. package/dist/core/agent/findings/offer.js.map +1 -1
  88. package/dist/core/agent/findings/reserved.js +12 -83
  89. package/dist/core/agent/findings/reserved.js.map +1 -1
  90. package/dist/core/agent/findings/types.js +3 -2
  91. package/dist/core/agent/findings/types.js.map +1 -1
  92. package/dist/core/agent/honesty/mounts.js +6 -0
  93. package/dist/core/agent/honesty/mounts.js.map +1 -1
  94. package/dist/core/agent/nativeOutputFormat.js +19 -1
  95. package/dist/core/agent/nativeOutputFormat.js.map +1 -1
  96. package/dist/core/agent/negativeClaims/capture.js +522 -0
  97. package/dist/core/agent/negativeClaims/capture.js.map +1 -0
  98. package/dist/core/agent/negativeClaims/checkpoint.js +83 -0
  99. package/dist/core/agent/negativeClaims/checkpoint.js.map +1 -0
  100. package/dist/core/agent/negativeClaims/config.js +192 -0
  101. package/dist/core/agent/negativeClaims/config.js.map +1 -0
  102. package/dist/core/agent/negativeClaims/delivery.js +249 -0
  103. package/dist/core/agent/negativeClaims/delivery.js.map +1 -0
  104. package/dist/core/agent/negativeClaims/observe.js +38 -0
  105. package/dist/core/agent/negativeClaims/observe.js.map +1 -0
  106. package/dist/core/agent/negativeClaims/prose.js +116 -0
  107. package/dist/core/agent/negativeClaims/prose.js.map +1 -0
  108. package/dist/core/agent/negativeClaims/recheck.js +37 -0
  109. package/dist/core/agent/negativeClaims/recheck.js.map +1 -0
  110. package/dist/core/agent/outputEnforcement.js.map +1 -1
  111. package/dist/core/agent/stages/answerEvidence.js +21 -0
  112. package/dist/core/agent/stages/answerEvidence.js.map +1 -0
  113. package/dist/core/agent/stages/answerValidation.js +112 -4
  114. package/dist/core/agent/stages/answerValidation.js.map +1 -1
  115. package/dist/core/agent/stages/callLLM.js +82 -41
  116. package/dist/core/agent/stages/callLLM.js.map +1 -1
  117. package/dist/core/agent/stages/evidenceRecheck.js +16 -2
  118. package/dist/core/agent/stages/evidenceRecheck.js.map +1 -1
  119. package/dist/core/agent/stages/outputRetry.js +23 -7
  120. package/dist/core/agent/stages/outputRetry.js.map +1 -1
  121. package/dist/core/agent/stages/prepareFinal.js +6 -1
  122. package/dist/core/agent/stages/prepareFinal.js.map +1 -1
  123. package/dist/core/agent/stages/reliabilityExecution.js +3 -0
  124. package/dist/core/agent/stages/reliabilityExecution.js.map +1 -1
  125. package/dist/core/agent/stages/route.js +81 -33
  126. package/dist/core/agent/stages/route.js.map +1 -1
  127. package/dist/core/agent/stages/searchCoverage.js +121 -0
  128. package/dist/core/agent/stages/searchCoverage.js.map +1 -0
  129. package/dist/core/agent/stages/seed.js +19 -21
  130. package/dist/core/agent/stages/seed.js.map +1 -1
  131. package/dist/core/agent/stages/toolCalls.js +699 -76
  132. package/dist/core/agent/stages/toolCalls.js.map +1 -1
  133. package/dist/core/agent/toolChoice/compose.js +1 -0
  134. package/dist/core/agent/toolChoice/compose.js.map +1 -1
  135. package/dist/core/agent/toolChoice/pick.js +2 -0
  136. package/dist/core/agent/toolChoice/pick.js.map +1 -1
  137. package/dist/core/checkin.js +82 -18
  138. package/dist/core/checkin.js.map +1 -1
  139. package/dist/core/consentRequest.js +844 -0
  140. package/dist/core/consentRequest.js.map +1 -0
  141. package/dist/core/pause.js +104 -6
  142. package/dist/core/pause.js.map +1 -1
  143. package/dist/core/runCheckpoint.js +8 -1
  144. package/dist/core/runCheckpoint.js.map +1 -1
  145. package/dist/core/slots/buildToolsSlot.js +4 -24
  146. package/dist/core/slots/buildToolsSlot.js.map +1 -1
  147. package/dist/debug.js +2 -0
  148. package/dist/debug.js.map +1 -1
  149. package/dist/esm/adapters/hosting/agentCoreA2A.js +4 -0
  150. package/dist/esm/adapters/hosting/agentCoreA2A.js.map +1 -1
  151. package/dist/esm/adapters/hosting/firestoreSessions.js +9 -2
  152. package/dist/esm/adapters/hosting/firestoreSessions.js.map +1 -1
  153. package/dist/esm/adapters/hosting/googleAgentEngine.js +4 -6
  154. package/dist/esm/adapters/hosting/googleAgentEngine.js.map +1 -1
  155. package/dist/esm/adapters/llm/AnthropicProvider.d.ts +1 -0
  156. package/dist/esm/adapters/llm/AnthropicProvider.js +5 -1
  157. package/dist/esm/adapters/llm/AnthropicProvider.js.map +1 -1
  158. package/dist/esm/adapters/llm/BrowserAnthropicProvider.d.ts +1 -0
  159. package/dist/esm/adapters/llm/BrowserAnthropicProvider.js +5 -1
  160. package/dist/esm/adapters/llm/BrowserAnthropicProvider.js.map +1 -1
  161. package/dist/esm/adapters/llm/MockProvider.d.ts +2 -0
  162. package/dist/esm/adapters/llm/MockProvider.js +2 -0
  163. package/dist/esm/adapters/llm/MockProvider.js.map +1 -1
  164. package/dist/esm/ag-ui/request.d.ts +4 -1
  165. package/dist/esm/ag-ui/request.js +27 -2
  166. package/dist/esm/ag-ui/request.js.map +1 -1
  167. package/dist/esm/ag-ui/serializer.d.ts +15 -2
  168. package/dist/esm/ag-ui/serializer.js +20 -7
  169. package/dist/esm/ag-ui/serializer.js.map +1 -1
  170. package/dist/esm/answer-account/facts/howSure.js +3 -0
  171. package/dist/esm/answer-account/facts/howSure.js.map +1 -1
  172. package/dist/esm/answer-account/templates.d.ts +4 -1
  173. package/dist/esm/answer-account/templates.js +4 -1
  174. package/dist/esm/answer-account/templates.js.map +1 -1
  175. package/dist/esm/answer-validation/agentChecks.d.ts +75 -0
  176. package/dist/esm/answer-validation/agentChecks.js +125 -0
  177. package/dist/esm/answer-validation/agentChecks.js.map +1 -0
  178. package/dist/esm/answer-validation/index.d.ts +2 -1
  179. package/dist/esm/answer-validation/index.js +1 -0
  180. package/dist/esm/answer-validation/index.js.map +1 -1
  181. package/dist/esm/answer-validation/outputSchema.d.ts +18 -7
  182. package/dist/esm/answer-validation/outputSchema.js +8 -1
  183. package/dist/esm/answer-validation/outputSchema.js.map +1 -1
  184. package/dist/esm/answer-validation/types.d.ts +125 -1
  185. package/dist/esm/answer-validation/types.js +9 -2
  186. package/dist/esm/answer-validation/types.js.map +1 -1
  187. package/dist/esm/answer-validation/validate.d.ts +11 -2
  188. package/dist/esm/answer-validation/validate.js +82 -3
  189. package/dist/esm/answer-validation/validate.js.map +1 -1
  190. package/dist/esm/core/Agent.d.ts +25 -1
  191. package/dist/esm/core/Agent.js +202 -47
  192. package/dist/esm/core/Agent.js.map +1 -1
  193. package/dist/esm/core/RunnerBase.js +4 -0
  194. package/dist/esm/core/RunnerBase.js.map +1 -1
  195. package/dist/esm/core/agent/AgentBuilder.d.ts +43 -12
  196. package/dist/esm/core/agent/AgentBuilder.js +135 -29
  197. package/dist/esm/core/agent/AgentBuilder.js.map +1 -1
  198. package/dist/esm/core/agent/arguments/checks.d.ts +1 -1
  199. package/dist/esm/core/agent/arguments/checks.js +1 -1
  200. package/dist/esm/core/agent/arguments/subflow.d.ts +6 -0
  201. package/dist/esm/core/agent/arguments/subflow.js +1 -0
  202. package/dist/esm/core/agent/arguments/subflow.js.map +1 -1
  203. package/dist/esm/core/agent/assessment/assess.js +31 -0
  204. package/dist/esm/core/agent/assessment/assess.js.map +1 -1
  205. package/dist/esm/core/agent/assessment/compose.js +3 -0
  206. package/dist/esm/core/agent/assessment/compose.js.map +1 -1
  207. package/dist/esm/core/agent/assessment/reasons.js +19 -1
  208. package/dist/esm/core/agent/assessment/reasons.js.map +1 -1
  209. package/dist/esm/core/agent/assessment/types.d.ts +3 -2
  210. package/dist/esm/core/agent/buildAgentChart.d.ts +4 -12
  211. package/dist/esm/core/agent/buildAgentChart.js +7 -17
  212. package/dist/esm/core/agent/buildAgentChart.js.map +1 -1
  213. package/dist/esm/core/agent/buildDynamicAgentChart.js +18 -15
  214. package/dist/esm/core/agent/buildDynamicAgentChart.js.map +1 -1
  215. package/dist/esm/core/agent/buildToolRegistry.js +13 -0
  216. package/dist/esm/core/agent/buildToolRegistry.js.map +1 -1
  217. package/dist/esm/core/agent/composeRequest.d.ts +19 -0
  218. package/dist/esm/core/agent/composeRequest.js +17 -0
  219. package/dist/esm/core/agent/composeRequest.js.map +1 -1
  220. package/dist/esm/core/agent/evidence/answerCarriers.js +1 -1
  221. package/dist/esm/core/agent/evidence/answerCarriers.js.map +1 -1
  222. package/dist/esm/core/agent/evidence/evidenceIndex.js +1 -1
  223. package/dist/esm/core/agent/evidence/evidenceIndex.js.map +1 -1
  224. package/dist/esm/core/agent/evidence/extract.d.ts +45 -6
  225. package/dist/esm/core/agent/evidence/extract.js +136 -30
  226. package/dist/esm/core/agent/evidence/extract.js.map +1 -1
  227. package/dist/esm/core/agent/evidence/figures.js +1 -1
  228. package/dist/esm/core/agent/evidence/figures.js.map +1 -1
  229. package/dist/esm/core/agent/evidence/frames.js +4 -2
  230. package/dist/esm/core/agent/evidence/frames.js.map +1 -1
  231. package/dist/esm/core/agent/evidence/gate.d.ts +6 -0
  232. package/dist/esm/core/agent/evidence/gate.js +11 -3
  233. package/dist/esm/core/agent/evidence/gate.js.map +1 -1
  234. package/dist/esm/core/agent/evidence/numericRanges.js +1 -1
  235. package/dist/esm/core/agent/evidence/numericRanges.js.map +1 -1
  236. package/dist/esm/core/agent/evidence/recovery.d.ts +2 -0
  237. package/dist/esm/core/agent/evidence/recovery.js +3 -1
  238. package/dist/esm/core/agent/evidence/recovery.js.map +1 -1
  239. package/dist/esm/core/agent/evidence/resultCarries.d.ts +2 -2
  240. package/dist/esm/core/agent/evidence/resultCarries.js +3 -3
  241. package/dist/esm/core/agent/evidence/resultCarries.js.map +1 -1
  242. package/dist/esm/core/agent/evidence/types.d.ts +17 -0
  243. package/dist/esm/core/agent/findings/context.d.ts +13 -0
  244. package/dist/esm/core/agent/findings/context.js +158 -0
  245. package/dist/esm/core/agent/findings/context.js.map +1 -0
  246. package/dist/esm/core/agent/findings/contingent.js +1 -1
  247. package/dist/esm/core/agent/findings/contingent.js.map +1 -1
  248. package/dist/esm/core/agent/findings/instruction.d.ts +12 -0
  249. package/dist/esm/core/agent/findings/instruction.js +22 -0
  250. package/dist/esm/core/agent/findings/instruction.js.map +1 -0
  251. package/dist/esm/core/agent/findings/ledger.d.ts +3 -0
  252. package/dist/esm/core/agent/findings/ledger.js +49 -0
  253. package/dist/esm/core/agent/findings/ledger.js.map +1 -1
  254. package/dist/esm/core/agent/findings/negativeProse.d.ts +1 -0
  255. package/dist/esm/core/agent/findings/negativeProse.js +49 -0
  256. package/dist/esm/core/agent/findings/negativeProse.js.map +1 -0
  257. package/dist/esm/core/agent/findings/offer.d.ts +9 -57
  258. package/dist/esm/core/agent/findings/offer.js +9 -57
  259. package/dist/esm/core/agent/findings/offer.js.map +1 -1
  260. package/dist/esm/core/agent/findings/reserved.d.ts +7 -31
  261. package/dist/esm/core/agent/findings/reserved.js +12 -83
  262. package/dist/esm/core/agent/findings/reserved.js.map +1 -1
  263. package/dist/esm/core/agent/findings/types.d.ts +11 -4
  264. package/dist/esm/core/agent/findings/types.js +3 -2
  265. package/dist/esm/core/agent/findings/types.js.map +1 -1
  266. package/dist/esm/core/agent/honesty/mounts.d.ts +7 -0
  267. package/dist/esm/core/agent/honesty/mounts.js +6 -0
  268. package/dist/esm/core/agent/honesty/mounts.js.map +1 -1
  269. package/dist/esm/core/agent/nativeOutputFormat.d.ts +2 -1
  270. package/dist/esm/core/agent/nativeOutputFormat.js +19 -1
  271. package/dist/esm/core/agent/nativeOutputFormat.js.map +1 -1
  272. package/dist/esm/core/agent/negativeClaims/capture.d.ts +65 -0
  273. package/dist/esm/core/agent/negativeClaims/capture.js +508 -0
  274. package/dist/esm/core/agent/negativeClaims/capture.js.map +1 -0
  275. package/dist/esm/core/agent/negativeClaims/checkpoint.d.ts +7 -0
  276. package/dist/esm/core/agent/negativeClaims/checkpoint.js +79 -0
  277. package/dist/esm/core/agent/negativeClaims/checkpoint.js.map +1 -0
  278. package/dist/esm/core/agent/negativeClaims/config.d.ts +66 -0
  279. package/dist/esm/core/agent/negativeClaims/config.js +185 -0
  280. package/dist/esm/core/agent/negativeClaims/config.js.map +1 -0
  281. package/dist/esm/core/agent/negativeClaims/delivery.d.ts +24 -0
  282. package/dist/esm/core/agent/negativeClaims/delivery.js +244 -0
  283. package/dist/esm/core/agent/negativeClaims/delivery.js.map +1 -0
  284. package/dist/esm/core/agent/negativeClaims/observe.d.ts +14 -0
  285. package/dist/esm/core/agent/negativeClaims/observe.js +34 -0
  286. package/dist/esm/core/agent/negativeClaims/observe.js.map +1 -0
  287. package/dist/esm/core/agent/negativeClaims/prose.d.ts +9 -0
  288. package/dist/esm/core/agent/negativeClaims/prose.js +112 -0
  289. package/dist/esm/core/agent/negativeClaims/prose.js.map +1 -0
  290. package/dist/esm/core/agent/negativeClaims/recheck.d.ts +7 -0
  291. package/dist/esm/core/agent/negativeClaims/recheck.js +32 -0
  292. package/dist/esm/core/agent/negativeClaims/recheck.js.map +1 -0
  293. package/dist/esm/core/agent/outputEnforcement.d.ts +5 -1
  294. package/dist/esm/core/agent/outputEnforcement.js.map +1 -1
  295. package/dist/esm/core/agent/receipt/receipt.d.ts +2 -2
  296. package/dist/esm/core/agent/stages/answerEvidence.d.ts +28 -0
  297. package/dist/esm/core/agent/stages/answerEvidence.js +16 -0
  298. package/dist/esm/core/agent/stages/answerEvidence.js.map +1 -0
  299. package/dist/esm/core/agent/stages/answerValidation.d.ts +15 -3
  300. package/dist/esm/core/agent/stages/answerValidation.js +113 -5
  301. package/dist/esm/core/agent/stages/answerValidation.js.map +1 -1
  302. package/dist/esm/core/agent/stages/callLLM.d.ts +11 -2
  303. package/dist/esm/core/agent/stages/callLLM.js +85 -44
  304. package/dist/esm/core/agent/stages/callLLM.js.map +1 -1
  305. package/dist/esm/core/agent/stages/evidenceRecheck.d.ts +6 -1
  306. package/dist/esm/core/agent/stages/evidenceRecheck.js +16 -2
  307. package/dist/esm/core/agent/stages/evidenceRecheck.js.map +1 -1
  308. package/dist/esm/core/agent/stages/outputRetry.js +23 -7
  309. package/dist/esm/core/agent/stages/outputRetry.js.map +1 -1
  310. package/dist/esm/core/agent/stages/prepareFinal.js +6 -1
  311. package/dist/esm/core/agent/stages/prepareFinal.js.map +1 -1
  312. package/dist/esm/core/agent/stages/reliabilityExecution.d.ts +3 -0
  313. package/dist/esm/core/agent/stages/reliabilityExecution.js +3 -0
  314. package/dist/esm/core/agent/stages/reliabilityExecution.js.map +1 -1
  315. package/dist/esm/core/agent/stages/route.d.ts +8 -2
  316. package/dist/esm/core/agent/stages/route.js +81 -33
  317. package/dist/esm/core/agent/stages/route.js.map +1 -1
  318. package/dist/esm/core/agent/stages/searchCoverage.d.ts +94 -0
  319. package/dist/esm/core/agent/stages/searchCoverage.js +117 -0
  320. package/dist/esm/core/agent/stages/searchCoverage.js.map +1 -0
  321. package/dist/esm/core/agent/stages/seed.d.ts +10 -0
  322. package/dist/esm/core/agent/stages/seed.js +19 -21
  323. package/dist/esm/core/agent/stages/seed.js.map +1 -1
  324. package/dist/esm/core/agent/stages/toolCalls.d.ts +16 -0
  325. package/dist/esm/core/agent/stages/toolCalls.js +700 -77
  326. package/dist/esm/core/agent/stages/toolCalls.js.map +1 -1
  327. package/dist/esm/core/agent/toolChoice/compose.d.ts +2 -0
  328. package/dist/esm/core/agent/toolChoice/compose.js +1 -0
  329. package/dist/esm/core/agent/toolChoice/compose.js.map +1 -1
  330. package/dist/esm/core/agent/toolChoice/pick.d.ts +2 -0
  331. package/dist/esm/core/agent/toolChoice/pick.js +2 -0
  332. package/dist/esm/core/agent/toolChoice/pick.js.map +1 -1
  333. package/dist/esm/core/agent/toolChoice/types.d.ts +1 -1
  334. package/dist/esm/core/agent/types.d.ts +86 -5
  335. package/dist/esm/core/checkin.d.ts +83 -7
  336. package/dist/esm/core/checkin.js +77 -15
  337. package/dist/esm/core/checkin.js.map +1 -1
  338. package/dist/esm/core/consentRequest.d.ts +488 -0
  339. package/dist/esm/core/consentRequest.js +817 -0
  340. package/dist/esm/core/consentRequest.js.map +1 -0
  341. package/dist/esm/core/pause.d.ts +88 -7
  342. package/dist/esm/core/pause.js +102 -5
  343. package/dist/esm/core/pause.js.map +1 -1
  344. package/dist/esm/core/runCheckpoint.d.ts +5 -1
  345. package/dist/esm/core/runCheckpoint.js +8 -1
  346. package/dist/esm/core/runCheckpoint.js.map +1 -1
  347. package/dist/esm/core/slots/buildToolsSlot.d.ts +4 -11
  348. package/dist/esm/core/slots/buildToolsSlot.js +4 -24
  349. package/dist/esm/core/slots/buildToolsSlot.js.map +1 -1
  350. package/dist/esm/debug.d.ts +1 -1
  351. package/dist/esm/debug.js +2 -0
  352. package/dist/esm/debug.js.map +1 -1
  353. package/dist/esm/events/payloads.d.ts +145 -3
  354. package/dist/esm/events/registry.d.ts +3 -1
  355. package/dist/esm/events/registry.js +2 -0
  356. package/dist/esm/events/registry.js.map +1 -1
  357. package/dist/esm/hosting/answeredPause.d.ts +301 -0
  358. package/dist/esm/hosting/answeredPause.js +522 -0
  359. package/dist/esm/hosting/answeredPause.js.map +1 -0
  360. package/dist/esm/hosting/conformance/cases.js +81 -1
  361. package/dist/esm/hosting/conformance/cases.js.map +1 -1
  362. package/dist/esm/hosting/conformance/types.d.ts +1 -1
  363. package/dist/esm/hosting/envelope.d.ts +6 -0
  364. package/dist/esm/hosting/envelope.js +14 -0
  365. package/dist/esm/hosting/envelope.js.map +1 -1
  366. package/dist/esm/hosting/errors.d.ts +14 -2
  367. package/dist/esm/hosting/errors.js +13 -6
  368. package/dist/esm/hosting/errors.js.map +1 -1
  369. package/dist/esm/hosting/index.d.ts +2 -1
  370. package/dist/esm/hosting/index.js +3 -0
  371. package/dist/esm/hosting/index.js.map +1 -1
  372. package/dist/esm/hosting/memorySessions.js +10 -2
  373. package/dist/esm/hosting/memorySessions.js.map +1 -1
  374. package/dist/esm/hosting/processLocalStore.d.ts +20 -0
  375. package/dist/esm/hosting/processLocalStore.js +26 -0
  376. package/dist/esm/hosting/processLocalStore.js.map +1 -0
  377. package/dist/esm/hosting/protocolAdapter.d.ts +13 -0
  378. package/dist/esm/hosting/refusalStatus.d.ts +6 -0
  379. package/dist/esm/hosting/refusalStatus.js +13 -0
  380. package/dist/esm/hosting/refusalStatus.js.map +1 -1
  381. package/dist/esm/hosting/sessionWire.d.ts +8 -3
  382. package/dist/esm/hosting/sessionWire.js.map +1 -1
  383. package/dist/esm/hosting/sqliteSessions.js +27 -3
  384. package/dist/esm/hosting/sqliteSessions.js.map +1 -1
  385. package/dist/esm/hosting/standingAgent.js +70 -26
  386. package/dist/esm/hosting/standingAgent.js.map +1 -1
  387. package/dist/esm/hosting/streamHandler.d.ts +3 -1
  388. package/dist/esm/hosting/streamHandler.js +150 -32
  389. package/dist/esm/hosting/streamHandler.js.map +1 -1
  390. package/dist/esm/hosting/types.d.ts +28 -6
  391. package/dist/esm/hosting/types.js.map +1 -1
  392. package/dist/esm/index.d.ts +7 -3
  393. package/dist/esm/index.js +21 -17
  394. package/dist/esm/index.js.map +1 -1
  395. package/dist/esm/integrity/negative-claim/anchor.d.ts +9 -0
  396. package/dist/esm/integrity/negative-claim/anchor.js +120 -0
  397. package/dist/esm/integrity/negative-claim/anchor.js.map +1 -0
  398. package/dist/esm/integrity/negative-claim/citation.d.ts +34 -0
  399. package/dist/esm/integrity/negative-claim/citation.js +367 -0
  400. package/dist/esm/integrity/negative-claim/citation.js.map +1 -0
  401. package/dist/esm/integrity/negative-claim/containment.d.ts +40 -0
  402. package/dist/esm/integrity/negative-claim/containment.js +257 -0
  403. package/dist/esm/integrity/negative-claim/containment.js.map +1 -0
  404. package/dist/esm/integrity/negative-claim/derive.d.ts +17 -0
  405. package/dist/esm/integrity/negative-claim/derive.js +122 -0
  406. package/dist/esm/integrity/negative-claim/derive.js.map +1 -0
  407. package/dist/esm/integrity/negative-claim/detect.d.ts +44 -0
  408. package/dist/esm/integrity/negative-claim/detect.js +65 -0
  409. package/dist/esm/integrity/negative-claim/detect.js.map +1 -0
  410. package/dist/esm/integrity/negative-claim/judge.d.ts +41 -0
  411. package/dist/esm/integrity/negative-claim/judge.js +95 -0
  412. package/dist/esm/integrity/negative-claim/judge.js.map +1 -0
  413. package/dist/esm/integrity/negative-claim/language.d.ts +14 -0
  414. package/dist/esm/integrity/negative-claim/language.js +42 -0
  415. package/dist/esm/integrity/negative-claim/language.js.map +1 -0
  416. package/dist/esm/integrity/negative-claim/limits.d.ts +2 -0
  417. package/dist/esm/integrity/negative-claim/limits.js +3 -0
  418. package/dist/esm/integrity/negative-claim/limits.js.map +1 -0
  419. package/dist/esm/integrity/negative-claim/matcher.d.ts +51 -0
  420. package/dist/esm/integrity/negative-claim/matcher.js +164 -0
  421. package/dist/esm/integrity/negative-claim/matcher.js.map +1 -0
  422. package/dist/esm/integrity/negative-claim/noRead.d.ts +8 -0
  423. package/dist/esm/integrity/negative-claim/noRead.js +9 -0
  424. package/dist/esm/integrity/negative-claim/noRead.js.map +1 -0
  425. package/dist/esm/integrity/negative-claim/phrases.d.ts +69 -0
  426. package/dist/esm/integrity/negative-claim/phrases.js +249 -0
  427. package/dist/esm/integrity/negative-claim/phrases.js.map +1 -0
  428. package/dist/esm/integrity/negative-claim/prose.d.ts +36 -0
  429. package/dist/esm/integrity/negative-claim/prose.js +143 -0
  430. package/dist/esm/integrity/negative-claim/prose.js.map +1 -0
  431. package/dist/esm/integrity/negative-claim/readings.d.ts +81 -0
  432. package/dist/esm/integrity/negative-claim/readings.js +322 -0
  433. package/dist/esm/integrity/negative-claim/readings.js.map +1 -0
  434. package/dist/esm/integrity/negative-claim/resolve.d.ts +37 -0
  435. package/dist/esm/integrity/negative-claim/resolve.js +179 -0
  436. package/dist/esm/integrity/negative-claim/resolve.js.map +1 -0
  437. package/dist/esm/integrity/negative-claim/statement.d.ts +75 -0
  438. package/dist/esm/integrity/negative-claim/statement.js +361 -0
  439. package/dist/esm/integrity/negative-claim/statement.js.map +1 -0
  440. package/dist/esm/integrity/negative-claim/types.d.ts +144 -0
  441. package/dist/esm/integrity/negative-claim/types.js +39 -0
  442. package/dist/esm/integrity/negative-claim/types.js.map +1 -0
  443. package/dist/esm/integrity/negative-claim/units.d.ts +33 -0
  444. package/dist/esm/integrity/negative-claim/units.js +185 -0
  445. package/dist/esm/integrity/negative-claim/units.js.map +1 -0
  446. package/dist/esm/integrity/negative-claim/work.d.ts +12 -0
  447. package/dist/esm/integrity/negative-claim/work.js +19 -0
  448. package/dist/esm/integrity/negative-claim/work.js.map +1 -0
  449. package/dist/esm/integrity/unsupported-claim/check.d.ts +33 -0
  450. package/dist/esm/integrity/unsupported-claim/check.js +48 -26
  451. package/dist/esm/integrity/unsupported-claim/check.js.map +1 -1
  452. package/dist/esm/integrity/unsupported-claim/delivered.d.ts +72 -0
  453. package/dist/esm/integrity/unsupported-claim/delivered.js +98 -0
  454. package/dist/esm/integrity/unsupported-claim/delivered.js.map +1 -0
  455. package/dist/esm/integrity/unsupported-claim/evaluate.d.ts +103 -1
  456. package/dist/esm/integrity/unsupported-claim/evaluate.js +373 -0
  457. package/dist/esm/integrity/unsupported-claim/evaluate.js.map +1 -1
  458. package/dist/esm/lib/conventions.d.ts +1 -0
  459. package/dist/esm/lib/conventions.js +3 -0
  460. package/dist/esm/lib/conventions.js.map +1 -1
  461. package/dist/esm/lib/frozenCopy.d.ts +75 -0
  462. package/dist/esm/lib/frozenCopy.js +198 -0
  463. package/dist/esm/lib/frozenCopy.js.map +1 -0
  464. package/dist/esm/lib/jsonFaithful.d.ts +34 -0
  465. package/dist/esm/lib/jsonFaithful.js +111 -0
  466. package/dist/esm/lib/jsonFaithful.js.map +1 -0
  467. package/dist/esm/lib/normalize.d.ts +96 -0
  468. package/dist/esm/{tools → lib}/normalize.js +142 -6
  469. package/dist/esm/lib/normalize.js.map +1 -0
  470. package/dist/esm/lib/saidByPerson.d.ts +2 -0
  471. package/dist/esm/lib/saidByPerson.js +3 -0
  472. package/dist/esm/lib/saidByPerson.js.map +1 -1
  473. package/dist/esm/mcp/toolExtras.d.ts +10 -0
  474. package/dist/esm/mcp/toolExtras.js +11 -0
  475. package/dist/esm/mcp/toolExtras.js.map +1 -1
  476. package/dist/esm/provider-contract/nativeOutputSchema.d.ts +6 -2
  477. package/dist/esm/provider-contract/nativeOutputSchema.js +9 -2
  478. package/dist/esm/provider-contract/nativeOutputSchema.js.map +1 -1
  479. package/dist/esm/provider-contract/types.d.ts +12 -1
  480. package/dist/esm/provider-contract/types.js.map +1 -1
  481. package/dist/esm/recorders/core/CheckInRecorder.d.ts +6 -1
  482. package/dist/esm/recorders/core/CheckInRecorder.js +5 -1
  483. package/dist/esm/recorders/core/CheckInRecorder.js.map +1 -1
  484. package/dist/esm/redaction/conversation.js +6 -0
  485. package/dist/esm/redaction/conversation.js.map +1 -1
  486. package/dist/esm/redaction/knownStrings.d.ts +9 -7
  487. package/dist/esm/redaction/knownStrings.js +74 -0
  488. package/dist/esm/redaction/knownStrings.js.map +1 -1
  489. package/dist/esm/resilience/withCircuitBreaker.js +3 -0
  490. package/dist/esm/resilience/withCircuitBreaker.js.map +1 -1
  491. package/dist/esm/resilience/withFallback.js +8 -1
  492. package/dist/esm/resilience/withFallback.js.map +1 -1
  493. package/dist/esm/resilience/withRetry.js +3 -0
  494. package/dist/esm/resilience/withRetry.js.map +1 -1
  495. package/dist/esm/semantics/check.d.ts +44 -2
  496. package/dist/esm/semantics/check.js +112 -3
  497. package/dist/esm/semantics/check.js.map +1 -1
  498. package/dist/esm/semantics/cli.js +33 -3
  499. package/dist/esm/semantics/cli.js.map +1 -1
  500. package/dist/esm/semantics/coverage/absent.d.ts +19 -2
  501. package/dist/esm/semantics/coverage/absent.js +56 -52
  502. package/dist/esm/semantics/coverage/absent.js.map +1 -1
  503. package/dist/esm/semantics/coverage/among.d.ts +73 -0
  504. package/dist/esm/semantics/coverage/among.js +172 -0
  505. package/dist/esm/semantics/coverage/among.js.map +1 -0
  506. package/dist/esm/semantics/coverage/composedCoverage.d.ts +220 -0
  507. package/dist/esm/semantics/coverage/composedCoverage.js +42 -0
  508. package/dist/esm/semantics/coverage/composedCoverage.js.map +1 -0
  509. package/dist/esm/semantics/coverage/evidence.js +27 -2
  510. package/dist/esm/semantics/coverage/evidence.js.map +1 -1
  511. package/dist/esm/semantics/coverage/index.d.ts +4 -1
  512. package/dist/esm/semantics/coverage/index.js +2 -0
  513. package/dist/esm/semantics/coverage/index.js.map +1 -1
  514. package/dist/esm/semantics/coverage/ledger.d.ts +2 -1
  515. package/dist/esm/semantics/coverage/ledger.js +15 -53
  516. package/dist/esm/semantics/coverage/ledger.js.map +1 -1
  517. package/dist/esm/semantics/coverage/read.d.ts +19 -0
  518. package/dist/esm/semantics/coverage/read.js.map +1 -1
  519. package/dist/esm/semantics/coverage/recognize.d.ts +17 -1
  520. package/dist/esm/semantics/coverage/recognize.js +40 -0
  521. package/dist/esm/semantics/coverage/recognize.js.map +1 -1
  522. package/dist/esm/semantics/coverage/search/binding.d.ts +27 -0
  523. package/dist/esm/semantics/coverage/search/binding.js +42 -0
  524. package/dist/esm/semantics/coverage/search/binding.js.map +1 -0
  525. package/dist/esm/semantics/coverage/search/compose.d.ts +90 -0
  526. package/dist/esm/semantics/coverage/search/compose.js +120 -0
  527. package/dist/esm/semantics/coverage/search/compose.js.map +1 -0
  528. package/dist/esm/semantics/coverage/search/declaration.d.ts +75 -0
  529. package/dist/esm/semantics/coverage/search/declaration.js +453 -0
  530. package/dist/esm/semantics/coverage/search/declaration.js.map +1 -0
  531. package/dist/esm/semantics/coverage/search/door.d.ts +46 -0
  532. package/dist/esm/semantics/coverage/search/door.js +130 -0
  533. package/dist/esm/semantics/coverage/search/door.js.map +1 -0
  534. package/dist/esm/semantics/coverage/search/events.d.ts +42 -0
  535. package/dist/esm/semantics/coverage/search/events.js +100 -0
  536. package/dist/esm/semantics/coverage/search/events.js.map +1 -0
  537. package/dist/esm/semantics/coverage/search/facets.d.ts +52 -0
  538. package/dist/esm/semantics/coverage/search/facets.js +191 -0
  539. package/dist/esm/semantics/coverage/search/facets.js.map +1 -0
  540. package/dist/esm/semantics/coverage/search/gaps.d.ts +63 -0
  541. package/dist/esm/semantics/coverage/search/gaps.js +221 -0
  542. package/dist/esm/semantics/coverage/search/gaps.js.map +1 -0
  543. package/dist/esm/semantics/coverage/search/inEffect.d.ts +65 -0
  544. package/dist/esm/semantics/coverage/search/inEffect.js +48 -0
  545. package/dist/esm/semantics/coverage/search/inEffect.js.map +1 -0
  546. package/dist/esm/semantics/coverage/search/resultFacts.d.ts +42 -0
  547. package/dist/esm/semantics/coverage/search/resultFacts.js +100 -0
  548. package/dist/esm/semantics/coverage/search/resultFacts.js.map +1 -0
  549. package/dist/esm/semantics/coverage/search/review.d.ts +36 -0
  550. package/dist/esm/semantics/coverage/search/review.js +89 -0
  551. package/dist/esm/semantics/coverage/search/review.js.map +1 -0
  552. package/dist/esm/semantics/coverage/search/served.d.ts +51 -0
  553. package/dist/esm/semantics/coverage/search/served.js +130 -0
  554. package/dist/esm/semantics/coverage/search/served.js.map +1 -0
  555. package/dist/esm/semantics/coverage/search/span.d.ts +34 -0
  556. package/dist/esm/semantics/coverage/search/span.js +61 -0
  557. package/dist/esm/semantics/coverage/search/span.js.map +1 -0
  558. package/dist/esm/semantics/coverage/search/statementText.d.ts +46 -0
  559. package/dist/esm/semantics/coverage/search/statementText.js +102 -0
  560. package/dist/esm/semantics/coverage/search/statementText.js.map +1 -0
  561. package/dist/esm/semantics/coverage/search/types.d.ts +120 -0
  562. package/dist/esm/semantics/coverage/search/types.js +11 -0
  563. package/dist/esm/semantics/coverage/search/types.js.map +1 -0
  564. package/dist/esm/semantics/coverage/search/valueWords.d.ts +22 -0
  565. package/dist/esm/semantics/coverage/search/valueWords.js +32 -0
  566. package/dist/esm/semantics/coverage/search/valueWords.js.map +1 -0
  567. package/dist/esm/semantics/coverage/types.d.ts +163 -0
  568. package/dist/esm/semantics/described.js +3 -1
  569. package/dist/esm/semantics/described.js.map +1 -1
  570. package/dist/esm/semantics/envelope.js +26 -2
  571. package/dist/esm/semantics/envelope.js.map +1 -1
  572. package/dist/esm/semantics/index.d.ts +2 -1
  573. package/dist/esm/semantics/index.js.map +1 -1
  574. package/dist/esm/semantics/overclaim.d.ts +105 -0
  575. package/dist/esm/semantics/overclaim.js +397 -0
  576. package/dist/esm/semantics/overclaim.js.map +1 -0
  577. package/dist/esm/semantics/types.d.ts +13 -0
  578. package/dist/esm/semantics/types.js.map +1 -1
  579. package/dist/esm/time/forms.js +1 -1
  580. package/dist/esm/time/textForms.js +1 -1
  581. package/dist/esm/time-travel/servedView.d.ts +2 -2
  582. package/dist/esm/time-travel/servedView.js +52 -160
  583. package/dist/esm/time-travel/servedView.js.map +1 -1
  584. package/dist/esm/tools/declare.d.ts +1 -1
  585. package/dist/esm/tools/declare.js +2 -2
  586. package/dist/esm/tools/declare.js.map +1 -1
  587. package/dist/esm/tools/hostFilled.d.ts +20 -1
  588. package/dist/esm/tools/hostFilled.js +46 -1
  589. package/dist/esm/tools/hostFilled.js.map +1 -1
  590. package/dist/esm/tools/searchOf.d.ts +60 -0
  591. package/dist/esm/tools/searchOf.js +97 -0
  592. package/dist/esm/tools/searchOf.js.map +1 -0
  593. package/dist/esm/tools/tools.d.ts +49 -0
  594. package/dist/esm/tools/tools.js +76 -1
  595. package/dist/esm/tools/tools.js.map +1 -1
  596. package/dist/esm/trace-toolpack/causeCapture.d.ts +17 -0
  597. package/dist/esm/trace-toolpack/causeCapture.js +96 -0
  598. package/dist/esm/trace-toolpack/causeCapture.js.map +1 -0
  599. package/dist/esm/trace-toolpack/causeControl.d.ts +6 -0
  600. package/dist/esm/trace-toolpack/causeControl.js +45 -0
  601. package/dist/esm/trace-toolpack/causeControl.js.map +1 -0
  602. package/dist/esm/trace-toolpack/causeReader.js +11 -9
  603. package/dist/esm/trace-toolpack/causeReader.js.map +1 -1
  604. package/dist/esm/trace-toolpack/causeResponse.d.ts +3 -2
  605. package/dist/esm/trace-toolpack/causeResponse.js +27 -7
  606. package/dist/esm/trace-toolpack/causeResponse.js.map +1 -1
  607. package/dist/esm/trace-toolpack/causeSnapshot.d.ts +6 -1
  608. package/dist/esm/trace-toolpack/causeSnapshot.js +26 -15
  609. package/dist/esm/trace-toolpack/causeSnapshot.js.map +1 -1
  610. package/dist/esm/trace-toolpack/causeTools.js +1 -1
  611. package/dist/esm/trace-toolpack/causeTools.js.map +1 -1
  612. package/dist/events/registry.js +2 -0
  613. package/dist/events/registry.js.map +1 -1
  614. package/dist/hosting/answeredPause.js +536 -0
  615. package/dist/hosting/answeredPause.js.map +1 -0
  616. package/dist/hosting/conformance/cases.js +80 -0
  617. package/dist/hosting/conformance/cases.js.map +1 -1
  618. package/dist/hosting/envelope.js +14 -0
  619. package/dist/hosting/envelope.js.map +1 -1
  620. package/dist/hosting/errors.js +13 -6
  621. package/dist/hosting/errors.js.map +1 -1
  622. package/dist/hosting/index.js +7 -3
  623. package/dist/hosting/index.js.map +1 -1
  624. package/dist/hosting/memorySessions.js +10 -2
  625. package/dist/hosting/memorySessions.js.map +1 -1
  626. package/dist/hosting/processLocalStore.js +31 -0
  627. package/dist/hosting/processLocalStore.js.map +1 -0
  628. package/dist/hosting/refusalStatus.js +13 -0
  629. package/dist/hosting/refusalStatus.js.map +1 -1
  630. package/dist/hosting/sessionWire.js.map +1 -1
  631. package/dist/hosting/sqliteSessions.js +27 -3
  632. package/dist/hosting/sqliteSessions.js.map +1 -1
  633. package/dist/hosting/standingAgent.js +69 -25
  634. package/dist/hosting/standingAgent.js.map +1 -1
  635. package/dist/hosting/streamHandler.js +149 -31
  636. package/dist/hosting/streamHandler.js.map +1 -1
  637. package/dist/hosting/types.js.map +1 -1
  638. package/dist/index.js +26 -21
  639. package/dist/index.js.map +1 -1
  640. package/dist/integrity/negative-claim/anchor.js +124 -0
  641. package/dist/integrity/negative-claim/anchor.js.map +1 -0
  642. package/dist/integrity/negative-claim/citation.js +371 -0
  643. package/dist/integrity/negative-claim/citation.js.map +1 -0
  644. package/dist/integrity/negative-claim/containment.js +262 -0
  645. package/dist/integrity/negative-claim/containment.js.map +1 -0
  646. package/dist/integrity/negative-claim/derive.js +130 -0
  647. package/dist/integrity/negative-claim/derive.js.map +1 -0
  648. package/dist/integrity/negative-claim/detect.js +69 -0
  649. package/dist/integrity/negative-claim/detect.js.map +1 -0
  650. package/dist/integrity/negative-claim/judge.js +100 -0
  651. package/dist/integrity/negative-claim/judge.js.map +1 -0
  652. package/dist/integrity/negative-claim/language.js +46 -0
  653. package/dist/integrity/negative-claim/language.js.map +1 -0
  654. package/dist/integrity/negative-claim/limits.js +6 -0
  655. package/dist/integrity/negative-claim/limits.js.map +1 -0
  656. package/dist/integrity/negative-claim/matcher.js +179 -0
  657. package/dist/integrity/negative-claim/matcher.js.map +1 -0
  658. package/dist/integrity/negative-claim/noRead.js +13 -0
  659. package/dist/integrity/negative-claim/noRead.js.map +1 -0
  660. package/dist/integrity/negative-claim/phrases.js +253 -0
  661. package/dist/integrity/negative-claim/phrases.js.map +1 -0
  662. package/dist/integrity/negative-claim/prose.js +147 -0
  663. package/dist/integrity/negative-claim/prose.js.map +1 -0
  664. package/dist/integrity/negative-claim/readings.js +338 -0
  665. package/dist/integrity/negative-claim/readings.js.map +1 -0
  666. package/dist/integrity/negative-claim/resolve.js +184 -0
  667. package/dist/integrity/negative-claim/resolve.js.map +1 -0
  668. package/dist/integrity/negative-claim/statement.js +369 -0
  669. package/dist/integrity/negative-claim/statement.js.map +1 -0
  670. package/dist/integrity/negative-claim/types.js +42 -0
  671. package/dist/integrity/negative-claim/types.js.map +1 -0
  672. package/dist/integrity/negative-claim/units.js +190 -0
  673. package/dist/integrity/negative-claim/units.js.map +1 -0
  674. package/dist/integrity/negative-claim/work.js +24 -0
  675. package/dist/integrity/negative-claim/work.js.map +1 -0
  676. package/dist/integrity/unsupported-claim/check.js +50 -27
  677. package/dist/integrity/unsupported-claim/check.js.map +1 -1
  678. package/dist/integrity/unsupported-claim/delivered.js +102 -0
  679. package/dist/integrity/unsupported-claim/delivered.js.map +1 -0
  680. package/dist/integrity/unsupported-claim/evaluate.js +377 -1
  681. package/dist/integrity/unsupported-claim/evaluate.js.map +1 -1
  682. package/dist/lib/conventions.js +3 -0
  683. package/dist/lib/conventions.js.map +1 -1
  684. package/dist/lib/frozenCopy.js +207 -0
  685. package/dist/lib/frozenCopy.js.map +1 -0
  686. package/dist/lib/jsonFaithful.js +115 -0
  687. package/dist/lib/jsonFaithful.js.map +1 -0
  688. package/dist/{tools → lib}/normalize.js +151 -7
  689. package/dist/lib/normalize.js.map +1 -0
  690. package/dist/lib/saidByPerson.js +4 -1
  691. package/dist/lib/saidByPerson.js.map +1 -1
  692. package/dist/mcp/toolExtras.js +11 -0
  693. package/dist/mcp/toolExtras.js.map +1 -1
  694. package/dist/provider-contract/nativeOutputSchema.js +11 -3
  695. package/dist/provider-contract/nativeOutputSchema.js.map +1 -1
  696. package/dist/provider-contract/types.js.map +1 -1
  697. package/dist/recorders/core/CheckInRecorder.js +5 -1
  698. package/dist/recorders/core/CheckInRecorder.js.map +1 -1
  699. package/dist/redaction/conversation.js +6 -0
  700. package/dist/redaction/conversation.js.map +1 -1
  701. package/dist/redaction/knownStrings.js +74 -0
  702. package/dist/redaction/knownStrings.js.map +1 -1
  703. package/dist/resilience/withCircuitBreaker.js +3 -0
  704. package/dist/resilience/withCircuitBreaker.js.map +1 -1
  705. package/dist/resilience/withFallback.js +7 -0
  706. package/dist/resilience/withFallback.js.map +1 -1
  707. package/dist/resilience/withRetry.js +3 -0
  708. package/dist/resilience/withRetry.js.map +1 -1
  709. package/dist/semantics/check.js +112 -3
  710. package/dist/semantics/check.js.map +1 -1
  711. package/dist/semantics/cli.js +32 -2
  712. package/dist/semantics/cli.js.map +1 -1
  713. package/dist/semantics/coverage/absent.js +56 -52
  714. package/dist/semantics/coverage/absent.js.map +1 -1
  715. package/dist/semantics/coverage/among.js +177 -0
  716. package/dist/semantics/coverage/among.js.map +1 -0
  717. package/dist/semantics/coverage/composedCoverage.js +46 -0
  718. package/dist/semantics/coverage/composedCoverage.js.map +1 -0
  719. package/dist/semantics/coverage/evidence.js +27 -2
  720. package/dist/semantics/coverage/evidence.js.map +1 -1
  721. package/dist/semantics/coverage/index.js +5 -1
  722. package/dist/semantics/coverage/index.js.map +1 -1
  723. package/dist/semantics/coverage/ledger.js +18 -56
  724. package/dist/semantics/coverage/ledger.js.map +1 -1
  725. package/dist/semantics/coverage/read.js.map +1 -1
  726. package/dist/semantics/coverage/recognize.js +43 -1
  727. package/dist/semantics/coverage/recognize.js.map +1 -1
  728. package/dist/semantics/coverage/search/binding.js +46 -0
  729. package/dist/semantics/coverage/search/binding.js.map +1 -0
  730. package/dist/semantics/coverage/search/compose.js +124 -0
  731. package/dist/semantics/coverage/search/compose.js.map +1 -0
  732. package/dist/semantics/coverage/search/declaration.js +462 -0
  733. package/dist/semantics/coverage/search/declaration.js.map +1 -0
  734. package/dist/semantics/coverage/search/door.js +134 -0
  735. package/dist/semantics/coverage/search/door.js.map +1 -0
  736. package/dist/semantics/coverage/search/events.js +104 -0
  737. package/dist/semantics/coverage/search/events.js.map +1 -0
  738. package/dist/semantics/coverage/search/facets.js +196 -0
  739. package/dist/semantics/coverage/search/facets.js.map +1 -0
  740. package/dist/semantics/coverage/search/gaps.js +226 -0
  741. package/dist/semantics/coverage/search/gaps.js.map +1 -0
  742. package/dist/semantics/coverage/search/inEffect.js +52 -0
  743. package/dist/semantics/coverage/search/inEffect.js.map +1 -0
  744. package/dist/semantics/coverage/search/resultFacts.js +109 -0
  745. package/dist/semantics/coverage/search/resultFacts.js.map +1 -0
  746. package/dist/semantics/coverage/search/review.js +93 -0
  747. package/dist/semantics/coverage/search/review.js.map +1 -0
  748. package/dist/semantics/coverage/search/served.js +137 -0
  749. package/dist/semantics/coverage/search/served.js.map +1 -0
  750. package/dist/semantics/coverage/search/span.js +66 -0
  751. package/dist/semantics/coverage/search/span.js.map +1 -0
  752. package/dist/semantics/coverage/search/statementText.js +107 -0
  753. package/dist/semantics/coverage/search/statementText.js.map +1 -0
  754. package/dist/semantics/coverage/search/types.js +12 -0
  755. package/dist/semantics/coverage/search/types.js.map +1 -0
  756. package/dist/semantics/coverage/search/valueWords.js +36 -0
  757. package/dist/semantics/coverage/search/valueWords.js.map +1 -0
  758. package/dist/semantics/described.js +3 -1
  759. package/dist/semantics/described.js.map +1 -1
  760. package/dist/semantics/envelope.js +26 -2
  761. package/dist/semantics/envelope.js.map +1 -1
  762. package/dist/semantics/index.js.map +1 -1
  763. package/dist/semantics/overclaim.js +407 -0
  764. package/dist/semantics/overclaim.js.map +1 -0
  765. package/dist/semantics/types.js.map +1 -1
  766. package/dist/time/forms.js +1 -1
  767. package/dist/time/textForms.js +1 -1
  768. package/dist/time-travel/servedView.js +51 -159
  769. package/dist/time-travel/servedView.js.map +1 -1
  770. package/dist/tools/declare.js +2 -2
  771. package/dist/tools/declare.js.map +1 -1
  772. package/dist/tools/hostFilled.js +48 -2
  773. package/dist/tools/hostFilled.js.map +1 -1
  774. package/dist/tools/searchOf.js +104 -0
  775. package/dist/tools/searchOf.js.map +1 -0
  776. package/dist/tools/tools.js +80 -2
  777. package/dist/tools/tools.js.map +1 -1
  778. package/dist/trace-toolpack/causeCapture.js +103 -0
  779. package/dist/trace-toolpack/causeCapture.js.map +1 -0
  780. package/dist/trace-toolpack/causeControl.js +49 -0
  781. package/dist/trace-toolpack/causeControl.js.map +1 -0
  782. package/dist/trace-toolpack/causeReader.js +11 -9
  783. package/dist/trace-toolpack/causeReader.js.map +1 -1
  784. package/dist/trace-toolpack/causeResponse.js +27 -7
  785. package/dist/trace-toolpack/causeResponse.js.map +1 -1
  786. package/dist/trace-toolpack/causeSnapshot.js +31 -20
  787. package/dist/trace-toolpack/causeSnapshot.js.map +1 -1
  788. package/dist/trace-toolpack/causeTools.js +1 -1
  789. package/dist/trace-toolpack/causeTools.js.map +1 -1
  790. package/dist/types/adapters/hosting/agentCoreA2A.d.ts.map +1 -1
  791. package/dist/types/adapters/hosting/firestoreSessions.d.ts.map +1 -1
  792. package/dist/types/adapters/hosting/googleAgentEngine.d.ts.map +1 -1
  793. package/dist/types/adapters/llm/AnthropicProvider.d.ts +1 -0
  794. package/dist/types/adapters/llm/AnthropicProvider.d.ts.map +1 -1
  795. package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts +1 -0
  796. package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts.map +1 -1
  797. package/dist/types/adapters/llm/MockProvider.d.ts +2 -0
  798. package/dist/types/adapters/llm/MockProvider.d.ts.map +1 -1
  799. package/dist/types/ag-ui/request.d.ts +4 -1
  800. package/dist/types/ag-ui/request.d.ts.map +1 -1
  801. package/dist/types/ag-ui/serializer.d.ts +15 -2
  802. package/dist/types/ag-ui/serializer.d.ts.map +1 -1
  803. package/dist/types/answer-account/facts/howSure.d.ts.map +1 -1
  804. package/dist/types/answer-account/templates.d.ts +4 -1
  805. package/dist/types/answer-account/templates.d.ts.map +1 -1
  806. package/dist/types/answer-validation/agentChecks.d.ts +76 -0
  807. package/dist/types/answer-validation/agentChecks.d.ts.map +1 -0
  808. package/dist/types/answer-validation/index.d.ts +2 -1
  809. package/dist/types/answer-validation/index.d.ts.map +1 -1
  810. package/dist/types/answer-validation/outputSchema.d.ts +18 -7
  811. package/dist/types/answer-validation/outputSchema.d.ts.map +1 -1
  812. package/dist/types/answer-validation/types.d.ts +125 -1
  813. package/dist/types/answer-validation/types.d.ts.map +1 -1
  814. package/dist/types/answer-validation/validate.d.ts +11 -2
  815. package/dist/types/answer-validation/validate.d.ts.map +1 -1
  816. package/dist/types/core/Agent.d.ts +25 -1
  817. package/dist/types/core/Agent.d.ts.map +1 -1
  818. package/dist/types/core/RunnerBase.d.ts.map +1 -1
  819. package/dist/types/core/agent/AgentBuilder.d.ts +43 -12
  820. package/dist/types/core/agent/AgentBuilder.d.ts.map +1 -1
  821. package/dist/types/core/agent/arguments/checks.d.ts +1 -1
  822. package/dist/types/core/agent/arguments/subflow.d.ts +6 -0
  823. package/dist/types/core/agent/arguments/subflow.d.ts.map +1 -1
  824. package/dist/types/core/agent/assessment/assess.d.ts.map +1 -1
  825. package/dist/types/core/agent/assessment/compose.d.ts.map +1 -1
  826. package/dist/types/core/agent/assessment/reasons.d.ts.map +1 -1
  827. package/dist/types/core/agent/assessment/types.d.ts +3 -2
  828. package/dist/types/core/agent/assessment/types.d.ts.map +1 -1
  829. package/dist/types/core/agent/buildAgentChart.d.ts +4 -12
  830. package/dist/types/core/agent/buildAgentChart.d.ts.map +1 -1
  831. package/dist/types/core/agent/buildDynamicAgentChart.d.ts.map +1 -1
  832. package/dist/types/core/agent/buildToolRegistry.d.ts.map +1 -1
  833. package/dist/types/core/agent/composeRequest.d.ts +19 -0
  834. package/dist/types/core/agent/composeRequest.d.ts.map +1 -1
  835. package/dist/types/core/agent/evidence/extract.d.ts +45 -6
  836. package/dist/types/core/agent/evidence/extract.d.ts.map +1 -1
  837. package/dist/types/core/agent/evidence/frames.d.ts.map +1 -1
  838. package/dist/types/core/agent/evidence/gate.d.ts +6 -0
  839. package/dist/types/core/agent/evidence/gate.d.ts.map +1 -1
  840. package/dist/types/core/agent/evidence/recovery.d.ts +2 -0
  841. package/dist/types/core/agent/evidence/recovery.d.ts.map +1 -1
  842. package/dist/types/core/agent/evidence/resultCarries.d.ts +2 -2
  843. package/dist/types/core/agent/evidence/types.d.ts +17 -0
  844. package/dist/types/core/agent/evidence/types.d.ts.map +1 -1
  845. package/dist/types/core/agent/findings/context.d.ts +14 -0
  846. package/dist/types/core/agent/findings/context.d.ts.map +1 -0
  847. package/dist/types/core/agent/findings/instruction.d.ts +13 -0
  848. package/dist/types/core/agent/findings/instruction.d.ts.map +1 -0
  849. package/dist/types/core/agent/findings/ledger.d.ts +3 -0
  850. package/dist/types/core/agent/findings/ledger.d.ts.map +1 -1
  851. package/dist/types/core/agent/findings/negativeProse.d.ts +2 -0
  852. package/dist/types/core/agent/findings/negativeProse.d.ts.map +1 -0
  853. package/dist/types/core/agent/findings/offer.d.ts +9 -57
  854. package/dist/types/core/agent/findings/offer.d.ts.map +1 -1
  855. package/dist/types/core/agent/findings/reserved.d.ts +7 -31
  856. package/dist/types/core/agent/findings/reserved.d.ts.map +1 -1
  857. package/dist/types/core/agent/findings/types.d.ts +11 -4
  858. package/dist/types/core/agent/findings/types.d.ts.map +1 -1
  859. package/dist/types/core/agent/honesty/mounts.d.ts +7 -0
  860. package/dist/types/core/agent/honesty/mounts.d.ts.map +1 -1
  861. package/dist/types/core/agent/nativeOutputFormat.d.ts +2 -1
  862. package/dist/types/core/agent/nativeOutputFormat.d.ts.map +1 -1
  863. package/dist/types/core/agent/negativeClaims/capture.d.ts +66 -0
  864. package/dist/types/core/agent/negativeClaims/capture.d.ts.map +1 -0
  865. package/dist/types/core/agent/negativeClaims/checkpoint.d.ts +8 -0
  866. package/dist/types/core/agent/negativeClaims/checkpoint.d.ts.map +1 -0
  867. package/dist/types/core/agent/negativeClaims/config.d.ts +67 -0
  868. package/dist/types/core/agent/negativeClaims/config.d.ts.map +1 -0
  869. package/dist/types/core/agent/negativeClaims/delivery.d.ts +25 -0
  870. package/dist/types/core/agent/negativeClaims/delivery.d.ts.map +1 -0
  871. package/dist/types/core/agent/negativeClaims/observe.d.ts +15 -0
  872. package/dist/types/core/agent/negativeClaims/observe.d.ts.map +1 -0
  873. package/dist/types/core/agent/negativeClaims/prose.d.ts +10 -0
  874. package/dist/types/core/agent/negativeClaims/prose.d.ts.map +1 -0
  875. package/dist/types/core/agent/negativeClaims/recheck.d.ts +8 -0
  876. package/dist/types/core/agent/negativeClaims/recheck.d.ts.map +1 -0
  877. package/dist/types/core/agent/outputEnforcement.d.ts +5 -1
  878. package/dist/types/core/agent/outputEnforcement.d.ts.map +1 -1
  879. package/dist/types/core/agent/receipt/receipt.d.ts +2 -2
  880. package/dist/types/core/agent/receipt/receipt.d.ts.map +1 -1
  881. package/dist/types/core/agent/stages/answerEvidence.d.ts +29 -0
  882. package/dist/types/core/agent/stages/answerEvidence.d.ts.map +1 -0
  883. package/dist/types/core/agent/stages/answerValidation.d.ts +15 -3
  884. package/dist/types/core/agent/stages/answerValidation.d.ts.map +1 -1
  885. package/dist/types/core/agent/stages/callLLM.d.ts +11 -2
  886. package/dist/types/core/agent/stages/callLLM.d.ts.map +1 -1
  887. package/dist/types/core/agent/stages/evidenceRecheck.d.ts +6 -1
  888. package/dist/types/core/agent/stages/evidenceRecheck.d.ts.map +1 -1
  889. package/dist/types/core/agent/stages/outputRetry.d.ts.map +1 -1
  890. package/dist/types/core/agent/stages/prepareFinal.d.ts.map +1 -1
  891. package/dist/types/core/agent/stages/reliabilityExecution.d.ts +3 -0
  892. package/dist/types/core/agent/stages/reliabilityExecution.d.ts.map +1 -1
  893. package/dist/types/core/agent/stages/route.d.ts +8 -2
  894. package/dist/types/core/agent/stages/route.d.ts.map +1 -1
  895. package/dist/types/core/agent/stages/searchCoverage.d.ts +95 -0
  896. package/dist/types/core/agent/stages/searchCoverage.d.ts.map +1 -0
  897. package/dist/types/core/agent/stages/seed.d.ts +10 -0
  898. package/dist/types/core/agent/stages/seed.d.ts.map +1 -1
  899. package/dist/types/core/agent/stages/toolCalls.d.ts +16 -0
  900. package/dist/types/core/agent/stages/toolCalls.d.ts.map +1 -1
  901. package/dist/types/core/agent/toolChoice/compose.d.ts +2 -0
  902. package/dist/types/core/agent/toolChoice/compose.d.ts.map +1 -1
  903. package/dist/types/core/agent/toolChoice/pick.d.ts +2 -0
  904. package/dist/types/core/agent/toolChoice/pick.d.ts.map +1 -1
  905. package/dist/types/core/agent/toolChoice/types.d.ts +1 -1
  906. package/dist/types/core/agent/toolChoice/types.d.ts.map +1 -1
  907. package/dist/types/core/agent/types.d.ts +86 -5
  908. package/dist/types/core/agent/types.d.ts.map +1 -1
  909. package/dist/types/core/checkin.d.ts +83 -7
  910. package/dist/types/core/checkin.d.ts.map +1 -1
  911. package/dist/types/core/consentRequest.d.ts +489 -0
  912. package/dist/types/core/consentRequest.d.ts.map +1 -0
  913. package/dist/types/core/pause.d.ts +88 -7
  914. package/dist/types/core/pause.d.ts.map +1 -1
  915. package/dist/types/core/runCheckpoint.d.ts +5 -1
  916. package/dist/types/core/runCheckpoint.d.ts.map +1 -1
  917. package/dist/types/core/slots/buildToolsSlot.d.ts +4 -11
  918. package/dist/types/core/slots/buildToolsSlot.d.ts.map +1 -1
  919. package/dist/types/debug.d.ts +1 -1
  920. package/dist/types/debug.d.ts.map +1 -1
  921. package/dist/types/events/payloads.d.ts +145 -3
  922. package/dist/types/events/payloads.d.ts.map +1 -1
  923. package/dist/types/events/registry.d.ts +3 -1
  924. package/dist/types/events/registry.d.ts.map +1 -1
  925. package/dist/types/hosting/answeredPause.d.ts +302 -0
  926. package/dist/types/hosting/answeredPause.d.ts.map +1 -0
  927. package/dist/types/hosting/conformance/cases.d.ts.map +1 -1
  928. package/dist/types/hosting/conformance/types.d.ts +1 -1
  929. package/dist/types/hosting/conformance/types.d.ts.map +1 -1
  930. package/dist/types/hosting/envelope.d.ts +6 -0
  931. package/dist/types/hosting/envelope.d.ts.map +1 -1
  932. package/dist/types/hosting/errors.d.ts +14 -2
  933. package/dist/types/hosting/errors.d.ts.map +1 -1
  934. package/dist/types/hosting/index.d.ts +2 -1
  935. package/dist/types/hosting/index.d.ts.map +1 -1
  936. package/dist/types/hosting/memorySessions.d.ts.map +1 -1
  937. package/dist/types/hosting/processLocalStore.d.ts +21 -0
  938. package/dist/types/hosting/processLocalStore.d.ts.map +1 -0
  939. package/dist/types/hosting/protocolAdapter.d.ts +13 -0
  940. package/dist/types/hosting/protocolAdapter.d.ts.map +1 -1
  941. package/dist/types/hosting/refusalStatus.d.ts +6 -0
  942. package/dist/types/hosting/refusalStatus.d.ts.map +1 -1
  943. package/dist/types/hosting/sessionWire.d.ts +8 -3
  944. package/dist/types/hosting/sessionWire.d.ts.map +1 -1
  945. package/dist/types/hosting/sqliteSessions.d.ts.map +1 -1
  946. package/dist/types/hosting/standingAgent.d.ts.map +1 -1
  947. package/dist/types/hosting/streamHandler.d.ts +3 -1
  948. package/dist/types/hosting/streamHandler.d.ts.map +1 -1
  949. package/dist/types/hosting/types.d.ts +28 -6
  950. package/dist/types/hosting/types.d.ts.map +1 -1
  951. package/dist/types/index.d.ts +7 -3
  952. package/dist/types/index.d.ts.map +1 -1
  953. package/dist/types/integrity/negative-claim/anchor.d.ts +10 -0
  954. package/dist/types/integrity/negative-claim/anchor.d.ts.map +1 -0
  955. package/dist/types/integrity/negative-claim/citation.d.ts +35 -0
  956. package/dist/types/integrity/negative-claim/citation.d.ts.map +1 -0
  957. package/dist/types/integrity/negative-claim/containment.d.ts +41 -0
  958. package/dist/types/integrity/negative-claim/containment.d.ts.map +1 -0
  959. package/dist/types/integrity/negative-claim/derive.d.ts +18 -0
  960. package/dist/types/integrity/negative-claim/derive.d.ts.map +1 -0
  961. package/dist/types/integrity/negative-claim/detect.d.ts +45 -0
  962. package/dist/types/integrity/negative-claim/detect.d.ts.map +1 -0
  963. package/dist/types/integrity/negative-claim/judge.d.ts +42 -0
  964. package/dist/types/integrity/negative-claim/judge.d.ts.map +1 -0
  965. package/dist/types/integrity/negative-claim/language.d.ts +15 -0
  966. package/dist/types/integrity/negative-claim/language.d.ts.map +1 -0
  967. package/dist/types/integrity/negative-claim/limits.d.ts +3 -0
  968. package/dist/types/integrity/negative-claim/limits.d.ts.map +1 -0
  969. package/dist/types/integrity/negative-claim/matcher.d.ts +52 -0
  970. package/dist/types/integrity/negative-claim/matcher.d.ts.map +1 -0
  971. package/dist/types/integrity/negative-claim/noRead.d.ts +9 -0
  972. package/dist/types/integrity/negative-claim/noRead.d.ts.map +1 -0
  973. package/dist/types/integrity/negative-claim/phrases.d.ts +70 -0
  974. package/dist/types/integrity/negative-claim/phrases.d.ts.map +1 -0
  975. package/dist/types/integrity/negative-claim/prose.d.ts +37 -0
  976. package/dist/types/integrity/negative-claim/prose.d.ts.map +1 -0
  977. package/dist/types/integrity/negative-claim/readings.d.ts +82 -0
  978. package/dist/types/integrity/negative-claim/readings.d.ts.map +1 -0
  979. package/dist/types/integrity/negative-claim/resolve.d.ts +38 -0
  980. package/dist/types/integrity/negative-claim/resolve.d.ts.map +1 -0
  981. package/dist/types/integrity/negative-claim/statement.d.ts +76 -0
  982. package/dist/types/integrity/negative-claim/statement.d.ts.map +1 -0
  983. package/dist/types/integrity/negative-claim/types.d.ts +145 -0
  984. package/dist/types/integrity/negative-claim/types.d.ts.map +1 -0
  985. package/dist/types/integrity/negative-claim/units.d.ts +34 -0
  986. package/dist/types/integrity/negative-claim/units.d.ts.map +1 -0
  987. package/dist/types/integrity/negative-claim/work.d.ts +13 -0
  988. package/dist/types/integrity/negative-claim/work.d.ts.map +1 -0
  989. package/dist/types/integrity/unsupported-claim/check.d.ts +33 -0
  990. package/dist/types/integrity/unsupported-claim/check.d.ts.map +1 -1
  991. package/dist/types/integrity/unsupported-claim/delivered.d.ts +73 -0
  992. package/dist/types/integrity/unsupported-claim/delivered.d.ts.map +1 -0
  993. package/dist/types/integrity/unsupported-claim/evaluate.d.ts +103 -1
  994. package/dist/types/integrity/unsupported-claim/evaluate.d.ts.map +1 -1
  995. package/dist/types/lib/conventions.d.ts +1 -0
  996. package/dist/types/lib/conventions.d.ts.map +1 -1
  997. package/dist/types/lib/frozenCopy.d.ts +76 -0
  998. package/dist/types/lib/frozenCopy.d.ts.map +1 -0
  999. package/dist/types/lib/jsonFaithful.d.ts +35 -0
  1000. package/dist/types/lib/jsonFaithful.d.ts.map +1 -0
  1001. package/dist/types/lib/normalize.d.ts +97 -0
  1002. package/dist/types/lib/normalize.d.ts.map +1 -0
  1003. package/dist/types/lib/saidByPerson.d.ts +2 -0
  1004. package/dist/types/lib/saidByPerson.d.ts.map +1 -1
  1005. package/dist/types/mcp/toolExtras.d.ts +10 -0
  1006. package/dist/types/mcp/toolExtras.d.ts.map +1 -1
  1007. package/dist/types/provider-contract/nativeOutputSchema.d.ts +6 -2
  1008. package/dist/types/provider-contract/nativeOutputSchema.d.ts.map +1 -1
  1009. package/dist/types/provider-contract/types.d.ts +12 -1
  1010. package/dist/types/provider-contract/types.d.ts.map +1 -1
  1011. package/dist/types/recorders/core/CheckInRecorder.d.ts +6 -1
  1012. package/dist/types/recorders/core/CheckInRecorder.d.ts.map +1 -1
  1013. package/dist/types/redaction/conversation.d.ts.map +1 -1
  1014. package/dist/types/redaction/knownStrings.d.ts +9 -7
  1015. package/dist/types/redaction/knownStrings.d.ts.map +1 -1
  1016. package/dist/types/resilience/withCircuitBreaker.d.ts.map +1 -1
  1017. package/dist/types/resilience/withFallback.d.ts.map +1 -1
  1018. package/dist/types/resilience/withRetry.d.ts.map +1 -1
  1019. package/dist/types/semantics/check.d.ts +44 -2
  1020. package/dist/types/semantics/check.d.ts.map +1 -1
  1021. package/dist/types/semantics/cli.d.ts.map +1 -1
  1022. package/dist/types/semantics/coverage/absent.d.ts +19 -2
  1023. package/dist/types/semantics/coverage/absent.d.ts.map +1 -1
  1024. package/dist/types/semantics/coverage/among.d.ts +74 -0
  1025. package/dist/types/semantics/coverage/among.d.ts.map +1 -0
  1026. package/dist/types/semantics/coverage/composedCoverage.d.ts +221 -0
  1027. package/dist/types/semantics/coverage/composedCoverage.d.ts.map +1 -0
  1028. package/dist/types/semantics/coverage/evidence.d.ts.map +1 -1
  1029. package/dist/types/semantics/coverage/index.d.ts +4 -1
  1030. package/dist/types/semantics/coverage/index.d.ts.map +1 -1
  1031. package/dist/types/semantics/coverage/ledger.d.ts +2 -1
  1032. package/dist/types/semantics/coverage/ledger.d.ts.map +1 -1
  1033. package/dist/types/semantics/coverage/read.d.ts +19 -0
  1034. package/dist/types/semantics/coverage/read.d.ts.map +1 -1
  1035. package/dist/types/semantics/coverage/recognize.d.ts +17 -1
  1036. package/dist/types/semantics/coverage/recognize.d.ts.map +1 -1
  1037. package/dist/types/semantics/coverage/search/binding.d.ts +28 -0
  1038. package/dist/types/semantics/coverage/search/binding.d.ts.map +1 -0
  1039. package/dist/types/semantics/coverage/search/compose.d.ts +91 -0
  1040. package/dist/types/semantics/coverage/search/compose.d.ts.map +1 -0
  1041. package/dist/types/semantics/coverage/search/declaration.d.ts +76 -0
  1042. package/dist/types/semantics/coverage/search/declaration.d.ts.map +1 -0
  1043. package/dist/types/semantics/coverage/search/door.d.ts +47 -0
  1044. package/dist/types/semantics/coverage/search/door.d.ts.map +1 -0
  1045. package/dist/types/semantics/coverage/search/events.d.ts +43 -0
  1046. package/dist/types/semantics/coverage/search/events.d.ts.map +1 -0
  1047. package/dist/types/semantics/coverage/search/facets.d.ts +53 -0
  1048. package/dist/types/semantics/coverage/search/facets.d.ts.map +1 -0
  1049. package/dist/types/semantics/coverage/search/gaps.d.ts +64 -0
  1050. package/dist/types/semantics/coverage/search/gaps.d.ts.map +1 -0
  1051. package/dist/types/semantics/coverage/search/inEffect.d.ts +66 -0
  1052. package/dist/types/semantics/coverage/search/inEffect.d.ts.map +1 -0
  1053. package/dist/types/semantics/coverage/search/resultFacts.d.ts +43 -0
  1054. package/dist/types/semantics/coverage/search/resultFacts.d.ts.map +1 -0
  1055. package/dist/types/semantics/coverage/search/review.d.ts +37 -0
  1056. package/dist/types/semantics/coverage/search/review.d.ts.map +1 -0
  1057. package/dist/types/semantics/coverage/search/served.d.ts +52 -0
  1058. package/dist/types/semantics/coverage/search/served.d.ts.map +1 -0
  1059. package/dist/types/semantics/coverage/search/span.d.ts +35 -0
  1060. package/dist/types/semantics/coverage/search/span.d.ts.map +1 -0
  1061. package/dist/types/semantics/coverage/search/statementText.d.ts +47 -0
  1062. package/dist/types/semantics/coverage/search/statementText.d.ts.map +1 -0
  1063. package/dist/types/semantics/coverage/search/types.d.ts +121 -0
  1064. package/dist/types/semantics/coverage/search/types.d.ts.map +1 -0
  1065. package/dist/types/semantics/coverage/search/valueWords.d.ts +23 -0
  1066. package/dist/types/semantics/coverage/search/valueWords.d.ts.map +1 -0
  1067. package/dist/types/semantics/coverage/types.d.ts +163 -0
  1068. package/dist/types/semantics/coverage/types.d.ts.map +1 -1
  1069. package/dist/types/semantics/described.d.ts.map +1 -1
  1070. package/dist/types/semantics/envelope.d.ts.map +1 -1
  1071. package/dist/types/semantics/index.d.ts +2 -1
  1072. package/dist/types/semantics/index.d.ts.map +1 -1
  1073. package/dist/types/semantics/overclaim.d.ts +106 -0
  1074. package/dist/types/semantics/overclaim.d.ts.map +1 -0
  1075. package/dist/types/semantics/types.d.ts +13 -0
  1076. package/dist/types/semantics/types.d.ts.map +1 -1
  1077. package/dist/types/time-travel/servedView.d.ts +2 -2
  1078. package/dist/types/time-travel/servedView.d.ts.map +1 -1
  1079. package/dist/types/tools/declare.d.ts +1 -1
  1080. package/dist/types/tools/hostFilled.d.ts +20 -1
  1081. package/dist/types/tools/hostFilled.d.ts.map +1 -1
  1082. package/dist/types/tools/searchOf.d.ts +61 -0
  1083. package/dist/types/tools/searchOf.d.ts.map +1 -0
  1084. package/dist/types/tools/tools.d.ts +49 -0
  1085. package/dist/types/tools/tools.d.ts.map +1 -1
  1086. package/dist/types/trace-toolpack/causeCapture.d.ts +18 -0
  1087. package/dist/types/trace-toolpack/causeCapture.d.ts.map +1 -0
  1088. package/dist/types/trace-toolpack/causeControl.d.ts +7 -0
  1089. package/dist/types/trace-toolpack/causeControl.d.ts.map +1 -0
  1090. package/dist/types/trace-toolpack/causeReader.d.ts.map +1 -1
  1091. package/dist/types/trace-toolpack/causeResponse.d.ts +3 -2
  1092. package/dist/types/trace-toolpack/causeResponse.d.ts.map +1 -1
  1093. package/dist/types/trace-toolpack/causeSnapshot.d.ts +6 -1
  1094. package/dist/types/trace-toolpack/causeSnapshot.d.ts.map +1 -1
  1095. package/package.json +3 -2
  1096. package/dist/esm/tools/normalize.d.ts +0 -43
  1097. package/dist/esm/tools/normalize.js.map +0 -1
  1098. package/dist/tools/normalize.js.map +0 -1
  1099. package/dist/types/tools/normalize.d.ts +0 -44
  1100. package/dist/types/tools/normalize.d.ts.map +0 -1
@@ -0,0 +1,221 @@
1
+ /**
2
+ * search/gaps — the ground one call's search did NOT cover, typed.
3
+ *
4
+ * Pattern: one pure composer per list; this one is the gaps.
5
+ * Role: semantics/ layer, pure.
6
+ * Emits: N/A.
7
+ *
8
+ * Each gap names the facet it bears on, so a checker decides relevance by
9
+ * facet and never by reading prose:
10
+ *
11
+ * • `argument-unsent` — any classified argument of any role but `inert` the
12
+ * call did not send, with no `whenOmitted`, or sent as an empty list: its
13
+ * default may live inside `execute`, and an empty list names nothing (it is
14
+ * never "every value"). Bears on that argument's facet (cap and page:
15
+ * completeness).
16
+ * • `cap-reached` — rows at the cap in effect (an argument's, or the
17
+ * declared server cap), rows that cannot be counted under a cap, or a
18
+ * server cap of `'unknown'`. Bears on completeness.
19
+ * • `paged` — a page argument sent, a result whose `paging.next` is not
20
+ * null, or a tool with a `page` argument whose result declares no
21
+ * `paging`. Bears on completeness.
22
+ * • `partial` — the tool declared its outcome `partial` or `pending`.
23
+ * • `period` — the declared period's verdict is not `covered`.
24
+ * • `scope` — the declaration's own constants.
25
+ * • `prose` — a hand-written `notChecked` / `cannotCover` item; no facet.
26
+ *
27
+ * Every `what` the library writes here names an ARGUMENT or a verdict, never
28
+ * a value the call sent.
29
+ */
30
+ import { periodVerdict } from '../period.js';
31
+ /** The facet an unsent argument of each role bears on. */
32
+ function unsentFacet(arg) {
33
+ const byRole = {
34
+ population: 'population',
35
+ filter: { filter: arg.name },
36
+ period: 'period',
37
+ source: 'source',
38
+ cap: 'completeness',
39
+ page: 'completeness',
40
+ query: 'population',
41
+ match: 'population',
42
+ inert: undefined,
43
+ };
44
+ return byRole[arg.role];
45
+ }
46
+ /** A cap value in effect as a number, or `undefined` when it is no whole count. */
47
+ function capOf(value) {
48
+ if (typeof value === 'number' && Number.isFinite(value))
49
+ return value;
50
+ if (typeof value === 'string' && /^\d+$/.test(value.trim()))
51
+ return Number(value.trim());
52
+ return undefined;
53
+ }
54
+ function unsentGaps(input) {
55
+ const out = [];
56
+ for (const [arg, reading] of input.readings) {
57
+ if (reading.kind !== 'unsent' && reading.kind !== 'empty')
58
+ continue;
59
+ const bears = unsentFacet(arg);
60
+ if (bears === undefined)
61
+ continue;
62
+ // An empty list names no value — like an unsent argument, its effect lives in `execute`.
63
+ const what = reading.kind === 'empty' ? `${arg.name}: an empty list` : `${arg.name}: not sent`;
64
+ out.push({ kind: 'argument-unsent', what, argument: arg.name, bears });
65
+ }
66
+ return out;
67
+ }
68
+ function capGaps(input) {
69
+ const out = [];
70
+ const atCap = (cap) => cap === undefined || input.rows === undefined || input.rows >= cap;
71
+ for (const [arg, reading] of input.readings) {
72
+ if (arg.role !== 'cap')
73
+ continue;
74
+ if (reading.kind !== 'sent' && reading.kind !== 'default')
75
+ continue;
76
+ if (atCap(capOf(reading.value))) {
77
+ out.push({
78
+ kind: 'cap-reached',
79
+ what: `rows may stop at the cap (${arg.name})`,
80
+ argument: arg.name,
81
+ bears: 'completeness',
82
+ });
83
+ }
84
+ }
85
+ const server = input.search.limits?.cap;
86
+ if (server !== undefined && (server === 'unknown' || atCap(server))) {
87
+ out.push({
88
+ kind: 'cap-reached',
89
+ what: server === 'unknown' ? 'the server cap is unknown' : 'rows may stop at the server cap',
90
+ bears: 'completeness',
91
+ });
92
+ }
93
+ return out;
94
+ }
95
+ function pagingGaps(input) {
96
+ const out = [];
97
+ const pages = input.readings.filter(([a]) => a.role === 'page');
98
+ for (const [arg, reading] of pages) {
99
+ if (reading.kind === 'sent') {
100
+ out.push({
101
+ kind: 'paged',
102
+ what: `a page past the first (${arg.name})`,
103
+ argument: arg.name,
104
+ bears: 'completeness',
105
+ });
106
+ }
107
+ }
108
+ if (input.paging !== undefined && input.paging.next !== null) {
109
+ out.push({ kind: 'paged', what: 'more pages after this one', bears: 'completeness' });
110
+ }
111
+ else if (input.paging === undefined && pages.length > 0) {
112
+ out.push({
113
+ kind: 'paged',
114
+ what: 'whether more pages exist (no paging declared)',
115
+ bears: 'completeness',
116
+ });
117
+ }
118
+ return out;
119
+ }
120
+ /**
121
+ * The read sees only what the caller's credential may see — declared
122
+ * (`limits.byCredential`) or read off an argument the host fills from a
123
+ * credential. One gap, whatever the count; it names no value and no credential.
124
+ */
125
+ function credentialGaps(input) {
126
+ const filled = input.readings.some(([, reading]) => reading.kind === 'credential');
127
+ if (input.search.limits?.byCredential !== true && !filled)
128
+ return [];
129
+ return [
130
+ {
131
+ kind: 'credential-limited',
132
+ what: "within what the caller's credential may see",
133
+ bears: 'population',
134
+ },
135
+ ];
136
+ }
137
+ /**
138
+ * A `query` or `match` argument in effect: the population is what matched, by
139
+ * a rule only the tool knows — a gap on the population, every call.
140
+ */
141
+ function matchGaps(input) {
142
+ return input.readings
143
+ .filter(([a, r]) => (a.role === 'query' || a.role === 'match') && (r.kind === 'sent' || r.kind === 'default'))
144
+ .map(([a]) => ({
145
+ kind: 'match',
146
+ what: `${a.name}: matched by the tool's own rule`,
147
+ argument: a.name,
148
+ bears: 'population',
149
+ }));
150
+ }
151
+ /** `ranking: 'approximate'` — the rows nearest, never every row that fits. */
152
+ function rankingGaps(input) {
153
+ if (input.search.ranking !== 'approximate')
154
+ return [];
155
+ return [
156
+ { kind: 'ranking', what: 'rows ranked by approximate similarity', bears: 'completeness' },
157
+ ];
158
+ }
159
+ function statusGaps(input) {
160
+ if (input.status !== 'partial' && input.status !== 'pending')
161
+ return [];
162
+ return [
163
+ { kind: 'partial', what: `the tool said its result is ${input.status}`, bears: 'completeness' },
164
+ ];
165
+ }
166
+ function periodGaps(input) {
167
+ if (input.period === undefined)
168
+ return [];
169
+ const verdict = periodVerdict(input.period);
170
+ return verdict === 'covered'
171
+ ? []
172
+ : [{ kind: 'period', what: `period: ${verdict}`, bears: 'period' }];
173
+ }
174
+ const proseGap = (item) => ({
175
+ kind: 'prose',
176
+ what: item.what,
177
+ ...(item.why !== undefined && { why: item.why }),
178
+ });
179
+ /**
180
+ * Every gap of one call, in a fixed order, with the plain lists: the
181
+ * composed gaps (but `period`, which the period row carries) and the
182
+ * hand-written `notChecked` under `notChecked`; the declared constants and the
183
+ * hand-written `cannotCover` under `cannotCover`.
184
+ */
185
+ export function composeGaps(input) {
186
+ const scope = (input.search.gaps ?? []).map((g) => ({
187
+ kind: 'scope',
188
+ what: g.what,
189
+ why: g.why,
190
+ bears: g.bears,
191
+ }));
192
+ const composed = [
193
+ ...unsentGaps(input),
194
+ ...capGaps(input),
195
+ ...pagingGaps(input),
196
+ ...statusGaps(input),
197
+ ...credentialGaps(input),
198
+ ...matchGaps(input),
199
+ ...rankingGaps(input),
200
+ ];
201
+ const gaps = [
202
+ ...composed,
203
+ ...periodGaps(input),
204
+ ...scope,
205
+ ...input.handNotChecked.map(proseGap),
206
+ ...input.handCannotCover.map(proseGap),
207
+ ];
208
+ return {
209
+ gaps,
210
+ notChecked: [...composed.map((g) => ({ what: g.what })), ...input.handNotChecked],
211
+ cannotCover: [
212
+ ...scope.map((g) => ({ what: g.what, why: g.why, kind: 'scope' })),
213
+ ...input.handCannotCover,
214
+ ],
215
+ };
216
+ }
217
+ /** The gap kinds that keep a row from being complete — and `prose`, which names no facet. */
218
+ export function blocksComplete(gap) {
219
+ return gap.kind === 'argument-unsent' || gap.kind === 'prose' || gap.bears === 'completeness';
220
+ }
221
+ //# sourceMappingURL=gaps.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gaps.js","sourceRoot":"","sources":["../../../../../src/semantics/coverage/search/gaps.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,65 @@
1
+ /**
2
+ * search/inEffect — what ONE classified argument was, for the call that ran.
3
+ *
4
+ * Pattern: one pure reader, the first step of composition. Every other step
5
+ * asks it, so "sent", "defaulted", "no narrowing" and "unsent" have
6
+ * one meaning.
7
+ * Role: semantics/ layer, pure.
8
+ * Emits: N/A.
9
+ *
10
+ * The arguments are the ones the tool RAN with: after the inputs layer's fill
11
+ * and any before-tool rewrite. A host-filled argument never appears there —
12
+ * `hostFilled` fills it inside `execute` — so the caller names those from the
13
+ * wrapper's own declaration (`tools/hostFilled.ts` · `hostFillsOf`).
14
+ */
15
+ import type { SearchArgument, SearchScalar } from './types.js';
16
+ /** Arguments the host fills inside `execute`, by where their value comes from. */
17
+ export interface HostFilledArguments {
18
+ /** argument → the identity field it is filled from (`'tenant'`). */
19
+ readonly identity: Readonly<Record<string, string>>;
20
+ /** Arguments filled from the call's credential — never composed. */
21
+ readonly credential: readonly string[];
22
+ }
23
+ /** What one classified argument was, for this call. */
24
+ export type ArgumentReading =
25
+ /** The call sent it (`null` included: a value the tool was handed). */
26
+ {
27
+ readonly kind: 'sent';
28
+ readonly value: unknown;
29
+ }
30
+ /** Left out, and the declaration says what `execute` applies. */
31
+ | {
32
+ readonly kind: 'default';
33
+ readonly value: SearchScalar | readonly SearchScalar[];
34
+ }
35
+ /** Left out, and omission narrows nothing (`{ any: true }`). */
36
+ | {
37
+ readonly kind: 'any';
38
+ }
39
+ /** Left out, and the declaration says nothing: its default may live in `execute`. */
40
+ | {
41
+ readonly kind: 'unsent';
42
+ }
43
+ /** Sent as an empty list — it names nothing, so what `execute` did with it is unknown. */
44
+ | {
45
+ readonly kind: 'empty';
46
+ }
47
+ /** Filled by the host from the run's identity. */
48
+ | {
49
+ readonly kind: 'host';
50
+ readonly identity: string;
51
+ }
52
+ /** Filled by the host from the call's credential. */
53
+ | {
54
+ readonly kind: 'credential';
55
+ };
56
+ /**
57
+ * Read one argument against the arguments the call ran with.
58
+ *
59
+ * @example
60
+ * ```ts
61
+ * readArgument({ name: 'window', role: 'period', whenOmitted: '2h' }, {});
62
+ * // { kind: 'default', value: '2h' }
63
+ * ```
64
+ */
65
+ export declare function readArgument(arg: SearchArgument, args: Readonly<Record<string, unknown>>, hostFilled?: HostFilledArguments): ArgumentReading;
@@ -0,0 +1,48 @@
1
+ /**
2
+ * search/inEffect — what ONE classified argument was, for the call that ran.
3
+ *
4
+ * Pattern: one pure reader, the first step of composition. Every other step
5
+ * asks it, so "sent", "defaulted", "no narrowing" and "unsent" have
6
+ * one meaning.
7
+ * Role: semantics/ layer, pure.
8
+ * Emits: N/A.
9
+ *
10
+ * The arguments are the ones the tool RAN with: after the inputs layer's fill
11
+ * and any before-tool rewrite. A host-filled argument never appears there —
12
+ * `hostFilled` fills it inside `execute` — so the caller names those from the
13
+ * wrapper's own declaration (`tools/hostFilled.ts` · `hostFillsOf`).
14
+ */
15
+ import { isAnyValue } from './declaration.js';
16
+ /**
17
+ * Read one argument against the arguments the call ran with.
18
+ *
19
+ * @example
20
+ * ```ts
21
+ * readArgument({ name: 'window', role: 'period', whenOmitted: '2h' }, {});
22
+ * // { kind: 'default', value: '2h' }
23
+ * ```
24
+ */
25
+ export function readArgument(arg, args, hostFilled) {
26
+ if (hostFilled !== undefined) {
27
+ if (hostFilled.credential.includes(arg.name))
28
+ return { kind: 'credential' };
29
+ const identity = Object.hasOwn(hostFilled.identity, arg.name)
30
+ ? hostFilled.identity[arg.name]
31
+ : undefined;
32
+ if (identity !== undefined)
33
+ return { kind: 'host', identity };
34
+ }
35
+ if (Object.hasOwn(args, arg.name) && args[arg.name] !== undefined) {
36
+ const value = args[arg.name];
37
+ if (Array.isArray(value) && value.length === 0)
38
+ return { kind: 'empty' };
39
+ return { kind: 'sent', value };
40
+ }
41
+ const omitted = arg.whenOmitted;
42
+ if (omitted === undefined)
43
+ return { kind: 'unsent' };
44
+ if (isAnyValue(omitted))
45
+ return { kind: 'any' };
46
+ return { kind: 'default', value: omitted };
47
+ }
48
+ //# sourceMappingURL=inEffect.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inEffect.js","sourceRoot":"","sources":["../../../../../src/semantics/coverage/search/inEffect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA4B9C;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAmB,EACnB,IAAuC,EACvC,UAAgC;IAEhC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAC5E,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC;YAC3D,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAC/B,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACzE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC;IAChC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrD,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAiD,EAAE,CAAC;AACvF,CAAC"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * search/resultFacts — the two facts a search tool's RESULT states out loud:
3
+ * `resolved` (the entity a population value resolved to) and `paging` (whether
4
+ * there is a next page).
5
+ *
6
+ * Pattern: one rule set, two doors (the `readItemExtras` law). The mint
7
+ * (`absent()`, `describedResult()`) THROWS a refusal at the line the
8
+ * author wrote; the reader (any envelope, minted anywhere) DROPS a
9
+ * malformed value — read, never repaired.
10
+ * Role: semantics/ layer, pure. The same spelling on the wire and in code
11
+ * (every key is one word).
12
+ * Emits: N/A.
13
+ *
14
+ * Both are the tool's own claims, said out loud — the trusted base. Each can
15
+ * only NARROW what the library composes: `resolved` attaches to the value the
16
+ * call was sent for and to no other entity; `paging.next` that is not null is
17
+ * a gap, and a first page is complete only with `next: null`.
18
+ */
19
+ /** One population value, resolved — `{ argument, id, name?, aliases? }`. */
20
+ export interface ResolvedDeclaration {
21
+ /** The population argument the value was sent as. */
22
+ readonly argument: string;
23
+ readonly id: string;
24
+ readonly name?: string;
25
+ readonly aliases?: readonly string[];
26
+ }
27
+ /** `{ next }` — `null` says there is no next page; a cursor or page number says there is. */
28
+ export interface PagingDeclaration {
29
+ readonly next: string | number | null;
30
+ }
31
+ /** What is wrong with a `resolved` list, or `undefined` when it is fine. */
32
+ export declare function resolvedProblem(value: unknown): string | undefined;
33
+ /** What is wrong with a `paging`, or `undefined` when it is fine. */
34
+ export declare function pagingProblem(value: unknown): string | undefined;
35
+ /** The minted `resolved` — a copy — or `undefined` for none; THROWS a refusal when malformed. */
36
+ export declare function mintResolved(value: unknown): readonly ResolvedDeclaration[] | undefined;
37
+ /** The minted `paging` — a copy — or `undefined` for none; THROWS a refusal when malformed. */
38
+ export declare function mintPaging(value: unknown): PagingDeclaration | undefined;
39
+ /** A `resolved` read off an envelope — a copy, or `undefined` when absent or malformed. */
40
+ export declare function readResolved(value: unknown): readonly ResolvedDeclaration[] | undefined;
41
+ /** A `paging` read off an envelope — a copy, or `undefined` when absent or malformed. */
42
+ export declare function readPaging(value: unknown): PagingDeclaration | undefined;
@@ -0,0 +1,100 @@
1
+ /**
2
+ * search/resultFacts — the two facts a search tool's RESULT states out loud:
3
+ * `resolved` (the entity a population value resolved to) and `paging` (whether
4
+ * there is a next page).
5
+ *
6
+ * Pattern: one rule set, two doors (the `readItemExtras` law). The mint
7
+ * (`absent()`, `describedResult()`) THROWS a refusal at the line the
8
+ * author wrote; the reader (any envelope, minted anywhere) DROPS a
9
+ * malformed value — read, never repaired.
10
+ * Role: semantics/ layer, pure. The same spelling on the wire and in code
11
+ * (every key is one word).
12
+ * Emits: N/A.
13
+ *
14
+ * Both are the tool's own claims, said out loud — the trusted base. Each can
15
+ * only NARROW what the library composes: `resolved` attaches to the value the
16
+ * call was sent for and to no other entity; `paging.next` that is not null is
17
+ * a gap, and a first page is complete only with `next: null`.
18
+ */
19
+ import { refusal } from '../refusal.js';
20
+ const isPlain = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
21
+ const isWord = (v) => typeof v === 'string' && v.trim() !== '';
22
+ const RESOLVED_KEYS = ['argument', 'id', 'name', 'aliases'];
23
+ /** What is wrong with a `resolved` list, or `undefined` when it is fine. */
24
+ export function resolvedProblem(value) {
25
+ if (!Array.isArray(value) || value.length === 0) {
26
+ return '`resolved` must be a non-empty list of { argument, id, name?, aliases? } — omit it to say nothing.';
27
+ }
28
+ for (const [i, raw] of value.entries()) {
29
+ const at = `\`resolved[${i}]\``;
30
+ if (!isPlain(raw))
31
+ return `${at} must be { argument, id, name?, aliases? }.`;
32
+ const unknown = Object.keys(raw).find((k) => !RESOLVED_KEYS.includes(k));
33
+ if (unknown !== undefined)
34
+ return `${at} has an unknown key '${unknown}'.`;
35
+ if (!isWord(raw.argument))
36
+ return `${at}.argument must name the population argument.`;
37
+ if (!isWord(raw.id))
38
+ return `${at}.id must be a non-empty string.`;
39
+ if (raw.name !== undefined && !isWord(raw.name))
40
+ return `${at}.name must be a non-empty string.`;
41
+ if (raw.aliases !== undefined && (!Array.isArray(raw.aliases) || !raw.aliases.every(isWord))) {
42
+ return `${at}.aliases must be a list of non-empty strings.`;
43
+ }
44
+ }
45
+ return undefined;
46
+ }
47
+ /** What is wrong with a `paging`, or `undefined` when it is fine. */
48
+ export function pagingProblem(value) {
49
+ if (!isPlain(value) || !('next' in value)) {
50
+ return '`paging` must be { next } — `next: null` when there is no next page.';
51
+ }
52
+ const unknown = Object.keys(value).find((k) => k !== 'next');
53
+ if (unknown !== undefined)
54
+ return `\`paging\` has an unknown key '${unknown}'.`;
55
+ const next = value.next;
56
+ const ok = next === null || isWord(next) || (typeof next === 'number' && Number.isFinite(next));
57
+ return ok
58
+ ? undefined
59
+ : '`paging.next` must be null (no next page), a cursor string or a page number.';
60
+ }
61
+ function copyResolved(list) {
62
+ return list.map((r) => ({
63
+ argument: r.argument,
64
+ id: r.id,
65
+ ...(r.name !== undefined && { name: r.name }),
66
+ ...(r.aliases !== undefined && { aliases: [...r.aliases] }),
67
+ }));
68
+ }
69
+ /** The minted `resolved` — a copy — or `undefined` for none; THROWS a refusal when malformed. */
70
+ export function mintResolved(value) {
71
+ if (value === undefined || value === null)
72
+ return undefined;
73
+ const problem = resolvedProblem(value);
74
+ if (problem !== undefined)
75
+ throw refusal(problem);
76
+ return copyResolved(value);
77
+ }
78
+ /** The minted `paging` — a copy — or `undefined` for none; THROWS a refusal when malformed. */
79
+ export function mintPaging(value) {
80
+ if (value === undefined)
81
+ return undefined;
82
+ const problem = pagingProblem(value);
83
+ if (problem !== undefined)
84
+ throw refusal(problem);
85
+ return { next: value.next };
86
+ }
87
+ /** A `resolved` read off an envelope — a copy, or `undefined` when absent or malformed. */
88
+ export function readResolved(value) {
89
+ if (value === undefined || value === null || resolvedProblem(value) !== undefined) {
90
+ return undefined;
91
+ }
92
+ return copyResolved(value);
93
+ }
94
+ /** A `paging` read off an envelope — a copy, or `undefined` when absent or malformed. */
95
+ export function readPaging(value) {
96
+ if (value === undefined || pagingProblem(value) !== undefined)
97
+ return undefined;
98
+ return { next: value.next };
99
+ }
100
+ //# sourceMappingURL=resultFacts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resultFacts.js","sourceRoot":"","sources":["../../../../../src/semantics/coverage/search/resultFacts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ /**
2
+ * search/review — what a person should LOOK AT in a `Tool.search`, never a
3
+ * refusal.
4
+ *
5
+ * Pattern: one pure lister, two readers: the `check:semantics` gate (warnings,
6
+ * errors only under `--strict`) and `defineTool`'s dev-mode warning.
7
+ * Role: semantics/ layer, pure.
8
+ * Emits: N/A.
9
+ *
10
+ * • `source-said` — every word a claim may use to scope itself to the
11
+ * source. A word wider than the source ("the estate") would let a claim
12
+ * about everything read as a claim about this store, so a person reviews
13
+ * the list, like an `authoritative` use. No word ever removes a gap.
14
+ * • `said-overlap` — a `subject.said` word that repeats a qualifier: a
15
+ * filter value's word (a qualifier NOT in `fixed`), or a fixed
16
+ * qualifier's own word. The subject says WHAT was looked for and the
17
+ * qualifiers say WHICH; a subject word carrying a qualifier lets a claim
18
+ * match the subject without naming the qualifier the search applied.
19
+ */
20
+ import type { ToolSearch } from './types.js';
21
+ export type SearchReviewCode = 'source-said' | 'said-overlap';
22
+ /** One thing a reviewer should read. */
23
+ export interface SearchReviewItem {
24
+ readonly code: SearchReviewCode;
25
+ readonly field: string;
26
+ readonly message: string;
27
+ }
28
+ /**
29
+ * The review items of one search — `[]` when there is nothing to look at.
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * searchReviewItems(search).map((i) => i.code); // ['source-said']
34
+ * ```
35
+ */
36
+ export declare function searchReviewItems(search: ToolSearch): readonly SearchReviewItem[];
@@ -0,0 +1,89 @@
1
+ /**
2
+ * search/review — what a person should LOOK AT in a `Tool.search`, never a
3
+ * refusal.
4
+ *
5
+ * Pattern: one pure lister, two readers: the `check:semantics` gate (warnings,
6
+ * errors only under `--strict`) and `defineTool`'s dev-mode warning.
7
+ * Role: semantics/ layer, pure.
8
+ * Emits: N/A.
9
+ *
10
+ * • `source-said` — every word a claim may use to scope itself to the
11
+ * source. A word wider than the source ("the estate") would let a claim
12
+ * about everything read as a claim about this store, so a person reviews
13
+ * the list, like an `authoritative` use. No word ever removes a gap.
14
+ * • `said-overlap` — a `subject.said` word that repeats a qualifier: a
15
+ * filter value's word (a qualifier NOT in `fixed`), or a fixed
16
+ * qualifier's own word. The subject says WHAT was looked for and the
17
+ * qualifiers say WHICH; a subject word carrying a qualifier lets a claim
18
+ * match the subject without naming the qualifier the search applied.
19
+ */
20
+ /** The words of a phrase, for a phrase-in-phrase test — NFC, case-folded. */
21
+ function wordsOf(phrase) {
22
+ return phrase
23
+ .normalize('NFC')
24
+ .toLowerCase()
25
+ .split(/[^\p{L}\p{N}]+/u)
26
+ .filter((w) => w !== '');
27
+ }
28
+ /** Whether `inner`'s words appear, in order and adjacent, inside `outer`'s. */
29
+ function containsPhrase(outer, inner) {
30
+ if (inner.length === 0 || inner.length > outer.length)
31
+ return false;
32
+ for (let i = 0; i + inner.length <= outer.length; i += 1) {
33
+ if (inner.every((w, j) => outer[i + j] === w))
34
+ return true;
35
+ }
36
+ return false;
37
+ }
38
+ /** Every qualifier word the search declares, with where it came from. */
39
+ function qualifierWords(search) {
40
+ const out = [];
41
+ for (const q of search.fixed ?? []) {
42
+ for (const word of q.said)
43
+ out.push({ word, from: `the fixed qualifier '${q.name}'` });
44
+ }
45
+ const filters = search.arguments.filter((a) => a.role === 'filter');
46
+ for (const a of filters) {
47
+ for (const [value, words] of Object.entries(a.said ?? {})) {
48
+ for (const word of [value, ...words]) {
49
+ out.push({ word, from: `the filter '${a.name}' (not a fixed qualifier)` });
50
+ }
51
+ }
52
+ }
53
+ return out;
54
+ }
55
+ /**
56
+ * The review items of one search — `[]` when there is nothing to look at.
57
+ *
58
+ * @example
59
+ * ```ts
60
+ * searchReviewItems(search).map((i) => i.code); // ['source-said']
61
+ * ```
62
+ */
63
+ export function searchReviewItems(search) {
64
+ const items = [
65
+ {
66
+ code: 'source-said',
67
+ field: 'search.source.said',
68
+ message: `a claim using one of these words is read as scoped to '${search.source.what}': ` +
69
+ `${search.source.said.map((w) => `'${w}'`).join(', ')}. Check that each names this ` +
70
+ 'source and nothing wider — no word ever removes a gap.',
71
+ },
72
+ ];
73
+ const qualifiers = qualifierWords(search);
74
+ search.subject.said.forEach((subjectWord, i) => {
75
+ const subject = wordsOf(subjectWord);
76
+ const hit = qualifiers.find((q) => containsPhrase(subject, wordsOf(q.word)));
77
+ if (hit === undefined)
78
+ return;
79
+ items.push({
80
+ code: 'said-overlap',
81
+ field: `search.subject.said[${i}]`,
82
+ message: `'${subjectWord}' repeats '${hit.word}', a word of ${hit.from}. Keep the subject's ` +
83
+ 'words to what was looked for and the qualifiers in their own lists, or a claim can ' +
84
+ 'match the subject without naming a qualifier the search applied.',
85
+ });
86
+ });
87
+ return items;
88
+ }
89
+ //# sourceMappingURL=review.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"review.js","sourceRoot":"","sources":["../../../../../src/semantics/coverage/search/review.ts"],"names":[],"mappings":"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"}