@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
@@ -0,0 +1,911 @@
1
+ # saas.models.organizations.organization-relationships
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/saas-models`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/saas-models`
10
+
11
+ ```typescript
12
+ /**
13
+ * Where an organization relationship stands. One member per distinct claim, so the record says WHO
14
+ * ended it and HOW.
15
+ *
16
+ * Only {@link OrganizationRelationshipStatus.ACTIVE} confers anything, and even then only while
17
+ * `endsAt` is absent or in the future — {@link isOrganizationRelationshipConferring} is the one
18
+ * predicate, and it reads `endsAt` itself rather than trusting {@link EXPIRED}.
19
+ */
20
+ export enum OrganizationRelationshipStatus {
21
+ /** Proposed by one side, awaiting the other. Confers nothing. */
22
+ PROPOSED = 'PROPOSED',
23
+ /** Accepted by the non-proposing side. Confers, subject to the live filter. */
24
+ ACTIVE = 'ACTIVE',
25
+ /** Paused by the granting organization. Confers nothing; `resume` returns it to ACTIVE. */
26
+ SUSPENDED = 'SUSPENDED',
27
+ /** The granting organization refused the representing organization's proposal. Terminal. */
28
+ DECLINED = 'DECLINED',
29
+ /**
30
+ * The representing organization ended it (or withdrew its proposal) — or the representing ORGANIZATION was deleted
31
+ * (the purge after its retention window, or an operator's immediate delete), which ends every relationship it serves
32
+ * the same way. Terminal.
33
+ */
34
+ WITHDRAWN = 'WITHDRAWN',
35
+ /**
36
+ * The granting organization ended it — or the granting ORGANIZATION was deleted (the purge, or an operator's immediate
37
+ * delete), which ends every relationship it holds the same way. Terminal.
38
+ */
39
+ TERMINATED = 'TERMINATED',
40
+ /** The sweep relabelled it after `endsAt`. Terminal bookkeeping — admission never reads this label. */
41
+ EXPIRED = 'EXPIRED',
42
+ }
43
+
44
+ /** Statuses from which a relationship can still move — at most one of these per (representing, granting) pair. */
45
+ export const ORGANIZATION_RELATIONSHIP_LIVE_STATUSES: readonly OrganizationRelationshipStatus[] = [
46
+ OrganizationRelationshipStatus.PROPOSED,
47
+ OrganizationRelationshipStatus.ACTIVE,
48
+ OrganizationRelationshipStatus.SUSPENDED,
49
+ ];
50
+
51
+ /** Statuses that end a relationship for good. Reaching one ends every assignment and representative membership. */
52
+ export const ORGANIZATION_RELATIONSHIP_TERMINAL_STATUSES: readonly OrganizationRelationshipStatus[] = [
53
+ OrganizationRelationshipStatus.DECLINED,
54
+ OrganizationRelationshipStatus.WITHDRAWN,
55
+ OrganizationRelationshipStatus.TERMINATED,
56
+ OrganizationRelationshipStatus.EXPIRED,
57
+ ];
58
+
59
+ /** One lifecycle audit row per transition, written to BOTH organizations' trails. */
60
+ export enum OrganizationRelationshipTransition {
61
+ PROPOSED = 'PROPOSED',
62
+ ACCEPTED = 'ACCEPTED',
63
+ DECLINED = 'DECLINED',
64
+ SUSPENDED = 'SUSPENDED',
65
+ RESUMED = 'RESUMED',
66
+ SCOPE_AMENDED = 'SCOPE_AMENDED',
67
+ TERMINATED = 'TERMINATED',
68
+ WITHDRAWN = 'WITHDRAWN',
69
+ EXPIRED = 'EXPIRED',
70
+ /**
71
+ * The granting organization changed how the representing organization's representatives are admitted (#1612) — see
72
+ * {@link RepresentativeAdmissionPolicy}. Not retroactive: representatives already admitted stay admitted.
73
+ */
74
+ REPRESENTATIVE_ADMISSION_POLICY_CHANGED = 'REPRESENTATIVE_ADMISSION_POLICY_CHANGED',
75
+ /**
76
+ * An operator changed one party's organization type and the declaration no longer allows this pair or role (#2611):
77
+ * the relationship's status is unchanged, but it confers nothing on the next request until a declaration or a type
78
+ * allows it again. Recorded in both trails, so the party that did NOT change learns its relationship went quiet.
79
+ */
80
+ DORMANT_BY_TYPE_CHANGE = 'DORMANT_BY_TYPE_CHANGE',
81
+ /**
82
+ * An operator changed one party's organization type and the declaration allows this pair and role again (#2611): a
83
+ * dormant relationship confers again, giving the representatives back the granting organization's data. Recorded in
84
+ * both trails — above all the granting organization's, which may not be the organization whose type changed.
85
+ */
86
+ REVIVED_BY_TYPE_CHANGE = 'REVIVED_BY_TYPE_CHANGE',
87
+ /**
88
+ * One party organization stopped operating (suspended, closed, or marked for deletion) and so confers nothing (#2795):
89
+ * the relationship's status is unchanged, but it confers nothing on the next request until that organization operates
90
+ * again. Recorded in both trails, so the OTHER party learns its relationship went quiet and why.
91
+ */
92
+ DORMANT_BY_PARTY_STATUS = 'DORMANT_BY_PARTY_STATUS',
93
+ /**
94
+ * One party organization operates again (reactivated or restored) and the relationship confers again (#2795): above all
95
+ * the granting organization's record, since another organization's people act in it again without anyone in it deciding so.
96
+ */
97
+ REVIVED_BY_PARTY_STATUS = 'REVIVED_BY_PARTY_STATUS',
98
+ }
99
+
100
+ /**
101
+ * Whether a transition GRANTS reach: another organization's people gain, regain or widen access to the granting tenant.
102
+ * The relationship lifecycle audit row is HIGH for these and MEDIUM for the rest, so a reviewer filtering to HIGH sees
103
+ * every moment a third party gained or widened access to a tenant (#2795 review F1). Total over the enum, so a transition
104
+ * added tomorrow is a compile error until someone decides which it is, rather than silently MEDIUM.
105
+ */
106
+ export const ORGANIZATION_RELATIONSHIP_TRANSITION_GRANTS_REACH: Readonly<Record<OrganizationRelationshipTransition, boolean>> = {
107
+ [OrganizationRelationshipTransition.PROPOSED]: false,
108
+ [OrganizationRelationshipTransition.ACCEPTED]: true,
109
+ [OrganizationRelationshipTransition.DECLINED]: false,
110
+ [OrganizationRelationshipTransition.SUSPENDED]: false,
111
+ [OrganizationRelationshipTransition.RESUMED]: true,
112
+ [OrganizationRelationshipTransition.SCOPE_AMENDED]: true,
113
+ [OrganizationRelationshipTransition.TERMINATED]: false,
114
+ [OrganizationRelationshipTransition.WITHDRAWN]: false,
115
+ [OrganizationRelationshipTransition.EXPIRED]: false,
116
+ // Changes how representatives are admitted, never whether the relationship reaches: not retroactive.
117
+ [OrganizationRelationshipTransition.REPRESENTATIVE_ADMISSION_POLICY_CHANGED]: false,
118
+ [OrganizationRelationshipTransition.DORMANT_BY_TYPE_CHANGE]: false,
119
+ [OrganizationRelationshipTransition.REVIVED_BY_TYPE_CHANGE]: true,
120
+ [OrganizationRelationshipTransition.DORMANT_BY_PARTY_STATUS]: false,
121
+ [OrganizationRelationshipTransition.REVIVED_BY_PARTY_STATUS]: true,
122
+ };
123
+
124
+ /** Whether a representative currently serves an engagement. */
125
+ export enum RepresentativeAssignmentStatus {
126
+ /** Designated by the representing organization; the representative holds a representative membership in the granting organization. */
127
+ ACTIVE = 'ACTIVE',
128
+ /**
129
+ * Unassigned, ended with the relationship, ended by the representative's erasure (#2920), or withdrawn while still
130
+ * awaiting the granting organization's approval. The membership in the granting organization (when one was ever
131
+ * created) is INACTIVE; the row is evidence.
132
+ */
133
+ ENDED = 'ENDED',
134
+ /**
135
+ * The representing organization assigned the representative under a relationship whose granting organization approves
136
+ * each representative (#1612), and the granting organization has not answered yet. Confers NOTHING by construction: no
137
+ * membership row exists in the granting organization, so there is no role entry, nothing in any membership consumer,
138
+ * and no (person, granting organization) slot taken.
139
+ */
140
+ PENDING_GRANTING_APPROVAL = 'PENDING_GRANTING_APPROVAL',
141
+ /**
142
+ * The granting organization refused the representative — or approved, but the relationship, the representative's
143
+ * membership in the representing organization or the (person, granting organization) slot no longer allowed admission
144
+ * when the approval was applied. Nothing was created. Terminal; `approvalDenialReason` says which.
145
+ */
146
+ DENIED = 'DENIED',
147
+ /** Nobody in the granting organization answered before the approval's lapse (decision deadlines, #1628). Nothing was created. Terminal. */
148
+ LAPSED = 'LAPSED',
149
+ }
150
+
151
+ /** Assignment statuses that still hold, or still wait for, a place in the granting organization — the ones a second assignment collides with. */
152
+ export const REPRESENTATIVE_ASSIGNMENT_LIVE_STATUSES: readonly RepresentativeAssignmentStatus[] = [
153
+ RepresentativeAssignmentStatus.ACTIVE,
154
+ RepresentativeAssignmentStatus.PENDING_GRANTING_APPROVAL,
155
+ ];
156
+
157
+ /**
158
+ * Why a per-representative approval ended without admitting the representative (#1612). Recorded on the assignment the
159
+ * representing organization reads, so it names a FACT the representing side may know — never the granting
160
+ * organization's administrator who answered.
161
+ */
162
+ export enum RepresentativeApprovalDenialReason {
163
+ /** An administrator of the granting organization refused the representative. */
164
+ REFUSED_BY_GRANTING_ORGANIZATION = 'REFUSED_BY_GRANTING_ORGANIZATION',
165
+ /**
166
+ * The granting organization approved, but the relationship no longer confers: it ended, was suspended or is past its
167
+ * term; its kind no longer admits the two organizations, the role or the unit scope (a dormant relationship, #2616);
168
+ * or the granting organization itself is suspended, cancelled or being deleted.
169
+ */
170
+ RELATIONSHIP_NO_LONGER_CONFERS = 'RELATIONSHIP_NO_LONGER_CONFERS',
171
+ /**
172
+ * The granting organization approved, but the representative is no longer an active, ordinary member of the
173
+ * representing organization, or the representing organization no longer confers authority.
174
+ */
175
+ REPRESENTATIVE_NO_LONGER_ELIGIBLE = 'REPRESENTATIVE_NO_LONGER_ELIGIBLE',
176
+ /**
177
+ * The granting organization approved, but the person meanwhile holds another membership in it (their own, a suspended
178
+ * one, or one through another representing organization).
179
+ */
180
+ CONFLICTS_WITH_GRANTING_MEMBERSHIP = 'CONFLICTS_WITH_GRANTING_MEMBERSHIP',
181
+ }
182
+
183
+ /**
184
+ * The two answers a per-representative approval offers (#1612), in the one answer shape (`HumanDecision_Answer.optionRef`).
185
+ * APPROVE proceeds (the representative is admitted, re-checked at that moment); REJECT ends the waiting assignment.
186
+ */
187
+ export enum RepresentativeApprovalOption {
188
+ APPROVE = 'approve',
189
+ REJECT = 'reject',
190
+ }
191
+ ```
192
+
193
+ ### Origin Package: `@wildo-ai/saas-models`
194
+
195
+ ```typescript
196
+ /**
197
+ * One admitted machine client's agents, as the GRANTING organization chose them (#1611). See
198
+ * `OrganizationRelationship.admittedAutonomousAgents`.
199
+ */
200
+ export const RelationshipAdmittedAutonomousAgentsSchema = z.object({
201
+ oauthClientId: z.string().min(1).describe('The representing organization\'s machine client this entry is for. It is always one of the relationship\'s `admittedMachineClientIds`.'),
202
+ autonomousAgentRefs: z
203
+ .array(AutonomousAgentRefSchema)
204
+ .max(AUTONOMOUS_AGENT_REFS_PER_CLIENT_MAX)
205
+ .describe('The agents of that machine client the granting organization lets act inside it. An empty list admits none, even if the representing organization runs more agents on that machine client.'),
206
+ });
207
+ export type RelationshipAdmittedAutonomousAgents = z.infer<typeof RelationshipAdmittedAutonomousAgentsSchema>;
208
+
209
+ /**
210
+ * Does this relationship let this machine client of the representing organization run this autonomous agent in the
211
+ * granting organization (#1611)? The granting organization's consent only: whether the machine client is admitted at
212
+ * all, live, and with which role is `admitRelationshipMachineClient`'s question, and whether the representing
213
+ * organization binds the agent to it is the OAuth client row's. The one predicate the principal resolver, the schedule's
214
+ * nomination and the admission audit share.
215
+ */
216
+ export function relationshipAdmitsAutonomousAgent(
217
+ relationship: Pick<OrganizationRelationship, 'admittedMachineClientIds' | 'admittedAutonomousAgents'> | null | undefined,
218
+ oauthClientId: string,
219
+ autonomousAgentRef: string,
220
+ ): boolean {
221
+ if (!relationship || !(relationship.admittedMachineClientIds ?? []).includes(oauthClientId)) return false;
222
+ return (relationship.admittedAutonomousAgents ?? [])
223
+ .some((entry) => entry.oauthClientId === oauthClientId && entry.autonomousAgentRefs.includes(autonomousAgentRef));
224
+ }
225
+
226
+ /**
227
+ * The relationship, stored in the GRANTING organization — the party whose tenant is reached into, and which controls it.
228
+ *
229
+ * Every field is server-authored. There is no generic CREATE or UPDATE: each field changes only through
230
+ * the verb that owns its transition, which is what makes the record evidence rather than a form.
231
+ */
232
+ export const OrganizationRelationshipSchema = z.object({
233
+ _id: z.string().min(1).isPrimaryKey().isSummaryField(),
234
+
235
+ /** The GRANTING organization — the scope anchor, and the only party that can widen or end the relationship. */
236
+ organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
237
+
238
+ /**
239
+ * The relationship KIND this is an instance of (`organizationRelationships.<kind>` in the application configuration):
240
+ * what the relationship may confer, what its representatives see of this organization's own records, who may propose
241
+ * it (#2722). Fixed at the proposal, like the pair it links. A kind the declaration no longer carries leaves the
242
+ * relationship dormant: it confers nothing until the kind is declared again.
243
+ */
244
+ kind: z.string().min(1).systemEnum(ApplicationConfigVocabulary.ORGANIZATION_RELATIONSHIP_KIND).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
245
+
246
+ /**
247
+ * The REPRESENTING organization. A plain indexed id, not a foreign key: it names another tenant, and a navigable
248
+ * edge from one tenant's row into another tenant is exactly what this model refuses to create.
249
+ */
250
+ representingOrganizationId: z.string().min(1).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
251
+ /**
252
+ * The representing organization's name when the relationship was proposed — a snapshot, because the granting
253
+ * organization cannot read the representing organization's row.
254
+ *
255
+ * Personal data where the representing organization is a sole trader (#2119, #2535): the name of the party the row
256
+ * describes, not of anyone an erasure of the row reaches. Kept, with the rest of the row, as the granting
257
+ * organization's evidence of who could reach its tenant (AUDIT_LOGS class from `endedAt`); the representing
258
+ * organization's own deletion ends the relationship and does not scrub the copy held in the other tenant.
259
+ */
260
+ representingOrganizationName: z.string().max(200).optional().isSummaryField().excludeFromCreate().excludeFromUpdate()
261
+ .dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true }),
262
+
263
+ status: z.enum(OrganizationRelationshipStatus)
264
+ .systemEnum('OrganizationRelationshipStatus')
265
+ .default(OrganizationRelationshipStatus.PROPOSED)
266
+ .isDBIndexed()
267
+ .isSummaryField()
268
+ .excludeFromCreate()
269
+ .excludeFromUpdate()
270
+ .isAuditEvidence(),
271
+
272
+ /**
273
+ * The role every representative holds in the granting organization. One of its kind's `confers.roles` that the
274
+ * granting organization's type offers, never one leading up to `ORG_ADMIN` (refused at startup).
275
+ * The representative memberships' `roles` mirror it; the live filter emits THIS value.
276
+ */
277
+ role: z.string().min(1).isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
278
+
279
+ /**
280
+ * Engagement scope. Absent or empty ⇒ organization-wide. Present ⇒ the representatives reach ONLY these units:
281
+ * the live filter emits one unit-scoped role entry per id and NO organization-wide entry, so a
282
+ * resource that neither narrows by unit nor is declared organization-wide for representatives is refused.
283
+ * Stored once, here — no `ORGANIZATION_UNIT_MEMBERS` rows mirror it.
284
+ */
285
+ organizationUnitIds: z.array(z.string().min(1)).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
286
+
287
+ /** The term. Absent ⇒ open-ended. Admission reads this, never the EXPIRED label. */
288
+ // Nullish: `amendScope` CLEARS a term by writing null, which means "no term".
289
+ endsAt: z.date().nullish().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
290
+
291
+ /** Why the relationship exists — required, and the fact the granting organization's processor register derives from. */
292
+ purpose: purposeField(),
293
+
294
+ /**
295
+ * OAuth clients owned by the representing organization that the granting organization admits into its organization
296
+ * under this relationship (S3). A listed client authenticating by client credentials receives the relationship's role
297
+ * in THIS organization, re-checked per request. What such a principal may do is decided elsewhere.
298
+ */
299
+ admittedMachineClientIds: z.array(z.string().min(1)).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
300
+
301
+ /**
302
+ * Which of the representing organization's autonomous agents the granting organization lets each admitted machine
303
+ * client run HERE (#1611). The representing organization decides which agents its machine client runs
304
+ * (`autonomousAgentRefs` on the OAuth client); the GRANTING organization decides which of those may act in its
305
+ * organization, at the relationship's role and on its token budget. A turn needs both: see
306
+ * {@link relationshipAdmitsAutonomousAgent}. No entry for a machine client, or an empty list, admits none — a
307
+ * representing organization adding an agent to its own machine client never starts it in a granting organization that
308
+ * did not choose it.
309
+ *
310
+ * Written only by `admitMachineClient` (which replaces the machine client's entry) and `removeMachineClient` (which
311
+ * drops it), so it can never name a client `admittedMachineClientIds` does not.
312
+ */
313
+ admittedAutonomousAgents: z.array(RelationshipAdmittedAutonomousAgentsSchema).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
314
+
315
+ /**
316
+ * Whether each representative the representing organization assigns waits for the granting organization's own
317
+ * approval (#1612). The GRANTING organization's choice: written by its `propose`, `accept` and
318
+ * `setRepresentativeAdmissionPolicy` only — a proposal from the representing side starts from the granting
319
+ * organization type's declared default, and no verb of the representing side reads a value for it.
320
+ */
321
+ representativeAdmissionPolicy: z.enum(RepresentativeAdmissionPolicy)
322
+ .systemEnum('RepresentativeAdmissionPolicy')
323
+ .default(RepresentativeAdmissionPolicy.ADMITTED_ON_DESIGNATION)
324
+ .isSummaryField()
325
+ .excludeFromCreate()
326
+ .excludeFromUpdate()
327
+ .isAuditEvidence(),
328
+
329
+ /**
330
+ * Whether the granting organization accepts the multi-factor proof the REPRESENTING organization's own enterprise
331
+ * identity provider made (#1633). The granting organization's choice, written only by its `setRepresentingMfaTrust`
332
+ * verb (ORG_OWNER, step-up); off by default. The granting organization type's authentication policy governs the
333
+ * representatives either way — this only decides whether a factor the representing organization's provider reported
334
+ * may satisfy it. See {@link RelationshipMfaTrust}.
335
+ */
336
+ representingMfaTrust: z.enum(RelationshipMfaTrust)
337
+ .systemEnum('RelationshipMfaTrust')
338
+ .default(RelationshipMfaTrust.NOT_TRUSTED)
339
+ .isSummaryField()
340
+ .excludeFromCreate()
341
+ .excludeFromUpdate()
342
+ .isAuditEvidence(),
343
+
344
+ /**
345
+ * How much of the audit rows the representatives' acts wrote in this granting organization the REPRESENTING
346
+ * organization's administrators may read (#2874). The granting organization's choice, written only by its
347
+ * `setRepresentativeActivityDisclosure` verb (ORG_ADMIN); `METADATA` by default. Read live, per row, by the
348
+ * representative-activity read. See {@link RepresentativeActivityDisclosure}.
349
+ */
350
+ representativeActivityDisclosure: z.enum(RepresentativeActivityDisclosure)
351
+ .systemEnum('RepresentativeActivityDisclosure')
352
+ .default(RepresentativeActivityDisclosure.METADATA)
353
+ .isSummaryField()
354
+ .excludeFromCreate()
355
+ .excludeFromUpdate()
356
+ .isAuditEvidence(),
357
+
358
+ /** Which side proposed — the OTHER side accepts. */
359
+ proposedByOrganizationId: z.string().min(1).isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
360
+ proposedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
361
+ acceptedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence().isDecider(),
362
+ acceptedAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),
363
+ endedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence().isDecider(),
364
+ /*
365
+ * The people above, NAMED (#1852): each stamp is a user id and deliberately not a foreign key (it records who acted,
366
+ * nothing navigates through it), so its screen showed 24 hexadecimal characters. Resolved at read time
367
+ * (`forwardedUserName`), never stored: the row's evidence holds the ids and nothing else.
368
+ *
369
+ * Only the GRANTING organization reads this row, and a person of either side may be named here: the granting side is
370
+ * already told who the representing side's people are (a representative's name in its directory, the assigner's on
371
+ * an approval card). The representing side reads its own mirror, which carries no person.
372
+ */
373
+ proposedByName: forwardedUserName({ localField: 'proposedByUserId' }),
374
+ acceptedByName: forwardedUserName({ localField: 'acceptedByUserId' }),
375
+ endedByName: forwardedUserName({ localField: 'endedByUserId' }),
376
+ /** When a terminal status was reached — the retention clock's start point. */
377
+ endedAt: z.date().optional().isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
378
+ decisionReason: decisionReasonField(),
379
+
380
+ createdAt: z.date().optional(),
381
+ updatedAt: z.date().optional(),
382
+ });
383
+ export type OrganizationRelationship = z.infer<typeof OrganizationRelationshipSchema>;
384
+
385
+ /**
386
+ * The representing side's mirror of one relationship, stored in the REPRESENTING organization.
387
+ *
388
+ * System-written in the same transaction as every relationship transition, and what the representing organization
389
+ * reads — its list of granting organizations, the representative assignment screen, the organization switcher's
390
+ * grouping. It carries only what the representing side needs: the granting organization's unit ids stay in its own
391
+ * tenant (`scopedToOrganizationUnits` says whether a scope exists, not what it is).
392
+ */
393
+ export const OrganizationRepresentationSchema = z.object({
394
+ _id: z.string().min(1).isPrimaryKey().isSummaryField(),
395
+
396
+ /** The REPRESENTING organization. */
397
+ organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
398
+
399
+ /** The granting organization. A plain id for the same reason as `representingOrganizationId` on the relationship. */
400
+ grantingOrganizationId: z.string().min(1).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
401
+
402
+ /** The relationship this mirrors, in the granting organization's tenant. Unique: one mirror per relationship. */
403
+ organizationRelationshipId: z.string().min(1).isDBIndexed().isUnique().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
404
+
405
+ /** The relationship's kind, copied from it (#2722): the representing side reads its own record, never the other tenant's. */
406
+ kind: z.string().min(1).systemEnum(ApplicationConfigVocabulary.ORGANIZATION_RELATIONSHIP_KIND).isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate(),
407
+
408
+ status: z.enum(OrganizationRelationshipStatus)
409
+ .systemEnum('OrganizationRelationshipStatus')
410
+ .default(OrganizationRelationshipStatus.PROPOSED)
411
+ .isDBIndexed()
412
+ .isSummaryField()
413
+ .excludeFromCreate()
414
+ .excludeFromUpdate(),
415
+ role: z.string().min(1).isSummaryField().excludeFromCreate().excludeFromUpdate(),
416
+ scopedToOrganizationUnits: z.boolean().default(false).isSummaryField().excludeFromCreate().excludeFromUpdate(),
417
+ // Nullish, and always written by the mirror sync: a term the granting organization cleared must clear here too.
418
+ endsAt: z.date().nullish().isSummaryField().excludeFromCreate().excludeFromUpdate(),
419
+ purpose: purposeField(),
420
+ proposedByOrganizationId: z.string().min(1).excludeFromCreate().excludeFromUpdate(),
421
+ /**
422
+ * Display copy of the granting organization's name — the representing organization cannot read the granting row.
423
+ * Written only once the granting organization has consented to the representing organization knowing it (it proposed
424
+ * to this organization, or accepted this organization's proposal), then refreshed at each transition. Absent while a
425
+ * representing organization's proposal is pending and after a decline: a proposal must not be a way to learn a
426
+ * tenant's name. The one exception is the second direction of a MUTUAL relationship, written at its proposal: the two
427
+ * organizations already dealt with each other in the first direction (#2722, review H1).
428
+ *
429
+ * Personal data where the granting organization is a sole trader (#2119, #2535), kept with the mirror as the
430
+ * representing organization's record of whom it served; the granting organization's deletion does not scrub it.
431
+ */
432
+ grantingOrganizationName: z.string().max(200).optional().isSummaryField().excludeFromCreate().excludeFromUpdate()
433
+ .dataCategories(PersonalDataCategory.IDENTITY, { personalOnlyWhen: PersonalDataCondition.DESCRIBED_PARTY_IS_A_NATURAL_PERSON, aboutAnotherParty: true }),
434
+ /**
435
+ * The granting organization's admission policy, mirrored so the representing organization knows before assigning
436
+ * whether each representative will wait for the granting organization's approval (#1612). Read-only here: the
437
+ * representing side has no verb that writes it.
438
+ */
439
+ representativeAdmissionPolicy: z.enum(RepresentativeAdmissionPolicy)
440
+ .systemEnum('RepresentativeAdmissionPolicy')
441
+ .default(RepresentativeAdmissionPolicy.ADMITTED_ON_DESIGNATION)
442
+ .isSummaryField()
443
+ .excludeFromCreate()
444
+ .excludeFromUpdate(),
445
+ /**
446
+ * The administrative capabilities the granting organization currently lends this representing organization (#1631),
447
+ * with when each ends — mirrored so the representing side knows what its representatives may do there. System-written
448
+ * on every grant and revocation; read-only to the representing side, which can never grant, widen or extend one.
449
+ */
450
+ delegatedCapabilities: z.array(OrganizationRepresentationDelegatedCapabilitySchema).optional().excludeFromCreate().excludeFromUpdate(),
451
+ /** Mirrors the relationship's end — the retention clock's start point, so the sweep queries it (indexed). */
452
+ endedAt: z.date().optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),
453
+ decisionReason: decisionReasonField(),
454
+
455
+ createdAt: z.date().optional(),
456
+ updatedAt: z.date().optional(),
457
+ });
458
+ export type OrganizationRepresentation = z.infer<typeof OrganizationRepresentationSchema>;
459
+
460
+ /**
461
+ * Has the GRANTING organization consented to the representing organization knowing its name? (#1597 review L2, #2722)
462
+ *
463
+ * A representing organization can propose to any organization whose id it knows, so a name disclosed at that proposal,
464
+ * or on the granting organization's refusal of it, would tell a tenant's name to a party it never agreed to deal with.
465
+ * The name is owed only once the granting organization took a step toward it: proposing to that representing
466
+ * organization itself, or accepting its proposal (`acceptedAt`, which stays set through suspension and termination, so
467
+ * a name once disclosed is not withdrawn from the representing organization's history).
468
+ *
469
+ * The ONE rule for every place the representing side may see the granting side's name: the mirror's
470
+ * `grantingOrganizationName`, and the emails a relationship verb sends the representing organization (#2781).
471
+ */
472
+ export function grantingOrganizationConsentedToNameDisclosure(
473
+ relationship: { readonly organizationId?: unknown; readonly proposedByOrganizationId?: unknown; readonly acceptedAt?: unknown } | null | undefined,
474
+ ): boolean {
475
+ // A row that does not say whose it is gives no consent: `undefined === undefined` must not read as "it proposed".
476
+ if (!relationship || typeof relationship.organizationId !== 'string' || relationship.organizationId.length === 0) return false;
477
+ return relationship.proposedByOrganizationId === relationship.organizationId || Boolean(relationship.acceptedAt);
478
+ }
479
+
480
+ /**
481
+ * Which of the representing organization's members serve which engagement — stored in the REPRESENTING organization,
482
+ * decided by its administrators. Assigning creates (or reactivates) the representative's representative membership in the
483
+ * granting organization; unassigning makes it INACTIVE. The live filter reads the ACTIVE assignment for
484
+ * `(organizationRelationshipId, userId)` on every request.
485
+ */
486
+ export const RepresentativeAssignmentSchema = z.object({
487
+ _id: z.string().min(1).isPrimaryKey().isSummaryField(),
488
+
489
+ /** The REPRESENTING organization. */
490
+ organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
491
+
492
+ /** The engagement (mirror) this assignment serves — same tenant, a real edge. */
493
+ organizationRepresentationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence(),
494
+
495
+ /** The representative. Must be an ACTIVE, ordinary member of the representing organization when assigned. */
496
+ userId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate().isAuditEvidence()
497
+ .foreignKeyUI({ display: { labelFallbackField: 'representativeName' } }),
498
+ /**
499
+ * The representative, NAMED (#1852): `userId`'s `labelFallbackField`, for an administrator who may not read the
500
+ * member's account. Resolved at read time (`forwardedUserName`), never stored. Shown through the reference.
501
+ */
502
+ representativeName: forwardedUserName({ localField: 'userId' }).isSummaryField().isHidden({ display: true }),
503
+
504
+ /** Copied from the engagement so the live filter reads one row by `(relationship, user)`. */
505
+ organizationRelationshipId: z.string().min(1).isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
506
+ grantingOrganizationId: z.string().min(1).isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
507
+
508
+ status: z.enum(RepresentativeAssignmentStatus)
509
+ .systemEnum('RepresentativeAssignmentStatus')
510
+ .default(RepresentativeAssignmentStatus.ACTIVE)
511
+ .isDBIndexed()
512
+ .isSummaryField()
513
+ .excludeFromCreate()
514
+ .excludeFromUpdate()
515
+ .isAuditEvidence(),
516
+
517
+ assignedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
518
+ /**
519
+ * Who assigned, NAMED (#1852): an administrator of the representing organization, which reads this row. Resolved at read
520
+ * time (`forwardedUserName`), never stored. `endedByUserId` below has no name on purpose: an assignment ends with its
521
+ * relationship, and then the actor may be the granting organization's administrator, whom the representing
522
+ * organization is never told about (see `approvalResolvedAt`).
523
+ */
524
+ assignedByName: forwardedUserName({ localField: 'assignedByUserId' }),
525
+ assignedAt: z.date().optional().excludeFromCreate().excludeFromUpdate(),
526
+
527
+ /**
528
+ * The granting organization's pending approval of this representative (#1612): the `HumanDecision_Request.decisionId`
529
+ * of the decision routed to the granting organization's administrators, set when the assignment was made under a
530
+ * relationship whose granting organization approves each representative. It is the ONE key the decision is read,
531
+ * listed and settled by, and the settle write matches on it, so an answer can only ever settle the request it was given.
532
+ */
533
+ approvalDecisionId: z.string().min(1).optional().isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
534
+ /**
535
+ * When the granting organization's approval ended — approved, denied or lapsed. Indexed (#2880): the ending repair lists
536
+ * the approvals settled within its window by it, whatever the assignment's status has become since (an approved
537
+ * assignment may since have ENDED). A withdrawal of an approval nobody answered never sets it.
538
+ */
539
+ approvalResolvedAt: z.date().optional().isDBIndexed().excludeFromCreate().excludeFromUpdate(),
540
+ /**
541
+ * The granting organization's administrator who ANSWERED the approval (approved or refused), written by the
542
+ * `settleGrantorApproval` verb in the same write as the answer (#2880). Absent on a lapse, a late answer the verb ends
543
+ * LAPSED, and a withdrawal: nobody decided those.
544
+ *
545
+ * BACKEND-ONLY, and that is the whole design: the representing organization reads this row, and is never told who in
546
+ * the granting organization decided (the decision's resolved row, in the GRANTING organization's trail, names them).
547
+ * So it is never in a response, a listing, a subject-export bundle or an email, and it is deliberately NOT
548
+ * `.isAuditEvidence()`: that would put its value on the settle's `RESOURCE_OPERATION_PERFORMED` row, which sits in the
549
+ * representing organization's trail.
550
+ *
551
+ * It exists for one reader: the ending repair (`repairUnrecordedRepresentativeApprovalEndings`), which records and tells
552
+ * an answer whose commit landed with its reply lost, so its ending row names the person who answered rather than nobody.
553
+ * Kept as evidence on erasure, like the other actor ids here (the resource is RETAIN_ONLY).
554
+ */
555
+ approvalDecidedByUserId: z.string().min(1).optional().isBackendOnly().excludeFromCreate().excludeFromUpdate().isDecider(),
556
+ /** Why a DENIED assignment admitted nobody — a fact the representing side may know, never who in the granting organization decided. */
557
+ approvalDenialReason: z.enum(RepresentativeApprovalDenialReason)
558
+ .systemEnum('RepresentativeApprovalDenialReason')
559
+ .optional()
560
+ .excludeFromCreate()
561
+ .excludeFromUpdate(),
562
+
563
+ /**
564
+ * The clocks of a pending approval by the granting organization (#1909), armed at `assign` from the relationship
565
+ * kind's `granting.organizationTypes[type].representativeApprovalDeadlines` for the granting organization's type, with
566
+ * #1628's model, and stored rather than recomputed so a deployment that changes the declaration never reshapes a clock
567
+ * already running.
568
+ *
569
+ * - `approvalLapseAt` — when the approval ends LAPSED, admitting nobody. The representing organization may see it: it
570
+ * is when its request stops waiting.
571
+ * - `approvalDecisionDeadlineAt` / `approvalDecisionWarningAt` — the DECISION service target and its optional
572
+ * warning, on `approvalDecisionClockBasis`. There is no CLAIM clock: this plane offers no claim.
573
+ * - `approvalDecisionWarningFiredAt` / `approvalDecisionMissedFiredAt` — each stage's fired marker, set by a
574
+ * compare-and-swap that requires it null, so a stage fires exactly once across hosts.
575
+ * - `approvalNextDueAt` — the earliest of the lapse and any stage still to fire: what the sweep selects by index.
576
+ */
577
+ approvalLapseAt: z.date().nullish().isDBIndexed().excludeFromCreate().excludeFromUpdate()
578
+ .describe('While the granting organization has not decided on this assignment: when the request lapses, admitting nobody. Empty once the granting organization has decided.'),
579
+ approvalDecisionDeadlineAt: z.date().nullish().excludeFromCreate().excludeFromUpdate()
580
+ .describe('The service target by which the granting organization is expected to decide on this assignment, counted on `approvalDecisionClockBasis`.'),
581
+ approvalDecisionWarningAt: z.date().nullish().excludeFromCreate().excludeFromUpdate()
582
+ .describe('When the granting organization is warned that the decision target is near, when its organization type declares a warning. Empty otherwise.'),
583
+ approvalDecisionClockBasis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').nullish().excludeFromCreate().excludeFromUpdate()
584
+ .describe('How the decision target is counted: `elapsed` wall-clock time, or `calendar` working hours of the application\'s review calendar.'),
585
+ approvalDecisionWarningFiredAt: z.date().nullish().isBackendOnly().excludeFromCreate().excludeFromUpdate(),
586
+ approvalDecisionMissedFiredAt: z.date().nullish().isBackendOnly().excludeFromCreate().excludeFromUpdate(),
587
+ approvalNextDueAt: z.date().nullish().isDBIndexed().isBackendOnly().excludeFromCreate().excludeFromUpdate(),
588
+
589
+ endedByUserId: z.string().min(1).optional().excludeFromCreate().excludeFromUpdate().isAuditEvidence().isDecider(),
590
+ /** When the assignment ended — the retention clock's start point. */
591
+ endedAt: z.date().optional().isDBIndexed().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
592
+
593
+ createdAt: z.date().optional(),
594
+ updatedAt: z.date().optional(),
595
+ });
596
+ export type RepresentativeAssignment = z.infer<typeof RepresentativeAssignmentSchema>;
597
+
598
+ /**
599
+ * The input of the INTERNAL `settleGrantorApproval` verb (#1612): which pending approval, and how the granting
600
+ * organization answered.
601
+ *
602
+ * `outcome` is the one decision vocabulary (`HumanDecision_Outcome`). Only ACCEPTED, REJECTED and LAPSED settle a
603
+ * representative approval — the verb refuses the others rather than reading them as one of these.
604
+ */
605
+ export const RepresentativeAssignmentSettleGrantorApprovalDtoSchema = z.object({
606
+ approvalDecisionId: z.string().min(1),
607
+ outcome: z.enum(HumanDecision_Outcome),
608
+ /**
609
+ * The granting organization's administrator who answered — recorded in the GRANTING organization's trail, and on the
610
+ * assignment only as its backend-only `approvalDecidedByUserId` (#2880), which no response carries to the
611
+ * representing organization that reads the row.
612
+ */
613
+ decidedByUserId: z.string().min(1).optional(),
614
+ /** #2664: the inbound delivery the answer arrived through (a chat button), recorded on the RESOLVED row with it. */
615
+ answeredThrough: HumanDecision_AnsweredThroughSchema.optional(),
616
+ /** #2905: how the administrator who answered was authenticated, recorded on the RESOLVED row with them. Never stored. */
617
+ decider: HumanDecision_DeciderRecordSchema.optional(),
618
+ /**
619
+ * #2903: what the administrator was shown, as the decision host checked it against the assignment, and what they
620
+ * answered, sealed with the answer in the settle's transaction. Built by the host, never by a caller.
621
+ */
622
+ presentation: HumanDecision_SealedPresentationSchema.optional(),
623
+ statement: HumanDecision_StatementSchema.optional(),
624
+ });
625
+ export type RepresentativeAssignmentSettleGrantorApprovalDto = z.infer<typeof RepresentativeAssignmentSettleGrantorApprovalDtoSchema>;
626
+
627
+ /**
628
+ * The input of the INTERNAL `recordTypeChangeStanding` verb (#2611, #2794): what the type change did to the relationship,
629
+ * and which party's type changed. The party told is the OTHER one.
630
+ */
631
+ export const RecordTypeChangeStandingDtoSchema = z.object({
632
+ transition: z.enum([OrganizationRelationshipTransition.DORMANT_BY_TYPE_CHANGE, OrganizationRelationshipTransition.REVIVED_BY_TYPE_CHANGE])
633
+ .systemEnum('OrganizationRelationshipTransition'),
634
+ changedSide: z.enum(RelationshipSide).systemEnum('RelationshipSide'),
635
+ });
636
+ export type RecordTypeChangeStandingDto = z.infer<typeof RecordTypeChangeStandingDtoSchema>;
637
+
638
+ /**
639
+ * The input of the INTERNAL `recordPartyStatusStanding` verb (#2795): what a party organization's status change did to the
640
+ * relationship, which party changed, and the status it now has, which is what the other party is told (a suspension and a
641
+ * deletion mean different things to it: the second ends the relationship unless the organization is restored).
642
+ */
643
+ export const RecordPartyStatusStandingDtoSchema = z.object({
644
+ transition: z.enum([OrganizationRelationshipTransition.DORMANT_BY_PARTY_STATUS, OrganizationRelationshipTransition.REVIVED_BY_PARTY_STATUS])
645
+ .systemEnum('OrganizationRelationshipTransition'),
646
+ changedSide: z.enum(RelationshipSide).systemEnum('RelationshipSide'),
647
+ // No `.systemEnum`: the organization's own `status` declares none, and this internal input is never rendered.
648
+ partyStatus: z.enum(OrganizationStatus),
649
+ });
650
+ export type RecordPartyStatusStandingDto = z.infer<typeof RecordPartyStatusStandingDtoSchema>;
651
+
652
+ /**
653
+ * The input of the INTERNAL `endForRemovedParty` verb (#2794): which party organization is being deleted. Who deleted it
654
+ * is not an input: the organization delete runs the verb on that person's behalf (`auditActorUserId`, evidence only).
655
+ */
656
+ export const EndForRemovedPartyDtoSchema = z.object({
657
+ removedSide: z.enum(RelationshipSide).systemEnum('RelationshipSide'),
658
+ });
659
+ export type EndForRemovedPartyDto = z.infer<typeof EndForRemovedPartyDtoSchema>;
660
+
661
+ /**
662
+ * The statuses that end one direction of a MUTUAL relationship and so end the other with it (#2722 Phase 3, #2796): the
663
+ * granting side's DECLINED, TERMINATED and EXPIRED, and the representing side's WITHDRAWN. Each also says which side
664
+ * acted: the representing side only ever ends a relationship as WITHDRAWN, the granting side never does.
665
+ */
666
+ export const RECIPROCAL_ENDING_CAUSES = [
667
+ OrganizationRelationshipStatus.DECLINED,
668
+ OrganizationRelationshipStatus.TERMINATED,
669
+ OrganizationRelationshipStatus.WITHDRAWN,
670
+ OrganizationRelationshipStatus.EXPIRED,
671
+ ] as const;
672
+
673
+ /**
674
+ * The input of the INTERNAL `endWithReciprocal` verb (#2796): the status that ended the OTHER direction of the mutual
675
+ * agreement. The verb derives everything else from it and from the row (what this direction becomes, and which
676
+ * organization acted). Who acted is not an input: the ending verb runs it on that person's behalf (`auditActorUserId`).
677
+ */
678
+ export const EndWithReciprocalDtoSchema = z.object({
679
+ endedDirectionStatus: z.enum(RECIPROCAL_ENDING_CAUSES).systemEnum('OrganizationRelationshipStatus'),
680
+ });
681
+ export type EndWithReciprocalDto = z.infer<typeof EndWithReciprocalDtoSchema>;
682
+
683
+ /**
684
+ * The client-branchable codes a relationship refusal carries (all answer 409 CONFLICT: the caller is
685
+ * authorized and the payload is valid; the current STATE forbids the write).
686
+ */
687
+ export enum OrganizationRelationshipErrorCode {
688
+ /** A PROPOSED, ACTIVE or SUSPENDED relationship already links this representing and this granting organization. */
689
+ ORGANIZATION_RELATIONSHIP_ALREADY_LIVE = 'ORGANIZATION_RELATIONSHIP_ALREADY_LIVE',
690
+ /** The representative is one of the granting organization's OWN members; a person is in an organization one way at a time. */
691
+ RELATIONSHIP_ASSIGNMENT_CONFLICTS_WITH_MEMBERSHIP = 'RELATIONSHIP_ASSIGNMENT_CONFLICTS_WITH_MEMBERSHIP',
692
+ /** The representative already serves this granting organization under another live relationship. */
693
+ RELATIONSHIP_ASSIGNMENT_ALREADY_LIVE = 'RELATIONSHIP_ASSIGNMENT_ALREADY_LIVE',
694
+ /** A representative membership's roles belong to the relationship; change the relationship, not the membership. */
695
+ RELATIONSHIP_MEMBERSHIP_ROLES_OWNED_BY_RELATIONSHIP = 'RELATIONSHIP_MEMBERSHIP_ROLES_OWNED_BY_RELATIONSHIP',
696
+ /**
697
+ * An invitation to a person who has a REPRESENTATIVE membership in this organization. A live one: the person is
698
+ * already here through a representing organization. An ended one (INACTIVE): remove that membership first, then invite.
699
+ */
700
+ RELATIONSHIP_MEMBERSHIP_CONFLICTS_WITH_INVITATION = 'RELATIONSHIP_MEMBERSHIP_CONFLICTS_WITH_INVITATION',
701
+ /**
702
+ * An organization type does not take the side this act needs. In a relationship verb, no kind admits the two
703
+ * organizations' types in these sides (or the named kind does not).
704
+ */
705
+ RELATIONSHIP_ORGANIZATION_TYPE_NOT_ELIGIBLE = 'RELATIONSHIP_ORGANIZATION_TYPE_NOT_ELIGIBLE',
706
+ /** The side that proposed tried to accept its own proposal. */
707
+ RELATIONSHIP_PROPOSAL_ACCEPTED_BY_PROPOSER = 'RELATIONSHIP_PROPOSAL_ACCEPTED_BY_PROPOSER',
708
+ /** The requested role is not one the relationship's kind confers, or the granting type does not offer it. */
709
+ RELATIONSHIP_ROLE_NOT_DECLARED = 'RELATIONSHIP_ROLE_NOT_DECLARED',
710
+ /** The relationship's kind lets only the other side propose (`proposedBy`): this side accepts a proposal, never makes one. */
711
+ RELATIONSHIP_KIND_NOT_PROPOSED_BY_THIS_SIDE = 'RELATIONSHIP_KIND_NOT_PROPOSED_BY_THIS_SIDE',
712
+ /** A requested organization unit is not a unit of the granting organization. */
713
+ RELATIONSHIP_UNIT_NOT_IN_GRANTOR = 'RELATIONSHIP_UNIT_NOT_IN_GRANTOR',
714
+ /**
715
+ * Assignment needs an ACTIVE engagement, a relationship that confers right now (ACTIVE, in term, still admitted by its
716
+ * kind, both organizations conferring authority: #2616) and an ACTIVE, ordinary member of the representing organization.
717
+ */
718
+ RELATIONSHIP_ASSIGNMENT_NOT_ELIGIBLE = 'RELATIONSHIP_ASSIGNMENT_NOT_ELIGIBLE',
719
+ /**
720
+ * The granting organization SUSPENDED this representative's membership. That is the granting organization's decision
721
+ * about one person, and an assignment by the representing side may not undo it: the granting organization reactivates
722
+ * the membership first.
723
+ */
724
+ REPRESENTATIVE_SUSPENDED_BY_GRANTOR = 'REPRESENTATIVE_SUSPENDED_BY_GRANTOR',
725
+ /** The OAuth client to admit is not an ACTIVE client owned by the representing organization. */
726
+ RELATIONSHIP_MACHINE_CLIENT_NOT_ELIGIBLE = 'RELATIONSHIP_MACHINE_CLIENT_NOT_ELIGIBLE',
727
+ /** The representing organization already has a PENDING, unexpired invitation to this address: revoke it before inviting again (#2618). */
728
+ RELATIONSHIP_INVITATION_ALREADY_PENDING = 'RELATIONSHIP_INVITATION_ALREADY_PENDING',
729
+ /** The relationship is confined to units, and its kind confers only organization-wide relationships (`confers.unitScope: false`). */
730
+ RELATIONSHIP_KIND_CONFERS_NO_UNIT_SCOPE = 'RELATIONSHIP_KIND_CONFERS_NO_UNIT_SCOPE',
731
+ /** The kind forbids accepting the representing organization's identity-provider MFA (`confers.representingMfaTrust: false`). */
732
+ RELATIONSHIP_KIND_FORBIDS_MFA_TRUST = 'RELATIONSHIP_KIND_FORBIDS_MFA_TRUST',
733
+ /**
734
+ * The invitee acted on an invitation that can no longer be delivered (#2716): the representing organization revoked it,
735
+ * it was delivered or declined, or it lapsed. Answered only to the person it is addressed to.
736
+ */
737
+ RELATIONSHIP_INVITATION_NO_LONGER_PENDING = 'RELATIONSHIP_INVITATION_NO_LONGER_PENDING',
738
+ /**
739
+ * A granting organization asked "the operator" without naming one, under a kind in which the operating organization is
740
+ * not the only representing party (`OperatorStanding.OPERATOR_IS_PARTY`), or whose operating organization cannot be
741
+ * reached (#2618, #2722). Only then is there exactly one organization to ask.
742
+ */
743
+ RELATIONSHIP_OPERATOR_UNAVAILABLE = 'RELATIONSHIP_OPERATOR_UNAVAILABLE',
744
+ /** The proposal names no relationship kind, and more than one kind admits this pair of organization types (#2722). */
745
+ RELATIONSHIP_KIND_REQUIRED = 'RELATIONSHIP_KIND_REQUIRED',
746
+ /**
747
+ * The record named for sharing cannot be shared (#2722): its resource is not one of the organization's separated records
748
+ * (an application- or user-scoped resource, the organization row, the member directory, a system of record's row), or it
749
+ * issues authority (a credential, a membership, a relationship), which is never shared.
750
+ */
751
+ RELATIONSHIP_RECORD_NOT_SHAREABLE = 'RELATIONSHIP_RECORD_NOT_SHAREABLE',
752
+ }
753
+ ```
754
+
755
+ ### Origin Package: `@wildo-ai/saas-models`
756
+
757
+ ```typescript
758
+ /**
759
+ * The granting side's verbs. Kept with the vocabulary, not the resources-config, for the reason recorded on
760
+ * `PlatformAccessGrants_Operations`: authorization and batch code need the names without dragging
761
+ * resource-configuration evaluation into their module graph.
762
+ *
763
+ * No generic CREATE / UPDATE: every field's server authorship IS the control.
764
+ */
765
+ export enum OrganizationRelationships_Operations {
766
+ /** The granting organization's ORG_OWNER proposes a relationship to a representing organization. The proposal is the granting organization's consent. */
767
+ PROPOSE = 'propose',
768
+ /** The granting organization's ORG_OWNER accepts a REPRESENTING organization's proposal (step-up). Never available to the proposing side. */
769
+ ACCEPT = 'accept',
770
+ /** The granting organization's ORG_ADMIN refuses a representing organization's proposal. */
771
+ DECLINE = 'decline',
772
+ SUSPEND = 'suspend',
773
+ RESUME = 'resume',
774
+ TERMINATE = 'terminate',
775
+ /**
776
+ * The granting organization's ORG_OWNER changes role, units or term (step-up). The representing organization cannot
777
+ * widen what the granting organization granted.
778
+ */
779
+ AMEND_SCOPE = 'amendScope',
780
+ ADMIT_MACHINE_CLIENT = 'admitMachineClient',
781
+ REMOVE_MACHINE_CLIENT = 'removeMachineClient',
782
+ /** ACTIVE → EXPIRED past `endsAt`, dispatched by the credential-expiry sweep only. */
783
+ EXPIRE = 'expire',
784
+ /**
785
+ * INTERNAL: a party organization is being deleted, so the relationship ends inside that deletion's transaction (#2794):
786
+ * TERMINATED when the granting organization goes, WITHDRAWN when the representing one does. Run by the organization
787
+ * delete only, one relationship at a time, so the remaining party is told through this verb's declared notice.
788
+ */
789
+ END_FOR_REMOVED_PARTY = 'endForRemovedParty',
790
+ /**
791
+ * INTERNAL: one party's type changed, and the relationship stopped conferring (`DORMANT_BY_TYPE_CHANGE`) or confers
792
+ * again (`REVIVED_BY_TYPE_CHANGE`) (#2611, #2794). Stores nothing about it on the row (dormancy is derived per request,
793
+ * so a stored copy would drift when a declaration changes; only `updatedAt` moves, the framework's core update of an
794
+ * entity replace): it records the transition in both trails and tells the party whose type did NOT change. Run by
795
+ * `organizations.changeType` and owner promotion only.
796
+ */
797
+ RECORD_TYPE_CHANGE_STANDING = 'recordTypeChangeStanding',
798
+ /**
799
+ * INTERNAL: the other direction of a MUTUAL relationship ended, so this one ends with it, in the same transaction
800
+ * (#2722 Phase 3, #2796). Run by every verb that ends a direction, so the organization whose own tenant this direction
801
+ * narrows is told through this verb's declared notice rather than learning it from nothing.
802
+ */
803
+ END_WITH_RECIPROCAL = 'endWithReciprocal',
804
+ /**
805
+ * INTERNAL: one party organization stopped operating or operates again, and the relationship stopped conferring
806
+ * (`DORMANT_BY_PARTY_STATUS`) or confers again (`REVIVED_BY_PARTY_STATUS`) (#2795). The status-change twin of
807
+ * `recordTypeChangeStanding`: stores nothing (conferral is derived per request), records the transition in both trails
808
+ * and tells the party whose status did NOT change. Run by `organizations` `suspend`, `activate`, `requestDeletion` and
809
+ * `restore`, only for a change that crosses the line between a status that confers and one that does not.
810
+ */
811
+ RECORD_PARTY_STATUS_STANDING = 'recordPartyStatusStanding',
812
+ /** The granting organization's ORG_OWNER decides whether the representing organization's own identity provider's MFA counts here (#1633, step-up). */
813
+ SET_REPRESENTING_MFA_TRUST = 'setRepresentingMfaTrust',
814
+ /** The granting organization's ORG_ADMIN decides how much of its representatives' activity rows the representing organization reads (#2874). */
815
+ SET_REPRESENTATIVE_ACTIVITY_DISCLOSURE = 'setRepresentativeActivityDisclosure',
816
+ /**
817
+ * The granting organization's ORG_ADMIN changes how the representatives are admitted (#1612). Not retroactive. The
818
+ * representing side has no such verb.
819
+ */
820
+ SET_REPRESENTATIVE_ADMISSION_POLICY = 'setRepresentativeAdmissionPolicy',
821
+ /**
822
+ * The granting organization's administrator shares one of its records with this relationship (#2722): the record
823
+ * becomes visible to the relationship's representatives, whichever relationship (or none) created it. Decision #2617:
824
+ * a granting organization may share one representing organization's record with another. The representing side has no
825
+ * such verb.
826
+ */
827
+ SHARE_RECORD = 'shareRecord',
828
+ /** Withdraws a share {@link SHARE_RECORD} made. Never hides a record the relationship created itself. */
829
+ UNSHARE_RECORD = 'unshareRecord',
830
+ /**
831
+ * The granting organization's administrator reads whose one of its records is and which relationships it is shared
832
+ * with (#2736): what a screen offering {@link SHARE_RECORD} / {@link UNSHARE_RECORD} shows. Answered only to the
833
+ * organization's own administrators, never on the record's own response: a representative reading a shared record must
834
+ * not learn which other relationships it reaches, nor the id of the one that created it (#2617).
835
+ */
836
+ READ_RECORD_SHARING = 'readRecordSharing',
837
+ }
838
+
839
+ /**
840
+ * What one relationship's people reach of one record (#2736), as the sharing read answers it: each field the engine's own
841
+ * decision (`describeRelationshipRecordReach`), so a screen offers a share only where it changes what someone reads.
842
+ */
843
+ export const RelationshipRecordReachSchema = z.object({
844
+ confersNow: z.boolean()
845
+ .describe('The relationship confers authority right now: live, its kind and role still declared, both organizations active.'),
846
+ rolesReachRecord: z.boolean()
847
+ .describe('Its people\'s roles let them read this record, before any share: the resource\'s read permission through the relationship\'s role and the capabilities you lent it, and, for a relationship limited to units, the record\'s unit.'),
848
+ readsWithoutShare: z.boolean()
849
+ .describe('Its people read this record without a share naming the relationship: it was created through it, the relationship reads your organization\'s own records of this kind, or the kind is common to every relationship.'),
850
+ wouldReadIfShared: z.boolean()
851
+ .describe('Sharing the record with the relationship would let its people read it.'),
852
+ });
853
+ export type RelationshipRecordReach = z.infer<typeof RelationshipRecordReachSchema>;
854
+
855
+ /** One relationship in the sharing read's answer: who it is, and what its people reach of the record. */
856
+ export const RelationshipRecordSharingRelationshipSchema = RelationshipRecordReachSchema.extend({
857
+ relationshipId: z.string().describe('The relationship, by its id: the value `shareRecord` and `unshareRecord` name.'),
858
+ representingOrganizationName: z.string().optional().describe('The representing organization\'s name, when the relationship carries it.'),
859
+ });
860
+
861
+ /**
862
+ * Whose a record is and who it is shared with (#2736), as {@link OrganizationRelationships_Operations.READ_RECORD_SHARING}
863
+ * answers it. Both fields are engine-managed on every record that carries relationship provenance and are stripped from
864
+ * the record's own response.
865
+ */
866
+ export const RelationshipRecordSharingSchema = z.object({
867
+ resourceType: z.string().describe('The kind of record, as the application names its resource.'),
868
+ recordId: z.string().describe('The record\'s id in your organization.'),
869
+ viaRelationshipId: z.string().nullable()
870
+ .describe('The relationship the record was created through, or null when it is your organization\'s own.'),
871
+ sharedWithRelationshipIds: z.array(z.string())
872
+ .describe('The relationships you shared the record with. Their representatives read it whichever relationship created it.'),
873
+ commonToEveryRelationship: z.boolean()
874
+ .describe('Whether the application declares this kind of record common to every relationship (`relationshipCommonRecords`): every relationship already reads every record of it, so a share changes nothing.'),
875
+ relationships: z.array(RelationshipRecordSharingRelationshipSchema)
876
+ .describe('Every live relationship of your organization, and any other the record names (created through it, or shared with it): what its people reach of this record.'),
877
+ });
878
+
879
+ export type RelationshipRecordSharing = z.infer<typeof RelationshipRecordSharingSchema>;
880
+
881
+ /** The representing side's verbs, on its own mirror. */
882
+ export enum OrganizationRepresentations_Operations {
883
+ /** The representing organization's ORG_ADMIN proposes a relationship to a granting organization. */
884
+ PROPOSE = 'propose',
885
+ /** The representing organization's ORG_ADMIN accepts a GRANTING organization's proposal. */
886
+ ACCEPT = 'accept',
887
+ /** The representing organization's ORG_ADMIN ends the relationship, or withdraws its own pending proposal. */
888
+ WITHDRAW = 'withdraw',
889
+ /**
890
+ * INTERNAL — the APPLICATION withdraws a live relationship on the representing organization's behalf, with the reason
891
+ * stated (#2573): what the representing organization would do, done when the application's own records say it must.
892
+ * Wonder Ledger's first: once a firm's mandate ENDED and nothing still awaits its sign-off, the firm keeps no access to
893
+ * the client (a processor's access ends with its services). The transition, its audit row in both trails and the
894
+ * ending of the relationship's reach are the representing side's `withdraw`; only no person acted.
895
+ */
896
+ WITHDRAW_ON_BEHALF = 'withdrawOnBehalf',
897
+ }
898
+
899
+ export enum RepresentativeAssignments_Operations {
900
+ /** The representing organization's ORG_ADMIN designates one of its members to serve an ACTIVE engagement. */
901
+ ASSIGN = 'assign',
902
+ /** Ends an ACTIVE assignment, or withdraws one still awaiting the granting organization's approval (#1612). */
903
+ UNASSIGN = 'unassign',
904
+ /**
905
+ * Apply the granting organization's answer to a per-representative approval (#1612) — INTERNAL only, reached through
906
+ * the human-decision answer path after the answerer was authorized there. Approval re-checks everything admission
907
+ * depends on, inside one transaction, before creating the membership.
908
+ */
909
+ SETTLE_GRANTOR_APPROVAL = 'settleGrantorApproval',
910
+ }
911
+ ```