@wildo-ai/framework-knowledge 1.1.11 → 1.1.13

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 (812) hide show
  1. package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
  2. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  3. package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
  5. package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
  6. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
  7. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
  8. package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
  9. package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
  10. package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
  11. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  12. package/dist/esm/framework-knowledge.definitions.js +180 -32
  13. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  14. package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
  15. package/dist/esm/framework-knowledge.loader.js.map +1 -1
  16. package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
  17. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
  18. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
  19. package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
  20. package/dist/esm/framework-knowledge.schemas.js.map +1 -1
  21. package/dist/esm/index.d.ts.map +1 -1
  22. package/dist/esm/index.js.map +1 -1
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
  24. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
  25. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
  26. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  27. package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
  29. package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
  31. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  32. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
  33. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
  35. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
  37. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
  39. package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
  41. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  43. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
  45. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
  47. package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  49. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
  50. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  51. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
  52. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  53. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
  54. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  55. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
  56. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
  57. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
  58. package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
  59. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  61. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
  62. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
  63. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
  64. package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
  65. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
  66. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  67. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
  68. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  69. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  71. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
  72. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
  73. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
  74. package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
  75. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
  76. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
  77. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
  78. package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
  79. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
  80. package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
  81. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  82. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  83. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
  84. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  85. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
  86. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
  87. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
  88. package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
  89. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
  91. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
  93. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
  94. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
  95. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  96. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
  98. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
  99. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  100. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
  101. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  102. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
  104. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
  107. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
  109. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
  111. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
  113. package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
  114. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
  115. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  116. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
  117. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
  118. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
  119. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  120. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
  121. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
  122. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
  123. package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
  124. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
  125. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  126. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
  127. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  128. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  129. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
  130. package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
  131. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
  132. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
  133. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
  134. package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
  135. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
  136. package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
  137. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
  138. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  139. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
  140. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  141. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  142. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  143. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
  144. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  145. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
  146. package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
  147. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
  148. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
  149. package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
  150. package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
  151. package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
  152. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  153. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
  154. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  155. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  156. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
  157. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  158. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
  159. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  160. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
  161. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  162. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
  163. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
  164. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
  165. package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
  166. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
  167. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
  168. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
  169. package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
  170. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
  171. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
  172. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
  173. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
  174. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
  175. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
  176. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
  177. package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
  178. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
  179. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  180. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
  181. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  182. package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
  183. package/dist/esm/source-anchor-grammar.js.map +1 -1
  184. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  185. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  186. package/dist/knowledge/manifest.json +7 -7
  187. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  188. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
  189. package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
  190. package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
  191. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  192. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  193. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
  194. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
  195. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
  196. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
  197. package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
  198. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
  199. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
  200. package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
  201. package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
  202. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  203. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  204. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
  205. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
  206. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
  207. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
  208. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
  209. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
  210. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
  211. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
  212. package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
  213. package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
  214. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
  215. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
  216. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
  217. package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
  218. package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
  219. package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
  220. package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
  221. package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
  222. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
  223. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
  224. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
  225. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
  226. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
  227. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
  228. package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
  229. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
  230. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
  231. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
  232. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  233. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  234. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
  235. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
  236. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
  237. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  238. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  239. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
  240. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
  241. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
  242. package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
  243. package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
  244. package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
  245. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
  246. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
  247. package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
  248. package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
  249. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
  250. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
  251. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
  252. package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
  253. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
  254. package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
  255. package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
  256. package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
  257. package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
  258. package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
  259. package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
  260. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
  261. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
  262. package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
  263. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
  264. package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
  265. package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
  266. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
  267. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
  268. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  269. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  270. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
  271. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
  272. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
  273. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  274. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  275. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  277. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  278. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  279. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  283. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  284. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  285. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  286. package/dist/knowledge/references/application-maturity.config.md +70 -1
  287. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  288. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  289. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  290. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  291. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  292. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  293. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  294. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  295. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  296. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  297. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  298. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  299. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  300. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  301. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  302. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  303. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  305. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  306. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  307. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  308. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  309. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  310. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  311. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  312. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  313. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  314. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  315. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
  316. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  317. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  318. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  319. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  320. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  321. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  322. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  323. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  324. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  325. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  326. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  327. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  328. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  329. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  330. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  331. package/dist/knowledge/references/experience-plan.config.md +111 -1
  332. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  333. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  334. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  335. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  336. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  337. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  338. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  339. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  340. package/dist/knowledge/references/integration-plan.config.md +7 -7
  341. package/dist/knowledge/references/placement-plan.config.md +19 -0
  342. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  343. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  344. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  345. package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
  346. package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
  347. package/dist/knowledge/references/platform.config.saas.md +20 -18
  348. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  349. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  350. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  351. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  352. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  353. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  354. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  355. package/dist/knowledge/references/requirements.engine-substance.md +38 -0
  356. package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
  357. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
  358. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  359. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
  360. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  361. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  362. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  363. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  364. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  365. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  366. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  367. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  368. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  369. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  370. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  371. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  372. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  373. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  374. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
  375. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  376. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  377. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  378. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  379. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  380. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  381. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  382. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  383. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  384. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  385. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  386. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  387. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  388. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  389. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
  390. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  391. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  392. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  393. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  394. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  395. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  396. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  397. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  398. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  399. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  400. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  401. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  402. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  403. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  404. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  405. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  406. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  407. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  408. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  409. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  410. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  411. package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
  412. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  413. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  414. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  415. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  416. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  417. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  418. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  419. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  420. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  421. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  422. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  423. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  424. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  425. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
  426. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  427. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  428. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  429. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  430. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  431. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  432. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  433. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  434. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  435. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  436. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  437. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  438. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  439. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  440. package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
  441. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  442. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  443. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  444. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  445. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  446. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  447. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  448. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  449. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  450. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  451. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  452. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  453. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  454. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  455. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  456. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  457. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  458. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  459. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  460. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  461. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  462. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  463. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  464. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  465. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  466. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  467. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  468. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  469. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  470. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  471. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  472. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  473. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  474. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  475. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  476. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  477. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  478. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  479. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  480. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  481. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  482. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  483. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  484. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  485. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  486. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  487. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  488. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  489. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  490. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  491. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  492. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  493. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  494. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  495. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  496. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  497. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  498. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  499. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  500. package/dist/knowledge/references/service-method.config.md +35 -2
  501. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  502. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  503. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  504. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  505. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  506. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  507. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  508. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  509. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  510. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  511. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  512. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  513. package/dist/knowledge/references/zod.factories.code.md +4 -4
  514. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  515. package/dist/knowledge/references/zod.factories.money.md +4 -4
  516. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  517. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  518. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  519. package/dist/knowledge/registries/framework-topics.json +455 -2
  520. package/dist/knowledge/registries/playbooks.json +51 -39
  521. package/dist/knowledge/registries/source-tags.json +2505 -1627
  522. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  523. package/dist/knowledge/rules/live-context-door.md +1 -1
  524. package/dist/knowledge/skills/INDEX.md +3 -1
  525. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  526. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  527. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  528. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  529. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  530. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  531. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  532. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  533. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  534. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  535. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  536. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  537. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  538. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  539. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  540. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  541. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  542. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  543. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  544. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  545. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  546. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  547. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  548. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  549. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  550. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
  551. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  552. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  553. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  554. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  555. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  556. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  557. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  558. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  559. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  560. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  561. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  562. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  563. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  564. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  565. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  566. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  567. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  568. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  569. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  570. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  571. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  572. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  573. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  574. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  575. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  576. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
  577. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  578. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  579. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  580. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  581. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  582. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  583. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  584. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  585. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  586. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  587. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  588. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  589. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  590. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  591. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
  592. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  593. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  594. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  595. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  596. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  597. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  598. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
  599. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  606. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  607. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  608. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  609. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
  610. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  611. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  612. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  613. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
  614. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  615. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  616. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
  617. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  618. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  619. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
  620. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
  621. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
  622. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  623. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  624. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  625. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  626. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  627. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  628. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  629. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  630. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  631. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  632. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  633. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  634. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  635. package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
  636. package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
  637. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  638. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  639. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
  640. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
  641. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  642. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  643. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  644. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  645. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  646. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  647. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  648. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  649. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  650. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  651. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  652. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  653. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  654. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  655. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  656. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  657. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  658. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  659. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  660. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  661. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  662. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  663. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  664. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  665. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  666. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  667. package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
  668. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  669. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  670. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  671. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  672. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  673. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  674. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  675. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  676. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  677. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  678. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  679. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  680. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  681. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  682. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  683. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  684. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  685. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  686. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  687. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  688. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  693. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  694. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  695. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
  696. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  697. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  698. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  699. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  700. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  701. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  702. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  703. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  704. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  705. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  706. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  707. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  708. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  709. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  710. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  711. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  712. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  713. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  714. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  715. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  716. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  717. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  718. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  719. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  720. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  721. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  722. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  723. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  724. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  725. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  726. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  727. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  728. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  729. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  730. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  731. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  732. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  733. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  734. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  735. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  736. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  737. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  738. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  739. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  740. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  741. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  742. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  743. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  744. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  745. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  746. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  747. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  748. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  749. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  750. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  751. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  752. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  753. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  754. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  755. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  756. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  757. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  758. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  759. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  760. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  761. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  762. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  763. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  764. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  765. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  766. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  767. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  768. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  769. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  770. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  771. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  772. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  773. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  774. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  775. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  776. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  777. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
  778. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  779. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  780. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  781. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  783. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  784. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  785. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  786. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  787. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  788. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  790. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  791. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  792. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  793. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  795. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  797. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  798. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  799. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  800. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  801. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  802. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  803. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  804. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  805. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  806. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  807. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  808. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  809. package/dist/knowledge/topic-index.json +2422 -723
  810. package/dist/tsconfig.build.tsbuildinfo +1 -1
  811. package/package.json +6 -6
  812. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -0,0 +1,78 @@
1
+ # What makes a signature request SIGNED
2
+
3
+ ## The life of a request
4
+
5
+ | State | Meaning | Final |
6
+ |---|---|---|
7
+ | SENT | Sent; nobody has signed yet, as far as the vendor reports. | no |
8
+ | PARTIALLY_SIGNED | The vendor reports that some signers signed. A claim, never evidence. | no |
9
+ | SIGNED | The signed document validated and proves every signer at the required level. | yes |
10
+ | DECLINED | A signer refused. | yes |
11
+ | EXPIRED | The vendor's deadline passed. | yes |
12
+ | CANCELLED | Withdrawn before it was signed, at the vendor or because its record went. | yes |
13
+ | FAILED | The evidence proves another signer or a lower level than required. | yes |
14
+
15
+ A final request absorbs every later event: a late notification changes nothing and is recorded.
16
+
17
+ ## What the validation checks
18
+
19
+ A vendor's "completed" moves nothing by itself. The engine downloads the signed PDF and validates it:
20
+
21
+ - **Byte range.** Each signature covers the whole file except its own `/Contents`.
22
+ - **The bytes sent.** The file starts with exactly the approved bytes (their hash is the request's
23
+ `originalContentSha256`). A vendor that rewrites the file instead of appending to it is refused.
24
+ - **Nothing added but signing.** After those bytes, only signatures, their fields and appearances, the form, a page's
25
+ `/Annots` and a document security store (`/DSS`) may be added. After the last signature, only a `/DSS` update.
26
+ Every appended cross-reference section must be one the check read, chained to the one before it, so a section hidden
27
+ inside a stream's data cannot be the one a PDF reader follows.
28
+ - **The chain.** The signer's certificate chains, at the claimed signing time (which must fall within the request's
29
+ life), to an anchor the provider pins for its vendor environment.
30
+ - **Revocation.** Every certificate below the anchor has a CRL or OCSP response saying it is not revoked: the one the
31
+ signature carries, or a CRL fetched now from the certificate's distribution point.
32
+ - **Algorithms.** SHA-256, SHA-384 or SHA-512 throughout; SHA-1 and RSA keys under 2048 bits are refused.
33
+ - **Signer and level.** At ADVANCED, every signer's certificate names their e-mail address and carries a certificate
34
+ policy the provider declares as advanced.
35
+
36
+ A document that fails any check leaves the request open (the poll reads it again). One that validates but proves another
37
+ signer or a lower level ends it FAILED.
38
+
39
+ ## The evidence it keeps
40
+
41
+ A SIGNED request names two files of its own, written in the same move: the signed PDF (a vendor-signed copy of the
42
+ original) and the validation's evidence as JSON (each signature, its chain, the check date, and every CRL and OCSP
43
+ response used). They go with the request when its record goes, and the record's legal holds keep them. Where your
44
+ application scans files, the signed PDF is linked to its request once its scan ends; the poll does it, so nothing is lost
45
+ while the scan runs. The audit trail records each sending, each move (with the hashes and the signers), each late event
46
+ and each cancellation.
47
+
48
+ ## Watching it
49
+
50
+ The poll's batch output counts what each run sent, moved, linked and left pending. The metrics answer whether signing is
51
+ healthy without reading the audit rows:
52
+
53
+ | Metric | Labels | Worth an alert when |
54
+ |---|---|---|
55
+ | `signature_request_sent_total` | `outcome` (`sent` or the refusal), `required_level` | a refusal other than `already_open` keeps appearing |
56
+ | `signature_request_moved_total` | `provider`, `to` | `to="failed"` appears (a signer or level that can never be met) |
57
+ | `signature_request_evidence_refused_total` | `provider`, `failure` | any `failure` but `rejected`: the engine cannot validate or keep evidence |
58
+ | `signature_request_vendor_not_read_total` | `provider` | it rises steadily: the vendor is down |
59
+ | `signature_request_evidence_link_total` | `outcome` | `outcome="lost"`: a SIGNED request names evidence nothing keeps |
60
+
61
+ ## Notifications
62
+
63
+ A vendor's notification names a request and nothing in it is believed: the request is re-read at the vendor's API, and
64
+ that answer decides. A notification about a request of an application-wide record (no organization) is dropped; the
65
+ poll re-reads that request within five minutes.
66
+
67
+ ## Stated limits
68
+
69
+ - One document per request. A request the vendor split into several documents is left open.
70
+ - A signer's e-mail address is compared as it is now. One changed since the invitation does not match the certificate;
71
+ a signer with no address on record leaves the request open.
72
+ - An OCSP response the signature carries counts only once it verifies (signed by the certificate's issuer or a responder
73
+ it delegated to, and current).
74
+ - OCSP is read when the signature carries it, never fetched; the CRL is fetched instead.
75
+ - The appearance a signature field draws is not inspected.
76
+ - Signers are invited, and their certificate's e-mail compared, at the address in your database. Someone who can change
77
+ a signer's address can receive their invitation. Requiring identity proofing that does not rely on that data (an
78
+ identity document or eID checked by the vendor, proved by the certificate it issues) is designed and not yet available.
@@ -377,7 +377,7 @@ single self-contained reference shape for app developers.
377
377
 
378
378
  ## References
379
379
 
380
- - `references/framework-email-attachments-and-limits.md` — `attachmentFileIds`, the framework's own size cap, and why a declared vendor list is not failover
380
+ - `references/framework-email-attachments-and-limits.md` — `attachmentFileIds`, the framework's own size cap, and when a send is handed to a declared `failover` vendor
381
381
  - `references/email-artifact-paths.md` — where files live (template, labels, registry, type enum)
382
382
  - `references/framework-email-template-api.md` — `EmailTemplateDefinition<TLabels>` + `EmailTemplateDefinitionsMap` types
383
383
  - `references/framework-operation-email-template-ref-api.md` — the ref an operation's `userNotifications` email renders, and the directory it lives in, with worked cases (source-backed)
@@ -25,14 +25,17 @@ upload validation and, where its field opts into scanning, the scanner — and t
25
25
  only what the download route would serve, which excludes an infected file. Re-deciding admissible
26
26
  types here would be a second policy that can disagree with the first.
27
27
 
28
- ## ⚠️ A declared vendor list is not failover
29
-
30
- The provider selection accepts a primary and further entries, and the send path takes the FIRST and
31
- stops. There is no automatic retry against a second vendor when the primary refuses.
32
-
33
- The field is named `whenUnavailable` rather than `fallbacks` for exactly this reason — it governs how
34
- an UNAVAILABLE capability resolves, not what happens to a failed send. If continuity across vendors
35
- matters, that is something the application builds.
28
+ ## ⚠️ `whenUnavailable` is not failover; `failover` is, and only on a proven non-delivery
29
+
30
+ `whenUnavailable` governs how an UNAVAILABLE capability resolves (the selected vendor is not declared
31
+ or not loaded), not what happens to a failed send. A send the selected vendor fails is handed to the
32
+ next vendor only through the selection's separate `failover` list, and only when the vendor provably
33
+ did NOT take it: the connection was never established, or it answered that it refused the message for
34
+ now (429, or its adapter's own retryable refusal). A send that timed out, was reset or got a 5xx may
35
+ already have been delivered, so it is NOT handed on (a second vendor would deliver it twice); it stays
36
+ `acceptance_unknown` and retryable against the selected vendor. See the `config-saas` skill's
37
+ `framework-capability-resolution-api.md` for the declaration, and keep the application's sending
38
+ domains authenticated (SPF, DKIM) at every vendor the list names.
36
39
 
37
40
  ## Other send-path limits worth knowing
38
41
 
@@ -19,8 +19,9 @@ code. Send from code only when it cannot express the email:
19
19
  - it carries an **attachment** (a declaration has none);
20
20
  - it goes to **several addresses**, or an address in a **nested** field or a list;
21
21
  - it needs **cc, bcc, reply-to or threading** headers (a reply in an existing conversation);
22
- - a recipient who is **not a user** must be written to in **their own language** (`recipientEmailField` sends in the
23
- application's default locale).
22
+ - a recipient who is **not a user** must be written to in **their own language**: `recipientEmailField` writes in the
23
+ reader's language only when the record's `userId` names a user holding that address, and in the application's
24
+ primary language otherwise.
24
25
 
25
26
  A direct send consults no preference. Reaching for it to get around a person's choice to switch an email off is the
26
27
  one wrong use.
@@ -354,11 +354,10 @@ export const moduleBackend_FlowsActorsRegistry: {
354
354
  // owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
355
355
  // DTO coerces the ISO `dueDate` string to a Date at the service boundary.
356
356
  //
357
- // `recurringType` IS supplied (pinned to ONE_TIME): todos is a discriminated-union inheritance
358
- // resource (one-time / recurring), so its CREATE DTO REQUIRES the `recurringType` discriminator
359
- // to select a variant — omitting it fails with "no matching discriminator". The assistant only
360
- // creates NON-recurring todos, so we default it to ONE_TIME (the model need not supply it) and
361
- // use a literal so the model cannot select the recurring variant, whose extra fields
357
+ // `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
358
+ // resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
359
+ // left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
360
+ // states that: the model cannot select the recurring variant, whose extra fields
362
361
  // (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
363
362
  // defaulted (not merely optional) so they are always present for the discriminated base branch.
364
363
  resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
@@ -377,6 +376,10 @@ export const moduleBackend_FlowsActorsRegistry: {
377
376
  .describe('Always "one_time"; the assistant creates non-recurring todos.'),
378
377
  dueDate: z.string().optional()
379
378
  .describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
379
+ // The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
380
+ // and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
381
+ // lost answer does not add a second todo. Optional, like the operation's key.
382
+ idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
380
383
  }),
381
384
  }),
382
385
  // WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
@@ -458,20 +461,24 @@ curl -X POST https://your-app.example.com/api/v1/a2a \
458
461
 
459
462
  ## Tasks: when a turn becomes addressable
460
463
 
461
- A completed blocking turn returns a reply without a task row. A task makes work addressable
464
+ A completed blocking turn with no webhook returns a reply without a task row. A task makes work addressable
462
465
  beyond the original request; conversation history and task status are separate records.
463
466
 
464
467
  | Request or outcome | What it gets back | Task lifetime |
465
468
  |---|---|---|
466
469
  | Blocking `message/send` completes | A reply `Message` with conversation context | No task for that reply |
467
- | `configuration.blocking: false` | A `Task` with its own ID | Work continues independently of the request once the task is opened |
470
+ | A send carrying a webhook (`configuration.pushNotificationConfig`; 1.0: `configuration.taskPushNotificationConfig`) | A `Task`; a blocking send waits for the turn and returns it in its latest state | The webhook is registered on that task; a streamed send carrying one is refused |
471
+ | `configuration.blocking: false` (1.0: `configuration.returnImmediately: true`) | A `Task` with its own ID | Work continues independently of the request once the task is opened |
468
472
  | Direct `message/stream` completes | Message frames and the final reply | No background task; disconnect during generation aborts the turn |
469
473
  | Send or stream pauses for approval | A `Task` in `input-required`; a stream returns it in its terminal frame | The task reports the pause; the human decision uses the application's approval channel |
470
474
  | A message to a conversation still waiting for that decision | JSON-RPC error `-32015` (`DECISION_PENDING`) on every send mode, before any task is created; nothing runs or is written | The input the task waits for is the person's answer: wait for it, or `tasks/cancel`, which withdraws the decision. A decision raised in the instant between that check and a non-blocking turn ends the new task `failed` |
471
475
 
472
476
  These are the supported 0.2.5 request/state spellings. Other supported dialects use the corresponding
473
- projected names. If nonblocking task creation fails, the transport falls back to a blocking reply;
474
- check the result kind before using its ID as a task handle. An approval pause whose task cannot be
477
+ projected names. **A request is read in the dialect of its method**: a 1.0 `SendMessage` carries parts
478
+ with no `kind` (`{ text }`, `{ raw }`, `{ url }`, `{ data }`) and the role `ROLE_USER`, and the other
479
+ dialect's parts, role or non-blocking flag on a method are refused with `INVALID_PARAMS`. If nonblocking task creation fails, the transport falls back to a blocking reply (except for a
480
+ send carrying a webhook, which is refused instead); check the result kind before using its ID as a
481
+ task handle. An approval pause whose task cannot be
475
482
  created returns an error instead. Approval does not grant additional operation permissions.
476
483
 
477
484
  Reattaching a stream to an existing task is different from starting a direct message stream:
@@ -498,6 +505,21 @@ worth knowing because they surprise people:
498
505
  - **A task whose worker died reports `failed`, not `working`.** The engine holds a
499
506
  liveness lease while a turn runs; if the process serving it disappears, the task stops
500
507
  claiming to be in progress. You do not have to reconcile that yourself.
508
+ - **Every reply is written in the dialect the client called in.** A 1.0 `SendMessage` result and
509
+ each stream frame name one member, `{ task }` or `{ message }`, with no `kind` and the role
510
+ `ROLE_AGENT`; v0.2.5 sends the task or message bare. A push notification is written in the
511
+ dialect of the request that created its target: `{ statusUpdate }` in 1.0, a
512
+ `kind: 'status-update'` event with `final` in v0.2.5.
513
+ - **A webhook can ride the send.** `configuration.taskPushNotificationConfig` (1.0, no `taskId`) or
514
+ `configuration.pushNotificationConfig` (v0.2.5) is registered on the task the send opens, through
515
+ the same checks as the push-configuration methods. Such a send always opens a task; a blocking one
516
+ waits and answers with the task, and a streamed one is refused, since a stream opens no task.
517
+ - **A `failed` task says why, in a code a client can branch on.** `status.message.metadata.errorCode`
518
+ is the code the turn stored when it ended (`TURN_INTERRUPTED` when its worker died, `DECISION_LAPSED`
519
+ when the approval it waited on closed unanswered, `AGENT_SUSPENDED`, `MODEL_BUDGET_EXHAUSTED`, …), and
520
+ `metadata.rpcErrorCode` is the JSON-RPC error a blocking send would have answered. The text part
521
+ (`"<CODE>: <reason>"`) is for people; branch on the code. A task that is not `failed` carries no
522
+ status message. See `references/framework-flows-actors-a2a-contract.md` for the full contract.
501
523
 
502
524
  Your app does not implement any of this — it is served by the engine for every actor
503
525
  system you expose. What you control is which systems are exposed at all (above) and
@@ -109,7 +109,9 @@ the next turn — but do not describe it to a customer as a single-turn guarante
109
109
  * A flow run is refused BEFORE each of its model calls once its organization's allowance is spent or unverifiable: the
110
110
  * step fails with the budget's error, the run ends FAILED on that step, nothing of the step is written, and a
111
111
  * `MODEL_SPEND_LIMIT_REFUSED` row names the door `flow_step`. A flow's spend counts against the organization's
112
- * allowance, never a person's ceiling.
112
+ * allowance, never a person's ceiling. A call made in no turn and no flow but attributed to an organization is refused
113
+ * the same way, before it runs, through the door `organization_work` (#2957); its row names that organization and no
114
+ * person. A call attributed to no organization is neither charged nor refused.
113
115
  *
114
116
  * A call whose provider reported no token usage is charged an ESTIMATE (the characters it sent and received, at the
115
117
  * provider-documented four characters per token, plus a fixed figure per image), never nothing. RAG embeddings,
@@ -143,14 +145,18 @@ the next turn — but do not describe it to a customer as a single-turn guarante
143
145
  * which one (`MODEL_BUDGET_EXHAUSTED`, `PERSON_MODEL_CEILING_EXHAUSTED`, or the recoverable
144
146
  * `MODEL_BUDGET_UNVERIFIABLE`). Granting neither leaves in-app chat uncapped, as it was.
145
147
  *
146
- * ## Every refusal is recorded
148
+ * ## Every refusal leaves a record
147
149
  *
148
150
  * A turn either limit refuses, at any door, writes one `MODEL_SPEND_LIMIT_REFUSED` audit row: the door
149
151
  * (`initiationKind`), which limit (`ceiling`: `organization_budget` or `person_ceiling`), why (`reason`:
150
152
  * `allowance_exhausted`, `allowance_unverifiable` or `consumption_unverifiable`), and the allowance and consumption
151
153
  * when they were known. A call a unit ceiling refuses writes the same row with the unit's ceiling
152
154
  * (`embedding_token_ceiling`, `extraction_page_ceiling` or `screening_text_record_ceiling`), its counts in
153
- * `allowanceUnits` / `consumedUnits`, and the door only when the call was made in one. The actor is the person or machine whose turn it was, and the row's organization is the one
155
+ * `allowanceUnits` / `consumedUnits`, and the door only when the call was made in one. A unit call made in a turn or a
156
+ * flow writes one row per refusal; a call made in NEITHER (the embedding drain, an ingestion sweep, which re-ask a spent
157
+ * ceiling on every run) writes one row per organization, unit, reason and period in each process, and later refusals
158
+ * of the same combination are logged at DEBUG. A restart or a second process records it again, so it errs toward
159
+ * recording. The actor is the person or machine whose turn it was, and the row's organization is the one
154
160
  * whose allowance refused it. The gate writes it, not the door, so no door can refuse without a record. An autonomous
155
161
  * turn refused for spend writes it as well as its own `AUTONOMOUS_AGENT_TURN_REFUSED` row (reason `over_budget`).
156
162
  * An admitted turn writes none.
@@ -185,7 +191,8 @@ the next turn — but do not describe it to a customer as a single-turn guarante
185
191
  * we cannot prove the tenant is under it — the coherent choice for a spend boundary. This is safe
186
192
  * to fail closed precisely because the counter lives in the application's primary datastore: if
187
193
  * that is unreachable the application is down anyway, so this can never be the *sole* cause of an
188
- * outage (unlike a Redis blip, which is why the burst throttle fails OPEN instead).
194
+ * outage (unlike a Redis blip, which is why the burst throttle counts in process instead of refusing
195
+ * everyone, #3275).
189
196
  *
190
197
  * ## Overage tolerance
191
198
  *
@@ -125,22 +125,32 @@ one, and that is deliberate rather than a gap.
125
125
  * do with a turn your actor system runs.
126
126
  *
127
127
  * A task is materialised ONLY when a turn cannot complete inline:
128
- * - the client sent `configuration.blocking: false` (the A2A field — absent means blocking), or
128
+ * - the client asked not to block: `configuration.blocking: false` on v0.2.5, `configuration.returnImmediately: true`
129
+ * on 1.0 (absent means blocking in both), or
130
+ * - the send carries a webhook for its task (`configuration.pushNotificationConfig` on v0.2.5,
131
+ * `configuration.taskPushNotificationConfig` on 1.0, #3381): a blocking one waits for the turn and answers with the
132
+ * task, and a streamed one is refused, since a stream opens no task, or
129
133
  * - the turn reached an interrupted state (a human-in-the-loop approval pause).
130
134
  *
131
- * BOTH triggers are live. The interrupted-state arm needs a runtime that can pause a turn; that
135
+ * All three triggers are live. The interrupted-state arm needs a runtime that can pause a turn; that
132
136
  * is the human-in-the-loop approval gate, and a paused turn now materialises a task carrying
133
137
  * `input-required` on all three transports (blocking send, non-blocking send, stream). An earlier
134
138
  * revision of this note warned that the arm was inert and `input-required` never emitted — true
135
139
  * when written, and left here in corrected form because a reader who remembers the old claim would
136
140
  * otherwise conclude the state is decorative and safe to drop.
137
141
  *
138
- * A blocking turn that answers in one shot returns an A2A `Message` and writes no task
142
+ * A blocking turn that answers in one shot, with no webhook, returns an A2A `Message` and writes no task
139
143
  * row at all. Both shapes are protocol-conformant: the specification types the
140
144
  * `message/send` result as `Task | Message`, so returning either is conformance rather than a
141
145
  * shortcut. The inline case is the default so a chatty agent does not accumulate a row per turn.
142
146
  * spec-cite: A2A v0.2.5 §7.1 (SendMessageResponse result type)
143
147
  *
148
+ * Every reply is written in the dialect of the method called (#3378). In 1.0 a `SendMessage` result and every stream
149
+ * frame are a oneof object naming ONE member, `{ task }` or `{ message }`; a task, message or part carries no `kind`; a
150
+ * role is `ROLE_AGENT`; a text part is `{ text }`. In v0.2.5 the task or message is sent bare, told apart by `kind`.
151
+ * spec-cite: A2A v1.0.0 `specification/a2a.proto` — `message SendMessageResponse` / `message StreamResponse` (`oneof
152
+ * payload`), `message Part` (`oneof content`), `enum Role`.
153
+ *
144
154
  *
145
155
  * Once a task exists the client can poll it with `tasks/get` and stop it with
146
156
  * `tasks/cancel`. Cancel is a STATUS TRANSITION, never a delete: the spec requires it to
@@ -154,6 +164,19 @@ one, and that is deliberate rather than a gap.
154
164
  * cancel is best read as "stop as soon as the runtime is able", not "stop instantly".
155
165
  * The task record is the truth about the request either way.
156
166
  *
167
+ * **A `failed` task says why** (#3020). Its `status.message` is an agent message whose one text part reads
168
+ * `"<CODE>: <reason>"` and whose `metadata` is `{ errorCode, rpcErrorCode }`: `errorCode` is the
169
+ * `FlowsActors_ExecutionErrorCode` the turn stored when it ended (for a turn that ended live, the same code its stream
170
+ * sent), and `rpcErrorCode` is the JSON-RPC code a blocking send would have answered with. Branch on
171
+ * `metadata.errorCode`, never on the text: `TURN_INTERRUPTED` (the process serving the turn went away; sending again is
172
+ * safe; stored only, never sent live), `DECISION_LAPSED` (the human decision it waited on closed unanswered; stored
173
+ * only), `AGENT_SUSPENDED`, `MODEL_BUDGET_EXHAUSTED` and the other members each name a different remedy. A task that is
174
+ * not `failed` carries no status message from this server.
175
+ * spec-cite: A2A v0.2.5 `specification/json/a2a.json`, `TaskStatus.message` (optional, `$ref: Message`) and
176
+ * `Message.metadata` ("Extension metadata."); A2A v1.0.0 `specification/a2a.proto`, `message TaskStatus` / `message
177
+ * Message`. In the 1.0 dialect the message takes the proto's JSON mapping: `role: "ROLE_AGENT"`, no `kind`, and the
178
+ * `taskId` it belongs to; `metadata` is the same.
179
+ *
157
180
  * Import path: `@wildo-ai/saas-backend-lib`.
158
181
  */
159
182
  /**
@@ -75,7 +75,7 @@ is not established. Read the `ai-use-declaration` skill before choosing the valu
75
75
 
76
76
  | Declaration | Declare it when | Needs |
77
77
  |---|---|---|
78
- | `personalData: { treatment }` | always, on a language-model agent with tools or a conversation: `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
78
+ | `personalData: { treatment }` | always, on a language-model agent offered a tool or an MCP server (a treatment acts on what those return, so an agent with neither is sent only what its caller composes and needs none): `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
79
79
  | `promptInjection: { screening: THIRD_PARTY_CONTENT }` | the agent reads what somebody else wrote: shared records, documents, retrieved passages, an MCP answer, an inbound email | a provider selected for `EngineCapability.AI_CONTENT_SAFETY` |
80
80
  | `outputModeration: { blockAtOrAbove }` | what the agent writes reaches a person, a record or a message | the same provider |
81
81
 
@@ -83,8 +83,18 @@ A screening or moderation declaration with no content-safety provider makes the
83
83
  fails closed, by design, and it does so in EVERY environment that cannot serve it, so a provider and its
84
84
  secrets authored for `local` only leave the agent refusing every turn in staging and production. The
85
85
  backend warns at startup, one line per such agent, and `wildo local doctor` lists every authored
86
- environment that cannot serve it. Until the application selects a provider, declare `personalData`, and write one
87
- line at the agent saying which of the other two it will declare and why. A guardrail that cannot treat
86
+ environment that cannot serve it. On the development machine the classifier is usually a local double: the
87
+ provider's host secret names `127.0.0.1:<port>`, and `wildo local dev` starts the double on that port when the
88
+ application's root `package.json` declares `"@wildo-ai/provider-simulators": "*"` in its `devDependencies` (add it
89
+ in the same task that selects the provider). Without it nothing answers there, and every guarded turn is withheld
90
+ locally as `OUTPUT_NOT_MODERATED`. Two registry providers serve it: `azure-content-safety` screens and moderates
91
+ (its own Azure resource), `openai-moderation` moderates only, free, with an OpenAI key. An environment that is meant to
92
+ run without one (a staging stack with no key for it, while production has one) does not drop the declaration: it
93
+ states `agentContentGuardrails: { withoutClassifier: RUN_UNGUARDED, reason }` in its `wildo.infra.<env>.config.ts`, and
94
+ the agent runs unguarded there, named at startup. Never author that for an environment because a provider's setup is
95
+ pending; it is the operator's decision, and the infra-environment-config skill describes it. Until the application
96
+ selects a provider, declare `personalData`, and write one line at the agent saying which of the other two it will
97
+ declare and why. A guardrail that cannot treat
88
98
  anything (an agent with no tools and no conversation, fed only text your code composes) is not declared at
89
99
  all: a declaration that does nothing reads as a control. The contract and every refusal are in the
90
100
  `flows-actors-chat-assistant` skill, `references/framework-agent-content-guardrails-api.md`.
@@ -63,6 +63,33 @@ can be approved as proposed or denied; the answer says why (`modification_reject
63
63
  The approved write's audit row names the machine (`actorKind` MACHINE,
64
64
  `principalCredentialId`), the agent (`agentActor`, with the decision) and the reviewer who decided.
65
65
 
66
+ A call also has to run exactly as the reviewer read it. If the tool's input schema would drop, rewrite or fill in an
67
+ argument (an undeclared key, a `.trim()`, a `.default()` the reviewer removed), or a value cannot be used (a withheld
68
+ marker), the answer is refused while the decision stays pending, with `call_not_run_as_read` and the arguments to
69
+ correct on the live card, or with `arguments_cannot_be_corrected` where nothing the reviewer could enter would run, which
70
+ leaves only denying it. This holds for an edit, and for a proposal approved as it stands. So keep a gated tool's
71
+ schema free of value-changing transforms: what a reviewer reads is what is sealed, so it has to be what runs.
72
+
73
+ An approval is also refused, with `call_cannot_run`, when the call could not run as things stand: its agent or tool is
74
+ gone, the agent is switched off or suspended, the tool's approval route no longer admits this requester, an organization
75
+ tightened its content policy since the pause, or one of those could not be read. The decision stays pending and denying
76
+ it stays open. If the resumed turn still ends with the call unrun, for something no check could see beforehand, the
77
+ decision stays accepted and the trail gains a `HUMAN_DECISION_ACCEPTED_CALL_NOT_RUN` row, even if the turn completed.
78
+
79
+ So an accepted decision says the person accepted, not that the action happened, and that row's absence does not prove it
80
+ did: a turn stopped by its owner, or a process that died, writes none. To report that an action happened, read what the
81
+ action left behind, such as the record it wrote or the tool's result in the conversation.
82
+
83
+ A reviewer cannot type a value into a field DECLARED as a credential (`.isPassword()`, `.isWriteOnlySecret()`, a
84
+ `CREDENTIALS` category), on the tool's input schema or any schema of its `argumentsResource`, at any depth. It is refused
85
+ under any treatment with `credential_not_accepted`, because a call's arguments are kept with the decision. This reads
86
+ declarations: a secret pasted into a free-text field is not caught, so declare the fields that hold one. If a reviewer has
87
+ to supply a secret, take it through the application's own secret handling, not through a tool argument.
88
+
89
+ The model is held to the same line. A tool offered to an agent cannot declare a credential among its arguments, and startup
90
+ refuses one that does. A gated call in which the model wrote a value into a field its `argumentsResource` declares as a
91
+ credential is denied without pausing, so no decision is raised on it.
92
+
66
93
  ## Why a run was refused
67
94
 
68
95
  Every refusal records `AUTONOMOUS_AGENT_TURN_REFUSED` and opens nothing. A repeated occurrence is not a
@@ -85,6 +85,12 @@ Same file. Author an `ActorSystem` (`kind: FlowActorSystem_Kind.ACTOR`,
85
85
  can list it) with one `actor` (`executionMode: Actor_ExecutionMode.AGENTIC`,
86
86
  `agentRef: <your agent ref>`). Its minimal `config` needs only `accessControl[]`
87
87
  + `riskLevel`. Register it under `flowActorSystemsFactoryMap[<systemRef>] = () => system`.
88
+ To open the assistant only to some people, add `roles` to its `accessControl` entry
89
+ (`[{ primaryScope: ResourcePrimaryScope.ORGANIZATIONS, roles: [CORE_ORG_ROLES.ORG_ADMIN] }]`):
90
+ every door that starts a turn (the application's chat, A2A, Slack or Teams, an
91
+ autonomous agent) refuses a person who holds none of them in the organization the
92
+ turn works in, with `SYSTEM_ROLE_NOT_HELD`, and records the refusal. Omit `roles` and
93
+ every member may talk to it. The same field gates a declared flow's `startFlow`.
88
94
 
89
95
  ### Step 3: Instantiate the grounding tools
90
96
  Same file. For each resource the agent should read, add
@@ -105,7 +111,9 @@ not just answer questions), add a `resourceWriteTool(<ResourceType>, op, { input
105
111
  alongside the read tools (`op` = `CoreResourceOperation.CREATE` | `.UPDATE`;
106
112
  `functionRef` = `resource.<resourceType>.<op>`, mirror it into `functionRefs`).
107
113
  Supply the model-facing `inputSchema` (the fields the model may set — never owner
108
- FKs or server-set fields; include `id` for updates). Writes run as the user under
114
+ FKs or server-set fields; include `id` for updates). A date argument is `z.date()`: the
115
+ model writes it as an RFC 3339 string, a person approving the call reads and may edit that text, and the tool
116
+ receives a `Date`. Writes run as the user under
109
117
  the resource's own create/update ACL (fail-closed), same as reads. Keep write tools
110
118
  grounded and non-destructive in the prompt (no silent bulk mutations). Same
111
119
  reference file.
@@ -154,7 +162,9 @@ where none can serve it the agent refuses every turn, the backend warns at start
154
162
  environment. To keep what it
155
163
  **writes** within a content policy (no hate, sexual content, violence or self-harm reaching a person, a record or a
156
164
  message), declare `contentGuardrails.outputModeration` with the severity to withhold per category. See
157
- `references/framework-agent-content-guardrails-api.md`.
165
+ `references/framework-agent-content-guardrails-api.md`. When a reply instead reads *"This reply couldn't be checked
166
+ against the content policy"*, the classifier is configured and did not answer (on a development machine, usually its
167
+ local double is not running): that reference's section of the same name diagnoses it from the turn's audit event.
158
168
 
159
169
  Every agent call leaves an **operation record** (`agentOperationRecords`): the model the provider answered with, each tool
160
170
  call and how it ended, what the guardrails decided and how the call ended, never what a tool returned. You write
@@ -197,7 +207,7 @@ is not established. Read the `ai-use-declaration` skill before choosing the valu
197
207
 
198
208
  | Declaration | Declare it when | Needs |
199
209
  |---|---|---|
200
- | `personalData: { treatment }` | always, on a language-model agent with tools or a conversation: `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
210
+ | `personalData: { treatment }` | always, on a language-model agent offered a tool or an MCP server (a treatment acts on what those return, so an agent with neither is sent only what its caller composes and needs none): `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
201
211
  | `promptInjection: { screening: THIRD_PARTY_CONTENT }` | the agent reads what somebody else wrote: shared records, documents, retrieved passages, an MCP answer, an inbound email | a provider selected for `EngineCapability.AI_CONTENT_SAFETY` |
202
212
  | `outputModeration: { blockAtOrAbove }` | what the agent writes reaches a person, a record or a message | the same provider |
203
213
 
@@ -205,8 +215,18 @@ A screening or moderation declaration with no content-safety provider makes the
205
215
  fails closed, by design, and it does so in EVERY environment that cannot serve it, so a provider and its
206
216
  secrets authored for `local` only leave the agent refusing every turn in staging and production. The
207
217
  backend warns at startup, one line per such agent, and `wildo local doctor` lists every authored
208
- environment that cannot serve it. Until the application selects a provider, declare `personalData`, and write one
209
- line at the agent saying which of the other two it will declare and why. A guardrail that cannot treat
218
+ environment that cannot serve it. On the development machine the classifier is usually a local double: the
219
+ provider's host secret names `127.0.0.1:<port>`, and `wildo local dev` starts the double on that port when the
220
+ application's root `package.json` declares `"@wildo-ai/provider-simulators": "*"` in its `devDependencies` (add it
221
+ in the same task that selects the provider). Without it nothing answers there, and every guarded turn is withheld
222
+ locally as `OUTPUT_NOT_MODERATED`. Two registry providers serve it: `azure-content-safety` screens and moderates
223
+ (its own Azure resource), `openai-moderation` moderates only, free, with an OpenAI key. An environment that is meant to
224
+ run without one (a staging stack with no key for it, while production has one) does not drop the declaration: it
225
+ states `agentContentGuardrails: { withoutClassifier: RUN_UNGUARDED, reason }` in its `wildo.infra.<env>.config.ts`, and
226
+ the agent runs unguarded there, named at startup. Never author that for an environment because a provider's setup is
227
+ pending; it is the operator's decision, and the infra-environment-config skill describes it. Until the application
228
+ selects a provider, declare `personalData`, and write one line at the agent saying which of the other two it will
229
+ declare and why. A guardrail that cannot treat
210
230
  anything (an agent with no tools and no conversation, fed only text your code composes) is not declared at
211
231
  all: a declaration that does nothing reads as a control. The contract and every refusal are in the
212
232
  `flows-actors-chat-assistant` skill, `references/framework-agent-content-guardrails-api.md`.
@@ -475,11 +495,10 @@ export const moduleBackend_FlowsActorsRegistry: {
475
495
  // owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
476
496
  // DTO coerces the ISO `dueDate` string to a Date at the service boundary.
477
497
  //
478
- // `recurringType` IS supplied (pinned to ONE_TIME): todos is a discriminated-union inheritance
479
- // resource (one-time / recurring), so its CREATE DTO REQUIRES the `recurringType` discriminator
480
- // to select a variant — omitting it fails with "no matching discriminator". The assistant only
481
- // creates NON-recurring todos, so we default it to ONE_TIME (the model need not supply it) and
482
- // use a literal so the model cannot select the recurring variant, whose extra fields
498
+ // `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
499
+ // resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
500
+ // left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
501
+ // states that: the model cannot select the recurring variant, whose extra fields
483
502
  // (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
484
503
  // defaulted (not merely optional) so they are always present for the discriminated base branch.
485
504
  resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
@@ -498,6 +517,10 @@ export const moduleBackend_FlowsActorsRegistry: {
498
517
  .describe('Always "one_time"; the assistant creates non-recurring todos.'),
499
518
  dueDate: z.string().optional()
500
519
  .describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
520
+ // The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
521
+ // and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
522
+ // lost answer does not add a second todo. Optional, like the operation's key.
523
+ idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
501
524
  }),
502
525
  }),
503
526
  // WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
@@ -565,7 +588,7 @@ export const moduleBackend_FlowsActorsRegistry: {
565
588
  - `references/framework-present-records-tool-api.md` — `presentRecordsTool()`: the agent shows its person records as summary cards in the conversation, kept as a reference and fetched with the viewer's session
566
589
  - `references/framework-retrieval-tool-api.md` — `retrievalTool()`: the agent searches your `.ragSource()` fields as its person, cites the record and field of each passage, and reads `outcome` before answering
567
590
  - `references/framework-ask-person-tool-api.md` — `askPersonTool()`: the agent pauses its turn to ask its person a structured question, answered through a form, and gets typed answers back
568
- - `references/framework-agent-content-guardrails-api.md` — `contentGuardrails.personalData` (what the model is sent in place of a personal field's value, who reads the real values back, the `personalDataOutput` every tool declares), `contentGuardrails.promptInjection` (screening what others wrote before the model reads it), `contentGuardrails.outputModeration` (judging what the model writes before anyone reads, stores or sends it) and `argumentsResource` on every write tool (what a guarded write may store)
591
+ - `references/framework-agent-content-guardrails-api.md` — `contentGuardrails.personalData` (what the model is sent in place of a personal field's value, who reads the real values back, the `personalDataOutput` every tool declares), `contentGuardrails.promptInjection` (screening what others wrote before the model reads it), `contentGuardrails.outputModeration` (judging what the model writes before anyone reads, stores or sends it), `argumentsResource` on every write tool (what a guarded write may store), and how to diagnose a reply withheld because the classifier did not answer (`OUTPUT_NOT_MODERATED`, the local double `wildo local dev` starts)
569
592
  - `references/framework-agent-suspension-api.md` — an administrator's runtime off switch for one agent: who may suspend and resume it (an organization's administrator, or the application's super-administrator for everybody), what a suspended agent's caller and conversation see, what is audited, and what a suspension does not stop
570
593
  - `references/framework-agent-operation-record-api.md` — the `agentOperationRecords` row every agent call leaves: the model the provider reported, each tool call and how it ended, the guardrail verdicts and the end, never a tool's result; how to read it per run and as counts through the evidence door, and its retention
571
594
  - `references/framework-agent-behavior-reports-api.md` — a person reports an agent's reply from the conversation (a closed category, an optional comment; the report points at the reply and never copies it), the organization's administrators triage, resolve or dismiss it against declared deadlines, and how it is audited, erased and measured
@@ -215,11 +215,10 @@ export const moduleBackend_FlowsActorsRegistry: {
215
215
  // owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
216
216
  // DTO coerces the ISO `dueDate` string to a Date at the service boundary.
217
217
  //
218
- // `recurringType` IS supplied (pinned to ONE_TIME): todos is a discriminated-union inheritance
219
- // resource (one-time / recurring), so its CREATE DTO REQUIRES the `recurringType` discriminator
220
- // to select a variant — omitting it fails with "no matching discriminator". The assistant only
221
- // creates NON-recurring todos, so we default it to ONE_TIME (the model need not supply it) and
222
- // use a literal so the model cannot select the recurring variant, whose extra fields
218
+ // `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
219
+ // resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
220
+ // left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
221
+ // states that: the model cannot select the recurring variant, whose extra fields
223
222
  // (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
224
223
  // defaulted (not merely optional) so they are always present for the discriminated base branch.
225
224
  resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
@@ -238,6 +237,10 @@ export const moduleBackend_FlowsActorsRegistry: {
238
237
  .describe('Always "one_time"; the assistant creates non-recurring todos.'),
239
238
  dueDate: z.string().optional()
240
239
  .describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
240
+ // The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
241
+ // and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
242
+ // lost answer does not add a second todo. Optional, like the operation's key.
243
+ idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
241
244
  }),
242
245
  }),
243
246
  // WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
@@ -217,8 +217,8 @@ export enum AgentBehaviorReportRemedyKind {
217
217
 
218
218
  /** A resolution's link to its remedy. A reference, never a copy of what changed. */
219
219
  export const AgentBehaviorReportRemedyRefSchema = z.strictObject({
220
- kind: z.enum(AgentBehaviorReportRemedyKind).systemEnum('AgentBehaviorReportRemedyKind'),
221
- ref: z.string().trim().min(1).max(200),
220
+ kind: z.enum(AgentBehaviorReportRemedyKind).systemEnum('AgentBehaviorReportRemedyKind').describe('What the remedy is: `guardrail_event`, the audit event of a guardrail decision that now catches the behaviour, or `agent_configuration_change`, the change made to the agent (an agent-policy change\'s audit event, or the release that changed its configuration).'),
221
+ ref: z.string().trim().min(1).max(200).describe('The remedy\'s reference: the audit event id for `guardrail_event`, the audit event id or release reference for `agent_configuration_change`. A reference, never a copy of what changed.'),
222
222
  });
223
223
  export type AgentBehaviorReportRemedyRef = z.infer<typeof AgentBehaviorReportRemedyRefSchema>;
224
224
 
@@ -313,8 +313,12 @@ export const AgentBehaviorReportSchema = z.object({
313
313
  /** The stored message the report is about, sent by the reporter: an agent's reply in that conversation. */
314
314
  turnMessageId: z.string().min(1).max(200).excludeFromUpdate().isAuditEvidence().portabilityProvenance(DataPortabilityProvenance.SUBJECT_PROVIDED)
315
315
  .dataCategories(PersonalDataCategory.USAGE),
316
- /** The actor system the conversation runs, read from the conversation when the report is received. */
317
- systemRef: z.string().min(1).max(200).excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
316
+ /**
317
+ * The actor system the conversation runs, read from the conversation when the report is received. A summary field: a
318
+ * report is labelled by its agent, else by this system, and a report on a system with no named agent kept no name on
319
+ * its card while this was not carried (the label sweep, #2329 widened by #3066 review L1).
320
+ */
321
+ systemRef: z.string().min(1).max(200).isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
318
322
  /** The agent that answered in it, when the system names a conversational agent. */
319
323
  agentRef: z.string().min(1).max(200).optional().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
320
324
  /** When the reported reply was produced, read from the stored message when the report was received. */
@@ -412,13 +416,13 @@ export type AgentBehaviorReportDismissDto = z.infer<typeof AgentBehaviorReportDi
412
416
  * erased with their account): the report never kept a copy, so there is nothing else to show.
413
417
  */
414
418
  export const AgentBehaviorReportedTurnSchema = z.object({
415
- available: z.boolean(),
419
+ available: z.boolean().describe('`false` when the conversation or the reply no longer exists (deleted by the reporter, or erased with their account). The report never kept a copy, so nothing else is returned.'),
416
420
  /** The person's message the reply answered, when the conversation still holds one before it, and when it was sent. */
417
- prompt: z.string().optional(),
418
- promptAt: z.date().optional(),
421
+ prompt: z.string().optional().describe('The person\'s message the reply answered, when the conversation still holds one before it.'),
422
+ promptAt: z.date().optional().describe('When that message was sent.'),
419
423
  /** The agent's reply, as the person read it (Markdown when the agent answered in Markdown), and when it was produced. */
420
- reply: z.string().optional(),
421
- replyAt: z.date().optional(),
424
+ reply: z.string().optional().describe('The agent\'s reply as the person read it, in Markdown when the agent answered in Markdown.'),
425
+ replyAt: z.date().optional().describe('When the reply was produced.'),
422
426
  });
423
427
  export type AgentBehaviorReportedTurn = z.infer<typeof AgentBehaviorReportedTurnSchema>;
424
428
  ```