@wildo-ai/framework-knowledge 1.1.10 → 1.1.12
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 +7 -5
- 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 +628 -107
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +90 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- 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 +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- 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 +10 -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 +82 -15
- 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 +1 -5
- 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 +4 -16
- 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 +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 +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 +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- 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 +38 -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 +20 -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 +29 -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 +80 -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 +2 -2
- 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 +7 -2
- 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 +6 -2
- 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 +4 -3
- 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 +26 -7
- 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 +23 -6
- 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.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 +7 -3
- 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.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 +9 -7
- 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 +9 -2
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.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 +5 -2
- 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 +15 -5
- 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.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 +7 -3
- 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 +6 -4
- 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.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.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 +24 -9
- 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 +8 -2
- 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 +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +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.js.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.js.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 +98 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +124 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- 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 +39 -20
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- 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 +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +12 -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 +788 -49
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +18 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +451 -16
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +3 -6
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +4 -3
- 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 +115 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +71 -7
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +19 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +126 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +28 -9
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +67 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +10 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +21 -3
- 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 -5
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +5 -2
- 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 +153 -28
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +36 -7
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +9 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +2 -1
- 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/method.md +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +17 -5
- 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 +49 -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 +15 -5
- 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 +10 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +14 -5
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -1
- 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/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +8 -1
- 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 +216 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +108 -0
- 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 +21 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +63 -18
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- 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 +28 -2
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +57 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +65 -13
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +463 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +438 -12
- package/dist/knowledge/references/business-model.pricing-plan.config.md +19 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +29 -8
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- 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 +342 -76
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +16 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -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 +47 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +78 -19
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +34 -63
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- 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.module.relationships.scope-membership-junction.md +8 -10
- 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.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +38 -4
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -5
- 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.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +87 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +80 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +20 -21
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- 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.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- 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.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +127 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +8 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +13 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +168 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +72 -8
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +235 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1272 -3
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- 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 +28 -8
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +94 -13
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +140 -7
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +282 -0
- package/dist/knowledge/references/platform.config.saas.md +126 -32
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- 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.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +11 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +47 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +158 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +85 -12
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +179 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- 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.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- 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 +105 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +7 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +35 -4
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +219 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +661 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +15 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +28 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- 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.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +394 -104
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -10
- 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.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- 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.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +92 -23
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +57 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +14 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +184 -5
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +59 -19
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +344 -62
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -8
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +183 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +72 -13
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +175 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +54 -74
- package/dist/knowledge/references/saas.models.conversation-threads.md +43 -6
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +32 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +29 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +442 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +91 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -79
- package/dist/knowledge/references/saas.models.engine-capabilities.md +39 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +96 -26
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +321 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +154 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +70 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +349 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +4 -3
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +274 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +176 -50
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +75 -3
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +28 -3
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +259 -21
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +74 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +51 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +933 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +228 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +291 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +114 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +114 -7
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +73 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- 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 +280 -40
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +38 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +20 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +52 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -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.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +165 -44
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +92 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- 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-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +137 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +23 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +46 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +12 -6
- package/dist/knowledge/references/saas.models.schema-family-builder.md +32 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -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 +123 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +19 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +110 -14
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -25
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +287 -17
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +30 -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 +22 -4
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +44 -5
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +113 -70
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +77 -14
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +49 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +105 -49
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +106 -9
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +115 -87
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +188 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +5 -2
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +26 -3
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +4 -3
- package/dist/knowledge/references/saas.website.label-pack.validator.md +9 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +303 -0
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/website-plan.config.md +544 -32
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +133 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +124 -34
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +99 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +34 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +10 -8
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +6 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +52 -18
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +107 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +193 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +5250 -2565
- package/dist/knowledge/registries/playbooks.json +88 -55
- package/dist/knowledge/registries/source-tags.json +9347 -4807
- package/dist/knowledge/rules/database-migration-obligation.md +10 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +62 -33
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +227 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +16 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +376 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- 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 +26 -9
- 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 +37 -1
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +24 -7
- 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 +168 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +92 -0
- 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 +66 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +108 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +81 -10
- 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-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +5 -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 +79 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +191 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- 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 +166 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +307 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +179 -37
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +48 -11
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +896 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +184 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +487 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +62 -29
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- 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 +21 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +38 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +278 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +12 -1
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +4 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -6
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +333 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +83 -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 -10
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1370 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +77 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +171 -26
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +126 -32
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +16 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- 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-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +167 -84
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +20 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +38 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- 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 +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +47 -6
- 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 +10 -2
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +102 -23
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +103 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +35 -4
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +71 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +298 -26
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +78 -19
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +455 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +446 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +174 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- 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 +10 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +69 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +695 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +124 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +276 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +120 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +283 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +134 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +78 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +16 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -19
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +166 -21
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +35 -3
- 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 +93 -13
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +49 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +245 -27
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +471 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +44 -5
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +39 -16
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +226 -73
- 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 +140 -7
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +370 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- 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/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- 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 +7 -5
- 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-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +33 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +42 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +49 -7
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +63 -9
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +43 -11
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +58 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +257 -46
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +30 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +110 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +143 -119
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1259 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +555 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +163 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +149 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +98 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +388 -11
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +31 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- 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 +13 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +755 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +235 -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 +72 -8
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +11 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +50 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +41 -15
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1275 -4
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +451 -67
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +57 -8
- 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 +165 -44
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +138 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +171 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +8 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +371 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +51 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +163 -0
- 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 +200 -61
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +8 -3
- 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 +8 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +351 -159
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +160 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +440 -119
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +426 -32
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +344 -62
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +326 -76
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +96 -26
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +257 -57
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +147 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +62 -15
- 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/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +65 -18
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +77 -7
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +25 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +18 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +42 -3
- 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 +21 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +114 -7
- 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 +46 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +27 -11
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +13 -8
- 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 +4 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +105 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +150 -35
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +32 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +58 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +107 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +200 -69
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +326 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +7 -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 +219 -77
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +105 -24
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +131 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +428 -72
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- 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 +223 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +186 -65
- 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 +138 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +89 -32
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +73 -0
- 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/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +48 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +72 -13
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- 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 +30 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- 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 +186 -83
- 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 +113 -70
- 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-add-composite-view/SKILL.md +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -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 +41 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- 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 +15 -4
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +57 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +253 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1105 -222
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +42 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +20 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +43 -21
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +29 -5
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +409 -186
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +399 -235
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +562 -303
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +648 -275
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +573 -265
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +533 -234
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +604 -333
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +594 -379
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +189 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +5 -2
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +740 -316
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +576 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17998 -8568
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +0 -169
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -16,6 +16,8 @@
|
|
|
16
16
|
* the tool may use. The engine supplies this at call time; a tool never fabricates
|
|
17
17
|
* identity from the model's arguments.
|
|
18
18
|
*
|
|
19
|
+
* assurance-control: WILDO.AI.AGENT_AUTHORITY_CONFINEMENT — a tool acts on its caller's server-verified authority, which the model can never supply.
|
|
20
|
+
*
|
|
19
21
|
* Import path: `@wildo-ai/saas-backend-lib`.
|
|
20
22
|
*/
|
|
21
23
|
export interface FunctionToolExecutionContext {
|
|
@@ -43,6 +45,14 @@ export interface FunctionToolExecutionContext {
|
|
|
43
45
|
* the decision that authorized it. Absent on every call no one had to approve.
|
|
44
46
|
*/
|
|
45
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;
|
|
46
56
|
/**
|
|
47
57
|
* Which door opened the turn this call belongs to (#1594), read by the engine from the execution ROW —
|
|
48
58
|
* at turn start and again at a decision's resume — never from the caller. It decides whether a gated call
|
|
@@ -55,6 +65,31 @@ export interface FunctionToolExecutionContext {
|
|
|
55
65
|
* reviewer — see {@link FunctionTool.effect}.
|
|
56
66
|
*/
|
|
57
67
|
autonomousTrigger?: AutonomousTurnTrigger;
|
|
68
|
+
/**
|
|
69
|
+
* #2292: this conversation's personal-data placeholders, when its agent declares `contentGuardrails.personalData` with
|
|
70
|
+
* `TOKENIZE`. Loaded by the engine from the conversation and stored again with the turn; a tool never needs it.
|
|
71
|
+
*/
|
|
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;
|
|
58
93
|
}
|
|
59
94
|
|
|
60
95
|
/**
|
|
@@ -90,16 +125,34 @@ export enum FunctionToolEffect {
|
|
|
90
125
|
* functionRef: 'demo.echo',
|
|
91
126
|
* description: 'Echo the provided text back.',
|
|
92
127
|
* inputSchema: z.object({ text: z.string() }),
|
|
128
|
+
* effect: FunctionToolEffect.READ,
|
|
129
|
+
* // A hand-written tool says how it reaches data (#2839): this one reaches none.
|
|
130
|
+
* authority: { kind: FunctionToolAuthorityKind.NO_APPLICATION_DATA, reason: 'It returns its own argument.' },
|
|
93
131
|
* execute: async (args) => ({ echoed: args.text }),
|
|
94
132
|
* };
|
|
95
133
|
*/
|
|
96
134
|
export interface FunctionTool {
|
|
97
135
|
/** Stable id referenced from `agent.capabilities.tools.functionRefs`. */
|
|
98
136
|
functionRef: string;
|
|
99
|
-
/**
|
|
137
|
+
/**
|
|
138
|
+
* Natural-language description shown to the model (what the tool does + when).
|
|
139
|
+
*
|
|
140
|
+
* It is also the intent the labelling pipeline words the tool from for a PERSON (#2551): the title of the call's card
|
|
141
|
+
* in the conversation and its working line, `flows_actors_tools.<model tool name>.{title,working}`, generated by
|
|
142
|
+
* `wildo generate labels`. So say what the tool does for the person, not only how the model should call it.
|
|
143
|
+
*/
|
|
100
144
|
description: string;
|
|
101
145
|
/** Zod schema of the tool's arguments (surfaced to the model). */
|
|
102
146
|
inputSchema: z.ZodTypeAny;
|
|
147
|
+
/**
|
|
148
|
+
* The tool's arguments as the application's RESOURCES declare them. Called ONCE, when the tool is registered (both
|
|
149
|
+
* hosts register resources first; a host that does not keeps the authored schema, with a warning); what it answers
|
|
150
|
+
* REPLACES `inputSchema` and `description` for every reader — the
|
|
151
|
+
* model, an approval card, an approval's validation — so all of them read one schema. For a tool whose arguments ARE a
|
|
152
|
+
* resource's declaration: {@link resourceReadTool} offers the filters its resource's search declares. Answering
|
|
153
|
+
* `undefined` keeps the authored schema and description.
|
|
154
|
+
*/
|
|
155
|
+
bindToResources?: (resources: FunctionToolResourceDeclarations) => Pick<FunctionTool, 'inputSchema' | 'description'> | undefined;
|
|
103
156
|
/** Execute the tool with validated args under the caller's context. */
|
|
104
157
|
execute: (args: any, context: FunctionToolExecutionContext) => Promise<unknown>;
|
|
105
158
|
/**
|
|
@@ -153,6 +206,185 @@ export interface FunctionTool {
|
|
|
153
206
|
* tool you write by hand.
|
|
154
207
|
*/
|
|
155
208
|
effect?: FunctionToolEffect;
|
|
209
|
+
/**
|
|
210
|
+
* The resource whose fields this tool's arguments are (#1923). When a decider's decision on a call is exported as
|
|
211
|
+
* evaluation data, an argument is an identifier if the tool's `inputSchema` OR this resource's own schema declares it
|
|
212
|
+
* one (`.isForeignKey()`, `.isPrimaryKey()`, `IDENTITY` / `CONTACT_DETAILS` data), so a tool whose argument schema
|
|
213
|
+
* restates a resource field without its decorators still has the field's meaning. `rowIdArgument` names the
|
|
214
|
+
* argument that addresses the row (the row's own id). `resourceWriteTool` declares both for you.
|
|
215
|
+
*
|
|
216
|
+
* It also decides who sees a gated call's decision (#2734). The card shows the call's arguments, so a representative
|
|
217
|
+
* (someone working in the organization through an organization relationship) is shown and may answer it only when
|
|
218
|
+
* their relationship may read the row `rowIdArgument` names. Without a declared row, the decision goes to the
|
|
219
|
+
* organization's own staff and to representatives of the requester's own relationship only. An edit from someone
|
|
220
|
+
* answering only through a relationship may not point the row at a record their relationship cannot read, nor turn the
|
|
221
|
+
* row argument into something that names no record, nor change an argument that is, or contains at any depth, a field
|
|
222
|
+
* declared `.isForeignKey()` on the tool's argument schema or on any schema of this resource; and an edit the engine
|
|
223
|
+
* cannot judge (this resource can no longer be read) is refused to them too. An argument that addresses a record without that declaration is not recognized, so
|
|
224
|
+
* declare it. Declare `argumentsResource` on every write tool whose decisions representatives should answer.
|
|
225
|
+
*
|
|
226
|
+
* And it decides where a guarded agent's placeholders may go (#2292, #2848). For an agent that declares
|
|
227
|
+
* `contentGuardrails.personalData`, the arguments of every tool that can change something are checked before it runs:
|
|
228
|
+
* a `⟦withheld:…⟧` marker or a placeholder the conversation did not issue is refused whatever the tool declares, and
|
|
229
|
+
* an issued placeholder is put back only into a field this resource declares to hold data of the same kind. A write
|
|
230
|
+
* tool without `argumentsResource` (and whose result is not `RECORDS_OF_RESOURCE`) accepts no placeholder at all.
|
|
231
|
+
*/
|
|
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 electronic signature the file deliverable needs once the person approved it (#2293): after the approval's seal is
|
|
254
|
+
* SEALED, the engine sends the approved file (`deliverableFileArgument`, bound by its hash) to the vendor selected for
|
|
255
|
+
* `ELECTRONIC_SIGNATURE`, for `signers` to sign at `requiredLevel`, and records a `signatureRequests` row. Only a
|
|
256
|
+
* validated signed document makes that request SIGNED. Opt-in per deliverable: a tool without it is unaffected.
|
|
257
|
+
*
|
|
258
|
+
* Requires `deliverableFileArgument`, an approval gate, and the `ELECTRONIC_SIGNATURE` capability enabled with a
|
|
259
|
+
* provider that applies `requiredLevel`: the application refuses to start otherwise, so a requirement nothing could meet
|
|
260
|
+
* is found before the first approval rather than after it.
|
|
261
|
+
*
|
|
262
|
+
* @example
|
|
263
|
+
* electronicSignature: { requiredLevel: ElectronicSignature_Level.ADVANCED, signers: [FunctionTool_SignerSource.APPROVER] },
|
|
264
|
+
*/
|
|
265
|
+
electronicSignature?: FunctionTool_ElectronicSignatureRequirement;
|
|
266
|
+
/**
|
|
267
|
+
* The tool IS a question to the person whose turn it is (#2720). Set by {@link askPersonTool}; do not set it on a
|
|
268
|
+
* tool you write by hand.
|
|
269
|
+
*
|
|
270
|
+
* Its approval is not an approval: the turn pauses on the call as on any gated tool, but the person is shown the
|
|
271
|
+
* call's QUESTIONS through a form and answers them, and the answer becomes the tool's result. Such a pause is settled
|
|
272
|
+
* by an answer carrying the person's values, or by declining, and never by a bare approve, which would run the tool
|
|
273
|
+
* on whatever answers the model wrote. It must be gated on the OWNER route: only the person in the conversation
|
|
274
|
+
* answers it (a question to a reviewer belongs to an actor system's run).
|
|
275
|
+
*/
|
|
276
|
+
asksThePerson?: boolean;
|
|
277
|
+
/**
|
|
278
|
+
* For a question tool (`asksThePerson`): whether the engine composes a form for its questions (#2720 D). `false` asks
|
|
279
|
+
* them through the request's default form, exactly as written: a text box, the options, a yes or no. For a host whose
|
|
280
|
+
* questions invite free answers ("none", "contact us", "not decided yet") that a typed control would refuse, such as
|
|
281
|
+
* the creation workbench's interview (#2731). Absent: composed.
|
|
282
|
+
*/
|
|
283
|
+
composesQuestionForm?: boolean;
|
|
284
|
+
/**
|
|
285
|
+
* For a question tool: what the agent is told when the person declines, in place of `ASK_PERSON_DECLINED_REASON`.
|
|
286
|
+
* A host whose own rules say what to do without an answer (propose answers for the person to review, say) names
|
|
287
|
+
* them here, so the agent is not told two different things.
|
|
288
|
+
*/
|
|
289
|
+
questionDeclinedReason?: string;
|
|
290
|
+
/**
|
|
291
|
+
* The tool SHOWS its person records: the conversation draws a successful call as the records' summary cards, read
|
|
292
|
+
* back from the call's input, rather than as a tool card. Set by {@link presentRecordsTool}; do not set it on a tool
|
|
293
|
+
* you write by hand, whose input would not read back as records.
|
|
294
|
+
*/
|
|
295
|
+
presentsRecords?: boolean;
|
|
296
|
+
/**
|
|
297
|
+
* The resources the tool SEARCHES through the retrieval index (#2300). Set by {@link retrievalTool}; startup refuses an
|
|
298
|
+
* application whose retrieval tool names a resource that declares no `.ragSource()` field, which would otherwise
|
|
299
|
+
* search nothing and answer as if nothing matched.
|
|
300
|
+
*/
|
|
301
|
+
retrievalSources?: readonly ResourceType[];
|
|
302
|
+
/**
|
|
303
|
+
* What this tool's RESULT carries, so an agent declaring `contentGuardrails.personalData` (#2292) can treat its personal
|
|
304
|
+
* fields before the model reads them. Declare it on every tool you write by hand: startup refuses a guarded agent
|
|
305
|
+
* offered a tool that does not say, because an undeclared result could carry anything. An organization's policy can put
|
|
306
|
+
* ANY language-model agent under a treatment (#2292 R8); an undeclared tool's result then reaches that agent's model
|
|
307
|
+
* withheld whole, and startup warns about every such tool.
|
|
308
|
+
*
|
|
309
|
+
* - `{ kind: RECORDS_OF_RESOURCE, resourceType }` — records of that resource: a record, or `{ data: [records] }`. Their
|
|
310
|
+
* personal fields are treated; for a tool that WRITES them, a placeholder in its arguments is put back too (only into
|
|
311
|
+
* a field of the same kind). A row of an organization-owned resource is treated under its organization's agent
|
|
312
|
+
* policy too (#2877), so the engine must know whose row it is (#3369). It does when the row keeps its
|
|
313
|
+
* `organizationId`, and for a `PRINCIPAL_RESOURCE_OPERATION` tool whatever the row keeps, because each dispatch
|
|
314
|
+
* records the owners of the rows it returned (as long as the operations it dispatches return rows naming their
|
|
315
|
+
* 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
|
|
316
|
+
* `rowsNameTheirOrganization: true` once every row it returns carries `organizationId`; without it, startup names the
|
|
317
|
+
* tool, and a row naming no organization read by an agent acting in none is treated under the strictest policy.
|
|
318
|
+
* - `{ kind: NOT_FROM_RECORDS, reason }` — nothing the engine moved from a record (an id list, a computed total, the
|
|
319
|
+
* answer a person chose to give). Say why: the reason is what a reviewer reads.
|
|
320
|
+
* - `{ kind: TREATED_BY_TOOL, treat }` — the tool knows its own shape and treats it (the engine's retrieval tool).
|
|
321
|
+
*
|
|
322
|
+
* `resourceReadTool`, `resourceWriteTool`, `presentRecordsTool`, `askPersonTool` and `retrievalTool` declare it for you.
|
|
323
|
+
* The model is sent the treated result; the person, the conversation's tool trace and the cards keep the real values.
|
|
324
|
+
*/
|
|
325
|
+
personalDataOutput?: FunctionTool_PersonalDataOutput;
|
|
326
|
+
/**
|
|
327
|
+
* How this tool reaches the application's data, and so on whose authority (#2839). The engine closes every tool over
|
|
328
|
+
* its caller's server-verified `auth`; what it does with that inside `execute` is the tool's own code, which nothing
|
|
329
|
+
* can check, so it is declared here:
|
|
330
|
+
*
|
|
331
|
+
* - `{ kind: PRINCIPAL_RESOURCE_OPERATION }` — every data access is {@link dispatchResourceOperationAsTool} (the
|
|
332
|
+
* operation's roles, the tenancy filter and its rate limit, for the caller);
|
|
333
|
+
* - `{ kind: PRINCIPAL_SCOPED_SERVICE, reason }` — a service given a context built from the caller's `auth`;
|
|
334
|
+
* - `{ kind: NO_APPLICATION_DATA, reason }` — the tool touches no application data;
|
|
335
|
+
* - `{ kind: SYSTEM_AUTHORITY, reason }` — it reaches data through a `*AsSystem` door, beyond the caller's own reach.
|
|
336
|
+
*
|
|
337
|
+
* `resourceReadTool`, `resourceWriteTool`, `presentRecordsTool`, `askPersonTool` and `retrievalTool` declare it for you.
|
|
338
|
+
* Declare it on every tool you write by hand: the evidence an application's `WILDO.AI.AGENT_AUTHORITY_CONFINEMENT`
|
|
339
|
+
* claim rests on lists every tool with its declaration, and reports one that declares nothing. It is never refused at
|
|
340
|
+
* registration.
|
|
341
|
+
*/
|
|
342
|
+
authority?: FunctionToolAuthorityDeclaration;
|
|
343
|
+
/**
|
|
344
|
+
* #2292: the result is the words of the PERSON the agent works for — the answer they gave to its question — and not
|
|
345
|
+
* content somebody else wrote. An agent's prompt-injection screening (`contentGuardrails.promptInjection`) does not
|
|
346
|
+
* screen it: the person's own words, on their own authority, are not a third party's injection. Set by
|
|
347
|
+
* {@link askPersonTool}. It opts a result out of a security control, so registration refuses it on any tool that is not
|
|
348
|
+
* a question tool (`asksThePerson`).
|
|
349
|
+
*/
|
|
350
|
+
returnsThePersonsOwnWords?: true;
|
|
351
|
+
}
|
|
352
|
+
|
|
353
|
+
/** How a tool's result relates to personal data. See {@link FunctionTool.personalDataOutput}. */
|
|
354
|
+
export enum FunctionToolPersonalDataOutputKind {
|
|
355
|
+
/** Records of one resource: a record, or `{ data: [records] }`. */
|
|
356
|
+
RECORDS_OF_RESOURCE = 'records_of_resource',
|
|
357
|
+
/** Nothing the engine moved from a record. */
|
|
358
|
+
NOT_FROM_RECORDS = 'not_from_records',
|
|
359
|
+
/** The tool treats its own result. */
|
|
360
|
+
TREATED_BY_TOOL = 'treated_by_tool',
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
/** See {@link FunctionTool.personalDataOutput}. */
|
|
364
|
+
export type FunctionTool_PersonalDataOutput =
|
|
365
|
+
| {
|
|
366
|
+
readonly kind: FunctionToolPersonalDataOutputKind.RECORDS_OF_RESOURCE;
|
|
367
|
+
readonly resourceType: ResourceType;
|
|
368
|
+
/**
|
|
369
|
+
* #3369: every row this tool returns carries its resource's `organizationId` (the organization row its own `_id`).
|
|
370
|
+
* For a tool that does not reach its rows through `dispatchResourceOperationAsTool`, whose owners the engine
|
|
371
|
+
* therefore cannot observe. Checked on every row: one that still names no organization is treated under the
|
|
372
|
+
* strictest policy, and counted on the call's operation record.
|
|
373
|
+
*/
|
|
374
|
+
readonly rowsNameTheirOrganization?: true;
|
|
375
|
+
}
|
|
376
|
+
| { readonly kind: FunctionToolPersonalDataOutputKind.NOT_FROM_RECORDS; readonly reason: string }
|
|
377
|
+
| {
|
|
378
|
+
readonly kind: FunctionToolPersonalDataOutputKind.TREATED_BY_TOOL;
|
|
379
|
+
/** The result as the model may read it, every personal value replaced through `guard`. */
|
|
380
|
+
readonly treat: (output: unknown, guard: PersonalDataGuard) => unknown;
|
|
381
|
+
};
|
|
382
|
+
|
|
383
|
+
/** The resource a tool's arguments describe. See {@link FunctionTool.argumentsResource}. */
|
|
384
|
+
export interface FunctionTool_ArgumentsResource {
|
|
385
|
+
resourceType: ResourceType;
|
|
386
|
+
/** The argument holding the id of the row the call acts on, when there is one. */
|
|
387
|
+
rowIdArgument?: string;
|
|
156
388
|
}
|
|
157
389
|
|
|
158
390
|
/**
|
|
@@ -160,12 +392,78 @@ export interface FunctionTool {
|
|
|
160
392
|
*/
|
|
161
393
|
export interface FunctionTool_HumanApprovalGate {
|
|
162
394
|
route: HumanDecision_RouteKind;
|
|
395
|
+
/**
|
|
396
|
+
* How risky the CALL this gate holds is, in the vocabulary a resource operation declares its own risk in (#2526).
|
|
397
|
+
* Every surface that answers the decision reads it: HIGH and CRITICAL put Approve behind a confirmation, and the
|
|
398
|
+
* inbox can sort by it. Absent means no badge and no confirmation, never a default: a severity nobody declared would
|
|
399
|
+
* be a claim nobody made.
|
|
400
|
+
*
|
|
401
|
+
* Declare what the operation the tool performs declares. A tool that deletes through an operation declared HIGH
|
|
402
|
+
* declares HIGH here, so the person approving the call is warned exactly as one deleting the record by hand is.
|
|
403
|
+
*
|
|
404
|
+
* It is declared rather than derived because a hand-written tool names no operation: its `execute` may run several,
|
|
405
|
+
* or none, and `argumentsResource` names the resource its arguments describe, not the verb. A `resourceWriteTool`
|
|
406
|
+
* does know its operation, and still declares the risk here (pass `humanApproval: { route, riskLevel }`): the
|
|
407
|
+
* boolean `requiresHumanApproval` carries no risk. The actor system's own `riskLevel` says how much an assistant may
|
|
408
|
+
* be trusted overall, which is a different statement from how much this one call can do, so it is never shown in
|
|
409
|
+
* place of this.
|
|
410
|
+
*/
|
|
411
|
+
riskLevel?: ResourceOperationRiskLevel;
|
|
163
412
|
/**
|
|
164
413
|
* ROLE and ASSIGNEE: the role every answerer must hold. For ROLE it is the role the decision is
|
|
165
414
|
* routed to. It is also the floor for anyone the decision is later reassigned, escalated or claimed
|
|
166
415
|
* to: a move can never hand it to someone this gate would not have admitted.
|
|
167
416
|
*/
|
|
168
417
|
eligibleRole?: string;
|
|
418
|
+
/**
|
|
419
|
+
* ROLE and ASSIGNEE: the professional qualifications every answerer must ALSO hold (#2967), kinds the application
|
|
420
|
+
* declares in `professionalQualificationKinds`. Read when they act: a qualification verified, within its validity, and
|
|
421
|
+
* recorded by the organization they decide for here — their own organization for one of its own members, the
|
|
422
|
+
* representing organization for someone deciding through a relationship. A floor like `eligibleRole`: a reassignment,
|
|
423
|
+
* an escalation or a claim can never hand the decision to someone without them.
|
|
424
|
+
*
|
|
425
|
+
* Use it when the decision must be taken by a person who is qualified, not merely one who holds a role: a chartered
|
|
426
|
+
* accountant posting an adjustment, a licensed engineer signing off a design. Startup refuses a kind the application
|
|
427
|
+
* does not declare, and an OWNER route (its answerer is the person whose turn it is, who is not vetted).
|
|
428
|
+
*
|
|
429
|
+
* ```ts
|
|
430
|
+
* humanApproval: { route: HumanDecision_RouteKind.ROLE, eligibleRole: 'accountant', requiredQualificationKinds: ['chartered-accountant'] }
|
|
431
|
+
* ```
|
|
432
|
+
*/
|
|
433
|
+
requiredQualificationKinds?: readonly string[];
|
|
434
|
+
/**
|
|
435
|
+
* Whether the answer must carry a fresh step-up proof bound to THIS decision (#2923), as an operation approval's
|
|
436
|
+
* `requiresApproval.requiresStepUpAuthentication` does. The person re-proves a factor (`POST /auth/reauth` with a
|
|
437
|
+
* `decisionBinding` naming the decision and the presentation they answer) and answers from the decision inbox with it
|
|
438
|
+
* in `X-Reauth-Token`. A socket or chat answer carries no proof, so it is refused (`decision_step_up_required`).
|
|
439
|
+
*
|
|
440
|
+
* Use it when approving the call commits the person to something they must be present for: releasing a payment,
|
|
441
|
+
* signing off a filing. Applies to an agent's question (`askPersonTool`) the same way.
|
|
442
|
+
*/
|
|
443
|
+
requiresStepUpAuthentication?: boolean;
|
|
444
|
+
/**
|
|
445
|
+
* What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true`; startup refuses it without:
|
|
446
|
+
* `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven` (any step-up
|
|
447
|
+
* factor), `possession` (TOTP or a passkey) or `phishing_resistant` (a passkey). The approvers' user types must allow
|
|
448
|
+
* that factor as a step-up method. The factor and the instant it was proven are recorded on the decision and its
|
|
449
|
+
* approval seal (`decider.stepUpMethod`, `decider.stepUpAt`).
|
|
450
|
+
*
|
|
451
|
+
* ```ts
|
|
452
|
+
* humanApproval: {
|
|
453
|
+
* route: HumanDecision_RouteKind.ROLE, eligibleRole: 'treasurer',
|
|
454
|
+
* requiresStepUpAuthentication: true,
|
|
455
|
+
* stepUp: { maximumAgeSeconds: 120, minimumAssurance: HumanDecision_StepUpAssurance.PHISHING_RESISTANT },
|
|
456
|
+
* }
|
|
457
|
+
* ```
|
|
458
|
+
*/
|
|
459
|
+
stepUp?: HumanDecision_StepUpRequirement;
|
|
460
|
+
/**
|
|
461
|
+
* The channels that may answer the call (#2923): `web_session` (the application), `chat` (a chat card),
|
|
462
|
+
* `api_client` (a client the person delegated to). Absent: every channel the other requirements allow. A tool approval
|
|
463
|
+
* is decided in person, so `api_client` never answers one whatever this says; `chat` is refused beside a step-up, which
|
|
464
|
+
* a chat answer cannot carry. A chat card for a call it may not answer links to it in the application.
|
|
465
|
+
*/
|
|
466
|
+
answerChannels?: HumanDecision_AnswerChannels;
|
|
169
467
|
/**
|
|
170
468
|
* ASSIGNEE only: resolves the ONE person to route to, when the call pauses, from its arguments and
|
|
171
469
|
* context (for example, the record's account manager). Returning `undefined`, or a person without
|
|
@@ -205,6 +503,51 @@ export interface FunctionTool_HumanApprovalGate {
|
|
|
205
503
|
* target or on an OWNER gate.
|
|
206
504
|
*/
|
|
207
505
|
deadlines?: FunctionTool_HumanApprovalDeadlines;
|
|
506
|
+
/**
|
|
507
|
+
* What a person's DENIAL does to the record the call was about (#3015). A denied call does not run `execute`,
|
|
508
|
+
* so without this a denial changes nothing: an agent's proposal stays proposed, and the application needs a
|
|
509
|
+
* second, unsealed act to record the rejection. Declared here, the denial IS the rejection. It runs once the
|
|
510
|
+
* sealed REJECTED decision has committed, like `execute` once an approval has, with the same context: the
|
|
511
|
+
* requester's authority and the decision's `decisionRef`, which the effect reads back from the engine's record of
|
|
512
|
+
* the decision rather than trusting.
|
|
513
|
+
*
|
|
514
|
+
* It runs only for a person's REJECTED answer, never for a lapse, a withdrawal, or the engine's own denial of a
|
|
515
|
+
* call nobody can answer (nobody decided). It receives the arguments the model proposed (the denied call), and runs
|
|
516
|
+
* in the agent's actor frame, so the rows it writes name the agent, the tool and the decision. Its failure never
|
|
517
|
+
* undoes the decision: the denial stays sealed, the failure is logged, and the resumed turn is told that the record
|
|
518
|
+
* did not move.
|
|
519
|
+
*
|
|
520
|
+
* The usual effect is a server-owned transition (an `INTERNAL_CALL` operation) on the row the call named, given
|
|
521
|
+
* `ctx.decisionRef` and `ctx.executionId` so it can read the decision back before moving anything. The decision is
|
|
522
|
+
* on the conversation's execution row, in whichever of `userFlowActorExecutions`, `organizationFlowActorExecutions`
|
|
523
|
+
* and `applicationFlowActorExecutions` holds it: read each with `readAsSystem` on
|
|
524
|
+
* `{ executionId, lastResolvedDecisionRef: decisionRef }` (the fields are backend-only, and a NOT_FOUND means the
|
|
525
|
+
* next variant). The transition refuses unless `decisionOutcome` is `REJECTED`, `decidedByUserId` is set, and
|
|
526
|
+
* `decisionToolName` equals `modelToolNameForFunctionRef(<this tool's functionRef>)`: the name the model saw, in
|
|
527
|
+
* which a dot becomes `_`, never the dotted functionRef itself.
|
|
528
|
+
*
|
|
529
|
+
* ```ts
|
|
530
|
+
* humanApproval: {
|
|
531
|
+
* route: HumanDecision_RouteKind.ROLE,
|
|
532
|
+
* eligibleRole: 'accountant',
|
|
533
|
+
* onDenied: async (args, ctx) => {
|
|
534
|
+
* const { proposalId } = PostProposal_InputSchema.parse(args); // the arguments the model proposed
|
|
535
|
+
* const { resourcesRegistry, executionContextCreator, servicesRegistryHandler, authorizer } = ctx.services;
|
|
536
|
+
* const contextIds = ctx.organizationId ? { organizationId: ctx.organizationId } : {};
|
|
537
|
+
* const contextFor = (operation: string, path = resourcesRegistry.getServiceOperationPathDefault('proposals', operation)) =>
|
|
538
|
+
* executionContextCreator.buildContextFromSocketAuth(ctx.auth, resourcesRegistry.getOperationFromPath(path), contextIds);
|
|
539
|
+
* // An INTERNAL_CALL operation has no role gate of its own: the requester must hold the row's own UPDATE.
|
|
540
|
+
* await authorizer.authorizeInController(proposalId, await contextFor(CoreResourceOperation.UPDATE,
|
|
541
|
+
* resourcesRegistry.getOperationPathDefault('proposals', CoreResourceOperation.UPDATE)));
|
|
542
|
+
* await servicesRegistryHandler.executeCustomOperation('proposals', 'record_denial', await contextFor('record_denial'),
|
|
543
|
+
* proposalId, { decisionRef: ctx.decisionRef, executionId: ctx.executionId });
|
|
544
|
+
* },
|
|
545
|
+
* }
|
|
546
|
+
* ```
|
|
547
|
+
*
|
|
548
|
+
* assurance-control: WILDO.AI.HUMAN_OVERSIGHT — a person's refusal of an agent's proposal takes effect on the record it refused, as the outcome of the sealed decision.
|
|
549
|
+
*/
|
|
550
|
+
onDenied?: (args: unknown, context: FunctionToolExecutionContext) => Promise<void>;
|
|
208
551
|
}
|
|
209
552
|
|
|
210
553
|
/**
|
|
@@ -237,17 +580,237 @@ export interface FunctionTool_ReviewEscalationRule {
|
|
|
237
580
|
* only a tool that READS, or one gated on a REVIEWER — so a write that content from outside asks for is
|
|
238
581
|
* either impossible or seen by a person first. An OWNER-gated tool is not offered there either: a machine
|
|
239
582
|
* turn has no owner to ask, so the call could only ever be denied.
|
|
583
|
+
*
|
|
584
|
+
* A tool that SHOWS records (`presentsRecords`) is offered only to a turn a person watches in a conversation the
|
|
585
|
+
* application draws. An A2A caller receives the reply's text and no tool calls, and an autonomous turn has nobody
|
|
586
|
+
* watching: offered there, the agent would show cards nobody sees and leave them out of the text the reader does get.
|
|
240
587
|
*/
|
|
588
|
+
// assurance-control: WILDO.AI.AGENT_AUTHORITY_CONFINEMENT — a turn started by content from outside is offered no write a reviewer does not see first.
|
|
241
589
|
export function isFunctionToolOfferedToTurn(
|
|
242
|
-
tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'effect'>,
|
|
590
|
+
tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'effect' | 'presentsRecords'>,
|
|
243
591
|
autonomousTrigger: AutonomousTurnTrigger | undefined,
|
|
592
|
+
initiationKind?: FlowsActors_InitiationKind | null,
|
|
244
593
|
): boolean {
|
|
594
|
+
if (tool.presentsRecords === true && (autonomousTrigger !== undefined || !turnIsDrawnForAPerson(initiationKind))) return false;
|
|
245
595
|
if (autonomousTrigger !== AutonomousTurnTrigger.INBOUND_DELIVERY) return true;
|
|
246
596
|
if (tool.effect === FunctionToolEffect.READ) return true;
|
|
247
597
|
const route = resolveFunctionToolApprovalGate(tool)?.route;
|
|
248
598
|
return route === HumanDecision_RouteKind.ROLE || route === HumanDecision_RouteKind.ASSIGNEE;
|
|
249
599
|
}
|
|
250
600
|
|
|
601
|
+
/**
|
|
602
|
+
* The resource whose personal fields a guarded agent's placeholder may be put back into, in this tool's ARGUMENTS
|
|
603
|
+
* (#2848): the resource the arguments describe (`argumentsResource`), else the resource of the records the tool returns
|
|
604
|
+
* (`personalDataOutput: RECORDS_OF_RESOURCE`). `undefined` when the tool names neither: no argument may then carry a
|
|
605
|
+
* placeholder, because nothing says which field of which resource it would land in.
|
|
606
|
+
*
|
|
607
|
+
* Keyed on the ARGUMENTS first because the result declaration says what the model is SENT, not what the tool WRITES: a
|
|
608
|
+
* write whose result is only ids is `NOT_FROM_RECORDS`, and its arguments must still be checked.
|
|
609
|
+
*/
|
|
610
|
+
export function personalDataArgumentsResourceOf(tool: Pick<FunctionTool, 'argumentsResource' | 'personalDataOutput'>): ResourceType | undefined {
|
|
611
|
+
if (tool.argumentsResource !== undefined) return tool.argumentsResource.resourceType;
|
|
612
|
+
return tool.personalDataOutput?.kind === FunctionToolPersonalDataOutputKind.RECORDS_OF_RESOURCE ? tool.personalDataOutput.resourceType : undefined;
|
|
613
|
+
}
|
|
614
|
+
|
|
615
|
+
/**
|
|
616
|
+
* Whether a guarded agent's arguments to this tool are checked and re-identified before it runs (#2848): every tool that
|
|
617
|
+
* can change something (an undeclared `effect` counts as a write), and every tool that names a resource for its
|
|
618
|
+
* arguments or its records. Only a pure read naming no resource passes its arguments as the model wrote them, since
|
|
619
|
+
* nothing it does stores them.
|
|
620
|
+
*
|
|
621
|
+
* Until #2848 the check was keyed on the RESULT declaration alone, so a write tool declaring `NOT_FROM_RECORDS` stored a
|
|
622
|
+
* `⟦withheld:…⟧` marker or a placeholder exactly as the model wrote it.
|
|
623
|
+
*/
|
|
624
|
+
// assurance-control: WILDO.PRIVACY.DATA_MINIMIZATION — a guarded agent's write never stores a placeholder or a withheld marker, whatever its tool declares about its result.
|
|
625
|
+
export function functionToolArgumentsAreGuarded(tool: Pick<FunctionTool, 'effect' | 'argumentsResource' | 'personalDataOutput'>): boolean {
|
|
626
|
+
return tool.effect !== FunctionToolEffect.READ || personalDataArgumentsResourceOf(tool) !== undefined;
|
|
627
|
+
}
|
|
628
|
+
|
|
629
|
+
/** One date-text form per schema: the SDK and the decision door ask for it on every call. See {@link toolCallSchemaOf}. */
|
|
630
|
+
const TOOL_CALL_SCHEMAS = new WeakMap<z.ZodTypeAny, z.ZodTypeAny>();
|
|
631
|
+
|
|
632
|
+
/**
|
|
633
|
+
* 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
|
|
634
|
+
* `Date` with no such counterpart (one a transform or a default made) as its RFC 3339 text. Everything else as parsed.
|
|
635
|
+
*/
|
|
636
|
+
function withDateText(parsed: unknown, raw: unknown): unknown {
|
|
637
|
+
if (parsed instanceof Date) return typeof raw === 'string' || typeof raw === 'number' ? raw : parsed.toISOString();
|
|
638
|
+
if (Array.isArray(parsed)) return parsed.map((item, index) => withDateText(item, Array.isArray(raw) ? raw[index] : undefined));
|
|
639
|
+
if (parsed !== null && typeof parsed === 'object' && Object.getPrototypeOf(parsed) === Object.prototype) {
|
|
640
|
+
const rawFields = raw !== null && typeof raw === 'object' && !Array.isArray(raw) ? raw as Record<string, unknown> : {};
|
|
641
|
+
return Object.fromEntries(Object.entries(parsed).map(([key, value]) => [key, withDateText(value, Object.hasOwn(rawFields, key) ? rawFields[key] : undefined)]));
|
|
642
|
+
}
|
|
643
|
+
return parsed;
|
|
644
|
+
}
|
|
645
|
+
|
|
646
|
+
/**
|
|
647
|
+
* A tool's arguments as the SDK holds a call (#3489): validated by the schema's JSON form, every check, refinement and
|
|
648
|
+
* transform included, but with each DATE kept as the text it was written in rather than read into a `Date`.
|
|
649
|
+
*
|
|
650
|
+
* ## Why the SDK must never hold a `Date`
|
|
651
|
+
*
|
|
652
|
+
* The SDK treats a call's input as JSON data, and three of its mechanisms break on anything else:
|
|
653
|
+
* - an approval-gated call is paused and stored as JSON, and on approval the SDK requires that parsing the call again
|
|
654
|
+
* yields the stored input (`isDeepEqualData`). A `Date` comes back from storage as its text, so a date argument never
|
|
655
|
+
* compared equal and the call could never be approved;
|
|
656
|
+
* - the approval signature hashes the input with `canonicalJSON`, which writes a `Date` as `{}`: it covered no date's value;
|
|
657
|
+
* - a person's edit is stored as written, and a date parsed to a `Date` never equals the person's text either.
|
|
658
|
+
* spec-cite: N/A — read from the `ai@7.0.142` source (`generate-text/validate-tool-approvals.ts`, `util/is-deep-equal-data.ts`,
|
|
659
|
+
* `util/canonical-hash.ts`), which documents none of it.
|
|
660
|
+
*
|
|
661
|
+
* So the text stays text up to `execute`, where {@link argumentsAToolExecutesWith} reads the dates (a value walk, no second
|
|
662
|
+
* parse). The JSON Schema the model is told is the JSON form's own (a date is `string`, `date-time`): zod's pipe
|
|
663
|
+
* processor is mirrored, since the wrapper's own input side is `any`.
|
|
664
|
+
*
|
|
665
|
+
* Rejected: restoring the stored call's `Date`s at the resume. It made the stored input equal again, but left the
|
|
666
|
+
* signature blind to dates and an edit's text unequal; and the issue's other direction, refusing a gated tool that
|
|
667
|
+
* declares `z.date()`, would forbid what the framework teaches applications to declare.
|
|
668
|
+
*/
|
|
669
|
+
export function toolCallSchemaOf(schema: z.ZodTypeAny): z.ZodTypeAny {
|
|
670
|
+
const known = TOOL_CALL_SCHEMAS.get(schema);
|
|
671
|
+
if (known) return known;
|
|
672
|
+
const jsonForm = jsonParsingSchemaOf(schema);
|
|
673
|
+
const callForm = z.any().transform(async (raw, ctx) => {
|
|
674
|
+
const parsed = await jsonForm.safeParseAsync(raw);
|
|
675
|
+
if (!parsed.success) {
|
|
676
|
+
for (const issue of parsed.error.issues) ctx.addIssue({ ...issue } as never);
|
|
677
|
+
return z.NEVER;
|
|
678
|
+
}
|
|
679
|
+
return withDateText(parsed.data, raw);
|
|
680
|
+
});
|
|
681
|
+
callForm._zod.processJSONSchema = (ctx, _json, params) => {
|
|
682
|
+
z.core.process(jsonForm, ctx as never, params as never);
|
|
683
|
+
(ctx as unknown as { seen: Map<z.ZodTypeAny, { ref?: z.ZodTypeAny }> }).seen.get(callForm)!.ref = jsonForm;
|
|
684
|
+
};
|
|
685
|
+
TOOL_CALL_SCHEMAS.set(schema, callForm);
|
|
686
|
+
return callForm;
|
|
687
|
+
}
|
|
688
|
+
|
|
689
|
+
/**
|
|
690
|
+
* The schema the SDK validates this tool's calls against, which is also the one it revalidates an approved call with
|
|
691
|
+
* (#3295): the tool's own, or under `TOKENIZE` the form whose personal fields also accept a placeholder, since a personal
|
|
692
|
+
* value reaches the SDK as one. The ONE answer: the agent service hands it to the SDK and the decision door rehearses with
|
|
693
|
+
* it, so the two read one schema.
|
|
694
|
+
*
|
|
695
|
+
* In its call form ({@link toolCallSchemaOf}): validated as JSON (#3478), a date's text kept (#3489). A model writes a tool
|
|
696
|
+
* call as JSON, so a `z.date()` argument arrives as an RFC 3339 string; it is checked here, told to the model as `string`
|
|
697
|
+
* `date-time`, and read into a `Date` only for `execute`.
|
|
698
|
+
*/
|
|
699
|
+
export function sdkInputSchemaOfFunctionTool(
|
|
700
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
701
|
+
guard: PersonalDataGuard | undefined,
|
|
702
|
+
): z.ZodTypeAny {
|
|
703
|
+
const argumentsResource = guard !== undefined && functionToolArgumentsAreGuarded(tool) ? personalDataArgumentsResourceOf(tool) : undefined;
|
|
704
|
+
return toolCallSchemaOf(guard?.treatment === RedactionType.TOKENIZE && argumentsResource !== undefined
|
|
705
|
+
? placeholderTolerantInputSchema(tool.inputSchema, guard.personalFieldsOf(argumentsResource))
|
|
706
|
+
: tool.inputSchema);
|
|
707
|
+
}
|
|
708
|
+
|
|
709
|
+
/**
|
|
710
|
+
* The target fields of a guarded write whose tool names no resource for its arguments (#2848): none. Every issued
|
|
711
|
+
* placeholder is then refused ("that field does not hold data of the same kind"), as is every withheld marker and every
|
|
712
|
+
* placeholder the conversation did not issue, so the write can store only values the model actually wrote.
|
|
713
|
+
*/
|
|
714
|
+
const NO_PERSONAL_ARGUMENT_FIELDS: PersonalFieldMap = new Map();
|
|
715
|
+
|
|
716
|
+
/**
|
|
717
|
+
* What a tool's `execute` receives for the arguments the SDK hands it (#2292, #3295): under a guard, a placeholder is put
|
|
718
|
+
* back (only into a field of the same kind) and the result held to the tool's own schema, which the placeholder-tolerant
|
|
719
|
+
* one the model saw was not. Throws what the run would throw: a `PersonalDataPlaceholderRefusal` for a marker or a
|
|
720
|
+
* placeholder that cannot be put back, a schema error for a value the tool refuses.
|
|
721
|
+
*
|
|
722
|
+
* The ONE body of that step: `execute` runs it, and the decision door rehearses it before a decision settles, so a call
|
|
723
|
+
* cannot be recorded as accepted on an answer the run would refuse.
|
|
724
|
+
*/
|
|
725
|
+
export async function argumentsAToolRunsWith(
|
|
726
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
727
|
+
guard: PersonalDataGuard | undefined,
|
|
728
|
+
args: unknown,
|
|
729
|
+
): Promise<unknown> {
|
|
730
|
+
if (!functionToolArgumentsAreGuarded(tool)) return args;
|
|
731
|
+
if (guard === undefined) {
|
|
732
|
+
// #2877: an unguarded call can still hold a withheld marker in its messages: a row an organization outside the call's
|
|
733
|
+
// scope owns was withheld from its model (`treatRecordsResultByOwner`), and a resume after an approval pause runs with
|
|
734
|
+
// no guard of that call. A marker stands for a value nobody may store, so it is refused here whatever the call, and the
|
|
735
|
+
// decision door rehearses the same refusal. Nothing else changes for an unguarded call: no placeholder is put back and
|
|
736
|
+
// the arguments are not parsed again.
|
|
737
|
+
const carrying = argumentsCarryingWithheldMarkers(args);
|
|
738
|
+
if (carrying.length > 0) {
|
|
739
|
+
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.`);
|
|
740
|
+
}
|
|
741
|
+
return args;
|
|
742
|
+
}
|
|
743
|
+
// Asynchronously, as the SDK validates: a tool may declare an async refinement, and `parse` would refuse every value of it.
|
|
744
|
+
// 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
|
|
745
|
+
// the decision door compares what a person read with what runs; `execute` reads it (`argumentsAToolExecutesWith`).
|
|
746
|
+
return toolCallSchemaOf(tool.inputSchema).parseAsync(guard.reidentifyArguments(args, argumentFieldsOf(tool, guard)));
|
|
747
|
+
}
|
|
748
|
+
|
|
749
|
+
/**
|
|
750
|
+
* What a tool's `execute` is called with (#3489): {@link argumentsAToolRunsWith}, with each date the tool's schema declares
|
|
751
|
+
* read into a `Date`. The SDK holds a date as its text ({@link toolCallSchemaOf}), so this is where the tool gets the
|
|
752
|
+
* `Date` its `z.date()` promises. A value walk on the schema's output side, never a second parse: the arguments are
|
|
753
|
+
* already validated, and a transform must not run twice.
|
|
754
|
+
*/
|
|
755
|
+
export async function argumentsAToolExecutesWith(
|
|
756
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
757
|
+
guard: PersonalDataGuard | undefined,
|
|
758
|
+
args: unknown,
|
|
759
|
+
): Promise<unknown> {
|
|
760
|
+
return ResourcesConfigOperationsDtosBuilderUtils.restoreStoredDates(await argumentsAToolRunsWith(tool, guard, args), tool.inputSchema);
|
|
761
|
+
}
|
|
762
|
+
|
|
763
|
+
function argumentFieldsOf(tool: Pick<FunctionTool, 'argumentsResource' | 'personalDataOutput'>, guard: PersonalDataGuard): PersonalFieldMap {
|
|
764
|
+
const argumentsResource = personalDataArgumentsResourceOf(tool);
|
|
765
|
+
return argumentsResource === undefined ? NO_PERSONAL_ARGUMENT_FIELDS : guard.personalFieldsOf(argumentsResource);
|
|
766
|
+
}
|
|
767
|
+
|
|
768
|
+
/**
|
|
769
|
+
* #3295: {@link argumentsAToolRunsWith} rehearsed for the decision door, which must say why rather than throw: what
|
|
770
|
+
* `execute` would receive (`ran`) beside the same arguments before its parse (`readAs`, the values a person reads), or the
|
|
771
|
+
* arguments that stop it, by name. A value that cannot be put back is named alone, by asking the guard field by field; a
|
|
772
|
+
* refusal it cannot place names every argument.
|
|
773
|
+
*/
|
|
774
|
+
export async function rehearsedToolArguments(
|
|
775
|
+
tool: Pick<FunctionTool, 'inputSchema' | 'effect' | 'argumentsResource' | 'personalDataOutput'>,
|
|
776
|
+
guard: PersonalDataGuard | undefined,
|
|
777
|
+
executedCopy: Record<string, unknown>,
|
|
778
|
+
): Promise<{ ran: unknown; readAs: unknown } | { refusedArguments: string[] }> {
|
|
779
|
+
const guarded = guard !== undefined && functionToolArgumentsAreGuarded(tool) ? guard : undefined;
|
|
780
|
+
try {
|
|
781
|
+
return {
|
|
782
|
+
ran: await argumentsAToolRunsWith(tool, guard, executedCopy),
|
|
783
|
+
readAs: guarded ? guarded.reidentifyArguments(executedCopy, argumentFieldsOf(tool, guarded)) : executedCopy,
|
|
784
|
+
};
|
|
785
|
+
} catch {
|
|
786
|
+
const unreadable = guarded === undefined ? argumentsCarryingWithheldMarkers(executedCopy) : Object.entries(executedCopy).filter(([name, value]) => {
|
|
787
|
+
try {
|
|
788
|
+
guarded.reidentifyArguments({ [name]: value }, argumentFieldsOf(tool, guarded));
|
|
789
|
+
return false;
|
|
790
|
+
} catch {
|
|
791
|
+
return true;
|
|
792
|
+
}
|
|
793
|
+
}).map(([name]) => name);
|
|
794
|
+
return { refusedArguments: (unreadable.length > 0 ? unreadable : Object.keys(executedCopy)).sort() };
|
|
795
|
+
}
|
|
796
|
+
}
|
|
797
|
+
|
|
798
|
+
/**
|
|
799
|
+
* Whether a turn's conversation is drawn for a person by the application: a turn over the application's own socket.
|
|
800
|
+
* A turn that records no door predates the door's recording and was a socket turn. Total over the vocabulary.
|
|
801
|
+
*/
|
|
802
|
+
function turnIsDrawnForAPerson(initiationKind: FlowsActors_InitiationKind | null | undefined): boolean {
|
|
803
|
+
if (initiationKind === null || initiationKind === undefined) return true;
|
|
804
|
+
const drawn: Record<FlowsActors_InitiationKind, boolean> = {
|
|
805
|
+
[FlowsActors_InitiationKind.WEBSOCKET_SESSION]: true,
|
|
806
|
+
[FlowsActors_InitiationKind.A2A_REQUEST]: false,
|
|
807
|
+
[FlowsActors_InitiationKind.AUTONOMOUS]: false,
|
|
808
|
+
// The reply is posted in Slack or Teams as text: a card the agent showed would reach nobody (#2665).
|
|
809
|
+
[FlowsActors_InitiationKind.CHAT_MESSAGE]: false,
|
|
810
|
+
};
|
|
811
|
+
return drawn[initiationKind];
|
|
812
|
+
}
|
|
813
|
+
|
|
251
814
|
/** Refused because a tool's approval gate cannot be answered as declared. */
|
|
252
815
|
export class FunctionToolApprovalGateError extends Error {}
|
|
253
816
|
|
|
@@ -258,18 +821,38 @@ export class FunctionToolApprovalGateError extends Error {}
|
|
|
258
821
|
* Throws {@link FunctionToolApprovalGateError} for a declaration nobody could answer. The registry
|
|
259
822
|
* calls it at registration, so that surfaces at startup rather than on the first gated call.
|
|
260
823
|
*/
|
|
261
|
-
|
|
824
|
+
// assurance-control: WILDO.AI.HUMAN_OVERSIGHT — a gated tool's call waits for the person its gate routes it to.
|
|
825
|
+
export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'asksThePerson'>): FunctionTool_HumanApprovalGate | undefined {
|
|
262
826
|
const gate = tool.humanApproval ?? (tool.requiresHumanApproval ? { route: HumanDecision_RouteKind.OWNER } : undefined);
|
|
827
|
+
// #2720: a question to the person is answered by the person in the conversation, so it is gated, on the OWNER route.
|
|
828
|
+
if (tool.asksThePerson && gate?.route !== HumanDecision_RouteKind.OWNER) {
|
|
829
|
+
throw new FunctionToolApprovalGateError(`Function tool "${tool.functionRef}" asks the person and must be gated on the OWNER route: only the person whose turn it is answers it.`);
|
|
830
|
+
}
|
|
263
831
|
if (!gate) return undefined;
|
|
264
832
|
const refuse = (why: string): never => {
|
|
265
833
|
throw new FunctionToolApprovalGateError(`Function tool "${tool.functionRef}" declares an approval gate nobody can answer: ${why}`);
|
|
266
834
|
};
|
|
267
835
|
refuseUnsoundDeadlines(tool.functionRef, gate);
|
|
836
|
+
// #2923: a step-up declaration that cannot mean what it says is refused here, at registration.
|
|
837
|
+
const stepUpIssues = [
|
|
838
|
+
...humanDecisionStepUpDeclarationIssues(gate, 'humanApproval'),
|
|
839
|
+
// #2923: and a channel declaration that names a channel that could never answer it.
|
|
840
|
+
...humanDecisionAnswerChannelsIssues(gate.answerChannels, humanDecisionStepUpRequirementOf(gate) !== undefined, 'humanApproval'),
|
|
841
|
+
];
|
|
842
|
+
if (stepUpIssues.length > 0) refuse(stepUpIssues.join(' '));
|
|
843
|
+
// #2967: a required qualification names a kind, once each. Whether the application DECLARES it needs the configuration,
|
|
844
|
+
// which a tool does not see: the startup validator asks that.
|
|
845
|
+
const requiredKinds = gate.requiredQualificationKinds ?? [];
|
|
846
|
+
if (requiredKinds.some((kind) => typeof kind !== 'string' || kind.length === 0)) refuse('`requiredQualificationKinds` names an empty kind.');
|
|
847
|
+
if (new Set(requiredKinds).size !== requiredKinds.length) refuse('`requiredQualificationKinds` names a kind twice.');
|
|
268
848
|
switch (gate.route) {
|
|
269
849
|
case HumanDecision_RouteKind.OWNER:
|
|
270
850
|
if (gate.eligibleRole || gate.assignee || gate.escalateTo) {
|
|
271
851
|
refuse('an OWNER route is answered by the person whose turn it is, so it takes no role, assignee or escalation target.');
|
|
272
852
|
}
|
|
853
|
+
if (requiredKinds.length > 0) {
|
|
854
|
+
refuse('an OWNER route is answered by the person whose turn it is, who is not vetted, so it can require no qualification; route it to a ROLE.');
|
|
855
|
+
}
|
|
273
856
|
return gate;
|
|
274
857
|
case HumanDecision_RouteKind.ROLE:
|
|
275
858
|
if (!gate.eligibleRole) refuse('a ROLE route must name `eligibleRole`, the role it is routed to.');
|
|
@@ -285,4 +868,79 @@ export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functi
|
|
|
285
868
|
}
|
|
286
869
|
}
|
|
287
870
|
}
|
|
871
|
+
/**
|
|
872
|
+
* Who signs a deliverable sent for electronic signature (#2293). A closed vocabulary: each member names where the person
|
|
873
|
+
* comes from, so nothing the model wrote picks a signer.
|
|
874
|
+
*/
|
|
875
|
+
export enum FunctionTool_SignerSource {
|
|
876
|
+
/** The person whose approval of the call was sealed: the approver signs what they approved. */
|
|
877
|
+
APPROVER = 'approver',
|
|
878
|
+
}
|
|
879
|
+
|
|
880
|
+
/** A tool's electronic-signature requirement for its file deliverable (`FunctionTool.electronicSignature`, #2293). */
|
|
881
|
+
export interface FunctionTool_ElectronicSignatureRequirement {
|
|
882
|
+
readonly requiredLevel: ElectronicSignature_Level;
|
|
883
|
+
/** Who signs, in signing order. At least one; each source once. */
|
|
884
|
+
readonly signers: readonly FunctionTool_SignerSource[];
|
|
885
|
+
}
|
|
886
|
+
|
|
887
|
+
/**
|
|
888
|
+
* What is wrong with a tool's electronic-signature requirement (`electronicSignature`, #2293), one sentence per problem
|
|
889
|
+
* with its remedy; empty when it is sound or absent. Read at registration, beside the deliverable's own declaration.
|
|
890
|
+
*/
|
|
891
|
+
export function functionToolElectronicSignatureDeclarationProblems(
|
|
892
|
+
tool: Pick<FunctionTool, 'functionRef' | 'electronicSignature' | 'deliverableFileArgument'>,
|
|
893
|
+
): string[] {
|
|
894
|
+
const requirement = tool.electronicSignature;
|
|
895
|
+
if (requirement === undefined) return [];
|
|
896
|
+
const named = `Function tool "${tool.functionRef}" declares electronicSignature`;
|
|
897
|
+
const problems: string[] = [];
|
|
898
|
+
if (!tool.deliverableFileArgument) problems.push(`${named} and no deliverableFileArgument: only a file deliverable the approver approved by its hash can be sent for signature.`);
|
|
899
|
+
if (!Object.values(ElectronicSignature_Level).includes(requirement.requiredLevel)) problems.push(`${named} with an unknown requiredLevel "${String(requirement.requiredLevel)}".`);
|
|
900
|
+
const signers = Array.isArray(requirement.signers) ? requirement.signers : [];
|
|
901
|
+
if (signers.length === 0) problems.push(`${named} with no signer: name at least one (FunctionTool_SignerSource).`);
|
|
902
|
+
if (signers.some((signer) => !Object.values(FunctionTool_SignerSource).includes(signer))) problems.push(`${named} with an unknown signer source.`);
|
|
903
|
+
if (new Set(signers).size !== signers.length) problems.push(`${named} naming one signer source twice.`);
|
|
904
|
+
return problems;
|
|
905
|
+
}
|
|
906
|
+
|
|
907
|
+
/**
|
|
908
|
+
* What is wrong with a tool's file-deliverable declaration (`deliverableFileArgument`, #2904), one sentence per problem
|
|
909
|
+
* with its remedy; empty when it is sound or absent. Read at registration, on the schema the tool is registered with
|
|
910
|
+
* (after `bindToResources`), so the argument the engine binds is the one the model is offered.
|
|
911
|
+
*/
|
|
912
|
+
export function functionToolDeliverableDeclarationProblems(
|
|
913
|
+
tool: Pick<FunctionTool, 'functionRef' | 'deliverableFileArgument' | 'inputSchema' | 'requiresHumanApproval' | 'humanApproval' | 'asksThePerson'>,
|
|
914
|
+
): string[] {
|
|
915
|
+
const argument = tool.deliverableFileArgument;
|
|
916
|
+
if (argument === undefined) return [];
|
|
917
|
+
const problems: string[] = [];
|
|
918
|
+
const named = `Function tool "${tool.functionRef}" declares deliverableFileArgument "${String(argument)}"`;
|
|
919
|
+
if (typeof argument !== 'string' || argument.trim().length === 0) return [`${named}, which names no argument: name the argument holding the file's id.`];
|
|
920
|
+
if (!tool.humanApproval && !tool.requiresHumanApproval) {
|
|
921
|
+
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).`);
|
|
922
|
+
}
|
|
923
|
+
if (tool.asksThePerson) problems.push(`${named} and asks the person: a question approves no file.`);
|
|
924
|
+
const shape = tool.inputSchema instanceof z.ZodObject ? (tool.inputSchema.shape as Record<string, z.ZodTypeAny>) : undefined;
|
|
925
|
+
const declared = shape?.[argument];
|
|
926
|
+
if (!declared) {
|
|
927
|
+
problems.push(`${named}, which is not a top-level argument of its input schema: declare it there as the file's id (a string).`);
|
|
928
|
+
} else if (!isStringArgumentSchema(declared)) {
|
|
929
|
+
problems.push(`${named}, which is not a string argument: a file deliverable is named by its file id.`);
|
|
930
|
+
}
|
|
931
|
+
return problems;
|
|
932
|
+
}
|
|
933
|
+
|
|
934
|
+
/** Whether an argument schema is a string once its optional, nullable and default wrappers are removed. */
|
|
935
|
+
function isStringArgumentSchema(schema: z.ZodTypeAny): boolean {
|
|
936
|
+
let current: z.ZodTypeAny = schema;
|
|
937
|
+
for (let depth = 0; depth < 8; depth += 1) {
|
|
938
|
+
if (current instanceof z.ZodOptional || current instanceof z.ZodNullable || current instanceof z.ZodDefault) {
|
|
939
|
+
current = current.def.innerType as z.ZodTypeAny;
|
|
940
|
+
continue;
|
|
941
|
+
}
|
|
942
|
+
return current instanceof z.ZodString || (current as { def?: { type?: unknown } }).def?.type === 'string';
|
|
943
|
+
}
|
|
944
|
+
return false;
|
|
945
|
+
}
|
|
288
946
|
```
|