@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
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# Reporting what your provider can say about its own state: the compliance-state collector
|
|
2
|
+
|
|
3
|
+
Read this when your provider holds state an auditor would ask about and only your provider can describe: which account
|
|
4
|
+
the application uses at your vendor, whether that account is the vendor's built-in administrator, whether its password
|
|
5
|
+
is the vendor's packaged default, how your client trusts the server. The application's assurance cycle asks every
|
|
6
|
+
declared provider, records the answer in the application's assurance repository, and a demand weighs it. Your module
|
|
7
|
+
only states facts.
|
|
8
|
+
|
|
9
|
+
## What you implement
|
|
10
|
+
|
|
11
|
+
Declare `complianceStateCollectorFactory` on your backend module. The engine hands it your resolved secrets (platform-minted
|
|
12
|
+
slots first, exactly as your audit sink or capability receives them) and, per slot, where the value came from. It returns
|
|
13
|
+
a collector whose `collect()` answers a list of facts, or `undefined` to decline when the connection material is
|
|
14
|
+
incomplete.
|
|
15
|
+
|
|
16
|
+
## Import Origins
|
|
17
|
+
|
|
18
|
+
- `@wildo-ai/external-connectors-private`
|
|
19
|
+
|
|
20
|
+
## Source Excerpts
|
|
21
|
+
|
|
22
|
+
### Origin Package: `@wildo-ai/external-connectors-private`
|
|
23
|
+
|
|
24
|
+
```typescript
|
|
25
|
+
/**
|
|
26
|
+
* Resolved config the engine hands a provider's {@link BackendProviderModule.complianceStateCollectorFactory} (#298):
|
|
27
|
+
* the same secrets the audit sink builder resolves, through the same resolution (`resolveProviderSecrets`), plus where
|
|
28
|
+
* each slot's value came from. The origins are the one fact a collector cannot read off a value: an account the platform
|
|
29
|
+
* minted for this application and one an operator typed look identical as strings.
|
|
30
|
+
*
|
|
31
|
+
* A collector READS these to describe the connection; it must never copy a value into a fact. The fact schema admits
|
|
32
|
+
* vocabulary members and booleans only, and the builder refuses anything else, so a leaked value fails the snapshot
|
|
33
|
+
* rather than reaching the evidence repository.
|
|
34
|
+
*/
|
|
35
|
+
export interface ProviderComplianceStateCollectorConfig {
|
|
36
|
+
readonly secrets: Readonly<Record<string, string>>;
|
|
37
|
+
readonly secretOrigins: Readonly<Record<string, ProviderCredentialOrigin>>;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* A provider's compliance-state collector (#298): asked once per evidence read, it returns the facts the provider can
|
|
42
|
+
* state about its own state. DETERMINISTIC, and never a judgement: what a fact means for an objective is the demand's
|
|
43
|
+
* question, judged elsewhere. It may throw, or return facts the schema refuses; the builder records either as an absence
|
|
44
|
+
* (`COLLECTION_FAILED`), never as a partial snapshot.
|
|
45
|
+
*/
|
|
46
|
+
export interface ProviderComplianceStateCollector {
|
|
47
|
+
collect(): Promise<ReadonlyArray<ProviderComplianceStateFactRecord>>;
|
|
48
|
+
}
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
A fact is `{ fact, value, source }`: `fact` a member of `ProviderComplianceStateFact` (from `@wildo-ai/saas-models`), its
|
|
52
|
+
`value` the type that member fixes (a boolean or a vocabulary member), and `source` where you read it
|
|
53
|
+
(`ProviderComplianceStateSource`). Report each fact at most once.
|
|
54
|
+
|
|
55
|
+
## What the engine guarantees, and what it refuses
|
|
56
|
+
|
|
57
|
+
| Your module | What the application's evidence records |
|
|
58
|
+
|---|---|
|
|
59
|
+
| declares no collector | the provider, ABSENT, `NO_COLLECTOR` |
|
|
60
|
+
| a required secret is not configured | ABSENT, `NOT_CONFIGURED`; your factory is never called |
|
|
61
|
+
| your factory returns `undefined` | ABSENT, `COLLECTOR_DECLINED` |
|
|
62
|
+
| `collect()` throws, or returns anything the schema refuses | ABSENT, `COLLECTION_FAILED` |
|
|
63
|
+
| `collect()` returns valid facts | CAPTURED, with your facts and the instant |
|
|
64
|
+
|
|
65
|
+
The schema admits no free string anywhere in a fact, so a value you read (a password, an account name, a host, a
|
|
66
|
+
database name) can never reach the evidence: report a COMPARISON (`PASSWORD_IS_VENDOR_PACKAGED_DEFAULT: true`), never the
|
|
67
|
+
value. A collector that tries to return one produces no snapshot at all, and the failure is logged by provider, never
|
|
68
|
+
with the value.
|
|
69
|
+
|
|
70
|
+
## How to write a collector
|
|
71
|
+
|
|
72
|
+
- State facts, never a verdict. Whether a built-in administrator account is acceptable is the demand's question; do not
|
|
73
|
+
add a "secure" or "compliant" fact.
|
|
74
|
+
- Deterministic or absent. When you cannot read something, decline or throw; never report a plausible default.
|
|
75
|
+
- Report only facts a demand reads. A new fact needs a member in `ProviderComplianceStateFact` and a demand clause that
|
|
76
|
+
reads it, in the same change.
|
|
77
|
+
- Load no SDK at module load. A collector that asks your vendor's API loads its client inside `collect()`; the module
|
|
78
|
+
stays data plus lazy factories.
|
|
79
|
+
|
|
80
|
+
## Worked shape
|
|
81
|
+
|
|
82
|
+
The engine's immudb provider reads everything off its resolved configuration and asks the server nothing:
|
|
83
|
+
|
|
84
|
+
```ts
|
|
85
|
+
complianceStateCollectorFactory: ({ secrets, secretOrigins }) => {
|
|
86
|
+
if (!secrets.user || !secrets.password) return undefined;
|
|
87
|
+
const source = ProviderComplianceStateSource.RESOLVED_CONFIGURATION;
|
|
88
|
+
return {
|
|
89
|
+
collect: async () => [
|
|
90
|
+
{ fact: ProviderComplianceStateFact.ACCOUNT_IS_VENDOR_BUILT_IN_ADMINISTRATOR, value: secrets.user === 'immudb', source },
|
|
91
|
+
{ fact: ProviderComplianceStateFact.PASSWORD_IS_VENDOR_PACKAGED_DEFAULT, value: secrets.password === 'immudb', source },
|
|
92
|
+
{ fact: ProviderComplianceStateFact.TRUST_ANCHOR_PERSISTENCE, value: secrets.stateDir ? ProviderTrustAnchorPersistence.DURABLE : ProviderTrustAnchorPersistence.EPHEMERAL, source },
|
|
93
|
+
],
|
|
94
|
+
};
|
|
95
|
+
},
|
|
96
|
+
```
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
# Checking how an application configured your provider: the configuration check
|
|
2
|
+
|
|
3
|
+
Read this when your provider has a setting that can be well-formed and still WRONG, and only your provider can tell:
|
|
4
|
+
an account id that must be the account the API key belongs to, a workspace that must be the one the bot token is
|
|
5
|
+
installed in, a region that must match the endpoint the key was issued for. Nothing else refuses such a value, because
|
|
6
|
+
nothing else knows what it should be.
|
|
7
|
+
|
|
8
|
+
## What you implement
|
|
9
|
+
|
|
10
|
+
Declare `configurationCheck` on your backend module: an async function answering one sentence per problem, and an
|
|
11
|
+
empty list when the configuration is right. It is given exactly two things:
|
|
12
|
+
|
|
13
|
+
- `readSecret(envVarName)`: the value of one of YOUR module's declared secret slots, or `undefined` when it has none. A
|
|
14
|
+
name your `secretsContract` does not declare always reads `undefined`.
|
|
15
|
+
- `execute(operationId, input?)`: one of YOUR provider's operations on the APPLICATION's own connection (its own
|
|
16
|
+
account, acting as itself), answering the operation's output and throwing when the call is refused or fails. Call
|
|
17
|
+
only READ operations: a check must change nothing at the vendor.
|
|
18
|
+
|
|
19
|
+
## Import Origins
|
|
20
|
+
|
|
21
|
+
- `@wildo-ai/external-connectors-private`
|
|
22
|
+
|
|
23
|
+
## Source Excerpts
|
|
24
|
+
|
|
25
|
+
### Origin Package: `@wildo-ai/external-connectors-private`
|
|
26
|
+
|
|
27
|
+
```typescript
|
|
28
|
+
/**
|
|
29
|
+
* What a provider's configuration check is given (#2711): the provider's own declared values, and its own operations on
|
|
30
|
+
* the application's own account. Nothing else: a check cannot read another provider's secrets or spend another
|
|
31
|
+
* provider's connection.
|
|
32
|
+
*/
|
|
33
|
+
export interface ProviderConfigurationCheckInput {
|
|
34
|
+
/**
|
|
35
|
+
* The value of one of THIS module's declared secret slots, by its environment variable name (`SLACK_ACCESS_TOKEN`), or
|
|
36
|
+
* `undefined` when it has no value. A name the module's `secretsContract` does not declare always reads `undefined`.
|
|
37
|
+
* The backend reads its own environment; `wildo local doctor` reads the environment's `providerEnv` (a variable set in
|
|
38
|
+
* the shell running doctor takes precedence, so `SLACK_APPLICATION_WORKSPACE_ID=T000WRONG wildo local doctor` tries a
|
|
39
|
+
* value without editing the secrets).
|
|
40
|
+
*/
|
|
41
|
+
readonly readSecret: (envVarName: string) => string | undefined;
|
|
42
|
+
/**
|
|
43
|
+
* Calls one of THIS provider's operations on the APPLICATION's own connection (the floor: its own account, acting as
|
|
44
|
+
* itself) and answers the operation's output. Throws when the call is refused or fails, exactly as an application's
|
|
45
|
+
* call would; the backend records it in the audit trail like any provider call. Call only READ operations: a check must
|
|
46
|
+
* change nothing at the vendor.
|
|
47
|
+
*/
|
|
48
|
+
readonly execute: (operationId: string, input?: Readonly<Record<string, unknown>>) => Promise<unknown>;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* A provider's own check of how an application configured it (#2711): an async function answering one sentence per
|
|
53
|
+
* problem found, and nothing when the configuration is right (or is not set, which is not a problem the check owns).
|
|
54
|
+
*
|
|
55
|
+
* It exists for the mistakes only the provider can see: a value that is well-formed and wrong, which nothing refuses
|
|
56
|
+
* because nothing else knows what it should be. Slack's is the reference case: `SLACK_APPLICATION_WORKSPACE_ID` must
|
|
57
|
+
* name the workspace the application's own bot token is installed in, which only `auth.test` on that token answers.
|
|
58
|
+
*
|
|
59
|
+
* NEVER a refusal, and the engine guarantees it:
|
|
60
|
+
* - the application backend runs every loaded module's check ONCE at boot, in the background, and logs each sentence as a
|
|
61
|
+
* WARN naming the provider; startup neither waits for it nor fails on it;
|
|
62
|
+
* - `wildo local doctor` runs it against the local environment's values and prints a WARN line per provider with a
|
|
63
|
+
* finding (a PASS line when the check found nothing);
|
|
64
|
+
* - a check that THROWS, or does not answer within the engine's deadline, is reported as "could not be run" with the
|
|
65
|
+
* reason, never propagated.
|
|
66
|
+
*
|
|
67
|
+
* So write it to say what is wrong and how to fix it, in one sentence each, naming the setting. A comparison it could not
|
|
68
|
+
* make (the vendor call failed) is a sentence too ("could not be compared, because …"): a check that cannot run must not
|
|
69
|
+
* read as one that passed. Make at most a few READ calls; it runs on every boot.
|
|
70
|
+
*
|
|
71
|
+
* @example
|
|
72
|
+
* ```ts
|
|
73
|
+
* export const AcmeBackendProvider: BackendProviderModule = {
|
|
74
|
+
* // …
|
|
75
|
+
* configurationCheck: async ({ readSecret, execute }) => {
|
|
76
|
+
* const declared = readSecret('ACME_ACCOUNT_ID');
|
|
77
|
+
* if (declared === undefined) return [];
|
|
78
|
+
* const { accountId } = (await execute('whoami')) as { accountId?: string };
|
|
79
|
+
* return accountId === declared ? [] : [`ACME_ACCOUNT_ID is ${declared}, but ACME_API_KEY belongs to account ${accountId}.`];
|
|
80
|
+
* },
|
|
81
|
+
* };
|
|
82
|
+
* ```
|
|
83
|
+
*/
|
|
84
|
+
export type ProviderConfigurationCheck = (input: ProviderConfigurationCheckInput) => Promise<readonly string[]>;
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## When it runs, and what the engine guarantees
|
|
88
|
+
|
|
89
|
+
| Where | When | What a finding becomes |
|
|
90
|
+
|---|---|---|
|
|
91
|
+
| The application backend | Once at boot, in the background: startup does not wait for it | A WARN log line per sentence, `[provider configuration] <ref>: <sentence>` |
|
|
92
|
+
| `wildo local doctor` | Every run, against the local environment's values | A WARN line `provider configuration (<ref>)` carrying the sentences |
|
|
93
|
+
|
|
94
|
+
Never a refusal, in either place. A check that throws, answers something other than a list of sentences, or does not
|
|
95
|
+
answer within 30 seconds is reported as "could not be run", with the reason, and nothing else is affected. A module
|
|
96
|
+
with no check gets no line at all. Minions do not run checks: the backend already asked the same question of the same
|
|
97
|
+
configuration.
|
|
98
|
+
|
|
99
|
+
`wildo local doctor` reads a variable from the shell first, then from the environment's stored secrets, so
|
|
100
|
+
`ACME_ACCOUNT_ID=A2 wildo local doctor` tries a value without changing anything. Every credential is masked out of
|
|
101
|
+
what it prints.
|
|
102
|
+
|
|
103
|
+
## How to write the sentences
|
|
104
|
+
|
|
105
|
+
- Say what is wrong and how to fix it, naming the setting and both values (a non-secret value only).
|
|
106
|
+
- A comparison you could not make is a sentence too ("could not be compared, because the call failed: …"). A check
|
|
107
|
+
that cannot run must not read as one that passed.
|
|
108
|
+
- Return nothing when the setting is not set and that is a legitimate configuration: the check is about values that are
|
|
109
|
+
wrong, not about values that are optional.
|
|
110
|
+
- Keep it to a few calls: it runs on every boot.
|
|
111
|
+
|
|
112
|
+
## Worked shape
|
|
113
|
+
|
|
114
|
+
The registry Slack provider's check: `SLACK_APPLICATION_WORKSPACE_ID` must name the workspace `SLACK_ACCESS_TOKEN` is
|
|
115
|
+
installed in, which only `auth.test` on that token answers.
|
|
116
|
+
|
|
117
|
+
```ts
|
|
118
|
+
configurationCheck: async ({ readSecret, execute }) => {
|
|
119
|
+
const declared = readSecret('SLACK_APPLICATION_WORKSPACE_ID')?.trim() ?? '';
|
|
120
|
+
if (declared === '') return [];
|
|
121
|
+
if (!/^T[A-Z0-9]{2,31}$/.test(declared)) return [`SLACK_APPLICATION_WORKSPACE_ID is "${declared}", which is not a Slack workspace id (T…).`];
|
|
122
|
+
if (readSecret('SLACK_ACCESS_TOKEN') === undefined) return [`SLACK_APPLICATION_WORKSPACE_ID is ${declared}, and SLACK_ACCESS_TOKEN has no value to compare it with.`];
|
|
123
|
+
try {
|
|
124
|
+
const { team_id } = (await execute('auth.test', {})) as { team_id?: string };
|
|
125
|
+
return team_id === declared ? [] : [`SLACK_APPLICATION_WORKSPACE_ID is ${declared}, but SLACK_ACCESS_TOKEN is installed in ${team_id}. Set it to ${team_id}.`];
|
|
126
|
+
} catch (error) {
|
|
127
|
+
return [`SLACK_APPLICATION_WORKSPACE_ID could not be compared: auth.test failed (${error instanceof Error ? error.message : String(error)}).`];
|
|
128
|
+
}
|
|
129
|
+
},
|
|
130
|
+
```
|
|
@@ -84,6 +84,12 @@ export enum ProviderFileStorageFailureKind {
|
|
|
84
84
|
INVALID_REFERENCE = 'INVALID_REFERENCE',
|
|
85
85
|
/** The vendor failed or could not be reached. */
|
|
86
86
|
VENDOR_FAILURE = 'VENDOR_FAILURE',
|
|
87
|
+
/**
|
|
88
|
+
* The vendor's hash of the stored file differs from the hash of the bytes the adapter sent (#2965). The adapter removes
|
|
89
|
+
* its copy at the vendor before throwing and says in the message whether that worked: a mismatched copy is the
|
|
90
|
+
* adapter's own upload, never the owner's document. The engine refuses it as `FileIntegrityErrorCode.CONTENT_CHECKSUM_MISMATCH`.
|
|
91
|
+
*/
|
|
92
|
+
CONTENT_CHECKSUM_MISMATCH = 'CONTENT_CHECKSUM_MISMATCH',
|
|
87
93
|
}
|
|
88
94
|
|
|
89
95
|
/**
|
|
@@ -139,7 +145,8 @@ export interface ProviderFileStorageUploadRequest {
|
|
|
139
145
|
readonly body: AsyncIterable<Uint8Array>;
|
|
140
146
|
/**
|
|
141
147
|
* SHA-256 of `body`, lowercase hex, when the engine computed it before uploading (#2900). An adapter whose vendor
|
|
142
|
-
* reports a hash of the stored bytes
|
|
148
|
+
* reports a hash of the stored bytes compares it (the hash itself, or a vendor hash of the bytes it hashed and sent)
|
|
149
|
+
* and throws `CONTENT_CHECKSUM_MISMATCH` on a mismatch, as the engine's `ONEDRIVE` adapter does (#2965). The engine
|
|
143
150
|
* checks the bytes it streamed to the adapter against this hash either way.
|
|
144
151
|
*/
|
|
145
152
|
readonly contentSha256?: string;
|
|
@@ -13,6 +13,23 @@ implements, the engine verifies every request itself and your package supplies n
|
|
|
13
13
|
| Svix / Standard Webhooks senders | `SVIX_V1` | the `whsec_` signing secret |
|
|
14
14
|
| Slack (events, interactions, slash commands) | `SLACK_V0` | the Slack app's signing secret |
|
|
15
15
|
| Microsoft Teams and other Azure Bot Service channels | `BOT_FRAMEWORK_JWT` | the bot's Microsoft App ID (the token's audience) |
|
|
16
|
+
| Telnyx, Discord interactions (an Ed25519 signature) | `ED25519` | the vendor's PUBLIC key, 32 bytes in base64 or hex (not a secret: the vendor publishes it) |
|
|
17
|
+
| A vendor that signs nothing and sends HTTP Basic credentials from its webhook URL (Postmark's inbound webhook) | `BASIC_CREDENTIAL` | the `user-id:password` the operator writes into the webhook URL; one that is empty or not `user-id:password` refuses every request |
|
|
18
|
+
| Mailgun routes forwarding to a URL ending in `json` (inbound email) | `MAILGUN_FORWARD_JSON` | the account's webhook signing key (not the API key); a subaccount's parent signature is admitted when the slot holds the primary account's key |
|
|
19
|
+
|
|
20
|
+
`ED25519` is the one scheme whose construction varies by vendor, so its `signatureConfig` names it and the route is
|
|
21
|
+
not mounted without all three: `headerName` (the signature header), `timestampHeader`, and `signedContentSeparator`,
|
|
22
|
+
the text between the timestamp and the body in what the vendor signs. Telnyx: `telnyx-signature-ed25519`,
|
|
23
|
+
`telnyx-timestamp`, `'|'`. Discord: `x-signature-ed25519`, `x-signature-timestamp`, `''`. The signed timestamp must be
|
|
24
|
+
within five minutes of now.
|
|
25
|
+
|
|
26
|
+
`MAILGUN_FORWARD_JSON` reads Mailgun's own headers (`X-Mailgun-Signature`, `X-Mailgun-Timestamp`,
|
|
27
|
+
`X-Mailgun-Parent-Signature`), so the endpoint declares nothing beyond the algorithm. A timestamp may be nine hours old, because
|
|
28
|
+
Mailgun retries for eight, and five minutes ahead. A forward URL not ending in `json` posts a form the engine does not verify, refused `415`:
|
|
29
|
+
the endpoint key itself ends in `json` (`inbound-email-json`) so the URL the operator copies is the right one.
|
|
30
|
+
|
|
31
|
+
`BASIC_CREDENTIAL` signs neither the body nor a time: it proves who sent the request, not what it carries. Use it
|
|
32
|
+
only for a vendor that offers nothing stronger, and tell the operator to generate a long random password.
|
|
16
33
|
|
|
17
34
|
Declare the secret in your `secretsContract` and name it as the protocol's `secretRef`. An unset value refuses
|
|
18
35
|
every request; a signature, token or timestamp that does not verify answers `401` and is audited. Any other
|
|
@@ -149,10 +166,10 @@ export function reReadTriggerLimitsAreSound(trigger: Pick<Hook_ReReadTrigger, 'c
|
|
|
149
166
|
and a user id), as a Slack event, click or command and a Teams activity do. Only such an endpoint's handler may act
|
|
150
167
|
as the member that chat account is linked to (`ctx.chat`); every other handler is refused. Honored only on a scheme
|
|
151
168
|
the engine verifies itself (`HOOK_ENGINE_VERIFIED_SIGNATURE_ALGORITHMS`: `SLACK_V0`, `BOT_FRAMEWORK_JWT`,
|
|
152
|
-
`SVIX_V1`). Never declare it for a vendor whose "sender" its signature does not vouch for, such as an email's From.
|
|
169
|
+
`SVIX_V1`, `ED25519`, `BASIC_CREDENTIAL`, `MAILGUN_FORWARD_JSON`). Never declare it for a vendor whose "sender" its signature does not vouch for, such as an email's From.
|
|
153
170
|
- `answerHandshake` — for a vendor that proves the URL with a challenge (Slack's `url_verification`): return the
|
|
154
171
|
answer for a handshake, `null` otherwise. A handshake is answered and never stored.
|
|
155
|
-
- `identifyEvent` — REQUIRED for `SLACK_V0` and `
|
|
172
|
+
- `identifyEvent` — REQUIRED for `SLACK_V0`, `BOT_FRAMEWORK_JWT`, `ED25519`, `BASIC_CREDENTIAL` and `MAILGUN_FORWARD_JSON`, whose schemes sign no delivery id: return the
|
|
156
173
|
vendor's event id (`event_id`, `trigger_id`, the activity `id`) and its type, or `null` for a request that
|
|
157
174
|
carries no event. The id is what the store deduplicates retries on. Without it, the route is not mounted.
|
|
158
175
|
- `acknowledge` — the answer the vendor requires within its deadline, replacing the engine's `{ received: true }`
|
|
@@ -240,6 +257,90 @@ export enum Hook_SignatureAlgorithm {
|
|
|
240
257
|
* numbered token requirements.
|
|
241
258
|
*/
|
|
242
259
|
BOT_FRAMEWORK_JWT = "bot-framework-jwt",
|
|
260
|
+
/**
|
|
261
|
+
* An Ed25519 signature over `{timestamp}{signedContentSeparator}{raw body}`, verified by the ENGINE (#3393) against
|
|
262
|
+
* the vendor's PUBLIC key, for vendors that sign asymmetrically: Telnyx and Discord interactions. The endpoint's
|
|
263
|
+
* secret resolves to that public key, which is not a secret (both vendors publish it in their portal), as 32 raw
|
|
264
|
+
* bytes in hex (Discord) or base64 (Telnyx). The signature header carries 64 bytes in hex or base64, told apart by
|
|
265
|
+
* length. The vendors differ in their header names and in the text between the timestamp and the body, so this
|
|
266
|
+
* scheme reads them from the declaration, and refuses one that omits any of them: `headerName` (the signature),
|
|
267
|
+
* `timestampHeader`, and `signedContentSeparator` (`|` for Telnyx, the empty string for Discord). A mis-declared
|
|
268
|
+
* separator or header can only refuse a genuine request, never admit a forged one: the check is the vendor's key.
|
|
269
|
+
* The signed timestamp must fall within five minutes of now. Neither vendor signs a delivery id, so the endpoint
|
|
270
|
+
* names its events with `identifyEvent`.
|
|
271
|
+
*
|
|
272
|
+
* spec-cite: https://www.rubydoc.info/gems/telnyx/Telnyx/Lib/WebhookVerification — Telnyx's own SDK:
|
|
273
|
+
* `telnyx-signature-ed25519` / `telnyx-timestamp` headers, `signed_payload = "#{timestamp}|#{payload}"`, a
|
|
274
|
+
* strict-base64 signature, a "Base64-encoded raw 32-byte Ed25519 public key", `DEFAULT_TOLERANCE = 300` seconds.
|
|
275
|
+
* spec-cite: https://docs.discord.com/developers/interactions/overview — "Security and Authorization":
|
|
276
|
+
* `X-Signature-Ed25519` / `X-Signature-Timestamp`, the examples' `timestamp + body` with no separator, the
|
|
277
|
+
* signature and the public key decoded from hex.
|
|
278
|
+
*/
|
|
279
|
+
ED25519 = "ed25519",
|
|
280
|
+
/**
|
|
281
|
+
* HTTP Basic credentials, verified by the ENGINE (#3395), for a vendor that signs nothing and authenticates its
|
|
282
|
+
* webhook only with the credentials an operator writes into the webhook URL: Postmark's inbound webhook. The
|
|
283
|
+
* endpoint's secret resolves to `user-id:password`, and the request must carry `Authorization: Basic <base64 of
|
|
284
|
+
* those bytes>`, compared in constant time. An empty secret, or one that is not `user-id:password` with both parts
|
|
285
|
+
* present, refuses every request, so a delivery is never accepted unauthenticated. The credential travels in every
|
|
286
|
+
* request and signs neither the body nor a timestamp: it proves who sent the request, not what it carries, so it is
|
|
287
|
+
* worth what the TLS protecting it is worth. Nothing names a delivery, so the endpoint names its events with
|
|
288
|
+
* `identifyEvent`.
|
|
289
|
+
*
|
|
290
|
+
* spec-cite: https://postmarkapp.com/developer/user-guide/inbound/configure-an-inbound-server (fetched 2026-11-09)
|
|
291
|
+
* — "we support HTTP Basic authentication", the credentials given in the webhook URL.
|
|
292
|
+
* spec-cite: RFC 7617 §2 — the user-pass is the user-id, a single colon and the password, Base64-encoded
|
|
293
|
+
* (RFC 4648 §4) in the `token68` credentials of the `Basic` scheme; "a user-id containing a colon character is
|
|
294
|
+
* invalid".
|
|
295
|
+
*/
|
|
296
|
+
BASIC_CREDENTIAL = "basic-credential",
|
|
297
|
+
/**
|
|
298
|
+
* A Mailgun route's JSON forward, verified by the ENGINE (#3395): a route whose `forward()` URL ends in `json` posts
|
|
299
|
+
* the parsed message as one JSON document and carries the signature in headers. It is the hex HMAC-SHA256, keyed
|
|
300
|
+
* with the account's webhook signing key, of `{X-Mailgun-Timestamp}{raw body}` (Mailgun's `timestamp + token`, with
|
|
301
|
+
* the whole body in place of the token), in `X-Mailgun-Signature`; a subaccount's domain also carries
|
|
302
|
+
* `X-Mailgun-Parent-Signature`, the same HMAC under the primary account's key, and either may match the key in the
|
|
303
|
+
* slot. The signed timestamp may be at most nine hours old, which covers Mailgun's eight hours of retries, and five
|
|
304
|
+
* minutes ahead. The
|
|
305
|
+
* header names are Mailgun's, so the endpoint declares nothing beyond the algorithm. Mailgun signs no delivery id, so
|
|
306
|
+
* the endpoint names its events with `identifyEvent`.
|
|
307
|
+
*
|
|
308
|
+
* A forward URL not ending in `json` posts a form (urlencoded, or multipart with attachments) with the signature in
|
|
309
|
+
* body fields; the engine neither decodes that body nor verifies that signature, so such a route is refused (415).
|
|
310
|
+
*
|
|
311
|
+
* spec-cite: https://documentation.mailgun.com/docs/mailgun/user-manual/receive-forward-store/receive-http (fetched
|
|
312
|
+
* 2026-11-09) — the destination-URL table, and "JSON Payload Format" › "Signature verification".
|
|
313
|
+
* spec-cite: https://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/securing-webhooks (fetched
|
|
314
|
+
* 2026-11-09) — the signature as hex HMAC-SHA256 of `timestamp + token`, and `parent-signature`.
|
|
315
|
+
*/
|
|
316
|
+
MAILGUN_FORWARD_JSON = "mailgun-forward-json",
|
|
317
|
+
/**
|
|
318
|
+
* Twilio's request signature (#3394), verified by the ENGINE: the base64 HMAC-SHA1, keyed with the account's auth
|
|
319
|
+
* token, of the full URL Twilio called (scheme to query string) followed by every POST parameter, sorted by name,
|
|
320
|
+
* each written as its name then its value with no delimiter. A parameter sent more than once contributes each of
|
|
321
|
+
* its distinct values, sorted, after its name. The signature is carried in the declared `headerName`
|
|
322
|
+
* (`x-twilio-signature`).
|
|
323
|
+
*
|
|
324
|
+
* The URL is part of what is signed, so the engine composes it from the application's public API URL
|
|
325
|
+
* (`runtime.endPoints[MAIN_BACKEND_API].publicUrl`) and the path and query string the request arrived on, and tries
|
|
326
|
+
* it with and without an explicit default port, as Twilio's own helper does. No public URL configured, every request
|
|
327
|
+
* is refused. The endpoint's secret resolves to the auth token, or to the `accountId:secret` bundle the SMS arm reads
|
|
328
|
+
* (`SmsProviderCredentialShape.ACCOUNT_ID_AND_SECRET`), whose secret half IS the auth token: one value, never a copy
|
|
329
|
+
* that can drift from it. Form bodies only: Twilio signs a JSON body through a `bodySHA256` query parameter, which
|
|
330
|
+
* this scheme refuses rather than half-checks.
|
|
331
|
+
*
|
|
332
|
+
* Twilio signs no timestamp and no delivery id, so a captured request stays valid: the endpoint names its event
|
|
333
|
+
* (`identifyEvent`), and the inbound ledger stores one delivery per event, so a replay is stored once and runs nothing.
|
|
334
|
+
*
|
|
335
|
+
* spec-cite: https://www.twilio.com/docs/usage/security (fetched 2026-11-09) — "Validating requests are coming from
|
|
336
|
+
* Twilio": the full URL "from the protocol (https...)" through the query string; POST parameters sorted "using
|
|
337
|
+
* Unix-style case-sensitive sorting order"; "append the variable name and value (with no delimiters)"; HMAC-SHA1
|
|
338
|
+
* with the AuthToken; Base64; and SMS over HTTP(S) keeps the port.
|
|
339
|
+
* spec-cite: https://github.com/twilio/twilio-node/blob/main/src/webhooks/webhooks.ts (fetched 2026-11-09) —
|
|
340
|
+
* `getExpectedTwilioSignature` (keys sorted, `toFormUrlEncodedParam` appends each de-duplicated, sorted array value
|
|
341
|
+
* after its name) and `validateRequest` (the URL tried with the port removed and added).
|
|
342
|
+
*/
|
|
343
|
+
TWILIO_HMAC_SHA1 = "twilio-hmac-sha1",
|
|
243
344
|
}
|
|
244
345
|
|
|
245
346
|
/**
|
|
@@ -251,7 +352,27 @@ export const HOOK_ENGINE_VERIFIED_SIGNATURE_ALGORITHMS: ReadonlySet<Hook_Signatu
|
|
|
251
352
|
Hook_SignatureAlgorithm.SVIX_V1,
|
|
252
353
|
Hook_SignatureAlgorithm.SLACK_V0,
|
|
253
354
|
Hook_SignatureAlgorithm.BOT_FRAMEWORK_JWT,
|
|
355
|
+
Hook_SignatureAlgorithm.ED25519,
|
|
356
|
+
Hook_SignatureAlgorithm.BASIC_CREDENTIAL,
|
|
357
|
+
Hook_SignatureAlgorithm.MAILGUN_FORWARD_JSON,
|
|
358
|
+
Hook_SignatureAlgorithm.TWILIO_HMAC_SHA1,
|
|
254
359
|
]);
|
|
360
|
+
|
|
361
|
+
/**
|
|
362
|
+
* Whether an endpoint's signature declaration names everything its scheme reads from it. `ED25519` reads more
|
|
363
|
+
* than its algorithm (#3393): the signature header, the timestamp header (never optional: an unsigned or absent
|
|
364
|
+
* timestamp leaves a captured request replayable for ever) and the separator. `TWILIO_HMAC_SHA1` reads its signature
|
|
365
|
+
* header (#3394). The engine withholds the route of an incomplete declaration, and refuses a request reaching one,
|
|
366
|
+
* rather than guessing a vendor's construction.
|
|
367
|
+
*/
|
|
368
|
+
export function hookSignatureDeclarationIsComplete(config: Pick<Hook_SignatureConfig, 'algorithm' | 'headerName' | 'timestampHeader' | 'signedContentSeparator'>): boolean {
|
|
369
|
+
// TWILIO_HMAC_SHA1 (#3394) reads its signature from the declared header, so an empty one could only refuse.
|
|
370
|
+
if (config.algorithm === Hook_SignatureAlgorithm.TWILIO_HMAC_SHA1) return typeof config.headerName === 'string' && config.headerName.length > 0;
|
|
371
|
+
if (config.algorithm !== Hook_SignatureAlgorithm.ED25519) return true;
|
|
372
|
+
return typeof config.headerName === 'string' && config.headerName.length > 0
|
|
373
|
+
&& typeof config.timestampHeader === 'string' && config.timestampHeader.length > 0
|
|
374
|
+
&& typeof config.signedContentSeparator === 'string';
|
|
375
|
+
}
|
|
255
376
|
```
|
|
256
377
|
|
|
257
378
|
## Import Origins
|
|
@@ -627,7 +748,7 @@ endpoints: [{
|
|
|
627
748
|
```
|
|
628
749
|
|
|
629
750
|
An engine scheme reads its own headers (`x-slack-signature` and `x-slack-request-timestamp`, `authorization`, the
|
|
630
|
-
`svix-*` set) and ignores `signatureHeaderName`. The protocol contract still requires it, so set it to the scheme's
|
|
751
|
+
`svix-*` set, or for `ED25519` the ones its `signatureConfig` names) and ignores `signatureHeaderName`. The protocol contract still requires it, so set it to the scheme's
|
|
631
752
|
signature header, which is what a reader of the configuration expects to find there.
|
|
632
753
|
|
|
633
754
|
`capability` names one of the provider's own `providerCapabilities`. An endpoint an inbound handler takes is
|
|
@@ -85,6 +85,76 @@ export enum ProviderOAuth2PkceSupport {
|
|
|
85
85
|
NOT_ACCEPTED = 'NOT_ACCEPTED',
|
|
86
86
|
}
|
|
87
87
|
|
|
88
|
+
/**
|
|
89
|
+
* How this application's client authenticates to a vendor's token and revocation endpoints. See
|
|
90
|
+
* {@link ProviderRestOAuth2.tokenEndpointAuthMethod}.
|
|
91
|
+
*
|
|
92
|
+
* The values are the names the "OAuth Token Endpoint Authentication Methods" registry gives these two methods, which
|
|
93
|
+
* is what OpenID Connect and dynamic client registration call `token_endpoint_auth_method`, so a vendor's discovery
|
|
94
|
+
* document (`token_endpoint_auth_methods_supported`) can be compared with a declaration by eye.
|
|
95
|
+
* spec-cite: RFC 7591 §2 — `token_endpoint_auth_method`: "client_secret_post": "The client uses the HTTP POST parameters
|
|
96
|
+
* as defined in OAuth 2.0, Section 2.3.1."; "client_secret_basic": "The client uses HTTP Basic as defined in OAuth 2.0,
|
|
97
|
+
* Section 2.3.1." Fetched 2026-11-06.
|
|
98
|
+
*
|
|
99
|
+
* Narrower than `OAuth2_TokenEndpoint_AuthMethod` on purpose: that vocabulary also names `client_secret_jwt` and
|
|
100
|
+
* `none`, which nothing here performs. `private_key_jwt` joined with #3402, performed by the client-credentials grant
|
|
101
|
+
* only; the connected-account exchange refuses it at startup. A member nothing honours would
|
|
102
|
+
* be a declaration that looks like a client-authentication choice and changes nothing, so each method joins this
|
|
103
|
+
* vocabulary in the change that implements it.
|
|
104
|
+
*/
|
|
105
|
+
export enum ProviderOAuth2ClientAuthenticationMethod {
|
|
106
|
+
/**
|
|
107
|
+
* `client_id` and `client_secret` as parameters of the request body: the engine's behaviour when nothing is declared,
|
|
108
|
+
* and what most vendors' own documentation shows. RFC 6749 calls it "NOT RECOMMENDED", which is why a vendor that
|
|
109
|
+
* documents Basic declares {@link CLIENT_SECRET_BASIC} rather than being met with this.
|
|
110
|
+
* spec-cite: RFC 6749 §2.3.1 — sending the two parameters in the body "is NOT RECOMMENDED and SHOULD be limited to
|
|
111
|
+
* clients unable to directly utilize the HTTP Basic authentication scheme". Fetched 2026-11-06.
|
|
112
|
+
*/
|
|
113
|
+
CLIENT_SECRET_POST = 'client_secret_post',
|
|
114
|
+
/**
|
|
115
|
+
* `Authorization: Basic base64(client_id ":" client_secret)`, each half form-urlencoded BEFORE base64, and neither in
|
|
116
|
+
* the body: one credential on one channel. Every authorization server must accept it (Zoom, Notion and Intuit document
|
|
117
|
+
* it as their client authentication).
|
|
118
|
+
* spec-cite: RFC 6749 §2.3.1 — "The client identifier is encoded using the "application/x-www-form-urlencoded"
|
|
119
|
+
* encoding algorithm per Appendix B", and so is the password, before both become the Basic user-id and password; "The
|
|
120
|
+
* authorization server MUST support the HTTP Basic authentication scheme". Appendix B encodes UTF-8 first, so `£` is
|
|
121
|
+
* `%C2%A3` and a space is `+`. Fetched 2026-11-06.
|
|
122
|
+
*/
|
|
123
|
+
CLIENT_SECRET_BASIC = 'client_secret_basic',
|
|
124
|
+
/**
|
|
125
|
+
* A JWT the client signs with its own private key, sent as `client_assertion` (#3402). Performed by the
|
|
126
|
+
* client-credentials grant only ({@link ProviderRestClientCredentials.privateKeyJwt}); the connected-account exchange
|
|
127
|
+
* does not sign assertions, so `oauth2.tokenEndpointAuthMethod` refuses it at startup.
|
|
128
|
+
* spec-cite: OpenID Connect Core 1.0 §9 — `private_key_jwt`: "Clients that have registered a public key sign a JWT
|
|
129
|
+
* using that key." Fetched 2026-11-09 from https://openid.net/specs/openid-connect-core-1_0.html.
|
|
130
|
+
*/
|
|
131
|
+
PRIVATE_KEY_JWT = 'private_key_jwt',
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* How the parameters of a request to a vendor's token or revocation endpoint are written in its body. See
|
|
136
|
+
* {@link ProviderRestOAuth2.tokenRequestBodyEncoding} and {@link ProviderRestOAuth2.revocationRequestBodyEncoding}.
|
|
137
|
+
*
|
|
138
|
+
* The parameters are the same in both encodings (`grant_type`, `code`, `refresh_token`, `token`, …); only their
|
|
139
|
+
* serialization and the `Content-Type` change.
|
|
140
|
+
*/
|
|
141
|
+
export enum ProviderOAuth2RequestBodyEncoding {
|
|
142
|
+
/**
|
|
143
|
+
* `application/x-www-form-urlencoded`, which RFC 6749 and RFC 7009 specify: the default for both requests.
|
|
144
|
+
* spec-cite: RFC 6749 §4.1.3 (the client makes the token request "by sending the following parameters using the
|
|
145
|
+
* "application/x-www-form-urlencoded" format"; §6 does the same for a refresh), and RFC 7009 §2.1 (the revocation
|
|
146
|
+
* request uses "the "application/x-www-form-urlencoded" format in the HTTP request entity-body"). Fetched 2026-11-06.
|
|
147
|
+
*/
|
|
148
|
+
FORM = 'FORM',
|
|
149
|
+
/**
|
|
150
|
+
* `application/json`, an object whose members are the same parameters as string values. A deviation some vendors
|
|
151
|
+
* document: Notion's token endpoint takes only JSON, and Intuit's own client library revokes with a JSON body.
|
|
152
|
+
* spec-cite: https://developers.notion.com/docs/authorization — the token request's `Content-Type: application/json`,
|
|
153
|
+
* fetched 2026-11-06.
|
|
154
|
+
*/
|
|
155
|
+
JSON = 'JSON',
|
|
156
|
+
}
|
|
157
|
+
|
|
88
158
|
/**
|
|
89
159
|
* A `scope` list encoding that deviates from RFC 6749's space-delimited list, in either direction: the token answer
|
|
90
160
|
* ({@link ProviderRestOAuth2.grantedScopesDelimiter}) or the authorize request ({@link ProviderRestOAuth2.authorizeScopesDelimiter}).
|
|
@@ -102,6 +172,101 @@ export enum ProviderOAuth2ScopeListDelimiter {
|
|
|
102
172
|
COMMA = 'COMMA',
|
|
103
173
|
}
|
|
104
174
|
|
|
175
|
+
/**
|
|
176
|
+
* What makes a client-authentication declaration unusable (see {@link ProviderRestOAuth2.tokenEndpointAuthMethod}):
|
|
177
|
+
*
|
|
178
|
+
* - a method or an encoding outside its vocabulary. The request builder tests for the declared member, so an unknown
|
|
179
|
+
* value (a misspelling in a module written without types) would silently fall back to the default and send the
|
|
180
|
+
* secret the way the vendor said not to;
|
|
181
|
+
* - a revocation encoding with no revocation URL, a setting that changes nothing.
|
|
182
|
+
*/
|
|
183
|
+
export function describeProviderOAuth2ClientAuthenticationDefects(
|
|
184
|
+
oauth2: Pick<ProviderRestOAuth2, 'tokenEndpointAuthMethod' | 'tokenRequestBodyEncoding' | 'revocationRequestBodyEncoding' | 'rfc7009RevocationUrl'>,
|
|
185
|
+
): string[] {
|
|
186
|
+
const defects: string[] = [];
|
|
187
|
+
// The exchange signs no assertion: a key-based client (#3402) authenticates only on the client-credentials grant.
|
|
188
|
+
const methods: readonly string[] = [ProviderOAuth2ClientAuthenticationMethod.CLIENT_SECRET_POST, ProviderOAuth2ClientAuthenticationMethod.CLIENT_SECRET_BASIC];
|
|
189
|
+
const encodings: readonly string[] = Object.values(ProviderOAuth2RequestBodyEncoding);
|
|
190
|
+
if (oauth2.tokenEndpointAuthMethod !== undefined && !methods.includes(oauth2.tokenEndpointAuthMethod)) {
|
|
191
|
+
defects.push(`declares tokenEndpointAuthMethod ${JSON.stringify(oauth2.tokenEndpointAuthMethod)}, which is none of ${methods.join(', ')}`);
|
|
192
|
+
}
|
|
193
|
+
for (const [field, value] of [['tokenRequestBodyEncoding', oauth2.tokenRequestBodyEncoding], ['revocationRequestBodyEncoding', oauth2.revocationRequestBodyEncoding]] as const) {
|
|
194
|
+
if (value !== undefined && !encodings.includes(value)) defects.push(`declares ${field} ${JSON.stringify(value)}, which is none of ${encodings.join(', ')}`);
|
|
195
|
+
}
|
|
196
|
+
if (oauth2.revocationRequestBodyEncoding !== undefined && oauth2.rfc7009RevocationUrl === undefined) {
|
|
197
|
+
defects.push('declares revocationRequestBodyEncoding without rfc7009RevocationUrl, so no revocation request uses it');
|
|
198
|
+
}
|
|
199
|
+
return defects;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/** A refresh refusal the vendor documents as a dead refresh token. See {@link ProviderRestOAuth2.refreshRefusals}. */
|
|
203
|
+
export interface ProviderOAuth2RefreshRefusal {
|
|
204
|
+
/** The OAuth2 `error` code of the refusal. */
|
|
205
|
+
readonly error: string;
|
|
206
|
+
/** The `error_description` the refusal must carry, exactly, when the code alone is not specific to a dead token. */
|
|
207
|
+
readonly errorDescription?: string;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* The parameter names the token request writes itself, which {@link ProviderRestOAuth2.codeExchangeParameters} may not
|
|
212
|
+
* name: the exchange's own parameters (RFC 6749 §4.1.3), the client's credentials (§2.3.1) and assertion (RFC 7523 §2.2),
|
|
213
|
+
* and the refresh's (§6). A declared value for one of them would change what the request IS.
|
|
214
|
+
* semantic-literal-boundary: OAuth2 wire parameter names, as RFC 6749 and RFC 7523 spell them.
|
|
215
|
+
*/
|
|
216
|
+
const PROVIDER_OAUTH2_ENGINE_WRITTEN_TOKEN_PARAMETERS: ReadonlySet<string> = new Set([
|
|
217
|
+
'grant_type', 'code', 'redirect_uri', 'code_verifier', 'client_id', 'client_secret', 'client_assertion', 'client_assertion_type', 'refresh_token', 'scope',
|
|
218
|
+
]);
|
|
219
|
+
|
|
220
|
+
/** An OAuth2 error code's shape (RFC 6749 §5.2: `error` values are `%x20-21 / %x23-5B / %x5D-7E`, no space in practice). */
|
|
221
|
+
const PROVIDER_OAUTH2_ERROR_CODE_SHAPE = /^[A-Za-z0-9_.:-]{1,128}$/;
|
|
222
|
+
/** A token-request parameter name a declaration may add: a plain identifier, so it cannot smuggle structure into a body. */
|
|
223
|
+
const PROVIDER_OAUTH2_EXTRA_PARAMETER_NAME = /^[A-Za-z][A-Za-z0-9_.-]{0,63}$/;
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* What makes a token-request declaration unusable (follow-up to #3392), checked where the provider registry composes:
|
|
227
|
+
*
|
|
228
|
+
* - a {@link ProviderRestOAuth2.codeExchangeParameters} name that is not a plain identifier, that names a parameter the
|
|
229
|
+
* engine writes itself, or whose value is empty;
|
|
230
|
+
* - a {@link ProviderRestOAuth2.refreshRefusals} entry whose code is not code-shaped (it would never match), is
|
|
231
|
+
* `invalid_grant` (already a refusal, so the entry says nothing) or `invalid_client` (the application's registration,
|
|
232
|
+
* never one person's grant), or whose description is empty.
|
|
233
|
+
*/
|
|
234
|
+
export function describeProviderOAuth2TokenRequestDefects(
|
|
235
|
+
oauth2: Pick<ProviderRestOAuth2, 'codeExchangeParameters' | 'refreshRefusals'>,
|
|
236
|
+
): string[] {
|
|
237
|
+
const defects: string[] = [];
|
|
238
|
+
for (const [name, value] of Object.entries(oauth2.codeExchangeParameters ?? {})) {
|
|
239
|
+
if (!PROVIDER_OAUTH2_EXTRA_PARAMETER_NAME.test(name)) defects.push(`declares the code-exchange parameter ${JSON.stringify(name)}, which is not a plain parameter name`);
|
|
240
|
+
else if (PROVIDER_OAUTH2_ENGINE_WRITTEN_TOKEN_PARAMETERS.has(name)) defects.push(`declares the code-exchange parameter '${name}', which the engine writes itself`);
|
|
241
|
+
if (typeof value !== 'string' || value.length === 0) defects.push(`declares the code-exchange parameter ${JSON.stringify(name)} with no value`);
|
|
242
|
+
}
|
|
243
|
+
for (const refusal of oauth2.refreshRefusals ?? []) {
|
|
244
|
+
if (typeof refusal.error !== 'string' || !PROVIDER_OAUTH2_ERROR_CODE_SHAPE.test(refusal.error)) {
|
|
245
|
+
defects.push(`declares the refresh refusal ${JSON.stringify(refusal.error)}, which is not an OAuth2 error code and would never match`);
|
|
246
|
+
} else if (refusal.error === 'invalid_grant') {
|
|
247
|
+
defects.push('declares the refresh refusal \'invalid_grant\', which already retires a connection');
|
|
248
|
+
} else if (refusal.error === 'invalid_client') {
|
|
249
|
+
defects.push('declares the refresh refusal \'invalid_client\', which names the application\'s registration, not a person\'s grant');
|
|
250
|
+
}
|
|
251
|
+
if (refusal.errorDescription !== undefined && refusal.errorDescription.trim().length === 0) {
|
|
252
|
+
defects.push(`declares the refresh refusal '${refusal.error}' with an empty errorDescription`);
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
return defects;
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/**
|
|
259
|
+
* Whether a refresh's refusal is one the provider declares as a dead refresh token ({@link ProviderRestOAuth2.refreshRefusals}).
|
|
260
|
+
* The one reading, shared by the refresh and its tests.
|
|
261
|
+
*/
|
|
262
|
+
export function providerOAuth2RefreshRefusalIsDeclared(
|
|
263
|
+
oauth2: Pick<ProviderRestOAuth2, 'refreshRefusals'>,
|
|
264
|
+
answer: { readonly error: string; readonly errorDescription?: string },
|
|
265
|
+
): boolean {
|
|
266
|
+
return (oauth2.refreshRefusals ?? []).some((refusal) => refusal.error === answer.error
|
|
267
|
+
&& (refusal.errorDescription === undefined || refusal.errorDescription === answer.errorDescription));
|
|
268
|
+
}
|
|
269
|
+
|
|
105
270
|
/**
|
|
106
271
|
* The granted scopes a token answer's `scope` string names, read with the vendor's declared delimiter: whitespace (RFC
|
|
107
272
|
* 6749 §5.1) when none is declared, a comma for {@link ProviderOAuth2ScopeListDelimiter.COMMA}.
|
package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md
CHANGED
|
@@ -44,6 +44,12 @@ export interface BackendProviderResolutionRequest {
|
|
|
44
44
|
* package without publishing one; production passes nothing.
|
|
45
45
|
*/
|
|
46
46
|
readonly importModule?: (specifier: string) => Promise<unknown>;
|
|
47
|
+
/**
|
|
48
|
+
* The deployment environment a bound module's region answers are compared with (#3513): a deployment slot naming a
|
|
49
|
+
* different region for the application's own account than the one it declares refuses the provider. Overridable for a
|
|
50
|
+
* test; production passes nothing and `process.env` is read.
|
|
51
|
+
*/
|
|
52
|
+
readonly env?: Readonly<Record<string, string | undefined>>;
|
|
47
53
|
}
|
|
48
54
|
|
|
49
55
|
export interface BackendProviderResolution {
|