@wildo-ai/framework-knowledge 1.1.9 → 1.1.11

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 (1163) 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 +11 -0
  4. package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
  5. package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
  6. package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
  7. package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
  8. package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
  9. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  10. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  11. package/dist/esm/framework-knowledge.definitions.js +543 -80
  12. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  13. package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
  14. package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
  15. package/dist/esm/framework-knowledge.research-provenance.js +140 -0
  16. package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
  17. package/dist/esm/index.d.ts +2 -0
  18. package/dist/esm/index.d.ts.map +1 -1
  19. package/dist/esm/index.js +2 -0
  20. package/dist/esm/index.js.map +1 -1
  21. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
  22. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
  23. package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
  24. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +43 -2
  25. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
  26. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +138 -21
  27. package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
  28. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
  29. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -1
  30. package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
  31. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
  32. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +1 -1
  33. package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
  34. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +17 -9
  35. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
  36. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +22 -11
  37. package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
  38. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -1
  39. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
  40. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +89 -9
  41. package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
  42. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +6 -5
  43. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
  44. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +6 -4
  45. package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
  46. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -2
  47. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
  48. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +7 -2
  49. package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
  50. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
  51. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
  52. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +8 -4
  53. package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
  54. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +28 -6
  55. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
  56. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +23 -5
  57. package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
  58. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
  59. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
  60. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
  61. package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
  62. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
  63. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
  64. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +14 -2
  65. package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
  66. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
  67. package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
  68. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
  69. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
  70. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +14 -6
  71. package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
  72. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
  73. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
  74. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
  75. package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
  76. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
  77. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
  78. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
  79. package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
  80. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
  81. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
  82. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
  83. package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
  84. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
  85. package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
  86. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
  87. package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
  88. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +2 -1
  89. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
  90. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
  91. package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
  92. package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
  93. package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
  94. package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
  95. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +34 -7
  96. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
  97. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +39 -13
  98. package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
  99. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
  100. package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
  101. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -1
  102. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
  103. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +14 -6
  104. package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
  105. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
  106. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
  107. package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
  108. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -1
  109. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
  110. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
  111. package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
  112. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
  113. package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
  114. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
  115. package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
  116. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
  117. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +15 -3
  118. package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
  119. package/dist/esm/source-anchor-grammar.d.ts +70 -0
  120. package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
  121. package/dist/esm/source-anchor-grammar.js +114 -0
  122. package/dist/esm/source-anchor-grammar.js.map +1 -0
  123. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
  124. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  125. package/dist/knowledge/manifest.json +8 -8
  126. package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
  127. package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
  128. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
  129. package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
  130. package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +497 -32
  131. package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +44 -3
  132. package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +302 -8
  133. package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
  134. package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
  135. package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
  136. package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
  137. package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
  138. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
  139. package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
  140. package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +118 -11
  141. package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -3
  142. package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +41 -10
  143. package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +7 -5
  144. package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
  145. package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
  146. package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
  147. package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
  148. package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +79 -1
  149. package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
  150. package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +187 -14
  151. package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +23 -3
  152. package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
  153. package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
  154. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +99 -24
  155. package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
  156. package/dist/knowledge/playbooks/refinement.document-facts/method.md +38 -3
  157. package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +4 -3
  158. package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
  159. package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +2 -2
  160. package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
  161. package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
  162. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
  163. package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
  164. package/dist/knowledge/playbooks/top_down.brand-identity/method.md +16 -5
  165. package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
  166. package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
  167. package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
  168. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
  169. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
  170. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
  171. package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
  172. package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
  173. package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
  174. package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
  175. package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
  176. package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +2 -2
  177. package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
  178. package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
  179. package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
  180. package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
  181. package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
  182. package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +18 -4
  183. package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
  184. package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -2
  185. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
  186. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
  187. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
  188. package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +5 -3
  189. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
  190. package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
  191. package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
  192. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
  193. package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
  194. package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
  195. package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
  196. package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
  197. package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
  198. package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
  199. package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
  200. package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +23 -0
  201. package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -4
  202. package/dist/knowledge/references/acp.execution-profile.md +9 -1
  203. package/dist/knowledge/references/application-maturity.config.md +1 -1
  204. package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
  205. package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
  206. package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
  207. package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
  208. package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
  209. package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
  210. package/dist/knowledge/references/brand.name-choice.config.md +20 -3
  211. package/dist/knowledge/references/brand.name-screening.config.md +58 -3
  212. package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
  213. package/dist/knowledge/references/build-plan.task-graph.config.md +292 -7
  214. package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
  215. package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
  216. package/dist/knowledge/references/capability-composition.config.md +4 -3
  217. package/dist/knowledge/references/cli.market.generate-command.md +2 -1
  218. package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
  219. package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
  220. package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
  221. package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
  222. package/dist/knowledge/references/engine.saas-website.config.md +16 -44
  223. package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
  224. package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
  225. package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
  226. package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
  227. package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +259 -0
  228. package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
  229. package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +129 -0
  230. package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
  231. package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
  232. package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
  233. package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
  234. package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
  235. package/dist/knowledge/references/example.config.design-system.full.md +40 -116
  236. package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
  237. package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
  238. package/dist/knowledge/references/example.email.template.minimal.md +1 -1
  239. package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
  240. package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
  241. package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
  242. package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
  243. package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
  244. package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
  245. package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
  246. package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
  247. package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
  248. package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
  249. package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
  250. package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
  251. package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
  252. package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
  253. package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
  254. package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
  255. package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
  256. package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
  257. package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
  258. package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
  259. package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
  260. package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
  261. package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
  262. package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +60 -22
  263. package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
  264. package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
  265. package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
  266. package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
  267. package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
  268. package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
  269. package/dist/knowledge/references/example.website.blocks.section.md +20 -0
  270. package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
  271. package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
  272. package/dist/knowledge/references/example.website.demo.append.md +57 -0
  273. package/dist/knowledge/references/example.website.demo.approval.md +47 -0
  274. package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
  275. package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
  276. package/dist/knowledge/references/example.website.demo.connect.md +45 -0
  277. package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
  278. package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
  279. package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
  280. package/dist/knowledge/references/example.website.demo.transform.md +43 -0
  281. package/dist/knowledge/references/example.website.page.manifest.md +2 -6
  282. package/dist/knowledge/references/example.website.section.bento.md +27 -0
  283. package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
  284. package/dist/knowledge/references/example.website.section.factories.md +82 -0
  285. package/dist/knowledge/references/example.website.section.faq.md +17 -0
  286. package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
  287. package/dist/knowledge/references/example.website.section.hero.md +16 -0
  288. package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
  289. package/dist/knowledge/references/example.website.section.marquee.md +26 -0
  290. package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
  291. package/dist/knowledge/references/example.website.section.site-block.md +43 -0
  292. package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
  293. package/dist/knowledge/references/example.website.section.stats.md +23 -0
  294. package/dist/knowledge/references/example.website.section.steps.md +15 -0
  295. package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
  296. package/dist/knowledge/references/example.website.theme.composed.md +69 -0
  297. package/dist/knowledge/references/experience-plan.config.md +76 -7
  298. package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
  299. package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
  300. package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
  301. package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
  302. package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
  303. package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
  304. package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
  305. package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
  306. package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
  307. package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
  308. package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
  309. package/dist/knowledge/references/integration-plan.config.md +21 -1
  310. package/dist/knowledge/references/market.context-block.builder.md +1 -1
  311. package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
  312. package/dist/knowledge/references/minions.tick-contract.md +2 -2
  313. package/dist/knowledge/references/placement-plan.config.md +107 -2
  314. package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
  315. package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
  316. package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
  317. package/dist/knowledge/references/platform.config.saas.md +106 -14
  318. package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
  319. package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
  320. package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
  321. package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
  322. package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
  323. package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
  324. package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
  325. package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
  326. package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
  327. package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
  328. package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
  329. package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
  330. package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
  331. package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
  332. package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
  333. package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
  334. package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
  335. package/dist/knowledge/references/requirements.references.conventions.md +1 -1
  336. package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
  337. package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
  338. package/dist/knowledge/references/roadmap.phase.config.md +2 -16
  339. package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
  340. package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
  341. package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
  342. package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
  343. package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
  344. package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
  345. package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
  346. package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
  347. package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
  348. package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
  349. package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
  350. package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
  351. package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
  352. package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
  353. package/dist/knowledge/references/saas.backend.email.send.md +84 -0
  354. package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
  355. package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
  356. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
  357. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
  358. package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
  359. package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
  360. package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
  361. package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
  362. package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
  363. package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
  364. package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
  365. package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
  366. package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
  367. package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
  368. package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
  369. package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
  370. package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
  371. package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
  372. package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
  373. package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
  374. package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
  375. package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
  376. package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
  377. package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
  378. package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
  379. package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
  380. package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
  381. package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
  382. package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
  383. package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
  384. package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
  385. package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
  386. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
  387. package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
  388. package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
  389. package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
  390. package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
  391. package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
  392. package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
  393. package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
  394. package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +126 -0
  395. package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
  396. package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
  397. package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
  398. package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
  399. package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
  400. package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
  401. package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
  402. package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +324 -0
  403. package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +109 -0
  404. package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +61 -0
  405. package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
  406. package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
  407. package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
  408. package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
  409. package/dist/knowledge/references/saas.frontend.resource-label-params.md +54 -0
  410. package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
  411. package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +125 -58
  412. package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -7
  413. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
  414. package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
  415. package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +64 -2
  416. package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
  417. package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
  418. package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
  419. package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
  420. package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
  421. package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
  422. package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
  423. package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
  424. package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
  425. package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
  426. package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
  427. package/dist/knowledge/references/saas.models.audit.trail-config.md +63 -5
  428. package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
  429. package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
  430. package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
  431. package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
  432. package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
  433. package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
  434. package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
  435. package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
  436. package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
  437. package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
  438. package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
  439. package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
  440. package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
  441. package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
  442. package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
  443. package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
  444. package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
  445. package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
  446. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
  447. package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
  448. package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
  449. package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
  450. package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
  451. package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
  452. package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
  453. package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
  454. package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
  455. package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
  456. package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
  457. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
  458. package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
  459. package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
  460. package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
  461. package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
  462. package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
  463. package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
  464. package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
  465. package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
  466. package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
  467. package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
  468. package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
  469. package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
  470. package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
  471. package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
  472. package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
  473. package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +63 -9
  474. package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
  475. package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
  476. package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
  477. package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
  478. package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
  479. package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
  480. package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
  481. package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
  482. package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
  483. package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
  484. package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
  485. package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
  486. package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
  487. package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
  488. package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
  489. package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
  490. package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
  491. package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
  492. package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
  493. package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
  494. package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
  495. package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
  496. package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
  497. package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
  498. package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
  499. package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
  500. package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
  501. package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
  502. package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +84 -2
  503. package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
  504. package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
  505. package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
  506. package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
  507. package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
  508. package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
  509. package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
  510. package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
  511. package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
  512. package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
  513. package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
  514. package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
  515. package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
  516. package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
  517. package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
  518. package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
  519. package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
  520. package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
  521. package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
  522. package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
  523. package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
  524. package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
  525. package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
  526. package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
  527. package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
  528. package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
  529. package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
  530. package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
  531. package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
  532. package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
  533. package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
  534. package/dist/knowledge/references/saas.public-runtime.contract.md +60 -2
  535. package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
  536. package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
  537. package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
  538. package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
  539. package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
  540. package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
  541. package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
  542. package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
  543. package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
  544. package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
  545. package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
  546. package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
  547. package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
  548. package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
  549. package/dist/knowledge/references/saas.website.astro.bridge.md +61 -14
  550. package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
  551. package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
  552. package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
  553. package/dist/knowledge/references/saas.website.astro.label-loader.md +41 -9
  554. package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
  555. package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
  556. package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
  557. package/dist/knowledge/references/saas.website.astro.site-context.md +30 -8
  558. package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
  559. package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
  560. package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
  561. package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
  562. package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
  563. package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
  564. package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
  565. package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
  566. package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
  567. package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
  568. package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
  569. package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
  570. package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
  571. package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
  572. package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
  573. package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
  574. package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
  575. package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
  576. package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
  577. package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
  578. package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
  579. package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
  580. package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
  581. package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
  582. package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
  583. package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
  584. package/dist/knowledge/references/saas.website.blog.bridge.md +102 -53
  585. package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
  586. package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
  587. package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
  588. package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
  589. package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
  590. package/dist/knowledge/references/saas.website.blog.index.md +43 -0
  591. package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
  592. package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
  593. package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
  594. package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
  595. package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
  596. package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
  597. package/dist/knowledge/references/saas.website.config.site-context-loader.md +24 -1
  598. package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
  599. package/dist/knowledge/references/saas.website.consent.context.md +1 -1
  600. package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
  601. package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
  602. package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
  603. package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
  604. package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
  605. package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
  606. package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
  607. package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
  608. package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
  609. package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
  610. package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
  611. package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
  612. package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
  613. package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
  614. package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
  615. package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
  616. package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
  617. package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
  618. package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
  619. package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
  620. package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
  621. package/dist/knowledge/references/saas.website.legal.public-document-links.md +91 -0
  622. package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
  623. package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
  624. package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
  625. package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
  626. package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
  627. package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
  628. package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
  629. package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
  630. package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
  631. package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
  632. package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
  633. package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
  634. package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
  635. package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
  636. package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
  637. package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
  638. package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
  639. package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
  640. package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
  641. package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
  642. package/dist/knowledge/references/saas.website.page.context.md +9 -2
  643. package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
  644. package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
  645. package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
  646. package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
  647. package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
  648. package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
  649. package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
  650. package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
  651. package/dist/knowledge/references/saas.website.product.figures.md +320 -0
  652. package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
  653. package/dist/knowledge/references/saas.website.product.panels.md +324 -0
  654. package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
  655. package/dist/knowledge/references/saas.website.refs.section.md +2 -2
  656. package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
  657. package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
  658. package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
  659. package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
  660. package/dist/knowledge/references/saas.website.runtime.context.md +51 -17
  661. package/dist/knowledge/references/saas.website.section.component.md +21 -19
  662. package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
  663. package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
  664. package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
  665. package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
  666. package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
  667. package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
  668. package/dist/knowledge/references/saas.website.stacking.md +86 -0
  669. package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
  670. package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
  671. package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
  672. package/dist/knowledge/references/service-method.config.md +270 -0
  673. package/dist/knowledge/references/website-plan.config.md +561 -23
  674. package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
  675. package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
  676. package/dist/knowledge/references/website-plan.page-routes.md +39 -0
  677. package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
  678. package/dist/knowledge/references/zod.decorators.chainable-runtime.md +86 -9
  679. package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
  680. package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
  681. package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +82 -6
  682. package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
  683. package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
  684. package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
  685. package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
  686. package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
  687. package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
  688. package/dist/knowledge/references/zod.decorators.schema-metadata.md +5 -0
  689. package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +50 -1
  690. package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
  691. package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
  692. package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -7
  693. package/dist/knowledge/references/zod.factories.code.md +18 -8
  694. package/dist/knowledge/references/zod.factories.duration.md +23 -13
  695. package/dist/knowledge/references/zod.factories.money.md +24 -14
  696. package/dist/knowledge/references/zod.factories.phone.md +23 -14
  697. package/dist/knowledge/references/zod.factories.range.md +5 -1
  698. package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
  699. package/dist/knowledge/registries/framework-topics.json +2854 -246
  700. package/dist/knowledge/registries/playbooks.json +57 -36
  701. package/dist/knowledge/registries/source-tags.json +8863 -4569
  702. package/dist/knowledge/rules/database-migration-obligation.md +11 -5
  703. package/dist/knowledge/rules/live-context-door.md +1 -1
  704. package/dist/knowledge/skills/INDEX.md +63 -34
  705. package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
  706. package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
  707. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
  708. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
  709. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
  710. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
  711. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
  712. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
  713. package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
  714. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
  715. package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
  716. package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
  717. package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
  718. package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
  719. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
  720. package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
  721. package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
  722. package/dist/knowledge/skills/application-database-migrations/SKILL.md +41 -12
  723. package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
  724. package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
  725. package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
  726. package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
  727. package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +130 -4
  728. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
  729. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
  730. package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
  731. package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
  732. package/dist/knowledge/skills/backend-custom-operation/SKILL.md +291 -10
  733. package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
  734. package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
  735. package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +223 -0
  736. package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
  737. package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
  738. package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
  739. package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
  740. package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
  741. package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
  742. package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +132 -2
  743. package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
  744. package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
  745. package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
  746. package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
  747. package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
  748. package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
  749. package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
  750. package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
  751. package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
  752. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
  753. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +136 -34
  754. package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
  755. package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
  756. package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
  757. package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
  758. package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
  759. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
  760. package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
  761. package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
  762. package/dist/knowledge/skills/config-app-shell/SKILL.md +101 -19
  763. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
  764. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
  765. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
  766. package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
  767. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +472 -0
  768. package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +82 -0
  769. package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
  770. package/dist/knowledge/skills/config-design-system/SKILL.md +271 -166
  771. package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
  772. package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
  773. package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
  774. package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
  775. package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
  776. package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
  777. package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
  778. package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
  779. package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
  780. package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
  781. package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
  782. package/dist/knowledge/skills/config-saas/SKILL.md +27 -11
  783. package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +62 -4
  784. package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +80 -7
  785. package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
  786. package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
  787. package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
  788. package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
  789. package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
  790. package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
  791. package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
  792. package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
  793. package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
  794. package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -4
  795. package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
  796. package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
  797. package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
  798. package/dist/knowledge/skills/configure-billing/SKILL.md +32 -4
  799. package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
  800. package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
  801. package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
  802. package/dist/knowledge/skills/email-add-template/SKILL.md +72 -9
  803. package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
  804. package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +135 -0
  805. package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
  806. package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
  807. package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
  808. package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
  809. package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
  810. package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
  811. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
  812. package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
  813. package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
  814. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
  815. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
  816. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
  817. package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
  818. package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +291 -22
  819. package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
  820. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
  821. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
  822. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
  823. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
  824. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
  825. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
  826. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
  827. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
  828. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
  829. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
  830. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
  831. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
  832. package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
  833. package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
  834. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
  835. package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
  836. package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
  837. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +109 -9
  838. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
  839. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
  840. package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
  841. package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +16 -7
  842. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -18
  843. package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +144 -14
  844. package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
  845. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
  846. package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
  847. package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
  848. package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
  849. package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +14 -3
  850. package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
  851. package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
  852. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
  853. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
  854. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
  855. package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
  856. package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
  857. package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
  858. package/dist/knowledge/skills/infra-environment-config/SKILL.md +113 -3
  859. package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
  860. package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
  861. package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
  862. package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
  863. package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
  864. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
  865. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
  866. package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
  867. package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
  868. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
  869. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
  870. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
  871. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
  872. package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
  873. package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
  874. package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
  875. package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
  876. package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
  877. package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
  878. package/dist/knowledge/skills/market-category/SKILL.md +21 -7
  879. package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
  880. package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +20 -3
  881. package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +10 -1
  882. package/dist/knowledge/skills/market-generation-cli/SKILL.md +23 -12
  883. package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +13 -7
  884. package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
  885. package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
  886. package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
  887. package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
  888. package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
  889. package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
  890. package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
  891. package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
  892. package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
  893. package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
  894. package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
  895. package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
  896. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
  897. package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
  898. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
  899. package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +176 -4
  900. package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
  901. package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
  902. package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
  903. package/dist/knowledge/skills/module-relationships/SKILL.md +81 -31
  904. package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
  905. package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
  906. package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
  907. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
  908. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
  909. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
  910. package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
  911. package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
  912. package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
  913. package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
  914. package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
  915. package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
  916. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
  917. package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
  918. package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
  919. package/dist/knowledge/skills/provider-address-lookup/SKILL.md +15 -4
  920. package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
  921. package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
  922. package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
  923. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
  924. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
  925. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
  926. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
  927. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
  928. package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
  929. package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +15 -6
  930. package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
  931. package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
  932. package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
  933. package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
  934. package/dist/knowledge/skills/provider-operation-calls/SKILL.md +37 -14
  935. package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
  936. package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
  937. package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
  938. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
  939. package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
  940. package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
  941. package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +81 -37
  942. package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
  943. package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
  944. package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
  945. package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +167 -61
  946. package/dist/knowledge/skills/resource-add-resource/SKILL.md +63 -6
  947. package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +84 -2
  948. package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
  949. package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
  950. package/dist/knowledge/skills/resource-config-wiring/SKILL.md +131 -7
  951. package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
  952. package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
  953. package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +25 -4
  954. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
  955. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +23 -2
  956. package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
  957. package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +162 -2
  958. package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
  959. package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
  960. package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
  961. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
  962. package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +221 -23
  963. package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
  964. package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
  965. package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +202 -17
  966. package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
  967. package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
  968. package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +123 -56
  969. package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
  970. package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
  971. package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
  972. package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +73 -14
  973. package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
  974. package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
  975. package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
  976. package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
  977. package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
  978. package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
  979. package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
  980. package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
  981. package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
  982. package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
  983. package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
  984. package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
  985. package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
  986. package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
  987. package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
  988. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
  989. package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
  990. package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
  991. package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
  992. package/dist/knowledge/skills/resource-retention-binding/SKILL.md +8 -2
  993. package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
  994. package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
  995. package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +39 -9
  996. package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
  997. package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +571 -0
  998. package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
  999. package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
  1000. package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +87 -6
  1001. package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
  1002. package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
  1003. package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
  1004. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +50 -1
  1005. package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
  1006. package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +119 -64
  1007. package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
  1008. package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +216 -18
  1009. package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
  1010. package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
  1011. package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
  1012. package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
  1013. package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +185 -80
  1014. package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +159 -0
  1015. package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
  1016. package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
  1017. package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
  1018. package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +257 -65
  1019. package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
  1020. package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
  1021. package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
  1022. package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
  1023. package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
  1024. package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
  1025. package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
  1026. package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
  1027. package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
  1028. package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
  1029. package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
  1030. package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
  1031. package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
  1032. package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
  1033. package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
  1034. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -31
  1035. package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +64 -2
  1036. package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
  1037. package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
  1038. package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
  1039. package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
  1040. package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
  1041. package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +17 -9
  1042. package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
  1043. package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
  1044. package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
  1045. package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
  1046. package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
  1047. package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
  1048. package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
  1049. package/dist/knowledge/skills/views-add-composite-view/SKILL.md +20 -6
  1050. package/dist/knowledge/skills/views-add-custom-view/SKILL.md +20 -3
  1051. package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
  1052. package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
  1053. package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
  1054. package/dist/knowledge/skills/views-chart-authoring/SKILL.md +226 -37
  1055. package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
  1056. package/dist/knowledge/skills/views-composite-authoring/SKILL.md +33 -9
  1057. package/dist/knowledge/skills/views-execution-authoring/SKILL.md +12 -3
  1058. package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
  1059. package/dist/knowledge/skills/website-anonymous-session/SKILL.md +93 -27
  1060. package/dist/knowledge/skills/website-blog-authoring/SKILL.md +264 -78
  1061. package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1068 -192
  1062. package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
  1063. package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
  1064. package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
  1065. package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
  1066. package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
  1067. package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +46 -19
  1068. package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
  1069. package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
  1070. package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +97 -29
  1071. package/dist/knowledge/skills/website-factory-advanced/SKILL.md +77 -66
  1072. package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +71 -24
  1073. package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
  1074. package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
  1075. package/dist/knowledge/skills/website-layout-overrides/SKILL.md +116 -76
  1076. package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +43 -14
  1077. package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
  1078. package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
  1079. package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
  1080. package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +266 -371
  1081. package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
  1082. package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +120 -0
  1083. package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
  1084. package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -329
  1085. package/dist/knowledge/skills/website-page-authoring/SKILL.md +170 -66
  1086. package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
  1087. package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +27 -3
  1088. package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
  1089. package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
  1090. package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
  1091. package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +54 -29
  1092. package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
  1093. package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
  1094. package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
  1095. package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
  1096. package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
  1097. package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
  1098. package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
  1099. package/dist/knowledge/skills/website-section-faq/SKILL.md +564 -300
  1100. package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
  1101. package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
  1102. package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +650 -272
  1103. package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
  1104. package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +577 -261
  1105. package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
  1106. package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
  1107. package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
  1108. package/dist/knowledge/skills/website-section-hero/SKILL.md +606 -330
  1109. package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
  1110. package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
  1111. package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
  1112. package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
  1113. package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
  1114. package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
  1115. package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
  1116. package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
  1117. package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
  1118. package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
  1119. package/dist/knowledge/skills/website-section-pricing/SKILL.md +552 -376
  1120. package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
  1121. package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
  1122. package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
  1123. package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
  1124. package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
  1125. package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
  1126. package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
  1127. package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
  1128. package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
  1129. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
  1130. package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
  1131. package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
  1132. package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
  1133. package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
  1134. package/dist/knowledge/skills/website-section-social-proof/SKILL.md +743 -309
  1135. package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
  1136. package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
  1137. package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
  1138. package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
  1139. package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
  1140. package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
  1141. package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
  1142. package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
  1143. package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +198 -70
  1144. package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
  1145. package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +17 -2
  1146. package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +8 -95
  1147. package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
  1148. package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
  1149. package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
  1150. package/dist/knowledge/topic-index.json +17305 -8263
  1151. package/dist/tsconfig.build.tsbuildinfo +1 -1
  1152. package/package.json +4 -4
  1153. package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
  1154. package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
  1155. package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
  1156. package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
  1157. package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
  1158. package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
  1159. package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
  1160. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
  1161. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
  1162. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
  1163. package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
@@ -44,13 +44,14 @@ an application reaches those through configuration, never through JSX.
44
44
  | `AI_Image` | Image tile for multimodal assistant output. | Use when image parts are present in model responses. | Avoid when only external URLs are shown without generation metadata. |
45
45
  | `AI_WebPreview` | Compound preview for web browsing tool results. | Use when agents return URLs that should be inspected in-place. | Avoid when link cards or plain anchors meet the need. |
46
46
 
47
- ## Ai Elements / Chat (6)
47
+ ## Ai Elements / Chat (7)
48
48
 
49
49
  | Component | Renders | Use when | Avoid when |
50
50
  | --- | --- | --- | --- |
51
51
  | `AI_Conversation` | Stick-to-bottom compound wrapping message lists. | Use as the root of assistant chat layouts. | Avoid for single-shot prompts without history. |
52
+ | `AI_ConversationThread` | Compound drawing a `ConversationThreadModel`: the root is the transcript, `.Composer` the message input, `.Discussions` the discussion list. | Use for any surface where a person converses with an agent of an ActorSystem: derive the model with `conversationThreadModel` from the stored thread (`fetchConversationHistory`, read a page at a time and held with `withNewestHistoryPage` / `withOlderHistoryPage`) and the live execution (`useFlowsActors().executions`), then draw it with this component. | Avoid for a single prompt with no history, or for a background run nobody converses with: use `AI_PromptInput` or an execution card. Do not hand-build a second message list beside it — interleave host cards through `hostEntries` instead. |
52
53
  | `AI_Message` | Large compound covering user/assistant/system roles. | Use for every message row inside `AI_Conversation`. | Avoid when rendering plain text without actions or branching. |
53
- | `AI_PromptInput` | Very large compound built from command/menu/select primitives. | Use as the primary chat input for power users. | Avoid when a single textarea without attachments is enough. |
54
+ | `AI_PromptInput` | Compound built on the input group: a form whose text field is the group's control, with a header and a footer row for actions. | Use wherever a person writes a message to an assistant or a conversation and sends it: Enter sends, Shift+Enter breaks the line, and the field grows with its text. A text-only composer is just `AI_PromptInputTextarea` and `AI_PromptInputSubmit` in the footer. | Avoid for a multi-line value saved with a form or a record (use `Textarea`), and for a search or filter box. |
54
55
  | `AI_Sources` | Popover-style sources list with external links. | Use when RAG or web browsing produces reference URLs. | Avoid when answers are not attributed to sources. |
55
56
  | `AI_Suggestion` | Chip-style CTA feeding the composer. | Use beneath assistant messages to steer the next turn. | Avoid when suggestions are shown only as a batch list. |
56
57
  | `AI_Suggestions` | Horizontal suggestion scroller. | Use when several follow-ups should be visible at once. | Avoid when only one suggestion is offered. |
@@ -59,7 +60,7 @@ an application reaches those through configuration, never through JSX.
59
60
 
60
61
  | Component | Renders | Use when | Avoid when |
61
62
  | --- | --- | --- | --- |
62
- | `AI_ApprovalQueue` | Batch review surface for multiple approval requests. | Use in operator consoles managing many concurrent agent actions. | Avoid when only one approval is ever in flight. |
63
+ | `AI_ApprovalQueue` | Batch review surface for multiple approval requests. | Use in operator consoles managing many concurrent agent actions. An application gets one without mounting it: the engine's Decisions page draws `FlowsActors_ApprovalQueue` for every member a decision can be routed to — a gated tool's approval, a representative's admission, or a question one of the application's actor systems asks. | Avoid when only one approval is ever in flight. |
63
64
  | `AI_ApprovalRequest` | Inline human-in-the-loop gate for risky tool calls. | Use when policies require explicit approval before execution. | Avoid when automation should proceed without confirmation. |
64
65
  | `AI_DecisionRequest` | Branching UI for structured decisions returned by agents. | Use when the model enumerates explicit next-step choices. | Avoid when free-text replies are preferred over enumerated options. |
65
66
  | `AI_HumanInputRequest` | Form-like prompt embedded in agent flows. | Use when agents pause for missing parameters or clarifications. | Avoid when structured enums cover all inputs. |
@@ -77,11 +78,11 @@ an application reaches those through configuration, never through JSX.
77
78
 
78
79
  | Component | Renders | Use when | Avoid when |
79
80
  | --- | --- | --- | --- |
80
- | `AI_Canvas` | Graph workspace root for nodes, edges, and controls. | Use for visual planners, workflows, or tool graphs. | Avoid when a textual trace fully substitutes for a graph. |
81
+ | `AI_Canvas` | Graph workspace root for nodes, edges, and controls. | Use for visual planners, workflows, or tool graphs, and for any graph a person edits. | Avoid when a textual trace fully substitutes for a graph, and for drawing a plan, a run, a flow or a choreography read-only: AI_GraphViewer does that on this canvas, with its layout, keyboard reading and list form. |
81
82
  | `AI_Connection` | Geometry-based edge drawing helper. | Use in custom graph layouts between handles. | Avoid when standard `AI_Edge` from React Flow suffices exclusively. |
82
83
  | `AI_Controls` | Wrapper around xyflow Controls primitive. | Use on graph surfaces needing camera controls. | Avoid on read-only tiny previews. |
83
84
  | `AI_Edge` | Custom edge preset between `AI_Node` instances. | Use in agent graphs with explicit directed relationships. | Avoid when graphs are not used. |
84
- | `AI_Node` | Primary vertex visual for flow graphs. | Use for each step, tool, or decision in a visual plan. | Avoid for list-only traces. |
85
+ | `AI_Node` | Primary vertex visual for flow graphs. | Use for each step, tool, or decision in a graph drawn on an AI_Canvas; list one handle per port an edge names. | Avoid for list-only traces, and for drawing a plan, a run, a flow or a choreography: AI_GraphViewer lays those out, measures them and makes them keyboard-readable, and draws its steps with this node itself. |
85
86
  | `AI_Panel` | Simple div shell positioned beside or over the canvas. | Use when selection details should sit adjacent to the graph. | Avoid when modals replace side panels. |
86
87
  | `AI_Toolbar` | Distinct from `APPLICATION_LEVEL_TOOLBAR` — scoped to graph interactions. | Use above or floating on graph canvases. | Avoid when graph is view-only without editing actions. |
87
88
 
@@ -114,7 +115,7 @@ an application reaches those through configuration, never through JSX.
114
115
  | `AI_Plan` | Card + collapsible composition for structured plans. | Use when agents emit explicit multi-step plans. | Avoid for unstructured prose-only replies. |
115
116
  | `AI_Reasoning` | Collapsible content area with streaming-friendly layout. | Use when showing model reasoning separate from final answer. | Avoid when reasoning must not be displayed. |
116
117
 
117
- ## App (10)
118
+ ## App (11)
118
119
 
119
120
  | Component | Renders | Use when | Avoid when |
120
121
  | --- | --- | --- | --- |
@@ -125,20 +126,22 @@ an application reaches those through configuration, never through JSX.
125
126
  | `AppLayout_MainContainer` | Root layout preset wiring `useAppShellLayout` with sidebar, toolbars, overlays, and loading gates. | Use as the top-level wrapper for signed-in SaaS experiences. | Avoid for marketing or auth-only public pages — use `PUBLIC_LAYOUTS_MAIN_CONTAINER`. |
126
127
  | `AppLayout_RouterErrorBoundary` | ErrorDisplay presets for 404/403/5xx, application crashes, and unknown failures. | Use at the router boundary wrapping navigable content. | Avoid for isolated component errors — use `APP_LAYOUTS_ERROR_BOUNDARY`. |
127
128
  | `Files_UploadGrantDrop` | Focused public shell — the target field and its constraints, one file chooser, one upload, then a terminal state (received, already used, expired, cancelled). | Reached only through a grant’s `uploadPageUrl`. It is the fallback for an assistant host that cannot perform the upload itself; a host that can run a command uses the grant’s curl example instead. | Never as a general upload surface — authenticated uploads go through the resource file fields, and nothing on this page is reachable without a grant token. |
128
- | `PublicLayout_MainContainer` | Minimal full-viewport wrapper driven by `usePublicShellLayout`. In card mode it may open the card with a brand header: the mark when one resolves, and the name — set from the TYPOGRAPHY.HEADING recipe, and not a heading element, since the card content owns the page heading. The login page may pass `organizationBranding` from identification; an explicit shell identity still wins. Tenant color is a decorative identity accent, not a replacement for accessible application theme tokens. Other public pages keep their defaults. | Use for auth flows, static marketing content, and other pre-app surfaces. | Avoid for authenticated app shells — use `APP_LAYOUTS_MAIN_CONTAINER`. |
129
+ | `PublicLayout_LegalNotice` | Public legal layout listing the legal name, establishment address and contact always, marking any of those three the operator has not declared yet, and listing legal form, representatives, trade register, VAT number, supervisory authority and regulated profession when declared; it states that no notice is published when the operator owes none. | Use on `/legal-notice`, the route the application router mounts from the public-documents atom and the marketing website links when the notice is owed. | Avoid for governed documents with releases (privacy notice, terms: use the public governed-document page) and for any text the operator did not declare: this page never drafts or invents a particular. |
130
+ | `PublicLayout_MainContainer` | Minimal full-viewport wrapper driven by `usePublicShellLayout`. In card mode it may open the card with a brand header: the mark when one resolves, and the name — set from the TYPOGRAPHY.HEADING recipe, and not a heading element, since the card content owns the page heading. The login page may pass `organizationBranding` from identification; an explicit shell identity still wins. Tenant color is a decorative identity accent, not a replacement for accessible application theme tokens. Other public pages keep their defaults: a signed-in visitor's organization branding never replaces the application's mark here, since a public page speaks for the application. | Use for auth flows, static marketing content, and other pre-app surfaces. | Avoid for authenticated app shells — use `APP_LAYOUTS_MAIN_CONTAINER`. |
129
131
  | `PublicLayout_StaticContentContainer` | Thin wrapper around centered content within the public shell. | Use for legal, help, or marketing pages that do not need auth chrome. | Avoid for authenticated app surfaces. |
130
132
  | `PublicLayout_Terms` | Public legal-document layout that shows release version and effective date for a release, a draft notice for an unreleased draft, and a "not yet established" note beneath any clause the document states is incomplete; it shows no partial content when nothing may be displayed, and withholds unapproved releases and drafts only when the application arms its governed-document approval gate (`compliance.governedDocumentApprovalGate`), the same switch every acceptance surface reads. | Use on `/privacy`, `/terms` and future stable-definition public document routes. | Avoid for authenticated governance records, off-site documents, or rendering a draft candidate directly — drafts reach this page only as projected public documents. |
131
133
 
132
- ## Auth (14)
134
+ ## Auth (15)
133
135
 
134
136
  | Component | Renders | Use when | Avoid when |
135
137
  | --- | --- | --- | --- |
136
138
  | `Auth_AuthCallback` | Spinner + error alert flow tied to auth redirect parameters, redirecting to the post-sign-in target or to organization onboarding. | Use on the auth callback route configured with the identity provider. | Avoid for password login — use `PUBLIC_LAYOUTS_USER_AUTH`. |
139
+ | `Auth_ChatIdentityLink` | Confirmation surface on the /chat-link route: the named chat account, a not-yours warning, link and cancel, then a terminal state (linked, already linked, linked to another member, or the link cannot be used). When a chat host opened it in its own sign-in window (the `host` marker, `ChatIdentityLinkHost`), it tells the providers serving FRONTEND_CHAT_SIGN_IN_COMPLETION for that host how the sign-in ended: at once for a working link, on Close otherwise, Close replacing the way home. | Reached only through the link a chat bot answers an unknown person with. It signs the visitor in first, keeping the link and its host marker, and never completes on load. | Never as a place to list or remove chat links: a member's own links and an administrator's view of every link are the `chatIdentityLinks` resource's list surfaces. |
137
140
  | `Auth_ConfirmEmail` | Token-driven confirm surface with resend and support paths. | Use on the confirm-email route after signup. | Avoid when email verification is disabled. |
138
141
  | `Auth_EnrollmentRequired` | Method picker with per-method enrollment ceremonies (TOTP, passkey, phone), or a terminal sign-out when nothing can be enrolled. | Use when an authentication answer requires a second factor and none is usable. | Avoid when a usable second factor exists — use `PUBLIC_LAYOUTS_MFA_CHALLENGE`. |
139
- | `Auth_Invitation` | Invitation card with accept/decline and optional sign-in handoff. | Use on invitation deep links. | Avoid when invitations are disabled. |
142
+ | `Auth_Invitation` | Invitation card with accept/decline and optional sign-in handoff. Beside them, a privacy-notice link opens `/privacy` in a new tab while the application serves its notice, because this screen collects the invitee's name and credential before any session exists (#2976). | Use on invitation deep links. | Avoid when invitations are disabled. |
140
143
  | `Auth_MagicLinkVerify` | Progress + error states for email link verification. | Use on the magic-link landing route. | Avoid when magic links are not offered. |
141
- | `Auth_Main` | Large automated form host switching between password, magic link, passkey, and SSO methods; before any email is typed it also offers username-less passkey sign-in — a sign-in-with-a-passkey button and passkey autofill on the email field — where the device lists every account the person holds a passkey for. Two things it will NOT show: password recovery beside a method that is not the password, and an enterprise method and a password fallback as equal choices — where the tenant requires the former, the page says so. | Use on the main authentication route. | Avoid for step-up or MFA-only flows — use dedicated MFA layout. |
144
+ | `Auth_Main` | Large automated form host switching between password, magic link, passkey, and SSO methods; before any email is typed it also offers username-less passkey sign-in — a sign-in-with-a-passkey button and passkey autofill on the email field — where the device lists every account the person holds a passkey for. Two things it will NOT show: password recovery beside a method that is not the password, and an enterprise method and a password fallback as equal choices — where the tenant requires the former, the page says so. At its foot, beside the recovery and sign-up links, a privacy-notice link opens `/privacy` in a new tab, drawn exactly when that page would render the notice (`resolveServedPublicGovernedDocumentPath`). | Use on the main authentication route. | Avoid for step-up or MFA-only flows — use dedicated MFA layout. |
142
145
  | `Auth_MfaChallenge` | Session-bound MFA form with method-specific inputs. | Use when `requiresMFA` is returned from identify. | Avoid for first-factor identification. |
143
146
  | `Auth_OAuthConsent` | Approve/deny decision surface for user-delegated (A2A/MCP) OAuth authorization on the /oauth/consent route. | Use on the /oauth/consent route, reached when GET /oauth/authorize returns `consent_required` for an opt-in client; the decision is POSTed to /oauth/authorize/decision. | Avoid for trusted/first-party or machine clients — they auto-grant (requiresConsent defaults false), so the screen never renders for them. |
144
147
  | `Auth_OAuthLoggedOut` | Post-logout confirmation surface on the /oauth/logged-out route; informational only (the session is already terminated server-side by the per-session revocation fence). | Use on the /oauth/logged-out route, reached when GET /oauth/end-session has no registered post_logout_redirect_uri to redirect to (RP-Initiated Logout 1.0 §5). | Avoid when the logout request carries a registered post_logout_redirect_uri — the OP redirects straight back to the relying party (§3) and this screen never renders. |
@@ -155,7 +158,7 @@ an application reaches those through configuration, never through JSX.
155
158
  | `BillingPortalLink` | A thin link or button that opens the billing provider’s customer portal, delegating to the `useBillingSafe` portal opener when uncontrolled; renders an explicit unavailable state rather than empty or zero data when the portal is not reachable. | Use when users must self-serve payment methods or invoices. | Avoid when portal access is unavailable for the current customer. |
156
159
  | `InvoiceHistory` | Unavailable slices render an explicit unavailable state instead of empty or zero data; independently available billing panels remain usable. Billing summary table wired to optional `useBillingSafe` defaults. | Use on account or subscription settings surfaces. | Avoid when billing provider does not expose invoice history. |
157
160
  | `PlanChangePreview` | Composed by PricingTable after plan selection, with estimate, cancel, retry and a confirmation enabled only for the current server-bound preview. | Use when changing an existing subscription plan; new subscriptions use checkout. | Avoid for anonymous pricing pages without an active subscription context. |
158
- | `PricingTable` | Unavailable slices render an explicit unavailable state instead of empty or zero data; independently available billing panels remain usable. Marketing-grade plan grid integrated with catalog metadata: the catalogue decides which plan is recommended (emphasised, never worded as popularity), how much of each price is stated (listed, a starting price, or on request with a contact-sales action when `contactSalesHref` is given), and which plans are announced but not yet on sale (listed, selection disabled). | For an existing subscription, selection composes a provider invoice preview and explicit server-bound confirmation; new subscribers use checkout. Use on upgrade paths and public pricing when embedded in the app. | Avoid when a single plan replaces self-serve tiers. A custom-quote plan belongs in the grid as an on-request product, not in a separate component. |
161
+ | `PricingTable` | Unavailable slices render an explicit unavailable state instead of empty or zero data; independently available billing panels remain usable. Marketing-grade plan grid integrated with catalog metadata, whose plans share the width of the container it renders in (a settings pane or a page), never a column count read from the window: the catalogue decides which plan is recommended (emphasised, never worded as popularity), how much of each price is stated (listed, a starting price, or on request with a contact-sales action when `contactSalesHref` is given), and which plans are announced but not yet on sale (listed, selection disabled). | For an existing subscription, selection composes a provider invoice preview and explicit server-bound confirmation; new subscribers use checkout. Use on upgrade paths and public pricing when embedded in the app. | Avoid when a single plan replaces self-serve tiers. A custom-quote plan belongs in the grid as an on-request product, not in a separate component. |
159
162
  | `SubscriptionStatus` | Unavailable slices render an explicit unavailable state instead of empty or zero data; independently available billing panels remain usable. Read-only status panel with optional actions to manage billing. | Use on account settings and billing overview routes. | Avoid for users without an active billing subject. |
160
163
  | `UsageDashboard` | Unavailable slices render an explicit unavailable state instead of empty or zero data; usage and credit balance availability are independent, so either section can remain usable when the other fails. Dashboard cards/charts fed by billing usage APIs. | Use when plans include metered entitlements or quota warnings. | Avoid when billing is flat-rate without usage signals. |
161
164
 
@@ -228,6 +231,12 @@ an application reaches those through configuration, never through JSX.
228
231
  | `FeatureUnavailableDialog` | Blocking dialog variant of the feature-unavailable prompt. | Use when navigation or a button attempt must stop with explicit acknowledgement. | Avoid for non-blocking hints; use `FeatureUnavailablePrompt` inline instead. |
229
232
  | `FeatureUnavailablePrompt` | Non-modal upsell / explanation surface embedded in pages or drawers. | Use when a feature gate should explain why content is hidden without a full dialog. | Avoid when user acknowledgement is mandatory; prefer the dialog slot. |
230
233
 
234
+ ## Flows Actors (1)
235
+
236
+ | Component | Renders | Use when | Avoid when |
237
+ | --- | --- | --- | --- |
238
+ | `AI_GraphViewer` | A drawing of steps in ranks joined by arrows, with a key, a banner when the run waits on a decision, and a list presentation of the same steps. | Use to show any process the engine models as a graph. Build the GraphView with its adapter (`executionPlanGraph`, `actorSystemExecutionGraph`, `flowGraph`, `choreographyGraph`, `playbookCatalogGraph`) and hand it here; keep the selection in navigation (`selectedNodeId`, `onNodeActivate`). | Do not use to EDIT a graph: it is read-only by construction. Do not use for a domain model, which has cycles by nature and keeps its own grid layout. Do not hand-build React Flow nodes for a process: an edge drawn from data the record does not hold is the defect this replaces. |
239
+
231
240
  ## Form (3)
232
241
 
233
242
  | Component | Renders | Use when | Avoid when |
@@ -273,7 +282,7 @@ an application reaches those through configuration, never through JSX.
273
282
  | --- | --- | --- | --- |
274
283
  | `Checkbox` | Binary choice aligned with design-system checkbox recipe. | Use for explicit opt-in flags and multi-select groups. | Avoid for immediate settings that behave like hardware switches; consider `Switch`. |
275
284
  | `Switch` | Slider-style on/off control. | Use for feature toggles and binary preferences. | Avoid when a checkbox better matches form semantics (e.g. terms acceptance). |
276
- | `Toggle` | Button-styled boolean control for dense toolbars. | Use inside `ToggleGroup` or standalone icon toggles. | Avoid when a sliding switch metaphor is required. |
285
+ | `Toggle` | Button-styled boolean control for dense toolbars. | Use for a standalone pressable toggle, often icon-only; a group of toggles is `ToggleGroup` with its own `ToggleGroupItem`. | Avoid when a sliding switch metaphor is required. |
277
286
  | `ToggleGroupBoolean` | Two-state segmented control. | Use when UX requires explicit Yes/No chips. | Avoid when more than two states are needed; use `ToggleGroup`. |
278
287
 
279
288
  ## Form / Controls / Date Time (8)
@@ -297,7 +306,7 @@ an application reaches those through configuration, never through JSX.
297
306
  | `RadioGroupItem` | Radix radio indicator paired with labels inside `RadioGroup`. | Use when composing custom radio layouts that still resolve through the registry. | Prefer the bundled `RadioGroup` options API for standard cases. |
298
307
  | `Select` | Trigger + popper list wired to `FieldOption` metadata. | Use for static enumerations with predictable cardinality. | Avoid when search/async filtering is required; use `Combobox`. |
299
308
  | `SelectMultiple` | Popover checklist for many-to-one enum arrays. | Use when users must pick several visible options. | Avoid for single selection; use `Select`. |
300
- | `ToggleGroup` | Toolbar-style option chips with shared sizing variants. | Use for compact enum switching (filters, alignment modes). | Avoid when a dropdown saves space better. |
309
+ | `ToggleGroup` | SEGMENTED: options in a recessed track, the selected one raised as a thumb. CHIPS: outlined chips, tinted with a check mark when on. | Use SEGMENTED for a short single choice that should stay in view (a status filter, an alignment mode), CHIPS for additive filters or tags. | Avoid SEGMENTED beyond about five options or with long labels (it clips in a narrow container; use a select there), and CHIPS for one exclusive choice. |
301
310
 
302
311
  ## Form / Controls / File (2)
303
312
 
@@ -313,10 +322,11 @@ an application reaches those through configuration, never through JSX.
313
322
  | `RangeSlider` | Range selection mapped to `{ from, to }` values. | Use for budgets, time windows, or tolerance bands. | Avoid for single scalar values; use `Slider`. |
314
323
  | `Slider` | Drag affordance bound to min/max/step. | Use for continuous numeric parameters (volume, probability). | Avoid for paired min/max; use `RangeSlider`. |
315
324
 
316
- ## Form / Controls / String (6)
325
+ ## Form / Controls / String (7)
317
326
 
318
327
  | Component | Renders | Use when | Avoid when |
319
328
  | --- | --- | --- | --- |
329
+ | `ChipsInput` | A tags-style input: the values read as the same neutral chips the read view shows, and the text input at the end of the row is where the next one is typed. | Use for a string array read as a SET — free-form tags on a record, keywords, labels — where each value is a short word or two. A string array declaring `ArrayListStyle.CHIPS` is edited with this control automatically. | Avoid for values chosen from a CLOSED vocabulary (an enum array already renders a multi-select of its own members), for ordered lists where position means something (a checklist, steps), and for values long enough to wrap — a chip holds a word, not a sentence. |
320
330
  | `ColorInput` | Chooses a CSS color value for theming or design tools. | Use for brand color pickers or theme overrides. | Avoid when a simple text token is enough. |
321
331
  | `InlineEditText` | An in-place text control that reads as content until it is edited — single click focuses and selects, double-click or Enter/F2 enters edit, Enter or blur commits, Escape cancels. | Use where a value is read far more often than it is changed and a form would be heavier than the edit itself — a checklist item, a title on a card, a renameable label in a list. | Avoid inside a form that already has an explicit save (the control commits on its own, so two commit paths would disagree), and avoid for a value that must be validated against others before it is accepted — a form field can refuse, this control only commits or cancels. |
322
332
  | `InputOTP` | OTP capture for MFA and email/SMS verification. | Use when verifying short numeric or alphanumeric codes. | Avoid for full passwords or unconstrained text. |
@@ -393,7 +403,7 @@ an application reaches those through configuration, never through JSX.
393
403
  | `ApplicationLevel_CommandMenu` | Application-level wrapper around the search palette with container placement hooks, a responsive open trigger (full input-like control, or compact icon on mobile / collapsed rail) with per-placement width, a desktop dialog-width cap plus mobile bottom-drawer shape, and a unified record-above-command ordered result list. | Use for a searchable everything-palette across the app shell (records + quick actions); host it in the menubar and/or sidebar `hostedComponents` (with a per-placement `triggerWidth`) to show a visible search trigger reachable on mobile; enable `OMNIBOX` policy with `searchResources` when users should search live resource records (e.g. todos, tasks) — set `searchResources[].order` to tune where each record group sits relative to the command categories. | Avoid when page-local command surfaces (`LOW_LEVEL_COMMAND`) suffice. |
394
404
  | `ApplicationLevel_ControlPanel` | Shell control panel preset with placement and behavior hooks from app configuration. | Use when secondary tools should live beside main content without a route change. | Avoid when a modal or dedicated page communicates the tools more clearly. |
395
405
  | `ApplicationLevel_MenuBar` | Wraps the low-level menubar primitives with app-level layout and behavior. | Use for desktop shells that expose File/Edit-style menus across the top edge. | Avoid on mobile-first layouts without horizontal space for a menubar. |
396
- | `ApplicationLevel_MenuUserOrg` | Application-level dropdown preset combining avatar trigger and structured sections. | Use in the shell header for account switching and session management. | Avoid when authentication is anonymous or handled entirely off-app. |
406
+ | `ApplicationLevel_MenuUserOrg` | Application-level dropdown preset combining avatar trigger and structured sections. Above sign-out it links the application's privacy notice (opening `/privacy` in a new tab) whenever the application serves one, whichever sections are configured, so a person signed in by their identity provider reaches the notice from the application itself (#2983). | Use in the shell header for account switching and session management. | Avoid when authentication is anonymous or handled entirely off-app. |
397
407
  | `ApplicationLevel_NavigationBack` | Icon button integrated with routing/resource header patterns. | Use inside nested resource layouts where users need an explicit up-level action. | Avoid when browser back or breadcrumbs already cover wayfinding. |
398
408
  | `ApplicationLevel_NotificationCenter` | Application-level surface distinct from the low-level `NotificationCenter` feedback widget. | Use when notifications should be reviewable from a persistent shell control. | Avoid duplicating toast-only flows that never need an inbox. |
399
409
  | `ApplicationLevel_QuickActionButton` | FAB-style shell control wired to app quick-action configuration. | Use when a single high-priority action should stay thumb- or cursor-close. | Avoid when multiple equal actions belong in a balanced toolbar instead. |
@@ -401,7 +411,7 @@ an application reaches those through configuration, never through JSX.
401
411
  | `ApplicationLevel_Sidebar` | App-level preset layered on `LOW_LEVEL_SIDEBAR` primitives with behavior hooks. | Use as the primary navigation column for multi-resource SaaS shells. | Avoid when navigation should live solely in top tabs or a single hub page. |
402
412
  | `ApplicationLevel_StatusBar` | Thin shell chrome that aggregates lightweight operational telemetry. | Use when users need persistent awareness without opening a panel. | Avoid when toast notifications or inline indicators already cover the same signals. |
403
413
  | `ApplicationLevel_Toolbar` | Horizontal shell region hosting icon buttons, splits, and responsive overflow. | Use when 3–7 high-frequency actions should stay one click away. | Avoid when actions are rarely used — prefer menus or command palette. |
404
- | `ApplicationLevel_UtilityPanel` | Shell utility region with show/hide behavior tied to app configuration. | Use when persistent helper UI should coexist with main canvas content. | Avoid when a single sliding drawer or modal covers the helper use case. |
414
+ | `ApplicationLevel_UtilityPanel` | Modal side sheet over the workspace, opened from a shell control. Its items render inside it; a record an item links to opens in the workspace, and the sheet closes whenever the workspace beneath it changes. | Use for a helper consulted on demand that may point the person at records, such as an AI assistant: it opens over the current page and gets out of the way when the person follows a link. | Avoid for content that must stay visible beside the page while the person works in it (the sheet is modal and closes when the page changes); open it in a pane instead. Avoid for content that is itself the destination; give it a page. |
405
415
 
406
416
  ## Overlays / Containers (5)
407
417
 
@@ -429,7 +439,7 @@ an application reaches those through configuration, never through JSX.
429
439
  | --- | --- | --- | --- |
430
440
  | `ProgressionMilestoneTracker` | A card summarising milestone progress — from a one-line glance to a full per-category breakdown, chosen by `variant`. | Use on a dashboard, a home screen or an achievements page when the application declares milestones and wants people to see their progress. Pick the variant by how much of the screen progression deserves there. | Avoid when the application declares no milestones (the card renders nothing useful), and do not use it to show a single milestone's celebration — that is the celebration overlay, which fires on its own when a milestone is reached. |
431
441
 
432
- ## Resources (19)
442
+ ## Resources (20)
433
443
 
434
444
  | Component | Renders | Use when | Avoid when |
435
445
  | --- | --- | --- | --- |
@@ -443,13 +453,14 @@ an application reaches those through configuration, never through JSX.
443
453
  | `ResourceLayout_Create` | Resource creation layout shell. | Use on CREATE operations generated by the resource framework. | Avoid for non-resource standalone forms. |
444
454
  | `ResourceLayout_DangerZone` | Fenced, destructive-toned section at the bottom of the read view, hosting destructive actions as rows (title, description, button). | Use when a resource exposes destructive (DANGER_ZONE-placement) operations that should be segregated out of the primary action bar. | Avoid when the resource has no destructive operations; the section renders nothing. |
445
455
  | `ResourceLayout_Filters` | Filter controls layout for resource collections. | Use on LIST or SEARCH when filter definitions exist for the resource. | Avoid when the operation has no filter schema. |
446
- | `ResourceLayout_Header` | Primary resource header chrome. | Use on operations that need consistent resource titling. | Avoid stuffing unrelated widgets into the header; prefer toolbars. |
456
+ | `ResourceLayout_Header` | Primary resource header chrome. | Use on operations that need consistent resource titling. | Avoid stuffing unrelated widgets into the header; prefer toolbars. Do not restyle the title in a header template — its voice is the theme recipe — and do not put the record's actions in the bar: they belong on the title line, beside the name they act on. |
447
457
  | `ResourceLayout_List` | Primary LIST/SEARCH surface that composes resource chrome with the collection renderer; presents as stacked cards or a sortable table per the operation `displayMode`, optionally letting the user switch (choice persisted per resource). | Use for generated LIST operations that need the standard resource list layout lane. | Avoid when the operation replaces the entire view with a custom resource view override. |
448
458
  | `ResourceLayout_OperationBulk` | Bulk operations host for selected rows. | Use when LIST enables multi-select with bulk semantics. | Avoid when selection is not supported. |
449
459
  | `ResourceLayout_OperationsItems` | Inline item operations renderer. | Use for row-level actions in collections. | Avoid replacing the entire row renderer unless intentional. |
450
460
  | `ResourceLayout_Pagination` | Collection pagination strip. | Use for paginated LIST/SEARCH surfaces. | Avoid when the backend uses infinite scroll only. |
451
461
  | `ResourceLayout_Read` | Hosts the canonical detail page shell for one resource operation, including header, detail display, inserted views, and nested surfaces. | Use this component target when the UI needs the framework-owned resource detail shell through the standard resource-layout preset lane. | Avoid treating this target as the home of operation-owned custom views. Resource-specific read overrides belong to the resource specification and UI behavior metadata, not to this injectable component family. |
452
462
  | `ResourceLayout_ReadSummary` | Condensed read layout distinct from the full `RESOURCES_LAYOUTS_READ` shell. | Use when LIST, SEARCH, or nested views need a lighter read preview. | Avoid when the full detail read page is required. |
463
+ | `ResourceLayout_RecordSharing` | Section at the bottom of the read view, before the danger zone: a provenance line, the relationships that read the record without a share, one row per relationship the record is shared with (withdraw, marked when the share changes nothing), and a choice of the relationships a share would let read it, with Share, confirmed first when the share verb is HIGH risk. | Mounted by the default read layout on every record; it hides itself unless the resource separates its records between relationships, the record belongs to the current organization, that organization grants in some relationship kind, and the viewer may perform `readRecordSharing` and `shareRecord`. Mount it in a custom read view that does not wrap the default read preset. | Do not mount it on a resource that is not organization-scoped or that issues authority (memberships, credentials, sign-in configuration, relationships): it renders nothing there. It is not where a representative sees anything: the read it uses answers the organization's administrators only. |
453
464
  | `ResourceLayout_Search` | Primary SEARCH surface for resource discovery flows. | Use for generated SEARCH operations that participate in the resource layout system. | Avoid when replacing the view entirely with a custom search experience unrelated to resource config. |
454
465
  | `ResourceLayout_Update` | Resource update layout shell. | Use on UPDATE operations from the resource framework. | Avoid for wizard flows that are not operation-backed. |
455
466
 
@@ -63,13 +63,17 @@ Group multiple row- or toolbar-level actions with overflow handling, separators,
63
63
  **Props**
64
64
 
65
65
  - `items` **(required)** — Declarative list of buttons, separators, and sub-groups that make up the toolbar. Array of `ActionBarItem`.
66
+ - `items` note: An item that cannot run (`disabled`, or `unavailability` carrying the reason) is never drawn with its authored emphasis: a `DEFAULT`, `SECONDARY` or `ACCENT` item is drawn plain (`resolveDrawnActionVariant`), while a `DESTRUCTIVE` risk colour stays. A running item (`busy`) is not refused and keeps its look.
66
67
  - `maxDisplayed` — Maximum directly visible actions before remaining items move to the overflow menu. Type: `number`.
67
68
  - `maxDisplayed` note: When omitted, all items render inline (no overflow) unless the caller passes an explicit limit.
69
+ - `maxDisplayed` note: When the bar overflows, the slots each group (the actions between two separators) holds in priority order go first to its actions that can run, then to its refused ones (`allocateActionBarSlots`); shown items keep their own order. Nothing crosses a separator, so a danger-zone action never takes a primary slot. A refused action in the menu shows its reason under its label.
68
70
  - `size` — Icon button size for action entries in the bar. **Enum** `ButtonSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `icon-sm` · `icon`.
69
71
  - `icon-sm` — Default compact toolbar buttons.
70
72
  - `icon` — Larger hit targets when density allows.
71
73
  - `labelDisplayMode` — How the bar renders action labels. When omitted, falls back to the app-wide default (`ComponentStyleTheme.actionLabelDisplayMode` via `useUI()`). `INLINE` renders label text inside each button; `TOOLTIP` keeps buttons icon-only with tooltip labels; `DROPDOWN` collapses every action into the overflow `…` menu (icon + label per row). **Enum** `ActionLabelDisplayMode` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `TOOLTIP` · `INLINE` · `DROPDOWN`.
72
74
  - `labelDisplayMode` values note: Omitting the prop inherits the app policy; resource views may override it via `layout.actionLabelDisplayMode`.
75
+ - `labelDisplayMode` values note: One exception to `TOOLTIP`, scoped to the record header: inside `EmphasisedActionLabelsProvider` an EMPHASISED action (variant `DEFAULT`, `SECONDARY` or `ACCENT`), a single button or a sub-group trigger, shows its label, while the plain ones stay icons. A bare emphasised icon read as a pressed toggle, not as the main verb. Every other bar keeps its label mode as given.
76
+ - `labelDisplayMode` values note: The label follows the AUTHORED variant, so a refused emphasised action in the header keeps its words while it is drawn plain: the header does not reflow when the record changes state, and the person can still read what is refused and open the reason.
73
77
  - `TOOLTIP` — Icon-only buttons with tooltip labels.
74
78
  - `INLINE` — Label text rendered inside each button.
75
79
  - `DROPDOWN` — All actions collapse into the overflow menu (icon + label rows).
@@ -179,7 +183,7 @@ Displays and edits the system/developer prompt spec for an agent.
179
183
 
180
184
  ## `AI_ApprovalQueue`
181
185
 
182
- Queue of pending approvals with per-item metadata; each item may offer the argument editor (`allowArgumentModification`) and a reason picker (`reasonCodeOptions`) for a reviewer correcting the proposal.
186
+ Queue of pending approvals with per-item metadata; each item may offer the argument editor (`allowArgumentModification`) and a reason picker (`reasonCodeOptions`) for a reviewer correcting the proposal, or, for a decision that asks its own question (`question`), its own named options and fields in place of approve and deny, answered through `onAnswer` — with the reason picker beside them when the question reviews an agent's work and carries `reasonCodeOptions`. It draws its own read states (`isLoading`, `loadFailed` with `onRetry`), a filter field, and an optional order by the risk each call's gate declares.
183
187
 
184
188
  **Composition**
185
189
 
@@ -211,7 +215,7 @@ Browseable list of artifacts with typed previews (text, file, structured).
211
215
 
212
216
  ## `AI_Canvas`
213
217
 
214
- React Flow canvas hosting agent graphs with project defaults.
218
+ React Flow canvas for agent graphs. The host declares its interaction (VIEW reads and refits on resize, and tells the host where that refit left the view (`onRefit`) so the host can tell it from the reader moving the map; EDIT lets a person arrange the map and never refits on its own), and may ask for a minimap coloured per node and a legend in its own words. Its colours follow the theme, light or dark, and it does not animate for a reader who asked for reduced motion.
215
219
 
216
220
  **Composition**
217
221
 
@@ -281,6 +285,31 @@ Scroll-managed conversation viewport with empty state and scroll-to-latest contr
281
285
 
282
286
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
283
287
 
288
+ ## `AI_ConversationThread`
289
+
290
+ A whole conversation with an assistant: what was said, what each turn did (its tool calls, the records it showed the person as summary cards, its shown reasoning, the sources it cited), the decision a paused turn waits on, how the latest turn ended (working, stopped, failed, interrupted), a composer with Stop, and the list of discussions.
291
+
292
+ **Props**
293
+
294
+ - `model` **(required)** — What the thread shows: its lines in order and how the latest turn stands. Built by `conversationThreadModel`. Type: `ConversationThreadModel` from `@wildo-ai/saas-frontend-lib`.
295
+ - `emptyState` — Shown when the thread has nothing to draw — no line, no turn in flight, no trailing content: a title and an optional description, already worded by the host.
296
+ - `renderApproval` — Draws the decision a paused turn waits on, in place of the engine’s approval card. Signature: `(executionId: string) => React.ReactNode`.
297
+ - `toolCallTitle` — The heading of a tool call’s card, at any phase: what the call is about, never that it is running. Return undefined to keep the default. Signature: `(trace: FlowsActors_ToolTraceData) => string | undefined`.
298
+ - `toolCallInProgress` — The working line while a call is being made. Return undefined to keep the default. Signature: `(trace: FlowsActors_ToolTraceData) => string | undefined`.
299
+ - `renderTurnState` — Replaces the line drawn for how the latest turn stands. Return undefined to keep the default for that state. Signature: `(model: ConversationThreadModel) => React.ReactNode | undefined`.
300
+ - `children` — Drawn after the latest turn: a host’s own turn, such as an interview.
301
+
302
+ **Composition**
303
+
304
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
305
+ - Presentational: it reads no thread and sends nothing. The model carries the stored thread as the authority and the live turn as an overlay that steps aside, part by part, once the record holds it.
306
+ - A call is named by the host's words when it gives them (`toolCallTitle`, `toolCallInProgress`), else by the engine's: a resource read by the resource's title, a show-records call by what it shows. Any other call is an application's own tool (#2551), named by its own words, `flows_actors_tools.<tool name>.title` on its card and `.working` on the working line, which the labelling pipeline plans from every function tool the application registers (`flowsActorsToolLabelKey`). A tool with no generated words is shown by its name.
307
+ - Seams instead of forks: `renderApproval` replaces the default approval card, `toolCallTitle` heads a host’s tool cards and `toolCallInProgress` words its working line (kept apart: a card outlives the call, so it must not say it is running), `renderTurnState` rewords how a turn ended, `children` draws a host’s own latest turn.
308
+ - `.Composer` (`AI_ConversationThreadComposerProps`): `placeholder`, `onSubmit(text)` with the trimmed message, and `onStop` — when given, Stop replaces Send while the latest turn can be stopped (`model.stoppable`, stopping `model.activeExecutionId`). `sendDisabled` holds Send back while the text stays editable (a turn in flight, an assistant not yet available); `disabled` locks the whole composer; `submitting` marks a send in flight; `footerStart` holds the host’s own line beside Send. It also takes the form’s attributes, for a host’s `data-*` hooks.
309
+ - `.Discussions` (`AI_ConversationThreadDiscussionsProps`): `discussions` ({ id, title }; an empty title is worded as untitled at render), `currentId`, `onNew`, `onSelect(id)`, and `onDelete(id)` — the delete control appears only when it is given — and `onLoadOlder` with `loadingOlder`, which offer the next older page after the last row only when it is given (#2528). Rows are drawn by the theme’s selectable recipe and the controls are the framework’s Button.
310
+ - A successful call to a tool that shows records (`presentRecordsTool`, read back by `presentedRecordsOf`) is not a tool card: it draws a heading (the agent's, else the resource's title) and one card per record, each holding its summary through `ResourceFieldDisplay_ResourceReference`. The cards sit in a display context carrying only the TENANCY — the organization the tool read in (`presentedInOrganizationId`), else the viewer's, and the application, never the viewer's user or a quick-switcher selection — and the host's zone, else PRIMARY. Each card is fetched with the viewer's session each time the conversation is drawn, and opens its record when the resource has a page in that tenancy (a user-nested or API_ONLY target is drawn without a link). While the call runs it is a tool card titled by what it is showing; a failed or refused one stays a tool card titled by what it tried to show. `toolCallTitle` heads neither the cards nor those two.
311
+ - Selected via `FlowsActorsViewDefinition.layoutPreset`: a preset registered under that name for this component type draws the view. An unregistered name does not fall back to Default: each part draws the not-injected placeholder.
312
+
284
313
  ## `AI_DecisionRequest`
285
314
 
286
315
  Presents discrete decision options for the user to pick from.
@@ -305,6 +334,33 @@ Bezier edge representation with source/target handles for React Flow.
305
334
 
306
335
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
307
336
 
337
+ ## `AI_GraphViewer`
338
+
339
+ A process drawn read-only from a GraphView (#2529): a plan and what each step waits on, a run and the decision it waits on, a flow, the rounds of a choreography, a playbook catalog and what unlocks what.
340
+
341
+ **Props**
342
+
343
+ - `graph` **(required)** — The process to draw, built by the adapter for its record kind (`executionPlanGraph`, `actorSystemExecutionGraph`, `flowGraph`, `choreographyGraph`, `playbookCatalogGraph`). Never hand-built: an edge the record does not hold is not drawn. Type: `GraphView` from `@wildo-ai/saas-frontend-lib`.
344
+ - `direction` **(required)** — Which way the ranks run. **Enum** `GraphViewLayoutDirection` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `LR` · `TB`.
345
+ - `LR` — Left to right: a flow, a plan, what each step waits on.
346
+ - `TB` — Top to bottom: a hierarchy, or the rounds of a choreography read down the page.
347
+ - `title` **(required)** — The process's accessible name, in the host's words (a label, never an identifier). Type: `string`.
348
+ - `selectedNodeId` — The step the host has open. Keep it in navigation (the URL or a pane), not in component state: the selection follows where the person is. Type: `string`.
349
+ - `onNodeActivate` — A step was opened, by a click or by Enter or Space on it. Open its detail (a pane or a sheet) and pass its id back as `selectedNodeId`. Signature: `(node: GraphViewNode) => void`.
350
+ - `onDecisionActivate` — The decision the run waits on was opened from the banner. Without it the banner only says the run waits. Signature: `(decisionId: string) => void`.
351
+ - `renderNodeBody` — What a step shows under its name. Its status is always shown; this adds the host's own detail. Signature: `(node: GraphViewNode) => React.ReactNode`.
352
+ - `minimap` — A miniature of the whole drawing, for a process too large to read at once. Type: `boolean`.
353
+ - `defaultPresentation` — How the process is first shown; the person can switch. **Enum** `GraphViewerPresentation` from `@wildo-ai/saas-frontend-lib` — import it and pass a MEMBER, not a string. Values: `graph` · `list`. Default `graph`.
354
+ - `graph` — The drawing: steps in ranks, joined by arrows. The default.
355
+ - `list` — Every step in order, a group's steps nested under it: the process read without the drawing.
356
+
357
+ **Composition**
358
+
359
+ - Tier-2 / framework-internal: not registered in `ComponentRegistry` (see `assert-registry-completeness.frontend.helper.ts` KNOWN_NON_REGISTERED_COMPONENT_TYPES).
360
+ - Reached through the flows-actors graph door (`flows-actors-graph.lazy.tsx`), so the graph library loads only with a drawing; `GraphViewerPresentation` is exported eagerly.
361
+ - Every edge leaves from the port it names; steps are placed by `layoutGraphView` at the size React Flow measured them at; a step waiting on a person is drawn amber; Tab reaches each step, brings it into view when it is off the visible part of the drawing, and Enter or Space opens it.
362
+ - A host may hand over a new GraphView on every update of a live run: only a change of its structure (nodes, nesting, edges, direction) lays it out again and refits it, so a step or round added while the run goes on is drawn and fitted in, and a status update keeps the drawing, the focused step and the reader's zoom, a zoom chosen after the canvas refitted itself on a resize included. Each node carries the size React Flow last REPORTED for it (`onNodesChange`), so an update does not make React Flow measure every step again; a size read back afterwards could be older than the measurement, and adopting it put the old height back over the new one. The open step is announced as current (`aria-current`), not as a pressed toggle; a step focused from the keyboard is brought into view, a clicked one is not.
363
+
308
364
  ## `AI_HumanInputRequest`
309
365
 
310
366
  Collects open-ended human input required to continue a run.
@@ -355,7 +411,7 @@ Command-dialog model picker with search and keyboard selection.
355
411
 
356
412
  ## `AI_Node`
357
413
 
358
- Card-styled graph node with handle visibility for inputs/outputs.
414
+ Card-styled graph node whose edges attach to declared handles: each handle names its role (an edge ends there or starts there), the side it sits on and, when a node has several on one side, its id, so a branch's edges leave from separate points.
359
415
 
360
416
  **Composition**
361
417
 
@@ -388,7 +444,7 @@ Collapsible plan card summarizing steps and progress.
388
444
 
389
445
  ## `AI_PromptInput`
390
446
 
391
- Full composer: attachments, model tabs, speech, slash commands, and submit.
447
+ The chat composer: a text field and a send button in one input group that the theme draws like any other field, with optional attachments, an action menu, slash-command lists, model selection and speech input.
392
448
 
393
449
  **Composition**
394
450
 
@@ -601,6 +657,8 @@ User + organization account menu with profile, billing, and sign-out affordances
601
657
 
602
658
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
603
659
  - D1 alignment: enum `APPLICATION_LEVEL_USER_DROPDOWN` pairs with the `ApplicationLevel_MenuUserOrg` consumer export and `ApplicationLevelPreset_MenuUserOrg_Default` preset implementation.
660
+ - The organization switcher lists the organizations the session holds: the newest 20 memberships the user context carries, plus any loaded on demand. When the person belongs to more (counted from the backend access profile), it adds a search box that finds the others through `GET /organizations/search/mine` and loads the one chosen on demand.
661
+ - Every row a person acts on (organization options, settings rows, the privacy notice, sign-out) is a dropdown-menu item, so the menu follows the WAI-ARIA menu-button keyboard contract: Enter, Space or Down Arrow opens it on the first row, the arrow keys, Home and End move between rows, Enter or Space activates one, and Escape closes it back onto its button (#2986). The organization search box is joined to that order: Up Arrow from the first row below it enters the box, and Down Arrow leaves it.
604
662
 
605
663
  ## `ApplicationLevel_NavigationBack`
606
664
 
@@ -648,7 +706,7 @@ Application shell sidebar that composes resource navigation, mode hints, and col
648
706
  - Active/hover item states consume the theme SELECTABLE/FILLED recipe via `data-active` (overlay + font-medium — never a primary tint); the collapse toggle sits at the sidebar bottom and reveals on region hover / focus-within (always visible for coarse pointers).
649
707
  - Responsive: with `responsivePolicy: BURGER` at/below the configured `responsiveBreakpoint` (default MOBILE) nothing renders inline — the sidebar opens as a Sheet overlay drawer (backdrop click / Escape close, focus trapped) toggled by the menubar burger or `HOTKEY_SIDEBAR_TOGGLE`; `DRAWER` policy keeps the inline column and auto-expands above the threshold. Whole-rail collapse state persists in localStorage and hydrates synchronously on mount; active-item highlight is keyed on item identity (one winner among duplicate url paths).
650
708
  - Section placement is engine policy rather than declaration order: a navigation-list section declaring `isPrimary` heads the column as one unlabeled, non-collapsible group, a `SidebarSectionBehavior.FAVORITES` section follows it and is omitted entirely while the user has starred nothing, and every other section keeps its declared order. Favorites are user-curated through a hover-revealed star affordance on each row (filled while starred) and persist machine-locally.
651
- - The application HOME affordance is exactly one of three authored presentations (`SIDEBAR.homeDisplayMode`): a navigation row heading the primary group (default), a brand header pinned above the scroll region — the application brand mark for the active light/dark theme plus its display name, doubling as the home button and degrading to the name alone when no brand asset resolves — or no home affordance at all. The brand header is presented as product identity rather than a navigation row — it takes the hover wash but never the selected fill, and sets its own type register — and the mark variant it shows (adaptive colour, monochrome, or a pinned light/dark side) is authored separately from the mode.
709
+ - The application HOME affordance is exactly one of three authored presentations (`SIDEBAR.homeDisplayMode`): a navigation row heading the primary group (default), a brand header pinned above the scroll region — the application brand mark for the active light/dark theme plus its display name (the current organization's logo replaces the mark while its custom branding is in effect; the name stays the application's), doubling as the home button and degrading to the name alone when no brand asset resolves — or no home affordance at all. The brand header is presented as product identity rather than a navigation row — it takes the hover wash but never the selected fill, and sets its own type register — and the mark variant it shows (adaptive colour, monochrome, or a pinned light/dark side) is authored separately from the mode.
652
710
 
653
711
  ## `ApplicationLevel_StatusBar`
654
712
 
@@ -668,7 +726,7 @@ Primary action toolbar aligned with the current route or resource context.
668
726
 
669
727
  ## `ApplicationLevel_UtilityPanel`
670
728
 
671
- Secondary utility column for assistants, logs, or contextual helpers opposite the sidebar.
729
+ A side sheet the person opens on demand, holding an assistant or a contextual helper over whatever they are doing.
672
730
 
673
731
  **Composition**
674
732
 
@@ -700,6 +758,14 @@ OAuth/OIDC and SAML callback handler surface that exchanges the one-time code an
700
758
 
701
759
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
702
760
 
761
+ ## `Auth_ChatIdentityLink`
762
+
763
+ Page where a signed-in member completes the one-time link a chat bot (Slack, Microsoft Teams) gave them: it shows which chat account the link names, warns to continue only if the account is theirs, and links it on explicit confirmation.
764
+
765
+ **Composition**
766
+
767
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
768
+
703
769
  ## `Auth_ConfirmEmail`
704
770
 
705
771
  Email confirmation token validation and success/failure messaging.
@@ -734,7 +800,7 @@ Consumes magic-link token query params, completes the passwordless session, and
734
800
 
735
801
  ## `Auth_Main`
736
802
 
737
- Primary sign-in orchestration with method-specific templates and OAuth section; signup surfacing is gated by the resolved public-registration policy.
803
+ Primary sign-in orchestration with method-specific templates and OAuth section; signup surfacing is gated by the resolved public-registration policy. It links the application's privacy notice whenever the application serves one, because sign-in is usually the first screen a person meets, and for staff provisioned by an identity provider often the only one before their data is processed.
738
804
 
739
805
  **Composition**
740
806
 
@@ -845,6 +911,7 @@ Compact status or metadata chip with semantic colour variants.
845
911
  - `info` — Informational emphasis.
846
912
  - `success` — Positive completion state.
847
913
  - `warning` — Caution or attention-needed state.
914
+ - `dot` — Leads the label with a small dot in the badge's own tone — the form a STATE takes (an enum rendered as a badge with no glyph of its own). A count or a plain label leaves it off. Type: `boolean`. Default `false`.
848
915
  - `asChild` — Compose badge styling onto an existing child element. Type: `boolean`. Default `false`.
849
916
 
850
917
  **Status badge**
@@ -1124,6 +1191,48 @@ Boolean checkbox with optional indeterminate support inside compound API.
1124
1191
  - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1125
1192
  - Compound component with `Checkbox.Root` for advanced layouts.
1126
1193
 
1194
+ ## `ChipsInput`
1195
+
1196
+ Edits a set of short strings — tags, labels, keywords — as chips inside one input box, each chip removable, with a text input at the end that adds a value on Enter or a comma.
1197
+
1198
+ **Props**
1199
+
1200
+ - `value` **(required)** — The current set of values, in the order they were added. Array of `string`.
1201
+ - `onChange` **(required)** — Called with the next set whenever a value is added or removed. Signature: `(next: string[]) => void`.
1202
+ - `onBlur` — Called when focus leaves the control, after any pending draft has been added. Signature: `() => void`.
1203
+ - `validateItem` — Asked about each value before it is added; returns a message to refuse it, or undefined to accept. Signature: `(candidate: string) => string | undefined`.
1204
+ - `maxItems` — No more values can be added once the set holds this many; a value past it stays in the input with a message, and the input stays focusable. Type: `number`.
1205
+ - `placeholder` — Shown in the input while the set is empty. Type: `string`.
1206
+ - `disabled` — Renders the chips with no remove buttons and a disabled input. Type: `boolean`.
1207
+ - `readOnly` — Renders the chips only, with no remove buttons and no input. Type: `boolean`.
1208
+ - `id` — The text input's id, so a field label points at it. Type: `string`.
1209
+ - `ariaLabel` — Accessible name of the text input when no label points at it. Type: `string`.
1210
+ - `invalid` — Marks the control invalid for a field-level error. Type: `boolean`.
1211
+ - `controlSize` — Control density. **Enum** `ControlSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `md` · `sm`.
1212
+ - `md` — The default density, one input tall when empty.
1213
+ - `sm` — A denser control, for a toolbar or a compact form.
1214
+ - `className` — Layout classes for the group. Type: `string`.
1215
+
1216
+ **Composition**
1217
+
1218
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
1219
+ - The DEFAULT preset composes `InputGroup` and `InputGroupInput`, so it wears the application's input chrome, focus ring and invalid style, and each chip is the neutral `Badge` the read view renders.
1220
+ - A set, not a list: a value already present adds nothing. Enter and a comma add the draft (the commas other scripts type too), a paste splits on commas and new lines at the caret, Backspace in an empty input removes the last chip, and leaving the input adds a non-empty draft. Nothing typed is lost: a refused value, or one past maxItems, stays in the input with its message, and each add or remove is announced to a screen reader.
1221
+ - Validation happens BEFORE a value is added (`validateItem`): a refused value stays in the input with its message beneath, so it can be corrected rather than dropped.
1222
+
1223
+ **Tags on a record**
1224
+
1225
+ ```tsx
1226
+ import { ChipsInput } from '@wildo-ai/saas-frontend-lib';
1227
+
1228
+ <ChipsInput
1229
+ value={tags}
1230
+ onChange={setTags}
1231
+ maxItems={6}
1232
+ placeholder={t('todos.tags.placeholder')}
1233
+ />
1234
+ ```
1235
+
1127
1236
  ## `Code`
1128
1237
 
1129
1238
  Render inline monospace snippets (API identifiers, shell commands, short literals) with design-system code styling.
@@ -2725,7 +2834,7 @@ import { CorePresetNames } from '@wildo-ai/presets-components-models';
2725
2834
 
2726
2835
  ## `FormFieldString`
2727
2836
 
2728
- General string input (input, textarea, markdown, password, OTP, color, single organization role) from string UI metadata. `StringEditMode.ORGANIZATION_ROLE` picks ONE key of the organization role table the backend publishes (`organizationRoles`: core plus custom organization roles), each option worded from the `roles` labels, and falls back to a text input when no table is published.
2837
+ General string input (input, textarea, markdown, password, OTP, color, single organization role) from string UI metadata. `StringEditMode.ORGANIZATION_ROLE` picks ONE key of the organization role table the backend publishes (`organizationRoles`: core plus custom organization roles), each option worded from the `roles` labels, and falls back to a text input when no table is published. `offeredValues` (the values the field's operation offers, `requestFieldOffers`) narrows that table; with `organizationRoleTable: ANOTHER_ORGANIZATION` the field names a role held in another organization and offers `offeredValues` alone, a text input until there are some.
2729
2838
 
2730
2839
  **Composition**
2731
2840
 
@@ -3259,6 +3368,14 @@ import { ProgressionTrackerVariant } from '@wildo-ai/saas-models';
3259
3368
  <ProgressionMilestoneTracker variant={ProgressionTrackerVariant.DETAILED} className="w-full" />
3260
3369
  ```
3261
3370
 
3371
+ ## `PublicLayout_LegalNotice`
3372
+
3373
+ Public legal-notice (imprint) page at `/legal-notice`, rendering the operator identity particulars an information-society service provider established in the EU, the EEA, the UK or Switzerland must publish, from the application's `compliance.legalNotice` (projected from `operatorComplianceIdentity` by `wildo config legal-notice`).
3374
+
3375
+ **Composition**
3376
+
3377
+ - Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
3378
+
3262
3379
  ## `PublicLayout_MainContainer`
3263
3380
 
3264
3381
  Public / unauthenticated layout container with optional centered card chrome, and — when the application opts in via `publicShellIdentityMode` — the surface identity at the top of that card.
@@ -3431,7 +3548,7 @@ Resource list/search filter strip wired to filter state and backend query params
3431
3548
 
3432
3549
  ## `ResourceLayout_Header`
3433
3550
 
3434
- Title, description, and iconography for the active resource operation.
3551
+ The page header of a resource operation, in three lines: a bar (back, the parent breadcrumb, and — when the record is open in a split pane — that pane's expand and close), the title line (the resource icon, the title in the theme's `TypographyVariant.RESOURCE_TITLE` voice, and the record's actions), and the facts line (the rest of an authored `layout.header` template: status, priority, the parent chip). A collection's header adds its description under the title.
3435
3552
 
3436
3553
  **Composition**
3437
3554
 
@@ -3439,13 +3556,13 @@ Title, description, and iconography for the active resource operation.
3439
3556
 
3440
3557
  ## `ResourceLayout_List`
3441
3558
 
3442
- Framework list-operation shell for resource collections: a unified collection toolbar (expand-on-focus search, icon-only filters, multi-sort, and a cards/table view toggle), the collection renderer, and create entry points.
3559
+ Framework list-operation shell for resource collections: a two-line collection toolbar (the promoted quick filter as a segmented control; then one action row with the select-all, expand-on-focus search, icon-only filters, multi-sort, the preset pills, a cards/table view toggle and Create), the collection renderer, and create entry points.
3443
3560
 
3444
3561
  **Composition**
3445
3562
 
3446
3563
  - Default and table presets register in `registerFrameworkLayouts`; apps may add further list presets.
3447
3564
  - The DEFAULT preset owns the data fetch and renders the cards body or the table body in place, so toggling cards/table never refetches. The default body + whether a runtime toggle is shown come from the operation's `operationFrontendConfig.collectionDisplayConfig` (`displayMode` + `userSwitchableDisplayMode`), authored in the resource UI behavior — a pure FRONTEND concern, NOT on the shared resources-config. The table preset is a thin wrapper that seeds the table view.
3448
- - `collectionDisplayConfig` also carries: `cardLayout` (CARDS arrangement — a single-column bordered LIST or an N-column responsive GRID via `CardLayoutStyle`); `cardActionPlacement` (where each card's per-item actions sit — a 2-axis `VerticalPlacement`×`HorizontalPlacement` anchor + `DisplayDirection` orientation, MIDDLE×MIDDLE rejected); and `selectable` (opt-in per-item selection + bulk actions). Selection is a single host-level model shared by the cards checkbox and the table select column (keyed on `resourceFieldIdentifier`), clears on filter/search change but persists across pagination, and the bulk-action bar contextually replaces the Create action in the toolbar trailing zone while a selection is active. The table also renders a trailing per-row actions column mirroring the cards' per-item operations. All pure FRONTEND presentation.
3565
+ - `collectionDisplayConfig` also carries: `cardLayout` (CARDS arrangement — a single-column bordered LIST or an N-column responsive GRID via `CardLayoutStyle`); `cardActionPlacement` (where each card's per-item actions sit — a 2-axis `VerticalPlacement`×`HorizontalPlacement` anchor + `DisplayDirection` orientation, MIDDLE×MIDDLE rejected); and `selectable` (opt-in per-item selection + bulk actions). Selection is a single host-level model shared by the cards checkbox and the table select column (keyed on `resourceFieldIdentifier`), clears on filter/search change but persists across pagination, and while a selection is active the toolbar's action row becomes the selection bar: the select-all (in the rows' checkbox column), the count, then the bulk actions in place of Create; the refine controls and whole-scope collection actions step aside, and a bulk action no selected row can take is hidden. The table also renders a trailing per-row actions column mirroring the cards' per-item operations. All pure FRONTEND presentation.
3449
3566
  - Sort is one multi-sort model (`SortState[]`, priority = order) shared by the toolbar sort popover and the table column headers, serialized as `sort=field:dir,field:dir` with LIST/SEARCH parity (validated against the operation `sortFields` and applied at the repository).
3450
3567
 
3451
3568
  ## `ResourceLayout_OperationBulk`
@@ -3511,6 +3628,17 @@ Summarized read surface for a resource record, used in cards, drawers, or table
3511
3628
 
3512
3629
  - Default and table-row presets both register through `registerFrameworkLayouts`.
3513
3630
 
3631
+ ## `ResourceLayout_RecordSharing`
3632
+
3633
+ Record page section where an administrator of the granting organization sees whose a record is (the organization's own, or created through one of its organization relationships) and shares it with, or withdraws it from, a relationship.
3634
+
3635
+ **Composition**
3636
+
3637
+ - Preset implementations register in `registerFrameworkLayouts` in `@wildo-ai/saas-frontend-lib`.
3638
+ - Reads through `organization-relationships`: `readRecordSharing` answers the record's provenance and shares and, for every live relationship and every one the record names, what its people reach of the record (`confersNow`, `rolesReachRecord`, `readsWithoutShare`, `wouldReadIfShared`); `shareRecord` / `unshareRecord` change the shares. It lists nothing itself.
3639
+ - A resource the backend does not share (a system of record's rows) answers `RELATIONSHIP_RECORD_NOT_SHAREABLE`, and the section stays hidden.
3640
+ - A share is never presented as changing what it does not: the engine decides each relationship's reach with the request path's own predicates (the conferred roles, the READ's lent-capability narrowing, record separation), so a relationship already reading the record, one that confers nothing now, and one whose roles do not reach this record (its role, or its units) are not offered, and a resource declared in `relationshipCommonRecords` offers nothing. An existing share is always listed with its withdraw.
3641
+
3514
3642
  ## `ResourceLayout_Search`
3515
3643
 
3516
3644
  Framework search-operation shell combining query inputs, results, and resource chrome.
@@ -3815,7 +3943,7 @@ Render body and inline copy using the design-system text scale instead of ad-hoc
3815
3943
 
3816
3944
  **Props**
3817
3945
 
3818
- - `variant` — Semantic color variant for the text. **Enum** `TextVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `default` · `muted` · `subtle` · `contrast` · `destructive` · `success` · `inherit`.
3946
+ - `variant` — Semantic color variant for the text. Omitted, the text keeps the ink its typography recipe sets in the active theme, and the DEFAULT ink when that recipe sets none. Which voices carry an ink, and which ink, is each theme's decision rather than this component's — the same LABEL is plain in one theme and muted in another — so never assume one. Pass a variant only to override the theme. **Enum** `TextVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `default` · `muted` · `subtle` · `contrast` · `destructive` · `success` · `inherit`.
3819
3947
  - `default` — Primary body text color.
3820
3948
  - `muted` — Secondary / de-emphasized copy.
3821
3949
  - `subtle` — The third level, below MUTED: meta copy — a time, a count, an attribution — that must not compete with a description.
@@ -3823,10 +3951,12 @@ Render body and inline copy using the design-system text scale instead of ad-hoc
3823
3951
  - `destructive` — Error or danger-adjacent copy.
3824
3952
  - `success` — Positive status copy.
3825
3953
  - `inherit` — Match parent color.
3826
- - `typography` — The TYPOGRAPHY recipe the text is set in — BODY unless said otherwise; EYEBROW for a tracked uppercase label above a heading or a section. **Enum** `TypographyVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `body` · `eyebrow` · `description`. Default `body`.
3954
+ - `typography` — The TYPOGRAPHY recipe the text is set in — BODY unless said otherwise; EYEBROW for a tracked uppercase label above a heading or a section. **Enum** `TypographyVariant` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `body` · `eyebrow` · `description` · `resource-title` · `data`. Default `body`.
3827
3955
  - `body` — Body copy — the default.
3828
3956
  - `eyebrow` — A small tracked uppercase label above a heading or a section, worded by the theme.
3829
3957
  - `description` — Descriptive copy beneath a title.
3958
+ - `resource-title` — The name a page or pane is about, in the voice the resource header uses: a custom view composing its own header should title it with this rather than restyling a heading.
3959
+ - `data` — A figure — a date, an amount, a duration, a count — in the theme's data voice (tabular figures; monospace in the default theme). Every value formatter already uses it; a custom view showing a figure should too, rather than adding tabular-nums by hand.
3830
3960
  - `size` — Type scale mapped to design-system CSS variables. **Enum** `TextSize` from `@wildo-ai/presets-components-models` — import it and pass a MEMBER, not a string. Values: `xxs` · `xs` · `sm` · `base` · `lg`.
3831
3961
  - `xxs` — Meta / badge scale.
3832
3962
  - `xs` — Compact helper text.
@@ -3956,7 +4086,7 @@ Pressable toggle button styling (distinct from `Switch`).
3956
4086
 
3957
4087
  ## `ToggleGroup`
3958
4088
 
3959
- Segmented toggle group supporting single or multi selection.
4089
+ A group of toggles shown as one segmented control (a single choice along one axis) or as filter chips (independent toggles that combine), chosen by `appearance`.
3960
4090
 
3961
4091
  **Composition**
3962
4092