@wildo-ai/framework-knowledge 1.1.11 → 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 +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +170 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +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.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +27 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +415 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2412 -1604
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2275 -715
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -25,14 +25,17 @@ upload validation and, where its field opts into scanning, the scanner — and t
|
|
|
25
25
|
only what the download route would serve, which excludes an infected file. Re-deciding admissible
|
|
26
26
|
types here would be a second policy that can disagree with the first.
|
|
27
27
|
|
|
28
|
-
## ⚠️
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
28
|
+
## ⚠️ `whenUnavailable` is not failover; `failover` is, and only on a proven non-delivery
|
|
29
|
+
|
|
30
|
+
`whenUnavailable` governs how an UNAVAILABLE capability resolves (the selected vendor is not declared
|
|
31
|
+
or not loaded), not what happens to a failed send. A send the selected vendor fails is handed to the
|
|
32
|
+
next vendor only through the selection's separate `failover` list, and only when the vendor provably
|
|
33
|
+
did NOT take it: the connection was never established, or it answered that it refused the message for
|
|
34
|
+
now (429, or its adapter's own retryable refusal). A send that timed out, was reset or got a 5xx may
|
|
35
|
+
already have been delivered, so it is NOT handed on (a second vendor would deliver it twice); it stays
|
|
36
|
+
`acceptance_unknown` and retryable against the selected vendor. See the `config-saas` skill's
|
|
37
|
+
`framework-capability-resolution-api.md` for the declaration, and keep the application's sending
|
|
38
|
+
domains authenticated (SPF, DKIM) at every vendor the list names.
|
|
36
39
|
|
|
37
40
|
## Other send-path limits worth knowing
|
|
38
41
|
|
|
@@ -19,8 +19,9 @@ code. Send from code only when it cannot express the email:
|
|
|
19
19
|
- it carries an **attachment** (a declaration has none);
|
|
20
20
|
- it goes to **several addresses**, or an address in a **nested** field or a list;
|
|
21
21
|
- it needs **cc, bcc, reply-to or threading** headers (a reply in an existing conversation);
|
|
22
|
-
- a recipient who is **not a user** must be written to in **their own language
|
|
23
|
-
|
|
22
|
+
- a recipient who is **not a user** must be written to in **their own language**: `recipientEmailField` writes in the
|
|
23
|
+
reader's language only when the record's `userId` names a user holding that address, and in the application's
|
|
24
|
+
primary language otherwise.
|
|
24
25
|
|
|
25
26
|
A direct send consults no preference. Reaching for it to get around a person's choice to switch an email off is the
|
|
26
27
|
one wrong use.
|
|
@@ -354,11 +354,10 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
354
354
|
// owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
|
|
355
355
|
// DTO coerces the ISO `dueDate` string to a Date at the service boundary.
|
|
356
356
|
//
|
|
357
|
-
// `recurringType` IS
|
|
358
|
-
// resource (one-time / recurring)
|
|
359
|
-
//
|
|
360
|
-
//
|
|
361
|
-
// use a literal so the model cannot select the recurring variant, whose extra fields
|
|
357
|
+
// `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
|
|
358
|
+
// resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
|
|
359
|
+
// left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
|
|
360
|
+
// states that: the model cannot select the recurring variant, whose extra fields
|
|
362
361
|
// (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
|
|
363
362
|
// defaulted (not merely optional) so they are always present for the discriminated base branch.
|
|
364
363
|
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
|
|
@@ -377,6 +376,10 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
377
376
|
.describe('Always "one_time"; the assistant creates non-recurring todos.'),
|
|
378
377
|
dueDate: z.string().optional()
|
|
379
378
|
.describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
|
|
379
|
+
// The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
|
|
380
|
+
// and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
|
|
381
|
+
// lost answer does not add a second todo. Optional, like the operation's key.
|
|
382
|
+
idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
|
|
380
383
|
}),
|
|
381
384
|
}),
|
|
382
385
|
// WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
|
|
@@ -458,20 +461,24 @@ curl -X POST https://your-app.example.com/api/v1/a2a \
|
|
|
458
461
|
|
|
459
462
|
## Tasks: when a turn becomes addressable
|
|
460
463
|
|
|
461
|
-
A completed blocking turn returns a reply without a task row. A task makes work addressable
|
|
464
|
+
A completed blocking turn with no webhook returns a reply without a task row. A task makes work addressable
|
|
462
465
|
beyond the original request; conversation history and task status are separate records.
|
|
463
466
|
|
|
464
467
|
| Request or outcome | What it gets back | Task lifetime |
|
|
465
468
|
|---|---|---|
|
|
466
469
|
| Blocking `message/send` completes | A reply `Message` with conversation context | No task for that reply |
|
|
467
|
-
| `configuration.
|
|
470
|
+
| A send carrying a webhook (`configuration.pushNotificationConfig`; 1.0: `configuration.taskPushNotificationConfig`) | A `Task`; a blocking send waits for the turn and returns it in its latest state | The webhook is registered on that task; a streamed send carrying one is refused |
|
|
471
|
+
| `configuration.blocking: false` (1.0: `configuration.returnImmediately: true`) | A `Task` with its own ID | Work continues independently of the request once the task is opened |
|
|
468
472
|
| Direct `message/stream` completes | Message frames and the final reply | No background task; disconnect during generation aborts the turn |
|
|
469
473
|
| Send or stream pauses for approval | A `Task` in `input-required`; a stream returns it in its terminal frame | The task reports the pause; the human decision uses the application's approval channel |
|
|
470
474
|
| A message to a conversation still waiting for that decision | JSON-RPC error `-32015` (`DECISION_PENDING`) on every send mode, before any task is created; nothing runs or is written | The input the task waits for is the person's answer: wait for it, or `tasks/cancel`, which withdraws the decision. A decision raised in the instant between that check and a non-blocking turn ends the new task `failed` |
|
|
471
475
|
|
|
472
476
|
These are the supported 0.2.5 request/state spellings. Other supported dialects use the corresponding
|
|
473
|
-
projected names.
|
|
474
|
-
|
|
477
|
+
projected names. **A request is read in the dialect of its method**: a 1.0 `SendMessage` carries parts
|
|
478
|
+
with no `kind` (`{ text }`, `{ raw }`, `{ url }`, `{ data }`) and the role `ROLE_USER`, and the other
|
|
479
|
+
dialect's parts, role or non-blocking flag on a method are refused with `INVALID_PARAMS`. If nonblocking task creation fails, the transport falls back to a blocking reply (except for a
|
|
480
|
+
send carrying a webhook, which is refused instead); check the result kind before using its ID as a
|
|
481
|
+
task handle. An approval pause whose task cannot be
|
|
475
482
|
created returns an error instead. Approval does not grant additional operation permissions.
|
|
476
483
|
|
|
477
484
|
Reattaching a stream to an existing task is different from starting a direct message stream:
|
|
@@ -498,6 +505,21 @@ worth knowing because they surprise people:
|
|
|
498
505
|
- **A task whose worker died reports `failed`, not `working`.** The engine holds a
|
|
499
506
|
liveness lease while a turn runs; if the process serving it disappears, the task stops
|
|
500
507
|
claiming to be in progress. You do not have to reconcile that yourself.
|
|
508
|
+
- **Every reply is written in the dialect the client called in.** A 1.0 `SendMessage` result and
|
|
509
|
+
each stream frame name one member, `{ task }` or `{ message }`, with no `kind` and the role
|
|
510
|
+
`ROLE_AGENT`; v0.2.5 sends the task or message bare. A push notification is written in the
|
|
511
|
+
dialect of the request that created its target: `{ statusUpdate }` in 1.0, a
|
|
512
|
+
`kind: 'status-update'` event with `final` in v0.2.5.
|
|
513
|
+
- **A webhook can ride the send.** `configuration.taskPushNotificationConfig` (1.0, no `taskId`) or
|
|
514
|
+
`configuration.pushNotificationConfig` (v0.2.5) is registered on the task the send opens, through
|
|
515
|
+
the same checks as the push-configuration methods. Such a send always opens a task; a blocking one
|
|
516
|
+
waits and answers with the task, and a streamed one is refused, since a stream opens no task.
|
|
517
|
+
- **A `failed` task says why, in a code a client can branch on.** `status.message.metadata.errorCode`
|
|
518
|
+
is the code the turn stored when it ended (`TURN_INTERRUPTED` when its worker died, `DECISION_LAPSED`
|
|
519
|
+
when the approval it waited on closed unanswered, `AGENT_SUSPENDED`, `MODEL_BUDGET_EXHAUSTED`, …), and
|
|
520
|
+
`metadata.rpcErrorCode` is the JSON-RPC error a blocking send would have answered. The text part
|
|
521
|
+
(`"<CODE>: <reason>"`) is for people; branch on the code. A task that is not `failed` carries no
|
|
522
|
+
status message. See `references/framework-flows-actors-a2a-contract.md` for the full contract.
|
|
501
523
|
|
|
502
524
|
Your app does not implement any of this — it is served by the engine for every actor
|
|
503
525
|
system you expose. What you control is which systems are exposed at all (above) and
|
package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md
CHANGED
|
@@ -109,7 +109,9 @@ the next turn — but do not describe it to a customer as a single-turn guarante
|
|
|
109
109
|
* A flow run is refused BEFORE each of its model calls once its organization's allowance is spent or unverifiable: the
|
|
110
110
|
* step fails with the budget's error, the run ends FAILED on that step, nothing of the step is written, and a
|
|
111
111
|
* `MODEL_SPEND_LIMIT_REFUSED` row names the door `flow_step`. A flow's spend counts against the organization's
|
|
112
|
-
* allowance, never a person's ceiling.
|
|
112
|
+
* allowance, never a person's ceiling. A call made in no turn and no flow but attributed to an organization is refused
|
|
113
|
+
* the same way, before it runs, through the door `organization_work` (#2957); its row names that organization and no
|
|
114
|
+
* person. A call attributed to no organization is neither charged nor refused.
|
|
113
115
|
*
|
|
114
116
|
* A call whose provider reported no token usage is charged an ESTIMATE (the characters it sent and received, at the
|
|
115
117
|
* provider-documented four characters per token, plus a fixed figure per image), never nothing. RAG embeddings,
|
|
@@ -143,14 +145,18 @@ the next turn — but do not describe it to a customer as a single-turn guarante
|
|
|
143
145
|
* which one (`MODEL_BUDGET_EXHAUSTED`, `PERSON_MODEL_CEILING_EXHAUSTED`, or the recoverable
|
|
144
146
|
* `MODEL_BUDGET_UNVERIFIABLE`). Granting neither leaves in-app chat uncapped, as it was.
|
|
145
147
|
*
|
|
146
|
-
* ## Every refusal
|
|
148
|
+
* ## Every refusal leaves a record
|
|
147
149
|
*
|
|
148
150
|
* A turn either limit refuses, at any door, writes one `MODEL_SPEND_LIMIT_REFUSED` audit row: the door
|
|
149
151
|
* (`initiationKind`), which limit (`ceiling`: `organization_budget` or `person_ceiling`), why (`reason`:
|
|
150
152
|
* `allowance_exhausted`, `allowance_unverifiable` or `consumption_unverifiable`), and the allowance and consumption
|
|
151
153
|
* when they were known. A call a unit ceiling refuses writes the same row with the unit's ceiling
|
|
152
154
|
* (`embedding_token_ceiling`, `extraction_page_ceiling` or `screening_text_record_ceiling`), its counts in
|
|
153
|
-
* `allowanceUnits` / `consumedUnits`, and the door only when the call was made in one.
|
|
155
|
+
* `allowanceUnits` / `consumedUnits`, and the door only when the call was made in one. A unit call made in a turn or a
|
|
156
|
+
* flow writes one row per refusal; a call made in NEITHER (the embedding drain, an ingestion sweep, which re-ask a spent
|
|
157
|
+
* ceiling on every run) writes one row per organization, unit, reason and period in each process, and later refusals
|
|
158
|
+
* of the same combination are logged at DEBUG. A restart or a second process records it again, so it errs toward
|
|
159
|
+
* recording. The actor is the person or machine whose turn it was, and the row's organization is the one
|
|
154
160
|
* whose allowance refused it. The gate writes it, not the door, so no door can refuse without a record. An autonomous
|
|
155
161
|
* turn refused for spend writes it as well as its own `AUTONOMOUS_AGENT_TURN_REFUSED` row (reason `over_budget`).
|
|
156
162
|
* An admitted turn writes none.
|
|
@@ -185,7 +191,8 @@ the next turn — but do not describe it to a customer as a single-turn guarante
|
|
|
185
191
|
* we cannot prove the tenant is under it — the coherent choice for a spend boundary. This is safe
|
|
186
192
|
* to fail closed precisely because the counter lives in the application's primary datastore: if
|
|
187
193
|
* that is unreachable the application is down anyway, so this can never be the *sole* cause of an
|
|
188
|
-
* outage (unlike a Redis blip, which is why the burst throttle
|
|
194
|
+
* outage (unlike a Redis blip, which is why the burst throttle counts in process instead of refusing
|
|
195
|
+
* everyone, #3275).
|
|
189
196
|
*
|
|
190
197
|
* ## Overage tolerance
|
|
191
198
|
*
|
|
@@ -125,22 +125,32 @@ one, and that is deliberate rather than a gap.
|
|
|
125
125
|
* do with a turn your actor system runs.
|
|
126
126
|
*
|
|
127
127
|
* A task is materialised ONLY when a turn cannot complete inline:
|
|
128
|
-
* - the client
|
|
128
|
+
* - the client asked not to block: `configuration.blocking: false` on v0.2.5, `configuration.returnImmediately: true`
|
|
129
|
+
* on 1.0 (absent means blocking in both), or
|
|
130
|
+
* - the send carries a webhook for its task (`configuration.pushNotificationConfig` on v0.2.5,
|
|
131
|
+
* `configuration.taskPushNotificationConfig` on 1.0, #3381): a blocking one waits for the turn and answers with the
|
|
132
|
+
* task, and a streamed one is refused, since a stream opens no task, or
|
|
129
133
|
* - the turn reached an interrupted state (a human-in-the-loop approval pause).
|
|
130
134
|
*
|
|
131
|
-
*
|
|
135
|
+
* All three triggers are live. The interrupted-state arm needs a runtime that can pause a turn; that
|
|
132
136
|
* is the human-in-the-loop approval gate, and a paused turn now materialises a task carrying
|
|
133
137
|
* `input-required` on all three transports (blocking send, non-blocking send, stream). An earlier
|
|
134
138
|
* revision of this note warned that the arm was inert and `input-required` never emitted — true
|
|
135
139
|
* when written, and left here in corrected form because a reader who remembers the old claim would
|
|
136
140
|
* otherwise conclude the state is decorative and safe to drop.
|
|
137
141
|
*
|
|
138
|
-
* A blocking turn that answers in one shot returns an A2A `Message` and writes no task
|
|
142
|
+
* A blocking turn that answers in one shot, with no webhook, returns an A2A `Message` and writes no task
|
|
139
143
|
* row at all. Both shapes are protocol-conformant: the specification types the
|
|
140
144
|
* `message/send` result as `Task | Message`, so returning either is conformance rather than a
|
|
141
145
|
* shortcut. The inline case is the default so a chatty agent does not accumulate a row per turn.
|
|
142
146
|
* spec-cite: A2A v0.2.5 §7.1 (SendMessageResponse result type)
|
|
143
147
|
*
|
|
148
|
+
* Every reply is written in the dialect of the method called (#3378). In 1.0 a `SendMessage` result and every stream
|
|
149
|
+
* frame are a oneof object naming ONE member, `{ task }` or `{ message }`; a task, message or part carries no `kind`; a
|
|
150
|
+
* role is `ROLE_AGENT`; a text part is `{ text }`. In v0.2.5 the task or message is sent bare, told apart by `kind`.
|
|
151
|
+
* spec-cite: A2A v1.0.0 `specification/a2a.proto` — `message SendMessageResponse` / `message StreamResponse` (`oneof
|
|
152
|
+
* payload`), `message Part` (`oneof content`), `enum Role`.
|
|
153
|
+
*
|
|
144
154
|
*
|
|
145
155
|
* Once a task exists the client can poll it with `tasks/get` and stop it with
|
|
146
156
|
* `tasks/cancel`. Cancel is a STATUS TRANSITION, never a delete: the spec requires it to
|
|
@@ -154,6 +164,19 @@ one, and that is deliberate rather than a gap.
|
|
|
154
164
|
* cancel is best read as "stop as soon as the runtime is able", not "stop instantly".
|
|
155
165
|
* The task record is the truth about the request either way.
|
|
156
166
|
*
|
|
167
|
+
* **A `failed` task says why** (#3020). Its `status.message` is an agent message whose one text part reads
|
|
168
|
+
* `"<CODE>: <reason>"` and whose `metadata` is `{ errorCode, rpcErrorCode }`: `errorCode` is the
|
|
169
|
+
* `FlowsActors_ExecutionErrorCode` the turn stored when it ended (for a turn that ended live, the same code its stream
|
|
170
|
+
* sent), and `rpcErrorCode` is the JSON-RPC code a blocking send would have answered with. Branch on
|
|
171
|
+
* `metadata.errorCode`, never on the text: `TURN_INTERRUPTED` (the process serving the turn went away; sending again is
|
|
172
|
+
* safe; stored only, never sent live), `DECISION_LAPSED` (the human decision it waited on closed unanswered; stored
|
|
173
|
+
* only), `AGENT_SUSPENDED`, `MODEL_BUDGET_EXHAUSTED` and the other members each name a different remedy. A task that is
|
|
174
|
+
* not `failed` carries no status message from this server.
|
|
175
|
+
* spec-cite: A2A v0.2.5 `specification/json/a2a.json`, `TaskStatus.message` (optional, `$ref: Message`) and
|
|
176
|
+
* `Message.metadata` ("Extension metadata."); A2A v1.0.0 `specification/a2a.proto`, `message TaskStatus` / `message
|
|
177
|
+
* Message`. In the 1.0 dialect the message takes the proto's JSON mapping: `role: "ROLE_AGENT"`, no `kind`, and the
|
|
178
|
+
* `taskId` it belongs to; `metadata` is the same.
|
|
179
|
+
*
|
|
157
180
|
* Import path: `@wildo-ai/saas-backend-lib`.
|
|
158
181
|
*/
|
|
159
182
|
/**
|
|
@@ -75,7 +75,7 @@ is not established. Read the `ai-use-declaration` skill before choosing the valu
|
|
|
75
75
|
|
|
76
76
|
| Declaration | Declare it when | Needs |
|
|
77
77
|
|---|---|---|
|
|
78
|
-
| `personalData: { treatment }` | always, on a language-model agent
|
|
78
|
+
| `personalData: { treatment }` | always, on a language-model agent offered a tool or an MCP server (a treatment acts on what those return, so an agent with neither is sent only what its caller composes and needs none): `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
|
|
79
79
|
| `promptInjection: { screening: THIRD_PARTY_CONTENT }` | the agent reads what somebody else wrote: shared records, documents, retrieved passages, an MCP answer, an inbound email | a provider selected for `EngineCapability.AI_CONTENT_SAFETY` |
|
|
80
80
|
| `outputModeration: { blockAtOrAbove }` | what the agent writes reaches a person, a record or a message | the same provider |
|
|
81
81
|
|
package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md
CHANGED
|
@@ -63,6 +63,33 @@ can be approved as proposed or denied; the answer says why (`modification_reject
|
|
|
63
63
|
The approved write's audit row names the machine (`actorKind` MACHINE,
|
|
64
64
|
`principalCredentialId`), the agent (`agentActor`, with the decision) and the reviewer who decided.
|
|
65
65
|
|
|
66
|
+
A call also has to run exactly as the reviewer read it. If the tool's input schema would drop, rewrite or fill in an
|
|
67
|
+
argument (an undeclared key, a `.trim()`, a `.default()` the reviewer removed), or a value cannot be used (a withheld
|
|
68
|
+
marker), the answer is refused while the decision stays pending, with `call_not_run_as_read` and the arguments to
|
|
69
|
+
correct on the live card, or with `arguments_cannot_be_corrected` where nothing the reviewer could enter would run, which
|
|
70
|
+
leaves only denying it. This holds for an edit, and for a proposal approved as it stands. So keep a gated tool's
|
|
71
|
+
schema free of value-changing transforms: what a reviewer reads is what is sealed, so it has to be what runs.
|
|
72
|
+
|
|
73
|
+
An approval is also refused, with `call_cannot_run`, when the call could not run as things stand: its agent or tool is
|
|
74
|
+
gone, the agent is switched off or suspended, the tool's approval route no longer admits this requester, an organization
|
|
75
|
+
tightened its content policy since the pause, or one of those could not be read. The decision stays pending and denying
|
|
76
|
+
it stays open. If the resumed turn still ends with the call unrun, for something no check could see beforehand, the
|
|
77
|
+
decision stays accepted and the trail gains a `HUMAN_DECISION_ACCEPTED_CALL_NOT_RUN` row, even if the turn completed.
|
|
78
|
+
|
|
79
|
+
So an accepted decision says the person accepted, not that the action happened, and that row's absence does not prove it
|
|
80
|
+
did: a turn stopped by its owner, or a process that died, writes none. To report that an action happened, read what the
|
|
81
|
+
action left behind, such as the record it wrote or the tool's result in the conversation.
|
|
82
|
+
|
|
83
|
+
A reviewer cannot type a value into a field DECLARED as a credential (`.isPassword()`, `.isWriteOnlySecret()`, a
|
|
84
|
+
`CREDENTIALS` category), on the tool's input schema or any schema of its `argumentsResource`, at any depth. It is refused
|
|
85
|
+
under any treatment with `credential_not_accepted`, because a call's arguments are kept with the decision. This reads
|
|
86
|
+
declarations: a secret pasted into a free-text field is not caught, so declare the fields that hold one. If a reviewer has
|
|
87
|
+
to supply a secret, take it through the application's own secret handling, not through a tool argument.
|
|
88
|
+
|
|
89
|
+
The model is held to the same line. A tool offered to an agent cannot declare a credential among its arguments, and startup
|
|
90
|
+
refuses one that does. A gated call in which the model wrote a value into a field its `argumentsResource` declares as a
|
|
91
|
+
credential is denied without pausing, so no decision is raised on it.
|
|
92
|
+
|
|
66
93
|
## Why a run was refused
|
|
67
94
|
|
|
68
95
|
Every refusal records `AUTONOMOUS_AGENT_TURN_REFUSED` and opens nothing. A repeated occurrence is not a
|
|
@@ -85,6 +85,12 @@ Same file. Author an `ActorSystem` (`kind: FlowActorSystem_Kind.ACTOR`,
|
|
|
85
85
|
can list it) with one `actor` (`executionMode: Actor_ExecutionMode.AGENTIC`,
|
|
86
86
|
`agentRef: <your agent ref>`). Its minimal `config` needs only `accessControl[]`
|
|
87
87
|
+ `riskLevel`. Register it under `flowActorSystemsFactoryMap[<systemRef>] = () => system`.
|
|
88
|
+
To open the assistant only to some people, add `roles` to its `accessControl` entry
|
|
89
|
+
(`[{ primaryScope: ResourcePrimaryScope.ORGANIZATIONS, roles: [CORE_ORG_ROLES.ORG_ADMIN] }]`):
|
|
90
|
+
every door that starts a turn (the application's chat, A2A, Slack or Teams, an
|
|
91
|
+
autonomous agent) refuses a person who holds none of them in the organization the
|
|
92
|
+
turn works in, with `SYSTEM_ROLE_NOT_HELD`, and records the refusal. Omit `roles` and
|
|
93
|
+
every member may talk to it. The same field gates a declared flow's `startFlow`.
|
|
88
94
|
|
|
89
95
|
### Step 3: Instantiate the grounding tools
|
|
90
96
|
Same file. For each resource the agent should read, add
|
|
@@ -105,7 +111,9 @@ not just answer questions), add a `resourceWriteTool(<ResourceType>, op, { input
|
|
|
105
111
|
alongside the read tools (`op` = `CoreResourceOperation.CREATE` | `.UPDATE`;
|
|
106
112
|
`functionRef` = `resource.<resourceType>.<op>`, mirror it into `functionRefs`).
|
|
107
113
|
Supply the model-facing `inputSchema` (the fields the model may set — never owner
|
|
108
|
-
FKs or server-set fields; include `id` for updates).
|
|
114
|
+
FKs or server-set fields; include `id` for updates). A date argument is `z.date()`: the
|
|
115
|
+
model writes it as an RFC 3339 string, a person approving the call reads and may edit that text, and the tool
|
|
116
|
+
receives a `Date`. Writes run as the user under
|
|
109
117
|
the resource's own create/update ACL (fail-closed), same as reads. Keep write tools
|
|
110
118
|
grounded and non-destructive in the prompt (no silent bulk mutations). Same
|
|
111
119
|
reference file.
|
|
@@ -197,7 +205,7 @@ is not established. Read the `ai-use-declaration` skill before choosing the valu
|
|
|
197
205
|
|
|
198
206
|
| Declaration | Declare it when | Needs |
|
|
199
207
|
|---|---|---|
|
|
200
|
-
| `personalData: { treatment }` | always, on a language-model agent
|
|
208
|
+
| `personalData: { treatment }` | always, on a language-model agent offered a tool or an MCP server (a treatment acts on what those return, so an agent with neither is sent only what its caller composes and needs none): `RedactionType.TOKENIZE` when the agent must refer to a personal value or write it back, `RedactionType.REMOVE` otherwise (a machine turn keeps the placeholders either way) | every tool it is offered declares `personalDataOutput` (what its result carries); the engine's tools do, and startup refuses a hand-written one that does not. Every write tool also declares `argumentsResource`: the engine checks a guarded agent's write arguments whatever the result declares, refuses a withheld marker or an unissued placeholder, and puts an issued placeholder back only into a field of that resource |
|
|
201
209
|
| `promptInjection: { screening: THIRD_PARTY_CONTENT }` | the agent reads what somebody else wrote: shared records, documents, retrieved passages, an MCP answer, an inbound email | a provider selected for `EngineCapability.AI_CONTENT_SAFETY` |
|
|
202
210
|
| `outputModeration: { blockAtOrAbove }` | what the agent writes reaches a person, a record or a message | the same provider |
|
|
203
211
|
|
|
@@ -475,11 +483,10 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
475
483
|
// owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
|
|
476
484
|
// DTO coerces the ISO `dueDate` string to a Date at the service boundary.
|
|
477
485
|
//
|
|
478
|
-
// `recurringType` IS
|
|
479
|
-
// resource (one-time / recurring)
|
|
480
|
-
//
|
|
481
|
-
//
|
|
482
|
-
// use a literal so the model cannot select the recurring variant, whose extra fields
|
|
486
|
+
// `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
|
|
487
|
+
// resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
|
|
488
|
+
// left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
|
|
489
|
+
// states that: the model cannot select the recurring variant, whose extra fields
|
|
483
490
|
// (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
|
|
484
491
|
// defaulted (not merely optional) so they are always present for the discriminated base branch.
|
|
485
492
|
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
|
|
@@ -498,6 +505,10 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
498
505
|
.describe('Always "one_time"; the assistant creates non-recurring todos.'),
|
|
499
506
|
dueDate: z.string().optional()
|
|
500
507
|
.describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
|
|
508
|
+
// The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
|
|
509
|
+
// and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
|
|
510
|
+
// lost answer does not add a second todo. Optional, like the operation's key.
|
|
511
|
+
idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
|
|
501
512
|
}),
|
|
502
513
|
}),
|
|
503
514
|
// WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
|
package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md
CHANGED
|
@@ -215,11 +215,10 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
215
215
|
// owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
|
|
216
216
|
// DTO coerces the ISO `dueDate` string to a Date at the service boundary.
|
|
217
217
|
//
|
|
218
|
-
// `recurringType` IS
|
|
219
|
-
// resource (one-time / recurring)
|
|
220
|
-
//
|
|
221
|
-
//
|
|
222
|
-
// use a literal so the model cannot select the recurring variant, whose extra fields
|
|
218
|
+
// `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
|
|
219
|
+
// resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
|
|
220
|
+
// left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
|
|
221
|
+
// states that: the model cannot select the recurring variant, whose extra fields
|
|
223
222
|
// (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
|
|
224
223
|
// defaulted (not merely optional) so they are always present for the discriminated base branch.
|
|
225
224
|
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
|
|
@@ -238,6 +237,10 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
238
237
|
.describe('Always "one_time"; the assistant creates non-recurring todos.'),
|
|
239
238
|
dueDate: z.string().optional()
|
|
240
239
|
.describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
|
|
240
|
+
// The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
|
|
241
|
+
// and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
|
|
242
|
+
// lost answer does not add a second todo. Optional, like the operation's key.
|
|
243
|
+
idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
|
|
241
244
|
}),
|
|
242
245
|
}),
|
|
243
246
|
// WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
|
|
@@ -217,8 +217,8 @@ export enum AgentBehaviorReportRemedyKind {
|
|
|
217
217
|
|
|
218
218
|
/** A resolution's link to its remedy. A reference, never a copy of what changed. */
|
|
219
219
|
export const AgentBehaviorReportRemedyRefSchema = z.strictObject({
|
|
220
|
-
kind: z.enum(AgentBehaviorReportRemedyKind).systemEnum('AgentBehaviorReportRemedyKind'),
|
|
221
|
-
ref: z.string().trim().min(1).max(200),
|
|
220
|
+
kind: z.enum(AgentBehaviorReportRemedyKind).systemEnum('AgentBehaviorReportRemedyKind').describe('What the remedy is: `guardrail_event`, the audit event of a guardrail decision that now catches the behaviour, or `agent_configuration_change`, the change made to the agent (an agent-policy change\'s audit event, or the release that changed its configuration).'),
|
|
221
|
+
ref: z.string().trim().min(1).max(200).describe('The remedy\'s reference: the audit event id for `guardrail_event`, the audit event id or release reference for `agent_configuration_change`. A reference, never a copy of what changed.'),
|
|
222
222
|
});
|
|
223
223
|
export type AgentBehaviorReportRemedyRef = z.infer<typeof AgentBehaviorReportRemedyRefSchema>;
|
|
224
224
|
|
|
@@ -313,8 +313,12 @@ export const AgentBehaviorReportSchema = z.object({
|
|
|
313
313
|
/** The stored message the report is about, sent by the reporter: an agent's reply in that conversation. */
|
|
314
314
|
turnMessageId: z.string().min(1).max(200).excludeFromUpdate().isAuditEvidence().portabilityProvenance(DataPortabilityProvenance.SUBJECT_PROVIDED)
|
|
315
315
|
.dataCategories(PersonalDataCategory.USAGE),
|
|
316
|
-
/**
|
|
317
|
-
|
|
316
|
+
/**
|
|
317
|
+
* The actor system the conversation runs, read from the conversation when the report is received. A summary field: a
|
|
318
|
+
* report is labelled by its agent, else by this system, and a report on a system with no named agent kept no name on
|
|
319
|
+
* its card while this was not carried (the label sweep, #2329 widened by #3066 review L1).
|
|
320
|
+
*/
|
|
321
|
+
systemRef: z.string().min(1).max(200).isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
|
|
318
322
|
/** The agent that answered in it, when the system names a conversational agent. */
|
|
319
323
|
agentRef: z.string().min(1).max(200).optional().isDBIndexed().isSummaryField().excludeFromCreate().excludeFromUpdate().isAuditEvidence(),
|
|
320
324
|
/** When the reported reply was produced, read from the stored message when the report was received. */
|
|
@@ -412,13 +416,13 @@ export type AgentBehaviorReportDismissDto = z.infer<typeof AgentBehaviorReportDi
|
|
|
412
416
|
* erased with their account): the report never kept a copy, so there is nothing else to show.
|
|
413
417
|
*/
|
|
414
418
|
export const AgentBehaviorReportedTurnSchema = z.object({
|
|
415
|
-
available: z.boolean(),
|
|
419
|
+
available: z.boolean().describe('`false` when the conversation or the reply no longer exists (deleted by the reporter, or erased with their account). The report never kept a copy, so nothing else is returned.'),
|
|
416
420
|
/** The person's message the reply answered, when the conversation still holds one before it, and when it was sent. */
|
|
417
|
-
prompt: z.string().optional(),
|
|
418
|
-
promptAt: z.date().optional(),
|
|
421
|
+
prompt: z.string().optional().describe('The person\'s message the reply answered, when the conversation still holds one before it.'),
|
|
422
|
+
promptAt: z.date().optional().describe('When that message was sent.'),
|
|
419
423
|
/** The agent's reply, as the person read it (Markdown when the agent answered in Markdown), and when it was produced. */
|
|
420
|
-
reply: z.string().optional(),
|
|
421
|
-
replyAt: z.date().optional(),
|
|
424
|
+
reply: z.string().optional().describe('The agent\'s reply as the person read it, in Markdown when the agent answered in Markdown.'),
|
|
425
|
+
replyAt: z.date().optional().describe('When the reply was produced.'),
|
|
422
426
|
});
|
|
423
427
|
export type AgentBehaviorReportedTurn = z.infer<typeof AgentBehaviorReportedTurnSchema>;
|
|
424
428
|
```
|
|
@@ -34,7 +34,10 @@ Read this when:
|
|
|
34
34
|
personal data, only not in clear: pseudonymised data is still personal data.
|
|
35
35
|
3. The treatment is applied where the model is sent each tool result, so the person's view of the turn (the tool
|
|
36
36
|
calls, the cards, the cited sources) keeps the real values. A tool that fails tells the model the kind of failure,
|
|
37
|
-
never its text, because an error message can quote a value.
|
|
37
|
+
never its text, because an error message can quote a value. The same holds for arguments an approver edits before
|
|
38
|
+
approving a paused call: the write receives the approver's values, and the model's copy of the call carries the
|
|
39
|
+
personal fields of `argumentsResource` as the treatment (a withheld marker under `REMOVE`). A person's answer to a
|
|
40
|
+
question the agent asked is their own words and reaches the model as given, like their message.
|
|
38
41
|
4. Who reads the real values back: the person whose turn it is (their socket session, or a chat message from their
|
|
39
42
|
linked account). An A2A client's turn and an autonomous turn keep the placeholders, because another model reading
|
|
40
43
|
them is a disclosure. Declare `reidentifyForMachineReaders: true` only when that disclosure is intended.
|
|
@@ -192,7 +195,29 @@ What follows from it:
|
|
|
192
195
|
- A conversation that started before the treatment did keeps its earlier replies from the model: they were written
|
|
193
196
|
untreated, so a treated turn sends each as a notice that it was withheld (the person still reads them). An action
|
|
194
197
|
paused for approval under a weaker treatment does not resume (`CONTENT_POLICY_TIGHTENED`); asking again starts afresh.
|
|
195
|
-
- A
|
|
198
|
+
- A record a tool returns is treated under the policy of the organization that owns it too, the stricter of the two.
|
|
199
|
+
This is what protects an organization's records read by a turn acting for another organization or for none (an
|
|
200
|
+
application-scope caller, whose agent no tenant policy tightens). On a turn whose agent has no treatment, such a row is
|
|
201
|
+
withheld (`REMOVE`) even when its owner asked for `TOKENIZE`, because nothing on that turn can put a placeholder back,
|
|
202
|
+
and a write carrying the withheld value is refused. Prompt-injection screening is decided per record too: a record
|
|
203
|
+
whose owner screens is screened before the model reads it, and withheld if it is not found clean, even when the turn
|
|
204
|
+
screens nothing. And a placeholder for a record whose owner sets `machineReadersKeepPlaceholders` stays a placeholder
|
|
205
|
+
for a machine reader (A2A, autonomous) even when the agent gives machine readers the values back; the person whose
|
|
206
|
+
turn it is still reads the value. A reply is moderated under the strictest output policy of every organization whose
|
|
207
|
+
records reached the model in that turn, and the turn's own, even when the agent declares no moderation; a reply that
|
|
208
|
+
cannot be judged in what an owner asked is withheld.
|
|
209
|
+
- So the engine must know whose record each row is. A row that keeps its `organizationId` says so. A tool you write may
|
|
210
|
+
return only the fields it needs; when it reaches its records through `dispatchResourceOperationAsTool` (and declares
|
|
211
|
+
the `PRINCIPAL_RESOURCE_OPERATION` authority), the engine still knows, because each dispatch records the organization
|
|
212
|
+
of every row it read: the row is treated under its own organization's policy when it keeps its `_id`, else under the
|
|
213
|
+
strictest policy of the organizations the call reached. That holds only while the operations it dispatches return rows
|
|
214
|
+
naming their organization; a custom operation whose answer names none leaves the call's rows to the strictest policy.
|
|
215
|
+
A tool reaching its records any other way (an internal
|
|
216
|
+
transition, a service) must return each row's `organizationId` and declare
|
|
217
|
+
`personalDataOutput: { kind: RECORDS_OF_RESOURCE, resourceType, rowsNameTheirOrganization: true }`. Startup warns
|
|
218
|
+
about every tool offered to an agent that does neither. A row whose organization cannot be known, read by an agent
|
|
219
|
+
acting in no organization, reaches the model under the strictest policy (personal data withheld, screened, the reply
|
|
220
|
+
moderated in every category), and is counted on the call's operation record (`rowsOwnerNotDerived`).
|
|
196
221
|
|
|
197
222
|
## Import Origins
|
|
198
223
|
|
|
@@ -240,6 +265,21 @@ export type OrganizationAgentPolicy = z.infer<typeof OrganizationAgentPolicySche
|
|
|
240
265
|
|
|
241
266
|
- Text you compose and pass to the agent yourself (its input messages, its instructions): the engine cannot tell which
|
|
242
267
|
of your words are personal data. Do not paste record values into a prompt for a guarded agent; give it a tool.
|
|
268
|
+
- Text a reviewer types into an approval's edit, in a field that declares no personal-data category: it reaches the model as
|
|
269
|
+
written, like a chat message from that person. The engine cannot tell which of their words are personal, and refusing or
|
|
270
|
+
rewriting a person's sentence is not its call. So declare a category on any free-text argument that may hold a name
|
|
271
|
+
(`.dataCategories(...)` on that field of the tool's `argumentsResource`): the field is then treated like a record's. A string the
|
|
272
|
+
reviewer left as the card showed it stays the model's, in the model's form, so editing one argument does not hand the
|
|
273
|
+
others back in clear; a placeholder the model wrote in a field that cannot hold it is refused, edited or not.
|
|
274
|
+
- Secrets outside a declared field. A tool cannot declare a credential among its arguments: startup refuses it, because its
|
|
275
|
+
schema is what the model is asked to fill and a call's arguments are kept with the decision and the trace. A value the
|
|
276
|
+
model writes into a field the tool's `argumentsResource` declares as a credential is withheld from the trace and from any
|
|
277
|
+
pause, and a gated call is denied instead of paused. An ungated tool still runs with it, so leave such a field out of a
|
|
278
|
+
tool's arguments. A schema that renames such a field defeats the reading too, because the new name is declared by nothing: the
|
|
279
|
+
live progress shows it, and on an ungated tool the trace keeps it. What no declaration covers is out of reach: a secret in a free-text argument, a
|
|
280
|
+
person's chat message, an answer to the agent's question, or a reason given on a decision. The engine cannot tell those
|
|
281
|
+
words from any others, so take a secret through your application's own secret handling or a connected account, and let the
|
|
282
|
+
tool read it.
|
|
243
283
|
- What an MCP tool returns, field by field, for `personalData`: it comes from another system with no schema to read. Under
|
|
244
284
|
a treatment, declared or set by an organization's policy, the model is sent an MCP result withheld whole (an error
|
|
245
285
|
result by its kind only), so a guarded agent cannot use what an MCP server answers. The person still sees it. Without a
|
|
@@ -249,8 +289,8 @@ export type OrganizationAgentPolicy = z.infer<typeof OrganizationAgentPolicySche
|
|
|
249
289
|
- A long text is screened in overlapping pieces, so an instruction of up to 1,000 characters is always whole in one of
|
|
250
290
|
them; a longer one may be split across two.
|
|
251
291
|
- For `outputModeration`: a chunk of a streamed reply that passed is not taken back when a later chunk is withheld — the
|
|
252
|
-
person keeps what they already saw.
|
|
253
|
-
|
|
292
|
+
person keeps what they already saw. The ended turn stores its code (`OUTPUT_WITHHELD`), so a reloaded conversation, a
|
|
293
|
+
reply posted to Slack or Microsoft Teams, and an A2A task read later all say the reply was withheld, as the live turn did.
|
|
254
294
|
- Coding agents and image agents: their output is not text a classifier judges (a coding run's change set is accepted
|
|
255
295
|
by a person through a commit).
|
|
256
296
|
- Tool arguments an APPROVER edits before approving (approve-with-modification): they are the approver's own words, on
|
|
@@ -113,6 +113,13 @@ export const AgentOperationToolCallSchema = z.object({
|
|
|
113
113
|
* Absent when the agent screens nothing, and for an empty result (released without a screening, carrying no text).
|
|
114
114
|
*/
|
|
115
115
|
screening: z.enum(ContentSafetyScreeningOutcome).systemEnum('ContentSafetyScreeningOutcome').optional(),
|
|
116
|
+
/**
|
|
117
|
+
* RESULT (#3369): what reached the model under the strictest agent policy because nothing the engine observed could say
|
|
118
|
+
* whose it was, read by tools acting in no organization. For a tool returning records, the rows of an
|
|
119
|
+
* organization-owned resource that named no organization; for a tool that treats its own output (whose rows never name
|
|
120
|
+
* one), 1 for the whole result. A count, never the content; absent when every owner was known.
|
|
121
|
+
*/
|
|
122
|
+
rowsOwnerNotDerived: z.number().int().min(1).optional(),
|
|
116
123
|
});
|
|
117
124
|
export type AgentOperationToolCall = z.infer<typeof AgentOperationToolCallSchema>;
|
|
118
125
|
|
|
@@ -39,7 +39,9 @@ composes `RESOURCES_FRONTEND_ADMIN_APP` beside the tenant scope.
|
|
|
39
39
|
the same way when the application's id cannot be resolved.
|
|
40
40
|
- A conversation turn ends with `FlowsActors_ExecutionErrorCode.AGENT_SUSPENDED`; the thread says the assistant was
|
|
41
41
|
switched off (`agentSuspended`), and an A2A client receives the JSON-RPC code `-32018` on a blocking `message/send` or
|
|
42
|
-
`message/stream`.
|
|
42
|
+
`message/stream`. The ended turn stores the code, so a reloaded conversation and a chat platform's reply say it too, and
|
|
43
|
+
a client reading the failed task back (`tasks/get`) finds it in the task's status message:
|
|
44
|
+
`metadata.errorCode` (`AGENT_SUSPENDED`) and `metadata.rpcErrorCode` (`-32018`).
|
|
43
45
|
- Each refused call leaves one `SUSPENDED_AGENT_CALL_REFUSED` audit row naming the agent, the scope and the door, when
|
|
44
46
|
the call was made in a conversation or a flow run. The row is written best-effort: a failed write is logged, and the
|
|
45
47
|
refusal stands.
|
|
@@ -116,13 +118,13 @@ export enum AgentSuspensionChangeRefusal {
|
|
|
116
118
|
*/
|
|
117
119
|
export const AgentSuspensionEntrySchema = z.object({
|
|
118
120
|
/** The suspended agent's declared ref (`FlowsActors_Agent.ref`). */
|
|
119
|
-
agentRef: z.string().min(1).max(200),
|
|
121
|
+
agentRef: z.string().min(1).max(200).describe('The suspended agent\'s declared ref.'),
|
|
120
122
|
/** The user who suspended it. Absent once that person was erased. */
|
|
121
|
-
suspendedBy: z.string().min(1).optional(),
|
|
123
|
+
suspendedBy: z.string().min(1).optional().describe('The user who suspended it. Absent once that person was erased; the suspension stays in force.'),
|
|
122
124
|
/** Why, in the administrator's words: shown to the other administrators and kept on the audit trail. */
|
|
123
|
-
reason: z.string().trim().min(1).max(1000),
|
|
125
|
+
reason: z.string().trim().min(1).max(1000).describe('Why, in the administrator\'s words. Shown to the other administrators and kept on the audit trail.'),
|
|
124
126
|
/** When it was suspended (ISO 8601). */
|
|
125
|
-
at: z.iso.datetime(),
|
|
127
|
+
at: z.iso.datetime().describe('When it was suspended (ISO 8601).'),
|
|
126
128
|
});
|
|
127
129
|
export type AgentSuspensionEntry = z.infer<typeof AgentSuspensionEntrySchema>;
|
|
128
130
|
|
|
@@ -131,15 +133,15 @@ export const AgentSuspensionEntriesSchema = z.array(AgentSuspensionEntrySchema).
|
|
|
131
133
|
|
|
132
134
|
/** What `suspendAgent` takes, on either policy: the agent and why. */
|
|
133
135
|
export const AgentSuspension_SuspendRequestSchema = z.object({
|
|
134
|
-
agentRef: AgentSuspensionEntrySchema.shape.agentRef,
|
|
135
|
-
reason: AgentSuspensionEntrySchema.shape.reason,
|
|
136
|
+
agentRef: AgentSuspensionEntrySchema.shape.agentRef.describe('The declared ref of the agent to suspend.'),
|
|
137
|
+
reason: AgentSuspensionEntrySchema.shape.reason.describe('Why it is suspended, in your words. Shown to the other administrators and kept on the audit trail.'),
|
|
136
138
|
});
|
|
137
139
|
export type AgentSuspension_SuspendRequest = z.infer<typeof AgentSuspension_SuspendRequestSchema>;
|
|
138
140
|
|
|
139
141
|
/** What `resumeAgent` takes, on either policy: the agent and why it may run again. */
|
|
140
142
|
export const AgentSuspension_ResumeRequestSchema = z.object({
|
|
141
|
-
agentRef: AgentSuspensionEntrySchema.shape.agentRef,
|
|
142
|
-
reason: AgentSuspensionEntrySchema.shape.reason,
|
|
143
|
+
agentRef: AgentSuspensionEntrySchema.shape.agentRef.describe('The declared ref of the suspended agent to resume.'),
|
|
144
|
+
reason: AgentSuspensionEntrySchema.shape.reason.describe('Why it may run again, in your words. Kept on the audit trail.'),
|
|
143
145
|
});
|
|
144
146
|
export type AgentSuspension_ResumeRequest = z.infer<typeof AgentSuspension_ResumeRequestSchema>;
|
|
145
147
|
```
|
|
@@ -108,6 +108,27 @@ export enum AuditActorKind {
|
|
|
108
108
|
UNATTRIBUTED = 'unattributed',
|
|
109
109
|
}
|
|
110
110
|
|
|
111
|
+
/**
|
|
112
|
+
* WHICH kind of machine credential an audit row's `principalCredentialId` names (#3445): an API key or an OAuth client,
|
|
113
|
+
* of an organization or of the application. Each is its own resource, so the id alone does not say where to look, and
|
|
114
|
+
* a row that recorded only the id could be named only by guessing across all four.
|
|
115
|
+
*
|
|
116
|
+
* Recorded by `_createAuditLog` beside the id, from the credential's authentication method and the machine's execution
|
|
117
|
+
* type, and never supplied by an emitter. Absent where neither is known: a shared platform secret named by its stable
|
|
118
|
+
* name, a platform service's own key, and every row written before the field existed. Those rows show the id they
|
|
119
|
+
* recorded.
|
|
120
|
+
*/
|
|
121
|
+
export enum AuditMachineCredentialKind {
|
|
122
|
+
/** An organization's API key (`organizationApiKeys`). */
|
|
123
|
+
ORGANIZATION_API_KEY = 'organization_api_key',
|
|
124
|
+
/** The application's API key (`applicationApiKeys`). */
|
|
125
|
+
APPLICATION_API_KEY = 'application_api_key',
|
|
126
|
+
/** An organization's OAuth client, acting as itself with client credentials (`organizationOAuthClients`). */
|
|
127
|
+
ORGANIZATION_OAUTH_CLIENT = 'organization_oauth_client',
|
|
128
|
+
/** The application's OAuth client, acting as itself with client credentials (`applicationOAuthClients`). */
|
|
129
|
+
APPLICATION_OAUTH_CLIENT = 'application_oauth_client',
|
|
130
|
+
}
|
|
131
|
+
|
|
111
132
|
/**
|
|
112
133
|
* Which AI agent performed an audited action, and in which execution — present on an audit row ONLY
|
|
113
134
|
* when an agent acted. Its presence is how the trail says "an agent did this"; `actorKind` still names
|
|
@@ -209,7 +209,7 @@ export type ReviewDeadlineAt = z.infer<typeof ReviewDeadlineAtSchema>;
|
|
|
209
209
|
export const ReviewDeadlineTargetSchema = z.object({
|
|
210
210
|
at: ReviewDeadlineAtSchema,
|
|
211
211
|
/** Elapsed time (the default) or the application's business calendar. */
|
|
212
|
-
basis: z.enum(ReviewClockBasis).optional(),
|
|
212
|
+
basis: z.enum(ReviewClockBasis).systemEnum('ReviewClockBasis').optional(),
|
|
213
213
|
/** Arms a WARNING stage this long before the deadline, on the same basis. Absent: no warning stage. */
|
|
214
214
|
warnBefore: ReviewDurationSchema.optional(),
|
|
215
215
|
});
|
|
@@ -220,8 +220,8 @@ export type ReviewDeadlineTarget = z.infer<typeof ReviewDeadlineTargetSchema>;
|
|
|
220
220
|
* target resolver, declared on the backend gate beside it.
|
|
221
221
|
*/
|
|
222
222
|
export const ReviewEscalationRuleSchema = z.object({
|
|
223
|
-
stage: z.enum(ReviewDeadlineStage),
|
|
224
|
-
action: z.enum(ReviewEscalationActionKind),
|
|
223
|
+
stage: z.enum(ReviewDeadlineStage).systemEnum('ReviewDeadlineStage'),
|
|
224
|
+
action: z.enum(ReviewEscalationActionKind).systemEnum('ReviewEscalationActionKind'),
|
|
225
225
|
});
|
|
226
226
|
export type ReviewEscalationRuleDescriptor = z.infer<typeof ReviewEscalationRuleSchema>;
|
|
227
227
|
|