agentfootprint 10.10.0 → 11.0.0

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