@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,87 @@
|
|
|
1
|
+
# Translation glossary (source)
|
|
2
|
+
|
|
3
|
+
Read this when a translated word must not change between runs, or when two units translate the same source wording
|
|
4
|
+
differently.
|
|
5
|
+
|
|
6
|
+
- **`ApplicationTranslationGlossarySchema`**: what the specifications package exports as `translationGlossary`.
|
|
7
|
+
- **`TranslationGlossaryTermSchema`**: one term. It has either `translations` per language or `doNotTranslate: true`.
|
|
8
|
+
- **`LockedTranslationSchema`**: one key of one unit in one language, with the `source` words it was chosen for.
|
|
9
|
+
|
|
10
|
+
## Import Origins
|
|
11
|
+
|
|
12
|
+
- `@wildo-ai/saas-specifications`
|
|
13
|
+
|
|
14
|
+
## Source Excerpts
|
|
15
|
+
|
|
16
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
17
|
+
|
|
18
|
+
```typescript
|
|
19
|
+
*
|
|
20
|
+
* The application's translation glossary, exported by its specifications package as `translationGlossary`
|
|
21
|
+
* (`import { ApplicationTranslationGlossaryDeclaration } from '@wildo-ai/saas-specifications'`). Terms apply to every
|
|
22
|
+
* string `wildo generate translate` writes; a locked translation pins one key of one unit in one language. Matching is
|
|
23
|
+
* literal and ignores case: an inflected form is a different string and needs its own term.
|
|
24
|
+
*/
|
|
25
|
+
|
|
26
|
+
/** One term of the glossary: an English (primary-language) wording and what it becomes in each language. */
|
|
27
|
+
export const TranslationGlossaryTermSchema = z
|
|
28
|
+
.strictObject({
|
|
29
|
+
/**
|
|
30
|
+
* The wording in the application's PRIMARY language, as it appears in labels (`ERP supplier key`). Matched without
|
|
31
|
+
* regard to case and at word boundaries, so `ERP supplier key` also matches inside "Edit the ERP supplier key".
|
|
32
|
+
*/
|
|
33
|
+
term: z.string().trim().min(1),
|
|
34
|
+
/** The chosen translation per target language. A language with no entry is translated freely. */
|
|
35
|
+
translations: z.partialRecord(z.enum(AvailableLanguage).systemEnum('AvailableLanguage'), z.string().trim().min(1)).optional(),
|
|
36
|
+
/** The term stays as written in every language: a product name, a brand, an acronym. Excludes `translations`. */
|
|
37
|
+
doNotTranslate: z.literal(true).optional(),
|
|
38
|
+
/** Why this wording: read by people, and given to the model beside the term. */
|
|
39
|
+
note: z.string().trim().min(1).optional(),
|
|
40
|
+
})
|
|
41
|
+
.refine((term) => (term.doNotTranslate === true) !== (term.translations !== undefined && Object.keys(term.translations).length > 0), {
|
|
42
|
+
message: 'A glossary term declares either translations (at least one language) or doNotTranslate: true, never both and never neither.',
|
|
43
|
+
});
|
|
44
|
+
export type TranslationGlossaryTerm = z.infer<typeof TranslationGlossaryTermSchema>;
|
|
45
|
+
|
|
46
|
+
/** One key of one label unit whose word in one language a person chose. */
|
|
47
|
+
export const LockedTranslationSchema = z.strictObject({
|
|
48
|
+
/** The label unit, as `wildo generate translate --units` names it (`resource:supplierDirectory`). */
|
|
49
|
+
unitId: z.string().trim().min(1),
|
|
50
|
+
/** The key's full dotted path, from the root of the label file (`resources.supplierDirectory.header.title`). A key that matches nothing is reported and does nothing. */
|
|
51
|
+
key: z.string().trim().min(1),
|
|
52
|
+
/** The language whose word is chosen. */
|
|
53
|
+
locale: z.enum(AvailableLanguage).systemEnum('AvailableLanguage'),
|
|
54
|
+
/** The primary-language words this translation was chosen for. When the key's words change, the lock is stale. */
|
|
55
|
+
source: z.string().min(1),
|
|
56
|
+
/** The chosen translation, written as is. */
|
|
57
|
+
value: z.string().min(1),
|
|
58
|
+
/** Why this word, and who chose it if that matters. */
|
|
59
|
+
reason: z.string().trim().min(1),
|
|
60
|
+
});
|
|
61
|
+
export type LockedTranslation = z.infer<typeof LockedTranslationSchema>;
|
|
62
|
+
|
|
63
|
+
/** The application's glossary: the terms every string honours, and the keys a person locked. */
|
|
64
|
+
export const ApplicationTranslationGlossarySchema = z
|
|
65
|
+
.strictObject({
|
|
66
|
+
terms: z.array(TranslationGlossaryTermSchema).default([]),
|
|
67
|
+
lockedTranslations: z.array(LockedTranslationSchema).default([]),
|
|
68
|
+
})
|
|
69
|
+
.superRefine((glossary, context) => {
|
|
70
|
+
// Two entries for one term, or two locks on one word, would make the outcome depend on declaration order.
|
|
71
|
+
const terms = new Set<string>();
|
|
72
|
+
glossary.terms.forEach((term, index) => {
|
|
73
|
+
const normalized = term.term.toLocaleLowerCase();
|
|
74
|
+
if (terms.has(normalized)) context.addIssue({ code: 'custom', path: ['terms', index, 'term'], message: `The term "${term.term}" is declared twice.` });
|
|
75
|
+
terms.add(normalized);
|
|
76
|
+
});
|
|
77
|
+
const locks = new Set<string>();
|
|
78
|
+
glossary.lockedTranslations.forEach((lock, index) => {
|
|
79
|
+
const identity = `${lock.unitId}\u0000${lock.key}\u0000${lock.locale}`;
|
|
80
|
+
if (locks.has(identity)) context.addIssue({ code: 'custom', path: ['lockedTranslations', index], message: `The ${lock.locale} word of ${lock.unitId} ${lock.key} is locked twice.` });
|
|
81
|
+
locks.add(identity);
|
|
82
|
+
});
|
|
83
|
+
});
|
|
84
|
+
export type ApplicationTranslationGlossary = z.infer<typeof ApplicationTranslationGlossarySchema>;
|
|
85
|
+
/** What an application authors: both lists may be omitted. */
|
|
86
|
+
export type ApplicationTranslationGlossaryDeclaration = z.input<typeof ApplicationTranslationGlossarySchema>;
|
|
87
|
+
```
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: inbound-channels
|
|
3
|
-
description: Declare code that runs when a message ARRIVES — a signed webhook
|
|
3
|
+
description: Declare code that runs when a message ARRIVES — a signed webhook, or an email or text from a person — on `BackendDomainModule.inboundHandlers`, stored once, retried and replayable, with the sender's assurance deciding whether the handler runs and never what it may do. Use when the user says "receive a webhook from X", "add an inbound webhook endpoint", "handle Svix / Resend webhooks", "a client's system should create records in our app", "verify an HMAC-signed callback", "replay a failed webhook", "why does /webhooks/app/<key> answer 404", "clients should email documents to a case", "turn incoming email into tickets", "reply to the sender automatically", "only accept mail from known contacts", "let each organization receive mail at its own domain", "give each client a mailbox on our domain", or "people should text our number". Also when a system of record notifies that records changed ("Odoo posts a webhook when a partner changes", "refresh the synced customers when the ERP says so").
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -21,8 +21,8 @@ Read and apply these patterns from the application-developer point of view:
|
|
|
21
21
|
## Overview
|
|
22
22
|
|
|
23
23
|
An inbound handler is backend code that runs on one message sent to your application: a signed delivery
|
|
24
|
-
from another system (an ENDPOINT handler), or an email from a person (a CHANNEL handler,
|
|
25
|
-
`references/email-channel.md`). You declare WHAT the message means; the engine owns everything between the wire and your
|
|
24
|
+
from another system (an ENDPOINT handler), or an email or a text message from a person (a CHANNEL handler,
|
|
25
|
+
`references/email-channel.md`, `references/sms-channel.md`). You declare WHAT the message means; the engine owns everything between the wire and your
|
|
26
26
|
code: body limits, signature verification, a durable dedup ledger, scope resolution, retries, a DEAD
|
|
27
27
|
state and operator replay. The handler runs later, in a worker, with the roles you declare — in exactly
|
|
28
28
|
the one organization (or the application) the message resolved to, never in more.
|
|
@@ -41,6 +41,8 @@ the one organization (or the application) the message resolved to, never in more
|
|
|
41
41
|
| Shared receiving domain | `backend-api/src/saas-config.backend.ts` → `email.inbound.sharedDomain`, the default; an environment lays its own over it in `wildo.infra.<env>.config.ts` → `email.inbound.sharedDomain` (`infra-environment-config`) |
|
|
42
42
|
| Organization domains, relationship mailboxes | engine resources `organizationEmailDomains` / `relationshipMailboxes` — organization settings, no code |
|
|
43
43
|
| Reply templates | the module's email templates (`email-add-template`) |
|
|
44
|
+
| SMS channel handler | same folder and naming as the email one, with `channel: InboundChannelKind.SMS` |
|
|
45
|
+
| Receiving texts | the SMS capability with a provider that reports received messages, on the backend scope with `SMS_PROVIDER` + `WEBHOOK_ORIGINATOR` (its notification endpoint enabled), and each organization's number as an `smsNumberAssignments` row the application's super-administrator creates — no code |
|
|
44
46
|
|
|
45
47
|
## When to Use
|
|
46
48
|
|
|
@@ -48,6 +50,8 @@ the one organization (or the application) the message resolved to, never in more
|
|
|
48
50
|
- You need each event stored once, retried until it succeeds or is dead, and a way to replay what failed.
|
|
49
51
|
- People email your application — documents to a case, requests to a support address — and the message
|
|
50
52
|
should file, create or answer something.
|
|
53
|
+
- People text an organization's number (move a booking, answer a reminder) and the text should reach code, or be
|
|
54
|
+
answered by text (`references/sms-channel.md`).
|
|
51
55
|
- A system of record notifies that records changed and the application keeps a synced copy of them: the
|
|
52
56
|
handler asks the pipeline to re-read exactly those records (`ctx.pipelines.requestPipelineKeys`,
|
|
53
57
|
`references/framework-inbound-pipelines-api.md`).
|
|
@@ -96,13 +100,18 @@ the one organization (or the application) the message resolved to, never in more
|
|
|
96
100
|
3. **Declare the handler** with `defineInboundHandler` and a `payloadSchema` for the body
|
|
97
101
|
(`references/framework-inbound-handler-api.md`). Keep `actingRoles` to what the handler writes —
|
|
98
102
|
never `APP_ADMIN_SUPER_ADMIN`.
|
|
99
|
-
4. **
|
|
103
|
+
4. **Declare `subjectKeys`** when the payload can name a person: their email address, their phone number or
|
|
104
|
+
their user id, written with `inboundSubjectKeyForEmailAddress` / `inboundSubjectKeyForPhoneNumber`
|
|
105
|
+
(`@wildo-ai/saas-models`). A person's erasure deletes the deliveries naming them by these keys, and nothing
|
|
106
|
+
else can find them
|
|
107
|
+
(`references/inbound-delivery-lifecycle.md` → "What a stored delivery keeps").
|
|
108
|
+
5. **Register it** on the module's `inboundHandlers`. A misdeclaration stops the backend at startup
|
|
100
109
|
with the rule it broke.
|
|
101
|
-
|
|
110
|
+
6. **Provide the secret** in each environment's `secrets.json`, under `inboundEndpointEnv`, keyed by the
|
|
102
111
|
name the engine derives from the endpoint key: `todo-intake` → `WILDO_INBOUND_TODO_INTAKE__SECRET`
|
|
103
112
|
(`deriveInboundEndpointSecretEnvVarName` from `@wildo-ai/saas-models`). `wildo config sync` delivers
|
|
104
113
|
it to the backend only. Without it the route is not mounted and senders get `404`.
|
|
105
|
-
|
|
114
|
+
7. **Verify** with the checks below, then send a signed test delivery.
|
|
106
115
|
|
|
107
116
|
**For email** (`references/email-channel.md`), the steps differ:
|
|
108
117
|
|
|
@@ -123,6 +132,11 @@ the one organization (or the application) the message resolved to, never in more
|
|
|
123
132
|
the returned copy in the record's `z_file` field — never the attachment's own `fileId`, which belongs to the
|
|
124
133
|
received message (`references/email-channel.md` → "Attachments onto your records").
|
|
125
134
|
|
|
135
|
+
**For SMS** (`references/sms-channel.md`), as for email, plus: give each organization its number
|
|
136
|
+
(`smsNumberAssignments`), pick the minimum on the SMS ladder (`UNVERIFIED` < `KNOWN_CONTACT` <
|
|
137
|
+
`VERIFIED_MEMBER_NUMBER`), and answer with `ctx.reply({ text })`, never a template. STOP, START and HELP never
|
|
138
|
+
reach the handler.
|
|
139
|
+
|
|
126
140
|
## Worked Example
|
|
127
141
|
|
|
128
142
|
A client system asks for a todo in one list. Svix-verified; the organization is the one that OWNS that
|
|
@@ -273,6 +287,8 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
273
287
|
replying, threads and the linked record, why a message never authorizes a payment or an approval.
|
|
274
288
|
- `references/framework-inbound-channel-api.md` — the channel handler and conversation contracts, and
|
|
275
289
|
`ctx.attachments.adopt` (source-backed).
|
|
290
|
+
- `references/sms-channel.md` — the SMS channel: control messages, which number routes to which organization, the
|
|
291
|
+
SMS ladder, route tags as a text's first word, threads by number pair, and replying by text at most once.
|
|
276
292
|
- `references/receiving-email.md` — receiving: the four route kinds and which address reaches which
|
|
277
293
|
organization, configuring the provider and the shared domain, an organization's own domain (claim → TXT →
|
|
278
294
|
verify), relationship mailboxes on a representing organization's domain, the answer's From, what a stored message
|
|
@@ -287,12 +303,15 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
287
303
|
- [ ] Every handler has a unique `ref` and its module lists it in `inboundHandlers`.
|
|
288
304
|
- [ ] A handler on `HMAC_SHA256_HEADER` declares `dedupKey`.
|
|
289
305
|
- [ ] `actingRoles` names only roles the handler's writes need, and never the super-administrator role.
|
|
306
|
+
- [ ] A handler whose payload names a person declares `subjectKeys`, every address and phone number written through the saas-models key helpers.
|
|
290
307
|
- [ ] The backend starts (a misdeclared handler refuses startup and names the rule).
|
|
291
308
|
- [ ] `POST /webhooks/app/<endpointKey>` answers `401` to an unsigned body — not `404` (secret missing)
|
|
292
309
|
and not `200`.
|
|
293
310
|
- [ ] Each email channel has exactly one `isDefault: true` handler, and every handler declares `replyMode`
|
|
294
311
|
and a `minimumSenderAssurance` from the email ladder.
|
|
295
312
|
- [ ] No channel handler writes payment details, approvals or recipients from a message's content.
|
|
313
|
+
- [ ] An SMS channel's handlers declare exactly one `isDefault: true`, a minimum from the SMS ladder, and answer with
|
|
314
|
+
`ctx.reply({ text })`; each organization that should receive texts has its `smsNumberAssignments` row.
|
|
296
315
|
- [ ] A channel handler names an attachment on a record only through `ctx.attachments.adopt`'s returned copy.
|
|
297
316
|
- [ ] With `EMAIL_INBOUND` enabled, `POST /api/v1/webhooks/<provider>/<endpoint>` answers `401` to an unsigned
|
|
298
317
|
body, and a shared receiving domain is set wherever organizations should receive mail with no setup —
|
|
@@ -303,6 +322,8 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
303
322
|
- `rg "inboundHandlers:" backend-api/src/modules` — every handler file is registered somewhere.
|
|
304
323
|
- `rg "APP_ADMIN_SUPER_ADMIN" backend-api/src/modules/*/inbound` — must return nothing.
|
|
305
324
|
- `rg "HMAC_SHA256_HEADER" -l backend-api/src/modules/*/inbound | xargs rg --files-without-match "dedupKey"` — must return nothing.
|
|
325
|
+
- `rg -l "defineInboundHandler" backend-api/src/modules | xargs rg --files-without-match "subjectKeys"` — every handler
|
|
326
|
+
listed has a payload that names no person; review each one that does.
|
|
306
327
|
- `rg -c "isDefault: true" backend-api/src/modules/*/inbound` — sums to one per channel.
|
|
307
328
|
- `rg -l "requestPipelineKeys" backend-api/src/modules | xargs rg --files-without-match "pipelineKeyRequests"` — must return nothing.
|
|
308
329
|
- `rg -n "ctx\.resources\.(create|update)" backend-api/src/modules/*/inbound` — none may target a resource that declares an `externalDataPipeline`.
|
|
@@ -310,7 +331,7 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
310
331
|
- `rg -n "message\.(text|strippedReply)" backend-api/src/modules/*/inbound` — every read of the body; none may
|
|
311
332
|
choose an organization, a record to write into, or a recipient.
|
|
312
333
|
- `rg -n "fileId: attachment\.fileId|attachment\.fileId \}" backend-api/src/modules/*/inbound` — must return nothing: an
|
|
313
|
-
attachment's own id written into a record is refused (`
|
|
334
|
+
attachment's own id written into a record is refused (`FILE_NOT_LINKABLE`); write the adopted copy's id.
|
|
314
335
|
|
|
315
336
|
## Common Rationalizations
|
|
316
337
|
|
|
@@ -320,6 +341,7 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
320
341
|
| "The provider retries, so I don't need dedup." | Retries are exactly why you need it: without the ledger each retry runs the handler again. Declare `dedupKey` when the scheme signs no id. |
|
|
321
342
|
| "I'll give the handler an admin role so it never gets refused." | The roles are its whole authority, in one organization. A broader role turns a forged-but-verified message into broad access. Declare what it writes. |
|
|
322
343
|
| "The payload says which organization it is for." | A signature proves who SENT it, not whose tenant it is: one secret serves the whole application. Resolve the organization from your own data bound to something the delivery names. |
|
|
344
|
+
| "The payload is the sender's, so its people are the sender's problem." | The stored delivery is yours, and so is answering an erasure request about it. Without `subjectKeys` nothing can find the person in a base64 body, and they stay until the retention period ends. |
|
|
323
345
|
| "The handler won't run twice, the delivery is deduplicated." | The delivery is STORED once; the handler runs at least once (a crash after your writes is retried). Make it idempotent per `ctx.delivery.id`. |
|
|
324
346
|
| "If the organization isn't found I'll put it in the application scope." | There is no fallback on purpose: the handler was written for a tenant. The delivery is `UNROUTABLE`, audited, and visible to the operator. |
|
|
325
347
|
| "The email came from the client's address, so it is the client." | The From line is typed by the sender. `DOMAIN_ALIGNED` proves the domain, not the person; even `THREAD_TOKEN_BOUND` proves only that someone holds the reply address. Set the minimum for what the handler does, and never let a message authorize a payment or an approval. |
|
|
@@ -327,7 +349,7 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
327
349
|
| "The ERP's webhook carries the new values, so I'll write them into the synced resource." | A synced resource's fields belong to its pipeline, and a notification can be stale, partial or replayed. Call `ctx.pipelines.requestPipelineKeys` with the record keys; the pipeline re-reads them from the source. |
|
|
328
350
|
| "The attachment already has a `fileId`, I'll put it in my record's file field." | That file is the received message's, kept and erased with it; the write is refused. `ctx.attachments.adopt` makes your record its own copy, checked against your field's rules. |
|
|
329
351
|
| "The handler knows the thread, so it should tell the agent which conversation to continue." | `ctx.chat.converse()` takes nothing. The engine reads the conversation, the sender and the message from the verified request, so a handler cannot point a member's turn at another conversation or put words in their mouth. |
|
|
330
|
-
| "The chat click says who clicked, so the handler can approve for them with its own roles." | The handler's roles are the scope's, not the person's. `ctx.chat.answerDecision` answers as the member the chat account is linked to, under the decision's own rules, and the decision's audit row names the delivery it came through. |
|
|
352
|
+
| "The chat click says who clicked, so the handler can approve for them with its own roles." | The handler's roles are the scope's, not the person's. `ctx.chat.answerDecision` answers as the member the chat account is linked to, under the decision's own rules, and the decision's audit row names the delivery it came through. When the decision cannot be answered in chat (it requires a step-up, or its kind does not admit a chat answer), the result carries `openInApplicationUrl`: post it as the message's link rather than a bare refusal. |
|
|
331
353
|
| "I'll call the agent directly from the handler." | `ctx` has no actor call. Hand the delivery to a declared autonomous agent with `ctx.agents.startAutonomousTurn` — it runs under the principal the organization bound to that agent, is idempotent per delivery, and is offered only read or reviewer-gated tools (`flows-actors-autonomous-agents`). |
|
|
332
354
|
|
|
333
355
|
## Red Flags
|
|
@@ -341,7 +363,7 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
341
363
|
- A channel handler at `UNVERIFIED` that writes records a client relies on — catch with the second
|
|
342
364
|
Verification item; raise the minimum or route the message to a review handler.
|
|
343
365
|
- Two `isDefault: true` handlers on one channel — catch with the fourth grep (startup refuses it too).
|
|
344
|
-
- A record created from an email with no file, or a delivery ending DEAD on `
|
|
366
|
+
- A record created from an email with no file, or a delivery ending DEAD on `FILE_NOT_LINKABLE` — the handler wrote
|
|
345
367
|
the attachment's own id; catch with the attachment-id grep above and adopt instead.
|
|
346
368
|
- A handler that reads the organization or the list from the message BODY — routing already chose the
|
|
347
369
|
organization from the envelope; read the route tag (`message.payload.routeTag`) and your own data. Catch
|
|
@@ -58,13 +58,21 @@ tag each. Two defaults, or two handlers on one tag, stop the backend at startup.
|
|
|
58
58
|
## Answering: reply mode
|
|
59
59
|
|
|
60
60
|
`replyMode` is required. `NONE` means the handler never answers, and `ctx.reply` does not exist on its
|
|
61
|
-
context. `THREAD` gives it `ctx.reply({ templateRef, variables })`:
|
|
61
|
+
context. `THREAD` gives it `ctx.reply({ templateRef, variables, attachmentFileIds? })`:
|
|
62
62
|
|
|
63
63
|
- the reply goes out through your transactional email provider, on the thread the message arrived on,
|
|
64
64
|
with `Message-ID`, `In-Reply-To` and `References` set so the client's mail program files it in the same
|
|
65
65
|
conversation — no other header can be set;
|
|
66
66
|
- the template is yours: register it like any other email template (`email-add-template`);
|
|
67
|
-
- a handler that runs twice for one message (a retry) queues ONE reply per template
|
|
67
|
+
- a handler that runs twice for one message (a retry) queues ONE reply per template;
|
|
68
|
+
- `attachmentFileIds` sends files with the reply (a signed copy, a receipt, the document the sender asked for), at most
|
|
69
|
+
ten. Each must be a file the HANDLER can read with its own roles in the message's organization: a file one of a
|
|
70
|
+
record's file fields holds, on a record it can READ through `ctx.resources`, or one this delivery produced (a copy
|
|
71
|
+
`ctx.attachments.adopt` made, a generated document). A file a record no longer holds is refused like any other. Anything else is refused when the reply is queued, with the file named, and no reply is queued: another
|
|
72
|
+
organization's file answers `NOT_FOUND` like a missing one, a file it cannot read answers `AUTHORIZATION`, and a file
|
|
73
|
+
still being scanned answers `BUSINESS_RULE`, so the delivery retries. The ids are kept on the reply's message row and
|
|
74
|
+
checked against the organization again when the reply is sent; a file deleted or moved in between fails the reply
|
|
75
|
+
rather than sending it without the file.
|
|
68
76
|
|
|
69
77
|
## Threads and the linked record
|
|
70
78
|
|
|
@@ -96,7 +104,7 @@ whatever happens to the thread.
|
|
|
96
104
|
`message.attachments` lists the CLEAN attachments; the withheld ones are in `message.withheldAttachments` with their
|
|
97
105
|
reason and never reach a handler. Each clean attachment's `fileId` is the file the EMAIL keeps — linked to the
|
|
98
106
|
received message, kept for the message's retention and erased with it. A file belongs to exactly one record, so that
|
|
99
|
-
id cannot also go into a `z_file` field of yours: the write is refused (`
|
|
107
|
+
id cannot also go into a `z_file` field of yours: the write is refused (`FILE_NOT_LINKABLE`).
|
|
100
108
|
|
|
101
109
|
To make an attachment part of a record — a document, a claim, a case's evidence — adopt it:
|
|
102
110
|
|
|
@@ -107,6 +115,10 @@ await ctx.resources.create('sourceDocuments', { title: attachment.filename, file
|
|
|
107
115
|
|
|
108
116
|
<!-- TIER C WAIVER: two lines naming the call order; the full handler shape is the anchored example in SKILL.md. -->
|
|
109
117
|
|
|
118
|
+
A handler may link only what its own delivery produced. An id read from a sender's payload is refused whoever uploaded
|
|
119
|
+
that file, usually with a `NOT_FOUND`, which is retried until the delivery's budget is spent, so never ask a sender for a
|
|
120
|
+
file id.
|
|
121
|
+
|
|
110
122
|
`adopt` makes a COPY: a new file of the delivery's organization, carrying the attachment's clean scan verdict, made
|
|
111
123
|
for that field. Your record's copy then lives — and is erased — with your record (an accounting document kept for
|
|
112
124
|
years), while the email keeps its own for as long as correspondence is kept. Text extraction, OCR and retrieval run
|
|
@@ -158,7 +170,7 @@ a reviewer (`flows-actors-autonomous-agents`).
|
|
|
158
170
|
|---|---|
|
|
159
171
|
| `INBOUND_DELIVERY_ACCEPTED` | A message was admitted; carries the channel and the sender assurance. |
|
|
160
172
|
| `INBOUND_DELIVERY_BELOW_ASSURANCE` | A message was below its handler's minimum; says where it went. |
|
|
161
|
-
| `INBOUND_REPLY_SENT` / `INBOUND_REPLY_FAILED` | A reply was accepted by the provider, or finally failed. |
|
|
173
|
+
| `INBOUND_REPLY_SENT` / `INBOUND_REPLY_FAILED` | A reply was accepted by the provider (naming the ids of the files it carried), or finally failed. |
|
|
162
174
|
| `INBOUND_REPLY_TOKEN_REVOKED` | Reply addresses stopped binding (closed, counterpart changed, member removed, rotated). |
|
|
163
175
|
| `INBOUND_REPLY_TOKEN_DOWNGRADED` | A reply address was used by another sender than its recipient. |
|
|
164
176
|
| `INBOUND_ATTACHMENT_ADOPTED` | A handler adopted an attachment onto a record; names the original, the copy and the field. |
|
|
@@ -17,12 +17,17 @@ its minimum sender assurance, or read a conversation thread.
|
|
|
17
17
|
/**
|
|
18
18
|
* What a message arrived on.
|
|
19
19
|
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
20
|
+
* Chat and Slack join this vocabulary when a provider can fill them — a channel nothing can receive on is a
|
|
21
|
+
* slot no configuration can satisfy.
|
|
22
22
|
*/
|
|
23
23
|
export enum InboundChannelKind {
|
|
24
24
|
/** Email received through the application's `EMAIL_INBOUND` provider and routed to an organization. */
|
|
25
25
|
EMAIL = 'email',
|
|
26
|
+
/**
|
|
27
|
+
* A text message received by the application's SMS provider on a number the application assigned to an
|
|
28
|
+
* organization (#3394), routed to that organization by the number it was sent TO, never by its sender.
|
|
29
|
+
*/
|
|
30
|
+
SMS = 'sms',
|
|
26
31
|
/**
|
|
27
32
|
* A signed HTTP delivery from another system (#1596). Derived for provider and application endpoint
|
|
28
33
|
* deliveries; a handler never declares it.
|
|
@@ -63,6 +68,13 @@ export enum InboundSenderAssurance {
|
|
|
63
68
|
* and `From` is the address that token was issued to.
|
|
64
69
|
*/
|
|
65
70
|
THREAD_TOKEN_BOUND = 'thread_token_bound',
|
|
71
|
+
/**
|
|
72
|
+
* SMS: the sending number is the verified phone number (`UserCredentials.phoneNumberVerified`) of exactly one
|
|
73
|
+
* active member of the routed organization. Verified when the member confirmed a code sent to it; the sender of
|
|
74
|
+
* THIS text is still not authenticated (caller ID can be spoofed onto SMS), so it identifies the member and
|
|
75
|
+
* grants nothing. Two members holding one number identify nobody.
|
|
76
|
+
*/
|
|
77
|
+
VERIFIED_MEMBER_NUMBER = 'verified_member_number',
|
|
66
78
|
}
|
|
67
79
|
|
|
68
80
|
/** The assurance levels meaningful on each channel — the type a channel's ladder and minimum are drawn from. */
|
|
@@ -72,6 +84,10 @@ export interface InboundSenderAssuranceByChannel {
|
|
|
72
84
|
| InboundSenderAssurance.DOMAIN_ALIGNED
|
|
73
85
|
| InboundSenderAssurance.KNOWN_CONTACT
|
|
74
86
|
| InboundSenderAssurance.THREAD_TOKEN_BOUND;
|
|
87
|
+
[InboundChannelKind.SMS]:
|
|
88
|
+
| InboundSenderAssurance.UNVERIFIED
|
|
89
|
+
| InboundSenderAssurance.KNOWN_CONTACT
|
|
90
|
+
| InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
|
|
75
91
|
[InboundChannelKind.WEBHOOK]: InboundSenderAssurance.UNVERIFIED | InboundSenderAssurance.SOURCE_SIGNED;
|
|
76
92
|
}
|
|
77
93
|
|
|
@@ -89,6 +105,16 @@ export const INBOUND_SENDER_ASSURANCE_LADDERS: { readonly [C in InboundChannelKi
|
|
|
89
105
|
InboundSenderAssurance.KNOWN_CONTACT,
|
|
90
106
|
InboundSenderAssurance.THREAD_TOKEN_BOUND,
|
|
91
107
|
],
|
|
108
|
+
/*
|
|
109
|
+
* A member's verified number outranks a contact the application recognises: the member proved the number by a code
|
|
110
|
+
* the engine sent to it, while a contact's number is whatever the application recorded. Neither authenticates the
|
|
111
|
+
* sender of this text (SMS has no counterpart of DMARC), which is why the ladder only ever IDENTIFIES.
|
|
112
|
+
*/
|
|
113
|
+
[InboundChannelKind.SMS]: [
|
|
114
|
+
InboundSenderAssurance.UNVERIFIED,
|
|
115
|
+
InboundSenderAssurance.KNOWN_CONTACT,
|
|
116
|
+
InboundSenderAssurance.VERIFIED_MEMBER_NUMBER,
|
|
117
|
+
],
|
|
92
118
|
[InboundChannelKind.WEBHOOK]: [InboundSenderAssurance.UNVERIFIED, InboundSenderAssurance.SOURCE_SIGNED],
|
|
93
119
|
};
|
|
94
120
|
|
|
@@ -276,6 +302,49 @@ export function isEmailMessageId(value: unknown): value is string {
|
|
|
276
302
|
return typeof value === 'string' && EMAIL_MESSAGE_ID_PATTERN.test(value);
|
|
277
303
|
}
|
|
278
304
|
|
|
305
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
306
|
+
// SMS: deriving sender assurance and a text's route tag
|
|
307
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
308
|
+
|
|
309
|
+
/** What the routed organization knows about the number a text came from (#3394). */
|
|
310
|
+
export enum SmsSenderNumberMatch {
|
|
311
|
+
/** Not one member's verified number, and not a contact the application recognises. */
|
|
312
|
+
NONE = 'none',
|
|
313
|
+
/** The verified phone number of exactly one active member of the routed organization (sets `memberUserId`). */
|
|
314
|
+
VERIFIED_MEMBER = 'verified_member',
|
|
315
|
+
/** The handler's contact resolver recognised the number. The engine keeps no contacts of its own. */
|
|
316
|
+
APPLICATION_CONTACT = 'application_contact',
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
/**
|
|
320
|
+
* A text's sender assurance (#3394). PURE: the input is a lookup the engine made, never what the text says.
|
|
321
|
+
*
|
|
322
|
+
* SMS carries no sender authentication — no counterpart of DMARC, and caller ID can be spoofed onto a text — so every
|
|
323
|
+
* level above the floor IDENTIFIES the sender by a number someone verified or recorded, and none of them
|
|
324
|
+
* authenticates it. A handler's roles never depend on it (I8); a handler only states the minimum it acts on.
|
|
325
|
+
*/
|
|
326
|
+
export function deriveSmsSenderAssurance(match: SmsSenderNumberMatch): SenderAssuranceOf<InboundChannelKind.SMS> {
|
|
327
|
+
switch (match) {
|
|
328
|
+
case SmsSenderNumberMatch.VERIFIED_MEMBER: return InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
|
|
329
|
+
case SmsSenderNumberMatch.APPLICATION_CONTACT: return InboundSenderAssurance.KNOWN_CONTACT;
|
|
330
|
+
case SmsSenderNumberMatch.NONE: return InboundSenderAssurance.UNVERIFIED;
|
|
331
|
+
default: {
|
|
332
|
+
const unhandled: never = match;
|
|
333
|
+
return unhandled;
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
/**
|
|
339
|
+
* What an SMS `routeTag` looks like: the first word of a text, lower-cased, when it is a tag a handler declares
|
|
340
|
+
* (`INBOUND_ROUTE_TAG_PATTERN`'s shape). A text has no sub-address, so its first word is the only place a tag can be.
|
|
341
|
+
*/
|
|
342
|
+
export function smsRouteTagCandidate(text: string): string | undefined {
|
|
343
|
+
const first = text.normalize('NFKC').trim().split(/\s+/u)[0] ?? '';
|
|
344
|
+
const word = first.replace(/[^\p{L}\p{N}-]+$/gu, '').toLowerCase();
|
|
345
|
+
return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(word) ? word : undefined;
|
|
346
|
+
}
|
|
347
|
+
|
|
279
348
|
/**
|
|
280
349
|
* What an inbound handler's `ref` looks like: lower-case, dot-separated segments of `[a-z0-9-]`
|
|
281
350
|
* (`todos.intake`, `matters.mail-intake`). One definition for the backend's `inboundHandlerRef()`, which
|
|
@@ -308,8 +377,9 @@ export interface InboundChannelSource<C extends InboundChannelKind = InboundChan
|
|
|
308
377
|
readonly kind: InboundSourceKind.CHANNEL;
|
|
309
378
|
readonly channel: C;
|
|
310
379
|
/**
|
|
311
|
-
* The tag routing names — for email, `tag` in `cases+tag@firm.example
|
|
312
|
-
*
|
|
380
|
+
* The tag routing names — for email, `tag` in `cases+tag@firm.example`; for SMS, the text's first word
|
|
381
|
+
* (`BOOKING tomorrow 9am` carries `booking`), since a text has no sub-address. Lower-case letters, digits
|
|
382
|
+
* and hyphens. An SMS text whose first word no handler claims goes to the default.
|
|
313
383
|
*/
|
|
314
384
|
readonly routeTag?: string;
|
|
315
385
|
/** Take every message no `routeTag` claims. */
|
|
@@ -318,11 +388,12 @@ export interface InboundChannelSource<C extends InboundChannelKind = InboundChan
|
|
|
318
388
|
|
|
319
389
|
/** Who sent a message, as far as the engine could establish. */
|
|
320
390
|
export interface InboundMessageSender<C extends InboundChannelKind = InboundChannelKind> {
|
|
391
|
+
/** The sender's address: an email address, or for SMS the sending number in E.164. */
|
|
321
392
|
readonly address: string;
|
|
322
393
|
readonly name?: string;
|
|
323
394
|
/** Identification, never authentication — see `InboundSenderAssurance`. It grants nothing. */
|
|
324
395
|
readonly assurance: SenderAssuranceOf<C>;
|
|
325
|
-
/** Set when the sender is a verified, active member of the routed organization. */
|
|
396
|
+
/** Set when the sender is a verified, active member of the routed organization (for SMS: by their verified phone number). */
|
|
326
397
|
readonly memberUserId?: string;
|
|
327
398
|
}
|
|
328
399
|
|
|
@@ -368,9 +439,21 @@ export interface InboundEmailPayload {
|
|
|
368
439
|
readonly routeTag?: string;
|
|
369
440
|
}
|
|
370
441
|
|
|
442
|
+
/**
|
|
443
|
+
* What an SMS handler receives about a text beyond its words (#3394). A text has no subject and no copy list: only the
|
|
444
|
+
* application number it was sent to, which is also the number a reply goes out from.
|
|
445
|
+
*/
|
|
446
|
+
export interface InboundSmsPayload {
|
|
447
|
+
/** The application's number the text was sent to, in E.164 — one the application assigned to the organization. */
|
|
448
|
+
readonly to: string;
|
|
449
|
+
/** The tag the text was routed on (its first word), when a handler claims it. */
|
|
450
|
+
readonly routeTag?: string;
|
|
451
|
+
}
|
|
452
|
+
|
|
371
453
|
/** The payload each channel carries — total over the channels a handler can be declared for. */
|
|
372
454
|
export interface InboundChannelPayloadByChannel {
|
|
373
455
|
[InboundChannelKind.EMAIL]: InboundEmailPayload;
|
|
456
|
+
[InboundChannelKind.SMS]: InboundSmsPayload;
|
|
374
457
|
}
|
|
375
458
|
|
|
376
459
|
/** A channel a handler may be declared for. `WEBHOOK` is the endpoint handlers' channel, never declared here. */
|
|
@@ -406,6 +489,9 @@ export interface InboundContactLookups {
|
|
|
406
489
|
* The application's answer to "is this address a contact of this organization?" (#1630 M6). The engine
|
|
407
490
|
* keeps no contacts: without a resolver, only members of the organization reach `KNOWN_CONTACT`. Asked
|
|
408
491
|
* only for a domain-aligned sender, and a resolver that throws counts as "no".
|
|
492
|
+
*
|
|
493
|
+
* SMS (#3394): `address` is the sending number in E.164, and the resolver is asked for every text that is
|
|
494
|
+
* not a member's verified number (SMS has no alignment to gate on, so the answer only ever identifies).
|
|
409
495
|
*/
|
|
410
496
|
export type InboundContactResolver = (input: {
|
|
411
497
|
readonly organizationId: string;
|
|
@@ -419,6 +505,29 @@ export interface InboundReplyRequest {
|
|
|
419
505
|
readonly templateRef: string;
|
|
420
506
|
/** Rendered into the template as `additionalContext`. Stored on the reply's message row until the reply's retention ends. */
|
|
421
507
|
readonly variables: Readonly<Record<string, unknown>>;
|
|
508
|
+
/**
|
|
509
|
+
* Files to send with the reply (#1856): a signed copy, a receipt, the document the sender asked for. Each must be a
|
|
510
|
+
* file the HANDLER can read with its own roles in the delivery's organization — a file on a record it can READ, or one
|
|
511
|
+
* this delivery produced itself — and is refused, with the file named, when the reply is queued otherwise. Never
|
|
512
|
+
* another organization's file, whatever the handler learned its id from. At most `CONVERSATION_REPLY_MAX_ATTACHMENTS`.
|
|
513
|
+
*/
|
|
514
|
+
readonly attachmentFileIds?: readonly string[];
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
/**
|
|
518
|
+
* What an SMS handler asks `ctx.reply` to send (#3394): the words of the reply. A text has no template; what it says
|
|
519
|
+
* is the handler's, at most `CONVERSATION_SMS_REPLY_MAX_LENGTH` characters (refused when queued, never cut). It goes
|
|
520
|
+
* out from the application number the text was sent to, only while the thread is open, and never to a number that
|
|
521
|
+
* replied STOP.
|
|
522
|
+
*/
|
|
523
|
+
export interface InboundSmsReplyRequest {
|
|
524
|
+
readonly text: string;
|
|
525
|
+
}
|
|
526
|
+
|
|
527
|
+
/** The reply request each channel takes — total over the channels a handler can be declared for. */
|
|
528
|
+
export interface InboundReplyRequestByChannel {
|
|
529
|
+
[InboundChannelKind.EMAIL]: InboundReplyRequest;
|
|
530
|
+
[InboundChannelKind.SMS]: InboundSmsReplyRequest;
|
|
422
531
|
}
|
|
423
532
|
|
|
424
533
|
/** The reply that was queued — one per call, idempotent per delivery and template (see `ctx.reply`). */
|
|
@@ -462,19 +571,20 @@ export type InboundChannelHandlerContextBase = Omit<InboundHandlerContext, 'deli
|
|
|
462
571
|
};
|
|
463
572
|
|
|
464
573
|
/**
|
|
465
|
-
* The context a handler of reply mode `M` receives. Under `THREAD` it can answer
|
|
466
|
-
* is `never`, so calling it does not compile.
|
|
574
|
+
* The context a handler of reply mode `M` on channel `C` receives. Under `THREAD` it can answer, with the
|
|
575
|
+
* channel's own reply request; under `NONE` `reply` is `never`, so calling it does not compile.
|
|
467
576
|
*/
|
|
468
|
-
export type InboundChannelHandlerContext<M extends InboundReplyMode> = InboundChannelHandlerContextBase & (
|
|
577
|
+
export type InboundChannelHandlerContext<M extends InboundReplyMode, C extends DeclarableInboundChannel = DeclarableInboundChannel> = InboundChannelHandlerContextBase & (
|
|
469
578
|
M extends InboundReplyMode.THREAD
|
|
470
579
|
? {
|
|
471
580
|
/**
|
|
472
581
|
* Answer on the thread the message arrived on, and only there (I7). Writes the reply as an OUTBOUND
|
|
473
|
-
* message and queues it; the reply worker sends it
|
|
474
|
-
* provider with the thread's headers
|
|
475
|
-
*
|
|
582
|
+
* message and queues it; the reply worker sends it on the thread's channel: for email through the
|
|
583
|
+
* application's transactional email provider with the thread's headers, for SMS through the SMS
|
|
584
|
+
* provider from the number the text was sent to. Calling it twice with the same template (or, for
|
|
585
|
+
* SMS, the same text) in one delivery queues ONE reply — a retried handler does not answer twice.
|
|
476
586
|
*/
|
|
477
|
-
readonly reply: (request:
|
|
587
|
+
readonly reply: (request: InboundReplyRequestByChannel[C]) => Promise<InboundQueuedReply>;
|
|
478
588
|
}
|
|
479
589
|
: { readonly reply?: never }
|
|
480
590
|
);
|
|
@@ -498,7 +608,7 @@ export interface InboundChannelHandlerDefinition<C extends DeclarableInboundChan
|
|
|
498
608
|
/** The handler's whole authority, in the routed organization. Never the super-administrator role. */
|
|
499
609
|
readonly actingRoles: { readonly organization: readonly string[] };
|
|
500
610
|
readonly retry?: InboundRetryPolicy;
|
|
501
|
-
handle(ctx: InboundChannelHandlerContext<M>, message: InboundMessage<C>): Promise<void>;
|
|
611
|
+
handle(ctx: InboundChannelHandlerContext<M, C>, message: InboundMessage<C>): Promise<void>;
|
|
502
612
|
}
|
|
503
613
|
|
|
504
614
|
/** Identity function that infers the channel and the reply mode, so `ctx.reply` is typed from the declaration. */
|
|
@@ -558,8 +668,10 @@ export interface InboundAdoptedAttachment {
|
|
|
558
668
|
* - **Recorded** — every adoption writes `inbound_attachment_adopted` on the organization's audit trail.
|
|
559
669
|
*
|
|
560
670
|
* What the copy MAY do is decided by your write, not here: `ctx.resources.create/update` authorizes the write with
|
|
561
|
-
* the handler's roles as for any caller, and links the copy then.
|
|
562
|
-
*
|
|
671
|
+
* the handler's roles as for any caller, and links the copy then. Only this delivery may name it, and a handler can name
|
|
672
|
+
* no other unlinked file: an id taken from a sender's payload that names someone's upload answers `NOT_FOUND` (#3330). A
|
|
673
|
+
* copy your handler never names (the write failed, or a retry found the record already filed) is swept a day later like
|
|
674
|
+
* any upload nobody attached.
|
|
563
675
|
*/
|
|
564
676
|
export interface InboundAttachmentOperations {
|
|
565
677
|
adopt(fileId: string, target: InboundAttachmentAdoptionTarget): Promise<InboundAdoptedAttachment>;
|
|
@@ -652,7 +764,7 @@ export const ConversationThreadSchema = z.object({
|
|
|
652
764
|
channel: z.enum(InboundChannelKind).systemEnum('InboundChannelKind').isSummaryField().excludeFromUpdate()
|
|
653
765
|
.describe('The channel the thread runs on. Replies go out on this channel only.'),
|
|
654
766
|
threadKey: z.string().min(1).max(998).isDBIndexed().excludeFromUpdate()
|
|
655
|
-
.describe("The channel's correlation key: for email, the Message-ID of the message that opened the thread."),
|
|
767
|
+
.describe("The channel's correlation key: for email, the Message-ID of the message that opened the thread; for SMS, the two numbers and the opening text's provider id."),
|
|
656
768
|
/** The address the application is exchanging messages with. Changing it revokes the previous counterpart's tokens. */
|
|
657
769
|
counterpartAddress: address().isDBIndexed().isSummaryField()
|
|
658
770
|
.describe('The address the application is exchanging messages with on this thread.'),
|
|
@@ -685,6 +797,20 @@ export const ConversationOutboundThreadingSchema = z.strictObject({
|
|
|
685
797
|
references: z.array(z.string().max(998)).max(100).default([]).describe('The thread\'s Message-IDs, oldest first, ending with the one answered.'),
|
|
686
798
|
});
|
|
687
799
|
|
|
800
|
+
/**
|
|
801
|
+
* The most files one reply carries. A reply answers one message, and a person reading it expects the few documents it
|
|
802
|
+
* is about (a signed copy, a receipt), not an archive; the email service also caps the attachments' total size
|
|
803
|
+
* (`OUTBOUND_ATTACHMENT_TOTAL_BYTES_LIMIT`), so the count is the bound a handler meets first, with the file named.
|
|
804
|
+
*/
|
|
805
|
+
export const CONVERSATION_REPLY_MAX_ATTACHMENTS = 10;
|
|
806
|
+
|
|
807
|
+
/**
|
|
808
|
+
* The longest text reply (#3394): what the SMS vendors accept in one message body (Twilio's `Body` and Telnyx's `text`
|
|
809
|
+
* both stop at 1600 characters, split by the carrier into segments). A reply longer than this is refused when it is
|
|
810
|
+
* queued, rather than cut.
|
|
811
|
+
*/
|
|
812
|
+
export const CONVERSATION_SMS_REPLY_MAX_LENGTH = 1600;
|
|
813
|
+
|
|
688
814
|
/** One message of a thread, in either direction. */
|
|
689
815
|
export const ConversationMessageSchema = z.object({
|
|
690
816
|
_id: z.string().min(1).isPrimaryKey().isSummaryField(),
|
|
@@ -693,9 +819,13 @@ export const ConversationMessageSchema = z.object({
|
|
|
693
819
|
.describe('The thread this message belongs to.'),
|
|
694
820
|
direction: z.enum(ConversationMessageDirection).systemEnum('ConversationMessageDirection').isSummaryField().excludeFromUpdate()
|
|
695
821
|
.describe('Whether the message was received from the counterpart or sent by the application.'),
|
|
696
|
-
/**
|
|
822
|
+
/**
|
|
823
|
+
* The RFC 5322 Message-ID on the wire — what a later In-Reply-To or References names. A text message has none: an
|
|
824
|
+
* SMS row carries `<providerMessageId@sms.invalid>` (the provider's id for the text, or the reply's submission id),
|
|
825
|
+
* which nothing on the wire ever names.
|
|
826
|
+
*/
|
|
697
827
|
rfcMessageId: z.string().min(1).max(998).isDBIndexed().excludeFromUpdate()
|
|
698
|
-
.describe('The Message-ID the message carried on the wire, angle brackets included.'),
|
|
828
|
+
.describe('The Message-ID the message carried on the wire, angle brackets included; for a text message, the provider\'s id for it.'),
|
|
699
829
|
fromAddress: address().isSummaryField().describe('Who sent the message.'),
|
|
700
830
|
// RESET, not MASK: the treatment belongs to the ARRAY, and a mask string is not an array. Erasure returns
|
|
701
831
|
// the list to its default — empty.
|
|
@@ -740,6 +870,15 @@ export const ConversationMessageSchema = z.object({
|
|
|
740
870
|
outboundStatus: z.enum(ConversationOutboundStatus).systemEnum('ConversationOutboundStatus').isDBIndexed().nullable().default(null)
|
|
741
871
|
.excludeFromCreate().excludeFromUpdate()
|
|
742
872
|
.describe('For a reply, where it stands with the sending provider; null for a received message.'),
|
|
873
|
+
/**
|
|
874
|
+
* OUTBOUND, SMS (#3394): the words the handler answered a text with. A text reply has no template — what it says is
|
|
875
|
+
* the handler's, as for the other texts the application sends — so the row keeps it until the reply's retention ends,
|
|
876
|
+
* as an email reply keeps its template variables. Null on every other row.
|
|
877
|
+
*/
|
|
878
|
+
replyText: addImpersonalizeWith(
|
|
879
|
+
z.string().max(CONVERSATION_SMS_REPLY_MAX_LENGTH).nullable().default(null).excludeFromUpdate().dataCategories(PersonalDataCategory.USER_CONTENT),
|
|
880
|
+
RedactionType.RESET,
|
|
881
|
+
).describe('For a reply by text message, what it said.'),
|
|
743
882
|
/** OUTBOUND: the template the HANDLER chose, and the variables it rendered with. */
|
|
744
883
|
templateRef: z.string().max(200).nullable().default(null).excludeFromUpdate()
|
|
745
884
|
.describe('For a reply, the email template the handler chose.'),
|
|
@@ -750,6 +889,15 @@ export const ConversationMessageSchema = z.object({
|
|
|
750
889
|
).describe('For a reply, the variables the template rendered with.'),
|
|
751
890
|
locale: z.string().max(35).nullable().default(null).excludeFromUpdate()
|
|
752
891
|
.describe('For a reply, the locale the template rendered in.'),
|
|
892
|
+
/**
|
|
893
|
+
* OUTBOUND: the files the handler attached to the reply (#1856), from the moment it is queued to the moment it is
|
|
894
|
+
* sent — this row is the reply's only record, so nothing else survives to the send attempt. Each was checked against
|
|
895
|
+
* the handler's own READ authority in the delivery's organization when the reply was queued, and the send confines
|
|
896
|
+
* them to that organization again. Ids only: a file's name and bytes stay with the file. Empty for a received message,
|
|
897
|
+
* whose attachments live in its channel record.
|
|
898
|
+
*/
|
|
899
|
+
attachmentFileIds: z.array(z.string().min(1)).max(CONVERSATION_REPLY_MAX_ATTACHMENTS).default([]).excludeFromUpdate()
|
|
900
|
+
.describe('For a reply, the ids of the files sent with it as attachments.'),
|
|
753
901
|
/**
|
|
754
902
|
* For a reply, while it is QUEUED: the Reply-To address its first send attempt composed. It carries the
|
|
755
903
|
* reply token IN PLAINTEXT (I12), so it is backend-only — no API returns it — and it is cleared when the
|
|
@@ -853,18 +1001,16 @@ export function EmbedLinkedConversations({ className }: EmbedLinkedConversations
|
|
|
853
1001
|
{ hostResourceType },
|
|
854
1002
|
);
|
|
855
1003
|
}
|
|
856
|
-
|
|
1004
|
+
// Threads are linked by type and id, not by a relationship, so this embed confines them itself (#3072).
|
|
1005
|
+
return compositeResourceContext.buildOperationContext({
|
|
857
1006
|
resourceType: CoreResourceType.CONVERSATION_THREADS,
|
|
858
1007
|
operationLike: CoreResourceOperation.LIST,
|
|
859
1008
|
requireAddressable: false,
|
|
860
|
-
});
|
|
861
|
-
return {
|
|
862
|
-
...threads,
|
|
863
1009
|
pinnedFilters: {
|
|
864
1010
|
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,
|
|
865
1011
|
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,
|
|
866
1012
|
},
|
|
867
|
-
};
|
|
1013
|
+
});
|
|
868
1014
|
}, [compositeResourceContext, hostResourceType, hostResourceId]);
|
|
869
1015
|
|
|
870
1016
|
return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
|