@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
|
@@ -45,6 +45,14 @@ export interface FunctionToolExecutionContext {
|
|
|
45
45
|
* the decision that authorized it. Absent on every call no one had to approve.
|
|
46
46
|
*/
|
|
47
47
|
decisionRef?: string;
|
|
48
|
+
/**
|
|
49
|
+
* #2904: the id of the approval seal of the answer `decisionRef` names (an `approvalSeals` row), set by the engine from
|
|
50
|
+
* the release that wrote it, never from the model or a request. A tool that RECORDS the decision (a sign-off, an
|
|
51
|
+
* acceptance) stores it beside the decider, so the record points at the signed evidence of what the person was shown
|
|
52
|
+
* and answered. Absent when the answer was not sealed: a decision answered before seals existed, or a host that binds
|
|
53
|
+
* no seal services. Its absence never changes whether the call may run.
|
|
54
|
+
*/
|
|
55
|
+
decisionSealId?: string;
|
|
48
56
|
/**
|
|
49
57
|
* Which door opened the turn this call belongs to (#1594), read by the engine from the execution ROW —
|
|
50
58
|
* at turn start and again at a decision's resume — never from the caller. It decides whether a gated call
|
|
@@ -62,6 +70,26 @@ export interface FunctionToolExecutionContext {
|
|
|
62
70
|
* `TOKENIZE`. Loaded by the engine from the conversation and stored again with the turn; a tool never needs it.
|
|
63
71
|
*/
|
|
64
72
|
personalDataPlaceholders?: PersonalDataPlaceholderTable;
|
|
73
|
+
/**
|
|
74
|
+
* #3295: on a resumed turn, the personal-data treatment the turn paused under. The paused messages are in the form it
|
|
75
|
+
* wrote, placeholders included, and only a guard under it can read them back, so the resume runs under at least this
|
|
76
|
+
* however the agent's declaration or an organization's policy has moved since. Its own field rather than an entry of the
|
|
77
|
+
* turn's policy frame: a frame applies only to the organizations it covers, and a call can name none, or another.
|
|
78
|
+
*/
|
|
79
|
+
heldPersonalDataTreatment?: FlowsActors_PersonalDataModelTreatment;
|
|
80
|
+
/**
|
|
81
|
+
* #3364 step 3: on a resumed turn, the output moderation its replies were judged under when it paused, tightened by the
|
|
82
|
+
* organizations whose records it had read. Those records stay in the paused messages, so the resume is judged under at
|
|
83
|
+
* least this (`OutputModerationGuard.tighten`).
|
|
84
|
+
*/
|
|
85
|
+
heldOutputModeration?: FlowsActors_OutputModerationPolicy;
|
|
86
|
+
/**
|
|
87
|
+
* #3313: told a function tool's `execute` is about to run, with the id of its call, once its arguments are final. The one
|
|
88
|
+
* point that means the call ran: the SDK reports an approved call it refused to run as a `tool-error`, so an error event
|
|
89
|
+
* says nothing about whether `execute` was reached. A resumed turn reads this to tell an accepted call that ran and failed
|
|
90
|
+
* from one that never ran.
|
|
91
|
+
*/
|
|
92
|
+
onFunctionToolExecuting?: (toolCallId: string) => void;
|
|
65
93
|
}
|
|
66
94
|
|
|
67
95
|
/**
|
|
@@ -202,6 +230,75 @@ export interface FunctionTool {
|
|
|
202
230
|
* tool without `argumentsResource` (and whose result is not `RECORDS_OF_RESOURCE`) accepts no placeholder at all.
|
|
203
231
|
*/
|
|
204
232
|
argumentsResource?: FunctionTool_ArgumentsResource;
|
|
233
|
+
/**
|
|
234
|
+
* The argument that names a FILE the person approves (#2904): a generated document, an agent's output file, a report to
|
|
235
|
+
* send. Declare it on an approval-gated tool whose call is about a file, so that what the person approves is the file's
|
|
236
|
+
* BYTES and not merely its id:
|
|
237
|
+
*
|
|
238
|
+
* - the decision's card binds the file by its content hash (hashed now when the file has none), so an answer given on a
|
|
239
|
+
* card shown before the file's recorded hash changed is refused as stale;
|
|
240
|
+
* - the approval's seal commits to `H(salt ‖ contentSha256)` and attests the file, which is then frozen while the seal
|
|
241
|
+
* exists (its bytes are not removed or replaced on request), and a verifier given the file's bytes reports a file
|
|
242
|
+
* changed since the approval;
|
|
243
|
+
* - an approver may not edit this argument: approving another file than the one shown is not an approval of it.
|
|
244
|
+
*
|
|
245
|
+
* A file the engine cannot hash (a remote reference whose vendor keeps the bytes, a deleted or missing file, a file of
|
|
246
|
+
* another organization) is shown and sealed as NOT bound, never bound to an empty hash.
|
|
247
|
+
*
|
|
248
|
+
* Registration refuses it on a tool that is not approval-gated, on a question tool, and when the tool's argument schema
|
|
249
|
+
* has no top-level string argument of that name. A tool without it is unaffected.
|
|
250
|
+
*/
|
|
251
|
+
deliverableFileArgument?: string;
|
|
252
|
+
/**
|
|
253
|
+
* The fields of the row the call acts on that the approval COVERS (#2914): the record's SEALED FIELD SET. Declare it
|
|
254
|
+
* on an approval-gated tool whose approval is a statement about a record's values (a month's figures signed off, an
|
|
255
|
+
* invoice's amounts approved), so that whether the approval still holds can be answered later:
|
|
256
|
+
*
|
|
257
|
+
* - the decision's card shows these values of the row named by `argumentsResource.rowIdArgument`, read as the system
|
|
258
|
+
* when the card is built, so the person approves what they read; a card read before one of them changed is refused
|
|
259
|
+
* as stale;
|
|
260
|
+
* - the approval's seal commits to them inside its presentation, and the currency check
|
|
261
|
+
* (`approvalSealSubjectCurrencyOf`, the operator door `POST /internal/admin/approval-seals/currency`, and
|
|
262
|
+
* `wildo seal verify --subject-record`) compares them with the record as it is: CURRENT right after the approval,
|
|
263
|
+
* NO_LONGER_CURRENT once one of them changes.
|
|
264
|
+
*
|
|
265
|
+
* Name only what the approval is ABOUT. Never a lifecycle or approval field (a status, `updatedAt`, the column the
|
|
266
|
+
* approved call writes the seal's id or the signer into): the approved call's own write would otherwise make its own
|
|
267
|
+
* seal look stale. A row of another organization than the decision's, or one that cannot be read, is shown and sealed
|
|
268
|
+
* with no record values, and so is an answer given on a chat card: no notice card shows the row, so its SENT seal
|
|
269
|
+
* claims none of it (its currency reads NO_SEALED_FIELD_SET).
|
|
270
|
+
*
|
|
271
|
+
* Registration refuses it on a tool that is not approval-gated, on a question tool, without
|
|
272
|
+
* `argumentsResource.rowIdArgument`, and when it names no field, a field twice, or a field the resource's main schema
|
|
273
|
+
* does not declare (checked when the resource is registered).
|
|
274
|
+
*/
|
|
275
|
+
sealedRecordFields?: readonly string[];
|
|
276
|
+
/**
|
|
277
|
+
* An approval of this tool on a row REPLACES the latest earlier approval of this tool on the same row (#2914): its seal
|
|
278
|
+
* names that earlier seal as the one it supersedes, as a decision answered again supersedes its own earlier seal. For a
|
|
279
|
+
* decision that is taken again on the same record after the record was reopened (a month signed off, reopened and
|
|
280
|
+
* signed off again): the two are different decisions, and without this the second seal names no predecessor, so a
|
|
281
|
+
* verifier sees two approvals of one record and nothing saying which one stands.
|
|
282
|
+
*
|
|
283
|
+
* Only the latest seal of the same source, the same record (`argumentsResource.rowIdArgument`) and the same tool is
|
|
284
|
+
* superseded, never an approval made through another tool on that row; a decision answered again still supersedes its
|
|
285
|
+
* own earlier answer first. Requires an approval gate and `argumentsResource.rowIdArgument`.
|
|
286
|
+
*/
|
|
287
|
+
approvalReplacesEarlierApprovalOfRow?: boolean;
|
|
288
|
+
/**
|
|
289
|
+
* The electronic signature the file deliverable needs once the person approved it (#2293): after the approval's seal is
|
|
290
|
+
* SEALED, the engine sends the approved file (`deliverableFileArgument`, bound by its hash) to the vendor selected for
|
|
291
|
+
* `ELECTRONIC_SIGNATURE`, for `signers` to sign at `requiredLevel`, and records a `signatureRequests` row. Only a
|
|
292
|
+
* validated signed document makes that request SIGNED. Opt-in per deliverable: a tool without it is unaffected.
|
|
293
|
+
*
|
|
294
|
+
* Requires `deliverableFileArgument`, an approval gate, and the `ELECTRONIC_SIGNATURE` capability enabled with a
|
|
295
|
+
* provider that applies `requiredLevel`: the application refuses to start otherwise, so a requirement nothing could meet
|
|
296
|
+
* is found before the first approval rather than after it.
|
|
297
|
+
*
|
|
298
|
+
* @example
|
|
299
|
+
* electronicSignature: { requiredLevel: ElectronicSignature_Level.ADVANCED, signers: [FunctionTool_SignerSource.APPROVER] },
|
|
300
|
+
*/
|
|
301
|
+
electronicSignature?: FunctionTool_ElectronicSignatureRequirement;
|
|
205
302
|
/**
|
|
206
303
|
* The tool IS a question to the person whose turn it is (#2720). Set by {@link askPersonTool}; do not set it on a
|
|
207
304
|
* tool you write by hand.
|
|
@@ -247,7 +344,13 @@ export interface FunctionTool {
|
|
|
247
344
|
*
|
|
248
345
|
* - `{ kind: RECORDS_OF_RESOURCE, resourceType }` — records of that resource: a record, or `{ data: [records] }`. Their
|
|
249
346
|
* personal fields are treated; for a tool that WRITES them, a placeholder in its arguments is put back too (only into
|
|
250
|
-
* a field of the same kind).
|
|
347
|
+
* a field of the same kind). A row of an organization-owned resource is treated under its organization's agent
|
|
348
|
+
* policy too (#2877), so the engine must know whose row it is (#3369). It does when the row keeps its
|
|
349
|
+
* `organizationId`, and for a `PRINCIPAL_RESOURCE_OPERATION` tool whatever the row keeps, because each dispatch
|
|
350
|
+
* records the owners of the rows it returned (as long as the operations it dispatches return rows naming their
|
|
351
|
+
* organization: a custom operation's answer that names none leaves the call's rows to the strictest policy). A tool reaching its rows any other way declares
|
|
352
|
+
* `rowsNameTheirOrganization: true` once every row it returns carries `organizationId`; without it, startup names the
|
|
353
|
+
* tool, and a row naming no organization read by an agent acting in none is treated under the strictest policy.
|
|
251
354
|
* - `{ kind: NOT_FROM_RECORDS, reason }` — nothing the engine moved from a record (an id list, a computed total, the
|
|
252
355
|
* answer a person chose to give). Say why: the reason is what a reviewer reads.
|
|
253
356
|
* - `{ kind: TREATED_BY_TOOL, treat }` — the tool knows its own shape and treats it (the engine's retrieval tool).
|
|
@@ -295,7 +398,17 @@ export enum FunctionToolPersonalDataOutputKind {
|
|
|
295
398
|
|
|
296
399
|
/** See {@link FunctionTool.personalDataOutput}. */
|
|
297
400
|
export type FunctionTool_PersonalDataOutput =
|
|
298
|
-
| {
|
|
401
|
+
| {
|
|
402
|
+
readonly kind: FunctionToolPersonalDataOutputKind.RECORDS_OF_RESOURCE;
|
|
403
|
+
readonly resourceType: ResourceType;
|
|
404
|
+
/**
|
|
405
|
+
* #3369: every row this tool returns carries its resource's `organizationId` (the organization row its own `_id`).
|
|
406
|
+
* For a tool that does not reach its rows through `dispatchResourceOperationAsTool`, whose owners the engine
|
|
407
|
+
* therefore cannot observe. Checked on every row: one that still names no organization is treated under the
|
|
408
|
+
* strictest policy, and counted on the call's operation record.
|
|
409
|
+
*/
|
|
410
|
+
readonly rowsNameTheirOrganization?: true;
|
|
411
|
+
}
|
|
299
412
|
| { readonly kind: FunctionToolPersonalDataOutputKind.NOT_FROM_RECORDS; readonly reason: string }
|
|
300
413
|
| {
|
|
301
414
|
readonly kind: FunctionToolPersonalDataOutputKind.TREATED_BY_TOOL;
|
|
@@ -354,6 +467,39 @@ export interface FunctionTool_HumanApprovalGate {
|
|
|
354
467
|
* ```
|
|
355
468
|
*/
|
|
356
469
|
requiredQualificationKinds?: readonly string[];
|
|
470
|
+
/**
|
|
471
|
+
* Whether the answer must carry a fresh step-up proof bound to THIS decision (#2923), as an operation approval's
|
|
472
|
+
* `requiresApproval.requiresStepUpAuthentication` does. The person re-proves a factor (`POST /auth/reauth` with a
|
|
473
|
+
* `decisionBinding` naming the decision and the presentation they answer) and answers from the decision inbox with it
|
|
474
|
+
* in `X-Reauth-Token`. A socket or chat answer carries no proof, so it is refused (`decision_step_up_required`).
|
|
475
|
+
*
|
|
476
|
+
* Use it when approving the call commits the person to something they must be present for: releasing a payment,
|
|
477
|
+
* signing off a filing. Applies to an agent's question (`askPersonTool`) the same way.
|
|
478
|
+
*/
|
|
479
|
+
requiresStepUpAuthentication?: boolean;
|
|
480
|
+
/**
|
|
481
|
+
* What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true`; startup refuses it without:
|
|
482
|
+
* `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven` (any step-up
|
|
483
|
+
* factor), `possession` (TOTP or a passkey) or `phishing_resistant` (a passkey). The approvers' user types must allow
|
|
484
|
+
* that factor as a step-up method. The factor and the instant it was proven are recorded on the decision and its
|
|
485
|
+
* approval seal (`decider.stepUpMethod`, `decider.stepUpAt`).
|
|
486
|
+
*
|
|
487
|
+
* ```ts
|
|
488
|
+
* humanApproval: {
|
|
489
|
+
* route: HumanDecision_RouteKind.ROLE, eligibleRole: 'treasurer',
|
|
490
|
+
* requiresStepUpAuthentication: true,
|
|
491
|
+
* stepUp: { maximumAgeSeconds: 120, minimumAssurance: HumanDecision_StepUpAssurance.PHISHING_RESISTANT },
|
|
492
|
+
* }
|
|
493
|
+
* ```
|
|
494
|
+
*/
|
|
495
|
+
stepUp?: HumanDecision_StepUpRequirement;
|
|
496
|
+
/**
|
|
497
|
+
* The channels that may answer the call (#2923): `web_session` (the application), `chat` (a chat card),
|
|
498
|
+
* `api_client` (a client the person delegated to). Absent: every channel the other requirements allow. A tool approval
|
|
499
|
+
* is decided in person, so `api_client` never answers one whatever this says; `chat` is refused beside a step-up, which
|
|
500
|
+
* a chat answer cannot carry. A chat card for a call it may not answer links to it in the application.
|
|
501
|
+
*/
|
|
502
|
+
answerChannels?: HumanDecision_AnswerChannels;
|
|
357
503
|
/**
|
|
358
504
|
* ASSIGNEE only: resolves the ONE person to route to, when the call pauses, from its arguments and
|
|
359
505
|
* context (for example, the record's account manager). Returning `undefined`, or a person without
|
|
@@ -516,6 +662,175 @@ export function functionToolArgumentsAreGuarded(tool: Pick<FunctionTool, 'effect
|
|
|
516
662
|
return tool.effect !== FunctionToolEffect.READ || personalDataArgumentsResourceOf(tool) !== undefined;
|
|
517
663
|
}
|
|
518
664
|
|
|
665
|
+
/** One date-text form per schema: the SDK and the decision door ask for it on every call. See {@link toolCallSchemaOf}. */
|
|
666
|
+
const TOOL_CALL_SCHEMAS = new WeakMap<z.ZodTypeAny, z.ZodTypeAny>();
|
|
667
|
+
|
|
668
|
+
/**
|
|
669
|
+
* A parse output with every `Date` put back to the text (or epoch number) it was read from in `raw`, at the same place; a
|
|
670
|
+
* `Date` with no such counterpart (one a transform or a default made) as its RFC 3339 text. Everything else as parsed.
|
|
671
|
+
*/
|
|
672
|
+
function withDateText(parsed: unknown, raw: unknown): unknown {
|
|
673
|
+
if (parsed instanceof Date) return typeof raw === 'string' || typeof raw === 'number' ? raw : parsed.toISOString();
|
|
674
|
+
if (Array.isArray(parsed)) return parsed.map((item, index) => withDateText(item, Array.isArray(raw) ? raw[index] : undefined));
|
|
675
|
+
if (parsed !== null && typeof parsed === 'object' && Object.getPrototypeOf(parsed) === Object.prototype) {
|
|
676
|
+
const rawFields = raw !== null && typeof raw === 'object' && !Array.isArray(raw) ? raw as Record<string, unknown> : {};
|
|
677
|
+
return Object.fromEntries(Object.entries(parsed).map(([key, value]) => [key, withDateText(value, Object.hasOwn(rawFields, key) ? rawFields[key] : undefined)]));
|
|
678
|
+
}
|
|
679
|
+
return parsed;
|
|
680
|
+
}
|
|
681
|
+
|
|
682
|
+
/**
|
|
683
|
+
* A tool's arguments as the SDK holds a call (#3489): validated by the schema's JSON form, every check, refinement and
|
|
684
|
+
* transform included, but with each DATE kept as the text it was written in rather than read into a `Date`.
|
|
685
|
+
*
|
|
686
|
+
* ## Why the SDK must never hold a `Date`
|
|
687
|
+
*
|
|
688
|
+
* The SDK treats a call's input as JSON data, and three of its mechanisms break on anything else:
|
|
689
|
+
* - an approval-gated call is paused and stored as JSON, and on approval the SDK requires that parsing the call again
|
|
690
|
+
* yields the stored input (`isDeepEqualData`). A `Date` comes back from storage as its text, so a date argument never
|
|
691
|
+
* compared equal and the call could never be approved;
|
|
692
|
+
* - the approval signature hashes the input with `canonicalJSON`, which writes a `Date` as `{}`: it covered no date's value;
|
|
693
|
+
* - a person's edit is stored as written, and a date parsed to a `Date` never equals the person's text either.
|
|
694
|
+
* spec-cite: N/A — read from the `ai@7.0.142` source (`generate-text/validate-tool-approvals.ts`, `util/is-deep-equal-data.ts`,
|
|
695
|
+
* `util/canonical-hash.ts`), which documents none of it.
|
|
696
|
+
*
|
|
697
|
+
* So the text stays text up to `execute`, where {@link argumentsAToolExecutesWith} reads the dates (a value walk, no second
|
|
698
|
+
* parse). The JSON Schema the model is told is the JSON form's own (a date is `string`, `date-time`): zod's pipe
|
|
699
|
+
* processor is mirrored, since the wrapper's own input side is `any`.
|
|
700
|
+
*
|
|
701
|
+
* Rejected: restoring the stored call's `Date`s at the resume. It made the stored input equal again, but left the
|
|
702
|
+
* signature blind to dates and an edit's text unequal; and the issue's other direction, refusing a gated tool that
|
|
703
|
+
* declares `z.date()`, would forbid what the framework teaches applications to declare.
|
|
704
|
+
*/
|
|
705
|
+
export function toolCallSchemaOf(schema: z.ZodTypeAny): z.ZodTypeAny {
|
|
706
|
+
const known = TOOL_CALL_SCHEMAS.get(schema);
|
|
707
|
+
if (known) return known;
|
|
708
|
+
const jsonForm = jsonParsingSchemaOf(schema);
|
|
709
|
+
const callForm = z.any().transform(async (raw, ctx) => {
|
|
710
|
+
const parsed = await jsonForm.safeParseAsync(raw);
|
|
711
|
+
if (!parsed.success) {
|
|
712
|
+
for (const issue of parsed.error.issues) ctx.addIssue({ ...issue } as never);
|
|
713
|
+
return z.NEVER;
|
|
714
|
+
}
|
|
715
|
+
return withDateText(parsed.data, raw);
|
|
716
|
+
});
|
|
717
|
+
callForm._zod.processJSONSchema = (ctx, _json, params) => {
|
|
718
|
+
z.core.process(jsonForm, ctx as never, params as never);
|
|
719
|
+
(ctx as unknown as { seen: Map<z.ZodTypeAny, { ref?: z.ZodTypeAny }> }).seen.get(callForm)!.ref = jsonForm;
|
|
720
|
+
};
|
|
721
|
+
TOOL_CALL_SCHEMAS.set(schema, callForm);
|
|
722
|
+
return callForm;
|
|
723
|
+
}
|
|
724
|
+
|
|
725
|
+
/**
|
|
726
|
+
* The schema the SDK validates this tool's calls against, which is also the one it revalidates an approved call with
|
|
727
|
+
* (#3295): the tool's own, or under `TOKENIZE` the form whose personal fields also accept a placeholder, since a personal
|
|
728
|
+
* value reaches the SDK as one. The ONE answer: the agent service hands it to the SDK and the decision door rehearses with
|
|
729
|
+
* it, so the two read one schema.
|
|
730
|
+
*
|
|
731
|
+
* In its call form ({@link toolCallSchemaOf}): validated as JSON (#3478), a date's text kept (#3489). A model writes a tool
|
|
732
|
+
* call as JSON, so a `z.date()` argument arrives as an RFC 3339 string; it is checked here, told to the model as `string`
|
|
733
|
+
* `date-time`, and read into a `Date` only for `execute`.
|
|
734
|
+
*/
|
|
735
|
+
export function sdkInputSchemaOfFunctionTool(
|
|
736
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
737
|
+
guard: PersonalDataGuard | undefined,
|
|
738
|
+
): z.ZodTypeAny {
|
|
739
|
+
const argumentsResource = guard !== undefined && functionToolArgumentsAreGuarded(tool) ? personalDataArgumentsResourceOf(tool) : undefined;
|
|
740
|
+
return toolCallSchemaOf(guard?.treatment === RedactionType.TOKENIZE && argumentsResource !== undefined
|
|
741
|
+
? placeholderTolerantInputSchema(tool.inputSchema, guard.personalFieldsOf(argumentsResource))
|
|
742
|
+
: tool.inputSchema);
|
|
743
|
+
}
|
|
744
|
+
|
|
745
|
+
/**
|
|
746
|
+
* The target fields of a guarded write whose tool names no resource for its arguments (#2848): none. Every issued
|
|
747
|
+
* placeholder is then refused ("that field does not hold data of the same kind"), as is every withheld marker and every
|
|
748
|
+
* placeholder the conversation did not issue, so the write can store only values the model actually wrote.
|
|
749
|
+
*/
|
|
750
|
+
const NO_PERSONAL_ARGUMENT_FIELDS: PersonalFieldMap = new Map();
|
|
751
|
+
|
|
752
|
+
/**
|
|
753
|
+
* What a tool's `execute` receives for the arguments the SDK hands it (#2292, #3295): under a guard, a placeholder is put
|
|
754
|
+
* back (only into a field of the same kind) and the result held to the tool's own schema, which the placeholder-tolerant
|
|
755
|
+
* one the model saw was not. Throws what the run would throw: a `PersonalDataPlaceholderRefusal` for a marker or a
|
|
756
|
+
* placeholder that cannot be put back, a schema error for a value the tool refuses.
|
|
757
|
+
*
|
|
758
|
+
* The ONE body of that step: `execute` runs it, and the decision door rehearses it before a decision settles, so a call
|
|
759
|
+
* cannot be recorded as accepted on an answer the run would refuse.
|
|
760
|
+
*/
|
|
761
|
+
export async function argumentsAToolRunsWith(
|
|
762
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
763
|
+
guard: PersonalDataGuard | undefined,
|
|
764
|
+
args: unknown,
|
|
765
|
+
): Promise<unknown> {
|
|
766
|
+
if (!functionToolArgumentsAreGuarded(tool)) return args;
|
|
767
|
+
if (guard === undefined) {
|
|
768
|
+
// #2877: an unguarded call can still hold a withheld marker in its messages: a row an organization outside the call's
|
|
769
|
+
// scope owns was withheld from its model (`treatRecordsResultByOwner`), and a resume after an approval pause runs with
|
|
770
|
+
// no guard of that call. A marker stands for a value nobody may store, so it is refused here whatever the call, and the
|
|
771
|
+
// decision door rehearses the same refusal. Nothing else changes for an unguarded call: no placeholder is put back and
|
|
772
|
+
// the arguments are not parsed again.
|
|
773
|
+
const carrying = argumentsCarryingWithheldMarkers(args);
|
|
774
|
+
if (carrying.length > 0) {
|
|
775
|
+
throw new PersonalDataPlaceholderRefusal(`${carrying.map((name) => `'${name}'`).join(', ')} carries a value you were not shown (⟦withheld:…⟧). Write a value you know, or leave the field out.`);
|
|
776
|
+
}
|
|
777
|
+
return args;
|
|
778
|
+
}
|
|
779
|
+
// Asynchronously, as the SDK validates: a tool may declare an async refinement, and `parse` would refuse every value of it.
|
|
780
|
+
// The tool's own schema in its call form (#3478, #3489): a date is checked and kept as its text, as the SDK holds it, so
|
|
781
|
+
// the decision door compares what a person read with what runs; `execute` reads it (`argumentsAToolExecutesWith`).
|
|
782
|
+
return toolCallSchemaOf(tool.inputSchema).parseAsync(guard.reidentifyArguments(args, argumentFieldsOf(tool, guard)));
|
|
783
|
+
}
|
|
784
|
+
|
|
785
|
+
/**
|
|
786
|
+
* What a tool's `execute` is called with (#3489): {@link argumentsAToolRunsWith}, with each date the tool's schema declares
|
|
787
|
+
* read into a `Date`. The SDK holds a date as its text ({@link toolCallSchemaOf}), so this is where the tool gets the
|
|
788
|
+
* `Date` its `z.date()` promises. A value walk on the schema's output side, never a second parse: the arguments are
|
|
789
|
+
* already validated, and a transform must not run twice.
|
|
790
|
+
*/
|
|
791
|
+
export async function argumentsAToolExecutesWith(
|
|
792
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
793
|
+
guard: PersonalDataGuard | undefined,
|
|
794
|
+
args: unknown,
|
|
795
|
+
): Promise<unknown> {
|
|
796
|
+
return ResourcesConfigOperationsDtosBuilderUtils.restoreStoredDates(await argumentsAToolRunsWith(tool, guard, args), tool.inputSchema);
|
|
797
|
+
}
|
|
798
|
+
|
|
799
|
+
function argumentFieldsOf(tool: Pick<FunctionTool, 'argumentsResource' | 'personalDataOutput'>, guard: PersonalDataGuard): PersonalFieldMap {
|
|
800
|
+
const argumentsResource = personalDataArgumentsResourceOf(tool);
|
|
801
|
+
return argumentsResource === undefined ? NO_PERSONAL_ARGUMENT_FIELDS : guard.personalFieldsOf(argumentsResource);
|
|
802
|
+
}
|
|
803
|
+
|
|
804
|
+
/**
|
|
805
|
+
* #3295: {@link argumentsAToolRunsWith} rehearsed for the decision door, which must say why rather than throw: what
|
|
806
|
+
* `execute` would receive (`ran`) beside the same arguments before its parse (`readAs`, the values a person reads), or the
|
|
807
|
+
* arguments that stop it, by name. A value that cannot be put back is named alone, by asking the guard field by field; a
|
|
808
|
+
* refusal it cannot place names every argument.
|
|
809
|
+
*/
|
|
810
|
+
export async function rehearsedToolArguments(
|
|
811
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
812
|
+
guard: PersonalDataGuard | undefined,
|
|
813
|
+
executedCopy: Record<string, unknown>,
|
|
814
|
+
): Promise<{ ran: unknown; readAs: unknown } | { refusedArguments: string[] }> {
|
|
815
|
+
const guarded = guard !== undefined && functionToolArgumentsAreGuarded(tool) ? guard : undefined;
|
|
816
|
+
try {
|
|
817
|
+
return {
|
|
818
|
+
ran: await argumentsAToolRunsWith(tool, guard, executedCopy),
|
|
819
|
+
readAs: guarded ? guarded.reidentifyArguments(executedCopy, argumentFieldsOf(tool, guarded)) : executedCopy,
|
|
820
|
+
};
|
|
821
|
+
} catch {
|
|
822
|
+
const unreadable = guarded === undefined ? argumentsCarryingWithheldMarkers(executedCopy) : Object.entries(executedCopy).filter(([name, value]) => {
|
|
823
|
+
try {
|
|
824
|
+
guarded.reidentifyArguments({ [name]: value }, argumentFieldsOf(tool, guarded));
|
|
825
|
+
return false;
|
|
826
|
+
} catch {
|
|
827
|
+
return true;
|
|
828
|
+
}
|
|
829
|
+
}).map(([name]) => name);
|
|
830
|
+
return { refusedArguments: (unreadable.length > 0 ? unreadable : Object.keys(executedCopy)).sort() };
|
|
831
|
+
}
|
|
832
|
+
}
|
|
833
|
+
|
|
519
834
|
/**
|
|
520
835
|
* Whether a turn's conversation is drawn for a person by the application: a turn over the application's own socket.
|
|
521
836
|
* A turn that records no door predates the door's recording and was a socket turn. Total over the vocabulary.
|
|
@@ -554,6 +869,13 @@ export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functi
|
|
|
554
869
|
throw new FunctionToolApprovalGateError(`Function tool "${tool.functionRef}" declares an approval gate nobody can answer: ${why}`);
|
|
555
870
|
};
|
|
556
871
|
refuseUnsoundDeadlines(tool.functionRef, gate);
|
|
872
|
+
// #2923: a step-up declaration that cannot mean what it says is refused here, at registration.
|
|
873
|
+
const stepUpIssues = [
|
|
874
|
+
...humanDecisionStepUpDeclarationIssues(gate, 'humanApproval'),
|
|
875
|
+
// #2923: and a channel declaration that names a channel that could never answer it.
|
|
876
|
+
...humanDecisionAnswerChannelsIssues(gate.answerChannels, humanDecisionStepUpRequirementOf(gate) !== undefined, 'humanApproval'),
|
|
877
|
+
];
|
|
878
|
+
if (stepUpIssues.length > 0) refuse(stepUpIssues.join(' '));
|
|
557
879
|
// #2967: a required qualification names a kind, once each. Whether the application DECLARES it needs the configuration,
|
|
558
880
|
// which a tool does not see: the startup validator asks that.
|
|
559
881
|
const requiredKinds = gate.requiredQualificationKinds ?? [];
|
|
@@ -582,4 +904,115 @@ export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functi
|
|
|
582
904
|
}
|
|
583
905
|
}
|
|
584
906
|
}
|
|
907
|
+
/**
|
|
908
|
+
* Who signs a deliverable sent for electronic signature (#2293). A closed vocabulary: each member names where the person
|
|
909
|
+
* comes from, so nothing the model wrote picks a signer.
|
|
910
|
+
*/
|
|
911
|
+
export enum FunctionTool_SignerSource {
|
|
912
|
+
/** The person whose approval of the call was sealed: the approver signs what they approved. */
|
|
913
|
+
APPROVER = 'approver',
|
|
914
|
+
}
|
|
915
|
+
|
|
916
|
+
/** A tool's electronic-signature requirement for its file deliverable (`FunctionTool.electronicSignature`, #2293). */
|
|
917
|
+
export interface FunctionTool_ElectronicSignatureRequirement {
|
|
918
|
+
readonly requiredLevel: ElectronicSignature_Level;
|
|
919
|
+
/** Who signs, in signing order. At least one; each source once. */
|
|
920
|
+
readonly signers: readonly FunctionTool_SignerSource[];
|
|
921
|
+
}
|
|
922
|
+
|
|
923
|
+
/**
|
|
924
|
+
* What is wrong with a tool's electronic-signature requirement (`electronicSignature`, #2293), one sentence per problem
|
|
925
|
+
* with its remedy; empty when it is sound or absent. Read at registration, beside the deliverable's own declaration.
|
|
926
|
+
*/
|
|
927
|
+
export function functionToolElectronicSignatureDeclarationProblems(
|
|
928
|
+
tool: Pick<FunctionTool, 'functionRef' | 'electronicSignature' | 'deliverableFileArgument'>,
|
|
929
|
+
): string[] {
|
|
930
|
+
const requirement = tool.electronicSignature;
|
|
931
|
+
if (requirement === undefined) return [];
|
|
932
|
+
const named = `Function tool "${tool.functionRef}" declares electronicSignature`;
|
|
933
|
+
const problems: string[] = [];
|
|
934
|
+
if (!tool.deliverableFileArgument) problems.push(`${named} and no deliverableFileArgument: only a file deliverable the approver approved by its hash can be sent for signature.`);
|
|
935
|
+
if (!Object.values(ElectronicSignature_Level).includes(requirement.requiredLevel)) problems.push(`${named} with an unknown requiredLevel "${String(requirement.requiredLevel)}".`);
|
|
936
|
+
const signers = Array.isArray(requirement.signers) ? requirement.signers : [];
|
|
937
|
+
if (signers.length === 0) problems.push(`${named} with no signer: name at least one (FunctionTool_SignerSource).`);
|
|
938
|
+
if (signers.some((signer) => !Object.values(FunctionTool_SignerSource).includes(signer))) problems.push(`${named} with an unknown signer source.`);
|
|
939
|
+
if (new Set(signers).size !== signers.length) problems.push(`${named} naming one signer source twice.`);
|
|
940
|
+
return problems;
|
|
941
|
+
}
|
|
942
|
+
|
|
943
|
+
/**
|
|
944
|
+
* What is wrong with a tool's file-deliverable declaration (`deliverableFileArgument`, #2904), one sentence per problem
|
|
945
|
+
* with its remedy; empty when it is sound or absent. Read at registration, on the schema the tool is registered with
|
|
946
|
+
* (after `bindToResources`), so the argument the engine binds is the one the model is offered.
|
|
947
|
+
*/
|
|
948
|
+
export function functionToolDeliverableDeclarationProblems(
|
|
949
|
+
tool: Pick<FunctionTool, 'functionRef' | 'deliverableFileArgument' | 'inputSchema' | 'requiresHumanApproval' | 'humanApproval' | 'asksThePerson'>,
|
|
950
|
+
): string[] {
|
|
951
|
+
const argument = tool.deliverableFileArgument;
|
|
952
|
+
if (argument === undefined) return [];
|
|
953
|
+
const problems: string[] = [];
|
|
954
|
+
const named = `Function tool "${tool.functionRef}" declares deliverableFileArgument "${String(argument)}"`;
|
|
955
|
+
if (typeof argument !== 'string' || argument.trim().length === 0) return [`${named}, which names no argument: name the argument holding the file's id.`];
|
|
956
|
+
if (!tool.humanApproval && !tool.requiresHumanApproval) {
|
|
957
|
+
problems.push(`${named} and is not approval-gated: a file deliverable is bound by the approval of the call, so gate it (humanApproval or requiresHumanApproval).`);
|
|
958
|
+
}
|
|
959
|
+
if (tool.asksThePerson) problems.push(`${named} and asks the person: a question approves no file.`);
|
|
960
|
+
const shape = tool.inputSchema instanceof z.ZodObject ? (tool.inputSchema.shape as Record<string, z.ZodTypeAny>) : undefined;
|
|
961
|
+
const declared = shape?.[argument];
|
|
962
|
+
if (!declared) {
|
|
963
|
+
problems.push(`${named}, which is not a top-level argument of its input schema: declare it there as the file's id (a string).`);
|
|
964
|
+
} else if (!isStringArgumentSchema(declared)) {
|
|
965
|
+
problems.push(`${named}, which is not a string argument: a file deliverable is named by its file id.`);
|
|
966
|
+
}
|
|
967
|
+
return problems;
|
|
968
|
+
}
|
|
969
|
+
|
|
970
|
+
/**
|
|
971
|
+
* What is wrong with a tool's record-approval declarations (`sealedRecordFields`, `approvalReplacesEarlierApprovalOfRow`,
|
|
972
|
+
* #2914), one sentence per problem with its remedy; empty when they are sound or absent. `declaredFieldsOf` answers the
|
|
973
|
+
* fields the resource's main schema declares, or undefined when the resource is not registered (its fields are then not
|
|
974
|
+
* checked here: a field the row does not hold is shown and sealed as absent).
|
|
975
|
+
*/
|
|
976
|
+
export function functionToolRecordApprovalDeclarationProblems(
|
|
977
|
+
tool: Pick<FunctionTool, 'functionRef' | 'sealedRecordFields' | 'approvalReplacesEarlierApprovalOfRow' | 'argumentsResource' | 'requiresHumanApproval' | 'humanApproval' | 'asksThePerson'>,
|
|
978
|
+
declaredFieldsOf?: (resourceType: string) => readonly string[] | undefined,
|
|
979
|
+
): string[] {
|
|
980
|
+
const fields = tool.sealedRecordFields;
|
|
981
|
+
const replaces = tool.approvalReplacesEarlierApprovalOfRow === true;
|
|
982
|
+
if (fields === undefined && !replaces) return [];
|
|
983
|
+
const problems: string[] = [];
|
|
984
|
+
const named = `Function tool "${tool.functionRef}" declares ${fields !== undefined ? 'sealedRecordFields' : 'approvalReplacesEarlierApprovalOfRow'}`;
|
|
985
|
+
if (!tool.humanApproval && !tool.requiresHumanApproval) {
|
|
986
|
+
problems.push(`${named} and is not approval-gated: it describes what an approval covers, so gate it (humanApproval or requiresHumanApproval).`);
|
|
987
|
+
}
|
|
988
|
+
if (tool.asksThePerson) problems.push(`${named} and asks the person: a question approves no record.`);
|
|
989
|
+
if (!tool.argumentsResource?.rowIdArgument) {
|
|
990
|
+
problems.push(`${named} without argumentsResource.rowIdArgument: name the argument holding the id of the row the approval is about.`);
|
|
991
|
+
}
|
|
992
|
+
if (fields !== undefined) {
|
|
993
|
+
if (!Array.isArray(fields) || fields.length === 0 || fields.some((field) => typeof field !== 'string' || field.trim().length === 0)) {
|
|
994
|
+
problems.push(`${named}, which names no field: list the fields of the row the approval covers.`);
|
|
995
|
+
} else {
|
|
996
|
+
const duplicated = fields.filter((field, index) => fields.indexOf(field) !== index);
|
|
997
|
+
if (duplicated.length > 0) problems.push(`${named}, which names ${[...new Set(duplicated)].join(', ')} more than once.`);
|
|
998
|
+
const declared = tool.argumentsResource ? declaredFieldsOf?.(tool.argumentsResource.resourceType) : undefined;
|
|
999
|
+
const unknown = declared ? fields.filter((field) => !declared.includes(field)) : [];
|
|
1000
|
+
if (unknown.length > 0) problems.push(`${named}, naming ${unknown.join(', ')}, which ${tool.argumentsResource!.resourceType} does not declare.`);
|
|
1001
|
+
}
|
|
1002
|
+
}
|
|
1003
|
+
return problems;
|
|
1004
|
+
}
|
|
1005
|
+
|
|
1006
|
+
/** Whether an argument schema is a string once its optional, nullable and default wrappers are removed. */
|
|
1007
|
+
function isStringArgumentSchema(schema: z.ZodTypeAny): boolean {
|
|
1008
|
+
let current: z.ZodTypeAny = schema;
|
|
1009
|
+
for (let depth = 0; depth < 8; depth += 1) {
|
|
1010
|
+
if (current instanceof z.ZodOptional || current instanceof z.ZodNullable || current instanceof z.ZodDefault) {
|
|
1011
|
+
current = current.def.innerType as z.ZodTypeAny;
|
|
1012
|
+
continue;
|
|
1013
|
+
}
|
|
1014
|
+
return current instanceof z.ZodString || (current as { def?: { type?: unknown } }).def?.type === 'string';
|
|
1015
|
+
}
|
|
1016
|
+
return false;
|
|
1017
|
+
}
|
|
585
1018
|
```
|
|
@@ -43,13 +43,15 @@
|
|
|
43
43
|
* delivered on a STREAMED operation (`STREAM_TEXT`, `STREAM_STRUCTURED`) throws
|
|
44
44
|
* `AgentModelCallFailedError` instead (exported from `@wildo-ai/saas-backend-lib`, not a
|
|
45
45
|
* backend error: test it with `instanceof`), carrying the provider's error, its HTTP
|
|
46
|
-
* `statusCode` when it refused, and the `usage` of the steps that finished first. Inside a flow run,
|
|
46
|
+
* `statusCode` when it refused, and the `usage` of the steps that finished first. Inside a flow run, or
|
|
47
|
+
* outside any turn or flow for work attributed to an organization (your own operation or handler, #2957), a
|
|
47
48
|
* `FEATURE_LIMIT_EXCEEDED` backend error when the organization's model allowance is spent, or `INFRASTRUCTURE`
|
|
48
49
|
* when it cannot be checked, before the model is called (#2935).
|
|
49
50
|
*
|
|
50
51
|
* Every call is charged to the model allowance of the work it is made in (#2935): the conversational turn or flow
|
|
51
|
-
* run around it, else the organization its work is attributed to
|
|
52
|
-
* an estimate. Application code needs to do nothing for
|
|
52
|
+
* run around it, else the organization its work is attributed to, whose allowance is also asked before the call
|
|
53
|
+
* (#2957). A call whose provider reported no usage is charged an estimate. Application code needs to do nothing for
|
|
54
|
+
* this, except pass `attribution` when its work is attributed to no organization otherwise.
|
|
53
55
|
*/
|
|
54
56
|
public async invokeAgent(
|
|
55
57
|
request: FlowsActors_Agent_Invocation<any, any, any>,
|
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
*
|
|
45
45
|
* **Narrowing by a field's value.** The tool also offers `filters`: the filter fields the resource's
|
|
46
46
|
* default SEARCH declares (else its LIST), each as it accepts values — one of an enum's values, a
|
|
47
|
-
* string, a number, a boolean, or a `{ startDate, endDate }` / `{ min, max }` range. They are bound
|
|
47
|
+
* string, a number, a boolean, or a `{ startDate, endDate }` / `{ min, max }` / `{ startMonth, endMonth }` range. They are bound
|
|
48
48
|
* when the tool is registered, from the operation it dispatches, so the model is offered what that
|
|
49
49
|
* operation's repository allows — less the primary scope's field (`organizationId`), which the
|
|
50
50
|
* conversation's own context decides. A question about a status or a category is a filter, never a
|
|
@@ -29,10 +29,15 @@
|
|
|
29
29
|
* with the ACL unread. On `organizations` CREATE that combination created ownerless tenants.
|
|
30
30
|
*
|
|
31
31
|
* A resource that declares no URL-bearing default for the operation is REFUSED rather than written
|
|
32
|
-
* through its internal variant.
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
32
|
+
* through its internal variant. Owner FKs and other server-set fields are EC-injected / `excludeFromCreate`,
|
|
33
|
+
* so the model can never spoof ownership through the tool arguments.
|
|
34
|
+
*
|
|
35
|
+
* **Retries.** A model calls a write tool again when a call fails, so an operation that declares
|
|
36
|
+
* `idempotencyKey` takes the key as the `idempotencyKey` ARGUMENT: add
|
|
37
|
+
* `idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION)` to `inputSchema` (`.optional()` for an
|
|
38
|
+
* `ACCEPTED` operation). The factory takes it out of the fields and the framework answers the model's retry
|
|
39
|
+
* with the first result instead of writing twice. A `REQUIRED` operation called without it is refused before
|
|
40
|
+
* anything runs, naming the argument.
|
|
36
41
|
*
|
|
37
42
|
* Unlike the read tool (whose args are a fixed `{ searchQuery, limit }`), a write
|
|
38
43
|
* tool's arguments are resource-specific, so the caller MUST supply the model-facing
|
|
@@ -18,7 +18,8 @@
|
|
|
18
18
|
*
|
|
19
19
|
* @throws NOT_FOUND for an unknown flow; VALIDATION for an inactive flow, an ambiguous or unknown trigger, or a `caseRef`
|
|
20
20
|
* on a resource that is not a work unit; AUTHORIZATION for a requester who is not a person or whose membership
|
|
21
|
-
* of `organizationId` does not hold,
|
|
21
|
+
* of `organizationId` does not hold, who holds none of the roles the flow's `config.accessControl[].roles`
|
|
22
|
+
* opens it to in that organization (`flow_requester_role_not_held`, recorded on the denial trail), or whose rebuilt authority acts in another organization
|
|
22
23
|
* (`flow_requester_not_in_run_organization`, #2935: its model spend would be charged to the wrong allowance); CONFLICT (`ACTOR_EXECUTION_SUBJECT_BUSY`) while another run of the flow
|
|
23
24
|
* that is starting or continuing holds `exclusiveSubject`. A run WAITING on a person holds no subject: refuse
|
|
24
25
|
* a second run yourself when one may be waiting (list the flow's open runs).
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# saas.backend.privacy.subject-export-archive
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The archive a PORTABILITY export is delivered as, from `@wildo-ai/saas-backend-lib`:
|
|
14
|
+
* `writeSubjectExportArchive(bundle, output: Writable): Promise<{ bytesWritten }>` streams `export.json` (the report,
|
|
15
|
+
* the rows, the verification keys and a manifest of the files) and then each `bundle.fileContents` part at its `path`.
|
|
16
|
+
* It rejects, leaving `output` unfinished, when a file's bytes do not verify or the archive would pass 4 GiB: the caller
|
|
17
|
+
* owns `output` and must discard it then. `exportSubjectAsSystem(…, { fileContents: { maxTotalBytes } })` takes a
|
|
18
|
+
* bound between 1 byte and the ceiling below.
|
|
19
|
+
*/
|
|
20
|
+
/** The archive's JSON entry: the report, the rows, the verification keys and the file manifest. */
|
|
21
|
+
export const SUBJECT_EXPORT_ARCHIVE_JSON_PATH = 'export.json';
|
|
22
|
+
/** The default bound on a portability export's file bytes: 2 GiB. */
|
|
23
|
+
export const SUBJECT_EXPORT_FILE_CONTENT_DEFAULT_MAX_BYTES = 2 * 1024 ** 3;
|
|
24
|
+
/** The highest bound a caller may set: 3 GiB, below the 4 GiB a ZIP without ZIP64 can address, leaving room for the JSON. */
|
|
25
|
+
export const SUBJECT_EXPORT_FILE_CONTENT_MAX_BYTES_CEILING = 3 * 1024 ** 3;
|
|
26
|
+
```
|