@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -7,7 +7,8 @@ Read this when authoring Step 3 (grounding). It surfaces:
|
|
|
7
7
|
`resource.<resourceType>.read` (the exact string to put in the agent's
|
|
8
8
|
`capabilities.tools.functionRefs`). Its `filters` argument is bound when the tool is
|
|
9
9
|
registered, from the `filterFields` your resource's SEARCH (else LIST) declares: an enum
|
|
10
|
-
offers its values, a `z.date()` a `{ startDate, endDate }` range
|
|
10
|
+
offers its values, a `z.date()` a `{ startDate, endDate }` range, a declared number range
|
|
11
|
+
`{ min, max }`, and a declared month range `{ startMonth, endMonth }`. So what the assistant can
|
|
11
12
|
narrow by is exactly what you declare there — declare `status`, `priority` and a due date
|
|
12
13
|
if people will ask "what is pending / urgent / due this week".
|
|
13
14
|
- `resourceWriteTool(resourceType, op, options)` — the generic WRITE factory (the
|
|
@@ -75,7 +76,7 @@ All import from `@wildo-ai/saas-backend-lib`.
|
|
|
75
76
|
*
|
|
76
77
|
* **Narrowing by a field's value.** The tool also offers `filters`: the filter fields the resource's
|
|
77
78
|
* default SEARCH declares (else its LIST), each as it accepts values — one of an enum's values, a
|
|
78
|
-
* string, a number, a boolean, or a `{ startDate, endDate }` / `{ min, max }` range. They are bound
|
|
79
|
+
* string, a number, a boolean, or a `{ startDate, endDate }` / `{ min, max }` / `{ startMonth, endMonth }` range. They are bound
|
|
79
80
|
* when the tool is registered, from the operation it dispatches, so the model is offered what that
|
|
80
81
|
* operation's repository allows — less the primary scope's field (`organizationId`), which the
|
|
81
82
|
* conversation's own context decides. A question about a status or a category is a filter, never a
|
|
@@ -128,10 +129,15 @@ export function resourceReadTool(
|
|
|
128
129
|
* with the ACL unread. On `organizations` CREATE that combination created ownerless tenants.
|
|
129
130
|
*
|
|
130
131
|
* A resource that declares no URL-bearing default for the operation is REFUSED rather than written
|
|
131
|
-
* through its internal variant.
|
|
132
|
-
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
132
|
+
* through its internal variant. Owner FKs and other server-set fields are EC-injected / `excludeFromCreate`,
|
|
133
|
+
* so the model can never spoof ownership through the tool arguments.
|
|
134
|
+
*
|
|
135
|
+
* **Retries.** A model calls a write tool again when a call fails, so an operation that declares
|
|
136
|
+
* `idempotencyKey` takes the key as the `idempotencyKey` ARGUMENT: add
|
|
137
|
+
* `idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION)` to `inputSchema` (`.optional()` for an
|
|
138
|
+
* `ACCEPTED` operation). The factory takes it out of the fields and the framework answers the model's retry
|
|
139
|
+
* with the first result instead of writing twice. A `REQUIRED` operation called without it is refused before
|
|
140
|
+
* anything runs, naming the argument.
|
|
135
141
|
*
|
|
136
142
|
* Unlike the read tool (whose args are a fixed `{ searchQuery, limit }`), a write
|
|
137
143
|
* tool's arguments are resource-specific, so the caller MUST supply the model-facing
|
|
@@ -224,6 +230,14 @@ export interface FunctionToolExecutionContext {
|
|
|
224
230
|
* the decision that authorized it. Absent on every call no one had to approve.
|
|
225
231
|
*/
|
|
226
232
|
decisionRef?: string;
|
|
233
|
+
/**
|
|
234
|
+
* #2904: the id of the approval seal of the answer `decisionRef` names (an `approvalSeals` row), set by the engine from
|
|
235
|
+
* the release that wrote it, never from the model or a request. A tool that RECORDS the decision (a sign-off, an
|
|
236
|
+
* acceptance) stores it beside the decider, so the record points at the signed evidence of what the person was shown
|
|
237
|
+
* and answered. Absent when the answer was not sealed: a decision answered before seals existed, or a host that binds
|
|
238
|
+
* no seal services. Its absence never changes whether the call may run.
|
|
239
|
+
*/
|
|
240
|
+
decisionSealId?: string;
|
|
227
241
|
/**
|
|
228
242
|
* Which door opened the turn this call belongs to (#1594), read by the engine from the execution ROW —
|
|
229
243
|
* at turn start and again at a decision's resume — never from the caller. It decides whether a gated call
|
|
@@ -241,6 +255,26 @@ export interface FunctionToolExecutionContext {
|
|
|
241
255
|
* `TOKENIZE`. Loaded by the engine from the conversation and stored again with the turn; a tool never needs it.
|
|
242
256
|
*/
|
|
243
257
|
personalDataPlaceholders?: PersonalDataPlaceholderTable;
|
|
258
|
+
/**
|
|
259
|
+
* #3295: on a resumed turn, the personal-data treatment the turn paused under. The paused messages are in the form it
|
|
260
|
+
* wrote, placeholders included, and only a guard under it can read them back, so the resume runs under at least this
|
|
261
|
+
* however the agent's declaration or an organization's policy has moved since. Its own field rather than an entry of the
|
|
262
|
+
* turn's policy frame: a frame applies only to the organizations it covers, and a call can name none, or another.
|
|
263
|
+
*/
|
|
264
|
+
heldPersonalDataTreatment?: FlowsActors_PersonalDataModelTreatment;
|
|
265
|
+
/**
|
|
266
|
+
* #3364 step 3: on a resumed turn, the output moderation its replies were judged under when it paused, tightened by the
|
|
267
|
+
* organizations whose records it had read. Those records stay in the paused messages, so the resume is judged under at
|
|
268
|
+
* least this (`OutputModerationGuard.tighten`).
|
|
269
|
+
*/
|
|
270
|
+
heldOutputModeration?: FlowsActors_OutputModerationPolicy;
|
|
271
|
+
/**
|
|
272
|
+
* #3313: told a function tool's `execute` is about to run, with the id of its call, once its arguments are final. The one
|
|
273
|
+
* point that means the call ran: the SDK reports an approved call it refused to run as a `tool-error`, so an error event
|
|
274
|
+
* says nothing about whether `execute` was reached. A resumed turn reads this to tell an accepted call that ran and failed
|
|
275
|
+
* from one that never ran.
|
|
276
|
+
*/
|
|
277
|
+
onFunctionToolExecuting?: (toolCallId: string) => void;
|
|
244
278
|
}
|
|
245
279
|
|
|
246
280
|
/**
|
|
@@ -381,6 +415,75 @@ export interface FunctionTool {
|
|
|
381
415
|
* tool without `argumentsResource` (and whose result is not `RECORDS_OF_RESOURCE`) accepts no placeholder at all.
|
|
382
416
|
*/
|
|
383
417
|
argumentsResource?: FunctionTool_ArgumentsResource;
|
|
418
|
+
/**
|
|
419
|
+
* The argument that names a FILE the person approves (#2904): a generated document, an agent's output file, a report to
|
|
420
|
+
* send. Declare it on an approval-gated tool whose call is about a file, so that what the person approves is the file's
|
|
421
|
+
* BYTES and not merely its id:
|
|
422
|
+
*
|
|
423
|
+
* - the decision's card binds the file by its content hash (hashed now when the file has none), so an answer given on a
|
|
424
|
+
* card shown before the file's recorded hash changed is refused as stale;
|
|
425
|
+
* - the approval's seal commits to `H(salt ‖ contentSha256)` and attests the file, which is then frozen while the seal
|
|
426
|
+
* exists (its bytes are not removed or replaced on request), and a verifier given the file's bytes reports a file
|
|
427
|
+
* changed since the approval;
|
|
428
|
+
* - an approver may not edit this argument: approving another file than the one shown is not an approval of it.
|
|
429
|
+
*
|
|
430
|
+
* A file the engine cannot hash (a remote reference whose vendor keeps the bytes, a deleted or missing file, a file of
|
|
431
|
+
* another organization) is shown and sealed as NOT bound, never bound to an empty hash.
|
|
432
|
+
*
|
|
433
|
+
* Registration refuses it on a tool that is not approval-gated, on a question tool, and when the tool's argument schema
|
|
434
|
+
* has no top-level string argument of that name. A tool without it is unaffected.
|
|
435
|
+
*/
|
|
436
|
+
deliverableFileArgument?: string;
|
|
437
|
+
/**
|
|
438
|
+
* The fields of the row the call acts on that the approval COVERS (#2914): the record's SEALED FIELD SET. Declare it
|
|
439
|
+
* on an approval-gated tool whose approval is a statement about a record's values (a month's figures signed off, an
|
|
440
|
+
* invoice's amounts approved), so that whether the approval still holds can be answered later:
|
|
441
|
+
*
|
|
442
|
+
* - the decision's card shows these values of the row named by `argumentsResource.rowIdArgument`, read as the system
|
|
443
|
+
* when the card is built, so the person approves what they read; a card read before one of them changed is refused
|
|
444
|
+
* as stale;
|
|
445
|
+
* - the approval's seal commits to them inside its presentation, and the currency check
|
|
446
|
+
* (`approvalSealSubjectCurrencyOf`, the operator door `POST /internal/admin/approval-seals/currency`, and
|
|
447
|
+
* `wildo seal verify --subject-record`) compares them with the record as it is: CURRENT right after the approval,
|
|
448
|
+
* NO_LONGER_CURRENT once one of them changes.
|
|
449
|
+
*
|
|
450
|
+
* Name only what the approval is ABOUT. Never a lifecycle or approval field (a status, `updatedAt`, the column the
|
|
451
|
+
* approved call writes the seal's id or the signer into): the approved call's own write would otherwise make its own
|
|
452
|
+
* seal look stale. A row of another organization than the decision's, or one that cannot be read, is shown and sealed
|
|
453
|
+
* with no record values, and so is an answer given on a chat card: no notice card shows the row, so its SENT seal
|
|
454
|
+
* claims none of it (its currency reads NO_SEALED_FIELD_SET).
|
|
455
|
+
*
|
|
456
|
+
* Registration refuses it on a tool that is not approval-gated, on a question tool, without
|
|
457
|
+
* `argumentsResource.rowIdArgument`, and when it names no field, a field twice, or a field the resource's main schema
|
|
458
|
+
* does not declare (checked when the resource is registered).
|
|
459
|
+
*/
|
|
460
|
+
sealedRecordFields?: readonly string[];
|
|
461
|
+
/**
|
|
462
|
+
* An approval of this tool on a row REPLACES the latest earlier approval of this tool on the same row (#2914): its seal
|
|
463
|
+
* names that earlier seal as the one it supersedes, as a decision answered again supersedes its own earlier seal. For a
|
|
464
|
+
* decision that is taken again on the same record after the record was reopened (a month signed off, reopened and
|
|
465
|
+
* signed off again): the two are different decisions, and without this the second seal names no predecessor, so a
|
|
466
|
+
* verifier sees two approvals of one record and nothing saying which one stands.
|
|
467
|
+
*
|
|
468
|
+
* Only the latest seal of the same source, the same record (`argumentsResource.rowIdArgument`) and the same tool is
|
|
469
|
+
* superseded, never an approval made through another tool on that row; a decision answered again still supersedes its
|
|
470
|
+
* own earlier answer first. Requires an approval gate and `argumentsResource.rowIdArgument`.
|
|
471
|
+
*/
|
|
472
|
+
approvalReplacesEarlierApprovalOfRow?: boolean;
|
|
473
|
+
/**
|
|
474
|
+
* The electronic signature the file deliverable needs once the person approved it (#2293): after the approval's seal is
|
|
475
|
+
* SEALED, the engine sends the approved file (`deliverableFileArgument`, bound by its hash) to the vendor selected for
|
|
476
|
+
* `ELECTRONIC_SIGNATURE`, for `signers` to sign at `requiredLevel`, and records a `signatureRequests` row. Only a
|
|
477
|
+
* validated signed document makes that request SIGNED. Opt-in per deliverable: a tool without it is unaffected.
|
|
478
|
+
*
|
|
479
|
+
* Requires `deliverableFileArgument`, an approval gate, and the `ELECTRONIC_SIGNATURE` capability enabled with a
|
|
480
|
+
* provider that applies `requiredLevel`: the application refuses to start otherwise, so a requirement nothing could meet
|
|
481
|
+
* is found before the first approval rather than after it.
|
|
482
|
+
*
|
|
483
|
+
* @example
|
|
484
|
+
* electronicSignature: { requiredLevel: ElectronicSignature_Level.ADVANCED, signers: [FunctionTool_SignerSource.APPROVER] },
|
|
485
|
+
*/
|
|
486
|
+
electronicSignature?: FunctionTool_ElectronicSignatureRequirement;
|
|
384
487
|
/**
|
|
385
488
|
* The tool IS a question to the person whose turn it is (#2720). Set by {@link askPersonTool}; do not set it on a
|
|
386
489
|
* tool you write by hand.
|
|
@@ -426,7 +529,13 @@ export interface FunctionTool {
|
|
|
426
529
|
*
|
|
427
530
|
* - `{ kind: RECORDS_OF_RESOURCE, resourceType }` — records of that resource: a record, or `{ data: [records] }`. Their
|
|
428
531
|
* personal fields are treated; for a tool that WRITES them, a placeholder in its arguments is put back too (only into
|
|
429
|
-
* a field of the same kind).
|
|
532
|
+
* a field of the same kind). A row of an organization-owned resource is treated under its organization's agent
|
|
533
|
+
* policy too (#2877), so the engine must know whose row it is (#3369). It does when the row keeps its
|
|
534
|
+
* `organizationId`, and for a `PRINCIPAL_RESOURCE_OPERATION` tool whatever the row keeps, because each dispatch
|
|
535
|
+
* records the owners of the rows it returned (as long as the operations it dispatches return rows naming their
|
|
536
|
+
* organization: a custom operation's answer that names none leaves the call's rows to the strictest policy). A tool reaching its rows any other way declares
|
|
537
|
+
* `rowsNameTheirOrganization: true` once every row it returns carries `organizationId`; without it, startup names the
|
|
538
|
+
* tool, and a row naming no organization read by an agent acting in none is treated under the strictest policy.
|
|
430
539
|
* - `{ kind: NOT_FROM_RECORDS, reason }` — nothing the engine moved from a record (an id list, a computed total, the
|
|
431
540
|
* answer a person chose to give). Say why: the reason is what a reviewer reads.
|
|
432
541
|
* - `{ kind: TREATED_BY_TOOL, treat }` — the tool knows its own shape and treats it (the engine's retrieval tool).
|
|
@@ -474,7 +583,17 @@ export enum FunctionToolPersonalDataOutputKind {
|
|
|
474
583
|
|
|
475
584
|
/** See {@link FunctionTool.personalDataOutput}. */
|
|
476
585
|
export type FunctionTool_PersonalDataOutput =
|
|
477
|
-
| {
|
|
586
|
+
| {
|
|
587
|
+
readonly kind: FunctionToolPersonalDataOutputKind.RECORDS_OF_RESOURCE;
|
|
588
|
+
readonly resourceType: ResourceType;
|
|
589
|
+
/**
|
|
590
|
+
* #3369: every row this tool returns carries its resource's `organizationId` (the organization row its own `_id`).
|
|
591
|
+
* For a tool that does not reach its rows through `dispatchResourceOperationAsTool`, whose owners the engine
|
|
592
|
+
* therefore cannot observe. Checked on every row: one that still names no organization is treated under the
|
|
593
|
+
* strictest policy, and counted on the call's operation record.
|
|
594
|
+
*/
|
|
595
|
+
readonly rowsNameTheirOrganization?: true;
|
|
596
|
+
}
|
|
478
597
|
| { readonly kind: FunctionToolPersonalDataOutputKind.NOT_FROM_RECORDS; readonly reason: string }
|
|
479
598
|
| {
|
|
480
599
|
readonly kind: FunctionToolPersonalDataOutputKind.TREATED_BY_TOOL;
|
|
@@ -533,6 +652,39 @@ export interface FunctionTool_HumanApprovalGate {
|
|
|
533
652
|
* ```
|
|
534
653
|
*/
|
|
535
654
|
requiredQualificationKinds?: readonly string[];
|
|
655
|
+
/**
|
|
656
|
+
* Whether the answer must carry a fresh step-up proof bound to THIS decision (#2923), as an operation approval's
|
|
657
|
+
* `requiresApproval.requiresStepUpAuthentication` does. The person re-proves a factor (`POST /auth/reauth` with a
|
|
658
|
+
* `decisionBinding` naming the decision and the presentation they answer) and answers from the decision inbox with it
|
|
659
|
+
* in `X-Reauth-Token`. A socket or chat answer carries no proof, so it is refused (`decision_step_up_required`).
|
|
660
|
+
*
|
|
661
|
+
* Use it when approving the call commits the person to something they must be present for: releasing a payment,
|
|
662
|
+
* signing off a filing. Applies to an agent's question (`askPersonTool`) the same way.
|
|
663
|
+
*/
|
|
664
|
+
requiresStepUpAuthentication?: boolean;
|
|
665
|
+
/**
|
|
666
|
+
* What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true`; startup refuses it without:
|
|
667
|
+
* `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven` (any step-up
|
|
668
|
+
* factor), `possession` (TOTP or a passkey) or `phishing_resistant` (a passkey). The approvers' user types must allow
|
|
669
|
+
* that factor as a step-up method. The factor and the instant it was proven are recorded on the decision and its
|
|
670
|
+
* approval seal (`decider.stepUpMethod`, `decider.stepUpAt`).
|
|
671
|
+
*
|
|
672
|
+
* ```ts
|
|
673
|
+
* humanApproval: {
|
|
674
|
+
* route: HumanDecision_RouteKind.ROLE, eligibleRole: 'treasurer',
|
|
675
|
+
* requiresStepUpAuthentication: true,
|
|
676
|
+
* stepUp: { maximumAgeSeconds: 120, minimumAssurance: HumanDecision_StepUpAssurance.PHISHING_RESISTANT },
|
|
677
|
+
* }
|
|
678
|
+
* ```
|
|
679
|
+
*/
|
|
680
|
+
stepUp?: HumanDecision_StepUpRequirement;
|
|
681
|
+
/**
|
|
682
|
+
* The channels that may answer the call (#2923): `web_session` (the application), `chat` (a chat card),
|
|
683
|
+
* `api_client` (a client the person delegated to). Absent: every channel the other requirements allow. A tool approval
|
|
684
|
+
* is decided in person, so `api_client` never answers one whatever this says; `chat` is refused beside a step-up, which
|
|
685
|
+
* a chat answer cannot carry. A chat card for a call it may not answer links to it in the application.
|
|
686
|
+
*/
|
|
687
|
+
answerChannels?: HumanDecision_AnswerChannels;
|
|
536
688
|
/**
|
|
537
689
|
* ASSIGNEE only: resolves the ONE person to route to, when the call pauses, from its arguments and
|
|
538
690
|
* context (for example, the record's account manager). Returning `undefined`, or a person without
|
|
@@ -695,6 +847,175 @@ export function functionToolArgumentsAreGuarded(tool: Pick<FunctionTool, 'effect
|
|
|
695
847
|
return tool.effect !== FunctionToolEffect.READ || personalDataArgumentsResourceOf(tool) !== undefined;
|
|
696
848
|
}
|
|
697
849
|
|
|
850
|
+
/** One date-text form per schema: the SDK and the decision door ask for it on every call. See {@link toolCallSchemaOf}. */
|
|
851
|
+
const TOOL_CALL_SCHEMAS = new WeakMap<z.ZodTypeAny, z.ZodTypeAny>();
|
|
852
|
+
|
|
853
|
+
/**
|
|
854
|
+
* A parse output with every `Date` put back to the text (or epoch number) it was read from in `raw`, at the same place; a
|
|
855
|
+
* `Date` with no such counterpart (one a transform or a default made) as its RFC 3339 text. Everything else as parsed.
|
|
856
|
+
*/
|
|
857
|
+
function withDateText(parsed: unknown, raw: unknown): unknown {
|
|
858
|
+
if (parsed instanceof Date) return typeof raw === 'string' || typeof raw === 'number' ? raw : parsed.toISOString();
|
|
859
|
+
if (Array.isArray(parsed)) return parsed.map((item, index) => withDateText(item, Array.isArray(raw) ? raw[index] : undefined));
|
|
860
|
+
if (parsed !== null && typeof parsed === 'object' && Object.getPrototypeOf(parsed) === Object.prototype) {
|
|
861
|
+
const rawFields = raw !== null && typeof raw === 'object' && !Array.isArray(raw) ? raw as Record<string, unknown> : {};
|
|
862
|
+
return Object.fromEntries(Object.entries(parsed).map(([key, value]) => [key, withDateText(value, Object.hasOwn(rawFields, key) ? rawFields[key] : undefined)]));
|
|
863
|
+
}
|
|
864
|
+
return parsed;
|
|
865
|
+
}
|
|
866
|
+
|
|
867
|
+
/**
|
|
868
|
+
* A tool's arguments as the SDK holds a call (#3489): validated by the schema's JSON form, every check, refinement and
|
|
869
|
+
* transform included, but with each DATE kept as the text it was written in rather than read into a `Date`.
|
|
870
|
+
*
|
|
871
|
+
* ## Why the SDK must never hold a `Date`
|
|
872
|
+
*
|
|
873
|
+
* The SDK treats a call's input as JSON data, and three of its mechanisms break on anything else:
|
|
874
|
+
* - an approval-gated call is paused and stored as JSON, and on approval the SDK requires that parsing the call again
|
|
875
|
+
* yields the stored input (`isDeepEqualData`). A `Date` comes back from storage as its text, so a date argument never
|
|
876
|
+
* compared equal and the call could never be approved;
|
|
877
|
+
* - the approval signature hashes the input with `canonicalJSON`, which writes a `Date` as `{}`: it covered no date's value;
|
|
878
|
+
* - a person's edit is stored as written, and a date parsed to a `Date` never equals the person's text either.
|
|
879
|
+
* spec-cite: N/A — read from the `ai@7.0.142` source (`generate-text/validate-tool-approvals.ts`, `util/is-deep-equal-data.ts`,
|
|
880
|
+
* `util/canonical-hash.ts`), which documents none of it.
|
|
881
|
+
*
|
|
882
|
+
* So the text stays text up to `execute`, where {@link argumentsAToolExecutesWith} reads the dates (a value walk, no second
|
|
883
|
+
* parse). The JSON Schema the model is told is the JSON form's own (a date is `string`, `date-time`): zod's pipe
|
|
884
|
+
* processor is mirrored, since the wrapper's own input side is `any`.
|
|
885
|
+
*
|
|
886
|
+
* Rejected: restoring the stored call's `Date`s at the resume. It made the stored input equal again, but left the
|
|
887
|
+
* signature blind to dates and an edit's text unequal; and the issue's other direction, refusing a gated tool that
|
|
888
|
+
* declares `z.date()`, would forbid what the framework teaches applications to declare.
|
|
889
|
+
*/
|
|
890
|
+
export function toolCallSchemaOf(schema: z.ZodTypeAny): z.ZodTypeAny {
|
|
891
|
+
const known = TOOL_CALL_SCHEMAS.get(schema);
|
|
892
|
+
if (known) return known;
|
|
893
|
+
const jsonForm = jsonParsingSchemaOf(schema);
|
|
894
|
+
const callForm = z.any().transform(async (raw, ctx) => {
|
|
895
|
+
const parsed = await jsonForm.safeParseAsync(raw);
|
|
896
|
+
if (!parsed.success) {
|
|
897
|
+
for (const issue of parsed.error.issues) ctx.addIssue({ ...issue } as never);
|
|
898
|
+
return z.NEVER;
|
|
899
|
+
}
|
|
900
|
+
return withDateText(parsed.data, raw);
|
|
901
|
+
});
|
|
902
|
+
callForm._zod.processJSONSchema = (ctx, _json, params) => {
|
|
903
|
+
z.core.process(jsonForm, ctx as never, params as never);
|
|
904
|
+
(ctx as unknown as { seen: Map<z.ZodTypeAny, { ref?: z.ZodTypeAny }> }).seen.get(callForm)!.ref = jsonForm;
|
|
905
|
+
};
|
|
906
|
+
TOOL_CALL_SCHEMAS.set(schema, callForm);
|
|
907
|
+
return callForm;
|
|
908
|
+
}
|
|
909
|
+
|
|
910
|
+
/**
|
|
911
|
+
* The schema the SDK validates this tool's calls against, which is also the one it revalidates an approved call with
|
|
912
|
+
* (#3295): the tool's own, or under `TOKENIZE` the form whose personal fields also accept a placeholder, since a personal
|
|
913
|
+
* value reaches the SDK as one. The ONE answer: the agent service hands it to the SDK and the decision door rehearses with
|
|
914
|
+
* it, so the two read one schema.
|
|
915
|
+
*
|
|
916
|
+
* In its call form ({@link toolCallSchemaOf}): validated as JSON (#3478), a date's text kept (#3489). A model writes a tool
|
|
917
|
+
* call as JSON, so a `z.date()` argument arrives as an RFC 3339 string; it is checked here, told to the model as `string`
|
|
918
|
+
* `date-time`, and read into a `Date` only for `execute`.
|
|
919
|
+
*/
|
|
920
|
+
export function sdkInputSchemaOfFunctionTool(
|
|
921
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
922
|
+
guard: PersonalDataGuard | undefined,
|
|
923
|
+
): z.ZodTypeAny {
|
|
924
|
+
const argumentsResource = guard !== undefined && functionToolArgumentsAreGuarded(tool) ? personalDataArgumentsResourceOf(tool) : undefined;
|
|
925
|
+
return toolCallSchemaOf(guard?.treatment === RedactionType.TOKENIZE && argumentsResource !== undefined
|
|
926
|
+
? placeholderTolerantInputSchema(tool.inputSchema, guard.personalFieldsOf(argumentsResource))
|
|
927
|
+
: tool.inputSchema);
|
|
928
|
+
}
|
|
929
|
+
|
|
930
|
+
/**
|
|
931
|
+
* The target fields of a guarded write whose tool names no resource for its arguments (#2848): none. Every issued
|
|
932
|
+
* placeholder is then refused ("that field does not hold data of the same kind"), as is every withheld marker and every
|
|
933
|
+
* placeholder the conversation did not issue, so the write can store only values the model actually wrote.
|
|
934
|
+
*/
|
|
935
|
+
const NO_PERSONAL_ARGUMENT_FIELDS: PersonalFieldMap = new Map();
|
|
936
|
+
|
|
937
|
+
/**
|
|
938
|
+
* What a tool's `execute` receives for the arguments the SDK hands it (#2292, #3295): under a guard, a placeholder is put
|
|
939
|
+
* back (only into a field of the same kind) and the result held to the tool's own schema, which the placeholder-tolerant
|
|
940
|
+
* one the model saw was not. Throws what the run would throw: a `PersonalDataPlaceholderRefusal` for a marker or a
|
|
941
|
+
* placeholder that cannot be put back, a schema error for a value the tool refuses.
|
|
942
|
+
*
|
|
943
|
+
* The ONE body of that step: `execute` runs it, and the decision door rehearses it before a decision settles, so a call
|
|
944
|
+
* cannot be recorded as accepted on an answer the run would refuse.
|
|
945
|
+
*/
|
|
946
|
+
export async function argumentsAToolRunsWith(
|
|
947
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
948
|
+
guard: PersonalDataGuard | undefined,
|
|
949
|
+
args: unknown,
|
|
950
|
+
): Promise<unknown> {
|
|
951
|
+
if (!functionToolArgumentsAreGuarded(tool)) return args;
|
|
952
|
+
if (guard === undefined) {
|
|
953
|
+
// #2877: an unguarded call can still hold a withheld marker in its messages: a row an organization outside the call's
|
|
954
|
+
// scope owns was withheld from its model (`treatRecordsResultByOwner`), and a resume after an approval pause runs with
|
|
955
|
+
// no guard of that call. A marker stands for a value nobody may store, so it is refused here whatever the call, and the
|
|
956
|
+
// decision door rehearses the same refusal. Nothing else changes for an unguarded call: no placeholder is put back and
|
|
957
|
+
// the arguments are not parsed again.
|
|
958
|
+
const carrying = argumentsCarryingWithheldMarkers(args);
|
|
959
|
+
if (carrying.length > 0) {
|
|
960
|
+
throw new PersonalDataPlaceholderRefusal(`${carrying.map((name) => `'${name}'`).join(', ')} carries a value you were not shown (⟦withheld:…⟧). Write a value you know, or leave the field out.`);
|
|
961
|
+
}
|
|
962
|
+
return args;
|
|
963
|
+
}
|
|
964
|
+
// Asynchronously, as the SDK validates: a tool may declare an async refinement, and `parse` would refuse every value of it.
|
|
965
|
+
// The tool's own schema in its call form (#3478, #3489): a date is checked and kept as its text, as the SDK holds it, so
|
|
966
|
+
// the decision door compares what a person read with what runs; `execute` reads it (`argumentsAToolExecutesWith`).
|
|
967
|
+
return toolCallSchemaOf(tool.inputSchema).parseAsync(guard.reidentifyArguments(args, argumentFieldsOf(tool, guard)));
|
|
968
|
+
}
|
|
969
|
+
|
|
970
|
+
/**
|
|
971
|
+
* What a tool's `execute` is called with (#3489): {@link argumentsAToolRunsWith}, with each date the tool's schema declares
|
|
972
|
+
* read into a `Date`. The SDK holds a date as its text ({@link toolCallSchemaOf}), so this is where the tool gets the
|
|
973
|
+
* `Date` its `z.date()` promises. A value walk on the schema's output side, never a second parse: the arguments are
|
|
974
|
+
* already validated, and a transform must not run twice.
|
|
975
|
+
*/
|
|
976
|
+
export async function argumentsAToolExecutesWith(
|
|
977
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
978
|
+
guard: PersonalDataGuard | undefined,
|
|
979
|
+
args: unknown,
|
|
980
|
+
): Promise<unknown> {
|
|
981
|
+
return ResourcesConfigOperationsDtosBuilderUtils.restoreStoredDates(await argumentsAToolRunsWith(tool, guard, args), tool.inputSchema);
|
|
982
|
+
}
|
|
983
|
+
|
|
984
|
+
function argumentFieldsOf(tool: Pick<FunctionTool, 'argumentsResource' | 'personalDataOutput'>, guard: PersonalDataGuard): PersonalFieldMap {
|
|
985
|
+
const argumentsResource = personalDataArgumentsResourceOf(tool);
|
|
986
|
+
return argumentsResource === undefined ? NO_PERSONAL_ARGUMENT_FIELDS : guard.personalFieldsOf(argumentsResource);
|
|
987
|
+
}
|
|
988
|
+
|
|
989
|
+
/**
|
|
990
|
+
* #3295: {@link argumentsAToolRunsWith} rehearsed for the decision door, which must say why rather than throw: what
|
|
991
|
+
* `execute` would receive (`ran`) beside the same arguments before its parse (`readAs`, the values a person reads), or the
|
|
992
|
+
* arguments that stop it, by name. A value that cannot be put back is named alone, by asking the guard field by field; a
|
|
993
|
+
* refusal it cannot place names every argument.
|
|
994
|
+
*/
|
|
995
|
+
export async function rehearsedToolArguments(
|
|
996
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
997
|
+
guard: PersonalDataGuard | undefined,
|
|
998
|
+
executedCopy: Record<string, unknown>,
|
|
999
|
+
): Promise<{ ran: unknown; readAs: unknown } | { refusedArguments: string[] }> {
|
|
1000
|
+
const guarded = guard !== undefined && functionToolArgumentsAreGuarded(tool) ? guard : undefined;
|
|
1001
|
+
try {
|
|
1002
|
+
return {
|
|
1003
|
+
ran: await argumentsAToolRunsWith(tool, guard, executedCopy),
|
|
1004
|
+
readAs: guarded ? guarded.reidentifyArguments(executedCopy, argumentFieldsOf(tool, guarded)) : executedCopy,
|
|
1005
|
+
};
|
|
1006
|
+
} catch {
|
|
1007
|
+
const unreadable = guarded === undefined ? argumentsCarryingWithheldMarkers(executedCopy) : Object.entries(executedCopy).filter(([name, value]) => {
|
|
1008
|
+
try {
|
|
1009
|
+
guarded.reidentifyArguments({ [name]: value }, argumentFieldsOf(tool, guarded));
|
|
1010
|
+
return false;
|
|
1011
|
+
} catch {
|
|
1012
|
+
return true;
|
|
1013
|
+
}
|
|
1014
|
+
}).map(([name]) => name);
|
|
1015
|
+
return { refusedArguments: (unreadable.length > 0 ? unreadable : Object.keys(executedCopy)).sort() };
|
|
1016
|
+
}
|
|
1017
|
+
}
|
|
1018
|
+
|
|
698
1019
|
/**
|
|
699
1020
|
* Whether a turn's conversation is drawn for a person by the application: a turn over the application's own socket.
|
|
700
1021
|
* A turn that records no door predates the door's recording and was a socket turn. Total over the vocabulary.
|
|
@@ -733,6 +1054,13 @@ export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functi
|
|
|
733
1054
|
throw new FunctionToolApprovalGateError(`Function tool "${tool.functionRef}" declares an approval gate nobody can answer: ${why}`);
|
|
734
1055
|
};
|
|
735
1056
|
refuseUnsoundDeadlines(tool.functionRef, gate);
|
|
1057
|
+
// #2923: a step-up declaration that cannot mean what it says is refused here, at registration.
|
|
1058
|
+
const stepUpIssues = [
|
|
1059
|
+
...humanDecisionStepUpDeclarationIssues(gate, 'humanApproval'),
|
|
1060
|
+
// #2923: and a channel declaration that names a channel that could never answer it.
|
|
1061
|
+
...humanDecisionAnswerChannelsIssues(gate.answerChannels, humanDecisionStepUpRequirementOf(gate) !== undefined, 'humanApproval'),
|
|
1062
|
+
];
|
|
1063
|
+
if (stepUpIssues.length > 0) refuse(stepUpIssues.join(' '));
|
|
736
1064
|
// #2967: a required qualification names a kind, once each. Whether the application DECLARES it needs the configuration,
|
|
737
1065
|
// which a tool does not see: the startup validator asks that.
|
|
738
1066
|
const requiredKinds = gate.requiredQualificationKinds ?? [];
|
|
@@ -761,4 +1089,115 @@ export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functi
|
|
|
761
1089
|
}
|
|
762
1090
|
}
|
|
763
1091
|
}
|
|
1092
|
+
/**
|
|
1093
|
+
* Who signs a deliverable sent for electronic signature (#2293). A closed vocabulary: each member names where the person
|
|
1094
|
+
* comes from, so nothing the model wrote picks a signer.
|
|
1095
|
+
*/
|
|
1096
|
+
export enum FunctionTool_SignerSource {
|
|
1097
|
+
/** The person whose approval of the call was sealed: the approver signs what they approved. */
|
|
1098
|
+
APPROVER = 'approver',
|
|
1099
|
+
}
|
|
1100
|
+
|
|
1101
|
+
/** A tool's electronic-signature requirement for its file deliverable (`FunctionTool.electronicSignature`, #2293). */
|
|
1102
|
+
export interface FunctionTool_ElectronicSignatureRequirement {
|
|
1103
|
+
readonly requiredLevel: ElectronicSignature_Level;
|
|
1104
|
+
/** Who signs, in signing order. At least one; each source once. */
|
|
1105
|
+
readonly signers: readonly FunctionTool_SignerSource[];
|
|
1106
|
+
}
|
|
1107
|
+
|
|
1108
|
+
/**
|
|
1109
|
+
* What is wrong with a tool's electronic-signature requirement (`electronicSignature`, #2293), one sentence per problem
|
|
1110
|
+
* with its remedy; empty when it is sound or absent. Read at registration, beside the deliverable's own declaration.
|
|
1111
|
+
*/
|
|
1112
|
+
export function functionToolElectronicSignatureDeclarationProblems(
|
|
1113
|
+
tool: Pick<FunctionTool, 'functionRef' | 'electronicSignature' | 'deliverableFileArgument'>,
|
|
1114
|
+
): string[] {
|
|
1115
|
+
const requirement = tool.electronicSignature;
|
|
1116
|
+
if (requirement === undefined) return [];
|
|
1117
|
+
const named = `Function tool "${tool.functionRef}" declares electronicSignature`;
|
|
1118
|
+
const problems: string[] = [];
|
|
1119
|
+
if (!tool.deliverableFileArgument) problems.push(`${named} and no deliverableFileArgument: only a file deliverable the approver approved by its hash can be sent for signature.`);
|
|
1120
|
+
if (!Object.values(ElectronicSignature_Level).includes(requirement.requiredLevel)) problems.push(`${named} with an unknown requiredLevel "${String(requirement.requiredLevel)}".`);
|
|
1121
|
+
const signers = Array.isArray(requirement.signers) ? requirement.signers : [];
|
|
1122
|
+
if (signers.length === 0) problems.push(`${named} with no signer: name at least one (FunctionTool_SignerSource).`);
|
|
1123
|
+
if (signers.some((signer) => !Object.values(FunctionTool_SignerSource).includes(signer))) problems.push(`${named} with an unknown signer source.`);
|
|
1124
|
+
if (new Set(signers).size !== signers.length) problems.push(`${named} naming one signer source twice.`);
|
|
1125
|
+
return problems;
|
|
1126
|
+
}
|
|
1127
|
+
|
|
1128
|
+
/**
|
|
1129
|
+
* What is wrong with a tool's file-deliverable declaration (`deliverableFileArgument`, #2904), one sentence per problem
|
|
1130
|
+
* with its remedy; empty when it is sound or absent. Read at registration, on the schema the tool is registered with
|
|
1131
|
+
* (after `bindToResources`), so the argument the engine binds is the one the model is offered.
|
|
1132
|
+
*/
|
|
1133
|
+
export function functionToolDeliverableDeclarationProblems(
|
|
1134
|
+
tool: Pick<FunctionTool, 'functionRef' | 'deliverableFileArgument' | 'inputSchema' | 'requiresHumanApproval' | 'humanApproval' | 'asksThePerson'>,
|
|
1135
|
+
): string[] {
|
|
1136
|
+
const argument = tool.deliverableFileArgument;
|
|
1137
|
+
if (argument === undefined) return [];
|
|
1138
|
+
const problems: string[] = [];
|
|
1139
|
+
const named = `Function tool "${tool.functionRef}" declares deliverableFileArgument "${String(argument)}"`;
|
|
1140
|
+
if (typeof argument !== 'string' || argument.trim().length === 0) return [`${named}, which names no argument: name the argument holding the file's id.`];
|
|
1141
|
+
if (!tool.humanApproval && !tool.requiresHumanApproval) {
|
|
1142
|
+
problems.push(`${named} and is not approval-gated: a file deliverable is bound by the approval of the call, so gate it (humanApproval or requiresHumanApproval).`);
|
|
1143
|
+
}
|
|
1144
|
+
if (tool.asksThePerson) problems.push(`${named} and asks the person: a question approves no file.`);
|
|
1145
|
+
const shape = tool.inputSchema instanceof z.ZodObject ? (tool.inputSchema.shape as Record<string, z.ZodTypeAny>) : undefined;
|
|
1146
|
+
const declared = shape?.[argument];
|
|
1147
|
+
if (!declared) {
|
|
1148
|
+
problems.push(`${named}, which is not a top-level argument of its input schema: declare it there as the file's id (a string).`);
|
|
1149
|
+
} else if (!isStringArgumentSchema(declared)) {
|
|
1150
|
+
problems.push(`${named}, which is not a string argument: a file deliverable is named by its file id.`);
|
|
1151
|
+
}
|
|
1152
|
+
return problems;
|
|
1153
|
+
}
|
|
1154
|
+
|
|
1155
|
+
/**
|
|
1156
|
+
* What is wrong with a tool's record-approval declarations (`sealedRecordFields`, `approvalReplacesEarlierApprovalOfRow`,
|
|
1157
|
+
* #2914), one sentence per problem with its remedy; empty when they are sound or absent. `declaredFieldsOf` answers the
|
|
1158
|
+
* fields the resource's main schema declares, or undefined when the resource is not registered (its fields are then not
|
|
1159
|
+
* checked here: a field the row does not hold is shown and sealed as absent).
|
|
1160
|
+
*/
|
|
1161
|
+
export function functionToolRecordApprovalDeclarationProblems(
|
|
1162
|
+
tool: Pick<FunctionTool, 'functionRef' | 'sealedRecordFields' | 'approvalReplacesEarlierApprovalOfRow' | 'argumentsResource' | 'requiresHumanApproval' | 'humanApproval' | 'asksThePerson'>,
|
|
1163
|
+
declaredFieldsOf?: (resourceType: string) => readonly string[] | undefined,
|
|
1164
|
+
): string[] {
|
|
1165
|
+
const fields = tool.sealedRecordFields;
|
|
1166
|
+
const replaces = tool.approvalReplacesEarlierApprovalOfRow === true;
|
|
1167
|
+
if (fields === undefined && !replaces) return [];
|
|
1168
|
+
const problems: string[] = [];
|
|
1169
|
+
const named = `Function tool "${tool.functionRef}" declares ${fields !== undefined ? 'sealedRecordFields' : 'approvalReplacesEarlierApprovalOfRow'}`;
|
|
1170
|
+
if (!tool.humanApproval && !tool.requiresHumanApproval) {
|
|
1171
|
+
problems.push(`${named} and is not approval-gated: it describes what an approval covers, so gate it (humanApproval or requiresHumanApproval).`);
|
|
1172
|
+
}
|
|
1173
|
+
if (tool.asksThePerson) problems.push(`${named} and asks the person: a question approves no record.`);
|
|
1174
|
+
if (!tool.argumentsResource?.rowIdArgument) {
|
|
1175
|
+
problems.push(`${named} without argumentsResource.rowIdArgument: name the argument holding the id of the row the approval is about.`);
|
|
1176
|
+
}
|
|
1177
|
+
if (fields !== undefined) {
|
|
1178
|
+
if (!Array.isArray(fields) || fields.length === 0 || fields.some((field) => typeof field !== 'string' || field.trim().length === 0)) {
|
|
1179
|
+
problems.push(`${named}, which names no field: list the fields of the row the approval covers.`);
|
|
1180
|
+
} else {
|
|
1181
|
+
const duplicated = fields.filter((field, index) => fields.indexOf(field) !== index);
|
|
1182
|
+
if (duplicated.length > 0) problems.push(`${named}, which names ${[...new Set(duplicated)].join(', ')} more than once.`);
|
|
1183
|
+
const declared = tool.argumentsResource ? declaredFieldsOf?.(tool.argumentsResource.resourceType) : undefined;
|
|
1184
|
+
const unknown = declared ? fields.filter((field) => !declared.includes(field)) : [];
|
|
1185
|
+
if (unknown.length > 0) problems.push(`${named}, naming ${unknown.join(', ')}, which ${tool.argumentsResource!.resourceType} does not declare.`);
|
|
1186
|
+
}
|
|
1187
|
+
}
|
|
1188
|
+
return problems;
|
|
1189
|
+
}
|
|
1190
|
+
|
|
1191
|
+
/** Whether an argument schema is a string once its optional, nullable and default wrappers are removed. */
|
|
1192
|
+
function isStringArgumentSchema(schema: z.ZodTypeAny): boolean {
|
|
1193
|
+
let current: z.ZodTypeAny = schema;
|
|
1194
|
+
for (let depth = 0; depth < 8; depth += 1) {
|
|
1195
|
+
if (current instanceof z.ZodOptional || current instanceof z.ZodNullable || current instanceof z.ZodDefault) {
|
|
1196
|
+
current = current.def.innerType as z.ZodTypeAny;
|
|
1197
|
+
continue;
|
|
1198
|
+
}
|
|
1199
|
+
return current instanceof z.ZodString || (current as { def?: { type?: unknown } }).def?.type === 'string';
|
|
1200
|
+
}
|
|
1201
|
+
return false;
|
|
1202
|
+
}
|
|
764
1203
|
```
|
|
@@ -209,6 +209,15 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
209
209
|
* the people who already may approve. Startup refuses a name a variant uses and no module registers.
|
|
210
210
|
*/
|
|
211
211
|
operationApprovalResolvers?: OperationApprovalResolvers;
|
|
212
|
+
/**
|
|
213
|
+
* How each of the application's OWN external effects is undone (#3446), keyed by its compensation kind. A custom
|
|
214
|
+
* implementation that creates an object at a vendor before its operation's write reserves it first with
|
|
215
|
+
* `reserveExternalEffect(utils, { applicationCompensationKind, … })`; when no row names the object once the operation
|
|
216
|
+
* ended, the engine's settlement calls the compensator declared here. Key it by an enum the application owns
|
|
217
|
+
* (`satisfies Record<MyKind, ApplicationExternalEffectCompensator>`). One module declares a kind: two modules declaring
|
|
218
|
+
* the same kind are refused, naming both. A reservation naming a kind no module declares is refused before the vendor call.
|
|
219
|
+
*/
|
|
220
|
+
externalEffectCompensators?: ApplicationExternalEffectCompensators;
|
|
212
221
|
}
|
|
213
222
|
|
|
214
223
|
/**
|
|
@@ -223,7 +232,7 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
223
232
|
* |---|---|
|
|
224
233
|
* | `resourceConfigurations` | **last module wins, silently** |
|
|
225
234
|
* | `resourceFieldIdentifiers` | **last module wins, silently** |
|
|
226
|
-
* | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` · `operationApprovalResolvers` | rejected, naming both modules |
|
|
235
|
+
* | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` · `operationApprovalResolvers` · `externalEffectCompensators` | rejected, naming both modules |
|
|
227
236
|
* | `resourceRelationships` · `operations` · `controllers` · `seeds` | concatenated — both are kept |
|
|
228
237
|
* | `inboundHandlers` | concatenated; a duplicate `ref` is rejected, naming both modules |
|
|
229
238
|
* | `humanDecisionNoticeHandler` | at most one across every module; a second is rejected, naming both modules |
|
|
@@ -263,9 +272,29 @@ export function mergeBackendDomainModules(
|
|
|
263
272
|
...mergeHumanDecisionNoticeHandler(modules),
|
|
264
273
|
chatReplyHandlers: modules.flatMap(m => m.chatReplyHandlers ?? []),
|
|
265
274
|
operationApprovalResolvers: mergeOperationApprovalResolvers(modules),
|
|
275
|
+
externalEffectCompensators: mergeExternalEffectCompensators(modules),
|
|
266
276
|
};
|
|
267
277
|
}
|
|
268
278
|
|
|
279
|
+
/** Every module's external effect compensators in one record, refusing a kind two modules declare (naming both). */
|
|
280
|
+
function mergeExternalEffectCompensators(modules: BackendDomainModule[]): ApplicationExternalEffectCompensators | undefined {
|
|
281
|
+
const merged: Record<string, ApplicationExternalEffectCompensators[string]> = {};
|
|
282
|
+
const sourceIndexByKind = new Map<string, number>();
|
|
283
|
+
for (let moduleIndex = 0; moduleIndex < modules.length; moduleIndex++) {
|
|
284
|
+
for (const [kind, compensator] of Object.entries(modules[moduleIndex]!.externalEffectCompensators ?? {})) {
|
|
285
|
+
const firstSource = sourceIndexByKind.get(kind);
|
|
286
|
+
if (firstSource !== undefined) {
|
|
287
|
+
throw new Error(
|
|
288
|
+
`mergeBackendDomainModules: duplicate externalEffectCompensators kind '${kind}' — declared by module index ${firstSource} AND module index ${moduleIndex}. A kind is undone one way; pick a unique one.`,
|
|
289
|
+
);
|
|
290
|
+
}
|
|
291
|
+
sourceIndexByKind.set(kind, moduleIndex);
|
|
292
|
+
merged[kind] = compensator;
|
|
293
|
+
}
|
|
294
|
+
}
|
|
295
|
+
return Object.keys(merged).length > 0 ? merged : undefined;
|
|
296
|
+
}
|
|
297
|
+
|
|
269
298
|
/** Every module's operation-approval resolvers in one record, refusing a name two modules register (naming both). */
|
|
270
299
|
function mergeOperationApprovalResolvers(modules: BackendDomainModule[]): OperationApprovalResolvers | undefined {
|
|
271
300
|
const merged: Record<string, OperationApprovalResolvers[string]> = {};
|