@wildo-ai/framework-knowledge 1.1.11 → 1.1.12

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 (803) 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 +170 -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 +29 -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 +80 -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 +51 -7
  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 +10 -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/playbook.json +10 -6
  272. package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
  273. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
  274. package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
  275. package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
  276. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
  277. package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
  278. package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
  279. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
  280. package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
  281. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
  282. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
  283. package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
  284. package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
  285. package/dist/knowledge/references/application-maturity.config.md +27 -1
  286. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
  287. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
  288. package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
  289. package/dist/knowledge/references/brand.name-screening.config.md +30 -3
  290. package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
  291. package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
  292. package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
  293. package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
  294. package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
  295. package/dist/knowledge/references/companion.market.generation-service.md +46 -5
  296. package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
  297. package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
  298. package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
  299. package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
  300. package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
  301. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
  302. package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
  303. package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
  304. package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
  305. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
  306. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
  307. package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
  308. package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
  309. package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
  310. package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
  311. package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
  312. package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
  313. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
  314. package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
  315. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
  316. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
  317. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
  318. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
  319. package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
  320. package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
  321. package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
  322. package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
  323. package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
  324. package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
  325. package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
  326. package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
  327. package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
  328. package/dist/knowledge/references/example.website.section.stats.md +1 -1
  329. package/dist/knowledge/references/experience-plan.config.md +111 -1
  330. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
  331. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
  332. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
  333. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
  334. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
  335. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
  336. package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
  337. package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
  338. package/dist/knowledge/references/integration-plan.config.md +7 -7
  339. package/dist/knowledge/references/placement-plan.config.md +19 -0
  340. package/dist/knowledge/references/platform.config.backing-services.md +9 -11
  341. package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
  342. package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
  343. package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
  344. package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
  345. package/dist/knowledge/references/platform.config.saas.md +20 -18
  346. package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
  347. package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
  348. package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
  349. package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
  350. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
  351. package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
  352. package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
  353. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
  354. package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
  355. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
  356. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
  357. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
  358. package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
  359. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
  360. package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
  361. package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
  362. package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
  363. package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
  364. package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
  365. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
  366. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
  367. package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
  368. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
  369. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
  370. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
  371. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
  372. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
  373. package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
  374. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
  375. package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
  376. package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
  377. package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
  378. package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
  380. package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
  381. package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
  382. package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
  383. package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
  384. package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
  385. package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
  386. package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
  387. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
  388. package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
  389. package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
  390. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
  391. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
  392. package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
  393. package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
  394. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
  395. package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
  396. package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
  397. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
  398. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
  399. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
  400. package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
  401. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
  402. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
  403. package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
  404. package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
  405. package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
  406. package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
  407. package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
  408. package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
  409. package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
  410. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
  411. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
  412. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
  413. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
  414. package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
  415. package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
  416. package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
  417. package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
  418. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
  419. package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
  420. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
  421. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
  422. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
  423. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
  424. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
  425. package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
  426. package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
  427. package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
  428. package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
  429. package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
  430. package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
  431. package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
  432. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
  433. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
  434. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
  435. package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
  436. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
  437. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
  438. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
  439. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
  440. package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
  441. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
  442. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
  443. package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
  444. package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
  445. package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
  446. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
  447. package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
  448. package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
  449. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
  450. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
  451. package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
  452. package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
  453. package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
  454. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
  455. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
  456. package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
  457. package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
  458. package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
  459. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
  460. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
  461. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
  462. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
  463. package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
  464. package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
  465. package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
  466. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
  467. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
  468. package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
  469. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
  470. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
  471. package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
  472. package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
  473. package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
  474. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
  475. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
  476. package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
  477. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
  478. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
  479. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
  480. package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
  481. package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
  482. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
  483. package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
  484. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
  485. package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
  486. package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
  487. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
  488. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
  489. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
  490. package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
  491. package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
  492. package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
  493. package/dist/knowledge/references/service-method.config.md +35 -2
  494. package/dist/knowledge/references/vision.constraint.config.md +4 -2
  495. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
  496. package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
  497. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
  498. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
  499. package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
  500. package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
  501. package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
  502. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
  503. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
  504. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
  505. package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
  506. package/dist/knowledge/references/zod.factories.code.md +4 -4
  507. package/dist/knowledge/references/zod.factories.duration.md +4 -4
  508. package/dist/knowledge/references/zod.factories.money.md +4 -4
  509. package/dist/knowledge/references/zod.factories.phone.md +4 -4
  510. package/dist/knowledge/references/zod.factories.year-month.md +79 -0
  511. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  512. package/dist/knowledge/registries/framework-topics.json +415 -2
  513. package/dist/knowledge/registries/playbooks.json +51 -39
  514. package/dist/knowledge/registries/source-tags.json +2412 -1604
  515. package/dist/knowledge/rules/database-migration-obligation.md +6 -7
  516. package/dist/knowledge/rules/live-context-door.md +1 -1
  517. package/dist/knowledge/skills/INDEX.md +3 -1
  518. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
  519. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
  520. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
  521. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
  522. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
  523. package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
  524. package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
  525. package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
  526. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
  527. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
  528. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
  529. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
  530. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
  531. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
  532. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
  533. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
  534. package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
  535. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
  536. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
  537. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
  538. package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
  539. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
  540. package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
  541. package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
  542. package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
  543. package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
  544. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
  545. package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
  546. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
  547. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
  548. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
  549. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
  550. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
  551. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
  552. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
  553. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
  554. package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
  555. package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
  556. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
  557. package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
  558. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
  559. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
  560. package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
  561. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
  562. package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
  563. package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
  564. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
  565. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
  566. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
  567. package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
  568. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
  569. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
  570. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
  571. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
  572. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
  573. package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
  574. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
  575. package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
  576. package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
  577. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
  578. package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
  579. package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
  580. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
  581. package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
  582. package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
  583. package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
  584. package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
  585. package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
  586. package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
  587. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
  588. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
  589. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
  590. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
  591. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
  592. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
  593. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
  594. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
  595. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
  596. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
  597. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
  598. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
  599. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
  600. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
  601. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
  602. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
  603. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
  604. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
  605. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
  606. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
  607. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
  608. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
  609. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
  610. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
  611. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
  612. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
  613. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
  614. package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
  615. package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
  616. package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
  617. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
  618. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
  619. package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
  620. package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
  621. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
  622. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
  623. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
  624. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
  625. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
  626. package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
  627. package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
  628. package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
  629. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
  630. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
  631. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
  632. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
  633. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
  634. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
  635. package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
  636. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
  637. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
  638. package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
  639. package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
  640. package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
  641. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
  642. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
  643. package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
  644. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
  645. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
  646. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
  647. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
  648. package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
  649. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
  650. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
  651. package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
  652. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
  653. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
  654. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
  655. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
  656. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
  657. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
  658. package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
  659. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
  660. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
  661. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
  662. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
  663. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
  664. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
  665. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
  666. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
  667. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
  668. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
  669. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
  670. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
  671. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
  672. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
  673. package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
  674. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
  675. package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
  676. package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
  677. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
  678. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
  679. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
  680. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
  681. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
  682. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
  683. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
  684. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
  685. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
  686. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
  687. package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
  688. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
  689. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
  690. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
  691. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
  692. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
  693. package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
  694. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
  695. package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
  696. package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
  697. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
  698. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
  699. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
  700. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
  701. package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
  702. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
  703. package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
  704. package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
  705. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
  706. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
  707. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
  708. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
  709. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
  710. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
  711. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
  712. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
  713. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
  714. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
  715. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
  716. package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
  717. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
  718. package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
  719. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
  720. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
  721. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
  722. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  723. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
  724. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
  725. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
  726. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
  727. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
  728. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
  729. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
  730. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
  731. package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
  732. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
  733. package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
  734. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
  735. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
  736. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
  737. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
  738. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
  739. package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
  740. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
  741. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
  742. package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
  743. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
  744. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
  745. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
  746. package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
  747. package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
  748. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
  749. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
  750. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
  751. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
  752. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
  753. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
  754. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
  755. package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
  756. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
  757. package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
  758. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
  759. package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
  760. package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
  761. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
  762. package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
  763. package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
  764. package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
  765. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
  766. package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
  767. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
  768. package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
  769. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
  770. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
  771. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
  772. package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
  773. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
  774. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
  775. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
  776. package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
  777. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
  778. package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
  779. package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
  780. package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
  781. package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
  782. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
  783. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
  784. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
  785. package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
  786. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
  787. package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
  788. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
  789. package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
  790. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
  791. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
  792. package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
  793. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
  794. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
  795. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
  796. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
  797. package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
  798. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
  799. package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
  800. package/dist/knowledge/topic-index.json +2275 -715
  801. package/dist/tsconfig.build.tsbuildinfo +1 -1
  802. package/package.json +6 -6
  803. package/dist/tsconfig.tsbuildinfo +0 -1
@@ -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
 
@@ -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.
@@ -197,7 +205,7 @@ is not established. Read the `ai-use-declaration` skill before choosing the valu
197
205
 
198
206
  | Declaration | Declare it when | Needs |
199
207
  |---|---|---|
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 |
208
+ | `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
209
  | `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
210
  | `outputModeration: { blockAtOrAbove }` | what the agent writes reaches a person, a record or a message | the same provider |
203
211
 
@@ -475,11 +483,10 @@ export const moduleBackend_FlowsActorsRegistry: {
475
483
  // owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
476
484
  // DTO coerces the ISO `dueDate` string to a Date at the service boundary.
477
485
  //
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
486
+ // `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
487
+ // resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
488
+ // left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
489
+ // states that: the model cannot select the recurring variant, whose extra fields
483
490
  // (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
484
491
  // defaulted (not merely optional) so they are always present for the discriminated base branch.
485
492
  resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
@@ -498,6 +505,10 @@ export const moduleBackend_FlowsActorsRegistry: {
498
505
  .describe('Always "one_time"; the assistant creates non-recurring todos.'),
499
506
  dueDate: z.string().optional()
500
507
  .describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
508
+ // The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
509
+ // and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
510
+ // lost answer does not add a second todo. Optional, like the operation's key.
511
+ idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
501
512
  }),
502
513
  }),
503
514
  // WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
@@ -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
  ```
@@ -34,7 +34,10 @@ Read this when:
34
34
  personal data, only not in clear: pseudonymised data is still personal data.
35
35
  3. The treatment is applied where the model is sent each tool result, so the person's view of the turn (the tool
36
36
  calls, the cards, the cited sources) keeps the real values. A tool that fails tells the model the kind of failure,
37
- never its text, because an error message can quote a value.
37
+ never its text, because an error message can quote a value. The same holds for arguments an approver edits before
38
+ approving a paused call: the write receives the approver's values, and the model's copy of the call carries the
39
+ personal fields of `argumentsResource` as the treatment (a withheld marker under `REMOVE`). A person's answer to a
40
+ question the agent asked is their own words and reaches the model as given, like their message.
38
41
  4. Who reads the real values back: the person whose turn it is (their socket session, or a chat message from their
39
42
  linked account). An A2A client's turn and an autonomous turn keep the placeholders, because another model reading
40
43
  them is a disclosure. Declare `reidentifyForMachineReaders: true` only when that disclosure is intended.
@@ -192,7 +195,29 @@ What follows from it:
192
195
  - A conversation that started before the treatment did keeps its earlier replies from the model: they were written
193
196
  untreated, so a treated turn sends each as a notice that it was withheld (the person still reads them). An action
194
197
  paused for approval under a weaker treatment does not resume (`CONTENT_POLICY_TIGHTENED`); asking again starts afresh.
195
- - A turn acting for no organization (an application-scope caller) applies no tenant policy.
198
+ - A record a tool returns is treated under the policy of the organization that owns it too, the stricter of the two.
199
+ This is what protects an organization's records read by a turn acting for another organization or for none (an
200
+ application-scope caller, whose agent no tenant policy tightens). On a turn whose agent has no treatment, such a row is
201
+ withheld (`REMOVE`) even when its owner asked for `TOKENIZE`, because nothing on that turn can put a placeholder back,
202
+ and a write carrying the withheld value is refused. Prompt-injection screening is decided per record too: a record
203
+ whose owner screens is screened before the model reads it, and withheld if it is not found clean, even when the turn
204
+ screens nothing. And a placeholder for a record whose owner sets `machineReadersKeepPlaceholders` stays a placeholder
205
+ for a machine reader (A2A, autonomous) even when the agent gives machine readers the values back; the person whose
206
+ turn it is still reads the value. A reply is moderated under the strictest output policy of every organization whose
207
+ records reached the model in that turn, and the turn's own, even when the agent declares no moderation; a reply that
208
+ cannot be judged in what an owner asked is withheld.
209
+ - So the engine must know whose record each row is. A row that keeps its `organizationId` says so. A tool you write may
210
+ return only the fields it needs; when it reaches its records through `dispatchResourceOperationAsTool` (and declares
211
+ the `PRINCIPAL_RESOURCE_OPERATION` authority), the engine still knows, because each dispatch records the organization
212
+ of every row it read: the row is treated under its own organization's policy when it keeps its `_id`, else under the
213
+ strictest policy of the organizations the call reached. That holds only while the operations it dispatches return rows
214
+ naming their organization; a custom operation whose answer names none leaves the call's rows to the strictest policy.
215
+ A tool reaching its records any other way (an internal
216
+ transition, a service) must return each row's `organizationId` and declare
217
+ `personalDataOutput: { kind: RECORDS_OF_RESOURCE, resourceType, rowsNameTheirOrganization: true }`. Startup warns
218
+ about every tool offered to an agent that does neither. A row whose organization cannot be known, read by an agent
219
+ acting in no organization, reaches the model under the strictest policy (personal data withheld, screened, the reply
220
+ moderated in every category), and is counted on the call's operation record (`rowsOwnerNotDerived`).
196
221
 
197
222
  ## Import Origins
198
223
 
@@ -240,6 +265,21 @@ export type OrganizationAgentPolicy = z.infer<typeof OrganizationAgentPolicySche
240
265
 
241
266
  - Text you compose and pass to the agent yourself (its input messages, its instructions): the engine cannot tell which
242
267
  of your words are personal data. Do not paste record values into a prompt for a guarded agent; give it a tool.
268
+ - Text a reviewer types into an approval's edit, in a field that declares no personal-data category: it reaches the model as
269
+ written, like a chat message from that person. The engine cannot tell which of their words are personal, and refusing or
270
+ rewriting a person's sentence is not its call. So declare a category on any free-text argument that may hold a name
271
+ (`.dataCategories(...)` on that field of the tool's `argumentsResource`): the field is then treated like a record's. A string the
272
+ reviewer left as the card showed it stays the model's, in the model's form, so editing one argument does not hand the
273
+ others back in clear; a placeholder the model wrote in a field that cannot hold it is refused, edited or not.
274
+ - Secrets outside a declared field. A tool cannot declare a credential among its arguments: startup refuses it, because its
275
+ schema is what the model is asked to fill and a call's arguments are kept with the decision and the trace. A value the
276
+ model writes into a field the tool's `argumentsResource` declares as a credential is withheld from the trace and from any
277
+ pause, and a gated call is denied instead of paused. An ungated tool still runs with it, so leave such a field out of a
278
+ tool's arguments. A schema that renames such a field defeats the reading too, because the new name is declared by nothing: the
279
+ live progress shows it, and on an ungated tool the trace keeps it. What no declaration covers is out of reach: a secret in a free-text argument, a
280
+ person's chat message, an answer to the agent's question, or a reason given on a decision. The engine cannot tell those
281
+ words from any others, so take a secret through your application's own secret handling or a connected account, and let the
282
+ tool read it.
243
283
  - What an MCP tool returns, field by field, for `personalData`: it comes from another system with no schema to read. Under
244
284
  a treatment, declared or set by an organization's policy, the model is sent an MCP result withheld whole (an error
245
285
  result by its kind only), so a guarded agent cannot use what an MCP server answers. The person still sees it. Without a
@@ -249,8 +289,8 @@ export type OrganizationAgentPolicy = z.infer<typeof OrganizationAgentPolicySche
249
289
  - A long text is screened in overlapping pieces, so an instruction of up to 1,000 characters is always whole in one of
250
290
  them; a longer one may be split across two.
251
291
  - For `outputModeration`: a chunk of a streamed reply that passed is not taken back when a later chunk is withheld — the
252
- person keeps what they already saw. A reloaded conversation, and a reply posted to Slack or Microsoft Teams, show the
253
- turn as failed without saying it was withheld (the stored turn carries no failure code).
292
+ person keeps what they already saw. The ended turn stores its code (`OUTPUT_WITHHELD`), so a reloaded conversation, a
293
+ reply posted to Slack or Microsoft Teams, and an A2A task read later all say the reply was withheld, as the live turn did.
254
294
  - Coding agents and image agents: their output is not text a classifier judges (a coding run's change set is accepted
255
295
  by a person through a commit).
256
296
  - Tool arguments an APPROVER edits before approving (approve-with-modification): they are the approver's own words, on
@@ -113,6 +113,13 @@ export const AgentOperationToolCallSchema = z.object({
113
113
  * Absent when the agent screens nothing, and for an empty result (released without a screening, carrying no text).
114
114
  */
115
115
  screening: z.enum(ContentSafetyScreeningOutcome).systemEnum('ContentSafetyScreeningOutcome').optional(),
116
+ /**
117
+ * RESULT (#3369): what reached the model under the strictest agent policy because nothing the engine observed could say
118
+ * whose it was, read by tools acting in no organization. For a tool returning records, the rows of an
119
+ * organization-owned resource that named no organization; for a tool that treats its own output (whose rows never name
120
+ * one), 1 for the whole result. A count, never the content; absent when every owner was known.
121
+ */
122
+ rowsOwnerNotDerived: z.number().int().min(1).optional(),
116
123
  });
117
124
  export type AgentOperationToolCall = z.infer<typeof AgentOperationToolCallSchema>;
118
125
 
@@ -39,7 +39,9 @@ composes `RESOURCES_FRONTEND_ADMIN_APP` beside the tenant scope.
39
39
  the same way when the application's id cannot be resolved.
40
40
  - A conversation turn ends with `FlowsActors_ExecutionErrorCode.AGENT_SUSPENDED`; the thread says the assistant was
41
41
  switched off (`agentSuspended`), and an A2A client receives the JSON-RPC code `-32018` on a blocking `message/send` or
42
- `message/stream`. A client that reads the failed task back later sees a plain failure, without the code.
42
+ `message/stream`. The ended turn stores the code, so a reloaded conversation and a chat platform's reply say it too, and
43
+ a client reading the failed task back (`tasks/get`) finds it in the task's status message:
44
+ `metadata.errorCode` (`AGENT_SUSPENDED`) and `metadata.rpcErrorCode` (`-32018`).
43
45
  - Each refused call leaves one `SUSPENDED_AGENT_CALL_REFUSED` audit row naming the agent, the scope and the door, when
44
46
  the call was made in a conversation or a flow run. The row is written best-effort: a failed write is logged, and the
45
47
  refusal stands.
@@ -116,13 +118,13 @@ export enum AgentSuspensionChangeRefusal {
116
118
  */
117
119
  export const AgentSuspensionEntrySchema = z.object({
118
120
  /** The suspended agent's declared ref (`FlowsActors_Agent.ref`). */
119
- agentRef: z.string().min(1).max(200),
121
+ agentRef: z.string().min(1).max(200).describe('The suspended agent\'s declared ref.'),
120
122
  /** The user who suspended it. Absent once that person was erased. */
121
- suspendedBy: z.string().min(1).optional(),
123
+ suspendedBy: z.string().min(1).optional().describe('The user who suspended it. Absent once that person was erased; the suspension stays in force.'),
122
124
  /** Why, in the administrator's words: shown to the other administrators and kept on the audit trail. */
123
- reason: z.string().trim().min(1).max(1000),
125
+ reason: z.string().trim().min(1).max(1000).describe('Why, in the administrator\'s words. Shown to the other administrators and kept on the audit trail.'),
124
126
  /** When it was suspended (ISO 8601). */
125
- at: z.iso.datetime(),
127
+ at: z.iso.datetime().describe('When it was suspended (ISO 8601).'),
126
128
  });
127
129
  export type AgentSuspensionEntry = z.infer<typeof AgentSuspensionEntrySchema>;
128
130
 
@@ -131,15 +133,15 @@ export const AgentSuspensionEntriesSchema = z.array(AgentSuspensionEntrySchema).
131
133
 
132
134
  /** What `suspendAgent` takes, on either policy: the agent and why. */
133
135
  export const AgentSuspension_SuspendRequestSchema = z.object({
134
- agentRef: AgentSuspensionEntrySchema.shape.agentRef,
135
- reason: AgentSuspensionEntrySchema.shape.reason,
136
+ agentRef: AgentSuspensionEntrySchema.shape.agentRef.describe('The declared ref of the agent to suspend.'),
137
+ reason: AgentSuspensionEntrySchema.shape.reason.describe('Why it is suspended, in your words. Shown to the other administrators and kept on the audit trail.'),
136
138
  });
137
139
  export type AgentSuspension_SuspendRequest = z.infer<typeof AgentSuspension_SuspendRequestSchema>;
138
140
 
139
141
  /** What `resumeAgent` takes, on either policy: the agent and why it may run again. */
140
142
  export const AgentSuspension_ResumeRequestSchema = z.object({
141
- agentRef: AgentSuspensionEntrySchema.shape.agentRef,
142
- reason: AgentSuspensionEntrySchema.shape.reason,
143
+ agentRef: AgentSuspensionEntrySchema.shape.agentRef.describe('The declared ref of the suspended agent to resume.'),
144
+ reason: AgentSuspensionEntrySchema.shape.reason.describe('Why it may run again, in your words. Kept on the audit trail.'),
143
145
  });
144
146
  export type AgentSuspension_ResumeRequest = z.infer<typeof AgentSuspension_ResumeRequestSchema>;
145
147
  ```
@@ -108,6 +108,27 @@ export enum AuditActorKind {
108
108
  UNATTRIBUTED = 'unattributed',
109
109
  }
110
110
 
111
+ /**
112
+ * WHICH kind of machine credential an audit row's `principalCredentialId` names (#3445): an API key or an OAuth client,
113
+ * of an organization or of the application. Each is its own resource, so the id alone does not say where to look, and
114
+ * a row that recorded only the id could be named only by guessing across all four.
115
+ *
116
+ * Recorded by `_createAuditLog` beside the id, from the credential's authentication method and the machine's execution
117
+ * type, and never supplied by an emitter. Absent where neither is known: a shared platform secret named by its stable
118
+ * name, a platform service's own key, and every row written before the field existed. Those rows show the id they
119
+ * recorded.
120
+ */
121
+ export enum AuditMachineCredentialKind {
122
+ /** An organization's API key (`organizationApiKeys`). */
123
+ ORGANIZATION_API_KEY = 'organization_api_key',
124
+ /** The application's API key (`applicationApiKeys`). */
125
+ APPLICATION_API_KEY = 'application_api_key',
126
+ /** An organization's OAuth client, acting as itself with client credentials (`organizationOAuthClients`). */
127
+ ORGANIZATION_OAUTH_CLIENT = 'organization_oauth_client',
128
+ /** The application's OAuth client, acting as itself with client credentials (`applicationOAuthClients`). */
129
+ APPLICATION_OAUTH_CLIENT = 'application_oauth_client',
130
+ }
131
+
111
132
  /**
112
133
  * Which AI agent performed an audited action, and in which execution — present on an audit row ONLY
113
134
  * when an agent acted. Its presence is how the trail says "an agent did this"; `actorKind` still names
@@ -209,7 +209,7 @@ export type ReviewDeadlineAt = z.infer<typeof ReviewDeadlineAtSchema>;
209
209
  export const ReviewDeadlineTargetSchema = z.object({
210
210
  at: ReviewDeadlineAtSchema,
211
211
  /** Elapsed time (the default) or the application's business calendar. */
212
- basis: z.enum(ReviewClockBasis).optional(),
212
+ basis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').optional(),
213
213
  /** Arms a WARNING stage this long before the deadline, on the same basis. Absent: no warning stage. */
214
214
  warnBefore: ReviewDurationSchema.optional(),
215
215
  });
@@ -220,8 +220,8 @@ export type ReviewDeadlineTarget = z.infer<typeof ReviewDeadlineTargetSchema>;
220
220
  * target resolver, declared on the backend gate beside it.
221
221
  */
222
222
  export const ReviewEscalationRuleSchema = z.object({
223
- stage: z.enum(ReviewDeadlineStage),
224
- action: z.enum(ReviewEscalationActionKind),
223
+ stage: z.enum(ReviewDeadlineStage).systemEnum('ReviewDeadlineStage'),
224
+ action: z.enum(ReviewEscalationActionKind).systemEnum('ReviewEscalationActionKind'),
225
225
  });
226
226
  export type ReviewEscalationRuleDescriptor = z.infer<typeof ReviewEscalationRuleSchema>;
227
227